clone.c 26.3 KB
Newer Older
D
Daniel Barkalow 已提交
1 2 3 4 5 6 7 8 9 10
/*
 * Builtin "git clone"
 *
 * Copyright (c) 2007 Kristian Høgsberg <krh@redhat.com>,
 *		 2008 Daniel Barkalow <barkalow@iabervon.org>
 * Based on git-commit.sh by Junio C Hamano and Linus Torvalds
 *
 * Clone a repository into a different directory that does not yet exist.
 */

S
Stephen Boyd 已提交
11
#include "builtin.h"
D
Daniel Barkalow 已提交
12 13 14 15 16 17 18 19 20
#include "parse-options.h"
#include "fetch-pack.h"
#include "refs.h"
#include "tree.h"
#include "tree-walk.h"
#include "unpack-trees.h"
#include "transport.h"
#include "strbuf.h"
#include "dir.h"
21
#include "sigchain.h"
22
#include "branch.h"
J
Jay Soffian 已提交
23
#include "remote.h"
24
#include "run-command.h"
25
#include "connected.h"
D
Daniel Barkalow 已提交
26 27 28 29 30 31 32 33 34 35

/*
 * Overall FIXMEs:
 *  - respect DB_ENVIRONMENT for .git/objects.
 *
 * Implementation notes:
 *  - dropping use-separate-remote and no-separate-remote compatibility
 *
 */
static const char * const builtin_clone_usage[] = {
36
	N_("git clone [options] [--] <repo> [<dir>]"),
D
Daniel Barkalow 已提交
37 38 39
	NULL
};

40
static int option_no_checkout, option_bare, option_mirror, option_single_branch = -1;
41
static int option_local = -1, option_no_hardlinks, option_shared, option_recursive;
42
static char *option_template, *option_depth;
D
Daniel Barkalow 已提交
43
static char *option_origin = NULL;
44
static char *option_branch = NULL;
45
static const char *real_git_dir;
D
Daniel Barkalow 已提交
46
static char *option_upload_pack = "git-upload-pack";
47
static int option_verbosity;
48
static int option_progress = -1;
49
static struct string_list option_config;
50 51 52 53 54 55 56 57 58 59
static struct string_list option_reference;

static int opt_parse_reference(const struct option *opt, const char *arg, int unset)
{
	struct string_list *option_reference = opt->value;
	if (!arg)
		return -1;
	string_list_append(option_reference, arg);
	return 0;
}
D
Daniel Barkalow 已提交
60 61

static struct option builtin_clone_options[] = {
62
	OPT__VERBOSITY(&option_verbosity),
63
	OPT_BOOL(0, "progress", &option_progress,
64
		 N_("force progress reporting")),
D
Daniel Barkalow 已提交
65
	OPT_BOOLEAN('n', "no-checkout", &option_no_checkout,
66 67
		    N_("don't create a checkout")),
	OPT_BOOLEAN(0, "bare", &option_bare, N_("create a bare repository")),
J
Junio C Hamano 已提交
68
	{ OPTION_BOOLEAN, 0, "naked", &option_bare, NULL,
69
		N_("create a bare repository"),
J
Junio C Hamano 已提交
70
		PARSE_OPT_NOARG | PARSE_OPT_HIDDEN },
71
	OPT_BOOLEAN(0, "mirror", &option_mirror,
72
		    N_("create a mirror repository (implies bare)")),
73
	OPT_BOOL('l', "local", &option_local,
74
		N_("to clone from a local repository")),
D
Daniel Barkalow 已提交
75
	OPT_BOOLEAN(0, "no-hardlinks", &option_no_hardlinks,
76
		    N_("don't use local hardlinks, always copy")),
D
Daniel Barkalow 已提交
77
	OPT_BOOLEAN('s', "shared", &option_shared,
78
		    N_("setup as shared repository")),
79
	OPT_BOOLEAN(0, "recursive", &option_recursive,
80
		    N_("initialize submodules in the clone")),
81
	OPT_BOOLEAN(0, "recurse-submodules", &option_recursive,
82 83 84 85 86 87 88 89 90 91 92 93 94
		    N_("initialize submodules in the clone")),
	OPT_STRING(0, "template", &option_template, N_("template-directory"),
		   N_("directory from which templates will be used")),
	OPT_CALLBACK(0 , "reference", &option_reference, N_("repo"),
		     N_("reference repository"), &opt_parse_reference),
	OPT_STRING('o', "origin", &option_origin, N_("name"),
		   N_("use <name> instead of 'origin' to track upstream")),
	OPT_STRING('b', "branch", &option_branch, N_("branch"),
		   N_("checkout <branch> instead of the remote's HEAD")),
	OPT_STRING('u', "upload-pack", &option_upload_pack, N_("path"),
		   N_("path to git-upload-pack on the remote")),
	OPT_STRING(0, "depth", &option_depth, N_("depth"),
		    N_("create a shallow clone of that depth")),
95
	OPT_BOOL(0, "single-branch", &option_single_branch,
96 97 98 99 100
		    N_("clone only one branch, HEAD or --branch")),
	OPT_STRING(0, "separate-git-dir", &real_git_dir, N_("gitdir"),
		   N_("separate git dir from working tree")),
	OPT_STRING_LIST('c', "config", &option_config, N_("key=value"),
			N_("set config inside the new repository")),
D
Daniel Barkalow 已提交
101 102 103
	OPT_END()
};

