Go to file
Christian Couder d460267613 Add 'promisor-remote' capability to protocol v2
When a server S knows that some objects from a repository are available
from a promisor remote X, S might want to suggest to a client C cloning
or fetching the repo from S that C may use X directly instead of S for
these objects.

Note that this could happen both in the case S itself doesn't have the
objects and borrows them from X, and in the case S has the objects but
knows that X is better connected to the world (e.g., it is in a
$LARGEINTERNETCOMPANY datacenter with petabit/s backbone connections)
than S. Implementation of the latter case, which would require S to
omit in its response the objects available on X, is left for future
improvement though.

Then C might or might not, want to get the objects from X. If S and C
can agree on C using X directly, S can then omit objects that can be
obtained from X when answering C's request.

To allow S and C to agree and let each other know about C using X or
not, let's introduce a new "promisor-remote" capability in the
protocol v2, as well as a few new configuration variables:

  - "promisor.advertise" on the server side, and:
  - "promisor.acceptFromServer" on the client side.

By default, or if "promisor.advertise" is set to 'false', a server S will
not advertise the "promisor-remote" capability.

If S doesn't advertise the "promisor-remote" capability, then a client C
replying to S shouldn't advertise the "promisor-remote" capability
either.

If "promisor.advertise" is set to 'true', S will advertise its promisor
remotes with a string like:

  promisor-remote=<pr-info>[;<pr-info>]...

where each <pr-info> element contains information about a single
promisor remote in the form:

  name=<pr-name>[,url=<pr-url>]

where <pr-name> is the urlencoded name of a promisor remote and
<pr-url> is the urlencoded URL of the promisor remote named <pr-name>.

For now, the URL is passed in addition to the name. In the future, it
might be possible to pass other information like a filter-spec that the
client may use when cloning from S, or a token that the client may use
when retrieving objects from X.

It is C's responsibility to arrange how it can reach X though, so pieces
of information that are usually outside Git's concern, like proxy
configuration, must not be distributed over this protocol.

It might also be possible in the future for "promisor.advertise" to have
other values. For example a value like "onlyName" could prevent S from
advertising URLs, which could help in case C should use a different URL
for X than the URL S is using. (The URL S is using might be an internal
one on the server side for example.)

By default or if "promisor.acceptFromServer" is set to "None", C will
not accept to use the promisor remotes that might have been advertised
by S. In this case, C will not advertise any "promisor-remote"
capability in its reply to S.

If "promisor.acceptFromServer" is set to "All" and S advertised some
promisor remotes, then on the contrary, C will accept to use all the
promisor remotes that S advertised and C will reply with a string like:

  promisor-remote=<pr-name>[;<pr-name>]...

where the <pr-name> elements are the urlencoded names of all the
promisor remotes S advertised.

In a following commit, other values for "promisor.acceptFromServer" will
be implemented, so that C will be able to decide the promisor remotes it
accepts depending on the name and URL it received from S. So even if
that name and URL information is not used much right now, it will be
needed soon.

