#include <logging.h>

Collaboration diagram for BCLog::Logger:

Classes
struct	BufferedLog

Public Member Functions
void	LogPrintStr (std::string_view str, SourceLocation &&source_loc, BCLog::LogFlags category, BCLog::Level level, bool should_ratelimit) EXCLUSIVE_LOCKS_REQUIRED(!m_cs)
	Send a string to the log output.

bool	Enabled () const EXCLUSIVE_LOCKS_REQUIRED(!m_cs)
	Returns whether logs will be written to any output.

void	DeleteCallback (std::list< std::function< void(const std::string &)> >::iterator it) EXCLUSIVE_LOCKS_REQUIRED(!m_cs)
	Delete a connection.

size_t	NumConnections ()

bool	StartLogging () EXCLUSIVE_LOCKS_REQUIRED(!m_cs)
	Start logging (and flush all buffered messages)

void	DisconnectTestLogger () EXCLUSIVE_LOCKS_REQUIRED(!m_cs)
	Only for testing.

void	SetRateLimiting (std::shared_ptr< LogRateLimiter > limiter) EXCLUSIVE_LOCKS_REQUIRED(!m_cs)

void	DisableLogging () EXCLUSIVE_LOCKS_REQUIRED(!m_cs)
	Disable logging This offers a slight speedup and slightly smaller memory usage compared to leaving the logging system in its default state.

void	ShrinkDebugFile ()

std::unordered_map< LogFlags, Level >	CategoryLevels () const EXCLUSIVE_LOCKS_REQUIRED(!m_cs)

void	SetCategoryLogLevel (const std::unordered_map< LogFlags, Level > &levels) EXCLUSIVE_LOCKS_REQUIRED(!m_cs)

void	AddCategoryLogLevel (LogFlags category, Level level)

bool	SetCategoryLogLevel (std::string_view category_str, std::string_view level_str) EXCLUSIVE_LOCKS_REQUIRED(!m_cs)

Level	LogLevel () const

void	SetLogLevel (Level level)

bool	SetLogLevel (std::string_view level)

CategoryMask	GetCategoryMask () const

void	EnableCategory (LogFlags flag)

bool	EnableCategory (std::string_view str)

void	DisableCategory (LogFlags flag)

bool	DisableCategory (std::string_view str)

bool	WillLogCategory (LogFlags category) const

bool	WillLogCategoryLevel (LogFlags category, Level level) const EXCLUSIVE_LOCKS_REQUIRED(!m_cs)

std::vector< LogCategory >	LogCategoriesList () const
	Returns a vector of the log categories in alphabetical order.

std::string	LogCategoriesString () const
	Returns a string with the log categories in alphabetical order.

std::string	LogLevelsString () const
	Returns a string with all user-selectable log levels.

bool	DefaultShrinkDebugFile () const

Static Public Member Functions
static std::string	LogLevelToStr (BCLog::Level level)
	Returns the string representation of a log level.

Public Attributes
bool	m_print_to_console = false

bool	m_print_to_file = false

bool	m_log_timestamps = DEFAULT_LOGTIMESTAMPS

bool	m_log_time_micros = DEFAULT_LOGTIMEMICROS

bool	m_log_threadnames = DEFAULT_LOGTHREADNAMES

bool	m_log_sourcelocations = DEFAULT_LOGSOURCELOCATIONS

bool	m_always_print_category_level = DEFAULT_LOGLEVELALWAYS

fs::path	m_file_path

std::atomic< bool >	m_reopen_file {false}

std::list< std::function< void(conststd::string &)> >::iterato	PushBackCallback )(std::function< void(const std::string &)> fun) EXCLUSIVE_LOCKS_REQUIRED(!m_cs)
	Connect a slot to the print signal and return the connection.

Private Member Functions
FILE *m_fileout	GUARDED_BY (m_cs)

std::list< BufferedLog > m_msgs_before_open	GUARDED_BY (m_cs)

bool m_buffering	GUARDED_BY (m_cs)
	Buffer messages before logging can be started.

size_t m_max_buffer_memusage	GUARDED_BY (m_cs)

size_t m_cur_buffer_memusage	GUARDED_BY (m_cs)

size_t m_buffer_lines_discarded	GUARDED_BY (m_cs)

std::shared_ptr< LogRateLimiter > m_limiter	GUARDED_BY (m_cs)
	Manages the rate limiting of each log location.

std::unordered_map< LogFlags, Level > m_category_log_levels	GUARDED_BY (m_cs)
	Category-specific log level. Overrides `m_log_level`.

