asciichat_errno.c File Reference

🚨 Custom error code system with formatted messages, thread-local storage, and errno mapping More...

Go to the source code of this file.

Macros
#define	MAX_THREAD_ERRORS   64

Functions
void	log_labeled (const char *label, log_color_t color, const char *message,...)
void	asciichat_set_errno (asciichat_error_t code, const char *file, int line, const char *function, const char *context_message)
void	asciichat_set_errno_with_message (asciichat_error_t code, const char *file, int line, const char *function, const char *format,...)
void	asciichat_set_errno_with_system_error (asciichat_error_t code, const char *file, int line, const char *function, int sys_errno)
void	asciichat_set_errno_with_system_error_and_message (asciichat_error_t code, const char *file, int line, const char *function, int sys_errno, const char *format,...)
void	asciichat_set_errno_with_wsa_error (asciichat_error_t code, const char *file, int line, const char *function, int wsa_error)
bool	asciichat_has_wsa_error (void)
bool	asciichat_has_errno (asciichat_error_context_t *context)
void	asciichat_clear_errno (void)
asciichat_error_t	asciichat_get_errno (void)
void	asciichat_fatal_with_context (asciichat_error_t code, const char *file, int line, const char *function, const char *format,...)
void	asciichat_print_error_context (const asciichat_error_context_t *context)
void	asciichat_error_stats_init (void)
void	asciichat_error_stats_record (asciichat_error_t code)
void	asciichat_error_stats_print (void)
void	asciichat_error_stats_reset (void)
asciichat_error_stats_t	asciichat_error_stats_get (void)
asciichat_error_t	asciichat_get_thread_error (int thread_id)
void	asciichat_set_thread_error (int thread_id, asciichat_error_t code)
void	asciichat_clear_thread_error (int thread_id)
void	asciichat_errno_suppress (bool suppress)
void	asciichat_errno_destroy (void)

Variables
__thread asciichat_error_context_t	asciichat_errno_context
__thread asciichat_error_t	asciichat_errno = ASCIICHAT_OK

Detailed Description

🚨 Custom error code system with formatted messages, thread-local storage, and errno mapping

Definition in file asciichat_errno.c.

Macro Definition Documentation

MAX_THREAD_ERRORS

#define MAX_THREAD_ERRORS   64

Definition at line 62 of file asciichat_errno.c.

Function Documentation

asciichat_clear_errno()

void asciichat_clear_errno

(

void

)

Definition at line 236 of file asciichat_errno.c.

                                 {
  if (asciichat_errno_context.context_message) {
    SAFE_FREE(asciichat_errno_context.context_message);
    asciichat_errno_context.context_message = NULL;
  }
 
  if (asciichat_errno_context.backtrace_symbols != NULL) {
    platform_backtrace_symbols_destroy(asciichat_errno_context.backtrace_symbols);
    asciichat_errno_context.backtrace_symbols = NULL;
  }
 
  memset(&asciichat_errno_context, 0, sizeof(asciichat_errno_context));
  asciichat_errno_context.code = ASCIICHAT_OK;
  asciichat_errno_context.system_errno = 0;
  asciichat_errno_context.has_system_error = false;
  asciichat_errno_context.has_wsa_error = false;
  asciichat_errno_context.wsa_error = 0;
 
  /* Clear platform-specific error state */
  platform_clear_error_state();
}

References asciichat_errno_context, platform_backtrace_symbols_destroy(), and platform_clear_error_state().

asciichat_clear_thread_error()

void asciichat_clear_thread_error

(

int

thread_id

)

Definition at line 484 of file asciichat_errno.c.

                                                 {
  for (int i = 0; i < MAX_THREAD_ERRORS; i++) {
    if (thread_errors[i].valid && thread_errors[i].thread_id == thread_id) {
      thread_errors[i].valid = false;
      break;
    }
  }
}

References MAX_THREAD_ERRORS, thread_id, and valid.

