From: Pavel Kretov Date: Tue, 24 Oct 2017 22:47:45 +0000 (+0300) Subject: btrfs-progs: defrag: add a brief warning about ref-link breakage X-Git-Tag: upstream/4.16.1~307 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=a624f1616731da6113ab9c6613be733ab41e664b;p=platform%2Fupstream%2Fbtrfs-progs.git btrfs-progs: defrag: add a brief warning about ref-link breakage There is a warning in btrfs-filesystem(8) saying that running 'defrag' in Linux will almost certainly break ref-links, with much data potentially being physically duplicated. However, many users tend to read man pages *after* trying to run things on their own risk and may miss this important information. This commit adds a brief copy of this warning into the command built-in help message where it has good chances to be spotted before user is stuck with a crowded filesystem. Pull-request: #73 Signed-off-by: Pavel Kretov Signed-off-by: David Sterba --- diff --git a/cmds-filesystem.c b/cmds-filesystem.c index c39f2d1..46aa497 100644 --- a/cmds-filesystem.c +++ b/cmds-filesystem.c @@ -893,6 +893,11 @@ static const char * const cmd_filesystem_defrag_usage[] = { "-s start defragment only from byte onward", "-l len defragment only up to len bytes", "-t size target extent size hint (default: 32M)", + "", + "Warning: most Linux kernels will break up the ref-links of COW data", + "(e.g., files copied with 'cp --reflink', snapshots) which may cause", + "considerable increase of space usage. See btrfs-filesystem(8) for", + "more information.", NULL };