01. Exit Statuses

When a program finishes, it returns a integer value. This code is known as the exit status or exit code. Depending on its value, we can see if the program terminated successfully or not.

If the value is 0, that means the program ran without a problem (this is why you return 0 in C programs). However, any value of 1 or greater means that it terminated unsuccessfully.

So...what do exit statuses have to do with control flow? Great question! We'll how all this ties in together real soon when we learn if-else statements.

Last exit status $?

To find the last exit status, simply use the $? variable.

Be cautious in that if you run echo $? twice in a row, the second command will always return a 0. Can you guess why?

Let's try some examples.

$ rm /; echo $?
rm: /: is a directory
$ ls -l; echo $?
# Lists folder contents
$ echo $?
# Running 'echo $?' twice always produces a success

POSIX exit statueses

Here is a list of POSIX exit statuses.

> 0
Failure due to redirection or word expansion.
Unsuccessful (for the most part, but depends on command).
File not executable.
Command not found.
Unspecified, but failure.
Command failed due to receiving a signal.
$ ls -l hello_world
# Not executable
-rw-r--r--  1 johnPC  staff  0 Jul  3 09:41 hello_world
$ ./hello_world
-bash: ./hello_world: Permission denied
$ echo $?
$ asdf
$ echo $?

Passing an exit value per script

To terminate your script with a specific exit code, use the exit code, followed by an integer.

if [ ! -e $SAMP_FILE ]; then
    exit 32

We'll learn if statements real soon, but this snippet simply checks if the file does not exist.

Exceptions to the 0 successful rule

In some cases, a program can exit with a value other than 0, and still be considered a successful run.

For example, the grep command returns a 0 if a matching pattern is found, and a 1 if no matching pattern is found. A value of 2 or greater is reported for real errors.

To ensure of no bugs in your code, make sure to check out a command's EXIT VALUE or DIAGNOSTICS section of its man page!

Take your Linux skills to the next level!

The Linux Command Line

Take your Linux skills to the next level! Try Linux & UNIX

The Linux Command Line takes you from your very first terminal keystrokes to writing full programs in Bash, the most popular Linux shell. Along the way you'll learn the timeless skills handed down by generations of gray-bearded, mouse-shunning gurus: file navigation, environment configuration, command chaining, pattern matching with regular expressions, and more.

$ Check price
39.9539.95Amazon 4.5 logo(274+ reviews)

More Linux & UNIX resources

Aching back from coding all day?

Inversion Therapy Table

Aching back from coding all day? Try Back Problems

Stretch out your back and relieve your back muscles with inversion therapy. This device counteracts the forces of gravity on the body by decompressing and elongating the spine. By using this product just ten minutes a day, you can be well on your way to improved circulation and posture while relieving muscle aches, back pain and stress.

$$ Check price
119.98119.98Amazon 4.5 logo(1,700+ reviews)

More Back Problems resources