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

NAME

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

SYNOPSIS

9       #include <libexplain/lchown.h>
10       void explain_lchown_or_die(const char *pathname, int owner, int group);
11

DESCRIPTION

13       The explain_lchown_or_die function is used to call the lchown(2) system
14       call.  On failure an explanation will be printed  to  stderr,  obtained
15       from  explain_lchown(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_lchown_or_die(pathname, owner, group);
21
22       pathname
23               The  pathname,  exactly as to be passed to the lchown(2) system
24               call.
25
26       owner   The owner, exactly as to be  passed  to  the  lchown(2)  system
27               call.
28
29       group   The  group,  exactly  as  to  be passed to the lchown(2) system
30               call.
31
32       Returns:
33               This function only returns on success.  On failure,  prints  an
34               explanation and exits.
35

SEE ALSO

37       lchown(2)
38               change ownership of a file
39
40       explain_lchown(3)
41               explain lchown(2) errors
42
43       exit(2) terminate the calling process
44
46       libexplain version 0.40
47       Copyright (C) 2008 Peter Miller
48
49
50
51                                                      explain_lchown_or_die(3)
Impressum