This is a draft; comments and suggestions are welcome.


PTR_Init_wall_timer - Initialize the wallclock timer.
PTR_Init_usr_timer - Initialize the User CPU timer.
PTR_Init_sys_timer - Initialize the System CPU timer.

#include <ptools_ptr_c.h>

void PTR_Init_wall_timer(
double calib_time,
int *PTR_wall_stat );

void PTR_Init_usr_timer(
double calib_time,
int *PTR_usr_stat );

void PTR_Init_sys_timer(
double calib_time,
int *PTR_sys_stat );

NOTE: ??? refers to the prefix for any of the three timers: wallclock time (wall), user CPU time (usr), or system CPU time (sys).

These three routines do all necessary initializations for the wallclock, user CPU and system CPU timers, respectively. This is where all platform dependent initializations occur. In addition these routines set the values for the tick periods to be used during timing. These routines should be called before any other timing routines are called.

The first argument, calib_time, may be used to specify the time for which calibration should be run - if it is zero, no calibration is done. Note that in the 0.2 implementation, full advantage has been taken of the clause that "the vendor can choose to do nothing when the user requests calibration" - no calibration is done in any case.
The second argument, PTR_???_stat, is used for returning status information.

PTR_Get_wall_time(3C), PTR_Get_usr_time(3C), PTR_Get_sys_time(3C), PTR_Get_wall_interval(3C), PTR_Get_usr_interval(3C), PTR_Get_sys_interval(3C)

For further information, contact kennino@cs.orst.edu.