How to install¶
From a Package¶
Repology maintains a list of various bundled zshdb packages. Below are some specific distributions that contain zshdb.
At the time this documentation was built, here is status that they provide:
Check the link above for more up-to-date information.
Debian/Ubuntu¶
On Debian systems, and derivatives, zshdb can be installed by running:
$ sudo apt-get install zshdb
The latest version may not yet be included in the archives. If you are running a stable version of Debian or a derivative, you may need to install zshdb from the backports repository for your version to get a recent version installed.
From Source¶
SourceForge¶
Go to sourceforge and find the most recent version and download a tarball of that.
$ tar -xpf zshdb-xxx.tar.bz2
$ cd zshdb-xxx
$ ./autogen.sh
$ make && make test
$ make install # may need sudo
git¶
Many package managers have back-level versions of this debugger. The most recent versions is from the github.
To install from git:
$ git clone git://github.com/rocky/zshdb.git
$ cd zshdb
$ ./autogen.sh # Add configure options. See ./configure --help
If you’ve got a suitable zsh installed, then
$ make && make test
To try on a real program such as perhaps /etc/zsh/zshrc:
$ ./zshdb -L /etc/zsh/zshrc # substitute .../zshrc with your favorite zsh script
To modify source code to call the debugger inside the program:
source path-to-zshdb/zshdb/dbg-trace.sh
# work, work, work.
_Dbg_debugger
# start debugging here
Above, the directory path-to_zshdb should be replaced with the directory that dbg-trace.sh is located in. This can also be from the source code directory zshdb or from the directory dbg-trace.sh gets installed directory. The “source” command needs to be done only once somewhere in the code prior to using _Dbg_debugger.
If you are happy and make test above worked, install via:
sudo make install
and uninstall with:
$ sudo make uninstall # ;-)