Proccontrol

From University of Washington - Ubicomp Research Page
Revision as of 22:56, 17 August 2007 by Karl Koscher (talk | contribs) (→‎Typical Usage)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigationJump to search

proccontrol

proccontrol is a program which launches and monitors all of the other processes involved in the MSP data collection. proccontrol can be controlled via IPC to start and stop processes. Additionally, it can listen for heartbeat messages over IPC to detect hung processes, and publish a list of process states.

usage

    Typical Usage

      proccontrol process.ini
      

      where process.ini will typically contain:

      msb-server  msb    1 0  /msp/msb-server -ini /msp/msb.ini
      #lsb-server lsb    1 0  /msp/lsb-server.loop
      #gps-server gps    1 0  /msp/gps-server /dev/ttyS2 38400 /msp/enableDGPS.bin
      logger      logger 1 0  /msp/logger -ini /msp/logger.ini
      #gps-debug  gps    1 0  /msp/gps-debug > /dev/null
      #cam-server camera 1 0  /msp/cam-server.loop
      

      The file name is optional. If left unspecified, it will default to process.ini.

    process.ini

      process.ini specifies which processes to run and monitor. Each line of process.ini specifies a process, except for comments, which begin with #. The format of each line is:
      <process name> <process group> <startup state> <heartbeat flag> <command line>

      If the startup state is 1, the process will be started as soon as proccontrol does. Otherwise, the proccontrol will wait to start it until instructed to via IPC. If the heartbeat flag is non-zero, proccontrol will listen for heartbeat IPC messages from the process, and restart the process if a heartbeat hasn't been sent for two seconds.