ircproxy  The Ultimate Cyborg

---

Application.h

Go to the documentation of this file.

// ircproxy -- An IRC bouncer.
//
//! @file Application.h
//! @brief This file contains the declaration of class Application.
//
// Copyright (C) 2006, 2007 by
//
// Carlo Wood, Run on IRC <carlo@alinoe.com>
// RSA-1024 0x624ACAD5 1997-01-26                    Sign & Encrypt
// Fingerprint16 = 32 EC A7 B6 AC DB 65 A6  F6 F6 55 DD 1C DC FF 61
//
// This file may be distributed under the terms of the Q Public License
// version 1.0 as appearing in the file LICENSE.QPL included in the
// packaging of this file.

#ifndef TARGET_H
// Must be included before Application.h
#include "Target.h"
#endif

#ifndef APPLICATION_H
#define APPLICATION_H

#ifndef USE_PCH
#include <libcw/libcw_app.h>
#endif

#include "networks_type.h"
#include "identities_type.h"

class PersistXML;

/*! @brief The application singleton
 *
 * This class represents the application itself.
 * It is a singleton and needs to be accessed through Application::instance().
 */
class Application : public libcw_app_tct<Application> {
#ifndef DOXYGEN
  friend_Instance;                              // See documentation of libcw.
#endif
private:
  unsigned short M_listen_port;                 //!< The listen port the IRC proxy listens on.
#ifdef CWDEBUG
  bool M_suppress_ping;                         //!< True if PING/PONG debug messages should be suppressed.
  bool M_suppress_who;                          //!< True if WHO debug messages should be suppressed.
#endif
  networks_type M_networks;                     //!< List with all known networks.
  identities_type M_identities;                 //!< Map with all known identities.
  memory_block_st* M_memory_block_dummy;        //!< Dummy variable used during construction.
  msg_block_ct M_msg_block_dummy;               //!< Used for MessageIn objects not related to a real message block.
  bool M_terminating;                           //!< Set to true when the application should terminate after the last ServerSession is destructed.

private:
  Application(void);

  //! Called when a signal is received (SIGINT or SIGHUP).
  void handle_signal(SignalType const&);

public:
  ~Application() throw();

  //! A const reference to an STL container with all known networks.
  networks_type const& networks(void) const { return M_networks; }

  //! A reference to the STL container with all known networks.
  networks_type& networks(void) { return M_networks; }

  //! A const reference to a map with all known identities.
  identities_type const& identities(void) const { return M_identities; }

  //! A reference to the map with all known identities.
  identities_type& identities(void) { return M_identities; }

  //! A dummy message block that can be used as place holder.
  msg_block_ct& dummy_msg_block(void) { return M_msg_block_dummy; }

protected:
  virtual void start(void);
  virtual void finish_options(void);
  virtual void print_version(std::ostream&) const;
#ifdef CWDEBUG
  virtual void main_entered(int* argc_ptr, char* const** argv_ptr);
#endif

protected:
  void command_line_option_listen_port(char const* argument);
  void command_line_option_suppress_ping(char const* argument);
  void command_line_option_suppress_who(char const* argument);

public:
  void serialize(PersistXML& xml);
#ifdef CWDEBUG
  bool suppress_ping(void) const { return M_suppress_ping; }
  bool suppress_who(void) const { return M_suppress_who; }
#endif

  //! This function is called from the destructor of the last ServerSession.
  void last_server_session_destroyed(void);
};

#endif // APPLICATION_H

---