/*
* Copyright (C) 2013 Red Hat, GmbH
*
* Calculates device-mapper thin privisioning
* metadata device size based on pool, block size and
* maximum expected thin provisioned devices and snapshots.
*
* This file is part of the thin-provisioning-tools source.
*
* thin-provisioning-tools is free software: you can redistribute it
* and/or modify it under the terms of the GNU General Public License
* as published by the Free Software Foundation, either version 3 of
* the License, or (at your option) any later version.
*
* thin-provisioning-tools is distributed in the hope that it will be
* useful, but WITHOUT ANY WARRANTY; without even the implied warranty
* of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License along
* with thin-provisioning-tools. If not, see
* .
*
*/
#include
#include
#include
#include
#include
#include
#include "version.h"
/*----------------------------------------------------------------*/
enum numeric_options { BLOCKSIZE, POOLSIZE, MAXTHINS, NUMERIC, OPT_END};
enum return_units { RETURN_BYTES, RETURN_SECTORS };
struct global {
char *prg; /* program name */
struct {
char *chars;
char **strings;
unsigned long long *factors;
} unit;
struct options {
unsigned unit_idx;
char *s[OPT_END];
unsigned long long n[OPT_END];
} options;
};
static void exit_prg(struct global *g, int ret)
{
if (g)
free(g);
exit(ret);
}
static void abort_prg(struct global *g, const char *msg)
{
fprintf(stderr, "%s - %s\n", g->prg, msg);
exit_prg(g, 1);
}
static struct global *init_prg(char *prg_path)
{
unsigned u;
static char *unit_chars = "bskKmMgGtTpPeEzZyY";
static char *unit_strings[] = { "bytes", "sectors",
"kilobytes", "kibibytes", "megabytes", "mebibytes",
"gigabytes", "gibibytes", "terabytes", "tebibytes",
"petabytes", "pebibytes", "exabytes", "ebibytes",
"zetabytes", "zebibytes", "yottabytes", "yobibytes", NULL };
static unsigned long long unit_factors[18] = { 1, 512, 1024, 1000 };
struct global *r = malloc(sizeof(*r));
if (!r)
abort_prg(r, "failed to allocate global context!");
memset(r, 0, sizeof(*r));
for (u = 4; unit_strings[u]; u += 2) {
unit_factors[u] = unit_factors[u-2] * unit_factors[2];
unit_factors[u+1] = unit_factors[u-1] * unit_factors[3];
}
r->prg = basename(prg_path);
r->unit.chars = unit_chars;
r->unit.strings = unit_strings;
r->unit.factors = unit_factors;
return r;
}
#define bytes_per_sector(g) (g)->unit.factors[get_index(g, "sectors")]
static int get_index(struct global *g, char *unit_string)
{
unsigned len;
if (!unit_string)
return get_index(g, "sectors");
len = strlen(unit_string);
if (len == 1) {
char *o = strchr(g->unit.chars, *unit_string);
if (o)
return o - g->unit.chars;
} else {
char **s;
for (s = g->unit.strings; *s; s++)
if (!strncmp(*s, unit_string, len))
return s - g->unit.strings;
}
return -1;
}
static void check_opts(struct global *g)
{
struct options *o = &g->options;
if (!o->n[BLOCKSIZE] || !o->n[POOLSIZE] || !o->n[MAXTHINS])
abort_prg(g, "3 arguments required!");
else if (o->n[BLOCKSIZE] & (o->n[BLOCKSIZE] - 1))
abort_prg(g, "block size must be 2^^N");
else if (o->n[POOLSIZE] <= o->n[BLOCKSIZE])
abort_prg(g, "POOLSIZE must be larger than BLOCKSIZE");
else if (!o->n[MAXTHINS])
abort_prg(g, "maximum number of thin provisioned devices must be > 0");
}
static unsigned long long to_bytes(struct global *g, char *sz, enum return_units unit, int *index)
{
int idx;
unsigned long long r;
char *us;
for (us = sz; *us; us++) {
if (!isdigit(*us))
break;
}
if (*us) {
idx = get_index(g, us);
if (idx < 0)
abort_prg(g, "Invalid unit specifier!");
*us = 0;
*index = idx;
} else {
idx = get_index(g, NULL);
us = NULL;
*index = -1;
}
r = atoll(sz) * g->unit.factors[idx];
return (!us || unit == RETURN_SECTORS) ? r / bytes_per_sector(g) : r;
}
static void printf_aligned(struct global *g, char *a, char *b, char *c, int units)
{
char buf[80];
strcpy(buf, b);
if (units)
strcat(buf, "["), strcat(buf, g->unit.chars), strcat(buf, "]");
printf("\t%-4s%-44s%s\n", a, buf, c);
}
static void help(struct global *g)
{
printf ("Thin Provisioning Metadata Device Size Calculator.\nUsage: %s [options]\n", g->prg);
printf_aligned(g, "-b", "--block-size BLOCKSIZE", "Block size of thin provisioned devices.", 1);
printf_aligned(g, "-s", "--pool-size SIZE", "Size of pool device.", 1);
printf_aligned(g, "-m", "--max-thins #MAXTHINS", "Maximum sum of all thin devices and snapshots.", 1);
printf_aligned(g, "-u", "--unit ", "Output unit specifier.", 1);
printf_aligned(g, "-n", "--numeric-only[=unit]", "Output numeric value only (optionally with unit identifier).", 0);
printf_aligned(g, "-h", "--help", "This help.", 0);
printf_aligned(g, "-V", "--version", "Print thin provisioning tools version.", 0);
exit_prg(g, 0);
}
static void version(struct global *g)
{
printf("%s\n", THIN_PROVISIONING_TOOLS_VERSION);
exit_prg(g, 1);
}
static void check_unit(struct global *g, char *arg)
{
int idx = get_index(g, arg);
if (idx < 0)
abort_prg(g, "output unit specifier invalid!");
g->options.unit_idx = idx;
}
static void check_numeric_option(struct global *g, char *arg)
{
if (g->options.n[NUMERIC])
abort_prg(g, "-n already given!");
g->options.n[NUMERIC] = 1;
if (arg) {
if (!*arg || strncmp("unit", arg, strlen(arg)))
abort_prg(g, "-n invalid option argument");
g->options.n[NUMERIC]++;
}
}
static void check_size(struct global *g, enum numeric_options o, char *arg)
{
int idx;
if (g->options.n[o])
abort_prg(g, "option already given!");
g->options.n[o] = to_bytes(g, arg, o == MAXTHINS ? RETURN_BYTES : RETURN_SECTORS, &idx);
g->options.s[o] = malloc(strlen(arg) + ((idx > -1) ? strlen(g->unit.strings[idx]) : 0) + 1);
if (!g->options.s[o])
abort_prg(g, "failed to allocate string!");
strcpy(g->options.s[o], arg);
if (idx > -1)
strcat(g->options.s[o], g->unit.strings[idx]);
}
static void parse_command_line(struct global *g, int argc, char **argv)
{
int c;
static struct option long_options[] = {
{"block-size", required_argument, NULL, 'b' },
{"pool-size", required_argument, NULL, 's' },
{"max-thins", required_argument, NULL, 'm' },
{"unit", required_argument, NULL, 'u' },
{"numeric-only",optional_argument, NULL, 'n' },
{"help", no_argument, NULL, 'h' },
{"version", no_argument, NULL, 'V' },
{NULL, 0, NULL, 0 }
};
while ((c = getopt_long(argc, argv, "b:s:m:u:n::hV", long_options, NULL)) != -1) {
switch (c) {
case 'b':
check_size(g, BLOCKSIZE, optarg);
break;
case 's':
check_size(g, POOLSIZE, optarg);
break;
case 'm':
check_size(g, MAXTHINS, optarg);
break;
case 'u':
check_unit(g, optarg);
break;
case 'n':
check_numeric_option(g, optarg);
break;
case 'h':
help(g); /* exits */
case 'V':
version(g); /* exits */
default:
abort_prg(g, "Invalid option!");
}
}
check_opts(g);
}
static const unsigned mappings_per_block(void)
{
const struct {
const unsigned node;
const unsigned node_header;
const unsigned entry;
} btree_size = { 4096, 64, 16 };
return (btree_size.node - btree_size.node_header) / btree_size.entry;
}
static void printf_precision(struct global *g, double r, unsigned idx)
{
int full = !g->options.n[NUMERIC];
double rtrunc = truncl(r);
if (full)
printf("%s - estimated metadata area size [blocksize=%s,poolsize=%s,maxthins=%s] is ",
g->prg, g->options.s[BLOCKSIZE], g->options.s[POOLSIZE], g->options.s[MAXTHINS]);
if (r == rtrunc)
printf("%llu", (unsigned long long) r);
else
printf(r - truncl(r) < 1E-2 ? "%0.2e" : "%0.2f", r);
if (full)
printf(" %s", g->unit.strings[idx]);
else if (g->options.n[NUMERIC] > 1)
printf("%c", g->unit.chars[idx]);
putchar('\n');
}
static void print_estimated_result(struct global *g)
{
unsigned idx = g->options.unit_idx;
double r;
/* double-fold # of nodes, because they aren't fully populated in average */
r = (1.0 + (2 * g->options.n[POOLSIZE] / g->options.n[BLOCKSIZE] / mappings_per_block() + g->options.n[MAXTHINS])) * 8 * bytes_per_sector(g); /* in bytes! */
r /= g->unit.factors[idx]; /* in requested unit */
printf_precision(g, r, idx);
}
int main(int argc, char **argv)
{
struct global *g = init_prg(*argv);
parse_command_line(g, argc, argv);
print_estimated_result(g);
exit_prg(g, 0);
return 0; /* Doesn't get here... */
}