Estado de salida

En AmigaOS , MorphOS y AROS se definen cuatro niveles:

1. OK 0
2. ADVERTENCIA 5
3. ERROR 10
4. FALLO 20

Los scripts de shell suelen ejecutar comandos y capturar sus estados de salida.

Para los propósitos del intérprete de comandos, un comando que finaliza con un código de salida cero se considera exitoso. Un código de salida distinto de cero indica un fallo. Este esquema, aparentemente contraintuitivo, se utiliza para que exista una forma bien definida de indicar el éxito y diversas formas de indicar los distintos modos de fallo. Cuando un comando finaliza con una señal cuyo número es N, el intérprete de comandos establece la variable $?a un valor mayor que 128. La mayoría de los intérpretes de comandos utilizan 128+N , mientras que ksh93 utiliza 256+N .

Si no se encuentra un comando, el intérprete de comandos debe devolver un estado de 127. Si se encuentra un comando pero no es ejecutable, el estado de retorno debe ser 126. [ ^{2 ] Tenga} en cuenta que esto no se aplica a todos los intérpretes de comandos.

Si un comando falla debido a un error durante la expansión o la redirección, el estado de salida es mayor que cero.

Los lenguajes de programación C y C++ permiten que los programas que salen o regresan de la función principal indiquen éxito o fracaso devolviendo un entero, o devolviendo las macrosEXIT_SUCCESS y EXIT_FAILURE. En sistemas tipo Unix, estas son iguales a 0y 1respectivamente. ^{[ 3 ]} El programa AC también puede usar la exit()función especificando el estado entero o la macro de salida como primer parámetro, lo que detiene el programa.

El valor de retorno mainse pasa a la exitfunción, que para valores cero, EXIT_SUCCESSo EXIT_FAILUREpuede traducirlo a "una forma definida por la implementación" de terminación exitosa o terminación fallida .

Aparte de 0las macros EXIT_SUCCESSy EXIT_FAILURE, el estándar C no define el significado de los códigos de retorno. Las reglas para el uso de códigos de retorno varían en diferentes plataformas (consulte las secciones específicas de cada plataforma).

En C# , el Main()método normalmente no devuelve un tipo (su tipo es void, o si async, es System.Threading.Tasks.Task). Sin embargo, Main()puede indicar un tipo de retorno, de tipo int, que se devuelve al sistema operativo. Si el Main()método se declara async, entonces en su lugar devuelve . ^{[ 4 ]}System.Threading.Tasks.Task<int>

En la terminología de DOS, un nivel de error es un código de salida entero devuelto por un programa ejecutable o subrutina . Los niveles de error suelen ir de 0 a 255. ^{[ 5 ] [ 6 ] [ 7 ] [ 8 ]} En DOS solo hay 256 códigos de error disponibles, pero DR DOS 6.0 y versiones posteriores admiten códigos de error de 16 bits al menos en CONFIG.SYS . ^{[ 7 ]} Con 4DOS y DR-DOS COMMAND.COM , los códigos de salida (en trabajos por lotes) se pueden establecer mediante EXIT n ^{[ 7 ]} y (en CONFIG.SYS ) mediante ERROR= n . ^{[ 7 ]}

Los estados de salida suelen ser capturados por programas por lotes mediante comandos IF ERRORLEVEL . ^{[ 5 ] [ 7 ]} Multiuser DOS admite una variable de entorno reservada %ERRORLVL% que se actualiza automáticamente al regresar de las aplicaciones. COMMAND.COM en DR-DOS 7.02 y versiones posteriores admite una variable de entorno pseudo- similar %ERRORLVL% así como %ERRORLEVEL% . En CONFIG.SYS , DR DOS 6.0 y versiones posteriores admiten ONERROR para probar el estado de carga y el código de retorno de los controladores de dispositivos y el código de salida de los programas. ^{[ 7 ]} 

