diff --git a/ChangeLog b/ChangeLog index ebce3c976..828a77849 100644 --- a/ChangeLog +++ b/ChangeLog @@ -5,6 +5,8 @@ 2004-10-16 Henning Meier-Geinitz * frontend/saned.c: Fixed NULL string crash. + * REAME.linux: Added some more details about hotplug and Gentoo + problems. 2004-10-17 Ullrich Sigwanz diff --git a/README.linux b/README.linux index 42423fb9c..0ae9d8a60 100644 --- a/README.linux +++ b/README.linux @@ -6,20 +6,31 @@ access USB scanners. In Linux 2.6.4 the kernel scanner module was removed. Therefore with this and later kernels libusb must be used. While SANE automatically uses libusb when the library and its header file were -present during the build of sane-backends, setting permissions will require -some attention. +present during the build of sane-backends, setting permissions will require some +attention. So if scanimage -L lists your scanner as root but not as normal user +read on this text. The device files used by libusb are located in /proc/bus/usb/ (e.g. /proc/bus/usb/001/003). The exact file name can be found out by running sane-find-scanner which would print "libusb:001:003" in this case. While -setting permissions with e.g. "chmod a+rw /proc/bus/usb/001/003" seems to work, +setting permissions with e.g. "chmod a+rw /proc/bus/usb/001/003" works, this change is not permanent. The permissions will be reset when the scanner is replugged or Linux is rebooted. One solution to set permissions on-the-fly are the Linux hot-plug tools that -should come with any current distribution. SANE itsself comes with a hotplug -script and related documentaion in the tools/hotplug/ directory. Please refer to -the README in that directory for the details. +should come with any current distribution. Your distribution should have set up +the scripts to automatically change permissions correctly. Look for +"libsane.usermap" and "libusbscanner" in /etc/hotplug/usb. Usually you must just +add the users that are allowed to access the scanner to group "scanner". To make +that change active, the user must login again. For more details, see your +distribution's documentation e.g. for Debian: README.debian.gz. + +If you build SANE from source you can use the hotplug script that comes with +SANE. See the tools/hotplug/ directory in the source distribution. Please refer +to the README in that directory for the details. + +Gentoo users: If your USB scanner is not detected at all check that USE=usb is +set when emerging. Information about SCSI scanners: