aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation
diff options
context:
space:
mode:
authorQu Wenruo <wqu@suse.com>2023-10-09 15:17:00 +1030
committerDavid Sterba <dsterba@suse.com>2023-10-13 18:13:12 +0200
commit42404a4e448c2eb8b9fd1ab9863a11e9c4d90571 (patch)
treee4d4e90803565f879fc46fe428f7edd7b73351b2 /Documentation
parent146cca7e164e3b54d063d60dd7e14f7acb842f05 (diff)
downloadbtrfs-progs-42404a4e448c2eb8b9fd1ab9863a11e9c4d90571.tar.gz
btrfs-progs: move inode cache removal to rescue group
The option "--clear-ino-cache" is not really that suitable for "btrfs check" group. Let's move it to "btrfs rescue" group to fix those small hiccups, just like the existing "btrfs rescue fix-device-size" command. For now, "btrfs check --clear-ino-cache" would still work, with one extra warning referring to "btrfs rescue clear-ino-cache". This is mostly to reduce the surprise, and keep script users (I doubt if there is any though) happy for now. In the next or two releases, we would fully remove the support in "btrfs check" group. Another small change is, in the documents, we refer to the feature as "inode map", which doesn't match with the mount option documents. Since we're here, unify them to "inode cache" feature. Issue: #669 Signed-off-by: Qu Wenruo <wqu@suse.com> Signed-off-by: David Sterba <dsterba@suse.com>
Diffstat (limited to 'Documentation')
-rw-r--r--Documentation/btrfs-check.rst5
-rw-r--r--Documentation/btrfs-rescue.rst6
2 files changed, 10 insertions, 1 deletions
diff --git a/Documentation/btrfs-check.rst b/Documentation/btrfs-check.rst
index cf8de9fc..3c5f96f1 100644
--- a/Documentation/btrfs-check.rst
+++ b/Documentation/btrfs-check.rst
@@ -84,8 +84,11 @@ SAFE OR ADVISORY OPTIONS
See also the *clear_cache* mount option.
--clear-ino-cache
- remove leftover items pertaining to the deprecated inode map feature
+ remove leftover items pertaining to the deprecated `inode cache` feature
+ .. warning::
+ This option is deprecated, please use `btrfs rescue clear-ino-cache`
+ instead, this option would be removed in the future eventually.
DANGEROUS OPTIONS
-----------------
diff --git a/Documentation/btrfs-rescue.rst b/Documentation/btrfs-rescue.rst
index 39d250ce..3c58f1da 100644
--- a/Documentation/btrfs-rescue.rst
+++ b/Documentation/btrfs-rescue.rst
@@ -50,6 +50,12 @@ fix-device-size <device>
WARNING: CPU: 3 PID: 439 at fs/btrfs/ctree.h:1559 btrfs_update_device+0x1c5/0x1d0 [btrfs]
+clear-ino-cache <device>
+ Remove leftover items pertaining to the deprecated `inode cache` feature.
+
+ The `inode cache` feature (enabled by mount option "inode_cache") has been
+ completely removed in 5.11 kernel.
+
clear-uuid-tree <device>
Clear UUID tree, so that kernel can re-generate it at next read-write
mount.