<a id="hook-command-relation-list"></a>

# `relation-list`

## Summary

Lists relation units.

## Usage

`relation-list [options]`

### Options

| Flag               | Default   | Usage                                                    |
|--------------------|-----------|----------------------------------------------------------|
| `--app`            | false     | Lists remote application instead of participating units. |
| `--format`         | smart     | Specify output format (json|smart|yaml)                  |
| `-o`, `--output`   |           | Specify an output file                                   |
| `-r`, `--relation` |           | Specifies a relation by ID.                              |

## Details

`-r` must be specified when not in a relation hook

`relation-list` outputs a list of all the related units for a relation identifier.
If not running in a relation hook context, `-r` needs to be specified with a
relation identifier similar to the `relation-get` and `relation-set` commands.