ascii-chat/debug_2named_8h_source.html

#pragma once


/* Storage capacities in elements; text buffers include the terminating NUL. */

#define DEBUG_NAMED_NAME_BUFFER_SIZE 256

#define DEBUG_NAMED_TYPE_BUFFER_SIZE 64

#define DEBUG_NAMED_FORMAT_BUFFER_SIZE 64


#include <stdint.h>

#include <stdbool.h>

#include <ascii-chat/asciichat_errno.h>


#ifdef __cplusplus

extern "C" {

#endif


#include <libplatform/thread.h>


// ============================================================================

// Core Registry API

// ============================================================================


asciichat_error_t named_init(void);


void named_destroy(void);


const char *named_register(uintptr_t key, const char *base_name, const char *type, const char *format_spec,

                           const char *file, int line, const char *func, uintptr_t parent_key);


const char *named_register_fmt(uintptr_t key, const char *type, const char *format_spec, const char *file, int line,

                               const char *func, const char *fmt, ...);


void named_unregister(uintptr_t key);


const char *named_update_name(uintptr_t key, const char *new_base_name);


const char *named_get(uintptr_t key);


typedef struct {

  char name[DEBUG_NAMED_NAME_BUFFER_SIZE];

  char type[DEBUG_NAMED_TYPE_BUFFER_SIZE];

  char format[DEBUG_NAMED_FORMAT_BUFFER_SIZE];

} named_metadata_t;


bool named_metadata_copy(uintptr_t key, named_metadata_t *output);

bool named_fd_metadata_copy(int fd, named_metadata_t *output);

bool named_packet_metadata_copy(int packet_type, named_metadata_t *output);


const char *named_get_type(uintptr_t key);


bool named_registry_has_type(const char *type, size_t length);


const char *named_get_format_spec(uintptr_t key);


const char *named_register_fd(int fd, const char *name, const char *file, int line, const char *func);


const char *named_get_fd(int fd);


const char *named_get_fd_format_spec(int fd);


const char *named_register_packet_type(int pkt_type, const char *file, int line, const char *func);


const char *named_get_packet_type(int pkt_type);


const char *named_get_packet_type_format_spec(int pkt_type);


const char *named_get_by_type_and_id(const char *type_name, size_t type_len, int id);


const char *named_describe(uintptr_t key, const char *type_hint);


uintptr_t thread_to_key(platform_thread_t thread);


// ============================================================================

// Convenience Macros — Pointer-based Registration

// ============================================================================


#define NAMED_REGISTER(ptr, name, type, fmt, parent_ptr)                                                               \

  named_register((uintptr_t)(const void *)(ptr), (name), (type), (fmt), __FILE__, __LINE__, __func__,                  \

                 (uintptr_t)(const void *)(parent_ptr))


#define NAMED_REGISTER_FMT(ptr, type, fmt_spec, fmt, ...)                                                              \

  named_register_fmt((uintptr_t)(const void *)(ptr), (type), (fmt_spec), __FILE__, __LINE__, __func__, (fmt),          \

                     __VA_ARGS__)


#define NAMED_UNREGISTER(ptr) named_unregister((uintptr_t)(const void *)(ptr))


#define NAMED_GET(ptr) named_get((uintptr_t)(const void *)(ptr))


#define NAMED_DESCRIBE(ptr, hint) named_describe((uintptr_t)(const void *)(ptr), (hint))


// ============================================================================

// Convenience Macros — Integer Handle Registration

// ============================================================================


#define NAMED_REGISTER_ID(id, name, type, fmt, parent_ptr)                                                             \

  named_register((uintptr_t)(intptr_t)(id), (name), (type), (fmt), __FILE__, __LINE__, __func__,                       \

                 (uintptr_t)(const void *)(parent_ptr))


#define NAMED_UNREGISTER_ID(id) named_unregister((uintptr_t)(intptr_t)(id))


#define NAMED_DESCRIBE_ID(id, hint) named_describe((uintptr_t)(intptr_t)(id), (hint))


// ============================================================================

// Type-Specific Convenience Macros (Mutex, RWLock, Cond, Thread)

// ============================================================================


#define NAMED_REGISTER_MUTEX(mutex, name, parent_ptr)                                                                  \

  named_register((uintptr_t)(const void *)(mutex), (name), "mutex", "0x%tx", __FILE__, __LINE__, __func__,             \

                 (uintptr_t)(const void *)(parent_ptr))


#ifndef NDEBUG


#define NAMED_REGISTER_RWLOCK(lock, name, parent_ptr)                                                                  \

  named_register((uintptr_t)(const void *)(lock), (name), "rwlock", "0x%tx", __FILE__, __LINE__, __func__,             \

                 (uintptr_t)(const void *)(parent_ptr))


#else

#define NAMED_REGISTER_RWLOCK(lock, name, parent_ptr) ((void)(lock), (void)(parent_ptr), (name))

#endif


#define NAMED_REGISTER_COND(cond, name, parent_ptr)                                                                    \

  named_register((uintptr_t)(const void *)(cond), (name), "cond", "0x%tx", __FILE__, __LINE__, __func__,               \

                 (uintptr_t)(const void *)(parent_ptr))


#define NAMED_REGISTER_SOCKET(socket, name, parent_ptr)                                                                \

  named_register((uintptr_t)(intptr_t)(socket), (name), "socket", "0x%tx", __FILE__, __LINE__, __func__,               \

                 (uintptr_t)(const void *)(parent_ptr))


#define NAMED_UNREGISTER_SOCKET(socket) NAMED_UNREGISTER_ID((socket))


#define NAMED_REGISTER_WEBSOCKET(websocket, name, parent_ptr)                                                          \

  named_register((uintptr_t)(const void *)(websocket), (name), "websocket", "0x%tx", __FILE__, __LINE__, __func__,     \

                 (uintptr_t)(const void *)(parent_ptr))


#define NAMED_REGISTER_DATACHANNEL(datachannel, name, parent_ptr)                                                      \

  named_register((uintptr_t)(const void *)(datachannel), (name), "datachannel", "0x%tx", __FILE__, __LINE__, __func__, \

                 (uintptr_t)(const void *)(parent_ptr))


#define NAMED_REGISTER_THREADPOOL_WORK(work, name, parent_ptr)                                                         \

  named_register((uintptr_t)(const void *)(work), (name), "work", "0x%tx", __FILE__, __LINE__, __func__,               \

                 (uintptr_t)(const void *)(parent_ptr))


#define NAMED_REGISTER_CLIENT(client, name, parent_ptr)                                                                \

  named_register((uintptr_t)(const void *)(client), (name), "client", "0x%tx", __FILE__, __LINE__, __func__,           \

                 (uintptr_t)(const void *)(parent_ptr))


#define NAMED_REGISTER_CRYPTO_CONTEXT(ctx, name, parent_ptr)                                                           \

  named_register((uintptr_t)(const void *)(ctx), (name), "crypto", "0x%tx", __FILE__, __LINE__, __func__,              \

                 (uintptr_t)(const void *)(parent_ptr))


#define NAMED_REGISTER_TRANSPORT(transport, name, parent_ptr)                                                          \

  named_register((uintptr_t)(const void *)(transport), (name), "transport", "0x%tx", __FILE__, __LINE__, __func__,     \

                 (uintptr_t)(const void *)(parent_ptr))


#define NAMED_REGISTER_FRAME_BUFFER(buf, name, parent_ptr)                                                             \

  named_register((uintptr_t)(const void *)(buf), (name), "frame_buffer", "0x%tx", __FILE__, __LINE__, __func__,        \

                 (uintptr_t)(const void *)(parent_ptr))


#define NAMED_REGISTER_PACKET_QUEUE(queue, name, parent_ptr)                                                           \

  named_register((uintptr_t)(const void *)(queue), (name), "packet_queue", "0x%tx", __FILE__, __LINE__, __func__,      \

                 (uintptr_t)(const void *)(parent_ptr))


#define NAMED_REGISTER_AUDIO_RINGBUF(buf, name, parent_ptr)                                                            \

  named_register((uintptr_t)(const void *)(buf), (name), "audio_ringbuf", "0x%tx", __FILE__, __LINE__, __func__,       \

                 (uintptr_t)(const void *)(parent_ptr))


#define NAMED_REGISTER_MIXER(mixer, name, parent_ptr)                                                                  \

  named_register((uintptr_t)(const void *)(mixer), (name), "mixer", "0x%tx", __FILE__, __LINE__, __func__,             \

                 (uintptr_t)(const void *)(parent_ptr))


#define NAMED_REGISTER_AUDIO_CODEC(codec, name, parent_ptr)                                                            \

  named_register((uintptr_t)(const void *)(codec), (name), "audio_codec", "0x%tx", __FILE__, __LINE__, __func__,       \

                 (uintptr_t)(const void *)(parent_ptr))


#define NAMED_REGISTER_VIDEO_ENCODER(encoder, name, parent_ptr)                                                        \

  named_register((uintptr_t)(const void *)(encoder), (name), "video_encoder", "0x%tx", __FILE__, __LINE__, __func__,   \

                 (uintptr_t)(const void *)(parent_ptr))


#define NAMED_REGISTER_BUFFER_DOMAIN(pool, name, parent_ptr)                                                           \

  named_register((uintptr_t)(const void *)(pool), (name), "buffer_domain", "0x%tx", __FILE__, __LINE__, __func__,      \

                 (uintptr_t)(const void *)(parent_ptr))


#define NAMED_REGISTER_FFMPEG_DECODER(decoder, name, parent_ptr)                                                       \

  named_register((uintptr_t)(const void *)(decoder), (name), "ffmpeg_decoder", "0x%tx", __FILE__, __LINE__, __func__,  \

                 (uintptr_t)(const void *)(parent_ptr))


#define NAMED_REGISTER_FFMPEG_ENCODER(encoder, name, parent_ptr)                                                       \

  named_register((uintptr_t)(const void *)(encoder), (name), "ffmpeg_encoder", "0x%tx", __FILE__, __LINE__, __func__,  \

                 (uintptr_t)(const void *)(parent_ptr))


#define NAMED_REGISTER_H265_ENCODER(encoder, name, parent_ptr)                                                         \

  named_register((uintptr_t)(const void *)(encoder), (name), "h265_encoder", "0x%tx", __FILE__, __LINE__, __func__,    \

                 (uintptr_t)(const void *)(parent_ptr))


#define NAMED_REGISTER_H265_DECODER(decoder, name, parent_ptr)                                                         \

  named_register((uintptr_t)(const void *)(decoder), (name), "h265_decoder", "0x%tx", __FILE__, __LINE__, __func__,    \

                 (uintptr_t)(const void *)(parent_ptr))


#define NAMED_REGISTER_AUDIO_CONTEXT(ctx, name, parent_ptr)                                                            \

  named_register((uintptr_t)(const void *)(ctx), (name), "audio_context", "0x%tx", __FILE__, __LINE__, __func__,       \

                 (uintptr_t)(const void *)(parent_ptr))


#define NAMED_REGISTER_RATE_LIMITER(limiter, name, parent_ptr)                                                         \

  named_register((uintptr_t)(const void *)(limiter), (name), "rate_limiter", "0x%tx", __FILE__, __LINE__, __func__,    \

                 (uintptr_t)(const void *)(parent_ptr))


#define NAMED_REGISTER_WAV_WRITER(writer, name, parent_ptr)                                                            \

  named_register((uintptr_t)(const void *)(writer), (name), "wav_writer", "0x%tx", __FILE__, __LINE__, __func__,       \

                 (uintptr_t)(const void *)(parent_ptr))


#define NAMED_REGISTER_MEDIA_SOURCE(source, name, parent_ptr)                                                          \

  named_register((uintptr_t)(const void *)(source), (name), "media_source", "0x%tx", __FILE__, __LINE__, __func__,     \

                 (uintptr_t)(const void *)(parent_ptr))


#define NAMED_OPEN(pathname, name, flags, ...)                                                                         \

  ({                                                                                                                   \

    int _fd;                                                                                                           \

    if ((flags) & O_CREAT) {                                                                                           \

      _fd = platform_open((pathname), (flags), __VA_ARGS__);                                                           \

    } else {                                                                                                           \

      _fd = platform_open((pathname), (flags));                                                                        \

    }                                                                                                                  \

    if (_fd >= 0) {                                                                                                    \

      named_register_fd(_fd, NULL, __FILE__, __LINE__, __func__);                                                      \

    }                                                                                                                  \

    _fd;                                                                                                               \

  })


#define NAMED_UNREGISTER_FD(fd) NAMED_UNREGISTER_ID((fd))


#define NAMED_REGISTER_FD(fd, name) named_register_fd((fd), (name), __FILE__, __LINE__, __func__)


#define NAMED_REGISTER_ATOMIC(a, name, parent_ptr)                                                                     \

  named_register((uintptr_t)(const void *)(a), (name), "atomic", "0x%tx", __FILE__, __LINE__, __func__,                \

                 (uintptr_t)(const void *)(parent_ptr))


#define NAMED_REGISTER_ATOMIC_PTR(a, name, parent_ptr)                                                                 \

  named_register((uintptr_t)(const void *)(a), (name), "atomic_ptr", "0x%tx", __FILE__, __LINE__, __func__,            \

                 (uintptr_t)(const void *)(parent_ptr))


// ============================================================================

// Thread-Specific Registration Macros

// ============================================================================


#define NAMED_REGISTER_THREAD(thread, name, parent_ptr)                                                                \

  named_register(thread_to_key((thread)), (name), "thread", "0x%tx", __FILE__, __LINE__, __func__,                     \

                 (uintptr_t)(const void *)(parent_ptr))


#define NAMED_UNREGISTER_THREAD(thread) named_unregister(thread_to_key((thread)))


// ============================================================================

// Type-Specific Description Macros

// ============================================================================


#define NAME_DESCRIBE_MUTEX(m) named_describe((uintptr_t)(const void *)(m), "mutex")


#define NAME_DESCRIBE_RWLOCK(l) named_describe((uintptr_t)(const void *)(l), "rwlock")


#define NAME_DESCRIBE_COND(c) named_describe((uintptr_t)(const void *)(c), "cond")


#define NAME_DESCRIBE_THREAD(t) named_describe_thread(t)


#define NAME_DESCRIBE_TRANSPORT(tr) named_describe((uintptr_t)(const void *)(tr), "transport")


#define NAME_DESCRIBE_SOCKET(fd) named_describe((uintptr_t)(intptr_t)(fd), "socket")


#define NAME_DESCRIBE_RINGBUF(rb) named_describe((uintptr_t)(const void *)(rb), "ringbuf")

 /* Type-Specific Description Macros */


// ============================================================================

// Thread-Specific Description Function

// ============================================================================


const char *named_describe_thread(void *thread);


// ============================================================================

// Registry Iteration

// ============================================================================


typedef void (*named_iter_callback_t)(uintptr_t key, const char *name, void *user_data);


#define NAMED_REGISTER_TCP_CLIENT(client, name, parent_ptr)                                                            \

  named_register((uintptr_t)(const void *)(client), (name), "tcp_client", "0x%tx", __FILE__, __LINE__, __func__,       \

                 (uintptr_t)(const void *)(parent_ptr))


#define NAMED_REGISTER_WEBSOCKET_CLIENT(client, name, parent_ptr)                                                      \

  named_register((uintptr_t)(const void *)(client), (name), "websocket_client", "0x%tx", __FILE__, __LINE__, __func__, \

                 (uintptr_t)(const void *)(parent_ptr))


#define NAMED_REGISTER_APP_CLIENT(client, name, parent_ptr)                                                            \

  named_register((uintptr_t)(const void *)(client), (name), "app_client", "0x%tx", __FILE__, __LINE__, __func__,       \

                 (uintptr_t)(const void *)(parent_ptr))


#define NAMED_REGISTER_VIDEO_FRAME_BUFFER(buf, name, parent_ptr)                                                       \

  named_register((uintptr_t)(const void *)(buf), (name), "video_frame_buffer", "0x%tx", __FILE__, __LINE__, __func__,  \

                 (uintptr_t)(const void *)(parent_ptr))


#define NAMED_REGISTER_THREAD_POOL(pool, name, parent_ptr)                                                             \

  named_register((uintptr_t)(const void *)(pool), (name), "thread_pool", "0x%tx", __FILE__, __LINE__, __func__,        \

                 (uintptr_t)(const void *)(parent_ptr))


#define NAMED_REGISTER_OPTIONS_BUILDER(builder, name, parent_ptr)                                                      \

  named_register((uintptr_t)(const void *)(builder), (name), "options_builder", "0x%tx", __FILE__, __LINE__, __func__, \

                 (uintptr_t)(const void *)(parent_ptr))


#define NAMED_REGISTER_SIMPLE_FRAME_SWAP(swap, name, parent_ptr)                                                       \

  named_register((uintptr_t)(const void *)(swap), (name), "simple_frame_swap", "0x%tx", __FILE__, __LINE__, __func__,  \

                 (uintptr_t)(const void *)(parent_ptr))


#define NAMED_REGISTER_CLIENT_AUDIO_PIPELINE(pipeline, name, parent_ptr)                                               \

  named_register((uintptr_t)(const void *)(pipeline), (name), "client_audio_pipeline", "0x%tx", __FILE__, __LINE__,    \

                 __func__, (uintptr_t)(const void *)(parent_ptr))


#ifdef DEBUG_MEMORY

#define NAMED_REGISTER_WEBSOCKET_IMPL(data, name, parent_ptr)                                                          \

  named_register((uintptr_t)(const void *)(data), (name), "websocket_impl", "0x%tx", __FILE__, __LINE__, __func__,     \

                 (uintptr_t)(const void *)(parent_ptr))

#else

#define NAMED_REGISTER_WEBSOCKET_IMPL(data, name, parent_ptr) ((void)(data), (void)(name), (void)(parent_ptr))

#endif


void named_registry_register_packet_types(void);


asciichat_error_t named_registry_for_each(named_iter_callback_t callback, void *user_data, bool *completed);


bool named_registry_read(uintptr_t key, const char *type, void (*read_object)(uintptr_t, void *), void *user_data);


typedef void (*named_snapshot_fn)(uintptr_t key, uint64_t generation, const char *name, const char *type,

                                  const char *file, int line, void *data);

asciichat_error_t named_registry_try_snapshot(size_t capacity, size_t *required, bool *completed,

                                              named_snapshot_fn copy, void *data);


#define NAMED_REGISTER_LWS_CONTEXT(context, name, parent_ptr)                                                          \

  named_register((uintptr_t)(const void *)(context), (name), "lws_context", "0x%tx", __FILE__, __LINE__, __func__,     \

                 (uintptr_t)(const void *)(parent_ptr))


#define NAMED_REGISTER_FFMPEG_CONTEXT(context, name, parent_ptr)                                                       \

  named_register((uintptr_t)(const void *)(context), (name), "ffmpeg_context", "0x%tx", __FILE__, __LINE__, __func__,  \

                 (uintptr_t)(const void *)(parent_ptr))


#define NAMED_REGISTER_CONTEXT(context, context_type, name, parent_ptr)                                                \

  named_register((uintptr_t)(const void *)(context), (name), (context_type), "0x%tx", __FILE__, __LINE__, __func__,    \

                 (uintptr_t)(const void *)(parent_ptr))


#define NAMED_GET_BY_PTR(key, buffer, size)                                                                            \

  do {                                                                                                                 \

    const char *_name = named_get(key);                                                                                \

    if (_name) {                                                                                                       \

      size_t _len = strlen(_name);                                                                                     \

      if (_len >= (size))                                                                                              \

        _len = (size) - 1;                                                                                             \

      memcpy((buffer), (_name), _len);                                                                                 \

      (buffer)[_len] = '\0';                                                                                           \

    } else {                                                                                                           \

      snprintf((buffer), (size), "0x%tx", (ptrdiff_t)(key));                                                           \

    }                                                                                                                  \

  } while (0)


#define NAMED_GET_BY_INT(id, buffer, size)                                                                             \

  do {                                                                                                                 \

    const char *_name = named_get((uintptr_t)(id));                                                                    \

    if (_name) {                                                                                                       \

      size_t _len = strlen(_name);                                                                                     \

      if (_len >= (size))                                                                                              \

        _len = (size) - 1;                                                                                             \

      memcpy((buffer), (_name), _len);                                                                                 \

      (buffer)[_len] = '\0';                                                                                           \

    } else {                                                                                                           \

      snprintf((buffer), (size), "0x%lx", (unsigned long)(id));                                                        \

    }                                                                                                                  \

  } while (0)


#define NAMED_GET_BY_STR(str, buffer, size)                                                                            \

  do {                                                                                                                 \

    if ((str)) {                                                                                                       \

      strncpy((buffer), (str), (size) - 1);                                                                            \

      (buffer)[(size) - 1] = '\0';                                                                                     \

    } else {                                                                                                           \

      (buffer)[0] = '\0';                                                                                              \

    }                                                                                                                  \

  } while (0)


void named_print_hash_stats(void);


#ifdef __cplusplus

}

