The logging items that are generated by LOG() and are sent to the console. More...

#include <logging.h>

Inheritance diagram for LoggingItem:

Collaboration diagram for LoggingItem:

[legend]

Public Member Functions
char *	getThreadName (void)
	Get the name of the thread that produced the LoggingItem. More...

int64_t	getThreadTid (void)
	Get the thread ID of the thread that produced the LoggingItem. More...

void	setThreadTid (void)
	Set the thread ID of the thread that produced the LoggingItem. More...

QByteArray	toByteArray (void)

QString	getTimestamp (void) const
	Convert numerical timestamp to a readable date and time. More...

QString	getTimestampUs (void) const

char	getLevelChar (void)
	Get the message log level as a single character. More...

int	pid () const

qlonglong	tid () const

qulonglong	threadId () const

uint	usec () const

int	line () const

int	type () const

int	level () const

int	facility () const

qlonglong	epoch () const

QString	file () const

QString	function () const

QString	threadName () const

QString	appName () const

QString	table () const

QString	logFile () const

QString	message () const

void	setPid (const int val)

void	setTid (const qlonglong val)

void	setThreadId (const qulonglong val)

void	setUsec (const uint val)

void	setLine (const int val)

void	setType (const int val)

void	setLevel (const int val)

void	setFacility (const int val)

void	setEpoch (const qlonglong val)

void	setFile (const QString &val) SET_LOGGING_ARG(m_file) void setFunction(const QString &val) SET_LOGGING_ARG(m_function) void setThreadName(const QString &val) SET_LOGGING_ARG(m_threadName) void setAppName(const QString &val) SET_LOGGING_ARG(m_appName) void setTable(const QString &val) SET_LOGGING_ARG(m_table) void setLogFile(const QString &val) SET_LOGGING_ARG(m_logFile) void setMessage(const QString &val)

const char *	rawFile () const

const char *	rawFunction () const

const char *	rawThreadName () const

const char *	rawAppName () const

const char *	rawTable () const

const char *	rawLogFile () const

Public Member Functions inherited from ReferenceCounter
	ReferenceCounter (const QString &debugName, bool logDebug=true)
	Creates reference counter with an initial value of 1. More...

virtual int	IncrRef (void)
	Increments reference count. More...

virtual int	DecrRef (void)
	Decrements reference count and deletes on 0. More...

Static Public Member Functions
static LoggingItem *	create (const char _file, const char _function, int _line, LogLevel_t _level, LoggingType _type)
	Create a new LoggingItem. More...

static LoggingItem *	create (QByteArray &buf)

Static Public Member Functions inherited from ReferenceCounter
static void	PrintDebug (void)
	Print out any leaks if that level of debugging is enabled. More...

Protected Attributes
int	m_pid {-1}

qlonglong	m_tid {-1}

qulonglong	m_threadId {UINT64_MAX}

uint	m_usec {0}

int	m_line {0}

LoggingType	m_type {kMessage}

LogLevel_t	m_level {LOG_INFO}

int	m_facility {0}

qlonglong	m_epoch {0}

char *	m_file {nullptr}

char *	m_function {nullptr}

char *	m_threadName {nullptr}

char *	m_appName {nullptr}

char *	m_table {nullptr}

char *	m_logFile {nullptr}

QString	m_message {}

Protected Attributes inherited from ReferenceCounter
bool	m_logDebug
	This is used to suppress creating LoggingItem classes for LoggingItem reference count changes. More...

QAtomicInt	m_referenceCount {1}

Properties
int	pid

qlonglong	tid

qulonglong	threadId

uint	usec

int	line

int	type

int	level

int	facility

qlonglong	epoch

QString	file

QString	function

QString	threadName

QString	appName

QString	table

QString	logFile

QString	message

Private Member Functions
	LoggingItem ()

	LoggingItem (const char _file, const char _function, int _line, LogLevel_t _level, LoggingType _type)

	~LoggingItem () override

	Q_DISABLE_COPY (LoggingItem)

