1explain_mktemp_or_die(3) Library Functions Manual explain_mktemp_or_die(3)
2
3
4
6 explain_mktemp_or_die - make a unique temporary filename and report
7 errors
8
10 #include <libexplain/mktemp.h>
11 char *explain_mktemp_or_die(char *pathname);
12 char *explain_mktemp_on_error(char *pathname);
13
15 The explain_mktemp_or_die function is used to call the mktemp(3) system
16 call. On failure an explanation will be printed to stderr, obtained
17 from the explain_mktemp(3) function, and then the process terminates by
18 calling exit(EXIT_FAILURE).
19
20 The explain_mktemp_on_error function is used to call the mktemp(3) sys‐
21 tem call. On failure an explanation will be printed to stderr, obtained
22 from the explain_mktemp(3) function, but still returns to the caller.
23
24 pathname
25 The pathname, exactly as to be passed to the mktemp(3) system
26 call.
27
29 The explain_mktemp_or_die function only returns on success, see
30 mktemp(3) for more information. On failure, prints an explanation and
31 exits, it does not return.
32
33 The explain_mktemp_on_error function always returns the value return by
34 the wrapped mktemp(3) system call.
35
37 The explain_mktemp_or_die function is intended to be used in a fashion
38 similar to the following example:
39 char *result = explain_mktemp_or_die(pathname);
40
42 mktemp(3)
43 make a unique temporary filename
44
45 explain_mktemp(3)
46 explain mktemp(3) errors
47
48 exit(2) terminate the calling process
49
51 libexplain version 0.40
52 Copyright (C) 2010 Peter Miller
53
54
55
56 explain_mktemp_or_die(3)