€•û4Œ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”ŒC/translations/zh_CN/networking/device_drivers/ethernet/amd/pds_vdpa”Œmodname”NŒ classname”NŒ refexplicit”ˆuŒtagname”hhh ubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”ŒC/translations/zh_TW/networking/device_drivers/ethernet/amd/pds_vdpa”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”ŒC/translations/it_IT/networking/device_drivers/ethernet/amd/pds_vdpa”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”ŒC/translations/ja_JP/networking/device_drivers/ethernet/amd/pds_vdpa”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”ŒC/translations/ko_KR/networking/device_drivers/ethernet/amd/pds_vdpa”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒSpanish”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”ŒC/translations/sp_SP/networking/device_drivers/ethernet/amd/pds_vdpa”Œ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/networking/device_drivers/ethernet/amd/pds_vdpa.rst”h Kubh¢)”}”(hŒ8note: can be edited and viewed with /usr/bin/formiko-vim”h]”hŒ8note: can be edited and viewed with /usr/bin/formiko-vim”…””}”hh´sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1h¡hhhžhhŸh³h KubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒ:PCI vDPA driver for the AMD/Pensando(R) DSC adapter family”h]”hŒ:PCI vDPA driver for the AMD/Pensando(R) DSC adapter family”…””}”(hhÉhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhhÄhžhhŸh³h KubhŒ paragraph”“”)”}”(hŒ"AMD/Pensando vDPA VF Device Driver”h]”hŒ"AMD/Pensando vDPA VF Device Driver”…””}”(hhÙhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh³h KhhÄhžhubhØ)”}”(hŒ-Copyright(c) 2023 Advanced Micro Devices, Inc”h]”hŒ-Copyright(c) 2023 Advanced Micro Devices, Inc”…””}”(hhçhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh³h K hhÄhžhubhÃ)”}”(hhh]”(hÈ)”}”(hŒOverview”h]”hŒOverview”…””}”(hhøhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhhõhžhhŸh³h K ubhØ)”}”(hXVThe ``pds_vdpa`` driver is an auxiliary bus driver that supplies a vDPA device for use by the virtio network stack. It is used with the Pensando Virtual Function devices that offer vDPA and virtio queue services. It depends on the ``pds_core`` driver and hardware for the PF and VF PCI handling as well as for device configuration services.”h]”(hŒThe ”…””}”(hjhžhhŸNh NubhŒliteral”“”)”}”(hŒ ``pds_vdpa``”h]”hŒpds_vdpa”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jhjubhŒÙ driver is an auxiliary bus driver that supplies a vDPA device for use by the virtio network stack. It is used with the Pensando Virtual Function devices that offer vDPA and virtio queue services. It depends on the ”…””}”(hjhžhhŸNh Nubj)”}”(hŒ ``pds_core``”h]”hŒpds_core”…””}”(hj"hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jhjubhŒa driver and hardware for the PF and VF PCI handling as well as for device configuration services.”…””}”(hjhžhhŸNh Nubeh}”(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 K ubhÃ)”}”(hhh]”(hÈ)”}”(hŒUsing the device”h]”hŒUsing the device”…””}”(hjEhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhjBhžhhŸh³h KubhØ)”}”(hX$The ``pds_vdpa`` device is enabled via multiple configuration steps and depends on the ``pds_core`` driver to create and enable SR-IOV Virtual Function devices. After the VFs are enabled, we enable the vDPA service in the ``pds_core`` device to create the auxiliary devices used by pds_vdpa.”h]”(hŒThe ”…””}”(hjShžhhŸNh Nubj)”}”(hŒ ``pds_vdpa``”h]”hŒpds_vdpa”…””}”(hj[hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jhjSubhŒG device is enabled via multiple configuration steps and depends on the ”…””}”(hjShžhhŸNh Nubj)”}”(hŒ ``pds_core``”h]”hŒpds_core”…””}”(hjmhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jhjSubhŒ| driver to create and enable SR-IOV Virtual Function devices. After the VFs are enabled, we enable the vDPA service in the ”…””}”(hjShžhhŸNh Nubj)”}”(hŒ ``pds_core``”h]”hŒpds_core”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jhjSubhŒ9 device to create the auxiliary devices used by pds_vdpa.”…””}”(hjShžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh³h KhjBhžhubhØ)”}”(hŒExample steps:”h]”hŒExample steps:”…””}”(hj—hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh³h KhjBhžhubhŒ literal_block”“”)”}”(hX±#!/bin/bash modprobe pds_core modprobe vdpa modprobe pds_vdpa PF_BDF=`ls /sys/module/pds_core/drivers/pci\:pds_core/*/sriov_numvfs | awk -F / '{print $7}'` # Enable vDPA VF auxiliary device(s) in the PF devlink dev param set pci/$PF_BDF name enable_vnet cmode runtime value true # Create a VF for vDPA use echo 1 > /sys/bus/pci/drivers/pds_core/$PF_BDF/sriov_numvfs # Find the vDPA services/devices available PDS_VDPA_MGMT=`vdpa mgmtdev show | grep vDPA | head -1 | cut -d: -f1` # Create a vDPA device for use in virtio network configurations vdpa dev add name vdpa1 mgmtdev $PDS_VDPA_MGMT mac 00:11:22:33:44:55 # Set up an ethernet interface on the vdpa device modprobe virtio_vdpa”h]”hX±#!/bin/bash modprobe pds_core modprobe vdpa modprobe pds_vdpa PF_BDF=`ls /sys/module/pds_core/drivers/pci\:pds_core/*/sriov_numvfs | awk -F / '{print $7}'` # Enable vDPA VF auxiliary device(s) in the PF devlink dev param set pci/$PF_BDF name enable_vnet cmode runtime value true # Create a VF for vDPA use echo 1 > /sys/bus/pci/drivers/pds_core/$PF_BDF/sriov_numvfs # Find the vDPA services/devices available PDS_VDPA_MGMT=`vdpa mgmtdev show | grep vDPA | head -1 | cut -d: -f1` # Create a vDPA device for use in virtio network configurations vdpa dev add name vdpa1 mgmtdev $PDS_VDPA_MGMT mac 00:11:22:33:44:55 # Set up an ethernet interface on the vdpa device modprobe virtio_vdpa”…””}”hj§sbah}”(h]”h ]”h"]”h$]”h&]”h±h²Œforce”‰Œlanguage”Œbash”Œhighlight_args”}”uh1j¥hŸh³h KhjBhžhubeh}”(h]”Œusing-the-device”ah ]”h"]”Œusing the device”ah$]”h&]”uh1hÂhhÄhžhhŸh³h KubhÃ)”}”(hhh]”(hÈ)”}”(hŒEnabling the driver”h]”hŒEnabling the driver”…””}”(hjÅhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhjÂhžhhŸh³h K;ubhØ)”}”(hŒ\The driver is enabled via the standard kernel configuration system, using the make command::”h]”hŒ[The driver is enabled via the standard kernel configuration system, using the make command:”…””}”(hjÓhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh³h K=hjÂhžhubj¦)”}”(hŒmake oldconfig/menuconfig/etc.”h]”hŒmake oldconfig/menuconfig/etc.”…””}”hjásbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j¥hŸh³h K@hjÂhžhubhØ)”}”(hŒ/The driver is located in the menu structure at:”h]”hŒ/The driver is located in the menu structure at:”…””}”(hjïhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh³h KBhjÂhžhubhŒ block_quote”“”)”}”(hŒ§-> Device Drivers -> Network device support (NETDEVICES [=y]) -> Ethernet driver support -> Pensando devices -> Pensando Ethernet PDS_VDPA Support ”h]”hŒdefinition_list”“”)”}”(hhh]”hŒdefinition_list_item”“”)”}”(hŒŸ-> Device Drivers -> Network device support (NETDEVICES [=y]) -> Ethernet driver support -> Pensando devices -> Pensando Ethernet PDS_VDPA Support ”h]”(hŒterm”“”)”}”(hŒ-> Device Drivers”h]”hŒ-> Device Drivers”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jhŸh³h KHhj ubhŒ definition”“”)”}”(hhh]”j)”}”(hhh]”j )”}”(hŒ‡-> Network device support (NETDEVICES [=y]) -> Ethernet driver support -> Pensando devices -> Pensando Ethernet PDS_VDPA Support ”h]”(j)”}”(hŒ+-> Network device support (NETDEVICES [=y])”h]”hŒ+-> Network device support (NETDEVICES [=y])”…””}”(hj*hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jhŸh³h KHhj&ubj)”}”(hhh]”j)”}”(hhh]”j )”}”(hŒW-> Ethernet driver support -> Pensando devices -> Pensando Ethernet PDS_VDPA Support ”h]”(j)”}”(hŒ-> Ethernet driver support”h]”hŒ-> Ethernet driver support”…””}”(hjBhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jhŸh³h KHhj>ubj)”}”(hhh]”j)”}”(hhh]”j )”}”(hŒ:-> Pensando devices -> Pensando Ethernet PDS_VDPA Support ”h]”(j)”}”(hŒ-> Pensando devices”h]”hŒ-> Pensando devices”…””}”(hjZhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jhŸh³h KHhjVubj)”}”(hhh]”hØ)”}”(hŒ%-> Pensando Ethernet PDS_VDPA Support”h]”hŒ%-> Pensando Ethernet PDS_VDPA Support”…””}”(hjkhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh³h KHhjhubah}”(h]”h ]”h"]”h$]”h&]”uh1jhjVubeh}”(h]”h ]”h"]”h$]”h&]”uh1jhŸh³h KHhjSubah}”(h]”h ]”h"]”h$]”h&]”uh1jhjPubah}”(h]”h ]”h"]”h$]”h&]”uh1jhj>ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jhŸh³h KHhj;ubah}”(h]”h ]”h"]”h$]”h&]”uh1jhj8ubah}”(h]”h ]”h"]”h$]”h&]”uh1jhj&ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jhŸh³h KHhj#ubah}”(h]”h ]”h"]”h$]”h&]”uh1jhj ubah}”(h]”h ]”h"]”h$]”h&]”uh1jhj ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jhŸh³h KHhjubah}”(h]”h ]”h"]”h$]”h&]”uh1jhjÿubah}”(h]”h ]”h"]”h$]”h&]”uh1jýhŸh³h KDhjÂhžhubeh}”(h]”Œenabling-the-driver”ah ]”h"]”Œenabling the driver”ah$]”h&]”uh1hÂhhÄhžhhŸh³h K;ubhÃ)”}”(hhh]”(hÈ)”}”(hŒSupport”h]”hŒSupport”…””}”(hjÒhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhjÏhžhhŸh³h KKubhØ)”}”(hŒtFor general Linux networking support, please use the netdev mailing list, which is monitored by Pensando personnel::”h]”hŒsFor general Linux networking support, please use the netdev mailing list, which is monitored by Pensando personnel:”…””}”(hjàhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh³h KMhjÏhžhubj¦)”}”(hŒnetdev@vger.kernel.org”h]”hŒnetdev@vger.kernel.org”…””}”hjîsbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j¥hŸh³h KPhjÏhžhubhØ)”}”(hŒOFor more specific support needs, please use the Pensando driver support email::”h]”hŒNFor more specific support needs, please use the Pensando driver support email:”…””}”(hjühžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh³h KRhjÏhžhubj¦)”}”(hŒdrivers@pensando.io”h]”hŒdrivers@pensando.io”…””}”hj sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j¥hŸh³h KUhjÏhžhubeh}”(h]”Œsupport”ah ]”h"]”Œsupport”ah$]”h&]”uh1hÂhhÄhžhhŸh³h KKubeh}”(h]”Œ9pci-vdpa-driver-for-the-amd-pensando-r-dsc-adapter-family”ah ]”h"]”Œ:pci vdpa driver for the amd/pensando(r) dsc adapter family”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”jKŒ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<j¿j¼jÌjÉjjuŒ nametypes”}”(j%‰j?‰j¿‰j̉j‰uh}”(j"hÄj<hõj¼jBjÉjÂjjÏ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.