Date: Thu, 7 May 2020 14:23:11 +0000 (UTC) From: Marc Fonvieille <blackend@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r54106 - head/en_US.ISO8859-1/books/handbook/multimedia Message-ID: <202005071423.047ENBLY039598@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
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@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>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?202005071423.047ENBLY039598>