SYNOPSIS
git ls-remote [--heads] [--tags] [--refs] [--upload-pack=<exec>] [-q | --quiet] [--exit-code] [--get-url] [--sort=<key>] [--symref] [<repository> [<refs>…]]
DESCRIPTION
リモートリポジトリで有効な参照を、関連するコミットIDとともに表示します。
OPTIONS
-
-h
-
--heads
-
-t
-
--tags
-
それぞれ、refs/heads と refs/tags のみに制限します。これらのオプションは相互に排他的ではありません。両方を指定すると、 refs/heads と refs/tags に保存されている参照が表示されます。コマンドラインで他に何も指定せずに使用された
git ls-remote -h
は、他のgitサブコマンドと同じようにヘルプを提供することに注意してください。 -
--refs
-
ピーリングされたタグ(peeled tag)や
HEAD
のような疑似参照(pseudoref)を出力に表示しないでください。 -
-q
-
--quiet
-
stderrにリモートURLを出力しないでください。
-
--upload-pack=<exec>
-
リモートホストの「git-upload-pack」のフルパスを指定します。これにより、SSH経由でアクセスされ、SSHデーモンがユーザーによって構成されたPATHを使用しないリポジトリからの参照を一覧表示できます。
-
--exit-code
-
リモートリポジトリに一致する参照が見つからない場合は、ステータス「2」で終了します。通常、コマンドはステータス「0」で終了し、一致する参照が見つかったかどうかに関係なく、リモートリポジトリと正常に通信したことを示します。
-
--get-url
-
url.<base>.insteadOf
構成設定(git-config(1)を参照)を考慮して、指定されたリモートリポジトリのURLを展開し、リモートと通信せずに終了します。 -
--symref
-
それが指すオブジェクトに加えて、シンボリックrefを表示するときに、それが指す基になるrefを表示します。 現在、upload-packはsymref HEADのみを表示するため、ls-remoteによって表示されるのはこれだけです。
-
--sort=<key>
-
指定されたキーに基づいて並べ替えます。接頭辞
-
を使用して、値の降順で並べ替えます。version:refname
またはv:refname
をサポートします(タグ名はバージョンとして扱われます)。version:refname
のソート順は、versionsort.suffix
構成変数の影響も受ける可能性があります。 その他の並べ替えオプションについては git-for-each-ref(1) を参照してください。ただし、オブジェクト自体へのアクセスを必要とするcommitterdate
のようなキーは、オブジェクトがまだリモートからフェッチされていないrefに対しては機能せず、missing object
エラーが発生することに注意してください。 -
-o <option>
-
--server-option=<option>
-
プロトコルバージョン2を使用して通信する場合は、指定された文字列をサーバーに送信します。指定された文字列には、NULまたはLF文字を含めることはできません。 複数の
--server-option=<option>
が指定されている場合、それらはコマンドラインにリストされている順序で送信されます。 - <repository>
-
クエリする「リモート」リポジトリ。 このパラメーターは、URLまたはリモートの名前のいずれかです(git-fetch(1) の「GIT URLS」と「REMOTES」セクションを参照してください)。
- <refs>…
-
指定しない場合、
--heads
と--tags
でフィルタリングを行った後のすべての参照が表示されます。 <refs>… を指定すると、指定したパターンに一致する参照のみが表示されます。
EXAMPLES
$ 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 seen rc
5fe978a5381f1fbad26a80e682ddd2a401966740 refs/heads/master
c781a84b5204fb294c9ccc79f8b3baceeb32c061 refs/heads/seen
$ git remote add korg http://www.kernel.org/pub/scm/git/git.git
$ git ls-remote --tags korg v\*
d6602ec5194c87b0fc87103ca4d67251c76f233a refs/tags/v0.99
f25a265a342aed6041ab0cc484224d9ca54b6f41 refs/tags/v0.99.1
c5db5456ae3b0873fc659c19fafdde22313cc441 refs/tags/v0.99.2
7ceca275d047c90c0c7d5afb13ab97efdf51bd6e refs/tags/v0.99.3
SEE ALSO
GIT
Part of the git(1) suite