podman-pod-inspect

podman-pod-inspect(1) General Commands Manual podman-pod-inspect(1)

NAME

   podman-pod-inspect - Display 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, -f=format

   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                            
   
    .BlkioDeviceReadBps   Block I/O Device Read, in bytes/sec    
   
    .BlkioDeviceWriteBps  Block I/O Device Read, in bytes/sec    
   
    .BlkioWeight          Block I/O Weight                       
   
    .BlkioWeightDevice    Block I/O Device Weight                
   
    .CgroupParent         Pod cgroup parent                      
   
    .CgroupPath           Pod cgroup path                        
   
    .Containers           Pod containers                         
   
    .CPUPeriod            CPU period                             
   
    .CPUQuota             CPU quota                              
   
    .CPUSetCPUs           CPU Set CPUs                           
   
    .CPUSetMems           CPU Set Mems                           
   
    .CPUShares            CPU Shares                             
   
    .CreateCgroup         Whether cgroup was created             
   
    .CreateCommand        Create command                         
   
    .Created ...          Time when the pod was created          
   
    .CreateInfra          Whether infrastructure created         
   
    .Devices              Devices                                
   
    .ExitPolicy           Exit policy                            
   
    .Hostname             Pod hostname                           
   
    .ID                   Pod ID                                 
   
    .InfraConfig ...      Infra config (contains further fields) 
   
    .InfraContainerID     Pod infrastructure ID                  
   
    .InspectPodData ...   Nested structure, for experts only     
   
    .Labels ...           Pod labels                             
   
    .LockNumber           Number of the pod's Libpod lock        
   
    .MemoryLimit          Memory limit, bytes                    
   
    .MemorySwap           Memory swap limit, in bytes            
   
    .Mounts               Mounts                                 
   
    .Name                 Pod name                               
   
    .Namespace            Namespace                              
   
    .NumContainers        Number of containers in the pod        
   
    .RestartPolicy        Restart policy of the pod              
   
    .SecurityOpts         Security options                       
   
    .SharedNamespaces     Pod shared namespaces                  
   
    .State                Pod state                              
   
    .VolumesFrom          Volumes from                           
   

--latest, -l

   Instead  of  providing  the pod name or ID, use the last created pod.  Note: the last started pod can be from other users of Podman on the host machine.  (This option is not available
   with the remote Podman client, including Mac and Windows (excluding WSL2) machines)

EXAMPLE

   Inspect specified pod:

   # 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 bbaude@redhat.com mailto:bbaude@redhat.com

                                                                                                                                                                     podman-pod-inspect(1)