SGI Techpubs Library

Linux  »  Man Pages
find in page

sane-net


DESCRIPTION

       The  sane-net library implements a SANE (Scanner Access Now Easy) back-
       end 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  pro-
       tected resources.


DEVICE NAMES

       This backend expects device names of the form:

              host:device

       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).


CONFIGURATION

       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:

              scan-server.somedomain.firm
              # this is a comment
              localhost

       The above list of host names can be extended at run-time using environ-
       ment  variable  SANE_NET_HOSTS.   This environment variable is a colon-
       separated 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:

              new.scanner.com:scanner.univ.edu

       To request that hosts new.scanner.com  and  scanner.univ.edu  are  con-
       tacted 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


FILES

       /etc/sane.d/net.conf
              The   backend   configuration  file  (see  also  description  of
              SANE_CONFIG_DIR below).

       /usr/lib*/sane/libsane-net.a
              The static library implementing this backend.

       /usr/lib*/sane/libsane-net.so
              The shared library implementing this backend (present on systems
              value  of the environment variable ends with the directory sepa-
              rator 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
              order).

       SANE_NET_HOSTS
              A colon-separated list of host names to  be  contacted  by  this
              backend.

       SANE_DEBUG_NET
              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.


BUGS

       If saned has timed out, the net backend  may  loop  with  authorization
       requests.


SEE ALSO

       sane(7), saned(1), sane-dll(5), scanimage(1)

       http://www.penguin-breeder.org/?page=sane-net


AUTHOR

       David Mosberger and Andreas Beck

                                  8 Oct 2002                       sane-net(5)

Output converted with man2html


home/search | what's new | help