pidfilehack(8) [debian man page]

pidfilehack(8)						      System Manager's Manual						    pidfilehack(8)

NAME

       pidfilehack - work around daemons that always fork

SYNOPSIS

       pidfilehack servicename pidfile command [parameters]

DESCRIPTION

       pidfilehack is used to work around daemons that insist on forking into the background, but that do write a correct pid file.

       pidfilehack  forks  the	actual	service,  then waits for the pidfile to be written. Once it can read the pid from the pidfile it will tell
       minit the real pid and quit.

USAGE

       usually pidfilehack is symlinked as run command of a service.

       servicename
	      the name of the service pidfilehack is installed for.

       pidfile
	      the filename to read the pid from

       command
	      the real command to start

       parameters
	      additional parameters for the command

	      A typical use of this command will look like this:

       /etc/minit/apache

       /etc/minit/apache/params
	      apache
	      /var/run/apache.pid
	      apachectl
	      start

       /etc/minit/apache/run
	      -> /sbin/pidfilehack

AUTHOR

       minit was written by Felix von Leitner and can be downloaded from his page at http://www.fefe.de/minit/

       This manpage was written by Erich Schubert <erich@debian.org> for the Debian GNU/Linux operating system.

SEE ALSO

       msvc(8), pidfilehack(8)

																    pidfilehack(8)

msvc(8) 						      System Manager's Manual							   msvc(8)

NAME

       msvc - control minit

SYNOPSIS

       msvc [ -[uodpchaitko] ] [ -P pid ] service [...]

DESCRIPTION

       msvc  is the management interface to minit.  service is the service directory name relative to /etc/minit.  Starting with minit 0.9 you can
       also include /etc/minit/ in the service name.

OPTIONS

       If no option is given, msvc will just print a small diagnostic message to stdout, saying if the service is up, down or finished, which  PID
       it has if it is up, and for how long it has been in this state.

       -u   Up.  If the service is not running, start it.  If the service stops, restart it.

       -o   Once.  If the service is not running, start it.  If the service stops, do not restart it.

       -d   Down.  If the service is running, send it a TERM signal and then a CONT signal.  After it stops, do not restart it.

       -p   Pause.  Send the service a STOP signal.

       -c   Continue.  Send the service a CONT signal.

       -h   Hangup.  Send the service a HUP signal.

       -a   Alarm.  Send the service an ALRM signal.

       -i   Interrupt.	Send the service an INT signal.

       -t   Terminate.	Send the service a TERM signal.

       -k   Terminate.	Send the service a KILL signal.

       -P pid
	    Set PID.  Tell minit the PID of the service is really pid.	This is useful for services that fork themselves in the background but put
	    their real PID in a file, typically called /var/run/service.pid.  Used by pidfilehack.

       -D service
	    Print dependencies.  This will print all the names of all the services that were started  because  this  services  depended  on  them.
	    Please  note  that this is not done recursively (i.e. if default depends on qmail and qmail depends on log, this will print qmail, not
	    qmail/log.	But msvc -D qmail will print qmail/log).

       -H   Print history.  This will print the names of the ten least recently spawned processes.  This is useful if you see  a  process  looping
	    (initialization fails and minit is restarting it all the time).

RETURN CODES

       Generally,  msvc  return zero if everything is OK or 1 on error (could not open /lib/minit/in or /lib/minit/out or there is no process with
       the given name).  In diagnostic mode, it will exit 0 if the service is up, 2 if it is down or 3 if it is finished.

SEE ALSO

       pidfilehack(8), svc(8)

																	   msvc(8)