Go to file
Patrick Steinhardt e66077ae45 ref-filter: detect broken tags when dereferencing them
Users can ask git-for-each-ref(1) to peel tags and return information of
the tagged object by adding an asterisk to the format, like for example
"%(*$objectname)". If so, git-for-each-ref(1) peels that object to the
first non-tag object and then returns its values.

As mentioned in preceding commits, it can happen that the tagged object
type and the claimed object type differ, effectively resulting in a
corrupt tag. git-for-each-ref(1) would notice this mismatch, print an
error and then bail out when trying to peel the tag.

But we only notice this corruption in some very specific edge cases!
While we have a test in "t/for-each-ref-tests.sh" that verifies the
above scenario, this test is specifically crafted to detect the issue at
hand. Namely, we create two tags:

  - One tag points to a specific object with the correct type.

  - The other tag points to the *same* object with a different type.

The fact that both tags point to the same object is important here:
`peel_object()` wouldn't notice the corruption if the tagged objects
were different.

The root cause is that `peel_object()` calls `lookup_${type}()`
eventually, where the type is the same type declared in the tag object.
Consequently, when we have two tags pointing to the same object but with
different declared types we'll call two different lookup functions. The
first lookup will store the object with an unverified type A, whereas
the second lookup will try to look up the object with a different
unverified type B. And it is only now that we notice the discrepancy in
object types, even though type A could've already been the wrong type.

Fix the issue by verifying the object type in `populate_value()`. With
this change we'll also notice type mismatches when only dereferencing a
tag once.

