term% cat index.txt TIMES(2) System Calls Manual TIMES(2)
NAME
times - get process times
SYNOPSIS
#include <sys/types.h>
#include <sys/times.h>
times(buffer)
struct tms *buffer;
DESCRIPTION
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 either 50 or 60 depending on your lo‐
cality.
This is the structure returned by times:
/* Copyright (C) 1991-2025 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, see
<https://www.gnu.org/licenses/>. */
/*
* POSIX Standard: 4.5.2 Process Times <sys/times.h>
*/
#ifndef _SYS_TIMES_H
#define _SYS_TIMES_H 1
#include <features.h>
#include <bits/types/clock_t.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), time(2)
TIMES(2)