source: pst/scanning/sane.xml@ a8eba10

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 xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since a8eba10 was a8eba10, checked in by Igor Živković <igor@…>, 17 years ago

Updated to GTK+-2.6.0.

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

  • Property mode set to 100644
File size: 11.1 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>Download 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>Downlaod 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 instructions to configure the
189<command>saned</command> daemon. If you desire to make the daemon available,
190ensure you provide adequate security, configure your
191<filename>[x]inetd.conf</filename> file and send a
192<userinput>SIGHUP</userinput> to the [x]inetd daemon. Some good information for
193setting up and securing the <command>saned</command> daemon can be found at
194<ulink url="http://penguin-breeder.org/sane/saned/"/>.</para>
195</sect4>
196</sect3>
197
198</sect2>
199
200<sect2>
201<title>Contents</title>
202
203<sect3><title>Back ends:</title>
204<para>The <application><acronym>SANE</acronym></application>-backends package
205contains
206<command>gamma4scanimage</command>,
207<command>sane-config</command>,
208<command>saned</command>,
209<command>sane-find-scanner</command>,
210<command>scanimage</command>,
211the <filename class='libraryfile'>libsane</filename> library and
212numerous scanner backend modules. See
213<ulink url="http://www.sane-project.org/sane-supported-devices.html"/>
214for a list of supported backends.</para>
215</sect3>
216
217<sect3><title>Front ends:</title>
218<para>The <application><acronym>SANE</acronym></application>-frontends package
219contains
220<command>scanadf</command>,
221<command>xcam</command>,
222<command>xscanimage</command> and a <application>GIMP</application> plugin
223imbedded in <command>xscanimage</command>.</para>
224</sect3>
225
226</sect2>
227
228<sect2>
229<title>Description</title>
230
231<sect3><title>gamma4scanimage</title>
232<para><command>gamma4scanimage</command> creates a gamma table in the format
233expected by <command>scanimage</command>.</para></sect3>
234
235<sect3><title>sane-config</title>
236<para><command>sane-config</command> is a tool used to determine the compiler
237and linker flags that should be used to compile and link
238<application><acronym>SANE</acronym></application>.</para></sect3>
239
240<sect3><title>saned</title>
241<para><command>saned</command> is the
242<application><acronym>SANE</acronym></application> daemon that allows remote
243clients to access image acquisition devices available on the local
244host.</para></sect3>
245
246<sect3><title>sane-find-scanner</title>
247<para><command>sane-find-scanner</command> is a command-line tool to find
248<acronym>SCSI</acronym> and <acronym>USB</acronym> scanners and determine
249their device files. Its primary aim is to make sure that scanners can be
250detected by <application><acronym>SANE</acronym></application>
251backends.</para></sect3>
252
253<sect3><title>scanadf</title>
254<para><command>scanadf</command> is a command-line interface to control image
255acquisition devices which are equipped with an automatic document feeder
256(<acronym>ADF</acronym>).</para></sect3>
257
258<sect3><title>scanimage</title>
259<para><command>scanimage</command> is a command line interface for scanning
260from image acquisition devices such as flatbed scanners or cameras. It is
261also used to list the available backend devices.</para></sect3>
262
263<sect3><title>xcam</title>
264<para><command>xcam</command> is a graphical camera front end for
265<application><acronym>SANE</acronym></application>.</para></sect3>
266
267<sect3><title>xscanimage</title>
268<para><command>xscanimage</command> is a graphical user interface for
269scanning.</para></sect3>
270
271</sect2>
272
273</sect1>
Note: See TracBrowser for help on using the repository browser.