shutdown_alerter.cpp

Go to the documentation of this file.

#ifndef SHUTDOWN_ALERTER_IMPLEMENTATION_FILE
#define SHUTDOWN_ALERTER_IMPLEMENTATION_FILE

/*****************************************************************************\
*                                                                             *
*  Name   : shutdown_alerter                                                  *
*  Author : Chris Koeritz                                                     *
*                                                                             *
*******************************************************************************
* Copyright (c) 2003-$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 "process_control.h"
#include "process_entry.h"
#include "shutdown_alerter.h"

#include <basis/array.cpp>
#include <basis/istring.h>
#include <basis/log_base.h>
#include <basis/mutex.h>
#include <basis/portable.h>
#include <basis/set.cpp>
#include <data_struct/static_memory_gremlin.h>
#include <mechanisms/time_stamp.h>
#include <opsystem/filename.h>
#include <opsystem/timer_driver.h>

#include <signal.h>

//#define DEBUG_SHUTDOWN_ALERTER
  // uncomment for noisy version.

#undef LOG
#define LOG(s) CLASS_EMERGENCY_LOG(program_wide_logger(), s)


SAFE_STATIC(istring_object, shutdown_alerter::_app_name, )

bool &shutdown_alerter::_defunct() { static bool _defu = false; return _defu; }

bool &shutdown_alerter::_saw_interrupt()
{ static bool _saw = false; return _saw; }

int &shutdown_alerter::_timer_period() { static int _tim = 0; return _tim; }


static shutdown_alerter *_global_shutdown_alerter = NIL;
  // this static object is set by the setup() method.  it should only come
  // into existence once during a program's lifetime.

shutdown_alerter::shutdown_alerter()
{
}

shutdown_alerter::~shutdown_alerter()
{
  set_defunct();
  if (_global_shutdown_alerter) {
    program_wide_timer().zap_timer(_global_shutdown_alerter);
  }
}

void shutdown_alerter::handle_startup() { /* nothing for base class. */ }

void shutdown_alerter::handle_shutdown() { /* nothing for base class. */ }

void shutdown_alerter::handle_timer() { /* nothing for base class. */ }

void shutdown_alerter::handle_timer_callback()
{ 
  // don't invoke the user's timer unless the object is still alive.
  if (!is_defunct()) handle_timer();
}

void shutdown_alerter::close_this_program()
{
  set_defunct();
}

bool shutdown_alerter::close_application(const istring &app_name)
{
  FUNCDEF("close_application");
  process_entry_array procs;
  process_control querier;

  // lookup process ids of apps.
  bool got_list = querier.query_processes(procs);
  if (!got_list) {
    LOG("couldn't get process list.");
    return false;
  }
  int_set pids;
  got_list = querier.find_process_in_list(procs, app_name, pids);
  if (!got_list) {
    LOG("couldn't find process in the list of active ones.");
    return true;
  }

  // zap all of them using our signal.
  for (int i = 0; i < pids.length(); i++) {
//would linux be better served with sigterm also?
#ifdef __UNIX__
    kill(pids[i], SIGHUP);
#endif
#ifdef __WIN32__
//lame--goes to whole program.
    raise(SIGTERM);
#endif
//hmmm: check results...
  }

  return true;
}

void shutdown_alerter::handle_OS_signal(int formal(sig_id))
{
  _saw_interrupt() = true;  // save the status.
  if (_global_shutdown_alerter) {
    _global_shutdown_alerter->close_this_program();
  }
}

void shutdown_alerter::set_defunct()
{
  _defunct() = true;
}

bool shutdown_alerter::setup(const istring &app_name, int timer_period)
{
//hmmm: make sure not already initted.

  // simple initializations first...
  _timer_period() = timer_period;
  _app_name() = app_name;

  _global_shutdown_alerter = this;

  // setup signal handler for HUP signal.  this is the one used to tell us
  // to leave.
#ifdef __UNIX__
  signal(SIGHUP, handle_OS_signal);
#endif

  // setup a handler for interrupt (e.g. ctrl-C) also.
  signal(SIGINT, handle_OS_signal);
#ifdef __WIN32__
  signal(SIGBREAK, handle_OS_signal);
#endif

  return true;
}

bool shutdown_alerter::launch_console(shutdown_alerter &alert,
    const istring &app_name, int timer_period)
{
  FUNCDEF("launch_console");
  if (!alert.setup(app_name, timer_period)) return false;

  alert.handle_startup();  // tell the program it has started up.

  // start a timer if they requested one.
  if (_timer_period()) {
    program_wide_timer().set_timer(_timer_period(), &alert);
  }

#ifdef DEBUG_SHUTDOWN_ALERTER
  time_stamp next_report(10 * SECOND_ms);
#endif

  while (!alert.is_defunct()) {
#ifdef DEBUG_SHUTDOWN_ALERTER
    if (time_stamp() >= next_report) {
      printf("%s: shout out from my main thread yo.\n", __argv[0]);
      next_report.reset(10 * SECOND_ms);
    }
#endif
    portable::sleep_ms(42);
  }
  alert.handle_shutdown();
  return true;
}

/*
#ifdef __WIN32__
bool shutdown_alerter::launch_event_loop(shutdown_alerter &alert,
    const istring &app_name, int timer_period)
{
  if (!alert.setup(app_name, timer_period)) return false;
  alert.handle_startup();

  if (timer_period)
    program_wide_timer().set_timer(timer_period, this);

  MSG msg;
  msg.hwnd = 0; msg.message = 0; msg.wParam = 0; msg.lParam = 0;
  while (!alert.is_defunct() && (GetMessage(&msg, NIL, 0, 0)) {
    TranslateMessage(&msg);
    DispatchMessage(&msg);
  }
  alert.handle_shutdown();

  return true;
}
#endif
*/



#endif //SHUTDOWN_ALERTER_IMPLEMENTATION_FILE

---