Skip to content

Latest commit

 

History

History
48 lines (25 loc) · 1.63 KB

interfacing_with_cwerg.md

File metadata and controls

48 lines (25 loc) · 1.63 KB
Raw

Interfacing With Cwerg

Cwerg includes several components that might be helpful for other compiler projects:

  • the full backend
  • the Arm32 assembler (A32)
  • the Aarch64 assembler (A64)
  • the X86-64 assembler (X64)

All 4 components have Python3 and C++ implementations which can be used as libraries. C bindings wrapping parts of the C++ API also exist.

The components can be used:

  1. AOT style emitting to ELF images or
  2. JIT style emitting to memory where the code can be called directly

In addition, the full backend can emit textual assembler (albeit Cwerg flavored).

Besides using the components programmatically as libraries, there are also standalone exectuables that accept textual input.

Ports to other languages should be straight forward as all components are heavily table driven. Please contact the author if you need help with porting or have suggestions for making the code base easier to interface.

Examples for JITing can be found in Examples.

The Python3 implementation of the A32 assembler can be found at CpuA32/assembler_tool.py. CpuA32/Makefile has many usage examples as part of the $(DIR)/%.test target.

The A64 and X64 assemblers follow the same organization.

The full backend comes in 3 variants, one for each target architecture:

The Python3 implementation of the codegenerator (Cwert IR -> target code) lives in codegen.py. Usage examples are provided by the $(DIR)/%.asm.exe targets in the Makefile.