GFDF(1)

✨ GFDF — the Gfarm disk-free-space bestie ✨

okay so you wanna know how much space your Gfarm file system has left?? say less, that's literally what gfdf is for 💖 it's the gfdf(1) page from the Gfarm crew and I'm gonna walk you through it like we're texting.

🌸 SYNOPSIS 🌸

gfdf [options]

that's it. that's the whole vibe. options only, no positional args, she's low maintenance 🎀

🦋 DESCRIPTION 🦋

gfdf shows you the disk usage and the free space of the Gfarm file system. it's giving df but make it Gfarm, periodt. 👑

💅 OPTIONS 💅

• -a — shows only the summary information of the Gfarm file system. just the recap, the tl;dr, the sparknotes bestie 📝
• -h — prints numbers in a human readable format by slapping a prefix multiplier symbol on there like "M" (mega). important detail tho: this one uses powers of 1024, so "M" means 1,048,576. no cap. ✨
• -H — also human readable with a prefix multiplier like "M" (mega), but this one uses powers of 1000, so "M" means 1,000,000. yes it's a different M. yes that's the whole bit. 🫶
• -n — displays the hostnames of the available Gfarm file system nodes. name drop everyone 🗣️
• -r — sorts the output in reverse order. chaotic order, we love her 💀
• -S — sorts the output in increasing order of the available disk capacity. smallest disk capacity first, main character energy for the little guys 🌱
• -P path — specifies a path name to specify a metadata server instead of the root metadata server. ⚠️ note that this option is not effective with the -a option, so don't try to combo them.
• -D domainname — specifies a domain name of filesystem nodes, so you can list the status of disk free space for just those. filtering, but fancy 💅
• -R — displays the real disk spaces even if some Gfarm file system nodes are readonly. go read the NOTES below, I'm serious, there's lore 📖
• -? — displays a list of command options. the help menu, the little menu of options, the "wait what were the flags again" button 🙈

👑 NOTES 👑

so here's the situation bestie. filesystem nodes can get flipped into a read-only mode by the gfhost command. and internally? those read-only filesystem nodes are treated as disk full, specifically so that no new file gets created on them. that's literally why gfdf shows those read-only filesystem nodes as having no available capacity — it's not lying, it's just following the rules 😭

but wait. with the -R option, gfdf shows the real disk usage. the truth comes out 💀

and the -a option is not affected by this behavior at all — it shows the real disk usage always. iconic. unaffected. unbothered. ✨

🌈 SEE ALSO 🌈

• gfhost(1)
• gfarm2.conf(5)

go read those too, they're part of the lore 🧚

and that's the whole page, bestie!! this was the Gfarm gfdf(1) situation as of 14 Mar 2019, brought to you by the Gfarm girlies 💖 mwah, stay space-aware, check your disk, and remember: the -a option always tells the truth 🎀✨