7.2.1.1. NV::Cupti::Checkpoint

namespace Checkpoint

数据结构

CUpti_Checkpoint

CUPTI Checkpoint 的配置和句柄。

枚举

CUpti_CheckpointOptimizations

指定 checkpoint 的优化选项,可以进行“或”运算组合以指定多个选项。

函数

CUptiResult cuptiCheckpointFree(CUpti_Checkpoint *const handle)

释放 checkpoint 的后备数据。

CUptiResult cuptiCheckpointRestore(CUpti_Checkpoint *const handle)

将 checkpoint 恢复到与其上下文关联的设备。

CUptiResult cuptiCheckpointSave(CUpti_Checkpoint *const handle)

初始化并保存与句柄上下文关联的设备状态的 checkpoint。

7.2.1.1.2. 枚举

enum NV::Cupti::Checkpoint::CUpti_CheckpointOptimizations

指定 checkpoint 的优化选项,可以进行“或”运算组合以指定多个选项。

enumerator CUPTI_CHECKPOINT_OPT_NONE

默认行为。

enumerator CUPTI_CHECKPOINT_OPT_TRANSFER

确定哪些内存块已更改,并仅恢复这些块。此优化是缓存的,这意味着当启用此选项时,必须始终在应用程序中的同一点调用 cuptiCheckpointRestore,否则结果可能不正确。

7.2.1.1.3. 函数

CUptiResult NV::Cupti::Checkpoint::cuptiCheckpointFree(CUpti_Checkpoint *const handle)

释放 checkpoint 的后备数据。

释放此上下文的所有关联设备、主机内存和文件系统存储。释放句柄后,它可以像新句柄一样重新使用 - 选项可以重新配置,并在下次调用 cuptiCheckpointSave 时生效。

参数

handle – 指向先前保存的 CUpti_Checkpoint 对象的指针

返回值
  • CUPTI_SUCCESS – 如果句柄已成功释放

  • CUPTI_ERROR_INVALID_PARAMETER – 如果句柄已被释放或显示无效

  • CUPTI_ERROR_INVALID_CONTEXT – 如果上下文不再有效

CUptiResult NV::Cupti::Checkpoint::cuptiCheckpointRestore(CUpti_Checkpoint *const handle)

将 checkpoint 恢复到与其上下文关联的设备。

将设备、固定内存和已分配内存恢复到保存 checkpoint 时的状态

参数

handle – 指向先前保存的 CUpti_Checkpoint 对象的指针

返回值
  • CUTPI_SUCCESS – 如果 checkpoint 已成功恢复

  • CUPTI_ERROR_NOT_INITIALIZED – 如果 checkpoint 之前未初始化

  • CUPTI_ERROR_INVALID_CONTEXT

  • CUPTI_ERROR_INVALID_PARAMETER – 如果句柄显示无效

  • CUPTI_ERROR_UNKNOWN – 如果恢复或优化操作失败

CUptiResult NV::Cupti::Checkpoint::cuptiCheckpointSave(CUpti_Checkpoint *const handle)

初始化并保存与句柄上下文关联的设备状态的 checkpoint。

使用句柄选项配置并保存与指定上下文关联的设备状态的 checkpoint。

参数

handle – 指向 CUpti_Checkpoint 对象的指针

返回值
  • CUPTI_SUCCESS – 如果 checkpoint 已成功初始化并保存

  • CUPTI_ERROR_INVALID_PARAMETER – 如果 handle 似乎未指向有效的 CUpti_Checkpoint

  • CUPTI_ERROR_INVALID_CONTEXT

  • CUPTI_ERROR_INVALID_DEVICE – 如果与上下文关联的设备与 checkpoint API 不兼容

  • CUPTI_ERROR_INVALID_OPERATION – 如果在现有 checkpoint 上请求保存,但最初未指定 allowOverwrite

  • CUPTI_ERROR_OUT_OF_MEMORY – 如果按配置,没有足够的后备存储空间来保存 checkpoint