Todos sabemos que si un proceso termina con éxito en Linux siempre lo hace usando 0 como estado de salida. Mientras que en caso de error, dicho valor debe estar comprendido entre 1 y 255. Pero ¿existe algún estándar respecto del estado de salida que se debe utilizar en función de la causa del error?
Obviamente, esta no es una pregunta que a uno le venga alegremente a la cabeza. Ayer estaba corrigiendo prácticas y todas las “inspiradas” en la misma fuente tenían la costumbre de usar estados de salida curiosamente altos: 127, 128, etc. Así que obviamente a alguien se le ocurrió preguntarme ¿de verdad esto tiene que ser así? ¿Para terminar a causa de este error concreto tengo que utilizar exit(128) o puedo emplear cualquier otro valor?
Exit Status en el manual de GNU libc
El manual de la librería del sistema en Linux comenta que cualquier valor entre 0 y 255 es válido, con la salvedad de que:
Sin embargo, como algunos sistemas no POSIX puede usar una convención diferente, el manual recomienda utilizar las macros EXIT_SUCCESS —0 en los sistemas POSIX— y EXIT_FAILURE —1 en los sistemas POSIX—. También comenta que, por lo general, valores superiores a 127 se reservan para propósitos especiales, recomendando emplear el valor 128 para indicar un fallo en la ejecución de un programa en un subproceso.
Estados de salida de BASH
En el apéndice E de Advanced Bash Scripting Guide se publica una tabla que muestra el uso y significado de los estados de salida empleados por BASH:
1: Catchall for general errors
2: Misuse of shell builtins (according to Bash documentation)
126: Command invoked cannot execute
127: "command not found"
128: Invalid argument to exit (exit takes only integer args in
the range 0 - 255)
128+n: Fatal error signal "n"
255: Exit status out of range (exit takes only integer args in
the range 0 - 255)
Esta tabla puede ser útil para tener alguna idea acerca de los estados de salida adecuados para nuestros propios scripts de BASH y además nos puede servir de guía cuando programamos nuestras propias aplicaciones en otros lenguajes.
Archivo sysexits.h en C y C++
La comunidad ha intentado sistematizar el uso y la interpretación de los estados de salida cuando se desarrolla en C y C++, siendo muchos los programas que siguen esta recomendación, aunque nunca se haya estandarizado. Estos estados de salida recomendados, junto con su significado, están disponibles en el archivo /usr/include/sysexits.h.
#define EX_OK 0
#define EX__BASE 64
#define EX_USAGE 64
#define EX_DATAERR 65
#define EX_NOINPUT 66
#define EX_NOUSER 67
#define EX_NOHOST 68
#define EX_UNAVAILABLE 69
#define EX_SOFTWARE 70
#define EX_OSERR 71
#define EX_OSFILE 72
#define EX_CANTCREAT 73
#define EX_IOERR 74
#define EX_TEMPFAIL 75
#define EX_PROTOCOL 76
#define EX_NOPERM 77
#define EX_CONFIG 78
#define EX__MAX 78
Si la causa del error en nuestro programa encaja en alguna de las anteriores, podemos usar las macros definidas. En caso contrario, podemos utilizar los valores anteriores al 64 y posteriores al 78 para definir nuestros propios estados de salida.
