Skip to content

Latest commit

 

History

History
35 lines (26 loc) · 1.41 KB

TOOLS.adoc

File metadata and controls

35 lines (26 loc) · 1.41 KB
Raw

project metal: tools

The Gradle Metal driver requires a JDK 17 in either JAVA_HOME or PATH. It is an application of the Gradle build tool.

Generally, tools will be found in the system PATH. This may be replaced with a custom tools path in gradle property metal.path. To set Gradle properties, look here.

For assembling main components, LLVM is required. Versions 16 and 17 are known to work. Metal employs LLVM’s cross-compilation capabilities.

For assembling Multiboot2 system test programs, GNU GRUB 2 is required. Currently, Metal creates "standalone" images for test programs.

For running system test programs, QEMU is required. Versions from 6.0 up to 7.2 are known to work. Versions 8.0 or more recent are known to not work. For more information, see TEST.

Microsoft Windows

Windows 10 and 11 are known to work.

Quick start:

  1. Install any JDK 17

  2. Set JAVA_HOME to JDK 17

  3. Install Visual Studio Build Tools 2022

  4. Install LLVM 17 for Windows from https://github.com/llvm/llvm-project/releases

  5. Install GNU GRUB 2.06 for Windows from https://ftp.gnu.org/gnu/grub/

  6. Install QEMU 7.2 for Windows (qemu-w64-setup-20221230) from https://qemu.weilnetz.de/w64/

  7. Edit gradle.properties setting metal.path with the appropriate values