void	FormatLogStrInPlace (std::string &str, LogFlags category, Level level, const SourceLocation &source_loc, std::string_view threadname, SystemClock::time_point now, std::chrono::seconds mocktime) const

std::string	LogTimestampStr (SystemClock::time_point now, std::chrono::seconds mocktime) const

void	LogPrintStr_ (std::string_view str, SourceLocation &&source_loc, BCLog::LogFlags category, BCLog::Level level, bool should_ratelimit) EXCLUSIVE_LOCKS_REQUIRED(m_cs)
	Send a string to the log output (internal)

std::string	GetLogPrefix (LogFlags category, Level level) const

Private Attributes
StdMutex	m_cs

std::atomic< Level >	m_log_level {DEFAULT_LOG_LEVEL}
	If there is no category-specific log level, all logs with a severity level lower than `m_log_level` will be ignored.

std::atomic< CategoryMask >	m_categories {BCLog::NONE}
	Log categories bitfield.

std::list< std::function< void(const std::string &)> > m_print_callback	GUARDED_BY )(m_cs)
	Slots that connect to the print signal.

Detailed Description

Definition at line 127 of file logging.h.

Member Function Documentation

◆ AddCategoryLogLevel()

void BCLog::Logger::AddCategoryLogLevel	(	LogFlags	category,
		Level	level )

inline

Definition at line 251 of file logging.h.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ CategoryLevels()

std::unordered_map< LogFlags, Level > BCLog::Logger::CategoryLevels ( ) const

inline

Definition at line 241 of file logging.h.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ DefaultShrinkDebugFile()

bool BCLog::Logger::DefaultShrinkDebugFile ( ) const

Definition at line 167 of file logging.cpp.

◆ DeleteCallback()

void BCLog::Logger::DeleteCallback ( std::list< std::function< void(const std::string &)> >::iterator it )

inline

Delete a connection.

Definition at line 208 of file logging.h.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ DisableCategory() [1/2]

void BCLog::Logger::DisableCategory ( BCLog::LogFlags flag )

Definition at line 136 of file logging.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ DisableCategory() [2/2]

bool BCLog::Logger::DisableCategory ( std::string_view str )

Definition at line 141 of file logging.cpp.

Here is the call graph for this function:

◆ DisableLogging()

void BCLog::Logger::DisableLogging ( )

Disable logging This offers a slight speedup and slightly smaller memory usage compared to leaving the logging system in its default state.

Mostly intended for libbitcoin-kernel apps that don't want any logging. Should be used instead of StartLogging().

Definition at line 111 of file logging.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ DisconnectTestLogger()

void BCLog::Logger::DisconnectTestLogger ( )

Only for testing.

Definition at line 98 of file logging.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ EnableCategory() [1/2]

void BCLog::Logger::EnableCategory ( BCLog::LogFlags flag )

Definition at line 123 of file logging.cpp.

Here is the caller graph for this function:

◆ EnableCategory() [2/2]

bool BCLog::Logger::EnableCategory ( std::string_view str )

Definition at line 128 of file logging.cpp.

Here is the call graph for this function:

◆ Enabled()

bool BCLog::Logger::Enabled ( ) const

inline

Returns whether logs will be written to any output.

Definition at line 193 of file logging.h.

Here is the call graph for this function:

◆ FormatLogStrInPlace()

void BCLog::Logger::FormatLogStrInPlace	(	std::string &	str,
		BCLog::LogFlags	category,
		BCLog::Level	level,
		const SourceLocation &	source_loc,
		std::string_view	threadname,
		SystemClock::time_point	now,
		std::chrono::seconds	mocktime ) const

private

Definition at line 407 of file logging.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetCategoryMask()

CategoryMask BCLog::Logger::GetCategoryMask ( ) const

inline

Definition at line 262 of file logging.h.

Here is the caller graph for this function:

◆ GetLogPrefix()

std::string BCLog::Logger::GetLogPrefix	(	BCLog::LogFlags	category,
		BCLog::Level	level ) const

private

Definition at line 343 of file logging.cpp.

Here is the call graph for this function:

◆ GUARDED_BY() [1/8]

FILE *m_fileout BCLog::Logger::GUARDED_BY ( m_cs )

private

◆ GUARDED_BY() [2/8]

std::list< BufferedLog > m_msgs_before_open BCLog::Logger::GUARDED_BY ( m_cs )

private

◆ GUARDED_BY() [3/8]

bool m_buffering BCLog::Logger::GUARDED_BY ( m_cs )

private

Buffer messages before logging can be started.

◆ GUARDED_BY() [4/8]

size_t m_max_buffer_memusage BCLog::Logger::GUARDED_BY ( m_cs )

