Skip to contentSkip to conversation

ftrace: important updates

PATCH Superseded Steven Rostedt 2 participants 10 messages Jan 6, 2009 – Jan 7, 2009

Subsystems (3)

v1 of 2 Superseded Latest is v2 →

lore
Share & tools
lore

Steven Rostedt

author maintainer
#0 lore raw

cover ftrace: important updates

Ingo,

The first patch is a critical fix that needs to get into 2.6.29.

The next patch is a rename of tracing_on to writing_enabled since tracing_on is confusing, and the file enables or disables writes.

The last patch is a fix to tip that prevents a memory leak.

-- Steve

The following patches are in:

git://git.kernel.org/pub/scm/linux/kernel/git/rostedt/linux-2.6-trace.git

branch: tip/devel

Frederic Weisbecker (1):
tracing/ftrace: fix a memory leak in stat tracing

Steven Rostedt (2):
ftrace: convert unsigned index to signed
ring-buffer: rename debugfs file tracing_on to writing_enabled

----

 kernel/trace/ftrace.c      |    4 ++--
 kernel/trace/ring_buffer.c |    5 +++--
 kernel/trace/trace_stat.c  |   39 +++++++++++++++------------------------
 3 files changed, 20 insertions(+), 28 deletions(-)
author maintainer
#1 lore raw

PATCH 1/3 ftrace: convert unsigned index to signed

From: Steven Rostedt <[email protected]>

Impact: fix to unsigned compared to less than zero

Roel Kluin pointed out that there is a compare of an unsigned number to less than zero. A previous clean up had the unsigned index set to -1 for certain cases, but never converted it to signed.

Frederic Weisbecker noticed that another index is used to compare the above index to and it also needs to be converted to signed.

---
 kernel/trace/ftrace.c |    4 ++--
 1 files changed, 2 insertions(+), 2 deletions(-)
kernel/trace/ftrace.c +2 -2
index 2f32969..3576707 100644
@@ -289,7 +289,7 @@ static DEFINE_MUTEX(ftrace_regex_lock);
 
 struct ftrace_page {
 	struct ftrace_page	*next;
-	unsigned long		index;
+	long			index;
 	struct dyn_ftrace	records[];
 };
 
