Skip to main content

Exitcodes

Exitcodes geben den Status eines Befehls an, nachdem er von der CodeQL CLI ausgeführt wurde.

Wer kann dieses Feature verwenden?

GitHub CodeQL wird nach der Installation auf Benutzerbasis lizenziert. Du kannst CodeQL nur für bestimmte Aufgaben unter den Lizenzeinschränkungen verwenden. Weitere Informationen findest du unter Informationen zur CodeQL-CLI.

Wenn du über eine GitHub Advanced Security-Lizenz verfügst, kannst du CodeQL für eine automatisierte Analyse sowie für Continuous Integration und Continuous Delivery verwenden. Weitere Informationen findest du unter Informationen zu GitHub Advanced Security.

Informationen zu Exitcodes

Die CodeQL CLI meldet den Status jedes ausgeführten Befehls als Exitcode. Dieser Exitcode stellt Informationen für nachfolgende Befehle oder andere Tools bereit, die auf der CodeQL CLI basieren.

0

Erfolg, normale Beendigung

1

Mit dem Befehl wurde festgestellt, dass die Antwort auf deine Frage „Nein“ lautet.

Dieser Exitcode wird nur von wenigen Befehlen wie test run, dataset check, query format und resolve extractor verwendet. Weitere Informationen findest du in der Dokumentation zu diesen Befehlen.

2

Es ist ein Problem aufgetreten.

Die CLI schreibt eine für Menschen lesbare Fehlermeldung in stderr. Dies schließt Fälle ein, in denen bei einem Extraktor ein interner Fehler auftritt, da der codeql-Treiber nicht zwischen internen und benutzerbezogenen Fehlern im Extraktorverhalten unterscheiden kann.

3

Das Startprogramm konnte das CodeQL-Installationsverzeichnis nicht finden.

In diesem Fall kann das Startprogramm den Java-Code für die CodeQL CLI überhaupt nicht starten. Dies sollte nur passieren, wenn bei der CodeQL-Installation ein schwerwiegender Fehler auftritt.

32

Der Extraktor hat keinen Code zum Ausführen von database create oder database finalize beim Analysieren gefunden.

33

Bei einer oder mehreren Abfrageauswertungen ist ein Timeout aufgetreten.

Eventuell ist bei einigen parallel ausgewerteten Abfragen kein Timeout aufgetreten. Die Ergebnisse für diese Abfragen werden wie gewohnt erstellt.

98

Die Auswertung wurde explizit abgebrochen.

99

Der CodeQL CLI steht kein Speicher mehr zur Verfügung.

Dies bedeutet nicht unbedingt, dass der gesamte physische RAM des Computers verwendet wurde. Wenn du mit der --ram-Option nicht explizit ein Limit festlegst, wird durch JVM beim Start ein Standardlimit festgelegt.

100

Ein schwerwiegender interner Fehler ist aufgetreten.

Dies sollte als Bug betrachtet werden. Die CLI schreibt normalerweise eine abgekürzte Fehlerbeschreibung in stderr. Wenn du den Fehler reproduzieren kannst, verwende --logdir, und sende die Protokolldateien in einem Fehlerbericht an GitHub.

Sonstiges

Bei sehr schwerwiegenden Problemen innerhalb der JVM-Instanz, auf der codeqlausgeführt wird, wird ein beliebiger Exitcode ungleich 0 zurückgegeben. Dies sollte nur passieren, wenn bei der CodeQL-Installation ein schwerwiegender Fehler oder bei dem Hostsystem, das den CodeQL-Prozess ausführt, ein Speicherproblem auftritt. Unix-Systeme können beispielsweise Exitcode 137 zurückgeben, um anzugeben, dass der Kernel einen von CodeQL gestarteten Prozess beendet hat. Eine Möglichkeit, dies zu beheben, besteht im Ändern deines –ram=-Flags für den Schritt codeql database analyze und dem nochmaligen Ausführen deines Workflows.