xref: /csrg-svn/usr.sbin/amd/amq/amq.8 (revision 66876)
149686Spendry.\"
244628Smckusick.\" Copyright (c) 1990 Jan-Simon Pendry
344628Smckusick.\" Copyright (c) 1990 Imperial College of Science, Technology & Medicine
461778Sbostic.\" Copyright (c) 1990, 1991, 1993
561778Sbostic.\"	The Regents of the University of California.  All rights reserved.
644628Smckusick.\"
744628Smckusick.\" This code is derived from software contributed to Berkeley by
844628Smckusick.\" Jan-Simon Pendry at Imperial College, London.
944628Smckusick.\"
1049686Spendry.\" %sccs.include.redist.man%
1144628Smckusick.\"
12*66876Sbostic.\"     @(#)amq.8	8.3 (Berkeley) 04/18/94
1347529Spendry.\"
1452453Spendry.\" $Id: amq.8,v 5.2.2.1 1992/02/09 15:11:41 jsp beta $
1549686Spendry.\"
1649686Spendry.Dd March 16, 1991
1747469Scael.Dt AMQ 8
1847469Scael.Os
1947469Scael.Sh NAME
2047469Scael.Nm amq
2147469Scael.Nd automounter query tool
2247469Scael.Sh SYNOPSIS
2347469Scael.Nm amq
2447469Scael.Op Fl f
2547469Scael.Op Fl h Ar hostname
2647529Spendry.Op Fl M Ar mountmap_entry
2747469Scael.Op Fl m
2847469Scael.Op Fl s
2947469Scael.Op Fl u
3047529Spendry.Op Fl v
3147469Scael.Op Ar directory
3247469Scael.Ar ...
3347469Scael.Sh DESCRIPTION
3447469Scael.Nm Amq
3547529Spendryprovides a simple way of determining the current state of the
3647469Scael.Xr amd 8
3744628Smckusickprogram.
3844628SmckusickCommunication is by
3947469Scael.Tn RPC .
4044628SmckusickThree modes of operation are supported by the current protocol.
4144628SmckusickBy default a list of mount points and auto-mounted filesystems
4244628Smckusickis output.
4344628SmckusickAn alternative host can be specified using the
4447469Scael.Fl h
4544628Smckusickoption.
4647469Scael.Pp
4744628SmckusickIf directory names are given, as output by default,
4844628Smckusickthen per-filesystem information is displayed.
4947469Scael.Sh OPTIONS
5047469Scael.Bl -tag -width Ds
5147469Scael.It Fl f
5247529SpendryRequest automounter to flush the internal caches.
5347469Scael.It Fl h Ar hostname
5447469ScaelQuery alternate host
5547469Scael.Ar hostname .
5644628SmckusickBy default the local host is used.  In an
5747469Scael.Tn HP-UX
5844628Smckusickcluster, the root server is queried by default, since
5944628Smckusickthat is the system on which the automounter is normally run.
6047469Scael.It Fl m
6147529SpendryRequest the automounter to provide a list of mounted filesystems,
6244628Smckusickincluding the number of references to each filesystem and any error
63*66876Sbosticwhich occurred while mounting.
6447469Scael.It Fl s
6547529SpendryRequest the automounter to provide system-wide mount statistics.
6647469Scael.It Fl u
6747529SpendryRequest the automounter to unmount the named filesystems
6844628Smckusickinstead of providing information about them.  Unmounts are requested,
6944628Smckusicknot forced.  They merely cause the mounted filesystem to timeout,
7044628Smckusickwhich will be picked up by
7147469Scael.Xr amd Ns \'s
7244628Smckusickmain scheduler thus causing the normal timeout action to be taken.
7347529Spendry.It Fl v
7447529SpendryRequest the automounter to provide version information.  This is a subset
7547529Spendryof the information provided by
7665104Smckusick.Xr amd Ns \'s Fl v
7747529Spendryoption.
7847529Spendry.It Fl M
7947529SpendryRequest automounter to add the given map entry to the root map and then
8047529Spendrytrigger a mount request for it.
8147469Scael.El
8247469Scael.Sh FILES
8347469Scael.Bl -tag -width amq.xxxxx -compact
8447469Scael.Bl -tag -width Ds
8547469Scael.It Pa amq.x
8647469Scael.Tn RPC
8744628Smckusickprotocol description.
8847469Scael.El
8947469Scael.Sh CAVEATS
9047469Scael.Nm Amq
9144628Smckusickuses a Sun registered
9247469Scael.Tn RPC
9344628Smckusickprogram number (300019 decimal) which may not
9447469Scaelbe in the
9547469Scael.Pa /etc/rpc
9647469Scaeldatabase.
9747469Scael.Sh SEE ALSO
9847469Scael.Xr amd 8
9947469Scael.Sh AUTHOR
10047469Scael.An Jan-Simon Pendry
10147469Scael<jsp@doc.ic.ac.uk>, Department of Computing, Imperial College, London, UK.
10247469Scael.Sh HISTORY
10352453Spendry.Nm Amq
10452453Spendry.At
105