Go to file
Ramsay Jones 59da9f292a t0610-reftable-basics: mitigate a flaky test on cygwin
Test #29 ('ref transaction: corrupted tables cause failure') started to
fail intermittently for me (from v2.52.0-rc0) when running the testsuite
with '-j8'. (Also, having moved to a new laptop and windows 11, rather
than windows 10). If the test is run by hand, or without any parallelism,
then it passes without issue.

When the test fails (e.g. 1 out of 32 parallel runs) the cause is due to
a permission error while corrupting a table file:

  ./test-lib.sh: line 1010: .git/reftable/0x000000000001-0x000000000002-d89bb8ee.ref: Permission denied

This corruption is done in a shell loop, directly after a 'test_commit',
which uses an ': >"$f"' expression to truncate the file. Adding a sleep
of one second after the 'test_commit' and before the shell loop fixes
the test (it is not clear why). Replacing the redirection shell expression
with a 'test-tool truncate "$f" 0' invocation also provides a fix, which
could simply be another way to change the timing sufficiently to win the
race.

During a debug session, I tried looking at the strace output for the
shell redirection:

  $ rm /tmp/hello; echo hello >/tmp/hello; ls -l /tmp/hello
  -rw-r--r-- 1 ramsay None 6 Nov 10 17:25 /tmp/hello
  $

  $ strace -o zzz bash -c ': >/tmp/hello'
  $

Similarly, for the test-tool solution:

  $ strace -o xxx ./t/helper/test-tool truncate /tmp/hello 0
  $

When comparing the output, the differences seemed to be what you would
expect and, if anything, the shell redirect probably would have taken
longer than the test-tool solution (many fcntl() calls to dup the stdout
to the <fd>).  The call to the win32 api NtCreateFile() was identical,
apart from the first (FileHandle) parameter, of course.

In order to fix this flaky test on cygwin, despite not knowing why it
works, replace the shell redirection with the above 'test-tool truncate'
invocation.

Helped-by: Patrick Steinhardt <ps@pks.im>
Signed-off-by: Ramsay Jones <ramsay@ramsayjones.plus.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
2026-01-16 14:01:42 -08:00
.github Merge branch 'js/ci-show-breakage-in-dockerized-jobs' 2025-12-05 14:49:58 +09:00
Documentation The 14th batch 2025-12-30 12:58:22 +09:00
bin-wrappers
…
block-sha1
…
builtin Merge branch 'jt/repo-struct-more-objinfo' 2025-12-30 12:58:19 +09: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 Merge branch 'gf/maintenance-is-needed-fix' 2025-12-30 12:58:20 +09: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 t0610-reftable-basics: mitigate a flaky test on cygwin 2026-01-16 14:01:42 -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
…
.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
…
.tsan-suppressions
…
CODE_OF_CONDUCT.md
…
COPYING
…
Cargo.toml
…
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 'jc/memzero-array' 2025-12-23 11:33:16 +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
…
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.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 refs: expose peeled object ID via the iterator 2025-11-04 07:32:25 -08:00
commit-graph.h
…
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 commit: refactor verify_commit_buffer() 2025-11-16 20:56:35 -08:00
commit.h commit: refactor verify_commit_buffer() 2025-11-16 20:56:35 -08:00
common-exit.c
…
common-init.c
…
common-init.h
…
common-main.c
…
config.c Merge branch 'jc/optional-path' 2025-12-05 14:49:56 +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
…
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 Merge branch 'rs/diff-index-find-copies-harder-optim' 2025-12-14 17:04:36 +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 Merge branch 'ps/object-source-management' 2025-12-05 14:49:58 +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
…
hook.h
…
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
…
ident.h
…
imap-send.c
…
iterator.h
…
json-writer.c
…
json-writer.h
…
khash.h
…
kwset.c
…
kwset.h
…
levenshtein.c
…
levenshtein.h
…
line-log.c
…
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 '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 '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 'ps/repack-avoid-noop-midx-rewrite' 2025-12-30 12:58:19 +09: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 Merge branch 'ps/object-source-loose' 2025-11-24 15:46:41 -08: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.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 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
…
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 Merge branch 'ps/object-source-management' 2025-12-05 14:49:58 +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
…
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 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 refs: introduce wrapper struct for `each_ref_fn` 2025-11-04 07:32:24 -08:00
revision.h
…
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 Merge branch 'ds/doc-scalar-config' 2025-12-23 11:33:15 +09:00
send-pack.c
…
send-pack.h
…
sequencer.c
…
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 Merge branch 'jc/memzero-array' 2025-12-23 11:33:16 +09:00
shallow.h
…
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 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
…
transport-internal.h
…
transport.c
…
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 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/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