Time library

Time and time calculations. More...

Collaboration diagram for Time library:

Data Structures
struct	GNUNET_TIME_Absolute
	Time for absolute times used by GNUnet, in microseconds. More...
struct	GNUNET_TIME_Timestamp
	Time for timestamps used by GNUnet, in microseconds rounded to seconds. More...
struct	GNUNET_TIME_Relative
	Time for relative time used by GNUnet, in microseconds. More...
struct	GNUNET_TIME_RelativeNBO
	Time for relative time used by GNUnet, in microseconds and in network byte order. More...
struct	GNUNET_TIME_AbsoluteNBO
	Time for absolute time used by GNUnet, in microseconds and in network byte order. More...
struct	GNUNET_TIME_TimestampNBO
	Time for timestamps used by GNUnet, in seconds and in network byte order. More...

Macros
#define	GNUNET_TIME_UNIT_ZERO   ((struct GNUNET_TIME_Relative){0})
	Relative time zero.
#define	GNUNET_TIME_UNIT_ZERO_ABS   ((struct GNUNET_TIME_Absolute){0})
	Absolute time zero.
#define	GNUNET_TIME_UNIT_ZERO_TS   ((struct GNUNET_TIME_Timestamp){{0}})
	Timestamp of zero.
#define	GNUNET_TIME_UNIT_MICROSECONDS   GNUNET_TIME_relative_get_unit_ ()
	One microsecond, our basic time unit.
#define	GNUNET_TIME_UNIT_MILLISECONDS   GNUNET_TIME_relative_get_millisecond_ ()
	One millisecond.
#define	GNUNET_TIME_UNIT_SECONDS   GNUNET_TIME_relative_get_second_ ()
	One second.
#define	GNUNET_TIME_UNIT_MINUTES   GNUNET_TIME_relative_get_minute_ ()
	One minute.
#define	GNUNET_TIME_UNIT_HOURS   GNUNET_TIME_relative_get_hour_ ()
	One hour.
#define	GNUNET_TIME_UNIT_DAYS
	One day.
#define	GNUNET_TIME_UNIT_WEEKS
	One week.
#define	GNUNET_TIME_UNIT_MONTHS
	One month (30 days).
#define	GNUNET_TIME_UNIT_YEARS
	One year (365 days).
#define	GNUNET_TIME_UNIT_FOREVER_REL    ((struct GNUNET_TIME_Relative){UINT64_MAX})
	Constant used to specify "forever".
#define	GNUNET_TIME_UNIT_FOREVER_ABS    ((struct GNUNET_TIME_Absolute){UINT64_MAX})
	Constant used to specify "forever".
#define	GNUNET_TIME_UNIT_NEVER_ABS    ((struct GNUNET_TIME_Absolute){UINT64_MAX})
#define	GNUNET_TIME_UNIT_FOREVER_TS    ((struct GNUNET_TIME_Timestamp){{UINT64_MAX}})
	Constant used to specify "forever".
#define	GNUNET_TIME_STD_EXPONENTIAL_BACKOFF_THRESHOLD    GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_MINUTES, 15)
	Threshold after which exponential backoff should not increase (15 m).
#define	GNUNET_TIME_STD_BACKOFF(r)
	Perform our standard exponential back-off calculation, starting at 1 ms and then going by a factor of 2 up unto a maximum of 15 m.
#define	GNUNET_TIME_absolute_cmp(t1, op, t2)    ((void) (1 op 2), (t1).abs_value_us op (t2).abs_value_us)
	Compare two absolute times.
#define	GNUNET_TIME_timestamp_cmp(t1, op, t2)    GNUNET_TIME_absolute_cmp ((t1).abs_time,op,(t2).abs_time)
	Compare two timestamps.
#define	GNUNET_TIME_relative_cmp(t1, op, t2)    ((void) (1 op 2), (t1).rel_value_us op (t2).rel_value_us)
	Compare two relative times.

Enumerations
enum	GNUNET_TIME_RounderInterval {   GNUNET_TIME_RI_NONE = 0 , GNUNET_TIME_RI_SECOND , GNUNET_TIME_RI_MINUTE , GNUNET_TIME_RI_HOUR ,   GNUNET_TIME_RI_DAY , GNUNET_TIME_RI_WEEK , GNUNET_TIME_RI_MONTH , GNUNET_TIME_RI_QUARTER ,   GNUNET_TIME_RI_YEAR }
	Quantities by which we support round up absolute time values. More...

Functions
enum GNUNET_GenericReturnValue	GNUNET_STRINGS_fancy_time_to_absolute (const char *fancy_time, struct GNUNET_TIME_Absolute *atime)
	Convert a given fancy human-readable time to our internal representation.
enum GNUNET_GenericReturnValue	GNUNET_STRINGS_fancy_time_to_timestamp (const char *fancy_time, struct GNUNET_TIME_Timestamp *atime)
	Convert a given fancy human-readable time to our internal representation.
const char *	GNUNET_STRINGS_timestamp_to_string (struct GNUNET_TIME_Timestamp t)
	Like asctime, except for GNUnet time.
const char *	GNUNET_STRINGS_absolute_time_to_string (struct GNUNET_TIME_Absolute t)
	Like asctime, except for GNUnet time.
const char *	GNUNET_STRINGS_relative_time_to_string (struct GNUNET_TIME_Relative delta, int do_round)
	Give relative time in human-readable fancy format.
enum GNUNET_TIME_RounderInterval	GNUNET_TIME_relative_to_round_interval (struct GNUNET_TIME_Relative rel)
	Convert a relative time to the corresponding rounding interval.
enum GNUNET_GenericReturnValue	GNUNET_TIME_string_to_round_interval (const char *ri_str, enum GNUNET_TIME_RounderInterval *ri)
	Convert rounding interval given as a string to the enum value.
const char *	GNUNET_TIME_round_interval2s (enum GNUNET_TIME_RounderInterval ri)
	Convert rounding interval to string.
struct GNUNET_TIME_Absolute	GNUNET_TIME_round_up (struct GNUNET_TIME_Absolute at, enum GNUNET_TIME_RounderInterval ri)
	Round up the given at to the interval ri.
struct GNUNET_TIME_Absolute	GNUNET_TIME_round_down (struct GNUNET_TIME_Absolute at, enum GNUNET_TIME_RounderInterval ri)
	Round @at down to the start of the next interval ri.
const char *	GNUNET_TIME_timestamp2s (struct GNUNET_TIME_Timestamp ts)
	Convert ts to human-readable timestamp.
const char *	GNUNET_TIME_absolute2s (struct GNUNET_TIME_Absolute ts)
	Like asctime, except for GNUnet time.
const char *	GNUNET_TIME_relative2s (struct GNUNET_TIME_Relative delta, bool do_round)
	Give relative time in human-readable fancy format.
struct GNUNET_TIME_Relative	GNUNET_TIME_randomized_backoff (struct GNUNET_TIME_Relative rt, struct GNUNET_TIME_Relative threshold)
	Randomized exponential back-off, starting at 1 ms and going up by a factor of 2+r, where 0 <= r <= 0.5, up to a maximum of the given threshold.
struct GNUNET_TIME_Relative	GNUNET_TIME_randomize (struct GNUNET_TIME_Relative r)
	Return a random time value between 0.5*r and 1.5*r.
struct GNUNET_TIME_Relative	GNUNET_TIME_relative_get_zero_ (void)
	Return relative time of 0ms.
struct GNUNET_TIME_Absolute	GNUNET_TIME_absolute_get_zero_ (void)
	Return absolute time of 0ms.
struct GNUNET_TIME_Relative	GNUNET_TIME_relative_get_unit_ (void)
	Return relative time of 1 microsecond.
struct GNUNET_TIME_Relative	GNUNET_TIME_relative_get_millisecond_ (void)
	Return relative time of 1ms.
struct GNUNET_TIME_Relative	GNUNET_TIME_relative_get_second_ (void)
	Return relative time of 1s.
struct GNUNET_TIME_Relative	GNUNET_TIME_relative_get_minute_ (void)
	Return relative time of 1 minute.
struct GNUNET_TIME_Relative	GNUNET_TIME_relative_get_hour_ (void)
	Return relative time of 1 hour.
struct GNUNET_TIME_Relative	GNUNET_TIME_relative_get_forever_ (void)
	Return "forever".
struct GNUNET_TIME_Absolute	GNUNET_TIME_absolute_get_forever_ (void)
	Return "forever".
struct GNUNET_TIME_Absolute	GNUNET_TIME_absolute_get (void)
	Get the current time.
struct GNUNET_TIME_Absolute	GNUNET_TIME_relative_to_absolute (struct GNUNET_TIME_Relative rel)
	Convert relative time to an absolute time in the future.
struct GNUNET_TIME_Timestamp	GNUNET_TIME_relative_to_timestamp (struct GNUNET_TIME_Relative rel)
	Convert relative time to a timestamp in the future.
struct GNUNET_TIME_Timestamp	GNUNET_TIME_absolute_to_timestamp (struct GNUNET_TIME_Absolute at)
	Round an absolute time to a timestamp.
struct GNUNET_TIME_Timestamp	GNUNET_TIME_timestamp_get (void)
	Get timestamp representing the current time.
struct GNUNET_TIME_Relative	GNUNET_TIME_relative_min (struct GNUNET_TIME_Relative t1, struct GNUNET_TIME_Relative t2)
	Return the minimum of two relative time values.
struct GNUNET_TIME_Relative	GNUNET_TIME_relative_max (struct GNUNET_TIME_Relative t1, struct GNUNET_TIME_Relative t2)
	Return the maximum of two relative time values.
struct GNUNET_TIME_Absolute	GNUNET_TIME_absolute_min (struct GNUNET_TIME_Absolute t1, struct GNUNET_TIME_Absolute t2)
	Return the minimum of two absolute time values.
struct GNUNET_TIME_Absolute	GNUNET_TIME_absolute_max (struct GNUNET_TIME_Absolute t1, struct GNUNET_TIME_Absolute t2)
	Return the maximum of two absolute time values.
struct GNUNET_TIME_Absolute	GNUNET_TIME_absolute_round_down (struct GNUNET_TIME_Absolute at, struct GNUNET_TIME_Relative rt)
	Round down absolute time at to multiple of rt.
struct GNUNET_TIME_Timestamp	GNUNET_TIME_timestamp_max (struct GNUNET_TIME_Timestamp t1, struct GNUNET_TIME_Timestamp t2)
	Return the maximum of two timestamps.
struct GNUNET_TIME_Timestamp	GNUNET_TIME_timestamp_min (struct GNUNET_TIME_Timestamp t1, struct GNUNET_TIME_Timestamp t2)
	Return the minimum of two timestamps.
struct GNUNET_TIME_Relative	GNUNET_TIME_absolute_get_remaining (struct GNUNET_TIME_Absolute future)
	Given a timestamp in the future, how much time remains until then?
bool	GNUNET_TIME_absolute_approx_eq (struct GNUNET_TIME_Absolute a1, struct GNUNET_TIME_Absolute a2, struct GNUNET_TIME_Relative t)
	Test if a1 and a2 are equal within a margin of error of t.
struct GNUNET_TIME_Relative	GNUNET_TIME_calculate_eta (struct GNUNET_TIME_Absolute start, uint64_t finished, uint64_t total)
	Calculate the estimate time of arrival/completion for an operation.
struct GNUNET_TIME_Relative	GNUNET_TIME_absolute_get_difference (struct GNUNET_TIME_Absolute start, struct GNUNET_TIME_Absolute end)
	Compute the time difference between the given start and end times.
struct GNUNET_TIME_Relative	GNUNET_TIME_absolute_get_duration (struct GNUNET_TIME_Absolute whence)
	Get the duration of an operation as the difference of the current time and the given start time "hence".
struct GNUNET_TIME_Absolute	GNUNET_TIME_absolute_add (struct GNUNET_TIME_Absolute start, struct GNUNET_TIME_Relative duration)
	Add a given relative duration to the given start time.
struct GNUNET_TIME_Absolute	GNUNET_TIME_absolute_subtract (struct GNUNET_TIME_Absolute start, struct GNUNET_TIME_Relative duration)
	Subtract a given relative duration from the given start time.
struct GNUNET_TIME_Relative	GNUNET_TIME_relative_multiply_double (struct GNUNET_TIME_Relative rel, double factor)
	Multiply relative time by a given factor.
struct GNUNET_TIME_Relative	GNUNET_TIME_relative_multiply (struct GNUNET_TIME_Relative rel, unsigned long long factor)
	Multiply relative time by a given factor.
struct GNUNET_TIME_Relative	GNUNET_TIME_relative_saturating_multiply (struct GNUNET_TIME_Relative rel, unsigned long long factor)
	Saturating multiply relative time by a given factor.
struct GNUNET_TIME_Relative	GNUNET_TIME_relative_divide (struct GNUNET_TIME_Relative rel, unsigned long long factor)
	Divide relative time by a given factor.
struct GNUNET_TIME_Relative	GNUNET_TIME_relative_add (struct GNUNET_TIME_Relative a1, struct GNUNET_TIME_Relative a2)
	Add relative times together.
struct GNUNET_TIME_Relative	GNUNET_TIME_relative_subtract (struct GNUNET_TIME_Relative a1, struct GNUNET_TIME_Relative a2)
	Subtract relative timestamp from the other.
struct GNUNET_TIME_RelativeNBO	GNUNET_TIME_relative_hton (struct GNUNET_TIME_Relative a)
	Convert relative time to network byte order.
struct GNUNET_TIME_Relative	GNUNET_TIME_relative_ntoh (struct GNUNET_TIME_RelativeNBO a)
	Convert relative time from network byte order.
struct GNUNET_TIME_AbsoluteNBO	GNUNET_TIME_absolute_hton (struct GNUNET_TIME_Absolute a)
	Convert absolute time to network byte order.
struct GNUNET_TIME_TimestampNBO	GNUNET_TIME_timestamp_hton (struct GNUNET_TIME_Timestamp t)
	Convert timestamp to network byte order.
struct GNUNET_TIME_Absolute	GNUNET_TIME_absolute_from_ms (uint64_t ms_after_epoch)
	Convert milliseconds after the UNIX epoch to absolute time.
bool	GNUNET_TIME_absolute_is_never (struct GNUNET_TIME_Absolute abs)
	Test if abs is never.
bool	GNUNET_TIME_absolute_is_past (struct GNUNET_TIME_Absolute abs)
	Test if abs is truly in the past (excluding now).
bool	GNUNET_TIME_absolute_is_zero (struct GNUNET_TIME_Absolute abs)
	Test if abs is truly zero.
bool	GNUNET_TIME_absolute_is_future (struct GNUNET_TIME_Absolute abs)
	Test if abs is truly in the future (excluding now).
bool	GNUNET_TIME_relative_is_forever (struct GNUNET_TIME_Relative rel)
	Test if rel is forever.
bool	GNUNET_TIME_relative_is_zero (struct GNUNET_TIME_Relative rel)
	Test if rel is zero.
struct GNUNET_TIME_Absolute	GNUNET_TIME_absolute_from_s (uint64_t s_after_epoch)
	Convert seconds after the UNIX epoch to absolute time.
struct GNUNET_TIME_Timestamp	GNUNET_TIME_timestamp_from_s (uint64_t s_after_epoch)
	Convert seconds after the UNIX epoch to timestamp.
uint64_t	GNUNET_TIME_timestamp_to_s (struct GNUNET_TIME_Timestamp ts)
	Convert timestamp to number of seconds after the UNIX epoch.
struct GNUNET_TIME_Absolute	GNUNET_TIME_absolute_ntoh (struct GNUNET_TIME_AbsoluteNBO a)
	Convert absolute time from network byte order.
struct GNUNET_TIME_Timestamp	GNUNET_TIME_timestamp_ntoh (struct GNUNET_TIME_TimestampNBO tn)
	Convert timestamp from network byte order.
void	GNUNET_TIME_set_offset (long long offset)
	Set the timestamp offset for this instance.
long long	GNUNET_TIME_get_offset (void)
	Get the timestamp offset for this instance.
