1explain_adjtime_or_die(3) Library Functions Manual explain_adjtime_or_die(3)
2
3
4
6 explain_adjtime_or_die - smoothly tune kernel clock and report errors
7
9 #include <libexplain/adjtime.h>
10 void explain_adjtime_or_die(const struct timeval *delta, struct timeval
11 *olddelta);
12 int explain_adjtime_on_error(const struct timeval *delta, struct
13 timeval *olddelta);
14
16 The explain_adjtime_or_die function is used to call the adjtime(2) sys‐
17 tem call. On failure an explanation will be printed to stderr, obtained
18 from the explain_adjtime(3) function, and then the process terminates
19 by calling exit(EXIT_FAILURE).
20
21 The explain_adjtime_on_error function is used to call the adjtime(2)
22 system call. On failure an explanation will be printed to stderr,
23 obtained from the explain_adjtime(3) function, but still returns to the
24 caller.
25
26 delta The delta, exactly as to be passed to the adjtime(2) system
27 call.
28
29 olddelta
30 The olddelta, exactly as to be passed to the adjtime(2) system
31 call.
32
34 The explain_adjtime_or_die function only returns on success, see adj‐
35 time(2) for more information. On failure, prints an explanation and
36 exits, it does not return.
37
38 The explain_adjtime_on_error function always returns the value return
39 by the wrapped adjtime(2) system call.
40
42 The explain_adjtime_or_die function is intended to be used in a fashion
43 similar to the following example:
44 explain_adjtime_or_die(delta, olddelta);
45
47 adjtime(2)
48 smoothly tune kernel clock
49
50 explain_adjtime(3)
51 explain adjtime(2) errors
52
53 exit(2) terminate the calling process
54
56 libexplain version 1.4
57 Copyright (C) 2009 Peter Miller
58
59
60
61 explain_adjtime_or_die(3)