Git (software): Wikis


Note: Many of our articles have direct quotes from sources you can cite, within the Wikipedia article! This article doesn't yet, but we're working on it! See more info or our list of citable articles.


From Wikipedia, the free encyclopedia

Git logo
Original author(s) Linus Torvalds
Developer(s) Junio Hamano, Linus Torvalds
Stable release  (March 7, 2010; 11 day(s) ago (2010-03-07))[1] [+/−]
Preview release [+/−]
Written in C, Bourne Shell, Perl[2]
Operating system POSIX
Type Revision control
License GNU General Public License v2

Git is a free distributed revision control, or software source code management project with an emphasis on being fast. Git was initially designed and developed by Linus Torvalds for Linux kernel development.

Every Git working directory is a full-fledged repository with complete history and full revision tracking capabilities, not dependent on network access or a central server.

Git's current software maintenance is overseen by Junio Hamano.



Linus Torvalds has quipped about the name "git", which is British English slang for a stupid or unpleasant person:[3] "I'm an egotistical bastard, and I name all my projects after myself. First Linux, now git."[citation needed]

The official Git wiki also gives a number of alternative explanations for the name, including "Global Information Tracker".[4]

Early history

Git development began after many Linux kernel developers were forced to give up access to the proprietary BitKeeper system (see BitKeeper - Pricing change). The ability to use BitKeeper free of charge had been withdrawn by the copyright holder Larry McVoy after he claimed Andrew Tridgell had reverse engineered the BitKeeper protocols in alleged violation of the BitKeeper license. At Linux.Conf.Au 2005, Tridgell demonstrated during his keynote that the reverse engineering process he had used was simply to telnet to the appropriate port of a BitKeeper server and type "help".[5]

Torvalds wanted a distributed system that he could use like BitKeeper, but none of the available free systems met his needs, particularly his performance needs. From an e-mail he wrote on April 7, 2005 while writing the first prototype:[6]

