GaspardMake pour GaspardOS x64¶
Port de GNU Make 4.4 vers le SDK newlib LP64 de GaspardOS.
Le binaire est build/GaspardMake.elf, un ELF64 AMD64 statique.
Les sources GNU et leur licence GPL sont conservées dans ce répertoire.
État : port de l'analyseur et du planificateur, pas encore un moteur de
compilation natif complet. Le binaire lit les Makefiles, développe les
variables et affiche les recettes en mode -n. Il refuse l'exécution externe :
le noyau actuel ne fournit pas le code de sortie des processus enfants.
Un lancement réussi ne permet donc pas de savoir si le compilateur a réussi.
Construire depuis Windows / MSYS2¶
Depuis la racine du dépôt, dans MSYS2 MINGW64 :
bash GaspardMake/build-gaspardos.sh
Le script utilise build-x64-install/bin/x86_64-gaspardos-*, configure hors
des sources, compile les adaptateurs et vérifie le format ELF. Prérequis :
toolchain GaspardOS x64 avec newlib, GNU Make hôte, bash et Python.
Il n'exécute jamais le binaire ELF sous Windows.
Après une modification C sans changement de configuration :
bash GaspardMake/build-gaspardos.sh --rebuild
JOBS=4 règle uniquement le parallélisme de la compilation sur l'hôte.
BUILD=/chemin permet de choisir un autre dossier intermédiaire.
Les journaux sont build/gaspardos/configure.log et build.log.
La sortie finale reste build/GaspardMake.elf.
Installer et utiliser¶
Copier build/GaspardMake.elf dans /AHCIDISK0/apps/GaspardMake.elf et placer
le projet sur un volume GFS2 monté. Depuis GaspardTerminal :
run /AHCIDISK0/apps/GaspardMake.elf --version
run /AHCIDISK0/apps/GaspardMake.elf -C /AHCIDISK0/projet -f Makefile -n all
run /AHCIDISK0/apps/GaspardMake.elf -C /AHCIDISK0/projet -n all CC=/usr/bin/gcc
Toujours passer -C avec un chemin absolu : le répertoire courant de
GaspardTerminal n'est pas transmis au processus enfant. Les variables de
GaspardTerminal ne sont pas exportées non plus ; passer les affectations
NOM=valeur comme arguments à Make. Le CRT ne transmet pas de troisième
argument envp : le port utilise environ de newlib.
Exemple de Makefile (les recettes commencent par une tabulation) :
CC = /usr/bin/gcc
CFLAGS = -O2
SOURCES := $(wildcard *.c)
OBJECTS := $(SOURCES:.c=.o)
all: demo.elf
demo.elf: $(OBJECTS)
$(CC) $(OBJECTS) -o $@
%.o: %.c
$(CC) $(CFLAGS) -c $< -o $@
Avec -n, Make affiche les commandes nécessaires. Il ne crée pas les objets.
Comme dans GNU Make, les lignes récursives ou préfixées + peuvent être
tentées même avec -n ; ce port les refuse également.
Couche de portabilité¶
| Fichier | Rôle |
|---|---|
build-aux/config.sub |
Reconnaît l'OS gaspardos. |
ports/gaspardos/config.site |
Corrige les détections que les stubs newlib rendent trompeuses. |
ports/gaspardos/dirent.h, compat.c |
opendir/readdir/closedir, conversion UTF-16 → UTF-8 et erreurs des services absents. |
src/main.c |
Point d'entrée à deux arguments du CRT GaspardOS. |
src/makeint.h |
Évite les anciennes déclarations incompatibles avec les en-têtes newlib. |
src/job.c |
Refuse les recettes au lieu d'inventer une réussite. |
src/function.c |
Refuse explicitement $(shell ...) et les affectations !=. |
Les accès fichiers ordinaires, chemins relatifs et -C utilisent newlib.
L'énumération des répertoires utilise le syscall GO64_fs_readdir.
La compilation désactive la red zone x86-64 et utilise le linker du SDK.
Limites actuelles¶
- Pas d'exécution de compilateurs, de shell, de sous-Make, de pipelines ou de
redirections. Une recette externe produit une erreur, et un statut Make
d'échec.
$(shell ...)et!=arrêtent Make avec un diagnostic. - Pas de jobserver, de parallélisme natif garanti ni de synchronisation des
sorties
-O. Ne pas utiliser ces options pour ce port. - Le SDK initialise les dates de
statà zéro : les décisions de reconstruction incrémentale fondées sur les dates ne sont pas fiables.-B -npermet d'inspecter toutes les recettes indépendamment des dates. Un avertissementCurrent time: Timestamp out of rangeest également possible, car l'horloge POSIX du SDK n'est pas disponible. - Pas de base utilisateurs :
~utilisateurn'est pas résolu. UnHOMEexplicite peut servir aux expansions qui le consultent. - Les noms de volumes et les règles d'accès sont ceux de GaspardOS/GFS2. NLS, Guile et le chargement dynamique ne sont pas activés.
Pour rendre les compilations natives complètes, il reste à exposer des
statuts de fin par enfant, transmettre cwd/environnement, fournir un shell
ou un moteur de recettes, et exposer des dates de modification valides.
Les syscalls 150–152 utilisés par GaspardTerminal ne suffisent pas :
process_status renvoie un nombre d'enfants actifs, pas un code de sortie.
Vérification¶
python tests/gaspardos64/verify_elf.py GaspardMake/build/GaspardMake.elf
python GaspardMake/tests/gaspardos_runtime.py
Le test natif requiert QEMU, NASM, LLD, xorriso, GCC hôte et un noyau GaspardOS
déjà construit. --kernel CHEMIN sélectionne ce noyau. Il fabrique un volume
GFS2 jetable dans build/runtime, utilise QEMU avec snapshot=on et ne touche
aucun disque physique. Les sondes sont liées aux mêmes objets que le binaire,
avec un point d'entrée de test qui prépare ses fichiers et arguments.
Il lance aussi le véritable GaspardMake.elf par le syscall de création de
processus et vérifie sa sortie en mode -n, sans modifier son point d'entrée.
Les sorties série sont conservées dans build/runtime/*-serial.log.
La suite GNU Make complète exige un shell POSIX et n'est pas validée sur ce port.
Vérifié le 11 novembre 2026 : validation ELF64 et cinq cas QEMU réussis
(dry-run, version, recipe-error, shell-error, actual-binary).