// SPDX-License-Identifier: GPL-2.0-only /** * Digital Voice Modem - Common Library * GPLv2 Open Source. Use is subject to license terms. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * @package DVM / Common Library * @derivedfrom MMDVMHost (https://github.com/g4klx/MMDVMHost) * @license GPLv2 License (https://opensource.org/licenses/GPL-2.0) * * Copyright (C) 2015,2016 Jonathan Naylor, G4KLX * Copyright (C) 2018-2024 Bryan Biedenkapp, N2PLL * */ #include "Log.h" #include "network/BaseNetwork.h" #include #if defined(CATCH2_TEST_COMPILATION) #include #endif #include #include #include #include #include #include #include // --------------------------------------------------------------------------- // Constants // --------------------------------------------------------------------------- #define EOL "\r\n" const uint32_t LOG_BUFFER_LEN = 4096U; // --------------------------------------------------------------------------- // Global Variables // --------------------------------------------------------------------------- static uint32_t m_fileLevel = 0U; static std::string m_filePath; static std::string m_fileRoot; static network::BaseNetwork* m_network; static FILE* m_fpLog = nullptr; uint32_t g_logDisplayLevel = 2U; bool g_disableTimeDisplay = false; static struct tm m_tm; static std::ostream m_outStream { std::cerr.rdbuf() }; static char LEVELS[] = " DMIWEF"; // --------------------------------------------------------------------------- // Global Functions // --------------------------------------------------------------------------- /// /// Helper to get the current log file level. /// /// uint32_t CurrentLogFileLevel() { return m_fileLevel; } /// /// Helper to get the current log file path. /// /// std::string LogGetFilePath() { return m_filePath; } /// /// Helper to get the current log file root. /// /// std::string LogGetFileRoot() { return m_fileRoot; } /// /// Helper to open the detailed log file, file handle. /// /// True, if log file is opened, otherwise false. static bool LogOpen() { #if defined(CATCH2_TEST_COMPILATION) return true; #endif if (m_fileLevel == 0U) return true; time_t now; ::time(&now); struct tm* tm = ::gmtime(&now); if (tm->tm_mday == m_tm.tm_mday && tm->tm_mon == m_tm.tm_mon && tm->tm_year == m_tm.tm_year) { if (m_fpLog != nullptr) return true; } else { if (m_fpLog != nullptr) ::fclose(m_fpLog); } char filename[200U]; ::sprintf(filename, "%s/%s-%04d-%02d-%02d.log", m_filePath.c_str(), m_fileRoot.c_str(), tm->tm_year + 1900, tm->tm_mon + 1, tm->tm_mday); m_fpLog = ::fopen(filename, "a+t"); m_tm = *tm; return m_fpLog != nullptr; } /// /// Internal helper to set an output stream to direct logging to. /// /// void __InternalOutputStream(std::ostream& stream) { m_outStream.rdbuf(stream.rdbuf()); } /// Gets the instance of the Network class to transfer the activity log with. void* LogGetNetwork() { // NO GOOD, VERY BAD, TERRIBLE HACK return (void*)m_network; } /// /// Sets the instance of the Network class to transfer the activity log with. /// /// Instance of the Network class. void LogSetNetwork(void* network) { #if defined(CATCH2_TEST_COMPILATION) return; #endif // note: The Network class is passed here as a void so we can avoid including the Network.h // header in Log.h. This is dirty and probably terrible... m_network = (network::BaseNetwork*)network; } /// /// Initializes the diagnostics log. /// /// Full-path to the detailed log file. /// Prefix of the detailed log file name. /// File logging level. /// Console logging level. /// Disable display of date/time on the console log. bool LogInitialise(const std::string& filePath, const std::string& fileRoot, uint32_t fileLevel, uint32_t displayLevel, bool disableTimeDisplay) { m_filePath = filePath; m_fileRoot = fileRoot; m_fileLevel = fileLevel; g_logDisplayLevel = displayLevel; g_disableTimeDisplay = disableTimeDisplay; return ::LogOpen(); } /// /// Finalizes the diagnostics log. /// void LogFinalise() { #if defined(CATCH2_TEST_COMPILATION) return; #endif if (m_fpLog != nullptr) ::fclose(m_fpLog); } /// /// Writes a new entry to the diagnostics log. /// /// This is a variable argument function. /// Log level. /// Module name the log entry was genearted from. /// Formatted string to write to the log. void Log(uint32_t level, const char *module, const char* fmt, ...) { assert(fmt != nullptr); #if defined(CATCH2_TEST_COMPILATION) g_disableTimeDisplay = true; #endif char buffer[LOG_BUFFER_LEN]; if (!g_disableTimeDisplay) { struct timeval now; ::gettimeofday(&now, NULL); struct tm* tm = ::gmtime(&now.tv_sec); if (module != nullptr) { ::sprintf(buffer, "%c: %04d-%02d-%02d %02d:%02d:%02d.%03lu (%s) ", LEVELS[level], tm->tm_year + 1900, tm->tm_mon + 1, tm->tm_mday, tm->tm_hour, tm->tm_min, tm->tm_sec, now.tv_usec / 1000U, module); } else { ::sprintf(buffer, "%c: %04d-%02d-%02d %02d:%02d:%02d.%03lu ", LEVELS[level], tm->tm_year + 1900, tm->tm_mon + 1, tm->tm_mday, tm->tm_hour, tm->tm_min, tm->tm_sec, now.tv_usec / 1000U); } } else { if (module != nullptr) { ::sprintf(buffer, "%c: (%s) ", LEVELS[level], module); } else { if (level >= 9999U) { ::sprintf(buffer, "U: "); } else { ::sprintf(buffer, "%c: ", LEVELS[level]); } } } va_list vl, vl_len; va_start(vl, fmt); va_copy(vl_len, vl); size_t len = ::vsnprintf(nullptr, 0U, fmt, vl_len); ::vsnprintf(buffer + ::strlen(buffer), len + 1U, fmt, vl); va_end(vl_len); va_end(vl); if (m_outStream && g_logDisplayLevel == 0U) { m_outStream << buffer << std::endl; } if (m_network != nullptr) { // don't transfer debug data... if (level > 1U) { m_network->writeDiagLog(buffer); } } #if defined(CATCH2_TEST_COMPILATION) UNSCOPED_INFO(buffer); return; #endif if (level >= m_fileLevel && m_fileLevel != 0U) { bool ret = ::LogOpen(); if (!ret) return; ::fprintf(m_fpLog, "%s\n", buffer); ::fflush(m_fpLog); } if (level >= g_logDisplayLevel && g_logDisplayLevel != 0U) { ::fprintf(stdout, "%s" EOL, buffer); ::fflush(stdout); } // fatal error (specially allow any log levels above 9999) if (level >= 6U && level < 9999U) { ::fclose(m_fpLog); exit(1); } }