En Java , el main()no indica un código de salida, por lo que, si es necesario, se especifica manualmente un código de salida a través de java.lang.System::exit(), lo que finaliza el programa y la JVM. Cualquier método puede llamar a System.exit(), a menos que un administrador de seguridad no lo permita. El argumento sirve como código de estado; por convención, un código de estado distinto de cero indica una terminación anormal. ^{[ 9 ]}

En OpenVMS , el éxito se indica con valores impares y el fracaso con valores pares. El valor es un entero de 32 bits con subcampos: bits de control, número de instalación, número de mensaje y gravedad. Los valores de gravedad se dividen entre éxito (Éxito, Informativo) y fracaso (Advertencia, Error, Fatal). ^{[ 10 ]}

En C de Plan 9, el estado de salida se indica mediante una cadena que se pasa a la función exits() , y la función main() es de tipo void .

En Unix y otros sistemas compatibles con POSIX , el proceso padre puede recuperar el estado de salida de un proceso hijo utilizando la wait()familia de llamadas al sistema definidas en el encabezado POSIX<wait.h> . ^{[ 11 ]} De estas, la llamada waitid()^{[ 12 ]} recupera el estado de salida completo, pero las llamadas más antiguas wait()y waitpid()^{[ 13 ]} recuperan solo los 8 bits menos significativos del estado de salida.

Las wait()interfaces waitpid()establecen un valor de estado de tipo intempaquetado como un campo de bits con varios tipos de información de terminación del hijo. Si el hijo terminó al salir (según lo determine la WIFEXITED()macro; la alternativa habitual es que murió por una señal no capturada ), SUS especifica que los 8 bits de orden inferior del estado de salida se pueden recuperar del valor de estado usando la WEXITSTATUS()macro.

En la waitid()llamada al sistema (añadida con SUSv1), el estado de salida del hijo y otra información ya no están en un campo de bits sino en la estructura de tipo siginfo_t. ^{[ 14 ]}

Los sistemas compatibles con POSIX suelen usar la convención de cero para éxito y distinto de cero para error. ^{[ 15 ]} Se han desarrollado algunas convenciones sobre los significados relativos de varios códigos de error; por ejemplo, GNU recomienda que los códigos con el bit más significativo activado se reserven para errores graves. ^{[ 3 ]}

Los sistemas operativos derivados de BSD han definido un extenso conjunto de interpretaciones preferidas: los significados para 15 códigos de estado del 64 al 78 están definidos en el encabezado POSIX <sysexits.h>. ^{[ 16 ]} Históricamente, estos se derivan de sendmail y otros agentes de transferencia de mensajes , pero desde entonces se han utilizado en muchos otros programas. ^{[ 17 ]} Se ha descontinuado y se desaconseja su uso. ^{[ 16 ]}

La Guía avanzada de scripting de Bash contiene información sobre el significado de los códigos de estado de salida distintos de 0. ^{[ 18 ]}

En Rust , main()puede devolver cualquier tipo que implemente el rasgo std::process::Termination. ^{[ 19 ]}

Internamente, en el entorno de ejecución de Rust, estos valores se devolverán libc::EXIT_SUCCESStanto en caso de ejecución exitosa como libc::EXIT_FAILUREen caso de fallo.

En la biblioteca estándar de Rust, los siguientes tipos tienen implementaciones para std::process::Termination:

• !(el tipo nunca )
• ()(el tipo de unidad )
• std::convert::Infalliable
• std::process::ExitCode(con constantes SUCCESSy FAIL)
• std::result::Result<T, E>

^{[ 20 ]}

Microsoft Windows utiliza enteros sin signo de 32 bits como códigos de salida, ^{[ 21 ] [ 22 ]} aunque el intérprete de comandos los trata como si tuvieran signo. ^{[ 23 ]}

Los códigos de salida se referencian directamente, por ejemplo, mediante el intérprete de línea de comandos CMD.exe, utilizando la errorlevelterminología heredada de DOS . Los procesos de .NET Framework y Windows PowerShell se refieren a ellos como la ExitCodepropiedad del Processobjeto.