From dc66d32ddffa55b22af84ebe5c4918e064214a10 Mon Sep 17 00:00:00 2001
From: Bao <qubidt@gmail.com>
Date: Fri, 24 Dec 2021 17:07:54 -0600
Subject: [PATCH] btrfs-restore: add page (#7455)

---
 pages/linux/btrfs-restore.md | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)
 create mode 100644 pages/linux/btrfs-restore.md

diff --git a/pages/linux/btrfs-restore.md b/pages/linux/btrfs-restore.md
new file mode 100644
index 0000000000..add3a90d91
--- /dev/null
+++ b/pages/linux/btrfs-restore.md
@@ -0,0 +1,24 @@
+# btrfs restore
+
+> Try to salvage files from a damaged btrfs filesystem.
+> More information: <https://btrfs.wiki.kernel.org/index.php/Manpage/btrfs-restore>.
+
+- Restore all files from a btrfs filesystem to a given directory:
+
+`sudo btrfs restore {{path/to/btrfs_device}} {{path/to/target_directory}}`
+
+- List (don't write) files to be restored from a btrfs filesystem:
+
+`sudo btrfs restore --dry-run {{path/to/btrfs_device}} {{path/to/target_directory}}`
+
+- Restore files matching a given regex ([c]ase-insensitive) files to be restored from a btrfs filesystem (all parent directories of target file(s) must match as well):
+
+`sudo btrfs restore --path-regex {{regex}} -c {{path/to/btrfs_device}} {{path/to/target_directory}}`
+
+- Restore files from a btrfs filesystem using a specific root tree `bytenr` (see `btrfs-find-root`):
+
+`sudo btrfs restore -t {{bytenr}} {{path/to/btrfs_device}} {{path/to/target_directory}}`
+
+- Restore files from a btrfs filesystem (along with metadata, extended attributes, and Symlinks), overwriting files in the target:
+
+`sudo btrfs restore --metadata --xattr --symlinks --overwrite {{path/to/btrfs_device}} {{path/to/target_directory}}`