contrib/ofed/management/libibumad/man/umad_set_grh_net.3

   1 .\" -*- nroff -*-
   2 .\"
   3 .TH UMAD_SET_GRH_NET 3  "May 24, 2007" "OpenIB" "OpenIB Programmer\'s Manual"
   4 .SH "NAME"
   5 umad_set_grh_net \- set GRH fields within umad buffer using network ordering
   6 .SH "SYNOPSIS"
   7 .nf
   8 .B #include <infiniband/umad.h>
   9 .sp
  10 .BI "int umad_set_grh_net(void " "*umad" ", void " "*mad_addr");
  11 .fi
  12 .SH "DESCRIPTION"
  13 .B umad_set_grh_net()
  14 sets the GRH fields (grh_present, gid, hop_limit, traffic_class, flow_label)
  15 within the specified
  16 .I umad\fR
  17 buffer based on the
  18 .I mad_addr\fR
  19 supplied. The provided
  20 .I mad_addr\fR
  21 fields are expected to be in network order.
  22 If the
  23 .I mad_addr\fR
  24 pointer supplied is NULL, no GRH is set.
  25 The argument
  26 .I mad_addr
  27 is a pointer to an
  28 .I ib_mad_addr_t
  29 struct, as specified in <infiniband/umad.h>.
  30 The argument
  31 .I umad
  32 is a pointer to an
  33 .I ib_user_mad_t
  34 struct, as specified in
  35 .I <infiniband/umad.h>.
  36 .PP
  37 .nf
  38 typedef struct ib_mad_addr {
  39 .in +8
  40 uint32_t qpn;
  41 uint32_t qkey;
  42 uint16_t lid;
  43 uint8_t  sl;
  44 uint8_t  path_bits;
  45 uint8_t  grh_present;
  46 uint8_t  gid_index;
  47 uint8_t  hop_limit;
  48 uint8_t  traffic_class;
  49 uint8_t  gid[16];
  50 uint32_t flow_label;
  51 .in -8
  52 } ib_mad_addr_t;
  53 .PP
  54 typedef struct ib_user_mad {
  55 .in +8
  56 uint32_t agent_id;
  57 uint32_t status;
  58 uint32_t timeout_ms;
  59 uint32_t retries;
  60 uint32_t length;
  61 ib_mad_addr_t addr;
  62 uint8_t  data[0];
  63 .in -8
  64 } ib_user_mad_t;
  65 .fi
  66 .SH "RETURN VALUE"
  67 .B umad_set_grh_net()
  68 returns 0 on success, and a negative value on errors. Currently, there
  69 are no errors indicated.
  70 .SH "KNOWN BUGS"
  71 Not implemented.
  72 .SH "SEE ALSO"
  73 .BR umad_set_grh (3)
  74 .SH "AUTHOR"
  75 .TP
  76 Hal Rosenstock <halr@voltaire.com>