misc.right

bash debugger. You can use this tool to debug bash shell script

of preserving the free status of all derivatives of our free software and
of promoting the sharing and reuse of software generally.

+#### help commands...
+help 
bashdb commands:
List/search source lines:                 Control script execution:
-------------------------                 -------------------------
 l [start|.] [cnt] List cnt lines         T [n]        Stack trace
                   from line start        s [n]        Single step [n times]
 l sub       List source code fn          n [n]        Next, steps over subs
 - or .      List previous/current line   <CR>/<Enter> Repeat last n or s 
 w [line]    List around line             c [linespec] Continue [to linespec]
 f filename  View source in file          L            List all breakpoints
 /pat/       Search forward for pat       b linespec   Set breakpoint
 ?pat?       Search backward for pat      del [n].. or D Delete a/all breaks
                                                         by entry number
Debugger controls:                        skip         skip execution of cmd
-------------------------                 cl linespec  Delete breakpoints by
 H [num]         Show last num commands                line spec
 q [exp] or ^D   Quit returning exp       R [args]     Attempt a restart
 info [cmd]      Get info on cmd.         u [n]        Go up stack by n or 1.
 !n or hi n      Run debugger history n   do [n]       Go down stack by n or 1.
 h or ? [cmd]    Get help on command      W [var]      Add watchpoint. If no
 info [cmd]      Get info on cmd                       no expr, delete all
 show [cmd]      Show settings            We [expr]    Add Watchpoint arith 
                                                       expr
 so file         read in dbg commands     t            Toggle trace
                                          en/di n      enable/disable brkpt,
 set x y         set a debugger variable               watchpoint, or display
 e bash-cmd      evaluate a bash command  tb linespec  Add one-time break
 disp expr       add a display expr       a linespec cmd eval "cmd" at linespec
 M               Show module versions     A            delete all actions
 x expr          evaluate expression      ret          jump out of fn or source
                 (via declare, let, eval) finish       execute until return
 deb             debug into another       cond n exp   set breakpoint condition
                 shell script
 !! cmd [args]   execute shell command "cmd" with "args"
 file filename   Set script filename to read for current source.
 load filename   read in Bash source file use in list and break commands

Data Examination: also see e, t, x
-------------------------                 
 p variable      Print variable 
 V [[!]pat]      List variable(s) matching or not (!) matching pattern pat
 S [[!]pat]      List subroutine names [not] matching pattern pat

Readline command line editing (emacs/vi mode) is available.
For more help, type h <cmd> or consult online-documentation.
+help set
set args -- Set argument list to give program being debugged when it is started.
Follow this command with any number of args, to be passed to the program.
set annotate  -- Set annotation level.
set basename  -- Set short filenames (the basename) in debug output is on.
set debugger  -- Set debugging the debugger is debugger
set editing   -- Set editing of command lines as they are typed is off.
set linetrace -- Set tracing execution of lines before executed is off.
set listsize  -- Set number of source lines bashdb will list by default.
set prompt    -- bashdb's prompt is:
       "bashdb${_Dbg_less}${#_Dbg_history[@]}${_Dbg_greater}$_Dbg_space".
set showcommand -- Set showing the command to execute is auto.
set trace-commands -- Set showing debugger commands is on.
+help set foo
There is no "set foo" command.
+help set ar
Set argument list to give program being debugged when it is started.
Follow this command with any number of args, to be passed to the program.
+help set annotate
Set annotation level.
0 == normal;     1 == fullname (for use when running under emacs)
+help set listsize
Set number of source lines bashdb will list by default.
+help set prompt
bashdb's prompt is:
       "bashdb${_Dbg_less}${#_Dbg_history[@]}${_Dbg_greater}$_Dbg_space".
+help set editing
Set editing of command lines as they are typed is off.
+help tty
tt  tty-name     Set the output device for debugger output
                 Long command name: tty.
+help info
List of info subcommands:

info args -- Argument variables (e.g. $1, $2, ...) of the current stack frame.
info breakpoints -- Status of user-settable breakpoints
info display -- Show all display expressions
info files -- Source files in the program
info functions -- All function names
info line -- list current line number and and file name
info program -- Execution status of the program.
info signals -- What debugger does when program gets various signals
info source -- Information about the current source file
info stack -- Backtrace of the stack
info terminal -- Print terminal device
info variables -- All global and static variable names
info warranty -- Various kinds of warranty you do not have
+info 
Info subcommands are: args breakpoints display files functions program source sources stack terminal variables watchpoints
+show 
args:     Argument list to give script when debugged program starts is:
       "-B -q -L .. -x misc.cmd dbg-test2.sh testarg1 testarg2".
basename: Show short filenames (the basename) in debug output is on.
debugger: Allow debugging the debugger is off.
editing:  Editing of command lines as they are typed is on.
line tracing: Show line tracing is off.
line tracing: Show line trace delay is 0.
listsize: Number of source lines bashdb will list by default is 10.
prompt:   bashdb's prompt is:
       "bashdb${_Dbg_less}${#_Dbg_history[@]}${_Dbg_greater}$_Dbg_space".
trace-commands: State of command tracing is on.
+#### and show...
+show args
Argument list to give script when debugged program starts is:
       "-B -q -L .. -x misc.cmd dbg-test2.sh testarg1 testarg2".
