sane-project-backends/README

177 wiersze
6.2 KiB
Plaintext
Czysty Zwykły widok Historia

1999-08-09 18:06:01 +00:00
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.
2000-11-23 23:01:36 +00:00
You always find the most recent version of SANE on:
2001-04-29 10:15:51 +00:00
http://www.mostang.com/sane/
2001-04-29 10:15:51 +00:00
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.mostang.com/sane/sane-frontends.html.
2000-08-12 15:11:46 +00:00
Quick install:
==============
./configure
make
make install
man sane
2000-08-12 15:11:46 +00:00
Prerequisites
=============
1999-08-09 18:06:01 +00:00
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:
- libusb (>=0.1.6): 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 the canon_pp and hpsj5s backends.
- libgphoto2 (>=2.0): For the gphoto2 backend.
SANE should build on most Unix-like systems. Support for OS/2, MacOS X and
BeOS is also available. For more details look at the operating system specific
README.* files. For a detailed support matrix, see:
1999-08-09 18:06:01 +00:00
2000-08-12 15:11:46 +00:00
http://www.mostang.com/sane/sane-support.html
1999-08-09 18:06:01 +00:00
This table may be out of date. Please tell us about any corrections or
additions. Please mention your operating sytem and platform and all the other
details mentioned in the table. See also the contact section.
1999-08-09 18:06:01 +00:00
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.
1999-08-09 18:06:01 +00:00
2000-08-12 15:11:46 +00:00
Configuration
=============
1999-08-09 18:06:01 +00:00
Simply invoke configure in the top-level directory. Besides the usual GNU
configure options, there are the following SANE specific options:
1999-08-09 18:06:01 +00:00
--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.
1999-08-09 18:06:01 +00:00
--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-static
Use static libraries (turned off by default).
1999-08-09 18:06:01 +00:00
--enable-preload
2000-08-12 15:11:46 +00:00
Preload backends into DLL backend. This is useful for debugging,
1999-08-09 18:06:01 +00:00
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.
2000-08-12 15:11:46 +00:00
--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.
1999-08-09 18:06:01 +00:00
--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.
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.
1999-08-09 18:06:01 +00:00
If you plan on debugging one of the SANE programs, we recommend to run
configure like this:
CFLAGS="-g -O -Wall" ./configure --disable-shared
2000-08-12 15:11:46 +00:00
For operating system specific information, look at the README.* files.
1999-08-09 18:06:01 +00:00
2000-08-12 15:11:46 +00:00
Build
=====
1999-08-09 18:06:01 +00:00
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".
2000-08-12 15:11:46 +00:00
Installation and Configuration
==============================
1999-08-09 18:06:01 +00:00
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.
2000-08-12 15:11:46 +00:00
Before running any SANE program, read the PROBLEMS file in this directory.
1999-08-09 18:06:01 +00:00
For information on configuring and trouble-shooting the various SANE
components, please refer to the manual page sane(7).
2000-08-12 15:11:46 +00:00
The tools/ directory contains some small programs that may be helpfull. They
2000-08-12 15:11:46 +00:00
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 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 general discussion about SANE, bug reports and feature requests contact
the sane-devel mailing list. You must be subscribed to the list to send
mail. See http://www.mostang.com/sane/mail.html for details.
If you have a question or bug report for a specific backend, you may also
contact the author of this backend directly. See the AUTHORS file for a list
of addresses.
If you don't want to subscribe to sane-devel and want to report bugs
concerning security, compilation, installation, porting, or documentation of
SANE, you can also contact Henning Meier-Geinitz <henning@meier-geinitz.de>.