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. All advertising materials mentioning features or use of this software 13.\" must display the following acknowledgement: 14.\" This product includes software developed by the University of 15.\" California, Berkeley and its contributors. 16.\" 4. Neither the name of the University nor the names of its contributors 17.\" may be used to endorse or promote products derived from this software 18.\" without specific prior written permission. 19.\" 20.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 21.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 22.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 23.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 24.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 30.\" SUCH DAMAGE. 31.\" 32.\" @(#)umount.8 8.2 (Berkeley) 5/8/95 33.\" 34.Dd May 8, 1995 35.Dt UMOUNT 8 36.Os BSD 4 37.Sh NAME 38.Nm umount 39.Nd unmount filesystems 40.Sh SYNOPSIS 41.Nm umount 42.Op Fl fv 43.Ar special | node 44.Nm umount 45.Fl a | A 46.Op Fl fv 47.Op Fl h Ar host 48.Op Fl t Ar type 49.Sh DESCRIPTION 50The 51.Nm umount 52command 53calls the 54.Xr unmount 2 55system call to remove a 56.Ar "special device" 57or the remote node (rhost:path) from the filesystem tree at the point 58.Ar node . 59If either 60.Ar special 61or 62.Ar node 63are not provided, the appropriate information is taken from the 64.Xr fstab 5 65file. 66.Pp 67The options are as follows: 68.Bl -tag -width indent 69.It Fl a 70All the filesystems described in 71.Xr fstab 5 72are unmounted. 73.It Fl A 74All the currently mounted filesystems except 75the root are unmounted. 76.It Fl f 77The filesystem is forcibly unmounted. 78Active special devices continue to work, 79but all other files return errors if further accesses are attempted. 80The root filesystem cannot be forcibly unmounted. 81.It Fl h Ar host 82Only filesystems mounted from the specified host will be 83unmounted. 84This option is implies the 85.Fl A 86option and, unless otherwise specified with the 87.Fl t 88option, will only unmount NFS filesystems. 89.It Fl t Ar type 90Is used to indicate the actions should only be taken on 91filesystems of the specified type. 92More than one type may be specified in a comma separated list. 93The list of filesystem types can be prefixed with 94.Dq no 95to specify the filesystem types for which action should 96.Em not 97be taken. 98For example, the 99.Nm umount 100command: 101.Bd -literal -offset indent 102umount -a -t nfs,mfs 103.Ed 104.Pp 105umounts all filesystems of the type 106.Tn NFS 107and 108.Tn MFS . 109.It Fl v 110Verbose, additional information is printed out as each filesystem 111is unmounted. 112.El 113.Sh FILES 114.Bl -tag -width /etc/fstab -compact 115.It Pa /etc/fstab 116filesystem table 117.El 118.Sh SEE ALSO 119.Xr unmount 2 , 120.Xr fstab 5 , 121.Xr mount 8 122.Sh BUGS 123When using union filesystems, 124.Xr umount 8 125cannot always determine the node which is the mountpoint. 126In this case, 127it is necessary to specify the relevant directory to be unmounted 128in the same form as that displayed by 129.Xr mount 8 . 130For example, given a mount entry like this: 131.Bd -literal -offset indent 132<above>/tmpdir on /cdrom (local, user mount) 133.Ed 134.Pp 135then the command: 136.Bd -literal -offset indent 137umount '<above>/tmpdir' 138.Ed 139.Pp 140would unmount 141.Ar /tmpdir 142from the mountpoint 143.Ar /cdrom . 144.Sh HISTORY 145A 146.Nm umount 147command appeared in 148.At v6 . 149