Scanner Access Now Easy ― Backends
 
 
 
 
 
 
Go to file
Matto Marjanovic 34f44f87cd Small fixes to microtek backend:
o Use 'expanded contrast/exposure settings' inquiry data to dynamically
   set ranges for those options.
 o Incorporate patches for Polaroid SprintScan 35LE  (from Dick Bruijn)
    - added "Polaroid" vendor string
    - screwed around with 'brightness' setting
    - attached 'negative scan' button
 o sane_exit() now frees the devlist allocated by sane_get_devices()
 o upped version to 0.12.2
2001-05-23 16:51:41 +00:00
backend Small fixes to microtek backend: 2001-05-23 16:51:41 +00:00
doc Added target "uninstall". 2001-05-21 20:20:54 +00:00
frontend Added target "uninstall". 2001-05-21 20:20:54 +00:00
include Used a more suitable comment. 2001-05-17 21:43:36 +00:00
japi Move javac and javah to make variables. 2000-09-17 03:02:24 +00:00
lib Added target "uninstall". 2001-05-21 20:20:54 +00:00
sanei Added target "uninstall". 2001-05-21 20:20:54 +00:00
testsuite Started on runtime test suite. Currently only tests if PNM test 2001-02-22 09:53:08 +00:00
tools Added target "uninstall". 2001-05-21 20:20:54 +00:00
AUTHORS Updated documentation concerning sm3600 backend and added 2001-05-16 19:06:21 +00:00
COPYING Initial revision 1999-08-09 18:06:01 +00:00
ChangeLog Wiped old repository. Imported v1.0.1. 1999-08-09 18:06:01 +00:00
LEVEL2 Added point about sane_init results != SANE_STATUS_GOOD. 2001-05-13 15:57:57 +00:00
LICENSE Initial revision 1999-08-09 18:06:01 +00:00
Makefile.in Added target "uninstall". 2001-05-21 20:20:54 +00:00
NEWS Wiped old repository. Imported v1.0.1. 1999-08-09 18:06:01 +00:00
PROBLEMS 2001-04-22 Henning Meier-Geinitz <henning@meier-geinitz.de> 2001-04-22 20:01:30 +00:00
PROJECTS Removed sm3600. 2001-05-16 19:11:31 +00:00
README Added "man sane" to quick install. Added paragraph about old 2001-05-21 20:31:09 +00:00
README.aix Added mention of the AIX 5.1 version of the passthru driver. 1994-09-07 02:48:51 +00:00
README.hp-ux Use gmake if make doesn't work. 2001-05-13 15:58:59 +00:00
README.linux sanei_scsi.c: Fixed a buf in the rror handling for the Linux SG driver v3.x; 2001-04-10 22:38:01 +00:00
README.os2 Merge devel (v1.0.3) into head branch. 2000-08-12 15:11:46 +00:00
README.solaris Added support for Solaris sgen SCSI driver (patch from Juergen Keil 2001-05-01 21:08:45 +00:00
README.unixware2 2000-11-24 Henning Meier-Geinitz <hmg@gmx.de> 2000-11-24 22:21:32 +00:00
README.unixware7 2000-11-24 Henning Meier-Geinitz <hmg@gmx.de> 2000-11-24 22:21:32 +00:00
TODO Wiped old repository. Imported v1.0.1. 1999-08-09 18:06:01 +00:00
acinclude.m4 Added Irix to the list of operating systems that can use -Wl,-rpath. 2001-05-01 19:37:35 +00:00
aclocal.m4 Added Irix to the list of operating systems that can use -Wl,-rpath. 2001-05-01 19:37:35 +00:00
config.guess Upgraded to latest version from <URL:ftp://ftp.gnu.org/pub/gnu/config/>. 2000-09-17 07:33:39 +00:00
config.sub Upgraded to latest version from <URL:ftp://ftp.gnu.org/pub/gnu/config/>. 2000-09-17 07:33:39 +00:00
configure Wiped old repository. Imported v1.0.1. 1999-08-09 18:06:01 +00:00
configure.in Wiped old repository. Imported v1.0.1. 1999-08-09 18:06:01 +00:00
configure.os2 Merge devel (v1.0.3) into head branch. 2000-08-12 15:11:46 +00:00
install-sh Merged main branch with current DEVEL_1_9. 2000-03-05 13:57:25 +00:00
ltconfig 2000-11-22 Oliver Rauch <Oliver.Rauch@Wolfsburg.DE> 2000-11-22 23:10:46 +00:00
ltmain.sh Merge devel (v1.0.3) into head branch. 2000-08-12 15:11:46 +00:00
mkinstalldirs Merged main branch with current DEVEL_1_9. 2000-03-05 13:57:25 +00:00
sane-backends.lsm Added keyword gphoto. 1994-11-04 13:13:55 +00:00

README

How to configure, build, and install SANE.

Introduction:
=============
SANE stands for Scanner Access Now Easy.
This package contains the SANE libraries (this means backends and
network scanning parts) and the command line frontend scanimage.
You always find the most recent version of SANE on:

  http://www.mostang.com/sane

The source is available via anonymous CVS, hosted by The Hungry
Programmers. Information on the CVS repository is available from
<URL:http://www.student.uit.no/~pere/linux/sane/cvs-server.html>.  The
following will fetch the latests source:

  cvs -d :pserver:anoncvs@anoncvs.hungry.com:/cvsroot login 
  [password "anoncvs"] 
  cvs -d :pserver:anoncvs@anoncvs.hungry.com:/cvsroot co sane

There are several graphical frontends available for SANE.
XSane is available on http://www.xsane.org
The graphical frontends that have been included into the sane package up to
version sane-1.0.3 (xscanimage and xcam) have been put into an own package
sane-frontends-1.0.x, this package is available on http://www.mostang.com/sane


Quick install:
==============

./configure
make
make install

man sane

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

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.

Please check that there aren't any older versions of SANE installed on your
system. Especially if sane-libraries are installed in a different prefix
directory (e.g. /usr/lib) this may cause problems with external
frontends. Please remove these libraries (libsane.*, sane/libsane-*) before
installing this version of SANE.

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
	(<dlfcn.h> 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 configuration options, there are some more SANE-specific
options and many standard-options.  To get a description of available options,
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.

To clean up the executables and libraries in the source directory, type "make
clean". To restore everything to the status after unpacking the package, type
"make distclean".


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 page sane(7).

The tools directory contains some small programs that may be helpfull. They
are described in tools/README.

Removing
========

Type "make uninstall" to remove SANE from your system. This will also remove
older versions of SANE if they have been installed at the same prefix.
Warning: Your configuration in etc/sane.d/*.conf will be deleted also.