On Sun, Aug 1, 2021 at 12:25 PM Yanteng Si <siyanteng@xxxxxxxxxxx> wrote: > > Translate Documentation/infiniband/core_locking.rst into Chinese. > > Signed-off-by: Yanteng Si <siyanteng@xxxxxxxxxxx> Reviewed-by: Puyu Wang <realpuyuwang@xxxxxxxxx> > --- > .../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 > > diff --git a/Documentation/translations/zh_CN/infiniband/core_locking.rst b/Documentation/translations/zh_CN/infiniband/core_locking.rst > new file mode 100644 > index 000000000000..42f08038d44b > --- /dev/null > +++ b/Documentation/translations/zh_CN/infiniband/core_locking.rst > @@ -0,0 +1,115 @@ > + > +.. include:: ../disclaimer-zh_CN.rst > + > +:Original: Documentation/infiniband/core_locking.rst > + > +:翻译: > + > + 司延腾 Yanteng Si <siyanteng@xxxxxxxxxxx> > + > +:校译: > + > + 王普宇 Puyu Wang <realpuyuwang@xxxxxxxxx> > + 时奎亮 Alex Shi <alexs@xxxxxxxxxx> > + > +.. _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设备。使用者必须在从移除方法返回之前完成所有的清理工作并释放 > + 与设备相关的所有资源。 > + > + 使用者被允许在其添加和删除方法中睡眠。 > diff --git a/Documentation/translations/zh_CN/infiniband/index.rst b/Documentation/translations/zh_CN/infiniband/index.rst > index ebb1e20b7df4..cc00f31c77d0 100644 > --- a/Documentation/translations/zh_CN/infiniband/index.rst > +++ b/Documentation/translations/zh_CN/infiniband/index.rst > @@ -22,9 +22,10 @@ infiniband > .. toctree:: > :maxdepth: 1 > > + core_locking > + > TODOLIST: > > - core_locking > ipoib > opa_vnic > sysfs > -- > 2.27.0 >
