€•g      Œ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”Œ(/translations/zh_CN/arch/powerpc/vpa-dtl”Œ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”Œ(/translations/zh_TW/arch/powerpc/vpa-dtl”Œ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”Œ(/translations/it_IT/arch/powerpc/vpa-dtl”Œ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”Œ(/translations/ja_JP/arch/powerpc/vpa-dtl”Œ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”Œ(/translations/ko_KR/arch/powerpc/vpa-dtl”Œ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”Œ(/translations/sp_SP/arch/powerpc/vpa-dtl”Œ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ŸŒB/var/lib/git/docbuild/linux/Documentation/arch/powerpc/vpa-dtl.rst”h KubhŒtarget”“”)”}”(hŒ.. _vpa-dtl:”h]”h}”(h]”h ]”h"]”h$]”h&]”Œrefid”Œvpa-dtl”uh1h´h KhhhžhhŸh³ubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒDTL (Dispatch Trace Log)”h]”hŒDTL (Dispatch Trace Log)”…””}”(hhÉhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”hÀŒid1”uh1hÇhhÄhžhhŸh³h KubhŒ	paragraph”“”)”}”(hŒAthira Rajeev, 19 April 2025”h]”hŒAthira Rajeev, 19 April 2025”…””}”(hhÚhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hØhŸh³h KhhÄhžhubhŒtopic”“”)”}”(hŒ
Contents

”h]”(hÈ)”}”(hŒContents”h]”hŒContents”…””}”(hhîhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhhêhŸh³h KubhŒbullet_list”“”)”}”(hhh]”hŒ	list_item”“”)”}”(hhh]”(hÙ)”}”(hhh]”hŒ	reference”“”)”}”(hhh]”hŒDTL (Dispatch Trace Log)”…””}”(hj  hžhhŸNh Nubah}”(h]”h×ah ]”h"]”h$]”h&]”Œrefid”Œdtl-dispatch-trace-log”uh1j	  hj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hØhj  ubhý)”}”(hhh]”(j  )”}”(hhh]”hÙ)”}”(hhh]”j
  )”}”(hhh]”hŒBasic overview”…””}”(hj)  hžhhŸNh Nubah}”(h]”Œid2”ah ]”h"]”h$]”h&]”Œrefid”Œbasic-overview”uh1j	  hj&  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hØhj#  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj   ubj  )”}”(hhh]”hÙ)”}”(hhh]”j
  )”}”(hhh]”hŒInfrastructure used”…””}”(hjK  hžhhŸNh Nubah}”(h]”Œid3”ah ]”h"]”h$]”h&]”Œrefid”Œinfrastructure-used”uh1j	  hjH  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hØhjE  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj   ubj  )”}”(hhh]”hÙ)”}”(hhh]”j
  )”}”(hhh]”hŒvpa-dtl PMU example usage”…””}”(hjm  hžhhŸNh Nubah}”(h]”Œid4”ah ]”h"]”h$]”h&]”Œrefid”Œvpa-dtl-pmu-example-usage”uh1j	  hjj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hØhjg  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj   ubj  )”}”(hhh]”hÙ)”}”(hhh]”j
  )”}”(hhh]”hŒ9Visualize the dispatch trace log entries with perf report”…””}”(hj  hžhhŸNh Nubah}”(h]”Œid5”ah ]”h"]”h$]”h&]”Œrefid”Œ9visualize-the-dispatch-trace-log-entries-with-perf-report”uh1j	  hjŒ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hØhj‰  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj   ubj  )”}”(hhh]”hÙ)”}”(hhh]”j
  )”}”(hhh]”hŒ9Visualize the dispatch trace log entries with perf script”…””}”(hj±  hžhhŸNh Nubah}”(h]”Œid6”ah ]”h"]”h$]”h&]”Œrefid”Œ9visualize-the-dispatch-trace-log-entries-with-perf-script”uh1j	  hj®  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hØhj«  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj   ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hühj  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j  hhþubah}”(h]”h ]”h"]”h$]”h&]”uh1hühhêhžhhŸNh Nubeh}”(h]”Œcontents”ah ]”Œcontents”ah"]”Œcontents”ah$]”h&]”uh1hèhŸh³h KhhÄhžhubhÃ)”}”(hhh]”(hÈ)”}”(hŒBasic overview”h]”hŒBasic overview”…””}”(hjë  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”hÀj2  uh1hÇhjè  hžhhŸh³h KubhÙ)”}”(hX`  The pseries Shared Processor Logical Partition(SPLPAR) machines can
