Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

ibv_query_port(3) [debian man page]

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

NAME

       ibv_query_port - query an RDMA port's attributes

SYNOPSIS

       #include <infiniband/verbs.h>

       int ibv_query_port(struct ibv_context *context, uint8_t port_num,
			  struct ibv_port_attr *port_attr);

DESCRIPTION

       ibv_query_port()  returns the attributes of port port_num for device context context through the pointer port_attr.  The argument port_attr
       is an ibv_port_attr struct, as defined in <infiniband/verbs.h>.

       struct ibv_port_attr {
	       enum ibv_port_state     state;	       /* Logical port state */
	       enum ibv_mtu	       max_mtu;        /* Max MTU supported by port */
	       enum ibv_mtu	       active_mtu;     /* Actual MTU */
	       int		       gid_tbl_len;    /* Length of source GID table */
	       uint32_t 	       port_cap_flags; /* Port capabilities */
	       uint32_t 	       max_msg_sz;     /* Maximum message size */
	       uint32_t 	       bad_pkey_cntr;  /* Bad P_Key counter */
	       uint32_t 	       qkey_viol_cntr; /* Q_Key violation counter */
	       uint16_t 	       pkey_tbl_len;   /* Length of partition table */
	       uint16_t 	       lid;	       /* Base port LID */
	       uint16_t 	       sm_lid;	       /* SM LID */
	       uint8_t		       lmc;	       /* LMC of LID */
	       uint8_t		       max_vl_num;     /* Maximum number of VLs */
	       uint8_t		       sm_sl;	       /* SM service level */
	       uint8_t		       subnet_timeout; /* Subnet propagation delay */
	       uint8_t		       init_type_reply;/* Type of initialization performed by SM */
	       uint8_t		       active_width;   /* Currently active link width */
	       uint8_t		       active_speed;   /* Currently active link speed */
	       uint8_t		       phys_state;     /* Physical port state */
	       uint8_t		       link_layer;     /* link layer protocol of the port */
       };

       possible values for the link layer field are IBV_LINK_LAYER_INFINIBAND,
       IBV_LINK_LAYER_ETHERNET, or IBV_LINK_LAYER_UNSPECIFIED.

RETURN VALUE

       ibv_query_port() returns 0 on success, or the value of errno on failure (which indicates the failure reason).

SEE ALSO

       ibv_create_qp(3), ibv_destroy_qp(3), ibv_query_qp(3), ibv_create_ah(3)

AUTHORS

       Dotan Barak <dotanba@gmail.com>

libibverbs							    2006-10-31							 IBV_QUERY_PORT(3)

Check Out this Related Man Page

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

NAME

       umad_get_port, umad_release_port - open and close an InfiniBand port

SYNOPSIS

       #include <infiniband/umad.h>

       int umad_get_port(char *ca_name, int portnum, umad_port_t *port);
       int umad_release_port(umad_port_t *port);

DESCRIPTION

       umad_get_port()	fills  the port structure with the IB port attributes specified by ca_name and portnum , or the default port if ca_name is
       NULL and portnum is zero. If only one of ca_name and portnum are specified, the other is used as a filter.  For	example,  passing  a  NULL
       ca_name	and  2 for the portnum means get a port from any of the local IB devices, as long as it is the second port.  Note that the library
       may use some reference scheme to support port caching therefore umad_release_port() should be called before the port structure can be deal-
       located.  The argument port is an umad_port_t struct, as specified in <infiniband/umad.h>.

       typedef struct umad_port {
	       char ca_name[UMAD_CA_NAME_LEN];		       /* Name of the device */
	       int portnum;				       /* Physical port number */
	       uint base_lid;				       /* Base port LID */
	       uint lmc;				       /* LMC of LID */
	       uint sm_lid;				       /* SM LID */
	       uint sm_sl;				       /* SM service level */
	       uint state;				       /* Logical port state */
	       uint phys_state; 			       /* Physical port state */
	       uint rate;				       /* Port link bit rate */
	       uint64_t capmask;			       /* Port capabilities */
	       uint64_t gid_prefix;			       /* Gid prefix of this port */
	       uint64_t port_guid;			       /* GUID of this port */
       } umad_port_t;

       umad_release_port() releases the resources that were allocated by the umad_get_port() function for the specified IB port.

RETURN VALUE

       umad_get_port() and umad_release_port() return 0 on success, and a negative value on error.

AUTHORS

       Hal Rosenstock <halr@voltaire.com>

       Dotan Barak <dotanb@mellanox.co.il>

OpenIB								   May 21, 2007 						  UMAD_GET_PORT(3)
Man Page