instrument_log.h

Go to the documentation of this file.

// SPDX-License-Identifier: MIT
#pragma once
 
#include <stdbool.h>
#include <stddef.h>
#include <stdint.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
enum {
  ASCII_INSTR_SOURCE_PRINT_MACRO_NONE = 0u,      
  ASCII_INSTR_SOURCE_PRINT_MACRO_EXPANSION = 1u, 
  ASCII_INSTR_SOURCE_PRINT_MACRO_INVOCATION = 2u 
};
 
#if defined(__clang__)
#define ASCII_INSTR_SOURCE_PRINT_SIGNAL_HANDLER __attribute__((annotate("ASCII_INSTR_SOURCE_PRINT_SIGNAL_HANDLER")))
#else
#define ASCII_INSTR_SOURCE_PRINT_SIGNAL_HANDLER
#endif
 
typedef struct asciichat_instr_runtime asciichat_instr_runtime_t;
 
asciichat_instr_runtime_t *asciichat_instr_runtime_get(void);
 
void asciichat_instr_runtime_destroy(asciichat_instr_runtime_t *runtime);
 
void asciichat_instr_runtime_global_shutdown(void);
 
void asciichat_instr_log_line(const char *file_path, uint32_t line_number, const char *function_name,
                              const char *snippet, uint8_t is_macro_expansion);
 
bool asciichat_instr_coverage_enabled(void);
 
void asciichat_instr_log_pc(uintptr_t program_counter);
 
#ifdef __cplusplus
}
#endif