Skip to content

Latest commit

 

History

History
67 lines (54 loc) · 3.36 KB

README.md

File metadata and controls

67 lines (54 loc) · 3.36 KB
Raw

daemontools - collection of tools for managing UNIX services

This is a significant rewrite of daemontools written by djb. This version of daaemontools is a component of indimail-mta, but can be used independently.

Few of the changes are

  1. run shutdown script in dir/shutdown on svc -d, svc -r
  2. run alert scripts when services go down abnormally
  3. systemctl unit file for linux, rc for FreeBSD, launchd unit file for OSX
  4. Use of /run, /var/run to allow readonly service directory
  5. Logging of svscan output
  6. Private namespace for filesystems mounted by services under svscan
  7. Configurable scan interval
  8. Run initializtion commands on svscan startup
  9. Addtional actions in svc command (-r, -1, -2)
  10. svps command to pretty print service status
  11. Ability for a service to wait for another service
  12. New fifo supervise/up which services can open to test if service is up or down.
  13. Additional information in svstat (wait status, supervise pid)
  14. rpm/debian packages along with create_rpm, create_debian scripts
  15. Return the status of supervise/service in svstat itself.
  16. enhanced envdir utility that can load environment variables from multiple directories and -c option to clear existing environment variables on startup.
  17. man pages for all commands
  18. docker-entrypoint to svscan
  19. functional as init replacement in docker/podman environment.
  20. ability to become session leader if SETSID env variable is set
  21. create .svscan.pid file
  22. Linked with libqmail to avoid duplication of functions and ease of maintenance. This also implies use of substdio interface instead of buffer interface for standard input / output

Build daemontools

To configure the build for daemontools, you need to configure conf-prefix, conf-qmail, conf-sysconfdir, conf-shared, conf-libexec and conf-servicedir. Defaults are given in the table below. If you are ok with the defaults, you can run the script default.configure to set the below values.

Linux

config file value
conf-prefix /usr
conf-qmail /var/indimail
conf-sysconfdir /etc/indimail
conf-shared /usr/share/indimail
conf-libexec /usr/libexec/indimail
conf-servicedir /service

FreeBSD, Darwin

config file value
conf-prefix /usr/local
conf-qmail /var/indimail
conf-sysconfdir /usr/local/etc/indimail
conf-shared /usr/local/share/indimail
conf-libexec /usr/local/libexec/indimail
conf-servicedir /usr/local/etc/indimail/sv

The build below depends on several Makefiles. For the build to operate without errors, you need to run default.configure the first time and everytime after you do a make clean. If you don't run default.configure, you can run replace make with ./qmake

$ ./default.configure
$ cd /usr/local/src/indimail-mta/daemontools-x
$ make or ./qmake
$ sudo make install or sudo ./qmake install

(check version in indimail-mta/daemontools-x/conf-version)

For more details look at README