Skip to content

zolutal/dwat

Repository files navigation

dwat

A fairly performant library intended to make DWARF (v4/v5) debugging information more accessible.

My focus so far has been on making the type information (specifically structs) present in DWARF info easier to work with, so functionality related to that is largely what is implemented at this point.

Current Features:

  • Get a list of types by name
  • Get a map of types by name
  • Lookup types by name
  • Formating of parsed struct and union information to C-style definitions
  • Get members of structs/unions
  • Get underlying types of modifiers (volatile/const/etc...)
  • Get byte size information for types
  • Get bit sizes for bit field struct members

CLI

Though dwat is primarily meant to be a library, a basic cli is included:

Usage: dwat <COMMAND>

Commands:
  lookup  Find and display a single struct
  dump    Find and display all structs
  help    Print this message or the help of the given subcommand(s)

Options:
  -h, --help  Print help

Python bindings

dwat has python bindings! The documentation can be found here: https://zolutal.github.io/dwat/

Examples

There are several examples in the examples directory that are worth checking out.

Usage

The first step of using the library is to load the file containing DWARF info into memory, then invoke Dwarf::load:

    let file = File::open(path)?;
    let mmap = unsafe { Mmap::map(&file) }?;

    let dwarf = Dwarf::load(&*mmap)?;

The dwarf object has a lookup_type method that can be used to lookup any type implementing the Tagged trait by name, in this case a struct will be searched for:

    let found = dwarf.lookup_type::<dwat::Struct>(struct_name)?;

Struct members can then be retrieved by calling .members() which returns a Vector of Member structs.

    let members = struc.members(&dwarf)?;

A struct object can be converted to a C-style definition String by invoking the to_string function:

    if let Some(found) = found {
        println!("{}", found.to_string(&dwarf)?);
    }