---
name: "lxc-ps"
section: "1"
platform: "linux"
package: "lxc"
version: "0.8.0~rc1-8+deb7u2"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://carta.tech/man/lxc-ps"
---

# lxc-ps(1)

list the processes belonging to a specific container.

## NAME

lxc-ps - list the processes belonging to a specific container.

## SYNOPSIS

**lxc-ps \[--name name\]** **\[--lxc\]** **\[ps option\]**

## DESCRIPTION

**lxc-ps** is a wrapper tp ps command to report the name of lxc container associated to reported processes.

The cgroup fs must be mounted before container creation, to be able to have **lxc-ps** to find the container associated to processes.

The additionnal specified ps options must not remove the default ps header and the pid information, to be able to have the **lxc-ps** to find the container associated to processes.

## OPTIONS

- *--name NAME*

  specify the container *NAME* to limit the output to the processes belonging  to this container name.

- *--lxc*

  limit the output to the processes belonging  to all lxc containers.

- **\[ps options\]**

  The **ps** options must be separated from **lxc-ps** options by the **--** parameter.

## EXAMPLE

- **lxc-ps --name foo -- --forest**

  list all the processes belonging to container 'foo' and show dependencies.

## SEE ALSO

[**ps**(1)](/man/ps/1.md),

## SEE ALSO

[**lxc**(1)](/man/lxc/1.md), [**lxc-create**(1)](/man/lxc-create/1.md), [**lxc-destroy**(1)](/man/lxc-destroy/1.md), [**lxc-start**(1)](/man/lxc-start/1.md), [**lxc-stop**(1)](/man/lxc-stop/1.md), [**lxc-execute**(1)](/man/lxc-execute/1.md), [**lxc-kill**(1)](/man/lxc-kill/1.md), [**lxc-console**(1)](/man/lxc-console/1.md), [**lxc-monitor**(1)](/man/lxc-monitor/1.md), [**lxc-wait**(1)](/man/lxc-wait/1.md), [**lxc-cgroup**(1)](/man/lxc-cgroup/1.md), [**lxc-ls**(1)](/man/lxc-ls/1.md), [**lxc-ps**(1)](/man/lxc-ps/1.md), [**lxc-info**(1)](/man/lxc-info/1.md), [**lxc-freeze**(1)](/man/lxc-freeze/1.md), [**lxc-unfreeze**(1)](/man/lxc-unfreeze/1.md), [**lxc-attach**(1)](/man/lxc-attach/1.md), [**lxc.conf**(5)](/man/lxc.conf/5.md)

## AUTHOR

Daniel Lezcano \<daniel.lezcano@free.fr\>