autofs-5.0.8 - make autofs(5) consistent with auto.master(5) From: Ian Kent The presentation in autofs(5) isn't the same as that in auto.master(5). --- CHANGELOG | 1 + man/auto.master.5.in | 18 +++++++++++------- man/autofs.5 | 41 +++++++++++++++++++++++++++-------------- 3 files changed, 39 insertions(+), 21 deletions(-) diff --git a/CHANGELOG b/CHANGELOG index 5316b26..a6ff31d 100644 --- a/CHANGELOG +++ b/CHANGELOG @@ -30,6 +30,7 @@ - change walk_tree() to take ap. - add negative cache lookup to hesiod lookup. - fix external env configure. +- make autofs(5) consistent with auto.master(5). 17/10/2013 autofs-5.0.8 ======================= diff --git a/man/auto.master.5.in b/man/auto.master.5.in index 65a86b2..1d96d7e 100644 --- a/man/auto.master.5.in +++ b/man/auto.master.5.in @@ -38,14 +38,14 @@ Access to mounts in maps is governed by a key. .P For direct maps the mount point is always specified as: .P -/- +.BR /- .P and the key used within the direct map is the full path to the mount point. The direct map may have multiple entries in the master map. .P For indirect maps access is by using the path scheme: .P -.RI / mount-point / key +.BR /mount-point/key .P where .I mount-point @@ -57,7 +57,9 @@ map given in the entry (See .P Additionally, a map may be included from its source as if it were itself present in the master map by including a line of the form: -.BR +\ [ maptype , format :] map [ options ] +.P +.BR + [ maptype [, format ]:] map\ [ options ] +.P and .BR automount (8) will process the map according to the specification described below for @@ -73,14 +75,14 @@ which contains options to be applied to all entries in the map. .P The format of a master map entry is: .TP -.IR mount-point\ [ map-type [, format ]:] map\ [ options ] +.BR mount-point\ [ map-type [, format ]:] map\ [ options ] .TP -\fBmount-point\fP +.B mount-point Base location for the \fBautofs\fP filesystem to be mounted. For indirect maps this directory will be created (as with \fBmkdir \-p\fP) and is removed when the \fBautofs\fP filesystem is umounted. .TP -\fBmap-type\fP +.B map-type Type of map used for this mount point. The following are valid map types: .RS @@ -133,7 +135,8 @@ for maps of types \fBfile\fP, \fBdir\fP, or \fBprogram\fP, and the name of a dat in the case for maps of type \fByp\fP, \fBnisplus\fP, or \fBhesiod\fP or the \fBdn\fP of an LDAP entry for maps of type \fBldap\fP. .TP -\fBoptions\fP +.B options +.br Any remaining command line arguments without leading dashes (\-) are taken as options (\fI\-o\fP) to \fBmount\fP. Arguments with leading dashes are considered options for the maps. @@ -287,6 +290,7 @@ it will used for subsequent lookups. There are three common schemas in use: .TP .I nisMap +.br Entries in the \fBnisMap\fP schema are \fBnisObject\fP objects in the specified subtree, where the \fBcn\fP attribute is the key (the wildcard key is "/"), and the \fBnisMapEntry\fP attribute diff --git a/man/autofs.5 b/man/autofs.5 index d2e7b12..96c2a2c 100644 --- a/man/autofs.5 +++ b/man/autofs.5 @@ -22,42 +22,56 @@ This is a description of the text file format. Other methods of specifying these files may exist. All empty lines or lines beginning with # are ignored. The basic format of one line in such maps is: .P -.BI "key [" -options "] location" - -.SS key +.BR key\ [ -options ]\ location +.TP +.B key +.br For indirect mounts this is the part of the path name between the mount point and the path into the filesystem when it is mounted. Usually you can think about the key as a sub-directory name below the autofs managed mount point. For direct mounts this is the full path of each mount point. This map is always associated with the /- mount point in the master map. - -.SS options +.TP +.B options +.br Zero or more options may be given. Options can also be given in the .B auto.master file in which case both values are cumulative (this is a difference from SunOS). The options are a list of comma separated options as customary for the .BR mount (8) -command. There are two special options -.I -fstype= -used to specify a filesystem type if the filesystem is not of the default +command. + +There are several special options +.RS +.TP +.B -fstype= +.br +is used to specify a filesystem type if the filesystem is not of the default NFS type. This option is processed by the automounter and not by the mount command. -.I -strict +.TP +.B -strict +.br is used to treat errors when mounting file systems as fatal. This is important when multiple file systems should be mounted (`multi-mounts'). If this option is given, no file system is mounted at all if at least one file system can't be mounted. -.I -use-weight-only +.TP +.B -use-weight-only +.br is used to make the weight the sole factor in selecting a server when multiple servers are present in a map entry. and -.I -no-use-weight-only +.TP +.B -no-use-weight-only +.br can be used to negate the option if it is present in the master map entry for the map but is not wanted for the given mount. - -.SS location +.RE +.TP +.B location The location specifies from where the file system is to be mounted. In the most cases this will be an NFS volume and the usual notation .I host:pathname @@ -227,7 +241,6 @@ Anything else is questionable and unsupported, but these variations will also wo host1(3),host:/blah .fi .RE -.sp .SH UNSUPPORTED This version of the automounter supports direct maps stored in FILE, NIS, NISPLUS and LDAP only.