Friends
class	LoggerThread

void	LogPrintLine (uint64_t mask, LogLevel_t level, const char file, int line, const char function, QString message)
	Format and send a log message into the queue. More...

Additional Inherited Members
Protected Member Functions inherited from ReferenceCounter
virtual	~ReferenceCounter (void)
	Called on destruction, will warn if object deleted with references in place. More...

Detailed Description

The logging items that are generated by LOG() and are sent to the console.

Definition at line 61 of file logging.h.

Constructor & Destructor Documentation

◆ LoggingItem() [1/2]

LoggingItem::LoggingItem ( )

inlineprivate

Definition at line 158 of file logging.h.

Referenced by create().

◆ LoggingItem() [2/2]

LoggingItem::LoggingItem	(	const char *	_file,
		const char *	_function,
		int	_line,
		LogLevel_t	_level,
		LoggingType	_type
	)

private

Definition at line 149 of file logging.cpp.

◆ ~LoggingItem()

LoggingItem::~LoggingItem ( )

overrideprivate

Definition at line 160 of file logging.cpp.

Member Function Documentation

◆ getThreadName()

char * LoggingItem::getThreadName ( void )

Get the name of the thread that produced the LoggingItem.

Returns: C-string of the thread name

Definition at line 182 of file logging.cpp.

Referenced by LoggerThread::fillItem().

◆ getThreadTid()

int64_t LoggingItem::getThreadTid ( void )

Get the thread ID of the thread that produced the LoggingItem.

Returns: Thread ID of the producing thread, cast to a 64-bit signed integer

Note: In different platforms, the actual value returned here will vary. The intention is to get a thread ID that will map well to what is shown in gdb.

Definition at line 198 of file logging.cpp.

Referenced by LoggerThread::handleItem().

◆ setThreadTid()

void LoggingItem::setThreadTid ( void )

Set the thread ID of the thread that produced the LoggingItem.

This code is actually run in the thread in question as part of the call to LOG()

Note: In different platforms, the actual value returned here will vary. The intention is to get a thread ID that will map well to what is shown in gdb.

Definition at line 211 of file logging.cpp.

Referenced by LoggingItem().

◆ create() [1/2]

LoggingItem * LoggingItem::create	(	const char *	_file,
		const char *	_function,
		int	_line,
		LogLevel_t	_level,
		LoggingType	_type
	)

static

Create a new LoggingItem.

Parameters

_file	filename of the source file where the log message is from
_function	source function where the log message is from
_line	line number in the source where the log message is from
_level	logging level of the message (LogLevel_t)
_type	type of logging message

Returns: LoggingItem that was created

Definition at line 574 of file logging.cpp.

Referenced by LogForwardThread::forwardMessage(), loggingDeregisterThread(), loggingRegisterThread(), and LogPrintLine().

◆ create() [2/2]

LoggingItem * LoggingItem::create ( QByteArray & buf )

static

Definition at line 584 of file logging.cpp.

◆ toByteArray()

QByteArray LoggingItem::toByteArray ( void )

Definition at line 170 of file logging.cpp.

Referenced by LoggerThread::handleItem().

◆ getTimestamp()

QString LoggingItem::getTimestamp ( void ) const

Convert numerical timestamp to a readable date and time.

Definition at line 237 of file logging.cpp.

Referenced by getTimestampUs(), and DatabaseLogger::logqmsg().

◆ getTimestampUs()

QString LoggingItem::getTimestampUs ( void ) const

Definition at line 244 of file logging.cpp.

Referenced by LoggerThread::logConsole(), and FileLogger::logmsg().

◆ getLevelChar()

char LoggingItem::getLevelChar ( void )

Get the message log level as a single character.

Definition at line 252 of file logging.cpp.

Referenced by LoggerThread::logConsole(), and FileLogger::logmsg().

◆ pid()

int LoggingItem::pid ( ) const

inline

