3 .TH IBV_CREATE_AH 3 2006-10-31 libibverbs "Libibverbs Programmer's Manual"
5 ibv_create_ah, ibv_destroy_ah \- create or destroy an address handle (AH)
8 .B #include <infiniband/verbs.h>
10 .BI "struct ibv_ah *ibv_create_ah(struct ibv_pd " "*pd" ",
11 .BI " struct ibv_ah_attr " "*attr" ");
13 .BI "int ibv_destroy_ah(struct ibv_ah " "*ah" ");
17 creates an address handle (AH) associated with the protection domain
21 is an ibv_ah_attr struct, as defined in <infiniband/verbs.h>.
26 struct ibv_global_route grh; /* Global Routing Header (GRH) attributes */
27 uint16_t dlid; /* Destination LID */
28 uint8_t sl; /* Service Level */
29 uint8_t src_path_bits; /* Source path bits */
30 uint8_t static_rate; /* Maximum static rate */
31 uint8_t is_global; /* GRH attributes are valid */
32 uint8_t port_num; /* Physical port number */
37 struct ibv_global_route {
39 union ibv_gid dgid; /* Destination GID or MGID */
40 uint32_t flow_label; /* Flow label */
41 uint8_t sgid_index; /* Source GID index */
42 uint8_t hop_limit; /* Hop limit */
43 uint8_t traffic_class; /* Traffic class */
54 returns a pointer to the created AH, or NULL if the request fails.
57 returns 0 on success, or the value of errno on failure (which indicates the failure reason).
60 .BR ibv_init_ah_from_wc (3),
61 .BR ibv_create_ah_from_wc (3)
64 Dotan Barak <dotanb@mellanox.co.il>