From abbcc3941b4b3192a2994e4a16087e4c6bb5e1c2 Mon Sep 17 00:00:00 2001 From: Jonas 'Sortie' Termansen Date: Sun, 19 Jan 2014 00:21:31 +0100 Subject: [PATCH] Document times(2) as obsolete. --- doc/obsolete-stuff | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/doc/obsolete-stuff b/doc/obsolete-stuff index 3c35e1e7..f8863cdb 100644 --- a/doc/obsolete-stuff +++ b/doc/obsolete-stuff @@ -212,6 +212,18 @@ sys/timeb.h This is a header that contains the ftime function that has been replaced, this header has been removed as well. +times +----- + +This function is badly designed and the whole clock_t and sysconf(_SC_CLK_TCK) +business is insane. It doesn't help there is problem with potential overflowing +and the accuracy of the function varies between systems. You should avoid this +function in favor of clock_gettime and the Sortix extension clocks that provide +the same information as struct timespecs. If you need the atomic semantics of +times, you can use the Sortix extension timens. + +Sortix currently provides this function for compatibility reasons. + tmpnam ------