summaryrefslogtreecommitdiff
path: root/tools/hotplug/README
diff options
context:
space:
mode:
Diffstat (limited to 'tools/hotplug/README')
-rw-r--r--tools/hotplug/README35
1 files changed, 35 insertions, 0 deletions
diff --git a/tools/hotplug/README b/tools/hotplug/README
new file mode 100644
index 0000000..1170639
--- /dev/null
+++ b/tools/hotplug/README
@@ -0,0 +1,35 @@
+README for the USB hotplug scripts for sane-backends :
+------------------------------------------------------
+
+If you intend to use a USB scanner with libusb and older versions of Linux, you
+should install the hotplug package, and then take the following steps. For
+current Linux kernels, "udev" is state of the art, see the "udev" directory
+instead.
+
+ o Copy the libsane.usermap and libusbscanner files from this directory to
+ /etc/hotplug/usb/
+ o If you use Linux 2.6.3 or older, add scanner to /etc/hotplug/blacklist so
+ that the scanner.o kernel driver won't be loaded by hotplug. With later
+ kernel versions there is no scanner module and therefore it's not necessary
+ to use the blacklist.
+ o Check if /etc/hotplug/usb/libsane.usermap already knows about your scanner.
+ If your scanner is not in this list,add a line similar to the other ones
+ using the vendor ID and the product ID of your scanner. Please contact the
+ sane-devel mailing list in this case so the ids of your scanner can be added.
+ o Make sure that the "scanner" group exists on your system and that every user
+ who should be allowed to acces the scanner is a member of that group.
+ Alternatively, you can enable access for every user of your system in
+ libusbscanner.
+
+The vendor ID and product ID of your scanner can be obtained by running
+sane-find-scanner (you might need to run it as root).
+
+Please note that the scanner.o (or scanner.ko in Linux 2.6) kernel module is
+now deprecated and marked as obsolete in Linux 2.6. It is recommended to switch
+to libusb.
+
+If the hotplug support doesn't work for you once you have taken the steps
+described above, check that your kernel has been built with hotplug support.
+Otherwise, you'll need to rebuild your kernel.
+
+ -- Julien BLACHE <jb@jblache.org>, Sat, 28 Feb 2004 10:01:02 +0000