VS Code Ksh Debug

A ksh debugger GUI frontend based on awesome kshdb scripts (kshdb included in package).

Overview

This is a SIMPLE kshdb debugger frontend. Useful for learning ksh shell usage and writing simple scripts.

Useful hint: shellcheck extension does a great job with finding common script errors before debugging.

Usage

1. Download and install newest ksh: (https://build.opensuse.org/project/show/shells:ksh:new:latest)
2. Select Debug -> Add Configuration to add custom debug configuration (drop-down, path-input, etc...)
3. Select Debug -> Start Debugging (F5) to start debugging

See https://code.visualstudio.com/docs/editor/debugging for general usage.

Sample features

• Debugging auto-configuration via launch.json

• Simple debugging in hello world application

• Standard input handling via terminal

• Pause support while script is running

• Advanced "Watch" and "Debug console" usage

• Conditional breakpoints usage

For Windows users:

• Install Windows Subsystem for Linux
• Terminal has problems with spaces in paths when powershell is used, use WSL shell instead. For beta WSL please read this

For macOS users:

• Read here if your mac has /usr/local/bin/pkill.

Dependencies

1. ksh version 93v- 2014-12-24 or later
2. cat, mkfifo, rm, pkill

Limitations and known problems

• Use terminalKind@launch.json set to integrated or external for interactive scripts (using stdin)
• Currently debugger stops at first command
• $0 variable shows path to kshdb
• Korn shell sometimes crashes