FreeBSD manual

download PDF document: rpc.umntall.8.pdf

RPC.UMNTALL(8) FreeBSD System Manager's Manual RPC.UMNTALL(8)
NAME rpc.umntall - notify NFS servers about unmounted NFS file systems
SYNOPSIS rpc.umntall [-e expire] [-h host] [-k] [-p remotepath] [-v]
DESCRIPTION The rpc.umntall utility is proposed in the NFS RPC specification; see NFS Version 3 Protocol Specification, RFC 1813, Appendix I. It uses remote procedure calls to remove mount entries from /var/db/mountdtab on the remote NFS server. It is called automatically without any parameters during startup and shutdown of the system. This ensures that showmount(8) does not display old and expired entries. The rpc.umntall utility is only needed on client side, where mount_nfs(8) adds a mount entry with the current date to /var/db/mounttab, and umount(8) removes the entry again. The rpc.umntall utility cares about all remaining entries in this table which result from crashes or unproper shutdowns.
The options are as follows:
-e expire All entries which are not actually mounted or older than expire (seconds) are removed from /var/db/mounttab. This may be the case for DNS changes or long out of service periods. Default expire time is 86400 seconds (one day).
-h host Only remove the specific hostname. Send a UMNTALL RPC to the NFS server.
-k Keep entries for existing NFS file systems. Compare the NFS file systems from the mounttab against the kernel mountlist and do not send the RPC to existing mount entries. Useful during startup of the system. It may be possible that there are already mounted NFS file systems, so calling RPC UMOUNT is not a good idea. This is the case if the user has rebooted to 'single user mode' and starts up the system again.
-p path Only remove the specific mount-path. Send a UMOUNT RPC to the NFS server. This option implies the -host option.
-v Verbose, additional information is printed for each processed mounttab entry.
FILES /var/db/mounttab mounted nfs-file systems
SEE ALSO mount_nfs(8), mountd(8), umount(8)
HISTORY The rpc.umntall utility first appeared in FreeBSD 4.0.
AUTHORS Martin Blapp <mb@imp.ch>
FreeBSD 14.0-RELEASE-p11 November 17, 1999 FreeBSD 14.0-RELEASE-p11