2005-09-23 12:05:51 +00:00
|
|
|
.TH scanimage 1 "23 Sep 2005" "@PACKAGEVERSION@" "SANE Scanner Access Now Easy"
|
1999-08-09 18:06:01 +00:00
|
|
|
.IX scanimage
|
|
|
|
.SH NAME
|
2002-11-22 17:47:45 +00:00
|
|
|
scanimage \- scan an image
|
1999-08-09 18:06:01 +00:00
|
|
|
.SH SYNOPSIS
|
|
|
|
.B scanimage
|
2002-11-22 17:47:45 +00:00
|
|
|
.RB [ \-d | \-\-device-name
|
1999-08-09 18:06:01 +00:00
|
|
|
.IR dev ]
|
2002-11-22 17:47:45 +00:00
|
|
|
.RB [ \-\-format
|
2000-08-12 15:11:46 +00:00
|
|
|
.IR format ]
|
2002-11-22 17:47:45 +00:00
|
|
|
.RB [ \-i | \-\-icc-profile
|
|
|
|
.IR profile ]
|
|
|
|
.RB [ \-L | \-\-list-devices ]
|
|
|
|
.RB [ \-f | \-\-formatted-device-list
|
2002-01-13 20:46:35 +00:00
|
|
|
.IR format ]
|
2002-11-22 17:47:45 +00:00
|
|
|
.RB [ \-\-batch
|
2003-04-11 19:26:40 +00:00
|
|
|
.RI [= format ]]
|
2002-11-22 17:47:45 +00:00
|
|
|
.RB [ \-\-batch-start
|
|
|
|
.IR start ]
|
|
|
|
.RB [ \-\-batch-count
|
|
|
|
.IR count ]
|
|
|
|
.RB [ \-\-batch-increment
|
|
|
|
.IR increment ]
|
|
|
|
.RB [ \-\-batch-double ]
|
|
|
|
.RB [ \-\-accept-md5-only ]
|
2005-09-23 12:05:51 +00:00
|
|
|
.RB [ \-p | \-\-progress ]
|
2002-11-22 17:47:45 +00:00
|
|
|
.RB [ \-n | \-\-dont-scan ]
|
|
|
|
.RB [ \-T | \-\-test ]
|
|
|
|
.RB [ \-h | \-\-help ]
|
|
|
|
.RB [ \-v | \-\-verbose ]
|
2005-04-15 21:25:07 +00:00
|
|
|
.RB [ \-B | \-\-buffersize ]
|
2002-11-22 17:47:45 +00:00
|
|
|
.RB [ \-V | \-\-version ]
|
1999-08-09 18:06:01 +00:00
|
|
|
.RI [ device-specific-options ]
|
|
|
|
.SH DESCRIPTION
|
|
|
|
.B scanimage
|
|
|
|
is a command-line interface to control image acquisition devices such
|
|
|
|
as flatbed scanners or cameras. The device is controlled via
|
|
|
|
command-line options. After command-line processing,
|
|
|
|
.B scanimage
|
|
|
|
normally proceeds to acquire an image. The image data is written to
|
|
|
|
standard output in one of the PNM (portable aNyMaP) formats (PBM for
|
|
|
|
black-and-white images, PGM for grayscale images, and PPM for color
|
2000-08-12 15:11:46 +00:00
|
|
|
images) or in TIFF (black-and-white, grayscale or color).
|
1999-08-09 18:06:01 +00:00
|
|
|
.B scanimage
|
2002-11-22 17:47:45 +00:00
|
|
|
accesses image acquisition devices through the
|
|
|
|
.B SANE
|
|
|
|
(Scanner Access Now Easy) interface and can thus support any device for which
|
|
|
|
there exists a
|
|
|
|
.B SANE
|
|
|
|
backend (try
|
|
|
|
.B apropos
|
|
|
|
.I sane-
|
|
|
|
to get a list of available backends).
|
2003-04-16 09:12:23 +00:00
|
|
|
|
|
|
|
.SH EXAMPLES
|
|
|
|
To get a list of devices:
|
|
|
|
|
|
|
|
scanimage \-L
|
|
|
|
|
|
|
|
To scan with default settings to the file image.pnm:
|
|
|
|
|
|
|
|
scanimage >image.pnm
|
|
|
|
|
|
|
|
To print all available options:
|
|
|
|
|
|
|
|
scanimage \-h
|
|
|
|
|
1999-08-09 18:06:01 +00:00
|
|
|
.SH OPTIONS
|
|
|
|
.PP
|
|
|
|
The
|
2002-11-22 17:47:45 +00:00
|
|
|
.B \-d
|
1999-08-09 18:06:01 +00:00
|
|
|
or
|
2002-11-22 17:47:45 +00:00
|
|
|
.B \-\-device-name
|
|
|
|
options must be followed by a
|
|
|
|
.B SANE
|
|
|
|
device-name like
|
|
|
|
.RI ` epson:/dev/sg0 '
|
|
|
|
or
|
|
|
|
.RI ` hp:/dev/usbscanner0 '.
|
|
|
|
A (partial) list of available devices can be obtained with the
|
|
|
|
.B \-\-list-devices
|
1999-08-09 18:06:01 +00:00
|
|
|
option (see below). If no device-name is specified explicitly,
|
|
|
|
.B scanimage
|
2000-08-12 15:11:46 +00:00
|
|
|
reads a device-name from the environment variable
|
|
|
|
.BR SANE_DEFAULT_DEVICE .
|
|
|
|
If this variable is not set,
|
|
|
|
.B scanimage
|
1999-08-09 18:06:01 +00:00
|
|
|
will attempt to open the first available device.
|
|
|
|
.PP
|
|
|
|
The
|
2002-11-22 17:47:45 +00:00
|
|
|
.B \-\-format
|
2000-08-12 15:11:46 +00:00
|
|
|
.I format
|
2002-11-22 17:47:45 +00:00
|
|
|
option selects how image data is written to standard output.
|
2000-08-12 15:11:46 +00:00
|
|
|
.I format
|
|
|
|
can be
|
|
|
|
.B pnm
|
|
|
|
or
|
2002-11-22 17:47:45 +00:00
|
|
|
.BR tiff.
|
|
|
|
If
|
|
|
|
.B \-\-format
|
2000-08-12 15:11:46 +00:00
|
|
|
is not used, PNM is written.
|
|
|
|
.PP
|
|
|
|
The
|
2002-11-22 17:47:45 +00:00
|
|
|
.B \-i
|
1999-08-09 18:06:01 +00:00
|
|
|
or
|
2002-11-22 17:47:45 +00:00
|
|
|
.B \-\-icc-profile
|
2002-09-11 21:36:26 +00:00
|
|
|
option is used to include an ICC profile into a TIFF file.
|
1999-08-09 18:06:01 +00:00
|
|
|
.PP
|
|
|
|
The
|
2002-11-22 17:47:45 +00:00
|
|
|
.B \-L
|
1999-08-09 18:06:01 +00:00
|
|
|
or
|
2002-11-22 17:47:45 +00:00
|
|
|
.B \-\-list-devices
|
1999-08-09 18:06:01 +00:00
|
|
|
option requests a (partial) list of devices that are available. The
|
|
|
|
list is not complete since some devices may be available, but are not
|
|
|
|
listed in any of the configuration files (which are typically stored
|
2002-11-22 17:47:45 +00:00
|
|
|
in directory
|
|
|
|
.IR @CONFIGDIR@ ).
|
|
|
|
This is particularly the case when accessing scanners through the network. If
|
|
|
|
a device is not listed in a configuration file, the only way to access it is
|
|
|
|
by its full device name. You may need to consult your system administrator to
|
|
|
|
find out the names of such devices.
|
1999-08-09 18:06:01 +00:00
|
|
|
.PP
|
|
|
|
The
|
2002-11-22 17:47:45 +00:00
|
|
|
.B \-f
|
2002-01-13 20:46:35 +00:00
|
|
|
or
|
2002-11-22 17:47:45 +00:00
|
|
|
.B \-\-formatted-device-list
|
|
|
|
option works similar to
|
|
|
|
.BR \-\-list-devices ,
|
|
|
|
but requires a format string.
|
|
|
|
.B scanimage
|
|
|
|
replaces the placeholders
|
2002-01-13 20:46:35 +00:00
|
|
|
.B %d %v %m %t %i
|
|
|
|
with the device name, vendor name, model name, scanner type and an index
|
|
|
|
number respectively. The command
|
|
|
|
.PP
|
|
|
|
.RS
|
2002-11-22 17:47:45 +00:00
|
|
|
.B scanimage \-f
|
|
|
|
.I \*(lq scanner number %i device %d is a %t, model %m, produced by %v \*(rq
|
2002-01-13 20:46:35 +00:00
|
|
|
.PP
|
|
|
|
.RE
|
|
|
|
will produce something like:
|
|
|
|
.PP
|
|
|
|
.RS
|
|
|
|
scanner number 0 device sharp:/dev/sg1 is a flatbed scanner, model JX250
|
|
|
|
SCSI, produced by SHARP
|
|
|
|
.RE
|
2002-09-11 21:36:26 +00:00
|
|
|
.PP
|
|
|
|
The
|
2002-11-22 17:47:45 +00:00
|
|
|
.B \-\-batch*
|
2002-09-11 21:36:26 +00:00
|
|
|
options provide the features for scanning documents using document
|
|
|
|
feeders.
|
2002-11-22 17:47:45 +00:00
|
|
|
.BR \-\-batch
|
|
|
|
.RI [ format ]
|
2002-09-11 21:36:26 +00:00
|
|
|
is used to specify the format of the filename that each page will be written
|
2002-11-22 17:47:45 +00:00
|
|
|
to. Each page is written out to a single file. If
|
|
|
|
.I format
|
|
|
|
is not specified, the default of out%d.pnm (or out%d.tif for \-\-format tiff)
|
|
|
|
will be used.
|
|
|
|
.I format
|
|
|
|
is given as a printf style string with one integer parameter.
|
|
|
|
.B \-\-batch-start
|
|
|
|
.I start
|
2002-09-11 21:36:26 +00:00
|
|
|
selects the page number to start naming files with. If this option is not
|
|
|
|
given, the counter will start at 0.
|
2002-11-22 17:47:45 +00:00
|
|
|
.B \-\-batch-count
|
|
|
|
.I count
|
2002-09-11 21:36:26 +00:00
|
|
|
specifies the number of pages to attempt to scan. If not given,
|
|
|
|
scanimage will continue scanning until the scanner returns a state
|
|
|
|
other than OK. Not all scanners with document feeders signal when the
|
|
|
|
ADF is empty, use this command to work around them.
|
|
|
|
With
|
2002-11-22 17:47:45 +00:00
|
|
|
.B \-\-batch-increment
|
|
|
|
.I increment
|
2002-09-11 21:36:26 +00:00
|
|
|
you can change the amount that the number in the filename is incremented
|
|
|
|
by. Generally this is used when you are scanning double-sided documents
|
|
|
|
on a single-sided document feeder. A specific command is provided to
|
|
|
|
aid this:
|
2002-11-22 17:47:45 +00:00
|
|
|
.B \-\-batch-double
|
2002-09-11 21:36:26 +00:00
|
|
|
will automatically set the increment to 2.
|
2004-02-22 11:17:49 +00:00
|
|
|
.B \-\-batch-prompt
|
|
|
|
will ask for pressing RETURN before scanning a page. This can be used for
|
|
|
|
scanning multiple pages without an automatic document feeder.
|
2002-09-11 21:36:26 +00:00
|
|
|
.PP
|
|
|
|
The
|
2002-11-22 17:47:45 +00:00
|
|
|
.B \-\-accept-md5-only
|
2002-09-11 21:36:26 +00:00
|
|
|
option only accepts user authorization requests that support MD5 security. The
|
2002-11-22 17:47:45 +00:00
|
|
|
.B SANE
|
|
|
|
network daemon
|
|
|
|
.RB ( saned )
|
|
|
|
is capable of doing such requests. See
|
2004-06-13 15:25:13 +00:00
|
|
|
.BR saned (8).
|
2002-09-11 21:36:26 +00:00
|
|
|
.PP
|
|
|
|
The
|
2005-09-23 12:05:51 +00:00
|
|
|
.B \-p
|
|
|
|
or
|
|
|
|
.B \-\-progress
|
|
|
|
option requests that
|
|
|
|
.B scanimage
|
|
|
|
prints a progress counter. It shows how much image data of the current image has
|
|
|
|
already been received by
|
|
|
|
.B scanimage
|
|
|
|
(in percent).
|
|
|
|
.PP
|
|
|
|
The
|
2002-11-22 17:47:45 +00:00
|
|
|
.B \-n
|
2002-09-11 21:36:26 +00:00
|
|
|
or
|
2002-11-22 17:47:45 +00:00
|
|
|
.B \-\-dont-scan
|
2002-09-11 21:36:26 +00:00
|
|
|
option requests that
|
|
|
|
.B scanimage
|
|
|
|
only sets the options provided by the user but doesn't actually perform a
|
|
|
|
scan. This option can be used to e.g. turn off the scanner's lamp (if
|
|
|
|
supported by the backend).
|
|
|
|
.PP
|
2002-01-13 20:46:35 +00:00
|
|
|
The
|
2002-11-22 17:47:45 +00:00
|
|
|
.B \-T
|
1999-08-09 18:06:01 +00:00
|
|
|
or
|
2002-11-22 17:47:45 +00:00
|
|
|
.B \-\-test
|
1999-08-09 18:06:01 +00:00
|
|
|
option requests that
|
|
|
|
.B scanimage
|
2002-11-22 17:47:45 +00:00
|
|
|
performs a few simple sanity tests to make sure the backend works as
|
|
|
|
defined by the
|
|
|
|
.B SANE
|
|
|
|
API (in particular the
|
1999-08-09 18:06:01 +00:00
|
|
|
.B sane_read
|
2005-03-31 11:12:18 +00:00
|
|
|
function is exercised by this test).
|
1999-08-09 18:06:01 +00:00
|
|
|
.PP
|
|
|
|
The
|
2002-11-22 17:47:45 +00:00
|
|
|
.B \-h
|
2002-09-11 21:36:26 +00:00
|
|
|
or
|
2002-11-22 17:47:45 +00:00
|
|
|
.B \-\-help
|
2002-09-11 21:36:26 +00:00
|
|
|
options request help information. The information is printed on
|
|
|
|
standard output and in this case, no attempt will be made to acquire
|
|
|
|
an image.
|
|
|
|
.PP
|
|
|
|
The
|
2002-11-22 17:47:45 +00:00
|
|
|
.B \-v
|
1999-08-09 18:06:01 +00:00
|
|
|
or
|
2002-11-22 17:47:45 +00:00
|
|
|
.B \-\-verbose
|
1999-08-09 18:06:01 +00:00
|
|
|
options increase the verbosity of the operation of
|
|
|
|
.B scanimage.
|
|
|
|
The option may be specified repeatedly, each time increasing the verbosity
|
|
|
|
level.
|
2002-09-11 21:36:26 +00:00
|
|
|
.PP
|
1999-08-09 18:06:01 +00:00
|
|
|
The
|
2005-04-15 21:25:07 +00:00
|
|
|
.B \-B
|
|
|
|
or
|
|
|
|
.B \-\-buffersize
|
|
|
|
option changes the input buffersize that
|
|
|
|
.B scanimage
|
|
|
|
uses from default 32*1024 to 1024*1024 kbytes.
|
|
|
|
.PP
|
|
|
|
The
|
2002-11-22 17:47:45 +00:00
|
|
|
.B \-V
|
1999-08-09 18:06:01 +00:00
|
|
|
or
|
2002-11-22 17:47:45 +00:00
|
|
|
.B \-\-version
|
1999-08-09 18:06:01 +00:00
|
|
|
option requests that
|
|
|
|
.B scanimage
|
2001-04-13 17:04:51 +00:00
|
|
|
prints the program and package name, the version number of
|
2002-11-22 17:47:45 +00:00
|
|
|
the
|
|
|
|
.B SANE
|
|
|
|
distribution that it came with and the version of the backend that it
|
|
|
|
loads. Usually that's the dll backend. If more information about the version
|
|
|
|
numbers of the backends are necessary, the
|
|
|
|
.B DEBUG
|
|
|
|
variable for the dll backend can be used. Example: SANE_DEBUG_DLL=3 scanimage
|
|
|
|
\-L.
|
2002-09-11 21:36:26 +00:00
|
|
|
.PP
|
1999-08-09 18:06:01 +00:00
|
|
|
As you might imagine, much of the power of
|
|
|
|
.B scanimage
|
2002-11-22 17:47:45 +00:00
|
|
|
comes from the fact that it can control any
|
|
|
|
.B SANE
|
|
|
|
backend. Thus, the exact set of command-line options depends on the
|
|
|
|
capabilities of the selected device. To see the options for a device named
|
1999-08-09 18:06:01 +00:00
|
|
|
.IR dev ,
|
|
|
|
invoke
|
|
|
|
.B scanimage
|
|
|
|
via a command-line of the form:
|
|
|
|
.PP
|
|
|
|
.RS
|
2002-11-22 17:47:45 +00:00
|
|
|
.B scanimage \-\-help \-\-device-name
|
1999-08-09 18:06:01 +00:00
|
|
|
.I dev
|
|
|
|
.RE
|
|
|
|
.PP
|
|
|
|
The documentation for the device-specific options printed by
|
2002-11-22 17:47:45 +00:00
|
|
|
.B \-\-help
|
1999-08-09 18:06:01 +00:00
|
|
|
is best explained with a few examples:
|
|
|
|
|
2002-11-22 17:47:45 +00:00
|
|
|
\-\-brightness -100..100% [0]
|
1999-08-09 18:06:01 +00:00
|
|
|
.br
|
|
|
|
Controls the brightness of the acquired image.
|
|
|
|
.PP
|
|
|
|
.RS
|
|
|
|
The description above shows that option
|
2002-11-22 17:47:45 +00:00
|
|
|
.B \-\-brightness
|
1999-08-09 18:06:01 +00:00
|
|
|
expects an option value in the range from -100 to 100 percent. The
|
|
|
|
value in square brackets indicates that the current option value is 0
|
|
|
|
percent.
|
|
|
|
.RE
|
|
|
|
|
2002-11-22 17:47:45 +00:00
|
|
|
\-\-default-enhancements
|
1999-08-09 18:06:01 +00:00
|
|
|
.br
|
|
|
|
Set default values for enhancement controls.
|
|
|
|
.PP
|
|
|
|
.RS
|
|
|
|
The description above shows that option
|
2002-11-22 17:47:45 +00:00
|
|
|
.B \-\-default-enhancements
|
1999-08-09 18:06:01 +00:00
|
|
|
has no option value. It should be thought of as having an immediate
|
|
|
|
effect at the point of the command-line at which it appears. For
|
|
|
|
example, since this option resets the
|
2002-11-22 17:47:45 +00:00
|
|
|
.B \-\-brightness
|
1999-08-09 18:06:01 +00:00
|
|
|
option, the option-pair
|
2002-11-22 17:47:45 +00:00
|
|
|
.B \-\-brightness 50 \-\-default-enhancements
|
1999-08-09 18:06:01 +00:00
|
|
|
would effectively be a no-op.
|
|
|
|
.RE
|
|
|
|
|
2002-11-22 17:47:45 +00:00
|
|
|
\-\-mode Lineart|Gray|Color [Gray]
|
1999-08-09 18:06:01 +00:00
|
|
|
.br
|
|
|
|
Selects the scan mode (e.g., lineart or color).
|
|
|
|
.PP
|
|
|
|
.RS
|
|
|
|
The description above shows that option
|
2002-11-22 17:47:45 +00:00
|
|
|
.B \-\-mode
|
1999-08-09 18:06:01 +00:00
|
|
|
accepts an argument that must be one of the strings
|
|
|
|
.BR Lineart ,
|
|
|
|
.BR Gray ,
|
|
|
|
or
|
|
|
|
.BR Color .
|
|
|
|
The value in the square bracket indicates that the option is currently
|
|
|
|
set to
|
|
|
|
.BR Gray .
|
|
|
|
For convenience, it is legal to abbreviate the string values as long as
|
|
|
|
they remain unique. Also, the case of the spelling doesn't matter. For
|
|
|
|
example, option setting
|
2002-11-22 17:47:45 +00:00
|
|
|
.B \-\-mode col
|
1999-08-09 18:06:01 +00:00
|
|
|
is identical to
|
2002-11-22 17:47:45 +00:00
|
|
|
.BR "\-\-mode Color" .
|
1999-08-09 18:06:01 +00:00
|
|
|
.RE
|
|
|
|
|
2002-11-22 17:47:45 +00:00
|
|
|
\-\-custom-gamma[=(yes|no)] [inactive]
|
1999-08-09 18:06:01 +00:00
|
|
|
.br
|
|
|
|
Determines whether a builtin or a custom gamma-table
|
|
|
|
.br
|
|
|
|
should be used.
|
|
|
|
.PP
|
|
|
|
.RS
|
|
|
|
The description above shows that option
|
2002-11-22 17:47:45 +00:00
|
|
|
.B \-\-custom-gamma
|
1999-08-09 18:06:01 +00:00
|
|
|
expects either no option value, a "yes" string, or a "no" string.
|
|
|
|
Specifying the option with no value is equivalent to specifying "yes".
|
|
|
|
The value in square-brackets indicates that the option is not
|
|
|
|
currently active. That is, attempting to set the option would result
|
|
|
|
in an error message. The set of available options typically depends
|
|
|
|
on the settings of other options. For example, the
|
2002-11-22 17:47:45 +00:00
|
|
|
.B \-\-custom-gamma
|
1999-08-09 18:06:01 +00:00
|
|
|
table might be active only when a grayscale or color scan-mode has
|
|
|
|
been requested.
|
|
|
|
|
|
|
|
Note that the
|
2002-11-22 17:47:45 +00:00
|
|
|
.B \-\-help
|
1999-08-09 18:06:01 +00:00
|
|
|
option is processed only after all other options have been processed.
|
|
|
|
This makes it possible to see the option settings for a particular
|
|
|
|
mode by specifying the appropriate mode-options along
|
|
|
|
with the
|
2002-11-22 17:47:45 +00:00
|
|
|
.B \-\-help
|
1999-08-09 18:06:01 +00:00
|
|
|
option. For example, the command-line:
|
|
|
|
.PP
|
2002-11-22 17:47:45 +00:00
|
|
|
.B scanimage \-\-help \-\-mode
|
|
|
|
.I color
|
1999-08-09 18:06:01 +00:00
|
|
|
.PP
|
|
|
|
would print the option settings that are in effect when the color-mode
|
|
|
|
is selected.
|
|
|
|
.RE
|
|
|
|
|
2002-11-22 17:47:45 +00:00
|
|
|
\-\-gamma-table 0..255,...
|
1999-08-09 18:06:01 +00:00
|
|
|
.br
|
|
|
|
Gamma-correction table. In color mode this option
|
|
|
|
.br
|
|
|
|
equally affects the red, green, and blue channels
|
|
|
|
.br
|
|
|
|
simultaneously (i.e., it is an intensity gamma table).
|
|
|
|
.PP
|
|
|
|
.RS
|
|
|
|
The description above shows that option
|
2002-11-22 17:47:45 +00:00
|
|
|
.B \-\-gamma-table
|
1999-08-09 18:06:01 +00:00
|
|
|
expects zero or more values in the range 0 to 255. For example, a
|
|
|
|
legal value for this option would be "3,4,5,6,7,8,9,10,11,12". Since
|
|
|
|
it's cumbersome to specify long vectors in this form, the same can be
|
|
|
|
expressed by the abbreviated form "[0]3-[9]12". What this means is
|
2001-11-20 20:23:10 +00:00
|
|
|
that the first vector element is set to 3, the 9-th element is set to
|
2005-03-31 11:12:18 +00:00
|
|
|
12 and the values in between are interpolated linearly. Of course, it
|
1999-08-09 18:06:01 +00:00
|
|
|
is possible to specify multiple such linear segments. For example,
|
|
|
|
"[0]3-[2]3-[6]7,[7]10-[9]6" is equivalent to "3,3,3,4,5,6,7,10,8,6".
|
2002-09-11 21:36:26 +00:00
|
|
|
The program
|
|
|
|
.B gamma4scanimage
|
2002-11-22 17:47:45 +00:00
|
|
|
can be used to generate such gamma tables (see
|
|
|
|
.BR gamma4scanimage (1)
|
|
|
|
for details).
|
1999-08-09 18:06:01 +00:00
|
|
|
.RE
|
|
|
|
|
|
|
|
.br
|
2002-11-22 17:47:45 +00:00
|
|
|
\-\-filename <string> [/tmp/input.ppm]
|
1999-08-09 18:06:01 +00:00
|
|
|
.br
|
|
|
|
The filename of the image to be loaded.
|
|
|
|
.PP
|
|
|
|
.RS
|
2005-03-31 11:12:18 +00:00
|
|
|
The description above is an example of an option that takes an
|
1999-08-09 18:06:01 +00:00
|
|
|
arbitrary string value (which happens to be a filename). Again,
|
|
|
|
the value in brackets show that the option is current set to the
|
|
|
|
filename
|
|
|
|
.BR /tmp/input.ppm .
|
|
|
|
.RE
|
|
|
|
|
2000-08-12 15:11:46 +00:00
|
|
|
.SH ENVIRONMENT
|
|
|
|
.TP
|
|
|
|
.B SANE_DEFAULT_DEVICE
|
|
|
|
The default device-name.
|
1999-08-09 18:06:01 +00:00
|
|
|
.SH FILES
|
|
|
|
.TP
|
|
|
|
.I @CONFIGDIR@
|
|
|
|
This directory holds various configuration files. For details, please
|
|
|
|
refer to the manual pages listed below.
|
2000-11-20 18:49:26 +00:00
|
|
|
.TP
|
|
|
|
.I ~/.sane/pass
|
2001-11-20 20:23:10 +00:00
|
|
|
This file contains lines of the form
|
2000-11-20 18:49:26 +00:00
|
|
|
.PP
|
|
|
|
.RS
|
2000-11-24 15:05:22 +00:00
|
|
|
user:password:resource
|
2000-11-20 18:49:26 +00:00
|
|
|
.PP
|
|
|
|
scanimage uses this information to answer user authorization requests
|
|
|
|
automatically. The file must have 0600 permissions or stricter. You should
|
2002-11-22 17:47:45 +00:00
|
|
|
use this file in conjunction with the \-\-accept-md5-only option to avoid
|
2000-11-24 15:05:22 +00:00
|
|
|
server-side attacks. The resource may contain any character but is limited
|
|
|
|
to 127 characters.
|
1999-08-09 18:06:01 +00:00
|
|
|
.SH "SEE ALSO"
|
2002-11-22 17:47:45 +00:00
|
|
|
.BR sane (7),
|
|
|
|
.BR gamma4scanimage (1),
|
|
|
|
.BR xscanimage (1),
|
|
|
|
.BR xcam(1) ,
|
|
|
|
.BR xsane(1) ,
|
|
|
|
.BR scanadf (1),
|
|
|
|
.BR sane-dll (5),
|
|
|
|
.BR sane-net (5),
|
|
|
|
.BR sane-"backendname" (5)
|
1999-08-09 18:06:01 +00:00
|
|
|
.SH AUTHOR
|
2005-09-23 12:05:51 +00:00
|
|
|
David Mosberger, Andreas Beck, Gordon Matzigkeit, Caskey Dickson, and many
|
|
|
|
others. For questions and comments contact the sane-devel mailinglist (see
|
|
|
|
http://www.sane-project.org/mailing-lists.html).
|
|
|
|
|
1999-08-09 18:06:01 +00:00
|
|
|
.SH BUGS
|
|
|
|
For vector options, the help output currently has no indication as to
|
|
|
|
how many elements a vector-value should have.
|