2008-07-14 10:49:06 +00:00
|
|
|
.TH sane\-dll 5 "13 Jul 2008" "@PACKAGEVERSION@" "SANE Scanner Access Now Easy"
|
|
|
|
.IX sane\-dll
|
1999-08-09 18:06:01 +00:00
|
|
|
.SH NAME
|
2008-07-14 10:49:06 +00:00
|
|
|
sane\-dll \- SANE dynamic backend loader
|
1999-08-09 18:06:01 +00:00
|
|
|
.SH DESCRIPTION
|
|
|
|
The
|
2008-07-14 10:49:06 +00:00
|
|
|
.B sane\-dll
|
1999-08-09 18:06:01 +00:00
|
|
|
library implements a SANE (Scanner Access Now Easy) backend that
|
|
|
|
provides access to an arbitrary number of other SANE backends. These
|
|
|
|
backends may either be pre-loaded at the time the
|
2008-07-14 10:49:06 +00:00
|
|
|
.B sane\-dll
|
1999-08-09 18:06:01 +00:00
|
|
|
library is built or, on systems that support dynamic loading of shared
|
|
|
|
libraries, the backends may be loaded at runtime. In the latter case,
|
|
|
|
adding support for a new backend simply involves installing the
|
|
|
|
relevant library in
|
|
|
|
.I @LIBDIR@
|
|
|
|
and adding an entry to the
|
|
|
|
.I dll.conf
|
|
|
|
configuration file. In other words, no applications need to be
|
|
|
|
modified or recompiled to add support for new devices.
|
|
|
|
.SH "DEVICE NAMES"
|
|
|
|
This backend expects device names of the form:
|
|
|
|
.PP
|
|
|
|
.RS
|
|
|
|
.IR backend : device
|
|
|
|
.RE
|
|
|
|
.PP
|
|
|
|
Where
|
|
|
|
.I backend
|
|
|
|
is the name of the backend and
|
|
|
|
.I device
|
|
|
|
is the name of the device in this backend that should be addressed.
|
|
|
|
If the device name does not contain a colon (:), then the entire string
|
|
|
|
is treated as the
|
|
|
|
.I device
|
|
|
|
string for the default backend. The default backend is the backend
|
|
|
|
listed last in the configuration file (see below) or the first
|
|
|
|
pre-loaded backend (if any).
|
|
|
|
.SH CONFIGURATION
|
|
|
|
The contents of the
|
|
|
|
.I dll.conf
|
2002-12-04 20:25:13 +00:00
|
|
|
file is a list of backend names that may be loaded dynamically upon demand.
|
|
|
|
Empty lines are ignored, also everything after a hash mark (#). A sample
|
|
|
|
configuration file is shown below:
|
1999-08-09 18:06:01 +00:00
|
|
|
.PP
|
|
|
|
.RS
|
|
|
|
net
|
|
|
|
.br
|
|
|
|
# this is a comment
|
|
|
|
.br
|
|
|
|
pnm
|
|
|
|
.br
|
|
|
|
mustek
|
|
|
|
.RE
|
2013-01-11 21:16:01 +00:00
|
|
|
.PP
|
|
|
|
It is also possible to add a file in
|
|
|
|
.I @CONFIGDIR@/dll.d
|
2017-05-27 05:27:22 +00:00
|
|
|
that contains the list of backends to be added. Backends mentioned in a
|
|
|
|
file included in this directory will be added before any backends listed
|
|
|
|
in
|
2013-01-11 21:16:01 +00:00
|
|
|
.I dll.conf.
|
2017-05-27 05:27:22 +00:00
|
|
|
Files in
|
2013-01-11 21:16:01 +00:00
|
|
|
.I @CONFIGDIR@/dll.d
|
|
|
|
can be freely named. They shall follow the format conventions as apply for
|
|
|
|
.I dll.conf.
|
|
|
|
|
1999-08-09 18:06:01 +00:00
|
|
|
.PP
|
|
|
|
Note that backends that were pre-loaded when building this library do
|
|
|
|
not have to be listed in this configuration file. That is, if a
|
|
|
|
backend was preloaded, then that backend will always be present,
|
|
|
|
regardless of whether it's listed in the configuration file or not.
|
|
|
|
.PP
|
|
|
|
The list of preloaded backends is determined by macro
|
|
|
|
.B PRELOADABLE_BACKENDS
|
|
|
|
in file backend/Makefile.in of the SANE source code distribution. After
|
|
|
|
changing the value of this macro, it is necessary to reconfigure, rebuild,
|
|
|
|
and reinstall SANE for the change to take effect.
|
2000-03-05 13:57:25 +00:00
|
|
|
|
2017-05-27 05:27:22 +00:00
|
|
|
Aliases are defined in the config file
|
2001-06-10 13:49:10 +00:00
|
|
|
.IR dll.aliases .
|
|
|
|
It can contain entries of the form
|
2000-03-05 13:57:25 +00:00
|
|
|
.PP
|
|
|
|
.RS
|
|
|
|
.br
|
|
|
|
alias SomeName SaneDeviceName
|
|
|
|
.br
|
|
|
|
alias "Some Name" SaneDeviceName
|
|
|
|
.br
|
|
|
|
hide SaneDeviceName
|
|
|
|
.RE
|
|
|
|
.PP
|
|
|
|
For example:
|
|
|
|
|
|
|
|
.PP
|
|
|
|
.RS
|
|
|
|
.br
|
|
|
|
alias Epson net:somehost:epson:/dev/sgX
|
|
|
|
.br
|
|
|
|
alias "Siemens ST400" st400:/dev/sgY
|
|
|
|
.br
|
|
|
|
hide net:somehost:pnm:0
|
|
|
|
.br
|
|
|
|
hide net:somehost:pnm:1
|
|
|
|
.br
|
|
|
|
alias "Read from file" pnm:0
|
|
|
|
.br
|
|
|
|
hide pnm:1
|
|
|
|
.RE
|
|
|
|
.PP
|
|
|
|
|
|
|
|
Aliased device names are automatically hidden.
|
|
|
|
|
|
|
|
The idea is that users don't have to deal with complicated device
|
|
|
|
names (especially for networked devices), and to hide other exported
|
|
|
|
devices which might confuse them. Note that a hidden device can still
|
|
|
|
be accessed if the device name is known, it just doesn't appear on the
|
|
|
|
list.
|
|
|
|
|
1999-08-09 18:06:01 +00:00
|
|
|
.SH FILES
|
|
|
|
.TP
|
2000-03-05 13:57:25 +00:00
|
|
|
.I @CONFIGDIR@/dll.aliases
|
|
|
|
The list of aliased or hidden backends.
|
|
|
|
.TP
|
1999-08-09 18:06:01 +00:00
|
|
|
.I @CONFIGDIR@/dll.conf
|
|
|
|
The backend configuration file (see also description of
|
|
|
|
.B SANE_CONFIG_DIR
|
|
|
|
below).
|
|
|
|
.TP
|
2008-07-14 10:49:06 +00:00
|
|
|
.I @LIBDIR@/libsane\-dll.a
|
1999-08-09 18:06:01 +00:00
|
|
|
The static library implementing this backend.
|
|
|
|
.TP
|
2008-07-14 10:49:06 +00:00
|
|
|
.I @LIBDIR@/libsane\-dll.so
|
1999-08-09 18:06:01 +00:00
|
|
|
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. 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 @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 "tmp/config", ".", and
|
|
|
|
"@CONFIGDIR@" being searched (in this order).
|
|
|
|
.TP
|
|
|
|
.B SANE_DEBUG_DLL
|
|
|
|
If the library was compiled with debug support enabled, this
|
|
|
|
environment variable controls the debug level for this backend. E.g.,
|
|
|
|
a value of 128 requests all debug output to be printed. Smaller
|
2017-05-27 05:27:22 +00:00
|
|
|
levels reduce verbosity.
|
2001-11-11 19:55:49 +00:00
|
|
|
|
2005-04-12 06:01:14 +00:00
|
|
|
.ft CR
|
|
|
|
.nf
|
2002-12-04 20:25:13 +00:00
|
|
|
Value Description
|
2001-11-11 19:55:49 +00:00
|
|
|
0 print severe errors only
|
|
|
|
1 print normal errors and important messages
|
|
|
|
2 print normal messages
|
|
|
|
3 print debugging messages
|
|
|
|
4 print everything
|
2005-04-12 06:01:14 +00:00
|
|
|
.fi
|
|
|
|
.ft R
|
2001-11-11 19:55:49 +00:00
|
|
|
|
2017-05-27 05:27:22 +00:00
|
|
|
Example:
|
2001-11-11 19:55:49 +00:00
|
|
|
export SANE_DEBUG_DLL=3
|
|
|
|
|
|
|
|
|
2001-06-10 13:49:10 +00:00
|
|
|
.SH "SEE ALSO"
|
2002-12-04 20:25:13 +00:00
|
|
|
.BR sane (7),
|
|
|
|
.BR scanimage (1),
|
2008-07-14 10:49:06 +00:00
|
|
|
.BR sane\-"backendname" (5)
|
2002-12-04 20:25:13 +00:00
|
|
|
|
1999-08-09 18:06:01 +00:00
|
|
|
.SH AUTHOR
|
|
|
|
David Mosberger
|