From: Wang Shilong Date: Tue, 23 Apr 2019 14:58:28 +0000 (+0900) Subject: fstrim: document kernel return minlen explicitly X-Git-Tag: v2.34-rc1~18 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=ce3d198d7c6031ef22bd23c80c24ea5c6ce0f194;p=thirdparty%2Futil-linux.git fstrim: document kernel return minlen explicitly Filesystem will modify @minlen according to its block size etc, and will return actual unit to userspace, document it into manpage. Cc: Darrick J. Wong Signed-off-by: Wang Shilong Reviewed-by: Darrick J. Wong --- diff --git a/sys-utils/fstrim.8 b/sys-utils/fstrim.8 index f7e7aa9ef6..c6ecca7064 100644 --- a/sys-utils/fstrim.8 +++ b/sys-utils/fstrim.8 @@ -76,10 +76,11 @@ the end of the filesystem. .IP "\fB\-m, \-\-minimum\fP \fIminimum-size\fP" Minimum contiguous free range to discard, in bytes. (This value is internally rounded up to a multiple of the filesystem block size.) Free ranges smaller -than this will be ignored. By increasing this value, the fstrim operation -will complete more quickly for filesystems with badly fragmented freespace, -although not all blocks will be discarded. The default value is zero, -discarding every free block. +than this will be ignored and fstrim will adjust the minimum if it's smaller than +the device's minimum, and report that (fstrim_range.minlen) back to userspace. +By increasing this value, the fstrim operation will complete more quickly for +filesystems with badly fragmented freespace, although not all blocks will be +discarded. The default value is zero, discarding every free block. .IP "\fB\-v, \-\-verbose\fP" Verbose execution. With this option .B fstrim