Comando timeout do Linux explicado para iniciantes (com exemplos)

Às vezes, quando você executa um comando no Linux, pode querer executá-lo por um tempo determinado. Existe uma utilidade de linha de comando - timeout - que foi especificamente desenvolvida para esse propósito. Neste artigo, discutiremos o básico deste comando usando alguns exemplos fáceis de entender.

Mas antes de fazermos isso, vale a pena mencionar que todos os exemplos deste tutorial foram testados em uma máquina Ubuntu 18.04 LTS.

Comando timeout do Linux

Como o nome sugere, o comando timeout no Linux permite que você execute um comando com um limite de tempo. A seguir está sua sintaxe:

timeout [OPÇÃO] DURAÇÃO COMANDO [ARG]...

E aqui está como a página do manual da ferramenta explica:

timeout - execute um comando com um limite de tempo  
Inicie o COMANDO e mate-o se ainda estiver em execução após a DURAÇÃO

A seguir estão alguns exemplos no estilo Q&A que devem lhe dar uma ideia melhor de como essa ferramenta funciona.

Q1. Como usar o comando timeout?

O uso básico é bem fácil - basta executar ‘timeout’ especificando um valor de timeout (considerado em segundos) e o comando que você deseja executar.

Por exemplo, se você quiser que um comando ping expire após 5 segundos, aqui está como você pode usar o timeout neste caso.

timeout 5 ping google.com

Q2. Como obter o status de saída do comando na saída?

Por padrão, se o comando timeout for bem-sucedido, ele retorna 124 como status de saída. A seguir está um exemplo:

No primeiro caso, deixei o comando timeout ser executado com sucesso e, como você pode ver, o status de saída foi 124. No entanto, durante a segunda execução, matei o comando forçosamente usando Ctrl+C, e nesse caso, o status de saída foi 0.

Mas caso você queira que o timeout retorne o status do comando de entrada mesmo que o timeout seja executado com sucesso, você terá que usar a opção de linha de comando –preserve-status.

Por exemplo:

timeout --preserve-status 5 ping google.com

Q3. Como mudar o sinal que o timeout envia?

Não há ponto em adivinhar que o timeout funciona enviando um sinal para o comando de entrada para que este pare de executar quando o prazo se aproxima. Por padrão, SIGTERM é usado pelo comando.

No entanto, se você quiser, pode mudar o sinal que é enviado pelo timeout. Para isso, você terá que usar a opção de linha de comando -s e especificar como entrada o sinal que você deseja que o timeout envie.

Por exemplo:

timeout -s SIGKILL [COMANDO]

Para obter uma lista de sinais disponíveis que você pode enviar, execute o seguinte comando:

kill -l

Q4. Como fazer o timeout enviar automaticamente o sinal KILL?

Às vezes, você pode encontrar um comando de entrada que continua a ser executado mesmo depois que o timeout envia o sinal inicial. Para casos como esses, o timeout oferece uma opção ‘–kill-after’.

Aqui está como a página do manual explica:

-k, --kill-after=DURAÇÃO  
              também envia um sinal KILL se o COMANDO ainda estiver em execução  
              esse tempo após o sinal inicial ter sido enviado

Então, como você pode ver, você precisa especificar uma duração para informar ao timeout após quanto tempo esse sinal deve ser enviado.

Conclusão

Dependendo do tipo de trabalho que você faz, o comando timeout pode se mostrar uma ferramenta bastante útil. Aqui, neste tutorial, discutimos a maioria das opções que esta utilidade oferece. Uma vez que você tenha praticado isso, pode aprender mais sobre o timeout acessando sua página de manual.