summaryrefslogtreecommitdiffstats
path: root/contrib/amd/fixmount/fixmount.8
diff options
context:
space:
mode:
Diffstat (limited to 'contrib/amd/fixmount/fixmount.8')
-rw-r--r--contrib/amd/fixmount/fixmount.8159
1 files changed, 159 insertions, 0 deletions
diff --git a/contrib/amd/fixmount/fixmount.8 b/contrib/amd/fixmount/fixmount.8
new file mode 100644
index 0000000..f9a87f0
--- /dev/null
+++ b/contrib/amd/fixmount/fixmount.8
@@ -0,0 +1,159 @@
+.\"
+.\" Copyright (c) 1997-1998 Erez Zadok
+.\" Copyright (c) 1990 Jan-Simon Pendry
+.\" Copyright (c) 1990 Imperial College of Science, Technology & Medicine
+.\" Copyright (c) 1990 The Regents of the University of California.
+.\" All rights reserved.
+.\"
+.\" This code is derived from software contributed to Berkeley by
+.\" Jan-Simon Pendry at Imperial College, London.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in the
+.\" documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\" must display the following acknowledgment:
+.\" This product includes software developed by the University of
+.\" California, Berkeley and its contributors.
+.\" 4. Neither the name of the University nor the names of its contributors
+.\" may be used to endorse or promote products derived from this software
+.\" without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.\" %W% (Berkeley) %G%
+.\"
+.\" $Id: fixmount.8,v 5.2.2.1 1992/02/09 15:11:15 jsp beta $
+.\"
+.TH FIXMOUNT 8L "26 Feb 1993"
+.SH NAME
+fixmount \- fix remote mount entries
+.SH SYNOPSIS
+.B fixmount
+[
+.B \-adervq
+]
+[
+.B \-h
+.I name
+]
+.I host
+\&...
+.SH DESCRIPTION
+.IX "fixmount command" "" "\fLfixmount\fP \(em fix remote mount entries"
+.LP
+.B fixmount
+is a variant of
+.BR showmount (8)
+that can delete bogus mount entries in remote
+.BR mountd (8C)
+daemons.
+The actions specified by the options are performed for each
+.I host
+in turn.
+.SH OPTIONS
+.TP
+.B \-a \-d \-e
+These options work as in
+.BR showmount (8)
+except that only entries pertaining to the local host are printed.
+.TP
+.B \-r
+Removes those remote mount entries on
+.I host
+that do not correspond to current mounts, i.e., which are left-over
+from a crash or are the result of improper mount protocol.
+The actuality of mounts is verified using the entries in
+.BR /etc/mtab .
+.TP
+.B \-v
+Verify remote mounts. Similar to
+.B \-r
+except that only a notification message is printed for each bogus entry
+found. The remote mount table is not changed.
+.TP
+.B \-A
+Issues a command to the remote mountd declaring that ALL of its filesystems
+have been unmounted. This should be used with caution, as it removes all
+remote mount entries pertaining to the local system, whether or not any
+filesystems are still mounted locally.
+.TP
+.B \-q
+Be quiet.
+Suppresses error messages due to timeouts and "Program not registered",
+i.e., due to remote hosts not supporting RPC or not running mountd.
+.TP
+.BI \-h \ name
+Pretend the local hostname is
+.IR name .
+This is useful after the local hostname has been changed and rmtab entries
+using the old name remain on a remote machine.
+Unfortunately, most mountd's won't be able to successfully handle removal
+of such entries, so this option is useful in combination with
+.B \-v
+only.
+.br
+This option also saves time as comparisons of remotely recorded and local
+hostnames by address are avoided.
+.SH FILES
+.PD 0
+.TP 20
+.B /etc/mtab
+List of current mounts.
+.TP
+.B /etc/rmtab
+Backup file for remote mount entries on NFS server.
+.PD
+.SH "SEE ALSO"
+.BR showmount (8),
+.BR mtab (5),
+.BR rmtab (5),
+.BR mountd (8C).
+.SH BUGS
+No attempt is made to verify the information in
+.B /etc/mtab
+itself.
+.PP
+Since swap file mounts are not recorded in
+.BR /etc/mtab ,
+a heuristic specific to SunOS is used to determine whether such a mount
+is actual (replacing the string "swap" with "root" and verifying the resulting
+path).
+.PP
+Symbolic links on the server will cause the path in the remote entry to differ
+from the one in
+.BR /etc/mtab .
+To catch those cases, a filesystem is also deemed mounted if its
+.I local
+mount point is identical to the remote entry.
+I.e., on a SunOS diskless client,
+.B server:/export/share/sunos.4.1.1
+is actually
+.BR /usr/share .
+Since the local mount point is
+.B /usr/share
+as well this will be handled correctly.
+.PP
+There is no way to clear a stale entry in a remote mountd after the
+local hostname (or whatever reverse name resolution returns for it)
+has been changed. To take care of these cases,
+the remote /etc/rmtab file has to be edited and mountd restarted.
+.PP
+The RPC timeouts for mountd calls can only be changed by recompiling.
+The defaults are 2 seconds for client handle creation and 5 seconds for
+RPC calls.
OpenPOWER on IntegriCloud