Skip to contentSkip to conversation

docs/zh_CN: add infiniband translation

PATCH In review Yanteng Si 2 participants 10 messages Aug 6, 2021 – Aug 12, 2021

Subsystems (2)
lore
Share & tools
lore

Yanteng Si

author
#0 lore raw

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
author
#1 lore raw

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
index e0d51a167032..84d000245102 100644
@@ -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
new file mode 100644
index 000000000000..ebb1e20b7df4
@@ -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
author
#2 lore raw

PATCH v4 2/8 docs/zh_CN: add infiniband core_locking translation

In reply to Yanteng Si

Translate 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
new file mode 100644
index 000000000000..42f08038d44b
@@ -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
index ebb1e20b7df4..cc00f31c77d0 100644
@@ -22,9 +22,10 @@ infiniband
 .. toctree::
    :maxdepth: 1
 
+   core_locking
+
 TODOLIST:
 
-   core_locking
    ipoib
    opa_vnic
    sysfs
Signature · 1 line
2.27.0
author
#3 lore raw

PATCH v4 3/8 docs/zh_CN: add infiniband ipoib translation

In reply to Yanteng Si

Translate 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
index cc00f31c77d0..da5e2821f767 100644
@@ -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
author
#4 lore raw

PATCH v4 4/8 docs/zh_CN: add infiniband opa_vnic translation

In reply to Yanteng Si

Translate 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
index da5e2821f767..a933e3c6981d 100644
@@ -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
author
#5 lore raw

PATCH v4 5/8 docs/zh_CN: add infiniband sysfs translation

In reply to Yanteng Si

Translate 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
index a933e3c6981d..1d208d50b0c2 100644
@@ -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
new file mode 100644
index 000000000000..e9a48b0b2ba6
@@ -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
author
#6 lore raw

PATCH v4 6/8 docs/zh_CN: add infiniband tag_matching translation

In reply to Yanteng Si

Translate 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
index 1d208d50b0c2..c273088b8686 100644
@@ -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
author
#7 lore raw

PATCH v4 7/8 docs/zh_CN: add infiniband user_mad translation

In reply to Yanteng Si

Translate 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
index c273088b8686..55645171a675 100644
@@ -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
author
#8 lore raw

PATCH v4 8/8 docs/zh_CN: add infiniband user_verbs translation

In reply to Yanteng Si

Translate 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
index 55645171a675..5634cc48379f 100644
@@ -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
maintainer
#9 lore raw
In reply to Yanteng Si
Quoted 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 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

Set applied, thanks.

jon