Documentation/user-manual: update outdated example output
[git.git] / bundle.c
blobd15db03c84556af8a47783f4d4ee76379d721020
1 #include "cache.h"
2 #include "lockfile.h"
3 #include "bundle.h"
4 #include "object.h"
5 #include "commit.h"
6 #include "diff.h"
7 #include "revision.h"
8 #include "list-objects.h"
9 #include "run-command.h"
10 #include "refs.h"
11 #include "argv-array.h"
13 static const char bundle_signature[] = "# v2 git bundle\n";
15 static void add_to_ref_list(const struct object_id *oid, const char *name,
16 struct ref_list *list)
18 ALLOC_GROW(list->list, list->nr + 1, list->alloc);
19 oidcpy(&list->list[list->nr].oid, oid);
20 list->list[list->nr].name = xstrdup(name);
21 list->nr++;
24 static int parse_bundle_header(int fd, struct bundle_header *header,
25 const char *report_path)
27 struct strbuf buf = STRBUF_INIT;
28 int status = 0;
30 /* The bundle header begins with the signature */
31 if (strbuf_getwholeline_fd(&buf, fd, '\n') ||
32 strcmp(buf.buf, bundle_signature)) {
33 if (report_path)
34 error(_("'%s' does not look like a v2 bundle file"),
35 report_path);
36 status = -1;
37 goto abort;
40 /* The bundle header ends with an empty line */
41 while (!strbuf_getwholeline_fd(&buf, fd, '\n') &&
42 buf.len && buf.buf[0] != '\n') {
43 struct object_id oid;
44 int is_prereq = 0;
45 const char *p;
47 if (*buf.buf == '-') {
48 is_prereq = 1;
49 strbuf_remove(&buf, 0, 1);
51 strbuf_rtrim(&buf);
54 * Tip lines have object name, SP, and refname.
55 * Prerequisites have object name that is optionally
56 * followed by SP and subject line.
58 if (parse_oid_hex(buf.buf, &oid, &p) ||
59 (*p && !isspace(*p)) ||
60 (!is_prereq && !*p)) {
61 if (report_path)
62 error(_("unrecognized header: %s%s (%d)"),
63 (is_prereq ? "-" : ""), buf.buf, (int)buf.len);
64 status = -1;
65 break;
66 } else {
67 if (is_prereq)
68 add_to_ref_list(&oid, "", &header->prerequisites);
69 else
70 add_to_ref_list(&oid, p + 1, &header->references);
74 abort:
75 if (status) {
76 close(fd);
77 fd = -1;
79 strbuf_release(&buf);
80 return fd;
83 int read_bundle_header(const char *path, struct bundle_header *header)
85 int fd = open(path, O_RDONLY);
87 if (fd < 0)
88 return error(_("could not open '%s'"), path);
89 return parse_bundle_header(fd, header, path);
92 int is_bundle(const char *path, int quiet)
94 struct bundle_header header;
95 int fd = open(path, O_RDONLY);
97 if (fd < 0)
98 return 0;
99 memset(&header, 0, sizeof(header));
100 fd = parse_bundle_header(fd, &header, quiet ? NULL : path);
101 if (fd >= 0)
102 close(fd);
103 return (fd >= 0);
106 static int list_refs(struct ref_list *r, int argc, const char **argv)
108 int i;
110 for (i = 0; i < r->nr; i++) {
111 if (argc > 1) {
112 int j;
113 for (j = 1; j < argc; j++)
114 if (!strcmp(r->list[i].name, argv[j]))
115 break;
116 if (j == argc)
117 continue;
119 printf("%s %s\n", oid_to_hex(&r->list[i].oid),
120 r->list[i].name);
122 return 0;
125 /* Remember to update object flag allocation in object.h */
126 #define PREREQ_MARK (1u<<16)
128 int verify_bundle(struct bundle_header *header, int verbose)
131 * Do fast check, then if any prereqs are missing then go line by line
132 * to be verbose about the errors
134 struct ref_list *p = &header->prerequisites;
135 struct rev_info revs;
136 const char *argv[] = {NULL, "--all", NULL};
137 struct object_array refs;
138 struct commit *commit;
139 int i, ret = 0, req_nr;
140 const char *message = _("Repository lacks these prerequisite commits:");
142 init_revisions(&revs, NULL);
143 for (i = 0; i < p->nr; i++) {
144 struct ref_list_entry *e = p->list + i;
145 struct object *o = parse_object(&e->oid);
146 if (o) {
147 o->flags |= PREREQ_MARK;
148 add_pending_object(&revs, o, e->name);
149 continue;
151 if (++ret == 1)
152 error("%s", message);
153 error("%s %s", oid_to_hex(&e->oid), e->name);
155 if (revs.pending.nr != p->nr)
156 return ret;
157 req_nr = revs.pending.nr;
158 setup_revisions(2, argv, &revs, NULL);
160 refs = revs.pending;
161 revs.leak_pending = 1;
163 if (prepare_revision_walk(&revs))
164 die(_("revision walk setup failed"));
166 i = req_nr;
167 while (i && (commit = get_revision(&revs)))
168 if (commit->object.flags & PREREQ_MARK)
169 i--;
171 for (i = 0; i < req_nr; i++)
172 if (!(refs.objects[i].item->flags & SHOWN)) {
173 if (++ret == 1)
174 error("%s", message);
175 error("%s %s", oid_to_hex(&refs.objects[i].item->oid),
176 refs.objects[i].name);
179 clear_commit_marks_for_object_array(&refs, ALL_REV_FLAGS);
180 free(refs.objects);
182 if (verbose) {
183 struct ref_list *r;
185 r = &header->references;
186 printf_ln(Q_("The bundle contains this ref:",
187 "The bundle contains these %d refs:",
188 r->nr),
189 r->nr);
190 list_refs(r, 0, NULL);
191 r = &header->prerequisites;
192 if (!r->nr) {
193 printf_ln(_("The bundle records a complete history."));
194 } else {
195 printf_ln(Q_("The bundle requires this ref:",
196 "The bundle requires these %d refs:",
197 r->nr),
198 r->nr);
199 list_refs(r, 0, NULL);
202 return ret;
205 int list_bundle_refs(struct bundle_header *header, int argc, const char **argv)
207 return list_refs(&header->references, argc, argv);
210 static int is_tag_in_date_range(struct object *tag, struct rev_info *revs)
212 unsigned long size;
213 enum object_type type;
214 char *buf = NULL, *line, *lineend;
215 timestamp_t date;
216 int result = 1;
218 if (revs->max_age == -1 && revs->min_age == -1)
219 goto out;
221 buf = read_sha1_file(tag->oid.hash, &type, &size);
222 if (!buf)
223 goto out;
224 line = memmem(buf, size, "\ntagger ", 8);
225 if (!line++)
226 goto out;
227 lineend = memchr(line, '\n', buf + size - line);
228 line = memchr(line, '>', lineend ? lineend - line : buf + size - line);
229 if (!line++)
230 goto out;
231 date = parse_timestamp(line, NULL, 10);
232 result = (revs->max_age == -1 || revs->max_age < date) &&
233 (revs->min_age == -1 || revs->min_age > date);
234 out:
235 free(buf);
236 return result;
240 /* Write the pack data to bundle_fd, then close it if it is > 1. */
241 static int write_pack_data(int bundle_fd, struct rev_info *revs)
243 struct child_process pack_objects = CHILD_PROCESS_INIT;
244 int i;
246 argv_array_pushl(&pack_objects.args,
247 "pack-objects", "--all-progress-implied",
248 "--stdout", "--thin", "--delta-base-offset",
249 NULL);
250 pack_objects.in = -1;
251 pack_objects.out = bundle_fd;
252 pack_objects.git_cmd = 1;
253 if (start_command(&pack_objects))
254 return error(_("Could not spawn pack-objects"));
256 for (i = 0; i < revs->pending.nr; i++) {
257 struct object *object = revs->pending.objects[i].item;
258 if (object->flags & UNINTERESTING)
259 write_or_die(pack_objects.in, "^", 1);
260 write_or_die(pack_objects.in, oid_to_hex(&object->oid), GIT_SHA1_HEXSZ);
261 write_or_die(pack_objects.in, "\n", 1);
263 close(pack_objects.in);
264 if (finish_command(&pack_objects))
265 return error(_("pack-objects died"));
266 return 0;
269 static int compute_and_write_prerequisites(int bundle_fd,
270 struct rev_info *revs,
271 int argc, const char **argv)
273 struct child_process rls = CHILD_PROCESS_INIT;
274 struct strbuf buf = STRBUF_INIT;
275 FILE *rls_fout;
276 int i;
278 argv_array_pushl(&rls.args,
279 "rev-list", "--boundary", "--pretty=oneline",
280 NULL);
281 for (i = 1; i < argc; i++)
282 argv_array_push(&rls.args, argv[i]);
283 rls.out = -1;
284 rls.git_cmd = 1;
285 if (start_command(&rls))
286 return -1;
287 rls_fout = xfdopen(rls.out, "r");
288 while (strbuf_getwholeline(&buf, rls_fout, '\n') != EOF) {
289 struct object_id oid;
290 if (buf.len > 0 && buf.buf[0] == '-') {
291 write_or_die(bundle_fd, buf.buf, buf.len);
292 if (!get_oid_hex(buf.buf + 1, &oid)) {
293 struct object *object = parse_object_or_die(&oid,
294 buf.buf);
295 object->flags |= UNINTERESTING;
296 add_pending_object(revs, object, buf.buf);
298 } else if (!get_oid_hex(buf.buf, &oid)) {
299 struct object *object = parse_object_or_die(&oid,
300 buf.buf);
301 object->flags |= SHOWN;
304 strbuf_release(&buf);
305 fclose(rls_fout);
306 if (finish_command(&rls))
307 return error(_("rev-list died"));
308 return 0;
312 * Write out bundle refs based on the tips already
313 * parsed into revs.pending. As a side effect, may
314 * manipulate revs.pending to include additional
315 * necessary objects (like tags).
317 * Returns the number of refs written, or negative
318 * on error.
320 static int write_bundle_refs(int bundle_fd, struct rev_info *revs)
322 int i;
323 int ref_count = 0;
325 for (i = 0; i < revs->pending.nr; i++) {
326 struct object_array_entry *e = revs->pending.objects + i;
327 struct object_id oid;
328 char *ref;
329 const char *display_ref;
330 int flag;
332 if (e->item->flags & UNINTERESTING)
333 continue;
334 if (dwim_ref(e->name, strlen(e->name), oid.hash, &ref) != 1)
335 goto skip_write_ref;
336 if (read_ref_full(e->name, RESOLVE_REF_READING, oid.hash, &flag))
337 flag = 0;
338 display_ref = (flag & REF_ISSYMREF) ? e->name : ref;
340 if (e->item->type == OBJ_TAG &&
341 !is_tag_in_date_range(e->item, revs)) {
342 e->item->flags |= UNINTERESTING;
343 goto skip_write_ref;
347 * Make sure the refs we wrote out is correct; --max-count and
348 * other limiting options could have prevented all the tips
349 * from getting output.
351 * Non commit objects such as tags and blobs do not have
352 * this issue as they are not affected by those extra
353 * constraints.
355 if (!(e->item->flags & SHOWN) && e->item->type == OBJ_COMMIT) {
356 warning(_("ref '%s' is excluded by the rev-list options"),
357 e->name);
358 goto skip_write_ref;
361 * If you run "git bundle create bndl v1.0..v2.0", the
362 * name of the positive ref is "v2.0" but that is the
363 * commit that is referenced by the tag, and not the tag
364 * itself.
366 if (oidcmp(&oid, &e->item->oid)) {
368 * Is this the positive end of a range expressed
369 * in terms of a tag (e.g. v2.0 from the range
370 * "v1.0..v2.0")?
372 struct commit *one = lookup_commit_reference(&oid);
373 struct object *obj;
375 if (e->item == &(one->object)) {
377 * Need to include e->name as an
378 * independent ref to the pack-objects
379 * input, so that the tag is included
380 * in the output; otherwise we would
381 * end up triggering "empty bundle"
382 * error.
384 obj = parse_object_or_die(&oid, e->name);
385 obj->flags |= SHOWN;
386 add_pending_object(revs, obj, e->name);
388 goto skip_write_ref;
391 ref_count++;
392 write_or_die(bundle_fd, oid_to_hex(&e->item->oid), 40);
393 write_or_die(bundle_fd, " ", 1);
394 write_or_die(bundle_fd, display_ref, strlen(display_ref));
395 write_or_die(bundle_fd, "\n", 1);
396 skip_write_ref:
397 free(ref);
400 /* end header */
401 write_or_die(bundle_fd, "\n", 1);
402 return ref_count;
405 int create_bundle(struct bundle_header *header, const char *path,
406 int argc, const char **argv)
408 static struct lock_file lock;
409 int bundle_fd = -1;
410 int bundle_to_stdout;
411 int ref_count = 0;
412 struct rev_info revs;
414 bundle_to_stdout = !strcmp(path, "-");
415 if (bundle_to_stdout)
416 bundle_fd = 1;
417 else {
418 bundle_fd = hold_lock_file_for_update(&lock, path,
419 LOCK_DIE_ON_ERROR);
422 * write_pack_data() will close the fd passed to it,
423 * but commit_lock_file() will also try to close the
424 * lockfile's fd. So make a copy of the file
425 * descriptor to avoid trying to close it twice.
427 bundle_fd = dup(bundle_fd);
428 if (bundle_fd < 0)
429 die_errno("unable to dup file descriptor");
432 /* write signature */
433 write_or_die(bundle_fd, bundle_signature, strlen(bundle_signature));
435 /* init revs to list objects for pack-objects later */
436 save_commit_buffer = 0;
437 init_revisions(&revs, NULL);
439 /* write prerequisites */
440 if (compute_and_write_prerequisites(bundle_fd, &revs, argc, argv))
441 goto err;
443 argc = setup_revisions(argc, argv, &revs, NULL);
445 if (argc > 1) {
446 error(_("unrecognized argument: %s"), argv[1]);
447 goto err;
450 object_array_remove_duplicates(&revs.pending);
452 ref_count = write_bundle_refs(bundle_fd, &revs);
453 if (!ref_count)
454 die(_("Refusing to create empty bundle."));
455 else if (ref_count < 0)
456 goto err;
458 /* write pack */
459 if (write_pack_data(bundle_fd, &revs)) {
460 bundle_fd = -1; /* already closed by the above call */
461 goto err;
464 if (!bundle_to_stdout) {
465 if (commit_lock_file(&lock))
466 die_errno(_("cannot create '%s'"), path);
468 return 0;
469 err:
470 if (!bundle_to_stdout) {
471 if (0 <= bundle_fd)
472 close(bundle_fd);
473 rollback_lock_file(&lock);
475 return -1;
478 int unbundle(struct bundle_header *header, int bundle_fd, int flags)
480 const char *argv_index_pack[] = {"index-pack",
481 "--fix-thin", "--stdin", NULL, NULL};
482 struct child_process ip = CHILD_PROCESS_INIT;
484 if (flags & BUNDLE_VERBOSE)
485 argv_index_pack[3] = "-v";
487 if (verify_bundle(header, 0))
488 return -1;
489 ip.argv = argv_index_pack;
490 ip.in = bundle_fd;
491 ip.no_stdout = 1;
492 ip.git_cmd = 1;
493 if (run_command(&ip))
494 return error(_("index-pack died"));
495 return 0;