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

NAME

6       explain_fchown_or_die - change ownership of a file and report errors
7

SYNOPSIS

9       #include <libexplain/fchown.h>
10       void explain_fchown_or_die(int fildes, int owner, int group);
11

DESCRIPTION

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

SEE ALSO

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 0.40
46       Copyright (C) 2008 Peter Miller
47
48
49
50                                                      explain_fchown_or_die(3)
Impressum