S6-SUDO(8)

NAME 💅 (s6-sudo(8) · System Manager's Manual energy)

Okay bestie, welcome to s6-sudo(8) — the page lives in the System Manager's Manual, and the whole assignment is: connect to a Unix domain socket and pass its standard file descriptors, command-line arguments and environment to a program running on the server side, potentially with different privileges. No cap, that's the NAME-section tea. 💖

SYNOPSIS 🎀

s6-sudo [-q | -Q | -v] [-p bindpath] [-l localname] [-e]
        [-t timeoutconn] [-T timeoutrun] path [args...]

DESCRIPTION 🦋

s6-sudo executes into s6-ipcclient(8) path s6-sudoc(8) args.... That's literally all it does — it's just a convenience program. No hidden main-character side quest. 💅

<cyan>s6-ipcclient(8)</cyan> is the one that connects to a Unix socket at path, and s6-sudoc(8) is the one that transmits the desired elements over the socket. 🌸

You should use it to connect to an s6-local-service(7) running the s6-sudod(8) program — that program will run a server program on the client's behalf. 🫶

OPTIONS 💖

The -q, -Q, -v, -p and -l options are passed to s6-ipcclient(8); the -e, -t and -T options are passed to s6-sudoc(8). Here's the full roster, one bullet per option so nobody gets left on read:

• -q — passed to s6-ipcclient(8). That's the whole assignment.
• -Q — passed to s6-ipcclient(8). Same energy.
• -v — passed to s6-ipcclient(8). Yep.
• -p bindpath — passed to s6-ipcclient(8); bindpath is its argument.
• -l localname — passed to s6-ipcclient(8); localname is its argument.
• -e — passed to s6-sudoc(8).
• -t timeoutconn — passed to s6-sudoc(8); timeoutconn is its argument.
• -T timeoutrun — passed to s6-sudoc(8); timeoutrun is its argument.

Command-line arguments, if any, are also passed to s6-sudoc(8), which will transmit them to s6-sudod(8) over the socket. Periodt. 💌

SEE ALSO 🌈

• s6-sudoc(8)
• s6-sudod(8)

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

AUTHORS 👑

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

Debian · September 29, 2021 — source/version and date, sign-off slay. Stay iconic, bestie. 💖✨