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

1 files changed, 27 insertions, 1 deletions

diff --git a/share/man/man5/devfs.rules.5 b/share/man/man5/devfs.rules.5
index 075e71b..487039e 100644
--- a/share/man/man5/devfs.rules.5
+++ b/share/man/man5/devfs.rules.5
@@ -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