lyxc ist der Compiler und Linker der Lyx-Sprache. Diese Seite erklärt den praktischen Ablauf eines Builds mit dem aktuellen Compilerstand lyxc 1.2.34B: Eingabe wählen, Units finden, semantisch prüfen, Code erzeugen, Ziel formatieren und das Ergebnis kontrollieren.
Die vollständige Schalterliste steht in der Compiler-Parameter-Referenz. Für größere Projekte ist die Projektdatei *.lpf die zentrale Konfigurationsdatei.
Der einfachste Aufruf ist:
lyxc main.lyx -o build/main
Der Compiler arbeitet dabei in einer durchgehenden Pipeline:
main.lyx
→ Kommandozeile/Projektdatei einlesen
→ Imports und Units finden
→ parsen
→ Namen und Typen prüfen
→ Sicherheits- und Analyseinformationen sammeln
→ IR erzeugen und senken
→ Zielcode/Objektformat schreiben
→ fertiges Programm oder Shared Library ausgeben
Es gibt keinen separaten cc-, as- oder ld-Aufruf und normalerweise keine Objektdateien. lyxc erzeugt direkt das Zielformat. Standardmäßig ist das Ziel die Hostplattform, typischerweise Linux/x86_64.
Datei main.lyx:
unit main;
import std.io;
fn main(): int64 {
PrintLn("Hallo Lyx");
return 0;
}
Build und Ausführung:
$ mkdir -p build
$ lyxc main.lyx -o build/main
$ ./build/main
Hallo Lyx
-o bezeichnet die Ausgabedatei. Das Ausgabeverzeichnis legt lyxc nicht zuverlässig selbst an; mkdir -p build gehört deshalb in das Build-Skript oder wird einmalig vorher ausgeführt.
Version und Hilfe prüft man vor einem Vergleich immer mit demselben Binary:
$ lyxc --version
lyxc 1.2.34B
$ lyxc --help
Das verhindert, dass ein installiertes /usr/local/bin/lyxc mit einem frisch gebauten ./lyxc verwechselt wird.
| Aufruf | Bedeutung |
|---|---|
lyxc main.lyx | baut nach a.out (plattformabhängiger Standard) |
lyxc main.lyx -o app | schreibt genau nach app |
lyxc main.lyx -I src | ergänzt den Unit-Suchpfad |
lyxc main.lyx –target=arm64 -o app | erzeugt Code für ARM64 Linux |
lyxc main.lyx –lint-only | prüft, ohne ein Zielbinary zu schreiben |
lyxc –compile-unit lib.lyx -o lib.lyu | erzeugt eine vorkompilierte .lyu-Unit |
Bei Erfolg endet der Prozess mit Exit 0. Ein unbekannter oder ungültiger Schalter endet mit Exit 2. Quelltext-, Semantik- und Codegen-Fehler liefern einen Fehlerstatus ungleich 0; die konkrete Diagnose steht auf stderr.
Die Sicherheits- und Auditmeldungen erscheinen ebenfalls auf stderr. Ein Skript darf daher stdout und stderr getrennt behandeln:
lyxc main.lyx -o build/main >build/compiler.out 2>build/compiler.err
status=$?
test "$status" -eq 0 || exit "$status"
Lyx-Programme bestehen aus Units. Der Root-Aufruf ist die Datei, die den Einstiegspunkt main enthält; weitere Units werden über import gefunden.
Beispielstruktur:
projekt/
main.lyx
lib/
rechnen.lyx
build/
main.lyx:
unit main;
import rechnen;
import std.io;
fn main(): int64 {
PrintLn(IntToStr(Addiere(20, 22)));
return 0;
}
lib/rechnen.lyx:
unit rechnen;
pub fn Addiere(a: int64, b: int64): int64 {
return a + b;
}
Build:
lyxc main.lyx -I lib -o build/main
-I kann mehrfach angegeben werden. Die Reihenfolge ist relevant, wenn verschiedene Suchpfade gleichnamige Units enthalten:
lyxc main.lyx -I project_units -I vendor_units -o build/main
Die Standardbibliothek wird getrennt vom normalen Include-Pfad gesucht. Ein eigener Standardpfad kann mit –std-path=… bzw. der dafür vorgesehenen Umgebungskonfiguration gesetzt werden. Einzelheiten zur Suchreihenfolge stehen in der Parameter-Referenz.
Ab mehreren Schaltern lohnt sich .lpf. Beispiel projekt.lpf:
[projekt]
quelle = "main.lyx"
ziel = "linux"
ausgabe = "build/main"
[include]
pfade = ["lib", "vendor"]
[schalter]
liste = ["-O2", "--runtime-checks"]
Build:
mkdir -p build
lyxc projekt.lpf
./build/main
Die relativen Pfade beziehen sich auf das Verzeichnis der .lpf, nicht auf das aktuelle Arbeitsverzeichnis. Ein Schalter auf der Kommandozeile kann die Vorgabe aus der Projektdatei überstimmen:
lyxc projekt.lpf --target=arm64 -o build/main-arm64
Pakete werden im Abschnitt [pakete] eingetragen. Dann ruft lyxc für jeden Eintrag den installierten Paketmanager auf:
[pakete]
vega = "0.3.1"
Sinngemäß wird lpm resolve vega 0.3.1 ausgeführt. Die Details zu Registry, Lockfile und Cache stehen im LPM-Integrationskapitel.
Eine Unit kann separat als .lyu geschrieben werden:
mkdir -p build
lyxc --compile-unit lib/rechnen.lyx -o build/rechnen.lyu
Wichtig:
-o ist ausdrücklich erforderlich;.lyu zurückbleiben;
Für normale Projekte ist Vorkompilierung nicht zwingend: lyxc kann importierte .lyx-Units direkt aus dem Suchpfad lesen. .lyu ist vor allem für reproduzierbare Zwischenartefakte, große Projekte oder eine kontrollierte Build-Pipeline interessant.
Der Zielschalter bestimmt Architektur, ABI und Ausgabeformat. Beispiele:
# Linux x86_64 — Standard, explizit angegeben
lyxc main.lyx --target=linux -o build/main
# LyxOS: nativer LYX!-Genesis-Container
lyxc main.lyx --target=lyxos -o build/main.lbf
# LyxOS: alternativ IR-Bytecode im LBF\0-Format
lyxc main.lyx --target=lyxos --emit=lbf -o build/main_ir.lbf
# LyxOS-Kernelziel
lyxc kernel.lyx --target=lyxos-kernel -o build/kernel
# ARM64 Linux
lyxc main.lyx --target=arm64 -o build/main-arm64
# RISC-V Linux
lyxc main.lyx --target=linux-riscv64 -o build/main-riscv64
# Windows x64: PE32+
lyxc main.lyx --target=win64 -o build/main.exe
# macOS Apple Silicon: Mach-O
lyxc main.lyx --target=macos-arm64 -o build/main
lyxos ist kein Linux-Target mit anderem Dateinamen, sondern ein eigenes LyxOS-Ziel. Es erzeugt keinen gewöhnlichen Linux-ELF-Benutzerprozess. Das Ziel kennt zwei relevante Ausgaben:
--emit=lbf: nativer LyxOS-Genesis-Container mit Magic LYX!;--emit=lbf: IR-Bytecode im Format LBF\0.Die IR-/Bytecode-Ausgabe wird so angefordert:
mkdir -p build
lyxc app.lyx --target=lyxos --emit=lbf -o build/app_ir.lbf
Der native LyxOS-Bau enthält unter anderem Sektionen und Capability-TLVs. Der IR-Bau enthält Header, String-Pool, Funktionen und IR-Instruktionen. Beide Ergebnisse sind für die LyxOS-Werkzeuge bzw. Laufzeit bestimmt; sie sind nicht als gewöhnliche Linux-Programme direkt ausführbar.
Für eine erste Prüfung:
file build/app.lbf
lbfdump -x build/app.lbf
lyxos-kernel ist das separate Kernelziel. Es wird nicht als Ersatz für lyxos verwendet, wenn eine normale LyxOS-Anwendung gebaut werden soll:
lyxc kernel.lyx --target=lyxos-kernel -o build/lyxos-kernel
Die LBF-/LyxOS-spezifischen Diagnoseoptionen stehen in der Compiler-Parameter-Referenz, insbesondere --emit=lbf, --dump-ir und --ir-source-map.
Für Cortex-M wird typischerweise ein Bare-Metal-Aufruf verwendet:
lyxc firmware.lyx --target=arm-cm4 --no-libc-init -o build/firmware.elf
–no-libc-init ist ein vom Parser angenommener, nicht in jeder Hilfeversion beworbener Schalter. Für die vollständige Zielmatrix und die Einschränkungen einzelner Backends siehe Cross-Compilation.
Der Standardaufruf verwendet die normale Compileroptimierung. Für Diagnose und Safety-Builds sind insbesondere diese Varianten wichtig:
# Optimierung explizit und Laufzeitprüfungen
lyxc main.lyx -O2 --runtime-checks -o build/main-debug
# Optimierungen für einen energiearmen Zielpfad
lyxc main.lyx --target=arm64 --target-energy=1 -o build/sensor
# Optimierungen beim Eingrenzen eines Codegen-Problems reduzieren
lyxc main.lyx -O0 -o build/main-o0
-O0 und –no-opt sind Diagnosewerkzeuge; sie bedeuten nicht, dass sich alle anderen Backendentscheidungen abschalten lassen. –target-energy=1..5 ist ein eigener Zielpfad für das Energy-Aware-Backend und nicht einfach ein Alias für -O0 bis -O3.
Die Analyseoptionen lassen sich kombinieren:
lyxc flight.lyx --lint --static-analysis --call-graph \
--runtime-checks --provenance -o build/flight
–lint meldet strukturelle und stilistische Probleme;–static-analysis untersucht unter anderem Datenfluss und Stackinformationen;–call-graph erzeugt die statische Aufrufbeziehung;–runtime-checks fordert Laufzeitprüfungen an;–provenance ergänzt Nachweisinformationen zum Build;–mcdc und –mcdc-report behandeln MC/DC-Struktur bzw. Bericht.
–mcdc ist keine Laufzeitinstrumentierung. Wer tatsächliche Testüberdeckung messen will, braucht zusätzlich einen Testaufbau außerhalb dieses Schalters.
Nur prüfen, ohne ein Programm zu schreiben:
lyxc flight.lyx --lint-only
Für die Untersuchung des erzeugten Codes stehen mehrere Ausgaben zur Verfügung:
lyxc main.lyx --emit-asm -o build/main
lyxc main.lyx --asm-listing -o build/main
lyxc main.lyx --dump-relocs -o build/main
lyxc main.lyx --map-file -o build/main
lyxc main.lyx --debug-symbols -o build/main-debug
Je nach Schalter entsteht zusätzlich build/main.asm oder build/main.map bzw. die Information wird in der Compiler-Ausgabe ausgegeben. Diese Dateien sind Diagnose- und Nachweisartefakte; sie ersetzen nicht das eigentliche Zielbinary.
Ein erzeugtes Binary kann anschließend mit den Systemwerkzeugen geprüft werden:
file build/main
readelf -h build/main
readelf -S build/main
Für Lyx-eigene LBF-Ausgaben ist lbfdump zuständig.
Bei einem fehlgeschlagenen Build zuerst die Ebenen trennen:
| Meldungsebene | Typische Ursache | Erster Check |
|---|---|---|
| Kommandozeile | unbekannter Schalter, ungültiger Wert | lyxc –help, Exit 2 |
| Parser | Syntaxfehler, fehlendes Semikolon, falsche Klammer | Datei und gemeldete Zeile |
| Sema | unbekannter Name, Typ- oder Importfehler | -I, Unitname, Signatur |
| LPM/Projekt | Paket nicht auflösbar, lpm fehlt | lpm –version, .lpf und lyx.lock |
| Codegen | Zielbackend oder statischer Startwert nicht darstellbar | mit -O0/anderem –target gegenprüfen |
| Ausgabedatei | Verzeichnis fehlt oder keine Schreibrechte | mkdir -p und Dateirechte |
| Laufzeit | Capability, falsches Ziel-ABI oder Eingabedaten | Audit-Ausgabe und Zielsystem prüfen |
Beispiel für einen bewusst kleinen Diagnoseablauf:
lyxc --version
lyxc --help >/tmp/lyxc-help.txt
mkdir -p build
lyxc main.lyx --lint-only
lyxc main.lyx -O0 -o build/main-o0
file build/main-o0
Wenn –lint-only scheitert, liegt der Fehler vor dem Codegen. Wenn –lint-only gelingt, der normale Build aber nicht, sind Ziel, Ausgabe, Codegen oder ein späterer Integrationsschritt die nächsten Verdächtigen.
Ein reproduzierbarer Build braucht mehr als nur denselben Quelltext:
lyx.toml und .lpf versionieren;lyx.lock einchecken, wenn LPM-Pakete verwendet werden;file, Hash oder readelf prüfen;Beispiel eines einfachen Build-Skripts:
#!/bin/sh
set -eu
mkdir -p build
lyxc --version
lyxc projekt.lpf 2>build/compiler.stderr
file build/main
Für ein Paketprojekt kommt vor dem Build typischerweise lpm install –offline hinzu. Damit wird verhindert, dass ein Build unbemerkt neue Inhalte aus dem Netz holt.
-L/-l-Optionen;–profile gesetzt ist;–mcdc;lyxc main.lyx-Aufruf — die automatische LPM-Integration gehört zur .lpf-Projektdatei und ihrem Abschnitt [pakete].
Letzte Aktualisierung: 2026-11-09 — neue Praxisreferenz gegen lyxc 1.2.34B, Projektdatei- und LPM-Integration abgeglichen.