summaryrefslogtreecommitdiff
path: root/doc/sane.man
diff options
context:
space:
mode:
Diffstat (limited to 'doc/sane.man')
-rw-r--r--doc/sane.man928
1 files changed, 928 insertions, 0 deletions
diff --git a/doc/sane.man b/doc/sane.man
new file mode 100644
index 0000000..b062782
--- /dev/null
+++ b/doc/sane.man
@@ -0,0 +1,928 @@
+.TH sane 7 "14 Jul 2008" "@PACKAGEVERSION@" "SANE Scanner Access Now Easy"
+.IX sane
+
+.SH NAME
+sane \- Scanner Access Now Easy: API for accessing scanners
+
+.SH DESCRIPTION
+.B SANE
+is an application programming interface (API) that provides standardized
+access to any raster image scanner hardware. The standardized interface makes
+it possible to write just one driver for each scanner device instead of one
+driver for each scanner and application.
+
+While
+.B SANE
+is primarily targeted at a UNIX environment, the standard has been carefully
+designed to make it possible to implement the API on virtually any hardware or
+operating system.
+.PP
+This manual page provides a summary of the information available about
+.BR SANE .
+.PP
+If you have trouble getting your scanner detected, read the PROBLEMS section.
+
+.SH TERMINOLOGY
+
+An application that uses the
+.B SANE
+interface is called a
+.B SANE frontend.
+A driver that implements the
+.B SANE
+interface is called a
+.B SANE backend.
+A
+.B meta backend
+provides some means to manage one or more other backends.
+
+
+.SH "SOFTWARE PACKAGES"
+The package
+.RB ` sane\-backends '
+contains a lot of backends, documentation (including the
+.B SANE
+standard), networking support, and the command line frontend
+.RB ` scanimage '.
+The frontends
+.RB ` xscanimage "', `" xcam "', and `" scanadf '
+are included in the package
+.RB ` sane\-frontends '.
+Both packages can be downloaded from the
+.B SANE
+homepage
+.RI ( http://www.sane\-project.org/ ).
+Information about other frontends and backends can also be found on the
+.B SANE
+homepage.
+
+.SH "GENERAL INFORMATION"
+The following sections provide short descriptions and links to more
+information about several aspects of
+.B SANE.
+A name with a number in parenthesis (e.g.
+.RB ` sane\-dll (5)')
+points to a manual page. In this case
+.RB ` "man 5 sane\-dll" '
+will display the page. Entries like
+.RI ` @DOCDIR@/sane.tex '
+are references to text files that were copied to the
+.B SANE
+documentation directory
+.RI ( @DOCDIR@/ )
+during installation. Everything else is a URL to a resource on the web.
+
+.TP 2
+.B SANE homepage
+Information on all aspects of SANE including a tutorial and a link to the SANE FAQ
+can be found on the SANE homepage:
+.IR http://www.sane\-project.org/ .
+.TP
+.B SANE device lists
+The
+.B SANE
+device lists contain information about the status of
+.B SANE
+support for a specific device. If your scanner is not listed there (either
+supported or unsupported), please contact us. See section HOW CAN YOU HELP
+SANE for details. There are lists for specific releases of SANE, for the
+current development version and a search engine:
+.IR http://www.sane\-project.org/sane\-supported\-devices.html .
+The lists are also installed on your system at @DOCDIR@/.
+.TP
+.B SANE mailing list
+There is a mailing list for the purpose of discussing the SANE standard and its
+implementations: sane\-devel. Despite its name, the list is not only intended
+for developers, but also for users. There are also some more lists for special
+topics, however, for users, sane\-devel is the right list. How to subscribe and
+unsubscribe:
+.IR http://www.sane\-project.org/mailing\-lists.html .
+.TP
+.B SANE IRC channel
+The IRC (Internet Relay Chat) channel #sane can be found on the Freenode
+network (irc.freenode.net). It's for discussing
+.B SANE
+problems, talking about development and general
+.B SANE
+related chatting. Before asking for help, please read the other documentation
+mentioned in this manual page. The channel's topic is also used for
+announcements of problems with SANE infrastructure (mailing lists, web server,
+etc.).
+.TP
+.B Compiling and installing SANE
+Look at
+.I @DOCDIR@/README
+and the os-dependent README files for information about compiling and
+installing
+.B SANE.
+.TP
+.B SCSI configuration
+For information about various systems and SCSI controllers see
+.BR sane\-scsi (5).
+.TP
+.B USB configuration
+For information about USB configuration see
+.BR sane\-usb (5).
+
+.SH "FRONTENDS AND MISCELLANEOUS PROGRAMS"
+.TP 2
+.B scanimage
+Command-line frontend. See
+.BR scanimage (1).
+.TP
+.B saned
+.B SANE
+network daemon that allows remote clients to access image acquisition devices
+available on the local host. See
+.BR saned (8).
+.TP
+.B sane\-find\-scanner
+Command-line tool to find SCSI and USB scanners and determine their Unix
+device files. See
+.BR sane\-find\-scanner (1).
+.PP
+Also, have a look at the
+.B sane\-frontends
+package (including
+.BR xscanimage ", " xcam ", and " scanadf )
+and the frontend information page at
+.IR http://www.sane\-project.org/sane\-frontends.html .
+
+.SH "BACKENDS FOR SCANNERS"
+.TP 2
+.B abaton
+The SANE backend for Abaton flatbed scanners supports the Scan 300/GS (8bit,
+256 levels of gray) and the Scan 300/S (black and white, untested). See
+.BR sane\-abaton (5)
+for details.
+.TP
+.B agfafocus
+This backend supports AGFA Focus scanners and the Siemens S9036 (untested).
+See
+.BR sane\-agfafocus (5)
+for details.
+.TP
+.B apple
+The SANE backend for Apple flatbed scanners supports the following scanners:
+AppleScanner, OneScanner and ColorOneScanner. See
+.BR sane\-apple (5)
+for details.
+.TP
+.B artec
+The SANE Artec backend supports several Artec/Ultima SCSI flatbed scanners as
+well as the BlackWidow BW4800SP and the Plustek 19200S. See
+.BR sane\-artec (5)
+for details.
+.TP
+.B artec_eplus48u
+The SANE artec_eplus48u backend supports the scanner Artec E+ 48U and re-badged
+models like Tevion MD 9693, Medion MD 9693, Medion MD 9705 and Trust Easy
+Webscan 19200. See
+.BR sane\-artec_eplus48u (5)
+for details.
+.TP
+.B as6e
+This is a SANE backend for using the Artec AS6E parallel port interface
+scanner. See
+.BR sane\-as6e (5)
+for details.
+.TP
+.B avision
+This backend supports several Avision based scanners. This includes the
+original Avision scanners (like AV 630, AV 620, ...) as well as the HP
+ScanJet 53xx and 74xx series, Fujitsu ScanPartner, some Mitsubishi and
+Minolta film-scanners.
+See
+.BR sane\-avision (5)
+for details.
+.TP
+.B bh
+The bh backend provides access to Bell+Howell Copiscan II series document
+scanners. See
+.BR sane\-bh (5)
+for details.
+.TP
+.B canon
+The canon backend supports the CanoScan 300, CanoScan 600, and CanoScan
+2700F SCSI flatbed scanners. See
+.BR sane\-canon (5)
+for details.
+.TP
+.B canon630u
+The canon630u backend supports the CanoScan 630u and 636u USB scanners. See
+.BR sane\-canon630u (5)
+for details.
+.TP
+.B canon_dr
+The canon_dr backend supports the Canon DR-Series ADF SCSI and USB scanners. See
+.BR sane\-canon_dr (5)
+for details.
+.TP
+.B canon_pp
+The canon_pp backend supports the CanoScan FB330P, FB630P, N340P and N640P
+parallel port scanners. See
+.BR sane\-canon_pp (5)
+for details.
+.TP
+.B cardscan
+This backend provides support for Corex Cardscan USB scanners. See
+.BR sane\-cardscan (5)
+for details.
+.TP
+.B coolscan
+This is a SANE backend for Nikon Coolscan film-scanners. See
+.BR sane\-coolscan (5)
+for details.
+.TP
+.B coolscan2
+This is a SANE backend for Nikon Coolscan film-scanners.
+See
+.BR sane\-coolscan2 (5)
+or
+.I http://coolscan2.sourceforge.net
+for details.
+.TP
+.B epjitsu
+The epjitsu backend provides support for Epson-based Fujitsu USB scanners. See
+.BR sane\-epjitsu (5)
+for details.
+.TP
+.B epson
+The SANE epson backend provides support for Epson SCSI, parallel port and USB
+flatbed scanners. See
+.BR sane\-epson (5)
+for details.
+.TP
+.B fujitsu
+The fujitsu backend provides support for most Fujitsu SCSI and USB, flatbed
+and adf scanners. See
+.BR sane\-fujitsu (5)
+for details.
+.TP
+.B genesys
+The genesys backend provides support for several scanners based on the Genesys Logic
+GL646, GL841, GL843, GL847 and GL124 chips like the Medion 6471 and Hewlett-Packard 2300c.
+ See
+.BR sane\-genesys (5)
+for details.
+.TP
+.B gt68xx
+The gt68xx backend provides support for scanners based on the Grandtech
+GT-6801 and GT-6816 chips like the Artec Ultima 2000 and several Mustek
+BearPaw CU and TA models. Some Genius, Lexmark, Medion, Packard Bell, Plustek,
+and Trust scanners are also supported. See
+.BR sane\-gt68xx (5)
+for details.
+.TP
+.B hp
+The SANE hp backend provides access to Hewlett-Packard ScanJet scanners which
+support SCL (Scanner Control Language by HP). See
+.BR sane\-hp (5)
+for details.
+.TP
+.B hpsj5s
+The SANE backend for the Hewlett-Packard ScanJet 5S scanner. See
+.BR sane\-hpsj5s (5)
+for details.
+.TP
+.B hp3500
+The SANE backend for the Hewlett-Packard ScanJet 3500 series. See
+.BR sane\-hp3500 (5)
+for details.
+.TP
+.B hp3900
+The SANE backend for the Hewlett-Packard ScanJet 3900 series. See
+.BR sane\-hp3900 (5)
+for details.
+.TP
+.B hp4200
+The SANE backend for the Hewlett-Packard ScanJet 4200 series. See
+.BR sane\-hp4200 (5)
+for details.
+.TP
+.B hp5400
+The SANE backend for the Hewlett-Packard ScanJet 54XXC series. See
+.BR sane\-hp5400 (5)
+for details.
+.TP
+.B hpljm1005
+The SANE backend for the Hewlett-Packard LaserJet M1005 scanner. See
+.BR sane\-hpljm1005(5)
+for details.
+.TP
+.B hs2p
+The SANE backend for the Ricoh IS450 family of SCSI scanners. See
+.BR sane\-hs2p (5)
+for details.
+.TP
+.B ibm
+The SANE backend for some IBM and Ricoh SCSI scanners. See
+.BR sane\-ibm (5)
+for details.
+.TP
+.B kodak
+The SANE backend for some large Kodak scanners. See
+.BR sane\-kodak (5)
+for details.
+.TP
+.B kodakaio
+The SANE backend for Kodak AiO printer/scanners. See
+.BR sane\-kodakaio (5)
+for details.
+.TP
+.B kvs1025
+The SANE backend for Panasonic KV-S102xC scanners. See
+.BR sane\-kvs1025 (5)
+for details.
+.TP
+.B leo
+This backend supports the Leo S3 and the Across FS-1130, which is a re-badged
+LEO FS-1130 scanner. See
+.BR sane\-leo (5)
+for details.
+.TP
+.B lexmark
+This backend supports the Lexmark X1100 series of USB scanners. See
+.BR sane\-lexmark (5)
+for details.
+.TP
+.B ma1509
+The ma1509 backend supports the Mustek BearPaw 1200F USB flatbed scanner. See
+.BR sane\-ma1509 (5)
+for details.
+.TP
+.B magicolor
+The magicolor backend supports the KONICA MINOLTA magicolor 1690MF multi-function printer/scanner/fax. See
+.BR sane\-magicolor (5)
+for details.
+.TP
+.B matsushita
+This backend supports some Panasonic KVSS high speed scanners. See
+.BR sane\-matsushita (5)
+for details.
+.TP
+.B microtek
+The microtek backend provides access to the "second generation" Microtek
+scanners with SCSI-1 command set. See
+.BR sane\-microtek (5)
+for details.
+.TP
+.B microtek2
+The microtek2 backend provides access to some Microtek scanners with a
+SCSI-2 command set. See
+.BR sane\-microtek2 (5)
+for details.
+.TP
+.B mustek
+The SANE mustek backend supports most Mustek SCSI flatbed scanners including the
+Paragon and ScanExpress series and the 600 II N and 600 II EP (non-SCSI). Some
+Trust scanners are also supported. See
+.BR sane\-mustek (5)
+for details.
+.TP
+.B mustek_pp
+The mustek_pp backend provides access to Mustek parallel port flatbed
+scanners. See
+.BR sane\-mustek_pp (5)
+for details.
+.TP
+.B mustek_usb
+The mustek_usb backend provides access to some Mustek ScanExpress USB flatbed
+scanners. See
+.BR sane\-mustek_usb (5)
+for details.
+.TP
+.B mustek_usb2
+The mustek_usb2 backend provides access to scanners using the SQ113
+chipset like the Mustek BearPaw 2448 TA Pro USB flatbed scanner. See
+.BR sane\-mustek_usb2 (5)
+for details.
+.TP
+.B nec
+The SANE nec backend supports the NEC PC-IN500/4C SCSI scanner. See
+.BR sane\-nec (5)
+for details.
+.TP
+.B niash
+The niash backend supports the Agfa Snapscan Touch and the HP ScanJet 3300c,
+3400c, and 4300c USB flatbed scanners. See
+.BR sane\-niash (5)
+for details.
+.TP
+.B p5
+The SANE backend for Primax PagePartner. See
+.BR sane\-p5 (5)
+for details.
+.TP
+.B pie
+The pie backend provides access to Pacific Image Electronics (PIE) and Devcom
+SCSI flatbed scanners. See
+.BR sane\-pie (5)
+for details.
+.TP
+.B pixma
+The pixma backend supports Canon PIXMA MP series (multi-function devices). See
+.BR sane\-pixma (5)
+or
+.I http://home.arcor.de/wittawat/pixma/
+for details.
+.TP
+.B plustek
+The SANE plustek backend supports USB flatbed scanners that use the National
+Semiconductor LM983[1/2/3]-chipset aka Merlin. Scanners using this LM983x chips
+include some models from Plustek, KYE/Genius, Hewlett-Packard, Mustek, Umax,
+Epson, and Canon. See
+.BR sane\-plustek (5)
+for details.
+.TP
+.B plustek_pp
+The SANE plustek_pp backend supports Plustek parallel port flatbed scanners.
+Scanners using the Plustek ASIC P96001, P96003, P98001 and P98003 include some
+models from Plustek, KYE/Genius, Primax. See
+.BR sane\-plustek_pp (5)
+for details.
+.TP
+.B ricoh
+The ricoh backend provides access to the following Ricoh flatbed
+scanners: IS50 and IS60. See
+.BR sane\-ricoh (5)
+for details.
+.TP
+.B s9036
+The s9036 backend provides access to Siemens 9036 flatbed scanners. See
+.BR sane\-s9036 (5)
+for details.
+.TP
+.B sceptre
+The sceptre backend provides access to the Sceptre S1200 flatbed scanner. See
+.BR sane\-sceptre (5)
+for details.
+.TP
+.B sharp
+The SANE sharp backend supports Sharp SCSI scanners. See
+.BR sane\-sharp (5)
+for details.
+.TP
+.B sm3600
+The SANE sm3600 backend supports the Microtek ScanMaker 3600 USB scanner. See
+.BR sane\-sm3600 (5)
+for details.
+.TP
+.B sm3840
+The SANE sm3840 backend supports the Microtek ScanMaker 3840 USB scanner. See
+.BR sane\-sm3840 (5)
+for details.
+.TP
+.B snapscan
+The snapscan backend supports AGFA SnapScan flatbed scanners. See
+.BR sane\-snapscan (5)
+for details.
+.TP
+.B sp15c
+This backend supports the Fujitsu FCPA ScanPartner 15C flatbed scanner. See
+.BR sane\-sp15c (5)
+for details.
+.TP
+.B st400
+The sane\-st400 backend provides access to Siemens ST400 and ST800. See
+.BR sane\-st400 (5)
+for details.
+.TP
+.B tamarack
+The SANE tamarack backend supports Tamarack Artiscan flatbed scanners. See
+.BR sane\-tamarack (5)
+for details.
+.TP
+.B teco1 teco2 teco3
+The SANE teco1, teco2 and teco3 backends support some TECO scanners,
+usually sold under the Relisys, Trust, Primax, Piotech, Dextra
+names. See
+.BR sane\-teco1 "(5), " sane\-teco2 "(5) and " sane\-teco3 (5)
+for details.
+.TP
+.B u12
+The sane\-u12 backend provides USB flatbed scanners based on Plustek's ASIC 98003
+(parallel-port ASIC) and a GeneSys Logics' USB-parport bridge chip like the
+Plustek OpticPro U(T)12. See
+.BR sane\-u12 (5)
+for details.
+.TP
+.B umax
+The sane\-umax backend provides access to several UMAX-SCSI-scanners and some
+Linotype Hell SCSI-scanners. See
+.BR sane\-umax (5)
+for details.
+.TP
+.B umax_pp
+The sane\-umax_pp backend provides access to Umax parallel port flatbed scanners
+and the HP 3200C. See
+.BR sane\-umax_pp (5)
+for details.
+.TP
+.B umax1200u
+The sane\-umax1220u backend supports the UMAX Astra 1220U (USB) flatbed scanner
+(and also the UMAX Astra 2000U, sort of). See
+.BR sane\-umax1220u (5)
+for details.
+.PP
+Also, have a look at the backend information page at
+.I http://www.sane\-project.org/sane\-supported\-devices.html
+and the list of projects in
+.IR @DOCDIR@/PROJECTS .
+
+.SH "BACKENDS FOR DIGITAL CAMERAS"
+.TP 2
+.B dc210
+Backend for Kodak DC210 Digital Camera. See
+.BR sane\-dc210 (5).
+.TP
+.B dc240
+Backend for Kodak DC240 Digital Camera. See
+.BR sane\-dc240 (5).
+.TP
+.B dc25
+Backend for Kodak DC20/DC25 Digital Cameras. See
+.BR sane\-dc25 (5).
+.TP
+.B dmc
+Backend for the Polaroid Digital Microscope Camera. See
+.BR sane\-dmc (5).
+.TP
+.B gphoto2
+Backend for digital cameras supported by the gphoto2 library package. (See
+.I http://www.gphoto.org
+for more information and a list of supported cameras.) Gphoto2 supports over
+140 different camera models. However, please note that more development and
+testing is needed before all of these cameras will be supported by
+.B SANE
+backend. See
+.BR sane\-gphoto2 (5).
+.TP
+.B qcam
+Backend for Connectix QuickCam cameras. See
+.BR sane\-qcam (5).
+.TP
+.B stv680
+The sane\-st680 backend provides access to webcams with a stv680 chip. See
+.BR sane\-st680 (5)
+for details.
+.PP
+Also, have a look at the backend information page at
+.I http://www.sane\-project.org/sane\-supported\-devices.html
+and the list of projects in
+.IR @DOCDIR@/PROJECTS .
+
+.SH "MISCELLANEOUS BACKENDS"
+.TP 2
+.B dll
+The sane\-dll library implements a
+.B SANE
+backend that provides access to an arbitrary number of other
+.B SANE
+backends by dynamic loading. See
+.BR sane\-dll (5).
+.TP
+.B net
+The
+.B SANE
+network daemon saned provides access to scanners located on different
+computers in connection with the net backend. See
+.BR sane\-net "(5) and " saned (8).
+.TP
+.B pnm
+PNM image reader pseudo-backend. The purpose of this backend is primarily to
+aid in debugging of
+.B SANE
+frontends. See
+.BR sane\-pnm (5).
+.TP
+.B pint
+Backend for scanners that use the
+.B PINT
+(Pint Is Not Twain) device driver. The
+.B PINT
+driver is being actively developed on the OpenBSD platform, and has been
+ported to a few other *nix-like operating systems. See
+.BR sane\-pint (5).
+.TP
+.B test
+The
+.B SANE
+test backend is for testing frontends and the
+.B SANE
+installation. It provides test pictures and various test options. See
+.BR sane\-test (5).
+.TP
+.B v4l
+The sane\-v4l library implements a
+.B SANE
+backend that provides generic access to video cameras and similar equipment
+using the
+.B V4L
+(Video for Linux) API. See
+.BR sane\-v4l (5) .
+.PP
+Also, have a look at the backend information page at
+.I http://www.sane\-project.org/sane\-supported\-devices.html
+and the list of projects in
+.IR @DOCDIR@/PROJECTS .
+
+.SH "CHANGING THE TOP-LEVEL BACKEND"
+By default, all
+.B SANE
+backends (drivers) are loaded dynamically by the
+.B sane\-dll
+meta backend. If you have any questions about the dynamic loading,
+read
+.BR sane\-dll (5).
+.B SANE
+frontend can also be linked to other backends directly by copying or linking a
+backend to
+.B libsane.so
+in
+.IR @LIBDIR@ .
+.PP
+
+.SH "DEVELOPER'S DOCUMENTATION"
+It's not hard to write a
+.B SANE
+backend. It can take some time, however. You should have basic knowledge of C
+and enough patience to work through the documentation and find out how your
+scanner works. Appended is a list of some documents that help to write backends
+and frontends.
+.PP
+The
+.B SANE
+standard defines the application programming interface (API) that is used to
+communicate between frontends and backends. It can be found at
+.I @DOCDIR@/sane.ps
+(if latex is installed on your system) and on the
+.B SANE
+website:
+.I http://www.sane\-project.org/html/
+(HTML), or
+.I http://www.sane\-project.org/sane.ps
+(Postscript).
+.PP
+There is some more information for programmers in
+.IR @DOCDIR@/backend\-writing.txt .
+Most of the internal
+.B SANE
+routines
+.RB ( sanei )
+are documented using doxygen:
+.IR http://www.sane\-project.org/sanei/ .
+Before a new backend or frontend project is started, have a look at
+.I @DOCDIR@/PROJECTS
+for projects that are planned or not yet included into the
+.B SANE
+distribution and at our bug-tracking system:
+.IR http://www.http://www.sane\-project.org/bugs.html .
+.PP
+There are some links on how to find out about the protocol of a scanner:
+.IR http://www.meier\-geinitz.de/sane/misc/develop.html .
+
+.PP
+If you start writing a backend or frontend or any other part of
+.BR SANE,
+please contact the sane\-devel mailing list for coordination so the same work
+isn't done twice.
+
+.SH "FILES"
+.TP
+.I @CONFIGDIR@/*.conf
+The backend configuration files.
+.TP
+.I @LIBDIR@/libsane\-*.a
+The static libraries implementing the backends.
+.TP
+.I @LIBDIR@/libsane\-*.so
+The shared libraries implementing the backends (present on systems that
+support dynamic loading).
+.TP
+.I @DOCDIR@/*
+.B SANE
+documentation: The standard, READMEs, text files for backends etc.
+
+.SH "PROBLEMS"
+If your device isn't found but you know that it is supported, make
+sure that it is detected by your operating system. For SCSI and USB scanners,
+use the
+.B sane\-find\-scanner
+tool (see
+.BR sane\-find\-scanner (1)
+for details). It prints one line for each scanner it has detected and some
+comments (#). If
+.B sane\-find\-scanner
+finds your scanner only as root but not as normal user, the permissions for
+the device files are not adjusted correctly. If the scanner isn't found at all,
+the operating system hasn't detected it and may need some help. Depending on
+the type of your scanner, read
+.BR sane\-usb (5)
+or
+.BR sane\-scsi (5).
+If your scanner (or other device) is not connected over the SCSI bus or USB,
+read the backend's manual page for details on how to set it up.
+.PP
+
+Now your scanner is detected by the operating system but not by
+.BR SANE ?
+Try
+.BR "scanimage \-L" .
+If the scanner is not found, check that the backend's name is mentioned in
+.IR @CONFIGDIR@/dll.conf .
+Some backends are commented out by default. Remove the comment sign for your
+backend in this case. Also some backends aren't compiled at all if one of their
+prerequisites are missing. Examples include dc210, dc240, canon_pp, hpsj5s,
+gphoto2, pint, qcam, v4l, net, sm3600, snapscan, pnm. If you need one of these
+backends and they aren't available, read the build instructions in the
+.B README
+file and the individual manual pages of the backends.
+.PP
+
+Another reason for not being detected by
+.B scanimage \-L
+may be a missing or wrong configuration in the backend's configuration
+file. While
+.B SANE
+tries to automatically find most scanners, some can't be setup correctly
+without the intervention of the administrator. Also on some operating systems
+auto-detection may not work. Check the backend's manual page for details.
+.PP
+If your scanner is still not found, try
+setting the various environment variables that are available to assist in
+debugging. The environment variables are documented in the
+relevant manual pages. For example, to get the maximum amount of debug
+information when testing a Mustek SCSI scanner, set environment variables
+.BR SANE_DEBUG_DLL ", " SANE_DEBUG_MUSTEK ", and " SANE_DEBUG_SANEI_SCSI
+to 128 and then invoke
+.B scanimage
+.B \-L .
+The debug messages for the dll backend tell if the mustek backend was found
+and loaded at all. The mustek messages explain what the mustek backend is
+doing while the SCSI debugging shows the low level handling. If you can't find
+out what's going on by checking the messages carefully, contact the sane\-devel
+mailing list for help (see REPORTING BUGS below).
+.PP
+Now that your scanner is found by
+.BR "scanimage \-L" ,
+try to do a scan:
+.BR "scanimage >image.pnm" .
+This command starts a scan for the default scanner with default settings. All
+the available options are listed by running
+.BR "scanimage \-\-help" .
+If scanning aborts with an error message, turn on debugging as mentioned
+above. Maybe the configuration file needs some tuning, e.g. to setup the path
+to a firmware that is needed by some scanners. See the backend's manual page
+for details. If you can't find out what's wrong, contact sane\-devel.
+.PP
+To check that the
+.B SANE
+libraries are installed correctly you can use the test backend, even if you
+don't have a scanner or other
+.B SANE
+device:
+.IP
+.B scanimage \-d
+.I test
+.B \-T
+.PP
+You should get a list of PASSed tests. You can do the same with your backend
+by changing "test" to your backend's name.
+.PP
+So now scanning with
+.B scanimage
+works and you want to use one of the graphical frontends like
+.BR xsane ,
+.BR xscanimage ", or"
+.B quiteinsane
+but those frontends don't detect your scanner? One reason may be that you
+installed two versions of
+.BR SANE .
+E.g. the version that was installed by your distribution in
+.I /usr
+and one you installed from source in
+.IR /usr/local/ .
+Make sure that only one version is installed. Another possible reason is, that
+your system's dynamic loader can't find the
+.B SANE
+libraries. For Linux, make sure that
+.I /etc/ld.so.conf
+contains
+.I /usr/local/lib
+and does
+.B not
+contain
+.IR /usr/local/lib/sane .
+See also the documentation of the frontends.
+.PP
+
+.SH "HOW CAN YOU HELP SANE"
+We appreciate any help we can get. Please have a look at our web page about
+contributing to
+.BR SANE :
+.I http://www.sane\-project.org/contrib.html
+.PP
+
+.SH "CONTACT"
+For reporting bugs or requesting new features, please use our bug-tracking
+system:
+.IR http://www.sane\-project.org/bugs.html .
+You can also contact the author of your backend directly. Usually the email
+address can be found in the
+.I @DOCDIR@/AUTHORS
+file or the backend's manpage. For general discussion about SANE, please use
+the
+.B SANE
+mailing list sane\-devel (see
+.I http://www.sane\-project.org/mailing\-lists.html
+for details).
+.PP
+
+.SH "SEE ALSO"
+.BR saned (8),
+.BR sane\-find\-scanner (1),
+.BR scanimage (1),
+.BR sane\-abaton (5),
+.BR sane\-agfafocus (5),
+.BR sane\-apple (5),
+.BR sane\-artec (5),
+.BR sane\-artec_eplus48u (5),
+.BR sane\-as6e (5),
+.BR sane\-avision (5),
+.BR sane\-bh (5),
+.BR sane\-canon (5),
+.BR sane\-canon630u (5),
+.BR sane\-canon_dr (5),
+.BR sane\-canon_pp (5),
+.BR sane\-cardscan (5),
+.BR sane\-coolscan2 (5),
+.BR sane\-coolscan (5),
+.BR sane\-dc210 (5),
+.BR sane\-dc240 (5),
+.BR sane\-dc25 (5),
+.BR sane\-dll (5),
+.BR sane\-dmc (5),
+.BR sane\-epson (5),
+.BR sane\-fujitsu (5),
+.BR sane\-genesys (5),
+.BR sane\-gphoto2 (5),
+.BR sane\-gt68xx (5),
+.BR sane\-hp (5),
+.BR sane\-hpsj5s (5),
+.BR sane\-hp3500 (5),
+.BR sane\-hp3900 (5),
+.BR sane\-hp4200 (5),
+.BR sane\-hp5400 (5),
+.BR sane\-hpljm1005 (5),
+.BR sane\-ibm (5),
+.BR sane\-kodak (5),
+.BR sane\-leo (5),
+.BR sane\-lexmark (5),
+.BR sane\-ma1509 (5),
+.BR sane\-matsushita (5),
+.BR sane\-microtek2 (5),
+.BR sane\-microtek (5),
+.BR sane\-mustek (5),
+.BR sane\-mustek_pp (5),
+.BR sane\-mustek_usb (5),
+.BR sane\-mustek_usb2 (5),
+.BR sane\-nec (5),
+.BR sane\-net (5),
+.BR sane\-niash (5),
+.BR sane\-pie (5),
+.BR sane\-pint (5),
+.BR sane\-plustek (5),
+.BR sane\-plustek_pp (5),
+.BR sane\-pnm (5),
+.BR sane\-qcam (5),
+.BR sane\-ricoh (5),
+.BR sane\-s9036 (5),
+.BR sane\-sceptre (5),
+.BR sane\-scsi (5),
+.BR sane\-sharp (5),
+.BR sane\-sm3600 (5),
+.BR sane\-sm3840 (5),
+.BR sane\-snapscan (5),
+.BR sane\-sp15c (5),
+.BR sane\-st400 (5),
+.BR sane\-stv680 (5),
+.BR sane\-tamarack (5),
+.BR sane\-teco1 (5),
+.BR sane\-teco2 (5),
+.BR sane\-teco3 (5),
+.BR sane\-test (5),
+.BR sane\-u12 (5),
+.BR sane\-umax1220u (5),
+.BR sane\-umax (5),
+.BR sane\-umax_pp (5),
+.BR sane\-usb (5),
+.BR sane\-v4l (5)
+
+.SH AUTHOR
+David Mosberger-Tang and many many more (see
+.I @DOCDIR@/AUTHORS
+for details). This man page was written by Henning Meier-Geinitz. Quite a lot
+of text was taken from the
+.B SANE
+standard, several man pages, and README files.