X-Git-Url: http://git.tuebingen.mpg.de/?p=paraslash.git;a=blobdiff_plain;f=time.c;h=6f6dd49e330df2f4d85565aa65ab1e02615abebd;hp=8faefc059c950c5a5889b37b14ea6e8b61072af8;hb=24758c5f;hpb=b0fe6d882dd35b01360a66e130d6714aff7b6a0d;ds=sidebyside

diff --git a/time.c b/time.c
index 8faefc05..6f6dd49e 100644
--- a/time.c
+++ b/time.c
@@ -1,5 +1,5 @@
 /*
- * Copyright (C) 2005-2010 Andre Noll <maan@systemlinux.org>
+ * Copyright (C) 2005-2013 Andre Noll <maan@systemlinux.org>
  *
  * Licensed under the GPL v2. For licencing details see COPYING.
  */
@@ -12,7 +12,7 @@
  *
  * \param tv The time value value to convert.
  *
- * \return The number off milliseconds in \a tv.
+ * \return The number of milliseconds in \a tv.
  */
 long unsigned tv2ms(const struct timeval *tv)
 {
@@ -82,7 +82,7 @@ int tv_diff(const struct timeval *b, const struct timeval *a, struct timeval *di
  *
  * \param a First addend.
  * \param b Second addend.
- * \param sum Contains the sum \a + \a b on return.
+ * \param sum Contains the sum \a a + \a b on return.
  */
 void tv_add(const struct timeval *a, const struct timeval *b,
 	struct timeval *sum)
@@ -180,7 +180,7 @@ int tv_convex_combination(const long a, const struct timeval *tv1,
  * \param stream_start When the first chunk was sent.
  * \param result The time when to send chunk number \a chunk_num.
  *
- * This function computes stream_start + chunk_num * chunk_time.
+ * This function computes \a stream_start + \a chunk_num * \a chunk_time.
  */
 void compute_chunk_time(long unsigned chunk_num,
 		struct timeval *chunk_tv, struct timeval *stream_start,
@@ -191,3 +191,40 @@ void compute_chunk_time(long unsigned chunk_num,
 	tv_scale(chunk_num, chunk_tv, &tmp);
 	tv_add(&tmp, stream_start, result);
 }
+
+/**
+ * Retrieve the time of the realtime clock.
+ *
+ * \param tv Where to store the result.
+ *
+ * Gets the current value of the system-wide real-time clock (identified by id
+ * \p CLOCK_REALTIME). If \a tv is \p NULL, the value is stored in a static
+ * buffer, otherwise it is stored at the location given by \a tv.
+ *
+ * \return This function aborts on errors. On success it returns a pointer to
+ * memory containing the current time.
+ *
+ * \sa clock_gettime(2), gettimeofday(2).
+ */
+struct timeval *clock_get_realtime(struct timeval *tv)
+{
+	static struct timeval user_friendly;
+
+	if (!tv)
+		tv = &user_friendly;
+#ifdef HAVE_CLOCK_GETTIME
+	{
+		struct timespec t;
+		int ret;
+
+		ret = clock_gettime(CLOCK_REALTIME, &t);
+		assert(ret == 0);
+		tv->tv_sec = t.tv_sec;
+		tv->tv_usec = t.tv_nsec / 1000;
+	}
+#else
+	#include <sys/time.h>
+	gettimeofday(tv, NULL);
+#endif /* HAVE_CLOCK_GETTIME */
+	return tv;
+}