Add more details about enabling a custom ruleset for /dev in `rc.conf',

and add ruleset labels/numbering to the custom ruleset example.

PR:		docs/90362
Submitted by:	Roland Smith <rsmith@xs4all.nl>
MFC after:	3 days
This commit is contained in:
Giorgos Keramidas 2006-01-30 13:28:28 +00:00
parent 2bf3c1f587
commit 2882d87e08

@ -24,7 +24,7 @@
.\"
.\" $FreeBSD$
.\"
.Dd May 17, 2005
.Dd Jan 30, 2006
.Dt DEVFS.RULES 5
.Os
.Sh NAME
@ -60,6 +60,27 @@ by the startup scripts of the system.
It is important to put path elements that contain
.Xr glob 3
special characters between quotes.
.Pp
Rulesets should have a unique name and number.
.Pp
All rules that follow a ruleset declaration belong to that ruleset, until a
new ruleset is started.
.Pp
One custom ruleset has to be enabled in
.Pa /etc/rc.conf ,
otherwise it won't be applied to the
.Pa /dev
file system by the default system startup process.
For example, to enable a
.Dq Li localrules
ruleset for the
.Pa /dev
file system, you would have to use something like this in your
.Pa rc.conf
file:
.Bd -literal -offset indent
devfs_system_ruleset="localrules"
.Ed
.Sh FILES
.Bl -tag -compact
.It Pa /etc/devfs.rules
@ -72,8 +93,13 @@ devices readable and writable by their owner and the
.Dq Li usb
group, the following rule may be used:
.Pp
.Dl "[localrules=10]"
.Dl "add path 'da*s*' mode 0660 group usb"
.Pp
The first line declares and starts a new ruleset, with the name
.Va localrules
and the number 10.
.Pp
To make all the
.Xr uscanner 4
devices accessible to their owner and the