S6-RC-ONESHOT-RUN(8)

NAME
s6-rc-oneshot-run - executes a oneshot service's up or down script

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

DESCRIPTION
s6-rc-oneshot-run executes a oneshot service's up or down script taken from the current live compiled database.

s6-rc-oneshot-run is not meant to be used directly; it is used in internal scripts created by s6-rc-compile(8), which are invoked during an s6-rc(8) execution. 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).

up or down are run with the RC_NAME environment variable set to the name of the service.

OPTIONS

-l live
    Use the live directory in live. 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
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)