1UMAD_SEND(3)              OpenIB Programmer´s Manual              UMAD_SEND(3)
2
3
4

NAME

6       umad_send - send umad
7

SYNOPSIS

9       #include <infiniband/umad.h>
10
11       int umad_send(int portid, int agentid, void *umad, int length, int timeout_ms, int retries);
12

DESCRIPTION

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
17       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
24       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

RETURN VALUE

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

AUTHOR

39       Hal Rosenstock <halr@voltaire.com>
40
41
42
43OpenIB                           May 11, 2007                     UMAD_SEND(3)
Impressum