docs/122359: times (3) returns system uptime, not epoch time

[Viktor Štujber]

>Number:         122359
>Category:       docs
>Synopsis:       times (3) returns system uptime, not epoch time
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Apr 01 22:10:04 UTC 2008
>Closed-Date:
>Last-Modified:
>Originator:     Viktor Štujber
>Release:        7.0-RELEASE
>Organization:
>Environment:
FreeBSD poring.netvor.sk 7.0-RELEASE FreeBSD 7.0-RELEASE #0: Tue Apr  1 15:52:35          CEST 2008     root at poring.netvor.sk:/usr/obj/usr/src/sys/PORING  i386

>Description:
The freebsd manpages for 'clock_t times(struct tms *tp)' say the following:

   The times() function returns the value of time in CLK_TCK's of a second since 0 hours, 0 minutes, 0 seconds, January 1, 1970, Coordinated Universal Time.

But after letting a sample C program print the returned value, it matches the system's uptime (in clock ticks). I would like to ask the bsd devs to clarify whether this is a documentation problem, or an implementation problem.


References:

* http://www.freebsd.org/cgi/man.cgi?query=times&apropos=0&sektion=3&manpath=FreeBSD+7.0-RELEASE&format=html

* http://www.opengroup.org/onlinepubs/009695399/functions/times.html
>How-To-Repeat:

>Fix:


>Release-Note:
>Audit-Trail:
>Unformatted: