core_locking.rst

  1
  2.. include:: ../disclaimer-zh_CN.rst
  3
  4:Original: Documentation/infiniband/core_locking.rst
  5
  6:翻译:
  7
  8 司延腾 Yanteng Si <siyanteng@loongson.cn>
  9
 10:校译:
 11
 12 王普宇 Puyu Wang <realpuyuwang@gmail.com>
 13 时奎亮 Alex Shi <alexs@kernel.org>
 14
 15.. _cn_infiniband_core_locking:
 16
 17==================
 18infiniband中间层锁
 19==================
 20
 21  本指南试图明确infiniband中间层的锁假设。它描述了对位于中间层以下的低
 22  级驱动程序和使用中间层的上层协议的要求。
 23
 24睡眠和中断环境
 25==============
 26
 27  除了以下异常情况，ib_device结构体中所有方法的低级驱动实现都可以睡眠。
 28  这些异常情况是列表中的任意的方法:
 29
 30    - create_ah
 31    - modify_ah
 32    - query_ah
 33    - destroy_ah
 34    - post_send
 35    - post_recv
 36    - poll_cq
 37    - req_notify_cq
 38
 39    他们可能不可以睡眠，而且必须可以从任何上下文中调用。
 40
 41    向上层协议使用者输出的相应函数:
 42
 43    - rdma_create_ah
 44    - rdma_modify_ah
 45    - rdma_query_ah
 46    - rdma_destroy_ah
 47    - ib_post_send
 48    - ib_post_recv
 49    - ib_req_notify_cq
 50
 51    因此，在任何情况下都可以安全调用（它们）。
 52
 53  此外，该函数
 54
 55    - ib_dispatch_event
 56
 57  被底层驱动用来通过中间层调度异步事件的“A”，也可以从任何上下文中安全调
 58  用。
 59
 60可重入性
 61--------
 62
 63  由低级驱动程序导出的ib_device结构体中的所有方法必须是完全可重入的。
 64  即使使用同一对象的多个函数调用被同时运行，低级驱动程序也需要执行所有
 65  必要的同步以保持一致性。
 66
 67  IB中间层不执行任何函数调用的序列化。
 68
 69  因为低级驱动程序是可重入的，所以不要求上层协议使用者任何顺序执行。然
 70  而，为了得到合理的结果，可能需要一些顺序。例如，一个使用者可以在多个
 71  CPU上同时安全地调用ib_poll_cq()。然而，不同的ib_poll_cq()调用之间
 72  的工作完成信息的顺序没有被定义。
 73
 74回调
 75----
 76
 77  低级驱动程序不得直接从与ib_device方法调用相同的调用链中执行回调。例
 78  如，低级驱动程序不允许从post_send方法直接调用使用者的完成事件处理程
 79  序。相反，低级驱动程序应该推迟这个回调，例如，调度一个tasklet来执行
 80  这个回调。
 81
 82  低层驱动负责确保同一CQ的多个完成事件处理程序不被同时调用。驱动程序必
 83  须保证一个给定的CQ的事件处理程序在同一时间只有一个在运行。换句话说，
 84  以下情况是不允许的::
 85
 86          CPU1                                    CPU2
 87
 88    low-level driver ->
 89      consumer CQ event callback:
 90        /* ... */
 91        ib_req_notify_cq(cq, ...);
 92                                          low-level driver ->
 93        /* ... */                           consumer CQ event callback:
 94                                              /* ... */
 95        return from CQ event handler
 96
 97  完成事件和异步事件回调的运行环境没有被定义。 根据低级别的驱动程序，它可能是
 98  进程上下文、softirq上下文或中断上下文。上层协议使用者可能不会在回调中睡眠。
 99
100热插拔
101------
102
103  当一个低级驱动程序调用ib_register_device()时，它宣布一个设备已经
104  准备好供使用者使用，所有的初始化必须在这个调用之前完成。设备必须保
105  持可用，直到驱动对ib_unregister_device()的调用返回。
106
107  低级驱动程序必须从进程上下文调用ib_register_device()和
108  ib_unregister_device()。如果使用者在这些调用中回调到驱动程序，它
109  不能持有任何可能导致死锁的semaphores。
110
111  一旦其结构体ib_client的add方法被调用，上层协议使用者就可以开始使用
112  一个IB设备。使用者必须在从移除方法返回之前完成所有的清理工作并释放
113  与设备相关的所有资源。
114
115  使用者被允许在其添加和删除方法中睡眠。