MagAOX::logger::logManager< _parentT, _logFileT > Struct Template Reference

The standard MagAOX log manager, used for both process logs and telemetry streams. More...

#include <logManager.hpp>

Inheritance diagram for MagAOX::logger::logManager< _parentT, _logFileT >:

Collaboration diagram for MagAOX::logger::logManager< _parentT, _logFileT >:

Public Types
typedef _parentT	parentT
typedef _logFileT	logFileT

Public Member Functions
	logManager ()
	Default c'tor.
	~logManager ()
	Destructor.
void	parent (parentT *p)
	Set the logger parent.
parentT *	parent ()
	Get the logger parent.
int	logShutdown (bool ls)
	Set a new value of logShutdown.
bool	logShutdown ()
	Get the current value of logShutdown.
int	writePause (const unsigned long &wp)
	Set a new value of writePause.
unsigned long	writePause ()
	Get the current value of writePause.
int	logLevel (logPrioT newLev)
	Set a new value of logLevel.
logPrioT	logLevel ()
	Get the current value of logLevel.
int	logThreadPrio (int newPrio)
	Set a new value of logThreadPrio.
int	logThreadPrio ()
	Get the current value of logThreadPrio.
bool	logThreadRunning ()
	Get status of the log thread running flag.
int	setupConfig (mx::app::appConfigurator &config)
	Setup an application configurator for the logger section.
int	loadConfig (mx::app::appConfigurator &config)
	Load the logger section from an application configurator.
int	logThreadStart ()
	Start the logger thread.
void	logThreadExec ()
	Execute the logger thread.
template<typename logT >
void	log (const typename logT::messageT &msg, logPrioT level=logPrio::LOG_DEFAULT)
	Make a log entry, including a message.
template<typename logT >
void	log (timespecX &ts, const typename logT::messageT &msg, logPrioT level=logPrio::LOG_DEFAULT)
	Make a log entry, including a message.
template<typename logT >
void	log (logPrioT level=logPrio::LOG_DEFAULT)
	Make a log entry with no message.
template<typename logT >
void	log (timespecX &ts, logPrioT level=logPrio::LOG_DEFAULT)
	Make a log entry with no message.

Static Public Member Functions
static void	_logThreadStart (logManager *l)
	Thread starter, called by logThreadStart on thread construction. Calls logThreadExec.
template<typename logT >
static int	createLog (bufferPtrT &logBuffer, const typename logT::messageT &msg, const logPrioT &level)
	Create a log formatted log entry, filling in a buffer.
template<typename logT >
static int	createLog (bufferPtrT &logBuffer, const timespecX &ts, const typename logT::messageT &msg, const logPrioT &level)
	Create a log formatted log entry, filling in a buffer.

Public Attributes
std::string	m_configSection {"logger"}
	The configuration files section name. Default is logger.
logPrioT	m_logLevel {logPrio::LOG_INFO}
	The minimum log level to actually record. Logs with level below this are rejected. Default is INFO. Configure with logger.logLevel.

Protected Attributes
parentT *	m_parent {nullptr}
std::list< bufferPtrT >	m_logQueue
	Log entries are stored here, and writen to the file by the log thread.
std::thread	m_logThread
	A separate thread for actually writing to the file.
std::mutex	m_qMutex
	Mutex for accessing the m_logQueue.
bool	m_logShutdown {false}
	Flag to signal the log thread to shutdown.
unsigned long	m_writePause {MAGAOX_default_writePause}
	Time, in nanoseconds, to pause between successive batch writes to the file. Default is 1e9. Configure with logger.writePause.
int	m_logThreadPrio {0}
bool	m_logThreadRunning {false}

Detailed Description

template<class _parentT, class _logFileT>
struct MagAOX::logger::logManager< _parentT, _logFileT >

The standard MagAOX log manager, used for both process logs and telemetry streams.

Manages the formatting and queueing of the log entries.

A log entry is made using one of the standard log types. These are formatted into a binary stream and stored in a std::list. This occurs in the calling thread. The insertion into the list is mutex-ed, so it is safe to make logs from different threads concurrently.

Write-to-disk occurs in a separate thread, which is normally set to the lowest priority so as not to interfere with higher-priority tasks. The log thread cycles through pending log entries in the list, dispatching them to the logFile.

The template parameter logFileT is one of the logFile types, which is used to actually write to disk.

Example:

logManager<logFileRaw> log;
log.m_logThreadStart();
 
