From 3c5254b18710cf99d8b7d00250483d2ecb292271 Mon Sep 17 00:00:00 2001 From: Zygo Blaxell Date: Tue, 26 Nov 2019 22:55:09 -0500 Subject: [PATCH] btrfs-progs: inspect-internal: document new logical-resolve options and kernel requirements Document the new options requiring the V2 ioctl and the increased default buffer size. Signed-off-by: Zygo Blaxell Reviewed-by: Anand Jain Signed-off-by: David Sterba --- Documentation/btrfs-inspect-internal.asciidoc | 11 +++++++++-- 1 file changed, 9 insertions(+), 2 deletions(-) diff --git a/Documentation/btrfs-inspect-internal.asciidoc b/Documentation/btrfs-inspect-internal.asciidoc index 2abf044a..1f93b80e 100644 --- a/Documentation/btrfs-inspect-internal.asciidoc +++ b/Documentation/btrfs-inspect-internal.asciidoc @@ -125,7 +125,7 @@ at 'path', ie. all hardlinks -v:::: verbose mode, print count of returned paths and ioctl() return value -*logical-resolve* [-Pv] [-s ] :: +*logical-resolve* [-Pvo] [-s ] :: (needs root privileges) + resolve paths to all files at given 'logical' address in the linear filesystem space @@ -136,8 +136,15 @@ resolve paths to all files at given 'logical' address in the linear filesystem s skip the path resolving and print the inodes instead -v:::: verbose mode, print count of returned paths and all ioctl() return values +-o:::: +ignore offsets, find all references to an extent instead of a single block. +Requires kernel support for the V2 ioctl (added in 4.15). The results might need +further processing to filter out unwanted extents by the offset that is supposed +to be obtained by other means. -s :::: -set internal buffer for storing the file names to 'bufsize', default is 4096, maximum 64k +set internal buffer for storing the file names to 'bufsize', default is 64k, +maximum 16m. Buffer sizes over 64K require kernel support for the V2 ioctl +(added in 4.15). *min-dev-size* [options] :: (needs root privileges)