---
name: "lxc-ps"
section: "1"
platform: "linux"
package: "lxc"
version: "0.8.0~rc1-8+deb7u2"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://new.carta.tech/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)](/ps/1.md),

## SEE ALSO

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

## AUTHOR

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