Remove a useless use of cat, strip overzealous punctuation, and

clarify some text.
This commit is contained in:
Dima Dorfman 2004-11-06 11:16:56 +00:00
parent 1cf7cec3a3
commit 111c3747b7
Notes: svn2git 2020-12-20 02:59:44 +00:00
svn path=/head/; revision=137304

View File

@ -117,7 +117,7 @@ to the mount-point.
Rules that are
.Dq applied
have their conditions checked against all nodes
in the mount-point, and the actions taken if they match.
in the mount-point and the actions taken if they match.
.It Cm rule applyset
Apply all the rules in the ruleset to the mount-point
(see above for the definition of
@ -143,7 +143,7 @@ as the current ruleset for the mount-point.
.El
.Ss Rule Specification
Rules have two parts: the conditions and the actions.
The conditions determine which DEVFS nodes the rule matches,
The conditions determine which DEVFS nodes the rule matches
and the actions determine what should be done when a rule matches a node.
For example, a rule can be written that sets the GID to
.Dq Li games
@ -162,8 +162,8 @@ Matches any node with a major number equal to
.Ar majdev .
.It Cm path Ar pattern
Matches any node with a path that matches
.Ar pattern .
The latter is interpreted as a
.Ar pattern ,
which is interpreted as a
.Xr glob 3 Ns -style
pattern.
.It Cm type Ar devtype
@ -189,7 +189,7 @@ or number.
.It Cm hide
Hide the node.
Nodes may later be revived manually with
.Xr mknod 8 ,
.Xr mknod 8
or with the
.Cm unhide
action.
@ -215,13 +215,13 @@ or number.
Unhide the node.
.El
.Sh IMPLEMENTATION NOTES
Rulesets are created by the kernel at the first reference,
Rulesets are created by the kernel at the first reference
and destroyed when the last reference disappears.
E.g., a ruleset is created when a rule is added to it or when it is set
as the current ruleset for a mount-point;
a ruleset is destroyed when the last rule in it is deleted,
as the current ruleset for a mount-point, and
a ruleset is destroyed when the last rule in it is deleted
and no other references to it exist
(i.e., it is not included by any rules, and it is not the current ruleset
(i.e., it is not included by any rules and it is not the current ruleset
for any mount-point).
.Pp
Ruleset number 0 is the default ruleset for all new mount-points.
@ -235,7 +235,7 @@ I.e., a
.Cm showsets
will return the same information regardless of the mount-point specified with
.Fl m .
The mount-point is only relevant when changing what its current ruleset is,
The mount-point is only relevant when changing what its current ruleset is
or when using one of the apply commands.
.Sh EXAMPLES
When the system boots,
@ -278,8 +278,8 @@ Apply all the rules in the current ruleset to all the existing nodes.
E.g., if the above rule was added after
.Pa /dev/speaker
was created,
this command will cause its file mode to be changed to 666,
as rule prescribes.
this command will cause its file mode to be changed to 666
as prescribed by the rule.
.Pp
.Dl devfs rule add path "snp*" mode 660 group snoopers
.Pp
@ -288,7 +288,7 @@ as rule prescribes.
is often necessary to disable the shell's globbing features.)
For all devices with a path that matches
.Dq Li snp* ,
set the file more to 660, and the GID to
set the file more to 660 and the GID to
.Dq Li snoopers .
This permits users in the
.Dq Li snoopers
@ -309,14 +309,14 @@ However, it can be applied explicitly, as such:
This will apply all rules in ruleset number 20 to the DEVFS mount on
.Pa /my/jail/dev .
It does not matter that ruleset 20 is not the current ruleset for that
mount-point; the rules are applied regardless.
mount-point; the rules are still applied.
.Pp
.Dl "devfs rule apply hide"
.Pp
Since this rule has no conditions, the action
.Pq Cm hide
will be applied to all nodes.
Since hiding all nodes is not very useful, we can undo like so:
Since hiding all nodes is not very useful, we can undo it:
.Pp
.Dl "devfs rule apply unhide"
.Pp
@ -325,7 +325,7 @@ which applies
to all the nodes,
causing them to reappear.
.Pp
.Dl "cat my_rules | devfs rule -s 10 add -"
.Dl "devfs rule -s 10 add - < my_rules"
.Pp
Add all the rules from the file
.Pa my_rules