aboutsummaryrefslogtreecommitdiff
path: root/en_US.ISO8859-1/books/handbook/multimedia/chapter.xml
diff options
context:
space:
mode:
authorMarc Fonvieille <blackend@FreeBSD.org>2020-05-07 14:23:11 +0000
committerMarc Fonvieille <blackend@FreeBSD.org>2020-05-07 14:23:11 +0000
commita640b8413e69f56cb00fe71bf35b13febdc101e6 (patch)
tree887c47e5bde9a562a2c151634a69142943642549 /en_US.ISO8859-1/books/handbook/multimedia/chapter.xml
parente26d240c3c4378988aeceff24de049d2bea30eda (diff)
downloaddoc-a640b8413e69f56cb00fe71bf35b13febdc101e6.tar.gz
doc-a640b8413e69f56cb00fe71bf35b13febdc101e6.zip
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>
Notes
Notes: svn path=/head/; revision=54106
Diffstat (limited to 'en_US.ISO8859-1/books/handbook/multimedia/chapter.xml')
-rw-r--r--en_US.ISO8859-1/books/handbook/multimedia/chapter.xml82
1 files changed, 49 insertions, 33 deletions
diff --git a/en_US.ISO8859-1/books/handbook/multimedia/chapter.xml b/en_US.ISO8859-1/books/handbook/multimedia/chapter.xml
index a62776be79..53dc3c06b2 100644
--- a/en_US.ISO8859-1/books/handbook/multimedia/chapter.xml
+++ b/en_US.ISO8859-1/books/handbook/multimedia/chapter.xml
@@ -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>