diff options
Diffstat (limited to 'upstream/debian-unstable/man8/btrfs-select-super.8')
| -rw-r--r-- | upstream/debian-unstable/man8/btrfs-select-super.8 | 80 |
1 files changed, 80 insertions, 0 deletions
diff --git a/upstream/debian-unstable/man8/btrfs-select-super.8 b/upstream/debian-unstable/man8/btrfs-select-super.8 new file mode 100644 index 00000000..81adca29 --- /dev/null +++ b/upstream/debian-unstable/man8/btrfs-select-super.8 @@ -0,0 +1,80 @@ +.\" Man page generated from reStructuredText. +. +. +.nr rst2man-indent-level 0 +. +.de1 rstReportMargin +\\$1 \\n[an-margin] +level \\n[rst2man-indent-level] +level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] +- +\\n[rst2man-indent0] +\\n[rst2man-indent1] +\\n[rst2man-indent2] +.. +.de1 INDENT +.\" .rstReportMargin pre: +. RS \\$1 +. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] +. nr rst2man-indent-level +1 +.\" .rstReportMargin post: +.. +.de UNINDENT +. RE +.\" indent \\n[an-margin] +.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] +.nr rst2man-indent-level -1 +.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] +.in \\n[rst2man-indent\\n[rst2man-indent-level]]u +.. +.TH "BTRFS-SELECT-SUPER" "8" "Feb 28, 2024" "6.6.3" "BTRFS" +.SH NAME +btrfs-select-super \- overwrite primary superblock with a backup copy +.SH SYNOPSIS +.sp +\fBbtrfs\-select\-super\fP \-s number <device> +.SH DESCRIPTION +.sp +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, e.g. accidentally overwritten. +.sp +The filesystem specified by \fIdevice\fP must not be mounted. +.sp +\fBNOTE:\fP +.INDENT 0.0 +.INDENT 3.5 +Prior to overwriting the primary superblock, please make sure that the +backup copies are valid! +.UNINDENT +.UNINDENT +.sp +To dump a superblock use the \fBbtrfs inspect\-internal dump\-super\fP command. +.sp +Then run the check (in the non\-repair mode) using the command \fBbtrfs check \-s\fP +where \fI\-s\fP specifies the superblock copy to use. +.sp +Superblock copies exist in the following offsets on the device: +.INDENT 0.0 +.IP \(bu 2 +primary: 64KiB (65536) +.IP \(bu 2 +1st copy: 64MiB (67108864) +.IP \(bu 2 +2nd copy: 256GiB (274877906944) +.UNINDENT +.sp +A superblock size is 4KiB (4096). +.SH OPTIONS +.INDENT 0.0 +.TP +.B \-s|\-\-super <N> +use Nth superblock copy, valid values are 0 1 or 2 if the +respective superblock offset is within the device size +.UNINDENT +.SH SEE ALSO +.sp +\fI\%btrfs(8)\fP +.\" Generated by docutils manpage writer. +. |