doc: add 'everyday' to 'git help'
[git] / shallow.c
1 #include "cache.h"
2 #include "commit.h"
3 #include "tag.h"
4 #include "pkt-line.h"
5 #include "remote.h"
6 #include "refs.h"
7 #include "sha1-array.h"
8 #include "diff.h"
9 #include "revision.h"
10 #include "commit-slab.h"
11 #include "sigchain.h"
12
13 static int is_shallow = -1;
14 static struct stat_validity shallow_stat;
15 static char *alternate_shallow_file;
16
17 void set_alternate_shallow_file(const char *path, int override)
18 {
19         if (is_shallow != -1)
20                 die("BUG: is_repository_shallow must not be called before set_alternate_shallow_file");
21         if (alternate_shallow_file && !override)
22                 return;
23         free(alternate_shallow_file);
24         alternate_shallow_file = path ? xstrdup(path) : NULL;
25 }
26
27 int register_shallow(const unsigned char *sha1)
28 {
29         struct commit_graft *graft =
30                 xmalloc(sizeof(struct commit_graft));
31         struct commit *commit = lookup_commit(sha1);
32
33         hashcpy(graft->sha1, sha1);
34         graft->nr_parent = -1;
35         if (commit && commit->object.parsed)
36                 commit->parents = NULL;
37         return register_commit_graft(graft, 0);
38 }
39
40 int is_repository_shallow(void)
41 {
42         FILE *fp;
43         char buf[1024];
44         const char *path = alternate_shallow_file;
45
46         if (is_shallow >= 0)
47                 return is_shallow;
48
49         if (!path)
50                 path = git_path("shallow");
51         /*
52          * fetch-pack sets '--shallow-file ""' as an indicator that no
53          * shallow file should be used. We could just open it and it
54          * will likely fail. But let's do an explicit check instead.
55          */
56         if (!*path || (fp = fopen(path, "r")) == NULL) {
57                 stat_validity_clear(&shallow_stat);
58                 is_shallow = 0;
59                 return is_shallow;
60         }
61         stat_validity_update(&shallow_stat, fileno(fp));
62         is_shallow = 1;
63
64         while (fgets(buf, sizeof(buf), fp)) {
65                 unsigned char sha1[20];
66                 if (get_sha1_hex(buf, sha1))
67                         die("bad shallow line: %s", buf);
68                 register_shallow(sha1);
69         }
70         fclose(fp);
71         return is_shallow;
72 }
73
74 struct commit_list *get_shallow_commits(struct object_array *heads, int depth,
75                 int shallow_flag, int not_shallow_flag)
76 {
77         int i = 0, cur_depth = 0;
78         struct commit_list *result = NULL;
79         struct object_array stack = OBJECT_ARRAY_INIT;
80         struct commit *commit = NULL;
81         struct commit_graft *graft;
82
83         while (commit || i < heads->nr || stack.nr) {
84                 struct commit_list *p;
85                 if (!commit) {
86                         if (i < heads->nr) {
87                                 commit = (struct commit *)
88                                         deref_tag(heads->objects[i++].item, NULL, 0);
89                                 if (!commit || commit->object.type != OBJ_COMMIT) {
90                                         commit = NULL;
91                                         continue;
92                                 }
93                                 if (!commit->util)
94                                         commit->util = xmalloc(sizeof(int));
95                                 *(int *)commit->util = 0;
96                                 cur_depth = 0;
97                         } else {
98                                 commit = (struct commit *)
99                                         stack.objects[--stack.nr].item;
100                                 cur_depth = *(int *)commit->util;
101                         }
102                 }
103                 parse_commit_or_die(commit);
104                 cur_depth++;
105                 if ((depth != INFINITE_DEPTH && cur_depth >= depth) ||
106                     (is_repository_shallow() && !commit->parents &&
107                      (graft = lookup_commit_graft(commit->object.sha1)) != NULL &&
108                      graft->nr_parent < 0)) {
109                         commit_list_insert(commit, &result);
110                         commit->object.flags |= shallow_flag;
111                         commit = NULL;
112                         continue;
113                 }
114                 commit->object.flags |= not_shallow_flag;
115                 for (p = commit->parents, commit = NULL; p; p = p->next) {
116                         if (!p->item->util) {
117                                 int *pointer = xmalloc(sizeof(int));
118                                 p->item->util = pointer;
119                                 *pointer =  cur_depth;
120                         } else {
121                                 int *pointer = p->item->util;
122                                 if (cur_depth >= *pointer)
123                                         continue;
124                                 *pointer = cur_depth;
125                         }
126                         if (p->next)
127                                 add_object_array(&p->item->object,
128                                                 NULL, &stack);
129                         else {
130                                 commit = p->item;
131                                 cur_depth = *(int *)commit->util;
132                         }
133                 }
134         }
135
136         return result;
137 }
138
139 void check_shallow_file_for_update(void)
140 {
141         if (is_shallow == -1)
142                 die("BUG: shallow must be initialized by now");
143
144         if (!stat_validity_check(&shallow_stat, git_path("shallow")))
145                 die("shallow file has changed since we read it");
146 }
147
148 #define SEEN_ONLY 1
149 #define VERBOSE   2
150
151 struct write_shallow_data {
152         struct strbuf *out;
153         int use_pack_protocol;
154         int count;
155         unsigned flags;
156 };
157
158 static int write_one_shallow(const struct commit_graft *graft, void *cb_data)
159 {
160         struct write_shallow_data *data = cb_data;
161         const char *hex = sha1_to_hex(graft->sha1);
162         if (graft->nr_parent != -1)
163                 return 0;
164         if (data->flags & SEEN_ONLY) {
165                 struct commit *c = lookup_commit(graft->sha1);
166                 if (!c || !(c->object.flags & SEEN)) {
167                         if (data->flags & VERBOSE)
168                                 printf("Removing %s from .git/shallow\n",
169                                        sha1_to_hex(c->object.sha1));
170                         return 0;
171                 }
172         }
173         data->count++;
174         if (data->use_pack_protocol)
175                 packet_buf_write(data->out, "shallow %s", hex);
176         else {
177                 strbuf_addstr(data->out, hex);
178                 strbuf_addch(data->out, '\n');
179         }
180         return 0;
181 }
182
183 static int write_shallow_commits_1(struct strbuf *out, int use_pack_protocol,
184                                    const struct sha1_array *extra,
185                                    unsigned flags)
186 {
187         struct write_shallow_data data;
188         int i;
189         data.out = out;
190         data.use_pack_protocol = use_pack_protocol;
191         data.count = 0;
192         data.flags = flags;
193         for_each_commit_graft(write_one_shallow, &data);
194         if (!extra)
195                 return data.count;
196         for (i = 0; i < extra->nr; i++) {
197                 strbuf_addstr(out, sha1_to_hex(extra->sha1[i]));
198                 strbuf_addch(out, '\n');
199                 data.count++;
200         }
201         return data.count;
202 }
203
204 int write_shallow_commits(struct strbuf *out, int use_pack_protocol,
205                           const struct sha1_array *extra)
206 {
207         return write_shallow_commits_1(out, use_pack_protocol, extra, 0);
208 }
209
210 static struct strbuf temporary_shallow = STRBUF_INIT;
211
212 static void remove_temporary_shallow(void)
213 {
214         if (temporary_shallow.len) {
215                 unlink_or_warn(temporary_shallow.buf);
216                 strbuf_reset(&temporary_shallow);
217         }
218 }
219
220 static void remove_temporary_shallow_on_signal(int signo)
221 {
222         remove_temporary_shallow();
223         sigchain_pop(signo);
224         raise(signo);
225 }
226
227 const char *setup_temporary_shallow(const struct sha1_array *extra)
228 {
229         static int installed_handler;
230         struct strbuf sb = STRBUF_INIT;
231         int fd;
232
233         if (temporary_shallow.len)
234                 die("BUG: attempt to create two temporary shallow files");
235
236         if (write_shallow_commits(&sb, 0, extra)) {
237                 strbuf_addstr(&temporary_shallow, git_path("shallow_XXXXXX"));
238                 fd = xmkstemp(temporary_shallow.buf);
239
240                 if (!installed_handler) {
241                         atexit(remove_temporary_shallow);
242                         sigchain_push_common(remove_temporary_shallow_on_signal);
243                 }
244
245                 if (write_in_full(fd, sb.buf, sb.len) != sb.len)
246                         die_errno("failed to write to %s",
247                                   temporary_shallow.buf);
248                 close(fd);
249                 strbuf_release(&sb);
250                 return temporary_shallow.buf;
251         }
252         /*
253          * is_repository_shallow() sees empty string as "no shallow
254          * file".
255          */
256         return temporary_shallow.buf;
257 }
258
259 void setup_alternate_shallow(struct lock_file *shallow_lock,
260                              const char **alternate_shallow_file,
261                              const struct sha1_array *extra)
262 {
263         struct strbuf sb = STRBUF_INIT;
264         int fd;
265
266         fd = hold_lock_file_for_update(shallow_lock, git_path("shallow"),
267                                        LOCK_DIE_ON_ERROR);
268         check_shallow_file_for_update();
269         if (write_shallow_commits(&sb, 0, extra)) {
270                 if (write_in_full(fd, sb.buf, sb.len) != sb.len)
271                         die_errno("failed to write to %s",
272                                   shallow_lock->filename);
273                 *alternate_shallow_file = shallow_lock->filename;
274         } else
275                 /*
276                  * is_repository_shallow() sees empty string as "no
277                  * shallow file".
278                  */
279                 *alternate_shallow_file = "";
280         strbuf_release(&sb);
281 }
282
283 static int advertise_shallow_grafts_cb(const struct commit_graft *graft, void *cb)
284 {
285         int fd = *(int *)cb;
286         if (graft->nr_parent == -1)
287                 packet_write(fd, "shallow %s\n", sha1_to_hex(graft->sha1));
288         return 0;
289 }
290
291 void advertise_shallow_grafts(int fd)
292 {
293         if (!is_repository_shallow())
294                 return;
295         for_each_commit_graft(advertise_shallow_grafts_cb, &fd);
296 }
297
298 /*
299  * mark_reachable_objects() should have been run prior to this and all
300  * reachable commits marked as "SEEN".
301  */
302 void prune_shallow(int show_only)
303 {
304         static struct lock_file shallow_lock;
305         struct strbuf sb = STRBUF_INIT;
306         int fd;
307
308         if (show_only) {
309                 write_shallow_commits_1(&sb, 0, NULL, SEEN_ONLY | VERBOSE);
310                 strbuf_release(&sb);
311                 return;
312         }
313         fd = hold_lock_file_for_update(&shallow_lock, git_path("shallow"),
314                                        LOCK_DIE_ON_ERROR);
315         check_shallow_file_for_update();
316         if (write_shallow_commits_1(&sb, 0, NULL, SEEN_ONLY)) {
317                 if (write_in_full(fd, sb.buf, sb.len) != sb.len)
318                         die_errno("failed to write to %s",
319                                   shallow_lock.filename);
320                 commit_lock_file(&shallow_lock);
321         } else {
322                 unlink(git_path("shallow"));
323                 rollback_lock_file(&shallow_lock);
324         }
325         strbuf_release(&sb);
326 }
327
328 struct trace_key trace_shallow = TRACE_KEY_INIT(SHALLOW);
329
330 /*
331  * Step 1, split sender shallow commits into "ours" and "theirs"
332  * Step 2, clean "ours" based on .git/shallow
333  */
334 void prepare_shallow_info(struct shallow_info *info, struct sha1_array *sa)
335 {
336         int i;
337         trace_printf_key(&trace_shallow, "shallow: prepare_shallow_info\n");
338         memset(info, 0, sizeof(*info));
339         info->shallow = sa;
340         if (!sa)
341                 return;
342         info->ours = xmalloc(sizeof(*info->ours) * sa->nr);
343         info->theirs = xmalloc(sizeof(*info->theirs) * sa->nr);
344         for (i = 0; i < sa->nr; i++) {
345                 if (has_sha1_file(sa->sha1[i])) {
346                         struct commit_graft *graft;
347                         graft = lookup_commit_graft(sa->sha1[i]);
348                         if (graft && graft->nr_parent < 0)
349                                 continue;
350                         info->ours[info->nr_ours++] = i;
351                 } else
352                         info->theirs[info->nr_theirs++] = i;
353         }
354 }
355
356 void clear_shallow_info(struct shallow_info *info)
357 {
358         free(info->ours);
359         free(info->theirs);
360 }
361
362 /* Step 4, remove non-existent ones in "theirs" after getting the pack */
363
364 void remove_nonexistent_theirs_shallow(struct shallow_info *info)
365 {
366         unsigned char (*sha1)[20] = info->shallow->sha1;
367         int i, dst;
368         trace_printf_key(&trace_shallow, "shallow: remove_nonexistent_theirs_shallow\n");
369         for (i = dst = 0; i < info->nr_theirs; i++) {
370                 if (i != dst)
371                         info->theirs[dst] = info->theirs[i];
372                 if (has_sha1_file(sha1[info->theirs[i]]))
373                         dst++;
374         }
375         info->nr_theirs = dst;
376 }
377
378 define_commit_slab(ref_bitmap, uint32_t *);
379
380 struct paint_info {
381         struct ref_bitmap ref_bitmap;
382         unsigned nr_bits;
383         char **slab;
384         char *free, *end;
385         unsigned slab_count;
386 };
387
388 static uint32_t *paint_alloc(struct paint_info *info)
389 {
390         unsigned nr = (info->nr_bits + 31) / 32;
391         unsigned size = nr * sizeof(uint32_t);
392         void *p;
393         if (!info->slab_count || info->free + size > info->end) {
394                 info->slab_count++;
395                 REALLOC_ARRAY(info->slab, info->slab_count);
396                 info->free = xmalloc(COMMIT_SLAB_SIZE);
397                 info->slab[info->slab_count - 1] = info->free;
398                 info->end = info->free + COMMIT_SLAB_SIZE;
399         }
400         p = info->free;
401         info->free += size;
402         return p;
403 }
404
405 /*
406  * Given a commit SHA-1, walk down to parents until either SEEN,
407  * UNINTERESTING or BOTTOM is hit. Set the id-th bit in ref_bitmap for
408  * all walked commits.
409  */
410 static void paint_down(struct paint_info *info, const unsigned char *sha1,
411                        int id)
412 {
413         unsigned int i, nr;
414         struct commit_list *head = NULL;
415         int bitmap_nr = (info->nr_bits + 31) / 32;
416         int bitmap_size = bitmap_nr * sizeof(uint32_t);
417         uint32_t *tmp = xmalloc(bitmap_size); /* to be freed before return */
418         uint32_t *bitmap = paint_alloc(info);
419         struct commit *c = lookup_commit_reference_gently(sha1, 1);
420         if (!c)
421                 return;
422         memset(bitmap, 0, bitmap_size);
423         bitmap[id / 32] |= (1 << (id % 32));
424         commit_list_insert(c, &head);
425         while (head) {
426                 struct commit_list *p;
427                 struct commit *c = head->item;
428                 uint32_t **refs = ref_bitmap_at(&info->ref_bitmap, c);
429
430                 p = head;
431                 head = head->next;
432                 free(p);
433
434                 /* XXX check "UNINTERESTING" from pack bitmaps if available */
435                 if (c->object.flags & (SEEN | UNINTERESTING))
436                         continue;
437                 else
438                         c->object.flags |= SEEN;
439
440                 if (*refs == NULL)
441                         *refs = bitmap;
442                 else {
443                         memcpy(tmp, *refs, bitmap_size);
444                         for (i = 0; i < bitmap_nr; i++)
445                                 tmp[i] |= bitmap[i];
446                         if (memcmp(tmp, *refs, bitmap_size)) {
447                                 *refs = paint_alloc(info);
448                                 memcpy(*refs, tmp, bitmap_size);
449                         }
450                 }
451
452                 if (c->object.flags & BOTTOM)
453                         continue;
454
455                 if (parse_commit(c))
456                         die("unable to parse commit %s",
457                             sha1_to_hex(c->object.sha1));
458
459                 for (p = c->parents; p; p = p->next) {
460                         uint32_t **p_refs = ref_bitmap_at(&info->ref_bitmap,
461                                                           p->item);
462                         if (p->item->object.flags & SEEN)
463                                 continue;
464                         if (*p_refs == NULL || *p_refs == *refs)
465                                 *p_refs = *refs;
466                         commit_list_insert(p->item, &head);
467                 }
468         }
469
470         nr = get_max_object_index();
471         for (i = 0; i < nr; i++) {
472                 struct object *o = get_indexed_object(i);
473                 if (o && o->type == OBJ_COMMIT)
474                         o->flags &= ~SEEN;
475         }
476
477         free(tmp);
478 }
479
480 static int mark_uninteresting(const char *refname,
481                               const unsigned char *sha1,
482                               int flags, void *cb_data)
483 {
484         struct commit *commit = lookup_commit_reference_gently(sha1, 1);
485         if (!commit)
486                 return 0;
487         commit->object.flags |= UNINTERESTING;
488         mark_parents_uninteresting(commit);
489         return 0;
490 }
491
492 static void post_assign_shallow(struct shallow_info *info,
493                                 struct ref_bitmap *ref_bitmap,
494                                 int *ref_status);
495 /*
496  * Step 6(+7), associate shallow commits with new refs
497  *
498  * info->ref must be initialized before calling this function.
499  *
500  * If used is not NULL, it's an array of info->shallow->nr
501  * bitmaps. The n-th bit set in the m-th bitmap if ref[n] needs the
502  * m-th shallow commit from info->shallow.
503  *
504  * If used is NULL, "ours" and "theirs" are updated. And if ref_status
505  * is not NULL it's an array of ref->nr ints. ref_status[i] is true if
506  * the ref needs some shallow commits from either info->ours or
507  * info->theirs.
508  */
509 void assign_shallow_commits_to_refs(struct shallow_info *info,
510                                     uint32_t **used, int *ref_status)
511 {
512         unsigned char (*sha1)[20] = info->shallow->sha1;
513         struct sha1_array *ref = info->ref;
514         unsigned int i, nr;
515         int *shallow, nr_shallow = 0;
516         struct paint_info pi;
517
518         trace_printf_key(&trace_shallow, "shallow: assign_shallow_commits_to_refs\n");
519         shallow = xmalloc(sizeof(*shallow) * (info->nr_ours + info->nr_theirs));
520         for (i = 0; i < info->nr_ours; i++)
521                 shallow[nr_shallow++] = info->ours[i];
522         for (i = 0; i < info->nr_theirs; i++)
523                 shallow[nr_shallow++] = info->theirs[i];
524
525         /*
526          * Prepare the commit graph to track what refs can reach what
527          * (new) shallow commits.
528          */
529         nr = get_max_object_index();
530         for (i = 0; i < nr; i++) {
531                 struct object *o = get_indexed_object(i);
532                 if (!o || o->type != OBJ_COMMIT)
533                         continue;
534
535                 o->flags &= ~(UNINTERESTING | BOTTOM | SEEN);
536         }
537
538         memset(&pi, 0, sizeof(pi));
539         init_ref_bitmap(&pi.ref_bitmap);
540         pi.nr_bits = ref->nr;
541
542         /*
543          * "--not --all" to cut short the traversal if new refs
544          * connect to old refs. If not (e.g. force ref updates) it'll
545          * have to go down to the current shallow commits.
546          */
547         head_ref(mark_uninteresting, NULL);
548         for_each_ref(mark_uninteresting, NULL);
549
550         /* Mark potential bottoms so we won't go out of bound */
551         for (i = 0; i < nr_shallow; i++) {
552                 struct commit *c = lookup_commit(sha1[shallow[i]]);
553                 c->object.flags |= BOTTOM;
554         }
555
556         for (i = 0; i < ref->nr; i++)
557                 paint_down(&pi, ref->sha1[i], i);
558
559         if (used) {
560                 int bitmap_size = ((pi.nr_bits + 31) / 32) * sizeof(uint32_t);
561                 memset(used, 0, sizeof(*used) * info->shallow->nr);
562                 for (i = 0; i < nr_shallow; i++) {
563                         const struct commit *c = lookup_commit(sha1[shallow[i]]);
564                         uint32_t **map = ref_bitmap_at(&pi.ref_bitmap, c);
565                         if (*map)
566                                 used[shallow[i]] = xmemdupz(*map, bitmap_size);
567                 }
568                 /*
569                  * unreachable shallow commits are not removed from
570                  * "ours" and "theirs". The user is supposed to run
571                  * step 7 on every ref separately and not trust "ours"
572                  * and "theirs" any more.
573                  */
574         } else
575                 post_assign_shallow(info, &pi.ref_bitmap, ref_status);
576
577         clear_ref_bitmap(&pi.ref_bitmap);
578         for (i = 0; i < pi.slab_count; i++)
579                 free(pi.slab[i]);
580         free(pi.slab);
581         free(shallow);
582 }
583
584 struct commit_array {
585         struct commit **commits;
586         int nr, alloc;
587 };
588
589 static int add_ref(const char *refname,
590                    const unsigned char *sha1, int flags, void *cb_data)
591 {
592         struct commit_array *ca = cb_data;
593         ALLOC_GROW(ca->commits, ca->nr + 1, ca->alloc);
594         ca->commits[ca->nr] = lookup_commit_reference_gently(sha1, 1);
595         if (ca->commits[ca->nr])
596                 ca->nr++;
597         return 0;
598 }
599
600 static void update_refstatus(int *ref_status, int nr, uint32_t *bitmap)
601 {
602         int i;
603         if (!ref_status)
604                 return;
605         for (i = 0; i < nr; i++)
606                 if (bitmap[i / 32] & (1 << (i % 32)))
607                         ref_status[i]++;
608 }
609
610 /*
611  * Step 7, reachability test on "ours" at commit level
612  */
613 static void post_assign_shallow(struct shallow_info *info,
614                                 struct ref_bitmap *ref_bitmap,
615                                 int *ref_status)
616 {
617         unsigned char (*sha1)[20] = info->shallow->sha1;
618         struct commit *c;
619         uint32_t **bitmap;
620         int dst, i, j;
621         int bitmap_nr = (info->ref->nr + 31) / 32;
622         struct commit_array ca;
623
624         trace_printf_key(&trace_shallow, "shallow: post_assign_shallow\n");
625         if (ref_status)
626                 memset(ref_status, 0, sizeof(*ref_status) * info->ref->nr);
627
628         /* Remove unreachable shallow commits from "theirs" */
629         for (i = dst = 0; i < info->nr_theirs; i++) {
630                 if (i != dst)
631                         info->theirs[dst] = info->theirs[i];
632                 c = lookup_commit(sha1[info->theirs[i]]);
633                 bitmap = ref_bitmap_at(ref_bitmap, c);
634                 if (!*bitmap)
635                         continue;
636                 for (j = 0; j < bitmap_nr; j++)
637                         if (bitmap[0][j]) {
638                                 update_refstatus(ref_status, info->ref->nr, *bitmap);
639                                 dst++;
640                                 break;
641                         }
642         }
643         info->nr_theirs = dst;
644
645         memset(&ca, 0, sizeof(ca));
646         head_ref(add_ref, &ca);
647         for_each_ref(add_ref, &ca);
648
649         /* Remove unreachable shallow commits from "ours" */
650         for (i = dst = 0; i < info->nr_ours; i++) {
651                 if (i != dst)
652                         info->ours[dst] = info->ours[i];
653                 c = lookup_commit(sha1[info->ours[i]]);
654                 bitmap = ref_bitmap_at(ref_bitmap, c);
655                 if (!*bitmap)
656                         continue;
657                 for (j = 0; j < bitmap_nr; j++)
658                         if (bitmap[0][j] &&
659                             /* Step 7, reachability test at commit level */
660                             !in_merge_bases_many(c, ca.nr, ca.commits)) {
661                                 update_refstatus(ref_status, info->ref->nr, *bitmap);
662                                 dst++;
663                                 break;
664                         }
665         }
666         info->nr_ours = dst;
667
668         free(ca.commits);
669 }
670
671 /* (Delayed) step 7, reachability test at commit level */
672 int delayed_reachability_test(struct shallow_info *si, int c)
673 {
674         if (si->need_reachability_test[c]) {
675                 struct commit *commit = lookup_commit(si->shallow->sha1[c]);
676
677                 if (!si->commits) {
678                         struct commit_array ca;
679                         memset(&ca, 0, sizeof(ca));
680                         head_ref(add_ref, &ca);
681                         for_each_ref(add_ref, &ca);
682                         si->commits = ca.commits;
683                         si->nr_commits = ca.nr;
684                 }
685
686                 si->reachable[c] = in_merge_bases_many(commit,
687                                                        si->nr_commits,
688                                                        si->commits);
689                 si->need_reachability_test[c] = 0;
690         }
691         return si->reachable[c];
692 }