unsigned int	GNUNET_TIME_get_current_year (void)
	Return the current year (e.g.
struct GNUNET_TIME_Absolute	GNUNET_TIME_year_to_time (unsigned int year)
	Convert a year to an expiration time of January 1st of that year.
unsigned int	GNUNET_TIME_time_to_year (struct GNUNET_TIME_Absolute at)
	Convert an expiration time to the respective year (rounds)
struct GNUNET_TIME_Absolute	GNUNET_TIME_absolute_get_monotonic (const struct GNUNET_CONFIGURATION_Handle *cfg)
	Obtain the current time and make sure it is monotonically increasing.

Detailed Description

Time and time calculations.

Macro Definition Documentation

GNUNET_TIME_UNIT_ZERO

#define GNUNET_TIME_UNIT_ZERO   ((struct GNUNET_TIME_Relative){0})

Relative time zero.

Definition at line 131 of file gnunet_time_lib.h.

GNUNET_TIME_UNIT_ZERO_ABS

#define GNUNET_TIME_UNIT_ZERO_ABS   ((struct GNUNET_TIME_Absolute){0})

Absolute time zero.

Definition at line 136 of file gnunet_time_lib.h.

GNUNET_TIME_UNIT_ZERO_TS

#define GNUNET_TIME_UNIT_ZERO_TS   ((struct GNUNET_TIME_Timestamp){{0}})

Timestamp of zero.

Definition at line 141 of file gnunet_time_lib.h.

GNUNET_TIME_UNIT_MICROSECONDS

#define GNUNET_TIME_UNIT_MICROSECONDS   GNUNET_TIME_relative_get_unit_ ()

One microsecond, our basic time unit.

Definition at line 146 of file gnunet_time_lib.h.

GNUNET_TIME_UNIT_MILLISECONDS

#define GNUNET_TIME_UNIT_MILLISECONDS   GNUNET_TIME_relative_get_millisecond_ ()

One millisecond.

Definition at line 151 of file gnunet_time_lib.h.

GNUNET_TIME_UNIT_SECONDS

#define GNUNET_TIME_UNIT_SECONDS   GNUNET_TIME_relative_get_second_ ()

One second.

Definition at line 156 of file gnunet_time_lib.h.

GNUNET_TIME_UNIT_MINUTES

#define GNUNET_TIME_UNIT_MINUTES   GNUNET_TIME_relative_get_minute_ ()

One minute.

Definition at line 161 of file gnunet_time_lib.h.

GNUNET_TIME_UNIT_HOURS

#define GNUNET_TIME_UNIT_HOURS   GNUNET_TIME_relative_get_hour_ ()

One hour.

Definition at line 166 of file gnunet_time_lib.h.

GNUNET_TIME_UNIT_DAYS

#define GNUNET_TIME_UNIT_DAYS

Value:

          GNUNET_TIME_relative_multiply ( \
          GNUNET_TIME_UNIT_HOURS, 24)

One day.

Definition at line 171 of file gnunet_time_lib.h.

                                      {UINT64_MAX})
 
#define GNUNET_TIME_UNIT_FOREVER_ABS \
        ((struct GNUNET_TIME_Absolute){UINT64_MAX})
#define GNUNET_TIME_UNIT_NEVER_ABS \
        ((struct GNUNET_TIME_Absolute){UINT64_MAX})
 
#define GNUNET_TIME_UNIT_FOREVER_TS \
        ((struct GNUNET_TIME_Timestamp){{UINT64_MAX}})
 
 
#define GNUNET_TIME_STD_EXPONENTIAL_BACKOFF_THRESHOLD \
        GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_MINUTES, 15)
 
 
#define GNUNET_TIME_STD_BACKOFF(r) GNUNET_TIME_relative_min ( \
          GNUNET_TIME_STD_EXPONENTIAL_BACKOFF_THRESHOLD, \
          GNUNET_TIME_relative_multiply ( \
            GNUNET_TIME_relative_max (GNUNET_TIME_UNIT_MILLISECONDS, (r)), 2))
 
 
enum GNUNET_TIME_RounderInterval
{
  GNUNET_TIME_RI_NONE = 0,
 
  GNUNET_TIME_RI_SECOND,
 
  GNUNET_TIME_RI_MINUTE,
 
  GNUNET_TIME_RI_HOUR,
 
  GNUNET_TIME_RI_DAY,
 
  GNUNET_TIME_RI_WEEK,
 
  GNUNET_TIME_RI_MONTH,
 
  GNUNET_TIME_RI_QUARTER,
 
  GNUNET_TIME_RI_YEAR
};
 
 
enum GNUNET_TIME_RounderInterval
GNUNET_TIME_relative_to_round_interval (struct GNUNET_TIME_Relative rel);
 
 
enum GNUNET_GenericReturnValue
GNUNET_TIME_string_to_round_interval (const char *ri_str,
                                      enum GNUNET_TIME_RounderInterval *ri);
 
 
const char *
GNUNET_TIME_round_interval2s (enum GNUNET_TIME_RounderInterval ri);
 
 
struct GNUNET_TIME_Absolute
GNUNET_TIME_round_up (struct GNUNET_TIME_Absolute at,
                      enum GNUNET_TIME_RounderInterval ri);
 
 
struct GNUNET_TIME_Absolute
GNUNET_TIME_round_down (struct GNUNET_TIME_Absolute at,
                        enum GNUNET_TIME_RounderInterval ri);
 
 
const char *
GNUNET_TIME_timestamp2s (struct GNUNET_TIME_Timestamp ts);
 
 
const char *
GNUNET_TIME_absolute2s (struct GNUNET_TIME_Absolute ts);
 
 
const char *
GNUNET_TIME_relative2s (struct GNUNET_TIME_Relative delta,
                        bool do_round);
 
 
struct GNUNET_TIME_Relative
GNUNET_TIME_randomized_backoff (struct GNUNET_TIME_Relative rt,
                                struct GNUNET_TIME_Relative threshold);
 
 
struct GNUNET_TIME_Relative
GNUNET_TIME_randomize (struct GNUNET_TIME_Relative r);
 
 
struct GNUNET_TIME_Relative
GNUNET_TIME_relative_get_zero_ (void);
 
 
struct GNUNET_TIME_Absolute
GNUNET_TIME_absolute_get_zero_ (void);
 
 
struct GNUNET_TIME_Relative
GNUNET_TIME_relative_get_unit_ (void);
 
 
struct GNUNET_TIME_Relative
GNUNET_TIME_relative_get_millisecond_ (void);
 
 
struct GNUNET_TIME_Relative
GNUNET_TIME_relative_get_second_ (void);
 
 
struct GNUNET_TIME_Relative
GNUNET_TIME_relative_get_minute_ (void);
 
 
struct GNUNET_TIME_Relative
GNUNET_TIME_relative_get_hour_ (void);
 
 
struct GNUNET_TIME_Relative
GNUNET_TIME_relative_get_forever_ (void);
 
 
struct GNUNET_TIME_Absolute
GNUNET_TIME_absolute_get_forever_ (void);
 
 
struct GNUNET_TIME_Absolute
GNUNET_TIME_absolute_get (void);
 
 
struct GNUNET_TIME_Absolute
GNUNET_TIME_relative_to_absolute (struct GNUNET_TIME_Relative rel);
 
 
struct GNUNET_TIME_Timestamp
GNUNET_TIME_relative_to_timestamp (struct GNUNET_TIME_Relative rel);
 
 
struct GNUNET_TIME_Timestamp
GNUNET_TIME_absolute_to_timestamp (struct GNUNET_TIME_Absolute at);
 
 
struct GNUNET_TIME_Timestamp
GNUNET_TIME_timestamp_get (void);
 
 
#define GNUNET_TIME_absolute_cmp(t1,op,t2) \
        ((void) (1 op 2), (t1).abs_value_us op (t2).abs_value_us)
 
 
#define GNUNET_TIME_timestamp_cmp(t1,op,t2) \
        GNUNET_TIME_absolute_cmp ((t1).abs_time,op,(t2).abs_time)
 
 
#define GNUNET_TIME_relative_cmp(t1,op,t2) \
        ((void) (1 op 2), (t1).rel_value_us op (t2).rel_value_us)
 
 
struct GNUNET_TIME_Relative
GNUNET_TIME_relative_min (struct GNUNET_TIME_Relative t1,
                          struct GNUNET_TIME_Relative t2);
 
 
struct GNUNET_TIME_Relative
GNUNET_TIME_relative_max (struct GNUNET_TIME_Relative t1,
                          struct GNUNET_TIME_Relative t2);
 
 
struct GNUNET_TIME_Absolute
GNUNET_TIME_absolute_min (struct GNUNET_TIME_Absolute t1,
                          struct GNUNET_TIME_Absolute t2);
 
 
struct GNUNET_TIME_Absolute
GNUNET_TIME_absolute_max (struct GNUNET_TIME_Absolute t1,
                          struct GNUNET_TIME_Absolute t2);
 
 
struct GNUNET_TIME_Absolute
GNUNET_TIME_absolute_round_down (struct GNUNET_TIME_Absolute at,
                                 struct GNUNET_TIME_Relative rt);
 
 
struct GNUNET_TIME_Timestamp
GNUNET_TIME_timestamp_max (struct GNUNET_TIME_Timestamp t1,
                           struct GNUNET_TIME_Timestamp t2);
 
 
struct GNUNET_TIME_Timestamp
GNUNET_TIME_timestamp_min (struct GNUNET_TIME_Timestamp t1,
                           struct GNUNET_TIME_Timestamp t2);
 
 
struct GNUNET_TIME_Relative
GNUNET_TIME_absolute_get_remaining (struct GNUNET_TIME_Absolute future);
 
 
bool
GNUNET_TIME_absolute_approx_eq (struct GNUNET_TIME_Absolute a1,
                                struct GNUNET_TIME_Absolute a2,
                                struct GNUNET_TIME_Relative t);
 
 
struct GNUNET_TIME_Relative
GNUNET_TIME_calculate_eta (struct GNUNET_TIME_Absolute start,
                           uint64_t finished,
                           uint64_t total);
 
 
struct GNUNET_TIME_Relative
GNUNET_TIME_absolute_get_difference (struct GNUNET_TIME_Absolute start,
                                     struct GNUNET_TIME_Absolute end);
 
 
struct GNUNET_TIME_Relative
GNUNET_TIME_absolute_get_duration (struct GNUNET_TIME_Absolute whence);
 
 
struct GNUNET_TIME_Absolute
GNUNET_TIME_absolute_add (struct GNUNET_TIME_Absolute start,
                          struct GNUNET_TIME_Relative duration);
 
 
struct GNUNET_TIME_Absolute
GNUNET_TIME_absolute_subtract (struct GNUNET_TIME_Absolute start,
                               struct GNUNET_TIME_Relative duration);
 
 
struct GNUNET_TIME_Relative
GNUNET_TIME_relative_multiply_double (struct GNUNET_TIME_Relative rel,
                                      double factor);
 
struct GNUNET_TIME_Relative
GNUNET_TIME_relative_multiply (struct GNUNET_TIME_Relative rel,
                               unsigned long long factor);
 
 
struct GNUNET_TIME_Relative
GNUNET_TIME_relative_saturating_multiply (struct GNUNET_TIME_Relative rel,
                                          unsigned long long factor);
 
 
struct GNUNET_TIME_Relative
GNUNET_TIME_relative_divide (struct GNUNET_TIME_Relative rel,
                             unsigned long long factor);
 
 
struct GNUNET_TIME_Relative
GNUNET_TIME_relative_add (struct GNUNET_TIME_Relative a1,
                          struct GNUNET_TIME_Relative a2);
 
 
struct GNUNET_TIME_Relative
GNUNET_TIME_relative_subtract (struct GNUNET_TIME_Relative a1,
                               struct GNUNET_TIME_Relative a2);
 
 
struct GNUNET_TIME_RelativeNBO
GNUNET_TIME_relative_hton (struct GNUNET_TIME_Relative a);
 
 
struct GNUNET_TIME_Relative
GNUNET_TIME_relative_ntoh (struct GNUNET_TIME_RelativeNBO a);
 
 
struct GNUNET_TIME_AbsoluteNBO
GNUNET_TIME_absolute_hton (struct GNUNET_TIME_Absolute a);
 
 
struct GNUNET_TIME_TimestampNBO
GNUNET_TIME_timestamp_hton (struct GNUNET_TIME_Timestamp t);
 
 
struct GNUNET_TIME_Absolute
GNUNET_TIME_absolute_from_ms (uint64_t ms_after_epoch);
 
 
bool
GNUNET_TIME_absolute_is_never (struct GNUNET_TIME_Absolute abs);
 
 
bool
GNUNET_TIME_absolute_is_past (struct GNUNET_TIME_Absolute abs);
 
 
bool
GNUNET_TIME_absolute_is_zero (struct GNUNET_TIME_Absolute abs);
 
 
bool
GNUNET_TIME_absolute_is_future (struct GNUNET_TIME_Absolute abs);
 
 
bool
GNUNET_TIME_relative_is_forever (struct GNUNET_TIME_Relative rel);
 
 
bool
GNUNET_TIME_relative_is_zero (struct GNUNET_TIME_Relative rel);
 
 
struct GNUNET_TIME_Absolute
GNUNET_TIME_absolute_from_s (uint64_t s_after_epoch);
 
 
struct GNUNET_TIME_Timestamp
GNUNET_TIME_timestamp_from_s (uint64_t s_after_epoch);
 
 
uint64_t
GNUNET_TIME_timestamp_to_s (struct GNUNET_TIME_Timestamp ts);
 
 
struct GNUNET_TIME_Absolute
GNUNET_TIME_absolute_ntoh (struct GNUNET_TIME_AbsoluteNBO a);
 
 
struct GNUNET_TIME_Timestamp
GNUNET_TIME_timestamp_ntoh (struct GNUNET_TIME_TimestampNBO tn);
 
 
void
GNUNET_TIME_set_offset (long long offset);
 
 
long long
GNUNET_TIME_get_offset (void);
 
 
unsigned int
GNUNET_TIME_get_current_year (void);
 
 
struct GNUNET_TIME_Absolute
GNUNET_TIME_year_to_time (unsigned int year);
 
 
unsigned int
GNUNET_TIME_time_to_year (struct GNUNET_TIME_Absolute at);
 
 
struct GNUNET_CONFIGURATION_Handle;
 
 
struct GNUNET_TIME_Absolute
GNUNET_TIME_absolute_get_monotonic (
  const struct GNUNET_CONFIGURATION_Handle *cfg);
 
 
#if 0                           /* keep Emacsens' auto-indent happy */
{
#endif
#ifdef __cplusplus
}
#endif
 
/* ifndef GNUNET_TIME_LIB_H */
#endif
 
 
 
/* end of gnunet_time_lib.h */

GNUNET_TIME_UNIT_WEEKS

#define GNUNET_TIME_UNIT_WEEKS

Value:

          GNUNET_TIME_relative_multiply ( \
          GNUNET_TIME_UNIT_DAYS, 7)

One week.

Definition at line 177 of file gnunet_time_lib.h.

GNUNET_TIME_UNIT_MONTHS

#define GNUNET_TIME_UNIT_MONTHS

Value:

          GNUNET_TIME_relative_multiply ( \
          GNUNET_TIME_UNIT_DAYS, 30)

One month (30 days).

Definition at line 183 of file gnunet_time_lib.h.

GNUNET_TIME_UNIT_YEARS

#define GNUNET_TIME_UNIT_YEARS

Value:

          GNUNET_TIME_relative_multiply ( \
          GNUNET_TIME_UNIT_DAYS, 365)

One year (365 days).

Definition at line 189 of file gnunet_time_lib.h.

GNUNET_TIME_UNIT_FOREVER_REL

#define GNUNET_TIME_UNIT_FOREVER_REL    ((struct GNUNET_TIME_Relative){UINT64_MAX})

Constant used to specify "forever".

This constant will be treated specially in all time operations.

Definition at line 196 of file gnunet_time_lib.h.

                                      {UINT64_MAX})

GNUNET_TIME_UNIT_FOREVER_ABS

#define GNUNET_TIME_UNIT_FOREVER_ABS    ((struct GNUNET_TIME_Absolute){UINT64_MAX})

Constant used to specify "forever".

This constant will be treated specially in all time operations.

Definition at line 203 of file gnunet_time_lib.h.

                                      {UINT64_MAX})

GNUNET_TIME_UNIT_NEVER_ABS

#define GNUNET_TIME_UNIT_NEVER_ABS    ((struct GNUNET_TIME_Absolute){UINT64_MAX})

Definition at line 205 of file gnunet_time_lib.h.

                                      {UINT64_MAX})

GNUNET_TIME_UNIT_FOREVER_TS

#define GNUNET_TIME_UNIT_FOREVER_TS    ((struct GNUNET_TIME_Timestamp){{UINT64_MAX}})

Constant used to specify "forever".

This constant will be treated specially in all time operations.

Definition at line 212 of file gnunet_time_lib.h.

                                       {{UINT64_MAX}})

GNUNET_TIME_STD_EXPONENTIAL_BACKOFF_THRESHOLD

#define GNUNET_TIME_STD_EXPONENTIAL_BACKOFF_THRESHOLD    GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_MINUTES, 15)

Threshold after which exponential backoff should not increase (15 m).

Definition at line 219 of file gnunet_time_lib.h.

GNUNET_TIME_STD_BACKOFF

#define GNUNET_TIME_STD_BACKOFF

(

r

)

Value:

          GNUNET_TIME_relative_min ( \
          GNUNET_TIME_STD_EXPONENTIAL_BACKOFF_THRESHOLD, \
          GNUNET_TIME_relative_multiply ( \
            GNUNET_TIME_relative_max (GNUNET_TIME_UNIT_MILLISECONDS, (r)), 2))

Perform our standard exponential back-off calculation, starting at 1 ms and then going by a factor of 2 up unto a maximum of 15 m.

Parameters

r	current backoff time, initially zero

Definition at line 229 of file gnunet_time_lib.h.

GNUNET_TIME_absolute_cmp

#define GNUNET_TIME_absolute_cmp	(		t1,
			op,
			t2
	)		((void) (1 op 2), (t1).abs_value_us op (t2).abs_value_us)

Compare two absolute times.

Parameters

t1	first time
op	compare operator
t2	second time

Returns

true if t1 op t2

Definition at line 534 of file gnunet_time_lib.h.

GNUNET_TIME_timestamp_cmp

#define GNUNET_TIME_timestamp_cmp	(		t1,
			op,
			t2
	)		GNUNET_TIME_absolute_cmp ((t1).abs_time,op,(t2).abs_time)