Signed-off-by: Patrick Steinhardt <ps@pks.im>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
2025-11-04 07:32:25 -08:00
.github ci: convert "pedantic" job into full build with breaking changes 2025-10-02 09:32:32 -07:00
Documentation Merge branch 'jt/repo-structure' into ps/ref-peeled-tags 2025-10-22 07:47:24 -07:00
bin-wrappers
block-sha1
builtin builtin/show-ref: convert to use `reference_get_peeled_oid()` 2025-11-04 07:32:25 -08:00
ci Merge branch 'ps/ci-avoid-broken-sudo-on-ubuntu' 2025-10-13 22:00:35 -07:00
compat mingw: order `#include`s alphabetically 2025-10-09 13:21:28 -07:00
compiler-tricks
contrib Merge branch 'ps/meson-build-docs' 2025-10-02 12:26:12 -07:00
ewah
git-gui Merge branch 'master' of https://github.com/j6t/git-gui 2025-09-10 14:28:23 -07:00
gitk-git Merge branch 'master' of https://github.com/j6t/gitk 2025-10-05 13:32:47 -07:00
gitweb
mergetools doc: update references to renamed AsciiDoc files 2025-06-06 15:05:47 -07:00
negotiator refs: introduce wrapper struct for `each_ref_fn` 2025-11-04 07:32:24 -08:00
oss-fuzz commit-graph: refactor `parse_commit_graph()` to take a repository 2025-08-15 09:34:47 -07:00
perl contrib: better support symbolic port names in git-credential-netrc 2025-06-25 09:43:59 -07:00
po git-gui: sync Makefiles with git.git 2025-09-06 11:59:48 +02:00
refs refs: don't store peeled object IDs for invalid tags 2025-11-04 07:32:25 -08:00
reftable Merge branch 'kn/reftable-consistency-checks' 2025-10-13 22:00:35 -07:00
sha1
sha1collisiondetection@855827c583
sha1dc
sha256
src varint: reimplement as test balloon for Rust 2025-10-02 09:32:32 -07:00
subprojects meson: update subproject wrappers 2025-07-11 09:56:34 -07:00
t ref-filter: detect broken tags when dereferencing them 2025-11-04 07:32:25 -08:00
templates
trace2 trace2: do not use strbuf_split*() 2025-08-02 22:44:58 -07:00
xdiff Merge branch 'en/xdiff-cleanup' 2025-10-14 12:56:09 -07:00
.cirrus.yml ci: update FreeBSD image to 14.3 2025-07-01 07:46:22 -07:00
.clang-format clang-format: exclude control macros from SpaceBeforeParens 2025-09-28 08:37:23 -07:00
.editorconfig
.gitattributes git-gui: wire up support for the Meson build system 2025-05-13 08:48:09 +02:00
.gitignore Merge branch 'ps/rust-balloon' 2025-10-08 12:17:55 -07:00
.gitlab-ci.yml Merge branch 'ps/gitlab-ci-windows-improvements' 2025-10-10 12:51:46 -07:00
.gitmodules
.mailmap mailmap: change primary address for Jonathan Tan 2025-10-07 10:38:21 -07:00
.tsan-suppressions
CODE_OF_CONDUCT.md
COPYING
Cargo.toml meson: add infrastructure to build internal Rust library 2025-10-02 09:32:31 -07:00
GIT-BUILD-OPTIONS.in
GIT-VERSION-FILE.in
GIT-VERSION-GEN Git 2.51.1 2025-10-15 10:29:35 -07:00
INSTALL
LGPL-2.1
Makefile Merge branch 'tb/incremental-midx-part-3.1' into ps/ref-peeled-tags 2025-10-22 07:47:01 -07:00
README.md gitk: add README with usage, build, and contribution details 2025-08-28 19:51:31 +02:00
RelNotes Prepare for 2.51.1 2025-10-14 13:43:25 -07:00
SECURITY.md
abspath.c
abspath.h
aclocal.m4
add-interactive.c Merge branch 'sj/string-list' 2025-10-14 12:56:08 -07:00
add-interactive.h add-interactive: retain colorbool values longer 2025-09-16 18:00:25 -07:00
add-patch.c Merge branch 'rs/add-patch-options-fix' 2025-10-17 14:02:17 -07:00
advice.c initial branch: give hints after switching the default name 2025-09-18 11:44:47 -07:00
advice.h initial branch: give hints after switching the default name 2025-09-18 11:44:47 -07:00
alias.c
alias.h
alloc.c alloc: fix dangling pointer in alloc_state cleanup 2025-09-04 15:24:16 -07:00
alloc.h alloc: fix dangling pointer in alloc_state cleanup 2025-09-04 15:24:16 -07:00
apply.c Merge branch 'ps/object-file-wo-the-repository' 2025-08-05 11:53:55 -07:00
apply.h
archive-tar.c config: drop `git_config()` wrapper 2025-07-23 08:15:18 -07:00
archive-zip.c archive: flush deflate stream until Z_STREAM_END 2025-08-04 13:36:35 -07:00
archive.c config: drop `git_config_get_bool()` wrapper 2025-07-23 08:15:20 -07:00
archive.h
attr.c odb: rename `repo_read_object_file()` 2025-07-01 14:46:38 -07:00
attr.h
banned.h
base85.c
base85.h
bisect.c refs: introduce wrapper struct for `each_ref_fn` 2025-11-04 07:32:24 -08:00
bisect.h rev-list: make "struct rev_list_info" static to the only user 2025-07-21 15:40:46 -07:00
blame.c blame: drop explicit check for commit graph 2025-09-04 16:16:21 -07:00
blame.h
blob.c
blob.h
bloom.c commit-graph: return commit graph from `repo_find_commit_pos_in_graph()` 2025-09-04 16:16:22 -07:00
bloom.h bloom: replace struct bloom_key * with struct bloom_keyvec 2025-07-14 10:03:03 -07:00
branch.c config: drop `git_config_get_multivar_gently()` wrapper 2025-07-23 08:15:21 -07:00
branch.h
builtin.h Merge branch 'tc/last-modified' 2025-09-08 14:54:35 -07:00
bulk-checkin.c Merge branch 'ps/packfile-store' into tb/incremental-midx-part-3.1 2025-09-29 09:31:08 -07:00
bundle-uri.c Merge branch 'ps/object-store' 2025-07-15 15:18:18 -07:00
bundle-uri.h
bundle.c Merge branch 'bc/use-sha256-by-default-in-3.0' 2025-07-21 09:14:25 -07:00
bundle.h
cache-tree.c odb: add transaction interface 2025-09-16 11:37:06 -07:00
cache-tree.h
cbtree.c
cbtree.h
chdir-notify.c
chdir-notify.h
check-builtins.sh
checkout.c config: drop `git_config_get_string()` wrapper 2025-07-23 08:15:19 -07:00
checkout.h
chunk-format.c
chunk-format.h
color.c color: return bool from want_color() 2025-09-16 18:00:25 -07:00
color.h color: return bool from want_color() 2025-09-16 18:00:25 -07:00
column.c
column.h
combine-diff.c Merge branch 'tc/last-modified-recursive-fix' 2025-09-29 11:40:35 -07:00
command-list.txt Merge branch 'tc/last-modified' 2025-09-08 14:54:35 -07:00
commit-graph.c refs: expose peeled object ID via the iterator 2025-11-04 07:32:25 -08:00
commit-graph.h commit-graph: return commit graph from `repo_find_commit_pos_in_graph()` 2025-09-04 16:16:22 -07:00
commit-reach.c
commit-reach.h
commit-slab-decl.h
commit-slab-impl.h
commit-slab.h
commit.c Merge branch 'ps/remote-rename-fix' 2025-08-21 13:46:58 -07:00
commit.h Merge branch 'lm/add-p-context' 2025-08-04 08:10:33 -07:00
common-exit.c
common-init.c
common-init.h
common-main.c
config.c Merge branch 'jc/optional-path' 2025-10-14 12:56:09 -07:00
config.h Merge branch 'ps/config-wo-the-repository' 2025-08-04 08:10:33 -07:00
config.mak.dev
config.mak.in
config.mak.uname Merge branch 'bs/config-mak-freebsd' 2025-07-14 11:19:23 -07:00
configure.ac Merge branch 'rj/freebsd-sysinfo-build-fix' 2025-07-14 11:19:28 -07:00
connect.c Merge branch 'jc/string-list-split' 2025-08-21 13:46:59 -07:00
connect.h
connected.c packfile: refactor `get_all_packs()` to work on packfile store 2025-09-24 11:53:51 -07:00
connected.h
convert.c config: drop `git_config()` wrapper 2025-07-23 08:15:18 -07:00
convert.h
copy.c
copy.h
credential.c
credential.h
csum-file.c
csum-file.h
ctype.c
daemon.c Merge branch 'ps/config-wo-the-repository' 2025-08-04 08:10:33 -07:00
date.c
date.h
decorate.c
decorate.h
delta-islands.c refs: introduce wrapper struct for `each_ref_fn` 2025-11-04 07:32:24 -08:00
delta-islands.h
delta.h
detect-compiler
diagnose.c odb: get rid of `the_repository` in `for_each()` functions 2025-07-01 14:46:36 -07:00
diagnose.h
diff-delta.c
diff-lib.c diff: teach tree-diff a max-depth parameter 2025-08-07 15:29:35 -07:00
diff-merges.c
diff-merges.h
diff-no-index.c diff --no-index: fix logic for paths ending in '/' 2025-09-25 11:35:20 -07:00
diff.c Merge branch 'jk/color-variable-fixes' 2025-09-29 11:40:35 -07:00
diff.h Merge branch 'tc/last-modified-recursive-fix' 2025-09-29 11:40:35 -07:00
diffcore-break.c
diffcore-delta.c
diffcore-order.c
diffcore-pickaxe.c
diffcore-rename.c
diffcore-rotate.c
diffcore.h
dir-iterator.c
dir-iterator.h
dir.c varint: use explicit width for integers 2025-10-02 09:32:32 -07:00
dir.h dir: move starts_with_dot(_dot)_slash to dir.h 2025-06-23 16:38:56 -07:00
editor.c config: drop `git_config_get_string()` wrapper 2025-07-23 08:15:19 -07:00
editor.h
entry.c odb: rename `repo_read_object_file()` 2025-07-01 14:46:38 -07:00
entry.h
environment.c Merge branch 'pw/3.0-commentchar-auto-deprecation' 2025-09-18 10:07:00 -07:00
environment.h config: warn on core.commentString=auto 2025-08-26 08:52:44 -07:00
exec-cmd.c
exec-cmd.h
fetch-negotiator.c
fetch-negotiator.h
fetch-pack.c refs: introduce wrapper struct for `each_ref_fn` 2025-11-04 07:32:24 -08:00
fetch-pack.h
fmt-merge-msg.c Merge branch 'ac/deglobal-fmt-merge-log-config' 2025-08-22 13:13:21 -07:00
fmt-merge-msg.h environment: remove the global variable 'merge_log_config' 2025-08-11 09:16:55 -07:00
for-each-ref.h Merge branch 'ja/doc-lint-sections-and-synopsis' 2025-08-25 14:22:02 -07:00
fsck.c config: move Git config parsing into "environment.c" 2025-07-23 08:15:22 -07:00
fsck.h refs/reftable: add fsck check for checking the table name 2025-10-07 09:22:58 -07:00
fsmonitor--daemon.h
fsmonitor-ipc.c
fsmonitor-ipc.h
fsmonitor-ll.h
fsmonitor-path-utils.h
fsmonitor-settings.c
fsmonitor-settings.h
fsmonitor.c config: drop `git_config_get_int()` wrapper 2025-07-23 08:15:20 -07:00
fsmonitor.h
generate-cmdlist.sh
generate-configlist.sh Merge branch 'jc/sed-build-fixes' 2025-06-13 13:29:14 -07:00
generate-hooklist.sh
generate-perl.sh
generate-python.sh
generate-script.sh git-gui: honor TCLTK_PATH in git-gui--askpass 2025-07-31 18:42:54 +02:00
gettext.c
gettext.h
git-archimport.perl
git-compat-util.h whatchanged: hint about git-log(1) and aliasing 2025-09-17 13:47:24 -07:00
git-curl-compat.h curl: add support for curl_global_trace() components 2025-08-27 09:49:43 -07:00
git-cvsexportcommit.perl
git-cvsimport.perl
git-cvsserver.perl cvsserver: remove unused escapeRefName function 2025-05-27 08:25:08 -07:00
git-difftool--helper.sh
git-filter-branch.sh
git-instaweb.sh
git-merge-octopus.sh
git-merge-one-file.sh
git-merge-resolve.sh
git-mergetool--lib.sh
git-mergetool.sh
git-p4.py
git-quiltimport.sh
git-request-pull.sh
git-send-email.perl Merge branch 'nb/send-email-no-dup-reply-to' 2025-09-29 11:40:33 -07:00
git-sh-i18n.sh
git-sh-setup.sh
git-submodule.sh
git-svn.perl
git-web--browse.sh
git-zlib.c
git-zlib.h
git.c Merge branch 'kh/you-still-use-whatchanged-fix' 2025-10-02 12:26:12 -07:00
git.rc.in
gpg-interface.c gpg-interface: refactor 'enum sign_mode' parsing 2025-09-17 11:18:28 -07:00
gpg-interface.h gpg-interface: refactor 'enum sign_mode' parsing 2025-09-17 11:18:28 -07:00
graph.c
graph.h
grep.c grep: don't treat grep_opt.color as a strict bool 2025-09-16 13:37:05 -07:00
grep.h color: use git_colorbool enum type to store colorbools 2025-09-16 17:59:53 -07:00
hash-lookup.c
hash-lookup.h
hash.c
hash.h Merge branch 'bc/use-sha256-by-default-in-3.0' 2025-07-21 09:14:25 -07:00
hashmap.c
hashmap.h
help.c refs: introduce wrapper struct for `each_ref_fn` 2025-11-04 07:32:24 -08:00
help.h
hex-ll.c
hex-ll.h
hex.c
hex.h
hook.c
hook.h
http-backend.c refs: introduce wrapper struct for `each_ref_fn` 2025-11-04 07:32:24 -08:00
http-fetch.c config: move Git config parsing into "environment.c" 2025-07-23 08:15:22 -07:00
http-push.c Merge branch 'js/curl-off-t-fixes' into maint-2.51 2025-10-14 13:40:53 -07:00
http-walker.c odb: rename `has_object()` 2025-07-01 14:46:38 -07:00
http.c Merge branch 'jk/curl-global-trace-components' into maint-2.51 2025-10-14 13:41:25 -07:00
http.h Merge branch 'js/curl-off-t-fixes' 2025-10-07 12:25:27 -07:00
ident.c Merge branch 'ps/reflog-migrate-fixes' into maint-2.51 2025-10-15 10:29:28 -07:00
ident.h ident: fix type of string length parameter 2025-08-06 07:36:30 -07:00
imap-send.c Merge branch 'js/curl-off-t-fixes' into maint-2.51 2025-10-14 13:40:53 -07:00
iterator.h
json-writer.c json-writer: add docstrings to jw_* functions 2025-05-16 09:33:06 -07:00
json-writer.h json-writer: describe the usage of jw_* functions 2025-05-16 09:33:07 -07:00
khash.h
kwset.c
kwset.h
levenshtein.c
levenshtein.h
line-log.c Merge branch 'sg/line-log-boundary-fixes' into maint-2.51 2025-10-15 10:29:30 -07:00
line-log.h
line-range.c
line-range.h
linear-assignment.c
linear-assignment.h
list-objects-filter-options.c config: drop `git_config_set()` wrapper 2025-07-23 08:15:21 -07:00
list-objects-filter-options.h
list-objects-filter.c use repo_get_oid_with_flags() 2025-09-10 14:29:49 -07:00
list-objects-filter.h
list-objects.c odb: rename `has_object()` 2025-07-01 14:46:38 -07:00
list-objects.h
list.h
lockfile.c
lockfile.h
log-tree.c refs: introduce wrapper struct for `each_ref_fn` 2025-11-04 07:32:24 -08:00
log-tree.h color: use git_colorbool enum type to store colorbools 2025-09-16 17:59:53 -07:00
loose.c loose: write loose objects map via their source 2025-07-16 22:16:15 -07:00
loose.h loose: write loose objects map via their source 2025-07-16 22:16:15 -07:00
ls-refs.c refs: expose peeled object ID via the iterator 2025-11-04 07:32:25 -08:00
ls-refs.h
mailinfo.c config: move Git config parsing into "environment.c" 2025-07-23 08:15:22 -07:00
mailinfo.h
mailmap.c string-list: change "string_list_find_insert_index" return type to "size_t" 2025-10-06 09:11:07 -07:00
mailmap.h
match-trees.c odb: introduce `odb_write_object()` 2025-07-16 22:16:15 -07:00
match-trees.h
mem-pool.c
mem-pool.h
merge-blobs.c odb: rename `repo_read_object_file()` 2025-07-01 14:46:38 -07:00
merge-blobs.h
merge-ll.c config: drop `git_config()` wrapper 2025-07-23 08:15:18 -07:00
merge-ll.h
merge-ort-wrappers.c
merge-ort-wrappers.h
merge-ort.c Merge branch 'en/ort-rename-fixes' into maint-2.51 2025-10-15 10:29:28 -07:00
merge-ort.h merge-ort: add a new mergeability_only option 2025-05-16 15:09:14 -07:00
merge.c
merge.h
mergesort.h
meson.build Merge branch 'tb/incremental-midx-part-3.1' into ps/ref-peeled-tags 2025-10-22 07:47:01 -07:00
meson_options.txt meson: add infrastructure to build internal Rust library 2025-10-02 09:32:31 -07:00
midx-write.c refs: expose peeled object ID via the iterator 2025-11-04 07:32:25 -08:00
midx.c packfile: move `get_multi_pack_index()` into "midx.c" 2025-09-24 11:53:50 -07:00
midx.h packfile: move `get_multi_pack_index()` into "midx.c" 2025-09-24 11:53:50 -07:00
name-hash.c name-hash: don't add sparse directories in threaded lazy init 2025-05-21 14:51:08 -07:00
name-hash.h
notes-cache.c odb: introduce `odb_write_object()` 2025-07-16 22:16:15 -07:00
notes-cache.h
notes-merge.c odb: rename `repo_read_object_file()` 2025-07-01 14:46:38 -07:00
notes-merge.h
notes-utils.c config: drop `git_config()` wrapper 2025-07-23 08:15:18 -07:00
notes-utils.h
notes.c refs: introduce wrapper struct for `each_ref_fn` 2025-11-04 07:32:24 -08:00
notes.h
object-file-convert.c
object-file-convert.h
object-file.c Merge branch 'ps/packfile-store' 2025-10-07 12:25:27 -07:00
object-file.h odb: add transaction interface 2025-09-16 11:37:06 -07:00
object-name.c refs: introduce wrapper struct for `each_ref_fn` 2025-11-04 07:32:24 -08:00
object-name.h
object.c object: add flag to `peel_object()` to verify object type 2025-11-04 07:32:25 -08:00
object.h object: add flag to `peel_object()` to verify object type 2025-11-04 07:32:25 -08:00
odb.c Merge branch 'ps/packfile-store' 2025-10-07 12:25:27 -07:00
odb.h Merge branch 'ps/odb-clean-stale-wrappers' 2025-10-07 12:25:28 -07:00
oid-array.c
oid-array.h
oidmap.c oidmap: rename oidmap_free() to oidmap_clear() 2025-05-12 13:06:26 -07:00
oidmap.h oidmap: add size function 2025-05-12 13:06:26 -07:00
oidset.c
oidset.h
oidtree.c
oidtree.h
pack-bitmap-write.c Merge branch 'ps/object-store' 2025-07-15 15:18:18 -07:00
pack-bitmap.c packfile: refactor `get_all_packs()` to work on packfile store 2025-09-24 11:53:51 -07:00
pack-bitmap.h pack-bitmap: add load corrupt bitmap test 2025-07-01 14:41:54 -07:00
pack-check.c object-store: rename files to "odb.{c,h}" 2025-07-01 14:46:34 -07:00
pack-mtimes.c object-store: rename files to "odb.{c,h}" 2025-07-01 14:46:34 -07:00
pack-mtimes.h
pack-objects.c Merge branch 'ps/odb-clean-stale-wrappers' into maint-2.51 2025-10-15 10:29:34 -07:00
pack-objects.h Merge branch 'ps/object-store' 2025-07-15 15:18:18 -07:00
pack-refs.c builtin/pack-refs: factor out core logic into a shared library 2025-09-19 10:02:55 -07:00
pack-refs.h builtin/pack-refs: factor out core logic into a shared library 2025-09-19 10:02:55 -07:00
pack-revindex.c midx: compute paths via their source 2025-08-11 09:22:23 -07:00
pack-revindex.h
pack-write.c object-file: get rid of `the_repository` in `finalize_object_file()` 2025-07-16 22:16:14 -07:00
pack.h object-file: get rid of `the_repository` in `finalize_object_file()` 2025-07-16 22:16:14 -07:00
packfile.c packfile: refactor `get_packed_git_mru()` to work on packfile store 2025-09-24 11:53:51 -07:00
packfile.h packfile: refactor `get_packed_git_mru()` to work on packfile store 2025-09-24 11:53:51 -07:00
pager.c
pager.h
parallel-checkout.c config: drop `git_config_get_int()` wrapper 2025-07-23 08:15:20 -07:00
parallel-checkout.h
parse-options-cb.c color: use git_colorbool enum type to store colorbools 2025-09-16 17:59:53 -07:00
parse-options.c Merge branch 'jc/optional-path' 2025-10-14 12:56:09 -07:00
parse-options.h Merge branch 'lm/add-p-context' 2025-08-04 08:10:33 -07:00
parse.c
parse.h
patch-delta.c
patch-ids.c
patch-ids.h
path-walk.c path-walk: create initializer for path lists 2025-08-25 09:01:17 -07:00
path-walk.h path-walk: add new 'edge_aggressive' option 2025-05-16 12:15:40 -07:00
path.c object-store: rename files to "odb.{c,h}" 2025-07-01 14:46:34 -07:00
path.h
pathspec.c string-list: split-then-remove-empty can be done while splitting 2025-08-02 22:34:45 -07:00
pathspec.h pathspec: add flag to indicate operation without repository 2025-05-22 14:20:11 -07:00
pkt-line.c Use legacy hash for legacy formats 2025-07-01 14:58:24 -07:00
pkt-line.h
preload-index.c preload-index: stop depending on 'the_repository' 2025-06-10 10:10:40 -07:00
preload-index.h
pretty.c color: use git_colorbool enum type to store colorbools 2025-09-16 17:59:53 -07:00
pretty.h color: use git_colorbool enum type to store colorbools 2025-09-16 17:59:53 -07:00
prio-queue.c prio-queue: add prio_queue_replace() 2025-07-22 07:28:35 -07:00
prio-queue.h prio-queue: add prio_queue_replace() 2025-07-22 07:28:35 -07:00
progress.c progress: pay attention to (customized) delay time 2025-08-25 15:50:17 -07:00
progress.h
promisor-remote.c promisor-remote: use string_list_split() in mark_remotes_as_accepted() 2025-09-08 10:30:56 -07:00
promisor-remote.h
prompt.c interactive: do strip trailing CRLF from input 2025-07-31 14:17:54 -07:00
prompt.h
protocol-caps.c odb: rename `oid_object_info()` 2025-07-01 14:46:37 -07:00
protocol-caps.h
protocol.c Merge branch 'jc/string-list-split' 2025-08-21 13:46:59 -07:00
protocol.h
prune-packed.c object-file: get rid of `the_repository` in loose object iterators 2025-07-16 22:16:17 -07:00
prune-packed.h
pseudo-merge.c refs: expose peeled object ID via the iterator 2025-11-04 07:32:25 -08:00
pseudo-merge.h
quote.c
quote.h
range-diff.c range-diff: rename other_arg to log_arg 2025-09-25 11:34:11 -07:00
range-diff.h range-diff: rename other_arg to log_arg 2025-09-25 11:34:11 -07:00
reachable.c refs: introduce wrapper struct for `each_ref_fn` 2025-11-04 07:32:24 -08:00
reachable.h
read-cache-ll.h
read-cache.c Merge branch 'ps/rust-balloon' 2025-10-08 12:17:55 -07:00
read-cache.h
rebase-interactive.c config: drop `git_config_get_value()` wrapper 2025-07-23 08:15:18 -07:00
rebase-interactive.h
rebase.c
rebase.h
ref-filter.c ref-filter: detect broken tags when dereferencing them 2025-11-04 07:32:25 -08:00
ref-filter.h ref-filter: propagate peeled object ID 2025-11-04 07:32:25 -08:00
reflog-walk.c refs: pass refname when invoking reflog entry callback 2025-08-06 14:19:30 -07:00
reflog-walk.h
reflog.c refs: introduce wrapper struct for `each_ref_fn` 2025-11-04 07:32:24 -08:00
reflog.h Merge branch 'ps/remote-rename-fix' 2025-08-21 13:46:58 -07:00
refs.c object: add flag to `peel_object()` to verify object type 2025-11-04 07:32:25 -08:00
refs.h refs: drop infrastructure to peel via iterators 2025-11-04 07:32:25 -08:00
refspec.c
refspec.h
remote-curl.c Merge branch 'js/curl-off-t-fixes' into maint-2.51 2025-10-14 13:40:53 -07:00
remote.c refs: introduce wrapper struct for `each_ref_fn` 2025-11-04 07:32:24 -08:00
remote.h submodule: look up remotes by URL first 2025-06-23 16:38:57 -07:00
repack-cruft.c repack: move `write_cruft_pack()` out of the builtin 2025-10-16 10:08:57 -07:00
repack-filtered.c repack: move `write_filtered_pack()` out of the builtin 2025-10-16 10:08:57 -07:00
repack-geometry.c repack: move `pack_kept_objects` to `struct pack_objects_args` 2025-10-16 10:08:57 -07:00
repack-midx.c refs: expose peeled object ID via the iterator 2025-11-04 07:32:25 -08:00
repack-promisor.c builtin/repack.c: remove "repack_promisor_objects()" from the builtin 2025-10-16 10:08:55 -07:00
repack.c repack: move `pack_kept_objects` to `struct pack_objects_args` 2025-10-16 10:08:57 -07:00
repack.h repack: move `write_cruft_pack()` out of the builtin 2025-10-16 10:08:57 -07:00
replace-object.c refs: introduce wrapper struct for `each_ref_fn` 2025-11-04 07:32:24 -08:00
replace-object.h object-store: rename files to "odb.{c,h}" 2025-07-01 14:46:34 -07:00
repo-settings.c Merge branch 'ds/path-walk-2' 2025-06-17 10:44:38 -07:00
repo-settings.h Merge branch 'ds/path-walk-2' 2025-06-17 10:44:38 -07:00
repository.c Merge branch 'pw/3.0-commentchar-auto-deprecation' 2025-09-18 10:07:00 -07:00
repository.h config: warn on core.commentString=auto 2025-08-26 08:52:44 -07:00
rerere.c config: move Git config parsing into "environment.c" 2025-07-23 08:15:22 -07:00
rerere.h
reset.c
reset.h
resolve-undo.c
resolve-undo.h
revision.c refs: introduce wrapper struct for `each_ref_fn` 2025-11-04 07:32:24 -08:00
revision.h Merge branch 'kh/format-patch-range-diff-notes' 2025-10-14 12:56:09 -07:00
run-command.c config: drop `git_config_get_bool()` wrapper 2025-07-23 08:15:20 -07:00
run-command.h
sane-ctype.h sane-ctype: fix compiler error on Amazon Linux 2 2025-07-10 11:18:37 -07:00
scalar.c config: drop `git_config_get_multivar_gently()` wrapper 2025-07-23 08:15:21 -07:00
send-pack.c Merge branch 'ps/object-store' 2025-07-15 15:18:18 -07:00
send-pack.h
sequencer.c Merge branch 'pw/rebase-i-cleanup-fix' into maint-2.51 2025-10-15 10:29:31 -07:00
sequencer.h treewide: pass strvecs around for setup_revisions_from_strvec() 2025-09-22 14:27:03 -07:00
serve.c Use legacy hash for legacy formats 2025-07-01 14:58:24 -07:00
serve.h
server-info.c refs: introduce wrapper struct for `each_ref_fn` 2025-11-04 07:32:24 -08:00
server-info.h
setup.c Merge branch 'jc/string-list-split' 2025-08-21 13:46:59 -07:00
setup.h setup: use the default algorithm to initialize repo format 2025-07-01 14:58:24 -07:00
sh-i18n--envsubst.c
sha1dc_git.c
sha1dc_git.h
shallow.c refs: introduce wrapper struct for `each_ref_fn` 2025-11-04 07:32:24 -08:00
shallow.h treewide: pass strvecs around for setup_revisions_from_strvec() 2025-09-22 14:27:03 -07:00
shared.mak Makefile: introduce infrastructure to build internal Rust library 2025-10-02 09:32:31 -07:00
shell.c
shortlog.h
sideband.c color: use git_colorbool enum type to store colorbools 2025-09-16 17:59:53 -07:00
sideband.h
sigchain.c
sigchain.h
simple-ipc.h
sparse-index.c
sparse-index.h
split-index.c
split-index.h
stable-qsort.c
statinfo.c
statinfo.h
strbuf.c strbuf: convert predicates to return bool 2025-07-16 08:18:06 -07:00
strbuf.h strbuf: convert predicates to return bool 2025-07-16 08:18:06 -07:00
streaming.c odb: rename `oid_object_info()` 2025-07-01 14:46:37 -07:00
streaming.h
string-list.c string-list: change "string_list_find_insert_index" return type to "size_t" 2025-10-06 09:11:07 -07:00
string-list.h string-list: change "string_list_find_insert_index" return type to "size_t" 2025-10-06 09:11:07 -07:00
strmap.c
strmap.h
strvec.c
strvec.h
sub-process.c sub-process: do not use strbuf_split*() 2025-08-02 22:44:58 -07:00
sub-process.h doc: update references to renamed AsciiDoc files 2025-06-06 15:05:47 -07:00
submodule-config.c config: drop `git_config_set_in_file_gently()` wrapper 2025-07-23 08:15:21 -07:00
submodule-config.h
submodule.c refs: introduce wrapper struct for `each_ref_fn` 2025-11-04 07:32:24 -08:00
submodule.h odb: get rid of `the_repository` when handling submodule sources 2025-07-01 14:46:37 -07:00
symlinks.c
symlinks.h
tag.c object: add flag to `peel_object()` to verify object type 2025-11-04 07:32:25 -08:00
tag.h object: add flag to `peel_object()` to verify object type 2025-11-04 07:32:25 -08:00
tar.h
tempfile.c
tempfile.h
thread-utils.c thread-utils.c: detect online CPU count on OpenBSD / NetBSD 2025-06-01 17:15:13 -07:00
thread-utils.h
tmp-objdir.c object-file: get rid of `the_repository` in `finalize_object_file()` 2025-07-16 22:16:14 -07:00
tmp-objdir.h
trace.c
trace.h
trace2.c
trace2.h
trailer.c config: drop `git_config()` wrapper 2025-07-23 08:15:18 -07:00
trailer.h
transport-helper.c packfile: split up responsibilities of `reprepare_packed_git()` 2025-09-24 11:53:50 -07:00
transport-internal.h
transport.c Merge branch 'jk/color-variable-fixes' 2025-09-29 11:40:35 -07:00
transport.h
tree-diff.c diff: teach tree-diff a max-depth parameter 2025-08-07 15:29:35 -07:00
tree-walk.c odb: rename `read_object_with_reference()` 2025-07-01 14:46:39 -07:00
tree-walk.h
tree.c odb: rename `repo_read_object_file()` 2025-07-01 14:46:38 -07:00
tree.h
unicode-width.h
unimplemented.sh
unix-socket.c
unix-socket.h
unix-stream-server.c
unix-stream-server.h
unpack-trees.c object-store: rename files to "odb.{c,h}" 2025-07-01 14:46:34 -07:00
unpack-trees.h
upload-pack.c upload-pack: convert to use `reference_get_peeled_oid()` 2025-11-04 07:32:25 -08:00
upload-pack.h
url.c
url.h
urlmatch.c
urlmatch.h
usage.c Merge branch 'kh/you-still-use-whatchanged-fix' 2025-10-02 12:26:12 -07:00
userdiff.c userdiff: add support for R programming language 2025-05-29 15:29:37 -07:00
userdiff.h
utf8.c
utf8.h
varint.c varint: use explicit width for integers 2025-10-02 09:32:32 -07:00
varint.h varint: use explicit width for integers 2025-10-02 09:32:32 -07:00
version-def.h.in
version.c
version.h
versioncmp.c config: drop `git_config_get_string_multi()` wrapper 2025-07-23 08:15:19 -07:00
versioncmp.h
walker.c refs: introduce wrapper struct for `each_ref_fn` 2025-11-04 07:32:24 -08:00
walker.h
wildmatch.c
wildmatch.h
worktree.c refs: introduce wrapper struct for `each_ref_fn` 2025-11-04 07:32:24 -08:00
worktree.h
wrapper.c config: values of pathname type can be prefixed with :(optional) 2025-10-07 10:05:48 -07:00
wrapper.h config: values of pathname type can be prefixed with :(optional) 2025-10-07 10:05:48 -07:00
write-or-die.c
write-or-die.h
ws.c
ws.h
wt-status.c Merge branch 'jk/color-variable-fixes' 2025-09-29 11:40:35 -07:00
wt-status.h color: use git_colorbool enum type to store colorbools 2025-09-16 17:59:53 -07:00
xdiff-interface.c config: move Git config parsing into "environment.c" 2025-07-23 08:15:22 -07:00
xdiff-interface.h diff: ensure consistent diff behavior with ignore options 2025-08-08 07:54:44 -07:00

