STEER/AliLog.h

   1 #ifndef ALILOG_H
   2 #define ALILOG_H
   3 /* Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. *
   4  * See cxx source for full Copyright notice                               */
   5
   6 /* $Id$ */
   7
   8 ///
   9 /// class for logging debug, info and error messages
  10 ///
  11
  12 #include <TObject.h>
  13 #include <TObjArray.h>
  14 #include <TString.h>
  15
  16
  17 class AliLog: public TObject {
  18  public:
  19   AliLog();
  20   virtual ~AliLog();
  21   static AliLog* Instance() {return fgInstance;}
  22
  23   enum EType_t {kFatal = 0, kError, kWarning, kInfo, kDebug, kMaxType};
  24   typedef void (*AliLogNotification)(EType_t type, const char* message );
  25
  26
  27   static void  EnableDebug(Bool_t enabled);
  28   static void  SetGlobalLogLevel(EType_t type);
  29   static Int_t GetGlobalLogLevel();
  30   static void  SetGlobalDebugLevel(Int_t level);
  31   static Int_t GetGlobalDebugLevel();
  32   static void  SetModuleDebugLevel(const char* module, Int_t level);
  33   static void  ClearModuleDebugLevel(const char* module);
  34   static void  SetClassDebugLevel(const char* className, Int_t level);
  35   static void  ClearClassDebugLevel(const char* className);
  36
  37   static void  SetStandardOutput();
  38   static void  SetStandardOutput(EType_t type);
  39   static void  SetErrorOutput();
  40   static void  SetErrorOutput(EType_t type);
  41   static void  SetFileOutput(const char* fileName);
  42   static void  SetFileOutput(EType_t type, const char* fileName);
  43   static void  SetStreamOutput(ostream* stream);
  44   static void  SetStreamOutput(EType_t type, ostream* stream);
  45   static void  SetLogNotification(AliLogNotification pCallBack);
  46   static void  SetLogNotification(EType_t type, AliLogNotification pCallBack);
  47   static void  Flush();
  48
  49   static void  SetHandleRootMessages(Bool_t on);
  50
  51   static void  SetPrintType(Bool_t on);
  52   static void  SetPrintType(EType_t type, Bool_t on);
  53   static void  SetPrintModule(Bool_t on);
  54   static void  SetPrintModule(EType_t type, Bool_t on);
  55   static void  SetPrintScope(Bool_t on);
  56   static void  SetPrintScope(EType_t type, Bool_t on);
  57   static void  SetPrintLocation(Bool_t on);
  58   static void  SetPrintLocation(EType_t type, Bool_t on);
  59
  60   static void  SetPrintRepetitions(Bool_t on);
  61
  62   static void  WriteToFile(const char* name, Int_t option = 0);
  63
  64   // the following public methods are used by the preprocessor macros
  65   // and should not be called directly
  66   static Bool_t IsDebugEnabled() {return fgDebugEnabled;}
  67   static Int_t GetDebugLevel(const char* module, const char* className);
  68   static void  Message(UInt_t level, const char* message,
  69                        const char* module, const char* className,
  70                        const char* function, const char* file, Int_t line);
  71   static void  Debug(UInt_t level, const char* message,
  72                      const char* module, const char* className,
  73                      const char* function, const char* file, Int_t line);
  74
  75   static Int_t RedirectStdoutTo(EType_t type, UInt_t level, const char* module,
  76                                 const char* className, const char* function,
  77                                 const char* file, Int_t line, Bool_t print);
  78   static Int_t RedirectStderrTo(EType_t type, UInt_t level, const char* module,
  79                                 const char* className, const char* function,
  80                                 const char* file, Int_t line, Bool_t print);
  81   static void  RestoreStdout(Int_t original);
  82   static void  RestoreStderr(Int_t original);
  83
  84   static ostream& Stream(EType_t type, UInt_t level,
  85                          const char* module, const char* className,
  86                          const char* function, const char* file, Int_t line);
  87
  88  private:
  89   AliLog(const AliLog& log);
  90   AliLog& operator = (const AliLog& log);
  91
  92   void           ReadEnvSettings();
  93
  94   static void    RootErrorHandler(Int_t level, Bool_t abort,
  95                                   const char* location, const char* message);
  96
  97   void           CloseFile(Int_t type);
  98   FILE*          GetOutputStream(Int_t type);
  99
 100   UInt_t         GetLogLevel(const char* module, const char* className) const;
 101   void           PrintMessage(UInt_t type, const char* message,
 102                               const char* module, const char* className,
 103                               const char* function,
 104                               const char* file, Int_t line);
 105
 106   void           PrintString(Int_t type, FILE* stream, const char* format, ...);
 107   void           PrintRepetitions();
 108
 109   Int_t          RedirectTo(FILE* stream, EType_t type, UInt_t level,
 110                             const char* module, const char* className,
 111                             const char* function,
 112                             const char* file, Int_t line, Bool_t print);
 113
 114   ostream&       GetStream(EType_t type, UInt_t level,
 115                            const char* module, const char* className,
 116                            const char* function, const char* file, Int_t line);
 117
 118   enum {kDebugOffset = kDebug-1};
 119
 120   static AliLog* fgInstance;                 //! pointer to current instance
 121
 122   static Bool_t  fgDebugEnabled;             // flag for debug en-/disabling
 123
 124   UInt_t         fGlobalLogLevel;            // global logging level
 125   TObjArray      fModuleDebugLevels;         // debug levels for modules
 126   TObjArray      fClassDebugLevels;          // debug levels for classes
 127
 128   Int_t          fOutputTypes[kMaxType];     // types of output streams
 129   TString        fFileNames[kMaxType];       // file names
 130   FILE*          fOutputFiles[kMaxType];     //! log output files
 131   ostream*       fOutputStreams[kMaxType];   //! log output streams
 132
 133   Bool_t         fPrintType[kMaxType];       // print type on/off
 134   Bool_t         fPrintModule[kMaxType];     // print module on/off
 135   Bool_t         fPrintScope[kMaxType];      // print scope/class name on/off
 136   Bool_t         fPrintLocation[kMaxType];   // print file and line on/off
 137
 138   Bool_t         fPrintRepetitions;          // print number of repetitions instead of repeated message on/off
 139
 140   Int_t          fRepetitions;               //! counter of repetitions
 141   UInt_t         fLastType;                  //! type of last message
 142   TString        fLastMessage;               //! last message
 143   TString        fLastModule;                //! module name of last message
 144   TString        fLastClassName;             //! class name of last message
 145   TString        fLastFunction;              //! function name of last message
 146   TString        fLastFile;                  //! file name of last message
 147   Int_t          fLastLine;                  //! line number of last message
 148   AliLogNotification fCallBacks[kMaxType];   //! external notification callback
 149
 150   ClassDef(AliLog, 1)   // class for logging debug, info and error messages
 151 };
 152
 153
 154 // module name
 155 #ifdef _MODULE_
 156 #define MODULENAME() _MODULE_
 157 #else
 158 #define MODULENAME() "NoModule"
 159 #endif
 160
 161 // function name
 162 #if defined(__GNUC__) || defined(__ICC) || defined(__ECC) || defined(__APPLE__)
 163 #define FUNCTIONNAME() __FUNCTION__
 164 // #elif defined(__HP_aCC) || defined(__alpha) || defined(__DECCXX)
 165 // #define FUNCTIONNAME() __FUNC__
 166 #else
 167 #define FUNCTIONNAME() "???"
 168 #endif
 169
 170 // redirection
 171 #define REDIRECTSTDOUT(type, level, scope, whatever) {Int_t originalStdout = AliLog::RedirectStdoutTo(type, level, MODULENAME(), scope, FUNCTIONNAME(), __FILE__, __LINE__, kFALSE); whatever; AliLog::RestoreStdout(originalStdout);}
 172 #define REDIRECTSTDERR(type, level, scope, whatever) {Int_t originalStderr = AliLog::RedirectStderrTo(type, level, MODULENAME(), scope, FUNCTIONNAME(), __FILE__, __LINE__, kFALSE); whatever; AliLog::RestoreStderr(originalStderr);}
 173 #define REDIRECTSTDOUTANDSTDERR(type, level, scope, whatever) {Int_t originalStdout = AliLog::RedirectStdoutTo(type, level, MODULENAME(), scope, FUNCTIONNAME(), __FILE__, __LINE__, kFALSE); Int_t originalStderr = AliLog::RedirectStderrTo(type, level, MODULENAME(), scope, FUNCTIONNAME(), __FILE__, __LINE__, kFALSE); whatever; AliLog::RestoreStderr(originalStderr); AliLog::RestoreStdout(originalStdout);}
 174
 175
 176 // debug level
 177 #ifdef LOG_NO_DEBUG
 178 #define AliDebugLevel() -1
 179 #define AliDebugLevelClass() -1
 180 #define AliDebugLevelGeneral(scope) -1
 181 #else
 182 #define AliDebugLevel() ((AliLog::IsDebugEnabled()) ? AliLog::GetDebugLevel(MODULENAME(), ClassName()) : -1)
 183 #define AliDebugLevelClass() ((AliLog::IsDebugEnabled()) ? AliLog::GetDebugLevel(MODULENAME(), Class()->GetName()) : -1)
 184 #define AliDebugLevelGeneral(scope) ((AliLog::IsDebugEnabled()) ? AliLog::GetDebugLevel(MODULENAME(), scope) : -1)
 185 #endif
 186
 187 // debug messages
 188 #ifdef LOG_NO_DEBUG
 189 #define AliDebug(level, message)
 190 #define AliDebugClass(level, message)
 191 #define AliDebugGeneral(scope, level, message)
 192 #else
 193 #define AliDebug(level, message) {if (AliLog::IsDebugEnabled()) AliLog::Debug(level, message, MODULENAME(), ClassName(), FUNCTIONNAME(), __FILE__, __LINE__);}
 194 #define AliDebugClass(level, message) {if (AliLog::IsDebugEnabled()) AliLog::Debug(level, message, MODULENAME(), Class()->GetName(), FUNCTIONNAME(), __FILE__, __LINE__);}
 195 #define AliDebugGeneral(scope, level, message) {if (AliLog::IsDebugEnabled()) AliLog::Debug(level, message, MODULENAME(), scope, FUNCTIONNAME(), __FILE__, __LINE__);}
 196 #endif
 197
 198 // redirection to debug
 199 #define StdoutToAliDebug(level, whatever) REDIRECTSTDOUT(AliLog::kDebug, level, ClassName(), whatever)
 200 #define StderrToAliDebug(level, whatever) REDIRECTSTDERR(AliLog::kDebug, level, ClassName(), whatever)
 201 #define ToAliDebug(level, whatever) REDIRECTSTDOUTANDSTDERR(AliLog::kDebug, level, ClassName(), whatever)
 202 #define StdoutToAliDebugClass(level, whatever) REDIRECTSTDOUT(AliLog::kDebug, level, Class()->GetName(), whatever)
 203 #define StderrToAliDebugClass(level, whatever) REDIRECTSTDERR(AliLog::kDebug, level, Class()->GetName(), whatever)
 204 #define ToAliDebugClass(level, whatever) REDIRECTSTDOUTANDSTDERR(AliLog::kDebug, level, Class()->GetName(), whatever)
 205 #define StdoutToAliDebugGeneral(scope, level, whatever) REDIRECTSTDOUT(AliLog::kDebug, level, scope, whatever)
 206 #define StderrToAliDebugGeneral(scope, level, whatever) REDIRECTSTDERR(AliLog::kDebug, level, scope, whatever)
 207 #define ToAliDebugGeneral(scope, level, whatever) REDIRECTSTDOUTANDSTDERR(AliLog::kDebug, level, scope, whatever)
 208
 209 // debug stream objects
 210 #define AliDebugStream(level) AliLog::Stream(AliLog::kDebug, level, MODULENAME(), ClassName(), FUNCTIONNAME(), __FILE__, __LINE__)
 211 #define AliDebugClassStream(level) AliLog::Stream(AliLog::kDebug, level, MODULENAME(), Class()->GetName(), FUNCTIONNAME(), __FILE__, __LINE__)
 212 #define AliDebugGeneralStream(scope, level) AliLog::Stream(AliLog::kDebug, level, MODULENAME(), scope, FUNCTIONNAME(), __FILE__, __LINE__)
 213
 214
 215 // info messages
 216 #ifdef LOG_NO_INFO
 217 #define AliInfo(message)
 218 #define AliInfoClass(message)
 219 #define AliInfoGeneral(scope, message)
 220 #else
 221 #define AliInfo(message) {AliLog::Message(AliLog::kInfo, message, MODULENAME(), ClassName(), FUNCTIONNAME(), __FILE__, __LINE__);}
 222 #define AliInfoClass(message) {AliLog::Message(AliLog::kInfo, message, MODULENAME(), Class()->GetName(), FUNCTIONNAME(), __FILE__, __LINE__);}
 223 #define AliInfoGeneral(scope, message) {AliLog::Message(AliLog::kInfo, message, MODULENAME(), scope, FUNCTIONNAME(), __FILE__, __LINE__);}
 224 #endif
 225
 226 // redirection to info
 227 #define StdoutToAliInfo(whatever) REDIRECTSTDOUT(AliLog::kInfo, 0, ClassName(), whatever)
 228 #define StderrToAliInfo(whatever) REDIRECTSTDERR(AliLog::kInfo, 0, ClassName(), whatever)
 229 #define ToAliInfo(whatever) REDIRECTSTDOUTANDSTDERR(AliLog::kInfo, 0, ClassName(), whatever)
 230 #define StdoutToAliInfoClass(whatever) REDIRECTSTDOUT(AliLog::kInfo, 0, Class()->GetName(), whatever)
 231 #define StderrToAliInfoClass(whatever) REDIRECTSTDERR(AliLog::kInfo, 0, Class()->GetName(), whatever)
 232 #define ToAliInfoClass(whatever) REDIRECTSTDOUTANDSTDERR(AliLog::kInfo, 0, Class()->GetName(), whatever)
 233 #define StdoutToAliInfoGeneral(scope, whatever) REDIRECTSTDOUT(AliLog::kInfo, 0, scope, whatever)
 234 #define StderrToAliInfoGeneral(scope, whatever) REDIRECTSTDERR(AliLog::kInfo, 0, scope, whatever)
 235 #define ToAliInfoGeneral(scope, whatever) REDIRECTSTDOUTANDSTDERR(AliLog::kInfo, 0, scope, whatever)
 236
 237 // info stream objects
 238 #define AliInfoStream() AliLog::Stream(AliLog::kInfo, 0, MODULENAME(), ClassName(), FUNCTIONNAME(), __FILE__, __LINE__)
 239 #define AliInfoClassStream() AliLog::Stream(AliLog::kInfo, 0, MODULENAME(), Class()->GetName(), FUNCTIONNAME(), __FILE__, __LINE__)
 240 #define AliInfoGeneralStream(scope) AliLog::Stream(AliLog::kInfo, 0, MODULENAME(), scope, FUNCTIONNAME(), __FILE__, __LINE__)
 241
 242
 243 // warning messages
 244 #ifdef LOG_NO_WARNING
 245 #define AliWarning(message)
 246 #define AliWarningClass(message)
 247 #define AliWarningGeneral(scope, message)
 248 #else
 249 #define AliWarning(message) {AliLog::Message(AliLog::kWarning, message, MODULENAME(), ClassName(), FUNCTIONNAME(), __FILE__, __LINE__);}
 250 #define AliWarningClass(message) {AliLog::Message(AliLog::kWarning, message, MODULENAME(), Class()->GetName(), FUNCTIONNAME(), __FILE__, __LINE__);}
 251 #define AliWarningGeneral(scope, message) {AliLog::Message(AliLog::kWarning, message, MODULENAME(), scope, FUNCTIONNAME(), __FILE__, __LINE__);}
 252 #endif
 253
 254 // redirection to warning
 255 #define StdoutToAliWarning(whatever) REDIRECTSTDOUT(AliLog::kWarning, 0, ClassName(), whatever)
 256 #define StderrToAliWarning(whatever) REDIRECTSTDERR(AliLog::kWarning, 0, ClassName(), whatever)
 257 #define ToAliWarning(whatever) REDIRECTSTDOUTANDSTDERR(AliLog::kWarning, 0, ClassName(), whatever)
 258 #define StdoutToAliWarningClass(whatever) REDIRECTSTDOUT(AliLog::kWarning, 0, Class()->GetName(), whatever)
 259 #define StderrToAliWarningClass(whatever) REDIRECTSTDERR(AliLog::kWarning, 0, Class()->GetName(), whatever)
 260 #define ToAliWarningClass(whatever) REDIRECTSTDOUTANDSTDERR(AliLog::kWarning, 0, Class()->GetName(), whatever)
 261 #define StdoutToAliWarningGeneral(scope, whatever) REDIRECTSTDOUT(AliLog::kWarning, 0, scope, whatever)
 262 #define StderrToAliWarningGeneral(scope, whatever) REDIRECTSTDERR(AliLog::kWarning, 0, scope, whatever)
 263 #define ToAliWarningGeneral(scope, whatever) REDIRECTSTDOUTANDSTDERR(AliLog::kWarning, 0, scope, whatever)
 264
 265 // warning stream objects
 266 #define AliWarningStream() AliLog::Stream(AliLog::kWarning, 0, MODULENAME(), ClassName(), FUNCTIONNAME(), __FILE__, __LINE__)
 267 #define AliWarningClassStream() AliLog::Stream(AliLog::kWarning, 0, MODULENAME(), Class()->GetName(), FUNCTIONNAME(), __FILE__, __LINE__)
 268 #define AliWarningGeneralStream(scope) AliLog::Stream(AliLog::kWarning, 0, MODULENAME(), scope, FUNCTIONNAME(), __FILE__, __LINE__)
 269
 270
 271 // error messages
 272 #define AliError(message) {AliLog::Message(AliLog::kError, message, MODULENAME(), ClassName(), FUNCTIONNAME(), __FILE__, __LINE__);}
 273 #define AliErrorClass(message) {AliLog::Message(AliLog::kError, message, MODULENAME(), Class()->GetName(), FUNCTIONNAME(), __FILE__, __LINE__);}
 274 #define AliErrorGeneral(scope, message) {AliLog::Message(AliLog::kError, message, MODULENAME(), scope, FUNCTIONNAME(), __FILE__, __LINE__);}
 275
 276 // redirection to error
 277 #define StdoutToAliError(whatever) REDIRECTSTDOUT(AliLog::kError, 0, ClassName(), whatever)
 278 #define StderrToAliError(whatever) REDIRECTSTDERR(AliLog::kError, 0, ClassName(), whatever)
 279 #define ToAliError(whatever) REDIRECTSTDOUTANDSTDERR(AliLog::kError, 0, ClassName(), whatever)
 280 #define StdoutToAliErrorClass(whatever) REDIRECTSTDOUT(AliLog::kError, 0, Class()->GetName(), whatever)
 281 #define StderrToAliErrorClass(whatever) REDIRECTSTDERR(AliLog::kError, 0, Class()->GetName(), whatever)
 282 #define ToAliErrorClass(whatever) REDIRECTSTDOUTANDSTDERR(AliLog::kError, 0, Class()->GetName(), whatever)
 283 #define StdoutToAliErrorGeneral(scope, whatever) REDIRECTSTDOUT(AliLog::kError, 0, scope, whatever)
 284 #define StderrToAliErrorGeneral(scope, whatever) REDIRECTSTDERR(AliLog::kError, 0, scope, whatever)
 285 #define ToAliErrorGeneral(scope, whatever) REDIRECTSTDOUTANDSTDERR(AliLog::kError, 0, scope, whatever)
 286
 287 // error stream objects
 288 #define AliErrorStream() AliLog::Stream(AliLog::kError, 0, MODULENAME(), ClassName(), FUNCTIONNAME(), __FILE__, __LINE__)
 289 #define AliErrorClassStream() AliLog::Stream(AliLog::kError, 0, MODULENAME(), Class()->GetName(), FUNCTIONNAME(), __FILE__, __LINE__)
 290 #define AliErrorGeneralStream(scope) AliLog::Stream(AliLog::kError, 0, MODULENAME(), scope, FUNCTIONNAME(), __FILE__, __LINE__)
 291
 292
 293 // fatal messages
 294 #define AliFatal(message) {AliLog::Message(AliLog::kFatal, message, MODULENAME(), ClassName(), FUNCTIONNAME(), __FILE__, __LINE__);}
 295 #define AliFatalClass(message) {AliLog::Message(AliLog::kFatal, message, MODULENAME(), Class()->GetName(), FUNCTIONNAME(), __FILE__, __LINE__);}
 296 #define AliFatalGeneral(scope, message) {AliLog::Message(AliLog::kFatal, message, MODULENAME(), scope, FUNCTIONNAME(), __FILE__, __LINE__);}
 297
 298 #endif