timeout - execute um comando com um limite de tempo
SINTAXE
timeout [OPÇÃO] DURAÇÃO COMANDO [ARG]...
timeout [OPÇÃO]
DESCRIÇÃO
Inicia o COMANDO e o encerra se ainda estiver em execução após a DURAÇÃO.
Os argumentos obrigatórios para opções longas também são obrigatórios para opções curtas.
-f, --foreground
quando não estiver executando timeout diretamente a partir de um prompt de shell, permite que o COMANDO leia do TTY
e receba sinais do TTY; neste modo, os processos filhos do COMANDO não serão encerrados por tempo limite
-k, --kill-after=DURAÇÃO
também envia um sinal KILL se o COMANDO ainda estiver em execução por este tempo após o sinal inicial
ter sido enviado
-p, --preserve-status
sai com o mesmo status do COMANDO, mesmo quando o comando atinge o limite de tempo
-s, --signal=SINAL
especifica o sinal a ser enviado no tempo limite; SINAL pode ser um nome como 'HUP' ou um número; veja
'kill -l' para uma lista de sinais
-v, --verbose
diagnostica para stderr qualquer sinal enviado no tempo limite
--help exibe esta ajuda e sai
--version
exibe informações da versão e sai
DURAÇÃO é um número de ponto flutuante com um sufixo opcional: 's' para segundos (o padrão), 'm'
para minutos, 'h' para horas ou 'd' para dias. Uma duração de 0 desativa o tempo limite associado.
Ao atingir o tempo limite, envia o sinal TERM para o COMANDO, caso nenhum outro SINAL seja especificado. O sinal TERM encerra qualquer processo que não bloqueie ou capture esse sinal. Pode ser necessário usar o sinal KILL, já que este sinal não pode ser capturado.
Status de saída:
124 se o COMANDO atingir o tempo limite, e --preserve-status não for especificado
125 se o comando timeout falhar
126 se o COMANDO for encontrado, mas não puder ser invocado
127 se o COMANDO não puder ser encontrado
137 se o COMANDO (ou o próprio timeout) receber o sinal KILL (9) (128+9)
- o status de saída do COMANDO, caso contrário
BUGS
Algumas plataformas atualmente não suportam tempos limite além do ano de 2038.
AUTOR
Escrito por Padraig Brady.
RELATANDO BUGS
Ajuda online do GNU coreutils: [https://www.gnu.org/software/coreutils/] Relate quaisquer erros de tradução para [https://translationproject.org/team/]
VEJA TAMBÉM
kill(1)
Documentação completa [https://www.gnu.org/software/coreutils/timeout] ou disponível localmente via: info '(coreutils) timeout invocation'
Empacotado por Debian (9.7-3) Copyright © 2025 Free Software Foundation, Inc. Licença GPLv3+: GNU GPL versão 3 ou posterior [https://gnu.org/licenses/gpl.html]. Este é um software livre: você é livre para alterá-lo e redistribuí-lo. Não há GARANTIA, na medida permitida por lei.