====== 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 [[lyx_-_programmiersprache:tools:compiler-parameter|Compiler-Parameter-Referenz]]. Für größere Projekte ist die [[lyx_-_programmiersprache:tools:projektdatei|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 [[lyx_-_programmiersprache:tools:lpm:compiler-integration|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:
* ''-o'' ist 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 ''.lyu'' zurü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 Magic ''LYX!'';
* mit ''%%--%%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 [[lyx_-_programmiersprache:tools:compiler-parameter|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 [[lyx_-_programmiersprache:guides:crosscompiling|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
* ''--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
===== 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 [[lyx_-_programmiersprache:tools:lbfdump|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.toml'' und ''.lpf'' versionieren;
* ''lyx.lock'' einchecken, wenn LPM-Pakete verwendet werden;
* Standardbibliothek und Include-Pfade eindeutig festlegen;
* Zielplattform und relevante Flags im Build-Skript angeben;
* erzeugte Artefakte mit ''file'', Hash oder ''readelf'' prü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 ''--profile'' gesetzt 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.