xref: /original-bsd/usr.sbin/amd/amq/amq.8 (revision 64cd2caf)
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.3 (Berkeley) 04/18/94
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 occurred 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 Fl v
77option.
78.It Fl M
79Request automounter to add the given map entry to the root map and then
80trigger a mount request for it.
81.El
82.Sh FILES
83.Bl -tag -width amq.xxxxx -compact
84.Bl -tag -width Ds
85.It Pa amq.x
86.Tn RPC
87protocol description.
88.El
89.Sh CAVEATS
90.Nm Amq
91uses a Sun registered
92.Tn RPC
93program number (300019 decimal) which may not
94be in the
95.Pa /etc/rpc
96database.
97.Sh SEE ALSO
98.Xr amd 8
99.Sh AUTHOR
100.An Jan-Simon Pendry
101<jsp@doc.ic.ac.uk>, Department of Computing, Imperial College, London, UK.
102.Sh HISTORY
103.Nm Amq
104.At
105