]>
Commit | Line | Data |
---|---|---|
6ab674bd | 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 | ||
44ce6bbe | 23 | enum EType_t {kFatal = 0, kError, kWarning, kInfo, kDebug, kMaxType}; |
1948744e | 24 | typedef void (*AliLogNotification)(EType_t type, const char* message ); |
25 | ||
6ab674bd | 26 | |
27 | static void EnableDebug(Bool_t enabled); | |
44ce6bbe | 28 | static void SetGlobalLogLevel(EType_t type); |
6ab674bd | 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(); | |
44ce6bbe | 38 | static void SetStandardOutput(EType_t type); |
6ab674bd | 39 | static void SetErrorOutput(); |
44ce6bbe | 40 | static void SetErrorOutput(EType_t type); |
6ab674bd | 41 | static void SetFileOutput(const char* fileName); |
44ce6bbe | 42 | static void SetFileOutput(EType_t type, const char* fileName); |
1948744e | 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); | |
6ab674bd | 47 | static void Flush(); |
48 | ||
49 | static void SetHandleRootMessages(Bool_t on); | |
50 | ||
51 | static void SetPrintType(Bool_t on); | |
44ce6bbe | 52 | static void SetPrintType(EType_t type, Bool_t on); |
6ab674bd | 53 | static void SetPrintModule(Bool_t on); |
44ce6bbe | 54 | static void SetPrintModule(EType_t type, Bool_t on); |
6ab674bd | 55 | static void SetPrintScope(Bool_t on); |
44ce6bbe | 56 | static void SetPrintScope(EType_t type, Bool_t on); |
6ab674bd | 57 | static void SetPrintLocation(Bool_t on); |
44ce6bbe | 58 | static void SetPrintLocation(EType_t type, Bool_t on); |
6ab674bd | 59 | |
45fa0297 | 60 | static void SetPrintRepetitions(Bool_t on); |
61 | ||
c4cb6153 | 62 | static void WriteToFile(const char* name, Int_t option = 0); |
6ab674bd | 63 | |
64 | // the following public methods are used by the preprocessor macros | |
65 | // and should not be called directly | |
20848f77 | 66 | static Bool_t IsDebugEnabled() {return fgDebugEnabled;} |
6ab674bd | 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 | ||
44ce6bbe | 75 | static Int_t RedirectStdoutTo(EType_t type, UInt_t level, const char* module, |
eeb769e2 | 76 | const char* className, const char* function, |
77 | const char* file, Int_t line, Bool_t print); | |
44ce6bbe | 78 | static Int_t RedirectStderrTo(EType_t type, UInt_t level, const char* module, |
eeb769e2 | 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 | ||
44ce6bbe | 84 | static ostream& Stream(EType_t type, UInt_t level, |
eeb769e2 | 85 | const char* module, const char* className, |
86 | const char* function, const char* file, Int_t line); | |
87 | ||
6ab674bd | 88 | private: |
89 | AliLog(const AliLog& log); | |
90 | AliLog& operator = (const AliLog& log); | |
91 | ||
eeb769e2 | 92 | void ReadEnvSettings(); |
93 | ||
6ab674bd | 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; | |
eeb769e2 | 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); | |
1948744e | 105 | |
106 | void PrintString(Int_t type, FILE* stream, const char* format, ...); | |
45fa0297 | 107 | void PrintRepetitions(); |
eeb769e2 | 108 | |
44ce6bbe | 109 | Int_t RedirectTo(FILE* stream, EType_t type, UInt_t level, |
eeb769e2 | 110 | const char* module, const char* className, |
111 | const char* function, | |
112 | const char* file, Int_t line, Bool_t print); | |
113 | ||
44ce6bbe | 114 | ostream& GetStream(EType_t type, UInt_t level, |
eeb769e2 | 115 | const char* module, const char* className, |
116 | const char* function, const char* file, Int_t line); | |
6ab674bd | 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 | |
1948744e | 131 | ostream* fOutputStreams[kMaxType]; //! log output streams |
6ab674bd | 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 | ||
45fa0297 | 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 | |
1948744e | 148 | AliLogNotification fCallBacks[kMaxType]; //! external notification callback |
45fa0297 | 149 | |
6ab674bd | 150 | ClassDef(AliLog, 1) // class for logging debug, info and error messages |
151 | }; | |
152 | ||
eeb769e2 | 153 | |
154 | // module name | |
eb5bc777 | 155 | #ifdef _MODULE_ |
156 | #define MODULENAME() _MODULE_ | |
eeb769e2 | 157 | #else |
158 | #define MODULENAME() "NoModule" | |
cd676389 | 159 | #endif |
eeb769e2 | 160 | |
161 | // function name | |
162 | #if defined(__GNUC__) || defined(__ICC) || defined(__ECC) || defined(__APPLE__) | |
163 | #define FUNCTIONNAME() __FUNCTION__ | |
92154bc0 | 164 | // #elif defined(__HP_aCC) || defined(__alpha) || defined(__DECCXX) |
165 | // #define FUNCTIONNAME() __FUNC__ | |
eeb769e2 | 166 | #else |
167 | #define FUNCTIONNAME() "???" | |
cd676389 | 168 | #endif |
6ab674bd | 169 | |
eeb769e2 | 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 | |
6ab674bd | 177 | #ifdef LOG_NO_DEBUG |
178 | #define AliDebugLevel() -1 | |
179 | #define AliDebugLevelClass() -1 | |
180 | #define AliDebugLevelGeneral(scope) -1 | |
181 | #else | |
eeb769e2 | 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) | |
6ab674bd | 185 | #endif |
186 | ||
eeb769e2 | 187 | // debug messages |
6ab674bd | 188 | #ifdef LOG_NO_DEBUG |
189 | #define AliDebug(level, message) | |
190 | #define AliDebugClass(level, message) | |
191 | #define AliDebugGeneral(scope, level, message) | |
192 | #else | |
eeb769e2 | 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__);} | |
6ab674bd | 196 | #endif |
197 | ||
eeb769e2 | 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 | |
6ab674bd | 216 | #ifdef LOG_NO_INFO |
217 | #define AliInfo(message) | |
218 | #define AliInfoClass(message) | |
219 | #define AliInfoGeneral(scope, message) | |
220 | #else | |
eeb769e2 | 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__);} | |
6ab674bd | 224 | #endif |
225 | ||
eeb769e2 | 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 | |
6ab674bd | 244 | #ifdef LOG_NO_WARNING |
245 | #define AliWarning(message) | |
246 | #define AliWarningClass(message) | |
247 | #define AliWarningGeneral(scope, message) | |
248 | #else | |
eeb769e2 | 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__);} | |
6ab674bd | 252 | #endif |
253 | ||
eeb769e2 | 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 | ||
6ab674bd | 292 | |
eeb769e2 | 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__);} | |
6ab674bd | 297 | |
298 | #endif |