man7.org > Linux > man-pages

Linux/UNIX system programming training

umad_set_grh_net(3) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | KNOWN BUGS | SEE ALSO | AUTHOR | COLOPHON 

UMAD_SET_GRH_NET(3)    OpenIB Programmer's Manual    UMAD_SET_GRH_NET(3)

NAME         top

       umad_set_grh_net - set GRH fields within umad buffer using
       network ordering

SYNOPSIS         top

       #include <infiniband/umad.h>

       int umad_set_grh_net(void *umad, void *mad_addr);

DESCRIPTION         top

       umad_set_grh_net() sets the GRH fields (grh_present, gid,
       hop_limit, traffic_class, flow_label) within the specified umad
       buffer based on the mad_addr supplied. The provided mad_addr
       fields are expected to be in network order.  If the mad_addr
       pointer supplied is NULL, no GRH is set.  The argument mad_addr
       is a pointer to an ib_mad_addr_t struct, as specified in
       <infiniband/umad.h>.  The argument umad is a pointer to an
       ib_user_mad_t struct, as specified in <infiniband/umad.h>.

       typedef struct ib_mad_addr {
               uint32_t qpn;
               uint32_t qkey;
               uint16_t lid;
               uint8_t  sl;
               uint8_t  path_bits;
               uint8_t  grh_present;
               uint8_t  gid_index;
               uint8_t  hop_limit;
               uint8_t  traffic_class;
               uint8_t  gid[16];
               uint32_t flow_label;
       } ib_mad_addr_t;

       typedef struct ib_user_mad {
               uint32_t agent_id;
               uint32_t status;
               uint32_t timeout_ms;
               uint32_t retries;
               uint32_t length;
               ib_mad_addr_t addr;
               uint8_t  data[0];
       } ib_user_mad_t;

RETURN VALUE         top

       umad_set_grh_net() returns 0 on success, and a negative value on
       errors. Currently, there are no errors indicated.

KNOWN BUGS         top

       Not implemented.

SEE ALSO         top

       umad_set_grh(3)

AUTHOR         top

       Hal Rosenstock <halr@voltaire.com>

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                        May 24, 2007           UMAD_SET_GRH_NET(3)

Pages that refer to this page: umad_set_grh(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