Helped-by: Taylor Blau <me@ttaylorr.com>
Helped-by: Patrick Steinhardt <ps@pks.im>
Signed-off-by: Christian Couder <chriscool@tuxfamily.org>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
2025-02-18 11:05:37 -08:00
.github Merge branch 'jk/ci-coverity-update' 2025-02-10 10:18:31 -08:00
Documentation Add 'promisor-remote' capability to protocol v2 2025-02-18 11:05:37 -08:00
bin-wrappers Introduce support for the Meson build system 2024-12-07 07:52:14 +09:00
block-sha1 sha1: do not redefine `platform_SHA_CTX` and friends 2024-09-27 11:27:47 -07:00
builtin Merge branch 'bf/fetch-set-head-fix' 2025-02-14 17:53:48 -08:00
ci Merge branch 'ps/zlib-ng' 2025-02-06 14:56:45 -08:00
compat Merge branch 'ps/zlib-ng' 2025-02-06 14:56:45 -08:00
contrib Merge branch 'js/libgit-rust' 2025-02-12 10:08:53 -08:00
ewah global: trivial conversions to fix `-Wsign-compare` warnings 2024-12-06 20:20:04 +09:00
git-gui Merge branch 'master' of https://github.com/j6t/git-gui 2025-01-06 06:51:37 -08:00
gitk-git Merge branch 'master' of https://github.com/j6t/gitk 2025-01-06 06:52:05 -08:00
gitweb Merge branch 'ps/build' 2024-12-15 17:54:33 -08:00
mergetools Merge branch 'ak/typofix-2.46-maint' 2024-10-04 14:21:40 -07:00
negotiator prio-queue: use size_t rather than int for size 2024-12-20 07:21:45 -08:00
oss-fuzz Merge branch 'ps/build-meson-fixes' 2025-02-03 10:23:34 -08:00
perl meson: fix perl dependencies 2025-01-08 08:05:39 -08:00
po Merge branch '2.48-uk-update' of github.com:arkid15r/git-ukrainian-l10n 2025-01-07 15:45:43 +08:00
refs Merge branch 'kn/reflog-migration-fix-followup' 2025-02-14 17:53:48 -08:00
reftable Merge branch 'kn/reflog-migration-fix-followup' 2025-02-14 17:53:48 -08:00
sha1 sha1: do not redefine `platform_SHA_CTX` and friends 2024-09-27 11:27:47 -07:00
sha1collisiondetection@855827c583
sha1dc
sha256
subprojects Introduce support for the Meson build system 2024-12-07 07:52:14 +09:00
t Add 'promisor-remote' capability to protocol v2 2025-02-18 11:05:37 -08:00
templates Introduce support for the Meson build system 2024-12-07 07:52:14 +09:00
trace2 global: adapt callers to use generic hash context helpers 2025-01-31 10:06:11 -08:00
xdiff global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
.cirrus.yml ci: update FreeBSD image to 13.4 2024-09-20 14:40:41 -07:00
.clang-format clang-format: align consecutive macro definitions 2024-10-18 17:37:16 -04:00
.editorconfig editorconfig: add .adoc extension 2025-01-21 12:56:05 -08:00
.gitattributes Remove obsolete ".txt" extensions for AsciiDoc files 2025-01-21 12:56:10 -08:00
.gitignore libgit: add higher-level libgit crate 2025-01-29 15:06:50 -08:00
.gitlab-ci.yml Merge branch 'jt/gitlab-ci-base-fix' 2025-02-10 10:18:30 -08:00
.gitmodules
.mailmap .mailmap document current address. 2024-09-06 09:31:15 -07:00
.tsan-suppressions
CODE_OF_CONDUCT.md
COPYING
GIT-BUILD-OPTIONS.in Merge branch 'ps/3.0-remote-deprecation' 2025-02-03 10:23:33 -08:00
GIT-VERSION-FILE.in Makefile: refactor GIT-VERSION-GEN to be reusable 2024-12-07 07:52:08 +09:00
GIT-VERSION-GEN Merge branch 'ps/build-meson-fixes' 2025-02-03 10:23:34 -08:00
INSTALL Require Perl 5.26.0 2024-10-23 16:16:36 -04:00
LGPL-2.1
Makefile Merge branch 'bc/doc-adoc-not-txt' 2025-02-14 17:53:47 -08:00
README.md
RelNotes doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
SECURITY.md
abspath.c
abspath.h
aclocal.m4
add-interactive.c add-interactive: stop using `the_repository` 2024-12-18 10:44:31 -08:00
add-interactive.h
add-patch.c pager: stop using `the_repository` 2024-12-18 10:44:30 -08:00
advice.c Merge branch 'ps/build-sign-compare' 2024-12-23 09:32:11 -08:00
advice.h fetch set_head: move warn advice into advise_if_enabled 2024-12-06 02:59:16 +09:00
alias.c config: make dependency on repo in `read_early_config()` explicit 2024-09-12 10:15:40 -07:00
alias.h
alloc.c
alloc.h
apply.c Merge branch 'pw/apply-ulong-overflow-check' 2025-02-10 10:18:30 -08:00
apply.h apply: support --ours, --theirs, and --union for three-way merges 2024-09-09 10:07:24 -07:00
archive-tar.c compat/zlib: provide stubs for `deflateSetHeader()` 2025-01-28 13:03:23 -08:00
archive-zip.c
archive.c git-compat-util: move include of "compat/zlib.h" into "git-zlib.h" 2025-01-28 13:03:22 -08:00
archive.h
attr.c Merge branch 'ps/build-sign-compare' 2024-12-23 09:32:11 -08:00
attr.h fuzz: port fuzz-parse-attr-line from OSS-Fuzz 2024-10-16 18:14:11 -04:00
banned.h
base85.c global: trivial conversions to fix `-Wsign-compare` warnings 2024-12-06 20:20:04 +09:00
base85.h
bisect.c commit-reach: use `size_t` to track indices when computing merge bases 2024-12-27 08:12:40 -08:00
bisect.h bisect: fix leaking good/bad terms when reading multipe times 2024-11-21 08:23:40 +09:00
blame.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
blame.h builtin/blame: fix leaking blame entries with `--incremental` 2024-11-21 08:23:40 +09:00
blob.c
blob.h
bloom.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
bloom.h Merge branch 'ak/typofixes' 2024-09-23 10:35:07 -07:00
branch.c Merge branch 'jc/forbid-head-as-tagname' 2024-12-15 17:54:26 -08:00
branch.h
builtin.h builtin: remove USE_THE_REPOSITORY_VARIABLE from builtin.h 2024-09-13 14:32:24 -07:00
bulk-checkin.c Merge branch 'ps/hash-cleanup' 2025-02-10 10:18:31 -08:00
bulk-checkin.h
bundle-uri.c Merge branch 'ps/build-sign-compare' 2024-12-23 09:32:11 -08:00
bundle-uri.h
bundle.c bundle: avoid closing file descriptor twice 2025-01-25 18:38:11 -08:00
bundle.h bundle: avoid closing file descriptor twice 2025-01-25 18:38:11 -08:00
cache-tree.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
cache-tree.h cache-tree: refactor verification to return error codes 2024-10-07 15:08:11 -07:00
cbtree.c cbtree: fix a typo 2024-09-16 10:46:00 -07:00
cbtree.h
chdir-notify.c
chdir-notify.h
check-builtins.sh
checkout.c
checkout.h
chunk-format.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
chunk-format.h
color.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
color.h
column.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
column.h
combine-diff.c tree-diff: drop list-tail argument to diff_tree_paths() 2025-01-09 12:24:26 -08:00
command-list.txt
commit-graph.c Merge branch 'ps/build-sign-compare' 2024-12-23 09:32:11 -08:00
commit-graph.h
commit-reach.c commit-reach: use `size_t` to track indices when computing merge bases 2024-12-27 08:12:40 -08:00
commit-reach.h commit-reach: use `size_t` to track indices when computing merge bases 2024-12-27 08:12:40 -08:00
commit-slab-decl.h
commit-slab-impl.h
commit-slab.h
commit.c commit-reach: use `size_t` to track indices in `get_reachable_subset()` 2024-12-27 08:11:45 -08:00
commit.h commit-reach: use `size_t` to track indices in `get_reachable_subset()` 2024-12-27 08:11:45 -08:00
common-exit.c common-main: split init and exit code into new files 2025-01-28 14:39:16 -08:00
common-init.c common-main: split init and exit code into new files 2025-01-28 14:39:16 -08:00
common-init.h common-main: split init and exit code into new files 2025-01-28 14:39:16 -08:00
common-main.c common-main: split init and exit code into new files 2025-01-28 14:39:16 -08:00
config.c git-compat-util: move include of "compat/zlib.h" into "git-zlib.h" 2025-01-28 13:03:22 -08:00
config.h config: make dependency on repo in `read_early_config()` explicit 2024-09-12 10:15:40 -07:00
config.mak.dev config.mak.dev: drop `-Wno-sign-compare` 2024-12-06 20:20:02 +09:00
config.mak.in
config.mak.uname cmake/vcxproj: stop special-casing `remote-ext` 2024-12-17 12:48:54 -08:00
configure.ac Makefile: consistently use @PLACEHOLDER@ to substitute 2024-12-07 07:52:08 +09:00
connect.c Add 'promisor-remote' capability to protocol v2 2025-02-18 11:05:37 -08:00
connect.h
connected.c packfile: add repository to struct `packed_git` 2024-12-04 08:21:53 +09:00
connected.h
convert.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
convert.h
copy.c
copy.h
credential.c Merge branch 'ps/the-repository' 2025-01-21 08:44:54 -08:00
credential.h Merge branch 'ps/the-repository' 2025-01-21 08:44:54 -08:00
csum-file.c Merge branch 'ps/hash-cleanup' 2025-02-10 10:18:31 -08:00
csum-file.h hash: stop typedeffing the hash context 2025-01-31 10:06:10 -08:00
ctype.c
daemon.c Merge branch 'ps/build-sign-compare' 2024-12-23 09:32:11 -08:00
date.c date.c: Fix type missmatch warings from msvc 2024-12-26 13:34:28 -08:00
date.h
decorate.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
decorate.h
delta-islands.c progress: stop using `the_repository` 2024-12-18 10:44:30 -08:00
delta-islands.h
delta.h
detect-compiler
diagnose.c diagnose: stop using `the_repository` 2024-12-18 10:44:31 -08:00
diagnose.h diagnose: stop using `the_repository` 2024-12-18 10:44:31 -08:00
diff-delta.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
diff-lib.c run_diff_files(): de-mystify the size of combine_diff_path struct 2025-01-09 12:24:24 -08:00
diff-merges.c diff.h: fix index used to loop through unsigned integer 2024-12-06 20:20:03 +09:00
diff-merges.h
diff-no-index.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
diff.c global: adapt callers to use generic hash context helpers 2025-01-31 10:06:11 -08:00
diff.h Merge branch 'ps/hash-cleanup' 2025-02-10 10:18:31 -08:00
diffcore-break.c diff: improve lifecycle management of diff queues 2024-09-30 11:23:05 -07:00
diffcore-delta.c
diffcore-order.c diff.h: fix index used to loop through unsigned integer 2024-12-06 20:20:03 +09:00
diffcore-pickaxe.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
diffcore-rename.c progress: stop using `the_repository` 2024-12-18 10:44:30 -08:00
diffcore-rotate.c diff.h: fix index used to loop through unsigned integer 2024-12-06 20:20:03 +09:00
diffcore.h diff: improve lifecycle management of diff queues 2024-09-30 11:23:05 -07:00
dir-iterator.c
dir-iterator.h
dir.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
dir.h
editor.c
editor.h
entry.c progress: stop using `the_repository` 2024-12-18 10:44:30 -08:00
entry.h
environment.c git-compat-util: move include of "compat/zlib.h" into "git-zlib.h" 2025-01-28 13:03:22 -08:00
environment.h config: make `delta_base_cache_limit` a non-global variable 2024-12-04 08:21:55 +09:00
exec-cmd.c
exec-cmd.h
fetch-negotiator.c
fetch-negotiator.h
fetch-pack.c Merge branch 'kn/pack-write-with-reduced-globals' 2025-02-03 10:23:34 -08:00
fetch-pack.h fetch-pack: split out fsck config parsing 2024-11-28 12:07:58 +09:00
fmt-merge-msg.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
fmt-merge-msg.h
fsck.c fsck: reject misconfigured fsck.skipList 2025-01-07 09:22:25 -08:00
fsck.h ref: add symlink ref content check for files backend 2024-11-21 08:21:34 +09:00
fsmonitor--daemon.h
fsmonitor-ipc.c
fsmonitor-ipc.h
fsmonitor-ll.h
fsmonitor-path-utils.h
fsmonitor-settings.c fsmonitor-settings: fix a typo 2024-09-19 13:46:00 -07:00
fsmonitor-settings.h
fsmonitor.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
fsmonitor.h
generate-cmdlist.sh doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
generate-configlist.sh doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
generate-hooklist.sh doc: use .adoc extension for AsciiDoc files 2025-01-21 12:56:06 -08:00
generate-perl.sh Makefile: use "generate-perl.sh" to massage Perl library 2024-12-07 07:52:10 +09:00
generate-python.sh Makefile: extract script to massage Python scripts 2024-12-07 07:52:10 +09:00
generate-script.sh Makefile: extract script to massage Shell scripts 2024-12-07 07:52:10 +09:00
gettext.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
gettext.h
git-archimport.perl Require Perl 5.26.0 2024-10-23 16:16:36 -04:00
git-compat-util.h Merge branch 'ps/zlib-ng' 2025-02-06 14:56:45 -08:00
git-curl-compat.h git-curl-compat: remove check for curl 7.56.0 2024-10-23 16:16:35 -04:00
git-cvsexportcommit.perl Require Perl 5.26.0 2024-10-23 16:16:36 -04:00
git-cvsimport.perl Require Perl 5.26.0 2024-10-23 16:16:36 -04:00
git-cvsserver.perl Makefile: consistently use @PLACEHOLDER@ to substitute 2024-12-07 07:52:08 +09:00
git-difftool--helper.sh git-difftool--helper.sh: exit upon initialize_merge_tool errors 2024-11-25 11:59:19 +09:00
git-filter-branch.sh
git-instaweb.sh instaweb: fix ip binding for the python http.server 2025-01-10 15:27:52 -08:00
git-merge-octopus.sh
git-merge-one-file.sh
git-merge-resolve.sh
git-mergetool--lib.sh git-mergetool--lib.sh: add error message for unknown tool variant 2024-11-25 11:59:19 +09:00
git-mergetool.sh
git-p4.py git-p4: fix typos 2024-09-19 13:46:00 -07:00
git-quiltimport.sh
git-request-pull.sh Makefile: consistently use PERL_PATH 2024-12-07 07:52:09 +09:00
git-send-email.perl Makefile: consistently use @PLACEHOLDER@ to substitute 2024-12-07 07:52:08 +09:00
git-sh-i18n.sh Makefile: consistently use @PLACEHOLDER@ to substitute 2024-12-07 07:52:08 +09:00
git-sh-setup.sh Makefile: consistently use @PLACEHOLDER@ to substitute 2024-12-07 07:52:08 +09:00
git-submodule.sh git-submodule.sh: rename some variables 2024-12-11 20:46:48 +09:00
git-svn.perl Makefile: consistently use @PLACEHOLDER@ to substitute 2024-12-07 07:52:08 +09:00
git-web--browse.sh
git-zlib.c git-zlib: cast away potential constness of `next_in` pointer 2025-01-28 13:03:23 -08:00
git-zlib.h git-compat-util: move include of "compat/zlib.h" into "git-zlib.h" 2025-01-28 13:03:22 -08:00
git.c Merge branch 'ps/3.0-remote-deprecation' 2025-02-03 10:23:33 -08:00
git.rc.in Makefile: generate "git.rc" via GIT-VERSION-GEN 2024-12-07 07:52:09 +09:00
gpg-interface.c gpg-interface: address -Wsign-comparison warnings 2024-12-06 20:20:04 +09:00
gpg-interface.h gpg-interface: fix misdesigned signing key interfaces 2024-09-05 08:49:11 -07:00
graph.c graph: stop using `the_repository` 2024-12-18 10:44:31 -08:00
graph.h
grep.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
grep.h
hash-lookup.c
hash-lookup.h
hash.h hash: provide generic wrappers to update hash contexts 2025-01-31 10:06:11 -08:00
hashmap.c
hashmap.h
help.c help: add "show" as a valid configuration value 2025-02-03 15:22:05 -08:00
help.h global: trivial conversions to fix `-Wsign-compare` warnings 2024-12-06 20:20:04 +09:00
hex-ll.c
hex-ll.h
hex.c global: trivial conversions to fix `-Wsign-compare` warnings 2024-12-06 20:20:04 +09:00
hex.h
hook.c Merge branch 'bf/explicit-config-set-in-advice-messages' 2024-12-15 17:54:28 -08:00
hook.h
http-backend.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
http-fetch.c http-fetch: clear leaking git-index-pack(1) arguments 2024-09-25 10:24:52 -07:00
http-push.c global: adapt callers to use generic hash context helpers 2025-01-31 10:06:11 -08:00
http-walker.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
http.c global: adapt callers to use generic hash context helpers 2025-01-31 10:06:11 -08:00
http.h hash: stop typedeffing the hash context 2025-01-31 10:06:10 -08:00
ident.c
ident.h
imap-send.c credential: stop using `the_repository` 2024-12-18 10:44:31 -08:00
iterator.h
json-writer.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
json-writer.h
khash.h
kwset.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
kwset.h
levenshtein.c
levenshtein.h
line-log.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
line-log.h
line-range.c
line-range.h
linear-assignment.c
linear-assignment.h
list-objects-filter-options.c global: trivial conversions to fix `-Wsign-compare` warnings 2024-12-06 20:20:04 +09:00
list-objects-filter-options.h
list-objects-filter.c diff.h: fix index used to loop through unsigned integer 2024-12-06 20:20:03 +09:00
list-objects-filter.h
list-objects.c Merge branch 'ps/build-sign-compare' 2024-12-23 09:32:11 -08:00
list-objects.h
list.h
lockfile.c
lockfile.h
log-tree.c tmp-objdir: stop using `the_repository` 2024-12-18 10:44:31 -08:00
log-tree.h rebase-update-refs: extract load_branch_decorations 2024-10-09 10:52:45 -07:00
loose.c loose: don't rely on repository global state 2024-10-09 11:51:31 -07:00
loose.h
ls-refs.c global: trivial conversions to fix `-Wsign-compare` warnings 2024-12-06 20:20:04 +09:00
ls-refs.h
mailinfo.c mailinfo: stop using `the_repository` 2024-12-18 10:44:31 -08:00
mailinfo.h mailinfo: stop using `the_repository` 2024-12-18 10:44:31 -08:00
mailmap.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
mailmap.h check-mailmap: add options for additional mailmap sources 2024-08-27 14:51:29 -07:00
match-trees.c match-trees: stop using `the_repository` 2024-12-18 10:44:31 -08:00
match-trees.h
mem-pool.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
mem-pool.h
merge-blobs.c
merge-blobs.h
merge-ll.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
merge-ll.h
merge-ort-wrappers.c
merge-ort-wrappers.h
merge-ort.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
merge-ort.h
merge-recursive.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
merge-recursive.h
merge.c global: trivial conversions to fix `-Wsign-compare` warnings 2024-12-06 20:20:04 +09:00
merge.h
mergesort.h
meson.build Merge branch 'bc/doc-adoc-not-txt' 2025-02-14 17:53:47 -08:00
meson_options.txt Merge branch 'ps/zlib-ng' 2025-02-06 14:56:45 -08:00
midx-write.c Merge branch 'kn/pack-write-with-reduced-globals' 2025-02-03 10:23:34 -08:00
midx.c Merge branch 'ps/build-sign-compare' 2024-12-23 09:32:11 -08:00
midx.h midx: pass down `hash_algo` to functions using global variables 2024-12-04 10:32:21 +09:00
name-hash.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
name-hash.h
notes-cache.c
notes-cache.h
notes-merge.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
notes-merge.h
notes-utils.c
notes-utils.h
notes.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
notes.h environment: stop storing "core.notesRef" globally 2024-09-12 10:15:44 -07:00
object-file-convert.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
object-file-convert.h
object-file.c Merge branch 'tb/unsafe-hash-cleanup' 2025-02-03 10:23:32 -08:00
object-file.h finalize_object_file(): implement collision check 2024-09-27 11:27:47 -07:00
object-name.c object-name: be more strict in parsing describe-like output 2025-01-13 11:48:43 -08:00
object-name.h
object-store-ll.h packfile: pass down repository to `for_each_packed_object` 2024-12-04 08:21:54 +09:00
object-store.h
object.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
object.h object: clear grafts when clearing parsed object pool 2024-09-05 08:49:11 -07:00
oid-array.c
oid-array.h
oidmap.c
oidmap.h
oidset.c
oidset.h
oidtree.c global: Fix duplicate word typos 2024-10-21 16:05:04 -04:00
oidtree.h
pack-bitmap-write.c progress: stop using `the_repository` 2024-12-18 10:44:30 -08:00
pack-bitmap.c Merge branch 'ps/the-repository' 2025-01-21 08:44:54 -08:00
pack-bitmap.h pack-bitmap: tag bitmapped packs with their corresponding MIDX 2024-08-27 14:50:26 -07:00
pack-check.c global: adapt callers to use generic hash context helpers 2025-01-31 10:06:11 -08:00
pack-mtimes.c
pack-mtimes.h
pack-objects.c
pack-objects.h Merge branch 'ds/name-hash-tweaks' 2025-02-12 10:08:51 -08:00
pack-revindex.c midx: pass down `hash_algo` to functions using global variables 2024-12-04 10:32:21 +09:00
pack-revindex.h
pack-write.c Merge branch 'ps/hash-cleanup' 2025-02-10 10:18:31 -08:00
pack.h Merge branch 'kn/pack-write-with-reduced-globals' 2025-02-03 10:23:34 -08:00
packfile.c Merge branch 'jk/pack-header-parse-alignment-fix' 2025-01-28 13:02:23 -08:00
packfile.h Merge branch 'jk/pack-header-parse-alignment-fix' 2025-01-28 13:02:23 -08:00
pager.c pager: stop using `the_repository` 2024-12-18 10:44:30 -08:00
pager.h pager: stop using `the_repository` 2024-12-18 10:44:30 -08:00
parallel-checkout.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
parallel-checkout.h
parse-options-cb.c
parse-options.c Merge branch 'jc/show-usage-help' 2025-01-28 13:02:22 -08:00
parse-options.h parse-options: introduce die_for_incompatible_opt2() 2025-02-06 12:23:54 -08:00
parse.c
parse.h
patch-delta.c
patch-ids.c diff.h: fix index used to loop through unsigned integer 2024-12-06 20:20:03 +09:00
patch-ids.h
path-walk.c path-walk: drop redundant parse_tree() call 2025-01-22 17:52:44 -08:00
path-walk.h path-walk: mark trees and blobs as UNINTERESTING 2024-12-20 08:37:05 -08:00
path.c Merge branch 'ps/build-sign-compare' 2024-12-23 09:32:11 -08:00
path.h Merge branch 'bc/allow-upload-pack-from-other-people' 2024-12-10 10:04:55 +09:00
pathspec.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
pathspec.h
pkt-line.c global: trivial conversions to fix `-Wsign-compare` warnings 2024-12-06 20:20:04 +09:00
pkt-line.h
preload-index.c progress: stop using `the_repository` 2024-12-18 10:44:30 -08:00
preload-index.h
pretty.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
pretty.h
prio-queue.c prio-queue: use size_t rather than int for size 2024-12-20 07:21:45 -08:00
prio-queue.h prio-queue: fix type of `insertion_ctr` 2024-12-27 08:10:41 -08:00
progress.c progress: stop using `the_repository` 2024-12-18 10:44:30 -08:00
progress.h progress: stop using `the_repository` 2024-12-18 10:44:30 -08:00
promisor-remote.c Add 'promisor-remote' capability to protocol v2 2025-02-18 11:05:37 -08:00
promisor-remote.h Add 'promisor-remote' capability to protocol v2 2025-02-18 11:05:37 -08:00
prompt.c environment: guard state depending on a repository 2024-09-12 10:15:42 -07:00
prompt.h
protocol-caps.c
protocol-caps.h
protocol.c
protocol.h
prune-packed.c progress: stop using `the_repository` 2024-12-18 10:44:30 -08:00
prune-packed.h
pseudo-merge.c progress: stop using `the_repository` 2024-12-18 10:44:30 -08:00
pseudo-merge.h pseudo-merge: fix various memory leaks 2024-09-30 11:23:06 -07:00
quote.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
quote.h
range-diff.c Merge branch 'js/range-diff-diff-merges' 2024-12-23 09:32:17 -08:00
range-diff.h range-diff: optionally include merge commits' diffs in the analysis 2024-12-16 08:45:48 -08:00
reachable.c diff.h: fix index used to loop through unsigned integer 2024-12-06 20:20:03 +09:00
reachable.h
read-cache-ll.h global: Fix duplicate word typos 2024-10-21 16:05:04 -04:00
read-cache.c global: adapt callers to use generic hash context helpers 2025-01-31 10:06:11 -08:00
read-cache.h
rebase-interactive.c
rebase-interactive.h
rebase.c rebase: fix a typo 2024-09-19 13:46:01 -07:00
rebase.h
ref-filter.c Merge branch 'rs/ref-fitler-used-atoms-value-fix' 2025-01-29 14:05:09 -08:00
ref-filter.h ref-filter: remove ref_format_clear() 2025-01-21 09:06:24 -08:00
reflog-walk.c diff.h: fix index used to loop through unsigned integer 2024-12-06 20:20:03 +09:00
reflog-walk.h
reflog.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
reflog.h
refs.c Merge branch 'kn/reflog-migration-fix-followup' 2025-02-14 17:53:48 -08:00
refs.h refs: mark `ref_transaction_update_reflog()` as static 2025-01-22 09:51:35 -08:00
refspec.c Merge branch 'ms/remote-valid-remote-name' 2025-02-12 10:08:54 -08:00
refspec.h Merge branch 'ms/remote-valid-remote-name' 2025-02-12 10:08:54 -08:00
remote-curl.c credential: stop using `the_repository` 2024-12-18 10:44:31 -08:00
remote.c Merge branch 'tc/clone-single-revision' 2025-02-14 17:53:48 -08:00
remote.h Merge branch 'tc/clone-single-revision' 2025-02-14 17:53:48 -08:00
replace-object.c
replace-object.h
repo-settings.c config: make `packed_git_(limit|window_size)` non-global variables 2024-12-04 08:21:55 +09:00
repo-settings.h config: make `packed_git_(limit|window_size)` non-global variables 2024-12-04 08:21:55 +09:00
repository.c worktree: add `relativeWorktrees` extension 2024-12-02 09:36:16 +09:00
repository.h worktree: add `relativeWorktrees` extension 2024-12-02 09:36:16 +09:00
rerere.c global: adapt callers to use generic hash context helpers 2025-01-31 10:06:11 -08:00
rerere.h
reset.c
reset.h
resolve-undo.c resolve-undo: stop using `the_repository` 2024-12-18 10:44:31 -08:00
resolve-undo.h resolve-undo: stop using `the_repository` 2024-12-18 10:44:31 -08:00
revision.c Merge branch 'ps/build-sign-compare' 2024-12-23 09:32:11 -08:00
revision.h revision: fix a typo 2024-09-19 13:46:12 -07:00
run-command.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
run-command.h run-command: fix a typo 2024-09-19 13:46:12 -07:00
sane-ctype.h
scalar.c Merge branch 'ps/leakfixes-0129' 2025-02-06 14:56:45 -08:00
send-pack.c send-pack: stop using `the_repository` 2024-12-18 10:44:30 -08:00
send-pack.h send-pack: stop using `the_repository` 2024-12-18 10:44:30 -08:00
sequencer.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
sequencer.h
serve.c Add 'promisor-remote' capability to protocol v2 2025-02-18 11:05:37 -08:00
serve.h serve: stop using `the_repository` 2024-12-18 10:44:30 -08:00
server-info.c server-info: stop using `the_repository` 2024-12-18 10:44:30 -08:00
server-info.h server-info: stop using `the_repository` 2024-12-18 10:44:30 -08:00
setup.c setup: fix reinit of repos with incompatible GIT_DEFAULT_HASH 2025-01-30 14:36:41 -08:00
setup.h worktree: add `relativeWorktrees` extension 2024-12-02 09:36:16 +09:00
sh-i18n--envsubst.c
sha1dc_git.c
sha1dc_git.h sha1: do not redefine `platform_SHA_CTX` and friends 2024-09-27 11:27:47 -07:00
shallow.c sign-compare: avoid comparing ptrdiff with an int/unsigned 2024-12-27 12:25:30 -08:00
shallow.h shallow: fix -Wsign-compare warnings 2024-12-27 08:12:40 -08:00
shared.mak GIT-VERSION-GEN: fix overriding GIT_BUILT_FROM_COMMIT and GIT_DATE 2024-12-20 12:36:45 -08:00
shell.c shell: fix leaking strings 2024-09-30 11:23:03 -07:00
shortlog.h
sideband.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
sideband.h
sigchain.c
sigchain.h
simple-ipc.h simple-ipc: split async server initialization and running 2024-10-08 12:03:56 -07:00
sparse-index.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
sparse-index.h sparse-checkout: disable advice in 'disable' 2024-09-23 13:19:01 -07:00
split-index.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
split-index.h
stable-qsort.c
statinfo.c environment: guard state depending on a repository 2024-09-12 10:15:42 -07:00
statinfo.h
strbuf.c Git 2.47.2 2025-01-13 12:55:26 -08:00
strbuf.h Git 2.47.2 2025-01-13 12:55:26 -08:00
streaming.c
streaming.h
string-list.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
string-list.h
strmap.c
strmap.h
strvec.c Merge branch 'ps/build-sign-compare' 2024-12-23 09:32:11 -08:00
strvec.h strvec: introduce new `strvec_splice()` function 2024-11-21 08:23:42 +09:00
sub-process.c
sub-process.h
submodule-config.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
submodule-config.h submodule: fix leaking submodule entry list 2024-09-30 11:23:03 -07:00
submodule.c Merge branch 'sk/calloc-not-malloc-plus-memset' 2024-12-23 09:32:18 -08:00
submodule.h submodule: fix leaking update strategy 2024-09-27 08:25:34 -07:00
symlinks.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
symlinks.h
tag.c Merge branch 'ps/build-sign-compare' 2024-12-23 09:32:11 -08:00
tag.h
tar.h
tempfile.c
tempfile.h
thread-utils.c
thread-utils.h Revert barrier-based LSan threading race workaround 2025-01-01 14:13:01 -08:00
tmp-objdir.c tmp-objdir: stop using `the_repository` 2024-12-18 10:44:31 -08:00
tmp-objdir.h tmp-objdir: stop using `the_repository` 2024-12-18 10:44:31 -08:00
trace.c trace: stop using `the_repository` 2024-12-18 10:44:30 -08:00
trace.h trace: stop using `the_repository` 2024-12-18 10:44:30 -08:00
trace2.c Merge branch 'am/trace2-with-valueless-true' 2025-01-29 14:05:10 -08:00
trace2.h refs/reftable: wire up support for exclude patterns 2024-09-16 13:57:19 -07:00
trailer.c global: trivial conversions to fix `-Wsign-compare` warnings 2024-12-06 20:20:04 +09:00
trailer.h trailer: spread usage of "trailer_block" language 2024-10-14 12:33:02 -04:00
transport-helper.c global: trivial conversions to fix `-Wsign-compare` warnings 2024-12-06 20:20:04 +09:00
transport-internal.h
transport.c Merge branch 'js/bundle-unbundle-fd-reuse-fix' 2025-02-06 14:56:44 -08:00
transport.h transport: introduce parse_transport_option() method 2024-10-08 10:22:06 -07:00
tree-diff.c tree-diff: make list tail-passing more explicit 2025-01-09 12:24:27 -08:00
tree-walk.c
tree-walk.h
tree.c
tree.h
unicode-width.h unicode: update the width tables to Unicode 16 2024-09-12 14:20:44 -07:00
unimplemented.sh Makefile: consistently use @PLACEHOLDER@ to substitute 2024-12-07 07:52:08 +09:00
unix-socket.c Merge branch 'ps/leakfixes-0129' 2025-02-06 14:56:45 -08:00
unix-socket.h
unix-stream-server.c
unix-stream-server.h
unpack-trees.c progress: stop using `the_repository` 2024-12-18 10:44:30 -08:00
unpack-trees.h
upload-pack.c Add 'promisor-remote' capability to protocol v2 2025-02-18 11:05:37 -08:00
upload-pack.h
url.c
url.h
urlmatch.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
urlmatch.h
usage.c usage: add show_usage_if_asked() 2025-01-17 13:30:02 -08:00
userdiff.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
userdiff.h
utf8.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
utf8.h utf8.h: squelch unused-parameter warnings with NO_ICONV 2024-10-02 15:52:48 -07:00
varint.c
varint.h
version-def.h.in Makefile: propagate Git version via generated header 2024-12-07 07:52:08 +09:00
version.c meson: ensure correct version-def.h is used 2025-01-14 11:14:54 -08:00
version.h
versioncmp.c global: trivial conversions to fix `-Wsign-compare` warnings 2024-12-06 20:20:04 +09:00
versioncmp.h
walker.c progress: stop using `the_repository` 2024-12-18 10:44:30 -08:00
walker.h http-walker: use object_id instead of bare hash 2024-10-25 17:35:46 -04:00
wildmatch.c
wildmatch.h
worktree.c worktree: detect from secondary worktree if main worktree is bare 2025-02-05 09:46:23 -08:00
worktree.h worktree: add relative cli/config options to `repair` command 2024-12-02 09:36:17 +09:00
wrapper.c wrapper: allow generating insecure random bytes 2025-01-07 09:04:18 -08:00
wrapper.h wrapper: allow generating insecure random bytes 2025-01-07 09:04:18 -08:00
write-or-die.c
write-or-die.h
ws.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
ws.h
wt-status.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
wt-status.h
xdiff-interface.c global: mark code units that generate warnings with `-Wsign-compare` 2024-12-06 20:20:02 +09:00
xdiff-interface.h

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 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