IBV_QUERY_GID(3)

NAME

ibv_query_gid - InfiniBand ポートの GID Table を取得する

SYNOPSIS

#include <infiniband/verbs.h>

int ibv_query_gid(struct ibv_context *context, uint8_t port_num,
                  int index, union ibv_gid *gid);

DESCRIPTION

ibv_query_gid() は context で指定される RDMA デバイスの port_num で指定されるポートの GID Table の index 番目の GID を取り出し gid が指す領域にコピーする。

context は ibv_open_device() でオープンした RDMA デバイスを指定する。

port_num は 1 からはじまるポート番号を指定する。 RDMA デバイスにいくつポートがあるかは ibv_query_device() で得られる phys_port_cnt を参照すること。

index は 0 からはじまる GID Table のインデックス番号を指定すること。 GID Table の最大数は ibv_query_port() で得られる gid_tbl_len で確認できる。 index には gid_tbl_len 未満のインデックス番号を指定すること。

RETURN VALUE

ibv_query_gid() が成功すれば 0 を返す。失敗すれば -1 を返す。

NOTES

Subnet Manager がサブネットを構成後は、index が 0 の GID はポートに割り付けられたユニキャスト GID となる。

gid 内の全ビットが 0 の場合、その GIDは無効である。

AUTHORS

コメントを書き込む