Manpage/btrfs-inspect-internal
From btrfs Wiki
(Difference between revisions)
(Update from git, v4.2) |
(Update from git, v4.3) |
||
Line 5: | Line 5: | ||
==NAME== | ==NAME== | ||
− | btrfs-inspect-internal - | + | btrfs-inspect-internal - query various internal information |
==SYNOPSIS== | ==SYNOPSIS== | ||
Line 13: | Line 13: | ||
==DESCRIPTION== | ==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== | ==SUBCOMMAND== | ||
− | ; '''inode-resolve''' [-v] < | + | ; '''inode-resolve''' [-v] <ino> <path> |
− | : | + | : (needs root privileges) <br /> resolve paths to all files with given inode number '''ino''' in a given subvolume at '''path''', ie. all hardlinks <br /><code>Options</code><br /> |
:; -v | :; -v | ||
− | :: verbose mode | + | :: verbose mode, print count of returned paths and ioctl() return value |
; '''logical-resolve''' [-Pv] [-s <bufsize>] <logical> <path> | ; '''logical-resolve''' [-Pv] [-s <bufsize>] <logical> <path> | ||
− | : | + | : (needs root privileges) <br /> resolve paths to all files at given '''logical''' address in the linear filesystem space <br /><code>Options</code><br /> |
:; -P | :; -P | ||
:: skip the path resolving and print the inodes instead | :: skip the path resolving and print the inodes instead | ||
:; -v | :; -v | ||
− | :: verbose mode | + | :: verbose mode, print count of returned paths and all ioctl() return values |
:; -s <bufsize> | :; -s <bufsize> | ||
− | :: set | + | :: set internal buffer for storing the file names to '''bufsize''', default is 4096, maximum 64k |
; '''min-dev-size''' [options] <path> | ; '''min-dev-size''' [options] <path> | ||
− | : | + | : (needs root privileges) <br /> 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 <br /><code>Options</code><br /> |
− | :; --id | + | :; --id <id> |
− | :: specify the device id to query, default is 1 | + | :: specify the device '''id''' to query, default is 1 if this option is not used |
; '''rootid''' <path> | ; '''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) <br />'''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> | ; '''subvolid-resolve''' <subvolid> <path> | ||
− | : | + | : (needs root privileges) <br /> resolve the absolute path of a the subvolume id '''subvolid''' |
==EXIT STATUS== | ==EXIT STATUS== |
Revision as of 16:09, 7 November 2015
Contents |
btrfs-inspect-internal(8) Manual Page
Note: manual pages are located at
read-the-docs site, please update your links.
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 hardlinksOptions
- -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 spaceOptions
- -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 operationOptions
- --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.