ACE/ace/Log_Record.h

   1 // -*- C++ -*-
   2
   3 //=============================================================================
   4 /**
   5  *  @file    Log_Record.h
   6  *
   7  *  @author Douglas C. Schmidt <d.schmidt@vanderbilt.edu>
   8  */
   9 //=============================================================================
  10
  11 // These need to go outside of the #ifdef to avoid problems with
  12 // circular dependencies...
  13
  14 #include "ace/Log_Priority.h"
  15
  16 #ifndef ACE_LOG_RECORD_H
  17 #define ACE_LOG_RECORD_H
  18 #include /**/ "ace/pre.h"
  19
  20 #include /**/ "ace/ACE_export.h"
  21
  22 #if !defined (ACE_LACKS_PRAGMA_ONCE)
  23 # pragma once
  24 #endif /* ACE_LACKS_PRAGMA_ONCE */
  25
  26 #include "ace/Default_Constants.h"
  27 #include "ace/Basic_Types.h"
  28 #include "ace/iosfwd.h"
  29
  30 ACE_BEGIN_VERSIONED_NAMESPACE_DECL
  31
  32 class ACE_Time_Value;
  33 class ACE_Log_Category_TSS;
  34
  35 /// Defines the structure of an ACE logging record.
  36 class ACE_Export ACE_Log_Record
  37 {
  38 public:
  39   enum
  40   {
  41     /// Maximum size of a logging message.
  42     MAXLOGMSGLEN = ACE_MAXLOGMSGLEN+1,
  43
  44     /// Most restrictive alignment.
  45     ALIGN_WORDB  = 8,
  46
  47     /// Size used by verbose mode.
  48     /// 20 (date) + 15 (host_name) + 10 (pid) + 10 (type)
  49     ///           + 4 (@) ... + ? (progname)
  50     VERBOSE_LEN = 128,
  51
  52     /// Maximum size of a logging message with the verbose headers
  53     MAXVERBOSELOGMSGLEN = VERBOSE_LEN + MAXLOGMSGLEN
  54   };
  55
  56   // = Initialization
  57   /**
  58    * Create a Log_Record and set its priority, time stamp, and
  59    * process id.
  60    */
  61   ACE_Log_Record (void);
  62   ACE_Log_Record (ACE_Log_Priority lp,
  63                   time_t time_stamp,
  64                   long pid);
  65   ACE_Log_Record (ACE_Log_Priority lp,
  66                   const ACE_Time_Value &time_stamp,
  67                   long pid);
  68
  69   /// Default dtor.
  70   ~ACE_Log_Record (void);
  71
  72   /// Write the contents of the logging record to the appropriate
  73   /// FILE if the corresponding type is enabled.
  74   int print (const ACE_TCHAR host_name[],
  75              u_long verbose_flag,
  76 #if !defined (ACE_HAS_WINCE) && !defined (ACE_LACKS_STDERR)
  77              FILE *fp = stderr);
  78 #else
  79              FILE *fp);
  80 #endif /* ACE_HAS_WINCE */
  81
  82 #if !defined (ACE_LACKS_IOSTREAM_TOTALLY)
  83   /// Write the contents of the logging record to the appropriate
  84   /// @a stream if the corresponding type is enabled.
  85   int print (const ACE_TCHAR host_name[],
  86              u_long verbose_flag,
  87              ACE_OSTREAM_TYPE &stream);
  88 #endif /* ! ACE_LACKS_IOSTREAM_TOTALLY */
  89
  90   int format_msg (const ACE_TCHAR host_name[],
  91                   u_long verbose_flag,
  92                   ACE_TCHAR *verbose_msg,
  93                   size_t verbose_msg_size);
  94
  95   /**
  96    * Returns a character array with the string form of the
  97    * ACE_Log_Priority parameter.  This is used for the verbose
  98    * printing format.
  99    */
 100   static const ACE_TCHAR *priority_name (ACE_Log_Priority p);
 101
 102   /// IMPORTANT: @a name must be a statically allocated const ACE_TCHAR*
 103   static void priority_name (ACE_Log_Priority p, const ACE_TCHAR *name);
 104
 105   /// Get the type of the Log_Record.
 106   ACE_UINT32 type (void) const;
 107
 108   /// Set the type of the Log_Record.
 109   void type (ACE_UINT32);
 110
 111   /// Get the category of the Log_Record.
 112   ACE_Log_Category_TSS* category (void) const;
 113   /// Set the category of the Log_Record.
 114   void category (ACE_Log_Category_TSS*);
 115
 116   /**
 117    * Get the priority of the Log_Record <type_>.  This is computed
 118    * as the base 2 logarithm of <type_> (which must be a power of 2,
 119    * as defined by the enums in ACE_Log_Priority).
 120    */
 121   u_long priority (void) const;
 122
 123   /// Set the priority of the Log_Record <type_> (which must be a
 124   /// power of 2, as defined by the enums in ACE_Log_Priority).
 125   void priority (u_long num);
 126
 127   /// Get the total length of the Log_Record, which includes the
 128   /// size of the various data member fields.
 129   long length (void) const;
 130
 131   /// Set the total length of the Log_Record, which needs to account for
 132   /// the size of the various data member fields.
 133   void length (long);
 134
 135   /// Get the time stamp of the Log_Record.
 136   ACE_Time_Value time_stamp (void) const;
 137
 138   /// Set the time stamp of the Log_Record.
 139   void time_stamp (const ACE_Time_Value &ts);
 140
 141   /// Get the process id of the Log_Record.
 142   long pid (void) const;
 143
 144   /// Set the process id of the Log_Record.
 145   void pid (long);
 146
 147   /// Get the message data of the Log_Record.
 148   const ACE_TCHAR *msg_data (void) const;
 149
 150   /// Set the message data of the record. If @a data is longer than the
 151   /// current msg_data_ buffer, a new msg_data_ buffer is allocated to
 152   /// fit. If such a reallocation faisl, this method returns -1, else 0.
 153   int msg_data (const ACE_TCHAR *data);
 154
 155   /// Get the size of the message data of the Log_Record, including
 156   /// a byte for the NUL.
 157   size_t msg_data_len (void) const;
 158
 159   /// Dump the state of an object.
 160   void dump (void) const;
 161
 162   /// Declare the dynamic allocation hooks.
 163   ACE_ALLOC_HOOK_DECLARE;
 164
 165 private:
 166   /// Round up to the alignment restrictions.
 167   void round_up (void);
 168
 169   /**
 170    * Total length of the logging record in bytes.  This field *must*
 171    * come first in order for various IPC framing mechanisms to work
 172    * correctly.  In addition, the field must be an ACE_INT32 in order
 173    * to be passed portably across platforms.
 174    */
 175   ACE_INT32 length_;
 176
 177   /// Type of logging record.
 178   ACE_UINT32 type_;
 179
 180   /// Time that the logging record was generated.
 181   time_t secs_;
 182   ACE_UINT32 usecs_;
 183
 184   /// Id of process that generated the logging record.
 185   ACE_UINT32 pid_;
 186
 187   /// Logging record data
 188   ACE_TCHAR *msg_data_;   // Heap-allocated text message area
 189
 190   /// Allocated size of msg_data_ in ACE_TCHARs
 191   size_t msg_data_size_;
 192
 193   ///
 194   ACE_Log_Category_TSS* category_;
 195
 196   /// disallow copying...
 197   ACE_Log_Record (const ACE_Log_Record& rhs);
 198   ACE_Log_Record& operator= (const ACE_Log_Record& rhs);
 199 };
 200
 201 // Forward decls.
 202 class ACE_InputCDR;
 203 class ACE_OutputCDR;
 204
 205 // iostream operators for ACE_Log_Record.
 206 ACE_Export int operator>> (ACE_InputCDR &cdr, ACE_Log_Record &log_record);
 207 ACE_Export int operator<< (ACE_OutputCDR &cdr, const ACE_Log_Record &log_record);
 208
 209 ACE_END_VERSIONED_NAMESPACE_DECL
 210
 211 #if defined (__ACE_INLINE__)
 212 #include "ace/Log_Record.inl"
 213 #endif /* __ACE_INLINE__ */
 214
 215 #include /**/ "ace/post.h"
 216 #endif /* ACE_LOG_RECORD_H */