包概述

Q(队列)包是一组内核过程的集合,用于操作队列模块内包含的排队资源。本手册记录的大多数包都设计为可在四种上下文中使用:在处理器上执行的进程、在队列上执行的进程、Transceiver Pipeline(收发器管道)级,以及通过内核过程 op_intrpt_schedule_call() 调度的过程调用。Q 包的特殊之处在于它只能用于一种上下文:在队列上执行的进程。

队列的内部资源组织为一组子队列。每个子队列是一条独立的数据包链表,具有确定的头和尾。Subq 包支持对子队列的操作,例如插入和提取数据包。Q 包支持对整个子队列组的操作,因此在 Q 操作中不指定单个子队列。

若子队列不包含任何数据包,则该子队列为空;若队列的所有子队列都为空,则该队列为空。队列进程可使用内核过程 op_q_empty() 判断队列是否为空。

网络中的某些全局或局部事件需要将队列清空(“刷新”)。例如,通知各队列网络协议正在复位的全局消息,或本地节点的崩溃。当队列进程判断需要刷新所有数据包时,可调用内核过程 op_q_flush()。

队列模块在子队列和队列两个级别收集大量统计量。队列级统计量是基于所有子队列运行情况的汇总值。可使用内核过程 op_q_stat() 获取内置队列级统计量的值;该统计量由整数代码指定(所有支持的队列统计量的符号常量见第 28 章“Symbolic Constants”第 1 页)。

存储在队列中的数据包包含特殊属性,用于记录其进入排队资源的时间,以及在排队资源内等待的时间长度。可通过内核过程 op_q_insert_time() 获取数据包的插入时间属性,通过内核过程 op_q_wait_time() 获取数据包的等待时间属性。