Nonstop Progressive Marxism

    dbgmits

    0.1.0 • Public • Published

    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, though LLDB's implementation is incomplete (but getting there!).

    Prerequisites

    Install

    If you don't already have the grunt-cli and tsd modules installed do so first:

    npm install -g grunt-cli
    npm install -g tsd
    

    Then install all the other module dependencies for this library:

    npm install
    

    Build

    To build the library just run:

    grunt 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 executable, to do so run:

    grunt configure-tests
    

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

    License

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

    Install

    npm i dbgmits

    DownloadsWeekly Downloads

    0

    Version

    0.1.0

    License

    MIT

    Last publish

    Collaborators

    • enlight