GFNCOPY(1)

🦋 GFNCOPY(1) — the Gfarm girlies' guide to replica counts 💅

ok so bestie, this is gfncopy, straight out of the Gfarm manual, and it's literally the tool that lets you manipulate the number of file replicas automatically created. yes. the ✨auto-replication✨ girl. she's iconic, she's in charge of how many copies of your file the system is gonna make for you, no cap.

🌸 SYNOPSIS 🌸

gfncopy [-vh] path

gfncopy [-vh] [-C | -M] -s NCOPY path

gfncopy [-vh] [-C | -M] -S REPATTR path

gfncopy [-vh] -r path [path...]

gfncopy [-vh] -c path

gfncopy [-v] -w [-t TIMEOUT] path [path...]

💖 DESCRIPTION 💖

okay so real talk: gfncopy manipulates the number of file replicas automatically created. that's the whole vibe.

• if you give it no option at all, it just displays the specified number of file replicas. show and tell, periodt. 🎀
• if the replication attributes of both NCOPY and REPATTR are set on a file, those attributes get displayed in two lines. two lines, two moods. ✌️
• and with the -v option, it also displays path names all the way up to the ancient directory that specifies the number of file repilcas. yes bestie, we're going ancestor-hunting 🧚

✨ OPTIONS ✨

• -s NCOPY — specifies the attribute for automatic replication represented by the number of file replicas, applied to a file or directory. NCOPY is stored in the extended attribute of gfarm.ncopy. 📌
• -S REPATTR — specifies the attribute for automatic replication represented by host groups, applied to a file or directory. 🫶

when both NCOPY and REPATTR are set to a same file, here's the tea on how many replicas get created: if N is the total number of replicas specified by REPATTR, and N is greater than NCOPY, at least N replicas will be created. otherwise, replicas will be created according to REPATTR, and more replicas will be added until total number of replicas reaches NCOPY. REPATTR is stored in the extended attribute of gfarm.replicainfo. 💾

a REPATTR is represented by the following BNF:

<repattr> ::= <an_attr> | <an_attr> ',' <repattr>
<an_attr> ::= <host_group> ':' <num_rep>
<host_group> ::= <string>
<num_rep> ::= <integer>

e.g.)

group0:2
group0:1,group1:2,group2:3

• -C — if the replication attribute exists already on the file, gfncopy with the -s or -S options fails. like, sorry babe, it's taken. 💀
• -M — if the replication attribute does not exist on the file, gfncopy with the -s or -S options fails. opposite energy, same drama. 🙈
• -r — removes the specified replication attributes. bye bye attribute! 👋

the path can be specified multiple times.

• -c — displays the number of file repicas the file really has. the truth-teller. the reality check. 🔥
• -w — checks whether or not the file replicas have been created according to the replication attributes (NCOPY or REPATTR), otherwise waits for the completion of the replication. it's giving patient bestie who waits for you outside the store. ⏳

the path can be specified multiple times.

if the path is a directory, files in subdirectories are checked. yes, it goes deep. 🌈

• -t TIMEOUT — specifies the time in seconds for the -w option to wait until automatic replication starts. timeout does not occur while the replication is running. default is 30 seconds. ⏰
• -h — processes symbolic link instead of any referenced files. don't follow the link, look at the link itself, main character energy. 🎀
• -v — displays verbose messages. she's chatty and we love that for her. 💜
• -? — displays a list of command options. the menu, the whole menu, and nothing but the menu. 📋

👑 SEE ALSO 👑

• gfhostgroup(1)
• gfarm_attr(5)

bestie reminder: this page is the Gfarm manual, and the source + date that lived in the footer were Gfarm, 15 Jul 2020. so go forth, set your NCOPY, set your REPATTR, and let the replicas replicate. slay. 💅✨🦋