.\" -*- 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_FLUSHMOUNT 1"
.TH FS_FLUSHMOUNT 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_flushmount \- Forces the Cache Manager to discard a mount point
.SH SYNOPSIS
.IX Header "SYNOPSIS"
\&\fBfs flushmount\fR [\fB\-path\fR\ <\fIdir/file\ path\fR>+] [\fB\-help\fR]
.PP
\&\fBfs flushm\fR [\fB\-p\fR\ <\fIdir/file\ path\fR>+] [\fB\-h\fR]
.SH DESCRIPTION
.IX Header "DESCRIPTION"
The \fBfs flushmount\fR command removes from the cache all information
associated with each mount point named by the \fB\-path\fR argument. The next
time an application accesses the mount point, the Cache Manager fetches
the most current version of it from the File Server. Data cached from the
associated volume is not affected.
.PP
The command's intended use is to discard information about mount points
that has become corrupted in the cache. (The Cache Manager periodically
refreshes cached mount points, but the only other way to discard them
immediately is to reinitialize the Cache Manager by rebooting the
machine.) Symptoms of a corrupted mount point included garbled output from
the \fBfs lsmount\fR command, and failed attempts to change directory to or
list the contents of a mount point.
.PP
To flush cached data rather than a mount point, use the \fBfs flush\fR or
\&\fBfs flushvolume\fR command.
.SH OPTIONS
.IX Header "OPTIONS"
.IP "\fB\-path\fR <\fIdir/file path\fR>+" 4
.IX Item "-path <dir/file path>+"
Names each mount point to flush from the cache. Partial pathnames are
interpreted relative to the current working directory, which is also the
default value if this argument is omitted.
.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 flushes from the cache the mount point for user
\&\f(CW\*(C`pat\*(C'\fR's home directory:
.PP
.Vb 1
\&   % fs flushm /afs/example.com/usr/pat
.Ve
.SH "PRIVILEGE REQUIRED"
.IX Header "PRIVILEGE REQUIRED"
The issuer must have the \f(CW\*(C`l\*(C'\fR (lookup) permission on the ACL of the root
directory of the volume that houses the file or directory named by the
\&\fB\-path\fR argument, and on the ACL of each directory that precedes it in
the pathname.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBfs_flush\fR\|(1),
\&\fBfs_flushvolume\fR\|(1),
\&\fBfs_lsmount\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.