Debian Codegraph @

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

raw
1 .TH sane\-avision 5 "11 Jul 2008" "" "SANE Scanner Access Now Easy"
2 .IX sane\-avision
3
4 .SH NAME
5 sane\-avision \- SANE backend for Avision branded and Avision OEM
6 (HP, Minolta, Mitsubishi, UMAX and possibly more) flatbed and film scanners.
7
8 .SH DESCRIPTION
9 The
10 .B sane\-avision
11 library implements a SANE (Scanner Access Now Easy) backend that
12 provides access to various Avision scanners and the Avision OEM
13 scanners labelled by HP, Minolta, Mitsubishi or Fujitsu.
14
15 It is fully big-endian aware and in everyday use on PowerPC and SPARC
16 systems.
17
18 .B I suggest you hold one hand on the power-button of the scanner while
19 .B you try the first scans \- especially with film-scanners!
20
21 .SH CONFIGURATION
22
23 The configuration file for this backend resides in
24 .IR /etc/sane.d/avision.conf .
25
26 Its contents is a list of device names that correspond to Avision and Avision
27 compatible scanners and backend-options. Empty lines and lines starting with
28 a hash mark (#) are ignored. A sample configuration file is shown below:
29
30 .nf
31 # this is a comment
32 \
33 option force\-a4
34 option force\-a3
35 option skip\-adf
36 option disable\-gamma\-table
37 option disable\-calibration
38 \
39 #scsi Vendor Model Type Bus Channel ID LUN
40 scsi AVISION
41 scsi HP
42 scsi /dev/scanner
43 usb 0x03f0 0x0701
44 .fi
45
46 .TP
47 force\-a4:
48 Forces the backend to overwrite the scanable area
49 returned by the scanner to ISO A4. Scanner that are
50 known to return bogus data are marked in the backend
51 so if you need this option please report this to the
52 backend maintainer. USE WITH CARE!
53 .TP
54 force\-a3:
55 Forces the backend to overwrite the scanable area
56 returned by the scanner to ISO A3. Scanner that are
57 known to return bogus data are marked in the backend
58 so if you need this option please report this to the
59 backend maintainer. USE WITH CARE!
60 .TP
61 skip\-adf:
62 Forces the backend to ignore an inconsistent ADF
63 status returned by the scanner (ADF not present, but
64 ADF model number non-zero). Without this option, the
65 backend will make several attempts to reset the ADF
66 and retry the query in this situation, and will fail
67 with a "not supported" error if the ADF still doesn't
68 respond.
69 .TP
70 disable\-gamma\-table:
71 Disables the usage of the scanner's gamma-table. You
72 might try this if your scans hang or only produce
73 random garbage.
74 .TP
75 disable\-calibration:
76 Disables the scanner's color calibration. You
77 might try this if your scans hang or only produce
78 random garbage.
79 .TP
80 Note:
81 Any option above modifies the default code-flow
82 for your scanner. The options should only be used
83 when you encounter problems with the default behavior
84 of the backend. Please report the need of
85 options to the backend-author so the backend can
86 be fixed as soon as possible.
87
88 .SH "DEVICE NAMES"
89 This backend expects device names of the form:
90 .PP
91 .RS
92 .I scsi scsi-spec
93
94 .I usb usb-spec
95 .RE
96 .PP
97 Where
98 .I scsi-spec
99 is the path-name to a special device or a device ID for the device that
100 corresponds to a SCSI scanner. The special device name must be a generic
101 SCSI device or a symlink to such a device, for example on Linux
102 .I /dev/sga
103 or
104 .IR /dev/sg0 .
105 The device ID is the ID returned by the scanner, for example
106 "HP" or "AVISION". See
107 .BR sane\-scsi (5)
108 for details.
109 .TP
110 Note:
111 Since the backend now includes native USB access,
112 it is no longer needed \- even considered obsolete \-
113 to access USB scanner via the SCSI emulation (named
114 hpusbscsi on Linux) for Avision USB devices such as
115 the HP 53xx, HP 74xx or Minolta film-scanners.
116 .PP
117 .I usb-spec
118 is the USB device name, the vendor/product ID pair or the name used by
119 libusb corresponding to the USB scanner. For example "0x03f0 0x0701" or
120 "libusb:002:003". See
121 .BR sane\-usb (5)
122 for details.
123
124 The program
125 .BR sane\-find\-scanner (1)
126 helps to find out the correct scsi or usb device name.
127
128 A list with supported devices is built into the avision backend so
129 normally specifying an ID should not be necessary.
130
131 .SH FILES
132 .TP
133 .I /etc/sane.d/avision.conf
134 The backend configuration file (see also description of
135 .B SANE_CONFIG_DIR
136 below).
137 .TP
138 .I /usr/lib/x86_64-linux-gnu/sane/libsane\-avision.a
139 The static library implementing this backend.
140 .TP
141 .I /usr/lib/x86_64-linux-gnu/sane/libsane\-avision.so
142 The shared library implementing this backend (present on systems that
143 support dynamic loading).
144
145 .SH ENVIRONMENT
146 .TP
147 .B SANE_CONFIG_DIR
148 This environment variable specifies the list of directories that may
149 contain the configuration file. On *NIX systems, the directories are
150 separated by a colon (`:'), under OS/2, they are separated by a
151 semi-colon (`;'). If this variable is not set, the configuration file
152 is searched in two default directories: first, the current working
153 directory (".") and then in
154 .IR /etc/sane.d .
155 If the value of the
156 environment variable ends with the directory separator character, then
157 the default directories are searched after the explicitly specified
158 directories. For example, setting
159 .B SANE_CONFIG_DIR
160 to "/tmp/config:" would result in directories
161 .IR tmp/config ,
162 .IR . ,
163 and
164 .I /etc/sane.d
165 being searched (in this order).
166 .TP
167 .B SANE_DEBUG_AVISION
168 If the library was compiled with debug support enabled, this
169 environment variable controls the debug level for this backend.
170 Higher debug levels increase the verbosity of the output. The debug
171 level 7 is the author's preferred value to debug backend problems.
172
173 Example:
174 export SANE_DEBUG_AVISION=7
175
176 .SH "SEE ALSO"
177 .BR sane (7),
178 .BR sane\-scsi (5),
179 .BR sane\-usb (5)
180 .br
181 .I http://exactcode.com/site/open_source/saneavision
182
183 .SH MAINTAINER
184 Ren\['e] Rebe
185
186 .SH AUTHOR
187 Ren\['e] Rebe and Meino Christian Cramer