17.2.370. MPI_T_pvar_start

MPI_T_pvar_start, MPI_T_pvar_stop - 启动/停止性能变量

17.2.370.1. 语法

17.2.370.1.1. C语法

#include <mpi.h>

int MPI_T_pvar_start(MPI_T_pvar_session session, MPI_T_pvar_handle handle)

int MPI_T_pvar_stop(MPI_T_pvar_session session, MPI_T_pvar_handle handle)

17.2.370.2. 输入参数

  • session: 性能实验会话。

  • handle: 性能变量句柄。

17.2.370.3. 描述

MPI_T_pvar_start 启动由handle参数指定的性能变量。特殊值MPI_T_PVAR_ALL_HANDLES可以传入handle参数,用于启动session参数指定会话中的所有非连续句柄。

MPI_T_pvar_stop 用于停止由handle参数指定的性能变量。可以通过传入特殊值MPI_T_PVAR_ALL_HANDLES来停止session参数指定会话中的所有非连续句柄。

连续性能变量既无法启动也无法停止。

17.2.370.4. 错误

MPI_T_pvar_start 和 MPI_T_pvar_stop() 在以下情况下会失败:

  • MPI_T_ERR_NOT_INITIALIZED: MPI工具接口未初始化

  • MPI_T_ERR_INVALID_SESSION: 会话参数不是有效的会话

  • MPI_T_ERR_INVALID_HANDLE: 无效句柄或句柄未与会话关联

  • MPI_T_ERR_PVAR_NO_STARTSTOP: 该变量无法启动或停止

另请参阅