bionic (8) amq.8.gz

Provided by: am-utils_6.2+rc20110530-3.2ubuntu2_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)