[At-work.gif]

This is a draft; comments and suggestions are welcome.


PTR_GET_WALL_INTERVAL(3)
PTR_GET_USR_INTERVAL(3)
PTR_GET_SYS_INTERVAL(3)

NAME
PTR_GET_WALL_INTERVAL - Calculate the interval between two wallclock timer values.
PTR_GET_USR_INTERVAL - Calculate the interval between two User CPU timer values.
PTR_GET_SYS_INTERVAL - Calculate the interval between two System CPU timer values.

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_GET_WALL_INTERVAL(
DOUBLE PRECISION wall_var1,
DOUBLE PRECISION wall_var2,
DOUBLE PRECISION wall_secs,
INTEGER PTR_wall_stat );

void PTR_GET_USR_INTERVAL(
DOUBLE PRECISION usr_var1,
DOUBLE PRECISION usr_var2,
DOUBLE PRECISION usr_secs,
INTEGER PTR_usr_stat );

void PTR_GET_SYS_INTERVAL(
DOUBLE PRECISION sys_var1,
DOUBLE PRECISION sys_var2,
DOUBLE PRECISION sys_secs,
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 routines are used to calculate the time interval, in seconds, between two timer values. The overhead of converting the platform-dependent timer values and the calculation of the interval is encapsulated in these routines.

The first argument, ???_var1, is the timer value at the start of the interval being measured.

The second argument, ???_var2, is the timer value at the end of the interval being measured.

The third argument, ???_secs, is used to return the time interval between the two timer values, in seconds.

The fourth argument, PTR_???_stat, is used to return status information.

SEE ALSO
PTR_INIT_WALL_TIMER(3), PTR_INIT_USR_TIMER(3), PTR_INIT_SYS_TIMER(3), PTR_GET_WALL_TIME(3), PTR_GET_USR_TIME(3), PTR_GET_SYS_TIME(3).

WARNINGS
Switching the order of the timer values may give an PTR_ROLLOVER_DETECTED error.


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