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