Softpanorama (slightly skeptical) Open Source Software Educational Society

May the source be with you, but remember the KISS principle ;-) Softpanorama Search

Bash Debugger

I would recommend to check syntax of the bash script before using the debugger. You can use this by using option "-n", for example 

bash -n your_script.sh

Usage of bash db is very simple. The essentials are:

• type `bash --debugger script-name' or `bashdb script-name' to start the BASH debugger. 
• type quit or C-d inside the debugger to exit. Other way to terminate the debugger is to use the kill command. kill -9 can be used in cases where quit doesn't work.
• type `bashdb -c command string' to give a string to run under the debugger
• Options
  • -h | --help
  • This option causes the BASH debugger to print some basic help and exit.
  • -V | --version
  • This option causes the BASH debugger to print its version number, no-warranty blurb, and exit.
  • -A | --annodate level
  • Add additional output which allows front-ends to track what's going on without having to poll for such vital information. The default annotation level is 0 (none). If you are running inside GNU Emacs using the Emacs code from this package, an annotation level 3 when set will allow for automatic tracking of frames and breakpoints. See section Annotation Level (‘set annotate’).
  • -c | --command cmd
  • Run the string instead of running a script
  • -B | --basename
  • This option causes the BASH debugger to print its version number and no-warranty blurb, and exit.
  • -n | --nx | --no-init
  • Do not execute commands found in any initialization files. Normally, BASH executes the commands in these files after all the command options and arguments have been processed. See section Command files.
  • -q | --quiet
  • “Quiet”. Do not print the introductory and copyright messages. These messages are also suppressed in batch mode.
  • -t | --terminal | --tty tty
  • “Terminal output”. Set the file or terminal that you want debugger command output to go to. Note that the debugger output is independent of the debugged script output.
  • -x | --eval-command
  • execute debugger commands from cmdfile.
  • -L | --library directory
  • Set directory where debugger files reside to directory. The default location is ../lib/bashdb relative to the place that the bashdb script is located. For example if bashdb is located in /usr/local/bin/bashdb, the default library location will be /usr/local/lib/bashdb which may or may not exist. If it doesn't you'll get an error when you run bashdb. Only if the default location is incorrect, should you need to use the -L option.
  • -T | --tempdir directory
  • Set directory to use for writing temporary files.
• Activation of the debugger within the script. you can make an explicit call to the debugger in your script

  _Dbg_debugger

  Let's show an example of that. We'll even do it under a condition:

  for ((i=1; i<=10; i++)) ; (( 5 == i )) && { _Dbg_debugger } date=$(date) echo "$date" sleep 2 done

  You can also turn on and off line tracing with _Dbg_linetrace_on
   
• Getting help (‘help’) Once inside the BASH debugger, you can always ask it for information on its commands, using the command help. You can use help (abbreviated h) with no arguments to display a short list of named classes of commands:

  bashdb<0> help Available commands: / debug enable help next show step- untrace alias delete eval history print signal tbreak up break disable examine info pwd skip trace watch commands display file kill quit source tty where condition down frame list restart step unalias continue edit handle load set step+ undisplay

  
   

There are also two front-ends available as well. One can also enter the debugger inside emacs via the command M-x bashdb after loading Emacs' Grand Unified Debugger, gud. See Using the BASH debugger from GNU Emacs. And there is support in a DDD for bash.

Basdb documentation has several examples on how to use bashdb. See  Summary of the BASH Debugger

The Ubuntu repository contains a package for bashdb

There is also a new version, bashdb 4.0, which has been tested on bash 4.0 alpha as well as bash 3.2.x.

There are also similar debuggers for zsh and ksh; these are called zshdb and kshdb respectively. But in contrast to bashdb, both require fairly new releases (ksh93t from Nov 4 or zshdb 4.3.6-dev-0 or greater) .

As with bashdb, zshdb in available as a source package in Debian. To get releases from sources though go to the same place:
https://sourceforge.net/project/showfiles.php?group_id=61395

Recommended Links

---

In case of broken links please try to use Google search. If you find the page please notify us about new location

BASH Debugger Debugging with the BASH debugger

rpmseek.com - The search engine for Linux rpm and Debian packages

RPM Search bash-3.0-18.x86_64.rpm
bash rpm build for : Fedora 3. For other distributions click here. ... bashdb
/usr/share/doc/bash-3.0/bashdb/bashdb.el /usr ... ps There is 253 files more in these ...
rpm.pbone.net/index.php3/stat/ 4/idpl/1562422/com/bash-3.0-18.x86_64.rpm.html - 15k - Supplemental Result - Cached - Similar pages

RPM Search bash-3.0-24.i386.rpm
bash rpm build for : Fedora Other ... bash-3.0/bashdb/bashdb /usr/share/doc/bash-3.0/
bashdb/bashdb.el /usr ... bash-3.0/builtins.ps There is 253 files more in these RPM.
rpm.pbone.net/index.php3/stat/ 4/idpl/1546533/com/bash-3.0-24.i386.rpm.html - 16k - Supplemental Result - Cached - Similar pages
[ More results from rpm.pbone.net ]

bash-doc-3.0-67125cl.i386 RPM
... 26 01:55:29 (42311) - Include the pgrp_sync.patch from the fedora bash src.rpm,
this was ... doc-3.0/bashbug.ps /usr/share/doc/bash-doc-3.0/bashdb /usr/share ...
rpmfind.net/linux/RPM/conectiva/snapshot/ i386/RPMS.doc/bash-doc-3.0-67125cl.i386.html - 16k - Supplemental Result - Cached - Similar pages

bash-3.0-24.ia64 RPM
From Fedora Core Development for ia64. ... Size: 6002587, Source RPM: bash-3.0-24.src.
rpm. ... usr/share/doc/bash-3.0/bashbug.ps /usr/share/doc/bash-3.0/bashdb /usr/share ...
rpmfind.net/linux/RPM/fedora/ development/ia64/bash-3.0-24.ia64.html - 34k - Supplemental Result - Cached - Similar pages
[ More results from rpmfind.net ]

bash-2.05b-31.i386 RPM
De Fedora Core 1 - i386. ... Tamaño: 4406854, RPM del código fuente : bash-2.05b-31.src.
rpm. ... doc/bash-2.05b/bashbug.ps /usr/share/doc/bash-2.05b/bashdb /usr/share ...
rpmfind.rediris.es/rpm2html/ fc1-i386/bash-2.05b-31.i386.html - 30k - Supplemental Result - Cached - Similar pages

bash-2.05b-38.i386 RPM
De Fedora Core 2 - i386. ... Tamaño: 4394487, RPM del código fuente : bash-2.05b-38.src.
rpm. ... doc/bash-2.05b/bashbug.ps /usr/share/doc/bash-2.05b/bashdb /usr/share ...
rpmfind.rediris.es/rpm2html/ fc2-i386/bash-2.05b-38.i386.html - 31k - Supplemental Result - Cached - Similar pages