#include "global/signal_handler.h"
#include "common/CDC.h"
+#include <boost/program_options/variables_map.hpp>
+#include <boost/program_options/parsers.hpp>
+
using namespace std;
+namespace po = boost::program_options;
struct EstimateResult {
std::unique_ptr<CDC> cdc;
int32_t default_report_period = 10;
ceph::mutex glock = ceph::make_mutex("glock");
-void usage()
-{
- cout <<
-"usage: \n"
-" ceph-dedup-tool \n"
-" [--op estimate --pool POOL --chunk-size CHUNK_SIZE --chunk-algorithm ALGO --fingerprint-algorithm FP_ALGO] \n"
-" [--op chunk-scrub --op chunk-scrub --chunk-pool POOL] \n"
-" [--op chunk-get-ref --chunk-pool POOL --object OID --target-ref OID --target-ref-pool-id POOL_ID] \n"
-" [--op chunk-put-ref --chunk-pool POOL --object OID --target-ref OID --target-ref-pool-id POOL_ID] \n"
-" [--op chunk-repair --chunk-pool POOL --object OID --target-ref OID --target-ref-pool-id POOL_ID] \n"
-" [--op dump-chunk-refs --chunk-pool POOL --object OID] \n"
-" [--op chunk-dedup --pool POOL --object OID --chunk-pool POOL --fingerprint-algorithm FP --source-off OFFSET --source-length LENGTH] \n"
-" [--op object-dedup --pool POOL --object OID --chunk-pool POOL --fingerprint-algorithm FP --dedup-cdc-chunk-size CHUNK_SIZE] \n"
- << std::endl;
- cout << "optional arguments: " << std::endl;
- cout << " --object <object_name> " << std::endl;
- cout << " --chunk-size <size> chunk-size (byte) " << std::endl;
- cout << " --chunk-algorithm <fixed|fastcdc> " << std::endl;
- cout << " --fingerprint-algorithm <sha1|sha256|sha512> " << std::endl;
- cout << " --chunk-pool <pool name> " << std::endl;
- cout << " --max-thread <threads> " << std::endl;
- cout << " --report-period <seconds> " << std::endl;
- cout << " --max-seconds <seconds>" << std::endl;
- cout << " --max-read-size <bytes> " << std::endl;
- cout << "explanations: " << std::endl;
- cout << " chunk-dedup performs deduplication using a chunk generated by given source" << std::endl;
- cout << " offset and length. object-dedup deduplicates the entire object, not a chunk" << std::endl;
- exit(1);
+po::options_description make_usage() {
+ po::options_description desc("Usage");
+ desc.add_options()
+ ("help,h", ": produce help message")
+ ("op estimate --pool <POOL> --chunk-size <CHUNK_SIZE> --chunk-algorithm <ALGO> --fingerprint-algorithm <FP_ALGO>",
+ ": estimate how many chunks are redundant")
+ ("op chunk-scrub --chunk-pool <POOL>",
+ ": perform chunk scrub")
+ ("op chunk-get-ref --chunk-pool <POOL> --object <OID> --target-ref <OID> --target-ref-pool-id <POOL_ID>",
+ ": get chunk object's reference")
+ ("op chunk-put-ref --chunk-pool <POOL> --object <OID> --target-ref <OID> --target-ref-pool-id <POOL_ID>",
+ ": put chunk object's reference")
+ ("op chunk-repair --chunk-pool <POOL> --object <OID> --target-ref <OID> --target-ref-pool-id <POOL_ID>",
+ ": fix mismatched references")
+ ("op dump-chunk-refs --chunk-pool <POOL> --object <OID>",
+ ": dump chunk object's references")
+ ("op chunk-dedup --pool <POOL> --object <OID> --chunk-pool <POOL> --fingerprint-algorithm <FP> --source-off <OFFSET> --source-length <LENGTH>",
+ ": perform a chunk dedup---deduplicate only a chunk, which is a part of object.")
+ ("op object-dedup --pool <POOL> --object <OID> --chunk-pool <POOL> --fingerprint-algorithm <FP> --dedup-cdc-chunk-size <CHUNK_SIZE> [--snap]",
+ ": perform a object dedup---deduplicate the entire object, not a chunk. Related snapshots are also deduplicated if --snap is given")
+ ;
+ po::options_description op_desc("Opational arguments");
+ op_desc.add_options()
+ ("op", po::value<std::string>(), ": estimate|chunk-scrub|chunk-get-ref|chunk-put-ref|chunk-repair|dump-chunk-refs|chunk-dedup|object-dedup")
+ ("target-ref", po::value<std::string>(), ": set target object")
+ ("target-ref-pool-id", po::value<uint64_t>(), ": set target pool id")
+ ("object", po::value<std::string>(), ": set object name")
+ ("chunk-size", po::value<int>(), ": chunk size (byte)")
+ ("chunk-algorithm", po::value<std::string>(), ": <fixed|fastcdc>, set chunk-algorithm")
+ ("fingerprint-algorithm", po::value<std::string>(), ": <sha1|sha256|sha512>, set fingerprint-algorithm")
+ ("chunk-pool", po::value<std::string>(), ": set chunk pool name")
+ ("max-thread", po::value<int>(), ": set max thread")
+ ("report-period", po::value<int>(), ": set report-period")
+ ("max-seconds", po::value<int>(), ": set max runtime")
+ ("max-read-size", po::value<int>(), ": set max read size")
+ ("pool", po::value<std::string>(), ": set pool name")
+ ("min-chunk-size", po::value<int>(), ": min chunk size (byte)")
+ ("max-chunk-size", po::value<int>(), ": max chunk size (byte)")
+ ("source-off", po::value<uint64_t>(), ": set source offset")
+ ("source-length", po::value<uint64_t>(), ": set source length")
+ ("dedup-cdc-chunk-size", po::value<unsigned int>(), ": set dedup chunk size for cdc")
+ ("snap", ": deduplciate snapshotted object")
+ ("debug", ": enable debug")
+ ("pgid", ": set pgid")
+ ;
+ desc.add(op_desc);
+ return desc;
}
template <typename I, typename T>
}
}
-int estimate_dedup_ratio(const std::map < std::string, std::string > &opts,
- std::vector<const char*> &nargs)
+string get_opts_pool_name(const po::variables_map &opts) {
+ if (opts.count("pool")) {
+ return opts["pool"].as<string>();
+ }
+ cerr << "must specify pool name" << std::endl;
+ exit(1);
+}
+
+string get_opts_chunk_algo(const po::variables_map &opts) {
+ if (opts.count("chunk-algorithm")) {
+ string chunk_algo = opts["chunk-algorithm"].as<string>();
+ if (!CDC::create(chunk_algo, 12)) {
+ cerr << "unrecognized chunk-algorithm " << chunk_algo << std::endl;
+ exit(1);
+ }
+ return chunk_algo;
+ }
+ cerr << "must specify chunk-algorithm" << std::endl;
+ exit(1);
+}
+
+string get_opts_fp_algo(const po::variables_map &opts) {
+ if (opts.count("fingerprint-algorithm")) {
+ string fp_algo = opts["fingerprint-algorithm"].as<string>();
+ if (fp_algo != "sha1"
+ && fp_algo != "sha256" && fp_algo != "sha512") {
+ cerr << "unrecognized fingerprint-algorithm " << fp_algo << std::endl;
+ exit(1);
+ }
+ return fp_algo;
+ }
+ cout << "SHA1 is set as fingerprint algorithm by default" << std::endl;
+ return string("sha1");
+}
+
+string get_opts_op_name(const po::variables_map &opts) {
+ if (opts.count("op")) {
+ return opts["op"].as<string>();
+ } else {
+ cerr << "must specify op" << std::endl;
+ exit(1);
+ }
+}
+
+string get_opts_chunk_pool(const po::variables_map &opts) {
+ if (opts.count("chunk-pool")) {
+ return opts["chunk-pool"].as<string>();
+ } else {
+ cerr << "must specify --chunk-pool" << std::endl;
+ exit(1);
+ }
+}
+
+string get_opts_object_name(const po::variables_map &opts) {
+ if (opts.count("object")) {
+ return opts["object"].as<string>();
+ } else {
+ cerr << "must specify object" << std::endl;
+ exit(1);
+ }
+}
+
+int get_opts_max_thread(const po::variables_map &opts) {
+ if (opts.count("max-thread")) {
+ return opts["max-thread"].as<int>();
+ } else {
+ cout << "2 is set as the number of threads by default" << std::endl;
+ return 2;
+ }
+}
+
+int get_opts_report_period(const po::variables_map &opts) {
+ if (opts.count("report-period")) {
+ return opts["report-period"].as<int>();
+ } else {
+ cout << "10 seconds is set as report period by default" << std::endl;
+ return 10;
+ }
+}
+
+int estimate_dedup_ratio(const po::variables_map &opts)
{
Rados rados;
IoCtx io_ctx;
std::string chunk_algo = "fastcdc";
string fp_algo = "sha1";
string pool_name;
- uint64_t chunk_size = 0;
+ uint64_t chunk_size = 8192;
uint64_t min_chunk_size = 8192;
uint64_t max_chunk_size = 4*1024*1024;
unsigned max_thread = default_max_thread;
list<string> pool_names;
map<string, librados::pool_stat_t> stats;
- i = opts.find("pool");
- if (i != opts.end()) {
- pool_name = i->second.c_str();
- }
- i = opts.find("chunk-algorithm");
- if (i != opts.end()) {
- chunk_algo = i->second.c_str();
+ pool_name = get_opts_pool_name(opts);
+ if (opts.count("chunk-algorithm")) {
+ chunk_algo = opts["chunk-algorithm"].as<string>();
if (!CDC::create(chunk_algo, 12)) {
cerr << "unrecognized chunk-algorithm " << chunk_algo << std::endl;
exit(1);
cerr << "must specify chunk-algorithm" << std::endl;
exit(1);
}
-
- i = opts.find("fingerprint-algorithm");
- if (i != opts.end()) {
- fp_algo = i->second.c_str();
- if (fp_algo != "sha1"
- && fp_algo != "sha256" && fp_algo != "sha512") {
- cerr << "unrecognized fingerprint-algorithm " << fp_algo << std::endl;
- exit(1);
- }
- }
-
- i = opts.find("chunk-size");
- if (i != opts.end()) {
- if (rados_sistrtoll(i, &chunk_size)) {
- return -EINVAL;
- }
+ fp_algo = get_opts_fp_algo(opts);
+ if (opts.count("chunk-size")) {
+ chunk_size = opts["chunk-size"].as<int>();
+ } else {
+ cout << "8192 is set as chunk size by default" << std::endl;
}
-
- i = opts.find("min-chunk-size");
- if (i != opts.end()) {
- if (rados_sistrtoll(i, &min_chunk_size)) {
- return -EINVAL;
- }
+ if (opts.count("min-chunk-size")) {
+ chunk_size = opts["min-chunk-size"].as<int>();
+ } else {
+ cout << "8192 is set as min chunk size by default" << std::endl;
}
- i = opts.find("max-chunk-size");
- if (i != opts.end()) {
- if (rados_sistrtoll(i, &max_chunk_size)) {
- return -EINVAL;
- }
+ if (opts.count("max-chunk-size")) {
+ chunk_size = opts["max-chunk-size"].as<int>();
+ } else {
+ cout << "4MB is set as max chunk size by default" << std::endl;
}
-
- i = opts.find("max-thread");
- if (i != opts.end()) {
- if (rados_sistrtoll(i, &max_thread)) {
- return -EINVAL;
- }
- }
-
- i = opts.find("report-period");
- if (i != opts.end()) {
- if (rados_sistrtoll(i, &report_period)) {
- return -EINVAL;
- }
+ max_thread = get_opts_max_thread(opts);
+ report_period = get_opts_report_period(opts);
+ if (opts.count("max-seconds")) {
+ max_seconds = opts["max-seconds"].as<int>();
+ } else {
+ cout << "max seconds is not set" << std::endl;
}
- i = opts.find("max-seconds");
- if (i != opts.end()) {
- if (rados_sistrtoll(i, &max_seconds)) {
- return -EINVAL;
- }
+ if (opts.count("max-read-size")) {
+ max_read_size = opts["max-read-size"].as<int>();
+ } else {
+ cout << default_op_size << " is set as max-read-size by default" << std::endl;
}
- i = opts.find("max-read-size");
- if (i != opts.end()) {
- if (rados_sistrtoll(i, &max_read_size)) {
- return -EINVAL;
- }
- }
- i = opts.find("debug");
- if (i != opts.end()) {
+ if (opts.count("debug")) {
debug = true;
}
-
- i = opts.find("pgid");
- boost::optional<pg_t> pgid(i != opts.end(), pg_t());
+ boost::optional<pg_t> pgid(opts.count("pgid"), pg_t());
ret = rados.init_with_context(g_ceph_context);
if (ret < 0) {
cout << " Damaged object : " << damaged_objects << std::endl;
}
-int chunk_scrub_common(const std::map < std::string, std::string > &opts,
- std::vector<const char*> &nargs)
+int chunk_scrub_common(const po::variables_map &opts)
{
Rados rados;
IoCtx io_ctx, chunk_io_ctx;
list<string> pool_names;
map<string, librados::pool_stat_t> stats;
- i = opts.find("op_name");
- if (i != opts.end()) {
- op_name= i->second.c_str();
- } else {
- cerr << "must specify op" << std::endl;
- exit(1);
- }
-
- i = opts.find("chunk-pool");
- if (i != opts.end()) {
- chunk_pool_name = i->second.c_str();
- } else {
- cerr << "must specify --chunk-pool" << std::endl;
- exit(1);
- }
- i = opts.find("max-thread");
- if (i != opts.end()) {
- if (rados_sistrtoll(i, &max_thread)) {
- return -EINVAL;
- }
- }
- i = opts.find("report-period");
- if (i != opts.end()) {
- if (rados_sistrtoll(i, &report_period)) {
- return -EINVAL;
- }
- }
- i = opts.find("pgid");
- boost::optional<pg_t> pgid(i != opts.end(), pg_t());
+ op_name = get_opts_op_name(opts);
+ chunk_pool_name = get_opts_chunk_pool(opts);
+ max_thread = get_opts_max_thread(opts);
+ report_period = get_opts_report_period(opts);
+ boost::optional<pg_t> pgid(opts.count("pgid"), pg_t());
ret = rados.init_with_context(g_ceph_context);
if (ret < 0) {
op_name == "chunk-repair") {
string target_object_name;
uint64_t pool_id;
- i = opts.find("object");
- if (i != opts.end()) {
- object_name = i->second.c_str();
- } else {
- cerr << "must specify object" << std::endl;
- exit(1);
- }
- i = opts.find("target-ref");
- if (i != opts.end()) {
- target_object_name = i->second.c_str();
+ object_name = get_opts_object_name(opts);
+ if (opts.count("target-ref")) {
+ target_object_name = opts["target-ref"].as<string>();
} else {
cerr << "must specify target ref" << std::endl;
exit(1);
}
- i = opts.find("target-ref-pool-id");
- if (i != opts.end()) {
- if (rados_sistrtoll(i, &pool_id)) {
- return -EINVAL;
- }
+ if (opts.count("target-ref-pool-id")) {
+ pool_id = opts["target-ref-pool-id"].as<uint64_t>();
} else {
cerr << "must specify target-ref-pool-id" << std::endl;
exit(1);
return ret;
} else if (op_name == "dump-chunk-refs") {
- i = opts.find("object");
- if (i != opts.end()) {
- object_name = i->second.c_str();
- } else {
- cerr << "must specify object" << std::endl;
- exit(1);
- }
+ object_name = get_opts_object_name(opts);
bufferlist t;
ret = chunk_io_ctx.getxattr(object_name, CHUNK_REFCOUNT_ATTR, t);
if (ret < 0) {
return make_pool_str(pool, var, stringify(val));
}
-int make_dedup_object(const std::map < std::string, std::string > &opts,
- std::vector<const char*> &nargs)
+int make_dedup_object(const po::variables_map &opts)
{
Rados rados;
IoCtx io_ctx, chunk_io_ctx;
int ret;
std::map<std::string, std::string>::const_iterator i;
- i = opts.find("op_name");
- if (i != opts.end()) {
- op_name = i->second;
- } else {
- cerr << "must specify op" << std::endl;
- exit(1);
- }
- i = opts.find("pool");
- if (i != opts.end()) {
- pool_name = i->second;
- } else {
- cerr << "must specify --pool" << std::endl;
- exit(1);
- }
- i = opts.find("object");
- if (i != opts.end()) {
- object_name = i->second;
- } else {
- cerr << "must specify object" << std::endl;
- exit(1);
- }
-
- i = opts.find("chunk-pool");
- if (i != opts.end()) {
- chunk_pool_name = i->second;
- } else {
- cerr << "must specify --chunk-pool" << std::endl;
- exit(1);
- }
- i = opts.find("pgid");
- boost::optional<pg_t> pgid(i != opts.end(), pg_t());
+ op_name = get_opts_op_name(opts);
+ pool_name = get_opts_pool_name(opts);
+ object_name = get_opts_object_name(opts);
+ chunk_pool_name = get_opts_chunk_pool(opts);
+ boost::optional<pg_t> pgid(opts.count("pgid"), pg_t());
ret = rados.init_with_context(g_ceph_context);
if (ret < 0) {
<< cpp_strerror(ret) << std::endl;
goto out;
}
- i = opts.find("fingerprint-algorithm");
- if (i != opts.end()) {
- fp_algo = i->second.c_str();
- if (fp_algo != "sha1"
- && fp_algo != "sha256" && fp_algo != "sha512") {
- cerr << "unrecognized fingerprint-algorithm " << fp_algo << std::endl;
- exit(1);
- }
- }
+ fp_algo = get_opts_fp_algo(opts);
if (op_name == "chunk-dedup") {
uint64_t offset, length;
string chunk_object;
- i = opts.find("source-off");
- if (i != opts.end()) {
- if (rados_sistrtoll(i, &offset)) {
- return -EINVAL;
- }
+ if (opts.count("source-off")) {
+ offset = opts["source-off"].as<uint64_t>();
} else {
cerr << "must specify --source-off" << std::endl;
exit(1);
}
- i = opts.find("source-length");
- if (i != opts.end()) {
- if (rados_sistrtoll(i, &length)) {
- return -EINVAL;
- }
+ if (opts.count("source-length")) {
+ length = opts["source-length"].as<uint64_t>();
} else {
- cerr << "must specify --source-off" << std::endl;
+ cerr << "must specify --source-length" << std::endl;
exit(1);
}
// 1. make a copy from manifest object to chunk object
goto out;
}
} else if (op_name == "object-dedup") {
- unsigned chunk_size;
+ unsigned chunk_size = 0;
bool snap = false;
- i = opts.find("dedup-cdc-chunk-size");
- if (i != opts.end()) {
- if (rados_sistrtoll(i, &chunk_size)) {
- cerr << "unrecognized dedup_cdc_chunk_size " << chunk_size << std::endl;
- return -EINVAL;
- }
+ if (opts.count("dedup-cdc-chunk-size")) {
+ chunk_size = opts["dedup-cdc-chunk-size"].as<unsigned int>();
+ } else {
+ cerr << "must specify --dedup-cdc-chunk-size" << std::endl;
+ exit(1);
}
- i = opts.find("snap");
- if (i != opts.end()) {
+ if (opts.count("snap")) {
snap = true;
}
cerr << argv[0] << ": -h or --help for usage" << std::endl;
exit(1);
}
- if (ceph_argparse_need_usage(args)) {
- usage();
+
+ po::variables_map opts;
+ po::positional_options_description p;
+ p.add("command", 1);
+ po::options_description desc = make_usage();
+ try {
+ po::parsed_options parsed =
+ po::command_line_parser(argc, argv).options(desc).positional(p).allow_unregistered().run();
+ po::store(parsed, opts);
+ po::notify(opts);
+ } catch(po::error &e) {
+ std::cerr << e.what() << std::endl;
+ return 1;
+ }
+ if (opts.count("help") || opts.count("h")) {
+ cout<< desc << std::endl;
exit(0);
}
- std::string fn;
- string op_name;
-
auto cct = global_init(NULL, args, CEPH_ENTITY_TYPE_CLIENT,
CODE_ENVIRONMENT_UTILITY, 0);
common_init_finish(g_ceph_context);
init_async_signal_handler();
register_async_signal_handler_oneshot(SIGINT, handle_signal);
register_async_signal_handler_oneshot(SIGTERM, handle_signal);
- std::map < std::string, std::string > opts;
- std::string val;
- std::vector<const char*>::iterator i;
- for (i = args.begin(); i != args.end(); ) {
- if (ceph_argparse_double_dash(args, i)) {
- break;
- } else if (ceph_argparse_witharg(args, i, &val, "--op", (char*)NULL)) {
- opts["op_name"] = val;
- op_name = val;
- } else if (ceph_argparse_witharg(args, i, &val, "--pool", (char*)NULL)) {
- opts["pool"] = val;
- } else if (ceph_argparse_witharg(args, i, &val, "--object", (char*)NULL)) {
- opts["object"] = val;
- } else if (ceph_argparse_witharg(args, i, &val, "--chunk-algorithm", (char*)NULL)) {
- opts["chunk-algorithm"] = val;
- } else if (ceph_argparse_witharg(args, i, &val, "--chunk-size", (char*)NULL)) {
- opts["chunk-size"] = val;
- } else if (ceph_argparse_witharg(args, i, &val, "--fingerprint-algorithm", (char*)NULL)) {
- opts["fingerprint-algorithm"] = val;
- } else if (ceph_argparse_witharg(args, i, &val, "--chunk-pool", (char*)NULL)) {
- opts["chunk-pool"] = val;
- } else if (ceph_argparse_witharg(args, i, &val, "--target-ref", (char*)NULL)) {
- opts["target-ref"] = val;
- } else if (ceph_argparse_witharg(args, i, &val, "--target-ref-pool-id", (char*)NULL)) {
- opts["target-ref-pool-id"] = val;
- } else if (ceph_argparse_witharg(args, i, &val, "--max-thread", (char*)NULL)) {
- opts["max-thread"] = val;
- } else if (ceph_argparse_witharg(args, i, &val, "--report-period", (char*)NULL)) {
- opts["report-period"] = val;
- } else if (ceph_argparse_witharg(args, i, &val, "--max-read-size", (char*)NULL)) {
- opts["max-seconds"] = val;
- } else if (ceph_argparse_witharg(args, i, &val, "--max-seconds", (char*)NULL)) {
- opts["max-seconds"] = val;
- } else if (ceph_argparse_witharg(args, i, &val, "--min-chunk-size", (char*)NULL)) {
- opts["min-chunk-size"] = val;
- } else if (ceph_argparse_witharg(args, i, &val, "--max-chunk-size", (char*)NULL)) {
- opts["max-chunk-size"] = val;
- } else if (ceph_argparse_witharg(args, i, &val, "--chunk-object", (char*)NULL)) {
- opts["chunk-object"] = val;
- } else if (ceph_argparse_witharg(args, i, &val, "--source-off", (char*)NULL)) {
- opts["source-off"] = val;
- } else if (ceph_argparse_witharg(args, i, &val, "--source-length", (char*)NULL)) {
- opts["source-length"] = val;
- } else if (ceph_argparse_witharg(args, i, &val, "--dedup-cdc-chunk-size", (char*)NULL)) {
- opts["dedup-cdc-chunk-size"] = val;
- } else if (ceph_argparse_flag(args, i, "--snap", (char*)NULL)) {
- opts["snap"] = "true";
- } else if (ceph_argparse_flag(args, i, "--debug", (char*)NULL)) {
- opts["debug"] = "true";
- } else {
- if (val[0] == '-') {
- cerr << "unrecognized option " << val << std::endl;
- exit(1);
- }
- ++i;
- }
- }
+ string op_name = get_opts_op_name(opts);
if (op_name == "estimate") {
- return estimate_dedup_ratio(opts, args);
+ return estimate_dedup_ratio(opts);
} else if (op_name == "chunk-scrub" ||
op_name == "chunk-get-ref" ||
op_name == "chunk-put-ref" ||
op_name == "chunk-repair" ||
op_name == "dump-chunk-refs") {
- return chunk_scrub_common(opts, args);
+ return chunk_scrub_common(opts);
} else if (op_name == "chunk-dedup" ||
op_name == "object-dedup") {
/*
* perform deduplication on the entire object, not a chunk.
*
*/
- return make_dedup_object(opts, args);
+ return make_dedup_object(opts);
} else {
cerr << "unrecognized op " << op_name << std::endl;
exit(1);