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:
/ 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:
"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 downWhen 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.