NetBSD Dokumentation: Cross-building NetBSD

Frequently Asked Questions

• Fachausdrücke in diesem Dokument
• Wann wird ein Cross Build benötigt?

Schritt für Schritt

• Auswahl des Host Systems
• Vorbereitung der Build Hierarchie
• Erstellung der Cross-Compiler Toolchain
• Die eigenliche Cross-Kompilation des Kernel
• Die eigentlich Cross-Kompilation des Userlands

Häufige Probleme

• ``Compiler died with internal error'' oder ähnliche Fehlermeldung

Weitere Informationen

• Tracking NetBSD-current (englisch)
• Allgemeine Anleitungen und FAQs über NetBSD - nicht cross-building spezifisch
• ``Cross-building NetBSD'' - Luke Mewburn und Matthew Green's Präsentation ihrer Veröffentlichung zur BSDCon 2003

Frequently Asked Questions

Fachausdrücke in diesem Dokument (zurück)

• Host System: das System auf welchem der Cross-Build erfolgt.
• Target System: das System für welches der Cross-Build erfolgt; das System, auf welchem die kompilierten Binärdateien installiert werden.
• Cross Build: Host System und Target System sind unterschiedlich.
• Self Build: Host System und Target System sind identisch.

Zum Beispiel: Wenn Sie unter NetBSD/i386 Binärdateien für NetBSD/sh3 erstellen, ist dies ein Cross Build: NetBSD/i386 ist das "Host System", und NetBSD/sh3 ist das "Target System".

Wann wird ein Cross Build benötigt? (zurück)

• NetBSD unterstützt eine Vielzahl von Architekturen. Einige darunter sind nicht so leistungsstark wie andere. Daher ist ein Cross Build eine gute Lösung, wenn Sie häufig für ältere Architekturen kompilieren.
• Wenn das Target System ein embedded Produkt ist (wie z.B. ein Handy), auf welches Sie NetBSD portieren wollen, kann es sein, dass dieses nicht genug Speicher-, Festplatten- oder Arbeitspeicherplatz hat, um darauf selbst zu kompilieren.
• Wenn Sie NetBSD Binärdateien auf einem nicht-NetBSD Host System erstellen wollen, so müssen Sie dies durch einen Cross Build tun.
• Wenn Sie NetBSD auf eine neue Plattform übertragen wollen, ist (zumindest anfangs) ein Cross Build häufig Ihre einzige Chance.

Schritt für Schritt

Auswahl des Host Systems (zurück)

Sofern Sie keine besonderen Gründe dagegen haben, so schlagen wir vor, NetBSD (wenn möglich den letzten Release oder NetBSD-current) als Host System zu nutzen. Andere Plattformen sind zwar auch unterstützt, werden jedoch weniger häufig getestet. Einige mehr oder weniger aktuelle Hinweise für andere Plattformen finden Sie in src/tools/compat/README .

Vorbereitung der Build Hierarchie (zurück)

Zuerst benötigen Sie natürlich die NetBSD Quellen. Sehen Sie hierzu: Tracking NetBSD-current (englisch). Im Folgenden nehmen wir an, dass sich die Sources unter $TOP/src befinden.

Erstellung der Cross-Compiler Toolchain (zurück)

Um die notwendigen Tools für ein macppc Target System im Verzeichnis /usr/cross/{bin,include,lib,libexec,...} zu erstellen, führen Sie diesen Befehl aus:

	% cd $TOP/src
	% ./build.sh -m macppc -T /usr/cross tools

Für weitere Optionen und allgemeine Hilfe, sehen Sie

./build.sh -h

Die eigenliche Cross-Kompilation des Kernel (zurück)

Nun nutzen Sie die neu erstellten Tools um den Kernel zu kompilieren. Da NetBSDs config(8) Plattform-unabhängig ist, können Sie dies von dem Host System aus tun. (Beachten Sie jedoch, dass config(8) Versions-abhängig ist; Sie können also mit einem -current config keinen 1.6 Kernel erstellen, weshalb die nbconfig Binärdatei aus dem Cross-Verzeichnis genutzt wird.)

% cd $TOP/src/sys/arch/macppc/conf
% cp GENERIC MYCONF
% vi MYCONF

Um nun den Kernel per Hand zu cross-kompilieren, geben Sie die folgenden Befehle ein:

% /usr/cross/bin/nbconfig MYCONF
% cd ../compile/MYCONF
% /usr/cross/bin/nbmake-macppc depend
% /usr/cross/bin/nbmake-macppc 

Oder Sie lassen ./build.sh Ihnen die Arbeit abnehmen:

% cd $TOP/src
% ./build.sh kernel=MYCONF

Die eigentlich Cross-Kompilation des Userlands (zurück)

Auch hier können Sie das ./build.sh Script nutzen, um das gesamte Userland wie unter Tracking NetBSD-current beschrieben zu erstellen:

# cd $TOP/src
# ./build.sh -D $DESTDIR -d

Häufige Probleme

``Compiler died with internal error'' oder ähnliche Fehlermeldung (zurück)

In einem Cross Build ist es oft schwieriger, den Compiler korrekt zu konfigurieren. Bugs im Compiler tauchen wesentlich häufiger auf. Des Weiteren ist es notwendig, einen anderen Compiler zu benutzen, als unter normalen Umständen; Probleme in der Kompatibilität zwischen verschiedenen Compiler Versionen (z.B. verschiedene Versionen von GCC oder zu einem Compiler eines anderen Anbieters) können uns hier Kopfschmerzen bereiten.

Ohne den richtigen Prä-Prozessor (cpp(1)), geraten Sie leicht in Schwierigkeiten mit vor-definierten Symbolen, wie z.B. __NO_LEADING_UNDERSCORES__ oder __LITTLE_ENDIAN__.

Natürlich müssen wir unsere Cross Builds weiter stabilisieren.

Leider gibt es keine allgemeine Lösung für solche Fehler. Doch die folgenden Hinweise können helfen:

• Überprüfen Sie noch einmal das Compiler Script. Wenn Sie verschiedene Compiler für verschiedene Targets nutzen, gibt es Probleme (z.B. wenn Sie /usr/bin/as während eines Cross Builds nutzen).
• Verringern Sie den Optimierungs-Level (z.B. von -O2 auf -O); ändern Sie Compiler Konfigurationsparameter zur Laufzeit.
• Überprüfen Sie die Compiler Konfigurationsparameter zum Zeitpunkt der Cross-Compiler Generation.
• Wenn Sie den Fehler wiederholen können und gcc nutzen, senden Sie einen Problem Report an die GCC Entwickler.

Home page

Zurück zu Dokumentation