initial commit - doom port

2026-08-07 17:05:34 +02:00
commit 0e5e33ac0e
13 changed files with 997 additions and 0 deletions
@@ -0,0 +1,131 @@
+# port.mk - Shared rules for MontaukOS ports.
+#
+# A port builds against a MontaukOS checkout (the SDK) and produces an app
+# bundle in $(OUTDIR)/apps/<name>/ containing:
+#
+#     <name>.elf      the binary
+#     manifest.toml   launcher metadata (name, binary, icon, category)
+#     <icon>.svg      the launcher icon
+#     .port           marker so the OS release step can tell ports from
+#                     in-tree apps (see MontaukOS scripts/install_apps.sh)
+#
+# The desktop readdirs 0:/apps/ at runtime and parses each manifest.toml, so a
+# bundle dropped into the ramdisk needs no changes anywhere in the OS tree.
+#
+# A port Makefile sets PORT_NAME, PORT_ICON and its own sources/flags, then
+# includes this file and uses $(BUNDLE_DIR) as its link target directory.
+
+MAKEFLAGS += -rR
+.SUFFIXES:
+
+# This file defines rules before the including Makefile does, so pin the
+# default goal rather than letting the first bundle rule claim it.
+.DEFAULT_GOAL := all
+
+# ==== Repo root =======================================================
+# Derived from this file's own location so a port builds the same whether it
+# is invoked from the top-level Makefile or directly with `make -C <cat>/<port>`,
+# and regardless of how deeply categories nest it.
+
+PORT_MK_DIR   := $(patsubst %/,%,$(dir $(lastword $(MAKEFILE_LIST))))
+MTKPORTS_ROOT := $(abspath $(PORT_MK_DIR)/..)
+
+# ==== SDK location ====================================================
+# Ports build against a live MontaukOS checkout rather than a copied
+# sysroot, so libc/header changes are picked up without a sync step.
+
+MONTAUKOS ?= $(HOME)/dev/MontaukOS
+
+ifeq ($(wildcard $(MONTAUKOS)/programs/link.ld),)
+    $(error MontaukOS tree not found at $(MONTAUKOS). Pass MONTAUKOS=/path/to/MontaukOS)
+endif
+
+# ==== Toolchain =======================================================
+
+TOOLCHAIN_PREFIX := $(MONTAUKOS)/toolchain/local/bin/x86_64-montauk-
+
+ifeq ($(wildcard $(TOOLCHAIN_PREFIX)gcc),)
+    $(error x86_64-montauk toolchain not found. Run $(MONTAUKOS)/toolchain/build-montauk-toolchain.sh first)
+endif
+
+CC  := $(TOOLCHAIN_PREFIX)gcc
+CXX := $(TOOLCHAIN_PREFIX)g++
+AR  := $(TOOLCHAIN_PREFIX)ar
+LD  := $(TOOLCHAIN_PREFIX)gcc
+
+# ==== SDK paths =======================================================
+
+SDK_INC     := $(MONTAUKOS)/programs/include
+SDK_LIBC_INC:= $(MONTAUKOS)/programs/include/libc
+SDK_LIB     := $(MONTAUKOS)/programs/lib
+SDK_LINK_LD := $(MONTAUKOS)/programs/link.ld
+
+LIBC_A      := $(SDK_LIB)/libc/liblibc.a
+LIBLOADER_A := $(SDK_LIB)/libloader/liblibloader.a
+LIBTLS_A    := $(SDK_LIB)/tls/libtls.a
+LIBBEARSSL_A:= $(SDK_LIB)/bearssl/libbearssl.a
+LIBJPEG_A   := $(SDK_LIB)/libjpeg/libjpeg.a
+
+# The kernel ABI version this port is being built against. Recorded in the
+# bundle so a stale port can be spotted after a syscall/ABI bump rather than
+# crashing mysteriously at runtime.
+SDK_API_VERSION := $(shell sed -n 's/.*apiVersion = \([0-9]\+\);.*/\1/p' \
+                     $(MONTAUKOS)/kernel/src/Api/Info.hpp 2>/dev/null | head -1)
+
+# ==== Output ==========================================================
+
+OUTDIR     ?= $(MTKPORTS_ROOT)/out
+BUNDLE_DIR := $(OUTDIR)/apps/$(PORT_NAME)
+OBJDIR     ?= obj
+TARGET     := $(BUNDLE_DIR)/$(PORT_NAME).elf
+
+# ==== Common flags ====================================================
+# Mirrors the in-tree convention: freestanding, no stdlib, linked with the
+# shared program link script.
+
+PORT_CFLAGS_COMMON := \
+    -g -O2 -pipe \
+    -ffreestanding \
+    -fno-stack-protector \
+    -fno-stack-check \
+    -ffunction-sections \
+    -fdata-sections \
+    -msse \
+    -msse2 \
+    -isystem $(SDK_LIBC_INC) \
+    -I $(SDK_INC)
+
+PORT_LDFLAGS_COMMON := \
+    -nostdlib \
+    -Wl,--gc-sections \
+    -T $(SDK_LINK_LD)
+
+# ==== Bundle assembly =================================================
+# Ports depend on $(BUNDLE_FILES) to get manifest + icon + marker staged
+# alongside the ELF their link rule produces.
+
+BUNDLE_FILES := $(BUNDLE_DIR)/manifest.toml $(BUNDLE_DIR)/.port
+ifneq ($(PORT_ICON),)
+    BUNDLE_FILES += $(BUNDLE_DIR)/$(PORT_ICON)
+endif
+
+$(BUNDLE_DIR)/manifest.toml: manifest.toml | $(BUNDLE_DIR)
+	cp $< $@
+
+$(BUNDLE_DIR)/$(PORT_ICON): $(PORT_ICON) | $(BUNDLE_DIR)
+	cp $< $@
+
+# Marker file consumed by the MontaukOS release step to prune ports from a
+# base ISO. Carries the ABI version so mismatches are diagnosable.
+$(BUNDLE_DIR)/.port: Makefile | $(BUNDLE_DIR)
+	printf 'port = "%s"\napi_version = "%s"\n' '$(PORT_NAME)' '$(SDK_API_VERSION)' > $@
+
+$(BUNDLE_DIR):
+	mkdir -p $@
+
+.PHONY: bundle
+bundle: $(TARGET) $(BUNDLE_FILES)
+
+.PHONY: clean-bundle
+clean-bundle:
+	rm -rf $(OBJDIR) $(BUNDLE_DIR)