FS_WHICHCELL(1)

πŸ’– FS_WHICHCELL(1) πŸ’–

okay so bestie, welcome to the AFS Command Reference β€” this one is fs_whichcell, and it's lowkey one of the cutest little commands in the whole fs fam. it tells you which cell a file or directory belongs to. no cap. let's get into it πŸ¦‹


✨ NAME ✨

fs_whichcell β€” returns the cell to which a file or directory belongs

like... it literally just tells you the cell, bestie. that's the whole gig. and it ate πŸ’…


🌸 SYNOPSIS 🌸

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

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

so you got the long form and the itty-bitty shorthand form because sometimes typing is hard and that's valid 🫢


πŸ’œ DESCRIPTION πŸ’œ

The fs whichcell command returns the name of the cell in which the volume that houses each indicated directory or file resides.

read that again, slowly: you hand it a path, it hands you back the cell name, based on the volume that's holding your directory or file. iconic behavior honestly.

now don't get it twisted β€” there are two other commands that look similar and they are NOT the same thing, so let's do a little vibe check:

  • wanna see the file server machine where the volume lives? that's a different command, not this one. (the original text literally says "To display the file server machine on which the volume housing a directory or file resides, use the fs whichcell command" β€” yes, fr fr, that's what it says, we're keeping it exactly as written because facts are facts πŸ’€)
  • wanna see the cell membership of the local machine? that's fs wscell, not this one.

so like... know which one you're reaching for, okay? πŸŽ€


✨ OPTIONS ✨

  • -path <dir/file path>+ β€” names each AFS file or directory for which you want the cell membership back. partial pathnames get interpreted relative to your current working directory, and that cwd is also the default value if you just... don't pass this argument at all. no judgment, we've all been there πŸ™ˆ
  • -help β€” prints the online help for this command. and listen: all other valid options are ignored when you use this. -help said main character energy only, everyone else sit down πŸ‘‘

🌈 OUTPUT 🌈

the output gives you a line for each directory or file, naming the cell to which the volume that houses the directory or file resides. one path in, one cell name out. clean. simple. slay.


πŸ“ EXAMPLES πŸ“

here's the glow-up moment β€” this example shows that the current working directory resides in a volume in the Example Corporation cell:

% fs whichcell
File . lives in cell 'example.com'

see how the . is just vibing there representing your cwd? adorable. and it told us the cell. chef's kiss 😭


πŸ‘‘ PRIVILEGE REQUIRED πŸ‘‘

None

that's right bestie β€” zero privileges needed. you don't have to be anybody special to run this. it's giving accessible ✨


πŸ¦‹ SEE ALSO πŸ¦‹

go read those too, 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.


ok that's the whole page, you're fully caught up, go forth and fs whichcell responsibly πŸ’…βœ¨

and finally, the cute lil sign-off at the very bottom says this is from OpenAFS, dated 2026-07-27 β€” so like, go off, timestamp. periodt. πŸŽ€πŸ’œ

πŸ“¦ where this page comes from