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

NAME

6       explain_mktemp_or_die  -  make  a  unique temporary filename and report
7       errors
8

SYNOPSIS

10       #include <libexplain/mktemp.h>
11       char *explain_mktemp_or_die(char *pathname);
12       char *explain_mktemp_on_error(char *pathname);
13

DESCRIPTION

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

RETURN VALUE

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

EXAMPLE

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

SEE ALSO

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)
Impressum