From 966de2a5f9307fd3dd9cd5d2da525f85a4b595a2 Mon Sep 17 00:00:00 2001 From: Ioan Eugen Stan Date: Tue, 8 May 2018 22:16:15 +0300 Subject: [PATCH] Added description about pids count. Documentation in response to issue docker/for-linux#192 Signed-off-by: Ioan Eugen Stan --- docs/reference/commandline/stats.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/reference/commandline/stats.md b/docs/reference/commandline/stats.md index d8d86da6a9..702e99a92c 100644 --- a/docs/reference/commandline/stats.md +++ b/docs/reference/commandline/stats.md @@ -36,6 +36,8 @@ If you want more detailed information about a container's resource usage, use th > **Note**: On Linux, the Docker CLI reports memory usage by subtracting page cache usage from the total memory usage. The API does not perform such a calculation but rather provides the total memory usage and the amount from the page cache so that clients can use the data as needed. +> **Note**: The `PIDS` column contains the number of processes and kernel threads created by that container. Threads is the term used by Linux kernel. Other equivalent terms are "lightweight process" or "kernel task", etc. A large number in the `PIDS` column combined with a small number of processes (as reported by `ps` or `top`) may indicate that something in the container is creating many threads. + ## Examples Running `docker stats` on all running containers against a Linux daemon.