| 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. |