rdtsc: Binding for the rdtsc machine instruction

[ bsd3, foreign-binding, library ] [ Propose Tags ]

This module provides the function rdtsc for accessing the rdtsc machine register on modern IA-32 processors. This is a 64-bit counter which counts the number of processor cycles since the machine has been powered up. Using this instruction, you can make very precise time measurements which are independent of the actual CPU frequency. But note that you can get strange results sometimes on a superscalar processor.

Also note that the Haskell foreign function interface imposes some additional overheads. On my machine, it takes about 950 cycles to call this function twice and to compute the difference, whereas in C the overhead is only about 88 cycles.

[Skip to Readme]




Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees


  • No Candidates
Versions [RSS] 1.1.1, 1.1.3,,,,
Change log ChangeLog.md
Dependencies base (>=4 && <5) [details]
License BSD-3-Clause
Author Martin Grabmueller <martin@grabmueller.de>
Maintainer martin@grabmueller.de
Category Foreign binding
Home page https://github.com/mgrabmueller/rdtsc
Bug tracker https://github.com/mgrabmueller/rdtsc/issues
Source repo head: git clone https://github.com/mgrabmueller/rdtsc
Uploaded by MartinGrabmueller at 2015-05-26T15:17:33Z
Distributions LTSHaskell:, NixOS:, Stackage:
Reverse Dependencies 6 direct, 4 indirect [details]
Downloads 5605 total (27 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs available [build log]
Last success reported on 2015-05-27 [all 1 reports]

Readme for rdtsc-

[back to package description]

rdtsc - Binding for the rdtsc machine instruction

This small Cabal package provides a Haskell binding to the "rdtsc" machine instruction on modern IA-32 processors. This instruction can be used to read the number of cycles since processor startup and gives very accurate timing information.

Note: this package contains the file cycle.h by Matteo Frigo, which provides access to cycle counters on several architectures. The license for this file is included in the file LICENSE in this package.



cabal install rdtsc

for building and installing system-wide, or

tar xzvf rdtsc-X.Y.Z.W.tar.gz
cd rdtsc-X.Y.Z.W
cabal sandbox init
cabal install

for building and installing in a sandbox.

Just import module "System.CPUTime.Rdtsc" into your Haskell file and use

ghc --make FILENAME

to compile your program.

The "tests" directory contains a small test program for the module and demonstrates its usage. There is also a C version for this test program, to test the overheads of Haskell's FFI.

Happy Haskell hacking, Martin