-*- nroff -*-
IBV_ALLOC_SHPD 3 2012-02-29 libibverbs "Libibverbs Programmer's Manual"
"NAME"
ibv_alloc_shpd - allocate unique id for sharing a protection domain (PD).
"SYNOPSIS"
#include <infiniband/verbs.h> "struct ibv_shpd *ibv_alloc_shpd(struct ibv_pd " "*pd" ", uint64_t " " " " share_key" ", struct ibv_shpd " "*shpd");
"DESCRIPTION"
ibv_alloc_shpd() allocates a unique identifier required for sharing the PD
pd with another process. share_key is a 64 bit key which needs to be provided with
ibv_share_pd() call by another process to share the same PD in that other process. The argument
shpd specifies a pointer to a user allocated area where libibverbs can write the unique identifier for the
pd. "RETURN VALUE"
ibv_alloc_shpd() returns
shpd - a pointer to the area where the unique identifier is written - or NULL if the request fails.
"NOTES"
ibv_alloc_shpd() can be called on a particular PD only once.
"SEE ALSO"
ibv_share_pd (3) "AUTHORS"
Arun Kaimalettu <gotoarunk at gmail dot com>