1explain_fchown_or_die(3) Library Functions Manual explain_fchown_or_die(3)
2
3
4
6 explain_fchown_or_die - change ownership of a file and report errors
7
9 #include <libexplain/fchown.h>
10 void explain_fchown_or_die(int fildes, int owner, int group);
11
13 The explain_fchown_or_die function is used to call the fchown(2) system
14 call. On failure an explanation will be printed to stderr, obtained
15 from explain_fchown(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_fchown_or_die(fildes, owner, group);
21
22 fildes The fildes, exactly as to be passed to the fchown(2) system
23 call.
24
25 owner The owner, exactly as to be passed to the fchown(2) system
26 call.
27
28 group The group, exactly as to be passed to the fchown(2) system
29 call.
30
31 Returns:
32 This function only returns on success. On failure, prints an
33 explanation and exits.
34
36 fchown(2)
37 change ownership of a file
38
39 explain_fchown(3)
40 explain fchown(2) errors
41
42 exit(2) terminate the calling process
43
45 libexplain version 1.4
46 Copyright (C) 2008 Peter Miller
47
48
49
50 explain_fchown_or_die(3)