1UMAD_SEND(3) OpenIB Programmer's Manual UMAD_SEND(3)
2
6 umad_send - send umad
7
9 #include <infiniband/umad.h>
10 int umad_send(int portid, int agentid, void *umad, int length, int timeout_ms, int retries);
12
14 umad_send() sends length bytes from the specified umad buffer from the
15 port specified by portid, and using the agent specified by agentid.
16 The buffer can contain a RMPP transmission which is larger than a sin‐
18 gle MAD packet when the agentid specifies a class which utilizes RMPP
19 and the header flags indicate RMPP is active. NOTE currently only
20 RMPPFlags.Active is meaningful in the header in user space. All other
21 RMPP fields are ignored. The data section of the buffer will be sent
22 in multiple RMPP MAD packets with headers built for the user.
23 timeout_ms controls the solicited MADs behavior as follows: zero value
25 means not solicited. Positive value makes kernel indicate timeout in
26 milliseconds. If reply is not received within the specified value, the
27 original buffer is returned in the read channel with the status field
28 set (to non zero). Negative timeout_ms makes kernel wait forever for
29 the reply. retries indicates the number of times the MAD will be
30 retried before giving up.
31
33 umad_send() returns 0 on success; on error, errno is set and a negative
34 value is returned as follows:
35 -EINVAL invalid port handle or agentid
36 -EIO send operation failed
37
39 Hal Rosenstock <halr@voltaire.com>
40OpenIB May 11, 2007 UMAD_SEND(3)