runc-ps(8)

runc-ps8

Display the processes inside a container

Usage

runc ps [option ...] container-id [ps-option ...]

Overview

The command ps is a wrapper around the stock ps(1) utility, which filters its output to only contain processes belonging to a specified container-id. Therefore, the PIDs shown are the host PIDs.

Any ps(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.

Options

--format|-f table|json

Output format. Default is table. The json format shows a mere array of PIDs belonging to a container; if used, all ps options are gnored.

Releases

5 releases since Debian 10 (Buster); the text changed 3 times.

  1. 10
  2. 11
  3. 12–13
  4. Arch

From runc 1.5.2-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.