mirror of
https://github.com/troglobit/finit.git
synced 2026-11-14 19:03:16 +00:00
doc: update service with pre:script and post:script actions
Signed-off-by: Joachim Wiberg <troglobit@gmail.com>
This commit is contained in:
1 parent
106516d12d
commit
01358a5a45
1 file changed
+23
@@ -396,6 +396,28 @@ process using a different signal, use the option `halt:SIGNAL`, e.g.,
|
|||||||
use the option `kill:SEC`, e.g., `kill:10` to wait 10 seconds before
|
use the option `kill:SEC`, e.g., `kill:10` to wait 10 seconds before
|
||||||
sending `SIGKILL`.
|
sending `SIGKILL`.
|
||||||
|
|
||||||
|
Services support `pre:script` and `post:script` actions as well. These
|
||||||
|
run as the same `@USER:GROUP` as the service itself, with any `env:file`
|
||||||
|
sourced. The scripts must use an absolute path, but are executed from
|
||||||
|
the `$HOME` of the given user. The scripts are not called with any
|
||||||
|
argument (currently), but both get the `SERVICE_IDENT=foo` environment
|
||||||
|
variable set. Here `foo` denotes the identity of the service, which if
|
||||||
|
there are multiple services named `foo`, may be `foo:1`, or any unique
|
||||||
|
identifier specified in the .conf file. The `post:script` is called
|
||||||
|
with an additional set of environment variables:
|
||||||
|
|
||||||
|
- `EXIT_CODE=[exited,signal]`: set to one of `exited` or `signal`
|
||||||
|
- `EXIT_STATUS=[num,SIGNAME]`: set to one of exit status code from
|
||||||
|
the program, if it exited normally, or the signal name (`HUP`,
|
||||||
|
`TERM`, etc.) if it exited due to signal
|
||||||
|
|
||||||
|
The scripts have a default execution time of 3 seconds before they are
|
||||||
|
SIGKILLed, this can be adjusted using the above `kill:SEC` syntax.
|
||||||
|
|
||||||
|
> **Note:** the `pre:script` _must_ be idempotent, because a service
|
||||||
|
> can transition between READY and HALTED states any number
|
||||||
|
> of times before going to RUNNING.
|
||||||
|
|
||||||
|
|
||||||
### Run-parts Scripts
|
### Run-parts Scripts
|
||||||
|
|
||||||
@@ -416,6 +438,7 @@ you will block Finit.
|
|||||||
|
|
||||||
> **Note:** only read and executed in runlevel S (bootstrap).
|
> **Note:** only read and executed in runlevel S (bootstrap).
|
||||||
|
|
||||||
|
|
||||||
### Including Finit Configs
|
### Including Finit Configs
|
||||||
|
|
||||||
**Syntax:** `include <CONF>`
|
**Syntax:** `include <CONF>`
|
||||||
|
|||||||
Reference in new issue
Block a user