478

I have a shell script with the following line in it:

[ "$DEBUG" == 'true' ] && set -x
5
  • 30
    Take a look: help -m set | less
    – Cyrus
    Commented Mar 29, 2016 at 1:05
  • 7
    Thanks for the help -m set tip. That works. I tried man set prior to asking, however on ubuntu there is No manual entry for set
    – Ole
    Commented Mar 29, 2016 at 5:18
  • 5
    @Ole, set is built into bash so if you man 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 \[.
    – User5910
    Commented Sep 28, 2018 at 17:10
  • 10
    man is for non-builtins and help is for shell builtins. Commented Feb 8, 2021 at 6:06
  • 1
    BTW, the string comparison operator should be = not ==; the latter is a nonstandard extension, the former is officially standardized and guaranteed to be available in all POSIX-compliant sh implementations. Commented Jun 26, 2023 at 19:37

3 Answers 3

671

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.

11
  • 8
    This is VERY useful! I wish someone had told me that earlier. Are there other interesting tricks like this that can sort of boost up our meta-skill on scripting?
    – Student
    Commented Jun 27, 2019 at 13:22
  • 26
    @Student: 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
  • 6
    @JohnZwinck, unfortunately, 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
  • 2
    @JohnZwinck, Yes, but I have no idea who 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
  • 8
    btw: these messages are printed to stderr, so if you for example have such a script running inside a docker container, these messages are interpreted as errors. :)
    – rudi
    Commented Aug 10, 2020 at 12:56
110

$(set -x)

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]

Example

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.

  • First step expr has been evaluated.
  • Second step 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

2
  • 1
    Think about using $( ) 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
  • Thanks for suggestion @CharlesDuffy, Agreed with your comment and I have updated the answer !
    – Raju
    Commented Jun 27, 2023 at 11:04
23

-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

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.