1 files changed, 59 insertions, 0 deletions
diff --git a/docs/podman-top.1.md b/docs/podman-top.1.md
new file mode 100644
index 000000000..1067cdc52
--- /dev/null
+++ b/docs/podman-top.1.md
@@ -0,0 +1,59 @@
+% podman(1) podman-top - display the running processes of a container
+% Brent Baude
+
+## NAME
+podman top - Display the running processes of a container
+
+## SYNOPSIS
+**podman top**
+[**--help**|**-h**]
+
+## DESCRIPTION
+Display the running process of the container. ps-OPTION can be any of the options you would pass to a Linux ps command
+
+**podman [GLOBAL OPTIONS] top [OPTIONS]**
+
+## OPTIONS
+
+**--help, -h**
+  Print usage statement
+
+**--format**
+  Display the output in an alternate format.  The only supported format is **JSON**.
+
+## EXAMPLES
+
+```
+# podman top f5a62a71b07
+  UID   PID  PPID %CPU STIME TT           TIME CMD
+    0 18715 18705  0.0 10:35 pts/0    00:00:00 /bin/bash
+    0 18741 18715  0.0 10:35 pts/0    00:00:00 vi
+#
+```
+
+```
+#podman --log-level=debug top f5a62a71b07 -o fuser,f,comm,label
+FUSER    F COMMAND         LABEL
+root     4 bash            system_u:system_r:container_t:s0:c429,c1016
+root     0 vi              system_u:system_r:container_t:s0:c429,c1016
+#
+```
+```
+# podman top --format=json f5a62a71b07b -o %cpu,%mem,command,blocked
+[
+    {
+        "CPU": "0.0",
+        "MEM": "0.0",
+        "COMMAND": "vi",
+        "BLOCKED": "0000000000000000",
+        "START": "",
+        "TIME": "",
+        "C": "",
+        "CAUGHT": "",
+        ...
+```
+## SEE ALSO
+podman(1), ps(1)
+
+## HISTORY
+December 2017, Originally compiled by Brent Baude<bbaude@redhat.com>