Skip to contentSkip to conversation

libtracefs: New API for getting synthetic event

PATCH Superseded Yordan Karadzhov (VMware) 3 participants 6 messages Jan 12, 2022 – Jan 13, 2022 Documentation

v1 of 3 Superseded Latest is v3 →

lore
Share & tools
lore
#0 lore raw

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
index 8056ab8..fac155b 100644
@@ -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
index daea5da..fc0a2c5 100644
@@ -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
index bd758dc..9c53b84 100644
@@ -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
index d089d02..ddebb6b 100644
@@ -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
index 067f6e0..30e80ce 100644
@@ -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
index 7146fc1..8d99492 100644
@@ -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
#1 lore raw
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.

---
 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
index 8056ab8..fac155b 100644
@@ -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.
 
 ERRORS
include/tracefs-local.h +0 -0
index daea5da..fc0a2c5 100644

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
index bd758dc..9c53b84 100644
@@ -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
index d089d02..ddebb6b 100644
@@ -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
index 067f6e0..30e80ce 100644
@@ -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
index 7146fc1..8d99492 100644
@@ -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
#2 lore raw
Quoted 8 lines · Tzvetomir Stoyanov
Quoted 1 line

+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.

So, do I have to change something on this particular line?

Thanks!
Yordan

#3 lore raw
Quoted 13 lines · Yordan Karadzhov
Quoted 8 lines · Tzvetomir Stoyanov
Quoted 1 line

+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 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
#4 lore raw
Quoted 14 lines · Tzvetomir Stoyanov
Quoted 13 lines · Yordan Karadzhov
Quoted 8 lines · Tzvetomir Stoyanov
Quoted 1 line

+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 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

#5 lore raw
In reply to Yordan Karadzhov (VMware)
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
---
 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
index 8056ab8..fac155b 100644
@@ -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
index daea5da..fc0a2c5 100644
@@ -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
index bd758dc..9c53b84 100644
@@ -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
index d089d02..ddebb6b 100644
@@ -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
index 067f6e0..30e80ce 100644
@@ -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);
+}
+