LinuxCommandLibrary

runsvdir

TLDR

Start supervising services

$ runsvdir [/etc/service]
copy
With logging
$ runsvdir -P [/etc/service] log
copy
Set scan interval
$ SVDIR=[/etc/service] runsvdir
copy

SYNOPSIS

runsvdir [-P] dir [log]

DESCRIPTION

runsvdir supervises a directory of services. It starts runsv for each subdirectory.
Scanning detects new and removed services. Services appear/disappear dynamically.
Each subdirectory becomes a supervised service. The directory must contain a run script.
Symlinks work for service enabling. Point from service directory to actual service.
The -P flag sets process groups. Enables signal delivery to all service processes.

PARAMETERS

-P

Set child process group.
dir
Service directory.
log
Log command.

SERVICE MANAGEMENT

- Create symlink in dir: service starts
- Remove symlink: service stops
- sv command controls individual services

CAVEATS

Usually started by runit init. Continuous scanning uses resources. Permissions must be correct.

HISTORY

runsvdir is the service directory supervisor in runit. It watches for service directories and manages runsv processes for each.

SEE ALSO

runit(8), runsv(8), sv(8), runsvchdir(8)

Copied to clipboard