network/log.h

Go to the documentation of this file.

#pragma once


typedef enum remote_log_direction {
  REMOTE_LOG_DIRECTION_UNKNOWN = 0,
  REMOTE_LOG_DIRECTION_SERVER_TO_CLIENT = 1,
  REMOTE_LOG_DIRECTION_CLIENT_TO_SERVER = 2
} remote_log_direction_t;
 
#include "../log/log.h"
 
/* ============================================================================
 * Network Logging Macros
 * ============================================================================
 * Convenience macros for sending log messages over the network.
 *
 * Server-side (logging TO a client):
 *   log_info_client(client, "Hello %s", name);
 *   - Takes client_info_t*, direction is automatically SERVER_TO_CLIENT
 *   - Only sends after connection security negotiation
 *
 * Client-side (logging TO the server):
 *   log_info_server(transport, "Hello %s", name);
 *   - Takes the shared connection transport
 *   - Direction is automatically CLIENT_TO_SERVER
 */
 
/* Server-side: log TO client (takes client_info_t*) */
#ifdef NDEBUG
#define LOG_CLIENT_IMPL(client, level, fmt, ...)                                                                       \
  do {                                                                                                                 \
    if ((client)->security_ready && (client)->transport) {                                                             \
      log_net_message((client)->transport, level, REMOTE_LOG_DIRECTION_SERVER_TO_CLIENT, NULL, 0, NULL,                \
                      fmt, ##__VA_ARGS__);                                                                             \
    }                                                                                                                  \
  } while (0)
#else
#define LOG_CLIENT_IMPL(client, level, fmt, ...)                                                                       \
  do {                                                                                                                 \
    if ((client)->security_ready && (client)->transport) {                                                             \
      log_net_message((client)->transport, level, REMOTE_LOG_DIRECTION_SERVER_TO_CLIENT, __FILE__, __LINE__, __func__, \
                      fmt, ##__VA_ARGS__);                                                                             \
    }                                                                                                                  \
  } while (0)
#endif

#define log_debug_client(client, fmt, ...) LOG_CLIENT_IMPL(client, LOG_DEBUG, fmt, ##__VA_ARGS__)

#define log_info_client(client, fmt, ...) LOG_CLIENT_IMPL(client, LOG_INFO, fmt, ##__VA_ARGS__)

#define log_warn_client(client, fmt, ...) LOG_CLIENT_IMPL(client, LOG_WARN, fmt, ##__VA_ARGS__)

#define log_error_client(client, fmt, ...) LOG_CLIENT_IMPL(client, LOG_ERROR, fmt, ##__VA_ARGS__)

#define log_fatal_client(client, fmt, ...) LOG_CLIENT_IMPL(client, LOG_FATAL, fmt, ##__VA_ARGS__)
 
/* Client-side: log TO server (takes transport) */
#ifdef NDEBUG
#define LOG_SERVER_IMPL(transport, level, fmt, ...)                                                                    \
  log_net_message(transport, level, REMOTE_LOG_DIRECTION_CLIENT_TO_SERVER, NULL, 0, NULL, fmt, ##__VA_ARGS__)
#else
#define LOG_SERVER_IMPL(transport, level, fmt, ...)                                                                    \
  log_net_message(transport, level, REMOTE_LOG_DIRECTION_CLIENT_TO_SERVER, __FILE__, __LINE__, __func__,               \
                  fmt, ##__VA_ARGS__)
#endif

#define log_debug_server(transport, fmt, ...) LOG_SERVER_IMPL(transport, LOG_DEBUG, fmt, ##__VA_ARGS__)

#define log_info_server(transport, fmt, ...) LOG_SERVER_IMPL(transport, LOG_INFO, fmt, ##__VA_ARGS__)

#define log_warn_server(transport, fmt, ...) LOG_SERVER_IMPL(transport, LOG_WARN, fmt, ##__VA_ARGS__)

#define log_error_server(transport, fmt, ...) LOG_SERVER_IMPL(transport, LOG_ERROR, fmt, ##__VA_ARGS__)

#define log_fatal_server(transport, fmt, ...) LOG_SERVER_IMPL(transport, LOG_FATAL, fmt, ##__VA_ARGS__)