op_pk_bcast_general()
摘要
为指定数据包设置广播属性,允许其广播到所有网络节点中的合格接收器。
语法
op_pk_bcast_general (pkptr)
| 参数 | 类型 | 说明 |
|---|---|---|
pkptr |
Packet* |
指向目标数据包的指针 [指向数据包的指针可以从许多内核过程获得,包括 op_pk_create()、op_pk_create_fmt()、op_pk_copy()、op_pk_get()、op_subq_pk_access() 和 op_subq_pk_remove()。] |
返回类型
void
无返回值。
示例
/** this is the basis of a simple repeater node, which **/
/** receives uniquely broadcasted packets from terminal nodes **/
/** and repeats them at high power to all terminal nodes. **/
/* receive a uniquely broadcasted packet from terminal node */
pkptr = op_pk_get (IN_STRM);
/* restore general broadcast property of packet */
op_pk_bcast_general (pkptr);
/* send packet to transmitter, thus generally broadcasting it */
op_pk_send (pkptr, 0);
详情
在默认条件下,使用总线发射器或无线电发射器发送数据包会将该数据包广播到所有有资格接收该广播的接收器。就总线广播而言,连接在同一总线链路上的任何接收器都有资格接收。就无线电广播而言,接收器必须有若干发射器和接收器属性相互匹配才有资格接收。在两种情况下,通常都会有多个接收器有资格接收广播的数据包。
每个数据包都有一个内部广播属性;上述默认条件的产生,是因为数据包的广播属性被设置为 general(即所有合格接收器都会接收广播)。相反的情况是数据包的广播属性被设置为 unique(即只有单个指定节点处的合格接收器会接收广播)。该内核过程将数据包的广播属性设置为 general。数据包的广播属性可以在任何时候设置;它只在数据包进入总线或无线电发射器时才会影响仿真内核的行为。
该内核过程需要进程上下文,因此只能从进程模型、或被进程模型直接或间接调用的函数中调用。该内核过程既可操作未格式化数据包,也可操作格式化数据包。
用途
提供一种将数据包的广播属性恢复为 general 的机制。只有当数据包此前已被相关内核过程 op_pk_bcast_unique() 操作过、现在必须重置以允许一般广播时,才需要这样做。
错误
- 程序中止:Segmentation violation.(由于无效的数据包指针或格式错误的数据包)
- 程序中止:内核过程需要进程上下文。
- 程序中止:数据包指针为 NIL。
- 程序中止:数据包指针指向已销毁的数据包。
- 程序中止:数据包指针指向无主数据包 (
<pk_id>)。 - 程序中止:数据包指针指向静态数据包 (
<pk_id>)。
参考
- 使用内核过程 op_pk_bcast_unique() 将数据包的广播属性设置为面向单个节点
- 使用内核过程 op_pk_send() 将数据包转发到总线或无线电发射器,以实际执行广播操作