€•h      Œsphinx.addnodes”Œdocument”“”)”}”(Œ	rawsource”Œ ”Œchildren”]”(Œtranslations”ŒLanguagesNode”“”)”}”(hhh]”(h Œpending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ
attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ	refdomain”Œstd”Œreftype”Œdoc”Œ	reftarget”Œ2/translations/zh_CN/trace/coresight/coresight-perf”Œmodname”NŒ	classname”NŒrefexplicit”ˆuŒtagname”hhhubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ2/translations/zh_TW/trace/coresight/coresight-perf”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ2/translations/it_IT/trace/coresight/coresight-perf”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ2/translations/ja_JP/trace/coresight/coresight-perf”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ2/translations/ko_KR/trace/coresight/coresight-perf”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒPortuguese (Brazilian)”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ2/translations/pt_BR/trace/coresight/coresight-perf”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒSpanish”…””}”hh–sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ2/translations/sp_SP/trace/coresight/coresight-perf”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h
hhŒ	_document”hŒsource”NŒline”NubhŒcomment”“”)”}”(hŒ SPDX-License-Identifier: GPL-2.0”h]”hŒ SPDX-License-Identifier: GPL-2.0”…””}”hh·sbah}”(h]”h ]”h"]”h$]”h&]”Œ	xml:space”Œpreserve”uh1hµhhh²hh³ŒL/var/lib/git/docbuild/linux/Documentation/trace/coresight/coresight-perf.rst”h´KubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒCoreSight - Perf”h]”hŒCoreSight - Perf”…””}”(hhÏh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhhÊh²hh³hÇh´KubhŒblock_quote”“”)”}”(hŒR:Author:   Carsten Haitzler <carsten.haitzler@arm.com>
:Date:     June 29th, 2022
”h]”hŒ
field_list”“”)”}”(hhh]”(hŒfield”“”)”}”(hhh]”(hŒ
field_name”“”)”}”(hŒAuthor”h]”hŒAuthor”…””}”(hhïh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1híhhêh³hÇh´K ubhŒ
field_body”“”)”}”(hŒ+Carsten Haitzler <carsten.haitzler@arm.com>”h]”hŒ	paragraph”“”)”}”(hj  h]”(hŒCarsten Haitzler <”…””}”(hj  h²hh³Nh´NubhŒ	reference”“”)”}”(hŒcarsten.haitzler@arm.com”h]”hŒcarsten.haitzler@arm.com”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œmailto:carsten.haitzler@arm.com”uh1j  hj  ubhŒ>”…””}”(hj  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÇh´Khhÿubah}”(h]”h ]”h"]”h$]”h&]”uh1hýhhêubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèh³hÇh´Khhåubhé)”}”(hhh]”(hî)”}”(hŒDate”h]”hŒDate”…””}”(hj7  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1híhj4  h³hÇh´K ubhþ)”}”(hŒJune 29th, 2022
”h]”j  )”}”(hŒJune 29th, 2022”h]”hŒJune 29th, 2022”…””}”(hjI  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÇh´KhjE  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hýhj4  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hèh³hÇh´Khhåubeh}”(h]”h ]”h"]”h$]”h&]”uh1hãhhßubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KhhÊh²hubj  )”}”(hX
  Perf is able to locally access CoreSight trace data and store it to the
