nstime.h

Go to the documentation of this file.

/* nstime.h
 * Definition of data structure to hold time values with nanosecond resolution
 *
 * Wireshark - Network traffic analyzer
 * By Gerald Combs <[email protected]>
 * Copyright 1998 Gerald Combs
 *
 * SPDX-License-Identifier: GPL-2.0-or-later
 */
 
#ifndef __NSTIME_H__
#define __NSTIME_H__
 
#include <wireshark.h>
#include <time.h>
 
#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */
 
typedef struct {
    time_t  secs;
    int nsecs;
} nstime_t;
 
/* Macros that expand to nstime_t initializers */
 
/* Initialize to zero */
#define NSTIME_INIT_ZERO {0, 0}
 
/* Initialize to unset */
#define NSTIME_INIT_UNSET {0, INT_MAX}
 
/* Initialize to a specified number of seconds and nanoseconds */
#define NSTIME_INIT_SECS_NSECS(secs, nsecs) {secs, nsecs}
 
/* Initialize to a specified number of seconds and microseconds */
#define NSTIME_INIT_SECS_USECS(secs, usecs) {secs, usecs*1000}
 
/* Initialize to a specified number of seconds and milliseconds */
#define NSTIME_INIT_SECS_MSECS(secs, msecs) {secs, msecs*1000000}
 
/* Initialize to a specified number of seconds */
#define NSTIME_INIT_SECS(secs)          {secs, 0}
 
/* Initialize to the maximum possible value */
#define NSTIME_INIT_MAX {sizeof(time_t) > sizeof(int) ? LONG_MAX : INT_MAX, INT_MAX}
 
/* functions */
 
WS_DLL_PUBLIC void nstime_set_zero(nstime_t *nstime);
 
WS_DLL_PUBLIC bool nstime_is_zero(const nstime_t *nstime);
 
WS_DLL_PUBLIC void nstime_set_unset(nstime_t *nstime);
 
/* is the given nstime_t currently (0,maxint)? */
WS_DLL_PUBLIC bool nstime_is_unset(const nstime_t *nstime);
 
WS_DLL_PUBLIC void nstime_copy(nstime_t *a, const nstime_t *b);
 
WS_DLL_PUBLIC void nstime_delta(nstime_t *delta, const nstime_t *b, const nstime_t *a );
 
WS_DLL_PUBLIC void nstime_sum(nstime_t *sum, const nstime_t *a, const nstime_t *b );
 
#define nstime_add(sum, a) nstime_sum(sum, sum, a)
 
#define nstime_subtract(sum, a) nstime_delta(sum, sum, a)
 
WS_DLL_PUBLIC int nstime_cmp (const nstime_t *a, const nstime_t *b );
 
WS_DLL_PUBLIC unsigned nstime_hash(const nstime_t *nstime);
 
WS_DLL_PUBLIC double nstime_to_msec(const nstime_t *nstime);
 
WS_DLL_PUBLIC double nstime_to_sec(const nstime_t *nstime);
 
WS_DLL_PUBLIC bool filetime_to_nstime(nstime_t *nstime, uint64_t filetime);
 
WS_DLL_PUBLIC bool filetime_ns_to_nstime(nstime_t *nstime, uint64_t nsfiletime);
 
WS_DLL_PUBLIC bool filetime_1sec_to_nstime(nstime_t *nstime, uint64_t filetime);
 
typedef enum {
    ISO8601_DATETIME,       
    ISO8601_DATETIME_BASIC, 
    ISO8601_DATETIME_AUTO,  
} iso8601_fmt_e;
 
WS_DLL_PUBLIC const char * iso8601_to_nstime(nstime_t *nstime, const char *ptr, iso8601_fmt_e format);
 
WS_DLL_PUBLIC const char * unix_epoch_to_nstime(nstime_t *nstime, const char *ptr);
 
#define NSTIME_ISO8601_BUFSIZE  sizeof("YYYY-MM-DDTHH:MM:SS.123456789Z")
 
WS_DLL_PUBLIC size_t nstime_to_iso8601(char *buf, size_t buf_size, const nstime_t *nstime);
 
/* 64 bit signed number plus nanosecond fractional part */
#define NSTIME_UNIX_BUFSIZE  (20+10+1)
 
WS_DLL_PUBLIC void nstime_to_unix(char *buf, size_t buf_size, const nstime_t *nstime);
 
/*
 * Timestamp precision values.
 *
 * The value is the number of digits of precision after the integral part.
 */
typedef enum {
    WS_TSPREC_SEC      = 0,
    WS_TSPREC_100_MSEC = 1,
    WS_TSPREC_10_MSEC  = 2,
    WS_TSPREC_MSEC     = 3,
    WS_TSPREC_100_USEC = 4,
    WS_TSPREC_10_USEC  = 5,
    WS_TSPREC_USEC     = 6,
    WS_TSPREC_100_NSEC = 7,
    WS_TSPREC_10_NSEC  = 8,
    WS_TSPREC_NSEC     = 9
} ws_tsprec_e;
 
/*
 * Maximum time stamp precision supported.
 * Note that going beyond nanosecond precision would require expanding
 * the fractional part of an nstime_t to 64 bits, and changing code
 * that currently only handles second to nanosecond precision.
 */
#define WS_TSPREC_MAX 9
 
/*
 * Total number of valid precision values.
 */
#define NUM_WS_TSPREC_VALS (WS_TSPREC_MAX + 1)
 
#ifdef __cplusplus
}
#endif /* __cplusplus */
 
#endif /* __NSTIME_H__  */