Go to file
Patrick Steinhardt b3449b1517 builtin/gc: fix condition for whether to write commit graphs
When performing auto-maintenance we check whether commit graphs need to
be generated by counting the number of commits that are reachable by any
reference, but not covered by a commit graph. This search is performed
by iterating through all references and then doing a depth-first search
until we have found enough commits that are not present in the commit
graph.

This logic has a memory leak though:

  Direct leak of 16 byte(s) in 1 object(s) allocated from:
      #0 0x55555562e433 in malloc (git+0xda433)
      #1 0x555555964322 in do_xmalloc ../wrapper.c:55:8
      #2 0x5555559642e6 in xmalloc ../wrapper.c:76:9
      #3 0x55555579bf29 in commit_list_append ../commit.c:1872:35
      #4 0x55555569f160 in dfs_on_ref ../builtin/gc.c:1165:4
      #5 0x5555558c33fd in do_for_each_ref_iterator ../refs/iterator.c:431:12
      #6 0x5555558af520 in do_for_each_ref ../refs.c:1828:9
      #7 0x5555558ac317 in refs_for_each_ref ../refs.c:1833:9
      #8 0x55555569e207 in should_write_commit_graph ../builtin/gc.c:1188:11
      #9 0x55555569c915 in maintenance_is_needed ../builtin/gc.c:3492:8
      #10 0x55555569b76a in cmd_maintenance ../builtin/gc.c:3542:9
      #11 0x55555575166a in run_builtin ../git.c:506:11
      #12 0x5555557502f0 in handle_builtin ../git.c:779:9
      #13 0x555555751127 in run_argv ../git.c:862:4
      #14 0x55555575007b in cmd_main ../git.c:984:19
      #15 0x5555557523aa in main ../common-main.c:9:11
      #16 0x7ffff7a2a4d7 in __libc_start_call_main (/nix/store/xx7cm72qy2c0643cm1ipngd87aqwkcdp-glibc-2.40-66/lib/libc.so.6+0x2a4d7) (BuildId: cddea92d6cba8333be952b5a02fd47d61054c5ab)
      #17 0x7ffff7a2a59a in __libc_start_main@GLIBC_2.2.5 (/nix/store/xx7cm72qy2c0643cm1ipngd87aqwkcdp-glibc-2.40-66/lib/libc.so.6+0x2a59a) (BuildId: cddea92d6cba8333be952b5a02fd47d61054c5ab)
      #18 0x5555555f0934 in _start (git+0x9c934)

The root cause of this memory leak is our use of `commit_list_append()`.
This function expects as parameters the item to append and the _tail_ of
the list to append. This tail will then be overwritten with the new tail
of the list so that it can be used in subsequent calls. But we call it
with `commit_list_append(parent->item, &stack)`, so we end up losing
everything but the new item.

This issue only surfaces when counting merge commits. Next to being a
memory leak, it also shows that we're in fact miscounting as we only
respect children of the last parent. All previous parents are discarded,
so their children will be disregarded unless they are hit via another
reference.

While crafting a test case for the issue I was puzzled that I couldn't
establish the proper border at which the auto-condition would be
fulfilled. As it turns out, there's another bug: if an object is at the
tip of any reference we don't mark it as seen. Consequently, if it is
the tip of or reachable via another ref, we'd count that object multiple
times.

Fix both of these bugs so that we properly count objects without leaking
any memory.

