Go to file
Patrick Steinhardt e509b5b8be rust: support for Windows
The initial patch series that introduced Rust into the core of Git only
cared about macOS and Linux. This specifically leaves out Windows, which
indeed fails to build right now due to two issues:

  - The Rust runtime requires `GetUserProfileDirectoryW()`, but we don't
    link against "userenv.dll".

  - The path of the Rust library built on Windows is different than on
    most other systems systems.

Fix both of these issues to support Windows.

Note that this commit fixes the Meson-based job in GitHub's CI. Meson
auto-detects the availability of Rust, and as the Windows runner has
Rust installed by default it already enabled Rust support there. But due
to the above issues that job fails consistently.

Install Rust on GitLab CI, as well, to improve test coverage there.

Based-on-patch-by: Johannes Schindelin <johannes.schindelin@gmx.de>
Based-on-patch-by: Ezekiel Newren <ezekielnewren@gmail.com>
Signed-off-by: Patrick Steinhardt <ps@pks.im>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
2025-10-15 08:10:17 -07:00
.github ci: check formatting of our Rust code 2025-10-15 08:10:17 -07:00
Documentation Merge branch 'ps/rust-balloon' into ps/ci-rust 2025-10-07 10:55:39 -07:00
bin-wrappers
block-sha1
builtin Merge branch 'kh/you-still-use-whatchanged-fix' 2025-10-02 12:26:12 -07:00
ci ci: verify minimum supported Rust version 2025-10-15 08:10:17 -07:00
compat
compiler-tricks
contrib Merge branch 'ps/meson-build-docs' 2025-10-02 12:26:12 -07:00
ewah
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
mergetools
negotiator
oss-fuzz commit-graph: refactor `parse_commit_graph()` to take a repository 2025-08-15 09:34:47 -07:00
perl
po git-gui: sync Makefiles with git.git 2025-09-06 11:59:48 +02:00
refs Merge branch 'ms/refs-optimize' 2025-10-02 12:26:12 -07:00
reftable reftable: don't second-guess errors from flock interface 2025-08-12 07:41:00 -07:00
sha1
sha1collisiondetection@855827c583
sha1dc
sha256
src rust: support for Windows 2025-10-15 08:10:17 -07:00
subprojects
t Merge branch 'ps/gitlab-ci-windows-improvements' into ps/ci-rust 2025-10-07 10:55:57 -07:00
templates
trace2
xdiff xdiff: optimize xdl_hash_record_verbatim 2025-08-18 08:44:49 -07:00
.cirrus.yml
.clang-format
.editorconfig
.gitattributes
.gitignore Merge branch 'ps/rust-balloon' into ps/ci-rust 2025-10-07 10:55:39 -07:00
.gitlab-ci.yml rust: support for Windows 2025-10-15 08:10:17 -07:00
.gitmodules
.mailmap mailmap: consolidate multiple addresses into one 2025-09-16 17:55:25 -07:00
.tsan-suppressions
CODE_OF_CONDUCT.md
COPYING
Cargo.toml ci: verify minimum supported Rust version 2025-10-15 08:10:17 -07:00
GIT-BUILD-OPTIONS.in
GIT-VERSION-FILE.in
GIT-VERSION-GEN Start 2.52 cycle, the first batch 2025-08-21 13:47:03 -07:00
INSTALL
LGPL-2.1
Makefile rust: support for Windows 2025-10-15 08:10:17 -07:00
README.md gitk: add README with usage, build, and contribution details 2025-08-28 19:51:31 +02:00
RelNotes Start 2.52 cycle, the first batch 2025-08-21 13:47:03 -07:00
SECURITY.md
abspath.c
abspath.h
aclocal.m4
add-interactive.c add-interactive: retain colorbool values longer 2025-09-16 18:00:25 -07:00
add-interactive.h add-interactive: retain colorbool values longer 2025-09-16 18:00:25 -07:00
add-patch.c add-interactive: respect color.diff for diff coloring 2025-09-08 14:00:32 -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
apply.h
archive-tar.c
archive-zip.c
archive.c
archive.h
attr.c
attr.h
banned.h
base85.c
base85.h
bisect.c revision: add wrapper to setup_revisions() from a strvec 2025-09-22 14:27:03 -07:00
bisect.h
blame.c
blame.h
blob.c
blob.h
bloom.c
bloom.h
branch.c
branch.h
builtin.h Merge branch 'tc/last-modified' 2025-09-08 14:54:35 -07:00
bundle-uri.c
bundle-uri.h
bundle.c
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
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 Merge branch 'tc/last-modified' 2025-09-08 14:54:35 -07:00
commit-graph.h commit-graph: stop passing in redundant repository 2025-08-15 09:34:48 -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
common-exit.c
common-init.c
common-init.h
common-main.c
config.c Merge branch 'pw/3.0-commentchar-auto-deprecation' 2025-09-18 10:07:00 -07:00
config.h
config.mak.dev
config.mak.in
config.mak.uname
configure.ac
connect.c Merge branch 'jc/string-list-split' 2025-08-21 13:46:59 -07:00
connect.h
connected.c
connected.h
convert.c
convert.h
copy.c
copy.h
credential.c
credential.h
csum-file.c
csum-file.h
ctype.c
daemon.c
date.c
date.h
decorate.c
decorate.h
delta-islands.c
delta-islands.h
delta.h
detect-compiler
diagnose.c
diagnose.h
diff-delta.c
diff-lib.c
diff-merges.c
diff-merges.h
diff-no-index.c
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
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
editor.c
editor.h
entry.c
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 Merge branch 'jk/fetch-check-graph-objects-fix' 2025-08-28 11:28:58 -07: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
for-each-ref.h Merge branch 'ja/doc-lint-sections-and-synopsis' 2025-08-25 14:22:02 -07:00
fsck.c
fsck.h
fsmonitor--daemon.h
fsmonitor-ipc.c
fsmonitor-ipc.h
fsmonitor-ll.h
fsmonitor-path-utils.h
fsmonitor-settings.c
fsmonitor-settings.h
fsmonitor.c
fsmonitor.h
generate-cmdlist.sh
generate-configlist.sh
generate-hooklist.sh
generate-perl.sh
generate-python.sh
generate-script.sh
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
git-difftool--helper.sh
git-filter-branch.sh
git-instaweb.sh
git-merge-octopus.sh
git-merge-one-file.sh
git-merge-resolve.sh
git-mergetool--lib.sh
git-mergetool.sh
git-p4.py
git-quiltimport.sh
git-request-pull.sh
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
git-zlib.h
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
hashmap.c
hashmap.h
help.c help: report on whether or not Rust is enabled 2025-10-02 09:32:31 -07:00
help.h
hex-ll.c
hex-ll.h
hex.c
hex.h
hook.c
hook.h
http-backend.c
http-fetch.c
http-push.c treewide: use setup_revisions_from_strvec() when we have a strvec 2025-09-22 14:27:03 -07:00
http-walker.c
http.c Merge branch 'jk/curl-global-trace-components' 2025-09-18 10:07:02 -07:00
http.h
ident.c Merge branch 'ps/reflog-migrate-fixes' 2025-08-21 13:46:57 -07:00
ident.h
imap-send.c Merge branch 'ag/send-email-imap-sent' 2025-09-18 10:07:00 -07:00
iterator.h
json-writer.c
json-writer.h
khash.h
kwset.c
kwset.h
levenshtein.c
levenshtein.h
line-log.c Merge branch 'sg/line-log-boundary-fixes' 2025-09-18 10:07:01 -07:00
line-log.h
line-range.c
line-range.h
linear-assignment.c
linear-assignment.h
list-objects-filter-options.c
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
list-objects.h
list.h
lockfile.c
lockfile.h
log-tree.c Merge branch 'jk/color-variable-fixes' 2025-09-29 11:40:35 -07:00
log-tree.h color: use git_colorbool enum type to store colorbools 2025-09-16 17:59:53 -07:00
loose.c
loose.h
ls-refs.c
ls-refs.h
mailinfo.c
mailinfo.h
mailmap.c
mailmap.h
match-trees.c
match-trees.h
mem-pool.c
mem-pool.h
merge-blobs.c
merge-blobs.h
merge-ll.c
merge-ll.h
merge-ort-wrappers.c
merge-ort-wrappers.h
merge-ort.c Merge branch 'en/ort-rename-fixes' 2025-08-21 13:47:02 -07:00
merge-ort.h
merge.c
merge.h
mergesort.h
meson.build rust: support for Windows 2025-10-15 08:10:17 -07:00
meson_options.txt meson: add infrastructure to build internal Rust library 2025-10-02 09:32:31 -07:00
midx-write.c Merge branch 'ds/midx-write-fixes' 2025-09-15 08:52:06 -07:00
midx.c midx: compute paths via their source 2025-08-11 09:22:23 -07:00
midx.h midx: compute paths via their source 2025-08-11 09:22:23 -07:00
name-hash.c
name-hash.h
notes-cache.c
notes-cache.h
notes-merge.c
notes-merge.h
notes-utils.c
notes-utils.h
notes.c Merge branch 'jc/string-list-split' 2025-08-21 13:46:59 -07:00
notes.h
object-file-convert.c
object-file-convert.h
object-file.c odb: add transaction interface 2025-09-16 11:37:06 -07:00
object-file.h odb: add transaction interface 2025-09-16 11:37:06 -07:00
object-name.c Merge branch 'rs/get-oid-with-flags-cleanup' 2025-09-23 11:53:40 -07:00
object-name.h
object.c alloc: fix dangling pointer in alloc_state cleanup 2025-09-04 15:24:16 -07:00
object.h
odb.c Merge branch 'jt/odb-transaction' 2025-10-02 12:26:11 -07:00
odb.h Merge branch 'jt/odb-transaction' 2025-10-02 12:26:11 -07:00
oid-array.c
oid-array.h
oidmap.c
oidmap.h
oidset.c
oidset.h
oidtree.c
oidtree.h
pack-bitmap-write.c
pack-bitmap.c midx: compute paths via their source 2025-08-11 09:22:23 -07:00
pack-bitmap.h
pack-check.c
pack-mtimes.c
pack-mtimes.h
pack-objects.c
pack-objects.h
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
pack.h
packfile.c midx: drop redundant `struct repository` parameter 2025-08-11 09:22:22 -07:00
packfile.h
pager.c
pager.h
parallel-checkout.c
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 'dk/help-all' 2025-08-25 14:22:00 -07:00
parse-options.h
parse.c
parse.h
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.c
path.h
pathspec.c
pathspec.h
pkt-line.c
pkt-line.h
preload-index.c
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.h
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
prompt.h
protocol-caps.c
protocol-caps.h
protocol.c Merge branch 'jc/string-list-split' 2025-08-21 13:46:59 -07:00
protocol.h
prune-packed.c
prune-packed.h
pseudo-merge.c
pseudo-merge.h
quote.c
quote.h
range-diff.c range-diff: add configurable memory limit for cost matrix 2025-08-29 09:46:07 -07:00
range-diff.h range-diff: add configurable memory limit for cost matrix 2025-08-29 09:46:07 -07:00
reachable.c
reachable.h
read-cache-ll.h
read-cache.c Merge branch 'ps/rust-balloon' into ps/ci-rust 2025-10-07 10:55:39 -07:00
read-cache.h
rebase-interactive.c
rebase-interactive.h
rebase.c
rebase.h
ref-filter.c Merge branch 'jc/string-list-split' 2025-08-21 13:46:59 -07:00
ref-filter.h color: use git_colorbool enum type to store colorbools 2025-09-16 17:59:53 -07:00
reflog-walk.c
reflog-walk.h
reflog.c Merge branch 'ps/remote-rename-fix' 2025-08-21 13:46:58 -07:00
reflog.h Merge branch 'ps/remote-rename-fix' 2025-08-21 13:46:58 -07:00
refs.c Merge branch 'ms/refs-optimize' 2025-10-02 12:26:12 -07:00
refs.h Merge branch 'ms/refs-optimize' 2025-10-02 12:26:12 -07:00
refspec.c
refspec.h
remote-curl.c
remote.c Merge branch 'jk/setup-revisions-freefix' 2025-09-29 11:40:34 -07:00
remote.h
replace-object.c
replace-object.h
repo-settings.c
repo-settings.h
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
rerere.h
reset.c
reset.h
resolve-undo.c
resolve-undo.h
revision.c Merge branch 'jk/setup-revisions-freefix' 2025-09-29 11:40:34 -07:00
revision.h revision: add wrapper to setup_revisions() from a strvec 2025-09-22 14:27:03 -07:00
run-command.c
run-command.h
sane-ctype.h
scalar.c
send-pack.c
send-pack.h
sequencer.c Merge branch 'jk/setup-revisions-freefix' 2025-09-29 11:40:34 -07:00
sequencer.h treewide: pass strvecs around for setup_revisions_from_strvec() 2025-09-22 14:27:03 -07:00
serve.c
serve.h
server-info.c
server-info.h
setup.c Merge branch 'jc/string-list-split' 2025-08-21 13:46:59 -07:00
setup.h
sh-i18n--envsubst.c
sha1dc_git.c
sha1dc_git.h
shallow.c treewide: pass strvecs around for setup_revisions_from_strvec() 2025-09-22 14:27:03 -07: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.h
streaming.c
streaming.h
string-list.c
string-list.h
strmap.c
strmap.h
strvec.c
strvec.h
sub-process.c
sub-process.h
submodule-config.c
submodule-config.h
submodule.c treewide: use setup_revisions_from_strvec() when we have a strvec 2025-09-22 14:27:03 -07:00
submodule.h
symlinks.c
symlinks.h
tag.c
tag.h
tar.h
tempfile.c
tempfile.h
thread-utils.c
thread-utils.h
tmp-objdir.c
tmp-objdir.h
trace.c
trace.h
trace2.c
trace2.h
trailer.c
trailer.h
transport-helper.c
transport-internal.h
transport.c Merge branch 'jk/color-variable-fixes' 2025-09-29 11:40:35 -07:00
transport.h
tree-diff.c
tree-walk.c
tree-walk.h
tree.c
tree.h
unicode-width.h
unimplemented.sh
unix-socket.c
unix-socket.h
unix-stream-server.c
unix-stream-server.h
unpack-trees.c
unpack-trees.h
upload-pack.c Merge branch 'jk/setup-revisions-freefix' 2025-09-29 11:40:34 -07: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.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
versioncmp.h
walker.c
walker.h
wildmatch.c
wildmatch.h
worktree.c
worktree.h
wrapper.c
wrapper.h
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
xdiff-interface.h

README.md

Build status

Git - fast, scalable, distributed revision control system

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

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

Please read the file INSTALL for installation instructions.

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

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