libgccjit

This document describes libgccjit, an API for embedding GCC inside programs and libraries.

Note that libgccjit is currently of “Alpha” quality; the APIs are not yet set in stone, and they shouldn’t be used in production yet.

There are actually two APIs for the library:

• a pure C API: libgccjit.h
• a C++ wrapper API: libgccjit++.h. This is a collection of “thin” wrapper classes around the C API, to save typing.

Contents:

• Tutorial
  • Tutorial part 1: “Hello world”
  • Tutorial part 2: Creating a trivial machine code function
  • Tutorial part 3: Loops and variables
  • Tutorial part 4: Adding JIT-compilation to a toy interpreter
  • Tutorial part 5: Implementing an Ahead-of-Time compiler
• Topic Reference
  • Compilation contexts
  • Objects
  • Types
  • Expressions
  • Creating and using functions
  • Source Locations
  • Compiling a context
  • ABI and API compatibility
  • Performance
• C++ bindings for libgccjit
  • Tutorial
  • Topic Reference
• Internals
  • Working on the JIT library
  • Running the test suite
  • Environment variables
  • Packaging notes
  • Overview of code structure
  • Design notes
  • Submitting patches

Indices and tables

• Index
• Module Index
• Search Page