Go to file

Johannes Schindelin 0060fd1511 clone --recurse-submodules: prevent name squatting on Windows In addition to preventing `.git` from being tracked by Git, on Windows we also have to prevent `git~1` from being tracked, as the default NTFS short name (also known as the "8.3 filename") for the file name `.git` is `git~1`, otherwise it would be possible for malicious repositories to write directly into the `.git/` directory, e.g. a `post-checkout` hook that would then be executed _during_ a recursive clone. When we implemented appropriate protections in `2b4c6efc82` (read-cache: optionally disallow NTFS .git variants, 2014-12-16), we had analyzed carefully that the `.git` directory or file would be guaranteed to be the first directory entry to be written. Otherwise it would be possible e.g. for a file named `..git` to be assigned the short name `git~1` and subsequently, the short name generated for `.git` would be `git~2`. Or `git~3`. Or even `~9999999` (for a detailed explanation of the lengths we have to go to protect `.gitmodules`, see the commit message of `e7cb0b4455` (is_ntfs_dotgit: match other .git files, 2018-05-11)). However, by exploiting two issues (that will be addressed in a related patch series close by), it is currently possible to clone a submodule into a non-empty directory: - On Windows, file names cannot end in a space or a period (for historical reasons: the period separating the base name from the file extension was not actually written to disk, and the base name/file extension was space-padded to the full 8/3 characters, respectively). Helpfully, when creating a directory under the name, say, `sub.`, that trailing period is trimmed automatically and the actual name on disk is `sub`. This means that while Git thinks that the submodule names `sub` and `sub.` are different, they both access `.git/modules/sub/`. - While the backslash character is a valid file name character on Linux, it is not so on Windows. As Git tries to be cross-platform, it therefore allows backslash characters in the file names stored in tree objects. Which means that it is totally possible that a submodule `c` sits next to a file `c\..git`, and on Windows, during recursive clone a file called `..git` will be written into `c/`, of course _before_ the submodule is cloned. Note that the actual exploit is not quite as simple as having a submodule `c` next to a file `c\..git`, as we have to make sure that the directory `.git/modules/b` already exists when the submodule is checked out, otherwise a different code path is taken in `module_clone()` that does _not_ allow a non-empty submodule directory to exist already. Even if we will address both issues nearby (the next commit will disallow backslash characters in tree entries' file names on Windows, and another patch will disallow creating directories/files with trailing spaces or periods), it is a wise idea to defend in depth against this sort of attack vector: when submodules are cloned recursively, we now _require_ the directory to be empty, addressing CVE-2019-1349. Note: the code path we patch is shared with the code path of `git submodule update --init`, which must not expect, in general, that the directory is empty. Hence we have to introduce the new option `--force-init` and hand it all the way down from `git submodule` to the actual `git submodule--helper` process that performs the initial clone. Reported-by: Nicolas Joly <Nicolas.Joly@microsoft.com> Signed-off-by: Johannes Schindelin <johannes.schindelin@gmx.de>		2019-12-04 13:20:05 +01:00
.github	Configure Git contribution guidelines for github.com	2017-06-13 08:41:47 -07:00
Documentation	fast-import: disallow "feature import-marks" by default	2019-12-04 13:20:04 +01:00
block-sha1	…
builtin	clone --recurse-submodules: prevent name squatting on Windows	2019-12-04 13:20:05 +01:00
ci	travis-ci: fix "skip_branch_tip_with_tag()" string comparison	2017-09-22 10:58:29 +09:00
compat	Merge branch 'rb/compat-poll-fix' into maint	2017-10-18 14:19:05 +09:00
contrib	Merge branch 'tb/complete-describe' into maint	2017-10-18 14:19:14 +09:00
ewah	use DIV_ROUND_UP	2017-07-10 14:24:36 -07:00
git-gui	Merge branch 'js/msgfmt-on-windows' of ../git-gui into js/git-gui-msgfmt-on-windows	2017-07-25 13:42:41 -07:00
gitk-git	…
gitweb	Merge branch 'hb/gitweb-project-list' into maint	2017-08-23 14:33:44 -07:00
mergetools	mergetools/meld: improve compatibiilty with Meld on macOS X	2017-06-18 22:11:29 -07:00
perl	Merge branch 'jc/perl-git-comment-typofix' into maint	2017-09-10 17:02:57 +09:00
po	l10n: zh_CN: review for git v2.14.0 l10n	2017-08-02 08:02:37 +08:00
ppc	…
refs	convert less-trivial versions of "write_in_full() != len"	2017-09-14 15:17:59 +09:00
sha1collisiondetection@19d97bf5af	sha1dc: optionally use sha1collisiondetection as a submodule	2017-07-03 10:09:34 -07:00
sha1dc	Merge branch 'ab/sha1dc-maint'	2017-07-06 18:14:44 -07:00
t	clone --recurse-submodules: prevent name squatting on Windows	2019-12-04 13:20:05 +01:00
templates	pre-rebase hook: capture documentation in a <<here document	2017-07-11 08:56:33 -07:00
vcs-svn	Merge branch 'jn/vcs-svn-cleanup' into maint	2017-09-10 17:03:09 +09:00
xdiff	…
.gitattributes	Fix build with core.autocrlf=true	2017-05-10 13:32:50 +09:00
.gitignore	…
.gitmodules	sha1dc: optionally use sha1collisiondetection as a submodule	2017-07-03 10:09:34 -07:00
.mailmap	.mailmap: normalize name for René Scharfe	2017-10-06 11:31:41 +09:00
.travis.yml	travis-ci: move Travis CI code into dedicated scripts	2017-09-11 09:54:08 +09:00
.tsan-suppressions	ThreadSanitizer: add suppressions	2017-08-23 10:38:56 -07:00
COPYING	…
GIT-VERSION-GEN	Git 2.14.5	2018-09-27 11:19:11 -07:00
INSTALL	…
LGPL-2.1	…
Makefile	Merge branch 'jn/vcs-svn-cleanup' into maint	2017-09-10 17:03:09 +09:00
README.md	…
RelNotes	Git 2.14.5	2018-09-27 11:19:11 -07:00
abspath.c	Spelling fixes	2017-06-27 10:35:49 -07:00
aclocal.m4	…
advice.c	Merge branch 'jk/warn-add-gitlink'	2017-06-24 14:28:41 -07:00
advice.h	add: warn when adding an embedded repository	2017-06-15 09:10:44 -07:00
alias.c	Merge branch 'js/alias-case-sensitivity'	2017-07-20 16:29:59 -07:00
alloc.c	…
apply.c	Sync with Git 2.13.7	2018-05-22 14:10:49 +09:00
apply.h	apply: remove prefix_length member from apply_state	2017-08-09 10:21:45 -07:00
archive-tar.c	Merge branch 'bw/config-h'	2017-06-24 14:28:41 -07:00
archive-zip.c	Merge branch 'bw/config-h'	2017-06-24 14:28:41 -07:00
archive.c	archive: don't add empty directories to archives	2017-09-14 15:08:22 +09:00
archive.h	timestamp_t: a new data type for timestamps	2017-04-27 13:07:39 +09:00
argv-array.c	…
argv-array.h	…
attr.c	hashmap.h: compare function has access to a data field	2017-06-30 12:49:28 -07:00
attr.h	…
base85.c	…
bisect.c	Merge branch 'bw/config-h'	2017-06-24 14:28:41 -07:00
bisect.h	…
blame.c	Merge branch 'js/blame-lib'	2017-07-31 13:05:15 -07:00
blame.h	blame: move entry prepend to libgit	2017-05-25 13:08:23 +09:00
blob.c	Convert lookup_blob to struct object_id	2017-05-08 15:12:57 +09:00
blob.h	Convert lookup_blob to struct object_id	2017-05-08 15:12:57 +09:00
branch.c	Merge branch 'nd/worktree-kill-parse-ref' into maint	2017-10-23 14:14:16 +09:00
branch.h	…
builtin.h	git.c: provide setup_auto_pager()	2017-08-03 11:08:10 -07:00
bulk-checkin.c	pack: convert struct pack_idx_entry to struct object_id	2017-05-08 15:12:57 +09:00
bulk-checkin.h	…
bundle.c	Merge branch 'bc/object-id'	2017-05-29 12:34:43 +09:00
bundle.h	bundle: convert to struct object_id	2017-05-02 10:46:41 +09:00
cache-tree.c	use MOVE_ARRAY	2017-07-17 14:54:56 -07:00
cache-tree.h	Convert struct cache_tree to use struct object_id	2017-05-02 10:46:41 +09:00
cache.h	Sync with Git 2.13.7	2018-05-22 14:10:49 +09:00
check-builtins.sh	…
check-racy.c	…
check_bindir	…
color.c	Revert "color: check color.ui in git_default_config()"	2017-10-17 15:09:52 +09:00
color.h	…
column.c	config: don't include config.h by default	2017-06-15 12:56:22 -07:00
column.h	…
combine-diff.c	Merge branch 'bw/ls-files-sans-the-index'	2017-06-24 14:28:40 -07:00
command-list.txt	…
commit-slab.h	commit-slab.h: avoid -Wsign-compare warnings	2017-09-22 13:00:36 +09:00
commit.c	use MOVE_ARRAY	2017-07-17 14:54:56 -07:00
commit.h	commit: remove unused inline function single_parent()	2017-08-19 09:24:05 -07:00
common-main.c	…
config.c	Merge branch 'jk/write-in-full-fix' into maint	2017-10-23 14:37:22 +09:00
config.h	config: read config from a repository object	2017-06-23 18:24:34 -07:00
config.mak.in	…
config.mak.uname	config.mak.uname: set FREAD_READS_DIRECTORIES for cygwin	2017-07-21 11:58:06 -07:00
configure.ac	Merge branch 'nd/fopen-errors'	2017-06-22 14:15:20 -07:00
connect.c	Git 2.13.5	2017-08-04 12:40:37 -07:00
connect.h	…
connected.c	…
connected.h	…
convert.c	Merge branch 'ma/ts-cleanups' into maint	2017-10-23 14:19:02 +09:00
convert.h	Merge branch 'tb/apply-with-crlf' into maint	2017-09-10 17:02:55 +09:00
copy.c	…
credential-cache--daemon.c	Merge branch 'bw/config-h'	2017-06-24 14:28:41 -07:00
credential-cache.c	Merge branch 'dl/credential-cache-socket-in-xdg-cache' into maint	2017-08-23 14:33:45 -07:00
credential-store.c	path.c: and an option to call real_path() in expand_user_path()	2017-04-14 23:51:38 -07:00
credential.c	Merge branch 'ab/free-and-null'	2017-06-24 14:28:41 -07:00
credential.h	…
csum-file.c	…
csum-file.h	…
ctype.c	…
daemon.c	config: don't include config.h by default	2017-06-15 12:56:22 -07:00
date.c	Merge branch 'ab/strbuf-addftime-tzname-boolify'	2017-07-06 18:14:47 -07:00
decorate.c	…
decorate.h	…
delta.h	…
diff-delta.c	…
diff-lib.c	Merge branch 'ab/free-and-null'	2017-06-24 14:28:41 -07:00
diff-no-index.c	diff: convert fill_filespec to struct object_id	2017-06-02 09:36:07 +09:00
diff.c	Merge branch 'jk/write-in-full-fix' into maint	2017-10-23 14:37:22 +09:00
diff.h	Merge branch 'bw/object-id'	2017-06-19 12:38:44 -07:00
diffcore-break.c	…
diffcore-delta.c	…
diffcore-order.c	wildmatch: remove unused wildopts parameter	2017-06-23 18:27:07 -07:00
diffcore-pickaxe.c	Merge branch 'js/regexec-buf' into maint	2017-03-28 13:52:24 -07:00
diffcore-rename.c	hashmap.h: compare function has access to a data field	2017-06-30 12:49:28 -07:00
diffcore.h	diff: convert fill_filespec to struct object_id	2017-06-02 09:36:07 +09:00
dir-iterator.c	…
dir-iterator.h	…
dir.c	Merge branch 'rs/stat-data-unaligned-reads-fix' into maint	2017-08-23 14:33:48 -07:00
dir.h	Merge branch 'pc/dir-count-slashes'	2017-06-22 14:15:21 -07:00
editor.c	…
entry.c	convert less-trivial versions of "write_in_full() != len"	2017-09-14 15:17:59 +09:00
environment.c	Merge branch 'bw/config-h'	2017-06-24 14:28:41 -07:00
exec_cmd.c	git_extract_argv0_path: do nothing without RUNTIME_PREFIX	2017-09-07 09:41:14 +09:00
exec_cmd.h	…
fast-import.c	fast-import: disallow "feature import-marks" by default	2019-12-04 13:20:04 +01:00
fetch-pack.c	Merge branch 'bw/config-h'	2017-06-24 14:28:41 -07:00
fetch-pack.h	Rename sha1_array to oid_array	2017-03-31 08:33:56 -07:00
fmt-merge-msg.h	…
fsck.c	fsck: handle NULL return of lookup_blob() and lookup_tree()	2017-10-06 11:04:34 +09:00
fsck.h	Rename sha1_array to oid_array	2017-03-31 08:33:56 -07:00
generate-cmdlist.sh	…
gettext.c	…
gettext.h	…
git-add--interactive.perl	Merge branch 'pw/unquote-path-in-git-pm' into maint	2017-07-31 13:51:05 -07:00
git-archimport.perl	archimport: use safe_pipe_capture for user input	2017-09-12 11:08:15 +09:00
git-bisect.sh	…
git-compat-util.h	Sync with Git 2.13.7	2018-05-22 14:10:49 +09:00
git-cvsexportcommit.perl	…
git-cvsimport.perl	cvsimport: shell-quote variable used in backticks	2017-09-12 11:10:22 +09:00
git-cvsserver.perl	cvsserver: use safe_pipe_capture for `constant commands` as well	2017-09-11 14:52:29 +09:00
git-difftool--helper.sh	…
git-filter-branch.sh	filter-branch: add [--] to usage	2017-06-12 09:49:52 -07:00
git-instaweb.sh	…
git-merge-octopus.sh	scripts: use "git foo" not "git-foo"	2017-08-07 12:04:45 -07:00
git-merge-one-file.sh	scripts: use "git foo" not "git-foo"	2017-08-07 12:04:45 -07:00
git-merge-resolve.sh	scripts: use "git foo" not "git-foo"	2017-08-07 12:04:45 -07:00
git-mergetool--lib.sh	…
git-mergetool.sh	…
git-p4.py	git-p4: filter for {'code':'info'} in p4CmdList	2017-07-13 10:52:42 -07:00
git-parse-remote.sh	…
git-quiltimport.sh	…
git-rebase--am.sh	rebase: honor --rerere-autoupdate	2017-08-02 15:16:09 -07:00
git-rebase--interactive.sh	rebase -i: honor --rerere-autoupdate	2017-08-02 15:16:09 -07:00
git-rebase--merge.sh	…
git-rebase.sh	Merge branch 'pw/rebase-i-regression-fix-tests' into maint	2017-07-10 13:59:00 -07:00
git-remote-testgit.sh	…
git-request-pull.sh	request-pull: capitalise "Git" to make it a proper noun	2017-10-03 13:11:57 +09:00
git-send-email.perl	send-email: don't use Mail::Address, even if available	2017-08-24 14:40:17 -07:00
git-sh-i18n.sh	…
git-sh-setup.sh	…
git-stash.sh	Merge branch 'mf/no-dashed-subcommands' into maint	2017-09-10 17:02:56 +09:00
git-submodule.sh	clone --recurse-submodules: prevent name squatting on Windows	2019-12-04 13:20:05 +01:00
git-svn.perl	…
git-web--browse.sh	…
git.c	git.c: ignore pager.* when launching builtin as dashed external	2017-08-03 11:08:11 -07:00
git.rc	…
gpg-interface.c	Merge branch 'ab/free-and-null'	2017-06-24 14:28:41 -07:00
gpg-interface.h	…
graph.c	config: don't include config.h by default	2017-06-15 12:56:22 -07:00
graph.h	…
grep.c	Merge branch 'as/grep-quiet-no-match-exit-code-fix' into maint	2017-09-10 17:02:55 +09:00
grep.h	grep: remove regflags from the public grep_opt API	2017-06-30 10:06:24 -07:00
hash.h	sha1dc: optionally use sha1collisiondetection as a submodule	2017-07-03 10:09:34 -07:00
hashmap.c	hashmap.h: compare function has access to a data field	2017-06-30 12:49:28 -07:00
hashmap.h	hashmap: migrate documentation from Documentation/technical into header	2017-06-30 13:11:59 -07:00
help.c	Merge branch 'mb/reword-autocomplete-message' into maint	2017-07-10 13:59:04 -07:00
help.h	…
hex.c	Convert GIT_SHA1_HEXSZ used for allocation to GIT_MAX_HEXSZ	2017-03-26 22:08:21 -07:00
http-backend.c	avoid "write_in_full(fd, buf, len) != len" pattern	2017-09-14 15:17:59 +09:00
http-fetch.c	config: don't include config.h by default	2017-06-15 12:56:22 -07:00
http-push.c	http-push: fix construction of hex value from path	2017-10-04 13:48:35 +09:00
http-walker.c	Merge branch 'ew/http-alternates-as-redirects-warning' into maint	2017-03-28 13:52:23 -07:00
http.c	Merge branch 'jc/http-sslkey-and-ssl-cert-are-paths' into maint	2017-08-23 14:33:43 -07:00
http.h	http.postbuffer: allow full range of ssize_t values	2017-04-13 18:24:32 -07:00
ident.c	Merge branch 'bw/config-h'	2017-06-24 14:28:41 -07:00
imap-send.c	Merge branch 'rs/use-div-round-up'	2017-07-12 15:18:23 -07:00
iterator.h	…
khash.h	…
kwset.c	…
kwset.h	…
levenshtein.c	…
levenshtein.h	…
line-log.c	ALLOC_GROW: avoid -Wsign-compare warnings	2017-09-22 13:21:11 +09:00
line-log.h	ALLOC_GROW: avoid -Wsign-compare warnings	2017-09-22 13:21:11 +09:00
line-range.c	…
line-range.h	…
list-objects.c	Convert lookup_tree to struct object_id	2017-05-08 15:12:57 +09:00
list-objects.h	…
list.h	…
ll-merge.c	avoid "write_in_full(fd, buf, len) != len" pattern	2017-09-14 15:17:59 +09:00
ll-merge.h	…
lockfile.c	…
lockfile.h	lockfile: add a new method, is_lock_file_locked()	2017-05-23 14:29:54 +09:00
log-tree.c	Merge branch 'bw/config-h'	2017-06-24 14:28:41 -07:00
log-tree.h	…
mailinfo.c	Merge branch 'rs/mailinfo-qp-decode-fix' into maint	2017-10-18 14:19:03 +09:00
mailinfo.h	…
mailmap.c	…
mailmap.h	…
match-trees.c	…
merge-blobs.c	…
merge-blobs.h	…
merge-recursive.c	Merge branch 'sb/merge-recursive-code-cleanup'	2017-07-06 18:14:45 -07:00
merge-recursive.h	…
merge.c	tree: convert parse_tree_indirect to struct object_id	2017-05-08 15:12:58 +09:00
mergesort.c	…
mergesort.h	…
mru.c	…
mru.h	…
name-hash.c	hashmap.h: compare function has access to a data field	2017-06-30 12:49:28 -07:00
notes-cache.c	notes: convert some accessor functions to struct object_id	2017-06-02 09:36:06 +09:00
notes-cache.h	notes-cache: convert to struct object_id	2017-05-08 15:12:57 +09:00
notes-merge.c	notes-merge: use ssize_t for write_in_full() return value	2017-09-14 15:17:59 +09:00
notes-merge.h	notes-merge: convert notes_merge* to struct object_id	2017-06-05 11:23:58 +09:00
notes-utils.c	Merge branch 'bw/config-h'	2017-06-24 14:28:41 -07:00
notes-utils.h	builtin/notes: convert to struct object_id	2017-06-02 09:36:06 +09:00
notes.c	Merge branch 'bw/config-h'	2017-06-24 14:28:41 -07:00
notes.h	notes: convert some accessor functions to struct object_id	2017-06-02 09:36:06 +09:00
object.c	object: remove "used" field from struct object	2017-07-20 14:54:08 -07:00
object.h	object: remove "used" field from struct object	2017-07-20 14:54:08 -07:00
oidset.c	hashmap.h: compare function has access to a data field	2017-06-30 12:49:28 -07:00
oidset.h	…
pack-bitmap-write.c	pack: convert struct pack_idx_entry to struct object_id	2017-05-08 15:12:57 +09:00
pack-bitmap.c	Merge branch 'jc/pack-bitmap-unaligned' into maint	2017-07-10 13:59:00 -07:00
pack-bitmap.h	…
pack-check.c	Convert the verify_pack callback to struct object_id	2017-05-08 15:12:57 +09:00
pack-objects.c	pack: convert struct pack_idx_entry to struct object_id	2017-05-08 15:12:57 +09:00
pack-objects.h	…
pack-revindex.c	…
pack-revindex.h	…
pack-write.c	pack: convert struct pack_idx_entry to struct object_id	2017-05-08 15:12:57 +09:00
pack.h	Convert the verify_pack callback to struct object_id	2017-05-08 15:12:57 +09:00
pager.c	config: don't include config.h by default	2017-06-15 12:56:22 -07:00
parse-options-cb.c	Merge branch 'bc/object-id'	2017-05-29 12:34:43 +09:00
parse-options.c	Merge branch 'bw/config-h'	2017-06-24 14:28:41 -07:00
parse-options.h	ref-filter: add --no-contains option to tag/branch/for-each-ref	2017-03-24 12:15:26 -07:00
patch-delta.c	…
patch-ids.c	patch-ids.c: use hashmap correctly	2017-06-30 13:11:54 -07:00
patch-ids.h	patch-ids: convert to struct object_id	2017-06-02 09:36:07 +09:00
path.c	Sync with Git 2.13.7	2018-05-22 14:10:49 +09:00
path.h	path: add repo_worktree_path and strbuf_repo_worktree_path	2017-06-23 18:24:34 -07:00
pathspec.c	Spelling fixes	2017-06-27 10:35:49 -07:00
pathspec.h	pathspec: convert find_pathspecs_matching_against_index to take an index	2017-05-12 14:23:46 +09:00
pkt-line.c	Merge branch 'jk/write-in-full-fix' into maint	2017-10-23 14:37:22 +09:00
pkt-line.h	sub-process: refactor handshake to common function	2017-07-26 13:00:40 -07:00
preload-index.c	…
pretty.c	pretty: respect color settings for %C placeholders	2017-07-13 12:42:51 -07:00
prio-queue.c	*.[ch] refactoring: make use of the FREE_AND_NULL() macro	2017-06-16 12:44:09 -07:00
prio-queue.h	…
progress.c	progress: show overall rate in last update	2017-07-09 09:54:20 -07:00
progress.h	…
prompt.c	config: don't include config.h by default	2017-06-15 12:56:22 -07:00
prompt.h	…
quote.c	…
quote.h	…
reachable.c	Merge branch 'bc/object-id'	2017-05-29 12:34:43 +09:00
reachable.h	timestamp_t: a new data type for timestamps	2017-04-27 13:07:39 +09:00
read-cache.c	Sync with Git 2.13.7	2018-05-22 14:10:49 +09:00
ref-filter.c	ref-filter.c: pass empty-string as NULL to atom parsers	2017-10-05 10:41:57 +09:00
ref-filter.h	ref-filter: consult want_color() before emitting colors	2017-07-13 12:42:51 -07:00
reflog-walk.c	use MOVE_ARRAY	2017-07-17 14:54:56 -07:00
reflog-walk.h	reflog-walk: apply --since/--until to reflog dates	2017-07-09 10:00:48 -07:00
refs.c	Merge branch 'jk/write-in-full-fix' into maint	2017-10-23 14:37:22 +09:00
refs.h	refs: strip out not allowed flags from ref_transaction_update	2017-09-14 14:46:05 +09:00
remote-curl.c	config: don't include config.h by default	2017-06-15 12:56:22 -07:00
remote-testsvn.c	Merge branch 'ab/free-and-null'	2017-06-24 14:28:41 -07:00
remote.c	hashmap.h: compare function has access to a data field	2017-06-30 12:49:28 -07:00
remote.h	Merge branch 'bw/push-options-recursively-to-submodules'	2017-04-19 21:37:14 -07:00
replace_object.c	…
repository.c	repository: enable initialization of submodules	2017-06-23 18:24:34 -07:00
repository.h	repository: enable initialization of submodules	2017-06-23 18:24:34 -07:00
rerere.c	avoid "write_in_full(fd, buf, len) != len" pattern	2017-09-14 15:17:59 +09:00
rerere.h	…
resolve-undo.c	…
resolve-undo.h	…
revision.c	ALLOC_GROW: avoid -Wsign-compare warnings	2017-09-22 13:21:11 +09:00
revision.h	revision: add rev_input_given flag	2017-08-02 15:45:20 -07:00
run-command.c	run-command: use ALLOC_ARRAY	2017-10-03 08:42:57 +09:00
run-command.h	run-command: expose is_executable function	2017-04-25 18:45:29 -07:00
send-pack.c	Spelling fixes	2017-06-27 10:35:49 -07:00
send-pack.h	Rename sha1_array to oid_array	2017-03-31 08:33:56 -07:00
sequencer.c	cherry-pick/revert: remember --rerere-autoupdate	2017-08-02 15:16:09 -07:00
sequencer.h	…
server-info.c	Merge branch 'nd/fopen-errors'	2017-06-13 13:47:09 -07:00
setup.c	Merge branch 'js/alias-early-config' into maint	2017-07-10 13:58:58 -07:00
sh-i18n--envsubst.c	…
sha1-array.c	coccinelle: make use of the "type" FREE_AND_NULL() rule	2017-06-16 12:44:03 -07:00
sha1-array.h	Rename sha1_array to oid_array	2017-03-31 08:33:56 -07:00
sha1-lookup.c	sha1_file: drop experimental GIT_USE_LOOKUP search	2017-08-09 11:03:35 -07:00
sha1-lookup.h	sha1-lookup: remove sha1_entry_pos() from header file	2017-08-25 09:54:26 -07:00
sha1_file.c	Merge branch 'jk/info-alternates-fix' into maint	2017-10-23 14:40:00 +09:00
sha1_name.c	Merge branch 'rs/use-div-round-up'	2017-07-12 15:18:23 -07:00
sha1dc_git.c	sha1dc: update from upstream	2017-05-22 10:20:46 +09:00
sha1dc_git.h	sha1dc: update from upstream	2017-05-22 10:20:46 +09:00
shallow.c	avoid "write_in_full(fd, buf, len) != len" pattern	2017-09-14 15:17:59 +09:00
shell.c	shell: drop git-cvsserver support by default	2017-09-12 11:05:58 +09:00
shortlog.h	…
show-index.c	…
sideband.c	…
sideband.h	…
sigchain.c	…
sigchain.h	…
split-index.c	Merge branch 'ab/free-and-null'	2017-06-24 14:28:41 -07:00
split-index.h	Revert "split-index: add and use unshare_split_index()"	2017-06-24 12:02:39 -07:00
strbuf.c	Merge branch 'rs/strbuf-getwholeline-fix' into maint	2017-10-18 14:18:58 +09:00
strbuf.h	Merge branch 'ma/ts-cleanups' into maint	2017-10-23 14:19:02 +09:00
streaming.c	convert less-trivial versions of "write_in_full() != len"	2017-09-14 15:17:59 +09:00
streaming.h	…
string-list.c	use MOVE_ARRAY	2017-07-17 14:54:56 -07:00
string-list.h	for_each_string_list_item: avoid undefined behavior for empty list	2017-09-20 14:41:08 +09:00
sub-process.c	Merge branch 'cc/subprocess-handshake-missing-capabilities' into maint	2017-10-18 14:19:10 +09:00
sub-process.h	sub-process: refactor handshake to common function	2017-07-26 13:00:40 -07:00
submodule-config.c	submodule-config: ban submodule paths that start with a dash	2018-09-27 09:34:59 -07:00
submodule-config.h	Sync with Git 2.13.7	2018-05-22 14:10:49 +09:00
submodule.c	Merge branch 'bw/push-options-recursively-to-submodules' into maint	2017-09-10 17:02:49 +09:00
submodule.h	submodule.h: typofix	2017-09-22 10:59:52 +09:00
symlinks.c	…
tag.c	tag: avoid NULL pointer arithmetic	2017-10-02 13:14:33 +09:00
tag.h	Merge branch 'bc/object-id'	2017-05-29 12:34:43 +09:00
tar.h	…
tempfile.c	…
tempfile.h	…
thread-utils.c	…
thread-utils.h	…
tmp-objdir.c	…
tmp-objdir.h	…
trace.c	…
trace.h	…
trailer.c	config: don't include config.h by default	2017-06-15 12:56:22 -07:00
trailer.h	…
transport-helper.c	fast-import: disallow "feature export-marks" by default	2019-12-04 13:20:04 +01:00
transport.c	Merge branch 'ab/free-and-null'	2017-06-24 14:28:41 -07:00
transport.h	…
tree-diff.c	Merge branch 'ab/free-and-null'	2017-06-24 14:28:41 -07:00
tree-walk.c	ALLOC_GROW: avoid -Wsign-compare warnings	2017-09-22 13:21:11 +09:00
tree-walk.h	…
tree.c	Merge branch 'ab/free-and-null'	2017-06-24 14:28:41 -07:00
tree.h	tree: convert read_tree to take an index parameter	2017-06-13 11:40:51 -07:00
unicode_width.h	unicode: update the width tables to Unicode 10	2017-07-07 10:33:30 -07:00
unimplemented.sh	…
unix-socket.c	…
unix-socket.h	…
unpack-trees.c	Merge branch 'ls/filter-process-delayed' into jt/subprocess-handshake	2017-07-26 12:56:19 -07:00
unpack-trees.h	…
upload-pack.c	Merge branch 'bw/config-h'	2017-06-24 14:28:41 -07:00
url.c	…
url.h	…
urlmatch.c	urlmatch: use hex2chr() in append_normalized_escapes()	2017-07-09 09:43:01 -07:00
urlmatch.h	…
usage.c	die(): stop hiding errors due to overzealous recursion guard	2017-06-21 14:09:13 -07:00
userdiff.c	Merge branch 'ik/userdiff-html-h-element-fix' into maint	2017-10-18 14:19:02 +09:00
userdiff.h	…
utf8.c	is_hfs_dotgit: match other .git files	2018-05-21 23:50:11 -04:00
utf8.h	is_hfs_dotgit: match other .git files	2018-05-21 23:50:11 -04:00
varint.c	…
varint.h	…
version.c	…
version.h	…
versioncmp.c	config: don't include config.h by default	2017-06-15 12:56:22 -07:00
walker.c	object: convert parse_object* to take struct object_id	2017-05-08 15:12:58 +09:00
walker.h	…
wildmatch.c	wildmatch: remove unused wildopts parameter	2017-06-23 18:27:07 -07:00
wildmatch.h	wildmatch: remove unused wildopts parameter	2017-06-23 18:27:07 -07:00
worktree.c	Merge branch 'nd/worktree-kill-parse-ref' into maint	2017-10-23 14:14:16 +09:00
worktree.h	worktree.c: kill parse_ref() in favor of refs_resolve_ref_unsafe()	2017-04-24 21:28:55 -07:00
wrap-for-bin.sh	…
wrapper.c	avoid "write_in_full(fd, buf, len) != len" pattern	2017-09-14 15:17:59 +09:00
write_or_die.c	…
ws.c	…
wt-status.c	Merge branch 'rs/wt-status-cleanup'	2017-07-12 15:18:23 -07:00
wt-status.h	Merge branch 'ks/status-initial-commit'	2017-06-30 13:45:22 -07:00
xdiff-interface.c	Merge branch 'bw/config-h'	2017-06-24 14:28:41 -07:00
xdiff-interface.h	…
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-.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.

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