kernel
/
git
mirror of https://git.kernel.org/pub/scm/git/git.git
1
0
Fork 0
Code Releases Activity
78,765 Commits
7 Branches
1,000 Tags
174 MiB
C 50.5%
Shell 38.8%
Perl 4.4%
Tcl 3.2%
Python 0.8%
Other 2.1%
 
 
 
 
 
 
Go to file
Patrick Steinhardt 7ec85185b1 object: add flag to `peel_object()` to verify object type 
When peeling a tag to a non-tag object we repeatedly call
`parse_object()` on the tagged object until we find the first object
that isn't a tag. While this feels sensible at first, there is a big
catch here: `parse_object()` doesn't actually verify the type of the
tagged object.

The relevant code path here eventually ends up in `parse_tag_buffer()`.
Here, we parse the various fields of the tag, including the "type". Once
we've figured out the type and the tagged object ID, we call one of the
`lookup_${type}()` functions for whatever type we have found. There is
two possible outcomes in the successful case:

  1. The object is already part of our cached objects. In that case we
     double-check whether the type we're trying to look up matches the
     type that was cached.

  2. The object is _not_ part of our cached objects. In that case, we
     simply create a new object with the expected type, but we don't
     parse that object.

In the first case we might notice type mismatches, but only in the case
where our cache has the object with the correct type. In the second
case, we'll blindly assume that the type is correct and then go with it.
We'll only notice that the type might be wrong when we try to parse the
object at a later point.

Now arguably, we could change `parse_tag_buffer()` to verify the tagged
object's type for us. But that would have the effect that such a tag
cannot be parsed at all anymore, and we have a small bunch of tests for
exactly this case that assert we still can open such tags. So this
change does not feel like something we can retroactively tighten, even
though one shouldn't ever hit such corrupted tags.

Instead, add a new `flags` field to `peel_object()` that allows the
caller to opt in to strict object verification. This will be wired up at
a subset of callsites over the next few commits.

Note that this change also inlines `deref_tag_noverify()`. There's only
been two callsites of that function, the one we're changing and one in
our test helpers. The latter callsite can trivially use `deref_tag()`
instead, so by inlining the function we avoid having to pass down the
flag.

Signed-off-by: Patrick Steinhardt <ps@pks.im>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
 		2025-11-04 07:32:25 -08:00
