MemtestCL 技术文档

2024-12-28 09:26:50作者：卓炯娓

1. 安装指南

安装依赖

在安装 MemtestCL 前，确保您的系统已经安装了 OpenCL SDK。通常情况下，可以使用 NVIDIA CUDA 工具包（3.0 版本及以上）或 ATI Stream SDK。使用任一 SDK 编译的二进制文件都应在任何 OpenCL 实现上运行（即无需使用 ATI Stream SDK 编译的二进制文件就可以在 ATI GPU 上运行）。

编译说明

项目提供了适用于 32 位和 64 位 Linux、Mac OS X 以及 32 位 Windows 的 Makefile 文件。以下是在不同操作系统上编译 MemtestCL 的步骤：

Linux 和 OS X:
```
make -f Makefiles/Makefile.OS
```
其中 OS 是以下之一：linux32, linux64, osx。
Windows: 使用 Visual Studio C++ 编译器和 make 系统进行编译（已测试在 VS2005 下）：
```
nmake -f Makefiles\Makefile.windows
```

编译完成后，会在相应目录下生成可执行文件 memtestCL。

2. 项目的使用说明

MemtestCL 是一个用于测试 OpenCL 启用的 GPU、CPU 和加速器的内存和逻辑是否出现错误的程序。它是基于 CUDA 的 MemtestG80 的 OpenCL 版本。

本项目是 MemtestCL 的开源版本，实现了与闭源版本相同的内存测试。建议将 MemtestCL 作为库使用，以便其他软件开发者能够在其代码中使用 MemtestCL 测试来验证 GPU 或加速器的正确操作。

3. 项目 API 使用文档

MemtestCL 的 API 定义在 memtestCL_core.h 文件中。API 包含两个层次：低级 API，由 memtestFunctions 类定义（这是一个围绕底层 OpenCL 核函数调用的薄包装），以及高级 API，由 memtestState 和 memtestMultiTester 类定义。最低层的测试是通过 memtestCL_kernels.cl 文件中的内核实现的。

建议使用的接口是 memtestMultiTester 类，它自动封装了特定 OCL 库中的最大每缓冲区分配等详细信息。API 使用示例可以在独立测试器 memtestCL_cli.cu 中找到。