github.com/opencontainers/runc@v1.2.0-rc.1.0.20240520010911-492dc558cdd6/man/runc-list.8.md (about)

     1  % runc-list "8"
     2  
     3  # NAME
     4  **runc-list** - lists containers
     5  
     6  # SYNOPSIS
     7  **runc list** [_option_ ...]
     8  
     9  # DESCRIPTION
    10  
    11  The **list** commands lists containers. Note that a global **--root**
    12  option can be specified to change the default root. For the description
    13  of **--root**, see **runc**(8).
    14  
    15  # OPTIONS
    16  **--format**|**-f** **table**|**json**
    17  : Specify the format. Default is **table**. The **json** format provides
    18  more details.
    19  
    20  **--quiet**|**-q**
    21  : Only display container IDs.
    22  
    23  # EXAMPLES
    24  To list containers created with the default root:
    25  
    26  	# runc list
    27  
    28  To list containers in a human-readable JSON (with the help of **jq**(1)
    29  utility):
    30  
    31  	# runc list -f json | jq
    32  
    33  To list containers created with the root of **/tmp/myroot**:
    34  
    35  	# runc --root /tmp/myroot
    36  
    37  # SEE ALSO
    38  
    39  **runc**(8).