asciichat_errno_destroy()

void asciichat_errno_destroy

(

void

)

Definition at line 502 of file asciichat_errno.c.

                                   {
  if (asciichat_errno_context.backtrace_symbols != NULL) {
    platform_backtrace_symbols_destroy(asciichat_errno_context.backtrace_symbols);
    asciichat_errno_context.backtrace_symbols = NULL;
  }
 
  if (asciichat_errno_context.context_message != NULL) {
    SAFE_FREE(asciichat_errno_context.context_message);
  }
 
  // Reset the context to a clean state
  memset(&asciichat_errno_context, 0, sizeof(asciichat_errno_context));
  asciichat_errno_context.code = ASCIICHAT_OK;
 
  // Suppress any further error context allocation to prevent cleanup-phase leaks
  // This prevents other atexit() functions from allocating new contexts after we've cleaned up
  g_suppress_error_context = true;
}

References asciichat_errno_context, and platform_backtrace_symbols_destroy().

Referenced by asciichat_shared_destroy(), client_audio_render_thread(), client_receive_thread(), client_send_thread_func(), client_video_render_thread(), server_main(), and stats_logger_thread().

asciichat_errno_suppress()

void asciichat_errno_suppress

(

bool

suppress

)

Definition at line 498 of file asciichat_errno.c.

                                             {
  g_suppress_error_context = suppress;
}

asciichat_error_stats_get()

asciichat_error_stats_t asciichat_error_stats_get

(

void

)

Definition at line 436 of file asciichat_errno.c.

                                                        {
  static_mutex_lock(&g_error_stats_mutex);
 
  if (!stats_initialized) {
    memset(&error_stats, 0, sizeof(error_stats));
    stats_initialized = true;
  }
 
  asciichat_error_stats_t result = error_stats;
  static_mutex_unlock(&g_error_stats_mutex);
 
  return result;
}

asciichat_error_stats_init()

void asciichat_error_stats_init

(

void

)

Definition at line 365 of file asciichat_errno.c.

                                      {
  static_mutex_lock(&g_error_stats_mutex);
 
  if (!stats_initialized) {
    memset(&error_stats, 0, sizeof(error_stats));
    stats_initialized = true;
  }
 
  static_mutex_unlock(&g_error_stats_mutex);
}

asciichat_error_stats_print()

void asciichat_error_stats_print

(

void

)

Definition at line 394 of file asciichat_errno.c.

                                       {
  static_mutex_lock(&g_error_stats_mutex);
 
  if (!stats_initialized || error_stats.total_errors == 0) {
    static_mutex_unlock(&g_error_stats_mutex);
    log_plain("No errors recorded.\n");
    return;
  }
 
  // Copy stats to local variable to minimize lock hold time
  asciichat_error_stats_t local_stats = error_stats;
  static_mutex_unlock(&g_error_stats_mutex);
 
  log_plain("\n=== ascii-chat Error Statistics ===\n");
  log_plain("Total errors: %llu\n", (unsigned long long)local_stats.total_errors);
 
  if (local_stats.last_error_time > 0) {
    time_t sec = (time_t)(local_stats.last_error_time / NS_PER_MS_INT);
    struct tm tm_info;
    if (platform_localtime(&sec, &tm_info) == ASCIICHAT_OK) {
      char time_str[64];
      strftime(time_str, sizeof(time_str), "%Y-%m-%d %H:%M:%S", &tm_info);
      log_plain("Last error: %s (code %d)\n", time_str, (int)local_stats.last_error_code);
    }
  }
 
  log_plain("\nError breakdown:\n");
  for (int i = 0; i < 256; i++) {
    if (local_stats.error_counts[i] > 0) {
      log_plain("  %3d (%s): %llu\n", i, asciichat_error_string((asciichat_error_t)i),
                (unsigned long long)local_stats.error_counts[i]);
    }
  }
  log_plain("\n");
}

