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

NAME

6       explain_acct_or_die  -  switch  process accounting on or off and report
7       errors
8

SYNOPSIS

10       #include <libexplain/acct.h>
11       void explain_acct_or_die(const char *pathname);
12       int explain_acct_on_error(const char *pathname))
13

DESCRIPTION

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

RETURN VALUE

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

EXAMPLE

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

SEE ALSO

42       acct(2) switch process accounting on or off
43
44       explain_acct(3)
45               explain acct(2) errors
46
47       exit(2) terminate the calling process
48
50       libexplain version 0.40
51       Copyright (C) 2009 Peter Miller
52
53
54
55                                                        explain_acct_or_die(3)
Impressum