TAO/orbsvcs/ImplRepo_Service/Activator_Options.h

   1 // -*- C++ -*-
   2
   3 //=============================================================================
   4 /**
   5  *  @file   Activator_Options.h
   6  *
   7  *  @brief  Definition of the Options class for the Implementation Repository.
   8  *
   9  *  @author Darrell Brunsch <brunsch@cs.wustl.edu>
  10  */
  11 //=============================================================================
  12
  13 #ifndef ACTIVATOR_OPTIONS_H
  14 #define ACTIVATOR_OPTIONS_H
  15
  16 #include "activator_export.h"
  17
  18 #include "ace/SString.h"
  19
  20 #if !defined (ACE_LACKS_PRAGMA_ONCE)
  21 # pragma once
  22 #endif /* ACE_LACKS_PRAGMA_ONCE */
  23
  24 /**
  25  * @class Options
  26  *
  27  * This is where all the settings for TAO's Implementation Repository are
  28  * stored.
  29  */
  30 class Activator_Export Activator_Options
  31 {
  32 public:
  33   enum SERVICE_COMMAND {
  34     SC_NONE,
  35     SC_INSTALL,
  36     SC_REMOVE,
  37     SC_INSTALL_NO_LOCATOR
  38   };
  39
  40   // This default is based on the value from ACE_Process_Options
  41   // however, the real value is protected -- CAE 4/16/2007
  42   enum ACTIVATOR_PROCESS
  43   {
  44     ENVIRONMENT_BUFFER = 16 * 1024,
  45     ENVIRONMENT_MAX_VARS = 512
  46   };
  47
  48   Activator_Options ();
  49
  50   /// Parse the command-line arguments and initialize the options.
  51   int init (int argc, ACE_TCHAR *argv[]);
  52   /// This version should only be used when run as an nt service.
  53   int init_from_registry();
  54
  55   /// Service Mode
  56   bool service () const;
  57
  58   /// Notify the ImR when server processes die.
  59   /// @note Currently this only works on Unix.
  60   bool notify_imr () const;
  61
  62   /// When notifying of child death, pause this number of milliseconds
  63   /// to simulate a heavily loaded server.
  64   unsigned int induce_delay () const;
  65
  66   /// Debug level for the Implementation Repository.
  67   unsigned int debug () const;
  68
  69   /// Returns the file where the IOR should be stored.
  70   const ACE_TString& ior_filename () const;
  71
  72   /// The nt service command to run (install/remove)
  73   SERVICE_COMMAND service_command() const;
  74
  75   /// Save the command line arguments as registry settings. (Windows only)
  76   int save_registry_options ();
  77
  78   const char* cmdline() const;
  79
  80   const ACE_CString& name() const;
  81
  82   int env_buf_len () const;
  83
  84   int max_env_vars () const;
  85
  86   bool detach_child () const;
  87
  88 private:
  89   /// Parses and pulls out arguments for the ImR
  90   int parse_args (int &argc, ACE_TCHAR *argv[]);
  91
  92   /// Print the usage information.
  93   void print_usage () const;
  94
  95   /// Loads options from the registry
  96   int load_registry_options ();
  97
  98 private:
  99   /// Our extra command line arguments
 100   ACE_CString cmdline_;
 101
 102   /// Debug level.
 103   unsigned int debug_;
 104
 105   /// File where the IOR of the server object is stored.
 106   ACE_TString ior_output_file_;
 107
 108   /// Should we run as a service?
 109   bool service_;
 110
 111   /// Notify the ImR when server processes die.
 112   /// @note Currently this only works on Unix.
 113   bool notify_imr_;
 114
 115   /// When notifying of child death, pause this number of milliseconds
 116   /// to simulate a heavily loaded server.
 117   unsigned int induce_delay_;
 118
 119   /// SC_NONE, SC_INSTALL, SC_REMOVE, ...
 120   SERVICE_COMMAND service_command_;
 121
 122   ACE_CString name_;
 123
 124   /// The default environment buffer length
 125   int env_buf_len_;
 126
 127   /// Maximum number of environment variables
 128   int max_env_vars_;
 129
 130   /// Control signal handling related to child processes
 131   bool detach_child_;
 132 };
 133
 134 #endif