Documentation/btrfs-select-super.asciidoc

   1 btrfs-select-super(8)
   2 =====================
   3
   4 NAME
   5 ----
   6 btrfs-select-super - overwrite primary superblock with a backup copy
   7
   8 SYNOPSIS
   9 --------
  10 *btrfs-select-super* -s number <device>
  11
  12 DESCRIPTION
  13 -----------
  14 Destructively overwrite all copies of the superblock
  15 with a specified copy.  This helps in certain cases, for example when write
  16 barriers were disabled during a power failure and not all superblocks were
  17 written, or if the primary superblock is damaged, eg. accidentally overwritten.
  18
  19 The filesystem specified by 'device' must not be mounted.
  20
  21 NOTE: *Prior to overwriting the primary superblock, please make sure that the backup
  22 copies are valid!*
  23
  24 To dump a superblock use the *btrfs inspect-internal
  25 dump-super* command, or the obsolete command *btrfs-show-super*.
  26
  27 Then run the check (in the non-repair mode) using the command *btrfs check -s*
  28 where '-s' specifies the superblock copy to use.
  29
  30 Superblock copies exist in the following offsets on the device:
  31
  32 - primary: '64KiB' (65536)
  33 - 1st copy: '64MiB' (67108864)
  34 - 2nd copy: '256GiB' (274877906944)
  35
  36 A superblock size is '4KiB' (4096).
  37
  38 OPTIONS
  39 -------
  40 -s|--super <superblock>::
  41 use 'superblock'th superblock copy, valid values are 0 1 or 2 if the
  42 respective superblock offset is within the device size
  43
  44 SEE ALSO
  45 --------
  46 `btrfs-inspect-internal`(8),
  47 `btrfsck check`(8)