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

Re: [PATCH] refs/files: keep root refs out of loose ref cache

From
Patrick Steinhardt <ps@pks.im>
Date
Oct 16, 2026, 07:00 UTC
Message-ID
<atHLkIADa6BlO_a-@pks.im>
In-Reply-To
<CAHWeT-Z4n=txTGaBNuGPj3jcOou91owB59gvaPvF=2_p50eFHA@mail.gmail.com>
On Thu, Oct 15, 2026 at 08:43:06PM +0100, Andy Koppe wrote:
Show 54 quoted lines
> Junio C Hamano <gitster@pobox.com> wrote:
> > Patrick Steinhardt <ps@pks.im> writes:
> >>> +/*
> >>> + * Create a separate ref cache containing only the root refs. These are kept
> >>> + * out of the loose ref cache, which may already exist and is shared by
> >>> + * iterations that should not include them.
> >>> + */
> >>
> >> This raises the question whether an alternative fix could have been to
> >> teach the cache itself to skip over root refs in case the caller is not
> >> interested in them. The answer may very well be a "no", but I would be
> >> curious to learn why you settled on the proposed fix instead.
> >> ...
> >>> -    loose_iter = cache_ref_iterator_begin(get_loose_ref_cache(refs, flags),
> >>> +    loose_iter = cache_ref_iterator_begin(get_loose_ref_cache(refs),
> >>>                                            prefix, ref_store->repo, 1);
> >>>
> >>> +    if (flags & REFS_FOR_EACH_INCLUDE_ROOT_REFS) {
> >>> +            root_refs = create_root_ref_cache(refs);
> >>> +            loose_iter = overlay_ref_iterator_begin(
> >>> +                            cache_ref_iterator_begin(root_refs, prefix,
> >>> +                                                     ref_store->repo, 0),
> >>> +                            loose_iter);
> >>> +    }
> >>
> >> It's a bit weird that we recreate the root ref "cache" for every single
> >> ref iterator we create that asks for root refs. Is there a reason why
> >> you have decided to not actually cache the root refs the same way as we
> >> cache the loose refs?
> >
> > Curious.
> >
> > So an alternative would be to have two caches, the primary one for
> > things under refs/ hierarchy and the other one for those outside,
> > and callers can choose to use only the primary one or use both of
> > them?
> 
> Thanks for considering this.
> 
> I think it makes for a simpler change with less overhead to not
> actually cache them, as there are only two uses of the
> REFS_FOR_EACH_INCLUDE_ROOT_REFS flag: in builtin/for-each-ref.c for
> `git for-each-ref --include-root-refs`, and in builtin/refs.c for `git
> refs migrate`. And both only invoke it once.
> 
> I considered keeping the root refs in the loose ref cache but skipping
> them during iteration if the flag is unset. But that would mean more
> impact on that much more common case.
> 
> A cleaner approach might be to drop the flag and change all call sites
> that currently ask for all refs without setting the flag, so that they
> explicitly ask for "refs/" only. That way root refs wouldn't need as
> much special handling. But of course that would be a much bigger and
> more risky change.

That's fair. I guess the part that triggers me is that it's called a "cache" whereas we don't really use it as one in this instance. But that's a historical wart, and I agree that the proposed solution is good enough.

Thanks!
Patrick
Previous: Andy KoppeNext: Junio C Hamano
Message 5 of 13 in “refs/files: keep root refs out of loose ref cache”
  1. refs/files: keep root refs out of loose ref cacheAndy Koppe, Oct 14, 2026
  2. Patrick SteinhardtOct 15, 2026
  3. Junio C HamanoOct 15, 2026
  4. Andy KoppeOct 15, 2026
  5. Patrick SteinhardtOct 16, 2026
  6. Junio C HamanoOct 16, 2026
  7. refs/files: keep root refs out of loose ref cacheAndy Koppe, Oct 17, 2026
  8. Patrick SteinhardtOct 19, 2026
  9. Andy KoppeOct 19, 2026
  10. refs/files: keep root refs out of loose ref cacheAndy Koppe, Oct 19, 2026
  11. Patrick SteinhardtOct 20, 2026
  12. Junio C HamanoOct 21, 2026
  13. Patrick SteinhardtOct 21, 2026

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.