commit e30b6ac5d1127c368184232dc749cef28d0cbb6c
author Harald Welte <laforge@gnumonks.org> Fri Jul 13 12:21:04 2012 +0200
committer Harald Welte <laforge@gnumonks.org> Fri Jul 13 12:22:20 2012 +0200
tree 2afac8b934cc4510981cfcf00432ebabf07fd12c
parent 3c16de295480f269a1610c6d2cc559718c39c202

timer: Add function osmo_timer_remaining() to determine remainign time

src/timer.c

diff --git a/src/timer.c b/src/timer.c
index cca2a23..6d4abc2 100644
--- a/src/timer.c
+++ b/src/timer.c
@@ -126,6 +126,34 @@
 	return timer->active;
 }
 
+/*! \brief compute the remaining time of a timer
+ *  \param[in] timer the to-be-checked timer
+ *  \param[in] the current time (NULL if not known)
+ *  \param[out] remaining remaining time until timer fires
+ *  \return 0 if timer has not expired yet, -1 if it has
+ *
+ *  This function can be used to determine the amount of time
+ *  remaining until the expiration of the timer.
+ */
+int osmo_timer_remaining(const struct osmo_timer_list *timer,
+			 const struct timeval *now,
+			 struct timeval *remaining)
+{
+	struct timeval current_time;
+
+	if (!now) {
+		gettimeofday(&current_time, NULL);
+		now = &current_time;
+	}
+
+	timersub(&timer->timeout, &current_time, remaining);
+
+	if (remaining->tv_sec < 0)
+		return -1;
+
+	return 0;
+}
+
 /*
  * if we have a nearest time return the delta between the current
  * time and the time of the nearest timer.