IBV_CREATE_AH
Section: Libibverbs Programmer's Manual (3)
Updated: 2006-10-31
Index
Return to Main Contents
NAME
ibv_create_ah, ibv_destroy_ah - create or destroy an address handle (AH)
SYNOPSIS
#include <infiniband/verbs.h>
struct ibv_ah *ibv_create_ah(struct ibv_pd *pd,
struct ibv_ah_attr *attr);
int ibv_destroy_ah(struct ibv_ah *ah);
DESCRIPTION
ibv_create_ah()
creates an address handle (AH) associated with the protection domain
pd.
The argument
attr
is an ibv_ah_attr struct, as defined in <infiniband/verbs.h>.
struct ibv_ah_attr {
struct ibv_global_route grh; /* Global Routing Header (GRH) attributes */
uint16_t dlid; /* Destination LID */
uint8_t sl; /* Service Level */
uint8_t src_path_bits; /* Source path bits */
uint8_t static_rate; /* Maximum static rate */
uint8_t is_global; /* GRH attributes are valid */
uint8_t port_num; /* Physical port number */
};
struct ibv_global_route {
union ibv_gid dgid; /* Destination GID or MGID */
uint32_t flow_label; /* Flow label */
uint8_t sgid_index; /* Source GID index */
uint8_t hop_limit; /* Hop limit */
uint8_t traffic_class; /* Traffic class */
};
ibv_destroy_ah()
destroys the AH
ah.
RETURN VALUE
ibv_create_ah()
returns a pointer to the created AH, or NULL if the request fails.
NOTES
If port flag IBV_QPF_GRH_REQUIRED is set then
ibv_create_ah()
must be created with definition of 'struct ibv_ah_attr { .is_global = 1; .grh = {...}; }'.
ibv_destroy_ah()
returns 0 on success, or the value of errno on failure (which indicates the failure reason).
SEE ALSO
ibv_alloc_pd(3),
ibv_init_ah_from_wc(3),
ibv_create_ah_from_wc(3)
AUTHORS
- Dotan Barak <dotanba@gmail.com>
-
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- RETURN VALUE
-
- NOTES
-
- SEE ALSO
-
- AUTHORS
-
This document was created by
man2html,
using the manual pages.
Time: 02:52:56 GMT, April 28, 2024