From 9473830ad612dcb674f6048a9a17e372ff9d9ec3 Mon Sep 17 00:00:00 2001 From: Laurent Bercot Date: Wed, 12 Aug 2015 20:00:17 +0000 Subject: Intermediary commit; working on source dir format change. Should work, but untested as for now. --- doc/s6-rc-db.html | 50 +++++++++++++++++++++++++++----------------------- 1 file changed, 27 insertions(+), 23 deletions(-) (limited to 'doc/s6-rc-db.html') diff --git a/doc/s6-rc-db.html b/doc/s6-rc-db.html index 280f98a..a60658e 100644 --- a/doc/s6-rc-db.html +++ b/doc/s6-rc-db.html @@ -43,7 +43,7 @@ operation. s6-rc-db [ -l live ] [ -c compiled ] [ -u | -d ] timeout atomicname s6-rc-db [ -l live ] [ -c compiled ] contents bundlename s6-rc-db [ -l live ] [ -c compiled ] [ -u | -d ] dependencies servicename - s6-rc-db [ -l live ] [ -c compiled ] servicedir longrunname + s6-rc-db [ -l live ] [ -c compiled ] pipeline longrunname s6-rc-db [ -l live ] [ -c compiled ] [ -u | -d ] script oneshotname s6-rc-db [ -l live ] [ -c compiled ] flags atomicname s6-rc-db [ -l live ] [ -c compiled ] atomics servicename... @@ -54,9 +54,8 @@ operation.
  • s6-rc-db expects to find a compiled service database in compiled; by default it uses the service database used by the live state in live. -It reads and parses the compiled database it finds. If the -database is invalid, it exits 4.
    • -
  • Depending on the arguments given, it prints the requested +It reads and parses the compiled database it finds; depending on +its arguments, it prints the requested information to stdout, then exits 0.
    • @@ -78,6 +77,17 @@ depending on whether it's about bringing the service up or down, select the "down" data. This option is ignored when it is irrelevant. +

    Exit codes

    + + +

    Subcommands

    s6-rc-db help

    @@ -134,8 +144,7 @@ dependency tables, or a dependency cycle.

    Prints the type of servicename: oneshot, longrun -or bundle. Exits 1 if -servicename is not a valid identifier in the database. +or bundle.

    s6-rc-db timeout atomicname

    @@ -143,8 +152,8 @@ or bundle. Exits 1 if

    Prints the timeout value, in milliseconds, after which bringing atomicname up or down is considered a failure if the -called script still has not succeeded. Exits 1 if atomicname -isn't a valid atomic service. By default, or if the -u +called script still has not succeeded. +By default, or if the -u option has been given to s6-rc-db, the timeout for up is printed; the timeout for down is printed instead if the -d option has been given. @@ -154,14 +163,12 @@ printed; the timeout for down is printed instead if the

    Lists the atomic services represented by bundle bundlename. -Exits 1 if bundlename is not a valid bundle.

    s6-rc-db dependencies servicename

    - Prints the list of direct dependencies for servicename. -Exits 1 if servicename isn't a valid identifier. If + Prints the list of direct dependencies for servicename. If servicename is a bundle, its set of direct dependencies is the union of the direct dependencies of all the atomic services contained in the bundle. @@ -174,12 +181,13 @@ depend on servicename, or on one of its components if it is a bundle.

    -

    s6-rc-db servicedir longrunname

    +

    s6-rc-db pipeline longrunname

    - Prints the service directory for longrun service longrunname; -this value is relative to the scandir. Exits 1 if -longrunname is not a valid longrun. + Prints the longrun service pipeline longrunname is a +part of, one service per line, producers before consumers. +If longrunname isn't +part of a pipeline, only longrunname is printed.

    s6-rc-db script oneshotname

    @@ -190,8 +198,7 @@ an argv, i.e. a Unix command line. Each component of this command line is terminated by a null character, so to print it in a human-readable format, pipe the output into something like -xargs -0 echo. The command exits 1 if oneshotname -is not a valid oneshot. +xargs -0 echo.

    @@ -203,8 +210,7 @@ is not a valid oneshot.

    Prints a hexadecimal number that is the list of all binary flags -for atomic service atomicname. Exits 1 if atomicname -is not a valid atomic service. +for atomic service atomicname.

    @@ -219,8 +225,7 @@ future version of s6-rc. servicename... arguments, i.e. the union of all atomic services contained in servicename.... Each argument in servicename... can be an atomic service or -a bundle. If an argument isn't a valid identifier, the command -exits 1. +a bundle.

    s6-rc-db all-dependencies servicename...

    @@ -232,8 +237,7 @@ dependencies, recursively. In other words: for servicename... to be up, every single service listed in the output will need to be up. The output includes the atomic services represented by the -servicename... arguments themselves. If one of those -arguments isn't a valid identifier, the command exits 1. +servicename... arguments themselves.

    -- cgit v1.3.1