wiki.bash-hackers.org/syntax/ccmd/if_clause.md

# The if-clause

## Synopsis

    if <LIST>; then
      <LIST>
    fi

    if <LIST>; then
      <LIST>
    else
      <LIST>
    fi

    if <LIST>; then
      <LIST>
    elif <LIST>; then
      <LIST>
    else
      <LIST>
    fi

## Description

The `if`-clause can control the script's flow (what's executed) by
looking at the exit codes of other commands.

All commandsets `<LIST>` are interpreted as [command
lists](/syntax/basicgrammar#lists), thus they can contain the whole
palette from [simple commands](/syntax/basicgrammar#simple_commands)
over [pipelines](/syntax/basicgrammar#pipelines) to [compound
commands](/syntax/basicgrammar#compound_commands) (and their
combination) as condition.

### Operation

The **`if <LIST>`** commands are executed. If the exit code was 0 (TRUE)
then the **`then <LIST>`** commands are executed, otherwise the
**`elif <LIST>`** commands and their **`then <LIST>`** statements are
executed in turn, if all down to the last one fails, the
**`else <LIST>`** commands are executed, if one of the `elif` succeeds,
its `then` thread is executed, and the `if`-clause finishes.

Basically, the `elif` clauses are just additional conditions to test
(like a chain of conditions) if the very first condition failed. If one
of the conditions fails, the `else` commands are executed, otherwise the
commands of the condition that succeeded.

## Examples

**Check if a specific user exists in /etc/passwd :-)**

    if grep ^myuser: /etc/passwd >/dev/null 2>&1; then
      echo &quot;Yes, it seems I'm real&quot;
    else
      echo &quot;Uh - am I a ghost?&quot;
    fi

**Mount with check**

    if ! mount /mnt/backup >/dev/null 2>&1; then
      echo &quot;FATAL: backup mount failed&quot; >&2
      exit 1
    fi

**Multiple commands as condition**

It's perfectly valid to do:

    if echo &quot;I'm testing!&quot;; [ -e /some/file ]; then
      ...
    fi

The exit code that dictates the condition's value is the exit code of
the very last command executed in the condition-list (here: The
`[ -e /some/file ]`)

**A complete pipe as condition**

A complete pipe can also be used as condition. It's very similar to the
example above (multiple commands):

    if echo &quot;Hello world!&quot; | grep -i hello >/dev/null 2>&1; then
      echo &quot;You just said 'hello', yeah?&quot;
    fi

## Portability considerations

## See also

- Internal: [the classic test command](/commands/classictest)