2 .\" Copyright (c) 1997-2006 Erez Zadok
3 .\" Copyright (c) 1990 Jan-Simon Pendry
4 .\" Copyright (c) 1990 Imperial College of Science, Technology & Medicine
5 .\" Copyright (c) 1990 The Regents of the University of California.
6 .\" All rights reserved.
8 .\" This code is derived from software contributed to Berkeley by
9 .\" Jan-Simon Pendry at Imperial College, London.
11 .\" Redistribution and use in source and binary forms, with or without
12 .\" modification, are permitted provided that the following conditions
14 .\" 1. Redistributions of source code must retain the above copyright
15 .\" notice, this list of conditions and the following disclaimer.
16 .\" 2. Redistributions in binary form must reproduce the above copyright
17 .\" notice, this list of conditions and the following disclaimer in the
18 .\" documentation and/or other materials provided with the distribution.
19 .\" 3. All advertising materials mentioning features or use of this software
20 .\" must display the following acknowledgment:
21 .\" This product includes software developed by the University of
22 .\" California, Berkeley and its contributors.
23 .\" 4. Neither the name of the University nor the names of its contributors
24 .\" may be used to endorse or promote products derived from this software
25 .\" without specific prior written permission.
27 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
28 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
29 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
30 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
31 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
32 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
33 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
34 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
35 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
36 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
39 .\" %W% (Berkeley) %G%
41 .\" $Id: amq.8,v 1.15.2.1 2006/01/02 18:48:24 ezk Exp $
49 .Nd automounter query tool
55 .Op Fl x Ar log_options
56 .Op Fl D Ar debug_options
57 .Op Fl P Ar program_number
58 .Op Oo Fl u Oc Ar directory ...
63 provides a simple way of determining the current state of the
68 Three modes of operation are supported by the current protocol.
70 a list of mount points and auto-mounted file systems is output.
72 alternative host can be specified using the
78 names are given, as output by default, then per file system
79 information is displayed.
81 .Bl -tag -width indent
83 Ask the automounter to flush the internal caches and reload all the maps.
85 Specify an alternate host to query.
86 By default the local host is used.
90 cluster, the root server is queried by default, since that is the system on
91 which the automounter is normally run.
98 For security reasons, this must be the same log file
102 This option is therefore only useful to
105 open file handle on the log file, so that it can be rotated
106 and compressed via daily cron jobs.
108 Ask the automounter to provide a list of mounted file systems, including the
109 number of references to each file system and any error which occurred while
112 Return the process ID of the remote or locally running
115 need to send a signal to the local
117 process, and would rather not have to
118 search through the process table.
119 This option is used in the
123 Ask the automounter to provide system-wide mount statistics.
125 Ask the automounter to unmount the file systems named in
128 information about them.
129 Unmounts are requested, not forced.
131 cause the mounted file system to timeout, which will be picked up by
133 main scheduler thus causing the normal timeout action to be taken.
135 Ask the automounter for its version information.
136 This is a subset of the
137 information output by
142 Translate a full pathname as returned by
146 pathname that goes through its mount points.
147 This option requires that
150 .It Fl x Ar log_options
151 Ask the automounter to use the logging options specified in
154 .It Fl D Ar debug_options
155 Ask the automounter to use the debugging options specified in
159 Display short usage message.
160 .It Fl P Ar program_number
161 Contact an alternate running
163 that had registered itself on a different
166 and apply all other operations to that instance of the automounter.
168 useful when you run multiple copies of
170 and need to manage each
174 will use the default program number for
177 For security reasons, the only alternate program numbers
179 can use range from 300019 to 300029, inclusive.
183 using the TCP transport only.
186 will try TCP, and if that failed, will try UDP.
190 using UDP (connectionless) transport only.
193 will try TCP, and if that failed, will try UDP.
196 .Bl -tag -width ".Pa amq.x" -compact
199 protocol description.
205 uses a Sun registered
207 program number (300019 decimal) which may not
212 If the TCP wrappers library is available, and the
220 will verify that the host running
222 is authorized to connect.
225 service name must be used in the
230 For example, to allow only localhost to connect to
233 .Pa /etc/hosts.allow :
238 .Pa /etc/hosts.deny :
251 .%B "Linux NFS and Automounter Administration"
252 .%O ISBN 0-7821-2739-8
257 .Pa http://www.am-utils.org/
259 .%T Amd \- The 4.4 BSD Automounter
268 .An Jan-Simon Pendry Aq jsp@doc.ic.ac.uk ,
269 Department of Computing, Imperial College, London, UK.
271 .An Erez Zadok Aq ezk@cs.sunysb.edu ,
272 Computer Science Department, Stony Brook
273 University, Stony Brook, New York, USA.
275 Other authors and contributors to
279 file distributed with