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>
This commit is contained in:
baude
2018-01-22 13:56:08 -06:00
parent a03e040f0b
commit b74e38b042
6 changed files with 263 additions and 0 deletions

60
docs/podman-port.1.md Normal file
View File

@ -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>