#endif

 /* debug_named */

asciichat_errno.h
Synchronized per-thread pending error stacks and value snapshots. SET_ERRNO pushes,...

uint64_t
unsigned long long uint64_t
Definition common.h:63

named_print_hash_stats
void named_print_hash_stats(void)
Definition debug/named.c:864

named_get_fd
const char * named_get_fd(int fd)
Look up a registered file descriptor.
Definition debug/named.c:761

named_registry_has_type
bool named_registry_has_type(const char *type, size_t length)
Definition debug/named.c:515

named_get_packet_type_format_spec
const char * named_get_packet_type_format_spec(int pkt_type)
Get the format specifier for a registered packet type.
Definition debug/named.c:843

thread_to_key
uintptr_t thread_to_key(platform_thread_t thread)
Convert a thread handle to a registry key.

named_packet_metadata_copy
bool named_packet_metadata_copy(int packet_type, named_metadata_t *output)
Definition debug/named.c:722

named_registry_read
bool named_registry_read(uintptr_t key, const char *type, void(*read_object)(uintptr_t, void *), void *user_data)
Definition debug/named.c:683

named_destroy
void named_destroy(void)
Destroy the named object registry.
Definition debug/named.c:259

named_describe
const char * named_describe(uintptr_t key, const char *type_hint)
Format a description string for logging.
Definition debug/named.c:555

