op_subq_sort()
摘要
按照与每个数据包关联的优先级属性对指定子队列进行排序。
语法
op_subq_sort (subq_index)
| 参数 | 类型 | 说明 |
|---|---|---|
subq_index |
int |
目标子队列的数字索引 [子队列流索引从 0 开始,依次递增 1。子队列的数量没有上限,但如果连续使用它们,可以实现内存的节约使用。除了显式的子队列索引,还可以指定抽象子队列选择索引。抽象子队列选择索引通过某个子队列独有的属性来指定该子队列。可接受的抽象子队列选择索引列于表 85“Subqueue Selection Index Symbolic Constants“ 第 26 页。] |
返回类型
void
无返回值。
示例
/* determine the type
of the interrupt */
if (op_intrpt_type () == OPC_INTRPT_REMOTE)
{
/* cold reboot: total loss of queued packets */
if (op_intrpt_code () == COLD_REBOOT)
{
/* record the number of packets lost */
num_lost_packets += op_q_stat (OPC_QSTAT_PKSIZE);
/* flush the queue of its contents */
op_q_flush ();
}
/* prioritize: loop through and sort all subqueues */
else if (op_intrpt_code () == PRIORITIZE)
{
op_ima_obj_attr_get (op_id_self (), "subqueue", &subq_objid);
num_subqs = op_topo_child_count (subq_objid, OPC_OBJTYPE_SUBQ);
for (i = 0; i < num_subqs; i++)
op_subq_sort (i);
}
}
详情
本 KP 只能在与队列模块上运行的进程的上下文中调用(或由队列进程直接或间接调用的函数中调用);从处理器上运行的进程或管道级模型调用将导致错误。
用途
提供一种在一次调用中基于数据包优先级属性对子队列进行排序的机制。在优先级排队场景中,子队列通常始终处于排序状态,这意味着数据包是通过向 KP op_subq_pk_insert() 传递 OPC_QPOS_PRIO 符号常量来插入的。这类场景不需要调用本 KP。然而,当一个此前未排序的队列状态发生变化、必须突然转为优先级排队时,op_subq_sort() 就非常有用。本 KP 的另一种应用是:已排序子队列中某些数据包的优先级级别被动态改变,从而需要对子队列重新洗牌。
错误
- 程序中止:KP 需要队列上下文。
- 可恢复错误:子队列选择标志(
<flag>)无法识别。 - 程序中止:段违例。(由于子队列内存在格式错误的数据包)
参考
- 使用 KP op_pk_priority_get() 获取数据包的优先级值
- 使用 KP op_pk_priority_set() 为数据包赋予新的优先级值
- 使用 KP op_subq_pk_insert(),以 OPC_QPOS_PRIO 符号常量作为位置索引传入,在保持优先级顺序的同时将数据包插入子队列
- 使用 KP op_subq_pk_swap() 交换子队列中两个数据包的位置