Improve the git-diff-tree -c/-cc documentation
[git/jrn.git] / git.c
blobfa58232ddf146ee9edcf51403e551f8d2fa015a5
1 #include <stdio.h>
2 #include <sys/types.h>
3 #include <sys/stat.h>
4 #include <dirent.h>
5 #include <unistd.h>
6 #include <stdlib.h>
7 #include <string.h>
8 #include <errno.h>
9 #include <limits.h>
10 #include <stdarg.h>
11 #include <sys/ioctl.h>
12 #include "git-compat-util.h"
13 #include "exec_cmd.h"
14 #include "common-cmds.h"
16 #include "cache.h"
17 #include "commit.h"
18 #include "revision.h"
20 #ifndef PATH_MAX
21 # define PATH_MAX 4096
22 #endif
24 static const char git_usage[] =
25 "Usage: git [--version] [--exec-path[=GIT_EXEC_PATH]] [--help] COMMAND [ ARGS ]";
27 /* most gui terms set COLUMNS (although some don't export it) */
28 static int term_columns(void)
30 char *col_string = getenv("COLUMNS");
31 int n_cols = 0;
33 if (col_string && (n_cols = atoi(col_string)) > 0)
34 return n_cols;
36 #ifdef TIOCGWINSZ
38 struct winsize ws;
39 if (!ioctl(1, TIOCGWINSZ, &ws)) {
40 if (ws.ws_col)
41 return ws.ws_col;
44 #endif
46 return 80;
49 static void oom(void)
51 fprintf(stderr, "git: out of memory\n");
52 exit(1);
55 static inline void mput_char(char c, unsigned int num)
57 while(num--)
58 putchar(c);
61 static struct cmdname {
62 size_t len;
63 char name[1];
64 } **cmdname;
65 static int cmdname_alloc, cmdname_cnt;
67 static void add_cmdname(const char *name, int len)
69 struct cmdname *ent;
70 if (cmdname_alloc <= cmdname_cnt) {
71 cmdname_alloc = cmdname_alloc + 200;
72 cmdname = realloc(cmdname, cmdname_alloc * sizeof(*cmdname));
73 if (!cmdname)
74 oom();
76 ent = malloc(sizeof(*ent) + len);
77 if (!ent)
78 oom();
79 ent->len = len;
80 memcpy(ent->name, name, len);
81 ent->name[len] = 0;
82 cmdname[cmdname_cnt++] = ent;
85 static int cmdname_compare(const void *a_, const void *b_)
87 struct cmdname *a = *(struct cmdname **)a_;
88 struct cmdname *b = *(struct cmdname **)b_;
89 return strcmp(a->name, b->name);
92 static void pretty_print_string_list(struct cmdname **cmdname, int longest)
94 int cols = 1, rows;
95 int space = longest + 1; /* min 1 SP between words */
96 int max_cols = term_columns() - 1; /* don't print *on* the edge */
97 int i, j;
99 if (space < max_cols)
100 cols = max_cols / space;
101 rows = (cmdname_cnt + cols - 1) / cols;
103 qsort(cmdname, cmdname_cnt, sizeof(*cmdname), cmdname_compare);
105 for (i = 0; i < rows; i++) {
106 printf(" ");
108 for (j = 0; j < cols; j++) {
109 int n = j * rows + i;
110 int size = space;
111 if (n >= cmdname_cnt)
112 break;
113 if (j == cols-1 || n + rows >= cmdname_cnt)
114 size = 1;
115 printf("%-*s", size, cmdname[n]->name);
117 putchar('\n');
121 static void list_commands(const char *exec_path, const char *pattern)
123 unsigned int longest = 0;
124 char path[PATH_MAX];
125 int dirlen;
126 DIR *dir = opendir(exec_path);
127 struct dirent *de;
129 if (!dir) {
130 fprintf(stderr, "git: '%s': %s\n", exec_path, strerror(errno));
131 exit(1);
134 dirlen = strlen(exec_path);
135 if (PATH_MAX - 20 < dirlen) {
136 fprintf(stderr, "git: insanely long exec-path '%s'\n",
137 exec_path);
138 exit(1);
141 memcpy(path, exec_path, dirlen);
142 path[dirlen++] = '/';
144 while ((de = readdir(dir)) != NULL) {
145 struct stat st;
146 int entlen;
148 if (strncmp(de->d_name, "git-", 4))
149 continue;
150 strcpy(path+dirlen, de->d_name);
151 if (stat(path, &st) || /* stat, not lstat */
152 !S_ISREG(st.st_mode) ||
153 !(st.st_mode & S_IXUSR))
154 continue;
156 entlen = strlen(de->d_name);
157 if (4 < entlen && !strcmp(de->d_name + entlen - 4, ".exe"))
158 entlen -= 4;
160 if (longest < entlen)
161 longest = entlen;
163 add_cmdname(de->d_name + 4, entlen-4);
165 closedir(dir);
167 printf("git commands available in '%s'\n", exec_path);
168 printf("----------------------------");
169 mput_char('-', strlen(exec_path));
170 putchar('\n');
171 pretty_print_string_list(cmdname, longest - 4);
172 putchar('\n');
175 static void list_common_cmds_help(void)
177 int i, longest = 0;
179 for (i = 0; i < ARRAY_SIZE(common_cmds); i++) {
180 if (longest < strlen(common_cmds[i].name))
181 longest = strlen(common_cmds[i].name);
184 puts("The most commonly used git commands are:");
185 for (i = 0; i < ARRAY_SIZE(common_cmds); i++) {
186 printf(" %s", common_cmds[i].name);
187 mput_char(' ', longest - strlen(common_cmds[i].name) + 4);
188 puts(common_cmds[i].help);
190 puts("(use 'git help -a' to get a list of all installed git commands)");
193 #ifdef __GNUC__
194 static void cmd_usage(int show_all, const char *exec_path, const char *fmt, ...)
195 __attribute__((__format__(__printf__, 3, 4), __noreturn__));
196 #endif
197 static void cmd_usage(int show_all, const char *exec_path, const char *fmt, ...)
199 if (fmt) {
200 va_list ap;
202 va_start(ap, fmt);
203 printf("git: ");
204 vprintf(fmt, ap);
205 va_end(ap);
206 putchar('\n');
208 else
209 puts(git_usage);
211 if (exec_path) {
212 putchar('\n');
213 if (show_all)
214 list_commands(exec_path, "git-*");
215 else
216 list_common_cmds_help();
219 exit(1);
222 static void prepend_to_path(const char *dir, int len)
224 char *path, *old_path = getenv("PATH");
225 int path_len = len;
227 if (!old_path)
228 old_path = "/usr/local/bin:/usr/bin:/bin";
230 path_len = len + strlen(old_path) + 1;
232 path = malloc(path_len + 1);
234 memcpy(path, dir, len);
235 path[len] = ':';
236 memcpy(path + len + 1, old_path, path_len - len);
238 setenv("PATH", path, 1);
241 static void show_man_page(const char *git_cmd)
243 const char *page;
245 if (!strncmp(git_cmd, "git", 3))
246 page = git_cmd;
247 else {
248 int page_len = strlen(git_cmd) + 4;
249 char *p = malloc(page_len + 1);
250 strcpy(p, "git-");
251 strcpy(p + 4, git_cmd);
252 p[page_len] = 0;
253 page = p;
256 execlp("man", "man", page, NULL);
259 static int cmd_version(int argc, const char **argv, char **envp)
261 printf("git version %s\n", GIT_VERSION);
262 return 0;
265 static int cmd_help(int argc, const char **argv, char **envp)
267 const char *help_cmd = argv[1];
268 if (!help_cmd)
269 cmd_usage(0, git_exec_path(), NULL);
270 else if (!strcmp(help_cmd, "--all") || !strcmp(help_cmd, "-a"))
271 cmd_usage(1, git_exec_path(), NULL);
272 else
273 show_man_page(help_cmd);
274 return 0;
277 #define LOGSIZE (65536)
279 static int cmd_log(int argc, const char **argv, char **envp)
281 struct rev_info rev;
282 struct commit *commit;
283 char *buf = xmalloc(LOGSIZE);
284 static enum cmit_fmt commit_format = CMIT_FMT_DEFAULT;
285 int abbrev = DEFAULT_ABBREV;
286 int abbrev_commit = 0;
287 const char *commit_prefix = "commit ";
289 argc = setup_revisions(argc, argv, &rev, "HEAD");
290 while (1 < argc) {
291 const char *arg = argv[1];
292 if (!strncmp(arg, "--pretty", 8)) {
293 commit_format = get_commit_format(arg + 8);
294 if (commit_format == CMIT_FMT_ONELINE)
295 commit_prefix = "";
297 else if (!strcmp(arg, "--no-abbrev")) {
298 abbrev = 0;
300 else if (!strcmp(arg, "--abbrev")) {
301 abbrev = DEFAULT_ABBREV;
303 else if (!strcmp(arg, "--abbrev-commit")) {
304 abbrev_commit = 1;
306 else if (!strncmp(arg, "--abbrev=", 9)) {
307 abbrev = strtoul(arg + 9, NULL, 10);
308 if (abbrev && abbrev < MINIMUM_ABBREV)
309 abbrev = MINIMUM_ABBREV;
310 else if (40 < abbrev)
311 abbrev = 40;
313 else
314 die("unrecognized argument: %s", arg);
315 argc--; argv++;
318 prepare_revision_walk(&rev);
319 setup_pager();
320 while ((commit = get_revision(&rev)) != NULL) {
321 fputs(commit_prefix, stdout);
322 if (abbrev_commit && abbrev)
323 fputs(find_unique_abbrev(commit->object.sha1, abbrev),
324 stdout);
325 else
326 fputs(sha1_to_hex(commit->object.sha1), stdout);
327 if (rev.parents) {
328 struct commit_list *parents = commit->parents;
329 while (parents) {
330 struct object *o = &(parents->item->object);
331 parents = parents->next;
332 if (o->flags & TMP_MARK)
333 continue;
334 printf(" %s", sha1_to_hex(o->sha1));
335 o->flags |= TMP_MARK;
337 /* TMP_MARK is a general purpose flag that can
338 * be used locally, but the user should clean
339 * things up after it is done with them.
341 for (parents = commit->parents;
342 parents;
343 parents = parents->next)
344 parents->item->object.flags &= ~TMP_MARK;
346 if (commit_format == CMIT_FMT_ONELINE)
347 putchar(' ');
348 else
349 putchar('\n');
350 pretty_print_commit(commit_format, commit, ~0, buf,
351 LOGSIZE, abbrev);
352 printf("%s\n", buf);
354 free(buf);
355 return 0;
358 static void handle_internal_command(int argc, const char **argv, char **envp)
360 const char *cmd = argv[0];
361 static struct cmd_struct {
362 const char *cmd;
363 int (*fn)(int, const char **, char **);
364 } commands[] = {
365 { "version", cmd_version },
366 { "help", cmd_help },
367 { "log", cmd_log },
369 int i;
371 for (i = 0; i < ARRAY_SIZE(commands); i++) {
372 struct cmd_struct *p = commands+i;
373 if (strcmp(p->cmd, cmd))
374 continue;
375 exit(p->fn(argc, argv, envp));
379 int main(int argc, const char **argv, char **envp)
381 const char *cmd = argv[0];
382 char *slash = strrchr(cmd, '/');
383 char git_command[PATH_MAX + 1];
384 const char *exec_path = NULL;
387 * Take the basename of argv[0] as the command
388 * name, and the dirname as the default exec_path
389 * if it's an absolute path and we don't have
390 * anything better.
392 if (slash) {
393 *slash++ = 0;
394 if (*cmd == '/')
395 exec_path = cmd;
396 cmd = slash;
400 * "git-xxxx" is the same as "git xxxx", but we obviously:
402 * - cannot take flags in between the "git" and the "xxxx".
403 * - cannot execute it externally (since it would just do
404 * the same thing over again)
406 * So we just directly call the internal command handler, and
407 * die if that one cannot handle it.
409 if (!strncmp(cmd, "git-", 4)) {
410 cmd += 4;
411 argv[0] = cmd;
412 handle_internal_command(argc, argv, envp);
413 die("cannot handle %s internally", cmd);
416 /* Default command: "help" */
417 cmd = "help";
419 /* Look for flags.. */
420 while (argc > 1) {
421 cmd = *++argv;
422 argc--;
424 if (strncmp(cmd, "--", 2))
425 break;
427 cmd += 2;
430 * For legacy reasons, the "version" and "help"
431 * commands can be written with "--" prepended
432 * to make them look like flags.
434 if (!strcmp(cmd, "help"))
435 break;
436 if (!strcmp(cmd, "version"))
437 break;
440 * Check remaining flags (which by now must be
441 * "--exec-path", but maybe we will accept
442 * other arguments some day)
444 if (!strncmp(cmd, "exec-path", 9)) {
445 cmd += 9;
446 if (*cmd == '=') {
447 git_set_exec_path(cmd + 1);
448 continue;
450 puts(git_exec_path());
451 exit(0);
453 cmd_usage(0, NULL, NULL);
455 argv[0] = cmd;
458 * We search for git commands in the following order:
459 * - git_exec_path()
460 * - the path of the "git" command if we could find it
461 * in $0
462 * - the regular 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 /* See if it's an internal command */
470 handle_internal_command(argc, argv, envp);
472 /* .. then try the external ones */
473 execv_git_cmd(argv);
475 if (errno == ENOENT)
476 cmd_usage(0, exec_path, "'%s' is not a git-command", cmd);
478 fprintf(stderr, "Failed to run command '%s': %s\n",
479 git_command, strerror(errno));
481 return 1;