I have a shell script with the following line in it:
[ "$DEBUG" == 'true' ] && set -x
set -x
enables a shell mode where all executed commands are printed to the terminal.
In your case it's used for debugging, which is a typical use case for set -x
: printing every command as it is executed may help you visualize the script's control flow if it is not functioning as expected.
set +x
disables it.
set -e
at the top of your script will make the script exit with an error whenever an error occurs (and is not explicitly handled). I find that immensely preferable to the default, which is to keep going willy-nilly (like Visual Basic's infamous On Error Resume Next
).
Commented
Jun 28, 2019 at 6:41
set -e
has very undesirable side effects, to the point that it makes code review almost impossible (because a given line's behavior depends on what's up the call stack -- if a function is called in a "checked" context, set -e
is disabled for that invocation and everything it in turn calls). See the exercises in BashFAQ #105.
Commented
Feb 16, 2020 at 3:49
rking
is. Greycat is the author of the BashFAQ, the channel elder of the freenode IRC #bash channel, etc -- if you're going to argue-by-authority, it helps to know who the authorities in a field are. And yes, I absolutely do argue for tediously checking every command's exit handling, just as a code review requires in C or Go, or any other language that doesn't support exceptions. To rely on set -e
is to rely on something that is simply not reliable.
Commented
Feb 16, 2020 at 19:23
Prints a trace of simple commands, for commands, case commands, select commands, and arithmetic for commands and their arguments or associated word lists after they are expanded and before they are executed. The value of the PS4 variable is expanded and the resultant value is printed before the command and its expanded arguments.
[source]
set -x
echo $(expr 10 + 20)
+ expr 10 + 20
+ echo 30
30
set +x
echo $(expr 10 + 20)
30
Above example illustrates the usage of set -x
. When it is used, above arithmetic expression has been expanded. We could see how a single line has been evaluated step by step.
expr
has been evaluated.echo
has been evaluated.To know more about set → visit this link
when it comes to your shell script,
[ "$DEBUG" == 'true' ] && set -x
Your script might have been printing some additional lines of information when the execution mode selected as DEBUG
. Traditionally people used to enable debug mode when a script called with optional argument such as -d
$( )
instead of backticks when writing examples -- it's been part of the POSIX.2 standard since its initial publication in the early 1990s so there's no meaningful portability loss, and it's much better form (nests well, doesn't change the meaning of backslashes contained within, &c).
Commented
Jun 26, 2023 at 19:39
-u: disabled by default. When activated, an error message is displayed when using an unconfigured variable.
-v: inactive by default. After activation, the original content of the information will be displayed (without variable resolution) before the information is output.
-x: inactive by default. If activated, the command content will be displayed before the command is run (after variable resolution, there is a ++ symbol).
Compare the following differences:
/ # set -v && echo $HOME
/root
/ # set +v && echo $HOME
set +v && echo $HOME
/root
/ # set -x && echo $HOME
+ echo /root
/root
/ # set +x && echo $HOME
+ set +x
/root
/ # set -u && echo $NOSET
/bin/sh: NOSET: parameter not set
/ # set +u && echo $NOSET
help -m set | less
help -m set
tip. That works. I triedman set
prior to asking, however on ubuntu there isNo manual entry for set
set
is built into bash so if youman bash
you can find it in the SHELL BUILTIN COMMANDS section. When viewing the man page you can probably jump to it by searching for this regexp:\bset \[
.man
is for non-builtins andhelp
is for shell builtins.=
not==
; the latter is a nonstandard extension, the former is officially standardized and guaranteed to be available in all POSIX-compliantsh
implementations.