References platform_localtime().

Referenced by server_main(), and stats_logger_thread().

asciichat_error_stats_record()

void asciichat_error_stats_record

(

asciichat_error_t

code

)

Definition at line 376 of file asciichat_errno.c.

                                                          {
  static_mutex_lock(&g_error_stats_mutex);
 
  if (!stats_initialized) {
    memset(&error_stats, 0, sizeof(error_stats));
    stats_initialized = true;
  }
 
  if (code >= 0 && code < 256) {
    error_stats.error_counts[code]++;
  }
  error_stats.total_errors++;
  error_stats.last_error_time = time_ns_to_us(time_get_realtime_ns());
  error_stats.last_error_code = code;
 
  static_mutex_unlock(&g_error_stats_mutex);
}

References time_get_realtime_ns().

Referenced by asciichat_set_errno().

asciichat_error_stats_reset()

void asciichat_error_stats_reset

(

void

)

Definition at line 430 of file asciichat_errno.c.

                                       {
  static_mutex_lock(&g_error_stats_mutex);
  memset(&error_stats, 0, sizeof(error_stats));
  static_mutex_unlock(&g_error_stats_mutex);
}

asciichat_fatal_with_context()

void asciichat_fatal_with_context	(	asciichat_error_t	code,
		const char *	file,
		int	line,
		const char *	function,
		const char *	format,
			...
	)

Definition at line 267 of file asciichat_errno.c.

                                                           {
  (void)file;
  (void)line;
  (void)function;
 
  // Print library error context if available
  asciichat_error_context_t err_ctx;
  if (HAS_ERRNO(&err_ctx)) {
    log_labeled("\nasciichat_errno: libary code error context", LOG_COLOR_ERROR, "");
    asciichat_print_error_context(&err_ctx);
  } else {
    log_plain("WARNING: No error context found (asciichat_errno_context.code=%d)", asciichat_errno_context.code);
  }
 
  safe_fprintf(stderr, "\n");
  log_labeled("FATAL ERROR", LOG_COLOR_FATAL, "exit code %d (%s)", (int)code, asciichat_error_string(code));
#ifndef NDEBUG
  const char *relative_file = extract_project_relative_path(file);
  log_plain("  Location: %s:%d in %s()", relative_file, line, function);
#endif
 
  if (format) {
    va_list args;
    va_start(args, format);
    char *formatted_message = format_message(format, args);
    log_plain("  Error message: %s", formatted_message);
    SAFE_FREE(formatted_message);
    va_end(args);
  }
 
#ifndef NDEBUG
  // Always print platform backtrace in debug/dev builds
  void *buffer[32];
  int size = platform_backtrace(buffer, 32);
  if (size > 0) {
    char **symbols = platform_backtrace_symbols(buffer, size);
    if (symbols) {
      platform_print_backtrace_symbols("\nFATAL BACKTRACE", symbols, size, 0, 0, skip_backtrace_frame);
      platform_backtrace_symbols_destroy(symbols);
    }
  }
#endif
 
  exit(code);
}

References args, asciichat_errno_context, asciichat_print_error_context(), extract_project_relative_path(), format_message(), log_labeled(), platform_backtrace(), platform_backtrace_symbols(), platform_backtrace_symbols_destroy(), platform_print_backtrace_symbols(), and safe_fprintf().

asciichat_get_errno()

asciichat_error_t asciichat_get_errno

(

void

)

Definition at line 258 of file asciichat_errno.c.

                                            {
  return asciichat_errno_context.code;
}

References asciichat_errno_context.

asciichat_get_thread_error()

asciichat_error_t asciichat_get_thread_error

(

int

thread_id

)

Definition at line 455 of file asciichat_errno.c.

                                                            {
  for (int i = 0; i < MAX_THREAD_ERRORS; i++) {
    if (thread_errors[i].valid && thread_errors[i].thread_id == thread_id) {
      return thread_errors[i].error_code;
    }
  }
  return ASCIICHAT_OK;
}

