Update Image Scanners section:

- remove mention to deprecated frontend;
- update kernel config settings;
- update devfs(8) part for device nodes permissions.
Example with devd(8) will be added soon.

PR:		244156
Submitted by:	Tobias Kortkamp <tobik@FreeBSD.org>
This commit is contained in:
Marc Fonvieille 2020-05-07 14:23:11 +00:00
parent e26d240c3c
commit a640b8413e
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=54106

View file

@ -1461,7 +1461,8 @@ bktr0: Pinnacle/Miro TV, Philips SECAM tuner.</programlisting>
<programlisting>device usb
device uhci
device ohci
device ehci</programlisting>
device ehci
device xhci</programlisting>
<para>To determine if the <acronym>USB</acronym> scanner is
detected, plug it in and use <command>dmesg</command> to
@ -1524,29 +1525,26 @@ Re-scan of bus 3 was successful</screen>
<sect2>
<title><application>SANE</application> Configuration</title>
<para>The <application>SANE</application> system is split in two
parts: the backends
(<package>graphics/sane-backends</package>) and the frontends
(<package>graphics/sane-frontends</package> or
<package>graphics/xsane</package>). The backends provide
access to the scanner. Refer to <link
<para>The <application>SANE</application> system provides the
access to the scanner via backends (<package>graphics/sane-backends</package>).
Refer to <link
xlink:href="http://www.sane-project.org/sane-supported-devices.html">http://www.sane-project.org/sane-supported-devices.html</link>
to determine which backend supports the scanner. The
frontends provide the graphical scanning interface.
<package>graphics/sane-frontends</package> installs
<application>xscanimage</application> while
<package>graphics/xsane</package> installs
<application>xsane</application>.</para>
to determine which backend supports the scanner. A
graphical scanning interface is provided by third party
applications like <application>Kooka</application>
(<package>graphics/kooka</package>) or
<application>XSane</application>
(<package>graphics/xsane</package>).
<application>SANE</application>'s backends are enough to test
the scanner.</para>
<para>To install the two parts from binary packages:</para>
<para>To install the backends from binary package:</para>
<screen>&prompt.root; <userinput>pkg install xsane sane-frontends</userinput></screen>
<screen>&prompt.root; <userinput>pkg install sane-backends</userinput></screen>
<para>Alternatively, to install from the Ports Collection</para>
<screen>&prompt.root; <userinput>cd /usr/ports/graphics/sane-frontends</userinput>
&prompt.root; <userinput>make install clean</userinput>
&prompt.root; <userinput>cd /usr/ports/graphics/xsane</userinput>
<screen>&prompt.root; <userinput>cd /usr/ports/graphics/sane-backends</userinput>
&prompt.root; <userinput>make install clean</userinput></screen>
<para>After installing the
@ -1579,12 +1577,13 @@ found SCSI scanner "AGFA SNAPSCAN 600 1.10" at /dev/pass3</screen>
<screen>&prompt.root; <userinput>scanimage -L</userinput>
device `snapscan:/dev/pass3' is a AGFA SNAPSCAN 600 flatbed scanner
&prompt.root; <userinput>scanimage -L</userinput>
device 'epson2:libusb:/dev/usb:/dev/ugen0.2' is a Epson GT-8200 flatbed scanner</screen>
device 'epson2:libusb:000:002' is a Epson GT-8200 flatbed scanner</screen>
<para>In this second example,
<literal>'epson2:libusb:/dev/usb:/dev/ugen0.2'</literal> is
the backend name (<literal>epson2</literal>) and
<literal>/dev/ugen0.2</literal> is the device node used by the
<literal>epson2</literal> is
the backend name and
<literal>libusb:000:002</literal> means
<filename>/dev/ugen0.2</filename> is the device node used by the
scanner.</para>
<para>If <command>scanimage</command> is unable to identify the
@ -1612,7 +1611,7 @@ which came with this software (README, FAQ, manpages).</screen>
with the right backend name and the device node:</para>
<screen>&prompt.root; <userinput>scanimage -L</userinput>
device 'epson2:libusb:/dev/usb:/dev/ugen0.2' is a Epson GT-8200 flatbed scanner</screen>
device 'epson2:libusb:000:002' is a Epson GT-8200 flatbed scanner</screen>
<para>Once <command>scanimage -L</command> sees the scanner, the
configuration is complete and the scanner is now ready to
@ -1621,16 +1620,12 @@ device 'epson2:libusb:/dev/usb:/dev/ugen0.2' is a Epson GT-8200 flatbed scanner<
<para>While <command>scanimage</command> can be used to perform
an image acquisition from the command line, it is often
preferable to use a graphical interface to perform image
scanning. The <package>graphics/sane-frontends</package>
package or port installs a simple but efficient graphical
interface, <application>xscanimage</application>.</para>
<para>Alternately, <application>xsane</application>, which is
installed with the <package>graphics/xsane</package> package
or port, is another popular graphical scanning frontend. It
offers advanced features such as various scanning modes, color
correction, and batch scans. Both of these applications are
usable as a <application>GIMP</application> plugin.</para>
scanning. Applications like <application>Kooka</application>
or <application>XSane</application> are popular scanning
frontends. They
offer advanced features such as various scanning modes, color
correction, and batch scans. <application>XSane</application>
is also usable as a <application>GIMP</application> plugin.</para>
</sect2>
<sect2>
@ -1668,6 +1663,27 @@ device 'epson2:libusb:/dev/usb:/dev/ugen0.2' is a Epson GT-8200 flatbed scanner<
add path ugen0.2 mode 0660 group usb
add path usb/0.2.0 mode 0666 group usb</programlisting>
<note>
<para>It happens the device node changes with the addition or
removal of devices, so one may want to give access to all
USB devices using this ruleset instead:</para>
<programlisting>[system=5]
add path 'ugen*' mode 0660 group usb
add path 'usb/*' mode 0666 group usb</programlisting>
</note>
<para>Refer to &man.devfs.rules.5; for more information about
this file.</para>
<para>Next, enable the ruleset in /etc/rc.conf:</para>
<programlisting>devfs_system_ruleset="system"</programlisting>
<para>And, restart the &man.devfs.8; system:</para>
<screen>&prompt.root; <userinput>service devfs restart</userinput></screen>
<para>Finally, add the users to <systemitem
class="groupname"><replaceable>usb</replaceable></systemitem>
in order to allow access to the scanner:</para>