Caffe源码中syncedmem文件分析

Caffe源码(caffe version:09868ac , date: 2015.08.15)中有一些重要文件，这里介绍下syncedmem文件。

1.      include文件：

(1)、<caffe/common.hpp>：此文件的介绍可以参考：http://blog.csdn.net/fengbingchun/article/details/54955236  ；

(2)、<caffe/util/math_functions.hpp>：此文件的介绍可以参考： http://blog.csdn.net/fengbingchun/article/details/56280708 ；

2.      内联函数CaffeMallocHost/CaffeFreeHost：

(1)、CaffeMallocHost：CPU模式下，通过调用C语言的malloc函数分配内存；

(2)、CaffeFreeHost：CPU模式下，通过调用C语言的free函数释放内存；

3.        类SyncedMemory：在主机(CPU)和设备(GPU)之间管理内存分配和数据同步，封装CPU和GPU之间数据交互操作。

<caffe/syncedmem.hpp>文件的详细介绍如下：

#ifndef CAFFE_SYNCEDMEM_HPP_
#define CAFFE_SYNCEDMEM_HPP_#include <cstdlib>#include "caffe/common.hpp"
#include "caffe/util/math_functions.hpp"namespace caffe {// If CUDA is available and in GPU mode, host memory will be allocated pinned,
// using cudaMallocHost. It avoids dynamic pinning for transfers (DMA).
// The improvement in performance seems negligible in the single GPU case,
// but might be more significant for parallel training. Most importantly,
// it improved stability for large models on many GPUs.
// CPU模式下，通过调用C语言的malloc函数分配内存
inline void CaffeMallocHost(void** ptr, size_t size) {
#ifndef CPU_ONLYif (Caffe::mode() == Caffe::GPU) {CUDA_CHECK(cudaMallocHost(ptr, size));return;}
#endif*ptr = malloc(size);CHECK(*ptr) << "host allocation of size " << size << " failed";
}// CPU模式下，通过调用C语言的free函数释放内存
inline void CaffeFreeHost(void* ptr) {
#ifndef CPU_ONLYif (Caffe::mode() == Caffe::GPU) {CUDA_CHECK(cudaFreeHost(ptr));return;}
#endiffree(ptr);
}/*** @brief Manages memory allocation and synchronization between the host (CPU)*        and device (GPU).** TODO(dox): more thorough description.*/
// 在主机(Host/CPU)和设备(Device/GPU)之间管理内存分配和数据同步，封装CPU和GPU之间数据交互操作
class SyncedMemory {public:
// 默认构造函数，简单初始化，数据状态置为UNINITIALIZEDSyncedMemory(): cpu_ptr_(NULL), gpu_ptr_(NULL), size_(0), head_(UNINITIALIZED),own_cpu_data_(false), own_gpu_data_(false), gpu_device_(-1) {}
// 带size参数的显示构造函数，并未分配内存，数据状态置为UNINITIALIZEDexplicit SyncedMemory(size_t size): cpu_ptr_(NULL), gpu_ptr_(NULL), size_(size), head_(UNINITIALIZED),own_cpu_data_(false), own_gpu_data_(false), gpu_device_(-1) {}
// 析构函数，CPU模式下，当cpu_ptr_非空并且own_cpu_data_为true时，仅会调用CaffeFreeHost函数释放内存~SyncedMemory();
// 获取CPU数据指针,数据不可更改，内部会调用to_cpu函数，在CPU模式下，数据状态为HEAD_AT_CPU，在GPU模式下，数据状态置为SYNCEDconst void* cpu_data();
// 调用CaffeFreeHost释放内存，如果own_cpu_data_为非空，则调用CaffeFreeHost释放内存，并修改CPU数据指针使其指向data，并置own_cpu_data_为false，数据状态置为HEAD_AT_CPUvoid set_cpu_data(void* data);
// 获取GPU数据指针，数据不可更改，在GPU模式下，数据状态为HEAD_AT_GPU，在CPU模式下，数据状态置为SYNCEDconst void* gpu_data();
// 在GPU模式下，内部会调用to_gpu函数，如果own_gpu_data_为非空，调用cudaFree释放显存，并修改GPU数据指针使其指向data,并置own_gpu_data_为false，在GPU模式下，数据状态置为HEAD_AT_GPUvoid set_gpu_data(void* data);
// 获取CPU数据指针，数据可更改，内部会调用to_cpu函数，数据状态置为HEAD_AT_CPUvoid* mutable_cpu_data();
// 获取GPU数据指针，数据可更改，在GPU模式下，内部会调用to_gpu函数，数据状态置为HEAD_AT_GPUvoid* mutable_gpu_data();
// SyncedHead为枚举类型，数据存放的位置，包括四种数据状态，依次为未初始化、在CPU、在GPU、已同步enum SyncedHead { UNINITIALIZED, HEAD_AT_CPU, HEAD_AT_GPU, SYNCED };
// 返回数据状态，即数据存放的位置SyncedHead head() { return head_; }
// 返回数据大小(字节)size_t size() { return size_; }#ifndef CPU_ONLY
// 异步推送数据从CPU到GPU，并置数据状态为SYNCEDvoid async_gpu_push(const cudaStream_t& stream);
#endifprivate:
// 把数据存放到CPU上，
// 如果数据状态为UNINITIALIZED，则调用CaffeMallocHost分配内存，并初始化数据内容为0，置own_cpu_data_为true，置数据状态为HEAD_AT_CPU，
// 如果数据状态为HEAD_AT_GPU，如果在GPU模式下，如果cpu_ptr_为空，则调用CaffeMallocHost分配内存，并置own_cpu_data_为true，然后则将显存数据拷贝到内存(数据同步)，并将数据状态置为SYNCED// 其它数据状态不作任何操作void to_cpu();
// 把数据存放到GPU上，仅在GPU模式作操作，在CPU模式下不作任何操作，
// 如果数据状态为UNINITIALIZED，则调用cudaMalloc分配显存，并初始化数据内容为0，置数据状态为HEAD_AT_GPU，并置own_gpu_data_为true
// 如果数据状态为HEAD_AT_CPU，如果gpu_ptr_为空，则调用cudaMalloc分配显存，并置own_gpu_data_为true，然后将内存数据拷贝到显存(数据同步)，并将数据状态置为SYNCED
// 其它数据状态不作任何操作void to_gpu();
// 指向CPU的数据指针void* cpu_ptr_;
// 指向GPU的数据指针void* gpu_ptr_;
// 数据大小(字节)size_t size_;
// 数据状态，当前数据存放的位置SyncedHead head_;
// 是否通过SyncedMemory类分配了CPU内存bool own_cpu_data_;
// 是否通过SyncedMemory类分配了GPU显存bool own_gpu_data_;
// 设备编号int gpu_device_;// 禁止使用SyncedMemory类的拷贝和赋值操作DISABLE_COPY_AND_ASSIGN(SyncedMemory);
};  // class SyncedMemory}  // namespace caffe#endif  // CAFFE_SYNCEDMEM_HPP_

