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