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