[README FILE - START]

Name    : TestMHZ
Version : 0.99 (English/DOS)
Author  : Idan Nof [idannof@hotmail.com]
HomePage: www.geocities.com/idannof

Excerpt : Uses the TSC & PIT to benchmark your CPU frequency.
          * TSC = Time Stamp Counter
            (Valid for Intel Pentium and compatible CPU's)

          * PIT = Programmable Interrupt Timer

Usage   : C:\>TestMHZ [resolution] <ENTER>
          Where [resolution] is the number of digits after the floation
          point you want to see [0<=x<=6] , 0 is the default.

License : GNU GPL (See attached file "GPL.TXT" and/or visit "www.gnu.org" )

         "This program is free software; you can redistribute it and/or
          modify it under the terms of the GNU General Public License
          as published by the Free Software Foundation.

          This program is distributed in the hope that it will be useful,
          but WITHOUT ANY WARRANTY; without even the implied warranty of
          MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
          GNU General Public License for more details."

What/How: The PIT is a standard PC timer chip with a well-known resolution;
          The TSC is a Pentium feature which counts the number of clock
          cycles/ticks since the boot.

          This program uses readings from the PIT and the TSC to evaluate
          the CPU frequency, by making two consecutive reads of the TSC in
          an interval of 1 second of each other, as determined by the PIT.

          You can read the TSC using two instructions :
          1. RDTSC [0F 31] instruction
          2. using the RDMSR [0F A2] instruction when EAX=10h

          on both cases output is 64bit EAX:EDX Time Stamp Counter.

Problems: - Under multi-taskers (such as MS-Windows) the program might
            crash or give incorrect results.
          - Pure DOS shell recommended.
          - Some memory managers can cause trouble. If this is the case,
            try to perform a "clean" boot. 

Notes   : * Full Source + GPL license is in "SOURCE.ZIP" 
          * This program is a simple hybrid of two source codes (of TSC & PIT)
          * Compiled under Turbo Pascal 7.01, with RTE200 fix

Credits : 1. PIT Functions - TurboPower    (TPTIMER.PAS)
          2. TSC     "     - Yuval Melamed (YUVAL  .PAS)
          3. CPU Detection - Unknown       (CPUTEST.PAS)
          4. WIN     "     - Unknown

TestMHZ History 
***************

Version 0.99 (08/09/1999)
-------------
* First public version
* Revised README file (BUILD #2, 26/07/2000)

[README FILE - END]
