RepoMirrors
/
btrfs-progs
mirror of https://github.com/kdave/btrfs-progs
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
btrfs-progs/Documentation/btrfs-select-super.rst

47 lines
1.2 KiB
ReStructuredText
Raw Normal View History

btrfs-progs: docs: add sample RSTified manual page The asciidoc format needs to be tweaked but otherwise is basically the same. Changes: - bold text is ** ** - italics is * * - NOTE is directive .. note - definition list is simple indented block after the term - section NAME in the manual page is generated from date in conf.py:man_pages - new page has to be added to the index To do: - references to other manual pages, will be RST native linking once all the pages are converted The output is in Documentation/_build/man and the format is visually not much different from what is generated by asciidoc. Signed-off-by: David Sterba <dsterba@suse.com>
2021-10-26 21:06:50 +00:00
btrfs-select-super(8)
=====================
SYNOPSIS
--------
**btrfs-select-super** -s number <device>
DESCRIPTION
-----------
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
btrfs-progs: docs: fix typos Namely change eg. to e.g. and ie. to i.e. Signed-off-by: David Sterba <dsterba@suse.com>
2022-12-07 20:00:25 +00:00
superblock is damaged, e.g. accidentally overwritten.
btrfs-progs: docs: add sample RSTified manual page The asciidoc format needs to be tweaked but otherwise is basically the same. Changes: - bold text is ** ** - italics is * * - NOTE is directive .. note - definition list is simple indented block after the term - section NAME in the manual page is generated from date in conf.py:man_pages - new page has to be added to the index To do: - references to other manual pages, will be RST native linking once all the pages are converted The output is in Documentation/_build/man and the format is visually not much different from what is generated by asciidoc. Signed-off-by: David Sterba <dsterba@suse.com>
2021-10-26 21:06:50 +00:00
The filesystem specified by *device* must not be mounted.
.. note::
Prior to overwriting the primary superblock, please make sure that the
backup copies are valid!
btrfs-progs: docs: use command role for programs or command lines Replace **bold** or ``quoted`` with :command:`line ...` that is supposed to be used verbatim. Signed-off-by: David Sterba <dsterba@suse.com>
2023-04-26 23:48:47 +00:00
To dump a superblock use the :command:`btrfs inspect-internal dump-super` command.
btrfs-progs: docs: add sample RSTified manual page The asciidoc format needs to be tweaked but otherwise is basically the same. Changes: - bold text is ** ** - italics is * * - NOTE is directive .. note - definition list is simple indented block after the term - section NAME in the manual page is generated from date in conf.py:man_pages - new page has to be added to the index To do: - references to other manual pages, will be RST native linking once all the pages are converted The output is in Documentation/_build/man and the format is visually not much different from what is generated by asciidoc. Signed-off-by: David Sterba <dsterba@suse.com>
2021-10-26 21:06:50 +00:00
btrfs-progs: docs: use command role for programs or command lines Replace **bold** or ``quoted`` with :command:`line ...` that is supposed to be used verbatim. Signed-off-by: David Sterba <dsterba@suse.com>
2023-04-26 23:48:47 +00:00
Then run the check (in the non-repair mode) using the command :command:`btrfs check -s`
btrfs-progs: docs: add sample RSTified manual page The asciidoc format needs to be tweaked but otherwise is basically the same. Changes: - bold text is ** ** - italics is * * - NOTE is directive .. note - definition list is simple indented block after the term - section NAME in the manual page is generated from date in conf.py:man_pages - new page has to be added to the index To do: - references to other manual pages, will be RST native linking once all the pages are converted The output is in Documentation/_build/man and the format is visually not much different from what is generated by asciidoc. Signed-off-by: David Sterba <dsterba@suse.com>
2021-10-26 21:06:50 +00:00
where *-s* specifies the superblock copy to use.
Superblock copies exist in the following offsets on the device:
- primary: 64KiB (65536)
- 1st copy: 64MiB (67108864)
- 2nd copy: 256GiB (274877906944)
A superblock size is 4KiB (4096).
OPTIONS
-------
-s|--super <N>
use Nth superblock copy, valid values are 0 1 or 2 if the
respective superblock offset is within the device size
SEE ALSO
--------
btrfs-progs: docs: add cross reference for manualpages RST format provides cross reference function that users can navigate manual pages click. This patch is written by macro that replaces old references to doc role in RST format. Issue: #495 Signed-off-by: Sidong Yang <realwakka@gmail.com> Signed-off-by: David Sterba <dsterba@suse.com>
2022-08-08 07:28:56 +00:00
:doc:`btrfs(8)<btrfs>`