summaryrefslogtreecommitdiff
path: root/docs/source/markdown/podman-ps.1.md
diff options
context:
space:
mode:
authorOpenShift Merge Robot <openshift-merge-robot@users.noreply.github.com>2020-09-09 12:15:46 -0400
committerGitHub <noreply@github.com>2020-09-09 12:15:46 -0400
commit49cb0edd651848d1e731b77412ed9d47a34fe0a7 (patch)
tree0ae031547c8fb6152f39e3e8339e25fbaf66e34f /docs/source/markdown/podman-ps.1.md
parent5a09fd8f2b8e624a8d4155fd4fc89f51e544e2ca (diff)
parent581afbb86f441c94c6dd49fe93dff935de7af340 (diff)
downloadpodman-49cb0edd651848d1e731b77412ed9d47a34fe0a7.tar.gz
podman-49cb0edd651848d1e731b77412ed9d47a34fe0a7.tar.bz2
podman-49cb0edd651848d1e731b77412ed9d47a34fe0a7.zip
Merge pull request #7290 from rhatdan/external
Show c/storage (Buildah/CRI-O) containers in ps
Diffstat (limited to 'docs/source/markdown/podman-ps.1.md')
-rw-r--r--docs/source/markdown/podman-ps.1.md19
1 files changed, 17 insertions, 2 deletions
diff --git a/docs/source/markdown/podman-ps.1.md b/docs/source/markdown/podman-ps.1.md
index 2f8112aab..58d3358e5 100644
--- a/docs/source/markdown/podman-ps.1.md
+++ b/docs/source/markdown/podman-ps.1.md
@@ -32,12 +32,18 @@ all the containers information. By default it lists:
**--all**, **-a**
-Show all the containers, default is only running containers
+Show all the containers created by Podman, default is only running containers.
+
+Note: Podman shares containers storage with other tools such as Buildah and CRI-O. In some cases these `external` containers might also exist in the same storage. Use the `--storage` option to see these external containers. External containers show the 'storage' status.
**--pod**, **-p**
Display the pods the containers are associated with
+**--storage**
+
+Display external containers that are not controlled by Podman but are stored in containers storage. These external containers are generally created via other container technology such as Buildah or CRI-O and may depend on the same container images that Podman is also using. External containers are denoted with either a 'buildah' or 'storage' in the COMMAND and STATUS column of the ps output. Only used with the --all option.
+
**--no-trunc**
Display the extended information
@@ -174,11 +180,20 @@ CONTAINER ID IMAGE COMMAND CREATED STATUS
```
+```
+$ podman ps --storage -a
+CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
+69ed779d8ef9f redis:alpine "redis-server" 25 hours ago Created 6379/tcp k8s_container1_podsandbox1_redhat.test.crio_redhat-test-crio_1
+38a8a78596f9 docker.io/library/busybox:latest buildah 2 hours ago storage busybox-working-container
+fd7b786b5c32 docker.io/library/alpine:latest buildah 2 hours ago storage alpine-working-container
+f78620804e00 scratch buildah 2 hours ago storage working-container
+```
+
## ps
Print a list of containers
## SEE ALSO
-podman(1)
+podman(1), buildah(1), crio(8)
## HISTORY
August 2017, Originally compiled by Urvashi Mohnani <umohnani@redhat.com>