summaryrefslogtreecommitdiff
path: root/doc/sane-p5.man
blob: 80438e8cd72f39c6fb3bb1f4762b4076d8016d1b (plain)
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
156
157
158
159
160
161
162
.TH "sane\-p5" "5" "15 Feb 2010" "@PACKAGEVERSION@" "SANE Scanner Access Now Easy"
.IX sane\-p5
.SH "NAME"
sane\-p5 \- SANE backend for the Primax PagePartner
.SH "DESCRIPTION"
The
.B sane\-p5
library implements a SANE (Scanner Access Now Easy) backend that
provides access to the Primax PagePartner parallel port sheet fed scanner.
.PP
This backend handles 100, 150, 200, 300 and 600 dpi scan resolutions,
in color and gray modes. The 600 dpi is actually 300x600 with lines
enlarged to match the vertical resolution.
.PP
.B EPP/ECP MODES ONLY
The current version of the backend uses only EPP or ECP mode to communicate
with the scanner. It is
recommended that you set your parallel port to EPP in BIOS with the current
version of this backend. ECPEPP will only
work if you use a 2.4 or 2.6 kernel with ppdev character device support.
.PP

.SH "DEVICE NAMES"
This backend expects device names of the form:
.PP
.RS
.I port value
.RE
.PP
Where
\fBvalue\fR is :

.RS
.TP
auto
autodetect all parallel ports and probe
them for scanner
.TP
/dev/parport0
uses linux ppdev device, depending on the
number of available parallel port, you
have to use /dev/parport1, /dev/parport2, ...
.PP
.RE
You can rename any device using the
.PP
.RS
.br
.I option name my_name
.RE
.PP
option. This option apply to the last port option.

.SH "CONFIGURATION"
Please make sure to edit
.I dll.conf
.B before
you use the backend, since this backend isn't enabled by default.
.PP

.SH "FILES"
.TP
.I @CONFIGDIR@/p5.conf
The backend configuration file (see also description of
.B SANE_CONFIG_DIR
below).
.TP
.I @LIBDIR@/libsane\-p5.a
The static library implementing this backend.
.TP
.I @LIBDIR@/libsane\-p5.so
The shared library implementing this backend (present on systems that
support dynamic loading).

.SH "ENVIRONMENT"
.TP
.B SANE_CONFIG_DIR
This environment variable specifies the list of directories that may
contain the configuration file.  On *NIX systems, the directories are
separated by a colon (`:'), under OS/2, they are separated by a
semi-colon (`;').  If this variable is not set, the configuration file
is searched in two default directories: first, the current working
directory (".") and then in
.IR @CONFIGDIR@ .
If the value of the
environment variable ends with the directory separator character, then
the default directories are searched after the explicitly specified
directories.  For example, setting
.B SANE_CONFIG_DIR
to "/tmp/config:" would result in directories
.IR "tmp/config" ,
.IR "." ,
and
.I "@CONFIGDIR@"
being searched (in this order).
.TP
.B SANE_DEBUG_P5
If the library was compiled with debug support enabled, this
environment variable controls the debug level for this backend.  E.g.,
a value of 255 requests all debug output to be printed.  Smaller
levels reduce verbosity.

.PP
.RS
.ft CR
.nf
level   debug output
\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
 0       critical errors
 1       errors
 2       warnings & minor errors
 4       information messages
 8       start/stop of functions
 16      tracing messages
 32      I/O functions
 64      I/O functions with traces
 128     scanned/calibration data
.fi
.ft R

.SH "SEE ALSO"
.BR sane (7),
.BR sane\-net (5),
.BR saned (8),
.BR scanimage (1)

.SH "AUTHOR"
St\['e]phane Voltz
.RI < stef.dev@free.fr >

.SH "CREDITS"
Support for the Prima PagePartner has been made possible thank to an hardware donation
by S\['e]bastien Lange.

.SH "BUG REPORTS"
If something doesn't work mail sane-devel@alioth-lists.debian.net or submit an
issue via
.I https://gitlab.com/sane-project/backends/issues/new
with a label of backend/p5.
Please give as much information as you can.

.TP
.I SANE version
run "scanimage \-V" to determine this
.TP
.I the backend version and your scanner hardware
run
.I "SANE_DEBUG_P5=255 scanimage \-L 2>log"
as root. If you don't get any output from the p5 backend, make sure a line "p5" is included into
your
.IR @CONFIGDIR@/dll.conf .
If your scanner isn't detected, make sure you've defined the right port address, or the
correct device
in your p5.conf.
.TP
.I the name of your scanner/vendor
also a worthy information. Please also include the optical resolution and lamp type of your
scanner, both can be found in the manual of your scanner.
.TP
.I any further comments
if you have comments about the documentation (what could be done better), or you
think I should know something, please include it.