Syntalos::datactl

Namespaces

Name
Syntalos::datactl::detail

Classes

	Name
struct	Syntalos::datactl::LogCategory A named log category with a per-instance severity threshold.
struct	Syntalos::datactl::LogMessage Describes a single log message.

Types

	Name
enum class uint8_t	LogSeverity { TraceL3, TraceL2, TraceL1, Debug, Info, Notice, Warning, Error, Critical} Log severity enum.
using std::function< void(const LogMessage &)>	LogHandlerFn

Functions

	Name
bool	shouldLog(const LogCategory & c, LogSeverity s)
void	dispatchLog(const LogCategory & cat, LogSeverity sev, const char * file, int line, const char * function, const std::string & message)
void	setLogHandler(LogHandlerFn handler) Install a log handler for all datactl log messages.
void	setLogSeverity(LogSeverity min) Set the minimum log severity globally across all datactl categories.
void	setLogSeverity(const char * category, LogSeverity min) Set the minimum log severity for a specific category.

Attributes

	Name
std::atomic< LogCategory * >	g_categoryListHead Head of the global category linked list.
std::atomic< bool >	g_handlerActive Set to true whenever a non-empty handler is installed.

Types Documentation

enum LogSeverity

Enumerator	Value	Description
TraceL3
TraceL2
TraceL1
Debug
Info
Notice
Warning
Error
Critical

Log severity enum.

This enum is kept intentionally directly compatible with the quill::LogLevel enum. We must keep both in sync, to directly convert between the two!

using LogHandlerFn

using Syntalos::datactl::LogHandlerFn = typedef std::function<void(const LogMessage &)>;

Functions Documentation

function shouldLog

inline bool shouldLog(
    const LogCategory & c,
    LogSeverity s
)

function dispatchLog

void dispatchLog(
    const LogCategory & cat,
    LogSeverity sev,
    const char * file,
    int line,
    const char * function,
    const std::string & message
)

function setLogHandler

void setLogHandler(
    LogHandlerFn handler
)

Install a log handler for all datactl log messages.

Replaces any previously installed handler. Pass an empty/default-constructed handler to stop logging. Intended to be called once during host process initialization; not safe to call concurrently with active logging.

function setLogSeverity

void setLogSeverity(
    LogSeverity min
)

Set the minimum log severity globally across all datactl categories.

Messages below min are discarded before formatting.

function setLogSeverity

void setLogSeverity(
    const char * category,
    LogSeverity min
)

Set the minimum log severity for a specific category.

Attributes Documentation

variable g_categoryListHead

std::atomic< LogCategory * > g_categoryListHead {nullptr};

Head of the global category linked list.

variable g_handlerActive

std::atomic< bool > g_handlerActive {true};

Set to true whenever a non-empty handler is installed.

Updated on 2026-04-24 at 06:25:18 +0000

Syntalos Syntalos::datactl::detail