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

Re: `.git` symlink makes `git submodule add` fail

From
Vít Novotný <witiko@gmail.com>
Date
Feb 13, 2016, 04:20 UTC
Message-ID
<20160213042008.GA26677@witiko>
In-Reply-To
<20160212182733.GA19973@sigill.intra.peff.net>
On Fri, Feb 12, 2016 at 01:27:33PM -0500, Jeff King wrote:
Show 17 quoted lines
> On Fri, Feb 12, 2016 at 10:19:38AM -0800, Junio C Hamano wrote:
> 
> > >> Is this a bug, or is the ability to symlink `.git` just a happy coincidence?
> > >
> > > It has never been supported.
> > 
> > Oops, hit "send" too early.
> > 
> > We have support for a "gitdir:" facility that would work even on a
> > filesystem that cannot do symlinks (see gitrepository-layout(5)),
> > and both the higher-level submodule Porcelain and the more recent
> > "worktree" experimental code do use it.
> 
> And the way to convince git to make the link for you is with clone's
> "--separate-git-dir" option.
> 
> -Peff

What's curious is that this doesn't really work either, so the issue doesn't seem to be the lack of symlink support, but rather the lack of willingness on the part of Git to resolve a path recursively.

The following works flawlessly:
  $ mkdir repos
  $ git init
  $ mv .git repos/repoA
  $ printf 'gitdir: repos/repoA\n' >.git
  $ git submodule add https://github.com/witiko/git-parallel
There is, however, a minor pain, which makes the repository unportable:
  $ cat git-parallel/.git
  gitdir: /tmp/foobar/repos/repoA/modules/git-parallel

When I change the gitdir symlink to a relative path, everything works fine as long as I don't make Git go over two gitdir symlinks:

  $ sed -i 's#^/tmp/foobar#..#' git-parallel/.git
  $ git status
  [works]
  $ sed -i 's#repos/repoA#.git#' git-parallel/.git
  $ git status
  fatal: Not a git repository: git-parallel/../.git/modules/git-parallel
Clearly, Git resolves the first gitdir symlink:
  git-parallel/.git => git-parallel/../.git/modules/git-parallel
but refuses to resolve recursively:
  git-parallel/../.git/modules/git-parallel =>
  git-parallel/../repos/repoA/modules/git-parallel
Previous: Jeff KingNext: Jeff King
Message 5 of 7 in “`.git` symlink makes `git submodule add` fail”
  1. Vít NovotnýFeb 12, 2016
  2. Junio C HamanoFeb 12, 2016
  3. Junio C HamanoFeb 12, 2016
  4. Jeff KingFeb 12, 2016
  5. Vít NovotnýFeb 13, 2016
  6. Jeff KingFeb 13, 2016
  7. Vít NovotnýFeb 12, 2016

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.