Classes
struct	LogPropagateOpts

Functions
void	verboseAdd (uint64_t mask, QString name, bool additive, QString helptext)
	Add a verbose level to the verboseMap.
void	loglevelAdd (int value, QString name, char shortname)
	Add a log level to the logLevelMap.
void	verboseInit (void)
	Initialize the logging levels and verbose levels.
void	verboseHelp (void)
	Outputs the Verbose levels and their descriptions (for –verbose help)
void	loggingGetTimeStamp (qlonglong epoch, uint usec)
void	LogPrintLine (uint64_t mask, LogLevel_t level, const char file, int line, const char function, int fromQString, const char *format,...)
	Format and send a log message into the queue.
void	logPropagateCalc (void)
	Generate the logPropagateArgs global with the latest logging level, mask, etc to propagate to all of the mythtv programs spawned from this one.
bool	logPropagateQuiet (void)
	Check if we are propagating a "–quiet".
void	logStart (QString logfile, int progress, int quiet, int facility, LogLevel_t level, bool dblog, bool propagate)
	Entry point to start logging for the application.
void	logStop (void)
	Entry point for stopping logging for an application.
void	loggingRegisterThread (const QString &name)
	Register the current thread with the given name.
void	loggingDeregisterThread (void)
	Deregister the current thread's name.
int	syslogGetFacility (QString facility)
	Map a syslog facility name back to the enumerated value.
LogLevel_t	logLevelGet (QString level)
	Map a log level name back to the enumerated value.
QString	logLevelGetName (LogLevel_t level)
	Map a log level enumerated value back to the name.
int	verboseArgParse (QString arg)
	Parse the –verbose commandline argument and set the verbose level.
QString	logStrerror (int errnum)
	Verbose helper function for ENO macro.

Variables
static QMutex	logQueueMutex
static QQueue< LoggingItem * >	logQueue
static QRegExp	logRegExp = QRegExp("[%]{1,2}")
static LoggerThread *	logThread = NULL
static QMutex	logThreadMutex
static QHash< uint64_t, char * >	logThreadHash
static QMutex	logThreadTidMutex
static QHash< uint64_t, int64_t >	logThreadTidHash
static bool	logThreadFinished = false
static bool	debugRegistration = false
LogPropagateOpts	logPropagateOpts
QString	logPropagateArgs
QStringList	logPropagateArgList
LogLevel_t	logLevel = (LogLevel_t)LOG_INFO
bool	verboseInitialized = false
VerboseMap	verboseMap
QMutex	verboseMapMutex
LoglevelMap	loglevelMap
QMutex	loglevelMapMutex
const uint64_t	verboseDefaultInt = VB_GENERAL
const char *	verboseDefaultStr = " general"
uint64_t	verboseMask = verboseDefaultInt
QString	verboseString = QString(verboseDefaultStr)
uint64_t	userDefaultValueInt = verboseDefaultInt
QString	userDefaultValueStr = QString(verboseDefaultStr)
bool	haveUserDefaultValues = false

Function Documentation

void verboseAdd	(	uint64_t	mask,
		QString	name,
		bool	additive,
		QString	helptext
	)

Add a verbose level to the verboseMap.

Done at initialization.

Parameters

mask	verbose mask (VB_*)
name	name of the verbosity level
additive	true if this is to be ORed with other masks. false if is will clear the other bits.
helptext	Descriptive text for –verbose help output

Definition at line 998 of file logging.cpp.

void loglevelAdd	(	int	value,
		QString	name,
		char	shortname
	)

Add a log level to the logLevelMap.

Done at initialization.

Parameters

value	log level enumerated value (LOG_*) - matches syslog levels
name	name of the log level
shortname	one-letter short name for output into logs

Definition at line 1020 of file logging.cpp.

void verboseInit ( void )

Initialize the logging levels and verbose levels.

Definition at line 1036 of file logging.cpp.

Referenced by logLevelGet(), logLevelGetName(), and verboseArgParse().

void verboseHelp ( void )

Outputs the Verbose levels and their descriptions (for –verbose help)

Definition at line 1061 of file logging.cpp.

Referenced by verboseArgParse().

void loggingGetTimeStamp	(	qlonglong *	epoch,
		uint *	usec
	)

Definition at line 120 of file logging.cpp.

Referenced by LoggerThread::checkHeartBeat(), LogServerThread::checkHeartBeats(), LogForwardThread::forwardMessage(), LoggingItem::LoggingItem(), LoggerThread::messageReceived(), and LoggerThread::run().

void LogPrintLine	(	uint64_t	mask,
		LogLevel_t	level,
		const char *	file,
		int	line,
		const char *	function,
		int	fromQString,
		const char *	format,
			...
	)

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
fromQString	true if this message originated from QString
format	printf format string (when not from QString), log message (when from QString)
...	printf arguments (when not from QString)

Definition at line 722 of file logging.cpp.

void logPropagateCalc ( void )

Generate the logPropagateArgs global with the latest logging level, mask, etc to propagate to all of the mythtv programs spawned from this one.

Definition at line 778 of file logging.cpp.

Referenced by MainServer::HandleSetLogLevel(), MainServer::HandleSetVerbose(), and logStart().

bool logPropagateQuiet ( void )

Check if we are propagating a "–quiet".

Returns: true if –quiet is being propagated

Definition at line 827 of file logging.cpp.

Referenced by BurnMenu::doBurn(), getFileDetails(), and MythSystem::SetCommand().

void logStart	(	QString	logfile,
		int	progress,
		int	quiet,
		int	facility,
		LogLevel_t	level,
		bool	dblog,
		bool	propagate
	)

Entry point to start logging for the application.

This will start up all of the threads needed.

Parameters

logfile	Filename of the logfile to create. Empty if no file.
progress	non-zero if progress output will be sent to the console. This squelches all messages less important than LOG_ERR on the console
quiet	quiet level requested (squelches all console output)
facility	Syslog facility to use. -1 to disable syslog output
level	Minimum logging level to put into the logs
dblog	true if database logging is requested
propagate	true if the logfile path needs to be propagated to child processes.