https://github.com/vadimcn/codelldb

A native debugger extension for VSCode based on LLDB
https://github.com/vadimcn/codelldb

debugger lldb vscode-extension

Last synced: 1 day ago
JSON representation

A native debugger extension for VSCode based on LLDB

• Host: GitHub
• URL: https://github.com/vadimcn/codelldb
• Owner: vadimcn
• License: mit
• Created: 2016-01-11T06:37:39.000Z (almost 9 years ago)
• Default Branch: master
• Last Pushed: 2024-10-06T06:11:10.000Z (2 months ago)
• Last Synced: 2024-10-29T15:21:07.252Z (about 1 month ago)
• Topics: debugger, lldb, vscode-extension
• Language: Rust
• Homepage: https://marketplace.visualstudio.com/items?itemName=vadimcn.vscode-lldb
• Size: 3.26 MB
• Stars: 2,545
• Watchers: 30
• Forks: 246
• Open Issues: 161
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

• stars - vadimcn/codelldb
• awesome-github-star - codelldb

README

        
# Features

- Conditional breakpoints, function breakpoints, logpoints,

- Hardware data access breakpoints (watchpoints),

- Launch debuggee in integrated or external terminal,

- Disassembly view with instruction-level stepping,

- [Step Into Targets](https://code.visualstudio.com/updates/v1_46#_step-into-targets).

- Caller exclusion for breakpoints.

- Memory view.

- Loaded modules view,

- Python scripting,

- HTML rendering for advanced visualizations,

- Workspace-level defaults for launch configurations,

- Remote debugging,

- Reverse debugging (experimental, requires a compatible backend).

For full details please see [User's Manual](MANUAL.md).


# Languages

The primary focus of this project are the C++ and Rust languages, for which CodeLLDB includes built-in visualizers for

vectors, strings, maps, and other standard library types.


That said, it is usable with most other compiled languages whose compiler generates compatible debugging information,

such as Ada, Fortran, Kotlin Native, Nim, Objective-C, Pascal, [Swift](https://github.com/vadimcn/codelldb/wiki/Swift)

and Zig.

# Supported Platforms

## Host

- Linux with glibc 2.18+ for x86_64, aarch64 or armhf.

- MacOS X 10.10+ for x86_64 and 11.0+ for arm64.

- Windows 10 and 11 for x86_64. [See Windows notes in wiki!](https://github.com/vadimcn/codelldb/wiki/Windows)

## Target

CodeLLDB supports AArch64, ARM, AVR, MSP430, RISCV, X86 architectures and may be used to debug on embedded platforms

via [remote debugging](MANUAL.md#remote-debugging).

# More information

- [CodeLLDB User's Manual](MANUAL.md) - how to use this extension.

- [Debugging in VS Code](https://code.visualstudio.com/docs/editor/debugging) - if you are new to VSCode debugging.

- [LLDB Tutorial](https://lldb.llvm.org/use/tutorial.html) - all of LLDB's CLI commands and scripting features may be used in CodeLLDB.

- [Wiki pages](https://github.com/vadimcn/codelldb/wiki) - [troubleshooting](https://github.com/vadimcn/codelldb/wiki/Troubleshooting) and other tips and tricks.

- [Discussions](https://github.com/vadimcn/codelldb/discussions) - for questions and discussions.

# Screenshots

C++ debugging with data visualization ([Howto](https://github.com/vadimcn/codelldb/wiki/Data-visualization)):


![source](images/plotting.png)







Rust debugging:


![source](images/source.png)