Merge branch 'sp/checkout'
[git/gitweb-caching.git] / Documentation / git-ls-remote.txt
blob66fe60f9985d23a02420d7733414b232e59cc22a
1 git-ls-remote(1)
2 ================
4 NAME
5 ----
6 git-ls-remote - Look at references other repository has.
9 SYNOPSIS
10 --------
11 'git-ls-remote' [--heads] [--tags] <repository> <refs>...
13 DESCRIPTION
14 -----------
15 Displays the references other repository has.
18 OPTIONS
19 -------
20 -h|--heads, -t|--tags::
21         Limit to only refs/heads and refs/tags, respectively.
22         These options are _not_ mutually exclusive; when given
23         both, references stored in refs/heads and refs/tags are
24         displayed.
26 <repository>::
27         Location of the repository.  The shorthand defined in
28         $GIT_DIR/branches/ can be used.
30 <refs>...::
31         When unspecified, all references, after filtering done
32         with --heads and --tags, are shown.  When <refs>... are
33         specified, only references matching the given patterns
34         are displayed.
36 EXAMPLES
37 --------
39         $ git ls-remote --tags ./.
40         d6602ec5194c87b0fc87103ca4d67251c76f233a        refs/tags/v0.99
41         f25a265a342aed6041ab0cc484224d9ca54b6f41        refs/tags/v0.99.1
42         7ceca275d047c90c0c7d5afb13ab97efdf51bd6e        refs/tags/v0.99.3
43         c5db5456ae3b0873fc659c19fafdde22313cc441        refs/tags/v0.99.2
44         0918385dbd9656cab0d1d81ba7453d49bbc16250        refs/tags/junio-gpg-pub
45         $ git ls-remote http://www.kernel.org/pub/scm/git/git.git master pu rc
46         5fe978a5381f1fbad26a80e682ddd2a401966740        refs/heads/master
47         c781a84b5204fb294c9ccc79f8b3baceeb32c061        refs/heads/pu
48         b1d096f2926c4e37c9c0b6a7bf2119bedaa277cb        refs/heads/rc
49         $ echo http://www.kernel.org/pub/scm/git/git.git >.git/branches/public
50         $ git ls-remote --tags public v\*
51         d6602ec5194c87b0fc87103ca4d67251c76f233a        refs/tags/v0.99
52         f25a265a342aed6041ab0cc484224d9ca54b6f41        refs/tags/v0.99.1
53         c5db5456ae3b0873fc659c19fafdde22313cc441        refs/tags/v0.99.2
54         7ceca275d047c90c0c7d5afb13ab97efdf51bd6e        refs/tags/v0.99.3
56 Author
57 ------
58 Written by Junio C Hamano <junkio@cox.net>
60 GIT
61 ---
62 Part of the gitlink:git[7] suite