/* Setstripe and migrate share mostly the same parameters */
#define SSM_CMD_COMMON(cmd) \
- "usage: "cmd" [--stripe-count|-c <stripe_count>]\n" \
+ "usage: "cmd" [--component-end|-E <comp_end>]\n" \
+ " [--stripe-count|-c <stripe_count>]\n" \
" [--stripe-index|-i <start_ost_idx>]\n" \
" [--stripe-size|-S <stripe_size>]\n" \
" [--layout|-L <pattern>]\n" \
" [--pool|-p <pool_name>]\n" \
- " [--ost|-o <ost_indices>]\n" \
- " [--component-end|-E <comp_end>]\n"
+ " [--ost|-o <ost_indices>]\n"
#define SSM_HELP_COMMON \
- "\tstripe_size: Number of bytes on each OST (0 filesystem default)\n" \
- "\t Can be specified with k, m or g (in KB, MB and GB\n" \
+ "\tstripe_count: Number of OSTs to stripe over (0=fs default, -1 all)\n" \
+ "\tstart_ost_idx: OST index of first stripe (-1=default round robin)\n"\
+ "\tstripe_size: Number of bytes on each OST (0=fs default)\n" \
+ "\t Can be specified with K, M or G (for KB, MB, GB\n" \
"\t respectively)\n" \
- "\tstart_ost_idx: OST index of first stripe (-1 default)\n" \
- "\tstripe_count: Number of OSTs to stripe over (0 default, -1 all)\n" \
"\tpool_name: Name of OST pool to use (default none)\n" \
"\tlayout: stripe pattern type: raid0, mdt (default raid0)\n"\
"\tost_indices: List of OST indices, can be repeated multiple times\n"\
"\t Or:\n" \
"\t -o <ost_1> -o <ost_i>-<ost_j> -o <ost_n>\n" \
"\t If --pool is set with --ost, then the OSTs\n" \
- "\t must be the members of the pool." \
- "\tcomp_end: Extent end of the component\n" \
- "\t Can be specified with k, m or g (in KB, MB and GB\n" \
- "\t respectively, -1 for EOF), it must be aligned with\n"\
- "\t the stripe_size\n"
+ "\t must be the members of the pool.\n" \
+ "\tcomp_end: Extent end of component, start after previous end.\n"\
+ "\t Can be specified with K, M or G (for KB, MB, GB\n" \
+ "\t respectively, -1 for EOF). Must be a multiple of\n"\
+ "\t stripe_size.\n"
-#define SETSTRIPE_USAGE \
- SSM_CMD_COMMON("setstripe") \
- " <directory|filename>\n" \
- SSM_HELP_COMMON \
#define MIGRATE_USAGE \
SSM_CMD_COMMON("migrate ") \
/* all available commands */
command_t cmdlist[] = {
{"setstripe", lfs_setstripe, 0,
- "Create a new file with a specific striping pattern or\n"
- "set the default striping pattern on an existing directory or\n"
- "delete the default striping pattern from an existing directory or\n"
- "add layout component(s) to an existing composite file or\n"
- "delete specified component(s) from an existing composite file\n\n"
- "To delete default striping from an existing directory:\n"
+ "To create a file with specified striping/composite layout, or\n"
+ "create/replace the default layout on an existing directory:\n"
+ SSM_CMD_COMMON("setstripe")
+ " <directory|filename>\n"
+ " or\n"
+ "To add component(s) to an existing composite file:\n"
+ SSM_CMD_COMMON("setstripe --component-add")
+ SSM_HELP_COMMON
+ "To totally delete the default striping from an existing directory:\n"
"usage: setstripe -d <directory>\n"
" or\n"
- "To delete component(s) from an existing composite file:\n"
+ "To delete the last component(s) from an existing composite file\n"
+ "(note that this will also delete any data in those components):\n"
"usage: setstripe --component-del [--component-id|-I <comp_id>]\n"
" [--component-flags|-F <comp_flags>]\n"
" <filename>\n"
- "\tcomp_id: Unique component ID\n"
+ "\tcomp_id: Unique component ID to delete\n"
"\tcomp_flags: 'init' indicating all instantiated components\n"
- "\t '^init' indicating all uninstantiated components\n"
- "\t-I and -F can't be specified at the same time\n"
- " or\n"
- "To add component(s) to an existing composite file:\n"
- SSM_CMD_COMMON("setstripe --component-add")
- " or\n"
- "To create a file with specified striping/composite layout:\n"
- SETSTRIPE_USAGE},
+ "\t '^init' indicating all uninstantiated components\n"
+ "\t-I and -F cannot be specified at the same time\n"},
{"getstripe", lfs_getstripe, 0,
"To list the striping info for a given file or files in a\n"
"directory or recursively for all files in a directory tree.\n"
fd = llapi_layout_file_open(fname, open_flags, open_mode, layout);
if (fd < 0)
- fprintf(stderr, "%s %s failed. %s\n",
+ fprintf(stderr, "%s: cannot %s '%s': %s\n", progname,
S_ISDIR(st.st_mode) ?
- "Set default composite layout to " :
- "Create composite file",
+ "set default composite layout for" :
+ "create composite file",
fname, strerror(errno));
return fd;
}
fd = open(name, O_RDWR | O_DIRECT);
if (fd == -1) {
rc = -errno;
- fprintf(stderr, "%s: %s: cannot open: %s\n", progname, name,
+ fprintf(stderr, "%s: cannot open '%s': %s\n", progname, name,
strerror(-rc));
goto free;
}
}
}
if (!found) {
- llapi_printf(LLAPI_MSG_ERROR, "Component flag "
- "'%s' is not supported.\n", name);
+ llapi_printf(LLAPI_MSG_ERROR,
+ "%s: component flag '%s' not supported\n",
+ progname, name);
return -EINVAL;
}
}
{ .val = LFS_COMP_SET_OPT,
.name = "component-set",
.has_arg = no_argument},
-#if LUSTRE_VERSION_CODE < OBD_OCD_VERSION(2, 9, 59, 0)
- /* This formerly implied "stripe-count", but was explicitly
- * made "stripe-count" for consistency with other options,
- * and to separate it from "mdt-count" when DNE arrives. */
- { .val = 'c', .name = "count", .has_arg = required_argument },
-#endif
{ .val = 'c', .name = "stripe-count", .has_arg = required_argument},
{ .val = 'c', .name = "stripe_count", .has_arg = required_argument},
{ .val = 'd', .name = "delete", .has_arg = no_argument},
{ .val = 'E', .name = "component-end",
.has_arg = required_argument},
/* dirstripe {"mdt-hash", required_argument, 0, 'H'}, */
-#if LUSTRE_VERSION_CODE < OBD_OCD_VERSION(2, 9, 59, 0)
- /* This formerly implied "stripe-index", but was explicitly
- * made "stripe-index" for consistency with other options,
- * and to separate it from "mdt-index" when DNE arrives. */
- { .val = 'i', .name = "index", .has_arg = required_argument },
-#endif
{ .val = 'i', .name = "stripe-index", .has_arg = required_argument},
{ .val = 'i', .name = "stripe_index", .has_arg = required_argument},
{ .val = 'I', .name = "comp-id", .has_arg = required_argument},
{ .val = 'o', .name = "ost_list", .has_arg = required_argument },
#endif
{ .val = 'p', .name = "pool", .has_arg = required_argument },
-#if LUSTRE_VERSION_CODE < OBD_OCD_VERSION(2, 9, 59, 0)
- /* This formerly implied "--stripe-size", but was confusing
- * with "lfs find --size|-s", which means "file size", so use
- * the consistent "--stripe-size|-S" for all commands. */
- { .val = 's', .name = "size", .has_arg = required_argument },
-#endif
{ .val = 'S', .name = "stripe-size", .has_arg = required_argument },
{ .val = 'S', .name = "stripe_size", .has_arg = required_argument },
/* dirstripe {"mdt-count", required_argument, 0, 'T'}, */
break;
case LFS_COMP_FLAGS_OPT:
result = comp_str2flags(&lsa.lsa_comp_flags, optarg);
- if (result != 0) {
- fprintf(stderr, "error: %s: bad comp flags "
- "'%s'\n", argv[0], optarg);
- goto error;
- }
+ if (result != 0)
+ goto usage_error;
break;
case LFS_COMP_SET_OPT:
comp_set = 1;
break;
case 'b':
if (!migrate_mode) {
- fprintf(stderr, "--block is valid only for"
- " migrate mode\n");
- goto error;
+ fprintf(stderr,
+ "%s %s: -b|--block valid only for migrate command\n",
+ progname, argv[0]);
+ goto usage_error;
}
migration_block = true;
break;
case 'c':
-#if LUSTRE_VERSION_CODE >= OBD_OCD_VERSION(2, 6, 53, 0)
- if (strcmp(argv[optind - 1], "--count") == 0)
- fprintf(stderr, "warning: '--count' deprecated"
- ", use '--stripe-count' instead\n");
-#endif
lsa.lsa_stripe_count = strtoul(optarg, &end, 0);
if (*end != '\0') {
- fprintf(stderr, "error: %s: bad stripe count "
- "'%s'\n", argv[0], optarg);
- goto error;
+ fprintf(stderr,
+ "%s %s: invalid stripe count '%s'\n",
+ progname, argv[0], optarg);
+ goto usage_error;
}
break;
case 'd':
case 'E':
if (lsa.lsa_comp_end != 0) {
result = comp_args_to_layout(&layout, &lsa);
- if (result)
- goto error;
+ if (result) {
+ fprintf(stderr,
+ "%s %s: invalid layout\n",
+ progname, argv[0]);
+ goto usage_error;
+ }
setstripe_args_init(&lsa);
}
&lsa.lsa_comp_end,
&size_units, 0);
if (result) {
- fprintf(stderr, "error: %s: "
- "bad component end '%s'\n",
- argv[0], optarg);
- goto error;
+ fprintf(stderr,
+ "%s %s: invalid component end '%s'\n",
+ progname, argv[0], optarg);
+ goto usage_error;
}
}
break;
case 'i':
- if (strcmp(argv[optind - 1], "--index") == 0)
- fprintf(stderr, "warning: '--index' deprecated"
- ", use '--stripe-index' instead\n");
lsa.lsa_stripe_off = strtol(optarg, &end, 0);
if (*end != '\0') {
- fprintf(stderr, "error: %s: bad stripe offset "
- "'%s'\n", argv[0], optarg);
- goto error;
+ fprintf(stderr,
+ "%s %s: invalid stripe offset '%s'\n",
+ progname, argv[0], optarg);
+ goto usage_error;
}
break;
case 'I':
comp_id = strtoul(optarg, &end, 0);
if (*end != '\0' || comp_id == 0 ||
comp_id > LCME_ID_MAX) {
- fprintf(stderr, "error: %s: bad comp ID "
- "'%s'\n", argv[0], optarg);
- goto error;
+ fprintf(stderr,
+ "%s %s: invalid component ID '%s'\n",
+ progname, argv[0], optarg);
+ goto usage_error;
}
break;
case 'L':
break;
case 'm':
if (!migrate_mode) {
- fprintf(stderr, "--mdt-index is valid only for"
- " migrate mode\n");
- goto error;
+ fprintf(stderr,
+ "%s %s: -m|--mdt-index valid only for migrate command\n",
+ progname, argv[0]);
+ goto usage_error;
}
mdt_idx_arg = optarg;
break;
case 'n':
if (!migrate_mode) {
- fprintf(stderr, "--non-block is valid only for"
- " migrate mode\n");
- goto error;
+ fprintf(stderr,
+ "%s %s: -n|--non-block valid only for migrate command\n",
+ progname, argv[0]);
+ goto usage_error;
}
migration_flags |= MIGRATION_NONBLOCK;
break;
lsa.lsa_nr_osts, optarg);
if (lsa.lsa_nr_osts < 0) {
fprintf(stderr,
- "error: %s: bad OST indices '%s'\n",
- argv[0], optarg);
- goto error;
+ "%s %s: invalid OST target(s) '%s'\n",
+ progname, argv[0], optarg);
+ goto usage_error;
}
lsa.lsa_osts = osts;
break;
case 'p':
if (optarg == NULL)
- goto error;
+ goto usage_error;
lsa.lsa_pool_name = optarg;
break;
-#if LUSTRE_VERSION_CODE < OBD_OCD_VERSION(2, 9, 59, 0)
- case 's':
-#if LUSTRE_VERSION_CODE >= OBD_OCD_VERSION(2, 6, 53, 0)
- fprintf(stderr, "warning: '--size|-s' deprecated, "
- "use '--stripe-size|-S' instead\n");
-#endif
-#endif /* LUSTRE_VERSION_CODE < OBD_OCD_VERSION(2, 9, 59, 0) */
case 'S':
result = llapi_parse_size(optarg, &lsa.lsa_stripe_size,
&size_units, 0);
if (result) {
- fprintf(stderr, "error: %s: bad stripe size "
- "'%s'\n", argv[0], optarg);
- goto error;
+ fprintf(stderr,
+ "%s %s: invalid stripe size '%s'\n",
+ progname, argv[0], optarg);
+ goto usage_error;
}
break;
case 'v':
if (!migrate_mode) {
- fprintf(stderr, "--verbose is valid only for"
- " migrate mode\n");
- goto error;
+ fprintf(stderr,
+ "%s %s: -v|--verbose valid only for migrate command\n",
+ progname, argv[0]);
+ goto usage_error;
}
migrate_mdt_param.fp_verbose = VERBOSE_DETAIL;
break;
default:
- goto error;
+ fprintf(stderr, "%s %s: unrecognized option '%s'\n",
+ progname, argv[0], argv[optind - 1]);
+ goto usage_error;
}
}
if (lsa.lsa_comp_end != 0) {
result = comp_args_to_layout(&layout, &lsa);
- if (result)
- goto error;
+ if (result) {
+ fprintf(stderr, "%s %s: invalid component layout\n",
+ progname, argv[0]);
+ goto usage_error;
+ }
}
if (optind == argc) {
- fprintf(stderr, "error: %s: missing filename|dirname\n",
- argv[0]);
- goto error;
+ fprintf(stderr, "%s %s: FILE must be specified\n",
+ progname, argv[0]);
+ goto usage_error;
}
/* Only LCME_FL_INIT flags is used in PFL, and it shouldn't be
* altered by user space tool, so we don't need to support the
* --component-set for this moment. */
if (comp_set != 0) {
- fprintf(stderr, "error: %s: --component-set isn't supported.\n",
- argv[0]);
- goto error;
+ fprintf(stderr, "%s %s: --component-set not supported\n",
+ progname, argv[0]);
+ goto usage_error;
}
if ((delete + comp_set + comp_del + comp_add) > 1) {
- fprintf(stderr, "error: %s: can't specify --component-set, "
- "--component-del, --component-add or -d together\n",
- argv[0]);
- goto error;
+ fprintf(stderr,
+ "%s %s: options --component-set, --component-del, --component-add and -d are mutually exclusive\n",
+ progname, argv[0]);
+ goto usage_error;
}
if (delete && (setstripe_args_specified(&lsa) || comp_id != 0 ||
lsa.lsa_comp_flags != 0 || layout != NULL)) {
- fprintf(stderr, "error: %s: can't specify -d with "
- "-s, -c, -o, -p, -I, -F or -E options\n",
- argv[0]);
- goto error;
+ fprintf(stderr,
+ "%s %s: option -d is mutually exclusive with -s, -c, -o, -p, -I, -F and -E options\n",
+ progname, argv[0]);
+ goto usage_error;
}
if ((comp_set || comp_del) &&
(setstripe_args_specified(&lsa) || layout != NULL)) {
- fprintf(stderr, "error: %s: can't specify --component-del or "
- "--component-set with -s, -c, -o, -p or -E options.\n",
- argv[0]);
- goto error;
+ fprintf(stderr,
+ "%s %s: options --component-del and --component-set are mutually exclusive when used with -c, -E, -o, -p, or -s\n",
+ progname, argv[0]);
+ goto usage_error;
}
if (comp_del && comp_id != 0 && lsa.lsa_comp_flags != 0) {
- fprintf(stderr, "error: %s: can't specify both -I and -F for "
- "--component-del option.\n", argv[0]);
- goto error;
+ fprintf(stderr,
+ "%s %s: options -I and -F are mutually exclusive when used with --component-del\n",
+ progname, argv[0]);
+ goto usage_error;
}
if (comp_add || comp_del) {
result = lstat(fname, &st);
if (result == 0 && S_ISDIR(st.st_mode)) {
- fprintf(stderr, "error: %s: can't use --component-add "
- "or --component-del for directory.\n",
- argv[0]);
- goto error;
+ fprintf(stderr,
+ "%s setstripe: cannot use --component-add or --component-del for directory\n",
+ progname);
+ goto usage_error;
}
}
if (comp_add) {
if (layout == NULL) {
- fprintf(stderr, "error: %s: -E option must be present"
- "in --component-add mode.\n", argv[0]);
- goto error;
+ fprintf(stderr,
+ "%s %s: option -E must be specified with --component-add\n",
+ progname, argv[0]);
+ goto usage_error;
}
result = adjust_first_extent(fname, layout);
if (result == -ENODATA)
}
if (mdt_idx_arg != NULL && optind > 3) {
- fprintf(stderr, "error: %s: cannot specify -m with other "
- "options\n", argv[0]);
- goto error;
+ fprintf(stderr,
+ "%s %s: option -m cannot be used with other options\n",
+ progname, argv[0]);
+ goto usage_error;
}
if ((migration_flags & MIGRATION_NONBLOCK) && migration_block) {
fprintf(stderr,
- "error: %s: cannot specify --non-block and --block\n",
- argv[0]);
- goto error;
+ "%s %s: options --non-block and --block are mutually exclusive\n",
+ progname, argv[0]);
+ goto usage_error;
}
if (!comp_del && !comp_set && comp_id != 0) {
- fprintf(stderr, "error: %s: -I can only be used with "
- "--component-del.\n", argv[0]);
- goto error;
+ fprintf(stderr,
+ "%s %s: option -I can only be used with --component-del\n",
+ progname, argv[0]);
+ goto usage_error;
}
if (mdt_idx_arg != NULL) {
/* initialize migrate mdt parameters */
migrate_mdt_param.fp_mdt_index = strtoul(mdt_idx_arg, &end, 0);
if (*end != '\0') {
- fprintf(stderr, "error: %s: bad MDT index '%s'\n",
- argv[0], mdt_idx_arg);
- goto error;
+ fprintf(stderr, "%s %s: invalid MDT index '%s'\n",
+ progname, argv[0], mdt_idx_arg);
+ goto usage_error;
}
migrate_mdt_param.fp_migrate = 1;
} else if (layout == NULL) {
param = calloc(1, offsetof(typeof(*param),
lsp_osts[lsa.lsa_nr_osts]));
if (param == NULL) {
- fprintf(stderr, "error: %s: %s\n", argv[0],
- strerror(ENOMEM));
+ fprintf(stderr,
+ "%s %s: cannot allocate memory for parameters: %s\n",
+ progname, argv[0], strerror(ENOMEM));
+ result = -ENOMEM;
goto error;
}
if (lsa.lsa_nr_osts > 0) {
if (lsa.lsa_stripe_count > 0 &&
lsa.lsa_nr_osts != lsa.lsa_stripe_count) {
- fprintf(stderr, "error: %s: stripe count '%d' "
- "doesn't match the number of OSTs: %d\n"
- , argv[0], lsa.lsa_stripe_count,
+ fprintf(stderr,
+ "%s %s: stripe count '%d' does not match number of OSTs: %d\n",
+ progname, argv[0], lsa.lsa_stripe_count,
lsa.lsa_nr_osts);
free(param);
- goto error;
+ goto usage_error;
}
param->lsp_is_specific = true;
}
for (fname = argv[optind]; fname != NULL; fname = argv[++optind]) {
- char *op;
if (mdt_idx_arg != NULL) {
result = llapi_migrate_mdt(fname, &migrate_mdt_param);
- op = "migrate mdt objects of";
} else if (migrate_mode) {
result = lfs_migrate(fname, migration_flags, param,
layout);
- op = "migrate ost objects of";
} else if (comp_set != 0) {
result = lfs_component_set(fname, comp_id,
lsa.lsa_comp_flags);
- op = "modify component flags of";
} else if (comp_del != 0) {
result = lfs_component_del(fname, comp_id,
lsa.lsa_comp_flags);
- op = "delete component of";
} else if (comp_add != 0) {
result = lfs_component_add(fname, layout);
- op = "add component to";
} else if (layout != NULL) {
result = lfs_component_create(fname, O_CREAT | O_WRONLY,
0644, layout);
close(result);
result = 0;
}
- op = "create composite";
} else {
result = llapi_file_open_param(fname,
O_CREAT | O_WRONLY,
close(result);
result = 0;
}
- op = "create striped";
}
if (result) {
/* Save the first error encountered. */
if (result2 == 0)
result2 = result;
- fprintf(stderr, "error: %s: %s file '%s' failed: %s\n",
- argv[0], op, fname,
- lsa.lsa_pool_name != NULL && result == EINVAL ?
- "OST not in pool?" : strerror(errno));
continue;
}
}
free(param);
llapi_layout_free(layout);
return result2;
+usage_error:
+ result = CMD_HELP;
error:
llapi_layout_free(layout);
- return CMD_HELP;
+ return result;
}
static int lfs_poollist(int argc, char **argv)
break;
default:
rc = -ENOTSUP;
- break;
+ pass++;
+ goto out;
}
if (rc)
name = "<unknown>";
int main(int argc, char **argv)
{
- int rc;
+ int rc;
/* Ensure that liblustreapi constructor has run */
if (!liblustreapi_initialized)
fprintf(stderr, "liblustreapi was not properly initialized\n");
- setlinebuf(stdout);
+ setlinebuf(stdout);
+ opterr = 0;
Parser_init("lfs > ", cmdlist);
progname = argv[0]; /* Used in error messages */
- if (argc > 1) {
- rc = Parser_execarg(argc - 1, argv + 1, cmdlist);
- } else {
- rc = Parser_commands();
- }
+ if (argc > 1)
+ rc = Parser_execarg(argc - 1, argv + 1, cmdlist);
+ else
+ rc = Parser_commands();
- return rc < 0 ? -rc : rc;
+ return rc < 0 ? -rc : rc;
}
#ifdef _LUSTRE_IDL_H_
git://git.whamcloud.com / fs / lustre-release.git / blobdiff