Exit Codes - Revision history

Leo at 22:36, 18 August 2023

2023-08-18T22:36:06Z

← Older revision		Revision as of 22:36, 18 August 2023
Line 1:		Line 1:
	~~Here~~ are ~~some common exit codes~~ that ~~may be~~ returned by a program or ~~script~~.		Exit codes are numbers that are returned by a program when it exits.

			== Understanding exit codes ==
			Exit codes are used to determine whether a program completed successfully or encountered an issue. Depending on the operating system you're using (Linux, BSD, or Windows), you'll likely encounter different exit code conventions.

			This page will try to cover most common exit codes to help you troubleshoot.

			== Common exit codes ==
	{\| class="wikitable"		{\| class="wikitable"
	!Exit Code		!Exit Code
Line 17:		Line 24:
	\|-		\|-
	\|64-78		\|64-78
	\|BSD exit codes. See section below.		\|BSD exit codes. See the BSD section below.
	\|-		\|-
	\|124		\|124
Line 60:		Line 67:
	\|-		\|-
	\|200-243		\|200-243
	\|Are you working with systemd? See section below.		\|Are you working with systemd? See the systemd section below.
	\|-		\|-
	\|255		\|255
Line 70:		Line 77:
	\|}		\|}

	==~~Parsing high~~ exit ~~code values~~==		== High value exit codes (>256) ==
	At least on Linux (and whatever is reported by Slurm), the exit code that's stored is an 2 byte value which can be parsed as:		At least on Linux (and whatever is reported by Slurm), the exit code that's stored is an 2 byte value which can be parsed as:
	{\| class="wikitable"		{\| class="wikitable"
Line 87:		Line 94:
	For example, the exit code 32512 has an exit code of 127 (command not found).		For example, the exit code 32512 has an exit code of 127 (command not found).

	==Systemd exit codes==		==Systemd exit codes (200-243)==
	See the systemd documentation: https://www.freedesktop.org/software/systemd/man/systemd.exec.html		See the systemd documentation: https://www.freedesktop.org/software/systemd/man/systemd.exec.html
	{\| class="wikitable"		{\| class="wikitable"
Line 263:		Line 270:
	\|}		\|}

	==~~'''~~BSD exit codes~~'''~~==		==BSD exit codes (64-78)==
	{\| class="wikitable"		{\| class="wikitable"
	!Exit Code		!Exit Code
Line 330:		Line 337:
	\|}		\|}

	==See ~~Also~~==		==See also==

	*https://tldp.org/LDP/abs/html/exitcodes.html		*https://tldp.org/LDP/abs/html/exitcodes.html

Leo: Added categories and navbox

2021-12-30T00:48:59Z

Added categories and navbox

← Older revision		Revision as of 00:48, 30 December 2021
Line 335:		Line 335:
	*Coreutils / Timeout: <nowiki>https://www.gnu.org/software/coreutils/manual/html_node/timeout-invocation.html</nowiki>		*Coreutils / Timeout: <nowiki>https://www.gnu.org/software/coreutils/manual/html_node/timeout-invocation.html</nowiki>
	*errno - error numbers used in Linux (<code>errno -ls</code>)		*errno - error numbers used in Linux (<code>errno -ls</code>)

			{{Navbox Linux}}
			[[Category:Linux]]

Leo at 01:12, 7 December 2021

2021-12-07T01:12:39Z

← Older revision		Revision as of 01:12, 7 December 2021
Line 263:		Line 263:
	\|}		\|}

	== '''BSD exit codes''' ==		=='''BSD exit codes'''==
	{\| class="wikitable"		{\| class="wikitable"
	!Exit Code		!Exit Code
Line 334:		Line 334:
	*https://tldp.org/LDP/abs/html/exitcodes.html		*https://tldp.org/LDP/abs/html/exitcodes.html
	*Coreutils / Timeout: <nowiki>https://www.gnu.org/software/coreutils/manual/html_node/timeout-invocation.html</nowiki>		*Coreutils / Timeout: <nowiki>https://www.gnu.org/software/coreutils/manual/html_node/timeout-invocation.html</nowiki>
			*errno - error numbers used in Linux (<code>errno -ls</code>)

Leo at 20:38, 23 November 2021

2021-11-23T20:38:39Z

Show changes

Leo at 20:37, 23 November 2021

2021-11-23T20:37:25Z

Show changes

Leo at 23:26, 28 April 2021

2021-04-28T23:26:18Z

← Older revision		Revision as of 23:26, 28 April 2021
Line 8:		Line 8:
	\|-		\|-
	\|1		\|1
	\|General Error		\|General Error, typical catch-all value
	\|-		\|-
	\|2		\|2
	\|Misuse of shell builtins, keywords, or functions		\|Misuse of shell builtins, keywords, or functions
			\|-
			\|6
			\|No such device or address. Eg. curl on an invalid host.
			\|-
			\|124
			\|Command timed out (coreutils/timeout)
			\|-
			\|125
			\|Command failure (coreutils/timeout)
	\|-		\|-
	\|126		\|126
	\|~~Cannot Execute~~		\|Command found, but cannot be executed
	\|-		\|-
	\|127		\|127
	\|Command ~~Not Found~~. ~~Path~~ or typo issue.		\|Command not found. Possible path or typo issue.
			\|-
			\|128
			\|Invalid argument to exit. Eg. <code>exit 1.1</code> would result in 128.
	\|-		\|-
	\|128+n		\|128+n
Line 24:		Line 36:
	\|-		\|-
	\|130		\|130
	\|Program Interrupted (SIGINT, 2), such as termination from Ctrl-C		\|Program Interrupted (SIGINT, 128+2), such as termination from Ctrl-C
	\|-		\|-
	\|134		\|134
	\|Program Abort (SIGABRT, 6)		\|Program Abort (SIGABRT, 128+6)
	\|-		\|-
	\|136		\|136
	\|Erroneous Arithmetic Operation (SIGFPE, 8), such as division by zero		\|Erroneous Arithmetic Operation (SIGFPE, 128+8), such as division by zero
			\|-
			\|137
			\|Killed. (SIGKILL, 128+9)
	\|-		\|-
	\|139		\|139
Line 45:		Line 60:
	\|-		\|-
	\|256+		\|256+
	\|All higher exit codes should be reduced down to the 0-255 range. More information below.		\|All higher exit codes should be reduced down to the 0-255 range. More information below. You typically either modulo the code by 256 or take the high 8-bit values.
	Eg. Code 3809 % 256 results in 225		Eg. Code <code>3809 % 256</code> results in 225, or code <code>32512 & 0xff00 >> 8</code> results in 127.
	\|}		\|}

	== Parsing high exit code values ==		==Parsing high exit code values==
	At least on Linux (and whatever is reported by Slurm), the exit code that's stored is an 2 byte value which can be parsed as:		At least on Linux (and whatever is reported by Slurm), the exit code that's stored is an 2 byte value which can be parsed as:
	{\| class="wikitable"		{\| class="wikitable"
Line 69:		Line 84:

	*https://tldp.org/LDP/abs/html/exitcodes.html		*https://tldp.org/LDP/abs/html/exitcodes.html
			*Coreutils / Timeout: <nowiki>https://www.gnu.org/software/coreutils/manual/html_node/timeout-invocation.html</nowiki>

Leo at 23:09, 28 April 2021

2021-04-28T23:09:04Z

← Older revision		Revision as of 23:09, 28 April 2021
Line 45:		Line 45:
	\|-		\|-
	\|256+		\|256+
	\|All higher exit codes should be reduced down to the 0-255 range ~~via the modulo operator~~.		\|All higher exit codes should be reduced down to the 0-255 range. More information below.
	Eg. Code 3809 % 256 results in 225		Eg. Code 3809 % 256 results in 225
	\|}		\|}

			== Parsing high exit code values ==
			At least on Linux (and whatever is reported by Slurm), the exit code that's stored is an 2 byte value which can be parsed as:
			{\| class="wikitable"
			!Bits
			!Description
			\|-
			\|high 8 bits
			\|The actual exit code
			\|-
			\|7 bit
			\|if a core dump was produced
			\|-
			\|lower 7 bits
			\|signal number that killed the process
			\|}
			For example, the exit code 32512 has an exit code of 127 (command not found).

	==See Also==		==See Also==

	*https://tldp.org/LDP/abs/html/exitcodes.html		*https://tldp.org/LDP/abs/html/exitcodes.html

