6/sbin/mount_std/mount_std.8

   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 .\" 4. 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$
  34 .\"
  35 .Dd November 26, 2004
  36 .Dt MOUNT_STD 8
  37 .Os
  38 .Sh NAME
  39 .Nm mount_std ,
  40 .Nm mount_devfs ,
  41 .Nm mount_fdescfs ,
  42 .Nm mount_linprocfs ,
  43 .Nm mount_linsysfs ,
  44 .Nm mount_procfs
  45 .Nd mount
  46 .Dq standard
  47 file systems
  48 .Sh SYNOPSIS
  49 .Nm mount_ Ns Ar fsname
  50 .Op Fl o Ar options
  51 .Ar "fs"
  52 .Ar mount_point
  53 .Sh DESCRIPTION
  54 The
  55 .Nm
  56 utility is a generic mechanism for attaching ``standard'' file systems to
  57 the file system.
  58 The
  59 .Nm
  60 utility currently supports the following file systems:
  61 .Nm devfs ,
  62 .Nm fdescfs ,
  63 .Nm linprocfs ,
  64 .Nm linsysfs
  65 and
  66 .Nm procfs .
  67 A ``standard'' file system is one which:
  68 .Bl -enum -offset indent
  69 .It
  70 accepts only the standard
  71 .Fl o
  72 options
  73 .Dq ro ,
  74 .Dq rw ,
  75 .Dq noexec ,
  76 .Dq nosuid ,
  77 and
  78 .Dq union .
  79 .It
  80 has a kernel file system module name the same as its user-visible name.
  81 .It
  82 requires no other special processing on the part of the
  83 .Nm
  84 utility.
  85 .El
  86 .Pp
  87 The options are as follows:
  88 .Bl -tag -width indent
  89 .It Fl o
  90 Options are specified with a
  91 .Fl o
  92 flag followed by a comma separated string of options.
  93 See the
  94 .Xr mount 8
  95 man page for possible options and their meanings.
  96 .El
  97 .Pp
  98 The
  99 .Nm
 100 utility examines its zeroth command-line argument (the name by which
 101 it was called) to determine the type of file system to be mounted.
 102 If
 103 it is called by a name which does not end in
 104 .Dq Li _ Ns Ar fsname ,
 105 .Nm
 106 will assume (for compatibility
 107 with
 108 .Xr mount 8 )
 109 that the zeroth argument contains only the name of the file system type.
 110 The
 111 .Nm
 112 utility is normally installed with appropriate links to commands for
 113 the distributed file systems which can be mounted in this way;
 114 for information on the function of each file system, see the manual page
 115 for that specific
 116 .Nm mount_ Ns Ar fsname
 117 utility.
 118 .Pp
 119 Refer to the following manual pages for detailed information
 120 on these file system:
 121 .Xr devfs 5 ,
 122 .Xr fdescfs 5 ,
 123 .Xr linprocfs 5 ,
 124 .Xr linsysfs 5
 125 and
 126 .Xr procfs 5 .
 127 .Sh DIAGNOSTICS
 128 .Bl -diag
 129 .It argv[0] must end in _fsname
 130 The
 131 .Nm
 132 utility was called with a zeroth argument of
 133 .Dq Li mount_std .
 134 .It %s file system not available
 135 The specified file system type was not present in the kernel and no
 136 loadable module for it was found.
 137 .El
 138 .Sh SEE ALSO
 139 .Xr mount 2 ,
 140 .Xr unmount 2 ,
 141 .Xr getvfsbyname 3 ,
 142 .Xr devfs 5 ,
 143 .Xr fdescfs 5 ,
 144 .Xr fstab 5 ,
 145 .Xr linprocfs 5 ,
 146 .Xr linsysfs 5 ,
 147 .Xr procfs 5 ,
 148 .Xr mount 8
 149 .Sh CAVEATS
 150 None of the ``standard'' file systems may be NFS-exported.
 151 .Sh HISTORY
 152 The
 153 .Nm
 154 utility first appeared in
 155 .Fx 2.2 .
 156 Loadable file system modules first appeared in
 157 .Fx 2.0 .
 158 The
 159 .Dq fdescfs
 160 and
 161 .Dq procfs
 162 file system types first appeared in
 163 .Fx 2.0 ;
 164 the
 165 .Dq devfs
 166 file system type first appeared in
 167 .Fx 2.2 ;
 168 the
 169 .Dq linprocfs
 170 file system type first appeared in
 171 .Fx 4.0 .