ibv_query_gid_ex(3)

1IBV_QUERY_GID_EX(3)     Libibverbs Programmer’s Manual     IBV_QUERY_GID_EX(3)
2
3
4

NAME

6       ibv_query_gid_ex - Query an InfiniBand port’s GID table entry
7

SYNOPSIS

9              #include <infiniband/verbs.h>
10
11              int ibv_query_gid_ex(struct ibv_context *context,
12                                   uint32_t port_num,
13                                   uint32_t gid_index,
14                                   struct ibv_gid_entry *entry,
15                                   uint32_t flags);
16

DESCRIPTION

18       ibv_query_gid_ex() returns the GID entry at entry for gid_index of port
19       port_num for device context context.
20

ARGUMENTS

22       context
23              The context of the device to query.
24
25       port_num
26              The number of port to query its GID table.
27
28       gid_index
29              The index of the GID table entry to query.
30
31       ## entry Argument
32              An ibv_gid_entry struct, as defined in <infiniband/verbs.h>.
33
34                     struct ibv_gid_entry {
35                         union ibv_gid gid;
36                         uint32_t gid_index;
37                         uint32_t port_num;
38                         uint32_t gid_type;
39                         uint32_t ndev_ifindex;
40                     };
41
42              gid
43
44                  The GID entry.
45
46              gid_index
47
48                  The GID table index of this entry.
49
50              port_num
51
52                  The port number that this GID belongs to.
53
54              gid_type
55
56                  enum ibv_gid_type, can be one of IBV_GID_TYPE_IB, IBV_GID_TYPE_ROCE_V1 or IBV_GID_TYPE_ROCE_V2.
57
58              ndev_ifindex
59
60                  The interface index of the net device associated with this GID.
61                  It is 0 if there is no net device associated with it.
62
63       flags  Extra fields to query post ndev_ifindex, for now must be 0.
64

RETURN VALUE

66       ibv_query_gid_ex() returns 0 on success or errno value on error.
67

ERRORS

69       ENODATA
70              gid_index is within the GID table  size  of  port  port_num  but
71              there is no data in this index.
72

AUTHOR

78       Parav Pandit <parav@nvidia.com>
79
80
81
82libibverbs                        2020-04-24               IBV_QUERY_GID_EX(3)