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

NAME

6       umad_poll - poll umad
7

SYNOPSIS

9       #include <infiniband/umad.h>
10
11       int umad_poll(int portid, int timeout_ms);
12

DESCRIPTION

14       umad_poll()  waits  up  to  timeout_ms  milliseconds for a packet to be
15       received from the port specified by portid.  Once a packet is ready  to
16       be  read,  the  function  returns  0. After that the packet can be read
17       using umad_recv().  Otherwise, -ETIMEDOUT is returned. Note  that  suc‐
18       cessfully  polling  a  port  does  not  guarantee  that  the subsequent
19       umad_recv() will be non blocking when several  threads  are  using  the
20       same  port.  Instead, use a timeout_ms parameter of zero to umad_recv()
21       to ensure a non-blocking read.
22

RETURN VALUE

24       umad_poll() returns 0 on success, and a negative value on error as fol‐
25       lows:
26        -EINVAL    invalid port handle or agentid
27        -ETIMEDOUT poll operation timed out
28        -EIO       poll operation failed
29

SEE ALSO

31       umad_recv(3)
32

AUTHOR

34       Hal Rosenstock <halr@voltaire.com>
35
36
37
38OpenIB                         October 23, 2007                   UMAD_POLL(3)