1 <!DOCTYPE html PUBLIC
"-//W3C//DTD XHTML 1.1//EN"
2 "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
3 <html xmlns=
"http://www.w3.org/1999/xhtml" xml:
lang=
"en">
5 <meta http-equiv=
"Content-Type" content=
"text/html; charset=UTF-8" />
6 <meta name=
"generator" content=
"AsciiDoc 8.4.5" />
7 <title>git-remote(
1)
</title>
8 <style type=
"text/css">
10 p
, li
, dt
, dd
, div
, pre
, h1
, h2
, h3
, h4
, h5
, h6
{
12 border: 1px solid red;
17 margin: 1em 5% 1em 5%;
22 text-decoration: underline
;
42 h1
, h2
, h3
, h4
, h5
, h6
{
44 font-family: sans-serif
;
51 border-bottom: 2px solid silver
;
69 border: 1px solid silver
;
88 font-family: sans-serif
;
94 span#revnumber
, span#revdate
, span#revremark
{
95 font-family: sans-serif
;
99 font-family: sans-serif
;
101 border-top: 2px solid silver
;
107 padding-bottom: 0.5em;
111 padding-bottom: 0.5em;
116 margin-bottom: 1.5em;
118 div
.tableblock
, div
.imageblock
, div
.exampleblock
, div
.verseblock
,
119 div
.quoteblock
, div
.literalblock
, div
.listingblock
, div
.sidebarblock
,
120 div
.admonitionblock
{
122 margin-bottom: 1.5em;
124 div
.admonitionblock
{
126 margin-bottom: 2.5em;
129 div
.content
{ /* Block element content. */
133 /* Block element titles. */
134 div
.title
, caption
.title
{
136 font-family: sans-serif
;
140 margin-bottom: 0.5em;
146 td div
.title:first-child
{
149 div
.content div
.title:first-child
{
152 div
.content
+ div
.title
{
156 div
.sidebarblock
> div
.content
{
158 border: 1px solid silver
;
162 div
.listingblock
> div
.content
{
163 border: 1px solid silver
;
172 div
.quoteblock
> div
.attribution
{
181 div
.verseblock
> div
.content
{
184 div
.verseblock
> div
.attribution
{
188 /* DEPRECATED: Pre version 8.2.7 verse style literal block. */
189 div
.verseblock
+ div
.attribution
{
193 div
.admonitionblock
.icon
{
197 text-decoration: underline
;
199 padding-right: 0.5em;
201 div
.admonitionblock td
.content
{
203 border-left: 2px solid silver
;
206 div
.exampleblock
> div
.content
{
207 border-left: 2px solid silver
;
211 div
.imageblock div
.content
{ padding-left: 0; }
212 span
.image img
{ border-style: none
; }
213 a
.image:visited
{ color: white
; }
217 margin-bottom: 0.8em;
230 list-style-position: outside
;
233 list-style-type: decimal
;
236 list-style-type: lower-alpha
;
239 list-style-type: upper-alpha
;
242 list-style-type: lower-roman
;
245 list-style-type: upper-roman
;
248 div
.compact ul
, div
.compact ol
,
249 div
.compact p
, div
.compact p
,
250 div
.compact div
, div
.compact div
{
252 margin-bottom: 0.1em;
255 div
.tableblock
> table
{
256 border: 3px solid
#527bbd;
259 font-family: sans-serif
;
271 /* Because the table frame attribute is overriden by CSS in most browsers. */
272 div
.tableblock
> table
[frame
="void"] {
275 div
.tableblock
> table
[frame
="hsides"] {
276 border-left-style: none
;
277 border-right-style: none
;
279 div
.tableblock
> table
[frame
="vsides"] {
280 border-top-style: none
;
281 border-bottom-style: none
;
287 margin-bottom: 0.8em;
290 padding-bottom: 15px;
292 dt
.hdlist1
.strong
, td
.hdlist1
.strong
{
298 padding-right: 0.8em;
304 div
.hdlist
.compact tr
{
314 div#footer-badges
{ display: none
; }
319 font-family: sans-serif
;
323 margin-bottom: 0.1em;
326 div
.toclevel1
, div
.toclevel2
, div
.toclevel3
, div
.toclevel4
{
342 /* Overrides for manpage documents */
345 padding-bottom: 0.5em;
346 border-top: 2px solid silver
;
347 border-bottom: 2px solid silver
;
357 div#toc
{ display: none
; }
360 /* Workarounds for IE6's broken and incomplete CSS2. */
362 div
.sidebar-content
{
364 border: 1px solid silver
;
367 div
.sidebar-title
, div
.image-title
{
369 font-family: sans-serif
;
372 margin-bottom: 0.5em;
375 div
.listingblock div
.content
{
376 border: 1px solid silver
;
381 div
.quoteblock-attribution
{
386 div
.verseblock-content
{
389 div
.verseblock-attribution
{
394 div
.exampleblock-content
{
395 border-left: 2px solid silver
;
399 /* IE6 sets dynamically generated links as visited. */
400 div#toc
a:visited
{ color: blue
; }
406 git-remote(
1) Manual Page
409 <div class=
"sectionbody">
411 manage set of tracked repositories
415 <h2 id=
"_synopsis">SYNOPSIS
</h2>
416 <div class=
"sectionbody">
417 <div class=
"verseblock">
418 <div class=
"verseblock-content"><em>git remote
</em> [-v | --verbose]
419 <em>git remote add
</em> [-t
<branch
>] [-m
<master
>] [-f] [--tags|--no-tags] [--mirror]
<name
> <url
>
420 <em>git remote rename
</em> <old
> <new
>
421 <em>git remote rm
</em> <name
>
422 <em>git remote set-head
</em> <name
> (-a | -d |
<branch
>)
423 <em>git remote set-branches
</em> <name
> [--add]
<branch
>…
424 <em>git remote set-url
</em> [--push]
<name
> <newurl
> [
<oldurl
>]
425 <em>git remote set-url --add
</em> [--push]
<name
> <newurl
>
426 <em>git remote set-url --delete
</em> [--push]
<name
> <url
>
427 <em>git remote
</em> [-v | --verbose]
<em>show
</em> [-n]
<name
>
428 <em>git remote prune
</em> [-n | --dry-run]
<name
>
429 <em>git remote
</em> [-v | --verbose]
<em>update
</em> [-p | --prune] [(
<group
> |
<remote
>)
…]
</div>
430 <div class=
"verseblock-attribution">
433 <h2 id=
"_description">DESCRIPTION
</h2>
434 <div class=
"sectionbody">
435 <div class=
"paragraph"><p>Manage the set of repositories (
"remotes") whose branches you track.
</p></div>
437 <h2 id=
"_options">OPTIONS
</h2>
438 <div class=
"sectionbody">
439 <div class=
"dlist"><dl>
448 Be a little more verbose and show remote url after name.
449 NOTE: This must be placed between
<tt>remote
</tt> and
<tt>subcommand
</tt>.
454 <h2 id=
"_commands">COMMANDS
</h2>
455 <div class=
"sectionbody">
456 <div class=
"paragraph"><p>With no arguments, shows a list of existing remotes. Several
457 subcommands are available to perform operations on the remotes.
</p></div>
458 <div class=
"dlist"><dl>
464 Adds a remote named
<name
> for the repository at
465 <url
>. The command
<tt>git fetch
<name
></tt> can then be used to create and
466 update remote-tracking branches
<name
>/
<branch
>.
468 <div class=
"paragraph"><p>With
<tt>-f
</tt> option,
<tt>git fetch
<name
></tt> is run immediately after
469 the remote information is set up.
</p></div>
470 <div class=
"paragraph"><p>With
<tt>--tags
</tt> option,
<tt>git fetch
<name
></tt> imports every tag from the
471 remote repository.
</p></div>
472 <div class=
"paragraph"><p>With
<tt>--no-tags
</tt> option,
<tt>git fetch
<name
></tt> does not import tags from
473 the remote repository.
</p></div>
474 <div class=
"paragraph"><p>With
<tt>-t
<branch
></tt> option, instead of the default glob
475 refspec for the remote to track all branches under
476 <tt>$GIT_DIR/remotes/
<name
>/
</tt>, a refspec to track only
<tt><branch
></tt>
477 is created. You can give more than one
<tt>-t
<branch
></tt> to track
478 multiple branches without grabbing all branches.
</p></div>
479 <div class=
"paragraph"><p>With
<tt>-m
<master
></tt> option,
<tt>$GIT_DIR/remotes/
<name
>/HEAD
</tt> is set
480 up to point at remote
’s
<tt><master
></tt> branch. See also the set-head command.
</p></div>
481 <div class=
"paragraph"><p>In mirror mode, enabled with
<tt>--mirror
</tt>, the refs will not be stored
482 in the
<em>refs/remotes/
</em> namespace, but in
<em>refs/heads/
</em>. This option
483 only makes sense in bare repositories. If a remote uses mirror
484 mode, furthermore,
<tt>git push
</tt> will always behave as if
<tt>--mirror
</tt>
485 was passed.
</p></div>
492 Rename the remote named
<old
> to
<new
>. All remote-tracking branches and
493 configuration settings for the remote are updated.
495 <div class=
"paragraph"><p>In case
<old
> and
<new
> are the same, and
<old
> is a file under
496 <tt>$GIT_DIR/remotes
</tt> or
<tt>$GIT_DIR/branches
</tt>, the remote is converted to
497 the configuration file format.
</p></div>
504 Remove the remote named
<name
>. All remote-tracking branches and
505 configuration settings for the remote are removed.
513 Sets or deletes the default branch (
<tt>$GIT_DIR/remotes/
<name
>/HEAD
</tt>) for
514 the named remote. Having a default branch for a remote is not required,
515 but allows the name of the remote to be specified in lieu of a specific
516 branch. For example, if the default branch for
<tt>origin
</tt> is set to
517 <tt>master
</tt>, then
<tt>origin
</tt> may be specified wherever you would normally
518 specify
<tt>origin/master
</tt>.
520 <div class=
"paragraph"><p>With
<tt>-d
</tt>,
<tt>$GIT_DIR/remotes/
<name
>/HEAD
</tt> is deleted.
</p></div>
521 <div class=
"paragraph"><p>With
<tt>-a
</tt>, the remote is queried to determine its
<tt>HEAD
</tt>, then
522 <tt>$GIT_DIR/remotes/
<name
>/HEAD
</tt> is set to the same branch. e.g., if the remote
523 <tt>HEAD
</tt> is pointed at
<tt>next
</tt>,
"<tt>git remote set-head origin -a</tt>" will set
524 <tt>$GIT_DIR/refs/remotes/origin/HEAD
</tt> to
<tt>refs/remotes/origin/next
</tt>. This will
525 only work if
<tt>refs/remotes/origin/next
</tt> already exists; if not it must be
526 fetched first.
</p></div>
527 <div class=
"paragraph"><p>Use
<tt><branch
></tt> to set
<tt>$GIT_DIR/remotes/
<name
>/HEAD
</tt> explicitly. e.g.,
"git
528 remote set-head origin master" will set
<tt>$GIT_DIR/refs/remotes/origin/HEAD
</tt> to
529 <tt>refs/remotes/origin/master
</tt>. This will only work if
530 <tt>refs/remotes/origin/master
</tt> already exists; if not it must be fetched first.
</p></div>
533 <em>set-branches
</em>
537 Changes the list of branches tracked by the named remote.
538 This can be used to track a subset of the available remote branches
539 after the initial setup for a remote.
541 <div class=
"paragraph"><p>The named branches will be interpreted as if specified with the
542 <tt>-t
</tt> option on the
<em>git remote add
</em> command line.
</p></div>
543 <div class=
"paragraph"><p>With
<tt>--add
</tt>, instead of replacing the list of currently tracked
544 branches, adds to that list.
</p></div>
551 Changes URL remote points to. Sets first URL remote points to matching
552 regex
<oldurl
> (first URL if no
<oldurl
> is given) to
<newurl
>. If
553 <oldurl
> doesn
’t match any URL, error occurs and nothing is changed.
555 <div class=
"paragraph"><p>With
<em>--push
</em>, push URLs are manipulated instead of fetch URLs.
</p></div>
556 <div class=
"paragraph"><p>With
<em>--add
</em>, instead of changing some URL, new URL is added.
</p></div>
557 <div class=
"paragraph"><p>With
<em>--delete
</em>, instead of changing some URL, all URLs matching
558 regex
<url
> are deleted. Trying to delete all non-push URLs is an
566 Gives some information about the remote
<name
>.
568 <div class=
"paragraph"><p>With
<tt>-n
</tt> option, the remote heads are not queried first with
569 <tt>git ls-remote
<name
></tt>; cached information is used instead.
</p></div>
576 Deletes all stale remote-tracking branches under
<name
>.
577 These stale branches have already been removed from the remote repository
578 referenced by
<name
>, but are still locally available in
579 "remotes/<name>".
581 <div class=
"paragraph"><p>With
<tt>--dry-run
</tt> option, report what branches will be pruned, but do not
582 actually prune them.
</p></div>
589 Fetch updates for a named set of remotes in the repository as defined by
590 remotes.
<group
>. If a named group is not specified on the command line,
591 the configuration parameter remotes.default will be used; if
592 remotes.default is not defined, all remotes which do not have the
593 configuration parameter remote.
<name
>.skipDefaultUpdate set to true will
594 be updated. (See
<a href=
"git-config.html">git-config(
1)
</a>).
596 <div class=
"paragraph"><p>With
<tt>--prune
</tt> option, prune all the remotes that are updated.
</p></div>
600 <h2 id=
"_discussion">DISCUSSION
</h2>
601 <div class=
"sectionbody">
602 <div class=
"paragraph"><p>The remote configuration is achieved using the
<tt>remote.origin.url
</tt> and
603 <tt>remote.origin.fetch
</tt> configuration variables. (See
604 <a href=
"git-config.html">git-config(
1)
</a>).
</p></div>
606 <h2 id=
"_examples">Examples
</h2>
607 <div class=
"sectionbody">
608 <div class=
"ulist"><ul>
611 Add a new remote, fetch, and check out a branch from it
613 <div class=
"listingblock">
614 <div class=
"content">
615 <pre><tt>$ git remote
619 $ git remote add linux-nfs git://linux-nfs.org/pub/linux/nfs-
2.6.git
624 * refs/remotes/linux-nfs/master: storing branch 'master' ...
629 $ git checkout -b nfs linux-nfs/master
635 Imitate
<em>git clone
</em> but track only selected branches
637 <div class=
"listingblock">
638 <div class=
"content">
639 <pre><tt>$ mkdir project.git
642 $ git remote add -f -t master -m master origin git://example.com/git.git/
643 $ git merge origin
</tt></pre>
648 <h2 id=
"_see_also">SEE ALSO
</h2>
649 <div class=
"sectionbody">
650 <div class=
"paragraph"><p><a href=
"git-fetch.html">git-fetch(
1)
</a>
651 <a href=
"git-branch.html">git-branch(
1)
</a>
652 <a href=
"git-config.html">git-config(
1)
</a></p></div>
654 <h2 id=
"_author">Author
</h2>
655 <div class=
"sectionbody">
656 <div class=
"paragraph"><p>Written by Junio Hamano
</p></div>
658 <h2 id=
"_documentation">Documentation
</h2>
659 <div class=
"sectionbody">
660 <div class=
"paragraph"><p>Documentation by J. Bruce Fields and the git-list
<<a href=
"mailto:git@vger.kernel.org">git@vger.kernel.org
</a>>.
</p></div>
662 <h2 id=
"_git">GIT
</h2>
663 <div class=
"sectionbody">
664 <div class=
"paragraph"><p>Part of the
<a href=
"git.html">git(
1)
</a> suite
</p></div>
667 <div id=
"footer-text">
668 Last updated
2010-
11-
25 03:
13:
42 UTC