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