RepoMirrors/btrfs-progs
1
0
Fork 0
mirror of https://github.com/kdave/btrfs-progs synced 2024-12-24 07:02:45 +00:00
Code Issues Packages Projects Releases Wiki Activity

btrfs-progs: docs: update btrfs-balance

Browse Source 
Copy unexpected edits from wiki so they do not get lost at next
git->wiki sync.

Author: Bill S.
Signed-off-by: David Sterba <dsterba@suse.com>
This commit is contained in:
David Sterba 2017-09-29 22:29:38 +02:00
parent aa0cc10a4e
commit f96546d01c
1 changed files with 9 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
Documentation/btrfs-balance.asciidoc
View File

@ -45,29 +45,27 @@ COMPATIBILITY
NOTE: The balance subcommand also exists under the *btrfs filesystem* NOTE: The balance subcommand also exists under the *btrfs filesystem*
namespace. This still works for backward compatibility but is deprecated and namespace. This still works for backward compatibility but is deprecated and
should not be used anymore. should not be used any more.
NOTE: A short syntax *btrfs balance <path>* works due to backward compatibility NOTE: A short syntax *btrfs balance <path>* works due to backward compatibility
but is deprecated and should not be used anymore. Use *btrfs balance start* but is deprecated and should not be used any more. Use *btrfs balance start*
command instead. command instead.
PERFORMANCE IMPLICATIONS PERFORMANCE IMPLICATIONS
------------------------ ------------------------
Balance operation is intense namely in the IO respect, but can be also CPU Balancing operations are very IO intensive and can also be quite CPU intensive,
intense. It affects other actions on the filesystem. There are typically lots impacting other ongoing filesystem operations. Typically large amounts of data
of data being copied from one location to another, and lots of metadata get are copied from one location to another, with corresponding metadata updates.
updated.
Depending on the actual block group layout, it can be also seek-heavy. The Depending upon the block group layout, it can also be seek heavy. Performance
performance on rotational devices is noticeably worse than on SSDs or fast on rotational devices is noticeably worse compared to SSDs or fast arrays.
arrays.
SUBCOMMAND SUBCOMMAND
---------- ----------
*cancel* <path>:: *cancel* <path>::
cancel running or paused balance, the command will block and wait until the cancels a running or paused balance, the command will block and wait until the
actually processed blockgroup is finished current blockgroup being processed completes
*pause* <path>:: *pause* <path>::
pause running balance operation, this will store the state of the balance pause running balance operation, this will store the state of the balance