librbd

librbd是ceph 对外提供的块存储接口，这个接口了c/c++ 两种接口，接口提供的头文件分别在ceph-master\ceph-master\src\include\rbd\librbd.hpp和source\ceph-master\ceph-master\src\include\rbd\librbd.h中
这里我们以提供的c++为例，
namespace librbd {
  using librados::IoCtx;
class CEPH_RBD_API RBD
{
#创建，删除,clone镜像等操作
  int create(IoCtx& io_ctx, const char *name, uint64_t size, int *order);
  int clone(IoCtx& p_ioctx, const char *p_name, const char *p_snapname,
	       IoCtx& c_ioctx, const char *c_name, uint64_t features,
	       int *c_order);
   // RBD pool mirroring support functions
  int mirror_mode_get(IoCtx& io_ctx, rbd_mirror_mode_t *mirror_mode);
 };

class CEPH_RBD_API Image
{
#主要是镜像的读写操作
  int snap_list(std::vector<snap_info_t>& snaps);
  /* DEPRECATED; use snap_exists2 */
  bool snap_exists(const char *snapname) __attribute__ ((deprecated));
  int snap_exists2(const char *snapname, bool *exists);
  int snap_create(const char *snapname);
  int snap_remove(const char *snapname);
  int snap_remove2(const char *snapname, uint32_t flags, ProgressContext& pctx);
}
从这里和容易看出librbd对外提供了一个namspace。这样我们使用using librbd就可以使用linrbd提供的函数
其次在这个namespace 中使用了librados中的ioctx，从这里可以看出librbd是在librados之上的
在libedb中只要提供了两个class，分别是rbd 和 image.
这两个类的实现都在ceph-master\ceph-master\src\librbd\librbd.cc 中
我们来看看rbd中的open函数
 int RBD::open(IoCtx& io_ctx, Image& image, const char *name,
		const char *snap_name)
  {
  #新建一个ImageCtx
    ImageCtx *ictx = new ImageCtx(name, "", snap_name, io_ctx, false);
    TracepointProvider::initialize<tracepoint_traits>(get_cct(io_ctx));
    tracepoint(librbd, open_image_enter, ictx, ictx->name.c_str(), ictx->id.c_str(), ictx->snap_name.c_str(), ictx->read_only);
	#如果形参image.ctx不为null，说明上一次可能没有调用close函数，这里首先会调用close函数将其关闭
    if (image.ctx != NULL) {
      reinterpret_cast<ImageCtx*>(image.ctx)->state->close();
      image.ctx = NULL;
    }
	#走到这里的话image.ctx 已经为null了，这里通过新建的Imagectx来重新open
    int r = ictx->state->open(false);
    if (r < 0) {
      tracepoint(librbd, open_image_exit, r);
      return r;
    }
	#将新建且已经打开的ictx 赋值给image.ctx
    image.ctx = (image_ctx_t) ictx;
    tracepoint(librbd, open_image_exit, 0);
    return 0;
  }
 从这里可以知道rbd class的open函数主要是给image类的ctx赋值，这个值是一个ImageCtx类型