retrieve a log of dispatch and preempt events from the hypervisor
using data from Disptach Trace Log(DTL) buffer. With this information,
user can retrieve when and why each dispatch & preempt has occurred.
The vpa-dtl PMU exposes the Virtual Processor Area(VPA) DTL counters
via perf.”h]”hX`  The pseries Shared Processor Logical Partition(SPLPAR) machines can
retrieve a log of dispatch and preempt events from the hypervisor
using data from Disptach Trace Log(DTL) buffer. With this information,
user can retrieve when and why each dispatch & preempt has occurred.
The vpa-dtl PMU exposes the Virtual Processor Area(VPA) DTL counters
via perf.”…””}”(hjù  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hØhŸh³h Khjè  hžhubeh}”(h]”j8  ah ]”h"]”Œbasic overview”ah$]”h&]”uh1hÂhhÄhžhhŸh³h KubhÃ)”}”(hhh]”(hÈ)”}”(hŒInfrastructure used”h]”hŒInfrastructure used”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”hÀjT  uh1hÇhj  hžhhŸh³h KubhÙ)”}”(hXÊ  The VPA DTL PMU counters do not interrupt on overflow or generate any
PMI interrupts. Therefore, hrtimer is used to poll the DTL data. The timer
nterval can be provided by user via sample_period field in nano seconds.
vpa dtl pmu has one hrtimer added per vpa-dtl pmu thread. DTL (Dispatch
Trace Log) contains information about dispatch/preempt, enqueue time etc.
We directly copy the DTL buffer data as part of auxiliary buffer and it
will be processed later. This will avoid time taken to create samples
in the kernel space. The PMU driver collecting Dispatch Trace Log (DTL)
entries makes use of AUX support in perf infrastructure. On the tools side,
this data is made available as PERF_RECORD_AUXTRACE records.”h]”hXÊ  The VPA DTL PMU counters do not interrupt on overflow or generate any
PMI interrupts. Therefore, hrtimer is used to poll the DTL data. The timer
nterval can be provided by user via sample_period field in nano seconds.
vpa dtl pmu has one hrtimer added per vpa-dtl pmu thread. DTL (Dispatch
Trace Log) contains information about dispatch/preempt, enqueue time etc.
We directly copy the DTL buffer data as part of auxiliary buffer and it
will be processed later. This will avoid time taken to create samples
in the kernel space. The PMU driver collecting Dispatch Trace Log (DTL)
entries makes use of AUX support in perf infrastructure. On the tools side,
this data is made available as PERF_RECORD_AUXTRACE records.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hØhŸh³h Khj  hžhubhÙ)”}”(hXÂ  To correlate each DTL entry with other events across CPU's, an auxtrace_queue
is created for each CPU. Each auxtrace queue has a array/list of auxtrace buffers.
All auxtrace queues is maintained in auxtrace heap. The queues are sorted
based on timestamp. When the different PERF_RECORD_XX records are processed,
compare the timestamp of perf record with timestamp of top element in the
auxtrace heap so that DTL events can be co-related with other events
Process the auxtrace queue if the timestamp of element from heap is
lower than timestamp from entry in perf record. Sometimes it could happen that
one buffer is only partially processed. if the timestamp of occurrence of
another event is more than currently processed element in the queue, it will
move on to next perf record. So keep track of position of buffer to continue
processing next time. Update the timestamp of the auxtrace heap with the timestamp
of last processed entry from the auxtrace buffer.”h]”hXÄ  To correlate each DTL entry with other events across CPUâ€™s, an auxtrace_queue
is created for each CPU. Each auxtrace queue has a array/list of auxtrace buffers.
All auxtrace queues is maintained in auxtrace heap. The queues are sorted
based on timestamp. When the different PERF_RECORD_XX records are processed,
compare the timestamp of perf record with timestamp of top element in the
auxtrace heap so that DTL events can be co-related with other events
Process the auxtrace queue if the timestamp of element from heap is
lower than timestamp from entry in perf record. Sometimes it could happen that
one buffer is only partially processed. if the timestamp of occurrence of
another event is more than currently processed element in the queue, it will
move on to next perf record. So keep track of position of buffer to continue
processing next time. Update the timestamp of the auxtrace heap with the timestamp
of last processed entry from the auxtrace buffer.”…””}”(hj-  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hØhŸh³h K&hj  hžhubhÙ)”}”(hŒzThis infrastructure ensures dispatch trace log entries can be correlated
and presented along with other events like sched.”h]”hŒzThis infrastructure ensures dispatch trace log entries can be correlated
and presented along with other events like sched.”…””}”(hj;  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hØhŸh³h K4hj  hžhubeh}”(h]”jZ  ah ]”h"]”Œinfrastructure used”ah$]”h&]”uh1hÂhhÄhžhhŸh³h KubhÃ)”}”(hhh]”(hÈ)”}”(hŒvpa-dtl PMU example usage”h]”hŒvpa-dtl PMU example usage”…””}”(hjS  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”hÀjv  uh1hÇhjP  hžhhŸh³h K8ubhŒliteral_block”“”)”}”(hŒe# ls /sys/devices/vpa_dtl/
events  format  perf_event_mux_interval_ms  power  subsystem  type  uevent”h]”hŒe# ls /sys/devices/vpa_dtl/
events  format  perf_event_mux_interval_ms  power  subsystem  type  uevent”…””}”hjc  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²Œforce”‰Œlanguage”Œsh”Œhighlight_args”}”uh1ja  hŸh³h K:hjP  hžhubhÙ)”}”(hŒ=To capture the DTL data using perf record:
.. code-block:: sh”h]”hŒ=To capture the DTL data using perf record:
.. code-block:: sh”…””}”(hjv  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hØhŸh³h K@hjP  hžhubhŒblock_quote”“”)”}”(hŒF# ./perf record -a -e sched:\*,vpa_dtl/dtl_all/ -c 1000000000 sleep 1
”h]”hÙ)”}”(hŒE# ./perf record -a -e sched:\*,vpa_dtl/dtl_all/ -c 1000000000 sleep 1”h]”hŒE# ./perf record -a -e sched: *,vpa_dtl/dtl_all/ -c 1000000000 sleep 1”…””}”(hjŠ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hØhŸh³h KChj†  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j„  hŸh³h KChjP  hžhubhÙ)”}”(hŒJThe result can be interpreted using perf record. Snippet of perf report -D”h]”hŒJThe result can be interpreted using perf record. Snippet of perf report -D”…””}”(hjž  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hØhŸh³h KEhjP  hžhubjb  )”}”(hŒ# ./perf report -D”h]”hŒ# ./perf report -D”…””}”hj¬  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²jq  ‰jr  Œsh”jt  }”uh1ja  hŸh³h KGhjP  hžhubhÙ)”}”(hŒgThere are different PERF_RECORD_XX records. In that records corresponding to
auxtrace buffers includes:”h]”hŒgThere are different PERF_RECORD_XX records. In that records corresponding to
auxtrace buffers includes:”…””}”(hj¼  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hØhŸh³h KKhjP  hžhubhŒenumerated_list”“”)”}”(hhh]”(j  )”}”(hŒ?PERF_RECORD_AUX
Conveys that new data is available in AUX area
”h]”hÙ)”}”(hŒ>PERF_RECORD_AUX
Conveys that new data is available in AUX area”h]”hŒ>PERF_RECORD_AUX
Conveys that new data is available in AUX area”…””}”(hjÓ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hØhŸh³h KNhjÏ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hjÌ  hžhhŸh³h Nubj  )”}”(hŒTPERF_RECORD_AUXTRACE_INFO
Describes offset and size of auxtrace data in the buffers
”h]”hÙ)”}”(hŒSPERF_RECORD_AUXTRACE_INFO
Describes offset and size of auxtrace data in the buffers”h]”hŒSPERF_RECORD_AUXTRACE_INFO
Describes offset and size of auxtrace data in the buffers”…””}”(hjë  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hØhŸh³h KQhjç  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hjÌ  hžhhŸh³h Nubj  )”}”(hŒ…PERF_RECORD_AUXTRACE
This is the record that defines the auxtrace data which here in case of
vpa-dtl pmu is dispatch trace log data.
”h]”hÙ)”}”(hŒ„PERF_RECORD_AUXTRACE
This is the record that defines the auxtrace data which here in case of
vpa-dtl pmu is dispatch trace log data.”h]”hŒ„PERF_RECORD_AUXTRACE
This is the record that defines the auxtrace data which here in case of
vpa-dtl pmu is dispatch trace log data.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hØhŸh³h KThjÿ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hjÌ  hžhhŸh³h Nubeh}”(h]”h ]”h"]”h$]”h&]”Œenumtype”Œarabic”Œprefix”hŒsuffix”Œ.”uh1jÊ  hjP  hžhhŸh³h KNubhÙ)”}”(hŒASnippet from perf report -D showing the PERF_RECORD_AUXTRACE dump”h]”hŒASnippet from perf report -D showing the PERF_RECORD_AUXTRACE dump”…””}”(hj"  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hØhŸh³h KXhjP  hžhubjb  )”}”(hhh]”h}”(h]”h ]”h"]”h$]”h&]”h±h²jq  ‰jr  Œsh”jt  }”uh1ja  hŸh³h KZhjP  hžhubhÙ)”}”(hX»  0 0 0x39b10 [0x30]: PERF_RECORD_AUXTRACE size: 0x690  offset: 0  ref: 0  idx: 0  tid: -1  cpu: 0
.
. ... VPA DTL PMU data: size 1680 bytes, entries is 35
.  00000000: boot_tb: 21349649546353231, tb_freq: 512000000
.  00000030: dispatch_reason:decrementer interrupt, preempt_reason:H_CEDE, enqueue_to_dispatch_time:7064, ready_to_enqueue_time:187, waiting_to_ready_time:6611773
.  00000060: dispatch_reason:priv doorbell, preempt_reason:H_CEDE, enqueue_to_dispatch_time:146, ready_to_enqueue_time:0, waiting_to_ready_time:15359437
.  00000090: dispatch_reason:decrementer interrupt, preempt_reason:H_CEDE, enqueue_to_dispatch_time:4868, ready_to_enqueue_time:232, waiting_to_ready_time:5100709
.  000000c0: dispatch_reason:priv doorbell, preempt_reason:H_CEDE, enqueue_to_dispatch_time:179, ready_to_enqueue_time:0, waiting_to_ready_time:30714243
.  000000f0: dispatch_reason:priv doorbell, preempt_reason:H_CEDE, enqueue_to_dispatch_time:197, ready_to_enqueue_time:0, waiting_to_ready_time:15350648
.  00000120: dispatch_reason:priv doorbell, preempt_reason:H_CEDE, enqueue_to_dispatch_time:213, ready_to_enqueue_time:0, waiting_to_ready_time:15353446
.  00000150: dispatch_reason:priv doorbell, preempt_reason:H_CEDE, enqueue_to_dispatch_time:212, ready_to_enqueue_time:0, waiting_to_ready_time:15355126
.  00000180: dispatch_reason:decrementer interrupt, preempt_reason:H_CEDE, enqueue_to_dispatch_time:6368, ready_to_enqueue_time:164, waiting_to_ready_time:5104665”h]”hX»  0 0 0x39b10 [0x30]: PERF_RECORD_AUXTRACE size: 0x690  offset: 0  ref: 0  idx: 0  tid: -1  cpu: 0
.
. ... VPA DTL PMU data: size 1680 bytes, entries is 35
.  00000000: boot_tb: 21349649546353231, tb_freq: 512000000
.  00000030: dispatch_reason:decrementer interrupt, preempt_reason:H_CEDE, enqueue_to_dispatch_time:7064, ready_to_enqueue_time:187, waiting_to_ready_time:6611773
.  00000060: dispatch_reason:priv doorbell, preempt_reason:H_CEDE, enqueue_to_dispatch_time:146, ready_to_enqueue_time:0, waiting_to_ready_time:15359437
.  00000090: dispatch_reason:decrementer interrupt, preempt_reason:H_CEDE, enqueue_to_dispatch_time:4868, ready_to_enqueue_time:232, waiting_to_ready_time:5100709
.  000000c0: dispatch_reason:priv doorbell, preempt_reason:H_CEDE, enqueue_to_dispatch_time:179, ready_to_enqueue_time:0, waiting_to_ready_time:30714243
.  000000f0: dispatch_reason:priv doorbell, preempt_reason:H_CEDE, enqueue_to_dispatch_time:197, ready_to_enqueue_time:0, waiting_to_ready_time:15350648
.  00000120: dispatch_reason:priv doorbell, preempt_reason:H_CEDE, enqueue_to_dispatch_time:213, ready_to_enqueue_time:0, waiting_to_ready_time:15353446
.  00000150: dispatch_reason:priv doorbell, preempt_reason:H_CEDE, enqueue_to_dispatch_time:212, ready_to_enqueue_time:0, waiting_to_ready_time:15355126
.  00000180: dispatch_reason:decrementer interrupt, preempt_reason:H_CEDE, enqueue_to_dispatch_time:6368, ready_to_enqueue_time:164, waiting_to_ready_time:5104665”…””}”(hj;  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hØhŸh³h K\hjP  hžhubhÙ)”}”(hŒ5Above is representation of dtl entry of below format:”h]”hŒ5Above is representation of dtl entry of below format:”…””}”(hjI  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hØhŸh³h KihjP  hžhubhŒdefinition_list”“”)”}”(hhh]”hŒdefinition_list_item”“”)”}”(hŒüstruct dtl_entry {
u8      dispatch_reason;
u8      preempt_reason;
u16     processor_id;
u32     enqueue_to_dispatch_time;
u32     ready_to_enqueue_time;
u32     waiting_to_ready_time;
u64     timebase;
u64     fault_addr;
u64     srr0;
u64     srr1;
”h]”(hŒterm”“”)”}”(hŒstruct dtl_entry {”h]”hŒstruct dtl_entry {”…””}”(hjd  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jb  hŸh³h Kuhj^  ubhŒ
definition”“”)”}”(hhh]”hÙ)”}”(hŒèu8      dispatch_reason;
u8      preempt_reason;
u16     processor_id;
u32     enqueue_to_dispatch_time;
u32     ready_to_enqueue_time;
u32     waiting_to_ready_time;
u64     timebase;
u64     fault_addr;
u64     srr0;
u64     srr1;”h]”hŒèu8      dispatch_reason;
u8      preempt_reason;
u16     processor_id;
u32     enqueue_to_dispatch_time;
u32     ready_to_enqueue_time;
u32     waiting_to_ready_time;
u64     timebase;
u64     fault_addr;
u64     srr0;
u64     srr1;”…””}”(hjw  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hØhŸh³h Klhjt  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jr  hj^  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j\  hŸh³h KuhjY  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jW  hjP  hžhhŸh³h NubhÙ)”}”(hŒ};”h]”hŒ};”…””}”(hj—  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hØhŸh³h KwhjP  hžhubhÙ)”}”(hŒ­First two fields represent the dispatch reason and preempt reason. The post
processing of PERF_RECORD_AUXTRACE records will translate to meaningful data
for user to consume.”h]”hŒ­First two fields represent the dispatch reason and preempt reason. The post
processing of PERF_RECORD_AUXTRACE records will translate to meaningful data
for user to consume.”…””}”(hj¥  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hØhŸh³h KyhjP  hžhubeh}”(h]”j|  ah ]”h"]”Œvpa-dtl pmu example usage”ah$]”h&]”uh1hÂhhÄhžhhŸh³h K8ubhÃ)”}”(hhh]”(hÈ)”}”(hŒ9Visualize the dispatch trace log entries with perf report”h]”hŒ9Visualize the dispatch trace log entries with perf report”…””}”(hj½  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”hÀj˜  uh1hÇhjº  hžhhŸh³h K~ubjb  )”}”(hXÛ  # ./perf record -a -e sched:*,vpa_dtl/dtl_all/ -c 1000000000 sleep 1
[ perf record: Woken up 1 times to write data ]
[ perf record: Captured and wrote 0.300 MB perf.data ]

# ./perf report
# Samples: 321  of event 'vpa-dtl'
# Event count (approx.): 321
#
# Children      Self  Command  Shared Object      Symbol
# ........  ........  .......  .................  ..............................
#
   100.00%   100.00%  swapper  [kernel.kallsyms]  [k] plpar_hcall_norets_notrace”h]”hXÛ  # ./perf record -a -e sched:*,vpa_dtl/dtl_all/ -c 1000000000 sleep 1
[ perf record: Woken up 1 times to write data ]
[ perf record: Captured and wrote 0.300 MB perf.data ]

# ./perf report
# Samples: 321  of event 'vpa-dtl'
# Event count (approx.): 321
#
# Children      Self  Command  Shared Object      Symbol
# ........  ........  .......  .................  ..............................
#
   100.00%   100.00%  swapper  [kernel.kallsyms]  [k] plpar_hcall_norets_notrace”…””}”hjË  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²jq  ‰jr  Œsh”jt  }”uh1ja  hŸh³h K€hjº  hžhubeh}”(h]”jž  ah ]”h"]”Œ9visualize the dispatch trace log entries with perf report”ah$]”h&]”uh1hÂhhÄhžhhŸh³h K~ubhÃ)”}”(hhh]”(hÈ)”}”(hŒ9Visualize the dispatch trace log entries with perf script”h]”hŒ9Visualize the dispatch trace log entries with perf script”…””}”(hjå  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”hÀjº  uh1hÇhjâ  hžhhŸh³h Kubjb  )”}”(hX
  # ./perf script
  migration/9      67 [009] 105373.359903:                     sched:sched_waking: comm=perf pid=13418 prio=120 target_cpu=009
  migration/9      67 [009] 105373.359904:               sched:sched_migrate_task: comm=perf pid=13418 prio=120 orig_cpu=9 dest_cpu=10
  migration/9      67 [009] 105373.359907:               sched:sched_stat_runtime: comm=migration/9 pid=67 runtime=4050 [ns]
  migration/9      67 [009] 105373.359908:                     sched:sched_switch: prev_comm=migration/9 prev_pid=67 prev_prio=0 prev_state=S ==> next_comm=swapper/9 next_pid=0 next_prio=120
         :256     256 [016] 105373.359913:                                vpa-dtl: timebase: 21403600706628832 dispatch_reason:decrementer interrupt, preempt_reason:H_CEDE, enqueue_to_dispatch_time:4854,                        ready_to_enqueue_time:139, waiting_to_ready_time:511842115 c0000000000fcd28 plpar_hcall_norets_notrace+0x18 ([kernel.kallsyms])
         :256     256 [017] 105373.360012:                                vpa-dtl: timebase: 21403600706679454 dispatch_reason:priv doorbell, preempt_reason:H_CEDE, enqueue_to_dispatch_time:236,                         ready_to_enqueue_time:0, waiting_to_ready_time:133864583 c0000000000fcd28 plpar_hcall_norets_notrace+0x18 ([kernel.kallsyms])
         perf   13418 [010] 105373.360048:               sched:sched_stat_runtime: comm=perf pid=13418 runtime=139748 [ns]
         perf   13418 [010] 105373.360052:                     sched:sched_waking: comm=migration/10 pid=72 prio=0 target_cpu=010”h]”hX
  # ./perf script
  migration/9      67 [009] 105373.359903:                     sched:sched_waking: comm=perf pid=13418 prio=120 target_cpu=009
  migration/9      67 [009] 105373.359904:               sched:sched_migrate_task: comm=perf pid=13418 prio=120 orig_cpu=9 dest_cpu=10
  migration/9      67 [009] 105373.359907:               sched:sched_stat_runtime: comm=migration/9 pid=67 runtime=4050 [ns]
  migration/9      67 [009] 105373.359908:                     sched:sched_switch: prev_comm=migration/9 prev_pid=67 prev_prio=0 prev_state=S ==> next_comm=swapper/9 next_pid=0 next_prio=120
         :256     256 [016] 105373.359913:                                vpa-dtl: timebase: 21403600706628832 dispatch_reason:decrementer interrupt, preempt_reason:H_CEDE, enqueue_to_dispatch_time:4854,                        ready_to_enqueue_time:139, waiting_to_ready_time:511842115 c0000000000fcd28 plpar_hcall_norets_notrace+0x18 ([kernel.kallsyms])
         :256     256 [017] 105373.360012:                                vpa-dtl: timebase: 21403600706679454 dispatch_reason:priv doorbell, preempt_reason:H_CEDE, enqueue_to_dispatch_time:236,                         ready_to_enqueue_time:0, waiting_to_ready_time:133864583 c0000000000fcd28 plpar_hcall_norets_notrace+0x18 ([kernel.kallsyms])
         perf   13418 [010] 105373.360048:               sched:sched_stat_runtime: comm=perf pid=13418 runtime=139748 [ns]
         perf   13418 [010] 105373.360052:                     sched:sched_waking: comm=migration/10 pid=72 prio=0 target_cpu=010”…””}”hjó  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²jq  ‰jr  Œsh”jt  }”uh1ja  hŸh³h K’hjâ  hžhubeh}”(h]”jÀ  ah ]”h"]”Œ9visualize the dispatch trace log entries with perf script”ah$]”h&]”uh1hÂhhÄhžhhŸh³h Kubeh}”(h]”(j  hÁeh ]”h"]”(Œdtl (dispatch trace log)”Œvpa-dtl”eh$]”h&]”uh1hÂhhhžhhŸh³h KŒexpect_referenced_by_name”}”j  h¶sŒexpect_referenced_by_id”}”hÁh¶subeh}”(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”j9  Œ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”}”hÁ]”h¶asŒnameids”}”(j  hÁj  j  jå  já  j  j8  jM  jZ  j·  j|  jß  jž  j  jÀ  uŒ	nametypes”}”(j  ˆj  ‰jå  ‰j  ‰jM  ‰j·  ‰jß  ‰j  ‰uh}”(hÁhÄj  hÄjá  hêj8  jè  jZ  j  j|  jP  jž  jº  jÀ  jâ  h×j  j2  j)  jT  jK  jv  jm  j˜  j  jº  j±  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”“”}”jG  Ks…”R”Œparse_messages”]”hŒsystem_message”“”)”}”(hhh]”hÙ)”}”(hŒfPossible title underline, too short for the title.
Treating it as ordinary text because it's so short.”h]”hŒhPossible title underline, too short for the title.
Treating it as ordinary text because itâ€™s so short.”…””}”(hj¡  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hØhjž  ubah}”(h]”h ]”h"]”h$]”h&]”Œlevel”KŒtype”ŒINFO”Œline”K]Œsource”h³uh1jœ  hjP  hžhhŸh³h K]ubaŒtransform_messages”]”j  )”}”(hhh]”hÙ)”}”(hhh]”hŒ-Hyperlink target "vpa-dtl" is not referenced.”…””}”hj¿  sbah}”(h]”h ]”h"]”h$]”h&]”uh1hØhj¼  ubah}”(h]”h ]”h"]”h$]”h&]”Œlevel”KŒtype”j·  Œsource”h³Œline”Kuh1jœ  ubaŒtransformer”NŒinclude_log”]”Œ
decoration”Nhžhub.