openbsd-ports/graphics/sane-backends/pkg
2010-12-24 10:40:04 +00:00
..
DESCR
PFRAG.shared Remove the microtek2 backend which needs a Linux kernel module. 2010-11-25 13:55:57 +00:00
PLIST Remove the microtek2 backend which needs a Linux kernel module. 2010-11-25 13:55:57 +00:00
README Extend README. 2010-12-20 11:40:39 +00:00
saned.rc Cope with recent rc.subr changes. 2010-12-24 10:40:04 +00:00

$OpenBSD: README,v 1.3 2010/12/20 11:40:39 ajacoutot Exp $

Using sane(7) under OpenBSD
===========================

First read ${TRUEPREFIX}/share/doc/sane-backends/PROBLEMS.

USB
---
Since USB scanning will be handled by libusb, you need to allow the
_cups user rw access to the corresponding USB endpoint. To do so, find
where your scanner is attached to using dmesg(8) then change the
ownerships accordingly.
ugenX = /dev/ugenX
uhubX = /dev/usbX

e.g.
$ dmesg | grep ugen
ugen0 at uhub1 port 1 "EPSON USB MFP" rev 1.10/1.00 addr 2
$ sudo chgrp _saned /dev/ugen0.* /dev/usb1

The reason we are changing the group and not the user is that it will
allow for multi-function devices to work for both printing and scanning
(e.g. by being owned by _cups:_saned).

To preserve your changes after a system update, use rc.local(8).
e.g. for a multi-function printer/scanner add the following lines:
chown _cups:_saned /dev/ugen0.* /dev/usb1

You can then grant users direct access to the scanner by adding them to
the _saned group.

SCSI
----
SANE only supports the generic SCSI uk(4) devices.
Make sure your user has read/write access to the scanner device or you
will not be able to scan.

LOCKING
-------
Some backends (like sane-plustek(5)) use a lockfile for allowing
multiple access to one scanner. If using such a backend, you must
add yourself to the _saned group or you will not be able to scan.

NETWORK
-------
The saned(8) daemon needs rw access to your device, make sure the _saned
group as rw permissions.
If you're planning on using the SANE network daemon (saned) with
inetd(8) as opposed to starting it standalone from the provided rc
script, add the following line in /etc/services:
sane-port	6566/tcp	saned	# SANE network scanner daemon