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