Fork: 0
dd86k / alicedbg
7 releases
v0.4.1
c8ffe43
26 days ago

0.4.1

@dd86k dd86k released this 16 days ago

Fix disassemble switch not applying in the alicedump configuration.
v0.4.0
ddfa846
on 23 May

0.4

@dd86k dd86k released this on 23 May

Overview

Minor release featuring various work on object dumping.

New License

The license was changed from BSD-3-Clause to BSD-3-Clause-Clear.

New CLI Module

A new CLI module was introduced to keep options and behaviors consistent in both Alicedbg and Alicedump.

Long format options now require the equal sign (--example=) with options that requires a value.

New Alicedump Configuration

A new Alicedump configuration was created with its own set of options, to avoid polluting the debugger's set of options.

Alicedump is a direct alternative, but still work-in-progress, to tools such as objdump(1), nm(1), and readelf(1).

By default, without any specific data requested, a file(1)-like output is provided:

$ alicedump alicedump
alicedump: Executable and Linkable Format (elf), Executable, for AMD x86-64 (amd64) machines

$ alicedump alicedump.exe
alicedump.exe: Portable Executable (pe32), Executable, for AMD x86-64 (amd64) machines

The --extract option was added to allow for some binary information to be set to stdout, allowing data to be piped to other tools.

The --hexdump option was added to allow for some binary information to be hexdumped and formatted on screen.

Support for OMF objects and libraries were initiated.

New Shared Configuration

The Alicedbg library can now be compiled as a shared object (also known as a dynamically linked library).

Notes

The Linux static builds should work regardless of the host C runtime environment, such as glibc, because the executables do not rely on the host C runtime and includes its own.

Changelog

  • cli: Change --debug-info to --build-info.
  • cli: Change -a|--arch to -m|--machine=.
  • debugger: Align disassembly output.
  • debugger: disassemble command uses EIP or RIP by default if no memory location was given.
  • dumper: Now available as a alicedump command.
  • dumper: Add a new "Summary View", which is the new default, and outputs information in a file(1) style format.
  • dumper: Add --hexdump. Certain elements can be dumped using Alicedump's internal hexdump printer.
  • dumper: Remove redundant quotes for UNIX archive (ar) names.
  • dumper: Able to dump all UNIX archive (ar) headers.
  • library: Add missing OS values for LX objects.
  • library: Add missing header flags and OS values for NE objects.
  • library: Add XBOX Code Catalog subsystem value for PE objects.
  • library: Add VC Feature debug structure for PE objects.
  • library: Limit to 96 sections when selecting a PE section, not when loading, as per spec.
  • library: Start support for OMF objects and libraries.
  • library: Add support for ELF dynamic symbols. Sort of.
  • library: x86 machine was renamed to i386 for consistency.
  • library: Return "le" as a short name if it is one (LX).
v0.3.0
0b88b82
on 16 Mar

0.3

@dd86k dd86k released this on 16 Mar

This release features new APIs and new additions for the dumper for informative reasons.

A crash handler was introduced in the application, and hopefully in the long-term future, the debugger can force itself in.

The plan for version 0.4 can be viewed on GitHub.

Changelog

  • cli: Add --debug-version and dump the build information there. Will be renamed in a later release.
  • dumper: Add support for Library Archives (.lib), header only.
  • dumper: Add support for coredumps, x86-64 only, header only.
  • dumper: Add support for Windows memory dumps, x86 and x86-64 only, header only.
  • dumper: Add support for Minidumps, header only.
  • dumper: Add support for PDB 7.0 stream information. This will help support source debugging.
  • dumper: Add the remaining header fields for PDB 2.0.
  • dumper: Add support for COFF objects for x86, x86-IAX, x86-64, Z80, some TI and some MIPS platforms (excluding ECOFF). Header only.
  • dumper: Add (untested) support for MS-COFF anonymous objects, header only.
  • shell: Add plist command to list running processes.
  • shell: Fix go, restart commands. Make go a little prettier.
  • shell: The memory command now has an ASCII column.
  • shell: Reworked the way readline works. Should be a little more consistent with the host console/terminal application.
  • library: Add self module for self-diagnosis, crash handling. Used with the application.
  • library: Add missing fields for NE executables.
  • library: Enhance memory transfer speed on Linux when possible.
  • library: Fix debugger continuing with attached processes on Windows.
  • library: Fix Android build.
  • library: PE32 images are now limited to 96 sections as per specification (v11, 2017).
v0.2.0
83c5dd2
on 17 Jan

0.2

@dd86k dd86k released this on 17 Jan

I've been busy catching up!

While it's still a toy debugger, I'm hoping to chew my own food one day... At least, the current focus is the object server, as it allows me to view inside executable images and how to better parse them. I'd like to continue working on the PDB parser (and obviously support DWARF) for the next version, as any other good debuggers.

Changelog

  • app: Add --dump-everything option to dump everything but disassembly.
  • app: Enhance dump options.
    • Changes the old options of --dump --show xyz to just --dump-* for readability.
    • Example: Instead of -D --show i, use --dump-imports.
  • app: Fix printing ELF program headers.
  • app: Fix printing PE imports and exports.
  • app: Fix MZ disassembly.
  • app: Fix shell not attaching to process when indicated via CLI.
  • app: Fix base address for blob disassembly.
  • lib: Add a custom dynamic library loader to replace BindBC.
  • lib: Add support for getting process memory map on Windows with full paths.
  • lib: Add support for NE and LX executables, including dumping. (header only)
  • lib: Add support for PDB 7.0 debug objects, including dumping. (header only)
  • lib: Add detecting POGO and Portable PDB debug entries for PE executables.
  • lib: Add getting pagesize.
  • lib: Add support to enumerate running processes.
  • lib: Improve bound-checking for object server.
  • lib: Improve scenarios loading MZ executables.

Notes:

  • The musl static build should work as-is in other environments, such as glibc.
  • I couldn't formulate some changelog items... I'll try to keep my commit consistency better.
v0.1.0
141556b
on 20 Oct

0.1

@dd86k dd86k released this on 20 Oct

After 228 commits, wow, I finally made it.

Giving up on the x86 decoder multiple times, embracing Capstone, redoing the entire API...

It's still not done. You can't do much with it, but, I plan to release 0.2 early 2024 with something more useful.

Changelog

  • Add API V2:
    • Add primitive memory scanner.
    • Make the debugger to be process-focused instead of itself.
    • Make disassembler to use Capstone 4.0.
  • Deprecate API V1.
  • Make application use API V2.
  • Shell: Add scan command.
  • Shell: Add status command.
  • Shell: Add detach command.
  • Shell: Add memory command.
  • Shell: Add restart command.
  • Shell: Introduce manpage-like articles for commands.
  • Shell: Make regs command search register with an optional parameter.
v0.1-alpha.1
b4804c0
on 14 Oct
cli: Change synopsis
v0.0.1
bac71f4
on 20 Mar 2021

alicedbg v0.0.1

@dd86k dd86k released this on 20 Mar 2021

Initial release.

FAQ

  • Can I use this?
    • I hope you don't
  • Binaries where?
    • I really hope you don't use this
  • Do you need help?
    • Not at the moment
  • DUB registry when?
    • Maybe at 0.1
  • Are you asking yourself these questions?
    • Yes

Contributors