named_snapshot_fn
void(* named_snapshot_fn)(uintptr_t key, uint64_t generation, const char *name, const char *type, const char *file, int line, void *data)
Definition debug/named.h:1056

DEBUG_NAMED_FORMAT_BUFFER_SIZE
#define DEBUG_NAMED_FORMAT_BUFFER_SIZE
Definition debug/named.h:49

named_metadata_copy
bool named_metadata_copy(uintptr_t key, named_metadata_t *output)
Definition debug/named.c:211

named_get_packet_type
const char * named_get_packet_type(int pkt_type)
Look up a registered packet type.
Definition debug/named.c:826

named_register_packet_type
const char * named_register_packet_type(int pkt_type, const char *file, int line, const char *func)
Register a packet type with namespace encoding.
Definition debug/named.c:795

named_register_fd
const char * named_register_fd(int fd, const char *name, const char *file, int line, const char *func)
Register a file descriptor with namespace encoding.
Definition debug/named.c:726

named_get_type
const char * named_get_type(uintptr_t key)
Look up the registered type for a resource.
Definition debug/named.c:529

named_unregister
void named_unregister(uintptr_t key)
Unregister a resource by key.
Definition debug/named.c:442

named_iter_callback_t
void(* named_iter_callback_t)(uintptr_t key, const char *name, void *user_data)
Callback function for iterating registered entries.
Definition debug/named.h:927

