[At-work.gif]

This is a draft; comments and suggestions are welcome.


PTR_Get_wall_time(3C)
PTR_Get_usr_time(3C)
PTR_Get_sys_time(3C)

NAME
PTR_Get_wall_time - Get current value of the wallclock timer.
PTR_Get_usr_time - Get current value of the User CPU timer.
PTR_Get_sys_time - Get current value of the System CPU timer.

SYNOPSIS
#include <ptools_ptr_c.h>

void PTR_Get_wall_time (PTR_wall_timer_val *wall_var);

void PTR_Get_usr_time (PTR_usr_timer_val *usr_var);

void PTR_Get_sys_time (PTR_sys_timer_val *sys_var);

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 read the current wallclock, user CPU and system CPU timer values respectively. They are called before and after the code to be timed. These routines take one argument which is the user defined variable for storing the current timer value.

These routines are meant to be the least intrusive and are implemented using very low level routines or assembly code. No error detection is done because it is either too difficult or requires too much overhead.

The value returned by these routines are not necessarily meaningful in themselves as no conversions to time units are made. They may be register contents or some 64-bit quantitiy depending on the underlying system's representation of the current timer value. Interval calculating routines (see the SEE ALSO section below) are used to convert these values to seconds.

SEE ALSO
PTR_Init_wall_timer(3C), PTR_Init_usr_timer(3C), PTR_Init_sys_timer(3C), PTR_Get_wall_interval(3C), PTR_Get_usr_interval(3C), PTR_Get_sys_interval(3C).

WARNINGS
The variable types (PTR_???_timer_val) are platform dependent and should be used for code portablity.


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