//do stuff
 
log<loop_closed>(); //An empty log, which is used to log discrete events.
 
//more stuff happens
 
log<text_log>("a log entry with a std::string message type");

Todo:

document all the requirements of logFileT

Template Parameters

logFileT

a logFile type with a writeLog method.

Definition at line 73 of file logManager.hpp.

Member Typedef Documentation

logFileT

template<class _parentT , class _logFileT >

typedef _logFileT MagAOX::logger::logManager< _parentT, _logFileT >::logFileT

Definition at line 76 of file logManager.hpp.

parentT

template<class _parentT , class _logFileT >

typedef _parentT MagAOX::logger::logManager< _parentT, _logFileT >::parentT

Definition at line 75 of file logManager.hpp.

Constructor & Destructor Documentation

logManager()

template<class parentT , class logFileT >

MagAOX::logger::logManager< parentT, logFileT >::logManager

(

)

Default c'tor.

Definition at line 267 of file logManager.hpp.

~logManager()

template<class parentT , class logFileT >

MagAOX::logger::logManager< parentT, logFileT >::~logManager

(

)

Destructor.

Definition at line 272 of file logManager.hpp.

Member Function Documentation

_logThreadStart()

template<class parentT , class logFileT >

void MagAOX::logger::logManager< parentT, logFileT >::_logThreadStart ( logManager< _parentT, _logFileT > *  l )

static

Thread starter, called by logThreadStart on thread construction. Calls logThreadExec.

Parameters

[in]

l

a pointer to a logger instance (normally this)

Definition at line 418 of file logManager.hpp.

References MagAOX::logger::logManager< _parentT, _logFileT >::logThreadExec().

createLog() [1/2]

template<class parentT , class logFileT >

template<typename logT >

int MagAOX::logger::logManager< parentT, logFileT >::createLog ( bufferPtrT &  logBuffer, const timespecX &  ts, const typename logT::messageT &  msg, const logPrioT &  level  )

static

Create a log formatted log entry, filling in a buffer.

This version has the timestamp provided.

Template Parameters

logT	is a log entry type

Returns

0 on success, -1 on error.

Parameters

[out]	logBuffer	a shared_ptr<logBuffer>, which will be allocated and populated with the log entry
[in]	ts	the timestamp of this log entry.
[in]	msg	the message to log (could be of type emptyMessage)
[in]	level	the level (verbosity) of this log

Definition at line 544 of file logManager.hpp.

createLog() [2/2]

template<class parentT , class logFileT >

template<typename logT >

int MagAOX::logger::logManager< parentT, logFileT >::createLog ( bufferPtrT &  logBuffer, const typename logT::messageT &  msg, const logPrioT &  level  )

static

Create a log formatted log entry, filling in a buffer.

This is where the timestamp of the log entry is set.

Template Parameters

logT	is a log entry type

Returns

0 on success, -1 on error.

Parameters

[out]	logBuffer	a shared_ptr<logBuffer>, which will be allocated and populated with the log entry
[in]	msg	the message to log (could be of type emptyMessage)
[in]	level	the level (verbosity) of this log

Definition at line 530 of file logManager.hpp.

References flatlogs::timespecX::gettime().

loadConfig()

template<class parentT , class logFileT >

int MagAOX::logger::logManager< parentT, logFileT >::loadConfig

(

mx::app::appConfigurator &

config

)

Load the logger section from an application configurator.

Parameters

[in]

config

an application configuration from which to load values

Definition at line 376 of file logManager.hpp.

References flatlogs::logPrio::LOG_DEFAULT, flatlogs::logPrio::LOG_INFO, flatlogs::logPrio::LOG_UNKNOWN, and flatlogs::logLevelFromString().

log() [1/4]

template<class parentT , class logFileT >

template<typename logT >

void MagAOX::logger::logManager< parentT, logFileT >::log	(	const typename logT::messageT &	msg,
		logPrioT	level = logPrio::LOG_DEFAULT
	)

Make a log entry, including a message.

Template Parameters

logT	is a log entry type

Parameters

[in]	msg	the message to log
[in]	level	[optional] the log level. The default is used if not specified.

Definition at line 555 of file logManager.hpp.

References flatlogs::logPrio::LOG_DEFAULT.

