🎯 Aiming to be a simple cross-platform debugger

@dd86k dd86k authored 24 days ago
.github ci: Fix build library 1 month ago
common cli: Make disassembler list accepted values 1 month ago
debugger Replace x86 machine to i386 1 month ago
dumper Fix disassemble switch not applying 24 days ago
examples Replace adbg_error_msg with adbg_error_message, start adding exports 1 month ago
src/ adbg Update to 0.4.0, update README 1 month ago
tests Redo term module a little 3 months ago
.gitignore dub: Add shared configuration 1 month ago
LICENSE Change License to BSD-3-Clause-Clear 3 months ago
README.md Update to 0.4.0, update README 1 month ago
dscanner.ini Init AVX512F support + VEX/EVEX 2 years ago
dub.sdl platform: Add ADBG_CONFIG, build configuration string 1 month ago
README.md

Alice Debugger Project

Aiming to be a simple cross-platform debugger, binary dumper, and memory scanner.

Fully written in D's BetterC mode, and available as a DUB package.

Features:

  • Debugger
  • Disassembler (using Capstone)
  • Object server

Written from scratch for self-taught educational purposes.

Warnings

⚠️ This is a toy debugger with barely any features ⚠️

There are currently no stable APIs. Every releases pre-1.0 will see frequent changes to the API.

None of the functions are currently thread-safe.

Usage

Usage for alicedbg (Debugger) and alicedump (Dumper) can be looked in the repo Wiki.

The disassembly feature is provided by Capstone 4.0.2.

For Windows, the dynamic library can be downloaded here.

For other platforms, package names are typically:

  • Debian, Ubuntu 22.04, SUSE: libcapstone4
  • Ubuntu 20.04: libcapstone3 (4.0.1)
  • RHEL: capstone-devel
  • Alpine: capstone-dev

Capstone is licensed under the 3-clause BSD license.

Documentation

For information about compilation, internal structures, support, see the repository's Wiki for information.

Contributing

Currently not looking for contributors, sorry. Feel free to provide suggestions regarding contributor management.

License

This project is licensed under the BSD 3-Clause Clear license.