A fork of Git containing Microsoft-specific patches.
Перейти к файлу
Taylor Blau a8dd7e05b1 config: enable `pack.writeReverseIndex` by default
Back in e37d0b8730 (builtin/index-pack.c: write reverse indexes,
2021-01-25), Git learned how to read and write a pack's reverse index
from a file instead of in-memory.

A pack's reverse index is a mapping from pack position (that is, the
order that objects appear together in a ".pack")  to their position in
lexical order (that is, the order that objects are listed in an ".idx"
file).

Reverse indexes are consulted often during pack-objects, as well as
during auxiliary operations that require mapping between pack offsets,
pack order, and index index.

They are useful in GitHub's infrastructure, where we have seen a
dramatic increase in performance when writing ".rev" files[1]. In
particular:

  - an ~80% reduction in the time it takes to serve fetches on a popular
    repository, Homebrew/homebrew-core.

  - a ~60% reduction in the peak memory usage to serve fetches on that
    same repository.

  - a collective savings of ~35% in CPU time across all pack-objects
    invocations serving fetches across all repositories in a single
    datacenter.

Reverse indexes are also beneficial to end-users as well as forges. For
example, the time it takes to generate a pack containing the objects for
the 10 most recent commits in linux.git (representing a typical push) is
significantly faster when on-disk reverse indexes are available:

    $ { git rev-parse HEAD && printf '^' && git rev-parse HEAD~10 } >in
    $ hyperfine -L v false,true 'git.compile -c pack.readReverseIndex={v} pack-objects --delta-base-offset --revs --stdout <in >/dev/null'
    Benchmark 1: git.compile -c pack.readReverseIndex=false pack-objects --delta-base-offset --revs --stdout <in >/dev/null
      Time (mean ± σ):     543.0 ms ±  20.3 ms    [User: 616.2 ms, System: 58.8 ms]
      Range (min … max):   521.0 ms … 577.9 ms    10 runs

    Benchmark 2: git.compile -c pack.readReverseIndex=true pack-objects --delta-base-offset --revs --stdout <in >/dev/null
      Time (mean ± σ):     245.0 ms ±  11.4 ms    [User: 335.6 ms, System: 31.3 ms]
      Range (min … max):   226.0 ms … 259.6 ms    13 runs

    Summary
      'git.compile -c pack.readReverseIndex=true pack-objects --delta-base-offset --revs --stdout <in >/dev/null' ran
	2.22 ± 0.13 times faster than 'git.compile -c pack.readReverseIndex=false pack-objects --delta-base-offset --revs --stdout <in >/dev/null'

The same is true of writing a pack containing the objects for the 30
most-recent commits:

    $ { git rev-parse HEAD && printf '^' && git rev-parse HEAD~30 } >in
    $ hyperfine -L v false,true 'git.compile -c pack.readReverseIndex={v} pack-objects --delta-base-offset --revs --stdout <in >/dev/null'
    Benchmark 1: git.compile -c pack.readReverseIndex=false pack-objects --delta-base-offset --revs --stdout <in >/dev/null
      Time (mean ± σ):     866.5 ms ±  16.2 ms    [User: 1414.5 ms, System: 97.0 ms]
      Range (min … max):   839.3 ms … 886.9 ms    10 runs

    Benchmark 2: git.compile -c pack.readReverseIndex=true pack-objects --delta-base-offset --revs --stdout <in >/dev/null
      Time (mean ± σ):     581.6 ms ±  10.2 ms    [User: 1181.7 ms, System: 62.6 ms]
      Range (min … max):   567.5 ms … 599.3 ms    10 runs

    Summary
      'git.compile -c pack.readReverseIndex=true pack-objects --delta-base-offset --revs --stdout <in >/dev/null' ran
	1.49 ± 0.04 times faster than 'git.compile -c pack.readReverseIndex=false pack-objects --delta-base-offset --revs --stdout <in >/dev/null'

...and savings on trivial operations like computing the on-disk size of
a single (packed) object are even more dramatic:

    $ git rev-parse HEAD >in
    $ hyperfine -L v false,true 'git.compile -c pack.readReverseIndex={v} cat-file --batch-check="%(objectsize:disk)" <in'
    Benchmark 1: git.compile -c pack.readReverseIndex=false cat-file --batch-check="%(objectsize:disk)" <in
      Time (mean ± σ):     305.8 ms ±  11.4 ms    [User: 264.2 ms, System: 41.4 ms]
      Range (min … max):   290.3 ms … 331.1 ms    10 runs

    Benchmark 2: git.compile -c pack.readReverseIndex=true cat-file --batch-check="%(objectsize:disk)" <in
      Time (mean ± σ):       4.0 ms ±   0.3 ms    [User: 1.7 ms, System: 2.3 ms]
      Range (min … max):     1.6 ms …   4.6 ms    1155 runs

    Summary
      'git.compile -c pack.readReverseIndex=true cat-file --batch-check="%(objectsize:disk)" <in' ran
       76.96 ± 6.25 times faster than 'git.compile -c pack.readReverseIndex=false cat-file --batch-check="%(objectsize:disk)" <in'

