包概述
ICI(Interface Control Information,接口控制信息)包是一组与 ICI 仿真实体相关的内核过程;ICI 是 Interface Control Information 的缩写。ICI 是一种结构化的数据集合,在进程之间传递,作为进程间通信的一种形式。如果进程在引发中断的动作之前安装了该 ICI,则该 ICI 会与中断建立关联。分层协议接口是 ICI 的主要应用场景,但 ICI 也可用于将信息与复杂自中断或对等远程中断相关联。
ICI 是动态的仿真实体,因为它们在进程执行过程中按需创建和销毁。内核过程 op_ici_create() 用于基于指定的 ICI 格式创建 ICI。ICI 格式通过 ICI 格式编辑器创建,它决定新建 ICI 所支持的属性名称与数据类型列表。ICI 创建完成后,op_ici_create() 返回指向该 ICI 的指针,ICI 包中大多数内核过程都用该引用来指代这个 ICI。
当某个已存在的 ICI 不再需要时,可以使用内核过程 op_ici_destroy() 将其销毁。销毁即释放该 ICI 占用的内存资源。ICI 通常由接收它的进程负责销毁,因为接收进程最清楚它何时已经完成了使命。
新创建的 ICI 内部不含任何信息,必须按属性逐个添加。内核过程 op_ici_attr_set_dbl()、op_ici_attr_set_int32()、op_ici_attr_set_int64() 和 op_ici_attr_set_ptr() 用于设置单个 ICI 属性的值。
一个进程可以创建多个 ICI,为其属性赋值,并通过在状态变量或临时变量中保存其指针来维护它们。但每个进程只有一个 ICI 会实际与出站中断关联。若要将某个 ICI 安装为应与中断关联的 ICI,应使用该 ICI 的指针调用内核过程 op_ici_install()。一个 ICI 会保持安装状态,直到用同样的方法安装了另一个 ICI 为止。
当进程收到一个 ICI 后,可以通过内核过程 op_intrpt_ici() 获取指向它的指针。随后可通过内核过程 op_ici_attr_get_dbl()、op_ici_attr_get_int32()、op_ici_attr_get_int64() 和 op_ici_attr_get_ptr() 获取该 ICI 各属性的值。由于某些进程模型可能需要接收包含不同属性、格式各异的多个 ICI,在提取值之前可能需要先用 op_ici_attr_exists() 确认某个属性是否存在。
当一个复杂的进程预计会收到与不同类型的 ICI 关联的中断时,可以通过内核过程 op_ici_format()(获取名称)和 op_ici_is_format()(检验名称)来识别收到的 ICI 的格式。
在调试进程模型时,可以使用内核过程 op_ici_print() 打印 ICI 的内容。借助内核过程 op_ici_format_print_proc_set() 可以打印自定义的 ICI 结构字段。可以分别使用 op_ici_id() 或 op_ici_id_str_get() 以数字或字符串形式获取 ICI 的 ID。