libtracefs: New API for getting synthetic event
PATCH 1/1 libtracefs: New API for getting synthetic event
A new API is proposed, to get tep event descriptor for given synthetic event:
tracefs_synth_get_event ()
The API implementation gets derived from the implementation of the existing API tracefs_dynevent_get_event(). It can detect any newly created or removed synthetic events.
--- Documentation/libtracefs-synth2.txt | 14 ++++++++++++-- include/tracefs-local.h | 2 ++ include/tracefs.h | 2 ++ src/tracefs-dynevents.c | 17 +---------------- src/tracefs-events.c | 21 +++++++++++++++++++++ src/tracefs-hist.c | 18 ++++++++++++++++++ 6 files changed, 56 insertions(+), 18 deletions(-)
Documentation/libtracefs-synth2.txt +12 -2
@@ -6,7 +6,8 @@ NAME tracefs_synth_create, tracefs_synth_destroy, tracefs_synth_echo_cmd, tracefs_synth_complete, tracefs_synth_get_start_hist, tracefs_synth_trace, tracefs_synth_snapshot, tracefs_synth_get_name, tracefs_synth_raw_fmt, tracefs_synth_show_event, -tracefs_synth_show_start_hist, tracefs_synth_show_end_hist - Creation of synthetic events +tracefs_synth_show_start_hist, tracefs_synth_show_end_hist, tracefs_synth_get_event +- Creation of synthetic events SYNOPSIS --------
@@ -32,7 +33,8 @@ int tracefs_synth_raw_fmt(struct trace_seq pass:[*]seq, struct tracefs_synth pas const char *tracefs_synth_show_event(struct tracefs_synth pass:[*]synth); const char *tracefs_synth_show_start_hist(struct tracefs_synth pass:[*]synth); const char *tracefs_synth_show_end_hist(struct tracefs_synth pass:[*]synth); - +tracefs_synth_get_event +struct tep_event pass:[*]*tracefs_synth_get_event*(struct tep_handle pass:[*]_tep_, struct tracefs_synth pass:[*]_synth_); -- DESCRIPTION
@@ -114,11 +116,19 @@ and is freed with the event by *tracefs_synth_free*(). synthetic event or NULL on error. The returned string belongs to the synth event object and is freed with the event by *tracefs_synth_free*(). +The *tracefs_synth_get_event*() function returns a tep event, describing the given synthetic +event. The API detects any newly created or removed dynamic events. The returned pointer to +tep event is controlled by @tep and must not be freed. + RETURN VALUE ------------ *tracefs_synth_get_name*(), *tracefs_synth_show_event*(), *tracefs_synth_show_start_hist*() and *tracefs_synth_show_end_hist*() return a string owned by the synth event object. +The *tracefs_synth_get_event*() function returns a pointer to a tep event or NULL in case of an +error or if the requested synthetic event is missing. The returned pointer to tep event is +controlled by @tep and must not be freed. + All other functions return zero on success or -1 on error. ERRORS
include/tracefs-local.h +2 -0
@@ -116,5 +116,7 @@ int trace_load_events(struct tep_handle *tep, const char *tracing_dir, const char *system);int trace_rescan_events (struct tep_handle *tep,const char *tracing_dir,const char *system); +__hidden struct tep_event *get_tep_event(struct tep_handle *tep, +const char *system,const char *name);#endif /* _TRACE_FS_LOCAL_H */
include/tracefs.h +2 -0
@@ -564,5 +564,7 @@ const char *tracefs_synth_show_end_hist(struct tracefs_synth *synth);struct tracefs_synth *tracefs_sql (struct tep_handle *tep,const char *name,const char *sql_buffer,char **err); +struct tep_event * +tracefs_synth_get_event (struct tep_handle *tep,struct tracefs_synth *synth);#endif /* _TRACE_FS_H */
src/tracefs-dynevents.c +1 -16
@@ -765,23 +765,8 @@ error:struct tep_event *tracefs_dynevent_get_event (struct tep_handle *tep,struct tracefs_dynevent *dynevent) { -struct tep_event *event; -if (!tep || !dynevent || !dynevent->event)return NULL ; -/* Check if event exists in the system */ -if (!tracefs_event_file_exists (NULL , dynevent->system, dynevent->event,"format" )) -return NULL ; - -/* If the dynamic event is already loaded in the tep, return it */ - event =tep_find_event_by_name (tep, dynevent->system, dynevent->event); -if (event) -return event; - -/* Try to load any new events from the given system */ -if (trace_rescan_events (tep,NULL , dynevent->system)) -return NULL ; - -return tep_find_event_by_name (tep, dynevent->system, dynevent->event); +return get_tep_event (tep, dynevent->system, dynevent->event); }
src/tracefs-events.c +21 -0
@@ -752,6 +752,27 @@ __hidden int trace_load_events(struct tep_handle *tep,return load_events (tep, tracing_dir, system, false); } +__hidden struct tep_event *get_tep_event(struct tep_handle *tep, +const char *system,const char *name) +{ +struct tep_event *event; + +/* Check if event exists in the system */ +if (!tracefs_event_file_exists (NULL , system, name,"format" )) +return NULL ; + +/* If the dynamic event is already loaded in the tep, return it */ + event =tep_find_event_by_name (tep, system, name); +if (event) +return event; + +/* Try to load any new events from the given system */ +if (trace_rescan_events (tep,NULL , system)) +return NULL ; + +return tep_find_event_by_name (tep, system, name); +} +static int read_header (struct tep_handle *tep,const char *tracing_dir) {struct stat st;
src/tracefs-hist.c +18 -0
@@ -2197,3 +2197,21 @@ int tracefs_synth_echo_cmd(struct trace_seq *seq, }return ret; } + +/** +* tracefs_synth_get_event - return tep event representing the given synthetic event +* @tep: a handle to the trace event parser context that holds the events +* @synth: a synthetic event context, describing given synthetic event. +* +* Returns a pointer to a tep event describing the given synthetic event. The pointer +* is managed by the @tep handle and must not be freed. In case of an error, or in case +* the requested synthetic event is missing in the @tep handler - NULL is returned. +*/ +struct tep_event * +tracefs_synth_get_event (struct tep_handle *tep,struct tracefs_synth *synth) +{ +if (!tep || !synth || !synth->name) +return NULL ; + +return get_tep_event (tep,SYNTHETIC_GROUP , synth->name); +}
Signature · 1 line
2.32.0
Quoted 35 lines · Yordan Karadzhov (VMware)
A new API is proposed, to get tep event descriptor for given synthetic event:
tracefs_synth_get_event()The API implementation gets derived from the implementation of the existing API
tracefs_dynevent_get_event(). It can detect any newly created or removed synthetic events.Signed-off-by Yordan Karadzhov (VMware) <[email protected]>--- Documentation/libtracefs-synth2.txt | 14 ++++++++++++-- include/tracefs-local.h | 2 ++ include/tracefs.h | 2 ++ src/tracefs-dynevents.c | 17 +---------------- src/tracefs-events.c | 21 +++++++++++++++++++++ src/tracefs-hist.c | 18 ++++++++++++++++++ 6 files changed, 56 insertions(+), 18 deletions(-)Documentation/libtracefs-synth2.txt +2
-1@@ -6,7 +6,8 @@ NAME tracefs_synth_create, tracefs_synth_destroy, tracefs_synth_echo_cmd, tracefs_synth_complete, tracefs_synth_get_start_hist, tracefs_synth_trace, tracefs_synth_snapshot, tracefs_synth_get_name, tracefs_synth_raw_fmt, tracefs_synth_show_event, -tracefs_synth_show_start_hist, tracefs_synth_show_end_hist - Creation of synthetic events +tracefs_synth_show_start_hist, tracefs_synth_show_end_hist, tracefs_synth_get_event +- Creation of synthetic events SYNOPSIS --------
Documentation/libtracefs-synth2.txt int tracefs_synth_raw_fmt(struct trace_seq pass:[*]seq, struct tracefs_synth pas · line 36
Quoted 5 lines
Documentation/libtracefs-synth2.txt +1
-1@@ -32,7 +33,8 @@ int tracefs_synth_raw_fmt(struct trace_seq pass:[*]seq, struct tracefs_synth pas const char *tracefs_synth_show_event(struct tracefs_synth pass:[*]synth); const char *tracefs_synth_show_start_hist(struct tracefs_synth pass:[*]synth); const char *tracefs_synth_show_end_hist(struct tracefs_synth pass:[*]synth); - +tracefs_synth_get_event
Looks like something forgotten.
Documentation/libtracefs-synth2.txt int tracefs_synth_raw_fmt(struct trace_seq pass:[*]seq, struct tracefs_synth pas · line 37
Quoted 1 line
Documentation/libtracefs-synth2.txt +1
-0+struct tep_event pass:[*]*tracefs_synth_get_event*(struct tep_handle pass:[*]_tep_, struct tracefs_synth pass:[*]_synth_);
The arguments of the other functions in this man page are not underlined, all should follow the same style. As in the other man pages of the library all arguments are underlined, this should be the default style.
This could be addressed in a follow up patch - applying the same style of all tracefs man pages.
Quoted 28 lines
Documentation/libtracefs-synth2.txt +8
-0-- DESCRIPTION@@ -114,11 +116,19 @@ and is freed with the event by *tracefs_synth_free*(). synthetic event or NULL on error. The returned string belongs to the synth event object and is freed with the event by *tracefs_synth_free*(). +The *tracefs_synth_get_event*() function returns a tep event, describing the given synthetic +event. The API detects any newly created or removed dynamic events. The returned pointer to +tep event is controlled by @tep and must not be freed. + RETURN VALUE ------------ *tracefs_synth_get_name*(), *tracefs_synth_show_event*(), *tracefs_synth_show_start_hist*() and *tracefs_synth_show_end_hist*() return a string owned by the synth event object. +The *tracefs_synth_get_event*() function returns a pointer to a tep event or NULL in case of an +error or if the requested synthetic event is missing. The returned pointer to tep event is +controlled by @tep and must not be freed. + All other functions return zero on success or -1 on error. ERRORSinclude/tracefs-local.h +0
-0
include/tracefs-local.h int trace_load_events(struct tep_handle *tep, · line 120
Quoted 5 lines
include/tracefs-local.h +2
-0@@ -116,5 +116,7 @@ int trace_load_events(struct tep_handle *tep, const char *tracing_dir, const char *system);int trace_rescan_events (struct tep_handle *tep,const char *tracing_dir,const char *system); +__hidden struct tep_event *get_tep_event(struct tep_handle *tep, +const char *system,const char *name);
"__hidden" is not needed here, in the header file. All functions in tracefs-local.h are hidden and this is specified in their implementation.
Quoted 104 lines
include/tracefs-local.h +0
-0#endif /* _TRACE_FS_LOCAL_H */ include/tracefs.h +2
-0@@ -564,5 +564,7 @@ const char *tracefs_synth_show_end_hist(struct tracefs_synth *synth);struct tracefs_synth *tracefs_sql (struct tep_handle *tep,const char *name,const char *sql_buffer,char **err); +struct tep_event * +tracefs_synth_get_event (struct tep_handle *tep,struct tracefs_synth *synth);#endif /* _TRACE_FS_H */ src/tracefs-dynevents.c +1
-16@@ -765,23 +765,8 @@ error:struct tep_event *tracefs_dynevent_get_event (struct tep_handle *tep,struct tracefs_dynevent *dynevent) { -struct tep_event *event; -if (!tep || !dynevent || !dynevent->event)return NULL ; -/* Check if event exists in the system */ -if (!tracefs_event_file_exists (NULL , dynevent->system, dynevent->event,"format" )) -return NULL ; - -/* If the dynamic event is already loaded in the tep, return it */ - event =tep_find_event_by_name (tep, dynevent->system, dynevent->event); -if (event) -return event; - -/* Try to load any new events from the given system */ -if (trace_rescan_events (tep,NULL , dynevent->system)) -return NULL ; - -return tep_find_event_by_name (tep, dynevent->system, dynevent->event); +return get_tep_event (tep, dynevent->system, dynevent->event); }src/tracefs-events.c +21
-0@@ -752,6 +752,27 @@ __hidden int trace_load_events(struct tep_handle *tep,return load_events (tep, tracing_dir, system, false); } +__hidden struct tep_event *get_tep_event(struct tep_handle *tep, +const char *system,const char *name) +{ +struct tep_event *event; + +/* Check if event exists in the system */ +if (!tracefs_event_file_exists (NULL , system, name,"format" )) +return NULL ; + +/* If the dynamic event is already loaded in the tep, return it */ + event =tep_find_event_by_name (tep, system, name); +if (event) +return event; + +/* Try to load any new events from the given system */ +if (trace_rescan_events (tep,NULL , system)) +return NULL ; + +return tep_find_event_by_name (tep, system, name); +} +static int read_header (struct tep_handle *tep,const char *tracing_dir) {struct stat st;src/tracefs-hist.c +18
-1@@ -2197,3 +2197,21 @@ int tracefs_synth_echo_cmd(struct trace_seq *seq, }return ret; } + +/** +* tracefs_synth_get_event - return tep event representing the given synthetic event +* @tep: a handle to the trace event parser context that holds the events +* @synth: a synthetic event context, describing given synthetic event. +* +* Returns a pointer to a tep event describing the given synthetic event. The pointer +* is managed by the @tep handle and must not be freed. In case of an error, or in case +* the requested synthetic event is missing in the @tep handler - NULL is returned. +*/ +struct tep_event * +tracefs_synth_get_event (struct tep_handle *tep,struct tracefs_synth *synth) +{ +if (!tep || !synth || !synth->name) +return NULL ; + +return get_tep_event (tep,SYNTHETIC_GROUP , synth->name); +} --2.32.0
Signature · 2 lines
Tzvetomir (Ceco) Stoyanov VMware Open Source Technology Center
Quoted 8 lines · Tzvetomir Stoyanov
Quoted 1 line
+struct
tep_eventpass:[*]*tracefs_synth_get_event*(structtep_handlepass:[*]_tep_, structtracefs_synthpass:[*]_synth_);The arguments of the other functions in this man page are not underlined, all should follow the same style. As in the other man pages of the library all arguments are underlined, this should be the default style.
This could be addressed in a follow up patch - applying the same style of all tracefs man pages.
So, do I have to change something on this particular line?
Thanks!
Yordan
Quoted 13 lines · Yordan Karadzhov
Quoted 8 lines · Tzvetomir Stoyanov
Quoted 1 line
+struct
tep_eventpass:[*]*tracefs_synth_get_event*(structtep_handlepass:[*]_tep_, structtracefs_synthpass:[*]_synth_);The arguments of the other functions in this man page are not underlined, all should follow the same style. As in the other man pages of the library all arguments are underlined, this should be the default style.
This could be addressed in a follow up patch - applying the same style of all tracefs man pages.
Quoted 1 line
So, do I have to change something on this particular line?
This line is OK, I'll submit a patch to unify the other man pages. The arguments should be underlined.
Quoted 3 lines
Thanks!
Yordan
Signature · 2 lines
Tzvetomir (Ceco) Stoyanov VMware Open Source Technology Center
Quoted 14 lines · Tzvetomir Stoyanov
Quoted 13 lines · Yordan Karadzhov
Quoted 8 lines · Tzvetomir Stoyanov
Quoted 1 line
+struct
tep_eventpass:[*]*tracefs_synth_get_event*(structtep_handlepass:[*]_tep_, structtracefs_synthpass:[*]_synth_);The arguments of the other functions in this man page are not underlined, all should follow the same style. As in the other man pages of the library all arguments are underlined, this should be the default style.
This could be addressed in a follow up patch - applying the same style of all tracefs man pages.
Quoted 5 lines
Quoted 1 line
So, do I have to change something on this particular line?
This line is OK, I'll submit a patch to unify the other man pages. The arguments should be underlined.
OK, I will send v2, fixing the other problems you found in your review. thanks,
Y.
Quoted 6 lines
Quoted 3 lines
Thanks!
Yordan
Quoted 8 lines · On Wed, 12 Jan 2022 18:36:19 +0200 "Yordan Karadzhov (VMware)"…
A new API is proposed, to get tep event descriptor for given synthetic event:
tracefs_synth_get_event()The API implementation gets derived from the implementation of the existing API
tracefs_dynevent_get_event(). It can detect any newly created or removed synthetic events.
Hi Yordan,
Quoted 116 lines
Signed-off-by Yordan Karadzhov (VMware) <[email protected]>--- Documentation/libtracefs-synth2.txt | 14 ++++++++++++-- include/tracefs-local.h | 2 ++ include/tracefs.h | 2 ++ src/tracefs-dynevents.c | 17 +---------------- src/tracefs-events.c | 21 +++++++++++++++++++++ src/tracefs-hist.c | 18 ++++++++++++++++++ 6 files changed, 56 insertions(+), 18 deletions(-)Documentation/libtracefs-synth2.txt +12
-2@@ -6,7 +6,8 @@ NAME tracefs_synth_create, tracefs_synth_destroy, tracefs_synth_echo_cmd, tracefs_synth_complete, tracefs_synth_get_start_hist, tracefs_synth_trace, tracefs_synth_snapshot, tracefs_synth_get_name, tracefs_synth_raw_fmt, tracefs_synth_show_event, -tracefs_synth_show_start_hist, tracefs_synth_show_end_hist - Creation of synthetic events +tracefs_synth_show_start_hist, tracefs_synth_show_end_hist, tracefs_synth_get_event +- Creation of synthetic events SYNOPSIS --------@@ -32,7 +33,8 @@ int tracefs_synth_raw_fmt(struct trace_seq pass:[*]seq, struct tracefs_synth pas const char *tracefs_synth_show_event(struct tracefs_synth pass:[*]synth); const char *tracefs_synth_show_start_hist(struct tracefs_synth pass:[*]synth); const char *tracefs_synth_show_end_hist(struct tracefs_synth pass:[*]synth); - +tracefs_synth_get_event +struct tep_event pass:[*]*tracefs_synth_get_event*(struct tep_handle pass:[*]_tep_, struct tracefs_synth pass:[*]_synth_); -- DESCRIPTION@@ -114,11 +116,19 @@ and is freed with the event by *tracefs_synth_free*(). synthetic event or NULL on error. The returned string belongs to the synth event object and is freed with the event by *tracefs_synth_free*(). +The *tracefs_synth_get_event*() function returns a tep event, describing the given synthetic +event. The API detects any newly created or removed dynamic events. The returned pointer to +tep event is controlled by @tep and must not be freed. + RETURN VALUE ------------ *tracefs_synth_get_name*(), *tracefs_synth_show_event*(), *tracefs_synth_show_start_hist*() and *tracefs_synth_show_end_hist*() return a string owned by the synth event object. +The *tracefs_synth_get_event*() function returns a pointer to a tep event or NULL in case of an +error or if the requested synthetic event is missing. The returned pointer to tep event is +controlled by @tep and must not be freed. + All other functions return zero on success or -1 on error. ERRORSinclude/tracefs-local.h +2
-0@@ -116,5 +116,7 @@ int trace_load_events(struct tep_handle *tep, const char *tracing_dir, const char *system);int trace_rescan_events (struct tep_handle *tep,const char *tracing_dir,const char *system); +__hidden struct tep_event *get_tep_event(struct tep_handle *tep, +const char *system,const char *name);#endif /* _TRACE_FS_LOCAL_H */ include/tracefs.h +2
-0@@ -564,5 +564,7 @@ const char *tracefs_synth_show_end_hist(struct tracefs_synth *synth);struct tracefs_synth *tracefs_sql (struct tep_handle *tep,const char *name,const char *sql_buffer,char **err); +struct tep_event * +tracefs_synth_get_event (struct tep_handle *tep,struct tracefs_synth *synth);#endif /* _TRACE_FS_H */ src/tracefs-dynevents.c +1
-16@@ -765,23 +765,8 @@ error:struct tep_event *tracefs_dynevent_get_event (struct tep_handle *tep,struct tracefs_dynevent *dynevent) { -struct tep_event *event; -if (!tep || !dynevent || !dynevent->event)return NULL ; -/* Check if event exists in the system */ -if (!tracefs_event_file_exists (NULL , dynevent->system, dynevent->event,"format" )) -return NULL ; - -/* If the dynamic event is already loaded in the tep, return it */ - event =tep_find_event_by_name (tep, dynevent->system, dynevent->event); -if (event) -return event; - -/* Try to load any new events from the given system */ -if (trace_rescan_events (tep,NULL , dynevent->system)) -return NULL ; - -return tep_find_event_by_name (tep, dynevent->system, dynevent->event); +return get_tep_event (tep, dynevent->system, dynevent->event); }src/tracefs-events.c +0
-0@@ -752,6 +752,27 @@ __hidden int trace_load_events(struct tep_handle *tep,return load_events (tep, tracing_dir, system, false); }
src/tracefs-events.c __hidden int trace_load_events(struct tep_handle *tep, · line 764
Quoted 10 lines
src/tracefs-events.c +10
-0+__hidden struct tep_event *get_tep_event(struct tep_handle *tep, +const char *system,const char *name) +{ +struct tep_event *event; + +/* Check if event exists in the system */ +if (!tracefs_event_file_exists (NULL , system, name,"format" )) +return NULL ; + +/* If the dynamic event is already loaded in the tep, return it */
As this was moved out of the tracefs_dynevent_get_event() function, we probably should update the comments too ;-)
/* If the event is already loaded in the tep handler, return it */
-- Steve
Quoted 11 lines
src/tracefs-events.c +11
-0+ event =tep_find_event_by_name (tep, system, name); +if (event) +return event; + +/* Try to load any new events from the given system */ +if (trace_rescan_events (tep,NULL , system)) +return NULL ; + +return tep_find_event_by_name (tep, system, name); +} +