Guardian Native C Library Calls Reference Manual (G06.28+, H06.04+)

Guardian Native C Library Calls (t - z) times(3)
clock_t tms_cutime
User time, children. The sum of the tms_utime and tms_cutime times of the ter-
minated child processes.
clock_t tms_cstime
System time, children. The sum of the tms_stime and tms_cstime times of the
terminated child processes.
Use From the Guardian Environment
A Guardian process can call times() with the following restrictions:
• Child times are not maintained.
• All processor time is accumulated as user time.
• Elapsed time might not be correct if the processor’s internal clock has been reset.
RETURN VALUES
For OSS processes, the return value is the elapsed time (in microseconds) since the creation of
the process. For Guardian processes, the return value is the current time minus the process startup
time, which is affected if the internal clock has been reset. (The points from which elapsed times
are measured are likely to change in a future release and should not be depended on.)
If the times() function call is unsuccessful, the value -1 is returned and errno is set to indicate
the error.
ERRORS
If the following condition occurs, the times( ) function sets errno to the corresponding value:
[EFAULT] The buffer parameter points outside of the process address space.
RELATED INFORMATION
Functions: exec(2), fork(2), sysconf(3), tdm_execve(2), tdm_execvep(2), tdm_fork(2),
time(3), wait(2).
STANDARDS CONFORMANCE
The POSIX standards leave some features to the implementing vendor to define. The following
features are affected in the HP implementation:
• There is no overflow limit for the fields in the tms structure.
The following are HP extensions to the XPG4 Version 2 specification:
• The error value [EFAULT] can be returned.
527192-005 Hewlett-Packard Company 7−11