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 dump-super* command.
  25
  26 Then run the check (in the non-repair mode) using the command *btrfs check -s*
  27 where '-s' specifies the superblock copy to use.
  28
  29 Superblock copies exist in the following offsets on the device:
  30
  31 - primary: '64KiB' (65536)
  32 - 1st copy: '64MiB' (67108864)
  33 - 2nd copy: '256GiB' (274877906944)
  34
  35 A superblock size is '4KiB' (4096).
  36
  37 OPTIONS
  38 -------
  39 -s|--super <superblock>::
  40 use 'superblock'th superblock copy, valid values are 0 1 or 2 if the
  41 respective superblock offset is within the device size
  42
  43 SEE ALSO
  44 --------
  45 `btrfs-inspect-internal`(8),
  46 `btrfsck check`(8)