GFLSOF(1)

💖 GFLSOF 💖

okay bestie, so gflsof is the manual page for the gflsof command in the Gfarm fam, and it's literally just "list currently opened Gfarm files" ✨ iykyk.

---

✨ NAME ✨

gflsof — list currently opened Gfarm files 🗂️💅

---

🎀 SYNOPSIS 🎀

gflsof [-AW] [-P path] [-D domainname-of-gfsd]
       [-U domainname-of-user-host] [-u username]

gflsof [-AW] [-P path] [-D domainname-of-gfsd]
       [-U domainname-of-user-host] [-u username] -C

gflsof [-AW] [-P path] [-D domainname-of-gfsd]
       [-U domainname-of-user-host] [-u username] -G

---

🌸 DESCRIPTION 🌸

So if you don't pass -C and you don't pass -G, it spills all the tea about every Gfarm file descriptor. 🫖✨ Here's the field-by-field breakdown, because the way this thing prints columns is honestly iconic:

• the USER field → the username
• the GPID field → the Gfarm process ID
• the FD field → the Gfarm file descriptor number. and listen, the character right after that descriptor number is doing a lot of work:
  • if it's r, it means read-only open 🍓
  • if it's w, it means write-only open ✍️
  • if it's u, it means read-write open 🔥
• the TYPE fields → the type of the inode, where REG is a file, DIR is a directory, and LNK is a symbolic link 🦋
• the INODE field → the inode number
• the GEN field → the generation number of the inode
• the SIZE/OFF → shows the seek-offset value if the inode is a directory, or the file size if the inode is a file 📏
• the CLIENT field → hostname and port number of the client which is connecting to the gfmd
• the GFSD field → hostname and port number of the gfsd which is connecting to the gfmd

if you pass the -C option, this command shows only hostnames of clients which are opening descriptors 💻✨

and if you pass the -G option, this command shows only hostnames of gfsd which are opening file replicas 🗄️✨

---

💅 OPTIONS 💅

• -A — display information about all users. lowkey exclusive: only the gfarmadm group is allowed to use this option 👑
• -W — limit subject descriptors to which are either write-only opened or read-write opened ✍️
• -P path — specify a pathname or a Gfarm URL to identify the metadata server which will be accessed by this command. if you don't specify it, "." is used as the default value 🌈
• -D domainname-of-gfsd — limit subject descriptors to which gfsd is currently opening a replica and the gfsd belongs to the specified domain 🌐
• -U domainname-of-user-host — limit subject descriptors to which client host belongs to the specified domain 🏠
• -u username — limit subject descriptors to which is opened by the specified user. only the gfarmadm group is allowed to use this option 💜
• -? — displays a list of command options 🙈

---

⭐ EXAMPLES ⭐

Example 1. list file descriptors which are opened by myself 🪞

gflsof

Example 2. list all users' file descriptors 👥

gflsof -A

Example 3. list filesystem nodes which are currently opening file replicas in writable mode ✍️🔥

gflsof -AWG

Example 4. list descriptors that corresponding gfsd processes are opening file replicas in writable mode 🗄️

gflsof -AW -D ''

Example 5. list client hosts which belong to example.org domain and user john is opening descriptors on the hosts 🌐💻

gflsof -U example.org -u john -C

---

ngl bestie, that's the whole vibe. go forth and gflsof responsibly 🫶

---

k byeeee 💖 this was the Gfarm manual page, dated 27 Sep 2016 — periodt ✨🎀