104 105 106 107
static const char *argv_submodule[] = {
	"submodule", "update", "--init", "--recursive", NULL
};

D
Daniel Barkalow 已提交
108 109
static char *get_repo_path(const char *repo, int *is_bundle)
{
110
	static char *suffix[] = { "/.git", "", ".git/.git", ".git" };
D
Daniel Barkalow 已提交
111 112 113 114 115 116 117
	static char *bundle_suffix[] = { ".bundle", "" };
	struct stat st;
	int i;

	for (i = 0; i < ARRAY_SIZE(suffix); i++) {
		const char *path;
		path = mkpath("%s%s", repo, suffix[i]);
118 119
		if (stat(path, &st))
			continue;
120
		if (S_ISDIR(st.st_mode) && is_git_directory(path)) {
D
Daniel Barkalow 已提交
121
			*is_bundle = 0;
122
			return xstrdup(absolute_path(path));
123 124 125 126 127 128 129 130 131 132 133 134 135 136 137
		} else if (S_ISREG(st.st_mode) && st.st_size > 8) {
			/* Is it a "gitfile"? */
			char signature[8];
			int len, fd = open(path, O_RDONLY);
			if (fd < 0)
				continue;
			len = read_in_full(fd, signature, 8);
			close(fd);
			if (len != 8 || strncmp(signature, "gitdir: ", 8))
				continue;
			path = read_gitfile(path);
			if (path) {
				*is_bundle = 0;
				return xstrdup(absolute_path(path));
			}
D
Daniel Barkalow 已提交
138 139 140 141 142 143 144 145
		}
	}

	for (i = 0; i < ARRAY_SIZE(bundle_suffix); i++) {
		const char *path;
		path = mkpath("%s%s", repo, bundle_suffix[i]);
		if (!stat(path, &st) && S_ISREG(st.st_mode)) {
			*is_bundle = 1;
146
			return xstrdup(absolute_path(path));
D
Daniel Barkalow 已提交
147 148 149 150 151 152
		}
	}

	return NULL;
}

153
static char *guess_dir_name(const char *repo, int is_bundle, int is_bare)
D
Daniel Barkalow 已提交
154
{
155
	const char *end = repo + strlen(repo), *start;
156
	char *dir;
157 158

	/*
159
	 * Strip trailing spaces, slashes and /.git
160
	 */
161
	while (repo < end && (is_dir_sep(end[-1]) || isspace(end[-1])))
162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187
		end--;
	if (end - repo > 5 && is_dir_sep(end[-5]) &&
	    !strncmp(end - 4, ".git", 4)) {
		end -= 5;
		while (repo < end && is_dir_sep(end[-1]))
			end--;
	}

	/*
	 * Find last component, but be prepared that repo could have
	 * the form  "remote.example.com:foo.git", i.e. no slash
	 * in the directory part.
	 */
	start = end;
	while (repo < start && !is_dir_sep(start[-1]) && start[-1] != ':')
		start--;

	/*
	 * Strip .{bundle,git}.
	 */
	if (is_bundle) {
		if (end - start > 7 && !strncmp(end - 7, ".bundle", 7))
			end -= 7;
	} else {
		if (end - start > 4 && !strncmp(end - 4, ".git", 4))
			end -= 4;
D
Daniel Barkalow 已提交
188 189
	}

190
	if (is_bare) {
191 192
		struct strbuf result = STRBUF_INIT;
		strbuf_addf(&result, "%.*s.git", (int)(end - start), start);
193
		dir = strbuf_detach(&result, NULL);
194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217
	} else
		dir = xstrndup(start, end - start);
	/*
	 * Replace sequences of 'control' characters and whitespace
	 * with one ascii space, remove leading and trailing spaces.
	 */
	if (*dir) {
		char *out = dir;
		int prev_space = 1 /* strip leading whitespace */;
		for (end = dir; *end; ++end) {
			char ch = *end;
			if ((unsigned char)ch < '\x20')
				ch = '\x20';
			if (isspace(ch)) {
				if (prev_space)
					continue;
				prev_space = 1;
			} else
				prev_space = 0;
			*out++ = ch;
		}
		*out = '\0';
		if (out > dir && prev_space)
			out[-1] = '\0';
218
	}
219
	return dir;
D
Daniel Barkalow 已提交
220 221
}

222 223 224 225 226 227 228 229 230
static void strip_trailing_slashes(char *dir)
{
	char *end = dir + strlen(dir);

	while (dir < end - 1 && is_dir_sep(end[-1]))
		end--;
	*end = '\0';
}

