1.\" 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. 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, with or without 12.\" modification, are permitted provided that the following conditions 13.\" are met: 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. 26.\" 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 37.\" SUCH DAMAGE. 38.\" 39.\" %W% (Berkeley) %G% 40.\" 41.\" $Id: fixmount.8,v 1.12.2.1 2006/01/02 18:48:25 ezk Exp $ 42.\" $FreeBSD$ 43.\" 44.Dd January 2, 2006 45.Dt FIXMOUNT 8 46.Os 47.Sh NAME 48.Nm fixmount 49.Nd fix remote mount entries 50.Sh SYNOPSIS 51.Nm 52.Op Fl adervq 53.Op Fl h Ar name 54.Ar host ... 55.Sh DESCRIPTION 56The 57.Nm 58utility 59is a variant of 60.Xr showmount 8 61that can delete bogus mount entries in remote 62.Xr mountd 8 63daemons. 64The actions specified by the options are performed for each 65.Ar host 66in turn. 67.Sh OPTIONS 68.Bl -tag -width indent 69.It Fl a , d , e 70These options work as in 71.Xr showmount 8 72except that only entries pertaining to the local host are printed. 73.It Fl r 74Removes those remote mount entries on 75.Ar host 76that do not correspond to current mounts, i.e., which are left-over 77from a crash or are the result of improper mount protocol. 78The actuality of mounts is verified using the entries in 79.Pa /etc/mtab . 80.It Fl v 81Verify remote mounts. 82Similar to 83.Fl r 84except that only a notification message is printed for each bogus entry 85found. 86The remote mount table is not changed. 87.It Fl A 88Issues a command to the remote mountd declaring that 89.Em all 90of its file systems have been unmounted. 91This should be used with caution, as it removes all 92remote mount entries pertaining to the local system, whether or not any 93file systems are still mounted locally. 94.It Fl q 95Be quiet. 96Suppresses error messages due to timeouts and 97.Dq Li "Program not registered" , 98i.e., due to remote hosts not supporting RPC or not running 99.Xr mountd 8 . 100.It Fl h Ar name 101Pretend the local hostname is 102.Ar name . 103This is useful after the local hostname has been changed and rmtab entries 104using the old name remain on a remote machine. 105Unfortunately, most mountd's will not be able to successfully handle removal 106of such entries, so this option is useful in combination with 107.Fl v 108only. 109.Pp 110This option also saves time as comparisons of remotely recorded and local 111hostnames by address are avoided. 112.El 113.Sh FILES 114.Bl -tag -width ".Pa /etc/rmtab" 115.It Pa /etc/mtab 116List of current mounts. 117.It Pa /etc/rmtab 118Backup file for remote mount entries on 119.Tn NFS 120server. 121.El 122.Sh SEE ALSO 123.Xr mtab 5 , 124.Xr rmtab 5 , 125.Xr mountd 8 , 126.Xr showmount 8 127.Pp 128.Dq am-utils 129.Xr info 1 130entry. 131.Rs 132.%A Erez Zadok 133.%B "Linux NFS and Automounter Administration" 134.%O ISBN 0-7821-2739-8 135.%I Sybex 136.%D 2001 137.Re 138.Pp 139.Pa http://www.am-utils.org/ 140.Rs 141.%T Amd \- The 4.4 BSD Automounter 142.Re 143.Sh HISTORY 144The 145.Nm 146utility appeared in 147.Fx 3.0 . 148.Sh AUTHORS 149.An Jan-Simon Pendry Aq jsp@doc.ic.ac.uk , 150Department of Computing, Imperial College, London, UK. 151.Pp 152.An Erez Zadok Aq ezk@cs.columbia.edu , 153Department of Computer Science, Columbia University, New York, USA. 154.Pp 155.An Other authors and contributors to 156.Nm am-utils 157are listed in the 158.Pa AUTHORS 159file distributed with 160.Nm am-utils . 161.Sh AUTHORS 162.An Andreas Stolcke Aq stolcke@icsi.berkeley.edu 163.Pp 164.An Erez Zadok Aq ezk@cs.sunysb.edu , 165Computer Science Department, Stony Brook University, Stony Brook, New York, USA. 166.Pp 167Other authors and contributors to am-utils are listed in the 168.Pa AUTHORS 169file distributed with am-utils. 170.Sh BUGS 171No attempt is made to verify the information in 172.Pa /etc/mtab 173itself. 174.Pp 175Since swap file mounts are not recorded in 176.Pa /etc/mtab , 177a heuristic specific to SunOS is used to determine whether such a mount 178is actual (replacing the string 179.Dq Li swap 180with 181.Dq Li root 182and verifying the resulting path). 183.Pp 184Symbolic links on the server will cause the path in the remote entry to differ 185from the one in 186.Pa /etc/mtab . 187To catch those cases, a file system is also deemed mounted if its 188.Em local 189mount point is identical to the remote entry. 190I.e., on a SunOS diskless client, 191.Pa server:/export/share/sunos.4.1.1 192is actually 193.Pa /usr/share . 194Since the local mount point is 195.Pa /usr/share 196as well this will be handled correctly. 197.Pp 198There is no way to clear a stale entry in a remote 199.Xr mountd 8 200after the 201local hostname (or whatever reverse name resolution returns for it) 202has been changed. 203To take care of these cases, 204the remote 205.Pa /etc/rmtab 206file has to be edited and 207.Xr mountd 8 208restarted. 209.Pp 210The RPC timeouts for 211.Xr mountd 8 212calls can only be changed by recompiling. 213The defaults are 2 seconds for client handle creation and 5 seconds for 214RPC calls. 215