€•ƒ;Œ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”Œ2/translations/zh_CN/misc-devices/pci-endpoint-test”Œmodname”NŒ classname”NŒ refexplicit”ˆuŒtagname”hhh ubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ2/translations/zh_TW/misc-devices/pci-endpoint-test”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ2/translations/it_IT/misc-devices/pci-endpoint-test”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ2/translations/ja_JP/misc-devices/pci-endpoint-test”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ2/translations/ko_KR/misc-devices/pci-endpoint-test”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒPortuguese (Brazilian)”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ2/translations/pt_BR/misc-devices/pci-endpoint-test”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒSpanish”…””}”hh–sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ2/translations/sp_SP/misc-devices/pci-endpoint-test”Œ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³ŒL/var/lib/git/docbuild/linux/Documentation/misc-devices/pci-endpoint-test.rst”h´KubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒ%Driver for PCI Endpoint Test Function”h]”hŒ%Driver for PCI Endpoint Test Function”…””}”(hhÏh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhhÊh²hh³hÇh´KubhŒ paragraph”“”)”}”(hŒ·This driver should be used as a host side driver if the root complex is connected to a configurable PCI endpoint running ``pci_epf_test`` function driver configured according to [1]_.”h]”(hŒyThis driver should be used as a host side driver if the root complex is connected to a configurable PCI endpoint running ”…””}”(hhßh²hh³Nh´NubhŒliteral”“”)”}”(hŒ``pci_epf_test``”h]”hŒ pci_epf_test”…””}”(hhéh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hçhhßubhŒ) function driver configured according to ”…””}”(hhßh²hh³Nh´NubhŒfootnote_reference”“”)”}”(hŒ[1]_”h]”hŒ1”…””}”(hhýh²hh³Nh´Nubah}”(h]”Œid1”ah ]”h"]”h$]”h&]”Œrefid”Œid2”Œdocname”Œmisc-devices/pci-endpoint-test”uh1hûhhߌresolved”KubhŒ.”…””}”(hhßh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KhhÊh²hubhÞ)”}”(hŒJThe "pci_endpoint_test" driver can be used to perform the following tests.”h]”hŒNThe “pci_endpoint_test†driver can be used to perform the following tests.”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K hhÊh²hubhÞ)”}”(hŒ@The PCI driver for the test device performs the following tests:”h]”hŒ@The PCI driver for the test device performs the following tests:”…””}”(hj)h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K hhÊh²hubhŒ block_quote”“”)”}”(hŒ‰#) verifying addresses programmed in BAR #) raise legacy IRQ #) raise MSI IRQ #) raise MSI-X IRQ #) read data #) write data #) copy data ”h]”hŒenumerated_list”“”)”}”(hhh]”(hŒ list_item”“”)”}”(hŒ%verifying addresses programmed in BAR”h]”hÞ)”}”(hjFh]”hŒ%verifying addresses programmed in BAR”…””}”(hjHh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KhjDubah}”(h]”h ]”h"]”h$]”h&]”uh1jBhj?ubjC)”}”(hŒraise legacy IRQ”h]”hÞ)”}”(hj]h]”hŒraise legacy IRQ”…””}”(hj_h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Khj[ubah}”(h]”h ]”h"]”h$]”h&]”uh1jBhj?ubjC)”}”(hŒ raise MSI IRQ”h]”hÞ)”}”(hjth]”hŒ raise MSI IRQ”…””}”(hjvh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Khjrubah}”(h]”h ]”h"]”h$]”h&]”uh1jBhj?ubjC)”}”(hŒraise MSI-X IRQ”h]”hÞ)”}”(hj‹h]”hŒraise MSI-X IRQ”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Khj‰ubah}”(h]”h ]”h"]”h$]”h&]”uh1jBhj?ubjC)”}”(hŒ read data”h]”hÞ)”}”(hj¢h]”hŒ read data”…””}”(hj¤h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Khj ubah}”(h]”h ]”h"]”h$]”h&]”uh1jBhj?ubjC)”}”(hŒ write data”h]”hÞ)”}”(hj¹h]”hŒ write data”…””}”(hj»h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Khj·ubah}”(h]”h ]”h"]”h$]”h&]”uh1jBhj?ubjC)”}”(hŒ copy data ”h]”hÞ)”}”(hŒ copy data”h]”hŒ copy data”…””}”(hjÒh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KhjÎubah}”(h]”h ]”h"]”h$]”h&]”uh1jBhj?ubeh}”(h]”h ]”h"]”h$]”h&]”Œenumtype”Œarabic”Œprefix”hŒsuffix”Œ)”uh1j=hj9ubah}”(h]”h ]”h"]”h$]”h&]”uh1j7h³hÇh´KhhÊh²hubhÞ)”}”(hŒ¯This misc driver creates /dev/pci-endpoint-test. for every ``pci_epf_test`` function connected to the root complex and "ioctls" should be used to perform the above tests.”h]”(hŒ@This misc driver creates /dev/pci-endpoint-test. for every ”…””}”(hj÷h²hh³Nh´Nubhè)”}”(hŒ``pci_epf_test``”h]”hŒ pci_epf_test”…””}”(hjÿh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hçhj÷ubhŒc function connected to the root complex and “ioctls†should be used to perform the above tests.”…””}”(hj÷h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KhhÊh²hubhÉ)”}”(hhh]”(hÎ)”}”(hŒioctl”h]”hŒioctl”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjh²hh³hÇh´Kubj8)”}”(hXîPCITEST_BAR: Tests the BAR. The number of the BAR to be tested should be passed as argument. PCITEST_LEGACY_IRQ: Tests legacy IRQ PCITEST_MSI: Tests message signalled interrupts. The MSI number to be tested should be passed as argument. PCITEST_MSIX: Tests message signalled interrupts. The MSI-X number to be tested should be passed as argument. PCITEST_SET_IRQTYPE: Changes driver IRQ type configuration. The IRQ type should be passed as argument (0: Legacy, 1:MSI, 2:MSI-X). PCITEST_GET_IRQTYPE: Gets driver IRQ type configuration. PCITEST_WRITE: Perform write tests. The size of the buffer should be passed as argument. PCITEST_READ: Perform read tests. The size of the buffer should be passed as argument. PCITEST_COPY: Perform read tests. The size of the buffer should be passed as argument. ”h]”hŒdefinition_list”“”)”}”(hhh]”(hŒdefinition_list_item”“”)”}”(hŒ\PCITEST_BAR: Tests the BAR. The number of the BAR to be tested should be passed as argument.”h]”(hŒterm”“”)”}”(hŒ PCITEST_BAR:”h]”hŒ PCITEST_BAR:”…””}”(hj9h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j7h³hÇh´Khj3ubhŒ definition”“”)”}”(hhh]”hÞ)”}”(hŒOTests the BAR. The number of the BAR to be tested should be passed as argument.”h]”hŒOTests the BAR. The number of the BAR to be tested should be passed as argument.”…””}”(hjLh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KhjIubah}”(h]”h ]”h"]”h$]”h&]”uh1jGhj3ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j1h³hÇh´Khj.ubj2)”}”(hŒ$PCITEST_LEGACY_IRQ: Tests legacy IRQ”h]”(j8)”}”(hŒPCITEST_LEGACY_IRQ:”h]”hŒPCITEST_LEGACY_IRQ:”…””}”(hjjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j7h³hÇh´K!hjfubjH)”}”(hhh]”hÞ)”}”(hŒTests legacy IRQ”h]”hŒTests legacy IRQ”…””}”(hj{h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K"hjxubah}”(h]”h ]”h"]”h$]”h&]”uh1jGhjfubeh}”(h]”h ]”h"]”h$]”h&]”uh1j1h³hÇh´K!hj.ubj2)”}”(hŒjPCITEST_MSI: Tests message signalled interrupts. The MSI number to be tested should be passed as argument.”h]”(j8)”}”(hŒ PCITEST_MSI:”h]”hŒ PCITEST_MSI:”…””}”(hj™h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j7h³hÇh´K$hj•ubjH)”}”(hhh]”hÞ)”}”(hŒ]Tests message signalled interrupts. The MSI number to be tested should be passed as argument.”h]”hŒ]Tests message signalled interrupts. The MSI number to be tested should be passed as argument.”…””}”(hjªh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K$hj§ubah}”(h]”h ]”h"]”h$]”h&]”uh1jGhj•ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j1h³hÇh´K$hj.ubj2)”}”(hŒmPCITEST_MSIX: Tests message signalled interrupts. The MSI-X number to be tested should be passed as argument.”h]”(j8)”}”(hŒ PCITEST_MSIX:”h]”hŒ PCITEST_MSIX:”…””}”(hjÈh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j7h³hÇh´K'hjÄubjH)”}”(hhh]”hÞ)”}”(hŒ_Tests message signalled interrupts. The MSI-X number to be tested should be passed as argument.”h]”hŒ_Tests message signalled interrupts. The MSI-X number to be tested should be passed as argument.”…””}”(hjÙh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K'hjÖubah}”(h]”h ]”h"]”h$]”h&]”uh1jGhjÄubeh}”(h]”h ]”h"]”h$]”h&]”uh1j1h³hÇh´K'hj.ubj2)”}”(hŒ‚PCITEST_SET_IRQTYPE: Changes driver IRQ type configuration. The IRQ type should be passed as argument (0: Legacy, 1:MSI, 2:MSI-X).”h]”(j8)”}”(hŒPCITEST_SET_IRQTYPE:”h]”hŒPCITEST_SET_IRQTYPE:”…””}”(hj÷h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j7h³hÇh´K*hjóubjH)”}”(hhh]”hÞ)”}”(hŒmChanges driver IRQ type configuration. The IRQ type should be passed as argument (0: Legacy, 1:MSI, 2:MSI-X).”h]”hŒmChanges driver IRQ type configuration. The IRQ type should be passed as argument (0: Legacy, 1:MSI, 2:MSI-X).”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K*hjubah}”(h]”h ]”h"]”h$]”h&]”uh1jGhjóubeh}”(h]”h ]”h"]”h$]”h&]”uh1j1h³hÇh´K*hj.ubj2)”}”(hŒ8PCITEST_GET_IRQTYPE: Gets driver IRQ type configuration.”h]”(j8)”}”(hŒPCITEST_GET_IRQTYPE:”h]”hŒPCITEST_GET_IRQTYPE:”…””}”(hj&h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j7h³hÇh´K,hj"ubjH)”}”(hhh]”hÞ)”}”(hŒ#Gets driver IRQ type configuration.”h]”hŒ#Gets driver IRQ type configuration.”…””}”(hj7h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K-hj4ubah}”(h]”h ]”h"]”h$]”h&]”uh1jGhj"ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j1h³hÇh´K,hj.ubj2)”}”(hŒXPCITEST_WRITE: Perform write tests. The size of the buffer should be passed as argument.”h]”(j8)”}”(hŒPCITEST_WRITE:”h]”hŒPCITEST_WRITE:”…””}”(hjUh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j7h³hÇh´K/hjQubjH)”}”(hhh]”hÞ)”}”(hŒIPerform write tests. The size of the buffer should be passed as argument.”h]”hŒIPerform write tests. The size of the buffer should be passed as argument.”…””}”(hjfh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K/hjcubah}”(h]”h ]”h"]”h$]”h&]”uh1jGhjQubeh}”(h]”h ]”h"]”h$]”h&]”uh1j1h³hÇh´K/hj.ubj2)”}”(hŒVPCITEST_READ: Perform read tests. The size of the buffer should be passed as argument.”h]”(j8)”}”(hŒ PCITEST_READ:”h]”hŒ PCITEST_READ:”…””}”(hj„h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j7h³hÇh´K2hj€ubjH)”}”(hhh]”hÞ)”}”(hŒHPerform read tests. The size of the buffer should be passed as argument.”h]”hŒHPerform read tests. The size of the buffer should be passed as argument.”…””}”(hj•h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K2hj’ubah}”(h]”h ]”h"]”h$]”h&]”uh1jGhj€ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j1h³hÇh´K2hj.ubj2)”}”(hŒWPCITEST_COPY: Perform read tests. The size of the buffer should be passed as argument. ”h]”(j8)”}”(hŒ PCITEST_COPY:”h]”hŒ PCITEST_COPY:”…””}”(hj³h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j7h³hÇh´K6hj¯ubjH)”}”(hhh]”hÞ)”}”(hŒHPerform read tests. The size of the buffer should be passed as argument.”h]”hŒHPerform read tests. The size of the buffer should be passed as argument.”…””}”(hjÄh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K5hjÁubah}”(h]”h ]”h"]”h$]”h&]”uh1jGhj¯ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j1h³hÇh´K6hj.ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j,hj(ubah}”(h]”h ]”h"]”h$]”h&]”uh1j7h³hÇh´Khjh²hubhŒfootnote”“”)”}”(hŒ8Documentation/PCI/endpoint/function/binding/pci-test.rst”h]”(hŒlabel”“”)”}”(hŒ1”h]”hŒ1”…””}”(hjòh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jðhjìubhÞ)”}”(hjîh]”hŒ8Documentation/PCI/endpoint/function/binding/pci-test.rst”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K8hjìubeh}”(h]”j ah ]”h"]”Œ1”ah$]”h&]”jajjuh1jêh³hÇh´K8hjh²hjKubeh}”(h]”Œioctl”ah ]”h"]”Œioctl”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´Kubeh}”(h]”Œ%driver-for-pci-endpoint-test-function”ah ]”h"]”Œ%driver for pci endpoint test function”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”jGŒ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”}”Œ1”]”hýasŒrefids”}”Œnameids”}”(j!jjjjj uŒ nametypes”}”(j!‰j‰jˆuh}”(jhÊjhýjjj jìuŒ footnote_refs”}”j‡]”hýasŒ citation_refs”}”Œ autofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ footnotes”]”jìaŒ citations”]”Œautofootnote_start”KŒsymbol_footnote_start”KŒ id_counter”Œ collections”ŒCounter”“”}”jUKs…”R”Œparse_messages”]”Œtransform_messages”]”Œ transformer”NŒ include_log”]”Œ decoration”Nh²hub.