231
static int add_one_reference(struct string_list_item *item, void *cb_data)
D
Daniel Barkalow 已提交
232
{
233
	char *ref_git;
234
	const char *repo;
235
	struct strbuf alternate = STRBUF_INIT;
D
Daniel Barkalow 已提交
236

237
	/* Beware: read_gitfile(), real_path() and mkpath() return static buffer */
238
	ref_git = xstrdup(real_path(item->string));
239 240 241 242 243 244 245 246 247 248

	repo = read_gitfile(ref_git);
	if (!repo)
		repo = read_gitfile(mkpath("%s/.git", ref_git));
	if (repo) {
		free(ref_git);
		ref_git = xstrdup(repo);
	}

	if (!repo && is_directory(mkpath("%s/.git/objects", ref_git))) {
249
		char *ref_git_git = mkpathdup("%s/.git", ref_git);
250 251 252
		free(ref_git);
		ref_git = ref_git_git;
	} else if (!is_directory(mkpath("%s/objects", ref_git)))
253
		die(_("reference repository '%s' is not a local repository."),
254
		    item->string);
D
Daniel Barkalow 已提交
255

256 257 258 259
	strbuf_addf(&alternate, "%s/objects", ref_git);
	add_to_alternates_file(alternate.buf);
	strbuf_release(&alternate);
	free(ref_git);
260 261
	return 0;
}
D
Daniel Barkalow 已提交
262

263 264 265
static void setup_reference(void)
{
	for_each_string_list(&option_reference, add_one_reference, NULL);
D
Daniel Barkalow 已提交
266 267
}

268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303
static void copy_alternates(struct strbuf *src, struct strbuf *dst,
			    const char *src_repo)
{
	/*
	 * Read from the source objects/info/alternates file
	 * and copy the entries to corresponding file in the
	 * destination repository with add_to_alternates_file().
	 * Both src and dst have "$path/objects/info/alternates".
	 *
	 * Instead of copying bit-for-bit from the original,
	 * we need to append to existing one so that the already
	 * created entry via "clone -s" is not lost, and also
	 * to turn entries with paths relative to the original
	 * absolute, so that they can be used in the new repository.
	 */
	FILE *in = fopen(src->buf, "r");
	struct strbuf line = STRBUF_INIT;

	while (strbuf_getline(&line, in, '\n') != EOF) {
		char *abs_path, abs_buf[PATH_MAX];
		if (!line.len || line.buf[0] == '#')
			continue;
		if (is_absolute_path(line.buf)) {
			add_to_alternates_file(line.buf);
			continue;
		}
		abs_path = mkpath("%s/objects/%s", src_repo, line.buf);
		normalize_path_copy(abs_buf, abs_path);
		add_to_alternates_file(abs_buf);
	}
	strbuf_release(&line);
	fclose(in);
}

static void copy_or_link_directory(struct strbuf *src, struct strbuf *dest,
				   const char *src_repo, int src_baselen)
D
Daniel Barkalow 已提交
304 305 306 307 308 309
{
	struct dirent *de;
	struct stat buf;
	int src_len, dest_len;
	DIR *dir;

310
	dir = opendir(src->buf);
D
Daniel Barkalow 已提交
311
	if (!dir)
312
		die_errno(_("failed to open '%s'"), src->buf);
D
Daniel Barkalow 已提交
313

314
	if (mkdir(dest->buf, 0777)) {
D
Daniel Barkalow 已提交
315
		if (errno != EEXIST)
316
			die_errno(_("failed to create directory '%s'"), dest->buf);
317
		else if (stat(dest->buf, &buf))
318
			die_errno(_("failed to stat '%s'"), dest->buf);
D
Daniel Barkalow 已提交
319
		else if (!S_ISDIR(buf.st_mode))
320
			die(_("%s exists and is not a directory"), dest->buf);
D
Daniel Barkalow 已提交
321 322
	}

323 324 325 326
	strbuf_addch(src, '/');
	src_len = src->len;
	strbuf_addch(dest, '/');
	dest_len = dest->len;
D
Daniel Barkalow 已提交
327 328

	while ((de = readdir(dir)) != NULL) {
329 330 331 332 333
		strbuf_setlen(src, src_len);
		strbuf_addstr(src, de->d_name);
		strbuf_setlen(dest, dest_len);
		strbuf_addstr(dest, de->d_name);
		if (stat(src->buf, &buf)) {
334
			warning (_("failed to stat %s\n"), src->buf);
D
Daniel Barkalow 已提交
335 336 337 338
			continue;
		}
		if (S_ISDIR(buf.st_mode)) {
			if (de->d_name[0] != '.')
339 340 341 342 343 344 345 346
				copy_or_link_directory(src, dest,
						       src_repo, src_baselen);
			continue;
		}

		/* Files that cannot be copied bit-for-bit... */
		if (!strcmp(src->buf + src_baselen, "/info/alternates")) {
			copy_alternates(src, dest, src_repo);
D
Daniel Barkalow 已提交
347 348 349
			continue;
		}

350
		if (unlink(dest->buf) && errno != ENOENT)
351
			die_errno(_("failed to unlink '%s'"), dest->buf);
352
		if (!option_no_hardlinks) {
353
			if (!link(src->buf, dest->buf))
354
				continue;
355
			if (option_local > 0)
356
				die_errno(_("failed to create link '%s'"), dest->buf);
357
			option_no_hardlinks = 1;
D
Daniel Barkalow 已提交
358
		}
359
		if (copy_file_with_time(dest->buf, src->buf, 0666))
360
			die_errno(_("failed to copy file to '%s'"), dest->buf);
D
Daniel Barkalow 已提交
361
	}
362
	closedir(dir);
D
Daniel Barkalow 已提交
363 364
}

