libexplain  1.4.D001
Functions
libexplain/select_on_error.c File Reference
#include <libexplain/ac/errno.h>
#include <libexplain/ac/sys/select.h>
#include <libexplain/select.h>
#include <libexplain/output.h>

Go to the source code of this file.

Functions

int explain_select_on_error (int nfds, fd_set *readfds, fd_set *writefds, fd_set *exceptfds, struct timeval *timeout)

Function Documentation

int explain_select_on_error ( int  nfds,
fd_set *  readfds,
fd_set *  writefds,
fd_set *  exceptfds,
struct timeval *  timeout 
)

The explain_select_on_error function is used to call the select(2) system call. On failure an explanation will be printed to stderr, obtained from the explain_select(3) function.

This function is intended to be used in a fashion similar to the following example:

 if (explain_select_on_error(nfds, readfds, writefds, exceptfds, timeout)
     < 0)
 {
     ...cope with error
     ...no need to print error message
 }
Parameters:
nfdsThe nfds, exactly as to be passed to the select(2) system call.
readfdsThe readfds, exactly as to be passed to the select(2) system call.
writefdsThe writefds, exactly as to be passed to the select(2) system call.
exceptfdsThe exceptfds, exactly as to be passed to the select(2) system call.
timeoutThe timeout, exactly as to be passed to the select(2) system call.
Returns:
The value returned by the wrapped select(2) system call.

Definition at line 27 of file select_on_error.c.