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