sane-net - SANE network backend
The sane-net library implements a SANE (Scanner Access Now Easy) backend
that provides access to image acquisition devices through a network
connection. This makes it possible to control devices attached to a
remote host and also provides a means to grant users access to protected
This backend expects device names of the form:
Where host is the name of the (remote-) host and device is the name of
the device on this host that should be addressed. If the device name
does not contain a colon (:), then the entire string is treated as the
device string for the default host. The default host is the host
listed last in the configuration file (see below).
The contents of the net.conf. file is a list of host names that should
be contacted for scan requests. Empty lines and lines starting with a
hash mark (#) are ignored. A sample configuration file is shown below:
# this is a comment
The above list of host names can be extended at run-time using environment
variable SANE_NET_HOSTS. This environment variable is a colonseparated
list of hostnames that should be contacted in addition to the
hosts mentioned in the configuration file. For example, a user could
set the environment variable to the string:
To request that hosts new.scanner.com and scanner.univ.edu are contacted
in addition to the hosts listed above.
For this backend to function properly, it is also necessary to define
the sane service in /etc/services. At present, the sane service should
be defined using a line of the following form:
sane 6566/tcp # SANE network scanner daemon
Note that port number 6566 has not been officially assigned to the SANE
service and may change in the future.
The backend configuration file (see also description of
The static library implementing this backend.
The shared library implementing this backend (present on systems
that support dynamic loading).
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 /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 specified directories. For example, setting
SANE_CONFIG_DIR to "/tmp/config:" would result in directories
"tmp/config", ".", and "/etc/sane.d" being searched (in this
SANE_NET_HOSTS [Toc] [Back]
A colon-separated list of host names to be contacted by this
SANE_DEBUG_NET [Toc] [Back]
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.
If saned has timed out, the net backend may loop with authorization
sane(7), saned(1), sane-dll(5), scanimage(1)
David Mosberger and Andreas Beck
10 Jun 2001 sane-net(5)
[ Back ]