@hackage rdtsc1.3.0.0

                                                          -*-outline-*-

• README file for Rdtsc binding

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.

** Usage

Use

runghc Setup.hs configure runghc Setup.hs build runghc Setup.hs install

for building and installing system-wide, or

runghc Setup.hs configure --prefix=$HOME/haskell-modules runghc Setup.hs build runghc Setup.hs install --user

for building and installing in directory $HOME/haskell-modules.

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