[blfs-book] r11002 - trunk/BOOK/pst/scanning

randy at higgs.linuxfromscratch.org randy at higgs.linuxfromscratch.org
Thu Feb 7 13:05:35 PST 2013

Author: randy
Date: Thu Feb  7 13:05:35 2013
New Revision: 11002

Minor modifications and added dependencies to the SANE instructions


Modified: trunk/BOOK/pst/scanning/sane.xml
--- trunk/BOOK/pst/scanning/sane.xml	Thu Feb  7 12:38:10 2013	(r11001)
+++ trunk/BOOK/pst/scanning/sane.xml	Thu Feb  7 13:05:35 2013	(r11002)
@@ -4,10 +4,11 @@
   <!ENTITY % general-entities SYSTEM "../../general.ent">
-  <!ENTITY sane-be-download-http "http://alioth.debian.org/frs/?group_id=30186">
-  <!ENTITY sane-be-download-ftp  "ftp://ftp2.sane-project.org/pub/sane/">
+  <!-- <!ENTITY sane-be-download-http "http://alioth.debian.org/frs/?group_id=30186"> -->
+  <!ENTITY sane-be-download-http " ">
+  <!ENTITY sane-be-download-ftp  "ftp://ftp2.sane-project.org/pub/sane/sane-backends-&sane-version;.tar.gz">
   <!--<!ENTITY sane-be-download-ftp  "&gentoo-ftp-repo;/sane-backends-&sane-version;.tar.gz">-->
-  <!ENTITY sane-be-md5sum        "e226a89c54173efea80e91e9a5eb6573">
+  <!ENTITY sane-be-md5sum        "979c9dbb23920d04e322be23122c7de7">
   <!ENTITY sane-be-size          "5.1 MB">
   <!ENTITY sane-be-buildsize     "120 MB">
   <!ENTITY sane-be-time          "1.2 SBU">
@@ -38,7 +39,7 @@
     <title>Introduction to SANE</title>
     <para><application>SANE</application> is short for Scanner Access Now Easy.
-    Scanner access, however, is far from easy, since every vendor has their own
+    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, <application>SANE</application> comes with
@@ -50,8 +51,14 @@
+    <!-- This note is not applicable. First, there is no issue downloading the
+         ftp://ftp2.sane-project.org/pub/sane/sane-backends-1.0.23.tar.gz
+         tarball with wget. Next, the combined tarball exists on the SANE FTP
+         site, but the MD5sum is wrong. We can simply point the download to
+         the SANE FTP site and create our own MD5sum (as we do on many packages).
     <note><para>The upstream web site uses a self signed security
-    certificate.  If using <command>wget</command>, the option --no-check-certificate
+    certificate.  If using <command>wget</command>, the option -no-check-certificate
     needs to be added.</para>
     <para>The md5sum of the backend file does not match unless the three parts
@@ -59,6 +66,7 @@
     sane-backends-1.0.23.tar.gz.[1-3], are combined.  A combined tarball with
     the correct md5sum is located at <ulink
+    -->
     <bridgehead renderas="sect3">Back Ends Package Information</bridgehead>
     <itemizedlist spacing='compact'>
@@ -117,11 +125,15 @@
     <bridgehead renderas="sect4">Optional (Back Ends)</bridgehead>
     <para role="optional">
+      <xref linkend="avahi"/>,
+      <xref linkend="cups"/>,
       <xref linkend="libjpeg"/>,
       <xref linkend="libtiff"/>,
-      <xref linkend="libusb-compat"/>,
+      <xref linkend="libusb"/>,
+      <ulink url="http://www.net-snmp.org/">Net-SNMP</ulink>,
       <ulink url="http://cyberelk.net/tim/libieee1284/">libieee1284</ulink>,
-      <ulink url="http://www.gphoto.org/">libgphoto2</ulink>, and
+      <ulink url="http://www.gphoto.org/">libgphoto2</ulink>,
+      <ulink url="http://linuxtv.org/downloads/v4l-utils/">Video4Linux</ulink>, and
       <xref linkend="texlive"/>
