7183c3f848
/dev/usb. The actions are specified in the file /etc/usbd.conf. usbd.c: - Add event queue (/dev/usb) handling. - Add comments - Clean up code some more usbd.8: - Update manpage for the new command line flags - Remove a duplicate FreeBSD tag from it). usbd.conf, usbd.conf.5, Makefile: - Add the usbd.conf configuration file and the man page for it. NOTE: MAKEDEV already creates the /dev/usb device tree node, no change needed there anymore.
129 lines
4.1 KiB
Groff
129 lines
4.1 KiB
Groff
.\"
|
|
.\" Copyright (c) 1999 Nick Hibma. All rights reserved.
|
|
.\"
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
.\" modification, are permitted provided that the following conditions
|
|
.\" are met:
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
.\" 3. The name of the author may not be used to endorse or promote products
|
|
.\" derived from this software without specific prior written permission.
|
|
.\"
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
|
|
.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
|
.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
|
|
.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
|
|
.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
|
.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
|
.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
|
|
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
.\"
|
|
.\" $FreeBSD$
|
|
.\"
|
|
.\" Many parts of this manual have been snarfed from the pccard.conf (5) man
|
|
.\" page, copyright by Andrew McRae.
|
|
.\"
|
|
.Dd November 19, 1999
|
|
.Dt USBD.CONF 5
|
|
.Os FreeBSD
|
|
.Sh NAME
|
|
.Nm usbd.conf
|
|
.Nd
|
|
.Xr usbd 8
|
|
configuration file
|
|
.Sh DESCRIPTION
|
|
The
|
|
.Nm
|
|
file is the configuration file for the
|
|
.Xr usbd 8
|
|
daemon. It provides information to allow execution of userland commands
|
|
on events reported by the
|
|
.Xr usb 4
|
|
subsystem in the kernel. Currently the only events are device attach and
|
|
detach, but could in the future be extended to include power management
|
|
functions.
|
|
.Pp
|
|
The configuration file consists of a sorted list of entries. Each entry
|
|
describes a set of criteria commands. When an event occurs, the criteria
|
|
are checked and if met, the commands for that event are executed through
|
|
a shell. The list is sorted and scanned from top to bottom. The first
|
|
matching entry is used for an event.
|
|
.Pp
|
|
Each entry contains a number of fields. There are 3 types of fields:
|
|
descriptive fields, selection criteria and commands to execute on
|
|
events. The field name is case sensitive and should be all lower case.
|
|
Each field can have one or more arguments.
|
|
.Pp
|
|
The following fields are available:
|
|
.Bl -tag -width devicename\ <Id>
|
|
.It device Ar string
|
|
Start a new entry.
|
|
.Ar string
|
|
is an arbitrary string used for pretty printing.
|
|
.It product Ar id
|
|
Product Id
|
|
.It vendor Ar id
|
|
Vendor Id
|
|
.It release Ar id
|
|
Release Id, also called revision Id sometimes.
|
|
.It class Ar id
|
|
Device Class
|
|
.It subclass Ar id
|
|
Device Subclass
|
|
.It protocol Ar id
|
|
Device Protocol
|
|
.It devicenames Ar string
|
|
Device name, for example umass2, or ums0.
|
|
.El
|
|
.Pp
|
|
String arguments may be quoted. If a string argument contains a space or
|
|
tab character it needs to be enclosed in single or double quotes. If an
|
|
argument contains a single or double quote, that quote needs to be
|
|
enclosed in double or single quotes respectively. See below for
|
|
examples.
|
|
.Pp
|
|
Numeric arguments can either be specified in decimal (42), octal (052) or
|
|
hexadeximal (0x2a).
|
|
.Pp
|
|
The values for the fields
|
|
.Li product , vendor , release, class , subclass
|
|
and
|
|
.Li protocol
|
|
can be retrieved by killing the
|
|
.Nm usbd
|
|
daemon and running it with the
|
|
.Fl -d
|
|
and
|
|
.Fl -v
|
|
flags.
|
|
.Pp
|
|
.Sh EXAMPLES
|
|
A sample entry to rescan the SCSI bus on connection of a
|
|
.Tn "Iomega USB Zip Drive" .
|
|
.Bd -literal
|
|
device "USB Zip drive"
|
|
product 0x0001
|
|
vendor 0x059b
|
|
release 0x0100
|
|
attach "/usr/bin/camcontrol rescan bus 0"
|
|
.Ed
|
|
.Sh FILES
|
|
.Bl -tag -width /etc/pccard.conf -compact
|
|
.It Pa /etc/usbd.conf
|
|
The
|
|
.Nm usbd
|
|
configuration file.
|
|
.El
|
|
.Sh SEE ALSO
|
|
.Xr usb 4 ,
|
|
.Xr usbd 8 ,
|
|
.Xr usbdevs 8
|
|
.Sh AUTHORS
|
|
The man page for the usbd configuration file was written by
|
|
.An Nick Hibma Aq n_hibma@freebsd.org .
|