amd map parser

==============

The ability to parse amd format maps has been added to autofs.

How to use amd maps in autofs

-----------------------------

To add amd map parsing to autofs a new "format" module has been added.

There are two ways to use this new map format module. First, the existing

master map syntax can be used as described below, and second, sections that

use the top level mount path may be added to the autofs configuration below

the "amd" section in much the same way as is done with amd.

The master map entry syntax is:

mount-point [map-type[,format]:]map [options]

For amd format maps this becomes:

/amd/mp   file,amd:amd.mp

which will use file as the map source and the amd format parser for

the map.

In order to use nsswitch to specify the map source an amd per-mount

section needs to be added to the autofs configuration so autofs

knows the master map entry is an amd format mount.

If an amd-per-mount section is added to the autofs configuration a

corresponding master map entry is optional. If both are present the

map name given in the master map entry will override a "map_name"

option in the amd per-mount section.

If an amd per-mount section is used alone then not giving the "map_type"

option will alow the use of nsswicth for map selection.

See below for an example of an amd per-mount configuration entry.

Configuration sub-system changes

--------------------------------

The configuration sub-system has changed to accommodate the amd parser.

See autofs.conf(5) for more information on format changes.

The configuration is now split into system initialization only

configuration and the daemon configuration. Previously everything was

located in the system initialization configuration file, but now the

configuration is located in autofs.conf in the directory the distribution

uses for the autofs configuration.

There is information about what amd configuration entries can be used

in comments of the installed configuration so that's worth a look.

All that's needed to add an existing amd configuration to autofs is to

add it below the autofs configuration. Apart from changing the amd

"[ global ]" section name to "[ amd ]" nothing else should need to be

changed. However, quite a few amd configuration options don't have

meaning within autofs. When these options are seen they are logged.

Be aware that, if the an old configuration exists and the configuration

hasn't been updated after the installation, changes to the the old

configuration will override changes to the new configuration because

backward compatibility takes priority over the new implementation.

The amd per-mount sections have two functions, to allow per-mount

configuration, as it does in amd, and to allow master map entries to

avoid the need to specify the "type,format" part of the master map

entry. This allows them to use the nsswitch map source functionality

in the same way autofs master map entries do.

If amd per-mount sections are present in the autofs configuration

their corresponding master map entries are optional. This allows

amd maps to be used without adding incompatible entries to the autofs

master map in shared infrastructure environments.

If a section for an amd mount is added below the global amd section

using the mount point path (as is done in amd.conf) then autofs will

know the map format is amd (it doesn't matter if there are no other

configuration options in the mount point section).

If there is a corresponding master map entry the map given in the

master map entry will be used over the map_name option if it is

present in an amd per-mount section.

If a mount point is present in the master map and the source of the

map is nis then it is sufficient to use (for example):

/amd/mp           amd.mp

in the master map and

automount: nis

in /etc/nsswitch.conf or

[ amd ]

map_type = nis

in the configuration along with

[ /amd/mp ]

or

[ /amd/mp ]

map_type = nis

An example of an amd per-mount configuration entry is:

[ amd ]

...

[ /test ]

map_name = /etc/amd.test

#map_type = file

#search_path =			/etc

#browsable_dirs =		yes | no

browsable_dirs =		yes

amd map options that can be used

--------------------------------

In an attempt to describe the usable amd map options, many of the amd

map options have been added to autofs(5).

Not all the amd functionality has been implemented. The autofs(5) man

page usually mentions if something hasn't been implemented so that's

worth checking.

What hasn't been implemented

----------------------------

The configuration options fully_qualified_hosts, unmount_on_exit and

browsable_dirs = full (and a couple of others) aren't implemented.

Map types (sources) ndbm, passwd are not implemented.

The map source "sss" can't be used for amd format maps.

Map caching options aren't used, the existing autofs map caching is

always used for available map sources.

The regex map key matching feature is not implemented.

Mount types lustre, nfsx, jfs and direct haven't been implemented

and other mount types that aren't implemented in amd are also not

available.

How to find out more

--------------------

Have a look at the man pages autofs.conf(5), autofs(5) and to a

lesser extent auto.master(5). These may help.

But the best way to get more information is to ask on the

autofs mailing list as described in the README file.

Ian