xref: /freebsd/sbin/umount/umount.8 (revision c4f6a2a9e1b1879b618c436ab4f56ff75c73a0f5)
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 file systems
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 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 the file systems described in
71.Xr fstab 5
72are unmounted.
73.It Fl A
74All the currently mounted file systems except
75the root are unmounted.
76.It Fl f
77The file system is forcibly unmounted.
78Active special devices continue to work,
79but all other files return errors if further accesses are attempted.
80The root file system cannot be forcibly unmounted.
81.It Fl h Ar host
82Only file systems 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
90file systems.
91.It Fl t Ar type
92Is used to indicate the actions should only be taken on
93file systems of the specified type.
94More than one type may be specified in a comma separated list.
95The list of file system types can be prefixed with
96.Dq no
97to specify the file system 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 file systems 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 file system
116is unmounted.
117.El
118.Sh FILES
119.Bl -tag -width /etc/fstab -compact
120.It Pa /etc/fstab
121file system 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