btrfs-progs: check: introduce function to check fs root

[platform/upstream/btrfs-progs.git] / help.c

diff --git a/help.c b/help.c
index 6d04293..c8bb720 100644 (file)
--- a/help.c
+++ b/help.c
@@ -17,10 +17,10 @@
 #include <stdio.h>
 #include <stdlib.h>
 #include <string.h>
+#include <limits.h>
 
 #include "commands.h"
-
-extern char argv0_buf[ARGV0_BUF_SIZE];
+#include "utils.h"
 
 #define USAGE_SHORT            1U
 #define USAGE_LONG             2U
@@ -35,7 +35,7 @@ static int do_usage_one_command(const char * const *usagestr,
        if (!usagestr || !*usagestr)
                return -1;
 
-       fprintf(outf, "%s%s\n", (flags & USAGE_LISTING) ? "    " : "usage: ",
+       fprintf(outf, "%s%s", (flags & USAGE_LISTING) ? "    " : "usage: ",
                *usagestr++);
 
        /* a short one-line description (mandatory) */
@@ -43,6 +43,7 @@ static int do_usage_one_command(const char * const *usagestr,
                return 0;
        else if (!*usagestr)
                return -2;
+       fputc('\n', outf);
 
        if (flags & USAGE_LISTING)
                pad = 8;
@@ -79,11 +80,13 @@ static int do_usage_one_command(const char * const *usagestr,
 
 static int usage_command_internal(const char * const *usagestr,
                                  const char *token, int full, int lst,
-                                 FILE *outf)
+                                 int alias, FILE *outf)
 {
-       unsigned int flags = USAGE_SHORT;
+       unsigned int flags = 0;
        int ret;
 
+       if (!alias)
+               flags |= USAGE_SHORT;
        if (full)
                flags |= USAGE_LONG | USAGE_OPTIONS;
        if (lst)
@@ -108,7 +111,7 @@ static void usage_command_usagestr(const char * const *usagestr,
        FILE *outf = err ? stderr : stdout;
        int ret;
 
-       ret = usage_command_internal(usagestr, token, full, 0, outf);
+       ret = usage_command_internal(usagestr, token, full, 0, 0, outf);
        if (!ret)
                fputc('\n', outf);
 }
@@ -121,7 +124,7 @@ void usage_command(const struct cmd_struct *cmd, int full, int err)
 void usage(const char * const *usagestr)
 {
        usage_command_usagestr(usagestr, NULL, 1, 1);
-       exit(129);
+       exit(1);
 }
 
 static void usage_command_group_internal(const struct cmd_group *grp, int full,
@@ -131,7 +134,7 @@ static void usage_command_group_internal(const struct cmd_group *grp, int full,
        int do_sep = 0;
 
        for (; cmd->token; cmd++) {
-               if (cmd->hidden)
+               if (cmd->flags & CMD_HIDDEN)
                        continue;
 
                if (full && cmd != grp->commands)
@@ -144,7 +147,7 @@ static void usage_command_group_internal(const struct cmd_group *grp, int full,
                        }
 
                        usage_command_internal(cmd->usagestr, cmd->token, full,
-                                              1, outf);
+                                              1, cmd->flags & CMD_ALIAS, outf);
                        continue;
                }
 
@@ -160,6 +163,50 @@ static void usage_command_group_internal(const struct cmd_group *grp, int full,
        }
 }
 
+void usage_command_group_short(const struct cmd_group *grp)
+{
+       const char * const *usagestr = grp->usagestr;
+       FILE *outf = stdout;
+       const struct cmd_struct *cmd;
+
+       if (usagestr && *usagestr) {
+               fprintf(outf, "usage: %s\n", *usagestr++);
+               while (*usagestr)
+                       fprintf(outf, "   or: %s\n", *usagestr++);
+       }
+
+       fputc('\n', outf);
+
+       fprintf(outf, "Command groups:\n");
+       for (cmd = grp->commands; cmd->token; cmd++) {
+               if (cmd->flags & CMD_HIDDEN)
+                       continue;
+
+               if (!cmd->next)
+                       continue;
+
+               fprintf(outf, "  %-16s  %s\n", cmd->token, cmd->next->infostr);
+       }
+
+       fprintf(outf, "\nCommands:\n");
+       for (cmd = grp->commands; cmd->token; cmd++) {
+               if (cmd->flags & CMD_HIDDEN)
+                       continue;
+
+               if (cmd->next)
+                       continue;
+
+               fprintf(outf, "  %-16s  %s\n", cmd->token, cmd->usagestr[1]);
+       }
+
+       fputc('\n', outf);
+       fprintf(stderr, "For an overview of a given command use 'btrfs command --help'\n");
+       fprintf(stderr, "or 'btrfs [command...] --help --full' to print all available options.\n");
+       fprintf(stderr, "Any command name can be shortened as far as it stays unambiguous,\n");
+       fprintf(stderr, "however it is recommended to use full command names in scripts.\n");
+       fprintf(stderr, "All command groups have their manual page named 'btrfs-<group>'.\n");
+}
+
 void usage_command_group(const struct cmd_group *grp, int full, int err)
 {
        const char * const *usagestr = grp->usagestr;
@@ -181,7 +228,7 @@ void usage_command_group(const struct cmd_group *grp, int full, int err)
 
 void help_unknown_token(const char *arg, const struct cmd_group *grp)
 {
-       fprintf(stderr, "%s: unknown token '%s'\n", argv0_buf, arg);
+       fprintf(stderr, "%s: unknown token '%s'\n", get_argv0_buf(), arg);
        usage_command_group(grp, 0, 1);
        exit(1);
 }
@@ -190,7 +237,7 @@ void help_ambiguous_token(const char *arg, const struct cmd_group *grp)
 {
        const struct cmd_struct *cmd = grp->commands;
 
-       fprintf(stderr, "%s: ambiguous token '%s'\n", argv0_buf, arg);
+       fprintf(stderr, "%s: ambiguous token '%s'\n", get_argv0_buf(), arg);
        fprintf(stderr, "\nDid you mean one of these ?\n");
 
        for (; cmd->token; cmd++) {
@@ -212,3 +259,13 @@ void help_command_group(const struct cmd_group *grp, int argc, char **argv)
 
        usage_command_group(grp, full, 0);
 }
+
+int prefixcmp(const char *str, const char *prefix)
+{
+       for (; ; str++, prefix++)
+               if (!*prefix)
+                       return 0;
+               else if (*str != *prefix)
+                       return (unsigned char)*prefix - (unsigned char)*str;
+}
+