FreeBSD Manual Pages
podman-container-inspect(1) General Commands Manualpodman-container-inspect(1) NAME podman-container-inspect - Display a container's configuration SYNOPSIS podman container inspect [options] container [container ...] DESCRIPTION This displays the low-level information on containers identified by name or ID. By default, this renders all results in a JSON array. If a format is specified, the given template is executed for each result. OPTIONS --format, -f=format Format the output using the given Go template. The keys of the re- turned JSON can be used as the values for the --format flag (see exam- ples below). Valid placeholders for the Go template are listed below: +--------------------------+-------------------------------+ | Placeholder | Description | +--------------------------+-------------------------------+ | .AppArmorProfile | AppArmor profile (string) | +--------------------------+-------------------------------+ | .Args | Command-line arguments (array | | | of strings) | +--------------------------+-------------------------------+ | .BoundingCaps | Bounding capability set (ar- | | | ray of strings) | +--------------------------+-------------------------------+ | .Config ... | Structure with config info | +--------------------------+-------------------------------+ | .ConmonPidFile | Path to file containing con- | | | mon pid (string) | +--------------------------+-------------------------------+ | .Created ... | Container creation time | | | (string, ISO3601) | +--------------------------+-------------------------------+ | .Dependencies | Dependencies (array of | | | strings) | +--------------------------+-------------------------------+ | .Driver | Storage driver (string) | +--------------------------+-------------------------------+ | .EffectiveCaps | Effective capability set (ar- | | | ray of strings) | +--------------------------+-------------------------------+ | .ExecIDs | Exec IDs (array of strings) | +--------------------------+-------------------------------+ | .GraphDriver ... | Further details of graph dri- | | | ver (struct) | +--------------------------+-------------------------------+ | .HostConfig ... | Host config details (struct) | +--------------------------+-------------------------------+ | .HostnamePath | Path to file containing host- | | | name (string) | +--------------------------+-------------------------------+ | .HostsPath | Path to container /etc/hosts | | | file (string) | +--------------------------+-------------------------------+ | .ID | Container ID (full 64-char | | | hash) | +--------------------------+-------------------------------+ | .Image | Container image ID (64-char | | | hash) | +--------------------------+-------------------------------+ | .ImageDigest | Container image digest | | | (sha256:+64-char hash) | +--------------------------+-------------------------------+ | .ImageName | Container image name (string) | +--------------------------+-------------------------------+ | .IsInfra | Is this an infra container? | | | (string: true/false) | +--------------------------+-------------------------------+ | .IsService | Is this a service container? | | | (string: true/false) | +--------------------------+-------------------------------+ | .KubeExitCodePropagation | Kube exit-code propagation | | | (string) | +--------------------------+-------------------------------+ | .LockNumber | Number of the container's | | | Libpod lock | +--------------------------+-------------------------------+ | .MountLabel | SELinux label of mount | | | (string) | +--------------------------+-------------------------------+ | .Mounts | Mounts (array of strings) | +--------------------------+-------------------------------+ | .Name | Container name (string) | +--------------------------+-------------------------------+ | .Namespace | Container namespace (string) | +--------------------------+-------------------------------+ | .NetworkSettings ... | Network settings (struct) | +--------------------------+-------------------------------+ | .OCIConfigPath | Path to OCI config file | | | (string) | +--------------------------+-------------------------------+ | .OCIRuntime | OCI runtime name (string) | +--------------------------+-------------------------------+ | .Path | Path to container command | | | (string) | +--------------------------+-------------------------------+ | .PidFile | Path to file containing con- | | | tainer PID (string) | +--------------------------+-------------------------------+ | .Pod | Parent pod (string) | +--------------------------+-------------------------------+ | .ProcessLabel | SELinux label of process | | | (string) | +--------------------------+-------------------------------+ | .ResolvConfPath | Path to container's re- | | | solv.conf file (string) | +--------------------------+-------------------------------+ | .RestartCount | Number of times container has | | | been restarted (int) | +--------------------------+-------------------------------+ | .Rootfs | Container rootfs (string) | +--------------------------+-------------------------------+ | .SizeRootFs | Size of rootfs, in bytes [1] | +--------------------------+-------------------------------+ | .SizeRw | Size of upper (R/W) container | | | layer, in bytes [1] | +--------------------------+-------------------------------+ | .State ... | Container state info (struct) | +--------------------------+-------------------------------+ | .StaticDir | Path to container metadata | | | dir (string) | +--------------------------+-------------------------------+ [1] This format specifier requires the --size option --latest, -l Instead of providing the container name or ID, use the last created container. Note: the last started container can be from other users of Podman on the host machine. (This option is not available with the re- mote Podman client, including Mac and Windows (excluding WSL2) ma- chines) --size, -s In addition to normal output, display the total file size if the type is a container. EXAMPLE Inspect the specified container and print its information in json for- mat. $ podman container inspect foobar [ { "Id": "99f66530fe9c7249f7cf29f78e8661669d5831cbe4ee80ea757d5e922dd6a8a6", "Created": "2021-09-16T06:09:08.936623325-04:00", "Path": "echo", "Args": [ "hi" ], "State": { "OciVersion": "1.0.2-dev", "Status": "exited", "Running": false, "Paused": false, "Restarting": false, "OOMKilled": false, "Dead": false, "Pid": 0, "ExitCode": 0, "Error": "", "StartedAt": "2021-09-16T06:09:09.033564436-04:00", "FinishedAt": "2021-09-16T06:09:09.036184314-04:00", "Healthcheck": { "Status": "", "FailingStreak": 0, "Log": null } }, "Image": "14119a10abf4669e8cdbdff324a9f9605d99697215a0d21c360fe8dfa8471bab", "ImageName": "docker.io/library/alpine:latest", "Rootfs": "", "Pod": "", "ResolvConfPath": "/run/user/3267/containers/overlay-containers/99f66530fe9c7249f7cf29f78e8661669d5831cbe4ee80ea757d5e922dd6a8a6/userdata/resolv.conf", "HostnamePath": "/run/user/3267/containers/overlay-containers/99f66530fe9c7249f7cf29f78e8661669d5831cbe4ee80ea757d5e922dd6a8a6/userdata/hostname", "HostsPath": "/run/user/3267/containers/overlay-containers/99f66530fe9c7249f7cf29f78e8661669d5831cbe4ee80ea757d5e922dd6a8a6/userdata/hosts", "StaticDir": "/home/dwalsh/.local/share/containers/storage/overlay-containers/99f66530fe9c7249f7cf29f78e8661669d5831cbe4ee80ea757d5e922dd6a8a6/userdata", "OCIConfigPath": "/home/dwalsh/.local/share/containers/storage/overlay-containers/99f66530fe9c7249f7cf29f78e8661669d5831cbe4ee80ea757d5e922dd6a8a6/userdata/config.json", "OCIRuntime": "crun", "ConmonPidFile": "/run/user/3267/containers/overlay-containers/99f66530fe9c7249f7cf29f78e8661669d5831cbe4ee80ea757d5e922dd6a8a6/userdata/conmon.pid", "PidFile": "/run/user/3267/containers/overlay-containers/99f66530fe9c7249f7cf29f78e8661669d5831cbe4ee80ea757d5e922dd6a8a6/userdata/pidfile", "Name": "foobar", "RestartCount": 0, "Driver": "overlay", "MountLabel": "system_u:object_r:container_file_t:s0:c25,c695", "ProcessLabel": "system_u:system_r:container_t:s0:c25,c695", "AppArmorProfile": "", "EffectiveCaps": [ "CAP_CHOWN", "CAP_DAC_OVERRIDE", "CAP_FOWNER", "CAP_FSETID", "CAP_KILL", "CAP_NET_BIND_SERVICE", "CAP_SETFCAP", "CAP_SETGID", "CAP_SETPCAP", "CAP_SETUID", ], "BoundingCaps": [ "CAP_CHOWN", "CAP_DAC_OVERRIDE", "CAP_FOWNER", "CAP_FSETID", "CAP_KILL", "CAP_NET_BIND_SERVICE", "CAP_SETFCAP", "CAP_SETGID", "CAP_SETPCAP", "CAP_SETUID", ], "ExecIDs": [], "GraphDriver": { "Name": "overlay", "Data": { "LowerDir": "/home/dwalsh/.local/share/containers/storage/overlay/e2eb06d8af8218cfec8210147357a68b7e13f7c485b991c288c2d01dc228bb68/diff", "UpperDir": "/home/dwalsh/.local/share/containers/storage/overlay/8f3d70434a3db17410ec4710caf4f251f3e4ed0a96a08124e4b3d4af0a0ea300/diff", "WorkDir": "/home/dwalsh/.local/share/containers/storage/overlay/8f3d70434a3db17410ec4710caf4f251f3e4ed0a96a08124e4b3d4af0a0ea300/work" } }, "Mounts": [], "Dependencies": [], "NetworkSettings": { "EndpointID": "", "Gateway": "", "IPAddress": "", "IPPrefixLen": 0, "IPv6Gateway": "", "GlobalIPv6Address": "", "GlobalIPv6PrefixLen": 0, "MacAddress": "", "Bridge": "", "SandboxID": "", "HairpinMode": false, "LinkLocalIPv6Address": "", "LinkLocalIPv6PrefixLen": 0, "Ports": {}, "SandboxKey": "" }, "Namespace": "", "IsInfra": false, "Config": { "Hostname": "99f66530fe9c", "Domainname": "", "User": "", "AttachStdin": false, "AttachStdout": false, "AttachStderr": false, "Tty": false, "OpenStdin": false, "StdinOnce": false, "Env": [ "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin", "TERM=xterm", "container=podman", "HOME=/root", "HOSTNAME=99f66530fe9c" ], "Cmd": [ "echo", "hi" ], "Image": "docker.io/library/alpine:latest", "Volumes": null, "WorkingDir": "/", "Entrypoint": "", "OnBuild": null, "Labels": null, "Annotations": { "io.container.manager": "libpod", "io.kubernetes.cri-o.Created": "2021-09-16T06:09:08.936623325-04:00", "org.opencontainers.image.stopSignal": "15" }, "StopSignal": 15, "CreateCommand": [ "podman", "run", "--name", "foobar", "alpine", "echo", "hi" ], "Timezone": "local", "Umask": "0022", "Timeout": 0, "StopTimeout": 10 }, "HostConfig": { "Binds": [], "CgroupManager": "systemd", "CgroupMode": "private", "ContainerIDFile": "", "LogConfig": { "Type": "journald", "Config": null, "Path": "", "Tag": "", "Size": "0B" }, "NetworkMode": "slirp4netns", "PortBindings": {}, "RestartPolicy": { "Name": "", "MaximumRetryCount": 0 }, "AutoRemove": false, "VolumeDriver": "", "VolumesFrom": null, "CapAdd": [], "CapDrop": [], "Dns": [], "DnsOptions": [], "DnsSearch": [], "ExtraHosts": [], "GroupAdd": [], "IpcMode": "shareable", "Cgroup": "", "Cgroups": "default", "Links": null, "OomScoreAdj": 0, "PidMode": "private", "Privileged": false, "PublishAllPorts": false, "ReadonlyRootfs": false, "SecurityOpt": [], "Tmpfs": {}, "UTSMode": "private", "UsernsMode": "", "ShmSize": 65536000, "Runtime": "oci", "ConsoleSize": [ 0, 0 ], "Isolation": "", "CpuShares": 0, "Memory": 0, "NanoCpus": 0, "CgroupParent": "user.slice", "BlkioWeight": 0, "BlkioWeightDevice": null, "BlkioDeviceReadBps": null, "BlkioDeviceWriteBps": null, "BlkioDeviceReadIOps": null, "BlkioDeviceWriteIOps": null, "CpuPeriod": 0, "CpuQuota": 0, "CpuRealtimePeriod": 0, "CpuRealtimeRuntime": 0, "CpusetCpus": "", "CpusetMems": "", "Devices": [], "DiskQuota": 0, "KernelMemory": 0, "MemoryReservation": 0, "MemorySwap": 0, "MemorySwappiness": 0, "OomKillDisable": false, "PidsLimit": 2048, "Ulimits": [], "CpuCount": 0, "CpuPercent": 0, "IOMaximumIOps": 0, "IOMaximumBandwidth": 0, "CgroupConf": null } } ] Inspect the specified container for the Image Name it is based on. $ podman container inspect nervous_fermi --format "{{.ImageName}}" registry.access.redhat.com/ubi8:latest Inspect the specified container for the GraphDriver Name it is running with. $ podman container inspect foobar --format "{{.GraphDriver.Name}}" overlay Inspect the latest container created for its EffectiveCaps field. (This option is not available with the remote Podman client, including Mac and Windows (excluding WSL2) machines) $ podman container inspect --latest --format {{.EffectiveCaps}} [CAP_CHOWN CAP_DAC_OVERRIDE CAP_FOWNER CAP_FSETID CAP_KILL CAP_NET_BIND_SERVICE CAP_SETFCAP CAP_SETGID CAP_SETPCAP CAP_SETUID] SEE ALSO podman(1), podman-container(1), podman-inspect(1) HISTORY Sep 2021, Originally compiled by Dan Walsh dwalsh@redhat.com <mailto:dwalsh@redhat.com> podman-container-inspect(1)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLE | SEE ALSO | HISTORY
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=podman-container-inspect&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>