https://github.com/thlorenz/lldb-jbt

Adds JavaScript symbols to lldb stack traces
https://github.com/thlorenz/lldb-jbt

Last synced: 27 days ago
JSON representation

Adds JavaScript symbols to lldb stack traces

• Host: GitHub
• URL: https://github.com/thlorenz/lldb-jbt
• Owner: thlorenz
• License: mit
• Archived: true
• Created: 2014-12-29T21:08:47.000Z (almost 10 years ago)
• Default Branch: master
• Last Pushed: 2017-11-25T12:49:13.000Z (about 7 years ago)
• Last Synced: 2024-10-29T02:39:02.300Z (about 2 months ago)
• Language: Python
• Homepage:
• Size: 907 KB
• Stars: 49
• Watchers: 6
• Forks: 7
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# lldb-jbt

**NOTE:** Even though this module works as is, **I am no longer improving it because a better solution is available now**. Therefore please use [llnode](https://github.com/nodejs/llnode) instead.

![assets/sample.png](assets/sample.png)

## Screencasts

Debugging Node.js with lldb and jbt                                              |  Debugging Node.js with Xcode and jbt

:-------------------------------------------------------------------------------:|:--------------------------------------------------------------------------------------:

[![assets/yt-jbt-lldb.png](assets/yt-jbt-lldb.png)](http://youtu.be/hy9o5Crjy1A) | [![assets/yt-jbt-lldb.png](assets/yt-jbt-xcode.png)](http://youtu.be/_oMt1vCwod0)

## Installation

```

npm install -g lldb-jbt

```

**Requires Node.js version `0.11.13` or higher** and works best with a *debug* build.

For more information see Node.js [build instructions](https://github.com/thlorenz/lldb-jbt/wiki/Building-Node.js).

## Usage

1. Add the script dir to your `PYTHONPATH` by running `source jbt`

2. Debug your node process with `--perf-basic-prof` flag, i.e. `lldb -- node --perf-basic-prof index.js`

3. Import the **jbt** command into lldb `command script import jbt`

4. Set a breakpoint, i.e. `b uv_fs_read`

5. When you hit the breakpoint type `jbt` to see the stack trace with JavaScript symbols resolved

## Xcode

To make things work with Xcode do the following:

1. Run `jbt` to determine where `jbt.py` was installed on your machine

2. Add a `~/.lldbinit-xcode` file which will be picked up by Xcode with the below content

```

command script import 

```

Now the **jbt** command will initialize itself and is accessible to you in the **lldb** console inside Xcode.

## License

MIT