Código de saída bash do último comando
Quando um comando bash é executado, ele deixa para trás o código de saída, independentemente da execução bem-sucedida ou malsucedida. Examinar o código de saída pode oferecer informações úteis sobre o comportamento do comando de última execução.
Neste guia, confira como verificar o código de saída bash do último comando e alguns possíveis usos dele.
Código de Saída Bash
Todo comando UNIX/Linux executado pelo shell script ou usuário deixa um status de saída. É um número inteiro que permanece inalterado, a menos que o próximo comando seja executado. Se o código de saída for 0, o comando foi bem-sucedido. Se o código de saída for diferente de zero (1-255), significa um erro.
Existem muitos usos potenciais do código de saída bash. A mais óbvia é, obviamente, verificar se o último comando foi executado corretamente, especialmente se o comando não gerar nenhuma saída.
No caso do bash, o código de saída do comando anterior é acessível usando a variável shell “$? ”.
Verificando o código de saída Bash
Inicie um terminal e execute qualquer comando.
Verifique o valor da variável shell “$? ” para o código de saída.
Como o comando “date ” foi executado com sucesso, o código de saída é 0. O que aconteceria se houvesse um erro?
Vamos tentar executar um comando que não existe.
Verifique o código de saída.
É um valor diferente de zero, indicando que o comando anterior não foi executado corretamente.
Agora, dê uma olhada no seguinte comando:
Ao trabalhar com um comando que possui um ou mais pipes, o código de saída será o último código executado no pipe. Neste caso, é o comando grep.
Como o comando grep foi bem-sucedido, será 0.
Neste exemplo, se o comando grep falhar, o código de saída será diferente de zero.
$ echo $?
Incorporando código de saída em scripts
O código de saída também pode ser usado para scripts. Uma maneira simples de usá-lo é atribuindo-o a uma variável de shell e trabalhando com ele. Aqui está um exemplo de script de shell que usa o código de saída como condição para imprimir uma saída específica.
$ echo "hello world"
$ status=$?
$ [ $status -eq 0 ] && echo "command successful" || echo "command unsuccessful"
Ao ser executado, o script gerará a seguinte saída.
Agora, vamos ver o que acontece quando há um comando inválido para executar.
$ random-command
$ status=$?
$ [ $status -eq 0 ] && echo "command successful" || echo "command unsuccessful"
Ao ser executado, a saída será diferente.
Explicação do valor do código de saída
Quando o código de saída é diferente de zero, o valor varia de 1 a 255. Agora, o que significa esse valor?
Embora o valor seja limitado, a explicação de cada valor é exclusiva do programa/script. Por exemplo, “ls” e “grep” têm explicações diferentes para os códigos de erro 1 e 2.
Definindo o status de saída no script
Ao escrever um script, podemos definir valores de código de saída personalizados. É um método útil para facilitar a depuração. Em scripts bash, é o comando “exit” seguido pelo valor do código de saída.
Pela convenção, é recomendável atribuir o código de saída 0 para execução bem-sucedida e usar o restante (1-255) para possíveis erros. Ao atingir o comando exit, a execução do shell script será encerrada, portanto, tenha cuidado com seu posicionamento.
Dê uma olhada no script de shell a seguir. Aqui, se a condição for atendida, o script terminará com o código de saída 0. Se a condição não for atendida, o código de saída será 1.
$ if [[ "$(whoami)" != root ]]; then
$ echo "Not root user."
$ exit 1
$ fi
$ echo "root user"
$ exit 0
Verifique o resultado da execução deste script sem privilégio sudo ou usuário “root”.
$ echo $?
Pensamentos finais
Este guia demonstra o que são códigos de saída e como você pode usá-los. Ele também demonstra como atribuir códigos de saída apropriados em um script bash.
Interessado em script bash? Uma das maneiras mais fáceis de começar é escrevendo seus próprios scripts. Confira este guia simples sobre como escrever um script bash simples.
Feliz computação!