Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
sane-kodak(5)		 SANE Scanner Access Now Easy		 sane-kodak(5)

       sane-kodak - SANE backend for big Kodak flatbed and ADF scanners

       The  sane-kodak	library	 implements  a	SANE (Scanner Access Now Easy)
       backend which provides access to	large Kodak flatbed and	ADF scanners.

       This document describes backend version	7,  which  shipped  with  SANE

       This  version  should  support  models  which  speak the	Kodak SCSI and
       Firewire	protocols. The i1860 was used  to  develop  the	 backend,  but
       other  models  may work with only minimal modifications.	Please see the
       list at for  an
       updated list.

       If  you have a machine not on that list,	or reported as 'untested': the
       best way	to determine level of support is to test the scanner directly,
       or  to collect a	trace of the windows driver in action.	Please contact
       the author for help or with test	results.

       Most of the recent Kodak	consumer or workgroup level machines are based
       on  other chipsets and are not supported	by this	backend. Some of these
       scanners	may be supported by another backend.

       Effort has been made to expose the basic	hardware options, including:

       --source	s
	      Selects the source for the scan. Options may include  "Flatbed",
	      "ADF Front", "ADF	Back", "ADF Duplex".

       --mode m
	      Selects  the  mode  for the scan.	Options	may include "Lineart",
	      "Halftone", "Gray", and "Color".

	      Controls scan resolution.	Available choices may  be  limited  by

       --tl-x, --tl-y, --br-x, --br-y
	      Sets scan	area upper left	and lower right	coordinates. These are
	      renamed -t, -l, -x, -y by	some frontends.

       --page-width, --page-height
	      Sets paper size. Used by scanner to determine centering of  scan
	      coordinates  when	 using the ADF (Automatic Document Feeder) and
	      to detect	double feed errors.

       Other options will be available based on	the capabilities of the	 scan-
       ner.   Use  scanimage  --help to	get a list, but	be aware that some op-
       tions may be settable only when another option has been set,  and  that
       advanced	options	may be hidden by some frontend programs.

       The  configuration  file	 kodak.conf is used to tell the	backend	how to
       look for	scanners, and provide options controlling the operation	of the
       backend.	 This file is read each	time the frontend asks the backend for
       a list of scanners, generally only when the  frontend  starts.  If  the
       configuration  file  is missing,	the backend will use a set of compiled
       defaults, which are identical to	the default configuration file shipped
       with SANE.

       Scanners	can be specified in the	configuration file in 2	ways:

       "scsi KODAK"
	      Requests	backend	 to  search all	scsi buses in the system for a
	      device which reports itself to be	a scanner made by 'KODAK'.

       "scsi /dev/sg0" (or other scsi device file)
	      Requests backend to open the named scsi device. Only  useful  if
	      you  have	multiple compatible scanners connected to your system,
	      and need to specify one. Probably	should not be  used  with  the
	      other "scsi" line	above.

       The  only configuration option supported	is "buffer-size=xxx", allowing
       you to set the number of	bytes in the data buffer  to  something	 other
       than the	compiled-in default, 32768 (32K). Some users report that their
       scanner will "hang" mid-page, or	fail to	transmit the image if the buf-
       fer is not large	enough.

       Note:  This option may appear multiple times in the configuration file.
       It only applies to scanners discovered by 'scsi/usb' lines that	follow
       this option.

       Note:  The backend does not place an upper bound	on this	value, as some
       users required it to be quite large. Values above the default  are  not
       recommended, and	may crash your OS or lockup your scsi card driver. You
       have been warned.

       The backend uses	a single environment variable, SANE_DEBUG_KODAK, which
       enables debugging output	to stderr. Valid values	are:

	      5	 Errors
	      10 Function trace
	      15 Function detail
	      20 Option	commands
	      25 SCSI trace
	      30 SCSI detail
	      35 Useless noise

       Most  hardware options are either not supported or not exposed for con-
       trol by the user, including: multifeed  detection,  image  compression,
       autocropping, endorser, thresholding, multi-stream, etc.

       The  various  authors  of  the  sane-fujitsu(5) backend provided	useful
       Kodak provided access to	hardware, documentation	and personnel.

       sane(7),	sane-scsi(5), scanimage(1)

       m. allan	noah: <kitno455	a t gmail d o t	com>

				  10 Feb 2010			 sane-kodak(5)


Want to link to this manual page? Use this URL:

home | help