libtracefs: Add tracefs_event_is_enabled() API
PATCH 1/1 libtracefs: Add tracefs_event_is_enabled() API
From: "Steven Rostedt (Google)" <[email protected]>
Add a function that checks if an event (or events) are enabled or not. Returns the enums:
TRACEFS_ERROR = -1
TRACEFS_ALL_DISABLED = 0
TRACEFS_ALL_ENABLED = 1
TRACEFS_SOME_ENABLED = 2
Signed-off-by Steven Rostedt (Google) <[email protected]>
--- Documentation/libtracefs-events.txt | 30 ++++++- include/tracefs.h | 9 ++ src/tracefs-events.c | 128 ++++++++++++++++++++++++++-- 3 files changed, 157 insertions(+), 10 deletions(-)
Documentation/libtracefs-events.txt +29 -1
@@ -4,7 +4,7 @@ libtracefs(3) NAME ---- tracefs_event_systems, tracefs_system_events, tracefs_event_enable, tracefs_event_disable, -tracefs_iterate_raw_events, tracefs_iterate_stop - Work with trace systems and events. +tracefs_event_is_enabled, tracefs_iterate_raw_events, tracefs_iterate_stop - Work with trace systems and events. SYNOPSIS --------
@@ -12,12 +12,22 @@ SYNOPSIS -- *#include <tracefs.h>* +enum tracefs_event_state { + TRACEFS_ERROR = -1, + TRACEFS_ALL_DISABLED = 0, + TRACEFS_ALL_ENABLED = 1, + TRACEFS_SOME_ENABLED = 2, +}; + char pass:[*]pass:[*]*tracefs_event_systems*(const char pass:[*]_tracing_dir_); char pass:[*]pass:[*]*tracefs_system_events*(const char pass:[*]_tracing_dir_, const char pass:[*]_system_); int *tracefs_event_enable*(struct tracefs_instance pass:[*]_instance_, const char pass:[*]_system_, const char pass:[*]_event_); int *tracefs_event_disable*(struct tracefs_instance pass:[*]_instance_, const char pass:[*]_system_, const char pass:[*]_event_); +enum tracefs_enable_state *tracefs_event_is_enabled*(struct tracefs_instance pass:[*]instance, + const char pass:[*]system, const char pass:[*]event); + int *tracefs_iterate_raw_events*(struct tep_handle pass:[*]_tep_, struct tracefs_instance pass:[*]_instance_, cpu_set_t pass:[*]_cpus_, int _cpu_size_, int (pass:[*]_callback_)(struct tep_event pass:[*], struct tep_record pass:[*], int, void pass:[*]),
@@ -61,6 +71,24 @@ events. That is, if _instance_ is NULL, then the top level tracing directory is used. If both _system_ and _event_ are NULL then all events are disabled for the given _instance_, and so on. +The *tracefs_event_is_enabled()* returns if an event is enabled, a set of +events are enabled, a system is enabled, or all events are enabled. If both +_system_ and _event_ are NULL, then it returns the enable state of all events. +If _system_ is not NULL and _event_ is NULL, then it will check if all the events +in all the systems that _system_ and return the enable state of those events. +If _system_ is NULL and _event_ is not NULL, then it will match all the events +in all systmes that match _event_ and return their enabled state. If both _system_ +and _event_ are not NULL, then it will return the enabled state of all matching +events. The enabled state is defined as: + +*TRACEFS_ERROR* - An error occurred including no event were matched. + +*TRACEFS_ALL_DISABLED* - All matching events are disabled. + +*TRACEFS_ALL_ENABLED* - All matching events are enabled. + +*TRACEFS_SOME_ENABLED* - Some matching events were enabled while others were not. + The *tracefs_iterate_raw_events()* function will read the tracefs raw data buffers and call the specified _callback_ function for every event it encounters. Events are iterated in sorted order: oldest first. An initialized
include/tracefs.h +9 -0
@@ -67,8 +67,17 @@ int tracefs_trace_off(struct tracefs_instance *instance);int tracefs_trace_on_fd (int fd);int tracefs_trace_off_fd (int fd); +enum tracefs_enable_state { +TRACEFS_ERROR =-1 , +TRACEFS_ALL_DISABLED =0 , +TRACEFS_ALL_ENABLED =1 , +TRACEFS_SOME_ENABLED =2 , +}; +int tracefs_event_enable (struct tracefs_instance *instance,const char *system,const char *event);int tracefs_event_disable (struct tracefs_instance *instance,const char *system,const char *event); +enum tracefs_enable_state tracefs_event_is_enabled (struct tracefs_instance *instance, +const char *system,const char *event);char *tracefs_error_last (struct tracefs_instance *instance);char *tracefs_error_all (struct tracefs_instance *instance);
src/tracefs-events.c +119 -9
181 lines not on this page · raw message
Signature · 1 line
2.35.1