Compare two timestamps.

Parameters

t1	first timestamp
op	compare operator
t2	second timestamp

Returns

true if t1 op t2

Definition at line 546 of file gnunet_time_lib.h.

GNUNET_TIME_relative_cmp

#define GNUNET_TIME_relative_cmp	(		t1,
			op,
			t2
	)		((void) (1 op 2), (t1).rel_value_us op (t2).rel_value_us)

Compare two relative times.

Parameters

t1	first time
op	compare operator
t2	second time

Returns

true if t1 op t2

Definition at line 558 of file gnunet_time_lib.h.

Enumeration Type Documentation

GNUNET_TIME_RounderInterval

enum GNUNET_TIME_RounderInterval

Quantities by which we support round up absolute time values.

Enumerator
GNUNET_TIME_RI_NONE	No rounding up.
GNUNET_TIME_RI_SECOND	Round up to a multiple of seconds.
GNUNET_TIME_RI_MINUTE	Round up to the next minute.
GNUNET_TIME_RI_HOUR	Round up to the next hour.
GNUNET_TIME_RI_DAY	Round up to the next day.
GNUNET_TIME_RI_WEEK	Round up to the next calendar week.
GNUNET_TIME_RI_MONTH	Round up to the next month.
GNUNET_TIME_RI_QUARTER	Round up to the next quarter.
GNUNET_TIME_RI_YEAR	Round up to the next year.

Definition at line 238 of file gnunet_time_lib.h.

{
  GNUNET_TIME_RI_NONE = 0,
 
  GNUNET_TIME_RI_SECOND,
 
  GNUNET_TIME_RI_MINUTE,
 
  GNUNET_TIME_RI_HOUR,
 
  GNUNET_TIME_RI_DAY,
 
  GNUNET_TIME_RI_WEEK,
 
  GNUNET_TIME_RI_MONTH,
 
  GNUNET_TIME_RI_QUARTER,
 
  GNUNET_TIME_RI_YEAR
};

Function Documentation

GNUNET_STRINGS_fancy_time_to_absolute()

enum GNUNET_GenericReturnValue GNUNET_STRINGS_fancy_time_to_absolute	(	const char *	fancy_time,
		struct GNUNET_TIME_Absolute *	atime
	)

Convert a given fancy human-readable time to our internal representation.

The human-readable time is expected to be in local time, whereas the returned value will be in UTC.

Parameters

fancy_time	human readable string (e.g. Y-m-d H:M:S)
atime	set to the absolute time

Returns

GNUNET_OK on success, GNUNET_SYSERR on error

Definition at line 303 of file strings.c.

{
  struct tm tv;
  time_t t;
  const char *eos;
  unsigned long long l;
  char dummy;
 
  if (0 == strcasecmp ("end of time",
                       fancy_time))
  {
    *atime = GNUNET_TIME_UNIT_FOREVER_ABS;
    return GNUNET_OK;
  }
  if ( (1 == sscanf (fancy_time,
                     "%llu%c",
                     &l,
                     &dummy)) &&
       (l > 9999) )
  {
    /* Time given in seconds after epoch, and not a year */
    atime->abs_value_us = (uint64_t) ((uint64_t) l * 1000LL * 1000LL);
    return GNUNET_OK;
  }
  eos = &fancy_time[strlen (fancy_time)];
  memset (&tv, 0, sizeof(tv));
  if ((eos != strptime (fancy_time, "%a %b %d %H:%M:%S %Y", &tv)) &&
      (eos != strptime (fancy_time, "%c", &tv)) &&
      (eos != strptime (fancy_time, "%Ec", &tv)) &&
      (eos != strptime (fancy_time, "%Y-%m-%d %H:%M:%S", &tv)) &&
      (eos != strptime (fancy_time, "%Y-%m-%d %H:%M", &tv)) &&
      (eos != strptime (fancy_time, "%x", &tv)) &&
      (eos != strptime (fancy_time, "%Ex", &tv)) &&
      (eos != strptime (fancy_time, "%Y-%m-%d", &tv)) &&
      (eos != strptime (fancy_time, "%Y-%m", &tv)) &&
      (eos != strptime (fancy_time, "%Y", &tv)))
    return GNUNET_SYSERR;
  t = mktime (&tv);
  atime->abs_value_us = (uint64_t) ((uint64_t) t * 1000LL * 1000LL);
  return GNUNET_OK;
}

References GNUNET_TIME_Absolute::abs_value_us, dummy, GNUNET_OK, GNUNET_SYSERR, GNUNET_TIME_UNIT_FOREVER_ABS, and t.

Referenced by GNUNET_STRINGS_fancy_time_to_timestamp(), parse_expiration(), parse_expiration(), set_absolute_time(), set_timestamp(), and sign_cb().

Here is the caller graph for this function:

GNUNET_STRINGS_fancy_time_to_timestamp()

enum GNUNET_GenericReturnValue GNUNET_STRINGS_fancy_time_to_timestamp	(	const char *	fancy_time,
		struct GNUNET_TIME_Timestamp *	atime
	)

Convert a given fancy human-readable time to our internal representation.

The human-readable time is expected to be in local time, whereas the returned value will be in UTC.

Parameters

fancy_time	human readable string (e.g. Y-m-d H:M:S)
atime	set to the absolute time

Returns

GNUNET_OK on success, GNUNET_SYSERR on error

Definition at line 348 of file strings.c.

{
  enum GNUNET_GenericReturnValue ret;
 
  if (GNUNET_OK !=
      (ret = GNUNET_STRINGS_fancy_time_to_absolute (fancy_time,
                                                    &atime->abs_time)))
  {
    return ret;
  }
  if (GNUNET_TIME_absolute_is_never (atime->abs_time))
  {
    atime->abs_time = GNUNET_TIME_UNIT_FOREVER_TS.abs_time;
  }
  return GNUNET_OK;
}

References GNUNET_TIME_Timestamp::abs_time, GNUNET_OK, GNUNET_STRINGS_fancy_time_to_absolute(), GNUNET_TIME_absolute_is_never(), GNUNET_TIME_UNIT_FOREVER_TS, and ret.

Here is the call graph for this function:

GNUNET_STRINGS_timestamp_to_string()

const char * GNUNET_STRINGS_timestamp_to_string

(

struct GNUNET_TIME_Timestamp

t

)

Like asctime, except for GNUnet time.

Converts a GNUnet internal absolute time (which is in UTC) to a string in local time. Note that the returned value will be overwritten if this function is called again.

Parameters

t	the timestamp to convert

Returns

timestamp in human-readable form in local time

Definition at line 646 of file strings.c.

{
  struct GNUNET_TIME_Absolute av;
 
  if (t.abs_time.abs_value_us == GNUNET_TIME_UNIT_FOREVER_TS.abs_time.
      abs_value_us)
    return GNUNET_STRINGS_absolute_time_to_string (GNUNET_TIME_UNIT_FOREVER_ABS)
    ;
  av.abs_value_us = t.abs_time.abs_value_us;
  return GNUNET_STRINGS_absolute_time_to_string (av);
}

References GNUNET_TIME_Absolute::abs_value_us, GNUNET_STRINGS_absolute_time_to_string(), GNUNET_TIME_UNIT_FOREVER_ABS, GNUNET_TIME_UNIT_FOREVER_TS, and t.

Here is the call graph for this function:

GNUNET_STRINGS_absolute_time_to_string()

const char * GNUNET_STRINGS_absolute_time_to_string

(

struct GNUNET_TIME_Absolute

t

)

Like asctime, except for GNUnet time.

Converts a GNUnet internal absolute time (which is in UTC) to a string in local time. Note that the returned value will be overwritten if this function is called again.

Parameters

t	the absolute time to convert

Returns

timestamp in human-readable form in local time

Definition at line 660 of file strings.c.

{
  static GNUNET_THREAD_LOCAL char buf[255];
  time_t tt;
  struct tm *tp;
 
  if (GNUNET_TIME_absolute_is_never (t))
    return "end of time";
  tt = t.abs_value_us / 1000LL / 1000LL;
  tp = localtime (&tt);
  /* This is hacky, but i don't know a way to detect libc character encoding.
   * Just expect utf8 from glibc these days.
   * As for msvcrt, use the wide variant, which always returns utf16
   * (otherwise we'd have to detect current codepage or use W32API character
   * set conversion routines to convert to UTF8).
   */
  strftime (buf, sizeof(buf), "%a %b %d %H:%M:%S %Y", tp);
 
  return buf;
}

References GNUNET_THREAD_LOCAL, GNUNET_TIME_absolute_is_never(), t, and tt.

Referenced by block_decrypt_ecdsa(), block_decrypt_eddsa(), dispatch_job(), display_record(), do_rekey(), do_rekey(), execute_get(), get_resp_callback(), get_transmit_delay(), GNUNET_FS_meta_data_add_publication_date(), GNUNET_GNSRECORD_record_get_expiration_time(), GNUNET_PEERSTORE_hello_add(), GNUNET_STRINGS_timestamp_to_string(), got_hello(), handle_dht_response(), handle_estimate(), handle_namecache_block_response(), handle_p2p_estimate(), handle_validation_response(), hello_add_iter(), hello_iter(), inject_rekey(), inject_rekey(), learn_dv_path(), monitor_cb(), monitor_notify_connect(), monitor_notify_disconnect(), namecache_sqlite_cache_block(), ns_lookup_result_cb(), parse_expiration(), parse_expiration(), print_info(), print_plugin_event_info(), printer(), printer_watch(), process_queue(), process_record(), put_callback(), select_loop(), sqlite_plugin_put(), store_pi(), timeout_cb(), transmit_item(), transmit_on_queue(), transmit_task_cb(), update_pm_next_attempt(), and warn_monitor_slow().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_STRINGS_relative_time_to_string()

const char * GNUNET_STRINGS_relative_time_to_string	(	struct GNUNET_TIME_Relative	delta,
		int	do_round
	)

Give relative time in human-readable fancy format.

This is one of the very few calls in the entire API that is NOT reentrant!

Parameters

delta	time in milli seconds
do_round	are we allowed to round a bit?

Returns

string in human-readable form

Definition at line 599 of file strings.c.

{
  static GNUNET_THREAD_LOCAL char buf[128];
  const char *unit = /* time unit */ "µs";
  uint64_t dval = delta.rel_value_us;
 
  if (GNUNET_TIME_UNIT_FOREVER_REL.rel_value_us == delta.rel_value_us)
    return "forever";
  if (0 == delta.rel_value_us)
    return "0 ms";
  if (((GNUNET_YES == do_round) && (dval > 5 * 1000)) || (0 == (dval % 1000)))
  {
    dval = dval / 1000;
    unit = /* time unit */ "ms";
    if (((GNUNET_YES == do_round) && (dval > 5 * 1000)) || (0 == (dval % 1000)))
    {
      dval = dval / 1000;
      unit = /* time unit */ "s";
      if (((GNUNET_YES == do_round) && (dval > 5 * 60)) || (0 == (dval % 60)))
      {
        dval = dval / 60;
        unit = /* time unit */ "m";
        if (((GNUNET_YES == do_round) && (dval > 5 * 60)) || (0 == (dval % 60)))
        {
          dval = dval / 60;
          unit = /* time unit */ "h";
          if (((GNUNET_YES == do_round) && (dval > 5 * 24)) ||
              (0 == (dval % 24)))
          {
            dval = dval / 24;
            if (1 == dval)
              unit = /* time unit */ "day";
            else
              unit = /* time unit */ "days";
          }
        }
      }
    }
  }
  GNUNET_snprintf (buf, sizeof(buf), "%llu %s",
                   (unsigned long long) dval, unit);
  return buf;
}

References delta, do_round(), GNUNET_snprintf(), GNUNET_THREAD_LOCAL, GNUNET_TIME_UNIT_FOREVER_REL, GNUNET_YES, and GNUNET_TIME_Relative::rel_value_us.

Referenced by channel_open_sent_cb(), connect_fail_continuation(), consider_sending_fc(), data_sent_cb(), delay_warning(), delayed_restart_task(), disconnect_and_schedule_reconnect(), disconnect_and_schedule_reconnect(), display_record(), do_disconnect(), do_shutdown(), do_shutdown(), do_speedup(), expired_processor(), find_proof(), flush_bulk(), get_delay_randomization(), get_transmit_delay(), GNUNET_BANDWIDTH_tracker_get_delay(), GNUNET_BANDWIDTH_value_get_available_until(), GNUNET_BANDWIDTH_value_get_delay_for(), GNUNET_DATASTORE_put(), GNUNET_HOSTLIST_client_start(), GNUNET_SCHEDULER_do_work(), GNUNET_SPEEDUP_start_(), GNUNET_TESTING_interpreter_next_(), GSC_CLIENTS_solicit_request(), GSF_block_peer_migration_(), handle_announce(), handle_client_join(), handle_client_send(), handle_data(), handle_dv_learn(), handle_p2p_migration_stop(), handle_p2p_put(), handle_test(), handler_advertisement(), list_callback(), maint_child_death(), manage_first_hop_mq(), monitor_cb(), odc_warn_delay_task(), parse_expiration(), parse_expiration(), plan(), print_plugin_event_info(), process_job_queue(), process_lookup_result(), process_stat(), process_stdin(), process_stdin(), progress_cb(), progress_cb(), progress_cb(), put_migration_continuation(), queue_read(), queue_read(), queue_timeout(), quota_processor(), read_send(), RECLAIM_TICKETS_init(), reconnect(), regex_found_handler(), reschedule_connect(), run(), run(), run(), run(), run(), run(), run(), schedule_peer_transmission(), search_timed_out(), shutdown_task(), sqlite_plugin_put(), sqlite_plugin_put(), start_dv_learn(), store_completed_cb(), task_check(), task_hostlist_saving(), test_master(), timeout_cb(), transmit_item(), transmit_on_queue(), try_reconnect(), try_transmission(), update_excess(), update_tracker(), update_velocity(), validation_start_cb(), warn_delay(), warn_delay_task(), warn_no_client_continue(), and zone_iteration_finished().

Here is the call graph for this function:

GNUNET_TIME_relative_to_round_interval()

enum GNUNET_TIME_RounderInterval GNUNET_TIME_relative_to_round_interval

(

struct GNUNET_TIME_Relative

rel

)

Convert a relative time to the corresponding rounding interval.

Parameters

rel	relative time to convert

Returns

rounding interval, GNUNET_TIME_RI_NONE if either rel is zero or if the input does not match exactly any of the supported rounding intervals

Definition at line 1205 of file time.c.

{
  if (GNUNET_TIME_relative_cmp (GNUNET_TIME_UNIT_YEARS,
                                ==,
                                rel))
    return GNUNET_TIME_RI_YEAR;
  if (GNUNET_TIME_relative_cmp (GNUNET_TIME_relative_multiply (
                                  GNUNET_TIME_UNIT_MONTHS,
                                  3),
                                ==,
                                rel))
    return GNUNET_TIME_RI_QUARTER;
  if (GNUNET_TIME_relative_cmp (GNUNET_TIME_UNIT_MONTHS,
                                ==,
                                rel))
    return GNUNET_TIME_RI_MONTH;
  if (GNUNET_TIME_relative_cmp (GNUNET_TIME_UNIT_WEEKS,
                                ==,
                                rel))
    return GNUNET_TIME_RI_WEEK;
  if (GNUNET_TIME_relative_cmp (GNUNET_TIME_UNIT_DAYS,
                                ==,
                                rel))
    return GNUNET_TIME_RI_DAY;
  if (GNUNET_TIME_relative_cmp (GNUNET_TIME_UNIT_HOURS,
                                ==,
                                rel))
    return GNUNET_TIME_RI_HOUR;
  if (GNUNET_TIME_relative_cmp (GNUNET_TIME_UNIT_MINUTES,
                                ==,
                                rel))
    return GNUNET_TIME_RI_MINUTE;
  if (GNUNET_TIME_relative_cmp (GNUNET_TIME_UNIT_SECONDS,
                                ==,
                                rel))
    return GNUNET_TIME_RI_SECOND;
  GNUNET_break (GNUNET_TIME_relative_is_zero (rel));
  return GNUNET_TIME_RI_NONE;
}

References GNUNET_break, GNUNET_TIME_relative_cmp, GNUNET_TIME_relative_is_zero(), GNUNET_TIME_relative_multiply(), GNUNET_TIME_RI_DAY, GNUNET_TIME_RI_HOUR, GNUNET_TIME_RI_MINUTE, GNUNET_TIME_RI_MONTH, GNUNET_TIME_RI_NONE, GNUNET_TIME_RI_QUARTER, GNUNET_TIME_RI_SECOND, GNUNET_TIME_RI_WEEK, GNUNET_TIME_RI_YEAR, GNUNET_TIME_UNIT_DAYS, GNUNET_TIME_UNIT_HOURS, GNUNET_TIME_UNIT_MINUTES, GNUNET_TIME_UNIT_MONTHS, GNUNET_TIME_UNIT_SECONDS, GNUNET_TIME_UNIT_WEEKS, and GNUNET_TIME_UNIT_YEARS.

Here is the call graph for this function:

GNUNET_TIME_string_to_round_interval()

enum GNUNET_GenericReturnValue GNUNET_TIME_string_to_round_interval	(	const char *	ri_str,
		enum GNUNET_TIME_RounderInterval *	ri
	)

