explain_open_or_die man page

explain_open_or_die — open file and report errors

Synopsis

#include <fcntl.h>
#include <libexplain/open.h>

int explain_open_or_die(const char *pathname, int flags, int mode);

Description

Given a pathname for a file, open() returns a file descriptor, a small, non-negative integer for use in subsequent system calls (read(2), write(2), lseek(2), fcntl(2), etc.).  The file descriptor returned by a successful call will be the lowest-numbered file descriptor not currently open for the process. See open(2) for more information.

Return Value

On success, the new file descriptor is returned.

On error, a description of the error is obtained via explain_open(3), and printed on stderr.  The process is the terminated via a call to the exit(EXIT_FAILURE) function.

Author

Written by Peter Miller <pmiller@opensource.org.au>

Referenced By

explain(3).