times(2)

NOMBRE
times - obtiene los tiempos del proceso

BIBLIOTECA
Biblioteca Estándar C (libc, -lc)

SINOPSIS
#include <sys/times.h>

clock_t times(struct tms *buf);

DESCRIPCIÓN
times() almacena los tiempos del proceso en curso en la estructura tms a la que apunta buf. La estructura tms es tal como se define en <sys/times.h>:

    struct tms {
        clock_t tms_utime;  /* tiempo de usuario */
        clock_t tms_stime;  /* tiempo de sistema */
        clock_t tms_cutime; /* tiempo de usuario de los hijos */
        clock_t tms_cstime; /* tiempo de sistema de los hijos */
    };

El campo tms_utime contiene el tiempo de CPU empleado en la ejecución de instrucciones del proceso invocador. El campo tms_stime contiene el tiempo de CPU empleado en el sistema mientras se ejecutan tareas en nombre del proceso invocador.

El campo tms_cutime contiene la suma de los valores tms_utime y tms_cutime de todos los hijos terminados a los que se esperó. El campo tms_cstime contiene la suma de los valores tms_stime y tms_cstime de todos los hijos terminados a los que se esperó.

Los tiempos para los hijos terminados (y sus descendientes) son añadidos en el momento en el que wait(2) o waitpid(2) devuelve su identificador de proceso. En particular, los tiempos de los "nietos" a los que los hijos no esperaron no son procesados.

Todos los tiempos informados se dan en ticks de reloj.

VALOR DEVUELTO
times() returns the number of clock ticks that have elapsed since an arbitrary point in the past. The return value may overflow the possible range of type clock_t. On error, (clock_t) -1 is returned, and errno is set to indicate the error.

ERRORES

EFAULT
    tms apunta fuera del espacio de direcciones asignado al proceso.

ESTÁNDARES
POSIX.1-2001, POSIX.1-2008, SVr4, 4.3BSD.

NOTAS
El número de ticks de reloj por segundo puede obtenerse usando:

    sysconf(_SC_CLK_TCK);

En POSIX.1-1996 el símbolo CLK_TCK (definido en <time.h>) se menciona como obsoleto. Está obsoleto en la actualidad.

Before Linux 2.6.9, if the disposition of SIGCHLD is set to SIG_IGN, then the times of terminated children are automatically included in the tms_cstime and tms_cutime fields, although POSIX.1-2001 says that this should happen only if the calling process wait(2)s on its children. This nonconformance is rectified in Linux 2.6.9 and later.

On Linux, the buf argument can be specified as NULL, with the result that times() just returns a function result. However, POSIX does not specify this behavior, and most other UNIX implementations require a non-NULL value for buf.

Note that clock(3) also returns a value of type clock_t, but this value is measured in units of CLOCKS_PER_SEC, not the clock ticks used by times().

On Linux, the “arbitrary point in the past” from which the return value of times() is measured has varied across kernel versions. On Linux 2.4 and earlier, this point is the moment the system was booted. Since Linux 2.6, this point is (2^32/HZ) - 300 seconds before system boot time. This variability across kernel versions (and across UNIX implementations), combined with the fact that the returned value may overflow the range of clock_t, means that a portable application would be wise to avoid using this value. To measure changes in elapsed time, use clock_gettime(2) instead.

  Histórico
SVr1-3 devuelve long y los miembros de la estructura son de tipo time_t aunque almacenan ticks de reloj, no segundos desde la época. V7 usaba long para los miembros de la estructura, porque no disponía del tipo time_t todavía.

ERRORES
A limitation of the Linux system call conventions on some architectures (notably i386) means that on Linux 2.6 there is a small time window (41 seconds) soon after boot when times() can return -1, falsely indicating that an error occurred. The same problem can occur when the return value wraps past the maximum value that can be stored in clock_t.

VÉASE TAMBIÉN
time(1), getrusage(2), wait(2), clock(3), sysconf(3), time(7)

TRADUCCIÓN
La traducción al español de esta página del manual fue creada por Gerardo Aburruzaga García <gerardo.aburruzaga@uca.es> y Miguel Pérez Ibars <mpi79470@alu.um.es>

Esta traducción es documentación libre; lea la GNU General Public License Version 3 (https://www.gnu.org/licenses/gpl-3.0.html) o posterior con respecto a las condiciones de copyright. No existe NINGUNA RESPONSABILIDAD.

Si encuentra algún error en la traducción de esta página del manual, envíe un correo electrónico a debian-l10n-spanish@lists.debian.org.