FS_RMMOUNT(1)

💅 FS_RMMOUNT(1) — bestie's guide to yeeting a mount point 💅

okay so this is an AFS Command Reference page, and we're talking about fs rmmount — the little command that says "bye bye mount point" without ever touching the actual volume. no cap. let's get into it 🦋

---

✨ NAME ✨

fs_rmmount — removes a mount point. that's it, that's the whole job. iconic behaviour honestly 💖

---

🌸 SYNOPSIS 🌸

fs rmmount -dir <directory>+ [-help]

fs rm -d <directory>+ [-h]

look at those two little twins. same command, one's just wearing a shorter skirt (rm instead of rmmount, -d instead of -dir, -h instead of -help). choose your fighter bestie 💅

---

🎀 DESCRIPTION 🎀

so the fs rmmount command removes the mount point named by the -dir argument from the file system. that's the whole vibe.

but here's the tea 🍓: the corresponding volume stays exactly where it is on its host partition or partitions. it doesn't get deleted. it doesn't get harmed. it just becomes inaccessible if there are no other mount points pointing at it. which, like… if that was its only doorway, it's giving very much locked-in-the-room energy. the volume is still there, you just can't get to it. periodt. 😭

---

👑 OPTIONS 👑

• -dir <directory>+ — names the mount point (or points, bestie, the + means you can list as many as you want) to delete from the file system. one thing though: the last element in the pathname has to be an actual name. not a shorthand notation like "dot" (".") or "dot dot" (".."). so no sneaky little .. tricks, the command is not playing games with you 🙈

also, lowkey important: you should specify the read/write path to the directory, because if you try to delete a mount point from a read-only volume, it will fail. like, it cannot even. the convention here is that the read/write path is indicated by placing a period before the cell name at the pathname's second level — for example, /afs/.example.com 👀. and if you want the full deep-dive discussion of read/write vs. read-only paths through the filespace, that lives in the fs mkmount reference page. go read your sister's page, she explains it better 🫶

• -help — prints the online help for this command. and listen: all other valid options are ignored when you use this. it's help mode, she's not multitasking 💀

---

🌈 EXAMPLES 🌈

the following command removes the mount points jones and terry from the current working directory (which, in this example, is the /afs/example.com/usr directory):

% fs rmmount jones terry

two mount points, one command, zero regrets. we love a clean batch operation ✨

---

🔥 PRIVILEGE REQUIRED 🔥

the issuer must have the "d" (delete) permission on the ACL of the directory that houses each mount point. so like, yes you need permission to delete, obviously bestie, the filesystem is not just gonna let anyone walk in and start deleting doors 💅

---

⭐ SEE ALSO ⭐

• fs_lsmount(1)
• fs_mkmount(1)

(one lists them, one makes them, and this one deletes them. a whole little family fr fr 💜)

---

💖 COPYRIGHT 💖

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 Wachmann and Elizabeth Cassell. shoutout to the conversion girlies 🎀

---

and that's the whole page bestie!! this version of the page is from OpenAFS, dated 2026-07-27, and it lives in the AFS Command Reference. go forth and rmmount responsibly, you absolute main character 👑✨💖