btrfs-progs: docs: update mkfs page for dup on multidev fs
[btrfs-progs-unstable/devel.git] / cmds-device.c
blobb17b6c6f1f8321297f6eb9c47c4237d6c5fa8da5
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.
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.
17 #include <stdio.h>
18 #include <stdlib.h>
19 #include <string.h>
20 #include <unistd.h>
21 #include <fcntl.h>
22 #include <sys/ioctl.h>
23 #include <errno.h>
24 #include <sys/stat.h>
25 #include <getopt.h>
27 #include "kerncompat.h"
28 #include "ctree.h"
29 #include "ioctl.h"
30 #include "utils.h"
31 #include "volumes.h"
32 #include "cmds-fi-usage.h"
34 #include "commands.h"
36 static const char * const device_cmd_group_usage[] = {
37 "btrfs device <command> [<args>]",
38 NULL
41 static const char * const cmd_device_add_usage[] = {
42 "btrfs device add [options] <device> [<device>...] <path>",
43 "Add a device to a filesystem",
44 "-K|--nodiscard do not perform whole device TRIM",
45 "-f|--force force overwrite existing filesystem on the disk",
46 NULL
49 static int cmd_device_add(int argc, char **argv)
51 char *mntpnt;
52 int i, fdmnt, ret = 0;
53 DIR *dirstream = NULL;
54 int discard = 1;
55 int force = 0;
56 int last_dev;
58 while (1) {
59 int c;
60 static const struct option long_options[] = {
61 { "nodiscard", optional_argument, NULL, 'K'},
62 { "force", no_argument, NULL, 'f'},
63 { NULL, 0, NULL, 0}
66 c = getopt_long(argc, argv, "Kf", long_options, NULL);
67 if (c < 0)
68 break;
69 switch (c) {
70 case 'K':
71 discard = 0;
72 break;
73 case 'f':
74 force = 1;
75 break;
76 default:
77 usage(cmd_device_add_usage);
81 if (check_argc_min(argc - optind, 2))
82 usage(cmd_device_add_usage);
84 last_dev = argc - 1;
85 mntpnt = argv[last_dev];
87 fdmnt = btrfs_open_dir(mntpnt, &dirstream, 1);
88 if (fdmnt < 0)
89 return 1;
91 for (i = optind; i < last_dev; i++){
92 struct btrfs_ioctl_vol_args ioctl_args;
93 int devfd, res;
94 u64 dev_block_count = 0;
95 char *path;
97 res = test_dev_for_mkfs(argv[i], force);
98 if (res) {
99 ret++;
100 continue;
103 devfd = open(argv[i], O_RDWR);
104 if (devfd < 0) {
105 error("unable to open device '%s'", argv[i]);
106 ret++;
107 continue;
110 res = btrfs_prepare_device(devfd, argv[i], 1, &dev_block_count,
111 0, discard);
112 close(devfd);
113 if (res) {
114 ret++;
115 goto error_out;
118 path = canonicalize_path(argv[i]);
119 if (!path) {
120 error("could not canonicalize pathname '%s': %s",
121 argv[i], strerror(errno));
122 ret++;
123 goto error_out;
126 memset(&ioctl_args, 0, sizeof(ioctl_args));
127 strncpy_null(ioctl_args.name, path);
128 res = ioctl(fdmnt, BTRFS_IOC_ADD_DEV, &ioctl_args);
129 if (res < 0) {
130 error("error adding device '%s': %s",
131 path, strerror(errno));
132 ret++;
134 free(path);
137 error_out:
138 close_file_or_dir(fdmnt, dirstream);
139 return !!ret;
142 static int _cmd_device_remove(int argc, char **argv,
143 const char * const *usagestr)
145 char *mntpnt;
146 int i, fdmnt, ret = 0;
147 DIR *dirstream = NULL;
149 clean_args_no_options(argc, argv, usagestr);
151 if (check_argc_min(argc - optind, 2))
152 usage(usagestr);
154 mntpnt = argv[argc - 1];
156 fdmnt = btrfs_open_dir(mntpnt, &dirstream, 1);
157 if (fdmnt < 0)
158 return 1;
160 for(i = optind; i < argc - 1; i++) {
161 struct btrfs_ioctl_vol_args arg;
162 struct btrfs_ioctl_vol_args_v2 argv2 = {0};
163 int is_devid = 0;
164 int res;
166 if (string_is_numerical(argv[i])) {
167 argv2.devid = arg_strtou64(argv[i]);
168 argv2.flags = BTRFS_DEVICE_SPEC_BY_ID;
169 is_devid = 1;
170 } else if (is_block_device(argv[i]) == 1 ||
171 strcmp(argv[i], "missing") == 0) {
172 strncpy_null(argv2.name, argv[i]);
173 } else {
174 error("not a block device: %s", argv[i]);
175 ret++;
176 continue;
180 * Positive values are from BTRFS_ERROR_DEV_*,
181 * otherwise it's a generic error, one of errnos
183 res = ioctl(fdmnt, BTRFS_IOC_RM_DEV_V2, &argv2);
186 * If BTRFS_IOC_RM_DEV_V2 is not supported we get ENOTTY and if
187 * argv2.flags includes a flag which kernel doesn't understand then
188 * we shall get EOPNOTSUPP
190 if (res < 0 && (errno == ENOTTY || errno == EOPNOTSUPP)) {
191 if (is_devid) {
192 error("device delete by id failed: %s",
193 strerror(errno));
194 ret++;
195 continue;
197 memset(&arg, 0, sizeof(arg));
198 strncpy_null(arg.name, argv[i]);
199 res = ioctl(fdmnt, BTRFS_IOC_RM_DEV, &arg);
202 if (res) {
203 const char *msg;
205 if (res > 0)
206 msg = btrfs_err_str(res);
207 else
208 msg = strerror(errno);
209 if (is_devid) {
210 error("error removing devid %llu: %s",
211 (unsigned long long)argv2.devid, msg);
212 } else {
213 error("error removing device '%s': %s",
214 argv[i], msg);
216 ret++;
220 close_file_or_dir(fdmnt, dirstream);
221 return !!ret;
224 static const char * const cmd_device_remove_usage[] = {
225 "btrfs device remove <device>|<devid> [<device>|<devid>...] <path>",
226 "Remove a device from a filesystem",
227 NULL
230 static int cmd_device_remove(int argc, char **argv)
232 return _cmd_device_remove(argc, argv, cmd_device_remove_usage);
235 static const char * const cmd_device_delete_usage[] = {
236 "btrfs device delete <device>|<devid> [<device>|<devid>...] <path>",
237 "Remove a device from a filesystem",
238 NULL
241 static int cmd_device_delete(int argc, char **argv)
243 return _cmd_device_remove(argc, argv, cmd_device_delete_usage);
246 static const char * const cmd_device_scan_usage[] = {
247 "btrfs device scan [(-d|--all-devices)|<device> [<device>...]]",
248 "Scan devices for a btrfs filesystem",
249 " -d|--all-devices (deprecated)",
250 NULL
253 static int cmd_device_scan(int argc, char **argv)
255 int i;
256 int devstart;
257 int all = 0;
258 int ret = 0;
260 optind = 1;
261 while (1) {
262 int c;
263 static const struct option long_options[] = {
264 { "all-devices", no_argument, NULL, 'd'},
265 { NULL, 0, NULL, 0}
268 c = getopt_long(argc, argv, "d", long_options, NULL);
269 if (c < 0)
270 break;
271 switch (c) {
272 case 'd':
273 all = 1;
274 break;
275 default:
276 usage(cmd_device_scan_usage);
279 devstart = optind;
281 if (all && check_argc_max(argc - optind, 1))
282 usage(cmd_device_scan_usage);
284 if (all || argc - optind == 0) {
285 printf("Scanning for Btrfs filesystems\n");
286 ret = btrfs_scan_lblkid();
287 error_on(ret, "error %d while scanning", ret);
288 ret = btrfs_register_all_devices();
289 error_on(ret, "there are %d errors while registering devices", ret);
290 goto out;
293 for( i = devstart ; i < argc ; i++ ){
294 char *path;
296 if (is_block_device(argv[i]) != 1) {
297 error("not a block device: %s", argv[i]);
298 ret = 1;
299 goto out;
301 path = canonicalize_path(argv[i]);
302 if (!path) {
303 error("could not canonicalize path '%s': %s",
304 argv[i], strerror(errno));
305 ret = 1;
306 goto out;
308 printf("Scanning for Btrfs filesystems in '%s'\n", path);
309 if (btrfs_register_one_device(path) != 0) {
310 ret = 1;
311 free(path);
312 goto out;
314 free(path);
317 out:
318 return !!ret;
321 static const char * const cmd_device_ready_usage[] = {
322 "btrfs device ready <device>",
323 "Check device to see if it has all of its devices in cache for mounting",
324 NULL
327 static int cmd_device_ready(int argc, char **argv)
329 struct btrfs_ioctl_vol_args args;
330 int fd;
331 int ret;
332 char *path;
334 clean_args_no_options(argc, argv, cmd_device_ready_usage);
336 if (check_argc_min(argc - optind, 1))
337 usage(cmd_device_ready_usage);
339 fd = open("/dev/btrfs-control", O_RDWR);
340 if (fd < 0) {
341 perror("failed to open /dev/btrfs-control");
342 return 1;
345 path = canonicalize_path(argv[optind]);
346 if (!path) {
347 error("could not canonicalize pathname '%s': %s",
348 argv[optind], strerror(errno));
349 ret = 1;
350 goto out;
353 if (is_block_device(path) != 1) {
354 error("not a block device: %s", path);
355 ret = 1;
356 goto out;
359 memset(&args, 0, sizeof(args));
360 strncpy_null(args.name, path);
361 ret = ioctl(fd, BTRFS_IOC_DEVICES_READY, &args);
362 if (ret < 0) {
363 error("unable to determine if device '%s' is ready for mount: %s",
364 path, strerror(errno));
365 ret = 1;
368 out:
369 free(path);
370 close(fd);
371 return ret;
374 static const char * const cmd_device_stats_usage[] = {
375 "btrfs device stats [-z] <path>|<device>",
376 "Show current device IO stats.",
378 "-z show current stats and reset values to zero",
379 NULL
382 static int cmd_device_stats(int argc, char **argv)
384 char *dev_path;
385 struct btrfs_ioctl_fs_info_args fi_args;
386 struct btrfs_ioctl_dev_info_args *di_args = NULL;
387 int ret;
388 int fdmnt;
389 int i;
390 int c;
391 int err = 0;
392 __u64 flags = 0;
393 DIR *dirstream = NULL;
395 optind = 1;
396 while ((c = getopt(argc, argv, "z")) != -1) {
397 switch (c) {
398 case 'z':
399 flags = BTRFS_DEV_STATS_RESET;
400 break;
401 case '?':
402 default:
403 usage(cmd_device_stats_usage);
407 if (check_argc_exact(argc - optind, 1))
408 usage(cmd_device_stats_usage);
410 dev_path = argv[optind];
412 fdmnt = open_path_or_dev_mnt(dev_path, &dirstream, 1);
413 if (fdmnt < 0)
414 return 1;
416 ret = get_fs_info(dev_path, &fi_args, &di_args);
417 if (ret) {
418 error("getting dev info for devstats failed: %s",
419 strerror(-ret));
420 err = 1;
421 goto out;
423 if (!fi_args.num_devices) {
424 error("no devices found");
425 err = 1;
426 goto out;
429 for (i = 0; i < fi_args.num_devices; i++) {
430 struct btrfs_ioctl_get_dev_stats args = {0};
431 __u8 path[BTRFS_DEVICE_PATH_NAME_MAX + 1];
433 strncpy((char *)path, (char *)di_args[i].path,
434 BTRFS_DEVICE_PATH_NAME_MAX);
435 path[BTRFS_DEVICE_PATH_NAME_MAX] = '\0';
437 args.devid = di_args[i].devid;
438 args.nr_items = BTRFS_DEV_STAT_VALUES_MAX;
439 args.flags = flags;
441 if (ioctl(fdmnt, BTRFS_IOC_GET_DEV_STATS, &args) < 0) {
442 error("DEV_STATS ioctl failed on %s: %s",
443 path, strerror(errno));
444 err = 1;
445 } else {
446 char *canonical_path;
448 canonical_path = canonicalize_path((char *)path);
450 if (args.nr_items >= BTRFS_DEV_STAT_WRITE_ERRS + 1)
451 printf("[%s].write_io_errs %llu\n",
452 canonical_path,
453 (unsigned long long) args.values[
454 BTRFS_DEV_STAT_WRITE_ERRS]);
455 if (args.nr_items >= BTRFS_DEV_STAT_READ_ERRS + 1)
456 printf("[%s].read_io_errs %llu\n",
457 canonical_path,
458 (unsigned long long) args.values[
459 BTRFS_DEV_STAT_READ_ERRS]);
460 if (args.nr_items >= BTRFS_DEV_STAT_FLUSH_ERRS + 1)
461 printf("[%s].flush_io_errs %llu\n",
462 canonical_path,
463 (unsigned long long) args.values[
464 BTRFS_DEV_STAT_FLUSH_ERRS]);
465 if (args.nr_items >= BTRFS_DEV_STAT_CORRUPTION_ERRS + 1)
466 printf("[%s].corruption_errs %llu\n",
467 canonical_path,
468 (unsigned long long) args.values[
469 BTRFS_DEV_STAT_CORRUPTION_ERRS]);
470 if (args.nr_items >= BTRFS_DEV_STAT_GENERATION_ERRS + 1)
471 printf("[%s].generation_errs %llu\n",
472 canonical_path,
473 (unsigned long long) args.values[
474 BTRFS_DEV_STAT_GENERATION_ERRS]);
476 free(canonical_path);
480 out:
481 free(di_args);
482 close_file_or_dir(fdmnt, dirstream);
484 return err;
487 static const char * const cmd_device_usage_usage[] = {
488 "btrfs device usage [options] <path> [<path>..]",
489 "Show detailed information about internal allocations in devices.",
490 HELPINFO_UNITS_SHORT_LONG,
491 NULL
494 static int _cmd_device_usage(int fd, char *path, unsigned unit_mode)
496 int i;
497 int ret = 0;
498 struct chunk_info *chunkinfo = NULL;
499 struct device_info *devinfo = NULL;
500 int chunkcount = 0;
501 int devcount = 0;
503 ret = load_chunk_and_device_info(fd, &chunkinfo, &chunkcount, &devinfo,
504 &devcount);
505 if (ret)
506 goto out;
508 for (i = 0; i < devcount; i++) {
509 printf("%s, ID: %llu\n", devinfo[i].path, devinfo[i].devid);
510 print_device_sizes(fd, &devinfo[i], unit_mode);
511 print_device_chunks(fd, &devinfo[i], chunkinfo, chunkcount,
512 unit_mode);
513 printf("\n");
516 out:
517 free(devinfo);
518 free(chunkinfo);
520 return ret;
523 static int cmd_device_usage(int argc, char **argv)
525 unsigned unit_mode;
526 int ret = 0;
527 int i;
529 unit_mode = get_unit_mode_from_arg(&argc, argv, 1);
531 clean_args_no_options(argc, argv, cmd_device_usage_usage);
533 if (check_argc_min(argc - optind, 1))
534 usage(cmd_device_usage_usage);
536 for (i = optind; i < argc; i++) {
537 int fd;
538 DIR *dirstream = NULL;
540 if (i > 1)
541 printf("\n");
543 fd = btrfs_open_dir(argv[i], &dirstream, 1);
544 if (fd < 0) {
545 ret = 1;
546 break;
549 ret = _cmd_device_usage(fd, argv[i], unit_mode);
550 close_file_or_dir(fd, dirstream);
552 if (ret)
553 break;
556 return !!ret;
559 static const char device_cmd_group_info[] =
560 "manage and query devices in the filesystem";
562 const struct cmd_group device_cmd_group = {
563 device_cmd_group_usage, device_cmd_group_info, {
564 { "add", cmd_device_add, cmd_device_add_usage, NULL, 0 },
565 { "delete", cmd_device_delete, cmd_device_delete_usage, NULL,
566 CMD_ALIAS },
567 { "remove", cmd_device_remove, cmd_device_remove_usage, NULL, 0 },
568 { "scan", cmd_device_scan, cmd_device_scan_usage, NULL, 0 },
569 { "ready", cmd_device_ready, cmd_device_ready_usage, NULL, 0 },
570 { "stats", cmd_device_stats, cmd_device_stats_usage, NULL, 0 },
571 { "usage", cmd_device_usage,
572 cmd_device_usage_usage, NULL, 0 },
573 NULL_CMD_STRUCT
577 int cmd_device(int argc, char **argv)
579 return handle_command_group(&device_cmd_group, argc, argv);