blob: 9f3ddbb1fd77a7647b53397289b434ceb8e4205d (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
|
<table class="head">
<tr>
<td class="head-ltitle">AUTOFS(4)</td>
<td class="head-vol">Device Drivers Manual</td>
<td class="head-rtitle">AUTOFS(4)</td>
</tr>
</table>
<div class="manual-text">
<section class="Sh">
<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
<p class="Pp"><code class="Nm">autofs</code> —
<span class="Nd">automounter filesystem</span></p>
</section>
<section class="Sh">
<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
<p class="Pp">To compile this driver into the kernel, place the following line
in the kernel configuration file:</p>
<div class="Bd Pp Bd-indent"><code class="Cd">options AUTOFS</code></div>
<p class="Pp">Alternatively, to load the driver as a module at boot time, place
the following line in <a class="Xr">loader.conf(5)</a>:</p>
<div class="Bd Pp Bd-indent Li">
<pre>autofs_load="YES"</pre>
</div>
</section>
<section class="Sh">
<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
<p class="Pp">The <code class="Nm">autofs</code> driver is the kernel component
of the automounter infrastructure. Its job is to pass mount requests to the
<a class="Xr">automountd(8)</a> daemon, and pause the processes trying to
access the automounted filesystem until the mount is completed. It is
mounted by the <a class="Xr">automount(8)</a>.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="OPTIONS"><a class="permalink" href="#OPTIONS">OPTIONS</a></h1>
<p class="Pp">These options are available when mounting
<code class="Nm">autofs</code> file systems:</p>
<dl class="Bl-tag">
<dt id="master_options"><a class="permalink" href="#master_options"><code class="Cm">master_options</code></a></dt>
<dd>Mount options for all filesystems specified in the map entry.</dd>
<dt id="master_prefix"><a class="permalink" href="#master_prefix"><code class="Cm">master_prefix</code></a></dt>
<dd>Filesystem mountpoint prefix.</dd>
</dl>
</section>
<section class="Sh">
<h1 class="Sh" id="SYSCTL_VARIABLES"><a class="permalink" href="#SYSCTL_VARIABLES">SYSCTL
VARIABLES</a></h1>
<p class="Pp">The following variables are available as both
<a class="Xr">sysctl(8)</a> variables and <a class="Xr">loader(8)</a>
tunables:</p>
<dl class="Bl-tag">
<dt id="vfs.autofs.debug"><var class="Va">vfs.autofs.debug</var></dt>
<dd>Verbosity level for log messages from the <code class="Nm">autofs</code>
driver. Set to 0 to disable logging or 1 to warn about potential problems.
Larger values enable debugging output. Defaults to 1.</dd>
<dt id="vfs.autofs.interruptible"><var class="Va">vfs.autofs.interruptible</var></dt>
<dd>Set to 1 to allow mount requests to be interrupted by signal. Defaults to
1.</dd>
<dt id="vfs.autofs.retry_delay"><var class="Va">vfs.autofs.retry_delay</var></dt>
<dd>Number of seconds before retrying mount requests. Defaults to 1.</dd>
<dt id="vfs.autofs.retry_attempts"><var class="Va">vfs.autofs.retry_attempts</var></dt>
<dd>Number of attempts before failing mount. Defaults to 3.</dd>
<dt id="vfs.autofs.cache"><var class="Va">vfs.autofs.cache</var></dt>
<dd>Number of seconds to wait before reinvoking
<a class="Xr">automountd(8)</a> for any given file or directory. Defaults
to 600.</dd>
<dt id="vfs.autofs.timeout"><var class="Va">vfs.autofs.timeout</var></dt>
<dd>Number of seconds to wait for <a class="Xr">automountd(8)</a> to handle
the mount request. Defaults to 30.</dd>
<dt id="vfs.autofs.mount_on_stat"><var class="Va">vfs.autofs.mount_on_stat</var></dt>
<dd>Set to 1 to trigger mount on <a class="Xr">stat(2)</a> on mountpoint.
Defaults to 0.</dd>
</dl>
</section>
<section class="Sh">
<h1 class="Sh" id="EXAMPLES"><a class="permalink" href="#EXAMPLES">EXAMPLES</a></h1>
<p class="Pp">To unmount all mounted <code class="Nm">autofs</code>
filesystems:</p>
<p class="Pp"></p>
<div class="Bd Bd-indent"><code class="Li">umount -At autofs</code></div>
<p class="Pp">To mount <code class="Nm">autofs</code> filesystems specified in
<a class="Xr">auto_master(5)</a>:</p>
<p class="Pp"></p>
<div class="Bd Bd-indent"><code class="Li">automount</code></div>
</section>
<section class="Sh">
<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
ALSO</a></h1>
<p class="Pp"><a class="Xr">auto_master(5)</a>, <a class="Xr">automount(8)</a>,
<a class="Xr">automountd(8)</a>, <a class="Xr">autounmountd(8)</a></p>
</section>
<section class="Sh">
<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
<p class="Pp">The <code class="Nm">autofs</code> driver first appeared in
<span class="Ux">FreeBSD 10.1</span>.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<p class="Pp">The <code class="Nm">autofs</code> was developed by
<span class="An">Edward Tomasz Napierala</span>
<<a class="Mt" href="mailto:trasz@FreeBSD.org">trasz@FreeBSD.org</a>>
under sponsorship from the FreeBSD Foundation.</p>
</section>
</div>
<table class="foot">
<tr>
<td class="foot-date">December 2, 2017</td>
<td class="foot-os">FreeBSD 15.0</td>
</tr>
</table>
|