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:

nfds	The nfds, exactly as to be passed to the select(2) system call.
readfds	The readfds, exactly as to be passed to the select(2) system call.
writefds	The writefds, exactly as to be passed to the select(2) system call.
exceptfds	The exceptfds, exactly as to be passed to the select(2) system call.
timeout	The 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.