Seminar PTXdist Toolchains, Cross-Compilation und Sysroots

Das Seminar vertieft die technische Grundlage jedes PTXdist-Builds: Cross-Toolchain und Sysroots. Compiler, Binutils, C-Bibliothek, ABI, pkg-config, Hostwerkzeuge und Zielbibliotheken werden klar getrennt. Externe Toolchains, SDKs und typische Fehlerbilder werden praktisch untersucht.

Inhaltsverzeichnis

1. Einordnung und Zielbild
2. Zielgruppe
3. Voraussetzungen
4. Lernziele
5. Thematische Module
   1. Toolchain-Bestandteile und Zieltuple
   2. ABI, CPU und Gleitkomma
   3. Host-, Cross- und Target-Sysroots
   4. Compiler- und Linkersuchpfade
   5. pkg-config im Cross-Build
   6. Externe Toolchain integrieren
   7. SDK und Entwicklungsübergabe
   8. Fehleranalyse und Reproduzierbarkeit
6. Praxisarbeiten
7. Qualitätssicherung

Einordnung und Zielbild

Das Seminar vertieft die technische Grundlage jedes PTXdist-Builds: Cross-Toolchain und Sysroots. Compiler, Binutils, C-Bibliothek, ABI, pkg-config, Hostwerkzeuge und Zielbibliotheken werden klar getrennt. Externe Toolchains, SDKs und typische Fehlerbilder werden praktisch untersucht.

Zielgruppe

Embedded-Linux-Entwickler, BSP-Entwickler, Paketmaintainer, Build-Engineers und Integratoren mit Bedarf an tieferem Cross-Compilation-Verständnis.

Voraussetzungen

Linux-Shell, grundlegende C- und Compilerkenntnisse sowie erste Erfahrung mit PTXdist oder einem vergleichbaren Cross-Buildsystem.

Lernziele

• Bestandteile, Zieltuple und ABI einer Cross-Toolchain beurteilen.
• Host-, Cross- und Target-Sysroot ohne Pfadvermischung einsetzen.
• Compiler-, Linker- und pkg-config-Aufrufe nachvollziehen.
• Externe Toolchains und SDK-Ausgaben kontrolliert integrieren.
• Architektur-, ABI-, Header-, Bibliotheks- und Laufzeitfehler diagnostizieren.

Thematische Module

1. Toolchain-Bestandteile und Zieltuple

Dieser Baustein behandelt Compiler, Assembler, Linker, Binutils, C-Bibliothek, Architektur, Hersteller, System, ABI und Testobjekt. Die Bearbeitung folgt einer festen Reihenfolge aus Bestandsaufnahme, deklarativer Änderung, gezieltem Build, Artefaktprüfung und reproduzierbarer Verifikation.

1. Ausgangsstand und technische Randbedingungen für Compiler, Assembler, Linker, Binutils, C-Bibliothek, Architektur, Hersteller, System, ABI und Testobjekt erfassen.
2. Tatsächlich verwendete Werkzeuge, Zieltuple, Suchpfade und wirksame Plattformoptionen aus Konfiguration und Buildlog bestimmen.
3. Host-, Cross- und Target-Bestandteile trennen und nicht deklarierte Pfade oder Architekturvermischungen entfernen.
4. Eine minimale Konfigurations- oder Abhängigkeitsänderung umsetzen und die betroffene Komponente gezielt neu bauen.
5. Binärformat, Symbole, Interpreter, Bibliotheksabhängigkeiten und Laufzeitverhalten am erzeugten Artefakt prüfen.
6. Den Kontrollpunkt für Compiler, Assembler, Linker, Binutils, C-Bibliothek, Architektur, Hersteller, System, ABI und Testobjekt mit einem klaren Sollzustand und einem reproduzierbaren Test festlegen.
7. Die verwendeten Eingaben, Konfigurationsstände, Kommandos und erzeugten Artefakte für Review und Wiederholung dokumentieren.

2. ABI, CPU und Gleitkomma

