d/freebsd-dev
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
d7bc12b096
freebsd-dev/sbin/devd/devd.conf.5

130 lines
4.6 KiB
Groff
Raw Normal View History

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
2002-10-20 22:15:17 +00:00
.\"
.\" 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.
.\"
mdoc(7) police: Revision.
2003-03-03 11:51:30 +00:00
.\" $FreeBSD$
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
2002-10-20 22:15:17 +00:00
.\"
.\" 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.
mdoc(7) police: Revision.
2003-03-03 11:51:30 +00:00
.\"
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
2002-10-20 22:15:17 +00:00
.Dd October 17, 2002
.Dt DEVD.CONF 5
.Os
.Sh NAME
.Nm devd.conf
.Nd configuration file for
devd not devdd submitted by: joe
2003-01-06 08:03:00 +00:00
.Xr devd 8
mdoc(7) police: Revision.
2003-03-03 11:51:30 +00:00
.Sh DESCRIPTION
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
2002-10-20 22:15:17 +00:00
.Ss General Syntax
A
english(4) police.
2002-12-27 12:15:40 +00:00
.Xr devd 8
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
2002-10-20 22:15:17 +00:00
configuration consists of two general features, statements
and comments.
All statements end with a semicolon.
mdoc(7) police: Revision.
2003-03-03 11:51:30 +00:00
Many statements can contain substatements, which are also
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
2002-10-20 22:15:17 +00:00
terminated with a semicolon.
.Pp
The following statements are supported:
mdoc(7) police: Revision.
2003-03-03 11:51:30 +00:00
.Bl -tag -width ".Ic options"
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
2002-10-20 22:15:17 +00:00
.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
mdoc(7) police: Revision.
2003-03-03 11:51:30 +00:00
a newly detached device matches said criteria.
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
2002-10-20 22:15:17 +00:00
.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
mdoc(7) police: Revision.
2003-03-03 11:51:30 +00:00
Statements may occur in any order in the configuration file, and may be
repeated as often as required.
Further details on the syntax and meaning of each statement and their
substatements are explained below.
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
2002-10-20 22:15:17 +00:00
.Pp
MFp4 (imp_freebsd branch): snapshot of devd work: o improve parsing and lexing o create data structures based on the parsed file now. o Still need to rewrite main loop and add regex (still uses hard coded devd-generic) o minor man page updates. # There should be one more commit before rc2 Approved by: re (blanket)
2002-12-07 08:04:36 +00:00
Comments may appear anywhere that whitespace may appear in a
mdoc(7) police: Revision.
2003-03-03 11:51:30 +00:00
configuration file.
To appeal to programmers of all kinds, they can
be written in C, C++, or shell/Perl constructs.
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
2002-10-20 22:15:17 +00:00
.Pp
C-style comments start with the two characters
mdoc(7) police: Revision.
2003-03-03 11:51:30 +00:00
.Ql /*
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
2002-10-20 22:15:17 +00:00
(slash, star) and end with
mdoc(7) police: Revision.
2003-03-03 11:51:30 +00:00
.Ql */
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
2002-10-20 22:15:17 +00:00
(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
mdoc(7) police: Revision.
2003-03-03 11:51:30 +00:00
C-style comments cannot be nested.
For example, the following is
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
2002-10-20 22:15:17 +00:00
not valid because the entire comment ends with the first
mdoc(7) police: Revision.
2003-03-03 11:51:30 +00:00
.Ql */ :
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
2002-10-20 22:15:17 +00:00
.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
mdoc(7) police: Revision.
2003-03-03 11:51:30 +00:00
.Ql //
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
2002-10-20 22:15:17 +00:00
(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
mdoc(7) police: Revision.
2003-03-03 11:51:30 +00:00
.Ql //
pair.
For example:
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
2002-10-20 22:15:17 +00:00
.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
.Sh FILES
mdoc(7) police: Revision.
2003-03-03 11:51:30 +00:00
.Bl -tag -width ".Pa /etc/devd.conf" -compact
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
2002-10-20 22:15:17 +00:00
.It Pa /etc/devd.conf
The
Fixup FILES section to use proper width and to use a cross-reference to devd(8).
2002-11-18 21:07:48 +00:00
.Xr devd 8
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
2002-10-20 22:15:17 +00:00
configuration file.
.El
.Sh SEE ALSO
.Xr devd 8
Reference in New Issue Copy Permalink