Tiempo-Manual Página

Nombre

Tiempo - Ejecutar programas y resumir el uso de recursos del sistema

Sinopsis

tiempo

[ -APQVV ] [ -F FORMATO ] [ -O ARCHIVO ]
[ -adjuntar ] [ -verboso ] [ -tranquilo ] [ -portabilidad ]
[ -formato =FORMATO ] [ -salida =ARCHIVO ] [ -versión ]
[ -ayuda ] DOMINIO [ Argumentos ]

Descripción

tiempo ejecuta el programa DOMINIO con cualquier argumento dados Arg .. . Cuando DOMINIO acabados, tiempo Muestra información sobre los recursos utilizados por DOMINIO (En la salida de error estándar, de forma predeterminada). Si DOMINIO Salidas con un estado distinto de cero, tiempo Muestra un mensaje de advertencia y el estado de salida.

tiempo determina qué información mostrar sobre los recursos utilizados por el DOMINIO de la cuerda FORMATO. Si no se especifica ningún formato en la línea de comando, pero el TIEMPO Se establece la variable de entorno, su valor se utiliza como formato. De lo contrario, un formato predeterminado integrado en tiempo se usa.

Opciones para tiempo debe aparecer en la línea de comando antes DOMINIO. Cualquier cosa en la línea de comando después DOMINIO se pasa como argumentos a DOMINIO.

Opción

-O ARCHIVO, -salida =ARCHIVO

Escriba las estadísticas de uso de recursos para ARCHIVO en lugar de al flujo de error estándar. Por defecto, esto sobrescribe el archivo, destruyendo el contenido anterior del archivo. Esta opción es útil para recopilar información sobre programas y programas interactivos que producen salida en el flujo de error estándar.

-a, -adjuntar

Agregar la información de uso de recursos al archivo de salida en lugar de sobrescribirlo. Esta opción solo es útil con la opción '-o' o '-output'.

-F FORMATO, -formato FORMATO

Usar FORMATO como la cadena de formato que controla la salida de tiempo. Vea la siguiente información más información.

-ayuda

Imprima un resumen de las opciones de línea de comando y salga.

-pag, -portabilidad

Use la siguiente cadena de formato, para conformarse con Posix Standard 1003.2: %E real e
Usuario %u
sys %s

-V, -verboso

Use el formato verboso incorporado, que muestra cada información disponible sobre el uso de recursos del programa en su propia línea, con una descripción en inglés de su significado.

-tranquilo

No informe el estado del programa incluso si es diferente de cero.

-V, -versión

Imprima el número de versión de tiempo y salir.

Formatear la salida

La cadena de formato FORMATO controla el contenido del tiempo producción. La cadena de formato se puede establecer utilizando las opciones '-f' o '-format', '-v' o '-verbose', o '-p' o '-portabilidad'. Si no se les da, sino el TIEMPO Se establece la variable de entorno, su valor se utiliza como cadena de formato. De lo contrario, se utiliza un formato predeterminado incorporado. El formato predeterminado es: %UUSER %ssystem %eelapsed %pcpu ( %xtext+ %ddata %mmax) k
%Iinputs+%Ooutputs (%FMajor+%RMinor) PageFaults%WSWAPS

La cadena de formato generalmente consiste en 'especificadores de recursos' intercalados con texto sin formato. Un signo porcentual ('%') en la cadena de formato hace que el siguiente carácter se interprete como un especificador de recursos, que es similar a los caracteres de formato en el printf(3) función.

