Debian Codegraph @

upstream/debian-unstable/man5/sane-agfafocus.5

raw
1 .TH sane\-agfafocus 5 "10 Jul 2008" "" "SANE Scanner Access Now Easy"
2 .IX sane\-agfafocus
3 .SH NAME
4 sane\-agfafocus \- SANE backend for AGFA Focus flatbed scanners
5 .SH DESCRIPTION
6 The
7 .B sane\-agfafocus
8 library implements a SANE (Scanner Access Now Easy) backend that
9 provides access to AGFA Focus flatbed scanners. At present, the following
10 scanners are supported from this backend:
11 .PP
12 .RS
13 AGFA Focus GS Scanner (6 bit gray scale) (untested)
14 .br
15 AGFA Focus Lineart Scanner (lineart) (untested)
16 .br
17 AGFA Focus II (8 bit gray scale) (untested)
18 .br
19 AGFA Focus Color (24 bit color 3-pass)
20 .br
21 AGFA Focus Color Plus (24 bit color 3-pass)
22 .br
23 .PP
24 Siemens S9036 (8 bit gray scale) (untested)
25 .br
26 .RE
27 .PP
28 The driver supports line art, 6bpp and 8bpp gray, 18bpp and 24bpp
29 color scans.
30 .PP
31 If you own a scanner other than the ones listed above that works with
32 this backend, please let us know by sending the scanner's model name,
33 SCSI id, and firmware revision to
34 .IR sane\[email protected] .
35 Have a look at
36 .I http://www.sane\-project.org/mailing\-lists.html
37 concerning subscription to sane\-devel.
38 .PP
39 All of these scanners are pre-SCSI-2, and do not even report properly
40 to SCSI Inquiry. This is typically evident in SCSI bus scans, where
41 the scanner will come up with only garbage as vendor and models strings.
42
43 .SH "DEVICE NAMES"
44 This backend expects device names of the form:
45 .PP
46 .RS
47 .I special
48 .RE
49 .PP
50 where
51 .I special
52 is the path-name for the special device that corresponds to a
53 SCSI scanner. For SCSI scanners, the special device name must be a
54 generic SCSI device or a symlink to such a device. Under Linux, such
55 a device name could be
56 .I /dev/sga
57 or
58 .IR /dev/sge ,
59 for example. See
60 .BR sane\-scsi (5)
61 for details.
62
63 .SH CONFIGURATION
64 The contents of the
65 .I agfafocus.conf
66 file is a list of device names that correspond to AGFA Focus
67 scanners. Empty lines and lines starting with a hash mark (#) are
68 ignored. A sample configuration file is shown below:
69 .PP
70 .RS
71 /dev/scanner
72 .br
73 # this is a comment
74 .br
75 /dev/sge
76 .RE
77
78 .PP
79 .SH FILES
80 .TP
81 .I /etc/sane.d/agfafocus.conf
82 The backend configuration file (see also description of
83 .B SANE_CONFIG_DIR
84 below).
85 .TP
86 .I /usr/lib/libsane\-agfafocus.a
87 The static library implementing this backend.
88 .TP
89 .I /usr/lib/libsane\-agfafocus.so
90 The shared library implementing this backend (present on systems that
91 support dynamic loading).
92 .SH ENVIRONMENT
93 .TP
94 .B SANE_CONFIG_DIR
95 This environment variable specifies the list of directories that may
96 contain the configuration file. On *NIX systems, the directories are
97 separated by a colon (`:'), under OS/2, they are separated by a
98 semi-colon (`;'). If this variable is not set, the configuration file
99 is searched in two default directories: first, the current working
100 directory (".") and then in
101 .IR /etc/sane.d .
102 If the value of the environment variable ends with the directory separator
103 character, then the default directories are searched after the
104 explicitly specified directories. For example, setting
105 .B SANE_CONFIG_DIR
106 to "/tmp/config:" would result in directories
107 .IR tmp/config ,
108 .IR . ,
109 and
110 .I /etc/sane.d
111 being searched (in this order).
112 .TP
113 .B SANE_DEBUG_AGFAFOCUS
114 If the library was compiled with debug support enabled, this environment
115 variable controls the debug level for this backend. E.g., a value of 128
116 requests all debug output to be printed. Smaller levels reduce verbosity.
117 .B SANE_DEBUG_AGFAFOCUS
118 values:
119
120 .sp
121 .ft CR
122 .nf
123 Number Remark
124 \
125 0 print important errors (printed each time)
126 1 print errors
127 2 print sense
128 3 print warnings
129 4 print scanner-inquiry
130 5 print information
131 6 print less important information
132 7 print called procedures
133 8 print reader_process messages
134 10 print called sane\-init-routines
135 11 print called sane\-procedures
136 12 print sane infos
137 13 print sane option-control messages
138 .fi
139 .ft R
140
141 .SH MISSING FUNCTIONALITY
142
143 Uploading of dither matrices and tonecurves has been implemented, but
144 so far has not proven to be useful for anything. For this reason
145 these options have been disabled.
146
147 .SH BUGS
148 The scanners that do not support disconnect have problems with SCSI
149 timeouts if the SCSI bus gets loaded, eg. if you do a kernel build at
150 the same time as scanning. To see if your scanner supports
151 disconnect, run
152 .I "SANE_DEBUG_AGFAFOCUS=128 scanimage \-L"
153 in a terminal and look for the "disconnect:" line.
154
155 .SH DEBUG
156 If you have problems with SANE not detecting your scanner, make sure the
157 Artec backend is disabled. Somehow, this backend causes at least my scanner
158 not to respond correctly to SCSI inquiry commands.
159 .PP
160 If you encounter a bug please set the environment variable
161 .B SANE_DEBUG_AGFAFOCUS
162 to 128 and try to regenerate the problem. Then send me a report with the
163 log attached.
164 .PP
165 If you encounter a SCSI bus error or trimmed and/or displaced images please
166 also set the environment variable
167 .B SANE_DEBUG_SANEI_SCSI
168 to 128 before sending me the report.
169
170 .SH TODO
171 .TP
172 .B More scanners?
173
174 The AGFA ACS and ARCUS scanners are similar to the FOCUS scanners.
175 The driver could probably be extended to support these scanners
176 without too many changes. I do not have access to such scanners, and
177 cannot add support for it. However, if you are in possession of such
178 a scanner, I could be helpful in adding support for these scanners.
179
180 The AGFA HORIZON scanners are SCSI-2 scanners, and it would probably
181 be easier to support these scanners in a SCSI-2 compliant backend.
182
183 .SH SEE ALSO
184 .BR sane (7),
185 .BR sane\-scsi (5)
186
187 .SH AUTHOR
188 Ingo Schneider and Karl Anders \[/O]ygard.