mirror of
https://github.com/kdave/btrfs-progs
synced 2024-12-11 17:06:32 +00:00
btrfs-progs: docs: add DEV_ITEM object item description
Added DEV_ITEM object id to the reserved object id list. It's historical reason to let both of DEV_ITEM and ROOT_TREE have same object id. Developers should be aware of it. Signed-off-by: HAN Yuwei <hrx@bupt.moe> [ Replace immediate number with key names ] Signed-off-by: Qu Wenruo <wqu@suse.com>
This commit is contained in:
parent
3ad5a16450
commit
0ccaa82066
@ -29,6 +29,12 @@ specifically it contains "chunk items" for all system chunks. The superblock
|
||||
also contains a logical reference to root nodes in the root and chunk trees,
|
||||
which can then be used to locate all the other trees and data stored.
|
||||
|
||||
To avoid duplicated suffixes/prefixes, sometimes the macro name will have
|
||||
the "BTRFS_" prefix and "_OBJECTID" suffix removed.
|
||||
|
||||
E.g. "BTRFS_DEV_ITEMS_OBJECTID" (0x1) can be shown as "DEV_ITEMS" for short,
|
||||
this matches the output of "btrfs inspect-internal dump-tree".
|
||||
|
||||
TODO Subvolumes and snapshots.
|
||||
|
||||
|
||||
@ -268,6 +274,12 @@ Otherwise, the objectid should be considered reserved for internal use.
|
||||
|
||||
The object id that refers to the ``ROOT_TREE`` itself.
|
||||
|
||||
- BTRFS_DEV_ITEMS_OBJECTID = 1
|
||||
|
||||
The object id that refers to the :ref:`DEV_ITEM<DEV_ITEM_CONTENT>`.
|
||||
|
||||
duplicate with BTRFS_ROOT_TREE_OBJECTID for historical reason.
|
||||
|
||||
- BTRFS_EXTENT_TREE_OBJECTID = 2
|
||||
|
||||
The objectid that refers to the ``EXTENT_TREE``
|
||||
@ -1045,11 +1057,12 @@ Off Size Type Description
|
||||
0x30
|
||||
===== ==== ===== =======================
|
||||
|
||||
.. _DEV_ITEM_CONTENT:
|
||||
|
||||
DEV_ITEM (d8)
|
||||
^^^^^^^^^^^^^
|
||||
DEV_ITEM (0xd8)
|
||||
^^^^^^^^^^^^^^^
|
||||
|
||||
(1, device id) TODO
|
||||
Key format: (DEV_ITEMS DEV_ITEM <device id>)
|
||||
|
||||
Contains information about one device.
|
||||
|
||||
|
Loading…
Reference in New Issue
Block a user