1 files changed, 115 insertions, 0 deletions
diff --git a/docs/source/markdown/podman-inspect.1.md b/docs/source/markdown/podman-inspect.1.md
new file mode 100644
index 000000000..f1630c713
--- /dev/null
+++ b/docs/source/markdown/podman-inspect.1.md
@@ -0,0 +1,115 @@
+% podman-inspect(1)
+
+## NAME
+podman\-inspect - Display a container or image's configuration
+
+## SYNOPSIS
+**podman inspect** [*options*] *name* [...]
+
+**podman image inspect** [*options*] *image*
+
+**podman container inspect** [*options*] *container*
+
+## DESCRIPTION
+This displays the low-level information on containers and images identified by name or ID. By default, this will render
+all results in a JSON array. If the container and image have the same name, this will return container JSON for
+unspecified type. If a format is specified, the given template will be executed for each result.
+
+## OPTIONS
+
+**--type**, **-t**=*type*
+
+Return JSON for the specified type.  Type can be 'container', 'image' or 'all' (default: all)
+(Only meaningful when invoked as *podman inspect*)
+
+**--format**, **-f**=*format*
+
+Format the output using the given Go template.
+The keys of the returned JSON can be used as the values for the --format flag (see examples below).
+
+**--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.
+
+The latest option is not supported on the remote client or when invoked as *podman image inspect*.
+
+**--size**, **-s**
+
+Display the total file size if the type is a container
+
+
+## EXAMPLE
+
+```
+# podman inspect fedora
+{
+    "Id": "422dc563ca3260ad9ef5c47a1c246f5065d7f177ce51f4dd208efd82967ff182",
+    "Digest": "sha256:1b9bfb4e634dc1e5c19d0fa1eb2e5a28a5c2b498e3d3e4ac742bd7f5dae08611",
+    "RepoTags": [
+        "docker.io/library/fedora:latest"
+    ],
+    "RepoDigests": [
+        "docker.io/library/fedora@sha256:1b9bfb4e634dc1e5c19d0fa1eb2e5a28a5c2b498e3d3e4ac742bd7f5dae08611"
+    ],
+    "Parent": "",
+    "Comment": "",
+    "Created": "2017-11-14T21:07:08.475840838Z",
+    "Config": {
+        "Env": [
+            "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin",
+            "DISTTAG=f27container",
+            "FGC=f27",
+            "FBR=f27"
+        ]
+    },
+    "Version": "17.06.2-ce",
+    "Author": "[Adam Miller \u003cmaxamillion@fedoraproject.org\u003e] [Patrick Uiterwijk \u003cpatrick@puiterwijk.org\u003e]",
+    "Architecture": "amd64",
+    "Os": "linux",
+    "Size": 251722732,
+    "VirtualSize": 514895140,
+    "GraphDriver": {
+        "Name": "overlay",
+        "Data": {
+            "MergedDir": "/var/lib/containers/storage/overlay/d32459d9ce237564fb93573b85cbc707600d43fbe5e46e8eeef22cad914bb516/merged",
+            "UpperDir": "/var/lib/containers/storage/overlay/d32459d9ce237564fb93573b85cbc707600d43fbe5e46e8eeef22cad914bb516/diff",
+            "WorkDir": "/var/lib/containers/storage/overlay/d32459d9ce237564fb93573b85cbc707600d43fbe5e46e8eeef22cad914bb516/work"
+        }
+    },
+    "RootFS": {
+        "Type": "layers",
+        "Layers": [
+            "sha256:d32459d9ce237564fb93573b85cbc707600d43fbe5e46e8eeef22cad914bb516"
+        ]
+    },
+    "Labels": null,
+    "Annotations": {}
+}
+```
+
+```
+# podman inspect a04 --format "{{.ImageName}}"
+fedora
+```
+
+```
+# podman inspect a04 --format "{{.GraphDriver.Name}}"
+overlay
+```
+
+```
+# podman image inspect --format "size: {{.Size}}" alpine
+size:   4405240
+```
+
+```
+podman container inspect --latest --format {{.EffectiveCaps}}
+[CAP_CHOWN CAP_DAC_OVERRIDE CAP_FSETID CAP_FOWNER CAP_MKNOD CAP_NET_RAW CAP_SETGID CAP_SETUID CAP_SETFCAP CAP_SETPCAP CAP_NET_BIND_SERVICE CAP_SYS_CHROOT CAP_KILL CAP_AUDIT_WRITE]
+```
+
+## SEE ALSO
+podman(1)
+
+## HISTORY
+July 2017, Originally compiled by Dan Walsh <dwalsh@redhat.com>