365
static void clone_local(const char *src_repo, const char *dest_repo)
D
Daniel Barkalow 已提交
366
{
367 368 369 370 371 372 373 374
	if (option_shared) {
		struct strbuf alt = STRBUF_INIT;
		strbuf_addf(&alt, "%s/objects", src_repo);
		add_to_alternates_file(alt.buf);
		strbuf_release(&alt);
	} else {
		struct strbuf src = STRBUF_INIT;
		struct strbuf dest = STRBUF_INIT;
375 376
		strbuf_addf(&src, "%s/objects", src_repo);
		strbuf_addf(&dest, "%s/objects", dest_repo);
377
		copy_or_link_directory(&src, &dest, src_repo, src.len);
378 379
		strbuf_release(&src);
		strbuf_release(&dest);
D
Daniel Barkalow 已提交
380 381
	}

382
	if (0 <= option_verbosity)
383
		printf(_("done.\n"));
D
Daniel Barkalow 已提交
384 385 386 387
}

static const char *junk_work_tree;
static const char *junk_git_dir;
388
static pid_t junk_pid;
389
static enum {
390 391 392 393 394 395 396 397 398
	JUNK_LEAVE_NONE,
	JUNK_LEAVE_REPO,
	JUNK_LEAVE_ALL
} junk_mode = JUNK_LEAVE_NONE;

static const char junk_leave_repo_msg[] =
N_("Clone succeeded, but checkout failed.\n"
   "You can inspect what was checked out with 'git status'\n"
   "and retry the checkout with 'git checkout -f HEAD'\n");
D
Daniel Barkalow 已提交
399 400 401

static void remove_junk(void)
{
402
	struct strbuf sb = STRBUF_INIT;
403 404 405 406 407 408 409 410 411 412 413 414

	switch (junk_mode) {
	case JUNK_LEAVE_REPO:
		warning("%s", _(junk_leave_repo_msg));
		/* fall-through */
	case JUNK_LEAVE_ALL:
		return;
	default:
		/* proceed to removal */
		break;
	}

D
Daniel Barkalow 已提交
415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431
	if (getpid() != junk_pid)
		return;
	if (junk_git_dir) {
		strbuf_addstr(&sb, junk_git_dir);
		remove_dir_recursively(&sb, 0);
		strbuf_reset(&sb);
	}
	if (junk_work_tree) {
		strbuf_addstr(&sb, junk_work_tree);
		remove_dir_recursively(&sb, 0);
		strbuf_reset(&sb);
	}
}

static void remove_junk_on_signal(int signo)
{
	remove_junk();
432
	sigchain_pop(signo);
D
Daniel Barkalow 已提交
433 434 435
	raise(signo);
}

436 437 438 439 440 441 442 443
static struct ref *find_remote_branch(const struct ref *refs, const char *branch)
{
	struct ref *ref;
	struct strbuf head = STRBUF_INIT;
	strbuf_addstr(&head, "refs/heads/");
	strbuf_addstr(&head, branch);
	ref = find_ref_by_name(refs, head.buf);
	strbuf_release(&head);
444 445 446 447 448 449 450 451 452

	if (ref)
		return ref;

	strbuf_addstr(&head, "refs/tags/");
	strbuf_addstr(&head, branch);
	ref = find_ref_by_name(refs, head.buf);
	strbuf_release(&head);

453 454 455
	return ref;
}

456 457
static struct ref *wanted_peer_refs(const struct ref *refs,
		struct refspec *refspec)
D
Daniel Barkalow 已提交
458
{
J
Jeff King 已提交
459 460 461
	struct ref *head = copy_ref(find_ref_by_name(refs, "HEAD"));
	struct ref *local_refs = head;
	struct ref **tail = head ? &head->next : &local_refs;
D
Daniel Barkalow 已提交
462

463 464 465 466 467
	if (option_single_branch) {
		struct ref *remote_head = NULL;

		if (!option_branch)
			remote_head = guess_remote_head(head, refs, 0);
468 469 470 471 472
		else {
			local_refs = NULL;
			tail = &local_refs;
			remote_head = copy_ref(find_remote_branch(refs, option_branch));
		}
473 474 475 476

		if (!remote_head && option_branch)
			warning(_("Could not find remote branch %s to clone."),
				option_branch);
477
		else {
478
			get_fetch_map(remote_head, refspec, &tail, 0);
479 480 481 482

			/* if --branch=tag, pull the requested tag explicitly */
			get_fetch_map(remote_head, tag_refspec, &tail, 0);
		}
483 484 485 486
	} else
		get_fetch_map(refs, refspec, &tail, 0);

	if (!option_mirror && !option_single_branch)
487
		get_fetch_map(refs, tag_refspec, &tail, 0);
D
Daniel Barkalow 已提交
488

489 490 491 492 493 494 495
	return local_refs;
}

