7 releases

0.3.0 Aug 27, 2024
0.2.3 Mar 4, 2024
0.2.2 Feb 29, 2024
0.2.1 Jan 18, 2024
0.1.0 Jul 25, 2023

#396 in Parser implementations

Download history 314/week @ 2024-08-16 477/week @ 2024-08-23 369/week @ 2024-08-30 325/week @ 2024-09-06 294/week @ 2024-09-13 519/week @ 2024-09-20 561/week @ 2024-09-27 918/week @ 2024-10-04 632/week @ 2024-10-11 637/week @ 2024-10-18 649/week @ 2024-10-25 617/week @ 2024-11-01 487/week @ 2024-11-08 535/week @ 2024-11-15 589/week @ 2024-11-22 595/week @ 2024-11-29

2,278 downloads per month
Used in framehop

MIT license

50KB
961 lines

crates.io page docs.rs page

pe-unwind-info

A zero-copy parser for the contents of the .pdata section and unwind info structures (typically addressed by the contents of the .pdata section).

This library provides low-level, efficient parsers for the function tables in .pdata as well as unwind info structures in other places. On top of this functionality, higher-level functionality to unwind an entire frame (given a module's contents) is provided. This only copies data as necessary. No heap allocations are needed.

This currently targets x86_64 PE modules. ARM64 support will be added soon.

This library assumes all information is little-endian: as far as I can tell, Windows always either targets little-endian-only CPUs or configures CPUs which support little- and big-endian to be little-endian.


lib.rs:

Zero-copy parsers of the contents of the .pdata section and unwind information in PE binaries.

On top of these parsers, some higher-level interfaces are provided to easily unwind frames. The parsers and the higher interfaces are written with efficiency in mind, doing minimal copying of data. There is no heap allocation.

Dependencies

~1–1.7MB
~29K SLoC