umad_set_grh(3) [centos man page]

UMAD_SET_GRH(3) 					    OpenIB Programmer's Manual						   UMAD_SET_GRH(3)

NAME

       umad_set_grh - set GRH fields within umad buffer using host ordering

SYNOPSIS

       #include <infiniband/umad.h>

       int umad_set_grh(void *umad, void *mad_addr);

DESCRIPTION

       umad_set_grh()  sets  the GRH fields (grh_present, gid, hop_limit, traffic_class, flow_label) within the specified umad buffer based on the
       mad_addr supplied. The provided mad_addr fields are expected to be in host order.  If the mad_addr pointer supplied is NULL, no GRH is set.
       The  argument  mad_addr is a pointer to an ib_mad_addr_t struct, as specified in <infiniband/umad.h>.  The argument umad is a pointer to an
       ib_user_mad_t struct, as specified in <infiniband/umad.h>.

       typedef struct ib_mad_addr {
	       uint32_t qpn;
	       uint32_t qkey;
	       uint16_t lid;
	       uint8_t	sl;
	       uint8_t	path_bits;
	       uint8_t	grh_present;
	       uint8_t	gid_index;
	       uint8_t	hop_limit;
	       uint8_t	traffic_class;
	       uint8_t	gid[16];
	       uint32_t flow_label;
       } ib_mad_addr_t;

       typedef struct ib_user_mad {
	       uint32_t agent_id;
	       uint32_t status;
	       uint32_t timeout_ms;
	       uint32_t retries;
	       uint32_t length;
	       ib_mad_addr_t addr;
	       uint8_t	data[0];
       } ib_user_mad_t;

RETURN VALUE

       umad_set_grh() returns 0 on success, and a negative value on errors. Currently, there are no errors indicated.

SEE ALSO

       umad_set_grh_net(3)

AUTHOR

       Hal Rosenstock <halr@voltaire.com>

OpenIB								   May 24, 2007 						   UMAD_SET_GRH(3)

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)