// -------------------------------------------------------------------------- // // File // Name: Logging.h // Purpose: Generic logging core routines declarations and macros // Created: 2006/12/16 // // -------------------------------------------------------------------------- #ifndef LOGGING__H #define LOGGING__H #include #include #include #include #include #include #include "FileStream.h" #define BOX_LOG(level, stuff) \ { \ std::ostringstream _box_log_line; \ _box_log_line << stuff; \ Logging::Log(level, __FILE__, __LINE__, _box_log_line.str()); \ } #define BOX_SYSLOG(level, stuff) \ { \ std::ostringstream _box_log_line; \ _box_log_line << stuff; \ Logging::LogToSyslog(level, __FILE__, __LINE__, _box_log_line.str()); \ } #define BOX_FATAL(stuff) BOX_LOG(Log::FATAL, stuff) #define BOX_ERROR(stuff) BOX_LOG(Log::ERROR, stuff) #define BOX_WARNING(stuff) BOX_LOG(Log::WARNING, stuff) #define BOX_NOTICE(stuff) BOX_LOG(Log::NOTICE, stuff) #define BOX_INFO(stuff) BOX_LOG(Log::INFO, stuff) #define BOX_TRACE(stuff) \ if (Logging::IsEnabled(Log::TRACE)) \ { BOX_LOG(Log::TRACE, stuff) } #define BOX_SYS_ERRNO_MESSAGE(error_number, stuff) \ stuff << ": " << std::strerror(error_number) << \ " (" << error_number << ")" #define BOX_FILE_MESSAGE(filename, message) \ message << ": " << filename #define BOX_SYS_FILE_ERRNO_MESSAGE(filename, error_number, message) \ BOX_SYS_ERRNO_MESSAGE(error_number, BOX_FILE_MESSAGE(filename, message)) #define BOX_SYS_ERROR_MESSAGE(stuff) \ BOX_SYS_ERRNO_MESSAGE(errno, stuff) #define BOX_LOG_SYS_WARNING(stuff) \ BOX_WARNING(BOX_SYS_ERROR_MESSAGE(stuff)) #define BOX_LOG_SYS_ERROR(stuff) \ BOX_ERROR(BOX_SYS_ERROR_MESSAGE(stuff)) #define BOX_LOG_SYS_ERRNO(error_number, stuff) \ BOX_ERROR(BOX_SYS_ERRNO_MESSAGE(error_number, stuff)) #define BOX_LOG_SYS_FATAL(stuff) \ BOX_FATAL(BOX_SYS_ERROR_MESSAGE(stuff)) #define THROW_SYS_ERROR_NUMBER(message, error_number, exception, subtype) \ THROW_EXCEPTION_MESSAGE(exception, subtype, \ BOX_SYS_ERRNO_MESSAGE(error_number, message)) #define THROW_SYS_ERROR(message, exception, subtype) \ THROW_SYS_ERROR_NUMBER(message, errno, exception, subtype) #define THROW_SYS_FILE_ERROR(message, filename, exception, subtype) \ THROW_SYS_ERROR_NUMBER(BOX_FILE_MESSAGE(filename, message), \ errno, exception, subtype) #define THROW_SYS_FILE_ERRNO(message, filename, error_number, exception, subtype) \ THROW_SYS_ERROR_NUMBER(BOX_FILE_MESSAGE(filename, message), \ error_number, exception, subtype) #define THROW_FILE_ERROR(message, filename, exception, subtype) \ THROW_EXCEPTION_MESSAGE(exception, subtype, \ BOX_FILE_MESSAGE(filename, message)) #ifdef WIN32 #define BOX_LOG_WIN_ERROR(stuff) \ BOX_ERROR(stuff << ": " << GetErrorMessage(GetLastError())) #define BOX_LOG_WIN_WARNING(stuff) \ BOX_WARNING(stuff << ": " << GetErrorMessage(GetLastError())) #define BOX_LOG_WIN_ERROR_NUMBER(stuff, number) \ BOX_ERROR(stuff << ": " << GetErrorMessage(number)) #define BOX_LOG_WIN_WARNING_NUMBER(stuff, number) \ BOX_WARNING(stuff << ": " << GetErrorMessage(number)) #define BOX_LOG_NATIVE_ERROR(stuff) BOX_LOG_WIN_ERROR(stuff) #define BOX_LOG_NATIVE_WARNING(stuff) BOX_LOG_WIN_WARNING(stuff) #define BOX_WIN_ERRNO_MESSAGE(error_number, stuff) \ stuff << ": " << GetErrorMessage(error_number) #define THROW_WIN_ERROR_NUMBER(message, error_number, exception, subtype) \ THROW_EXCEPTION_MESSAGE(exception, subtype, \ BOX_WIN_ERRNO_MESSAGE(error_number, message)) #define THROW_WIN_FILE_ERRNO(message, filename, error_number, exception, subtype) \ THROW_WIN_ERROR_NUMBER(BOX_FILE_MESSAGE(filename, message), \ error_number, exception, subtype) #define THROW_WIN_FILE_ERROR(message, filename, exception, subtype) \ THROW_WIN_FILE_ERRNO(message, filename, GetLastError(), \ exception, subtype) #else #define BOX_LOG_NATIVE_ERROR(stuff) BOX_LOG_SYS_ERROR(stuff) #define BOX_LOG_NATIVE_WARNING(stuff) BOX_LOG_SYS_WARNING(stuff) #endif #ifdef WIN32 # define BOX_LOG_SOCKET_ERROR(_type, _name, _port, stuff) \ BOX_LOG_WIN_ERROR_NUMBER(stuff << " (type " << _type << ", name " << \ _name << ", port " << _port << ")", WSAGetLastError()) #else # define BOX_LOG_SOCKET_ERROR(_type, _name, _port, stuff) \ BOX_LOG_NATIVE_ERROR(stuff << " (type " << _type << ", name " << \ _name << ", port " << _port << ")") #endif #define BOX_FORMAT_HEX32(number) \ std::hex << \ std::showbase << \ std::internal << \ std::setw(10) << \ std::setfill('0') << \ (number) << \ std::dec #define BOX_FORMAT_ACCOUNT(accno) \ BOX_FORMAT_HEX32(accno) #define BOX_FORMAT_OBJECTID(objectid) \ std::hex << \ std::showbase << \ (objectid) << \ std::dec #define BOX_FORMAT_TIMESPEC(timespec) \ timespec.tv_sec << \ std::setw(6) << \ timespec.tv_usec #define BOX_FORMAT_MICROSECONDS(t) \ (int)((t) / 1000000) << "." << \ std::setw(6) << \ std::setfill('0') << \ (int)((t) % 1000000) << " seconds" #undef ERROR namespace Log { enum Level { NOTHING = 1, FATAL, ERROR, WARNING, NOTICE, INFO, TRACE, EVERYTHING, INVALID = -1 }; } // -------------------------------------------------------------------------- // // Class // Name: Logger // Purpose: Abstract base class for log targets // Created: 2006/12/16 // // -------------------------------------------------------------------------- class Logger { private: Log::Level mCurrentLevel; public: Logger(); Logger(Log::Level level); virtual ~Logger(); virtual bool Log(Log::Level level, const std::string& rFile, int line, std::string& rMessage) = 0; void Filter(Log::Level level) { mCurrentLevel = level; } virtual const char* GetType() = 0; Log::Level GetLevel() { return mCurrentLevel; } bool IsEnabled(Log::Level level); virtual void SetProgramName(const std::string& rProgramName) = 0; class Guard { private: Logger& mLogger; Log::Level mOldLevel; public: Guard(Logger& Logger) : mLogger(Logger) { mOldLevel = Logger.GetLevel(); } ~Guard() { mLogger.Filter(mOldLevel); } }; }; // -------------------------------------------------------------------------- // // Class // Name: Console // Purpose: Console logging target // Created: 2006/12/16 // // -------------------------------------------------------------------------- class Console : public Logger { private: static bool sShowTag; static bool sShowTime; static bool sShowTimeMicros; static bool sShowPID; static std::string sTag; public: virtual bool Log(Log::Level level, const std::string& rFile, int line, std::string& rMessage); virtual const char* GetType() { return "Console"; } virtual void SetProgramName(const std::string& rProgramName); static void SetShowTag(bool enabled); static void SetShowTime(bool enabled); static void SetShowTimeMicros(bool enabled); static void SetShowPID(bool enabled); }; // -------------------------------------------------------------------------- // // Class // Name: Syslog // Purpose: Syslog (or Windows Event Viewer) logging target // Created: 2006/12/16 // // -------------------------------------------------------------------------- class Syslog : public Logger { private: std::string mName; int mFacility; public: Syslog(); virtual ~Syslog(); virtual bool Log(Log::Level level, const std::string& rFile, int line, std::string& rMessage); virtual const char* GetType() { return "Syslog"; } virtual void SetProgramName(const std::string& rProgramName); virtual void SetFacility(int facility); static int GetNamedFacility(const std::string& rFacility); }; // -------------------------------------------------------------------------- // // Class // Name: Logging // Purpose: Static logging helper, keeps track of enabled loggers // and distributes log messages to them. // Created: 2006/12/16 // // -------------------------------------------------------------------------- class Logging { private: static std::vector sLoggers; static bool sLogToSyslog, sLogToConsole; static std::string sContext; static bool sContextSet; static Console* spConsole; static Syslog* spSyslog; static Log::Level sGlobalLevel; static Logging sGlobalLogging; static std::string sProgramName; public: Logging (); ~Logging(); static void ToSyslog (bool enabled); static void ToConsole (bool enabled); static void FilterSyslog (Log::Level level); static void FilterConsole (Log::Level level); static void Add (Logger* pNewLogger); static void Remove (Logger* pOldLogger); static void Log(Log::Level level, const std::string& rFile, int line, const std::string& rMessage); static void LogToSyslog(Log::Level level, const std::string& rFile, int line, const std::string& rMessage); static void SetContext(std::string context); static void ClearContext(); static void SetGlobalLevel(Log::Level level) { sGlobalLevel = level; } static Log::Level GetGlobalLevel() { return sGlobalLevel; } static Log::Level GetNamedLevel(const std::string& rName); static bool IsEnabled(Log::Level level) { return (int)sGlobalLevel >= (int)level; } static void SetProgramName(const std::string& rProgramName); static std::string GetProgramName() { return sProgramName; } static void SetFacility(int facility); static Console& GetConsole() { return *spConsole; } static Syslog& GetSyslog() { return *spSyslog; } class Guard { private: Log::Level mOldLevel; static int sGuardCount; static Log::Level sOriginalLevel; public: Guard(Log::Level newLevel) { mOldLevel = Logging::GetGlobalLevel(); if(sGuardCount == 0) { sOriginalLevel = mOldLevel; } sGuardCount++; Logging::SetGlobalLevel(newLevel); } ~Guard() { sGuardCount--; Logging::SetGlobalLevel(mOldLevel); } static bool IsActive() { return (sGuardCount > 0); } static Log::Level GetOriginalLevel() { return sOriginalLevel; } static bool IsGuardingFrom(Log::Level originalLevel) { return IsActive() && (int)sOriginalLevel >= (int)originalLevel; } }; class Tagger { private: std::string mOldTag; public: Tagger() : mOldTag(Logging::GetProgramName()) { } Tagger(const std::string& rTempTag) : mOldTag(Logging::GetProgramName()) { Logging::SetProgramName(mOldTag + " " + rTempTag); } ~Tagger() { Logging::SetProgramName(mOldTag); } void Change(const std::string& newTempTag) { Logging::SetProgramName(mOldTag + " " + newTempTag); } }; }; class FileLogger : public Logger { private: FileStream mLogFile; FileLogger(const FileLogger& forbidden) : mLogFile("") { /* do not call */ } public: FileLogger(const std::string& rFileName, Log::Level Level) : Logger(Level), mLogFile(rFileName, O_WRONLY | O_CREAT | O_APPEND) { } virtual bool Log(Log::Level Level, const std::string& rFile, int Line, std::string& rMessage); virtual const char* GetType() { return "FileLogger"; } virtual void SetProgramName(const std::string& rProgramName) { } }; class HideExceptionMessageGuard { public: HideExceptionMessageGuard() { mOldHiddenState = sHiddenState; sHiddenState = true; } ~HideExceptionMessageGuard() { sHiddenState = mOldHiddenState; } static bool ExceptionsHidden() { return sHiddenState; } private: static bool sHiddenState; bool mOldHiddenState; }; class HideSpecificExceptionGuard { private: std::pair mExceptionCode; public: typedef std::vector > SuppressedExceptions_t; static SuppressedExceptions_t sSuppressedExceptions; HideSpecificExceptionGuard(int type, int subtype) : mExceptionCode(std::pair(type, subtype)) { sSuppressedExceptions.push_back(mExceptionCode); } ~HideSpecificExceptionGuard() { SuppressedExceptions_t::reverse_iterator i = sSuppressedExceptions.rbegin(); assert(*i == mExceptionCode); sSuppressedExceptions.pop_back(); } static bool IsHidden(int type, int subtype); }; std::string PrintEscapedBinaryData(const std::string& rInput); #endif // LOGGING__H