.\" Copyright Andries Brouwer, 2000
.\"
.\" This page is distributed under GPL.
.\" Some fragments of text came from the time-1.7 info file.
.\" Inspired by kromJx@crosswinds.net.
.\" Translated by Jorge Rodríguez García (A.K.A. Tiriel)(tiriel@users.sourceforge.net
.\"
.TH TIME 1 "11 diciembre 2000" "" ""
.SH NOMBRE
time \- temporiza una orden sencilla o devuelve la utilización de recursos
.SH SINOPSIS
.BI "time [" opciones "] " orden " [" argumentos... "] "
.SH DESCRIPCIóN
La orden
.B time
ejecuta el programa
.I orden
con los argumentos suministrados. Cuando 
.I orden
finaliza,
.B time
escribe un mensaje en la salida estándar devolviendo estadísticas
temporales sobre la ejecución de este programa.
Estas estadísticas están compuestas por (i) el tiempo real transcurrido
entre la llamada y la finalización de 
.I orden ,
(ii) el tiempo de usuario del procesador
(la suma de los valores
.I tms_utime
y
.I tms_cutime
en un
.I "struct tms"
tal y como devuelve
.BR times (2)),
y (iii) el tiempo de sistema del procesador (la suma de los valores
.I  tms_stime
y
.I tms_cstime
en un
.I "struct tms"
tal y como devuelve
.BR times (2)).
.SH OPCIONES
.TP
.B \-p
Cuando se use la localización POSIX, usar el formato tradicional preciso
.br
.in +5
"real %f\enuser %f\ensys %f\en"
.in -5
.br
(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.
.SH ENTORNO
Se utilizan las variables LANG, LC_ALL, LC_CTYPE, LC_MESSAGES, LC_NUMERIC,
NLSPATH y PATH. La última para buscar
.IR orden .
El resto para el texto y el formato de la salida.
.SH "ESTADO DE SALIDA"
Si se invocó 
.I orden
, el estado de salida será el de 
.IR orden .
En otro caso, es 127 si
.I 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.
.SH "VÉASE TAMBIÉN"
.BR times (2),
.sp 2
.SH "VERSIÓN GNU"
A continuación, una descripción de la versión 1.7 de GNU de
.BR 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.
.LP
La cadena de formato por defecto es
.br
.in +3
%Uusuario %Ssistema %Etranscurrido %PCPU (%Xtexto+%Ddatos %Mmax)k
.br
%Ientradas+%Osalidas (%Fprincipal+%Rmenor)faltas de página %Wintercambios
.br
.in -3
.LP
Cuando se indica la opción \-p, se usa el formato de salida transportable
.br
.in +3
real %e
.br
user %U
.br
sys %S
.br
.in -3
.SS "La cadena de formato"
El formato se interpreta en el modo usual de printf.
Los caracteres habituales se copian directamente, tabulación,
nueva línea y barra invertida se escapan usando \et, \en y \e\e,
el signo de porcentaje se representa por %%, y de otra manera %
indica una conversión. El programa
.B time
añadirá siempre una línea final.
A continuación se presentan las conversiones. Todas las utilizadas por
.BR tcsh (1)
están respaldadas
.LP
.B "Tiempo"
.TP
.B %E
Tiempo real transcurrido (en [horas:]minutos:segundos).
.TP
.B %e
(No aparece en tcsh.) Tiempo real transcurrido (en segundos).
.TP
.B %S
Número total de segundos de CPU que el proceso consumió en modo de núcleo.
.TP
.B %U
Número total de segundos de CPU que el proceso consumió en modo de usuario.
.TP
.B %P
Porcentaje de CPU que recibió este trabajo, calculado como (%U + %S) / %E.
.LP
.B "Memoria"
.TP
.B %M
Conjunto máximo residente del proceso durante su tiempo de vida, en KBytes.
.TP
.B %t
(No aparece en tsch.) Tamaño aproximado del conjunto residente del proceso, en KBytes.
.TP
.B %K
Uso de memoria total aproximado (datos+pila+texto) del proceso, en KBytes.
.TP
.B %D
Tamaño aproximado del área de datos no compartida del proceso, en KBytes.
.TP
.B %p
(No aparece en tsch.) Tamaño aproximado del espacio de pila no compartido del proceso,
en KBytes.
.TP
.B %X
Tamaño aproximado del espacio de texto compartido del proceso, en KBytes.
.TP
.B %Z
(No aparece en tsch.) Tamaño de página del sistema, en KBytes.
Esto es una constante del sistema, pero varía entre un sistema y otro.
.TP
.B %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.
.TP
.B %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.
.TP
.B %W
Número de veces que el proceso fue intercambiado hacia afuera de la memoria principal.
.TP
.B %c
Número de veces que el proceso fue intercambiado de contexto involuntariamente
(porque finalizase la porción de tiempo).
.TP
.B %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.
.LP
.B "E/S"
.TP
.B %I
Número de entradas al sistema de archivos por el proceso.
.TP
.B %O
Número de salidas al sistema de archivos por el proceso.
.TP
.B %r
Número de mensajes de conexión recibidos por el proceso.
.TP
.B %s
Número de mensajes de conexión enviados por el proceso.
.TP
.B %k
Número de señales entregadas al proceso.
.TP
.B %C
(No aparece en tcsh.) Nombre y argumentos en línea de órdenes de la orden temporizada.
.TP
.B %x
(No aparece en tcsh.) Estado de salida de la orden.
.SH "OPCIONES GNU"
.TP
.BI "\-f " FORMATO ", \-\-format=" FORMATO
Especificar el formato de salida, posiblemente redefiniendo el formato
especificado en la variable de entorno TIME.
.TP
.B "\-p, \-\-portability"
Usar el formato de salida transportable.
.TP
.BI "\-o " FICHERO ", \-\-output=" FICHERO
No enviar los resultados a stderr, sino sobreescribir el fichero especificado.
.TP
.B "\-a, \-\-append"
(Usado en conjunción con \-o.) No sobreescribir, sino añadir al final.
.TP
.B "\-v, \-\-verbose"
Ofrece una salida detallada sobre todo lo que el programa conoce.
.SH "OPCIONES GNU ESTÁNDAR"
.TP
.B "\-\-help"
Imprime un mensaje de uso en la salida estándar y termina satisfactoriamente.
.TP
.B "\-V, \-\-version"
Imprime la información sobre la versión en la salida estándar y termina satisfactoriamente.
.TP
.B "\-\-"
Terminar la lista de opciones.
.SH FALLOS
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.
.LP
La versión 1.7 de GNU de time aún no está localizada.
De modo que no implementa los requisitos de POSIX.
.LP
La variable de entorno TIME no fue elegida correctamente.
No es inusual en sistemas como autoconf o make 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.
.LP
Parece desafortunado que \-o sobreescriba en lugar de añadir al final.
(Esto es, la opción por defecto debería ser \-a.)
.LP
Sugerencias por correo e informe de fallos de
.B time
de GNU a
.br
.I bug-utils@prep.ai.mit.edu
.br
Por favor, incluyase la versión de
.B time ,
que puedes obtener ejecutando
.br
.I time --version
.br
y el sistema operativo
y el compilador de C utilizado.
.SH "VÉASE TAMBIÉN"
.BR tcsh (1),
.BR times (2),
.BR wait3 (2)
.SH AUTORES
.TP
.IP "David Keppel"
Versión original
.IP "David MacKenzie"
POSIXización, autoconfiscación, GNU getoptización,
documentación, otras correciones de fallos y mejoras.
.IP "Arne Henrik Juul"
Ayudó a la portabilidad
.IP "Francois Pinard"
Ayudó a la portabilidad
.IP "Jorge Rodríguez (A.K.A. Tiriel)"
Realizó la traducción de la versión 1.55