xref: /freebsd/usr.sbin/autofs/automount.8 (revision 7ef62cebc2f965b0f640263e179276928885e33d)
1.\" Copyright (c) 2014 The FreeBSD Foundation
2.\"
3.\" This software was developed by Edward Tomasz Napierala under sponsorship
4.\" from the FreeBSD Foundation.
5.\"
6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions
8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright
10.\"    notice, this list of conditions and the following disclaimer.
11.\" 2. Redistributions in binary form must reproduce the above copyright
12.\"    notice, this list of conditions and the following disclaimer in the
13.\"    documentation and/or other materials provided with the distribution.
14.\"
15.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS AND CONTRIBUTORS ``AS IS'' AND
16.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
17.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
18.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE LIABLE
19.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
20.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
21.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
22.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
23.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
24.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
25.\" SUCH DAMAGE.
26.\"
27.\" $FreeBSD$
28.\"
29.Dd November 22, 2014
30.Dt AUTOMOUNT 8
31.Os
32.Sh NAME
33.Nm automount
34.Nd update autofs mounts
35.Sh SYNOPSIS
36.Nm
37.Op Fl D Ar name=value
38.Op Fl L
39.Op Fl c
40.Op Fl f
41.Op Fl o Ar options
42.Op Fl v
43.Op Fl u
44.Sh DESCRIPTION
45When called without options, the
46.Nm
47command parses the
48.Xr auto_master 5
49configuration file and any direct maps that it references, and mounts
50or unmounts
51.Xr autofs 5
52filesystems to match.
53These options are available:
54.Bl -tag -width ".Fl v"
55.It Fl D
56Define a variable.
57It is only useful with
58.Fl L .
59.It Fl L
60Do not mount or unmount anything.
61Instead parse
62.Xr auto_master 5
63and any direct maps, then print them to standard output.
64When specified more than once, all the maps, including indirect ones,
65will be parsed and shown.
66This is useful when debugging configuration problems.
67.It Fl c
68Flush caches, discarding possibly stale information obtained from maps
69and directory services.
70.It Fl f
71Force unmount, to be used with
72.Fl u .
73.It Fl o
74Specify mount options to be used along with the ones specified in the maps.
75It is only useful with
76.Fl L .
77.It Fl u
78Try to unmount filesystems mounted by
79.Xr automountd 8 .
80.Xr autofs 5
81mounts are not unmounted.
82To unmount all
83.Xr autofs
84mounts, use
85.Cm "umount -At autofs".
86.It Fl v
87Increase verbosity.
88.El
89.Sh EXIT STATUS
90.Ex -std
91.Sh EXAMPLES
92Unmount all filesystems mounted by
93.Xr automountd 8 :
94.Dl Nm Fl u
95.Sh SEE ALSO
96.Xr auto_master 5 ,
97.Xr autofs 5 ,
98.Xr automountd 8 ,
99.Xr autounmountd 8
100.Sh HISTORY
101The
102.Nm
103command appeared in
104.Fx 10.1 .
105.Sh AUTHORS
106The
107.Nm
108was developed by
109.An Edward Tomasz Napierala Aq Mt trasz@FreeBSD.org
110under sponsorship from the FreeBSD Foundation.
111