UMAD_POLL
Section: OpenIB Programmer's Manual (3)
Updated: October 23, 2007
Page Index
NAME
umad_poll - poll umad
SYNOPSIS
#include <infiniband/umad.h>
int umad_poll(int portid, int timeout_ms);
DESCRIPTION
umad_poll()
waits up to
timeout_ms
milliseconds for a packet to be received from the port specified by
portid.
Once a packet is ready to be read, the function
returns 0. After that the packet can be read using
umad_recv().
Otherwise, -ETIMEDOUT is returned. Note that successfully polling a port
does not guarantee that the subsequent
umad_recv()
will be non blocking when several threads are using
the same port. Instead, use a
timeout_ms
parameter of zero to
umad_recv()
to ensure a non-blocking read.
RETURN VALUE
umad_poll()
returns 0 on success, and a negative value on error as follows:
-EINVAL invalid port handle or agentid
-ETIMEDOUT poll operation timed out
-EIO poll operation failed
SEE ALSO
umad_recv(3)
AUTHOR
- Hal Rosenstock <halr@voltaire.com>
-