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