amq - automounter query tool
amq [ -fmpsvwHTU ] [ -h hostname ] [ -l log_file ] [ -x log_options ] [ -D debug_options ]
[ -P program_number ] [[ -u ] directory ... ]
Amq provides a simple way of determining the current state of amd program. Communication
is by RPC. Three modes of operation are supported by the current protocol. By default a
list of mount points and auto-mounted filesystems is output. An alternative host can be
specified using the -h option.
If directory names are given, as output by default, then per-filesystem information is
-f Ask the automounter to flush the internal caches and reload all the maps.
Specify an alternate host to query. By default the local host is used. In an HP-
UX cluster, the root server is queried by default, since that is the system on
which the automounter is normally run.
Tell amd to use log_file as the log file name. For security reasons, this must be
the same log file which amd used when started. This option is therefore only use-
ful to refresh amd's open file handle on the log file, so that it can be rotated
and compressed via daily cron jobs.
-m Ask the automounter to provide a list of mounted filesystems, including the number
of references to each filesystem and any error which occurred while mounting.
-p Return the process ID of the remote or locally running amd. Useful when you need
to send a signal to the local amd process, and would rather not have to search
through the process table. This option is used in the ctl-amd script.
-s Ask the automounter to provide system-wide mount statistics.
-u Ask the automounter to unmount the filesystems named in directory instead of pro-
viding information about them. Unmounts are requested, not forced. They merely
cause the mounted filesystem to timeout, which will be picked up by amd's main
scheduler thus causing the normal timeout action to be taken.
-v Ask the automounter for its version information. This is a subset of the informa-
tion output by amd's -v option.
-w Translate a full pathname as returned by getpwd(3) into a short Amd pathname that
goes through its mount points. This option requires that Amd is running.
Ask the automounter to use the logging options specified in log_options from now
Ask the automounter to use the debugging options specified in debug_options from
-H Display short usage message.
Contact an alternate running amd that had registered itself on a different RPC pro-
gram_number and apply all other operations to that instance of the automounter.
This is useful when you run multiple copies of amd, and need to manage each one
separately. If not specified, amq will use the default program number for amd,
300019. For security reasons, the only alternate program numbers amd can use range
from 300019 to 300029, inclusive.
-T Contact amd using the TCP transport only. Normally amq will try TCP, and if that
failed, will try UDP.
-U Contact amd using UDP (connectionless) transport only. Normally amq will try TCP,
and if that failed, will try UDP.
amq.x RPC protocol description.
Amq uses a Sun registered RPC program number (300019 decimal) which may not be in the
amd(8), ctl-amd(8), amd.conf(5).
Jan-Simon Pendry <email@example.com>, Department of Computing, Imperial College, London,
Erez Zadok <firstname.lastname@example.org>, Department of Computer Science, Columbia University, New
Other authors and contributors to am-utils are listed in the AUTHORS file distributed with
25 April 1989 AMQ(8)