__ppc_get_timebase_freq(3) [linux man page]

__PPC_GET_TIMEBASE(3)					     Linux Programmer'sManual					     __PPC_GET_TIMEBASE(3)

NAME

       __ppc_get_timebase, __ppc_get_timebase_freq - get the current value
	of the Time Base Register on Power architecture and its frequency.

SYNOPSIS

       #include <sys/platform/ppc.h>

       uint64_t __ppc_get_timebase(void)

       uint64_t __ppc_get_timebase_freq(void);

DESCRIPTION

       __ppc_get_timebase()  reads  the current value of the Time Base Register and returns its value, while __ppc_get_timebase_freq() returns the
       frequency in which the Time Base Register is updated.

       The Time Base Register is a 64-bit register provided by Power Architecture processors.  It stores a monotonically incremented value that is
       updated at a system-dependent frequency that may be different from the processor frequency.

RETURN VALUE

       __ppc_get_timebase() returns a 64-bit unsigned integer that represents the current value of the Time Base Register.

       __ppc_get_timebase_freq() returns a 64-bit unsigned integer that represents the frequency at which the Time Base Register is updated.

VERSIONS

       GNU  C Library support for __ppc_get_timebase() has been provided since version 2.16 and __ppc_get_timebase_freq() has been available since
       version 2.17.

CONFORMING TO

       Both functions are nonstandard GNU extensions.

EXAMPLE

       The following program will calculate the time, in microseconds, spent between two calls to __ppc_get_timebase().

   Program source

       #include <inttypes.h>
       #include <stdint.h>
       #include <stdio.h>
       #include <stdlib.h>
       #include <sys/platform/ppc.h>

       /* Maximum value of the Time Base Register: 2^60 - 1.
	  Source: POWER ISA.  */
       #define MAX_TB 0xFFFFFFFFFFFFFFF

       int
       main(void)
       {
	   uint64_t tb1, tb2, diff;

	   uint64_t freq = __ppc_get_timebase_freq();
	   printf("Time Base frequency = %"PRIu64" Hz
", 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
",
		   (double) diff * 1000000 / freq );

	   exit(EXIT_SUCCESS);
       }

SEE ALSO

       time(2), usleep(3)

GNU C Library							    2019-03-06						     __PPC_GET_TIMEBASE(3)

Check Out this Related Man Page

Sort::Key::Register(3pm)				User Contributed Perl Documentation				  Sort::Key::Register(3pm)

NAME

       Sort::Key::Register - tell Sort::Key how to sort new data types.

SYNOPSYS

	 use Sort::Key::Register Person =>
	     sub { $_->surname, $_->name },
	     qw(string string);

	 use Sort::Key::Register 'Color::Component' => 'integer';

	 use Sort::Key::Register Color =>
	     sub { $_->R, $_->G, $_->B },
	     ('Color::Component') x 3;

DESCRIPTION

       Sort::Key::Register allows one to register new data types with Sort::Key so that they can be sorted as natively supported ones.

       It works as a pragma module and doesn't export any function, all its functionality is provided via "use":

	 use Sort::Key::Register ...

       To avoid collisions between modules registering types with the same name, you should qualify them with the package name.

	 use Sort::Key::Register 'MyPkg::foo' => sub { $_ }, '-int';

	 # or using __PACKAGE__:
	 use Sort::Key::Register __PACKAGE__, sub { $_ }, '-int';

   USAGE
       use Sort::Key::Register $name => &multikeygen, @keytypes;
	   registers type $name.

	   &multikeygen is the multikey extraction function for the type and @keytypes are the types of the extracted keys.

       use Sort::Key::Register $name => $keytype;
	   this 'use' is useful for simple types that are sorted as another type already registered, maybe changing the direction of the sort
	   (ascending or descending).

SEE ALSO

       Sort::Key, Sort::Key::Maker.

AUTHOR

       Salvador Fandin~o, <sfandino@yahoo.com>

COPYRIGHT AND LICENSE

       Copyright (C) 2005 by Salvador Fandin~o

       This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.4 or,
       at your option, any later version of Perl 5 you may have available.

perl v5.14.2							    2012-06-30						  Sort::Key::Register(3pm)

Linux and UNIX Man Pages

__ppc_get_timebase_freq(3) [linux man page]

Check Out this Related Man Page