xref: /dflybsd-src/sbin/mount_devfs/mount_devfs.8 (revision debec64ea5cd4b48576c12b9f1a09eede6076505)
145e80934SMatthew Dillon.\"
2e30ec731SSascha Wildner.\" Copyright (c) 2009
3e30ec731SSascha Wildner.\"	The DragonFly Project.  All rights reserved.
445e80934SMatthew Dillon.\"
545e80934SMatthew Dillon.\" Redistribution and use in source and binary forms, with or without
645e80934SMatthew Dillon.\" modification, are permitted provided that the following conditions
745e80934SMatthew Dillon.\" are met:
8e30ec731SSascha Wildner.\"
945e80934SMatthew Dillon.\" 1. Redistributions of source code must retain the above copyright
1045e80934SMatthew Dillon.\"    notice, this list of conditions and the following disclaimer.
1145e80934SMatthew Dillon.\" 2. Redistributions in binary form must reproduce the above copyright
12e30ec731SSascha Wildner.\"    notice, this list of conditions and the following disclaimer in
13e30ec731SSascha Wildner.\"    the documentation and/or other materials provided with the
14e30ec731SSascha Wildner.\"    distribution.
15e30ec731SSascha Wildner.\" 3. Neither the name of The DragonFly Project nor the names of its
16e30ec731SSascha Wildner.\"    contributors may be used to endorse or promote products derived
17e30ec731SSascha Wildner.\"    from this software without specific, prior written permission.
1845e80934SMatthew Dillon.\"
19e30ec731SSascha Wildner.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
20e30ec731SSascha Wildner.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
21e30ec731SSascha Wildner.\" LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
22e30ec731SSascha Wildner.\" FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE
23e30ec731SSascha Wildner.\" COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
24e30ec731SSascha Wildner.\" INCIDENTAL, SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING,
25e30ec731SSascha Wildner.\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
26e30ec731SSascha Wildner.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
27e30ec731SSascha Wildner.\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
28e30ec731SSascha Wildner.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
29e30ec731SSascha Wildner.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
3045e80934SMatthew Dillon.\" SUCH DAMAGE.
3145e80934SMatthew Dillon.\"
32*debec64eSAntonio Huete Jimenez.Dd December 4, 2019
33e30ec731SSascha Wildner.Dt MOUNT_DEVFS 8
3445e80934SMatthew Dillon.Os
3545e80934SMatthew Dillon.Sh NAME
36e30ec731SSascha Wildner.Nm mount_devfs
375c2ba56bSSascha Wildner.Nd mount a device file system
3845e80934SMatthew Dillon.Sh SYNOPSIS
3945e80934SMatthew Dillon.Nm
4045e80934SMatthew Dillon.Op Fl o Ar options
415c2ba56bSSascha Wildner.Ar node
4245e80934SMatthew Dillon.Sh DESCRIPTION
4345e80934SMatthew DillonThe
4445e80934SMatthew Dillon.Nm
45e30ec731SSascha Wildnercommand attaches an instance of the device file system (or
46e30ec731SSascha Wildner.Xr devfs 5 )
4745e80934SMatthew Dillonto the global file system namespace.
48e30ec731SSascha WildnerThis command is automatically executed for
49e30ec731SSascha Wildner.Pa /dev
5045e80934SMatthew Dillonat boot time.
5145e80934SMatthew Dillon.Pp
5245e80934SMatthew DillonThe options are as follows:
5345e80934SMatthew Dillon.Bl -tag -width indent
5445e80934SMatthew Dillon.It Fl o
555c2ba56bSSascha WildnerSpecify mount options, which are a comma delimited set of options (see
565c2ba56bSSascha Wildner.Xr mount 8 ) .
575c2ba56bSSascha WildnerSupported mount options are:
585c2ba56bSSascha Wildner.Bl -tag -width indent
595c2ba56bSSascha Wildner.It Ar jail
605c2ba56bSSascha WildnerMount
615c2ba56bSSascha Wildner.Xr devfs 5
625c2ba56bSSascha Wildnerfor a jail.
635c2ba56bSSascha WildnerOnly rules between
645c2ba56bSSascha Wildner.Ic jail Ar yes
655c2ba56bSSascha Wildnerand
665c2ba56bSSascha Wildner.Ic jail Ar no
675c2ba56bSSascha Wildnerare applied.
685c2ba56bSSascha Wildner.It Ar ruleset=rule_file
695c2ba56bSSascha WildnerWhen mounting, apply the rules from the specified
705c2ba56bSSascha Wildner.Ar rule_file ,
715c2ba56bSSascha Wildnerwhich can be either an absolute path or one relative to
725c2ba56bSSascha Wildner.Pa /etc/devfs/ .
7345e80934SMatthew Dillon.El
745c2ba56bSSascha Wildner.El
755c2ba56bSSascha Wildner.Pp
765c2ba56bSSascha WildnerMounting an already mounted
775c2ba56bSSascha Wildner.Ar node
785c2ba56bSSascha Wildnerclears and resets all rules that are in effect for it and (if a
795c2ba56bSSascha Wildner.Ar ruleset
805c2ba56bSSascha Wildneroption is present) applies the rules from
815c2ba56bSSascha Wildner.Ar rule_file .
825c2ba56bSSascha WildnerIt is equal to
835c2ba56bSSascha Wildner.Nm devfsctl Fl cr
845c2ba56bSSascha Wildnerfollowed by an optional
855c2ba56bSSascha Wildner.Nm devfsctl Fl af .
865c2ba56bSSascha Wildner.Sh EXAMPLES
875c2ba56bSSascha WildnerMount a
885c2ba56bSSascha Wildner.Xr devfs 5 ,
895c2ba56bSSascha Wildnermarked as
905c2ba56bSSascha Wildner.Ar jail ,
915c2ba56bSSascha Wildnerwith a ruleset file named
925c2ba56bSSascha Wildner.Pa default.rules
935c2ba56bSSascha Wildneronto
945c2ba56bSSascha Wildner.Pa /var/jail/dev .
955c2ba56bSSascha Wildner.Bd -literal -offset indent
965c2ba56bSSascha Wildnermount_devfs -o jail,ruleset=default.rules /var/jail/dev
975c2ba56bSSascha Wildner.Ed
985c2ba56bSSascha Wildner.Pp
995c2ba56bSSascha WildnerA corresponding
1005c2ba56bSSascha Wildner.Xr fstab 5
1015c2ba56bSSascha Wildnerentry is:
1025c2ba56bSSascha Wildner.Bd -literal -offset indent
103*debec64eSAntonio Huete Jimenezdevfs /var/jail/dev devfs ro,jail,ruleset=default.rules
1045c2ba56bSSascha Wildner.Ed
10545e80934SMatthew Dillon.Sh SEE ALSO
10645e80934SMatthew Dillon.Xr mount 2 ,
10745e80934SMatthew Dillon.Xr unmount 2 ,
108e30ec731SSascha Wildner.Xr devfs 5 ,
1095c2ba56bSSascha Wildner.Xr fstab 5 ,
1105c2ba56bSSascha Wildner.Xr devfsctl 8 ,
11145e80934SMatthew Dillon.Xr mount 8
11245e80934SMatthew Dillon.Sh HISTORY
11345e80934SMatthew DillonThe
11445e80934SMatthew Dillon.Nm
11545e80934SMatthew Dillonutility first appeared in
116e30ec731SSascha Wildner.Dx 2.3 .
117