sha1_name.con commit Documentation/git-checkout: Update summary to reflect current abilities (76ce946)
   1#include "cache.h"
   2#include "tag.h"
   3#include "commit.h"
   4#include "tree.h"
   5#include "blob.h"
   6#include "tree-walk.h"
   7#include "refs.h"
   8
   9static int find_short_object_filename(int len, const char *name, unsigned char *sha1)
  10{
  11        struct alternate_object_database *alt;
  12        char hex[40];
  13        int found = 0;
  14        static struct alternate_object_database *fakeent;
  15
  16        if (!fakeent) {
  17                const char *objdir = get_object_directory();
  18                int objdir_len = strlen(objdir);
  19                int entlen = objdir_len + 43;
  20                fakeent = xmalloc(sizeof(*fakeent) + entlen);
  21                memcpy(fakeent->base, objdir, objdir_len);
  22                fakeent->name = fakeent->base + objdir_len + 1;
  23                fakeent->name[-1] = '/';
  24        }
  25        fakeent->next = alt_odb_list;
  26
  27        sprintf(hex, "%.2s", name);
  28        for (alt = fakeent; alt && found < 2; alt = alt->next) {
  29                struct dirent *de;
  30                DIR *dir;
  31                sprintf(alt->name, "%.2s/", name);
  32                dir = opendir(alt->base);
  33                if (!dir)
  34                        continue;
  35                while ((de = readdir(dir)) != NULL) {
  36                        if (strlen(de->d_name) != 38)
  37                                continue;
  38                        if (memcmp(de->d_name, name + 2, len - 2))
  39                                continue;
  40                        if (!found) {
  41                                memcpy(hex + 2, de->d_name, 38);
  42                                found++;
  43                        }
  44                        else if (memcmp(hex + 2, de->d_name, 38)) {
  45                                found = 2;
  46                                break;
  47                        }
  48                }
  49                closedir(dir);
  50        }
  51        if (found == 1)
  52                return get_sha1_hex(hex, sha1) == 0;
  53        return found;
  54}
  55
  56static int match_sha(unsigned len, const unsigned char *a, const unsigned char *b)
  57{
  58        do {
  59                if (*a != *b)
  60                        return 0;
  61                a++;
  62                b++;
  63                len -= 2;
  64        } while (len > 1);
  65        if (len)
  66                if ((*a ^ *b) & 0xf0)
  67                        return 0;
  68        return 1;
  69}
  70
  71static int find_short_packed_object(int len, const unsigned char *match, unsigned char *sha1)
  72{
  73        struct packed_git *p;
  74        const unsigned char *found_sha1 = NULL;
  75        int found = 0;
  76
  77        prepare_packed_git();
  78        for (p = packed_git; p && found < 2; p = p->next) {
  79                uint32_t num, last;
  80                uint32_t first = 0;
  81                open_pack_index(p);
  82                num = p->num_objects;
  83                last = num;
  84                while (first < last) {
  85                        uint32_t mid = (first + last) / 2;
  86                        const unsigned char *now;
  87                        int cmp;
  88
  89                        now = nth_packed_object_sha1(p, mid);
  90                        cmp = hashcmp(match, now);
  91                        if (!cmp) {
  92                                first = mid;
  93                                break;
  94                        }
  95                        if (cmp > 0) {
  96                                first = mid+1;
  97                                continue;
  98                        }
  99                        last = mid;
 100                }
 101                if (first < num) {
 102                        const unsigned char *now, *next;
 103                       now = nth_packed_object_sha1(p, first);
 104                        if (match_sha(len, match, now)) {
 105                                next = nth_packed_object_sha1(p, first+1);
 106                               if (!next|| !match_sha(len, match, next)) {
 107                                        /* unique within this pack */
 108                                        if (!found) {
 109                                                found_sha1 = now;
 110                                                found++;
 111                                        }
 112                                        else if (hashcmp(found_sha1, now)) {
 113                                                found = 2;
 114                                                break;
 115                                        }
 116                                }
 117                                else {
 118                                        /* not even unique within this pack */
 119                                        found = 2;
 120                                        break;
 121                                }
 122                        }
 123                }
 124        }
 125        if (found == 1)
 126                hashcpy(sha1, found_sha1);
 127        return found;
 128}
 129
 130#define SHORT_NAME_NOT_FOUND (-1)
 131#define SHORT_NAME_AMBIGUOUS (-2)
 132
 133static int find_unique_short_object(int len, char *canonical,
 134                                    unsigned char *res, unsigned char *sha1)
 135{
 136        int has_unpacked, has_packed;
 137        unsigned char unpacked_sha1[20], packed_sha1[20];
 138
 139        prepare_alt_odb();
 140        has_unpacked = find_short_object_filename(len, canonical, unpacked_sha1);
 141        has_packed = find_short_packed_object(len, res, packed_sha1);
 142        if (!has_unpacked && !has_packed)
 143                return SHORT_NAME_NOT_FOUND;
 144        if (1 < has_unpacked || 1 < has_packed)
 145                return SHORT_NAME_AMBIGUOUS;
 146        if (has_unpacked != has_packed) {
 147                hashcpy(sha1, (has_packed ? packed_sha1 : unpacked_sha1));
 148                return 0;
 149        }
 150        /* Both have unique ones -- do they match? */
 151        if (hashcmp(packed_sha1, unpacked_sha1))
 152                return SHORT_NAME_AMBIGUOUS;
 153        hashcpy(sha1, packed_sha1);
 154        return 0;
 155}
 156
 157static int get_short_sha1(const char *name, int len, unsigned char *sha1,
 158                          int quietly)
 159{
 160        int i, status;
 161        char canonical[40];
 162        unsigned char res[20];
 163
 164        if (len < MINIMUM_ABBREV || len > 40)
 165                return -1;
 166        hashclr(res);
 167        memset(canonical, 'x', 40);
 168        for (i = 0; i < len ;i++) {
 169                unsigned char c = name[i];
 170                unsigned char val;
 171                if (c >= '0' && c <= '9')
 172                        val = c - '0';
 173                else if (c >= 'a' && c <= 'f')
 174                        val = c - 'a' + 10;
 175                else if (c >= 'A' && c <='F') {
 176                        val = c - 'A' + 10;
 177                        c -= 'A' - 'a';
 178                }
 179                else
 180                        return -1;
 181                canonical[i] = c;
 182                if (!(i & 1))
 183                        val <<= 4;
 184                res[i >> 1] |= val;
 185        }
 186
 187        status = find_unique_short_object(i, canonical, res, sha1);
 188        if (!quietly && (status == SHORT_NAME_AMBIGUOUS))
 189                return error("short SHA1 %.*s is ambiguous.", len, canonical);
 190        return status;
 191}
 192
 193const char *find_unique_abbrev(const unsigned char *sha1, int len)
 194{
 195        int status, exists;
 196        static char hex[41];
 197
 198        exists = has_sha1_file(sha1);
 199        memcpy(hex, sha1_to_hex(sha1), 40);
 200        if (len == 40 || !len)
 201                return hex;
 202        while (len < 40) {
 203                unsigned char sha1_ret[20];
 204                status = get_short_sha1(hex, len, sha1_ret, 1);
 205                if (exists
 206                    ? !status
 207                    : status == SHORT_NAME_NOT_FOUND) {
 208                        hex[len] = 0;
 209                        return hex;
 210                }
 211                len++;
 212        }
 213        return hex;
 214}
 215
 216static int ambiguous_path(const char *path, int len)
 217{
 218        int slash = 1;
 219        int cnt;
 220
 221        for (cnt = 0; cnt < len; cnt++) {
 222                switch (*path++) {
 223                case '\0':
 224                        break;
 225                case '/':
 226                        if (slash)
 227                                break;
 228                        slash = 1;
 229                        continue;
 230                case '.':
 231                        continue;
 232                default:
 233                        slash = 0;
 234                        continue;
 235                }
 236                break;
 237        }
 238        return slash;
 239}
 240
 241int dwim_ref(const char *str, int len, unsigned char *sha1, char **ref)
 242{
 243        const char **p, *r;
 244        int refs_found = 0;
 245
 246        *ref = NULL;
 247        for (p = ref_rev_parse_rules; *p; p++) {
 248                unsigned char sha1_from_ref[20];
 249                unsigned char *this_result;
 250
 251                this_result = refs_found ? sha1_from_ref : sha1;
 252                r = resolve_ref(mkpath(*p, len, str), this_result, 1, NULL);
 253                if (r) {
 254                        if (!refs_found++)
 255                                *ref = xstrdup(r);
 256                        if (!warn_ambiguous_refs)
 257                                break;
 258                }
 259        }
 260        return refs_found;
 261}
 262
 263int dwim_log(const char *str, int len, unsigned char *sha1, char **log)
 264{
 265        const char **p;
 266        int logs_found = 0;
 267
 268        *log = NULL;
 269        for (p = ref_rev_parse_rules; *p; p++) {
 270                struct stat st;
 271                unsigned char hash[20];
 272                char path[PATH_MAX];
 273                const char *ref, *it;
 274
 275                strcpy(path, mkpath(*p, len, str));
 276                ref = resolve_ref(path, hash, 0, NULL);
 277                if (!ref)
 278                        continue;
 279                if (!stat(git_path("logs/%s", path), &st) &&
 280                    S_ISREG(st.st_mode))
 281                        it = path;
 282                else if (strcmp(ref, path) &&
 283                         !stat(git_path("logs/%s", ref), &st) &&
 284                         S_ISREG(st.st_mode))
 285                        it = ref;
 286                else
 287                        continue;
 288                if (!logs_found++) {
 289                        *log = xstrdup(it);
 290                        hashcpy(sha1, hash);
 291                }
 292                if (!warn_ambiguous_refs)
 293                        break;
 294        }
 295        return logs_found;
 296}
 297
 298static int get_sha1_basic(const char *str, int len, unsigned char *sha1)
 299{
 300        static const char *warning = "warning: refname '%.*s' is ambiguous.\n";
 301        char *real_ref = NULL;
 302        int refs_found = 0;
 303        int at, reflog_len;
 304
 305        if (len == 40 && !get_sha1_hex(str, sha1))
 306                return 0;
 307
 308        /* basic@{time or number} format to query ref-log */
 309        reflog_len = at = 0;
 310        if (str[len-1] == '}') {
 311                for (at = 0; at < len - 1; at++) {
 312                        if (str[at] == '@' && str[at+1] == '{') {
 313                                reflog_len = (len-1) - (at+2);
 314                                len = at;
 315                                break;
 316                        }
 317                }
 318        }
 319
 320        /* Accept only unambiguous ref paths. */
 321        if (len && ambiguous_path(str, len))
 322                return -1;
 323
 324        if (!len && reflog_len) {
 325                /* allow "@{...}" to mean the current branch reflog */
 326                refs_found = dwim_ref("HEAD", 4, sha1, &real_ref);
 327        } else if (reflog_len)
 328                refs_found = dwim_log(str, len, sha1, &real_ref);
 329        else
 330                refs_found = dwim_ref(str, len, sha1, &real_ref);
 331
 332        if (!refs_found)
 333                return -1;
 334
 335        if (warn_ambiguous_refs && refs_found > 1)
 336                fprintf(stderr, warning, len, str);
 337
 338        if (reflog_len) {
 339                int nth, i;
 340                unsigned long at_time;
 341                unsigned long co_time;
 342                int co_tz, co_cnt;
 343
 344                /* Is it asking for N-th entry, or approxidate? */
 345                for (i = nth = 0; 0 <= nth && i < reflog_len; i++) {
 346                        char ch = str[at+2+i];
 347                        if ('0' <= ch && ch <= '9')
 348                                nth = nth * 10 + ch - '0';
 349                        else
 350                                nth = -1;
 351                }
 352                if (0 <= nth)
 353                        at_time = 0;
 354                else
 355                        at_time = approxidate(str + at + 2);
 356                if (read_ref_at(real_ref, at_time, nth, sha1, NULL,
 357                                &co_time, &co_tz, &co_cnt)) {
 358                        if (at_time)
 359                                fprintf(stderr,
 360                                        "warning: Log for '%.*s' only goes "
 361                                        "back to %s.\n", len, str,
 362                                        show_date(co_time, co_tz, DATE_RFC2822));
 363                        else
 364                                fprintf(stderr,
 365                                        "warning: Log for '%.*s' only has "
 366                                        "%d entries.\n", len, str, co_cnt);
 367                }
 368        }
 369
 370        free(real_ref);
 371        return 0;
 372}
 373
 374static int get_sha1_1(const char *name, int len, unsigned char *sha1);
 375
 376static int get_parent(const char *name, int len,
 377                      unsigned char *result, int idx)
 378{
 379        unsigned char sha1[20];
 380        int ret = get_sha1_1(name, len, sha1);
 381        struct commit *commit;
 382        struct commit_list *p;
 383
 384        if (ret)
 385                return ret;
 386        commit = lookup_commit_reference(sha1);
 387        if (!commit)
 388                return -1;
 389        if (parse_commit(commit))
 390                return -1;
 391        if (!idx) {
 392                hashcpy(result, commit->object.sha1);
 393                return 0;
 394        }
 395        p = commit->parents;
 396        while (p) {
 397                if (!--idx) {
 398                        hashcpy(result, p->item->object.sha1);
 399                        return 0;
 400                }
 401                p = p->next;
 402        }
 403        return -1;
 404}
 405
 406static int get_nth_ancestor(const char *name, int len,
 407                            unsigned char *result, int generation)
 408{
 409        unsigned char sha1[20];
 410        struct commit *commit;
 411        int ret;
 412
 413        ret = get_sha1_1(name, len, sha1);
 414        if (ret)
 415                return ret;
 416        commit = lookup_commit_reference(sha1);
 417        if (!commit)
 418                return -1;
 419
 420        while (generation--) {
 421                if (parse_commit(commit) || !commit->parents)
 422                        return -1;
 423                commit = commit->parents->item;
 424        }
 425        hashcpy(result, commit->object.sha1);
 426        return 0;
 427}
 428
 429struct object *peel_to_type(const char *name, int namelen,
 430                            struct object *o, enum object_type expected_type)
 431{
 432        if (name && !namelen)
 433                namelen = strlen(name);
 434        if (!o) {
 435                unsigned char sha1[20];
 436                if (get_sha1_1(name, namelen, sha1))
 437                        return NULL;
 438                o = parse_object(sha1);
 439        }
 440        while (1) {
 441                if (!o || (!o->parsed && !parse_object(o->sha1)))
 442                        return NULL;
 443                if (o->type == expected_type)
 444                        return o;
 445                if (o->type == OBJ_TAG)
 446                        o = ((struct tag*) o)->tagged;
 447                else if (o->type == OBJ_COMMIT)
 448                        o = &(((struct commit *) o)->tree->object);
 449                else {
 450                        if (name)
 451                                error("%.*s: expected %s type, but the object "
 452                                      "dereferences to %s type",
 453                                      namelen, name, typename(expected_type),
 454                                      typename(o->type));
 455                        return NULL;
 456                }
 457        }
 458}
 459
 460static int peel_onion(const char *name, int len, unsigned char *sha1)
 461{
 462        unsigned char outer[20];
 463        const char *sp;
 464        unsigned int expected_type = 0;
 465        struct object *o;
 466
 467        /*
 468         * "ref^{type}" dereferences ref repeatedly until you cannot
 469         * dereference anymore, or you get an object of given type,
 470         * whichever comes first.  "ref^{}" means just dereference
 471         * tags until you get a non-tag.  "ref^0" is a shorthand for
 472         * "ref^{commit}".  "commit^{tree}" could be used to find the
 473         * top-level tree of the given commit.
 474         */
 475        if (len < 4 || name[len-1] != '}')
 476                return -1;
 477
 478        for (sp = name + len - 1; name <= sp; sp--) {
 479                int ch = *sp;
 480                if (ch == '{' && name < sp && sp[-1] == '^')
 481                        break;
 482        }
 483        if (sp <= name)
 484                return -1;
 485
 486        sp++; /* beginning of type name, or closing brace for empty */
 487        if (!strncmp(commit_type, sp, 6) && sp[6] == '}')
 488                expected_type = OBJ_COMMIT;
 489        else if (!strncmp(tree_type, sp, 4) && sp[4] == '}')
 490                expected_type = OBJ_TREE;
 491        else if (!strncmp(blob_type, sp, 4) && sp[4] == '}')
 492                expected_type = OBJ_BLOB;
 493        else if (sp[0] == '}')
 494                expected_type = OBJ_NONE;
 495        else
 496                return -1;
 497
 498        if (get_sha1_1(name, sp - name - 2, outer))
 499                return -1;
 500
 501        o = parse_object(outer);
 502        if (!o)
 503                return -1;
 504        if (!expected_type) {
 505                o = deref_tag(o, name, sp - name - 2);
 506                if (!o || (!o->parsed && !parse_object(o->sha1)))
 507                        return -1;
 508                hashcpy(sha1, o->sha1);
 509        }
 510        else {
 511                /*
 512                 * At this point, the syntax look correct, so
 513                 * if we do not get the needed object, we should
 514                 * barf.
 515                 */
 516                o = peel_to_type(name, len, o, expected_type);
 517                if (o) {
 518                        hashcpy(sha1, o->sha1);
 519                        return 0;
 520                }
 521                return -1;
 522        }
 523        return 0;
 524}
 525
 526static int get_describe_name(const char *name, int len, unsigned char *sha1)
 527{
 528        const char *cp;
 529
 530        for (cp = name + len - 1; name + 2 <= cp; cp--) {
 531                char ch = *cp;
 532                if (hexval(ch) & ~0377) {
 533                        /* We must be looking at g in "SOMETHING-g"
 534                         * for it to be describe output.
 535                         */
 536                        if (ch == 'g' && cp[-1] == '-') {
 537                                cp++;
 538                                len -= cp - name;
 539                                return get_short_sha1(cp, len, sha1, 1);
 540                        }
 541                }
 542        }
 543        return -1;
 544}
 545
 546static int get_sha1_1(const char *name, int len, unsigned char *sha1)
 547{
 548        int ret, has_suffix;
 549        const char *cp;
 550
 551        /*
 552         * "name~3" is "name^^^", "name~" is "name~1", and "name^" is "name^1".
 553         */
 554        has_suffix = 0;
 555        for (cp = name + len - 1; name <= cp; cp--) {
 556                int ch = *cp;
 557                if ('0' <= ch && ch <= '9')
 558                        continue;
 559                if (ch == '~' || ch == '^')
 560                        has_suffix = ch;
 561                break;
 562        }
 563
 564        if (has_suffix) {
 565                int num = 0;
 566                int len1 = cp - name;
 567                cp++;
 568                while (cp < name + len)
 569                        num = num * 10 + *cp++ - '0';
 570                if (!num && len1 == len - 1)
 571                        num = 1;
 572                if (has_suffix == '^')
 573                        return get_parent(name, len1, sha1, num);
 574                /* else if (has_suffix == '~') -- goes without saying */
 575                return get_nth_ancestor(name, len1, sha1, num);
 576        }
 577
 578        ret = peel_onion(name, len, sha1);
 579        if (!ret)
 580                return 0;
 581
 582        ret = get_sha1_basic(name, len, sha1);
 583        if (!ret)
 584                return 0;
 585
 586        /* It could be describe output that is "SOMETHING-gXXXX" */
 587        ret = get_describe_name(name, len, sha1);
 588        if (!ret)
 589                return 0;
 590
 591        return get_short_sha1(name, len, sha1, 0);
 592}
 593
 594static int handle_one_ref(const char *path,
 595                const unsigned char *sha1, int flag, void *cb_data)
 596{
 597        struct commit_list **list = cb_data;
 598        struct object *object = parse_object(sha1);
 599        if (!object)
 600                return 0;
 601        if (object->type == OBJ_TAG) {
 602                object = deref_tag(object, path, strlen(path));
 603                if (!object)
 604                        return 0;
 605        }
 606        if (object->type != OBJ_COMMIT)
 607                return 0;
 608        insert_by_date((struct commit *)object, list);
 609        return 0;
 610}
 611
 612/*
 613 * This interprets names like ':/Initial revision of "git"' by searching
 614 * through history and returning the first commit whose message starts
 615 * with the given string.
 616 *
 617 * For future extension, ':/!' is reserved. If you want to match a message
 618 * beginning with a '!', you have to repeat the exclamation mark.
 619 */
 620
 621#define ONELINE_SEEN (1u<<20)
 622static int get_sha1_oneline(const char *prefix, unsigned char *sha1)
 623{
 624        struct commit_list *list = NULL, *backup = NULL, *l;
 625        int retval = -1;
 626        char *temp_commit_buffer = NULL;
 627
 628        if (prefix[0] == '!') {
 629                if (prefix[1] != '!')
 630                        die ("Invalid search pattern: %s", prefix);
 631                prefix++;
 632        }
 633        for_each_ref(handle_one_ref, &list);
 634        for (l = list; l; l = l->next)
 635                commit_list_insert(l->item, &backup);
 636        while (list) {
 637                char *p;
 638                struct commit *commit;
 639                enum object_type type;
 640                unsigned long size;
 641
 642                commit = pop_most_recent_commit(&list, ONELINE_SEEN);
 643                if (!parse_object(commit->object.sha1))
 644                        continue;
 645                free(temp_commit_buffer);
 646                if (commit->buffer)
 647                        p = commit->buffer;
 648                else {
 649                        p = read_sha1_file(commit->object.sha1, &type, &size);
 650                        if (!p)
 651                                continue;
 652                        temp_commit_buffer = p;
 653                }
 654                if (!(p = strstr(p, "\n\n")))
 655                        continue;
 656                if (!prefixcmp(p + 2, prefix)) {
 657                        hashcpy(sha1, commit->object.sha1);
 658                        retval = 0;
 659                        break;
 660                }
 661        }
 662        free(temp_commit_buffer);
 663        free_commit_list(list);
 664        for (l = backup; l; l = l->next)
 665                clear_commit_marks(l->item, ONELINE_SEEN);
 666        return retval;
 667}
 668
 669/*
 670 * This is like "get_sha1_basic()", except it allows "sha1 expressions",
 671 * notably "xyz^" for "parent of xyz"
 672 */
 673int get_sha1(const char *name, unsigned char *sha1)
 674{
 675        unsigned unused;
 676        return get_sha1_with_mode(name, sha1, &unused);
 677}
 678
 679int get_sha1_with_mode(const char *name, unsigned char *sha1, unsigned *mode)
 680{
 681        int ret, bracket_depth;
 682        int namelen = strlen(name);
 683        const char *cp;
 684
 685        *mode = S_IFINVALID;
 686        ret = get_sha1_1(name, namelen, sha1);
 687        if (!ret)
 688                return ret;
 689        /* sha1:path --> object name of path in ent sha1
 690         * :path -> object name of path in index
 691         * :[0-3]:path -> object name of path in index at stage
 692         */
 693        if (name[0] == ':') {
 694                int stage = 0;
 695                struct cache_entry *ce;
 696                int pos;
 697                if (namelen > 2 && name[1] == '/')
 698                        return get_sha1_oneline(name + 2, sha1);
 699                if (namelen < 3 ||
 700                    name[2] != ':' ||
 701                    name[1] < '0' || '3' < name[1])
 702                        cp = name + 1;
 703                else {
 704                        stage = name[1] - '0';
 705                        cp = name + 3;
 706                }
 707                namelen = namelen - (cp - name);
 708                if (!active_cache)
 709                        read_cache();
 710                pos = cache_name_pos(cp, namelen);
 711                if (pos < 0)
 712                        pos = -pos - 1;
 713                while (pos < active_nr) {
 714                        ce = active_cache[pos];
 715                        if (ce_namelen(ce) != namelen ||
 716                            memcmp(ce->name, cp, namelen))
 717                                break;
 718                        if (ce_stage(ce) == stage) {
 719                                hashcpy(sha1, ce->sha1);
 720                                *mode = ce->ce_mode;
 721                                return 0;
 722                        }
 723                        pos++;
 724                }
 725                return -1;
 726        }
 727        for (cp = name, bracket_depth = 0; *cp; cp++) {
 728                if (*cp == '{')
 729                        bracket_depth++;
 730                else if (bracket_depth && *cp == '}')
 731                        bracket_depth--;
 732                else if (!bracket_depth && *cp == ':')
 733                        break;
 734        }
 735        if (*cp == ':') {
 736                unsigned char tree_sha1[20];
 737                if (!get_sha1_1(name, cp-name, tree_sha1))
 738                        return get_tree_entry(tree_sha1, cp+1, sha1,
 739                                              mode);
 740        }
 741        return ret;
 742}