process_manager.h

Go to the documentation of this file.

#ifndef PROCESS_MANAGER_CLASS
#define PROCESS_MANAGER_CLASS

/*****************************************************************************\
*                                                                             *
*  Name   : process_manager                                                   *
*  Author : Chris Koeritz                                                     *
*                                                                             *
*******************************************************************************
* Copyright (c) 2000-$now By Author.  This program is free software; you can  *
* redistribute it and/or modify it under the terms of the GNU General Public  *
* License as published by the Free Software Foundation; either version 2 of   *
* the License or (at your option) any later version.  This is online at:      *
*     http://www.fsf.org/copyleft/gpl.html                                    *
* Please send any updates to: fred@gruntose.com                               *
\*****************************************************************************/

#include "dll_processes.h"

#include <basis/object_base.h>

// forward.
class application_config;
class graceful_array;
class istring;
class int_set;
class mutex;
class outcome;
class process_manager_thread;
class process_entry_array;
class process_control;
class string_set;
class time_stamp;


class PROCESSES_CLASS_STYLE process_manager
{
public:
  process_manager(application_config &config);

  virtual ~process_manager();

  IMPLEMENT_CLASS_NAME("process_manager");

  enum outcomes {
    OKAY = common::OKAY,
    EXISTING = common::EXISTING,
    ACCESS_DENIED = common::ACCESS_DENIED,

    DEFINE_API_OUTCOME(FILE_NOT_FOUND, -53, "The file specified for the "
        "application doesn't exist, as far as we can tell"),
    FIRST_OUTCOME = FILE_NOT_FOUND,  // hold onto start of range.
    DEFINE_API_OUTCOME(NO_PRODUCT, -54, "The product specified does not exist"),
    DEFINE_API_OUTCOME(NO_APPLICATION, -55, "The application is not listed for "
        "the product"),
    DEFINE_API_OUTCOME(NOT_RUNNING, -56, "The program is not currently active, "
        "according to the OS process list"),
    DEFINE_API_OUTCOME(BAD_PROGRAM, -57, "The file existed but doesn't appear "
        "to be a valid program image"),
    DEFINE_API_OUTCOME(NO_ANCHOR, -58, "This occurs when the graceful shutdown "
        "process cannot find the special anchor window that implements the "
        "client side of a graceful shutdown"),
    DEFINE_API_OUTCOME(LAUNCH_FAILED, -59, "The program existed and seemed "
        "valid but its launch failed for some reason"),
    DEFINE_API_OUTCOME(FROZEN, -60, "The application is broken somehow; the "
        "system reports it as non-responsive"),
    LAST_OUTCOME = FROZEN  // hold onto end of range.
  };

  static const char *outcome_name(const outcome &to_name);

  outcome launch_now(const istring &product, const istring &app_name,
          const istring &parameters);

  outcome launch_at_startup(const istring &product, const istring &app_name,
          const istring &parameters, int one_shot);

  outcome remove_from_startup(const istring &product, const istring &app_name);

  outcome query_application(const istring &product, const istring &app_name);

  outcome zap_process(const istring &product, const istring &app_name,
          bool graceful);

  void add_gag_exclusion(const istring &exclusion);

  void add_tracking_exclusion(const istring &exclusion);

  outcome shut_down_launching_services(const istring &secret_word);

  outcome reenable_launching_services(const istring &secret_word);

  bool services_disabled() const { return _stop_launching; }

  void push_timed_activities(process_entry_array &processes);

  void stop_everything();

private:
  application_config &_configs;  
  bool _started_initial_apps;  
  process_manager_thread *_checker;  
  mutex *_config_lock;  
  graceful_array *_going_down;  
  mutex *_zombie_lock;  
  graceful_array *_our_kids;  
  mutex *_scamp_lock;  
  bool _stop_launching;  
  time_stamp *_startup_time;

  process_control *_procs;  
  string_set *_gag_exclusions;  
  string_set *_tracking_exclusions;  

  bool get_processes(process_entry_array &processes);

  bool find_process(const istring &app_name, int_set &pids);

  outcome start_graceful_close(const istring &product, const istring &app_name);

  void launch_startup_apps();

  void stop_all_kids();
};

#endif

---