Go to file

Patrick Steinhardt dcecffb616 refs/files: extract generic symref target checks The consistency checks for the "files" backend contain a couple of verifications for symrefs that verify generic properties of the target reference. These properties need to hold for every backend, no matter whether it's using the "files" or "reftable" backend. Reimplementing these checks for every single backend doesn't really make sense. Extract it into a generic `refs_fsck_symref()` function that can be used by other backends, as well. The "reftable" backend will be wired up in a subsequent commit. While at it, improve the consistency checks so that we don't complain about refs pointing to a non-ref target in case the target refname format does not verify. Otherwise it's very likely that we'll generate both error messages, which feels somewhat redundant in this case. Note that the function has a couple of `UNUSED` parameters. These will become referenced in a subsequent commit. Signed-off-by: Patrick Steinhardt <ps@pks.im> Signed-off-by: Junio C Hamano <gitster@pobox.com>		2026-01-12 06:55:40 -08:00
.github	Merge branch 'js/ci-show-breakage-in-dockerized-jobs'	2025-12-05 14:49:58 +09:00
Documentation	The 16th batch	2026-01-08 16:40:12 +09:00
bin-wrappers	…
block-sha1	…
builtin	Merge branch 'rs/tag-wo-the-repository'	2026-01-08 16:40:11 +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	refs/files: extract generic symref target checks	2026-01-12 06:55:40 -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	refs/files: perform consistency checks for root refs	2026-01-12 06:55:40 -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	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.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	Merge branch 'ar/run-command-hook'	2026-01-06 16:33:53 +09: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 '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	fsck: drop unused fields from `struct fsck_ref_report`	2026-01-12 06:55:40 -08:00
fsck.h	fsck: drop unused fields from `struct fsck_ref_report`	2026-01-12 06:55:40 -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 '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	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.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/files: extract generic symref target checks	2026-01-12 06:55:40 -08:00
refs.h	refs/files: extract generic symref target checks	2026-01-12 06:55:40 -08:00
refspec.c	…
refspec.h	…
remote-curl.c	Merge branch 'js/curl-off-t-fixes' into maint-2.51	2025-10-14 13:40:53 -07:00
remote.c	refs: introduce wrapper struct for `each_ref_fn`	2025-11-04 07:32:24 -08:00
remote.h	…
repack-cruft.c	packfile: introduce macro to iterate through packs	2025-10-16 14:42:39 -07:00
repack-filtered.c	repack: move `write_filtered_pack()` out of the builtin	2025-10-16 10:08:57 -07:00
repack-geometry.c	packfile: introduce macro to iterate through packs	2025-10-16 14:42:39 -07:00
repack-midx.c	refs: expose peeled object ID via the iterator	2025-11-04 07:32:25 -08:00
repack-promisor.c	builtin/repack.c: remove "repack_promisor_objects()" from the builtin	2025-10-16 10:08:55 -07:00
repack.c	packfile: introduce macro to iterate through packs	2025-10-16 14:42:39 -07:00
repack.h	repack: move `write_cruft_pack()` out of the builtin	2025-10-16 10:08:57 -07:00
replace-object.c	refs: introduce wrapper struct for `each_ref_fn`	2025-11-04 07:32:24 -08:00
replace-object.h	…
repo-settings.c	…
repo-settings.h	…
repository.c	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	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	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	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

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