Understanding exit codes on Linux

Exit codes on the Linux command line are numeric values that provide feedback on whether the command just run was successful or ran into some variety of problem. If you’ve never noticed them, don’t be surprised. The more obvious error messages like “command not found” will generally tell you all you need to know when something goes wrong, but the stealthy exit codes have a distinct advantage. For one thing, they can be checked in scripts to note errors that might be encountered (more on this below).

To get started, sit down at your Linux system and open a terminal window. Then type “pwd”. You should be rewarded by a quick display of your current location in the file system – undoubtedly your home directory. Before you do anything else, however, type “echo $?”. The system should result in the display of a zero (0). Yes, that’s the exit code and it’s meant to indicate that the pwd command you just used ran without any errors. An exit code of 0 always indicates that no problems were encountered.

Any exit code other than 0, on the other hand, indicates that some problem occurred. What problem depends on the command that was run. Executables don’t always use the same code for the same problem. The numeric range for exit codes is 0-255, so any code from 1-255 means something went wrong. Here’s a list of some of the exit codes that you might run into from time to time.

Code	Description
0	success
1	generic error
2	syntax error
126	permissions issue -- the requested command (file) can't be executed
	(but was found)
127	command (file) not found
128	fatal error, amount above 128 is signal number
128 + N	the shell was terminated by the signal N (also used like this by 
	various other programs)
130	process terminated by SIGINT (^c on keyboard)
137	process terminated by SIGKILL
143	process terminated by SIGTERM
255	wrong argument to the exit builtin (see code 128)

Now let’s run some tests and see how this works.

First, we’ll try to display a file that doesn’t exist – leading to an exit code of 1.

$ cat noSuchFile
cat: noSuchFile: No such file or directory
$ echo $?
1

Next, we’ll try to list the same nonexistent file.