logging.c File Reference

Logging category options. More...

Go to the source code of this file.

Variables
const registry_entry_t	g_logging_entries []

Detailed Description

Logging category options.

Binary-level logging and output control options including log files, verbosity levels, and grep filtering.

Author

Zachary Fogg me@zf.nosp@m.o.gg

Date

January 2026

Definition in file options/registry/logging.c.

Variable Documentation

g_logging_entries

const registry_entry_t g_logging_entries[]

Definition at line 21 of file options/registry/logging.c.

                                             {
    // LOGGING GROUP (binary-level)
    {"log-file",
     'L',
     OPTION_TYPE_CALLBACK,
     offsetof(options_t, log_file),
     NULL, // Use mode_default_getter instead
     0,
#ifndef NDEBUG
     "Set FILE as path for log file (default: current directory; filenames: server.log, client.log, mirror.log, "
     "acds.log, discovery.log).",
#else
     "Set FILE as path for log file (default: $TMPDIR/ascii-chat/ or %TEMP%\\ascii-chat\\; filenames: server.log, "
     "client.log, mirror.log, acds.log, discovery.log).",
#endif
     "LOGGING",
     "FILE",
     false,
     "ASCII_CHAT_LOG_FILE",
     NULL,
     parse_log_file,
     false,
     false,
#ifndef NDEBUG
     OPTION_MODE_CLIENT | OPTION_MODE_SERVER | OPTION_MODE_MIRROR | OPTION_MODE_DISCOVERY | OPTION_MODE_DISCOVERY_SVC,
#else
     OPTION_MODE_BINARY,
#endif
     {0},
     get_default_log_file},
    {"log-level",
     '\0',
     OPTION_TYPE_CALLBACK,
     offsetof(options_t, log_level),
     &default_log_level_value,
     sizeof(log_level_t),
     "Set log level: dev, debug, info, warn, error, fatal. Logs at or above this level are written.",
     "LOGGING",
     NULL,
     false,
     "ASCII_CHAT_LOG_LEVEL",
     NULL,
     parse_log_level,
     false,
     false,
     OPTION_MODE_BINARY,
     {.enum_values = g_log_level_values,
      .enum_descriptions = g_log_level_descs,
      .enum_integer_values = g_log_level_integers,
      .input_type = OPTION_INPUT_ENUM},
     NULL},
    {"verbose",
     'V',
     OPTION_TYPE_CALLBACK,
     offsetof(options_t, verbose_level),
     0,
     sizeof(unsigned short int),
     "Increase log verbosity (stackable: -VV, -VVV).",
     "LOGGING",
     NULL,
     false,
     "ASCII_CHAT_VERBOSE",
     NULL,
     parse_verbose_flag,
     false,
     true,
     OPTION_MODE_BINARY,
     {0},
     NULL},
    {"quiet",
     'q',
     OPTION_TYPE_BOOL,
     offsetof(options_t, quiet),
     &default_quiet_value,
     sizeof(bool),
     "Disable console logging (log to file only).",
     "LOGGING",
     NULL,
     false,
     "ASCII_CHAT_QUIET",
     NULL,
     NULL,
     false,
     false,
     OPTION_MODE_BINARY,
     {0},
     NULL},
    {"grep",
     '\0',
     OPTION_TYPE_STRING,
     offsetof(options_t, grep_pattern),
     NULL, // Default is empty string - not meaningful to display in help
     sizeof(char *),
     "Filter console logs with perl compatible regular expressions or fixed strings. "
     "Format 1: /pattern/flags (with flags). Format 2: pattern (plain regex, no flags). "
     "Flags (format 1 only): i(case-insensitive), m(multiline), s(dotall), x(extended), g(global highlight), "
     "I(invert match), F(fixed string), A<n>(n lines after), B<n>(n lines before), C<n>(n lines of context). "
     "Multiple --grep allowed (OR).",
     "LOGGING",
     "PATTERN",
     false,
     "ASCII_CHAT_GREP",
     NULL,
     NULL,
     false,
     false,
     OPTION_MODE_BINARY,
     {.examples = (const char *[]){"ERROR", "client\\.c", "network.*failed", NULL}},
     NULL},
    {"color-scheme",
     '\0',
     OPTION_TYPE_STRING,
     offsetof(options_t, color_scheme_name),
     OPT_COLOR_SCHEME_NAME_DEFAULT,
     sizeof(((options_t *)0)->color_scheme_name),
     "Color scheme for logging output. Built-in schemes: pastel, nord, solarized, dracula, gruvbox, "
     "monokai, base16-default. All schemes with light variants auto-adapt to terminal background.",
     "LOGGING",
     "NAME",
     false,
     "ASCII_CHAT_COLOR_SCHEME",
     NULL,
     NULL,
     false,
     false,
     OPTION_MODE_BINARY,
     {.input_type = OPTION_INPUT_STRING},
     NULL},
    {"json",
     '\0',
     OPTION_TYPE_BOOL,
     offsetof(options_t, json),
     &default_json_value,
     sizeof(bool),
     "Enable JSON logging (machine-readable NDJSON format). Disabled by default (text format).",
     "LOGGING",
     NULL,
     false,
     "ASCII_CHAT_JSON",
     NULL,
     NULL,
     false,
     false,
     OPTION_MODE_BINARY,
     {0},
     NULL},
    {"log-template",
     '\0',
     OPTION_TYPE_STRING,
     offsetof(options_t, log_template),
     NULL,
     sizeof(((options_t *)0)->log_template),
     "Custom log format string. Format specifiers: %time(fmt) - time with strftime format (see man 3 strftime); "
     "%level - log level (DEV/DEBUG/INFO/WARN/ERROR/FATAL); %level_aligned - level padded to 5 chars; "
     "%file - full file path; %file_relative - file path relative to project root; %line - line number; "
     "%func - function name; %tid - thread ID; %message - log message; "
     "%color(LEVEL, text) - colorize text using LEVEL's color from current scheme. "
     "Escape %% for literal %, \\\\ for literal backslash.",
     "LOGGING",
     "TEMPLATE",
     false,
     "ASCII_CHAT_LOG_TEMPLATE",
     NULL,
     NULL,
     false,
     false,
     OPTION_MODE_BINARY,
     {.input_type = OPTION_INPUT_STRING},
     NULL},
    {"log-format-console",
     '\0',
     OPTION_TYPE_BOOL,
     offsetof(options_t, log_format_console_only),
     NULL,
     sizeof(bool),
     "Apply custom log template (--log-template) only to console output (file logs use default format). See "
     "--log-template "
     "for supported format specifiers.",
     "LOGGING",
     NULL,
     false,
     "ASCII_CHAT_LOG_FORMAT_CONSOLE",
     NULL,
     NULL,
     false,
     false,
     OPTION_MODE_BINARY,
     {0},
     NULL},
 
    REGISTRY_TERMINATOR()};