| amq.8 (38840) | amq.8 (39087) |
|---|---|
| 1.\" 2.\" Copyright (c) 1997-1998 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. 7.\" 8.\" This code is derived from software contributed to Berkeley by --- 24 unchanged lines hidden (view full) --- 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 37.\" SUCH DAMAGE. 38.\" 39.\" %W% (Berkeley) %G% 40.\" | 1.\" 2.\" Copyright (c) 1997-1998 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. 7.\" 8.\" This code is derived from software contributed to Berkeley by --- 24 unchanged lines hidden (view full) --- 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 37.\" SUCH DAMAGE. 38.\" 39.\" %W% (Berkeley) %G% 40.\" |
| 41.\" $Id: amq.8,v 1.1.1.1 1998/08/23 22:07:20 obrien Exp $ | 41.\" $Id: amq.8,v 1.2 1998/09/05 06:38:19 obrien Exp $ |
| 42.\" | 42.\" |
| 43.TH AMQ 8 "25 April 1989" 44.SH NAME 45amq \- automounter query tool 46.SH SYNOPSIS 47.B amq 48[ 49.BI \-fmpsuvTU 50] [ 51.BI \-h " hostname" 52] [ 53.BI \-l " log_file" 54] [ 55.BI \-x " log_options" 56] [ 57.BI \-D " debug_options" 58] [ 59.BI \-M " mountmap entry" 60] [ 61.BI \-P " program_number" 62] [ 63.I directory 64] .\|.\|. 65.SH DESCRIPTION 66.B Amq 67provides a simple way of determining the current state of 68.B amd | 43.Dd March 16, 1991 44.Dt AMQ 8 45.Os 46.Sh NAME 47.Nm amq 48.Nd automounter query tool 49.Sh SYNOPSIS 50.Nm amq 51.Op Fl fmpsuvTU 52.Op Fl h Ar hostname 53.Op Fl l Ar log_file 54.Op Fl x Ar log_options 55.Op Fl D Ar debug_options 56.Op Fl M Ar mountmap_entry 57.Op Fl P Ar program_number 58.Op Ar directory 59.Ar ... 60.Sh DESCRIPTION 61.Nm Amq 62provides a simple way of determining the current state of the 63.Xr amd 8 |
| 69program. 70Communication is by | 64program. 65Communication is by |
| 71.SM RPC. 72Three modes of operation are supported by the current protocol. By default 73a list of mount points and auto-mounted filesystems is output. An 74alternative host can be specified using the 75.I \-h | 66.Tn RPC . 67Three modes of operation are supported by the current protocol. 68By default a list of mount points and auto-mounted filesystems 69is output. 70An alternative host can be specified using the 71.Fl h |
| 76option. | 72option. |
| 77.LP 78If 79.I directory 80names are given, as output by default, then per-filesystem 81information is displayed. 82.SH OPTIONS 83 84.TP 85.B \-f 86Ask the automounter to flush the internal caches. 87 88.TP 89.BI \-h " hostname" 90Specify an alternate host to query. By default the local host is used. In 91an 92.SM HP-UX 93cluster, the root server is queried by default, since that is the system on 94which the automounter is normally run. 95 96.TP 97.BI \-l " log_file" | 73.Pp 74If directory names are given, as output by default, 75then per-filesystem information is displayed. 76.Sh OPTIONS 77.Bl -tag -width Ds 78.It Fl f 79Request automounter to flush the internal caches. 80.It Fl h Ar hostname 81Query alternate host 82.Ar hostname . 83By default the local host is used. In an 84.Tn HP-UX 85cluster, the root server is queried by default, since 86that is the system on which the automounter is normally run. 87.It Fl l Ar log_file |
| 98Tell amd to use | 88Tell amd to use |
| 99.I log_file 100as the log file name. For security reasons, this must be the same log file 101which amd used when started. This option is therefore only useful to 102refresh amd's open file handle on the log file, so that it can be rotated 103and compressed via daily cron jobs. 104 105.TP 106.B \-m 107Ask the automounter to provide a list of mounted filesystems, including the 108number of references to each filesystem and any error which occurred while 109mounting. 110 111.TP 112.B \-p 113Return the process ID of the remote or locally running amd. Useful when you 114need to send a signal to the local amd process, and would rather not have to 115search through the process table. This option is used in the 116.I ctl-amd | 89.Ar log_file 90as the log file name. 91For security reasons, this must be the same log file which 92.Nm amd 93used when started. This option is therefore only useful to 94refresh 95.Nm amd's 96open file handle on the log file, so that it can be rotated and compressed via 97daily cron jobs. 98.It Fl m 99Request the automounter to provide a list of mounted filesystems, 100including the number of references to each filesystem and any error 101which occurred while mounting. 102.It Fl p 103Return the process ID of the remote or locally running 104.Nm amd . 105Useful when you need to send a signal to the local 106.Nm amd 107process, and would rather not have to search through the process table. This 108option is used in the 109.Pa ctl-amd |
| 117script. | 110script. |
| 118 119.TP 120.B \-s 121Ask the automounter to provide system-wide mount statistics. 122 123.TP 124.B \-u 125Ask the automounter to unmount the filesystems named in 126.I directory 127instead of providing 128information about them. Unmounts are requested, not forced. They merely 129cause the mounted filesystem to timeout, which will be picked up by 130.BR amd 's | 111.It Fl s 112Request the automounter to provide system-wide mount statistics. 113.It Fl u 114Request the automounter to unmount the named filesystems 115instead of providing information about them. Unmounts are requested, 116not forced. They merely cause the mounted filesystem to timeout, 117which will be picked up by 118.Nm amd Ns \'s |
| 131main scheduler thus causing the normal timeout action to be taken. | 119main scheduler thus causing the normal timeout action to be taken. |
| 132 133.TP 134.B \-v 135Ask the automounter for its version information. This is a subset of the 136information output by 137.BR amd 's 138.I -v | 120.It Fl v 121Request the automounter to provide version information. This is a subset 122of the information provided by 123.Nm amd Ns \'s Fl v |
| 139option. | 124option. |
| 140 141.TP 142.BI \-x " log_options" 143Ask the automounter to use the logging options specified in 144.I log_options | 125.It Fl x Ar log_options 126Ask the automounter to use the logging options specified in 127.Ar log_options |
| 145from now on. | 128from now on. |
| 146 147.TP 148.BI \-D " log_options" 149Ask the automounter to use the debugging options specified in 150.I debug_options | 129.It Fl D Ar log_options 130Ask the automounter to use the debugging options specified in 131.Ar debug_options |
| 151from now on. | 132from now on. |
| 152 153.TP 154.BI \-M " map_ent" 155Pass a mount map entry to 156.B amd 157and wait for it to be evaluated, possible causing a mount. This option is 158highly insecure. By default, amd and amq do not support it. You have to 159configure am-utils with 160.I \-\-enable\-amq\-mount | 133.It Fl M 134Pass a mount map entry to 135.Nm amd 136and wait for it to be evaluated, possibly causing a mount. 137This option is highly insecure. 138By default, 139.Nm amd 140and 141.Nm amq 142do not support it. 143It is necessary to configure 144.Nm am-utils 145with 146.Ar --enable-amq-mount |
| 161to enable this option. | 147to enable this option. |
| 162 163.TP 164.BI \-P " program_number" 165Contact an alternate running amd that had registered itself on a different 166RPC 167.I program_number 168and apply all other operations to that instance of the automounter. This is 169useful when you run multiple copies of amd, and need to manage each 170one separately. If not specified, amq will use the default program number 171for amd, 300019. For security reasons, the only alternate program numbers 172amd can use range from 300019 to 300029, inclusive. 173 174.TP 175.B \-T | 148.It Fl P Ar program_number 149Contact an alternate running 150.Nm amd 151that had registered itself on a different RPC 152.Ar program_number 153and apply all other operations to that instance of the automounter. 154This is useful when running multiple copies of 155.Nmamd , 156and need to manage each one separately. 157If not specified, 158.Nm amq 159will use the default program number for 160.Nm amd , 161300019. 162For security reasons, the only alternate program numbers 163.Nm amd 164can use range from 300019 to 300029, inclusive. 165.It Fl T |
| 176Contact | 166Contact |
| 177.B amd 178using the TCP transport only. Normally 179.B amq 180will try TCP, and if that failed, will try UDP. 181 182.TP 183.B \-U 184Contact 185.B amd 186using UDP (connectionless) transport only. Normally 187.B amq 188will try TCP, and if that failed, will try UDP. 189 190.SH FILES 191.PD 0 192.TP 20 193.B amq.x 194.SM RPC | 167.Nm amd 168using the TCP transport only. 169Normally 170.Nm amq 171will try TCP, and if that fails, will try UDP. 172.It Fl U 173Contact 174.Nm amd 175using UDP (connectionless) transport only. 176Normally 177.Nm amq 178will try TCP, and if that fails, will try UDP. 179.El 180.Sh FILES 181.Bl -tag -width amq.xxxxx -compact 182.Bl -tag -width Ds 183.It Pa amq.x 184.Tn RPC |
| 195protocol description. | 185protocol description. |
| 196.SH CAVEATS 197.B Amq | 186.El 187.Sh CAVEATS 188.Nm Amq |
| 198uses a Sun registered | 189uses a Sun registered |
| 199.SM RPC | 190.Tn RPC |
| 200program number (300019 decimal) which may not | 191program number (300019 decimal) which may not |
| 201be in the /etc/rpc database. 202.SH "SEE ALSO" 203.BR amd.conf (5). 204.BR amd (8), 205.BR ctl-amd (8), 206.SH AUTHORS 207Jan-Simon Pendry <jsp@doc.ic.ac.uk>, Department of Computing, Imperial College, London, UK. 208.P 209Erez Zadok <ezk@cs.columbia.edu>, Department of Computer Science, Columbia 210University, New York, USA. 211.P 212Other authors and contributors to am-utils are listed in the 213.B AUTHORS 214file distributed with am-utils. | 192be in the 193.Pa /etc/rpc 194database. 195.Sh SEE ALSO 196.Xr amd.conf 8 , 197.Xr amd 8 , 198.Xr ctl-amd 8 199.Sh AUTHORS 200.An Jan-Simon Pendry Aq jsp@doc.ic.ac.uk , 201Department of Computing, Imperial College, London, UK. 202.Pp 203.An Erez Zadok Aq ezk@cs.columbia.edu , 204Department of Computer Science, Columbia University, New York, USA. 205.Pp 206.An Other authors and contributors to 207.Nm am-utils 208are listed in the 209.Nm AUTHORS 210file distributed with 211.Nm am-utils . 212.Sh HISTORY 213.Nm Amq 214first appeared in 4.4BSD. 215.At |