Go to file

Patrick Steinhardt c1d233bd30 setup: defer object database creation In a subsequent commit we'll make the creation of the on-disk data structures of an object database pluggable. This will lead to an in-between state where we have already configured the repository's object database, but it's not usable yet until we eventually call `create_object_directory()`. Lift the call to `odb_new()` out of `apply_repository_format()` so that callers have more wiggle room with when exactly they call it, and adapt them accordingly. The only exception is `init_db()`, where we now defer creating the object database until we call `create_object_database()`. With this change, initializing and creating the object database on disk is now neatly encapsulated in a single function, which will make it easier for a subsequent commit to move creation of the on-disk data structures into the `struct odb_source` backends. Signed-off-by: Patrick Steinhardt <ps@pks.im> Signed-off-by: Junio C Hamano <gitster@pobox.com>		2026-08-06 21:24:25 -07:00
.github	Merge branch 'js/ci-dockerized-pid-limit'	2026-07-16 23:05:47 -07:00
Documentation	The 7th batch	2026-07-22 10:30:55 -07:00
bin-wrappers	…
block-sha1	…
builtin	Merge branch 'ps/odb-for-each-object-filter'	2026-07-22 10:30:54 -07:00
ci	Merge branch 'ps/reftable-hardening'	2026-07-19 10:42:15 -07:00
compat	Merge branch 'ty/migrate-ignorecase'	2026-07-19 10:42:19 -07:00
compiler-tricks	…
contrib	Merge branch 'sn/osxkeychain-rust-universal'	2026-07-19 10:42:17 -07:00
ewah	…
git-gui	Merge branch 'master' of https://github.com/j6t/git-gui	2026-07-16 10:48:52 -07:00
gitk-git	Merge branch 'master' of https://github.com/j6t/gitk	2026-07-16 10:47:40 -07:00
gitweb	…
mergetools	…
negotiator	…
odb	setup: detangle loading of loose object maps	2026-08-06 21:24:25 -07:00
oss-fuzz	Merge branch 'ps/reftable-hardening'	2026-07-19 10:42:15 -07:00
perl	…
po	Merge branch 'spanish_pr_bis' of github.com:basuradeluis/gitkbis	2026-07-16 10:53:01 +02:00
refs	Merge branch 'kk/reftable-tombstone-quadratic-fix'	2026-07-19 10:42:20 -07:00
reftable	Merge branch 'js/coverity-fixes-null-safety'	2026-07-19 10:42:20 -07:00
sha1	hash: add platform-specific discard functions	2026-07-02 09:50:47 -07:00
sha1collisiondetection@855827c583	…
sha1dc	…
sha256	hash: add platform-specific discard functions	2026-07-02 09:50:47 -07:00
src	…
subprojects	…
t	setup: handle ODB-related environment variables in `odb_new()`	2026-08-06 21:24:25 -07:00
templates	…
tools	hash: convert remaining direct function calls	2026-07-07 21:56:00 -07:00
trace2	hash: use git_hash_init() consistently	2026-07-07 21:56:00 -07:00
xdiff	…
.b4-config	…
.b4-cover-template	b4: include change-id in cover template	2026-07-10 09:49:47 -07:00
.cirrus.yml	…
.clang-format	…
.editorconfig	…
.gitattributes	Merge branch 'kw/gitattributes-typofix'	2026-06-21 16:41:37 -07:00
.gitignore	…
.gitlab-ci.yml	gitlab-ci: enable "GIT_TEST_LONG"	2026-07-06 07:21:57 -07:00
.gitmodules	…
.mailmap	mailmap: map Taylor Blau's work address	2026-07-09 09:43:23 -07:00
.tsan-suppressions	…
CODE_OF_CONDUCT.md	…
COPYING	…
Cargo.toml	…
GIT-BUILD-OPTIONS.in	…
GIT-VERSION-FILE.in	…
GIT-VERSION-GEN	Start Git 2.56 cycle	2026-07-06 15:50:25 -07:00
INSTALL	…
LGPL-2.1	…
Makefile	Merge branch 'sn/osxkeychain-rust-universal'	2026-07-19 10:42:17 -07:00
README.md	README: add GitLab CI badge to make it more discoverable	2026-07-06 07:21:57 -07:00
RelNotes	Start Git 2.56 cycle	2026-07-06 15:50:25 -07:00
SECURITY.md	…
abspath.c	…
abspath.h	…
aclocal.m4	…
add-interactive.c	…
add-interactive.h	…
add-patch.c	…
add-patch.h	…
advice.c	push: suggest <remote> <branch> for a slash slip	2026-06-27 19:36:43 -07:00
advice.h	push: suggest <remote> <branch> for a slash slip	2026-06-27 19:36:43 -07:00
alias.c	…
alias.h	…
alloc.c	…
alloc.h	…
apply.c	Merge branch 'ty/migrate-ignorecase'	2026-07-19 10:42:19 -07:00
apply.h	…
archive-tar.c	…
archive-zip.c	…
archive.c	…
archive.h	…
attr.c	Merge branch 'ps/setup-drop-global-state'	2026-07-06 15:50:19 -07:00
attr.h	…
banned.h	…
base85.c	…
base85.h	…
bisect.c	…
bisect.h	…
blame.c	…
blame.h	…
blob.c	…
blob.h	…
bloom.c	bloom: make bloom-filter slab initialization idempotent	2026-07-01 08:44:06 -07:00
bloom.h	…
branch.c	…
branch.h	…
build.rs	…
builtin.h	…
bundle-uri.c	Merge branch 'tc/bundle-uri-empty-fix'	2026-07-19 10:42:19 -07:00
bundle-uri.h	…
bundle.c	…
bundle.h	…
cache-tree.c	Merge branch 'jt/receive-pack-use-odb-transactions'	2026-07-22 10:30:53 -07:00
cache-tree.h	…
cbtree.c	…
cbtree.h	…
chdir-notify.c	chdir-notify: drop unused `chdir_notify_reparent()`	2026-06-26 08:27:19 -07:00
chdir-notify.h	chdir-notify: drop unused `chdir_notify_reparent()`	2026-06-26 08:27:19 -07:00
checkout.c	…
checkout.h	…
chunk-format.c	…
chunk-format.h	…
color.c	…
color.h	…
column.c	…
column.h	…
combine-diff.c	Merge branch 'js/objects-larger-than-4gb-on-windows-more'	2026-06-21 16:41:38 -07:00
command-list.txt	…
commit-graph.c	Merge branch 'kk/commit-graph-topo-levels-fix'	2026-07-19 10:42:19 -07:00
commit-graph.h	…
commit-reach.c	Merge branch 'kk/commit-reach-find-all-fix'	2026-07-19 10:42:16 -07:00
commit-reach.h	…
commit-slab-decl.h	…
commit-slab-impl.h	…
commit-slab.h	…
commit.c	Merge branch 'kk/prio-queue-get-put-fusion'	2026-07-13 08:27:27 -07:00
commit.h	…
common-exit.c	…
common-init.c	setup: split up concerns of `setup_git_env_internal()`	2026-07-07 10:49:40 -07:00
common-init.h	…
common-main.c	…
config.c	config: add "worktree" and "worktree/i" includeIf conditions	2026-07-10 08:19:15 -07:00
config.h	…
config.mak.dev	…
config.mak.in	…
config.mak.uname	Merge branch 'hn/macos-linker-warning'	2026-06-22 20:05:04 -07:00
configure.ac	…
connect.c	bundle-uri: drain remaining response on invalid bundle-uri lines	2026-07-08 13:54:16 -07:00
connect.h	…
connected.c	connected: search promisor objects generically	2026-06-25 13:20:20 -07:00
connected.h	…
convert.c	…
convert.h	…
copy.c	…
copy.h	…
credential.c	…
credential.h	…
csum-file.c	Merge branch 'jk/hash-algo-leak-fixes'	2026-07-16 23:05:47 -07:00
csum-file.h	Merge branch 'jk/hash-algo-leak-fixes'	2026-07-16 23:05:47 -07:00
ctype.c	…
daemon.c	…
date.c	…
date.h	…
decorate.c	…
decorate.h	…
delta-islands.c	…
delta-islands.h	…
delta.h	…
diagnose.c	…
diagnose.h	…
diff-delta.c	…
diff-lib.c	…
diff-merges.c	…
diff-merges.h	…
diff-no-index.c	…
diff.c	Merge branch 'jk/hash-algo-leak-fixes'	2026-07-16 23:05:47 -07:00
diff.h	…
diffcore-break.c	diffcore-break: guard against NULLed queue entries in merge loop	2026-07-10 08:13:54 -07:00
diffcore-delta.c	…
diffcore-order.c	…
diffcore-pickaxe.c	…
diffcore-rename.c	…
diffcore-rotate.c	…
diffcore.h	…
dir-iterator.c	…
dir-iterator.h	…
dir.c	Merge branch 'ty/migrate-ignorecase'	2026-07-19 10:42:19 -07:00
dir.h	…
editor.c	…
editor.h	…
entry.c	Merge branch 'js/objects-larger-than-4gb-on-windows-more'	2026-06-21 16:41:38 -07:00
entry.h	…
environment.c	Merge branch 'ty/migrate-ignorecase'	2026-07-19 10:42:19 -07:00
environment.h	Merge branch 'ty/migrate-ignorecase'	2026-07-19 10:42:19 -07:00
exec-cmd.c	…
exec-cmd.h	…
fetch-negotiator.c	…
fetch-negotiator.h	…
fetch-pack.c	…
fetch-pack.h	…
fmt-merge-msg.c	…
fmt-merge-msg.h	…
for-each-ref.h	…
fsck.c	…
fsck.h	…
fsmonitor--daemon.h	…
fsmonitor-ipc.c	…
fsmonitor-ipc.h	…
fsmonitor-ll.h	…
fsmonitor-path-utils.h	…
fsmonitor-settings.c	…
fsmonitor-settings.h	…
fsmonitor.c	config: use repo_ignore_case() to access core.ignorecase	2026-06-19 10:04:56 -07:00
fsmonitor.h	…
gettext.c	…
gettext.h	…
git-archimport.perl	…
git-compat-util.h	…
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	zlib: properly clamp to uLong	2026-06-18 09:46:56 -07:00
git-zlib.h	…
git.c	setup: unify setup of shallow file	2026-07-07 10:49:40 -07:00
git.rc.in	…
gpg-interface.c	gpg-interface: fix strip_cr_before_lf to only remove CR before LF	2026-06-24 09:49:05 -07:00
gpg-interface.h	…
graph.c	…
graph.h	…
grep.c	…
grep.h	…
hash-lookup.c	…
hash-lookup.h	…
hash.c	hash: check ctx->active flag in all wrapper functions	2026-07-07 21:56:00 -07:00
hash.h	hash: make git_hash_discard() idempotent	2026-07-07 21:56:00 -07:00
hashmap.c	…
hashmap.h	…
help.c	…
help.h	…
hex-ll.c	…
hex-ll.h	…
hex.c	…
hex.h	…
hook.c	…
hook.h	…
http-backend.c	…
http-fetch.c	…
http-push.c	hash: use git_hash_init() consistently	2026-07-07 21:56:00 -07:00
http-walker.c	…
http.c	Merge branch 'jk/hash-algo-leak-fixes'	2026-07-16 23:05:47 -07:00
http.h	Merge branch 'jk/hash-algo-leak-fixes'	2026-07-16 23:05:47 -07:00
ident.c	…
ident.h	…
imap-send.c	imap-send: avoid leaking the IMAP upload buffer	2026-07-05 09:12:10 -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 'jk/bloom-leak-fixes'	2026-07-15 13:24:19 -07:00
line-log.h	…
line-range.c	…
line-range.h	…
linear-assignment.c	…
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	log: improve --follow following renames for non-linear history	2026-06-22 05:45:09 -07:00
log-tree.h	log: improve --follow following renames for non-linear history	2026-06-22 05:45:09 -07:00
loose.c	setup: detangle loading of loose object maps	2026-08-06 21:24:25 -07:00
loose.h	setup: detangle loading of loose object maps	2026-08-06 21:24:25 -07:00
ls-refs.c	…
ls-refs.h	…
mailinfo.c	…
mailinfo.h	…
mailmap.c	Merge branch 'ps/setup-drop-global-state'	2026-07-06 15:50:19 -07:00
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-harden-against-corrupt-trees'	2026-07-06 15:50:20 -07:00
merge-ort.h	…
merge.c	…
merge.h	…
mergesort.h	…
meson.build	Merge branch 'ps/reftable-hardening'	2026-07-19 10:42:15 -07:00
meson_options.txt	Merge branch 'ps/reftable-hardening'	2026-07-19 10:42:15 -07:00
midx-write.c	Merge branch 'ps/odb-source-packed'	2026-07-06 15:50:21 -07:00
midx.c	odb/source: generalize `reprepare()` callback	2026-06-22 10:41:03 -07:00
midx.h	midx: refactor interfaces to work on "packed" source	2026-06-17 05:00:01 -07:00
name-hash.c	config: use repo_ignore_case() to access core.ignorecase	2026-06-19 10:04:56 -07:00
name-hash.h	…
notes-cache.c	…
notes-cache.h	…
notes-merge.c	…
notes-merge.h	…
notes-utils.c	…
notes-utils.h	…
notes.c	…
notes.h	…
object-file-convert.c	…
object-file-convert.h	…
object-file.c	Merge branch 'jt/receive-pack-use-odb-transactions'	2026-07-22 10:30:53 -07:00
object-file.h	Merge branch 'jt/receive-pack-use-odb-transactions'	2026-07-22 10:30:53 -07:00
object-name.c	Merge branch 'ps/setup-split-discovery-and-setup'	2026-07-19 10:42:15 -07:00
object-name.h	…
object.c	…
object.h	…
odb.c	setup: handle ODB-related environment variables in `odb_new()`	2026-08-06 21:24:25 -07:00
odb.h	setup: handle ODB-related environment variables in `odb_new()`	2026-08-06 21:24:25 -07:00
oid-array.c	…
oid-array.h	…
oidmap.c	…
oidmap.h	…
oidset.c	…
oidset.h	…
oidtree.c	…
oidtree.h	…
pack-bitmap-write.c	Merge branch 'kk/prio-queue-get-put-fusion'	2026-07-13 08:27:27 -07:00
pack-bitmap.c	Merge branch 'ps/odb-for-each-object-filter'	2026-07-22 10:30:54 -07:00
pack-bitmap.h	odb: introduce object filters to `odb_for_each_object()`	2026-07-15 07:19:16 -07:00
pack-check.c	hash: use git_hash_init() consistently	2026-07-07 21:56:00 -07:00
pack-mtimes.c	…
pack-mtimes.h	…
pack-objects.c	…
pack-objects.h	…
pack-refs.c	…
pack-refs.h	…
pack-revindex.c	midx: refactor interfaces to work on "packed" source	2026-06-17 05:00:01 -07:00
pack-revindex.h	…
pack-write.c	hash: use git_hash_init() consistently	2026-07-07 21:56:00 -07:00
pack.h	…
packfile-list.c	…
packfile-list.h	…
packfile.c	Merge branch 'ps/odb-drop-whence'	2026-07-15 13:24:18 -07:00
packfile.h	Merge branch 'ps/odb-source-packed'	2026-07-06 15:50:21 -07:00
pager.c	…
pager.h	…
parallel-checkout.c	…
parallel-checkout.h	…
parse-options-cb.c	…
parse-options.c	parse-options: exit 0 on -h	2026-07-07 17:48:57 -07:00
parse-options.h	parse-options: add a separate case for help output on error	2026-07-07 17:48:56 -07:00
parse.c	…
parse.h	…
patch-delta.c	…
patch-ids.c	…
patch-ids.h	…
path-walk.c	Merge branch 'kk/prio-queue-get-put-fusion'	2026-07-13 08:27:27 -07:00
path-walk.h	…
path.c	path: extract format_path() and use in rev-parse	2026-06-23 21:15:52 -07:00
path.h	Merge branch 'jk/repo-info-path-keys'	2026-07-06 15:50:23 -07: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	Merge branch 'cc/promisor-auto-config-url-more'	2026-07-06 15:50:19 -07:00
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	…
pseudo-merge.h	…
quote.c	…
quote.h	…
range-diff.c	…
range-diff.h	…
reachable.c	treewide: convert users of `whence` to the new source field	2026-07-02 09:52:32 -07:00
reachable.h	…
read-cache-ll.h	read-cache: split out function to drop unmerged entries to stage 0	2026-07-01 09:56:52 -07:00
read-cache.c	Merge branch 'jt/receive-pack-use-odb-transactions'	2026-07-22 10:30:53 -07:00
read-cache.h	…
rebase-interactive.c	…
rebase-interactive.h	…
rebase.c	…
rebase.h	…
ref-filter.c	Merge branch 'td/ref-filter-restore-prefix-iteration'	2026-07-06 15:50:20 -07:00
ref-filter.h	…
reflog-walk.c	…
reflog-walk.h	…
reflog.c	…
reflog.h	…
refs.c	refs: protect against chicken-and-egg recursion	2026-06-26 08:27:19 -07:00
refs.h	refs: move parsing of "core.logAllRefUpdates" back into ref stores	2026-06-26 08:27:19 -07:00
refspec.c	…
refspec.h	…
remote-curl.c	…
remote.c	remote: guard `remote_tracking()` against NULL remote	2026-07-10 08:13:54 -07:00
remote.h	fetch: refactor do_fetch handling of followRemoteHEAD	2026-06-19 09:19:36 -07:00
repack-cruft.c	…
repack-filtered.c	…
repack-geometry.c	midx: refactor interfaces to work on "packed" source	2026-06-17 05:00:01 -07:00
repack-midx.c	midx: refactor interfaces to work on "packed" source	2026-06-17 05:00:01 -07:00
repack-promisor.c	…
repack.c	midx: refactor interfaces to work on "packed" source	2026-06-17 05:00:01 -07:00
repack.h	…
replace-object.c	…
replace-object.h	…
replay.c	Merge branch 'js/coverity-fixes-null-safety'	2026-07-19 10:42:20 -07:00
replay.h	Merge branch 'ps/history-drop'	2026-07-15 13:24:19 -07:00
repo-settings.c	refs: move parsing of "core.logAllRefUpdates" back into ref stores	2026-06-26 08:27:19 -07:00
repo-settings.h	refs: move parsing of "core.logAllRefUpdates" back into ref stores	2026-06-26 08:27:19 -07:00
repository.c	setup: defer object database creation	2026-08-06 21:24:25 -07:00
repository.h	setup: move prefix into repository	2026-07-07 10:49:40 -07:00
rerere.c	hash: use git_hash_init() consistently	2026-07-07 21:56:00 -07:00
rerere.h	…
reset.c	reset: stop assuming that the caller passes in a clean index	2026-07-03 10:32:47 -07:00
reset.h	reset: allow the caller to specify the current HEAD object	2026-07-03 10:32:47 -07:00
resolve-undo.c	…
resolve-undo.h	…
revision.c	Merge branch 'kk/no-walk-pathspec-fix'	2026-07-22 10:30:55 -07:00
revision.h	log: improve --follow following renames for non-linear history	2026-06-22 05:45:09 -07:00
run-command.c	run-command: avoid `close(-1)` in `start_command()` error paths	2026-07-05 09:12:09 -07:00
run-command.h	…
sane-ctype.h	…
scalar.c	…
send-pack.c	…
send-pack.h	…
sequencer.c	Merge branch 'ps/history-drop'	2026-07-15 13:24:19 -07:00
sequencer.h	Merge branch 'pw/status-rebase-todo'	2026-07-06 15:50:23 -07:00
serve.c	…
serve.h	…
server-info.c	…
server-info.h	…
setup.c	setup: defer object database creation	2026-08-06 21:24:25 -07:00
setup.h	setup: defer object database creation	2026-08-06 21:24:25 -07:00
sh-i18n--envsubst.c	…
sha1dc_git.c	…
sha1dc_git.h	…
shallow.c	Merge branch 'js/coverity-fixes-null-safety'	2026-07-19 10:42:20 -07:00
shallow.h	setup: unify setup of shallow file	2026-07-07 10:49:40 -07:00
shared.mak	…
shell.c	…
shortlog.h	…
sideband.c	sideband: allow ANSI SGR with colon-separated subfields	2026-07-07 11:20:44 -07:00
sideband.h	…
sigchain.c	…
sigchain.h	…
simple-ipc.h	…
sparse-index.c	…
sparse-index.h	…
split-index.c	…
split-index.h	…
stable-qsort.c	…
statinfo.c	…
statinfo.h	…
strbuf.c	strbuf: avoid redundant reset in strbuf_getwholeline()	2026-07-14 09:35:02 -07:00
strbuf.h	…
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	Merge branch 'ty/migrate-ignorecase'	2026-07-19 10:42:19 -07:00
submodule.h	…
symlinks.c	…
symlinks.h	…
tag.c	…
tag.h	…
tar.h	…
tempfile.c	…
tempfile.h	…
thread-utils.c	…
thread-utils.h	…
tmp-objdir.c	…
tmp-objdir.h	…
trace.c	setup: move prefix into repository	2026-07-07 10:49:40 -07:00
trace.h	…
trace2.c	…
trace2.h	…
trailer.c	…
trailer.h	…
transport-helper.c	Merge branch 'ps/transport-helper-tsan-fix'	2026-06-17 11:10:11 -07:00
transport-internal.h	…
transport.c	…
transport.h	…
tree-diff.c	…
tree-walk.c	…
tree-walk.h	…
tree.c	…
tree.h	…
unicode-width.h	…
unimplemented.sh	…
unix-socket.c	…
unix-socket.h	…
unix-stream-server.c	…
unix-stream-server.h	…
unpack-trees.c	Merge branch 'ty/migrate-ignorecase'	2026-07-19 10:42:19 -07:00
unpack-trees.h	…
upload-pack.c	…
upload-pack.h	…
url.c	…
url.h	…
urlmatch.c	…
urlmatch.h	…
usage.c	parse-options: exit 0 on -h	2026-07-07 17:48:57 -07:00
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	…
walker.h	…
wildmatch.c	…
wildmatch.h	…
worktree.c	…
worktree.h	…
wrapper.c	…
wrapper.h	…
write-or-die.c	…
write-or-die.h	…
ws.c	…
ws.h	…
wt-status.c	Merge branch 'pw/status-rebase-todo'	2026-07-06 15:50:23 -07:00
wt-status.h	…
xdiff-interface.c	…
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