1explain_setbuffer_or_die(3)Library Functions Manualexplain_setbuffer_or_die(3)
2
3
4
6 explain_setbuffer_or_die - stream buffering operations and report
7 errors
8
10 #include <libexplain/setbuffer.h>
11 void explain_setbuffer_or_die(FILE *fp, char *data, size_t size);
12 void explain_setbuffer_on_error(FILE *fp, char *data, size_t size);
13
15 The explain_setbuffer_or_die function is used to call the setbuffer(3)
16 system call. On failure an explanation will be printed to stderr,
17 obtained from the explain_setbuffer(3) function, and then the process
18 terminates by calling exit(EXIT_FAILURE).
19
20 The explain_setbuffer_on_error function is used to call the set‐
21 buffer(3) system call. On failure an explanation will be printed to
22 stderr, obtained from the explain_setbuffer(3) function, but still
23 returns to the caller.
24
25 fp The fp, exactly as to be passed to the setbuffer(3) system
26 call.
27
28 data The data, exactly as to be passed to the setbuffer(3) system
29 call.
30
31 size The size, exactly as to be passed to the setbuffer(3) system
32 call.
33
35 The explain_setbuffer_or_die function only returns on success, see set‐
36 buffer(3) for more information. On failure, prints an explanation and
37 exits, it does not return.
38
39 The explain_setbuffer_on_error function always returns the value return
40 by the wrapped setbuffer(3) system call.
41
43 The explain_setbuffer_or_die function is intended to be used in a fash‐
44 ion similar to the following example:
45 void result = explain_setbuffer_or_die(fp, data, size);
46
48 setbuffer(3)
49 stream buffering operations
50
51 explain_setbuffer(3)
52 explain setbuffer(3) errors
53
54 exit(2) terminate the calling process
55
57 libexplain version 0.40
58 Copyright (C) 2010 Peter Miller
59
60
61
62 explain_setbuffer_or_die(3)