time

TIME(1)                    Manual de Usuario de Linux                    TIME(1)



NOMBRE
       time - temporiza una orden sencilla o devuelve la utilización de recursos

SINOPSIS
       time .RI [ opciones ] orden [ argumentos... ]

DESCRIPCIÓN
       La orden time ejecuta el programa orden con los argumentos dados. Una vez
       que orden termina, time escribe un mensaje en la salida de error estándar
       con información acerca de la ejecución de dicho programa. Ésta
       información consta de (i) el tiempo real transcurrido entre la llamada y
       la finalización de orden,  (ii) el tiempo de usuario del procesador
       empleado (la suma de los valores tms_utime y tms_cutime en un struct tms
       tal y como lo da times(2)), y (iii) el tiempo de sistema del procesador
       (la suma de los valores tms_stime y tms_cstime en un struct tms tal y
       como lo da times(2)).

       Observación: algunas shells (por ejemplo bash(1)) incorporan una orden
       time que suele realizar aproximadamente la misma función. Si desea
       acceder a esta orden en concreto, tendrá que especificar su ruta completa
       (seguramente /usr/bin/time).

OPCIONES
       -p     Cuando se use la localización POSIX, usar el formato tradicional
              preciso

                  "real %f\nuser %f\nsys %f\n"

              (con números en segundos)  donde el número de decimales en la
              salida de %f está sin especificar pero es suficiente para expresar
              la precisión del flanco de reloj, y al menos uno.

ESTADO DE SALIDA
       Si se invocó orden , el estado de salida será el de orden.  En otro caso,
       es 127 si orden no se pudo encontrar, 126 si se pudo encontrar pero no
       pudo invocarse, y algún otro valor distinto de cero (1–125) si ocurrió
       algun otro error.

ENTORNO
       Las variables LANG, LC_ALL, LC_CTYPE, LC_MESSAGES, LC_NUMERIC y NLSPATH
       se usan para dar forma a la salida.  PATH se usa para buscar una orden.
       El resto se usan para el texto y para dar forma a la información que da
       en programa.

