| lists.openwall.net | lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC | |
|
Open Source and information security mailing list archives
| ||
|
Message-ID: <202506261856010460uy5H5tAhfJzQXZaIk8-a@zte.com.cn>
Date: Thu, 26 Jun 2025 18:56:01 +0800 (CST)
From: <jiang.kun2@....com.cn>
To: <alexs@...nel.org>, <si.yanteng@...ux.dev>, <corbet@....net>,
<linux-doc@...r.kernel.org>, <linux-kernel@...r.kernel.org>
Cc: <xu.xin16@....com.cn>, <yang.yang29@....com.cn>, <wang.yaxin@....com.cn>,
<fan.yu9@....com.cn>, <he.peilin@....com.cn>, <tu.qiang35@....com.cn>,
<qiu.yutan@....com.cn>, <zhang.yunkai@....com.cn>,
<ye.xingchen@....com.cn>
Subject: [PATCH 3/3 linux next v2] Docs/zh_CN: Translate netmem.rst
to Simplified Chinese
From: Wang Yaxin <wang.yaxin@....com.cn>
translate the "netmem.rst" into Simplified Chinese.
Update to commit 383faec0fd64("net: enable driver support for
netmem TX")
Signed-off-by: Wang Yaxin <wang.yaxin@....com.cn>
Signed-off-by: Jiang Kun <jiang.kun2@....com.cn>
Reviewed-by: xu xin <xu.xin16@....com.cn>
---
v1->v2:
1. add reviewer tag.
.../translations/zh_CN/networking/index.rst | 2 +-
.../translations/zh_CN/networking/netmem.rst | 92 +++++++++++++++++++
2 files changed, 93 insertions(+), 1 deletion(-)
create mode 100644 Documentation/translations/zh_CN/networking/netmem.rst
diff --git a/Documentation/translations/zh_CN/networking/index.rst b/Documentation/translations/zh_CN/networking/index.rst
index 4cf09b60b3f0..e646b019598c 100644
--- a/Documentation/translations/zh_CN/networking/index.rst
+++ b/Documentation/translations/zh_CN/networking/index.rst
@@ -24,6 +24,7 @@
napi.rst
netif-msg
xfrm_proc
+ netmem
Todolist:
@@ -102,7 +103,6 @@ Todolist:
* netdev-features
* netdevices
* netfilter-sysctl
-* netmem
* nexthop-group-resilient
* nf_conntrack-sysctl
* nf_flowtable
diff --git a/Documentation/translations/zh_CN/networking/netmem.rst b/Documentation/translations/zh_CN/networking/netmem.rst
new file mode 100644
index 000000000000..fe351a240f02
--- /dev/null
+++ b/Documentation/translations/zh_CN/networking/netmem.rst
@@ -0,0 +1,92 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+.. include:: ../disclaimer-zh_CN.rst
+
+:Original: Documentation/networking/netmem.rst
+
+:翻译:
+
+ 王亚鑫 Wang Yaxin <wang.yaxin@....com.cn>
+
+==================
+网络驱动支持Netmem
+==================
+
+本文档概述了网络驱动支持netmem（一种抽象内存类型）的要求，该内存类型
+支持设备内存 TCP 等功能。通过支持netmem，驱动可以灵活适配不同底层内
+存类型（如设备内存TCP），且无需或仅需少量修改。
+
+Netmem的优势：
+
+* 灵活性：netmem 可由不同内存类型（如 struct page、DMA-buf）支持，
+ 使驱动程序能够支持设备内存 TCP 等各种用例。
+* 前瞻性：支持netmem的驱动可无缝适配未来依赖此功能的新特性。
+* 简化开发：驱动通过统一API与netmem交互，无需关注底层内存的实现差异。
+
+驱动RX要求
+==========
+
+1. 驱动必须支持page_pool。
+
+2. 驱动必须支持tcp-data-split ethtool选项。
+
+3. 驱动必须使用page_pool netmem API处理有效载荷内存。当前netmem API
+ 与page API一一对应。转换时需要将page API替换为netmem API，并用驱动
+ 中的netmem_refs跟踪内存而非 `struct page *`：
+
+ - page_pool_alloc -> page_pool_alloc_netmem
+ - page_pool_get_dma_addr -> page_pool_get_dma_addr_netmem
+ - page_pool_put_page -> page_pool_put_netmem
+
+ 目前并非所有页 pageAPI 都有对应的 netmem 等效接口。如果你的驱动程序
+ 依赖某个尚未实现的 netmem API，请直接实现并提交至 netdev@邮件列表，
+ 或联系维护者及 almasrymina@...gle.com 协助添加该 netmem API。
+
+4. 驱动必须设置以下PP_FLAGS：
+
+ - PP_FLAG_DMA_MAP：驱动程序无法对 netmem 执行 DMA 映射。此时驱动
+ 程序必须将 DMA 映射操作委托给 page_pool，由其判断何时适合（或不适合）
+ 进行 DMA 映射。
+ - PP_FLAG_DMA_SYNC_DEV：驱动程序无法保证 netmem 的 DMA 地址一定能
+ 完成 DMA 同步。此时驱动程序必须将 DMA 同步操作委托给 page_pool，由
+ 其判断何时适合（或不适合）进行 DMA 同步。
+ - PP_FLAG_ALLOW_UNREADABLE_NETMEM：仅当启用 tcp-data-split 时，
+ 驱动程序必须显式设置此标志。
+
+5. 驱动不得假设netmem可读或基于页。当netmem_address()返回NULL时，表示
+内存不可读。驱动需正确处理不可读的netmem，例如，当netmem_address()返回
+NULL时，避免访问内容。
+
+ 理想情况下，驱动程序不应通过netmem_is_net_iov()等辅助函数检查底层
+ netmem 类型，也不应通过netmem_to_page()或netmem_to_net_iov()将
+ netmem 转换为其底层类型。在大多数情况下，系统会提供抽象这些复杂性的
+ netmem 或 page_pool 辅助函数（并可根据需要添加更多）。
+
+6. 驱动程序必须使用page_pool_dma_sync_netmem_for_cpu()代替dma_sync_single_range_for_cpu()。
+对于某些内存提供者，CPU 的 DMA 同步将由 page_pool 完成；而对于其他提供者
+（特别是 dmabuf 内存提供者），CPU 的 DMA 同步由使用 dmabuf API 的用户空
+间负责。驱动程序必须将整个 DMA 同步操作委托给 page_pool，以确保操作正确执行。
+
+7. 避免在 page_pool 之上实现特定于驱动程序内存回收机制。由于 netmem 可能
+不由struct page支持，驱动程序不能保留struct page来进行自定义回收。不过，
+可为此目的通过page_pool_fragment_netmem()或page_pool_ref_netmem()保留
+page_pool 引用，但需注意某些 netmem 类型的循环时间可能更长（例如零拷贝场景
+下用户空间持有引用的情况）。
+
+驱动TX要求
+==========
+
+1. 驱动程序绝对不能直接把 netmem 的 dma_addr 传递给任何 dma-mapping API。这
+是由于 netmem 的 dma_addr 可能源自 dma-buf 这类和 dma-mapping API 不兼容的
+源头。
+
+应当使用netmem_dma_unmap_page_attrs()和netmem_dma_unmap_addr_set()等辅助
+函数来替代dma_unmap_page[_attrs]()、dma_unmap_addr_set()。不管 dma_addr
+来源如何，netmem 的这些变体都能正确处理 netmem dma_addr，在合适的时候会委托给
+dma-mapping API 去处理。
+
+目前，并非所有的 dma-mapping API 都有对应的 netmem 版本。要是你的驱动程序需要
+使用某个还不存在的 netmem API，你可以自行添加并提交到 netdev@，也可以联系维护
+人员或者发送邮件至 almasrymina@...gle.com 寻求帮助。
+
+2. 驱动程序应通过设置 netdev->netmem_tx = true 来表明自身支持 netmem 功能。
--
2.25.1
<div class="zcontentRow"><div style="font-size:14px;font-family:微软雅黑,Microsoft YaHei;line-height:1.5"><div style="line-height:1.5">From: Wang Yaxin <wang.yaxin@....com.cn></div><div style="line-height:1.5"><br></div><div style="line-height:1.5">translate the "netmem.rst" into Simplified Chinese.</div><div style="line-height:1.5"><br></div><div style="line-height:1.5">Update to commit 383faec0fd64("net: enable driver support for</div><div style="line-height:1.5"> netmem TX")</div><div style="line-height:1.5"><br></div><div style="line-height:1.5">Signed-off-by: Wang Yaxin <wang.yaxin@....com.cn></div><div style="line-height:1.5">Signed-off-by: Jiang Kun <jiang.kun2@....com.cn></div><div style="line-height:1.5">Reviewed-by: xu xin <xu.xin16@....com.cn></div><div style="line-height:1.5">---</div><div style="line-height:1.5">v1->v2:</div><div style="line-height:1.5">1. add reviewer tag.</div><div style="line-height:1.5"><br></div><div style="line-height:1.5"> .../translations/zh_CN/networking/index.rst | 2 +-</div><div style="line-height:1.5"> .../translations/zh_CN/networking/netmem.rst | 92 +++++++++++++++++++</div><div style="line-height:1.5"> 2 files changed, 93 insertions(+), 1 deletion(-)</div><div style="line-height:1.5"> create mode 100644 Documentation/translations/zh_CN/networking/netmem.rst</div><div style="line-height:1.5"><br></div><div style="line-height:1.5">diff --git a/Documentation/translations/zh_CN/networking/index.rst b/Documentation/translations/zh_CN/networking/index.rst</div><div style="line-height:1.5">index 4cf09b60b3f0..e646b019598c 100644</div><div style="line-height:1.5">--- a/Documentation/translations/zh_CN/networking/index.rst</div><div style="line-height:1.5">+++ b/Documentation/translations/zh_CN/networking/index.rst</div><div style="line-height:1.5">@@ -24,6 +24,7 @@</div><div style="line-height:1.5"> napi.rst</div><div style="line-height:1.5"> netif-msg</div><div style="line-height:1.5"> xfrm_proc</div><div style="line-height:1.5">+ netmem</div><div style="line-height:1.5"> </div><div style="line-height:1.5"> Todolist:</div><div style="line-height:1.5"> </div><div style="line-height:1.5">@@ -102,7 +103,6 @@ Todolist:</div><div style="line-height:1.5"> * netdev-features</div><div style="line-height:1.5"> * netdevices</div><div style="line-height:1.5"> * netfilter-sysctl</div><div style="line-height:1.5">-* netmem</div><div style="line-height:1.5"> * nexthop-group-resilient</div><div style="line-height:1.5"> * nf_conntrack-sysctl</div><div style="line-height:1.5"> * nf_flowtable</div><div style="line-height:1.5">diff --git a/Documentation/translations/zh_CN/networking/netmem.rst b/Documentation/translations/zh_CN/networking/netmem.rst</div><div style="line-height:1.5">new file mode 100644</div><div style="line-height:1.5">index 000000000000..fe351a240f02</div><div style="line-height:1.5">--- /dev/null</div><div style="line-height:1.5">+++ b/Documentation/translations/zh_CN/networking/netmem.rst</div><div style="line-height:1.5">@@ -0,0 +1,92 @@</div><div style="line-height:1.5">+.. SPDX-License-Identifier: GPL-2.0</div><div style="line-height:1.5">+</div><div style="line-height:1.5">+.. include:: ../disclaimer-zh_CN.rst</div><div style="line-height:1.5">+</div><div style="line-height:1.5">+:Original: Documentation/networking/netmem.rst</div><div style="line-height:1.5">+</div><div style="line-height:1.5">+:翻译:</div><div style="line-height:1.5">+</div><div style="line-height:1.5">+ 王亚鑫 Wang Yaxin <wang.yaxin@....com.cn></div><div style="line-height:1.5">+</div><div style="line-height:1.5">+==================</div><div style="line-height:1.5">+网络驱动支持Netmem</div><div style="line-height:1.5">+==================</div><div style="line-height:1.5">+</div><div style="line-height:1.5">+本文档概述了网络驱动支持netmem（一种抽象内存类型）的要求，该内存类型</div><div style="line-height:1.5">+支持设备内存 TCP 等功能。通过支持netmem，驱动可以灵活适配不同底层内</div><div style="line-height:1.5">+存类型（如设备内存TCP），且无需或仅需少量修改。</div><div style="line-height:1.5">+</div><div style="line-height:1.5">+Netmem的优势：</div><div style="line-height:1.5">+</div><div style="line-height:1.5">+* 灵活性：netmem 可由不同内存类型（如 struct page、DMA-buf）支持，</div><div style="line-height:1.5">+ 使驱动程序能够支持设备内存 TCP 等各种用例。</div><div style="line-height:1.5">+* 前瞻性：支持netmem的驱动可无缝适配未来依赖此功能的新特性。</div><div style="line-height:1.5">+* 简化开发：驱动通过统一API与netmem交互，无需关注底层内存的实现差异。</div><div style="line-height:1.5">+</div><div style="line-height:1.5">+驱动RX要求</div><div style="line-height:1.5">+==========</div><div style="line-height:1.5">+</div><div style="line-height:1.5">+1. 驱动必须支持page_pool。</div><div style="line-height:1.5">+</div><div style="line-height:1.5">+2. 驱动必须支持tcp-data-split ethtool选项。</div><div style="line-height:1.5">+</div><div style="line-height:1.5">+3. 驱动必须使用page_pool netmem API处理有效载荷内存。当前netmem API</div><div style="line-height:1.5">+ 与page API一一对应。转换时需要将page API替换为netmem API，并用驱动</div><div style="line-height:1.5">+ 中的netmem_refs跟踪内存而非 `struct page *`：</div><div style="line-height:1.5">+</div><div style="line-height:1.5">+ - page_pool_alloc -> page_pool_alloc_netmem</div><div style="line-height:1.5">+ - page_pool_get_dma_addr -> page_pool_get_dma_addr_netmem</div><div style="line-height:1.5">+ - page_pool_put_page -> page_pool_put_netmem</div><div style="line-height:1.5">+</div><div style="line-height:1.5">+ 目前并非所有页 pageAPI 都有对应的 netmem 等效接口。如果你的驱动程序</div><div style="line-height:1.5">+ 依赖某个尚未实现的 netmem API，请直接实现并提交至 netdev@邮件列表，</div><div style="line-height:1.5">+ 或联系维护者及 almasrymina@...gle.com 协助添加该 netmem API。</div><div style="line-height:1.5">+</div><div style="line-height:1.5">+4. 驱动必须设置以下PP_FLAGS：</div><div style="line-height:1.5">+</div><div style="line-height:1.5">+ - PP_FLAG_DMA_MAP：驱动程序无法对 netmem 执行 DMA 映射。此时驱动</div><div style="line-height:1.5">+ 程序必须将 DMA 映射操作委托给 page_pool，由其判断何时适合（或不适合）</div><div style="line-height:1.5">+ 进行 DMA 映射。</div><div style="line-height:1.5">+ - PP_FLAG_DMA_SYNC_DEV：驱动程序无法保证 netmem 的 DMA 地址一定能</div><div style="line-height:1.5">+ 完成 DMA 同步。此时驱动程序必须将 DMA 同步操作委托给 page_pool，由</div><div style="line-height:1.5">+ 其判断何时适合（或不适合）进行 DMA 同步。</div><div style="line-height:1.5">+ - PP_FLAG_ALLOW_UNREADABLE_NETMEM：仅当启用 tcp-data-split 时，</div><div style="line-height:1.5">+ 驱动程序必须显式设置此标志。</div><div style="line-height:1.5">+</div><div style="line-height:1.5">+5. 驱动不得假设netmem可读或基于页。当netmem_address()返回NULL时，表示</div><div style="line-height:1.5">+内存不可读。驱动需正确处理不可读的netmem，例如，当netmem_address()返回</div><div style="line-height:1.5">+NULL时，避免访问内容。</div><div style="line-height:1.5">+</div><div style="line-height:1.5">+ 理想情况下，驱动程序不应通过netmem_is_net_iov()等辅助函数检查底层</div><div style="line-height:1.5">+ netmem 类型，也不应通过netmem_to_page()或netmem_to_net_iov()将</div><div style="line-height:1.5">+ netmem 转换为其底层类型。在大多数情况下，系统会提供抽象这些复杂性的</div><div style="line-height:1.5">+ netmem 或 page_pool 辅助函数（并可根据需要添加更多）。</div><div style="line-height:1.5">+</div><div style="line-height:1.5">+6. 驱动程序必须使用page_pool_dma_sync_netmem_for_cpu()代替dma_sync_single_range_for_cpu()。</div><div style="line-height:1.5">+对于某些内存提供者，CPU 的 DMA 同步将由 page_pool 完成；而对于其他提供者</div><div style="line-height:1.5">+（特别是 dmabuf 内存提供者），CPU 的 DMA 同步由使用 dmabuf API 的用户空</div><div style="line-height:1.5">+间负责。驱动程序必须将整个 DMA 同步操作委托给 page_pool，以确保操作正确执行。</div><div style="line-height:1.5">+</div><div style="line-height:1.5">+7. 避免在 page_pool 之上实现特定于驱动程序内存回收机制。由于 netmem 可能</div><div style="line-height:1.5">+不由struct page支持，驱动程序不能保留struct page来进行自定义回收。不过，</div><div style="line-height:1.5">+可为此目的通过page_pool_fragment_netmem()或page_pool_ref_netmem()保留</div><div style="line-height:1.5">+page_pool 引用，但需注意某些 netmem 类型的循环时间可能更长（例如零拷贝场景</div><div style="line-height:1.5">+下用户空间持有引用的情况）。</div><div style="line-height:1.5">+</div><div style="line-height:1.5">+驱动TX要求</div><div style="line-height:1.5">+==========</div><div style="line-height:1.5">+</div><div style="line-height:1.5">+1. 驱动程序绝对不能直接把 netmem 的 dma_addr 传递给任何 dma-mapping API。这</div><div style="line-height:1.5">+是由于 netmem 的 dma_addr 可能源自 dma-buf 这类和 dma-mapping API 不兼容的</div><div style="line-height:1.5">+源头。</div><div style="line-height:1.5">+</div><div style="line-height:1.5">+应当使用netmem_dma_unmap_page_attrs()和netmem_dma_unmap_addr_set()等辅助</div><div style="line-height:1.5">+函数来替代dma_unmap_page[_attrs]()、dma_unmap_addr_set()。不管 dma_addr</div><div style="line-height:1.5">+来源如何，netmem 的这些变体都能正确处理 netmem dma_addr，在合适的时候会委托给</div><div style="line-height:1.5">+dma-mapping API 去处理。</div><div style="line-height:1.5">+</div><div style="line-height:1.5">+目前，并非所有的 dma-mapping API 都有对应的 netmem 版本。要是你的驱动程序需要</div><div style="line-height:1.5">+使用某个还不存在的 netmem API，你可以自行添加并提交到 netdev@，也可以联系维护</div><div style="line-height:1.5">+人员或者发送邮件至 almasrymina@...gle.com 寻求帮助。</div><div style="line-height:1.5">+</div><div style="line-height:1.5">+2. 驱动程序应通过设置 netdev->netmem_tx = true 来表明自身支持 netmem 功能。</div><div style="line-height:1.5">-- </div><div style="line-height:1.5">2.25.1</div></div><br><br><br><br><br><div><br></div></div>
Powered by blists - more mailing lists