perf: core, export pmus via sysfs
Subsystems (4)
RFC PATCH v2 6/11 perf: core, export pmus via sysfs
Now only exports cpu hardware events.
For each PMU, there are 2 sysfs dirs: event_source and events.
For example,/sys/devices/system/cpu/event_source//sys/devices/system/cpu/events/
$ tree /sys/devices/system/cpu/event_source/ /sys/devices/system/cpu/event_source/ `-- id
$ tree /sys/devices/system/cpu/events/
/sys/devices/system/cpu/events/
|-- L1-dcache-load-misses
| |-- event_source -> ../../event_source
| `-- id
|-- LLC-load-misses
| |-- event_source -> ../../event_source
| `-- id
|-- branch-misses
| |-- event_source -> ../../event_source
| `-- id
|-- branches
| |-- event_source -> ../../event_source
| `-- id
|-- bus-cycles
| |-- event_source -> ../../event_source
| `-- id
|-- cache-misses
| |-- event_source -> ../../event_source
| `-- id
|-- cache-references
| |-- event_source -> ../../event_source
| `-- id
|-- cycles
| |-- event_source -> ../../event_source
| `-- id
|-- dTLB-load-misses
| |-- event_source -> ../../event_source
| `-- id
|-- dTLB-store-misses
| |-- event_source -> ../../event_source
| `-- id
|-- iTLB-load-misses
| |-- event_source -> ../../event_source
| `-- id
|-- iTLB-load-refs
| |-- event_source -> ../../event_source
| `-- id
`-- instructions
|-- event_source -> ../../event_source
`-- id--- drivers/base/node.c | 3 +- include/linux/node.h | 2 + include/linux/perf_event.h | 10 +++ kernel/perf_event.c | 169 ++++++++++++++++++++++++++++++++++++++++++++ 4 files changed, 183 insertions(+), 1 deletions(-)
drivers/base/node.c +2 -1
@@ -19,10 +19,11 @@static struct sysdev_class_attribute *node_state_attrs[]; -static struct sysdev_class node_class = { +struct sysdev_class node_class = { .name ="node" , .attrs = node_state_attrs, }; +EXPORT_SYMBOL (node_class);static ssize_t node_read_cpumap (struct sys_device *dev,int type,char *buf)
include/linux/node.h +2 -0
@@ -50,6 +50,8 @@ extern int unregister_mem_sect_under_nodes(struct memory_block *mem_blk);extern void register_hugetlbfs_with_node (node_registration_func_t doregister,node_registration_func_t unregister);#endif + +extern struct sysdev_class node_class;#else static inline int register_one_node (int nid) {
include/linux/perf_event.h +10 -0
@@ -552,12 +552,18 @@ struct perf_event;#define PMU_TYPE_CPU 0#define PMU_TYPE_NODE 1 +struct perf_event_kobject { +struct kobject kobj; +u64 id; +}; +/** * struct pmu - generic performance monitoring unit */ struct pmu {int id;struct list_head entry; +struct kobject kobj;int (*enable) (struct perf_event *event);void (*disable) (struct perf_event *event);
@@ -577,6 +583,7 @@ struct pmu {int (*commit_txn) (struct pmu *pmu);int (*init_event) (struct perf_event *event); +int (*register_events) (struct pmu *pmu,struct kobject *events_kobj); };/**
@@ -1022,6 +1029,9 @@ extern void perf_event_disable(struct perf_event *event);extern int perf_event_register_pmu (struct pmu *pmu);extern void perf_event_unregister_pmu (int id); +char *perf_hw_event_name (int id); +char *perf_hw_cache_event_name (u8 type,u8 op,u8 result); +extern struct kobj_type event_ktype;#else static inline void perf_event_task_sched_in (struct task_struct *task) { }
kernel/perf_event.c +169 -0
181 lines not on this page · raw message
Quoted 8 lines · Lin Ming
Now only exports cpu hardware events.
For each PMU, there are 2 sysfs dirs:
event_sourceand events.For example,
/sys/devices/system/cpu/event_source//sys/devices/system/cpu/events/
Quoted 8 lines
$ tree /sys/devices/system/cpu/event_source/ /sys/devices/system/cpu/event_source/ `-- id$ tree /sys/devices/system/cpu/events/ /sys/devices/system/cpu/events/ |-- L1-dcache-load-misses | |-- event_source -> ../../event_source
What is this symlink for? Is it needed as they all seem to point to the same thing.
Also, as you are trying to add new sysfs interfaces, please document them in Documentation/ABI.
And, do you have to use "raw" kobjects here? Any chance you can use a struct device instead?
I'm still not really understanding what exactly you are trying to show in the sysfs tree here anyway, perhaps the documentation update will clear that up for me.
thanks,
greg k-h
kernel/perf_event.c static int __init perf_event_sysfs_init(void) · line 5839
Quoted 3 lines · Lin Ming
kernel/perf_event.c +3
-0+struct kobj_type event_ktype = { + .sysfs_ops = &event_sysfs_ops, +};
No release function? Hm, are you setting yourself up to be publically made fun of? You have read the kobject documentation about this, right? Have you looked at the kernel logs for when you try to free this object?
thanks,
greg k-h
Quoted 13 lines · Greg KH
Quoted 12 lines · Lin Ming
Now only exports cpu hardware events.
For each PMU, there are 2 sysfs dirs:
event_sourceand events.For example,
/sys/devices/system/cpu/event_source//sys/devices/system/cpu/events/$ tree /sys/devices/system/cpu/event_source/ /sys/devices/system/cpu/event_source/ `-- id
Quoted 7 lines
Quoted 4 lines
$ tree /sys/devices/system/cpu/events/ /sys/devices/system/cpu/events/ |-- L1-dcache-load-misses | |-- event_source -> ../../event_sourceWhat is this symlink for? Is it needed as they all seem to point to the same thing.
The symlink is used to find the "event_source" of the "event".
/sys/devices/system/cpu/event_source/
/sys/devices/system/cpu/events/
|-- L1-dcache-load-misses
| |-- event_source -> ../../event_source
For above example, "event_source" is the cpu pmu and the "event" is L1-dcache-load-misses.
Yes, they point to the same thing, because all the events under /sys/devices/system/cpu/events/* is monitored by the same event source, ie, the cpu pmu(/sys/devices/system/cpu/event_source/).
Quoted 3 lines
Also, as you are trying to add new sysfs interfaces, please document them in
Documentation/ABI.
Will add the document.
Quoted 3 lines
And, do you have to use "raw" kobjects here? Any chance you can use a struct device instead?
Let me think about this.
Quoted 4 lines
I'm still not really understanding what exactly you are trying to show in the sysfs tree here anyway, perhaps the documentation update will clear that up for me.
To support multiple pmus(or call them event source), I want to show all the pmus and events in the sysfs tree.
For cpu pmu,/sys/devices/system/cpu/event_source/*/sys/devices/system/cpu/events/*
For node pmu,/sys/devices/system/node/event_source/*/sys/devices/system/node/events/*
For mce,/sys/kernel/events/mce/*
and so on...the exact placement is not yet final.
Thanks,
Lin Ming
Quoted 4 lines
thanks,
greg k-h
Quoted 8 lines · Greg KH
kernel/perf_event.c static int __init perf_event_sysfs_init(void) · line 5839
Quoted 3 lines · Lin Ming
kernel/perf_event.c +3
-0+struct kobj_type event_ktype = { + .sysfs_ops = &event_sysfs_ops, +};No release function? Hm, are you setting yourself up to be publically made fun of? You have read the kobject documentation about this, right? Have you looked at the kernel logs for when you try to free this object?
Ah, will fix this "fun".
Quoted 4 lines
thanks,
greg k-h
Quoted 30 lines · Lin Ming
Quoted 13 lines · Greg KH
Quoted 12 lines · Lin Ming
Now only exports cpu hardware events.
For each PMU, there are 2 sysfs dirs:
event_sourceand events.For example,
/sys/devices/system/cpu/event_source//sys/devices/system/cpu/events/$ tree /sys/devices/system/cpu/event_source/ /sys/devices/system/cpu/event_source/ `-- idQuoted 7 lines
Quoted 4 lines
$ tree /sys/devices/system/cpu/events/ /sys/devices/system/cpu/events/ |-- L1-dcache-load-misses | |-- event_source -> ../../event_sourceWhat is this symlink for? Is it needed as they all seem to point to the same thing.
The symlink is used to find the "
event_source" of the "event".
/sys/devices/system/cpu/event_source/
/sys/devices/system/cpu/events/
|-- L1-dcache-load-misses
| |--event_source-> ../../event_source
Quoted 6 lines
For above example, "
event_source" is the cpu pmu and the "event" is L1-dcache-load-misses.Yes, they point to the same thing, because all the events under
/sys/devices/system/cpu/events/*is monitored by the same event source, ie, the cpupmu(/sys/devices/system/cpu/event_source/).
Then, why have a symlink if they are all going to be the same?
Quoted 5 lines
Quoted 3 lines
I'm still not really understanding what exactly you are trying to show in the sysfs tree here anyway, perhaps the documentation update will clear that up for me.
To support multiple pmus
What is a "pmu"?
Quoted 1 line
(or call them event source),
What is an "event source"?
Quoted 2 lines
I want to show all
the pmus and events in the sysfs tree.
Why do these things need to be in sysfs? What benifit is it going to have?
Quoted 3 lines
For cpu pmu,
/sys/devices/system/cpu/event_source/*/sys/devices/system/cpu/events/*
What is a "cpu pmu"?
Quoted 3 lines
For node pmu,
/sys/devices/system/node/event_source/*/sys/devices/system/node/events/*
What is a "node pmu"?
Quoted 2 lines
For mce,
/sys/kernel/events/mce/*
What? No, don't create /sys/kernel/events/. Is that in this patchset? Ick, that's such a "general" name that it is going to get confusing very quickly. Heck, I still don't know what this "event" thing is yet :)
Quoted 1 line
and so on...the exact placement is not yet final.
Again, why do you need/want anything in sysfs in the first place? What problem is it going to solve? Who is going to benifit? Why do they care? What is this whole thing about?
thanks,
greg k-h
Quoted 31 lines · Greg KH
Quoted 30 lines · Lin Ming
Quoted 13 lines · Greg KH
Quoted 12 lines · Lin Ming
Now only exports cpu hardware events.
For each PMU, there are 2 sysfs dirs:
event_sourceand events.For example,
/sys/devices/system/cpu/event_source//sys/devices/system/cpu/events/$ tree /sys/devices/system/cpu/event_source/ /sys/devices/system/cpu/event_source/ `-- idQuoted 7 lines
Quoted 4 lines
$ tree /sys/devices/system/cpu/events/ /sys/devices/system/cpu/events/ |-- L1-dcache-load-misses | |-- event_source -> ../../event_sourceWhat is this symlink for? Is it needed as they all seem to point to the same thing.
The symlink is used to find the "
event_source" of the "event".
/sys/devices/system/cpu/event_source/
/sys/devices/system/cpu/events/
|-- L1-dcache-load-misses
| |--event_source-> ../../event_source
Quoted 8 lines
Quoted 6 lines
For above example, "
event_source" is the cpu pmu and the "event" is L1-dcache-load-misses.Yes, they point to the same thing, because all the events under
/sys/devices/system/cpu/events/*is monitored by the same event source, ie, the cpupmu(/sys/devices/system/cpu/event_source/).Then, why have a symlink if they are all going to be the same?
So how about move the symlink to parent directory, like
/sys/devices/system/cpu/event_source/
/sys/devices/system/cpu/events/
|-- event_source -> ../event_source
Quoted 8 lines
Quoted 6 lines
Quoted 4 lines
I'm still not really understanding what exactly you are trying to show in the sysfs tree here anyway, perhaps the documentation update will clear that up for me.
To support multiple pmus
What is a "pmu"?
Performance Monitoring Unit
Quoted 4 lines
Quoted 2 lines
(or call them event source),
What is an "event source"?
The source who generates the event.
The event includes hardware events, cache-misses, bus-cycles, interrupts, error conditions, hotplug......
and software events, context-switches, page-faults, sched events......
Quoted 6 lines
Quoted 3 lines
I want to show all
the pmus and events in the sysfs tree.Why do these things need to be in sysfs? What benifit is it going to have?
Kernel to provide the information of the event source and hardware/software events via sysfs and user-space can get this info from sysfs.
Quoted 6 lines
Quoted 4 lines
For cpu pmu,
/sys/devices/system/cpu/event_source/*/sys/devices/system/cpu/events/*What is a "cpu pmu"?
The performance monitoring unit in cpu.
Quoted 6 lines
Quoted 4 lines
For node pmu,
/sys/devices/system/node/event_source/*/sys/devices/system/node/events/*What is a "node pmu"?
The pmu shared by logical cpus in a package, for example, Nehalem uncore pmu, PowerPc nest units.
Quoted 5 lines
Quoted 3 lines
For mce,
/sys/kernel/events/mce/*What? No, don't create
/sys/kernel/events/. Is that in this patchset?
No, not in this patchset.
Quoted 12 lines
Ick, that's such a "general" name that it is going to get confusing very quickly. Heck, I still don't know what this "event" thing is yet :)
Quoted 1 line
and so on...the exact placement is not yet final.
Again, why do you need/want anything in sysfs in the first place? What problem is it going to solve? Who is going to benifit? Why do they care? What is this whole thing about?
thanks,
greg k-h
Quoted 13 lines · Lin Ming
Quoted 12 lines · Greg KH
Quoted 10 lines · Lin Ming
/sys/devices/system/cpu/events/
|-- L1-dcache-load-misses
| |--event_source-> ../../event_sourceFor above example, "
event_source" is the cpu pmu and the "event" is L1-dcache-load-misses.Yes, they point to the same thing, because all the events under
/sys/devices/system/cpu/events/*is monitored by the same event source, ie, the cpupmu(/sys/devices/system/cpu/event_source/).
Quoted 8 lines
Quoted 1 line
Then, why have a symlink if they are all going to be the same?
So how about move the symlink to parent directory, like
/sys/devices/system/cpu/event_source/
/sys/devices/system/cpu/events/
|--event_source-> ../event_source
Again, why would that make any sense? You would be creating a symlink to something that is always the same symlink. Why would that even be needed?
Quoted 9 lines
Quoted 7 lines
Quoted 5 lines
Quoted 3 lines
I'm still not really understanding what exactly you are trying to show in the sysfs tree here anyway, perhaps the documentation update will clear that up for me.
To support multiple pmus
What is a "pmu"?
Performance Monitoring Unit
What is a "unit"?
Quoted 5 lines
Quoted 3 lines
Quoted 1 line
(or call them event source),
What is an "event source"?
The source who generates the event.
The traditional way to define a word, or phrase, is to not use the word or phrase in the definition, otherwise that definition makes no sense.
Quoted 3 lines
The event includes hardware events, cache-misses, bus-cycles, interrupts, error conditions, hotplug......
and software events, context-switches, page-faults, sched events......
So, stuff that happens to a CPU that are usually handled in the performance counters portion of the CPU, right?
Why put this in sysfs? Why do you think that mapping this information there makes sense?
Quoted 9 lines
Quoted 5 lines
Quoted 2 lines
I want to show all
the pmus and events in the sysfs tree.Why do these things need to be in sysfs? What benifit is it going to have?
Kernel to provide the information of the event source and hardware/software events via sysfs and user-space can get this info from sysfs.
But that's not what you were doing with your "open a sysfs file from within the kernel and use the kobject there" logic, right? You were doing everything within the kernel itself, so sysfs, and kobjects and the like, aren't really needed at all, right?
How are you exporting this information to userspace today?
Quoted 6 lines
Quoted 4 lines
Quoted 2 lines
For mce,
/sys/kernel/events/mce/*What? No, don't create
/sys/kernel/events/. Is that in this patchset?No, not in this patchset.
Good :)
Quoted 8 lines
Quoted 8 lines
Ick, that's such a "general" name that it is going to get confusing very quickly. Heck, I still don't know what this "event" thing is yet :)
Quoted 1 line
and so on...the exact placement is not yet final.
Again, why do you need/want anything in sysfs in the first place? What problem is it going to solve? Who is going to benifit? Why do they care? What is this whole thing about?
You forgot to answer these questions...
thanks,
greg k-h
Quoted 18 lines · Greg KH
Quoted 17 lines · Lin Ming
Quoted 5 lines · Greg KH
Quoted 4 lines · Lin Ming
/sys/devices/system/cpu/events/
|-- L1-dcache-load-misses
| |--event_source-> ../../event_sourceQuoted 8 lines
Quoted 6 lines
For above example, "
event_source" is the cpu pmu and the "event" is L1-dcache-load-misses.Yes, they point to the same thing, because all the events under
/sys/devices/system/cpu/events/*is monitored by the same event source, ie, the cpupmu(/sys/devices/system/cpu/event_source/).Then, why have a symlink if they are all going to be the same?
So how about move the symlink to parent directory, like
Quoted 8 lines
Quoted 4 lines
/sys/devices/system/cpu/event_source/
/sys/devices/system/cpu/events/
|--event_source-> ../event_sourceAgain, why would that make any sense? You would be creating a symlink to something that is always the same symlink. Why would that even be needed?
Do you mean the target of the symlink is also a symlink? No.
/sys/devices/system/cpu/events/event_source points to /sys/devices/system/cpu/event_source.
/sys/devices/system/cpu/event_source/ is a sysfs dir, not a symlink.
Quoted 13 lines
Quoted 10 lines
Quoted 8 lines
Quoted 6 lines
Quoted 4 lines
I'm still not really understanding what exactly you are trying to show in the sysfs tree here anyway, perhaps the documentation update will clear that up for me.
To support multiple pmus
What is a "pmu"?
Performance Monitoring Unit
What is a "unit"?
Quoted 8 lines
Quoted 5 lines
Quoted 3 lines
Quoted 1 line
(or call them event source),
What is an "event source"?
The source who generates the event.
The traditional way to define a word, or phrase, is to not use the word or phrase in the definition, otherwise that definition makes no sense.
Ingo's explanation looks much more clear.
<---snip start--->
We _really_ dont want to call it a 'PMU' but 'events coming from an event source'.
The reason is that a PMU is an existing term that is quite attached to a CPU - while many hardware events come not from a PMU. Interrupts, error conditions, hotplug events, etc. etc.
Furthermore, the name 'PMU' is even less correct for software events.
So lets stick with 'events' and with some container that originates them. (event_source) Ok?
<---snip end--->
Quoted 7 lines
Quoted 4 lines
The event includes hardware events, cache-misses, bus-cycles, interrupts, error conditions, hotplug......
and software events, context-switches, page-faults, sched events......So, stuff that happens to a CPU that are usually handled in the performance counters portion of the CPU, right?
For cpu hardware events(cycles, branch-misses, L1-dcache-loads etc...), yes.
Quoted 3 lines
Why put this in sysfs? Why do you think that mapping this information there makes sense?
sysfs, "It provides a means to export kernel data structures, their attributes, and the linkages between them to userspace."
pmus and events have attributes that userspace tool want to know, for example, pmu id, event config value.
And they also have linkage, for example, cycles event uses cpu pmu to handle it, so
/sys/devices/system/cpu/events/cycles/event_source ---> /sys/devices/system/cpu/event_source
Quoted 7 lines
Quoted 7 lines
Quoted 6 lines
Quoted 3 lines
I want to show all
the pmus and events in the sysfs tree.Why do these things need to be in sysfs? What benifit is it going to have?
Quoted 8 lines
Quoted 3 lines
Kernel to provide the information of the event source and hardware/software events via sysfs and user-space can get this info from sysfs.
But that's not what you were doing with your "open a sysfs file from within the kernel and use the kobject there" logic, right? You were doing everything within the kernel itself, so sysfs, and kobjects and the like, aren't really needed at all, right?
No.
In userspace, open a sysfs file, see patch 11.
Then pass the open file's fd to the syscall sys_perf_event_open.
In kernel, use the passed in fd to find the pmu.
Quoted 2 lines
How are you exporting this information to userspace today?
Not export it today.
Quoted 13 lines
Quoted 7 lines
Quoted 5 lines
Quoted 3 lines
For mce,
/sys/kernel/events/mce/*What? No, don't create
/sys/kernel/events/. Is that in this patchset?No, not in this patchset.
Good :)
Quoted 3 lines
Quoted 3 lines
Ick, that's such a "general" name that it is going to get confusing very quickly. Heck, I still don't know what this "event" thing is yet :)
Quoted 7 lines
Quoted 5 lines
Quoted 5 lines
Quoted 1 line
and so on...the exact placement is not yet final.
Again, why do you need/want anything in sysfs in the first place? What problem is it going to solve? Who is going to benifit? Why do they care? What is this whole thing about?
You forgot to answer these questions...
Want to solve the problem of how to address an "event source". I thought it's clear to export via sysfs, but, I maybe totally wrong...
Thanks,
Lin Ming
Quoted 4 lines
thanks,
greg k-h
From: Lin Ming <[email protected]>
Date: Wed, May 19, 2010 at 10:34:55AM +0800
Hi,
[..]
Quoted 3 lines
For mce,
/sys/kernel/events/mce/*
have we considered the per-cpu granularity of MCEs here and if yes, how to represent that?
Something like
/sys/kernel/events/mce/cpus/cpuX/..
or similar maybe. One use case I can think of right now is being able to inject an MCE on a certain cpu...
Thanks.
Signature · 5 lines
Regards/Gruss, Boris. Operating Systems Research Center Advanced Micro Devices, Inc.
Peter Zijlstra
maintainerQuoted 3 lines · Greg KH
Again, why do you need/want anything in sysfs in the first place? What problem is it going to solve? Who is going to benifit? Why do they care? What is this whole thing about?
OK, so all of this is about perf_event. The story starts with CPUs adding a PMU (Performance Monitor Unit) which allows the user to count/sample cpu state.
The whole perf_counter subsystem was created to abstract this piece of hardware and provide an kernel interface to it.
Then we realized that a generalization of the PMU exists in pretty much everything that generates 'events' of interest and so we started adding software PMUs that allowed us to do the same for tracepoints etc.
So we ended up with perf_events. A subsystem dedicated to counting events and event based sampling.
Now the problem this patch set tries to solve; more hardware than the CPU has such capabilities. There are memory controllers, bus controllers and devices with similar capabilities.
So we need a way to identify and locate these things, and since sysfs has the full machine topology in it, the idea was to represent these things in sysfs as an event_source class.
Since the CPU and memory controllers are (assumed) symmetric on the system, we get to add things like:
/sys/devices/system/cpu/cpu_event_source/
/sys/devices/system/node/node_event_source/
Devices like GPUs can do:
/sys/devices/pci0000:00/0000:00:01.0/0000:01:00.0/radeon_event_source/
Hooking them into sysfs at the proper device/machine topology location allows us to quickly locate and identify these 'event_sources'.
Since all hardware wants to keep life interesting they all work differently and programming PMUs is no different, they count different things, have different ways to program them etc. But for each class there is a useful subset of things that is pretty uniform.
CPU based PMUs all can count things like clock-cycles and instructions, Memory controllers can count things like local/remote memory accesses etc.
So each class has a number of actual events that are worthy of abstracting. The idea was to place these events in the event_source, like:
/sys/devices/system/cpu/cpu_event_source/cycles/ /sys/devices/system/cpu/cpu_event_source/instructions/
And then there are the software event_sources that expose kernel events (through tracepoints), currently tracepoints live
in /debug/tracing/events/ (or /sys/kernel/debug/tracing/events/ for those so inclined). But the above abstraction would suggest we expose them similarly.
I'm not sure where we'd want them to live, we could add them to:
/sys/kernel/tracepoint_event_source/
and have them live there, but I'm open to alternatives :-)
[ With event_source's being a sysfs-class, we also get a nice flat
collection in /sys/class/event_source/ helping those who get lost in the device topology, me :-) ]
The next issue seems to be the interface between this sysfs representation and the perf_event syscall, how do we go about creating an actual perf_event object from this rich sysfs event_source class object.
The sys_perf_event_open() call takes a struct perf_event_attr pointer which describes the event and its properties. The current event classification goes through:
struct perf_event_attr {
__u32 type;
__u64 config;
...
};So my initial idea was to let each event_source have a type_id and let each of its events have a config field and read those and insert them in your structure.
So we'd get:
/sys/devices/system/cpu/cpu_event_source/type_id /sys/devices/system/cpu/cpu_event_source/instructions/config
cat those to get: .type = 0, .config = 1
(PERF_TYPE_HARDWARE:PERF_COUNT_HW_INSTRUCTIONS).
Then Ingo objected and said, if we need to open and read those file, you might as well just open one file and pass the fd along, saves some syscalls.
So you'd end up doing:
fd = open("/sys/devices/system/cpu/cpu_event_source/instructions/config"); attr->type = fd | PERF_TYPE_FD;
event_fd = perf_event_open(attr, ... );
close(fd);
Quoted 1 line
From that one fd we can find to which '
event_source' it belongs and what
particular config we need to use.
Plenty of opinions to be had on that I guess.
Anyway, this was the what, why and how of it.
Peter Zijlstra
maintainerQuoted 3 lines · Borislav Petkov
have we considered the per-cpu granularity of MCEs here and if yes, how to represent that?
Uhm, by opening the MCE event on a particular cpu? Remember that sys_perf_event_open() has a cpu target.
The thing is, CPUs are assumed symmetric, thus also all MCE events are symmetric, one CPU cannot generate other MCE than another. So the only thing that differs is where you want to listen for them.
Quoted 5 lines · Peter Zijlstra
Quoted 3 lines · Borislav Petkov
have we considered the per-cpu granularity of MCEs here and if yes, how to represent that?
Quoted 7 lines
Uhm, by opening the MCE event on a particular cpu? Remember that
sys_perf_event_open()has a cpu target.The thing is, CPUs are assumed symmetric, thus also all MCE events are symmetric, one CPU cannot generate other MCE than another. So the only thing that differs is where you want to listen for them.
Note, this does not preclude Linux from supporting assymetric MP, should the need arise: if MP assymetry is supported then that can (and should) be expressed in the sysfs topology accordingly - and the moment the assymetric MP topology is enumerated in sysfs it gives a place for the different event_source's to live there as well.
Thanks,
Ingo
Quoted 28 lines · Peter Zijlstra
Quoted 3 lines · Greg KH
Again, why do you need/want anything in sysfs in the first place? What problem is it going to solve? Who is going to benifit? Why do they care? What is this whole thing about?
OK, so all of this is about
perf_event. The story starts with CPUs adding a PMU (Performance Monitor Unit) which allows the user to count/sample cpu state.The whole
perf_countersubsystem was created to abstract this piece of hardware and provide an kernel interface to it.Then we realized that a generalization of the PMU exists in pretty much everything that generates 'events' of interest and so we started adding software PMUs that allowed us to do the same for tracepoints etc.
So we ended up with
perf_events. A subsystem dedicated to counting events and event based sampling.Now the problem this patch set tries to solve; more hardware than the CPU has such capabilities. There are memory controllers, bus controllers and devices with similar capabilities.
So we need a way to identify and locate these things, and since sysfs has the full machine topology in it, the idea was to represent these things in sysfs as an
event_sourceclass.
Quoted 5 lines
Since the CPU and memory controllers are (assumed) symmetric on the system, we get to add things like:
/sys/devices/system/cpu/cpu_event_source/
Wouldn't that really be:
/sys/devices/system/cpu/cpu0/cpu_event_source/
?
/sys/devices/system/cpu is a "type" of devices in the system here, and isn't an event source specific to the device itself?
Or is it for all cpus together?
Quoted 8 lines
/sys/devices/system/node/node_event_source/Devices like GPUs can do:
/sys/devices/pci0000:00/0000:00:01.0/0000:01:00.0/radeon_event_source/
Hooking them into sysfs at the proper device/machine topology location allows us to quickly locate and identify these '
event_sources'.
Ok, this all makes a lot more sense now, thanks.
Quoted 24 lines
Since all hardware wants to keep life interesting they all work differently and programming PMUs is no different, they count different things, have different ways to program them etc. But for each class there is a useful subset of things that is pretty uniform.
CPU based PMUs all can count things like clock-cycles and instructions, Memory controllers can count things like local/remote memory accesses etc.
So each class has a number of actual events that are worthy of abstracting. The idea was to place these events in the
event_source, like:
/sys/devices/system/cpu/cpu_event_source/cycles//sys/devices/system/cpu/cpu_event_source/instructions/And then there are the software
event_sourcesthat expose kernel events (through tracepoints), currently tracepoints live
in /debug/tracing/events/ (or/sys/kernel/debug/tracing/events/for those so inclined). But the above abstraction would suggest we expose them similarly.
Quoted 5 lines
I'm not sure where we'd want them to live, we could add them to:
/sys/kernel/tracepoint_event_source/and have them live there, but I'm open to alternatives :-)
Once you go outside of /sys/devices/ you aren't playing with devices properly, so you might just want to stick to a "class" and have /sys/class/tracepoint_event_source/ where all of the devices would end up symlinking to.
Quoted 3 lines
[ With event_source's being a sysfs-class, we also get a nice flat
collection in/sys/class/event_source/helping those who get lost in the device topology, me :-) ]
Yes, but isn't the fact that you can have different types of event sources lend itself to different classes of event sources?
Quoted 34 lines
The next issue seems to be the interface between this sysfs representation and the
perf_eventsyscall, how do we go about creating an actualperf_eventobject from this rich sysfsevent_sourceclass object.The
sys_perf_event_open()call takes a structperf_event_attrpointer which describes the event and its properties. The current event classification goes through:struct perf_event_attr { __u32 type; __u64 config; ... };So my initial idea was to let each
event_sourcehave atype_idand let each of its events have a config field and read those and insert them in your structure.So we'd get:
/sys/devices/system/cpu/cpu_event_source/type_id/sys/devices/system/cpu/cpu_event_source/instructions/configcat those to get: .type = 0, .config = 1
(PERF_TYPE_HARDWARE:PERF_COUNT_HW_INSTRUCTIONS).Then Ingo objected and said, if we need to open and read those file, you might as well just open one file and pass the fd along, saves some syscalls.
So you'd end up doing:
Quoted 7 lines
fd =
open("/sys/devices/system/cpu/cpu_event_source/instructions/config");attr->type= fd |PERF_TYPE_FD;
event_fd= perf_event_open(attr, ... );
close(fd);From that one fd we can find to which '
event_source' it belongs and what particular config we need to use.
Ah, pass the fd of a sysfs file to sysfs to get the kobject. Ick, that's just, well, something that I never even considered someone would need/want to do...
sysfs exports single values just fine. If you are starting to do more complex things, like you currently are, maybe you shouldn't be in sysfs...
I can always knock up a eventfs for you do mount at /sys/kernel/events/ or something if you want :)
thanks,
greg k-h
Peter Zijlstra
maintainerQuoted 8 lines · Greg KH
Quoted 5 lines · Peter Zijlstra
Since the CPU and memory controllers are (assumed) symmetric on the system, we get to add things like:
/sys/devices/system/cpu/cpu_event_source/
Quoted 8 lines
Wouldn't that really be:
/sys/devices/system/cpu/cpu0/cpu_event_source/
?
/sys/devices/system/cpuis a "type" of devices in the system here, and isn't an event source specific to the device itself?Or is it for all cpus together?
All CPUs are assumed identical, and the perf syscall has task/cpu monitor targets. If the CPUs would not be identical (like Paul Mundt said SH might do) then it would make sense to have different event_sources for each cpu.
Quoted 10 lines
Quoted 5 lines
I'm not sure where we'd want them to live, we could add them to:
/sys/kernel/tracepoint_event_source/and have them live there, but I'm open to alternatives :-)
Once you go outside of
/sys/devices/you aren't playing with devices properly, so you might just want to stick to a "class" and have/sys/class/tracepoint_event_source/where all of the devices would end up symlinking to.
Sure, that would work.
Quoted 6 lines
Quoted 3 lines
[ With event_source's being a sysfs-class, we also get a nice flat
collection in/sys/class/event_source/helping those who get lost in the device topology, me :-) ]Yes, but isn't the fact that you can have different types of event sources lend itself to different classes of event sources?
I'm not quite sure adding another abstraction level buys us much.
Quoted 11 lines
Quoted 7 lines
fd =
open("/sys/devices/system/cpu/cpu_event_source/instructions/config");attr->type= fd |PERF_TYPE_FD;
event_fd= perf_event_open(attr, ... );
close(fd);From that one fd we can find to which '
event_source' it belongs and what particular config we need to use.Ah, pass the fd of a sysfs file to sysfs to get the kobject. Ick, that's just, well, something that I never even considered someone would need/want to do...
No, we don't pass the fd to sysfs, we pass the fd into a syscall.
Quoted 3 lines
sysfs exports single values just fine. If you are starting to do more complex things, like you currently are, maybe you shouldn't be in sysfs...
Well, like said, I'm fine with it actually being single values, its just that Ingo suggested skipping a few syscalls.
Robert just suggested we could use the sysfs files as device nodes and have then open() return a perf_event fd. Its just that that would require we add a ioctl to change the perf_event_attr structure and attach it to a context.
Quoted 2 lines
I can always knock up a eventfs for you do mount at
/sys/kernel/events/or something if you want :)
But that won't get us the nice device linkage, right?
Quoted 4 lines · Greg KH
[...]
I can always knock up a eventfs for you do mount at
/sys/kernel/events/or something if you want :)
eventfs was my first idea, until Peter convinced me that we want sysfs :-)
One important aspect would be to move it into the physical topology. Graphics card? It might have events. PCI device? It might have events. Southbridge? It might have a PMU and events. CPU? It has a PMU.
Especially when it comes to complex physical topologies on larger systems, we eventually want to visualize things in tooling as well - as a tree of the physical topology. Also, physical topologies will only become more complex, so we dont want to detach events from them.
Quoted 2 lines
sysfs exports single values just fine. If you are starting to do more complex things, like you currently are, maybe you shouldn't be in sysfs...
This is really like a read-only attributes, and it would be multi-line only for the event format descriptor - a genuinely new aspect: a flexible ABI descriptor.
It's an attribute for a very good purpose: flexible ABI with a user-space that interprets new format descriptions automatically. This is not just theory, for example perf trace does this today, and you can write scripts with old tools for a new event that shows up in a new kernel, without rebuilding the tools.
Here is an example of a format descriptor:
# cat /debug/tracing/events/sched/sched_wakeup/format name: sched_wakeup ID: 59 format: field:unsigned short common_type; offset:0; size:2; signed:0; field:unsigned char common_flags; offset:2; size:1; signed:0; field:unsigned char common_preempt_count; offset:3; size:1; signed:0; field:int common_pid; offset:4; size:4; signed:1; field:int common_lock_depth; offset:8; size:4; signed:1;
field:char comm[TASK_COMM_LEN]; offset:12; size:16; signed:1; field:pid_t pid; offset:28; size:4; signed:1; field:int prio; offset:32; size:4; signed:1; field:int success; offset:36; size:4; signed:1; field:int target_cpu; offset:40; size:4; signed:1;
print fmt: "comm=%s pid=%d prio=%d success=%d target_cpu=%03d", REC->comm, REC->pid, REC->prio, REC->success, REC->target_cpu
Also, we already have quite a few multi-line files in sysfs, for example:
$ cat /sys/devices/pnp0/00:09/options Dependent: 00 - Priority preferred port 0x378-0x378, align 0x0, size 0x8, 16-bit address decoding port 0x778-0x778, align 0x0, size 0x8, 16-bit address decoding irq 7 High-Edge dma 3 8-bit compatible Dependent: 01 - Priority acceptable port 0x378-0x378, align 0x0, size 0x8, 16-bit address decoding port 0x778-0x778, align 0x0, size 0x8, 16-bit address decoding irq 3,4,5,6,7,10,11,12 High-Edge dma 0,1,2,3 8-bit compatible Dependent: 02 - Priority acceptable port 0x278-0x278, align 0x0, size 0x8, 16-bit address decoding port 0x678-0x678, align 0x0, size 0x8, 16-bit address decoding irq 3,4,5,6,7,10,11,12 High-Edge dma 0,1,2,3 8-bit compatible Dependent: 03 - Priority acceptable port 0x3bc-0x3bc, align 0x0, size 0x4, 16-bit address decoding port 0x7bc-0x7bc, align 0x0, size 0x4, 16-bit address decoding irq 3,4,5,6,7,10,11,12 High-Edge dma 0,1,2,3 8-bit compatible
$ cat /sys/devices/pci0000:00/0000:00:1a.7/pools poolinfo - 0.1 ehci_sitd 0 0 96 0 ehci_itd 0 0 160 0 ehci_qh 4 42 96 1 ehci_qtd 4 42 96 1 buffer-2048 0 0 2048 0 buffer-512 0 0 512 0 buffer-128 0 0 128 0 buffer-32 1 128 32 1
In fact uevents have multi-line attributes as well:
$ cat /sys/devices/pci0000:00/0000:00:1a.1/usb4/uevent MAJOR=189 MINOR=384 DEVNAME=bus/usb/004/001 DEVTYPE=usb_device DRIVER=usb DEVICE=/proc/bus/usb/004/001 PRODUCT=1d6b/1/206 TYPE=9/0/0 BUSNUM=004 DEVNUM=001
Thanks,
Ingo
Quoted 16 lines · Peter Zijlstra
Quoted 15 lines · Greg KH
Quoted 5 lines · Peter Zijlstra
Since the CPU and memory controllers are (assumed) symmetric on the system, we get to add things like:
/sys/devices/system/cpu/cpu_event_source/Wouldn't that really be:
/sys/devices/system/cpu/cpu0/cpu_event_source/
?
/sys/devices/system/cpuis a "type" of devices in the system here, and isn't an event source specific to the device itself?
Quoted 6 lines
Quoted 1 line
Or is it for all cpus together?
All CPUs are assumed identical, and the perf syscall has task/cpu monitor targets. If the CPUs would not be identical (like Paul Mundt said SH might do) then it would make sense to have different
event_sourcesfor each cpu.
Ah, ok.
Quoted 5 lines
Quoted 5 lines
Quoted 5 lines
fd =
open("/sys/devices/system/cpu/cpu_event_source/instructions/config");attr->type= fd |PERF_TYPE_FD;
event_fd= perf_event_open(attr, ... );
close(fd);
Quoted 8 lines
Quoted 6 lines
Quoted 2 lines
From that one fd we can find to which '
event_source' it belongs and what particular config we need to use.Ah, pass the fd of a sysfs file to sysfs to get the kobject. Ick, that's just, well, something that I never even considered someone would need/want to do...
No, we don't pass the fd to sysfs, we pass the fd into a syscall.
Sorry, yes, that is what I was trying to say. You then take that fd, pass it to the sysfs core within the kernel, and get a kobject back.
Quoted 11 lines
Quoted 3 lines
sysfs exports single values just fine. If you are starting to do more complex things, like you currently are, maybe you shouldn't be in sysfs...
Well, like said, I'm fine with it actually being single values, its just that Ingo suggested skipping a few syscalls.
Robert just suggested we could use the sysfs files as device nodes and have then
open()return aperf_eventfd. Its just that that would require we add a ioctl to change theperf_event_attrstructure and attach it to a context.
Nope, sorry, that's not going to happen, that is not what sysfs is for. No ioctls or device nodes in there please.
Quoted 4 lines
Quoted 2 lines
I can always knock up a eventfs for you do mount at
/sys/kernel/events/or something if you want :)But that won't get us the nice device linkage, right?
True, you would loose that.
thanks,
greg k-h
Quoted 10 lines · Ingo Molnar
Quoted 4 lines · Greg KH
[...]
I can always knock up a eventfs for you do mount at
/sys/kernel/events/or something if you want :)eventfs was my first idea, until Peter convinced me that we want sysfs :-)
Quoted 8 lines
One important aspect would be to move it into the physical topology. Graphics card? It might have events. PCI device? It might have events. Southbridge? It might have a PMU and events. CPU? It has a PMU.
Especially when it comes to complex physical topologies on larger systems, we eventually want to visualize things in tooling as well - as a tree of the physical topology. Also, physical topologies will only become more complex, so we dont want to detach events from them.
Ok, yes, physical topology would be nice to have, I agree.
Quoted 6 lines
Quoted 2 lines
sysfs exports single values just fine. If you are starting to do more complex things, like you currently are, maybe you shouldn't be in sysfs...
This is really like a read-only attributes, and it would be multi-line only for the event format descriptor - a genuinely new aspect: a flexible ABI descriptor.
Oh no...
Quoted 17 lines
It's an attribute for a very good purpose: flexible ABI with a user-space that interprets new format descriptions automatically. This is not just theory, for example perf trace does this today, and you can write scripts with old tools for a new event that shows up in a new kernel, without rebuilding the tools.
Here is an example of a format descriptor:
# cat /debug/tracing/events/sched/sched_wakeup/format name: sched_wakeup ID: 59 format: field:unsigned short common_type; offset:0; size:2; signed:0; field:unsigned char common_flags; offset:2; size:1; signed:0; field:unsigned char common_preempt_count; offset:3; size:1; signed:0; field:int common_pid; offset:4; size:4; signed:1; field:int common_lock_depth; offset:8; size:4; signed:1;
Quoted 7 lines
field:char comm[TASK_COMM_LEN]; offset:12; size:16; signed:1; field:pid_t pid; offset:28; size:4; signed:1; field:int prio; offset:32; size:4; signed:1; field:int success; offset:36; size:4; signed:1; field:int target_cpu; offset:40; size:4; signed:1;print fmt: "comm=%s pid=%d prio=%d success=%d target_cpu=%03d",
REC->comm,REC->pid,REC->prio,REC->success,REC->target_cpu
Hm, kind of like a "sane" xml, right?
Quoted 1 line
Also, we already have quite a few multi-line files in sysfs, for example:
These are all aborations, please don't perputuate it.
Quoted 13 lines
$ cat /sys/devices/pnp0/00:09/options Dependent: 00 - Priority preferred port 0x378-0x378, align 0x0, size 0x8, 16-bit address decoding port 0x778-0x778, align 0x0, size 0x8, 16-bit address decoding irq 7 High-Edge dma 3 8-bit compatible Dependent: 01 - Priority acceptable port 0x378-0x378, align 0x0, size 0x8, 16-bit address decoding port 0x778-0x778, align 0x0, size 0x8, 16-bit address decoding irq 3,4,5,6,7,10,11,12 High-Edge dma 0,1,2,3 8-bit compatible Dependent: 02 - Priority acceptable port 0x278-0x278, align 0x0, size 0x8, 16-bit address decoding
Quoted 8 lines
port 0x678-0x678, align 0x0, size 0x8, 16-bit address decoding irq 3,4,5,6,7,10,11,12 High-Edge dma 0,1,2,3 8-bit compatible Dependent: 03 - Priority acceptable port 0x3bc-0x3bc, align 0x0, size 0x4, 16-bit address decoding port 0x7bc-0x7bc, align 0x0, size 0x4, 16-bit address decoding irq 3,4,5,6,7,10,11,12 High-Edge dma 0,1,2,3 8-bit compatible
That should be a debugfs file.
Quoted 10 lines
$ cat /sys/devices/pci0000:00/0000:00:1a.7/pools poolinfo - 0.1 ehci_sitd 0 0 96 0 ehci_itd 0 0 160 0 ehci_qh 4 42 96 1 ehci_qtd 4 42 96 1 buffer-2048 0 0 2048 0 buffer-512 0 0 512 0 buffer-128 0 0 128 0 buffer-32 1 128 32 1
Odd, I hadn't noticed that one before. I can't figure out what that file is, who creates it?
Ick, mm/dmapool.c? Hm, not good, that's a debugging file only, and really does not belong in sysfs. It seems to predate 2.6.12, so it made it in before debugfs was around. I'll work on moving it out of sysfs...
Quoted 13 lines
In fact uevents have multi-line attributes as well:
$ cat /sys/devices/pci0000:00/0000:00:1a.1/usb4/uevent MAJOR=189 MINOR=384 DEVNAME=bus/usb/004/001 DEVTYPE=usb_device DRIVER=usb DEVICE=/proc/bus/usb/004/001 PRODUCT=1d6b/1/206 TYPE=9/0/0 BUSNUM=004 DEVNUM=001
Yes, that's the environment variables that are sent to userspace in the uevent. I don't like the multi-line stuff for this one, but we couldn't think of a better way at the time.
Anyway, back to your original issue, multi-line sysfs files.
I really don't want to do something like that, in sysfs, if at all possible. We have been working very hard to keep the sysfs file format simple, and to follow the one-value-per-file rule, so we don't end up repeating the same mistakes we did in /proc.
Now one could argue that we are not entirely successful, especially based on your examples above. However, those are the rare exception, not the rule by far.
So, where do we do something like this? I don't know. I still like the idea of eventfs, and we could pass in a kobject to it to have it create the tree if needed. Yeah, that would be a replication of some of the sysfs structure, but you could have a custom file format, like you show above, which would you could control and keep in step with your userspace tools.
How deep in the device tree are you really going to be caring about? It sounds like the large majority of events are only going to be coming from the "system" type objects (cpu, nodes, memory, etc.) and very few would be from things that we consider a 'struct device' today (like a pci, usb, scsi, or input, etc.)
thanks,
greg k-h
Peter Zijlstra
maintainerQuoted 5 lines · Greg KH
How deep in the device tree are you really going to be caring about? It sounds like the large majority of events are only going to be coming from the "system" type objects (cpu, nodes, memory, etc.) and very few would be from things that we consider a 'struct device' today (like a pci, usb, scsi, or input, etc.)
The general noise I hear from the hardware people is that we'll see more and more device-level stuff - bus bridges/controller and actual devices (GPUs, NICs etc.) will be wanting to export performance metrics.
[rfc] Describe events in a structured way via sysfs
Quoted 9 lines · Peter Zijlstra
Quoted 6 lines · Greg KH
How deep in the device tree are you really going to be caring about? It sounds like the large majority of events are only going to be coming from the "system" type objects (cpu, nodes, memory, etc.) and very few would be from things that we consider a 'struct device' today (like a pci, usb, scsi, or input, etc.)
Quoted 4 lines
The general noise I hear from the hardware people is that we'll see more and more device-level stuff - bus bridges/controller and actual devices (GPUs, NICs etc.) will be wanting to export performance metrics.
There's (much) more:
- laptops want to provide power level/usage metrics,
- we could express a lot of special, lower level (transport specific) disk IO stats via events as well - without having to push those stats to a higher level (where it might not make sense). Currently such kinds of stats/metrics are very device/subsystem specific way, if they are provided at all.
Also, we already have quite a few per device tracepoints upstream. Here are a few examples:
- GPU tracepoints (trace_i915_gem_request_submit(), etc.)
- WIFI tracepoints (trace_iwlwifi_dev_ioread32(), etc.)
- block tracepoints (trace_block_bio_complete())
So these would be attached to:
# GEM events of drm/card0:
/sys/devices/pci0000:00/0000:00:02.0/drm/card0/events/i915_gem_request_submit/
# Wifi-ioread events of wlan0:
/sys/devices/pci0000:00/0000:00:1c.1/0000:03:00.0/net/wlan0/events/iwlwifi_dev_ioread32/
# whole sdb disk events: /sys/block/sdb/events/block_bio_complete/
# sdb1 partition events: /sys/block/sdb/sdb1/events/block_bio_complete/
And we also have 'software nodes' in /sys that have events upstream here and today. For example for SLAB we already have kmalloc/kfree tracepoints (trace_kmalloc() and trace_kfree()):
# all kmalloc events: /sys/kernel/slab/events/
# kmalloc events for sighand_cache: /sys/kernel/slab/sighand_cache/events/kmalloc/
# kfree events for sighand_cache: /sys/kernel/slab/sighand_cache/events/kfree/
In general the set of events we have upstream is growing along an exponential curve (there's over a hundred now, via tracepoints).
They are either logically attached to the hardware topology of the system (as in the first set of examples above), or ae attached to the software/subsystem object topology of the kernel (some examples of which are described in the second set of examples above).
Sometimes there are aliasing/filtering relationship between events, which is expressed very well via the hierarchy and granularity of /sysfs.
New events would go into that topology there in a natural way.
For example general hugepage tracepoints (should we introduce any) would go into the existing hugepage node:
/sys/kernel/mm/hugepages/events/...
All in one, all these existing and future events, both of hardware and software type, are literally begging to be attached to nodes in /sys :-)
If we created a separate eventfs for it we'd have to start with duplicating all the topology/hiearchy/structure that is present in sysfs already. (and dilluting /sys's utility)
That would be a bad thing, so it would be nice if we found a workable solution here. We could split up the record format some more:
/sys/kernel/sched/events/sched_wakeup/format/ /sys/kernel/sched/events/sched_wakeup/format/common_type/ /sys/kernel/sched/events/sched_wakeup/format/common_flags/ /sys/kernel/sched/events/sched_wakeup/format/common_preempt_count/ /sys/kernel/sched/events/sched_wakeup/format/common_pid/ /sys/kernel/sched/events/sched_wakeup/format/common_lock_depth/ /sys/kernel/sched/events/sched_wakeup/format/comm/ /sys/kernel/sched/events/sched_wakeup/format/pid/ /sys/kernel/sched/events/sched_wakeup/format/prio/ /sys/kernel/sched/events/sched_wakeup/format/success/ /sys/kernel/sched/events/sched_wakeup/format/target_cpu/
Into single-value files. But this would add significant parsing overhead (plus significant allocation overhead), for no tangible benefit.
The problem with /proc was always the lack of standard structure and the lack of performance - while the format file is about _more_ structure.
Increasing structure parsing overhead does not look like the right answer to that problem.
Hm?
Ingo
Re: [rfc] Describe events in a structured way via sysfs
In reply to a message not in the archiveQuoted 40 lines · Peter Zijlstra
Quoted 10 lines · Greg KH
Quoted 7 lines
How deep in the device tree are you really going to be caring about? It sounds like the large majority of events are only going to be coming from the "system" type objects (cpu, nodes, memory, etc.) and very few would be from things that we consider a 'struct device' today (like a pci, usb, scsi, or input, etc.)
Quoted 4 lines
The general noise I hear from the hardware people is that we'll see more and more device-level stuff - bus bridges/controller and actual devices (GPUs, NICs etc.) will be wanting to export performance metrics.
There's (much) more:
- laptops want to provide power level/usage metrics,
- we could express a lot of special, lower level (transport specific) disk IO stats via events as well - without having to push those stats to a higher level (where it might not make sense). Currently such kinds of stats/metrics are very device/subsystem specific way, if they are provided at all.
Also, we already have quite a few per device tracepoints upstream. Here are a few examples:
- GPU tracepoints (
trace_i915_gem_request_submit(), etc.)
- WIFI tracepoints (trace_iwlwifi_dev_ioread32(), etc.)
- block tracepoints (trace_block_bio_complete())So these would be attached to:
# GEM events of drm/card0:
/sys/devices/pci0000:00/0000:00:02.0/drm/card0/events/i915_gem_request_submit/
Quoted 9 lines
# Wifi-ioread events of wlan0:
/sys/devices/pci0000:00/0000:00:1c.1/0000:03:00.0/net/wlan0/events/iwlwifi_dev_ioread32/# whole sdb disk events: /sys/block/sdb/events/block_bio_complete/# sdb1 partition events: /sys/block/sdb/sdb1/events/block_bio_complete/
The difficulty is how to know where each event should be attached to.
struct ftrace_event_call *call;
for_each_event(call, __start_ftrace_events, __stop_ftrace_events) {
/* where will this event be attached to? */
}Any idea?
Thanks,
Lin Ming
Re: [rfc] Describe events in a structured way via sysfs
Quoted 52 lines · Lin Ming
Quoted 40 lines · Peter Zijlstra
Quoted 10 lines · Greg KH
Quoted 7 lines
How deep in the device tree are you really going to be caring about? It sounds like the large majority of events are only going to be coming from the "system" type objects (cpu, nodes, memory, etc.) and very few would be from things that we consider a 'struct device' today (like a pci, usb, scsi, or input, etc.)
Quoted 4 lines
The general noise I hear from the hardware people is that we'll see more and more device-level stuff - bus bridges/controller and actual devices (GPUs, NICs etc.) will be wanting to export performance metrics.
There's (much) more:
- laptops want to provide power level/usage metrics,
- we could express a lot of special, lower level (transport specific) disk IO stats via events as well - without having to push those stats to a higher level (where it might not make sense). Currently such kinds of stats/metrics are very device/subsystem specific way, if they are provided at all.
Also, we already have quite a few per device tracepoints upstream. Here are a few examples:
- GPU tracepoints (
trace_i915_gem_request_submit(), etc.)
- WIFI tracepoints (trace_iwlwifi_dev_ioread32(), etc.)
- block tracepoints (trace_block_bio_complete())So these would be attached to:
# GEM events of drm/card0:
/sys/devices/pci0000:00/0000:00:02.0/drm/card0/events/i915_gem_request_submit/Quoted 9 lines
# Wifi-ioread events of wlan0:
/sys/devices/pci0000:00/0000:00:1c.1/0000:03:00.0/net/wlan0/events/iwlwifi_dev_ioread32/# whole sdb disk events: /sys/block/sdb/events/block_bio_complete/# sdb1 partition events: /sys/block/sdb/sdb1/events/block_bio_complete/The difficulty is how to know where each event should be attached to.
Quoted 7 lines
struct
ftrace_event_call*call;for_each_event(call, __start_ftrace_events, __stop_ftrace_events) { /* where will this event be attached to? */ }Any idea?
Well, it cannot be automatic - for each subsystem it's a different sysfs point. So it has to be specified in the TRACE_EVENT() definition or so.
Ingo
Re: [rfc] Describe events in a structured way via sysfs
In reply to a message not in the archiveQuoted 82 lines
From: Ingo Molnar <[email protected]>
Quoted 9 lines · Peter Zijlstra
Quoted 6 lines · Greg KH
How deep in the device tree are you really going to be caring about? It sounds like the large majority of events are only going to be coming from the "system" type objects (cpu, nodes, memory, etc.) and very few would be from things that we consider a 'struct device' today (like a pci, usb, scsi, or input, etc.)
Quoted 4 lines
The general noise I hear from the hardware people is that we'll see more and more device-level stuff - bus bridges/controller and actual devices (GPUs, NICs etc.) will be wanting to export performance metrics.
There's (much) more:
- laptops want to provide power level/usage metrics,
- we could express a lot of special, lower level (transport specific) disk IO stats via events as well - without having to push those stats to a higher level (where it might not make sense). Currently such kinds of stats/metrics are very device/subsystem specific way, if they are provided at all.
Also, we already have quite a few per device tracepoints upstream. Here are a few examples:
- GPU tracepoints (
trace_i915_gem_request_submit(), etc.)
- WIFI tracepoints (trace_iwlwifi_dev_ioread32(), etc.)
- block tracepoints (trace_block_bio_complete())So these would be attached to:
# GEM events of drm/card0:
/sys/devices/pci0000:00/0000:00:02.0/drm/card0/events/i915_gem_request_submit/# Wifi-ioread events of wlan0:
/sys/devices/pci0000:00/0000:00:1c.1/0000:03:00.0/net/wlan0/events/iwlwifi_dev_ioread32/# whole sdb disk events: /sys/block/sdb/events/block_bio_complete/# sdb1 partition events: /sys/block/sdb/sdb1/events/block_bio_complete/And we also have 'software nodes' in /sys that have events upstream here and today. For example for SLAB we already have kmalloc/kfree tracepoints (
trace_kmalloc()andtrace_kfree()):# all kmalloc events: /sys/kernel/slab/events/# kmalloc events for sighand_cache: /sys/kernel/slab/sighand_cache/events/kmalloc/# kfree events for sighand_cache: /sys/kernel/slab/sighand_cache/events/kfree/In general the set of events we have upstream is growing along an exponential curve (there's over a hundred now, via tracepoints).
They are either logically attached to the hardware topology of the system (as in the first set of examples above), or ae attached to the software/subsystem object topology of the kernel (some examples of which are described in the second set of examples above).
Sometimes there are aliasing/filtering relationship between events, which is expressed very well via the hierarchy and granularity of /sysfs.
New events would go into that topology there in a natural way.
Quoted 8 lines
For example general hugepage tracepoints (should we introduce any) would go into the existing hugepage node:
/sys/kernel/mm/hugepages/events/...All in one, all these existing and future events, both of hardware and software type, are literally begging to be attached to nodes in /sys :-)
(sorry for late response...)
There are so many events via tracepoints, how about below sysfs point for each events?
1. kvm events /sys/devices/system/kvm/kvm0/events/kvm_set_irq/
.../sys/devices/system/kvm/kvm0/events/kvm_emulate_insn/
2. kvm_mmu events /sys/devices/system/kvm/kvm0/events/kvm_mmu_pagetable_walk/
.../sys/devices/system/kvm/kvm0/events/kvm_mmu_zap_page/
3. raw_syscalls events/sys/kernel/events/sys_enter//sys/kernel/events/sys_exit/
4. mce events /sys/devices/system/machinecheck/machinecheck0/mce_record/
.../sys/devices/system/machinecheck/machinecheckN/mce_record/
5. sched events/sys/kernel/events/sched_kthread_stop/
.../sys/kernel/events/sched_stat_runtime/
6. irq events/sys/kernel/events/irq_handler_entry/
.../sys/kernel/events/softirq_exit/
7. timer events/sys/kernel/events/timer_init/
.../sys/kernel/events/itimer_expire/
8. signal events/sys/kernel/events/signal_generate/
.../sys/kernel/events/signal_lose_info/
9. workqueue events/sys/kernel/events/workqueue_insertion/
.../sys/kernel/events/workqueue_destruction/
10. lock events/sys/kernel/events/lock_acquire/
.../sys/kernel/events/lock_acquired/
11. module events/sys/module/events/module_load/
.../sys/module/events/module_request/
12. power events/sys/power/events/power_start/
.../sys/power/events/power_end/
13. kmem events/sys/kernel/mm/events/kmalloc/
.../sys/kernel/mm/events/mm_page_alloc_extfrag/
14. ext4 events/sys/fs/events/ext4_free_inode/
.../sys/fs/events/ext4_mb_buddy_bitmap_load/
15. jbd2 events/sys/fs/events/jbd2_checkpoint/
.../sys/fs/events/jbd2_cleanup_journal_tail/
16. xfs events/sys/fs/events/xfs_attr_list_sf/
.../sys/fs/events/xfs_log_recover_inode_skip/
17. gfs2 events/sys/fs/events/gfs2_glock_state_change/
.../sys/fs/events/gfs2_block_alloc/
18. block events/sys/block/sda/events/block_rq_abort/
.../sys/block/sdb/events/block_rq_remap/
19. bkl events/sys/kernel/events/lock_kernel/
.../sys/kernel/events/unlock_kernel/
20. scsi events /sys/bus/scsi/devices/0:0:0:0/events/scsi_dispatch_cmd_start/
...
/sys/bus/scsi/devices/0:0:0:0/events/scsi_eh_wakeup/
21. iwlwifi_io events /sys/devices/pci0000:00/0000:00:1c.1/0000:03:00.0/net/wlan0/events/iwlwifi_dev_ioread32/
...
/sys/devices/pci0000:00/0000:00:1c.1/0000:03:00.0/net/wlan0/events/iwlwifi_dev_ucode_event/
22. iwm events
<where should iwm events be in sysfs?>
23. skb events/sys/class/net/events/kfree_skb//sys/class/net/events/skb_copy_datagram_iovec/
24. napi events/sys/class/net/events/napi/
25. mac80211 events/sys/class/net/events/drv_start/
.../sys/class/net/events/stop_queue
Re: [rfc] Describe events in a structured way via sysfs
In reply to a message not in the archiveQuoted 16 lines · Johannes Berg
Quoted 15 lines · Lin Ming
Quoted 9 lines · Johannes Berg
Quoted 4 lines · Lin Ming
21.
iwlwifi_ioevents /sys/devices/pci0000:00/0000:00:1c.1/0000:03:00.0/net/wlan0/events/iwlwifi_dev_ioread32/
...
/sys/devices/pci0000:00/0000:00:1c.1/0000:03:00.0/net/wlan0/events/iwlwifi_dev_ucode_event/That doesn't work, you could have multiple PCI devices in your system.
Understood. This is just a "demo".
Actually, I mean
Quoted 7 lines
Quoted 4 lines
net/wlan0/events/net/waln1/events/
....net/walnN/events/That's not appropriate either though since you may have multiple network interfaces on the same hardware :)
Doesn't net/wlan0...wlanN mean multiple network interfaces on the same hardware?
If my understanding is wrong, would you show me an example in sysfs?
Quoted 10 lines
Quoted 10 lines
Quoted 10 lines
Quoted 9 lines
23. skb events
/sys/class/net/events/kfree_skb//sys/class/net/events/skb_copy_datagram_iovec/25. mac80211 events
/sys/class/net/events/drv_start/
.../sys/class/net/events/stop_queue
Quoted 7 lines
Quoted 4 lines
Quoted 1 line
It doesn't really seem right to mix all these.
Well, agree, skb events are totally different with mac80211 events. Any idea?
I suppose the most appropriate thing would
be/sys/class/ieee80211/phyN/events/... for almost all of them.
Good idea.
Thanks,
Lin Ming
Quoted 3 lines
johannes
Re: [rfc] Describe events in a structured way via sysfs
Quoted 10 lines · Lin Ming
Quoted 7 lines
Quoted 4 lines
net/wlan0/events/net/waln1/events/
....net/walnN/events/That's not appropriate either though since you may have multiple network interfaces on the same hardware :)
Doesn't
net/wlan0...wlanNmean multiple network interfaces on the same hardware?
Yes, but the trace points aren't per network interface but rather per hardware piece.
johannes
Re: [rfc] Describe events in a structured way via sysfs
Quoted 5 lines · Johannes Berg
Quoted 5 lines
Quoted 5 lines
Quoted 4 lines
net/wlan0/events/net/waln1/events/
....net/walnN/events/
Quoted 8 lines
Quoted 5 lines
Quoted 2 lines
That's not appropriate either though since you may have multiple network interfaces on the same hardware :)
Doesn't
net/wlan0...wlanNmean multiple network interfaces on the same hardware?Yes, but the trace points aren't per network interface but rather per hardware piece.
Which really just means that whoever writes the tracepoint needs to provide a struct device for where to put it (at least in the case of driver tracepoints), and then ideally some description of the device also gets put into the ringbuffer.
Assuming you actually want to have the event show up in sysfs twice if it has multiple producers? I'd like that, it would make sense for a lot of cases since you might only care about one of the producers.
johannes
Re: [rfc] Describe events in a structured way via sysfs
In reply to Johannes BergQuoted 7 lines · Johannes Berg
Quoted 5 lines · Lin Ming
Quoted 5 lines
Quoted 4 lines
net/wlan0/events/net/waln1/events/
....net/walnN/events/
Quoted 8 lines
Quoted 5 lines
Quoted 2 lines
That's not appropriate either though since you may have multiple network interfaces on the same hardware :)
Doesn't
net/wlan0...wlanNmean multiple network interfaces on the same hardware?Yes, but the trace points aren't per network interface but rather per hardware piece.
So it can only trace the whole hardware piece rather than a specific interface?
If yes, then will change to
- /sys/devices/pci0000:00/0000:00:1c.1/0000:03:00.0/net/wlan0/events/iwlwifi_dev_ioread32/
+ /sys/devices/pci0000:00/0000:00:1c.1/0000:03:00.0/events/iwlwifi_dev_ioread32/
Quoted 3 lines
johannes
Re: [rfc] Describe events in a structured way via sysfs
Quoted 6 lines · Lin Ming
So it can only trace the whole hardware piece rather than a specific interface?
If yes, then will change to
- /sys/devices/pci0000:00/0000:00:1c.1/0000:03:00.0/net/wlan0/events/iwlwifi_dev_ioread32/
+ /sys/devices/pci0000:00/0000:00:1c.1/0000:03:00.0/events/iwlwifi_dev_ioread32/
Yes, I guess you were right from the start and I was just thinking about it the wrong way. So presumably you'll somehow have to "instantiate" tracepoints for a given device?
johannes
Re: [rfc] Describe events in a structured way via sysfs
In reply to Johannes BergQuoted 13 lines · Johannes Berg
Quoted 11 lines · Johannes Berg
Quoted 10 lines
Quoted 7 lines
Quoted 4 lines
net/wlan0/events/net/waln1/events/
....net/walnN/events/That's not appropriate either though since you may have multiple network interfaces on the same hardware :)
Doesn't
net/wlan0...wlanNmean multiple network interfaces on the same hardware?
Quoted 7 lines
Quoted 2 lines
Yes, but the trace points aren't per network interface but rather per hardware piece.
Which really just means that whoever writes the tracepoint needs to provide a struct device for where to put it (at least in the case of driver tracepoints), and then ideally some description of the device also gets put into the ringbuffer.
I'm not familiar with tracepoint code. Correct me if I'm wrong. Do you mean that, for example, if iwlwifi_dev_ioread32 event is traced, then the "device" info will get put into the ftrace ringbuffer?
Quoted 4 lines
Assuming you actually want to have the event show up in sysfs twice if it has multiple producers? I'd like that, it would make sense for a lot of cases since you might only care about one of the producers.
Yes, each producers has a "events" sysfs dir.
Quoted 3 lines
johannes
Re: [rfc] Describe events in a structured way via sysfs
Quoted 8 lines · Lin Ming
Quoted 4 lines
Which really just means that whoever writes the tracepoint needs to provide a struct device for where to put it (at least in the case of driver tracepoints), and then ideally some description of the device also gets put into the ringbuffer.
I'm not familiar with tracepoint code. Correct me if I'm wrong. Do you mean that, for example, if
iwlwifi_dev_ioread32event is traced, then the "device" info will get put into the ftrace ringbuffer?
No, right now it doesn't.
johannes
Re: [rfc] Describe events in a structured way via sysfs
In reply to Johannes BergQuoted 7 lines · Johannes Berg
Quoted 5 lines · Lin Ming
Quoted 5 lines
Quoted 4 lines
net/wlan0/events/net/waln1/events/
....net/walnN/events/
Quoted 8 lines
Quoted 5 lines
Quoted 2 lines
That's not appropriate either though since you may have multiple network interfaces on the same hardware :)
Doesn't
net/wlan0...wlanNmean multiple network interfaces on the same hardware?Yes, but the trace points aren't per network interface but rather per hardware piece.
Yeah - we generally want events to live at their 'natural' source in sysfs.
So if it's a per device hardware event, it should live with the hardware piece. If it's a higher level chipset event, it should live where the chipset driver is in sysfs. If it's a subsystem level event then it should live there.
I think what you mentioned in your other posting makes the most sense: give flexibility to tracepoint authors to place the event in the most sensible sysfs place. It is them who define the tracepoints and the events so any second guessing by a generic layer will probably get in the way. The generic tool layer will be content with having the event_source class in sysfs, to see 'all' event sources ttheir topological structure.
That's probably best achieved via a TRACE_EVENT() variant, by passing in the sysfs location.
It might even make sense to make this a part of TRACE_EVENT() itself and make 'NULL' the current default, non-sysfs-enumerated behavior. That way we can gradually (and non-intrusively) find all the right sysfs places for events.
Thanks,
Ingo
Re: [rfc] Describe events in a structured way via sysfs
Quoted 6 lines · Ingo Molnar
That's probably best achieved via a
TRACE_EVENT()variant, by passing in the sysfs location.It might even make sense to make this a part of
TRACE_EVENT()itself and make 'NULL' the current default, non-sysfs-enumerated behavior. That way we can gradually (and non-intrusively) find all the right sysfs places for events.
No, this doesn't work. A lot of events are multi-instance. Say you have an event for each USB device. This event would have to show up in many places in sysfs, and each trace_foo() invocation needs to get the struct device pointer, not just the TRACE_EVENT() definition. Additionally, to create/destroy the sysfs pieces we need something like init_trace_foo(dev) and destroy_trace_foo(dev) be called when the sysfs points for the device should be created/destroyed.
The TRACE_EVENT() just defines the template, but such multi-instance events really should be standardised in terms of their struct device (or maybe kobject).
I think that needs some TRACE_DEVICE_EVENT macro that creates the required inlines etc, and including the init/destroy that are called when the event should show up in sysfs.
There's no way you can have the event show up in sysfs at the right spot with _just_ a TRACE_EVENT macro, since at define time in the header file you don't even have a valid struct device pointer.
johannes
Re: [rfc] Describe events in a structured way via sysfs
Quoted 9 lines · Johannes Berg
Quoted 6 lines · Ingo Molnar
That's probably best achieved via a
TRACE_EVENT()variant, by passing in the sysfs location.It might even make sense to make this a part of
TRACE_EVENT()itself and make 'NULL' the current default, non-sysfs-enumerated behavior. That way we can gradually (and non-intrusively) find all the right sysfs places for events.
Quoted 7 lines
No, this doesn't work. A lot of events are multi-instance. Say you have an event for each USB device. This event would have to show up in many places in sysfs, and each
trace_foo()invocation needs to get the struct device pointer, not just theTRACE_EVENT()definition. Additionally, to create/destroy the sysfs pieces we need something likeinit_trace_foo(dev)anddestroy_trace_foo(dev)be called when the sysfs points for the device should be created/destroyed.
Yes - but even this could be expressed via TRACE_EVENT(): by giving it a device-specific function pointer and then instantiating individual events from a single, central place in sysfs.
That is the place where we already know where it ends up in sysfs, and where the event-specific function can match up whether that particular node belongs to it and whether an additional event directory should be created for that particular sysfs node.
Quoted 11 lines
The
TRACE_EVENT()just defines the template, but such multi-instance events really should be standardised in terms of their struct device (or maybe kobject).I think that needs some
TRACE_DEVICE_EVENTmacro that creates the required inlines etc, and including the init/destroy that are called when the event should show up in sysfs.There's no way you can have the event show up in sysfs at the right spot with _just_ a
TRACE_EVENTmacro, since at define time in the header file you don't even have a valid struct device pointer.
That would be another possible way to do it - to explicitly create the events directory. It looks a bit simpler as we wouldnt have to touch TRACE_EVENT() and because it directly expresses the 'this node has an events directory' property at the place where we create the device node.
Thanks,
Ingo
Re: [rfc] Describe events in a structured way via sysfs
Quoted 36 lines · Ingo Molnar
Quoted 9 lines · Johannes Berg
Quoted 6 lines · Ingo Molnar
That's probably best achieved via a
TRACE_EVENT()variant, by passing in the sysfs location.It might even make sense to make this a part of
TRACE_EVENT()itself and make 'NULL' the current default, non-sysfs-enumerated behavior. That way we can gradually (and non-intrusively) find all the right sysfs places for events.Quoted 7 lines
No, this doesn't work. A lot of events are multi-instance. Say you have an event for each USB device. This event would have to show up in many places in sysfs, and each
trace_foo()invocation needs to get the struct device pointer, not just theTRACE_EVENT()definition. Additionally, to create/destroy the sysfs pieces we need something likeinit_trace_foo(dev)anddestroy_trace_foo(dev)be called when the sysfs points for the device should be created/destroyed.Yes - but even this could be expressed via
TRACE_EVENT(): by giving it a device-specific function pointer and then instantiating individual events from a single, central place in sysfs.That is the place where we already know where it ends up in sysfs, and where the event-specific function can match up whether that particular node belongs to it and whether an additional event directory should be created for that particular sysfs node.
Quoted 8 lines
The
TRACE_EVENT()just defines the template, but such multi-instance events really should be standardised in terms of their struct device (or maybe kobject).I think that needs some
TRACE_DEVICE_EVENTmacro that creates the required inlines etc, and including the init/destroy that are called when the event should show up in sysfs.
Quoted 8 lines
Quoted 3 lines
There's no way you can have the event show up in sysfs at the right spot with _just_ a
TRACE_EVENTmacro, since at define time in the header file you don't even have a valid struct device pointer.That would be another possible way to do it - to explicitly create the events directory. It looks a bit simpler as we wouldnt have to touch
TRACE_EVENT()and because it directly expresses the 'this node has an events directory' property at the place where we create the device node.
Let me take i915 tracepoints as an example.
Do you mean something like below?
drivers/gpu/drm/i915/i915_drv.c +12 -1
@@ -28,6 +28,7 @@*/ #include <linux/device.h> +#include <linux/perf_event.h> #include "drmP.h" #include "drm.h" #include "i915_drm.h"
@@ -413,7 +414,17 @@ int i965_reset(struct drm_device *dev, u8 flags)static int __devinit i915_pci_probe (struct pci_dev *pdev,const struct pci_device_id *ent) { -return drm_get_dev (pdev, ent, &driver); +struct kobject *kobj; +int ret; + + ret =drm_get_dev (pdev, ent, &driver); + +if (!ret) { + kobj = &pdev->dev.kobj; +perf_sys_register_tp (kobj,"i915" ); + } + +return ret; } static void
include/linux/perf_event.h +2 -0
@@ -1019,6 +1019,8 @@ extern int perf_swevent_get_recursion_context(void);extern void perf_swevent_put_recursion_context (int rctx);extern void perf_event_enable (struct perf_event *event);extern void perf_event_disable (struct perf_event *event); + +extern void perf_sys_register_tp (struct kobject *kobj,char *tp_system);#else static inline void perf_event_task_sched_in (struct task_struct *task) { }
kernel/perf_event.c +29 -0
@@ -5877,3 +5877,32 @@ static int __init perf_event_sysfs_init(void) &perfclass_attr_group); }device_initcall (perf_event_sysfs_init); + +#define for_each_event (event, start, end) \ + for (event = start; \ + (unsigned long)event < (unsigned long)end; \ + event++) + +extern struct ftrace_event_call __start_ftrace_events[]; +extern struct ftrace_event_call __stop_ftrace_events[]; + +void perf_sys_register_tp (struct kobject *kobj,char *tp_system) +{ +struct ftrace_event_call *call; +struct kobject *events_kobj; + + events_kobj =kobject_create_and_add ("events" , kobj); +if (!events_kobj) +return ; + +for_each_event (call, __start_ftrace_events, __stop_ftrace_events) { +if (call->class->system && !strcmp (call->class->system, tp_system)) { + +/* create events/<tracepoint> */ +kobject_create_and_add (call->name, events_kobj); + +/* create events/<tracepoint>/enable, filter, format, id */ +/* TBD ... */ + } + } +}
Re: [rfc] Describe events in a structured way via sysfs
Quoted 67 lines · Lin Ming
Quoted 36 lines · Ingo Molnar
Quoted 9 lines · Johannes Berg
Quoted 6 lines · Ingo Molnar
That's probably best achieved via a
TRACE_EVENT()variant, by passing in the sysfs location.It might even make sense to make this a part of
TRACE_EVENT()itself and make 'NULL' the current default, non-sysfs-enumerated behavior. That way we can gradually (and non-intrusively) find all the right sysfs places for events.Quoted 7 lines
No, this doesn't work. A lot of events are multi-instance. Say you have an event for each USB device. This event would have to show up in many places in sysfs, and each
trace_foo()invocation needs to get the struct device pointer, not just theTRACE_EVENT()definition. Additionally, to create/destroy the sysfs pieces we need something likeinit_trace_foo(dev)anddestroy_trace_foo(dev)be called when the sysfs points for the device should be created/destroyed.Yes - but even this could be expressed via
TRACE_EVENT(): by giving it a device-specific function pointer and then instantiating individual events from a single, central place in sysfs.That is the place where we already know where it ends up in sysfs, and where the event-specific function can match up whether that particular node belongs to it and whether an additional event directory should be created for that particular sysfs node.
Quoted 8 lines
The
TRACE_EVENT()just defines the template, but such multi-instance events really should be standardised in terms of their struct device (or maybe kobject).I think that needs some
TRACE_DEVICE_EVENTmacro that creates the required inlines etc, and including the init/destroy that are called when the event should show up in sysfs.Quoted 8 lines
Quoted 3 lines
There's no way you can have the event show up in sysfs at the right spot with _just_ a
TRACE_EVENTmacro, since at define time in the header file you don't even have a valid struct device pointer.That would be another possible way to do it - to explicitly create the events directory. It looks a bit simpler as we wouldnt have to touch
TRACE_EVENT()and because it directly expresses the 'this node has an events directory' property at the place where we create the device node.Let me take i915 tracepoints as an example.
Do you mean something like below?drivers/gpu/drm/i915/i915_drv.c +2
-1@@ -28,6 +28,7 @@*/ #include <linux/device.h> +#include <linux/perf_event.h> #include "drmP.h" #include "drm.h" #include "i915_drm.h" @@ -413,7 +414,17 @@ int i965_reset(struct drm_device *dev, u8 flags)static int __devinit i915_pci_probe (struct pci_dev *pdev,const struct pci_device_id *ent) { -return drm_get_dev (pdev, ent, &driver); +struct kobject *kobj;
drivers/gpu/drm/i915/i915_drv.c int i965_reset(struct drm_device *dev, u8 flags) · line 427
Quoted 10 lines
drivers/gpu/drm/i915/i915_drv.c +10
-0+int ret; + + ret =drm_get_dev (pdev, ent, &driver); + +if (!ret) { + kobj = &pdev->dev.kobj; +perf_sys_register_tp (kobj,"i915" ); + } + +return ret;
Yeah, something like that - assuming that this means that we'll add the events directory to the device directory, to all the /sys/bus/pci/drivers/i915/*/events/ driver directories right? (i havent checked the DRM code)
Small detail, it could be written a bit more compactly, like:
drivers/gpu/drm/i915/i915_drv.c int i965_reset(struct drm_device *dev, u8 flags) · line 427
Quoted 7 lines
drivers/gpu/drm/i915/i915_drv.c +7
-0+int ret; + + ret =drm_get_dev (pdev, ent, &driver); +if (!ret) +perf_sys_register_tp (&pdev->dev.kobj,"i915" ); + +return ret;
Also, we can (optionally) consider 'generic', subsystem level events to also show up under:
/sys/bus/pci/drivers/i915/events/
This would give a model to non-device-specific events to be listed one level higher in the sysfs hierarchy.
This too would be done in the driver, not by generic code. It's generally the driver which knows how the events should be categorized.
I'd imagine something similar for wireless drivers as well - most currently defined events would show up on a per device basis there.
Can you see practical problems with this scheme?
Ingo
Re: [rfc] Describe events in a structured way via sysfs
Quoted 76 lines · Ingo Molnar
Quoted 74 lines · Lin Ming
Quoted 36 lines · Ingo Molnar
Quoted 9 lines · Johannes Berg
Quoted 6 lines · Ingo Molnar
That's probably best achieved via a
TRACE_EVENT()variant, by passing in the sysfs location.It might even make sense to make this a part of
TRACE_EVENT()itself and make 'NULL' the current default, non-sysfs-enumerated behavior. That way we can gradually (and non-intrusively) find all the right sysfs places for events.Quoted 7 lines
No, this doesn't work. A lot of events are multi-instance. Say you have an event for each USB device. This event would have to show up in many places in sysfs, and each
trace_foo()invocation needs to get the struct device pointer, not just theTRACE_EVENT()definition. Additionally, to create/destroy the sysfs pieces we need something likeinit_trace_foo(dev)anddestroy_trace_foo(dev)be called when the sysfs points for the device should be created/destroyed.Yes - but even this could be expressed via
TRACE_EVENT(): by giving it a device-specific function pointer and then instantiating individual events from a single, central place in sysfs.That is the place where we already know where it ends up in sysfs, and where the event-specific function can match up whether that particular node belongs to it and whether an additional event directory should be created for that particular sysfs node.
Quoted 8 lines
The
TRACE_EVENT()just defines the template, but such multi-instance events really should be standardised in terms of their struct device (or maybe kobject).I think that needs some
TRACE_DEVICE_EVENTmacro that creates the required inlines etc, and including the init/destroy that are called when the event should show up in sysfs.Quoted 8 lines
Quoted 3 lines
There's no way you can have the event show up in sysfs at the right spot with _just_ a
TRACE_EVENTmacro, since at define time in the header file you don't even have a valid struct device pointer.That would be another possible way to do it - to explicitly create the events directory. It looks a bit simpler as we wouldnt have to touch
TRACE_EVENT()and because it directly expresses the 'this node has an events directory' property at the place where we create the device node.Let me take i915 tracepoints as an example.
Do you mean something like below?drivers/gpu/drm/i915/i915_drv.c +9
-1@@ -28,6 +28,7 @@*/ #include <linux/device.h> +#include <linux/perf_event.h> #include "drmP.h" #include "drm.h" #include "i915_drm.h" @@ -413,7 +414,17 @@ int i965_reset(struct drm_device *dev, u8 flags)static int __devinit i915_pci_probe (struct pci_dev *pdev,const struct pci_device_id *ent) { -return drm_get_dev (pdev, ent, &driver); +struct kobject *kobj; +int ret; + + ret =drm_get_dev (pdev, ent, &driver); + +if (!ret) { + kobj = &pdev->dev.kobj; +perf_sys_register_tp (kobj,"i915" );
Quoted 8 lines
drivers/gpu/drm/i915/i915_drv.c int i965_reset(struct drm_device *dev, u8 flags) · line 427
Quoted 3 lines
drivers/gpu/drm/i915/i915_drv.c +3
-0+ } + +return ret;Yeah, something like that - assuming that this means that we'll add the events directory to the device directory, to all the
/sys/bus/pci/drivers/i915/*/events/driver directories right? (i havent checked the DRM code)
I haven't run the code, but I think yes.
Quoted 2 lines
Small detail, it could be written a bit more compactly, like:
Thanks for the tip.
Quoted 12 lines
drivers/gpu/drm/i915/i915_drv.c int i965_reset(struct drm_device *dev, u8 flags) · line 427
Quoted 8 lines
drivers/gpu/drm/i915/i915_drv.c +7
-0+int ret; + + ret =drm_get_dev (pdev, ent, &driver); +if (!ret) +perf_sys_register_tp (&pdev->dev.kobj,"i915" ); + +return ret;Also, we can (optionally) consider 'generic', subsystem level events to also show up under:
Quoted 7 lines
/sys/bus/pci/drivers/i915/events/This would give a model to non-device-specific events to be listed one level higher in the sysfs hierarchy.
This too would be done in the driver, not by generic code. It's generally the driver which knows how the events should be categorized.
This is a bit difficult. I'd like not to touch TRACE_EVENT(). How does the driver know if an event is 'generic' if TRACE_EVENT is not touched?
Quoted 5 lines
I'd imagine something similar for wireless drivers as well - most currently defined events would show up on a per device basis there.
Can you see practical problems with this scheme?
Not now. I may find some problems when write more detail code.
Lin Ming
Quoted 2 lines
Ingo
Re: [rfc] Describe events in a structured way via sysfs
Quoted 5 lines · Lin Ming
Quoted 5 lines
Also, we can (optionally) consider 'generic', subsystem level events to also show up under:
/sys/bus/pci/drivers/i915/events/
Quoted 7 lines
Quoted 5 lines
This would give a model to non-device-specific events to be listed one level higher in the sysfs hierarchy.
This too would be done in the driver, not by generic code. It's generally the driver which knows how the events should be categorized.
This is a bit difficult. I'd like not to touch
TRACE_EVENT(). [...]
We can certainly start with the simpler variant - it's also the more common case.
Quoted 2 lines
[...] How does the driver know if an event is 'generic' if
TRACE_EVENTis not touched?
Well, it's per driver code which creates the 'events' directory anyway, so that code decides where to link things. It can link it to the per driver kobj
- or to the per subsys kobj.
Quoted 6 lines
Quoted 4 lines
I'd imagine something similar for wireless drivers as well - most currently defined events would show up on a per device basis there.
Can you see practical problems with this scheme?
Not now. I may find some problems when write more detail code.
Ok. Feel free to post RFC patches (even if they are not fully complete yet), so that we can see how things are progressing.
I suspect the best approach would be to try to figure out the right sysfs placement for one or two existing driver tracepoints, so that we can see it all in practice. (Obviously any changes to drivers will have to go via the relevant driver maintainer tree(s).)
Thanks,
Ingo
Re: [rfc] Describe events in a structured way via sysfs
Quoted 32 lines · Ingo Molnar
Quoted 5 lines · Lin Ming
Quoted 5 lines
Also, we can (optionally) consider 'generic', subsystem level events to also show up under:
/sys/bus/pci/drivers/i915/events/Quoted 7 lines
Quoted 5 lines
This would give a model to non-device-specific events to be listed one level higher in the sysfs hierarchy.
This too would be done in the driver, not by generic code. It's generally the driver which knows how the events should be categorized.
This is a bit difficult. I'd like not to touch
TRACE_EVENT(). [...]We can certainly start with the simpler variant - it's also the more common case.
Quoted 2 lines
[...] How does the driver know if an event is 'generic' if
TRACE_EVENTis not touched?Well, it's per driver code which creates the 'events' directory anyway, so that code decides where to link things. It can link it to the per driver kobj
- or to the per subsys kobj.Quoted 6 lines
Quoted 4 lines
I'd imagine something similar for wireless drivers as well - most currently defined events would show up on a per device basis there.
Can you see practical problems with this scheme?
Not now. I may find some problems when write more detail code.
Quoted 7 lines
Ok. Feel free to post RFC patches (even if they are not fully complete yet), so that we can see how things are progressing.
I suspect the best approach would be to try to figure out the right sysfs placement for one or two existing driver tracepoints, so that we can see it all in practice. (Obviously any changes to drivers will have to go via the relevant driver maintainer tree(s).)
Well, take i915 tracepoints as an example, the sys structures as below
/sys/class/drm/card0/events/
|-- i915_gem_object_bind
| |-- enable
| |-- filter
| |-- format
| `-- id
|-- i915_gem_object_change_domain
| |-- enable
| |-- filter
| |-- format
| `-- id
|-- i915_gem_object_clflush
| |-- enable
| |-- filter
| |-- format
| `-- id
|-- i915_gem_object_create
| |-- enable
| |-- filter
| |-- format
| `-- id
|-- i915_gem_object_destroy
| |-- enable
| |-- filter
| |-- format
| `-- id
|-- i915_gem_object_get_fence
| |-- enable
| |-- filter
| |-- format
| `-- id
|-- i915_gem_object_unbind
| |-- enable
| |-- filter
| |-- format
| `-- id
|-- i915_gem_request_complete
| |-- enable
| |-- filter
| |-- format
| `-- id
|-- i915_gem_request_flush
| |-- enable
| |-- filter
| |-- format
| `-- id
|-- i915_gem_request_retire
| |-- enable
| |-- filter
| |-- format
| `-- id
|-- i915_gem_request_submit
| |-- enable
| |-- filter
| |-- format
| `-- id
|-- i915_gem_request_wait_begin
| |-- enable
| |-- filter
| |-- format
| `-- id
|-- i915_gem_request_wait_end
| |-- enable
| |-- filter
| |-- format
| `-- id
|-- i915_ring_wait_begin
| |-- enable
| |-- filter
| |-- format
| `-- id
`-- i915_ring_wait_end
|-- enable
|-- filter
|-- format
`-- idAnd below is the very draft patch to export i915 tracepoints in sysfs. Is it the right direction?
--- drivers/gpu/drm/i915/i915_drv.c | 15 +++- include/linux/perf_event.h | 2 + kernel/perf_event.c | 168 +++++++++++++++++++++++++++++++++++++++ 4 files changed, 186 insertions(+), 1 deletions(-)
drivers/gpu/drm/i915/i915_drv.c +14 -1
@@ -28,6 +28,7 @@*/ #include <linux/device.h> +#include <linux/perf_event.h> #include "drmP.h" #include "drm.h" #include "i915_drm.h"
@@ -413,7 +414,19 @@ int i965_reset(struct drm_device *dev, u8 flags)static int __devinit i915_pci_probe (struct pci_dev *pdev,const struct pci_device_id *ent) { -return drm_get_dev (pdev, ent, &driver); +struct kobject *kobj; +struct drm_device *drm_dev; +int ret; + + ret =drm_get_dev (pdev, ent, &driver); + +if (!ret) { + drm_dev =pci_get_drvdata (pdev); + kobj = &drm_dev->primary->kdev.kobj; +perf_sys_register_tp (kobj,"i915" ); + } + +return ret; } static void
include/linux/perf_event.h +2 -0
@@ -1019,6 +1019,8 @@ extern int perf_swevent_get_recursion_context(void);extern void perf_swevent_put_recursion_context (int rctx);extern void perf_event_enable (struct perf_event *event);extern void perf_event_disable (struct perf_event *event); + +extern void perf_sys_register_tp (struct kobject *kobj,char *tp_system);#else static inline void perf_event_task_sched_in (struct task_struct *task) { }
kernel/perf_event.c +168 -0
171 lines not on this page · raw message
Re: [rfc] Describe events in a structured way via sysfs
Quoted 120 lines · Lin Ming
Quoted 32 lines · Ingo Molnar
Quoted 5 lines · Lin Ming
Quoted 5 lines
Also, we can (optionally) consider 'generic', subsystem level events to also show up under:
/sys/bus/pci/drivers/i915/events/Quoted 7 lines
Quoted 5 lines
This would give a model to non-device-specific events to be listed one level higher in the sysfs hierarchy.
This too would be done in the driver, not by generic code. It's generally the driver which knows how the events should be categorized.
This is a bit difficult. I'd like not to touch
TRACE_EVENT(). [...]We can certainly start with the simpler variant - it's also the more common case.
Quoted 2 lines
[...] How does the driver know if an event is 'generic' if
TRACE_EVENTis not touched?Well, it's per driver code which creates the 'events' directory anyway, so that code decides where to link things. It can link it to the per driver kobj
- or to the per subsys kobj.Quoted 6 lines
Quoted 4 lines
I'd imagine something similar for wireless drivers as well - most currently defined events would show up on a per device basis there.
Can you see practical problems with this scheme?
Not now. I may find some problems when write more detail code.
Quoted 7 lines
Ok. Feel free to post RFC patches (even if they are not fully complete yet), so that we can see how things are progressing.
I suspect the best approach would be to try to figure out the right sysfs placement for one or two existing driver tracepoints, so that we can see it all in practice. (Obviously any changes to drivers will have to go via the relevant driver maintainer tree(s).)
Well, take i915 tracepoints as an example, the sys structures as below
/sys/class/drm/card0/events/|-- i915_gem_object_bind | |-- enable | |-- filter | |-- format | `-- id |-- i915_gem_object_change_domain | |-- enable | |-- filter | |-- format | `-- id |-- i915_gem_object_clflush | |-- enable | |-- filter | |-- format | `-- id |-- i915_gem_object_create | |-- enable | |-- filter | |-- format | `-- id |-- i915_gem_object_destroy | |-- enable | |-- filter | |-- format | `-- id |-- i915_gem_object_get_fence | |-- enable | |-- filter | |-- format | `-- id |-- i915_gem_object_unbind | |-- enable | |-- filter | |-- format | `-- id |-- i915_gem_request_complete | |-- enable | |-- filter | |-- format | `-- id |-- i915_gem_request_flush | |-- enable | |-- filter | |-- format | `-- id |-- i915_gem_request_retire | |-- enable | |-- filter | |-- format | `-- id |-- i915_gem_request_submit | |-- enable | |-- filter | |-- format | `-- id |-- i915_gem_request_wait_begin | |-- enable | |-- filter | |-- format | `-- id |-- i915_gem_request_wait_end | |-- enable | |-- filter | |-- format | `-- id |-- i915_ring_wait_begin | |-- enable | |-- filter | |-- format | `-- id `-- i915_ring_wait_end |-- enable |-- filter |-- format `-- id
Quoted 2 lines
And below is the very draft patch to export i915 tracepoints in sysfs. Is it the right direction?
Yeah, i think so.
The per driver impact is small and to the point:
Quoted 8 lines
drivers/gpu/drm/i915/i915_drv.c | 15 +++-
i915_pci_probe(struct pci_dev *pdev, const struct pci_device_id *ent){drivers/gpu/drm/i915/i915_drv.c +3
-1-return drm_get_dev (pdev, ent, &driver); +struct kobject *kobj; +struct drm_device *drm_dev; +int ret;
drivers/gpu/drm/i915/i915_drv.c int i965_reset(struct drm_device *dev, u8 flags) · line 429
Quoted 10 lines
drivers/gpu/drm/i915/i915_drv.c +10
-0+ + ret =drm_get_dev (pdev, ent, &driver); + +if (!ret) { + drm_dev =pci_get_drvdata (pdev); + kobj = &drm_dev->primary->kdev.kobj; +perf_sys_register_tp (kobj,"i915" ); + } + +return ret;
(It could be even shorter - the same compactness comment as i made last time still holds for this function.)
Thanks,
Ingo
Re: [rfc] Describe events in a structured way via sysfs
In reply to Lin MingQuoted 41 lines · Lin Ming
Quoted 32 lines · Ingo Molnar
Quoted 5 lines · Lin Ming
Quoted 5 lines
Also, we can (optionally) consider 'generic', subsystem level events to also show up under:
/sys/bus/pci/drivers/i915/events/Quoted 7 lines
Quoted 5 lines
This would give a model to non-device-specific events to be listed one level higher in the sysfs hierarchy.
This too would be done in the driver, not by generic code. It's generally the driver which knows how the events should be categorized.
This is a bit difficult. I'd like not to touch
TRACE_EVENT(). [...]We can certainly start with the simpler variant - it's also the more common case.
Quoted 2 lines
[...] How does the driver know if an event is 'generic' if
TRACE_EVENTis not touched?Well, it's per driver code which creates the 'events' directory anyway, so that code decides where to link things. It can link it to the per driver kobj
- or to the per subsys kobj.Quoted 6 lines
Quoted 4 lines
I'd imagine something similar for wireless drivers as well - most currently defined events would show up on a per device basis there.
Can you see practical problems with this scheme?
Not now. I may find some problems when write more detail code.
Quoted 7 lines
Ok. Feel free to post RFC patches (even if they are not fully complete yet), so that we can see how things are progressing.
I suspect the best approach would be to try to figure out the right sysfs placement for one or two existing driver tracepoints, so that we can see it all in practice. (Obviously any changes to drivers will have to go via the relevant driver maintainer tree(s).)
Quoted 8 lines
Well, take i915 tracepoints as an example, the sys structures as below
/sys/class/drm/card0/events/|-- i915_gem_object_bind | |-- enable | |-- filter | |-- format | `-- id
...
Hi Lin,
Sorry for my late reply on this thread. I had missed these posts earlier because I had an email filter that was set to look for messages with "perf" in the subject, and so I missed this entire thread.
With your example here, let's say I want to open this event with the perf_events ABI... how would I go about doing that? Have you figured out whether the caller would read the id and pass that into the interface, or perhaps pass in the fd of the id file (or perhaps the fd of the specific event directory).
Also, I see the filter and format fields here. Would the caller write to these fields to set them up? What's the format of the data that's written to them? Would it be totally device dependent? It seems like there should be a way for a user space tool to discover what can be programmed into the filter and format fields.
- Corey
Re: [rfc] Describe events in a structured way via sysfs
Quoted 50 lines · Corey Ashford
Quoted 41 lines · Lin Ming
Quoted 32 lines · Ingo Molnar
Quoted 5 lines · Lin Ming
Quoted 5 lines
Also, we can (optionally) consider 'generic', subsystem level events to also show up under:
/sys/bus/pci/drivers/i915/events/Quoted 7 lines
Quoted 5 lines
This would give a model to non-device-specific events to be listed one level higher in the sysfs hierarchy.
This too would be done in the driver, not by generic code. It's generally the driver which knows how the events should be categorized.
This is a bit difficult. I'd like not to touch
TRACE_EVENT(). [...]We can certainly start with the simpler variant - it's also the more common case.
Quoted 2 lines
[...] How does the driver know if an event is 'generic' if
TRACE_EVENTis not touched?Well, it's per driver code which creates the 'events' directory anyway, so that code decides where to link things. It can link it to the per driver kobj
- or to the per subsys kobj.Quoted 6 lines
Quoted 4 lines
I'd imagine something similar for wireless drivers as well - most currently defined events would show up on a per device basis there.
Can you see practical problems with this scheme?
Not now. I may find some problems when write more detail code.
Quoted 7 lines
Ok. Feel free to post RFC patches (even if they are not fully complete yet), so that we can see how things are progressing.
I suspect the best approach would be to try to figure out the right sysfs placement for one or two existing driver tracepoints, so that we can see it all in practice. (Obviously any changes to drivers will have to go via the relevant driver maintainer tree(s).)
Quoted 8 lines
Well, take i915 tracepoints as an example, the sys structures as below
/sys/class/drm/card0/events/|-- i915_gem_object_bind | |-- enable | |-- filter | |-- format | `-- id
Quoted 7 lines
...
Hi Lin,
Sorry for my late reply on this thread. I had missed these posts earlier because I had an email filter that was set to look for messages with "perf" in the subject, and so I missed this entire thread.
Sorry for my late reply too.
I have been busy with some other stuff. Hope I can send a more functional patches this week.
Quoted 6 lines
With your example here, let's say I want to open this event with the
perf_eventsABI... how would I go about doing that? Have you figured out whether the caller would read the id and pass that into the interface, or perhaps pass in the fd of the id file (or perhaps the fd of the specific event directory).
Please just ignore my above example. Now I have some uncompleted new patches to export hardware/software/tracepoint events via sysfs, like below.
The event path is passed in with perf's "-e" option, for example perf record -e /sys/kernel/events/page-faults -- <some commands>
The caller reads config and type and pass them into perf_event_attr.
1. Hardware events/sys/devices/system/cpu/cpu0...cpuN/events
|-- L1-dcache-load-misses ===> event name | |-- config ===> config value for the event | `-- type ===> event type |-- cycles | |-- config | `-- type
.....
2. Software events/sys/kernel/events
|-- page-faults | |-- config | `-- type |-- context-switches | |-- config | `-- type
....
3. Tracepoint events
/sys/devices/pci0000:00/0000:00:02.0/events
|-- i915_gem_object_create | |-- config | `-- type |-- i915_gem_object_bind | |-- config | `-- type .... .... /sys/devices/system/kvm/kvm0/events |-- kvm_entry | |-- config | `-- type |-- kvm_hypercall | |-- config | `-- type
....
....
Quoted 6 lines
Also, I see the filter and format fields here. Would the caller write to these fields to set them up? What's the format of the data that's written to them? Would it be totally device dependent? It seems like there should be a way for a user space tool to discover what can be programmed into the filter and format fields.
Now only read-only event attributes(config and type) are exported. I want to first make some minimal functional patches. Then to implement the complex writable attributes.
Lin Ming
Re: [rfc] Describe events in a structured way via sysfs
On 20.07.10 01:48:28, Lin Ming wrote:
The caller reads config and type and pass them into perf_event_attr.
Quoted 6 lines
1. Hardware events
/sys/devices/system/cpu/cpu0...cpuN/events|-- L1-dcache-load-misses ===> event name | |-- config ===> config value for the event | `-- type ===> event type
Wouldn't it be much easier to have a unique sysfs id (could be an u64):
Quoted 2 lines
|-- L1-dcache-load-misses ===> event name | `-- id ===> event id
... and then extend the syscall to enable an event by its sysfs id:
memset(&attr, 0, sizeof(attr));
attr.type = PERF_TYPE_SYSFS;
attr.sysfs_id = sysfs_id;
attr.sample_type = PERF_SAMPLE_CPU | PERF_SAMPLE_RAW;
attr.config = config;
...The kerrnel then knows which event is meant and the don't have to provide event specific paramaters such as type/config that requires an event specific setup. The advantage would be that we can open an event file descriptor of every kind of event in a standardized way.
-Robert
Signature · 2 lines
Advanced Micro Devices, Inc. Operating System Research Center
Re: [rfc] Describe events in a structured way via sysfs
In reply to Lin MingQuoted 126 lines · Lin Ming
Quoted 50 lines · Corey Ashford
Quoted 41 lines · Lin Ming
Quoted 32 lines · Ingo Molnar
Quoted 5 lines · Lin Ming
Quoted 5 lines
Also, we can (optionally) consider 'generic', subsystem level events to also show up under:
/sys/bus/pci/drivers/i915/events/Quoted 7 lines
Quoted 5 lines
This would give a model to non-device-specific events to be listed one level higher in the sysfs hierarchy.
This too would be done in the driver, not by generic code. It's generally the driver which knows how the events should be categorized.
This is a bit difficult. I'd like not to touch
TRACE_EVENT(). [...]We can certainly start with the simpler variant - it's also the more common case.
Quoted 2 lines
[...] How does the driver know if an event is 'generic' if
TRACE_EVENTis not touched?Well, it's per driver code which creates the 'events' directory anyway, so that code decides where to link things. It can link it to the per driver kobj
- or to the per subsys kobj.Quoted 6 lines
Quoted 4 lines
I'd imagine something similar for wireless drivers as well - most currently defined events would show up on a per device basis there.
Can you see practical problems with this scheme?
Not now. I may find some problems when write more detail code.
Quoted 7 lines
Ok. Feel free to post RFC patches (even if they are not fully complete yet), so that we can see how things are progressing.
I suspect the best approach would be to try to figure out the right sysfs placement for one or two existing driver tracepoints, so that we can see it all in practice. (Obviously any changes to drivers will have to go via the relevant driver maintainer tree(s).)
Quoted 8 lines
Well, take i915 tracepoints as an example, the sys structures as below
/sys/class/drm/card0/events/|-- i915_gem_object_bind | |-- enable | |-- filter | |-- format | `-- idQuoted 7 lines
...
Hi Lin,
Sorry for my late reply on this thread. I had missed these posts earlier because I had an email filter that was set to look for messages with "perf" in the subject, and so I missed this entire thread.
Sorry for my late reply too.
I have been busy with some other stuff. Hope I can send a more functional patches this week.Quoted 6 lines
With your example here, let's say I want to open this event with the
perf_eventsABI... how would I go about doing that? Have you figured out whether the caller would read the id and pass that into the interface, or perhaps pass in the fd of the id file (or perhaps the fd of the specific event directory).Please just ignore my above example. Now I have some uncompleted new patches to export hardware/software/tracepoint events via sysfs, like below.
The event path is passed in with perf's "-e" option, for example perf record -e
/sys/kernel/events/page-faults--<some commands>The caller reads config and type and pass them into
perf_event_attr.1. Hardware events
/sys/devices/system/cpu/cpu0...cpuN/events|-- L1-dcache-load-misses ===> event name | |-- config ===> config value for the event | `-- type ===> event type |-- cycles | |-- config | `-- type.....
2. Software events
/sys/kernel/events|-- page-faults | |-- config | `-- type |-- context-switches | |-- config | `-- type....
3. Tracepoint events
/sys/devices/pci0000:00/0000:00:02.0/events|-- i915_gem_object_create | |-- config | `-- type |-- i915_gem_object_bind | |-- config | `-- type .... .... /sys/devices/system/kvm/kvm0/events |-- kvm_entry | |-- config | `-- type |-- kvm_hypercall | |-- config | `-- type....
....Quoted 6 lines
Also, I see the filter and format fields here. Would the caller write to these fields to set them up? What's the format of the data that's written to them? Would it be totally device dependent? It seems like there should be a way for a user space tool to discover what can be programmed into the filter and format fields.
Quoted 3 lines
Now only read-only event attributes(config and type) are exported. I want to first make some minimal functional patches. Then to implement the complex writable attributes.
I'm not seeing the value of writable attributes in sysfs at this point.
Wouldn't that disconnect the event opening between the syscall and the
writing of attributes in user space, with no real way to tie them together? For example, what if two users wrote to the same attribute with different values... which one would take precedence when you go to do the open syscall? I think all of the attribute data should be in the open call, and sysfs should be read-only.
Earlier, I briefly presented an idea that would allow a caller to read attribute formatting information, such as a shift and mask value, which would allow the caller to build up a more complex .config value, possibly extending into a new attr field - .config_extra[n] as dictated by the shift value; shift values greater than 63 would place the attribute into .config_extra[shift amount / 64] shifted by shift amount % 64. It's not the prettiest interface, but I think it could work and would be extensible.
- Corey
Re: [rfc] Describe events in a structured way via sysfs
In reply to Robert RichterQuoted 24 lines · Robert Richter
On 20.07.10 01:48:28, Lin Ming wrote:
The caller reads config and type and pass them intoperf_event_attr.Quoted 6 lines
1. Hardware events
/sys/devices/system/cpu/cpu0...cpuN/events|-- L1-dcache-load-misses ===> event name | |-- config ===> config value for the event | `-- type ===> event typeWouldn't it be much easier to have a unique sysfs id (could be an u64):
Quoted 2 lines
|-- L1-dcache-load-misses ===> event name | `-- id ===> event id... and then extend the syscall to enable an event by its sysfs id:
memset(&attr, 0, sizeof(attr)); attr.type = PERF_TYPE_SYSFS; attr.sysfs_id = sysfs_id; attr.sample_type = PERF_SAMPLE_CPU | PERF_SAMPLE_RAW; attr.config = config; ...
Quoted 4 lines
The kerrnel then knows which event is meant and the don't have to provide event specific paramaters such as type/config that requires an event specific setup. The advantage would be that we can open an event file descriptor of every kind of event in a standardized way.
Your example above still shows the .config member being set. Was that intentional?
Maybe another way to accomplish this would be to reuse the .config field for the sysfs_id.
We still need a way to deal with event attributes though, so something more than a single sysfs_id would be needed to specify the event completely.
- Corey
Re: [rfc] Describe events in a structured way via sysfs
Quoted 9 lines · Corey Ashford
Quoted 8 lines
... and then extend the syscall to enable an event by its sysfs id:
memset(&attr, 0, sizeof(attr)); attr.type = PERF_TYPE_SYSFS; attr.sysfs_id = sysfs_id; attr.sample_type = PERF_SAMPLE_CPU | PERF_SAMPLE_RAW; attr.config = config; ...
Quoted 5 lines
Your example above still shows the .config member being set. Was that intentional?
Maybe another way to accomplish this would be to reuse the .config field for the
sysfs_id.
This was intended as this could be used to configure the event, otherwise there is no way to setup the event with certain parameters. The config value will be event specific then and we can be sure the parameter belongs to _this_ kind of event.
Quoted 2 lines
We still need a way to deal with event attributes though, so something more than a single
sysfs_idwould be needed to specify the event completely.
It is true that you still need knowledge of what the event is measuring and how it is set up or configured. Maybe the configuration may left blank if the event can be setup without it. But with this approach you can get file descriptors for every event a user may be interested in simply by looking into sysfs.
For example, I was thinking of perfctr events vs. ibs events. The cpu could setup something like:
/sys/devices/system/cpu/cpu0...cpuN/events/perfctr/id /sys/devices/system/cpu/cpu0...cpuN/events/ibs_op/id
Both events are setup with one 64 bit config value that is basically the event's configuration msr (x86 perfctr or AMD IBS). These are definded in the hardware specifications. Its formats differ. You could then open the event file descriptor using the sysfs id and use the config value to customize the event. You don't have a complicated setup or implementation to detect which kind of event you want to use as the id indicates the type of event.
Actually, we could setup e.g. also trace events with this mechanism.
-Robert
Signature · 2 lines
Advanced Micro Devices, Inc. Operating System Research Center
Re: [rfc] Describe events in a structured way via sysfs
Quoted 22 lines · Robert Richter
Quoted 9 lines · Corey Ashford
Quoted 8 lines
... and then extend the syscall to enable an event by its sysfs id:
memset(&attr, 0, sizeof(attr)); attr.type = PERF_TYPE_SYSFS; attr.sysfs_id = sysfs_id; attr.sample_type = PERF_SAMPLE_CPU | PERF_SAMPLE_RAW; attr.config = config; ...Quoted 5 lines
Your example above still shows the .config member being set. Was that intentional?
Maybe another way to accomplish this would be to reuse the .config field for the
sysfs_id.This was intended as this could be used to configure the event, otherwise there is no way to setup the event with certain parameters. The config value will be event specific then and we can be sure the parameter belongs to _this_ kind of event.
Quoted 9 lines
Quoted 2 lines
We still need a way to deal with event attributes though, so something more than a single
sysfs_idwould be needed to specify the event completely.It is true that you still need knowledge of what the event is measuring and how it is set up or configured. Maybe the configuration may left blank if the event can be setup without it. But with this approach you can get file descriptors for every event a user may be interested in simply by looking into sysfs.
Yes, that would be a nice feature.
Quoted 14 lines
For example, I was thinking of perfctr events vs. ibs events. The cpu could setup something like:
/sys/devices/system/cpu/cpu0...cpuN/events/perfctr/id/sys/devices/system/cpu/cpu0...cpuN/events/ibs_op/idBoth events are setup with one 64 bit config value that is basically the event's configuration msr (x86 perfctr or AMD IBS). These are definded in the hardware specifications. Its formats differ. You could then open the event file descriptor using the sysfs id and use the config value to customize the event. You don't have a complicated setup or implementation to detect which kind of event you want to use as the id indicates the type of event.
Quoted 1 line
Actually, we could setup e.g. also trace events with this mechanism.
In perf_events, as I recall, they started out with a combined type and config field, but it quickly became obvious that config was going to get too crowded even with 64 bits available, so they were split up into separate type and config fields. I fear that's what would happen to the sysfs_id value as well... it would be too crowded.
Retaining the type and config nodes in sysfs makes it very clear for a programmer as to how to use them.... just read and copy them into the attr struct's corresponding members, and requires no changes to the existing attr struct (at least for the moment).
- Corey