git-add -i: add help text for list-and-choose UI
[git/jnareb-git/bp-gitweb.git] / git.c
bloba5adc3487d4ca62a9ff93679ce8711a578a5c3eb
1 #include "builtin.h"
2 #include "exec_cmd.h"
3 #include "cache.h"
4 #include "quote.h"
6 const char git_usage_string[] =
7 "git [--version] [--exec-path[=GIT_EXEC_PATH]] [-p|--paginate|--no-pager] [--bare] [--git-dir=GIT_DIR] [--work-tree=GIT_WORK_TREE] [--help] COMMAND [ARGS]";
9 static int handle_options(const char*** argv, int* argc, int* envchanged)
11 int handled = 0;
13 while (*argc > 0) {
14 const char *cmd = (*argv)[0];
15 if (cmd[0] != '-')
16 break;
19 * For legacy reasons, the "version" and "help"
20 * commands can be written with "--" prepended
21 * to make them look like flags.
23 if (!strcmp(cmd, "--help") || !strcmp(cmd, "--version"))
24 break;
27 * Check remaining flags.
29 if (!prefixcmp(cmd, "--exec-path")) {
30 cmd += 11;
31 if (*cmd == '=')
32 git_set_argv_exec_path(cmd + 1);
33 else {
34 puts(git_exec_path());
35 exit(0);
37 } else if (!strcmp(cmd, "-p") || !strcmp(cmd, "--paginate")) {
38 setup_pager();
39 } else if (!strcmp(cmd, "--no-pager")) {
40 setenv("GIT_PAGER", "cat", 1);
41 if (envchanged)
42 *envchanged = 1;
43 } else if (!strcmp(cmd, "--git-dir")) {
44 if (*argc < 2) {
45 fprintf(stderr, "No directory given for --git-dir.\n" );
46 usage(git_usage_string);
48 setenv(GIT_DIR_ENVIRONMENT, (*argv)[1], 1);
49 if (envchanged)
50 *envchanged = 1;
51 (*argv)++;
52 (*argc)--;
53 handled++;
54 } else if (!prefixcmp(cmd, "--git-dir=")) {
55 setenv(GIT_DIR_ENVIRONMENT, cmd + 10, 1);
56 if (envchanged)
57 *envchanged = 1;
58 } else if (!strcmp(cmd, "--work-tree")) {
59 if (*argc < 2) {
60 fprintf(stderr, "No directory given for --work-tree.\n" );
61 usage(git_usage_string);
63 setenv(GIT_WORK_TREE_ENVIRONMENT, (*argv)[1], 1);
64 if (envchanged)
65 *envchanged = 1;
66 (*argv)++;
67 (*argc)--;
68 } else if (!prefixcmp(cmd, "--work-tree=")) {
69 setenv(GIT_WORK_TREE_ENVIRONMENT, cmd + 12, 1);
70 if (envchanged)
71 *envchanged = 1;
72 } else if (!strcmp(cmd, "--bare")) {
73 static char git_dir[PATH_MAX+1];
74 is_bare_repository_cfg = 1;
75 setenv(GIT_DIR_ENVIRONMENT, getcwd(git_dir, sizeof(git_dir)), 0);
76 if (envchanged)
77 *envchanged = 1;
78 } else {
79 fprintf(stderr, "Unknown option: %s\n", cmd);
80 usage(git_usage_string);
83 (*argv)++;
84 (*argc)--;
85 handled++;
87 return handled;
90 static const char *alias_command;
91 static char *alias_string;
93 static int git_alias_config(const char *var, const char *value)
95 if (!prefixcmp(var, "alias.") && !strcmp(var + 6, alias_command)) {
96 alias_string = xstrdup(value);
98 return 0;
101 static int split_cmdline(char *cmdline, const char ***argv)
103 int src, dst, count = 0, size = 16;
104 char quoted = 0;
106 *argv = xmalloc(sizeof(char*) * size);
108 /* split alias_string */
109 (*argv)[count++] = cmdline;
110 for (src = dst = 0; cmdline[src];) {
111 char c = cmdline[src];
112 if (!quoted && isspace(c)) {
113 cmdline[dst++] = 0;
114 while (cmdline[++src]
115 && isspace(cmdline[src]))
116 ; /* skip */
117 if (count >= size) {
118 size += 16;
119 *argv = xrealloc(*argv, sizeof(char*) * size);
121 (*argv)[count++] = cmdline + dst;
122 } else if(!quoted && (c == '\'' || c == '"')) {
123 quoted = c;
124 src++;
125 } else if (c == quoted) {
126 quoted = 0;
127 src++;
128 } else {
129 if (c == '\\' && quoted != '\'') {
130 src++;
131 c = cmdline[src];
132 if (!c) {
133 free(*argv);
134 *argv = NULL;
135 return error("cmdline ends with \\");
138 cmdline[dst++] = c;
139 src++;
143 cmdline[dst] = 0;
145 if (quoted) {
146 free(*argv);
147 *argv = NULL;
148 return error("unclosed quote");
151 return count;
154 static int handle_alias(int *argcp, const char ***argv)
156 int nongit = 0, envchanged = 0, ret = 0, saved_errno = errno;
157 const char *subdir;
158 int count, option_count;
159 const char** new_argv;
161 subdir = setup_git_directory_gently(&nongit);
163 alias_command = (*argv)[0];
164 git_config(git_alias_config);
165 if (alias_string) {
166 if (alias_string[0] == '!') {
167 if (*argcp > 1) {
168 struct strbuf buf;
170 strbuf_init(&buf, PATH_MAX);
171 strbuf_addstr(&buf, alias_string);
172 sq_quote_argv(&buf, (*argv) + 1, *argcp - 1, PATH_MAX);
173 free(alias_string);
174 alias_string = buf.buf;
176 trace_printf("trace: alias to shell cmd: %s => %s\n",
177 alias_command, alias_string + 1);
178 ret = system(alias_string + 1);
179 if (ret >= 0 && WIFEXITED(ret) &&
180 WEXITSTATUS(ret) != 127)
181 exit(WEXITSTATUS(ret));
182 die("Failed to run '%s' when expanding alias '%s'\n",
183 alias_string + 1, alias_command);
185 count = split_cmdline(alias_string, &new_argv);
186 option_count = handle_options(&new_argv, &count, &envchanged);
187 if (envchanged)
188 die("alias '%s' changes environment variables\n"
189 "You can use '!git' in the alias to do this.",
190 alias_command);
191 memmove(new_argv - option_count, new_argv,
192 count * sizeof(char *));
193 new_argv -= option_count;
195 if (count < 1)
196 die("empty alias for %s", alias_command);
198 if (!strcmp(alias_command, new_argv[0]))
199 die("recursive alias: %s", alias_command);
201 trace_argv_printf(new_argv, count,
202 "trace: alias expansion: %s =>",
203 alias_command);
205 new_argv = xrealloc(new_argv, sizeof(char*) *
206 (count + *argcp + 1));
207 /* insert after command name */
208 memcpy(new_argv + count, *argv + 1, sizeof(char*) * *argcp);
209 new_argv[count+*argcp] = NULL;
211 *argv = new_argv;
212 *argcp += count - 1;
214 ret = 1;
217 if (subdir)
218 chdir(subdir);
220 errno = saved_errno;
222 return ret;
225 const char git_version_string[] = GIT_VERSION;
227 #define RUN_SETUP (1<<0)
228 #define USE_PAGER (1<<1)
230 * require working tree to be present -- anything uses this needs
231 * RUN_SETUP for reading from the configuration file.
233 #define NEED_WORK_TREE (1<<2)
235 struct cmd_struct {
236 const char *cmd;
237 int (*fn)(int, const char **, const char *);
238 int option;
241 static int run_command(struct cmd_struct *p, int argc, const char **argv)
243 int status;
244 struct stat st;
245 const char *prefix;
247 prefix = NULL;
248 if (p->option & RUN_SETUP)
249 prefix = setup_git_directory();
250 if (p->option & USE_PAGER)
251 setup_pager();
252 if (p->option & NEED_WORK_TREE)
253 setup_work_tree();
255 trace_argv_printf(argv, argc, "trace: built-in: git");
257 status = p->fn(argc, argv, prefix);
258 if (status)
259 return status;
261 /* Somebody closed stdout? */
262 if (fstat(fileno(stdout), &st))
263 return 0;
264 /* Ignore write errors for pipes and sockets.. */
265 if (S_ISFIFO(st.st_mode) || S_ISSOCK(st.st_mode))
266 return 0;
268 /* Check for ENOSPC and EIO errors.. */
269 if (fflush(stdout))
270 die("write failure on standard output: %s", strerror(errno));
271 if (ferror(stdout))
272 die("unknown write failure on standard output");
273 if (fclose(stdout))
274 die("close failed on standard output: %s", strerror(errno));
275 return 0;
278 static void handle_internal_command(int argc, const char **argv)
280 const char *cmd = argv[0];
281 static struct cmd_struct commands[] = {
282 { "add", cmd_add, RUN_SETUP | NEED_WORK_TREE },
283 { "annotate", cmd_annotate, RUN_SETUP },
284 { "apply", cmd_apply },
285 { "archive", cmd_archive },
286 { "blame", cmd_blame, RUN_SETUP },
287 { "branch", cmd_branch, RUN_SETUP },
288 { "bundle", cmd_bundle },
289 { "cat-file", cmd_cat_file, RUN_SETUP },
290 { "checkout-index", cmd_checkout_index,
291 RUN_SETUP | NEED_WORK_TREE},
292 { "check-ref-format", cmd_check_ref_format },
293 { "check-attr", cmd_check_attr, RUN_SETUP | NEED_WORK_TREE },
294 { "cherry", cmd_cherry, RUN_SETUP },
295 { "cherry-pick", cmd_cherry_pick, RUN_SETUP | NEED_WORK_TREE },
296 { "commit", cmd_commit, RUN_SETUP | NEED_WORK_TREE },
297 { "commit-tree", cmd_commit_tree, RUN_SETUP },
298 { "config", cmd_config },
299 { "count-objects", cmd_count_objects, RUN_SETUP },
300 { "describe", cmd_describe, RUN_SETUP },
301 { "diff", cmd_diff },
302 { "diff-files", cmd_diff_files },
303 { "diff-index", cmd_diff_index, RUN_SETUP },
304 { "diff-tree", cmd_diff_tree, RUN_SETUP },
305 { "fetch", cmd_fetch, RUN_SETUP },
306 { "fetch-pack", cmd_fetch_pack, RUN_SETUP },
307 { "fetch--tool", cmd_fetch__tool, RUN_SETUP },
308 { "fmt-merge-msg", cmd_fmt_merge_msg, RUN_SETUP },
309 { "for-each-ref", cmd_for_each_ref, RUN_SETUP },
310 { "format-patch", cmd_format_patch, RUN_SETUP },
311 { "fsck", cmd_fsck, RUN_SETUP },
312 { "fsck-objects", cmd_fsck, RUN_SETUP },
313 { "gc", cmd_gc, RUN_SETUP },
314 { "get-tar-commit-id", cmd_get_tar_commit_id },
315 { "grep", cmd_grep, RUN_SETUP | USE_PAGER },
316 { "help", cmd_help },
317 #ifndef NO_CURL
318 { "http-fetch", cmd_http_fetch, RUN_SETUP },
319 #endif
320 { "init", cmd_init_db },
321 { "init-db", cmd_init_db },
322 { "log", cmd_log, RUN_SETUP | USE_PAGER },
323 { "ls-files", cmd_ls_files, RUN_SETUP },
324 { "ls-tree", cmd_ls_tree, RUN_SETUP },
325 { "mailinfo", cmd_mailinfo },
326 { "mailsplit", cmd_mailsplit },
327 { "merge-base", cmd_merge_base, RUN_SETUP },
328 { "merge-file", cmd_merge_file },
329 { "merge-ours", cmd_merge_ours, RUN_SETUP },
330 { "mv", cmd_mv, RUN_SETUP | NEED_WORK_TREE },
331 { "name-rev", cmd_name_rev, RUN_SETUP },
332 { "pack-objects", cmd_pack_objects, RUN_SETUP },
333 { "pickaxe", cmd_blame, RUN_SETUP },
334 { "prune", cmd_prune, RUN_SETUP },
335 { "prune-packed", cmd_prune_packed, RUN_SETUP },
336 { "push", cmd_push, RUN_SETUP },
337 { "read-tree", cmd_read_tree, RUN_SETUP },
338 { "reflog", cmd_reflog, RUN_SETUP },
339 { "repo-config", cmd_config },
340 { "rerere", cmd_rerere, RUN_SETUP },
341 { "reset", cmd_reset, RUN_SETUP },
342 { "rev-list", cmd_rev_list, RUN_SETUP },
343 { "rev-parse", cmd_rev_parse },
344 { "revert", cmd_revert, RUN_SETUP | NEED_WORK_TREE },
345 { "rm", cmd_rm, RUN_SETUP },
346 { "shortlog", cmd_shortlog, RUN_SETUP | USE_PAGER },
347 { "show-branch", cmd_show_branch, RUN_SETUP },
348 { "show", cmd_show, RUN_SETUP | USE_PAGER },
349 { "status", cmd_status, RUN_SETUP | NEED_WORK_TREE },
350 { "stripspace", cmd_stripspace },
351 { "symbolic-ref", cmd_symbolic_ref, RUN_SETUP },
352 { "tag", cmd_tag, RUN_SETUP },
353 { "tar-tree", cmd_tar_tree },
354 { "unpack-objects", cmd_unpack_objects, RUN_SETUP },
355 { "update-index", cmd_update_index, RUN_SETUP },
356 { "update-ref", cmd_update_ref, RUN_SETUP },
357 { "upload-archive", cmd_upload_archive },
358 { "verify-tag", cmd_verify_tag, RUN_SETUP },
359 { "version", cmd_version },
360 { "whatchanged", cmd_whatchanged, RUN_SETUP | USE_PAGER },
361 { "write-tree", cmd_write_tree, RUN_SETUP },
362 { "verify-pack", cmd_verify_pack },
363 { "show-ref", cmd_show_ref, RUN_SETUP },
364 { "pack-refs", cmd_pack_refs, RUN_SETUP },
366 int i;
368 /* Turn "git cmd --help" into "git help cmd" */
369 if (argc > 1 && !strcmp(argv[1], "--help")) {
370 argv[1] = argv[0];
371 argv[0] = cmd = "help";
374 for (i = 0; i < ARRAY_SIZE(commands); i++) {
375 struct cmd_struct *p = commands+i;
376 if (strcmp(p->cmd, cmd))
377 continue;
378 exit(run_command(p, argc, argv));
382 int main(int argc, const char **argv)
384 const char *cmd = argv[0] ? argv[0] : "git-help";
385 char *slash = strrchr(cmd, '/');
386 const char *cmd_path = NULL;
387 int done_alias = 0;
390 * Take the basename of argv[0] as the command
391 * name, and the dirname as the default exec_path
392 * if we don't have anything better.
394 if (slash) {
395 *slash++ = 0;
396 cmd_path = cmd;
397 cmd = slash;
401 * "git-xxxx" is the same as "git xxxx", but we obviously:
403 * - cannot take flags in between the "git" and the "xxxx".
404 * - cannot execute it externally (since it would just do
405 * the same thing over again)
407 * So we just directly call the internal command handler, and
408 * die if that one cannot handle it.
410 if (!prefixcmp(cmd, "git-")) {
411 cmd += 4;
412 argv[0] = cmd;
413 handle_internal_command(argc, argv);
414 die("cannot handle %s internally", cmd);
417 /* Look for flags.. */
418 argv++;
419 argc--;
420 handle_options(&argv, &argc, NULL);
421 if (argc > 0) {
422 if (!prefixcmp(argv[0], "--"))
423 argv[0] += 2;
424 } else {
425 /* The user didn't specify a command; give them help */
426 printf("usage: %s\n\n", git_usage_string);
427 list_common_cmds_help();
428 exit(1);
430 cmd = argv[0];
433 * We use PATH to find git commands, but we prepend some higher
434 * precidence paths: the "--exec-path" option, the GIT_EXEC_PATH
435 * environment, and the $(gitexecdir) from the Makefile at build
436 * time.
438 setup_path(cmd_path);
440 while (1) {
441 /* See if it's an internal command */
442 handle_internal_command(argc, argv);
444 /* .. then try the external ones */
445 execv_git_cmd(argv);
447 /* It could be an alias -- this works around the insanity
448 * of overriding "git log" with "git show" by having
449 * alias.log = show
451 if (done_alias || !handle_alias(&argc, &argv))
452 break;
453 done_alias = 1;
456 if (errno == ENOENT) {
457 if (done_alias) {
458 fprintf(stderr, "Expansion of alias '%s' failed; "
459 "'%s' is not a git-command\n",
460 cmd, argv[0]);
461 exit(1);
463 help_unknown_cmd(cmd);
466 fprintf(stderr, "Failed to run command '%s': %s\n",
467 cmd, strerror(errno));
469 return 1;