References MAX_THREAD_ERRORS, thread_id, and valid.

asciichat_has_errno()

bool asciichat_has_errno

(

asciichat_error_context_t *

context

)

Definition at line 224 of file asciichat_errno.c.

                                                             {
  if (asciichat_errno_context.code == ASCIICHAT_OK) {
    return false;
  }
 
  if (context) {
    *context = asciichat_errno_context;
  }
 
  return true;
}

References asciichat_errno_context.

asciichat_has_wsa_error()

bool asciichat_has_wsa_error

(

void

)

Definition at line 215 of file asciichat_errno.c.

                                   {
  return asciichat_errno_context.has_wsa_error;
}

References asciichat_errno_context.

asciichat_print_error_context()

void asciichat_print_error_context

(

const asciichat_error_context_t *

context

)

Definition at line 319 of file asciichat_errno.c.

                                                                             {
  if (!context || context->code == ASCIICHAT_OK) {
    return;
  }
 
  if (context->file && context->line && context->function) {
    log_plain("  Location: %s:%d in %s()", extract_project_relative_path(context->file), context->line,
              context->function);
  } else {
    log_plain("  Location: unknown (set by system code)");
  }
 
  if (context->context_message) {
    safe_fprintf(stderr, "  %s %s\n", colored_string(LOG_COLOR_WARN, "Context:"), context->context_message);
    log_file("  Context: %s", context->context_message);
  }
 
  if (context->has_system_error) {
    log_plain("  System error: %s (code: %d, meaning: %s)", SAFE_STRERROR(context->system_errno), context->system_errno,
              SAFE_STRERROR(context->system_errno));
  }
 
  // Print timestamp
  if (context->timestamp > 0) {
    time_t sec = (time_t)(context->timestamp / NS_PER_MS_INT);
    long usec = (long)(context->timestamp % NS_PER_MS_INT);
    struct tm tm_info;
    if (platform_localtime(&sec, &tm_info) == ASCIICHAT_OK) {
      char time_str[64];
      (void)strftime(time_str, sizeof(time_str), "%Y-%m-%d %H:%M:%S", &tm_info);
      log_plain("  Timestamp: %s.%06ld", time_str, usec);
    }
  }
 
  // Print stack trace from library error
  if (context->stack_depth > 0 && context->backtrace_symbols) {
    platform_print_backtrace_symbols("\nBacktrace from library error", context->backtrace_symbols, context->stack_depth,
                                     0, 0, skip_backtrace_frame);
  }
}

References colored_string(), extract_project_relative_path(), platform_localtime(), platform_print_backtrace_symbols(), and safe_fprintf().

Referenced by asciichat_fatal_with_context().

asciichat_set_errno()

void asciichat_set_errno	(	asciichat_error_t	code,
		const char *	file,
		int	line,
		const char *	function,
		const char *	context_message
	)

