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>


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
SEE ALSO
AUTHOR