output perf data files. This data can then be later decoded to give the
instructions that were traced for debugging or profiling purposes. You
can log such data with a perf record command like::”h]”hX	  Perf is able to locally access CoreSight trace data and store it to the
output perf data files. This data can then be later decoded to give the
instructions that were traced for debugging or profiling purposes. You
can log such data with a perf record command like:”…””}”(hjo  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÇh´K
hhÊh²hubhŒliteral_block”“”)”}”(hŒ#perf record -e cs_etm//u testbinary”h]”hŒ#perf record -e cs_etm//u testbinary”…””}”hj  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j}  h³hÇh´KhhÊh²hubj  )”}”(hŒðThis would run some test binary (testbinary) until it exits and record
a perf.data trace file. That file would have AUX sections if CoreSight
is working correctly. You can dump the content of this file as
readable text with a command like::”h]”hŒïThis would run some test binary (testbinary) until it exits and record
a perf.data trace file. That file would have AUX sections if CoreSight
is working correctly. You can dump the content of this file as
readable text with a command like:”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÇh´KhhÊh²hubj~  )”}”(hŒ'perf report --stdio --dump -i perf.data”h]”hŒ'perf report --stdio --dump -i perf.data”…””}”hj›  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j}  h³hÇh´KhhÊh²hubj  )”}”(hŒFYou should find some sections of this file have AUX data blocks like::”h]”hŒEYou should find some sections of this file have AUX data blocks like:”…””}”(hj©  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÇh´KhhÊh²hubj~  )”}”(hX  0x1e78 [0x30]: PERF_RECORD_AUXTRACE size: 0x11dd0  offset: 0  ref: 0x1b614fc1061b0ad1  idx: 0  tid: 531230  cpu: -1

. ... CoreSight ETM Trace data: size 73168 bytes
        Idx:0; ID:10;   I_ASYNC : Alignment Synchronisation.
          Idx:12; ID:10;  I_TRACE_INFO : Trace Info.; INFO=0x0 { CC.0 }
          Idx:17; ID:10;  I_ADDR_L_64IS0 : Address, Long, 64 bit, IS0.; Addr=0x0000000000000000;
          Idx:26; ID:10;  I_TRACE_ON : Trace On.
          Idx:27; ID:10;  I_ADDR_CTXT_L_64IS0 : Address & Context, Long, 64 bit, IS0.; Addr=0x0000FFFFB6069140; Ctxt: AArch64,EL0, NS;
          Idx:38; ID:10;  I_ATOM_F6 : Atom format 6.; EEEEEEEEEEEEEEEEEEEEEEEE
          Idx:39; ID:10;  I_ATOM_F6 : Atom format 6.; EEEEEEEEEEEEEEEEEEEEEEEE
          Idx:40; ID:10;  I_ATOM_F6 : Atom format 6.; EEEEEEEEEEEEEEEEEEEEEEEE
          Idx:41; ID:10;  I_ATOM_F6 : Atom format 6.; EEEEEEEEEEEN
          ...”h]”hX  0x1e78 [0x30]: PERF_RECORD_AUXTRACE size: 0x11dd0  offset: 0  ref: 0x1b614fc1061b0ad1  idx: 0  tid: 531230  cpu: -1

