NodeJS module that provides the ability to control GDB and LLDB debuggers via GDB/MI.
Switch branches/tags
Nothing to show
Clone or download
enlight Fix wrong require
I guess someone didn't bother running the tests after switching from
`pty.js` to `unix-pty`!
Latest commit 9850776 Oct 13, 2016
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.vscode
conf Overhaul the build system Oct 10, 2016
lib
scripts
src
test
.editorconfig
.gitignore Remove VS solution and add some settings for VSCode Oct 4, 2016
.npmignore
LICENSE
README.md Overhaul the build system Oct 10, 2016
binding.gyp
package.json

README.md

dbgmits (WIP)

This library can be used to programmatically control debuggers that implement the GDB/Machine Interface via JavaScript. Currently both GDB and LLDB support this interface. Note that LLDB's implementation is incomplete, and is still under development, so if you want to use LLDB it's best to build it yourself from source instead of using a released version.

Prerequisites

Install

The latest release of this library can be installed via NPM:

npm install dbgmits --save

Development

This section assumes you'll be working within a local checkout of this repository.

Install

Install all the dependencies for this library with:

npm install

Build

To build the library just run:

npm run build

Test

Before running the tests for the first time you'll need to generate the target executable used by the tests. Unfortunately, while the target executable can be built on Windows the current setup will build it with MSVC and the generated debug information will be unreadable by LLDB and GDB, which in turn means that most of the tests won't run properly. The target executable is built via the node-gyp module, which currently expects to have access to the Node.js development headers, so if you haven't done so previously you can ask node-gyp to download and unpack the required files by running:

node-gyp install

Next, ensure you have Python 2.7 and a C/C++ compiler tool-chain installed on your system, as detailed in the node-gyp README.

Now you're ready to build the target executables, to do so run:

npm run configure-tests

Finally, you can run the tests with GDB via npm run gdb-tests, or LLDB via npm run lldb-tests.

License

This library is licensed under the MIT license. See LICENSE file for full terms.