chiark / gitweb /
Prep v220: Fix src/basic/time-util.h, unmask timezone_is_valid, mask unneeded functions.
[elogind.git] / src / basic / time-util.h
1 /*-*- Mode: C; c-basic-offset: 8; indent-tabs-mode: nil -*-*/
2
3 #pragma once
4
5 /***
6   This file is part of systemd.
7
8   Copyright 2010 Lennart Poettering
9
10   systemd is free software; you can redistribute it and/or modify it
11   under the terms of the GNU Lesser General Public License as published by
12   the Free Software Foundation; either version 2.1 of the License, or
13   (at your option) any later version.
14
15   systemd is distributed in the hope that it will be useful, but
16   WITHOUT ANY WARRANTY; without even the implied warranty of
17   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
18   Lesser General Public License for more details.
19
20   You should have received a copy of the GNU Lesser General Public License
21   along with systemd; If not, see <http://www.gnu.org/licenses/>.
22 ***/
23
24 #include <stdio.h>
25 #include <inttypes.h>
26
27 typedef uint64_t usec_t;
28 typedef uint64_t nsec_t;
29
30 #define NSEC_FMT "%" PRIu64
31 #define USEC_FMT "%" PRIu64
32
33 #include "macro.h"
34
35 typedef struct dual_timestamp {
36         usec_t realtime;
37         usec_t monotonic;
38 } dual_timestamp;
39
40 #define USEC_INFINITY ((usec_t) -1)
41 #define NSEC_INFINITY ((nsec_t) -1)
42
43 #define MSEC_PER_SEC  1000ULL
44 #define USEC_PER_SEC  ((usec_t) 1000000ULL)
45 #define USEC_PER_MSEC ((usec_t) 1000ULL)
46 #define NSEC_PER_SEC  ((nsec_t) 1000000000ULL)
47 #define NSEC_PER_MSEC ((nsec_t) 1000000ULL)
48 #define NSEC_PER_USEC ((nsec_t) 1000ULL)
49
50 #define USEC_PER_MINUTE ((usec_t) (60ULL*USEC_PER_SEC))
51 #define NSEC_PER_MINUTE ((nsec_t) (60ULL*NSEC_PER_SEC))
52 #define USEC_PER_HOUR ((usec_t) (60ULL*USEC_PER_MINUTE))
53 #define NSEC_PER_HOUR ((nsec_t) (60ULL*NSEC_PER_MINUTE))
54 #define USEC_PER_DAY ((usec_t) (24ULL*USEC_PER_HOUR))
55 #define NSEC_PER_DAY ((nsec_t) (24ULL*NSEC_PER_HOUR))
56 #define USEC_PER_WEEK ((usec_t) (7ULL*USEC_PER_DAY))
57 #define NSEC_PER_WEEK ((nsec_t) (7ULL*NSEC_PER_DAY))
58 #define USEC_PER_MONTH ((usec_t) (2629800ULL*USEC_PER_SEC))
59 #define NSEC_PER_MONTH ((nsec_t) (2629800ULL*NSEC_PER_SEC))
60 #define USEC_PER_YEAR ((usec_t) (31557600ULL*USEC_PER_SEC))
61 #define NSEC_PER_YEAR ((nsec_t) (31557600ULL*NSEC_PER_SEC))
62
63 #define FORMAT_TIMESTAMP_MAX ((4*4+1)+11+9+4+1) /* weekdays can be unicode */
64 #define FORMAT_TIMESTAMP_WIDTH 28 /* when outputting, assume this width */
65 #define FORMAT_TIMESTAMP_RELATIVE_MAX 256
66 #define FORMAT_TIMESPAN_MAX 64
67
68 #define TIME_T_MAX (time_t)((1UL << ((sizeof(time_t) << 3) - 1)) - 1)
69
70 #define DUAL_TIMESTAMP_NULL ((struct dual_timestamp) { 0ULL, 0ULL })
71
72 usec_t now(clockid_t clock);
73 // UNNEEDED nsec_t now_nsec(clockid_t clock);
74
75 dual_timestamp* dual_timestamp_get(dual_timestamp *ts);
76 dual_timestamp* dual_timestamp_from_realtime(dual_timestamp *ts, usec_t u);
77 // UNNEEDED dual_timestamp* dual_timestamp_from_monotonic(dual_timestamp *ts, usec_t u);
78 // UNNEEDED dual_timestamp* dual_timestamp_from_boottime_or_monotonic(dual_timestamp *ts, usec_t u);
79
80 static inline bool dual_timestamp_is_set(dual_timestamp *ts) {
81         return ((ts->realtime > 0 && ts->realtime != USEC_INFINITY) ||
82                 (ts->monotonic > 0 && ts->monotonic != USEC_INFINITY));
83 }
84
85 usec_t timespec_load(const struct timespec *ts) _pure_;
86 struct timespec *timespec_store(struct timespec *ts, usec_t u);
87
88 usec_t timeval_load(const struct timeval *tv) _pure_;
89 struct timeval *timeval_store(struct timeval *tv, usec_t u);
90
91 nsec_t timespec_load_nsec(const struct timespec *ts) _pure_;
92
93 char *format_timestamp(char *buf, size_t l, usec_t t);
94 // UNNEEDED char *format_timestamp_utc(char *buf, size_t l, usec_t t);
95 char *format_timestamp_us(char *buf, size_t l, usec_t t);
96 // UNNEEDED char *format_timestamp_us_utc(char *buf, size_t l, usec_t t);
97 char *format_timestamp_relative(char *buf, size_t l, usec_t t);
98 char *format_timespan(char *buf, size_t l, usec_t t, usec_t accuracy);
99
100 // UNNEEDED void dual_timestamp_serialize(FILE *f, const char *name, dual_timestamp *t);
101 // UNNEEDED int dual_timestamp_deserialize(const char *value, dual_timestamp *t);
102
103 // UNNEEDED int parse_timestamp(const char *t, usec_t *usec);
104
105 int parse_sec(const char *t, usec_t *usec);
106 int parse_nsec(const char *t, nsec_t *nsec);
107
108 // UNNEEDED bool ntp_synced(void);
109
110 // UNNEEDED int get_timezones(char ***l);
111 bool timezone_is_valid(const char *name);
112
113 clockid_t clock_boottime_or_monotonic(void);
114
115 #define xstrftime(buf, fmt, tm) assert_se(strftime(buf, ELEMENTSOF(buf), fmt, tm) > 0)
116
117 int get_timezone(char **timezone);