Run-time Administration

It is sometimes desirable or necessary to exercise external control over some of 's internal state. To support this requirement, implements an RPC interface which is used by the program.

provides a variety of operations. With no arguments, obtains a brief list of all existing mounts created by . This is different from the list displayed by df(1) since the latter only includes system mount points. The output from this option includes the following information:

For example:
/            auto  "root"                      sky:(pid75)
/homes       auto  /usr/local/etc/amd.homes    /homes
/home        auto  /usr/local/etc/amd.home     /home
/homes/jsp   nfs   charm:/home/charm           /a/charm/home/charm/jsp
/homes/phjk  nfs   toytown:/home/toytown       /a/toytown/home/toytown/ai/phjk

The ``-m'' option displays similar information about mounted filesystems, rather than automount points. The output includes the following information:

For example:
"root"             truth:(pid602)       auto 1 localhost is up
hesiod.home        /home                auto 1 localhost is up
hesiod.vol         /vol                 auto 1 localhost is up
hesiod.homes       /homes               auto 1 localhost is up
amy:/home/amy      /a/amy/home/amy      nfs  5 amy is up
gould:/home/gould  /a/gould/home/gould  nfs  0 gould is up (Permission denied)
noddy:/home/noddy  /a/noddy/home/noddy  nfs  0 noddy is down
When the reference count is zero the filesystem is not mounted but the mount point and server information is still being maintained by .

generally applies an operation, specified by a single letter option, to a list of mount points. The default operation is to obtain statistics about each mount point. This is similar to the output shown above but includes information about the number and type of accesses to each mount point.

By default the local host is used. In an HP-UX cluster the root server is used since that is the only place in the cluster where will be running. To query on another host the ``-h'' option should be used.

The ``-u'' option causes the time-to-live interval of the named mount points to be expired, thus causing an unmount attempt. This is the only safe way to unmount an automounted filesystem. It is not possible to unmount a filesystem which has been mounted with the notimeout flag.

The ``-s'' option displays global statistics. If any other options are specified or any filesystems named then this option is ignored.

The ``-f'' option causes to flush the internal mount map cache. This is useful for YP and Hesiod maps since will not notice when they have been updated.

Three other operations are implemented. These modify the state of as a whole, rather than any particular filesystem. The ``-l'', ``-x'' and ``-D'' options have exactly the same effect as 's corresponding command line options. However, the ``-l'' option is rejected by in version ``'' for obvious security reasons.