€•C9Œ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/trace/events-pci”Œ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/trace/events-pci”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ$/translations/it_IT/trace/events-pci”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ$/translations/ja_JP/trace/events-pci”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ$/translations/ko_KR/trace/events-pci”Œ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/trace/events-pci”Œ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/trace/events-pci”Œ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³Œ>/var/lib/git/docbuild/linux/Documentation/trace/events-pci.rst”h´KubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒSubsystem Trace Points: PCI”h]”hŒSubsystem Trace Points: PCI”…””}”(hhÏh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhhÊh²hh³hÇh´KubhÉ)”}”(hhh]”(hÎ)”}”(hŒOverview”h]”hŒOverview”…””}”(hhàh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhhÝh²hh³hÇh´KubhŒ paragraph”“”)”}”(hŒ§The PCI tracing system provides tracepoints to monitor critical hardware events that can impact system performance and reliability. These events normally show up here:”h]”hŒ§The PCI tracing system provides tracepoints to monitor critical hardware events that can impact system performance and reliability. These events normally show up here:”…””}”(hhðh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´K hhÝh²hubhŒ block_quote”“”)”}”(hŒ/sys/kernel/tracing/events/pci ”h]”hï)”}”(hŒ/sys/kernel/tracing/events/pci”h]”hŒ/sys/kernel/tracing/events/pci”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´K hjubah}”(h]”h ]”h"]”h$]”h&]”uh1hþh³hÇh´K hhÝh²hubhï)”}”(hŒ:Cf. include/trace/events/pci.h for the events definitions.”h]”hŒ:Cf. include/trace/events/pci.h for the events definitions.”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´KhhÝh²hubeh}”(h]”Œoverview”ah ]”h"]”Œoverview”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´KubhÉ)”}”(hhh]”(hÎ)”}”(hŒAvailable Tracepoints”h]”hŒAvailable Tracepoints”…””}”(hj1h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj.h²hh³hÇh´KubhÉ)”}”(hhh]”(hÎ)”}”(hŒ pci_hp_event”h]”hŒ pci_hp_event”…””}”(hjBh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj?h²hh³hÇh´Kubhï)”}”(hŒWMonitors PCI hotplug events including card insertion/removal and link state changes. ::”h]”hŒTMonitors PCI hotplug events including card insertion/removal and link state changes.”…””}”(hjPh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´Khj?h²hubhŒ literal_block”“”)”}”(hŒ&pci_hp_event "%s slot:%s, event:%s\n"”h]”hŒ&pci_hp_event "%s slot:%s, event:%s\n"”…””}”hj`sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j^h³hÇh´Khj?h²hubhï)”}”(hŒ**Event Types**:”h]”(hŒstrong”“”)”}”(hŒ**Event Types**”h]”hŒ Event Types”…””}”(hjth²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jrhjnubhŒ:”…””}”(hjnh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´Khj?h²hubhŒ bullet_list”“”)”}”(hhh]”(hŒ list_item”“”)”}”(hŒ#``LINK_UP`` - PCIe link established”h]”hï)”}”(hj•h]”(hŒliteral”“”)”}”(hŒ ``LINK_UP``”h]”hŒLINK_UP”…””}”(hjœh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jšhj—ubhŒ - PCIe link established”…””}”(hj—h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´Khj“ubah}”(h]”h ]”h"]”h$]”h&]”uh1j‘hjŽh²hh³hÇh´Nubj’)”}”(hŒ``LINK_DOWN`` - PCIe link lost”h]”hï)”}”(hj¼h]”(j›)”}”(hŒ ``LINK_DOWN``”h]”hŒ LINK_DOWN”…””}”(hjÁh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jšhj¾ubhŒ - PCIe link lost”…””}”(hj¾h²hh³Nh´Nubeh}”(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Œ(``CARD_PRESENT`` - Card detected in slot”h]”hï)”}”(hjáh]”(j›)”}”(hŒ``CARD_PRESENT``”h]”hŒ CARD_PRESENT”…””}”(hjæh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jšhjãubhŒ - Card detected in slot”…””}”(hjãh²hh³Nh´Nubeh}”(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Œ.``CARD_NOT_PRESENT`` - Card removed from slot ”h]”hï)”}”(hŒ-``CARD_NOT_PRESENT`` - Card removed from slot”h]”(j›)”}”(hŒ``CARD_NOT_PRESENT``”h]”hŒCARD_NOT_PRESENT”…””}”(hj h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jšhjubhŒ - Card removed from slot”…””}”(hjh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´K"hjubah}”(h]”h ]”h"]”h$]”h&]”uh1j‘hjŽh²hh³hÇh´Nubeh}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ*”uh1jŒh³hÇh´Khj?h²hubhï)”}”(hŒ**Example Usage**::”h]”(js)”}”(hŒ**Example Usage**”h]”hŒ Example Usage”…””}”(hj6h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jrhj2ubhŒ:”…””}”(hj2h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´K$hj?h²hubj_)”}”(hX¤# Enable the tracepoint echo 1 > /sys/kernel/debug/tracing/events/pci/pci_hp_event/enable # Monitor events (the following output is generated when a device is hotplugged) cat /sys/kernel/debug/tracing/trace_pipe irq/51-pciehp-88 [001] ..... 1311.177459: pci_hp_event: 0000:00:02.0 slot:10, event:CARD_PRESENT irq/51-pciehp-88 [001] ..... 1311.177566: pci_hp_event: 0000:00:02.0 slot:10, event:LINK_UP”h]”hX¤# Enable the tracepoint echo 1 > /sys/kernel/debug/tracing/events/pci/pci_hp_event/enable # Monitor events (the following output is generated when a device is hotplugged) cat /sys/kernel/debug/tracing/trace_pipe irq/51-pciehp-88 [001] ..... 1311.177459: pci_hp_event: 0000:00:02.0 slot:10, event:CARD_PRESENT irq/51-pciehp-88 [001] ..... 1311.177566: pci_hp_event: 0000:00:02.0 slot:10, event:LINK_UP”…””}”hjNsbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j^h³hÇh´K&hj?h²hubeh}”(h]”Œ pci-hp-event”ah ]”h"]”Œ pci_hp_event”ah$]”h&]”uh1hÈhj.h²hh³hÇh´KubhÉ)”}”(hhh]”(hÎ)”}”(hŒpcie_link_event”h]”hŒpcie_link_event”…””}”(hjgh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjdh²hh³hÇh´K0ubhï)”}”(hŒRMonitors PCIe link speed changes and provides detailed link status information. ::”h]”hŒOMonitors PCIe link speed changes and provides detailed link status information.”…””}”(hjuh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´K2hjdh²hubj_)”}”(hŒqpcie_link_event "%s type:%d, reason:%d, cur_bus_speed:%d, max_bus_speed:%d, width:%u, flit_mode:%u, status:%s\n"”h]”hŒqpcie_link_event "%s type:%d, reason:%d, cur_bus_speed:%d, max_bus_speed:%d, width:%u, flit_mode:%u, status:%s\n"”…””}”hjƒsbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j^h³hÇh´K5hjdh²hubhï)”}”(hŒ**Parameters**:”h]”(js)”}”(hŒ**Parameters**”h]”hŒ Parameters”…””}”(hj•h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jrhj‘ubhŒ:”…””}”(hj‘h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´K7hjdh²hubj)”}”(hhh]”(j’)”}”(hŒ/``type`` - PCIe device type (4=Root Port, etc.)”h]”hï)”}”(hj²h]”(j›)”}”(hŒ``type``”h]”hŒtype”…””}”(hj·h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jšhj´ubhŒ' - PCIe device type (4=Root Port, etc.)”…””}”(hj´h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´K9hj°ubah}”(h]”h ]”h"]”h$]”h&]”uh1j‘hj­h²hh³hÇh´Nubj’)”}”(hŒ½``reason`` - Reason for link change: - ``0`` - Link retrain - ``1`` - Bus enumeration - ``2`` - Bandwidth notification enable - ``3`` - Bandwidth notification IRQ - ``4`` - Hotplug event ”h]”(hï)”}”(hŒ$``reason`` - Reason for link change:”h]”(j›)”}”(hŒ ``reason``”h]”hŒreason”…””}”(hjÝh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jšhjÙubhŒ - Reason for link change:”…””}”(hjÙh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´K:hjÕubj)”}”(hhh]”(j’)”}”(hŒ``0`` - Link retrain”h]”hï)”}”(hjúh]”(j›)”}”(hŒ``0``”h]”hŒ0”…””}”(hjÿh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jšhjüubhŒ - Link retrain”…””}”(hjüh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´KhjBubah}”(h]”h ]”h"]”h$]”h&]”uh1j‘hjõubj’)”}”(hŒ"``3`` - Bandwidth notification IRQ”h]”hï)”}”(hjih]”(j›)”}”(hŒ``3``”h]”hŒ3”…””}”(hjnh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jšhjkubhŒ - Bandwidth notification IRQ”…””}”(hjkh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´K?hjgubah}”(h]”h ]”h"]”h$]”h&]”uh1j‘hjõubj’)”}”(hŒ``4`` - Hotplug event ”h]”hï)”}”(hŒ``4`` - Hotplug event”h]”(j›)”}”(hŒ``4``”h]”hŒ4”…””}”(hj”h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jšhjubhŒ - Hotplug event”…””}”(hjh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hîh³hÇh´K@hjŒubah}”(h]”h ]”h"]”h$]”h&]”uh1j‘hjõubeh}”(h]”h ]”h"]”h$]”h&]”j0Œ-”uh1jŒh³hÇh´K /sys/kernel/debug/tracing/events/pci/pcie_link_event/enable # Monitor events (the following output is generated when a device is hotplugged) cat /sys/kernel/debug/tracing/trace_pipe irq/51-pciehp-88 [001] ..... 381.545386: pcie_link_event: 0000:00:02.0 type:4, reason:4, cur_bus_speed:20, max_bus_speed:23, width:1, flit_mode:0, status:DLLLA”h]”hX# Enable the tracepoint echo 1 > /sys/kernel/debug/tracing/events/pci/pcie_link_event/enable # Monitor events (the following output is generated when a device is hotplugged) cat /sys/kernel/debug/tracing/trace_pipe irq/51-pciehp-88 [001] ..... 381.545386: pcie_link_event: 0000:00:02.0 type:4, reason:4, cur_bus_speed:20, max_bus_speed:23, width:1, flit_mode:0, status:DLLLA”…””}”hjásbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j^h³hÇh´KEhjdh²hubeh}”(h]”Œpcie-link-event”ah ]”h"]”Œpcie_link_event”ah$]”h&]”uh1hÈhj.h²hh³hÇh´K0ubeh}”(h]”Œavailable-tracepoints”ah ]”h"]”Œavailable tracepoints”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´Kubeh}”(h]”Œsubsystem-trace-points-pci”ah ]”h"]”Œsubsystem trace points: pci”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”}”(jjj+j(jüjùjaj^jôjñuŒ nametypes”}”(j‰j+‰jü‰ja‰jô‰uh}”(jhÊj(hÝjùj.j^j?jñjduŒ 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”]”hŒsystem_message”“”)”}”(hhh]”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.”…””}”(hj‘h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hîhjŽubah}”(h]”h ]”h"]”h$]”h&]”Œlevel”KŒtype”ŒINFO”Œline”K3Œsource”hÇuh1jŒhjdh²hh³hÇh´K3ubaŒtransform_messages”]”Œ transformer”NŒ include_log”]”Œ decoration”Nh²hub.