xref: /freebsd/usr.sbin/autofs/automount.8 (revision 51c8a9c1be57b6750e7c64e1379e8c33bd0f02c1)
1.\"-
2.\" SPDX-License-Identifier: BSD-2-Clause
3.\"
4.\" Copyright (c) 2014 The FreeBSD Foundation
5.\"
6.\" This software was developed by Edward Tomasz Napierala under sponsorship
7.\" from the FreeBSD Foundation.
8.\"
9.\" Redistribution and use in source and binary forms, with or without
10.\" modification, are permitted provided that the following conditions
11.\" are met:
12.\" 1. Redistributions of source code must retain the above copyright
13.\"    notice, this list of conditions and the following disclaimer.
14.\" 2. Redistributions in binary form must reproduce the above copyright
15.\"    notice, this list of conditions and the following disclaimer in the
16.\"    documentation and/or other materials provided with the distribution.
17.\"
18.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS AND CONTRIBUTORS ``AS IS'' AND
19.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE LIABLE
22.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
24.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
26.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
27.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28.\" SUCH DAMAGE.
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 4
53filesystems to match.
54These options are available:
55.Bl -tag -width "-D"
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 4
82mounts are not unmounted.
83To unmount all
84.Xr autofs 4
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 autofs 4 ,
98.Xr auto_master 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