date and time created 91/03/17 12:05:19 by pendry
[unix-history] / usr / src / usr.sbin / amd / amq / amq.8
CommitLineData
e1a31032
KM
1.\" Copyright (c) 1990 Jan-Simon Pendry
2.\" Copyright (c) 1990 Imperial College of Science, Technology & Medicine
b42074ab 3.\" Copyright (c) 1990, 1991 The Regents of the University of California.
e1a31032
KM
4.\" All rights reserved.
5.\"
6.\" This code is derived from software contributed to Berkeley by
7.\" Jan-Simon Pendry at Imperial College, London.
e1a31032
KM
8.\" %sccs.include.redist.man%
9.\"
b42074ab 10.\" @(#)amq.8 5.2 (Berkeley) %G%
e1a31032 11.\"
b42074ab
CL
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
e1a31032 29provides a simple way of determining the current state of
b42074ab 30.Xr amd 8
e1a31032
KM
31program.
32Communication is by
b42074ab 33.Tn RPC .
e1a31032
KM
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
b42074ab 38.Fl h
e1a31032 39option.
b42074ab 40.Pp
e1a31032
KM
41If directory names are given, as output by default,
42then per-filesystem information is displayed.
b42074ab
CL
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 .
e1a31032 51By default the local host is used. In an
b42074ab 52.Tn HP-UX
e1a31032
KM
53cluster, the root server is queried by default, since
54that is the system on which the automounter is normally run.
b42074ab
CL
55.It Fl m
56Request automounter to provide a list of mounted filesystems,
e1a31032
KM
57including the number of references to each filesystem and any error
58which occured while mounting.
b42074ab
CL
59.It Fl s
60Request automounter to provide system-wide mount statistics.
61.It Fl u
62Request automounter to unmount the named filesystems
e1a31032
KM
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
b42074ab 66.Xr amd Ns \'s
e1a31032 67main scheduler thus causing the normal timeout action to be taken.
b42074ab
CL
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
e1a31032 74protocol description.
b42074ab
CL
75.El
76.Sh CAVEATS
77.Nm Amq
e1a31032 78uses a Sun registered
b42074ab 79.Tn RPC
e1a31032 80program number (300019 decimal) which may not
b42074ab
CL
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