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)