Since 69c305178 (submodules: refactor computation of relative gitdir path)
cloning a submodule recursively fails for recursive submodules when a
symbolic link is part of the path to the work tree of the superproject.
This happens when module_clone() tries to find the relative paths between
work tree and git dir. When a symbolic link in current $PWD points to a
directory in a different level determining the number of "../" needed to
traverse to the superprojects work tree leads to a wrong result.
As there is no portable way to say "pwd -P" use cd_to_toplevel to remove
the link from the pwd, which fixes this problem.
A test for this problem has been added to t7406.
Reported-by: Bob Halley <redacted>
Signed-off-by: Jens Lehmann <redacted>
---
Thanks to Bob for providing a very detailed bug report and test case!
git-submodule.sh | 4 ++--
t/t7406-submodule-update.sh | 13 +++++++++++++
2 files changed, 15 insertions(+), 2 deletions(-)
From: Johannes Sixt <hidden> Date: 2016-06-15 22:54:14
Am 11.07.2012 20:11, schrieb Jens Lehmann:
Since 69c305178 (submodules: refactor computation of relative gitdir path)
cloning a submodule recursively fails for recursive submodules when a
symbolic link is part of the path to the work tree of the superproject.
This happens when module_clone() tries to find the relative paths between
work tree and git dir. When a symbolic link in current $PWD points to a
directory in a different level determining the number of "../" needed to
traverse to the superprojects work tree leads to a wrong result.
As there is no portable way to say "pwd -P" use cd_to_toplevel to remove
the link from the pwd, which fixes this problem.
But if you cd out, how can it be correct not to cd in again if $gitdir
and/or $sm_path are relative?
And if $gitdir and/or $sm_path are absolute, how can the earlier
cd_to_toplevel make a difference?
+test_expect_success 'submodule update can handle symbolic links in pwd' '
Please add a SYMLINKS prerequisite.
+ mkdir -p linked/dir &&
+ ln -s linked/dir linkto &&
+ (
+ cd linkto &&
+ git clone "$TRASH_DIRECTORY"/super_update_r2 super &&
+ (
+ cd super &&
+ git submodule update --init --recursive
+ )
+ )
+'
Since 69c305178 (submodules: refactor computation of relative gitdir path)
cloning a submodule recursively fails for recursive submodules when a
symbolic link is part of the path to the work tree of the superproject.
This happens when module_clone() tries to find the relative paths between
work tree and git dir. When a symbolic link in current $PWD points to a
directory in a different level determining the number of "../" needed to
traverse to the superprojects work tree leads to a wrong result.
As there is no portable way to say "pwd -P" use cd_to_toplevel to remove
the link from the pwd, which fixes this problem.
But if you cd out, how can it be correct not to cd in again if $gitdir
and/or $sm_path are relative?
I'm not sure what you mean by "cd out", but the two "cd_to_toplevel"
make sure that when $gitdir or $sm_path are relative the symbolic link
gets removed from the output of pwd. So it's rather "cd into the path
where the symlink is resolved".
And if $gitdir and/or $sm_path are absolute, how can the earlier
cd_to_toplevel make a difference?
Then it doesn't, but $sm_path is always relative while $gitdir is
sometimes (in the superproject it returns ".git"). Just drop either
of the "cd_to_toplevel" and run the test ;-)
But it looks like the commit message could use some tuning ...
quoted
+test_expect_success 'submodule update can handle symbolic links in pwd' '
Please add a SYMLINKS prerequisite.
Oops. Thanks, will add that.
Will wait some time for other comments before preparing v2.
From: Johannes Sixt <hidden> Date: 2016-06-15 22:54:14
Am 11.07.2012 22:06, schrieb Jens Lehmann:
Am 11.07.2012 21:10, schrieb Johannes Sixt:
quoted
Am 11.07.2012 20:11, schrieb Jens Lehmann:
quoted
Since 69c305178 (submodules: refactor computation of relative gitdir path)
cloning a submodule recursively fails for recursive submodules when a
symbolic link is part of the path to the work tree of the superproject.
This happens when module_clone() tries to find the relative paths between
work tree and git dir. When a symbolic link in current $PWD points to a
directory in a different level determining the number of "../" needed to
traverse to the superprojects work tree leads to a wrong result.
As there is no portable way to say "pwd -P" use cd_to_toplevel to remove
the link from the pwd, which fixes this problem.
But if you cd out, how can it be correct not to cd in again if $gitdir
and/or $sm_path are relative?
I'm not sure what you mean by "cd out", but the two "cd_to_toplevel"
make sure that when $gitdir or $sm_path are relative the symbolic link
gets removed from the output of pwd. So it's rather "cd into the path
where the symlink is resolved".
At this point we can be in a subdirectory of the worktree. With
cd_to_toplevel we move up in the directory hierarchy ("cd out"). Then a
relative $gitdir or $sm_path now points to the wrong directory. No?
-- Hannes
Since 69c305178 (submodules: refactor computation of relative gitdir path)
cloning a submodule recursively fails for recursive submodules when a
symbolic link is part of the path to the work tree of the superproject.
This happens when module_clone() tries to find the relative paths between
work tree and git dir. When a symbolic link in current $PWD points to a
directory in a different level determining the number of "../" needed to
traverse to the superprojects work tree leads to a wrong result.
As there is no portable way to say "pwd -P" use cd_to_toplevel to remove
the link from the pwd, which fixes this problem.
But if you cd out, how can it be correct not to cd in again if $gitdir
and/or $sm_path are relative?
I'm not sure what you mean by "cd out", but the two "cd_to_toplevel"
make sure that when $gitdir or $sm_path are relative the symbolic link
gets removed from the output of pwd. So it's rather "cd into the path
where the symlink is resolved".
At this point we can be in a subdirectory of the worktree. With
cd_to_toplevel we move up in the directory hierarchy ("cd out"). Then a
relative $gitdir or $sm_path now points to the wrong directory. No?
Nope, "git submodule" will refuse to run in anything but the root of
the worktree. So we already are at the toplevel and use "cd_to_toplevel"
only to resolve any symlinks present in $PWD. Looks like a comment
explaining that above those lines would be a good idea ... will add one.
From: Johannes Sixt <hidden> Date: 2016-06-15 22:54:15
Am 11.07.2012 23:08, schrieb Jens Lehmann:
Am 11.07.2012 22:39, schrieb Johannes Sixt:
quoted
At this point we can be in a subdirectory of the worktree. With
cd_to_toplevel we move up in the directory hierarchy ("cd out"). Then a
relative $gitdir or $sm_path now points to the wrong directory. No?
Nope, "git submodule" will refuse to run in anything but the root of
the worktree. So we already are at the toplevel and use "cd_to_toplevel"
only to resolve any symlinks present in $PWD. Looks like a comment
explaining that above those lines would be a good idea ... will add one.
Ah, OK. I missed the lack of SUBDIRECTORY_OK=Yes, but noticed a few
cd_to_toplevel sprinkled throughout the script, so I thought it was OK
to be in a subdirectory.
-- Hannes