static void write_remote_refs(const struct ref *local_refs)
{
	const struct ref *r;

496 497
	lock_packed_refs(LOCK_DIE_ON_ERROR);

J
Jeff King 已提交
498 499 500
	for (r = local_refs; r; r = r->next) {
		if (!r->peer_ref)
			continue;
501
		add_packed_ref(r->peer_ref->name, r->old_sha1);
J
Jeff King 已提交
502
	}
J
Johan Herland 已提交
503

504 505
	if (commit_packed_refs())
		die_errno("unable to overwrite old ref-pack file");
D
Daniel Barkalow 已提交
506 507
}

508 509 510 511 512 513 514 515 516 517 518 519 520 521 522
static void write_followtags(const struct ref *refs, const char *msg)
{
	const struct ref *ref;
	for (ref = refs; ref; ref = ref->next) {
		if (prefixcmp(ref->name, "refs/tags/"))
			continue;
		if (!suffixcmp(ref->name, "^{}"))
			continue;
		if (!has_sha1_file(ref->old_sha1))
			continue;
		update_ref(msg, ref->name, ref->old_sha1,
			   NULL, 0, DIE_ON_ERR);
	}
}

523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542
static int iterate_ref_map(void *cb_data, unsigned char sha1[20])
{
	struct ref **rm = cb_data;
	struct ref *ref = *rm;

	/*
	 * Skip anything missing a peer_ref, which we are not
	 * actually going to write a ref for.
	 */
	while (ref && !ref->peer_ref)
		ref = ref->next;
	/* Returning -1 notes "end of list" to the caller. */
	if (!ref)
		return -1;

	hashcpy(sha1, ref->old_sha1);
	*rm = ref->next;
	return 0;
}

543 544 545 546
static void update_remote_refs(const struct ref *refs,
			       const struct ref *mapped_refs,
			       const struct ref *remote_head_points_at,
			       const char *branch_top,
547 548
			       const char *msg,
			       struct transport *transport)
549
{
550 551
	const struct ref *rm = mapped_refs;

552 553
	if (0 <= option_verbosity)
		printf(_("Checking connectivity... "));
554 555
	if (check_everything_connected_with_transport(iterate_ref_map,
						      0, &rm, transport))
556
		die(_("remote did not send all necessary objects"));
557 558
	if (0 <= option_verbosity)
		printf(_("done\n"));
559

560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575
	if (refs) {
		write_remote_refs(mapped_refs);
		if (option_single_branch)
			write_followtags(refs, msg);
	}

	if (remote_head_points_at && !option_bare) {
		struct strbuf head_ref = STRBUF_INIT;
		strbuf_addstr(&head_ref, branch_top);
		strbuf_addstr(&head_ref, "HEAD");
		create_symref(head_ref.buf,
			      remote_head_points_at->peer_ref->name,
			      msg);
	}
}

576 577 578
static void update_head(const struct ref *our, const struct ref *remote,
			const char *msg)
{
579
	if (our && !prefixcmp(our->name, "refs/heads/")) {
580 581 582 583 584 585 586
		/* Local default branch link */
		create_symref("HEAD", our->name, NULL);
		if (!option_bare) {
			const char *head = skip_prefix(our->name, "refs/heads/");
			update_ref(msg, "HEAD", our->old_sha1, NULL, 0, DIE_ON_ERR);
			install_branch_config(0, head, option_origin, our->name);
		}
587 588 589 590 591
	} else if (our) {
		struct commit *c = lookup_commit_reference(our->old_sha1);
		/* --branch specifies a non-branch (i.e. tags), detach HEAD */
		update_ref(msg, "HEAD", c->object.sha1,
			   NULL, REF_NODEREF, DIE_ON_ERR);
592 593 594
	} else if (remote) {
		/*
		 * We know remote HEAD points to a non-branch, or
595
		 * HEAD points to a branch but we don't know which one.
596 597 598 599 600 601 602
		 * Detach HEAD in all these cases.
		 */
		update_ref(msg, "HEAD", remote->old_sha1,
			   NULL, REF_NODEREF, DIE_ON_ERR);
	}
}

