Document what the stage numbers in the :$n:path syntax mean.
[git/mingw/4msysgit/wingit-dll.git] / git.c
blobc46691e9767bedf4af9cafcd4f48d858d220e8a5
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 void prepend_to_path(const char *dir, int len)
11 const char *old_path = getenv("PATH");
12 char *path;
13 int path_len = len;
15 if (!old_path)
16 old_path = "/usr/local/bin:/usr/bin:/bin";
18 path_len = len + strlen(old_path) + 1;
20 path = xmalloc(path_len + 1);
22 memcpy(path, dir, len);
23 path[len] = ':';
24 memcpy(path + len + 1, old_path, path_len - len);
26 setenv("PATH", path, 1);
28 free(path);
31 static int handle_options(const char*** argv, int* argc, int* envchanged)
33 int handled = 0;
35 while (*argc > 0) {
36 const char *cmd = (*argv)[0];
37 if (cmd[0] != '-')
38 break;
41 * For legacy reasons, the "version" and "help"
42 * commands can be written with "--" prepended
43 * to make them look like flags.
45 if (!strcmp(cmd, "--help") || !strcmp(cmd, "--version"))
46 break;
49 * Check remaining flags.
51 if (!prefixcmp(cmd, "--exec-path")) {
52 cmd += 11;
53 if (*cmd == '=')
54 git_set_exec_path(cmd + 1);
55 else {
56 puts(git_exec_path());
57 exit(0);
59 } else if (!strcmp(cmd, "-p") || !strcmp(cmd, "--paginate")) {
60 setup_pager();
61 } else if (!strcmp(cmd, "--no-pager")) {
62 setenv("GIT_PAGER", "cat", 1);
63 if (envchanged)
64 *envchanged = 1;
65 } else if (!strcmp(cmd, "--git-dir")) {
66 if (*argc < 2) {
67 fprintf(stderr, "No directory given for --git-dir.\n" );
68 usage(git_usage_string);
70 setenv(GIT_DIR_ENVIRONMENT, (*argv)[1], 1);
71 if (envchanged)
72 *envchanged = 1;
73 (*argv)++;
74 (*argc)--;
75 handled++;
76 } else if (!prefixcmp(cmd, "--git-dir=")) {
77 setenv(GIT_DIR_ENVIRONMENT, cmd + 10, 1);
78 if (envchanged)
79 *envchanged = 1;
80 } else if (!strcmp(cmd, "--work-tree")) {
81 if (*argc < 2) {
82 fprintf(stderr, "No directory given for --work-tree.\n" );
83 usage(git_usage_string);
85 setenv(GIT_WORK_TREE_ENVIRONMENT, (*argv)[1], 1);
86 if (envchanged)
87 *envchanged = 1;
88 (*argv)++;
89 (*argc)--;
90 } else if (!prefixcmp(cmd, "--work-tree=")) {
91 setenv(GIT_WORK_TREE_ENVIRONMENT, cmd + 12, 1);
92 if (envchanged)
93 *envchanged = 1;
94 } else if (!strcmp(cmd, "--bare")) {
95 static char git_dir[PATH_MAX+1];
96 setenv(GIT_DIR_ENVIRONMENT, getcwd(git_dir, sizeof(git_dir)), 1);
97 if (envchanged)
98 *envchanged = 1;
99 } else {
100 fprintf(stderr, "Unknown option: %s\n", cmd);
101 usage(git_usage_string);
104 (*argv)++;
105 (*argc)--;
106 handled++;
108 return handled;
111 static const char *alias_command;
112 static char *alias_string;
114 static int git_alias_config(const char *var, const char *value)
116 if (!prefixcmp(var, "alias.") && !strcmp(var + 6, alias_command)) {
117 alias_string = xstrdup(value);
119 return 0;
122 static int split_cmdline(char *cmdline, const char ***argv)
124 int src, dst, count = 0, size = 16;
125 char quoted = 0;
127 *argv = xmalloc(sizeof(char*) * size);
129 /* split alias_string */
130 (*argv)[count++] = cmdline;
131 for (src = dst = 0; cmdline[src];) {
132 char c = cmdline[src];
133 if (!quoted && isspace(c)) {
134 cmdline[dst++] = 0;
135 while (cmdline[++src]
136 && isspace(cmdline[src]))
137 ; /* skip */
138 if (count >= size) {
139 size += 16;
140 *argv = xrealloc(*argv, sizeof(char*) * size);
142 (*argv)[count++] = cmdline + dst;
143 } else if(!quoted && (c == '\'' || c == '"')) {
144 quoted = c;
145 src++;
146 } else if (c == quoted) {
147 quoted = 0;
148 src++;
149 } else {
150 if (c == '\\' && quoted != '\'') {
151 src++;
152 c = cmdline[src];
153 if (!c) {
154 free(*argv);
155 *argv = NULL;
156 return error("cmdline ends with \\");
159 cmdline[dst++] = c;
160 src++;
164 cmdline[dst] = 0;
166 if (quoted) {
167 free(*argv);
168 *argv = NULL;
169 return error("unclosed quote");
172 return count;
175 static int handle_alias(int *argcp, const char ***argv)
177 int nongit = 0, envchanged = 0, ret = 0, saved_errno = errno;
178 const char *subdir;
179 int count, option_count;
180 const char** new_argv;
182 subdir = setup_git_directory_gently(&nongit);
184 alias_command = (*argv)[0];
185 git_config(git_alias_config);
186 if (alias_string) {
187 if (alias_string[0] == '!') {
188 if (*argcp > 1) {
189 int i, sz = PATH_MAX;
190 char *s = xmalloc(sz), *new_alias = s;
192 add_to_string(&s, &sz, alias_string, 0);
193 free(alias_string);
194 alias_string = new_alias;
195 for (i = 1; i < *argcp &&
196 !add_to_string(&s, &sz, " ", 0) &&
197 !add_to_string(&s, &sz, (*argv)[i], 1)
198 ; i++)
199 ; /* do nothing */
200 if (!sz)
201 die("Too many or long arguments");
203 trace_printf("trace: alias to shell cmd: %s => %s\n",
204 alias_command, alias_string + 1);
205 ret = system(alias_string + 1);
206 if (ret >= 0 && WIFEXITED(ret) &&
207 WEXITSTATUS(ret) != 127)
208 exit(WEXITSTATUS(ret));
209 die("Failed to run '%s' when expanding alias '%s'\n",
210 alias_string + 1, alias_command);
212 count = split_cmdline(alias_string, &new_argv);
213 option_count = handle_options(&new_argv, &count, &envchanged);
214 if (envchanged)
215 die("alias '%s' changes environment variables\n"
216 "You can use '!git' in the alias to do this.",
217 alias_command);
218 memmove(new_argv - option_count, new_argv,
219 count * sizeof(char *));
220 new_argv -= option_count;
222 if (count < 1)
223 die("empty alias for %s", alias_command);
225 if (!strcmp(alias_command, new_argv[0]))
226 die("recursive alias: %s", alias_command);
228 trace_argv_printf(new_argv, count,
229 "trace: alias expansion: %s =>",
230 alias_command);
232 new_argv = xrealloc(new_argv, sizeof(char*) *
233 (count + *argcp + 1));
234 /* insert after command name */
235 memcpy(new_argv + count, *argv + 1, sizeof(char*) * *argcp);
236 new_argv[count+*argcp] = NULL;
238 *argv = new_argv;
239 *argcp += count - 1;
241 ret = 1;
244 if (subdir)
245 chdir(subdir);
247 errno = saved_errno;
249 return ret;
252 const char git_version_string[] = GIT_VERSION;
254 #define RUN_SETUP (1<<0)
255 #define USE_PAGER (1<<1)
257 * require working tree to be present -- anything uses this needs
258 * RUN_SETUP for reading from the configuration file.
260 #define NEED_WORK_TREE (1<<2)
262 struct cmd_struct {
263 const char *cmd;
264 int (*fn)(int, const char **, const char *);
265 int option;
268 static int run_command(struct cmd_struct *p, int argc, const char **argv)
270 int status;
271 struct stat st;
272 const char *prefix;
274 prefix = NULL;
275 if (p->option & RUN_SETUP)
276 prefix = setup_git_directory();
277 if (p->option & USE_PAGER)
278 setup_pager();
279 if (p->option & NEED_WORK_TREE) {
280 const char *work_tree = get_git_work_tree();
281 const char *git_dir = get_git_dir();
282 if (!is_absolute_path(git_dir))
283 set_git_dir(make_absolute_path(git_dir));
284 if (!work_tree || chdir(work_tree))
285 die("%s must be run in a work tree", p->cmd);
287 trace_argv_printf(argv, argc, "trace: built-in: git");
289 status = p->fn(argc, argv, prefix);
290 if (status)
291 return status;
293 /* Somebody closed stdout? */
294 if (fstat(fileno(stdout), &st))
295 return 0;
296 /* Ignore write errors for pipes and sockets.. */
297 if (S_ISFIFO(st.st_mode) || S_ISSOCK(st.st_mode))
298 return 0;
300 /* Check for ENOSPC and EIO errors.. */
301 if (fflush(stdout))
302 die("write failure on standard output: %s", strerror(errno));
303 if (ferror(stdout))
304 die("unknown write failure on standard output");
305 if (fclose(stdout))
306 die("close failed on standard output: %s", strerror(errno));
307 return 0;
310 static void handle_internal_command(int argc, const char **argv)
312 const char *cmd = argv[0];
313 static struct cmd_struct commands[] = {
314 { "add", cmd_add, RUN_SETUP | NEED_WORK_TREE },
315 { "annotate", cmd_annotate, RUN_SETUP },
316 { "apply", cmd_apply },
317 { "archive", cmd_archive },
318 { "blame", cmd_blame, RUN_SETUP },
319 { "branch", cmd_branch, RUN_SETUP },
320 { "bundle", cmd_bundle },
321 { "cat-file", cmd_cat_file, RUN_SETUP },
322 { "checkout-index", cmd_checkout_index,
323 RUN_SETUP | NEED_WORK_TREE},
324 { "check-ref-format", cmd_check_ref_format },
325 { "check-attr", cmd_check_attr, RUN_SETUP | NEED_WORK_TREE },
326 { "cherry", cmd_cherry, RUN_SETUP },
327 { "cherry-pick", cmd_cherry_pick, RUN_SETUP | NEED_WORK_TREE },
328 { "commit-tree", cmd_commit_tree, RUN_SETUP },
329 { "config", cmd_config },
330 { "count-objects", cmd_count_objects, RUN_SETUP },
331 { "describe", cmd_describe, RUN_SETUP },
332 { "diff", cmd_diff },
333 { "diff-files", cmd_diff_files },
334 { "diff-index", cmd_diff_index, RUN_SETUP },
335 { "diff-tree", cmd_diff_tree, RUN_SETUP },
336 { "fetch--tool", cmd_fetch__tool, RUN_SETUP },
337 { "fmt-merge-msg", cmd_fmt_merge_msg, RUN_SETUP },
338 { "for-each-ref", cmd_for_each_ref, RUN_SETUP },
339 { "format-patch", cmd_format_patch, RUN_SETUP },
340 { "fsck", cmd_fsck, RUN_SETUP },
341 { "fsck-objects", cmd_fsck, RUN_SETUP },
342 { "gc", cmd_gc, RUN_SETUP },
343 { "get-tar-commit-id", cmd_get_tar_commit_id },
344 { "grep", cmd_grep, RUN_SETUP | USE_PAGER },
345 { "help", cmd_help },
346 { "init", cmd_init_db },
347 { "init-db", cmd_init_db },
348 { "log", cmd_log, RUN_SETUP | USE_PAGER },
349 { "ls-files", cmd_ls_files, RUN_SETUP },
350 { "ls-tree", cmd_ls_tree, RUN_SETUP },
351 { "mailinfo", cmd_mailinfo },
352 { "mailsplit", cmd_mailsplit },
353 { "merge-base", cmd_merge_base, RUN_SETUP },
354 { "merge-file", cmd_merge_file },
355 { "mv", cmd_mv, RUN_SETUP | NEED_WORK_TREE },
356 { "name-rev", cmd_name_rev, RUN_SETUP },
357 { "pack-objects", cmd_pack_objects, RUN_SETUP },
358 { "pickaxe", cmd_blame, RUN_SETUP },
359 { "prune", cmd_prune, RUN_SETUP },
360 { "prune-packed", cmd_prune_packed, RUN_SETUP },
361 { "push", cmd_push, RUN_SETUP },
362 { "read-tree", cmd_read_tree, RUN_SETUP },
363 { "reflog", cmd_reflog, RUN_SETUP },
364 { "repo-config", cmd_config },
365 { "rerere", cmd_rerere, RUN_SETUP },
366 { "rev-list", cmd_rev_list, RUN_SETUP },
367 { "rev-parse", cmd_rev_parse, RUN_SETUP },
368 { "revert", cmd_revert, RUN_SETUP | NEED_WORK_TREE },
369 { "rm", cmd_rm, RUN_SETUP | NEED_WORK_TREE },
370 { "runstatus", cmd_runstatus, RUN_SETUP | NEED_WORK_TREE },
371 { "shortlog", cmd_shortlog, RUN_SETUP | USE_PAGER },
372 { "show-branch", cmd_show_branch, RUN_SETUP },
373 { "show", cmd_show, RUN_SETUP | USE_PAGER },
374 { "stripspace", cmd_stripspace },
375 { "symbolic-ref", cmd_symbolic_ref, RUN_SETUP },
376 { "tag", cmd_tag, RUN_SETUP },
377 { "tar-tree", cmd_tar_tree },
378 { "unpack-objects", cmd_unpack_objects, RUN_SETUP },
379 { "update-index", cmd_update_index, RUN_SETUP },
380 { "update-ref", cmd_update_ref, RUN_SETUP },
381 { "upload-archive", cmd_upload_archive },
382 { "verify-tag", cmd_verify_tag, RUN_SETUP },
383 { "version", cmd_version },
384 { "whatchanged", cmd_whatchanged, RUN_SETUP | USE_PAGER },
385 { "write-tree", cmd_write_tree, RUN_SETUP },
386 { "verify-pack", cmd_verify_pack },
387 { "show-ref", cmd_show_ref, RUN_SETUP },
388 { "pack-refs", cmd_pack_refs, RUN_SETUP },
390 int i;
392 /* Turn "git cmd --help" into "git help cmd" */
393 if (argc > 1 && !strcmp(argv[1], "--help")) {
394 argv[1] = argv[0];
395 argv[0] = cmd = "help";
398 for (i = 0; i < ARRAY_SIZE(commands); i++) {
399 struct cmd_struct *p = commands+i;
400 if (strcmp(p->cmd, cmd))
401 continue;
402 exit(run_command(p, argc, argv));
406 int main(int argc, const char **argv)
408 const char *cmd = argv[0] ? argv[0] : "git-help";
409 char *slash = strrchr(cmd, '/');
410 const char *exec_path = NULL;
411 int done_alias = 0;
414 * Take the basename of argv[0] as the command
415 * name, and the dirname as the default exec_path
416 * if it's an absolute path and we don't have
417 * anything better.
419 if (slash) {
420 *slash++ = 0;
421 if (*cmd == '/')
422 exec_path = cmd;
423 cmd = slash;
427 * "git-xxxx" is the same as "git xxxx", but we obviously:
429 * - cannot take flags in between the "git" and the "xxxx".
430 * - cannot execute it externally (since it would just do
431 * the same thing over again)
433 * So we just directly call the internal command handler, and
434 * die if that one cannot handle it.
436 if (!prefixcmp(cmd, "git-")) {
437 cmd += 4;
438 argv[0] = cmd;
439 handle_internal_command(argc, argv);
440 die("cannot handle %s internally", cmd);
443 /* Look for flags.. */
444 argv++;
445 argc--;
446 handle_options(&argv, &argc, NULL);
447 if (argc > 0) {
448 if (!prefixcmp(argv[0], "--"))
449 argv[0] += 2;
450 } else {
451 /* Default command: "help" */
452 argv[0] = "help";
453 argc = 1;
455 cmd = argv[0];
458 * We execute external git command via execv_git_cmd(),
459 * which looks at "--exec-path" option, GIT_EXEC_PATH
460 * environment, and $(gitexecdir) in Makefile while built,
461 * in this order. For scripted commands, we prepend
462 * the value of the exec_path variable to the PATH.
464 if (exec_path)
465 prepend_to_path(exec_path, strlen(exec_path));
466 exec_path = git_exec_path();
467 prepend_to_path(exec_path, strlen(exec_path));
469 while (1) {
470 /* See if it's an internal command */
471 handle_internal_command(argc, argv);
473 /* .. then try the external ones */
474 execv_git_cmd(argv);
476 /* It could be an alias -- this works around the insanity
477 * of overriding "git log" with "git show" by having
478 * alias.log = show
480 if (done_alias || !handle_alias(&argc, &argv))
481 break;
482 done_alias = 1;
485 if (errno == ENOENT) {
486 if (done_alias) {
487 fprintf(stderr, "Expansion of alias '%s' failed; "
488 "'%s' is not a git-command\n",
489 cmd, argv[0]);
490 exit(1);
492 help_unknown_cmd(cmd);
495 fprintf(stderr, "Failed to run command '%s': %s\n",
496 cmd, strerror(errno));
498 return 1;