Definition at line 98 of file logging.h.

◆ tid()

qlonglong LoggingItem::tid ( ) const

inline

Definition at line 99 of file logging.h.

◆ threadId()

qulonglong LoggingItem::threadId ( ) const

inline

Definition at line 100 of file logging.h.

◆ usec()

uint LoggingItem::usec ( ) const

inline

Definition at line 101 of file logging.h.

◆ line()

int LoggingItem::line ( ) const

inline

Definition at line 102 of file logging.h.

◆ type()

int LoggingItem::type ( ) const

inline

Definition at line 103 of file logging.h.

◆ level()

int LoggingItem::level ( ) const

inline

Definition at line 104 of file logging.h.

◆ facility()

int LoggingItem::facility ( ) const

inline

Definition at line 105 of file logging.h.

◆ epoch()

qlonglong LoggingItem::epoch ( ) const

inline

Definition at line 106 of file logging.h.

◆ file()

QString LoggingItem::file ( ) const

inline

Definition at line 107 of file logging.h.

◆ function()

QString LoggingItem::function ( ) const

inline

Definition at line 108 of file logging.h.

◆ threadName()

QString LoggingItem::threadName ( ) const

inline

Definition at line 109 of file logging.h.

◆ appName()

QString LoggingItem::appName ( ) const

inline

Definition at line 110 of file logging.h.

◆ table()

QString LoggingItem::table ( ) const

inline

Definition at line 111 of file logging.h.

◆ logFile()

QString LoggingItem::logFile ( ) const

inline

Definition at line 112 of file logging.h.

◆ message()

QString LoggingItem::message ( ) const

inline

Definition at line 113 of file logging.h.

◆ setPid()

void LoggingItem::setPid ( const int val )

inline

Definition at line 115 of file logging.h.

Referenced by LoggerThread::fillItem().

◆ setTid()

void LoggingItem::setTid ( const qlonglong val )

inline

Definition at line 116 of file logging.h.

◆ setThreadId()

void LoggingItem::setThreadId ( const qulonglong val )

inline

Definition at line 117 of file logging.h.

◆ setUsec()

void LoggingItem::setUsec ( const uint val )

inline

Definition at line 118 of file logging.h.

◆ setLine()

void LoggingItem::setLine ( const int val )

inline

Definition at line 119 of file logging.h.

◆ setType()

void LoggingItem::setType ( const int val )

inline

Definition at line 120 of file logging.h.

◆ setLevel()

void LoggingItem::setLevel ( const int val )

inline

Definition at line 121 of file logging.h.

◆ setFacility()

void LoggingItem::setFacility ( const int val )

inline

Definition at line 122 of file logging.h.

Referenced by LoggerThread::fillItem().

◆ setEpoch()

void LoggingItem::setEpoch ( const qlonglong val )

inline

Definition at line 123 of file logging.h.

◆ setFile()

void LoggingItem::setFile ( const QString & val ) const &

inline

Definition at line 124 of file logging.h.

◆ rawFile()

const char* LoggingItem::rawFile ( ) const

inline

Definition at line 132 of file logging.h.

◆ rawFunction()

const char* LoggingItem::rawFunction ( ) const

inline

Definition at line 133 of file logging.h.

◆ rawThreadName()

const char* LoggingItem::rawThreadName ( ) const

inline

Definition at line 134 of file logging.h.

Referenced by LoggerThread::logConsole().

◆ rawAppName()

const char* LoggingItem::rawAppName ( ) const

inline

Definition at line 135 of file logging.h.

◆ rawTable()

const char* LoggingItem::rawTable ( ) const

inline

Definition at line 136 of file logging.h.

◆ rawLogFile()

const char* LoggingItem::rawLogFile ( ) const

inline

Definition at line 137 of file logging.h.

◆ Q_DISABLE_COPY()

LoggingItem::Q_DISABLE_COPY ( LoggingItem )

private

Friends And Related Function Documentation

◆ LoggerThread

