Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

ibv_create_ah(3) [debian man page]

IBV_CREATE_AH(3)					  Libibverbs Programmer's Manual					  IBV_CREATE_AH(3)

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.

       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>

libibverbs							    2006-10-31							  IBV_CREATE_AH(3)

Check Out this Related Man Page

IBV_CREATE_AH_FROM_WC(3)				  Libibverbs Programmer's Manual				  IBV_CREATE_AH_FROM_WC(3)

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)
Man Page