xref: /csrg-svn/usr.sbin/amd/amq/amq.8 (revision 47469)
1.\" Copyright (c) 1990 Jan-Simon Pendry
2.\" Copyright (c) 1990 Imperial College of Science, Technology & Medicine
3.\" Copyright (c) 1990, 1991 The Regents of the University of California.
4.\" All rights reserved.
5.\"
6.\" This code is derived from software contributed to Berkeley by
7.\" Jan-Simon Pendry at Imperial College, London.
8.\" %sccs.include.redist.man%
9.\"
10.\"     @(#)amq.8	5.2 (Berkeley) 03/16/91
11.\"
12.Dd
13.Dt AMQ 8
14.Os
15.Sh NAME
16.Nm amq
17.Nd automounter query tool
18.Sh SYNOPSIS
19.Nm amq
20.Op Fl f
21.Op Fl h Ar hostname
22.Op Fl m
23.Op Fl s
24.Op Fl u
25.Op Ar directory
26.Ar ...
27.Sh DESCRIPTION
28.Nm Amq
29provides a simple way of determining the current state of
30.Xr amd 8
31program.
32Communication is by
33.Tn RPC .
34Three modes of operation are supported by the current protocol.
35By default a list of mount points and auto-mounted filesystems
36is output.
37An alternative host can be specified using the
38.Fl h
39option.
40.Pp
41If directory names are given, as output by default,
42then per-filesystem information is displayed.
43.Sh OPTIONS
44.Bl -tag -width Ds
45.It Fl f
46Request automounter to flush the internal
47mount map cache.
48.It Fl h Ar hostname
49Query alternate host
50.Ar hostname .
51By default the local host is used.  In an
52.Tn HP-UX
53cluster, the root server is queried by default, since
54that is the system on which the automounter is normally run.
55.It Fl m
56Request automounter to provide a list of mounted filesystems,
57including the number of references to each filesystem and any error
58which occured while mounting.
59.It Fl s
60Request automounter to provide system-wide mount statistics.
61.It Fl u
62Request automounter to unmount the named filesystems
63instead of providing information about them.  Unmounts are requested,
64not forced.  They merely cause the mounted filesystem to timeout,
65which will be picked up by
66.Xr amd Ns \'s
67main scheduler thus causing the normal timeout action to be taken.
68.El
69.Sh FILES
70.Bl -tag -width amq.xxxxx -compact
71.Bl -tag -width Ds
72.It Pa amq.x
73.Tn RPC
74protocol description.
75.El
76.Sh CAVEATS
77.Nm Amq
78uses a Sun registered
79.Tn RPC
80program number (300019 decimal) which may not
81be in the
82.Pa /etc/rpc
83database.
84.Sh SEE ALSO
85.Xr amd 8
86.Sh AUTHOR
87.An Jan-Simon Pendry
88<jsp@doc.ic.ac.uk>, Department of Computing, Imperial College, London, UK.
89.Sh HISTORY
90The
91.Nm
92.At
93