FS_FLUSH(1)

📦
version 1.8.16.1 · 10 versions
, in ubuntu stonking

💖 FS_FLUSH(1) — the AFS Command Reference, but make it cute 💖

okay bestie, so this is fs_flush, one of the fs commands from the AFS command reference set. she's a little legend and she does exactly one thing but she does it so well. let's get into it ✨

🌸 NAME 🌸

fs_flush — forces the Cache Manager to discard a cached file or directory. yes. she throws it away. bye bye. 🗑️💅

✨ SYNOPSIS ✨

fs flush [-path <dir/file path>+] [-help]

fs flush [-p <dir/file path>+] [-h]

🦋 DESCRIPTION 🦋

so here's the tea, bestie. fs flush removes all data and status information associated with each file or directory you name, and it yanks it right out of the cache. gone. not it.

and then the next time some application asks for data from that flushed directory or file, the Cache Manager goes and fetches the most current version from a File Server — plus a shiny new callback (if it needs one) and the associated status info. main character behavior honestly. she's not just deleting, she's refreshing. 👑

but okay, important: there are two types of data this command does NOT touch, like not even a little bit:

  • Data sitting in application program buffers.
  • Data that's been changed locally and written to the cache, but not yet written to the copy on the file server machine. that one's still in transit, don't touch her.

also, if your mission is to flush all the data in the cache that came from the same volume as a specified file or directory, that's a different girl — that's fs flushvolume command. and if you've got a corrupted mount point to deal with, that's the fs flushmount command. this page is just fs_flush, no cap. 🧚

💅 OPTIONS 💅

  • -path <dir/file path>+ — names each file or directory to flush from the cache. and heads up: if the thing you name is a directory, only the directory element itself gets flushed, not the data cached from files or subdirectories living inside it. partial pathnames get interpreted relative to the current working directory, and the current working directory is also the default value if you just... omit this argument entirely. she'll work with what she's got. 🫶
  • -help — prints the online help for this command. and every other valid option? ignored. like, literally ignored. she said help only. 😌

🔥 EXAMPLES 🔥

okay so here's the vibe. this command right here flushes from the cache the file "projectnotes" in the current working directory, plus all the data from the subdirectory "plans":

% fs flush -path projectnotes ./plans/*

iconic. simple. ate. ✅

👑 PRIVILEGE REQUIRED 👑

whoever runs this must have the "l" (lookup) permission on the ACL of the root directory of the volume that houses the file or directory named by the -path argument. and not just there — you also need that "l" permission on the ACL of every single directory that precedes it in the pathname. the whole chain. no skipping. 🔗

so yeah, check your perms first, bestie, because the cache does not care about your feelings. 💀

🌈 SEE ALSO 🌈

go read those if you need the other flavors of flush. iykyk. 🍓

IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.

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. shoutout to the whole team honestly, we love a collab. 💜

k that's the whole page! this was OpenAFS, dated 2026-07-27, filed under the FS_FLUSH(1) manual page. go forth and flush responsibly, bestie. mwah. 💖✨🌸
📦 where this page comes from