Debian Codegraph @

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

raw
1 .TH sane\-snapscan 5 "14 Jul 2008" "" "SANE Scanner Access Now Easy"
2 .IX sane\-snapscan
3 .SH NAME
4 sane\-snapscan \- SANE backend for AGFA SnapScan flatbed scanners
5 .SH DESCRIPTION
6 The
7 .B sane\-snapscan
8 library implements a SANE (Scanner Access Now Easy) backend that provides
9 access to AGFA SnapScan flatbed scanners. At present, the following scanners
10 are supported from this backend: AGFA SnapScan 300, 310, 600, and 1236s,
11 1236u, 1212u, e20, e25,
12 e40, e50, e60, Vuego 310s, Acer 300f, 310s, 610s, 610plus, Prisa 620s, Prisa
13 620u, Prisa 620ut, Prisa 640u, Prisa 640bu, Prisa 1240, Prisa 3300, Prisa
14 4300, Prisa 5300 and Guillemot Maxi Scan A4 Deluxe (SCSI) (with
15 varying success).
16 .PP
17
18 .SH "DEVICE NAMES"
19 This backend expects device names of the form:
20 .PP
21 .RS
22 .I special
23 .RE
24 .PP
25 Where
26 .I special
27 is the path-name for the special device that corresponds to a
28 SCSI scanner. For SCSI
29 scanners, the special device name must be a generic SCSI device or a
30 symlink to such a device. Under Linux, such a device name could be
31 .I /dev/sga
32 or
33 .IR /dev/sge ,
34 for example. See
35 .BR sane\-scsi (5)
36 for details.
37 .P
38 For USB scanners the devicename must contain the keyword "usb", as in
39 .I /dev/usbscanner
40 or
41 .IR /dev/usb/scanner0 .
42 For scanners that need a firmware upload before scanning add a line starting
43 with "firmware" followed by the fully qualified path to your firmware file,
44 e.g.
45 .PP
46 .RS
47 firmware /usr/share/sane/snapscan/firmware.bin
48 .RE
49 .PP
50 For further details read
51 .IR http://snapscan.sourceforge.net .
52
53 .SH CONFIGURATION
54 The contents of the
55 .I snapscan.conf
56 file is a list of device names that correspond to SnapScan
57 scanners. Empty lines and lines starting with a hash mark (#) are
58 ignored. See
59 .BR sane\-scsi (5)
60 on details of what constitutes a valid
61 device name.
62
63 .SH FILES
64 .TP
65 .I /etc/sane.d/snapscan.conf
66 The backend configuration file (see also description of
67 .B SANE_CONFIG_DIR
68 below).
69 .TP
70 .I /usr/lib/x86_64-linux-gnu/sane/libsane\-snapscan.a
71 The static library implementing this backend.
72 .TP
73 .I /usr/lib/x86_64-linux-gnu/sane/libsane\-snapscan.so
74 The shared library implementing this backend (present on systems that
75 support dynamic loading).
76 .SH ENVIRONMENT
77 .TP
78 .B SANE_CONFIG_DIR
79 This environment variable specifies the list of directories that may
80 contain the configuration file. On *NIX systems, the directories are
81 separated by a colon (`:'), under OS/2, they are separated by a
82 semi-colon (`;'). If this variable is not set, the configuration file
83 is searched in two default directories: first, the current working
84 directory (".") and then in
85 .IR /etc/sane.d .
86 If the value of the
87 environment variable ends with the directory separator character, then
88 the default directories are searched after the explicitly specified
89 directories. For example, setting
90 .B SANE_CONFIG_DIR
91 to "/tmp/config:" would result in directories
92 .IR "tmp/config" ,
93 .IR "." ,
94 and
95 .I "/etc/sane.d"
96 being searched (in this order).
97 .TP
98 .B SANE_DEBUG_SNAPSCAN
99 If the library was compiled with debug support enabled, this
100 environment variable controls the debug level for this backend. E.g.,
101 a value of 255 requests all debug output to be printed. Smaller
102 levels reduce verbosity.
103
104
105 .SH BUGS
106 Man page doesn't provide much information yet.
107
108 .SH "SEE ALSO"
109 .BR sane (7),
110 .BR sane\-scsi (5),
111 .br
112 .I http://sourceforge.net/projects/snapscan/
113 (new development website)
114
115 .SH AUTHOR
116 Kevin Charter, Franck Schneider, Michel Roelofs, Emmanuel Blot,
117 Mikko Tyolajarvi, David Mosberger-Tang, Wolfgang Goeller,
118 Petter Reinholdtsen, Gary Plewa, Sebastien Sable, Oliver Schwartz
119 and Mikael Magnusson.
120 .br
121 Man page by Henning Meier-Geinitz (mostly based on the web pages and
122 source code).