Skip to contentSkip to conversation

trace-cmd libtraceevent: Tzvetomir's updates from Namhyung's comments

PATCH In review Steven Rostedt 1 participant 10 messages Jul 14, 2020

lore
Share & tools
lore
#0 lore raw

cover trace-cmd libtraceevent: Tzvetomir's updates from Namhyung's comments

This is an updated series of Tzvetomir's patch set:

https://lore.kernel.org/r/[email protected]

The only changes to that are:

- Changed the prefix of the subjects from trace-cmd: to libtraceevent:

- Adds the links to Namhyung's comments.

- Adds Namhyung's Acked-by.

The code is unmodified. This only changes the commit logs.

-- Steve

Tzvetomir Stoyanov (VMware) (8):
libtraceevent: Document tep_load_plugins_hook()
libtraceevent: Handle strdup() error in parse_option_name()
libtraceevent: Fix typo in tep_plugin_add_option() description
libtraceevent: Improve error handling of tep_plugin_add_option() API
libtraceevent: Fixed broken indentation in parse_ip4_print_args()
libtraceevent: Fixed type in PRINT_FMT_STING
libtraceevent: Fixed description of tep_add_plugin_path() API
libtraceevent: Handle possible strdup() error in tep_add_plugin_path() API

----

 lib/traceevent/event-parse-local.h |  2 +-
 lib/traceevent/event-parse.c       | 10 ++++----
 lib/traceevent/event-plugin.c      | 50 ++++++++++++++++++++++++++++----------
 3 files changed, 43 insertions(+), 19 deletions(-)
#1 lore raw

PATCH 1/8 libtraceevent: Document tep_load_plugins_hook()

From: "Tzvetomir Stoyanov (VMware)" <[email protected]>

Add description of tep_load_plugins_hook() traceevent API.

---
 lib/traceevent/event-plugin.c | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)
lib/traceevent/event-plugin.c +16 -0
index 30c1526d3d06..c11636cea380 100644
@@ -544,6 +544,22 @@ load_plugins_dir(struct tep_handle *tep, const char *suffix,
 	closedir(dir);
 }
 
+/**
+ * tep_load_plugins_hook - call a user specified callback to load a plugin
+ * @tep: handler to traceevent context
+ * @suffix: filter only plugin files with given suffix
+ * @load_plugin: user specified callback, called for each plugin file
+ * @data: custom context, passed to @load_plugin
+ *
+ * Searches for traceevent plugin files and calls @load_plugin for each
+ * The order of plugins search is:
+ *  - Directories, specified in @tep->plugins_dir and priority TEP_PLUGIN_FIRST
+ *  - Directory, specified at compile time with PLUGIN_TRACEEVENT_DIR
+ *  - Directory, specified by environment variable TRACEEVENT_PLUGIN_DIR
+ *  - In user's home: ~/.local/lib/traceevent/plugins/
+ *  - Directories, specified in @tep->plugins_dir and priority TEP_PLUGIN_LAST
+ *
+ */
 void tep_load_plugins_hook(struct tep_handle *tep, const char *suffix,
 			   void (*load_plugin)(struct tep_handle *tep,
 					       const char *path,
Signature · 1 line
2.26.2
#2 lore raw

PATCH 2/8 libtraceevent: Handle strdup() error in parse_option_name()

In reply to Steven Rostedt

From: "Tzvetomir Stoyanov (VMware)" <[email protected]>

Modified internal function parse_option_name() to return error and handle that error in function callers in case strdup() fails.

---
 lib/traceevent/event-plugin.c | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)
lib/traceevent/event-plugin.c +5 -3
index c11636cea380..b97d0c7e95bf 100644
@@ -254,7 +254,7 @@ void tep_plugin_remove_options(struct tep_plugin_option *options)
 	}
 }
 
-static void parse_option_name(char **option, char **plugin)
+static int parse_option_name(char **option, char **plugin)
 {
 	char *p;
 
@@ -265,8 +265,9 @@ static void parse_option_name(char **option, char **plugin)
 		*p = '\0';
 		*option = strdup(p + 1);
 		if (!*option)
-			return;
+			return -1;
 	}
+	return 0;
 }
 
 static struct tep_plugin_option *
@@ -325,7 +326,8 @@ int tep_plugin_add_option(const char *name, const char *val)
 	if (!option_str)
 		return -ENOMEM;
 