Dieser Baustein behandelt CPU-Familie, Instruktionssatz, Endianness, Wortbreite, Floating-Point-ABI, Compilerflags und inkompatible Objekte. Die Bearbeitung folgt einer festen Reihenfolge aus Bestandsaufnahme, deklarativer Änderung, gezieltem Build, Artefaktprüfung und reproduzierbarer Verifikation.

1. Ausgangsstand und technische Randbedingungen für CPU-Familie, Instruktionssatz, Endianness, Wortbreite, Floating-Point-ABI, Compilerflags und inkompatible Objekte erfassen.
2. Tatsächlich verwendete Werkzeuge, Zieltuple, Suchpfade und wirksame Plattformoptionen aus Konfiguration und Buildlog bestimmen.
3. Host-, Cross- und Target-Bestandteile trennen und nicht deklarierte Pfade oder Architekturvermischungen entfernen.
4. Eine minimale Konfigurations- oder Abhängigkeitsänderung umsetzen und die betroffene Komponente gezielt neu bauen.
5. Binärformat, Symbole, Interpreter, Bibliotheksabhängigkeiten und Laufzeitverhalten am erzeugten Artefakt prüfen.
6. Den Kontrollpunkt für CPU-Familie, Instruktionssatz, Endianness, Wortbreite, Floating-Point-ABI, Compilerflags und inkompatible Objekte mit einem klaren Sollzustand und einem reproduzierbaren Test festlegen.
7. Die verwendeten Eingaben, Konfigurationsstände, Kommandos und erzeugten Artefakte für Review und Wiederholung dokumentieren.

3. Host-, Cross- und Target-Sysroots

Dieser Baustein behandelt Ausführungsort, Header, Bibliotheken, Programme, Architekturkontrolle, Pfadvermischung und klare Zuständigkeit. Die Bearbeitung folgt einer festen Reihenfolge aus Bestandsaufnahme, deklarativer Änderung, gezieltem Build, Artefaktprüfung und reproduzierbarer Verifikation.

1. Ausgangsstand und technische Randbedingungen für Ausführungsort, Header, Bibliotheken, Programme, Architekturkontrolle, Pfadvermischung und klare Zuständigkeit erfassen.
2. Tatsächlich verwendete Werkzeuge, Zieltuple, Suchpfade und wirksame Plattformoptionen aus Konfiguration und Buildlog bestimmen.
3. Host-, Cross- und Target-Bestandteile trennen und nicht deklarierte Pfade oder Architekturvermischungen entfernen.
4. Eine minimale Konfigurations- oder Abhängigkeitsänderung umsetzen und die betroffene Komponente gezielt neu bauen.
5. Binärformat, Symbole, Interpreter, Bibliotheksabhängigkeiten und Laufzeitverhalten am erzeugten Artefakt prüfen.
6. Den Kontrollpunkt für Ausführungsort, Header, Bibliotheken, Programme, Architekturkontrolle, Pfadvermischung und klare Zuständigkeit mit einem klaren Sollzustand und einem reproduzierbaren Test festlegen.
7. Die verwendeten Eingaben, Konfigurationsstände, Kommandos und erzeugten Artefakte für Review und Wiederholung dokumentieren.

4. Compiler- und Linkersuchpfade

Dieser Baustein behandelt Include-Suche, Bibliothekssuche, Linkeraufruf, RPATH, Interpreter, dynamische Abhängigkeiten und Paketabhängigkeit. Die Bearbeitung folgt einer festen Reihenfolge aus Bestandsaufnahme, deklarativer Änderung, gezieltem Build, Artefaktprüfung und reproduzierbarer Verifikation.

