doc/source/en/TortoiseGit/git_doc/git-ls-remote.html.xml

   1 <?xml version="1.0" encoding="UTF-8"?>\r
   2 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">\r
   3 \r
   4 <article lang="en" id="git-ls-remote(1)">\r
   5 <articleinfo>\r
   6     <title>git-ls-remote(1)</title>\r
   7         <indexterm>\r
   8                 <primary>git-ls-remote(1)</primary>\r
   9         </indexterm>\r
  10 </articleinfo>\r
  11 <simplesect id="_name">\r
  12 <title>NAME</title>\r
  13 <simpara>git-ls-remote - List references in a remote repository</simpara>\r
  14 </simplesect>\r
  15 <simplesect id="_synopsis">\r
  16 <title>SYNOPSIS</title>\r
  17 <blockquote>\r
  18 <literallayout><emphasis>git ls-remote</emphasis> [--heads] [--tags]  [-u &lt;exec&gt; | --upload-pack &lt;exec&gt;]\r
  19               &lt;repository&gt; &lt;refs&gt;&#8230;</literallayout>\r
  20 </blockquote>\r
  21 </simplesect>\r
  22 <simplesect id="_description">\r
  23 <title>DESCRIPTION</title>\r
  24 <simpara>Displays references available in a remote repository along with the associated\r
  25 commit IDs.</simpara>\r
  26 </simplesect>\r
  27 <simplesect id="_options">\r
  28 <title>OPTIONS</title>\r
  29 <variablelist>\r
  30 <varlistentry>\r
  31 <term>\r
  32 -h\r
  33 </term>\r
  34 <term>\r
  35 --heads\r
  36 </term>\r
  37 <term>\r
  38 -t\r
  39 </term>\r
  40 <term>\r
  41 --tags\r
  42 </term>\r
  43 <listitem>\r
  44 <simpara>\r
  45         Limit to only refs/heads and refs/tags, respectively.\r
  46         These options are <emphasis>not</emphasis> mutually exclusive; when given\r
  47         both, references stored in refs/heads and refs/tags are\r
  48         displayed.\r
  49 </simpara>\r
  50 </listitem>\r
  51 </varlistentry>\r
  52 <varlistentry>\r
  53 <term>\r
  54 -u &lt;exec&gt;\r
  55 </term>\r
  56 <term>\r
  57 --upload-pack=&lt;exec&gt;\r
  58 </term>\r
  59 <listitem>\r
  60 <simpara>\r
  61         Specify the full path of <emphasis>git-upload-pack</emphasis> on the remote\r
  62         host. This allows listing references from repositories accessed via\r
  63         SSH and where the SSH daemon does not use the PATH configured by the\r
  64         user.\r
  65 </simpara>\r
  66 </listitem>\r
  67 </varlistentry>\r
  68 <varlistentry>\r
  69 <term>\r
  70 &lt;repository&gt;\r
  71 </term>\r
  72 <listitem>\r
  73 <simpara>\r
  74         Location of the repository.  The shorthand defined in\r
  75         $GIT_DIR/branches/ can be used. Use "." (dot) to list references in\r
  76         the local repository.\r
  77 </simpara>\r
  78 </listitem>\r
  79 </varlistentry>\r
  80 <varlistentry>\r
  81 <term>\r
  82 &lt;refs&gt;&#8230;\r
  83 </term>\r
  84 <listitem>\r
  85 <simpara>\r
  86         When unspecified, all references, after filtering done\r
  87         with --heads and --tags, are shown.  When &lt;refs&gt;&#8230; are\r
  88         specified, only references matching the given patterns\r
  89         are displayed.\r
  90 </simpara>\r
  91 </listitem>\r
  92 </varlistentry>\r
  93 </variablelist>\r
  94 </simplesect>\r
  95 <simplesect id="_examples">\r
  96 <title>EXAMPLES</title>\r
  97 <literallayout class="monospaced">$ git ls-remote --tags ./.\r
  98 d6602ec5194c87b0fc87103ca4d67251c76f233a        refs/tags/v0.99\r
  99 f25a265a342aed6041ab0cc484224d9ca54b6f41        refs/tags/v0.99.1\r
 100 7ceca275d047c90c0c7d5afb13ab97efdf51bd6e        refs/tags/v0.99.3\r
 101 c5db5456ae3b0873fc659c19fafdde22313cc441        refs/tags/v0.99.2\r
 102 0918385dbd9656cab0d1d81ba7453d49bbc16250        refs/tags/junio-gpg-pub\r
 103 $ git ls-remote http://www.kernel.org/pub/scm/git/git.git master pu rc\r
 104 5fe978a5381f1fbad26a80e682ddd2a401966740        refs/heads/master\r
 105 c781a84b5204fb294c9ccc79f8b3baceeb32c061        refs/heads/pu\r
 106 b1d096f2926c4e37c9c0b6a7bf2119bedaa277cb        refs/heads/rc\r
 107 $ echo http://www.kernel.org/pub/scm/git/git.git &gt;.git/branches/public\r
 108 $ git ls-remote --tags public v\*\r
 109 d6602ec5194c87b0fc87103ca4d67251c76f233a        refs/tags/v0.99\r
 110 f25a265a342aed6041ab0cc484224d9ca54b6f41        refs/tags/v0.99.1\r
 111 c5db5456ae3b0873fc659c19fafdde22313cc441        refs/tags/v0.99.2\r
 112 7ceca275d047c90c0c7d5afb13ab97efdf51bd6e        refs/tags/v0.99.3</literallayout>\r
 113 </simplesect>\r
 114 <simplesect id="_author">\r
 115 <title>Author</title>\r
 116 <simpara>Written by Junio C Hamano &lt;<ulink url="mailto:gitster@pobox.com">gitster@pobox.com</ulink>&gt;</simpara>\r
 117 </simplesect>\r
 118 <simplesect id="_git">\r
 119 <title>GIT</title>\r
 120 <simpara>Part of the <xref linkend="git(1)"/> suite</simpara>\r
 121 </simplesect>\r
 122 </article>\r