Primeiro, receio que a explicação da opção -o
veiculada pelo link não seja totalmente correta.
Dado que set
é um "bulit-in"
comando, podemos ver sua documentação com help
executando help set
:
-o option-name
Set the variable corresponding to option-name:
allexport same as -a
braceexpand same as -B
emacs use an emacs-style line editing interface
errexit same as -e
errtrace same as -E
functrace same as -T
hashall same as -h
histexpand same as -H
history enable command history
ignoreeof the shell will not exit upon reading EOF
interactive-comments
allow comments to appear in interactive commands
keyword same as -k
monitor same as -m
noclobber same as -C
noexec same as -n
noglob same as -f
nolog currently accepted but ignored
notify same as -b
nounset same as -u
onecmd same as -t
physical same as -P
pipefail the return value of a pipeline is the status of
the last command to exit with a non-zero status,
or zero if no command exited with a non-zero status
posix change the behavior of bash where the default
operation differs from the Posix standard to
match the standard
privileged same as -p
verbose same as -v
vi use a vi-style line editing interface
xtrace same as -x
Como você pode ver, -o pipefail
significa:
the return value of a pipeline is the status of the last command to exit with a non-zero status, or zero if no command exited with a non-zero status
Mas não diz: Write the current settings of the options to standard output in an unspecified format.
Agora, -x
é usado para depuração, como você já sabe, e -e
será
Pare de executar após o primeiro erro no script. Considere um roteiro
assim:
#!/usr/bin/env bash
set -euxo pipefail
echo hi
non-existent-command
echo bye
A linha echo bye
nunca será executada quando -e
for usado porque
non-existent-command
não retorna 0:
+ echo hi
hi
+ non-existent-command
./setx.sh: line 5: non-existent-command: command not found
Sem -e
, a última linha seria impressa porque, mesmo que
erro aconteceu, não dissemos Bash
para sair automaticamente:
+ echo hi
hi
+ non-existent-command
./setx.sh: line 5: non-existent-command: command not found
+ echo bye
bye
set -e
é frequentemente colocado no topo do script para garantir que
script será interrompido quando o primeiro erro for encontrado - por
exemplo, se baixar um arquivo falhou, não faz sentido extrair
isso.