Referenced by visxCtrl.xapp.VisX::_gather_metadata(), visxCtrl.xapp.VisX::_init_properties(), visxCtrl.xapp.VisX::cancel_exposure(), visxCtrl.xapp.VisX::finalize_exposure(), camtipSR.core.camtipSR::fit_SR_EE(), camtipSR.core.camtipSR::fit_SR_gauss(), camtipSR.core.camtipSR::grab_img(), camtipSR.core.camtipSR::grab_stack(), corAlign.corAlign::handle_closed_loop(), adcCtrl.adcCtrl::handle_ctrl_mtx(), visxCtrl.xapp.VisX::handle_expose(), visxCtrl.xapp.VisX::handle_exptime(), adcCtrl.adcCtrl::handle_gain(), visxCtrl.xapp.VisX::handle_gain(), adcCtrl.adcCtrl::handle_knife_edge(), adcCtrl.adcCtrl::handle_knife_edge_findzero(), adcCtrl.adcCtrl::handle_labmode(), adcCtrl.adcCtrl::handle_n_avg(), camtipSR.core.camtipSR::handle_n_avg(), corAlign.corAlign::handle_n_avg(), camtipSR.core.camtipSR::handle_n_jitter(), adcCtrl.adcCtrl::handle_no_measurements(), adcCtrl.adcCtrl::handle_offset(), audibleAlerts.core.AudibleAlerts::handle_personality_switch(), corAlign.corAlign::handle_ref_x(), corAlign.corAlign::handle_ref_y(), adcCtrl.adcCtrl::handle_reset(), audibleAlerts.core.AudibleAlerts::handle_soundboard_switch(), audibleAlerts.core.AudibleAlerts::handle_speech_request(), audibleAlerts.core.AudibleAlerts::handle_speech_text(), adcCtrl.adcCtrl::handle_state(), corAlign.corAlign::handle_state(), visxCtrl.xapp.VisX::handle_temp_ccd(), dbIngest.dbIngest::ingest_line(), dbIngest.dbIngest::launch_followers(), audibleAlerts.core.AudibleAlerts::load_personality(), adcCtrl.adcCtrl::loop(), audibleAlerts.core.AudibleAlerts::loop(), corAlign.corAlign::loop(), dbIngest.dbIngest::loop(), visxCtrl.xapp.VisX::loop(), corAlign.corAlign::measure_fpm_mask_shift(), audibleAlerts.core.AudibleAlerts::preprocess(), MagAOX::app::sshDigger::processAutoSSHLog(), MagAOX::app::xindiserver::processISLog(), MagAOX::app::sshDigger::processSSHLog(), audibleAlerts.core.AudibleAlerts::reaction_handler(), dbIngest.dbIngest::refresh_properties(), visxCtrl.xapp.VisX::refresh_properties(), dbIngest.dbIngest::rescan_files(), adcCtrl.adcCtrl::send_command(), adcCtrl.adcCtrl::setup(), camtipSR.core.camtipSR::setup(), corAlign.corAlign::setup(), efcControl.efcControl::setup(), visxCtrl.xapp.VisX::subscribe_to_other_devices(), adcCtrl.adcCtrl::transition_to_idle(), camtipSR.core.camtipSR::transition_to_idle(), corAlign.corAlign::transition_to_idle(), adcCtrl.adcCtrl::update_wavelength(), and audibleAlerts.core.AudibleAlerts::walkup_handler().

log() [2/4]

template<class parentT , class logFileT >

template<typename logT >

void MagAOX::logger::logManager< parentT, logFileT >::log

(

logPrioT

level = logPrio::LOG_DEFAULT

)

Make a log entry with no message.

Template Parameters

logT	is a log entry type

Parameters

[in]

level

[optional] the log level. The default is used if not specified.

Definition at line 599 of file logManager.hpp.