named_get_format_spec
const char * named_get_format_spec(uintptr_t key)
Get the format specifier for a registered named object.
Definition debug/named.c:542

named_registry_try_snapshot
asciichat_error_t named_registry_try_snapshot(size_t capacity, size_t *required, bool *completed, named_snapshot_fn copy, void *data)
Definition debug/named.c:659

named_registry_register_packet_types
void named_registry_register_packet_types(void)
Register all packet types from packet_type_t enum.
Definition debug/named.c:860

named_get
const char * named_get(uintptr_t key)
Look up the registered name for a resource.
Definition debug/named.c:502

DEBUG_NAMED_TYPE_BUFFER_SIZE
#define DEBUG_NAMED_TYPE_BUFFER_SIZE
Definition debug/named.h:48

named_get_fd_format_spec
const char * named_get_fd_format_spec(int fd)
Get the format specifier for a registered file descriptor.
Definition debug/named.c:778

named_fd_metadata_copy
bool named_fd_metadata_copy(int fd, named_metadata_t *output)
Definition debug/named.c:718

named_registry_for_each
asciichat_error_t named_registry_for_each(named_iter_callback_t callback, void *user_data, bool *completed)
Iterate through all registered entries.
Definition debug/named.c:602

DEBUG_NAMED_NAME_BUFFER_SIZE
#define DEBUG_NAMED_NAME_BUFFER_SIZE
Definition debug/named.h:47

