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.

              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 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.

       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.


Man(1) output converted with man2html