Debian Codegraph @

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

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