libexplain/signalfd_on_error.c File Reference

#include <libexplain/ac/errno.h>
#include <libexplain/ac/signal.h>
#include <libexplain/ac/sys/signalfd.h>
#include <libexplain/signalfd.h>
#include <libexplain/output.h>

Go to the source code of this file.

Functions
int	explain_signalfd_on_error (int fildes, const sigset_t *mask, int flags)

---

Function Documentation

int explain_signalfd_on_error	(	int	fildes,
		const sigset_t *	mask,
		int	flags
	)

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

Parameters:

fildes	The fildes, exactly as to be passed to the signalfd(2) system call.
mask	The mask, exactly as to be passed to the signalfd(2) system call.
flags	The flags, exactly as to be passed to the signalfd(2) system call.

Returns:

The value returned by the wrapped signalfd(2) system call.

Example:

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

 int result = explain_signalfd_on_error(fildes, mask, flags);
 if (result < 0)
 {
     ...cope with error
     ...no need to print error message
 }

Definition at line 28 of file signalfd_on_error.c.