cpsv(8)

NAME
cpsv - utility to install and manage runit services

SYNOPSIS
cpsv [-f] -a <service-name> ...
cpsv [-f] --sync
cpsv -d <service-name>
cpsv --list

DESCRIPTION
cpsv is a tool to install and manage runscripts available in /usr/share/runit/sv/. Usually packages install runscripts in /etc/sv/. However packages that provide a large number of runscripts without the corresponding binaries may install services into /usr/share/runit/sv/ and let the sysadmin decide whether a service should be also available into /etc/sv/

OPTIONS

-a  Copy /usr/share/runit/sv/<service> into /etc/sv/ and create supervise symlinks. If /etc/sv/<service> already exists and the force flag is not given, cpsv prints a warning, the cp invocation is skipped and the return code is increased by one. More than one <service> name can be given and each <service> directory must exists into /usr/share/runit/sv/

-f  Overwrite the service directory /etc/sv/<service> with the stock version provided in /usr/share/runit/sv/<service>. No backup is provided.

-d  Print a diff between /usr/share/runit/sv/<service> and /etc/sv/<service>. The directory /usr/share/runit/sv/<service> must exists. Cprun return the exit status of diff.

--sync
    For each <service> available under /usr/share/runit/sv/ cpsv looks for a systemd or sysv service file with the same name: if it finds one then it copies <service> into /etc/sv/. If <service> already exists in /etc/sv/ cpsv does not overwrite it unless the force flag is given.

--list
    For each <service> available under /usr/share/runit/sv/ cpsv looks for a systemd or sysv service file with the same name: if it finds one then it prints a character surronded by square brakets, followed by the name of the service.
    [a]: <service> is available in /usr/share/runit/sv/ but it doesn't exists under /etc/sv/
    [i]: <service> is available in /usr/share/runit/sv/ and an identical copy exists in /etc/sv/
    [l]: <service> is available in /usr/share/runit/sv/ and an local (different) copy exists in /etc/sv/

BUGS
Combining flags, like cpsv -fa service is not supported, all merged short options are error.

AUTHOR
Lorenzo Puliti <plorenzo@disroot.org>

SEE ALSO
update-service(8)