#pragma once #include "base.h" #include "darray.h" #ifdef __cplusplus extern "C" { #endif typedef struct profiler_snapshot profiler_snapshot_t; typedef struct profiler_snapshot_entry profiler_snapshot_entry_t; typedef struct profiler_time_entry profiler_time_entry_t; /* ------------------------------------------------------------------------- */ /* Profiling */ EXPORT void profile_register_root(const char *name, uint64_t expected_time_between_calls); EXPORT void profile_start(const char *name); EXPORT void profile_end(const char *name); EXPORT void profile_reenable_thread(void); /* ------------------------------------------------------------------------- */ /* Profiler control */ EXPORT void profiler_start(void); EXPORT void profiler_stop(void); EXPORT void profiler_print(profiler_snapshot_t *snap); EXPORT void profiler_print_time_between_calls(profiler_snapshot_t *snap); EXPORT void profiler_free(void); /* ------------------------------------------------------------------------- */ /* Profiler name storage */ typedef struct profiler_name_store profiler_name_store_t; EXPORT profiler_name_store_t *profiler_name_store_create(void); EXPORT void profiler_name_store_free(profiler_name_store_t *store); #ifndef _MSC_VER #define PRINTFATTR(f, a) __attribute__((__format__(__printf__, f, a))) #else #define PRINTFATTR(f, a) #endif PRINTFATTR(2, 3) EXPORT const char *profile_store_name(profiler_name_store_t *store, const char *format, ...); #undef PRINTFATTR /* ------------------------------------------------------------------------- */ /* Profiler data access */ struct profiler_time_entry { uint64_t time_delta; uint64_t count; }; typedef DARRAY(profiler_time_entry_t) profiler_time_entries_t; typedef bool (*profiler_entry_enum_func)(void *context, profiler_snapshot_entry_t *entry); EXPORT profiler_snapshot_t *profile_snapshot_create(void); EXPORT void profile_snapshot_free(profiler_snapshot_t *snap); EXPORT bool profiler_snapshot_dump_csv(const profiler_snapshot_t *snap, const char *filename); EXPORT bool profiler_snapshot_dump_csv_gz(const profiler_snapshot_t *snap, const char *filename); EXPORT size_t profiler_snapshot_num_roots(profiler_snapshot_t *snap); EXPORT void profiler_snapshot_enumerate_roots(profiler_snapshot_t *snap, profiler_entry_enum_func func, void *context); typedef bool (*profiler_name_filter_func)(void *data, const char *name, bool *remove); EXPORT void profiler_snapshot_filter_roots(profiler_snapshot_t *snap, profiler_name_filter_func func, void *data); EXPORT size_t profiler_snapshot_num_children(profiler_snapshot_entry_t *entry); EXPORT void profiler_snapshot_enumerate_children( profiler_snapshot_entry_t *entry, profiler_entry_enum_func func, void *context); EXPORT const char *profiler_snapshot_entry_name( profiler_snapshot_entry_t *entry); EXPORT profiler_time_entries_t *profiler_snapshot_entry_times( profiler_snapshot_entry_t *entry); EXPORT uint64_t profiler_snapshot_entry_min_time( profiler_snapshot_entry_t *entry); EXPORT uint64_t profiler_snapshot_entry_max_time( profiler_snapshot_entry_t *entry); EXPORT uint64_t profiler_snapshot_entry_overall_count( profiler_snapshot_entry_t *entry); EXPORT profiler_time_entries_t *profiler_snapshot_entry_times_between_calls( profiler_snapshot_entry_t *entry); EXPORT uint64_t profiler_snapshot_entry_expected_time_between_calls( profiler_snapshot_entry_t *entry); EXPORT uint64_t profiler_snapshot_entry_min_time_between_calls( profiler_snapshot_entry_t *entry); EXPORT uint64_t profiler_snapshot_entry_max_time_between_calls( profiler_snapshot_entry_t *entry); EXPORT uint64_t profiler_snapshot_entry_overall_between_calls_count( profiler_snapshot_entry_t *entry); #ifdef __cplusplus } #endif