========
Refcount
========


Introduction
============

Deduplication, as described in ../deduplication.rst, needs a way to
maintain a target pool of deduplicated chunks with atomic ref
refcounting.  To that end, there exists an osd object class 
refcount responsible for using the object class machinery to
maintain refcounts on deduped chunks and ultimately remove them
as the refcount hits 0.

Class Interface
===============

See cls/refcount/cls_refcount_client*

* cls_refcount_get

  Atomically increments the refcount with specified tag ::

    void cls_refcount_get(librados::ObjectWriteOperation& op, const string& tag, bool implicit_ref = false);

* cls_refcount_put

  Atomically decrements the refcount specified by passed tag ::

    void cls_refcount_put(librados::ObjectWriteOperation& op, const string& tag, bool implicit_ref = false);

* cls_refcount_Set

  Atomically sets the set of refcounts with passed list of tags ::

    void cls_refcount_set(librados::ObjectWriteOperation& op, list<string>& refs);

* cls_refcount_read

  Dumps the current set of ref tags for the object ::

    int cls_refcount_read(librados::IoCtx& io_ctx, string& oid, list<string> *refs, bool implicit_ref = false);