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

NAME

6       explain_adjtimex_or_die - tune kernel clock and report errors
7

SYNOPSIS

9       #include <libexplain/adjtimex.h>
10       int explain_adjtimex_or_die(struct timex *data);
11       int explain_adjtimex_on_error(struct timex *data);
12

DESCRIPTION

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

RETURN VALUE

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

EXAMPLE

36       The  explain_adjtimex_or_die function is intended to be used in a fash‐
37       ion similar to the following example:
38              int result = explain_adjtimex_or_die(data);
39

SEE ALSO

41       adjtimex(2)
42               tune kernel clock
43
44       explain_adjtimex(3)
45               explain adjtimex(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_adjtimex_or_die(3)
Impressum