inlineprivate

Definition at line 145 of file logging.h.

◆ GUARDED_BY() [5/8]

size_t m_cur_buffer_memusage BCLog::Logger::GUARDED_BY ( m_cs )

inlineprivate

Definition at line 146 of file logging.h.

◆ GUARDED_BY() [6/8]

size_t m_buffer_lines_discarded BCLog::Logger::GUARDED_BY ( m_cs )

inlineprivate

Definition at line 147 of file logging.h.

◆ GUARDED_BY() [7/8]

std::shared_ptr< LogRateLimiter > m_limiter BCLog::Logger::GUARDED_BY ( m_cs )

private

Manages the rate limiting of each log location.

◆ GUARDED_BY() [8/8]

std::unordered_map< LogFlags, Level > m_category_log_levels BCLog::Logger::GUARDED_BY ( m_cs )

private

Category-specific log level. Overrides m_log_level.

◆ LogCategoriesList()

std::vector< LogCategory > BCLog::Logger::LogCategoriesList ( ) const

Returns a vector of the log categories in alphabetical order.

Definition at line 278 of file logging.cpp.

Here is the caller graph for this function:

◆ LogCategoriesString()

std::string BCLog::Logger::LogCategoriesString ( ) const

inline

Returns a string with the log categories in alphabetical order.

Definition at line 275 of file logging.h.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ LogLevel()

Level BCLog::Logger::LogLevel ( ) const

inline

Definition at line 258 of file logging.h.

◆ LogLevelsString()

std::string BCLog::Logger::LogLevelsString ( ) const

Returns a string with all user-selectable log levels.

Definition at line 294 of file logging.cpp.

Here is the call graph for this function:

◆ LogLevelToStr()

std::string BCLog::Logger::LogLevelToStr ( BCLog::Level level )

static

Returns the string representation of a log level.

Definition at line 234 of file logging.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ LogPrintStr()

void BCLog::Logger::LogPrintStr	(	std::string_view	str,
		SourceLocation &&	source_loc,
		BCLog::LogFlags	category,
		BCLog::Level	level,
		bool	should_ratelimit )

Send a string to the log output.

Definition at line 424 of file logging.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ LogPrintStr_()

void BCLog::Logger::LogPrintStr_	(	std::string_view	str,
		SourceLocation &&	source_loc,
		BCLog::LogFlags	category,
		BCLog::Level	level,
		bool	should_ratelimit )

private

Send a string to the log output (internal)

Definition at line 431 of file logging.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ LogTimestampStr()

std::string BCLog::Logger::LogTimestampStr	(	SystemClock::time_point	now,
		std::chrono::seconds	mocktime ) const

private

Definition at line 300 of file logging.cpp.

Here is the call graph for this function:

◆ NumConnections()

size_t BCLog::Logger::NumConnections ( )

inline

Definition at line 214 of file logging.h.

Here is the call graph for this function:

◆ SetCategoryLogLevel() [1/2]

void BCLog::Logger::SetCategoryLogLevel ( const std::unordered_map< LogFlags, Level > & levels )

inline

Definition at line 246 of file logging.h.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ SetCategoryLogLevel() [2/2]

bool BCLog::Logger::SetCategoryLogLevel	(	std::string_view	category_str,
		std::string_view	level_str )

Definition at line 593 of file logging.cpp.

Here is the call graph for this function:

◆ SetLogLevel() [1/2]

void BCLog::Logger::SetLogLevel ( Level level )

inline

Definition at line 259 of file logging.h.

Here is the caller graph for this function:

◆ SetLogLevel() [2/2]

bool BCLog::Logger::SetLogLevel ( std::string_view level )

Definition at line 585 of file logging.cpp.

Here is the call graph for this function:

◆ SetRateLimiting()

void BCLog::Logger::SetRateLimiting ( std::shared_ptr< LogRateLimiter > limiter )

inline

Definition at line 225 of file logging.h.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ShrinkDebugFile()

void BCLog::Logger::ShrinkDebugFile ( )

Definition at line 514 of file logging.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ StartLogging()

bool BCLog::Logger::StartLogging ( )

Start logging (and flush all buffered messages)

Definition at line 54 of file logging.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ WillLogCategory()

bool BCLog::Logger::WillLogCategory ( BCLog::LogFlags category ) const

Definition at line 149 of file logging.cpp.

◆ WillLogCategoryLevel()

bool BCLog::Logger::WillLogCategoryLevel	(	BCLog::LogFlags	category,
		BCLog::Level	level ) const

Definition at line 154 of file logging.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

Member Data Documentation

