diff options
author | Hubert Kario <kario@wit.edu.pl> | 2011-01-23 15:31:07 +0000 |
---|---|---|
committer | Chris Mason <chris.mason@oracle.com> | 2011-10-25 09:18:31 -0400 |
commit | 0646719841433c015d849c197cd13be6f2cb31a3 (patch) | |
tree | 94b1fc7a75a88095ce2058e4ebdf69492467ffeb /man/btrfs.8.in | |
parent | eb5418933f9729db0b7dbcf8eb0f40a4be01f273 (diff) |
update man page to new defragment command interface
Update
btrfs filesystem defragment
command explanation. Add explanation of advanced parameters and notes
about general usage.
Add few notes about the
btrfs <command> --help
usage, fix related grammar.
Signed-off-by: Hubert Kario <kario@wit.edu.pl>
Signed-off-by: Chris Mason <chris.mason@oracle.com>
Diffstat (limited to 'man/btrfs.8.in')
-rw-r--r-- | man/btrfs.8.in | 33 |
1 files changed, 26 insertions, 7 deletions
diff --git a/man/btrfs.8.in b/man/btrfs.8.in index 26ef9821..cba2de1f 100644 --- a/man/btrfs.8.in +++ b/man/btrfs.8.in @@ -15,7 +15,7 @@ btrfs \- control a btrfs filesystem .PP \fBbtrfs\fP \fBsubvolume set-default\fP\fI <id> <path>\fP .PP -\fBbtrfs\fP \fBfilesystem defrag\fP\fI <file>|<dir> [<file>|<dir>...]\fP +\fBbtrfs\fP \fBfilesystem defragment\fP\fI [-vcf] [-s start] [-l len] [-t size] <file>|<dir> [<file>|<dir>...]\fP .PP \fBbtrfs\fP \fBfilesystem sync\fP\fI <path> \fP .PP @@ -34,6 +34,8 @@ btrfs \- control a btrfs filesystem .PP \fBbtrfs\fP \fBhelp|\-\-help|\-h \fP\fI\fP .PP +\fBbtrfs\fP \fB<command> \-\-help \fP\fI\fP +.PP .SH DESCRIPTION .B btrfs is used to control the filesystem and the files and directories stored. It is @@ -60,12 +62,12 @@ returns an error. If a command is terminated by .I --help -, the relevant help is showed. If the passed command matches more commands, -the help of all the matched commands are showed. For example +, the detailed help is showed. If the passed command matches more commands, +detailed help of all the matched commands is showed. For example .I btrfs dev --help shows the help of all .I device* -command. +commands. .SH COMMANDS .TP @@ -98,12 +100,29 @@ mount time via the \fIsubvol=\fR option. \fBsubvolume set-default\fR\fI <id> <path>\fR Set the subvolume of the filesystem \fI<path>\fR which is mounted as -\fIdefault\fR. The subvolume is identified by \fB<id>\fR, which +\fIdefault\fR. The subvolume is identified by \fI<id>\fR, which is returned by the \fBsubvolume list\fR command. .TP -\fBfilesystem defragment\fP\fI <file>|<dir> [<file>|<dir>...]\fR -Defragment files and/or directories. +\fBfilesystem defragment\fP\fI [-vcf] [-s start] [-l len] [-t size] <file>|<dir> [<file>|<dir>...]\fR +Defragment file data and/or directory metadata. To defragment all files in a +directory you have to specify each one on its own or use your shell wildcards. + +\fB-v\fP be verbose + +\fB-c\fP compress file contents while defragmenting + +\fB-f\fP flush filesystem after defragmenting + +\fB-s start\fP defragment only from byte \fIstart\fR onward + +\fB-l len\fP defragment only up to \fIlen\fR bytes + +\fB-t size\fP defragment only files at least \fIsize\fR bytes big + +NOTE: defragmenting with kernels up to 2.6.37 will unlink COW-ed copies of data, don't +use it if you use snapshots, have de-duplicated your data or made copies with +\fBcp --reflink\fP. .TP \fBdevice scan\fR \fI[<device> [<device>..]]\fR |