docs/zh_CN: add infiniband translation
Subsystems (2)
v4 cover docs/zh_CN: add infiniband translation
v4:
Modified a word under Puyu advices; [PATCH 8/8]
v3:
* Modified some words under Alex's advices;
* pick Review-by tags.
v2:
* Modified some words under Alex's and Puyu advices; Thanks for their review!
* add 校译者(proofreading) sign.If you don't want me to do this, please let me know.
*--CC [email protected]
Yanteng Si (8):
docs/zh_CN: add infiniband index translation docs/zh_CN: add infiniband core_locking translation docs/zh_CN: add infiniband ipoib translation docs/zh_CN: add infiniband opa_vnic translation docs/zh_CN: add infiniband sysfs translation docs/zh_CN: add infiniband tag_matching translation docs/zh_CN: add infiniband user_mad translation docs/zh_CN: add infiniband user_verbs translation
Documentation/translations/zh_CN/index.rst | 2 +- .../zh_CN/infiniband/core_locking.rst | 115 ++++++++++++ .../translations/zh_CN/infiniband/index.rst | 40 +++++ .../translations/zh_CN/infiniband/ipoib.rst | 111 ++++++++++++ .../zh_CN/infiniband/opa_vnic.rst | 156 +++++++++++++++++ .../translations/zh_CN/infiniband/sysfs.rst | 21 +++ .../zh_CN/infiniband/tag_matching.rst | 63 +++++++ .../zh_CN/infiniband/user_mad.rst | 164 ++++++++++++++++++ .../zh_CN/infiniband/user_verbs.rst | 72 ++++++++ 9 files changed, 743 insertions(+), 1 deletion(-) create mode 100644 Documentation/translations/zh_CN/infiniband/core_locking.rst create mode 100644 Documentation/translations/zh_CN/infiniband/index.rst create mode 100644 Documentation/translations/zh_CN/infiniband/ipoib.rst create mode 100644 Documentation/translations/zh_CN/infiniband/opa_vnic.rst create mode 100644 Documentation/translations/zh_CN/infiniband/sysfs.rst create mode 100644 Documentation/translations/zh_CN/infiniband/tag_matching.rst create mode 100644 Documentation/translations/zh_CN/infiniband/user_mad.rst create mode 100644 Documentation/translations/zh_CN/infiniband/user_verbs.rst
Signature · 1 line
2.27.0
PATCH v4 1/8 docs/zh_CN: add infiniband index translation
Translate Documentation/infiniband/index.rst into Chinese.
--- Documentation/translations/zh_CN/index.rst | 2 +- .../translations/zh_CN/infiniband/index.rst | 40 +++++++++++++++++++ 2 files changed, 41 insertions(+), 1 deletion(-) create mode 100644 Documentation/translations/zh_CN/infiniband/index.rst
Documentation/translations/zh_CN/index.rst +1 -1
@@ -102,6 +102,7 @@ TODOList: iio/index sound/index filesystems/index + infiniband/index TODOList:
@@ -116,7 +117,6 @@ TODOList: * hid/index * i2c/index * isdn/index -* infiniband/index * leds/index * netlabel/index * networking/index
Documentation/translations/zh_CN/infiniband/index.rst new file +40 -0
@@ -0,0 +1,40 @@ +.. SPDX-License-Identifier: GPL-2.0 + +.. include:: ../disclaimer-zh_CN.rst + +:Original: Documentation/infiniband/index.rst + +:翻译: + + 司延腾 Yanteng Si <[email protected]> + +:校译: + + 王普宇 Puyu Wang <[email protected]> + 时奎亮 Alex Shi <[email protected]> + +.. _cn_infiniband_index: + +========== +infiniband +========== + +.. toctree:: + :maxdepth: 1 + +TODOLIST: + + core_locking + ipoib + opa_vnic + sysfs + tag_matching + user_mad + user_verbs + +.. only:: subproject and html + + Indices + ======= + + * :ref:`genindex`
Signature · 1 line
2.27.0
PATCH v4 2/8 docs/zh_CN: add infiniband core_locking translation
In reply to Yanteng SiTranslate Documentation/infiniband/core_locking.rst into Chinese.
--- .../zh_CN/infiniband/core_locking.rst | 115 ++++++++++++++++++ .../translations/zh_CN/infiniband/index.rst | 3 +- 2 files changed, 117 insertions(+), 1 deletion(-) create mode 100644 Documentation/translations/zh_CN/infiniband/core_locking.rst
Documentation/translations/zh_CN/infiniband/core_locking.rst new file +115 -0
@@ -0,0 +1,115 @@ + +.. include:: ../disclaimer-zh_CN.rst + +:Original: Documentation/infiniband/core_locking.rst + +:翻译: + + 司延腾 Yanteng Si <[email protected]> + +:校译: + + 王普宇 Puyu Wang <[email protected]> + 时奎亮 Alex Shi <[email protected]> + +.. _cn_infiniband_core_locking: + +================== +infiniband中间层锁 +================== + + 本指南试图明确infiniband中间层的锁假设。它描述了对位于中间层以下的低 + 级驱动程序和使用中间层的上层协议的要求。 + +睡眠和中断环境 +============== + + 除了以下异常情况,ib_device结构体中所有方法的低级驱动实现都可以睡眠。 + 这些异常情况是列表中的任意的方法: + + - create_ah + - modify_ah + - query_ah + - destroy_ah + - post_send + - post_recv + - poll_cq + - req_notify_cq + + 他们可能不可以睡眠,而且必须可以从任何上下文中调用。 + + 向上层协议使用者输出的相应函数: + + - rdma_create_ah + - rdma_modify_ah + - rdma_query_ah + - rdma_destroy_ah + - ib_post_send + - ib_post_recv + - ib_req_notify_cq + + 因此,在任何情况下都可以安全调用(它们)。 + + 此外,该函数 + + - ib_dispatch_event + + 被底层驱动用来通过中间层调度异步事件的“A”,也可以从任何上下文中安全调 + 用。 + +可重入性 +-------- + + 由低级驱动程序导出的ib_device结构体中的所有方法必须是完全可重入的。 + 即使使用同一对象的多个函数调用被同时运行,低级驱动程序也需要执行所有 + 必要的同步以保持一致性。 + + IB中间层不执行任何函数调用的序列化。 + + 因为低级驱动程序是可重入的,所以不要求上层协议使用者任何顺序执行。然 + 而,为了得到合理的结果,可能需要一些顺序。例如,一个使用者可以在多个 + CPU上同时安全地调用ib_poll_cq()。然而,不同的ib_poll_cq()调用之间 + 的工作完成信息的顺序没有被定义。 + +回调 +---- + + 低级驱动程序不得直接从与ib_device方法调用相同的调用链中执行回调。例 + 如,低级驱动程序不允许从post_send方法直接调用使用者的完成事件处理程 + 序。相反,低级驱动程序应该推迟这个回调,例如,调度一个tasklet来执行 + 这个回调。 + + 低层驱动负责确保同一CQ的多个完成事件处理程序不被同时调用。驱动程序必 + 须保证一个给定的CQ的事件处理程序在同一时间只有一个在运行。换句话说, + 以下情况是不允许的:: + + CPU1 CPU2 + + low-level driver -> + consumer CQ event callback: + /* ... */ + ib_req_notify_cq(cq, ...); + low-level driver -> + /* ... */ consumer CQ event callback: + /* ... */ + return from CQ event handler + + 完成事件和异步事件回调的运行环境没有被定义。 根据低级别的驱动程序,它可能是 + 进程上下文、softirq上下文或中断上下文。上层协议使用者可能不会在回调中睡眠。 + +热插拔 +------ + + 当一个低级驱动程序调用ib_register_device()时,它宣布一个设备已经 + 准备好供使用者使用,所有的初始化必须在这个调用之前完成。设备必须保 + 持可用,直到驱动对ib_unregister_device()的调用返回。 + + 低级驱动程序必须从进程上下文调用ib_register_device()和 + ib_unregister_device()。如果使用者在这些调用中回调到驱动程序,它 + 不能持有任何可能导致死锁的semaphores。 + + 一旦其结构体ib_client的add方法被调用,上层协议使用者就可以开始使用 + 一个IB设备。使用者必须在从移除方法返回之前完成所有的清理工作并释放 + 与设备相关的所有资源。 + + 使用者被允许在其添加和删除方法中睡眠。
Documentation/translations/zh_CN/infiniband/index.rst +2 -1
@@ -22,9 +22,10 @@ infiniband .. toctree:: :maxdepth: 1 + core_locking + TODOLIST: - core_locking ipoib opa_vnic sysfs
Signature · 1 line
2.27.0
PATCH v4 3/8 docs/zh_CN: add infiniband ipoib translation
In reply to Yanteng SiTranslate Documentation/infiniband/ipoib.rst into Chinese.
--- .../translations/zh_CN/infiniband/index.rst | 2 +- .../translations/zh_CN/infiniband/ipoib.rst | 111 ++++++++++++++++++ 2 files changed, 112 insertions(+), 1 deletion(-) create mode 100644 Documentation/translations/zh_CN/infiniband/ipoib.rst
Documentation/translations/zh_CN/infiniband/index.rst +1 -1
@@ -23,10 +23,10 @@ infiniband :maxdepth: 1 core_locking + ipoib TODOLIST: - ipoib opa_vnic sysfs tag_matching
Documentation/translations/zh_CN/infiniband/ipoib.rst new file +111 -0
111 lines not on this page · raw message
Signature · 1 line
2.27.0
PATCH v4 4/8 docs/zh_CN: add infiniband opa_vnic translation
In reply to Yanteng SiTranslate Documentation/infiniband/opa_vnic.rst into Chinese.
--- .../translations/zh_CN/infiniband/index.rst | 2 +- .../zh_CN/infiniband/opa_vnic.rst | 156 ++++++++++++++++++ 2 files changed, 157 insertions(+), 1 deletion(-) create mode 100644 Documentation/translations/zh_CN/infiniband/opa_vnic.rst
Documentation/translations/zh_CN/infiniband/index.rst +1 -1
@@ -24,10 +24,10 @@ infiniband core_locking ipoib + opa_vnic TODOLIST: - opa_vnic sysfs tag_matching user_mad
Documentation/translations/zh_CN/infiniband/opa_vnic.rst new file +156 -0
156 lines not on this page · raw message
Signature · 1 line
2.27.0
PATCH v4 5/8 docs/zh_CN: add infiniband sysfs translation
In reply to Yanteng SiTranslate Documentation/infiniband/sysfs.rst into Chinese.
--- .../translations/zh_CN/infiniband/index.rst | 2 +- .../translations/zh_CN/infiniband/sysfs.rst | 21 +++++++++++++++++++ 2 files changed, 22 insertions(+), 1 deletion(-) create mode 100644 Documentation/translations/zh_CN/infiniband/sysfs.rst
Documentation/translations/zh_CN/infiniband/index.rst +1 -1
@@ -25,10 +25,10 @@ infiniband core_locking ipoib opa_vnic + sysfs TODOLIST: - sysfs tag_matching user_mad user_verbs
Documentation/translations/zh_CN/infiniband/sysfs.rst new file +21 -0
@@ -0,0 +1,21 @@ +.. include:: ../disclaimer-zh_CN.rst + +:Original: Documentation/infiniband/sysfs.rst + +:翻译: + + 司延腾 Yanteng Si <[email protected]> + +:校译: + + 王普宇 Puyu Wang <[email protected]> + 时奎亮 Alex Shi <[email protected]> + +.. _cn_infiniband_sysfs: + +========= +Sysfs文件 +========= + +sysfs接口已移至 +Documentation/ABI/stable/sysfs-class-infiniband.
Signature · 1 line
2.27.0
PATCH v4 6/8 docs/zh_CN: add infiniband tag_matching translation
In reply to Yanteng SiTranslate Documentation/infiniband/tag_matching.rst into Chinese.
--- .../translations/zh_CN/infiniband/index.rst | 2 +- .../zh_CN/infiniband/tag_matching.rst | 63 +++++++++++++++++++ 2 files changed, 64 insertions(+), 1 deletion(-) create mode 100644 Documentation/translations/zh_CN/infiniband/tag_matching.rst
Documentation/translations/zh_CN/infiniband/index.rst +1 -1
@@ -26,10 +26,10 @@ infiniband ipoib opa_vnic sysfs + tag_matching TODOLIST: - tag_matching user_mad user_verbs
Documentation/translations/zh_CN/infiniband/tag_matching.rst new file +63 -0
63 lines not on this page · raw message
Signature · 1 line
2.27.0
PATCH v4 7/8 docs/zh_CN: add infiniband user_mad translation
In reply to Yanteng SiTranslate Documentation/infiniband/user_mad.rst into Chinese.
--- .../translations/zh_CN/infiniband/index.rst | 2 +- .../zh_CN/infiniband/user_mad.rst | 164 ++++++++++++++++++ 2 files changed, 165 insertions(+), 1 deletion(-) create mode 100644 Documentation/translations/zh_CN/infiniband/user_mad.rst
Documentation/translations/zh_CN/infiniband/index.rst +1 -1
@@ -27,10 +27,10 @@ infiniband opa_vnic sysfs tag_matching + user_mad TODOLIST: - user_mad user_verbs .. only:: subproject and html
Documentation/translations/zh_CN/infiniband/user_mad.rst new file +164 -0
164 lines not on this page · raw message
Signature · 1 line
2.27.0
PATCH v4 8/8 docs/zh_CN: add infiniband user_verbs translation
In reply to Yanteng SiTranslate Documentation/infiniband/user_verbs.rst into Chinese.
--- .../translations/zh_CN/infiniband/index.rst | 3 +- .../zh_CN/infiniband/user_verbs.rst | 72 +++++++++++++++++++ 2 files changed, 73 insertions(+), 2 deletions(-) create mode 100644 Documentation/translations/zh_CN/infiniband/user_verbs.rst
Documentation/translations/zh_CN/infiniband/index.rst +1 -2
@@ -28,10 +28,9 @@ infiniband sysfs tag_matching user_mad + user_verbs -TODOLIST: - user_verbs .. only:: subproject and html
Documentation/translations/zh_CN/infiniband/user_verbs.rst new file +72 -0
72 lines not on this page · raw message
Signature · 1 line
2.27.0
Jonathan Corbet
maintainerQuoted 19 lines · Yanteng Si
v4:
Modified a word under Puyu advices; [PATCH 8/8]
v3:
* Modified some words under Alex's advices;
* pick Review-by tags.
v2:
* Modified some words under Alex's and Puyu advices; Thanks for their review!
* add 校译者(proofreading) sign.If you don't want me to do this, please let me know.
*--CC [email protected]
Quoted 9 lines
Yanteng Si (8):
docs/zh_CN: add infiniband index translation docs/zh_CN: add infinibandcore_lockingtranslation docs/zh_CN: add infiniband ipoib translation docs/zh_CN: add infinibandopa_vnictranslation docs/zh_CN: add infiniband sysfs translation docs/zh_CN: add infinibandtag_matchingtranslation docs/zh_CN: add infinibanduser_madtranslation docs/zh_CN: add infinibanduser_verbstranslation
Set applied, thanks.
jon