Go to file
Karthik Nayak eff9299eac fetch: delay user information post committing of transaction
In Git 2.50 and earlier, we would display failure codes and error
message as part of the status display:

  $ git fetch . v1.0.0:refs/heads/foo
    error: cannot update ref 'refs/heads/foo': trying to write non-commit object f665776185 to branch 'refs/heads/foo'
    From .
     ! [new tag]               v1.0.0     -> foo  (unable to update local ref)

With the addition of batched updates, this information is no longer
shown to the user:

  $ git fetch . v1.0.0:refs/heads/foo
    From .
     * [new tag]               v1.0.0     -> foo
    error: cannot update ref 'refs/heads/foo': trying to write non-commit object f665776185 to branch 'refs/heads/foo'

Since reference updates are batched and processed together at the end,
information around the outcome is not available during individual
reference parsing.

To overcome this, collate and delay the output to the end. Introduce
`ref_update_display_info` which will hold individual update's
information and also whether the update failed or succeeded. This
finally allows us to iterate over all such updates and print them to the
user.

Using an dynamic array and strmap does add some overhead to
'git-fetch(1)', but from benchmarking this seems to be not too bad:

  Benchmark 1: fetch: many refs (refformat = files, refcount = 1000, revision = master)
    Time (mean ± σ):      42.6 ms ±   1.2 ms    [User: 13.1 ms, System: 29.8 ms]
    Range (min … max):    40.1 ms …  45.8 ms    47 runs

  Benchmark 2: fetch: many refs (refformat = files, refcount = 1000, revision = HEAD)
    Time (mean ± σ):      43.1 ms ±   1.2 ms    [User: 12.7 ms, System: 30.7 ms]
    Range (min … max):    40.5 ms …  45.8 ms    48 runs

  Summary
    fetch: many refs (refformat = files, refcount = 1000, revision = master) ran
      1.01 ± 0.04 times faster than fetch: many refs (refformat = files, refcount = 1000, revision = HEAD)

Another approach would be to move the status printing logic to be
handled post the transaction being committed. That however would require
adding an iterator to the ref transaction that tracks both the outcome
(success/failure) and the original refspec information for each update,
which is more involved infrastructure work compared to the strmap
approach here.

