summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorOpenShift Merge Robot <openshift-merge-robot@users.noreply.github.com>2021-01-13 16:22:45 -0500
committerGitHub <noreply@github.com>2021-01-13 16:22:45 -0500
commitb2ac2a3f10a8eaf9a2bc9040bacd3a2a94decbd0 (patch)
treec2aadbca75077931e05c15ffc1349dd6554dc907
parente273ba34efd1c6fe928cde832d3da8f5a9bc6c49 (diff)
parenta7c0c9125fba436669f28ab199aae5df3c48b2ae (diff)
downloadpodman-b2ac2a3f10a8eaf9a2bc9040bacd3a2a94decbd0.tar.gz
podman-b2ac2a3f10a8eaf9a2bc9040bacd3a2a94decbd0.tar.bz2
podman-b2ac2a3f10a8eaf9a2bc9040bacd3a2a94decbd0.zip
Merge pull request #8962 from rhatdan/man
[CI:DOCS] Add more information and examples on podman and pipes
-rw-r--r--.gitignore2
-rw-r--r--docs/source/markdown/podman-run.1.md14
2 files changed, 14 insertions, 2 deletions
diff --git a/.gitignore b/.gitignore
index 208a71f37..f87c8974f 100644
--- a/.gitignore
+++ b/.gitignore
@@ -33,3 +33,5 @@ release.txt
result
# Necessary to prevent hack/tree-status.sh false-positive
/*runner_stats.log
+.install.goimports
+.generate-bindings
diff --git a/docs/source/markdown/podman-run.1.md b/docs/source/markdown/podman-run.1.md
index 674079a9d..74c231184 100644
--- a/docs/source/markdown/podman-run.1.md
+++ b/docs/source/markdown/podman-run.1.md
@@ -1011,8 +1011,11 @@ When set to **true**, Podman will allocate a pseudo-tty and attach to the standa
input of the container. This can be used, for example, to run a throwaway
interactive shell. The default is **false**.
-**NOTE**: The **-t** option is incompatible with a redirection of the Podman client
-standard input.
+**NOTE**: The --tty flag prevents redirection of standard output. It combines STDOUT and STDERR, it can insert control characters, and it can hang pipes. This option should only be used when run interactively in a terminal. When feeding input to Podman, use -i only, not -it.
+
+```
+echo "asdf" | podman run --rm -i someimage /bin/cat
+```
#### **--tz**=*timezone*
@@ -1528,6 +1531,13 @@ weight by **--blkio-weight-device** flag. Use the following command:
$ podman run -it --blkio-weight-device "/dev/sda:200" ubuntu
```
+### Using a podman container with input from a pipe
+
+```
+$ echo "asdf" | podman run --rm -i --entrypoint /bin/cat someimage
+asdf
+```
+
### Setting Namespaced Kernel Parameters (Sysctls)
The **--sysctl** sets namespaced kernel parameters (sysctls) in the