1explain_remove_or_die(3)   Library Functions Manual   explain_remove_or_die(3)
2
3
4

NAME

6       explain_remove_or_die - delete a file and report errors
7

SYNOPSIS

9       #include <libexplain/remove.h>
10       void explain_remove_or_die(const char *pathname);
11

DESCRIPTION

13       The explain_remove_or_die function is used to call the remove(2) system
14       call.  On failure an explanation will be printed  to  stderr,  obtained
15       from  explain_remove(3),  and  then  the  process terminates by calling
16       exit(EXIT_FAILURE).
17
18       This function is intended to be used in a fashion similar to  the  fol‐
19       lowing example:
20              explain_remove_or_die(pathname);
21
22       pathname
23               The  pathname,  exactly as to be passed to the remove(2) system
24               call.
25
26       Returns:
27               This function only returns on success.  On failure,  prints  an
28               explanation and exits.
29

SEE ALSO

31       remove(2)
32               delete a name and possibly the file it refers to
33
34       explain_remove(3)
35               explain remove(2) errors
36
37       exit(2) terminate the calling process
38

40       libexplain version 0.40
41       Copyright (C) 2008 Peter Miller
42
43
44
45                                                      explain_remove_or_die(3)
Impressum