|CATSITD(8)||FreeBSD System Manager's Manual||CATSITD(8)|
catsitddaemon is a process supervisor for FreeBSD and OpenBSD. It is designed to supervise processes with the following behavior:
- The process runs in the foreground, not as a daemon.
- The process logs to standard output or standard error.
- The process handles errors by exiting and expects to be restarted.
- The process indicates its reason for exiting with sysexits(3).
catsitd daemon spawns processes for a
list of services, redirects their output to syslog, and
restarts the processes when they exit according to their exit status.
Exponential backoff is applied to automatic restarts.
The list of services is defined in a
catsit.conf(5) file. The services
catsitd can be controlled through a named
pipe. The catsit(8) utility is a wrapper
for writing to the named pipe, and its manual page describes the control
The arguments are as follows:
- Change directory to path before starting services. By default the working directory is /.
- Set the path of the named pipe used for service control.
- Do not run as a daemon. Log to standard error as well as syslog.
- Set the path of the catsit.conf(5) file.
- Change group to group before starting services. If
-uis set, the default group is the user's group.
- Write the PID of the
catsitdprocess to pidfile.
- Set the interval in milliseconds for which a process must live to have its service restart interval reset to the initial value. The default interval is 15 minutes.
- Set the list of exit statuses for which a restart will not be attempted.
The stopexits argument is a comma-separated list of
integers. The default list contains the values of
EX_CANTCREATdefined in sysexits(3). The exit statuses 126 and 127 are always treated as stop exits.
- Set the initial interval in milliseconds between automatic restarts. This interval is doubled each time a service is automatically restarted. The default interval is 1 second.
- Change user to user before starting services. Services which are privileged are started without changing user. The catsit.conf(5) manual page describes privileged services.
catsitd daemon takes the following
actions in response to signals:
- The catsit.conf(5) file is reloaded. Services are not automatically started, stopped or restarted. Removed services can be dropped with catsit(8).
- The named pipe used for service control is closed and unlinked. All
services are stopped, after which
- The current status of all services is logged.
|August 16, 2020||FreeBSD 12.2-RELEASE-p7|