xref: /freebsd/sbin/umount/umount.8 (revision afe61c15161c324a7af299a9b8457aba5afc92db)
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.1 (Berkeley) 2/20/94
33.\"
34.Dd February 20, 1994
35.Dt UMOUNT 8
36.Os BSD 4
37.Sh NAME
38.Nm umount
39.Nd unmount file systems
40.Sh SYNOPSIS
41.Nm umount
42.Op Fl fv
43.Ar special | node
44.Nm umount
45.Fl a
46.Op Fl fv
47.Op Fl h Ar host
48.Op Fl t Ar ufs | lfs | external_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 file system 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 of the file systems described in
71.Xr fstab 5
72are unmounted.
73.It Fl f
74The file system is forcibly unmounted.
75Active special devices continue to work,
76but all other files return errors if further accesses are attempted.
77The root file system cannot be forcibly unmounted.
78.It Fl h Ar host
79Only filesystems mounted from the specified host will be
80unmounted.
81This option is implies the
82.Fl a
83option and, unless otherwise specified with the
84.Fl t
85option, will only unmount NFS filesystems.
86.It Fl t Ar "ufs \\*(Ba lfs \\*(Ba external type"
87Is used to indicate the actions should only be taken on
88filesystems of the specified type.
89More than one type may be specified in a comma separated list.
90The list of filesystem types can be prefixed with
91.Dq no
92to specify the filesystem types for which action should
93.Em not
94be taken.
95For example, the
96.Nm umount
97command:
98.Bd -literal -offset indent
99umount -a -t nfs,mfs
100.Ed
101.Pp
102umounts all filesystems of the type
103.Tn NFS
104and
105.Tn MFS .
106.It Fl v
107Verbose, additional information is printed out as each file system
108is unmounted.
109.El
110.Sh FILES
111.Bl -tag -width /etc/fstab -compact
112.It Pa /etc/fstab
113file system table
114.El
115.Sh SEE ALSO
116.Xr unmount 2 ,
117.Xr fstab 5 ,
118.Xr mount 8
119.Sh HISTORY
120A
121.Nm umount
122command appeared in
123.At v6 .
124