man/man2/mount.2

   1 .TH MOUNT 2
   2 .SH NAME
   3 mount, umount \- mount or umount a file system
   4 .SH SYNOPSIS
   5 .ft B
   6 .nf
   7 #include <sys/mount.h>
   8
   9 int mount(char *\fIspecial\fP, char *\fIname\fP, int \fImountflags\fP, char *\fItype\fP, char *\fIargs\fP)
  10 int umount(char *\fIname\fP)
  11 int umount2(char *\fIname\fP, int \fIflags)
  12 .fi
  13 .ft P
  14 .SH DESCRIPTION
  15 .B Mount()
  16 tells the system that the file system
  17 .I special
  18 is to be mounted on the file
  19 .IR name ,
  20 effectively overlaying
  21 .I name
  22 with the file tree on
  23 .IR special .
  24 .I Name
  25 may of any type, except that if the root of
  26 .I special
  27 is a directory, then
  28 .I name
  29 must also be a directory.
  30 .I Special
  31 must be a block special file, or a NULL pointer.
  32 If a NULL pointer is passed, the file system is
  33 mounted without a block device.
  34 .I Mountflags
  35 may be a bitwise combination of the following flags:
  36 .TP 2
  37 .B MS_RDONLY
  38 Mount file system read-only, rather than read-write.
  39 .TP
  40 .B MS_REUSE
  41 Reuse the file system server image if possible.
  42 .TP
  43 .B MS_EXISTING
  44 Do not start the file system server, but use existing one. The label of
  45 the running file server is specified in
  46 .I Type.
  47 .PP
  48 .I Type
  49 is the type of the file system (e.g. "mfs"), used to pick a file system server.
  50 If this parameter is NULL, the default type is used.
  51 .I Args
  52 is a string with arguments passed to the file system server.
  53 Their interpretation is up to the server.
  54 This parameter may be NULL as well.
  55 .PP
  56 .B Umount()
  57 removes the connection between a device and a mount point,
  58 .I name
  59 may refer to either of them.  If more than one device is mounted on the
  60 same mount point then unmounting at the mount point removes the last mounted
  61 device, unmounting a device removes precisely that device.  The unmount will
  62 only succeed if none of the files on the device are in use.
  63 .PP
  64 .B Umount2()
  65 Same as Umount(), but takes an additional
  66 .I flags
  67 parameter.
  68 .I Flags
  69 may be a bitwise combination of the following flags:
  70 .TP 2
  71 .B MS_EXISTING
  72 Umount the file system but do not terminate the the file system server.
  73 .PP
  74 .TO
  75 These calls may only be executed by the super-user.
  76 .SH "SEE ALSO"
  77 .BR mount (1),
  78 .BR umount (1).
  79 .SH AUTHOR
  80 Kees J. Bot (kjb@cs.vu.nl)