€•öŒ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/networking/sriov”Œ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/networking/sriov”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)�”}”(hhh]”hŒItalian”…”�”}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ$/translations/it_IT/networking/sriov”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)�”}”(hhh]”hŒJapanese”…”�”}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ$/translations/ja_JP/networking/sriov”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)�”}”(hhh]”hŒKorean”…”�”}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ$/translations/ko_KR/networking/sriov”Œ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/networking/sriov”Œ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/networking/sriov”Œ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/sriov.rst”h´KubhŒsection”“”)�”}”(hhh]”(hŒtitle”“”)�”}”(hŒNIC SR-IOV APIs”h]”hŒNIC SR-IOV APIs”…”�”}”(hhÏh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhhÊh²hh³hÇh´KubhŒ paragraph”“”)�”}”(hŒ©Modern NICs are strongly encouraged to focus on implementing the ``switchdev`` model (see :ref:`switchdev`) to configure forwarding and security of SR-IOV functionality.”h]”(hŒAModern NICs are strongly encouraged to focus on implementing the ”…”�”}”(hhßh²hh³Nh´NubhŒliteral”“”)�”}”(hŒ ``switchdev``”h]”hŒ switchdev”…”�”}”(hhéh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hçhhßubhŒ model (see ”…”�”}”(hhßh²hh³Nh´Nubh)�”}”(hŒ:ref:`switchdev`”h]”hŒinline”“”)�”}”(hhýh]”hŒ switchdev”…”�”}”(hjh²hh³Nh´Nubah}”(h]”h ]”(Œxref”Œstd”Œstd-ref”eh"]”h$]”h&]”uh1hÿhhûubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”Œnetworking/sriov”Œ refdomain”j Œreftype”Œref”Œ refexplicit”‰Œrefwarn”ˆŒ reftarget”Œ switchdev”uh1hh³hÇh´KhhßubhŒ?) to configure forwarding and security of SR-IOV functionality.”…”�”}”(hhßh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KhhÊh²hubhÉ)�”}”(hhh]”(hÎ)�”}”(hŒ Legacy API”h]”hŒ Legacy API”…”�”}”(hj-h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj*h²hh³hÇh´K ubhÞ)�”}”(hŒÝThe old SR-IOV API is implemented in ``rtnetlink`` Netlink family as part of the ``RTM_GETLINK`` and ``RTM_SETLINK`` commands. On the driver side it consists of a number of ``ndo_set_vf_*`` and ``ndo_get_vf_*`` callbacks.”h]”(hŒ%The old SR-IOV API is implemented in ”…”�”}”(hj;h²hh³Nh´Nubhè)�”}”(hŒ ``rtnetlink``”h]”hŒ rtnetlink”…”�”}”(hjCh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hçhj;ubhŒ Netlink family as part of the ”…”�”}”(hj;h²hh³Nh´Nubhè)�”}”(hŒ``RTM_GETLINK``”h]”hŒ RTM_GETLINK”…”�”}”(hjUh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hçhj;ubhŒ and ”…”�”}”(hj;h²hh³Nh´Nubhè)�”}”(hŒ``RTM_SETLINK``”h]”hŒ RTM_SETLINK”…”�”}”(hjgh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hçhj;ubhŒ9 commands. On the driver side it consists of a number of ”…”�”}”(hj;h²hh³Nh´Nubhè)�”}”(hŒ``ndo_set_vf_*``”h]”hŒ ndo_set_vf_*”…”�”}”(hjyh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hçhj;ubhŒ and ”…”�”}”hj;sbhè)�”}”(hŒ``ndo_get_vf_*``”h]”hŒ ndo_get_vf_*”…”�”}”(hj‹h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hçhj;ubhŒ callbacks.”…”�”}”(hj;h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Khj*h²hubhÞ)�”}”(hXSince the legacy APIs do not integrate well with the rest of the stack the API is considered frozen; no new functionality or extensions will be accepted. New drivers should not implement the uncommon callbacks; namely the following callbacks are off limits:”h]”hXSince the legacy APIs do not integrate well with the rest of the stack the API is considered frozen; no new functionality or extensions will be accepted. New drivers should not implement the uncommon callbacks; namely the following callbacks are off limits:”…”�”}”(hj£h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Khj*h²hubhŒ block_quote”“”)�”}”(hŒI- ``ndo_get_vf_port`` - ``ndo_set_vf_port`` - ``ndo_set_vf_rss_query_en``”h]”hŒ bullet_list”“”)�”}”(hhh]”(hŒ list_item”“”)�”}”(hŒ``ndo_get_vf_port``”h]”hÞ)�”}”(hjÀh]”hè)�”}”(hjÀh]”hŒndo_get_vf_port”…”�”}”(hjÅh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hçhjÂubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Khj¾ubah}”(h]”h ]”h"]”h$]”h&]”uh1j¼hj¹ubj½)�”}”(hŒ``ndo_set_vf_port``”h]”hÞ)�”}”(hjàh]”hè)�”}”(hjàh]”hŒndo_set_vf_port”…”�”}”(hjåh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hçhjâubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KhjÞubah}”(h]”h ]”h"]”h$]”h&]”uh1j¼hj¹ubj½)�”}”(hŒ``ndo_set_vf_rss_query_en``”h]”hÞ)�”}”(hjh]”hè)�”}”(hjh]”hŒndo_set_vf_rss_query_en”…”�”}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hçhjubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Khjþubah}”(h]”h ]”h"]”h$]”h&]”uh1j¼hj¹ubeh}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ-”uh1j·h³hÇh´Khj³ubah}”(h]”h ]”h"]”h$]”h&]”uh1j±h³hÇh´Khj*h²hubeh}”(h]”Œ legacy-api”ah ]”h"]”Œ legacy api”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´K ubeh}”(h]”Œnic-sr-iov-apis”ah ]”h"]”Œnic sr-iov apis”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”}”(j9j6j1j.uŒ nametypes”}”(j9‰j1‰uh}”(j6hÊ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.