From 5c2ba56b563ab64a650d0db48e8044cfe173f63f Mon Sep 17 00:00:00 2001
From: Sascha Wildner <saw@online.de>
Date: Sun, 16 Aug 2009 14:58:15 +0200
Subject: [PATCH] mount_devfs.8: Update for new options. Add some EXAMPLES.

Submitted-by: alexh
---
 sbin/mount_devfs/mount_devfs.8 | 63 ++++++++++++++++++++++++++++++++++++------
 1 file changed, 54 insertions(+), 9 deletions(-)

diff --git a/sbin/mount_devfs/mount_devfs.8 b/sbin/mount_devfs/mount_devfs.8
index b58adf6f8d..d5cf2a581c 100644
--- a/sbin/mount_devfs/mount_devfs.8
+++ b/sbin/mount_devfs/mount_devfs.8
@@ -29,16 +29,16 @@
 .\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd August 14, 2009
+.Dd August 17, 2009
 .Dt MOUNT_DEVFS 8
 .Os
 .Sh NAME
 .Nm mount_devfs
-.Nd mount device file system
+.Nd mount a device file system
 .Sh SYNOPSIS
 .Nm
 .Op Fl o Ar options
-.Ar mount_point
+.Ar node
 .Sh DESCRIPTION
 The
 .Nm
@@ -52,17 +52,62 @@ at boot time.
 The options are as follows:
 .Bl -tag -width indent
 .It Fl o
-Options are specified with a
-.Fl o
-flag followed by a comma separated string of options.
-See the
-.Xr mount 8
-man page for possible options and their meanings.
+Specify mount options, which are a comma delimited set of options (see
+.Xr mount 8 ) .
+Supported mount options are:
+.Bl -tag -width indent
+.It Ar jail
+Mount
+.Xr devfs 5
+for a jail.
+Only rules between
+.Ic jail Ar yes
+and
+.Ic jail Ar no
+are applied.
+.It Ar ruleset=rule_file
+When mounting, apply the rules from the specified
+.Ar rule_file ,
+which can be either an absolute path or one relative to
+.Pa /etc/devfs/ .
+.El
 .El
+.Pp
+Mounting an already mounted
+.Ar node
+clears and resets all rules that are in effect for it and (if a
+.Ar ruleset
+option is present) applies the rules from
+.Ar rule_file .
+It is equal to
+.Nm devfsctl Fl cr
+followed by an optional
+.Nm devfsctl Fl af .
+.Sh EXAMPLES
+Mount a
+.Xr devfs 5 ,
+marked as
+.Ar jail ,
+with a ruleset file named
+.Pa default.rules
+onto
+.Pa /var/jail/dev .
+.Bd -literal -offset indent
+mount_devfs -o jail,ruleset=default.rules /var/jail/dev
+.Ed
+.Pp
+A corresponding
+.Xr fstab 5
+entry is:
+.Bd -literal -offset indent
+devfs /var/jail/dev devfs jail,ruleset=default.rules
+.Ed
 .Sh SEE ALSO
 .Xr mount 2 ,
 .Xr unmount 2 ,
 .Xr devfs 5 ,
+.Xr fstab 5 ,
+.Xr devfsctl 8 ,
 .Xr mount 8
 .Sh HISTORY
 The
-- 
2.11.4.GIT