8866c94081bd1ebfcd8364c3899d4bb9be7d624c
[platform/upstream/btrfs-progs.git] / Documentation / btrfs-show-super.asciidoc
1 btrfs-show-super(8)
2 ====================
3
4 NAME
5 ----
6 btrfs-show-super - show btrfs superblock information stored in devices
7
8 SYNOPSIS
9 --------
10 *btrfs-show-super* [options] <dev> [<dev>...]
11
12 DESCRIPTION
13 -----------
14 *btrfs-show-super* is used to print the information of superblock,
15 you can specify which mirror to print out.
16
17 By default, every device's first superblock will be printed out.
18
19 Mainly used for debug purpose.
20
21 OPTIONS
22 -------
23 -f::
24 Print full superblock information.
25 +
26 Including the system chunk array and backup roots.
27
28 -a::
29 Print information of all superblocks.
30 +
31 If this option is given, '-i' option will be ignored.
32
33 -i <super_mirror>::
34 Specify which mirror to print out.
35 +
36 <super_mirror> is between 0 and 2.
37 If several '-i <super_mirror>' are given, only the last one is valid.
38
39 -F::
40 Attempt to print the superblock even if no superblock magic is found.  May end
41 badly.
42
43 -s <bytenr>::
44 specifiy offset to a superblock in a non-standard location at 'bytenr', useful
45 for debugging (disables the '-f' option)
46
47 EXIT STATUS
48 -----------
49 *btrfs-show-super* will return 0 if no error happened.
50 If any problems happened, 1 will be returned.
51
52 SEE ALSO
53 --------
54 `mkfs.btrfs`(8)