Google Git
Sign in
chromium / external / gitster / git-htmldocs / 301bc7b9aebba4531542ba2275cd8792842a7b04 / . / git-ls-remote.txt
blob: abe7bf9ff9eb9a3ddb1924938de071291520797a [file] [log] [blame]
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1git-ls-remote(1)
2================
3
4NAME
5----
Junio C Hamano6b2cee12006-08-26 08:43:31[diff] [blame]6git-ls-remote - List references in a remote repository
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]7
8
9SYNOPSIS
10--------
Junio C Hamano6b2cee12006-08-26 08:43:31[diff] [blame]11[verse]
Junio C Hamanofce7c7e2008-07-02 03:06:38[diff] [blame]12'git ls-remote' [--heads] [--tags] [-u <exec> | --upload-pack <exec>]
Junio C Hamano6b2cee12006-08-26 08:43:31[diff] [blame]13 <repository> <refs>...
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]14
15DESCRIPTION
16-----------
Junio C Hamano6b2cee12006-08-26 08:43:31[diff] [blame]17Displays references available in a remote repository along with the associated
18commit IDs.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]19
20
21OPTIONS
22-------
Junio C Hamanoeb415992008-06-08 22:49:47[diff] [blame]23-h::
24--heads::
25-t::
26--tags::
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]27Limit to only refs/heads and refs/tags, respectively.
28These options are _not_ mutually exclusive; when given
29both, references stored in refs/heads and refs/tags are
30displayed.
31
Junio C Hamanoeb415992008-06-08 22:49:47[diff] [blame]32-u <exec>::
33--upload-pack=<exec>::
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]34Specify the full path of 'git-upload-pack' on the remote
Junio C Hamano6b2cee12006-08-26 08:43:31[diff] [blame]35host. This allows listing references from repositories accessed via
Junio C Hamanof9771f62007-01-17 17:42:30[diff] [blame]36SSH and where the SSH daemon does not use the PATH configured by the
Junio C Hamano1fbbbc12007-12-18 07:01:27[diff] [blame]37user.
Junio C Hamano6b2cee12006-08-26 08:43:31[diff] [blame]38
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]39<repository>::
40Location of the repository. The shorthand defined in
Junio C Hamano6b2cee12006-08-26 08:43:31[diff] [blame]41$GIT_DIR/branches/ can be used. Use "." (dot) to list references in
42the local repository.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]43
44<refs>...::
45When unspecified, all references, after filtering done
46with --heads and --tags, are shown. When <refs>... are
47specified, only references matching the given patterns
48are displayed.
49
50EXAMPLES
51--------
52
53$ git ls-remote --tags ./.
54d6602ec5194c87b0fc87103ca4d67251c76f233a refs/tags/v0.99
55f25a265a342aed6041ab0cc484224d9ca54b6f41 refs/tags/v0.99.1
567ceca275d047c90c0c7d5afb13ab97efdf51bd6e refs/tags/v0.99.3
57c5db5456ae3b0873fc659c19fafdde22313cc441 refs/tags/v0.99.2
580918385dbd9656cab0d1d81ba7453d49bbc16250 refs/tags/junio-gpg-pub
59$ git ls-remote http://www.kernel.org/pub/scm/git/git.git master pu rc
605fe978a5381f1fbad26a80e682ddd2a401966740 refs/heads/master
61c781a84b5204fb294c9ccc79f8b3baceeb32c061 refs/heads/pu
62b1d096f2926c4e37c9c0b6a7bf2119bedaa277cb refs/heads/rc
63$ echo http://www.kernel.org/pub/scm/git/git.git >.git/branches/public
64$ git ls-remote --tags public v\*
65d6602ec5194c87b0fc87103ca4d67251c76f233a refs/tags/v0.99
66f25a265a342aed6041ab0cc484224d9ca54b6f41 refs/tags/v0.99.1
67c5db5456ae3b0873fc659c19fafdde22313cc441 refs/tags/v0.99.2
687ceca275d047c90c0c7d5afb13ab97efdf51bd6e refs/tags/v0.99.3
69
70Author
71------
Junio C Hamano0868a302008-07-22 09:20:44[diff] [blame]72Written by Junio C Hamano <gitster@pobox.com>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]73
74GIT
75---
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]76Part of the linkgit:git[1] suite