manpagez: man pages & more
man sane-find-scanner(1)
Home | html | info | man
sane-find-scanner(1)      SANE Scanner Access Now Easy      sane-find-scanner(1)




NAME

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


SYNOPSIS

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



DESCRIPTION

       sane-find-scanner is a command-line tool to find SCSI and USB scanners
       and determine their UNIX device files. Its primary aim is to make sure
       that scanners can be detected by SANE backends.

       For SCSI scanners, it checks the default generic SCSI device files (e.g.,
       /dev/sg0) and /dev/scanner.  The test is done by sending a SCSI inquiry
       command and looking for a device type of "scanner" or "processor" (some
       old HP scanners seem to send "processor"). So sane-find-scanner will find
       any SCSI scanner connected to those default device files even if it isn't
       supported by any SANE backend.

       For USB scanners, first the USB kernel scanner device files (e.g.
       /dev/usb/scanner0, /dev/usb/scanner, and /dev/usbscanner) are tested. The
       files are opened and the vendor and device ids are determined, if the
       operating system supports this feature. Currently USB scanners are only
       found this way if they are supported by the Linux scanner module or the
       FreeBSD or OpenBSD uscanner driver. After that test, sane-find-scanner
       tries to scan for USB devices found by the USB library libusb (if
       available). There is no special USB class for scanners, so the heuristics
       used to distinguish scanners from other USB devices is not perfect.
       sane-find-scanner also tries to find out the type of USB chip used in the
       scanner. If detected, it will be printed after the vendor and product
       ids.  sane-find-scanner will even find USB scanners, that are not
       supported by any SANE backend.

       sane-find-scanner won't find most parallel port scanners, or scanners
       connected to proprietary ports. Some parallel port scanners may be
       detected by sane-find-scanner -p .  At the time of writing this will only
       detect Mustek parallel port scanners.



OPTIONS

       -?, -h, --help
               Prints a short usage message.

       -v      Verbose output. If used once, sane-find-scanner shows every
               device name and the test result.  If used twice, SCSI inquiry
               information and the USB device descriptors are also printed.

       -q      Be quiet. Print only the devices, no comments.

       -p      Probe parallel port scanners.

       -f      Force opening all explicitly given devices as SCSI and USB
               devices. That's useful if sane-find-scanner is wrong in
               determining the device type.

       -F filename
               filename is a file that contains USB descriptors in the format of
               /proc/bus/usb/devices as used by Linux.  sane-find-scanner tries
               to identify the chipset(s) of all USB scanners found in such a
               file. This option is useful for developers when the output of cat
               /proc/bus/usb/devices is available but the scanner itself isn't.

       devname Test device file "devname". No other devices are checked if
               devname is given.


EXAMPLE

       sane-find-scanner -v
       Check all SCSI and USB devices for available scanners and print a line
       for every device file.

       sane-find-scanner /dev/scanner
       Look for a (SCSI) scanner only at /dev/scanner and print the result.

       sane-find-scanner -p
       Probe for parallel port scanners.


SEE ALSO

       sane(7), sane-scsi(5), sane-usb(5), scanimage(1), xscanimage(1),
       xsane(1), sane-"backendname"(5)



AUTHOR

       Oliver Rauch, Henning Meier-Geinitz and others


SUPPORTED PLATFORMS

       USB support is limited to Linux (kernel, libusb), FreeBSD (kernel,
       libusb), NetBSD (libusb), OpenBSD (kernel, libusb). Detecting the vendor
       and device ids only works with Linux or libusb.

       SCSI support is available on Irix, EMX, Linux, Next, AIX, Solaris,
       FreeBSD, NetBSD, OpenBSD, and HP-UX.



BUGS

       No support for most parallel port scanners yet.
       Detection of USB chipsets is limited to a few chipsets.



                                   13 Jul 2008              sane-find-scanner(1)

sane-backends 1.2.1 - Generated Fri Feb 24 16:23:33 CST 2023
© manpagez.com 2000-2024
Individual documents may contain additional copyright information.