git/list[1] front-page[2] threads[3] people[4] search[5] about
wed 2026-10-07 18:07 UTC

Re: [PATCH 00/13] odb/source-files: move alternates into the backend

From
Patrick Steinhardt <ps@pks.im>
Date
Oct 7, 2026, 05:50 UTC
Message-ID
<asXdne7-Vujgkud1@pks.im>
In-Reply-To
<CAOLa=ZTHSRmwJgsxi9Fq5ek5wVsFYUHD_ohwSmzWLQjcM3TYLA@mail.gmail.com>
On Tue, Oct 06, 2026 at 01:53:24PM -0700, Karthik Nayak wrote:
Show 47 quoted lines
> Patrick Steinhardt <ps@pks.im> writes:
> 
> > Hi,
> >
> > Originally, when designing pluggable object databases the goal was that
> > the object database can have multiple sources, and every source attached
> > to it could use a different backend. This would have allowed for quite a
> > lot of flexibility, as you could trivially mix and match different kinds
> > of object storages in whatever way you like.
> >
> > But while well-intentioned, this design led to a bunch of conceptual
> > problems:
> >
> >   - We're now trying to read objects in source order, whereas we
> >     previously tried to read objects via packfiles before trying to read
> >     them via loose objects. This led to a performance regression when
> >     using alternates or when using a quarantine directory.
> >
> >   - Some data structures are supposed to only ever exist once, like for
> >     example bitmaps and commit graphs. At the same time, those data
> >     structures also span across the union of all objects, so they may
> >     cross sources.
> >
> >   - It is unclear how we can extend GIT_OBJECT_DIRECTORY or
> >     GIT_ALTERNATE_OBJECT_DIRECTORIES to become backend-agnostic in a
> >     backwards-compatible way. In general, introducing an object storage
> >     extension into the current status quo where alternates may have to
> >     be extended to become generic was proving to be painful.
> >
> >   - Some mechanisms of alternates assume way too much about how exactly
> >     their backends work. Alternate refs for example assume that the
> >     alternate is backed by a filesystem path, and that this filesystem
> >     path may also allow us to read references. This is not a given
> >     though, as backends may not even have local data at all.
> >
> > In short, there are a bunch of conceptual mismatches when we have
> > alternates and pluggable object databases coexist. So while the original
> > idea was nice, it does not result in a system that is easy to reason
> > about.
> >
> > This patch series corrects course by moving alternates into the "files"
> > backend itself so that they become another implementation detail. It's
> > unfortunately on the bigger side, and I'm sorry about that, but I
> > couldn't really find a way to split it up further in a sensible way.
> 
> I went through the series, took attention split over two days. The
> changes look good to me, but would definitely like to see another review :)
Thanks for your review!
Patrick
Previous: Patrick Steinhardt
Message 26 of 26 in “odb/source-files: move alternates into the backend”
  1. 00/13 odb/source-files: move alternates into the backendPatrick Steinhardt, Oct 2, 2026
  2. 01/13 commit-graph: require resolved packfile paths for `stdin_packs`Patrick Steinhardt, Oct 2, 2026
  3. 02/13 commit-graph: stop depending on `struct odb_source`Patrick Steinhardt, Oct 2, 2026
  4. 03/13 odb/source-files: introduce `struct odb_files_dir`Patrick Steinhardt, Oct 2, 2026
  5. 04/13 odb: refactor `odb_for_each_alternate()` to yield dirsPatrick Steinhardt, Oct 2, 2026
  6. 05/13 odb: refactor `odb_find_source()` to yield dirsPatrick Steinhardt, Oct 2, 2026
  7. 06/13 odb/source-files: add the ability to have multiple object dirsPatrick Steinhardt, Oct 2, 2026
  8. 07/13 tmp-objdir: absorb logic to set and restore primary sourcesPatrick Steinhardt, Oct 2, 2026
  9. 08/13 tmp-objdir: manage quarantine as an object directoryPatrick Steinhardt, Oct 2, 2026
  10. 09/13 tmp-objdir: replace primary source at creation timePatrick Steinhardt, Oct 2, 2026
  11. 10/13 odb/source: make `will_destroy` an implementation detailPatrick Steinhardt, Oct 2, 2026
  12. 11/13 odb/source-files: extract reading alternatesPatrick Steinhardt, Oct 2, 2026
  13. 12/13 odb/source-files: move alternates into the backendPatrick Steinhardt, Oct 2, 2026
  14. 13/13 odb/source: drop `read_alternates` callbackPatrick Steinhardt, Oct 2, 2026
  15. Karthik NayakOct 5, 2026
  16. Karthik NayakOct 5, 2026
  17. Karthik NayakOct 6, 2026
  18. Patrick SteinhardtOct 6, 2026
  19. Patrick SteinhardtOct 6, 2026
  20. Karthik NayakOct 6, 2026
  21. Karthik NayakOct 6, 2026
  22. Karthik NayakOct 6, 2026
  23. Karthik NayakOct 6, 2026
  24. Karthik NayakOct 6, 2026
  25. Patrick SteinhardtOct 7, 2026
  26. Patrick SteinhardtOct 7, 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.