Linux Certif

Toute la documentation sur la certification Linux LPI

umad_get_ca

NAME

umad_get_ca, umad_release_ca - get and release InfiniBand device port attributes

SYNOPSIS

 #include <infiniband/umad.h>
 
 int umad_get_ca(char *ca_name, umad_ca_t *ca);
 int umad_release_ca(umad_ca_t *ca);
 

DESCRIPTION

umad_get_ca() gets the attributes of the InfiniBand device ca_name. It fills the ca structure with the device attributes specified by the ca_name or with the default device attributes if ca_name is NULL. umad_release_ca() should be called before the ca structure is deallocated. The argument ca is an umad_ca_t struct, as specified in <infiniband/umad.h>.

 typedef struct umad_ca {
 char ca_name[UMAD_CA_NAME_LEN];                 /* Name of the device */
 uint node_type;                                 /* Type of the device */
 int numports;                                   /* Number of physical ports */
 char fw_ver[20];                                /* FW version */
 char ca_type[40];                               /* CA type (e.g. MT23108, etc.) */
 char hw_ver[20];                                /* Hardware version */
 uint64_t node_guid;                             /* Node GUID */
 uint64_t system_guid;                           /* System image GUID */
 umad_port_t *ports[UMAD_CA_MAX_PORTS];          /* Array of device port properties */
 } umad_ca_t;
 

umad_release_ca() releases the resources that were allocated in the function umad_get_ca().

RETURN VALUE

umad_get_ca() and umad_release_ca() return 0 on success, and a negative value on error.

AUTHORS

Hal Rosenstock <halr@voltaire.com>

Dotan Barak <dotanb@mellanox.co.il>