From owner-freebsd-doc@FreeBSD.ORG Sun May 28 17:10:18 2006 Return-Path: X-Original-To: freebsd-doc@hub.freebsd.org Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 51B6E16B79C for ; Sun, 28 May 2006 17:10:18 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id CD7FC43D76 for ; Sun, 28 May 2006 17:10:09 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.13.4/8.13.4) with ESMTP id k4SHA8GD032311 for ; Sun, 28 May 2006 17:10:08 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.4/8.13.4/Submit) id k4SHA8Nb032308; Sun, 28 May 2006 17:10:08 GMT (envelope-from gnats) Resent-Date: Sun, 28 May 2006 17:10:08 GMT Resent-Message-Id: <200605281710.k4SHA8Nb032308@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Warren Block Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 8C78516AB3C for ; Sun, 28 May 2006 17:01:28 +0000 (UTC) (envelope-from wblock@wonkity.com) Received: from wonkity.com (wonkity.com [67.158.26.137]) by mx1.FreeBSD.org (Postfix) with ESMTP id 8938243D53 for ; Sun, 28 May 2006 17:01:24 +0000 (GMT) (envelope-from wblock@wonkity.com) Received: from speedy.wonkity.com (speedy [10.0.0.7]) by wonkity.com (8.13.4/8.13.3) with ESMTP id k4SH1IEV007369 for ; Sun, 28 May 2006 11:01:23 -0600 (MDT) (envelope-from wblock@speedy.wonkity.com) Received: from speedy.wonkity.com (localhost [127.0.0.1]) by speedy.wonkity.com (8.13.6/8.13.6) with ESMTP id k4SH1IqR069386 for ; Sun, 28 May 2006 11:01:18 -0600 (MDT) (envelope-from wblock@speedy.wonkity.com) Received: (from wblock@localhost) by speedy.wonkity.com (8.13.6/8.13.6/Submit) id k4SH1IlK069385; Sun, 28 May 2006 11:01:18 -0600 (MDT) (envelope-from wblock) Message-Id: <200605281701.k4SH1IlK069385@speedy.wonkity.com> Date: Sun, 28 May 2006 11:01:18 -0600 (MDT) From: Warren Block To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/98058: Edit of scanner portion of Handbook Multimedia chapter X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Warren Block List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 28 May 2006 17:10:20 -0000 >Number: 98058 >Category: docs >Synopsis: Edit of scanner portion of Handbook Multimedia chapter >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sun May 28 17:10:08 GMT 2006 >Closed-Date: >Last-Modified: >Originator: Warren Block >Release: FreeBSD 6.1-STABLE i386 >Organization: >Environment: System: FreeBSD speedy.wonkity.com 6.1-STABLE FreeBSD 6.1-STABLE #0: Tue May 23 09:28:34 MDT 2006 root@speedy.wonkity.com:/usr/obj/usr/src/sys/SPEEDY i386 >Description: Some spelling and clarity errors, repetitive or defensive wording in scanner section of Multimedia chapter of Handbook. >How-To-Repeat: Read scanner section of Multimedia chapter of Handbook. >Fix: --- chapter.sgml.old Sun May 28 09:44:53 2006 +++ chapter.sgml Sun May 28 10:50:07 2006 @@ -1549,13 +1549,13 @@ Introduction - &os;, like any modern operating system, allows the use of - image scanners. Standardized access to scanners is provided + In &os;, + access to image scanners is provided by the SANE (Scanner Access Now Easy) API available through the &os; Ports Collection. SANE will also use - some &os; devices drivers to access to the scanner + some &os; device drivers to access the scanner hardware. &os; supports both SCSI and USB scanners. Be sure your @@ -1581,8 +1581,8 @@ The GENERIC kernel by default includes the device drivers needed to support USB scanners. - Should you decide to use a custom kernel, be sure that the - following lines are present in your kernel configuration + If you use a custom kernel, these + lines should be present in your kernel configuration file: device usb @@ -1592,13 +1592,12 @@ Depending upon the USB chipset on your motherboard, you will only need either device uhci or - device ohci, however having both in the + device ohci, but having both in the kernel configuration file is harmless. - If you do not want to rebuild your kernel and your - kernel is not the GENERIC one, you can + If you do not want to rebuild your custom kernel, you can directly load the &man.uscanner.4; device driver module with - the &man.kldload.8; command: + &man.kldload.8;: &prompt.root; kldload uscanner @@ -1609,9 +1608,10 @@ uscanner_load="YES" After rebooting with the correct kernel, or after - loading the required module, plug in your USB scanner. The - scanner should appear in your system message buffer - (&man.dmesg.8;) as something like: + loading the required module, plug in your USB scanner. A + line showing the detection of your scanner should appear + in the system message buffer + (&man.dmesg.8;): uscanner0: EPSON EPSON Scanner, rev 1.10/3.02, addr 2 @@ -1645,8 +1645,8 @@ device scbus device pass - Once your kernel has been properly compiled, you should - be able to see the devices in your system message buffer, + After building and installing the custom kernel, + the devices should be shown in the system message buffer when booting: pass2 at aic0 bus 0 target 2 lun 0 @@ -1672,7 +1672,7 @@ <AGFA SNAPSCAN 600 1.10> at scbus1 target 2 lun 0 (pass3) <PHILIPS CDD3610 CD-R/RW 1.00> at scbus2 target 0 lun 0 (pass2,cd0) - More details about SCSI devices, are available in the + More details about SCSI devices are available in the &man.scsi.4; and &man.camcontrol.8; manual pages. @@ -1680,48 +1680,45 @@ SANE Configuration - The SANE system has been - splitted in two parts: the backends (The SANE system is + split into two parts: the backends (graphics/sane-backends) and the frontends (graphics/sane-frontends). The - backends part provides access to the scanner itself. The + role="package">graphics/sane-frontends). Backends + control the scanner, while frontends provide a user interface. + The SANE's supported devices list specifies which backend will support your - image scanner. It is mandatory to determine the correct - backend for your scanner if you want to be able to use your - device. The frontends part provides the graphical scanning - interface (xscanimage). + image scanner. - The first thing to do is install the The first step is to install the graphics/sane-backends port or - package. Then, use the sane-find-scanner - command to check the scanner detection by the + package. Then use sane-find-scanner + to check the scanner detection by the SANE system: &prompt.root; sane-find-scanner -q found SCSI scanner "AGFA SNAPSCAN 600 1.10" at /dev/pass3 - The output will show the interface type of the scanner and - the device node used to attach the scanner to the system. The - vendor and the product model may not appear, it is not - important. + The type of interface and + device node where the scanner is attached to the system are shown. The + scanner vendor and model may not appear. - Some USB scanners require you to load a firmware, this + Some USB scanners require an upload of firmware, which is explained in the backend manual page. You should also read &man.sane-find-scanner.1; and &man.sane.7; manual pages. Now we have to check if the scanner will be identified by - a scanning frontend. By default, the - SANE backends comes with a command - line tool called &man.scanimage.1;. This command allows you - to list the devices and to perform an image acquisition from + a scanning frontend. Included with the + SANE backends is + &man.scanimage.1;. This program allows you + to list the devices and scan images from the command line. The option is used to - list the scanner device: + list the scanner devices: &prompt.root; scanimage -L device `snapscan:/dev/pass3' is a AGFA SNAPSCAN 600 flatbed scanner @@ -1733,7 +1730,7 @@ used. The /usr/local/etc/sane.d/ directory contains all backends configuration files. This - identification problem does appear with certain USB + identification problem appears with certain USB scanners. For example, with the USB scanner used in the &prompt.root; sane-find-scanner -q found USB scanner (UNKNOWN vendor and product) at device /dev/uscanner0 - The scanner is correctly detected, it uses the USB - interface and is attached to the - /dev/uscanner0 device node. We can now + The scanner is detected, it uses the USB + interface and is attached to + /dev/uscanner0. We can now check if the scanner is correctly identified: &prompt.root; scanimage -L @@ -1756,41 +1753,37 @@ which came with this software (README, FAQ, manpages). Since the scanner is not identified, we will need to edit - the /usr/local/etc/sane.d/epson.conf - file. The scanner model used was the &epson.perfection; 1650, - so we know the scanner will use the epson - backend. Be sure to read the help comments in the backends - configuration files. Line changes are quite simple: comment + /usr/local/etc/sane.d/epson.conf. + The scanner used in this example was an &epson.perfection; 1650, + so we know it will use the epson + backend. Before making changes, read the comments in the backends + configuration files and manual pages. Comment out all lines that have the wrong interface for your scanner - (in our case, we will comment out all lines starting with the - word scsi as our scanner uses the USB - interface), then add at the end of the file a line specifying - the interface and the device node used. In this case, we add - the following line: + (for this USB scanner, we will comment out all lines starting with the + word scsi), + Then, at the end of the file, add a line specifying + the interface and the device node used. In this case, we add: usb /dev/uscanner0 - Please be sure to read the comments provided in the - backend configuration file as well as the backend manual page - for more details and correct syntax to use. We can now verify - if the scanner is identified: + We can now verify if the scanner is identified: &prompt.root; scanimage -L device `epson:/dev/uscanner0' is a Epson GT-8200 flatbed scanner Our USB scanner has been identified. It is not important - if the brand and the model do not match. The key item to be - concerned with is the - `epson:/dev/uscanner0' field, which give us + if the brand and the model do not match the scanner. The key item + is the + `epson:/dev/uscanner0' field, which shows the right backend name and the right device node. Once the scanimage -L command is able - to see the scanner, the configuration is complete. The device + to detect the scanner, configuration is complete. The device is now ready to scan. While &man.scanimage.1; does allow us to perform an - image acquisition from the command line, it is preferable to - use a graphical user interface to perform image scanning. + image acquisition from the command line, + graphical user interfaces are usually preferable for image scanning. SANE offers a simple but efficient graphical interface: xscanimage (Xsane (graphics/xsane) is another popular - graphical scanning frontend. This frontend offers advanced - features such as various scanning mode (photocopy, fax, etc.), - color correction, batch scans, etc. Both of these applications - are useable as a GIMP - plugin. + graphical scanning frontend which offers + various scanning modes (photocopy, fax) and other advanced features. + Both of these applications + are useable as GIMP + plugins. - Allowing Scanner Access to Other Users + Giving Other Users Access To The Scanner All previous operations have been done with - root privileges. You may however, need - other users to have access + root privileges. However, you may wish to give + ordinary users access to the scanner. The user will need read and write permissions to the device node used by the scanner. As an example, our USB scanner uses the device node @@ -1826,13 +1819,13 @@ also have to set the correct write permissions (0660 or 0664) on the /dev/uscanner0 device node, by default the operator group can only - read the device node. This is done by adding the following - lines to the /etc/devfs.rules file: + read the device node. This is done by adding these + lines to /etc/devfs.rules: [system=5] add path uscanner0 mode 660 - Then add the following to + Then add this line to /etc/rc.conf and reboot the machine: @@ -1845,7 +1838,7 @@ /dev/uscanner0. - Of course, for security reasons, you should think twice + For security reasons, you should think twice before adding a user to any group, especially the operator group. >Release-Note: >Audit-Trail: >Unformatted: