From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from zg8tmtyylji0my4xnjqumte4.icoremail.net (zg8tmtyylji0my4xnjqumte4.icoremail.net [162.243.164.118]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 92EB0259C9C; Mon, 17 Aug 2026 02:14:32 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=162.243.164.118 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1786932877; cv=none; b=Lyh07Vljzo8Ryg1S3bBQn0I0X/vqdwquN1kz9W9W5ao1t7aLE4NEdS5yV75jtc1rtwaAc3c/yKSn1mmHZtwlO+wy8aytoEbyD5PJ9JQt46CbQmB9EwHUF2Ea+gh9iZ96foGyLDLoU4uTbgb63Ge881GhIVMy8RZZaHZJcPYFbdA= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1786932877; c=relaxed/simple; bh=icwJaAWU0OUeL/4db6OjGJXk9wMChBc/Hg1WCJ18OJA=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version:Content-Type; b=gQMAGhfGxeA7MoYpf4Wj6K7paqfAONZ3GjEUH8C2p8R1koFzsTU/JgunQUJRCwNtoncWvVgRStj3baeGCaR0ApbuwJl4Nrxa/vFf3M2H5uwAWj0bfd6TQVeY433KMVQrd17zwATI8fhH5e/3H8AXEJG09R5MiVVB5go3b9a6D0c= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=fail (p=quarantine dis=none) header.from=stu.cdut.edu.cn; spf=none smtp.mailfrom=stu.cdut.edu.cn; dkim=fail (0-bit key) header.d=stu.cdut.edu.cn header.i=@stu.cdut.edu.cn header.b=PZnw1oZx reason="key not found in DNS"; arc=none smtp.client-ip=162.243.164.118 Authentication-Results: smtp.subspace.kernel.org; dmarc=fail (p=quarantine dis=none) header.from=stu.cdut.edu.cn Authentication-Results: smtp.subspace.kernel.org; spf=none smtp.mailfrom=stu.cdut.edu.cn Authentication-Results: smtp.subspace.kernel.org; dkim=fail reason="key not found in DNS" (0-bit key) header.d=stu.cdut.edu.cn header.i=@stu.cdut.edu.cn header.b="PZnw1oZx" DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=stu.cdut.edu.cn; s=dkim; h=Received:From:To:Cc:Subject:Date: Message-ID:In-Reply-To:References:MIME-Version:Content-Type: Content-Transfer-Encoding; bh=AFygUGe/NMRez4Rwt8Hk2T5deubKgmEEm9 s7dej5yzY=; b=PZnw1oZxBMW+5PDB1NwyU4Zf0tEpga8/IXsbMHMSCBfafirp69 AfeJFGj3P6IsPiurFvEkSXq0UEy5xcqAT006CLUlepCX9SiHPFGYjjDcpaIGCG/J y/Z0C03kMvk48AB4LTL3M+6GxV/6WMA63JgurZWXHTYomfPG8Hpoti4v0= Received: from anka-20eya00ycd (unknown [182.139.166.85]) by hzbj-edu-front-4.icoremail.net (Coremail) with SMTP id BrQMCkBmycR2boJq_v1jAA--.23758S4; Mon, 17 Aug 2026 10:14:22 +0800 (CST) From: Siwei Chen To: alexs@kernel.org, si.yanteng@linux.dev, dzm91@hust.edu.cn, corbet@lwn.net, skhan@linuxfoundation.org Cc: linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, wy@wyuan.org, Siwei Chen Subject: [PATCH v4 2/5] docs/zh_CN: Add NIC SR-IOV APIs Chinese translation Date: Mon, 17 Aug 2026 10:13:36 +0800 Message-ID: <20260817021340.17318-3-anka@stu.cdut.edu.cn> X-Mailer: git-send-email 2.53.0 In-Reply-To: <20260817021340.17318-1-anka@stu.cdut.edu.cn> References: <20260817021340.17318-1-anka@stu.cdut.edu.cn> Precedence: bulk X-Mailing-List: linux-doc@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-CM-TRANSID:BrQMCkBmycR2boJq_v1jAA--.23758S4 X-Coremail-Antispam: 1UD129KBjvJXoW7Aw15XFyfAw1DAFyxAryxKrg_yoW8Kw1xpF WDKryxKF4xG34UGws3GF17Jry5GF1xC3y5Wrn2q3ZYqrs5Ja40qF47KF9xt3yxWrWFvFWr ZFsYgFW5WrWjy37anT9S1TB71UUUUUDqnTZGkaVYY2UrUUUUjbIjqfuFe4nvWSU5nxnvy2 9KBjDU0xBIdaVrnRJUUUPFb7Iv0xC_Cr1lb4IE77IF4wAFF20E14v26rWj6s0DM7CY07I2 0VC2zVCF04k26cxKx2IYs7xG6rWj6s0DM7CIcVAFz4kK6r1j6r18M28IrcIa0xkI8VA2jI 8067AKxVWUXwA2048vs2IY020Ec7CjxVAFwI0_Gr0_Xr1l8cAvFVAK0II2c7xJM28CjxkF 64kEwVA0rcxSw2x7M28EF7xvwVC0I7IYx2IY67AKxVWUCVW8JwA2z4x0Y4vE2Ix0cI8IcV CY1x0267AKxVW8JVWxJwA2z4x0Y4vEx4A2jsIE14v26r4j6F4UM28EF7xvwVC2z280aVCY 1x0267AKxVW8JVW8Jr1le2I262IYc4CY6c8Ij28IcVAaY2xG8wAqx4xG64xvF2IEw4CE5I 8CrVC2j2WlYx0E2Ix0cI8IcVAFwI0_JrI_JrylYx0Ex4A2jsIE14v26r1j6r4UMcvjeVCF s4IE7xkEbVWUJVW8JwACjcxG0xvY0x0EwIxGrwCY1x0262kKe7AKxVWUtVW8ZwCY02Avz4 vE14v_Gr1l42xK82IYc2Ij64vIr41l4I8I3I0E4IkC6x0Yz7v_Jr0_Gr1lx2IqxVAqx4xG 67AKxVWUJVWUGwC20s026x8GjcxK67AKxVWUGVWUWwC2zVAF1VAY17CE14v26r1q6r43MI IYrxkI7VAKI48JMIIF0xvE2Ix0cI8IcVAFwI0_JFI_Gr1lIxAIcVC0I7IYx2IY6xkF7I0E 14v26r4j6F4UMIIF0xvE42xK8VAvwI8IcIk0rVWUJVWUCwCI42IY6I8E87Iv67AKxVWUJV W8JwCI42IY6I8E87Iv6xkF7I0E14v26r4j6r4UJbIYCTnIWIevJa73UjIFyTuYvjxUcEdg DUUUU X-CM-SenderInfo: ysqsjiqyqsiiiqr623vxofv3vwohv3gofq/1tbiAgUICWqB-hMt-AAEsV From: Siwei Chen Translate .../networking/sriov.rst into Chinese. Update the translation through commit 4558645d139c ("docs: net: document guidance of implementing the SR-IOV NDOs") Signed-off-by: Siwei Chen --- .../translations/zh_CN/networking/index.rst | 2 +- .../translations/zh_CN/networking/sriov.rst | 31 +++++++++++++++++++ 2 files changed, 32 insertions(+), 1 deletion(-) create mode 100644 Documentation/translations/zh_CN/networking/sriov.rst diff --git a/Documentation/translations/zh_CN/networking/index.rst b/Documentation/translations/zh_CN/networking/index.rst index fcb8dc8f2c72..ae374c4cb144 100644 --- a/Documentation/translations/zh_CN/networking/index.rst +++ b/Documentation/translations/zh_CN/networking/index.rst @@ -29,6 +29,7 @@ alias mptcp-sysctl generic-hdlc + sriov team timestamping @@ -128,7 +129,6 @@ Todolist: * secid * seg6-sysctl * smc-sysctl -* sriov * statistics * strparser * switchdev diff --git a/Documentation/translations/zh_CN/networking/sriov.rst b/Documentation/translations/zh_CN/networking/sriov.rst new file mode 100644 index 000000000000..bf37e68f0534 --- /dev/null +++ b/Documentation/translations/zh_CN/networking/sriov.rst @@ -0,0 +1,31 @@ +.. SPDX-License-Identifier: GPL-2.0 + +.. include:: ../disclaimer-zh_CN.rst + +:Original: Documentation/networking/sriov.rst + +:翻译: + + 陈思为 Siwei Chen + +=============== +网卡 SR-IOV API +=============== + +强烈建议现代网卡专注于实现 ``switchdev`` 模型（参见 :ref:`switchdev`） +来配置 SR-IOV 功能的转发与安全。 + +传统 API +======== + +旧的 SR-IOV API 在 ``rtnetlink`` Netlink 协议族中实现，是 ``RTM_GETLINK`` 和 +``RTM_SETLINK`` 命令的一部分。在驱动侧，它由若干 ``ndo_set_vf_*`` 和 +``ndo_get_vf_*`` 回调组成。 + +由于传统 API 与协议栈其余部分集成不佳，该 API 被视为已冻结；不再接受任何新功能或扩展。 +新驱动不应实现那些不常用的回调； +即以下回调禁止使用： + + - ``ndo_get_vf_port`` + - ``ndo_set_vf_port`` + - ``ndo_set_vf_rss_query_en`` -- 2.53.0