Skip site navigation (1)Skip section navigation (2)

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
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|-?]  [-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 "proces-
       sor"  (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 scan-
       ners, 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, -?  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	deter-
	       mining 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 out-
	       put 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  ven-
       dor 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)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLE | SEE ALSO | AUTHOR | SUPPORTED PLATFORMS | BUGS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=sane-find-scanner&sektion=1&manpath=FreeBSD+8.2-RELEASE+and+Ports>

home | help