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