USRP Hardware Driver and USRP Manual  Version: 3.11.1.HEAD-0-gad6b0935
UHD and USRP Manual
Classes | Namespaces | Macros | Enumerations | Functions
log.hpp File Reference
#include <uhd/config.hpp>
#include <boost/current_function.hpp>
#include <boost/thread/thread.hpp>
#include <ostream>
#include <string>
#include <sstream>
#include <iostream>

Go to the source code of this file.

Classes

struct  uhd::log::logging_info
 

Namespaces

 uhd
 
 uhd::log
 

Macros

#define UHD_LOG_TRACE(component, message)   _UHD_LOG_INTERNAL(component, uhd::log::trace) << message;
 
#define UHD_LOG_DEBUG(component, message)   _UHD_LOG_INTERNAL(component, uhd::log::debug) << message;
 
#define UHD_LOG_INFO(component, message)   _UHD_LOG_INTERNAL(component, uhd::log::info) << message;
 
#define UHD_LOG_WARNING(component, message)   _UHD_LOG_INTERNAL(component, uhd::log::warning) << message;
 
#define UHD_LOG_ERROR(component, message)   _UHD_LOG_INTERNAL(component, uhd::log::error) << message;
 
#define UHD_LOG_FATAL(component, message)   _UHD_LOG_INTERNAL(component, uhd::log::fatal) << message;
 
#define UHD_LOG_FASTPATH(message)   uhd::_log::log_fastpath(message);
 Extra-fast logging macro for when speed matters. More...
 
#define UHD_LOGGER_TRACE(component)   _UHD_LOG_INTERNAL(component, uhd::log::trace)
 
#define UHD_LOGGER_DEBUG(component)   _UHD_LOG_INTERNAL(component, uhd::log::debug)
 
#define UHD_LOGGER_INFO(component)   _UHD_LOG_INTERNAL(component, uhd::log::info)
 
#define UHD_LOGGER_WARNING(component)   _UHD_LOG_INTERNAL(component, uhd::log::warning)
 
#define UHD_LOGGER_ERROR(component)   _UHD_LOG_INTERNAL(component, uhd::log::error)
 
#define UHD_LOGGER_FATAL(component)   _UHD_LOG_INTERNAL(component, uhd::log::fatal)
 
#define UHD_HERE()   UHD_LOGGER_DEBUG("DEBUG") << __FILE__ << ":" << __LINE__;
 Helpful debug tool to print site info. More...
 
#define UHD_VAR(var)   UHD_LOGGER_DEBUG("DEBUG") << #var << " = " << var;
 Helpful debug tool to print a variable. More...
 
#define UHD_HEX(var)   UHD_LOGGER_DEBUG("DEBUG") << #var << " = 0x" << std::hex << std::setfill('0') << std::setw(8) << var << std::dec;
 Helpful debug tool to print a variable in hex. More...
 

Enumerations

enum  uhd::log::severity_level {
  uhd::log::trace = 0, uhd::log::debug = 1, uhd::log::info = 2, uhd::log::warning = 3,
  uhd::log::error = 4, uhd::log::fatal = 5, uhd::log::off = 6
}
 

Functions

UHD_API void uhd::log::set_log_level (uhd::log::severity_level level)
 
UHD_API void uhd::log::set_console_level (uhd::log::severity_level level)
 
UHD_API void uhd::log::set_file_level (uhd::log::severity_level level)
 
UHD_API void uhd::log::set_logger_level (const std::string &logger, uhd::log::severity_level level)
 

Detailed Description

The UHD logging facility

The logger enables UHD library code to easily log events into a file and display messages above a certain level in the terminal. Log entries are time-stamped and stored with file, line, and function. Each call to the UHD_LOG macros is thread-safe. Each thread will aquire the lock for the logger.

Note: More information on the logging subsystem can be found on UHD Logging.

To disable console logging completely at compile time specify -DUHD_LOG_CONSOLE_DISABLE during configuration with CMake.

By default no file logging will occur. Set a log file path:

  • at compile time by specifying -DUHD_LOG_FILE=$file_path
  • and/or override at runtime by setting the environment variable UHD_LOG_FILE

Log levels

See also Log levels.

All log messages with verbosity greater than or equal to the log level (in other words, as often or less often than the current log level) are recorded to std::clog and/or the log file. Log levels can be specified using string or numeric values of uhd::log::severity_level.

