Misc doc improvements
[git.git] / git.c
diff --git a/git.c b/git.c
index d189801..6db8f2b 100644 (file)
--- a/git.c
+++ b/git.c
 #include <stdio.h>
+#include <sys/types.h>
+#include <sys/stat.h>
+#include <dirent.h>
 #include <unistd.h>
 #include <stdlib.h>
 #include <string.h>
 #include <errno.h>
 #include <limits.h>
 #include <stdarg.h>
-#include <glob.h>
+#include "git-compat-util.h"
+#include "exec_cmd.h"
+#include "cache.h"
 
-#ifndef PATH_MAX
-# define PATH_MAX 4096
-#endif
+#include "builtin.h"
 
-static const char git_usage[] =
-       "Usage: git [--version] [--exec-path[=GIT_EXEC_PATH]] [--help] COMMAND [ ARGS ]";
+static void prepend_to_path(const char *dir, int len)
+{
+       char *path, *old_path = getenv("PATH");
+       int path_len = len;
 
-struct string_list {
-       size_t len;
-       char *str;
-       struct string_list *next;
-};
+       if (!old_path)
+               old_path = "/usr/local/bin:/usr/bin:/bin";
 
-/* most gui terms set COLUMNS (although some don't export it) */
-static int term_columns(void)
-{
-       char *col_string = getenv("COLUMNS");
-       int n_cols = 0;
+       path_len = len + strlen(old_path) + 1;
+
+       path = malloc(path_len + 1);
 
-       if (col_string && (n_cols = atoi(col_string)) > 0)
-               return n_cols;
+       memcpy(path, dir, len);
+       path[len] = ':';
+       memcpy(path + len + 1, old_path, path_len - len);
 
-       return 80;
+       setenv("PATH", path, 1);
 }
 
-static inline void mput_char(char c, unsigned int num)
+static const char *alias_command;
+static char *alias_string = NULL;
+
+static int git_alias_config(const char *var, const char *value)
 {
-       while(num--)
-               putchar(c);
+       if (!strncmp(var, "alias.", 6) && !strcmp(var + 6, alias_command)) {
+               alias_string = strdup(value);
+       }
+       return 0;
 }
 
-static void pretty_print_string_list(struct string_list *list, int longest)
+static int split_cmdline(char *cmdline, const char ***argv)
 {
-       int cols = 1;
-       int space = longest + 1; /* min 1 SP between words */
-       int max_cols = term_columns() - 1; /* don't print *on* the edge */
-
-       if (space < max_cols)
-               cols = max_cols / space;
-
-       while (list) {
-               int c;
-               printf("  ");
+       int src, dst, count = 0, size = 16;
+       char quoted = 0;
+
+       *argv = malloc(sizeof(char*) * size);
+
+       /* split alias_string */
+       (*argv)[count++] = cmdline;
+       for (src = dst = 0; cmdline[src];) {
+               char c = cmdline[src];
+               if (!quoted && isspace(c)) {
+                       cmdline[dst++] = 0;
+                       while (cmdline[++src]
+                                       && isspace(cmdline[src]))
+                               ; /* skip */
+                       if (count >= size) {
+                               size += 16;
+                               *argv = realloc(*argv, sizeof(char*) * size);
+                       }
+                       (*argv)[count++] = cmdline + dst;
+               } else if(!quoted && (c == '\'' || c == '"')) {
+                       quoted = c;
+                       src++;
+               } else if (c == quoted) {
+                       quoted = 0;
+                       src++;
+               } else {
+                       if (c == '\\' && quoted != '\'') {
+                               src++;
+                               c = cmdline[src];
+                               if (!c) {
+                                       free(*argv);
+                                       *argv = NULL;
+                                       return error("cmdline ends with \\");
+                               }
+                       }
+                       cmdline[dst++] = c;
+                       src++;
+               }
+       }
 
-               for (c = cols; c && list; list = list->next) {
-                       printf("%s", list->str);
+       cmdline[dst] = 0;
 
-                       if (--c)
-                               mput_char(' ', space - list->len);
-               }
-               putchar('\n');
+       if (quoted) {
+               free(*argv);
+               *argv = NULL;
+               return error("unclosed quote");
        }
+
+       return count;
 }
 
-static void list_commands(const char *exec_path, const char *pattern)
+static int handle_alias(int *argcp, const char ***argv)
 {
-       struct string_list *list = NULL, *tail = NULL;
-       unsigned int longest = 0, i;
-       glob_t gl;
+       int nongit = 0, ret = 0;
+       const char *subdir;
 
-       if (chdir(exec_path) < 0) {
-               printf("git: '%s': %s\n", exec_path, strerror(errno));
-               exit(1);
-       }
+       subdir = setup_git_directory_gently(&nongit);
+       if (!nongit) {
+               int count;
+               const char** new_argv;
 
-       i = glob(pattern, 0, NULL, &gl);
-       switch(i) {
-       case GLOB_NOSPACE:
-               puts("Out of memory when running glob()");
-               exit(2);
-       case GLOB_ABORTED:
-               printf("'%s': Read error: %s\n", exec_path, strerror(errno));
-               exit(2);
-       case GLOB_NOMATCH:
-               printf("No git commands available in '%s'.\n", exec_path);
-               printf("Do you need to specify --exec-path or set GIT_EXEC_PATH?\n");
-               exit(1);
-       }
+               alias_command = (*argv)[0];
+               git_config(git_alias_config);
+               if (alias_string) {
 
-       for (i = 0; i < gl.gl_pathc; i++) {
-               int len = strlen(gl.gl_pathv[i] + 4);
+                       count = split_cmdline(alias_string, &new_argv);
 
-               if (access(gl.gl_pathv[i], X_OK))
-                       continue;
+                       if (count < 1)
+                               die("empty alias for %s", alias_command);
 
-               if (longest < len)
-                       longest = len;
+                       if (!strcmp(alias_command, new_argv[0]))
+                               die("recursive alias: %s", alias_command);
 
-               if (!tail)
-                       tail = list = malloc(sizeof(struct string_list));
-               else {
-                       tail->next = malloc(sizeof(struct string_list));
-                       tail = tail->next;
-               }
-               tail->len = len;
-               tail->str = gl.gl_pathv[i] + 4;
-               tail->next = NULL;
-       }
+                       /* insert after command name */
+                       if (*argcp > 1) {
+                               new_argv = realloc(new_argv, sizeof(char*) *
+                                               (count + *argcp - 1));
+                               memcpy(new_argv + count, *argv, sizeof(char*) *
+                                               (*argcp - 1));
+                       }
 
-       printf("git commands available in '%s'\n", exec_path);
-       printf("----------------------------");
-       mput_char('-', strlen(exec_path));
-       putchar('\n');
-       pretty_print_string_list(list, longest);
-       putchar('\n');
-}
+                       *argv = new_argv;
+                       *argcp += count - 1;
 
-#ifdef __GNUC__
-static void usage(const char *exec_path, const char *fmt, ...)
-       __attribute__((__format__(__printf__, 2, 3), __noreturn__));
-#endif
-static void usage(const char *exec_path, const char *fmt, ...)
-{
-       if (fmt) {
-               va_list ap;
-
-               va_start(ap, fmt);
-               printf("git: ");
-               vprintf(fmt, ap);
-               va_end(ap);
-               putchar('\n');
+                       ret = 1;
+               }
        }
-       else
-               puts(git_usage);
 
-       putchar('\n');
+       if (subdir)
+               chdir(subdir);
 
-       if(exec_path)
-               list_commands(exec_path, "git-*");
-
-       exit(1);
+       return ret;
 }
 
-static void prepend_to_path(const char *dir, int len)
-{
-       char *path, *old_path = getenv("PATH");
-       int path_len = len;
-
-       if (!old_path)
-               old_path = "/bin:/usr/bin:.";
-
-       path_len = len + strlen(old_path) + 1;
-
-       path = malloc(path_len + 1);
-       path[path_len + 1] = '\0';
+const char git_version_string[] = GIT_VERSION;
 
-       memcpy(path, dir, len);
-       path[len] = ':';
-       memcpy(path + len + 1, old_path, path_len - len);
+static void handle_internal_command(int argc, const char **argv, char **envp)
+{
+       const char *cmd = argv[0];
+       static struct cmd_struct {
+               const char *cmd;
+               int (*fn)(int, const char **, char **);
+       } commands[] = {
+               { "version", cmd_version },
+               { "help", cmd_help },
+               { "log", cmd_log },
+               { "whatchanged", cmd_whatchanged },
+               { "show", cmd_show },
+               { "push", cmd_push },
+               { "format-patch", cmd_format_patch },
+               { "count-objects", cmd_count_objects },
+               { "diff", cmd_diff },
+               { "grep", cmd_grep },
+               { "rm", cmd_rm },
+               { "add", cmd_add },
+               { "rev-list", cmd_rev_list },
+               { "init-db", cmd_init_db },
+               { "tar-tree", cmd_tar_tree },
+               { "upload-tar", cmd_upload_tar },
+               { "check-ref-format", cmd_check_ref_format },
+               { "ls-files", cmd_ls_files },
+               { "ls-tree", cmd_ls_tree },
+               { "tar-tree", cmd_tar_tree },
+               { "read-tree", cmd_read_tree },
+               { "commit-tree", cmd_commit_tree },
+               { "apply", cmd_apply },
+               { "show-branch", cmd_show_branch },
+               { "diff-files", cmd_diff_files },
+               { "diff-index", cmd_diff_index },
+               { "diff-stages", cmd_diff_stages },
+               { "diff-tree", cmd_diff_tree },
+               { "cat-file", cmd_cat_file },
+               { "rev-parse", cmd_rev_parse }
+       };
+       int i;
+
+       /* Turn "git cmd --help" into "git help cmd" */
+       if (argc > 1 && !strcmp(argv[1], "--help")) {
+               argv[1] = argv[0];
+               argv[0] = cmd = "help";
+       }
 
-       setenv("PATH", path, 1);
+       for (i = 0; i < ARRAY_SIZE(commands); i++) {
+               struct cmd_struct *p = commands+i;
+               if (strcmp(p->cmd, cmd))
+                       continue;
+               exit(p->fn(argc, argv, envp));
+       }
 }
 
-int main(int argc, char **argv, char **envp)
+int main(int argc, const char **argv, char **envp)
 {
+       const char *cmd = argv[0];
+       char *slash = strrchr(cmd, '/');
        char git_command[PATH_MAX + 1];
-       char wd[PATH_MAX + 1];
-       int i, len, show_help = 0;
-       char *exec_path = getenv("GIT_EXEC_PATH");
+       const char *exec_path = NULL;
+       int done_alias = 0;
+
+       /*
+        * Take the basename of argv[0] as the command
+        * name, and the dirname as the default exec_path
+        * if it's an absolute path and we don't have
+        * anything better.
+        */
+       if (slash) {
+               *slash++ = 0;
+               if (*cmd == '/')
+                       exec_path = cmd;
+               cmd = slash;
+       }
 
-       getcwd(wd, PATH_MAX);
+       /*
+        * "git-xxxx" is the same as "git xxxx", but we obviously:
+        *
+        *  - cannot take flags in between the "git" and the "xxxx".
+        *  - cannot execute it externally (since it would just do
+        *    the same thing over again)
+        *
+        * So we just directly call the internal command handler, and
+        * die if that one cannot handle it.
+        */
+       if (!strncmp(cmd, "git-", 4)) {
+               cmd += 4;
+               argv[0] = cmd;
+               handle_internal_command(argc, argv, envp);
+               die("cannot handle %s internally", cmd);
+       }
 
-       if (!exec_path)
-               exec_path = GIT_EXEC_PATH;
+       /* Default command: "help" */
+       cmd = "help";
 
-       for (i = 1; i < argc; i++) {
-               char *arg = argv[i];
+       /* Look for flags.. */
+       while (argc > 1) {
+               cmd = *++argv;
+               argc--;
 
-               if (strncmp(arg, "--", 2))
+               if (strncmp(cmd, "--", 2))
                        break;
 
-               arg += 2;
+               cmd += 2;
+
+               /*
+                * For legacy reasons, the "version" and "help"
+                * commands can be written with "--" prepended
+                * to make them look like flags.
+                */
+               if (!strcmp(cmd, "help"))
+                       break;
+               if (!strcmp(cmd, "version"))
+                       break;
 
-               if (!strncmp(arg, "exec-path", 9)) {
-                       arg += 9;
-                       if (*arg == '=')
-                               exec_path = arg + 1;
-                       else {
-                               puts(exec_path);
-                               exit(0);
+               /*
+                * Check remaining flags (which by now must be
+                * "--exec-path", but maybe we will accept
+                * other arguments some day)
+                */
+               if (!strncmp(cmd, "exec-path", 9)) {
+                       cmd += 9;
+                       if (*cmd == '=') {
+                               git_set_exec_path(cmd + 1);
+                               continue;
                        }
-               }
-               else if (!strcmp(arg, "version")) {
-                       printf("git version %s\n", GIT_VERSION);
+                       puts(git_exec_path());
                        exit(0);
                }
-               else if (!strcmp(arg, "help"))
-                       show_help = 1;
-               else if (!show_help)
-                       usage(NULL, NULL);
+               cmd_usage(0, NULL, NULL);
        }
-
-       if (i >= argc || show_help)
-               usage(exec_path, NULL);
-
-       /* allow relative paths, but run with exact */
-       if (chdir(exec_path)) {
-               printf("git: '%s': %s\n", exec_path, strerror(errno));
-               exit (1);
+       argv[0] = cmd;
+
+       /*
+        * We search for git commands in the following order:
+        *  - git_exec_path()
+        *  - the path of the "git" command if we could find it
+        *    in $0
+        *  - the regular PATH.
+        */
+       if (exec_path)
+               prepend_to_path(exec_path, strlen(exec_path));
+       exec_path = git_exec_path();
+       prepend_to_path(exec_path, strlen(exec_path));
+
+       while (1) {
+               /* See if it's an internal command */
+               handle_internal_command(argc, argv, envp);
+
+               /* .. then try the external ones */
+               execv_git_cmd(argv);
+
+               /* It could be an alias -- this works around the insanity
+                * of overriding "git log" with "git show" by having
+                * alias.log = show
+                */
+               if (done_alias || !handle_alias(&argc, &argv))
+                       break;
+               done_alias = 1;
        }
 
-       getcwd(git_command, sizeof(git_command));
-       chdir(wd);
-
-       len = strlen(git_command);
-       prepend_to_path(git_command, len);
-
-       strncat(&git_command[len], "/git-", sizeof(git_command) - len);
-       len += 5;
-       strncat(&git_command[len], argv[i], sizeof(git_command) - len);
-
-       if (access(git_command, X_OK))
-               usage(exec_path, "'%s' is not a git-command", argv[i]);
+       if (errno == ENOENT)
+               cmd_usage(0, exec_path, "'%s' is not a git-command", cmd);
 
-       /* execve() can only ever return if it fails */
-       execve(git_command, &argv[i], envp);
-       printf("Failed to run command '%s': %s\n", git_command, strerror(errno));
+       fprintf(stderr, "Failed to run command '%s': %s\n",
+               git_command, strerror(errno));
 
        return 1;
 }