1sane-find-scanner(1)     SANE Scanner Access Now Easy     sane-find-scanner(1)
2
3
4

NAME

6       sane-find-scanner - find SCSI and USB scanners and their device files
7

SYNOPSIS

9       sane-find-scanner  [-?|-h|--help]  [-v]  [-q]  [-p]  [-f] [-F filename]
10       [devname]
11
12

DESCRIPTION

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
32       library libusb (if available). There is no special USB class for  scan‐
33       ners,  so  the  heuristics  used to distinguish scanners from other USB
34       devices 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
41       detected  by  sane-find-scanner  -p.   At the time of writing this will
42       only detect Mustek parallel port scanners.
43
44

OPTIONS

46       -?, -h, --help
47               Prints a short usage message.
48
49       -v      Verbose output. If used  once,  sane-find-scanner  shows  every
50               device  name  and the test result.  If used twice, SCSI inquiry
51               information 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
58               devices.  That's useful if sane-find-scanner is wrong in deter‐
59               mining 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
70               devname is given.
71

EXAMPLE

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

SEE ALSO

84       sane(7),   sane-scsi(5),   sane-usb(5),   scanimage(1),  xscanimage(1),
85       xsane(1), sane-"backendname"(5)
86
87

AUTHOR

89       Oliver Rauch, Henning Meier-Geinitz and others
90

SUPPORTED PLATFORMS

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

BUGS

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)
Impressum