summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSerhei Makarov <serhei@serhei.io>2023-05-08 09:58:41 -0400
committerSerhei Makarov <serhei@serhei.io>2023-05-08 09:58:41 -0400
commit87294a118756a5cd45b0f9e21d6907f321da92c1 (patch)
treee3e2d002ee97b03220011709f8deafe3905b01df
parent704db650a8edda85261585a42fab8713f3d363d8 (diff)
downloadelfutils-users/serhei/eu-stacktrace.tar.gz
README.eu-stacktrace: add link to discussion threadusers/serhei/eu-stacktrace
Also fixed a number of incorrectly named PERF_EVENT_* constants.
-rw-r--r--README.eu-stacktrace15
1 files changed, 10 insertions, 5 deletions
diff --git a/README.eu-stacktrace b/README.eu-stacktrace
index 38982791..7e83c3a0 100644
--- a/README.eu-stacktrace
+++ b/README.eu-stacktrace
@@ -1,9 +1,9 @@
# eu-stacktrace development branch
-eu-stacktrace is (will be) a utility to process a stream of stack
+eu-stacktrace is (will be) a utility to process a stream of raw stack
samples (such as those obtained from the Linux kernel's
-PERF_EVENT_SAMPLE facility) into a stream of stack traces (such as
-those obtained from PERF_EVENT_CALLCHAIN), freeing various profiling
+PERF_SAMPLE_STACK facility) into a stream of stack traces (such as
+those obtained from PERF_SAMPLE_CALLCHAIN), freeing various profiling
utilities from having to implement their own backtracing logic.
For the time being, eu-stacktrace is meant to be fed data from a
@@ -13,12 +13,17 @@ works as implementation proceeds.
The goal is to work with various profiler data formats. For the
prototype, Serhei is working to support sysprof's data format. We'd
like to adapt sysprof to distros compiled with omit-framepointer,
-which will require sysprof to consume PERF_EVENT_SAMPLE data. After
+which will require sysprof to consume PERF_SAMPLE_STACK data. After
that, supporting perf's native data format is an obvious prerequisite
for merging this branch into elfutils. Ideally, we would like for
eu-stacktrace to also convert between different profile data formats
(e.g. taking sysprof data as input and emitting perf data, and
-vice-versa).
+vice-versa), but this may be out-of-scope given the amount of code
+that would need to be written to handle profile data other than stack
+traces.
+
+Link to latest roadmap and discussion thread:
+- 2023/05 https://sourceware.org/pipermail/elfutils-devel/2023q2/006151.html
## build & run (for now)