From nobody@FreeBSD.org  Tue Apr  1 22:07:32 2008
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 7477B10656C0
	for <freebsd-gnats-submit@FreeBSD.org>; Tue,  1 Apr 2008 22:07:32 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21])
	by mx1.freebsd.org (Postfix) with ESMTP id 65A328FC16
	for <freebsd-gnats-submit@FreeBSD.org>; Tue,  1 Apr 2008 22:07:32 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.14.2/8.14.2) with ESMTP id m31M7UUm025596
	for <freebsd-gnats-submit@FreeBSD.org>; Tue, 1 Apr 2008 22:07:30 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.14.2/8.14.1/Submit) id m31M7UdG025595;
	Tue, 1 Apr 2008 22:07:30 GMT
	(envelope-from nobody)
Message-Id: <200804012207.m31M7UdG025595@www.freebsd.org>
Date: Tue, 1 Apr 2008 22:07:30 GMT
From: "Viktor &#352;tujber" <theultramage@gmail.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: times (3) returns system uptime, not epoch time
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         122359
>Category:       docs
>Synopsis:       times (3) returns system uptime, not epoch time
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    keramida
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Apr 01 22:10:04 UTC 2008
>Closed-Date:    Sat Dec 06 14:52:06 UTC 2008
>Last-Modified:  Sat Dec 06 14:52:06 UTC 2008
>Originator:     Viktor &#352;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@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:
State-Changed-From-To: open->closed 
State-Changed-By: remko 
State-Changed-When: Wed Apr 2 12:07:08 UTC 2008 
State-Changed-Why:  
Questions can be asked directly to the doc@FreeBSD.org or 
questions@FreeBSd.org list and should not be contained within a PR. If 
this is proven to be wrong (as you opt) let me know and I'll reopen the 
ticket. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=122359 
State-Changed-From-To: closed->open 
State-Changed-By: keramida 
State-Changed-When: Mon Dec 1 15:24:59 UTC 2008 
State-Changed-Why:  
Reopen; this seems to be a manpage bug. 


Responsible-Changed-From-To: freebsd-doc->keramida 
Responsible-Changed-By: keramida 
Responsible-Changed-When: Mon Dec 1 15:24:59 UTC 2008 
Responsible-Changed-Why:  
I'll handle this. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=122359 
State-Changed-From-To: open->patched 
State-Changed-By: keramida 
State-Changed-When: Mon Dec 1 15:26:18 UTC 2008 
State-Changed-Why:  
Fixed in 8.0-CURRENT with svn change 185519.  Thank you for 
the original report and the email reminder.  We will try to 
merge this to the stable branches too :) 

http://www.freebsd.org/cgi/query-pr.cgi?pr=122359 
State-Changed-From-To: patched->closed 
State-Changed-By: keramida 
State-Changed-When: Sat Dec 6 14:50:56 UTC 2008 
State-Changed-Why:  
The manpage is fixed now in the stable/6, stable/7 and 
releng/7.1 branches too.  Thanks for submitting the PR, 
and for poking us again about it to solve it :) 

http://www.freebsd.org/cgi/query-pr.cgi?pr=122359 
>Unformatted:
