From 87b8fcabeecf2a9cff2ca596da54d6c1cf17d89f Mon Sep 17 00:00:00 2001 From: Laurent Bercot Date: Sun, 14 Jun 2026 04:37:32 +0000 Subject: Prepare for 0.7.0.0; lots of changes! - s6-rc-bundle deleted. Changing bundles without recompiling is not supported anymore. (It works, but it incentivizes poor workflows; it is better to handle stuff at the source level and recompile when in doubt, that's what s6-frontend does.) - new db format, need to recompile and use s6-rc-format-upgrade on new live db - support for the reload-signal file in service directories - new reload scripts for oneshots (which is why the db format has changed) - new "s6-rc reload" command, calling s6-svc -l on longruns (which makes use of reload-signal, HUP by default) and the reload script on oneshots - the live state now tracks when a service has been explicitly brought up as opposed to by pulled by dependencies. Nothing uses the feature for now but now the tech is there for an auto-stop-if-unneeded feature. --- doc/s6-rc-bundle.html | 138 -------------------------------------------------- 1 file changed, 138 deletions(-) delete mode 100644 doc/s6-rc-bundle.html (limited to 'doc/s6-rc-bundle.html') diff --git a/doc/s6-rc-bundle.html b/doc/s6-rc-bundle.html deleted file mode 100644 index fbe8d06..0000000 --- a/doc/s6-rc-bundle.html +++ /dev/null @@ -1,138 +0,0 @@ - - - - - - - s6-rc: the s6-rc-bundle program - - - - - - -

-s6-rc
-Software
-skarnet.org -

- -

The s6-rc-bundle program

- -

- s6-rc-bundle is a tool to add or delete bundles from a compiled -service database without having to recompile it from source. -

- -

- It is an offline tool, i.e. you can run it on any -compiled service database without actually having a live set -of services managed by s6-rc. However, if you do have a live -set, you can still run s6-rc-bundle on the current database (and -it is the default); it won't interfere with your normal service -operation. -

- -

Interface

- -

-     s6-rc-bundle help
-     s6-rc-bundle [ -f ] [ -l live ] [ -c compiled ] [ -b ] add bundlename contents...
-     s6-rc-bundle [ -f ] [ -l live ] [ -c compiled ] [ -b ] delete bundlenames...
-     s6-rc-bundle [ -f ] [ -l live ] [ -c compiled ] [ -b ] multiple args...
-

- -

s6-rc-bundle expects to find a compiled service database -in compiled; by default it uses the service database -used by the live state in live.
Depending on the arguments, it adds a bundle definition to this database, or -deletes a bundle definition from it, or performs multiple additions/deletions.

- -

Options

- -

-c compiled : operate on a -compiled service database in compiled instead of -the current live one.
-l live : assume the live -state is in live. This option is ignored if the --c option has been given. Default is -/run/s6-rc. The default can be changed at package -compilation time, by giving the --livedir=live -option to ./configure.
-f : force. s6-rc-bundle will not complain -when given a nonexisting name to delete (it will do nothing), or -when given an existing name to add (it will replace the definition). -By default, s6-rc-bundle will complain and exit when asked to delete a -nonexistent name or to add an existing name.
-b : blocking lock. If the database is currently -being used by another program, s6-rc-bundle will wait until that -other program has released its lock on the database, then proceed. -By default, s6-rc-bundle fails with an error message if the database -is currently in use.

- -

Exit codes

- -

0: success
1: identifier already exists in service database
3: identifier not found in service database
4: invalid or corrupted service database
5: wrong identifier type for the given command
100: wrong usage
111: system call failed

- -

Subcommands

- -

s6-rc-bundle help

- -

- Prints a help message on stdout. -

- -

s6-rc-bundle add bundlename contents...

- -

- Adds a bundle named bundlename to the database, representing -the services listed in contents. The arguments in contents... -are resolved before the database is modified by the -s6-rc-bundle invocation. -

- -

s6-rc-bundle delete bundlenames...

- -

- Deletes bundles listed in bundlenames.... -

- -

s6-rc-bundle multiple args...

- -

- Performs multiple bundle deletions and additions. This subcommand is best -used in an execline -script, because it uses -blocks. -

- -

-args... is composed of: -

- -

One block listing bundle names that will be -deleted from the database.
Zero or more addition definitions, each of them composed of: -
- One argument that is the name of the bundle to add
- One block listing the services contained in the -new bundle. The names in the block are resolved before any addition -or deletion is made to the database.

- - - -- cgit v1.3.1