From f4da7448ee89b9c62b2274b4968ae2fea5ddbd4f Mon Sep 17 00:00:00 2001 From: Vincent Demeester Date: Wed, 22 Mar 2017 13:46:48 +0100 Subject: [PATCH] Merge pull request #31973 from wsong/update_df_docs Update system df docs to call out performance implications (cherry picked from commit f453412bd8f161453981a828e989209c6cdf32f5) Signed-off-by: Sebastiaan van Stijn --- docs/reference/commandline/system_df.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs/reference/commandline/system_df.md b/docs/reference/commandline/system_df.md index 6758bdeb72..86cc9896c0 100644 --- a/docs/reference/commandline/system_df.md +++ b/docs/reference/commandline/system_df.md @@ -77,6 +77,15 @@ my-named-vol 0 > **Note**: Network information is not shown because it doesn't consume the disk > space. +## Performance + +The `system df` command can be very resource-intensive. It traverses the +filesystem of every image, container, and volume in the system. You should be +careful running this command in systems with lots of images, containers, or +volumes or in systems where some images, containers, or volumes have very large +filesystems with many files. You should also be careful not to run this command +in systems where performance is critical. + ## Related commands * [system prune](system_prune.md) * [container prune](container_prune.md)