svn commit: r54106 - head/en_US.ISO8859-1/books/handbook/multimedia
Marc Fonvieille
blackend at FreeBSD.org
Thu May 7 14:23:11 UTC 2020
Author: blackend
Date: Thu May 7 14:23:11 2020
New Revision: 54106
URL: https://svnweb.freebsd.org/changeset/doc/54106
Log:
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 at FreeBSD.org>
Modified:
head/en_US.ISO8859-1/books/handbook/multimedia/chapter.xml
Modified: head/en_US.ISO8859-1/books/handbook/multimedia/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/handbook/multimedia/chapter.xml Wed May 6 20:36:21 2020 (r54105)
+++ head/en_US.ISO8859-1/books/handbook/multimedia/chapter.xml Thu May 7 14:23:11 2020 (r54106)
@@ -1461,7 +1461,8 @@ bktr0: Pinnacle/Miro TV, Philips SECAM tuner.</program
<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/pa
<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).
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 Epso
<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>
@@ -1667,6 +1662,27 @@ device 'epson2:libusb:/dev/usb:/dev/ugen0.2' is a Epso
<programlisting>[system=5]
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>
More information about the svn-doc-all
mailing list