Convert rounding interval given as a string to the enum value.

Parameters

	ri_str	rounding interval as string
[out]	ri	set to enum value

Returns

GNUNET_OK on success, GNUNET_SYSERR on failure

Definition at line 1268 of file time.c.

{
  if (NULL == ri_str)
  {
    GNUNET_break (0);
    return GNUNET_SYSERR;
  }
  for (unsigned int i = 0;
       NULL != ri_lookup_table[i].str;
       i++)
  {
    if (0 == strcasecmp (ri_str,
                         ri_lookup_table[i].str))
    {
      *ri = ri_lookup_table[i].ri;
      return GNUNET_OK;
    }
  }
  return GNUNET_SYSERR;
}

References GNUNET_break, GNUNET_OK, GNUNET_SYSERR, ri, ri_lookup_table, and str.

Referenced by parse_tri().

Here is the caller graph for this function:

GNUNET_TIME_round_interval2s()

const char * GNUNET_TIME_round_interval2s

(

enum GNUNET_TIME_RounderInterval

ri

)

Convert rounding interval to string.

Parameters

ri	the rounding interval

Returns

NULL on failure (invalid enum value)

Definition at line 1293 of file time.c.

{
  for (unsigned int i = 0;
       NULL != ri_lookup_table[i].str;
       i++)
  {
    if (ri == ri_lookup_table[i].ri)
      return ri_lookup_table[i].str;
  }
  GNUNET_break (0);
  return NULL;
}

References GNUNET_break, ri, and ri_lookup_table.

Referenced by GNUNET_JSON_pack_time_rounder_interval().

Here is the caller graph for this function:

GNUNET_TIME_round_up()

struct GNUNET_TIME_Absolute GNUNET_TIME_round_up	(	struct GNUNET_TIME_Absolute	at,
		enum GNUNET_TIME_RounderInterval	ri
	)

Round up the given at to the interval ri.

NEVER/FOREVER always remains NEVER/FOREVER.

Parameters

at	some absolute time to round
ri	how much to round up

Returns

rounded up value of at

Definition at line 983 of file time.c.

{
  struct GNUNET_TIME_Absolute result;
  time_t seconds;
  struct tm timeinfo;
 
  if (GNUNET_TIME_absolute_is_never (at))
    return at;
  if (GNUNET_TIME_RI_NONE == ri)
    return at;
  seconds = at.abs_value_us / 1000000;
  if (NULL == localtime_r (&seconds,
                           &timeinfo))
  {
    GNUNET_break (0);
    return at;
  }
  switch (ri)
  {
  case GNUNET_TIME_RI_NONE:
    /* eh, we did this above!? */
    GNUNET_break (0);
    return at;
  case GNUNET_TIME_RI_SECOND:
    if (0 != at.abs_value_us % 1000000)
      result.abs_value_us = (seconds + 1) * 1000000ULL;
    else
      result = at;
    return result;
  case GNUNET_TIME_RI_MINUTE:
    if ( (timeinfo.tm_sec > 0) ||
         (0 != at.abs_value_us % 1000000) )
    {
      timeinfo.tm_sec = 0;
      timeinfo.tm_min += 1;
    }
    break;
  case GNUNET_TIME_RI_HOUR:
    /* Round up to next hour */
    if ( (timeinfo.tm_min > 0) ||
         (timeinfo.tm_sec > 0) ||
         (0 != (at.abs_value_us % 1000000)) )
    {
      timeinfo.tm_sec = 0;
      timeinfo.tm_min = 0;
      timeinfo.tm_hour += 1;
    }
    break;
  case GNUNET_TIME_RI_DAY:
    if ( (timeinfo.tm_hour > 0) ||
         (timeinfo.tm_min > 0) ||
         (timeinfo.tm_sec > 0) ||
         (0 != at.abs_value_us % 1000000) )
    {
      timeinfo.tm_sec = 0;
      timeinfo.tm_min = 0;
      timeinfo.tm_hour = 0;
      timeinfo.tm_mday += 1;
    }
    break;
  case GNUNET_TIME_RI_WEEK:
    /* Round up to next Monday (ISO 8601 week starts on Monday) */
    {
      /* tm_way == 0 => Sunday */
      int days_until_monday = (8 - timeinfo.tm_wday) % 7;
 
      if ( (0 == days_until_monday) &&
           ( (timeinfo.tm_hour > 0) ||
             (timeinfo.tm_min > 0) ||
             (timeinfo.tm_sec > 0) ||
             (0 != at.abs_value_us % 1000000) ) )
        days_until_monday = 7;
      if (days_until_monday > 0)
      {
        timeinfo.tm_sec = 0;
        timeinfo.tm_min = 0;
        timeinfo.tm_hour = 0;
        timeinfo.tm_mday += days_until_monday;
      }
    }
    break;
  case GNUNET_TIME_RI_MONTH:
    if ( (timeinfo.tm_mday > 1) ||
         (timeinfo.tm_hour > 0) ||
         (timeinfo.tm_min > 0) ||
         (timeinfo.tm_sec > 0) ||
         (0 != (at.abs_value_us % 1000000)) )
    {
      timeinfo.tm_sec = 0;
      timeinfo.tm_min = 0;
      timeinfo.tm_hour = 0;
      timeinfo.tm_mday = 1;
      timeinfo.tm_mon += 1;
    }
    break;
  case GNUNET_TIME_RI_QUARTER:
    {
      int next_quarter_month = ((timeinfo.tm_mon / 3) + 1) * 3;
 
      if ( (next_quarter_month > timeinfo.tm_mon) ||
           (timeinfo.tm_mday > 1) ||
           (timeinfo.tm_hour > 0) ||
           (timeinfo.tm_min > 0) ||
           (timeinfo.tm_sec > 0) ||
           (0 != (at.abs_value_us % 1000000)) )
      {
        timeinfo.tm_sec = 0;
        timeinfo.tm_min = 0;
        timeinfo.tm_hour = 0;
        timeinfo.tm_mday = 1;
        timeinfo.tm_mon = next_quarter_month;
      }
    }
    break;
  case GNUNET_TIME_RI_YEAR:
    if ( (timeinfo.tm_mon > 0) ||
         (timeinfo.tm_mday > 1) ||
         (timeinfo.tm_hour > 0) ||
         (timeinfo.tm_min > 0) ||
         (timeinfo.tm_sec > 0) ||
         (0 != (at.abs_value_us % 1000000)) )
    {
      timeinfo.tm_sec = 0;
      timeinfo.tm_min = 0;
      timeinfo.tm_hour = 0;
      timeinfo.tm_mday = 1;
      timeinfo.tm_mon = 0;
      timeinfo.tm_year += 1;
    }
    break;
  }
  result.abs_value_us = ((uint64_t) mktime (&timeinfo)) * 1000000ULL;
  return result;
}

References GNUNET_TIME_Absolute::abs_value_us, GNUNET_break, GNUNET_TIME_absolute_is_never(), GNUNET_TIME_RI_DAY, GNUNET_TIME_RI_HOUR, GNUNET_TIME_RI_MINUTE, GNUNET_TIME_RI_MONTH, GNUNET_TIME_RI_NONE, GNUNET_TIME_RI_QUARTER, GNUNET_TIME_RI_SECOND, GNUNET_TIME_RI_WEEK, GNUNET_TIME_RI_YEAR, result, and ri.

Here is the call graph for this function:

GNUNET_TIME_round_down()

struct GNUNET_TIME_Absolute GNUNET_TIME_round_down	(	struct GNUNET_TIME_Absolute	at,
		enum GNUNET_TIME_RounderInterval	ri
	)

Round @at down to the start of the next interval ri.

NEVER/FOREVER always remains NEVER/FOREVER.

Parameters

at	some absolute time to round
ri	how much to round down

Returns

rounded up value of at

Definition at line 1121 of file time.c.

{
  struct GNUNET_TIME_Absolute result;
  time_t seconds;
  struct tm timeinfo;
 
  if (GNUNET_TIME_absolute_is_never (at))
    return at;
  if (GNUNET_TIME_RI_NONE == ri)
    return at;
  seconds = at.abs_value_us / 1000000;
  if (NULL == localtime_r (&seconds,
                           &timeinfo))
  {
    GNUNET_break (0);
    return at;
  }
  switch (ri)
  {
  case GNUNET_TIME_RI_NONE:
    /* eh, we did this above!? */
    GNUNET_break (0);
    return at;
  case GNUNET_TIME_RI_SECOND:
    result.abs_value_us = seconds * 1000000ULL;
    return result;
  case GNUNET_TIME_RI_MINUTE:
    timeinfo.tm_sec = 0;
    break;
  case GNUNET_TIME_RI_HOUR:
    timeinfo.tm_sec = 0;
    timeinfo.tm_min = 0;
    break;
  case GNUNET_TIME_RI_DAY:
    timeinfo.tm_sec = 0;
    timeinfo.tm_min = 0;
    timeinfo.tm_hour = 0;
    break;
  case GNUNET_TIME_RI_WEEK:
    /* Round down to Monday of current week (ISO 8601 week starts Monday) */
    {
      /* tm_way == 0 => Sunday */
      int days_since_monday = (0 == timeinfo.tm_wday)
        ? 6
        : (timeinfo.tm_wday - 1);
 
      timeinfo.tm_sec = 0;
      timeinfo.tm_min = 0;
      timeinfo.tm_hour = 0;
      timeinfo.tm_mday -= days_since_monday;
    }
    break;
  case GNUNET_TIME_RI_MONTH:
    timeinfo.tm_sec = 0;
    timeinfo.tm_min = 0;
    timeinfo.tm_hour = 0;
    timeinfo.tm_mday = 1;
    break;
  case GNUNET_TIME_RI_QUARTER:
    {
      int quarter_start_month = (timeinfo.tm_mon / 3) * 3;
 
      timeinfo.tm_sec = 0;
      timeinfo.tm_min = 0;
      timeinfo.tm_hour = 0;
      timeinfo.tm_mday = 1;
      timeinfo.tm_mon = quarter_start_month;
    }
    break;
  case GNUNET_TIME_RI_YEAR:
    timeinfo.tm_sec = 0;
    timeinfo.tm_min = 0;
    timeinfo.tm_hour = 0;
    timeinfo.tm_mday = 1;
    timeinfo.tm_mon = 0;
    break;
  }
  result.abs_value_us = (uint64_t) mktime (&timeinfo) * 1000000ULL;
  return result;
}

References GNUNET_TIME_Absolute::abs_value_us, GNUNET_break, GNUNET_TIME_absolute_is_never(), GNUNET_TIME_RI_DAY, GNUNET_TIME_RI_HOUR, GNUNET_TIME_RI_MINUTE, GNUNET_TIME_RI_MONTH, GNUNET_TIME_RI_NONE, GNUNET_TIME_RI_QUARTER, GNUNET_TIME_RI_SECOND, GNUNET_TIME_RI_WEEK, GNUNET_TIME_RI_YEAR, result, and ri.

Here is the call graph for this function:

GNUNET_TIME_timestamp2s()

const char * GNUNET_TIME_timestamp2s

(

struct GNUNET_TIME_Timestamp

ts

)

Convert ts to human-readable timestamp.

Note that the returned value will be overwritten if this function is called again.

Parameters

ts	the timestamp to convert

Returns

statically allocated string, will change on the next call

Definition at line 214 of file time.c.

{
  static GNUNET_THREAD_LOCAL char buf[255];
  time_t tt;
  struct tm *tp;
 
  if (GNUNET_TIME_absolute_is_never (ts.abs_time))
    return "never";
  tt = ts.abs_time.abs_value_us / 1000LL / 1000LL;
  tp = localtime (&tt);
  /* This is hacky, but i don't know a way to detect libc character encoding.
   * Just expect utf8 from glibc these days.
   * As for msvcrt, use the wide variant, which always returns utf16
   * (otherwise we'd have to detect current codepage or use W32API character
   * set conversion routines to convert to UTF8).
   */
  strftime (buf,
            sizeof(buf),
            "%a %b %d %H:%M:%S %Y",
            tp);
  return buf;
}

References GNUNET_TIME_Timestamp::abs_time, GNUNET_TIME_Absolute::abs_value_us, GNUNET_THREAD_LOCAL, GNUNET_TIME_absolute_is_never(), and tt.

Here is the call graph for this function:

GNUNET_TIME_absolute2s()

const char * GNUNET_TIME_absolute2s

(

struct GNUNET_TIME_Absolute

ts

)

Like asctime, except for GNUnet time.

Converts a GNUnet internal absolute time (which is in UTC) to a string in local time. Note that the returned value will be overwritten if this function is called again.

Parameters

ts	the absolute time to convert

Returns

timestamp in human-readable form in local time

Definition at line 239 of file time.c.

{
  static GNUNET_THREAD_LOCAL char buf[255];
  time_t tt;
  struct tm *tp;
 
  if (GNUNET_TIME_absolute_is_never (t))
    return "never";
  tt = t.abs_value_us / 1000LL / 1000LL;
  tp = localtime (&tt);
  /* This is hacky, but i don't know a way to detect libc character encoding.
   * Just expect utf8 from glibc these days.
   * As for msvcrt, use the wide variant, which always returns utf16
   * (otherwise we'd have to detect current codepage or use W32API character
   * set conversion routines to convert to UTF8).
   */
  strftime (buf,
            sizeof(buf),
            "%a %b %d %H:%M:%S %Y",
            tp);
  return buf;
}

References GNUNET_THREAD_LOCAL, GNUNET_TIME_absolute_is_never(), t, and tt.

Here is the call graph for this function:

GNUNET_TIME_relative2s()

const char * GNUNET_TIME_relative2s	(	struct GNUNET_TIME_Relative	delta,
		bool	do_round
	)

Give relative time in human-readable fancy format.

This is one of the very few calls in the entire API that is NOT reentrant!

Parameters

delta	time in milli seconds
do_round	are we allowed to round a bit?

Returns

string in human-readable form

Definition at line 264 of file time.c.

{
  static GNUNET_THREAD_LOCAL char buf[128];
  const char *unit = /* time unit */ "µs";
  uint64_t dval = delta.rel_value_us;
 
  if (GNUNET_TIME_relative_is_forever (delta))
    return "forever";
  if (0 == delta.rel_value_us)
    return "0 ms";
  if ( ((GNUNET_YES == do_round) &&
        (dval > 5 * 1000)) ||
       (0 == (dval % 1000)))
  {
    dval = dval / 1000;
    unit = /* time unit */ "ms";
    if (((GNUNET_YES == do_round) && (dval > 5 * 1000)) || (0 == (dval % 1000)))
    {
      dval = dval / 1000;
      unit = /* time unit */ "s";
      if (((GNUNET_YES == do_round) && (dval > 5 * 60)) || (0 == (dval % 60)))
      {
        dval = dval / 60;
        unit = /* time unit */ "m";
        if (((GNUNET_YES == do_round) && (dval > 5 * 60)) || (0 == (dval % 60)))
        {
          dval = dval / 60;
          unit = /* time unit */ "h";
          if (((GNUNET_YES == do_round) && (dval > 5 * 24)) ||
              (0 == (dval % 24)))
          {
            dval = dval / 24;
            if (1 == dval)
              unit = /* time unit */ "day";
            else
              unit = /* time unit */ "days";
          }
        }
      }
    }
  }
  GNUNET_snprintf (buf,
                   sizeof(buf),
                   "%llu %s",
                   (unsigned long long) dval,
                   unit);
  return buf;
}

References delta, do_round(), GNUNET_snprintf(), GNUNET_THREAD_LOCAL, GNUNET_TIME_relative_is_forever(), GNUNET_YES, and GNUNET_TIME_Relative::rel_value_us.

Referenced by free_timedout_queue_entry(), GNUNET_CURL_perform2(), and GNUNET_get_udp_socket().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_TIME_randomized_backoff()

struct GNUNET_TIME_Relative GNUNET_TIME_randomized_backoff	(	struct GNUNET_TIME_Relative	rt,
		struct GNUNET_TIME_Relative	threshold
	)

Randomized exponential back-off, starting at 1 ms and going up by a factor of 2+r, where 0 <= r <= 0.5, up to a maximum of the given threshold.

Parameters

rt	current backoff time, initially zero
threshold	maximum value for backoff

Returns

the next backoff time

Definition at line 830 of file time.c.

{
  double r = (rand () % 500) / 1000.0;
  struct GNUNET_TIME_Relative t;
 
  t = GNUNET_TIME_relative_multiply_double (
    GNUNET_TIME_relative_max (GNUNET_TIME_UNIT_MILLISECONDS, rt),
    2 + r);
  return GNUNET_TIME_relative_min (threshold, t);
}

References GNUNET_TIME_relative_max(), GNUNET_TIME_relative_min(), GNUNET_TIME_relative_multiply_double(), GNUNET_TIME_UNIT_MILLISECONDS, and t.

Referenced by error_handler(), error_handler(), error_handler(), error_handler(), and validation_start_cb().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_TIME_randomize()

struct GNUNET_TIME_Relative GNUNET_TIME_randomize

(

struct GNUNET_TIME_Relative

r

)

Return a random time value between 0.5*r and 1.5*r.

Parameters

r	input time for scaling

Returns

randomized time

Definition at line 851 of file time.c.

