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.
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.
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.
21 #include <sys/ioctl.h>
28 #include "kerncompat.h"
34 #include "btrfs-list.h"
36 static const char * const subvolume_cmd_group_usage[] = {
37 "btrfs subvolume <command> <args>",
42 * test if path is a directory
43 * this function return
44 * 0-> path exists but it is not a directory
45 * 1-> path exists and it is a directory
46 * -1 -> path is unaccessible
48 static int test_isdir(char *path)
53 res = stat(path, &st);
57 return S_ISDIR(st.st_mode);
60 static const char * const cmd_subvol_create_usage[] = {
61 "btrfs subvolume create [<dest>/]<name>",
63 "Create a subvolume <name> in <dest>. If <dest> is not given",
64 "subvolume <name> will be created in the current directory.",
68 static int cmd_subvol_create(int argc, char **argv)
70 int res, fddst, len, e;
74 struct btrfs_qgroup_inherit *inherit = NULL;
78 int c = getopt(argc, argv, "c:i:r");
84 res = qgroup_inherit_add_copy(&inherit, optarg, 0);
89 res = qgroup_inherit_add_group(&inherit, optarg);
94 usage(cmd_subvol_create_usage);
98 if (check_argc_exact(argc - optind, 1))
99 usage(cmd_subvol_create_usage);
103 res = test_isdir(dst);
105 fprintf(stderr, "ERROR: '%s' exists\n", dst);
109 newname = strdup(dst);
110 newname = basename(newname);
111 dstdir = strdup(dst);
112 dstdir = dirname(dstdir);
114 if( !strcmp(newname,".") || !strcmp(newname,"..") ||
115 strchr(newname, '/') ){
116 fprintf(stderr, "ERROR: uncorrect subvolume name ('%s')\n",
121 len = strlen(newname);
122 if (len == 0 || len >= BTRFS_VOL_NAME_MAX) {
123 fprintf(stderr, "ERROR: subvolume name too long ('%s)\n",
128 fddst = open_file_or_dir(dstdir);
130 fprintf(stderr, "ERROR: can't access to '%s'\n", dstdir);
134 printf("Create subvolume '%s/%s'\n", dstdir, newname);
136 struct btrfs_ioctl_vol_args_v2 args;
138 memset(&args, 0, sizeof(args));
139 strncpy(args.name, newname, BTRFS_SUBVOL_NAME_MAX);
140 args.name[BTRFS_SUBVOL_NAME_MAX-1] = 0;
141 args.flags |= BTRFS_SUBVOL_QGROUP_INHERIT;
142 args.size = qgroup_inherit_size(inherit);
143 args.qgroup_inherit = inherit;
145 res = ioctl(fddst, BTRFS_IOC_SUBVOL_CREATE_V2, &args);
147 struct btrfs_ioctl_vol_args args;
149 memset(&args, 0, sizeof(args));
150 strncpy(args.name, newname, BTRFS_SUBVOL_NAME_MAX);
151 args.name[BTRFS_SUBVOL_NAME_MAX-1] = 0;
153 res = ioctl(fddst, BTRFS_IOC_SUBVOL_CREATE, &args);
161 fprintf( stderr, "ERROR: cannot create subvolume - %s\n",
171 * test if path is a subvolume:
172 * this function return
173 * 0-> path exists but it is not a subvolume
174 * 1-> path exists and it is a subvolume
175 * -1 -> path is unaccessible
177 int test_issubvolume(char *path)
182 res = stat(path, &st);
186 return (st.st_ino == 256) && S_ISDIR(st.st_mode);
189 static const char * const cmd_subvol_delete_usage[] = {
190 "btrfs subvolume delete <name>",
191 "Delete a subvolume",
195 static int cmd_subvol_delete(int argc, char **argv)
198 struct btrfs_ioctl_vol_args args;
199 char *dname, *vname, *cpath;
202 if (check_argc_exact(argc, 2))
203 usage(cmd_subvol_delete_usage);
207 res = test_issubvolume(path);
209 fprintf(stderr, "ERROR: error accessing '%s'\n", path);
213 fprintf(stderr, "ERROR: '%s' is not a subvolume\n", path);
217 cpath = realpath(path, 0);
218 dname = strdup(cpath);
219 dname = dirname(dname);
220 vname = strdup(cpath);
221 vname = basename(vname);
224 if( !strcmp(vname,".") || !strcmp(vname,"..") ||
225 strchr(vname, '/') ){
226 fprintf(stderr, "ERROR: incorrect subvolume name ('%s')\n",
232 if (len == 0 || len >= BTRFS_VOL_NAME_MAX) {
233 fprintf(stderr, "ERROR: snapshot name too long ('%s)\n",
238 fd = open_file_or_dir(dname);
241 fprintf(stderr, "ERROR: can't access to '%s'\n", dname);
245 printf("Delete subvolume '%s/%s'\n", dname, vname);
246 strncpy(args.name, vname, BTRFS_PATH_NAME_MAX);
247 args.name[BTRFS_PATH_NAME_MAX-1] = 0;
248 res = ioctl(fd, BTRFS_IOC_SNAP_DESTROY, &args);
254 fprintf( stderr, "ERROR: cannot delete '%s/%s' - %s\n",
255 dname, vname, strerror(e));
262 static const char * const cmd_subvol_list_usage[] = {
263 "btrfs subvolume list [-apurt] [-s 0|1] [-g [+|-]value] [-c [+|-]value] "
264 "[--sort=gen,ogen,rootid,path] <path>",
265 "List subvolumes (and snapshots)",
267 "-p print parent ID",
268 "-a print all the subvolumes in the filesystem.",
269 "-u print the uuid of subvolumes (and snapshots)",
270 "-t print the result as a table",
271 "-s value list snapshots with generation in ascending/descending order",
272 " (1: ascending, 0: descending)",
273 "-r list readonly subvolumes (including snapshots)",
275 " filter the subvolumes by generation",
276 " (+value: >= value; -value: <= value; value: = value)",
278 " filter the subvolumes by ogeneration",
279 " (+value: >= value; -value: <= value; value: = value)",
280 "--sort=gen,ogen,rootid,path",
281 " list the subvolume in order of gen, ogen, rootid or path",
282 " you also can add '+' or '-' in front of each items.",
283 " (+:ascending, -:descending, ascending default)",
287 static int cmd_subvol_list(int argc, char **argv)
289 struct btrfs_list_filter_set *filter_set;
290 struct btrfs_list_comparer_set *comparer_set;
298 int is_tab_result = 0;
300 struct option long_options[] = {
301 {"sort", 1, NULL, 'S'},
305 filter_set = btrfs_list_alloc_filter_set();
306 comparer_set = btrfs_list_alloc_comparer_set();
310 c = getopt_long(argc, argv,
311 "aps:urg:c:t", long_options, NULL);
317 btrfs_list_setup_print_column(BTRFS_LIST_PARENT);
326 order = atoi(optarg);
327 btrfs_list_setup_filter(&filter_set,
328 BTRFS_LIST_FILTER_SNAPSHOT_ONLY,
330 btrfs_list_setup_comparer(&comparer_set,
331 BTRFS_LIST_COMP_OGEN,
333 btrfs_list_setup_print_column(BTRFS_LIST_OGENERATION);
334 btrfs_list_setup_print_column(BTRFS_LIST_OTIME);
337 btrfs_list_setup_print_column(BTRFS_LIST_UUID);
340 flags |= BTRFS_ROOT_SUBVOL_RDONLY;
343 btrfs_list_setup_print_column(BTRFS_LIST_GENERATION);
344 ret = btrfs_list_parse_filter_string(optarg,
346 BTRFS_LIST_FILTER_GEN);
348 usage(cmd_subvol_list_usage);
352 btrfs_list_setup_print_column(BTRFS_LIST_OGENERATION);
353 ret = btrfs_list_parse_filter_string(optarg,
355 BTRFS_LIST_FILTER_CGEN);
357 usage(cmd_subvol_list_usage);
360 ret = btrfs_list_parse_sort_string(optarg,
363 usage(cmd_subvol_list_usage);
367 usage(cmd_subvol_list_usage);
372 btrfs_list_setup_filter(&filter_set, BTRFS_LIST_FILTER_FLAGS,
375 if (check_argc_exact(argc - optind, 1))
376 usage(cmd_subvol_list_usage);
378 subvol = argv[optind];
380 ret = test_issubvolume(subvol);
382 fprintf(stderr, "ERROR: error accessing '%s'\n", subvol);
386 fprintf(stderr, "ERROR: '%s' is not a subvolume\n", subvol);
390 fd = open_file_or_dir(subvol);
392 fprintf(stderr, "ERROR: can't access '%s'\n", subvol);
396 top_id = btrfs_list_get_path_rootid(fd);
398 btrfs_list_setup_filter(&filter_set,
399 BTRFS_LIST_FILTER_TOPID_EQUAL,
402 ret = btrfs_list_subvols(fd, filter_set, comparer_set,
409 static const char * const cmd_snapshot_usage[] = {
410 "btrfs subvolume snapshot [-r] <source> [<dest>/]<name>",
411 "Create a snapshot of the subvolume",
412 "Create a writable/readonly snapshot of the subvolume <source> with",
413 "the name <name> in the <dest> directory",
415 "-r create a readonly snapshot",
419 static int cmd_snapshot(int argc, char **argv)
422 int res, fd, fddst, len, e, readonly = 0;
425 struct btrfs_ioctl_vol_args_v2 args;
426 struct btrfs_qgroup_inherit *inherit = NULL;
429 memset(&args, 0, sizeof(args));
431 int c = getopt(argc, argv, "c:i:r");
437 res = qgroup_inherit_add_copy(&inherit, optarg, 0);
442 res = qgroup_inherit_add_group(&inherit, optarg);
450 res = qgroup_inherit_add_copy(&inherit, optarg, 1);
455 usage(cmd_snapshot_usage);
459 if (check_argc_exact(argc - optind, 2))
460 usage(cmd_snapshot_usage);
462 subvol = argv[optind];
463 dst = argv[optind + 1];
465 res = test_issubvolume(subvol);
467 fprintf(stderr, "ERROR: error accessing '%s'\n", subvol);
471 fprintf(stderr, "ERROR: '%s' is not a subvolume\n", subvol);
475 res = test_isdir(dst);
477 fprintf(stderr, "ERROR: '%s' exists and it is not a directory\n", dst);
482 newname = strdup(subvol);
483 newname = basename(newname);
486 newname = strdup(dst);
487 newname = basename(newname);
488 dstdir = strdup(dst);
489 dstdir = dirname(dstdir);
492 if( !strcmp(newname,".") || !strcmp(newname,"..") ||
493 strchr(newname, '/') ){
494 fprintf(stderr, "ERROR: incorrect snapshot name ('%s')\n",
499 len = strlen(newname);
500 if (len == 0 || len >= BTRFS_VOL_NAME_MAX) {
501 fprintf(stderr, "ERROR: snapshot name too long ('%s)\n",
506 fddst = open_file_or_dir(dstdir);
508 fprintf(stderr, "ERROR: can't access to '%s'\n", dstdir);
512 fd = open_file_or_dir(subvol);
515 fprintf(stderr, "ERROR: can't access to '%s'\n", dstdir);
520 args.flags |= BTRFS_SUBVOL_RDONLY;
521 printf("Create a readonly snapshot of '%s' in '%s/%s'\n",
522 subvol, dstdir, newname);
524 printf("Create a snapshot of '%s' in '%s/%s'\n",
525 subvol, dstdir, newname);
530 args.flags |= BTRFS_SUBVOL_QGROUP_INHERIT;
531 args.size = qgroup_inherit_size(inherit);
532 args.qgroup_inherit = inherit;
534 strncpy(args.name, newname, BTRFS_SUBVOL_NAME_MAX);
535 args.name[BTRFS_SUBVOL_NAME_MAX-1] = 0;
536 res = ioctl(fddst, BTRFS_IOC_SNAP_CREATE_V2, &args);
543 fprintf( stderr, "ERROR: cannot snapshot '%s' - %s\n",
544 subvol, strerror(e));
552 static const char * const cmd_subvol_get_default_usage[] = {
553 "btrfs subvolume get-default <path>",
554 "Get the default subvolume of a filesystem",
558 static int cmd_subvol_get_default(int argc, char **argv)
563 struct btrfs_list_filter_set *filter_set;
566 if (check_argc_exact(argc, 2))
567 usage(cmd_subvol_get_default_usage);
571 ret = test_issubvolume(subvol);
573 fprintf(stderr, "ERROR: error accessing '%s'\n", subvol);
577 fprintf(stderr, "ERROR: '%s' is not a subvolume\n", subvol);
581 fd = open_file_or_dir(subvol);
583 fprintf(stderr, "ERROR: can't access '%s'\n", subvol);
587 ret = btrfs_list_get_default_subvolume(fd, &default_id);
589 fprintf(stderr, "ERROR: can't perform the search - %s\n",
594 if (default_id == 0) {
595 fprintf(stderr, "ERROR: 'default' dir item not found\n");
599 /* no need to resolve roots if FS_TREE is default */
600 if (default_id == BTRFS_FS_TREE_OBJECTID) {
601 printf("ID 5 (FS_TREE)\n");
605 filter_set = btrfs_list_alloc_filter_set();
606 btrfs_list_setup_filter(&filter_set, BTRFS_LIST_FILTER_ROOTID,
609 ret = btrfs_list_subvols(fd, filter_set, NULL, 0);
615 static const char * const cmd_subvol_set_default_usage[] = {
616 "btrfs subvolume set-default <subvolid> <path>",
617 "Set the default subvolume of a filesystem",
621 static int cmd_subvol_set_default(int argc, char **argv)
628 if (check_argc_exact(argc, 3))
629 usage(cmd_subvol_set_default_usage);
634 fd = open_file_or_dir(path);
636 fprintf(stderr, "ERROR: can't access to '%s'\n", path);
640 objectid = (unsigned long long)strtoll(subvolid, NULL, 0);
641 if (errno == ERANGE) {
642 fprintf(stderr, "ERROR: invalid tree id (%s)\n",subvolid);
645 ret = ioctl(fd, BTRFS_IOC_DEFAULT_SUBVOL, &objectid);
649 fprintf(stderr, "ERROR: unable to set a new default subvolume - %s\n",
656 static const char * const cmd_find_new_usage[] = {
657 "btrfs subvolume find-new <path> <lastgen>",
658 "List the recently modified files in a filesystem",
662 static int cmd_find_new(int argc, char **argv)
669 if (check_argc_exact(argc, 3))
670 usage(cmd_find_new_usage);
673 last_gen = atoll(argv[2]);
675 ret = test_issubvolume(subvol);
677 fprintf(stderr, "ERROR: error accessing '%s'\n", subvol);
681 fprintf(stderr, "ERROR: '%s' is not a subvolume\n", subvol);
685 fd = open_file_or_dir(subvol);
687 fprintf(stderr, "ERROR: can't access '%s'\n", subvol);
690 ret = btrfs_list_find_updated_files(fd, 0, last_gen);
696 const struct cmd_group subvolume_cmd_group = {
697 subvolume_cmd_group_usage, NULL, {
698 { "create", cmd_subvol_create, cmd_subvol_create_usage, NULL, 0 },
699 { "delete", cmd_subvol_delete, cmd_subvol_delete_usage, NULL, 0 },
700 { "list", cmd_subvol_list, cmd_subvol_list_usage, NULL, 0 },
701 { "snapshot", cmd_snapshot, cmd_snapshot_usage, NULL, 0 },
702 { "get-default", cmd_subvol_get_default,
703 cmd_subvol_get_default_usage, NULL, 0 },
704 { "set-default", cmd_subvol_set_default,
705 cmd_subvol_set_default_usage, NULL, 0 },
706 { "find-new", cmd_find_new, cmd_find_new_usage, NULL, 0 },
711 int cmd_subvolume(int argc, char **argv)
713 return handle_command_group(&subvolume_cmd_group, argc, argv);