2022-07-28 16:28:18 +08:00
|
|
|
% runc-list "8"
|
|
|
|
|
|
|
|
|
|
# NAME
|
2022-12-30 11:21:19 +08:00
|
|
|
**runc-list** - lists containers
|
2022-07-28 16:28:18 +08:00
|
|
|
|
|
|
|
|
# SYNOPSIS
|
2022-12-30 11:21:19 +08:00
|
|
|
**runc list** [_option_ ...]
|
2022-07-28 16:28:18 +08:00
|
|
|
|
2022-12-30 11:21:19 +08:00
|
|
|
# DESCRIPTION
|
2022-07-28 16:28:18 +08:00
|
|
|
|
2022-12-30 11:21:19 +08:00
|
|
|
The **list** commands lists containers. Note that a global **--root**
|
|
|
|
|
option can be specified to change the default root. For the description
|
|
|
|
|
of **--root**, see **runc**(8).
|
2022-07-28 16:28:18 +08:00
|
|
|
|
|
|
|
|
# OPTIONS
|
2022-12-30 11:21:19 +08:00
|
|
|
**--format**|**-f** **table**|**json**
|
|
|
|
|
: Specify the format. Default is **table**. The **json** format provides
|
|
|
|
|
more details.
|
|
|
|
|
|
|
|
|
|
**--quiet**|**-q**
|
|
|
|
|
: Only display container IDs.
|
|
|
|
|
|
|
|
|
|
# EXAMPLES
|
|
|
|
|
To list containers created with the default root:
|
|
|
|
|
|
|
|
|
|
# runc list
|
|
|
|
|
|
|
|
|
|
To list containers in a human-readable JSON (with the help of **jq**(1)
|
|
|
|
|
utility):
|
|
|
|
|
|
|
|
|
|
# runc list -f json | jq
|
|
|
|
|
|
|
|
|
|
To list containers created with the root of **/tmp/myroot**:
|
|
|
|
|
|
|
|
|
|
# runc --root /tmp/myroot
|
|
|
|
|
|
|
|
|
|
# SEE ALSO
|
|
|
|
|
|
|
|
|
|
**runc**(8).
|
