1UMAD_GET_CA(3)            OpenIB Programmer´s Manual            UMAD_GET_CA(3)
2
3
4

NAME

6       umad_get_ca,  umad_release_ca  - get and release InfiniBand device port
7       attributes
8

SYNOPSIS

10       #include <infiniband/umad.h>
11
12       int umad_get_ca(char *ca_name, umad_ca_t *ca);
13
14       int umad_release_ca(umad_ca_t *ca);
15

DESCRIPTION

17       umad_get_ca() gets the attributes of the InfiniBand device ca_name.  It
18       fills  the  ca  structure  with  the device attributes specified by the
19       ca_name or with the default  device  attributes  if  ca_name  is  NULL.
20       umad_release_ca()  should  be called before the ca structure is deallo‐
21       cated.  The argument  ca  is  an  umad_ca_t  struct,  as  specified  in
22       <infiniband/umad.h>.
23
24       typedef struct umad_ca {
25               char ca_name[UMAD_CA_NAME_LEN];                 /* Name of the device */
26               uint node_type;                                 /* Type of the device */
27               int numports;                                   /* Number of physical ports */
28               char fw_ver[20];                                /* FW version */
29               char ca_type[40];                               /* CA type (e.g. MT23108, etc.) */
30               char hw_ver[20];                                /* Hardware version */
31               uint64_t node_guid;                             /* Node GUID */
32               uint64_t system_guid;                           /* System image GUID */
33               umad_port_t *ports[UMAD_CA_MAX_PORTS];          /* Array of device port properties */
34       } umad_ca_t;
35
36       umad_release_ca()  releases  the  resources  that were allocated in the
37       function umad_get_ca().
38

RETURN VALUE

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

AUTHORS

44       Hal Rosenstock <halr@voltaire.com>
45
46       Dotan Barak <dotanb@mellanox.co.il>
47
48
49
50OpenIB                           May 21, 2007                   UMAD_GET_CA(3)
Impressum