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

NAME

6       explain_tmpnam_or_die  -  create a name for a temporary file and report
7       errors
8

SYNOPSIS

10       #include <libexplain/tmpnam.h>
11       char *explain_tmpnam_or_die(char *pathname);
12       char *explain_tmpnam_on_error(char *pathname);
13

DESCRIPTION

15       The explain_tmpnam_or_die function is used to call the tmpnam(3) system
16       call.  On  failure  an  explanation will be printed to stderr, obtained
17       from the explain_tmpnam(3) function, and then the process terminates by
18       calling exit(EXIT_FAILURE).
19
20       The explain_tmpnam_on_error function is used to call the tmpnam(3) sys‐
21       tem call. On failure an explanation will be printed to stderr, obtained
22       from the explain_tmpnam(3) function, but still returns to the caller.
23
24       pathname
25               The  pathname,  exactly as to be passed to the tmpnam(3) system
26               call.
27

RETURN VALUE

29       The explain_tmpnam_or_die function only returns on  success,  see  tmp‐
30       nam(3)  for  more  information.  On  failure, prints an explanation and
31       exits, it does not return.
32
33       The explain_tmpnam_on_error function always returns the value return by
34       the wrapped tmpnam(3) system call.
35

EXAMPLE

37       The  explain_tmpnam_or_die function is intended to be used in a fashion
38       similar to the following example:
39              char *result = explain_tmpnam_or_die(pathname);
40

SEE ALSO

42       tmpnam(3)
43               create a name for a temporary file
44
45       explain_tmpnam(3)
46               explain tmpnam(3) errors
47
48       exit(2) terminate the calling process
49

51       libexplain version 1.4
52       Copyright (C) 2010 Peter Miller
53
54
55
56                                                      explain_tmpnam_or_die(3)
Impressum