kopia lustrzana https://gitlab.com/sane-project/website
524 wiersze
19 KiB
HTML
524 wiersze
19 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"
|
|
"http://www.w3.org/TR/REC-html40/loose.dtd">
|
|
<HTML>
|
|
<HEAD>
|
|
<TITLE>sane-devel: Re: README updates?</TITLE>
|
|
<META NAME="Author" CONTENT="Henning Meier-Geinitz (hmg-ml@gmx.de)">
|
|
<META NAME="Subject" CONTENT="Re: README updates?">
|
|
</HEAD>
|
|
<BODY BGCOLOR="#FFFFFF" TEXT="#000000">
|
|
<H1>Re: README updates?</H1>
|
|
<!-- received="Tue May 9 15:36:20 2000" -->
|
|
<!-- isoreceived="20000509223620" -->
|
|
<!-- sent="Wed, 10 May 2000 00:34:43 +0200" -->
|
|
<!-- isosent="20000509223443" -->
|
|
<!-- name="Henning Meier-Geinitz" -->
|
|
<!-- email="hmg-ml@gmx.de" -->
|
|
<!-- subject="Re: README updates?" -->
|
|
<!-- id="20000510003443.B3938@hmg1.vortex.swb.de" -->
|
|
<!-- inreplyto="200005080409.MAA03243@localhost.localdomain" -->
|
|
<STRONG>From:</STRONG> Henning Meier-Geinitz (<A HREF="mailto:hmg-ml@gmx.de?Subject=Re:%20README%20updates?&In-Reply-To=<20000510003443.B3938@hmg1.vortex.swb.de>"><EM>hmg-ml@gmx.de</EM></A>)<BR>
|
|
<STRONG>Date:</STRONG> Tue May 09 2000 - 15:34:43 PDT
|
|
<P>
|
|
<!-- next="start" -->
|
|
<LI><STRONG>Next message:</STRONG> <A HREF="0073.html">Henning Meier-Geinitz: "Re: README updates?"</A>
|
|
<UL>
|
|
<LI><STRONG>Previous message:</STRONG> <A HREF="0071.html">Simon Eder: "AGFA Snapscan 1212p"</A>
|
|
<LI><STRONG>In reply to:</STRONG> <A HREF="0059.html">Petter Reinholdtsen: "Re: README updates?"</A>
|
|
<!-- nextthread="start" -->
|
|
<LI><STRONG>Next in thread:</STRONG> <A HREF="0074.html">Robert Schwebel: "Re: README updates?"</A>
|
|
<LI><STRONG>Next in thread:</STRONG> <A HREF="0061.html">abel deuring: "Re: README updates?"</A>
|
|
<LI><STRONG>Reply:</STRONG> <A HREF="0074.html">Robert Schwebel: "Re: README updates?"</A>
|
|
<LI><STRONG>Reply:</STRONG> <A HREF="0105.html">Henning Meier-Geinitz: "Re: README updates?"</A>
|
|
<!-- reply="end" -->
|
|
<LI><STRONG>Messages sorted by:</STRONG>
|
|
<A HREF="date.html#72">[ date ]</A>
|
|
<A HREF="index.html#72">[ thread ]</A>
|
|
<A HREF="subject.html#72">[ subject ]</A>
|
|
<A HREF="author.html#72">[ author ]</A>
|
|
</UL>
|
|
<HR NOSHADE><P>
|
|
<!-- body="start" -->
|
|
<P>
|
|
Hi,
|
|
<BR>
|
|
<P><EM>> It seems like a good idea. A cleanup and/or rewrite of the README
|
|
</EM><BR>
|
|
<EM>> would be a good idea. Would you be willing to draft the new version?
|
|
</EM><BR>
|
|
<P>Ok, this is the first (raw) draft. It's mostly a cleanup of the old version.
|
|
<BR>
|
|
I changed the formatting a bit, moved the os specific things to their own
|
|
<BR>
|
|
files and added all the backends I found. Comments and questions are in
|
|
<BR>
|
|
square brackets []. Please look for spelling and grammar errors, too.
|
|
<BR>
|
|
<P>Bye,
|
|
<BR>
|
|
Henning
|
|
<BR>
|
|
<P>------------------------ README ------------------------------
|
|
<BR>
|
|
-*-Mode: Outline-*-
|
|
<BR>
|
|
^^^^^^^^^^^^^^^^^^^
|
|
<BR>
|
|
[what's this?]
|
|
<BR>
|
|
<P>How to configure, build, and install SANE.
|
|
<BR>
|
|
<P>Quick install:
|
|
<BR>
|
|
==============
|
|
<BR>
|
|
<P>./configure
|
|
<BR>
|
|
make
|
|
<BR>
|
|
make install
|
|
<BR>
|
|
<P>Prerequisites
|
|
<BR>
|
|
=============
|
|
<BR>
|
|
<P>In order to build SANE, the following tools and libraries are required:
|
|
<BR>
|
|
<P> - GNU make: version 3.70 or newer
|
|
<BR>
|
|
<P> - ANSI C compiler: GNU C (gcc) is recommended for best performance,
|
|
<BR>
|
|
but any ANSI-compliant compiler should do
|
|
<BR>
|
|
<P> - To build the graphical frontends (xscanimage and xcam), it is
|
|
<BR>
|
|
necessary to have the GTK libraries (libgtk, libgdk, and
|
|
<BR>
|
|
libglib) and associated header files installed. In
|
|
<BR>
|
|
addition, if you want to use xscanimage from within GIMP,
|
|
<BR>
|
|
you'll need to make sure libgimp (version 0.99.13 or newer)
|
|
<BR>
|
|
and its header files are installed as well. The GTK libraries and
|
|
<BR>
|
|
GIMP can be obtained from:
|
|
<BR>
|
|
<P> <A HREF="ftp://ftp.gimp.org/pub/">ftp://ftp.gimp.org/pub/</A>
|
|
<BR>
|
|
<P>SANE is known to build on the following platforms:
|
|
<BR>
|
|
<P> - AIX
|
|
<BR>
|
|
- Digital Unix (Alpha) [no generic SCSI support]
|
|
<BR>
|
|
- FreeBSD
|
|
<BR>
|
|
- FreeSCO
|
|
<BR>
|
|
- HP-UX (PA-RISC)
|
|
<BR>
|
|
- IRIX
|
|
<BR>
|
|
- Linux (Alpha, m68k, x86)
|
|
<BR>
|
|
- NetBSD (x86?)
|
|
<BR>
|
|
- OpenStep/NeXTStep (x86) [xscanimage/xcam untested]
|
|
<BR>
|
|
- OS/2
|
|
<BR>
|
|
- Solaris (SPARC)
|
|
<BR>
|
|
- SunOS (SPARC) [no generic SCSI support]
|
|
<BR>
|
|
<P>[up-to-date? The only thing I know is that SANE 1.0.2 compiles and works under
|
|
<BR>
|
|
Linux/x86 and compiles under Irix5.3 (pnm works, don't know about SCSI)]
|
|
<BR>
|
|
<P>For a detailed support matrix, see:
|
|
<BR>
|
|
<P> <A HREF="http://www.mostang.com/sane/sane-support.html">http://www.mostang.com/sane/sane-support.html</A>
|
|
<BR>
|
|
<P>[which is not up-to-date either]
|
|
<BR>
|
|
<P><P>Configuration
|
|
<BR>
|
|
=============
|
|
<BR>
|
|
<P>Simply invoke configure in the top-level directory. Besides the usual
|
|
<BR>
|
|
GNU configure options, there are the following SANE specific options:
|
|
<BR>
|
|
<P> --disable-shared
|
|
<BR>
|
|
Don't use shared libraries. Useful for debugging or when there
|
|
<BR>
|
|
is a problem building shared libraries. This implicitly turns
|
|
<BR>
|
|
on --disable-dynamic as well.
|
|
<BR>
|
|
<P> --disable-dynamic
|
|
<BR>
|
|
Disable dynamic loading of backends (in the dll backend).
|
|
<BR>
|
|
configure normally turns on dynamic loading when it
|
|
<BR>
|
|
can find the appropriate header files and libraries
|
|
<BR>
|
|
(<dlfcn.h> and -dl).
|
|
<BR>
|
|
<P> --enable-preload
|
|
<BR>
|
|
Preload backends into DLL backend. This is useful for debugging,
|
|
<BR>
|
|
when dynamic loading is unavailable, or to reduce runtime linking
|
|
<BR>
|
|
overheads. If dynamic loading or shared libraries are unavailable
|
|
<BR>
|
|
or disabled, this option is turned on automatically.
|
|
<BR>
|
|
|
|
<BR>
|
|
--enable-scsibuffersize=N
|
|
<BR>
|
|
Specify the buffer size of the buffer for SCSI commands. The default
|
|
<BR>
|
|
value is 131072 bytes (128 kb). This may be changed at runtime by
|
|
<BR>
|
|
setting the environment variable SANE_SG_BUFFERSIZE to the desired
|
|
<BR>
|
|
value. The option is Linux-only at this time.
|
|
<BR>
|
|
[is this true?]
|
|
<BR>
|
|
<P>In addition to these SANE-specific configuration options, there are
|
|
<BR>
|
|
many standard-options. To get a description of available standard
|
|
<BR>
|
|
option, invoke configure with option --help.
|
|
<BR>
|
|
<P>If you plan on debugging one of the SANE programs, we recommend to run
|
|
<BR>
|
|
configure like this:
|
|
<BR>
|
|
<P> CFLAGS="-g -O -Wall" ./configure --disable-shared
|
|
<BR>
|
|
<P>For operating system specific information, look at the README.* files.
|
|
<BR>
|
|
<P><P>Build
|
|
<BR>
|
|
=====
|
|
<BR>
|
|
<P>To build SANE, simply type "make" in the top-level directory.
|
|
<BR>
|
|
<P><P>Installation and Configuration
|
|
<BR>
|
|
==============================
|
|
<BR>
|
|
<P>Once the build has finished, install SANE with "make install". By
|
|
<BR>
|
|
default, this will place the SANE libraries in /usr/local/lib/, the
|
|
<BR>
|
|
configuration files in /usr/local/etc/sane.d/, and the manual pages in
|
|
<BR>
|
|
/usr/local/man/. The location of these directories can be overridden
|
|
<BR>
|
|
with configure options; see "configure --help" for details.
|
|
<BR>
|
|
<P>Before running any SANE program, read the PROBLEMS file in this directory.
|
|
<BR>
|
|
For information on configuring and trouble-shooting the various SANE
|
|
<BR>
|
|
components, please refer to the manual pages and other documentation listed
|
|
<BR>
|
|
below:
|
|
<BR>
|
|
<P> Regarding: Read:
|
|
<BR>
|
|
----------------- ------------------------------------------
|
|
<BR>
|
|
Frontends:
|
|
<BR>
|
|
scanimage scanimage(1)
|
|
<BR>
|
|
xscanimage xscanimage(1)
|
|
<BR>
|
|
saned saned(1)
|
|
<BR>
|
|
xcam frontend/xcam.README
|
|
<BR>
|
|
[move xcam.README to doc/ (better: add a man page)?]
|
|
<BR>
|
|
<P> Backends for scanners:
|
|
<BR>
|
|
Abaton sane-abaton(5)
|
|
<BR>
|
|
AGFA Focus sane-agfafocus(5)
|
|
<BR>
|
|
AGFA SnapScan <A HREF="http://www.cs.ualberta.ca/~charter/SnapScan/snapscan.html">http://www.cs.ualberta.ca/~charter/SnapScan/snapscan.html</A>
|
|
<BR>
|
|
[add man page?]
|
|
<BR>
|
|
Apple sane-apple(5)
|
|
<BR>
|
|
Artec sane-artec(5)
|
|
<BR>
|
|
Avision <A HREF="http://www.rene.rebe.myokay.net/avision/index.html">http://www.rene.rebe.myokay.net/avision/index.html</A>
|
|
<BR>
|
|
Canon doc/canon.README
|
|
<BR>
|
|
Nikon Coolscan <A HREF="http://www.sema.be/coolscan/">http://www.sema.be/coolscan/</A>
|
|
<BR>
|
|
[add man pages?]
|
|
<BR>
|
|
Epson sane-epson(5)
|
|
<BR>
|
|
Fujitsu sane-fujitsu(5)
|
|
<BR>
|
|
HP sane-hp(5)
|
|
<BR>
|
|
Microtek sane-microtek(5)
|
|
<BR>
|
|
Mikrotek SCSI-2 sane-microtek2(5)
|
|
<BR>
|
|
Mustek sane-mustek(5)
|
|
<BR>
|
|
Sharp sane-sharp(5)
|
|
<BR>
|
|
UMAX sane-umax(5)
|
|
<BR>
|
|
|
|
<BR>
|
|
Backends for digital cameras:
|
|
<BR>
|
|
Connectix QuickCam sane-qcam(5)
|
|
<BR>
|
|
Kodak DC20/DC25 sane-dc25(5)
|
|
<BR>
|
|
Polaroid sane-dmc(5)
|
|
<BR>
|
|
|
|
<BR>
|
|
Miscellaneous backends:
|
|
<BR>
|
|
PNM image reader sane-pnm(5)
|
|
<BR>
|
|
PINT scanners sane-pint(5)
|
|
<BR>
|
|
<P> Miscellaneous:
|
|
<BR>
|
|
Dynamic loading sane-dll(5)
|
|
<BR>
|
|
Networking sane-net(5) and saned(1)
|
|
<BR>
|
|
SCSI configuration sane-scsi(5)
|
|
<BR>
|
|
<P>[I couldn't find any documentation for:
|
|
<BR>
|
|
Kodak dc210
|
|
<BR>
|
|
Ricoh
|
|
<BR>
|
|
Siemens S9036
|
|
<BR>
|
|
Tamarack
|
|
<BR>
|
|
<P> Are any backends missing? Some backends are for more than one vendor,
|
|
<BR>
|
|
should I add more vendors?]
|
|
<BR>
|
|
<P>For more details on supported scanners and cameras look at the SANE
|
|
<BR>
|
|
website: <A HREF="http://www.mostang.com/sane/sane-backends.html">http://www.mostang.com/sane/sane-backends.html</A>
|
|
<BR>
|
|
<P>Please note that the default configuration uses sane-dll as the
|
|
<BR>
|
|
top-level backend. Hence it is probably a good idea to start with
|
|
<BR>
|
|
reading sane-dll(5). The top-level backend is determined by the
|
|
<BR>
|
|
libsane.* symlinks in /usr/local/lib/.
|
|
<BR>
|
|
<P>For SCSI scanners reading of sane-scsi(5) is recommended.
|
|
<BR>
|
|
<P>If you encounter any problems with getting your device(s) recognized,
|
|
<BR>
|
|
try setting the various environment variables that are there to assist
|
|
<BR>
|
|
in debugging such problems. The environment variables are documented
|
|
<BR>
|
|
in the relevant manual pages. For example, to get the maximum amount
|
|
<BR>
|
|
of debug information when testing a Mustek scanner, set environment
|
|
<BR>
|
|
variables SANE_DEBUG_DLL, SANE_DEBUG_MUSTEK, and SANE_DEBUG_SANEI_SCSI
|
|
<BR>
|
|
to 128 and then invoke scanimage or whatever program you're trying to
|
|
<BR>
|
|
debug. For a Mustek scanner at /dev/scanner, you might want to invoke
|
|
<BR>
|
|
scanimage as follows:
|
|
<BR>
|
|
<P> scanimage -d mustek:/dev/scanner -h
|
|
<BR>
|
|
<P>If this works, you could try to acquire an image with:
|
|
<BR>
|
|
<P> scanimage -d mustek:/dev/scanner >t.pnm
|
|
<BR>
|
|
<P>If you are not sure what generic SCSI device your scanner is connected
|
|
<BR>
|
|
to, try the command tools/find-scanner. It is normally sufficient to
|
|
<BR>
|
|
invoke the program without any arguments. Invoking this command
|
|
<BR>
|
|
should produce output similar to this:
|
|
<BR>
|
|
<P> $ tools/find-scanner
|
|
<BR>
|
|
find-scanner: found "MUSTEK MFC-06000CZ 1.01" at device /dev/scanner
|
|
<BR>
|
|
find-scanner: found "MUSTEK MFC-06000CZ 1.01" at device /dev/sge
|
|
<BR>
|
|
<P>The tools directory contains some small programs that may be helpfull. They
|
|
<BR>
|
|
are described in tools/README.
|
|
<BR>
|
|
--------------------------- end of README ------------------------------
|
|
<BR>
|
|
<P>--------------------------- README.aix ---------------------------------
|
|
<BR>
|
|
Under AIX, you'll need the generic SCSI device driver gsc written by
|
|
<BR>
|
|
Matthew Jacob <<A HREF="mailto:mjacob@feral.com?Subject=Re:%20README%20updates?&In-Reply-To=<20000510003443.B3938@hmg1.vortex.swb.de>">mjacob@feral.com</A>> (nice piece of work!). When you
|
|
<BR>
|
|
install this driver, copy the header file gscdds.h to /usr/include, as
|
|
<BR>
|
|
we look for it there.
|
|
<BR>
|
|
Find this driver under:
|
|
<BR>
|
|
<P> <A HREF="ftp://ftp.feral.com/pub/aix/gsc.tar.gz">ftp://ftp.feral.com/pub/aix/gsc.tar.gz</A>
|
|
<BR>
|
|
<A HREF="ftp://ftp.thp.Uni-Duisburg.DE/pub/source/gsc.tar.gz">ftp://ftp.thp.Uni-Duisburg.DE/pub/source/gsc.tar.gz</A>
|
|
<BR>
|
|
---------------------------end of README.aix ---------------------------
|
|
<BR>
|
|
<P>--------------------------- README.hp-ux -------------------------------
|
|
<BR>
|
|
Under HP-UX, it is necessary to add options -Aa and -D_HPUX_SOURCE to
|
|
<BR>
|
|
the compiler flags when using HP's C compiler (not gcc). This can be
|
|
<BR>
|
|
done by invoking configure with:
|
|
<BR>
|
|
<P> CC=cc CPPFLAGS=-D_HPUX_SOURCE CFLAGS=-Aa ./configure
|
|
<BR>
|
|
--------------------------- end of README.hp-ux ------------------------
|
|
<BR>
|
|
<P>--------------------------- README.linux -------------------------------
|
|
<BR>
|
|
Information about SCSI scanners:
|
|
<BR>
|
|
================================
|
|
<BR>
|
|
<P>Under Linux, your kernel must have generic SCSI support (sg) as well as a
|
|
<BR>
|
|
driver for your SCSI adapter. You may want to increase the SCSI buffer size
|
|
<BR>
|
|
to increase scan speed. Details on all of the above can be found in
|
|
<BR>
|
|
sane-scsi(5).
|
|
<BR>
|
|
<P>If your SCSI and sg driver are build as moduls you will need to load them
|
|
<BR>
|
|
with modprobe:
|
|
<BR>
|
|
<P># modprobe your-driver-name
|
|
<BR>
|
|
# modprobe sg
|
|
<BR>
|
|
<P>You may find error messages in /var/log/messages. Look at the documentation
|
|
<BR>
|
|
for your SCSI driver. Maybe you need to add options like the io port.
|
|
<BR>
|
|
<P>Now the SCSI adapter and your scanner should be visible at /proc/scsi/scsi.
|
|
<BR>
|
|
Example:
|
|
<BR>
|
|
<P># cat /proc/scsi/scsi
|
|
<BR>
|
|
Host: scsi0 Channel: 00 Id: 06 Lun: 00
|
|
<BR>
|
|
Vendor: SCANNER Model: Rev: 2.02
|
|
<BR>
|
|
Type: Scanner ANSI SCSI revision: 01 CCS
|
|
<BR>
|
|
<P>In this case the real vendor and scanner name are not shown (Mustek
|
|
<BR>
|
|
ScannExpress 12000SP) but SANE will detect it nevertheless.
|
|
<BR>
|
|
<P>If your scanner is supported by SANE, scanimage -L will list it now:
|
|
<BR>
|
|
<P># scanimage -L
|
|
<BR>
|
|
device mustek:/dev/scanner' is a Mustek ScanExpress 12000SP flatbed scanner
|
|
<BR>
|
|
<P>If this doesn't work you may have to add the right SCSI generic device name
|
|
<BR>
|
|
to the configuration file. This should be documented in the man page for
|
|
<BR>
|
|
your backend. To find out about the right SCSI device use tools/find-scanner:
|
|
<BR>
|
|
<P># tools/find-scanner
|
|
<BR>
|
|
find-scanner: found scanner "SCANNER 2.02" at device /dev/scanner
|
|
<BR>
|
|
find-scanner: found scanner "SCANNER 2.02" at device /dev/sg0
|
|
<BR>
|
|
find-scanner: found scanner "SCANNER 2.02" at device /dev/sga
|
|
<BR>
|
|
<P>It may help to set a soft link /dev/scanner to the respective device.
|
|
<BR>
|
|
<P>[add comment on Adaptec 1542 problems and solution or move this to
|
|
<BR>
|
|
sane-scsi(5)?]
|
|
<BR>
|
|
<P>--------------------------- end of README.linux ------------------------
|
|
<BR>
|
|
<P><PRE>
|
|
--
|
|
Source code, list archive, and docs: <A HREF="http://www.mostang.com/sane/">http://www.mostang.com/sane/</A>
|
|
To unsubscribe: echo unsubscribe sane-devel | mail <A HREF="mailto:majordomo@mostang.com?Subject=Re:%20README%20updates?&In-Reply-To=<20000510003443.B3938@hmg1.vortex.swb.de>">majordomo@mostang.com</A>
|
|
</PRE>
|
|
<P><!-- body="end" -->
|
|
<HR NOSHADE>
|
|
<UL>
|
|
<!-- next="start" -->
|
|
<LI><STRONG>Next message:</STRONG> <A HREF="0073.html">Henning Meier-Geinitz: "Re: README updates?"</A>
|
|
<LI><STRONG>Previous message:</STRONG> <A HREF="0071.html">Simon Eder: "AGFA Snapscan 1212p"</A>
|
|
<LI><STRONG>In reply to:</STRONG> <A HREF="0059.html">Petter Reinholdtsen: "Re: README updates?"</A>
|
|
<!-- nextthread="start" -->
|
|
<LI><STRONG>Next in thread:</STRONG> <A HREF="0074.html">Robert Schwebel: "Re: README updates?"</A>
|
|
<LI><STRONG>Next in thread:</STRONG> <A HREF="0061.html">abel deuring: "Re: README updates?"</A>
|
|
<LI><STRONG>Reply:</STRONG> <A HREF="0074.html">Robert Schwebel: "Re: README updates?"</A>
|
|
<LI><STRONG>Reply:</STRONG> <A HREF="0105.html">Henning Meier-Geinitz: "Re: README updates?"</A>
|
|
<!-- reply="end" -->
|
|
<LI><STRONG>Messages sorted by:</STRONG>
|
|
<A HREF="date.html#72">[ date ]</A>
|
|
<A HREF="index.html#72">[ thread ]</A>
|
|
<A HREF="subject.html#72">[ subject ]</A>
|
|
<A HREF="author.html#72">[ author ]</A>
|
|
</UL>
|
|
<!-- trailer="footer" -->
|
|
<HR NOSHADE>
|
|
<P>
|
|
<SMALL>
|
|
<EM>
|
|
This archive was generated by <A HREF="http://www.hypermail.org/">hypermail 2b29</A>
|
|
: <EM>Tue May 09 2000 - 15:38:32 PDT</EM>
|
|
</EM>
|
|
</SMALL>
|
|
</BODY>
|
|
</HTML>
|