cachepc-linux

Fork of AMDESE/linux with modifications for CachePC side-channel attack
git clone https://git.sinitax.com/sinitax/cachepc-linux
Log | Files | Refs | README | LICENSE | sfeed.txt

user_mad.rst (5368B)


      1.. include:: ../disclaimer-zh_CN.rst
      2
      3:Original: Documentation/infiniband/user_mad.rst
      4
      5:翻译:
      6
      7 司延腾 Yanteng Si <siyanteng@loongson.cn>
      8
      9:校译:
     10
     11 王普宇 Puyu Wang <realpuyuwang@gmail.com>
     12 时奎亮 Alex Shi <alexs@kernel.org>
     13
     14.. _cn_infiniband_user_mad:
     15
     16===============
     17用户空间MAD访问
     18===============
     19
     20设备文件
     21========
     22
     23  每个InfiniBand设备的每个端口都有一个“umad”设备和一个“issm”设备连接。
     24  例如,一个双端口的HCA将有两个umad设备和两个issm设备,而一个交换机将
     25  有每个类型的一个设备(对于交换机端口0)。
     26
     27创建MAD代理
     28===========
     29
     30  一个MAD代理可以通过填写一个结构体ib_user_mad_reg_req来创建,然后在
     31  适当的设备文件的文件描述符上调用IB_USER_MAD_REGISTER_AGENT ioctl。
     32  如果注册请求成功,结构体中会返回一个32位的ID。比如说::
     33
     34	struct ib_user_mad_reg_req req = { /* ... */ };
     35	ret = ioctl(fd, IB_USER_MAD_REGISTER_AGENT, (char *) &req);
     36        if (!ret)
     37		my_agent = req.id;
     38	else
     39		perror("agent register");
     40
     41  代理可以通过IB_USER_MAD_UNREGISTER_AGENT ioctl取消注册。另外,所有
     42  通过文件描述符注册的代理在描述符关闭时将被取消注册。
     43
     44  2014
     45       现在提供了一个新的注册IOctl,允许在注册时提供额外的字段。这个注册
     46       调用的用户隐含了对pkey_index的使用(见下文)。现在提供了一个新的
     47       注册IOctl,允许在注册时提供额外的字段。这个注册调用的用户隐含了对
     48       pkey_index的使用(见下文)。
     49
     50接收MADs
     51========
     52
     53  使用read()接收MAD。现在接收端支持RMPP。传给read()的缓冲区必须至少是
     54  一个struct ib_user_mad + 256字节。比如说:
     55
     56  如果传递的缓冲区不足以容纳收到的MAD(RMPP),errno被设置为ENOSPC,需
     57  要的缓冲区长度被设置在mad.length中。
     58
     59  正常MAD(非RMPP)的读取示例::
     60
     61	struct ib_user_mad *mad;
     62	mad = malloc(sizeof *mad + 256);
     63	ret = read(fd, mad, sizeof *mad + 256);
     64	if (ret != sizeof mad + 256) {
     65		perror("read");
     66		free(mad);
     67	}
     68
     69  RMPP读取示例::
     70
     71	struct ib_user_mad *mad;
     72	mad = malloc(sizeof *mad + 256);
     73	ret = read(fd, mad, sizeof *mad + 256);
     74	if (ret == -ENOSPC)) {
     75		length = mad.length;
     76		free(mad);
     77		mad = malloc(sizeof *mad + length);
     78		ret = read(fd, mad, sizeof *mad + length);
     79	}
     80	if (ret < 0) {
     81		perror("read");
     82		free(mad);
     83	}
     84
     85  除了实际的MAD内容外,其他结构体ib_user_mad字段将被填入收到的MAD的信
     86  息。例如,远程LID将在mad.lid中。
     87
     88  如果发送超时,将产生一个接收,mad.status设置为ETIMEDOUT。否则,当一个
     89  MAD被成功接收后,mad.status将是0。
     90
     91  poll()/select()可以用来等待一个MAD可以被读取。
     92
     93  poll()/select()可以用来等待,直到可以读取一个MAD。
     94
     95发送MADs
     96========
     97
     98  MADs是用write()发送的。发送的代理ID应该填入MAD的id字段,目的地LID应该
     99  填入lid字段,以此类推。发送端确实支持RMPP,所以可以发送任意长度的MAD。
    100  比如说::
    101
    102	struct ib_user_mad *mad;
    103
    104	mad = malloc(sizeof *mad + mad_length);
    105
    106	/* fill in mad->data */
    107
    108	mad->hdr.id  = my_agent;	/* req.id from agent registration */
    109	mad->hdr.lid = my_dest;		/* in network byte order... */
    110	/* etc. */
    111
    112	ret = write(fd, &mad, sizeof *mad + mad_length);
    113	if (ret != sizeof *mad + mad_length)
    114		perror("write");
    115
    116交换IDs
    117=======
    118
    119  umad设备的用户可以在发送的MAD中使用交换ID字段的低32位(也就是网络字节顺序中
    120  最小有效的一半字段)来匹配请求/响应对。上面的32位是保留给内核使用的,在发送
    121  MAD之前会被改写。
    122
    123P_Key索引处理
    124=============
    125
    126  旧的ib_umad接口不允许为发送的MAD设置P_Key索引,也没有提供获取接收的MAD的
    127  P_Key索引的方法。一个带有pkey_index成员的struct ib_user_mad_hdr的新布局已
    128  经被定义;然而,为了保持与旧的应用程序的二进制兼容性,除非在文件描述符被用于
    129  其他用途之前调用IB_USER_MAD_ENABLE_PKEY或IB_USER_MAD_REGISTER_AGENT2 ioctl
    130  之一,否则不会使用这种新布局。
    131
    132  在2008年9月,IB_USER_MAD_ABI_VERSION将被增加到6,默认使用新的ib_user_mad_hdr
    133  结构布局,并且IB_USER_MAD_ENABLE_PKEY ioctl将被删除。
    134
    135设置IsSM功能位
    136==============
    137
    138  要为一个端口设置IsSM功能位,只需打开相应的issm设备文件。如果IsSM位已经被设置,那
    139  么打开调用将阻塞,直到该位被清除(或者如果O_NONBLOCK标志被传递给open(),则立即返
    140  回,errno设置为EAGAIN)。当issm文件被关闭时,IsSM位将被清除。在issm文件上不能进
    141  行任何读、写或其他操作。
    142
    143/dev文件
    144========
    145
    146为了用 udev自动创建相应的字符设备文件,一个类似::
    147
    148    KERNEL=="umad*", NAME="infiniband/%k"
    149    KERNEL=="issm*", NAME="infiniband/%k"
    150
    151  的规则可以被使用。它将创建节点的名字::
    152
    153    /dev/infiniband/umad0
    154    /dev/infiniband/issm0
    155
    156  为第一个端口,以此类推。与这些设备相关的infiniband设备和端口可以从以下文件中确定::
    157
    158    /sys/class/infiniband_mad/umad0/ibdev
    159    /sys/class/infiniband_mad/umad0/port
    160
    161  和::
    162
    163    /sys/class/infiniband_mad/issm0/ibdev
    164    /sys/class/infiniband_mad/issm0/port