Debian Codegraph @

upstream/debian-trixie/man8/btrfs-select-super.8

raw
1 .\" Man page generated from reStructuredText.
2 .
3 .
4 .nr rst2man-indent-level 0
5 .
6 .de1 rstReportMargin
7 \\$1 \\n[an-margin]
8 level \\n[rst2man-indent-level]
9 level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
10 -
11 \\n[rst2man-indent0]
12 \\n[rst2man-indent1]
13 \\n[rst2man-indent2]
14 ..
15 .de1 INDENT
16 .\" .rstReportMargin pre:
17 . RS \\$1
18 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
19 . nr rst2man-indent-level +1
20 .\" .rstReportMargin post:
21 ..
22 .de UNINDENT
23 . RE
24 .\" indent \\n[an-margin]
25 .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
26 .nr rst2man-indent-level -1
27 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
28 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
29 ..
30 .TH "BTRFS-SELECT-SUPER" "8" "May 18, 2026" "7.0" "BTRFS"
31 .SH NAME
32 btrfs-select-super \- overwrite primary superblock with a backup copy
33 .SH SYNOPSIS
34 .sp
35 \fBbtrfs\-select\-super\fP \-s number <device>
36 .SH DESCRIPTION
37 .sp
38 Destructively overwrite all copies of the superblock with a specified copy.
39 This helps in certain cases, for example when write barriers were disabled
40 during a power failure and not all superblocks were written, or if the primary
41 superblock is damaged, e.g. accidentally overwritten.
42 .sp
43 The filesystem specified by \fIdevice\fP must not be mounted.
44 .sp
45 \fBNOTE:\fP
46 .INDENT 0.0
47 .INDENT 3.5
48 Prior to overwriting the primary superblock, please make sure that the
49 backup copies are valid!
50 .UNINDENT
51 .UNINDENT
52 .sp
53 To dump a superblock use the \fBbtrfs inspect\-internal dump\-super\fP command.
54 .sp
55 Then run the check (in the non\-repair mode) using the command \fBbtrfs check \-s\fP
56 where \fI\-s\fP specifies the superblock copy to use.
57 .sp
58 Superblock copies exist in the following offsets on the device:
59 .INDENT 0.0
60 .IP \(bu 2
61 primary: 64KiB (65536)
62 .IP \(bu 2
63 1st copy: 64MiB (67108864)
64 .IP \(bu 2
65 2nd copy: 256GiB (274877906944)
66 .UNINDENT
67 .sp
68 A superblock size is 4KiB (4096).
69 .SH OPTIONS
70 .INDENT 0.0
71 .TP
72 .B \-s|\-\-super <N>
73 use Nth superblock copy, valid values are 0 1 or 2 if the
74 respective superblock offset is within the device size
75 .UNINDENT
76 .SH SEE ALSO
77 .sp
78 \fI\%btrfs(8)\fP
79 .\" Generated by docutils manpage writer.
80 .