From a3dbd5c455992baf6bfc196b9059a2b485823b83 Mon Sep 17 00:00:00 2001 From: Tao Liu Date: Tue, 10 Jan 2023 14:56:31 +0800 Subject: [PATCH 69/89] Update the help text of "tree" command for maple tree Signed-off-by: Tao Liu Signed-off-by: Lianbo Jiang --- help.c | 86 +++++++++++++++++++++++++++++++++++++++++++--------------- 1 file changed, 64 insertions(+), 22 deletions(-) diff --git a/help.c b/help.c index bfba43f6e9fd..7ceefa06732b 100644 --- a/help.c +++ b/help.c @@ -6313,19 +6313,20 @@ NULL char *help_tree[] = { "tree", -"display radix tree, XArray or red-black tree", -"[-t [radix|xarray|rbtree]] [-r offset] [-[s|S] struct[.member[,member]]]\n -[x|d] [-o offset] [-l] [-p] [-N] start", -" This command dumps the contents of a radix tree, an XAarray, or a red-black", -" tree. The arguments are as follows:\n", +"display radix tree, XArray, red-black tree or maple tree", +"[-t [radix|xarray|rbtree|maple]] [-r offset] [-[s|S] struct[.member[,member]]]\n" +" -[x|d] [-o offset] [-l] [-p] [-v] [-N] start", +" This command dumps the contents of a radix tree, an XAarray, a red-black", +" tree, or a maple tree. The arguments are as follows:\n", " -t type The type of tree to dump; the type string can be one of ", -" \"radix\", \"rbtree\", or \"xarray\", or alternatively, \"ra\",", -" \"rb\" or \"x\" are acceptable. If not specified, rbtree is the", -" default type.", +" \"radix\", \"rbtree\", \"xarray\", or \"maple\", or alternatively,", +" \"ra\", \"rb\", \"x\" or \"m\" are acceptable. If not specified,", +" rbtree is the default type.", " -r offset If the \"start\" argument is the address of a data structure that", -" contains an radix_tree_root, xarray or rb_root structure, then this", -" is the offset to that structure member. If the offset is non-zero,", -" then this option is required. The offset may be entered in either", -" of two manners:", +" contains an radix_tree_root, maple_tree, xarray or rb_root", +" structure, then this is the offset to that structure member. If", +" the offset is non-zero, then this option is required. The offset", +" may be entered in either of two manners:", " 1. In \"structure.member\" format.", " 2. A number of bytes.", " -o offset For red-black trees only, the offset of the rb_node within its ", @@ -6354,25 +6355,26 @@ char *help_tree[] = { " -p Display the node's position information, showing the relationship", " between it and the root. For red-black trees, a position that", " indicates \"root/l/r\" means that the node is the right child", -" of the left child of the root node. For radix trees and xarrays,", -" the index, the height, and the slot index values are shown with", -" respect to the root.", +" of the left child of the root node. For radix trees, xarrays and", +" maple trees, the index, the height, and the slot index values are", +" shown with respect to the root.", " -x Override default output format with hexadecimal format.", " -d Override default output format with decimal format.", +" -v For maple trees only, dump the contents of each maple tree node.", " ", " The meaning of the \"start\" argument, which can be expressed either in", " hexadecimal format or symbolically, depends upon whether the -N option", " is prepended:", " ", -" start The address of a radix_tree_root, xarray or rb_root structure, or", -" the address of a structure containing the radix_tree_root, xarray", -" or rb_root structure; if the latter, then the \"-r offset\" option", -" must be used if the member offset of the root structure is ", -" non-zero.", +" start The address of a radix_tree_root, maple_tree, xarray or rb_root", +" structure, or the address of a structure containing the", +" radix_tree_root, maple_tree, xarray or rb_root structure; if the", +" latter, then the \"-r offset\" option must be used if the member", +" offset of the root structure is non-zero.", " ", -" -N start The address of a radix_tree_node, xa_node or rb_node structure,", -" bypassing the radix_tree_root, xarray, or rb_root that points", -" to it.", +" -N start The address of a radix_tree_node, maple_node, xa_node or rb_node", +" structure, bypassing the radix_tree_root, maple_tree, xarray, or", +" rb_root that points to it.", "", "\nEXAMPLES", " The vmap_area_root is a standalone rb_root structure. Display the ", @@ -6709,6 +6711,46 @@ char *help_tree[] = { " _refcount = {", " counter = 0x1", " }", +"", +" The -v option is introduced specifically for dumping the complete content of", +" maple tree:", +"", +" %s> tree -t maple 0xffff9034c006aec0 -v", +"", +" maple_tree(ffff9034c006aec0) flags 309, height 2 root 0xffff9034de70041e", +"", +" 0-18446744073709551615: node 0xffff9034de700400 depth 0 type 3 parent ...", +" 0-140112331583487: node 0xffff9034c01e8800 depth 1 type 1 parent ...", +" 0-94643156942847: 0x0", +" 94643156942848-94643158024191: 0xffff9035131754c0", +" 94643158024192-94643160117247: 0x0", +" ...", +"", +" The existing options can work as well for maple tree:", +"", +" %s> tree -t maple -r mm_struct.mm_mt 0xffff9034c006aec0 -p", +" ffff9035131754c0", +" index: 1 position: root/0/1", +" ffff9035131751c8", +" index: 2 position: root/0/3", +" ffff9035131757b8", +" index: 3 position: root/0/4", +" ...", +"", +" %s> tree -t maple 0xffff9034c006aec0 -p -x -s vm_area_struct.vm_start,vm_end", +" ffff9035131754c0", +" index: 1 position: root/0/1", +" vm_start = 0x5613d3c00000,", +" vm_end = 0x5613d3d08000,", +" ffff9035131751c8", +" index: 2 position: root/0/3", +" vm_start = 0x5613d3f07000,", +" vm_end = 0x5613d3f0b000,", +" ffff9035131757b8", +" index: 3 position: root/0/4", +" vm_start = 0x5613d3f0b000,", +" vm_end = 0x5613d3f14000,", +" ....", NULL }; -- 2.37.1