Go to file

Patrick Steinhardt afcd067dad refs: do not check ref existence in `is_root_ref()` Before this patch series, root refs except for "HEAD" and our special refs were classified as pseudorefs. Furthermore, our terminology clarified that pseudorefs must not be symbolic refs. This restriction is enforced in `is_root_ref()`, which explicitly checks that a supposed root ref resolves to an object ID without recursing. This has been extremely confusing right from the start because (in old terminology) a ref name may sometimes be a pseudoref and sometimes not depending on whether it is a symbolic or regular ref. This behaviour does not seem reasonable at all and I very much doubt that it results in anything sane. Last but not least, the current behaviour can actually lead to a segfault when calling `is_root_ref()` with a reference that either does not exist or that is a symbolic ref because we never initialized `oid`, but then read it via `is_null_oid()`. We have now changed terminology to clarify that pseudorefs are really only "MERGE_HEAD" and "FETCH_HEAD", whereas all the other refs that live in the root of the ref hierarchy are just plain refs. Thus, we do not need to check whether the ref is symbolic or not. In fact, we can now avoid looking up the ref completely as the name is sufficient for us to figure out whether something would be a root ref or not. This change of course changes semantics for our callers. As there are only three of them we can assess each of them individually: - "ref-filter.c:ref_kind_from_refname()" uses it to classify refs. It's clear that the intent is to classify based on the ref name, only. - "refs/reftable_backend.c:reftable_ref_iterator_advance()" uses it to filter root refs. Again, using existence checks is pointless here as the iterator has just surfaced the ref, so we know it does exist. - "refs/files_backend.c:add_pseudoref_and_head_entries()" uses it to determine whether it should add a ref to the root directory of its iterator. This had the effect that we skipped over any files that are either a symbolic ref, or which are not a ref at all. The new behaviour is to include symbolic refs know, which aligns us with the adapted terminology. Furthermore, files which look like root refs but aren't are now mark those as "broken". As broken refs are not surfaced by our tooling, this should not lead to a change in user-visible behaviour, but may cause us to emit warnings. This feels like the right thing to do as we would otherwise just silently ignore corrupted root refs completely. So in all cases the existence check was either superfluous, not in line with the adapted terminology or masked potential issues. This commit thus changes the behaviour as proposed and drops the existence check altogether. Add a test that verifies that this does not change user-visible behaviour. Namely, we still don't want to show broken refs to the user by default in git-for-each-ref(1). What this does allow though is for internal callers to surface dangling root refs when they pass in the `DO_FOR_EACH_INCLUDE_BROKEN` flag. Signed-off-by: Patrick Steinhardt <ps@pks.im> Signed-off-by: Junio C Hamano <gitster@pobox.com>		2024-05-15 07:30:52 -07:00
.github	Merge branch 'pb/ci-win-artifact-names-fix'	2024-03-21 14:55:13 -07:00
Documentation	Documentation/glossary: define root refs as refs	2024-05-15 07:30:51 -07:00
block-sha1	…
builtin	Merge branch 'rj/add-i-leak-fix'	2024-04-25 10:34:24 -07:00
ci	fuzz: add fuzzer for config parsing	2024-03-15 10:47:05 -07:00
compat	Win32: detect unix socket support at runtime	2024-04-03 14:54:28 -07:00
contrib	Merge branch 'ba/osxkeychain-updates'	2024-04-16 14:50:30 -07:00
ewah	ewah: implement `bitmap_is_empty()`	2023-12-14 14:38:07 -08:00
git-gui	Makefile(s): do not enforce "all indents must be done with tab"	2024-04-08 16:36:05 -07:00
gitk-git	Makefile(s): avoid recipe prefix in conditional statements	2024-04-08 14:42:32 -07:00
gitweb	Merge branch 'js/update-urls-in-doc-and-comment' into maint-2.43	2024-02-08 16:22:01 -08:00
mergetools	mergetools: vimdiff: use correct tool's name when reading mergetool config	2024-02-19 08:45:14 -08:00
negotiator	treewide: remove unnecessary includes in source files	2023-12-26 12:04:31 -08:00
oss-fuzz	Merge branch 'rs/date-mode-pass-by-value'	2024-04-16 14:50:29 -07:00
perl	Merge branch 'js/update-urls-in-doc-and-comment' into maint-2.43	2024-02-08 16:22:01 -08:00
po	Merge branch 'master' of github.com:alshopov/git-po	2024-04-29 14:50:23 +08:00
refs	refs: do not check ref existence in `is_root_ref()`	2024-05-15 07:30:52 -07:00
reftable	Merge branch 'ps/reftable-block-iteration-optim'	2024-04-23 11:52:37 -07:00
sha1	avoid SHA-1 functions deprecated in OpenSSL 3+	2023-08-01 08:34:56 -07:00
sha1collisiondetection@855827c583	…
sha1dc	doc: refer to internet archive	2023-11-26 10:07:06 +09:00
sha256	Merge branch 'ew/hash-with-openssl-evp'	2023-08-09 16:18:15 -07:00
t	refs: do not check ref existence in `is_root_ref()`	2024-05-15 07:30:52 -07:00
templates	Merge branch 'jp/use-diff-index-in-pre-commit-sample' into maint-2.43	2024-02-08 16:22:02 -08:00
trace2	Merge branch 'en/header-cleanup' into maint-2.43	2024-02-08 16:22:10 -08:00
xdiff	…
.cirrus.yml	Merge branch 'cb/use-freebsd-13-2-at-cirrus-ci'	2024-02-06 14:31:22 -08:00
.clang-format	clang-format: fix typo in comment	2023-11-01 12:24:19 +09:00
.editorconfig	editorconfig: add Makefiles to "text files"	2024-03-23 11:42:31 -07:00
.gitattributes	…
.gitignore	replay: introduce new builtin	2023-11-26 10:10:48 +09:00
.gitlab-ci.yml	ci: add jobs to test with the reftable backend	2024-02-07 08:28:37 -08:00
.gitmodules	…
.mailmap	mailmap: change primary address for Linus Arver	2024-04-16 22:25:11 -07:00
.tsan-suppressions	…
CODE_OF_CONDUCT.md	CoC: whitespace fix	2024-01-23 10:40:10 -08:00
COPYING	…
GIT-VERSION-GEN	Git 2.45	2024-04-29 07:30:29 -07:00
INSTALL	INSTALL: bump libcurl version to 7.21.3	2024-04-02 13:27:20 -07:00
LGPL-2.1	…
Makefile	Merge branch 'tb/make-indent-conditional-with-non-spaces'	2024-04-16 14:50:29 -07:00
README.md	Merge branch 'jc/majordomo-to-subspace' into maint-2.43	2024-02-13 14:44:50 -08:00
RelNotes	Start the 2.45 cycle	2024-02-26 18:10:25 -08:00
SECURITY.md	…
abspath.c	…
abspath.h	…
aclocal.m4	…
add-interactive.c	add-interactive: plug a leak in get_untracked_files	2024-04-22 16:27:42 -07:00
add-interactive.h	…
add-patch.c	add-patch: plug a leak handling the '/' command	2024-04-22 16:27:42 -07:00
advice.c	Merge branch 'jc/advice-sans-trailing-whitespace'	2024-04-09 14:31:43 -07:00
advice.h	sequencer: allow disabling conflict advice	2024-03-18 09:28:40 -07:00
alias.c	Merge branch 'cw/compat-util-header-cleanup'	2023-07-17 11:30:42 -07:00
alias.h	…
alloc.c	…
alloc.h	…
apply.c	Merge branch 'rj/add-i-leak-fix'	2024-04-25 10:34:24 -07:00
apply.h	…
archive-tar.c	use xstrncmpz()	2024-02-12 09:32:41 -08:00
archive-zip.c	archive.h: remove unnecessary include	2023-12-26 12:04:31 -08:00
archive.c	Merge branch 'eb/hash-transition'	2024-03-28 14:13:50 -07:00
archive.h	archive.h: remove unnecessary include	2023-12-26 12:04:31 -08:00
attr.c	attr: add builtin objectmode values support	2023-12-28 13:21:52 -08:00
attr.h	attr: add attr.tree for setting the treeish to read attributes from	2023-10-13 11:43:29 -07:00
banned.h	…
base85.c	…
base85.h	…
bisect.c	bisect: report the found commit with "show"	2024-04-15 11:29:09 -07:00
bisect.h	…
blame.c	blame.h: remove unnecessary includes	2023-12-26 12:04:32 -08:00
blame.h	blame.h: remove unnecessary includes	2023-12-26 12:04:32 -08:00
blob.c	treewide: remove unnecessary includes in source files	2023-12-26 12:04:31 -08:00
blob.h	…
bloom.c	treewide: remove unnecessary includes in source files	2023-12-26 12:04:31 -08:00
bloom.h	…
branch.c	Merge branch 'pf/commitish-committish'	2024-04-19 09:13:47 -07:00
branch.h	typo: replace 'commitish' with 'committish'	2024-04-11 15:14:56 -07:00
builtin.h	replay: introduce new builtin	2023-11-26 10:10:48 +09:00
bulk-checkin.c	treewide: remove unnecessary includes in source files	2023-12-26 12:04:31 -08:00
bulk-checkin.h	bulk-checkin: only support blobs in index_bulk_checkin	2023-09-26 10:17:56 -07:00
bundle-uri.c	treewide: remove unnecessary includes in source files	2023-12-26 12:04:31 -08: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	Merge branch 'eb/hash-transition'	2024-03-28 14:13:50 -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	chunk-format: drop pair_chunk_unsafe()	2023-10-09 15:55:02 -07:00
chunk-format.h	chunk-format: drop pair_chunk_unsafe()	2023-10-09 15:55:02 -07:00
color.c	hex-ll: separate out non-hash-algo functions	2023-09-29 15:14:56 -07:00
color.h	…
column.c	column: guard against negative padding	2024-02-13 10:18:57 -08:00
column.h	…
combine-diff.c	Merge branch 'js/check-null-from-read-object-file'	2024-02-14 15:36:06 -08:00
command-list.txt	replay: introduce new builtin	2023-11-26 10:10:48 +09:00
commit-graph.c	Merge branch 'en/header-cleanup' into maint-2.43	2024-02-08 16:22:10 -08:00
commit-graph.h	Merge branch 'ps/do-not-trust-commit-graph-blindly-for-existence'	2023-11-08 11:03:59 +09:00
commit-reach.c	commit-reach(repo_get_merge_bases_many_dirty): pass on errors	2024-02-29 08:06:01 -08:00
commit-reach.h	commit-reach(repo_get_merge_bases_many_dirty): pass on errors	2024-02-29 08:06:01 -08:00
commit-slab-decl.h	…
commit-slab-impl.h	…
commit-slab.h	…
commit.c	Merge branch 'jk/core-comment-string'	2024-04-05 10:49:49 -07:00
commit.h	Merge branch 'eb/hash-transition'	2024-03-28 14:13:50 -07:00
common-main.c	…
config.c	Merge branch 'jc/unleak-core-excludesfile'	2024-04-15 14:11:44 -07:00
config.h	config: allow tweaking whitespace between value and comment	2024-03-15 16:07:39 -07:00
config.mak.dev	…
config.mak.in	…
config.mak.uname	Merge branch 'tb/make-indent-conditional-with-non-spaces'	2024-04-16 14:50:29 -07:00
configure.ac	global: convert trivial usages of `test <expr> -a/-o <expr>`	2023-11-11 09:21:00 +09:00
connect.c	Merge branch 'gc/config-context'	2023-07-06 11:54:48 -07:00
connect.h	…
connected.c	…
connected.h	…
convert.c	use xstrncmpz()	2024-02-12 09:32:41 -08:00
convert.h	config: use git_config_string() for core.checkRoundTripEncoding	2023-12-09 08:26:22 +09:00
copy.c	…
copy.h	…
credential.c	credential: mark unused parameter in urlmatch callback	2023-08-29 17:56:26 -07:00
credential.h	…
csum-file.c	Merge branch 'ew/hash-with-openssl-evp'	2023-09-13 10:07:57 -07:00
csum-file.h	…
ctype.c	…
daemon.c	daemon: free listen_addr before returning	2023-10-05 14:54:58 -07:00
date.c	date: make DATE_MODE thread-safe	2024-04-05 15:21:14 -07:00
date.h	date: make DATE_MODE thread-safe	2024-04-05 15:21:14 -07:00
decorate.c	decorate: add clear_decoration() function	2023-10-05 14:54:55 -07:00
decorate.h	decorate: add clear_decoration() function	2023-10-05 14:54:55 -07:00
delta-islands.c	Merge branch 'eb/hash-transition'	2024-03-28 14:13:50 -07:00
delta-islands.h	…
delta.h	…
detect-compiler	…
diagnose.c	dir.[ch]: add 'follow_symlink' arg to 'get_dtype'	2023-10-09 15:53:13 -07:00
diagnose.h	…
diff-delta.c	…
diff-lib.c	revision: optionally record matches with pathspec elements	2024-04-03 14:55:21 -07:00
diff-merges.c	diff-merges: introduce '--dd' option	2023-10-09 12:47:29 -07:00
diff-merges.h	…
diff-no-index.c	treewide: remove unnecessary includes in source files	2023-12-26 12:04:31 -08:00
diff.c	diff: add diff.srcPrefix and diff.dstPrefix configuration variables	2024-03-15 10:04:45 -07:00
diff.h	diff --stat: set the width defaults in a helper function	2023-09-29 15:46:06 -07:00
diffcore-break.c	treewide: remove unnecessary includes in source files	2023-12-26 12:04:31 -08:00
diffcore-delta.c	Merge branch 'en/diffcore-delta-final-line-fix' into maint-2.43	2024-02-13 14:44:48 -08:00
diffcore-order.c	…
diffcore-pickaxe.c	…
diffcore-rename.c	…
diffcore-rotate.c	…
diffcore.h	…
dir-iterator.c	dir-iterator: support iteration in sorted order	2024-02-21 09:58:05 -08:00
dir-iterator.h	dir-iterator: support iteration in sorted order	2024-02-21 09:58:05 -08:00
dir.c	dir: create untracked_cache_invalidate_trimmed_path()	2024-02-26 15:34:02 -08:00
dir.h	dir: create untracked_cache_invalidate_trimmed_path()	2024-02-26 15:34:02 -08:00
editor.c	launch_editor: waiting message on error	2024-04-15 10:13:32 -07:00
editor.h	…
entry.c	treewide: remove unnecessary includes in source files	2023-12-26 12:04:31 -08:00
entry.h	wrapper: reduce scope of remove_or_warn()	2023-09-29 15:14:56 -07:00
environment.c	Merge branch 'jk/core-comment-string'	2024-04-05 10:49:49 -07:00
environment.h	Merge branch 'jk/core-comment-string'	2024-04-05 10:49:49 -07:00
exec-cmd.c	treewide: remove unnecessary includes in source files	2023-12-26 12:04:31 -08:00
exec-cmd.h	…
fetch-negotiator.c	…
fetch-negotiator.h	…
fetch-pack.c	Merge branch 'sd/negotiate-trace-fix' into maint-2.43	2024-02-13 14:44:50 -08:00
fetch-pack.h	treewide: remove unnecessary includes from header files	2023-12-26 12:04:31 -08:00
fmt-merge-msg.c	prefer comment_line_str to comment_line_char for printing	2024-03-12 13:28:10 -07:00
fmt-merge-msg.h	…
fsck.c	Merge branch 'eb/hash-transition'	2024-03-28 14:13:50 -07:00
fsck.h	fsck: detect very large tree pathnames	2023-08-31 15:51:07 -07:00
fsmonitor--daemon.h	fsmonitor--daemon.h: remove unnecessary includes	2023-12-26 12:04:32 -08:00
fsmonitor-ipc.c	treewide: remove unnecessary includes in source files	2023-12-26 12:04:33 -08:00
fsmonitor-ipc.h	…
fsmonitor-ll.h	…
fsmonitor-path-utils.h	…
fsmonitor-settings.c	fsmonitor: mark some maybe-unused parameters	2023-09-18 15:56:14 -07:00
fsmonitor-settings.h	…
fsmonitor.c	fsmonitor: support case-insensitive events	2024-03-06 09:10:06 -08:00
fsmonitor.h	…
generate-cmdlist.sh	…
generate-configlist.sh	…
generate-hooklist.sh	…
gettext.c	treewide: remove unnecessary includes in source files	2023-12-26 12:04:31 -08:00
gettext.h	…
git-archimport.perl	perl: bump the required Perl version to 5.8.1 from 5.8.0	2023-11-17 07:26:32 +09:00
git-compat-util.h	Merge branch 'rs/no-openssl-compilation-fix-on-macos'	2024-04-23 11:52:38 -07:00
git-curl-compat.h	remote-curl: add Transfer-Encoding header only for older curl	2024-04-05 14:45:19 -07:00
git-cvsexportcommit.perl	perl: bump the required Perl version to 5.8.1 from 5.8.0	2023-11-17 07:26:32 +09:00
git-cvsimport.perl	Merge branch 'js/update-urls-in-doc-and-comment' into maint-2.43	2024-02-08 16:22:01 -08:00
git-cvsserver.perl	perl: bump the required Perl version to 5.8.1 from 5.8.0	2023-11-17 07:26:32 +09:00
git-difftool--helper.sh	git-difftool--helper: honor `--trust-exit-code` with `--dir-diff`	2024-02-20 09:30:32 -08:00
git-filter-branch.sh	…
git-instaweb.sh	doc: switch links to https	2023-11-26 10:07:05 +09:00
git-merge-octopus.sh	…
git-merge-one-file.sh	…
git-merge-resolve.sh	…
git-mergetool--lib.sh	…
git-mergetool.sh	…
git-p4.py	Merge branch 'jt/p4-spell-re-with-raw-string'	2024-02-06 14:31:20 -08:00
git-quiltimport.sh	git-quiltimport: avoid an unnecessary subshell	2024-03-16 11:08:57 -07:00
git-request-pull.sh	…
git-send-email.perl	Merge branch 'tz/send-email-negatable-options' into maint-2.43	2024-02-08 16:22:01 -08:00
git-sh-i18n.sh	…
git-sh-setup.sh	…
git-submodule.sh	…
git-svn.perl	Merge branch 'tz/send-email-negatable-options' into maint-2.43	2024-02-08 16:22:01 -08:00
git-web--browse.sh	…
git-zlib.c	…
git-zlib.h	…
git.c	Merge branch 'jh/trace2-missing-def-param-fix'	2024-03-18 13:04:25 -07:00
git.rc	…
gpg-interface.c	Merge branch 'rs/date-mode-pass-by-value'	2024-04-16 14:50:29 -07:00
gpg-interface.h	tag: fix sign_buffer() call to create a signed tag	2024-02-07 10:47:25 -08:00
graph.c	diff --stat: add config option to limit filename width	2023-09-18 09:39:07 -07:00
graph.h	doc: switch links to https	2023-11-26 10:07:05 +09:00
grep.c	grep: improve errors for unmatched ( and )	2024-03-25 11:40:53 -07:00
grep.h	…
hash-ll.h	object-names: support input of oids in any supported hash	2023-10-02 14:57:38 -07:00
hash-lookup.c	…
hash-lookup.h	…
hash.h	cache: add a function to read an OID of a specific algorithm	2023-10-02 14:57:39 -07:00
hashmap.c	…
hashmap.h	…
help.c	help: handle NULL value for alias.* config	2023-12-09 08:24:47 +09:00
help.h	…
hex-ll.c	hex-ll: separate out non-hash-algo functions	2023-09-29 15:14:56 -07:00
hex-ll.h	hex-ll: separate out non-hash-algo functions	2023-09-29 15:14:56 -07:00
hex.c	hex-ll: separate out non-hash-algo functions	2023-09-29 15:14:56 -07:00
hex.h	hex-ll: separate out non-hash-algo functions	2023-09-29 15:14:56 -07:00
hook.c	…
hook.h	…
http-backend.c	http-backend: new rpc-service for git-upload-archive	2024-01-22 07:54:37 -08:00
http-fetch.c	http.h: remove unnecessary include	2023-12-26 12:04:32 -08:00
http-push.c	Merge branch 'eb/hash-transition'	2024-03-28 14:13:50 -07:00
http-walker.c	treewide: remove unnecessary includes in source files	2023-12-26 12:04:31 -08:00
http.c	http: reset POSTFIELDSIZE when clearing curl handle	2024-04-02 13:27:18 -07:00
http.h	http.h: remove unnecessary include	2023-12-26 12:04:32 -08:00
ident.c	Merge branch 'bc/ident-dot-is-no-longer-crud-letter'	2023-08-09 16:18:15 -07:00
ident.h	…
imap-send.c	imap-send: increase command size limit	2024-04-15 11:34:17 -07:00
iterator.h	…
json-writer.c	…
json-writer.h	doc: switch links to https	2023-11-26 10:07:05 +09:00
khash.h	…
kwset.c	doc: switch links to https	2023-11-26 10:07:05 +09:00
kwset.h	doc: switch links to https	2023-11-26 10:07:05 +09:00
levenshtein.c	…
levenshtein.h	…
line-log.c	treewide: remove unnecessary includes in source files	2023-12-26 12:04:33 -08:00
line-log.h	line-log.h: remove unnecessary include	2023-12-26 12:04:32 -08:00
line-range.c	treewide: remove unnecessary includes in source files	2023-12-26 12:04:31 -08:00
line-range.h	…
linear-assignment.c	…
linear-assignment.h	…
list-objects-filter-options.c	treewide: remove unnecessary includes in source files	2023-12-26 12:04:31 -08:00
list-objects-filter-options.h	…
list-objects-filter.c	oidset: refactor oidset_insert_from_set()	2024-02-14 09:39:14 -08:00
list-objects-filter.h	…
list-objects.c	Merge branch 'eb/hash-transition'	2024-03-28 14:13:50 -07:00
list-objects.h	…
list.h	doc: switch links to https	2023-11-26 10:07:05 +09:00
lockfile.c	…
lockfile.h	lockfile: report when rollback fails	2024-03-07 12:34:13 -08:00
log-tree.c	Merge branch 'rs/date-mode-pass-by-value'	2024-04-16 14:50:29 -07:00
log-tree.h	format-patch: return an allocated string from log_write_email_headers()	2024-03-19 17:54:16 -07:00
loose.c	loose: compatibilty short name support	2023-10-02 14:57:38 -07:00
loose.h	loose: add a mapping between SHA-1 and SHA-256 for loose objects	2023-10-02 14:57:38 -07:00
ls-refs.c	treewide: remove unnecessary includes in source files	2023-12-26 12:04:31 -08:00
ls-refs.h	…
mailinfo.c	Merge branch 'jk/mailinfo-iterative-unquote-comment' into maint-2.43	2024-02-08 16:22:03 -08:00
mailinfo.h	…
mailmap.c	…
mailmap.h	…
match-trees.c	tree-walk: init_tree_desc take an oid to get the hash algorithm	2023-10-02 14:57:40 -07:00
match-trees.h	…
mem-pool.c	don't report vsnprintf(3) error as bug	2024-04-21 12:27:07 -07:00
mem-pool.h	mem-pool: add mem_pool_strfmt()	2024-02-26 09:35:40 -08:00
merge-blobs.c	treewide: remove unnecessary includes in source files	2023-12-26 12:04:31 -08:00
merge-blobs.h	…
merge-ll.c	Merge branch 'pw/checkout-conflict-errorfix'	2024-04-01 13:21:33 -07:00
merge-ll.h	merge options: add a conflict style member	2024-03-14 10:08:52 -07:00
merge-ort-wrappers.c	…
merge-ort-wrappers.h	…
merge-ort.c	Merge branch 'pw/checkout-conflict-errorfix'	2024-04-01 13:21:33 -07:00
merge-ort.h	…
merge-recursive.c	Merge branch 'pw/checkout-conflict-errorfix'	2024-04-01 13:21:33 -07:00
merge-recursive.h	merge options: add a conflict style member	2024-03-14 10:08:52 -07:00
merge.c	Merge branch 'eb/hash-transition'	2024-03-28 14:13:50 -07:00
merge.h	…
mergesort.h	…
midx-write.c	midx-write.c: use `--stdin-packs` when repacking	2024-04-01 14:18:17 -07:00
midx.c	Merge branch 'ps/missing-btmp-fix'	2024-04-23 11:52:40 -07:00
midx.h	midx-write: move writing-related functions from midx.c	2024-04-01 14:18:16 -07:00
name-hash.c	name-hash: add index_dir_find()	2024-02-26 15:34:01 -08:00
name-hash.h	name-hash: add index_dir_find()	2024-02-26 15:34:01 -08:00
notes-cache.c	…
notes-cache.h	…
notes-merge.c	commit-reach(repo_get_merge_bases): pass on "missing commits" errors	2024-02-29 08:06:01 -08:00
notes-merge.h	…
notes-utils.c	Merge branch 'en/header-cleanup' into maint-2.43	2024-02-08 16:22:10 -08:00
notes-utils.h	…
notes.c	treewide: remove unnecessary includes in source files	2023-12-26 12:04:31 -08:00
notes.h	…
object-file-convert.c	object-file-convert: convert commits that embed signed tags	2023-10-02 14:57:39 -07:00
object-file-convert.h	object-file-convert: stubs for converting from one object format to another	2023-10-02 14:57:38 -07:00
object-file.c	Merge branch 'eb/hash-transition'	2024-03-28 14:13:50 -07:00
object-file.h	…
object-name.c	Merge branch 'eb/hash-transition'	2024-03-28 14:13:50 -07:00
object-name.h	object-names: support input of oids in any supported hash	2023-10-02 14:57:38 -07:00
object-store-ll.h	object-file: add a compat_oid_in parameter to write_object_file_flags	2023-10-02 14:57:39 -07:00
object-store.h	packfile.c: prevent overflow in `load_idx()`	2023-07-14 09:31:34 -07:00
object.c	Merge branch 'eb/hash-transition'	2024-03-28 14:13:50 -07:00
object.h	Merge branch 'eb/hash-transition'	2024-03-28 14:13:50 -07:00
oid-array.c	oid-array: teach oid-array to handle multiple kinds of oids	2023-10-02 14:57:38 -07:00
oid-array.h	…
oidmap.c	…
oidmap.h	…
oidset.c	oidset: refactor oidset_insert_from_set()	2024-02-14 09:39:14 -08:00
oidset.h	oidset: refactor oidset_insert_from_set()	2024-02-14 09:39:14 -08:00
oidtree.c	…
oidtree.h	…
pack-bitmap-write.c	Merge branch 'eb/hash-transition'	2024-03-28 14:13:50 -07:00
pack-bitmap.c	Merge branch 'ps/missing-btmp-fix'	2024-04-23 11:52:40 -07:00
pack-bitmap.h	pack-bitmap: enable reuse from all bitmapped packs	2023-12-14 14:38:09 -08:00
pack-check.c	treewide: remove unnecessary includes in source files	2023-12-26 12:04:31 -08:00
pack-mtimes.c	…
pack-mtimes.h	…
pack-objects.c	pack-objects: free packing_data in more places	2023-12-14 14:38:07 -08:00
pack-objects.h	pack-objects: free packing_data in more places	2023-12-14 14:38:07 -08:00
pack-revindex.c	pack-revindex: implement `midx_pair_to_pack_pos()`	2023-12-14 14:38:08 -08:00
pack-revindex.h	pack-revindex: implement `midx_pair_to_pack_pos()`	2023-12-14 14:38:08 -08:00
pack-write.c	treewide: remove unnecessary includes in source files	2023-12-26 12:04:31 -08:00
pack.h	…
packfile.c	Merge branch 'eb/hash-transition'	2024-03-28 14:13:50 -07:00
packfile.h	packfile.c: fix a typo in `each_file_in_pack_dir_fn()`'s declaration	2023-11-20 08:15:50 +09:00
pager.c	…
pager.h	…
parallel-checkout.c	…
parallel-checkout.h	…
parse-options-cb.c	parse-options: mark unused parameters in noop callback	2023-09-05 14:48:17 -07:00
parse-options.c	parse-options: rearrange long_name matching code	2024-03-03 09:49:22 -08:00
parse-options.h	parse-options: make CMDMODE errors more precise	2023-10-29 09:15:18 +09:00
parse.c	parse: separate out parsing functions from config.h	2023-09-29 15:14:57 -07:00
parse.h	parse: separate out parsing functions from config.h	2023-09-29 15:14:57 -07:00
patch-delta.c	…
patch-ids.c	treewide: remove unnecessary includes in source files	2023-12-26 12:04:31 -08:00
patch-ids.h	…
path.c	Merge branch 'rs/apply-lift-path-length-limit'	2024-04-15 14:11:42 -07:00
path.h	Merge branch 'rs/apply-lift-path-length-limit'	2024-04-15 14:11:42 -07:00
pathspec.c	attr: enable attr pathspec magic for git-add and git-stash	2023-11-04 17:00:27 +09:00
pathspec.h	…
pkt-line.c	Merge branch 'jx/sideband-chomp-newline-fix' into maint-2.43	2024-02-08 16:22:11 -08:00
pkt-line.h	Merge branch 'jx/sideband-chomp-newline-fix' into maint-2.43	2024-02-08 16:22:11 -08:00
preload-index.c	parse: separate out parsing functions from config.h	2023-09-29 15:14:57 -07:00
preload-index.h	…
pretty.c	Merge branch 'rs/date-mode-pass-by-value'	2024-04-16 14:50:29 -07:00
pretty.h	Merge branch 'rs/date-mode-pass-by-value'	2024-04-16 14:50:29 -07:00
prio-queue.c	…
prio-queue.h	…
progress.c	parse: separate out parsing functions from config.h	2023-09-29 15:14:57 -07:00
progress.h	…
promisor-remote.c	Merge branch 'gc/config-context'	2023-07-06 11:54:48 -07:00
promisor-remote.h	…
prompt.c	parse: separate out parsing functions from config.h	2023-09-29 15:14:57 -07:00
prompt.h	…
protocol-caps.c	treewide: remove unnecessary includes in source files	2023-12-26 12:04:31 -08:00
protocol-caps.h	…
protocol.c	…
protocol.h	doc: switch links to https	2023-11-26 10:07:05 +09:00
prune-packed.c	…
prune-packed.h	…
quote.c	…
quote.h	…
range-diff.c	Merge branch 'kh/range-diff-notes'	2023-09-29 09:04:15 -07:00
range-diff.h	…
reachable.c	prune: mark rebase autostash and orig-head as reachable	2024-02-09 10:04:59 -08:00
reachable.h	…
read-cache-ll.h	revision: optionally record matches with pathspec elements	2024-04-03 14:55:21 -07:00
read-cache.c	revision: optionally record matches with pathspec elements	2024-04-03 14:55:21 -07:00
read-cache.h	…
rebase-interactive.c	strbuf: accept a comment string for strbuf_add_commented_lines()	2024-03-12 13:28:10 -07:00
rebase-interactive.h	…
rebase.c	parse: separate out parsing functions from config.h	2023-09-29 15:14:57 -07:00
rebase.h	…
ref-filter.c	refs: do not check ref existence in `is_root_ref()`	2024-05-15 07:30:52 -07:00
ref-filter.h	for-each-ref: add new option to include root refs	2024-02-23 10:36:28 -08:00
reflog-walk.c	date: make DATE_MODE thread-safe	2024-04-05 15:21:14 -07:00
reflog-walk.h	date: make DATE_MODE thread-safe	2024-04-05 15:21:14 -07:00
reflog.c	Merge branch 'eb/hash-transition'	2024-03-28 14:13:50 -07:00
reflog.h	…
refs.c	refs: do not check ref existence in `is_root_ref()`	2024-05-15 07:30:52 -07:00
refs.h	refs: do not check ref existence in `is_root_ref()`	2024-05-15 07:30:52 -07:00
refspec.c	…
refspec.h	…
remote-curl.c	Merge branch 'jk/libcurl-8.7-regression-workaround'	2024-04-15 14:11:44 -07:00
remote.c	Merge branch 'js/merge-base-with-missing-commit'	2024-03-11 14:12:30 -07:00
remote.h	Merge branch 'jc/retire-cas-opt-name-constant' into maint-2.43	2024-02-08 16:22:09 -08:00
replace-object.c	…
replace-object.h	…
repo-settings.c	pack-objects: enable multi-pack reuse via `feature.experimental`	2024-02-05 15:27:01 -08:00
repository.c	Merge branch 'eb/hash-transition'	2024-03-28 14:13:50 -07:00
repository.h	Merge branch 'eb/hash-transition'	2024-03-28 14:13:50 -07:00
rerere.c	Merge branch 'mr/rerere-crash-fix'	2024-04-23 11:52:41 -07:00
rerere.h	…
reset.c	Merge branch 'js/merge-tree-3-trees'	2024-03-07 15:59:41 -08:00
reset.h	…
resolve-undo.c	Merge branch 'jc/unresolve-removal'	2023-10-02 11:20:00 -07:00
resolve-undo.h	checkout: allow "checkout -m path" to unmerge removed paths	2023-07-31 16:16:44 -07:00
revision.c	Merge branch 'eb/hash-transition'	2024-03-28 14:13:50 -07:00
revision.h	revision: optionally record matches with pathspec elements	2024-04-03 14:55:21 -07:00
run-command.c	run-command: introduce function to prepare auto-maintenance process	2024-04-17 08:42:26 -07:00
run-command.h	run-command: introduce function to prepare auto-maintenance process	2024-04-17 08:42:26 -07:00
sane-ctype.h	…
scalar.c	Merge branch 'ds/scalar-updates' into maint-2.42	2023-11-02 16:53:15 +09:00
send-pack.c	treewide: remove unnecessary includes in source files	2023-12-26 12:04:31 -08:00
send-pack.h	…
sequencer.c	Merge branch 'jk/core-comment-string'	2024-04-05 10:49:49 -07:00
sequencer.h	rebase -i: stop setting GIT_CHERRY_PICK_HELP	2024-02-27 10:33:36 -08:00
serve.c	upload-pack: disallow object-info capability by default	2024-02-28 14:42:01 -08:00
serve.h	…
server-info.c	…
server-info.h	…
setup.c	Merge branch 'eb/hash-transition'	2024-03-28 14:13:50 -07:00
setup.h	Merge branch 'eb/hash-transition'	2024-03-28 14:13:50 -07:00
sh-i18n--envsubst.c	doc: switch links to https	2023-11-26 10:07:05 +09:00
sha1dc_git.c	…
sha1dc_git.h	…
shallow.c	commit-reach(repo_in_merge_bases_many): report missing commits	2024-02-28 09:47:03 -08:00
shallow.h	…
shared.mak	Makefile: simplify output of the libpath_template	2024-01-31 14:43:00 -08:00
shell.c	treewide: remove unnecessary includes in source files	2023-12-26 12:04:31 -08:00
shortlog.h	…
sideband.c	sideband: avoid short write(2)	2024-03-02 11:12:16 -08:00
sideband.h	…
sigchain.c	…
sigchain.h	…
simple-ipc.h	…
sparse-index.c	Merge branch 'jh/sparse-index-expand-to-path-fix'	2024-02-08 13:20:34 -08:00
sparse-index.h	…
split-index.c	…
split-index.h	…
stable-qsort.c	…
statinfo.c	Merge branch 'jc/fake-lstat'	2023-12-27 14:52:24 -08:00
statinfo.h	cache: add fake_lstat()	2023-09-15 17:08:46 -07:00
strbuf.c	don't report vsnprintf(3) error as bug	2024-04-21 12:27:07 -07:00
strbuf.h	Merge branch 'jk/core-comment-string'	2024-04-05 10:49:49 -07:00
streaming.c	…
streaming.h	…
string-list.c	…
string-list.h	…
strmap.c	…
strmap.h	…
strvec.c	strvec: drop unnecessary include of hex.h	2023-11-03 08:26:55 +09:00
strvec.h	strvec: use correct member name in comments	2024-01-12 13:38:07 -08:00
sub-process.c	…
sub-process.h	…
submodule-config.c	config: add --comment option to add a comment	2024-03-15 12:25:35 -07:00
submodule-config.h	Merge branch 'vd/fsck-submodule-url-test'	2024-01-26 08:54:47 -08:00
submodule.c	config: add --comment option to add a comment	2024-03-15 12:25:35 -07:00
submodule.h	…
symlinks.c	…
symlinks.h	…
tag.c	…
tag.h	…
tar.h	…
tempfile.c	lockfile: report when rollback fails	2024-03-07 12:34:13 -08:00
tempfile.h	lockfile: report when rollback fails	2024-03-07 12:34:13 -08:00
thread-utils.c	…
thread-utils.h	…
tmp-objdir.c	treewide: remove unnecessary includes in source files	2023-12-26 12:04:31 -08:00
tmp-objdir.h	…
trace.c	doc: switch links to https	2023-11-26 10:07:05 +09:00
trace.h	…
trace2.c	trace2: emit 'def_param' set with 'cmd_name' event	2024-03-07 10:24:34 -08:00
trace2.h	trace2: fix signature of trace2_def_param() macro	2023-11-23 10:30:32 +09:00
trailer.c	Merge branch 'la/format-trailer-info'	2024-04-23 11:52:39 -07:00
trailer.h	trailer: finish formatting unification	2024-03-15 10:10:25 -07:00
transport-helper.c	Merge branch 'jk/remote-helper-object-format-option-fix'	2024-04-03 10:56:18 -07:00
transport-internal.h	…
transport.c	Merge branch 'es/some-up-to-date-messages-must-stay'	2024-01-26 08:54:45 -08:00
transport.h	…
tree-diff.c	tree-diff: respect max_allowed_tree_depth	2023-08-31 15:51:08 -07:00
tree-walk.c	Merge branch 'eb/hash-transition'	2024-03-28 14:13:50 -07:00
tree-walk.h	Merge branch 'eb/hash-transition'	2024-03-28 14:13:50 -07:00
tree.c	Merge branch 'eb/hash-transition'	2024-03-28 14:13:50 -07:00
tree.h	read_tree(): respect max_allowed_tree_depth	2023-08-31 15:51:08 -07:00
unicode-width.h	unicode: update the width tables to Unicode 15.1	2023-09-25 16:17:28 -07:00
unimplemented.sh	…
unix-socket.c	…
unix-socket.h	…
unix-stream-server.c	…
unix-stream-server.h	…
unpack-trees.c	Merge branch 'cw/prelim-cleanup'	2023-10-10 11:39:14 -07:00
unpack-trees.h	tree-walk: drop MAX_TRAVERSE_TREES macro	2023-08-31 15:51:07 -07:00
upload-pack.c	Merge branch 'jk/upload-pack-v2-capability-cleanup'	2024-03-07 15:59:42 -08:00
upload-pack.h	…
url.c	hex-ll: separate out non-hash-algo functions	2023-09-29 15:14:56 -07:00
url.h	…
urlmatch.c	hex-ll: separate out non-hash-algo functions	2023-09-29 15:14:56 -07:00
urlmatch.h	…
usage.c	usage: report vsnprintf(3) failure	2024-04-05 15:16:27 -07:00
userdiff.c	userdiff: better method/property matching for C#	2024-04-05 15:21:43 -07:00
userdiff.h	…
utf8.c	doc: switch links to https	2023-11-26 10:07:05 +09:00
utf8.h	doc: switch links to https	2023-11-26 10:07:05 +09:00
varint.c	…
varint.h	…
version.c	…
version.h	…
versioncmp.c	…
versioncmp.h	…
walker.c	tree-walk: init_tree_desc take an oid to get the hash algorithm	2023-10-02 14:57:40 -07:00
walker.h	…
wildmatch.c	…
wildmatch.h	…
worktree.c	config: add --comment option to add a comment	2024-03-15 12:25:35 -07:00
worktree.h	worktree: expose interface to look up worktree by name	2024-01-08 13:17:30 -08:00
wrap-for-bin.sh	…
wrapper.c	don't report vsnprintf(3) error as bug	2024-04-21 12:27:07 -07:00
wrapper.h	wrapper: reduce scope of remove_or_warn()	2023-09-29 15:14:56 -07:00
write-or-die.c	write-or-die: fix the polarity of GIT_FLUSH environment variable	2024-02-13 11:57:28 -08:00
write-or-die.h	…
ws.c	…
ws.h	…
wt-status.c	Merge branch 'jk/core-comment-string'	2024-04-05 10:49:49 -07:00
wt-status.h	status: unify parsing of --untracked= and status.showUntrackedFiles	2024-03-13 10:43:32 -07:00
xdiff-interface.c	xdiff-interface: refactor parsing of merge.conflictstyle	2024-03-14 10:08:52 -07:00
xdiff-interface.h	xdiff-interface: refactor parsing of merge.conflictstyle	2024-03-14 10:08:52 -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 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