op_intrpt_port_register()

摘要

注册一个进程,使其成为到达当前执行模块某个特定端口的数据包流或统计量中断的直接接收者。

语法

op_intrpt_port_register (port_type, port_index, pro_handle)
参数 类型 说明
port_type int 要启用中断注册的端口类型。
[这是一个整数符号常量,指定数据包流输入或统计量输入。可能的取值为 OPC_PORT_TYPE_STRM 和 OPC_PORT_TYPE_STAT。]
port_index int 要启用中断注册的端口索引。
[数据包流和统计量连线输入的索引均从零开始计第一个端口。]
pro_handle Prohandle 被指定为符合端口类型和端口索引条件之中断的直接接收者的进程的句柄。
[这必须是一个有效(即存在)进程的句柄。]

返回类型

void

无返回值

示例

/* Set up separate handling process for each */
/* supported input stream, since each stream */
/* will support one remote connection. */
for (i = 0; i < num_sup_streams; i++)
	{
	/* Create a packet handler process. */
	handler_pro = op_pro_create ("pkt_handler", OPC_NIL);
	
	/* Request that the kernel notify this new process directly */
	/* (i.e., without notifying the root process) when packets */
	/* arrive on its stream. */
	op_intrpt_port_register (OPC_PORT_TYPE_STRM, i, handler_pro);
	}

详情

默认情况下,数据包流或统计量中断被路由到其到达的模块的根进程。但是,有两种机制可以改变这一行为,使此类中断改为路由到模块内的另一个进程。第一种机制利用内核过程 op_intrpt_type_register() 指定一个进程来接收所有类型为数据包流或统计量的中断。第二种机制由内核过程 op_intrpt_port_register() 支持,它更为具体,允许当数据包流或统计量中断到达特定输入端口时将中断直接传送给指定进程。当两种注册同时生效时,端口注册优先于类型注册。

使用 op_intrpt_port_register() 的效果可以在仿真中其后的任意时刻通过调用内核过程 op_intrpt_port_deregister() 来“撤销”。

端口类型分为数据包流或统计量两种,分别由符号常量 OPC_PORT_TYPE_STRM 和 OPC_PORT_TYPE_STAT 表示。

用途

当可以编写模块化进程来独立处理模块各个端口产生的事件流时,该内核过程非常有用。通过配置模块将中断直接路由到合适的进程,可以避免在每个事件时先中断根进程、再由根进程把中断转交给另一个进程的开销。这也简化了根进程的设计,因为它不再需要扮演整个模块的“事件协调者”角色。

错误

  • 程序中止:内核过程需要进程上下文。(如果在处理器或队列之外调用)
  • 程序中止:段违例。(由于进程句柄格式错误)
  • 可恢复错误:进程句柄对应一个已被销毁的进程。
  • 可恢复错误:进程句柄无效。
  • 可恢复错误:进程句柄对应一个远程进程。
  • 可恢复错误:统计量索引 (<port_index>) 超出范围。
  • 可恢复错误:数据包流索引 (<port_index>) 超出范围。
  • 可恢复错误:端口类型 (<port_type>) 无法识别。

参考

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com