{
  double d = ((rand () % 1001) + 500) / 1000.0;
 
  return GNUNET_TIME_relative_multiply_double (r, d);
}

References d, and GNUNET_TIME_relative_multiply_double().

Referenced by sign_dv_init_cb().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_TIME_relative_get_zero_()

struct GNUNET_TIME_Relative GNUNET_TIME_relative_get_zero_

(

void

)

Return relative time of 0ms.

Definition at line 133 of file time.c.

{
  static struct GNUNET_TIME_Relative zero;
 
  return zero;
}

References zero.

Referenced by create_handle(), delayed_disconnect_channel(), get_epoch_private_key_timeout(), get_message_timeout(), handle_appeal_message(), handle_epoch_announcement(), handle_epoch_group_announcement(), handle_message(), solve_srv_room_member_collisions(), update_epoch_group(), and verify_tunnel_message().

Here is the caller graph for this function:

GNUNET_TIME_absolute_get_zero_()

struct GNUNET_TIME_Absolute GNUNET_TIME_absolute_get_zero_

(

void

)

Return absolute time of 0ms.

Definition at line 142 of file time.c.

{
  static struct GNUNET_TIME_Absolute zero;
 
  return zero;
}

References zero.

Referenced by create_epoch(), create_epoch_announcement(), create_epoch_group(), create_operation(), GNUNET_GNSRECORD_block_get_expiration(), pack_srv_room_message(), send_message_to_room(), and stop_operation().

Here is the caller graph for this function:

GNUNET_TIME_relative_get_unit_()

struct GNUNET_TIME_Relative GNUNET_TIME_relative_get_unit_

(

void

)

Return relative time of 1 microsecond.

Definition at line 151 of file time.c.

{
  static struct GNUNET_TIME_Relative one = { 1 };
 
  return one;
}

GNUNET_TIME_relative_get_millisecond_()

struct GNUNET_TIME_Relative GNUNET_TIME_relative_get_millisecond_

(

void

)

Return relative time of 1ms.

Definition at line 160 of file time.c.

{
  static struct GNUNET_TIME_Relative one = { 1000 };
 
  return one;
}

Referenced by handle_room_request_task().

Here is the caller graph for this function:

GNUNET_TIME_relative_get_second_()

struct GNUNET_TIME_Relative GNUNET_TIME_relative_get_second_

(

void

)

Return relative time of 1s.

Definition at line 169 of file time.c.

{
  static struct GNUNET_TIME_Relative one = { 1000 * 1000LL };
 
  return one;
}

Referenced by login_cont(), and on_message().

Here is the caller graph for this function:

GNUNET_TIME_relative_get_minute_()

struct GNUNET_TIME_Relative GNUNET_TIME_relative_get_minute_

(

void

)

Return relative time of 1 minute.

Definition at line 178 of file time.c.

{
  static struct GNUNET_TIME_Relative one = { 60 * 1000 * 1000LL };
 
  return one;
}

Referenced by get_message_timeout(), and register_reciever().

Here is the caller graph for this function:

GNUNET_TIME_relative_get_hour_()

struct GNUNET_TIME_Relative GNUNET_TIME_relative_get_hour_

(

void

)

Return relative time of 1 hour.

Definition at line 187 of file time.c.

{
  static struct GNUNET_TIME_Relative one = { 60 * 60 * 1000 * 1000LL };
 
  return one;
}

Referenced by handle_epoch_announcement_access(), handle_epoch_announcement_delay(), handle_epoch_group_access(), handle_epoch_group_announcement_delay(), send_epoch_announcement(), send_epoch_announcement_appeal(), and send_epoch_group_announcement().

Here is the caller graph for this function:

GNUNET_TIME_relative_get_forever_()

struct GNUNET_TIME_Relative GNUNET_TIME_relative_get_forever_

(

void

)

Return "forever".

Definition at line 196 of file time.c.

{
  static struct GNUNET_TIME_Relative forever = { UINT64_MAX };
 
  return forever;
}

Referenced by delete_srv_room_message().

Here is the caller graph for this function:

GNUNET_TIME_absolute_get_forever_()

struct GNUNET_TIME_Absolute GNUNET_TIME_absolute_get_forever_

(

void

)

Return "forever".

Definition at line 205 of file time.c.

{
  static struct GNUNET_TIME_Absolute forever = { UINT64_MAX };
 
  return forever;
}

Referenced by cleanup_srv_room_discourse_messages(), and store_handle_epoch_key().

Here is the caller graph for this function:

GNUNET_TIME_absolute_get()

struct GNUNET_TIME_Absolute GNUNET_TIME_absolute_get

(

void

)

Get the current time.

Returns

the current time

Definition at line 111 of file time.c.

{
  struct GNUNET_TIME_Absolute ret;
  struct timeval tv;
 
  gettimeofday (&tv, NULL);
  ret.abs_value_us = (uint64_t) (((uint64_t) tv.tv_sec * 1000LL * 1000LL)
                                 + ((uint64_t) tv.tv_usec))
                     + timestamp_offset;
  return ret;
}

References ret, and timestamp_offset.

Referenced by add_without_sets(), announce_id(), block_create_ecdsa(), block_create_eddsa(), block_decrypt_ecdsa(), block_decrypt_eddsa(), cache_nick(), check_vl_transmission(), cleanup_expired_records(), code_redirect(), consider_for_advertising(), consider_path_cb(), continue_store_activity(), cookie_identity_interpretation(), create_download_context(), create_member_session(), cummulative_ack(), data_sent_cb(), dht_connect_cb(), expire_blocks(), expired_processor(), find_proof(), flush_bulk(), free_timedout_queue_entry(), GCC_handle_connection_create_ack(), GCC_handle_encrypted(), GCC_transmit(), GCP_set_hello(), GCT_add_inbound_connection(), GDS_ROUTING_add(), generate_id_token_body(), get_age(), get_any(), get_epoch_private_key(), get_nick_record(), get_redirect_state(), get_timeout(), get_typed(), GNUNET_BANDWIDTH_tracker_init2(), GNUNET_CRYPTO_random_timeflake(), GNUNET_FS_meta_data_add_publication_date(), GNUNET_FS_publish_main_(), GNUNET_FS_queue_(), GNUNET_FS_search_probe_progress_(), GNUNET_FS_unindex_start(), GNUNET_GNSRECORD_normalize_record_set(), GNUNET_LOAD_update(), GNUNET_LOAD_value_init(), GNUNET_PEERSTORE_hello_add(), GNUNET_SCHEDULER_add_at_with_priority(), GNUNET_SCHEDULER_add_now(), GNUNET_SCHEDULER_add_select(), GNUNET_SCHEDULER_add_shutdown(), GNUNET_SCHEDULER_add_with_reason_and_priority(), GNUNET_SCHEDULER_do_work(), GNUNET_SCHEDULER_run(), GNUNET_TESTING_cmd_batch_next_(), GNUNET_TESTING_interpreter_current_cmd_touch(), GNUNET_TESTING_interpreter_next_(), GNUNET_TESTING_interpreter_run_cmd_(), GNUNET_TIME_absolute_get_duration(), GNUNET_TIME_absolute_get_monotonic(), GNUNET_TIME_absolute_get_remaining(), GNUNET_TIME_absolute_is_future(), GNUNET_TIME_absolute_is_past(), GNUNET_TIME_relative_to_absolute(), GNUNET_TIME_timestamp_get(), GNUNET_TIME_year_to_time(), GSF_peer_transmit_(), GSF_pending_request_create_(), GSF_pending_request_get_message_(), handle_client_send_request(), handle_connection_create(), handle_dht_local_get(), handle_dht_p2p_put(), handle_dht_reply(), handle_dummy(), handle_dv_learn(), handle_fragment_box(), handle_icmp_back(), handle_monitor_next(), handle_p2p_estimate(), handle_p2p_put(), handle_stop(), handle_tcp_back(), handle_test(), handle_udp_back(), handler_advertisement(), identity_changed(), insert_sorted(), iterate_zones(), lookup_authz_cb(), manage_first_hop_mq(), merge_with_nick_records(), monitor_cb(), monitor_notify_connect(), monitor_notify_disconnect(), monitor_unblock(), mylog(), namecache_postgres_expire_blocks(), namecache_sqlite_cache_block(), namecache_sqlite_expire_blocks(), notify_connect(), pack_srv_room_message(), parse(), peer_transmit(), postgres_plugin_del(), postgres_plugin_get(), postgres_plugin_get_closest(), postgres_plugin_get_expiration(), prepare_pending_acknowledgement(), printer(), printer_watch(), process_local_reply(), process_queue(), process_queue(), process_queue(), process_result(), process_stdin(), process_stdin(), progress_cb(), queue_send_msg(), read_start_time(), read_stdio(), RECLAIM_TICKETS_consume(), reconnect(), remove_expired(), revalidation_start_cb(), route_message(), route_packet(), route_via_neighbour(), RPS_sampler_elem_reinit(), run(), run(), run(), run(), run(), run_iteration_round(), run_zone_iteration_round(), sampler_mod_get_rand_peer(), scan(), schedule_peer_transmission(), schedule_transmit_on_queue(), search_start(), select_best_pending_from_link(), send_epoch_announcement(), send_epoch_group_announcement(), send_kx(), send_kx_auth(), send_message_to_room(), send_simple_single(), service_client_mst_cb(), set_epoch_announcement_appeal(), set_epoch_proposing(), setup_estimate_message(), setup_job(), setup_state_record(), shutdown_task(), sign_dv_init_cb(), sign_pow_identity(), sqlite_plugin_del(), sqlite_plugin_get_closest(), sqlite_plugin_get_expiration(), start_dht_request(), start_download(), start_job(), start_local_query(), start_operation(), start_process(), start_publish(), store_completed_cb(), store_skipped_key(), switch_member_session(), t_ax_encrypt(), test_exist_cb(), try_transmission(), update_ax_by_kx(), update_excess(), update_hostlist(), update_subscription_timing(), update_tracker(), and update_velocity().

GNUNET_TIME_relative_to_absolute()

struct GNUNET_TIME_Absolute GNUNET_TIME_relative_to_absolute

(

struct GNUNET_TIME_Relative

rel

)

Convert relative time to an absolute time in the future.

Parameters

rel	relative time to convert

Returns

timestamp that is "rel" in the future, or FOREVER if rel==FOREVER (or if we would overflow)

Definition at line 316 of file time.c.

{
  struct GNUNET_TIME_Absolute ret;
  struct GNUNET_TIME_Absolute now;
 
  if (GNUNET_TIME_relative_is_forever (rel))
    return GNUNET_TIME_UNIT_FOREVER_ABS;
  now = GNUNET_TIME_absolute_get ();
 
  if (rel.rel_value_us + now.abs_value_us < rel.rel_value_us)
  {
    GNUNET_break (0);  /* overflow... */
    return GNUNET_TIME_UNIT_FOREVER_ABS;
  }
  ret.abs_value_us = rel.rel_value_us + now.abs_value_us;
  return ret;
}

References GNUNET_TIME_Absolute::abs_value_us, GNUNET_break, GNUNET_TIME_absolute_get(), GNUNET_TIME_relative_is_forever(), GNUNET_TIME_UNIT_FOREVER_ABS, and ret.

Referenced by add_setter_action(), add_without_sets(), boot_queue(), boot_queue(), cadet_reply_proc(), check_for_glue(), check_if_ack_or_heartbeat(), check_rekey(), core_read_finished_cb(), core_read_finished_cb(), create_proto_queue(), create_proto_queue(), create_receiver(), data_sent_cb(), decaps_dv_box_cb(), do_dht_put(), do_generate_pid(), download_hostlist(), forward_dv_box(), GNUNET_DNSPARSER_parse_record(), GNUNET_GNSRECORD_record_get_expiration_time(), GNUNET_HELLO_builder_to_block(), GNUNET_HELLO_builder_to_url(), GNUNET_OS_command_run(), GNUNET_PILS_feed_addresses(), GNUNET_RESOLVER_hostname_get(), GNUNET_RESOLVER_ip_get(), GNUNET_SCHEDULER_add_delayed_with_priority(), GNUNET_SCHEDULER_add_select(), GNUNET_TIME_relative_to_timestamp(), GSC_SESSIONS_transmit(), GSF_pending_request_create_(), handle_client_call_message(), handle_dht_p2p_put(), handle_dht_reply(), handle_dv_learn(), handle_find_my_hello(), handle_fragment_box(), handle_heartbeat(), handle_initiator_done(), handle_p2p_migration_stop(), handle_p2p_put(), handle_reliability_box(), handle_validation_response(), learn_dv_path(), login_cont(), maint_child_death(), make_file(), modify_address(), mq_init(), mq_init(), ns_lookup_result_cb(), peerstore_store_own_cb(), pils_sign_addr_cb(), plan(), print_record(), process_record(), process_result(), put_migration_continuation(), queue_read(), queue_read(), queue_read_kx(), queue_read_kx(), queue_write(), queue_write(), regex_iterator(), reschedule_peer_timeout(), reschedule_peer_timeout(), reschedule_queue_timeout(), reschedule_receiver_timeout(), reschedule_sender_timeout(), result_processor(), run(), run(), run(), schedule_next_hello(), send_create(), send_create_ack(), send_kx(), send_kx_auth(), setup_filter(), setup_out_cipher(), setup_out_cipher(), setup_queue(), setup_sender(), start_address_validation(), transmit_on_queue(), transmit_request(), update_pm_next_attempt(), update_timeout(), validation_start_cb(), and vpn_allocation_cb().

Here is the call graph for this function:

GNUNET_TIME_relative_to_timestamp()

struct GNUNET_TIME_Timestamp GNUNET_TIME_relative_to_timestamp

(

struct GNUNET_TIME_Relative

rel

)

Convert relative time to a timestamp in the future.

Parameters

rel	relative time to convert

Returns

timestamp that is "rel" in the future, or FOREVER if rel==FOREVER (or if we would overflow)

Definition at line 336 of file time.c.

{
  return GNUNET_TIME_absolute_to_timestamp (
    GNUNET_TIME_relative_to_absolute (rel));
}

References GNUNET_TIME_absolute_to_timestamp(), and GNUNET_TIME_relative_to_absolute().

Here is the call graph for this function:

GNUNET_TIME_absolute_to_timestamp()

struct GNUNET_TIME_Timestamp GNUNET_TIME_absolute_to_timestamp

(

struct GNUNET_TIME_Absolute

at

)

Round an absolute time to a timestamp.

Parameters

at	time to round

Returns

the result

Definition at line 79 of file time.c.

{
  struct GNUNET_TIME_Timestamp ts;
 
  if (GNUNET_TIME_absolute_is_never (at))
    return GNUNET_TIME_UNIT_FOREVER_TS;
  ts.abs_time.abs_value_us = at.abs_value_us - at.abs_value_us % 1000000;
  return ts;
}

References GNUNET_TIME_Timestamp::abs_time, GNUNET_TIME_Absolute::abs_value_us, GNUNET_TIME_absolute_is_never(), and GNUNET_TIME_UNIT_FOREVER_TS.

Referenced by GNUNET_TIME_relative_to_timestamp(), and GNUNET_TIME_timestamp_get().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_TIME_timestamp_get()

struct GNUNET_TIME_Timestamp GNUNET_TIME_timestamp_get

(

void

)

Get timestamp representing the current time.

Returns

current time, rounded down to seconds

Definition at line 125 of file time.c.

{
  return GNUNET_TIME_absolute_to_timestamp (
    GNUNET_TIME_absolute_get ());
}

References GNUNET_TIME_absolute_get(), and GNUNET_TIME_absolute_to_timestamp().

Here is the call graph for this function:

GNUNET_TIME_relative_min()

struct GNUNET_TIME_Relative GNUNET_TIME_relative_min	(	struct GNUNET_TIME_Relative	t1,
		struct GNUNET_TIME_Relative	t2
	)

Return the minimum of two relative time values.

Parameters

t1	first timestamp
t2	other timestamp

Returns

timestamp that is smaller

Definition at line 344 of file time.c.

{
  return (t1.rel_value_us < t2.rel_value_us) ? t1 : t2;
}

Referenced by announce_id(), calculate_put_interval(), check_timeouts(), check_zone_namestore_next(), delayed_restart_task(), download_prepare(), encapsulate_for_dv(), find_advertisable_hello(), get_message_timeout(), GNUNET_TIME_absolute_approx_eq(), GNUNET_TIME_randomized_backoff(), handle_validation_response(), process_job_queue(), put_migration_continuation(), reconnect(), route_control_message_without_fc(), route_via_neighbour(), schedule_next_put(), schedule_next_task(), and start_address_validation().

Here is the caller graph for this function:

GNUNET_TIME_relative_max()

struct GNUNET_TIME_Relative GNUNET_TIME_relative_max	(	struct GNUNET_TIME_Relative	t1,
		struct GNUNET_TIME_Relative	t2
	)

Return the maximum of two relative time values.

Parameters

t1	first timestamp
t2	other timestamp

Returns

timestamp that is larger

Definition at line 352 of file time.c.

{
  return (t1.rel_value_us > t2.rel_value_us) ? t1 : t2;
}

Referenced by announce_id(), consider_gathering(), data_sent_cb(), do_scheduler_notify(), GNUNET_TIME_randomized_backoff(), put_migration_continuation(), reconnect(), schedule_next_task(), and send_heartbeat().

