git-filter-branch: document --original option
[git/mingw/4msysgit/wingit-dll.git] / builtin-bundle.c
blob1b650069c929744c43f95e62ca49f8a542a70111
1 #include "builtin.h"
2 #include "cache.h"
3 #include "object.h"
4 #include "commit.h"
5 #include "diff.h"
6 #include "revision.h"
7 #include "list-objects.h"
8 #include "run-command.h"
11 * Basic handler for bundle files to connect repositories via sneakernet.
12 * Invocation must include action.
13 * This function can create a bundle or provide information on an existing
14 * bundle supporting git-fetch, git-pull, and git-ls-remote
17 static const char *bundle_usage="git-bundle (create <bundle> <git-rev-list args> | verify <bundle> | list-heads <bundle> [refname]... | unbundle <bundle> [refname]... )";
19 static const char bundle_signature[] = "# v2 git bundle\n";
21 struct ref_list {
22 unsigned int nr, alloc;
23 struct ref_list_entry {
24 unsigned char sha1[20];
25 char *name;
26 } *list;
29 static void add_to_ref_list(const unsigned char *sha1, const char *name,
30 struct ref_list *list)
32 if (list->nr + 1 >= list->alloc) {
33 list->alloc = alloc_nr(list->nr + 1);
34 list->list = xrealloc(list->list,
35 list->alloc * sizeof(list->list[0]));
37 memcpy(list->list[list->nr].sha1, sha1, 20);
38 list->list[list->nr].name = xstrdup(name);
39 list->nr++;
42 struct bundle_header {
43 struct ref_list prerequisites;
44 struct ref_list references;
47 /* returns an fd */
48 static int read_header(const char *path, struct bundle_header *header) {
49 char buffer[1024];
50 int fd;
51 long fpos;
52 FILE *ffd = fopen(path, "rb");
54 if (!ffd)
55 return error("could not open '%s'", path);
56 if (!fgets(buffer, sizeof(buffer), ffd) ||
57 strcmp(buffer, bundle_signature)) {
58 fclose(ffd);
59 return error("'%s' does not look like a v2 bundle file", path);
61 while (fgets(buffer, sizeof(buffer), ffd)
62 && buffer[0] != '\n') {
63 int is_prereq = buffer[0] == '-';
64 int offset = is_prereq ? 1 : 0;
65 int len = strlen(buffer);
66 unsigned char sha1[20];
67 struct ref_list *list = is_prereq ? &header->prerequisites
68 : &header->references;
69 char delim;
71 if (buffer[len - 1] == '\n')
72 buffer[len - 1] = '\0';
73 if (get_sha1_hex(buffer + offset, sha1)) {
74 warning("unrecognized header: %s", buffer);
75 continue;
77 delim = buffer[40 + offset];
78 if (!isspace(delim) && (delim != '\0' || !is_prereq))
79 die ("invalid header: %s", buffer);
80 add_to_ref_list(sha1, isspace(delim) ?
81 buffer + 41 + offset : "", list);
83 fpos = ftell(ffd);
84 fclose(ffd);
85 fd = open(path, O_RDONLY);
86 if (fd < 0)
87 return error("could not open '%s'", path);
88 lseek(fd, fpos, SEEK_SET);
89 return fd;
92 static int list_refs(struct ref_list *r, int argc, const char **argv)
94 int i;
96 for (i = 0; i < r->nr; i++) {
97 if (argc > 1) {
98 int j;
99 for (j = 1; j < argc; j++)
100 if (!strcmp(r->list[i].name, argv[j]))
101 break;
102 if (j == argc)
103 continue;
105 printf("%s %s\n", sha1_to_hex(r->list[i].sha1),
106 r->list[i].name);
108 return 0;
111 #define PREREQ_MARK (1u<<16)
113 static int verify_bundle(struct bundle_header *header, int verbose)
116 * Do fast check, then if any prereqs are missing then go line by line
117 * to be verbose about the errors
119 struct ref_list *p = &header->prerequisites;
120 struct rev_info revs;
121 const char *argv[] = {NULL, "--all"};
122 struct object_array refs;
123 struct commit *commit;
124 int i, ret = 0, req_nr;
125 const char *message = "Repository lacks these prerequisite commits:";
127 init_revisions(&revs, NULL);
128 for (i = 0; i < p->nr; i++) {
129 struct ref_list_entry *e = p->list + i;
130 struct object *o = parse_object(e->sha1);
131 if (o) {
132 o->flags |= PREREQ_MARK;
133 add_pending_object(&revs, o, e->name);
134 continue;
136 if (++ret == 1)
137 error(message);
138 error("%s %s", sha1_to_hex(e->sha1), e->name);
140 if (revs.pending.nr != p->nr)
141 return ret;
142 req_nr = revs.pending.nr;
143 setup_revisions(2, argv, &revs, NULL);
145 memset(&refs, 0, sizeof(struct object_array));
146 for (i = 0; i < revs.pending.nr; i++) {
147 struct object_array_entry *e = revs.pending.objects + i;
148 add_object_array(e->item, e->name, &refs);
151 prepare_revision_walk(&revs);
153 i = req_nr;
154 while (i && (commit = get_revision(&revs)))
155 if (commit->object.flags & PREREQ_MARK)
156 i--;
158 for (i = 0; i < req_nr; i++)
159 if (!(refs.objects[i].item->flags & SHOWN)) {
160 if (++ret == 1)
161 error(message);
162 error("%s %s", sha1_to_hex(refs.objects[i].item->sha1),
163 refs.objects[i].name);
166 for (i = 0; i < refs.nr; i++)
167 clear_commit_marks((struct commit *)refs.objects[i].item, -1);
169 if (verbose) {
170 struct ref_list *r;
172 r = &header->references;
173 printf("The bundle contains %d ref%s\n",
174 r->nr, (1 < r->nr) ? "s" : "");
175 list_refs(r, 0, NULL);
176 r = &header->prerequisites;
177 printf("The bundle requires these %d ref%s\n",
178 r->nr, (1 < r->nr) ? "s" : "");
179 list_refs(r, 0, NULL);
181 return ret;
184 static int list_heads(struct bundle_header *header, int argc, const char **argv)
186 return list_refs(&header->references, argc, argv);
189 static int create_bundle(struct bundle_header *header, const char *path,
190 int argc, const char **argv)
192 static struct lock_file lock;
193 int bundle_fd = -1;
194 int bundle_to_stdout;
195 const char **argv_boundary = xmalloc((argc + 4) * sizeof(const char *));
196 const char **argv_pack = xmalloc(5 * sizeof(const char *));
197 int i, ref_count = 0;
198 char buffer[1024];
199 struct rev_info revs;
200 struct child_process rls;
201 FILE *rls_fout;
203 bundle_to_stdout = !strcmp(path, "-");
204 if (bundle_to_stdout)
205 bundle_fd = 1;
206 else
207 bundle_fd = hold_lock_file_for_update(&lock, path, 1);
209 /* write signature */
210 write_or_die(bundle_fd, bundle_signature, strlen(bundle_signature));
212 /* init revs to list objects for pack-objects later */
213 save_commit_buffer = 0;
214 init_revisions(&revs, NULL);
216 /* write prerequisites */
217 memcpy(argv_boundary + 3, argv + 1, argc * sizeof(const char *));
218 argv_boundary[0] = "rev-list";
219 argv_boundary[1] = "--boundary";
220 argv_boundary[2] = "--pretty=oneline";
221 argv_boundary[argc + 2] = NULL;
222 memset(&rls, 0, sizeof(rls));
223 rls.argv = argv_boundary;
224 rls.out = -1;
225 rls.git_cmd = 1;
226 if (start_command(&rls))
227 return -1;
228 rls_fout = fdopen(rls.out, "r");
229 while (fgets(buffer, sizeof(buffer), rls_fout)) {
230 unsigned char sha1[20];
231 if (buffer[0] == '-') {
232 write_or_die(bundle_fd, buffer, strlen(buffer));
233 if (!get_sha1_hex(buffer + 1, sha1)) {
234 struct object *object = parse_object(sha1);
235 object->flags |= UNINTERESTING;
236 add_pending_object(&revs, object, buffer);
238 } else if (!get_sha1_hex(buffer, sha1)) {
239 struct object *object = parse_object(sha1);
240 object->flags |= SHOWN;
243 fclose(rls_fout);
244 if (finish_command(&rls))
245 return error("rev-list died");
247 /* write references */
248 argc = setup_revisions(argc, argv, &revs, NULL);
249 if (argc > 1)
250 return error("unrecognized argument: %s'", argv[1]);
252 for (i = 0; i < revs.pending.nr; i++) {
253 struct object_array_entry *e = revs.pending.objects + i;
254 unsigned char sha1[20];
255 char *ref;
257 if (e->item->flags & UNINTERESTING)
258 continue;
259 if (dwim_ref(e->name, strlen(e->name), sha1, &ref) != 1)
260 continue;
262 * Make sure the refs we wrote out is correct; --max-count and
263 * other limiting options could have prevented all the tips
264 * from getting output.
266 * Non commit objects such as tags and blobs do not have
267 * this issue as they are not affected by those extra
268 * constraints.
270 if (!(e->item->flags & SHOWN) && e->item->type == OBJ_COMMIT) {
271 warning("ref '%s' is excluded by the rev-list options",
272 e->name);
273 free(ref);
274 continue;
277 * If you run "git bundle create bndl v1.0..v2.0", the
278 * name of the positive ref is "v2.0" but that is the
279 * commit that is referenced by the tag, and not the tag
280 * itself.
282 if (hashcmp(sha1, e->item->sha1)) {
284 * Is this the positive end of a range expressed
285 * in terms of a tag (e.g. v2.0 from the range
286 * "v1.0..v2.0")?
288 struct commit *one = lookup_commit_reference(sha1);
289 struct object *obj;
291 if (e->item == &(one->object)) {
293 * Need to include e->name as an
294 * independent ref to the pack-objects
295 * input, so that the tag is included
296 * in the output; otherwise we would
297 * end up triggering "empty bundle"
298 * error.
300 obj = parse_object(sha1);
301 obj->flags |= SHOWN;
302 add_pending_object(&revs, obj, e->name);
304 free(ref);
305 continue;
308 ref_count++;
309 write_or_die(bundle_fd, sha1_to_hex(e->item->sha1), 40);
310 write_or_die(bundle_fd, " ", 1);
311 write_or_die(bundle_fd, ref, strlen(ref));
312 write_or_die(bundle_fd, "\n", 1);
313 free(ref);
315 if (!ref_count)
316 die ("Refusing to create empty bundle.");
318 /* end header */
319 write_or_die(bundle_fd, "\n", 1);
321 /* write pack */
322 argv_pack[0] = "pack-objects";
323 argv_pack[1] = "--all-progress";
324 argv_pack[2] = "--stdout";
325 argv_pack[3] = "--thin";
326 argv_pack[4] = NULL;
327 memset(&rls, 0, sizeof(rls));
328 rls.argv = argv_pack;
329 rls.in = -1;
330 rls.out = bundle_fd;
331 rls.git_cmd = 1;
332 if (start_command(&rls))
333 return error("Could not spawn pack-objects");
334 for (i = 0; i < revs.pending.nr; i++) {
335 struct object *object = revs.pending.objects[i].item;
336 if (object->flags & UNINTERESTING)
337 write(rls.in, "^", 1);
338 write(rls.in, sha1_to_hex(object->sha1), 40);
339 write(rls.in, "\n", 1);
341 if (finish_command(&rls))
342 return error ("pack-objects died");
343 close(bundle_fd);
344 if (!bundle_to_stdout)
345 commit_lock_file(&lock);
346 return 0;
349 static int unbundle(struct bundle_header *header, int bundle_fd,
350 int argc, const char **argv)
352 const char *argv_index_pack[] = {"index-pack",
353 "--fix-thin", "--stdin", NULL};
354 struct child_process ip;
356 if (verify_bundle(header, 0))
357 return -1;
358 memset(&ip, 0, sizeof(ip));
359 ip.argv = argv_index_pack;
360 ip.in = bundle_fd;
361 ip.no_stdout = 1;
362 ip.git_cmd = 1;
363 if (run_command(&ip))
364 return error("index-pack died");
365 return list_heads(header, argc, argv);
368 int cmd_bundle(int argc, const char **argv, const char *prefix)
370 struct bundle_header header;
371 int nongit = 0;
372 const char *cmd, *bundle_file;
373 int bundle_fd = -1;
374 char buffer[PATH_MAX];
376 if (argc < 3)
377 usage(bundle_usage);
379 cmd = argv[1];
380 bundle_file = argv[2];
381 argc -= 2;
382 argv += 2;
384 prefix = setup_git_directory_gently(&nongit);
385 if (prefix && bundle_file[0] != '/') {
386 snprintf(buffer, sizeof(buffer), "%s/%s", prefix, bundle_file);
387 bundle_file = buffer;
390 memset(&header, 0, sizeof(header));
391 if (strcmp(cmd, "create") &&
392 (bundle_fd = read_header(bundle_file, &header)) < 0)
393 return 1;
395 if (!strcmp(cmd, "verify")) {
396 close(bundle_fd);
397 if (verify_bundle(&header, 1))
398 return 1;
399 fprintf(stderr, "%s is okay\n", bundle_file);
400 return 0;
402 if (!strcmp(cmd, "list-heads")) {
403 close(bundle_fd);
404 return !!list_heads(&header, argc, argv);
406 if (!strcmp(cmd, "create")) {
407 if (nongit)
408 die("Need a repository to create a bundle.");
409 return !!create_bundle(&header, bundle_file, argc, argv);
410 } else if (!strcmp(cmd, "unbundle")) {
411 if (nongit)
412 die("Need a repository to unbundle.");
413 return !!unbundle(&header, bundle_fd, argc, argv);
414 } else
415 usage(bundle_usage);