Referenced by visxCtrl.xapp.VisX::_gather_metadata(), visxCtrl.xapp.VisX::_init_properties(), visxCtrl.xapp.VisX::cancel_exposure(), visxCtrl.xapp.VisX::finalize_exposure(), camtipSR.core.camtipSR::fit_SR_EE(), camtipSR.core.camtipSR::fit_SR_gauss(), camtipSR.core.camtipSR::grab_img(), camtipSR.core.camtipSR::grab_stack(), corAlign.corAlign::handle_closed_loop(), adcCtrl.adcCtrl::handle_ctrl_mtx(), visxCtrl.xapp.VisX::handle_expose(), visxCtrl.xapp.VisX::handle_exptime(), adcCtrl.adcCtrl::handle_gain(), visxCtrl.xapp.VisX::handle_gain(), adcCtrl.adcCtrl::handle_knife_edge(), adcCtrl.adcCtrl::handle_knife_edge_findzero(), adcCtrl.adcCtrl::handle_labmode(), adcCtrl.adcCtrl::handle_n_avg(), camtipSR.core.camtipSR::handle_n_avg(), corAlign.corAlign::handle_n_avg(), camtipSR.core.camtipSR::handle_n_jitter(), adcCtrl.adcCtrl::handle_no_measurements(), adcCtrl.adcCtrl::handle_offset(), audibleAlerts.core.AudibleAlerts::handle_personality_switch(), corAlign.corAlign::handle_ref_x(), corAlign.corAlign::handle_ref_y(), adcCtrl.adcCtrl::handle_reset(), audibleAlerts.core.AudibleAlerts::handle_soundboard_switch(), audibleAlerts.core.AudibleAlerts::handle_speech_request(), audibleAlerts.core.AudibleAlerts::handle_speech_text(), adcCtrl.adcCtrl::handle_state(), corAlign.corAlign::handle_state(), visxCtrl.xapp.VisX::handle_temp_ccd(), dbIngest.dbIngest::ingest_line(), dbIngest.dbIngest::launch_followers(), audibleAlerts.core.AudibleAlerts::load_personality(), adcCtrl.adcCtrl::loop(), audibleAlerts.core.AudibleAlerts::loop(), corAlign.corAlign::loop(), dbIngest.dbIngest::loop(), visxCtrl.xapp.VisX::loop(), corAlign.corAlign::measure_fpm_mask_shift(), audibleAlerts.core.AudibleAlerts::preprocess(), audibleAlerts.core.AudibleAlerts::reaction_handler(), dbIngest.dbIngest::refresh_properties(), visxCtrl.xapp.VisX::refresh_properties(), dbIngest.dbIngest::rescan_files(), adcCtrl.adcCtrl::send_command(), adcCtrl.adcCtrl::setup(), camtipSR.core.camtipSR::setup(), corAlign.corAlign::setup(), efcControl.efcControl::setup(), visxCtrl.xapp.VisX::subscribe_to_other_devices(), adcCtrl.adcCtrl::transition_to_idle(), camtipSR.core.camtipSR::transition_to_idle(), corAlign.corAlign::transition_to_idle(), adcCtrl.adcCtrl::update_wavelength(), and audibleAlerts.core.AudibleAlerts::walkup_handler().

log() [3/4]

template<class parentT , class logFileT >

template<typename logT >

void MagAOX::logger::logManager< parentT, logFileT >::log	(	timespecX &	ts,
		const typename logT::messageT &	msg,
		logPrioT	level = logPrio::LOG_DEFAULT
	)

Make a log entry, including a message.

Template Parameters

logT	is a log entry type

Parameters

[in]	ts	the timestamp of the log entry
[in]	msg	the message to log
[in]	level	[optional] the log level. The default is used if not specified.

Definition at line 577 of file logManager.hpp.

References flatlogs::logPrio::LOG_DEFAULT.

