op_pro_tag_set()

摘要

在进程中设置描述性标签。

语法

op_pro_tag_set (pro_handle, tag_string)
参数 类型 说明
pro_handle Prohandle 指向目标进程的过程句柄
tag_string const char* 进程标签——描述性字符串

返回类型

Compcode

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

示例

/* Obtain the number of subqueues. */
op_ima_obj_attr_get (queue_object_id, “subqueue count”, &num_subq);

/* Create a process to manage each subqueue. */
for (i = 0; i < num_subq; i++)
	
	/* Create the process. */
	pro_handle = op_pro_create (“subqueue_manager”, OPC_NIL);
	
	/* Generate descriptive string and set in process. */
	sprintf (tag_string, “subq process (%d)”, i);
	op_pro_tag_set (pro_handle, tag_string);
	}

详情

标签通常是一个字符串,用于在同一个处理器或队列内区分同类型的不同进程。标签可以是字符串常量,在进程模型中表示为由双引号包围的字符串。标签值也可以使用 C 函数 sprintf 动态生成。

用途

该内核过程提供了一种为进程附加描述性字符串的机制。标签通常用于在仿真调试器环境中区分相似的进程。调试器命令 promap 显示指定处理器或队列中存在的进程。

错误

  • 程序中止:内核过程需要进程上下文。
  • 程序中止:段违例。(由于进程句柄格式错误,或 tag_string 参数无效或格式错误)
  • 可恢复错误:过程句柄无效。
  • 可恢复错误:过程句柄指向已被销毁的进程(<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