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.\" $FreeBSD$ 34.\" 35.Dd April 7, 2003 36.Dt UMOUNT 8 37.Os 38.Sh NAME 39.Nm umount 40.Nd unmount file systems 41.Sh SYNOPSIS 42.Nm 43.Op Fl fv 44.Ar special \&| node 45.Nm 46.Fl a | A 47.Op Fl F Ar fstab 48.Op Fl fv 49.Op Fl h Ar host 50.Op Fl t Ar type 51.Sh DESCRIPTION 52The 53.Nm 54utility calls the 55.Xr unmount 2 56system call to remove a 57.Ar "special device" 58or the remote node (rhost:path) from the file system tree at the point 59.Ar node . 60If either 61.Ar special 62or 63.Ar node 64are not provided, the appropriate information is taken from the 65.Xr fstab 5 66file. 67.Pp 68The options are as follows: 69.Bl -tag -width indent 70.It Fl a 71All the file systems described in 72.Xr fstab 5 73are unmounted. 74.It Fl A 75All the currently mounted file systems except 76the root are unmounted. 77.It Fl F Ar fstab 78Specify the 79.Pa fstab 80file to use. 81.It Fl f 82The file system is forcibly unmounted. 83Active special devices continue to work, 84but all other files return errors if further accesses are attempted. 85The root file system cannot be forcibly unmounted. 86.It Fl h Ar host 87Only file systems mounted from the specified host will be 88unmounted. 89This option implies the 90.Fl A 91option and, unless otherwise specified with the 92.Fl t 93option, will only unmount 94.Tn NFS 95file systems. 96.It Fl t Ar type 97Is used to indicate the actions should only be taken on 98file systems of the specified type. 99More than one type may be specified in a comma separated list. 100The list of file system types can be prefixed with 101.Dq no 102to specify the file system types for which action should 103.Em not 104be taken. 105For example, the 106.Nm 107command: 108.Bd -literal -offset indent 109umount -a -t nfs,nullfs 110.Ed 111.Pp 112unmounts all file systems of the type 113.Tn NFS 114and 115.Tn NULLFS 116that are listed in the 117.Xr fstab 5 118file. 119.It Fl v 120Verbose, additional information is printed out as each file system 121is unmounted. 122.El 123.Sh ENVIRONMENT 124.Bl -tag -width PATH_FSTAB 125.It Pa PATH_FSTAB 126If the environment variable 127.Pa PATH_FSTAB 128is set all operations are performed against the specified file. 129.Pa PATH_FSTAB 130will not be honored if the process environment or memory address space is 131considred 132.Dq tainted . 133(See 134.Fn issetugid 135for more information.) 136.El 137.Sh FILES 138.Bl -tag -width /etc/fstab -compact 139.It Pa /etc/fstab 140file system table 141.El 142.Sh SEE ALSO 143.Xr unmount 2 , 144.Xr fstab 5 , 145.Xr mount 8 146.Sh HISTORY 147A 148.Nm 149utility appeared in 150.At v6 . 151