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-?]  [-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 pri-
     mary 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 sys-
     tem 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  spe-
     cial  USB class for scanners, so the heuristics used to dis-
     tinguish 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, -?  Prints a short usage message.

     -v      Verbose  output.  If  used  once,  sane-find-scanner
             shows  every  device  name  and the test result.  If



sane-backends 1.0.19 Last change: 4 Oct 2004                    1






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



             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),  xscanim-
     age(1),  xsane(1), " .}S 3 1 "sane-backendname"" "(5)" "" ""
     "" ""


AUTHOR
     Oliver Rauch, Henning Meier-Geinitz and others

SUPORTED 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.



sane-backends 1.0.19 Last change: 4 Oct 2004                    2






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



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


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     
       ATRIBUTE TYPE     ATRIBUTE VALUE 
    
     Availability         SUNWsane-backend
    
     Interface Stability  Uncommitted     
    

NOTES
     Source for SANE is available on http:/opensolaris.org.




































sane-backends 1.0.19 Last change: 4 Oct 2004                    3