How to configure, build, and install SANE. Quick install: ============== ./configure make make install Prerequisites ============= In order to build SANE, the following tools and libraries are required: - GNU make: version 3.70 or newer - ANSI C compiler: GNU C (gcc) is recommended for best performance, but any ANSI-compliant compiler should do - To build the graphical frontends (xscanimage and xcam), it is necessary to have the GTK libraries (libgtk, libgdk, and libglib) and associated header files installed. In addition, if you want to use xscanimage from within GIMP, you'll need to make sure libgimp (version 0.99.13 or newer) and its header files are installed as well. The GTK libraries and GIMP can be obtained from: ftp://ftp.gimp.org/pub/ SANE should build on most Unix-like systems. Support for OS/2 is also available. For more details look at the operating system specific README.* files. For a detailed support matrix, see: http://www.mostang.com/sane/sane-support.html This table may be out of date. Please send any corrections or additions to sane-devel@mostang.com together with your platform, os and version. Configuration ============= Simply invoke configure in the top-level directory. Besides the usual GNU configure options, there are the following SANE specific options: --disable-shared Don't use shared libraries. Useful for debugging or when there is a problem building shared libraries. This implicitly turns on --disable-dynamic as well. --disable-dynamic Disable dynamic loading of backends (in the dll backend). configure normally turns on dynamic loading when it can find the appropriate header files and libraries ( and -dl). --enable-preload Preload backends into DLL backend. This is useful for debugging, when dynamic loading is unavailable, or to reduce runtime linking overheads. If dynamic loading or shared libraries are unavailable or disabled, this option is turned on automatically. --enable-scsibuffersize=N Specify the buffer size of the buffer for SCSI commands. The default value is 131072 bytes (128 kb). This may be changed at runtime by setting the environment variable SANE_SG_BUFFERSIZE to the desired value. The option is Linux-only at this time. --enable-scsibuffersize and SANE_SG_BUFFERSIZE have no effect for the Mustek, Umax and Sharp backends. For these backends, the buffer size is set automatically and/or can be specified in the backend's configuration file. Please refer to the backend's man pages for details. In addition to these SANE-specific configuration options, there are many standard-options. To get a description of available standard option, invoke configure with option --help. If you plan on debugging one of the SANE programs, we recommend to run configure like this: CFLAGS="-g -O -Wall" ./configure --disable-shared For operating system specific information, look at the README.* files. Build ===== To build SANE, simply type "make" in the top-level directory. Installation and Configuration ============================== Once the build has finished, install SANE with "make install". By default, this will place the SANE libraries in /usr/local/lib/, the configuration files in /usr/local/etc/sane.d/, and the manual pages in /usr/local/man/. The location of these directories can be overridden with configure options; see "configure --help" for details. Before running any SANE program, read the PROBLEMS file in this directory. For information on configuring and trouble-shooting the various SANE components, please refer to the manual pages and other documentation listed below: Regarding: Read: ----------------- ------------------------------------------ Frontends: scanimage scanimage(1) xscanimage xscanimage(1) saned saned(1) xcam xcam(1) Backends for scanners: Abaton sane-abaton(5) AGFA Focus sane-agfafocus(5) AGFA SnapScan sane-snapscan(5) Apple sane-apple(5) Artec sane-artec(5) Avision sane-avision(5) Canon sane-canon(5) Nikon Coolscan sane-coolscan(5) Epson sane-epson(5) Fujitsu sane-fujitsu(5) HP sane-hp(5) Microtek sane-microtek(5) Microtek SCSI-2 sane-microtek2(5) Mustek sane-mustek(5) Mustek parallel port sane-mustek_pp(5) Plustek sane-plustek(5) Ricoh sane-ricoh(5) Sharp sane-sharp(5) Siemens S9036 sane-s9036(5) Siemens ST400,ST800 sane-st400(5) Tamarack sane-tamarack(5) UMAX sane-umax(5) Backends for digital cameras: Connectix QuickCam sane-qcam(5) Kodak DC20/DC25 sane-dc25(5) Kodak dc210 sane-dc210(5) Polaroid sane-dmc(5) Miscellaneous backends: PNM image reader sane-pnm(5) PINT scanners sane-pint(5) Video for Linux sane-v4l(5) Miscellaneous: Dynamic loading sane-dll(5) Networking sane-net(5) and saned(1) SCSI configuration sane-scsi(5) For more details on supported scanners and cameras look at the SANE website: http://www.mostang.com/sane/sane-backends.html Please note that the default configuration uses sane-dll as the top-level backend. Hence it is probably a good idea to start with reading sane-dll(5). The top-level backend is determined by the libsane.* symlinks in /usr/local/lib/. For SCSI scanners reading of sane-scsi(5) is recommended. Please also read the file PROJECTS for projects that are planned or not yet included into the SANE distribution. If you encounter any problems with getting your device(s) recognized, try setting the various environment variables that are there to assist in debugging such problems. The environment variables are documented in the relevant manual pages. For example, to get the maximum amount of debug information when testing a Mustek scanner, set environment variables SANE_DEBUG_DLL, SANE_DEBUG_MUSTEK, and SANE_DEBUG_SANEI_SCSI to 128 and then invoke scanimage or whatever program you're trying to debug. For a Mustek scanner at /dev/scanner, you might want to invoke scanimage as follows: scanimage -d mustek:/dev/scanner -h If this works, you could try to acquire an image with: scanimage -d mustek:/dev/scanner >t.pnm If you are not sure what generic SCSI device your scanner is connected to, try the command tools/find-scanner. It is normally sufficient to invoke the program without any arguments. Invoking this command should produce output similar to this: $ tools/find-scanner find-scanner: found "MUSTEK MFC-06000CZ 1.01" at device /dev/scanner find-scanner: found "MUSTEK MFC-06000CZ 1.01" at device /dev/sge Note that find-scanner will find any scanner that is connected to a SCSI bus. It will even find scanners that are not supported at all by SANE. There may be several causes for the following messages from the frontends: "scanimage: no SANE devices found" or "xscanimage: no devices available.". * Your scanner is not recognized by any backend. It is not supported. You may ask the maintainer of your backend (see AUTHORS) or sane-devel@mostang.com if support is planned. * SANE can't access the device files (e.g /dev/sga). Check the permissions. * Your backend is not listed in dll.conf (or commented out). The tools directory contains some small programs that may be helpfull. They are described in tools/README.