3 .TH UMAD_GET_CA 3 "May 21, 2007" "OpenIB" "OpenIB Programmer\'s Manual"
5 umad_get_ca, umad_release_ca \- get and release InfiniBand device port attributes
8 .B #include <infiniband/umad.h>
10 .BI "int umad_get_ca(char " "*ca_name" ", umad_ca_t " "*ca" );
12 .BI "int umad_release_ca(umad_ca_t " "*ca" );
16 gets the attributes of the InfiniBand device
21 structure with the device attributes specified by
24 or with the default device attributes if
28 should be called before the
30 structure is deallocated.
35 struct, as specified in <infiniband/umad.h>.
38 typedef struct umad_ca {
40 char ca_name[UMAD_CA_NAME_LEN]; /* Name of the device */
41 uint node_type; /* Type of the device */
42 int numports; /* Number of physical ports */
43 char fw_ver[20]; /* FW version */
44 char ca_type[40]; /* CA type (e.g. MT23108, etc.) */
45 char hw_ver[20]; /* Hardware version */
46 uint64_t node_guid; /* Node GUID */
47 uint64_t system_guid; /* System image GUID */
48 umad_port_t *ports[UMAD_CA_MAX_PORTS]; /* Array of device port properties */
54 releases the resources that were allocated in the function
60 return 0 on success, and a negative value on error.
63 Hal Rosenstock <halr@voltaire.com>
65 Dotan Barak <dotanb@mellanox.co.il>