描述
获取 DT 节点对象列表。
语法
get_dt_nodes [-hier] [-regexp] [-filter <arg>] [-of_objects <args>] [-quiet] [-verbose] [<patterns>...] 返回
节点对象。如果该命令失败，则不返回任何结果。
用法
| 名称 | 描述 |
|---|---|
[-hier] |
当前树中的节点列表。 |
[-regexp] |
模式为正则表达式 |
[-filter] |
使用表达式筛选列表 |
[-of_objects] |
获取下列类型的 '' 对象：“dtsNode dtsTree”。 |
[-quiet] |
忽略命令错误 |
[-verbose] |
命令执行期间暂挂消息限制 |
| [<patterns>] | 根据模式匹配单元名称；默认设置：* |
类别
DeviceTree
描述
获取当前 HSI 会话中 DT 树下创建的 DT 节点列表，这些 DT 节点必须与指定搜索模式相匹配。默认命令会获取当前 DT 树下的所有根 DT 节点的列表。
实参
-of_objects <arg> -（可选）获取 DTSNode 和 DTSTree 的所有节点
注释：
-of_objects 选项要求使用 get_* 命令（如 get_dt_nodes 或 get_dt_trees）来指定对象，而不是按名称来指定对象。此外，-of_objects 不得搭配搜索 <pattern> 一起使用。-regexp -（可选）指定以正则表达式方式编写搜索 <patterns>。使用该实参时，搜索 <patterns> 和 -filter 表达式都必须以正则表达式方式来编写。AMD 正则表达式 Tcl 命令始终锚定到搜索字符串开始位置。您可在搜索字符串开始或结束处添加 .* 来拓宽搜索范围，以包含子字符串。如需获取正则表达式语法相关帮助信息，请参阅该网页。
-filter <args> -（可选）使用指定表达式来筛选结果列表。-filter 实参会根据对象的属性值来筛选返回的对象列表。您可使用 report_property 或 list_property 命令来查找对象上的属性。
-quiet -（可选）以静默方式执行命令，不返回来自该命令的任何消息。此命令还会返回 TCL_OK，忽略执行期间遇到的所有错误。 注释： 启动该命令时，会返回命令行上遇到的任何错误。仅捕获该命令内部发生的错误。
-verbose -（可选）暂时改写任何消息限制，并返回来自该命令的所有消息。注释： 可使用
set_msg_config 命令定义消息限制。<patterns> -（可选）将节点与指定模式相匹配。默认模式为通配符 `*`，用于获取当前 DT 树中所有根节点的列表。您可指定多个模式，根据不同搜索条件来查找多个节点。
注释： 您必须使用括号 {} 或引号 "" 将多个搜索模式括起，表示此列表是单个元素。
示例
以下示例可获取连接到指定 DT 树的根节点列表：
hsi::get_dt_nodes -of_objects [lindex [get_dt_trees] 1]注释： 如果不存在与该模式相匹配的节点，则该工具返回结果为空。
以下示例可获取当前 DT 树中所有节点的列表：
hsi::get_dt_nodes -hier注释： 如果不存在与该模式相匹配的节点，则该工具返回结果为空。
以下示例可获取根节点下创建的节点列表：
hsi::get_dt_nodes -of_objects [current_dt_tree]注释： 如果不存在与该模式相匹配的节点，则该工具返回结果为空。