contrib/amd/fixmount/fixmount.8

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