__ppc_get_timebase.3: New page documenting __ppc_get_timebase()

Glibc 2.16 was released with a new function for the Power
architecture that can read its Time Base Register.

Signed-off-by: Tulio Magno Quites Machado Filho <tuliom@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Tulio Magno Quites Machado Filho 2012-08-22 15:53:12 -03:00 committed by Michael Kerrisk
parent 4d45036a35
commit 42d7fb6cce
1 changed files with 49 additions and 0 deletions

49
man3/__ppc_get_timebase.3 Normal file
View File

@ -0,0 +1,49 @@
.\" Copyright (c) 2012, IBM Corporation.
.\"
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\" Permission is granted to copy and distribute modified versions of
.\" this manual under the conditions for verbatim copying, provided that
.\" the entire resulting derived work is distributed under the terms of
.\" a permission notice identical to this one.
.\"
.\" Since the Linux kernel and libraries are constantly changing, this
.\" manual page may be incorrect or out-of-date. The author(s) assume.
.\" no responsibility for errors or omissions, or for damages resulting.
.\" from the use of the information contained herein. The author(s) may.
.\" not have taken the same level of care in the production of this.
.\" manual, which is licensed free of charge, as they might when working.
.\" professionally.
.\"
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.TH __PPC_GET_TIMEBASE 3 2012-08-13 "GNU C Library" "Linux Programmer's\
Manual"
.SH NAME
__ppc_get_timebase \- Get the current value of the Time Base Register on
Power architecture
.SH SYNOPSIS
.B #include <sys/platform/ppc.h>
.sp
.BI "uint64_t __ppc_get_timebase(void)"
.SH DESCRIPTION
.BR __ppc_get_timebase()
reads the current value of the Time Base Register and returns its value.
The Time Base Register is a 64-bit register presented in Power Architecture
processors that stores a monotonically incremented value updated at a
system-dependent frequency that may be different from the processor
frequency.
.SH RETURN VALUE
Returns a 64-bit unsigned integer that represents the current value of the
Time Base Register.
.SH VERSIONS
The GNU C Library support for __ppc_get_timebase has been provided since
version 2.16.
.SH CONFORMING TO
This function is a nonstandard GNU extension.
.SH SEE ALSO
.BR time (2),
.BR usleep (3)