Here is the caller graph for this function:

GNUNET_TIME_absolute_min()

struct GNUNET_TIME_Absolute GNUNET_TIME_absolute_min	(	struct GNUNET_TIME_Absolute	t1,
		struct GNUNET_TIME_Absolute	t2
	)

Return the minimum of two absolute time values.

Parameters

t1	first timestamp
t2	other timestamp

Returns

timestamp that is smaller

Definition at line 360 of file time.c.

{
  return (t1.abs_value_us < t2.abs_value_us) ? t1 : t2;
}

Referenced by cadet_reply_proc(), cummulative_ack(), GNUNET_GNSRECORD_record_get_expiration_time(), handle_dht_reply(), handle_p2p_put(), handle_validation_response(), ns_lookup_result_cb(), process_result(), and try_transmission().

Here is the caller graph for this function:

GNUNET_TIME_absolute_max()

struct GNUNET_TIME_Absolute GNUNET_TIME_absolute_max	(	struct GNUNET_TIME_Absolute	t1,
		struct GNUNET_TIME_Absolute	t2
	)

Return the maximum of two absolute time values.

Parameters

t1	first timestamp
t2	other timestamp

Returns

timestamp that is smaller

Definition at line 368 of file time.c.

{
  return (t1.abs_value_us > t2.abs_value_us) ? t1 : t2;
}

Referenced by check_link_down(), GNUNET_GNSRECORD_record_get_expiration_time(), GNUNET_TIME_absolute_get_monotonic(), handle_add_queue_message(), handle_dht_result(), handle_flow_control(), learn_dv_path(), neighbour_dv_monotime_cb(), put_cb(), and update_iterator().

Here is the caller graph for this function:

GNUNET_TIME_absolute_round_down()

struct GNUNET_TIME_Absolute GNUNET_TIME_absolute_round_down	(	struct GNUNET_TIME_Absolute	at,
		struct GNUNET_TIME_Relative	rt
	)

Round down absolute time at to multiple of rt.

Parameters

at	absolute time to round
rt	multiple to round to (non-zero)

Returns

rounded time

Definition at line 392 of file time.c.

{
  struct GNUNET_TIME_Absolute ret;
 
  GNUNET_assert (! GNUNET_TIME_relative_is_zero (rt));
  ret.abs_value_us
    = at.abs_value_us
      - at.abs_value_us % rt.rel_value_us;
  return ret;
}

References GNUNET_assert, GNUNET_TIME_relative_is_zero(), and ret.

Here is the call graph for this function:

GNUNET_TIME_timestamp_max()

struct GNUNET_TIME_Timestamp GNUNET_TIME_timestamp_max	(	struct GNUNET_TIME_Timestamp	t1,
		struct GNUNET_TIME_Timestamp	t2
	)

Return the maximum of two timestamps.

Parameters

t1	first timestamp
t2	other timestamp

Returns

timestamp that is smaller

Definition at line 376 of file time.c.

{
  return (t1.abs_time.abs_value_us > t2.abs_time.abs_value_us) ? t1 : t2;
}

GNUNET_TIME_timestamp_min()

struct GNUNET_TIME_Timestamp GNUNET_TIME_timestamp_min	(	struct GNUNET_TIME_Timestamp	t1,
		struct GNUNET_TIME_Timestamp	t2
	)

Return the minimum of two timestamps.

Parameters

t1	first timestamp
t2	other timestamp

Returns

timestamp that is smaller

Definition at line 384 of file time.c.

{
  return (t1.abs_time.abs_value_us < t2.abs_time.abs_value_us) ? t1 : t2;
}

GNUNET_TIME_absolute_get_remaining()

struct GNUNET_TIME_Relative GNUNET_TIME_absolute_get_remaining

(

struct GNUNET_TIME_Absolute

future

)

Given a timestamp in the future, how much time remains until then?

Parameters

future

some absolute time, typically in the future

Returns

future - now, or 0 if now >= future, or FOREVER if future==FOREVER.

Definition at line 406 of file time.c.

{
  struct GNUNET_TIME_Relative ret;
  struct GNUNET_TIME_Absolute now;
 
  if (GNUNET_TIME_absolute_is_never (future))
    return GNUNET_TIME_UNIT_FOREVER_REL;
  now = GNUNET_TIME_absolute_get ();
 
  if (now.abs_value_us > future.abs_value_us)
    return GNUNET_TIME_UNIT_ZERO;
  ret.rel_value_us = future.abs_value_us - now.abs_value_us;
  return ret;
}

References GNUNET_TIME_Absolute::abs_value_us, GNUNET_TIME_absolute_get(), GNUNET_TIME_absolute_is_never(), GNUNET_TIME_UNIT_FOREVER_REL, GNUNET_TIME_UNIT_ZERO, and ret.

Referenced by add_record(), announce_id(), backtalker_timeout_cb(), check_for_glue(), check_link_down(), check_timeouts(), cmd_read(), connection_ready_cb(), consider_peer_destroy(), core_read_finished_cb(), core_read_finished_cb(), data_sent_cb(), delayed_restart_task(), display_record(), do_dht_put(), download_prepare(), encapsulate_for_dv(), find_advertisable_hello(), get_epoch_private_key_timeout(), get_message_timeout(), get_transmit_delay(), GNUNET_DATASTORE_put(), GNUNET_GNSRECORD_check_pow(), GNUNET_GNSRECORD_is_expired(), GNUNET_SCHEDULER_add_at_with_priority(), GSF_block_peer_migration_(), handle_add_queue_message(), handle_cadet_ring_message(), handle_dht_response(), handle_flow_control(), handle_namecache_block_response(), is_epoch_announcement_appealed(), is_epoch_proposing(), learn_dv_path(), list_callback(), load_operation(), monitor_cb(), path_cleanup_cb(), pick_random_dv_hops(), plan(), print_plugin_event_info(), process_job_queue(), process_lookup_result(), process_migration_content(), process_queue(), process_queue(), process_record(), proto_read_kx(), proto_read_kx(), put_migration_continuation(), queue_read(), queue_read(), queue_read_kx(), queue_read_kx(), queue_timeout(), queue_write(), queue_write(), quota_processor(), reassembly_cleanup_task(), revive_migration(), schedule_next_hello(), schedule_peer_transmission(), select_best_pending_from_link(), select_loop(), send_epoch_announcement(), send_epoch_group_announcement(), send_heartbeat(), sqlite_plugin_put(), sqlite_plugin_put(), t_ax_encrypt(), task_download(), timeout_cb(), transmit_item(), try_transmission(), update_flood_message(), update_pm_next_attempt(), and validation_start_cb().

Here is the call graph for this function:

GNUNET_TIME_absolute_approx_eq()

bool GNUNET_TIME_absolute_approx_eq	(	struct GNUNET_TIME_Absolute	a1,
		struct GNUNET_TIME_Absolute	a2,
		struct GNUNET_TIME_Relative	t
	)

Test if a1 and a2 are equal within a margin of error of t.

Parameters

a1	time to compare
a2	time to compare
t	tolerance to apply

Returns

true if "|a1-a2|<=t" holds.

Definition at line 63 of file time.c.

{
  struct GNUNET_TIME_Relative delta;
 
  delta = GNUNET_TIME_relative_min (
    GNUNET_TIME_absolute_get_difference (a1, a2),
    GNUNET_TIME_absolute_get_difference (a2, a1));
  return GNUNET_TIME_relative_cmp (delta,
                                   <=,
                                   t);
}

References delta, GNUNET_TIME_absolute_get_difference(), GNUNET_TIME_relative_cmp, GNUNET_TIME_relative_min(), and t.

Here is the call graph for this function:

GNUNET_TIME_calculate_eta()

struct GNUNET_TIME_Relative GNUNET_TIME_calculate_eta	(	struct GNUNET_TIME_Absolute	start,
		uint64_t	finished,
		uint64_t	total
	)

Calculate the estimate time of arrival/completion for an operation.

Parameters

start	when did the operation start?
finished	how much has been done?
total	how much must be done overall (same unit as for "finished")

Returns

remaining duration for the operation, assuming it continues at the same speed

Definition at line 562 of file time.c.

{
  struct GNUNET_TIME_Relative due;
  double exp;
  struct GNUNET_TIME_Relative ret;
 
  GNUNET_break (finished <= total);
  if (finished >= total)
    return GNUNET_TIME_UNIT_ZERO;
  if (0 == finished)
    return GNUNET_TIME_UNIT_FOREVER_REL;
  due = GNUNET_TIME_absolute_get_duration (start);
  exp = ((double) due.rel_value_us) * ((double) total) / ((double) finished);
  ret.rel_value_us = ((uint64_t) exp) - due.rel_value_us;
  return ret;
}

References finished, GNUNET_break, GNUNET_TIME_absolute_get_duration(), GNUNET_TIME_UNIT_FOREVER_REL, GNUNET_TIME_UNIT_ZERO, GNUNET_TIME_Relative::rel_value_us, ret, and start.

Referenced by GNUNET_FS_download_make_status_(), GNUNET_FS_publish_make_status_(), GNUNET_FS_unindex_make_status_(), and progress_proc().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_TIME_absolute_get_difference()

struct GNUNET_TIME_Relative GNUNET_TIME_absolute_get_difference	(	struct GNUNET_TIME_Absolute	start,
		struct GNUNET_TIME_Absolute	end
	)

Compute the time difference between the given start and end times.

Use this function instead of actual subtraction to ensure that "FOREVER" and overflows are handled correctly.

Parameters

start	some absolute time
end	some absolute time (typically larger or equal to start)

Returns

0 if start >= end; FOREVER if end==FOREVER; otherwise end - start

Definition at line 423 of file time.c.

{
  struct GNUNET_TIME_Relative ret;
 
  if (GNUNET_TIME_absolute_is_never (end))
    return GNUNET_TIME_UNIT_FOREVER_REL;
  if (end.abs_value_us < start.abs_value_us)
    return GNUNET_TIME_UNIT_ZERO;
  ret.rel_value_us = end.abs_value_us - start.abs_value_us;
  return ret;
}

References end, GNUNET_TIME_absolute_is_never(), GNUNET_TIME_UNIT_FOREVER_REL, GNUNET_TIME_UNIT_ZERO, GNUNET_TIME_Relative::rel_value_us, ret, and start.

Referenced by expire_blocks(), expired_processor(), free_timedout_queue_entry(), GNUNET_TIME_absolute_approx_eq(), handle_client_join(), handle_test(), sampler_mod_get_rand_peer(), solve_srv_room_member_collisions(), stat_cmd(), update_subscription_timing(), update_timeout(), and verify_tunnel_message().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_TIME_absolute_get_duration()

struct GNUNET_TIME_Relative GNUNET_TIME_absolute_get_duration

(

struct GNUNET_TIME_Absolute

whence

)

Get the duration of an operation as the difference of the current time and the given start time "hence".

Parameters

whence

some absolute time, typically in the past

Returns

0 if hence > now, otherwise now-hence.

Definition at line 438 of file time.c.

{
  struct GNUNET_TIME_Absolute now;
  struct GNUNET_TIME_Relative ret;
 
  now = GNUNET_TIME_absolute_get ();
  if (whence.abs_value_us > now.abs_value_us)
    return GNUNET_TIME_UNIT_ZERO;
  ret.rel_value_us = now.abs_value_us - whence.abs_value_us;
  return ret;
}

References GNUNET_TIME_Absolute::abs_value_us, GNUNET_TIME_absolute_get(), GNUNET_TIME_UNIT_ZERO, and ret.

Referenced by consider_sending_fc(), disconnect_and_schedule_reconnect(), do_shutdown(), evaluate_connection(), find_proof(), flush_bulk(), forward_dv_learn(), get_network_latency(), GNUNET_BANDWIDTH_tracker_get_available(), GNUNET_CURL_perform2(), GNUNET_FS_download_make_status_(), GNUNET_FS_publish_make_status_(), GNUNET_FS_search_make_status_(), GNUNET_FS_search_probe_progress_(), GNUNET_FS_unindex_make_status_(), GNUNET_SCHEDULER_do_work(), GNUNET_TESTING_interpreter_next_(), GNUNET_TIME_calculate_eta(), GSC_CLIENTS_solicit_request(), GSF_peer_update_performance_(), GSF_update_datastore_delay_(), handle_acknowledged(), handle_client_send(), handle_data(), handle_dht_p2p_put(), handle_fragment_box(), handle_matching_ack(), handle_result(), handle_validation_response(), internal_update(), lookup_authz_cb(), maint_child_death(), mylog(), namecache_sqlite_cache_block(), notify_client_chk_update(), odc_warn_delay_task(), peer_transmit(), process_parallel_lookup_result(), process_queue(), process_queue(), process_reply(), process_result(), process_result(), process_result_with_request(), process_stdin(), process_stdin(), progress_cb(), put_migration_continuation(), regex_found_handler(), run(), run(), run_iteration_round(), run_zone_iteration_round(), schedule_next_task(), shutdown_task(), signal_probe_result(), stop_job(), store_completed_cb(), test_master(), transmit_cummulative_ack_cb(), update_velocity(), warn_delay_task(), warn_no_client_continue(), and write_start_time().

Here is the call graph for this function:

GNUNET_TIME_absolute_add()

struct GNUNET_TIME_Absolute GNUNET_TIME_absolute_add	(	struct GNUNET_TIME_Absolute	start,
		struct GNUNET_TIME_Relative	duration
	)

Add a given relative duration to the given start time.

Parameters

start	some absolute time
duration	some relative time to add

Returns

FOREVER if either argument is FOREVER or on overflow; start+duration otherwise

Definition at line 452 of file time.c.

{
  struct GNUNET_TIME_Absolute ret;
 
  if (GNUNET_TIME_absolute_is_never (start) ||
      GNUNET_TIME_relative_is_forever (duration))
    return GNUNET_TIME_UNIT_FOREVER_ABS;
  if (start.abs_value_us + duration.rel_value_us < start.abs_value_us)
  {
    GNUNET_break (0);
    return GNUNET_TIME_UNIT_FOREVER_ABS;
  }
  ret.abs_value_us = start.abs_value_us + duration.rel_value_us;
  return ret;
}

References duration, GNUNET_break, GNUNET_TIME_absolute_is_never(), GNUNET_TIME_relative_is_forever(), GNUNET_TIME_UNIT_FOREVER_ABS, GNUNET_TIME_Relative::rel_value_us, ret, and start.

Referenced by announce_id(), block_create_ecdsa(), block_create_eddsa(), create_subscription(), generate_id_token_body(), get_epoch_private_key(), get_message_timeout(), get_transmit_delay(), GNUNET_GNSRECORD_check_pow(), identity_changed(), process_job_queue(), process_queue(), send_epoch_announcement(), send_epoch_group_announcement(), set_epoch_announcement_appeal(), set_epoch_proposing(), sign_ephemeral(), start_operation(), t_ax_encrypt(), timeout_cb(), update_ax_by_kx(), update_flood_message(), update_next_challenge_time(), and update_subscription().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_TIME_absolute_subtract()

struct GNUNET_TIME_Absolute GNUNET_TIME_absolute_subtract	(	struct GNUNET_TIME_Absolute	start,
		struct GNUNET_TIME_Relative	duration
	)

Subtract a given relative duration from the given start time.

Parameters

start	some absolute time
duration	some relative time to subtract

Returns

ZERO if start <= duration, or FOREVER if start time is FOREVER; start-duration otherwise

Definition at line 471 of file time.c.

{
  struct GNUNET_TIME_Absolute ret;
 
  if (start.abs_value_us <= duration.rel_value_us)
    return GNUNET_TIME_UNIT_ZERO_ABS;
  if (GNUNET_TIME_absolute_is_never (start))
    return GNUNET_TIME_UNIT_FOREVER_ABS;
  ret.abs_value_us = start.abs_value_us - duration.rel_value_us;
  return ret;
}

References GNUNET_TIME_Absolute::abs_value_us, duration, GNUNET_TIME_absolute_is_never(), GNUNET_TIME_UNIT_FOREVER_ABS, GNUNET_TIME_UNIT_ZERO_ABS, GNUNET_TIME_Relative::rel_value_us, ret, and start.

Referenced by GSF_pending_request_create_(), handle_validation_response(), read_start_time(), and sign_pow_identity().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_TIME_relative_multiply_double()

struct GNUNET_TIME_Relative GNUNET_TIME_relative_multiply_double	(	struct GNUNET_TIME_Relative	rel,
		double	factor
	)

Multiply relative time by a given factor.

Parameters

rel	some duration
factor	double to multiply with

Returns

FOREVER if rel=FOREVER or on overflow; otherwise rel*factor

Definition at line 506 of file time.c.

{
  struct GNUNET_TIME_Relative out;
  double m;
 
  GNUNET_assert (0.0 <= factor);
  if (0.0 >= factor)
    return GNUNET_TIME_UNIT_ZERO;
  if (GNUNET_TIME_relative_is_forever (rel))
    return GNUNET_TIME_UNIT_FOREVER_REL;
  m = ((double) rel.rel_value_us) * factor;
  if (m >= (double) (GNUNET_TIME_UNIT_FOREVER_REL).rel_value_us)
  {
    GNUNET_break (0);
    return GNUNET_TIME_UNIT_FOREVER_REL;
  }
  out.rel_value_us = (uint64_t) m;
  return out;
}

