| @@ -1,264 +1,264 @@ | | | @@ -1,264 +1,264 @@ |
1 | .\" $NetBSD: amq.8,v 1.1.1.1 2008/09/19 20:07:17 christos Exp $ | | 1 | .\" $NetBSD: amq.8,v 1.2 2008/09/19 21:46:58 christos Exp $ |
2 | .\" | | 2 | .\" |
3 | .\" | | 3 | .\" |
4 | .\" Copyright (c) 1997-2007 Erez Zadok | | 4 | .\" Copyright (c) 1997-2007 Erez Zadok |
5 | .\" Copyright (c) 1990 Jan-Simon Pendry | | 5 | .\" Copyright (c) 1990 Jan-Simon Pendry |
6 | .\" Copyright (c) 1990 Imperial College of Science, Technology & Medicine | | 6 | .\" Copyright (c) 1990 Imperial College of Science, Technology & Medicine |
7 | .\" Copyright (c) 1990 The Regents of the University of California. | | 7 | .\" Copyright (c) 1990 The Regents of the University of California. |
8 | .\" All rights reserved. | | 8 | .\" All rights reserved. |
9 | .\" | | 9 | .\" |
10 | .\" This code is derived from software contributed to Berkeley by | | 10 | .\" This code is derived from software contributed to Berkeley by |
11 | .\" Jan-Simon Pendry at Imperial College, London. | | 11 | .\" Jan-Simon Pendry at Imperial College, London. |
12 | .\" | | 12 | .\" |
13 | .\" Redistribution and use in source and binary forms, with or without | | 13 | .\" Redistribution and use in source and binary forms, with or without |
14 | .\" modification, are permitted provided that the following conditions | | 14 | .\" modification, are permitted provided that the following conditions |
15 | .\" are met: | | 15 | .\" are met: |
16 | .\" 1. Redistributions of source code must retain the above copyright | | 16 | .\" 1. Redistributions of source code must retain the above copyright |
17 | .\" notice, this list of conditions and the following disclaimer. | | 17 | .\" notice, this list of conditions and the following disclaimer. |
18 | .\" 2. Redistributions in binary form must reproduce the above copyright | | 18 | .\" 2. Redistributions in binary form must reproduce the above copyright |
19 | .\" notice, this list of conditions and the following disclaimer in the | | 19 | .\" notice, this list of conditions and the following disclaimer in the |
20 | .\" documentation and/or other materials provided with the distribution. | | 20 | .\" documentation and/or other materials provided with the distribution. |
21 | .\" 3. All advertising materials mentioning features or use of this software | | 21 | .\" 3. All advertising materials mentioning features or use of this software |
22 | .\" must display the following acknowledgment: | | 22 | .\" must display the following acknowledgment: |
23 | .\" This product includes software developed by the University of | | 23 | .\" This product includes software developed by the University of |
24 | .\" California, Berkeley and its contributors. | | 24 | .\" California, Berkeley and its contributors. |
25 | .\" 4. Neither the name of the University nor the names of its contributors | | 25 | .\" 4. Neither the name of the University nor the names of its contributors |
26 | .\" may be used to endorse or promote products derived from this software | | 26 | .\" may be used to endorse or promote products derived from this software |
27 | .\" without specific prior written permission. | | 27 | .\" without specific prior written permission. |
28 | .\" | | 28 | .\" |
29 | .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND | | 29 | .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND |
30 | .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | | 30 | .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE |
31 | .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE | | 31 | .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE |
32 | .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE | | 32 | .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE |
33 | .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL | | 33 | .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL |
34 | .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS | | 34 | .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS |
35 | .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | | 35 | .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) |
36 | .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | | 36 | .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT |
37 | .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | | 37 | .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY |
38 | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | | 38 | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF |
39 | .\" SUCH DAMAGE. | | 39 | .\" SUCH DAMAGE. |
40 | .\" | | 40 | .\" |
41 | .\" | | 41 | .\" |
42 | .\" File: am-utils/amq/amq.8 | | 42 | .\" File: am-utils/amq/amq.8 |
43 | .\" | | 43 | .\" |
44 | .TH AMQ 8 "25 April 1989" | | 44 | .TH AMQ 8 "25 April 1989" |
45 | .SH NAME | | 45 | .SH NAME |
46 | amq \- automounter query tool | | 46 | amq \- automounter query tool |
47 | .SH SYNOPSIS | | 47 | .SH SYNOPSIS |
48 | .B amq | | 48 | .B amq |
49 | [ | | 49 | [ |
50 | .BI \-fmpsvwHTU | | 50 | .BI \-fmpsvwHTU |
51 | ] [ | | 51 | ] [ |
52 | .BI \-h " hostname" | | 52 | .BI \-h " hostname" |
53 | ] [ | | 53 | ] [ |
54 | .BI \-l " log_file" | | 54 | .BI \-l " log_file" |
55 | ] [ | | 55 | ] [ |
56 | .BI \-x " log_options" | | 56 | .BI \-x " log_options" |
57 | ] [ | | 57 | ] [ |
58 | .BI \-D " debug_options" | | 58 | .BI \-D " debug_options" |
59 | ] [ | | 59 | ] [ |
60 | .BI \-P " program_number" | | 60 | .BI \-P " program_number" |
61 | ] [[ | | 61 | ] [[ |
62 | .B \-u | | 62 | .B \-u |
63 | ] | | 63 | ] |
64 | .I directory .\|.\|. | | 64 | .I directory .\|.\|. |
65 | ] | | 65 | ] |
66 | .SH DESCRIPTION | | 66 | .SH DESCRIPTION |
67 | .B Amq | | 67 | .B Amq |
68 | provides a simple way of determining the current state of | | 68 | provides a simple way of determining the current state of |
69 | .B amd | | 69 | .B amd |
70 | program. | | 70 | program. |
71 | Communication is by | | 71 | Communication is by |
72 | .SM RPC. | | 72 | .SM RPC. |
73 | Three modes of operation are supported by the current protocol. By default | | 73 | Three modes of operation are supported by the current protocol. By default |
74 | a list of mount points and auto-mounted filesystems is output. An | | 74 | a list of mount points and auto-mounted filesystems is output. An |
75 | alternative host can be specified using the | | 75 | alternative host can be specified using the |
76 | .I \-h | | 76 | .I \-h |
77 | option. | | 77 | option. |
78 | .LP | | 78 | .LP |
79 | If | | 79 | If |
80 | .I directory | | 80 | .I directory |
81 | names are given, as output by default, then per-filesystem | | 81 | names are given, as output by default, then per-filesystem |
82 | information is displayed. | | 82 | information is displayed. |
83 | .SH OPTIONS | | 83 | .SH OPTIONS |
84 | | | 84 | |
85 | .TP | | 85 | .TP |
86 | .B \-f | | 86 | .B \-f |
87 | Ask the automounter to flush the internal caches and reload all the maps. | | 87 | Ask the automounter to flush the internal caches and reload all the maps. |
88 | | | 88 | |
89 | .TP | | 89 | .TP |
90 | .BI \-h " hostname" | | 90 | .BI \-h " hostname" |
91 | Specify an alternate host to query. By default the local host is used. In | | 91 | Specify an alternate host to query. By default the local host is used. In |
92 | an | | 92 | an |
93 | .SM HP-UX | | 93 | .SM HP-UX |
94 | cluster, the root server is queried by default, since that is the system on | | 94 | cluster, the root server is queried by default, since that is the system on |
95 | which the automounter is normally run. | | 95 | which the automounter is normally run. |
96 | | | 96 | |
97 | .TP | | 97 | .TP |
98 | .BI \-l " log_file" | | 98 | .BI \-l " log_file" |
99 | Tell amd to use | | 99 | Tell amd to use |
100 | .I log_file | | 100 | .I log_file |
101 | as the log file name. For security reasons, this must be the same log file | | 101 | as the log file name. For security reasons, this must be the same log file |
102 | which amd used when started. This option is therefore only useful to | | 102 | which amd used when started. This option is therefore only useful to |
103 | refresh amd's open file handle on the log file, so that it can be rotated | | 103 | refresh amd's open file handle on the log file, so that it can be rotated |
104 | and compressed via daily cron jobs. | | 104 | and compressed via daily cron jobs. |
105 | | | 105 | |
106 | .TP | | 106 | .TP |
107 | .B \-m | | 107 | .B \-m |
108 | Ask the automounter to provide a list of mounted filesystems, including the | | 108 | Ask the automounter to provide a list of mounted filesystems, including the |
109 | number of references to each filesystem and any error which occurred while | | 109 | number of references to each filesystem and any error which occurred while |
110 | mounting. | | 110 | mounting. |
111 | | | 111 | |
112 | .TP | | 112 | .TP |
113 | .B \-p | | 113 | .B \-p |
114 | Return the process ID of the remote or locally running amd. Useful when you | | 114 | Return the process ID of the remote or locally running amd. Useful when you |
115 | need to send a signal to the local amd process, and would rather not have to | | 115 | need to send a signal to the local amd process, and would rather not have to |
116 | search through the process table. This option is used in the | | 116 | search through the process table. This option is used in the |
117 | .I ctl-amd | | 117 | .I ctl-amd |
118 | script. | | 118 | script. |
119 | | | 119 | |
120 | .TP | | 120 | .TP |
121 | .B \-s | | 121 | .B \-s |
122 | Ask the automounter to provide system-wide mount statistics. | | 122 | Ask the automounter to provide system-wide mount statistics. |
123 | | | 123 | |
124 | .TP | | 124 | .TP |
125 | .B \-u | | 125 | .B \-u |
126 | Ask the automounter to unmount the filesystems named in | | 126 | Ask the automounter to unmount the filesystems named in |
127 | .I directory | | 127 | .I directory |
128 | instead of providing | | 128 | instead of providing |
129 | information about them. Unmounts are requested, not forced. They merely | | 129 | information about them. Unmounts are requested, not forced. They merely |
130 | cause the mounted filesystem to timeout, which will be picked up by | | 130 | cause the mounted filesystem to timeout, which will be picked up by |
131 | .BR amd 's | | 131 | .BR amd 's |
132 | main scheduler thus causing the normal timeout action to be taken. | | 132 | main scheduler thus causing the normal timeout action to be taken. |
133 | | | 133 | |
134 | .TP | | 134 | .TP |
135 | .B \-v | | 135 | .B \-v |
136 | Ask the automounter for its version information. This is a subset of the | | 136 | Ask the automounter for its version information. This is a subset of the |
137 | information output by | | 137 | information output by |
138 | .BR amd 's | | 138 | .BR amd 's |
139 | .I -v | | 139 | .I -v |
140 | option. | | 140 | option. |
141 | | | 141 | |
142 | .TP | | 142 | .TP |
143 | .B \-w | | 143 | .B \-w |
144 | Translate a full pathname as returned by | | 144 | Translate a full pathname as returned by |
145 | .IR getcwd (3) | | 145 | .IR getcwd (3) |
146 | into a short | | 146 | into a short |
147 | .B Amd | | 147 | .B Amd |
148 | pathname that goes through its mount points. This option requires that | | 148 | pathname that goes through its mount points. This option requires that |
149 | .B Amd | | 149 | .B Amd |
150 | is running. | | 150 | is running. |
151 | | | 151 | |
152 | .TP | | 152 | .TP |
153 | .BI \-x " log_options" | | 153 | .BI \-x " log_options" |
154 | Ask the automounter to use the logging options specified in | | 154 | Ask the automounter to use the logging options specified in |
155 | .I log_options | | 155 | .I log_options |
156 | from now on. Note that the "fatal" and "error" options cannot be turned | | 156 | from now on. Note that the "fatal" and "error" options cannot be turned |
157 | off. | | 157 | off. |
158 | | | 158 | |
159 | .TP | | 159 | .TP |
160 | .BI \-D " debug_options" | | 160 | .BI \-D " debug_options" |
161 | Ask the automounter to use the debugging options specified in | | 161 | Ask the automounter to use the debugging options specified in |
162 | .I debug_options | | 162 | .I debug_options |
163 | from now on. | | 163 | from now on. |
164 | | | 164 | |
165 | .TP | | 165 | .TP |
166 | .B \-H | | 166 | .B \-H |
167 | Display short usage message. | | 167 | Display short usage message. |
168 | | | 168 | |
169 | .TP | | 169 | .TP |
170 | .BI \-P " program_number" | | 170 | .BI \-P " program_number" |
171 | Contact an alternate running amd that had registered itself on a different | | 171 | Contact an alternate running amd that had registered itself on a different |
172 | RPC | | 172 | RPC |
173 | .I program_number | | 173 | .I program_number |
174 | and apply all other operations to that instance of the automounter. This is | | 174 | and apply all other operations to that instance of the automounter. This is |
175 | useful when you run multiple copies of amd, and need to manage each | | 175 | useful when you run multiple copies of amd, and need to manage each |
176 | one separately. If not specified, amq will use the default program number | | 176 | one separately. If not specified, amq will use the default program number |
177 | for amd, 300019. For security reasons, the only alternate program numbers | | 177 | for amd, 300019. For security reasons, the only alternate program numbers |
178 | amd can use range from 300019 to 300029, inclusive. | | 178 | amd can use range from 300019 to 300029, inclusive. |
179 | | | 179 | |
180 | .TP | | 180 | .TP |
181 | .B \-T | | 181 | .B \-T |
182 | Contact | | 182 | Contact |
183 | .B amd | | 183 | .B amd |
184 | using the TCP transport only. Normally | | 184 | using the TCP transport only. Normally |
185 | .B amq | | 185 | .B amq |
186 | will try TCP, and if that failed, will try UDP. | | 186 | will try TCP, and if that failed, will try UDP. |
187 | | | 187 | |
188 | .TP | | 188 | .TP |
189 | .B \-U | | 189 | .B \-U |
190 | Contact | | 190 | Contact |
191 | .B amd | | 191 | .B amd |
192 | using UDP (connectionless) transport only. Normally | | 192 | using UDP (connectionless) transport only. Normally |
193 | .B amq | | 193 | .B amq |
194 | will try TCP, and if that failed, will try UDP. | | 194 | will try TCP, and if that failed, will try UDP. |
195 | | | 195 | |
196 | .SH FILES | | 196 | .SH FILES |
197 | .TP 20 | | 197 | .TP 20 |
198 | .B amq.x | | 198 | .B amq.x |
199 | .SM RPC | | 199 | .SM RPC |
200 | protocol description. | | 200 | protocol description. |
201 | | | 201 | |
202 | .SH CAVEATS | | 202 | .SH CAVEATS |
203 | .B Amq | | 203 | .B Amq |
204 | uses a Sun registered | | 204 | uses a Sun registered |
205 | .SM RPC | | 205 | .SM RPC |
206 | program number (300019 decimal) which may not | | 206 | program number (300019 decimal) which may not |
207 | be in the /etc/rpc database. | | 207 | be in the /etc/rpc database. |
208 | .PP | | 208 | .PP |
209 | If the TCP wrappers library is available, and the | | 209 | If the TCP wrappers library is available, and the |
210 | .B use_tcpwrappers | | 210 | .B use_tcpwrappers |
211 | global | | 211 | global |
212 | .B amd.conf | | 212 | .B amd.conf |
213 | option is set to ``yes'', then | | 213 | option is set to ``yes'', then |
214 | .B amd | | 214 | .B amd |
215 | will verify that the host running | | 215 | will verify that the host running |
216 | .B amq | | 216 | .B amq |
217 | is authorized to connect. The | | 217 | is authorized to connect. The |
218 | .I amd | | 218 | .I amd |
219 | service name must used in the | | 219 | service name must used in the |
220 | .B /etc/hosts.allow | | 220 | .B /etc/hosts.allow |
221 | and | | 221 | and |
222 | .B /etc/hosts.deny | | 222 | .B /etc/hosts.deny |
223 | files. For example, to allow only localhost to connect to | | 223 | files. For example, to allow only localhost to connect to |
224 | .B amd, | | 224 | .B amd, |
225 | add this line to | | 225 | add this line to |
226 | .B /etc/hosts.allow: | | 226 | .B /etc/hosts.allow: |
227 | .PP | | 227 | .PP |
228 | .RS | | 228 | .RS |
229 | amd: localhost | | 229 | amd: localhost |
230 | .RE | | 230 | .RE |
231 | .PP | | 231 | .PP |
232 | and this line to | | 232 | and this line to |
233 | .B /etc/hosts.deny: | | 233 | .B /etc/hosts.deny: |
234 | .PP | | 234 | .PP |
235 | .RS | | 235 | .RS |
236 | amd: ALL | | 236 | amd: ALL |
237 | .RE | | 237 | .RE |
238 | | | 238 | |
239 | .SH "SEE ALSO" | | 239 | .SH "SEE ALSO" |
240 | .BR amd (8), | | 240 | .BR amd (8), |
241 | .BR ctl-amd (8), | | 241 | .\" .BR ctl-amd (8), |
242 | .BR amd.conf (5), | | 242 | .BR amd.conf (5), |
243 | .BR hosts_access (5). | | 243 | .BR hosts_access (5). |
244 | .LP | | 244 | .LP |
245 | ``am-utils'' | | 245 | ``am-utils'' |
246 | .BR info (1) | | 246 | .BR info (1) |
247 | entry. | | 247 | entry. |
248 | .LP | | 248 | .LP |
249 | .I "Linux NFS and Automounter Administration" | | 249 | .I "Linux NFS and Automounter Administration" |
250 | by Erez Zadok, ISBN 0-7821-2739-8, (Sybex, 2001). | | 250 | by Erez Zadok, ISBN 0-7821-2739-8, (Sybex, 2001). |
251 | .LP | | 251 | .LP |
252 | .I http://www.am-utils.org | | 252 | .I http://www.am-utils.org |
253 | .LP | | 253 | .LP |
254 | .I "Amd \- The 4.4 BSD Automounter" | | 254 | .I "Amd \- The 4.4 BSD Automounter" |
255 | | | 255 | |
256 | .SH AUTHORS | | 256 | .SH AUTHORS |
257 | Jan-Simon Pendry <jsp@doc.ic.ac.uk>, Department of Computing, Imperial College, London, UK. | | 257 | Jan-Simon Pendry <jsp@doc.ic.ac.uk>, Department of Computing, Imperial College, London, UK. |
258 | .P | | 258 | .P |
259 | Erez Zadok <ezk@cs.sunysb.edu>, Computer Science Department, Stony Brook | | 259 | Erez Zadok <ezk@cs.sunysb.edu>, Computer Science Department, Stony Brook |
260 | University, Stony Brook, New York, USA. | | 260 | University, Stony Brook, New York, USA. |
261 | .P | | 261 | .P |
262 | Other authors and contributors to am-utils are listed in the | | 262 | Other authors and contributors to am-utils are listed in the |
263 | .B AUTHORS | | 263 | .B AUTHORS |
264 | file distributed with am-utils. | | 264 | file distributed with am-utils. |