op_pro_destroy()

摘要

销毁一个动态创建的进程。

语法

op_pro_destroy (pro_handle)
参数 类型 说明
pro_handle Prohandle 要销毁的进程的进程句柄

返回类型

Compcode

完成代码,指示仿真内核是否成功销毁了该进程。可将该返回代码与常量 OPC_COMPCODE_SUCCESS 和 OPC_COMPCODE_FAILURE 进行比较,以确定进程销毁是否成功。

示例

摘自:示例模型(models/std/x25);外部文件(x25_funcs.ex.c);函数(x25_channel_free())。

/* Extract the group and channel indices from the channel number */
group = (chan_num & X25C_MASK_GROUP) >> X25C_SHIFT_GROUP;
index = (chan_num & X25C_MASK_LCHAN) >> X25C_SHIFT_ICHAN;

if (root [group] != OPC_NIL)
	{
	/* Get the pointer to the channel. */
	chan_ptr = root [group][index];
	if (chan_ptr != OPC_NIL)
		{
		/* Destroy the sub-process. */
		if (op_pro_destroy (chan_ptr->process) == OPC_COMPCODE_FAILURE)
			{
			x25_warning (“Unable to destroy channel process.”);
			}

		/* Deallocate the memory for the channel structure. */
		/* First the string pointers. */
		op_prg_mem_free (chan_ptr->local_addr);
		op_prg_mem_free (chan_ptr->remote_addr);
		op_prg_mem_free (chan_ptr->loc_app_name);
		op_prg_mem_free (chan_ptr->rem_app_name);

		/* Deallocate the channel itself. */
		op_prg_mem_free (chan_ptr);

		/* Mark the entry as free, so that a future connection */
		/* can use this channel. */
		root [group] [index] = OPC_NIL;
		}
}

详情

该内核过程允许一个进程销毁由同一模块拥有的任何其他动态进程(因此,根进程是给定模块中唯一不能被销毁的进程)。(动态进程是指通过内核过程 op_pro_create() 创建的进程;动态进程可以在仿真期间的任何时刻从模型中移除。)

进程的正常终止通常包括释放该进程可能已分配的动态内存,但也可能包括建模应用特有的操作(例如报告该进程历史期间累积的某个统计量的值)。进程模型有一个专门的逻辑部分,用于处理其被销毁时发生的处理。这一部分就是进程模型的终止块(Termination Block),其中的代码在进程被销毁时由仿真内核直接调用。状态变量和临时变量可以在这一部分代码中使用。

进程可以销毁自身,此时它不会返回。因此,进程在销毁自身之后不会执行任何操作,终止块中指定的操作除外。

注意: 内核对父子内存或参数内存的释放不承担任何责任。

用途

支持动态创建进程的移除与释放。这使得处理器或队列能够只保持那些对其正确运行所必需的进程处于活动状态。

错误

  • 程序中止:内核过程要求进程上下文。
  • 程序中止:段错误。(由于进程句柄格式错误)
  • 可恢复错误:进程句柄无效。
  • 可恢复错误:进程句柄指向已被销毁的进程(<proc_id>)。
  • 可恢复错误:进程句柄指向远端进程(<proc_id>)。
  • 可恢复错误:进程句柄指向根进程(<proc_id>)。
  • 可恢复错误:进程句柄指向活动进程(<proc_id>)。

参考

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · 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