1explain_chmod_or_die(3) Library Functions Manual explain_chmod_or_die(3)
2
3
4
6 explain_chmod_or_die - change permissions of a file and report errors
7
9 #include <libexplain/chmod.h>
10 void explain_chmod_or_die(const char *pathname, int mode);
11
13 The explain_chmod_or_die function is used to call the chmod(2) system
14 call. On failure an explanation wiil be printed to stderr, obtained
15 from explain_chmod(3), and the 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_chmod_or_die(pathname, mode);
21
22 pathname
23 The pathname, exactly as to be passed to the chmod(2) system
24 call.
25
26 mode The mode, exactly as to be passed to the chmod(2) system call.
27
28 Returns:
29 This function only returns on success. On failure, prints an
30 explanation and exit(EXIT_FAILURE)s.
31
33 libexplain version 1.4
34 Copyright (C) 2008 Peter Miller
35
37 Written by Peter Miller <pmiller@opensource.org.au>
38
39
40
41 explain_chmod_or_die(3)