xref: /illumos-gate/usr/src/man/man8/automountd.8 (revision e2a8479967f5e2ae9ba0aa265cfa175d7874b057)
1.\"
2.\" The contents of this file are subject to the terms of the
3.\" Common Development and Distribution License (the "License").
4.\" You may not use this file except in compliance with the License.
5.\"
6.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
7.\" or http://www.opensolaris.org/os/licensing.
8.\" See the License for the specific language governing permissions
9.\" and limitations under the License.
10.\"
11.\" When distributing Covered Code, include this CDDL HEADER in each
12.\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
13.\" If applicable, add the following below this CDDL HEADER, with the
14.\" fields enclosed by brackets "[]" replaced with your own identifying
15.\" information: Portions Copyright [yyyy] [name of copyright owner]
16.\"
17.\"
18.\" Copyright 1989 AT&T
19.\" Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved
20.\" Copyright 2016 Nexenta Systems, Inc.
21.\"
22.Dd March 1, 2016
23.Dt AUTOMOUNTD 8
24.Os
25.Sh NAME
26.Nm automountd
27.Nd autofs mount/unmount daemon
28.Sh SYNOPSIS
29.Nm
30.Op Fl nTv
31.Op Fl D Ar name Ns = Ns Ar value
32.Sh DESCRIPTION
33.Nm
34is an RPC server that answers file system mount and unmount requests from the
35.Nm autofs
36file system.
37It uses local files or name service maps to locate file systems to be mounted.
38These maps are described with the
39.Xr automount 8
40command.
41.Pp
42If
43.Nm automount
44finds any non-trivial entries in either the local or distributed automount maps
45and if the daemon is not running already, the
46.Nm
47daemon is automatically invoked by
48.Xr automount 8 .
49.Nm
50enables the svc:/network/nfs/nlockmgr service
51.Pq Xr lockd 8 ,
52and the svc:/network/nfs/status service
53.Pq Xr statd 8 ,
54if NFS mounts need to be done.
55.Sh OPTIONS
56The following options are supported:
57.Bl -tag -width Ds
58.It Fl D Ar name Ns = Ns Ar value
59Assign
60.Ar value
61to the indicated
62.Nm automount
63map substitution variable.
64These assignments cannot be used to substitute variables in the master map
65.Sy auto_master .
66.It Fl n
67Turn off browsing for all
68.Nm autofs
69mount points.
70This option overrides the
71.Sy -browse
72.Nm autofs
73map option on the local host.
74.It Fl T
75Trace.
76Expand each RPC call and display it on the standard output.
77.It Fl v
78Verbose.
79Log status messages to the console.
80.El
81.Sh USAGE
82See
83.Xr largefile 7
84for the description of the behavior of
85.Nm
86when encountering files greater than or equal to 2 Gbyte
87.Pq 2^31 bytes .
88.Sh FILES
89.Bl -tag -width Ds
90.It Pa /etc/auto_master
91Master map for automounter.
92.El
93.Sh SEE ALSO
94.Xr svcs 1 ,
95.Xr autofs 5 ,
96.Xr attributes 7 ,
97.Xr largefile 7 ,
98.Xr smf 7 ,
99.Xr automount 8 ,
100.Xr svcadm 8
101.Sh NOTES
102The
103.Nm
104service is managed by the service management facility,
105.Xr smf 7 ,
106under the service identifier:
107.Bd -literal -offset indent
108svc:/system/filesystem/autofs
109.Ed
110.Pp
111Administrative actions on this service, such as enabling, disabling, or
112requesting restart, can be performed using
113.Xr svcadm 8 .
114The service's status can be queried using
115.Xr svcs 1 .
116If it is disabled, it is enabled by
117.Xr automount 8
118unless the
119.Sy application Ns / Ns Sy auto_enable
120property is set to
121.Sy false .
122