NOMBRE

       times - obtiene los tiempos del proceso

SINOPSIS

       #include <sys/times.h>

       clock_t times(struct tms *buf);

DESCRIPCIÓN

       La funció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

       La  función times devuelve el número de ticks de reloj que han transcurrido desde un punto
       arbitrario del pasado. Para Linux este punto es el momento en que se arrancó  el  sistema.
       Este  valor  devuelto  puede  desbordar  por arriba el rango del tipo clock_t.  En caso de
       error, se devuelve (clock_t) -1, y se modifica errno con el valor apropiado.

OBSERVACIONES

       El número de ticks de reloj por segundo puede obtenerse usando
              sysconf(_SC_CLK_TCK);
       En POSIX-1996 el símbolo CLK_TCK (definido en <time.h>) se menciona  como  obsoleto.  Está
       obsoleto en la actualidad.

       En Linux, si la señal SIGCHLD se trata con SIG_IGN los tiempos de los hijos terminados son
       incluidos automáticamente en los campos tms_cstime y tms_cutime , aunque POSIX 1003.1-2001
       dice  que  ésto  sólo  debería  ocurrir  si el proceso invocador realiza wait()s sobre sus
       hijos.

       Observe que clock(3) devuelve valores de tipo clock_t que no están  medidos  en  ticks  de
       reloj, sino en CLOCKS_PER_SEC.

CONFORME A

       SVr4, SVID, POSIX, X/OPEN, BSD 4.3

NOTAS HISTÓRICAS

       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.

       En  sistemas  más  antiguos  el  número  de  ticks  de reloj por segundo viene dado por la
       variable HZ.

VÉASE TAMBIÉN

       time(1), getrusage(2), wait(2), clock(3), sysconf(3)