Skip to content

A JIT compiler for Brainfuck running on x86_64 UEFI

License

Notifications You must be signed in to change notification settings

m4tx/uefi-jitfuck

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

uefi-jitfuck

A JIT (Just-In-Time) compiler for Brainfuck programming language running solely on x86_64 UEFI (Universal Extensible Firmware Interface).

Screenshot of uefi-jitfuck inside UEFI Shell

The Lost Kingdom by Jon Ripley - over 2-megabyte adventure text game running inside UEFI Shell with uefi-jitfuck.

Building

Requirements

  • C Compiler, e.g. GCC as well as linker (ld)
  • GNU Make
  • GNU-EFI

Compiling

Just execute:

$ make

in the project root directory. This will create bin/ directory with uefijitfuck.efi executable inside - this is the binary you want to run.

Usage

First, build the project or grab the executable from the Releases page and put it on your ESP (EFI System Partition) along with the programs you want to run. Then, there are several options:

  • Use your motherboard's built-in boot entry editor
  • Add a boot entry using efibootmgr
  • Use a UEFI Shell

If you don't want to run this on your UEFI directly, you can also use OVMF (UEFI firmware for QEMU/KVM).

The application requires one argument: the name of the file containing the Brainfuck program you want to run.