-	parse_option_name(&option_str, &plugin);
+	if (parse_option_name(&option_str, &plugin) < 0)
+		return -ENOMEM;
 
 	/* If the option exists, update the val */
 	for (op = trace_plugin_options; op; op = op->next) {
Signature · 1 line
2.26.2
#3 lore raw

PATCH 3/8 libtraceevent: Fix typo in tep_plugin_add_option() description

In reply to Steven Rostedt

From: "Tzvetomir Stoyanov (VMware)" <[email protected]>

A type "optiona" -> "optional" is fixed in description of tep_plugin_add_option() API.

---
 lib/traceevent/event-plugin.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
lib/traceevent/event-plugin.c +1 -1
index b97d0c7e95bf..03f26c8c58d5 100644
@@ -310,7 +310,7 @@ static int process_option(const char *plugin, const char *option, const char *va
 /**
  * tep_plugin_add_option - add an option/val pair to set plugin options
  * @name: The name of the option (format: <plugin>:<option> or just <option>)
- * @val: (optiona) the value for the option
+ * @val: (optional) the value for the option
  *
  * Modify a plugin option. If @val is given than the value of the option
  * is set (note, some options just take a boolean, so @val must be either
Signature · 1 line
2.26.2
#4 lore raw

PATCH 4/8 libtraceevent: Improve error handling of tep_plugin_add_option() API

In reply to Steven Rostedt

From: "Tzvetomir Stoyanov (VMware)" <[email protected]>

In case of memory error, ensure all allocated resources are freed. Do not append broken option in trace_plugin_options list.

---
 lib/traceevent/event-plugin.c | 16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)
lib/traceevent/event-plugin.c +9 -7
index 03f26c8c58d5..aa868133cbdf 100644
@@ -361,23 +361,25 @@ int tep_plugin_add_option(const char *name, const char *val)
 	if (!op) {
 		op = malloc(sizeof(*op));
 		if (!op)
-			return -ENOMEM;
+			goto out_free;
 		memset(op, 0, sizeof(*op));
-		op->next = trace_plugin_options;
-		trace_plugin_options = op;
-
 		op->plugin = plugin;
 		op->option = option_str;
-
 		if (val) {
 			op->value = strdup(val);
-			if (!op->value)
+			if (!op->value) {
+				free(op);
 				goto out_free;
+			}
 		}
+		op->next = trace_plugin_options;
+		trace_plugin_options = op;
 	}
 
 	return process_option(plugin, option_str, val);
- out_free:
+
+out_free:
+	free(plugin);
 	free(option_str);
 	return -ENOMEM;
 }
Signature · 1 line
2.26.2
#5 lore raw

PATCH 5/8 libtraceevent: Fixed broken indentation in parse_ip4_print_args()

In reply to Steven Rostedt

From: "Tzvetomir Stoyanov (VMware)" <[email protected]>

Fixed the "break" indentation in a switch() inside parse_ip4_print_args() static function.

---
 lib/traceevent/event-parse.c | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
lib/traceevent/event-parse.c +2 -2
index 77c3249220d3..4de9729ccc05 100644
@@ -4680,11 +4680,11 @@ static int parse_ip4_print_args(struct tep_handle *tep,
 		else
 			*reverse = true;
 		ret++;
-	break;
+		break;
 	case 'l':
 		*reverse = true;
 		ret++;
-	break;
+		break;
 	case 'n':
 	case 'b':
 		ret++;
Signature · 1 line
2.26.2
#6 lore raw

PATCH 6/8 libtraceevent: Fixed type in PRINT_FMT_STING

In reply to Steven Rostedt

From: "Tzvetomir Stoyanov (VMware)" <[email protected]>

PRINT_FMT_STING -> PRINT_FMT_STRING

---
 lib/traceevent/event-parse-local.h | 2 +-
 lib/traceevent/event-parse.c       | 6 +++---
 2 files changed, 4 insertions(+), 4 deletions(-)
lib/traceevent/event-parse-local.h +1 -1
index e71296a62236..d805a920af6f 100644
@@ -86,7 +86,7 @@ struct tep_handle {
 };
 
 enum tep_print_parse_type {
-	PRINT_FMT_STING,
+	PRINT_FMT_STRING,
 	PRINT_FMT_ARG_DIGIT,
 	PRINT_FMT_ARG_POINTER,
 	PRINT_FMT_ARG_STRING,
lib/traceevent/event-parse.c +3 -3
index 4de9729ccc05..186fee3364e3 100644
@@ -5659,7 +5659,7 @@ static int parse_arg_format(struct tep_print_parse **parse,
 		default:
 			snprintf(print_format, 32, ">%c<", *format);
 			parse_arg_add(parse, print_format,
-					PRINT_FMT_STING, NULL, NULL, 0);
+					PRINT_FMT_STRING, NULL, NULL, 0);
 			ret++;
 			return ret;
 		}
@@ -5711,7 +5711,7 @@ static int parse_arg_string(struct tep_print_parse **parse, const char *format)
 		ret++;
 	}
 	trace_seq_terminate(&s);
-	parse_arg_add(parse, s.buffer, PRINT_FMT_STING, NULL, NULL, 0);
+	parse_arg_add(parse, s.buffer, PRINT_FMT_STRING, NULL, NULL, 0);
 	trace_seq_destroy(&s);
 
 	return ret;
@@ -5769,7 +5769,7 @@ static void print_event_cache(struct tep_print_parse *parse, struct trace_seq *s
 					 parse->len_as_arg ? len_arg : -1,
 					 data, size, event, parse->arg);
 			break;
-		case PRINT_FMT_STING:
+		case PRINT_FMT_STRING:
 		default:
 			trace_seq_printf(s, "%s", parse->format);
 			break;
Signature · 1 line
2.26.2
#7 lore raw

PATCH 7/8 libtraceevent: Fixed description of tep_add_plugin_path() API

In reply to Steven Rostedt

From: "Tzvetomir Stoyanov (VMware)" <[email protected]>

Changed the description of tep_add_plugin_path() API to reflect the logic of the function. The suffix of plugin files is not hardcoded to ".so", it depends on the custom plugin loader callback.

---
 lib/traceevent/event-plugin.c | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
lib/traceevent/event-plugin.c +2 -2
index aa868133cbdf..841e41c68ad0 100644
@@ -647,8 +647,8 @@ tep_load_plugins(struct tep_handle *tep)
 /**
  * tep_add_plugin_path - Add a new plugin directory.
  * @tep: Trace event handler.
- * @path: Path to a directory. All files with extension .so in that
- *	  directory will be loaded as plugins.
+ * @path: Path to a directory. All plugin files in that
+ *	  directory will be loaded.
  *@prio: Load priority of the plugins in that directory.
  *
  * Returns -1 in case of an error, 0 otherwise.
Signature · 1 line
2.26.2
#8 lore raw

PATCH 8/8 libtraceevent: Handle possible strdup() error in tep_add_plugin_path() API

In reply to Steven Rostedt

From: "Tzvetomir Stoyanov (VMware)" <[email protected]>

Free allocated resources and return -1 in case strdup() fails in tep_add_plugin_path() API.

---
 lib/traceevent/event-plugin.c | 4 ++++
 1 file changed, 4 insertions(+)
lib/traceevent/event-plugin.c +4 -0
index 841e41c68ad0..4a3f7d3f7969 100644
@@ -666,6 +666,10 @@ int tep_add_plugin_path(struct tep_handle *tep, char *path,
 		return -1;
 
 	dir->path = strdup(path);
+	if (!dir->path) {
+		free(dir);
+		return -1;
+	}
 	dir->prio = prio;
 	dir->next = tep->plugins_dir;
 	tep->plugins_dir = dir;
Signature · 1 line
2.26.2
#9 lore raw
In reply to Steven Rostedt
Quoted 6 lines · On Tue, 14 Jul 2020 17:19:29 -0400 Steven Rostedt <[email protected]> wrote:

This is an updated series of Tzvetomir's patch set:

https://lore.kernel.org/r/[email protected]

The only changes to that are:

Quoted 8 lines

- Changed the prefix of the subjects from trace-cmd: to libtraceevent:

- Adds the links to Namhyung's comments.

- Adds Namhyung's Acked-by.

The code is unmodified. This only changes the commit logs.

Tzvetomir,

I haven't pushed this to the public repo yet. Let me know if you are OK with these modifications, and then I'll send them up.

Again, they are only commit log changes. Your code updates have not been touched.

Thanks!

-- Steve

Quoted 18 lines

Tzvetomir Stoyanov (VMware) (8):
libtraceevent: Document tep_load_plugins_hook()
libtraceevent: Handle strdup() error in parse_option_name()
libtraceevent: Fix typo in tep_plugin_add_option() description
libtraceevent: Improve error handling of tep_plugin_add_option() API
libtraceevent: Fixed broken indentation in parse_ip4_print_args()
libtraceevent: Fixed type in PRINT_FMT_STING
libtraceevent: Fixed description of tep_add_plugin_path() API
libtraceevent: Handle possible strdup() error in tep_add_plugin_path() API

----

 lib/traceevent/event-parse-local.h |  2 +-
 lib/traceevent/event-parse.c       | 10 ++++----
 lib/traceevent/event-plugin.c      | 50 ++++++++++++++++++++++++++++----------
 3 files changed, 43 insertions(+), 19 deletions(-)