forked from Mirrors/btrfs-progs
85 lines
2.2 KiB
Plaintext
85 lines
2.2 KiB
Plaintext
btrfs-inspect-internal(8)
|
|
=========================
|
|
|
|
NAME
|
|
----
|
|
btrfs-inspect-internal - query various internal information
|
|
|
|
SYNOPSIS
|
|
--------
|
|
*btrfs inspect-internal* <subcommand> <args>
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
|
|
This command group provides an interface to query internal information. The
|
|
functionality ranges from a simple UI to an ioctl or a more complex query that
|
|
assembles the result from several internal structures. The latter usually
|
|
requires calls to privileged ioctls.
|
|
|
|
SUBCOMMAND
|
|
----------
|
|
*inode-resolve* [-v] <ino> <path>::
|
|
(needs root privileges)
|
|
+
|
|
resolve paths to all files with given inode number 'ino' in a given subvolume
|
|
at 'path', ie. all hardlinks
|
|
+
|
|
`Options`
|
|
+
|
|
-v::::
|
|
verbose mode, print count of returned paths and ioctl() return value
|
|
|
|
*logical-resolve* [-Pv] [-s <bufsize>] <logical> <path>::
|
|
(needs root privileges)
|
|
+
|
|
resolve paths to all files at given 'logical' address in the linear filesystem space
|
|
+
|
|
`Options`
|
|
+
|
|
-P::::
|
|
skip the path resolving and print the inodes instead
|
|
-v::::
|
|
verbose mode, print count of returned paths and all ioctl() return values
|
|
-s <bufsize>::::
|
|
set internal buffer for storing the file names to 'bufsize', default is 4096, maximum 64k
|
|
|
|
*min-dev-size* [options] <path>::
|
|
(needs root privileges)
|
|
+
|
|
return the minimum size the device can be shrunk to, without performing any
|
|
resize operation, this may be useful before executing the actual resize operation
|
|
+
|
|
`Options`
|
|
+
|
|
--id <id>::::
|
|
specify the device 'id' to query, default is 1 if this option is not used
|
|
|
|
*rootid* <path>::
|
|
for a given file or directory, return the containing tree root id, for a
|
|
subvolume itself return it's own tree id (ie. subvol id)
|
|
+
|
|
NOTE: The result is undefined for the so-called empty subvolumes (identified by
|
|
inode number 2), but such subvolume does not contain any files anyway
|
|
|
|
*subvolid-resolve* <subvolid> <path>::
|
|
(needs root privileges)
|
|
+
|
|
resolve the absolute path of a the subvolume id 'subvolid'
|
|
|
|
EXIT STATUS
|
|
-----------
|
|
*btrfs inspect-internal* returns a zero exit status if it succeeds. Non zero is
|
|
returned in case of failure.
|
|
|
|
AVAILABILITY
|
|
------------
|
|
*btrfs* is part of btrfs-progs.
|
|
Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for
|
|
further details.
|
|
|
|
SEE ALSO
|
|
--------
|
|
`mkfs.btrfs`(8),
|
|
`btrfs-debug-tree`(8)
|