1#include "cache.h"
2#include "tag.h"
3#include "commit.h"
4#include "pkt-line.h"
5#include "utf8.h"
6#include "diff.h"
7#include "revision.h"
8#include "notes.h"
9#include "gpg-interface.h"
10#include "mergesort.h"
11#include "commit-slab.h"
12#include "prio-queue.h"
13#include "sha1-lookup.h"
14
15static struct commit_extra_header *read_commit_extra_header_lines(const char *buf, size_t len, const char **);
16
17int save_commit_buffer = 1;
18
19const char *commit_type = "commit";
20static int commit_count;
21
22static struct commit *check_commit(struct object *obj,
23 const unsigned char *sha1,
24 int quiet)
25{
26 if (obj->type != OBJ_COMMIT) {
27 if (!quiet)
28 error("Object %s is a %s, not a commit",
29 sha1_to_hex(sha1), typename(obj->type));
30 return NULL;
31 }
32 return (struct commit *) obj;
33}
34
35struct commit *lookup_commit_reference_gently(const unsigned char *sha1,
36 int quiet)
37{
38 struct object *obj = deref_tag(parse_object(sha1), NULL, 0);
39
40 if (!obj)
41 return NULL;
42 return check_commit(obj, sha1, quiet);
43}
44
45struct commit *lookup_commit_reference(const unsigned char *sha1)
46{
47 return lookup_commit_reference_gently(sha1, 0);
48}
49
50struct commit *lookup_commit_or_die(const unsigned char *sha1, const char *ref_name)
51{
52 struct commit *c = lookup_commit_reference(sha1);
53 if (!c)
54 die(_("could not parse %s"), ref_name);
55 if (hashcmp(sha1, c->object.sha1)) {
56 warning(_("%s %s is not a commit!"),
57 ref_name, sha1_to_hex(sha1));
58 }
59 return c;
60}
61
62struct commit *lookup_commit(const unsigned char *sha1)
63{
64 struct object *obj = lookup_object(sha1);
65 if (!obj) {
66 struct commit *c = alloc_commit_node();
67 c->index = commit_count++;
68 return create_object(sha1, OBJ_COMMIT, c);
69 }
70 if (!obj->type)
71 obj->type = OBJ_COMMIT;
72 return check_commit(obj, sha1, 0);
73}
74
75struct commit *lookup_commit_reference_by_name(const char *name)
76{
77 unsigned char sha1[20];
78 struct commit *commit;
79
80 if (get_sha1_committish(name, sha1))
81 return NULL;
82 commit = lookup_commit_reference(sha1);
83 if (parse_commit(commit))
84 return NULL;
85 return commit;
86}
87
88static unsigned long parse_commit_date(const char *buf, const char *tail)
89{
90 const char *dateptr;
91
92 if (buf + 6 >= tail)
93 return 0;
94 if (memcmp(buf, "author", 6))
95 return 0;
96 while (buf < tail && *buf++ != '\n')
97 /* nada */;
98 if (buf + 9 >= tail)
99 return 0;
100 if (memcmp(buf, "committer", 9))
101 return 0;
102 while (buf < tail && *buf++ != '>')
103 /* nada */;
104 if (buf >= tail)
105 return 0;
106 dateptr = buf;
107 while (buf < tail && *buf++ != '\n')
108 /* nada */;
109 if (buf >= tail)
110 return 0;
111 /* dateptr < buf && buf[-1] == '\n', so strtoul will stop at buf-1 */
112 return strtoul(dateptr, NULL, 10);
113}
114
115static struct commit_graft **commit_graft;
116static int commit_graft_alloc, commit_graft_nr;
117
118static const unsigned char *commit_graft_sha1_access(size_t index, void *table)
119{
120 struct commit_graft **commit_graft_table = table;
121 return commit_graft_table[index]->sha1;
122}
123
124static int commit_graft_pos(const unsigned char *sha1)
125{
126 return sha1_pos(sha1, commit_graft, commit_graft_nr,
127 commit_graft_sha1_access);
128}
129
130int register_commit_graft(struct commit_graft *graft, int ignore_dups)
131{
132 int pos = commit_graft_pos(graft->sha1);
133
134 if (0 <= pos) {
135 if (ignore_dups)
136 free(graft);
137 else {
138 free(commit_graft[pos]);
139 commit_graft[pos] = graft;
140 }
141 return 1;
142 }
143 pos = -pos - 1;
144 ALLOC_GROW(commit_graft, commit_graft_nr + 1, commit_graft_alloc);
145 commit_graft_nr++;
146 if (pos < commit_graft_nr)
147 memmove(commit_graft + pos + 1,
148 commit_graft + pos,
149 (commit_graft_nr - pos - 1) *
150 sizeof(*commit_graft));
151 commit_graft[pos] = graft;
152 return 0;
153}
154
155struct commit_graft *read_graft_line(char *buf, int len)
156{
157 /* The format is just "Commit Parent1 Parent2 ...\n" */
158 int i;
159 struct commit_graft *graft = NULL;
160
161 while (len && isspace(buf[len-1]))
162 buf[--len] = '\0';
163 if (buf[0] == '#' || buf[0] == '\0')
164 return NULL;
165 if ((len + 1) % 41)
166 goto bad_graft_data;
167 i = (len + 1) / 41 - 1;
168 graft = xmalloc(sizeof(*graft) + 20 * i);
169 graft->nr_parent = i;
170 if (get_sha1_hex(buf, graft->sha1))
171 goto bad_graft_data;
172 for (i = 40; i < len; i += 41) {
173 if (buf[i] != ' ')
174 goto bad_graft_data;
175 if (get_sha1_hex(buf + i + 1, graft->parent[i/41]))
176 goto bad_graft_data;
177 }
178 return graft;
179
180bad_graft_data:
181 error("bad graft data: %s", buf);
182 free(graft);
183 return NULL;
184}
185
186static int read_graft_file(const char *graft_file)
187{
188 FILE *fp = fopen(graft_file, "r");
189 struct strbuf buf = STRBUF_INIT;
190 if (!fp)
191 return -1;
192 while (!strbuf_getwholeline(&buf, fp, '\n')) {
193 /* The format is just "Commit Parent1 Parent2 ...\n" */
194 struct commit_graft *graft = read_graft_line(buf.buf, buf.len);
195 if (!graft)
196 continue;
197 if (register_commit_graft(graft, 1))
198 error("duplicate graft data: %s", buf.buf);
199 }
200 fclose(fp);
201 strbuf_release(&buf);
202 return 0;
203}
204
205static void prepare_commit_graft(void)
206{
207 static int commit_graft_prepared;
208 char *graft_file;
209
210 if (commit_graft_prepared)
211 return;
212 graft_file = get_graft_file();
213 read_graft_file(graft_file);
214 /* make sure shallows are read */
215 is_repository_shallow();
216 commit_graft_prepared = 1;
217}
218
219struct commit_graft *lookup_commit_graft(const unsigned char *sha1)
220{
221 int pos;
222 prepare_commit_graft();
223 pos = commit_graft_pos(sha1);
224 if (pos < 0)
225 return NULL;
226 return commit_graft[pos];
227}
228
229int for_each_commit_graft(each_commit_graft_fn fn, void *cb_data)
230{
231 int i, ret;
232 for (i = ret = 0; i < commit_graft_nr && !ret; i++)
233 ret = fn(commit_graft[i], cb_data);
234 return ret;
235}
236
237int unregister_shallow(const unsigned char *sha1)
238{
239 int pos = commit_graft_pos(sha1);
240 if (pos < 0)
241 return -1;
242 if (pos + 1 < commit_graft_nr)
243 memmove(commit_graft + pos, commit_graft + pos + 1,
244 sizeof(struct commit_graft *)
245 * (commit_graft_nr - pos - 1));
246 commit_graft_nr--;
247 return 0;
248}
249
250int parse_commit_buffer(struct commit *item, const void *buffer, unsigned long size)
251{
252 const char *tail = buffer;
253 const char *bufptr = buffer;
254 unsigned char parent[20];
255 struct commit_list **pptr;
256 struct commit_graft *graft;
257
258 if (item->object.parsed)
259 return 0;
260 item->object.parsed = 1;
261 tail += size;
262 if (tail <= bufptr + 46 || memcmp(bufptr, "tree ", 5) || bufptr[45] != '\n')
263 return error("bogus commit object %s", sha1_to_hex(item->object.sha1));
264 if (get_sha1_hex(bufptr + 5, parent) < 0)
265 return error("bad tree pointer in commit %s",
266 sha1_to_hex(item->object.sha1));
267 item->tree = lookup_tree(parent);
268 bufptr += 46; /* "tree " + "hex sha1" + "\n" */
269 pptr = &item->parents;
270
271 graft = lookup_commit_graft(item->object.sha1);
272 while (bufptr + 48 < tail && !memcmp(bufptr, "parent ", 7)) {
273 struct commit *new_parent;
274
275 if (tail <= bufptr + 48 ||
276 get_sha1_hex(bufptr + 7, parent) ||
277 bufptr[47] != '\n')
278 return error("bad parents in commit %s", sha1_to_hex(item->object.sha1));
279 bufptr += 48;
280 /*
281 * The clone is shallow if nr_parent < 0, and we must
282 * not traverse its real parents even when we unhide them.
283 */
284 if (graft && (graft->nr_parent < 0 || grafts_replace_parents))
285 continue;
286 new_parent = lookup_commit(parent);
287 if (new_parent)
288 pptr = &commit_list_insert(new_parent, pptr)->next;
289 }
290 if (graft) {
291 int i;
292 struct commit *new_parent;
293 for (i = 0; i < graft->nr_parent; i++) {
294 new_parent = lookup_commit(graft->parent[i]);
295 if (!new_parent)
296 continue;
297 pptr = &commit_list_insert(new_parent, pptr)->next;
298 }
299 }
300 item->date = parse_commit_date(bufptr, tail);
301
302 return 0;
303}
304
305int parse_commit(struct commit *item)
306{
307 enum object_type type;
308 void *buffer;
309 unsigned long size;
310 int ret;
311
312 if (!item)
313 return -1;
314 if (item->object.parsed)
315 return 0;
316 buffer = read_sha1_file(item->object.sha1, &type, &size);
317 if (!buffer)
318 return error("Could not read %s",
319 sha1_to_hex(item->object.sha1));
320 if (type != OBJ_COMMIT) {
321 free(buffer);
322 return error("Object %s not a commit",
323 sha1_to_hex(item->object.sha1));
324 }
325 ret = parse_commit_buffer(item, buffer, size);
326 if (save_commit_buffer && !ret) {
327 item->buffer = buffer;
328 return 0;
329 }
330 free(buffer);
331 return ret;
332}
333
334void parse_commit_or_die(struct commit *item)
335{
336 if (parse_commit(item))
337 die("unable to parse commit %s",
338 item ? sha1_to_hex(item->object.sha1) : "(null)");
339}
340
341int find_commit_subject(const char *commit_buffer, const char **subject)
342{
343 const char *eol;
344 const char *p = commit_buffer;
345
346 while (*p && (*p != '\n' || p[1] != '\n'))
347 p++;
348 if (*p) {
349 p += 2;
350 for (eol = p; *eol && *eol != '\n'; eol++)
351 ; /* do nothing */
352 } else
353 eol = p;
354
355 *subject = p;
356
357 return eol - p;
358}
359
360struct commit_list *commit_list_insert(struct commit *item, struct commit_list **list_p)
361{
362 struct commit_list *new_list = xmalloc(sizeof(struct commit_list));
363 new_list->item = item;
364 new_list->next = *list_p;
365 *list_p = new_list;
366 return new_list;
367}
368
369unsigned commit_list_count(const struct commit_list *l)
370{
371 unsigned c = 0;
372 for (; l; l = l->next )
373 c++;
374 return c;
375}
376
377struct commit_list *copy_commit_list(struct commit_list *list)
378{
379 struct commit_list *head = NULL;
380 struct commit_list **pp = &head;
381 while (list) {
382 struct commit_list *new;
383 new = xmalloc(sizeof(struct commit_list));
384 new->item = list->item;
385 new->next = NULL;
386 *pp = new;
387 pp = &new->next;
388 list = list->next;
389 }
390 return head;
391}
392
393void free_commit_list(struct commit_list *list)
394{
395 while (list) {
396 struct commit_list *temp = list;
397 list = temp->next;
398 free(temp);
399 }
400}
401
402struct commit_list * commit_list_insert_by_date(struct commit *item, struct commit_list **list)
403{
404 struct commit_list **pp = list;
405 struct commit_list *p;
406 while ((p = *pp) != NULL) {
407 if (p->item->date < item->date) {
408 break;
409 }
410 pp = &p->next;
411 }
412 return commit_list_insert(item, pp);
413}
414
415static int commit_list_compare_by_date(const void *a, const void *b)
416{
417 unsigned long a_date = ((const struct commit_list *)a)->item->date;
418 unsigned long b_date = ((const struct commit_list *)b)->item->date;
419 if (a_date < b_date)
420 return 1;
421 if (a_date > b_date)
422 return -1;
423 return 0;
424}
425
426static void *commit_list_get_next(const void *a)
427{
428 return ((const struct commit_list *)a)->next;
429}
430
431static void commit_list_set_next(void *a, void *next)
432{
433 ((struct commit_list *)a)->next = next;
434}
435
436void commit_list_sort_by_date(struct commit_list **list)
437{
438 *list = llist_mergesort(*list, commit_list_get_next, commit_list_set_next,
439 commit_list_compare_by_date);
440}
441
442struct commit *pop_most_recent_commit(struct commit_list **list,
443 unsigned int mark)
444{
445 struct commit *ret = (*list)->item;
446 struct commit_list *parents = ret->parents;
447 struct commit_list *old = *list;
448
449 *list = (*list)->next;
450 free(old);
451
452 while (parents) {
453 struct commit *commit = parents->item;
454 if (!parse_commit(commit) && !(commit->object.flags & mark)) {
455 commit->object.flags |= mark;
456 commit_list_insert_by_date(commit, list);
457 }
458 parents = parents->next;
459 }
460 return ret;
461}
462
463static void clear_commit_marks_1(struct commit_list **plist,
464 struct commit *commit, unsigned int mark)
465{
466 while (commit) {
467 struct commit_list *parents;
468
469 if (!(mark & commit->object.flags))
470 return;
471
472 commit->object.flags &= ~mark;
473
474 parents = commit->parents;
475 if (!parents)
476 return;
477
478 while ((parents = parents->next))
479 commit_list_insert(parents->item, plist);
480
481 commit = commit->parents->item;
482 }
483}
484
485void clear_commit_marks_many(int nr, struct commit **commit, unsigned int mark)
486{
487 struct commit_list *list = NULL;
488
489 while (nr--) {
490 commit_list_insert(*commit, &list);
491 commit++;
492 }
493 while (list)
494 clear_commit_marks_1(&list, pop_commit(&list), mark);
495}
496
497void clear_commit_marks(struct commit *commit, unsigned int mark)
498{
499 clear_commit_marks_many(1, &commit, mark);
500}
501
502void clear_commit_marks_for_object_array(struct object_array *a, unsigned mark)
503{
504 struct object *object;
505 struct commit *commit;
506 unsigned int i;
507
508 for (i = 0; i < a->nr; i++) {
509 object = a->objects[i].item;
510 commit = lookup_commit_reference_gently(object->sha1, 1);
511 if (commit)
512 clear_commit_marks(commit, mark);
513 }
514}
515
516struct commit *pop_commit(struct commit_list **stack)
517{
518 struct commit_list *top = *stack;
519 struct commit *item = top ? top->item : NULL;
520
521 if (top) {
522 *stack = top->next;
523 free(top);
524 }
525 return item;
526}
527
528/*
529 * Topological sort support
530 */
531
532/* count number of children that have not been emitted */
533define_commit_slab(indegree_slab, int);
534
535/* record author-date for each commit object */
536define_commit_slab(author_date_slab, unsigned long);
537
538static void record_author_date(struct author_date_slab *author_date,
539 struct commit *commit)
540{
541 const char *buf, *line_end, *ident_line;
542 char *buffer = NULL;
543 struct ident_split ident;
544 char *date_end;
545 unsigned long date;
546
547 if (!commit->buffer) {
548 unsigned long size;
549 enum object_type type;
550 buffer = read_sha1_file(commit->object.sha1, &type, &size);
551 if (!buffer)
552 return;
553 }
554
555 for (buf = commit->buffer ? commit->buffer : buffer;
556 buf;
557 buf = line_end + 1) {
558 line_end = strchrnul(buf, '\n');
559 ident_line = skip_prefix(buf, "author ");
560 if (!ident_line) {
561 if (!line_end[0] || line_end[1] == '\n')
562 return; /* end of header */
563 continue;
564 }
565 if (split_ident_line(&ident,
566 ident_line, line_end - ident_line) ||
567 !ident.date_begin || !ident.date_end)
568 goto fail_exit; /* malformed "author" line */
569 break;
570 }
571
572 date = strtoul(ident.date_begin, &date_end, 10);
573 if (date_end != ident.date_end)
574 goto fail_exit; /* malformed date */
575 *(author_date_slab_at(author_date, commit)) = date;
576
577fail_exit:
578 free(buffer);
579}
580
581static int compare_commits_by_author_date(const void *a_, const void *b_,
582 void *cb_data)
583{
584 const struct commit *a = a_, *b = b_;
585 struct author_date_slab *author_date = cb_data;
586 unsigned long a_date = *(author_date_slab_at(author_date, a));
587 unsigned long b_date = *(author_date_slab_at(author_date, b));
588
589 /* newer commits with larger date first */
590 if (a_date < b_date)
591 return 1;
592 else if (a_date > b_date)
593 return -1;
594 return 0;
595}
596
597int compare_commits_by_commit_date(const void *a_, const void *b_, void *unused)
598{
599 const struct commit *a = a_, *b = b_;
600 /* newer commits with larger date first */
601 if (a->date < b->date)
602 return 1;
603 else if (a->date > b->date)
604 return -1;
605 return 0;
606}
607
608/*
609 * Performs an in-place topological sort on the list supplied.
610 */
611void sort_in_topological_order(struct commit_list **list, enum rev_sort_order sort_order)
612{
613 struct commit_list *next, *orig = *list;
614 struct commit_list **pptr;
615 struct indegree_slab indegree;
616 struct prio_queue queue;
617 struct commit *commit;
618 struct author_date_slab author_date;
619
620 if (!orig)
621 return;
622 *list = NULL;
623
624 init_indegree_slab(&indegree);
625 memset(&queue, '\0', sizeof(queue));
626
627 switch (sort_order) {
628 default: /* REV_SORT_IN_GRAPH_ORDER */
629 queue.compare = NULL;
630 break;
631 case REV_SORT_BY_COMMIT_DATE:
632 queue.compare = compare_commits_by_commit_date;
633 break;
634 case REV_SORT_BY_AUTHOR_DATE:
635 init_author_date_slab(&author_date);
636 queue.compare = compare_commits_by_author_date;
637 queue.cb_data = &author_date;
638 break;
639 }
640
641 /* Mark them and clear the indegree */
642 for (next = orig; next; next = next->next) {
643 struct commit *commit = next->item;
644 *(indegree_slab_at(&indegree, commit)) = 1;
645 /* also record the author dates, if needed */
646 if (sort_order == REV_SORT_BY_AUTHOR_DATE)
647 record_author_date(&author_date, commit);
648 }
649
650 /* update the indegree */
651 for (next = orig; next; next = next->next) {
652 struct commit_list *parents = next->item->parents;
653 while (parents) {
654 struct commit *parent = parents->item;
655 int *pi = indegree_slab_at(&indegree, parent);
656
657 if (*pi)
658 (*pi)++;
659 parents = parents->next;
660 }
661 }
662
663 /*
664 * find the tips
665 *
666 * tips are nodes not reachable from any other node in the list
667 *
668 * the tips serve as a starting set for the work queue.
669 */
670 for (next = orig; next; next = next->next) {
671 struct commit *commit = next->item;
672
673 if (*(indegree_slab_at(&indegree, commit)) == 1)
674 prio_queue_put(&queue, commit);
675 }
676
677 /*
678 * This is unfortunate; the initial tips need to be shown
679 * in the order given from the revision traversal machinery.
680 */
681 if (sort_order == REV_SORT_IN_GRAPH_ORDER)
682 prio_queue_reverse(&queue);
683
684 /* We no longer need the commit list */
685 free_commit_list(orig);
686
687 pptr = list;
688 *list = NULL;
689 while ((commit = prio_queue_get(&queue)) != NULL) {
690 struct commit_list *parents;
691
692 for (parents = commit->parents; parents ; parents = parents->next) {
693 struct commit *parent = parents->item;
694 int *pi = indegree_slab_at(&indegree, parent);
695
696 if (!*pi)
697 continue;
698
699 /*
700 * parents are only enqueued for emission
701 * when all their children have been emitted thereby
702 * guaranteeing topological order.
703 */
704 if (--(*pi) == 1)
705 prio_queue_put(&queue, parent);
706 }
707 /*
708 * all children of commit have already been
709 * emitted. we can emit it now.
710 */
711 *(indegree_slab_at(&indegree, commit)) = 0;
712
713 pptr = &commit_list_insert(commit, pptr)->next;
714 }
715
716 clear_indegree_slab(&indegree);
717 clear_prio_queue(&queue);
718 if (sort_order == REV_SORT_BY_AUTHOR_DATE)
719 clear_author_date_slab(&author_date);
720}
721
722/* merge-base stuff */
723
724/* Remember to update object flag allocation in object.h */
725#define PARENT1 (1u<<16)
726#define PARENT2 (1u<<17)
727#define STALE (1u<<18)
728#define RESULT (1u<<19)
729
730static const unsigned all_flags = (PARENT1 | PARENT2 | STALE | RESULT);
731
732static struct commit *interesting(struct commit_list *list)
733{
734 while (list) {
735 struct commit *commit = list->item;
736 list = list->next;
737 if (commit->object.flags & STALE)
738 continue;
739 return commit;
740 }
741 return NULL;
742}
743
744/* all input commits in one and twos[] must have been parsed! */
745static struct commit_list *paint_down_to_common(struct commit *one, int n, struct commit **twos)
746{
747 struct commit_list *list = NULL;
748 struct commit_list *result = NULL;
749 int i;
750
751 one->object.flags |= PARENT1;
752 commit_list_insert_by_date(one, &list);
753 if (!n)
754 return list;
755 for (i = 0; i < n; i++) {
756 twos[i]->object.flags |= PARENT2;
757 commit_list_insert_by_date(twos[i], &list);
758 }
759
760 while (interesting(list)) {
761 struct commit *commit;
762 struct commit_list *parents;
763 struct commit_list *next;
764 int flags;
765
766 commit = list->item;
767 next = list->next;
768 free(list);
769 list = next;
770
771 flags = commit->object.flags & (PARENT1 | PARENT2 | STALE);
772 if (flags == (PARENT1 | PARENT2)) {
773 if (!(commit->object.flags & RESULT)) {
774 commit->object.flags |= RESULT;
775 commit_list_insert_by_date(commit, &result);
776 }
777 /* Mark parents of a found merge stale */
778 flags |= STALE;
779 }
780 parents = commit->parents;
781 while (parents) {
782 struct commit *p = parents->item;
783 parents = parents->next;
784 if ((p->object.flags & flags) == flags)
785 continue;
786 if (parse_commit(p))
787 return NULL;
788 p->object.flags |= flags;
789 commit_list_insert_by_date(p, &list);
790 }
791 }
792
793 free_commit_list(list);
794 return result;
795}
796
797static struct commit_list *merge_bases_many(struct commit *one, int n, struct commit **twos)
798{
799 struct commit_list *list = NULL;
800 struct commit_list *result = NULL;
801 int i;
802
803 for (i = 0; i < n; i++) {
804 if (one == twos[i])
805 /*
806 * We do not mark this even with RESULT so we do not
807 * have to clean it up.
808 */
809 return commit_list_insert(one, &result);
810 }
811
812 if (parse_commit(one))
813 return NULL;
814 for (i = 0; i < n; i++) {
815 if (parse_commit(twos[i]))
816 return NULL;
817 }
818
819 list = paint_down_to_common(one, n, twos);
820
821 while (list) {
822 struct commit_list *next = list->next;
823 if (!(list->item->object.flags & STALE))
824 commit_list_insert_by_date(list->item, &result);
825 free(list);
826 list = next;
827 }
828 return result;
829}
830
831struct commit_list *get_octopus_merge_bases(struct commit_list *in)
832{
833 struct commit_list *i, *j, *k, *ret = NULL;
834
835 if (!in)
836 return ret;
837
838 commit_list_insert(in->item, &ret);
839
840 for (i = in->next; i; i = i->next) {
841 struct commit_list *new = NULL, *end = NULL;
842
843 for (j = ret; j; j = j->next) {
844 struct commit_list *bases;
845 bases = get_merge_bases(i->item, j->item, 1);
846 if (!new)
847 new = bases;
848 else
849 end->next = bases;
850 for (k = bases; k; k = k->next)
851 end = k;
852 }
853 ret = new;
854 }
855 return ret;
856}
857
858static int remove_redundant(struct commit **array, int cnt)
859{
860 /*
861 * Some commit in the array may be an ancestor of
862 * another commit. Move such commit to the end of
863 * the array, and return the number of commits that
864 * are independent from each other.
865 */
866 struct commit **work;
867 unsigned char *redundant;
868 int *filled_index;
869 int i, j, filled;
870
871 work = xcalloc(cnt, sizeof(*work));
872 redundant = xcalloc(cnt, 1);
873 filled_index = xmalloc(sizeof(*filled_index) * (cnt - 1));
874
875 for (i = 0; i < cnt; i++)
876 parse_commit(array[i]);
877 for (i = 0; i < cnt; i++) {
878 struct commit_list *common;
879
880 if (redundant[i])
881 continue;
882 for (j = filled = 0; j < cnt; j++) {
883 if (i == j || redundant[j])
884 continue;
885 filled_index[filled] = j;
886 work[filled++] = array[j];
887 }
888 common = paint_down_to_common(array[i], filled, work);
889 if (array[i]->object.flags & PARENT2)
890 redundant[i] = 1;
891 for (j = 0; j < filled; j++)
892 if (work[j]->object.flags & PARENT1)
893 redundant[filled_index[j]] = 1;
894 clear_commit_marks(array[i], all_flags);
895 for (j = 0; j < filled; j++)
896 clear_commit_marks(work[j], all_flags);
897 free_commit_list(common);
898 }
899
900 /* Now collect the result */
901 memcpy(work, array, sizeof(*array) * cnt);
902 for (i = filled = 0; i < cnt; i++)
903 if (!redundant[i])
904 array[filled++] = work[i];
905 for (j = filled, i = 0; i < cnt; i++)
906 if (redundant[i])
907 array[j++] = work[i];
908 free(work);
909 free(redundant);
910 free(filled_index);
911 return filled;
912}
913
914struct commit_list *get_merge_bases_many(struct commit *one,
915 int n,
916 struct commit **twos,
917 int cleanup)
918{
919 struct commit_list *list;
920 struct commit **rslt;
921 struct commit_list *result;
922 int cnt, i;
923
924 result = merge_bases_many(one, n, twos);
925 for (i = 0; i < n; i++) {
926 if (one == twos[i])
927 return result;
928 }
929 if (!result || !result->next) {
930 if (cleanup) {
931 clear_commit_marks(one, all_flags);
932 clear_commit_marks_many(n, twos, all_flags);
933 }
934 return result;
935 }
936
937 /* There are more than one */
938 cnt = 0;
939 list = result;
940 while (list) {
941 list = list->next;
942 cnt++;
943 }
944 rslt = xcalloc(cnt, sizeof(*rslt));
945 for (list = result, i = 0; list; list = list->next)
946 rslt[i++] = list->item;
947 free_commit_list(result);
948
949 clear_commit_marks(one, all_flags);
950 clear_commit_marks_many(n, twos, all_flags);
951
952 cnt = remove_redundant(rslt, cnt);
953 result = NULL;
954 for (i = 0; i < cnt; i++)
955 commit_list_insert_by_date(rslt[i], &result);
956 free(rslt);
957 return result;
958}
959
960struct commit_list *get_merge_bases(struct commit *one, struct commit *two,
961 int cleanup)
962{
963 return get_merge_bases_many(one, 1, &two, cleanup);
964}
965
966/*
967 * Is "commit" a descendant of one of the elements on the "with_commit" list?
968 */
969int is_descendant_of(struct commit *commit, struct commit_list *with_commit)
970{
971 if (!with_commit)
972 return 1;
973 while (with_commit) {
974 struct commit *other;
975
976 other = with_commit->item;
977 with_commit = with_commit->next;
978 if (in_merge_bases(other, commit))
979 return 1;
980 }
981 return 0;
982}
983
984/*
985 * Is "commit" an ancestor of one of the "references"?
986 */
987int in_merge_bases_many(struct commit *commit, int nr_reference, struct commit **reference)
988{
989 struct commit_list *bases;
990 int ret = 0, i;
991
992 if (parse_commit(commit))
993 return ret;
994 for (i = 0; i < nr_reference; i++)
995 if (parse_commit(reference[i]))
996 return ret;
997
998 bases = paint_down_to_common(commit, nr_reference, reference);
999 if (commit->object.flags & PARENT2)
1000 ret = 1;
1001 clear_commit_marks(commit, all_flags);
1002 clear_commit_marks_many(nr_reference, reference, all_flags);
1003 free_commit_list(bases);
1004 return ret;
1005}
1006
1007/*
1008 * Is "commit" an ancestor of (i.e. reachable from) the "reference"?
1009 */
1010int in_merge_bases(struct commit *commit, struct commit *reference)
1011{
1012 return in_merge_bases_many(commit, 1, &reference);
1013}
1014
1015struct commit_list *reduce_heads(struct commit_list *heads)
1016{
1017 struct commit_list *p;
1018 struct commit_list *result = NULL, **tail = &result;
1019 struct commit **array;
1020 int num_head, i;
1021
1022 if (!heads)
1023 return NULL;
1024
1025 /* Uniquify */
1026 for (p = heads; p; p = p->next)
1027 p->item->object.flags &= ~STALE;
1028 for (p = heads, num_head = 0; p; p = p->next) {
1029 if (p->item->object.flags & STALE)
1030 continue;
1031 p->item->object.flags |= STALE;
1032 num_head++;
1033 }
1034 array = xcalloc(sizeof(*array), num_head);
1035 for (p = heads, i = 0; p; p = p->next) {
1036 if (p->item->object.flags & STALE) {
1037 array[i++] = p->item;
1038 p->item->object.flags &= ~STALE;
1039 }
1040 }
1041 num_head = remove_redundant(array, num_head);
1042 for (i = 0; i < num_head; i++)
1043 tail = &commit_list_insert(array[i], tail)->next;
1044 return result;
1045}
1046
1047static const char gpg_sig_header[] = "gpgsig";
1048static const int gpg_sig_header_len = sizeof(gpg_sig_header) - 1;
1049
1050static int do_sign_commit(struct strbuf *buf, const char *keyid)
1051{
1052 struct strbuf sig = STRBUF_INIT;
1053 int inspos, copypos;
1054
1055 /* find the end of the header */
1056 inspos = strstr(buf->buf, "\n\n") - buf->buf + 1;
1057
1058 if (!keyid || !*keyid)
1059 keyid = get_signing_key();
1060 if (sign_buffer(buf, &sig, keyid)) {
1061 strbuf_release(&sig);
1062 return -1;
1063 }
1064
1065 for (copypos = 0; sig.buf[copypos]; ) {
1066 const char *bol = sig.buf + copypos;
1067 const char *eol = strchrnul(bol, '\n');
1068 int len = (eol - bol) + !!*eol;
1069
1070 if (!copypos) {
1071 strbuf_insert(buf, inspos, gpg_sig_header, gpg_sig_header_len);
1072 inspos += gpg_sig_header_len;
1073 }
1074 strbuf_insert(buf, inspos++, " ", 1);
1075 strbuf_insert(buf, inspos, bol, len);
1076 inspos += len;
1077 copypos += len;
1078 }
1079 strbuf_release(&sig);
1080 return 0;
1081}
1082
1083int parse_signed_commit(const unsigned char *sha1,
1084 struct strbuf *payload, struct strbuf *signature)
1085{
1086 unsigned long size;
1087 enum object_type type;
1088 char *buffer = read_sha1_file(sha1, &type, &size);
1089 int in_signature, saw_signature = -1;
1090 char *line, *tail;
1091
1092 if (!buffer || type != OBJ_COMMIT)
1093 goto cleanup;
1094
1095 line = buffer;
1096 tail = buffer + size;
1097 in_signature = 0;
1098 saw_signature = 0;
1099 while (line < tail) {
1100 const char *sig = NULL;
1101 char *next = memchr(line, '\n', tail - line);
1102
1103 next = next ? next + 1 : tail;
1104 if (in_signature && line[0] == ' ')
1105 sig = line + 1;
1106 else if (starts_with(line, gpg_sig_header) &&
1107 line[gpg_sig_header_len] == ' ')
1108 sig = line + gpg_sig_header_len + 1;
1109 if (sig) {
1110 strbuf_add(signature, sig, next - sig);
1111 saw_signature = 1;
1112 in_signature = 1;
1113 } else {
1114 if (*line == '\n')
1115 /* dump the whole remainder of the buffer */
1116 next = tail;
1117 strbuf_add(payload, line, next - line);
1118 in_signature = 0;
1119 }
1120 line = next;
1121 }
1122 cleanup:
1123 free(buffer);
1124 return saw_signature;
1125}
1126
1127static void handle_signed_tag(struct commit *parent, struct commit_extra_header ***tail)
1128{
1129 struct merge_remote_desc *desc;
1130 struct commit_extra_header *mergetag;
1131 char *buf;
1132 unsigned long size, len;
1133 enum object_type type;
1134
1135 desc = merge_remote_util(parent);
1136 if (!desc || !desc->obj)
1137 return;
1138 buf = read_sha1_file(desc->obj->sha1, &type, &size);
1139 if (!buf || type != OBJ_TAG)
1140 goto free_return;
1141 len = parse_signature(buf, size);
1142 if (size == len)
1143 goto free_return;
1144 /*
1145 * We could verify this signature and either omit the tag when
1146 * it does not validate, but the integrator may not have the
1147 * public key of the signer of the tag he is merging, while a
1148 * later auditor may have it while auditing, so let's not run
1149 * verify-signed-buffer here for now...
1150 *
1151 * if (verify_signed_buffer(buf, len, buf + len, size - len, ...))
1152 * warn("warning: signed tag unverified.");
1153 */
1154 mergetag = xcalloc(1, sizeof(*mergetag));
1155 mergetag->key = xstrdup("mergetag");
1156 mergetag->value = buf;
1157 mergetag->len = size;
1158
1159 **tail = mergetag;
1160 *tail = &mergetag->next;
1161 return;
1162
1163free_return:
1164 free(buf);
1165}
1166
1167static struct {
1168 char result;
1169 const char *check;
1170} sigcheck_gpg_status[] = {
1171 { 'G', "\n[GNUPG:] GOODSIG " },
1172 { 'B', "\n[GNUPG:] BADSIG " },
1173 { 'U', "\n[GNUPG:] TRUST_NEVER" },
1174 { 'U', "\n[GNUPG:] TRUST_UNDEFINED" },
1175};
1176
1177static void parse_gpg_output(struct signature_check *sigc)
1178{
1179 const char *buf = sigc->gpg_status;
1180 int i;
1181
1182 /* Iterate over all search strings */
1183 for (i = 0; i < ARRAY_SIZE(sigcheck_gpg_status); i++) {
1184 const char *found, *next;
1185
1186 found = skip_prefix(buf, sigcheck_gpg_status[i].check + 1);
1187 if (!found) {
1188 found = strstr(buf, sigcheck_gpg_status[i].check);
1189 if (!found)
1190 continue;
1191 found += strlen(sigcheck_gpg_status[i].check);
1192 }
1193 sigc->result = sigcheck_gpg_status[i].result;
1194 /* The trust messages are not followed by key/signer information */
1195 if (sigc->result != 'U') {
1196 sigc->key = xmemdupz(found, 16);
1197 found += 17;
1198 next = strchrnul(found, '\n');
1199 sigc->signer = xmemdupz(found, next - found);
1200 }
1201 }
1202}
1203
1204void check_commit_signature(const struct commit* commit, struct signature_check *sigc)
1205{
1206 struct strbuf payload = STRBUF_INIT;
1207 struct strbuf signature = STRBUF_INIT;
1208 struct strbuf gpg_output = STRBUF_INIT;
1209 struct strbuf gpg_status = STRBUF_INIT;
1210 int status;
1211
1212 sigc->result = 'N';
1213
1214 if (parse_signed_commit(commit->object.sha1,
1215 &payload, &signature) <= 0)
1216 goto out;
1217 status = verify_signed_buffer(payload.buf, payload.len,
1218 signature.buf, signature.len,
1219 &gpg_output, &gpg_status);
1220 if (status && !gpg_output.len)
1221 goto out;
1222 sigc->gpg_output = strbuf_detach(&gpg_output, NULL);
1223 sigc->gpg_status = strbuf_detach(&gpg_status, NULL);
1224 parse_gpg_output(sigc);
1225
1226 out:
1227 strbuf_release(&gpg_status);
1228 strbuf_release(&gpg_output);
1229 strbuf_release(&payload);
1230 strbuf_release(&signature);
1231}
1232
1233
1234
1235void append_merge_tag_headers(struct commit_list *parents,
1236 struct commit_extra_header ***tail)
1237{
1238 while (parents) {
1239 struct commit *parent = parents->item;
1240 handle_signed_tag(parent, tail);
1241 parents = parents->next;
1242 }
1243}
1244
1245static void add_extra_header(struct strbuf *buffer,
1246 struct commit_extra_header *extra)
1247{
1248 strbuf_addstr(buffer, extra->key);
1249 if (extra->len)
1250 strbuf_add_lines(buffer, " ", extra->value, extra->len);
1251 else
1252 strbuf_addch(buffer, '\n');
1253}
1254
1255struct commit_extra_header *read_commit_extra_headers(struct commit *commit,
1256 const char **exclude)
1257{
1258 struct commit_extra_header *extra = NULL;
1259 unsigned long size;
1260 enum object_type type;
1261 char *buffer = read_sha1_file(commit->object.sha1, &type, &size);
1262 if (buffer && type == OBJ_COMMIT)
1263 extra = read_commit_extra_header_lines(buffer, size, exclude);
1264 free(buffer);
1265 return extra;
1266}
1267
1268static inline int standard_header_field(const char *field, size_t len)
1269{
1270 return ((len == 4 && !memcmp(field, "tree ", 5)) ||
1271 (len == 6 && !memcmp(field, "parent ", 7)) ||
1272 (len == 6 && !memcmp(field, "author ", 7)) ||
1273 (len == 9 && !memcmp(field, "committer ", 10)) ||
1274 (len == 8 && !memcmp(field, "encoding ", 9)));
1275}
1276
1277static int excluded_header_field(const char *field, size_t len, const char **exclude)
1278{
1279 if (!exclude)
1280 return 0;
1281
1282 while (*exclude) {
1283 size_t xlen = strlen(*exclude);
1284 if (len == xlen &&
1285 !memcmp(field, *exclude, xlen) && field[xlen] == ' ')
1286 return 1;
1287 exclude++;
1288 }
1289 return 0;
1290}
1291
1292static struct commit_extra_header *read_commit_extra_header_lines(
1293 const char *buffer, size_t size,
1294 const char **exclude)
1295{
1296 struct commit_extra_header *extra = NULL, **tail = &extra, *it = NULL;
1297 const char *line, *next, *eof, *eob;
1298 struct strbuf buf = STRBUF_INIT;
1299
1300 for (line = buffer, eob = line + size;
1301 line < eob && *line != '\n';
1302 line = next) {
1303 next = memchr(line, '\n', eob - line);
1304 next = next ? next + 1 : eob;
1305 if (*line == ' ') {
1306 /* continuation */
1307 if (it)
1308 strbuf_add(&buf, line + 1, next - (line + 1));
1309 continue;
1310 }
1311 if (it)
1312 it->value = strbuf_detach(&buf, &it->len);
1313 strbuf_reset(&buf);
1314 it = NULL;
1315
1316 eof = strchr(line, ' ');
1317 if (next <= eof)
1318 eof = next;
1319
1320 if (standard_header_field(line, eof - line) ||
1321 excluded_header_field(line, eof - line, exclude))
1322 continue;
1323
1324 it = xcalloc(1, sizeof(*it));
1325 it->key = xmemdupz(line, eof-line);
1326 *tail = it;
1327 tail = &it->next;
1328 if (eof + 1 < next)
1329 strbuf_add(&buf, eof + 1, next - (eof + 1));
1330 }
1331 if (it)
1332 it->value = strbuf_detach(&buf, &it->len);
1333 return extra;
1334}
1335
1336void free_commit_extra_headers(struct commit_extra_header *extra)
1337{
1338 while (extra) {
1339 struct commit_extra_header *next = extra->next;
1340 free(extra->key);
1341 free(extra->value);
1342 free(extra);
1343 extra = next;
1344 }
1345}
1346
1347int commit_tree(const char *msg, size_t msg_len,
1348 const unsigned char *tree,
1349 struct commit_list *parents, unsigned char *ret,
1350 const char *author, const char *sign_commit)
1351{
1352 struct commit_extra_header *extra = NULL, **tail = &extra;
1353 int result;
1354
1355 append_merge_tag_headers(parents, &tail);
1356 result = commit_tree_extended(msg, msg_len, tree, parents, ret,
1357 author, sign_commit, extra);
1358 free_commit_extra_headers(extra);
1359 return result;
1360}
1361
1362static int find_invalid_utf8(const char *buf, int len)
1363{
1364 int offset = 0;
1365 static const unsigned int max_codepoint[] = {
1366 0x7f, 0x7ff, 0xffff, 0x10ffff
1367 };
1368
1369 while (len) {
1370 unsigned char c = *buf++;
1371 int bytes, bad_offset;
1372 unsigned int codepoint;
1373 unsigned int min_val, max_val;
1374
1375 len--;
1376 offset++;
1377
1378 /* Simple US-ASCII? No worries. */
1379 if (c < 0x80)
1380 continue;
1381
1382 bad_offset = offset-1;
1383
1384 /*
1385 * Count how many more high bits set: that's how
1386 * many more bytes this sequence should have.
1387 */
1388 bytes = 0;
1389 while (c & 0x40) {
1390 c <<= 1;
1391 bytes++;
1392 }
1393
1394 /*
1395 * Must be between 1 and 3 more bytes. Longer sequences result in
1396 * codepoints beyond U+10FFFF, which are guaranteed never to exist.
1397 */
1398 if (bytes < 1 || 3 < bytes)
1399 return bad_offset;
1400
1401 /* Do we *have* that many bytes? */
1402 if (len < bytes)
1403 return bad_offset;
1404
1405 /*
1406 * Place the encoded bits at the bottom of the value and compute the
1407 * valid range.
1408 */
1409 codepoint = (c & 0x7f) >> bytes;
1410 min_val = max_codepoint[bytes-1] + 1;
1411 max_val = max_codepoint[bytes];
1412
1413 offset += bytes;
1414 len -= bytes;
1415
1416 /* And verify that they are good continuation bytes */
1417 do {
1418 codepoint <<= 6;
1419 codepoint |= *buf & 0x3f;
1420 if ((*buf++ & 0xc0) != 0x80)
1421 return bad_offset;
1422 } while (--bytes);
1423
1424 /* Reject codepoints that are out of range for the sequence length. */
1425 if (codepoint < min_val || codepoint > max_val)
1426 return bad_offset;
1427 /* Surrogates are only for UTF-16 and cannot be encoded in UTF-8. */
1428 if ((codepoint & 0x1ff800) == 0xd800)
1429 return bad_offset;
1430 /* U+xxFFFE and U+xxFFFF are guaranteed non-characters. */
1431 if ((codepoint & 0xfffe) == 0xfffe)
1432 return bad_offset;
1433 /* So are anything in the range U+FDD0..U+FDEF. */
1434 if (codepoint >= 0xfdd0 && codepoint <= 0xfdef)
1435 return bad_offset;
1436 }
1437 return -1;
1438}
1439
1440/*
1441 * This verifies that the buffer is in proper utf8 format.
1442 *
1443 * If it isn't, it assumes any non-utf8 characters are Latin1,
1444 * and does the conversion.
1445 */
1446static int verify_utf8(struct strbuf *buf)
1447{
1448 int ok = 1;
1449 long pos = 0;
1450
1451 for (;;) {
1452 int bad;
1453 unsigned char c;
1454 unsigned char replace[2];
1455
1456 bad = find_invalid_utf8(buf->buf + pos, buf->len - pos);
1457 if (bad < 0)
1458 return ok;
1459 pos += bad;
1460 ok = 0;
1461 c = buf->buf[pos];
1462 strbuf_remove(buf, pos, 1);
1463
1464 /* We know 'c' must be in the range 128-255 */
1465 replace[0] = 0xc0 + (c >> 6);
1466 replace[1] = 0x80 + (c & 0x3f);
1467 strbuf_insert(buf, pos, replace, 2);
1468 pos += 2;
1469 }
1470}
1471
1472static const char commit_utf8_warn[] =
1473"Warning: commit message did not conform to UTF-8.\n"
1474"You may want to amend it after fixing the message, or set the config\n"
1475"variable i18n.commitencoding to the encoding your project uses.\n";
1476
1477int commit_tree_extended(const char *msg, size_t msg_len,
1478 const unsigned char *tree,
1479 struct commit_list *parents, unsigned char *ret,
1480 const char *author, const char *sign_commit,
1481 struct commit_extra_header *extra)
1482{
1483 int result;
1484 int encoding_is_utf8;
1485 struct strbuf buffer;
1486
1487 assert_sha1_type(tree, OBJ_TREE);
1488
1489 if (memchr(msg, '\0', msg_len))
1490 return error("a NUL byte in commit log message not allowed.");
1491
1492 /* Not having i18n.commitencoding is the same as having utf-8 */
1493 encoding_is_utf8 = is_encoding_utf8(git_commit_encoding);
1494
1495 strbuf_init(&buffer, 8192); /* should avoid reallocs for the headers */
1496 strbuf_addf(&buffer, "tree %s\n", sha1_to_hex(tree));
1497
1498 /*
1499 * NOTE! This ordering means that the same exact tree merged with a
1500 * different order of parents will be a _different_ changeset even
1501 * if everything else stays the same.
1502 */
1503 while (parents) {
1504 struct commit_list *next = parents->next;
1505 struct commit *parent = parents->item;
1506
1507 strbuf_addf(&buffer, "parent %s\n",
1508 sha1_to_hex(parent->object.sha1));
1509 free(parents);
1510 parents = next;
1511 }
1512
1513 /* Person/date information */
1514 if (!author)
1515 author = git_author_info(IDENT_STRICT);
1516 strbuf_addf(&buffer, "author %s\n", author);
1517 strbuf_addf(&buffer, "committer %s\n", git_committer_info(IDENT_STRICT));
1518 if (!encoding_is_utf8)
1519 strbuf_addf(&buffer, "encoding %s\n", git_commit_encoding);
1520
1521 while (extra) {
1522 add_extra_header(&buffer, extra);
1523 extra = extra->next;
1524 }
1525 strbuf_addch(&buffer, '\n');
1526
1527 /* And add the comment */
1528 strbuf_add(&buffer, msg, msg_len);
1529
1530 /* And check the encoding */
1531 if (encoding_is_utf8 && !verify_utf8(&buffer))
1532 fprintf(stderr, commit_utf8_warn);
1533
1534 if (sign_commit && do_sign_commit(&buffer, sign_commit))
1535 return -1;
1536
1537 result = write_sha1_file(buffer.buf, buffer.len, commit_type, ret);
1538 strbuf_release(&buffer);
1539 return result;
1540}
1541
1542struct commit *get_merge_parent(const char *name)
1543{
1544 struct object *obj;
1545 struct commit *commit;
1546 unsigned char sha1[20];
1547 if (get_sha1(name, sha1))
1548 return NULL;
1549 obj = parse_object(sha1);
1550 commit = (struct commit *)peel_to_type(name, 0, obj, OBJ_COMMIT);
1551 if (commit && !commit->util) {
1552 struct merge_remote_desc *desc;
1553 desc = xmalloc(sizeof(*desc));
1554 desc->obj = obj;
1555 desc->name = strdup(name);
1556 commit->util = desc;
1557 }
1558 return commit;
1559}
1560
1561/*
1562 * Append a commit to the end of the commit_list.
1563 *
1564 * next starts by pointing to the variable that holds the head of an
1565 * empty commit_list, and is updated to point to the "next" field of
1566 * the last item on the list as new commits are appended.
1567 *
1568 * Usage example:
1569 *
1570 * struct commit_list *list;
1571 * struct commit_list **next = &list;
1572 *
1573 * next = commit_list_append(c1, next);
1574 * next = commit_list_append(c2, next);
1575 * assert(commit_list_count(list) == 2);
1576 * return list;
1577 */
1578struct commit_list **commit_list_append(struct commit *commit,
1579 struct commit_list **next)
1580{
1581 struct commit_list *new = xmalloc(sizeof(struct commit_list));
1582 new->item = commit;
1583 *next = new;
1584 new->next = NULL;
1585 return &new->next;
1586}
1587
1588void print_commit_list(struct commit_list *list,
1589 const char *format_cur,
1590 const char *format_last)
1591{
1592 for ( ; list; list = list->next) {
1593 const char *format = list->next ? format_cur : format_last;
1594 printf(format, sha1_to_hex(list->item->object.sha1));
1595 }
1596}