op_pk_deliver()
摘要
将指定数据包转发到远程模块,将数据包到达该模块的时间调度在当前仿真时间,并释放调用进程对该数据包的所有权。
语法
op_pk_deliver (pkptr, mod_objid, instrm_index)
| 参数 | 类型 | 说明 |
|---|---|---|
pkptr |
Packet* |
指向目标数据包的指针 [指向数据包的指针可以从许多内核过程获得,包括 op_pk_create()、op_pk_create_fmt()、op_pk_copy()、op_pk_get()、op_subq_pk_access() 和 op_subq_pk_remove()。] |
mod_objid |
Objid |
远程模块的对象 ID [模块对象 ID 可以从 Topo 和 Id 包中的若干内核过程获得: op_id_self()、op_topo_child() 和 op_id_from_name()。] |
instrm_index |
int |
远程模块某个输入数据包流的索引 |
返回类型
void
无返回值。
示例
/* obtain the object ID of remote telemetry processor */
node_objid = op_id_from_name (0, OPC_OBJTYPE_NODE_FIXED, "tlm_node");
proc_objid = op_id_from_name (node_objid, OPC_OBJTYPE_PROC, "tlm_proc");
/* create a packet */
pkptr = op_pk_create (128);
/* stuff packet with operation code */
op_pk_fd_set (pkptr, 0, OPC_FIELD_TYPE_INTEGER, OPCODE_ACTIVATE, 0);
/* deliver the packet to remote processor */
op_pk_deliver (pkptr, proc_objid, 0);
详情
该内核过程将指定数据包到达指定远程模块的时间进行调度。到达时间被调度在当前仿真时间,相应的事件被加入仿真事件列表。该事件将在任何仿真时间推进之前发生,但不会先于已调度在当前仿真时间的其他事件执行。事件执行时,远程模块将以流中断方式被调用。如果远程模块是处理器或队列,其关联的进程可以通过内核过程 op_intrpt_type() 判断该中断是由输入流引起的。到达输入数据包流的数据包可由目标进程通过内核过程 op_pk_get() 获取。
数据包一旦传递给该内核过程,调用进程即失去对该数据包的所有权,因为所有权已转移给远程模块。传递方进程再调用任何内核过程时若传入这个“失效”的数据包指针,将导致数据包所有权错误。
未格式化和已格式化的数据包都可以通过该内核过程传递。
用途
提供一种不依赖数据包流、在模块之间传递数据包的机制。使用该内核过程传递数据包是面向数据包流的 op_pk_send…() 系列内核过程的替代方式。当模块与节点之间的物理互连不影响对等进程之间的传输时,或者当网络架构的底层(即物理层、数据链路层和网络层)未被显式建模时,这种替代方式非常有用。该内核过程的变体提供在远程模块的延迟到达、强制到达或静默到达。数据包可以交付到处理器或队列中运行的其他进程,或交付到发射机模块。
错误
- 程序中止:Segmentation violation.(由于无效的数据包指针或格式错误的数据包)
- 程序中止:数据包指针为 NIL。
- 程序中止:数据包指针指向已销毁的数据包。
- 程序中止:数据包指针指向无主数据包 (
<pk_id>)。 - 程序中止:数据包指针指向静态数据包 (
<pk_id>)。 - 程序中止:数据包交付失败,对象 (
<mod_objid>),流 (<instrm_index>)。 - 可恢复错误:对象 ID (
<mod_objid>) 超出范围。
参考
- 使用内核过程 op_pk_deliver_delayed() 交付数据包,其到达带有延迟
- 使用内核过程 op_pk_deliver_forced() 交付数据包以便在远程模块立即处理
- 使用内核过程 op_pk_deliver_quiet() 交付数据包且不在远程模块引起中断
- 使用
op_pk_send…()内核过程通过数据包流向相邻模块转发包 - 使用内核过程 op_pk_get() 获取到达数据包的指针