Primeiro, receio que a explicação da -o
opção oferecida pelo http://explainshell.com não esteja totalmente correta.
Dado que set
é um comando bulit-in, podemos ver sua documentação 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:
o valor de retorno de um pipeline é o status do último comando para sair com um status diferente de zero ou zero se nenhum comando sair com um status diferente de zero
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á a conhece e -e
para de executar após o primeiro erro no script. Considere um script como este:
#!/usr/bin/env bash
set -euxo pipefail
echo hi
non-existent-command
echo bye
A echo bye
linha nunca será executada quando -e
for usada 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 um erro acontecesse, 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
geralmente é colocado na parte superior do script para garantir que o script seja interrompido quando o primeiro erro for encontrado - por exemplo, se o download de um arquivo falhou, não faz sentido extraí-lo.
set -uxo pipefail
).set -e
que apenas causará, o script será encerrado por erro. No seu exemplo, é apenas uma das muitas opções-uxo pipefail
.e
argumento.0
com sucesso e diferentes de zero na falha,-e
é útil, mas, como todo o resto, deve ser usado com cuidado.