tempo- (1) página manual

tempo- (1) página manual

Nome

Tempo - Execute programas e resuma o uso de recursos do sistema

Sinopse

tempo
[[ -apqvv ] [ -f FORMATAR ] [ -o ARQUIVO ]
[[ -acrescentar ] [ -detalhado ] [ -quieto ] [ -Portabilidade ]
[[ -formato =FORMATAR ] [ -saída =ARQUIVO ] [ -versão ]
[[ -ajuda ] COMANDO [[ Args ]

Descrição

tempo execute o programa COMANDO com qualquer argumento Arg .. . Quando COMANDO acabamentos, tempo exibe informações sobre os recursos usados ​​por COMANDO (Na saída de erro padrão, por padrão). Se COMANDO saídas com status diferente de zero, tempo exibe uma mensagem de aviso e o status de saída.

tempo determina quais informações exibirem sobre os recursos usados ​​pelo COMANDO da string FORMATAR. Se nenhum formato for especificado na linha de comando, mas o TEMPO A variável de ambiente é definida, seu valor é usado como formato. Caso contrário, um formato padrão incorporado em tempo é usado.

Opções para tempo deve aparecer na linha de comando antes COMANDO. Qualquer coisa na linha de comando depois COMANDO é passado como argumentos para COMANDO.

Opções

-o ARQUIVO, -saída =ARQUIVO
Escreva as estatísticas de uso de recursos para ARQUIVO Em vez de para o fluxo de erro padrão. Por padrão, isso substitui o arquivo, destruindo o conteúdo anterior do arquivo. Esta opção é útil para coletar informações sobre programas e programas interativos que produzem saída no fluxo de erro padrão.
-a, -acrescentar
Anexar o recurso Use as informações ao arquivo de saída em vez de substituí -las. Esta opção é útil apenas com a opção '-o' ou '-Output'.
-f FORMATAR, -formatar FORMATAR
Usar FORMATAR como a sequência de formato que controla a saída de tempo. Veja as mais informações abaixo.
-ajuda
Imprima um resumo das opções da linha de comando e saia.
-p, -Portabilidade
Use a seguinte sequência de formato, para conformidade com o Posix Standard 1003.2: Real %e
Usuário %u
Sys %s
-v, -detalhado
Use o formato detalhado embutido, que exibe cada informação disponível sobre o uso de recursos do programa em sua própria linha, com uma descrição em inglês de seu significado.
-quieto
Não relate o status do programa, mesmo que seja diferente de zero.
-V, -versão
Imprima o número da versão de tempo e saída.

Formatando a saída

A sequência do formato FORMATAR controla o conteúdo do tempo saída. A sequência do formato pode ser definida usando as opções '-f' ou '-format', '-v' ou '-verbose' ou '-p' ou '-portability'. Se eles não são dados, mas o TEMPO A variável de ambiente é definida, seu valor é usado como a sequência de formato. Caso contrário, um formato padrão embutido é usado. O formato padrão é: %UUSER %SSYSTEM %Eelapsed %PCPU ( %xText+ %ddata %mmax) K)
%Iinputs+%ooutputs (%fmajor+%rMinor) PageFaults%wswaps

A sequência do formato geralmente consiste em 'especificadores de recursos' intercalados com texto simples. Um sinal percentual ('%') na sequência do formato faz com que o seguinte personagem seja interpretado como um especificador de recursos, que é semelhante aos caracteres formatados no printf(3) função.

Uma barra de barriga ('\') apresenta um 'backslash Escape', que é traduzido em um único personagem de impressão após a saída. '\ t' produz um caractere de guia, '\ n' produz uma nova linha e '\\' produz uma barra de barragem. Uma barra de barriga seguida de qualquer outro personagem que gera um ponto de interrogação ('?') Seguido por uma barra de barriga, para indicar que uma fuga inválida de barra.

Outro texto no formato stringis copiado literalmente para a saída. tempo Sempre imprime uma nova linha depois de imprimir as informações de uso do recurso; portanto, normalmente as seqüências de strings de formato não terminam com um personagem de nova linha (ou '0).

Existem muitas especificações de recursos. Nem todos os recursos são medidos por todas as versões do UNIX; portanto, alguns dos valores podem ser relatados como zero. Qualquer personagem após um sinal percentual que não está listado na tabela abaixo causa um ponto de interrogação ('?') ser produzido, seguido por esse personagem, para indicar que um especificador de recursos inválidos foi dado.

Os especificadores de recursos, que são um superconjunto dos reconhecidos pelo TCSH(1) Comando construído 'tempo', são:

%
Um '%' literal.
C
Nome e linha de comando argumentos do comando sendo cronometrados.
D
Tamanho médio da área de dados não compartilhada do processo, em Kilobytes.
E
Real decorrido (relógio de parede) tempo usado pelo processo, em [horas:] minutos: segundos.
F
Número de maiores, ou falhas de página de E/O, que ocorreram enquanto o processo estava em execução. Essas são falhas em que a página realmente migrou da memória primária.
EU
Número de entradas do sistema de arquivos pelo processo.
K
Total médio (dados+pilha+texto) uso de memória do processo, em kilobytes.
M
Tamanho máximo do conjunto residente do processo durante sua vida, em Kilobytes.
O
Número de saídas do sistema de arquivos pelo processo.
P
Porcentagem da CPU que este trabalho conseguiu. Este é apenas o usuário + os tempos do sistema divididos pelo tempo total de execução. Ele também imprime um sinal percentual.
R
Número de falhas de página menores ou recuperáveis. Essas são páginas que não são válidas (então culpam), mas que ainda não foram reivindicadas por outras páginas virtuais. Assim, os dados na página ainda são válidos, mas as tabelas do sistema devem ser atualizadas.
S
Número total de segundos de CPU usados ​​pelo sistema em nome do processo (no modo kernel), em segundos.
você
Número total de segundos de CPU que o processo usou diretamente (no modo de usuário), em segundos.
C
Número de vezes o processo foi trocado da memória principal.
X
Quantidade média de texto compartilhado no processo, em Kilobytes.
Z
Tamanho da página do sistema, em bytes. Esta é uma constante por sistema, mas varia entre os sistemas.
c
Número de vezes que o processo foi comutado por contexto involuntariamente (porque a fatia de tempo expirou).
e
Real decorrido (relógio de parede) tempo usado pelo processo, em segundos.
k
Número de sinais entregues ao processo.
p
Tamanho médio da pilha não compartilhada do processo, em Kilobytes.
r
Número de mensagens de soquete recebidas pelo processo.
s
Número de mensagens de soquete enviadas pelo processo.
t
Tamanho médio do conjunto residente do processo, em Kilobytes.
c
Número de vezes que o programa foi alterado voluntariamente, por exemplo, enquanto esperava que uma operação de E/S seja concluída.
x
Saída do status do comando.

Exemplos

Para executar o comando 'wc /etc /hosts' e mostrar as informações padrão: time wc /etc /hosts

Para executar o comando 'ls -fs' e mostrar apenas o usuário, o sistema e o tempo total: tempo -f “T%e real, T%U Usuário, T%S Sys” LS -FS

Para editar o arquivo Bork e ter 'tempo', anexar o tempo e o número de sinais decorridos ao arquivo 'log', lendo a sequência de formato da variável de ambiente 'tempo': exportar tempo = ”t%e, t%k” # Se estiver usando Bash ou Ksh
tempo setenv “t%e, t%k” # se estiver usando csh ou tcsh
tempo -a -o log emacs bork

Usuários do Bash a shell precisa usar um caminho explícito para executar o externo tempo comando e não a variante construída por concha. No sistema onde tempo está instalado em /usr/bin, O primeiro exemplo se tornaria/usr/bin/time wc/etc/hosts

Precisão

O tempo decorrido não é coletado atomicamente com a execução do programa; como resultado, em circunstâncias bizarras (se o tempo O comando é interrompido ou trocado no meio quando o programa está sendo cronometrado sai e quando tempo calcula quanto tempo levou para correr), pode ser muito maior que o tempo real de execução.

Quando o tempo de execução de um comando é quase zero, alguns valores (e.g., a porcentagem de CPU usada) pode ser relatada como zero (que está errado) ou um ponto de interrogação.

A maioria das informações mostradas por tempo é derivado do espera3(2) SystemCall. Os números são tão bons quanto os devolvidos por espera3(2) . Em sistemas que não têm um espera3(2) Ligue para que retorne informações de status, o vezes(2) a chamada do sistema é usada em vez disso. No entanto, fornece muito menos informações do que espera3(2), então nesses sistemas tempo relata a maioria dos recursos como zero.

Os valores de '%i' e '%o' são supostamente de entrada e saída 'reais' e não incluem aqueles fornecidos por dispositivos de cache. O significado de E/S 'real' relatada por '%i' e '%O' pode estar confusa para estações de trabalho, especialmente as sem disco.

Diagnóstico

O tempo O comando retorna quando o programa sai, para ou é encerrado por um sinal. Se o programa saiu normalmente, o valor de retorno de tempoé o valor de retorno do programa que ele executou e mediu. Caso contrário, o valor de retorno é 128 mais o número do sinal que fez o programa parar ou terminar.

Autor

tempofoi escrito por David Mackenzie. Esta página do homem foi adicionada por Dirk Eddelbuettel, o mantenedor do Debian GNU/Linux, para uso pela distribuição Debian GNU/Linux, mas pode ser usada, obviamente, por outros.

Tutoriais do Linux relacionados:

  • Como definir a data e a hora no Almalinux
  • Comandos Linux: os 20 comandos mais importantes que você precisa para…
  • Comandos básicos do Linux
  • Como mudar o tempo no Kali Linux
  • Uma introdução à automação, ferramentas e técnicas do Linux
  • Como lançar processos externos com Python e…
  • Como definir/alterar o fuso horário no Almalinux
  • Como usar o comando de tempo no Linux
  • Comando de homem no Linux com exemplos
  • Exemplos de uma linha do Linux Complex Bash