603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621
static int checkout(void)
{
	unsigned char sha1[20];
	char *head;
	struct lock_file *lock_file;
	struct unpack_trees_options opts;
	struct tree *tree;
	struct tree_desc t;
	int err = 0, fd;

	if (option_no_checkout)
		return 0;

	head = resolve_refdup("HEAD", sha1, 1, NULL);
	if (!head) {
		warning(_("remote HEAD refers to nonexistent ref, "
			  "unable to checkout.\n"));
		return 0;
	}
622 623 624 625
	if (!strcmp(head, "HEAD")) {
		if (advice_detached_head)
			detach_advice(sha1_to_hex(sha1));
	} else {
626 627 628 629 630 631 632 633 634 635 636 637 638 639 640
		if (prefixcmp(head, "refs/heads/"))
			die(_("HEAD not found below refs/heads!"));
	}
	free(head);

	/* We need to be in the new work tree for the checkout */
	setup_work_tree();

	lock_file = xcalloc(1, sizeof(struct lock_file));
	fd = hold_locked_index(lock_file, 1);

	memset(&opts, 0, sizeof opts);
	opts.update = 1;
	opts.merge = 1;
	opts.fn = oneway_merge;
641
	opts.verbose_update = (option_verbosity >= 0);
642 643 644 645 646 647
	opts.src_index = &the_index;
	opts.dst_index = &the_index;

	tree = parse_tree_indirect(sha1);
	parse_tree(tree);
	init_tree_desc(&t, tree->buffer, tree->size);
648 649
	if (unpack_trees(1, &t, &opts) < 0)
		die(_("unable to checkout working tree"));
650 651 652 653 654 655 656 657 658 659 660 661 662 663

	if (write_cache(fd, active_cache, active_nr) ||
	    commit_locked_index(lock_file))
		die(_("unable to write new index file"));

	err |= run_hook(NULL, "post-checkout", sha1_to_hex(null_sha1),
			sha1_to_hex(sha1), "1", NULL);

	if (!err && option_recursive)
		err = run_command_v_opt(argv_submodule, RUN_GIT_CMD);

	return err;
}

664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679
static int write_one_config(const char *key, const char *value, void *data)
{
	return git_config_set_multivar(key, value ? value : "true", "^$", 0);
}

static void write_config(struct string_list *config)
{
	int i;

	for (i = 0; i < config->nr; i++) {
		if (git_config_parse_parameter(config->items[i].string,
					       write_one_config, NULL) < 0)
			die("unable to write parameters to config file");
	}
}

680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703
static void write_refspec_config(const char* src_ref_prefix,
		const struct ref* our_head_points_at,
		const struct ref* remote_head_points_at, struct strbuf* branch_top)
{
	struct strbuf key = STRBUF_INIT;
	struct strbuf value = STRBUF_INIT;

	if (option_mirror || !option_bare) {
		if (option_single_branch && !option_mirror) {
			if (option_branch) {
				if (strstr(our_head_points_at->name, "refs/tags/"))
					strbuf_addf(&value, "+%s:%s", our_head_points_at->name,
						our_head_points_at->name);
				else
					strbuf_addf(&value, "+%s:%s%s", our_head_points_at->name,
						branch_top->buf, option_branch);
			} else if (remote_head_points_at) {
				strbuf_addf(&value, "+%s:%s%s", remote_head_points_at->name,
						branch_top->buf,
						skip_prefix(remote_head_points_at->name, "refs/heads/"));
			}
			/*
			 * otherwise, the next "git fetch" will
			 * simply fetch from HEAD without updating
704
			 * any remote-tracking branch, which is what
705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 720 721 722 723 724 725 726 727
			 * we want.
			 */
		} else {
			strbuf_addf(&value, "+%s*:%s*", src_ref_prefix, branch_top->buf);
		}
		/* Configure the remote */
		if (value.len) {
			strbuf_addf(&key, "remote.%s.fetch", option_origin);
			git_config_set_multivar(key.buf, value.buf, "^$", 0);
			strbuf_reset(&key);

			if (option_mirror) {
				strbuf_addf(&key, "remote.%s.mirror", option_origin);
				git_config_set(key.buf, "true");
				strbuf_reset(&key);
			}
		}
	}

	strbuf_release(&key);
	strbuf_release(&value);
}

