MAN page from Mandrake Other am-utils-6.0a16-2.i386.rpm

AMQ

Section: Maintenance Commands (8)
Updated: 25 April 1989
Index

NAME

amq - automounter query tool

SYNOPSIS

amq[-fmpsuvTU] [-h hostname] [-l log_file] [-x log_options] [-D debug_options] [-M mountmap entry] [-P program_number] [directory] ...

DESCRIPTION

Amqprovides a simple way of determining the current state ofamdprogram.Communication is byRPC.Three modes of operation are supported by the current protocol. By defaulta list of mount points and auto-mounted filesystems is output. Analternative host can be specified using the-hoption.

Ifdirectorynames are given, as output by default, then per-filesysteminformation 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. InanHP-UXcluster, the root server is queried by default, since that is the system onwhich the automounter is normally run.
-l log_file: Tell amd to uselog_fileas the log file name. For security reasons, this must be the same log filewhich amd used when started. This option is therefore only useful torefresh amd's open file handle on the log file, so that it can be rotatedand compressed via daily cron jobs.
-m: Ask the automounter to provide a list of mounted filesystems, including thenumber of references to each filesystem and any error which occurred whilemounting.
-p: Return the process ID of the remote or locally running amd. Useful when youneed to send a signal to the local amd process, and would rather not have tosearch through the process table. This option is used in thectl-amdscript.
-s: Ask the automounter to provide system-wide mount statistics.
-u: Ask the automounter to unmount the filesystems named indirectoryinstead of providinginformation about them. Unmounts are requested, not forced. They merelycause the mounted filesystem to timeout, which will be picked up byamd'smain scheduler thus causing the normal timeout action to be taken.
-v: Ask the automounter for its version information. This is a subset of theinformation output byamd's-voption.
-x log_options: Ask the automounter to use the logging options specified inlog_optionsfrom now on.
-D log_options: Ask the automounter to use the debugging options specified indebug_optionsfrom now on.
-M map_ent: Pass a mount map entry toamdand wait for it to be evaluated, possible causing a mount. This option ishighly insecure. By default, amd and amq do not support it. You have toconfigure am-utils with--enable-amq-mountto enable this option.
-P program_number: Contact an alternate running amd that had registered itself on a differentRPCprogram_numberand apply all other operations to that instance of the automounter. This isuseful when you run multiple copies of amd, and need to manage eachone separately. If not specified, amq will use the default program numberfor amd, 300019. For security reasons, the only alternate program numbersamd can use range from 300019 to 300029, inclusive.
-T: Contactamdusing the TCP transport only. Normallyamqwill try TCP, and if that failed, will try UDP.
-U: Contactamdusing UDP (connectionless) transport only. Normallyamqwill try TCP, and if that failed, will try UDP.

FILES

amq.x: RPCprotocol description.

CAVEATS

Amquses a Sun registeredRPCprogram number (300019 decimal) which may notbe in the /etc/rpc database.

AUTHORS

Jan-Simon Pendry <jspAATTdoc.ic.ac.uk>, Department of Computing, Imperial College, London, UK.

Erez Zadok <ezkAATTcs.columbia.edu>, Department of Computer Science, ColumbiaUniversity, New York, USA.

Other authors and contributors to am-utils are listed in theAUTHORSfile distributed with am-utils.

This document was created byman2html,using the manual pages.

AMQ