op_q_flush()
摘要
从外围队列中移除所有数据包。
语法
op_q_flush ()
| 参数 | 类型 | 说明 |
|---|---|---|
| 无参数 |
返回类型
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)
{
num_subqs = op_topo_child_count (op_id_self (), OPC_OBJTYPE_SUBQ);
for (i = 0; i < num_subqs; i++)
op_subq_sort (i);
}
}
详情
清空队列是通过清空它的每一个子队列来完成的。队列最初是空的,因为其所有子队列都是空的。数据包通过内核过程 op_subq_pk_insert() 添加到队列内的一个或多个子队列中;它们通过内核过程 op_subq_pk_remove() 和 op_subq_flush() 从子队列中移除,或通过内核过程 op_q_flush() 从整个队列中移除。
Q 包的内核过程只能在运行于队列模块上的进程的上下文中调用(或由队列进程直接或间接调用的函数中调用);从运行在处理器上的进程或管道阶段模型中调用它们将导致错误。
用途
提供一种从外围队列中移除所有数据包的机制。数据包会在此过程中被销毁,因此该操作仅在队列中的数据包可以因某种动态条件而被丢弃时使用。清空队列的典型应用包括节点崩溃或重启、链路或链路接口中断、使当前缓冲的数据失效的路由或其他网络管理更新,以及无需交付当前缓冲消息的虚电路或会话关闭。
错误
- 程序中止:KP 需要队列上下文。
- 程序中止:段违例。(由于队列数据包内驻留的畸形数据包或畸形结构字段)
参考
- 使用内核过程 op_subq_flush() 清空一个子队列
- 使用内核过程 op_q_empty() 判断外围队列是否没有数据包
- 使用内核过程 op_subq_empty() 判断某个子队列是否没有数据包
- 使用内核过程 op_subq_stat(),以 OPC_QSTAT_PKSIZE 符号常量作为参数,确定子队列中包含的数据包数量
- 使用内核过程 op_subq_pk_remove() 从子队列中移除单个数据包并获得指向它的指针