Signed-off-by: Patrick Steinhardt <ps@pks.im>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
2026-01-07 09:16:50 +09:00
.github Merge branch 'jk/ci-windows-meson-test-fix' 2025-11-26 10:32:43 -08:00
Documentation The fifth batch 2025-11-30 18:31:41 -08:00
bin-wrappers
block-sha1
builtin builtin/gc: fix condition for whether to write commit graphs 2026-01-07 09:16:50 +09:00
ci Merge branch 'jk/ci-windows-meson-test-fix' 2025-11-26 10:32:43 -08:00
compat Merge branch 'jk/asan-bonanza' 2025-11-30 18:31:41 -08:00
compiler-tricks
contrib Merge branch 'js/wincred-get-credential-alloc-fix' 2025-11-26 10:32:42 -08: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-11-26 09:35:09 -08:00
gitweb
mergetools
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
po l10n: zh_CN: updated translation for 2.52 2025-11-16 17:27:10 +08:00
refs Merge branch 'kn/maintenance-is-needed' 2025-11-21 09:14:17 -08:00
reftable reftable/stack: add function to check if optimization is required 2025-11-10 09:28:47 -08:00
sha1
sha1collisiondetection@855827c583
sha1dc
sha256
src rust: support for Windows 2025-10-15 08:10:17 -07:00
subprojects
t builtin/gc: fix condition for whether to write commit graphs 2026-01-07 09:16:50 +09:00
templates
trace2 trace2: do not use strbuf_split*() 2025-08-02 22:44:58 -07:00
xdiff xdiff: add 'minimal' to XDF_DIFF_ALGORITHM_MASK 2025-11-17 09:31:59 -08:00
.cirrus.yml
.clang-format clang-format: exclude control macros from SpaceBeforeParens 2025-09-28 08:37:23 -07:00
.editorconfig
.gitattributes Merge branch 'jc/whitespace-incomplete-line' 2025-11-30 18:31:40 -08:00
.gitignore Merge branch 'ps/rust-balloon' 2025-10-08 12:17:55 -07:00
.gitlab-ci.yml Merge branch 'ps/gitlab-ci-disable-windows-monitoring' into maint-2.51 2025-10-26 19:48:19 -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 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 Start 2.53 cycle 2025-11-19 10:55:42 -08:00
INSTALL
LGPL-2.1
Makefile Merge branch 'jk/asan-bonanza' 2025-11-30 18:31:41 -08:00
README.md gitk: add README with usage, build, and contribution details 2025-08-28 19:51:31 +02:00
RelNotes Start 2.53 cycle 2025-11-19 10:55:42 -08: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 add-patch: quit on EOF 2025-10-26 16:34:39 -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 apply: check and fix incomplete lines 2025-11-12 14:04:04 -08:00
apply.h
archive-tar.c
archive-zip.c archive: flush deflate stream until Z_STREAM_END 2025-08-04 13:36:35 -07:00
archive.c
archive.h
attr.c attr: avoid recursion when expanding attribute macros 2025-11-12 10:30:04 -08: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
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
branch.c
branch.h
builtin.h Merge branch 'tc/last-modified' 2025-09-08 14:54:35 -07:00
bundle-uri.c
bundle-uri.h
bundle.c
bundle.h
cache-tree.c Merge branch 'jk/asan-bonanza' 2025-11-30 18:31:41 -08:00
cache-tree.h
cbtree.c
cbtree.h
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
check-builtins.sh
checkout.c
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: avoid commit_list_insert_by_date() 2025-10-24 10:13:17 -07:00
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 'dk/parseopt-optional-filename-fixes' 2025-11-06 15:17:01 -08: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
configure.ac
connect.c Merge branch 'jc/string-list-split' 2025-08-21 13:46:59 -07:00
connect.h
connected.c packfile: introduce macro to iterate through packs 2025-10-16 14:42:39 -07:00
connected.h
convert.c
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
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 'jc/whitespace-incomplete-line' 2025-11-30 18:31:40 -08:00
diff.h Merge branch 'jc/whitespace-incomplete-line' 2025-11-30 18:31:40 -08: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 Merge branch 'jk/match-pathname-fix' 2025-11-03 06:49:55 -08:00
dir.h dir: add generic "walk all files" helper 2025-09-12 08:59:52 -07:00
editor.c
editor.h
entry.c
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 Merge branch 'ps/object-source-management' into ps/odb-misc-fixes 2025-12-05 21:23:32 +09:00
fsck.h builtin/index-pack: fix deferred fsck outside repos 2025-11-25 12:15:59 -08: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
generate-cmdlist.sh
generate-configlist.sh
generate-hooklist.sh
generate-perl.sh perl: also mark git-contacts executable 2025-11-06 09:57:47 -08:00
generate-python.sh
generate-script.sh
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
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 Merge branch 'cc/fast-import-export-i18n-cleanup' 2025-11-06 15:17:01 -08:00
gpg-interface.h gpg-interface: use left shift to define GPG_VERIFY_* 2025-10-30 07:06:58 -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
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 Merge branch 'ps/object-source-management' into ps/odb-misc-fixes 2025-12-05 21:23:32 +09:00
http-fetch.c
http-push.c Merge branch 'ps/object-source-management' into ps/odb-misc-fixes 2025-12-05 21:23:32 +09:00
http-walker.c http: refactor subsystem to use `packfile_list`s 2025-10-30 07:09:52 -07:00
http.c http: refactor subsystem to use `packfile_list`s 2025-10-30 07:09:52 -07:00
http.h http: refactor subsystem to use `packfile_list`s 2025-10-30 07:09:52 -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.h
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
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
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 object-file: move loose object map into loose source 2025-11-03 12:18:47 -08:00
loose.h
ls-refs.c refs: expose peeled object ID via the iterator 2025-11-04 07:32:25 -08:00
ls-refs.h
mailinfo.c
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
match-trees.h
mem-pool.c
mem-pool.h
merge-blobs.c
merge-blobs.h
merge-ll.c
merge-ll.h
merge-ort-wrappers.c
merge-ort-wrappers.h
merge-ort.c Merge branch 'ad/blame-diff-algorithm' 2025-11-26 10:32:40 -08:00
merge-ort.h
merge.c
merge.h
mergesort.h
meson.build Merge branch 'jk/asan-bonanza' 2025-11-30 18:31:41 -08:00
meson_options.txt meson: make GIT_HTML_PATH configurable 2025-11-06 09:58:56 -08:00
midx-write.c Merge branch 'ps/object-source-management' into ps/odb-misc-fixes 2025-12-05 21:23:32 +09:00
midx.c packfile: always add packfiles to MRU when adding a pack 2025-10-30 07:09:53 -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.h
notes-cache.c
notes-cache.h
notes-merge.c
notes-merge.h
notes-utils.c
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/object-source-loose' 2025-11-24 15:46:41 -08:00
object-file.h object-file: refactor writing objects via a stream 2025-11-03 12:18:48 -08:00
object-name.c Merge branch 'ps/object-source-loose' 2025-11-24 15:46:41 -08:00
object-name.h
object.c object: fix performance regression when peeling tags 2025-11-06 10:54:34 -08:00
object.h Merge branch 'kn/maintenance-is-needed' 2025-11-21 09:14:17 -08:00
odb.c odb: handle recreation of quarantine directories 2025-11-25 12:16:00 -08:00
odb.h odb: handle changing a repository's commondir 2025-11-25 12:16:00 -08:00
oid-array.c
oid-array.h
oidmap.c
oidmap.h
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.h
pack-bitmap-write.c
pack-bitmap.c Merge branch 'jk/asan-bonanza' 2025-11-30 18:31:41 -08:00
pack-bitmap.h
pack-check.c
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 midx: compute paths via their source 2025-08-11 09:22:23 -07:00
pack-revindex.h
pack-write.c
pack.h
packfile.c Merge branch 'ps/object-source-management' into ps/odb-misc-fixes 2025-12-05 21:23:32 +09:00
packfile.h Merge branch 'ps/object-source-management' into ps/odb-misc-fixes 2025-12-05 21:23:32 +09:00
pager.c
pager.h
parallel-checkout.c
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 'dk/parseopt-optional-filename-fixes' 2025-11-06 15:17:01 -08: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.c path: move `enter_repo()` into "setup.c" 2025-11-19 17:41:03 -08:00
path.h path: move `enter_repo()` into "setup.c" 2025-11-19 17:41:03 -08:00
pathspec.c string-list: split-then-remove-empty can be done while splitting 2025-08-02 22:34:45 -07:00
pathspec.h
pkt-line.c
pkt-line.h
preload-index.c
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.h
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
protocol-caps.h
protocol.c Merge branch 'jc/string-list-split' 2025-08-21 13:46:59 -07:00
protocol.h
prune-packed.c
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 'bc/submodule-force-same-hash' 2025-11-24 15:46:40 -08:00
read-cache.h
rebase-interactive.c
rebase-interactive.h
rebase.c
rebase.h
ref-filter.c object: fix performance regression when peeling tags 2025-11-06 10:54:34 -08:00
ref-filter.h Merge branch 'jt/repo-structure' 2025-11-04 07:48:07 -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 Merge branch 'ps/object-source-management' into ps/odb-misc-fixes 2025-12-05 21:23:32 +09:00
refs.h refs: add a `optimize_required` field to `struct ref_storage_be` 2025-11-10 09:28:48 -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
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 packfile: introduce macro to iterate through packs 2025-10-16 14:42:39 -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 packfile: introduce macro to iterate through packs 2025-10-16 14:42:39 -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
repo-settings.c
repo-settings.h
repository.c odb: handle changing a repository's commondir 2025-11-25 12:16:00 -08:00
repository.h odb: handle changing a repository's commondir 2025-11-25 12:16:00 -08:00
rerere.c
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 odb: adopt logic to close object databases 2025-11-19 17:41:03 -08:00
run-command.h
sane-ctype.h
scalar.c odb: adopt logic to close object databases 2025-11-19 17:41:03 -08:00
send-pack.c
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
serve.h
server-info.c Merge branch 'ps/ref-peeled-tags' 2025-11-19 10:55:39 -08:00
server-info.h
setup.c odb: handle recreation of quarantine directories 2025-11-25 12:16:00 -08:00
setup.h setup: convert `set_git_dir()` to have file scope 2025-11-19 17:41:03 -08: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: improve advice message instructions 2025-10-20 09:20:50 -07:00
sparse-index.h
split-index.c
split-index.h
stable-qsort.c
statinfo.c
statinfo.h
strbuf.c
strbuf.h
streaming.c object-file: read objects via the loose object source 2025-11-03 12:18:47 -08: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
submodule-config.c
submodule-config.h
submodule.c refs: introduce wrapper struct for `each_ref_fn` 2025-11-04 07:32:24 -08:00
submodule.h
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.h
tmp-objdir.c
tmp-objdir.h
trace.c
trace.h
trace2.c
trace2.h
trailer.c
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
tree-walk.h
tree.c
tree.h
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
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.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
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 Merge branch 'rs/xmkstemp-simplify' 2025-11-26 10:32:40 -08: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 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 'jk/status-z-short-fix' 2025-10-24 13:48:04 -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
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