lyxc in der Praxis — vom Quelltext zum Zielbinary
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.
1. Was ''lyxc'' aus einer Datei macht
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.
2. Erstes vollständiges Programm
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.
3. Eingabe, Ausgabe und Ausführungsstatus
| 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"
4. Units und Imports
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.
5. Projektdatei statt langer Kommandozeile
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.
6. Vorkompilierte Units
Eine Unit kann separat als .lyu geschrieben werden:
mkdir -p build
lyxc --compile-unit lib/rechnen.lyx -o build/rechnen.lyu
Wichtig:
-oist ausdrücklich erforderlich;- der Lauf geht bis in den Codegen, nicht nur bis zur Syntax- und Semantikprüfung;
- bei einem Fehler darf keine scheinbar erfolgreiche
.lyuzurückbleiben; - die Quellen müssen zum Compiler- und Standardbibliotheksstand passen.
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.
7. Zielplattformen und Ausgabeformate
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 und ''.lbf''-Ausgabe
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:
- ohne
--emit=lbf: nativer LyxOS-Genesis-Container mit MagicLYX!; - mit
--emit=lbf: IR-Bytecode im FormatLBF\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.
8. Optimierung und Laufzeitprüfungen
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.
9. Lint, statische Analyse und Nachweise
Die Analyseoptionen lassen sich kombinieren:
lyxc flight.lyx --lint --static-analysis --call-graph \
--runtime-checks --provenance -o build/flight
–lintmeldet strukturelle und stilistische Probleme;–static-analysisuntersucht unter anderem Datenfluss und Stackinformationen;–call-grapherzeugt die statische Aufrufbeziehung;–runtime-checksfordert Laufzeitprüfungen an;–provenanceergänzt Nachweisinformationen zum Build;–mcdcund–mcdc-reportbehandeln 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
10. Assembler, Relokationen und Debug-Information
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.
11. Fehler systematisch eingrenzen
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.
12. Reproduzierbarer Build
Ein reproduzierbarer Build braucht mehr als nur denselben Quelltext:
- Compiler-Binary und Version festhalten;
lyx.tomlund.lpfversionieren;lyx.lockeinchecken, wenn LPM-Pakete verwendet werden;- Standardbibliothek und Include-Pfade eindeutig festlegen;
- Zielplattform und relevante Flags im Build-Skript angeben;
- erzeugte Artefakte mit
file, Hash oderreadelfprüfen; - Compilerdiagnosen aus stderr archivieren, wenn ein Nachweis erforderlich ist.
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.
13. Was ''lyxc'' nicht ist
- kein Make- oder Ninja-Ersatz mit automatischer Dateiabängigkeitsverwaltung;
- kein separater Linker mit
-L/-l-Optionen; - kein Laufzeit-Profiler, nur weil
–profilegesetzt ist; - keine MC/DC-Laufzeitmessung durch
–mcdc; - kein automatischer Paketmanager bei einem direkten
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.
