btrfs-progs/Documentation/btrfs-select-super.rst
Sidong Yang 2d039cc815 btrfs-progs: docs: add cross reference for manualpages
RST format provides cross reference function that users can navigate
manual pages click. This patch is written by macro that replaces old
references to doc role in RST format.

Issue: #495
Signed-off-by: Sidong Yang <realwakka@gmail.com>
Signed-off-by: David Sterba <dsterba@suse.com>
2022-10-11 09:08:08 +02:00

47 lines
1.2 KiB
ReStructuredText

btrfs-select-super(8)
=====================
SYNOPSIS
--------
**btrfs-select-super** -s number <device>
DESCRIPTION
-----------
Destructively overwrite all copies of the superblock with a specified copy.
This helps in certain cases, for example when write barriers were disabled
during a power failure and not all superblocks were written, or if the primary
superblock is damaged, eg. accidentally overwritten.
The filesystem specified by *device* must not be mounted.
.. note::
Prior to overwriting the primary superblock, please make sure that the
backup copies are valid!
To dump a superblock use the **btrfs inspect-internal dump-super** command.
Then run the check (in the non-repair mode) using the command **btrfs check -s**
where *-s* specifies the superblock copy to use.
Superblock copies exist in the following offsets on the device:
- primary: 64KiB (65536)
- 1st copy: 64MiB (67108864)
- 2nd copy: 256GiB (274877906944)
A superblock size is 4KiB (4096).
OPTIONS
-------
-s|--super <N>
use Nth superblock copy, valid values are 0 1 or 2 if the
respective superblock offset is within the device size
SEE ALSO
--------
:doc:`btrfs(8)<btrfs>`