![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to amq.tex CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSDReno / usr.sbin / amd / doc|
Return to amq.tex CVS log | Up to [CSRG BSD Unix] / 43BSDReno / usr.sbin / amd / doc |
1.1 root 1: % $Id: amq.tex,v 5.2 90/06/23 22:21:56 jsp Rel $
2: %
3: % Copyright (c) 1989 Jan-Simon Pendry
4: % Copyright (c) 1989 Imperial College of Science, Technology & Medicine
5: % Copyright (c) 1989 The Regents of the University of California.
6: % All rights reserved.
7: %
8: % This code is derived from software contributed to Berkeley by
9: % Jan-Simon Pendry at Imperial College, London.
10: %
11: % Redistribution and use in source and binary forms are permitted provided
12: % that: (1) source distributions retain this entire copyright notice and
13: % comment, and (2) distributions including binaries display the following
14: % acknowledgement: ``This product includes software developed by the
15: % University of California, Berkeley and its contributors'' in the
16: % documentation or other materials provided with the distribution and in
17: % all advertising materials mentioning features or use of this software.
18: % Neither the name of the University nor the names of its contributors may
19: % be used to endorse or promote products derived from this software without
20: % specific prior written permission.
21: % THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
22: % WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
23: % MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
24: %
25: % @(#)amq.tex 5.1 (Berkeley) 7/19/90
26:
27:
28: \Chapter{Run-time Administration}\label{chapter:amq}
29:
30: It is sometimes desirable or necessary to exercise external control
31: over some of \amd's internal state. To support this requirement,
32: \amd\ implements an RPC interface which is used by the \amq\ program.
33:
34: \Amq\ provides a variety of operations. With no arguments, \amq\ obtains
35: a brief list of all existing mounts created by \amd. This is different from
36: the list displayed by {\bf df}(1) since the latter only includes system
37: mount points.
38: The output from this option includes the following information:
39: \begin{itemize}
40: \item the automount point,
41: \item the filesystem type,
42: \item the mount map or mount information,
43: \item the internal, or system mount point.
44: \end{itemize}
45: For example:
46: \begin{verbatim}
47: / auto "root" sky:(pid75)
48: /homes auto /usr/local/etc/amd.homes /homes
49: /home auto /usr/local/etc/amd.home /home
50: /homes/jsp nfs charm:/home/charm /a/charm/home/charm/jsp
51: /homes/phjk nfs toytown:/home/toytown /a/toytown/home/toytown/ai/phjk
52: \end{verbatim}
53:
54: The ``-m'' option displays similar information about mounted filesystems,
55: rather than automount points. The output includes the following
56: information:
57: \begin{itemize}
58: \item the mount information,
59: \item the mount point,
60: \item the filesystem type,
61: \item the number of references to this filesystem,
62: \item the server hostname,
63: \item the state of the file server,
64: \item any error which has occured.
65: \end{itemize}
66: For example:
67: \begin{verbatim}
68: "root" truth:(pid602) auto 1 localhost is up
69: hesiod.home /home auto 1 localhost is up
70: hesiod.vol /vol auto 1 localhost is up
71: hesiod.homes /homes auto 1 localhost is up
72: amy:/home/amy /a/amy/home/amy nfs 5 amy is up
73: gould:/home/gould /a/gould/home/gould nfs 0 gould is up (Permission denied)
74: noddy:/home/noddy /a/noddy/home/noddy nfs 0 noddy is down
75: \end{verbatim}
76: When the reference count is zero the filesystem is not mounted but
77: the mount point and server information is still being maintained
78: by \amd.
79:
80: \Amq\ generally applies an operation, specified by a single letter option,
81: to a list of mount points. The default operation is to obtain statistics
82: about each mount point. This is similar to the output shown above
83: but includes information about the number and type of accesses to each
84: mount point.
85:
86: By default the local host is used. In an HP-UX cluster the root server
87: is used since that is the only place in the cluster where \amd\ will be running.
88: To query \amd\ on another host the ``-h'' option should be used.
89:
90: The ``-u'' option causes the time-to-live interval of the named mount points
91: to be expired, thus causing an unmount attempt. This is the only safe way
92: to unmount an automounted filesystem.
93: It is not possible to unmount a filesystem which has been mounted with
94: the {\tt notimeout} flag.
95:
96: %The ``-H'' option informs \amd\ that the specified mount point has hung -
97: %as if its keepalive timer had expired.
98:
99: The ``-s'' option displays global statistics. If any other options are specified
100: or any filesystems named then this option is ignored.
101:
102: The ``-f'' option causes \amd\ to flush the internal mount map cache. This is
103: useful for YP and Hesiod maps since \amd\ will not notice when they
104: have been updated.
105:
106: Three other operations are implemented. These modify the state of
107: \amd\ as a whole, rather than any particular filesystem.
108: The ``-l'', ``-x'' and ``-D'' options have exactly the same effect
109: as \amd's corresponding command line options. However, the ``-l''
110: option is rejected by \amd\ in version ``\VERSION''
111: for obvious security reasons.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.