However, the SCMs I've looked at make this hard. One of the things (the main thing, in fact) I've been working at is to make that process really efficient. If it takes half a minute to apply a patch and remember the changeset boundary etc. (and quite frankly, that's fast for most SCMs around for a project the size of Linux), then a series of 250 emails (which is not unheard of at all when I sync with Andrew, for example) takes two hours. If one of the patches in the middle doesn't apply, things are bad bad bad.

Now, BK wasn't a speed demon either (actually, compared to everything else, BK is a speed deamon [sic], often by one or two orders of magnitude), and took about 10–15 seconds per email when I merged with Andrew. HOWEVER, with BK that wasn't as big of an issue, since the BK<->BK merges were so easy, so I never had the slow email merges with any of the other main developers. So a patch-application-based SCM “merger” actually would need to be faster than BK is. Which is really really really hard.

So I'm writing some scripts to try to track things a whole lot faster. Initial indications are that I should be able to do it almost as quickly as I can just apply the patch, but quite frankly, I'm at most half done, and if I hit a snag maybe that's not true at all. Anyway, the reason I can do it quickly is that my scripts will not be an SCM, they'll be a very specific “log Linus' state” kind of thing. That will make the linear patch merge a lot more time-efficient, and thus possible.

(If a patch apply takes three seconds, even a big series of patches is not a problem: if I get notified within a minute or two that it failed half-way, that's fine, I can then just fix it up manually. That's why latency is critical—if I'd have to do things effectively “offline”, I'd by definition not be able to fix it up when problems happen).

Torvalds had several design criteria:

  1. Take CVS as an example of what not to do; if in doubt, make the exact opposite decision. To quote Torvalds, speaking somewhat tongue-in-cheek:
    “For the first 10 years of kernel maintenance, we literally used tarballs and patches, which is a much superior source control management system than CVS is, but I did end up using CVS for 7 years at a commercial company [Transmeta[7]] and I hate it with a passion. When I say I hate CVS with a passion, I have to also say that if there are any SVN (Subversion) users in the audience, you might want to leave. Because my hatred of CVS has meant that I see Subversion as being the most pointless project ever started. The slogan of Subversion for a while was "CVS done right", or something like that, and if you start with that kind of slogan, there's nowhere you can go. There is no way to do CVS right.”[8]
  2. Support a distributed, BitKeeper-like workflow
    "BitKeeper was not only the first source control system that I ever felt was worth using at all, it was also the source control system that taught me why there's a point to them, and how you actually can do things. So Git in many ways, even though from a technical angle it is very very different from BitKeeper (which was another design goal, because I wanted to make it clear that it wasn't a BitKeeper clone), a lot of the flows we use with Git come directly from the flows we learned from BitKeeper."[8]
  3. Very strong safeguards against corruption, either accidental or malicious[8][9]
  4. Very high performance

The first three criteria eliminated every pre-existing version control system except for Monotone, and the fourth excluded everything.[8] So, immediately after the 2.6.12-rc2 Linux kernel development release,[8] he set out to write his own.[8]

The development of Git began on April 3, 2005.[10] The project was announced on April 6,[11] and became self-hosting as of April 7.[10] The first merge of multiple branches was done on April 18.[12] Torvalds achieved his performance goals; on April 29, the nascent Git was benchmarked recording patches to the Linux kernel tree at the rate of 6.7 per second.[13] On June 16, the kernel 2.6.12 release was managed by Git.[14]

While strongly influenced by BitKeeper, Torvalds deliberately attempted to avoid conventional approaches, leading to a unique design.[15] He developed the system until it was usable by technical users, then turned over maintenance on July 26, 2005 to Junio Hamano, a major contributor to the project.[16] Hamano was responsible for the 1.0 release on December 21, 2005,[17] and remains the project's maintainer.


Git's design was inspired by BitKeeper and Monotone.[18][19] Git was originally designed as a low-level version control system engine on top of which others could write front ends, such as Cogito or StGIT.[19] However, the core Git project has since become a complete revision control system that is usable directly.[20]


Git's design is a synthesis of Torvalds's experience maintaining a large distributed development project, his intimate knowledge of file system performance, and an urgent need to produce a working system in short order. (See the history section for details.) These influences led to the following implementation choices:

Strong support for non-linear development
Git supports rapid branching and merging, and includes specific tools for visualizing and navigating a non-linear development history. A core assumption in Git is that a change will be merged more often than it is written, as it is passed around various reviewers.
Distributed development
Like Darcs, BitKeeper, Mercurial, SVK, Bazaar and Monotone, Git gives each developer a local copy of the entire development history, and changes are copied from one such repository to another. These changes are imported as additional development branches, and can be merged in the same way as a locally developed branch.
Compatibility with existing systems/protocols
Repositories can be published via HTTP, FTP, rsync, or a Git protocol over either a plain socket or ssh. Git also has a CVS server emulation, which enables the use of existing CVS clients and IDE plugins to access Git repositories. Subversion and svk repositories can be used directly with git-svn.
Efficient handling of large projects
Torvalds has described Git as being very fast and scalable,[21] and performance tests done by Mozilla showed it was an order of magnitude faster than some revision control systems, and fetching revision history from locally stored repository can be two orders of magnitude faster than fetching it from the remote server.[22][23] In particular, Git does not get slower as the project history grows larger.[24]
Cryptographic authentication of history
The Git history is stored in such a way that the name of a particular revision (a "commit" in Git terms) depends upon the complete development history leading up to that commit. Once it is published, it is not possible to change the old versions without it being noticed. The structure is similar to a hash tree, but with additional data at the nodes as well as the leaves.[25] (Mercurial and Monotone also have this property.)
Toolkit-based design
Git was designed as a set of programs written in C, and a number of shell scripts that provide wrappers around those programs.[26] Although most of those scripts have been rewritten in C as part of an ongoing effort to port it to Microsoft Windows[citation needed], the design remains, and it is easy to chain the components together.[27]
Pluggable merge strategies
As part of its toolkit design, Git has a well-defined model of an incomplete merge, and it has multiple algorithms for completing it, culminating in telling the user that it is unable to complete the merge automatically and manual editing is required.
Garbage accumulates unless collected
Aborting operations or backing out changes will leave useless dangling objects in the database. These are generally a small fraction of the continuously growing history of wanted objects, but reclaiming the space using git gc --prune can be slow.[28]
Periodic explicit object packing
Git stores each newly created object as a separate file. Although individually compressed, this takes a great deal of space and is inefficient. This is solved by the use of "packs" that store a large number of objects in a single file (or network byte stream), delta-compressed among themselves. Packs are compressed using the heuristic that files with the same name are probably similar, but do not depend on it for correctness. Newly created objects (newly added history) are still stored singly, and periodic repacking is required to maintain space efficiency. Git does periodic repacking automatically but manual repacking is also possible with the git gc command.

Another property of Git is that it snapshots directory trees of files. The earliest systems for tracking versions of source code, SCCS and RCS, worked on individual files and emphasized the space savings to be gained from delta encoding the (mostly similar) versions. Later revision control systems maintained this notion of a file having an identity across multiple revisions of a project. However, Torvalds rejected this concept.[29] Consequently, Git does not explicitly record file revision relationships at any level below the source code tree.

Inexplicit revision relationships has some significant consequences:

  • It is slightly more expensive to examine the change history of a single file than the whole project.[30] To obtain a history of changes affecting a given file, Git must walk the global history and then determine whether each change modified that file. This method of examining history does, however, let Git produce with equal efficiency a single history showing the changes to an arbitrary set of files. For example, a subdirectory of the source tree plus an associated global header file is a very common case.
  • Renames are handled implicitly rather than explicitly. A common complaint with CVS is that it uses the name of a file to identify its revision history, so moving or renaming a file is not possible without either interrupting its history, or renaming the history and thereby making the history inaccurate. Most post-CVS revision control systems solve this by giving a file a unique long-lived name (a sort of inode number) that survives renaming. Git does not record such an identifier, and this is claimed as an advantage.[31][32] Source code files are sometimes split or merged as well as simply renamed,[33] and recording this as a simple rename would freeze an inaccurate description of what happened in the (immutable) history. Git addresses the issue by detecting renames while browsing the history of snapshots rather than recording it when making the snapshot.[34] (Briefly, given a file in revision N, a file of the same name in revision N−1 is its default ancestor. However, when there is no like-named file in revision N−1, Git searches for a file that existed only in revision N−1 and is very similar to the new file.) However, it does require more CPU-intensive work every time history is reviewed, and a number of options to adjust the heuristics.

Git implements several merging strategies; a non-default can be selected at merge time:[35]

  • resolve: the traditional three-way merge algorithm.
  • recursive: This is the default when pulling or merging one branch, and is a variant of the three-way merge algorithm. "When there are more than one common ancestors that can be used for three-way merge, it creates a merged tree of the common ancestors and uses that as the reference tree for the three-way merge. This has been reported to result in fewer merge conflicts without causing mis-merges by tests done on actual merge commits taken from Linux 2.6 kernel development history. Additionally this can detect and handle merges involving renames."[36]
  • octopus: This is the default when merging more than two heads.


Like BitKeeper, Git does not use a centralized server. However, Git's primitives are not inherently a SCM system. Torvalds explains,[37]

In many ways you can just see git as a filesystem — it's content-addressable, and it has a notion of versioning, but I really really designed it coming at the problem from the viewpoint of a filesystem person (hey, kernels is what I do), and I actually have absolutely zero interest in creating a traditional SCM system.

In spite of his intentions, Git now has the full set of features expected of a traditional SCM.[38]

Git has two data structures: a mutable index that caches information about the working directory and the next revision to be committed; and an immutable, append-only object database.

The object database contains four types of objects:

  • A blob object is the content of a file. Blob objects have no names, timestamps, or other metadata.
  • A tree object is the equivalent of a directory. It contains a list of filenames, each with some type bits and the name of a blob or tree object that is that file, symbolic link, or directory's contents. This object describes a snapshot of the source tree.
  • A commit object links tree objects together into a history. It contains the name of a tree object (of the top-level source directory), a timestamp, a log message, and the names of zero or more parent commit objects.
  • A tag object is a container that contains reference to another object and can hold additional meta-data related to another object. Most commonly, it is used to store a digital signature of a commit object corresponding to a particular release of the data being tracked by Git.

The index serves as connection point between the object database and the working tree.

Each object is identified by a SHA-1 hash of its contents. Git computes the hash, and uses this value for the object's name. The object is put into a directory matching the first two characters of its hash. The rest of the hash is used as the file name for that object.

Git stores each revision of a file as a unique blob object. The relationships between the blobs can be found through examining the tree and commit objects. Newly added objects are stored in their entirety using zlib compression. This can consume a large amount of hard disk space quickly, so objects can be combined into packs, which use delta compression to save space, storing blobs as their changes relative to other blobs.

Git servers typically listen on TCP/IP port 9418.[39]


Git is primarily developed on Linux, but can be used on other Unix-like operating systems including BSD, Solaris and Darwin. Git is extremely fast on POSIX-based systems such as Linux.[40]

Git also runs on Windows. There are two variants:

  • A native Microsoft Windows port, called msysgit (using MSYS from MinGW), is approaching completion.[41] There are downloadable installers ready for testing (under the names "Git" and "msysgit", where "Git" is aimed for users).[42] While somewhat slower than the Linux version,[43] it is acceptably fast[44] and is reported to be usable in production, with only minor awkwardness.[45] In particular, some commands are not yet available from the GUIs, and must be invoked from the command line.
  • Git also runs on top of Cygwin (a POSIX emulation layer),[46] although it is noticeably slower, especially for commands written as shell scripts.[47] This is primarily due to the high cost of the fork emulation performed by Cygwin. However, the recent rewriting of many Git commands (originally implemented as shell scripts) in C has resulted in significant speed improvements on Windows.[48]

Other alternatives for running Git include:

Refactoring the lowest-level Git operations into libraries would theoretically enable re-implementation of the higher-level components for Windows without rewriting the rest.[50]


Source code hosting

The following websites provide free source code hosting for Git repositories:

Projects using Git

A number of high-profile software projects now use Git for revision control[51]:

The KDE project has begun migrating to Git, with Amarok having completed its migration[94][95], and Phonon expected to soon follow[96]. The Drupal community has recently announced plans to migrate development to Git[97].

See also


  1. ^ Hamano, Junio (2010-02-13). "[ANNOUNCE] Git 1.7.0". git mailing list. Retrieved 2010-02-13. 
  2. ^ "git/git.git/tree".;a=tree. Retrieved 2009-06-15. 
  3. ^ "After controversy, Torvalds begins work on git". InfoWorld. 2005-04-19. ISSN 0199-6649. Retrieved 2008-02-20. 
  4. ^ "GitFaq: Why the 'git' name?". Retrieved 2009-06-16. 
  5. ^ Jonathan Corbet (2005-04-20). "How Tridge reverse engineered BitKeeper". Linux Weekly News. 
  6. ^ Linus Torvalds (2005-04-07). "Re: Kernel SCM saga..". linux-kernel mailing list. 
  7. ^ Linus Torvalds (2005-10-31). "Re: git versus CVS (versus bk)". git mailing list. 
  8. ^ a b c d e f Linus Torvalds. (2007-05-03). Google tech talk: Linus Torvalds on git. Event occurs at 02:30. Retrieved 2007-05-16. 
  9. ^ Linus Torvalds (2007-06-10). "Re: fatal: serious inflate inconsistency". git mailing list.  A brief description of Git's data integrity design goals.
  10. ^ a b Linus Torvalds (2007-02-27). "Re: Trivia: When did git self-host?". git mailing list. 
  11. ^ Linus Torvalds (2005-04-06). "Kernel SCM saga..". linux-kernel mailing list. 
  12. ^ Linus Torvalds (2005-04-17). "First ever real kernel git merge!". git mailing list. 
  13. ^ Matt Mackall (2005-04-29). "Mercurial 0.4b vs git patchbomb benchmark". git mailing list. 
  14. ^ Linus Torvalds (2005-06-17). "Linux 2.6.12". git-commits-head mailing list. 
  15. ^ Linus Torvalds (2006-10-20). "Re: VCS comparison table". git mailing list.  A discussion of Git vs. BitKeeper
  16. ^ Linus Torvalds (2005-07-27). "Meet the new maintainer…". git mailing list. 
  17. ^ Junio C Hamano (2005-12-21). "ANNOUNCE: GIT 1.0.0". git mailing list. 
  18. ^ Linus Torvalds (2006-05-05). "Re: [ANNOUNCE] Git wiki". linux-kernel mailing list.  "Some historical background" on git's predecessors
  19. ^ a b Linus Torvalds (2005-04-08). "Re: Kernel SCM saga". linux-kernel mailing list. Retrieved 2008-02-20. 
  20. ^ Linus Torvalds (2006-03-23). "Re: Errors GITtifying GCC and Binutils". git mailing list. 
  21. ^ Linus Torvalds (2006-10-19). "Re: VCS comparison table". git mailing list. 
  22. ^ Stenback, Johnny (2006-11-30). "bzr/hg/git performance". Jst's Blog. Retrieved 2008-02-20. , benchmarking "git diff" against "bzr diff", and finding the former 100x faster in some cases.
  23. ^ Roland Dreier (2006-11-13). "Oh what a relief it is". , observing that "git log" is 100x faster than "svn log" because the latter has to contact a remote server.
  24. ^ Fendy, Robert (2009-01-21). DVCS Round-Up: One System to Rule Them All?—Part 2. Linux Foundation. Retrieved 2009-06-25. "One aspect that really sets Git apart is its speed. …dependence on repository size is very, very weak. For all facts and purposes, Git shows nearly a flat-line behavior when it comes to the dependence of its performance on the number of files and/or revisions in the repository, a feat no other VCS in this review can duplicate (although Mercurial does come quite close)." 
  25. ^ "Git User's Manual - Git Concepts - Trust". 2006-10-18. 
  26. ^ Linus Torvalds. "Re: VCS comparison table". git mailing list. Retrieved 2009-04-10. , describing Git's script-oriented design
  27. ^ iabervon (2005-12-22). "Git rocks!". , praising Git's scriptability
  28. ^ "Git User's Manual". 2007-08-05. 
  29. ^ Linus Torvalds (2005-04-10). "Re: more git updates..". linux-kernel mailing list. 
  30. ^ Bruno Haible (2007-02-11). "how to speed up "git log"?". git mailing list. 
  31. ^ Linus Torvalds (2006-03-01). "Re: impure renames / history tracking". git mailing list. 
  32. ^ Junio C Hamano (2006-03-24). "Re: Errors GITtifying GCC and Binutils". git mailing list. 
  33. ^ Junio C Hamano (2006-03-23). "Re: Errors GITtifying GCC and Binutils". git mailing list. 
  34. ^ Linus Torvalds (2006-11-28). "Re: git and bzr". git mailing list. , on using git-blame to show code moved between source files
  35. ^ Linus Torvalds (2007-07-18). "git-merge(1)". 
  36. ^ Linus Torvalds (2007-07-18). "CrissCrossMerge". 
  37. ^ Linus Torvalds (2005-04-10). "Re: more git updates…". linux-kernel mailing list. 
  38. ^ Linus Torvalds (2006-03-23). "Re: Errors GITtifying GCC and Binutils". git mailing list. 
  39. ^ "Exporting a git repository via the git protocol". Retrieved 2009-11-17. 
  40. ^ Stenback, Johnny (2006-11-30). "bzr/hg/git performance". Jst's Blog. Retrieved 2008-02-20. 
  41. ^ "Git on MSYS". 
  42. ^ "msysgit". 
  43. ^ Johannes Schindelin (2007-10-14). "Re: Switching from CVS to GIT". git mailing list.  A subjective comparison of Git under Windows and Linux on the same system.
  44. ^ Martin Langhoff (2007-10-15). "Re: Switching from CVS to GIT". git mailing list.  Experience running msysgit on Windows
  45. ^ Johannes Sixt (2007-10-15). "Re: Switching from CVS to GIT". git mailing list. 
  46. ^ Shawn Pearce (2006-10-24). "Re: VCS comparison table". git mailing list. 
  47. ^ Johannes Schindelin (2007-01-01). "Re: [PATCH] Speedup recursive by flushing index only once for all". git mailing list. 
  48. ^ Shawn O. Pearce (2007-09-18). "[PATCH 0/5] More builtin-fetch fixes". git mailing list. 
  49. ^ "git-cvsserver(1)". 2009-04-02. Retrieved 2009-06-15. 
  50. ^ Johannes Schindelin (2006-03-02). "Re: windows problems summary". git mailing list. 
  51. ^ "Projects that use Git for their source code management". Retrieved 2008-02-20. 
  52. ^ Getting Started/Sources/Amarok Git Tutorial - KDE TechBase
  53. ^ amarok in kde-developers - Gitorious
  54. ^ Using Repo and Git (Android Open Source Project)
  55. ^ BlueZ » GIT access
  56. ^ "Btrfs source repositories - btrfs Wiki". Retrieved 2009-06-15. 
  57. ^ Git
  58. ^ digg.git - part 1 | Digg About
  59. ^ TypicalGitUsage - dragonflywiki
  60. ^ Download
  61. ^ "Get FFmpeg". Retrieved 2009-06-15. 
  62. ^ Lucas Rocha. "Mailing List Announcement". Retrieved 2009-03-19. "GNOME to migrate to git version control system…" 
  63. ^ Git - GNOME Live!
  64. ^ gstreamer Wiki - GitDeveloperGuidelines
  65. ^ gthumb - GNOME Live!
  66. ^ GTK+ - Download
  67. ^ source repositories
  68. ^ Downloading jQuery - jQuery JavaScript Library
  69. ^ CCHIT's laika at master - GitHub
  70. ^ LilyPond, music notation for everyone
  71. ^ The Linux Mint Blog » Blog Archive » Mint to use Launchpad for translations, bugs, blueprints and github for code hosting and version control
  72. ^ Put the fun back into computing. Use Linux, BSD
  73. ^ LMMS - Linux MultiMedia Studio
  74. ^ Maemo - Gitorious
  75. ^ Ruby on Rails: Merb
  76. ^ MooTools - a compact javascript framework
  77. ^ OLPC wiki. "Project hosting". Retrieved 2008-02-20. 
  78. ^ openSUSE - Gitorious
  79. ^ Léon Brocard. "Mailing List Announcement". Retrieved 2008-12-22. "The Perl Foundation has migrated Perl 5 to the Git version control system…" 
  80. ^ phpBB (2010-03-07). "phpBB moves source code versioning from Subversion to Git". phpBB Group. Retrieved 2010-03-07. 
  81. ^ Prototype JavaScript framework: Contribute
  82. ^ Press Release (2009-05-11). "Qt now open for community contributions". Retrieved 2009-06-22. 
  83. ^ "Reddit Goes Open Source". Retrieved 2010-02-26. 
  84. ^ ""Rails is moving from SVN to Git"". Retrieved 2008-04-03. 
  85. ^ Using Git for Samba Development - SambaWiki
  86. ^ SproutCore Documentation
  87. ^ Sugar Labs project hosting
  88. ^ Accessing SWI-Prolog source via <a href="">GIT</a>
  89. ^ a b Git - VideoLAN Wiki
  90. ^ GitWine - The Official Wine Wiki
  91. ^ Xiph Git
  92. ^ X.Org Wiki - Development/git
  93. ^ "YUI 2 and YUI 3 Source Code Now on GitHub". Retrieved 2009-01-20. 
  94. ^ life at the end of the universe » we’re testing the water for everyone
  95. ^ KDE gets millionth commit - The H Open Source: News and Features
  96. ^ (Kde-scm-interest) Minutes from Today's KDE -> Git BoF, Ian Monroe, Wed Jul 8 18:43:42 CEST 2009
  97. ^ Migrating to Git

External links

Got something to say? Make a comment.
Your name
Your email address