]> git.baikalelectronics.ru Git - kernel.git/commit
btrfs: relocation: Add introduction of how relocation works
authorQu Wenruo <wqu@suse.com>
Thu, 16 Jan 2020 05:04:07 +0000 (13:04 +0800)
committerDavid Sterba <dsterba@suse.com>
Mon, 23 Mar 2020 16:01:23 +0000 (17:01 +0100)
commitd9d610cbdda296e8f88bb9c01f3fcafd2097f9fb
treee07c800cd37ca090877312a8c0253cbf7ca3cb6a
parent3a2a588c9a933c65a69f70332b522f26bfb762b3
btrfs: relocation: Add introduction of how relocation works

Relocation is one of the most complex part of btrfs, while it's also the
foundation stone for online resizing, profile converting.

For such a complex facility, we should at least have some introduction
to it.

This patch will add an basic introduction at pretty a high level,
explaining:

- What relocation does
- How relocation is done
  Only mentioning how data reloc tree and reloc tree are involved in the
  operation.
  No details like the backref cache, or the data reloc tree contents.
- Which function to refer.

More detailed comments will be added for reloc tree creation, data reloc
tree creation and backref cache.

Signed-off-by: Qu Wenruo <wqu@suse.com>
Reviewed-by: David Sterba <dsterba@suse.com>
Signed-off-by: David Sterba <dsterba@suse.com>
fs/btrfs/relocation.c