README.md

Build status

Git - fast, scalable, distributed revision control system

Git is a fast, scalable, distributed revision control system with an unusually rich command set that provides both high-level operations and full access to internals.

Git is an Open Source project covered by the GNU General Public License version 2 (some parts of it are under different licenses, compatible with the GPLv2). It was originally written by Linus Torvalds with help of a group of hackers around the net.

Please read the file INSTALL for installation instructions.

Many Git online resources are accessible from https://git-scm.com/ including full documentation and Git related tools.

See Documentation/gittutorial.adoc to get started, then see Documentation/giteveryday.adoc for a useful minimum set of commands, and Documentation/git-<commandname>.adoc for documentation of each command. If git has been correctly installed, then the tutorial can also be read with man gittutorial or git help tutorial, and the documentation of each command with man git-<commandname> or git help <commandname>.

CVS users may also want to read Documentation/gitcvs-migration.adoc (man gitcvs-migration or git help cvs-migration if git is installed).

The user discussion and development of Git take place on the Git mailing list -- everyone is welcome to post bug reports, feature requests, comments and patches to git@vger.kernel.org (read Documentation/SubmittingPatches for instructions on patch submission and Documentation/CodingGuidelines).

Those wishing to help with error message, usage and informational message string translations (localization l10) should see po/README.md (a po file is a Portable Object file that holds the translations).

To subscribe to the list, send an email to git+subscribe@vger.kernel.org (see https://subspace.kernel.org/subscribing.html for details). The mailing list archives are available at https://lore.kernel.org/git/, https://marc.info/?l=git and other archival sites.

Issues which are security relevant should be disclosed privately to the Git Security mailing list git-security@googlegroups.com.

The maintainer frequently sends the "What's cooking" reports that list the current status of various development topics to the mailing list. The discussion following them give a good reference for project status, development direction and remaining tasks.

The name "git" was given by Linus Torvalds when he wrote the very first version. He described the tool as "the stupid content tracker" and the name as (depending on your mood):

  • random three-letter combination that is pronounceable, and not actually used by any common UNIX command. The fact that it is a mispronunciation of "get" may or may not be relevant.
  • stupid. contemptible and despicable. simple. Take your pick from the dictionary of slang.
  • "global information tracker": you're in a good mood, and it actually works for you. Angels sing, and a light suddenly fills the room.
  • "goddamn idiotic truckload of sh*t": when it breaks