ascii-chat/debug_2named_8h_source.html

#pragma once


#include <stdint.h>

#include <stdbool.h>


#ifdef __cplusplus

extern "C" {

#endif


#include "../platform/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);


const char *named_get_type(uintptr_t key);


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 asciichat_thread_to_key(asciichat_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_POOL(pool, name, parent_ptr)                                                                         \

  named_register((uintptr_t)(const void *)(pool), (name), "buffer_pool", "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(asciichat_thread_to_key((thread)), (name), "thread", "0x%tx", __FILE__, __LINE__, __func__, (uintptr_t)(const void *)(parent_ptr))


#define NAMED_UNREGISTER_THREAD(thread) named_unregister(asciichat_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_NODE_POOL(pool, name, parent_ptr)                                                                           \

  named_register((uintptr_t)(const void *)(pool), (name), "node_pool", "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);


void named_registry_for_each(named_iter_callback_t callback, void *user_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)


#ifdef __cplusplus

}

#endif


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

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:573

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

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

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

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

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:526

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:458

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

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

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:868

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:355

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:590

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

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:509

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

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:188

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:400

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:258

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:323

asciichat_thread_to_key
uintptr_t asciichat_thread_to_key(asciichat_thread_t thread)
Convert a thread handle to a registry key.
Definition threading.c:87

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

asciichat_thread_t
void * asciichat_thread_t
Definition lib/platform/wasm/stubs/thread.h:16

stdbool.h
ClangTool/LibTooling compatibility shim for stdbool.h.