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. -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. 25 April 1989 1 AMQ(8) AMQ(8) -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 sched- uler 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 getcwd(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. 25 April 1989 2 AMQ(8) AMQ(8)
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.conf(5), amd(8)
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 3
Powered by man-cgi (2024-08-26). Maintained for NetBSD by Kimmo Suominen. Based on man-cgi by Panagiotis Christias.