Skip to content

Latest commit

 

History

History
77 lines (64 loc) · 3.34 KB

podman-pod-inspect.1.md

File metadata and controls

77 lines (64 loc) · 3.34 KB

% podman-pod-inspect(1)

NAME

podman-pod-inspect - Displays information describing a pod

SYNOPSIS

podman pod inspect [options] pod ...

DESCRIPTION

Displays configuration and state information about a given pod. It also displays information about containers that belong to the pod.

OPTIONS

--format=format, -f

Change the default output format. This can be of a supported type like 'json' or a Go template. Valid placeholders for the Go template are listed below:

Placeholder Description
.ID Pod ID
.Name Pod name
.State Pod state
.Hostname Pod hostname
.Labels Pod labels
.Created Time when the pod was created
.CreateCgroup Whether cgroup was created
.CgroupParent Pod cgroup parent
.CgroupPath Pod cgroup path
.CreateInfra Whether infrastructure created
.InfraContainerID Pod infrastructure ID
.SharedNamespaces Pod shared namespaces
.NumContainers Number of containers in the pod
.Containers Pod containers

--latest, -l

Instead of providing the pod name or ID, use the last created pod. If you use methods other than Podman to run pods such as CRI-O, the last started pod could be from either of those methods. (This option is not available with the remote Podman client, including Mac and Windows (excluding WSL2) machines)

EXAMPLE

# podman pod inspect foobar
{

     "Id": "3513ca70583dd7ef2bac83331350f6b6c47d7b4e526c908e49d89ebf720e4693",
     "Name": "foobar",
     "Labels": {},
     "CgroupParent": "/libpod_parent",
     "CreateCgroup": true,
     "Created": "2018-08-08T11:15:18.823115347-05:00"
     "State": "created",
     "Hostname": "",
     "SharedNamespaces": [
          "uts",
          "ipc",
          "net"
     ]
     "CreateInfra": false,
     "InfraContainerID": "1020dd70583dd7ff2bac83331350f6b6e007de0d026c908e49d89ebf891d4699"
     "CgroupPath": ""
     "Containers": [
          {
               "id": "d53f8bf1e9730281264aac6e6586e327429f62c704abea4b6afb5d8a2b2c9f2c",
               "state": "configured"
          }
     ]
}

SEE ALSO

podman(1), podman-pod(1), podman-inspect(1)

HISTORY

August 2018, Originally compiled by Brent Baude [email protected]