libexplain/open_on_error.c File Reference

#include <libexplain/ac/errno.h>
#include <libexplain/ac/fcntl.h>
#include <libexplain/open.h>
#include <libexplain/output.h>

Go to the source code of this file.

Functions
int	explain_open_on_error (const char *pathname, int flags, int mode)

---

Function Documentation

int explain_open_on_error	(	const char *	pathname,
		int	flags,
		int	mode
	)

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

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

 int fildes = explain_open_on_error(pathname, flags, mode);
 if (fildes < 0)
 {
     ...cope with error
     ...no need to print error message
 }

Parameters:

pathname	The pathname, exactly as to be passed to the open(2) system call.
flags	The flags, exactly as to be passed to the open(2) system call.
mode	The mode, exactly as to be passed to the open(2) system call.

Returns:

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

Definition at line 27 of file open_on_error.c.