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