Helped-by: Phillip Wood <phillip.wood123@gmail.com>
Reported-by: Jeff King <peff@peff.net>
Signed-off-by: Karthik Nayak <karthik.188@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
2026-01-25 22:27:34 -08:00
.github Merge branch 'js/ci-show-breakage-in-dockerized-jobs' 2025-12-05 14:49:58 +09:00
Documentation The 17th batch 2026-01-12 05:19:53 -08:00
bin-wrappers
…
block-sha1
…
builtin fetch: delay user information post committing of transaction 2026-01-25 22:27:34 -08:00
ci Merge branch 'jk/ci-windows-meson-test-fix' 2025-11-26 10:32:43 -08:00
compat Merge branch 'js/test-symlink-windows' 2025-12-30 12:58:19 +09:00
compiler-tricks
…
contrib Merge branch 'tc/memzero-array' 2025-12-23 11:33:16 +09:00
ewah git-compat-util: introduce MEMZERO_ARRAY() macro 2025-12-11 14:44:43 +09:00
git-gui
…
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
odb streaming: drop redundant type and size pointers 2025-11-23 12:56:46 -08:00
oss-fuzz
…
perl
…
po l10n: zh_CN: updated translation for 2.52 2025-11-16 17:27:10 +08:00
refs refs: skip to next ref when current ref is rejected 2026-01-25 22:27:33 -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: build correctly without GNU sed 2025-12-19 17:57:26 +09:00
subprojects meson: ignore subprojects/.wraplock 2025-12-05 11:11:00 +09:00
t fetch: delay user information post committing of transaction 2026-01-25 22:27:34 -08:00
templates
…
trace2
…
xdiff Merge branch 'yc/xdiff-patience-optim' 2025-12-09 07:54:55 +09:00
.cirrus.yml
…
.clang-format
…
.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: replace Karsten Blees' default address 2026-01-10 09:32:51 -08: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 'rs/macos-iconv-workaround' 2026-01-06 16:33:52 +09:00
README.md
…
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-patch.c add-patch: quit on EOF 2025-10-26 16:34:39 -07:00
advice.c
…
advice.h
…
alias.c
…
alias.h
…
alloc.c
…
alloc.h
…
apply.c Merge branch 'js/test-symlink-windows' 2025-12-30 12:58:19 +09:00
apply.h
…
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
…
archive.h
…
attr.c attr: avoid recursion when expanding attribute macros 2025-11-12 10:30:04 -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 refs: introduce wrapper struct for `each_ref_fn` 2025-11-04 07:32:24 -08:00
bisect.h
…
blame.c
…
blame.h
…
blob.c
…
blob.h
…
bloom.c
…
bloom.h
…
branch.c branch: advice using git-help(1) instead of man(1) 2025-12-03 00:16:05 -08:00
branch.h
…
builtin.h
…
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 '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.h
…
column.c
…
column.h
…
combine-diff.c
…
command-list.txt
…
commit-graph.c commit-graph: use commit_stack 2025-12-25 08:29:29 +09:00
commit-graph.h
…
commit-reach.c commit-reach: use commit_stack 2025-12-25 08:29:29 +09:00
commit-reach.h
…
commit-slab-decl.h
…
commit-slab-impl.h
…
commit-slab.h
…
commit.c Merge branch 'rs/commit-stack' 2026-01-12 05:19:52 -08:00
commit.h commit: add commit_stack_grow() 2025-12-25 08:29:28 +09:00
common-exit.c
…
common-init.c
…
common-init.h
…
common-main.c
…
config.c Merge branch 'rs/parse-config-expiry-simplify' 2026-01-06 16:33:53 +09:00
config.h config: mark otherwise unused function as file-scope static 2025-11-20 15:03:40 -08:00
config.mak.dev
…
config.mak.in
…
config.mak.uname macOS: use iconv from Homebrew if needed and present 2025-12-25 16:43:10 +09:00
configure.ac
…
connect.c connect: plug protocol capability leak 2025-12-09 07:11:42 +09: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
…
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 git-compat-util: introduce MEMZERO_ARRAY() macro 2025-12-11 14:44:43 +09:00
diff-lib.c diff-files: fix copy detection 2025-12-16 10:23:26 +09:00
diff-merges.c
…
diff-merges.h
…
diff-no-index.c
…
diff.c diff: avoid segfault with freed entries 2025-12-30 10:53:47 +09:00
diff.h Merge branch 'rs/diff-index-find-copies-harder-optim' 2025-12-14 17:04:36 +09:00
diffcore-break.c
…
diffcore-delta.c cocci: use MEMZERO_ARRAY() a bit more 2025-12-13 10:47:59 +09:00
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
…
editor.c
…
editor.h
…
entry.c streaming: move into object database subsystem 2025-11-23 12:56:46 -08:00
entry.h
…
environment.c
…
environment.h
…
exec-cmd.c
…
exec-cmd.h
…
fetch-negotiator.c
…
fetch-negotiator.h
…
fetch-pack.c Merge branch 'jc/optional-path' 2025-12-05 14:49:56 +09:00
fetch-pack.h
…
fmt-merge-msg.c
…
fmt-merge-msg.h
…
for-each-ref.h
…
fsck.c tag: support arbitrary repositories in parse_tag() 2025-12-29 22:02:54 +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 Merge branch 'jc/c99-fam' 2025-12-28 17:36:16 +09:00
git-curl-compat.h
…
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
…
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
…
git.rc.in
…
gpg-interface.c Merge branch 'cc/fast-import-strip-if-invalid' 2025-12-05 14:49:58 +09:00
gpg-interface.h Merge branch 'cc/fast-import-strip-if-invalid' 2025-12-05 14:49:58 +09:00
graph.c
…
graph.h
…
grep.c
…
grep.h
…
hash-lookup.c
…
hash-lookup.h
…
hash.c
…
hash.h
…
hashmap.c git-compat-util: introduce MEMZERO_ARRAY() macro 2025-12-11 14:44:43 +09:00
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 hooks: allow callers to capture output 2025-12-28 14:02:07 +09:00
hook.h hooks: allow callers to capture output 2025-12-28 14:02:07 +09:00
http-backend.c Merge branch 'ps/object-source-management' 2025-12-05 14:49:58 +09:00
http-fetch.c
…
http-push.c Merge branch 'ps/object-source-management' 2025-12-05 14:49:58 +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
…
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 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.h
…
list-objects-filter.c
…
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
…
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
…
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 'en/ort-recursive-d-f-conflict-fix' 2026-01-08 16:40:12 +09:00
merge-ort.h
…
merge.c
…
merge.h
…
mergesort.h
…
meson.build Merge branch 'rs/ban-mktemp' 2025-12-16 11:08:35 +09:00
meson_options.txt meson: make GIT_HTML_PATH configurable 2025-11-06 09:58:56 -08:00
midx-write.c Merge branch 'rs/commit-stack' 2026-01-12 05:19:52 -08:00
midx.c Merge branch 'ps/repack-avoid-noop-midx-rewrite' 2025-12-30 12:58:19 +09:00
midx.h
…
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 'jc/object-read-stream-fix' 2025-12-30 12:58:22 +09:00
object-file.h streaming: move logic to read loose objects streams into backend 2025-11-23 12:56:45 -08:00
object-name.c tag: support arbitrary repositories in parse_tag() 2025-12-29 22:02:54 +09:00
object-name.h
…
object.c object: apply skip_hash and discard_tree optimizations to unknown blobs too 2025-12-09 18:12:24 +09:00
object.h Merge branch 'kn/maintenance-is-needed' 2025-11-21 09:14:17 -08:00
odb.c Merge branch 'jc/object-read-stream-fix' 2025-12-30 12:58:22 +09: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-write: use commit_stack 2025-12-25 08:29:28 +09:00
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
…
pack-revindex.c git-compat-util: introduce MEMZERO_ARRAY() macro 2025-12-11 14:44:43 +09: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
…
packfile.c Merge branch 'jc/object-read-stream-fix' 2025-12-30 12:58:22 +09:00
packfile.h Merge branch 'ps/object-read-stream' 2025-12-16 11:08:34 +09:00
pager.c
…
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
…
parse-options.c Merge branch 'dk/parseopt-optional-filename-fixes' 2025-11-06 15:17:01 -08:00
parse-options.h
…
parse.c
…
parse.h
…
patch-delta.c
…
patch-ids.c
…
patch-ids.h
…
path-walk.c
…
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
…
pathspec.h
…
pkt-line.c
…
pkt-line.h
…
preload-index.c
…
preload-index.h
…
pretty.c
…
pretty.h
…
prio-queue.c
…
prio-queue.h
…
progress.c
…
progress.h
…
promisor-remote.c
…
promisor-remote.h
…
prompt.c
…
prompt.h
…
protocol-caps.c
…
protocol-caps.h
…
protocol.c
…
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.h
…
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 tag: support arbitrary repositories in parse_tag() 2025-12-29 22:02:54 +09:00
ref-filter.h Merge branch 'jt/repo-structure' 2025-11-04 07:48:07 -08:00
reflog-walk.c
…
reflog-walk.h
…
reflog.c refs: introduce wrapper struct for `each_ref_fn` 2025-11-04 07:32:24 -08:00
reflog.h
…
refs.c refs: add rejection detail to the callback function 2026-01-25 22:27:33 -08:00
refs.h refs: add rejection detail to the callback function 2026-01-25 22:27:33 -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 remote: use commit_stack for src_commits 2025-12-25 08:29:28 +09: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 Merge branch 'gf/clear-path-cache-cleanup' 2025-12-30 12:58:21 +09: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 revision: export commit_stack 2025-12-25 08:29:27 +09:00
revision.h Merge branch 'kh/format-patch-range-diff-notes' 2025-10-14 12:56:09 -07:00
run-command.c Merge branch 'ar/run-command-hook' 2026-01-06 16:33:53 +09:00
run-command.h run-command: allow capturing of collated output 2025-12-28 14:02:07 +09:00
sane-ctype.h
…
scalar.c Merge branch 'ds/doc-scalar-config' 2025-12-23 11:33:15 +09:00
send-pack.c
…
send-pack.h
…
sequencer.c hook: convert 'post-rewrite' hook in sequencer.c to hook API 2025-12-28 14:02:06 +09:00
sequencer.h
…
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 Merge branch 'ps/object-source-management' 2025-12-05 14:49:58 +09: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 shallow: use commit_stack 2025-12-25 08:29:28 +09:00
shallow.h shallow: use commit_stack 2025-12-25 08:29:28 +09:00
shared.mak
…
shell.c
…
shortlog.h
…
sideband.c
…
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 builtin/repo: add inflated object info to structure table 2025-12-18 09:02:31 +09:00
strbuf.h builtin/repo: add inflated object info to structure table 2025-12-18 09:02:31 +09:00
string-list.c
…
string-list.h
…
strmap.c
…
strmap.h
…
strvec.c
…
strvec.h
…
sub-process.c
…
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 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
…
tmp-objdir.h
…
trace.c
…
trace.h
…
trace2.c
…
trace2.h
…
trailer.c
…
trailer.h
…
transport-helper.c
…
transport-internal.h
…
transport.c transport: convert pre-push to hook API 2025-12-28 14:02:06 +09:00
transport.h
…
tree-diff.c
…
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
…
userdiff.c
…
userdiff.h
…
utf8.c
…
utf8.h
…
varint.c
…
varint.h
…
version-def.h.in
…
version.c
…
version.h
…
versioncmp.c
…
versioncmp.h
…
walker.c tag: support arbitrary repositories in parse_tag() 2025-12-29 22:02:54 +09: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/ban-mktemp' 2025-12-16 11:08:35 +09:00
wrapper.h wrapper: add git_mkdtemp() 2025-12-07 07:28:11 +09: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
…
xdiff-interface.c xdiff: use unambiguous types in xdl_hash_record() 2025-11-18 14:53:10 -08:00
xdiff-interface.h
…

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