librados: mark category args and ops as unused

Signed-off-by: Sage Weil <sage@redhat.com>

diff --git a/src/include/rados/librados.h b/src/include/rados/librados.h
index 79afe5521a166d87790a88b8fe029d496cc80560..60faa94986a953f137bce6f50aa3fba851d534e9 100644 (file)
--- a/src/include/rados/librados.h
+++ b/src/include/rados/librados.h
@@ -1993,6 +1993,7 @@ void rados_write_op_rmxattr(rados_write_op_t write_op, const char *name);
  * @param exclusive set to either LIBRADOS_CREATE_EXCLUSIVE or
    LIBRADOS_CREATE_IDEMPOTENT
  * will error if the object already exists.
+ * @param category category string (DEPRECATED, HAS NO EFFECT)
  */
 void rados_write_op_create(rados_write_op_t write_op,
                            int exclusive,

diff --git a/src/include/rados/librados.hpp b/src/include/rados/librados.hpp
index cabe63f97b5f991404b8f78994d93a9a42cad830..b97bf80ac9f665b98d9eab806a1d9cceb13bdb6f 100644 (file)
--- a/src/include/rados/librados.hpp
+++ b/src/include/rados/librados.hpp
@@ -308,7 +308,9 @@ namespace librados
     }
 
     void create(bool exclusive);
-    void create(bool exclusive, const std::string& category);
+    void create(bool exclusive,
+               const std::string& category); ///< NOTE: category is unused
+
     void write(uint64_t off, const bufferlist& bl);
     void write_full(const bufferlist& bl);
     void append(const bufferlist& bl);
@@ -584,7 +586,8 @@ namespace librados
 
     // create an object
     int create(const std::string& oid, bool exclusive);
-    int create(const std::string& oid, bool exclusive, const std::string& category);
+    int create(const std::string& oid, bool exclusive,
+              const std::string& category); ///< category is unused
 
     /**
      * write bytes to an object at a specified offset
@@ -989,6 +992,7 @@ namespace librados
     int pool_list(std::list<std::string>& v);
     int get_pool_stats(std::list<std::string>& v,
                       std::map<std::string, stats_map>& stats);
+    /// deprecated; categories no longer supported
     int get_pool_stats(std::list<std::string>& v,
                        std::string& category,
                       std::map<std::string, stats_map>& stats);