4.3BSD - /usr/man/cat3/times.0

TIMES(3C)                                                            TIMES(3C)


NAME
       times - get process times

SYNOPSIS
       #include <sys/types.h>
       #include <sys/times.h>

       times(buffer)
       struct tms *buffer;

DESCRIPTION
       This interface is obsoleted by getrusage(2).

       Times  returns  time-accounting information for the current process and
       for the terminated child processes of the current process.   All  times
       are in 1/HZ seconds, where HZ is 60.

       This is the structure returned by times:

       /* Copyright (C) 1991, 1992, 1996, 1998, 1999 Free Software Foundation, Inc.
          This file is part of the GNU C Library.

          The GNU C Library is free software; you can redistribute it and/or
          modify it under the terms of the GNU Lesser General Public
          License as published by the Free Software Foundation; either
          version 2.1 of the License, or (at your option) any later version.

          The GNU C Library is distributed in the hope that it will be useful,
          but WITHOUT ANY WARRANTY; without even the implied warranty of
          MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
          Lesser General Public License for more details.

          You should have received a copy of the GNU Lesser General Public
          License along with the GNU C Library; if not, write to the Free
          Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
          02111-1307 USA.  */

       /*
        *   POSIX Standard: 4.5.2 Process Times     <sys/times.h>
        */

       #ifndef   _SYS_TIMES_H
       #define   _SYS_TIMES_H   1

       #include <features.h>

       #define   __need_clock_t
       #include <time.h>


       __BEGIN_DECLS

       /* Structure describing CPU time used by a process and its children.  */
       struct tms
         {
           clock_t tms_utime;        /* User CPU time.  */
           clock_t tms_stime;        /* System CPU time.  */

           clock_t tms_cutime;       /* User CPU time of dead children.  */
           clock_t tms_cstime;       /* System CPU time of dead children.  */
         };


       /* Store the CPU time used by this process and all its
          dead children (and their dead children) in BUFFER.
          Return the elapsed real time, or (clock_t) -1 for errors.
          All times are in CLK_TCKths of a second.  */
       extern clock_t times (struct tms *__buffer) __THROW;

       __END_DECLS

       #endif /* sys/times.h    */

       The  children  times  are  the  sum of the children’s process times and
       their children’s times.

SEE ALSO
       time(1), getrusage(2), wait3(2), time(3)


4th Berkeley Distribution         May 9, 1985                        TIMES(3C)