git-ls-remote(1) - BetterMan

—

NAME

git-ls-remote - List references in a remote repository

SYNOPSIS

bash

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

DESCRIPTION

Displays references available in a remote repository along with the associated commit IDs.

OPTIONS

-b, --branches, -t, --tags

--refs

-q, --quiet

--upload-pack=<exec>

--exit-code

--get-url

--symref

--sort=<key>

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

<patterns>...

OUTPUT

The output is in the format:

bash

<oid> TAB <ref> LF

When showing an annotated tag, unless --refs is given, two such lines are shown: one with the refname for the tag itself as <ref>, and another with <ref> followed by ^{}. The <oid> on the latter line shows the name of the object the tag points at.

EXAMPLES

bash

$ 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^{}

bash

$ git ls-remote http://www.kernel.org/pub/scm/git/git.git master seen rc
5fe978a5381f1fbad26a80e682ddd2a401966740        refs/heads/master
c781a84b5204fb294c9ccc79f8b3baceeb32c061        refs/heads/seen

bash

$ 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

Part of the git(1) suite