linux-scalability-benchmarks / libowfat / tai.h

The default branch has multiple heads

Full commit
#ifndef TAI_H
#define TAI_H

/* Times with 1 second precision */

#include "uint64.h"

/* A struct tai value is an integer between 0 inclusive and 2^64
 * exclusive. The format of struct tai is designed to speed up common
 * operations; applications should not look inside struct tai.
 * A struct tai variable is commonly used to store a TAI64 label. Each
 * TAI64 label refers to one second of real time. TAI64 labels span a
 * range of hundreds of billions of years.
 * A struct tai variable may also be used to store the numerical
 * difference between two TAI64 labels.
 * See */

typedef struct tai {
  uint64 x;
} tai64;

#define tai_unix(t,u) ((void) ((t)->x = 4611686018427387914ULL + (uint64) (u)))

/* tai_now puts the current time into t. More precisely: tai_now puts
 * into t its best guess as to the TAI64 label for the 1-second interval
 * that contains the current time.
 * This implementation of tai_now assumes that the time_t returned from
 * the time function represents the number of TAI seconds since
 * 1970-01-01 00:00:10 TAI. This matches the convention used by the
 * Olson tz library in ``right'' mode. */
void tai_now(struct tai *);

/* tai_approx returns a double-precision approximation to t. The result
 * of tai_approx is always nonnegative. */
#define tai_approx(t) ((double) ((t)->x))

/* tai_add adds a to b modulo 2^64 and puts the result into t. The
 * inputs and output may overlap. */
void tai_add(struct tai *,const struct tai *,const struct tai *);
/* tai_sub subtracts b from a modulo 2^64 and puts the result into t.
 * The inputs and output may overlap. */
void tai_sub(struct tai *,const struct tai *,const struct tai *);
/* tai_less returns 1 if a is less than b, 0 otherwise. */
#define tai_less(t,u) ((t)->x < (u)->x)

#define TAI_PACK 8
/* tai_pack converts a TAI64 label from internal format in t to external
 * TAI64 format in buf. */
void tai_pack(char *,const struct tai *);
/* tai_unpack converts a TAI64 label from external TAI64 format in buf
 * to internal format in t. */
void tai_unpack(const char *,struct tai *);

void tai_uint(struct tai *,unsigned int);