1/* 2 * Blame 3 * 4 * Copyright (c) 2006, 2014 by its authors 5 * See COPYING for licensing conditions 6 */ 7 8#include"cache.h" 9#include"refs.h" 10#include"builtin.h" 11#include"blob.h" 12#include"commit.h" 13#include"tag.h" 14#include"tree-walk.h" 15#include"diff.h" 16#include"diffcore.h" 17#include"revision.h" 18#include"quote.h" 19#include"xdiff-interface.h" 20#include"cache-tree.h" 21#include"string-list.h" 22#include"mailmap.h" 23#include"mergesort.h" 24#include"parse-options.h" 25#include"prio-queue.h" 26#include"utf8.h" 27#include"userdiff.h" 28#include"line-range.h" 29#include"line-log.h" 30#include"dir.h" 31 32static char blame_usage[] =N_("git blame [<options>] [<rev-opts>] [<rev>] [--] <file>"); 33 34static const char*blame_opt_usage[] = { 35 blame_usage, 36"", 37N_("<rev-opts> are documented in git-rev-list(1)"), 38 NULL 39}; 40 41static int longest_file; 42static int longest_author; 43static int max_orig_digits; 44static int max_digits; 45static int max_score_digits; 46static int show_root; 47static int reverse; 48static int blank_boundary; 49static int incremental; 50static int xdl_opts; 51static int abbrev = -1; 52static int no_whole_file_rename; 53 54static struct date_mode blame_date_mode = { DATE_ISO8601 }; 55static size_t blame_date_width; 56 57static struct string_list mailmap; 58 59#ifndef DEBUG 60#define DEBUG 0 61#endif 62 63/* stats */ 64static int num_read_blob; 65static int num_get_patch; 66static int num_commits; 67 68#define PICKAXE_BLAME_MOVE 01 69#define PICKAXE_BLAME_COPY 02 70#define PICKAXE_BLAME_COPY_HARDER 04 71#define PICKAXE_BLAME_COPY_HARDEST 010 72 73/* 74 * blame for a blame_entry with score lower than these thresholds 75 * is not passed to the parent using move/copy logic. 76 */ 77static unsigned blame_move_score; 78static unsigned blame_copy_score; 79#define BLAME_DEFAULT_MOVE_SCORE 20 80#define BLAME_DEFAULT_COPY_SCORE 40 81 82/* Remember to update object flag allocation in object.h */ 83#define METAINFO_SHOWN (1u<<12) 84#define MORE_THAN_ONE_PATH (1u<<13) 85 86/* 87 * One blob in a commit that is being suspected 88 */ 89struct origin { 90int refcnt; 91/* Record preceding blame record for this blob */ 92struct origin *previous; 93/* origins are put in a list linked via `next' hanging off the 94 * corresponding commit's util field in order to make finding 95 * them fast. The presence in this chain does not count 96 * towards the origin's reference count. It is tempting to 97 * let it count as long as the commit is pending examination, 98 * but even under circumstances where the commit will be 99 * present multiple times in the priority queue of unexamined 100 * commits, processing the first instance will not leave any 101 * work requiring the origin data for the second instance. An 102 * interspersed commit changing that would have to be 103 * preexisting with a different ancestry and with the same 104 * commit date in order to wedge itself between two instances 105 * of the same commit in the priority queue _and_ produce 106 * blame entries relevant for it. While we don't want to let 107 * us get tripped up by this case, it certainly does not seem 108 * worth optimizing for. 109 */ 110struct origin *next; 111struct commit *commit; 112/* `suspects' contains blame entries that may be attributed to 113 * this origin's commit or to parent commits. When a commit 114 * is being processed, all suspects will be moved, either by 115 * assigning them to an origin in a different commit, or by 116 * shipping them to the scoreboard's ent list because they 117 * cannot be attributed to a different commit. 118 */ 119struct blame_entry *suspects; 120 mmfile_t file; 121unsigned char blob_sha1[20]; 122unsigned mode; 123/* guilty gets set when shipping any suspects to the final 124 * blame list instead of other commits 125 */ 126char guilty; 127char path[FLEX_ARRAY]; 128}; 129 130static intdiff_hunks(mmfile_t *file_a, mmfile_t *file_b,long ctxlen, 131 xdl_emit_hunk_consume_func_t hunk_func,void*cb_data) 132{ 133 xpparam_t xpp = {0}; 134 xdemitconf_t xecfg = {0}; 135 xdemitcb_t ecb = {NULL}; 136 137 xpp.flags = xdl_opts; 138 xecfg.ctxlen = ctxlen; 139 xecfg.hunk_func = hunk_func; 140 ecb.priv = cb_data; 141returnxdi_diff(file_a, file_b, &xpp, &xecfg, &ecb); 142} 143 144/* 145 * Prepare diff_filespec and convert it using diff textconv API 146 * if the textconv driver exists. 147 * Return 1 if the conversion succeeds, 0 otherwise. 148 */ 149inttextconv_object(const char*path, 150unsigned mode, 151const unsigned char*sha1, 152int sha1_valid, 153char**buf, 154unsigned long*buf_size) 155{ 156struct diff_filespec *df; 157struct userdiff_driver *textconv; 158 159 df =alloc_filespec(path); 160fill_filespec(df, sha1, sha1_valid, mode); 161 textconv =get_textconv(df); 162if(!textconv) { 163free_filespec(df); 164return0; 165} 166 167*buf_size =fill_textconv(textconv, df, buf); 168free_filespec(df); 169return1; 170} 171 172/* 173 * Given an origin, prepare mmfile_t structure to be used by the 174 * diff machinery 175 */ 176static voidfill_origin_blob(struct diff_options *opt, 177struct origin *o, mmfile_t *file) 178{ 179if(!o->file.ptr) { 180enum object_type type; 181unsigned long file_size; 182 183 num_read_blob++; 184if(DIFF_OPT_TST(opt, ALLOW_TEXTCONV) && 185textconv_object(o->path, o->mode, o->blob_sha1,1, &file->ptr, &file_size)) 186; 187else 188 file->ptr =read_sha1_file(o->blob_sha1, &type, &file_size); 189 file->size = file_size; 190 191if(!file->ptr) 192die("Cannot read blob%sfor path%s", 193sha1_to_hex(o->blob_sha1), 194 o->path); 195 o->file = *file; 196} 197else 198*file = o->file; 199} 200 201/* 202 * Origin is refcounted and usually we keep the blob contents to be 203 * reused. 204 */ 205staticinlinestruct origin *origin_incref(struct origin *o) 206{ 207if(o) 208 o->refcnt++; 209return o; 210} 211 212static voidorigin_decref(struct origin *o) 213{ 214if(o && --o->refcnt <=0) { 215struct origin *p, *l = NULL; 216if(o->previous) 217origin_decref(o->previous); 218free(o->file.ptr); 219/* Should be present exactly once in commit chain */ 220for(p = o->commit->util; p; l = p, p = p->next) { 221if(p == o) { 222if(l) 223 l->next = p->next; 224else 225 o->commit->util = p->next; 226free(o); 227return; 228} 229} 230die("internal error in blame::origin_decref"); 231} 232} 233 234static voiddrop_origin_blob(struct origin *o) 235{ 236if(o->file.ptr) { 237free(o->file.ptr); 238 o->file.ptr = NULL; 239} 240} 241 242/* 243 * Each group of lines is described by a blame_entry; it can be split 244 * as we pass blame to the parents. They are arranged in linked lists 245 * kept as `suspects' of some unprocessed origin, or entered (when the 246 * blame origin has been finalized) into the scoreboard structure. 247 * While the scoreboard structure is only sorted at the end of 248 * processing (according to final image line number), the lists 249 * attached to an origin are sorted by the target line number. 250 */ 251struct blame_entry { 252struct blame_entry *next; 253 254/* the first line of this group in the final image; 255 * internally all line numbers are 0 based. 256 */ 257int lno; 258 259/* how many lines this group has */ 260int num_lines; 261 262/* the commit that introduced this group into the final image */ 263struct origin *suspect; 264 265/* the line number of the first line of this group in the 266 * suspect's file; internally all line numbers are 0 based. 267 */ 268int s_lno; 269 270/* how significant this entry is -- cached to avoid 271 * scanning the lines over and over. 272 */ 273unsigned score; 274}; 275 276/* 277 * Any merge of blames happens on lists of blames that arrived via 278 * different parents in a single suspect. In this case, we want to 279 * sort according to the suspect line numbers as opposed to the final 280 * image line numbers. The function body is somewhat longish because 281 * it avoids unnecessary writes. 282 */ 283 284static struct blame_entry *blame_merge(struct blame_entry *list1, 285struct blame_entry *list2) 286{ 287struct blame_entry *p1 = list1, *p2 = list2, 288**tail = &list1; 289 290if(!p1) 291return p2; 292if(!p2) 293return p1; 294 295if(p1->s_lno <= p2->s_lno) { 296do{ 297 tail = &p1->next; 298if((p1 = *tail) == NULL) { 299*tail = p2; 300return list1; 301} 302}while(p1->s_lno <= p2->s_lno); 303} 304for(;;) { 305*tail = p2; 306do{ 307 tail = &p2->next; 308if((p2 = *tail) == NULL) { 309*tail = p1; 310return list1; 311} 312}while(p1->s_lno > p2->s_lno); 313*tail = p1; 314do{ 315 tail = &p1->next; 316if((p1 = *tail) == NULL) { 317*tail = p2; 318return list1; 319} 320}while(p1->s_lno <= p2->s_lno); 321} 322} 323 324static void*get_next_blame(const void*p) 325{ 326return((struct blame_entry *)p)->next; 327} 328 329static voidset_next_blame(void*p1,void*p2) 330{ 331((struct blame_entry *)p1)->next = p2; 332} 333 334/* 335 * Final image line numbers are all different, so we don't need a 336 * three-way comparison here. 337 */ 338 339static intcompare_blame_final(const void*p1,const void*p2) 340{ 341return((struct blame_entry *)p1)->lno > ((struct blame_entry *)p2)->lno 342?1: -1; 343} 344 345static intcompare_blame_suspect(const void*p1,const void*p2) 346{ 347const struct blame_entry *s1 = p1, *s2 = p2; 348/* 349 * to allow for collating suspects, we sort according to the 350 * respective pointer value as the primary sorting criterion. 351 * The actual relation is pretty unimportant as long as it 352 * establishes a total order. Comparing as integers gives us 353 * that. 354 */ 355if(s1->suspect != s2->suspect) 356return(intptr_t)s1->suspect > (intptr_t)s2->suspect ?1: -1; 357if(s1->s_lno == s2->s_lno) 358return0; 359return s1->s_lno > s2->s_lno ?1: -1; 360} 361 362static struct blame_entry *blame_sort(struct blame_entry *head, 363int(*compare_fn)(const void*,const void*)) 364{ 365returnllist_mergesort(head, get_next_blame, set_next_blame, compare_fn); 366} 367 368static intcompare_commits_by_reverse_commit_date(const void*a, 369const void*b, 370void*c) 371{ 372return-compare_commits_by_commit_date(a, b, c); 373} 374 375/* 376 * The current state of the blame assignment. 377 */ 378struct scoreboard { 379/* the final commit (i.e. where we started digging from) */ 380struct commit *final; 381/* Priority queue for commits with unassigned blame records */ 382struct prio_queue commits; 383struct rev_info *revs; 384const char*path; 385 386/* 387 * The contents in the final image. 388 * Used by many functions to obtain contents of the nth line, 389 * indexed with scoreboard.lineno[blame_entry.lno]. 390 */ 391const char*final_buf; 392unsigned long final_buf_size; 393 394/* linked list of blames */ 395struct blame_entry *ent; 396 397/* look-up a line in the final buffer */ 398int num_lines; 399int*lineno; 400}; 401 402static voidsanity_check_refcnt(struct scoreboard *); 403 404/* 405 * If two blame entries that are next to each other came from 406 * contiguous lines in the same origin (i.e. <commit, path> pair), 407 * merge them together. 408 */ 409static voidcoalesce(struct scoreboard *sb) 410{ 411struct blame_entry *ent, *next; 412 413for(ent = sb->ent; ent && (next = ent->next); ent = next) { 414if(ent->suspect == next->suspect && 415 ent->s_lno + ent->num_lines == next->s_lno) { 416 ent->num_lines += next->num_lines; 417 ent->next = next->next; 418origin_decref(next->suspect); 419free(next); 420 ent->score =0; 421 next = ent;/* again */ 422} 423} 424 425if(DEBUG)/* sanity */ 426sanity_check_refcnt(sb); 427} 428 429/* 430 * Merge the given sorted list of blames into a preexisting origin. 431 * If there were no previous blames to that commit, it is entered into 432 * the commit priority queue of the score board. 433 */ 434 435static voidqueue_blames(struct scoreboard *sb,struct origin *porigin, 436struct blame_entry *sorted) 437{ 438if(porigin->suspects) 439 porigin->suspects =blame_merge(porigin->suspects, sorted); 440else{ 441struct origin *o; 442for(o = porigin->commit->util; o; o = o->next) { 443if(o->suspects) { 444 porigin->suspects = sorted; 445return; 446} 447} 448 porigin->suspects = sorted; 449prio_queue_put(&sb->commits, porigin->commit); 450} 451} 452 453/* 454 * Given a commit and a path in it, create a new origin structure. 455 * The callers that add blame to the scoreboard should use 456 * get_origin() to obtain shared, refcounted copy instead of calling 457 * this function directly. 458 */ 459static struct origin *make_origin(struct commit *commit,const char*path) 460{ 461struct origin *o; 462size_t pathlen =strlen(path) +1; 463 o =xcalloc(1,sizeof(*o) + pathlen); 464 o->commit = commit; 465 o->refcnt =1; 466 o->next = commit->util; 467 commit->util = o; 468memcpy(o->path, path, pathlen);/* includes NUL */ 469return o; 470} 471 472/* 473 * Locate an existing origin or create a new one. 474 * This moves the origin to front position in the commit util list. 475 */ 476static struct origin *get_origin(struct scoreboard *sb, 477struct commit *commit, 478const char*path) 479{ 480struct origin *o, *l; 481 482for(o = commit->util, l = NULL; o; l = o, o = o->next) { 483if(!strcmp(o->path, path)) { 484/* bump to front */ 485if(l) { 486 l->next = o->next; 487 o->next = commit->util; 488 commit->util = o; 489} 490returnorigin_incref(o); 491} 492} 493returnmake_origin(commit, path); 494} 495 496/* 497 * Fill the blob_sha1 field of an origin if it hasn't, so that later 498 * call to fill_origin_blob() can use it to locate the data. blob_sha1 499 * for an origin is also used to pass the blame for the entire file to 500 * the parent to detect the case where a child's blob is identical to 501 * that of its parent's. 502 * 503 * This also fills origin->mode for corresponding tree path. 504 */ 505static intfill_blob_sha1_and_mode(struct origin *origin) 506{ 507if(!is_null_sha1(origin->blob_sha1)) 508return0; 509if(get_tree_entry(origin->commit->object.sha1, 510 origin->path, 511 origin->blob_sha1, &origin->mode)) 512goto error_out; 513if(sha1_object_info(origin->blob_sha1, NULL) != OBJ_BLOB) 514goto error_out; 515return0; 516 error_out: 517hashclr(origin->blob_sha1); 518 origin->mode = S_IFINVALID; 519return-1; 520} 521 522/* 523 * We have an origin -- check if the same path exists in the 524 * parent and return an origin structure to represent it. 525 */ 526static struct origin *find_origin(struct scoreboard *sb, 527struct commit *parent, 528struct origin *origin) 529{ 530struct origin *porigin; 531struct diff_options diff_opts; 532const char*paths[2]; 533 534/* First check any existing origins */ 535for(porigin = parent->util; porigin; porigin = porigin->next) 536if(!strcmp(porigin->path, origin->path)) { 537/* 538 * The same path between origin and its parent 539 * without renaming -- the most common case. 540 */ 541returnorigin_incref(porigin); 542} 543 544/* See if the origin->path is different between parent 545 * and origin first. Most of the time they are the 546 * same and diff-tree is fairly efficient about this. 547 */ 548diff_setup(&diff_opts); 549DIFF_OPT_SET(&diff_opts, RECURSIVE); 550 diff_opts.detect_rename =0; 551 diff_opts.output_format = DIFF_FORMAT_NO_OUTPUT; 552 paths[0] = origin->path; 553 paths[1] = NULL; 554 555parse_pathspec(&diff_opts.pathspec, 556 PATHSPEC_ALL_MAGIC & ~PATHSPEC_LITERAL, 557 PATHSPEC_LITERAL_PATH,"", paths); 558diff_setup_done(&diff_opts); 559 560if(is_null_sha1(origin->commit->object.sha1)) 561do_diff_cache(parent->tree->object.sha1, &diff_opts); 562else 563diff_tree_sha1(parent->tree->object.sha1, 564 origin->commit->tree->object.sha1, 565"", &diff_opts); 566diffcore_std(&diff_opts); 567 568if(!diff_queued_diff.nr) { 569/* The path is the same as parent */ 570 porigin =get_origin(sb, parent, origin->path); 571hashcpy(porigin->blob_sha1, origin->blob_sha1); 572 porigin->mode = origin->mode; 573}else{ 574/* 575 * Since origin->path is a pathspec, if the parent 576 * commit had it as a directory, we will see a whole 577 * bunch of deletion of files in the directory that we 578 * do not care about. 579 */ 580int i; 581struct diff_filepair *p = NULL; 582for(i =0; i < diff_queued_diff.nr; i++) { 583const char*name; 584 p = diff_queued_diff.queue[i]; 585 name = p->one->path ? p->one->path : p->two->path; 586if(!strcmp(name, origin->path)) 587break; 588} 589if(!p) 590die("internal error in blame::find_origin"); 591switch(p->status) { 592default: 593die("internal error in blame::find_origin (%c)", 594 p->status); 595case'M': 596 porigin =get_origin(sb, parent, origin->path); 597hashcpy(porigin->blob_sha1, p->one->sha1); 598 porigin->mode = p->one->mode; 599break; 600case'A': 601case'T': 602/* Did not exist in parent, or type changed */ 603break; 604} 605} 606diff_flush(&diff_opts); 607free_pathspec(&diff_opts.pathspec); 608return porigin; 609} 610 611/* 612 * We have an origin -- find the path that corresponds to it in its 613 * parent and return an origin structure to represent it. 614 */ 615static struct origin *find_rename(struct scoreboard *sb, 616struct commit *parent, 617struct origin *origin) 618{ 619struct origin *porigin = NULL; 620struct diff_options diff_opts; 621int i; 622 623diff_setup(&diff_opts); 624DIFF_OPT_SET(&diff_opts, RECURSIVE); 625 diff_opts.detect_rename = DIFF_DETECT_RENAME; 626 diff_opts.output_format = DIFF_FORMAT_NO_OUTPUT; 627 diff_opts.single_follow = origin->path; 628diff_setup_done(&diff_opts); 629 630if(is_null_sha1(origin->commit->object.sha1)) 631do_diff_cache(parent->tree->object.sha1, &diff_opts); 632else 633diff_tree_sha1(parent->tree->object.sha1, 634 origin->commit->tree->object.sha1, 635"", &diff_opts); 636diffcore_std(&diff_opts); 637 638for(i =0; i < diff_queued_diff.nr; i++) { 639struct diff_filepair *p = diff_queued_diff.queue[i]; 640if((p->status =='R'|| p->status =='C') && 641!strcmp(p->two->path, origin->path)) { 642 porigin =get_origin(sb, parent, p->one->path); 643hashcpy(porigin->blob_sha1, p->one->sha1); 644 porigin->mode = p->one->mode; 645break; 646} 647} 648diff_flush(&diff_opts); 649free_pathspec(&diff_opts.pathspec); 650return porigin; 651} 652 653/* 654 * Append a new blame entry to a given output queue. 655 */ 656static voidadd_blame_entry(struct blame_entry ***queue,struct blame_entry *e) 657{ 658origin_incref(e->suspect); 659 660 e->next = **queue; 661**queue = e; 662*queue = &e->next; 663} 664 665/* 666 * src typically is on-stack; we want to copy the information in it to 667 * a malloced blame_entry that gets added to the given queue. The 668 * origin of dst loses a refcnt. 669 */ 670static voiddup_entry(struct blame_entry ***queue, 671struct blame_entry *dst,struct blame_entry *src) 672{ 673origin_incref(src->suspect); 674origin_decref(dst->suspect); 675memcpy(dst, src,sizeof(*src)); 676 dst->next = **queue; 677**queue = dst; 678*queue = &dst->next; 679} 680 681static const char*nth_line(struct scoreboard *sb,long lno) 682{ 683return sb->final_buf + sb->lineno[lno]; 684} 685 686static const char*nth_line_cb(void*data,long lno) 687{ 688returnnth_line((struct scoreboard *)data, lno); 689} 690 691/* 692 * It is known that lines between tlno to same came from parent, and e 693 * has an overlap with that range. it also is known that parent's 694 * line plno corresponds to e's line tlno. 695 * 696 * <---- e -----> 697 * <------> 698 * <------------> 699 * <------------> 700 * <------------------> 701 * 702 * Split e into potentially three parts; before this chunk, the chunk 703 * to be blamed for the parent, and after that portion. 704 */ 705static voidsplit_overlap(struct blame_entry *split, 706struct blame_entry *e, 707int tlno,int plno,int same, 708struct origin *parent) 709{ 710int chunk_end_lno; 711memset(split,0,sizeof(struct blame_entry [3])); 712 713if(e->s_lno < tlno) { 714/* there is a pre-chunk part not blamed on parent */ 715 split[0].suspect =origin_incref(e->suspect); 716 split[0].lno = e->lno; 717 split[0].s_lno = e->s_lno; 718 split[0].num_lines = tlno - e->s_lno; 719 split[1].lno = e->lno + tlno - e->s_lno; 720 split[1].s_lno = plno; 721} 722else{ 723 split[1].lno = e->lno; 724 split[1].s_lno = plno + (e->s_lno - tlno); 725} 726 727if(same < e->s_lno + e->num_lines) { 728/* there is a post-chunk part not blamed on parent */ 729 split[2].suspect =origin_incref(e->suspect); 730 split[2].lno = e->lno + (same - e->s_lno); 731 split[2].s_lno = e->s_lno + (same - e->s_lno); 732 split[2].num_lines = e->s_lno + e->num_lines - same; 733 chunk_end_lno = split[2].lno; 734} 735else 736 chunk_end_lno = e->lno + e->num_lines; 737 split[1].num_lines = chunk_end_lno - split[1].lno; 738 739/* 740 * if it turns out there is nothing to blame the parent for, 741 * forget about the splitting. !split[1].suspect signals this. 742 */ 743if(split[1].num_lines <1) 744return; 745 split[1].suspect =origin_incref(parent); 746} 747 748/* 749 * split_overlap() divided an existing blame e into up to three parts 750 * in split. Any assigned blame is moved to queue to 751 * reflect the split. 752 */ 753static voidsplit_blame(struct blame_entry ***blamed, 754struct blame_entry ***unblamed, 755struct blame_entry *split, 756struct blame_entry *e) 757{ 758struct blame_entry *new_entry; 759 760if(split[0].suspect && split[2].suspect) { 761/* The first part (reuse storage for the existing entry e) */ 762dup_entry(unblamed, e, &split[0]); 763 764/* The last part -- me */ 765 new_entry =xmalloc(sizeof(*new_entry)); 766memcpy(new_entry, &(split[2]),sizeof(struct blame_entry)); 767add_blame_entry(unblamed, new_entry); 768 769/* ... and the middle part -- parent */ 770 new_entry =xmalloc(sizeof(*new_entry)); 771memcpy(new_entry, &(split[1]),sizeof(struct blame_entry)); 772add_blame_entry(blamed, new_entry); 773} 774else if(!split[0].suspect && !split[2].suspect) 775/* 776 * The parent covers the entire area; reuse storage for 777 * e and replace it with the parent. 778 */ 779dup_entry(blamed, e, &split[1]); 780else if(split[0].suspect) { 781/* me and then parent */ 782dup_entry(unblamed, e, &split[0]); 783 784 new_entry =xmalloc(sizeof(*new_entry)); 785memcpy(new_entry, &(split[1]),sizeof(struct blame_entry)); 786add_blame_entry(blamed, new_entry); 787} 788else{ 789/* parent and then me */ 790dup_entry(blamed, e, &split[1]); 791 792 new_entry =xmalloc(sizeof(*new_entry)); 793memcpy(new_entry, &(split[2]),sizeof(struct blame_entry)); 794add_blame_entry(unblamed, new_entry); 795} 796} 797 798/* 799 * After splitting the blame, the origins used by the 800 * on-stack blame_entry should lose one refcnt each. 801 */ 802static voiddecref_split(struct blame_entry *split) 803{ 804int i; 805 806for(i =0; i <3; i++) 807origin_decref(split[i].suspect); 808} 809 810/* 811 * reverse_blame reverses the list given in head, appending tail. 812 * That allows us to build lists in reverse order, then reverse them 813 * afterwards. This can be faster than building the list in proper 814 * order right away. The reason is that building in proper order 815 * requires writing a link in the _previous_ element, while building 816 * in reverse order just requires placing the list head into the 817 * _current_ element. 818 */ 819 820static struct blame_entry *reverse_blame(struct blame_entry *head, 821struct blame_entry *tail) 822{ 823while(head) { 824struct blame_entry *next = head->next; 825 head->next = tail; 826 tail = head; 827 head = next; 828} 829return tail; 830} 831 832/* 833 * Process one hunk from the patch between the current suspect for 834 * blame_entry e and its parent. This first blames any unfinished 835 * entries before the chunk (which is where target and parent start 836 * differing) on the parent, and then splits blame entries at the 837 * start and at the end of the difference region. Since use of -M and 838 * -C options may lead to overlapping/duplicate source line number 839 * ranges, all we can rely on from sorting/merging is the order of the 840 * first suspect line number. 841 */ 842static voidblame_chunk(struct blame_entry ***dstq,struct blame_entry ***srcq, 843int tlno,int offset,int same, 844struct origin *parent) 845{ 846struct blame_entry *e = **srcq; 847struct blame_entry *samep = NULL, *diffp = NULL; 848 849while(e && e->s_lno < tlno) { 850struct blame_entry *next = e->next; 851/* 852 * current record starts before differing portion. If 853 * it reaches into it, we need to split it up and 854 * examine the second part separately. 855 */ 856if(e->s_lno + e->num_lines > tlno) { 857/* Move second half to a new record */ 858int len = tlno - e->s_lno; 859struct blame_entry *n =xcalloc(1,sizeof(struct blame_entry)); 860 n->suspect = e->suspect; 861 n->lno = e->lno + len; 862 n->s_lno = e->s_lno + len; 863 n->num_lines = e->num_lines - len; 864 e->num_lines = len; 865 e->score =0; 866/* Push new record to diffp */ 867 n->next = diffp; 868 diffp = n; 869}else 870origin_decref(e->suspect); 871/* Pass blame for everything before the differing 872 * chunk to the parent */ 873 e->suspect =origin_incref(parent); 874 e->s_lno += offset; 875 e->next = samep; 876 samep = e; 877 e = next; 878} 879/* 880 * As we don't know how much of a common stretch after this 881 * diff will occur, the currently blamed parts are all that we 882 * can assign to the parent for now. 883 */ 884 885if(samep) { 886**dstq =reverse_blame(samep, **dstq); 887*dstq = &samep->next; 888} 889/* 890 * Prepend the split off portions: everything after e starts 891 * after the blameable portion. 892 */ 893 e =reverse_blame(diffp, e); 894 895/* 896 * Now retain records on the target while parts are different 897 * from the parent. 898 */ 899 samep = NULL; 900 diffp = NULL; 901while(e && e->s_lno < same) { 902struct blame_entry *next = e->next; 903 904/* 905 * If current record extends into sameness, need to split. 906 */ 907if(e->s_lno + e->num_lines > same) { 908/* 909 * Move second half to a new record to be 910 * processed by later chunks 911 */ 912int len = same - e->s_lno; 913struct blame_entry *n =xcalloc(1,sizeof(struct blame_entry)); 914 n->suspect =origin_incref(e->suspect); 915 n->lno = e->lno + len; 916 n->s_lno = e->s_lno + len; 917 n->num_lines = e->num_lines - len; 918 e->num_lines = len; 919 e->score =0; 920/* Push new record to samep */ 921 n->next = samep; 922 samep = n; 923} 924 e->next = diffp; 925 diffp = e; 926 e = next; 927} 928**srcq =reverse_blame(diffp,reverse_blame(samep, e)); 929/* Move across elements that are in the unblamable portion */ 930if(diffp) 931*srcq = &diffp->next; 932} 933 934struct blame_chunk_cb_data { 935struct origin *parent; 936long offset; 937struct blame_entry **dstq; 938struct blame_entry **srcq; 939}; 940 941/* diff chunks are from parent to target */ 942static intblame_chunk_cb(long start_a,long count_a, 943long start_b,long count_b,void*data) 944{ 945struct blame_chunk_cb_data *d = data; 946if(start_a - start_b != d->offset) 947die("internal error in blame::blame_chunk_cb"); 948blame_chunk(&d->dstq, &d->srcq, start_b, start_a - start_b, 949 start_b + count_b, d->parent); 950 d->offset = start_a + count_a - (start_b + count_b); 951return0; 952} 953 954/* 955 * We are looking at the origin 'target' and aiming to pass blame 956 * for the lines it is suspected to its parent. Run diff to find 957 * which lines came from parent and pass blame for them. 958 */ 959static voidpass_blame_to_parent(struct scoreboard *sb, 960struct origin *target, 961struct origin *parent) 962{ 963 mmfile_t file_p, file_o; 964struct blame_chunk_cb_data d; 965struct blame_entry *newdest = NULL; 966 967if(!target->suspects) 968return;/* nothing remains for this target */ 969 970 d.parent = parent; 971 d.offset =0; 972 d.dstq = &newdest; d.srcq = &target->suspects; 973 974fill_origin_blob(&sb->revs->diffopt, parent, &file_p); 975fill_origin_blob(&sb->revs->diffopt, target, &file_o); 976 num_get_patch++; 977 978diff_hunks(&file_p, &file_o,0, blame_chunk_cb, &d); 979/* The rest are the same as the parent */ 980blame_chunk(&d.dstq, &d.srcq, INT_MAX, d.offset, INT_MAX, parent); 981*d.dstq = NULL; 982queue_blames(sb, parent, newdest); 983 984return; 985} 986 987/* 988 * The lines in blame_entry after splitting blames many times can become 989 * very small and trivial, and at some point it becomes pointless to 990 * blame the parents. E.g. "\t\t}\n\t}\n\n" appears everywhere in any 991 * ordinary C program, and it is not worth to say it was copied from 992 * totally unrelated file in the parent. 993 * 994 * Compute how trivial the lines in the blame_entry are. 995 */ 996static unsignedent_score(struct scoreboard *sb,struct blame_entry *e) 997{ 998unsigned score; 999const char*cp, *ep;10001001if(e->score)1002return e->score;10031004 score =1;1005 cp =nth_line(sb, e->lno);1006 ep =nth_line(sb, e->lno + e->num_lines);1007while(cp < ep) {1008unsigned ch = *((unsigned char*)cp);1009if(isalnum(ch))1010 score++;1011 cp++;1012}1013 e->score = score;1014return score;1015}10161017/*1018 * best_so_far[] and this[] are both a split of an existing blame_entry1019 * that passes blame to the parent. Maintain best_so_far the best split1020 * so far, by comparing this and best_so_far and copying this into1021 * bst_so_far as needed.1022 */1023static voidcopy_split_if_better(struct scoreboard *sb,1024struct blame_entry *best_so_far,1025struct blame_entry *this)1026{1027int i;10281029if(!this[1].suspect)1030return;1031if(best_so_far[1].suspect) {1032if(ent_score(sb, &this[1]) <ent_score(sb, &best_so_far[1]))1033return;1034}10351036for(i =0; i <3; i++)1037origin_incref(this[i].suspect);1038decref_split(best_so_far);1039memcpy(best_so_far,this,sizeof(struct blame_entry [3]));1040}10411042/*1043 * We are looking at a part of the final image represented by1044 * ent (tlno and same are offset by ent->s_lno).1045 * tlno is where we are looking at in the final image.1046 * up to (but not including) same match preimage.1047 * plno is where we are looking at in the preimage.1048 *1049 * <-------------- final image ---------------------->1050 * <------ent------>1051 * ^tlno ^same1052 * <---------preimage----->1053 * ^plno1054 *1055 * All line numbers are 0-based.1056 */1057static voidhandle_split(struct scoreboard *sb,1058struct blame_entry *ent,1059int tlno,int plno,int same,1060struct origin *parent,1061struct blame_entry *split)1062{1063if(ent->num_lines <= tlno)1064return;1065if(tlno < same) {1066struct blame_entry this[3];1067 tlno += ent->s_lno;1068 same += ent->s_lno;1069split_overlap(this, ent, tlno, plno, same, parent);1070copy_split_if_better(sb, split,this);1071decref_split(this);1072}1073}10741075struct handle_split_cb_data {1076struct scoreboard *sb;1077struct blame_entry *ent;1078struct origin *parent;1079struct blame_entry *split;1080long plno;1081long tlno;1082};10831084static inthandle_split_cb(long start_a,long count_a,1085long start_b,long count_b,void*data)1086{1087struct handle_split_cb_data *d = data;1088handle_split(d->sb, d->ent, d->tlno, d->plno, start_b, d->parent,1089 d->split);1090 d->plno = start_a + count_a;1091 d->tlno = start_b + count_b;1092return0;1093}10941095/*1096 * Find the lines from parent that are the same as ent so that1097 * we can pass blames to it. file_p has the blob contents for1098 * the parent.1099 */1100static voidfind_copy_in_blob(struct scoreboard *sb,1101struct blame_entry *ent,1102struct origin *parent,1103struct blame_entry *split,1104 mmfile_t *file_p)1105{1106const char*cp;1107 mmfile_t file_o;1108struct handle_split_cb_data d;11091110memset(&d,0,sizeof(d));1111 d.sb = sb; d.ent = ent; d.parent = parent; d.split = split;1112/*1113 * Prepare mmfile that contains only the lines in ent.1114 */1115 cp =nth_line(sb, ent->lno);1116 file_o.ptr = (char*) cp;1117 file_o.size =nth_line(sb, ent->lno + ent->num_lines) - cp;11181119/*1120 * file_o is a part of final image we are annotating.1121 * file_p partially may match that image.1122 */1123memset(split,0,sizeof(struct blame_entry [3]));1124diff_hunks(file_p, &file_o,1, handle_split_cb, &d);1125/* remainder, if any, all match the preimage */1126handle_split(sb, ent, d.tlno, d.plno, ent->num_lines, parent, split);1127}11281129/* Move all blame entries from list *source that have a score smaller1130 * than score_min to the front of list *small.1131 * Returns a pointer to the link pointing to the old head of the small list.1132 */11331134static struct blame_entry **filter_small(struct scoreboard *sb,1135struct blame_entry **small,1136struct blame_entry **source,1137unsigned score_min)1138{1139struct blame_entry *p = *source;1140struct blame_entry *oldsmall = *small;1141while(p) {1142if(ent_score(sb, p) <= score_min) {1143*small = p;1144 small = &p->next;1145 p = *small;1146}else{1147*source = p;1148 source = &p->next;1149 p = *source;1150}1151}1152*small = oldsmall;1153*source = NULL;1154return small;1155}11561157/*1158 * See if lines currently target is suspected for can be attributed to1159 * parent.1160 */1161static voidfind_move_in_parent(struct scoreboard *sb,1162struct blame_entry ***blamed,1163struct blame_entry **toosmall,1164struct origin *target,1165struct origin *parent)1166{1167struct blame_entry *e, split[3];1168struct blame_entry *unblamed = target->suspects;1169struct blame_entry *leftover = NULL;1170 mmfile_t file_p;11711172if(!unblamed)1173return;/* nothing remains for this target */11741175fill_origin_blob(&sb->revs->diffopt, parent, &file_p);1176if(!file_p.ptr)1177return;11781179/* At each iteration, unblamed has a NULL-terminated list of1180 * entries that have not yet been tested for blame. leftover1181 * contains the reversed list of entries that have been tested1182 * without being assignable to the parent.1183 */1184do{1185struct blame_entry **unblamedtail = &unblamed;1186struct blame_entry *next;1187for(e = unblamed; e; e = next) {1188 next = e->next;1189find_copy_in_blob(sb, e, parent, split, &file_p);1190if(split[1].suspect &&1191 blame_move_score <ent_score(sb, &split[1])) {1192split_blame(blamed, &unblamedtail, split, e);1193}else{1194 e->next = leftover;1195 leftover = e;1196}1197decref_split(split);1198}1199*unblamedtail = NULL;1200 toosmall =filter_small(sb, toosmall, &unblamed, blame_move_score);1201}while(unblamed);1202 target->suspects =reverse_blame(leftover, NULL);1203}12041205struct blame_list {1206struct blame_entry *ent;1207struct blame_entry split[3];1208};12091210/*1211 * Count the number of entries the target is suspected for,1212 * and prepare a list of entry and the best split.1213 */1214static struct blame_list *setup_blame_list(struct blame_entry *unblamed,1215int*num_ents_p)1216{1217struct blame_entry *e;1218int num_ents, i;1219struct blame_list *blame_list = NULL;12201221for(e = unblamed, num_ents =0; e; e = e->next)1222 num_ents++;1223if(num_ents) {1224 blame_list =xcalloc(num_ents,sizeof(struct blame_list));1225for(e = unblamed, i =0; e; e = e->next)1226 blame_list[i++].ent = e;1227}1228*num_ents_p = num_ents;1229return blame_list;1230}12311232/*1233 * For lines target is suspected for, see if we can find code movement1234 * across file boundary from the parent commit. porigin is the path1235 * in the parent we already tried.1236 */1237static voidfind_copy_in_parent(struct scoreboard *sb,1238struct blame_entry ***blamed,1239struct blame_entry **toosmall,1240struct origin *target,1241struct commit *parent,1242struct origin *porigin,1243int opt)1244{1245struct diff_options diff_opts;1246int i, j;1247struct blame_list *blame_list;1248int num_ents;1249struct blame_entry *unblamed = target->suspects;1250struct blame_entry *leftover = NULL;12511252if(!unblamed)1253return;/* nothing remains for this target */12541255diff_setup(&diff_opts);1256DIFF_OPT_SET(&diff_opts, RECURSIVE);1257 diff_opts.output_format = DIFF_FORMAT_NO_OUTPUT;12581259diff_setup_done(&diff_opts);12601261/* Try "find copies harder" on new path if requested;1262 * we do not want to use diffcore_rename() actually to1263 * match things up; find_copies_harder is set only to1264 * force diff_tree_sha1() to feed all filepairs to diff_queue,1265 * and this code needs to be after diff_setup_done(), which1266 * usually makes find-copies-harder imply copy detection.1267 */1268if((opt & PICKAXE_BLAME_COPY_HARDEST)1269|| ((opt & PICKAXE_BLAME_COPY_HARDER)1270&& (!porigin ||strcmp(target->path, porigin->path))))1271DIFF_OPT_SET(&diff_opts, FIND_COPIES_HARDER);12721273if(is_null_sha1(target->commit->object.sha1))1274do_diff_cache(parent->tree->object.sha1, &diff_opts);1275else1276diff_tree_sha1(parent->tree->object.sha1,1277 target->commit->tree->object.sha1,1278"", &diff_opts);12791280if(!DIFF_OPT_TST(&diff_opts, FIND_COPIES_HARDER))1281diffcore_std(&diff_opts);12821283do{1284struct blame_entry **unblamedtail = &unblamed;1285 blame_list =setup_blame_list(unblamed, &num_ents);12861287for(i =0; i < diff_queued_diff.nr; i++) {1288struct diff_filepair *p = diff_queued_diff.queue[i];1289struct origin *norigin;1290 mmfile_t file_p;1291struct blame_entry this[3];12921293if(!DIFF_FILE_VALID(p->one))1294continue;/* does not exist in parent */1295if(S_ISGITLINK(p->one->mode))1296continue;/* ignore git links */1297if(porigin && !strcmp(p->one->path, porigin->path))1298/* find_move already dealt with this path */1299continue;13001301 norigin =get_origin(sb, parent, p->one->path);1302hashcpy(norigin->blob_sha1, p->one->sha1);1303 norigin->mode = p->one->mode;1304fill_origin_blob(&sb->revs->diffopt, norigin, &file_p);1305if(!file_p.ptr)1306continue;13071308for(j =0; j < num_ents; j++) {1309find_copy_in_blob(sb, blame_list[j].ent,1310 norigin,this, &file_p);1311copy_split_if_better(sb, blame_list[j].split,1312this);1313decref_split(this);1314}1315origin_decref(norigin);1316}13171318for(j =0; j < num_ents; j++) {1319struct blame_entry *split = blame_list[j].split;1320if(split[1].suspect &&1321 blame_copy_score <ent_score(sb, &split[1])) {1322split_blame(blamed, &unblamedtail, split,1323 blame_list[j].ent);1324}else{1325 blame_list[j].ent->next = leftover;1326 leftover = blame_list[j].ent;1327}1328decref_split(split);1329}1330free(blame_list);1331*unblamedtail = NULL;1332 toosmall =filter_small(sb, toosmall, &unblamed, blame_copy_score);1333}while(unblamed);1334 target->suspects =reverse_blame(leftover, NULL);1335diff_flush(&diff_opts);1336free_pathspec(&diff_opts.pathspec);1337}13381339/*1340 * The blobs of origin and porigin exactly match, so everything1341 * origin is suspected for can be blamed on the parent.1342 */1343static voidpass_whole_blame(struct scoreboard *sb,1344struct origin *origin,struct origin *porigin)1345{1346struct blame_entry *e, *suspects;13471348if(!porigin->file.ptr && origin->file.ptr) {1349/* Steal its file */1350 porigin->file = origin->file;1351 origin->file.ptr = NULL;1352}1353 suspects = origin->suspects;1354 origin->suspects = NULL;1355for(e = suspects; e; e = e->next) {1356origin_incref(porigin);1357origin_decref(e->suspect);1358 e->suspect = porigin;1359}1360queue_blames(sb, porigin, suspects);1361}13621363/*1364 * We pass blame from the current commit to its parents. We keep saying1365 * "parent" (and "porigin"), but what we mean is to find scapegoat to1366 * exonerate ourselves.1367 */1368static struct commit_list *first_scapegoat(struct rev_info *revs,struct commit *commit)1369{1370if(!reverse)1371return commit->parents;1372returnlookup_decoration(&revs->children, &commit->object);1373}13741375static intnum_scapegoats(struct rev_info *revs,struct commit *commit)1376{1377struct commit_list *l =first_scapegoat(revs, commit);1378returncommit_list_count(l);1379}13801381/* Distribute collected unsorted blames to the respected sorted lists1382 * in the various origins.1383 */1384static voiddistribute_blame(struct scoreboard *sb,struct blame_entry *blamed)1385{1386 blamed =blame_sort(blamed, compare_blame_suspect);1387while(blamed)1388{1389struct origin *porigin = blamed->suspect;1390struct blame_entry *suspects = NULL;1391do{1392struct blame_entry *next = blamed->next;1393 blamed->next = suspects;1394 suspects = blamed;1395 blamed = next;1396}while(blamed && blamed->suspect == porigin);1397 suspects =reverse_blame(suspects, NULL);1398queue_blames(sb, porigin, suspects);1399}1400}14011402#define MAXSG 1614031404static voidpass_blame(struct scoreboard *sb,struct origin *origin,int opt)1405{1406struct rev_info *revs = sb->revs;1407int i, pass, num_sg;1408struct commit *commit = origin->commit;1409struct commit_list *sg;1410struct origin *sg_buf[MAXSG];1411struct origin *porigin, **sg_origin = sg_buf;1412struct blame_entry *toosmall = NULL;1413struct blame_entry *blames, **blametail = &blames;14141415 num_sg =num_scapegoats(revs, commit);1416if(!num_sg)1417goto finish;1418else if(num_sg <ARRAY_SIZE(sg_buf))1419memset(sg_buf,0,sizeof(sg_buf));1420else1421 sg_origin =xcalloc(num_sg,sizeof(*sg_origin));14221423/*1424 * The first pass looks for unrenamed path to optimize for1425 * common cases, then we look for renames in the second pass.1426 */1427for(pass =0; pass <2- no_whole_file_rename; pass++) {1428struct origin *(*find)(struct scoreboard *,1429struct commit *,struct origin *);1430 find = pass ? find_rename : find_origin;14311432for(i =0, sg =first_scapegoat(revs, commit);1433 i < num_sg && sg;1434 sg = sg->next, i++) {1435struct commit *p = sg->item;1436int j, same;14371438if(sg_origin[i])1439continue;1440if(parse_commit(p))1441continue;1442 porigin =find(sb, p, origin);1443if(!porigin)1444continue;1445if(!hashcmp(porigin->blob_sha1, origin->blob_sha1)) {1446pass_whole_blame(sb, origin, porigin);1447origin_decref(porigin);1448goto finish;1449}1450for(j = same =0; j < i; j++)1451if(sg_origin[j] &&1452!hashcmp(sg_origin[j]->blob_sha1,1453 porigin->blob_sha1)) {1454 same =1;1455break;1456}1457if(!same)1458 sg_origin[i] = porigin;1459else1460origin_decref(porigin);1461}1462}14631464 num_commits++;1465for(i =0, sg =first_scapegoat(revs, commit);1466 i < num_sg && sg;1467 sg = sg->next, i++) {1468struct origin *porigin = sg_origin[i];1469if(!porigin)1470continue;1471if(!origin->previous) {1472origin_incref(porigin);1473 origin->previous = porigin;1474}1475pass_blame_to_parent(sb, origin, porigin);1476if(!origin->suspects)1477goto finish;1478}14791480/*1481 * Optionally find moves in parents' files.1482 */1483if(opt & PICKAXE_BLAME_MOVE) {1484filter_small(sb, &toosmall, &origin->suspects, blame_move_score);1485if(origin->suspects) {1486for(i =0, sg =first_scapegoat(revs, commit);1487 i < num_sg && sg;1488 sg = sg->next, i++) {1489struct origin *porigin = sg_origin[i];1490if(!porigin)1491continue;1492find_move_in_parent(sb, &blametail, &toosmall, origin, porigin);1493if(!origin->suspects)1494break;1495}1496}1497}14981499/*1500 * Optionally find copies from parents' files.1501 */1502if(opt & PICKAXE_BLAME_COPY) {1503if(blame_copy_score > blame_move_score)1504filter_small(sb, &toosmall, &origin->suspects, blame_copy_score);1505else if(blame_copy_score < blame_move_score) {1506 origin->suspects =blame_merge(origin->suspects, toosmall);1507 toosmall = NULL;1508filter_small(sb, &toosmall, &origin->suspects, blame_copy_score);1509}1510if(!origin->suspects)1511goto finish;15121513for(i =0, sg =first_scapegoat(revs, commit);1514 i < num_sg && sg;1515 sg = sg->next, i++) {1516struct origin *porigin = sg_origin[i];1517find_copy_in_parent(sb, &blametail, &toosmall,1518 origin, sg->item, porigin, opt);1519if(!origin->suspects)1520goto finish;1521}1522}15231524finish:1525*blametail = NULL;1526distribute_blame(sb, blames);1527/*1528 * prepend toosmall to origin->suspects1529 *1530 * There is no point in sorting: this ends up on a big1531 * unsorted list in the caller anyway.1532 */1533if(toosmall) {1534struct blame_entry **tail = &toosmall;1535while(*tail)1536 tail = &(*tail)->next;1537*tail = origin->suspects;1538 origin->suspects = toosmall;1539}1540for(i =0; i < num_sg; i++) {1541if(sg_origin[i]) {1542drop_origin_blob(sg_origin[i]);1543origin_decref(sg_origin[i]);1544}1545}1546drop_origin_blob(origin);1547if(sg_buf != sg_origin)1548free(sg_origin);1549}15501551/*1552 * Information on commits, used for output.1553 */1554struct commit_info {1555struct strbuf author;1556struct strbuf author_mail;1557unsigned long author_time;1558struct strbuf author_tz;15591560/* filled only when asked for details */1561struct strbuf committer;1562struct strbuf committer_mail;1563unsigned long committer_time;1564struct strbuf committer_tz;15651566struct strbuf summary;1567};15681569/*1570 * Parse author/committer line in the commit object buffer1571 */1572static voidget_ac_line(const char*inbuf,const char*what,1573struct strbuf *name,struct strbuf *mail,1574unsigned long*time,struct strbuf *tz)1575{1576struct ident_split ident;1577size_t len, maillen, namelen;1578char*tmp, *endp;1579const char*namebuf, *mailbuf;15801581 tmp =strstr(inbuf, what);1582if(!tmp)1583goto error_out;1584 tmp +=strlen(what);1585 endp =strchr(tmp,'\n');1586if(!endp)1587 len =strlen(tmp);1588else1589 len = endp - tmp;15901591if(split_ident_line(&ident, tmp, len)) {1592 error_out:1593/* Ugh */1594 tmp ="(unknown)";1595strbuf_addstr(name, tmp);1596strbuf_addstr(mail, tmp);1597strbuf_addstr(tz, tmp);1598*time =0;1599return;1600}16011602 namelen = ident.name_end - ident.name_begin;1603 namebuf = ident.name_begin;16041605 maillen = ident.mail_end - ident.mail_begin;1606 mailbuf = ident.mail_begin;16071608if(ident.date_begin && ident.date_end)1609*time =strtoul(ident.date_begin, NULL,10);1610else1611*time =0;16121613if(ident.tz_begin && ident.tz_end)1614strbuf_add(tz, ident.tz_begin, ident.tz_end - ident.tz_begin);1615else1616strbuf_addstr(tz,"(unknown)");16171618/*1619 * Now, convert both name and e-mail using mailmap1620 */1621map_user(&mailmap, &mailbuf, &maillen,1622&namebuf, &namelen);16231624strbuf_addf(mail,"<%.*s>", (int)maillen, mailbuf);1625strbuf_add(name, namebuf, namelen);1626}16271628static voidcommit_info_init(struct commit_info *ci)1629{16301631strbuf_init(&ci->author,0);1632strbuf_init(&ci->author_mail,0);1633strbuf_init(&ci->author_tz,0);1634strbuf_init(&ci->committer,0);1635strbuf_init(&ci->committer_mail,0);1636strbuf_init(&ci->committer_tz,0);1637strbuf_init(&ci->summary,0);1638}16391640static voidcommit_info_destroy(struct commit_info *ci)1641{16421643strbuf_release(&ci->author);1644strbuf_release(&ci->author_mail);1645strbuf_release(&ci->author_tz);1646strbuf_release(&ci->committer);1647strbuf_release(&ci->committer_mail);1648strbuf_release(&ci->committer_tz);1649strbuf_release(&ci->summary);1650}16511652static voidget_commit_info(struct commit *commit,1653struct commit_info *ret,1654int detailed)1655{1656int len;1657const char*subject, *encoding;1658const char*message;16591660commit_info_init(ret);16611662 encoding =get_log_output_encoding();1663 message =logmsg_reencode(commit, NULL, encoding);1664get_ac_line(message,"\nauthor ",1665&ret->author, &ret->author_mail,1666&ret->author_time, &ret->author_tz);16671668if(!detailed) {1669unuse_commit_buffer(commit, message);1670return;1671}16721673get_ac_line(message,"\ncommitter ",1674&ret->committer, &ret->committer_mail,1675&ret->committer_time, &ret->committer_tz);16761677 len =find_commit_subject(message, &subject);1678if(len)1679strbuf_add(&ret->summary, subject, len);1680else1681strbuf_addf(&ret->summary,"(%s)",sha1_to_hex(commit->object.sha1));16821683unuse_commit_buffer(commit, message);1684}16851686/*1687 * To allow LF and other nonportable characters in pathnames,1688 * they are c-style quoted as needed.1689 */1690static voidwrite_filename_info(const char*path)1691{1692printf("filename ");1693write_name_quoted(path, stdout,'\n');1694}16951696/*1697 * Porcelain/Incremental format wants to show a lot of details per1698 * commit. Instead of repeating this every line, emit it only once,1699 * the first time each commit appears in the output (unless the1700 * user has specifically asked for us to repeat).1701 */1702static intemit_one_suspect_detail(struct origin *suspect,int repeat)1703{1704struct commit_info ci;17051706if(!repeat && (suspect->commit->object.flags & METAINFO_SHOWN))1707return0;17081709 suspect->commit->object.flags |= METAINFO_SHOWN;1710get_commit_info(suspect->commit, &ci,1);1711printf("author%s\n", ci.author.buf);1712printf("author-mail%s\n", ci.author_mail.buf);1713printf("author-time%lu\n", ci.author_time);1714printf("author-tz%s\n", ci.author_tz.buf);1715printf("committer%s\n", ci.committer.buf);1716printf("committer-mail%s\n", ci.committer_mail.buf);1717printf("committer-time%lu\n", ci.committer_time);1718printf("committer-tz%s\n", ci.committer_tz.buf);1719printf("summary%s\n", ci.summary.buf);1720if(suspect->commit->object.flags & UNINTERESTING)1721printf("boundary\n");1722if(suspect->previous) {1723struct origin *prev = suspect->previous;1724printf("previous%s",sha1_to_hex(prev->commit->object.sha1));1725write_name_quoted(prev->path, stdout,'\n');1726}17271728commit_info_destroy(&ci);17291730return1;1731}17321733/*1734 * The blame_entry is found to be guilty for the range.1735 * Show it in incremental output.1736 */1737static voidfound_guilty_entry(struct blame_entry *ent)1738{1739if(incremental) {1740struct origin *suspect = ent->suspect;17411742printf("%s %d %d %d\n",1743sha1_to_hex(suspect->commit->object.sha1),1744 ent->s_lno +1, ent->lno +1, ent->num_lines);1745emit_one_suspect_detail(suspect,0);1746write_filename_info(suspect->path);1747maybe_flush_or_die(stdout,"stdout");1748}1749}17501751/*1752 * The main loop -- while we have blobs with lines whose true origin1753 * is still unknown, pick one blob, and allow its lines to pass blames1754 * to its parents. */1755static voidassign_blame(struct scoreboard *sb,int opt)1756{1757struct rev_info *revs = sb->revs;1758struct commit *commit =prio_queue_get(&sb->commits);17591760while(commit) {1761struct blame_entry *ent;1762struct origin *suspect = commit->util;17631764/* find one suspect to break down */1765while(suspect && !suspect->suspects)1766 suspect = suspect->next;17671768if(!suspect) {1769 commit =prio_queue_get(&sb->commits);1770continue;1771}17721773assert(commit == suspect->commit);17741775/*1776 * We will use this suspect later in the loop,1777 * so hold onto it in the meantime.1778 */1779origin_incref(suspect);1780parse_commit(commit);1781if(reverse ||1782(!(commit->object.flags & UNINTERESTING) &&1783!(revs->max_age != -1&& commit->date < revs->max_age)))1784pass_blame(sb, suspect, opt);1785else{1786 commit->object.flags |= UNINTERESTING;1787if(commit->object.parsed)1788mark_parents_uninteresting(commit);1789}1790/* treat root commit as boundary */1791if(!commit->parents && !show_root)1792 commit->object.flags |= UNINTERESTING;17931794/* Take responsibility for the remaining entries */1795 ent = suspect->suspects;1796if(ent) {1797 suspect->guilty =1;1798for(;;) {1799struct blame_entry *next = ent->next;1800found_guilty_entry(ent);1801if(next) {1802 ent = next;1803continue;1804}1805 ent->next = sb->ent;1806 sb->ent = suspect->suspects;1807 suspect->suspects = NULL;1808break;1809}1810}1811origin_decref(suspect);18121813if(DEBUG)/* sanity */1814sanity_check_refcnt(sb);1815}1816}18171818static const char*format_time(unsigned long time,const char*tz_str,1819int show_raw_time)1820{1821static struct strbuf time_buf = STRBUF_INIT;18221823strbuf_reset(&time_buf);1824if(show_raw_time) {1825strbuf_addf(&time_buf,"%lu%s", time, tz_str);1826}1827else{1828const char*time_str;1829size_t time_width;1830int tz;1831 tz =atoi(tz_str);1832 time_str =show_date(time, tz, &blame_date_mode);1833strbuf_addstr(&time_buf, time_str);1834/*1835 * Add space paddings to time_buf to display a fixed width1836 * string, and use time_width for display width calibration.1837 */1838for(time_width =utf8_strwidth(time_str);1839 time_width < blame_date_width;1840 time_width++)1841strbuf_addch(&time_buf,' ');1842}1843return time_buf.buf;1844}18451846#define OUTPUT_ANNOTATE_COMPAT 0011847#define OUTPUT_LONG_OBJECT_NAME 0021848#define OUTPUT_RAW_TIMESTAMP 0041849#define OUTPUT_PORCELAIN 0101850#define OUTPUT_SHOW_NAME 0201851#define OUTPUT_SHOW_NUMBER 0401852#define OUTPUT_SHOW_SCORE 01001853#define OUTPUT_NO_AUTHOR 02001854#define OUTPUT_SHOW_EMAIL 04001855#define OUTPUT_LINE_PORCELAIN 0100018561857static voidemit_porcelain_details(struct origin *suspect,int repeat)1858{1859if(emit_one_suspect_detail(suspect, repeat) ||1860(suspect->commit->object.flags & MORE_THAN_ONE_PATH))1861write_filename_info(suspect->path);1862}18631864static voidemit_porcelain(struct scoreboard *sb,struct blame_entry *ent,1865int opt)1866{1867int repeat = opt & OUTPUT_LINE_PORCELAIN;1868int cnt;1869const char*cp;1870struct origin *suspect = ent->suspect;1871char hex[GIT_SHA1_HEXSZ +1];18721873sha1_to_hex_r(hex, suspect->commit->object.sha1);1874printf("%s %d %d %d\n",1875 hex,1876 ent->s_lno +1,1877 ent->lno +1,1878 ent->num_lines);1879emit_porcelain_details(suspect, repeat);18801881 cp =nth_line(sb, ent->lno);1882for(cnt =0; cnt < ent->num_lines; cnt++) {1883char ch;1884if(cnt) {1885printf("%s %d %d\n", hex,1886 ent->s_lno +1+ cnt,1887 ent->lno +1+ cnt);1888if(repeat)1889emit_porcelain_details(suspect,1);1890}1891putchar('\t');1892do{1893 ch = *cp++;1894putchar(ch);1895}while(ch !='\n'&&1896 cp < sb->final_buf + sb->final_buf_size);1897}18981899if(sb->final_buf_size && cp[-1] !='\n')1900putchar('\n');1901}19021903static voidemit_other(struct scoreboard *sb,struct blame_entry *ent,int opt)1904{1905int cnt;1906const char*cp;1907struct origin *suspect = ent->suspect;1908struct commit_info ci;1909char hex[GIT_SHA1_HEXSZ +1];1910int show_raw_time = !!(opt & OUTPUT_RAW_TIMESTAMP);19111912get_commit_info(suspect->commit, &ci,1);1913sha1_to_hex_r(hex, suspect->commit->object.sha1);19141915 cp =nth_line(sb, ent->lno);1916for(cnt =0; cnt < ent->num_lines; cnt++) {1917char ch;1918int length = (opt & OUTPUT_LONG_OBJECT_NAME) ?40: abbrev;19191920if(suspect->commit->object.flags & UNINTERESTING) {1921if(blank_boundary)1922memset(hex,' ', length);1923else if(!(opt & OUTPUT_ANNOTATE_COMPAT)) {1924 length--;1925putchar('^');1926}1927}19281929printf("%.*s", length, hex);1930if(opt & OUTPUT_ANNOTATE_COMPAT) {1931const char*name;1932if(opt & OUTPUT_SHOW_EMAIL)1933 name = ci.author_mail.buf;1934else1935 name = ci.author.buf;1936printf("\t(%10s\t%10s\t%d)", name,1937format_time(ci.author_time, ci.author_tz.buf,1938 show_raw_time),1939 ent->lno +1+ cnt);1940}else{1941if(opt & OUTPUT_SHOW_SCORE)1942printf(" %*d%02d",1943 max_score_digits, ent->score,1944 ent->suspect->refcnt);1945if(opt & OUTPUT_SHOW_NAME)1946printf(" %-*.*s", longest_file, longest_file,1947 suspect->path);1948if(opt & OUTPUT_SHOW_NUMBER)1949printf(" %*d", max_orig_digits,1950 ent->s_lno +1+ cnt);19511952if(!(opt & OUTPUT_NO_AUTHOR)) {1953const char*name;1954int pad;1955if(opt & OUTPUT_SHOW_EMAIL)1956 name = ci.author_mail.buf;1957else1958 name = ci.author.buf;1959 pad = longest_author -utf8_strwidth(name);1960printf(" (%s%*s%10s",1961 name, pad,"",1962format_time(ci.author_time,1963 ci.author_tz.buf,1964 show_raw_time));1965}1966printf(" %*d) ",1967 max_digits, ent->lno +1+ cnt);1968}1969do{1970 ch = *cp++;1971putchar(ch);1972}while(ch !='\n'&&1973 cp < sb->final_buf + sb->final_buf_size);1974}19751976if(sb->final_buf_size && cp[-1] !='\n')1977putchar('\n');19781979commit_info_destroy(&ci);1980}19811982static voidoutput(struct scoreboard *sb,int option)1983{1984struct blame_entry *ent;19851986if(option & OUTPUT_PORCELAIN) {1987for(ent = sb->ent; ent; ent = ent->next) {1988int count =0;1989struct origin *suspect;1990struct commit *commit = ent->suspect->commit;1991if(commit->object.flags & MORE_THAN_ONE_PATH)1992continue;1993for(suspect = commit->util; suspect; suspect = suspect->next) {1994if(suspect->guilty && count++) {1995 commit->object.flags |= MORE_THAN_ONE_PATH;1996break;1997}1998}1999}2000}20012002for(ent = sb->ent; ent; ent = ent->next) {2003if(option & OUTPUT_PORCELAIN)2004emit_porcelain(sb, ent, option);2005else{2006emit_other(sb, ent, option);2007}2008}2009}20102011static const char*get_next_line(const char*start,const char*end)2012{2013const char*nl =memchr(start,'\n', end - start);2014return nl ? nl +1: end;2015}20162017/*2018 * To allow quick access to the contents of nth line in the2019 * final image, prepare an index in the scoreboard.2020 */2021static intprepare_lines(struct scoreboard *sb)2022{2023const char*buf = sb->final_buf;2024unsigned long len = sb->final_buf_size;2025const char*end = buf + len;2026const char*p;2027int*lineno;2028int num =0;20292030for(p = buf; p < end; p =get_next_line(p, end))2031 num++;20322033 sb->lineno = lineno =xmalloc(sizeof(*sb->lineno) * (num +1));20342035for(p = buf; p < end; p =get_next_line(p, end))2036*lineno++ = p - buf;20372038*lineno = len;20392040 sb->num_lines = num;2041return sb->num_lines;2042}20432044/*2045 * Add phony grafts for use with -S; this is primarily to2046 * support git's cvsserver that wants to give a linear history2047 * to its clients.2048 */2049static intread_ancestry(const char*graft_file)2050{2051FILE*fp =fopen(graft_file,"r");2052struct strbuf buf = STRBUF_INIT;2053if(!fp)2054return-1;2055while(!strbuf_getwholeline(&buf, fp,'\n')) {2056/* The format is just "Commit Parent1 Parent2 ...\n" */2057struct commit_graft *graft =read_graft_line(buf.buf, buf.len);2058if(graft)2059register_commit_graft(graft,0);2060}2061fclose(fp);2062strbuf_release(&buf);2063return0;2064}20652066static intupdate_auto_abbrev(int auto_abbrev,struct origin *suspect)2067{2068const char*uniq =find_unique_abbrev(suspect->commit->object.sha1,2069 auto_abbrev);2070int len =strlen(uniq);2071if(auto_abbrev < len)2072return len;2073return auto_abbrev;2074}20752076/*2077 * How many columns do we need to show line numbers, authors,2078 * and filenames?2079 */2080static voidfind_alignment(struct scoreboard *sb,int*option)2081{2082int longest_src_lines =0;2083int longest_dst_lines =0;2084unsigned largest_score =0;2085struct blame_entry *e;2086int compute_auto_abbrev = (abbrev <0);2087int auto_abbrev = default_abbrev;20882089for(e = sb->ent; e; e = e->next) {2090struct origin *suspect = e->suspect;2091int num;20922093if(compute_auto_abbrev)2094 auto_abbrev =update_auto_abbrev(auto_abbrev, suspect);2095if(strcmp(suspect->path, sb->path))2096*option |= OUTPUT_SHOW_NAME;2097 num =strlen(suspect->path);2098if(longest_file < num)2099 longest_file = num;2100if(!(suspect->commit->object.flags & METAINFO_SHOWN)) {2101struct commit_info ci;2102 suspect->commit->object.flags |= METAINFO_SHOWN;2103get_commit_info(suspect->commit, &ci,1);2104if(*option & OUTPUT_SHOW_EMAIL)2105 num =utf8_strwidth(ci.author_mail.buf);2106else2107 num =utf8_strwidth(ci.author.buf);2108if(longest_author < num)2109 longest_author = num;2110commit_info_destroy(&ci);2111}2112 num = e->s_lno + e->num_lines;2113if(longest_src_lines < num)2114 longest_src_lines = num;2115 num = e->lno + e->num_lines;2116if(longest_dst_lines < num)2117 longest_dst_lines = num;2118if(largest_score <ent_score(sb, e))2119 largest_score =ent_score(sb, e);2120}2121 max_orig_digits =decimal_width(longest_src_lines);2122 max_digits =decimal_width(longest_dst_lines);2123 max_score_digits =decimal_width(largest_score);21242125if(compute_auto_abbrev)2126/* one more abbrev length is needed for the boundary commit */2127 abbrev = auto_abbrev +1;2128}21292130/*2131 * For debugging -- origin is refcounted, and this asserts that2132 * we do not underflow.2133 */2134static voidsanity_check_refcnt(struct scoreboard *sb)2135{2136int baa =0;2137struct blame_entry *ent;21382139for(ent = sb->ent; ent; ent = ent->next) {2140/* Nobody should have zero or negative refcnt */2141if(ent->suspect->refcnt <=0) {2142fprintf(stderr,"%sin%shas negative refcnt%d\n",2143 ent->suspect->path,2144sha1_to_hex(ent->suspect->commit->object.sha1),2145 ent->suspect->refcnt);2146 baa =1;2147}2148}2149if(baa) {2150int opt =0160;2151find_alignment(sb, &opt);2152output(sb, opt);2153die("Baa%d!", baa);2154}2155}21562157static unsignedparse_score(const char*arg)2158{2159char*end;2160unsigned long score =strtoul(arg, &end,10);2161if(*end)2162return0;2163return score;2164}21652166static const char*add_prefix(const char*prefix,const char*path)2167{2168returnprefix_path(prefix, prefix ?strlen(prefix) :0, path);2169}21702171static intgit_blame_config(const char*var,const char*value,void*cb)2172{2173if(!strcmp(var,"blame.showroot")) {2174 show_root =git_config_bool(var, value);2175return0;2176}2177if(!strcmp(var,"blame.blankboundary")) {2178 blank_boundary =git_config_bool(var, value);2179return0;2180}2181if(!strcmp(var,"blame.showemail")) {2182int*output_option = cb;2183if(git_config_bool(var, value))2184*output_option |= OUTPUT_SHOW_EMAIL;2185else2186*output_option &= ~OUTPUT_SHOW_EMAIL;2187return0;2188}2189if(!strcmp(var,"blame.date")) {2190if(!value)2191returnconfig_error_nonbool(var);2192parse_date_format(value, &blame_date_mode);2193return0;2194}21952196if(userdiff_config(var, value) <0)2197return-1;21982199returngit_default_config(var, value, cb);2200}22012202static voidverify_working_tree_path(struct commit *work_tree,const char*path)2203{2204struct commit_list *parents;22052206for(parents = work_tree->parents; parents; parents = parents->next) {2207const unsigned char*commit_sha1 = parents->item->object.sha1;2208unsigned char blob_sha1[20];2209unsigned mode;22102211if(!get_tree_entry(commit_sha1, path, blob_sha1, &mode) &&2212sha1_object_info(blob_sha1, NULL) == OBJ_BLOB)2213return;2214}2215die("no such path '%s' in HEAD", path);2216}22172218static struct commit_list **append_parent(struct commit_list **tail,const unsigned char*sha1)2219{2220struct commit *parent;22212222 parent =lookup_commit_reference(sha1);2223if(!parent)2224die("no such commit%s",sha1_to_hex(sha1));2225return&commit_list_insert(parent, tail)->next;2226}22272228static voidappend_merge_parents(struct commit_list **tail)2229{2230int merge_head;2231struct strbuf line = STRBUF_INIT;22322233 merge_head =open(git_path_merge_head(), O_RDONLY);2234if(merge_head <0) {2235if(errno == ENOENT)2236return;2237die("cannot open '%s' for reading",git_path_merge_head());2238}22392240while(!strbuf_getwholeline_fd(&line, merge_head,'\n')) {2241unsigned char sha1[20];2242if(line.len <40||get_sha1_hex(line.buf, sha1))2243die("unknown line in '%s':%s",git_path_merge_head(), line.buf);2244 tail =append_parent(tail, sha1);2245}2246close(merge_head);2247strbuf_release(&line);2248}22492250/*2251 * This isn't as simple as passing sb->buf and sb->len, because we2252 * want to transfer ownership of the buffer to the commit (so we2253 * must use detach).2254 */2255static voidset_commit_buffer_from_strbuf(struct commit *c,struct strbuf *sb)2256{2257size_t len;2258void*buf =strbuf_detach(sb, &len);2259set_commit_buffer(c, buf, len);2260}22612262/*2263 * Prepare a dummy commit that represents the work tree (or staged) item.2264 * Note that annotating work tree item never works in the reverse.2265 */2266static struct commit *fake_working_tree_commit(struct diff_options *opt,2267const char*path,2268const char*contents_from)2269{2270struct commit *commit;2271struct origin *origin;2272struct commit_list **parent_tail, *parent;2273unsigned char head_sha1[20];2274struct strbuf buf = STRBUF_INIT;2275const char*ident;2276time_t now;2277int size, len;2278struct cache_entry *ce;2279unsigned mode;2280struct strbuf msg = STRBUF_INIT;22812282time(&now);2283 commit =alloc_commit_node();2284 commit->object.parsed =1;2285 commit->date = now;2286 parent_tail = &commit->parents;22872288if(!resolve_ref_unsafe("HEAD", RESOLVE_REF_READING, head_sha1, NULL))2289die("no such ref: HEAD");22902291 parent_tail =append_parent(parent_tail, head_sha1);2292append_merge_parents(parent_tail);2293verify_working_tree_path(commit, path);22942295 origin =make_origin(commit, path);22962297 ident =fmt_ident("Not Committed Yet","not.committed.yet", NULL,0);2298strbuf_addstr(&msg,"tree 0000000000000000000000000000000000000000\n");2299for(parent = commit->parents; parent; parent = parent->next)2300strbuf_addf(&msg,"parent%s\n",2301sha1_to_hex(parent->item->object.sha1));2302strbuf_addf(&msg,2303"author%s\n"2304"committer%s\n\n"2305"Version of%sfrom%s\n",2306 ident, ident, path,2307(!contents_from ? path :2308(!strcmp(contents_from,"-") ?"standard input": contents_from)));2309set_commit_buffer_from_strbuf(commit, &msg);23102311if(!contents_from ||strcmp("-", contents_from)) {2312struct stat st;2313const char*read_from;2314char*buf_ptr;2315unsigned long buf_len;23162317if(contents_from) {2318if(stat(contents_from, &st) <0)2319die_errno("Cannot stat '%s'", contents_from);2320 read_from = contents_from;2321}2322else{2323if(lstat(path, &st) <0)2324die_errno("Cannot lstat '%s'", path);2325 read_from = path;2326}2327 mode =canon_mode(st.st_mode);23282329switch(st.st_mode & S_IFMT) {2330case S_IFREG:2331if(DIFF_OPT_TST(opt, ALLOW_TEXTCONV) &&2332textconv_object(read_from, mode, null_sha1,0, &buf_ptr, &buf_len))2333strbuf_attach(&buf, buf_ptr, buf_len, buf_len +1);2334else if(strbuf_read_file(&buf, read_from, st.st_size) != st.st_size)2335die_errno("cannot open or read '%s'", read_from);2336break;2337case S_IFLNK:2338if(strbuf_readlink(&buf, read_from, st.st_size) <0)2339die_errno("cannot readlink '%s'", read_from);2340break;2341default:2342die("unsupported file type%s", read_from);2343}2344}2345else{2346/* Reading from stdin */2347 mode =0;2348if(strbuf_read(&buf,0,0) <0)2349die_errno("failed to read from stdin");2350}2351convert_to_git(path, buf.buf, buf.len, &buf,0);2352 origin->file.ptr = buf.buf;2353 origin->file.size = buf.len;2354pretend_sha1_file(buf.buf, buf.len, OBJ_BLOB, origin->blob_sha1);23552356/*2357 * Read the current index, replace the path entry with2358 * origin->blob_sha1 without mucking with its mode or type2359 * bits; we are not going to write this index out -- we just2360 * want to run "diff-index --cached".2361 */2362discard_cache();2363read_cache();23642365 len =strlen(path);2366if(!mode) {2367int pos =cache_name_pos(path, len);2368if(0<= pos)2369 mode = active_cache[pos]->ce_mode;2370else2371/* Let's not bother reading from HEAD tree */2372 mode = S_IFREG |0644;2373}2374 size =cache_entry_size(len);2375 ce =xcalloc(1, size);2376hashcpy(ce->sha1, origin->blob_sha1);2377memcpy(ce->name, path, len);2378 ce->ce_flags =create_ce_flags(0);2379 ce->ce_namelen = len;2380 ce->ce_mode =create_ce_mode(mode);2381add_cache_entry(ce, ADD_CACHE_OK_TO_ADD|ADD_CACHE_OK_TO_REPLACE);23822383/*2384 * We are not going to write this out, so this does not matter2385 * right now, but someday we might optimize diff-index --cached2386 * with cache-tree information.2387 */2388cache_tree_invalidate_path(&the_index, path);23892390return commit;2391}23922393static char*prepare_final(struct scoreboard *sb)2394{2395int i;2396const char*final_commit_name = NULL;2397struct rev_info *revs = sb->revs;23982399/*2400 * There must be one and only one positive commit in the2401 * revs->pending array.2402 */2403for(i =0; i < revs->pending.nr; i++) {2404struct object *obj = revs->pending.objects[i].item;2405if(obj->flags & UNINTERESTING)2406continue;2407while(obj->type == OBJ_TAG)2408 obj =deref_tag(obj, NULL,0);2409if(obj->type != OBJ_COMMIT)2410die("Non commit%s?", revs->pending.objects[i].name);2411if(sb->final)2412die("More than one commit to dig from%sand%s?",2413 revs->pending.objects[i].name,2414 final_commit_name);2415 sb->final = (struct commit *) obj;2416 final_commit_name = revs->pending.objects[i].name;2417}2418returnxstrdup_or_null(final_commit_name);2419}24202421static char*prepare_initial(struct scoreboard *sb)2422{2423int i;2424const char*final_commit_name = NULL;2425struct rev_info *revs = sb->revs;24262427/*2428 * There must be one and only one negative commit, and it must be2429 * the boundary.2430 */2431for(i =0; i < revs->pending.nr; i++) {2432struct object *obj = revs->pending.objects[i].item;2433if(!(obj->flags & UNINTERESTING))2434continue;2435while(obj->type == OBJ_TAG)2436 obj =deref_tag(obj, NULL,0);2437if(obj->type != OBJ_COMMIT)2438die("Non commit%s?", revs->pending.objects[i].name);2439if(sb->final)2440die("More than one commit to dig down to%sand%s?",2441 revs->pending.objects[i].name,2442 final_commit_name);2443 sb->final = (struct commit *) obj;2444 final_commit_name = revs->pending.objects[i].name;2445}2446if(!final_commit_name)2447die("No commit to dig down to?");2448returnxstrdup(final_commit_name);2449}24502451static intblame_copy_callback(const struct option *option,const char*arg,int unset)2452{2453int*opt = option->value;24542455/*2456 * -C enables copy from removed files;2457 * -C -C enables copy from existing files, but only2458 * when blaming a new file;2459 * -C -C -C enables copy from existing files for2460 * everybody2461 */2462if(*opt & PICKAXE_BLAME_COPY_HARDER)2463*opt |= PICKAXE_BLAME_COPY_HARDEST;2464if(*opt & PICKAXE_BLAME_COPY)2465*opt |= PICKAXE_BLAME_COPY_HARDER;2466*opt |= PICKAXE_BLAME_COPY | PICKAXE_BLAME_MOVE;24672468if(arg)2469 blame_copy_score =parse_score(arg);2470return0;2471}24722473static intblame_move_callback(const struct option *option,const char*arg,int unset)2474{2475int*opt = option->value;24762477*opt |= PICKAXE_BLAME_MOVE;24782479if(arg)2480 blame_move_score =parse_score(arg);2481return0;2482}24832484intcmd_blame(int argc,const char**argv,const char*prefix)2485{2486struct rev_info revs;2487const char*path;2488struct scoreboard sb;2489struct origin *o;2490struct blame_entry *ent = NULL;2491long dashdash_pos, lno;2492char*final_commit_name = NULL;2493enum object_type type;24942495static struct string_list range_list;2496static int output_option =0, opt =0;2497static int show_stats =0;2498static const char*revs_file = NULL;2499static const char*contents_from = NULL;2500static const struct option options[] = {2501OPT_BOOL(0,"incremental", &incremental,N_("Show blame entries as we find them, incrementally")),2502OPT_BOOL('b', NULL, &blank_boundary,N_("Show blank SHA-1 for boundary commits (Default: off)")),2503OPT_BOOL(0,"root", &show_root,N_("Do not treat root commits as boundaries (Default: off)")),2504OPT_BOOL(0,"show-stats", &show_stats,N_("Show work cost statistics")),2505OPT_BIT(0,"score-debug", &output_option,N_("Show output score for blame entries"), OUTPUT_SHOW_SCORE),2506OPT_BIT('f',"show-name", &output_option,N_("Show original filename (Default: auto)"), OUTPUT_SHOW_NAME),2507OPT_BIT('n',"show-number", &output_option,N_("Show original linenumber (Default: off)"), OUTPUT_SHOW_NUMBER),2508OPT_BIT('p',"porcelain", &output_option,N_("Show in a format designed for machine consumption"), OUTPUT_PORCELAIN),2509OPT_BIT(0,"line-porcelain", &output_option,N_("Show porcelain format with per-line commit information"), OUTPUT_PORCELAIN|OUTPUT_LINE_PORCELAIN),2510OPT_BIT('c', NULL, &output_option,N_("Use the same output mode as git-annotate (Default: off)"), OUTPUT_ANNOTATE_COMPAT),2511OPT_BIT('t', NULL, &output_option,N_("Show raw timestamp (Default: off)"), OUTPUT_RAW_TIMESTAMP),2512OPT_BIT('l', NULL, &output_option,N_("Show long commit SHA1 (Default: off)"), OUTPUT_LONG_OBJECT_NAME),2513OPT_BIT('s', NULL, &output_option,N_("Suppress author name and timestamp (Default: off)"), OUTPUT_NO_AUTHOR),2514OPT_BIT('e',"show-email", &output_option,N_("Show author email instead of name (Default: off)"), OUTPUT_SHOW_EMAIL),2515OPT_BIT('w', NULL, &xdl_opts,N_("Ignore whitespace differences"), XDF_IGNORE_WHITESPACE),2516OPT_BIT(0,"minimal", &xdl_opts,N_("Spend extra cycles to find better match"), XDF_NEED_MINIMAL),2517OPT_STRING('S', NULL, &revs_file,N_("file"),N_("Use revisions from <file> instead of calling git-rev-list")),2518OPT_STRING(0,"contents", &contents_from,N_("file"),N_("Use <file>'s contents as the final image")),2519{ OPTION_CALLBACK,'C', NULL, &opt,N_("score"),N_("Find line copies within and across files"), PARSE_OPT_OPTARG, blame_copy_callback },2520{ OPTION_CALLBACK,'M', NULL, &opt,N_("score"),N_("Find line movements within and across files"), PARSE_OPT_OPTARG, blame_move_callback },2521OPT_STRING_LIST('L', NULL, &range_list,N_("n,m"),N_("Process only line range n,m, counting from 1")),2522OPT__ABBREV(&abbrev),2523OPT_END()2524};25252526struct parse_opt_ctx_t ctx;2527int cmd_is_annotate = !strcmp(argv[0],"annotate");2528struct range_set ranges;2529unsigned int range_i;2530long anchor;25312532git_config(git_blame_config, &output_option);2533init_revisions(&revs, NULL);2534 revs.date_mode = blame_date_mode;2535DIFF_OPT_SET(&revs.diffopt, ALLOW_TEXTCONV);2536DIFF_OPT_SET(&revs.diffopt, FOLLOW_RENAMES);25372538 save_commit_buffer =0;2539 dashdash_pos =0;25402541parse_options_start(&ctx, argc, argv, prefix, options,2542 PARSE_OPT_KEEP_DASHDASH | PARSE_OPT_KEEP_ARGV0);2543for(;;) {2544switch(parse_options_step(&ctx, options, blame_opt_usage)) {2545case PARSE_OPT_HELP:2546exit(129);2547case PARSE_OPT_DONE:2548if(ctx.argv[0])2549 dashdash_pos = ctx.cpidx;2550goto parse_done;2551}25522553if(!strcmp(ctx.argv[0],"--reverse")) {2554 ctx.argv[0] ="--children";2555 reverse =1;2556}2557parse_revision_opt(&revs, &ctx, options, blame_opt_usage);2558}2559parse_done:2560 no_whole_file_rename = !DIFF_OPT_TST(&revs.diffopt, FOLLOW_RENAMES);2561DIFF_OPT_CLR(&revs.diffopt, FOLLOW_RENAMES);2562 argc =parse_options_end(&ctx);25632564if(0< abbrev)2565/* one more abbrev length is needed for the boundary commit */2566 abbrev++;25672568if(revs_file &&read_ancestry(revs_file))2569die_errno("reading graft file '%s' failed", revs_file);25702571if(cmd_is_annotate) {2572 output_option |= OUTPUT_ANNOTATE_COMPAT;2573 blame_date_mode.type = DATE_ISO8601;2574}else{2575 blame_date_mode = revs.date_mode;2576}25772578/* The maximum width used to show the dates */2579switch(blame_date_mode.type) {2580case DATE_RFC2822:2581 blame_date_width =sizeof("Thu, 19 Oct 2006 16:00:04 -0700");2582break;2583case DATE_ISO8601_STRICT:2584 blame_date_width =sizeof("2006-10-19T16:00:04-07:00");2585break;2586case DATE_ISO8601:2587 blame_date_width =sizeof("2006-10-19 16:00:04 -0700");2588break;2589case DATE_RAW:2590 blame_date_width =sizeof("1161298804 -0700");2591break;2592case DATE_SHORT:2593 blame_date_width =sizeof("2006-10-19");2594break;2595case DATE_RELATIVE:2596/* TRANSLATORS: This string is used to tell us the maximum2597 display width for a relative timestamp in "git blame"2598 output. For C locale, "4 years, 11 months ago", which2599 takes 22 places, is the longest among various forms of2600 relative timestamps, but your language may need more or2601 fewer display columns. */2602 blame_date_width =utf8_strwidth(_("4 years, 11 months ago")) +1;/* add the null */2603break;2604case DATE_LOCAL:2605case DATE_NORMAL:2606 blame_date_width =sizeof("Thu Oct 19 16:00:04 2006 -0700");2607break;2608case DATE_STRFTIME:2609 blame_date_width =strlen(show_date(0,0, &blame_date_mode)) +1;/* add the null */2610break;2611}2612 blame_date_width -=1;/* strip the null */26132614if(DIFF_OPT_TST(&revs.diffopt, FIND_COPIES_HARDER))2615 opt |= (PICKAXE_BLAME_COPY | PICKAXE_BLAME_MOVE |2616 PICKAXE_BLAME_COPY_HARDER);26172618if(!blame_move_score)2619 blame_move_score = BLAME_DEFAULT_MOVE_SCORE;2620if(!blame_copy_score)2621 blame_copy_score = BLAME_DEFAULT_COPY_SCORE;26222623/*2624 * We have collected options unknown to us in argv[1..unk]2625 * which are to be passed to revision machinery if we are2626 * going to do the "bottom" processing.2627 *2628 * The remaining are:2629 *2630 * (1) if dashdash_pos != 0, it is either2631 * "blame [revisions] -- <path>" or2632 * "blame -- <path> <rev>"2633 *2634 * (2) otherwise, it is one of the two:2635 * "blame [revisions] <path>"2636 * "blame <path> <rev>"2637 *2638 * Note that we must strip out <path> from the arguments: we do not2639 * want the path pruning but we may want "bottom" processing.2640 */2641if(dashdash_pos) {2642switch(argc - dashdash_pos -1) {2643case2:/* (1b) */2644if(argc !=4)2645usage_with_options(blame_opt_usage, options);2646/* reorder for the new way: <rev> -- <path> */2647 argv[1] = argv[3];2648 argv[3] = argv[2];2649 argv[2] ="--";2650/* FALLTHROUGH */2651case1:/* (1a) */2652 path =add_prefix(prefix, argv[--argc]);2653 argv[argc] = NULL;2654break;2655default:2656usage_with_options(blame_opt_usage, options);2657}2658}else{2659if(argc <2)2660usage_with_options(blame_opt_usage, options);2661 path =add_prefix(prefix, argv[argc -1]);2662if(argc ==3&& !file_exists(path)) {/* (2b) */2663 path =add_prefix(prefix, argv[1]);2664 argv[1] = argv[2];2665}2666 argv[argc -1] ="--";26672668setup_work_tree();2669if(!file_exists(path))2670die_errno("cannot stat path '%s'", path);2671}26722673 revs.disable_stdin =1;2674setup_revisions(argc, argv, &revs, NULL);2675memset(&sb,0,sizeof(sb));26762677 sb.revs = &revs;2678if(!reverse) {2679 final_commit_name =prepare_final(&sb);2680 sb.commits.compare = compare_commits_by_commit_date;2681}2682else if(contents_from)2683die("--contents and --children do not blend well.");2684else{2685 final_commit_name =prepare_initial(&sb);2686 sb.commits.compare = compare_commits_by_reverse_commit_date;2687}26882689if(!sb.final) {2690/*2691 * "--not A B -- path" without anything positive;2692 * do not default to HEAD, but use the working tree2693 * or "--contents".2694 */2695setup_work_tree();2696 sb.final =fake_working_tree_commit(&sb.revs->diffopt,2697 path, contents_from);2698add_pending_object(&revs, &(sb.final->object),":");2699}2700else if(contents_from)2701die("Cannot use --contents with final commit object name");27022703/*2704 * If we have bottom, this will mark the ancestors of the2705 * bottom commits we would reach while traversing as2706 * uninteresting.2707 */2708if(prepare_revision_walk(&revs))2709die(_("revision walk setup failed"));27102711if(is_null_sha1(sb.final->object.sha1)) {2712 o = sb.final->util;2713 sb.final_buf =xmemdupz(o->file.ptr, o->file.size);2714 sb.final_buf_size = o->file.size;2715}2716else{2717 o =get_origin(&sb, sb.final, path);2718if(fill_blob_sha1_and_mode(o))2719die("no such path%sin%s", path, final_commit_name);27202721if(DIFF_OPT_TST(&sb.revs->diffopt, ALLOW_TEXTCONV) &&2722textconv_object(path, o->mode, o->blob_sha1,1, (char**) &sb.final_buf,2723&sb.final_buf_size))2724;2725else2726 sb.final_buf =read_sha1_file(o->blob_sha1, &type,2727&sb.final_buf_size);27282729if(!sb.final_buf)2730die("Cannot read blob%sfor path%s",2731sha1_to_hex(o->blob_sha1),2732 path);2733}2734 num_read_blob++;2735 lno =prepare_lines(&sb);27362737if(lno && !range_list.nr)2738string_list_append(&range_list,xstrdup("1"));27392740 anchor =1;2741range_set_init(&ranges, range_list.nr);2742for(range_i =0; range_i < range_list.nr; ++range_i) {2743long bottom, top;2744if(parse_range_arg(range_list.items[range_i].string,2745 nth_line_cb, &sb, lno, anchor,2746&bottom, &top, sb.path))2747usage(blame_usage);2748if(lno < top || ((lno || bottom) && lno < bottom))2749die("file%shas only%lu lines", path, lno);2750if(bottom <1)2751 bottom =1;2752if(top <1)2753 top = lno;2754 bottom--;2755range_set_append_unsafe(&ranges, bottom, top);2756 anchor = top +1;2757}2758sort_and_merge_range_set(&ranges);27592760for(range_i = ranges.nr; range_i >0; --range_i) {2761const struct range *r = &ranges.ranges[range_i -1];2762long bottom = r->start;2763long top = r->end;2764struct blame_entry *next = ent;2765 ent =xcalloc(1,sizeof(*ent));2766 ent->lno = bottom;2767 ent->num_lines = top - bottom;2768 ent->suspect = o;2769 ent->s_lno = bottom;2770 ent->next = next;2771origin_incref(o);2772}27732774 o->suspects = ent;2775prio_queue_put(&sb.commits, o->commit);27762777origin_decref(o);27782779range_set_release(&ranges);2780string_list_clear(&range_list,0);27812782 sb.ent = NULL;2783 sb.path = path;27842785read_mailmap(&mailmap, NULL);27862787if(!incremental)2788setup_pager();27892790assign_blame(&sb, opt);27912792free(final_commit_name);27932794if(incremental)2795return0;27962797 sb.ent =blame_sort(sb.ent, compare_blame_final);27982799coalesce(&sb);28002801if(!(output_option & OUTPUT_PORCELAIN))2802find_alignment(&sb, &output_option);28032804output(&sb, output_option);2805free((void*)sb.final_buf);2806for(ent = sb.ent; ent; ) {2807struct blame_entry *e = ent->next;2808free(ent);2809 ent = e;2810}28112812if(show_stats) {2813printf("num read blob:%d\n", num_read_blob);2814printf("num get patch:%d\n", num_get_patch);2815printf("num commits:%d\n", num_commits);2816}2817return0;2818}