GFAL-RENAME(1)

✨ gfal-rename(1) ✨

okay bestie, welcome to the gfal-rename page from the General Commands Manual, and no bc we're not gatekeeping — this one's short, sweet, and honestly iconic 💅

🌸 NAME 🌸

gfal-rename — renames files or directories, fr fr

🦋 SYNOPSIS 🦋

gfal-rename [ OPTION ]...  SOURCE DESTINATION

💖 DESCRIPTION 💖

so the whole vibe is: gfal-rename renames SOURCE to DESTINATION. that's it. that's the plot. lowkey the most straightforward glow-up in the entire toolkit ✨

🎀 OPTIONS 🎀

• -h, --help — shows you help about the command. your little onboarding tour 🫶
• -V, --version — spits out version info and then dips (exits). main character exit, honestly 👑
• -v, --verbose — verbose mode. you can repeat it up to 3 times to get the most verbose mode possible. like turning the volume all the way up, but for logs 🔊
• -D, --definition DEFINITION — define properties for gfal2. the syntax is literally this and nothing else: "CONFIG_GROUP:KEY=VALUE" — memorize it, iykyk 💅
• -t, --timeout TIMEOUT — global timeout for the execution of the command. if time runs out before it finishes, the command gets interrupted. > note bestie: a grace period of 30 seconds is given to the global timeout, so it's not a hard jump-scare 😭
• -E, --cert CERT — user certificate. (this option only takes effect after the X509_USER_PROXY environment variable and the default /tmp/x509up_u`id -u` location both fail to provide a certificate — so it's the backup backup, not the first pick 🙈)
• --key KEY — user private key. keep it secret, keep it safe 🔐
• -4 — forces Gfal2 to use IPv4 addresses only. (option valid only for the GridFTP protocol)
• -6 — forces Gfal2 to use IPv6 addresses only. (option valid only for the GridFTP protocol)
• -C, --client-info CLIENT_INFO — provide custom client-side information. give it the lore 🍓
• --log-file LOG_FILE — write Gfal2 library logs to the given file location. receipts, but on disk 📝

🌈 EXAMPLES 🌈

the classic, the blueprint, the moment:

gfal-rename
       file:///tmp/original file:///tmp/newname

so you point it at file:///tmp/original and it becomes file:///tmp/newname. slay. ate. no crumbs ✨

🧚 FILES 🧚

• /etc/gfal2.d/* — every single configuration file in this directory affects the behavior of the underlying gfal2. it's giving group project, but make it config 🎀

💜 AUTHORS 💜

these legends built this, show some respect 🫶

• Duarte Meneses <duarte.meneses@cern.ch>
• Adrien Devresse <adrien.devresse@cern.ch>
• Alejandro Alvarez Ayllon <alejandro.alvarez.ayllon@cern.ch>
• Andrea Manzi <andrea.manzi@cern.ch>
• Mihai Patrascoiu <mihai.patrascoiu@cern.ch>
• Joao Lopes <joao.pedro.batista.lopes@cern.ch>

⭐ SEE ALSO ⭐

the whole friend group, go say hi 💖

gfal-cat(1), gfal-chmod(1), gfal-copy(1), gfal-ls(1), gfal-mkdir(1), gfal-rename(1), gfal-rm(1), gfal-save(1), gfal-stat(1), gfal-sum(1), gfal-token(1), gfal-xattr(1), gfal-evict(1), gfal-bringonline(1), gfal-archivepoll(1)

and that's the page bestie!! this version is v1.7.1, dated March 2022 — go rename something and be iconic with it 💅🌸🦋