References GNUNET_assert, GNUNET_break, GNUNET_TIME_relative_is_forever(), GNUNET_TIME_UNIT_FOREVER_REL, GNUNET_TIME_UNIT_ZERO, m, and GNUNET_TIME_Relative::rel_value_us.

Referenced by GNUNET_TIME_randomize(), GNUNET_TIME_randomized_backoff(), handle_appeal_message(), handle_discourse_subscription(), handle_epoch_announcement(), and update_pm_next_attempt().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_TIME_relative_multiply()

struct GNUNET_TIME_Relative GNUNET_TIME_relative_multiply	(	struct GNUNET_TIME_Relative	rel,
		unsigned long long	factor
	)

Multiply relative time by a given factor.

Parameters

rel	some duration
factor	integer to multiply with

Returns

FOREVER if rel=FOREVER or on overflow; otherwise rel*factor

Definition at line 486 of file time.c.

{
  struct GNUNET_TIME_Relative ret;
 
  if (0 == factor)
    return GNUNET_TIME_UNIT_ZERO;
  if (GNUNET_TIME_relative_is_forever (rel))
    return GNUNET_TIME_UNIT_FOREVER_REL;
  ret.rel_value_us = rel.rel_value_us * factor;
  if (ret.rel_value_us / factor != rel.rel_value_us)
  {
    GNUNET_break (0);
    return GNUNET_TIME_UNIT_FOREVER_REL;
  }
  return ret;
}

References GNUNET_break, GNUNET_TIME_relative_is_forever(), GNUNET_TIME_UNIT_FOREVER_REL, GNUNET_TIME_UNIT_ZERO, GNUNET_TIME_Relative::rel_value_us, and ret.

Referenced by announce_next_regex(), calculate_rtt(), check_zone_namestore_next(), cleanup_expired_records(), connection_create(), connection_update_timer(), consider_gathering(), context_task(), curl_download_prepare(), do_discover_peers(), do_open_listening_socket(), download_prepare(), expire_records_continuation(), get_randomized_delay(), GNUNET_DNSPARSER_parse_record(), GNUNET_GNSRECORD_check_pow(), GNUNET_GNSRECORD_pow_start(), GNUNET_RPS_sub_start(), GNUNET_STATISTICS_destroy(), GNUNET_TIME_relative_to_round_interval(), GSF_pending_request_create_(), handle_connection_create(), handle_dht_p2p_put(), handle_dv_learn(), handle_fragment_box(), handle_msg_test(), handle_p2p_put(), handle_room_request_task(), handle_test(), handle_validation_response(), helper_read(), helper_write(), iter_finished(), login_cont(), lookup_authz_cb(), main(), plan(), process_job_queue(), read_send(), reannounce_regex(), reconnect(), register_sender(), REST_gns_process_request(), run(), run(), run_httpd(), run_with_key(), schedule_next_put(), send_epoch_announcement(), send_epoch_group_announcement(), send_find_peer_message(), start_burst(), start_closing_period(), start_draining_period(), start_dv_learn(), start_helper(), store_completed_cb(), stream_start_response(), task_check(), test_master(), timeout_cb(), and transmit_on_queue().

Here is the call graph for this function:

GNUNET_TIME_relative_saturating_multiply()

struct GNUNET_TIME_Relative GNUNET_TIME_relative_saturating_multiply	(	struct GNUNET_TIME_Relative	rel,
		unsigned long long	factor
	)

Saturating multiply relative time by a given factor.

Parameters

rel	some duration
factor	integer to multiply with

Returns

FOREVER if rel=FOREVER or on overflow; otherwise rel*factor

Definition at line 529 of file time.c.

{
  struct GNUNET_TIME_Relative ret;
 
  if (0 == factor)
    return GNUNET_TIME_UNIT_ZERO;
  if (GNUNET_TIME_relative_is_forever (rel))
    return GNUNET_TIME_UNIT_FOREVER_REL;
  ret.rel_value_us = rel.rel_value_us * factor;
  if (ret.rel_value_us / factor != rel.rel_value_us)
  {
    return GNUNET_TIME_UNIT_FOREVER_REL;
  }
  return ret;
}

References GNUNET_TIME_relative_is_forever(), GNUNET_TIME_UNIT_FOREVER_REL, GNUNET_TIME_UNIT_ZERO, GNUNET_TIME_Relative::rel_value_us, and ret.

Referenced by compute_rand_delay(), daemon_started(), GNUNET_FS_search_start_probe_(), GNUNET_is_burst_ready(), process_job_queue(), put_migration_continuation(), reconnect(), schedule_next_task(), and update_excess().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_TIME_relative_divide()

struct GNUNET_TIME_Relative GNUNET_TIME_relative_divide	(	struct GNUNET_TIME_Relative	rel,
		unsigned long long	factor
	)

Divide relative time by a given factor.

Parameters

rel	some duration
factor	integer to divide by

Returns

FOREVER if rel=FOREVER or factor==0; otherwise rel/factor

Definition at line 548 of file time.c.

{
  struct GNUNET_TIME_Relative ret;
 
  if ((0 == factor) ||
      (GNUNET_TIME_relative_is_forever (rel)))
    return GNUNET_TIME_UNIT_FOREVER_REL;
  ret.rel_value_us = rel.rel_value_us / factor;
  return ret;
}

References GNUNET_TIME_relative_is_forever(), GNUNET_TIME_UNIT_FOREVER_REL, GNUNET_TIME_Relative::rel_value_us, and ret.

Referenced by calculate_put_interval(), compute_rand_delay(), consider_gathering(), do_shutdown(), find_proof(), get_network_latency(), GNUNET_GNSRECORD_check_pow(), handle_dht_p2p_put(), handle_reliability_box(), handle_test(), peerstore_store_own_cb(), run_iteration_round(), run_zone_iteration_round(), schedule_next_put(), send_heartbeat(), start_address_validation(), store_completed_cb(), update_pm_next_attempt(), and update_timeout().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_TIME_relative_add()

struct GNUNET_TIME_Relative GNUNET_TIME_relative_add	(	struct GNUNET_TIME_Relative	a1,
		struct GNUNET_TIME_Relative	a2
	)

Add relative times together.

Parameters

a1	some relative time
a2	some other relative time

Returns

FOREVER if either argument is FOREVER or on overflow; a1+a2 otherwise

Definition at line 583 of file time.c.

{
  struct GNUNET_TIME_Relative ret;
 
  if ((a1.rel_value_us == UINT64_MAX) || (a2.rel_value_us == UINT64_MAX))
    return GNUNET_TIME_UNIT_FOREVER_REL;
  if (a1.rel_value_us + a2.rel_value_us < a1.rel_value_us)
  {
    GNUNET_break (0);
    return GNUNET_TIME_UNIT_FOREVER_REL;
  }
  ret.rel_value_us = a1.rel_value_us + a2.rel_value_us;
  return ret;
}

References GNUNET_break, GNUNET_TIME_UNIT_FOREVER_REL, and ret.

Referenced by calculate_rtt(), compute_rand_delay(), forward_dv_learn(), handle_dht_p2p_put(), handle_test(), process_queue(), process_result(), process_result(), run(), stat_cmd(), stop_job(), store_completed_cb(), update_pm_next_attempt(), and update_velocity().

Here is the caller graph for this function:

GNUNET_TIME_relative_subtract()

struct GNUNET_TIME_Relative GNUNET_TIME_relative_subtract	(	struct GNUNET_TIME_Relative	a1,
		struct GNUNET_TIME_Relative	a2
	)

Subtract relative timestamp from the other.

Parameters

a1	first timestamp
a2	second timestamp

Returns

ZERO if a2>=a1 (including both FOREVER), FOREVER if a1 is FOREVER, a1-a2 otherwise

Definition at line 601 of file time.c.

{
  struct GNUNET_TIME_Relative ret;
 
  if (a2.rel_value_us >= a1.rel_value_us)
    return GNUNET_TIME_UNIT_ZERO;
  if (a1.rel_value_us == UINT64_MAX)
    return GNUNET_TIME_UNIT_FOREVER_REL;
  ret.rel_value_us = a1.rel_value_us - a2.rel_value_us;
  return ret;
}

References GNUNET_TIME_UNIT_FOREVER_REL, GNUNET_TIME_UNIT_ZERO, GNUNET_TIME_Relative::rel_value_us, and ret.

Referenced by check_zone_namestore_next(), get_network_latency(), GNUNET_FS_search_probe_progress_(), GNUNET_is_burst_ready(), handle_acknowledged(), learn_dv_path(), store_completed_cb(), and update_velocity().

Here is the caller graph for this function:

GNUNET_TIME_relative_hton()

struct GNUNET_TIME_RelativeNBO GNUNET_TIME_relative_hton

(

struct GNUNET_TIME_Relative

a

)

Convert relative time to network byte order.

Parameters

a	time to convert

Returns

converted time value

Definition at line 616 of file time.c.

{
  struct GNUNET_TIME_RelativeNBO ret;
 
  ret.rel_value_us__ = GNUNET_htonll (a.rel_value_us);
  return ret;
}

References GNUNET_htonll(), GNUNET_TIME_RelativeNBO::rel_value_us__, and ret.

Referenced by announce_reconnect(), consider_sending_fc(), create_message_announcement(), create_message_appeal(), create_message_deletion(), create_message_group(), create_message_subscription(), forward_dv_learn(), GNUNET_get_burst_sync_msg(), GNUNET_GNSRECORD_pow_start(), GNUNET_RPS_sub_start(), GNUNET_TRANSPORT_communicator_receive(), GSF_block_peer_migration_(), notify_monitor(), on_message(), send_add_address(), start_burst(), start_dv_learn(), and transmit_cummulative_ack_cb().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_TIME_relative_ntoh()

struct GNUNET_TIME_Relative GNUNET_TIME_relative_ntoh

(

struct GNUNET_TIME_RelativeNBO

a

)

Convert relative time from network byte order.

Parameters

a	time to convert

Returns

converted time value

Definition at line 626 of file time.c.

{
  struct GNUNET_TIME_Relative ret;
 
  ret.rel_value_us = GNUNET_ntohll (a.rel_value_us__);
  return ret;
}

References GNUNET_ntohll(), GNUNET_TIME_Relative::rel_value_us, and ret.

Referenced by forward_dv_learn(), get_message_timeout(), get_network_latency(), GNUNET_is_burst_ready(), GNUNET_JSON_pack_time_rel_nbo(), handle_add_address(), handle_add_address(), handle_announce(), handle_client_start_sub(), handle_discourse_subscription(), handle_flow_control(), handle_message_subscribe(), handle_monitor_data(), handle_p2p_migration_stop(), handle_reliability_ack(), handle_start_burst(), and handle_validation_response().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_TIME_absolute_hton()

struct GNUNET_TIME_AbsoluteNBO GNUNET_TIME_absolute_hton

(

struct GNUNET_TIME_Absolute

a

)

Convert absolute time to network byte order.

Parameters

a	time to convert

Returns

converted time value

Definition at line 636 of file time.c.

{
  struct GNUNET_TIME_AbsoluteNBO ret;
 
  ret.abs_value_us__ = GNUNET_htonll (a.abs_value_us);
  return ret;
}

References GNUNET_TIME_AbsoluteNBO::abs_value_us__, GNUNET_htonll(), and ret.

Referenced by block_create_ecdsa(), block_create_eddsa(), client_response_handler(), consider_sending_fc(), create_loc_uri(), do_dht_put(), do_generate_pid(), encapsulate_for_dv(), extract_abs_time_nbo(), forward_reply(), GDS_helper_make_put_message(), GDS_helper_sign_path(), GDS_NEIGHBOURS_handle_reply(), get_cb(), GNUNET_CONSENSUS_create(), GNUNET_DATASTORE_put(), GNUNET_DHT_put(), GNUNET_DHT_verify_path(), GNUNET_FS_uri_loc_create(), GNUNET_HELLO_builder_to_block(), GNUNET_HELLO_parser_to_block(), GNUNET_PILS_sign_hello(), GNUNET_SECRETSHARING_create_session(), GNUNET_SECRETSHARING_decrypt(), GNUNET_TIME_absolute_get_monotonic(), GNUNET_TIME_timestamp_hton(), GSC_KX_handle_client_monitor_peers(), handle_client_call_message(), handle_client_loc_sign(), handle_datastore_reply(), handle_list(), handle_lookup_block_it(), handle_p2p_reply(), inject_rekey(), inject_rekey(), monitor_notify_all(), notify_monitor(), pack_srv_room_message(), PEERSTORE_create_record_mq_envelope(), pils_sign_address(), put_action(), regex_iterator(), response_action(), run_edkey(), run_pkey(), send_challenge(), send_challenge(), send_create(), send_lookup_response_with_filter(), send_message_to_room(), send_msg_with_kx(), send_request(), send_simple_single(), setup_estimate_message(), setup_flood_message(), sign_ephemeral(), sign_pow_identity(), start_dv_learn(), transmit_content(), transmit_item(), transmit_kx(), transmit_kx(), transmit_status(), update_backtalker_monotime(), uri_loc_parse(), validation_transmit_on_queue(), and verify_hello().

Here is the call graph for this function:

GNUNET_TIME_timestamp_hton()

struct GNUNET_TIME_TimestampNBO GNUNET_TIME_timestamp_hton

(

struct GNUNET_TIME_Timestamp

t

)

Convert timestamp to network byte order.

Parameters

t	time to convert

Returns

converted time value

Definition at line 91 of file time.c.

{
  struct GNUNET_TIME_TimestampNBO tn;
 
  tn.abs_time_nbo = GNUNET_TIME_absolute_hton (t.abs_time);
  return tn;
}

References GNUNET_TIME_TimestampNBO::abs_time_nbo, GNUNET_TIME_absolute_hton(), and t.

Referenced by extract_timestamp_nbo(), and parse_timestamp_nbo().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_TIME_absolute_from_ms()

struct GNUNET_TIME_Absolute GNUNET_TIME_absolute_from_ms

(

uint64_t

ms_after_epoch

)

Convert milliseconds after the UNIX epoch to absolute time.

Parameters

ms_after_epoch

millisecond timestamp to convert

Returns

converted time value

Definition at line 687 of file time.c.

{
  struct GNUNET_TIME_Absolute ret;
 
  ret.abs_value_us = GNUNET_TIME_UNIT_MILLISECONDS.rel_value_us
                     * ms_after_epoch;
  if (ret.abs_value_us / GNUNET_TIME_UNIT_MILLISECONDS.rel_value_us !=
      ms_after_epoch)
    ret = GNUNET_TIME_UNIT_FOREVER_ABS;
  return ret;
}

References GNUNET_TIME_Absolute::abs_value_us, GNUNET_TIME_UNIT_FOREVER_ABS, GNUNET_TIME_UNIT_MILLISECONDS, and ret.

GNUNET_TIME_absolute_is_never()

bool GNUNET_TIME_absolute_is_never

(

struct GNUNET_TIME_Absolute

abs

)

Test if abs is never.

Returns

true if it is.

Definition at line 646 of file time.c.

{
  return GNUNET_TIME_UNIT_FOREVER_ABS.abs_value_us == abs.abs_value_us;
}

References GNUNET_TIME_Absolute::abs_value_us, and GNUNET_TIME_UNIT_FOREVER_ABS.

Referenced by GNUNET_JSON_from_timestamp(), GNUNET_STRINGS_absolute_time_to_string(), GNUNET_STRINGS_fancy_time_to_timestamp(), GNUNET_TIME_absolute2s(), GNUNET_TIME_absolute_add(), GNUNET_TIME_absolute_get_difference(), GNUNET_TIME_absolute_get_remaining(), GNUNET_TIME_absolute_subtract(), GNUNET_TIME_absolute_to_timestamp(), GNUNET_TIME_round_down(), GNUNET_TIME_round_up(), GNUNET_TIME_timestamp2s(), and GNUNET_TIME_timestamp_to_s().

Here is the caller graph for this function:

GNUNET_TIME_absolute_is_past()

bool GNUNET_TIME_absolute_is_past

(

struct GNUNET_TIME_Absolute

abs

)

Test if abs is truly in the past (excluding now).

Returns

true if it is.

Definition at line 667 of file time.c.

{
  struct GNUNET_TIME_Absolute now;
 
  now = GNUNET_TIME_absolute_get ();
  return abs.abs_value_us < now.abs_value_us;
}

References GNUNET_TIME_Absolute::abs_value_us, and GNUNET_TIME_absolute_get().

Referenced by block_plugin_dns_check_block(), block_plugin_regex_check_block(), check_rekey(), datacache_get_iterator(), get_cb(), handle_dht_p2p_put(), handle_dht_p2p_result(), handle_find_local_hello(), transmit_next_request_task(), and verify_hello().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_TIME_absolute_is_zero()

bool GNUNET_TIME_absolute_is_zero

(

struct GNUNET_TIME_Absolute

abs

)

Test if abs is truly zero.

Returns

true if it is.

Definition at line 844 of file time.c.

{
  return 0 == abs.abs_value_us;
}

References GNUNET_TIME_Absolute::abs_value_us.

Referenced by GNUNET_JSON_pack_timestamp().

Here is the caller graph for this function:

GNUNET_TIME_absolute_is_future()

bool GNUNET_TIME_absolute_is_future

(

struct GNUNET_TIME_Absolute

abs

)

Test if abs is truly in the future (excluding now).

