From 1fa8dfbaf42a4341255b3bbef3c8a3c574e8c477 Mon Sep 17 00:00:00 2001 From: Max Date: Fri, 20 Oct 2017 12:48:04 +0200 Subject: Expand osmo_gettimeofday() docs Change-Id: I9bc835aea56f5f2fb652bb5ab3405e354ba3b95c Related: OS#2586 --- src/timer_gettimeofday.c | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) (limited to 'src/timer_gettimeofday.c') diff --git a/src/timer_gettimeofday.c b/src/timer_gettimeofday.c index 1bf714eb..42988053 100644 --- a/src/timer_gettimeofday.c +++ b/src/timer_gettimeofday.c @@ -33,7 +33,13 @@ struct timeval osmo_gettimeofday_override_time = { 23, 424242 }; /*! shim around gettimeofday to be able to set the time manually. * To override, set osmo_gettimeofday_override == true and set the desired - * current time in osmo_gettimeofday_override_time. */ + * current time in osmo_gettimeofday_override_time. + * + * N. B: gettimeofday() is affected by discontinuous jumps in the system time + * (e.g., if the system administrator manually changes the system time). + * Hence this should NEVER be used for elapsed time computation. + * Instead, clock_gettime(CLOCK_MONOTONIC, ..) should be used for that (with similar shim if necessary). + */ int osmo_gettimeofday(struct timeval *tv, struct timezone *tz) { if (osmo_gettimeofday_override) { -- cgit v1.2.3