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>)。
参考
- 使用内核过程 op_pro_create() 创建进程并获取其句柄
- 使用内核过程 op_pro_parent() 获取另一进程的父进程的过程句柄