NAME<\/a> sane\u2212dll \u2212 SANE dynamic backend loader<\/p>\n The sane\u2212dll<\/b> 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 sane\u2212dll<\/b> 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 \/usr\/lib64\/sane<\/i> and adding an entry to the dll.conf<\/i> configuration file. In other words, no applications need to be modified or recompiled to add support for new devices.<\/p>\n This backend expects device names of the form:<\/p>\n backend<\/i>:device<\/i><\/p>\n Where backend<\/i> is the name of the backend and device<\/i> 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 device<\/i> 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).<\/p>\n The contents of the dll.conf<\/i> 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:<\/p>\n net It is also possible to add a file in \/etc\/sane.d\/dll.d<\/i> 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 dll.conf.<\/i> Files in \/etc\/sane.d\/dll.d<\/i> can be freely named. They shall follow the format conventions as apply for dll.conf.<\/i><\/p>\n 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\u2019s listed in the configuration file or not.<\/p>\n The list of preloaded backends is determined by macro PRELOADABLE_BACKENDS<\/b> 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.<\/p>\n Aliases are defined in the config file dll.aliases<\/i>. It can contain entries of the form<\/p>\n alias SomeName SaneDeviceName For example:<\/p>\n alias Epson net:somehost:epson:\/dev\/sgX Aliased device names are automatically hidden.<\/p>\n The idea is that users don\u2019t 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\u2019t appear on the list.<\/p>\n \/etc\/sane.d\/dll.aliases<\/i><\/p>\n The list of aliased or hidden backends.<\/p>\n \/etc\/sane.d\/dll.conf<\/i><\/p>\n The backend configuration file (see also description of SANE_CONFIG_DIR<\/b> below).<\/p>\n \/usr\/lib64\/sane\/libsane\u2212dll.a<\/i><\/p>\n The static library implementing this backend.<\/p>\n \/usr\/lib64\/sane\/libsane\u2212dll.so<\/i><\/p>\n The shared library implementing this backend (present on systems that support dynamic loading).<\/p>\n SANE_CONFIG_DIR<\/b><\/p>\n This environment variable specifies the list of directories that may contain the configuration file. On *NIX systems, the directories are separated by a colon (\u2018:\u2019), under OS\/2, they are separated by a semi-colon (\u2018;\u2019). If this variable is not set, the configuration file is searched in two default directories: first, the current working directory (“.”) and then in \/etc\/sane.d<\/i>. 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 SANE_CONFIG_DIR<\/b> to “\/tmp\/config:” would result in directories tmp\/config<\/i>, .<\/i>, and \/etc\/sane.d<\/i> being searched (in this order).<\/p>\n SANE_DEBUG_DLL<\/b><\/p>\n 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 levels reduce verbosity.<\/p>\n Value Description Example: export SANE_DEBUG_DLL=3<\/p>\n
DESCRIPTION<\/a>
DEVICE NAMES<\/a>
CONFIGURATION<\/a>
FILES<\/a>
ENVIRONMENT<\/a>
SEE ALSO<\/a>
AUTHOR<\/a> <\/p>\n
\nNAME <\/a> <\/h2>\n
DESCRIPTION <\/a> <\/h2>\n
DEVICE NAMES <\/a> <\/h2>\n
CONFIGURATION <\/a> <\/h2>\n
# this is a comment
pnm
mustek<\/p>\n
alias “Some Name” SaneDeviceName
hide SaneDeviceName<\/p>\n
alias “Siemens ST400” st400:\/dev\/sgY
hide net:somehost:pnm:0
hide net:somehost:pnm:1
alias “Read from file” pnm:0
hide pnm:1<\/p>\nFILES <\/a> <\/h2>\n
ENVIRONMENT <\/a> <\/h2>\n
0 print severe errors only
1 print normal errors and important messages
2 print normal messages
3 print debugging messages
4 print everything<\/p>\nSEE ALSO <\/a> <\/h2>\n