Definition at line 112 of file asciichat_errno.c.

                                                      {
  // Suppress error context allocation during cleanup to prevent leaks
  if (g_suppress_error_context) {
    return;
  }
 
  // Clear any existing context message
  if (asciichat_errno_context.context_message) {
    SAFE_FREE(asciichat_errno_context.context_message);
    asciichat_errno_context.context_message = NULL;
  }
 
  // Set the error context
  asciichat_errno_context.code = code;
  asciichat_errno_context.file = file;
  asciichat_errno_context.line = line;
  asciichat_errno_context.function = function;
  asciichat_errno_context.timestamp = time_ns_to_us(time_get_realtime_ns());
  asciichat_errno_context.has_system_error = false;
 
  // Set the simple error code variable
  asciichat_errno = code;
 
  // Copy context message if provided
  if (context_message == NULL) {
    log_error("context_message is NULL");
    const char *fallback = "No context message (this is invalid - set a context message)";
    size_t len = strlen(fallback) + 1;
    asciichat_errno_context.context_message = SAFE_MALLOC(len, char *);
    if (asciichat_errno_context.context_message) {
      SAFE_STRNCPY(asciichat_errno_context.context_message, fallback, len);
    } else {
      log_error("SAFE_MALLOC failed for fallback context_message");
    }
  } else {
    size_t len = strlen(context_message) + 1;
    asciichat_errno_context.context_message = SAFE_MALLOC(len, char *);
    if (asciichat_errno_context.context_message) {
      SAFE_STRNCPY(asciichat_errno_context.context_message, context_message, len);
    } else {
      log_error("SAFE_MALLOC failed for context_message");
    }
  }
 
  // Capture stack trace in debug builds
  if (asciichat_errno_context.backtrace_symbols != NULL) {
    platform_backtrace_symbols_destroy(asciichat_errno_context.backtrace_symbols);
    asciichat_errno_context.backtrace_symbols = NULL;
  }
  capture_backtrace(asciichat_errno_context.backtrace, &asciichat_errno_context.backtrace_symbols,
                    &asciichat_errno_context.stack_depth);
 
  // Record in statistics
  asciichat_error_stats_record(code);
}

References asciichat_errno, asciichat_errno_context, asciichat_error_stats_record(), platform_backtrace_symbols_destroy(), and time_get_realtime_ns().

Referenced by asciichat_set_errno_with_message(), asciichat_set_errno_with_system_error(), asciichat_set_errno_with_system_error_and_message(), and asciichat_set_errno_with_wsa_error().

asciichat_set_errno_with_message()

void asciichat_set_errno_with_message	(	asciichat_error_t	code,
		const char *	file,
		int	line,
		const char *	function,
		const char *	format,
			...
	)

Definition at line 169 of file asciichat_errno.c.

                                                               {
  va_list args;
  va_start(args, format);
 
  char *context_message = format_message(format, args);
  asciichat_set_errno(code, file, line, function, context_message);
 
  if (context_message) {
    SAFE_FREE(context_message);
  }
 
  va_end(args);
}

References args, asciichat_set_errno(), and format_message().

asciichat_set_errno_with_system_error()

void asciichat_set_errno_with_system_error	(	asciichat_error_t	code,
		const char *	file,
		int	line,
		const char *	function,
		int	sys_errno
	)

Definition at line 184 of file asciichat_errno.c.

                                                          {
  asciichat_set_errno(code, file, line, function, NULL);
  asciichat_errno_context.system_errno = sys_errno;
  asciichat_errno_context.has_system_error = true;
}

References asciichat_errno_context, and asciichat_set_errno().

asciichat_set_errno_with_system_error_and_message()

void asciichat_set_errno_with_system_error_and_message	(	asciichat_error_t	code,
		const char *	file,
		int	line,
		const char *	function,
		int	sys_errno,
		const char *	format,
			...
	)

Definition at line 191 of file asciichat_errno.c.

                                                                                                                     {
  va_list args;
  va_start(args, format);
 
  char *context_message = format_message(format, args);
  asciichat_set_errno(code, file, line, function, context_message);
  asciichat_errno_context.system_errno = sys_errno;
  asciichat_errno_context.has_system_error = true;
 
  if (context_message) {
    SAFE_FREE(context_message);
  }
 
  va_end(args);
}

References args, asciichat_errno_context, asciichat_set_errno(), and format_message().

asciichat_set_errno_with_wsa_error()

void asciichat_set_errno_with_wsa_error	(	asciichat_error_t	code,
		const char *	file,
		int	line,
		const char *	function,
		int	wsa_error
	)

Definition at line 208 of file asciichat_errno.c.

                                                       {
  asciichat_set_errno(code, file, line, function, NULL);
  asciichat_errno_context.wsa_error = wsa_error;
  asciichat_errno_context.has_wsa_error = true;
}