D
Daniel Barkalow 已提交
728 729
int cmd_clone(int argc, const char **argv, const char *prefix)
{
730
	int is_bundle = 0, is_local;
D
Daniel Barkalow 已提交
731 732 733
	struct stat buf;
	const char *repo_name, *repo, *work_tree, *git_dir;
	char *path, *dir;
734
	int dest_exists;
D
Daniel Barkalow 已提交
735
	const struct ref *refs, *remote_head;
736 737
	const struct ref *remote_head_points_at;
	const struct ref *our_head_points_at;
D
Daniel Barkalow 已提交
738
	struct ref *mapped_refs;
739
	const struct ref *ref;
740 741
	struct strbuf key = STRBUF_INIT, value = STRBUF_INIT;
	struct strbuf branch_top = STRBUF_INIT, reflog_msg = STRBUF_INIT;
742
	struct transport *transport = NULL;
743
	const char *src_ref_prefix = "refs/heads/";
744
	struct remote *remote;
745
	int err = 0, complete_refs_before_fetch = 1;
D
Daniel Barkalow 已提交
746

747 748
	struct refspec *refspec;
	const char *fetch_pattern;
D
Daniel Barkalow 已提交
749 750 751

	junk_pid = getpid();

J
Jeff King 已提交
752
	packet_trace_identity("clone");
753
	argc = parse_options(argc, argv, prefix, builtin_clone_options,
D
Daniel Barkalow 已提交
754 755
			     builtin_clone_usage, 0);

J
Jonathan Nieder 已提交
756
	if (argc > 2)
757
		usage_msg_opt(_("Too many arguments."),
J
Jonathan Nieder 已提交
758 759
			builtin_clone_usage, builtin_clone_options);

D
Daniel Barkalow 已提交
760
	if (argc == 0)
761
		usage_msg_opt(_("You must specify a repository to clone."),
J
Jonathan Nieder 已提交
762
			builtin_clone_usage, builtin_clone_options);
D
Daniel Barkalow 已提交
763

764 765 766
	if (option_single_branch == -1)
		option_single_branch = option_depth ? 1 : 0;

767 768 769
	if (option_mirror)
		option_bare = 1;

D
Daniel Barkalow 已提交
770 771
	if (option_bare) {
		if (option_origin)
772
			die(_("--bare and --origin %s options are incompatible."),
D
Daniel Barkalow 已提交
773
			    option_origin);
774 775
		if (real_git_dir)
			die(_("--bare and --separate-git-dir are incompatible."));
D
Daniel Barkalow 已提交
776 777 778 779 780 781 782 783 784 785
		option_no_checkout = 1;
	}

	if (!option_origin)
		option_origin = "origin";

	repo_name = argv[0];

	path = get_repo_path(repo_name, &is_bundle);
	if (path)
786
		repo = xstrdup(absolute_path(repo_name));
D
Daniel Barkalow 已提交
787
	else if (!strchr(repo_name, ':'))
788
		die(_("repository '%s' does not exist"), repo_name);
D
Daniel Barkalow 已提交
789 790
	else
		repo = repo_name;
791
	is_local = option_local != 0 && path && !is_bundle;
792
	if (is_local && option_depth)
793
		warning(_("--depth is ignored in local clones; use file:// instead."));
794 795
	if (option_local > 0 && !is_local)
		warning(_("--local is ignored"));
D
Daniel Barkalow 已提交
796 797 798 799

	if (argc == 2)
		dir = xstrdup(argv[1]);
	else
800
		dir = guess_dir_name(repo_name, is_bundle, option_bare);
801
	strip_trailing_slashes(dir);
D
Daniel Barkalow 已提交
802

803 804
	dest_exists = !stat(dir, &buf);
	if (dest_exists && !is_empty_dir(dir))
805 806
		die(_("destination path '%s' already exists and is not "
			"an empty directory."), dir);
D
Daniel Barkalow 已提交
807 808 809 810 811 812 813 814

	strbuf_addf(&reflog_msg, "clone: from %s", repo);

	if (option_bare)
		work_tree = NULL;
	else {
		work_tree = getenv("GIT_WORK_TREE");
		if (work_tree && !stat(work_tree, &buf))
815
			die(_("working tree '%s' already exists."), work_tree);
D
Daniel Barkalow 已提交
816 817 818 819 820 821
	}

	if (option_bare || work_tree)
		git_dir = xstrdup(dir);
	else {
		work_tree = dir;
822
		git_dir = mkpathdup("%s/.git", dir);
D
Daniel Barkalow 已提交
823 824 825 826
	}

	if (!option_bare) {
		junk_work_tree = work_tree;
827
		if (safe_create_leading_directories_const(work_tree) < 0)
828
			die_errno(_("could not create leading directories of '%s'"),
829
				  work_tree);
830
		if (!dest_exists && mkdir(work_tree, 0777))
831
			die_errno(_("could not create work tree dir '%s'."),
832
				  work_tree);
D
Daniel Barkalow 已提交
833 834 835 836
		set_git_work_tree(work_tree);
	}
	junk_git_dir = git_dir;
	atexit(remove_junk);
837
	sigchain_push_common(remove_junk_on_signal);
D
Daniel Barkalow 已提交
838

839
	if (safe_create_leading_directories_const(git_dir) < 0)
840
		die(_("could not create leading directories of '%s'"), git_dir);
841 842

	set_git_dir_init(git_dir, real_git_dir, 0);
843
	if (real_git_dir) {
844
		git_dir = real_git_dir;
845 846
		junk_git_dir = real_git_dir;
	}
D
Daniel Barkalow 已提交
847

848 849
	if (0 <= option_verbosity) {
		if (option_bare)
850
			printf(_("Cloning into bare repository '%s'...\n"), dir);
851
		else
852
			printf(_("Cloning into '%s'...\n"), dir);
853
	}
854
	init_db(option_template, INIT_DB_QUIET);
855
	write_config(&option_config);
D
Daniel Barkalow 已提交
856

J
Junio C Hamano 已提交
857
	git_config(git_default_config, NULL);
D
Daniel Barkalow 已提交
858 859

	if (option_bare) {
860 861
		if (option_mirror)
			src_ref_prefix = "refs/";
862
		strbuf_addstr(&branch_top, src_ref_prefix);
D
Daniel Barkalow 已提交
863 864 865

		git_config_set("core.bare", "true");
	} else {
866
		strbuf_addf(&branch_top, "refs/remotes/%s/", option_origin);
867
	}
D
Daniel Barkalow 已提交
868

869
	strbuf_addf(&value, "+%s*:%s*", src_ref_prefix, branch_top.buf);
870 871 872 873
	strbuf_addf(&key, "remote.%s.url", option_origin);
	git_config_set(key.buf, repo);
	strbuf_reset(&key);

874 875
	if (option_reference.nr)
		setup_reference();
876

877 878 879 880
	fetch_pattern = value.buf;
	refspec = parse_fetch_refspec(1, &fetch_pattern);

	strbuf_reset(&value);
D
Daniel Barkalow 已提交
881

882 883
	remote = remote_get(option_origin);
	transport = transport_get(remote, remote->url[0]);
D
Daniel Barkalow 已提交
884

885
	if (!is_local) {
886
		if (!transport->get_refs_list || !transport->fetch)
887
			die(_("Don't know how to clone %s"), transport->url);
888

D
Daniel Barkalow 已提交
889 890 891 892 893
		transport_set_option(transport, TRANS_OPT_KEEP, "yes");

		if (option_depth)
			transport_set_option(transport, TRANS_OPT_DEPTH,
					     option_depth);
894 895
		if (option_single_branch)
			transport_set_option(transport, TRANS_OPT_FOLLOWTAGS, "1");
D
Daniel Barkalow 已提交
896

897
		transport_set_verbosity(transport, option_verbosity, option_progress);
D
Daniel Barkalow 已提交
898

899 900 901
		if (option_upload_pack)
			transport_set_option(transport, TRANS_OPT_UPLOADPACK,
					     option_upload_pack);
902 903 904

		if (transport->smart_options && !option_depth)
			transport->smart_options->check_self_contained_and_connected = 1;
D
Daniel Barkalow 已提交
905 906
	}

907
	refs = transport_get_remote_refs(transport);
D
Daniel Barkalow 已提交
908

909 910 911 912 913 914 915 916 917 918 919 920 921 922 923 924 925
	if (refs) {
		mapped_refs = wanted_peer_refs(refs, refspec);
		/*
		 * transport_get_remote_refs() may return refs with null sha-1
		 * in mapped_refs (see struct transport->get_refs_list
		 * comment). In that case we need fetch it early because
		 * remote_head code below relies on it.
		 *
		 * for normal clones, transport_get_remote_refs() should
		 * return reliable ref set, we can delay cloning until after
		 * remote HEAD check.
		 */
		for (ref = refs; ref; ref = ref->next)
			if (is_null_sha1(ref->old_sha1)) {
				complete_refs_before_fetch = 0;
				break;
			}
926

927 928
		if (!is_local && !complete_refs_before_fetch)
			transport_fetch_refs(transport, mapped_refs);
D
Daniel Barkalow 已提交
929

930
		remote_head = find_ref_by_name(refs, "HEAD");
931 932 933 934 935
		remote_head_points_at =
			guess_remote_head(remote_head, mapped_refs, 0);

		if (option_branch) {
			our_head_points_at =
936
				find_remote_branch(mapped_refs, option_branch);
937

938 939 940
			if (!our_head_points_at)
				die(_("Remote branch %s not found in upstream %s"),
				    option_branch, option_origin);
941 942 943
		}
		else
			our_head_points_at = remote_head_points_at;
944 945
	}
	else {
946
		warning(_("You appear to have cloned an empty repository."));
947
		mapped_refs = NULL;
948 949
		our_head_points_at = NULL;
		remote_head_points_at = NULL;
950 951
		remote_head = NULL;
		option_no_checkout = 1;
952
		if (!option_bare)
953
			install_branch_config(0, "master", option_origin,
954
					      "refs/heads/master");
955
	}
D
Daniel Barkalow 已提交
956

957 958 959
	write_refspec_config(src_ref_prefix, our_head_points_at,
			remote_head_points_at, &branch_top);

960 961
	if (is_local)
		clone_local(path, git_dir);
962
	else if (refs && complete_refs_before_fetch)
963
		transport_fetch_refs(transport, mapped_refs);
D
Daniel Barkalow 已提交
964

965
	update_remote_refs(refs, mapped_refs, remote_head_points_at,
966
			   branch_top.buf, reflog_msg.buf, transport);
D
Daniel Barkalow 已提交
967

968
	update_head(our_head_points_at, remote_head, reflog_msg.buf);
969

970 971
	transport_unlock_pack(transport);
	transport_disconnect(transport);
972

973
	junk_mode = JUNK_LEAVE_REPO;
974
	err = checkout();
D
Daniel Barkalow 已提交
975 976

	strbuf_release(&reflog_msg);
977 978 979
	strbuf_release(&branch_top);
	strbuf_release(&key);
	strbuf_release(&value);
980
	junk_mode = JUNK_LEAVE_ALL;
981
	return err;
D
Daniel Barkalow 已提交
982
}