多线程安全性

Riverbed Modeler 拥有并行仿真内核,使仿真可以使用多个处理器。为确保数据包并行传输等活动尽可能正确、快速地完成,所有相关代码必须使用多线程安全的 API(内核过程与 PRG 函数)。

注意: 在此语境下,多线程安全性指代码在 Riverbed 并行仿真环境中安全运行的能力。这不等同于在操作系统线程管理器管理的用户自建线程中运行。你不能从用户自建线程中调用 Riverbed 函数(无论是否为内核过程)。

Riverbed API 的多线程安全级别分为两种:

  • MT-safe(多线程安全):这些 API 支持多线程。多个线程可以并行执行这些 API 而没有危险。
  • MT-unsafe(多线程不安全):这些 API 不支持多线程。使用 MT-unsafe API 的代码需要由用户自行进行适当的串行化。(为这些 API 启用并行反而会导致性能损失,而非预期的并行收益。)

大多数 KP 和 PRG API 都是 MT-safe 的。那些不安全或安全性存在某些限制的 API 会在 API 说明中明确标示,并列在表 3 中。

注意: 某些包不被并行内核支持。如果在并行仿真中使用这些包的 API,它们要么失败,要么什么都不做。

表 3:MT-Unsafe 的 KP 与 PRG API

KP 说明
op_anim_ 包 不安全。动画 KP(尤其是宏定义)的使用必须由用户串行化。
op_esys_ 包 External System(外部系统)包不被并行内核支持。
op_ev_count()、op_ev_count_local()、op_ev_next()、op_ev_next_local()、op_ev_pending()、op_ev_seek_time() 安全,但仅对未来事件(当前执行时间窗口之外的事件)具有确定性。我们不建议在并行仿真中使用这些 KP。
op_ima_obj_svar_get() 安全,但如果多个客户端正在访问或修改共享的 svar 信息,则必须谨慎使用。
op_intrpt_priority_get、op_intrpt_priority_set、op_intrpt_priority_set_next 与事件优先级相关的 KP 不被并行内核支持。
op_prg_list_ 子包 不安全。对共享列表的访问必须由用户串行化。
op_pro_svar_get() 安全,但如果多个客户端正在访问或修改共享的 svar 信息,则必须谨慎使用。
prg_string_hash_table 包 不安全。对共享哈希表的访问必须由用户串行化。
prg_list 包 不安全。对共享列表的访问必须由用户串行化。
prg_map 包 不安全。对共享的映射数据元素的访问必须由用户串行化。
prg_vector 包 不安全。对共享向量的访问必须由用户串行化。