测试代码如下：

int test_caffe_syncedmem()
{caffe::SyncedMemory mem(10);caffe::SyncedMemory* p_mem = new caffe::SyncedMemory(10 * sizeof(float));if (mem.head() != caffe::SyncedMemory::UNINITIALIZED ||mem.size() != 10 ||p_mem->size() != 10 * sizeof(float) ||mem.cpu_data() == nullptr ||mem.mutable_cpu_data() == nullptr ||mem.head() != caffe::SyncedMemory::HEAD_AT_CPU) {fprintf(stderr, "Error\n");return -1;}fprintf(stderr, "p_mem size: %d\n", p_mem->size());fprintf(stderr, "mem size: %d\n", mem.size());void* cpu_data = mem.mutable_cpu_data();if (mem.head() != caffe::SyncedMemory::HEAD_AT_CPU) {fprintf(stderr, "Error\n");return -1;}caffe::caffe_memset(mem.size(), 1, cpu_data);for (int i = 0; i < mem.size(); ++i) {if ((static_cast<char*>(cpu_data))[i] != 1) {fprintf(stderr, "Error\n");return -1;}}cpu_data = mem.mutable_cpu_data();if (mem.head() != caffe::SyncedMemory::HEAD_AT_CPU) {fprintf(stderr, "Error\n");return -1;}caffe::caffe_memset(mem.size(), 2, cpu_data);for (int i = 0; i < mem.size(); ++i) {if ((static_cast<char*>(cpu_data))[i] != 2) {fprintf(stderr, "Error\n");return -1;}}delete p_mem;return 0;
}

测试结果如下：

GitHub： https://github.com/fengbingchun/Caffe_Test