xref: /freebsd/sbin/umount/umount.8 (revision b52b9d56d4e96089873a75f9e29062eec19fabba)
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 May 8, 1995
36.Dt UMOUNT 8
37.Os
38.Sh NAME
39.Nm umount
40.Nd unmount filesystems
41.Sh SYNOPSIS
42.Nm
43.Op Fl fv
44.Ar special \&| node
45.Nm
46.Fl a | A
47.Op Fl fv
48.Op Fl h Ar host
49.Op Fl t Ar type
50.Sh DESCRIPTION
51The
52.Nm
53utility calls 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 implies the
85.Fl A
86option and, unless otherwise specified with the
87.Fl t
88option, will only unmount
89.Tn NFS
90filesystems.
91.It Fl t Ar type
92Is used to indicate the actions should only be taken on
93filesystems of the specified type.
94More than one type may be specified in a comma separated list.
95The list of filesystem types can be prefixed with
96.Dq no
97to specify the filesystem types for which action should
98.Em not
99be taken.
100For example, the
101.Nm
102command:
103.Bd -literal -offset indent
104umount -a -t nfs,nullfs
105.Ed
106.Pp
107unmounts all filesystems of the type
108.Tn NFS
109and
110.Tn NULLFS
111that are listed in the
112.Xr fstab 5
113file.
114.It Fl v
115Verbose, additional information is printed out as each filesystem
116is unmounted.
117.El
118.Sh FILES
119.Bl -tag -width /etc/fstab -compact
120.It Pa /etc/fstab
121filesystem table
122.El
123.Sh SEE ALSO
124.Xr unmount 2 ,
125.Xr fstab 5 ,
126.Xr mount 8
127.Sh HISTORY
128A
129.Nm
130utility appeared in
131.At v6 .
132