1explain_unlink_or_die(3) Library Functions Manual explain_unlink_or_die(3)
2
3
4
6 explain_unlink_or_die - delete a file and report errors
7
9 #include <libexplain/unlink.h>
10 void explain_unlink_or_die(const char *pathname);
11
13 The explain_unlink_or_die function is used to call the unlink(2) system
14 call. On failure an explanation will be printed to stderr, obtained
15 from explain_unlink(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_unlink_or_die(pathname);
21
22 pathname
23 The pathname, exactly as to be passed to the unlink(2) system
24 call.
25
26 Returns:
27 This function only returns on success. On failure, prints an
28 explanation and exits.
29
31 unlink(2)
32 delete a name and possibly the file it refers to
33
34 explain_unlink(3)
35 explain unlink(2) errors
36
37 exit(2) terminate the calling process
38
40 libexplain version 1.4
41 Copyright (C) 2008 Peter Miller
42
43
44
45 explain_unlink_or_die(3)