◆ GUARDED_BY

std::list< std::function< void(const std::string &)> > m_print_callback BCLog::Logger::GUARDED_BY) (m_cs)

inlineprivate

Slots that connect to the print signal.

Definition at line 167 of file logging.h.

◆ m_always_print_category_level

bool BCLog::Logger::m_always_print_category_level = DEFAULT_LOGLEVELALWAYS

Definition at line 183 of file logging.h.

◆ m_categories

std::atomic<CategoryMask> BCLog::Logger::m_categories {BCLog::NONE}

private

Log categories bitfield.

Definition at line 160 of file logging.h.

◆ m_cs

StdMutex BCLog::Logger::m_cs

mutableprivate

Definition at line 140 of file logging.h.

◆ m_file_path

fs::path BCLog::Logger::m_file_path

Definition at line 185 of file logging.h.

◆ m_log_level

std::atomic<Level> BCLog::Logger::m_log_level {DEFAULT_LOG_LEVEL}

private

If there is no category-specific log level, all logs with a severity level lower than m_log_level will be ignored.

Definition at line 157 of file logging.h.

◆ m_log_sourcelocations

bool BCLog::Logger::m_log_sourcelocations = DEFAULT_LOGSOURCELOCATIONS

Definition at line 182 of file logging.h.

◆ m_log_threadnames

bool BCLog::Logger::m_log_threadnames = DEFAULT_LOGTHREADNAMES

Definition at line 181 of file logging.h.

◆ m_log_time_micros

bool BCLog::Logger::m_log_time_micros = DEFAULT_LOGTIMEMICROS

Definition at line 180 of file logging.h.

◆ m_log_timestamps

bool BCLog::Logger::m_log_timestamps = DEFAULT_LOGTIMESTAMPS

Definition at line 179 of file logging.h.

◆ m_print_to_console

bool BCLog::Logger::m_print_to_console = false

Definition at line 176 of file logging.h.

◆ m_print_to_file

bool BCLog::Logger::m_print_to_file = false

Definition at line 177 of file logging.h.

◆ m_reopen_file

std::atomic<bool> BCLog::Logger::m_reopen_file {false}

Definition at line 186 of file logging.h.

◆ PushBackCallback

std::list< std::function< void(conststd::string &)> >::iterato BCLog::Logger::PushBackCallback) (std::function< void(const std::string &)> fun) EXCLUSIVE_LOCKS_REQUIRED(!m_cs)

inline

Connect a slot to the print signal and return the connection.

Definition at line 200 of file logging.h.

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

src/logging.h
src/logging.cpp

Classes

Public Member Functions

Static Public Member Functions

Public Attributes

Private Member Functions

Private Attributes

Detailed Description

Member Function Documentation

◆ AddCategoryLogLevel()

◆ CategoryLevels()

◆ DefaultShrinkDebugFile()

◆ DeleteCallback()

◆ DisableCategory() [1/2]

◆ DisableCategory() [2/2]

◆ DisableLogging()

◆ DisconnectTestLogger()

◆ EnableCategory() [1/2]

◆ EnableCategory() [2/2]

◆ Enabled()

◆ FormatLogStrInPlace()

◆ GetCategoryMask()

◆ GetLogPrefix()

◆ GUARDED_BY() [1/8]

◆ GUARDED_BY() [2/8]

◆ GUARDED_BY() [3/8]

◆ GUARDED_BY() [4/8]

◆ GUARDED_BY() [5/8]

◆ GUARDED_BY() [6/8]

◆ GUARDED_BY() [7/8]

◆ GUARDED_BY() [8/8]

◆ LogCategoriesList()

◆ LogCategoriesString()

◆ LogLevel()

◆ LogLevelsString()

◆ LogLevelToStr()

◆ LogPrintStr()

◆ LogPrintStr_()

◆ LogTimestampStr()

◆ NumConnections()

◆ SetCategoryLogLevel() [1/2]

◆ SetCategoryLogLevel() [2/2]

◆ SetLogLevel() [1/2]

◆ SetLogLevel() [2/2]

◆ SetRateLimiting()

◆ ShrinkDebugFile()

◆ StartLogging()

◆ WillLogCategory()

◆ WillLogCategoryLevel()

Member Data Documentation

◆ GUARDED_BY

◆ m_always_print_category_level

◆ m_categories

◆ m_cs

◆ m_file_path

◆ m_log_level

◆ m_log_sourcelocations

◆ m_log_threadnames

◆ m_log_time_micros

◆ m_log_timestamps

◆ m_print_to_console

◆ m_print_to_file

◆ m_reopen_file

◆ PushBackCallback