


sane-net(5)                                           sane-net(5)


NNAAMMEE
       sane-net - SANE network backend

DDEESSCCRRIIPPTTIIOONN
       The ssaannee--nneett library implements a SANE (Scanner Access Now
       Easy) backend that provides access  to  image  acquisition
       devices  through a network connection.  This makes it pos-
       sible to control devices attached to  a  remote  host  and
       also  provides  a means to grant users access to protected
       resources.


DDEEVVIICCEE NNAAMMEESS
       This backend expects device names of the form:

              _h_o_s_t:_d_e_v_i_c_e

       Where _h_o_s_t is the name of the (remote-) host and _d_e_v_i_c_e 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 _d_e_v_i_c_e
       string for the default host.  The default host is the host
       listed last in the configuration file (see below).

CCOONNFFIIGGUURRAATTIIOONN
       The  contents  of  the  _n_e_t_._c_o_n_f.   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  environment variable SSAANNEE__NNEETT__HHOOSSTTSS.  This environ-
       ment 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 _n_e_w_._s_c_a_n_n_e_r_._c_o_m and _s_c_a_n_n_e_r_._u_n_i_v_._e_d_u
       are contacted in addition to the hosts listed above.

       For this backend to function properly, it is  also  neces-
       sary  to  define  the  ssaanneedd service in _/_e_t_c_/_s_e_r_v_i_c_e_s.  At
       present, the ssaanneedd service should be defined using a  line
       of the following form:

              saned 6566/tcp # SANE network scanner daemon

       Note  that  port  number  6566  has  not  been  officially



                         25 October 1997                        1





sane-net(5)                                           sane-net(5)


       assigned to the SANE service and may change in the future.

FFIILLEESS
       _@_C_O_N_F_I_G_D_I_R_@_/_n_e_t_._c_o_n_f
              The  backend  configuration file (see also descrip-
              tion of SSAANNEE__CCOONNFFIIGG__DDIIRR below).

       _@_L_I_B_D_I_R_@_/_l_i_b_s_a_n_e_-_n_e_t_._a
              The static library implementing this backend.

       _@_L_I_B_D_I_R_@_/_l_i_b_s_a_n_e_-_n_e_t_._s_o
              The shared library implementing this backend  (pre-
              sent on systems that support dynamic loading).

EENNVVIIRROONNMMEENNTT
       SSAANNEE__CCOONNFFIIGG__DDIIRR
              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 sepa-
              rator character, then the default  directories  are
              searched  after  the  explicitly specified directo-
              ries.   For  example,  setting  SSAANNEE__CCOONNFFIIGG__DDIIRR  to
              "/tmp/config:"    would   result   in   directories
              "tmp/config", ".", and "@CONFIGDIR@" being searched
              (in this order).

       SSAANNEE__NNEETT__HHOOSSTTSS
              A  colon-separated  list  of  host names to be con-
              tacted by this backend.

       SSAANNEE__DDEEBBUUGG__NNEETT
              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.

AAUUTTHHOORR
       David Mosberger and Andreas Beck












                         25 October 1997                        2