References asciichat_errno_context, and asciichat_set_errno().

asciichat_set_thread_error()

void asciichat_set_thread_error	(	int	thread_id,
		asciichat_error_t	code
	)

Definition at line 464 of file asciichat_errno.c.

                                                                       {
  // Find existing entry or empty slot
  int slot = -1;
  for (int i = 0; i < MAX_THREAD_ERRORS; i++) {
    if (thread_errors[i].valid && thread_errors[i].thread_id == thread_id) {
      slot = i;
      break;
    }
    if (!thread_errors[i].valid && slot == -1) {
      slot = i;
    }
  }
 
  if (slot >= 0) {
    thread_errors[slot].thread_id = thread_id;
    thread_errors[slot].error_code = code;
    thread_errors[slot].valid = true;
  }
}

References MAX_THREAD_ERRORS, thread_id, and valid.

log_labeled()

void log_labeled	(	const char *	label,
		log_color_t	color,
		const char *	message,
			...
	)

Definition at line 94 of file asciichat_errno.c.

                                                                                 {
  va_list args;
  va_start(args, message);
  char *formatted_message = format_message(message, args);
  va_end(args);
 
  safe_fprintf(stderr, "%s: %s\n", colored_string(color, label), formatted_message);
 
  log_file("%s: %s", label, formatted_message);
 
  SAFE_FREE(formatted_message);
}

References args, colored_string(), format_message(), and safe_fprintf().

Referenced by asciichat_fatal_with_context().

Variable Documentation

asciichat_errno

__thread asciichat_error_t asciichat_errno = ASCIICHAT_OK

Definition at line 43 of file asciichat_errno.c.

Referenced by accept_with_timeout(), and asciichat_set_errno().

asciichat_errno_context

__thread asciichat_error_context_t asciichat_errno_context

Initial value:

= {.code = ASCIICHAT_OK,
                                                              .file = NULL,
                                                              .line = 0,
                                                              .function = NULL,
                                                              .context_message = NULL,
                                                              .timestamp = 0,
                                                              .system_errno = 0,
                                                              .backtrace = {0},
                                                              .backtrace_symbols = NULL,
                                                              .stack_depth = 0,
                                                              .has_system_error = false}

Definition at line 31 of file asciichat_errno.c.

                                                             {.code = ASCIICHAT_OK,
                                                              .file = NULL,
                                                              .line = 0,
                                                              .function = NULL,
                                                              .context_message = NULL,
                                                              .timestamp = 0,
                                                              .system_errno = 0,
                                                              .backtrace = {0},
                                                              .backtrace_symbols = NULL,
                                                              .stack_depth = 0,
                                                              .has_system_error = false};

Referenced by accept_with_timeout(), asciichat_clear_errno(), asciichat_errno_destroy(), asciichat_fatal_with_context(), asciichat_get_errno(), asciichat_has_errno(), asciichat_has_wsa_error(), asciichat_set_errno(), asciichat_set_errno_with_system_error(), asciichat_set_errno_with_system_error_and_message(), and asciichat_set_errno_with_wsa_error().

error_code

asciichat_error_t error_code

Definition at line 65 of file asciichat_errno.c.

Referenced by accept_with_timeout(), acip_send_error(), acip_server_send_error(), connect_with_timeout(), packet_send_error(), send_error_packet(), send_error_packet_message(), and webcam_print_init_error_help().

thread_id

int thread_id

Definition at line 64 of file asciichat_errno.c.

Referenced by asciichat_clear_thread_error(), asciichat_get_thread_error(), asciichat_set_thread_error(), and ascii_query::LLDBController::selectThread().

valid

bool valid

Definition at line 66 of file asciichat_errno.c.

Referenced by asciichat_clear_thread_error(), asciichat_get_thread_error(), asciichat_set_thread_error(), and database_session_verify_key().