GFWHERE(1)

💅 GFWHERE — bestie edition

okay so you know how the Gfarm girlies are always like "where are my files actually at tho" — yeah, this is that. gfwhere(1) is the glow-up page for gfwhere, and it's giving "replica location reveal party" 🗺️✨

✨ NAME ✨

gfwhere — print replica locations 🫶

🎀 SYNOPSIS 🎀

gfwhere [options] path...

🌸 DESCRIPTION 🌸

The gfwhere command prints hostnames of filesystem nodes which hold replicas of the specified files. that's it. that's the whole job. she tells you where your stuff lives, no cap 💖

💅 OPTIONS 💅

• -a — Displays information of all replicas. This is similar to specifying the -dio options. basically the "give me EVERYTHING" button, main character energy 👑
• -d — Displays replicas on filesystem nodes which are currently down as well. so like, the ghosts of replicas past... they're down but they still count 💀
• -F — Displays the following indicators just after each hostname. If the replica has been logically removed, but may still remain physically, ; and the replica's generation number are displayed. If the replica is incomplete because it's in the midst of replication, ? is displayed. If the host is currently down, - is displayed. lil mood ring for your replicas 🌈
• -h host — Only displays files stored on the specified host. When the -h option is specified multiple times, it displays files stored on all specified hosts. When the host A and host B are specified, it displays files stored on both host A and host B. The -h option can be specified up to three times. yes bestie, three times max, don't push her 🫣
• -i — Displays incomplete replicas which are in the midst of replication. she's still cooking, don't @ her 🍓
• -l — Displays in long format as follows.
  • This displays one hostname in each line.
  • If -o option or -a option is specified, this displays the generation number of the replica after the hostname.
  • If -d option or -a option is specified, this displays an indicator which shows whether this host is down (d) or up (-) at next column.
  • If -i option or -a option is specified, this displays an indicator which shows whether this replica is incomplete (i) or not (-) at next column. In the former case, this replica is in the midst of replication.
  • If -o option or -a option is specified, this displays an indicator which shows whether this replica is obsolete (o) or not (-) at next column. In the former case, this replica has been logically removed.
• -m N — Only displays files having less than or equal to N replicas and having greater than 0 bytes. the "under-replicated and not-empty" filter, we love a selective queen 💜
• -o — Displays obsolete replicas which has been logically removed, but may still remain physically. zombie replicas!! they're gone in spirit but still haunting the disk 😭
• -r, -R — Displays subdirectories recursively. down the rabbit hole we go 🐇
• -? — Displays a list of command options. the classic "help me help you" moment ✨

lowkey reminder: -o and -d are about stuff that's logically removed or currently down — that's not "broken", that's just the truth of the cluster, and gfwhere will show it to you straight. periodt. 🔥

anyway that's the whole page bestie, go find your replicas 💖

this was GFWHERE(1) from Gfarm, dated 12 Mar 2016 — yeah she's an older icon but she still slays 👑🦋