.github ci: convert "pedantic" job into full build with breaking changes 2025-10-02 09:32:32 -07:00
Documentation Merge branch 'jt/repo-structure' into ps/ref-peeled-tags 2025-10-22 07:47:24 -07:00
bin-wrappers
…
block-sha1
…
builtin builtin/show-ref: convert to use `reference_get_peeled_oid()` 2025-11-04 07:32:25 -08:00
ci Merge branch 'ps/ci-avoid-broken-sudo-on-ubuntu' 2025-10-13 22:00:35 -07:00
compat mingw: order `#include`s alphabetically 2025-10-09 13:21:28 -07:00
compiler-tricks intialize false_but_the_compiler_does_not_know_it_ 2025-05-07 09:11:47 -07:00
contrib Merge branch 'ps/meson-build-docs' 2025-10-02 12:26:12 -07:00
ewah ewah: implement `struct ewah_or_iterator` 2025-03-21 04:34:04 -07:00
git-gui Merge branch 'master' of https://github.com/j6t/git-gui 2025-09-10 14:28:23 -07:00
gitk-git Merge branch 'master' of https://github.com/j6t/gitk 2025-10-05 13:32:47 -07:00
gitweb meson: distinguish build and target host binaries 2025-04-01 02:20:44 -07:00
mergetools doc: update references to renamed AsciiDoc files 2025-06-06 15:05:47 -07:00
negotiator refs: introduce wrapper struct for `each_ref_fn` 2025-11-04 07:32:24 -08:00
oss-fuzz commit-graph: refactor `parse_commit_graph()` to take a repository 2025-08-15 09:34:47 -07:00
perl contrib: better support symbolic port names in git-credential-netrc 2025-06-25 09:43:59 -07:00
po git-gui: sync Makefiles with git.git 2025-09-06 11:59:48 +02:00
refs object: add flag to `peel_object()` to verify object type 2025-11-04 07:32:25 -08:00
reftable Merge branch 'kn/reftable-consistency-checks' 2025-10-13 22:00:35 -07:00
sha1
…
sha1collisiondetection@855827c583
…
sha1dc
…
sha256
…
src varint: reimplement as test balloon for Rust 2025-10-02 09:32:32 -07:00
subprojects meson: update subproject wrappers 2025-07-11 09:56:34 -07:00
t object: add flag to `peel_object()` to verify object type 2025-11-04 07:32:25 -08:00
templates meson: distinguish build and target host binaries 2025-04-01 02:20:44 -07:00
trace2 trace2: do not use strbuf_split*() 2025-08-02 22:44:58 -07:00
xdiff Merge branch 'en/xdiff-cleanup' 2025-10-14 12:56:09 -07:00
.cirrus.yml ci: update FreeBSD image to 14.3 2025-07-01 07:46:22 -07:00
.clang-format clang-format: exclude control macros from SpaceBeforeParens 2025-09-28 08:37:23 -07:00
.editorconfig
…
.gitattributes git-gui: wire up support for the Meson build system 2025-05-13 08:48:09 +02:00
.gitignore Merge branch 'ps/rust-balloon' 2025-10-08 12:17:55 -07:00
.gitlab-ci.yml Merge branch 'ps/gitlab-ci-windows-improvements' 2025-10-10 12:51:46 -07:00
.gitmodules
…
.mailmap mailmap: change primary address for Jonathan Tan 2025-10-07 10:38:21 -07:00
.tsan-suppressions
…
CODE_OF_CONDUCT.md
…
COPYING
…
Cargo.toml meson: add infrastructure to build internal Rust library 2025-10-02 09:32:31 -07:00
GIT-BUILD-OPTIONS.in
…
GIT-VERSION-FILE.in
…
GIT-VERSION-GEN Git 2.51.1 2025-10-15 10:29:35 -07:00
INSTALL
…
LGPL-2.1
…
Makefile Merge branch 'tb/incremental-midx-part-3.1' into ps/ref-peeled-tags 2025-10-22 07:47:01 -07:00
README.md gitk: add README with usage, build, and contribution details 2025-08-28 19:51:31 +02:00
RelNotes Prepare for 2.51.1 2025-10-14 13:43:25 -07:00
SECURITY.md
…
abspath.c
…
abspath.h
…
aclocal.m4
…
add-interactive.c Merge branch 'sj/string-list' 2025-10-14 12:56:08 -07:00
add-interactive.h add-interactive: retain colorbool values longer 2025-09-16 18:00:25 -07:00
add-patch.c Merge branch 'rs/add-patch-options-fix' 2025-10-17 14:02:17 -07:00
advice.c initial branch: give hints after switching the default name 2025-09-18 11:44:47 -07:00
advice.h initial branch: give hints after switching the default name 2025-09-18 11:44:47 -07:00
alias.c
…
alias.h
…
alloc.c alloc: fix dangling pointer in alloc_state cleanup 2025-09-04 15:24:16 -07:00
alloc.h alloc: fix dangling pointer in alloc_state cleanup 2025-09-04 15:24:16 -07:00
apply.c Merge branch 'ps/object-file-wo-the-repository' 2025-08-05 11:53:55 -07:00
apply.h
…
archive-tar.c config: drop `git_config()` wrapper 2025-07-23 08:15:18 -07:00
archive-zip.c archive: flush deflate stream until Z_STREAM_END 2025-08-04 13:36:35 -07:00
archive.c config: drop `git_config_get_bool()` wrapper 2025-07-23 08:15:20 -07:00
archive.h
…
attr.c odb: rename `repo_read_object_file()` 2025-07-01 14:46:38 -07:00
attr.h
…
banned.h
…
base85.c
…
base85.h
…
bisect.c refs: introduce wrapper struct for `each_ref_fn` 2025-11-04 07:32:24 -08:00
bisect.h rev-list: make "struct rev_list_info" static to the only user 2025-07-21 15:40:46 -07:00
blame.c blame: drop explicit check for commit graph 2025-09-04 16:16:21 -07:00
blame.h
…
blob.c
…
blob.h
…
bloom.c commit-graph: return commit graph from `repo_find_commit_pos_in_graph()` 2025-09-04 16:16:22 -07:00
bloom.h bloom: replace struct bloom_key * with struct bloom_keyvec 2025-07-14 10:03:03 -07:00
branch.c config: drop `git_config_get_multivar_gently()` wrapper 2025-07-23 08:15:21 -07:00
branch.h
…
builtin.h Merge branch 'tc/last-modified' 2025-09-08 14:54:35 -07:00
bulk-checkin.c Merge branch 'ps/packfile-store' into tb/incremental-midx-part-3.1 2025-09-29 09:31:08 -07:00
bundle-uri.c Merge branch 'ps/object-store' 2025-07-15 15:18:18 -07:00
bundle-uri.h
…
bundle.c Merge branch 'bc/use-sha256-by-default-in-3.0' 2025-07-21 09:14:25 -07:00
bundle.h
…
cache-tree.c odb: add transaction interface 2025-09-16 11:37:06 -07:00
cache-tree.h
…
cbtree.c
…
cbtree.h
…
chdir-notify.c
…
chdir-notify.h
…
check-builtins.sh
…
checkout.c config: drop `git_config_get_string()` wrapper 2025-07-23 08:15:19 -07:00
checkout.h
…
chunk-format.c
…
chunk-format.h
…
color.c color: return bool from want_color() 2025-09-16 18:00:25 -07:00
color.h color: return bool from want_color() 2025-09-16 18:00:25 -07:00
column.c
…
column.h
…
combine-diff.c Merge branch 'tc/last-modified-recursive-fix' 2025-09-29 11:40:35 -07:00
command-list.txt Merge branch 'tc/last-modified' 2025-09-08 14:54:35 -07:00
commit-graph.c refs: expose peeled object ID via the iterator 2025-11-04 07:32:25 -08:00
commit-graph.h commit-graph: return commit graph from `repo_find_commit_pos_in_graph()` 2025-09-04 16:16:22 -07:00
commit-reach.c
…
commit-reach.h
…
commit-slab-decl.h
…
commit-slab-impl.h
…
commit-slab.h
…
commit.c Merge branch 'ps/remote-rename-fix' 2025-08-21 13:46:58 -07:00
commit.h Merge branch 'lm/add-p-context' 2025-08-04 08:10:33 -07:00
common-exit.c
…
common-init.c
…
common-init.h
…
common-main.c
…
config.c Merge branch 'jc/optional-path' 2025-10-14 12:56:09 -07:00
config.h Merge branch 'ps/config-wo-the-repository' 2025-08-04 08:10:33 -07:00
config.mak.dev Merge branch 'js/comma-semicolon-confusion' 2025-04-15 13:50:17 -07:00
config.mak.in
…
config.mak.uname Merge branch 'bs/config-mak-freebsd' 2025-07-14 11:19:23 -07:00
configure.ac Merge branch 'rj/freebsd-sysinfo-build-fix' 2025-07-14 11:19:28 -07:00
connect.c Merge branch 'jc/string-list-split' 2025-08-21 13:46:59 -07:00
connect.h
…
connected.c packfile: refactor `get_all_packs()` to work on packfile store 2025-09-24 11:53:51 -07:00
connected.h
…
convert.c config: drop `git_config()` wrapper 2025-07-23 08:15:18 -07:00
convert.h
…
copy.c
…
copy.h
…
credential.c
…
credential.h
…
csum-file.c
…
csum-file.h
…
ctype.c
…
daemon.c Merge branch 'ps/config-wo-the-repository' 2025-08-04 08:10:33 -07:00
date.c
…
date.h
…
decorate.c
…
decorate.h
…
delta-islands.c refs: introduce wrapper struct for `each_ref_fn` 2025-11-04 07:32:24 -08:00
delta-islands.h
…
delta.h
…
detect-compiler detect-compiler: detect clang even if it found CUDA 2025-03-28 17:38:12 -07:00
diagnose.c odb: get rid of `the_repository` in `for_each()` functions 2025-07-01 14:46:36 -07:00
diagnose.h
…
diff-delta.c diff-delta: avoid using the comma operator 2025-03-28 17:38:10 -07:00
diff-lib.c diff: teach tree-diff a max-depth parameter 2025-08-07 15:29:35 -07:00
diff-merges.c
…
diff-merges.h
…
diff-no-index.c diff --no-index: fix logic for paths ending in '/' 2025-09-25 11:35:20 -07:00
diff.c Merge branch 'jk/color-variable-fixes' 2025-09-29 11:40:35 -07:00
diff.h Merge branch 'tc/last-modified-recursive-fix' 2025-09-29 11:40:35 -07:00
diffcore-break.c
…
diffcore-delta.c
…
diffcore-order.c
…
diffcore-pickaxe.c
…
diffcore-rename.c object-store: move function declarations to their respective subsystems 2025-04-29 10:08:12 -07:00
diffcore-rotate.c
…
diffcore.h
…
dir-iterator.c
…
dir-iterator.h
…
dir.c varint: use explicit width for integers 2025-10-02 09:32:32 -07:00
dir.h dir: move starts_with_dot(_dot)_slash to dir.h 2025-06-23 16:38:56 -07:00
editor.c config: drop `git_config_get_string()` wrapper 2025-07-23 08:15:19 -07:00
editor.h
…
entry.c odb: rename `repo_read_object_file()` 2025-07-01 14:46:38 -07:00
entry.h
…
environment.c Merge branch 'pw/3.0-commentchar-auto-deprecation' 2025-09-18 10:07:00 -07:00
environment.h config: warn on core.commentString=auto 2025-08-26 08:52:44 -07:00
exec-cmd.c
…
exec-cmd.h
…
fetch-negotiator.c
…
fetch-negotiator.h
…
fetch-pack.c refs: introduce wrapper struct for `each_ref_fn` 2025-11-04 07:32:24 -08:00
fetch-pack.h
…
fmt-merge-msg.c Merge branch 'ac/deglobal-fmt-merge-log-config' 2025-08-22 13:13:21 -07:00
fmt-merge-msg.h environment: remove the global variable 'merge_log_config' 2025-08-11 09:16:55 -07:00
for-each-ref.h Merge branch 'ja/doc-lint-sections-and-synopsis' 2025-08-25 14:22:02 -07:00
fsck.c config: move Git config parsing into "environment.c" 2025-07-23 08:15:22 -07:00
fsck.h refs/reftable: add fsck check for checking the table name 2025-10-07 09:22:58 -07:00
fsmonitor--daemon.h
…
fsmonitor-ipc.c
…
fsmonitor-ipc.h
…
fsmonitor-ll.h
…
fsmonitor-path-utils.h
…
fsmonitor-settings.c
…
fsmonitor-settings.h
…
fsmonitor.c config: drop `git_config_get_int()` wrapper 2025-07-23 08:15:20 -07:00
fsmonitor.h
…
generate-cmdlist.sh
…
generate-configlist.sh Merge branch 'jc/sed-build-fixes' 2025-06-13 13:29:14 -07:00
generate-hooklist.sh
…
generate-perl.sh
…
generate-python.sh
…
generate-script.sh git-gui: honor TCLTK_PATH in git-gui--askpass 2025-07-31 18:42:54 +02:00
gettext.c
…
gettext.h
…
git-archimport.perl
…
git-compat-util.h whatchanged: hint about git-log(1) and aliasing 2025-09-17 13:47:24 -07:00
git-curl-compat.h curl: add support for curl_global_trace() components 2025-08-27 09:49:43 -07:00
git-cvsexportcommit.perl
…
git-cvsimport.perl
…
git-cvsserver.perl cvsserver: remove unused escapeRefName function 2025-05-27 08:25:08 -07:00
git-difftool--helper.sh
…
git-filter-branch.sh filter-branch: stop depending on Perl 2025-04-16 07:30:29 -07:00
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: stop depending on Perl 2025-04-16 07:30:29 -07:00
git-send-email.perl Merge branch 'nb/send-email-no-dup-reply-to' 2025-09-29 11:40:33 -07:00
git-sh-i18n.sh
…
git-sh-setup.sh
…
git-submodule.sh
…
git-svn.perl
…
git-web--browse.sh
…
git-zlib.c Merge branch 'jk/zlib-inflate-fixes' 2025-04-15 13:50:14 -07:00
git-zlib.h git-zlib: use `struct z_stream_s` instead of typedef 2025-04-07 14:53:11 -07:00
git.c Merge branch 'kh/you-still-use-whatchanged-fix' 2025-10-02 12:26:12 -07:00
git.rc.in
…
gpg-interface.c gpg-interface: refactor 'enum sign_mode' parsing 2025-09-17 11:18:28 -07:00
gpg-interface.h gpg-interface: refactor 'enum sign_mode' parsing 2025-09-17 11:18:28 -07:00
graph.c
…
graph.h
…
grep.c grep: don't treat grep_opt.color as a strict bool 2025-09-16 13:37:05 -07:00
grep.h color: use git_colorbool enum type to store colorbools 2025-09-16 17:59:53 -07:00
hash-lookup.c
…
hash-lookup.h
…
hash.c
…
hash.h Merge branch 'bc/use-sha256-by-default-in-3.0' 2025-07-21 09:14:25 -07:00
hashmap.c Merge branch 'en/hashmap-clear-fix' 2025-05-08 12:36:31 -07:00
hashmap.h
…
help.c refs: introduce wrapper struct for `each_ref_fn` 2025-11-04 07:32:24 -08:00
help.h
…
hex-ll.c
…
hex-ll.h
…
hex.c
…
hex.h
…
hook.c
…
hook.h
…
http-backend.c refs: introduce wrapper struct for `each_ref_fn` 2025-11-04 07:32:24 -08:00
http-fetch.c config: move Git config parsing into "environment.c" 2025-07-23 08:15:22 -07:00
http-push.c Merge branch 'js/curl-off-t-fixes' into maint-2.51 2025-10-14 13:40:53 -07:00
http-walker.c odb: rename `has_object()` 2025-07-01 14:46:38 -07:00
http.c Merge branch 'jk/curl-global-trace-components' into maint-2.51 2025-10-14 13:41:25 -07:00
http.h Merge branch 'js/curl-off-t-fixes' 2025-10-07 12:25:27 -07:00
ident.c Merge branch 'ps/reflog-migrate-fixes' into maint-2.51 2025-10-15 10:29:28 -07:00
ident.h ident: fix type of string length parameter 2025-08-06 07:36:30 -07:00
imap-send.c Merge branch 'js/curl-off-t-fixes' into maint-2.51 2025-10-14 13:40:53 -07:00
iterator.h
…
json-writer.c json-writer: add docstrings to jw_* functions 2025-05-16 09:33:06 -07:00
json-writer.h json-writer: describe the usage of jw_* functions 2025-05-16 09:33:07 -07:00
khash.h
…
kwset.c kwset: avoid using the comma operator unnecessarily 2025-03-28 17:38:09 -07:00
kwset.h
…
levenshtein.c
…
levenshtein.h
…
line-log.c Merge branch 'sg/line-log-boundary-fixes' into maint-2.51 2025-10-15 10:29:30 -07:00
line-log.h
…
line-range.c
…
line-range.h
…
linear-assignment.c
…
linear-assignment.h
…
list-objects-filter-options.c config: drop `git_config_set()` wrapper 2025-07-23 08:15:21 -07:00
list-objects-filter-options.h
…
list-objects-filter.c use repo_get_oid_with_flags() 2025-09-10 14:29:49 -07:00
list-objects-filter.h
…
list-objects.c odb: rename `has_object()` 2025-07-01 14:46:38 -07:00
list-objects.h
…
list.h
…
lockfile.c
…
lockfile.h
…
log-tree.c refs: introduce wrapper struct for `each_ref_fn` 2025-11-04 07:32:24 -08:00
log-tree.h color: use git_colorbool enum type to store colorbools 2025-09-16 17:59:53 -07:00
loose.c loose: write loose objects map via their source 2025-07-16 22:16:15 -07:00
loose.h loose: write loose objects map via their source 2025-07-16 22:16:15 -07:00
ls-refs.c refs: expose peeled object ID via the iterator 2025-11-04 07:32:25 -08:00
ls-refs.h
…
mailinfo.c config: move Git config parsing into "environment.c" 2025-07-23 08:15:22 -07:00
mailinfo.h
…
mailmap.c string-list: change "string_list_find_insert_index" return type to "size_t" 2025-10-06 09:11:07 -07:00
mailmap.h
…
match-trees.c odb: introduce `odb_write_object()` 2025-07-16 22:16:15 -07:00
match-trees.h
…
mem-pool.c
…
mem-pool.h
…
merge-blobs.c odb: rename `repo_read_object_file()` 2025-07-01 14:46:38 -07:00
merge-blobs.h
…
merge-ll.c config: drop `git_config()` wrapper 2025-07-23 08:15:18 -07:00
merge-ll.h
…
merge-ort-wrappers.c merge-ort: support having merge verbosity be set to 0 2025-03-18 09:48:51 -07:00
merge-ort-wrappers.h merge-recursive.[ch]: thoroughly debug these 2025-04-08 13:59:13 -07:00
merge-ort.c Merge branch 'en/ort-rename-fixes' into maint-2.51 2025-10-15 10:29:28 -07:00
merge-ort.h merge-ort: add a new mergeability_only option 2025-05-16 15:09:14 -07:00
merge.c
…
merge.h
…
mergesort.h
…
meson.build Merge branch 'tb/incremental-midx-part-3.1' into ps/ref-peeled-tags 2025-10-22 07:47:01 -07:00
meson_options.txt meson: add infrastructure to build internal Rust library 2025-10-02 09:32:31 -07:00
midx-write.c refs: expose peeled object ID via the iterator 2025-11-04 07:32:25 -08:00
midx.c packfile: move `get_multi_pack_index()` into "midx.c" 2025-09-24 11:53:50 -07:00
midx.h packfile: move `get_multi_pack_index()` into "midx.c" 2025-09-24 11:53:50 -07:00
name-hash.c name-hash: don't add sparse directories in threaded lazy init 2025-05-21 14:51:08 -07:00
name-hash.h
…
notes-cache.c odb: introduce `odb_write_object()` 2025-07-16 22:16:15 -07:00
notes-cache.h
…
notes-merge.c odb: rename `repo_read_object_file()` 2025-07-01 14:46:38 -07:00
notes-merge.h
…
notes-utils.c config: drop `git_config()` wrapper 2025-07-23 08:15:18 -07:00
notes-utils.h
…
notes.c refs: introduce wrapper struct for `each_ref_fn` 2025-11-04 07:32:24 -08:00
notes.h
…
object-file-convert.c
…
object-file-convert.h
…
object-file.c Merge branch 'ps/packfile-store' 2025-10-07 12:25:27 -07:00
object-file.h odb: add transaction interface 2025-09-16 11:37:06 -07:00
object-name.c refs: introduce wrapper struct for `each_ref_fn` 2025-11-04 07:32:24 -08:00
object-name.h
…
object.c object: add flag to `peel_object()` to verify object type 2025-11-04 07:32:25 -08:00
object.h object: add flag to `peel_object()` to verify object type 2025-11-04 07:32:25 -08:00
odb.c Merge branch 'ps/packfile-store' 2025-10-07 12:25:27 -07:00
odb.h Merge branch 'ps/odb-clean-stale-wrappers' 2025-10-07 12:25:28 -07:00
oid-array.c
…
oid-array.h
…
oidmap.c oidmap: rename oidmap_free() to oidmap_clear() 2025-05-12 13:06:26 -07:00
oidmap.h oidmap: add size function 2025-05-12 13:06:26 -07:00
oidset.c
…
oidset.h
…
oidtree.c
…
oidtree.h
…
pack-bitmap-write.c Merge branch 'ps/object-store' 2025-07-15 15:18:18 -07:00
pack-bitmap.c packfile: refactor `get_all_packs()` to work on packfile store 2025-09-24 11:53:51 -07:00
pack-bitmap.h pack-bitmap: add load corrupt bitmap test 2025-07-01 14:41:54 -07:00
pack-check.c object-store: rename files to "odb.{c,h}" 2025-07-01 14:46:34 -07:00
pack-mtimes.c object-store: rename files to "odb.{c,h}" 2025-07-01 14:46:34 -07:00
pack-mtimes.h
…
pack-objects.c Merge branch 'ps/odb-clean-stale-wrappers' into maint-2.51 2025-10-15 10:29:34 -07:00
pack-objects.h Merge branch 'ps/object-store' 2025-07-15 15:18:18 -07:00
pack-refs.c builtin/pack-refs: factor out core logic into a shared library 2025-09-19 10:02:55 -07:00
pack-refs.h builtin/pack-refs: factor out core logic into a shared library 2025-09-19 10:02:55 -07:00
pack-revindex.c midx: compute paths via their source 2025-08-11 09:22:23 -07:00
pack-revindex.h
…
pack-write.c object-file: get rid of `the_repository` in `finalize_object_file()` 2025-07-16 22:16:14 -07:00
pack.h object-file: get rid of `the_repository` in `finalize_object_file()` 2025-07-16 22:16:14 -07:00
packfile.c packfile: refactor `get_packed_git_mru()` to work on packfile store 2025-09-24 11:53:51 -07:00
packfile.h packfile: refactor `get_packed_git_mru()` to work on packfile store 2025-09-24 11:53:51 -07:00
pager.c
…
pager.h
…
parallel-checkout.c config: drop `git_config_get_int()` wrapper 2025-07-23 08:15:20 -07:00
parallel-checkout.h
…
parse-options-cb.c color: use git_colorbool enum type to store colorbools 2025-09-16 17:59:53 -07:00
parse-options.c Merge branch 'jc/optional-path' 2025-10-14 12:56:09 -07:00
parse-options.h Merge branch 'lm/add-p-context' 2025-08-04 08:10:33 -07:00
parse.c parse-options: introduce precision handling for `OPTION_UNSIGNED` 2025-04-17 08:15:16 -07:00
parse.h parse-options: introduce precision handling for `OPTION_UNSIGNED` 2025-04-17 08:15:16 -07:00
patch-delta.c
…
patch-ids.c
…
patch-ids.h
…
path-walk.c path-walk: create initializer for path lists 2025-08-25 09:01:17 -07:00
path-walk.h path-walk: add new 'edge_aggressive' option 2025-05-16 12:15:40 -07:00
path.c object-store: rename files to "odb.{c,h}" 2025-07-01 14:46:34 -07:00
path.h object-store: move and rename `odb_pack_keep()` 2025-04-29 10:08:12 -07:00
pathspec.c string-list: split-then-remove-empty can be done while splitting 2025-08-02 22:34:45 -07:00
pathspec.h pathspec: add flag to indicate operation without repository 2025-05-22 14:20:11 -07:00
pkt-line.c Use legacy hash for legacy formats 2025-07-01 14:58:24 -07:00
pkt-line.h
…
preload-index.c preload-index: stop depending on 'the_repository' 2025-06-10 10:10:40 -07:00
preload-index.h
…
pretty.c color: use git_colorbool enum type to store colorbools 2025-09-16 17:59:53 -07:00
pretty.h color: use git_colorbool enum type to store colorbools 2025-09-16 17:59:53 -07:00
prio-queue.c prio-queue: add prio_queue_replace() 2025-07-22 07:28:35 -07:00
prio-queue.h prio-queue: add prio_queue_replace() 2025-07-22 07:28:35 -07:00
progress.c progress: pay attention to (customized) delay time 2025-08-25 15:50:17 -07:00
progress.h
…
promisor-remote.c promisor-remote: use string_list_split() in mark_remotes_as_accepted() 2025-09-08 10:30:56 -07:00
promisor-remote.h
…
prompt.c interactive: do strip trailing CRLF from input 2025-07-31 14:17:54 -07:00
prompt.h
…
protocol-caps.c odb: rename `oid_object_info()` 2025-07-01 14:46:37 -07:00
protocol-caps.h
…
protocol.c Merge branch 'jc/string-list-split' 2025-08-21 13:46:59 -07:00
protocol.h
…
prune-packed.c object-file: get rid of `the_repository` in loose object iterators 2025-07-16 22:16:17 -07:00
prune-packed.h
…
pseudo-merge.c refs: expose peeled object ID via the iterator 2025-11-04 07:32:25 -08:00
pseudo-merge.h Merge branch 'tb/bitamp-typofix' 2025-04-07 14:23:20 -07:00
quote.c
…
quote.h
…
range-diff.c range-diff: rename other_arg to log_arg 2025-09-25 11:34:11 -07:00
range-diff.h range-diff: rename other_arg to log_arg 2025-09-25 11:34:11 -07:00
reachable.c refs: introduce wrapper struct for `each_ref_fn` 2025-11-04 07:32:24 -08:00
reachable.h
…
read-cache-ll.h
…
read-cache.c Merge branch 'ps/rust-balloon' 2025-10-08 12:17:55 -07:00
read-cache.h
…
rebase-interactive.c config: drop `git_config_get_value()` wrapper 2025-07-23 08:15:18 -07:00
rebase-interactive.h
…
rebase.c
…
rebase.h
…
ref-filter.c object: add flag to `peel_object()` to verify object type 2025-11-04 07:32:25 -08:00
ref-filter.h ref-filter: propagate peeled object ID 2025-11-04 07:32:25 -08:00
reflog-walk.c refs: pass refname when invoking reflog entry callback 2025-08-06 14:19:30 -07:00
reflog-walk.h
…
reflog.c refs: introduce wrapper struct for `each_ref_fn` 2025-11-04 07:32:24 -08:00
reflog.h Merge branch 'ps/remote-rename-fix' 2025-08-21 13:46:58 -07:00
refs.c object: add flag to `peel_object()` to verify object type 2025-11-04 07:32:25 -08:00
refs.h refs: drop infrastructure to peel via iterators 2025-11-04 07:32:25 -08:00
refspec.c refspec: replace `refspec_item_init()` with fetch/push variants 2025-03-21 01:45:16 -07:00
refspec.h refspec: replace `refspec_item_init()` with fetch/push variants 2025-03-21 01:45:16 -07:00
remote-curl.c Merge branch 'js/curl-off-t-fixes' into maint-2.51 2025-10-14 13:40:53 -07:00
remote.c refs: introduce wrapper struct for `each_ref_fn` 2025-11-04 07:32:24 -08:00
remote.h submodule: look up remotes by URL first 2025-06-23 16:38:57 -07:00
repack-cruft.c repack: move `write_cruft_pack()` out of the builtin 2025-10-16 10:08:57 -07:00
repack-filtered.c repack: move `write_filtered_pack()` out of the builtin 2025-10-16 10:08:57 -07:00
repack-geometry.c repack: move `pack_kept_objects` to `struct pack_objects_args` 2025-10-16 10:08:57 -07:00
repack-midx.c refs: expose peeled object ID via the iterator 2025-11-04 07:32:25 -08:00
repack-promisor.c builtin/repack.c: remove "repack_promisor_objects()" from the builtin 2025-10-16 10:08:55 -07:00
repack.c repack: move `pack_kept_objects` to `struct pack_objects_args` 2025-10-16 10:08:57 -07:00
repack.h repack: move `write_cruft_pack()` out of the builtin 2025-10-16 10:08:57 -07:00
replace-object.c refs: introduce wrapper struct for `each_ref_fn` 2025-11-04 07:32:24 -08:00
replace-object.h object-store: rename files to "odb.{c,h}" 2025-07-01 14:46:34 -07:00
repo-settings.c Merge branch 'ds/path-walk-2' 2025-06-17 10:44:38 -07:00
repo-settings.h Merge branch 'ds/path-walk-2' 2025-06-17 10:44:38 -07:00
repository.c Merge branch 'pw/3.0-commentchar-auto-deprecation' 2025-09-18 10:07:00 -07:00
repository.h config: warn on core.commentString=auto 2025-08-26 08:52:44 -07:00
rerere.c config: move Git config parsing into "environment.c" 2025-07-23 08:15:22 -07:00
rerere.h
…
reset.c
…
reset.h
…
resolve-undo.c
…
resolve-undo.h
…
revision.c refs: introduce wrapper struct for `each_ref_fn` 2025-11-04 07:32:24 -08:00
revision.h Merge branch 'kh/format-patch-range-diff-notes' 2025-10-14 12:56:09 -07:00
run-command.c config: drop `git_config_get_bool()` wrapper 2025-07-23 08:15:20 -07:00
run-command.h
…
sane-ctype.h sane-ctype: fix compiler error on Amazon Linux 2 2025-07-10 11:18:37 -07:00
scalar.c config: drop `git_config_get_multivar_gently()` wrapper 2025-07-23 08:15:21 -07:00
send-pack.c Merge branch 'ps/object-store' 2025-07-15 15:18:18 -07:00
send-pack.h
…
sequencer.c Merge branch 'pw/rebase-i-cleanup-fix' into maint-2.51 2025-10-15 10:29:31 -07:00
sequencer.h treewide: pass strvecs around for setup_revisions_from_strvec() 2025-09-22 14:27:03 -07:00
serve.c Use legacy hash for legacy formats 2025-07-01 14:58:24 -07:00
serve.h
…
server-info.c refs: introduce wrapper struct for `each_ref_fn` 2025-11-04 07:32:24 -08:00
server-info.h
…
setup.c Merge branch 'jc/string-list-split' 2025-08-21 13:46:59 -07:00
setup.h setup: use the default algorithm to initialize repo format 2025-07-01 14:58:24 -07:00
sh-i18n--envsubst.c
…
sha1dc_git.c
…
sha1dc_git.h
…
shallow.c refs: introduce wrapper struct for `each_ref_fn` 2025-11-04 07:32:24 -08:00
shallow.h treewide: pass strvecs around for setup_revisions_from_strvec() 2025-09-22 14:27:03 -07:00
shared.mak Makefile: introduce infrastructure to build internal Rust library 2025-10-02 09:32:31 -07:00
shell.c
…
shortlog.h
…
sideband.c color: use git_colorbool enum type to store colorbools 2025-09-16 17:59:53 -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: convert predicates to return bool 2025-07-16 08:18:06 -07:00
strbuf.h strbuf: convert predicates to return bool 2025-07-16 08:18:06 -07:00
streaming.c odb: rename `oid_object_info()` 2025-07-01 14:46:37 -07:00
streaming.h
…
string-list.c string-list: change "string_list_find_insert_index" return type to "size_t" 2025-10-06 09:11:07 -07:00
string-list.h string-list: change "string_list_find_insert_index" return type to "size_t" 2025-10-06 09:11:07 -07:00
strmap.c
…
strmap.h
…
strvec.c
…
strvec.h
…
sub-process.c sub-process: do not use strbuf_split*() 2025-08-02 22:44:58 -07:00
sub-process.h doc: update references to renamed AsciiDoc files 2025-06-06 15:05:47 -07:00
submodule-config.c config: drop `git_config_set_in_file_gently()` wrapper 2025-07-23 08:15:21 -07:00
submodule-config.h
…
submodule.c refs: introduce wrapper struct for `each_ref_fn` 2025-11-04 07:32:24 -08:00
submodule.h odb: get rid of `the_repository` when handling submodule sources 2025-07-01 14:46:37 -07:00
symlinks.c
…
symlinks.h
…
tag.c object: add flag to `peel_object()` to verify object type 2025-11-04 07:32:25 -08:00
tag.h object: add flag to `peel_object()` to verify object type 2025-11-04 07:32:25 -08:00
tar.h
…
tempfile.c
…
tempfile.h
…
thread-utils.c thread-utils.c: detect online CPU count on OpenBSD / NetBSD 2025-06-01 17:15:13 -07:00
thread-utils.h
…
tmp-objdir.c object-file: get rid of `the_repository` in `finalize_object_file()` 2025-07-16 22:16:14 -07:00
tmp-objdir.h
…
trace.c
…
trace.h
…
trace2.c
…
trace2.h
…
trailer.c config: drop `git_config()` wrapper 2025-07-23 08:15:18 -07:00
trailer.h
…
transport-helper.c packfile: split up responsibilities of `reprepare_packed_git()` 2025-09-24 11:53:50 -07:00
transport-internal.h
…
transport.c Merge branch 'jk/color-variable-fixes' 2025-09-29 11:40:35 -07:00
transport.h
…
tree-diff.c diff: teach tree-diff a max-depth parameter 2025-08-07 15:29:35 -07:00
tree-walk.c odb: rename `read_object_with_reference()` 2025-07-01 14:46:39 -07:00
tree-walk.h tree-walk.h: fix incorrect API comment 2025-05-02 12:44:04 -07:00
tree.c odb: rename `repo_read_object_file()` 2025-07-01 14:46:38 -07:00
tree.h
…
unicode-width.h
…
unimplemented.sh
…
unix-socket.c
…
unix-socket.h
…
unix-stream-server.c
…
unix-stream-server.h
…
unpack-trees.c object-store: rename files to "odb.{c,h}" 2025-07-01 14:46:34 -07:00
unpack-trees.h
…
upload-pack.c upload-pack: convert to use `reference_get_peeled_oid()` 2025-11-04 07:32:25 -08:00
upload-pack.h
…
url.c
…
url.h
…
urlmatch.c
…
urlmatch.h
…
usage.c Merge branch 'kh/you-still-use-whatchanged-fix' 2025-10-02 12:26:12 -07:00
userdiff.c userdiff: add support for R programming language 2025-05-29 15:29:37 -07:00
userdiff.h
…
utf8.c
…
utf8.h
…
varint.c varint: use explicit width for integers 2025-10-02 09:32:32 -07:00
varint.h varint: use explicit width for integers 2025-10-02 09:32:32 -07:00
version-def.h.in
…
version.c
…
version.h
…
versioncmp.c config: drop `git_config_get_string_multi()` wrapper 2025-07-23 08:15:19 -07:00
versioncmp.h
…
walker.c refs: introduce wrapper struct for `each_ref_fn` 2025-11-04 07:32:24 -08:00
walker.h
…
wildmatch.c wildmatch: avoid using of the comma operator 2025-03-28 17:38:11 -07:00
wildmatch.h
…
worktree.c refs: introduce wrapper struct for `each_ref_fn` 2025-11-04 07:32:24 -08:00
worktree.h Merge branch 'sj/ref-consistency-checks-more' 2025-03-26 16:26:10 +09:00
wrapper.c config: values of pathname type can be prefixed with :(optional) 2025-10-07 10:05:48 -07:00
wrapper.h config: values of pathname type can be prefixed with :(optional) 2025-10-07 10:05:48 -07:00
write-or-die.c
…
write-or-die.h
…
ws.c
…
ws.h
…
wt-status.c Merge branch 'jk/color-variable-fixes' 2025-09-29 11:40:35 -07:00
wt-status.h color: use git_colorbool enum type to store colorbools 2025-09-16 17:59:53 -07:00
xdiff-interface.c config: move Git config parsing into "environment.c" 2025-07-23 08:15:22 -07:00
xdiff-interface.h diff: ensure consistent diff behavior with ignore options 2025-08-08 07:54:44 -07:00

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