In the more than two years since e37d0b8730 was merged, Git's
implementation of on-disk reverse indexes has been thoroughly tested,
both from users enabling `pack.writeReverseIndexes`, and from GitHub's
deployment of the feature. The latter has been running without incident
for more than two years.

This patch changes Git's behavior to write on-disk reverse indexes by
default when indexing a pack, which should make the above operations
faster for everybody's Git installation after a repack.

(The previous commit explains some potential drawbacks of using on-disk
reverse indexes in certain limited circumstances, that essentially boil
down to a trade-off between time to generate, and time to access. For
those limited cases, the `pack.readReverseIndex` escape hatch can be
used).

[1]: https://github.blog/2021-04-29-scaling-monorepo-maintenance/#reverse-indexes

Signed-off-by: Taylor Blau <me@ttaylorr.com>
Acked-by: Derrick Stolee <derrickstolee@github.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
2023-04-13 07:55:46 -07:00
.github Merge branch 'tb/ci-concurrency' into maint-2.39 2023-02-14 14:15:46 -08:00
Documentation config: enable `pack.writeReverseIndex` by default 2023-04-13 07:55:46 -07:00
block-sha1
builtin config: enable `pack.writeReverseIndex` by default 2023-04-13 07:55:46 -07:00
ci add: remove "add.interactive.useBuiltin" & Perl "git add--interactive" 2023-02-06 15:03:34 -08:00
compat environment.h: move declarations for environment.c functions from cache.h 2023-03-21 10:56:53 -07:00
contrib Merge branch 'ab/remove-implicit-use-of-the-repository' 2023-04-06 13:38:30 -07:00
ewah alloc.h: move ALLOC_GROW() functions from cache.h 2023-02-23 17:25:28 -08:00
git-gui Makefiles: change search through $(MAKEFLAGS) for GNU make 4.4 2022-12-01 07:24:12 +09:00
gitk-git
gitweb
mergetools
negotiator Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
oss-fuzz treewide: ensure one of the appropriate headers is sourced first 2023-02-23 17:25:28 -08:00
perl Git.pm: trust rev-parse to find bare repositories 2022-10-22 16:39:48 -07:00
po Merge branch 'fz/po-zh_CN' of github.com:fangyi-zhou/git-po 2023-03-10 22:50:14 +08:00
refs write-or-die.h: move declarations for write-or-die.c functions from cache.h 2023-03-21 10:56:54 -07:00
reftable
sha1collisiondetection@855827c583
sha1dc
sha256
t config: enable `pack.writeReverseIndex` by default 2023-04-13 07:55:46 -07:00
templates
trace2 treewide: remove unnecessary includes of cache.h 2023-03-21 10:56:53 -07:00
xdiff xdiff: mark unused parameter in xdl_call_hunk_func() 2022-12-13 22:16:23 +09:00
.cirrus.yml
.clang-format
.editorconfig
.gitattributes .gitattributes: include `text` attribute for eol attributes 2023-02-06 13:57:08 -08:00
.gitignore add: remove "add.interactive.useBuiltin" & Perl "git add--interactive" 2023-02-06 15:03:34 -08:00
.gitmodules
.mailmap mailmap: change primary address for Emily Shaffer 2023-04-07 14:33:52 -07:00
.tsan-suppressions
CODE_OF_CONDUCT.md
COPYING
GIT-VERSION-GEN Start the 2.41 cycle 2023-03-17 14:03:20 -07:00
INSTALL add: remove "add.interactive.useBuiltin" & Perl "git add--interactive" 2023-02-06 15:03:34 -08:00
LGPL-2.1
Makefile doc: remove GNU troff workaround 2023-03-21 13:16:46 -07:00
README.md
RelNotes Start the 2.41 cycle 2023-03-17 14:03:20 -07:00
SECURITY.md
abspath.c abspath.h: move absolute path functions from cache.h 2023-03-21 10:56:52 -07:00
abspath.h abspath.h: move absolute path functions from cache.h 2023-03-21 10:56:52 -07:00
aclocal.m4
add-interactive.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
add-interactive.h
add-patch.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
advice.c Merge branch 'fc/advice-diverged-history' 2023-03-19 15:03:13 -07:00
advice.h Merge branch 'fc/advice-diverged-history' 2023-03-19 15:03:13 -07:00
alias.c alloc.h: move ALLOC_GROW() functions from cache.h 2023-02-23 17:25:28 -08:00
alias.h
alloc.c object.h: stop depending on cache.h; make cache.h depend on object.h 2023-02-23 17:25:29 -08:00
alloc.h alloc.h: move ALLOC_GROW() functions from cache.h 2023-02-23 17:25:28 -08:00
apply.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
apply.h
archive-tar.c write-or-die.h: move declarations for write-or-die.c functions from cache.h 2023-03-21 10:56:54 -07:00
archive-zip.c write-or-die.h: move declarations for write-or-die.c functions from cache.h 2023-03-21 10:56:54 -07:00
archive.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
archive.h archive: add --mtime 2023-02-18 09:29:13 -08:00
attr.c setup.h: move declarations for setup.c functions from cache.h 2023-03-21 10:56:54 -07:00
attr.h attr: fix instructions on how to check attrs 2023-01-26 14:16:48 -08:00
banned.h
base85.c
bisect.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
bisect.h
blame.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
blame.h object.h: stop depending on cache.h; make cache.h depend on object.h 2023-02-23 17:25:29 -08:00
blob.c object.h: stop depending on cache.h; make cache.h depend on object.h 2023-02-23 17:25:29 -08:00
blob.h blob: drop unused parts of parse_blob_buffer() 2022-12-13 22:16:22 +09:00
bloom.c
bloom.h
branch.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
branch.h
builtin.h builtins: annotate always-empty prefix parameters 2023-03-28 14:11:24 -07:00
bulk-checkin.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
bulk-checkin.h treewide: remove unnecessary cache.h inclusion from a few headers 2023-03-21 10:56:50 -07:00
bundle-uri.c Merge branch 'ds/fetch-bundle-uri-with-all' 2023-04-06 13:38:32 -07:00
bundle-uri.h clone: set fetch.bundleURI if appropriate 2023-01-31 08:57:48 -08:00
bundle.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
bundle.h treewide: remove unnecessary cache.h inclusion from a few headers 2023-03-21 10:56:50 -07:00
cache-tree.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
cache-tree.h object.h: stop depending on cache.h; make cache.h depend on object.h 2023-02-23 17:25:29 -08:00
cache.h Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
cbtree.c treewide: ensure one of the appropriate headers is sourced first 2023-02-23 17:25:28 -08:00
cbtree.h treewide: remove unnecessary git-compat-util.h includes in headers 2023-02-23 17:25:28 -08:00
chdir-notify.c abspath.h: move absolute path functions from cache.h 2023-03-21 10:56:52 -07:00
chdir-notify.h
check-builtins.sh
checkout.c cocci: apply the "cache.h" part of "the_repository.pending" 2023-03-28 07:36:36 -07:00
checkout.h treewide: remove unnecessary cache.h includes 2023-02-23 17:25:28 -08:00
chunk-format.c csum-file.h: remove unnecessary inclusion of cache.h 2023-03-21 10:56:55 -07:00
chunk-format.h treewide: remove unnecessary git-compat-util.h includes in headers 2023-02-23 17:25:28 -08:00
color.c treewide: be explicit about dependence on gettext.h 2023-03-21 10:56:51 -07:00
color.h
column.c utf8: fix truncated string lengths in `utf8_strnwidth()` 2022-12-09 14:26:21 +09:00
column.h
combine-diff.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
command-list.txt
commit-graph.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
commit-graph.h Merge branch 'ds/ahead-behind' 2023-04-06 13:38:21 -07:00
commit-reach.c Merge branch 'ab/remove-implicit-use-of-the-repository' 2023-04-06 13:38:30 -07:00
commit-reach.h Merge branch 'ab/remove-implicit-use-of-the-repository' 2023-04-06 13:38:30 -07:00
commit-slab-decl.h
commit-slab-impl.h treewide: remove unnecessary git-compat-util.h includes in headers 2023-02-23 17:25:28 -08:00
commit-slab.h
commit.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
commit.h Merge branch 'ab/remove-implicit-use-of-the-repository' 2023-04-06 13:38:30 -07:00
common-main.c setup.h: move declarations for setup.c functions from cache.h 2023-03-21 10:56:54 -07:00
config.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
config.h Merge branch 'gc/config-parsing-cleanup' 2023-04-06 13:38:29 -07:00
config.mak.dev config.mak.dev: disable suggest braces error on old clang versions 2022-10-10 11:15:31 -07:00
config.mak.in
config.mak.uname Merge branch 'hj/remove-msys-support' 2023-02-09 14:40:47 -08:00
configure.ac
connect.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
connect.h Merge branch 'jk/fix-proto-downgrade-to-v0' 2023-03-28 10:51:52 -07:00
connected.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
connected.h receive-pack: only use visible refs for connectivity check 2022-11-17 16:22:52 -05:00
convert.c wrapper.h: move declarations for wrapper.c functions from cache.h 2023-03-21 10:56:53 -07:00
convert.h
copy.c wrapper.h: move declarations for wrapper.c functions from cache.h 2023-03-21 10:56:53 -07:00
credential.c abspath.h: move absolute path functions from cache.h 2023-03-21 10:56:52 -07:00
credential.h Merge branch 'mc/credential-helper-www-authenticate' 2023-03-17 14:03:10 -07:00
csum-file.c treewide: remove cache.h inclusion due to environment.h changes 2023-03-21 10:56:54 -07:00
csum-file.h csum-file.h: remove unnecessary inclusion of cache.h 2023-03-21 10:56:55 -07:00
ctype.c
daemon.c setup.h: move declarations for setup.c functions from cache.h 2023-03-21 10:56:54 -07:00
date.c treewide: be explicit about dependence on gettext.h 2023-03-21 10:56:51 -07:00
date.h
decorate.c treewide: replace cache.h with more direct headers, where possible 2023-02-23 17:25:30 -08:00
decorate.h
delta-islands.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
delta-islands.h delta-islands: free island_marks and bitmaps 2023-02-03 18:01:46 -08:00
delta.h
detect-compiler
diagnose.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
diagnose.h treewide: remove unnecessary inclusions of parse-options.h from headers 2023-03-20 11:55:18 -07:00
diff-delta.c
diff-lib.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
diff-merges.c object.h: stop depending on cache.h; make cache.h depend on object.h 2023-02-23 17:25:29 -08:00
diff-merges.h
diff-no-index.c abspath.h: move absolute path functions from cache.h 2023-03-21 10:56:52 -07:00
diff.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
diff.h Merge branch 'ab/remove-implicit-use-of-the-repository' 2023-04-06 13:38:30 -07:00
diffcore-break.c cocci: apply the "promisor-remote.h" part of "the_repository.pending" 2023-03-28 07:36:46 -07:00
diffcore-delta.c object.h: stop depending on cache.h; make cache.h depend on object.h 2023-02-23 17:25:29 -08:00
diffcore-order.c treewide: replace cache.h with more direct headers, where possible 2023-02-23 17:25:30 -08:00
diffcore-pickaxe.c pretty.h: move has_non_ascii() declaration from commit.h 2023-02-23 17:25:29 -08:00
diffcore-rename.c Merge branch 'ab/remove-implicit-use-of-the-repository' 2023-04-06 13:38:30 -07:00
diffcore-rotate.c treewide: replace cache.h with more direct headers, where possible 2023-02-23 17:25:30 -08:00
diffcore.h hash.h: move some oid-related declarations from cache.h 2023-02-23 17:25:28 -08:00
dir-iterator.c Merge branch 'en/header-cleanup' 2023-03-17 14:03:09 -07:00
dir-iterator.h dir-iterator: drop unused `DIR_ITERATOR_FOLLOW_SYMLINKS` 2023-02-16 16:21:56 -08:00
dir.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
dir.h Merge branch 'en/header-cleanup' 2023-03-17 14:03:09 -07:00
editor.c environment.h: move declarations for environment.c functions from cache.h 2023-03-21 10:56:53 -07:00
entry.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
entry.h treewide: remove unnecessary cache.h includes 2023-02-23 17:25:28 -08:00
environment.c write-or-die.h: move declarations for write-or-die.c functions from cache.h 2023-03-21 10:56:54 -07:00
environment.h environment.h: move declarations for environment.c functions from cache.h 2023-03-21 10:56:53 -07:00
exec-cmd.c environment.h: move declarations for environment.c functions from cache.h 2023-03-21 10:56:53 -07:00
exec-cmd.h
fetch-negotiator.c
fetch-negotiator.h
fetch-pack.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
fetch-pack.h
fmt-merge-msg.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
fmt-merge-msg.h
fsck.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
fsck.h object.h: stop depending on cache.h; make cache.h depend on object.h 2023-02-23 17:25:29 -08:00
fsmonitor--daemon.h fsmonitor: deal with synthetic firmlinks on macOS 2022-10-05 11:05:23 -07:00
fsmonitor-ipc.c treewide: be explicit about dependence on gettext.h 2023-03-21 10:56:51 -07:00
fsmonitor-ipc.h fsmonitor: relocate socket file if .git directory is remote 2022-10-05 11:05:22 -07:00
fsmonitor-path-utils.h fsmonitor: deal with synthetic firmlinks on macOS 2022-10-05 11:05:23 -07:00
fsmonitor-settings.c alloc.h: move ALLOC_GROW() functions from cache.h 2023-02-23 17:25:28 -08:00
fsmonitor-settings.h fsmonitor: check for compatability before communicating with fsmonitor 2022-10-05 11:05:23 -07:00
fsmonitor.c environment.h: move declarations for environment.c functions from cache.h 2023-03-21 10:56:53 -07:00
fsmonitor.h fsmonitor: avoid overriding `cache_changed` bits 2023-03-27 09:40:39 -07:00
generate-cmdlist.sh
generate-configlist.sh
generate-hooklist.sh
gettext.c treewide: remove cache.h inclusion due to environment.h changes 2023-03-21 10:56:54 -07:00
gettext.h
git-archimport.perl
git-compat-util.h Merge branch 'pe/time-use-gettimeofday' 2023-03-28 10:51:52 -07:00
git-curl-compat.h http: support CURLOPT_PROTOCOLS_STR 2023-02-06 09:27:09 +01:00
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 request-pull: filter out SSH/X.509 tag signatures 2023-01-25 15:54:41 -08:00
git-send-email.perl Merge branch 'jc/spell-id-in-both-caps-in-message-id' 2023-04-11 13:49:12 -07:00
git-sh-i18n.sh
git-sh-setup.sh
git-submodule.sh Merge branch 'ss/pull-v-recurse-fix' 2022-12-28 12:06:17 +09:00
git-svn.perl
git-web--browse.sh
git.c Merge branch 'ws/sparse-check-rules' 2023-04-11 13:49:12 -07:00
git.rc
gpg-interface.c treewide: remove unnecessary includes of cache.h 2023-03-21 10:56:53 -07:00
gpg-interface.h gpg-interface: lazily initialize and read the configuration 2023-02-09 17:01:27 -08:00
graph.c treewide: replace cache.h with more direct headers, where possible 2023-02-23 17:25:30 -08:00
graph.h
grep.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
grep.h grep: work around UTF-8 related JIT bug in PCRE2 <= 10.34 2023-03-23 11:19:34 -07:00
hash-lookup.c
hash-lookup.h
hash.h hash.h: move some oid-related declarations from cache.h 2023-02-23 17:25:28 -08:00
hashmap.c treewide: remove unnecessary cache.h includes in source files 2023-02-23 17:25:28 -08:00
hashmap.h hashmap.h: fix minor typo 2023-03-30 10:18:39 -07:00
help.c Merge branch 'jk/unused-post-2.39-part2' 2023-03-17 14:03:09 -07:00
help.h
hex.c hex.h: move some hex-related declarations from cache.h 2023-02-23 17:25:28 -08:00
hex.h hex.h: move some hex-related declarations from cache.h 2023-02-23 17:25:28 -08:00
hook.c Merge branch 'jk/unused-post-2.39-part2' 2023-03-17 14:03:09 -07:00
hook.h hook API: support passing stdin to hooks, convert am's 'post-rewrite' 2023-02-08 12:50:03 -08:00
http-backend.c write-or-die.h: move declarations for write-or-die.c functions from cache.h 2023-03-21 10:56:54 -07:00
http-fetch.c setup.h: move declarations for setup.c functions from cache.h 2023-03-21 10:56:54 -07:00
http-push.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
http-walker.c Merge branch 'ab/remove-implicit-use-of-the-repository' 2023-04-06 13:38:30 -07:00
http.c Merge branch 'sm/ssl-key-type-config' 2023-04-06 13:38:29 -07:00
http.h Sync with 2.37.6 2023-02-06 09:43:28 +01:00
ident.c ident.h: move ident-related declarations out of cache.h 2023-02-23 17:25:29 -08:00
ident.h ident.h: move ident-related declarations out of cache.h 2023-02-23 17:25:29 -08:00
imap-send.c setup.h: move declarations for setup.c functions from cache.h 2023-03-21 10:56:54 -07:00
iterator.h
json-writer.c treewide: remove unnecessary cache.h includes in source files 2023-02-23 17:25:28 -08:00
json-writer.h
khash.h treewide: remove unnecessary cache.h includes 2023-02-23 17:25:28 -08:00
kwset.c treewide: remove unnecessary cache.h includes in source files 2023-02-23 17:25:28 -08:00
kwset.h
levenshtein.c treewide: remove unnecessary cache.h includes in source files 2023-02-23 17:25:28 -08:00
levenshtein.h
line-log.c treewide: remove cache.h inclusion due to setup.h changes 2023-03-21 10:56:54 -07:00
line-log.h hash.h: move some oid-related declarations from cache.h 2023-02-23 17:25:28 -08:00
line-range.c line-range: fix infinite loop bug with '$' regex 2022-12-20 10:00:43 +09:00
line-range.h
linear-assignment.c treewide: remove unnecessary cache.h includes in source files 2023-02-23 17:25:28 -08:00
linear-assignment.h
list-objects-filter-options.c Merge branch 'ab/remove-implicit-use-of-the-repository' 2023-04-06 13:38:30 -07:00
list-objects-filter-options.h Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
list-objects-filter.c treewide: be explicit about dependence on gettext.h 2023-03-21 10:56:51 -07:00
list-objects-filter.h
list-objects.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
list-objects.h
list.h
ll-merge.c wrapper.h: move declarations for wrapper.c functions from cache.h 2023-03-21 10:56:53 -07:00
ll-merge.h
lockfile.c treewide: remove unnecessary includes of cache.h 2023-03-21 10:56:53 -07:00
lockfile.h
log-tree.c Merge branch 'jc/spell-id-in-both-caps-in-message-id' 2023-04-11 13:49:12 -07:00
log-tree.h
ls-refs.c treewide: remove cache.h inclusion due to environment.h changes 2023-03-21 10:56:54 -07:00
ls-refs.h
mailinfo.c Merge branch 'jc/spell-id-in-both-caps-in-message-id' 2023-04-11 13:49:12 -07:00
mailinfo.h
mailmap.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
mailmap.h
match-trees.c Merge branch 'ab/remove-implicit-use-of-the-repository' 2023-04-06 13:38:30 -07:00
mem-pool.c treewide: remove unnecessary cache.h includes in source files 2023-02-23 17:25:28 -08:00
mem-pool.h
merge-blobs.c Merge branch 'ab/remove-implicit-use-of-the-repository' 2023-04-06 13:38:30 -07:00
merge-blobs.h
merge-ort-wrappers.c treewide: be explicit about dependence on gettext.h 2023-03-21 10:56:51 -07:00
merge-ort-wrappers.h
merge-ort.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
merge-ort.h
merge-recursive.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
merge-recursive.h
merge.c treewide: be explicit about dependence on gettext.h 2023-03-21 10:56:51 -07:00
mergesort.h
midx.c csum-file.h: remove unnecessary inclusion of cache.h 2023-03-21 10:56:55 -07:00
midx.h
name-hash.c environment.h: move declarations for environment.c functions from cache.h 2023-03-21 10:56:53 -07:00
notes-cache.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
notes-cache.h
notes-merge.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
notes-merge.h
notes-utils.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
notes-utils.h
notes.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
notes.h
object-file.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
object-name.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
object-store.h Merge branch 'ab/remove-implicit-use-of-the-repository' 2023-04-06 13:38:30 -07:00
object.c treewide: be explicit about dependence on gettext.h 2023-03-21 10:56:51 -07:00
object.h object.h: stop depending on cache.h; make cache.h depend on object.h 2023-02-23 17:25:29 -08:00
oid-array.c alloc.h: move ALLOC_GROW() functions from cache.h 2023-02-23 17:25:28 -08:00
oid-array.h
oidmap.c treewide: remove unnecessary cache.h includes in source files 2023-02-23 17:25:28 -08:00
oidmap.h treewide: remove unnecessary cache.h includes 2023-02-23 17:25:28 -08:00
oidset.c hex.h: move some hex-related declarations from cache.h 2023-02-23 17:25:28 -08:00
oidset.h
oidtree.c treewide: ensure one of the appropriate headers is sourced first 2023-02-23 17:25:28 -08:00
oidtree.h
pack-bitmap-write.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
pack-bitmap.c pack-revindex: make `load_pack_revindex` take a repository 2023-04-13 07:55:45 -07:00
pack-bitmap.h
pack-check.c environment.h: move declarations for environment.c functions from cache.h 2023-03-21 10:56:53 -07:00
pack-mtimes.c treewide: be explicit about dependence on gettext.h 2023-03-21 10:56:51 -07:00
pack-mtimes.h treewide: remove unnecessary git-compat-util.h includes in headers 2023-02-23 17:25:28 -08:00
pack-objects.c alloc.h: move ALLOC_GROW() functions from cache.h 2023-02-23 17:25:28 -08:00
pack-objects.h
pack-revindex.c pack-revindex: introduce `pack.readReverseIndex` 2023-04-13 07:55:46 -07:00
pack-revindex.h pack-revindex: introduce GIT_TEST_REV_INDEX_DIE_ON_DISK 2023-04-13 07:55:46 -07:00
pack-write.c pack-write.c: plug a leak in stage_tmp_packfiles() 2023-04-13 07:55:45 -07:00
pack.h csum-file.h: remove unnecessary inclusion of cache.h 2023-03-21 10:56:55 -07:00
packfile.c pack-revindex: make `load_pack_revindex` take a repository 2023-04-13 07:55:45 -07:00
packfile.h Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
pager.c
parallel-checkout.c wrapper.h: move declarations for wrapper.c functions from cache.h 2023-03-21 10:56:53 -07:00
parallel-checkout.h
parse-options-cb.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
parse-options.c treewide: remove unnecessary includes of cache.h 2023-03-21 10:56:53 -07:00
parse-options.h Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
patch-delta.c
patch-ids.c treewide: remove unnecessary cache.h inclusion from several sources 2023-03-21 10:56:51 -07:00
patch-ids.h patch-id: use stable patch-id for rebases 2022-10-24 15:44:19 -07:00
path.c treewide: remove cache.h inclusion due to setup.h changes 2023-03-21 10:56:54 -07:00
path.h path.h: move function declarations for path.c functions from cache.h 2023-03-21 10:56:52 -07:00
pathspec.c setup.h: move declarations for setup.c functions from cache.h 2023-03-21 10:56:54 -07:00
pathspec.h dir.h: refactor to no longer need to include cache.h 2023-02-23 17:25:29 -08:00
pkt-line.c write-or-die.h: move declarations for write-or-die.c functions from cache.h 2023-03-21 10:56:54 -07:00
pkt-line.h treewide: remove unnecessary git-compat-util.h includes in headers 2023-02-23 17:25:28 -08:00
preload-index.c environment.h: move declarations for environment.c functions from cache.h 2023-03-21 10:56:53 -07:00
pretty.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
pretty.h Merge branch 'ab/remove-implicit-use-of-the-repository' 2023-04-06 13:38:30 -07:00
prio-queue.c alloc.h: move ALLOC_GROW() functions from cache.h 2023-02-23 17:25:28 -08:00
prio-queue.h
progress.c treewide: remove unnecessary inclusion of gettext.h 2023-03-21 10:56:51 -07:00
progress.h
promisor-remote.c treewide: be explicit about dependence on gettext.h 2023-03-21 10:56:51 -07:00
promisor-remote.h cocci: apply the "promisor-remote.h" part of "the_repository.pending" 2023-03-28 07:36:46 -07:00
prompt.c treewide: remove cache.h inclusion due to environment.h changes 2023-03-21 10:56:54 -07:00
prompt.h
protocol-caps.c Merge branch 'jx/cap-object-info-uninitialized-fix' 2023-04-11 13:49:13 -07:00
protocol-caps.h
protocol.c environment.h: move declarations for environment.c functions from cache.h 2023-03-21 10:56:53 -07:00
protocol.h
prune-packed.c treewide: remove cache.h inclusion due to environment.h changes 2023-03-21 10:56:54 -07:00
prune-packed.h
quote.c treewide: replace cache.h with more direct headers, where possible 2023-02-23 17:25:30 -08:00
quote.h
range-diff.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
range-diff.h
reachable.c treewide: remove cache.h inclusion due to environment.h changes 2023-03-21 10:56:54 -07:00
reachable.h
read-cache.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
rebase-interactive.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
rebase-interactive.h
rebase.c treewide: ensure one of the appropriate headers is sourced first 2023-02-23 17:25:28 -08:00
rebase.h
ref-filter.c Merge branch 'ow/ref-format-remove-unused-member' 2023-04-06 13:38:32 -07:00
ref-filter.h Merge branch 'ow/ref-format-remove-unused-member' 2023-04-06 13:38:32 -07:00
reflog-walk.c alloc.h: move ALLOC_GROW() functions from cache.h 2023-02-23 17:25:28 -08:00
reflog-walk.h treewide: remove unnecessary cache.h includes 2023-02-23 17:25:28 -08:00
reflog.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
reflog.h
refs.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
refs.h Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
refspec.c treewide: remove unnecessary cache.h inclusion from a few headers 2023-03-21 10:56:50 -07:00
refspec.h
remote-curl.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
remote.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
remote.h Merge branch 'sg/parse-options-h-users' 2023-03-30 13:47:11 -07:00
replace-object.c treewide: remove unnecessary cache.h inclusion from several sources 2023-03-21 10:56:51 -07:00
replace-object.h replace-object.h: move read_replace_refs declaration from cache.h to here 2023-02-23 17:25:30 -08:00
repo-settings.c pack-revindex: introduce `pack.readReverseIndex` 2023-04-13 07:55:46 -07:00
repository.c setup.h: move declarations for setup.c functions from cache.h 2023-03-21 10:56:54 -07:00
repository.h pack-revindex: introduce `pack.readReverseIndex` 2023-04-13 07:55:46 -07:00
rerere.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
rerere.h Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
reset.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
reset.h
resolve-undo.c
resolve-undo.h
revision.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
revision.h Merge branch 'ab/remove-implicit-use-of-the-repository' 2023-04-06 13:38:30 -07:00
run-command.c environment.h: move declarations for environment.c functions from cache.h 2023-03-21 10:56:53 -07:00
run-command.h Merge branch 'rs/no-more-run-command-v' 2022-11-08 17:15:12 -05:00
scalar.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
send-pack.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
send-pack.h
sequencer.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
sequencer.h treewide: remove unnecessary cache.h includes 2023-02-23 17:25:28 -08:00
serve.c Merge branch 'jk/unused-post-2.39-part2' 2023-03-17 14:03:09 -07:00
serve.h
server-info.c environment.h: move declarations for environment.c functions from cache.h 2023-03-21 10:56:53 -07:00
setup.c setup.h: move declarations for setup.c functions from cache.h 2023-03-21 10:56:54 -07:00
setup.h setup.h: move declarations for setup.c functions from cache.h 2023-03-21 10:56:54 -07:00
sh-i18n--envsubst.c
sha1dc_git.c treewide: replace cache.h with more direct headers, where possible 2023-02-23 17:25:30 -08:00
sha1dc_git.h Makefile & test-tool: replace "DC_SHA1" variable with a "define" 2022-11-07 22:11:51 -05:00
shallow.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
shallow.h object.h: stop depending on cache.h; make cache.h depend on object.h 2023-02-23 17:25:29 -08:00
shared.mak Merge branch 'ab/gnumake-4.4-fix' 2022-12-01 18:38:07 +09:00
shell.c treewide: remove unnecessary cache.h includes in source files 2023-02-23 17:25:28 -08:00
shortlog.h shortlog: extract `shortlog_finish_setup()` 2022-10-24 14:48:05 -07:00
sideband.c write-or-die.h: move declarations for write-or-die.c functions from cache.h 2023-03-21 10:56:54 -07:00
sideband.h
sigchain.c alloc.h: move ALLOC_GROW() functions from cache.h 2023-02-23 17:25:28 -08:00
sigchain.h
simple-ipc.h
sparse-index.c environment.h: move declarations for environment.c functions from cache.h 2023-03-21 10:56:53 -07:00
sparse-index.h
split-index.c treewide: be explicit about dependence on gettext.h 2023-03-21 10:56:51 -07:00
split-index.h
stable-qsort.c
statinfo.h dir.h: refactor to no longer need to include cache.h 2023-02-23 17:25:29 -08:00
strbuf.c wrapper.h: move declarations for wrapper.c functions from cache.h 2023-03-21 10:56:53 -07:00
strbuf.h post-cocci: adjust comments for recent repo_* migration 2023-03-28 07:36:46 -07:00
streaming.c environment.h: move declarations for environment.c functions from cache.h 2023-03-21 10:56:53 -07:00
streaming.h treewide: remove unnecessary cache.h inclusion from a few headers 2023-03-21 10:56:50 -07:00
string-list.c alloc.h: move ALLOC_GROW() functions from cache.h 2023-02-23 17:25:28 -08:00
string-list.h
strmap.c
strmap.h
strvec.c cache.h: remove dependence on hex.h; make other files include it explicitly 2023-02-23 17:25:29 -08:00
strvec.h
sub-process.c treewide: ensure one of the appropriate headers is sourced first 2023-02-23 17:25:28 -08:00
sub-process.h treewide: remove unnecessary git-compat-util.h includes in headers 2023-02-23 17:25:28 -08:00
submodule-config.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
submodule-config.h hash.h: move some oid-related declarations from cache.h 2023-02-23 17:25:28 -08:00
submodule.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
submodule.h read-tree: add "--super-prefix" option, eliminate global 2022-12-26 10:21:44 +09:00
symlinks.c setup.h: move declarations for setup.c functions from cache.h 2023-03-21 10:56:54 -07:00
tag.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
tag.h
tar.h
tempfile.c treewide: remove unnecessary includes of cache.h 2023-03-21 10:56:53 -07:00
tempfile.h
thread-utils.c treewide: remove unnecessary cache.h includes in source files 2023-02-23 17:25:28 -08:00
thread-utils.h
tmp-objdir.c environment.h: move declarations for environment.c functions from cache.h 2023-03-21 10:56:53 -07:00
tmp-objdir.h replace and remove run_command_v_opt_cd_env() 2022-10-30 14:04:47 -04:00
trace.c setup.h: move declarations for setup.c functions from cache.h 2023-03-21 10:56:54 -07:00
trace.h Merge branch 'en/header-cleanup' 2023-03-17 14:03:09 -07:00
trace2.c treewide: remove unnecessary cache.h includes in source files 2023-02-23 17:25:28 -08:00
trace2.h trace2: add global counter mechanism 2022-10-24 12:45:26 -07:00
trailer.c treewide: remove cache.h inclusion due to environment.h changes 2023-03-21 10:56:54 -07:00
trailer.h
transport-helper.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
transport-internal.h clone: request the 'bundle-uri' command when available 2022-12-25 16:24:23 +09:00
transport.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
transport.h treewide: remove unnecessary cache.h inclusion from a few headers 2023-03-21 10:56:50 -07:00
tree-diff.c
tree-walk.c treewide: be explicit about dependence on gettext.h 2023-03-21 10:56:51 -07:00
tree-walk.h hash.h: move some oid-related declarations from cache.h 2023-02-23 17:25:28 -08:00
tree.c Merge branch 'ab/remove-implicit-use-of-the-repository' 2023-04-06 13:38:30 -07:00
tree.h
unicode-width.h unicode: update the width tables to Unicode 15 2023-03-30 13:06:12 -07:00
unimplemented.sh
unix-socket.c treewide: replace cache.h with more direct headers, where possible 2023-02-23 17:25:30 -08:00
unix-socket.h
unix-stream-server.c treewide: remove unnecessary cache.h includes in source files 2023-02-23 17:25:28 -08:00
unix-stream-server.h
unpack-trees.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
unpack-trees.h unpack-trees: add usage notices around df_conflict_entry 2023-02-27 08:29:51 -08:00
upload-pack.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
upload-pack.h
url.c treewide: replace cache.h with more direct headers, where possible 2023-02-23 17:25:30 -08:00
url.h
urlmatch.c treewide: replace cache.h with more direct headers, where possible 2023-02-23 17:25:30 -08:00
urlmatch.h
usage.c treewide: remove unnecessary includes of cache.h 2023-03-21 10:56:53 -07:00
userdiff.c Merge branch 'en/header-cleanup' 2023-03-17 14:03:09 -07:00
userdiff.h diff: teach diff to read algorithm from diff driver 2023-02-21 09:29:10 -08:00
utf8.c Sync with Git 2.31.6 2022-12-13 21:09:40 +09:00
utf8.h Sync with Git 2.31.6 2022-12-13 21:09:40 +09:00
varint.c
varint.h
version.c
version.h
versioncmp.c config API: add "string" version of *_value_multi(), fix segfaults 2023-03-28 07:37:53 -07:00
walker.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
walker.h
wildmatch.c Merge branch 'pw/wildmatch-fixes' 2023-04-04 14:28:27 -07:00
wildmatch.h wildmatch: hide internal return values 2023-03-20 10:58:53 -07:00
worktree.c treewide: remove cache.h inclusion due to setup.h changes 2023-03-21 10:56:54 -07:00
worktree.h Merge branch 'rj/avoid-switching-to-already-used-branch' 2023-03-19 15:03:11 -07:00
wrap-for-bin.sh
wrapper.c wrapper.h: move declarations for wrapper.c functions from cache.h 2023-03-21 10:56:53 -07:00
wrapper.h wrapper.h: move declarations for wrapper.c functions from cache.h 2023-03-21 10:56:53 -07:00
write-or-die.c write-or-die.h: move declarations for write-or-die.c functions from cache.h 2023-03-21 10:56:54 -07:00
write-or-die.h write-or-die.h: move declarations for write-or-die.c functions from cache.h 2023-03-21 10:56:54 -07:00
ws.c Merge branch 'kn/attr-from-tree' 2023-01-23 13:39:51 -08:00
wt-status.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
wt-status.h
xdiff-interface.c Merge branch 'en/header-split-cleanup' 2023-04-06 13:38:31 -07:00
xdiff-interface.h treewide: remove unnecessary cache.h includes 2023-02-23 17:25:28 -08:00
zlib.c

README.md

Build status

Git - fast, scalable, distributed revision control system

Git is a fast, scalable, distributed revision control system with an unusually rich command set that provides both high-level operations and full access to internals.

Git is an Open Source project covered by the GNU General Public License version 2 (some parts of it are under different licenses, compatible with the GPLv2). It was originally written by Linus Torvalds with help of a group of hackers around the net.

Please read the file INSTALL for installation instructions.

Many Git online resources are accessible from https://git-scm.com/ including full documentation and Git related tools.

See Documentation/gittutorial.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