45 lines
		
	
	
		
			1.6 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
			
		
		
	
	
			45 lines
		
	
	
		
			1.6 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
daemonitor
 | 
						||
========================================================================
 | 
						||
Copyright: ©2007–2012, Güralp Systems Limited
 | 
						||
Author: Laurence Withers <lwithers@guralp.com>
 | 
						||
License: GPLv3
 | 
						||
 | 
						||
See file COPYING for detail license information.
 | 
						||
 | 
						||
Really Quick Instructions
 | 
						||
-------------------------
 | 
						||
 | 
						||
To build: ./make.sh
 | 
						||
To install: ./make.sh install
 | 
						||
 | 
						||
You might want to edit 'config' first. You might also want to set
 | 
						||
'INSTALL_PREFIX', which is prepended onto the destination of any installed
 | 
						||
file.
 | 
						||
 | 
						||
Introduction
 | 
						||
------------
 | 
						||
 | 
						||
Daemonitor is a daemon which starts and monitors a child process. It is
 | 
						||
intended to be used with foreground child processes (e.g. daemons with a
 | 
						||
foreground mode, or long-running processes which are always in the
 | 
						||
foreground). Taken together, the daemonitor instance and its child process
 | 
						||
represent a "standard" UNIX daemon process (i.e. backgrounded, PID file,
 | 
						||
etc.).
 | 
						||
 | 
						||
The true purpose of daemonitor is to provide a robust way of monitoring
 | 
						||
services under e.g. openrc, which provides a mechanism for starting, stopping
 | 
						||
and querying services but does not have any automatic monitoring of its own.
 | 
						||
Thus if a daemon or service crashes, this will not be recorded or addressed
 | 
						||
by the system.
 | 
						||
 | 
						||
Daemonitor is a very small daemon which itself never exits. Its simple design
 | 
						||
and single purpose should ensure that it is robust against various conditions
 | 
						||
that may arise in the system (out of disk space, out of memory, ...), and
 | 
						||
that it is unlikely to crash due to bugs. The process it monitors can then
 | 
						||
crash or exit or be killed and daemonitor will detect this and restart it.
 | 
						||
 | 
						||
Instructions
 | 
						||
------------
 | 
						||
 | 
						||
TODO
 |