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

NAME

6       explain_chroot_or_die - change root directory and report errors
7

SYNOPSIS

9       #include <libexplain/chroot.h>
10       void explain_chroot_or_die(const char *pathname);
11       int explain_chroot_on_error(const char *pathname))
12

DESCRIPTION

14       The explain_chroot_or_die function is used to call the chroot(2) system
15       call. On failure an explanation will be  printed  to  stderr,  obtained
16       from the explain_chroot(3) function, and then the process terminates by
17       calling exit(EXIT_FAILURE).
18
19       The explain_chroot_on_error function is used to call the chroot(2) sys‐
20       tem call. On failure an explanation will be printed to stderr, obtained
21       from the explain_chroot(3) function, but still returns to the caller.
22
23       pathname
24               The pathname, exactly as to be passed to the  chroot(2)  system
25               call.
26

RETURN VALUE

28       The   explain_chroot_or_die  function  only  returns  on  success,  see
29       chroot(2) for more information. On failure, prints an  explanation  and
30       exits, it does not return.
31
32       The explain_chroot_on_error function always returns the value return by
33       the wrapped chroot(2) system call.
34

EXAMPLE

36       The explain_chroot_or_die function is intended to be used in a  fashion
37       similar to the following example:
38              explain_chroot_or_die(pathname);
39

SEE ALSO

41       chroot(2)
42               change root directory
43
44       explain_chroot(3)
45               explain chroot(2) errors
46
47       exit(2) terminate the calling process
48

50       libexplain version 1.4
51       Copyright (C) 2009 Peter Miller
52
53
54
55                                                      explain_chroot_or_die(3)
Impressum