How to debug a bash script?

Start your bash script with bash -x ./script.sh or add in your script set -x.

Additional with bash 4.1 or later:

If you want to write the debug output to a separate file, add this to your script:

exec 5> debug_output.txt
BASH_XTRACEFD="5"

See: http://stackoverflow.com/a/25593226/3776858

If you want to see line numbers add this:

PS4='$LINENO: '

The standard method to debug scripts in most Bourne-based shells, like bash is to write set -x at the top of your script. This will make bash more verbose about what's being done/executed, and how arguments are evaluated.

-x  Print commands and their arguments as they are executed.

this is useful for either, the interpreter or inside scripts. For example:

$ find "$fileloc" -type f -prune "$filename" -print
+ find /var/adm/logs/morelogs -type f -prune '-name *.user' -print
find: unknown predicate '-name *.user'
$ find "$fileloc" -type f -prune $filename -print
+ find /var/adm/logs/morelogs -type f -prune -name '*.user' -print
find: '/var/adm/logs/morelogs': No such file or directory

In the above we can see why find is failing due some single quotes.

To deactivate the feature, just type set +x.

Using set -x

I always use set -x and set +x. You can wrap areas that you want to see what's happening with them to turn verbosity up/down.

#!/bin/bash

set -x
..code to debug...
set +x

log4bash

Also if you've done development work and are familiar with the style of loggers that go by the names log4j, log4perl, etc., then you might want to make use of log4bash.

Let's face it - plain old echo just doesn't cut it. log4bash is an attempt to have better logging for Bash scripts (i.e. make logging in Bash suck less).

From there you can do things like this in your Bash scripts:

#!/usr/bin/env bash
source log4bash.sh

log "This is regular log message... log and log_info do the same thing";

log_warning "Luke ... you turned off your targeting computer";
log_info "I have you now!";
log_success "You're all clear kid, now let's blow this thing and go home.";
log_error "One thing's for sure, we're all gonna be a lot thinner.";

# If you have figlet installed -- you'll see some big letters on the screen!
log_captains "What was in the captain's toilet?";

# If you have the "say" command (e.g. on a Mac)
log_speak "Resistance is futile";

Resulting in this type of output:

log4sh

If you need something more portable there's also the older log4sh. Works similar to log4bash, available here:

• https://sites.google.com/a/forestent.com/projects/log4sh

There's a bash debugger, bashdb, which is an installable package on many distros. It uses bash's built-in extended debugging mode (shopt -s extdebug). It looks a lot like gdb; here's a sample session to give some flavor:

$ ls
1st.JPG  2ndJPG.JPG
$ cat ../foo.sh
for f in *.JPG
do
  newf=${f/JPG/jpg}
  mv $f $newf
done
$ bashdb ../foo.sh
(foo.sh:1):
1:      for f in *.JPG
bashdb<0> next
(foo.sh:3):
3:        newf=${f/JPG/jpg}
bashdb<1> next
(foo.sh:4):
4:        mv $f $newf

As in gdb, the statement is shown just before it is about to be executed. So we can examine variables to see what the statement will do before it does it.

bashdb<2> print $f $newf
1st.JPG 1st.jpg
bashdb<3> next
(foo.sh:1):
1:      for f in *.JPG
bashdb<4> next
(foo.sh:3):
3:        newf=${f/JPG/jpg}
bashdb<5> next
(foo.sh:4):
4:        mv $f $newf
bashdb<6> print $f $newf
2ndJPG.JPG 2ndjpg.JPG

That's not what we want! Let's look at the parameter expansion again.

bashdb<7> print $f ${f/JPG/jpg}
2ndJPG.JPG 2ndjpg.JPG
bashdb<8> print $f ${f/JPG$/jpg}
2ndJPG.JPG 2ndJPG.JPG
bashdb<9> print $f ${f/%JPG/jpg}
2ndJPG.JPG 2ndJPG.jpg

OK, that works. Let's set newf to the correct value.

bashdb<10> eval newf=${f/%JPG/jpg}
$? is 0
bashdb<11> print $f $newf
2ndJPG.JPG 2ndJPG.jpg

Looks good. Continue the script.

bashdb<12> next
Debugged program terminated normally. Use q to quit or R to restart.
$ ls
1st.jpg  2ndJPG.jpg

Using Eclipse

You can use the combined environment of Eclipse and Shelled with the "_DEBUG.sh" script linked below.

• Eclipse Shelled Plug-in:
  http://sourceforge.net/projects/shelled/files/shelled/update/
• bash debugger - only works with shelled:
  http://sourceforge.net/projects/basheclipse/

Switching shells

By default the Shelled development tool uses /bin/dash as the interpreter. I changed this to /bin/bash to have better compatibility with most of the shell examples on the web and my environment.

NOTE: You can change this by going to: Window -> Preference -> Shell Script -> Interpreters

Setup Instructions

The Debugger package has the steps for using the _DEBUG.sh script for your script debugging which is basically (the readme.txt):

1. Create Shell Script Project: File -> New -> Other -> Shell Script -> Shell Script Project Wizard.
2. Create a Bash script file: File -> New -> File. For this example, it will be script.sh. Extension should be ".sh" and is a must.
3. Copy the file _DEBUG.sh to project folder.

4. Insert the following text to the top of the file script.sh:

   . _DEBUG.sh
   

5. If the file is created in Microsoft Windows then be sure to execute the File -> Convert Line Delimiters To -> Unix.

6. Set up a debug launch configuration: Run -> Debug Configurations -> Bash script... There are 2 fields to set here:

   a) "Bash script:" - Path in workspace of Eclipse to the Bash script to debug.
   e) "Debugger port:" 33333

7. Switch to The Debug perspective. Start the debugging session. Launch script.sh from bash shell.

The bash debug UI

This bash debugger has the full features of standard programming debuggers such as:

• Break Point toggle
• Single Step-by-step operation
• Step-in, Step-out, Step-over functions and sub-routines
• Examining code or variables at any point while script is running

The Shelled (Shell Script Editor) IDE (Integrated Development Environment) has an added bonus of performing context checking, highlighting and indenting while writing your script. If it doesn't indent correctly, you might immediately be able to flag/local many errors there.

Then there are other IDE benefits such as:

• TODO task list
• Mylyn Task
• Bookmark list
• Multiple Window Editing
• Remote Sharing of the environment

simply use:

#!/bin/bash -x

the same for shell:

#!/bin/sh -x