Leo at 18:26, 27 April 2021

2021-04-27T18:26:43Z

← Older revision		Revision as of 18:26, 27 April 2021
Line 36:		Line 36:
	\|-		\|-
	\|160+n		\|160+n
	\|The largest signal value is 31.		\|The largest signal value is 31. As a result, all values after 128+31 can be interpreted as negative return codes by treating the value as a 1 byte integer.
	As a result, all values after 128+31 can be interpreted as negative return codes.		For example, 255 = -1, 254 = -2, 240 = -16, 225 = -31, and so forth

	~~Eg. 255 = -1, 254 = -2, 240 = -16, 225 = -31, and so forth~~		A simple way to 'convert' it is to just subtract the value from 256.

	~~Simple~~ way to 'convert' it is to just subtract the value from 256.
	\|-		\|-
	\|255		\|255

Leo at 18:25, 27 April 2021

2021-04-27T18:25:09Z

← Older revision		Revision as of 18:25, 27 April 2021
Line 34:		Line 34:
	\|139		\|139
	\|Segmentation Fault (SIGSEGV, 11)		\|Segmentation Fault (SIGSEGV, 11)
			\|-
			\|160+n
			\|The largest signal value is 31.
			As a result, all values after 128+31 can be interpreted as negative return codes.

			Eg. 255 = -1, 254 = -2, 240 = -16, 225 = -31, and so forth

			Simple way to 'convert' it is to just subtract the value from 256.
	\|-		\|-
	\|255		\|255

Leo at 18:11, 27 April 2021

2021-04-27T18:11:15Z

← Older revision		Revision as of 18:11, 27 April 2021
Line 9:		Line 9:
	\|1		\|1
	\|General Error		\|General Error
			\|-
			\|2
			\|Misuse of shell builtins, keywords, or functions
	\|-		\|-
	\|126		\|126
Line 14:		Line 17:
	\|-		\|-
	\|127		\|127
	\|Command Not Found		\|Command Not Found. Path or typo issue.
	\|-		\|-
	\|128+n		\|128+n
Line 33:		Line 36:
	\|-		\|-
	\|255		\|255
	\|~~maximum~~ exit code. exit 3809 results in 225 ~~(3809 % 256)~~		\|Maximum exit code value. Obtained when the program calls <code>exit -1</code>.
			\|-
			\|256+
			\|All higher exit codes should be reduced down to the 0-255 range via the modulo operator.
			Eg. Code 3809 % 256 results in 225
	\|}		\|}

	== See Also ==		==See Also==

	* https://tldp.org/LDP/abs/html/exitcodes.html		*https://tldp.org/LDP/abs/html/exitcodes.html