util-linux/include/timeutils.h
Karel Zak b200c2aab0 build-sys: split _PATH_ADJTIME to two files
This patch introduces:

* _PATH_HWCLOCK_MODE_FILE for clock mode (UTC or LOCAL), default is
   _PATH_ADJTIME (/etc/adjtime).

* _PATH_HWCLOCK_DRIFT_FILE - optional file for clock drift information,
  the default is /var/lib/hwclock/drift. If the file does not exist than
  default to _PATH_HWCLOCK_MODE_FILE.

The both files use 'adjtime' file format for better backward compatibility.

The file /etc/adjtime is de-facto standard and it's used by more 3rd party
utils (e.g. systemd). Unfortunately, keep state files in /etc is bad
idea. This change makes /etc/adjtime read-only for UTC / LOCAL info
and rest is maintained in /var/lib/hwclock/drift.

Note that /var/lib/hwclock/drift is not automatically created. It's up
to downstream (or system admin) to create the file, for example by:

 		cp /etc/adjtime /var/lib/hwclock/drift

otherwise binary will fall back to /etc/adjtime. This idea makes
hwclock backwardly compatible and more portable without recompilation.
(This patch does not implement changes for hwclock.)

Signed-off-by: Karel Zak <kzak@redhat.com>
2021-03-05 15:53:22 +01:00

96 lines
3.2 KiB
C

/***
First set of functions in this file are part of systemd, and were
copied to util-linux at August 2013.
Copyright 2010 Lennart Poettering
Copyright (C) 2014 Karel Zak <kzak@redhat.com>
systemd is free software; you can redistribute it and/or modify it
under the terms of the GNU Lesser General Public License as published by
the Free Software Foundation; either version 2.1 of the License, or
(at your option) any later version.
systemd is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License
along with systemd; If not, see <http://www.gnu.org/licenses/>.
***/
#ifndef UTIL_LINUX_TIME_UTIL_H
#define UTIL_LINUX_TIME_UTIL_H
#include <stdio.h>
#include <inttypes.h>
#include <sys/time.h>
typedef uint64_t usec_t;
typedef uint64_t nsec_t;
#define MSEC_PER_SEC 1000ULL
#define USEC_PER_SEC 1000000ULL
#define USEC_PER_MSEC 1000ULL
#define NSEC_PER_SEC 1000000000ULL
#define NSEC_PER_MSEC 1000000ULL
#define NSEC_PER_USEC 1000ULL
#define USEC_PER_MINUTE (60ULL*USEC_PER_SEC)
#define NSEC_PER_MINUTE (60ULL*NSEC_PER_SEC)
#define USEC_PER_HOUR (60ULL*USEC_PER_MINUTE)
#define NSEC_PER_HOUR (60ULL*NSEC_PER_MINUTE)
#define USEC_PER_DAY (24ULL*USEC_PER_HOUR)
#define NSEC_PER_DAY (24ULL*NSEC_PER_HOUR)
#define USEC_PER_WEEK (7ULL*USEC_PER_DAY)
#define NSEC_PER_WEEK (7ULL*NSEC_PER_DAY)
#define USEC_PER_MONTH (2629800ULL*USEC_PER_SEC)
#define NSEC_PER_MONTH (2629800ULL*NSEC_PER_SEC)
#define USEC_PER_YEAR (31557600ULL*USEC_PER_SEC)
#define NSEC_PER_YEAR (31557600ULL*NSEC_PER_SEC)
#define FORMAT_TIMESTAMP_MAX ((4*4+1)+11+9+4+1) /* weekdays can be unicode */
#define FORMAT_TIMESTAMP_RELATIVE_MAX 256
#define FORMAT_TIMESPAN_MAX 64
int parse_timestamp(const char *t, usec_t *usec);
int get_gmtoff(const struct tm *tp);
/* flags and masks for strxxx_iso() functions */
enum {
ISO_DATE = (1 << 0),
ISO_TIME = (1 << 1),
ISO_TIMEZONE = (1 << 2),
ISO_DOTUSEC = (1 << 3),
ISO_COMMAUSEC = (1 << 4),
ISO_T = (1 << 5),
ISO_GMTIME = (1 << 6),
ISO_TIMESTAMP = ISO_DATE | ISO_TIME | ISO_TIMEZONE,
ISO_TIMESTAMP_T = ISO_TIMESTAMP | ISO_T,
ISO_TIMESTAMP_DOT = ISO_TIMESTAMP | ISO_DOTUSEC,
ISO_TIMESTAMP_DOT_T = ISO_TIMESTAMP_DOT | ISO_T,
ISO_TIMESTAMP_COMMA = ISO_TIMESTAMP | ISO_COMMAUSEC,
ISO_TIMESTAMP_COMMA_T = ISO_TIMESTAMP_COMMA | ISO_T,
ISO_TIMESTAMP_COMMA_G = ISO_TIMESTAMP_COMMA | ISO_GMTIME,
ISO_TIMESTAMP_COMMA_GT = ISO_TIMESTAMP_COMMA_G | ISO_T
};
#define CTIME_BUFSIZ 26
#define ISO_BUFSIZ 42
int strtimeval_iso(struct timeval *tv, int flags, char *buf, size_t bufsz);
int strtm_iso(struct tm *tm, int flags, char *buf, size_t bufsz);
int strtime_iso(const time_t *t, int flags, char *buf, size_t bufsz);
#define UL_SHORTTIME_THISYEAR_HHMM (1 << 1)
int strtime_short(const time_t *t, struct timeval *now, int flags, char *buf, size_t bufsz);
#ifndef HAVE_TIMEGM
extern time_t timegm(struct tm *tm);
#endif
const char *ul_hwclock_get_drift_file(void);
const char *ul_hwclock_get_mode_file(void);
int ul_hwclock_mode_is_utc(const char *modefile, int *rc);
#endif /* UTIL_LINUX_TIME_UTIL_H */