explain_freopen_or_die(3)

explain_freopen_or_die3

Open file and report errors

Usage

#include <libexplain/freopen.h>
void explain_freopen_or_die(const char *pathname, const char *flags, FILE *fp);

Overview

The explain_freopen_or_die function is used to reopen a file via the freopen(3) system call. On failure it will print an explanation, obtained from the linexplain_freopen(3) function, on the standard error stream and then exit.

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

explain_freopen_or_die(pathname, flags, fp);
pathname

The pathname, exactly as to be passed to the freopen(3) system call.

flags

The flags, exactly as to be passed to the freopen(3) system call.

fp

The fp, exactly as to be passed to the freopen(3) system call.

Returns:

Only ever return on success. Never returns on 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.