named_init
asciichat_error_t named_init(void)
Initialize the named object registry.
Definition debug/named.c:238

named_register
const char * named_register(uintptr_t key, const char *base_name, const char *type, const char *format_spec, const char *file, int line, const char *func, uintptr_t parent_key)
Register a resource with an auto-suffixed name, type, and location info.
Definition debug/named.c:329

named_get_by_type_and_id
const char * named_get_by_type_and_id(const char *type_name, size_t type_len, int id)
Look up an integer ID by type name and value.

named_describe_thread
const char * named_describe_thread(void *thread)
Describe a thread for logging (function wrapper).
Definition debug/named.c:587

named_register_fmt
const char * named_register_fmt(uintptr_t key, const char *type, const char *format_spec, const char *file, int line, const char *func, const char *fmt,...)
Register a resource with a formatted name, type, and location info (no auto-suffix).
Definition debug/named.c:400

named_update_name
const char * named_update_name(uintptr_t key, const char *new_base_name)
Update the registered name for a resource with a new base name.
Definition debug/named.c:472

asciichat_error_t
asciichat_error_t
Error and exit codes - unified status values (0-255).
Definition error_codes.h:44

named_metadata_t
The useful part of named metadata is in its fields: together they describe what is pending,...
Definition debug/named.h:174

named_metadata_t::format
char format[64]
Definition debug/named.h:177

named_metadata_t::type
char type[64]
Definition debug/named.h:176

named_metadata_t::name
char name[256]
Definition debug/named.h:175