IBV_ALLOC_TD(3) Libibverbs Programmer's Manual IBV_ALLOC_TD(3)
NAME
ibv_alloc_td(), ibv_dealloc_td() - allocate and deallocate thread do-
main object
SYNOPSIS
#include <infiniband/verbs.h>
struct ibv_td *ibv_alloc_td(struct ibv_context *context,
struct ibv_td_init_attr *init_attr);
int ibv_dealloc_td(struct ibv_td *td);
DESCRIPTION
ibv_alloc_td() allocates a thread domain object for the RDMA device
context context.
The thread domain object defines how the verbs libraries and provider
will use locks and additional hardware capabilities to achieve best
performance for handling multi-thread or single-thread protection. An
application assigns verbs resources to a thread domain when it creates
a verbs object.
If the ibv_td object is specified then any objects created under this
thread domain will disable internal locking designed to protect against
concurrent access to that object from multiple user threads. By default
all verbs objects are safe for multi-threaded access, whether or not a
thread domain is specified.
A struct ibv_td can be added to a parent domain via ibv_alloc_par-
ent_domain() and then the parent domain can be used to create verbs ob-
jects.
ibv_dealloc_td() will deallocate the thread domain td. All resources
created with the td should be destroyed prior to deallocating the td.
RETURN VALUE
ibv_alloc_td() returns a pointer to the allocated struct ibv_td object,
or NULL if the request fails (and sets errno to indicate the failure
reason).
ibv_dealloc_td() returns 0 on success, or the value of errno on failure
(which indicates the failure reason).
SEE ALSO
ibv_alloc_parent_domain(3),
AUTHORS
Alex Rosenbaum <alexr@mellanox.com>
Yishai Hadas <yishaih@mellanox.com>
libibverbs 2017-11-06 IBV_ALLOC_TD(3)
Generated by dwww version 1.15 on Mon Jul 1 01:14:08 CEST 2024.