xref: /netbsd-src/usr.sbin/autofs/automountd.8 (revision 3117ece4fc4a4ca4489ba793710b60b0d26bab6c)
1.\" $NetBSD: automountd.8,v 1.5 2019/11/25 16:57:09 tkusumi Exp $
2.\"
3.\" Copyright (c) 2017 The NetBSD Foundation, Inc.
4.\" Copyright (c) 2016 The DragonFly Project
5.\" Copyright (c) 2014 The FreeBSD Foundation
6.\" All rights reserved.
7.\"
8.\" This code is derived from software contributed to The NetBSD Foundation
9.\" by Tomohiro Kusumi.
10.\"
11.\" This software was developed by Edward Tomasz Napierala under sponsorship
12.\" from the FreeBSD Foundation.
13.\"
14.\" Redistribution and use in source and binary forms, with or without
15.\" modification, are permitted provided that the following conditions
16.\" are met:
17.\" 1. Redistributions of source code must retain the above copyright
18.\"    notice, this list of conditions and the following disclaimer.
19.\" 2. Redistributions in binary form must reproduce the above copyright
20.\"    notice, this list of conditions and the following disclaimer in the
21.\"    documentation and/or other materials provided with the distribution.
22.\"
23.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS AND CONTRIBUTORS ``AS IS'' AND
24.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
25.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
26.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE LIABLE
27.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
28.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
29.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
30.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
31.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
32.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
33.\" SUCH DAMAGE.
34.\"
35.\" $FreeBSD$
36.\"
37.Dd November 26, 2019
38.Dt AUTOMOUNTD 8
39.Os
40.Sh NAME
41.Nm automountd
42.Nd daemon handling autofs mount requests
43.Sh SYNOPSIS
44.Nm
45.Op Fl div
46.Op Fl D Ar name=value
47.Op Fl m Ar maxproc
48.Op Fl o Ar options
49.Sh DESCRIPTION
50The
51.Nm
52daemon is responsible for handling
53.Xr autofs 5
54mount requests, parsing maps,
55and mounting file systems they specify.
56On startup,
57.Nm
58forks into background and waits for kernel requests.
59When a request is received,
60.Nm
61forks a child process.
62The child process parses the appropriate map and mounts file systems accordingly.
63Then it signals the kernel to release blocked processes that were waiting
64for the mount.
65.Bl -tag -width ".Fl v"
66.It Fl D
67Define a variable.
68.It Fl d
69Debug mode: increase verbosity and do not daemonize.
70.It Fl i
71For indirect mounts, only create subdirectories if there are no wildcard
72entries.
73Without
74.Fl i ,
75.Nm
76creates all the subdirectories it can.
77Users may not realize that the wildcard map entry makes it possible to access
78directories that have not yet been created.
79.It Fl m Ar maxproc
80Limit the number of forked
81.Nm
82processes, and thus the number of mount requests being handled in parallel.
83The default is 30.
84.It Fl o Ar options
85Specify mount options.
86Options specified here will be overridden by options entered in maps or
87.Xr auto_master 5 .
88.It Fl T
89Increase verbosity.
90For compatibility with other implementations, such as OS X.
91.It Fl v
92Increase verbosity.
93.El
94.Sh EXIT STATUS
95.Ex -std
96.Sh SEE ALSO
97.Xr auto_master 5 ,
98.Xr autofs 5 ,
99.Xr automount 8 ,
100.Xr autounmountd 8
101.Sh HISTORY
102The
103.Nm
104daemon appeared in
105.Fx 10.1 .
106The
107.Nm
108daemon appeared in
109.Dx 4.5 .
110The
111.Nm
112command appeared in
113.Nx 9.0 .
114.Sh AUTHORS
115.An -nosplit
116The
117.Nm
118was developed by
119.An Edward Tomasz Napierala Aq Mt trasz@FreeBSD.org
120under sponsorship from the
121.Fx
122Foundation.
123.Pp
124.Nm
125was ported to
126.Dx
127and
128.Nx
129by
130.An Tomohiro Kusumi Aq Mt tkusumi@netbsd.org .
131