€•Ã/Œsphinx.addnodes”Œdocument”“”)”}”(Œ rawsource”Œ”Œchildren”]”(Œ translations”Œ LanguagesNode”“”)”}”(hhh]”(hŒ pending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ refdomain”Œstd”Œreftype”Œdoc”Œ reftarget”Œ(/translations/zh_CN/admin-guide/perf/cxl”Œmodname”NŒ classname”NŒ refexplicit”ˆuŒtagname”hhh ubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ(/translations/zh_TW/admin-guide/perf/cxl”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ(/translations/it_IT/admin-guide/perf/cxl”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ(/translations/ja_JP/admin-guide/perf/cxl”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ(/translations/ko_KR/admin-guide/perf/cxl”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒPortuguese (Brazilian)”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ(/translations/pt_BR/admin-guide/perf/cxl”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒSpanish”…””}”hh–sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ(/translations/sp_SP/admin-guide/perf/cxl”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h hhŒ _document”hŒsource”NŒline”NubhŒcomment”“”)”}”(hŒ SPDX-License-Identifier: GPL-2.0”h]”hŒ SPDX-License-Identifier: GPL-2.0”…””}”hh·sbah}”(h]”h ]”h"]”h$]”h&]”Œ xml:space”Œpreserve”uh1hµhhh²hh³ŒB/var/lib/git/docbuild/linux/Documentation/admin-guide/perf/cxl.rst”h´KubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒ&CXL Performance Monitoring Unit (CPMU)”h]”hŒ&CXL Performance Monitoring Unit (CPMU)”…””}”(hhÏh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhhÊh²hh³hÇh´KubhŒ paragraph”“”)”}”(hŒThe CXL rev 3.0 specification provides a definition of CXL Performance Monitoring Unit in section 13.2: Performance Monitoring.”h]”hŒThe CXL rev 3.0 specification provides a definition of CXL Performance Monitoring Unit in section 13.2: Performance Monitoring.”…””}”(hhßh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KhhÊh²hubhÞ)”}”(hXPCXL components (e.g. Root Port, Switch Upstream Port, End Point) may have any number of CPMU instances. CPMU capabilities are fully discoverable from the devices. The specification provides event definitions for all CXL protocol message types and a set of additional events for things commonly counted on CXL devices (e.g. DRAM events).”h]”hXPCXL components (e.g. Root Port, Switch Upstream Port, End Point) may have any number of CPMU instances. CPMU capabilities are fully discoverable from the devices. The specification provides event definitions for all CXL protocol message types and a set of additional events for things commonly counted on CXL devices (e.g. DRAM events).”…””}”(hhíh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K hhÊh²hubhÉ)”}”(hhh]”(hÎ)”}”(hŒ CPMU driver”h]”hŒ CPMU driver”…””}”(hhþh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhhûh²hh³hÇh´KubhÞ)”}”(hŒtThe CPMU driver registers a perf PMU with the name pmu_mem. on the CXL bus representing the Yth CPMU for memX.”h]”hŒtThe CPMU driver registers a perf PMU with the name pmu_mem. on the CXL bus representing the Yth CPMU for memX.”…””}”(hj h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Khhûh²hubhŒ block_quote”“”)”}”(hŒ#/sys/bus/cxl/device/pmu_mem. ”h]”hÞ)”}”(hŒ"/sys/bus/cxl/device/pmu_mem.”h]”hŒ"/sys/bus/cxl/device/pmu_mem.”…””}”(hj h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Khjubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´Khhûh²hubhÞ)”}”(hŒ#The associated PMU is registered as”h]”hŒ#The associated PMU is registered as”…””}”(hj4h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Khhûh²hubj)”}”(hŒ2/sys/bus/event_sources/devices/cxl_pmu_mem. ”h]”hÞ)”}”(hŒ1/sys/bus/event_sources/devices/cxl_pmu_mem.”h]”hŒ1/sys/bus/event_sources/devices/cxl_pmu_mem.”…””}”(hjFh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KhjBubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´Khhûh²hubhÞ)”}”(hŒºIn common with other CXL bus devices, the id has no specific meaning and the relationship to specific CXL device should be established via the device parent of the device on the CXL bus.”h]”hŒºIn common with other CXL bus devices, the id has no specific meaning and the relationship to specific CXL device should be established via the device parent of the device on the CXL bus.”…””}”(hjZh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Khhûh²hubhÞ)”}”(hŒPPMU driver provides description of available events and filter options in sysfs.”h]”hŒPPMU driver provides description of available events and filter options in sysfs.”…””}”(hjhh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K hhûh²hubhÞ)”}”(hXThe "format" directory describes all formats of the config (event vendor id, group id and mask) config1 (threshold, filter enables) and config2 (filter parameters) fields of the perf_event_attr structure. The "events" directory describes all documented events show in perf list.”h]”hXThe “format†directory describes all formats of the config (event vendor id, group id and mask) config1 (threshold, filter enables) and config2 (filter parameters) fields of the perf_event_attr structure. The “events†directory describes all documented events show in perf list.”…””}”(hjvh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K"hhûh²hubhÞ)”}”(hX#The events shown in perf list are the most fine grained events with a single bit of the event mask set. More general events may be enable by setting multiple mask bits in config. For example, all Device to Host Read Requests may be captured on a single counter by setting the bits for all of”h]”hX#The events shown in perf list are the most fine grained events with a single bit of the event mask set. More general events may be enable by setting multiple mask bits in config. For example, all Device to Host Read Requests may be captured on a single counter by setting the bits for all of”…””}”(hj„h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K'hhûh²hubhŒ bullet_list”“”)”}”(hhh]”(hŒ list_item”“”)”}”(hŒd2h_req_rdcurr”h]”hÞ)”}”(hj›h]”hŒd2h_req_rdcurr”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K,hj™ubah}”(h]”h ]”h"]”h$]”h&]”uh1j—hj”h²hh³hÇh´Nubj˜)”}”(hŒ d2h_req_rdown”h]”hÞ)”}”(hj²h]”hŒ d2h_req_rdown”…””}”(hj´h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K-hj°ubah}”(h]”h ]”h"]”h$]”h&]”uh1j—hj”h²hh³hÇh´Nubj˜)”}”(hŒd2h_req_rdshared”h]”hÞ)”}”(hjÉh]”hŒd2h_req_rdshared”…””}”(hjËh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K.hjÇubah}”(h]”h ]”h"]”h$]”h&]”uh1j—hj”h²hh³hÇh´Nubj˜)”}”(hŒ d2h_req_rdany”h]”hÞ)”}”(hjàh]”hŒ d2h_req_rdany”…””}”(hjâh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K/hjÞubah}”(h]”h ]”h"]”h$]”h&]”uh1j—hj”h²hh³hÇh´Nubj˜)”}”(hŒd2h_req_rdownnodata ”h]”hÞ)”}”(hŒd2h_req_rdownnodata”h]”hŒd2h_req_rdownnodata”…””}”(hjùh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K0hjõubah}”(h]”h ]”h"]”h$]”h&]”uh1j—hj”h²hh³hÇh´Nubeh}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ*”uh1j’h³hÇh´K,hhûh²hubhÞ)”}”(hŒExample of usage::”h]”hŒExample of usage:”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K2hhûh²hubhŒ literal_block”“”)”}”(hXù$#perf list cxl_pmu_mem0.0/clock_ticks/ [Kernel PMU event] cxl_pmu_mem0.0/d2h_req_rdshared/ [Kernel PMU event] cxl_pmu_mem0.0/h2d_req_snpcur/ [Kernel PMU event] cxl_pmu_mem0.0/h2d_req_snpdata/ [Kernel PMU event] cxl_pmu_mem0.0/h2d_req_snpinv/ [Kernel PMU event] ----------------------------------------------------------- $# perf stat -a -e cxl_pmu_mem0.0/clock_ticks/ -e cxl_pmu_mem0.0/d2h_req_rdshared/”h]”hXù$#perf list cxl_pmu_mem0.0/clock_ticks/ [Kernel PMU event] cxl_pmu_mem0.0/d2h_req_rdshared/ [Kernel PMU event] cxl_pmu_mem0.0/h2d_req_snpcur/ [Kernel PMU event] cxl_pmu_mem0.0/h2d_req_snpdata/ [Kernel PMU event] cxl_pmu_mem0.0/h2d_req_snpinv/ [Kernel PMU event] ----------------------------------------------------------- $# perf stat -a -e cxl_pmu_mem0.0/clock_ticks/ -e cxl_pmu_mem0.0/d2h_req_rdshared/”…””}”hj%sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j#h³hÇh´K4hhûh²hubhÞ)”}”(hŒFVendor specific events may also be available and if so can be used via”h]”hŒFVendor specific events may also be available and if so can be used via”…””}”(hj3h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K>hhûh²hubj)”}”(hŒ=$# perf stat -a -e cxl_pmu_mem0.0/vid=VID,gid=GID,mask=MASK/ ”h]”hÞ)”}”(hŒ<$# perf stat -a -e cxl_pmu_mem0.0/vid=VID,gid=GID,mask=MASK/”h]”hŒ<$# perf stat -a -e cxl_pmu_mem0.0/vid=VID,gid=GID,mask=MASK/”…””}”(hjEh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K@hjAubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´K@hhûh²hubhÞ)”}”(hŒ’The driver does not support sampling so "perf record" is unsupported. It only supports system-wide counting so attaching to a task is unsupported.”h]”hŒ–The driver does not support sampling so “perf record†is unsupported. It only supports system-wide counting so attaching to a task is unsupported.”…””}”(hjYh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KBhhûh²hubeh}”(h]”Œ cpmu-driver”ah ]”h"]”Œ cpmu driver”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´Kubeh}”(h]”Œ$cxl-performance-monitoring-unit-cpmu”ah ]”h"]”Œ&cxl performance monitoring unit (cpmu)”ah$]”h&]”uh1hÈhhh²hh³hÇh´Kubeh}”(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”}”(jtjqjljiuŒ nametypes”}”(jt‰jl‰uh}”(jqhÊjihû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.