sync

产品支持情况

• Ascend 950PR/Ascend 950DT：支持

• Atlas A3 训练系列产品/Atlas A3 推理系列产品：不支持

• Atlas A2 训练系列产品/Atlas A2 推理系列产品：不支持

• Atlas 200I/500 A2 推理产品：不支持

• Atlas 推理系列产品AI Core：不支持
• Atlas 推理系列产品Vector Core：不支持

• Atlas 训练系列产品：不支持

功能说明

同步指定协作组内的所有线程，功能等价于调用该协作组对象的成员函数sync()。

函数原型

C++

template <typename GroupType>
void sync(const GroupType& g)

参数说明

表1 模板参数说明

参数名	描述
GroupType	协作组对象的类型。

表2 参数说明

参数名	输入/输出	描述
g	输入	待同步的协作组对象。

返回值说明

无

约束说明

• 对于grid_group，该接口仅支持SIMT编程场景，不支持SIMD与SIMT混合编程场景。
• 必须保证协作组内所有线程都能执行到同一个sync(g)调用，否则是未定义行为。

调用示例

• SIMT编程场景：

  C++

  using namespace cooperative_groups;
  __global__ void simt_kernel(...)
  {
      ...
      thread_block block = this_thread_block();
      sync(block); // 等价于block.sync()
  
      grid_group grid = this_grid();
      sync(grid); // 等价于grid.sync()
      ...
  }
  

• SIMD与SIMT混合编程场景：

  C++

  using namespace cooperative_groups;
  __simt_vf__ inline void simt_kernel(...)
  {
      ...
      thread_block block = this_thread_block();
      sync(block); // 等价于block.sync()
      ...
  }