Minor adjustments, added headers, fixed \- bug.

DEVEL_2_0_BRANCH-1
Henning Geinitz 2002-11-19 16:07:48 +00:00
rodzic eb47cc6d78
commit e2e68a06d1
2 zmienionych plików z 56 dodań i 32 usunięć

Wyświetl plik

@ -3,6 +3,8 @@
* doc/sane-usb.man: Added quick start section. New structure/order.
Added list of backends that don't use sanei_usb. Added headers
and fixed \- bug.
* doc/sane-find-scanner.man: Minor adjustments, added headers, fixed
\- bug.
2002-11-18 Frank Zago <fzago at austin dot rr dot com>

Wyświetl plik

@ -1,42 +1,55 @@
.TH sane-find-scanner 1 "15 Sep 2002"
.TH sane-find-scanner 1 "15 Sep 2002" @PACKAGEVERSION@ "SANE Scanner Access Now Easy"
.IX sane-find-scanner
.SH NAME
sane-find-scanner - find SCSI and USB scanners and their device files
sane-find-scanner \- find SCSI and USB scanners and their device files
.SH SYNOPSIS
.B sane-find-scanner
.RB [\-h|\-?]
.RB [\-v]
.RB [\-q]
.RB [\-f]
.RI [devname]
.RB [ \-h | \-? ]
.RB [ \-v ]
.RB [ \-q ]
.RB [ \-f ]
.RI [ devname ]
.SH DESCRIPTION
.B sane-find-scanner
is a command-line tool to find SCSI and some USB scanners and determine their
Unix device files. It's part of the sane-backends package.
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.
.PP
For
.B 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.
scanners, it checks the default generic SCSI device files (e.g.,
.IR /dev/sg0 )
and
.IR /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
.B sane-find-scanner
will find any SCSI scanner connected to those default device files even if it
isn't supported by any SANE backend.
.PP
For
.B 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 will even find USB scanners, that are not supported
by any SANE backend.
scanners, first the USB kernel scanner device files (e.g.
.IR /dev/usb/scanner0 ),
.IR /dev/usb/scanner ,
and
.IR /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,
.B 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.
.B sane-find-scanner
will even find USB scanners, that are not supported by any SANE backend.
.PP
sane-find-scanner won't find parallel
port scanners, or scanners connected to proprietary ports.
.B sane-find-scanner
won't find parallel port scanners, or scanners connected to proprietary ports.
.SH OPTIONS
.TP 8
@ -44,16 +57,19 @@ port scanners, or scanners connected to proprietary ports.
Prints a short usage message.
.TP 8
.B \-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.
Verbose output. If used once,
.B 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.
.TP 8
.B \-q
Be quiet. Print only the devices, no comments.
.TP 8
.B \-f
Force opening all explicitely given devices as SCSI and USB devices. That's
useful if sane-find-scanner is wrong in determing the device type.
useful if
.B sane-find-scanner
is wrong in determing the device type.
.TP 8
.B devname
Test device file "devname". No other devices are checked if devname is given.
@ -67,8 +83,14 @@ every device file.
.br
Look for a (SCSI) scanner only at /dev/scanner and print the result.
.SH "SEE ALSO"
sane(7), sane-scsi(5), sane-usb(5), scanimage(1), xscanimage(1), xsane(1),
sane-"backendname"(5)
.BR sane (7),
.BR sane-scsi (5),
.BR sane-usb (5),
.BR scanimage(1),
.BR xscanimage(1),
.BR xsane(1),
.BR sane-"backendname" (5)
.SH AUTHOR
Oliver Rauch, Henning Meier-Geinitz and others
.SH SUPPORTED PLATFORMS