GFSD(8)

💖 GFSD(8) — like, the Gfarm filesystem daemon bestie 💖

okay so. gather round. this is gfsd, the manual page for the Gfarm filesystem daemon, and she is that girl. let's get into it 💅

---

✨ NAME ✨

gfsd — Gfarm filesystem daemon 🦋

---

✨ SYNOPSIS ✨

gfsd [options]

that's it. that's the whole vibe. options only, no positional args, she doesn't need them 💅

---

✨ DESCRIPTION ✨

so gfsd is the filesystem daemon for the Gfarm filesystem, and she runs on every filesystem node — usually with root privileges, no cap. 👑

what does she actually do tho? literally so much:

• provides remote file operations with access control in the Gfarm filesystem
• does user authentication
• does file replication
• monitors node resource status

multi-hyphenate. main character energy fr fr 🌟

now, important part, bestie: it is possible for gfsd to be executed as a non-privileged user process, yes. BUT. only the user that executes the gfsd can be authenticated. other users cannot use it. periodt. 🚫

for the deets on that, go read the SETUP.private.en document. it's giving homework but it's giving necessary homework 📚

---

✨ OPTIONS ✨

• -F log-file — specifies a log file. where the receipts go 📝
• -L log-level — specifies a log priority level. any log output whose priority is higher or equal to this level gets sent to syslog or standard error. and like, pls refer to gfarm2.conf(5) for the priority levels you can actually specify with this option, because the list lives over there 🫶
• -P pid-file — specifies a file name which records the process ID of gfsd. so you can find her later 🎀
• -c — when starting up, gfsd investigates all files stored in a spool directory. this is lowkey so useful when a hostname of a file system node is changed. valid file copies get registered to the metadata server. ✅

when the -c option is specified twice (or the -cc option), invalid file copies that are not registered in the metadata server get deleted. bye 💀

when the -c option is specified three times (or the -ccc option), invalid file copies that are not registered in the metadata server are moved to the lost+found directory in the Gfarm file system. and furthermore, invalid metadata pointing to a missing file copy of the file system node gets deleted. this is the default behavior btw, so if you were wondering what she does when you don't say anything — it's this. she's thorough like that 👑

• -d — specifies the debug mode. with the -d option, gfsd runs as a foreground process, not a daemon. she's not hiding in the background, she's right there with you, being loud 🌈

and if this option is specified and -L is not specified, the log level is set to "debug". automatic. she said you're welcome 💅

• -f config-file — specifies a configuration file that is read instead of the default configuration file. your config, your rules 🎀
• -h hostname — specifies my own canonical host name. yes, "my own". she's speaking in first person. iconique ✨
• -l IP-address — specifies the IP address from which the gfsd accepts TCP and UDP requests. the default address is all IP addresses of the host. this option is genuinely so handy when you wanna invoke multiple instances of gfsd to provide multiple spool directories on the host. multitasking queen 🐝
• -r directory — specifies a spool directory for a Gfarm filesystem on this filesystem node. and bestie, this option can be specified multiple times to specify multiple spool directories — up to five. five is the limit. don't push her 🖐️✨
• -s syslog-facility — specifies a syslog facility to report errors by gfsd. by default, local0 is used. default girlie 🍓
• -v — makes gfsd output verbose log message on authentication. this is useful when one has to resolve an issue about GSI authentication. debugging your auth drama, but make it chatty 🫶
• -? — displays a list of command options. the girlie will simply tell you her own options. self-aware 💖

---

✨ FILES ✨

• %%SYSCONFDIR%%/gfarm2.conf — configuration file 🎀

---

✨ SEE ALSO ✨

• gfarm2.conf(5) — go read it, it's the whole lore iykyk 📖

---

okay that's the whole page bestie, you ate that. now go configure your daemon and slay 💅✨

this was GFSD(8) from Gfarm, dated 5 March 2016 — like, vintage but still serving looks 🎀💖🦋