Protokolle von kdesrc-buildBeim Protokollieren schreibt kdesrc-build die Ausgabe jedes Befehls bei der Ausführung in eine Datei. So können bei einem Fehler die Protokolle nach der möglichen Ursache durchsucht werden.
Protokolle werden immer in einem eigenen Ordner gespeichert. Dieser Ordner wird mit der Option log-dir angegeben, die Voreinstellung dafür ist ${source-dir}/log. Dabei wird ${source-dir} durch den Wert der Option source-dir ersetzt. Im weiteren Text wird für diesen Wert ${log-dir} benutzt.
Der Ordner ${log-dir} hat weitere Unterordner, einen für jeden Ausführungszeitpunkt von kdesrc-build. Jeder Ordner wird mit dem Datum und einer fortlaufenden Zahl benannt. Wird kdesrc-build zum Beispiel am 26. Mai 2004 zum zweiten mal ausgeführt, lautet der Name des Ordners 2004-05-26-02.
Für einen leichteren Zugriff erstellt kdesrc-build eine Verknüpfung zu den Protokollen der letzten Ausführung mit dem Namen latest. Daher sind die aktuellen Protokolle immer unter ${log-dir}/latest zu finden.
Der Protokollordner für jede Ausführung von kdesrc-build enthält Unterordner, einen für jedes Modul, das erstellt wurde. Zusätzlich wird die Datei build-status angelegt, in der aufgeführt ist, welche Module erstellt bzw. nicht erstellt werden konnten.
Anmerkung
Wenn ein Modul weitere Untermodule enthält, wie zum Beispiel extragear/multimedia, playground/utils oder KDE/kdelibs, dann wird dieses Ordnerlayout auch für die Protokollordner verwendet. Das Protokoll für die letzte Ausführung von kdesrc-build für das Modul KDE/kdelibs finden Sie in ${log-dir}/latest/KDE/kdelibs, nicht in ${log-dir}/latest/kdelibs.
Im Protokollordner eines Moduls werden Dateien für jede Operation angelegt, die kdesrc-build ausführt. Aktualisiert kdesrc-build ein Modul, werden Dateien wie svn-co.log - wenn ein Modul das erste Mal heruntergeladen wird - oder svn-up.log - wenn das Modul aktualisiert wird - erstellt. Wird der Befehl configure ausgeführt, so wird das in der Datei configure.log protokolliert.
Ist ein Fehler aufgetreten, finden Sie eine Erklärung der Ursache in einer dieser Dateien. kdesrc-build erstellt eine Verknüpfung von der Datei mit dem Fehlerprotokoll wie zum Beispiel build-1.log zu der Datei error.log.
Um zu sehen, warum ein Modul bei der letzten Ausführung von kdesrc-build nicht erstellt werden konnte, sollten Sie daher als erstes die Datei ${log-dir}/latest/ begutachten. module-name/error.log
Tipp
Wenn die Datei error.log leer ist, insbesondere nach einer Installation, dann ist wahrscheinlich kein Fehler aufgetreten. Einige Programme im KDE-Erstellungssystem melden manchmal fälschlicherweise einen Fehler.
Außerdem können manche Befehle die Ausgabeumleitung von kdesrc-build unter bestimmten Umständen umgehen, normalerweise beim ersten Herunterladen aus dem Subversion-Archiv. Die Fehlerausgabe wird in diesem Fall nicht in die Protokolldatei geschrieben, sondern erscheint auf der Konsole oder im Terminal, in dem kdesrc-build ausgeführt wird.