@@ -786,7 +786,7 @@ enum {
 
 struct ftrace_iterator {
 	struct ftrace_page	*pg;
-	unsigned		idx;
+	int			idx;
 	unsigned		flags;
 	unsigned char		buffer[FTRACE_BUFF_MAX+1];
 	unsigned		buffer_idx;
Signature · 3 lines
1.5.6.5

-- 
#2 lore raw

Re: [PATCH 1/3] ftrace: convert unsigned index to signed

Quoted 23 lines · On Tue, 06 Jan 2009 17:33:38 -0500 Steven Rostedt <[email protected]> wrote:

From: Steven Rostedt <[email protected]>

Impact: fix to unsigned compared to less than zero

Roel Kluin pointed out that there is a compare of an unsigned number to less than zero. A previous clean up had the unsigned index set to -1 for certain cases, but never converted it to signed.

Frederic Weisbecker noticed that another index is used to compare the above index to and it also needs to be converted to signed.

---
 kernel/trace/ftrace.c |    4 ++--
 1 files changed, 2 insertions(+), 2 deletions(-)
kernel/trace/ftrace.c +0 -0
index 2f32969..3576707 100644

kernel/trace/ftrace.c static DEFINE_MUTEX(ftrace_regex_lock); · line 292

Quoted 5 lines
kernel/trace/ftrace.c +1 -1
@@ -289,7 +289,7 @@ static DEFINE_MUTEX(ftrace_regex_lock);
 
 struct ftrace_page {
 	struct ftrace_page	*next;
-	unsigned long		index;
+	long			index;

Does that actually need to be a long type?

kernel/trace/ftrace.c enum { · line 789

Quoted 9 lines
kernel/trace/ftrace.c +1 -1
 	struct dyn_ftrace	records[];
 };
 
@@ -786,7 +786,7 @@ enum {
 
 struct ftrace_iterator {
 	struct ftrace_page	*pg;
-	unsigned		idx;
+	int			idx;

because we have

        if (iter->idx >= iter->pg->index) {

Are 32-bit types actually more efficient than 64-bit types on any 64-bit hardware which we care about?

author maintainer
#3 lore raw

Re: [PATCH 1/3] ftrace: convert unsigned index to signed

Quoted 27 lines · Andrew Morton
Quoted 24 lines · On Tue, 06 Jan 2009 17:33:38 -0500 Steven Rostedt <[email protected]> wrote:

From: Steven Rostedt <[email protected]>

Impact: fix to unsigned compared to less than zero

Roel Kluin pointed out that there is a compare of an unsigned number to less than zero. A previous clean up had the unsigned index set to -1 for certain cases, but never converted it to signed.

Frederic Weisbecker noticed that another index is used to compare the above index to and it also needs to be converted to signed.

---
 kernel/trace/ftrace.c |    4 ++--
 1 files changed, 2 insertions(+), 2 deletions(-)
kernel/trace/ftrace.c +0 -0
index 2f32969..3576707 100644
@@ -289,7 +289,7 @@ static DEFINE_MUTEX(ftrace_regex_lock);
 
Quoted 6 lines

kernel/trace/ftrace.c static DEFINE_MUTEX(ftrace_regex_lock); · line 292

Quoted 4 lines
kernel/trace/ftrace.c +1 -1
 struct ftrace_page {
 	struct ftrace_page	*next;
-	unsigned long		index;
+	long			index;

Does that actually need to be a long type?

No, I think I just automatically typed "unsigned long" before, and here I just removed the unsigned. It can also be an int. It only indexes what is on a page.

Quoted 13 lines

kernel/trace/ftrace.c enum { · line 789

Quoted 10 lines
kernel/trace/ftrace.c +1 -1
 	struct dyn_ftrace	records[];
 };
 
@@ -786,7 +786,7 @@ enum {
 
 struct ftrace_iterator {
 	struct ftrace_page	*pg;
-	unsigned		idx;
+	int			idx;

because we have

Quoted 4 lines
        if (iter->idx >= iter->pg->index) {

Are 32-bit types actually more efficient than 64-bit types on any 64-bit hardware which we care about?

They both should always be way less than 2^31, so they both can be int.

Thanks, I'll fix this one up. I don't think Ingo pulled it yet.

-- Steve

author maintainer
#4 lore raw

PATCH 2/3 ring-buffer: rename debugfs file tracing_on to writing_enabled

In reply to Steven Rostedt

From: Steven Rostedt <[email protected]>

Impact: clean up

The debugfs file name tracing_on is confusing since there is also a tracing_enabled. When a tracer is added to current_tracer and tracing_enabled is set to 1, then the tracer will start tracing. The current file tracing_on, if set to 1, will allow writing to the ring buffers. If tracing_on is set to 0 then the ring buffers are read only, and any attempt by the tracers to write to the ring buffers will fail.

But the name tracing_on confuses both developers and users. This patch renames it to 'writing_enabled'. This is exactly what the file does. When set to 1, the ring buffers have writing enabled and when set to 0, the ring buffers can not be written to.

The tracers do not get any call backs called or other notification that the ring buffers have been set to read only, except when they attempt to write to the ring buffers, that write will fail.

Note: it is a requirement that any tracer that uses the ring buffers must handle a failure to write to the ring buffers, since the ring buffers may be disabled for any number of reasons.

---
 kernel/trace/ring_buffer.c |    5 +++--
 1 files changed, 3 insertions(+), 2 deletions(-)
kernel/trace/ring_buffer.c +3 -2
index a9d9760..dba6876 100644
@@ -2514,10 +2514,11 @@ static __init int rb_init_debugfs(void)
 
 	d_tracer = tracing_init_dentry();
 
-	entry = debugfs_create_file("tracing_on", 0644, d_tracer,
+	entry = debugfs_create_file("writing_enabled", 0644, d_tracer,
 				    &ring_buffer_flags, &rb_simple_fops);
 	if (!entry)
-		pr_warning("Could not create debugfs 'tracing_on' entry\n");
+		pr_warning("Could not create debugfs"
+			   " 'writing_enabled' entry\n");
 
 	return 0;
 }
Signature · 3 lines
1.5.6.5

-- 
#5 lore raw

Re: [PATCH 2/3] ring-buffer: rename debugfs file tracing_on to writing_enabled

Quoted 38 lines · On Tue, 06 Jan 2009 17:33:39 -0500 Steven Rostedt <[email protected]> wrote:

From: Steven Rostedt <[email protected]>

Impact: clean up

The debugfs file name tracing_on is confusing since there is also a tracing_enabled. When a tracer is added to current_tracer and tracing_enabled is set to 1, then the tracer will start tracing. The current file tracing_on, if set to 1, will allow writing to the ring buffers. If tracing_on is set to 0 then the ring buffers are read only, and any attempt by the tracers to write to the ring buffers will fail.

But the name tracing_on confuses both developers and users. This patch renames it to 'writing_enabled'. This is exactly what the file does. When set to 1, the ring buffers have writing enabled and when set to 0, the ring buffers can not be written to.

The tracers do not get any call backs called or other notification that the ring buffers have been set to read only, except when they attempt to write to the ring buffers, that write will fail.

Note: it is a requirement that any tracer that uses the ring buffers must handle a failure to write to the ring buffers, since the ring buffers may be disabled for any number of reasons.

---
 kernel/trace/ring_buffer.c |    5 +++--
 1 files changed, 3 insertions(+), 2 deletions(-)
kernel/trace/ring_buffer.c +0 -0
index a9d9760..dba6876 100644
@@ -2514,10 +2514,11 @@ static __init int rb_init_debugfs(void)
 
 	d_tracer = tracing_init_dentry();
 

kernel/trace/ring_buffer.c static __init int rb_init_debugfs(void) · line 2524

Quoted 10 lines
kernel/trace/ring_buffer.c +3 -2
-	entry = debugfs_create_file("tracing_on", 0644, d_tracer,
+	entry = debugfs_create_file("writing_enabled", 0644, d_tracer,
 				    &ring_buffer_flags, &rb_simple_fops);
 	if (!entry)
-		pr_warning("Could not create debugfs 'tracing_on' entry\n");
+		pr_warning("Could not create debugfs"
+			   " 'writing_enabled' entry\n");
 
 	return 0;
 }

There's no corresponding documentation update needed?

author maintainer
#6 lore raw

Re: [PATCH 2/3] ring-buffer: rename debugfs file tracing_on to writing_enabled

Quoted 3 lines · Andrew Morton

On Tue, 06 Jan 2009 17:33:39 -0500

There's no corresponding documentation update needed?

I've fallen a little behind in the documentation. I wanted to see what got pulled in before updating ftrace.txt. But you are correct, I probably should add the documentation updates along with the patches.

But unfortunately, I'm a bit lazy. I like to wait and see what makes it to mainline, and then write a patch to update ftrace.txt to reflect that. It lets me do it in one sitting, instead of doing it for each change.

Honestly, I think I document it better that way. If I document right after writing the code, I do it with too much knowledge of the code, and my writing is confusing for others. If I wait to document, I forget what I did, and have to relearn what I wrote, and then I have a better perspective of what others will want to know.

Thanks,

-- Steve

author maintainer
#7 lore raw

PATCH 3/3 tracing/ftrace: fix a memory leak in stat tracing

In reply to Steven Rostedt

From: Frederic Weisbecker <[email protected]>

Impact: fix memory leak

This patch fixes a memory leak inside reset_stat_list(). The freeing loop iterated only once.

Also turn the stat_list into a simple struct list_head, which simplify the code and avoid an unused static pointer.

---
 kernel/trace/trace_stat.c |   39 +++++++++++++++------------------------
 1 files changed, 15 insertions(+), 24 deletions(-)
kernel/trace/trace_stat.c +15 -24
index 6f194a3..4cb4ff2 100644
@@ -21,7 +21,7 @@ struct trace_stat_list {
 	void *stat;
 };
 
-static struct trace_stat_list stat_list;
+static LIST_HEAD(stat_list);
 
 /*
  * This is a copy of the current tracer to avoid racy
@@ -39,22 +39,12 @@ static DEFINE_MUTEX(stat_list_mutex);
 
 static void reset_stat_list(void)
 {
-	struct trace_stat_list *node;
-	struct list_head *next;
+	struct trace_stat_list *node, *next;
 
-	if (list_empty(&stat_list.list))
-		return;
-
-	node = list_entry(stat_list.list.next, struct trace_stat_list, list);
-	next = node->list.next;
-
-	while (&node->list != next) {
+	list_for_each_entry_safe(node, next, &stat_list, list)
 		kfree(node);
-		node = list_entry(next, struct trace_stat_list, list);
-	}
-	kfree(node);
 
-	INIT_LIST_HEAD(&stat_list.list);
+	INIT_LIST_HEAD(&stat_list);
 }
 
 void init_tracer_stat(struct tracer *trace)
@@ -107,7 +97,7 @@ static int stat_seq_init(void)
 	}
 
 	INIT_LIST_HEAD(&new_entry->list);
-	list_add(&new_entry->list, &stat_list.list);
+	list_add(&new_entry->list, &stat_list);
 	new_entry->stat = current_tracer.stat_start();
 
 	prev_stat = new_entry->stat;
@@ -130,7 +120,7 @@ static int stat_seq_init(void)
 		if (!new_entry->stat)
 			break;
 
-		list_for_each_entry(iter_entry, &stat_list.list, list) {
+		list_for_each_entry(iter_entry, &stat_list, list) {
 			/* Insertion with a descendent sorting */
 			if (current_tracer.stat_cmp(new_entry->stat,
 						iter_entry->stat) > 0) {
@@ -141,7 +131,7 @@ static int stat_seq_init(void)
 
 			/* The current smaller value */
 			} else if (list_is_last(&iter_entry->list,
-						&stat_list.list)) {
+						&stat_list)) {
 				list_add(&new_entry->list, &iter_entry->list);
 				break;
 			}
@@ -162,7 +152,7 @@ exit_free_list:
 
 static void *stat_seq_start(struct seq_file *s, loff_t *pos)
 {
-	struct trace_stat_list *l = (struct trace_stat_list *)s->private;
+	struct list_head *l = (struct list_head *)s->private;
 
 	/* Prevent from tracer switch or stat_list modification */
 	mutex_lock(&stat_list_mutex);
@@ -171,14 +161,14 @@ static void *stat_seq_start(struct seq_file *s, loff_t *pos)
 	if (!*pos && current_tracer.stat_headers)
 		current_tracer.stat_headers(s);
 
-	return seq_list_start(&l->list, *pos);
+	return seq_list_start(l, *pos);
 }
 
 static void *stat_seq_next(struct seq_file *s, void *p, loff_t *pos)
 {
-	struct trace_stat_list *l = (struct trace_stat_list *)s->private;
+	struct list_head *l = (struct list_head *)s->private;
 
-	return seq_list_next(p, &l->list, pos);
+	return seq_list_next(p, l, pos);
 }
 
 static void stat_seq_stop(struct seq_file *m, void *p)
@@ -188,8 +178,10 @@ static void stat_seq_stop(struct seq_file *m, void *p)
 
 static int stat_seq_show(struct seq_file *s, void *v)
 {
-	struct trace_stat_list *l = list_entry(v, struct trace_stat_list, list);
-	return current_tracer.stat_show(s, l->stat);
+	struct trace_stat_list *entry =
+		list_entry(v, struct trace_stat_list, list);
+
+	return current_tracer.stat_show(s, entry->stat);
 }
 
 static const struct seq_operations trace_stat_seq_ops = {
@@ -237,7 +229,6 @@ static int __init tracing_stat_init(void)
 	struct dentry *d_tracing;
 	struct dentry *entry;
 
-	INIT_LIST_HEAD(&stat_list.list);
 	d_tracing = tracing_init_dentry();
 
 	entry = debugfs_create_file("trace_stat", 0444, d_tracing,
Signature · 3 lines
1.5.6.5

-- 
#8 lore raw

Re: [PATCH 3/3] tracing/ftrace: fix a memory leak in stat tracing

kernel/trace/trace_stat.c static void stat_seq_stop(struct seq_file *m, void *p) · line 185

Quoted 9 lines · On Tue, 06 Jan 2009 17:33:40 -0500 Steven Rostedt <[email protected]> wrote:

static int stat_seq_show(struct seq_file *s, void *v) {

kernel/trace/trace_stat.c +4 -2
-	struct trace_stat_list *l = list_entry(v, struct trace_stat_list, list);
-	return current_tracer.stat_show(s, l->stat);
+	struct trace_stat_list *entry =
+		list_entry(v, struct trace_stat_list, list);
+
+	return current_tracer.stat_show(s, entry->stat);
 }

Rather than jumping through weird 80-column hoops, one can just do:

	struct trace_stat_list *entry;

	...

	entry = list_entry(v, struct trace_stat_list, list);
author maintainer
#9 lore raw

Re: [PATCH 3/3] tracing/ftrace: fix a memory leak in stat tracing

Quoted 15 lines · Andrew Morton

kernel/trace/trace_stat.c static void stat_seq_stop(struct seq_file *m, void *p) · line 185

Quoted 9 lines · On Tue, 06 Jan 2009 17:33:40 -0500 Steven Rostedt <[email protected]> wrote:

static int stat_seq_show(struct seq_file *s, void *v) {

kernel/trace/trace_stat.c +4 -2
-	struct trace_stat_list *l = list_entry(v, struct trace_stat_list, list);
-	return current_tracer.stat_show(s, l->stat);
+	struct trace_stat_list *entry =
+		list_entry(v, struct trace_stat_list, list);
+
+	return current_tracer.stat_show(s, entry->stat);
 }

Rather than jumping through weird 80-column hoops, one can just do:

Quoted 5 lines
	struct trace_stat_list *entry;

	...

	entry = list_entry(v, struct trace_stat_list, list);

OK, this is Frederics work. I'll submit a separate clean up patch.

-- Steve