git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH v5 3/3] clone: respect remote unborn HEAD

From
Junio C Hamano <gitster@pobox.com>
Date
Jan 26, 2021, 22:24 UTC
Message-ID
<xmqqzh0vz69k.fsf@gitster.c.googlers.com>
In-Reply-To
<922e8c229c359c15f1265876e6def87d7a18b763.1611686656.git.jonathantanmy@google.com>
Jonathan Tan <jonathantanmy@google.com> writes:
>  init.defaultBranch::
>  	Allows overriding the default branch name e.g. when initializing
> -	a new repository or when cloning an empty repository.
> +	a new repository.
Looking good.
Show 26 quoted lines
> diff --git a/builtin/clone.c b/builtin/clone.c
> index 211d4f54b0..77fdc61f4d 100644
> --- a/builtin/clone.c
> +++ b/builtin/clone.c
> @@ -1330,10 +1330,21 @@ int cmd_clone(int argc, const char **argv, const char *prefix)
>  		remote_head = NULL;
>  		option_no_checkout = 1;
>  		if (!option_bare) {
> -			const char *branch = git_default_branch_name();
> -			char *ref = xstrfmt("refs/heads/%s", branch);
> +			const char *branch;
> +			char *ref;
> +
> +			if (transport_ls_refs_options.unborn_head_target &&
> +			    skip_prefix(transport_ls_refs_options.unborn_head_target,
> +					"refs/heads/", &branch)) {
> +				ref = transport_ls_refs_options.unborn_head_target;
> +				transport_ls_refs_options.unborn_head_target = NULL;
> +			} else {
> +				branch = git_default_branch_name();
> +				ref = xstrfmt("refs/heads/%s", branch);
> +			}
>  
>  			install_branch_config(0, branch, remote_name, ref);
> +			create_symref("HEAD", ref, "");
>  			free(ref);

OK, we used to say "point our HEAD always to the local default name", and the code is still there in the else clause. But when the transport found what name the other side uses, we use that name instead.

I presume that clearing transport_ls_ref_options.unborn_head_target is to take ownership of this piece of memory ourselves?

We didn't call create_symref() in the original code, but now we do. Is this a valid bugfix even if we did not have this "learn remote symref even for unborn HEAD" feature? Or is the original codepath now somehow got broken with an extra create_symref() that we used not to do, but now we do?

Show 44 quoted lines
> @@ -1385,5 +1396,6 @@ int cmd_clone(int argc, const char **argv, const char *prefix)
>  	junk_mode = JUNK_LEAVE_ALL;
>  
>  	strvec_clear(&transport_ls_refs_options.ref_prefixes);
> +	free(transport_ls_refs_options.unborn_head_target);
>  	return err;
>  }
> diff --git a/connect.c b/connect.c
> index 328c279250..879669df93 100644
> --- a/connect.c
> +++ b/connect.c
> @@ -376,7 +376,8 @@ struct ref **get_remote_heads(struct packet_reader *reader,
>  }
>  
>  /* Returns 1 when a valid ref has been added to `list`, 0 otherwise */
> -static int process_ref_v2(struct packet_reader *reader, struct ref ***list)
> +static int process_ref_v2(struct packet_reader *reader, struct ref ***list,
> +			  char **unborn_head_target)
>  {
>  	int ret = 1;
>  	int i = 0;
> @@ -397,6 +398,25 @@ static int process_ref_v2(struct packet_reader *reader, struct ref ***list)
>  		goto out;
>  	}
>  
> +	if (!strcmp("unborn", line_sections.items[i].string)) {
> +		i++;
> +		if (unborn_head_target &&
> +		    !strcmp("HEAD", line_sections.items[i++].string)) {
> +			/*
> +			 * Look for the symref target (if any). If found,
> +			 * return it to the caller.
> +			 */
> +			for (; i < line_sections.nr; i++) {
> +				const char *arg = line_sections.items[i].string;
> +
> +				if (skip_prefix(arg, "symref-target:", &arg)) {
> +					*unborn_head_target = xstrdup(arg);
> +					break;
> +				}
> +			}
> +		}
> +		goto out;
> +	}

