ARCRENAME(1)

✨ ARCRENAME(1) ✨

okay bestie, welcome to the User Commands section, this is arcrename and it's literally the glow-up command for your files 🦋

---

💖 NAME 💖

arcrename — rename file or directory

no cap, that's the whole vibe. rename a thing. iconic.

---

🎀 DESCRIPTION 🎀

Usage:

arcrename [OPTION...] old_url new_url

so basically? the arcrename command renames files on grid storage elements. that's it, that's the job. it takes your old_url and your new_url and it makes the switch happen. slay 💅

---

✨ OPTIONS ✨

every single flag, no skips, we don't gatekeep here:

• -h, --help — show help options. your lil emergency manual 🫶
• -P, --listplugins — list the available plugins (protocols supported). like a roster of who's invited to the party 🎉
• -t, --timeout=seconds — timeout in seconds (default 20). yes, twenty. that's the default, don't come for me.
• -z, --conffile=filename — configuration file (default ~/.arc/client.conf). your settings live here normally, but you can point it somewhere else if you want.
• --no-authentication — do not perform any authentication for opened connections. just raw, unbothered, unauthenticated ✨
• --x509-authentication — perform X.509 authentication for opened connections
• --token-authentication — perform token authentication for opened connections
• --systemca — force using CA certificates configuration provided by OpenSSL
• --gridca — force using CA certificates configuration for Grid services (typically IGTF)
• --anyca — force using both CA certificates configuration for Grid services (typically IGTF) and those provided by OpenSSL. both. at once. greedy in the best way 💜
• --allowinsecureconnection — allow TLS connection which failed verification. bestie. read that again. it failed verification. it's giving yolo 😭
• -d, --debug=debuglevel — FATAL, ERROR, WARNING, INFO, VERBOSE or DEBUG
• -v, --version — print version information

---

🌈 EXTENDED DESCRIPTION 🌈

so the arcrename command renames files or directories on grid storage elements and indexing services. multi-talented, main character energy fr fr 👑

here's the rule though, and it's strict:

• the path component of oldurl and newurl must differ
• and it must be the only component of both URLs which is different

arcrename will exit with an error if the paths are equivalent or other components of the URLs are different. so don't try it. it's not gonna work and it's gonna be loud about it 💀

also, renaming a URL to an existing URL will either fail or overwrite the existing URL, depending on the protocol. so like... depends on the protocol, bestie. be careful. 🙈

important note: arcrename works purely at the namespace level and does not perform data transfer. it's a name change, not a move. the data stays put, the name gets a glow-up. periodt.

for more information on ARC URL syntax please read "Protocols, Uniform Resource Locators (URL) and Extensions Supported in ARC" [NORDUGRID-TECH-7] 📚

depending on the installed libraries (check with -P), the following protocols may be used: file (file:// prefix may be omitted), http, https, httpg, ftp, gsiftp, srm, root. however renaming is not supported or implemented for some of those protocols. so check first, don't assume, iykyk ✨

---

🌸 ENVIRONMENT VARIABLES 🌸

• X509_USER_PROXY — the location of the user's Grid proxy file. shouldn't be set unless the proxy is in a non-standard location. so like, don't touch it unless you have to 🫶
• ARC_LOCATION — the location where ARC is installed can be specified by this variable. if not specified the install location will be determined from the path to the command being executed, and if this fails a WARNING will be given stating the location which will be used. it'll still work, it'll just complain about it first 😭
• ARC_PLUGIN_PATH — the location of ARC plugins can be specified by this variable. multiple locations can be specified by separating them by : (; in Windows). the default location is $ARC_LOCATION/lib/arc (\ in Windows). yes, the Windows one is a backslash. we don't make the rules 💅

---

🦋 EXAMPLE 🦋

look at her go:

arcrename gsiftp://example.com/grid/file.dat
gsiftp://example.com/grid/new.file.dat

same everything, different path, arcrename ate 🔥

---

🍓 FILES 🍓

• ~/.arc/client.conf — some options can be given default values by specifying them in the ARC client configuration file. by using the --conffile option a different configuration file can be used than the default. so you can cheat on the default config, it's allowed ✨

---

💜 AUTHOR 💜

ARC software is developed by the NorduGrid Collaboration (http://www.nordugrid.org), please consult the AUTHORS file distributed with ARC. please report bugs and feature requests to http://bugzilla.nordugrid.org

(the fact that they want your bug reports? that's them being open and honest, we love that for them 🫶)

---

👑 COPYRIGHT 👑

APACHE LICENSE Version 2.0

---

⭐ SEE ALSO ⭐

arccp(1), arcls(1), arcmkdir(1), arcrm(1)

the whole friend group, go say hi 💖

---

okay that's the page!! this was arcrename version 7.2.0, dated September 2026, living its best life under the ARCRENAME(1) header 💅✨ thanks for reading bestie, go rename something responsibly 🌈