CLOCK(3,L)                  AIX Technical Reference                  CLOCK(3,L)



-------------------------------------------------------------------------------
clock



PURPOSE

Reports CPU time used.

LIBRARY

Standard C Library (libc.a)

SYNTAX

long clock ( )

DESCRIPTION

The clock subroutine returns the amount of CPU time (in microseconds) used
since the first call to clock.

The time reported is the sum of the user and system times of the calling
process and its terminated child processes for which it has executed a wait
system call or a system subroutine.

Note:  The value returned by the clock subroutine is defined in microseconds
       for compatibility with systems that have CPU clocks with very high
       resolution.  Because of this, the value returned wraps around after
       accumulating approximately 2147 seconds of CPU time (about 36 minutes).

RELATED INFORMATION

In this book:  "system," "times," and "wait, waitpid."





















Processed November 7, 1990        CLOCK(3,L)                                  1