Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Korn Shell (93t 2008-10-22 or greater) Debugger
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
command
data Add debugger command "shell" to go into a nested shell
doc
emacs
init Add --no-highlight option. Remove some array and Assoc array initiali…
lib
test
.gitignore break.sh: use functions for better localization
AUTHORS
COPYING Zero origin frame handling
INSTALL
Makefile.am Makefile.am - add comment to make like the others
NEWS
README
THANKS Start to sync with bashdb and zshdb
acinclude.m4
autogen.sh
configure.ac
dbg-main.sh
dbg-trace.sh.in configure.ac: up minimum ksh version we require. fns.sh: use regexp i…
getopt-test.sh
getopts_long.sh Use getopt_long from Stéphane Chazelas. Thanks Stéphane!
kshdb.in Clean up before a kill -9. And some code clean ups.
testing.sh Add gdb's print location. Move more of the zshdb code over.

README

0. INTRODUCTION
This is a port and cleanup of my bash debugger bashdb
(http://bashdb.sf.net). 

The command syntax generally follows that of the GNU debugger gdb.

However this debugger depends on a number of bug fixes and of debugging
support features that are neither part of the POSIX 1003.1 standard
and only in ksh93t+ releases. In particular, there are fixes to a
number of the .sh variables like .sh.level and .sh.file.

1. SETUP

See https://github.com/rocky/kshdb/wiki/How-to-install for how to install this code. 

2. WHAT'S HERE, WHAT'S NOT and WHY NOT

What's missing falls into two categories:

  * Stuff that can be ported in a straightforward way from bashdb
  * Stuff that needs additional ksh support

Of the things which can be ported in a straight-forward way, however
some of them I want to revise and simplify. In some cases, the fact
that ksh has associative arrays simplifies code. On other cases, the
code I wrote needs refactoring and better modularization.

Writing documentation is important, but an extensive guide will have
to wait. For now one can consult the reference guide that comes with
bashdb: http://bashdb.sf.net/bashdb.html There is some minimal help to
get a list of commands and some help for each.

3. WHAT'S NOT HERE YET IN DETAIL

This can be done with or without support from ksh, albeit faster with
help from ksh.

3.a) Setting $0

3.b) lots of other stuff including...

  display expressions, signal handling, 
  debugger commands:
     debug
     file
     handle
     history
     signal
     tty
     watch

  None of this is rocket science. Should be pretty straight-forward to
  add.

4. WHAT MAY NEED MORE WORK AND SUPPORT FROM KSH

4.a) stopping points that can be used for breakpoint



Something went wrong with that request. Please try again.