itrace.h

Go to the documentation of this file.

#ifndef ITRACE_H
#define ITRACE_H
#include "itrace_types.h"
#ifdef __cplusplus
extern "C" {
#endif

#ifdef IS_ITRACE_DISABLED
#define itrace_open_logger !sizeof
#define itrace_close_logger !sizeof
#define itrace_set_root_filename !sizeof
#define itrace_get_root_filename !sizeof
#define itrace_flush_logs !sizeof
#define itrace_close_files !sizeof
#define itrace_set_target_files !sizeof
#define itrace_open_profiler !sizeof
#define itrace_close_profiler !sizeof
#define itrace_add_event !sizeof
#define itrace_add_event_by_id !sizeof
#define itrace_add_events !sizeof
#define itrace_add_events_from_file !sizeof
#define itrace_add_all_pmu_events !sizeof
#define itrace_remove_all_events !sizeof
#define itrace_add_event_set !sizeof
#define itrace_register_events !sizeof
#define itrace_get_num_events_left_to_register !sizeof
#define itrace_set_processing_mode !sizeof
#define itrace_deregister_events !sizeof
#define itrace_enable_event !sizeof
#define itrace_disable_event !sizeof
#define itrace_start_section !sizeof
#define itrace_start_section_with_section_id !sizeof
#define itrace_end_section !sizeof
#define itrace_start_section_no_events !sizeof
#define itrace_end_section_no_events !sizeof
#define itrace_read_events !sizeof
#define itrace_add_marker !sizeof
#define itrace_start_periodic_events_reader !sizeof
#define itrace_end_periodic_events_reader !sizeof
#define itrace_start_periodic_logs_flusher !sizeof
#define itrace_end_periodic_logs_flusher !sizeof
#define itrace_setup_from_file !sizeof
#define itrace_teardown !sizeof
#define itrace_flush_log !sizeof
#define itrace_set_default_profiler !sizeof
#define itrace_get_dsp_version !sizeof
#define itrace_get_domain !sizeof
#define itrace_get_itrace_version !sizeof
#define itrace_merge_csv_files !sizeof
#else

itrace_return_t itrace_open_logger(int domain, itrace_logger_handle_t* logger_handle_ptr);

itrace_return_t itrace_close_logger(itrace_logger_handle_t logger_handle);

itrace_return_t itrace_set_root_filename(itrace_logger_handle_t logger_handle, const char* root_filename);

itrace_return_t itrace_get_root_filename(itrace_logger_handle_t logger_handle, char* root_filename);

itrace_return_t itrace_flush_logs(itrace_logger_handle_t logger_handle);

itrace_return_t itrace_close_files(itrace_logger_handle_t logger_handle);

itrace_return_t itrace_set_target_files(itrace_logger_handle_t logger_handle, uint32_t file_types);


itrace_return_t itrace_open_profiler(itrace_logger_handle_t logger_handle, uint32_t domain, size_t log_size, itrace_profiler_handle_t* profiler_handle_ptr);

itrace_return_t itrace_close_profiler(itrace_profiler_handle_t profiler_handle);

itrace_return_t itrace_add_event(itrace_profiler_handle_t profiler_handle, itrace_event_t event);

itrace_return_t itrace_add_event_by_id(itrace_profiler_handle_t profiler_handle, uint32_t event_id);

itrace_return_t itrace_add_events(itrace_profiler_handle_t profiler_handle, itrace_event_t* events, int num_events);

itrace_return_t itrace_add_events_from_file(itrace_profiler_handle_t profiler_handle, const char* events_filename);

itrace_return_t itrace_add_all_pmu_events(itrace_profiler_handle_t profiler_handle);

itrace_return_t itrace_remove_all_events(itrace_profiler_handle_t profiler_handle);

itrace_return_t itrace_add_event_set(itrace_profiler_handle_t profiler_handle, const char* set_name);

itrace_return_t itrace_register_events(itrace_profiler_handle_t profiler_handle, itrace_event_t* attempted_to_register_events, int* num_attempted_to_register_events);

itrace_return_t itrace_get_num_events_left_to_register(itrace_profiler_handle_t profiler_handle, int* num_events_left_to_register);

itrace_return_t itrace_set_processing_mode(itrace_profiler_handle_t profiler_handle, itrace_processing_mode_t processing_mode);

itrace_return_t itrace_deregister_events(itrace_profiler_handle_t profiler_handle);

itrace_return_t itrace_enable_event(itrace_profiler_handle_t profiler_handle, uint32_t event_id);

itrace_return_t itrace_disable_event(itrace_profiler_handle_t profiler_handle, uint32_t event_id);


itrace_return_t itrace_start_section(itrace_profiler_handle_t profiler_handle, const char* section_name, itrace_measured_events_t* measured_events);

itrace_return_t itrace_start_section_with_section_id(itrace_profiler_handle_t profiler_handle, section_id_t section_id, itrace_measured_events_t* measured_events);

itrace_return_t itrace_end_section(itrace_profiler_handle_t profiler_handle, itrace_measured_events_t* measured_events);

void itrace_start_section_no_events(section_id_t section_id);

void itrace_end_section_no_events(void);

itrace_return_t itrace_read_events(itrace_profiler_handle_t profiler_handle, itrace_measured_events_t* measured_events);

itrace_return_t itrace_add_marker(itrace_profiler_handle_t profiler_handle, const char* marker_name);

itrace_return_t itrace_start_periodic_events_reader(itrace_profiler_handle_t profiler_handle, uint32_t events_reader_period_us, uint32_t thread_priority);

itrace_return_t itrace_end_periodic_events_reader(itrace_profiler_handle_t profiler_handle);

itrace_return_t itrace_start_periodic_logs_flusher(itrace_logger_handle_t logger_handle, uint32_t flushing_period_us);

itrace_return_t itrace_end_periodic_logs_flusher(itrace_logger_handle_t logger_handle);

itrace_return_t itrace_setup_from_file(itrace_logger_handle_t* logger_handle_ptr, const char* setup_filename);

itrace_return_t itrace_teardown(itrace_logger_handle_t logger_handle);

itrace_return_t itrace_flush_log(itrace_profiler_handle_t profiler_handle);

itrace_return_t itrace_set_default_profiler(itrace_profiler_handle_t profiler_handle);

itrace_return_t itrace_get_dsp_version(itrace_profiler_handle_t profiler_handle, char* dsp_version);

itrace_return_t itrace_get_domain(itrace_profiler_handle_t profiler_handle, uint32_t* domain_id);


itrace_return_t itrace_get_itrace_version(itrace_profiler_handle_t profiler_handle, uint32_t* version);

void itrace_merge_csv_files(char *file_name,int num_files);

#endif

#ifdef __cplusplus
}
#endif

#endif