summaryrefslogtreecommitdiff
path: root/Documentation/btrfs-select-super.asciidoc
diff options
context:
space:
mode:
authorDimitri John Ledkov <xnox@ubuntu.com>2016-07-26 13:24:39 +0100
committerDimitri John Ledkov <xnox@ubuntu.com>2016-07-26 13:24:39 +0100
commit3d69435ee3292b4b1db2d61c4784789d75883821 (patch)
tree2c0edc9d9501374799875af36259089feb99d48c /Documentation/btrfs-select-super.asciidoc
Imported Upstream version 4.6.1
Diffstat (limited to 'Documentation/btrfs-select-super.asciidoc')
-rw-r--r--Documentation/btrfs-select-super.asciidoc47
1 files changed, 47 insertions, 0 deletions
diff --git a/Documentation/btrfs-select-super.asciidoc b/Documentation/btrfs-select-super.asciidoc
new file mode 100644
index 00000000..6e94a034
--- /dev/null
+++ b/Documentation/btrfs-select-super.asciidoc
@@ -0,0 +1,47 @@
+btrfs-select-super(8)
+=====================
+
+NAME
+----
+btrfs-select-super - overwrite primary superblock with a backup copy
+
+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, or the obsolete command *btrfs-show-super*.
+
+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 <superblock>::
+use 'superblock'th superblock copy, valid values are 0 1 or 2 if the
+respective superblock offset is within the device size
+
+SEE ALSO
+--------
+`btrfs-inspect-internal`(8),
+`btrfsck check`(8)