summaryrefslogtreecommitdiff
path: root/docs/podman-pod-top.1.md
diff options
context:
space:
mode:
authorbaude <bbaude@redhat.com>2019-10-24 14:54:57 -0500
committerbaude <bbaude@redhat.com>2019-10-31 12:31:39 -0500
commit52b92023edeba3a5e2c466d92d742e54b14a85cb (patch)
tree44e6193d49afd1277b7d07b0df41fc80d31b3adb /docs/podman-pod-top.1.md
parent5af166ff513265b17aee92a9ce3a1522090d7dec (diff)
downloadpodman-52b92023edeba3a5e2c466d92d742e54b14a85cb.tar.gz
podman-52b92023edeba3a5e2c466d92d742e54b14a85cb.tar.bz2
podman-52b92023edeba3a5e2c466d92d742e54b14a85cb.zip
Restructure documentation dir
Restructuring the docs dir to make integration with sphinx easier. man pages now exist in docs/source/man and the sphinx make files exists in docs. Signed-off-by: baude <bbaude@redhat.com>
Diffstat (limited to 'docs/podman-pod-top.1.md')
-rw-r--r--docs/podman-pod-top.1.md94
1 files changed, 0 insertions, 94 deletions
diff --git a/docs/podman-pod-top.1.md b/docs/podman-pod-top.1.md
deleted file mode 100644
index 48f10055a..000000000
--- a/docs/podman-pod-top.1.md
+++ /dev/null
@@ -1,94 +0,0 @@
-% podman-pod-top(1)
-
-## NAME
-podman\-pod\-top - Display the running processes of containers in a pod
-
-## SYNOPSIS
-**podman pod top** [*options*] *pod* [*format-descriptors*]
-
-## DESCRIPTION
-Display the running processes of containers in a pod. The *format-descriptors* are ps (1) compatible AIX format descriptors but extended to print additional information, such as the seccomp mode or the effective capabilities of a given process. The descriptors can either be passed as separated arguments or as a single comma-separated argument. Note that you can also specify options and or flags of ps(1); in this case, Podman will fallback to executing ps with the specified arguments and flags in the container.
-
-## OPTIONS
-
-**--help**, **-h**
-
- Print usage statement
-
-**--latest**, **-l**
-
-Instead of providing the pod name or ID, use the last created pod.
-
-The latest option is not supported on the remote client.
-
-## FORMAT DESCRIPTORS
-
-The following descriptors are supported in addition to the AIX format descriptors mentioned in ps (1):
-
-**args**, **capbnd**, **capeff**, **capinh**, **capprm**, **comm**, **etime**, **group**, **hgroup**, **hpid**, **huser**, **label**, **nice**, **pcpu**, **pgid**, **pid**, **ppid**, **rgroup**, **ruser**, **seccomp**, **state**, **time**, **tty**, **user**, **vsz**
-
-**capbnd**
-
- Set of bounding capabilities. See capabilities (7) for more information.
-
-**capeff**
-
- Set of effective capabilities. See capabilities (7) for more information.
-
-**capinh**
-
- Set of inheritable capabilities. See capabilities (7) for more information.
-
-**capprm**
-
- Set of permitted capabilities. See capabilities (7) for more information.
-
-**hgroup**
-
- The corresponding effective group of a container process on the host.
-
-**hpid**
-
- The corresponding host PID of a container process.
-
-**huser**
-
- The corresponding effective user of a container process on the host.
-
-**label**
-
- Current security attributes of the process.
-
-**seccomp**
-
- Seccomp mode of the process (i.e., disabled, strict or filter). See seccomp (2) for more information.
-
-**state**
-
- Process state codes (e.g, **R** for *running*, **S** for *sleeping*). See proc(5) for more information.
-
-## EXAMPLES
-
-By default, `podman-top` prints data similar to `ps -ef`:
-
-```
-$ podman pod top b031293491cc
-USER PID PPID %CPU ELAPSED TTY TIME COMMAND
-root 1 0 0.000 2h5m38.737137571s ? 0s top
-root 8 0 0.000 2h5m15.737228361s ? 0s top
-```
-
-The output can be controlled by specifying format descriptors as arguments after the pod:
-
-```
-$ podman pod top -l pid seccomp args %C
-PID SECCOMP COMMAND %CPU
-1 filter top 0.000
-1 filter /bin/sh 0.000
-```
-
-## SEE ALSO
-podman-pod(1), ps(1), seccomp(2), proc(5), capabilities(7)
-
-## HISTORY
-August 2018, Originally compiled by Peter Hunt <pehunt@redhat.com>