Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=podman-pod-inspect&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help