sane-magicolor.5

sane-magicolor(5)        SANE Scanner Access Now Easy        sane-magicolor(5)

NAME

       sane-magicolor - SANE backend for KONICA MINOLTA magicolor scanners

DESCRIPTION

       The  sane-magicolor  backend supports KONICA MINOLTA magicolor scanners
       connected via USB or LAN. Currently, only the magicolor  1690MF  device
       is  supported,  no  other  devices  with the same scanning protocol are
       known.

SUPPORTED DEVICES

       The following scanner should work with this backend:

       Device Details
       -----------------------------
       Vendor: KONICA MINOLTA
       Model: magicolor 1690MF

CONFIGURATION

       This section describes the backend's configuration  file  entries.  The
       file is located at:

              /usr/local/etc/sane.d/magicolor.conf

       For a proper setup, at least one of the following entries are needed:

              net autodiscovery
              net [IP ADDRESS] [DEVICE-ID]
              usb
              usb [VENDOR-ID] [DEVICE-ID]

FILES

       /usr/local/etc/sane.d/magicolor.conf
              The backend configuration file

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

       /usr/local/lib/sane/libsane-magicolor.so
              The shared library implementing this backend (present on systems
              that support dynamic loading).

ENVIRONMENT

       SANE_CONFIG_DIR
              This environment variable specifies the list of directories that
              may contain the configuration file.  On *NIX systems, the direc-
              tories are separated by a colon (`:'), under OS/2, they are sep-
              arated  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/lo-
              cal/etc/sane.d.  If the value of the environment  variable  ends
              with  the directory separator character, then the default direc-
              tories are searched after the explicitly specified  directories.
              For example, setting SANE_CONFIG_DIR to "/tmp/config:" would re-
              sult in directories /tmp/config,  .,  and  /usr/local/etc/sane.d
              being searched (in this order).

       SANE_DEBUG_MAGICOLOR
              If the library was compiled with debug support enabled, this en-
              vironment variable controls the debug level  for  this  backend.
              Higher debug levels increase the verbosity of the output.

              Example: export SANE_DEBUG_MAGICOLOR=127

              To  obtain debug messages from the backend, set this environment
              variable before calling your favorite frontend  (e.g.   xscanim-
              age(1)).

              Example: SANE_DEBUG_MAGICOLOR=65 xscanimage

KNOWN BUGS AND RESTRICTIONS

       Large  color  scans  may  sometimes timeout due to unknown reasons (the
       scanner simply stops returning data).

       Cancelling large scans may lock up the scanner.

SEE ALSO

       sane(7),
       http://wiki.kainhofer.com/hardware/magicolor_scan

AUTHOR

       Reinhold Kainhofer <reinhold@kainhofer.com>

                                  10 Jan 2011                sane-magicolor(5)