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.
22 #include "kerncompat.h"
23 #include "btrfs_cmds.h"
27 #define ADVANCED_HELP 1
29 typedef int (*CommandFunction)(int argc, char **argv);
32 CommandFunction func; /* function which implements the command */
33 int nargs; /* if == 999, any number of arguments
34 if >= 0, number of arguments,
35 if < 0, _minimum_ number of arguments */
36 char *verb; /* verb */
37 char *help; /* help lines; from the 2nd line onward they
38 are automatically indented */
39 char *adv_help; /* advanced help message; from the 2nd line
40 onward they are automatically indented */
42 /* the following fields are run-time filled by the program */
43 char **cmds; /* array of subcommands */
44 int ncmds; /* number of subcommand */
47 static struct Command commands[] = {
50 avoid short commands different for the case only
53 "subvolume snapshot", "[-r] <source> [<dest>/]<name>\n"
54 "Create a writable/readonly snapshot of the subvolume <source> with\n"
55 "the name <name> in the <dest> directory.",
58 { do_delete_subvolume, 1,
59 "subvolume delete", "<subvolume>\n"
60 "Delete the subvolume <subvolume>.",
63 { do_create_subvol, 1,
64 "subvolume create", "[<dest>/]<name>\n"
65 "Create a subvolume in <dest> (or the current directory if\n"
69 { do_subvol_list, -1, "subvolume list", "[-p] <path>\n"
70 "List the snapshot/subvolume of a filesystem.",
72 "List the snapshot/subvolume of a filesystem.\n"
75 { do_set_default_subvol, 2,
76 "subvolume set-default", "<id> <path>\n"
77 "Set the subvolume of the filesystem <path> which will be mounted\n"
81 { do_find_newer, 2, "subvolume find-new", "<path> <last_gen>\n"
82 "List the recently modified files in a filesystem.",
86 "filesystem defragment", "[-vf] [-c[zlib,lzo]] [-s start] [-l len] [-t size] <file>|<dir> [<file>|<dir>...]\n"
87 "Defragment a file or a directory.",
88 "[-vcf] [-s start] [-l len] [-t size] <file>|<dir> [<file>|<dir>...]\n"
89 "Defragment file data or directory metadata.\n"
91 "-c compress the file while defragmenting\n"
92 "-f flush data to disk immediately after defragmenting\n"
93 "-s start defragment only from byte onward\n"
94 "-l len defragment only up to len bytes\n"
95 "-t size minimal size of file to be considered for defragmenting\n"
98 "filesystem sync", "<path>\n"
99 "Force a sync on the filesystem <path>.",
103 "filesystem resize", "[+/-]<newsize>[gkm]|max <filesystem>\n"
104 "Resize the file system. If 'max' is passed, the filesystem\n"
105 "will occupe all available space on the device.",
108 { do_show_filesystem, 999,
109 "filesystem show", "[<device>|<uuid>|<label>]\n"
110 "Show the info of a btrfs filesystem. If no argument\n"
111 "is passed, info of all the btrfs filesystem are shown.",
114 { do_df_filesystem, 1,
115 "filesystem df", "<path>\n"
116 "Show space usage information for a mount point.",
120 "filesystem balance", "<path>\n"
121 "Balance the chunks across the device.",
124 { do_change_label, -1,
125 "filesystem label", "<device> [<newlabel>]\n"
126 "With one argument, get the label of filesystem on <device>.\n"
127 "If <newlabel> is passed, set the filesystem label to <newlabel>.\n"
128 "The filesystem must be unmounted.\n"
131 "device scan", "[<device>...]\n"
132 "Scan all device for or the passed device for a btrfs\n"
137 "device add", "<device> [<device>...] <path>\n"
138 "Add a device to a filesystem.",
141 { do_remove_volume, -2,
142 "device delete", "<device> [<device>...] <path>\n"
143 "Remove a device from a filesystem.",
149 static char *get_prgname(char *programname)
152 np = strrchr(programname,'/');
161 static void print_help(char *programname, struct Command *cmd, int helptype)
165 printf("\t%s %s ", programname, cmd->verb );
167 if (helptype == ADVANCED_HELP && cmd->adv_help)
168 for(pc = cmd->adv_help; *pc; pc++){
174 for(pc = cmd->help; *pc; pc++){
183 static void help(char *np)
188 for( cp = commands; cp->verb; cp++ )
189 print_help(np, cp, BASIC_HELP);
191 printf("\n\t%s help|--help|-h\n\t\tShow the help.\n",np);
192 printf("\n\t%s <cmd> --help\n\t\tShow detailed help for a command or\n\t\t"
193 "subset of commands.\n",np);
194 printf("\n%s\n", BTRFS_BUILD_VERSION);
197 static int split_command(char *cmd, char ***commands)
202 for( *commands = 0, l = c = 0, p = s = cmd ; ; p++, l++ ){
203 if ( *p && *p != ' ' )
206 /* c + 2 so that we have room for the null */
207 (*commands) = realloc( (*commands), sizeof(char *)*(c + 2));
208 (*commands)[c] = strndup(s, l);
220 This function checks if the passed command is ambiguous
222 static int check_ambiguity(struct Command *cmd, char **argv){
225 /* check for ambiguity */
226 for( i = 0 ; i < cmd->ncmds ; i++ ){
228 for( match = 0, cp = commands; cp->verb; cp++ ){
235 for( skip = 0, j = 0 ; j < i ; j++ )
236 if( strcmp(cmd->cmds[j], cp->cmds[j])){
243 if( !strcmp(cmd->cmds[i], cp->cmds[i]))
245 for(s2 = cp->cmds[i], s1 = argv[i+1];
246 *s1 == *s2 && *s1; s1++, s2++ ) ;
252 fprintf(stderr, "ERROR: in command '");
253 for( j = 0 ; j <= i ; j++ )
254 fprintf(stderr, "%s%s",j?" ":"", argv[j+1]);
255 fprintf(stderr, "', '%s' is ambiguous\n",argv[j]);
263 * This function, compacts the program name and the command in the first
264 * element of the '*av' array
266 static int prepare_args(int *ac, char ***av, char *prgname, struct Command *cmd ){
272 ret = (char **)malloc(sizeof(char*)*(*ac+1));
273 newname = (char*)malloc(strlen(prgname)+strlen(cmd->verb)+2);
274 if( !ret || !newname ){
281 for(i=0; i < *ac ; i++ )
284 strcpy(newname, prgname);
285 strcat(newname, " ");
286 strcat(newname, cmd->verb);
298 This function performs the following jobs:
299 - show the help if '--help' or 'help' or '-h' are passed
300 - verify that a command is not ambiguous, otherwise show which
301 part of the command is ambiguous
302 - if after a (even partial) command there is '--help' show detailed help
303 for all the matching commands
304 - if the command doesn't match show an error
305 - finally, if a command matches, they return which command matched and
308 The function return 0 in case of help is requested; <0 in case
309 of uncorrect command; >0 in case of matching commands
310 argc, argv are the arg-counter and arg-vector (input)
311 *nargs_ is the number of the arguments after the command (output)
312 **cmd_ is the invoked command (output)
313 ***args_ are the arguments after the command
316 static int parse_args(int argc, char **argv,
317 CommandFunction *func_,
318 int *nargs_, char **cmd_, char ***args_ )
321 struct Command *matchcmd=0;
322 char *prgname = get_prgname(argv[0]);
323 int i=0, helprequested=0;
325 if( argc < 2 || !strcmp(argv[1], "help") ||
326 !strcmp(argv[1], "-h") || !strcmp(argv[1], "--help")){
331 for( cp = commands; cp->verb; cp++ )
333 cp->ncmds = split_command(cp->verb, &(cp->cmds));
335 for( cp = commands; cp->verb; cp++ ){
338 if( argc-1 < cp->ncmds )
340 for( match = 1, i = 0 ; i < cp->ncmds ; i++ ){
345 for(s2 = cp->cmds[i], s1 = argv[i+1];
354 /* If you understand why this code works ...
355 you are a genious !! */
356 if(argc>i+1 && !strcmp(argv[i+1],"--help")){
359 print_help(prgname, cp, ADVANCED_HELP);
368 *nargs_ = argc-matchcmd->ncmds-1;
369 *cmd_ = matchcmd->verb;
370 *args_ = argv+matchcmd->ncmds+1;
377 printf("\n%s\n", BTRFS_BUILD_VERSION);
382 fprintf( stderr, "ERROR: unknown command '%s'\n",argv[1]);
387 if(check_ambiguity(matchcmd, argv))
390 /* check the number of argument */
391 if (matchcmd->nargs < 0 && matchcmd->nargs < -*nargs_ ){
392 fprintf(stderr, "ERROR: '%s' requires minimum %d arg(s)\n",
393 matchcmd->verb, -matchcmd->nargs);
396 if(matchcmd->nargs >= 0 && matchcmd->nargs != *nargs_ && matchcmd->nargs != 999){
397 fprintf(stderr, "ERROR: '%s' requires %d arg(s)\n",
398 matchcmd->verb, matchcmd->nargs);
402 if (prepare_args( nargs_, args_, prgname, matchcmd )){
403 fprintf(stderr, "ERROR: not enough memory\\n");
410 int main(int ac, char **av )
413 char *cmd=0, **args=0;
415 CommandFunction func=0;
417 r = parse_args(ac, av, &func, &nargs, &cmd, &args);
419 /* error or no command to parse*/
423 exit(func(nargs, args));