AMQ(8) AMQ(8)
NAME
amq - automounter query tool
SYNOPSIS
amq [ -fmpsvwHTU ] [ -h hostname ] [ -l log_file ] [ -x
log_options ] [ -D debug_options ] [ -P program_number ]
[[ -u ] directory ... ]
DESCRIPTION
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 filesys-
tems 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 displayed.
OPTIONS
-f Ask the automounter to flush the internal caches
and reload all the maps.
-h hostname
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.
-l log_file
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 there-
fore only useful to refresh amd's open file handle
on the log file, so that it can be rotated and com-
pressed 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 run-
ning 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 providing information
about them. Unmounts are requested, not forced.
They merely cause the mounted filesystem to time-
out, 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 information 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.
-x log_options
Ask the automounter to use the logging options
specified in log_options from now on.
-D log_options
Ask the automounter to use the debugging options
specified in debug_options from now on.
-H Display short usage message.
-P program_number
Contact an alternate running amd that had regis-
tered itself on a different RPC program_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 sepa-
rately. If not specified, amq will use the default
program number for amd, 300019. For security rea-
sons, 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.
FILES
amq.x RPC protocol description.
CAVEATS
Amq uses a Sun registered RPC program number (300019 deci-
mal) which may not be in the /etc/rpc database.
SEE ALSO
amd(8), ctl-amd(8), amd.conf(5).
AUTHORS
Jan-Simon Pendry <jsp@doc.ic.ac.uk>, Department of Comput-
ing, Imperial College, London, UK.
Erez Zadok <ezk@cs.columbia.edu>, Department of Computer
Science, Columbia University, New York, USA.
Other authors and contributors to am-utils are listed in
the AUTHORS file distributed with am-utils.
25 April 1989 AMQ(8)