xref: /dragonfly/sbin/mount_std/mount_std.8 (revision 799ba435)
1.\"
2.\" Copyright (c) 1992, 1993, 1994
3.\"	The Regents of the University of California.  All rights reserved.
4.\" All rights reserved.
5.\"
6.\" This code is derived from software donated to Berkeley by
7.\" Jan-Simon Pendry.
8.\"
9.\" Redistribution and use in source and binary forms, with or without
10.\" modification, are permitted provided that the following conditions
11.\" are met:
12.\" 1. Redistributions of source code must retain the above copyright
13.\"    notice, this list of conditions and the following disclaimer.
14.\" 2. Redistributions in binary form must reproduce the above copyright
15.\"    notice, this list of conditions and the following disclaimer in the
16.\"    documentation and/or other materials provided with the distribution.
17.\" 3. Neither the name of the University nor the names of its contributors
18.\"    may be used to endorse or promote products derived from this software
19.\"    without specific prior written permission.
20.\"
21.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
22.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
24.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
25.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
26.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
27.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
28.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
29.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
30.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
31.\" SUCH DAMAGE.
32.\"
33.\" $FreeBSD: src/sbin/mount_std/mount_std.8,v 1.9.2.7 2003/02/10 12:21:07 des Exp $
34.\"
35.Dd July 5, 2012
36.Dt MOUNT_STD 8
37.Os
38.Sh NAME
39.Nm mount_std ,
40.Nm mount_procfs
41.Nd mount
42.Dq standard
43filesystems
44.Sh SYNOPSIS
45.Nm mount_ Ns Ar fsname
46.Op Fl o Ar options
47.Ar "fs"
48.Ar mount_point
49.Sh DESCRIPTION
50The
51.Nm
52command is a generic mechanism for attaching ``standard'' filesystems to
53the filesystem.  The
54.Nm
55command currently supports the
56.Nm procfs
57filesystem.
58A ``standard'' filesystem is one which:
59.Bl -enum -offset indent
60.It
61accepts only the standard
62.Fl o
63options
64.Dq ro
65.Pq Dq rdonly ,
66.Dq rw ,
67.Dq nodev ,
68.Dq noexec ,
69and
70.Dq nosuid .
71.It
72has a kernel filesystem module name the same as its user-visible name.
73.It
74requires no other special processing on the part of the
75.Nm
76command.
77.El
78.Pp
79The options are as follows:
80.Bl -tag -width indent
81.It Fl o
82Options are specified with a
83.Fl o
84flag followed by a comma separated string of options.
85See the
86.Xr mount 8
87man page for possible options and their meanings.
88.El
89.Pp
90The
91.Nm
92command examines its zeroth command-line argument (the name by which
93it was called) to determine the type of filesystem to be mounted.  If
94it is called by a name which does not end in
95.Dq Li _ Ns Ar fsname ,
96.Nm
97will assume (for compatibility
98with
99.Xr mount 8 )
100that the zeroth argument contains only the name of the filesystem type.
101The
102.Nm
103command is normally installed with appropriate links to commands for
104the distributed filesystems which can be mounted in this way;
105for information on the function of each filesystem, see the manual page
106for that specific
107.Nm mount_ Ns Ar fsname
108command.
109.Pp
110Refer to the
111.Xr procfs 5
112manual page for detailed information on this file system.
113.Sh DIAGNOSTICS
114.Bl -diag
115.It argv[0] must end in _fsname
116.Nm Mount_std
117was called with a zeroth argument of
118.Dq Li mount_std .
119.It vfsload(%s)
120.Nm Mount_std
121was unable to load a kernel module implementing the %s filesystem
122type.
123.It %s filesystem not available
124The specified filesystem type was not present in the kernel and no
125loadable module for it was found.
126.El
127.Sh SEE ALSO
128.Xr mount 2 ,
129.Xr unmount 2 ,
130.Xr getvfsbyname 3 ,
131.Xr fstab 5 ,
132.Xr procfs 5 ,
133.Xr mount 8
134.Sh HISTORY
135The
136.Nm
137utility first appeared in
138.Fx 2.2 .
139Loadable filesystem modules first appeared in
140.Fx 2.0 .
141The
142.Dq procfs
143filesystem type first appeared in
144.Fx 2.0 .
145.Sh CAVEATS
146None of the ``standard'' filesystems may be NFS-exported.
147