GFREP(1)

💖 GFREP(1) 💖

okay bestie, welcome to the Gfarm girlies' corner, today we're talking about gfrep — the "replicate Gfarm files" icon, no cap. this is section 1 of the manual, so it's a user command, and she is so useful it's giving main character energy fr fr ✨

---

🌸 NAME 🌸

gfrep — replicate Gfarm files 🦋

---

✨ SYNOPSIS ✨

gfrep [-mnqvx] [-S source-domainname] [-D destination-domainname]
      [-h source-hostfile] [-H destination-hostfile]
      [-N num-of-replicas] [-j num-of-threads] path...

---

💅 DESCRIPTION 💅

so gfrep makes a specified number of replicas of Gfarm files (you point at them with path) and drops them onto a specified set of destination hosts. periodt. 👑

and listen — if you also specify a set of source hosts, then only the files that are stored on that set of source hosts get replicated. picky? maybe. iconic? absolutely. 🎀

a set of hosts can be given by a domain name and/or a host file. and when you give both a domain name and a host file? the set of hosts is determined by both conditions — yes bestie, they team up. 🤝

oh and one more thing: if the path parameter is a directory, the files under the directory get copied recursively. it goes all the way down, no crumbs left behind. 🧚

---

🔥 OPTIONS 🔥

• -S source-domainname — tells gfrep the domain name of the source filesystem nodes, aka the ones the replicas get copied from. 📤
• -D destination-domainname — tells gfrep the domain name of the destination filesystem nodes, aka the ones the replicas get copied to. 📥

and if you specify neither this option nor -H? then replicas may get copied to any available host. surprise location, lowkey chaotic, but it's fine. 💀

• -h source-hostfile — points at a file listing the hostnames of source filesystem nodes that the replica will be made from. the source-hostfile is just one filesystem node name per line, super simple, we love a clean format. 📝

if - is specified, standard input is used to read the host list. yes, a literal -. stdin said "i'll do it myself." 💅

• -H destination-hostfile — points at a file listing the hostnames of destination filesystem nodes where the replica will be made. the destination-hostfile is, again, one filesystem node name per line. 🌈

if - is specified, standard input is used to read the host list. same deal, bestie. 🙈

• -N num-of-replicas — sets the required number of file replicas, and yes that count includes the ones that already exist. so if the destination hosts already have enough replicas, gfrep does neither any copying nor any removal. she just vibes. 😌

if you don't specify this option, -N 1 is assumed. one replica minimum, always. ⭐

• -j num-of-threads — sets how many threads create file replicas simultaneously. multitasking queen. 👑

heads up: this option is only available when compiled by an OpenMP C compiler. no OpenMP, no -j, sorry bestie. 😭 and by default, it'll be the smallest among the number of total files, the number of source hosts, and the number of destination hosts. tiny but mighty. 🫶

• -m — lets the gfrep command do a migrate/move instead of doing replication. she's relocating, not duplicating. 🚚
• -x — removes file replicas when a set of destination nodes has more file replicas than specified. too many copies? we're decluttering. 🧹
• -n — displays the files that would be replicated, but does nothing. a dress rehearsal, a vision board, a "not me actually doing it" moment. 🙈
• -q — suppresses non-error messages. quiet luxury. 🤫
• -v — displays verbose output. she's a talker and we respect it. 🗣️
• -? — displays a list of command options. the little help menu that could. 💖

---

💀 BUGS 💀

• A source host is not always selected within a set of source hosts. yeah. that's the bug. it's real, it's documented, and we're just living with it ngl. 😭

---

🫶 that's the whole page, bestie 🫶

this gem came out of the Gfarm manual, dated 31 May 2008, and it lives at GFREP(1). go forth and replicate responsibly, mwah 💋✨