Una barra insegura ('\') introduce un 'escape de barra de inactividad', que se traduce en un solo carácter de impresión al salir. '\ t' emite un carácter de pestaña, '\ n' emite una nueva línea y '\\' genera una barra insegura. Una barra insegura seguida de cualquier otro personaje emite un signo de interrogación ('?') Seguido de una barra de inactividad, para indicar que se dio un escape de invernadero no válido.

Otro texto en el formato Stringis copiado textualmente a la salida. tiempo Siempre imprime una nueva línea después de imprimir la información de uso de recursos, por lo que normalmente las cadenas de formato no terminan con un carácter nuevo (o '0).

Hay muchas especificaciones de recursos. No todos los recursos se miden por todas las versiones de Unix, por lo que algunos de los valores podrían informarse como cero. Cualquier personaje que siga un signo porcentual que no figura en la tabla a continuación provoca un signo de interrogación ('?') para ser salido, seguido de ese carácter, para indicar que se dio un especificador de recursos no válido.

Los especificadores de recursos, que son un superconjunto de los reconocidos por el TCSH(1) Comando construido 'tiempo', son:

De %

Un '%' literal.

C

Nombre y argumentos de línea de comando del comando que se cronometra.

D

Tamaño promedio del área de datos no compartidos del proceso, en Kilobytes.

mi

Tiempo real (reloj de pared) transcurrido utilizado por el proceso, en [horas:] minutos: segundos.

F

Número de fallas de página mayores, o de I/O, que ocurrieron mientras el proceso se ejecutaba. Estas son fallas en las que la página realmente ha migrado de la memoria primaria.

I

Número de entradas del sistema de archivos por el proceso.

K

Uso promedio de la memoria total (datos+pila+texto) del proceso, en kilobytes.

METRO

Tamaño máximo de set de residente del proceso durante su vida, en Kilobytes.

O

Número de salidas del sistema de archivos por el proceso.

PAG

Porcentaje de la CPU que consiguió este trabajo. Esto es solo el usuario + tiempos del sistema divididos por el tiempo de ejecución total. También imprime un signo porcentual.

Riñonal

Número de fallas menores o recuperables de página. Estas son páginas que no son válidas (por lo que culpan) pero que aún no han sido reclamadas por otras páginas virtuales. Por lo tanto, los datos en la página siguen siendo válidos, pero las tablas del sistema deben actualizarse.

S

Número total de segundos de CPU utilizados por el sistema en nombre del proceso (en modo núcleo), en segundos.

U

Número total de segundos de CPU que el proceso usó directamente (en modo de usuario), en segundos.

W

Número de veces el proceso se intercambió fuera de la memoria principal.

X

Cantidad promedio de texto compartido en el proceso, en Kilobytes.

Z

Tamaño de página del sistema, en bytes. Esta es una constante por sistema, pero varía entre los sistemas.

C

Número de veces que el proceso fue conmutado por contexto involuntariamente (porque la porción de tiempo expiró).

mi

Tiempo real transcurrido (reloj de pared) utilizado por el proceso, en segundos.

k

Número de señales entregadas al proceso.

pag

Tamaño promedio de la pila no compartida del proceso, en Kilobytes.

riñonal

Número de mensajes de socket recibidos por el proceso.

s

Número de mensajes de socket enviados por el proceso.

T

Tamaño promedio del conjunto de residentes del proceso, en Kilobytes.

w

Número de veces que el programa fue cambiado voluntariamente con el contexto, por ejemplo, mientras esperaba que complete una operación de E/S.

X

Estado de salida del comando.

Ejemplos

Para ejecutar el comando 'wc /etc /hosts' y mostrar la información predeterminada: tiempo wc /etc /hosts

Para ejecutar el comando 'ls -fs' y mostrar solo el usuario, el sistema y el tiempo total: tiempo -f “T%E real, t%u user, t%s sys” ls -fs

Para editar el archivo Bork y tener 'tiempo', agregue el tiempo transcurrido y el número de señales al archivo 'Registro', leyendo la cadena de formato de la variable de entorno 'Tiempo': Export Time = ”T%E, T%K” # Si usa bash o ksh
Setenv Time "T%E, T%K" # si usa CSH o TCSH
TIME -A -O Log Emacs Bork

Usuarios del intento shell debe usar una ruta explícita para ejecutar el externo tiempo comando y no la variante de shell builtin. En el sistema donde tiempo se instala en /usr/bin, El primer ejemplo se convertiría en/usr/bin/time wc/etc/hosts

Exactitud

El tiempo transcurrido no se recopila atómicamente con la ejecución del programa; Como resultado, en circunstancias extrañas (si el tiempo El comando se detiene o se intercambia en el medio cuando el programa que se cronometra sale y cuándo tiempo calcula cuánto tiempo tardó), podría ser mucho más grande que el tiempo de ejecución real.

Cuando el tiempo de ejecución de un comando es casi cero, algunos valores (e.gramo., El porcentaje de CPU utilizado) puede informarse como cero (que está mal) o un signo de interrogación.

La mayoría de la información que se muestra por tiempo se deriva del esperar 3(2) Systemcall. Los números son tan buenos como los devueltos por esperar 3(2) . En sistemas que no tienen un esperar 3(2) Llame a que devuelva la información de estado, el veces(2) La llamada del sistema se usa en su lugar. Sin embargo, proporciona mucha menos información que esperar 3(2), así que en esos sistemas tiempo informa la mayoría de los recursos como cero.

Los valores '%I' y '%O' son supuestamente solo entrada y salida 'reales' y no incluyen los suministrados por dispositivos de almacenamiento en caché. El significado de la E/S 'real' reportada por '%I' y '%O' puede estar confundido para las estaciones de trabajo, especialmente las sin disco.

Diagnóstico

El tiempo El comando devuelve cuando el programa sale, se detiene o se termina con una señal. Si el programa salía normalmente, el valor de retorno de tiempo. De lo contrario, el valor de retorno es 128 más el número de la señal que hizo que el programa se detuviera o rescindiera.

Autor

tiempofue escrito por David Mackenzie. Esta página de Man fue agregada por Dirk Eddelbuettel, el mantenedor de Debian GNU/Linux, para su uso por la distribución de Debian GNU/Linux, pero por supuesto, puede ser utilizado por otros.