We split the line and notice that the first token is "unborn"; if the caller is not interested in the unborn head, we just skip the rest, but otherwise, if it is about HEAD (i.e. we do not care if a dangling symref that is not HEAD is reported), we notice the target in unborn_head_target.

OK.  We already saw how this is used in cmd_clone().
Show 6 quoted lines
> @@ -461,6 +481,8 @@ struct ref **get_remote_refs(int fd_out, struct packet_reader *reader,
>  	const char *hash_name;
>  	struct strvec *ref_prefixes = transport_options ?
>  		&transport_options->ref_prefixes : NULL;
> +	char **unborn_head_target = transport_options ?
> +		&transport_options->unborn_head_target : NULL;

So any caller that passes transport_options will get the unborn head information for free? The other callers are in fetch-pack.c and transport.c, which presumably are about fetching and not cloning.

I recall discussions on filling a missing refs/remotes/X/HEAD when we fetch from X and learn where X points at. Such an extension can be done on top of this mechanism to pass transport_options from the fetch codepath, I presume?

Thanks. I tried to follow the thought in the patches aloud, and it was mostly a pleasant read.

Previous: Jonathan TanNext: Jonathan Tan
Message 76 of 109 in “Cloning empty repository uses locally configured default branch name”
  1. Jonathan TanDec 8, 2020
  2. Junio C HamanoDec 8, 2020
  3. brian m. carlsonDec 8, 2020
  4. Jonathan TanDec 8, 2020
  5. Junio C HamanoDec 8, 2020
  6. Jeff KingDec 8, 2020
  7. Jonathan TanDec 8, 2020
  8. Jeff KingDec 8, 2020
  9. clone: in protocol v2, use remote's default branchJonathan Tan, Dec 11, 2020
  10. Junio C HamanoDec 11, 2020
  11. Ævar Arnfjörð BjarmasonDec 14, 2020
  12. Felipe ContrerasDec 14, 2020
  13. Junio C HamanoDec 14, 2020
  14. Ævar Arnfjörð BjarmasonDec 15, 2020
  15. Junio C HamanoDec 15, 2020
  16. Jeff KingDec 15, 2020
  17. Junio C HamanoDec 15, 2020
  18. Jeff KingDec 15, 2020
  19. Junio C HamanoDec 16, 2020
  20. Jeff KingDec 16, 2020
  21. Junio C HamanoDec 16, 2020
  22. Jeff KingDec 18, 2020
  23. Felipe ContrerasDec 15, 2020
  24. Jonathan TanDec 14, 2020
  25. Felipe ContrerasDec 14, 2020
  26. Jeff KingDec 15, 2020
  27. Jonathan TanDec 15, 2020
  28. 0/3 Cloning with remote unborn HEADJonathan Tan, Dec 16, 2020
  29. 1/3 ls-refs: report unborn targets of symrefsJonathan Tan, Dec 16, 2020
  30. Junio C HamanoDec 16, 2020
  31. Jonathan TanDec 16, 2020
  32. Jeff KingDec 16, 2020
  33. Jonathan TanDec 16, 2020
  34. Junio C HamanoDec 17, 2020
  35. Jeff KingDec 18, 2020
  36. 2/3 connect, transport: add no-op arg for future patchJonathan Tan, Dec 16, 2020
  37. Junio C HamanoDec 16, 2020
  38. 3/3 clone: respect remote unborn HEADJonathan Tan, Dec 16, 2020
  39. 0/3 Cloning with remote unborn HEADJonathan Tan, Dec 21, 2020
  40. 1/3 ls-refs: report unborn targets of symrefsJonathan Tan, Dec 21, 2020
  41. 2/3 connect, transport: add no-op arg for future patchJonathan Tan, Dec 21, 2020
  42. 3/3 clone: respect remote unborn HEADJonathan Tan, Dec 21, 2020
  43. Junio C HamanoDec 21, 2020
  44. Jeff KingJan 21, 2021
  45. 0/3 Cloning with remote unborn HEADJonathan Tan, Dec 22, 2020
  46. 1/3 ls-refs: report unborn targets of symrefsJonathan Tan, Dec 22, 2020
  47. Jeff KingJan 21, 2021
  48. Jonathan TanJan 26, 2021
  49. Jeff KingJan 26, 2021
  50. 2/3 connect, transport: add no-op arg for future patchJonathan Tan, Dec 22, 2020
  51. Jeff KingJan 21, 2021
  52. Jonathan TanJan 26, 2021
  53. 3/3 clone: respect remote unborn HEADJonathan Tan, Dec 22, 2020
  54. Jeff KingJan 21, 2021
  55. Jonathan TanJan 26, 2021
  56. Jeff KingJan 26, 2021
  57. Junio C HamanoJan 28, 2021
  58. Junio C HamanoDec 22, 2020
  59. 0/3 Cloning with remote unborn HEADJonathan Tan, Jan 26, 2021
  60. 1/3 ls-refs: report unborn targets of symrefsJonathan Tan, Jan 26, 2021
  61. Junio C HamanoJan 26, 2021
  62. Jeff KingJan 26, 2021
  63. Junio C HamanoJan 26, 2021
  64. Junio C HamanoJan 26, 2021
  65. Jonathan TanJan 30, 2021
  66. Jonathan TanJan 29, 2021
  67. Junio C HamanoJan 29, 2021
  68. Jonathan TanFeb 2, 2021
  69. Junio C HamanoFeb 2, 2021
  70. Ævar Arnfjörð BjarmasonJan 27, 2021
  71. Jonathan TanJan 30, 2021
  72. 2/3 connect, transport: encapsulate arg in structJonathan Tan, Jan 26, 2021
  73. Junio C HamanoJan 26, 2021
  74. Jonathan TanJan 30, 2021
  75. 3/3 clone: respect remote unborn HEADJonathan Tan, Jan 26, 2021
  76. Junio C HamanoJan 26, 2021
  77. Jonathan TanJan 30, 2021
  78. Ævar Arnfjörð BjarmasonJan 27, 2021
  79. Jonathan TanJan 30, 2021
  80. Ævar Arnfjörð BjarmasonJan 30, 2021
  81. Jonathan TanFeb 2, 2021
  82. Ævar Arnfjörð BjarmasonFeb 3, 2021
  83. Junio C HamanoFeb 5, 2021
  84. Junio C HamanoJan 27, 2021
  85. Jeff KingJan 27, 2021
  86. Junio C HamanoJan 27, 2021
  87. 0/3 Cloning with remote unborn HEADJonathan Tan, Feb 2, 2021
  88. 1/3 ls-refs: report unborn targets of symrefsJonathan Tan, Feb 2, 2021
  89. Junio C HamanoFeb 2, 2021
  90. Jonathan TanFeb 2, 2021
  91. Junio C HamanoFeb 2, 2021
  92. Jonathan TanFeb 3, 2021
  93. 2/3 connect, transport: encapsulate arg in structJonathan Tan, Feb 2, 2021
  94. 3/3 clone: respect remote unborn HEADJonathan Tan, Feb 2, 2021
  95. 0/3 Cloning with remote unborn HEADJonathan Tan, Feb 5, 2021
  96. 1/3 ls-refs: report unborn targets of symrefsJonathan Tan, Feb 5, 2021
  97. Jeff KingFeb 5, 2021
  98. 2/3 connect, transport: encapsulate arg in structJonathan Tan, Feb 5, 2021
  99. 3/3 clone: respect remote unborn HEADJonathan Tan, Feb 5, 2021
  100. Junio C HamanoFeb 5, 2021
  101. Ævar Arnfjörð BjarmasonFeb 5, 2021
  102. Junio C HamanoFeb 5, 2021
  103. Jeff KingFeb 5, 2021
  104. 0/3 Cloning with remote unborn HEADJonathan Tan, Feb 5, 2021
  105. 3/3 clone: respect remote unborn HEADJonathan Tan, Feb 5, 2021
  106. 2/3 connect, transport: encapsulate arg in structJonathan Tan, Feb 5, 2021
  107. 1/3 ls-refs: report unborn targets of symrefsJonathan Tan, Feb 5, 2021
  108. Junio C HamanoFeb 6, 2021
  109. Junio C HamanoFeb 8, 2021

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.