NAME

       umad_send - send umad

SYNOPSIS

       #include <infiniband/umad.h>

       int umad_send(int portid, int agentid, void *umad, int length, int timeout_ms, int retries);

DESCRIPTION

       umad_send()  sends  length  bytes  from  the specified umad buffer from the port specified by portid, and
       using the agent specified by agentid.

       The buffer can contain a RMPP transmission which is larger than a single  MAD  packet  when  the  agentid
       specifies  a class which utilizes RMPP and the header flags indicate RMPP is active.  NOTE currently only
       RMPPFlags.Active is meaningful in the header in user space.  All other RMPP fields are ignored.  The data
       section of the buffer will be sent in multiple RMPP MAD packets with headers built for the user.

       timeout_ms  controls  the  solicited  MADs  behavior as follows: zero value means not solicited. Positive
       value makes kernel indicate timeout in milliseconds. If reply is not received within the specified value,
       the  original  buffer  is  returned in the read channel with the status field set (to non zero). Negative
       timeout_ms makes kernel wait forever for the reply.  retries indicates the number of times the  MAD  will
       be retried before giving up.

RETURN VALUE

       umad_send() returns 0 on success; on error, errno is set and a negative value is returned as follows:
        -EINVAL invalid port handle or agentid
        -EIO    send operation failed

AUTHOR

       Hal Rosenstock <halr@voltaire.com>