====== 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.