https://github.com/angr/angr-platforms

A collection of extensions to angr to handle new platforms
https://github.com/angr/angr-platforms

Last synced: 3 months ago
JSON representation

A collection of extensions to angr to handle new platforms

• Host: GitHub
• URL: https://github.com/angr/angr-platforms
• Owner: angr
• License: bsd-2-clause
• Created: 2017-03-23T22:28:04.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2024-06-27T21:28:29.000Z (5 months ago)
• Last Synced: 2024-06-28T00:09:26.197Z (5 months ago)
• Language: Python
• Homepage: http://angr.io/
• Size: 3.57 MB
• Stars: 65
• Watchers: 14
• Forks: 37
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-security-collection - **33**星

README

        
# The angr Platforms collection

This is a collection of extensions to angr to handle new platforms!

> [!WARNING]  

> Many of the platforms in this repo are better supported using angr's pcode engine.

> We highly reccomend you try using that first if it supports your use case, as angr's pcode engine and pypcode are better maintained and there are more people able to help solve any issues you might encounter.

> This repo sees very little development and we cannot promise that any issues here are addressed in a timely manner.

Here you can find the following:

* ```BrainFuck support (yes, really)``` (by @subwire) Includes a arch description, loader, VEX lifter, native symexec engine, SimOS

* ```TI MSP430 Support``` (by @subwire and @nilocunger) Arch, VEX lifter, SimOS; Uses ELF or Blob to load binaries

* ```Berkeley Packet Filter (BPF)``` (by @ltfish) 

* ```CyberTronix64k support``` (by @rhelmot) Demonstrates how to support arches with odd byte-widths (16-bits), and uses memory-mapped registers and mmio.

* ```[WIP] Atmel AVR support``` (by @subwire, and maybe you!) WIP branch at https://github.com/angr/angr-platforms/tree/wip/avr

* ```[WIP] Hitachi SH4 support``` (by @pwnslinger) https://github.com/angr/angr-platforms/tree/wip/ikaruga

* ```Tricore support``` (by @shahinsba) 

The core idea here is that angr and its components are extensible through _registration_ -- a method, such as `pyvex.lifting.register()` can be used to include your out-of-tree code into angr's automatic consideration.

Through these mechanisms, you can write new architectural descriptions, laoders for new binary formats, lifters for new instruction sets, new simulated execution environments (SimOSes).  You can even create entirely new execution engines that operate on instructions other than the VEX IR.

A set of tutorials, providing a walkthrough of these components, how they interact, and how to write them, can be found here: https://github.com/angr/angr-platforms/tree/master/tutorial