Provided by: manpages-es_1.55-10_all bug

NOMBRE

       times - obtiene los tiempos del proceso

SINOPSIS

       #include <sys/times.h>

       clock_t times(struct tms *buf);

DESCRIPCI'ON

       La  funcion  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 ejecucion
       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 espero.  El campo tms_cstime contiene la  suma  de  los  valores
       tms_stime  y  tms_cstime  de  todos  los  hijos terminados a los que se
       espero.

       Los tiempos  para  los  hijos  terminados  (y  sus  descendientes)  son
       anadidos  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  funcion  times  devuelve  el  numero  de  ticks  de  reloj  que han
       transcurrido desde un punto arbitrario  del  pasado.  Para  Linux  este
       punto  es el momento en que se arranco 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 numero de ticks de reloj por segundo puede obtenerse usando
              sysconf(_SC_CLK_TCK);
       En POSIX-1996 el simbolo CLK_TCK (definido  en  <time.h>)  se  menciona
       como obsoleto. Esta obsoleto en la actualidad.

       En  Linux,  si la senal SIGCHLD se trata con SIG_IGN los tiempos de los
       hijos terminados son incluidos automaticamente en los campos tms_cstime
       y  tms_cutime  ,  aunque  POSIX  1003.1-2001 dice que esto solo deberia
       ocurrir si el proceso invocador realiza wait()s sobre sus hijos.

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

CONFORME A

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

NOTAS HIST'ORICAS

       SVr1-3 devuelve long y los miembros de la estructura son de tipo time_t
       aunque almacenan ticks de reloj, no segundos desde la epoca.  V7  usaba
       long  para  los  miembros de la estructura, porque no disponia del tipo
       time_t todavia.

       En sistemas mas antiguos el numero de ticks de reloj por segundo  viene
       dado por la variable HZ.

V'EASE TAMBI'EN

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