File: efadv_query_mr.3.md

package info (click to toggle)
rdma-core 56.1-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 17,196 kB
  • sloc: ansic: 171,361; python: 13,724; sh: 2,774; perl: 1,465; makefile: 73
file content (81 lines) | stat: -rw-r--r-- 1,615 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
---
layout: page
title: EFADV_QUERY_MR
section: 3
tagline: Verbs
date: 2023-11-13
header: "EFA Direct Verbs Manual"
footer: efa
---

# NAME

efadv_query_mr - Query EFA specific Memory Region attributes

# SYNOPSIS

```c
#include <infiniband/efadv.h>

int efadv_query_mr(struct ibv_mr *ibvmr, struct efadv_mr_attr *attr, uint32_t inlen);
```

# DESCRIPTION

**efadv_query_mr()** queries device-specific Memory Region attributes.

Compatibility is handled using the comp_mask and inlen fields.

```c
struct efadv_mr_attr {
	uint64_t comp_mask;
	uint16_t ic_id_validity;
	uint16_t recv_ic_id;
	uint16_t rdma_read_ic_id;
	uint16_t rdma_recv_ic_id;
};
```

*inlen*
:	In: Size of struct efadv_mr_attr.

*comp_mask*
:	Compatibility mask.

*ic_id_validity*
:	Validity mask of interconnect id fields:

	EFADV_MR_ATTR_VALIDITY_RECV_IC_ID:
		recv_ic_id has a valid value.

	EFADV_MR_ATTR_VALIDITY_RDMA_READ_IC_ID:
		rdma_read_ic_id has a valid value.

	EFADV_MR_ATTR_VALIDITY_RDMA_RECV_IC_ID:
		rdma_recv_ic_id has a valid value.

*recv_ic_id*
:	Physical interconnect used by the device to reach the MR for receive operation.

*rdma_read_ic_id*
:	Physical interconnect used by the device to reach the MR for RDMA read operation.

*rdma_recv_ic_id*
:	Physical interconnect used by the device to reach the MR for RDMA write receive.

# RETURN VALUE

**efadv_query_mr()** returns 0 on success, or the value of errno on failure
(which indicates the failure reason).

# SEE ALSO

**efadv**(7)

# NOTES

* Compatibility mask (comp_mask) is an out field and currently has no values.

# AUTHORS

Michael Margolin <mrgolin@amazon.com>