Make the auto_master(5) man page clearer on how auto_master

and map files work together, and add example for smbfs.

Differential Revision:	https://reviews.freebsd.org/D1184
Reviewed by:	wblock@
MFC after:	1 month
Sponsored by:	The FreeBSD Foundation
This commit is contained in:
Edward Tomasz Napierala 2014-11-19 19:46:58 +00:00
parent c07b9c32f0
commit e202e3ffec
Notes: svn2git 2020-12-20 02:59:44 +00:00
svn path=/head/; revision=274723

View File

@ -27,13 +27,17 @@
.\"
.\" $FreeBSD$
.\"
.Dd November 17, 2014
.Dd November 19, 2014
.Dt AUTO_MASTER 5
.Os
.Sh NAME
.Nm auto_master
.Nd auto_master and map file format
.Sh DESCRIPTION
The automounter configuration consists of the
.Nm
configuration file, which assigns filesystem paths to map names,
and maps, which contain actual mount information.
The
.Nm
configuration file is used by the
@ -132,8 +136,12 @@ The special option
.Li fstype
is used to specify filesystem type.
It is not passed to the mount program as an option.
Instead, it is passed as argument to
Instead, it is passed as an argument to
.Cm "mount -t".
The default
.Li fstype
is
.Ql nfs .
The special option
.Li nobrowse
is used to disable creation of top-level directories for special
@ -153,9 +161,11 @@ prefix it with colon.
For example,
.Li :/dev/cd0 .
.Pp
This example, when used with the
This example, when put into
.Pa /etc/auto_example ,
and with
.Nm
example above, specifies that the NFS share
referring to the map as described above, specifies that the NFS share
.Li 192.168.1.1:/share/example/x
will be mounted on
.Pa /example/x/
@ -163,11 +173,18 @@ when any process attempts to access that mountpoint, with
.Li intr
and
.Li nfsv4
mount options:
mount options, described in
.Xr mount_nfs 8 :
.Bd -literal -offset indent
.Li x -intr,nfsv4 192.168.1.1:/share/example/x
.Ed
.Pp
Automatically mount an SMB share on access, as a guest user,
without prompting for a password:
.Bd -literal -offset indent
.Li share -fstype=smbfs,-N ://@server/share
.Ed
.Pp
Automatically mount the CD drive on access:
.Bd -literal -offset indent
.Li cd -fstype=cd9660 :/dev/cd0
@ -224,6 +241,7 @@ and this in
map file:
.Bd -literal -offset indent
.Li /example/x -intr,nfsv4 192.168.1.1:/share/example/x
.Li /example/share -fstype=smbfs,-N ://@server/share
.Li /example/cd -fstype=cd9660 :/dev/cd0
.Ed
.Sh DIRECTORY SERVICES