S6-CHOWN(1)

📦 version 2.3.1.2, in nixpkgs unstable

🎀 S6-CHOWN(1) 🎀

okay bestie, welcome to the General Commands Manual page for s6-chown — she's a tiny little icon from the s6-portable-utils fam and she's literally here to change who owns your file 💅

✨ NAME ✨

s6-chown — change the owner and/or group of a file 🫶

🌸 SYNOPSIS 🌸

s6-chown [-U] [-u uid] [-g gid] file

🦋 DESCRIPTION 🦋

So s6-chown does exactly one thing and she does it flawlessly: she changes file's owner to (numeric) uid and the group to (numeric) gid. no cap, that's the whole vibe.

And if you don't hand her a uid? The owner just stays exactly as it was, untouched, unbothered, main character energy. Same deal with gid — no gid, no group change. she's not gonna mess with stuff you didn't ask her to mess with 🙈

💖 OPTIONS 💖

  • -U — sets the uid to whatever's sitting in the UID environment variable, and the gid to whatever's in the GID environment variable. this is the option that makes s6-chown chef's kiss easy to pair with s6-envuidgid(8), like so:
s6-envuidgid account s6-chown -U file

and boom, that little line changes file's uid and gid to account's. iconic behavior honestly 💅

  • -u — sets the uid to uid. that's it, that's the tweet ✨
  • -g — sets the gid to gid. slay 🎀

💀 EXIT STATUS 💀

  • 111 — temporary error. like, give it a sec, try again energy.
  • 100 — permanent error, such as a misuse. you did something she can't work with, bestie 😭
  • 127 — unable to execute program — not found.
  • 126 — unable to execute program — other reason.

🌈 SEE ALSO 🌈

this is the whole squad, and yes you're gonna get every single one of them because I would never do them dirty like that:

s6-basename(1), s6-cat(1), s6-chmod(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-rename(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)

and the reference links, preserved in all their glory:

[1] https://pubs.opengroup.org/onlinepubs/9799919799/utilities/chown.html

This man page is ported from the authoritative documentation at: https://skarnet.org/software/s6-portable-utils/s6-chown.html

⭐ STANDARDS ⭐

s6-chown is not suitable as a chown[1] program conforming to . — yeah, the standard name genuinely didn't survive the port, don't come for me 🙈 (the [1] link above is the POSIX chown page, iykyk)

👑 AUTHORS 👑

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

and that's the whole page babes 💜 huge thanks to Debian, this port is dated April 18, 2022, and it's the S6-CHOWN(1) page you just read, start to finish. go change some ownership. periodt 🔥🦋🌸

📦 where this page comes from