The default log level is "info", but can be overridden:

  • at compile time by setting the pre-processor define -DUHD_LOG_MIN_LEVEL.
  • at runtime by setting the environment variable UHD_LOG_LEVEL.
  • for console logging by setting (-D)UHD_LOG_CONSOLE_LEVEL at run-/compiletime
  • for file logging by setting (-D)UHD_LOG_FILE_LEVEL at run-/compiletime

UHD_LOG_LEVEL can be the name of a verbosity enum or integer value:

  • Example pre-processor define: -DUHD_LOG_MIN_LEVEL=3
  • Example pre-processor define: -DUHD_LOG_MIN_LEVEL=info
  • Example environment variable: export UHD_LOG_LEVEL=3
  • Example environment variable: export UHD_LOG_LEVEL=info

Log formatting

The log format for messages going into a log file is CSV. All log messages going into a logfile will contain following fields:

  • timestamp
  • thread-id
  • source-file + line information
  • severity level
  • component/channel information which logged the information
  • the actual log message

The log format of log messages displayed on the terminal is plain text with space separated tags prepended. For example:

  • [INFO] [X300] This is a informational log message

The log format for log output on the console by using these preprocessor defines in CMake:

  • -DUHD_LOG_CONSOLE_TIME adds a timestamp [2017-01-01 00:00:00.000000]
  • -DUHD_LOG_CONSOLE_THREAD adds a thread-id [0x001234]
  • -DUHD_LOG_CONSOLE_SRC adds a sourcefile and line tag [src_file:line]

Macro Definition Documentation

◆ UHD_HERE

#define UHD_HERE ( )    UHD_LOGGER_DEBUG("DEBUG") << __FILE__ << ":" << __LINE__;

Helpful debug tool to print site info.

◆ UHD_HEX

#define UHD_HEX (   var)    UHD_LOGGER_DEBUG("DEBUG") << #var << " = 0x" << std::hex << std::setfill('0') << std::setw(8) << var << std::dec;

Helpful debug tool to print a variable in hex.

◆ UHD_LOG_DEBUG

#define UHD_LOG_DEBUG (   component,
  message 
)    _UHD_LOG_INTERNAL(component, uhd::log::debug) << message;

◆ UHD_LOG_ERROR

#define UHD_LOG_ERROR (   component,
  message 
)    _UHD_LOG_INTERNAL(component, uhd::log::error) << message;

◆ UHD_LOG_FASTPATH

#define UHD_LOG_FASTPATH (   message)    uhd::_log::log_fastpath(message);

Extra-fast logging macro for when speed matters.

◆ UHD_LOG_FATAL

#define UHD_LOG_FATAL (   component,
  message 
)    _UHD_LOG_INTERNAL(component, uhd::log::fatal) << message;

◆ UHD_LOG_INFO

#define UHD_LOG_INFO (   component,
  message 
)    _UHD_LOG_INTERNAL(component, uhd::log::info) << message;

◆ UHD_LOG_TRACE

#define UHD_LOG_TRACE (   component,
  message 
)    _UHD_LOG_INTERNAL(component, uhd::log::trace) << message;

◆ UHD_LOG_WARNING

#define UHD_LOG_WARNING (   component,
  message 
)    _UHD_LOG_INTERNAL(component, uhd::log::warning) << message;

◆ UHD_LOGGER_DEBUG

#define UHD_LOGGER_DEBUG (   component)    _UHD_LOG_INTERNAL(component, uhd::log::debug)

◆ UHD_LOGGER_ERROR

#define UHD_LOGGER_ERROR (   component)    _UHD_LOG_INTERNAL(component, uhd::log::error)

◆ UHD_LOGGER_FATAL

#define UHD_LOGGER_FATAL (   component)    _UHD_LOG_INTERNAL(component, uhd::log::fatal)

◆ UHD_LOGGER_INFO

#define UHD_LOGGER_INFO (   component)    _UHD_LOG_INTERNAL(component, uhd::log::info)

◆ UHD_LOGGER_TRACE

#define UHD_LOGGER_TRACE (   component)    _UHD_LOG_INTERNAL(component, uhd::log::trace)

◆ UHD_LOGGER_WARNING

#define UHD_LOGGER_WARNING (   component)    _UHD_LOG_INTERNAL(component, uhd::log::warning)

◆ UHD_VAR

#define UHD_VAR (   var)    UHD_LOGGER_DEBUG("DEBUG") << #var << " = " << var;

Helpful debug tool to print a variable.