time(1) General Commands Manual time(1) NOMBRE time - temporiza una orden sencilla o devuelve la utilizacion de recursos SINOPSIS time [opcion ...] orden [argumento ...] DESCRIPCION 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 estandar con informacion acerca de la ejecucion de dicho programa. Esta informacion consta de (i) el tiempo real transcurrido entre la llamada y la finalizacion 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)). Observacion: algunas shells (por ejemplo bash(1)) incorporan una orden time que suele realizar aproximadamente la misma funcion. Si desea acceder a esta orden en concreto, tendra que especificar su ruta completa (seguramente /usr/bin/time). OPCIONES -p Cuando se use la localizacion POSIX, usar el formato tradicional preciso "real %f\nuser %f\nsys %f\n" (con numeros en segundos) donde el numero de decimales en la salida de %f esta sin especificar pero es suficiente para expresar la precision del flanco de reloj, y al menos uno. ESTADO DE SALIDA Si se invoco orden , el estado de salida sera el de orden. En otro caso, sera 127 si orden no se pudo encontrar, 126 si se pudo encontrar pero no pudo invocarse, y algun otro valor distinto de cero (1-125) si ocurrio 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. VERSION GNU A continuacion, una descripcion de la version 1.7 de GNU de time. A pesar del nombre de la utilidad, GNU hace que devuelva gran cantidad de informacion util, no solo sobre el tiempo utilizado, sino ademas sobre otros recursos como memoria, llamadas E/S o IPC (si estan disponibles). La salida se formatea utilizando una cadena de formato que se puede especificar utilizando la opcion -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 opcion -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 con printf. Los caracteres habituales se copian directamente mientras que las tabulaciones, nuevas lineas y barras invertidas se escapan usando \t, \n y \\, el signo de porcentaje se representa mediante %%, % indica una conversion. El programa time anadira siempre una linea vacia final. A continuacion 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 Numero total de segundos de CPU que el proceso consumio en modo de nucleo. %U Numero total de segundos de CPU que el proceso consumio en modo de usuario. %P Porcentaje de CPU que recibio este trabajo, calculado como (%U + %S) / %E. Memory %M Conjunto maximo residente del proceso durante su tiempo de vida, en KBytes. %t (No aparece en tcsh(1).) Tamano aproximado del conjunto residente del proceso, en KBytes. %K Uso de memoria total aproximado (datos+pila+texto) del proceso, en KBytes. %D Tamano aproximado del area de datos no compartida del proceso, en KBytes. %p (No aparece en tcsh(1).) Tamano aproximado del espacio de pila no compartido del proceso, en KBytes. %X Tamano aproximado del espacio de texto compartido del proceso, en KBytes. %Z (No aparece en tcsh(1).) Tamano de pagina del sistema, en KBytes. Esto es una constante del sistema, pero varia entre un sistema y otro. %F Numero de faltas de pagina principales, que ocurrieron mientras el proceso se ejecutaba. Estas son faltas en las que la pagina debe ser leida desde disco. %R Numero de faltas de pagina menores o recuperables. Estas son faltas para paginas que no son validas pero que no han sido reclamadas aun por otras paginas virtuales. De este modo, los datos en la pagina son todavia validos, pero las tablas de sistema deben actualizarse. %W Numero de veces que el proceso fue intercambiado hacia afuera de la memoria principal. %c Numero de veces que el proceso fue intercambiado de contexto involuntariamente (porque finalizase la porcion de tiempo). %w Numero de esperas: veces que el programa fue intercambiado de contexto voluntariamente, por ejemplo, mientras se espera a que se complete una operacion de E/S. E/S %I Numero de entradas al sistema de archivos por el proceso. %O Numero de salidas al sistema de archivos por el proceso. %r Numero de mensajes de conexion recibidos por el proceso. %s Numero de mensajes de conexion enviados por el proceso. %k Numero de senales entregadas al proceso. %C (No aparece en tcsh(1).) Nombre y argumentos en linea de ordenes 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 conjuncion con -o.) No sobreescribir, sino anadir 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 senal) o con un estdo de salida distinto de cero. Opciones estandar de GNU --help Muestra un mensaje en la salida estandar sobre el modo de empleo y acaba con codigo de exito. -V, --version Muestra en la salida estandar informacion sobre la version, y luego acaba con codigo de exito. -- 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 seleccion presente fue mayormente inspirada por los datos suministrados por 4.2 o 4.3BSD. La version 1.7 de GNU de time aun no esta 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 anadir al final. (Esto es, la opcion por defecto deberia ser -a.) Para comunicar sugerencias o errores en time, dirijase a bug-time@gnu.org. Indique la version de time ejecutando time --version y el sistema operativo y el compilador de C utilizado. VEASE TAMBIEN bash(1), tcsh(1), times(2), wait3(2) TRADUCCION La traduccion al espanol de esta pagina del manual fue creada por Jorge Rodriguez (A.K.A. Tiriel) y Marcos Fouces Esta traduccion es documentacion libre; lea la GNU General Public License Version 3 o posterior con respecto a las condiciones de copyright. No existe NINGUNA RESPONSABILIDAD. Si encuentra algun error en la traduccion de esta pagina del manual, envie un correo electronico a . Paginas de manual de Linux 6.06 31 Octubre 2023 time(1)