From ce69f8c36eb4187df2e2207a2e4e30715978f1c7 Mon Sep 17 00:00:00 2001
From: David Sterba <dsterba@suse.com>
Date: Fri, 6 May 2016 13:28:17 +0200
Subject: btrfs-progs: docs: update btrfs-select-super

Signed-off-by: David Sterba <dsterba@suse.com>
---
 Documentation/btrfs-select-super.asciidoc | 36 +++++++++++++++++++++++--------
 1 file changed, 27 insertions(+), 9 deletions(-)

(limited to 'Documentation/btrfs-select-super.asciidoc')

diff --git a/Documentation/btrfs-select-super.asciidoc b/Documentation/btrfs-select-super.asciidoc
index a8d7ef00..6e94a034 100644
--- a/Documentation/btrfs-select-super.asciidoc
+++ b/Documentation/btrfs-select-super.asciidoc
@@ -3,27 +3,45 @@ btrfs-select-super(8)
 
 NAME
 ----
-btrfs-select-super - overwrite superblock with a backup
+btrfs-select-super - overwrite primary superblock with a backup copy
 
 SYNOPSIS
 --------
-*btrfs-select-super* -s number dev
+*btrfs-select-super* -s number <device>
 
 DESCRIPTION
 -----------
-*btrfs-select-super* destructively overwrites all copies of the superblock
-with a specified copy.  This helps with certain cases of damage, especially
-when barriers were disabled during a power failure.  You can find a valid
-copy of the superblock with *btrfs check -s*.
+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 `dev` must not be mounted.
+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 up to 2 if the
-respective superblock offset is within the filesystem
+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)
-- 
cgit v1.2.3

