//
// Copyright 2012,2014,2016 Ettus Research LLC
//
// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with this program. If not, see .
//
#include
#include
#include
#include
#include
#include
#include
#include
#include
#include
#include
#include
#include
#include
namespace pt = boost::posix_time;
// Don't make these static const std::string -- we need their lifetime guaranteed!
#define PURPLE "\033[35;1m" // purple
#define BLUE "\033[34;1m" // blue
#define GREEN "\033[32;1m" // green
#define YELLOW "\033[33;1m" // yellow
#define RED "\033[31;0m" // red
#define BRED "\033[31;1m" // bright red
#define RESET_COLORS "\033[39;0m" // reset colors
/***********************************************************************
* Helpers
**********************************************************************/
static std::string verbosity_color(const uhd::log::severity_level &level){
switch(level){
case (uhd::log::trace):
return PURPLE;
case(uhd::log::debug):
return BLUE;
case(uhd::log::info):
return GREEN;
case(uhd::log::warning):
return YELLOW;
case(uhd::log::error):
return RED;
case(uhd::log::fatal):
return BRED;
default:
return RESET_COLORS;
}
}
static std::string verbosity_name(const uhd::log::severity_level &level){
switch(level){
case (uhd::log::trace):
return "TRACE";
case(uhd::log::debug):
return "DEBUG";
case(uhd::log::info):
return "INFO";
case(uhd::log::warning):
return "WARNING";
case(uhd::log::error):
return "ERROR";
case(uhd::log::fatal):
return "FATAL";
default:
return "-";
}
return "";
}
//! get the relative file path from the host directory
inline std::string path_to_filename(std::string path)
{
return path.substr(path.find_last_of("/\\") + 1);
}
/***********************************************************************
* Logger backends
**********************************************************************/
void console_log(
const uhd::log::logging_info &log_info
) {
std::clog
#ifdef UHD_LOG_CONSOLE_COLOR
<< verbosity_color(log_info.verbosity)
#endif
#ifdef UHD_LOG_CONSOLE_TIME
<< "[" << pt::to_simple_string(log_info.time) << "] "
#endif
#ifdef UHD_LOG_CONSOLE_THREAD
<< "[0x" << log_info.thread_id << "] "
#endif
#ifdef UHD_LOG_CONSOLE_SRC
<< "[" << path_to_filename(log_info.file) << ":" << log_info.line << "] "
#endif
<< "[" << verbosity_name(log_info.verbosity) << "] "
<< "[" << log_info.component << "] "
#ifdef UHD_LOG_CONSOLE_COLOR
<< RESET_COLORS
#endif
<< log_info.message
<< std::endl
;
}
/*! Helper class to implement file logging
*
* The class holds references to the file stream object, and handles closing
* and cleanup.
*/
class file_logger_backend
{
public:
file_logger_backend(const std::string &file_path)
{
_file_stream.exceptions(std::ofstream::failbit | std::ofstream::badbit);
if (!file_path.empty()){
try {
_file_stream.open(file_path.c_str(), std::fstream::out | std::fstream::app);
} catch (const std::ofstream::failure& fail){
std::cerr << "Error opening log file: " << fail.what() << std::endl;
}
}
}
void log(const uhd::log::logging_info &log_info)
{
if (_file_stream.is_open()){
_file_stream
<< pt::to_simple_string(log_info.time) << ","
<< "0x" << log_info.thread_id << ","
<< path_to_filename(log_info.file) << ":" << log_info.line << ","
<< log_info.verbosity << ","
<< log_info.component << ","
<< log_info.message
<< std::endl;
;
}
}
~file_logger_backend()
{
if (_file_stream.is_open()){
_file_stream.close();
}
}
private:
std::ofstream _file_stream;
};
/***********************************************************************
* Global resources for the logger
**********************************************************************/
#define UHD_CONSOLE_LOGGER_KEY "console"
#define UHD_FILE_LOGGER_KEY "file"
class log_resource {
public:
uhd::log::severity_level global_level;
std::map logger_level;
log_resource(void):
global_level(uhd::log::off),
_exit(false),
#ifndef UHD_LOG_FASTPATH_DISABLE
_fastpath_queue(10),
#endif
_log_queue(10)
{
//allow override from macro definition
#ifdef UHD_LOG_MIN_LEVEL
this->global_level = _get_log_level(BOOST_STRINGIZE(UHD_LOG_MIN_LEVEL), this->global_level);
#endif
//allow override from environment variables
const char * log_level_env = std::getenv("UHD_LOG_LEVEL");
if (log_level_env != NULL && log_level_env[0] != '\0') {
this->global_level =
_get_log_level(log_level_env, this->global_level);
}
/***** Console logging ***********************************************/
#ifndef UHD_LOG_CONSOLE_DISABLE
uhd::log::severity_level console_level = uhd::log::trace;
#ifdef UHD_LOG_CONSOLE_LEVEL
console_level = _get_log_level(BOOST_STRINGIZE(UHD_LOG_CONSOLE_LEVEL), console_level);
#endif
const char * log_console_level_env = std::getenv("UHD_LOG_CONSOLE_LEVEL");
if (log_console_level_env != NULL && log_console_level_env[0] != '\0') {
console_level =
_get_log_level(log_console_level_env, console_level);
}
logger_level[UHD_CONSOLE_LOGGER_KEY] = console_level;
_loggers[UHD_CONSOLE_LOGGER_KEY] = &console_log;
#endif
/***** File logging **************************************************/
uhd::log::severity_level file_level = uhd::log::trace;
std::string log_file_target;
#if defined(UHD_LOG_FILE_LEVEL) && defined(UHD_LOG_FILE_PATH)
file_level = _get_log_level(BOOST_STRINGIZE(UHD_LOG_FILE_LEVEL), file_level);
log_file_target = BOOST_STRINGIZE(UHD_LOG_FILE);
#endif
const char * log_file_level_env = std::getenv("UHD_LOG_FILE_LEVEL");
if (log_file_level_env != NULL && log_file_level_env[0] != '\0'){
file_level = _get_log_level(log_file_level_env, file_level);
}
const char* log_file_env = std::getenv("UHD_LOG_FILE");
if ((log_file_env != NULL) && (log_file_env[0] != '\0')) {
log_file_target = std::string(log_file_env);
}
if (!log_file_target.empty()){
logger_level[UHD_FILE_LOGGER_KEY] = file_level;
auto F = boost::make_shared(log_file_target);
_loggers[UHD_FILE_LOGGER_KEY] = [F](const uhd::log::logging_info& log_info){F->log(log_info);};
}
std::ostringstream sys_info;
sys_info \
<< "UHD" \
<< BOOST_PLATFORM << "; "
<< BOOST_COMPILER << "; "
<< "Boost_"
<< BOOST_VERSION << "; "
<< "UHD_" << uhd::get_version_string();
_log_queue.push_with_timed_wait(
uhd::log::logging_info(
pt::microsec_clock::local_time(),
uhd::log::info,
__FILE__,
__LINE__,
sys_info.str(),
boost::this_thread::get_id()),
0.25);
// Launch log message consumer
_pop_task = std::make_shared(std::thread([this](){this->pop_task();}));
_pop_fastpath_task = std::make_shared(std::thread([this](){this->pop_fastpath_task();}));
}
~log_resource(void){
_exit = true;
// We push a final message to kick the pop task out of it's wait state.
// This wouldn't be necessary if pop_with_wait() could fail. Should
// that ever get fixed, we can remove this.
auto final_message = uhd::log::logging_info(
pt::microsec_clock::local_time(),
uhd::log::trace,
__FILE__,
__LINE__,
"LOGGING",
boost::this_thread::get_id()
);
final_message.message = "Terminating logger.";
push(final_message);
#ifndef UHD_LOG_FASTPATH_DISABLE
push_fastpath("");
#endif
_pop_task->join();
{
std::lock_guard l(_logmap_mutex);
_loggers.clear();
}
_pop_task.reset();
#ifndef UHD_LOG_FASTPATH_DISABLE
_pop_fastpath_task->join();
_pop_fastpath_task.reset();
#endif
}
void push(const uhd::log::logging_info& log_info)
{
static const double PUSH_TIMEOUT = 0.25; // seconds
_log_queue.push_with_timed_wait(log_info, PUSH_TIMEOUT);
}
void push_fastpath(const std::string &message)
{
// Never wait. If the buffer is full, we just don't see the message.
// Too bad.
#ifndef UHD_LOG_FASTPATH_DISABLE
_fastpath_queue.push_with_haste(message);
#endif
}
void pop_task()
{
uhd::log::logging_info log_info;
log_info.message = "";
while (!_exit) {
_log_queue.pop_with_wait(log_info);
{
std::lock_guard l(_logmap_mutex);
for (const auto &logger : _loggers) {
auto level = logger_level.find(logger.first);
if(level != logger_level.end() && log_info.verbosity < level->second){
continue;
}
logger.second(log_info);
}
}
}
// Exit procedure: Clear the queue
while (_log_queue.pop_with_haste(log_info)) {
std::lock_guard l(_logmap_mutex);
for (const auto &logger : _loggers) {
auto level = logger_level.find(logger.first);
if (level != logger_level.end() && log_info.verbosity < level->second){
continue;
}
logger.second(log_info);
}
}
}
void pop_fastpath_task()
{
#ifndef UHD_LOG_FASTPATH_DISABLE
while (!_exit) {
std::string msg;
_fastpath_queue.pop_with_wait(msg);
{
std::cerr << msg << std::flush;
}
}
// Exit procedure: Clear the queue
std::string msg;
while (_fastpath_queue.pop_with_haste(msg)) {
std::cerr << msg << std::flush;
}
#endif
}
void add_logger(const std::string &key, uhd::log::log_fn_t logger_fn)
{
std::lock_guard l(_logmap_mutex);
_loggers[key] = logger_fn;
}
private:
std::shared_ptr _pop_task;
#ifndef UHD_LOG_FASTPATH_DISABLE
std::shared_ptr _pop_fastpath_task;
#endif
uhd::log::severity_level _get_log_level(const std::string &log_level_str,
const uhd::log::severity_level &previous_level){
if (std::isdigit(log_level_str[0])) {
const uhd::log::severity_level log_level_num =
uhd::log::severity_level(std::stoi(log_level_str));
if (log_level_num >= uhd::log::trace and
log_level_num <= uhd::log::fatal) {
return log_level_num;
}else{
UHD_LOGGER_ERROR("LOG") << "Failed to set log level to: " << log_level_str;
return previous_level;
}
}
#define if_loglevel_equal(name) \
else if (log_level_str == #name) return uhd::log::name
if_loglevel_equal(trace);
if_loglevel_equal(debug);
if_loglevel_equal(info);
if_loglevel_equal(warning);
if_loglevel_equal(error);
if_loglevel_equal(fatal);
if_loglevel_equal(off);
return previous_level;
}
std::mutex _logmap_mutex;
std::atomic _exit;
std::map _loggers;
#ifndef UHD_LOG_FASTPATH_DISABLE
uhd::transport::bounded_buffer _fastpath_queue;
#endif
uhd::transport::bounded_buffer _log_queue;
};
UHD_SINGLETON_FCN(log_resource, log_rs);
/***********************************************************************
* The logger object implementation
**********************************************************************/
uhd::_log::log::log(
const uhd::log::severity_level verbosity,
const std::string &file,
const unsigned int line,
const std::string &component,
const boost::thread::id thread_id
) :
_log_it(verbosity >= log_rs().global_level)
{
if (_log_it){
this->_log_info = uhd::log::logging_info(
pt::microsec_clock::local_time(),
verbosity,
file,
line,
component,
thread_id);
}
}
uhd::_log::log::~log(void)
{
if (_log_it) {
this->_log_info.message = _ss.str();
log_rs().push(this->_log_info);
}
}
void uhd::_log::log_fastpath(const std::string &msg)
{
#ifndef UHD_LOG_FASTPATH_DISABLE
log_rs().push_fastpath(msg);
#endif
}
/***********************************************************************
* Public API calls
**********************************************************************/
void
uhd::log::add_logger(const std::string &key, log_fn_t logger_fn)
{
log_rs().add_logger(key, logger_fn);
}
void
uhd::log::set_log_level(uhd::log::severity_level level){
log_rs().global_level = level;
}
void
uhd::log::set_logger_level(const std::string &key, uhd::log::severity_level level){
log_rs().logger_level[key] = level;
}
void
uhd::log::set_console_level(uhd::log::severity_level level){
set_logger_level(UHD_CONSOLE_LOGGER_KEY, level);
}
void
uhd::log::set_file_level(uhd::log::severity_level level){
set_logger_level(UHD_FILE_LOGGER_KEY, level);
}