.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "FS_RMMOUNT 1"
.TH FS_RMMOUNT 1 2024-03-20 OpenAFS "AFS Command Reference"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
fs_rmmount \- Removes a mount point
.SH SYNOPSIS
.IX Header "SYNOPSIS"
\&\fBfs rmmount\fR \fB\-dir\fR\ <\fIdirectory\fR>+ [\fB\-help\fR]
.PP
\&\fBfs rm\fR \fB\-d\fR\ <\fIdirectory\fR>+ [\fB\-h\fR]
.SH DESCRIPTION
.IX Header "DESCRIPTION"
The fs rmmount command removes the mount point named by the \fB\-dir\fR
argument from the file system. The corresponding volume remains on its
host partition or partitions, but is inaccessible if there are no other
mount points for it.
.SH OPTIONS
.IX Header "OPTIONS"
.IP "\fB\-dir\fR <\fIdirectory\fR>+" 4
.IX Item "-dir <directory>+"
Names the mount point to delete from the file system. The last element in
the pathname must be an actual name, not a shorthand notation such as
"dot" (\f(CW\*(C`.\*(C'\fR) or "dot dot" (\f(CW\*(C`..\*(C'\fR).
.Sp
Specify the read/write path to the directory, to avoid the failure that
results from attempting to delete a mount point from a read-only
volume. By convention, the read/write path is indicated by placing a
period before the cell name at the pathname's second level (for example,
\&\fI/afs/.example.com\fR). For further discussion of the concept of read/write and
read-only paths through the filespace, see the \fBfs mkmount\fR reference
page.
.IP \fB\-help\fR 4
.IX Item "-help"
Prints the online help for this command. All other valid options are
ignored.
.SH EXAMPLES
.IX Header "EXAMPLES"
The following command removes the mount points \fIjones\fR and \fIterry\fR from
the current working directory (the \fI/afs/example.com/usr\fR directory).
.PP
.Vb 1
\&   % fs rmmount jones terry
.Ve
.SH "PRIVILEGE REQUIRED"
.IX Header "PRIVILEGE REQUIRED"
The issuer must have the \f(CW\*(C`d\*(C'\fR (delete) permission on the ACL of the
directory that houses each mount point.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBfs_lsmount\fR\|(1),
\&\fBfs_mkmount\fR\|(1)
.SH COPYRIGHT
.IX Header "COPYRIGHT"
IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
.PP
This documentation is covered by the IBM Public License Version 1.0.  It was
converted from HTML to POD by software written by Chas Williams and Russ
Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.