Referenced by visxCtrl.xapp.VisX::_gather_metadata(), visxCtrl.xapp.VisX::_init_properties(), visxCtrl.xapp.VisX::cancel_exposure(), visxCtrl.xapp.VisX::finalize_exposure(), camtipSR.core.camtipSR::fit_SR_EE(), camtipSR.core.camtipSR::fit_SR_gauss(), camtipSR.core.camtipSR::grab_img(), camtipSR.core.camtipSR::grab_stack(), corAlign.corAlign::handle_closed_loop(), adcCtrl.adcCtrl::handle_ctrl_mtx(), visxCtrl.xapp.VisX::handle_expose(), visxCtrl.xapp.VisX::handle_exptime(), adcCtrl.adcCtrl::handle_gain(), visxCtrl.xapp.VisX::handle_gain(), adcCtrl.adcCtrl::handle_knife_edge(), adcCtrl.adcCtrl::handle_knife_edge_findzero(), adcCtrl.adcCtrl::handle_labmode(), adcCtrl.adcCtrl::handle_n_avg(), camtipSR.core.camtipSR::handle_n_avg(), corAlign.corAlign::handle_n_avg(), camtipSR.core.camtipSR::handle_n_jitter(), adcCtrl.adcCtrl::handle_no_measurements(), adcCtrl.adcCtrl::handle_offset(), audibleAlerts.core.AudibleAlerts::handle_personality_switch(), corAlign.corAlign::handle_ref_x(), corAlign.corAlign::handle_ref_y(), adcCtrl.adcCtrl::handle_reset(), audibleAlerts.core.AudibleAlerts::handle_soundboard_switch(), audibleAlerts.core.AudibleAlerts::handle_speech_request(), audibleAlerts.core.AudibleAlerts::handle_speech_text(), adcCtrl.adcCtrl::handle_state(), corAlign.corAlign::handle_state(), visxCtrl.xapp.VisX::handle_temp_ccd(), dbIngest.dbIngest::ingest_line(), dbIngest.dbIngest::launch_followers(), audibleAlerts.core.AudibleAlerts::load_personality(), adcCtrl.adcCtrl::loop(), audibleAlerts.core.AudibleAlerts::loop(), corAlign.corAlign::loop(), dbIngest.dbIngest::loop(), visxCtrl.xapp.VisX::loop(), corAlign.corAlign::measure_fpm_mask_shift(), audibleAlerts.core.AudibleAlerts::preprocess(), audibleAlerts.core.AudibleAlerts::reaction_handler(), dbIngest.dbIngest::refresh_properties(), visxCtrl.xapp.VisX::refresh_properties(), dbIngest.dbIngest::rescan_files(), adcCtrl.adcCtrl::send_command(), adcCtrl.adcCtrl::setup(), camtipSR.core.camtipSR::setup(), corAlign.corAlign::setup(), efcControl.efcControl::setup(), visxCtrl.xapp.VisX::subscribe_to_other_devices(), adcCtrl.adcCtrl::transition_to_idle(), camtipSR.core.camtipSR::transition_to_idle(), corAlign.corAlign::transition_to_idle(), adcCtrl.adcCtrl::update_wavelength(), and audibleAlerts.core.AudibleAlerts::walkup_handler().

log() [4/4]

template<class parentT , class logFileT >

template<typename logT >

void MagAOX::logger::logManager< parentT, logFileT >::log	(	timespecX &	ts,
		logPrioT	level = logPrio::LOG_DEFAULT
	)

Make a log entry with no message.

Template Parameters

logT	is a log entry type

Parameters

[in]	ts	the timestamp of the log entry
[in]	level	[optional] the log level. The default is used if not specified.

Definition at line 606 of file logManager.hpp.

Referenced by visxCtrl.xapp.VisX::_gather_metadata(), visxCtrl.xapp.VisX::_init_properties(), visxCtrl.xapp.VisX::cancel_exposure(), visxCtrl.xapp.VisX::finalize_exposure(), camtipSR.core.camtipSR::fit_SR_EE(), camtipSR.core.camtipSR::fit_SR_gauss(), camtipSR.core.camtipSR::grab_img(), camtipSR.core.camtipSR::grab_stack(), corAlign.corAlign::handle_closed_loop(), adcCtrl.adcCtrl::handle_ctrl_mtx(), visxCtrl.xapp.VisX::handle_expose(), visxCtrl.xapp.VisX::handle_exptime(), adcCtrl.adcCtrl::handle_gain(), visxCtrl.xapp.VisX::handle_gain(), adcCtrl.adcCtrl::handle_knife_edge(), adcCtrl.adcCtrl::handle_knife_edge_findzero(), adcCtrl.adcCtrl::handle_labmode(), adcCtrl.adcCtrl::handle_n_avg(), camtipSR.core.camtipSR::handle_n_avg(), corAlign.corAlign::handle_n_avg(), camtipSR.core.camtipSR::handle_n_jitter(), adcCtrl.adcCtrl::handle_no_measurements(), adcCtrl.adcCtrl::handle_offset(), audibleAlerts.core.AudibleAlerts::handle_personality_switch(), corAlign.corAlign::handle_ref_x(), corAlign.corAlign::handle_ref_y(), adcCtrl.adcCtrl::handle_reset(), audibleAlerts.core.AudibleAlerts::handle_soundboard_switch(), audibleAlerts.core.AudibleAlerts::handle_speech_request(), audibleAlerts.core.AudibleAlerts::handle_speech_text(), adcCtrl.adcCtrl::handle_state(), corAlign.corAlign::handle_state(), visxCtrl.xapp.VisX::handle_temp_ccd(), dbIngest.dbIngest::ingest_line(), dbIngest.dbIngest::launch_followers(), audibleAlerts.core.AudibleAlerts::load_personality(), adcCtrl.adcCtrl::loop(), audibleAlerts.core.AudibleAlerts::loop(), corAlign.corAlign::loop(), dbIngest.dbIngest::loop(), visxCtrl.xapp.VisX::loop(), corAlign.corAlign::measure_fpm_mask_shift(), audibleAlerts.core.AudibleAlerts::preprocess(), audibleAlerts.core.AudibleAlerts::reaction_handler(), dbIngest.dbIngest::refresh_properties(), visxCtrl.xapp.VisX::refresh_properties(), dbIngest.dbIngest::rescan_files(), adcCtrl.adcCtrl::send_command(), adcCtrl.adcCtrl::setup(), camtipSR.core.camtipSR::setup(), corAlign.corAlign::setup(), efcControl.efcControl::setup(), visxCtrl.xapp.VisX::subscribe_to_other_devices(), adcCtrl.adcCtrl::transition_to_idle(), camtipSR.core.camtipSR::transition_to_idle(), corAlign.corAlign::transition_to_idle(), adcCtrl.adcCtrl::update_wavelength(), and audibleAlerts.core.AudibleAlerts::walkup_handler().

