source: pst/scanning/sane.xml@ f051506

10.0 10.1 11.0 6.0 6.1 6.2 6.2.0 6.2.0-rc1 6.2.0-rc2 6.3 6.3-rc1 6.3-rc2 6.3-rc3 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since f051506 was f051506, checked in by Randy McMurchy <randy@…>, 17 years ago

Updated to SANE-1.0.15

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@2929 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 11.0 KB
Line 
1<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
2 "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
3 <!ENTITY % general-entities SYSTEM "../../general.ent">
4 %general-entities;
5
6 <!ENTITY sane-be-download-http "http://gd.tuwien.ac.at/api/sane/sane-backends-&sane-version;/sane-backends-&sane-version;.tar.gz">
7 <!ENTITY sane-be-download-ftp "ftp://ftp.sane-project.org/pub/sane/sane-backends-&sane-version;/sane-backends-&sane-version;.tar.gz">
8 <!ENTITY sane-be-md5sum "3b804f35cdfbc5ad2d201ffe078bbac9">
9 <!ENTITY sane-be-size "3.2 MB">
10 <!ENTITY sane-be-buildsize "50 MB">
11 <!ENTITY sane-be-time "1.26 SBU">
12
13 <!ENTITY sane-fe-version "1.0.13">
14 <!ENTITY sane-fe-download-http "http://gd.tuwien.ac.at/api/sane/sane-frontends-&sane-fe-version;/sane-frontends-&sane-fe-version;.tar.gz">
15 <!ENTITY sane-fe-download-ftp "ftp://ftp.sane-project.org/pub/sane/sane-frontends-&sane-fe-version;/sane-frontends-&sane-fe-version;.tar.gz">
16 <!ENTITY sane-fe-md5sum "2930626e627df49b45192a722cedc8a6">
17 <!ENTITY sane-fe-size "210 KB">
18 <!ENTITY sane-fe-buildsize "2.6 MB">
19 <!ENTITY sane-fe-time "0.09 SBU">
20]>
21
22<sect1 id="sane" xreflabel="SANE-&sane-version;">
23<sect1info>
24<othername>$LastChangedBy$</othername>
25<date>$Date$</date>
26</sect1info>
27<?dbhtml filename="sane.html"?>
28<title>SANE-&sane-version;</title>
29
30<sect2>
31<title>Introduction to
32<application><acronym>SANE</acronym></application></title>
33
34<para><application><acronym>SANE</acronym></application> is short for Scanner
35Access Now Easy. Scanner access, however, is far from easy, since every vendor
36has their own protocols. The only known protocol that should bring some unity
37into this chaos is the TWAIN interface, but this is too imprecise to allow a
38stable scanning framework. Therefore, <acronym>SANE</acronym> comes with its
39own protocol, and the vendor drivers can't be used.</para>
40
41<para><acronym>SANE</acronym> is split into back ends and front ends. The back
42ends are drivers for the supported scanners and cameras. The front ends are
43user interfaces to access the backends.</para>
44
45<sect3><title>Back ends package information</title>
46<itemizedlist spacing='compact'>
47<listitem><para>Download (HTTP): <ulink
48url="&sane-be-download-http;"/></para></listitem>
49<listitem><para>Download (FTP): <ulink
50url="&sane-be-download-ftp;"/></para></listitem>
51<listitem><para>MD5 sum: &sane-be-md5sum;</para></listitem>
52<listitem><para>Download size: &sane-be-size;</para></listitem>
53<listitem><para>Estimated disk space required:
54&sane-be-buildsize;</para></listitem>
55<listitem><para>Estimated build time:
56&sane-be-time;</para></listitem></itemizedlist>
57</sect3>
58
59<sect3><title>Front ends package information</title>
60<itemizedlist spacing='compact'>
61<listitem><para>Download (HTTP): <ulink
62url="&sane-fe-download-http;"/></para></listitem>
63<listitem><para>Download (FTP): <ulink
64url="&sane-fe-download-ftp;"/></para></listitem>
65<listitem><para>MD5 sum: &sane-fe-md5sum;</para></listitem>
66<listitem><para>Download size: &sane-fe-size;</para></listitem>
67<listitem><para>Estimated disk space required:
68&sane-fe-buildsize;</para></listitem>
69<listitem><para>Estimated build time:
70&sane-fe-time;</para></listitem></itemizedlist>
71</sect3>
72
73<sect3><title><application><acronym>SANE</acronym></application>
74dependencies</title>
75<sect4><title>Optional (back ends)</title>
76<para><xref linkend="libjpeg"/>,
77<xref linkend="libusb"/>,
78<ulink url="http://cyberelk.net/tim/libieee1284/">libieee1284</ulink>,
79<ulink url="http://www.gphoto.org/">gPhoto2</ulink>
80(requires <ulink url="http://www.gphoto.org/">libgphoto2</ulink>) and
81<xref linkend="pst-typesetting-tex"/></para>
82</sect4>
83
84<sect4><title>Optional (front ends)</title>
85<para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>),
86<xref linkend="GTK2"/> and
87<xref linkend="gimp"/></para>
88</sect4>
89</sect3>
90
91</sect2>
92
93<sect2>
94<title>Installation of
95<application><acronym>SANE</acronym></application></title>
96
97<sect3><title>Preparing your system for scanner access</title>
98<para>To access your scanner, you will probably need the related kernel
99drivers or additional support packages (<application>libusb</application>).
100A <acronym>SCSI</acronym> scanner will need <acronym>SCSI</acronym>
101drivers, a parallel port scanner needs parallel port support (you should use
102enhanced <acronym>EPP</acronym> modes) and a <acronym>USB</acronym> scanner
103will need the <application>libusb</application> package and a
104<acronym>SCSI</acronym> system for emulation. Be sure that you have got the
105necessary drivers to access the devices.</para>
106</sect3>
107
108<sect3><title>Installation of
109<application><acronym>SANE</acronym></application> back ends</title>
110
111<para>Install <application><acronym>SANE</acronym></application>-backends by
112running the following commands:</para>
113
114<screen><userinput><command>./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
115make &amp;&amp;
116make install</command></userinput></screen>
117</sect3>
118
119<sect3><title>Installation of
120<application><acronym>SANE</acronym></application> front ends</title>
121
122<para>The <application><acronym>SANE</acronym></application>-frontends package
123includes the graphical frontends <command>xscanimage</command> and
124<command>xcam</command>, and a command-line frontend
125<command>scanadf</command>. You don't need this package if you intend to use
126one of the more advanced graphical frontends like <xref linkend="xsane"/>. For
127a list of frontend packages, see
128<ulink url="http://www.sane-project.org/sane-frontends.html"/>.</para>
129
130<para>To install <application><acronym>SANE</acronym></application>-frontends,
131use the following commands:</para>
132
133<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
134make &amp;&amp;
135make install</command></userinput></screen>
136
137<para>If <application>GIMP</application> was linked into the build and you
138wish <application>GIMP</application> to use <command>xscanimage</command> as
139a scanning plugin, issue the following command:</para>
140
141<screen><userinput><command>ln -s /usr/bin/xscanimage /usr/lib/gimp/2.0/plug-ins</command></userinput></screen>
142</sect3>
143
144</sect2>
145
146<sect2>
147<title>Command explanations</title>
148
149<para><parameter>--sysconfdir=/etc</parameter>: This switch installs the
150configuration files in <filename class="directory">/etc/sane.d</filename>
151instead of <filename class="directory">/usr/etc/sane.d</filename>.</para>
152
153</sect2>
154
155<sect2>
156<title>Configuring <application><acronym>SANE</acronym></application></title>
157
158<sect3><title>Config files</title>
159<para><filename>/etc/sane.d/*.conf</filename></para>
160</sect3>
161
162<sect3><title>Configuration information</title>
163<sect4><title>Backend configuration</title>
164<para>The backend configuration files are located in
165<filename class='directory'>/etc/sane.d</filename>. Information for configuring
166the various backends can be found by using the man(5) page for the desired
167backend. Run <command>man sane-<replaceable>[backend]</replaceable></command>,
168substituting the desired backend.</para>
169</sect4>
170
171<sect4><title>General information</title>
172<para>For general information about configuring and using
173<application><acronym>SANE</acronym></application>, see
174<command>man sane</command>. Linux-2.6.x brings some special issues into the
175picture. See <ulink url="http://www.sane-project.org/README.linux"/> for
176information about using <application><acronym>SANE</acronym></application>
177with the Linux-2.6.x kernel. For information about <acronym>USB</acronym>
178scanning devices, run <command>man sane-usb</command>. For information about
179<acronym>SCSI</acronym> devices, run <command>man sane-scsi</command>.</para>
180</sect4>
181
182<sect4><title>Configuration and setup of the <command>saned</command>
183daemon</title>
184<para>The <command>saned</command> daemon is not meant to be used for untrusted
185clients. You should provide <application>tcpwrapper</application> and/or
186firewall protection to insure only trusted clients access the daemon. Due to
187the complex security requirements to insure only trusted clients access the
188daemon, <acronym>BLFS</acronym> does not provide a bootscript for the
189<command>saned</command> daemon. If you desire to run the daemon, ensure you
190provide adequate security and start the daemon manually, or create your own
191bootscript to start the daemon at system boot time. Some good information for
192setting up and securing the <command>saned</command> daemon can be found at
193<ulink url="http://penguin-breeder.org/sane/saned/"/>.</para>
194</sect4>
195</sect3>
196
197</sect2>
198
199<sect2>
200<title>Contents</title>
201
202<sect3><title>Back ends:</title>
203<para>The <application><acronym>SANE</acronym></application>-backends package
204contains
205<command>gamma4scanimage</command>,
206<command>sane-config</command>,
207<command>saned</command>,
208<command>sane-find-scanner</command>,
209<command>scanimage</command>,
210the <filename class='libraryfile'>libsane</filename> library and
211numerous scanner backend modules. See
212<ulink url="http://www.sane-project.org/sane-supported-devices.html"/>
213for a list of supported backends.</para>
214</sect3>
215
216<sect3><title>Front ends:</title>
217<para>The <application><acronym>SANE</acronym></application>-frontends package
218contains
219<command>scanadf</command>,
220<command>xcam</command>,
221<command>xscanimage</command> and a <application>GIMP</application> plugin
222imbedded in <command>xscanimage</command>.</para>
223</sect3>
224
225</sect2>
226
227<sect2>
228<title>Description</title>
229
230<sect3><title>gamma4scanimage</title>
231<para><command>gamma4scanimage</command> creates a gamma table in the format
232expected by <command>scanimage</command>.</para></sect3>
233
234<sect3><title>sane-config</title>
235<para><command>sane-config</command> is a tool used to determine the compiler
236and linker flags that should be used to compile and link
237<application><acronym>SANE</acronym></application>.</para></sect3>
238
239<sect3><title>saned</title>
240<para><command>saned</command> is the
241<application><acronym>SANE</acronym></application> daemon that allows remote
242clients to access image acquisition devices available on the local
243host.</para></sect3>
244
245<sect3><title>sane-find-scanner</title>
246<para><command>sane-find-scanner</command> is a command-line tool to find
247<acronym>SCSI</acronym> and <acronym>USB</acronym> scanners and determine
248their device files. Its primary aim is to make sure that scanners can be
249detected by <application><acronym>SANE</acronym></application>
250backends.</para></sect3>
251
252<sect3><title>scanadf</title>
253<para><command>scanadf</command> is a command-line interface to control image
254acquisition devices which are equipped with an automatic document feeder
255(<acronym>ADF</acronym>).</para></sect3>
256
257<sect3><title>scanimage</title>
258<para><command>scanimage</command> is a command line interface for scanning
259from image acquisition devices such as flatbed scanners or cameras. It is
260also used to list the available backend devices.</para></sect3>
261
262<sect3><title>xcam</title>
263<para><command>xcam</command> is a graphical camera front end for
264<application><acronym>SANE</acronym></application>.</para></sect3>
265
266<sect3><title>xscanimage</title>
267<para><command>xscanimage</command> is a graphical user interface for
268scanning.</para></sect3>
269
270</sect2>
271
272</sect1>
Note: See TracBrowser for help on using the repository browser.