.nh
.TH runc-ps "8"

.SH NAME
.PP
\fBrunc-ps\fP - display the processes inside a container


.SH SYNOPSIS
.PP
\fBrunc ps\fP [\fIoption\fP ...] \fIcontainer-id\fP [\fIps-option\fP ...]


.SH DESCRIPTION
.PP
The command \fBps\fP is a wrapper around the stock \fBps\fP(1) utility,
which filters its output to only contain processes belonging to a specified
\fIcontainer-id\fP\&. Therefore, the PIDs shown are the host PIDs.

.PP
Any \fBps\fP(1) options can be used, but some might break the filtering.
In particular, if PID column is not available, an error is returned,
and if there are columns with values containing spaces before the PID
column, the result is undefined.


.SH OPTIONS
.TP
\fB--format\fP|\fB-f\fP \fBtable\fP|\fBjson\fP
Output format. Default is \fBtable\fP\&. The \fBjson\fP format shows a mere array
of PIDs belonging to a container; if used, all \fBps\fP options are gnored.


.SH SEE ALSO
.PP
\fBrunc-list\fP(8),
\fBrunc\fP(8).