1sane-find-scanner(1) SANE Scanner Access Now Easy sane-find-scanner(1)
2
3
4
6 sane-find-scanner - find SCSI and USB scanners and their device files
7
9 sane-find-scanner [-?|-h|--help] [-v] [-q] [-p] [-f] [-F filename] [de‐
10 vname]
11
12
14 sane-find-scanner is a command-line tool to find SCSI and USB scanners
15 and determine their UNIX device files. Its primary aim is to make sure
16 that scanners can be detected by SANE backends.
17
18 For SCSI scanners, it checks the default generic SCSI device files
19 (e.g., /dev/sg0) and /dev/scanner. The test is done by sending a SCSI
20 inquiry command and looking for a device type of "scanner" or "proces‐
21 sor" (some old HP scanners seem to send "processor"). So
22 sane-find-scanner will find any SCSI scanner connected to those default
23 device files even if it isn't supported by any SANE backend.
24
25 For USB scanners, first the USB kernel scanner device files (e.g.
26 /dev/usb/scanner0, /dev/usb/scanner, and /dev/usbscanner) are tested.
27 The files are opened and the vendor and device ids are determined, if
28 the operating system supports this feature. Currently USB scanners are
29 only found this way if they are supported by the Linux scanner module
30 or the FreeBSD or OpenBSD uscanner driver. After that test,
31 sane-find-scanner tries to scan for USB devices found by the USB li‐
32 brary libusb (if available). There is no special USB class for scan‐
33 ners, so the heuristics used to distinguish scanners from other USB de‐
34 vices is not perfect. sane-find-scanner also tries to find out the
35 type of USB chip used in the scanner. If detected, it will be printed
36 after the vendor and product ids. sane-find-scanner will even find USB
37 scanners, that are not supported by any SANE backend.
38
39 sane-find-scanner won't find most parallel port scanners, or scanners
40 connected to proprietary ports. Some parallel port scanners may be de‐
41 tected by sane-find-scanner -p . At the time of writing this will only
42 detect Mustek parallel port scanners.
43
44
46 -?, -h, --help
47 Prints a short usage message.
48
49 -v Verbose output. If used once, sane-find-scanner shows every de‐
50 vice name and the test result. If used twice, SCSI inquiry in‐
51 formation and the USB device descriptors are also printed.
52
53 -q Be quiet. Print only the devices, no comments.
54
55 -p Probe parallel port scanners.
56
57 -f Force opening all explicitly given devices as SCSI and USB de‐
58 vices. That's useful if sane-find-scanner is wrong in determin‐
59 ing the device type.
60
61 -F filename
62 filename is a file that contains USB descriptors in the format
63 of /proc/bus/usb/devices as used by Linux. sane-find-scanner
64 tries to identify the chipset(s) of all USB scanners found in
65 such a file. This option is useful for developers when the out‐
66 put of cat /proc/bus/usb/devices is available but the scanner
67 itself isn't.
68
69 devname Test device file "devname". No other devices are checked if de‐
70 vname is given.
71
73 sane-find-scanner -v
74 Check all SCSI and USB devices for available scanners and print a line
75 for every device file.
76
77 sane-find-scanner /dev/scanner
78 Look for a (SCSI) scanner only at /dev/scanner and print the result.
79
80 sane-find-scanner -p
81 Probe for parallel port scanners.
82
84 sane(7), sane-scsi(5), sane-usb(5), scanimage(1), xscanimage(1),
85 xsane(1), sane-"backendname"[22m(5)
86
87
89 Oliver Rauch, Henning Meier-Geinitz and others
90
92 USB support is limited to Linux (kernel, libusb), FreeBSD (kernel,
93 libusb), NetBSD (libusb), OpenBSD (kernel, libusb). Detecting the ven‐
94 dor and device ids only works with Linux or libusb.
95
96 SCSI support is available on Irix, EMX, Linux, Next, AIX, Solaris,
97 FreeBSD, NetBSD, OpenBSD, and HP-UX.
98
99
101 No support for most parallel port scanners yet.
102 Detection of USB chipsets is limited to a few chipsets.
103
104
105
106 13 Jul 2008 sane-find-scanner(1)