diff options
| author | baude <bbaude@redhat.com> | 2017-12-11 09:34:58 -0600 |
|---|---|---|
| committer | Atomic Bot <atomic-devel@projectatomic.io> | 2017-12-14 22:22:56 +0000 |
| commit | 3ba2c3e11791b9da11661ea45d966d2db621a6ac (patch) | |
| tree | ba83d175492e64b2949b27113cc4bdb98cc8f98a /docs | |
| parent | bbe6b21cb802737f933305f7c2013a86349ba43c (diff) | |
| download | podman-3ba2c3e11791b9da11661ea45d966d2db621a6ac.tar.gz podman-3ba2c3e11791b9da11661ea45d966d2db621a6ac.tar.bz2 podman-3ba2c3e11791b9da11661ea45d966d2db621a6ac.zip | |
kpod top
Display information about processes in a running container.
Signed-off-by: baude <bbaude@redhat.com>
Closes: #121
Approved by: rhatdan
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/kpod-top.1.md | 59 | ||||
| -rw-r--r-- | docs/kpod.1.md | 3 |
2 files changed, 62 insertions, 0 deletions
diff --git a/docs/kpod-top.1.md b/docs/kpod-top.1.md new file mode 100644 index 000000000..e19b7342c --- /dev/null +++ b/docs/kpod-top.1.md @@ -0,0 +1,59 @@ +% kpod(1) kpod-top - display the running processes of a container +% Brent Baude + +## NAME +kpod top - Display the running processes of a container + +## SYNOPSIS +**kpod 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 + +**kpod [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 + +``` +# kpod 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 +# +``` + +``` +#kpod --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 +# +``` +``` +# kpod 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 +kpod(1), ps(1) + +## HISTORY +December 2017, Originally compiled by Brent Baude<bbaude@redhat.com> diff --git a/docs/kpod.1.md b/docs/kpod.1.md index dec29e395..02f97739e 100644 --- a/docs/kpod.1.md +++ b/docs/kpod.1.md @@ -136,6 +136,9 @@ Stops one or more running containers. ### tag Add an additional name to a local image +### top +Display the running processes of a container + ### umount Unmount a working container's root file system |