Skip to contentSkip to conversation

perf script: add -S/--symbols documentation

PATCH Applied Ian Rogers 3 participants 3 messages Apr 2, 2020 – Apr 4, 2020 perf events

lore
Share & tools
lore

Ian Rogers

author reviewer
#0 lore raw

PATCH 1/1 perf script: add -S/--symbols documentation

Capture both that this option exists and that symbols can be hexadecimal addresses.

---
 tools/perf/Documentation/perf-script.txt | 8 ++++++++
 1 file changed, 8 insertions(+)
tools/perf/Documentation/perf-script.txt +8 -0
index 99a9853a11ba..963487e82edc 100644
@@ -412,6 +412,14 @@ include::itrace.txt[]
 --xed::
 	Run xed disassembler on output. Requires installing the xed disassembler.
 
+-S::
+--symbols=symbol[,symbol...]::
+	Only consider the listed symbols. Symbols are typically a name
+	but they may also be hexadecimal address.
+
+	For example, to select the symbol noploop or the address 0x4007a0:
+	perf script --symbols=noploop,0x4007a0
+
 --call-trace::
 	Show call stream for intel_pt traces. The CPUs are interleaved, but
 	can be filtered with -C.
Signature · 1 line
2.26.0.rc2.310.g2932bb562d-goog
#1 lore raw

Em Thu, Apr 02, 2020 at 10:41:30AM -0700, Ian Rogers escreveu:

Quoted 2 lines

Capture both that this option exists and that symbols can be hexadecimal addresses.

Thanks, applied.

Quoted 27 lines
---
 tools/perf/Documentation/perf-script.txt | 8 ++++++++
 1 file changed, 8 insertions(+)
tools/perf/Documentation/perf-script.txt +8 -0
index 99a9853a11ba..963487e82edc 100644
@@ -412,6 +412,14 @@ include::itrace.txt[]
 --xed::
 	Run xed disassembler on output. Requires installing the xed disassembler.
 
+-S::
+--symbols=symbol[,symbol...]::
+	Only consider the listed symbols. Symbols are typically a name
+	but they may also be hexadecimal address.
+
+	For example, to select the symbol noploop or the address 0x4007a0:
+	perf script --symbols=noploop,0x4007a0
+
 --call-trace::
 	Show call stream for intel_pt traces. The CPUs are interleaved, but
 	can be filtered with -C.
Signature · 1 line
2.26.0.rc2.310.g2932bb562d-goog
Signature · 1 line
- Arnaldo
merge bot Applied
#2 lore raw
In reply to Ian Rogers
The following commit has been merged into the perf/urgent branch of tip:

The following commit has been merged into the perf/urgent branch of tip:

Commit-ID:     628d736d913a490d587941e8f68392f2de17e37a
Gitweb:        https://git.kernel.org/tip/628d736d913a490d587941e8f68392f2de17e37a
Author:        Ian Rogers <[email protected]>
AuthorDate:    Thu, 02 Apr 2020 10:41:30 -07:00
Committer:     Arnaldo Carvalho de Melo <[email protected]>
CommitterDate: Fri, 03 Apr 2020 09:37:56 -03:00

perf script: add -S/--symbols documentation

Capture both that this option exists and that symbols can be hexadecimal addresses.

---
 tools/perf/Documentation/perf-script.txt | 8 ++++++++
 1 file changed, 8 insertions(+)
tools/perf/Documentation/perf-script.txt +8 -0
index 99a9853..963487e 100644
@@ -412,6 +412,14 @@ include::itrace.txt[]
 --xed::
 	Run xed disassembler on output. Requires installing the xed disassembler.
 
+-S::
+--symbols=symbol[,symbol...]::
+	Only consider the listed symbols. Symbols are typically a name
+	but they may also be hexadecimal address.
+
+	For example, to select the symbol noploop or the address 0x4007a0:
+	perf script --symbols=noploop,0x4007a0
+
 --call-trace::
 	Show call stream for intel_pt traces. The CPUs are interleaved, but
 	can be filtered with -C.