.nh
.TH runc-list "8"

.SH NAME
.PP
\fBrunc-list\fP - lists containers


.SH SYNOPSIS
.PP
\fBrunc list\fP [\fIoption\fP ...]


.SH DESCRIPTION
.PP
The \fBlist\fP commands lists containers. Note that a global \fB--root\fP
option can be specified to change the default root. For the description
of \fB--root\fP, see \fBrunc\fP(8).


.SH OPTIONS
.TP
\fB--format\fP|\fB-f\fP \fBtable\fP|\fBjson\fP
Specify the format. Default is \fBtable\fP\&. The \fBjson\fP format provides
more details.

.TP
\fB--quiet\fP|\fB-q\fP
Only display container IDs.


.SH EXAMPLES
.PP
To list containers created with the default root:

.PP
.RS

.nf
# runc list

.fi
.RE

.PP
To list containers in a human-readable JSON (with the help of \fBjq\fP(1)
utility):

.PP
.RS

.nf
# runc list -f json | jq

.fi
.RE

.PP
To list containers created with the root of \fB/tmp/myroot\fP:

.PP
.RS

.nf
# runc --root /tmp/myroot

.fi
.RE


.SH SEE ALSO
.PP
\fBrunc\fP(8).