+set args now is the time
+show args
Argument list to give script when debugged program starts is:
       "now is the time".
+set editing off
+set editing fooo
"on" or "off" expected.
+show editing
Editing of command lines as they are typed is off.
+set editing
+show editing
Editing of command lines as they are typed is on.
+set misspelled 40
Undefined set command "misspelled"
+set listsize 40
+set listsize bad
Integer argument expected; got: bad
+set annotate bad
Integer argument expected; got: bad
+set annotate 6
annotation level must be 0 or 1
+show annotate
Annotation_level is 0.
+set annotate 1
+show listsize
Number of source lines bashdb will list by default is 40.
+show annotate
Annotation_level is 1.
+######################### 
+#### Test 'show commands'...
+show commands
49: show commands
48: show annotate
47: show listsize
46: set annotate 1
45: show annotate
44: set annotate 6
43: set annotate bad
42: set listsize bad
41: set listsize 40
40: set misspelled 40
39: show editing
+show commands +
38: set editing
37: show editing
36: set editing fooo
35: set editing off
34: show args
33: set args now is the time
32: show args
31: show 
30: info 
29: help info
28: help tty
+show commands -5
51: show commands -5
50: show commands +
49: show commands
48: show annotate
47: show listsize
+show commands 12
12: print "\$1: $1"
11: print "_Dbg_arg#: ${#_Dbg_arg[@]}"
10: print "prof1.cmd called"
9: set trace-commands on
8: source prof1.cmd
7: print calling prof1.cmd...
6: print prof2.cmd called...
5: set trace-commands on
4: source prof2.cmd
3: print "prof1.cmd called"
2: set trace-commands on
+#### history...
+H 
52: show commands 12
51: show commands -5
50: show commands +
49: show commands
48: show annotate
47: show listsize
46: set annotate 1
45: show annotate
44: set annotate 6
43: set annotate bad
42: set listsize bad
41: set listsize 40
40: set misspelled 40
39: show editing
38: set editing
37: show editing
36: set editing fooo
35: set editing off
34: show args
33: set args now is the time
32: show args
31: show 
30: info 
29: help info
28: help tty
27: help set editing
26: help set prompt
25: help set listsize
24: help set annotate
23: help set ar
22: help set foo
21: help set
20: help 
19: show copying
18: info warranty
17: show warranty
16: tty 
15: show badcommand
14: info args
13: print "\$2: $2"
12: print "\$1: $1"
11: print "_Dbg_arg#: ${#_Dbg_arg[@]}"
10: print "prof1.cmd called"
9: set trace-commands on
8: source prof1.cmd
7: print calling prof1.cmd...
6: print prof2.cmd called...
5: set trace-commands on
4: source prof2.cmd
3: print "prof1.cmd called"
2: set trace-commands on
1: source prof1.cmd
0: set trace-commands on
+H 5
5: set trace-commands on
4: source prof2.cmd
3: print "prof1.cmd called"
2: set trace-commands on
1: source prof1.cmd
0: set trace-commands on
+H 5 3
5: set trace-commands on
4: source prof2.cmd
3: print "prof1.cmd called"
+hi 11
_Dbg_arg#: 2
+!11 
_Dbg_arg#: 2
+!19:p 
19: show copying
+!-3:p 
50: show commands +
+!-2 
52: show commands 12
51: show commands -5
50: show commands +
49: show commands
48: show annotate
+! 2
+H -2
52: show commands 12
51: show commands -5
+H foo
Invalid history number: foo
+H 100000
52: show commands 12
51: show commands -5
50: show commands +
49: show commands
48: show annotate
47: show listsize
46: set annotate 1
45: show annotate
44: set annotate 6
43: set annotate bad
42: set listsize bad
41: set listsize 40
40: set misspelled 40
39: show editing
38: set editing
37: show editing
36: set editing fooo
35: set editing off
34: show args
33: set args now is the time
32: show args
31: show 
30: info 
29: help info
28: help tty
27: help set editing
26: help set prompt
25: help set listsize
24: help set annotate
23: help set ar
22: help set foo
21: help set
20: help 
19: show copying
18: info warranty
17: show warranty
16: tty 
15: show badcommand
14: info args
13: print "\$2: $2"
12: print "\$1: $1"
11: print "_Dbg_arg#: ${#_Dbg_arg[@]}"
10: print "prof1.cmd called"
9: set trace-commands on
8: source prof1.cmd
7: print calling prof1.cmd...
6: print prof2.cmd called...
5: set trace-commands on
4: source prof2.cmd
3: print "prof1.cmd called"
2: set trace-commands on
1: source prof1.cmd
0: set trace-commands on
+history -2
52: show commands 12
51: show commands -5
50: show commands +
49: show commands
48: show annotate
+history 10000
Number 10000 should be less than 53
+#### pwd/cd commands...
+pwd 
Working directory test.
+cd .
Working directory test.
+########################## 
+#### Test 'prompt' and 'tty' ...
+set prompt bashdb${_Dbg_greater}$_Dbg_hi${_Dbg_less}$_Dbg_space
+show prompt
bashdb's prompt is:
       "bashdb${_Dbg_greater}$_Dbg_hi${_Dbg_less}$_Dbg_space".
+tty /tmp/misc-output.check