Go to file
Patrick Steinhardt 6914a9a127 reftable/block: fix OOB write with bogus inflated log size
The "log" reftable block stores reflog information. This information is
compressed using zlib. The inflated size is stored in the block header
so that callers can easily learn ahead of time how large of a buffer
they have to allocate to inflate the data in a single pass. So to
reconstruct the full inflated block we:

  - Copy over the header as-is, as it's not deflated.

  - Append the inflated data to the buffer.

The inflated block size stored in the header also includes the length of
the header itself. So to figure out the bytes that should be inflated by
zlib we need to subtract the header size, which is trusted data, from
the block size, which is untrusted data derived from the block header.

While we do verify that we were able to inflate all data as expected, we
don't verify ahead of time that the encoded block length is larger than
the header length. This can lead to an underflow, which makes zlib
assume that it can write more data into the target buffer than we have
allocated. The result is an out-of-bounds write:

  ==1422297==ERROR: AddressSanitizer: heap-buffer-overflow on address 0x7c1ff6de5231 at pc 0x55555579a628 bp 0x7fffffff4f10 sp 0x7fffffff46d0
  WRITE of size 4 at 0x7c1ff6de5231 thread T0
      #0 0x55555579a627 in __asan_memcpy (./build/t/unit-tests+0x246627)
      #1 0x55555598b093 in reftable_block_init ./build/../reftable/block.c:277:3
      #2 0x555555813701 in test_reftable_block__corrupt_log_block_size ./build/../t/unit-tests/u-reftable-block.c:495:20
      #3 0x5555557f684e in clar_run_test ./build/../t/unit-tests/clar/clar.c:335:3
      #4 0x5555557f2e69 in clar_run_suite ./build/../t/unit-tests/clar/clar.c:431:3
      #5 0x5555557f2882 in clar_test_run ./build/../t/unit-tests/clar/clar.c:636:4
      #6 0x5555557f375f in clar_test ./build/../t/unit-tests/clar/clar.c:687:11
      #7 0x5555557fa49d in cmd_main ./build/../t/unit-tests/unit-test.c:62:8
      #8 0x55555584af4a in main ./build/../common-main.c:9:11
      #9 0x7ffff7a2b284 in __libc_start_call_main (/nix/store/57iz36553175g3178pvxjij8z5rcsd4n-glibc-2.42-61/lib/libc.so.6+0x2b284) (BuildId: 8ae0b698f2d4e727f569f64bb166e08ae30bd077)
      #10 0x7ffff7a2b337 in __libc_start_main@GLIBC_2.2.5 (/nix/store/57iz36553175g3178pvxjij8z5rcsd4n-glibc-2.42-61/lib/libc.so.6+0x2b337) (BuildId: 8ae0b698f2d4e727f569f64bb166e08ae30bd077)
      #11 0x555555694c24 in _start (./build/t/unit-tests+0x140c24)

  0x7c1ff6de5231 is located 0 bytes after 1-byte region [0x7c1ff6de5230,0x7c1ff6de5231)
  allocated by thread T0 here:
      #0 0x55555579db1b in realloc.part.0 asan_malloc_linux.cpp.o
      #1 0x5555559868d7 in reftable_realloc ./build/../reftable/basics.c:36:9
      #2 0x55555598a98f in reftable_alloc_grow ./build/../reftable/basics.h:229:10
      #3 0x55555598ae58 in reftable_block_init ./build/../reftable/block.c:269:3
      #4 0x555555813701 in test_reftable_block__corrupt_log_block_size ./build/../t/unit-tests/u-reftable-block.c:495:20
      #5 0x5555557f684e in clar_run_test ./build/../t/unit-tests/clar/clar.c:335:3
      #6 0x5555557f2e69 in clar_run_suite ./build/../t/unit-tests/clar/clar.c:431:3
      #7 0x5555557f2882 in clar_test_run ./build/../t/unit-tests/clar/clar.c:636:4
      #8 0x5555557f375f in clar_test ./build/../t/unit-tests/clar/clar.c:687:11
      #9 0x5555557fa49d in cmd_main ./build/../t/unit-tests/unit-test.c:62:8
      #10 0x55555584af4a in main ./build/../common-main.c:9:11
      #11 0x7ffff7a2b284 in __libc_start_call_main (/nix/store/57iz36553175g3178pvxjij8z5rcsd4n-glibc-2.42-61/lib/libc.so.6+0x2b284) (BuildId: 8ae0b698f2d4e727f569f64bb166e08ae30bd077)
      #12 0x7ffff7a2b337 in __libc_start_main@GLIBC_2.2.5 (/nix/store/57iz36553175g3178pvxjij8z5rcsd4n-glibc-2.42-61/lib/libc.so.6+0x2b337) (BuildId: 8ae0b698f2d4e727f569f64bb166e08ae30bd077)
      #13 0x555555694c24 in _start (./build/t/unit-tests+0x140c24)

  SUMMARY: AddressSanitizer: heap-buffer-overflow (./build/t/unit-tests+0x246627) in __asan_memcpy
  Shadow bytes around the buggy address:
    0x7c1ff6de4f80: fa fa fd fd fa fa fd fd fa fa fd fd fa fa fd fd
    0x7c1ff6de5000: fa fa fd fd fa fa fd fd fa fa fd fd fa fa fd fd
    0x7c1ff6de5080: fa fa fd fd fa fa fd fd fa fa fd fd fa fa fd fd
    0x7c1ff6de5100: fa fa fd fd fa fa fd fd fa fa fd fd fa fa fd fd
    0x7c1ff6de5180: fa fa fd fd fa fa fd fd fa fa fd fa fa fa fd fd
  =>0x7c1ff6de5200: fa fa 04 fa fa fa[01]fa fa fa fa fa fa fa fa fa
    0x7c1ff6de5280: fa fa fa fa fa fa fa fa fa fa fa fa fa fa fa fa
    0x7c1ff6de5300: fa fa fa fa fa fa fa fa fa fa fa fa fa fa fa fa
    0x7c1ff6de5380: fa fa fa fa fa fa fa fa fa fa fa fa fa fa fa fa
    0x7c1ff6de5400: fa fa fa fa fa fa fa fa fa fa fa fa fa fa fa fa
    0x7c1ff6de5480: fa fa fa fa fa fa fa fa fa fa fa fa fa fa fa fa
  Shadow byte legend (one shadow byte represents 8 application bytes):
    Addressable:           00
    Partially addressable: 01 02 03 04 05 06 07
    Heap left redzone:       fa
    Freed heap region:       fd
    Stack left redzone:      f1
    Stack mid redzone:       f2
    Stack right redzone:     f3
    Stack after return:      f5
    Stack use after scope:   f8
    Global redzone:          f9
    Global init order:       f6
    Poisoned by user:        f7
    Container overflow:      fc
    Array cookie:            ac
    Intra object redzone:    bb
    ASan internal:           fe
    Left alloca redzone:     ca
    Right alloca redzone:    cb

