S6-RC-ONESHOT-RUN(8)

✨ NAME ✨

okay so bestie, this is s6-rc-oneshot-run from section 8 of the System Manager's Manual, and it executes a oneshot service's up or down script. That's the whole vibe. 💅

🎀 SYNOPSIS 🎀

s6-rc-oneshot-run [-l live] [-b] up|down n

🌸 DESCRIPTION 🌸

s6-rc-oneshot-run runs a oneshot service's up or down script, and it pulls that script from the current live compiled database. Lowkey important. ✨

Real talk: this is not meant to be used directly by you, bestie. It's used inside internal scripts created by s6-rc-compile(8), and those get invoked during an s6-rc(8) execution. The way it works: s6-rc-oneshot-run executes into the up or down script of the *n*th oneshot service defined in the current compiled service database — i.e. the compiled linked from the live directory. No cap. 🫶

🔥 OPTIONS 🔥

• -l live — use the live directory at live. The default is /run/s6-rc, or what was given to the --livedir configure option at compile time. 🎀
• -b — blocking lock. If the service database is currently being used by another program, s6-rc-oneshot-run will wait until that other program has released its lock on the database, then proceed. By default, s6-rc-oneshot-run fails with an error message if the database is currently in use. 🔒

💀 EXIT STATUS 💀

• 3 — Invalid service number.
• 4 — Invalid service database.
• 100 — Wrong usage.
• 111 — System call failed.
• 126 — Cannot exec script.
• 127 — Cannot exec script: executable not found.
• other exit codes — Returned from the executed up or down script.

🦋 SEE ALSO 🦋

Go read these, bestie: s6-rc-faq(7), s6-rc-overview(7), s6-rc-why(7), s6-rc(8), s6-rc-bundle(8), s6-rc-compile(8), s6-rc-db(8), s6-rc-dryrun(8), s6-rc-fdholder-filler(8), s6-rc-format-upgrade(8), s6-rc-init(8), s6-rc-update(8).

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

👑 AUTHORS 👑

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

xoxo 💖 this page is the Debian edition, dated April 6, 2023, and its manual tag is <rainbow>S6-RC-ONESHOT-RUN(8)</rainbow>. Periodt.