From owner-svn-src-all@FreeBSD.ORG  Tue Dec 29 14:29:09 2009
Return-Path: <owner-svn-src-all@FreeBSD.ORG>
Delivered-To: svn-src-all@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 31C431065693;
	Tue, 29 Dec 2009 14:29:09 +0000 (UTC) (envelope-from kib@FreeBSD.org)
Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:4f8:fff6::2c])
	by mx1.freebsd.org (Postfix) with ESMTP id 21C398FC13;
	Tue, 29 Dec 2009 14:29:09 +0000 (UTC)
Received: from svn.freebsd.org (localhost [127.0.0.1])
	by svn.freebsd.org (8.14.3/8.14.3) with ESMTP id nBTET9j7027034;
	Tue, 29 Dec 2009 14:29:09 GMT (envelope-from kib@svn.freebsd.org)
Received: (from kib@localhost)
	by svn.freebsd.org (8.14.3/8.14.3/Submit) id nBTET9J5027031;
	Tue, 29 Dec 2009 14:29:09 GMT (envelope-from kib@svn.freebsd.org)
Message-Id: <200912291429.nBTET9J5027031@svn.freebsd.org>
From: Konstantin Belousov <kib@FreeBSD.org>
Date: Tue, 29 Dec 2009 14:29:09 +0000 (UTC)
To: src-committers@freebsd.org, svn-src-all@freebsd.org,
	svn-src-head@freebsd.org
X-SVN-Group: head
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Cc: 
Subject: svn commit: r201201 - in head/lib/libc: gen sys
X-BeenThere: svn-src-all@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: "SVN commit messages for the entire src tree \(except for &quot;
	user&quot; and &quot; projects&quot; \)" <svn-src-all.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/svn-src-all>,
	<mailto:svn-src-all-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/svn-src-all>
List-Post: <mailto:svn-src-all@freebsd.org>
List-Help: <mailto:svn-src-all-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/svn-src-all>,
	<mailto:svn-src-all-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Tue, 29 Dec 2009 14:29:09 -0000

Author: kib
Date: Tue Dec 29 14:29:08 2009
New Revision: 201201
URL: http://svn.freebsd.org/changeset/base/201201

Log:
  Document CLOCK_SECOND, add cross-reference from time(3) to clock_gettime(2).
  
  Based on submission by:	pluknet gmail com
  MFC after:	3 days

Modified:
  head/lib/libc/gen/time.3
  head/lib/libc/sys/clock_gettime.2

Modified: head/lib/libc/gen/time.3
==============================================================================
--- head/lib/libc/gen/time.3	Tue Dec 29 14:06:36 2009	(r201200)
+++ head/lib/libc/gen/time.3	Tue Dec 29 14:29:08 2009	(r201201)
@@ -66,6 +66,7 @@ The
 function may fail for any of the reasons described in
 .Xr gettimeofday 2 .
 .Sh SEE ALSO
+.Xr clock_gettime 2 ,
 .Xr gettimeofday 2 ,
 .Xr ctime 3
 .Sh STANDARDS

Modified: head/lib/libc/sys/clock_gettime.2
==============================================================================
--- head/lib/libc/sys/clock_gettime.2	Tue Dec 29 14:06:36 2009	(r201200)
+++ head/lib/libc/sys/clock_gettime.2	Tue Dec 29 14:29:08 2009	(r201201)
@@ -29,7 +29,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd November 4, 2006
+.Dd December 29, 2009
 .Dt CLOCK_GETTIME 2
 .Os
 .Sh NAME
@@ -70,10 +70,13 @@ which starts at zero when the kernel boo
 monotonically in SI seconds while the machine is running,
 .Dv CLOCK_VIRTUAL
 for time that increments only when
-the CPU is running in user mode on behalf of the calling process, or
+the CPU is running in user mode on behalf of the calling process,
 .Dv CLOCK_PROF
 for time that increments when the CPU is running in user or
-kernel mode.
+kernel mode, or
+.Dv CLOCK_SECOND
+which returns the current second without performing a full time counter
+query, using in-kernel cached value of current second.
 .Pp
 The structure pointed to by
 .Fa tp