update-service - add/remove a service to/from system-wide service supervision
--list|--check [ service-name]
must be a directory to be used by runsv
must not start with a dot, and must not contain a slash.
adds or removes the service-directory
system-wide service supervision provided through runit 's runsvdir
lists all registered system-wide services, or checks for a specific
whether it is registered.
When adding a service, and the service-directory
resides in /etc/,
makes sure that the ./supervise/ subdirectories in the
, and the optional service-directory
symbolic links pointing into /var/lib/supervise/, unless they already are
- --add | -a
- Add the service directory service-directory to the
system-wide service supervision, under the name service-name. If
service-name is not specified, update-service will use the
basename of service-directory. You can use the sv(8) program
to control the newly added service, or query its status, e.g.:
# sv status service-name
- --remove | -r
- Remove the service directory service-directory,
which has been added under the name service-name, from the
system-wide service supervision. If service-name is not specified,
update-service will use the basename of service-directory.
When removing the service-directory, the exit command is
sent to the corresponding runsv(8) process, telling it to take the
service down and exit afterwards. You can use the sv(8) program to
control the removed service, or query its status, e.g.:
# sv status service-directory
- --list | -l
- If service-name is specified, update-service
checks whether service-name is registered as system-wide service,
prints a message and exits non-zero if not, or prints the
service-name and the directory it points to and exits zero if yes.
If service-name is not specified, it prints the names of all
system-widely registered services, one per line.
- --check | -c
- The same as --list, but update-service doesn't print
anything to standard out or standard error.
- The environment variable $SVDIR overrides the default
services directory /etc/service/.
sv(8), runsv(8), runsvdir(8)
Gerrit Pape <email@example.com>