Git
English ▾ トピック ▾ 最新バージョン ▾ git-ls-remote の最終更新は 2.46.0

NAME

git-ls-remote - リモートリポジトリ内の参照をリスト表示

SYNOPSIS

git ls-remote [--branches] [--tags] [--refs] [--upload-pack=<exec>]
	      [-q | --quiet] [--exit-code] [--get-url] [--sort=<key>]
	      [--symref] [<repository> [<patterns>…​]]

DESCRIPTION

リモートリポジトリで利用可能な参照を、関連付けられたコミット ID とともに表示します。

OPTIONS

-b
--branches
-t
--tags

それぞれ、ローカルブランチとローカルタグのみに制限します。これらのオプションは相互に排他的ではありません。両方を指定すると、refs/heads と refs/tags に格納されている参照が表示されます。--heads および -h は、--branches および -b の非推奨の同義語であり、将来削除される可能性があることに注意してください。また、コマンドラインで何も指定せずに git ls-remote -h を使用すると、他の git サブコマンドと一貫してヘルプが表示されることにも注意してください。

--refs

出力に、剥がされたタグや HEAD のような擬似参照を表示しません。

-q
--quiet

リモート URL を stderr に出力しません。

--upload-pack=<exec>

リモートホスト上の git-upload-pack のフルパスを指定します。これにより、SSH 経由でアクセスされ、SSH デーモンがユーザーによって構成された PATH を使用しないリポジトリから参照をリストできます。

--exit-code

リモートリポジトリに一致する参照が見つからない場合は、ステータス "2" で終了します。通常、コマンドは、一致する参照を見つけたかどうかにかかわらず、リモートリポジトリとの通信が成功したことを示すために、ステータス "0" で終了します。

--get-url

"url.<base>.insteadOf" 構成設定を考慮して、指定されたリモートリポジトリの URL を展開し ( git-config[1] を参照)、リモートと通信せずに終了します。

--symref

シンボリック参照を表示するときは、そのオブジェクトが指すオブジェクトに加えて、その参照が指す基になる参照も表示します。現在、upload-pack はシンボリック参照 HEAD のみを表示するため、ls-remote で表示されるのは HEAD のみです。

--sort=<key>

指定されたキーに基づいてソートします。値の降順にソートするには、- をプレフィックスとして付けます。"version:refname" または "v:refname" (タグ名はバージョンとして扱われます) をサポートします。"version:refname" ソート順は、"versionsort.suffix" 構成変数によっても影響を受ける可能性があります。より多くのソートオプションについては、git-for-each-ref[1] を参照してください。ただし、オブジェクト自体へのアクセスを必要とする committerdate などのキーは、リモートからまだフェッチされていないオブジェクトを持つ参照では機能せず、missing object エラーが発生することに注意してください。

-o <option>
--server-option=<option>

プロトコルバージョン 2 を使用して通信する場合、指定された文字列をサーバーに送信します。指定された文字列に NUL または LF 文字を含めることはできません。複数の --server-option=<option> が指定されている場合、それらはすべてコマンドラインにリストされた順序で相手側に送信されます。

<repository>

クエリを実行する「リモート」リポジトリ。このパラメーターは、URL またはリモートの名前 ( git-fetch[1] の GIT URL および REMOTES セクションを参照) のいずれかになります。

<patterns>…​

指定されていない場合、--heads および --tags でフィルタリングされた後、すべての参照が表示されます。<patterns>…​が指定されている場合は、指定されたパターンの 1 つ以上に一致する参照のみが表示されます。各パターンは、参照の「末尾」に対して照合される glob ( gitglossary[7]glob を参照) として解釈されます。参照の先頭 (refs/heads/foo のような完全名が一致します) から、またはスラッシュ区切り文字 (barrefs/heads/bar に一致しますが、refs/heads/foobar には一致しません) から開始します。

OUTPUT

出力は次の形式です

<oid> TAB <ref> LF

--refs が指定されていない限り、アノテーション付きタグを表示する場合は、2 つの行が表示されます。1 つはタグ自体の refname を <ref> として、もう 1 つは <ref> の後に ^{} が続きます。後者の行の <oid> は、タグが指すオブジェクトの名前を示します。

EXAMPLES

  • すべての参照 (シンボリックおよび擬似参照を含む) をリスト表示し、タグを剥がす

    $ git ls-remote
    27d43aaaf50ef0ae014b88bba294f93658016a2e	HEAD
    950264636c68591989456e3ba0a5442f93152c1a	refs/heads/main
    d9ab777d41f92a8c1684c91cfb02053d7dd1046b	refs/heads/next
    d4ca2e3147b409459955613c152220f4db848ee1	refs/tags/v2.40.0
    73876f4861cd3d187a4682290ab75c9dccadbc56	refs/tags/v2.40.0^{}
  • 指定されたパターンに一致するすべての参照をリスト表示

    $ git ls-remote http://www.kernel.org/pub/scm/git/git.git master seen rc
    5fe978a5381f1fbad26a80e682ddd2a401966740	refs/heads/master
    c781a84b5204fb294c9ccc79f8b3baceeb32c061	refs/heads/seen
  • 指定されたワイルドカードパターンに一致するタグのみをリスト表示

    $ git ls-remote --tags http://www.kernel.org/pub/scm/git/git.git v\*
    485a869c64a68cc5795dd99689797c5900f4716d	refs/tags/v2.39.2
    cbf04937d5b9fcf0a76c28f69e6294e9e3ecd7e6	refs/tags/v2.39.2^{}
    d4ca2e3147b409459955613c152220f4db848ee1	refs/tags/v2.40.0
    73876f4861cd3d187a4682290ab75c9dccadbc56	refs/tags/v2.40.0^{}

GIT

git[1] スイートの一部

scroll-to-top