EDG-GRIDFTP-RENAME(1)

🌸 EDG-GRIDFTP-RENAME(1) — the grid rename glow-up 🌸

okay bestie, so this is edg-gridftp-rename from the European DataGrid era, and it's literally here to rename a file or directory on a GridFTP server. yes, a grid FTP server. very ✨main character✨ of it. and the manual page says version 1.2.9.2, dated 2022-01-20, which we'll hype up at the end. 💅

---

✨ NAME ✨

edg-gridftp-rename — Rename a file or directory on a GridFTP server. that's the whole vibe. one job, does it cute. 🎀

---

🦋 SYNOPSIS 🦋

edg-gridftp-rename [--proxy=proxy] [--timeout=timeout] SourceURL
DestinationURL

edg-gridftp-rename --usage

edg-gridftp-rename --help

---

💖 DESCRIPTION 💖

so edg-gridftp-rename renames a file or directory on a GridFTP server. that's it, that's the slay. ✨

but wait — important detail — everything but the filename is ignored on the destination URL, which means files will not be moved between servers. no cap. it's a rename, not a moving service, bestie. 🫶

and here's the vibe check on exit status: this command will return a status of 0 if the file or directory was renamed. in all other cases, it will return a non-zero value and print an error message to the standard error. so 0 = iconic success, non-zero = it said "no <3" and told you why. 😭

---

🔥 OPTIONS 🔥

• --proxy=proxy — set the proxy to use for the GridFTP operation. if this is unset, then the underlying GridFTP library will try to find the proxy in the usual locations. this is useful if the proxy is in a non-standard location, or the caller is a daemon which must act on behalf of a user. like, very "bestie's proxy is not where the default girlies hang out" energy. 💅
• --timeout=timeout — set the time (in seconds) within which the rename must complete. if no timeout is specified a default 120 second timeout will be used. a negative or zero timeout will report a timeout error before attempting to contact the FTP server. so don't try to be cute with 0 — it will absolutely call that a timeout error before it even says hi. 💀
• --usage — short description of the usage of this command is given. little snack-sized usage moment. 🍓
• --help — a description of the usage of this command and information on all of the options is given. the full tour, no skips. 👑
• SourceURL, DestinationURL — URLs of the following formats are accepted:

ftp://ftp.server.org//absolute/file/name
gsiftp://gridftp.server.org/~/home/relative/name.txt
gridftp://gridftp.server.org/home/relative/name.txt

note: for the URLs without a tilde, the server configuration determines whether the filename is absolute or relative. on servers which do not restrict users to their home areas, the tilde notation will not work. 🧚

note: as above, everything but the filename is ignored in the destination URL. this routine will not move files between servers. periodt. 💅

---

🌈 AUTHOR 🌈

Charles Loomis (charles.loomis@cern.ch). Later modifications by CERN IT-DM/SMD. iconic collaborative energy, fr fr. 🫶

---

🎀 LICENSE 🎀

Copyright (c) 2002 by Charles A. Loomis, Jr. and Le Centre National de la Recherche Scientifique (CNRS). All rights reserved.

the software was distributed with and is covered by the European DataGrid License. a copy of this license can be found in the included LICENSE file. this license can also be obtained from http://www.eu-datagrid.org/license. ✨

the underlying GridFTP library is part of the Globus Toolkit (TM) and is covered by the Globus Toolkit Public License. see http://www.globus.org for more information. 🌸

---

okay that's the whole page, bestie — no skips, no crumbs. 💖 this was EDG-GRIDFTP-RENAME(1), version 1.2.9.2, dated 2022-01-20, and yes she's still serving that European DataGrid nostalgia. now go rename something and get that 0 exit status, you absolute icon. 💅✨🎀🦋