explain_fopen_or_die(3)

explain_fopen_or_die3

Open file and report errors

Usage

#include <libexplain/fopen.h>

FILE *explain_fopen_or_die(const char *pathname, const char *flags);

Overview

The explain_fopen_or_die() function opens the file whose name is the string pointed to by pathname and associates a stream with it. See fopen(3) for more information.

This is a quick and simple way for programs to constitently report file open errors in a consistent and detailed fahion.

Return value

Upon successful completion explain_fopen_or_die returns a FILE pointer.

If an error occurs, explain_fopen will be called to explain the error, which will be printed onto stderr, and then the process will terminate by calling exit(EXIT_FAILURE).

Releases

6 releases since Debian 7 (Wheezy); the text changed 1 time.

  1. 7
  2. 9–13

Author

Written by Peter Miller <[email protected]>

From libexplain-dev 1.4.D001-16 in Debian 13 (Trixie). Parsed by carta from the page's man source.