1. Ausgangsstand und technische Randbedingungen für Include-Suche, Bibliothekssuche, Linkeraufruf, RPATH, Interpreter, dynamische Abhängigkeiten und Paketabhängigkeit erfassen.
2. Tatsächlich verwendete Werkzeuge, Zieltuple, Suchpfade und wirksame Plattformoptionen aus Konfiguration und Buildlog bestimmen.
3. Host-, Cross- und Target-Bestandteile trennen und nicht deklarierte Pfade oder Architekturvermischungen entfernen.
4. Eine minimale Konfigurations- oder Abhängigkeitsänderung umsetzen und die betroffene Komponente gezielt neu bauen.
5. Binärformat, Symbole, Interpreter, Bibliotheksabhängigkeiten und Laufzeitverhalten am erzeugten Artefakt prüfen.
6. Den Kontrollpunkt für Include-Suche, Bibliothekssuche, Linkeraufruf, RPATH, Interpreter, dynamische Abhängigkeiten und Paketabhängigkeit mit einem klaren Sollzustand und einem reproduzierbaren Test festlegen.
7. Die verwendeten Eingaben, Konfigurationsstände, Kommandos und erzeugten Artefakte für Review und Wiederholung dokumentieren.

5. pkg-config im Cross-Build

Dieser Baustein behandelt pc-Datei, Ziel-Sysroot, Suchpfad, Include-Flags, Linkerflags, Hostdatei und deklarierte Lieferabhängigkeit. Die Bearbeitung folgt einer festen Reihenfolge aus Bestandsaufnahme, deklarativer Änderung, gezieltem Build, Artefaktprüfung und reproduzierbarer Verifikation.

1. Ausgangsstand und technische Randbedingungen für pc-Datei, Ziel-Sysroot, Suchpfad, Include-Flags, Linkerflags, Hostdatei und deklarierte Lieferabhängigkeit erfassen.
2. Tatsächlich verwendete Werkzeuge, Zieltuple, Suchpfade und wirksame Plattformoptionen aus Konfiguration und Buildlog bestimmen.
3. Host-, Cross- und Target-Bestandteile trennen und nicht deklarierte Pfade oder Architekturvermischungen entfernen.
4. Eine minimale Konfigurations- oder Abhängigkeitsänderung umsetzen und die betroffene Komponente gezielt neu bauen.
5. Binärformat, Symbole, Interpreter, Bibliotheksabhängigkeiten und Laufzeitverhalten am erzeugten Artefakt prüfen.
6. Den Kontrollpunkt für pc-Datei, Ziel-Sysroot, Suchpfad, Include-Flags, Linkerflags, Hostdatei und deklarierte Lieferabhängigkeit mit einem klaren Sollzustand und einem reproduzierbaren Test festlegen.
7. Die verwendeten Eingaben, Konfigurationsstände, Kommandos und erzeugten Artefakte für Review und Wiederholung dokumentieren.

6. Externe Toolchain integrieren

Dieser Baustein behandelt Archivstruktur, Toolpräfix, Compiler, Sysroot, C-Bibliothek, Plattformauswahl, Referenzpaket und Gesamtbuild. Die Bearbeitung folgt einer festen Reihenfolge aus Bestandsaufnahme, deklarativer Änderung, gezieltem Build, Artefaktprüfung und reproduzierbarer Verifikation.

1. Ausgangsstand und technische Randbedingungen für Archivstruktur, Toolpräfix, Compiler, Sysroot, C-Bibliothek, Plattformauswahl, Referenzpaket und Gesamtbuild erfassen.
2. Tatsächlich verwendete Werkzeuge, Zieltuple, Suchpfade und wirksame Plattformoptionen aus Konfiguration und Buildlog bestimmen.
3. Host-, Cross- und Target-Bestandteile trennen und nicht deklarierte Pfade oder Architekturvermischungen entfernen.
4. Eine minimale Konfigurations- oder Abhängigkeitsänderung umsetzen und die betroffene Komponente gezielt neu bauen.
5. Binärformat, Symbole, Interpreter, Bibliotheksabhängigkeiten und Laufzeitverhalten am erzeugten Artefakt prüfen.
6. Den Kontrollpunkt für Archivstruktur, Toolpräfix, Compiler, Sysroot, C-Bibliothek, Plattformauswahl, Referenzpaket und Gesamtbuild mit einem klaren Sollzustand und einem reproduzierbaren Test festlegen.
7. Die verwendeten Eingaben, Konfigurationsstände, Kommandos und erzeugten Artefakte für Review und Wiederholung dokumentieren.

