Provided by: am-utils_6.2+rc20110530-3ubuntu1_amd64 bug

NAME

       amq - automounter query tool

SYNOPSIS

       amq  [ -fmpqsvwHTU ] [ -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 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
       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 therefore only
              useful 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.

       -q     Suppress error messages produced when attempting synchronous unmounts with  the  -u
              option.

       -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  timeout, which will be picked up by amd's main
              scheduler thus causing the normal timeout action to be taken.  If the -u option  is
              repeated,  amq  will  attempt  to  unmount the file system synchronously by waiting
              until the timeout action is taken and returning an error if the unmount fails.  Any
              error messages produced may be suppressed with the -q option.

       -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.  Note that the "fatal" and "error" options cannot be turned off.

       -D debug_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 registered 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
              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.

FILES

       amq.x               RPC protocol description.

CAVEATS

       Amq uses a Sun registered RPC program number (300019 decimal) which  may  not  be  in  the
       /etc/rpc database.

       If  the  TCP wrappers library is available, and the use_tcpwrappers global amd.conf option
       is set to ``yes'', then amd will verify  that  the  host  running  amq  is  authorized  to
       connect.   The  amd  service  name  must  used in the /etc/hosts.allow and /etc/hosts.deny
       files.  For example, to allow  only  localhost  to  connect  to  amd,  add  this  line  to
       /etc/hosts.allow:

              amd: localhost

       and this line to /etc/hosts.deny:

              amd: ALL

SEE ALSO

       amd(8), amd.conf(5), hosts_access(5).

       ``am-utils'' info(1) entry.

       Linux NFS and Automounter Administration by Erez Zadok, ISBN 0-7821-2739-8, (Sybex, 2001).

       http://www.am-utils.org

       Amd - The 4.4 BSD Automounter

AUTHORS

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

       Erez Zadok <ezk@cs.sunysb.edu>, Computer Science Department, Stony Brook University, Stony
       Brook, 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)