1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
|
-*-Mode: Outline-*-
How to configure, build, and install 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
- 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 is know to build on the following platforms:
- AIX
- Digital Unix (Alpha) [no generic SCSI support]
- FreeBSD
- FreeSCO
- HP-UX (PA-RISC)
- IRIX
- Linux (Alpha, m68k, x86)
- NetBSD (x86?)
- OpenStep/NeXTStep (x86) [xscanimage/xcam untested]
- OS/2
- Solaris (SPARC)
- SunOS (SPARC) [no generic SCSI support]
For a detailed support matrix, see:
http://www.mostang.com/sane/sane-support.html
* 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.
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
** AIX
Under AIX, you'll need the generic SCSI device driver gsc written by
Matthew Jacob <mjacob@feral.com> (nice piece of work!). When you
install this driver, copy the header file gscdds.h to /usr/include, as
we look for it there.
Find this driver under:
ftp://ftp.feral.com/pub/aix/gsc.tar.gz
ftp://ftp.thp.Uni-Duisburg.DE/pub/source/gsc.tar.gz
** HP-UX
Under HP-UX, it is necessary to add options -Aa and -D_HPUX_SOURCE to
the compiler flags when using HP's C compiler (not gcc). This can be
done by invoking configure with:
CC=cc CPPFLAGS=-D_HPUX_SOURCE CFLAGS=-Aa ./configure
** Solaris
See README.solaris.
* 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.
For information on configuring and trouble-shooting the various SANE
components, please refer to the manual pages listed below:
Regarding: Read:
----------------- ------------------------------------------
scanimage scanimage(1)
xscanimage xscanimage(1)
saned saned(1)
xcam no man-page---see frontend/xcam.README
Dynamic loading sane-dll(5)
Mustek scanners sane-mustek(5) and sane-scsi(5)
UMAX scanners sane-umax(5) and sane-scsi(5)
HP scanners sane-hp(5) and sane-scsi(5)
Networking sane-net(5) and saned(1)
PINT scanners sane-pint(5)
QuickCam sane-qcam(5)
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/.
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
|