logLevel() [1/2]

template<class parentT , class logFileT >

logPrioT MagAOX::logger::logManager< parentT, logFileT >::logLevel

(

)

Get the current value of logLevel.

Returns

the value m_logLevel

Definition at line 335 of file logManager.hpp.

logLevel() [2/2]

template<class parentT , class logFileT >

int MagAOX::logger::logManager< parentT, logFileT >::logLevel

(

logPrioT

newLev

)

Set a new value of logLevel.

Updates m_logLevel with new value. Will return an error and take no actions if the argument is outside the range of the logLevels enum.

Returns

0 on success

-1 on error.

Parameters

[in]

newLev

the new value of logLevel

Definition at line 325 of file logManager.hpp.

Referenced by MagAOX::app::sshDigger::execTunnel(), and MagAOX::app::xindiserver::forkIndiserver().

logShutdown() [1/2]

template<class parentT , class logFileT >

bool MagAOX::logger::logManager< parentT, logFileT >::logShutdown

(

)

Get the current value of logShutdown.

Returns

the value m_logShutdown.

Definition at line 303 of file logManager.hpp.

logShutdown() [2/2]

template<class parentT , class logFileT >

int MagAOX::logger::logManager< parentT, logFileT >::logShutdown

(

bool

ls

)

Set a new value of logShutdown.

Updates m_logShutdown with new value.

Returns

0 on success

-1 on error (if wp == 0).

Definition at line 296 of file logManager.hpp.

logThreadExec()

template<class parentT , class logFileT >

void MagAOX::logger::logManager< parentT, logFileT >::logThreadExec

(

)

Execute the logger thread.

Todo:

must check this for errors, and investigate how fsyncgate impacts us

Definition at line 464 of file logManager.hpp.

References flatlogs::logPrio::LOG_NOTICE, flatlogs::logHeader::logLevel(), and MagAOX::logger::logStdFormat().

Referenced by MagAOX::logger::logManager< _parentT, _logFileT >::_logThreadStart().

logThreadPrio() [1/2]

template<class parentT , class logFileT >

int MagAOX::logger::logManager< parentT, logFileT >::logThreadPrio

(

)

Get the current value of logThreadPrio.

Returns

the value m_logThreadPrio

Definition at line 351 of file logManager.hpp.

logThreadPrio() [2/2]

template<class parentT , class logFileT >

int MagAOX::logger::logManager< parentT, logFileT >::logThreadPrio

(

int

newPrio

)

Set a new value of logThreadPrio.

Updates m_logThreadPrio with new value. If the argument is < 0, this sets m_logThreadPrio to 0. Will not set > 98, and returns -1 with no changes in this case.

Returns

0 on success

-1 on error (> 98).

Parameters

[in]

newPrio

the new value of logThreadPrio

Definition at line 341 of file logManager.hpp.

logThreadRunning()

template<class parentT , class logFileT >

bool MagAOX::logger::logManager< parentT, logFileT >::logThreadRunning

(

)

Get status of the log thread running flag.

Returns

the current value of m_logThreadRunning

Definition at line 357 of file logManager.hpp.

logThreadStart()

template<class parentT , class logFileT >

int MagAOX::logger::logManager< parentT, logFileT >::logThreadStart

