Aaron Andersen
5f7e8457af
Similar to systemd's RemainAfterExit=yes. Prevents the task from
re-running on runlevel re-entry and ensures the post: script runs
when explicitly stopped or when leaving valid runlevels.
Useful for tasks that set up persistent state like firewall rules:
task [2345] remain:yes \
post:/usr/sbin/teardown-firewall \
/usr/sbin/setup-firewall -- Firewall setup
Not supported for bootstrap-only tasks (runlevel S only) since these
are deleted immediately after completion.
This section provides an overview of Finit's configuration system. For detailed information on specific topics, see the individual sections in the navigation menu.
Configuration File Syntax
The file format is line based, empty lines and comments, lines starting
with #, are ignored. A configuration directive starts with a keyword
followed by a space and the rest of the line is treated as the value.
As of Finit v4.4, configuration directives can be broken up in multiple
lines using the continuation character \, and trailing comments are
also allowed. Example:
# Escape \# chars if you want them literal in, e.g., descriptions
service name:sysklogd [S123456789] \
env:-/etc/default/sysklogd \
syslogd -F $SYSLOGD_ARGS \
-- System log daemon \# 1 # Comments allowed
The .conf files /etc/finit.conf and /etc/finit.d/* support many
directives. Some are restricted, e.g., only available at bootstrap,
runlevel S. Read on in Files & Layout for more on how
to structure your .conf files.
For details on restrictions, see Limitations.