S6-RENAME(1)

💖 S6-RENAME(1) — the girlies' guide to atomic renaming 💖

okay so this is the man page for s6-rename, from the s6-portable-utils fam (General Commands Manual, if you're keeping track 🎀). she's a tiny little icon and she does exactly one thing, but she does it flawlessly.

---

✨ NAME ✨

s6-rename — atomically rename a file 💅

like, the whole rename happens as one indivisible glow-up. no in-between state, no half-renamed mess. periodt.

🌸 SYNOPSIS 🌸

s6-rename old new

🦋 DESCRIPTION 🦋

s6-rename atomically renames old to new.

that's it. that's the whole vibe. bestie it is not complicated and honestly? we love that for her. the "atomic" part is the main character energy here — the rename is all-or-nothing, no cursed partial states, iykyk. 🔥

👑 EXIT STATUS 👑

she's got opinions and she will tell you about them via exit codes. here's the whole lineup, no gatekeeping:

• 111 — temporary error. like, it didn't work right now, but it's not necessarily forever 🫶
• 100 — permanent error, such as a misuse. you used her wrong, bestie, and she's not gonna pretend otherwise 💀
• 127 — unable to execute program - not found. literally couldn't find the thing 😭
• 126 — unable to execute program - other reason. found it, but executing it was a no 🙈

🌈 SEE ALSO 🌈

the whole friend group, in the order the original lists them (no reshuffling, i would never):

• s6-basename(1)
• s6-cat(1)
• s6-chmod(1)
• s6-chown(1)
• s6-clock(1)
• s6-cut(1)
• s6-dirname(1)
• s6-dumpenv(1)
• s6-echo(1)
• s6-env(1)
• s6-expr(1)
• s6-false(1)
• s6-format-filter(1)
• s6-grep(1)
• s6-head(1)
• s6-hiercopy(1)
• s6-linkname(1)
• s6-ln(1)
• s6-ls(1)
• s6-maximumtime(1)
• s6-mkdir(1)
• s6-mkfifo(1)
• s6-nice(1)
• s6-nuke(1)
• s6-pause(1)
• s6-printenv(1)
• s6-quote(1)
• s6-quote-filter(1)
• s6-rmrf(1)
• s6-seq(1)
• s6-sleep(1)
• s6-sort(1)
• s6-sync(1)
• s6-tai64ndiff(1)
• s6-tail(1)
• s6-touch(1)
• s6-true(1)
• s6-uniquename(1)
• s6-unquote(1)
• s6-unquote-filter(1)
• s6-update-symlinks(1)
• seekablepipe(1)

💡 also, for the record: this man page is ported from the authoritative documentation at: https://skarnet.org/software/s6-portable-utils/s6-rename.html — that's the source of truth, go say hi 🧚

🍓 AUTHORS 🍓

• Laurent Bercot
• Alexis <flexibeast@gmail.com> (man page port)

---

and that's the whole page, bestie 💜 credit where it's due: this is Debian's, dated April 17, 2022 — so like, respectfully, go touch some grass after this and remember: atomic means atomic 🎀✨