diff options
Diffstat (limited to 'man3/__ppc_get_timebase.3')
-rw-r--r-- | man3/__ppc_get_timebase.3 | 37 |
1 files changed, 19 insertions, 18 deletions
diff --git a/man3/__ppc_get_timebase.3 b/man3/__ppc_get_timebase.3 index f5ae9af3e..7ec1e5a13 100644 --- a/man3/__ppc_get_timebase.3 +++ b/man3/__ppc_get_timebase.3 @@ -2,7 +2,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH __ppc_get_timebase 3 2023-02-05 "Linux man-pages 6.03" +.TH __ppc_get_timebase 3 2023-05-03 "Linux man-pages 6.05.01" .SH NAME __ppc_get_timebase, __ppc_get_timebase_freq \- get the current value of the Time Base Register on Power architecture and its frequency. @@ -36,16 +36,17 @@ Time Base Register. .BR __ppc_get_timebase_freq () returns a 64-bit unsigned integer that represents the frequency at which the Time Base Register is updated. -.SH VERSIONS -GNU C Library support for -.\" commit d9dc34cd569bcfe714fe8c708e58c028106e8b2e +.SH STANDARDS +GNU. +.SH HISTORY +.TP .BR __ppc_get_timebase () -has been provided since glibc 2.16 and -.\" commit 8ad11b9a9cf1de82bd7771306b42070b91417c11 +.\" commit d9dc34cd569bcfe714fe8c708e58c028106e8b2e +glibc 2.16. +.TP .BR __ppc_get_timebase_freq () -has been available since glibc 2.17. -.SH STANDARDS -Both functions are nonstandard GNU extensions. +.\" commit 8ad11b9a9cf1de82bd7771306b42070b91417c11 +glibc 2.17. .SH EXAMPLES The following program will calculate the time, in microseconds, spent between two calls to @@ -59,36 +60,36 @@ between two calls to #include <stdio.h> #include <stdlib.h> #include <sys/platform/ppc.h> - +\& /* Maximum value of the Time Base Register: 2\[ha]60 \- 1. Source: POWER ISA. */ #define MAX_TB 0xFFFFFFFFFFFFFFF - +\& int main(void) { uint64_t tb1, tb2, diff; uint64_t freq; - +\& freq = __ppc_get_timebase_freq(); printf("Time Base frequency = %"PRIu64" Hz\en", freq); - +\& tb1 = __ppc_get_timebase(); - +\& // Do some stuff... - +\& tb2 = __ppc_get_timebase(); - +\& if (tb2 > tb1) { diff = tb2 \- tb1; } else { /* Treat Time Base Register overflow. */ diff = (MAX_TB \- tb2) + tb1; } - +\& printf("Elapsed time = %1.2f usecs\en", (double) diff * 1000000 / freq); - +\& exit(EXIT_SUCCESS); } .EE |