Man page - pidproxy(1)

Packages contains this manual

Package: supervisor
apt-get install supervisor

Manuals in package:

Documentations in package:

supervisor

Manual

PIDPROXY

NAME
OVERVIEW
pidproxy Program
GLOSSARY
AUTHOR
COPYRIGHT

NAME

pidproxy - Supervisor pidproxy Documentation

Supervisor is a client/server system that allows its users to monitor and control a number of processes on UNIX-like operating systems.

It shares some of the same goals of programs like launchd, daemontools, and runit. Unlike some of these programs, it is not meant to be run as a substitute for init as "process id 1". Instead it is meant to be used to control processes related to a project or a customer, and is meant to start like any other program at boot time.

OVERVIEW

pidproxy Program

Some processes (like mysqld ) ignore signals sent to the actual process which is spawned by supervisord . Instead, a "special" thread/process is created by these kinds of programs which is responsible for handling signals. This is problematic because supervisord can only kill a process which it creates itself. If a process created by supervisord creates its own child processes, supervisord cannot kill them.

Fortunately, these types of programs typically write a "pidfile" which contains the "special" process' PID, and is meant to be read and used in order to kill the process. As a workaround for this case, a special pidproxy program can handle startup of these kinds of processes. The pidproxy program is a small shim that starts a process, and upon the receipt of a signal, sends the signal to the pid provided in a pidfile. A sample configuration program entry for a pidproxy-enabled program is provided below.

[program:mysql]
command=/path/to/pidproxy /path/to/pidfile /path/to/mysqld_safe

The pidproxy program is put into your configuration's $BINDIR when supervisor is installed (it is a "console script").

GLOSSARY

daemontools

A process control system by D.J. Bernstein .

runit

A process control system .

AUTHOR

This man page was created by Orestis Ioannou <orestis@oioannou.com> using the official documentation.

COPYRIGHT

2004-2015, Agendaless Consulting and Contributors