[At-work.gif]

This is a draft; comments and suggestions are welcome.


PTR_INIT_WALL_TIMER(3)
PTR_INIT_USR_TIMER(3)
PTR_INIT_SYS_TIMER(3)

NAME
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.

SYNOPSIS
#include <ptools_ptr_f.h>

Note: The types of the arguments passed to these routines may vary based on the platform. Please refer to the header file, "ptools_ptr_f.h", for information about this platform.

void PTR_INIT_WALL_TIMER(
DOUBLE PRECISION calib_time,
INTEGER PTR_wall_stat );

void PTR_INIT_USR_TIME(
DOUBLE PRECISION calib_time,
INTEGER PTR_usr_stat );

void PTR_INIT_SYS_TIMER(
DOUBLE PRECISION calib_time,
INTEGER PTR_sys_stat );

DESCRIPTION
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.

SEE ALSO
PTR_GET_WALL_TIME(3), PTR_GET_USR_TIME(3), PTR_GET_SYS_TIME(3), PTR_GET_WALL_INTERVAL(3), PTR_GET_USR_INTERVAL(3), PTR_GET_SYS_INTERVAL(3).


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