times(2)                                                       times(2)

  times()

  NAME

    times() - get process times

  SYNOPSIS

    #include 

    clock_t times (struct tms *tp)

  DESCRIPTION

    The times(2) function returns the value of time in CLK_TCK's of a second
    since 0 hours, 0 minutes, 0 seconds, January 1, 1970, Coordinated
    Universal Time.

    It also fills in the structure pointed to by tp with time-accounting
    information.

    The tms structure is defined as follows:

    typedef struct {
         clock_t tms_utime;
         clock_t tms_stime;
         clock_t tms_cutime;
         clock_t tms_cstime;
    }

    The elements of this structure are defined as follows:

    tms_utime

        The CPU time charged for the execution of user instructions.

    tms_stime

        The CPU time charged for execution by the system on behalf of the
        process.

    tms_cutime

        The sum of the tms_utime and tms_cutime of the child processes.

    tms_cstime

        The sum of the tms_stime and tms_cstime of the child processes.

    All times are in CLK_TCK's of a second.

    The times of a terminated child process are included in the tms_cutime and
    tms_cstime elements of the parent when one of the wait(2) functions
    returns the process ID of the terminated child to the parent. If an error
    occurs, times(2) returns the value -1 and sets errno to indicate the
    error.

    The return value from times(2) can overflow the range of a clock_t object.

  ERRORS

    The times(2) function may fail for these errors:

    [EFAULT]
        The tp argument is an invalid address.

  SEE ALSO

    time(2)

    wait(2)

  USAGE NOTES

    The times function is thread safe.

    The times function is async-signal safe.