Go to file

Derrick Stolee via GitGitGadget 4c6c7971e0 unpack-trees: correctly compute result count The clear_ce_flags_dir() method processes the cache entries within a common directory. The returned int is the number of cache entries processed by that directory. When using the sparse-checkout feature in cone mode, we can skip the pattern matching for entries in the directories that are entirely included or entirely excluded. `eb42feca` (unpack-trees: hash less in cone mode, 2019-11-21) introduced this performance feature. The old mechanism relied on the counts returned by calling clear_ce_flags_1(), but the new mechanism calculated the number of rows by subtracting "cache_end" from "cache" to find the size of the range. However, the equation is wrong because it divides by sizeof(struct cache_entry ). This is not how pointer arithmetic works! A coverity build of Git for Windows in preparation for the 2.25.0 release found this issue with the warning, "Pointer differences, such as cache_end - cache, are automatically scaled down by the size (8 bytes) of the pointed-to type (struct cache_entry ). Most likely, the division by sizeof(struct cache_entry *) is extraneous and should be eliminated." This warning is correct. This leaves us with the question "how did this even work?" The problem that occurs with this incorrect pointer arithmetic is a performance-only bug, and a very slight one at that. Since the entry count returned by clear_ce_flags_dir() is reduced by a factor of 8, the loop in clear_ce_flags_1() will re-process entries from those directories. By inserting global counters into unpack-tree.c and tracing them with trace2_data_intmax() (in a private change, for testing), I was able to see count how many times the loop inside clear_ce_flags_1() processed an entry and how many times clear_ce_flags_dir() was called. Each of these are reduced by at least a factor of 8 with the current change. A factor larger than 8 happens when multiple levels of directories are repeated. Specifically, in the Linux kernel repo, the command git sparse-checkout set LICENSES restricts the working directory to only the files at root and in the LICENSES directory. Here are the measured counts: clear_ce_flags_1 loop blocks: Before: 11,520 After: 1,621 clear_ce_flags_dir calls: Before: 7,048 After: 606 While these are dramatic counts, the time spent in clear_ce_flags_1() is under one millisecond in each case, so the improvement is not measurable as an end-to-end time. Reported-by: Johannes Schindelin <Johannes.Schindelin@gmx.de> Signed-off-by: Derrick Stolee <dstolee@microsoft.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>		2020-01-10 11:34:36 -08:00
.github	…
Documentation	Documentation/git-sparse-checkout.txt: fix a typo	2020-01-04 14:40:29 -08:00
block-sha1	…
builtin	sparse-checkout: respect core.ignoreCase in cone mode	2019-12-13 12:01:02 -08:00
ci	Merge branch 'sg/ci-osx-gcc8-fix'	2019-10-24 13:34:03 +09:00
compat	Merge branch 'js/mingw-needs-hiding-fix'	2019-10-30 15:13:13 +09:00
contrib	Merge branch 'nr/diff-highlight-indent-fix'	2019-10-23 14:43:09 +09:00
ewah	…
git-gui	Merge https://github.com/prati0100/git-gui	2019-11-04 13:29:38 +09:00
gitk-git	Merge gitk to pick up emergency build fix	2019-09-17 14:59:18 -07:00
gitweb	gitweb: correctly store previous rev in javascript-actions mode	2019-10-28 11:06:57 +09:00
mergetools	…
negotiator	…
perl	git-svn: trim leading and trailing whitespaces in author name	2019-09-28 13:51:42 +09:00
po	l10n: zh_CN: for git v2.24.0 l10n round 1~2	2019-11-02 20:51:12 +08:00
ppc	*.[ch]: manually align parameter lists	2019-05-05 15:20:10 +09:00
refs	Merge branch 'sc/pack-refs-deletion-racefix'	2019-08-22 12:34:10 -07:00
sha1collisiondetection@855827c583	sha1dc: update from upstream	2019-05-14 16:45:01 +09:00
sha1dc	sha1dc: update from upstream	2019-05-14 16:45:01 +09:00
sha256	…
t	sparse-checkout: improve OS ls compatibility	2019-12-20 12:47:08 -08:00
templates	git-merge: honor pre-merge-commit hook	2019-08-07 12:37:33 -07:00
trace2	trace2: write discard message to sentinel files	2019-10-05 17:53:51 +09:00
vcs-svn	*.[ch]: manually align parameter lists	2019-05-05 15:20:10 +09:00
xdiff	xdiffi: fix typos and touch up comments	2019-10-09 10:58:34 +09:00
.clang-format	clang-format: use git grep to generate the ForEachMacros list	2019-06-04 14:50:40 -07:00
.editorconfig	…
.gitattributes	Fix build with core.autocrlf=true	2019-09-24 19:48:27 +05:30
.gitignore	sparse-checkout: create builtin with 'list' subcommand	2019-11-22 16:11:43 +09:00
.gitmodules	…
.mailmap	.mailmap: update email address of Andrey Mazo	2019-09-20 22:21:28 -07:00
.travis.yml	travis-ci: build with GCC 4.8 as well	2019-07-19 14:06:01 -07:00
.tsan-suppressions	…
CODE_OF_CONDUCT.md	CODE_OF_CONDUCT: mention individual project-leader emails	2019-10-10 10:41:46 +09:00
COPYING	…
GIT-VERSION-GEN	The first batch post 2.24 cycle	2019-11-10 18:02:17 +09:00
INSTALL	…
LGPL-2.1	…
Makefile	sparse-checkout: create builtin with 'list' subcommand	2019-11-22 16:11:43 +09:00
README.md	git-gui: add a readme	2019-10-12 21:29:30 +05:30
RelNotes	The first batch post 2.24 cycle	2019-11-10 18:02:17 +09:00
abspath.c	…
aclocal.m4	…
advice.c	Merge branch 'ra/cherry-pick-revert-skip'	2019-07-19 11:30:21 -07:00
advice.h	Merge branch 'ra/cherry-pick-revert-skip'	2019-07-19 11:30:21 -07:00
alias.c	…
alias.h	…
alloc.c	…
alloc.h	…
apply.c	Merge branch 'dl/apply-3way-diff3'	2019-11-10 18:02:15 +09:00
apply.h	apply.h: include missing header	2019-09-28 14:04:16 +09:00
archive-tar.c	Merge branch 'rs/pax-extended-header-length-fix'	2019-09-09 12:26:37 -07:00
archive-zip.c	…
archive.c	tree-walk.c: remove the_repo from get_tree_entry()	2019-06-27 12:45:17 -07:00
archive.h	Merge branch 'dl/no-extern-in-func-decl'	2019-05-13 23:50:32 +09:00
argv-array.c	…
argv-array.h	…
attr.c	Merge branch 'ew/hashmap'	2019-10-15 13:48:02 +09:00
attr.h	…
azure-pipelines.yml	Merge branch 'js/azure-pipelines-msvc'	2019-10-23 11:06:46 +09:00
banned.h	banned.h: fix vsprintf()'s ban message	2019-08-26 10:32:45 -07:00
base85.c	…
bisect.c	bisect: switch to using the_hash_algo	2019-08-19 15:04:58 -07:00
bisect.h	*.[ch]: manually align parameter lists	2019-05-05 15:20:10 +09:00
blame.c	Merge branch 'ew/hashmap'	2019-10-15 13:48:02 +09:00
blame.h	Merge branch 'br/blame-ignore'	2019-07-19 11:30:20 -07:00
blob.c	object: convert create_object() to use object_id	2019-06-20 10:20:51 -07:00
blob.h	…
branch.c	Merge branch 'nd/switch-and-restore'	2019-07-09 15:25:44 -07:00
branch.h	Merge branch 'nd/switch-and-restore'	2019-07-09 15:25:44 -07:00
builtin.h	sparse-checkout: create builtin with 'list' subcommand	2019-11-22 16:11:43 +09:00
bulk-checkin.c	bulk-checkin: zero-initialize hashfile_checkpoint	2019-09-06 11:03:39 -07:00
bulk-checkin.h	*.[ch]: manually align parameter lists	2019-05-05 15:20:10 +09:00
bundle.c	bundle: switch to use the_hash_algo	2019-08-19 15:04:58 -07:00
bundle.h	…
cache-tree.c	Merge branch 'en/merge-recursive-cleanup'	2019-10-15 13:47:59 +09:00
cache-tree.h	cache-tree: share code between functions writing an index as a tree	2019-08-19 10:08:03 -07:00
cache.h	sparse-checkout: use extern for global variables	2020-01-02 10:18:42 -08:00
chdir-notify.c	…
chdir-notify.h	…
check-builtins.sh	…
check_bindir	…
checkout.c	…
checkout.h	*.[ch]: manually align parameter lists	2019-05-05 15:20:10 +09:00
color.c	…
color.h	…
column.c	column: use utf8_strnwidth() to strip out ANSI color escapes	2019-10-15 10:54:15 +09:00
column.h	*.[ch]: manually align parameter lists	2019-05-05 15:20:10 +09:00
combine-diff.c	combine-diff: replace GIT_SHA1_HEXSZ with the_hash_algo	2019-08-19 15:04:58 -07:00
command-list.txt	sparse-checkout: create builtin with 'list' subcommand	2019-11-22 16:11:43 +09:00
commit-graph.c	Merge branch 'ds/commit-graph-on-fetch'	2019-11-04 13:33:06 +09:00
commit-graph.h	upload-pack: disable commit graph more gently for shallow traversal	2019-09-12 12:30:08 -07:00
commit-reach.c	commit-graph: fix writing first commit-graph during fetch	2019-10-25 11:19:16 +09:00
commit-reach.h	…
commit-slab-decl.h	…
commit-slab-impl.h	…
commit-slab.h	…
commit.c	Merge branch 'pw/post-commit-from-sequencer'	2019-11-10 18:02:12 +09:00
commit.h	Merge branch 'dl/no-extern-in-func-decl'	2019-05-13 23:50:32 +09:00
common-main.c	common-main: delay trace2 initialization	2019-08-06 13:09:01 -07:00
config.c	sparse-checkout: add 'cone' mode	2019-11-22 16:11:44 +09:00
config.h	Merge branch 'dl/no-extern-in-func-decl'	2019-05-13 23:50:32 +09:00
config.mak.dev	…
config.mak.in	…
config.mak.uname	vcxproj: include more generated files	2019-10-06 09:07:44 +09:00
configure.ac	configure: Detect linking style for HP aCC on HP-UX	2019-06-07 10:06:11 -07:00
connect.c	mingw: support UNC in git clone file://server/share/repo	2019-08-26 10:00:33 -07:00
connect.h	*.[ch]: manually align parameter lists	2019-05-05 15:20:10 +09:00
connected.c	Merge branch 'bc/object-id-part17'	2019-10-11 14:24:46 +09:00
connected.h	…
convert.c	Merge branch 'rs/convert-fix-utf-without-dash'	2019-10-09 14:01:00 +09:00
convert.h	am: reload .gitattributes after patching it	2019-09-03 15:16:18 -07:00
copy.c	…
credential-cache--daemon.c	…
credential-cache.c	…
credential-store.c	strbuf: give URL-encoding API a char predicate fn	2019-06-28 08:41:53 -07:00
credential.c	…
credential.h	…
csum-file.c	…
csum-file.h	*.[ch]: remove extern from function declarations using spatch	2019-05-05 15:20:06 +09:00
ctype.c	…
daemon.c	…
date.c	Quit passing 'now' to date code	2019-09-12 11:03:51 -07:00
decorate.c	hashmap: convert sha1hash() to oidhash()	2019-06-20 10:44:22 -07:00
decorate.h	*.[ch]: remove extern from function declarations using spatch	2019-05-05 15:20:06 +09:00
delta-islands.c	Merge branch 'jk/oidhash'	2019-07-09 15:25:43 -07:00
delta-islands.h	delta-islands: respect progress flag	2019-06-20 13:29:49 -07:00
delta.h	*.[ch]: manually align parameter lists	2019-05-05 15:20:10 +09:00
detect-compiler	…
diff-delta.c	diff-delta: set size out-parameter to 0 for NULL delta	2019-09-06 11:03:39 -07:00
diff-lib.c	mark_fsmonitor_valid(): mark the index as changed if needed	2019-05-28 12:43:43 -07:00
diff-no-index.c	…
diff.c	Merge branch 'ew/hashmap'	2019-10-15 13:48:02 +09:00
diff.h	patch-id: convert to use the_hash_algo	2019-08-19 15:04:57 -07:00
diffcore-break.c	diffcore-break: use a goto instead of a redundant if statement	2019-10-02 15:04:21 +09:00
diffcore-delta.c	…
diffcore-order.c	…
diffcore-pickaxe.c	…
diffcore-rename.c	Merge branch 'ew/hashmap'	2019-10-15 13:48:02 +09:00
diffcore.h	…
dir-iterator.c	dir-iterator: add flags parameter to dir_iterator_begin	2019-07-11 13:52:15 -07:00
dir-iterator.h	dir-iterator: add flags parameter to dir_iterator_begin	2019-07-11 13:52:15 -07:00
dir.c	sparse-checkout: respect core.ignoreCase in cone mode	2019-12-13 12:01:02 -08:00
dir.h	unpack-trees: hash less in cone mode	2019-11-22 16:11:44 +09:00
editor.c	pager: add a helper function to clear the last line in the terminal	2019-06-24 13:38:46 -07:00
entry.c	fill_stat_cache_info(): prepare for an fsmonitor fix	2019-05-28 12:43:42 -07:00
environment.c	sparse-checkout: add 'cone' mode	2019-11-22 16:11:44 +09:00
exec-cmd.c	…
exec-cmd.h	*.[ch]: remove extern from function declarations using sed	2019-05-05 15:20:08 +09:00
fast-import.c	Merge branch 'en/fast-imexport-nested-tags'	2019-10-15 13:48:00 +09:00
fetch-negotiator.c	repo-settings: create feature.experimental setting	2019-08-13 13:33:55 -07:00
fetch-negotiator.h	repo-settings: create feature.experimental setting	2019-08-13 13:33:55 -07:00
fetch-pack.c	Merge branch 'jt/fetch-pack-record-refs-in-the-dot-promisor'	2019-11-10 18:02:10 +09:00
fetch-pack.h	…
fmt-merge-msg.h	*.[ch]: remove extern from function declarations using spatch	2019-05-05 15:20:06 +09:00
fsck.c	Merge branch 'br/blame-ignore'	2019-07-19 11:30:20 -07:00
fsck.h	…
fsmonitor.c	fsmonitor: don't fill bitmap with entries to be removed	2019-10-12 10:16:11 +09:00
fsmonitor.h	mark_fsmonitor_valid(): mark the index as changed if needed	2019-05-28 12:43:43 -07:00
fuzz-commit-graph.c	…
fuzz-pack-headers.c	…
fuzz-pack-idx.c	…
generate-cmdlist.sh	…
gettext.c	Merge branch 'ab/test-env'	2019-07-25 13:59:20 -07:00
gettext.h	*.[ch]: remove extern from function declarations using spatch	2019-05-05 15:20:06 +09:00
git-add--interactive.perl	add -i: show progress counter in the prompt	2019-10-04 07:12:19 +09:00
git-archimport.perl	…
git-bisect.sh	…
git-compat-util.h	Merge branch 'bb/compat-util-comment-fix'	2019-10-18 11:40:48 +09:00
git-cvsexportcommit.perl	cvsexportcommit: force crlf translation	2019-05-07 18:23:27 +09:00
git-cvsimport.perl	…
git-cvsserver.perl	…
git-difftool--helper.sh	mergetool: use get_merge_tool function	2019-05-13 23:11:59 +09:00
git-filter-branch.sh	Recommend git-filter-repo instead of git-filter-branch	2019-09-05 13:01:48 -07:00
git-instaweb.sh	…
git-legacy-stash.sh	Merge branch 'js/update-index-ignore-removal-for-skip-worktree'	2019-11-10 18:02:16 +09:00
git-merge-octopus.sh	…
git-merge-one-file.sh	…
git-merge-resolve.sh	…
git-mergetool--lib.sh	Merge branch 'dl/difftool-mergetool'	2019-05-19 16:45:30 +09:00
git-mergetool.sh	mergetool: use shell variable magic instead of `awk`	2019-06-12 13:20:56 -07:00
git-p4.py	git-p4: auto-delete named temporary file	2019-10-06 20:43:37 +09:00
git-parse-remote.sh	…
git-quiltimport.sh	…
git-rebase--preserve-merges.sh	rebase: fold git-rebase--common into the -p backend	2019-07-31 12:24:06 -07:00
git-request-pull.sh	request-pull: warn if the remote object is not the same as the local one	2019-05-28 13:06:25 -07:00
git-send-email.perl	Merge branch 'ab/send-email-transferencoding-fix'	2019-06-13 13:18:46 -07:00
git-sh-i18n.sh	tests: make GIT_TEST_GETTEXT_POISON a boolean	2019-06-21 09:42:49 -07:00
git-sh-setup.sh	…
git-submodule.sh	Merge branch 'km/empty-repo-is-still-a-repo'	2019-05-09 00:37:23 +09:00
git-svn.perl	…
git-web--browse.sh	…
git.c	sparse-checkout: create builtin with 'list' subcommand	2019-11-22 16:11:43 +09:00
git.rc	mingw: embed a manifest to trick UAC into Doing The Right Thing	2019-06-27 12:55:45 -07:00
gpg-interface.c	gpg-interface: do not scan past the end of buffer	2019-07-16 12:15:12 -07:00
gpg-interface.h	…
graph.c	…
graph.h	…
grep.c	Merge branch 'cb/pcre2-chartables-leakfix'	2019-10-23 14:43:11 +09:00
grep.h	Merge branch 'cb/pcre2-chartables-leakfix'	2019-10-23 14:43:11 +09:00
hash.h	hash.h: move object_id definition from cache.h	2019-06-20 10:40:42 -07:00
hashmap.c	hashmap: remove type arg from hashmap_{get,put,remove}_entry	2019-10-07 10:20:12 +09:00
hashmap.h	hashmap_entry: remove first member requirement from docs	2019-10-07 10:20:12 +09:00
help.c	Merge branch 'rs/help-unknown-ref-does-not-return'	2019-09-30 13:19:27 +09:00
help.h	help: make help_unknown_ref() NORETURN	2019-08-30 10:22:42 -07:00
hex.c	…
http-backend.c	…
http-fetch.c	…
http-push.c	http-push: simplify deleting a list item	2019-10-15 10:53:50 +09:00
http-walker.c	Merge branch 'bc/hash-transition-16'	2019-04-25 16:41:17 +09:00
http.c	Merge branch 'mh/http-urlmatch-cleanup'	2019-09-30 13:19:24 +09:00
http.h	http: use xmalloc with cURL	2019-08-15 12:37:10 -07:00
ident.c	…
imap-send.c	…
interdiff.c	…
interdiff.h	…
iterator.h	…
json-writer.c	…
json-writer.h	…
khash.h	hashmap: convert sha1hash() to oidhash()	2019-06-20 10:44:22 -07:00
kwset.c	Merge branch 'rs/copy-array' into maint	2019-07-29 12:38:15 -07:00
kwset.h	*.[ch]: remove extern from function declarations using spatch	2019-05-05 15:20:06 +09:00
levenshtein.c	…
levenshtein.h	…
line-log.c	Merge branch 'sg/line-log-tree-diff-optim'	2019-09-18 11:50:09 -07:00
line-log.h	*.[ch]: remove extern from function declarations using spatch	2019-05-05 15:20:06 +09:00
line-range.c	…
line-range.h	…
linear-assignment.c	…
linear-assignment.h	…
list-objects-filter-options.c	Merge branch 'jk/partial-clone-sparse-blob'	2019-10-07 11:32:54 +09:00
list-objects-filter-options.h	Merge branch 'jk/partial-clone-sparse-blob'	2019-10-07 11:32:54 +09:00
list-objects-filter.c	Merge branch 'jk/partial-clone-sparse-blob'	2019-10-07 11:32:54 +09:00
list-objects-filter.h	list-objects-filter: implement composite filters	2019-06-28 08:41:53 -07:00
list-objects.c	Merge branch 'jk/list-objects-optim-wo-trees'	2019-10-07 11:32:56 +09:00
list-objects.h	…
list.h	…
ll-merge.c	am: reload .gitattributes after patching it	2019-09-03 15:16:18 -07:00
ll-merge.h	am: reload .gitattributes after patching it	2019-09-03 15:16:18 -07:00
lockfile.c	…
lockfile.h	*.[ch]: manually align parameter lists	2019-05-05 15:20:10 +09:00
log-tree.c	Merge branch 'rs/simplify-by-deco-with-deco-refs-exclude'	2019-10-07 11:32:54 +09:00
log-tree.h	…
ls-refs.c	upload-pack: strip namespace from symref data	2019-05-28 10:02:00 -07:00
ls-refs.h	*.[ch]: manually align parameter lists	2019-05-05 15:20:10 +09:00
mailinfo.c	…
mailinfo.h	*.[ch]: remove extern from function declarations using spatch	2019-05-05 15:20:06 +09:00
mailmap.c	…
mailmap.h	…
match-trees.c	match-trees.c: remove the_repo from shift_tree*()	2019-06-27 12:45:17 -07:00
mem-pool.c	…
mem-pool.h	…
merge-blobs.c	…
merge-blobs.h	*.[ch]: manually align parameter lists	2019-05-05 15:20:10 +09:00
merge-recursive.c	Merge branch 'en/merge-recursive-directory-rename-fixes'	2019-11-10 18:02:13 +09:00
merge-recursive.h	hashmap_entry: remove first member requirement from docs	2019-10-07 10:20:12 +09:00
merge.c	…
mergesort.c	…
mergesort.h	…
midx.c	midx: honor the MIDX_PROGRESS flag in midx_repack	2019-10-23 12:05:06 +09:00
midx.h	midx: add MIDX_PROGRESS flag	2019-10-23 12:05:05 +09:00
name-hash.c	hashmap: remove type arg from hashmap_{get,put,remove}_entry	2019-10-07 10:20:12 +09:00
notes-cache.c	…
notes-cache.h	…
notes-merge.c	…
notes-merge.h	…
notes-utils.c	…
notes-utils.h	…
notes.c	Merge branch 'mh/notes-duplicate-entries'	2019-09-30 13:19:25 +09:00
notes.h	notes: correct documentation of format_display_notes()	2019-05-07 19:08:10 +09:00
object-store.h	Merge branch 'ds/object-info-for-prefetch-fix' into maint	2019-07-25 14:27:08 -07:00
object.c	treewide: remove duplicate #include directives	2019-10-04 08:16:00 +09:00
object.h	commit-graph: fix writing first commit-graph during fetch	2019-10-25 11:19:16 +09:00
oidmap.c	hashmap: introduce hashmap_free_entries	2019-10-07 10:20:11 +09:00
oidmap.h	hashmap: use *_entry APIs for iteration	2019-10-07 10:20:11 +09:00
oidset.c	Merge branch 'br/blame-ignore'	2019-07-19 11:30:20 -07:00
oidset.h	Merge branch 'br/blame-ignore'	2019-07-19 11:30:20 -07:00
pack-bitmap-write.c	pack-objects: drop packlist index_pos optimization	2019-09-06 11:03:42 -07:00
pack-bitmap.c	Merge branch 'jk/misc-uninitialized-fixes'	2019-09-30 13:19:30 +09:00
pack-bitmap.h	pack-bitmap.h: remove magic number	2019-09-28 14:04:20 +09:00
pack-check.c	…
pack-objects.c	pack-objects: drop packlist index_pos optimization	2019-09-06 11:03:42 -07:00
pack-objects.h	pack-objects: drop packlist index_pos optimization	2019-09-06 11:03:42 -07:00
pack-revindex.c	…
pack-revindex.h	…
pack-write.c	pack-write: use hash_to_hex when writing checksums	2019-08-19 15:04:58 -07:00
pack.h	*.[ch]: manually align parameter lists	2019-05-05 15:20:10 +09:00
packfile.c	Merge branch 'ew/hashmap'	2019-10-15 13:48:02 +09:00
packfile.h	Merge branch 'ds/midx-expire-repack'	2019-09-09 12:26:38 -07:00
pager.c	pager: add a helper function to clear the last line in the terminal	2019-06-24 13:38:46 -07:00
parse-options-cb.c	Merge branch 'nd/switch-and-restore'	2019-07-09 15:25:44 -07:00
parse-options.c	parse-options: allow --end-of-options as a synonym for "--"	2019-08-06 13:05:39 -07:00
parse-options.h	Merge branch 'nd/diff-parseopt'	2019-09-09 12:26:38 -07:00
patch-delta.c	…
patch-ids.c	hashmap: remove type arg from hashmap_{get,put,remove}_entry	2019-10-07 10:20:12 +09:00
patch-ids.h	format-patch: make --base patch-id output stable	2019-05-08 19:27:43 +09:00
path.c	Merge branch 'sg/dir-trie-fixes'	2019-11-10 18:02:14 +09:00
path.h	path: add a function to check for path suffix	2019-08-26 10:36:13 -07:00
pathspec.c	…
pathspec.h	…
pkt-line.c	pkt-line: drop 'const'-ness of a param to set_packet_header()	2019-05-16 13:29:06 +09:00
pkt-line.h	*.[ch]: manually align parameter lists	2019-05-05 15:20:10 +09:00
preload-index.c	mark_fsmonitor_valid(): mark the index as changed if needed	2019-05-28 12:43:43 -07:00
pretty.c	pretty: add "%aL" etc. to show local-part of email addresses	2019-10-30 11:49:41 +09:00
pretty.h	…
prio-queue.c	…
prio-queue.h	*.[ch]: remove extern from function declarations using spatch	2019-05-05 15:20:06 +09:00
progress.c	Test the progress display	2019-09-17 09:39:16 -07:00
progress.h	Merge branch 'sg/overlong-progress-fix'	2019-04-25 16:41:19 +09:00
promisor-remote.c	promisor-remote: skip move_to_tail when no-op	2019-10-02 14:56:54 +09:00
promisor-remote.h	Merge branch 'dl/honor-cflags-in-hdr-check'	2019-10-07 11:33:02 +09:00
prompt.c	…
prompt.h	…
protocol.c	…
protocol.h	*.[ch]: remove extern from function declarations using spatch	2019-05-05 15:20:06 +09:00
quote.c	Merge branch 'gs/sq-quote-buf-pretty'	2019-10-15 13:48:02 +09:00
quote.h	quote: add sq_append_quote_argv_pretty()	2019-08-09 10:48:02 -07:00
range-diff.c	Merge branch 'ew/hashmap'	2019-10-15 13:48:02 +09:00
range-diff.h	…
reachable.c	object: convert lookup_object() to use object_id	2019-06-20 10:18:09 -07:00
reachable.h	*.[ch]: manually align parameter lists	2019-05-05 15:20:10 +09:00
read-cache.c	Merge branch 'js/azure-pipelines-msvc'	2019-10-15 13:48:00 +09:00
rebase-interactive.c	…
rebase-interactive.h	…
ref-filter.c	Merge branch 'ew/hashmap'	2019-10-15 13:48:02 +09:00
ref-filter.h	…
reflog-walk.c	…
reflog-walk.h	*.[ch]: manually align parameter lists	2019-05-05 15:20:10 +09:00
refs.c	hashmap_entry: remove first member requirement from docs	2019-10-07 10:20:12 +09:00
refs.h	Merge branch 'nd/worktree-name-sanitization'	2019-06-13 13:19:40 -07:00
refspec.c	…
refspec.h	…
remote-curl.c	Merge branch 'bc/smart-http-atomic-push'	2019-10-23 14:43:11 +09:00
remote-testsvn.c	…
remote.c	hashmap: remove type arg from hashmap_{get,put,remove}_entry	2019-10-07 10:20:12 +09:00
remote.h	hashmap_entry: remove first member requirement from docs	2019-10-07 10:20:12 +09:00
replace-object.c	…
replace-object.h	*.[ch]: manually align parameter lists	2019-05-05 15:20:10 +09:00
repo-settings.c	Merge branch 'ds/feature-macros'	2019-10-24 13:34:03 +09:00
repository.c	…
repository.h	Merge branch 'jk/disable-commit-graph-during-upload-pack'	2019-10-07 11:32:55 +09:00
rerere.c	rerere: replace sha1_to_hex	2019-08-19 15:04:59 -07:00
rerere.h	…
resolve-undo.c	…
resolve-undo.h	*.[ch]: remove extern from function declarations using spatch	2019-05-05 15:20:06 +09:00
revision.c	Merge branch 'ew/hashmap'	2019-10-15 13:48:02 +09:00
revision.h	…
run-command.c	…
run-command.h	*.[ch]: remove extern from function declarations using sed	2019-05-05 15:20:08 +09:00
send-pack.c	send-pack: never fetch when checking exclusions	2019-10-09 10:46:41 +09:00
send-pack.h	…
sequencer.c	Merge branch 'pw/post-commit-from-sequencer'	2019-11-10 18:02:12 +09:00
sequencer.h	Merge branch 'pw/post-commit-from-sequencer'	2019-11-10 18:02:12 +09:00
serve.c	…
serve.h	*.[ch]: manually align parameter lists	2019-05-05 15:20:10 +09:00
server-info.c	Merge branch 'ew/server-info-remove-crufts'	2019-06-17 10:15:15 -07:00
setup.c	Merge branch 'js/gitdir-at-unc-root'	2019-09-30 13:19:26 +09:00
sh-i18n--envsubst.c	cleanup: fix possible overflow errors in binary search, part 2	2019-06-13 11:28:53 -07:00
sha1-array.c	…
sha1-array.h	…
sha1-file.c	Merge branch 'bc/object-id-part17'	2019-10-11 14:24:46 +09:00
sha1-lookup.c	Merge branch 'js/azure-pipelines-msvc'	2019-10-15 13:48:00 +09:00
sha1-lookup.h	*.[ch]: manually align parameter lists	2019-05-05 15:20:10 +09:00
sha1-name.c	Merge branch 'rs/nth-switch-code-simplification'	2019-10-07 11:33:00 +09:00
sha1dc_git.c	…
sha1dc_git.h	…
shallow.c	Merge branch 'rs/dedup-includes'	2019-10-11 14:24:48 +09:00
shell.c	…
shortlog.h	…
sideband.c	…
sideband.h	…
sigchain.c	…
sigchain.h	…
split-index.c	…
split-index.h	…
stable-qsort.c	Move git_sort(), a stable sort, into into libgit.a	2019-10-02 14:44:51 +09:00
strbuf.c	Merge branch 'md/list-objects-filter-combo'	2019-09-18 11:50:09 -07:00
strbuf.h	Merge branch 'md/list-objects-filter-combo'	2019-09-18 11:50:09 -07:00
streaming.c	…
streaming.h	*.[ch]: remove extern from function declarations using spatch	2019-05-05 15:20:06 +09:00
string-list.c	…
string-list.h	*.[ch]: manually align parameter lists	2019-05-05 15:20:10 +09:00
sub-process.c	hashmap: remove type arg from hashmap_{get,put,remove}_entry	2019-10-07 10:20:12 +09:00
sub-process.h	hashmap_entry: remove first member requirement from docs	2019-10-07 10:20:12 +09:00
submodule-config.c	hashmap: remove type arg from hashmap_{get,put,remove}_entry	2019-10-07 10:20:12 +09:00
submodule-config.h	*.[ch]: manually align parameter lists	2019-05-05 15:20:10 +09:00
submodule.c	submodule: drop unused prefix parameter from some functions	2019-05-13 14:22:54 +09:00
submodule.h	submodule: drop unused prefix parameter from some functions	2019-05-13 14:22:54 +09:00
symlinks.c	…
tag.c	tag: factor out get_tagged_oid()	2019-09-05 14:10:18 -07:00
tag.h	tag: factor out get_tagged_oid()	2019-09-05 14:10:18 -07:00
tar.h	…
tempfile.c	…
tempfile.h	*.[ch]: manually align parameter lists	2019-05-05 15:20:10 +09:00
thread-utils.c	…
thread-utils.h	…
tmp-objdir.c	…
tmp-objdir.h	…
trace.c	packfile: drop release_pack_memory()	2019-08-13 12:21:33 -07:00
trace.h	*.[ch]: manually align parameter lists	2019-05-05 15:20:10 +09:00
trace2.c	Merge branch 'jh/trace2'	2019-05-13 23:50:35 +09:00
trace2.h	trace2: rename environment variables to GIT_TRACE2*	2019-05-28 10:20:34 -07:00
trailer.c	…
trailer.h	…
transport-helper.c	Merge branch 'bc/smart-http-atomic-push'	2019-10-23 14:43:11 +09:00
transport-internal.h	transport: teach all vtables to allow fetch first	2019-08-22 14:20:39 -07:00
transport.c	transport: push codepath can take arbitrary repository	2019-10-08 13:20:01 +09:00
transport.h	remote-curl: pass on atomic capability to remote side	2019-10-17 16:08:22 +09:00
tree-diff.c	tree-walk.c: remove the_repo from fill_tree_descriptor()	2019-06-27 12:45:17 -07:00
tree-walk.c	Merge branch 'jk/tree-walk-overflow'	2019-08-22 12:34:10 -07:00
tree-walk.h	Merge branch 'jk/tree-walk-overflow'	2019-08-22 12:34:10 -07:00
tree.c	tree: simplify parse_tree_indirect()	2019-09-03 15:10:53 -07:00
tree.h	…
unicode-width.h	Merge branch 'bb/unicode-12.1-reiwa' into maint	2019-07-25 14:27:11 -07:00
unimplemented.sh	…
unix-socket.c	…
unix-socket.h	…
unpack-trees.c	unpack-trees: correctly compute result count	2020-01-10 11:34:36 -08:00
unpack-trees.h	sparse-checkout: update working directory in-process	2019-11-22 16:11:44 +09:00
upload-pack.c	Merge branch 'jk/disable-commit-graph-during-upload-pack'	2019-10-07 11:32:55 +09:00
upload-pack.h	*.[ch]: manually align parameter lists	2019-05-05 15:20:10 +09:00
url.c	list-objects-filter: implement composite filters	2019-06-28 08:41:53 -07:00
url.h	list-objects-filter: implement composite filters	2019-06-28 08:41:53 -07:00
urlmatch.c	…
urlmatch.h	*.[ch]: remove extern from function declarations using spatch	2019-05-05 15:20:06 +09:00
usage.c	…
userdiff.c	userdiff: fix some corner cases in dts regex	2019-10-21 17:44:12 +09:00
userdiff.h	…
utf8.c	utf8: use ARRAY_SIZE() in git_wcwidth()	2019-10-12 10:57:39 +09:00
utf8.h	*.[ch]: remove extern from function declarations using spatch	2019-05-05 15:20:06 +09:00
varint.c	…
varint.h	*.[ch]: remove extern from function declarations using spatch	2019-05-05 15:20:06 +09:00
version.c	…
version.h	…
versioncmp.c	…
walker.c	object: convert lookup_unknown_object() to use object_id	2019-06-20 10:06:19 -07:00
walker.h	…
wildmatch.c	…
wildmatch.h	…
worktree.c	Merge branch 'nd/corrupt-worktrees' into maint	2019-07-25 14:27:07 -07:00
worktree.h	*.[ch]: manually align parameter lists	2019-05-05 15:20:10 +09:00
wrap-for-bin.sh	…
wrapper.c	Merge branch 'ah/cleanups'	2019-10-09 14:01:00 +09:00
write-or-die.c	…
ws.c	…
wt-status.c	Merge branch 'bc/object-id-part17'	2019-10-11 14:24:46 +09:00
wt-status.h	wt-status: convert struct wt_status to object_id	2019-08-19 15:04:59 -07:00
xdiff-interface.c	…
xdiff-interface.h	*.[ch]: manually align parameter lists	2019-05-05 15:20:10 +09:00
zlib.c	…

README.md

Git - fast, scalable, distributed revision control system

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

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

Please read the file INSTALL for installation instructions.

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

See Documentation/gittutorial.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). To subscribe to the list, send an email with just "subscribe git" in the body to majordomo@vger.kernel.org. The mailing list archives are available at https://public-inbox.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