cmds-balance.c

   1 /*
   2  * This program is free software; you can redistribute it and/or
   3  * modify it under the terms of the GNU General Public
   4  * License v2 as published by the Free Software Foundation.
   5  *
   6  * This program is distributed in the hope that it will be useful,
   7  * but WITHOUT ANY WARRANTY; without even the implied warranty of
   8  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
   9  * General Public License for more details.
  10  *
  11  * You should have received a copy of the GNU General Public
  12  * License along with this program; if not, write to the
  13  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  14  * Boston, MA 021110-1307, USA.
  15  */
  16
  17 #include <stdio.h>
  18 #include <stdlib.h>
  19 #include <string.h>
  20 #include <unistd.h>
  21 #include <getopt.h>
  22 #include <sys/ioctl.h>
  23 #include <errno.h>
  24
  25 #include "kerncompat.h"
  26 #include "ctree.h"
  27 #include "ioctl.h"
  28 #include "volumes.h"
  29
  30 #include "commands.h"
  31 #include "utils.h"
  32
  33 static const char * const balance_cmd_group_usage[] = {
  34         "btrfs balance <command> [options] <path>",
  35         "btrfs balance <path>",
  36         NULL
  37 };
  38
  39 static int parse_one_profile(const char *profile, u64 *flags)
  40 {
  41         if (!strcmp(profile, "raid0")) {
  42                 *flags |= BTRFS_BLOCK_GROUP_RAID0;
  43         } else if (!strcmp(profile, "raid1")) {
  44                 *flags |= BTRFS_BLOCK_GROUP_RAID1;
  45         } else if (!strcmp(profile, "raid10")) {
  46                 *flags |= BTRFS_BLOCK_GROUP_RAID10;
  47         } else if (!strcmp(profile, "raid5")) {
  48                 *flags |= BTRFS_BLOCK_GROUP_RAID5;
  49         } else if (!strcmp(profile, "raid6")) {
  50                 *flags |= BTRFS_BLOCK_GROUP_RAID6;
  51         } else if (!strcmp(profile, "dup")) {
  52                 *flags |= BTRFS_BLOCK_GROUP_DUP;
  53         } else if (!strcmp(profile, "single")) {
  54                 *flags |= BTRFS_AVAIL_ALLOC_BIT_SINGLE;
  55         } else {
  56                 fprintf(stderr, "Unknown profile '%s'\n", profile);
  57                 return 1;
  58         }
  59
  60         return 0;
  61 }
  62
  63 static int parse_profiles(char *profiles, u64 *flags)
  64 {
  65         char *this_char;
  66         char *save_ptr = NULL; /* Satisfy static checkers */
  67
  68         for (this_char = strtok_r(profiles, "|", &save_ptr);
  69              this_char != NULL;
  70              this_char = strtok_r(NULL, "|", &save_ptr)) {
  71                 if (parse_one_profile(this_char, flags))
  72                         return 1;
  73         }
  74
  75         return 0;
  76 }
  77
  78 static int parse_u64(const char *str, u64 *result)
  79 {
  80         char *endptr;
  81         u64 val;
  82
  83         val = strtoull(str, &endptr, 10);
  84         if (*endptr)
  85                 return 1;
  86
  87         *result = val;
  88         return 0;
  89 }
  90
  91 /*
  92  * Parse range that's missing some part that can be implicit:
  93  * a..b - exact range, a can be equal to b
  94  * a..  - implicitly unbounded maximum (end == (u64)-1)
  95  * ..b  - implicitly starting at 0
  96  * a    - invalid; unclear semantics, use parse_u64 instead
  97  *
  98  * Returned values are u64, value validation and interpretation should be done
  99  * by the caller.
 100  */
 101 static int parse_range(const char *range, u64 *start, u64 *end)
 102 {
 103         char *dots;
 104         char *endptr;
 105         const char *rest;
 106         int skipped = 0;
 107
 108         dots = strstr(range, "..");
 109         if (!dots)
 110                 return 1;
 111
 112         rest = dots + 2;
 113
 114         if (!*rest) {
 115                 *end = (u64)-1;
 116                 skipped++;
 117         } else {
 118                 *end = strtoull(rest, &endptr, 10);
 119                 if (*endptr)
 120                         return 1;
 121         }
 122         if (dots == range) {
 123                 *start = 0;
 124                 skipped++;
 125         } else {
 126                 *end = strtoull(range, &endptr, 10);
 127                 if (*endptr != 0 && *endptr != '.')
 128                         return 1;
 129         }
 130
 131         if (*start > *end) {
 132                 fprintf(stderr,
 133                         "ERROR: range %llu..%llu doesn't make sense\n",
 134                         (unsigned long long)*start,
 135                         (unsigned long long)*end);
 136                 return 1;
 137         }
 138
 139         if (skipped <= 1)
 140                 return 0;
 141
 142         return 1;
 143 }
 144
 145 /*
 146  * Parse range and check if start < end
 147  */
 148 static int parse_range_strict(const char *range, u64 *start, u64 *end)
 149 {
 150         if (parse_range(range, start, end) == 0) {
 151                 if (*start >= *end) {
 152                         fprintf(stderr,
 153                                 "ERROR: range %llu..%llu not allowed\n",
 154                                 (unsigned long long)*start,
 155                                 (unsigned long long)*end);
 156                         return 1;
 157                 }
 158                 return 0;
 159         }
 160
 161         return 1;
 162 }
 163
 164 /*
 165  * Convert 64bit range to 32bit with boundary checkso
 166  */
 167 static int range_to_u32(u64 start, u64 end, u32 *start32, u32 *end32)
 168 {
 169         if (start > (u32)-1)
 170                 return 1;
 171
 172         if (end != (u64)-1 && end > (u32)-1)
 173                 return 1;
 174
 175         *start32 = (u32)start;
 176         *end32 = (u32)end;
 177
 178         return 0;
 179 }
 180
 181 __attribute__ ((unused))
 182 static int parse_range_u32(const char *range, u32 *start, u32 *end)
 183 {
 184         u64 tmp_start;
 185         u64 tmp_end;
 186
 187         if (parse_range(range, &tmp_start, &tmp_end))
 188                 return 1;
 189
 190         if (range_to_u32(tmp_start, tmp_end, start, end))
 191                 return 1;
 192
 193         return 0;
 194 }
 195
 196 __attribute__ ((unused))
 197 static void print_range(u64 start, u64 end)
 198 {
 199         if (start)
 200                 printf("%llu", (unsigned long long)start);
 201         printf("..");
 202         if (end != (u64)-1)
 203                 printf("%llu", (unsigned long long)end);
 204 }
 205
 206 __attribute__ ((unused))
 207 static void print_range_u32(u32 start, u32 end)
 208 {
 209         if (start)
 210                 printf("%u", start);
 211         printf("..");
 212         if (end != (u32)-1)
 213                 printf("%u", end);
 214 }
 215
 216 static int parse_filters(char *filters, struct btrfs_balance_args *args)
 217 {
 218         char *this_char;
 219         char *value;
 220         char *save_ptr = NULL; /* Satisfy static checkers */
 221
 222         if (!filters)
 223                 return 0;
 224
 225         for (this_char = strtok_r(filters, ",", &save_ptr);
 226              this_char != NULL;
 227              this_char = strtok_r(NULL, ",", &save_ptr)) {
 228                 if ((value = strchr(this_char, '=')) != NULL)
 229                         *value++ = 0;
 230                 if (!strcmp(this_char, "profiles")) {
 231                         if (!value || !*value) {
 232                                 fprintf(stderr, "the profiles filter requires "
 233                                        "an argument\n");
 234                                 return 1;
 235                         }
 236                         if (parse_profiles(value, &args->profiles)) {
 237                                 fprintf(stderr, "Invalid profiles argument\n");
 238                                 return 1;
 239                         }
 240                         args->flags |= BTRFS_BALANCE_ARGS_PROFILES;
 241                 } else if (!strcmp(this_char, "usage")) {
 242                         if (!value || !*value) {
 243                                 fprintf(stderr, "the usage filter requires "
 244                                        "an argument\n");
 245                                 return 1;
 246                         }
 247                         if (parse_u64(value, &args->usage) ||
 248                             args->usage > 100) {
 249                                 fprintf(stderr, "Invalid usage argument: %s\n",
 250                                        value);
 251                                 return 1;
 252                         }
 253                         args->flags |= BTRFS_BALANCE_ARGS_USAGE;
 254                 } else if (!strcmp(this_char, "devid")) {
 255                         if (!value || !*value) {
 256                                 fprintf(stderr, "the devid filter requires "
 257                                        "an argument\n");
 258                                 return 1;
 259                         }
 260                         if (parse_u64(value, &args->devid) ||
 261                             args->devid == 0) {
 262                                 fprintf(stderr, "Invalid devid argument: %s\n",
 263                                        value);
 264                                 return 1;
 265                         }
 266                         args->flags |= BTRFS_BALANCE_ARGS_DEVID;
 267                 } else if (!strcmp(this_char, "drange")) {
 268                         if (!value || !*value) {
 269                                 fprintf(stderr, "the drange filter requires "
 270                                        "an argument\n");
 271                                 return 1;
 272                         }
 273                         if (parse_range_strict(value, &args->pstart, &args->pend)) {
 274                                 fprintf(stderr, "Invalid drange argument\n");
 275                                 return 1;
 276                         }
 277                         args->flags |= BTRFS_BALANCE_ARGS_DRANGE;
 278                 } else if (!strcmp(this_char, "vrange")) {
 279                         if (!value || !*value) {
 280                                 fprintf(stderr, "the vrange filter requires "
 281                                        "an argument\n");
 282                                 return 1;
 283                         }
 284                         if (parse_range_strict(value, &args->vstart, &args->vend)) {
 285                                 fprintf(stderr, "Invalid vrange argument\n");
 286                                 return 1;
 287                         }
 288                         args->flags |= BTRFS_BALANCE_ARGS_VRANGE;
 289                 } else if (!strcmp(this_char, "convert")) {
 290                         if (!value || !*value) {
 291                                 fprintf(stderr, "the convert option requires "
 292                                        "an argument\n");
 293                                 return 1;
 294                         }
 295                         if (parse_one_profile(value, &args->target)) {
 296                                 fprintf(stderr, "Invalid convert argument\n");
 297                                 return 1;
 298                         }
 299                         args->flags |= BTRFS_BALANCE_ARGS_CONVERT;
 300                 } else if (!strcmp(this_char, "soft")) {
 301                         args->flags |= BTRFS_BALANCE_ARGS_SOFT;
 302                 } else if (!strcmp(this_char, "limit")) {
 303                         if (!value || !*value) {
 304                                 fprintf(stderr,
 305                                         "the limit filter requires an argument\n");
 306                                 return 1;
 307                         }
 308                         if (parse_u64(value, &args->limit)) {
 309                                 fprintf(stderr, "Invalid limit argument: %s\n",
 310                                        value);
 311                                 return 1;
 312                         }
 313                         args->flags |= BTRFS_BALANCE_ARGS_LIMIT;
 314                 } else {
 315                         fprintf(stderr, "Unrecognized balance option '%s'\n",
 316                                 this_char);
 317                         return 1;
 318                 }
 319         }
 320
 321         return 0;
 322 }
 323
 324 static void dump_balance_args(struct btrfs_balance_args *args)
 325 {
 326         if (args->flags & BTRFS_BALANCE_ARGS_CONVERT) {
 327                 printf("converting, target=%llu, soft is %s",
 328                        (unsigned long long)args->target,
 329                        (args->flags & BTRFS_BALANCE_ARGS_SOFT) ? "on" : "off");
 330         } else {
 331                 printf("balancing");
 332         }
 333
 334         if (args->flags & BTRFS_BALANCE_ARGS_PROFILES)
 335                 printf(", profiles=%llu", (unsigned long long)args->profiles);
 336         if (args->flags & BTRFS_BALANCE_ARGS_USAGE)
 337                 printf(", usage=%llu", (unsigned long long)args->usage);
 338         if (args->flags & BTRFS_BALANCE_ARGS_DEVID)
 339                 printf(", devid=%llu", (unsigned long long)args->devid);
 340         if (args->flags & BTRFS_BALANCE_ARGS_DRANGE)
 341                 printf(", drange=%llu..%llu",
 342                        (unsigned long long)args->pstart,
 343                        (unsigned long long)args->pend);
 344         if (args->flags & BTRFS_BALANCE_ARGS_VRANGE)
 345                 printf(", vrange=%llu..%llu",
 346                        (unsigned long long)args->vstart,
 347                        (unsigned long long)args->vend);
 348         if (args->flags & BTRFS_BALANCE_ARGS_LIMIT)
 349                 printf(", limit=%llu", (unsigned long long)args->limit);
 350         if (args->flags & BTRFS_BALANCE_ARGS_LIMIT_RANGE) {
 351                 printf(", limit=");
 352                 print_range_u32(args->limit_min, args->limit_max);
 353         }
 354
 355         printf("\n");
 356 }
 357
 358 static void dump_ioctl_balance_args(struct btrfs_ioctl_balance_args *args)
 359 {
 360         printf("Dumping filters: flags 0x%llx, state 0x%llx, force is %s\n",
 361                (unsigned long long)args->flags, (unsigned long long)args->state,
 362                (args->flags & BTRFS_BALANCE_FORCE) ? "on" : "off");
 363         if (args->flags & BTRFS_BALANCE_DATA) {
 364                 printf("  DATA (flags 0x%llx): ",
 365                        (unsigned long long)args->data.flags);
 366                 dump_balance_args(&args->data);
 367         }
 368         if (args->flags & BTRFS_BALANCE_METADATA) {
 369                 printf("  METADATA (flags 0x%llx): ",
 370                        (unsigned long long)args->meta.flags);
 371                 dump_balance_args(&args->meta);
 372         }
 373         if (args->flags & BTRFS_BALANCE_SYSTEM) {
 374                 printf("  SYSTEM (flags 0x%llx): ",
 375                        (unsigned long long)args->sys.flags);
 376                 dump_balance_args(&args->sys);
 377         }
 378 }
 379
 380 static int do_balance_v1(int fd)
 381 {
 382         struct btrfs_ioctl_vol_args args;
 383         int ret;
 384
 385         memset(&args, 0, sizeof(args));
 386         ret = ioctl(fd, BTRFS_IOC_BALANCE, &args);
 387         return ret;
 388 }
 389
 390 static int do_balance(const char *path, struct btrfs_ioctl_balance_args *args,
 391                       int nofilters)
 392 {
 393         int fd;
 394         int ret;
 395         int e;
 396         DIR *dirstream = NULL;
 397
 398         fd = btrfs_open_dir(path, &dirstream, 1);
 399         if (fd < 0)
 400                 return 1;
 401
 402         ret = ioctl(fd, BTRFS_IOC_BALANCE_V2, args);
 403         e = errno;
 404
 405         if (ret < 0) {
 406                 /*
 407                  * older kernels don't have the new balance ioctl, try the
 408                  * old one.  But, the old one doesn't know any filters, so
 409                  * don't fall back if they tried to use the fancy new things
 410                  */
 411                 if (e == ENOTTY && nofilters) {
 412                         ret = do_balance_v1(fd);
 413                         if (ret == 0)
 414                                 goto out;
 415                         e = errno;
 416                 }
 417
 418                 if (e == ECANCELED) {
 419                         if (args->state & BTRFS_BALANCE_STATE_PAUSE_REQ)
 420                                 fprintf(stderr, "balance paused by user\n");
 421                         if (args->state & BTRFS_BALANCE_STATE_CANCEL_REQ)
 422                                 fprintf(stderr, "balance canceled by user\n");
 423                         ret = 0;
 424                 } else {
 425                         fprintf(stderr, "ERROR: error during balancing '%s' "
 426                                 "- %s\n", path, strerror(e));
 427                         if (e != EINPROGRESS)
 428                                 fprintf(stderr, "There may be more info in "
 429                                         "syslog - try dmesg | tail\n");
 430                         ret = 1;
 431                 }
 432         } else {
 433                 printf("Done, had to relocate %llu out of %llu chunks\n",
 434                        (unsigned long long)args->stat.completed,
 435                        (unsigned long long)args->stat.considered);
 436                 ret = 0;
 437         }
 438
 439 out:
 440         close_file_or_dir(fd, dirstream);
 441         return ret;
 442 }
 443
 444 static const char * const cmd_balance_start_usage[] = {
 445         "btrfs balance start [options] <path>",
 446         "Balance chunks across the devices",
 447         "Balance and/or convert (change allocation profile of) chunks that",
 448         "passed all filters in a comma-separated list of filters for a",
 449         "particular chunk type.  If filter list is not given balance all",
 450         "chunks of that type.  In case none of the -d, -m or -s options is",
 451         "given balance all chunks in a filesystem.",
 452         "",
 453         "-d[filters]    act on data chunks",
 454         "-m[filters]    act on metadata chunks",
 455         "-s[filters]    act on system chunks (only under -f)",
 456         "-v             be verbose",
 457         "-f             force reducing of metadata integrity",
 458         NULL
 459 };
 460
 461 static int cmd_balance_start(int argc, char **argv)
 462 {
 463         struct btrfs_ioctl_balance_args args;
 464         struct btrfs_balance_args *ptrs[] = { &args.data, &args.sys,
 465                                                 &args.meta, NULL };
 466         int force = 0;
 467         int verbose = 0;
 468         int nofilters = 1;
 469         int i;
 470
 471         memset(&args, 0, sizeof(args));
 472
 473         optind = 1;
 474         while (1) {
 475                 static const struct option longopts[] = {
 476                         { "data", optional_argument, NULL, 'd'},
 477                         { "metadata", optional_argument, NULL, 'm' },
 478                         { "system", optional_argument, NULL, 's' },
 479                         { "force", no_argument, NULL, 'f' },
 480                         { "verbose", no_argument, NULL, 'v' },
 481                         { NULL, 0, NULL, 0 }
 482                 };
 483
 484                 int opt = getopt_long(argc, argv, "d::s::m::fv", longopts, NULL);
 485                 if (opt < 0)
 486                         break;
 487
 488                 switch (opt) {
 489                 case 'd':
 490                         nofilters = 0;
 491                         args.flags |= BTRFS_BALANCE_DATA;
 492
 493                         if (parse_filters(optarg, &args.data))
 494                                 return 1;
 495                         break;
 496                 case 's':
 497                         nofilters = 0;
 498                         args.flags |= BTRFS_BALANCE_SYSTEM;
 499
 500                         if (parse_filters(optarg, &args.sys))
 501                                 return 1;
 502                         break;
 503                 case 'm':
 504                         nofilters = 0;
 505                         args.flags |= BTRFS_BALANCE_METADATA;
 506
 507                         if (parse_filters(optarg, &args.meta))
 508                                 return 1;
 509                         break;
 510                 case 'f':
 511                         force = 1;
 512                         break;
 513                 case 'v':
 514                         verbose = 1;
 515                         break;
 516                 default:
 517                         usage(cmd_balance_start_usage);
 518                 }
 519         }
 520
 521         if (check_argc_exact(argc - optind, 1))
 522                 usage(cmd_balance_start_usage);
 523
 524         /*
 525          * allow -s only under --force, otherwise do with system chunks
 526          * the same thing we were ordered to do with meta chunks
 527          */
 528         if (args.flags & BTRFS_BALANCE_SYSTEM) {
 529                 if (!force) {
 530                         fprintf(stderr,
 531 "Refusing to explicitly operate on system chunks.\n"
 532 "Pass --force if you really want to do that.\n");
 533                         return 1;
 534                 }
 535         } else if (args.flags & BTRFS_BALANCE_METADATA) {
 536                 args.flags |= BTRFS_BALANCE_SYSTEM;
 537                 memcpy(&args.sys, &args.meta,
 538                         sizeof(struct btrfs_balance_args));
 539         }
 540
 541         if (nofilters) {
 542                 /* relocate everything - no filters */
 543                 args.flags |= BTRFS_BALANCE_TYPE_MASK;
 544         }
 545
 546         /* drange makes sense only when devid is set */
 547         for (i = 0; ptrs[i]; i++) {
 548                 if ((ptrs[i]->flags & BTRFS_BALANCE_ARGS_DRANGE) &&
 549                     !(ptrs[i]->flags & BTRFS_BALANCE_ARGS_DEVID)) {
 550                         fprintf(stderr, "drange filter can be used only if "
 551                                 "devid filter is used\n");
 552                         return 1;
 553                 }
 554         }
 555
 556         /* soft makes sense only when convert for corresponding type is set */
 557         for (i = 0; ptrs[i]; i++) {
 558                 if ((ptrs[i]->flags & BTRFS_BALANCE_ARGS_SOFT) &&
 559                     !(ptrs[i]->flags & BTRFS_BALANCE_ARGS_CONVERT)) {
 560                         fprintf(stderr, "'soft' option can be used only if "
 561                                 "changing profiles\n");
 562                         return 1;
 563                 }
 564         }
 565
 566         if (force)
 567                 args.flags |= BTRFS_BALANCE_FORCE;
 568         if (verbose)
 569                 dump_ioctl_balance_args(&args);
 570
 571         return do_balance(argv[optind], &args, nofilters);
 572 }
 573
 574 static const char * const cmd_balance_pause_usage[] = {
 575         "btrfs balance pause <path>",
 576         "Pause running balance",
 577         NULL
 578 };
 579
 580 static int cmd_balance_pause(int argc, char **argv)
 581 {
 582         const char *path;
 583         int fd;
 584         int ret;
 585         int e;
 586         DIR *dirstream = NULL;
 587
 588         if (check_argc_exact(argc, 2))
 589                 usage(cmd_balance_pause_usage);
 590
 591         path = argv[1];
 592
 593         fd = btrfs_open_dir(path, &dirstream, 1);
 594         if (fd < 0)
 595                 return 1;
 596
 597         ret = ioctl(fd, BTRFS_IOC_BALANCE_CTL, BTRFS_BALANCE_CTL_PAUSE);
 598         e = errno;
 599         close_file_or_dir(fd, dirstream);
 600
 601         if (ret < 0) {
 602                 fprintf(stderr, "ERROR: balance pause on '%s' failed - %s\n",
 603                         path, (e == ENOTCONN) ? "Not running" : strerror(e));
 604                 if (e == ENOTCONN)
 605                         return 2;
 606                 else
 607                         return 1;
 608         }
 609
 610         return 0;
 611 }
 612
 613 static const char * const cmd_balance_cancel_usage[] = {
 614         "btrfs balance cancel <path>",
 615         "Cancel running or paused balance",
 616         NULL
 617 };
 618
 619 static int cmd_balance_cancel(int argc, char **argv)
 620 {
 621         const char *path;
 622         int fd;
 623         int ret;
 624         int e;
 625         DIR *dirstream = NULL;
 626
 627         if (check_argc_exact(argc, 2))
 628                 usage(cmd_balance_cancel_usage);
 629
 630         path = argv[1];
 631
 632         fd = btrfs_open_dir(path, &dirstream, 1);
 633         if (fd < 0)
 634                 return 1;
 635
 636         ret = ioctl(fd, BTRFS_IOC_BALANCE_CTL, BTRFS_BALANCE_CTL_CANCEL);
 637         e = errno;
 638         close_file_or_dir(fd, dirstream);
 639
 640         if (ret < 0) {
 641                 fprintf(stderr, "ERROR: balance cancel on '%s' failed - %s\n",
 642                         path, (e == ENOTCONN) ? "Not in progress" : strerror(e));
 643                 if (e == ENOTCONN)
 644                         return 2;
 645                 else
 646                         return 1;
 647         }
 648
 649         return 0;
 650 }
 651
 652 static const char * const cmd_balance_resume_usage[] = {
 653         "btrfs balance resume <path>",
 654         "Resume interrupted balance",
 655         NULL
 656 };
 657
 658 static int cmd_balance_resume(int argc, char **argv)
 659 {
 660         struct btrfs_ioctl_balance_args args;
 661         const char *path;
 662         DIR *dirstream = NULL;
 663         int fd;
 664         int ret;
 665         int e;
 666
 667         if (check_argc_exact(argc, 2))
 668                 usage(cmd_balance_resume_usage);
 669
 670         path = argv[1];
 671
 672         fd = btrfs_open_dir(path, &dirstream, 1);
 673         if (fd < 0)
 674                 return 1;
 675
 676         memset(&args, 0, sizeof(args));
 677         args.flags |= BTRFS_BALANCE_RESUME;
 678
 679         ret = ioctl(fd, BTRFS_IOC_BALANCE_V2, &args);
 680         e = errno;
 681         close_file_or_dir(fd, dirstream);
 682
 683         if (ret < 0) {
 684                 if (e == ECANCELED) {
 685                         if (args.state & BTRFS_BALANCE_STATE_PAUSE_REQ)
 686                                 fprintf(stderr, "balance paused by user\n");
 687                         if (args.state & BTRFS_BALANCE_STATE_CANCEL_REQ)
 688                                 fprintf(stderr, "balance canceled by user\n");
 689                 } else if (e == ENOTCONN || e == EINPROGRESS) {
 690                         fprintf(stderr, "ERROR: balance resume on '%s' "
 691                                 "failed - %s\n", path,
 692                                 (e == ENOTCONN) ? "Not in progress" :
 693                                                   "Already running");
 694                         if (e == ENOTCONN)
 695                                 return 2;
 696                         else
 697                                 return 1;
 698                 } else {
 699                         fprintf(stderr,
 700 "ERROR: error during balancing '%s' - %s\n"
 701 "There may be more info in syslog - try dmesg | tail\n", path, strerror(e));
 702                         return 1;
 703                 }
 704         } else {
 705                 printf("Done, had to relocate %llu out of %llu chunks\n",
 706                        (unsigned long long)args.stat.completed,
 707                        (unsigned long long)args.stat.considered);
 708         }
 709
 710         return 0;
 711 }
 712
 713 static const char * const cmd_balance_status_usage[] = {
 714         "btrfs balance status [-v] <path>",
 715         "Show status of running or paused balance",
 716         "",
 717         "-v     be verbose",
 718         NULL
 719 };
 720
 721 /* Checks the status of the balance if any
 722  * return codes:
 723  *   2 : Error failed to know if there is any pending balance
 724  *   1 : Successful to know status of a pending balance
 725  *   0 : When there is no pending balance or completed
 726  */
 727 static int cmd_balance_status(int argc, char **argv)
 728 {
 729         struct btrfs_ioctl_balance_args args;
 730         const char *path;
 731         DIR *dirstream = NULL;
 732         int fd;
 733         int verbose = 0;
 734         int ret;
 735         int e;
 736
 737         optind = 1;
 738         while (1) {
 739                 int opt;
 740                 static const struct option longopts[] = {
 741                         { "verbose", no_argument, NULL, 'v' },
 742                         { NULL, 0, NULL, 0 }
 743                 };
 744
 745                 opt = getopt_long(argc, argv, "v", longopts, NULL);
 746                 if (opt < 0)
 747                         break;
 748
 749                 switch (opt) {
 750                 case 'v':
 751                         verbose = 1;
 752                         break;
 753                 default:
 754                         usage(cmd_balance_status_usage);
 755                 }
 756         }
 757
 758         if (check_argc_exact(argc - optind, 1))
 759                 usage(cmd_balance_status_usage);
 760
 761         path = argv[optind];
 762
 763         fd = btrfs_open_dir(path, &dirstream, 1);
 764         if (fd < 0)
 765                 return 2;
 766
 767         ret = ioctl(fd, BTRFS_IOC_BALANCE_PROGRESS, &args);
 768         e = errno;
 769         close_file_or_dir(fd, dirstream);
 770
 771         if (ret < 0) {
 772                 if (e == ENOTCONN) {
 773                         printf("No balance found on '%s'\n", path);
 774                         return 0;
 775                 }
 776                 fprintf(stderr, "ERROR: balance status on '%s' failed - %s\n",
 777                         path, strerror(e));
 778                 return 2;
 779         }
 780
 781         if (args.state & BTRFS_BALANCE_STATE_RUNNING) {
 782                 printf("Balance on '%s' is running", path);
 783                 if (args.state & BTRFS_BALANCE_STATE_CANCEL_REQ)
 784                         printf(", cancel requested\n");
 785                 else if (args.state & BTRFS_BALANCE_STATE_PAUSE_REQ)
 786                         printf(", pause requested\n");
 787                 else
 788                         printf("\n");
 789         } else {
 790                 printf("Balance on '%s' is paused\n", path);
 791         }
 792
 793         printf("%llu out of about %llu chunks balanced (%llu considered), "
 794                "%3.f%% left\n", (unsigned long long)args.stat.completed,
 795                (unsigned long long)args.stat.expected,
 796                (unsigned long long)args.stat.considered,
 797                100 * (1 - (float)args.stat.completed/args.stat.expected));
 798
 799         if (verbose)
 800                 dump_ioctl_balance_args(&args);
 801
 802         return 1;
 803 }
 804
 805 static const char balance_cmd_group_info[] =
 806 "balance data accross devices, or change block groups using filters";
 807
 808 const struct cmd_group balance_cmd_group = {
 809         balance_cmd_group_usage, balance_cmd_group_info, {
 810                 { "start", cmd_balance_start, cmd_balance_start_usage, NULL, 0 },
 811                 { "pause", cmd_balance_pause, cmd_balance_pause_usage, NULL, 0 },
 812                 { "cancel", cmd_balance_cancel, cmd_balance_cancel_usage, NULL, 0 },
 813                 { "resume", cmd_balance_resume, cmd_balance_resume_usage, NULL, 0 },
 814                 { "status", cmd_balance_status, cmd_balance_status_usage, NULL, 0 },
 815                 NULL_CMD_STRUCT
 816         }
 817 };
 818
 819 int cmd_balance(int argc, char **argv)
 820 {
 821         if (argc == 2) {
 822                 /* old 'btrfs filesystem balance <path>' syntax */
 823                 struct btrfs_ioctl_balance_args args;
 824
 825                 memset(&args, 0, sizeof(args));
 826                 args.flags |= BTRFS_BALANCE_TYPE_MASK;
 827
 828                 return do_balance(argv[1], &args, 1);
 829         }
 830
 831         return handle_command_group(&balance_cmd_group, argc, argv);
 832 }