7. SDK und Entwicklungsübergabe

Dieser Baustein behandelt Compiler, Header, Bibliotheken, Metadaten, SDK-Artefakt, Umgebungsskript, Pfadisolation und Beispielanwendung. Die Bearbeitung folgt einer festen Reihenfolge aus Bestandsaufnahme, deklarativer Änderung, gezieltem Build, Artefaktprüfung und reproduzierbarer Verifikation.

1. Ausgangslage, Randbedingungen und erwarteten Sollzustand für Compiler, Header, Bibliotheken, Metadaten, SDK-Artefakt, Umgebungsskript, Pfadisolation und Beispielanwendung erfassen.
2. Relevante PTXdist-Konfigurationen, Regeln, Patches, Abhängigkeiten und Ergebnisartefakte zuordnen.
3. Änderung in kleine, überprüfbare Arbeitsschritte zerlegen und den ersten Schritt kontrolliert umsetzen.
4. Betroffene Komponente gezielt bauen und Logs sowie erzeugte Dateien auf Abweichungen prüfen.
5. Funktion im Zielsystem oder in einer isolierten Testumgebung verifizieren und den Stand reproduzierbar sichern.
6. Den Kontrollpunkt für Compiler, Header, Bibliotheken, Metadaten, SDK-Artefakt, Umgebungsskript, Pfadisolation und Beispielanwendung mit einem klaren Sollzustand und einem reproduzierbaren Test festlegen.
7. Die verwendeten Eingaben, Konfigurationsstände, Kommandos und erzeugten Artefakte für Review und Wiederholung dokumentieren.

8. Fehleranalyse und Reproduzierbarkeit

Dieser Baustein behandelt vollständiger Befehl, Architektur, ABI, Symbole, Hostpfade, Konfigurationskorrektur und sauberer Rebuild. Die Bearbeitung folgt einer festen Reihenfolge aus Bestandsaufnahme, deklarativer Änderung, gezieltem Build, Artefaktprüfung und reproduzierbarer Verifikation.

1. Fehlerbild, Ausgangsstand, Reproduktionskommando und Erfolgskriterium für vollständiger Befehl, Architektur, ABI, Symbole, Hostpfade, Konfigurationskorrektur und sauberer Rebuild festhalten.
2. Erste abweichende Buildstufe, Bootübergabe, Datei, Meldung oder Laufzeitbeobachtung bestimmen.
3. Hypothese durch genau eine kontrollierte Änderung prüfen und betroffene Komponente gezielt neu bauen.
4. Logs, Umgebung, Binärartefakte und Zielzustand vor und nach der Änderung vergleichen.
5. Bestätigte Ursache mit minimaler Korrektur, Positivtest, Negativtest und Regressionstest absichern.
6. Den Kontrollpunkt für vollständiger Befehl, Architektur, ABI, Symbole, Hostpfade, Konfigurationskorrektur und sauberer Rebuild mit einem klaren Sollzustand und einem reproduzierbaren Test festlegen.
7. Die verwendeten Eingaben, Konfigurationsstände, Kommandos und erzeugten Artefakte für Review und Wiederholung dokumentieren.

Praxisarbeiten

• Analyse einer Cross-Toolchain und ihres Zieltuples.
• Untersuchung der drei Sysroot-Bereiche.
• Behebung eines pkg-config- oder Linkerfehlers.
• Integration einer vorbereiteten externen Toolchain.
• Erzeugung und Test eines kleinen SDK-Workflows.

Qualitätssicherung

Die Bearbeitung wird anhand eindeutiger Eingaben, nachvollziehbarer Konfigurationsänderungen, gezielter Builds, geprüfter Artefakte, dokumentierter Tests und eines sauberen Wiederholungsbuilds bewertet.