LoggerOptions Class Reference

#include <logger_options.hh>

Collaboration diagram for LoggerOptions:

Public Member Functions
int	get_mpi_rank ()
	Returns number of actual process, if MPI is not supported returns -1. More...
int	setup_mpi (MPI_Comm comm)
	Set rank of actual process by MPI communicator. More...
void	set_log_file (std::string log_file_base)
	Initialize instance object in format 'log_file_base.process.log'. More...
void	reset ()
	Reset MPI rank and log file name. More...
bool	is_init ()
	Check if singleton instance object is initialize. More...
	~LoggerOptions ()
	Destructor. More...

Static Public Member Functions
static LoggerOptions &	get_instance ()
	Getter of singleton instance object. More...
static std::string	format_hh_mm_ss ()

Private Member Functions
	LoggerOptions ()
	Forbidden constructor. More...

Private Attributes
std::ofstream	file_stream_
	Stream for storing logger messages to file. More...
int	mpi_rank_
	Actual process number. More...
bool	no_log_
	Turn off logger file output. More...
bool	init_
	Flag sign if logger is initialized by set_log_file method. More...

Static Private Attributes
static TimePoint	start_time = TimePoint()
	Start time of program, allows you to specify the actual time of program (see format_hh_mm_ss method) More...
static LoggerOptions *	instance_ = new LoggerOptions()
	Singleton instance. More...

Friends
class	Logger

Detailed Description

Helper class defined logger output file and flags for setting of logger.

Use singleton design pattern.

Setting of logger is ensured by two methods: setup_mpi and set_log_file. Both methods are optional.

• setup_mpi sets actual rank of procces according to given MPI communicator. If setting is not performed, rank has default value -1. For correct functioning this method must be called before set_log_file.
• set_log_file allows set base name of logger output file (prefix). Name of logger file is created in format '<log_file_base>.<MPI_rank>.log'. If MPI rank is not set, it's generated random value (this option is not recommended). Method allows turn off logging if parameter log_file_base is set to empty string. If set_log_file method is not called, all logger messages are redirected to screen output.

Example of complete initialization of logger:

std::string log_file_prefix;
// ... set value of log_file_prefix
LoggerOptions::get_instance().setup_mpi(MPI_COMM_WORLD);
LoggerOptions::get_instance().set_log_file(log_file_prefix);

Definition at line 55 of file logger_options.hh.

Constructor & Destructor Documentation

~LoggerOptions()

LoggerOptions::~LoggerOptions

(

)

Destructor.

Definition at line 77 of file logger_options.cc.

LoggerOptions()

LoggerOptions::LoggerOptions ( )

private

Forbidden constructor.

Definition at line 73 of file logger_options.cc.

Member Function Documentation

format_hh_mm_ss()

std::string LoggerOptions::format_hh_mm_ss ( )

static

Return actual time from the beginning of application runtime in format HH:MM:SS.SSS

Definition at line 37 of file logger_options.cc.

Here is the caller graph for this function:

get_instance()

LoggerOptions & LoggerOptions::get_instance ( )

static

Getter of singleton instance object.

Definition at line 31 of file logger_options.cc.

Here is the caller graph for this function:

get_mpi_rank()

int LoggerOptions::get_mpi_rank

(

)

Returns number of actual process, if MPI is not supported returns -1.

Definition at line 85 of file logger_options.cc.

Here is the caller graph for this function:

is_init()

bool LoggerOptions::is_init ( )

inline

Check if singleton instance object is initialize.

Definition at line 79 of file logger_options.hh.

Here is the caller graph for this function:

reset()

void LoggerOptions::reset

(

)

Reset MPI rank and log file name.

Definition at line 119 of file logger_options.cc.

set_log_file()

void LoggerOptions::set_log_file

(

std::string

log_file_base

)

Initialize instance object in format 'log_file_base.process.log'.

Definition at line 97 of file logger_options.cc.

Here is the caller graph for this function:

setup_mpi()

int LoggerOptions::setup_mpi

(

MPI_Comm

comm

)

Set rank of actual process by MPI communicator.

Definition at line 90 of file logger_options.cc.

Here is the caller graph for this function:

Friends And Related Function Documentation

Logger

friend class Logger

friend

Definition at line 110 of file logger_options.hh.

Member Data Documentation

file_stream_

std::ofstream LoggerOptions::file_stream_

private

Stream for storing logger messages to file.

Definition at line 95 of file logger_options.hh.

init_

bool LoggerOptions::init_

private

Flag sign if logger is initialized by set_log_file method.

Definition at line 108 of file logger_options.hh.

instance_

LoggerOptions * LoggerOptions::instance_ = new LoggerOptions()

staticprivate

Singleton instance.

Definition at line 92 of file logger_options.hh.

mpi_rank_

int LoggerOptions::mpi_rank_

private

Actual process number.

Default value is set to -1 and indicates that MPI is not set

Definition at line 102 of file logger_options.hh.

no_log_

bool LoggerOptions::no_log_

private

Turn off logger file output.

Definition at line 105 of file logger_options.hh.

start_time

TimePoint LoggerOptions::start_time = TimePoint()

staticprivate

Start time of program, allows you to specify the actual time of program (see format_hh_mm_ss method)

Definition at line 89 of file logger_options.hh.

---

The documentation for this class was generated from the following files:

• /opt/flow123d/flow123d/src/system/logger_options.hh
• /opt/flow123d/flow123d/src/system/logger_options.cc