<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">

<article lang="en" id="git-ls-remote(1)">
<articleinfo>
    <title>git-ls-remote(1)</title>
        <indexterm>
                <primary>git-ls-remote(1)</primary>
        </indexterm>
</articleinfo>
<simplesect id="_name">
<title>NAME</title>
<simpara>git-ls-remote - List references in a remote repository</simpara>
</simplesect>
<simplesect id="_synopsis">
<title>SYNOPSIS</title>
<blockquote>
<literallayout><emphasis>git ls-remote</emphasis> [--heads] [--tags]  [-u &lt;exec&gt; | --upload-pack &lt;exec&gt;]
              &lt;repository&gt; &lt;refs&gt;&#8230;</literallayout>
</blockquote>
</simplesect>
<simplesect id="_description">
<title>DESCRIPTION</title>
<simpara>Displays references available in a remote repository along with the associated
commit IDs.</simpara>
</simplesect>
<simplesect id="_options">
<title>OPTIONS</title>
<variablelist>
<varlistentry>
<term>
-h
</term>
<term>
--heads
</term>
<term>
-t
</term>
<term>
--tags
</term>
<listitem>
<simpara>
        Limit to only refs/heads and refs/tags, respectively.
        These options are <emphasis>not</emphasis> mutually exclusive; when given
        both, references stored in refs/heads and refs/tags are
        displayed.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
-u &lt;exec&gt;
</term>
<term>
--upload-pack=&lt;exec&gt;
</term>
<listitem>
<simpara>
        Specify the full path of <emphasis>git-upload-pack</emphasis> on the remote
        host. This allows listing references from repositories accessed via
        SSH and where the SSH daemon does not use the PATH configured by the
        user.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
&lt;repository&gt;
</term>
<listitem>
<simpara>
        Location of the repository.  The shorthand defined in
        $GIT_DIR/branches/ can be used. Use "." (dot) to list references in
        the local repository.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
&lt;refs&gt;&#8230;
</term>
<listitem>
<simpara>
        When unspecified, all references, after filtering done
        with --heads and --tags, are shown.  When &lt;refs&gt;&#8230; are
        specified, only references matching the given patterns
        are displayed.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</simplesect>
<simplesect id="_examples">
<title>EXAMPLES</title>
<literallayout class="monospaced">$ git ls-remote --tags ./.
d6602ec5194c87b0fc87103ca4d67251c76f233a        refs/tags/v0.99
f25a265a342aed6041ab0cc484224d9ca54b6f41        refs/tags/v0.99.1
7ceca275d047c90c0c7d5afb13ab97efdf51bd6e        refs/tags/v0.99.3
c5db5456ae3b0873fc659c19fafdde22313cc441        refs/tags/v0.99.2
0918385dbd9656cab0d1d81ba7453d49bbc16250        refs/tags/junio-gpg-pub
$ git ls-remote http://www.kernel.org/pub/scm/git/git.git master pu rc
5fe978a5381f1fbad26a80e682ddd2a401966740        refs/heads/master
c781a84b5204fb294c9ccc79f8b3baceeb32c061        refs/heads/pu
b1d096f2926c4e37c9c0b6a7bf2119bedaa277cb        refs/heads/rc
$ echo http://www.kernel.org/pub/scm/git/git.git &gt;.git/branches/public
$ git ls-remote --tags public v\*
d6602ec5194c87b0fc87103ca4d67251c76f233a        refs/tags/v0.99
f25a265a342aed6041ab0cc484224d9ca54b6f41        refs/tags/v0.99.1
c5db5456ae3b0873fc659c19fafdde22313cc441        refs/tags/v0.99.2
7ceca275d047c90c0c7d5afb13ab97efdf51bd6e        refs/tags/v0.99.3</literallayout>
</simplesect>
<simplesect id="_author">
<title>Author</title>
<simpara>Written by Junio C Hamano &lt;<ulink url="mailto:gitster@pobox.com">gitster@pobox.com</ulink>&gt;</simpara>
</simplesect>
<simplesect id="_git">
<title>GIT</title>
<simpara>Part of the <xref linkend="git(1)"/> suite</simpara>
</simplesect>
</article>
