From 825b39f9a024ed8da91ab364d7c541bac7e7e331 Mon Sep 17 00:00:00 2001 From: imp Date: Sun, 20 Oct 2002 22:15:17 +0000 Subject: devd. A daemon that hooks into the kernel's /dev/devctl to produce arbitrary commands when devices come and go in the device tree (which is different than the /dev directory). This is an initial version. Much of the planned power isn't here. Instead of doing the full matching, we always run /etc/devd-generic. /etc/devd.generic will go away at some point, I think. I'm committing it in this early state so I can start getting feedback from early adapters. Approved by: re --- sbin/devd/devd.conf.5 | 133 ++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 133 insertions(+) create mode 100644 sbin/devd/devd.conf.5 (limited to 'sbin/devd/devd.conf.5') diff --git a/sbin/devd/devd.conf.5 b/sbin/devd/devd.conf.5 new file mode 100644 index 0000000..10c0e5d --- /dev/null +++ b/sbin/devd/devd.conf.5 @@ -0,0 +1,133 @@ +.\" +.\" Copyright (c) 2002 M. Warner Losh +.\" 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. 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 AND CONTRIBUTORS ``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 OR CONTRIBUTORS 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$ +.\" +.\" The section on comments was taken from named.conf.5, which has the +.\" following copyright: +.\" Copyright (c) 1999-2000 by Internet Software Consortium +.\" +.\" Permission to use, copy, modify, and distribute this software for any +.\" purpose with or without fee is hereby granted, provided that the above +.\" copyright notice and this permission notice appear in all copies. +.\" +.\" THE SOFTWARE IS PROVIDED "AS IS" AND INTERNET SOFTWARE CONSORTIUM DISCLAIMS +.\" ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES +.\" OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL INTERNET SOFTWARE +.\" CONSORTIUM BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL +.\" DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR +.\" PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS +.\" ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS +.\" SOFTWARE. +.Dd October 17, 2002 +.Dt DEVD.CONF 5 +.Os +.Sh NAME +.Nm devd.conf +.Nd configuration file for +.Xr devdd 8 +.Sh OVERVIEW +.Ss General Syntax +A +.Xr devd 8 +configuration consists of two general features, statements +and comments. +All statements end with a semicolon. +Many statements can contain substatements, which are each also +terminated with a semicolon. +.Pp +The following statements are supported: +.Bl -tag -width 0n +.It Ic options +specifies various options and parameters for the operation of +.Xr devd 8 . +.It Ic attach +specifies various matching criteria and actions to perform when +a newly attached device matches said criteria. +.It Ic detach +specifies various matching criteria and actions to perform when +a newly attached device matches said criteria. +.It Ic nomatch +specifies various matching criteria and actions to perform when +no device driver currently loaded in the kernel claims a (new) +device. +.El +.Pp +Statements may occur in any order in the config file, and may be +repated as often as required. +Further details on the syntax and meaning of each statement, and their +substatements is explained below. +.Pp +Comments may appear anywhere that whitespace may appear in a BIND +configuration file. To appeal to programmers of all kinds, they can +be written in C, C++, or shell/perl constructs. +.Pp +C-style comments start with the two characters +.Li /* +(slash, star) and end with +.Li */ +(star, slash). +Because they are completely delimited with these characters, +they can be used to comment only a portion of a line or to span +multiple lines. +.Pp +C-style comments cannot be nested. For example, the following is +not valid because the entire comment ends with the first +.Li */ : +.Bd -literal -offset indent +/* This is the start of a comment. + This is still part of the comment. +/* This is an incorrect attempt at nesting a comment. */ + This is no longer in any comment. */ +.Ed +.Pp +C++-style comments start with the two characters +.Li // +(slash, slash) and continue to the end of the physical line. +They cannot be continued across multiple physical lines; to have +one logical comment span multiple lines, each line must use the +.Li // +pair. For example: +.Bd -literal -offset indent +// This is the start of a comment. The next line +// is a new comment, even though it is logically +// part of the previous comment. +.Ed +.Pp +.Em WARNING : +you cannot use the +.Li ; +(semicolon) character to start a comment such as you would in a zone +file. The semicolon indicates the end of a configuration statement, +so whatever follows it will be interpreted as the start of the next +statement. +.Sh FILES +.Bl -tag -width 0n -compact +.It Pa /etc/devd.conf +The +.Nm devd +configuration file. +.El +.Sh SEE ALSO +.Xr devd 8 -- cgit v1.1