btrfs-progs: Doc: Fix format error in btrfs-send
[btrfs-progs-unstable/devel.git] / cmds-qgroup.c
bloba3bc939a961be85b09280eeeaa828b36e78eff75
1 /*
2 * Copyright (C) 2012 STRATO. All rights reserved.
4 * This program is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU General Public
6 * License v2 as published by the Free Software Foundation.
8 * This program is distributed in the hope that it will be useful,
9 * but WITHOUT ANY WARRANTY; without even the implied warranty of
10 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
11 * General Public License for more details.
13 * You should have received a copy of the GNU General Public
14 * License along with this program; if not, write to the
15 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
16 * Boston, MA 021110-1307, USA.
19 #include <sys/ioctl.h>
20 #include <unistd.h>
21 #include <getopt.h>
23 #include "ctree.h"
24 #include "ioctl.h"
26 #include "commands.h"
27 #include "qgroup.h"
28 #include "utils.h"
30 static const char * const qgroup_cmd_group_usage[] = {
31 "btrfs qgroup <command> [options] <path>",
32 NULL
35 static int _cmd_qgroup_assign(int assign, int argc, char **argv,
36 const char * const *usage_str)
38 int ret = 0;
39 int fd;
40 int rescan = 0;
41 char *path;
42 struct btrfs_ioctl_qgroup_assign_args args;
43 DIR *dirstream = NULL;
45 if (assign) {
46 while (1) {
47 enum { GETOPT_VAL_RESCAN = 256, GETOPT_VAL_NO_RESCAN };
48 static const struct option long_options[] = {
49 { "rescan", no_argument, NULL,
50 GETOPT_VAL_RESCAN },
51 { "no-rescan", no_argument, NULL,
52 GETOPT_VAL_NO_RESCAN },
53 { NULL, 0, NULL, 0 }
55 int c = getopt_long(argc, argv, "", long_options, NULL);
57 if (c < 0)
58 break;
59 switch (c) {
60 case GETOPT_VAL_RESCAN:
61 rescan = 1;
62 break;
63 case GETOPT_VAL_NO_RESCAN:
64 rescan = 0;
65 break;
66 default:
67 /* Usage printed by the caller */
68 return -1;
71 } else {
72 clean_args_no_options(argc, argv, usage_str);
75 if (check_argc_exact(argc - optind, 3))
76 usage(usage_str);
78 memset(&args, 0, sizeof(args));
79 args.assign = assign;
80 args.src = parse_qgroupid(argv[optind]);
81 args.dst = parse_qgroupid(argv[optind + 1]);
83 path = argv[optind + 2];
86 * FIXME src should accept subvol path
88 if (btrfs_qgroup_level(args.src) >= btrfs_qgroup_level(args.dst)) {
89 error("bad relation requested: %s", path);
90 return 1;
92 fd = btrfs_open_dir(path, &dirstream, 1);
93 if (fd < 0)
94 return 1;
96 ret = ioctl(fd, BTRFS_IOC_QGROUP_ASSIGN, &args);
97 if (ret < 0) {
98 error("unable to assign quota group: %s", strerror(errno));
99 close_file_or_dir(fd, dirstream);
100 return 1;
104 * If ret > 0, it means assign caused qgroup data inconsistent state.
105 * Schedule a quota rescan if requested.
107 * The return value change only happens in newer kernel. But will not
108 * cause problem since old kernel has a bug that will never clear
109 * INCONSISTENT bit.
111 if (ret > 0) {
112 if (rescan) {
113 struct btrfs_ioctl_quota_rescan_args qargs;
115 printf("Quota data changed, rescan scheduled\n");
116 memset(&qargs, 0, sizeof(qargs));
117 ret = ioctl(fd, BTRFS_IOC_QUOTA_RESCAN, &qargs);
118 if (ret < 0)
119 error("quota rescan failed: %s",
120 strerror(errno));
121 } else {
122 warning("quotas may be inconsistent, rescan needed");
125 close_file_or_dir(fd, dirstream);
126 return ret;
129 static int _cmd_qgroup_create(int create, int argc, char **argv)
131 int ret = 0;
132 int fd;
133 int e;
134 char *path;
135 struct btrfs_ioctl_qgroup_create_args args;
136 DIR *dirstream = NULL;
138 if (check_argc_exact(argc - optind, 2))
139 return -1;
141 memset(&args, 0, sizeof(args));
142 args.create = create;
143 args.qgroupid = parse_qgroupid(argv[optind]);
144 path = argv[optind + 1];
146 fd = btrfs_open_dir(path, &dirstream, 1);
147 if (fd < 0)
148 return 1;
150 ret = ioctl(fd, BTRFS_IOC_QGROUP_CREATE, &args);
151 e = errno;
152 close_file_or_dir(fd, dirstream);
153 if (ret < 0) {
154 error("unable to %s quota group: %s",
155 create ? "create":"destroy", strerror(e));
156 return 1;
158 return 0;
161 static int parse_limit(const char *p, unsigned long long *s)
163 char *endptr;
164 unsigned long long size;
165 unsigned long long CLEAR_VALUE = -1;
167 if (strcasecmp(p, "none") == 0) {
168 *s = CLEAR_VALUE;
169 return 1;
172 if (p[0] == '-')
173 return 0;
175 size = strtoull(p, &endptr, 10);
176 if (p == endptr)
177 return 0;
179 switch (*endptr) {
180 case 'T':
181 case 't':
182 size *= 1024;
183 /* fallthrough */
184 case 'G':
185 case 'g':
186 size *= 1024;
187 /* fallthrough */
188 case 'M':
189 case 'm':
190 size *= 1024;
191 /* fallthrough */
192 case 'K':
193 case 'k':
194 size *= 1024;
195 ++endptr;
196 break;
197 case 0:
198 break;
199 default:
200 return 0;
203 if (*endptr)
204 return 0;
206 *s = size;
208 return 1;
211 static const char * const cmd_qgroup_assign_usage[] = {
212 "btrfs qgroup assign [options] <src> <dst> <path>",
213 "Assign SRC as the child qgroup of DST",
215 "--rescan schedule qutoa rescan if needed",
216 "--no-rescan don't schedule quota rescan",
217 NULL
220 static int cmd_qgroup_assign(int argc, char **argv)
222 return _cmd_qgroup_assign(1, argc, argv, cmd_qgroup_assign_usage);
225 static const char * const cmd_qgroup_remove_usage[] = {
226 "btrfs qgroup remove <src> <dst> <path>",
227 "Remove a child qgroup SRC from DST.",
228 NULL
231 static int cmd_qgroup_remove(int argc, char **argv)
233 return _cmd_qgroup_assign(0, argc, argv, cmd_qgroup_remove_usage);
236 static const char * const cmd_qgroup_create_usage[] = {
237 "btrfs qgroup create <qgroupid> <path>",
238 "Create a subvolume quota group.",
239 NULL
242 static int cmd_qgroup_create(int argc, char **argv)
244 int ret;
246 clean_args_no_options(argc, argv, cmd_qgroup_create_usage);
248 ret = _cmd_qgroup_create(1, argc, argv);
250 if (ret < 0)
251 usage(cmd_qgroup_create_usage);
252 return ret;
255 static const char * const cmd_qgroup_destroy_usage[] = {
256 "btrfs qgroup destroy <qgroupid> <path>",
257 "Destroy a quota group.",
258 NULL
261 static int cmd_qgroup_destroy(int argc, char **argv)
263 int ret;
265 clean_args_no_options(argc, argv, cmd_qgroup_destroy_usage);
267 ret = _cmd_qgroup_create(0, argc, argv);
269 if (ret < 0)
270 usage(cmd_qgroup_destroy_usage);
271 return ret;
274 static const char * const cmd_qgroup_show_usage[] = {
275 "btrfs qgroup show -pcreFf "
276 "[--sort=qgroupid,rfer,excl,max_rfer,max_excl] <path>",
277 "Show subvolume quota groups.",
278 "-p print parent qgroup id",
279 "-c print child qgroup id",
280 "-r print limit of referenced size of qgroup",
281 "-e print limit of exclusive size of qgroup",
282 "-F list all qgroups which impact the given path",
283 " (including ancestral qgroups)",
284 "-f list all qgroups which impact the given path",
285 " (excluding ancestral qgroups)",
286 HELPINFO_UNITS_LONG,
287 "--sort=qgroupid,rfer,excl,max_rfer,max_excl",
288 " list qgroups sorted by specified items",
289 " you can use '+' or '-' in front of each item.",
290 " (+:ascending, -:descending, ascending default)",
291 NULL
294 static int cmd_qgroup_show(int argc, char **argv)
296 char *path;
297 int ret = 0;
298 int fd;
299 int e;
300 DIR *dirstream = NULL;
301 u64 qgroupid;
302 int filter_flag = 0;
303 unsigned unit_mode;
305 struct btrfs_qgroup_comparer_set *comparer_set;
306 struct btrfs_qgroup_filter_set *filter_set;
307 filter_set = btrfs_qgroup_alloc_filter_set();
308 comparer_set = btrfs_qgroup_alloc_comparer_set();
310 unit_mode = get_unit_mode_from_arg(&argc, argv, 0);
312 while (1) {
313 int c;
314 static const struct option long_options[] = {
315 {"sort", required_argument, NULL, 'S'},
316 { NULL, 0, NULL, 0 }
319 c = getopt_long(argc, argv, "pcreFf", long_options, NULL);
320 if (c < 0)
321 break;
322 switch (c) {
323 case 'p':
324 btrfs_qgroup_setup_print_column(
325 BTRFS_QGROUP_PARENT);
326 break;
327 case 'c':
328 btrfs_qgroup_setup_print_column(
329 BTRFS_QGROUP_CHILD);
330 break;
331 case 'r':
332 btrfs_qgroup_setup_print_column(
333 BTRFS_QGROUP_MAX_RFER);
334 break;
335 case 'e':
336 btrfs_qgroup_setup_print_column(
337 BTRFS_QGROUP_MAX_EXCL);
338 break;
339 case 'F':
340 filter_flag |= 0x1;
341 break;
342 case 'f':
343 filter_flag |= 0x2;
344 break;
345 case 'S':
346 ret = btrfs_qgroup_parse_sort_string(optarg,
347 &comparer_set);
348 if (ret)
349 usage(cmd_qgroup_show_usage);
350 break;
351 default:
352 usage(cmd_qgroup_show_usage);
355 btrfs_qgroup_setup_units(unit_mode);
357 if (check_argc_exact(argc - optind, 1))
358 usage(cmd_qgroup_show_usage);
360 path = argv[optind];
361 fd = btrfs_open_dir(path, &dirstream, 1);
362 if (fd < 0) {
363 btrfs_qgroup_free_filter_set(filter_set);
364 btrfs_qgroup_free_comparer_set(comparer_set);
365 return 1;
368 if (filter_flag) {
369 qgroupid = btrfs_get_path_rootid(fd);
370 if (filter_flag & 0x1)
371 btrfs_qgroup_setup_filter(&filter_set,
372 BTRFS_QGROUP_FILTER_ALL_PARENT,
373 qgroupid);
374 if (filter_flag & 0x2)
375 btrfs_qgroup_setup_filter(&filter_set,
376 BTRFS_QGROUP_FILTER_PARENT,
377 qgroupid);
379 ret = btrfs_show_qgroups(fd, filter_set, comparer_set);
380 e = errno;
381 close_file_or_dir(fd, dirstream);
382 if (ret < 0)
383 error("can't list qgroups: %s", strerror(e));
385 return !!ret;
388 static const char * const cmd_qgroup_limit_usage[] = {
389 "btrfs qgroup limit [options] <size>|none [<qgroupid>] <path>",
390 "Set the limits a subvolume quota group.",
392 "-c limit amount of data after compression. This is the default,",
393 " it is currently not possible to turn off this option.",
394 "-e limit space exclusively assigned to this qgroup",
395 NULL
398 static int cmd_qgroup_limit(int argc, char **argv)
400 int ret = 0;
401 int fd;
402 int e;
403 char *path = NULL;
404 struct btrfs_ioctl_qgroup_limit_args args;
405 unsigned long long size;
406 int compressed = 0;
407 int exclusive = 0;
408 DIR *dirstream = NULL;
410 while (1) {
411 int c = getopt(argc, argv, "ce");
412 if (c < 0)
413 break;
414 switch (c) {
415 case 'c':
416 compressed = 1;
417 break;
418 case 'e':
419 exclusive = 1;
420 break;
421 default:
422 usage(cmd_qgroup_limit_usage);
426 if (check_argc_min(argc - optind, 2))
427 usage(cmd_qgroup_limit_usage);
429 if (!parse_limit(argv[optind], &size)) {
430 error("invalid size argument: %s", argv[optind]);
431 return 1;
434 memset(&args, 0, sizeof(args));
435 if (compressed)
436 args.lim.flags |= BTRFS_QGROUP_LIMIT_RFER_CMPR |
437 BTRFS_QGROUP_LIMIT_EXCL_CMPR;
438 if (exclusive) {
439 args.lim.flags |= BTRFS_QGROUP_LIMIT_MAX_EXCL;
440 args.lim.max_exclusive = size;
441 } else {
442 args.lim.flags |= BTRFS_QGROUP_LIMIT_MAX_RFER;
443 args.lim.max_referenced = size;
446 if (argc - optind == 2) {
447 args.qgroupid = 0;
448 path = argv[optind + 1];
449 ret = test_issubvolume(path);
450 if (ret < 0) {
451 error("cannot access '%s': %s", path, strerror(-ret));
452 return 1;
454 if (!ret) {
455 error("'%s' is not a subvolume", path);
456 return 1;
459 * keep qgroupid at 0, this indicates that the subvolume the
460 * fd refers to is to be limited
462 } else if (argc - optind == 3) {
463 args.qgroupid = parse_qgroupid(argv[optind + 1]);
464 path = argv[optind + 2];
465 } else
466 usage(cmd_qgroup_limit_usage);
468 fd = btrfs_open_dir(path, &dirstream, 1);
469 if (fd < 0)
470 return 1;
472 ret = ioctl(fd, BTRFS_IOC_QGROUP_LIMIT, &args);
473 e = errno;
474 close_file_or_dir(fd, dirstream);
475 if (ret < 0) {
476 error("unable to limit requested quota group: %s", strerror(e));
477 return 1;
479 return 0;
482 static const char qgroup_cmd_group_info[] =
483 "manage quota groups";
485 const struct cmd_group qgroup_cmd_group = {
486 qgroup_cmd_group_usage, qgroup_cmd_group_info, {
487 { "assign", cmd_qgroup_assign, cmd_qgroup_assign_usage,
488 NULL, 0 },
489 { "remove", cmd_qgroup_remove, cmd_qgroup_remove_usage,
490 NULL, 0 },
491 { "create", cmd_qgroup_create, cmd_qgroup_create_usage,
492 NULL, 0 },
493 { "destroy", cmd_qgroup_destroy, cmd_qgroup_destroy_usage,
494 NULL, 0 },
495 { "show", cmd_qgroup_show, cmd_qgroup_show_usage,
496 NULL, 0 },
497 { "limit", cmd_qgroup_limit, cmd_qgroup_limit_usage,
498 NULL, 0 },
499 NULL_CMD_STRUCT
503 int cmd_qgroup(int argc, char **argv)
505 return handle_command_group(&qgroup_cmd_group, argc, argv);