summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorOpenShift Merge Robot <openshift-merge-robot@users.noreply.github.com>2021-05-06 14:50:26 -0400
committerGitHub <noreply@github.com>2021-05-06 14:50:26 -0400
commit034470e5be8cfeef8ce0e0d2f47587a660682219 (patch)
tree74af195993a2fd2136c980b8035629fe4863051d /docs
parent44184167e495a64f1a565a2bc2cccb6b5bc56eaa (diff)
parentefdc7d84652bbdbf398c88d0287b0740f040a588 (diff)
downloadpodman-034470e5be8cfeef8ce0e0d2f47587a660682219.tar.gz
podman-034470e5be8cfeef8ce0e0d2f47587a660682219.tar.bz2
podman-034470e5be8cfeef8ce0e0d2f47587a660682219.zip
Merge pull request #9689 from boaz0/boaz-1
add restart-policy to container filters & --filter to podman start
Diffstat (limited to 'docs')
-rw-r--r--docs/source/markdown/podman-start.1.md25
1 files changed, 25 insertions, 0 deletions
diff --git a/docs/source/markdown/podman-start.1.md b/docs/source/markdown/podman-start.1.md
index 626e6e368..7085f3f47 100644
--- a/docs/source/markdown/podman-start.1.md
+++ b/docs/source/markdown/podman-start.1.md
@@ -42,6 +42,31 @@ Proxy received signals to the process (non-TTY mode only). SIGCHLD, SIGSTOP, and
Start all the containers created by Podman, default is only running containers.
+#### **\-\-filter**, **-f**
+
+Filter what containers are going to be started from the given arguments.
+Multiple filters can be given with multiple uses of the --filter flag.
+Filters with the same key work inclusive with the only exception being
+`label` which is exclusive. Filters with different keys always work exclusive.
+
+Valid filters are listed below:
+
+| **Filter** | **Description** |
+| --------------- | -------------------------------------------------------------------------------- |
+| id | [ID] Container's ID (accepts regex) |
+| name | [Name] Container's name (accepts regex) |
+| label | [Key] or [Key=Value] Label assigned to a container |
+| exited | [Int] Container's exit code |
+| status | [Status] Container's status: 'created', 'exited', 'paused', 'running', 'unknown' |
+| ancestor | [ImageName] Image or descendant used to create container |
+| before | [ID] or [Name] Containers created before this container |
+| since | [ID] or [Name] Containers created since this container |
+| volume | [VolumeName] or [MountpointDestination] Volume mounted in container |
+| health | [Status] healthy or unhealthy |
+| pod | [Pod] name or full or partial ID of pod |
+| network | [Network] name or full ID of network |
+
+
## EXAMPLE
podman start mywebserver