Go to file

Patrick Steinhardt e04838ea82 commit-graph: introduce envvar to disable commit existence checks Our `lookup_commit_in_graph()` helper tries to look up commits from the commit graph and, if it doesn't exist there, falls back to parsing it from the object database instead. This is intended to speed up the lookup of any such commit that exists in the database. There is an edge case though where the commit exists in the graph, but not in the object database. To avoid returning such stale commits the helper function thus double checks that any such commit parsed from the graph also exists in the object database. This makes the function safe to use even when commit graphs aren't updated regularly. We're about to introduce the same pattern into other parts of our code base though, namely `repo_parse_commit_internal()`. Here the extra sanity check is a bit of a tougher sell: `lookup_commit_in_graph()` was a newly introduced helper, and as such there was no performance hit by adding this sanity check. If we added `repo_parse_commit_internal()` with that sanity check right from the beginning as well, this would probably never have been an issue to begin with. But by retrofitting it with this sanity check now we do add a performance regression to preexisting code, and thus there is a desire to avoid this or at least give an escape hatch. In practice, there is no inherent reason why either of those functions should have the sanity check whereas the other one does not: either both of them are able to detect this issue or none of them should be. This also means that the default of whether we do the check should likely be the same for both. To err on the side of caution, we thus rather want to make `repo_parse_commit_internal()` stricter than to loosen the checks that we already have in `lookup_commit_in_graph()`. The escape hatch is added in the form of a new GIT_COMMIT_GRAPH_PARANOIA environment variable that mirrors GIT_REF_PARANOIA. If enabled, which is the default, we will double check that commits looked up in the commit graph via `lookup_commit_in_graph()` also exist in the object database. This same check will also be added in `repo_parse_commit_internal()`. Signed-off-by: Patrick Steinhardt <ps@pks.im> Signed-off-by: Junio C Hamano <gitster@pobox.com>		2023-11-01 12:04:06 +09:00
.github	ci: drop linux-clang job	2023-06-03 10:35:13 +09:00
Documentation	commit-graph: introduce envvar to disable commit existence checks	2023-11-01 12:04:06 +09:00
block-sha1	…
builtin	fsck: use enum object_type for fsck_walk callback	2023-08-19 21:17:32 -07:00
ci	Merge branch 'tb/pack-bitmap-traversal-with-boundary'	2023-06-22 16:29:05 -07:00
compat	Merge branch 'ds/maintenance-on-windows-fix'	2023-08-15 10:19:47 -07:00
contrib	Merge branch 'ds/maintenance-on-windows-fix'	2023-08-15 10:19:47 -07:00
ewah	git-compat-util: move alloc macros to git-compat-util.h	2023-07-05 11:42:31 -07:00
git-gui	…
gitk-git	…
gitweb	…
mergetools	…
negotiator	…
oss-fuzz	object-store-ll.h: split this header out of object-store.h	2023-06-21 13:39:54 -07:00
perl	…
po	Merge branch 'po-id' of github.com:bagasme/git-po	2023-08-21 07:05:38 +08:00
refs	Merge branch 'tb/refs-exclusion-and-packed-refs'	2023-07-21 13:47:26 -07:00
reftable	…
sha1	avoid SHA-1 functions deprecated in OpenSSL 3+	2023-08-01 08:34:56 -07:00
sha1collisiondetection@855827c583	…
sha1dc	…
sha256	Merge branch 'ew/hash-with-openssl-evp'	2023-08-09 16:18:15 -07:00
t	commit-graph: introduce envvar to disable commit existence checks	2023-11-01 12:04:06 +09:00
templates	…
trace2	Merge branch 'bb/use-trace2-counters-for-fsync-stats'	2023-08-02 09:37:23 -07:00
xdiff	…
.cirrus.yml	…
.clang-format	…
.editorconfig	…
.gitattributes	…
.gitignore	gitignore: ignore clangd .cache directory	2023-08-04 10:56:51 -07:00
.gitmodules	…
.mailmap	mailmap: change primary address for Glen Choo	2023-08-07 11:58:17 -07:00
.tsan-suppressions	…
CODE_OF_CONDUCT.md	…
COPYING	…
GIT-VERSION-GEN	Git 2.42	2023-08-21 09:34:58 -07:00
INSTALL	…
LGPL-2.1	…
Makefile	Merge branch 'ds/maintenance-on-windows-fix'	2023-08-15 10:19:47 -07:00
README.md	…
RelNotes	Start the 2.42 cycle	2023-06-13 12:29:46 -07:00
SECURITY.md	…
abspath.c	abspath: move related functions to abspath	2023-06-12 13:49:35 -07:00
abspath.h	abspath: move related functions to abspath	2023-06-12 13:49:35 -07:00
aclocal.m4	…
add-interactive.c	diff.h: remove unnecessary include of oidset.h	2023-06-21 13:39:53 -07:00
add-interactive.h	…
add-patch.c	Merge branch 'cw/compat-util-header-cleanup'	2023-07-17 11:30:42 -07:00
advice.c	advice: handle "rebase" in error_resolve_conflict()	2023-08-07 13:21:00 -07:00
advice.h	…
alias.c	Merge branch 'cw/compat-util-header-cleanup'	2023-07-17 11:30:42 -07:00
alias.h	…
alloc.c	…
alloc.h	git-compat-util: move alloc macros to git-compat-util.h	2023-07-05 11:42:31 -07:00
apply.c	Merge branch 'cw/compat-util-header-cleanup'	2023-07-17 11:30:42 -07:00
apply.h	…
archive-tar.c	Merge branch 'cw/compat-util-header-cleanup'	2023-07-17 11:30:42 -07:00
archive-zip.c	Merge branch 'gc/config-context'	2023-07-06 11:54:48 -07:00
archive.c	git-compat-util: move alloc macros to git-compat-util.h	2023-07-05 11:42:31 -07:00
archive.h	…
attr.c	Merge branch 'cw/compat-util-header-cleanup'	2023-07-17 11:30:42 -07:00
attr.h	attr: expose and rename accessor functions	2023-06-27 11:31:06 -07:00
banned.h	…
base85.c	…
base85.h	…
bisect.c	object-store-ll.h: split this header out of object-store.h	2023-06-21 13:39:54 -07:00
bisect.h	…
blame.c	blame: allow --contents to work with bare repo	2023-07-21 07:32:58 -07:00
blame.h	diff.h: remove unnecessary include of oidset.h	2023-06-21 13:39:53 -07:00
blob.c	…
blob.h	…
bloom.c	…
bloom.h	…
branch.c	branch: update the message to refuse touching a branch in-use	2023-07-21 15:30:57 -07:00
branch.h	…
builtin.h	builtin.h: remove unneccessary includes	2023-06-21 13:39:54 -07:00
bulk-checkin.c	git-compat-util: move alloc macros to git-compat-util.h	2023-07-05 11:42:31 -07:00
bulk-checkin.h	…
bundle-uri.c	Merge branch 'gc/config-context'	2023-07-06 11:54:48 -07:00
bundle-uri.h	…
bundle.c	Merge branch 'dk/bundle-i18n-more'	2023-07-25 12:05:24 -07:00
bundle.h	…
cache-tree.c	git-compat-util: move alloc macros to git-compat-util.h	2023-07-05 11:42:31 -07:00
cache-tree.h	…
cbtree.c	…
cbtree.h	…
chdir-notify.c	…
chdir-notify.h	…
check-builtins.sh	…
checkout.c	…
checkout.h	…
chunk-format.c	git-compat-util: move alloc macros to git-compat-util.h	2023-07-05 11:42:31 -07:00
chunk-format.h	…
color.c	config: inline git_color_default_config	2023-06-28 14:06:38 -07:00
color.h	config: inline git_color_default_config	2023-06-28 14:06:38 -07:00
column.c	…
column.h	…
combine-diff.c	treewide: remove unnecessary includes for wrapper.h	2023-07-05 11:41:59 -07:00
command-list.txt	…
commit-graph.c	commit-graph: introduce envvar to disable commit existence checks	2023-11-01 12:04:06 +09:00
commit-graph.h	commit-graph: introduce envvar to disable commit existence checks	2023-11-01 12:04:06 +09:00
commit-reach.c	git-compat-util: move alloc macros to git-compat-util.h	2023-07-05 11:42:31 -07:00
commit-reach.h	…
commit-slab-decl.h	…
commit-slab-impl.h	…
commit-slab.h	…
commit.c	Merge branch 'rs/pack-objects-parseopt-fix'	2023-07-28 09:45:22 -07:00
commit.h	…
common-main.c	…
config.c	Merge branch 'cw/compat-util-header-cleanup'	2023-07-17 11:30:42 -07:00
config.h	config: pass source to config_parser_event_fn_t	2023-06-28 14:06:40 -07:00
config.mak.dev	…
config.mak.in	…
config.mak.uname	win32: add a helper to run `git.exe` without a foreground window	2023-08-09 13:58:13 -07:00
configure.ac	configure.ac: always save NO_ICONV to config.status	2023-07-19 10:07:55 -07:00
connect.c	Merge branch 'gc/config-context'	2023-07-06 11:54:48 -07:00
connect.h	…
connected.c	object-store-ll.h: split this header out of object-store.h	2023-06-21 13:39:54 -07:00
connected.h	…
convert.c	Merge branch 'cw/compat-util-header-cleanup'	2023-07-17 11:30:42 -07:00
convert.h	…
copy.c	treewide: remove unnecessary includes for wrapper.h	2023-07-05 11:41:59 -07:00
copy.h	…
credential.c	config: add ctx arg to config_fn_t	2023-06-28 14:06:39 -07:00
credential.h	credential: avoid erasing distinct password	2023-06-15 13:26:39 -07:00
csum-file.c	treewide: remove unnecessary includes for wrapper.h	2023-07-05 11:41:59 -07:00
csum-file.h	…
ctype.c	kwset: move translation table from ctype	2023-07-05 11:41:18 -07:00
daemon.c	Merge branch 'cw/compat-util-header-cleanup'	2023-07-17 11:30:42 -07:00
date.c	…
date.h	…
decorate.c	hash-ll, hashmap: move oidhash() to hash-ll	2023-06-21 13:39:54 -07:00
decorate.h	…
delta-islands.c	Merge branch 'cw/compat-util-header-cleanup'	2023-07-17 11:30:42 -07:00
delta-islands.h	…
delta.h	…
detect-compiler	…
diagnose.c	object-store-ll.h: split this header out of object-store.h	2023-06-21 13:39:54 -07:00
diagnose.h	…
diff-delta.c	…
diff-lib.c	Merge branch 'en/header-split-cache-h-part-3'	2023-06-29 16:43:21 -07:00
diff-merges.c	…
diff-merges.h	…
diff-no-index.c	diff --no-index: support reading from named pipes	2023-07-05 14:00:28 -07:00
diff.c	Merge branch 'cw/compat-util-header-cleanup'	2023-07-17 11:30:42 -07:00
diff.h	Merge branch 'gc/config-context'	2023-07-06 11:54:48 -07:00
diffcore-break.c	diff.h: remove unnecessary include of oidset.h	2023-06-21 13:39:53 -07:00
diffcore-delta.c	…
diffcore-order.c	git-compat-util.h: remove unneccessary include of wildmatch.h	2023-06-21 13:39:54 -07:00
diffcore-pickaxe.c	diff.h: remove unnecessary include of oidset.h	2023-06-21 13:39:53 -07:00
diffcore-rename.c	git-compat-util: move alloc macros to git-compat-util.h	2023-07-05 11:42:31 -07:00
diffcore-rotate.c	…
diffcore.h	…
dir-iterator.c	git-compat-util: move alloc macros to git-compat-util.h	2023-07-05 11:42:31 -07:00
dir-iterator.h	…
dir.c	Merge branch 'jc/pathspec-match-with-common-prefix'	2023-07-17 11:30:43 -07:00
dir.h	Merge branch 'cw/strbuf-cleanup'	2023-07-06 11:54:46 -07:00
editor.c	treewide: remove unnecessary includes for wrapper.h	2023-07-05 11:41:59 -07:00
editor.h	…
entry.c	treewide: remove unnecessary includes for wrapper.h	2023-07-05 11:41:59 -07:00
entry.h	…
environment.c	Merge branch 'rs/pack-objects-parseopt-fix'	2023-07-28 09:45:22 -07:00
environment.h	Merge branch 'rs/pack-objects-parseopt-fix'	2023-07-28 09:45:22 -07:00
exec-cmd.c	run-command.h: move declarations for run-command.c from cache.h	2023-06-21 13:39:53 -07:00
exec-cmd.h	…
fetch-negotiator.c	…
fetch-negotiator.h	…
fetch-pack.c	Merge branch 'cw/compat-util-header-cleanup'	2023-07-17 11:30:42 -07:00
fetch-pack.h	…
fmt-merge-msg.c	Merge branch 'cw/compat-util-header-cleanup'	2023-07-17 11:30:42 -07:00
fmt-merge-msg.h	config: add ctx arg to config_fn_t	2023-06-28 14:06:39 -07:00
fsck.c	Merge branch 'jk/unused-parameter'	2023-07-25 12:05:24 -07:00
fsck.h	config: add ctx arg to config_fn_t	2023-06-28 14:06:39 -07:00
fsmonitor--daemon.h	…
fsmonitor-ipc.c	fsmonitor-ll.h: split this header out of fsmonitor.h	2023-06-21 13:39:54 -07:00
fsmonitor-ipc.h	…
fsmonitor-ll.h	fsmonitor-ll.h: split this header out of fsmonitor.h	2023-06-21 13:39:54 -07:00
fsmonitor-path-utils.h	…
fsmonitor-settings.c	…
fsmonitor-settings.h	…
fsmonitor.c	cache.h: remove this no-longer-used header	2023-06-21 13:39:53 -07:00
fsmonitor.h	fsmonitor-ll.h: split this header out of fsmonitor.h	2023-06-21 13:39:54 -07:00
generate-cmdlist.sh	…
generate-configlist.sh	…
generate-hooklist.sh	…
gettext.c	…
gettext.h	…
git-archimport.perl	…
git-compat-util.h	Merge branch 'cw/compat-util-header-cleanup'	2023-07-17 11:30:42 -07: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	send-email: avoid creating more than one Term::ReadLine object	2023-08-08 16:48:17 -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 'en/header-split-cache-h-part-3'	2023-06-29 16:43:21 -07:00
git.rc	…
gpg-interface.c	Merge branch 'cw/compat-util-header-cleanup'	2023-07-17 11:30:42 -07:00
gpg-interface.h	…
graph.c	…
graph.h	…
grep.c	Merge branch 'cw/compat-util-header-cleanup'	2023-07-17 11:30:42 -07:00
grep.h	config: add ctx arg to config_fn_t	2023-06-28 14:06:39 -07:00
hash-ll.h	Merge branch 'ew/hash-with-openssl-evp'	2023-08-09 16:18:15 -07:00
hash-lookup.c	cache.h: remove this no-longer-used header	2023-06-21 13:39:53 -07:00
hash-lookup.h	…
hash.h	…
hashmap.c	…
hashmap.h	hash-ll, hashmap: move oidhash() to hash-ll	2023-06-21 13:39:54 -07:00
help.c	Merge branch 'cw/compat-util-header-cleanup'	2023-07-17 11:30:42 -07:00
help.h	…
hex.c	hex: retire get_sha1_hex()	2023-07-24 16:11:23 -07:00
hex.h	hex: retire get_sha1_hex()	2023-07-24 16:11:23 -07:00
hook.c	abspath: move related functions to abspath	2023-06-12 13:49:35 -07:00
hook.h	…
http-backend.c	Merge branch 'tb/refs-exclusion-and-packed-refs'	2023-07-21 13:47:26 -07:00
http-fetch.c	…
http-push.c	http-push: mark unused parameter in xml callback	2023-07-13 17:23:59 -07:00
http-walker.c	object-store-ll.h: split this header out of object-store.h	2023-06-21 13:39:54 -07:00
http.c	http: mark unused parameters in curl callbacks	2023-07-13 17:23:59 -07:00
http.h	…
ident.c	Merge branch 'bc/ident-dot-is-no-longer-crud-letter'	2023-08-09 16:18:15 -07:00
ident.h	config: add ctx arg to config_fn_t	2023-06-28 14:06:39 -07:00
imap-send.c	Merge branch 'cw/compat-util-header-cleanup'	2023-07-17 11:30:42 -07:00
iterator.h	…
json-writer.c	…
json-writer.h	…
khash.h	hash-ll, hashmap: move oidhash() to hash-ll	2023-06-21 13:39:54 -07:00
kwset.c	kwset: move translation table from ctype	2023-07-05 11:41:18 -07:00
kwset.h	kwset: move translation table from ctype	2023-07-05 11:41:18 -07:00
levenshtein.c	…
levenshtein.h	…
line-log.c	git-compat-util: move alloc macros to git-compat-util.h	2023-07-05 11:42:31 -07:00
line-log.h	…
line-range.c	…
line-range.h	…
linear-assignment.c	…
linear-assignment.h	…
list-objects-filter-options.c	git-compat-util: move alloc macros to git-compat-util.h	2023-07-05 11:42:31 -07:00
list-objects-filter-options.h	list-objects-filter-options.h: remove unneccessary include	2023-06-21 13:39:53 -07:00
list-objects-filter.c	git-compat-util: move alloc macros to git-compat-util.h	2023-07-05 11:42:31 -07:00
list-objects-filter.h	…
list-objects.c	Merge branch 'jc/tree-walk-drop-base-offset'	2023-08-02 09:37:23 -07:00
list-objects.h	…
list.h	…
lockfile.c	…
lockfile.h	…
log-tree.c	Merge branch 'en/header-split-cache-h-part-3'	2023-06-29 16:43:21 -07:00
log-tree.h	log-tree: replace include of revision.h with simple forward declaration	2023-06-21 13:39:53 -07:00
ls-refs.c	Merge branch 'tb/refs-exclusion-and-packed-refs'	2023-07-21 13:47:26 -07:00
ls-refs.h	…
mailinfo.c	config: add ctx arg to config_fn_t	2023-06-28 14:06:39 -07:00
mailinfo.h	…
mailmap.c	object-store-ll.h: split this header out of object-store.h	2023-06-21 13:39:54 -07:00
mailmap.h	…
match-trees.c	object-store-ll.h: split this header out of object-store.h	2023-06-21 13:39:54 -07:00
match-trees.h	…
mem-pool.c	…
mem-pool.h	…
merge-blobs.c	object-store-ll.h: split this header out of object-store.h	2023-06-21 13:39:54 -07:00
merge-blobs.h	…
merge-ll.c	Merge branch 'cw/compat-util-header-cleanup'	2023-07-17 11:30:42 -07:00
merge-ll.h	merge-ll: rename from ll-merge	2023-06-21 13:39:54 -07:00
merge-ort-wrappers.c	cache.h: remove this no-longer-used header	2023-06-21 13:39:53 -07:00
merge-ort-wrappers.h	…
merge-ort.c	object-store-ll.h: split this header out of object-store.h	2023-06-21 13:39:54 -07:00
merge-ort.h	…
merge-recursive.c	treewide: remove unnecessary includes for wrapper.h	2023-07-05 11:41:59 -07:00
merge-recursive.h	…
merge.c	diff.h: remove unnecessary include of oidset.h	2023-06-21 13:39:53 -07:00
merge.h	merge.h: move declarations for merge.c from cache.h	2023-06-21 13:39:53 -07:00
mergesort.h	…
midx.c	Merge branch 'tb/object-access-overflow-protection'	2023-07-25 12:05:23 -07:00
midx.h	…
name-hash.c	cache.h: remove this no-longer-used header	2023-06-21 13:39:53 -07:00
name-hash.h	name-hash.h: move declarations for name-hash.c from cache.h	2023-06-21 13:39:53 -07:00
notes-cache.c	object-store-ll.h: split this header out of object-store.h	2023-06-21 13:39:54 -07:00
notes-cache.h	…
notes-merge.c	treewide: remove unnecessary includes for wrapper.h	2023-07-05 11:41:59 -07:00
notes-merge.h	…
notes-utils.c	config: add ctx arg to config_fn_t	2023-06-28 14:06:39 -07:00
notes-utils.h	…
notes.c	Merge branch 'gc/config-context'	2023-07-06 11:54:48 -07:00
notes.h	notes: move the documentation to the struct	2023-06-06 09:35:05 +09:00
object-file.c	Merge branch 'jk/unused-parameter'	2023-07-25 12:05:24 -07:00
object-file.h	…
object-name.c	Merge branch 'cw/strbuf-cleanup'	2023-07-06 11:54:46 -07:00
object-name.h	object-name: move related functions to object-name	2023-06-12 13:49:36 -07:00
object-store-ll.h	Merge branch 'tb/object-access-overflow-protection'	2023-07-25 12:05:23 -07:00
object-store.h	packfile.c: prevent overflow in `load_idx()`	2023-07-14 09:31:34 -07:00
object.c	Merge branch 'en/header-split-cache-h-part-3'	2023-06-29 16:43:21 -07:00
object.h	Merge branch 'tb/pack-bitmap-traversal-with-boundary'	2023-06-22 16:29:05 -07:00
oid-array.c	git-compat-util: move alloc macros to git-compat-util.h	2023-07-05 11:42:31 -07:00
oid-array.h	…
oidmap.c	…
oidmap.h	read-cache*.h: move declarations for read-cache.c functions from cache.h	2023-06-21 13:39:53 -07:00
oidset.c	…
oidset.h	…
oidtree.c	git-compat-util: move alloc macros to git-compat-util.h	2023-07-05 11:42:31 -07:00
oidtree.h	…
pack-bitmap-write.c	git-compat-util: move alloc macros to git-compat-util.h	2023-07-05 11:42:31 -07:00
pack-bitmap.c	Merge branch 'tb/object-access-overflow-protection'	2023-07-25 12:05:23 -07:00
pack-bitmap.h	Merge branch 'tb/pack-bitmap-traversal-with-boundary'	2023-06-22 16:29:05 -07:00
pack-check.c	object-store-ll.h: split this header out of object-store.h	2023-06-21 13:39:54 -07:00
pack-mtimes.c	object-store-ll.h: split this header out of object-store.h	2023-06-21 13:39:54 -07:00
pack-mtimes.h	…
pack-objects.c	git-compat-util: move alloc macros to git-compat-util.h	2023-07-05 11:42:31 -07:00
pack-objects.h	object-store-ll.h: split this header out of object-store.h	2023-06-21 13:39:54 -07:00
pack-revindex.c	object-store-ll.h: split this header out of object-store.h	2023-06-21 13:39:54 -07:00
pack-revindex.h	…
pack-write.c	treewide: remove unnecessary includes for wrapper.h	2023-07-05 11:41:59 -07:00
pack.h	…
packfile.c	Merge branch 'jc/retire-get-sha1-hex'	2023-08-04 10:52:30 -07:00
packfile.h	…
pager.c	config: add ctx arg to config_fn_t	2023-06-28 14:06:39 -07:00
pager.h	…
parallel-checkout.c	git-compat-util: move alloc macros to git-compat-util.h	2023-07-05 11:42:31 -07:00
parallel-checkout.h	…
parse-options-cb.c	…
parse-options.c	parse-options: disallow negating OPTION_SET_INT 0	2023-08-08 16:55:07 -07:00
parse-options.h	fetch: reject --no-ipv[46]	2023-07-18 14:47:30 -07:00
patch-delta.c	…
patch-ids.c	diff.h: remove unnecessary include of oidset.h	2023-06-21 13:39:53 -07:00
patch-ids.h	…
path.c	Merge branch 'cw/compat-util-header-cleanup'	2023-07-17 11:30:42 -07:00
path.h	path: move related function to path	2023-06-12 13:49:36 -07:00
pathspec.c	git-compat-util.h: remove unneccessary include of wildmatch.h	2023-06-21 13:39:54 -07:00
pathspec.h	Merge branch 'jk/log-follow-with-non-literal-pathspec'	2023-06-20 15:53:13 -07:00
pkt-line.c	Merge branch 'cw/compat-util-header-cleanup'	2023-07-17 11:30:42 -07:00
pkt-line.h	pkt-line: add size parameter to packet_length()	2023-07-07 15:30:16 -07:00
preload-index.c	cache.h: remove this no-longer-used header	2023-06-21 13:39:53 -07:00
preload-index.h	preload-index.h: move declarations for preload-index.c from elsewhere	2023-06-21 13:39:53 -07:00
pretty.c	Merge branch 'cw/compat-util-header-cleanup'	2023-07-17 11:30:42 -07:00
pretty.h	…
prio-queue.c	git-compat-util: move alloc macros to git-compat-util.h	2023-07-05 11:42:31 -07:00
prio-queue.h	…
progress.c	…
progress.h	…
promisor-remote.c	Merge branch 'gc/config-context'	2023-07-06 11:54:48 -07:00
promisor-remote.h	…
prompt.c	…
prompt.h	…
protocol-caps.c	object-store-ll.h: split this header out of object-store.h	2023-06-21 13:39:54 -07:00
protocol-caps.h	…
protocol.c	…
protocol.h	…
prune-packed.c	object-store-ll.h: split this header out of object-store.h	2023-06-21 13:39:54 -07:00
prune-packed.h	…
quote.c	git-compat-util: move alloc macros to git-compat-util.h	2023-07-05 11:42:31 -07:00
quote.h	…
range-diff.c	diff.h: remove unnecessary include of oidset.h	2023-06-21 13:39:53 -07:00
range-diff.h	…
reachable.c	Merge branch 'en/header-split-cache-h-part-3'	2023-06-29 16:43:21 -07:00
reachable.h	…
read-cache-ll.h	read-cache*.h: move declarations for read-cache.c functions from cache.h	2023-06-21 13:39:53 -07:00
read-cache.c	Merge branch 'cw/compat-util-header-cleanup'	2023-07-17 11:30:42 -07:00
read-cache.h	read-cache*.h: move declarations for read-cache.c functions from cache.h	2023-06-21 13:39:53 -07:00
rebase-interactive.c	Merge branch 'cw/compat-util-header-cleanup'	2023-07-17 11:30:42 -07:00
rebase-interactive.h	…
rebase.c	…
rebase.h	…
ref-filter.c	Merge branch 'ks/ref-filter-describe'	2023-08-02 09:37:24 -07:00
ref-filter.h	builtin/for-each-ref.c: add `--exclude` option	2023-07-10 14:48:55 -07:00
reflog-walk.c	git-compat-util: move alloc macros to git-compat-util.h	2023-07-05 11:42:31 -07:00
reflog-walk.h	…
reflog.c	object-store-ll.h: split this header out of object-store.h	2023-06-21 13:39:54 -07:00
reflog.h	…
refs.c	Merge branch 'jk/unused-parameter'	2023-07-25 12:05:24 -07:00
refs.h	Merge branch 'tb/refs-exclusion-and-packed-refs'	2023-07-21 13:47:26 -07:00
refspec.c	git-compat-util: move alloc macros to git-compat-util.h	2023-07-05 11:42:31 -07:00
refspec.h	…
remote-curl.c	Merge branch 'cw/compat-util-header-cleanup'	2023-07-17 11:30:42 -07:00
remote.c	Merge branch 'ah/advise-force-pushing'	2023-07-25 12:05:23 -07:00
remote.h	wt-status: don't show divergence advice when committing	2023-07-13 09:14:58 -07:00
replace-object.c	Merge branch 'en/header-split-cache-h-part-3'	2023-06-29 16:43:21 -07:00
replace-object.h	Merge branch 'en/header-split-cache-h-part-3'	2023-06-29 16:43:21 -07:00
repo-settings.c	repository: create read_replace_refs setting	2023-06-12 13:34:55 -07:00
repository.c	object-store-ll.h: split this header out of object-store.h	2023-06-21 13:39:54 -07:00
repository.h	Merge branch 'en/header-split-cache-h-part-3'	2023-06-29 16:43:21 -07:00
rerere.c	Merge branch 'jc/retire-get-sha1-hex'	2023-08-04 10:52:30 -07:00
rerere.h	…
reset.c	…
reset.h	…
resolve-undo.c	cache.h: remove this no-longer-used header	2023-06-21 13:39:53 -07:00
resolve-undo.h	…
revision.c	Merge branch 'jk/unused-parameter'	2023-07-25 12:05:24 -07:00
revision.h	Merge branch 'jk/unused-parameter'	2023-07-25 12:05:24 -07:00
run-command.c	Merge branch 'ma/locate-in-path-for-windows'	2023-08-09 16:18:16 -07:00
run-command.h	cache.h: remove this no-longer-used header	2023-06-21 13:39:53 -07:00
sane-ctype.h	sane-ctype.h: create header for sane-ctype macros	2023-07-05 11:41:18 -07:00
scalar.c	config: add ctx arg to config_fn_t	2023-06-28 14:06:39 -07:00
send-pack.c	treewide: remove unnecessary includes for wrapper.h	2023-07-05 11:41:59 -07:00
send-pack.h	…
sequencer.c	Merge branch 'pw/rebase-skip-commit-message-fix'	2023-08-09 16:18:16 -07:00
sequencer.h	…
serve.c	hash-ll, hashmap: move oidhash() to hash-ll	2023-06-21 13:39:54 -07:00
serve.h	…
server-info.c	git-compat-util: move alloc macros to git-compat-util.h	2023-07-05 11:42:31 -07:00
server-info.h	…
setup.c	Merge branch 'cw/compat-util-header-cleanup'	2023-07-17 11:30:42 -07:00
setup.h	setup: adopt shared init-db & clone code	2023-06-21 13:39:53 -07:00
sh-i18n--envsubst.c	…
sha1dc_git.c	…
sha1dc_git.h	…
shallow.c	git-compat-util: move alloc macros to git-compat-util.h	2023-07-05 11:42:31 -07:00
shallow.h	…
shared.mak	…
shell.c	…
shortlog.h	…
sideband.c	…
sideband.h	…
sigchain.c	git-compat-util: move alloc macros to git-compat-util.h	2023-07-05 11:42:31 -07:00
sigchain.h	…
simple-ipc.h	…
sparse-index.c	git-compat-util: move alloc macros to git-compat-util.h	2023-07-05 11:42:31 -07:00
sparse-index.h	sparse-index.h: move declarations for sparse-index.c from cache.h	2023-06-21 13:39:53 -07:00
split-index.c	git-compat-util: move alloc macros to git-compat-util.h	2023-07-05 11:42:31 -07:00
split-index.h	…
stable-qsort.c	…
statinfo.c	statinfo: move stat_{data,validity} functions from cache/read-cache	2023-06-21 13:39:53 -07:00
statinfo.h	Merge branch 'en/header-split-cache-h-part-3'	2023-06-29 16:43:21 -07:00
strbuf.c	Merge branch 'rs/strbuf-addftime-simplify'	2023-07-25 12:05:24 -07:00
strbuf.h	Merge branch 'cw/compat-util-header-cleanup'	2023-07-17 11:30:42 -07:00
streaming.c	treewide: remove unnecessary includes for wrapper.h	2023-07-05 11:41:59 -07:00
streaming.h	…
string-list.c	git-compat-util: move alloc macros to git-compat-util.h	2023-07-05 11:42:31 -07:00
string-list.h	…
strmap.c	…
strmap.h	…
strvec.c	git-compat-util: move alloc macros to git-compat-util.h	2023-07-05 11:42:31 -07:00
strvec.h	…
sub-process.c	…
sub-process.h	…
submodule-config.c	Merge branch 'cw/compat-util-header-cleanup'	2023-07-17 11:30:42 -07:00
submodule-config.h	config: pass kvi to die_bad_number()	2023-06-28 14:06:40 -07:00
submodule.c	git-compat-util: move alloc macros to git-compat-util.h	2023-07-05 11:42:31 -07:00
submodule.h	…
symlinks.c	…
symlinks.h	…
tag.c	treewide: remove unnecessary includes for wrapper.h	2023-07-05 11:41:59 -07:00
tag.h	…
tar.h	…
tempfile.c	Merge branch 'cw/compat-util-header-cleanup'	2023-07-17 11:30:42 -07:00
tempfile.h	…
thread-utils.c	…
thread-utils.h	…
tmp-objdir.c	object-store-ll.h: split this header out of object-store.h	2023-06-21 13:39:54 -07:00
tmp-objdir.h	…
trace.c	treewide: remove unnecessary includes for wrapper.h	2023-07-05 11:41:59 -07:00
trace.h	…
trace2.c	wrapper: use trace2 counters to collect fsync stats	2023-07-20 11:52:53 -07:00
trace2.h	Merge branch 'bb/use-trace2-counters-for-fsync-stats'	2023-08-02 09:37:23 -07:00
trailer.c	Merge branch 'cw/compat-util-header-cleanup'	2023-07-17 11:30:42 -07:00
trailer.h	…
transport-helper.c	treewide: remove unnecessary includes for wrapper.h	2023-07-05 11:41:59 -07:00
transport-internal.h	…
transport.c	git-compat-util: move alloc macros to git-compat-util.h	2023-07-05 11:42:31 -07:00
transport.h	…
tree-diff.c	Merge branch 'jc/tree-walk-drop-base-offset'	2023-08-02 09:37:23 -07:00
tree-walk.c	Merge branch 'jc/tree-walk-drop-base-offset'	2023-08-02 09:37:23 -07:00
tree-walk.h	tree-walk: lose base_offset that is never used in tree_entry_interesting	2023-07-07 15:27:28 -07:00
tree.c	Merge branch 'jc/tree-walk-drop-base-offset'	2023-08-02 09:37:23 -07:00
tree.h	…
unicode-width.h	…
unimplemented.sh	…
unix-socket.c	…
unix-socket.h	…
unix-stream-server.c	…
unix-stream-server.h	…
unpack-trees.c	object-store-ll.h: split this header out of object-store.h	2023-06-21 13:39:54 -07:00
unpack-trees.h	read-cache*.h: move declarations for read-cache.c functions from cache.h	2023-06-21 13:39:53 -07:00
upload-pack.c	Merge branch 'tb/refs-exclusion-and-packed-refs'	2023-07-21 13:47:26 -07:00
upload-pack.h	…
url.c	…
url.h	…
urlmatch.c	config: add ctx arg to config_fn_t	2023-06-28 14:06:39 -07:00
urlmatch.h	config: add ctx arg to config_fn_t	2023-06-28 14:06:39 -07:00
usage.c	treewide: remove unnecessary includes for wrapper.h	2023-07-05 11:41:59 -07:00
userdiff.c	git-compat-util: move alloc macros to git-compat-util.h	2023-07-05 11:42:31 -07:00
userdiff.h	…
utf8.c	…
utf8.h	…
varint.c	…
varint.h	…
version.c	…
version.h	…
versioncmp.c	git-compat-util: move strbuf.c funcs to its header	2023-07-05 11:41:18 -07:00
versioncmp.h	…
walker.c	object-store-ll.h: split this header out of object-store.h	2023-06-21 13:39:54 -07:00
walker.h	…
wildmatch.c	…
wildmatch.h	…
worktree.c	Merge branch 'cw/compat-util-header-cleanup'	2023-07-17 11:30:42 -07:00
worktree.h	…
wrap-for-bin.sh	…
wrapper.c	Merge branch 'bb/use-trace2-counters-for-fsync-stats'	2023-08-02 09:37:23 -07:00
wrapper.h	wrapper: use trace2 counters to collect fsync stats	2023-07-20 11:52:53 -07:00
write-or-die.c	treewide: remove unnecessary includes for wrapper.h	2023-07-05 11:41:59 -07:00
write-or-die.h	…
ws.c	…
ws.h	…
wt-status.c	Merge branch 'ah/advise-force-pushing'	2023-07-25 12:05:23 -07:00
wt-status.h	…
xdiff-interface.c	Merge branch 'gc/config-context'	2023-07-06 11:54:48 -07:00
xdiff-interface.h	config: add ctx arg to config_fn_t	2023-06-28 14:06:39 -07:00

README.md

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.txt to get started, then see Documentation/giteveryday.txt for a useful minimum set of commands, and Documentation/git-<commandname>.txt 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.txt (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 with just "subscribe git" in the body to majordomo@vger.kernel.org (not the Git list). The mailing list archives are available at https://lore.kernel.org/git/, http://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