Supporting the PIE PowerSlide / Reflecta DigitDia slide scanners
C Shell Other Other
Latest commit 056f590 Jan 22, 2016 @dwery dwery epsonds: fixed comment
Permalink
Failed to load latest commit information.
backend epsonds: fixed comment Jan 22, 2016
doc pixma: backend version 0.17.25 Jan 8, 2016
frontend saned: Use system header IPv6 test macros if available Jan 2, 2016
include Merge all compatibility macros around __func__ and __FUNCTION__ Dec 20, 2015
japi autoheader and automake Oct 3, 2015
lib md5: Avoid the need for casting Jan 8, 2016
m4 Improve snmp detection when cross compiling. Aug 15, 2013
po autoheader and automake Oct 3, 2015
sanei sanei_thread: fix [-Wmaybe-uninitialized] compiler warning Dec 27, 2015
testsuite Use consistently __func__ instead of __FUNCTION__ Dec 20, 2015
tools Fix typos in comments Dec 20, 2015
.gitignore .gitignore: ignore all .* files Jul 3, 2013
AUTHORS New backend pieusb Aug 31, 2015
COPYING Initial revision Aug 9, 1999
ChangeLog Document ChangeLog policy change Dec 20, 2015
ChangeLog-1.0.0 Splitted ChangeLog to limit filesize. Editing became slow on smaller … Jan 9, 2002
ChangeLog-1.0.1 Splitted ChangeLog to limit filesize. Editing became slow on smaller … Jan 9, 2002
ChangeLog-1.0.10 Moved old ChageLog entries to ChangeLog-1.0.10. Feb 1, 2003
ChangeLog-1.0.12 Warnings enabled again. Added -cvs to version. May 25, 2003
ChangeLog-1.0.13 updated to backend version 1.0.44, updated maintainer email addy Jan 27, 2007
ChangeLog-1.0.14 Ulrich Deiters: removed option "OPT_PAGE" from Canon-SCSI backend May 21, 2004
ChangeLog-1.0.15 Moved ChangeLog to ChangeLog 1.0.15. Nov 7, 2004
ChangeLog-1.0.16 Moved ChangeLog to ChangeLog-1.0.16. Aug 7, 2005
ChangeLog-1.0.17 Moved old ChangeLog. Dec 18, 2005
ChangeLog-1.0.18 Changed version to 1.0.18-cvs. Enabled compilation warnings. Jul 3, 2006
ChangeLog-1.0.19 sane 1.0.19-cvs Feb 11, 2008
ChangeLog-1.0.2 Splitted ChangeLog to limit filesize. Editing became slow on smaller … Jan 9, 2002
ChangeLog-1.0.20 changelog from 1.0.20 in new file May 5, 2009
ChangeLog-1.0.21 reopen development with v1.0.22git Apr 26, 2010
ChangeLog-1.0.22 setup for development of 1.0.23 Feb 14, 2011
ChangeLog-1.0.23 Starting sane-backends 1.0.24git Aug 26, 2012
ChangeLog-1.0.24 starting 1.0.25git Oct 1, 2013
ChangeLog-1.0.25 reopen sane-backends 1.0.26git Oct 5, 2015
ChangeLog-1.0.3 Splitted ChangeLog to limit filesize. Editing became slow on smaller … Jan 9, 2002
ChangeLog-1.0.4 Splitted ChangeLog to limit filesize. Editing became slow on smaller … Jan 9, 2002
ChangeLog-1.0.5 Splitted ChangeLog to limit filesize. Editing became slow on smaller … Jan 9, 2002
ChangeLog-1.0.6 Oliver Rauch: Sep 22, 2002
ChangeLog-1.0.7 Oliver Rauch: Sep 22, 2002
ChangeLog-1.0.8 Oliver Rauch: Sep 22, 2002
ChangeLog-1.0.9 Moved Ulrich Deiters' changes to the current ChangeLog file. Nov 13, 2002
INSTALL Improve snmp detection when cross compiling. Aug 15, 2013
LICENSE Add an FAQ section to the LICENSE file. Apr 23, 2005
Makefile.am reopen sane-backends 1.0.26git Oct 5, 2015
Makefile.in reopen sane-backends 1.0.26git Oct 5, 2015
NEWS sane-backends 1.0.25 Oct 4, 2015
PROBLEMS Removed pnm problem description. It's not relevant for normal users and Jan 5, 2006
PROJECTS Removed link to BeOS (link goes to nowhere, SANE website has links to Oct 3, 2005
README Add --disable-dynamic/--disable-preload and update docs Nov 9, 2011
README.aix fixed urls Oct 21, 2003
README.beos Added BeOS platform information. Updated Makefiles concerning READMEs. Sep 12, 2002
README.darwin New date for good libusb from CVS Sep 17, 2005
README.djpeg Moved from djpeg.README in backend directory Jul 26, 2003
README.freebsd Add hint about configure and freebsd Ports location May 19, 2010
README.hp-ux Mention trouble with higher optimization levels (from Ulrich Deiters May 28, 2004
README.linux fix typo Aug 21, 2015
README.netbsd Mention SCSI buffer size problems and uk/ss files issue. Jun 8, 2004
README.openbsd 2007-04-5 Jochen Eisinger <jochen@penguin-breeder.org> Apr 5, 2007
README.os2 Updated contact information (website, mailing lists, bug tracker). Mi… Sep 24, 2003
README.solaris Added link to installation report. Feb 12, 2006
README.unixware2 2000-11-24 Henning Meier-Geinitz <hmg@gmx.de> Nov 24, 2000
README.unixware7 2000-11-24 Henning Meier-Geinitz <hmg@gmx.de> Nov 24, 2000
README.windows update README.windows to include mingw info. Nov 9, 2011
README.zeta Changes to support SANE on ZETA. Not all Jul 15, 2005
acinclude.m4 Change compile time warning policy Dec 26, 2015
aclocal.m4 rebuild with automake 1.14.1 Sep 1, 2015
compile Improve snmp detection when cross compiling. Aug 15, 2013
config.guess sane-backends 1.0.25 Oct 4, 2015
config.sub sane-backends 1.0.25 Oct 4, 2015
configure Change compile time warning policy Dec 26, 2015
configure.in Escape [] for configure help strings Oct 27, 2015
depcomp Improve snmp detection when cross compiling. Aug 15, 2013
install-sh Improve snmp detection when cross compiling. Aug 15, 2013
ltmain.sh Improve snmp detection when cross compiling. Aug 15, 2013
missing Improve snmp detection when cross compiling. Aug 15, 2013
mkinstalldirs Improve snmp detection when cross compiling. Aug 15, 2013
sane-backends.lsm setup for release 1.0.21 Apr 26, 2010
test-driver Improve snmp detection when cross compiling. Aug 15, 2013

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.sane-project.org/

At the same location there are also links to snapshots of the CVS server and
sometimes beta releases of sane-backends. These are unstable development
versions, so be careful when using them. Please report any problems to us. See
contact section for details.

There are several graphical frontends available for SANE, see the list at
http://www.sane-project.org/sane-frontends.html.


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

Some more libraries are not strictly necessary to compile SANE, but some
functionality may be lost if they are not available. Make sure that these
libraries and their respective header files are available before running
configure. On some Linux distributions the header files are part of separate
packages (e.g. usb.h in libusb-devel or libusb-dev). These must also be
installed.

        - libusb (>=0.1.8): Strongly recommended if you use a USB scanner.
          Some backends won't work without libusb at all.

        - libjpeg (>=6B): For the dc210, dc240, and gphoto2 backends.

        - libieee1284 (>=0.1.5): For some parallel port backends.

        - libgphoto2 (>=2.0): For the gphoto2 backend.

SANE should build on most Unix-like systems. Support for OS/2, MacOS X, BeOS,
and Microsoft Windows is also available. For more details look at the
operating system specific README.* files. For a detailed support matrix, see:

    http://www.sane-project.org/sane-support.html

This table may be out of date. Please tell us about any corrections or
additions. Please mention your operating system and platform and all the other
details mentioned in the table. See also the contact section.

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-*) by using
your packet manager or manually 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 --enable-static 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 -ldl).

 --enable-static
        Use static libraries (turned off by default).

 --enable-preload
        Preload backends into DLL backend.  This is useful for debugging,
	when dynamic loading is unavailable, to reduce runtime linking
	overheads, or when you only want to distribute a single DLL with
	all backends available.  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.

