常用参数

ODB 命令可以接受一个或多个参数,用于指定命令的作用对象或影响命令的参数。虽然某些命令基于操作的特定上下文而有独特的参数,但大多数命令共享一组常用参数。表 25 列出了最常见的 ODB 参数类型、使用这些参数的命令,以及可以作为参数值来源的命令。

表 25:ODB 常用命令参数

名称 说明 类型 使用命令 来源命令
<bkpt_id> 断点 ID 整数 actstop, delstop, suspstop status
<trace_id> 跟踪记录 ID 整数 acttrace, deltrace, susptrace status
<process_id> 进程 ID 整数 prodiag, proldiag, prostop, prolstop, protrace, proltrace, proprint objprint, promap
<objref> 对象引用
(数字对象 ID 或以点分隔的层次化对象名)
整数或字符串 attrget, attrset, evprint, intdisprint, interfaceset, interfacestop, interfacetrace, intstop, mlstop, mltrace, mstop, mtrace, objassoc, objid, objmap, objprint, promap objassoc, objid, objmap, objprint
<pk_id> 数据包 ID 整数 iciprint_pk, pkmap, pkprint, pktrace, pkstop pkmap
<pk_tree_id> 数据包树 ID 整数 ptmap, pttrace pkmap
<exec_id> 执行 ID 整数 evstop evprint
<sched_id> 调度 ID 整数 evstop evprint
<objtype> 对象类型 枚举关键字 objmap N/A
<label> 标签 字符串 lstop, trace, mlstop, mltrace, proldiag, prolstop, proltrace N/A

ODB 中使用最多的参数类型是复合类型 <objref>(object reference 的缩写)。对象引用要么是整数对象 ID,要么是层次化对象名——它由从网络模型顶层到目标对象的整条路径上所有嵌套对象的名称组成。完整层次化对象名的示例格式见图 28和图 29。

图 28:普通对象的完整层次化对象名格式与示例

普通对象的完整层次化对象名格式与示例

图 29:复合对象的完整层次化对象名格式与示例

复合对象的完整层次化对象名格式与示例

完整的层次化名称可以指向包含在若干嵌套子网中的对象;在这种情况下,如上面的示例所示,层次化名称中的子网部分实际上由所有嵌套子网名以点分隔的列表构成。注意,顶层子网名("top")是可选的,可以省略而不会出错。

在访问复合属性对象的子对象时,使用子模块索引来指代该复合属性对象的某个特定子对象。它用于访问复合属性子对象,如子队列(队列的子对象)和信道(发送器和接收器的子对象)。

使用上述格式引用子网、节点和模块时,只需省略格式中位于目标对象之下的部分。每种引用类型的示例见图 30。

图 30:部分层次化对象名示例

部分层次化对象名示例

命令别名

为简化调试,你可以为常用命令创建命令别名。别名将一串给定的字母数字字符映射到相应的 ODB 命令行片段。处理命令时,ODB 会尝试将命令的第一个词与别名列表匹配。如果匹配成功,该别名将被它所代表的实际命令替换。

表 26:别名命令

命令 说明
alias 定义一个别名,或显示所有已定义的别名。
unalias 取消定义一个别名。