summaryrefslogtreecommitdiff
path: root/docs/podman-port.1.md
diff options
context:
space:
mode:
authorbaude <bbaude@redhat.com>2018-01-22 13:56:08 -0600
committerbaude <bbaude@redhat.com>2018-01-23 08:54:57 -0600
commitb74e38b042cb32cead9adacbe75256a89e5cb664 (patch)
treeef61dc8a9e6ae41f46dea5fc1a1d22f78b1d4b70 /docs/podman-port.1.md
parenta03e040f0bb1d32645879b2c8bec7c5e1fe0561f (diff)
downloadpodman-b74e38b042cb32cead9adacbe75256a89e5cb664.tar.gz
podman-b74e38b042cb32cead9adacbe75256a89e5cb664.tar.bz2
podman-b74e38b042cb32cead9adacbe75256a89e5cb664.zip
podman port
podman port reports the port mappings per container. it can be used to report the ports ofa single container or latest container or all containers. in the case of a single container, the user can add an option filter for port and protocol. Signed-off-by: baude <bbaude@redhat.com>
Diffstat (limited to 'docs/podman-port.1.md')
-rw-r--r--docs/podman-port.1.md60
1 files changed, 60 insertions, 0 deletions
diff --git a/docs/podman-port.1.md b/docs/podman-port.1.md
new file mode 100644
index 000000000..026c52cca
--- /dev/null
+++ b/docs/podman-port.1.md
@@ -0,0 +1,60 @@
+% podman(1) podman-port - List port mappings for the CONTAINER, or lookup the public-facing port that is NAT-ed to the PRIVATE_PORT
+% Brent Baude
+# podman-port "1" "January 2018" "podman"
+
+## NAME
+podman port - List port mappings for a container
+
+## SYNOPSIS
+**podman port [OPTIONS] CONTAINER [PRIVATE_PORT[/PROTO]]**
+
+## DESCRIPTION
+List port mappings for the CONTAINER, or lookup the public-facing port that is NAT-ed to the PRIVATE_PORT
+
+## OPTIONS
+
+**--all, a**
+
+List all known port mappings for running containers. When using this option, you cannot pass any container names
+or private ports/protocols as filters.
+
+**--latest, -l**
+Instead of providing the container name or ID, use the last created container. If you use methods other than Podman
+to run containers such as CRI-O, the last started container could be from either of those methods.
+
+## EXAMPLE
+
+List all port mappings
+```
+#podman port -a
+b4d2f05432e482e017b1a4b2eae15fa7b4f6fb7e9f65c1bde46294fdef285906
+80/udp -> 0.0.0.0:44327
+80/tcp -> 0.0.0.0:44327
+#
+```
+
+List port mappings for a specific container
+```
+#podman port b4d2f054
+80/udp -> 0.0.0.0:44327
+80/tcp -> 0.0.0.0:44327
+#
+```
+List the port mappings for the latest container and port 80
+```
+#podman port b4d2f054 80
+ 0.0.0.0:44327
+#
+```
+
+List the port mappings for a specific container for port 80 and the tcp protocol.
+```
+#podman port b4d2f054 80/tcp
+0.0.0.0:44327
+#
+```
+## SEE ALSO
+podman(1), podan-inspect(1)
+
+## HISTORY
+January 2018, Originally compiled by Brent Baude <bbaude@redhat.com>