(

)

Start the logger thread.

Definition at line 424 of file logManager.hpp.

parent() [1/2]

template<class parentT , class logFileT >

parentT * MagAOX::logger::logManager< parentT, logFileT >::parent

(

)

Get the logger parent.

Returns a point to the parent object.

Definition at line 290 of file logManager.hpp.

parent() [2/2]

template<class parentT , class logFileT >

void MagAOX::logger::logManager< parentT, logFileT >::parent

(

parentT *

p

)

Set the logger parent.

The parent is used for interactive presentation of log messages

Parameters

[in]

p

pointer to the parent object

Definition at line 284 of file logManager.hpp.

setupConfig()

template<class parentT , class logFileT >

int MagAOX::logger::logManager< parentT, logFileT >::setupConfig

(

mx::app::appConfigurator &

config

)

Setup an application configurator for the logger section.

Parameters

[in]

config

an application configuration to setup

Definition at line 363 of file logManager.hpp.

writePause() [1/2]

template<class parentT , class logFileT >

unsigned long MagAOX::logger::logManager< parentT, logFileT >::writePause

(

)

Get the current value of writePause.

Returns

the value m_writePause.

Definition at line 319 of file logManager.hpp.

writePause() [2/2]

template<class parentT , class logFileT >

int MagAOX::logger::logManager< parentT, logFileT >::writePause

(

const unsigned long &

wp

)

Set a new value of writePause.

Updates m_writePause with new value.

Returns

0 on success

-1 on error (if wp == 0).

Parameters

[in]

wp

the new value of writePause

Definition at line 309 of file logManager.hpp.

Member Data Documentation

m_configSection

template<class _parentT , class _logFileT >

std::string MagAOX::logger::logManager< _parentT, _logFileT >::m_configSection {"logger"}

The configuration files section name. Default is logger.

Todo:

Make these protected members, with appropriate access methods

Definition at line 84 of file logManager.hpp.

m_logLevel

template<class _parentT , class _logFileT >

logPrioT MagAOX::logger::logManager< _parentT, _logFileT >::m_logLevel {logPrio::LOG_INFO}

The minimum log level to actually record. Logs with level below this are rejected. Default is INFO. Configure with logger.logLevel.

Definition at line 97 of file logManager.hpp.

m_logQueue

template<class _parentT , class _logFileT >

std::list<bufferPtrT> MagAOX::logger::logManager< _parentT, _logFileT >::m_logQueue

protected

Log entries are stored here, and writen to the file by the log thread.

Definition at line 87 of file logManager.hpp.

m_logShutdown

template<class _parentT , class _logFileT >

bool MagAOX::logger::logManager< _parentT, _logFileT >::m_logShutdown {false}

protected

Flag to signal the log thread to shutdown.

Definition at line 92 of file logManager.hpp.

m_logThread

template<class _parentT , class _logFileT >

std::thread MagAOX::logger::logManager< _parentT, _logFileT >::m_logThread

protected

A separate thread for actually writing to the file.

Definition at line 89 of file logManager.hpp.

m_logThreadPrio

template<class _parentT , class _logFileT >

int MagAOX::logger::logManager< _parentT, _logFileT >::m_logThreadPrio {0}

protected

Definition at line 100 of file logManager.hpp.

m_logThreadRunning

template<class _parentT , class _logFileT >

bool MagAOX::logger::logManager< _parentT, _logFileT >::m_logThreadRunning {false}

protected

Definition at line 102 of file logManager.hpp.

m_parent

template<class _parentT , class _logFileT >

parentT* MagAOX::logger::logManager< _parentT, _logFileT >::m_parent {nullptr}

protected

Definition at line 79 of file logManager.hpp.

m_qMutex

template<class _parentT , class _logFileT >

std::mutex MagAOX::logger::logManager< _parentT, _logFileT >::m_qMutex

protected

Mutex for accessing the m_logQueue.

Definition at line 90 of file logManager.hpp.

m_writePause

template<class _parentT , class _logFileT >

unsigned long MagAOX::logger::logManager< _parentT, _logFileT >::m_writePause {MAGAOX_default_writePause}

protected

Time, in nanoseconds, to pause between successive batch writes to the file. Default is 1e9. Configure with logger.writePause.

Definition at line 94 of file logManager.hpp.

---

The documentation for this struct was generated from the following file:

• libMagAOX/logger/logManager.hpp