
sane-test.5
NAME
sane-test - SANE backend for testing frontends
DESCRIPTION
The sane-test library implements a SANE (Scanner Access
Now Easy) backend that allows testing the SANE installa�
tion and SANE frontends. It provides access to a (nearly)
unlimited number of virtual devices. There is no support
for real scanners or cameras. However, the backend simu�
lates scanning and setting options.
The idea is not only to find bugs in frontends but also to
show all capabilities of SANE. Therefore sane-test imple�
ments functions and options that are not (or seldomly)
found in other backends.
The backend is commented out in
/usr/local/etc/sane.d/dll.conf, so either the comment sign
must be removed or the backend must be called explicitely.
E.g. `scanimage -d test' or `xscanimage test'.
SANE OPTIONS
The options should be self-explanatory. Have a look at
their descriptions. If a description is too vague, please
contact me. Just some comments: The combination of color
and 1-bit mode is quite obscure (8 colors) but allowed in
the SANE standard. However, the meaning of bits is not
defined. Currently 1 = high intensity and 0 = low inten�
sity is used.
FILES
/usr/local/etc/sane.d/test.conf
The backend configuration file (see also descrip�
tion of SANE_CONFIG_DIR below). The initial values
of most of the basic SANE options can be configured
in this file. A template containing all the default
values is provided together with this backend. One
of the more interesting values may be num�
ber_of_devices. It can be used to check the fron�
tend's ability to show a long list of devices. The
config values concerning resolution and geometry
can be usefull to test the handling of big file
sizes.
/usr/local/lib/sane/libsane-test.a
The static library implementing this backend.
/usr/local/lib/sane/libsane-test.so
The shared library implementing this backend (pre�
sent on systems that support dynamic loading).
ENVIRONMENT
SANE_CONFIG_DIR
This environment variable specifies the list of
directories that may contain the configuration
file. Under UNIX, 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 /usr/local/etc/sane.d. If the
value of the environment variable ends with the
directory separator character, then the default
directories are searched after the explicitly spec�
ified directories. For example, setting SANE_CON�
FIG_DIR to "/tmp/config:" would result in directo�
ries "tmp/config", ".", and "/usr/local/etc/sane.d"
being searched (in this order).
SANE_DEBUG_TEST
If the library was compiled with debug support
enabled, this environment variable controls the
debug level for this backend. Higher debug levels
increase the verbosity of the output.
Example: export SANE_DEBUG_TEST=4
SEE ALSO
sane(7), http://www.meier-geinitz.de/sane/test-backend/
AUTHOR
Henning Meier-Geinitz <henning@meier-geinitz.de>
BUGS
- config file values aren't tested for correctness - man
page hasn't been completed yet
Man(1) output converted with
man2html