Document -g (--walk-reflogs) option of git-log
[git/mingw.git] / builtin-grep.c
blobe13cb31f2b9dd63d335437fb5b1c9b0b06fbf188
1 /*
2 * Builtin "git grep"
4 * Copyright (c) 2006 Junio C Hamano
5 */
6 #include "cache.h"
7 #include "blob.h"
8 #include "tree.h"
9 #include "commit.h"
10 #include "tag.h"
11 #include "tree-walk.h"
12 #include "builtin.h"
13 #include "grep.h"
16 * git grep pathspecs are somewhat different from diff-tree pathspecs;
17 * pathname wildcards are allowed.
19 static int pathspec_matches(const char **paths, const char *name)
21 int namelen, i;
22 if (!paths || !*paths)
23 return 1;
24 namelen = strlen(name);
25 for (i = 0; paths[i]; i++) {
26 const char *match = paths[i];
27 int matchlen = strlen(match);
28 const char *cp, *meta;
30 if (!matchlen ||
31 ((matchlen <= namelen) &&
32 !strncmp(name, match, matchlen) &&
33 (match[matchlen-1] == '/' ||
34 name[matchlen] == '\0' || name[matchlen] == '/')))
35 return 1;
36 if (!fnmatch(match, name, 0))
37 return 1;
38 if (name[namelen-1] != '/')
39 continue;
41 /* We are being asked if the directory ("name") is worth
42 * descending into.
44 * Find the longest leading directory name that does
45 * not have metacharacter in the pathspec; the name
46 * we are looking at must overlap with that directory.
48 for (cp = match, meta = NULL; cp - match < matchlen; cp++) {
49 char ch = *cp;
50 if (ch == '*' || ch == '[' || ch == '?') {
51 meta = cp;
52 break;
55 if (!meta)
56 meta = cp; /* fully literal */
58 if (namelen <= meta - match) {
59 /* Looking at "Documentation/" and
60 * the pattern says "Documentation/howto/", or
61 * "Documentation/diff*.txt". The name we
62 * have should match prefix.
64 if (!memcmp(match, name, namelen))
65 return 1;
66 continue;
69 if (meta - match < namelen) {
70 /* Looking at "Documentation/howto/" and
71 * the pattern says "Documentation/h*";
72 * match up to "Do.../h"; this avoids descending
73 * into "Documentation/technical/".
75 if (!memcmp(match, name, meta - match))
76 return 1;
77 continue;
80 return 0;
83 static int grep_sha1(struct grep_opt *opt, const unsigned char *sha1, const char *name, int tree_name_len)
85 unsigned long size;
86 char *data;
87 enum object_type type;
88 char *to_free = NULL;
89 int hit;
91 data = read_sha1_file(sha1, &type, &size);
92 if (!data) {
93 error("'%s': unable to read %s", name, sha1_to_hex(sha1));
94 return 0;
96 if (opt->relative && opt->prefix_length) {
97 static char name_buf[PATH_MAX];
98 char *cp;
99 int name_len = strlen(name) - opt->prefix_length + 1;
101 if (!tree_name_len)
102 name += opt->prefix_length;
103 else {
104 if (ARRAY_SIZE(name_buf) <= name_len)
105 cp = to_free = xmalloc(name_len);
106 else
107 cp = name_buf;
108 memcpy(cp, name, tree_name_len);
109 strcpy(cp + tree_name_len,
110 name + tree_name_len + opt->prefix_length);
111 name = cp;
114 hit = grep_buffer(opt, name, data, size);
115 free(data);
116 free(to_free);
117 return hit;
120 static int grep_file(struct grep_opt *opt, const char *filename)
122 struct stat st;
123 int i;
124 char *data;
125 size_t sz;
127 if (lstat(filename, &st) < 0) {
128 err_ret:
129 if (errno != ENOENT)
130 error("'%s': %s", filename, strerror(errno));
131 return 0;
133 if (!st.st_size)
134 return 0; /* empty file -- no grep hit */
135 if (!S_ISREG(st.st_mode))
136 return 0;
137 sz = xsize_t(st.st_size);
138 i = open(filename, O_RDONLY);
139 if (i < 0)
140 goto err_ret;
141 data = xmalloc(sz + 1);
142 if (st.st_size != read_in_full(i, data, sz)) {
143 error("'%s': short read %s", filename, strerror(errno));
144 close(i);
145 free(data);
146 return 0;
148 close(i);
149 if (opt->relative && opt->prefix_length)
150 filename += opt->prefix_length;
151 i = grep_buffer(opt, filename, data, sz);
152 free(data);
153 return i;
156 #ifdef __unix__
157 static int exec_grep(int argc, const char **argv)
159 pid_t pid;
160 int status;
162 argv[argc] = NULL;
163 pid = fork();
164 if (pid < 0)
165 return pid;
166 if (!pid) {
167 execvp("grep", (char **) argv);
168 exit(255);
170 while (waitpid(pid, &status, 0) < 0) {
171 if (errno == EINTR)
172 continue;
173 return -1;
175 if (WIFEXITED(status)) {
176 if (!WEXITSTATUS(status))
177 return 1;
178 return 0;
180 return -1;
183 #define MAXARGS 1000
184 #define ARGBUF 4096
185 #define push_arg(a) do { \
186 if (nr < MAXARGS) argv[nr++] = (a); \
187 else die("maximum number of args exceeded"); \
188 } while (0)
190 static int external_grep(struct grep_opt *opt, const char **paths, int cached)
192 int i, nr, argc, hit, len, status;
193 const char *argv[MAXARGS+1];
194 char randarg[ARGBUF];
195 char *argptr = randarg;
196 struct grep_pat *p;
198 if (opt->extended || (opt->relative && opt->prefix_length))
199 return -1;
200 len = nr = 0;
201 push_arg("grep");
202 if (opt->fixed)
203 push_arg("-F");
204 if (opt->linenum)
205 push_arg("-n");
206 if (!opt->pathname)
207 push_arg("-h");
208 if (opt->regflags & REG_EXTENDED)
209 push_arg("-E");
210 if (opt->regflags & REG_ICASE)
211 push_arg("-i");
212 if (opt->word_regexp)
213 push_arg("-w");
214 if (opt->name_only)
215 push_arg("-l");
216 if (opt->unmatch_name_only)
217 push_arg("-L");
218 if (opt->count)
219 push_arg("-c");
220 if (opt->post_context || opt->pre_context) {
221 if (opt->post_context != opt->pre_context) {
222 if (opt->pre_context) {
223 push_arg("-B");
224 len += snprintf(argptr, sizeof(randarg)-len,
225 "%u", opt->pre_context);
226 if (sizeof(randarg) <= len)
227 die("maximum length of args exceeded");
228 push_arg(argptr);
229 argptr += len;
231 if (opt->post_context) {
232 push_arg("-A");
233 len += snprintf(argptr, sizeof(randarg)-len,
234 "%u", opt->post_context);
235 if (sizeof(randarg) <= len)
236 die("maximum length of args exceeded");
237 push_arg(argptr);
238 argptr += len;
241 else {
242 push_arg("-C");
243 len += snprintf(argptr, sizeof(randarg)-len,
244 "%u", opt->post_context);
245 if (sizeof(randarg) <= len)
246 die("maximum length of args exceeded");
247 push_arg(argptr);
248 argptr += len;
251 for (p = opt->pattern_list; p; p = p->next) {
252 push_arg("-e");
253 push_arg(p->pattern);
257 * To make sure we get the header printed out when we want it,
258 * add /dev/null to the paths to grep. This is unnecessary
259 * (and wrong) with "-l" or "-L", which always print out the
260 * name anyway.
262 * GNU grep has "-H", but this is portable.
264 if (!opt->name_only && !opt->unmatch_name_only)
265 push_arg("/dev/null");
267 hit = 0;
268 argc = nr;
269 for (i = 0; i < active_nr; i++) {
270 struct cache_entry *ce = active_cache[i];
271 char *name;
272 if (!S_ISREG(ntohl(ce->ce_mode)))
273 continue;
274 if (!pathspec_matches(paths, ce->name))
275 continue;
276 name = ce->name;
277 if (name[0] == '-') {
278 int len = ce_namelen(ce);
279 name = xmalloc(len + 3);
280 memcpy(name, "./", 2);
281 memcpy(name + 2, ce->name, len + 1);
283 argv[argc++] = name;
284 if (argc < MAXARGS && !ce_stage(ce))
285 continue;
286 status = exec_grep(argc, argv);
287 if (0 < status)
288 hit = 1;
289 argc = nr;
290 if (ce_stage(ce)) {
291 do {
292 i++;
293 } while (i < active_nr &&
294 !strcmp(ce->name, active_cache[i]->name));
295 i--; /* compensate for loop control */
298 if (argc > nr) {
299 status = exec_grep(argc, argv);
300 if (0 < status)
301 hit = 1;
303 return hit;
305 #endif
307 static int grep_cache(struct grep_opt *opt, const char **paths, int cached)
309 int hit = 0;
310 int nr;
311 read_cache();
313 #ifdef __unix__
315 * Use the external "grep" command for the case where
316 * we grep through the checked-out files. It tends to
317 * be a lot more optimized
319 if (!cached) {
320 hit = external_grep(opt, paths, cached);
321 if (hit >= 0)
322 return hit;
324 #endif
326 for (nr = 0; nr < active_nr; nr++) {
327 struct cache_entry *ce = active_cache[nr];
328 if (!S_ISREG(ntohl(ce->ce_mode)))
329 continue;
330 if (!pathspec_matches(paths, ce->name))
331 continue;
332 if (cached) {
333 if (ce_stage(ce))
334 continue;
335 hit |= grep_sha1(opt, ce->sha1, ce->name, 0);
337 else
338 hit |= grep_file(opt, ce->name);
339 if (ce_stage(ce)) {
340 do {
341 nr++;
342 } while (nr < active_nr &&
343 !strcmp(ce->name, active_cache[nr]->name));
344 nr--; /* compensate for loop control */
347 free_grep_patterns(opt);
348 return hit;
351 static int grep_tree(struct grep_opt *opt, const char **paths,
352 struct tree_desc *tree,
353 const char *tree_name, const char *base)
355 int len;
356 int hit = 0;
357 struct name_entry entry;
358 char *down;
359 int tn_len = strlen(tree_name);
360 char *path_buf = xmalloc(PATH_MAX + tn_len + 100);
362 if (tn_len) {
363 tn_len = sprintf(path_buf, "%s:", tree_name);
364 down = path_buf + tn_len;
365 strcat(down, base);
367 else {
368 down = path_buf;
369 strcpy(down, base);
371 len = strlen(path_buf);
373 while (tree_entry(tree, &entry)) {
374 strcpy(path_buf + len, entry.path);
376 if (S_ISDIR(entry.mode))
377 /* Match "abc/" against pathspec to
378 * decide if we want to descend into "abc"
379 * directory.
381 strcpy(path_buf + len + tree_entry_len(entry.path, entry.sha1), "/");
383 if (!pathspec_matches(paths, down))
385 else if (S_ISREG(entry.mode))
386 hit |= grep_sha1(opt, entry.sha1, path_buf, tn_len);
387 else if (S_ISDIR(entry.mode)) {
388 enum object_type type;
389 struct tree_desc sub;
390 void *data;
391 unsigned long size;
393 data = read_sha1_file(entry.sha1, &type, &size);
394 if (!data)
395 die("unable to read tree (%s)",
396 sha1_to_hex(entry.sha1));
397 init_tree_desc(&sub, data, size);
398 hit |= grep_tree(opt, paths, &sub, tree_name, down);
399 free(data);
402 return hit;
405 static int grep_object(struct grep_opt *opt, const char **paths,
406 struct object *obj, const char *name)
408 if (obj->type == OBJ_BLOB)
409 return grep_sha1(opt, obj->sha1, name, 0);
410 if (obj->type == OBJ_COMMIT || obj->type == OBJ_TREE) {
411 struct tree_desc tree;
412 void *data;
413 unsigned long size;
414 int hit;
415 data = read_object_with_reference(obj->sha1, tree_type,
416 &size, NULL);
417 if (!data)
418 die("unable to read tree (%s)", sha1_to_hex(obj->sha1));
419 init_tree_desc(&tree, data, size);
420 hit = grep_tree(opt, paths, &tree, name, "");
421 free(data);
422 return hit;
424 die("unable to grep from object of type %s", typename(obj->type));
427 static const char builtin_grep_usage[] =
428 "git-grep <option>* <rev>* [-e] <pattern> [<path>...]";
430 static const char emsg_invalid_context_len[] =
431 "%s: invalid context length argument";
432 static const char emsg_missing_context_len[] =
433 "missing context length argument";
434 static const char emsg_missing_argument[] =
435 "option requires an argument -%s";
437 int cmd_grep(int argc, const char **argv, const char *prefix)
439 int hit = 0;
440 int cached = 0;
441 int seen_dashdash = 0;
442 struct grep_opt opt;
443 struct object_array list = { 0, 0, NULL };
444 const char **paths = NULL;
445 int i;
447 memset(&opt, 0, sizeof(opt));
448 opt.prefix_length = (prefix && *prefix) ? strlen(prefix) : 0;
449 opt.relative = 1;
450 opt.pathname = 1;
451 opt.pattern_tail = &opt.pattern_list;
452 opt.regflags = REG_NEWLINE;
455 * If there is no -- then the paths must exist in the working
456 * tree. If there is no explicit pattern specified with -e or
457 * -f, we take the first unrecognized non option to be the
458 * pattern, but then what follows it must be zero or more
459 * valid refs up to the -- (if exists), and then existing
460 * paths. If there is an explicit pattern, then the first
461 * unrecognized non option is the beginning of the refs list
462 * that continues up to the -- (if exists), and then paths.
465 while (1 < argc) {
466 const char *arg = argv[1];
467 argc--; argv++;
468 if (!strcmp("--cached", arg)) {
469 cached = 1;
470 continue;
472 if (!strcmp("-a", arg) ||
473 !strcmp("--text", arg)) {
474 opt.binary = GREP_BINARY_TEXT;
475 continue;
477 if (!strcmp("-i", arg) ||
478 !strcmp("--ignore-case", arg)) {
479 opt.regflags |= REG_ICASE;
480 continue;
482 if (!strcmp("-I", arg)) {
483 opt.binary = GREP_BINARY_NOMATCH;
484 continue;
486 if (!strcmp("-v", arg) ||
487 !strcmp("--invert-match", arg)) {
488 opt.invert = 1;
489 continue;
491 if (!strcmp("-E", arg) ||
492 !strcmp("--extended-regexp", arg)) {
493 opt.regflags |= REG_EXTENDED;
494 continue;
496 if (!strcmp("-F", arg) ||
497 !strcmp("--fixed-strings", arg)) {
498 opt.fixed = 1;
499 continue;
501 if (!strcmp("-G", arg) ||
502 !strcmp("--basic-regexp", arg)) {
503 opt.regflags &= ~REG_EXTENDED;
504 continue;
506 if (!strcmp("-n", arg)) {
507 opt.linenum = 1;
508 continue;
510 if (!strcmp("-h", arg)) {
511 opt.pathname = 0;
512 continue;
514 if (!strcmp("-H", arg)) {
515 opt.pathname = 1;
516 continue;
518 if (!strcmp("-l", arg) ||
519 !strcmp("--files-with-matches", arg)) {
520 opt.name_only = 1;
521 continue;
523 if (!strcmp("-L", arg) ||
524 !strcmp("--files-without-match", arg)) {
525 opt.unmatch_name_only = 1;
526 continue;
528 if (!strcmp("-c", arg) ||
529 !strcmp("--count", arg)) {
530 opt.count = 1;
531 continue;
533 if (!strcmp("-w", arg) ||
534 !strcmp("--word-regexp", arg)) {
535 opt.word_regexp = 1;
536 continue;
538 if (!prefixcmp(arg, "-A") ||
539 !prefixcmp(arg, "-B") ||
540 !prefixcmp(arg, "-C") ||
541 (arg[0] == '-' && '1' <= arg[1] && arg[1] <= '9')) {
542 unsigned num;
543 const char *scan;
544 switch (arg[1]) {
545 case 'A': case 'B': case 'C':
546 if (!arg[2]) {
547 if (argc <= 1)
548 die(emsg_missing_context_len);
549 scan = *++argv;
550 argc--;
552 else
553 scan = arg + 2;
554 break;
555 default:
556 scan = arg + 1;
557 break;
559 if (strtoul_ui(scan, 10, &num))
560 die(emsg_invalid_context_len, scan);
561 switch (arg[1]) {
562 case 'A':
563 opt.post_context = num;
564 break;
565 default:
566 case 'C':
567 opt.post_context = num;
568 case 'B':
569 opt.pre_context = num;
570 break;
572 continue;
574 if (!strcmp("-f", arg)) {
575 FILE *patterns;
576 int lno = 0;
577 char buf[1024];
578 if (argc <= 1)
579 die(emsg_missing_argument, arg);
580 patterns = fopen(argv[1], "r");
581 if (!patterns)
582 die("'%s': %s", argv[1], strerror(errno));
583 while (fgets(buf, sizeof(buf), patterns)) {
584 int len = strlen(buf);
585 if (buf[len-1] == '\n')
586 buf[len-1] = 0;
587 /* ignore empty line like grep does */
588 if (!buf[0])
589 continue;
590 append_grep_pattern(&opt, xstrdup(buf),
591 argv[1], ++lno,
592 GREP_PATTERN);
594 fclose(patterns);
595 argv++;
596 argc--;
597 continue;
599 if (!strcmp("--not", arg)) {
600 append_grep_pattern(&opt, arg, "command line", 0,
601 GREP_NOT);
602 continue;
604 if (!strcmp("--and", arg)) {
605 append_grep_pattern(&opt, arg, "command line", 0,
606 GREP_AND);
607 continue;
609 if (!strcmp("--or", arg))
610 continue; /* no-op */
611 if (!strcmp("(", arg)) {
612 append_grep_pattern(&opt, arg, "command line", 0,
613 GREP_OPEN_PAREN);
614 continue;
616 if (!strcmp(")", arg)) {
617 append_grep_pattern(&opt, arg, "command line", 0,
618 GREP_CLOSE_PAREN);
619 continue;
621 if (!strcmp("--all-match", arg)) {
622 opt.all_match = 1;
623 continue;
625 if (!strcmp("-e", arg)) {
626 if (1 < argc) {
627 append_grep_pattern(&opt, argv[1],
628 "-e option", 0,
629 GREP_PATTERN);
630 argv++;
631 argc--;
632 continue;
634 die(emsg_missing_argument, arg);
636 if (!strcmp("--full-name", arg)) {
637 opt.relative = 0;
638 continue;
640 if (!strcmp("--", arg)) {
641 /* later processing wants to have this at argv[1] */
642 argv--;
643 argc++;
644 break;
646 if (*arg == '-')
647 usage(builtin_grep_usage);
649 /* First unrecognized non-option token */
650 if (!opt.pattern_list) {
651 append_grep_pattern(&opt, arg, "command line", 0,
652 GREP_PATTERN);
653 break;
655 else {
656 /* We are looking at the first path or rev;
657 * it is found at argv[1] after leaving the
658 * loop.
660 argc++; argv--;
661 break;
665 if (!opt.pattern_list)
666 die("no pattern given.");
667 if ((opt.regflags != REG_NEWLINE) && opt.fixed)
668 die("cannot mix --fixed-strings and regexp");
669 compile_grep_patterns(&opt);
671 /* Check revs and then paths */
672 for (i = 1; i < argc; i++) {
673 const char *arg = argv[i];
674 unsigned char sha1[20];
675 /* Is it a rev? */
676 if (!get_sha1(arg, sha1)) {
677 struct object *object = parse_object(sha1);
678 if (!object)
679 die("bad object %s", arg);
680 add_object_array(object, arg, &list);
681 continue;
683 if (!strcmp(arg, "--")) {
684 i++;
685 seen_dashdash = 1;
687 break;
690 /* The rest are paths */
691 if (!seen_dashdash) {
692 int j;
693 for (j = i; j < argc; j++)
694 verify_filename(prefix, argv[j]);
697 if (i < argc) {
698 paths = get_pathspec(prefix, argv + i);
699 if (opt.prefix_length && opt.relative) {
700 /* Make sure we do not get outside of paths */
701 for (i = 0; paths[i]; i++)
702 if (strncmp(prefix, paths[i], opt.prefix_length))
703 die("git-grep: cannot generate relative filenames containing '..'");
706 else if (prefix) {
707 paths = xcalloc(2, sizeof(const char *));
708 paths[0] = prefix;
709 paths[1] = NULL;
712 if (!list.nr)
713 return !grep_cache(&opt, paths, cached);
715 if (cached)
716 die("both --cached and trees are given.");
718 for (i = 0; i < list.nr; i++) {
719 struct object *real_obj;
720 real_obj = deref_tag(list.objects[i].item, NULL, 0);
721 if (grep_object(&opt, paths, real_obj, list.objects[i].name))
722 hit = 1;
724 free_grep_patterns(&opt);
725 return !hit;