€•ö5Œ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ŒPortuguese (Brazilian)”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”ŒC/translations/pt_BR/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”…””}”(hj h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÛhj 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”…””}”(hj$h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j"hjubhŒÙ 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”…””}”(hj6h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j"hjubhŒ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´Khj 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”…””}”(hjYh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÛhjVh²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 ”…””}”(hjgh²hh³Nh´Nubj#)”}”(hŒ ``pds_vdpa``”h]”hŒpds_vdpa”…””}”(hjoh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j"hjgubhŒG device is enabled via multiple configuration steps and depends on the ”…””}”(hjgh²hh³Nh´Nubj#)”}”(hŒ ``pds_core``”h]”hŒpds_core”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j"hjgubhŒ| driver to create and enable SR-IOV Virtual Function devices. After the VFs are enabled, we enable the vDPA service in the ”…””}”(hjgh²hh³Nh´Nubj#)”}”(hŒ ``pds_core``”h]”hŒpds_core”…””}”(hj“h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j"hjgubhŒ9 device to create the auxiliary devices used by pds_vdpa.”…””}”(hjgh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hëh³hÇh´KhjVh²hubhì)”}”(hŒExample steps:”h]”hŒExample steps:”…””}”(hj«h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hëh³hÇh´KhjVh²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´KhjVh²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:”…””}”(hjh²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”…””}”(hj$h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j"h³hÇh´KHhjubhŒ 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&]”uh1j"h³hÇh´KHhj:ubj3)”}”(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”…””}”(hjVh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j"h³hÇh´KHhjRubj3)”}”(hhh]”j)”}”(hhh]”j)”}”(hŒ:-> Pensando devices -> Pensando Ethernet PDS_VDPA Support ”h]”(j#)”}”(hŒ-> Pensando devices”h]”hŒ-> Pensando devices”…””}”(hjnh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j"h³hÇh´KHhjjubj3)”}”(hhh]”hì)”}”(hŒ%-> Pensando Ethernet PDS_VDPA Support”h]”hŒ%-> Pensando Ethernet PDS_VDPA Support”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hëh³hÇh´KHhj|ubah}”(h]”h ]”h"]”h$]”h&]”uh1j2hjjubeh}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´KHhjgubah}”(h]”h ]”h"]”h$]”h&]”uh1jhjdubah}”(h]”h ]”h"]”h$]”h&]”uh1j2hjRubeh}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´KHhjOubah}”(h]”h ]”h"]”h$]”h&]”uh1jhjLubah}”(h]”h ]”h"]”h$]”h&]”uh1j2hj:ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´KHhj7ubah}”(h]”h ]”h"]”h$]”h&]”uh1jhj4ubah}”(h]”h ]”h"]”h$]”h&]”uh1j2hjubeh}”(h]”h ]”h"]”h$]”h&]”uh1jh³hÇh´KHhjubah}”(h]”h ]”h"]”h$]”h&]”uh1jhjubah}”(h]”h ]”h"]”h$]”h&]”uh1jh³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”…””}”hjsbah}”(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:”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hëh³hÇh´KRhjãh²hubjº)”}”(hŒdrivers@pensando.io”h]”hŒdrivers@pensando.io”…””}”hjsbah}”(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”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”}”(j9j6jSjPjÓjÐjàjÝj1j.uŒ nametypes”}”(j9‰jS‰jÓ‰jà‰j1‰uh}”(j6hØjPj jÐjVjÝ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”“”}”…”R”Œparse_messages”]”Œtransform_messages”]”Œ transformer”NŒ include_log”]”Œ decoration”Nh²hub.