237 lines
5.7 KiB
HTML
237 lines
5.7 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of sane-find-scanner</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>sane-find-scanner</H1>
|
|
Section: SANE Scanner Access Now Easy (1)<BR>Updated: 13 Jul 2008<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="ixAAB"></A>
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
sane-find-scanner - find SCSI and USB scanners and their device files
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>sane-find-scanner</B>
|
|
|
|
[<B>-?</B>|<B>-h</B>|<B>--help</B>]
|
|
|
|
[<B>-v</B>]
|
|
|
|
[<B>-q</B>]
|
|
|
|
[<B>-p</B>]
|
|
|
|
[<B>-f</B>]
|
|
|
|
[<B>-F</B>
|
|
|
|
<I>filename</I>]
|
|
|
|
[<I>devname</I>]
|
|
|
|
<P>
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<B>sane-find-scanner</B>
|
|
|
|
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.
|
|
<P>
|
|
|
|
For
|
|
<B>SCSI</B>
|
|
|
|
scanners, it checks the default generic SCSI device files (e.g.,
|
|
<I>/dev/sg0</I>)
|
|
|
|
and
|
|
<I>/dev/scanner</I>.
|
|
|
|
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
|
|
<B>sane-find-scanner</B>
|
|
|
|
will find any SCSI scanner connected to those default device files even if it
|
|
isn't supported by any SANE backend.
|
|
<P>
|
|
|
|
For
|
|
<B>USB</B>
|
|
|
|
scanners, first the USB kernel scanner device files (e.g.
|
|
<I>/dev/usb/scanner0</I>),
|
|
|
|
<I>/dev/usb/scanner</I>,
|
|
|
|
and
|
|
<I>/dev/usbscanner</I>)
|
|
|
|
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,
|
|
<B>sane-find-scanner</B>
|
|
|
|
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.
|
|
<B>sane-find-scanner</B>
|
|
|
|
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.
|
|
<B>sane-find-scanner</B>
|
|
|
|
will even find USB scanners, that are not supported by any SANE backend.
|
|
<P>
|
|
|
|
<B>sane-find-scanner</B>
|
|
|
|
won't find most
|
|
parallel port scanners, or scanners connected to proprietary ports. Some
|
|
<B>parallel port</B>
|
|
|
|
scanners may be detected by
|
|
<B>sane-find-scanner -p.</B>
|
|
|
|
At the time of writing this will only detect Mustek parallel port scanners.
|
|
<P>
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-?, -h, --help</B>
|
|
|
|
<DD>
|
|
Prints a short usage message.
|
|
<DT id="2"><B>-v</B>
|
|
|
|
<DD>
|
|
Verbose output. If used once,
|
|
<B>sane-find-scanner</B>
|
|
|
|
shows every device name and the test result. If used twice, SCSI inquiry
|
|
information and the USB device descriptors are also printed.
|
|
<DT id="3"><B>-q</B>
|
|
|
|
<DD>
|
|
Be quiet. Print only the devices, no comments.
|
|
<DT id="4"><B>-p</B>
|
|
|
|
<DD>
|
|
Probe parallel port scanners.
|
|
<DT id="5"><B>-f</B>
|
|
|
|
<DD>
|
|
Force opening all explicitly given devices as SCSI and USB devices. That's
|
|
useful if
|
|
<B>sane-find-scanner</B>
|
|
|
|
is wrong in determining the device type.
|
|
<DT id="6"><B>-F filename</B>
|
|
|
|
<DD>
|
|
filename is a file that contains USB descriptors in the format of
|
|
/proc/bus/usb/devices as used by Linux.
|
|
<B>sane-find-scanner</B>
|
|
|
|
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.
|
|
<DT id="7"><B>devname</B>
|
|
|
|
<DD>
|
|
Test device file "devname". No other devices are checked if devname is given.
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>EXAMPLE</H2>
|
|
|
|
<B>sane-find-scanner -v</B>
|
|
|
|
<BR>
|
|
|
|
Check all SCSI and USB devices for available scanners and print a line for
|
|
every device file.
|
|
<P>
|
|
|
|
<B>sane-find-scanner /dev/scanner</B>
|
|
|
|
<BR>
|
|
|
|
Look for a (SCSI) scanner only at /dev/scanner and print the result.
|
|
<P>
|
|
|
|
<B>sane-find-scanner -p</B>
|
|
|
|
<BR>
|
|
|
|
Probe for parallel port scanners.
|
|
<A NAME="lbAG"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?7+sane">sane</A></B>(7),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+sane-scsi">sane-scsi</A></B>(5),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+sane-usb">sane-usb</A></B>(5),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+scanimage">scanimage</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+xscanimage">xscanimage</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+xsane">xsane</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+sane-backendname">sane-backendname</A></B>(5)
|
|
|
|
<P>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
Oliver Rauch, Henning Meier-Geinitz and others
|
|
<A NAME="lbAI"> </A>
|
|
<H2>SUPPORTED PLATFORMS</H2>
|
|
|
|
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.
|
|
<P>
|
|
|
|
SCSI support is available on Irix, EMX, Linux, Next, AIX, Solaris, FreeBSD,
|
|
NetBSD, OpenBSD, and HP-UX.
|
|
<P>
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>BUGS</H2>
|
|
|
|
No support for most parallel port scanners yet.
|
|
<BR>
|
|
|
|
Detection of USB chipsets is limited to a few chipsets.
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="8"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="9"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="10"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="11"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="12"><A HREF="#lbAF">EXAMPLE</A><DD>
|
|
<DT id="13"><A HREF="#lbAG">SEE ALSO</A><DD>
|
|
<DT id="14"><A HREF="#lbAH">AUTHOR</A><DD>
|
|
<DT id="15"><A HREF="#lbAI">SUPPORTED PLATFORMS</A><DD>
|
|
<DT id="16"><A HREF="#lbAJ">BUGS</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:26 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|