NAME

       ibv_init_ah_from_wc,  ibv_create_ah_from_wc  -  initialize  or  create an address handle (AH) from a work
       completion

SYNOPSIS

       #include <infiniband/verbs.h>

       int ibv_init_ah_from_wc(struct ibv_context *context, uint8_t port_num,
                               struct ibv_wc *wc, struct ibv_grh *grh,
                               struct ibv_ah_attr *ah_attr);

       struct ibv_ah *ibv_create_ah_from_wc(struct ibv_pd *pd,
                                            struct ibv_wc *wc,
                                            struct ibv_grh *grh,
                                            uint8_t port_num);

DESCRIPTION

       ibv_init_ah_from_wc() initializes the address handle (AH) attribute structure ah_attr for the RDMA device
       context context using the port number port_num, using attributes from the  work  completion  wc  and  the
       Global Routing Header (GRH) structure grh.

       ibv_create_ah_from_wc()  creates  an  AH  associated  with the protection domain pd using the port number
       port_num, using attributes from the work completion wc and the Global Routing Header (GRH) structure grh.

RETURN VALUE

       ibv_init_ah_from_wc() returns 0 on success, and -1 on error.

       ibv_create_ah_from_wc() returns a pointer to the created AH, or NULL if the request fails.

NOTES

       The filled structure ah_attr returned from ibv_init_ah_from_wc() can be used to create  a  new  AH  using
       ibv_create_ah().

SEE ALSO

       ibv_open_device(3), ibv_alloc_pd(3), ibv_create_ah(3), ibv_destroy_ah(3), ibv_poll_cq(3)

AUTHORS

       Dotan Barak <dotanba@gmail.com>

libibverbs                                         2006-10-31                           IBV_CREATE_AH_FROM_WC(3)