sbin/umount/umount.8

   1 .\" Copyright (c) 1980, 1989, 1991, 1993
   2 .\"     The Regents of the University of California.  All rights reserved.
   3 .\"
   4 .\" Redistribution and use in source and binary forms, with or without
   5 .\" modification, are permitted provided that the following conditions
   6 .\" are met:
   7 .\" 1. Redistributions of source code must retain the above copyright
   8 .\"    notice, this list of conditions and the following disclaimer.
   9 .\" 2. Redistributions in binary form must reproduce the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer in the
  11 .\"    documentation and/or other materials provided with the distribution.
  12 .\" 3. Neither the name of the University nor the names of its contributors
  13 .\"    may be used to endorse or promote products derived from this software
  14 .\"    without specific prior written permission.
  15 .\"
  16 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  17 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  18 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  19 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  20 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  21 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  22 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  23 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  24 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  25 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  26 .\" SUCH DAMAGE.
  27 .\"
  28 .\"     @(#)umount.8    8.2 (Berkeley) 5/8/95
  29 .\" $FreeBSD: src/sbin/umount/umount.8,v 1.7.2.3 2001/12/14 15:17:57 ru Exp $
  30 .\"
  31 .Dd September 29, 2016
  32 .Dt UMOUNT 8
  33 .Os
  34 .Sh NAME
  35 .Nm umount
  36 .Nd unmount filesystems
  37 .Sh SYNOPSIS
  38 .Nm
  39 .Op Fl fv
  40 .Ar special \&| node
  41 .Nm
  42 .Fl a | A
  43 .Op Fl F Ar fstab
  44 .Op Fl fv
  45 .Op Fl h Ar host
  46 .Op Fl t Ar type
  47 .Sh DESCRIPTION
  48 The
  49 .Nm
  50 command
  51 calls the
  52 .Xr unmount 2
  53 system call to remove a
  54 .Ar "special device"
  55 or the remote node (rhost:path) from the filesystem tree at the point
  56 .Ar node .
  57 If either
  58 .Ar special
  59 or
  60 .Ar node
  61 are not provided, the appropriate information is taken from the
  62 .Xr fstab 5
  63 file.
  64 .Pp
  65 The options are as follows:
  66 .Bl -tag -width indent
  67 .It Fl a
  68 All the filesystems described in
  69 .Xr fstab 5
  70 are unmounted.
  71 .It Fl A
  72 All the currently mounted filesystems except
  73 the root are unmounted.
  74 .It Fl F Ar fstab
  75 Specify the
  76 .Pa fstab
  77 file to use.
  78 .It Fl f
  79 The filesystem is forcibly unmounted.
  80 Active special devices continue to work,
  81 but all other files return errors if further accesses are attempted.
  82 The root filesystem cannot be forcibly unmounted.
  83 .It Fl h Ar host
  84 Only filesystems mounted from the specified host will be
  85 unmounted.
  86 This option implies the
  87 .Fl A
  88 option and, unless otherwise specified with the
  89 .Fl t
  90 option, will only unmount
  91 .Tn NFS
  92 filesystems.
  93 .It Fl t Ar type
  94 Is used to indicate the actions should only be taken on
  95 filesystems of the specified type.
  96 More than one type may be specified in a comma separated list.
  97 The list of filesystem types can be prefixed with
  98 .Dq no
  99 to specify the filesystem types for which action should
 100 .Em not
 101 be taken.
 102 For example, the
 103 .Nm
 104 command:
 105 .Bd -literal -offset indent
 106 umount -a -t nfs,mfs
 107 .Ed
 108 .Pp
 109 unmounts all filesystems of the type
 110 .Tn NFS
 111 and
 112 .Tn MFS
 113 that are listed in the
 114 .Xr fstab 5
 115 file.
 116 .It Fl v
 117 Verbose, additional information is printed out as each filesystem
 118 is unmounted.
 119 .El
 120 .Sh ENVIRONMENT
 121 .Bl -tag -width PATH_FSTAB
 122 .It Pa PATH_FSTAB
 123 If the environment variable
 124 .Pa PATH_FSTAB
 125 is set all operations are performed against the specified file.
 126 .El
 127 .Sh FILES
 128 .Bl -tag -width /etc/fstab -compact
 129 .It Pa /etc/fstab
 130 filesystem table
 131 .El
 132 .Sh SEE ALSO
 133 .Xr unmount 2 ,
 134 .Xr fstab 5 ,
 135 .Xr mount 8
 136 .Sh HISTORY
 137 A
 138 .Nm
 139 command appeared in
 140 .At v1 .