NAME
update-service - add/remove a service to/from system-wide service
supervision
SYNOPSIS
update-service --add|--remove service-directory [service-name]
update-service --list|--check [service-name]
DESCRIPTION
service-directory must be a directory to be used by runsv(8), service-
name must not start with a dot, and must not contain a slash.
update-service adds or removes the service-directory to the system-wide
service supervision provided through runit ’s runsvdir(8), lists all
registered system-wide services, or checks for a specific service-name
whether it is registered.
When adding a service, and the service-directory resides in /etc/,
update-service makes sure that the ./supervise/ subdirectories in the
service-directory, and the optional service-directory/log/, are
symbolic links pointing into /var/lib/supervise/, unless they already
are symbolic links.
OPTIONS
--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.
ENVIRONMENT
SVDIR The environment variable $SVDIR overrides the default services
directory /etc/service/.
FILES
/etc/service/
SEE ALSO
sv(8), runsv(8), runsvdir(8)
http://smarden.org/runit/
AUTHOR
Gerrit Pape <pape@smarden.org>
update-service(8)