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