@@ -148,7 +160,7 @@
     drivers and/or additional support packages. A SCSI scanner will need SCSI
     drivers, a parallel port scanner needs parallel port support (you should
     use enhanced EPP modes) and perhaps <ulink
-    url="http://cyberelk.net/tim/libieee1284/">libieee1284</ulink> and a USB
+    url="http://cyberelk.net/tim/libieee1284/">libieee1284</ulink>, and a USB
     scanner will need the <xref linkend="libusb"/> package. Ensure you have
     the necessary drivers properly configured to access the devices.</para>
@@ -160,34 +172,60 @@
       <title>Installation of SANE Back Ends</title>
+      <note>
+        <para>
+          You may safely disregard any messages printed on the screen when you
+          unpack the tarball.
+        </para>
+      </note>
       <para>The <application>SANE</application> daemon should run with its own
       group.  Create this group by issuing the following commands as the
       <systemitem class="username">root</systemitem> user:</para>
 <screen><userinput>groupadd -g 70 scanner</userinput></screen>
-      <note><para>The user building <application>SANE</application>-backends
-      should be a member of the scanner group before proceeding.  The easiest
-      way to ensure the system knows you have been added to a new group is to
-      log out log in again.  You can check with the output of the
-      <userinput>groups</userinput> command.</para></note>
+      <note>
+        <para>
+          The user building <application>SANE</application>-backends should be
+          a member of the <systemitem class="groupname">scanner</systemitem>
+          group before proceeding. After you have added the user building the
+          package to the <systemitem class="groupname">scanner</systemitem>
+          group, issue the following command to create a new shell:
+        </para>
+<screen><userinput>su $(whoami)</userinput></screen>
+        <para>
+          Check the output of the <userinput>groups</userinput> command and
+          ensure the user is a member of the
+          <systemitem class="groupname">scanner</systemitem> group.
+        </para>
+      </note>
       <para>Install <application>SANE</application>-backends by
       running the following commands:</para>
-<screen><userinput>./configure --prefix=/usr        \
-            --sysconfdir=/etc    \
-            --with-group=scanner \
-            --localstatedir=/var \
-            --disable-latex &&
+            <!-- Not sure why this was there as it works if TeX is installed
+                 and it doesn't try to use it if TeX is not installed
+                 -disable-latex && -->
+<screen><userinput>./configure --prefix=/usr                                    \
+            --sysconfdir=/etc                                \
+            --localstatedir=/var                             \
+            --with-docdir=/usr/share/doc/sane-backend-1.0.23 \
+            --with-group=scanner                             &&
+make                                                         &&
-      <para>This package does not come with a test suite.</para>
+      <para>To test the results, issue: <command>make check</command>.</para>
       <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
-<screen role="root"><userinput>make install &&
-install -m 644 -v tools/udev/libsane.rules /etc/udev/rules.d/65-scanner.rules</userinput></screen>
+<screen role="root"><userinput>make install                                         &&
+install -m 644 -v tools/udev/libsane.rules           \
+                  /etc/udev/rules.d/65-scanner.rules &&
+chgrp -v scanner  /var/lock/sane</userinput></screen>
@@ -235,6 +273,13 @@
     configuration files in <filename class="directory">/etc/sane.d</filename>
     instead of <filename class="directory">/usr/etc/sane.d</filename>.</para>
+    <para><parameter>--with-group=scanner</parameter>: This parameter causes
+    the directory created for the locking files to be group owned by the
+    <systemitem class="groupname">scanner</systemitem> group instead of the
+    default <systemitem class="groupname">uucp</systemitem> group.</para>
+    <para><command>exit</command>: This command is used to exit the shell
+    created by the <command>su</command> command.</para>
   <sect2 role="configuration">

More information about the blfs-book mailing list