src/shared/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 #include "macro.h"
  31
  32 typedef struct dual_timestamp {
  33         usec_t realtime;
  34         usec_t monotonic;
  35 } dual_timestamp;
  36
  37 #define MSEC_PER_SEC  1000ULL
  38 #define USEC_PER_SEC  1000000ULL
  39 #define USEC_PER_MSEC 1000ULL
  40 #define NSEC_PER_SEC  1000000000ULL
  41 #define NSEC_PER_MSEC 1000000ULL
  42 #define NSEC_PER_USEC 1000ULL
  43
  44 #define USEC_PER_MINUTE (60ULL*USEC_PER_SEC)
  45 #define NSEC_PER_MINUTE (60ULL*NSEC_PER_SEC)
  46 #define USEC_PER_HOUR (60ULL*USEC_PER_MINUTE)
  47 #define NSEC_PER_HOUR (60ULL*NSEC_PER_MINUTE)
  48 #define USEC_PER_DAY (24ULL*USEC_PER_HOUR)
  49 #define NSEC_PER_DAY (24ULL*NSEC_PER_HOUR)
  50 #define USEC_PER_WEEK (7ULL*USEC_PER_DAY)
  51 #define NSEC_PER_WEEK (7ULL*NSEC_PER_DAY)
  52 #define USEC_PER_MONTH (2629800ULL*USEC_PER_SEC)
  53 #define NSEC_PER_MONTH (2629800ULL*NSEC_PER_SEC)
  54 #define USEC_PER_YEAR (31557600ULL*USEC_PER_SEC)
  55 #define NSEC_PER_YEAR (31557600ULL*NSEC_PER_SEC)
  56
  57 #define FORMAT_TIMESTAMP_MAX ((4*4+1)+11+9+4+1) /* weekdays can be unicode */
  58 #define FORMAT_TIMESTAMP_RELATIVE_MAX 256
  59 #define FORMAT_TIMESPAN_MAX 64
  60
  61 #define DUAL_TIMESTAMP_NULL ((struct dual_timestamp) { 0, 0 })
  62
  63 usec_t now(clockid_t clock);
  64
  65 dual_timestamp* dual_timestamp_get(dual_timestamp *ts);
  66 dual_timestamp* dual_timestamp_from_realtime(dual_timestamp *ts, usec_t u);
  67 dual_timestamp* dual_timestamp_from_monotonic(dual_timestamp *ts, usec_t u);
  68
  69 static inline bool dual_timestamp_is_set(dual_timestamp *ts) {
  70         return ((ts->realtime > 0 && ts->realtime != (usec_t) -1) ||
  71                 (ts->monotonic > 0 && ts->monotonic != (usec_t) -1));
  72 }
  73
  74 usec_t timespec_load(const struct timespec *ts) _pure_;
  75 struct timespec *timespec_store(struct timespec *ts, usec_t u);
  76
  77 usec_t timeval_load(const struct timeval *tv) _pure_;
  78 struct timeval *timeval_store(struct timeval *tv, usec_t u);
  79
  80 char *format_timestamp(char *buf, size_t l, usec_t t);
  81 char *format_timestamp_us(char *buf, size_t l, usec_t t);
  82 char *format_timestamp_relative(char *buf, size_t l, usec_t t);
  83 char *format_timespan(char *buf, size_t l, usec_t t, usec_t accuracy);
  84
  85 void dual_timestamp_serialize(FILE *f, const char *name, dual_timestamp *t);
  86 void dual_timestamp_deserialize(const char *value, dual_timestamp *t);
  87
  88 int parse_timestamp(const char *t, usec_t *usec);
  89
  90 int parse_sec(const char *t, usec_t *usec);
  91 int parse_nsec(const char *t, nsec_t *nsec);
  92
  93 bool ntp_synced(void);