op_topo_connect()
摘要
获取指定的源对象与目的对象之间所请求类型和索引的连接对象的对象 ID。
语法
op_topo_connect (src_objid, dst_objid, conn_objmtype, conn_index)
| 参数 | 类型 | 说明 |
|---|---|---|
src_objid, dst_objid |
Objid |
被连接对象的对象 ID [对象 ID 可通过 Id 包中的多个内核过程获得: op_id_self()、op_id_from_userid() 和 op_id_from_name()。此外,对象 ID 也可从 Topo 包内核过程 op_topo_parent()、op_topo_child()、op_topo_assoc() 和 op_topo_connect() 的先前调用中获得。] |
conn_objmtype |
int |
连接对象的对象元类型 [该值是一个整数代码,指定所关注连接的对象类型(参见表 69“对象类型符号常量”第 19 页)。] |
conn_index |
int |
所关注连接对象的数字索引 [连接对象索引从 0 开始,每次递增 1,最大值为该类型连接对象数量减 1。] |
返回类型
Objid
源对象与目的对象之间指定连接对象的对象 ID。若发生可恢复错误,将返回符号常量 OPC_OBJID_INVALID 所代表的特殊值。
示例
/* Verify that a duplex point-to-point link exists between the two nodes. */
link_id = op_topo_connect (src_node_id, dest_node_id, OPC_OBJTYPE_LKDUP, 0);
if (link_id != OPC_OBJID_INVALID)
{
/* The link exists so send the packet. */
op_pk_send (pkptr, MAC_OUT_STREAM);
}
else
{
/* The link does not exist. Destroy the packet and increment counter. */
op_pk_destroy (pkptr);
num_pkts_destroyed++;
}
详情
如果一个对象连接了另外两个对象,则该对象是连接对象。例如,数据包流可以连接两个模块,链路可以连接两个节点。表 22 列出了有效的参考对象/连接对象类型组合。
表 22:对象与连接对象类型
| 源对象类型 | 目的对象类型 | 连接对象类型 |
|---|---|---|
| 站点(子网;固定节点) | 站点 | 路径 |
| 固定节点 | 固定节点 | 链路 |
| 模块(处理器、队列等) | 模块 | 数据包流与统计量连线 |
| 发射机(点对点、总线、无线电) | 接收机(点对点、总线、无线电) | 链路 |
| 总线发射机 | 总线链路 | 抽头 |
| 总线链路 | 总线接收机 | 抽头 |
移动节点和卫星节点不支持连接对象,因为它们无法连接到点对点链路或总线链路。
用途
提供了一种获取位于另外两个对象之间的对象的对象 ID 的机制。当进程需要获取或设置属于连接对象的属性时,该函数通常很有用。例如,发送节点中的进程可能需要更改到某个接收节点的链路的误码率。调用 op_topo_connect() 即可获得连接这两个节点的链路的对象 ID,再调用 op_ima_obj_attr_set() 即可设置新的误码率值。
错误
- 可恢复错误:源对象 ID (<src_objid>) 超出范围。
- 可恢复错误:目的对象 ID (<dst_objid>) 超出范围。
- 可恢复错误:对象元类型 (<conn_objmtype>) 无法识别。
- 可恢复错误:对象索引 (<conn_index>) 超出范围。
- 可恢复错误:源对象 ID (<src_objid>) 指向受限对象。
- 可恢复错误:目的对象 ID (<dst_objid>) 指向受限对象。
参考
- 使用内核过程 op_topo_connect_count() 确定两个对象之间的连接对象数量
- 使用内核过程 op_ima_obj_attr_get() 获取对象属性的值
- 使用内核过程 op_ima_obj_attr_set() 为对象属性赋值
- 使用内核过程 op_topo_object() 获取对象的对象 ID