sane-test.5




NAME

       sane-test - SANE backend for testing frontends


DESCRIPTION

       The  sane-test  library  implements a SANE (Scanner Access
       Now Easy) backend that allows testing the  SANE  installa�
       tion and SANE frontends.  It provides access to a (nearly)
       unlimited number of virtual devices. There is  no  support
       for  real  scanners or cameras. However, the backend simu�
       lates scanning and setting options.

       The idea is not only to find bugs in frontends but also to
       show  all capabilities of SANE. Therefore sane-test imple�
       ments functions and options that  are  not  (or  seldomly)
       found in other backends.

       The       backend       is      commented      out      in
       /usr/local/etc/sane.d/dll.conf, so either the comment sign
       must be removed or the backend must be called explicitely.
       E.g.  `scanimage -d test' or `xscanimage test'.


SANE OPTIONS

       The options should be self-explanatory.  Have  a  look  at
       their descriptions.  If a description is too vague, please
       contact me. Just some comments: The combination  of  color
       and  1-bit mode is quite obscure (8 colors) but allowed in
       the SANE standard. However, the meaning  of  bits  is  not
       defined.  Currently  1 = high intensity and 0 = low inten�
       sity is used.


FILES

       /usr/local/etc/sane.d/test.conf
              The backend configuration file (see  also  descrip�
              tion  of SANE_CONFIG_DIR below). The initial values
              of most of the basic SANE options can be configured
              in this file. A template containing all the default
              values is provided together with this backend.  One
              of   the   more  interesting  values  may  be  num�
              ber_of_devices.  It can be used to check the  fron�
              tend's ability to show a long list of devices.  The
              config values concerning  resolution  and  geometry
              can  be  usefull  to  test the handling of big file
              sizes.

       /usr/local/lib/sane/libsane-test.a
              The static library implementing this backend.

       /usr/local/lib/sane/libsane-test.so
              The shared library implementing this backend  (pre�
              sent on systems that support dynamic loading).


ENVIRONMENT

       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  /usr/local/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 spec�
              ified directories.  For example, setting  SANE_CON�
              FIG_DIR  to "/tmp/config:" would result in directo�
              ries "tmp/config", ".", and "/usr/local/etc/sane.d"
              being searched (in this order).

       SANE_DEBUG_TEST
              If  the  library  was  compiled  with debug support
              enabled, this  environment  variable  controls  the
              debug  level for this backend.  Higher debug levels
              increase the verbosity of the output.

              Example: export SANE_DEBUG_TEST=4


SEE ALSO

       sane(7), http://www.meier-geinitz.de/sane/test-backend/


AUTHOR

       Henning Meier-Geinitz <henning@meier-geinitz.de>


BUGS

       - config file values aren't tested for correctness  -  man
       page hasn't been completed yet


Man(1) output converted with man2html