friend class LoggerThread

friend

Definition at line 82 of file logging.h.

◆ LogPrintLine

void LogPrintLine	(	uint64_t	mask,
		LogLevel_t	level,
		const char *	file,
		int	line,
		const char *	function,
		QString	message
	)

friend

Format and send a log message into the queue.

This is called from the LOG() macro. The intention is minimal blocking of the caller.

Parameters

mask	Verbosity mask of the message (VB_*)
level	Log level of this message (LOG_* - matching syslog levels)
file	Filename of source code logging the message
line	Line number within the source of log message source
function	Function name of the log message source
message	log message

Definition at line 604 of file logging.cpp.

Member Data Documentation

◆ m_pid

int LoggingItem::m_pid {-1}

protected

Definition at line 140 of file logging.h.

Referenced by pid(), and setPid().

◆ m_tid

qlonglong LoggingItem::m_tid {-1}

protected

Definition at line 141 of file logging.h.

Referenced by getThreadTid(), LoggerThread::handleItem(), setThreadTid(), setTid(), and tid().

◆ m_threadId

qulonglong LoggingItem::m_threadId {UINT64_MAX}

protected

Definition at line 142 of file logging.h.

Referenced by getThreadName(), getThreadTid(), LoggerThread::handleItem(), setThreadId(), setThreadTid(), and threadId().

◆ m_usec

uint LoggingItem::m_usec {0}

protected

Definition at line 143 of file logging.h.

Referenced by getTimestampUs(), LoggingItem(), setUsec(), and usec().

◆ m_line

int LoggingItem::m_line {0}

protected

Definition at line 144 of file logging.h.

Referenced by line(), LoggerThread::logConsole(), and setLine().

◆ m_type

LoggingType LoggingItem::m_type {kMessage}

protected

Definition at line 145 of file logging.h.

Referenced by LoggerThread::handleItem(), LoggerThread::logConsole(), setType(), and type().

◆ m_level

LogLevel_t LoggingItem::m_level {LOG_INFO}

protected

Definition at line 146 of file logging.h.

Referenced by getLevelChar(), level(), LoggerThread::logConsole(), and setLevel().

◆ m_facility

int LoggingItem::m_facility {0}

protected

Definition at line 147 of file logging.h.

Referenced by facility(), and setFacility().

◆ m_epoch

qlonglong LoggingItem::m_epoch {0}

protected

Definition at line 148 of file logging.h.

Referenced by epoch(), getTimestamp(), LoggingItem(), and setEpoch().

◆ m_file

char* LoggingItem::m_file {nullptr}

protected

Definition at line 149 of file logging.h.

Referenced by file(), LoggerThread::logConsole(), rawFile(), and ~LoggingItem().

◆ m_function

char* LoggingItem::m_function {nullptr}

protected

Definition at line 150 of file logging.h.

Referenced by function(), LoggerThread::logConsole(), rawFunction(), and ~LoggingItem().

◆ m_threadName

char* LoggingItem::m_threadName {nullptr}

protected

Definition at line 151 of file logging.h.

Referenced by getThreadName(), LoggerThread::handleItem(), rawThreadName(), threadName(), and ~LoggingItem().

◆ m_appName

char* LoggingItem::m_appName {nullptr}

protected

Definition at line 152 of file logging.h.

Referenced by appName(), rawAppName(), and ~LoggingItem().

◆ m_table

char* LoggingItem::m_table {nullptr}

protected

Definition at line 153 of file logging.h.

Referenced by rawTable(), table(), and ~LoggingItem().

◆ m_logFile

char* LoggingItem::m_logFile {nullptr}

protected

Definition at line 154 of file logging.h.

Referenced by logFile(), rawLogFile(), and ~LoggingItem().

◆ m_message

QString LoggingItem::m_message {}

protected

Definition at line 155 of file logging.h.

Referenced by LoggerThread::handleItem(), LoggerThread::logConsole(), LogPrintLine(), message(), and setFile().