mount_devfs.8: Update for new options. Add some EXAMPLES.
authorSascha Wildner <saw@online.de>
Sun, 16 Aug 2009 12:58:15 +0000 (14:58 +0200)
committerSascha Wildner <saw@online.de>
Tue, 18 Aug 2009 08:58:36 +0000 (10:58 +0200)
Submitted-by: alexh
sbin/mount_devfs/mount_devfs.8

index b58adf6..d5cf2a5 100644 (file)
 .\" 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 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