*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->OpenBSD man pages -> times (3)              



NAME    [Toc]    [Back]

     times - process times

SYNOPSIS    [Toc]    [Back]

     #include <sys/times.h>

     times(struct tms *tp);

DESCRIPTION    [Toc]    [Back]

     This interface is obsoleted by getrusage(2)  and  gettimeofday(2).

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

     It  also  fills in the structure pointed to by tp with timeaccounting information.

     The tms structure is defined as follows:

           struct tms {
                   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

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

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

     tms_cstime  The sum of the tms_stimes and tms_cstimes of the
child processes.

     All times are in CLK_TCKs of a second.

     The times of a terminated child process are included in  the
     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()  returns  the value (clock_t - 1), and
sets errno to
     indicate the error.

ERRORS    [Toc]    [Back]

     The times() function may fail and set  the  global  variable
errno for any
     of   the   errors   specified   for   the  library  routines
getrusage(2) and

SEE ALSO    [Toc]    [Back]

     time(1), getrusage(2), gettimeofday(2), wait(2)

STANDARDS    [Toc]    [Back]

     The  times()  function  conforms  to  IEEE  Std  1003.1-1988

OpenBSD      3.6                           June      4,      1993
[ Back ]
 Similar pages
Name OS Title
times Tru64 Get process and child process times
times IRIX get process and child process times
times HP-UX get process and child process times
pxftimes IRIX Gets process times
times Linux get process times
Benchmark IRIX benchmark running times of code timethis - run a chunk of code several times timethese - run several chunks of
utime FreeBSD set file times
utime NetBSD set file times
utime OpenBSD set file times
utimes IRIX set file times
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service