From fab56e8c8460170c9316e86f040352c6e5f8c4b0 Mon Sep 17 00:00:00 2001 From: David Sterba Date: Thu, 7 Dec 2017 19:56:34 +0100 Subject: btrfs-progs: docs: update manual for mkfs --shrink Signed-off-by: David Sterba --- Documentation/mkfs.btrfs.asciidoc | 21 ++++++++++++--------- 1 file changed, 12 insertions(+), 9 deletions(-) (limited to 'Documentation') diff --git a/Documentation/mkfs.btrfs.asciidoc b/Documentation/mkfs.btrfs.asciidoc index 153bb87e..2a1c3592 100644 --- a/Documentation/mkfs.btrfs.asciidoc +++ b/Documentation/mkfs.btrfs.asciidoc @@ -100,18 +100,21 @@ Please see the mount option 'discard' for that in `btrfs`(5). *-r|--rootdir *:: Populate the toplevel subvolume with files from 'rootdir'. This does not -require root permissions and does not mount the filesystem. +require root permissions to write the new files or to mount the filesystem. + -NOTE: This option may enlarge the image or file to ensure it's large enough to -contain the files from 'rootdir'. +NOTE: This option may enlarge the image or file to ensure it's big enough to +contain the files from 'rootdir'. Since version 4.14.1 the filesystem size is +not minimized. Please see option '--shrink' if you need that functionality. -*--shrink*: -Shrink the filesystem to its minimal size, only works with *-r|--rootdir* -option. +*--shrink*:: +Shrink the filesystem to its minimal size, only works with '--rootdir' option. + -NOTE: If the destination is regular file, this option will also reduce the -file size. Or it will only reduce the filesystem available space. -Extra space will not be usable unless resized using 'btrfs filesystem resize'. +If the destination is a regular file, this option will also truncate the +file to the minimal size. Otherwise it will reduce the filesystem available +space. Extra space will not be usable unless the filesystem is mounted and +resized using 'btrfs filesystem resize'. ++ +NOTE: prior to version 4.14.1, the shrinking was done automatically. *-O|--features [,...]*:: A list of filesystem features turned on at mkfs time. Not all features are -- cgit v1.2.3