. ... CoreSight ETM Trace data: size 73168 bytes
        Idx:0; ID:10;   I_ASYNC : Alignment Synchronisation.
          Idx:12; ID:10;  I_TRACE_INFO : Trace Info.; INFO=0x0 { CC.0 }
          Idx:17; ID:10;  I_ADDR_L_64IS0 : Address, Long, 64 bit, IS0.; Addr=0x0000000000000000;
          Idx:26; ID:10;  I_TRACE_ON : Trace On.
          Idx:27; ID:10;  I_ADDR_CTXT_L_64IS0 : Address & Context, Long, 64 bit, IS0.; Addr=0x0000FFFFB6069140; Ctxt: AArch64,EL0, NS;
          Idx:38; ID:10;  I_ATOM_F6 : Atom format 6.; EEEEEEEEEEEEEEEEEEEEEEEE
          Idx:39; ID:10;  I_ATOM_F6 : Atom format 6.; EEEEEEEEEEEEEEEEEEEEEEEE
          Idx:40; ID:10;  I_ATOM_F6 : Atom format 6.; EEEEEEEEEEEEEEEEEEEEEEEE
          Idx:41; ID:10;  I_ATOM_F6 : Atom format 6.; EEEEEEEEEEEN
          ...”…””}”hj·  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j}  h³hÇh´KhhÊh²hubj  )”}”(hŒMIf you see these above, then your system is tracing CoreSight data
correctly.”h]”hŒMIf you see these above, then your system is tracing CoreSight data
correctly.”…””}”(hjÅ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÇh´K(hhÊh²hubj  )”}”(hŒGTo compile perf with CoreSight support in the tools/perf directory do::”h]”hŒFTo compile perf with CoreSight support in the tools/perf directory do:”…””}”(hjÓ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÇh´K+hhÊh²hubj~  )”}”(hŒmake CORESIGHT=1”h]”hŒmake CORESIGHT=1”…””}”hjá  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j}  h³hÇh´K-hhÊh²hubj  )”}”(hŒ¾This requires OpenCSD to build. You may install distribution packages
for the support such as libopencsd and libopencsd-dev or download it
and build yourself. Upstream OpenCSD is located at:”h]”hŒ¾This requires OpenCSD to build. You may install distribution packages
for the support such as libopencsd and libopencsd-dev or download it
and build yourself. Upstream OpenCSD is located at:”…””}”(hjï  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÇh´K/hhÊh²hubhÞ)”}”(hŒ"https://github.com/Linaro/OpenCSD
”h]”j  )”}”(hŒ!https://github.com/Linaro/OpenCSD”h]”j  )”}”(hj  h]”hŒ!https://github.com/Linaro/OpenCSD”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”j  uh1j  hj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÇh´K3hjý  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K3hhÊh²hubj  )”}”(hŒbFor complete information on building perf with CoreSight support and
more extensive usage look at:”h]”hŒbFor complete information on building perf with CoreSight support and
more extensive usage look at:”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÇh´K5hhÊh²hubhÞ)”}”(hŒ8https://github.com/Linaro/OpenCSD/blob/master/HOWTO.md

”h]”j  )”}”(hŒ6https://github.com/Linaro/OpenCSD/blob/master/HOWTO.md”h]”j  )”}”(hj3  h]”hŒ6https://github.com/Linaro/OpenCSD/blob/master/HOWTO.md”…””}”(hj5  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”j3  uh1j  hj1  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÇh´K8hj-  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K8hhÊh²hubhÉ)”}”(hhh]”(hÎ)”}”(hŒKernel CoreSight Support”h]”hŒKernel CoreSight Support”…””}”(hjR  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjO  h²hh³hÇh´K<ubj  )”}”(hŒ_You will also want CoreSight support enabled in your kernel config.
Ensure it is enabled with::”h]”hŒ^You will also want CoreSight support enabled in your kernel config.
Ensure it is enabled with:”…””}”(hj`  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÇh´K>hjO  h²hubj~  )”}”(hŒCONFIG_CORESIGHT=y”h]”hŒCONFIG_CORESIGHT=y”…””}”hjn  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j}  h³hÇh´KAhjO  h²hubj  )”}”(hŒOThere are various other CoreSight options you probably also want
enabled like::”h]”hŒNThere are various other CoreSight options you probably also want
enabled like:”…””}”(hj|  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÇh´KChjO  h²hubj~  )”}”(hŒúCONFIG_CORESIGHT_LINKS_AND_SINKS=y
CONFIG_CORESIGHT_LINK_AND_SINK_TMC=y
CONFIG_CORESIGHT_CATU=y
CONFIG_CORESIGHT_SINK_TPIU=y
CONFIG_CORESIGHT_SINK_ETBV10=y
CONFIG_CORESIGHT_SOURCE_ETM4X=y
CONFIG_CORESIGHT_CTI=y
CONFIG_CORESIGHT_CTI_INTEGRATION_REGS=y”h]”hŒúCONFIG_CORESIGHT_LINKS_AND_SINKS=y
CONFIG_CORESIGHT_LINK_AND_SINK_TMC=y
CONFIG_CORESIGHT_CATU=y
CONFIG_CORESIGHT_SINK_TPIU=y
CONFIG_CORESIGHT_SINK_ETBV10=y
CONFIG_CORESIGHT_SOURCE_ETM4X=y
CONFIG_CORESIGHT_CTI=y
CONFIG_CORESIGHT_CTI_INTEGRATION_REGS=y”…””}”hjŠ  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j}  h³hÇh´KFhjO  h²hubj  )”}”(hŒCPlease refer to the kernel configuration help for more information.”h]”hŒCPlease refer to the kernel configuration help for more information.”…””}”(hj˜  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÇh´KOhjO  h²hubeh}”(h]”Œkernel-coresight-support”ah ]”h"]”Œkernel coresight support”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´K<ubhÉ)”}”(hhh]”(hÎ)”}”(hŒ.Fine-grained tracing with AUX pause and resume”h]”hŒ.Fine-grained tracing with AUX pause and resume”…””}”(hj±  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj®  h²hh³hÇh´KRubj  )”}”(hX  Arm CoreSight may generate a large amount of hardware trace data, which
will lead to overhead in recording and distract users when reviewing
profiling result. To mitigate the issue of excessive trace data, Perf
provides AUX pause and resume functionality for fine-grained tracing.”h]”hX  Arm CoreSight may generate a large amount of hardware trace data, which
will lead to overhead in recording and distract users when reviewing
profiling result. To mitigate the issue of excessive trace data, Perf
provides AUX pause and resume functionality for fine-grained tracing.”…””}”(hj¿  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÇh´KThj®  h²hubj  )”}”(hX  The AUX pause and resume can be triggered by associated events. These
events can be ftrace tracepoints (including static and dynamic
tracepoints) or PMU events (e.g. CPU PMU cycle event). To create a perf
session with AUX pause / resume, three configuration terms are
introduced:”h]”hX  The AUX pause and resume can be triggered by associated events. These
events can be ftrace tracepoints (including static and dynamic
tracepoints) or PMU events (e.g. CPU PMU cycle event). To create a perf
session with AUX pause / resume, three configuration terms are
introduced:”…””}”(hjÍ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÇh´KYhj®  h²hubhŒbullet_list”“”)”}”(hhh]”(hŒ	list_item”“”)”}”(hŒ`"aux-action=start-paused": it is specified for the cs_etm PMU event to
launch in a paused state.”h]”j  )”}”(hŒ`"aux-action=start-paused": it is specified for the cs_etm PMU event to
launch in a paused state.”h]”hŒdâ€œaux-action=start-pausedâ€: it is specified for the cs_etm PMU event to
launch in a paused state.”…””}”(hjæ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÇh´K_hjâ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jà  hjÝ  h²hh³hÇh´Nubjá  )”}”(hŒW"aux-action=pause": an associated event is specified with this term
to pause AUX trace.”h]”j  )”}”(hŒW"aux-action=pause": an associated event is specified with this term
to pause AUX trace.”h]”hŒ[â€œaux-action=pauseâ€: an associated event is specified with this term
to pause AUX trace.”…””}”(hjþ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÇh´Kahjú  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jà  hjÝ  h²hh³hÇh´Nubjá  )”}”(hŒZ"aux-action=resume": an associated event is specified with this term
to resume AUX trace.
”h]”j  )”}”(hŒY"aux-action=resume": an associated event is specified with this term
to resume AUX trace.”h]”hŒ]â€œaux-action=resumeâ€: an associated event is specified with this term
to resume AUX trace.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÇh´Kchj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jà  hjÝ  h²hh³hÇh´Nubeh}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ-”uh1jÛ  h³hÇh´K_hj®  h²hubj  )”}”(hŒEExample for triggering AUX pause and resume with ftrace tracepoints::”h]”hŒDExample for triggering AUX pause and resume with ftrace tracepoints:”…””}”(hj2  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÇh´Kfhj®  h²hubj~  )”}”(hŒŠperf record -e cs_etm/aux-action=start-paused/k,syscalls:sys_enter_openat/aux-action=resume/,syscalls:sys_exit_openat/aux-action=pause/ ls”h]”hŒŠperf record -e cs_etm/aux-action=start-paused/k,syscalls:sys_enter_openat/aux-action=resume/,syscalls:sys_exit_openat/aux-action=pause/ ls”…””}”hj@  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j}  h³hÇh´Khhj®  h²hubj  )”}”(hŒ<Example for triggering AUX pause and resume with PMU event::”h]”hŒ;Example for triggering AUX pause and resume with PMU event:”…””}”(hjN  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÇh´Kjhj®  h²hubj~  )”}”(hŒ¥perf record -a -e cs_etm/aux-action=start-paused/k \
      -e cycles/aux-action=pause,period=10000000/ \
      -e cycles/aux-action=resume,period=1050000/ -- sleep 1”h]”hŒ¥perf record -a -e cs_etm/aux-action=start-paused/k \
      -e cycles/aux-action=pause,period=10000000/ \
      -e cycles/aux-action=resume,period=1050000/ -- sleep 1”…””}”hj\  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j}  h³hÇh´Klhj®  h²hubeh}”(h]”Œ.fine-grained-tracing-with-aux-pause-and-resume”ah ]”h"]”Œ.fine-grained tracing with aux pause and resume”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´KRubhÉ)”}”(hhh]”(hÎ)”}”(hŒ;Perf test - Verify kernel and userspace perf CoreSight work”h]”hŒ;Perf test - Verify kernel and userspace perf CoreSight work”…””}”(hju  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjr  h²hh³hÇh´Kqubj  )”}”(hX  When you run perf test, it will do a lot of self tests. Some of those
tests will cover CoreSight (only if enabled and on ARM64). You
generally would run perf test from the tools/perf directory in the
kernel tree. Some tests will check some internal perf support like:”h]”hX  When you run perf test, it will do a lot of self tests. Some of those
tests will cover CoreSight (only if enabled and on ARM64). You
generally would run perf test from the tools/perf directory in the
kernel tree. Some tests will check some internal perf support like:”…””}”(hjƒ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÇh´Kshjr  h²hubhÞ)”}”(hŒ|Check Arm CoreSight trace data recording and synthesized samples
Check Arm SPE trace data recording and synthesized samples
”h]”j  )”}”(hŒ{Check Arm CoreSight trace data recording and synthesized samples
Check Arm SPE trace data recording and synthesized samples”h]”hŒ{Check Arm CoreSight trace data recording and synthesized samples
Check Arm SPE trace data recording and synthesized samples”…””}”(hj•  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÇh´Kxhj‘  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Kxhjr  h²hubj  )”}”(hX  Some others will actually use perf record and some test binaries that
are in tests/shell/coresight and will collect traces to ensure a
minimum level of functionality is met. The scripts that launch these
tests are in the same directory. These will all look like:”h]”hX  Some others will actually use perf record and some test binaries that
are in tests/shell/coresight and will collect traces to ensure a
minimum level of functionality is met. The scripts that launch these
tests are in the same directory. These will all look like:”…””}”(hj©  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÇh´K{hjr  h²hubhÞ)”}”(hŒpCoreSight / ASM Pure Loop
CoreSight / Memcpy 16k 10 Threads
CoreSight / Thread Loop 10 Threads - Check TID
etc.
”h]”j  )”}”(hŒoCoreSight / ASM Pure Loop
CoreSight / Memcpy 16k 10 Threads
CoreSight / Thread Loop 10 Threads - Check TID
etc.”h]”hŒoCoreSight / ASM Pure Loop
CoreSight / Memcpy 16k 10 Threads
CoreSight / Thread Loop 10 Threads - Check TID
etc.”…””}”(hj»  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÇh´K€hj·  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K€hjr  h²hubj  )”}”(hX9  These perf record tests will not run if the tool binaries do not exist
in tests/shell/coresight/\*/ and will be skipped. If you do not have
CoreSight support in hardware then either do not build perf with
CoreSight support or remove these binaries in order to not have these
tests fail and have them skip instead.”h]”hX9  These perf record tests will not run if the tool binaries do not exist
in tests/shell/coresight/ */ and will be skipped. If you do not have
CoreSight support in hardware then either do not build perf with
CoreSight support or remove these binaries in order to not have these
tests fail and have them skip instead.”…””}”(hjÏ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÇh´K…hjr  h²hubj  )”}”(hŒThese tests will log historical results in the current working
directory (e.g. tools/perf) and will be named stats-\*.csv like:”h]”hŒThese tests will log historical results in the current working
directory (e.g. tools/perf) and will be named stats- *.csv like:”…””}”(hjÝ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÇh´K‹hjr  h²hubhÞ)”}”(hŒ?stats-asm_pure_loop-out.csv
stats-memcpy_thread-16k_10.csv
...
”h]”j  )”}”(hŒ>stats-asm_pure_loop-out.csv
stats-memcpy_thread-16k_10.csv
...”h]”hŒ>stats-asm_pure_loop-out.csv
stats-memcpy_thread-16k_10.csv
...”…””}”(hjï  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÇh´KŽhjë  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KŽhjr  h²hubj  )”}”(hXá  These statistic files log some aspects of the AUX data sections in
the perf data output counting some numbers of certain encodings (a
good way to know that it's working in a very simple way). One problem
with CoreSight is that given a large enough amount of data needing to
be logged, some of it can be lost due to the processor not waking up
in time to read out all the data from buffers etc.. You will notice
that the amount of data collected can vary a lot per run of perf test.
If you wish to see how this changes over time, simply run perf test
multiple times and all these csv files will have more and more data
appended to it that you can later examine, graph and otherwise use to
figure out if things have become worse or better.”h]”hXã  These statistic files log some aspects of the AUX data sections in
the perf data output counting some numbers of certain encodings (a
good way to know that itâ€™s working in a very simple way). One problem
with CoreSight is that given a large enough amount of data needing to
be logged, some of it can be lost due to the processor not waking up
in time to read out all the data from buffers etc.. You will notice
that the amount of data collected can vary a lot per run of perf test.
If you wish to see how this changes over time, simply run perf test
multiple times and all these csv files will have more and more data
appended to it that you can later examine, graph and otherwise use to
figure out if things have become worse or better.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÇh´K’hjr  h²hubj  )”}”(hŒÜThis means sometimes these tests fail as they don't capture all the
data needed. This is about tracking quality and amount of data
produced over time and to see when changes to the Linux kernel improve
quality of traces.”h]”hŒÞThis means sometimes these tests fail as they donâ€™t capture all the
data needed. This is about tracking quality and amount of data
produced over time and to see when changes to the Linux kernel improve
quality of traces.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÇh´Kžhjr  h²hubj  )”}”(hŒŸBe aware that some of these tests take quite a while to run, specifically
in processing the perf data file and dumping contents to then examine what
is inside.”h]”hŒŸBe aware that some of these tests take quite a while to run, specifically
in processing the perf data file and dumping contents to then examine what
is inside.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÇh´K£hjr  h²hubj  )”}”(hŒŽYou can change where these csv logs are stored by setting the
PERF_TEST_CORESIGHT_STATDIR environment variable before running perf
test like::”h]”hŒYou can change where these csv logs are stored by setting the
PERF_TEST_CORESIGHT_STATDIR environment variable before running perf
test like:”…””}”(hj-  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÇh´K§hjr  h²hubj~  )”}”(hŒ5export PERF_TEST_CORESIGHT_STATDIR=/var/tmp
perf test”h]”hŒ5export PERF_TEST_CORESIGHT_STATDIR=/var/tmp
perf test”…””}”hj;  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j}  h³hÇh´K«hjr  h²hubj  )”}”(hŒdThey will also store resulting perf output data in the current
directory for later inspection like::”h]”hŒcThey will also store resulting perf output data in the current
directory for later inspection like:”…””}”(hjI  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÇh´K®hjr  h²hubj~  )”}”(hŒ>perf-asm_pure_loop-out.data
perf-memcpy_thread-16k_10.data
...”h]”hŒ>perf-asm_pure_loop-out.data
perf-memcpy_thread-16k_10.data
...”…””}”hjW  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j}  h³hÇh´K±hjr  h²hubj  )”}”(hŒ|You can alter where the perf data files are stored by setting the
PERF_TEST_CORESIGHT_DATADIR environment variable such as::”h]”hŒ{You can alter where the perf data files are stored by setting the
PERF_TEST_CORESIGHT_DATADIR environment variable such as:”…””}”(hje  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÇh´Kµhjr  h²hubj~  )”}”(hŒ.PERF_TEST_CORESIGHT_DATADIR=/var/tmp
perf test”h]”hŒ.PERF_TEST_CORESIGHT_DATADIR=/var/tmp
perf test”…””}”hjs  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j}  h³hÇh´K¸hjr  h²hubj  )”}”(hŒ¯You may wish to set these above environment variables if you wish to
keep the output of tests outside of the current working directory for
longer term storage and examination.”h]”hŒ¯You may wish to set these above environment variables if you wish to
keep the output of tests outside of the current working directory for
longer term storage and examination.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  h³hÇh´K»hjr  h²hubeh}”(h]”Œ9perf-test-verify-kernel-and-userspace-perf-coresight-work”ah ]”h"]”Œ;perf test - verify kernel and userspace perf coresight work”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´Kqubeh}”(h]”Œcoresight-perf”ah ]”h"]”Œcoresight - perf”ah$]”h&]”uh1hÈhhh²hh³hÇh´Kubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”hÇuh1hŒcurrent_source”NŒcurrent_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(hÍNŒ	generator”NŒ	datestamp”NŒsource_link”NŒ
source_url”NŒtoc_backlinks”Œentry”Œfootnote_backlinks”KŒsectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒstrip_classes”NŒreport_level”KŒ
halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ	traceback”ˆŒinput_encoding”Œ	utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”jÂ  Œerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œlanguage_code”Œen”Œrecord_dependencies”NŒconfig”NŒ	id_prefix”hŒauto_id_prefix”Œid”Œdump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”hÇŒ_destination”NŒ_config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒraw_enabled”KŒline_length_limit”M'Œpep_references”NŒpep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒrfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ	tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œsmart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œdocinfo_xform”KŒsectsubtitle_xform”‰Œimage_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”Œnameids”}”(jœ  j™  j«  j¨  jo  jl  j”  j‘  uŒ	nametypes”}”(jœ  ‰j«  ‰jo  ‰j”  ‰uh}”(j™  hÊj¨  jO  jl  j®  j‘  jr  uŒfootnote_refs”}”Œcitation_refs”}”Œautofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ	footnotes”]”Œ	citations”]”Œautofootnote_start”KŒsymbol_footnote_start”K Œ
id_counter”Œcollections”ŒCounter”“”}”…”R”Œparse_messages”]”Œtransform_messages”]”Œtransformer”NŒinclude_log”]”Œ
decoration”Nh²hub.