mirror of
https://github.com/Zeckmathederg/glfs.git
synced 2025-02-03 23:07:23 +08:00
03d517889b
git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@3252 af4574ff-66df-0310-9fd7-8a98e5e911e0
274 lines
11 KiB
XML
274 lines
11 KiB
XML
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
|
|
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
|
|
<!ENTITY % general-entities SYSTEM "../../general.ent">
|
|
%general-entities;
|
|
|
|
<!ENTITY sane-be-download-http "http://gd.tuwien.ac.at/api/sane/sane-backends-&sane-version;/sane-backends-&sane-version;.tar.gz">
|
|
<!ENTITY sane-be-download-ftp "ftp://ftp.sane-project.org/pub/sane/sane-backends-&sane-version;/sane-backends-&sane-version;.tar.gz">
|
|
<!ENTITY sane-be-md5sum "3b804f35cdfbc5ad2d201ffe078bbac9">
|
|
<!ENTITY sane-be-size "3.2 MB">
|
|
<!ENTITY sane-be-buildsize "50 MB">
|
|
<!ENTITY sane-be-time "1.26 SBU">
|
|
|
|
<!ENTITY sane-fe-version "1.0.13">
|
|
<!ENTITY sane-fe-download-http "http://gd.tuwien.ac.at/api/sane/sane-frontends-&sane-fe-version;/sane-frontends-&sane-fe-version;.tar.gz">
|
|
<!ENTITY sane-fe-download-ftp "ftp://ftp.sane-project.org/pub/sane/sane-frontends-&sane-fe-version;/sane-frontends-&sane-fe-version;.tar.gz">
|
|
<!ENTITY sane-fe-md5sum "2930626e627df49b45192a722cedc8a6">
|
|
<!ENTITY sane-fe-size "210 KB">
|
|
<!ENTITY sane-fe-buildsize "2.6 MB">
|
|
<!ENTITY sane-fe-time "0.09 SBU">
|
|
]>
|
|
|
|
<sect1 id="sane" xreflabel="SANE-&sane-version;">
|
|
<sect1info>
|
|
<othername>$LastChangedBy$</othername>
|
|
<date>$Date$</date>
|
|
</sect1info>
|
|
<?dbhtml filename="sane.html"?>
|
|
<title>SANE-&sane-version;</title>
|
|
|
|
<sect2>
|
|
<title>Introduction to
|
|
<application><acronym>SANE</acronym></application></title>
|
|
|
|
<para><application><acronym>SANE</acronym></application> is short for Scanner
|
|
Access Now Easy. Scanner access, however, is far from easy, since every vendor
|
|
has their own protocols. The only known protocol that should bring some unity
|
|
into this chaos is the TWAIN interface, but this is too imprecise to allow a
|
|
stable scanning framework. Therefore, <acronym>SANE</acronym> comes with its
|
|
own protocol, and the vendor drivers can't be used.</para>
|
|
|
|
<para><acronym>SANE</acronym> is split into back ends and front ends. The back
|
|
ends are drivers for the supported scanners and cameras. The front ends are
|
|
user interfaces to access the backends.</para>
|
|
|
|
<sect3><title>Back ends package information</title>
|
|
<itemizedlist spacing='compact'>
|
|
<listitem><para>Download (HTTP): <ulink
|
|
url="&sane-be-download-http;"/></para></listitem>
|
|
<listitem><para>Download (FTP): <ulink
|
|
url="&sane-be-download-ftp;"/></para></listitem>
|
|
<listitem><para>Download MD5 sum: &sane-be-md5sum;</para></listitem>
|
|
<listitem><para>Download size: &sane-be-size;</para></listitem>
|
|
<listitem><para>Estimated disk space required:
|
|
&sane-be-buildsize;</para></listitem>
|
|
<listitem><para>Estimated build time:
|
|
&sane-be-time;</para></listitem></itemizedlist>
|
|
</sect3>
|
|
|
|
<sect3><title>Front ends package information</title>
|
|
<itemizedlist spacing='compact'>
|
|
<listitem><para>Download (HTTP): <ulink
|
|
url="&sane-fe-download-http;"/></para></listitem>
|
|
<listitem><para>Download (FTP): <ulink
|
|
url="&sane-fe-download-ftp;"/></para></listitem>
|
|
<listitem><para>Downlaod MD5 sum: &sane-fe-md5sum;</para></listitem>
|
|
<listitem><para>Download size: &sane-fe-size;</para></listitem>
|
|
<listitem><para>Estimated disk space required:
|
|
&sane-fe-buildsize;</para></listitem>
|
|
<listitem><para>Estimated build time:
|
|
&sane-fe-time;</para></listitem></itemizedlist>
|
|
</sect3>
|
|
|
|
<sect3><title><application><acronym>SANE</acronym></application>
|
|
dependencies</title>
|
|
<sect4><title>Optional (back ends)</title>
|
|
<para><xref linkend="libjpeg"/>,
|
|
<xref linkend="libusb"/>,
|
|
<ulink url="http://cyberelk.net/tim/libieee1284/">libieee1284</ulink>,
|
|
<ulink url="http://www.gphoto.org/">gPhoto2</ulink>
|
|
(requires <ulink url="http://www.gphoto.org/">libgphoto2</ulink>) and
|
|
<xref linkend="tex"/></para>
|
|
</sect4>
|
|
|
|
<sect4><title>Optional (front ends)</title>
|
|
<para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>),
|
|
<xref linkend="gtk2"/> and
|
|
<xref linkend="gimp"/></para>
|
|
</sect4>
|
|
</sect3>
|
|
|
|
</sect2>
|
|
|
|
<sect2>
|
|
<title>Installation of
|
|
<application><acronym>SANE</acronym></application></title>
|
|
|
|
<sect3><title>Preparing your system for scanner access</title>
|
|
<para>To access your scanner, you will probably need the related kernel
|
|
drivers or additional support packages (<application>libusb</application>).
|
|
A <acronym>SCSI</acronym> scanner will need <acronym>SCSI</acronym>
|
|
drivers, a parallel port scanner needs parallel port support (you should use
|
|
enhanced <acronym>EPP</acronym> modes) and a <acronym>USB</acronym> scanner
|
|
will need the <application>libusb</application> package and a
|
|
<acronym>SCSI</acronym> system for emulation. Be sure that you have got the
|
|
necessary drivers to access the devices.</para>
|
|
</sect3>
|
|
|
|
<sect3><title>Installation of
|
|
<application><acronym>SANE</acronym></application> back ends</title>
|
|
|
|
<para>Install <application><acronym>SANE</acronym></application>-backends by
|
|
running the following commands:</para>
|
|
|
|
<screen><userinput><command>./configure --prefix=/usr --sysconfdir=/etc &&
|
|
make &&
|
|
make install</command></userinput></screen>
|
|
</sect3>
|
|
|
|
<sect3><title>Installation of
|
|
<application><acronym>SANE</acronym></application> front ends</title>
|
|
|
|
<para>The <application><acronym>SANE</acronym></application>-frontends package
|
|
includes the graphical frontends <command>xscanimage</command> and
|
|
<command>xcam</command>, and a command-line frontend
|
|
<command>scanadf</command>. You don't need this package if you intend to use
|
|
one of the more advanced graphical frontends like <xref linkend="xsane"/>. For
|
|
a list of frontend packages, see
|
|
<ulink url="http://www.sane-project.org/sane-frontends.html"/>.</para>
|
|
|
|
<para>To install <application><acronym>SANE</acronym></application>-frontends,
|
|
use the following commands:</para>
|
|
|
|
<screen><userinput><command>./configure --prefix=/usr &&
|
|
make &&
|
|
make install</command></userinput></screen>
|
|
|
|
<para>If <application>GIMP</application> was linked into the build and you
|
|
wish <application>GIMP</application> to use <command>xscanimage</command> as
|
|
a scanning plugin, issue the following command:</para>
|
|
|
|
<screen><userinput><command>ln -s /usr/bin/xscanimage /usr/lib/gimp/2.0/plug-ins</command></userinput></screen>
|
|
</sect3>
|
|
|
|
</sect2>
|
|
|
|
<sect2>
|
|
<title>Command explanations</title>
|
|
|
|
<para><parameter>--sysconfdir=/etc</parameter>: This switch installs the
|
|
configuration files in <filename class="directory">/etc/sane.d</filename>
|
|
instead of <filename class="directory">/usr/etc/sane.d</filename>.</para>
|
|
|
|
</sect2>
|
|
|
|
<sect2>
|
|
<title>Configuring <application><acronym>SANE</acronym></application></title>
|
|
|
|
<sect3><title>Config files</title>
|
|
<para><filename>/etc/sane.d/*.conf</filename></para>
|
|
</sect3>
|
|
|
|
<sect3><title>Configuration information</title>
|
|
<sect4><title>Backend configuration</title>
|
|
<para>The backend configuration files are located in
|
|
<filename class='directory'>/etc/sane.d</filename>. Information for configuring
|
|
the various backends can be found by using the man(5) page for the desired
|
|
backend. Run <command>man sane-<replaceable>[backend]</replaceable></command>,
|
|
substituting the desired backend.</para>
|
|
</sect4>
|
|
|
|
<sect4><title>General information</title>
|
|
<para>For general information about configuring and using
|
|
<application><acronym>SANE</acronym></application>, see
|
|
<command>man sane</command>. Linux-2.6.x brings some special issues into the
|
|
picture. See <ulink url="http://www.sane-project.org/README.linux"/> for
|
|
information about using <application><acronym>SANE</acronym></application>
|
|
with the Linux-2.6.x kernel. For information about <acronym>USB</acronym>
|
|
scanning devices, run <command>man sane-usb</command>. For information about
|
|
<acronym>SCSI</acronym> devices, run <command>man sane-scsi</command>.</para>
|
|
</sect4>
|
|
|
|
<sect4><title>Configuration and setup of the <command>saned</command>
|
|
daemon</title>
|
|
<para>The <command>saned</command> daemon is not meant to be used for untrusted
|
|
clients. You should provide <application>tcpwrapper</application> and/or
|
|
firewall protection to insure only trusted clients access the daemon. Due to
|
|
the complex security requirements to insure only trusted clients access the
|
|
daemon, <acronym>BLFS</acronym> does not provide instructions to configure the
|
|
<command>saned</command> daemon. If you desire to make the daemon available,
|
|
ensure you provide adequate security, configure your
|
|
<filename>[x]inetd.conf</filename> file and send a
|
|
<userinput>SIGHUP</userinput> to the [x]inetd daemon. Some good information for
|
|
setting up and securing the <command>saned</command> daemon can be found at
|
|
<ulink url="http://penguin-breeder.org/sane/saned/"/>.</para>
|
|
</sect4>
|
|
</sect3>
|
|
|
|
</sect2>
|
|
|
|
<sect2>
|
|
<title>Contents</title>
|
|
|
|
<sect3><title>Back ends:</title>
|
|
<para>The <application><acronym>SANE</acronym></application>-backends package
|
|
contains
|
|
<command>gamma4scanimage</command>,
|
|
<command>sane-config</command>,
|
|
<command>saned</command>,
|
|
<command>sane-find-scanner</command>,
|
|
<command>scanimage</command>,
|
|
the <filename class='libraryfile'>libsane</filename> library and
|
|
numerous scanner backend modules. See
|
|
<ulink url="http://www.sane-project.org/sane-supported-devices.html"/>
|
|
for a list of supported backends.</para>
|
|
</sect3>
|
|
|
|
<sect3><title>Front ends:</title>
|
|
<para>The <application><acronym>SANE</acronym></application>-frontends package
|
|
contains
|
|
<command>scanadf</command>,
|
|
<command>xcam</command>,
|
|
<command>xscanimage</command> and a <application>GIMP</application> plugin
|
|
imbedded in <command>xscanimage</command>.</para>
|
|
</sect3>
|
|
|
|
</sect2>
|
|
|
|
<sect2>
|
|
<title>Description</title>
|
|
|
|
<sect3><title>gamma4scanimage</title>
|
|
<para><command>gamma4scanimage</command> creates a gamma table in the format
|
|
expected by <command>scanimage</command>.</para></sect3>
|
|
|
|
<sect3><title>sane-config</title>
|
|
<para><command>sane-config</command> is a tool used to determine the compiler
|
|
and linker flags that should be used to compile and link
|
|
<application><acronym>SANE</acronym></application>.</para></sect3>
|
|
|
|
<sect3><title>saned</title>
|
|
<para><command>saned</command> is the
|
|
<application><acronym>SANE</acronym></application> daemon that allows remote
|
|
clients to access image acquisition devices available on the local
|
|
host.</para></sect3>
|
|
|
|
<sect3><title>sane-find-scanner</title>
|
|
<para><command>sane-find-scanner</command> is a command-line tool to find
|
|
<acronym>SCSI</acronym> and <acronym>USB</acronym> scanners and determine
|
|
their device files. Its primary aim is to make sure that scanners can be
|
|
detected by <application><acronym>SANE</acronym></application>
|
|
backends.</para></sect3>
|
|
|
|
<sect3><title>scanadf</title>
|
|
<para><command>scanadf</command> is a command-line interface to control image
|
|
acquisition devices which are equipped with an automatic document feeder
|
|
(<acronym>ADF</acronym>).</para></sect3>
|
|
|
|
<sect3><title>scanimage</title>
|
|
<para><command>scanimage</command> is a command line interface for scanning
|
|
from image acquisition devices such as flatbed scanners or cameras. It is
|
|
also used to list the available backend devices.</para></sect3>
|
|
|
|
<sect3><title>xcam</title>
|
|
<para><command>xcam</command> is a graphical camera front end for
|
|
<application><acronym>SANE</acronym></application>.</para></sect3>
|
|
|
|
<sect3><title>xscanimage</title>
|
|
<para><command>xscanimage</command> is a graphical user interface for
|
|
scanning.</para></sect3>
|
|
|
|
</sect2>
|
|
|
|
</sect1>
|