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>