VERSIÓN GNU
       A continuación, una descripción de la versión 1.7 de GNU de time.  A
       pesar del nombre de la utilidad, GNU hace que devuelva gran cantidad de
       información útil, no sólo sobre el tiempo utilizado, sino además sobre
       otros recursos como memoria, llamadas E/S o IPC (si están disponibles).
       La salida se formatea utilizando una cadena de formato que se puede
       especificar utilizando la opción -f o la variable de entorno TIME.

       La cadena de formato por defecto es:

           %Uuser %Ssystem %Eelapsed %PCPU (%Xtext+%Ddata %Mmax)k
           %Iinputs+%Ooutputs (%Fmajor+%Rminor)pagefaults %Wswaps

       Cuando se indica la opción -p, se usa el formato de salida portable:

           real %e
           user %U
           sys %S

   La cadena de formato
       El formato se interpreta de igual modo que de printf.  Los caracteres
       habituales se copian directamente mientras que tabulación, nueva línea y
       barra invertida se escapan usando \t, \n y \\, el signo de porcentaje se
       representa por %%, % indica una conversión. El programa time añadirá
       siempre una línea final.  A continuación se presentan las conversiones.
       Es posible el uso de cualquiera de las que emplea tcsh(1).

       Time

       %E     Tiempo real transcurrido (en [horas:]minutos:segundos).

       %e     (No aparece en tcsh(1).) Tiempo real transcurrido (en segundos).

       %S     Número total de segundos de CPU que el proceso consumió en modo de
              núcleo.

       %U     Número total de segundos de CPU que el proceso consumió en modo de
              usuario.

       %P     Porcentaje de CPU que recibió este trabajo, calculado como (%U +
              %S) / %E.

       Memory

       %M     Conjunto máximo residente del proceso durante su tiempo de vida,
              en KBytes.

       %t     (No aparece en tcsh(1).) Tamaño aproximado del conjunto residente
              del proceso, en KBytes.

       %K     Uso de memoria total aproximado (datos+pila+texto) del proceso, en
              KBytes.

       %D     Tamaño aproximado del área de datos no compartida del proceso, en
              KBytes.

       %p     (No aparece en tcsh(1).) Tamaño aproximado del espacio de pila no
              compartido del proceso, en KBytes.

       %X     Tamaño aproximado del espacio de texto compartido del proceso, en
              KBytes.

       %Z     (No aparece en tcsh(1).) Tamaño de página del sistema, en KBytes.
              Esto es una constante del sistema, pero varía entre un sistema y
              otro.

       %F     Número de faltas de página principales, que ocurrieron mientras el
              proceso se ejecutaba.  Estas son faltas en las que la página debe
              ser leída desde disco.

       %R     Número de faltas de página menores o recuperables.  Estas son
              faltas para páginas que no son válidas pero que no han sido
              reclamadas aún por otras páginas virtuales. De este modo, los
              datos en la página son todavía válidos, pero las tablas de sistema
              deben actualizarse.

       %W     Número de veces que el proceso fue intercambiado hacia afuera de
              la memoria principal.

       %c     Número de veces que el proceso fue intercambiado de contexto
              involuntariamente (porque finalizase la porción de tiempo).

       %w     Número de esperas: veces que el programa fue intercambiado de
              contexto voluntariamente, por ejemplo, mientras se espera a que se
              complete una operación de E/S.

       E/S

       %I     Número de entradas al sistema de archivos por el proceso.

       %O     Número de salidas al sistema de archivos por el proceso.

       %r     Número de mensajes de conexión recibidos por el proceso.

       %s     Número de mensajes de conexión enviados por el proceso.

       %k     Número de señales entregadas al proceso.

       %C     (No aparece en tcsh(1).) Nombre y argumentos en línea de órdenes
              de la orden temporizada.

       %x     (No aparece en tcsh(1).) Estado de salida de la orden.

   Opciones de GNU
       -f formato, --format=formato
              Especificar el formato de salida, posiblemente redefiniendo el
              formato especificado en la variable de entorno TIME.

       -p, --portability
              Usar el formato de salida transportable.

       -o archivo, --output=archivo
              No enviar los resultados a stderr, sino sobreescribir el fichero
              especificado.

       -a, --append
              (Usado en conjunción con -o.) No sobreescribir, sino añadir al
              final.

       -v, --verbose
              Ofrece una salida detallada sobre todo lo que el programa conoce.

       -q, --quiet
              No informa de un final inesperado del programa (cuando orden
              finaliza al recibir una señal) o con un estdo de salida distinto
              de cero.

   Opciones estándar de GNU
       --help Muestra un mensaje en la salida estándar sobre el modo de empleo y
              acaba con código de éxito.

       -V, --version
              Muestra en la salida estándar información sobre la versión, y
              luego acaba con código de éxito.

       --     Termina la lista de opciones.

ERRORES
       No todos los recursos son medidos por todas las versiones de UNIX, de
       modo que algunos valores pueden ser devueltos como cero.  La selección
       presente fue mayormente inspirada por los datos suministrados por 4.2 o
       4.3BSD.

       La versión 1.7 de GNU de time aún no está localizada.  De modo que no
       implementa los requisitos de POSIX.

       La variable de entorno TIME no fue elegida correctamente.  No es inusual
       en sistemas como autoconf(1) o make(1) usar variables de entorno con el
       nombre de una utilidad para reemplazar la utilidad a usar. Usos como MORE
       o TIME para opciones a programas (en lugar de nombres de ruta a
       programas) tiende a llevar a dificultades.

       Parece desafortunado que -o sobreescriba en lugar de añadir al final.
       (Esto es, la opción por defecto debería ser -a.)

       Para comunicar sugerencias o errores en time, diríjase a
       bug-time@gnu.org. Indique la versión de time ejecutando

           time --version

       y el sistema operativo y el compilador de C utilizado.

VÉASE TAMBIÉN
       bash(1), tcsh(1), times(2), wait3(2)

COLOFÓN
       Esta página es parte de la versión 5.10 del proyecto Linux man-pages.
       Puede encontrar una descripción del proyecto, información sobre cómo
       informar errores y la última versión de esta página en
       https://www.kernel.org/doc/man-pages/.


TRADUCCIÓN
       La traducción al español de esta página del manual fue creada por Jorge
       Rodriguez (A.K.A. Tiriel) <tiriel@users.sourceforge.net> y Marcos Fouces
       <marcos@debian.org>

       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>.  ⟨⟩.



                                  6 Marzo 2019                           TIME(1)