xref: /freebsd/usr.sbin/autofs/automountd.8 (revision 1e66f787c838b5af7de716e266caf4e5d190d54b)
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 March 10, 2015
31.Dt AUTOMOUNTD 8
32.Os
33.Sh NAME
34.Nm automountd
35.Nd daemon handling autofs mount requests
36.Sh SYNOPSIS
37.Nm
38.Op Fl D Ar name=value
39.Op Fl i
40.Op Fl m Ar maxproc
41.Op Fl o Ar options
42.Op Fl d
43.Op Fl v
44.Sh DESCRIPTION
45The
46.Nm
47daemon is responsible for handling
48.Xr autofs 5
49mount requests, parsing maps,
50and mounting filesystems they specify.
51On startup,
52.Nm
53forks into background and waits for kernel requests.
54When a request is received,
55.Nm
56forks a child process.
57The child process parses the appropriate map and mounts filesystems accordingly.
58Then it signals the kernel to release blocked processes that were waiting
59for the mount.
60.Bl -tag -width ".Fl v"
61.It Fl D
62Define a variable.
63.It Fl i
64For indirect mounts, only create subdirectories if there are no wildcard
65entries.
66Without
67.Fl i ,
68.Nm
69creates all the subdirectories it can.
70Users may not realize that the wildcard map entry makes it possible to access
71directories that have not yet been created.
72.It Fl m Ar maxproc
73Limit the number of forked
74.Nm
75processes, and thus the number of mount requests being handled in parallel.
76The default is 30.
77.It Fl d
78Debug mode: increase verbosity and do not daemonize.
79.It Fl o Ar options
80Specify mount options.
81Options specified here will be overridden by options entered in maps or
82.Xr auto_master 5 .
83.It Fl v
84Increase verbosity.
85.El
86.Sh EXIT STATUS
87.Ex -std
88.Sh SEE ALSO
89.Xr auto_master 5 ,
90.Xr autofs 5 ,
91.Xr automount 8 ,
92.Xr autounmountd 8
93.Sh HISTORY
94The
95.Nm
96daemon appeared in
97.Fx 10.1 .
98.Sh AUTHORS
99The
100.Nm
101was developed by
102.An Edward Tomasz Napierala Aq Mt trasz@FreeBSD.org
103under sponsorship from the FreeBSD Foundation.
104