--disable-translations
	Disable installation of translated backend options. If you get
	errors in the po/ directory during build, use this option.
	See po/README for details.

--enable-locking
	Means, that some backends will use a lockfile for allowing multiple
	access to one scanner. This is useful, i.e. one frontend is scanning
	the button status and another one will scan. The path to the lock
	files is define by --localstatedir at the configure step and is
	$localstatedir/lock/sane. The default group is uucp and can be
	changed by using --with-group=newgroup. If you do not want any
	backend to use a lockfile, simply use --disable-locking.

To limit the backends that are compiled, set the variable BACKENDS to
the list of backends to compile.  The following will limit compiling
to the epson2 and fujitsu backends:

  ./configure BACKENDS="epson2 fujitsu"

To limit the backends that are preloaded into the DLL, set the variable
PRELOADABLE_BACKENDS.  The following will limit compiling  to the epson2
and fujitsu backends but only preloads the epson2 backend:

  ./configure BACKENDS="epson2 futjisu" PRELOADABLE_BACKENDS="epson2"

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 helpful. 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 files will be deleted also so make sure you have a
backup. By default the configuration files are located in the directory
/usr/local/etc/sane.d/.


Contact
=======

For questions and general discussion about SANE contact the sane-devel mailing
list. You must be subscribed to the list to send mail. See
http://www.sane-project.org/mailing-lists.html for details.

If you want to submit a bug report or feature request please use our bug
tracking system.  See http://www.sane-project.org/bugs.html for details. You
may also contact the author of a specific backend directly. See the AUTHORS
file for a list of addresses.