man7.org > Linux > man-pages

Linux/UNIX system programming training

umad_get_ca_portguids(3) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | SEE ALSO | AUTHORS | COLOPHON 

UMAD_GE...ORTGUIDS(3)  OpenIB Programmer's Manual  UMAD_GE...ORTGUIDS(3)

NAME         top

       umad_get_ca_portguids - get the InfiniBand device ports GUIDs

SYNOPSIS         top

       #include <infiniband/umad.h>

       int umad_get_ca_portguids(char *ca_name, __be64 *portguids, int max);

DESCRIPTION         top

       umad_get_ca_portguids() fills the portguids array with up to max
       port GUIDs belonging the specified IB device ca_name , or to the
       default IB device if ca_name is NULL.  The argument portguids is
       an array of max uint64_t entries.

RETURN VALUE         top

       On success, umad_get_ca_portguids() returns a non-negative value
       equal to the number of port GUIDs actually filled.  Not all
       filled entries may be valid. Invalid entries will be 0.  For
       example, on a CA node with only one port, this function returns a
       value of 2.  In this case, the value at index 0 will be invalid
       as it is reserved for switches.  On failure, a negative value is
       returned.

SEE ALSO         top

       umad_get_cas_names(3)

AUTHORS         top

       Hal Rosenstock <halr@voltaire.com>

       Dotan Barak <dotanb@mellanox.co.il>

COLOPHON         top

       This page is part of the rdma-core (RDMA Core Userspace Libraries
       and Daemons) project.  Information about the project can be found
       at ⟨https://github.com/linux-rdma/rdma-core⟩.  If you have a bug
       report for this manual page, send it to
       linux-rdma@vger.kernel.org.  This page was obtained from the
       project's upstream Git repository
       ⟨https://github.com/linux-rdma/rdma-core.git⟩ on 2024-06-14.  (At
       that time, the date of the most recent commit that was found in
       the repository was 2024-06-10.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there
       is a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       man-pages@man7.org

OpenIB                       August 8, 2016        UMAD_GE...ORTGUIDS(3)

Pages that refer to this page: umad_get_cas_names(3)

HTML rendering created 2024-06-26 by Michael Kerrisk, author of The Linux Programming Interface.

For details of in-depth Linux/UNIX system programming training courses that I teach, look here.

Hosting by jambit GmbH.

Cover of TLPI