Skip to main content

Códigos de salida

Los códigos de salida indican el estado de un comando después de que la CodeQL CLI lo ejecute.

¿Quién puede utilizar esta característica?

CodeQL está disponible para los siguientes tipos de repositorios:

Acerca de los códigos de salida

La CodeQL CLI informa del estado de cada comando que ejecuta con un código de salida. Este código de salida proporciona información para los siguientes comandos o para otras herramientas que dependen de la CodeQL CLI.

0

Correcto, finalización normal.

1

El comando determinó correctamente que la respuesta a la pregunta es "no".

Este código de salida solo lo usan algunos comandos, como "test run", "dataset check", "query format" y "resolve extractor". Para obtener más información, consulta la documentación de dichos comandos.

2

Ha habido algún error.

La CLI escribe un mensaje de error legible para el usuario en stderr. Esto incluye los casos en los que se produce un error interno en un extractor, ya que el controlador codeql no puede distinguir entre los errores internos y a los que se enfrenta el usuario en el comportamiento del extractor.

3

El iniciador no ha podido encontrar el directorio de instalación de CodeQL.

En este caso, el iniciador no puede iniciar el código Java para la CodeQL CLI. Esto solo debería ocurrir cuando hay un problema grave con la instalación de CodeQL.

32

El extractor no encontró ningún código para analizar al ejecutar "database create" o "finalización de la base de datos".

33

Se ha agotado el tiempo de espera de una o varias evaluaciones de consultas.

Es posible que no se haya agotado en tiempo de espera para algunas consultas evaluadas en paralelo. Los resultados de esas consultas se generan como de costumbre.

98

La evaluación se ha cancelado explícitamente.

99

La CodeQL CLI se ha quedado sin memoria.

Esto no significa necesariamente que se haya usado toda la RAM física de la máquina. Si no usas la opción --ram para establecer un límite explícitamente, la JVM decide un límite predeterminado al inicio.

100

Se ha producido un error interno grave.

Esto debe considerarse un error. Normalmente, la CLI escribe una descripción breve del error en stderr. Si puedes reproducir el error, resulta útil usar --logdir y enviar los archivos de registro a GitHub en un informe de errores.

Otros

En el caso de producirse problemas realmente graves dentro de la JVM que ejecuta codeql, podría devolverse un código de salida distinto de cero elegido por la propia máquina. Esto solo debería ocurrir si hay un problema realmente grave con la instalación de CodeQL o si hay un problema de memoria con el sistema del host que ejecuta el proceso de CodeQL. Por ejemplo, los sistemas Unix pueden devolver el código de salida 137 para indicar que el kernel ha terminado un proceso iniciado por CodeQL. Una manera de solucionar este problema es modificar la marca –ram= para el paso codeql database analyze y volver a ejecutar el flujo de trabajo.