Skip to content

fix: apply insteadOf from global config for detached remotes#7195

Merged
ethomson merged 2 commits into
libgit2:mainfrom
weihanglo:insteadof
Apr 24, 2026
Merged

fix: apply insteadOf from global config for detached remotes#7195
ethomson merged 2 commits into
libgit2:mainfrom
weihanglo:insteadof

Conversation

@weihanglo
Copy link
Copy Markdown
Contributor

@weihanglo weihanglo commented Jan 14, 2026

Detached remotes already read global/system config for http proxy
settings, but did not apply url.*.insteadOf or url.*.pushInsteadOf
rules. This inconsistency meant that git_remote_create_detached
behaved differently from git's ls-remote, which was the primary
use case for detached remotes.

This fixes it by loading the default config when no repository is
provided and apply insteadOf rules consistently.

While this is a behavior change, it still respects
GIT_REMOTE_CREATE_SKIP_INSTEADOF, meaning that user can restore
the previous behavior with minimal effort

Fixes #5469

How to review

Best review commit by commit.

The first commit shows the current behavior.
The test diff in the second commit demonstrates the behavior change.


This was found during the Cargo integration with SHA256.

I was trying detached remote to probe the remote object format first (via git_remote_oid_type exposed by #7185), and then set up the repository. Cargo needs to probe first because it stores sha256/sha1 separately for backward compatibility. However detached remote not respecting insteadOf may lead to inconsistent behavior.

`git_remote_create_detached` does not apply
`url.*.insteadOf` or url.*.pushInsteadOf from global config.

These tests currently pass, asserting the buggy behavior
and serving as a minimal reproduction.

The assertions will be updated when the fix is applied.

See <libgit2#5469>
Detached remotes already read global/system config for http proxy
settings, but did not apply url.*.insteadOf or url.*.pushInsteadOf
rules. This inconsistency meant that `git_remote_create_detached`
behaved differently from git's `ls-remote`, which was the primary
use case for detached remotes.

This fixes it by loading the default config when no repository is
provided and apply insteadOf rules consistently.

While this is a behavior change, it still respects
`GIT_REMOTE_CREATE_SKIP_INSTEADOF`, meaning that user can restore
the previous behavior with minimal effort

Fixes libgit2#5469
@ethomson ethomson merged commit 1e7d7c0 into libgit2:main Apr 24, 2026
19 checks passed
@ethomson
Copy link
Copy Markdown
Member

good catch - thanks!

@weihanglo weihanglo deleted the insteadof branch April 24, 2026 13:02
netbsd-srcmastr pushed a commit to NetBSD/pkgsrc that referenced this pull request May 5, 2026
v1.9.3

This release includes a number of bugfixes and compatibility
improvements, particularly around SHA256 support.

* cmake: fix linker error when using ninja build generator by
  @kcsaul in libgit2/libgit2#7249
* Handle redirects with Content-Length: 0 correctly by
  @ethomson in libgit2/libgit2#7246
* ci: use poxygit v0.8.1 in the tests by @ethomson in
  libgit2/libgit2#7248
* Zero indexer stats in pack objects by @ethomson in
  libgit2/libgit2#7243
* submodule: git_index_add_bypath does not move conflict entries
  to REUC by @lrm29 in libgit2/libgit2#7003
* fix: prevent SSH timeout infinite loop and enable TCP keepalive
  by @ambv in libgit2/libgit2#7165
* merge_files: avoid UB in xdiff by @ethomson in
  libgit2/libgit2#7239
* git_merge_file_from_index: handle cases when a child (ours or
  theirs) is null by @eantoranz in
  libgit2/libgit2#7092
* cmake: write git.h.tmp to current binary directory by @kcsaul in
  libgit2/libgit2#7241
* fix(pack): ensure pack_backend__read returns null terminated buffer
  by @kanru in libgit2/libgit2#7238
* Check object lengths against headers in read_loose by @howtonotwin
  in libgit2/libgit2#7178
* cmake: don't recreate git2.h unnecessarily by @ethomson in
  libgit2/libgit2#7234
* Memory Backend Corruption Fix by @kcsaul in
  libgit2/libgit2#7232
* Fixed a heap-buffer-overflow in the smart_pkt.c:set_data function
  by @oliverchang in libgit2/libgit2#7118
* fix(transport): get oid_type on local transport by @weihanglo in
  libgit2/libgit2#7229
* `GIT_REMOTE_DOWNLOAD_TAGS_ALL`: remove stray "the" in docs by
  @DanielEScherzer in libgit2/libgit2#7228
* fix(clone): propagate object format in local clone by @weihanglo in
  libgit2/libgit2#7226
* repo: Fix possible null pointer dereference by @csware in
  libgit2/libgit2#7225
* revparse: Allow `HEAD` abbreviation `@` by @KoviRobi in
  libgit2/libgit2#7218
* camke: include libssh2 in `Requires.private` in the PC file
  by @carlosmn in libgit2/libgit2#7215
* futils: fix undefined behavior in O_FSYNC fallback definition
  by @cehoffman in libgit2/libgit2#7211
* pcre: actually fix dangling-pointer warning by @ethomson in
  libgit2/libgit2#7206
* pcre: update cmake warnings for non-gcc by @ethomson in
  libgit2/libgit2#7205
* Fix some warnings with gcc by @ethomson in
  libgit2/libgit2#7203
* fix: apply insteadOf from global config for detached remotes by
  @weihanglo in libgit2/libgit2#7195
* Fix `git_index_entry` documentation by @bakersdozen123 in
  libgit2/libgit2#7192
* config: Fix potential null value passed to %s by @ethomson in
  libgit2/libgit2#7190
* index: support USE_NSEC=OFF by @ethomson in
  libgit2/libgit2#7187
* feat(remote): expose `git_remote_oid_type` by @weihanglo in
  libgit2/libgit2#7185
* fix(smart): keep caps across RPC stream resets by @weihanglo in
  libgit2/libgit2#7183
* fix wrong comment by @Murmele in
  libgit2/libgit2#7181
* fix(sha256): pass correct oid type by @weihanglo in
  libgit2/libgit2#7179
* examples: correct `git_commit_time` comment by @qaqland in
  libgit2/libgit2#7175
* tests: update to latest clar by @ethomson in
  libgit2/libgit2#7173
* delta: fix undefined behavior in hdr_sz varint parsing
  by @Oblivionsage in libgit2/libgit2#7172
* ci: Update macos-13 to macos-14 images on GitHub Actions by @ambv
  in libgit2/libgit2#7167
* ci: Fix cases of -Werror=discarded-qualifiers raised by @gcc 15.2
  by @ambv in libgit2/libgit2#7164
* Use CMAKE_INSTALL_INCLUDEDIR for libgit2package INSTALL_INTERFACE
  by @aware70 in libgit2/libgit2#7155
* Fix C4703 uninitialized pointer variable warnings by
  @ShiningMassXAcc in libgit2/libgit2#7154
* test: check the correct filesystem for case-sensitivity by @ambv
  in libgit2/libgit2#7153
* ci: update ci/docker/fedora to work with Rawhide 44 by @ambv
  in libgit2/libgit2#7152
* refs: honor REFSPEC_SHORTHAND for multi-segment refs by @roberth
  in libgit2/libgit2#7148
* config: Fix potential null value passed to %s by @orgads in
  libgit2/libgit2#7131
* Fix potential access to uninitialized variables by @orgads
  in libgit2/libgit2#7130
* refspec: Detect DEL character in is_valid_name by @xokdvium
  in libgit2/libgit2#7120
* Update documentation to clarify that cert cb is always called
  by @ehuss in libgit2/libgit2#7119
* Update `racy.c` reference by @emmanuel-ferdman in
  libgit2/libgit2#7091
* Avoid duplicate definition of git_http_auth_dummy. by
  @JohannesWilde in libgit2/libgit2#7077
netbsd-srcmastr pushed a commit to NetBSD/pkgsrc that referenced this pull request May 13, 2026
v1.9.3

This release includes a number of bugfixes and compatibility
improvements, particularly around SHA256 support.

* cmake: fix linker error when using ninja build generator by
  @kcsaul in libgit2/libgit2#7249
* Handle redirects with Content-Length: 0 correctly by
  @ethomson in libgit2/libgit2#7246
* ci: use poxygit v0.8.1 in the tests by @ethomson in
  libgit2/libgit2#7248
* Zero indexer stats in pack objects by @ethomson in
  libgit2/libgit2#7243
* submodule: git_index_add_bypath does not move conflict entries
  to REUC by @lrm29 in libgit2/libgit2#7003
* fix: prevent SSH timeout infinite loop and enable TCP keepalive
  by @ambv in libgit2/libgit2#7165
* merge_files: avoid UB in xdiff by @ethomson in
  libgit2/libgit2#7239
* git_merge_file_from_index: handle cases when a child (ours or
  theirs) is null by @eantoranz in
  libgit2/libgit2#7092
* cmake: write git.h.tmp to current binary directory by @kcsaul in
  libgit2/libgit2#7241
* fix(pack): ensure pack_backend__read returns null terminated buffer
  by @kanru in libgit2/libgit2#7238
* Check object lengths against headers in read_loose by @howtonotwin
  in libgit2/libgit2#7178
* cmake: don't recreate git2.h unnecessarily by @ethomson in
  libgit2/libgit2#7234
* Memory Backend Corruption Fix by @kcsaul in
  libgit2/libgit2#7232
* Fixed a heap-buffer-overflow in the smart_pkt.c:set_data function
  by @oliverchang in libgit2/libgit2#7118
* fix(transport): get oid_type on local transport by @weihanglo in
  libgit2/libgit2#7229
* `GIT_REMOTE_DOWNLOAD_TAGS_ALL`: remove stray "the" in docs by
  @DanielEScherzer in libgit2/libgit2#7228
* fix(clone): propagate object format in local clone by @weihanglo in
  libgit2/libgit2#7226
* repo: Fix possible null pointer dereference by @csware in
  libgit2/libgit2#7225
* revparse: Allow `HEAD` abbreviation `@` by @KoviRobi in
  libgit2/libgit2#7218
* camke: include libssh2 in `Requires.private` in the PC file
  by @carlosmn in libgit2/libgit2#7215
* futils: fix undefined behavior in O_FSYNC fallback definition
  by @cehoffman in libgit2/libgit2#7211
* pcre: actually fix dangling-pointer warning by @ethomson in
  libgit2/libgit2#7206
* pcre: update cmake warnings for non-gcc by @ethomson in
  libgit2/libgit2#7205
* Fix some warnings with gcc by @ethomson in
  libgit2/libgit2#7203
* fix: apply insteadOf from global config for detached remotes by
  @weihanglo in libgit2/libgit2#7195
* Fix `git_index_entry` documentation by @bakersdozen123 in
  libgit2/libgit2#7192
* config: Fix potential null value passed to %s by @ethomson in
  libgit2/libgit2#7190
* index: support USE_NSEC=OFF by @ethomson in
  libgit2/libgit2#7187
* feat(remote): expose `git_remote_oid_type` by @weihanglo in
  libgit2/libgit2#7185
* fix(smart): keep caps across RPC stream resets by @weihanglo in
  libgit2/libgit2#7183
* fix wrong comment by @Murmele in
  libgit2/libgit2#7181
* fix(sha256): pass correct oid type by @weihanglo in
  libgit2/libgit2#7179
* examples: correct `git_commit_time` comment by @qaqland in
  libgit2/libgit2#7175
* tests: update to latest clar by @ethomson in
  libgit2/libgit2#7173
* delta: fix undefined behavior in hdr_sz varint parsing
  by @Oblivionsage in libgit2/libgit2#7172
* ci: Update macos-13 to macos-14 images on GitHub Actions by @ambv
  in libgit2/libgit2#7167
* ci: Fix cases of -Werror=discarded-qualifiers raised by @gcc 15.2
  by @ambv in libgit2/libgit2#7164
* Use CMAKE_INSTALL_INCLUDEDIR for libgit2package INSTALL_INTERFACE
  by @aware70 in libgit2/libgit2#7155
* Fix C4703 uninitialized pointer variable warnings by
  @ShiningMassXAcc in libgit2/libgit2#7154
* test: check the correct filesystem for case-sensitivity by @ambv
  in libgit2/libgit2#7153
* ci: update ci/docker/fedora to work with Rawhide 44 by @ambv
  in libgit2/libgit2#7152
* refs: honor REFSPEC_SHORTHAND for multi-segment refs by @roberth
  in libgit2/libgit2#7148
* config: Fix potential null value passed to %s by @orgads in
  libgit2/libgit2#7131
* Fix potential access to uninitialized variables by @orgads
  in libgit2/libgit2#7130
* refspec: Detect DEL character in is_valid_name by @xokdvium
  in libgit2/libgit2#7120
* Update documentation to clarify that cert cb is always called
  by @ehuss in libgit2/libgit2#7119
* Update `racy.c` reference by @emmanuel-ferdman in
  libgit2/libgit2#7091
* Avoid duplicate definition of git_http_auth_dummy. by
  @JohannesWilde in libgit2/libgit2#7077
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

git_remote_create_detached will not apply the insteadOf from global config

3 participants