1git-fetch(1) 2============ 3 4NAME 5---- 6git-fetch - Download objects and refs from another repository 7 8 9SYNOPSIS 10-------- 11'git fetch' [<options>] [<repository> [<refspec>...]] 12 13'git fetch' [<options>] <group> 14 15'git fetch' --multiple [<options>] [(<repository> | <group>)...] 16 17'git fetch' --all [<options>] 18 19 20DESCRIPTION 21----------- 22Fetches named heads or tags from one or more other repositories, 23along with the objects necessary to complete them. 24 25The ref names and their object names of fetched refs are stored 26in `.git/FETCH_HEAD`. This information is left for a later merge 27operation done by 'git merge'. 28 29When <refspec> stores the fetched result in remote-tracking branches, 30the tags that point at these branches are automatically 31followed. This is done by first fetching from the remote using 32the given <refspec>s, and if the repository has objects that are 33pointed by remote tags that it does not yet have, then fetch 34those missing tags. If the other end has tags that point at 35branches you are not interested in, you will not get them. 36 37'git fetch' can fetch from either a single named repository, or 38or from several repositories at once if <group> is given and 39there is a remotes.<group> entry in the configuration file. 40(See linkgit:git-config[1]). 41 42OPTIONS 43------- 44include::fetch-options.txt[] 45 46include::pull-fetch-param.txt[] 47 48include::urls-remotes.txt[] 49 50 51EXAMPLES 52-------- 53 54* Update the remote-tracking branches: 55+ 56------------------------------------------------ 57$ git fetch origin 58------------------------------------------------ 59+ 60The above command copies all branches from the remote refs/heads/ 61namespace and stores them to the local refs/remotes/origin/ namespace, 62unless the branch.<name>.fetch option is used to specify a non-default 63refspec. 64 65* Using refspecs explicitly: 66+ 67------------------------------------------------ 68$ git fetch origin +pu:pu maint:tmp 69------------------------------------------------ 70+ 71This updates (or creates, as necessary) branches `pu` and `tmp` in 72the local repository by fetching from the branches (respectively) 73`pu` and `maint` from the remote repository. 74+ 75The `pu` branch will be updated even if it is does not fast-forward, 76because it is prefixed with a plus sign; `tmp` will not be. 77 78 79SEE ALSO 80-------- 81linkgit:git-pull[1] 82 83 84Author 85------ 86Written by Linus Torvalds <torvalds@osdl.org> and 87Junio C Hamano <gitster@pobox.com> 88 89Documentation 90------------- 91Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>. 92 93GIT 94--- 95Part of the linkgit:git[1] suite