Returns

true if it is.

Definition at line 677 of file time.c.

{
  struct GNUNET_TIME_Absolute now;
 
  now = GNUNET_TIME_absolute_get ();
  return abs.abs_value_us > now.abs_value_us;
}

References GNUNET_TIME_Absolute::abs_value_us, and GNUNET_TIME_absolute_get().

Here is the call graph for this function:

GNUNET_TIME_relative_is_forever()

bool GNUNET_TIME_relative_is_forever

(

struct GNUNET_TIME_Relative

rel

)

Test if rel is forever.

Returns

true if it is.

Definition at line 653 of file time.c.

{
  return GNUNET_TIME_UNIT_FOREVER_REL.rel_value_us == rel.rel_value_us;
}

References GNUNET_TIME_UNIT_FOREVER_REL, and GNUNET_TIME_Relative::rel_value_us.

Referenced by GNUNET_JSON_from_time_rel(), GNUNET_TIME_absolute_add(), GNUNET_TIME_relative2s(), GNUNET_TIME_relative_divide(), GNUNET_TIME_relative_multiply(), GNUNET_TIME_relative_multiply_double(), GNUNET_TIME_relative_saturating_multiply(), and GNUNET_TIME_relative_to_absolute().

Here is the caller graph for this function:

GNUNET_TIME_relative_is_zero()

bool GNUNET_TIME_relative_is_zero

(

struct GNUNET_TIME_Relative

rel

)

Test if rel is zero.

Returns

true if it is.

Definition at line 660 of file time.c.

{
  return 0 == rel.rel_value_us;
}

References GNUNET_TIME_Relative::rel_value_us.

Referenced by GNUNET_TIME_absolute_round_down(), GNUNET_TIME_relative_to_round_interval(), handle_appeal_message(), handle_epoch_announcement_delay(), is_epoch_announcement_appealed(), is_epoch_proposing(), send_epoch_announcement(), send_epoch_group_announcement(), and set_epoch_proposal_group().

Here is the caller graph for this function:

GNUNET_TIME_absolute_from_s()

struct GNUNET_TIME_Absolute GNUNET_TIME_absolute_from_s

(

uint64_t

s_after_epoch

)

Convert seconds after the UNIX epoch to absolute time.

Parameters

s_after_epoch

seconds after epoch to convert

Returns

converted time value

Definition at line 701 of file time.c.

{
  struct GNUNET_TIME_Absolute ret;
 
  ret.abs_value_us = GNUNET_TIME_UNIT_SECONDS.rel_value_us * s_after_epoch;
  if (ret.abs_value_us / GNUNET_TIME_UNIT_SECONDS.rel_value_us !=
      s_after_epoch)
    ret = GNUNET_TIME_UNIT_FOREVER_ABS;
  return ret;
}

References GNUNET_TIME_Absolute::abs_value_us, GNUNET_TIME_UNIT_FOREVER_ABS, GNUNET_TIME_UNIT_SECONDS, and ret.

GNUNET_TIME_timestamp_from_s()

struct GNUNET_TIME_Timestamp GNUNET_TIME_timestamp_from_s

(

uint64_t

s_after_epoch

)

Convert seconds after the UNIX epoch to timestamp.

Parameters

s_after_epoch

seconds after epoch to convert

Returns

converted time value

Definition at line 714 of file time.c.

{
  struct GNUNET_TIME_Timestamp ret;
 
  ret.abs_time.abs_value_us
    = GNUNET_TIME_UNIT_SECONDS.rel_value_us * s_after_epoch;
  if (ret.abs_time.abs_value_us / GNUNET_TIME_UNIT_SECONDS.rel_value_us
      != s_after_epoch)
    ret = GNUNET_TIME_UNIT_FOREVER_TS;
  return ret;
}

References GNUNET_TIME_Timestamp::abs_time, GNUNET_TIME_Absolute::abs_value_us, GNUNET_TIME_UNIT_FOREVER_TS, GNUNET_TIME_UNIT_SECONDS, and ret.

GNUNET_TIME_timestamp_to_s()

uint64_t GNUNET_TIME_timestamp_to_s

(

struct GNUNET_TIME_Timestamp

ts

)

Convert timestamp to number of seconds after the UNIX epoch.

Parameters

ts	timestamp to convert

Returns

converted time value

Definition at line 728 of file time.c.

{
  if (GNUNET_TIME_absolute_is_never (ts.abs_time))
    return UINT64_MAX;
  return ts.abs_time.abs_value_us / GNUNET_TIME_UNIT_SECONDS.rel_value_us;
}

References GNUNET_TIME_Timestamp::abs_time, GNUNET_TIME_Absolute::abs_value_us, GNUNET_TIME_absolute_is_never(), and GNUNET_TIME_UNIT_SECONDS.

Here is the call graph for this function:

GNUNET_TIME_absolute_ntoh()

struct GNUNET_TIME_Absolute GNUNET_TIME_absolute_ntoh

(

struct GNUNET_TIME_AbsoluteNBO

a

)

Convert absolute time from network byte order.

Parameters

a	time to convert

Returns

converted time value

Definition at line 737 of file time.c.

{
  struct GNUNET_TIME_Absolute ret;
 
  ret.abs_value_us = GNUNET_ntohll (a.abs_value_us__);
  return ret;
}

References GNUNET_TIME_Absolute::abs_value_us, GNUNET_ntohll(), and ret.

Referenced by backtalker_monotime_cb(), bind_nbotime(), block_plugin_dns_check_block(), block_plugin_regex_check_block(), decaps_dv_box_cb(), do_dht_put(), do_rekey(), do_rekey(), GCP_check_and_update_monotime(), get_message_timeout(), get_network_latency(), GNUNET_GNSRECORD_block_get_expiration(), GNUNET_GNSRECORD_check_pow(), GNUNET_HELLO_dht_msg_to_block(), GNUNET_HELLO_get_expiration_time_from_msg(), GNUNET_HELLO_parser_from_block_(), GNUNET_TIME_absolute_get_monotonic(), GNUNET_TIME_timestamp_ntoh(), handle_arm_list_result(), handle_cadet_ring_message(), handle_client_decrypt(), handle_client_join(), handle_client_keygen(), handle_client_loc_sign(), handle_client_redirect_to_ip(), handle_client_redirect_to_service(), handle_client_send_request(), handle_data(), handle_dht_local_put(), handle_dht_p2p_put(), handle_dht_p2p_result(), handle_dht_result(), handle_dv_learn(), handle_estimate(), handle_flow_control(), handle_lookup_block_response(), handle_message_id(), handle_message_join(), handle_message_subscribe(), handle_monitor_data(), handle_monitor_get_resp(), handle_monitor_put(), handle_p2p_estimate(), handle_p2p_put(), handle_put(), handle_put(), handle_receive_info(), handle_record_result(), handle_reply(), handle_result(), handle_result(), handle_signature_response(), handle_status(), handle_test(), handle_validation_response(), handshake_ack_monotime_cb(), handshake_ack_monotime_cb(), handshake_monotime_cb(), handshake_monotime_cb(), inject_rekey(), inject_rekey(), iterate_flag_for_cleanup_discourse_message(), neighbour_dv_monotime_cb(), notify_srv_handle_message(), PEERSTORE_parse_record_message(), process_client_result(), put_cb(), rekey_monotime_cb(), rekey_monotime_cb(), run(), transmit_task_cb(), update_flood_message(), and verify_tunnel_message().

Here is the call graph for this function:

GNUNET_TIME_timestamp_ntoh()

struct GNUNET_TIME_Timestamp GNUNET_TIME_timestamp_ntoh

(

struct GNUNET_TIME_TimestampNBO

tn

)

Convert timestamp from network byte order.

Parameters

tn	time to convert

Returns

converted time value

Definition at line 101 of file time.c.

{
  struct GNUNET_TIME_Timestamp t;
 
  t.abs_time = GNUNET_TIME_absolute_ntoh (tn.abs_time_nbo);
  return t;
}

References GNUNET_TIME_absolute_ntoh(), and t.

Referenced by GNUNET_JSON_from_timestamp_nbo(), and GNUNET_JSON_pack_timestamp_nbo().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_TIME_set_offset()

void GNUNET_TIME_set_offset

(

long long

offset

)

Set the timestamp offset for this instance.

Parameters

offset

the offset to skew the locale time by

Definition at line 49 of file time.c.

{
  timestamp_offset = offset;
}

References timestamp_offset.

Referenced by do_speedup(), GNUNET_PROGRAM_run2(), GNUNET_SERVICE_run_(), and set_timetravel_time().

Here is the caller graph for this function:

GNUNET_TIME_get_offset()

long long GNUNET_TIME_get_offset

(

void

)

Get the timestamp offset for this instance.

Returns

the offset we currently skew the locale time by

Definition at line 56 of file time.c.

{
  return timestamp_offset;
}

References timestamp_offset.

Referenced by mylog().

Here is the caller graph for this function:

GNUNET_TIME_get_current_year()

unsigned int GNUNET_TIME_get_current_year

(

void

)

Return the current year (e.g.

'2011').

Definition at line 747 of file time.c.

{
  time_t tp;
  struct tm *t;
 
  tp = time (NULL);
  t = gmtime (&tp);
  if (t == NULL)
    return 0;
  return t->tm_year + 1900;
}

References t.

Referenced by main().

Here is the caller graph for this function:

GNUNET_TIME_year_to_time()

struct GNUNET_TIME_Absolute GNUNET_TIME_year_to_time

(

unsigned int

year

)

Convert a year to an expiration time of January 1st of that year.

Parameters

year	a year (after 1970, please ;-)).

Returns

absolute time for January 1st of that year.

Definition at line 801 of file time.c.

{
  struct GNUNET_TIME_Absolute ret;
  time_t tp;
  struct tm t;
 
  memset (&t, 0, sizeof(t));
  if (year < 1900)
  {
    GNUNET_break (0);
    return GNUNET_TIME_absolute_get ();  /* now */
  }
  t.tm_year = year - 1900;
  t.tm_mday = 1;
  t.tm_mon = 0;
  t.tm_wday = 1;
  t.tm_yday = 1;
#ifndef HAVE_TIMEGM
  tp = my_timegm (&t);
#else
  tp = timegm (&t);
#endif
  GNUNET_break (tp != (time_t) -1);
  ret.abs_value_us = tp * 1000LL * 1000LL; /* seconds to microseconds */
  return ret;
}

References GNUNET_break, GNUNET_TIME_absolute_get(), my_timegm(), ret, and t.

Referenced by main().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_TIME_time_to_year()

unsigned int GNUNET_TIME_time_to_year

(

struct GNUNET_TIME_Absolute

at

)

Convert an expiration time to the respective year (rounds)

Parameters

at	absolute time

Returns

year a year (after 1970), 0 on error

Definition at line 761 of file time.c.

{
  struct tm *t;
  time_t tp;
 
  tp = at.abs_value_us / 1000LL / 1000LL; /* microseconds to seconds */
  t = gmtime (&tp);
  if (t == NULL)
    return 0;
  return t->tm_year + 1900;
}

References GNUNET_TIME_Absolute::abs_value_us, and t.

GNUNET_TIME_absolute_get_monotonic()

struct GNUNET_TIME_Absolute GNUNET_TIME_absolute_get_monotonic

(

const struct GNUNET_CONFIGURATION_Handle *

cfg

)

Obtain the current time and make sure it is monotonically increasing.

Guards against systems without an RTC or clocks running backwards and other nasty surprises. Does not guarantee that the returned time is near the current time returned by GNUNET_TIME_absolute_get(). Two subsequent calls (within a short time period) may return the same value. Persists the last returned time on disk to ensure that time never goes backwards. As a result, the resulting value can be used to check if a message is the "most recent" value and replays of older messages (from the same origin) would be discarded.

Parameters

cfg	configuration, used to determine where to store the time; user can also insist RTC is working nicely and disable the feature

Returns

monotonically increasing time

Definition at line 860 of file time.c.

{
  static const struct GNUNET_CONFIGURATION_Handle *last_cfg;
  static struct GNUNET_TIME_Absolute last_time;
  static struct GNUNET_DISK_MapHandle *map_handle;
  static ATOMIC volatile uint64_t *map;
  struct GNUNET_TIME_Absolute now;
 
  now = GNUNET_TIME_absolute_get ();
  if (last_cfg != cfg)
  {
    char *filename;
 
    if (NULL != map_handle)
    {
      GNUNET_DISK_file_unmap (map_handle);
      map_handle = NULL;
    }
    map = NULL;
 
    last_cfg = cfg;
    if ((NULL != cfg) &&
        (GNUNET_OK ==
         GNUNET_CONFIGURATION_get_value_filename (cfg,
                                                  "util",
                                                  "MONOTONIC_TIME_FILENAME",
                                                  &filename)))
    {
      struct GNUNET_DISK_FileHandle *fh;
 
      fh = GNUNET_DISK_file_open (filename,
                                  GNUNET_DISK_OPEN_READWRITE
                                  | GNUNET_DISK_OPEN_CREATE,
                                  GNUNET_DISK_PERM_USER_WRITE
                                  | GNUNET_DISK_PERM_GROUP_WRITE
                                  | GNUNET_DISK_PERM_USER_READ
                                  | GNUNET_DISK_PERM_GROUP_READ);
      if (NULL == fh)
      {
        GNUNET_log (GNUNET_ERROR_TYPE_WARNING,
                    _ ("Failed to map `%s', cannot assure monotonic time!\n"),
                    filename);
      }
      else
      {
        off_t size;
 
        size = 0;
        GNUNET_break (GNUNET_OK == GNUNET_DISK_file_handle_size (fh, &size));
        if (size < (off_t) sizeof(*map))
        {
          struct GNUNET_TIME_AbsoluteNBO o;
 
          o = GNUNET_TIME_absolute_hton (now);
          if (sizeof(o) != GNUNET_DISK_file_write (fh, &o, sizeof(o)))
            size = 0;
          else
            size = sizeof(o);
        }
        if (size == sizeof(*map))
        {
          map = GNUNET_DISK_file_map (fh,
                                      &map_handle,
                                      GNUNET_DISK_MAP_TYPE_READWRITE,
                                      sizeof(*map));
          if (NULL == map)
            GNUNET_log (GNUNET_ERROR_TYPE_WARNING,
                        _ (
                          "Failed to map `%s', cannot assure monotonic time!\n")
                        ,
                        filename);
        }
        else
        {
          GNUNET_log (
            GNUNET_ERROR_TYPE_WARNING,
            _ (
              "Failed to setup monotonic time file `%s', cannot assure monotonic time!\n"),
            filename);
        }
      }
      GNUNET_DISK_file_close (fh);
      GNUNET_free (filename);
    }
  }
  if (NULL != map)
  {
    struct GNUNET_TIME_AbsoluteNBO mt;
 
#if __STDC_NO_ATOMICS__
#if __GNUC__
    mt.abs_value_us__ = __sync_fetch_and_or (map, 0);
#else
    mt.abs_value_us__ = *map;   /* godspeed, pray this is atomic */
#endif
#else
    mt.abs_value_us__ = atomic_load (map);
#endif
    last_time =
      GNUNET_TIME_absolute_max (GNUNET_TIME_absolute_ntoh (mt), last_time);
  }
  if (now.abs_value_us <= last_time.abs_value_us)
    now.abs_value_us = last_time.abs_value_us + 1;
  last_time = now;
  if (NULL != map)
  {
    uint64_t val = GNUNET_TIME_absolute_hton (now).abs_value_us__;
#if __STDC_NO_ATOMICS__
#if __GNUC__
    (void) __sync_lock_test_and_set (map, val);
#else
    *map = val;   /* godspeed, pray this is atomic */
#endif
#else
    atomic_store (map, val);
#endif
  }
  return now;
}

References _, GNUNET_TIME_Absolute::abs_value_us, GNUNET_TIME_AbsoluteNBO::abs_value_us__, ATOMIC, cfg, filename, GNUNET_break, GNUNET_CONFIGURATION_get_value_filename(), GNUNET_DISK_file_close(), GNUNET_DISK_file_handle_size(), GNUNET_DISK_file_map(), GNUNET_DISK_file_open(), GNUNET_DISK_file_unmap(), GNUNET_DISK_file_write(), GNUNET_DISK_MAP_TYPE_READWRITE, GNUNET_DISK_OPEN_CREATE, GNUNET_DISK_OPEN_READWRITE, GNUNET_DISK_PERM_GROUP_READ, GNUNET_DISK_PERM_GROUP_WRITE, GNUNET_DISK_PERM_USER_READ, GNUNET_DISK_PERM_USER_WRITE, GNUNET_ERROR_TYPE_WARNING, GNUNET_free, GNUNET_log, GNUNET_OK, GNUNET_TIME_absolute_get(), GNUNET_TIME_absolute_hton(), GNUNET_TIME_absolute_max(), GNUNET_TIME_absolute_ntoh(), map, and size.

Referenced by __attribute__(), consider_sending_fc(), handle_validation_response(), inject_rekey(), inject_rekey(), run(), send_challenge(), send_challenge(), send_create(), send_msg_with_kx(), sign_ephemeral(), start_address_validation(), start_dv_learn(), transmit_kx(), transmit_kx(), validation_start_cb(), and validation_transmit_on_queue().

Here is the call graph for this function:

Here is the caller graph for this function: