1IBV_CREATE_AH(3)        Libibverbs Programmer's Manual        IBV_CREATE_AH(3)
2
3
4

NAME

6       ibv_create_ah,  ibv_destroy_ah  -  create  or destroy an address handle
7       (AH)
8

SYNOPSIS

10       #include <infiniband/verbs.h>
11
12       struct ibv_ah *ibv_create_ah(struct ibv_pd *pd,
13                                    struct ibv_ah_attr *attr);
14       int ibv_destroy_ah(struct ibv_ah *ah);
15

DESCRIPTION

17       ibv_create_ah() creates an address handle (AH) associated with the pro‐
18       tection  domain  pd.   The  argument  attr is an ibv_ah_attr struct, as
19       defined in <infiniband/verbs.h>.
20
21       struct ibv_ah_attr {
22               struct ibv_global_route grh;            /* Global Routing Header (GRH) attributes */
23               uint16_t                dlid;           /* Destination LID */
24               uint8_t                 sl;             /* Service Level */
25               uint8_t                 src_path_bits;  /* Source path bits */
26               uint8_t                 static_rate;    /* Maximum static rate */
27               uint8_t                 is_global;      /* GRH attributes are valid */
28               uint8_t                 port_num;       /* Physical port number */
29       };
30
31       struct ibv_global_route {
32               union ibv_gid           dgid;           /* Destination GID or MGID */
33               uint32_t                flow_label;     /* Flow label */
34               uint8_t                 sgid_index;     /* Source GID index */
35               uint8_t                 hop_limit;      /* Hop limit */
36               uint8_t                 traffic_class;  /* Traffic class */
37       };
38
39
40       ibv_destroy_ah() destroys the AH ah.
41

RETURN VALUE

43       ibv_create_ah() returns a pointer to the created AH,  or  NULL  if  the
44       request fails.
45
46       ibv_destroy_ah() returns 0 on success, or the value of errno on failure
47       (which indicates the failure reason).
48

SEE ALSO

50       ibv_alloc_pd(3), ibv_init_ah_from_wc(3), ibv_create_ah_from_wc(3)
51

AUTHORS

53       Dotan Barak <dotanb@mellanox.co.il>
54
55
56
57libibverbs                        2006-10-31                  IBV_CREATE_AH(3)
Impressum