svn commit: r275995 - stable/10/usr.sbin/autofs

[Edward Tomasz Napierala]

Author: trasz
Date: Sun Dec 21 11:03:59 2014
New Revision: 275995
URL: https://svnweb.freebsd.org/changeset/base/275995

Log:
  MFC r274723:
  
  Make the auto_master(5) man page clearer on how auto_master
  and map files work together, and add example for smbfs.
  
  Sponsored by:	The FreeBSD Foundation

Modified:
  stable/10/usr.sbin/autofs/auto_master.5
Directory Properties:
  stable/10/   (props changed)

Modified: stable/10/usr.sbin/autofs/auto_master.5
==============================================================================
--- stable/10/usr.sbin/autofs/auto_master.5	Sun Dec 21 11:00:48 2014	(r275994)
+++ stable/10/usr.sbin/autofs/auto_master.5	Sun Dec 21 11:03:59 2014	(r275995)
@@ -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
 .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