Signed-off-by: Wengang Wang <wen.gang.wang@xxxxxxxxxx> --- man/man8/xfs_spaceman.8 | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/man/man8/xfs_spaceman.8 b/man/man8/xfs_spaceman.8 index ece840d7..87324f21 100644 --- a/man/man8/xfs_spaceman.8 +++ b/man/man8/xfs_spaceman.8 @@ -24,6 +24,28 @@ arguments may be given. The commands are run in the sequence given, then the program exits. .SH COMMANDS +.TP +.BI "defrag [-i interval] [-e nr_ext]" +.B defrag +defragments the specified XFS file. It requires +.B reflink +feature enabled in the file system. +This command defragments the file segment by segment. In the betweens of segments, file reads/writes are served in parallel. +The command takes the following options: +.RS 1.0i +.PD 0 +.TP 0.4i +.B \-i interval +The time in ms to sleep between defragmenting two segments in the file. This is used to balance defragmenting and file IOs. The default value is 0. + +.TP +.B \-e nr_ext +Specifies the number of extents in segment, only the segments with more extents than +.B nr_ext +are defragmenting targets. Properly setting this value bigger can defragment the most fragmented parts of the file in shorter time. The default value is 1. +.PD +.RE + .TP .BI "freesp [ \-dgrs ] [-a agno]... [ \-b | \-e bsize | \-h bsize | \-m factor ]" With no arguments, -- 2.39.3 (Apple Git-145)