2007-04-5 Jochen Eisinger <jochen@penguin-breeder.org>

* README.openbsd, tools/README, tools/openbsd/attach,
	  tools/openbsd/detach: add notes about device permissions on
	  OpenBSD and provide some example scripts for hotplugd(8).

ChangeLog

@@ -1,3 +1,9 @@
+2007-04-5  Jochen Eisinger <jochen@penguin-breeder.org>
+
+	* README.openbsd, tools/README, tools/openbsd/attach,
+	  tools/openbsd/detach: add notes about device permissions on
+	  OpenBSD and provide some example scripts for hotplugd(8).
+
 2007-03-02  m. allan noah <kitno455 a t gmail d o t com>
 
 	* doc/sane.tex: update to 1.05, fix description of SANE_Parameters,

README.openbsd

@@ -10,6 +10,8 @@ If some libraries and headers (like libjpeg) are installed in /usr/local/, addin
 "-I/usr/local/include/ -L/usr/local/lib/" to the CPPFLAGS environment variable
 before running configure may be necessary to get them detected.
 
+Since release 3.9, SANE is available from OpenBSD ports.
+
 SCSI-scanners:
 --------------
 SANE only supports the generic /dev/uk? devices. /dev/ss? won't work. If your
@@ -41,6 +43,11 @@ no pipe". Make sure, that /dev/ugen* and /dev/usb* devices are available. Use
 For some backends you must use libusb. The uscanner driver won't work because
 automatic detection, control messages, or interrupt endpoints are needed.
 
+When using libusb, you need read/write permissions to ugen(4) (/dev/ugen*.*) and
+the usb(4) controller (/dev/usb*) your scanner is connected to.  Consider adding
+a group usb and setting the device permissions using the hotplugd(8) attach
+and detach scripts.  See tools/openbsd for an example.
+
 Parport-scanners:
 -----------------
 I don't have any information about these. Please contact me or the SANE mailing

tools/README

@@ -21,6 +21,10 @@ This directory contains various tools that may be useful:
 	hotplug and provides all the functionalities of hotplug. libusb 0.1.12
 	or newer is necessary.
 
+ openbsd/:
+ 	Contains example scripts for hotplugd(8) for USB scanners accessed via
+	libusb.
+
  sane-find-scanner:
         Attempts to find a SCSI scanner attached to your system.
         Invoke with "sane-find-scanner -h" to get command-line

tools/openbsd/attach

@@ -0,0 +1,20 @@
+#!/bin/sh
+
+DEVCLASS=$1
+DEVNAME=$2
+
+case $DEVCLASS in
+0)
+	# generic devices
+	case "$DEVNAME" in
+	ugen*)
+		BUSNAME=`usbdevs -v -d | egrep "Controller|$DEVNAME\$" | grep -B 1 ugen0$ | head -n 1 | sed -e 's,Controller ,,' -e 's,:$,,' `
+		echo $BUSNAME >  /var/run/${DEVNAME}.bus
+		# probably our scanner
+		chgrp usb /dev/"$DEVNAME".*
+		chgrp usb /dev/"$BUSNAME"
+		;;
+	esac
+
+        ;;
+esac

tools/openbsd/detach

@@ -0,0 +1,22 @@
+#!/bin/sh
+
+DEVCLASS=$1
+DEVNAME=$2
+
+case $DEVCLASS in
+0)
+	# generic devices
+	case "$DEVNAME" in
+	ugen*)
+		BUSNAME=`cat /var/run/${DEVNAME}.bus`
+		rm -f /var/run/${DEVNAME}.bus
+		# probably our scanner
+		chgrp wheel /dev/"$DEVNAME".*
+		if [ x$BUSNAME != x ] ; then
+			chgrp wheel /dev/"$BUSNAME"
+		fi
+		;;
+	esac
+
+        ;;
+esac