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

NAME

6       ibv_query_gid_table - query an InfiniBand device’s GID table
7

SYNOPSIS

9              #include <infiniband/verbs.h>
10
11              ssize_t ibv_query_gid_table(struct ibv_context *context,
12                                          struct ibv_gid_entry *entries,
13                                          size_t max_entries,
14                                          uint32_t flags);
15

DESCRIPTION

17       ibv_query_gid_table()  returns  the valid GID table entries of the RDMA
18       device context context at the pointer entries.
19
20       A caller must allocate entries array for the GID table entries  it  de‐
21       sires to query.  This API returns only valid GID table entries.
22
23       A  caller must pass non zero number of entries at max_entries that cor‐
24       responds to the size of entries array.
25
26       entries array must be allocated such that it can contain all the  valid
27       GID  table  entries of the device.  If there are more valid GID entries
28       than the provided value of max_entries and entries array, the call will
29       fail.   For  example, if an RDMA device context has a total of 10 valid
30       GID entries, entries should be allocated for at least 10  entries,  and
31       max_entries should be set appropriately.
32

ARGUMENTS

34       context
35              The context of the device to query.
36
37       entries
38              Array  of  ibv_gid_entry  structs  where the GID entries are re‐
39              turned.  Please see ibv_query_gid_ex(3) man page for ibv_gid_en‐
40              try.
41
42       max_entries
43              Maximum number of entries that can be returned.
44
45       flags  Extra  fields  to query post entries->ndev_ifindex, for now must
46              be 0.
47

RETURN VALUE

49       ibv_query_gid_table() returns the number of entries that were  read  on
50       success  or  negative errno value on error.  Number of entries returned
51       is <= max_entries.
52

SEE ALSO

54       ibv_open_device(3),       ibv_query_device(3),       ibv_query_port(3),
55       ibv_query_gid_ex(3)
56

AUTHOR

58       Parav Pandit <parav@nvidia.com>
59
60
61
62libibverbs                        2020-04-24            IBV_QUERY_GID_TABLE(3)
Impressum