[all] debug: add multiline debug print variants

This commit is contained in:
Geoffrey McRae
2026-07-29 10:27:14 +10:00
parent 61f00ae625
commit ea7924af43
4 changed files with 189 additions and 10 deletions

View File

@@ -74,6 +74,10 @@ void debug_level(enum DebugLevel level, const char * file, unsigned int line,
const char * function, const char * format, ...)
__attribute__((format (printf, 5, 6)));
void debug_levelML(enum DebugLevel level, const char * file, unsigned int line,
const char * function, const char * format, ...)
__attribute__((format (printf, 5, 6)));
void debug_info(const char * file, unsigned int line, const char * function,
const char * format, ...) __attribute__((format (printf, 4, 5)));
@@ -113,12 +117,22 @@ void debug_trace(const char * file, unsigned int line, const char * function,
fmt, ##__VA_ARGS__); \
} while (0)
#define DEBUG_PRINT_ML(level, fmt, ...) do { \
debug_levelML(level, STRIPPATH(__FILE__), __LINE__, __FUNCTION__, \
fmt, ##__VA_ARGS__); \
} while (0)
#define DEBUG_BREAK() DEBUG_PRINT(DEBUG_LEVEL_INFO, "================================================================================")
#define DEBUG_INFO(fmt, ...) DEBUG_PRINT(DEBUG_LEVEL_INFO, fmt, ##__VA_ARGS__)
#define DEBUG_WARN(fmt, ...) DEBUG_PRINT(DEBUG_LEVEL_WARN, fmt, ##__VA_ARGS__)
#define DEBUG_ERROR(fmt, ...) DEBUG_PRINT(DEBUG_LEVEL_ERROR, fmt, ##__VA_ARGS__)
#define DEBUG_TRACE(fmt, ...) DEBUG_PRINT(DEBUG_LEVEL_TRACE, fmt, ##__VA_ARGS__)
#define DEBUG_FIXME(fmt, ...) DEBUG_PRINT(DEBUG_LEVEL_FIXME, fmt, ##__VA_ARGS__)
#define DEBUG_INFO_ML(fmt, ...) DEBUG_PRINT_ML(DEBUG_LEVEL_INFO, fmt, ##__VA_ARGS__)
#define DEBUG_WARN_ML(fmt, ...) DEBUG_PRINT_ML(DEBUG_LEVEL_WARN, fmt, ##__VA_ARGS__)
#define DEBUG_ERROR_ML(fmt, ...) DEBUG_PRINT_ML(DEBUG_LEVEL_ERROR, fmt, ##__VA_ARGS__)
#define DEBUG_TRACE_ML(fmt, ...) DEBUG_PRINT_ML(DEBUG_LEVEL_TRACE, fmt, ##__VA_ARGS__)
#define DEBUG_FIXME_ML(fmt, ...) DEBUG_PRINT_ML(DEBUG_LEVEL_FIXME, fmt, ##__VA_ARGS__)
#define DEBUG_FATAL(fmt, ...) do { \
DEBUG_BREAK(); \
DEBUG_PRINT(DEBUG_LEVEL_FATAL, fmt, ##__VA_ARGS__); \
@@ -126,6 +140,13 @@ void debug_trace(const char * file, unsigned int line, const char * function,
abort(); \
DEBUG_UNREACHABLE_MARKER(); \
} while(0)
#define DEBUG_FATAL_ML(fmt, ...) do { \
DEBUG_BREAK(); \
DEBUG_PRINT_ML(DEBUG_LEVEL_FATAL, fmt, ##__VA_ARGS__); \
DEBUG_PRINT_BACKTRACE(); \
abort(); \
DEBUG_UNREACHABLE_MARKER(); \
} while(0)
#define DEBUG_ASSERT_PRINT(...) DEBUG_ERROR("Assertion failed: %s", #__VA_ARGS__)

View File

@@ -38,19 +38,15 @@ void debug_enableTracing(void)
traceEnabled = true;
}
inline static void debug_levelVA(enum DebugLevel level, const char * file,
unsigned int line, const char * function, const char * format, va_list va)
inline static void debug_printPrefix(enum DebugLevel level, const char * file,
unsigned int line, const char * function, uint64_t elapsed)
{
if (level == DEBUG_LEVEL_TRACE && !traceEnabled)
return;
const char * f = strrchr(file, DIRECTORY_SEPARATOR);
if (!f)
f = file;
else
++f;
uint64_t elapsed = microtime() - startTime;
uint64_t sec = elapsed / 1000000UL;
uint64_t us = elapsed % 1000000UL;
@@ -62,11 +58,66 @@ inline static void debug_levelVA(enum DebugLevel level, const char * file,
debug_lookup[level],
f,
line, function);
}
inline static void debug_levelVA(enum DebugLevel level, const char * file,
unsigned int line, const char * function, const char * format, va_list va)
{
if (level == DEBUG_LEVEL_TRACE && !traceEnabled)
return;
debug_printPrefix(level, file, line, function, microtime() - startTime);
vfprintf(stderr, format, va);
fprintf(stderr, "%s\n", debug_lookup[DEBUG_LEVEL_NONE]);
}
inline static void debug_levelMLVA(enum DebugLevel level, const char * file,
unsigned int line, const char * function, const char * format, va_list va)
{
if (level == DEBUG_LEVEL_TRACE && !traceEnabled)
return;
va_list copy;
va_copy(copy, va);
int length = vsnprintf(NULL, 0, format, copy);
va_end(copy);
if (length < 0)
return;
char * message = malloc((size_t)length + 1);
if (!message)
return;
va_copy(copy, va);
int result = vsnprintf(message, (size_t)length + 1, format, copy);
va_end(copy);
if (result < 0)
{
free(message);
return;
}
const uint64_t elapsed = microtime() - startTime;
const char * start = message;
while (true)
{
const char * end = strchr(start, '\n');
size_t lineLength = end ? (size_t)(end - start) : strlen(start);
if (lineLength && start[lineLength - 1] == '\r')
--lineLength;
debug_printPrefix(level, file, line, function, elapsed);
fwrite(start, 1, lineLength, stderr);
fprintf(stderr, "%s\n", debug_lookup[DEBUG_LEVEL_NONE]);
if (!end || !end[1])
break;
start = end + 1;
}
free(message);
}
void debug_level(enum DebugLevel level, const char * file, unsigned int line,
const char * function, const char * format, ...)
@@ -77,6 +128,15 @@ void debug_level(enum DebugLevel level, const char * file, unsigned int line,
va_end(va);
}
void debug_levelML(enum DebugLevel level, const char * file, unsigned int line,
const char * function, const char * format, ...)
{
va_list va;
va_start(va, format);
debug_levelMLVA(level, file, line, function, format, va);
va_end(va);
}
void debug_info(const char * file, unsigned int line, const char * function,
const char * format, ...)
{