Fix the bug by adding a sanity check and add a unit test.

Reported-by: oxsignal <awo@kakao.com>
Signed-off-by: Patrick Steinhardt <ps@pks.im>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
2026-07-03 11:08:02 -07:00
.github codeql: bump actions/cache from 4 to 5 2026-04-15 14:31:40 -07:00
Documentation doc: fix grammar errors in submodule description 2026-04-16 21:22:01 -07:00
bin-wrappers
block-sha1
builtin Merge branch 'ds/rev-list-maximal-only-optim' 2026-04-09 11:21:59 -07:00
ci oss-fuzz: add fuzzer for parsing reftables 2026-07-03 11:08:02 -07:00
compat Revert "compat/posix: introduce writev(3p) wrapper" 2026-04-09 14:48:24 -07:00
compiler-tricks
contrib Revert "cmake: use writev(3p) wrapper as needed" 2026-04-09 14:47:28 -07:00
ewah cocci: extend MEMZERO_ARRAY() rules 2026-02-03 09:41:52 -08:00
git-gui Merge branch 'master' of https://github.com/j6t/git-gui 2026-03-21 09:25:58 -07:00
gitk-git Merge branch 'master' of https://github.com/j6t/gitk 2026-03-21 09:25:10 -07:00
gitweb gitweb: let page header grow on mobile for long wrapped project names 2026-02-17 11:49:13 -08:00
mergetools
negotiator use commit_stack instead of prio_queue in LIFO mode 2026-03-18 10:39:56 -07:00
odb odb: use enum for `odb_write_object` flags 2026-03-31 20:43:13 -07:00
oss-fuzz oss-fuzz: add fuzzer for parsing reftables 2026-07-03 11:08:02 -07:00
perl
po Merge branch 'master' of github.com:alshopov/git-po 2026-04-20 07:37:21 +08:00
refs Merge branch 'jk/c23-const-preserving-fixes-more' 2026-04-09 11:21:59 -07:00
reftable reftable/block: fix OOB write with bogus inflated log size 2026-07-03 11:08:02 -07:00
sha1
sha1collisiondetection@855827c583
sha1dc
sha256
src rust: add a small wrapper around the hashfile code 2026-02-07 17:41:03 -08:00
subprojects meson: wire up gitk and git-gui 2026-02-04 09:42:50 -08:00
t reftable/block: fix OOB write with bogus inflated log size 2026-07-03 11:08:02 -07:00
templates Merge branch 'pt/fsmonitor-watchman-sample-fix' 2026-03-10 14:23:23 -07:00
tools Merge branch 'rs/use-strvec-pushv' 2026-04-01 10:28:19 -07:00
trace2
xdiff Merge branch 'yc/histogram-hunk-shift-fix' 2026-03-24 12:31:34 -07:00
.cirrus.yml
.clang-format clang-format: exclude control macros from SpaceBeforeParens 2025-09-28 08:37:23 -07:00
.editorconfig editorconfig: fix style not applying to subdirs anymore 2026-03-11 10:30:51 -07:00
.gitattributes templates: add .gitattributes entry for sample hooks 2026-02-13 09:26:11 -08:00
.gitignore gitk: ignore generated POT file 2026-03-20 09:31:04 +08:00
.gitlab-ci.yml Merge branch 'ps/ci-gitlab-prepare-for-macos-14-deprecation' 2026-03-12 10:56:04 -07:00
.gitmodules
.mailmap .mailmap: update email address for Tian Yuchen 2026-03-09 12:46:34 -07:00
.tsan-suppressions
CODE_OF_CONDUCT.md
COPYING
Cargo.toml ci: verify minimum supported Rust version 2025-10-15 08:10:17 -07:00
GIT-BUILD-OPTIONS.in
GIT-VERSION-FILE.in
GIT-VERSION-GEN Git 2.54 2026-04-19 19:01:39 -07:00
INSTALL
LGPL-2.1
Makefile oss-fuzz: add fuzzer for parsing reftables 2026-07-03 11:08:02 -07:00
README.md
RelNotes Start 2.54 cycle 2026-02-05 15:42:01 -08:00
SECURITY.md
abspath.c
abspath.h
aclocal.m4
add-interactive.c add-patch: allow disabling editing of hunks 2026-03-03 15:09:36 -08:00
add-interactive.h add-patch: split out `struct interactive_options` 2026-03-03 15:09:35 -08:00
add-patch.c Merge branch 'sp/add-patch-with-fewer-the-repository' 2026-04-07 14:59:26 -07:00
add-patch.h add-patch: allow disabling editing of hunks 2026-03-03 15:09:36 -08: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: treat empty subsection [alias ""] as plain [alias] 2026-02-26 13:06:49 -08:00
alias.h
alloc.c
alloc.h
apply.c Merge branch 'jc/whitespace-incomplete-line' 2026-04-07 14:59:26 -07:00
apply.h apply: report input location in header parsing errors 2026-03-17 11:08:24 -07:00
archive-tar.c streaming: drop redundant type and size pointers 2025-11-23 12:56:46 -08:00
archive-zip.c streaming: drop redundant type and size pointers 2025-11-23 12:56:46 -08:00
archive.c cocci: convert parse_tree functions to repo_ variants 2026-01-09 18:36:18 -08:00
archive.h
attr.c environment: stop storing `core.attributesFile` globally 2026-02-17 12:09:42 -08:00
attr.h
banned.h banned.h: ban mktemp(3) 2025-12-07 07:28:13 +09:00
base85.c
base85.h
bisect.c Merge branch 'ps/for-each-ref-in-fixes' 2026-02-27 15:11:50 -08:00
bisect.h
blame.c commit: rename `free_commit_list()` to conform to coding guidelines 2026-01-15 05:32:31 -08:00
blame.h
blob.c
blob.h
bloom.c Merge branch 'cf/constness-fixes' 2026-03-23 09:20:29 -07:00
bloom.h
branch.c branch: advice using git-help(1) instead of man(1) 2025-12-03 00:16:05 -08:00
branch.h environment: move "branch.autoSetupMerge" into `struct repo_config_values` 2026-02-26 07:22:53 -08:00
build.rs rust: add a build.rs script for tests 2026-02-07 17:41:03 -08:00
builtin.h Merge branch 'ps/history' 2026-02-09 12:09:09 -08:00
bundle-uri.c bundle-uri: validate that bundle entries have a uri 2025-12-20 14:45:27 +09:00
bundle-uri.h
bundle.c
bundle.h
cache-tree.c Merge branch 'jd/cache-tree-trace-wo-the-repository' 2026-04-08 10:19:17 -07:00
cache-tree.h cache-tree: allow writing in-memory index as tree 2026-03-03 15:09:36 -08:00
cbtree.c oidtree: extend iteration to allow for arbitrary return codes 2026-03-20 13:16:22 -07:00
cbtree.h oidtree: extend iteration to allow for arbitrary return codes 2026-03-20 13:16:22 -07:00
chdir-notify.c chdir-notify: add function to unregister listeners 2025-11-25 12:16:00 -08:00
chdir-notify.h chdir-notify: add function to unregister listeners 2025-11-25 12:16:00 -08:00
checkout.c
checkout.h
chunk-format.c
chunk-format.h
color.c color: add color_parse_quietly() 2026-02-23 13:23:41 -08:00
color.h color: add color_parse_quietly() 2026-02-23 13:23:41 -08: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 builtin: add new "history" command 2026-01-13 05:41:17 -08:00
commit-graph.c Merge branch 'ps/commit-graph-overflow-fix' 2026-04-07 14:59:25 -07:00
commit-graph.h
commit-reach.c commit-reach: simplify cleanup of remaining bitmaps in ahead_behind () 2026-03-19 10:45:41 -07:00
commit-reach.h
commit-slab-decl.h
commit-slab-impl.h
commit-slab.h
commit.c gpg-interface: allow sign_buffer() to use default signing key 2026-03-12 21:28:20 -07:00
commit.h Merge branch 'ps/history-split' 2026-03-24 12:31:32 -07:00
common-exit.c
common-init.c
common-init.h
common-main.c
config.c global: constify some pointers that are not written to 2026-02-05 17:52:49 -08:00
config.h config: mark otherwise unused function as file-scope static 2025-11-20 15:03:40 -08:00
config.mak.dev builds: move build scripts into "tools/" 2026-03-19 06:40:09 -07:00
config.mak.in
config.mak.uname Revert "compat/posix: introduce writev(3p) wrapper" 2026-04-09 14:48:24 -07:00
configure.ac
connect.c transport-helper, connect: use clean_on_exit to reap children on abnormal exit 2026-03-12 14:51:50 -07:00
connect.h
connected.c check_connected(): fix leak of pack-index mmap 2026-03-06 13:51:03 -08:00
connected.h
convert.c convert: add const to fix strchr() warnings 2026-04-01 22:08:50 -07:00
convert.h
copy.c
copy.h
credential.c
credential.h
csum-file.c Merge branch 'ps/upload-pack-buffer-more-writes' 2026-03-24 12:31:34 -07:00
csum-file.h Merge branch 'ps/upload-pack-buffer-more-writes' 2026-03-24 12:31:34 -07:00
ctype.c
daemon.c
date.c
date.h
decorate.c
decorate.h
delta-islands.c delta-islands: use repo_parse_tree() 2026-01-09 18:36:17 -08:00
delta-islands.h
delta.h
diagnose.c
diagnose.h
diff-delta.c git-compat-util: introduce MEMZERO_ARRAY() macro 2025-12-11 14:44:43 +09:00
diff-lib.c Merge branch 'ps/commit-list-functions-renamed' 2026-02-13 13:39:25 -08: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 'mm/line-log-use-standard-diff-output' 2026-04-07 14:59:27 -07:00
diff.h Merge branch 'rs/diff-index-find-copies-harder-optim' 2025-12-14 17:04:36 +09:00
diffcore-break.c Merge branch 'en/merge-ort-almost-wo-the-repository' 2026-03-04 10:53:02 -08:00
diffcore-delta.c cocci: extend MEMZERO_ARRAY() rules 2026-02-03 09:41:52 -08:00
diffcore-order.c
diffcore-pickaxe.c
diffcore-rename.c merge,diff: remove the_repository check before prefetching blobs 2026-02-21 18:34:06 -08:00
diffcore-rotate.c
diffcore.h line-log: route -L output through the standard diff pipeline 2026-03-16 21:05:42 -07:00
dir-iterator.c
dir-iterator.h
dir.c Merge branch 'cf/constness-fixes' 2026-03-23 09:20:29 -07:00
dir.h dir: add generic "walk all files" helper 2025-09-12 08:59:52 -07:00
editor.c
editor.h
entry.c streaming: move into object database subsystem 2025-11-23 12:56:46 -08:00
entry.h
environment.c Merge branch 'ob/core-attributesfile-in-repository' 2026-03-05 10:04:49 -08:00
environment.h Merge branch 'ob/core-attributesfile-in-repository' 2026-03-05 10:04:49 -08:00
exec-cmd.c
exec-cmd.h
fetch-negotiator.c
fetch-negotiator.h
fetch-pack.c Merge branch 'ps/odb-cleanup' 2026-04-08 10:19:17 -07:00
fetch-pack.h
fmt-merge-msg.c Merge branch 'ps/commit-list-functions-renamed' 2026-02-13 13:39:25 -08:00
fmt-merge-msg.h
for-each-ref.h
fsck.c fsck: drop USE_THE_REPOSITORY 2026-03-23 08:33:10 -07:00
fsck.h fsck: store repository in fsck options 2026-03-23 08:33:10 -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
fsmonitor.h
gettext.c
gettext.h
git-archimport.perl
git-compat-util.h git-compat-util: fix CONST_OUTPARAM typo and indentation 2026-04-06 08:22:57 -07:00
git-curl-compat.h http: add support for HTTP 429 rate limit retries 2026-03-17 09:14:19 -07:00
git-cvsexportcommit.perl
git-cvsimport.perl
git-cvsserver.perl
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 'sp/send-email-validate-charset' 2026-03-12 10:56:05 -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 use strvec_pushv() to add another strvec 2026-03-24 12:26:58 -07:00
git.rc.in
gpg-interface.c fast-import: add 'abort-if-invalid' mode to '--signed-commits=<mode>' 2026-03-26 12:42:57 -07:00
gpg-interface.h fast-import: add 'abort-if-invalid' mode to '--signed-commits=<mode>' 2026-03-26 12:42:57 -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 object-name: simplify computing common prefixes 2026-03-20 13:16:42 -07:00
hash.h object-name: simplify computing common prefixes 2026-03-20 13:16:42 -07:00
hashmap.c git-compat-util: introduce MEMZERO_ARRAY() macro 2025-12-11 14:44:43 +09:00
hashmap.h
help.c Merge branch 'jh/alias-i18n-fixes' 2026-03-10 14:23:24 -07:00
help.h
hex-ll.c
hex-ll.h
hex.c refs/files-backend: drop const to fix strchr() warning 2026-04-01 22:08:53 -07:00
hex.h refs/files-backend: drop const to fix strchr() warning 2026-04-01 22:08:53 -07:00
hook.c hook: show disabled hooks in "git hook list" 2026-03-25 14:00:47 -07:00
hook.h hook: show disabled hooks in "git hook list" 2026-03-25 14:00:47 -07:00
http-backend.c refs: replace `refs_for_each_namespaced_ref()` 2026-02-23 13:21:19 -08:00
http-fetch.c
http-push.c Merge branch 'jk/c23-const-preserving-fixes-more' 2026-04-09 11:21:59 -07:00
http-walker.c odb: rename `odb_has_object()` flags 2026-03-31 20:43:14 -07:00
http.c Merge branch 'jk/c23-const-preserving-fixes-more' 2026-04-09 11:21:59 -07:00
http.h http: add support for HTTP 429 rate limit retries 2026-03-17 09:14:19 -07:00
ident.c Merge branch 'ps/reflog-migrate-fixes' into maint-2.51 2025-10-15 10:29:28 -07:00
ident.h
imap-send.c imap-send: move common code into function host_matches() 2026-03-11 15:25:15 -07:00
iterator.h
json-writer.c
json-writer.h
khash.h
kwset.c
kwset.h
levenshtein.c
levenshtein.h
line-log.c line-log: route -L output through the standard diff pipeline 2026-03-16 21:05:42 -07:00
line-log.h line-log: route -L output through the standard diff pipeline 2026-03-16 21:05:42 -07:00
line-range.c
line-range.h
linear-assignment.c cocci: use MEMZERO_ARRAY() a bit more 2025-12-13 10:47:59 +09:00
linear-assignment.h
list-objects-filter-options.c list-objects-filter-options: avoid strbuf_split_str() 2026-03-11 11:08:53 -07:00
list-objects-filter-options.h list-objects-filter-options: support 'auto' mode for --filter 2026-02-17 11:46:40 -08:00
list-objects-filter.c list-objects-filter-options: support 'auto' mode for --filter 2026-02-17 11:46:40 -08:00
list-objects-filter.h
list-objects.c odb: rename `odb_has_object()` flags 2026-03-31 20:43:14 -07:00
list-objects.h
list.h
lockfile.c Merge branch 'pc/lockfile-pid' 2026-02-17 13:30:41 -08:00
lockfile.h lockfile: add PID file for debugging stale locks 2026-01-22 12:15:46 -08:00
log-tree.c commit: rename `free_commit_list()` to conform to coding guidelines 2026-01-15 05:32:31 -08:00
log-tree.h color: use git_colorbool enum type to store colorbools 2025-09-16 17:59:53 -07:00
loose.c odb: embed base source in the "files" backend 2026-03-05 11:45:15 -08:00
loose.h
ls-refs.c refs: generalize `refs_for_each_fullref_in_prefixes()` 2026-02-23 13:21:18 -08:00
ls-refs.h
mailinfo.c Merge branch 'vp/http-rate-limit-retries' 2026-04-01 10:28:18 -07:00
mailinfo.h
mailmap.c mailmap: drop global config variables 2026-02-20 08:13:58 -08:00
mailmap.h mailmap: drop global config variables 2026-02-20 08:13:58 -08:00
match-trees.c
match-trees.h
mem-pool.c global: constify some pointers that are not written to 2026-02-05 17:52:49 -08:00
mem-pool.h
merge-blobs.c
merge-blobs.h
merge-ll.c
merge-ll.h
merge-ort-wrappers.c commit: rename `free_commit_list()` to conform to coding guidelines 2026-01-15 05:32:31 -08:00
merge-ort-wrappers.h
merge-ort.c merge-ort: prevent the_repository from coming back 2026-02-21 18:34:07 -08:00
merge-ort.h
merge.c cocci: convert parse_tree functions to repo_ variants 2026-01-09 18:36:18 -08:00
merge.h
mergesort.h
meson.build meson: support building fuzzers with libFuzzer 2026-07-03 11:08:02 -07:00
meson_options.txt meson: support building fuzzers with libFuzzer 2026-07-03 11:08:02 -07:00
midx-write.c MIDX: revert the default version to v1 2026-04-16 13:45:53 -07:00
midx.c Merge branch 'tb/incremental-midx-part-3.2' 2026-03-25 12:58:04 -07:00
midx.h midx: implement MIDX compaction 2026-02-24 11:16:34 -08:00
name-hash.c
name-hash.h
notes-cache.c
notes-cache.h
notes-merge.c Merge branch 'rs/xdiff-wo-the-repository' 2026-02-17 13:30:42 -08:00
notes-merge.h
notes-utils.c commit: rename `free_commit_list()` to conform to coding guidelines 2026-01-15 05:32:31 -08:00
notes-utils.h
notes.c odb: rename `odb_has_object()` flags 2026-03-31 20:43:14 -07:00
notes.h
object-file-convert.c Merge branch 'bc/sha1-256-interop-02' 2026-03-12 10:56:02 -07:00
object-file-convert.h
object-file.c Merge branch 'jt/index-fd-wo-repo-regression-fix-maint' 2026-04-08 10:20:51 -07:00
object-file.h odb: use enum for `odb_write_object` flags 2026-03-31 20:43:13 -07:00
object-name.c Merge branch 'ps/odb-generic-object-name-handling' 2026-04-06 15:42:49 -07:00
object-name.h object-name: turn INTERPRET_BRANCH_* constants into enum values 2026-03-18 12:52:29 -07:00
object.c Merge branch 'ps/fsck-stream-from-the-right-object-instance' 2026-03-05 10:04:49 -08:00
object.h Merge branch 'ps/receive-pack-shallow-optim' 2026-03-02 17:06:53 -08:00
odb.c odb: rename `odb_has_object()` flags 2026-03-31 20:43:14 -07:00
odb.h odb: drop unneeded headers and forward decls 2026-03-31 20:43:14 -07:00
oid-array.c
oid-array.h
oidmap.c oidmap: make entry cleanup explicit in oidmap_clear 2026-03-05 11:16:18 -08:00
oidmap.h oidmap: make entry cleanup explicit in oidmap_clear 2026-03-05 11:16:18 -08:00
oidset.c oidset: introduce `oidset_equal()` 2025-11-25 12:15:59 -08:00
oidset.h oidset: introduce `oidset_equal()` 2025-11-25 12:15:59 -08:00
oidtree.c oidtree: extend iteration to allow for arbitrary return codes 2026-03-20 13:16:22 -07:00
oidtree.h oidtree: extend iteration to allow for arbitrary return codes 2026-03-20 13:16:22 -07:00
pack-bitmap-write.c Merge branch 'ps/commit-list-functions-renamed' 2026-02-13 13:39:25 -08:00
pack-bitmap.c Merge branch 'tb/incremental-midx-part-3.2' 2026-03-25 12:58:04 -07:00
pack-bitmap.h refs: rename `each_ref_fn` 2026-02-23 13:21:18 -08:00
pack-check.c builtin/fsck: stop using `the_repository` when checking packed objects 2026-03-23 08:33:11 -07:00
pack-mtimes.c
pack-mtimes.h
pack-objects.c Merge branch 'ps/remove-packfile-store-get-packs' 2025-10-30 08:00:19 -07:00
pack-objects.h
pack-refs.c refs: rename 'pack_refs_opts' to 'refs_optimize_opts' 2025-11-04 07:35:12 -08: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 Merge branch 'tb/incremental-midx-part-3.2' 2026-03-25 12:58:04 -07:00
pack-revindex.h midx: fix `BUG()` when getting preferred pack without a reverse index 2025-12-11 12:09:58 +09:00
pack-write.c
pack.h builtin/fsck: stop using `the_repository` when checking packed objects 2026-03-23 08:33:11 -07:00
packfile.c Merge branch 'ps/odb-cleanup' 2026-04-08 10:19:17 -07:00
packfile.h Merge branch 'ps/odb-cleanup' 2026-04-08 10:19:17 -07:00
pager.c pager: explicitly cast away strchr() constness 2026-04-01 22:08:51 -07:00
pager.h
parallel-checkout.c streaming: move into object database subsystem 2025-11-23 12:56:46 -08: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 'rs/parse-options-duplicated-long-options' 2026-03-10 14:23:19 -07:00
parse-options.h
parse.c
parse.h
patch-delta.c
patch-ids.c patch-ids: document intentional const-casting in patch_id_neq() 2026-03-09 12:45:19 -07:00
patch-ids.h
path-walk.c Merge branch 'yc/path-walk-fix-error-reporting' 2026-04-07 14:59:26 -07:00
path-walk.h
path.c backfill: work with prefix pathspecs 2026-03-26 09:38:06 -07:00
path.h backfill: work with prefix pathspecs 2026-03-26 09:38:06 -07:00
pathspec.c
pathspec.h
pkt-line.c global: constify some pointers that are not written to 2026-02-05 17:52:49 -08:00
pkt-line.h pkt-line: make packet_reader.line non-const 2026-04-01 22:08:52 -07:00
preload-index.c
preload-index.h
pretty.c Merge branch 'mf/format-patch-cover-letter-format' 2026-04-03 13:01:08 -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.h
progress.c
progress.h
promisor-remote.c promisor-remote: change promisor_remote_reply()'s signature 2026-02-17 11:46:41 -08:00
promisor-remote.h promisor-remote: change promisor_remote_reply()'s signature 2026-02-17 11:46:41 -08:00
prompt.c
prompt.h
protocol-caps.c remove duplicate includes 2026-02-08 15:03:06 -08:00
protocol-caps.h
protocol.c
protocol.h
prune-packed.c
prune-packed.h
pseudo-merge.c pseudo-merge: fix disk reads from find_pseudo_merge() 2026-04-01 22:08:52 -07:00
pseudo-merge.h
quote.c
quote.h
range-diff.c range-diff: drop const to fix strstr() warnings 2026-04-01 22:08:53 -07:00
range-diff.h range-diff: rename other_arg to log_arg 2025-09-25 11:34:11 -07:00
reachable.c reachable: convert to use `odb_for_each_object()` 2026-01-26 08:26:08 -08:00
reachable.h
read-cache-ll.h read-cache: update add_files_to_cache take param ignored_too 2026-02-06 09:43:26 -08:00
read-cache.c Merge branch 'ng/add-files-to-cache-wo-rename' 2026-04-08 10:19:18 -07:00
read-cache.h
rebase-interactive.c
rebase-interactive.h
rebase.c
rebase.h
ref-filter.c Merge branch 'ps/refs-for-each' 2026-03-09 14:36:55 -07:00
ref-filter.h Merge branch 'jt/repo-structure' 2025-11-04 07:48:07 -08:00
reflog-walk.c global: constify some pointers that are not written to 2026-02-05 17:52:49 -08:00
reflog-walk.h
reflog.c odb: rename `odb_has_object()` flags 2026-03-31 20:43:14 -07:00
reflog.h
refs.c Merge branch 'ps/odb-cleanup' 2026-04-08 10:19:17 -07:00
refs.h object-name: turn INTERPRET_BRANCH_* constants into enum values 2026-03-18 12:52:29 -07:00
refspec.c refspec: fix typo in comment 2026-03-23 21:27:17 -07:00
refspec.h
remote-curl.c Merge branch 'kj/refspec-parsing-outside-repository' 2026-04-01 10:28:19 -07:00
remote.c odb: rename `odb_has_object()` flags 2026-03-31 20:43:14 -07:00
remote.h remote: always allocate branch.push_tracking_ref 2026-01-19 16:24:02 -08:00
repack-cruft.c packfile: introduce macro to iterate through packs 2025-10-16 14:42:39 -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 builtin/repack: handle promisor packs with geometric repacking 2026-01-14 06:29:24 -08:00
repack-midx.c pack-bitmap: deduplicate logic to iterate over preferred bitmap tips 2026-02-19 10:41:18 -08:00
repack-promisor.c Merge branch 'ps/odb-for-each-object' 2026-03-02 17:06:50 -08:00
repack.c packfile: introduce macro to iterate through packs 2025-10-16 14:42:39 -07:00
repack.h builtin/repack: handle promisor packs with geometric repacking 2026-01-14 06:29:24 -08:00
replace-object.c refs: introduce wrapper struct for `each_ref_fn` 2025-11-04 07:32:24 -08:00
replace-object.h
replay.c Merge branch 'tc/replay-ref' 2026-04-08 10:19:18 -07:00
replay.h replay: allow to specify a ref with option --ref 2026-04-01 21:34:25 -07:00
repo-settings.c environment: move access to core.maxTreeDepth into repo settings 2026-01-09 18:36:16 -08:00
repo-settings.h environment: move access to core.maxTreeDepth into repo settings 2026-01-09 18:36:16 -08:00
repository.c Merge branch 'ps/object-counting' 2026-03-25 12:58:05 -07:00
repository.h Merge branch 'bc/sha1-256-interop-02' 2026-03-12 10:56:02 -07:00
rerere.c Merge branch 'jc/rerere-modern-strbuf-handling' 2026-03-27 11:00:03 -07:00
rerere.h
reset.c cocci: convert parse_tree functions to repo_ variants 2026-01-09 18:36:18 -08:00
reset.h
resolve-undo.c
resolve-undo.h
revision.c Merge branch 'mm/line-log-use-standard-diff-output' 2026-04-07 14:59:27 -07:00
revision.h revision: include object-name.h 2026-03-26 09:38:06 -07:00
run-command.c Merge branch 'jk/c23-const-preserving-fixes-more' 2026-04-09 11:21:59 -07:00
run-command.h Merge branch 'bk/run-command-wo-the-repository' 2026-03-19 09:54:56 -07:00
sane-ctype.h
scalar.c global: constify some pointers that are not written to 2026-02-05 17:52:49 -08:00
send-pack.c pkt-line: make packet_reader.line non-const 2026-04-01 22:08:52 -07:00
send-pack.h
sequencer.c Merge branch 'sa/replay-revert' 2026-04-03 13:01:09 -07:00
sequencer.h Merge branch 'sa/replay-revert' 2026-04-03 13:01:09 -07:00
serve.c hash: use uint32_t for object_id algorithm 2026-02-07 17:41:01 -08:00
serve.h
server-info.c Merge branch 'ps/ref-peeled-tags' 2025-11-19 10:55:39 -08:00
server-info.h
setup.c Merge branch 'ty/setup-error-tightening' 2026-03-16 10:48:14 -07:00
setup.h Merge branch 'ty/setup-error-tightening' 2026-03-16 10:48:14 -07:00
sh-i18n--envsubst.c
sha1dc_git.c
sha1dc_git.h
shallow.c odb: rename `odb_has_object()` flags 2026-03-31 20:43:14 -07:00
shallow.h Merge branch 'sp/shallow-deepen-relative-fix' 2026-03-04 10:52:59 -08: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 Revert "sideband: use writev(3p) to send pktlines" 2026-04-09 14:47:51 -07:00
sideband.h
sigchain.c
sigchain.h
simple-ipc.h
sparse-index.c environment: stop using core.sparseCheckout globally 2026-02-26 07:22:51 -08:00
sparse-index.h
split-index.c split-index: stop using the_repository and the_hash_algo 2026-03-19 12:01:24 -07:00
split-index.h
stable-qsort.c
statinfo.c
statinfo.h
strbuf.c Merge branch 'vp/http-rate-limit-retries' 2026-04-01 10:28:18 -07:00
strbuf.h builtin/repo: add inflated object info to structure table 2025-12-18 09:02:31 +09:00
string-list.c hook: move unsorted_string_list_remove() to string-list.[ch] 2026-03-25 14:00:45 -07:00
string-list.h hook: move unsorted_string_list_remove() to string-list.[ch] 2026-03-25 14:00:45 -07:00
strmap.c
strmap.h
strvec.c
strvec.h
sub-process.c
sub-process.h
submodule-config.c odb: stop including "odb/source.h" 2026-03-12 08:38:42 -07:00
submodule-config.h
submodule.c Merge branch 'rs/use-strvec-pushv' 2026-04-01 10:28:19 -07:00
submodule.h
symlinks.c symlinks: use unsigned int for flags 2026-02-20 15:03:42 -08:00
symlinks.h symlinks: use unsigned int for flags 2026-02-20 15:03:42 -08:00
tag.c tag: stop using the_repository 2025-12-29 22:02:54 +09:00
tag.h tag: support arbitrary repositories in parse_tag() 2025-12-29 22:02:54 +09:00
tar.h
tempfile.c
tempfile.h
thread-utils.c
thread-utils.h
tmp-objdir.c odb: stop including "odb/source.h" 2026-03-12 08:38:42 -07:00
tmp-objdir.h odb: move reparenting logic into respective subsystems 2026-03-05 11:45:15 -08:00
trace.c
trace.h
trace2.c
trace2.h
trailer.c Merge branch 'vp/http-rate-limit-retries' 2026-04-01 10:28:18 -07:00
trailer.h commit, tag: parse --trailer with OPT_STRVEC 2026-03-06 13:02:20 -08:00
transport-helper.c Merge branch 'jk/c23-const-preserving-fixes-more' 2026-04-09 11:21:59 -07:00
transport-internal.h
transport.c Merge branch 'ar/config-hook-cleanups' 2026-04-03 13:01:09 -07:00
transport.h
tree-diff.c tree-diff: remove the usage of the_hash_algo global 2026-02-20 10:21:11 -08:00
tree-walk.c environment: move access to core.maxTreeDepth into repo settings 2026-01-09 18:36:16 -08:00
tree-walk.h
tree.c tree: stop using the_repository 2026-01-09 18:36:17 -08:00
tree.h tree: stop using the_repository 2026-01-09 18:36:17 -08:00
unicode-width.h unicode: update the width tables to Unicode 17 2025-10-21 10:03:00 -07:00
unimplemented.sh
unix-socket.c
unix-socket.h
unix-stream-server.c
unix-stream-server.h
unpack-trees.c environment: stop using core.sparseCheckout globally 2026-02-26 07:22:51 -08:00
unpack-trees.h
upload-pack.c Merge branch 'ps/upload-pack-buffer-more-writes' 2026-03-24 12:31:34 -07:00
upload-pack.h
url.c submodule: fix case-folding gitdir filesystem collisions 2026-01-12 11:56:56 -08:00
url.h submodule: fix case-folding gitdir filesystem collisions 2026-01-12 11:56:56 -08:00
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.h
utf8.c utf8.c: prepare workaround for iconv under macOS 14/15 2026-01-12 12:00:04 -08:00
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: stop using the_repository 2026-02-08 15:16:49 -08:00
version.h version: stop using the_repository 2026-02-08 15:16:49 -08:00
versioncmp.c
versioncmp.h
walker.c odb: rename `odb_has_object()` flags 2026-03-31 20:43:14 -07:00
walker.h
wildmatch.c
wildmatch.h
worktree.c Merge branch 'pw/worktree-reduce-the-repository' 2026-04-03 13:01:09 -07:00
worktree.h Merge branch 'pw/worktree-reduce-the-repository' 2026-04-03 13:01:09 -07:00
wrapper.c Revert "wrapper: introduce writev(3p) wrappers" 2026-04-09 14:48:09 -07:00
wrapper.h Revert "wrapper: introduce writev(3p) wrappers" 2026-04-09 14:48:09 -07:00
write-or-die.c Revert "wrapper: introduce writev(3p) wrappers" 2026-04-09 14:48:09 -07:00
write-or-die.h Revert "wrapper: introduce writev(3p) wrappers" 2026-04-09 14:48:09 -07:00
ws.c apply: check and fix incomplete lines 2025-11-12 14:04:04 -08:00
ws.h whitespace: allocate a few more bits and define WS_INCOMPLETE_LINE 2025-11-12 14:04:04 -08:00
wt-status.c Merge branch 'sp/wt-status-wo-the-repository' 2026-03-16 10:48:14 -07:00
wt-status.h wt-status: provide function to expose status for trees 2026-01-13 05:41:16 -08:00
xdiff-interface.c xdiff-interface: stop using the_repository 2026-02-10 08:16:14 -08:00
xdiff-interface.h xdiff-interface: stop using the_repository 2026-02-10 08:16:14 -08: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