Git
Português (Brasil) ▾Topics ▾Latest version ▾ git-ls-remote last updated in 2.46.0

NOME

git-ls-remote - Liste referências num repositório remoto

RESUMO

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

DESCRIÇÃO

Exibe as referências disponíveis num repositório remoto, juntamente com as IDs os commits associados.

OPÇÕES

-b
--branches
-t
--tags

Limit to only local branches and local tags, respectively. These options are not mutually exclusive; when given both, references stored in refs/heads and refs/tags are displayed. Note that --heads and -h are deprecated synonyms for --branches and -b and may be removed in the future. Also note that git ls-remote -h used without anything else on the command line gives help, consistent with other git subcommands.

--refs

Não exiba as opções removidas ou as pseudorefs como HEAD na saída.

-q
--quiet

Não exiba a URL remota no stderr.

--upload-pack=<exec>

Define o caminho completo do git-upload-pack no host remoto. Permite listar as referências dos repositórios acessados através do SSH e onde o daemon SSH não utiliza o PATH configurado pelo usuário.

--exit-code

Encerra com a condição 2 quando nenhuma refs coincidente for encontrada no repositório remoto. Normalmente, o comando encerra com a condição 0 para indicar que houve uma comunicação bem sucedida com o repositório remoto, caso tenha encontrado qualquer refs coincidentes.

--get-url

Expanda a URL do repositório remoto informado, levando em consideração qualquer definição da configuração "url.<base>.insteadOf" (consulte git-config[1]) e encerre sem se comunicar com o repositório remoto.

--symref

Além do objeto apontado por ele, mostre a referência subjacente apontada por ele ao mostrar uma referência simbólica. Atualmente, o upload-pack mostra apenas o symref HEAD, portanto, ele será o único mostrado pelo ls-remote.

--sort=<chave>

Classifica com base na chave fornecida. Prefixo - para classificar em ordem decrescente do valor. Oferece suporte a "version:refname" ou "v:refname" (os nomes das etiquetas são tratadas como versões). A ordem de classificação "version:refname" também pode ser afetada pela variável de configuração "versionsort.suffix". Para mais opções de classificação consulte git-for-each-ref[1], mas esteja ciente de que chaves como committerdate, que exigem acesso aos próprios objetos, não funcionarão para as referências cujos objetos ainda não tenham sido obtidos remotamente e irá gerar um erro de objeto ausente.

-o <opção>
--server-option=<opção>

Transmite a string fornecida para o servidor ao se comunicar usando a versão 2 do protocolo. A atring fornecida não deve conter um caractere NUL ou LF. Quando várias opções --server-option=<opção> são usadas, todas elas são enviadas para o outro lado na ordem listada na linha de comando.

<repositório>

O repositório "remoto" para consulta. Esse parâmetro pode ser um URL ou o nome de um repositório remoto (consulte as seções URLS e REMOTOS do Git do comando git-fetch[1]).

<padrões>…​

Quando não especificado, todas as referências, após a filtragem feita com --heads e --tags, são mostradas. Quando <padrões>... são especificados, apenas as referências que correspondem a um ou mais dos padrões informados são exibidas. Cada padrão é interpretado como uma bolha (consulte glob do comando gitglossary[7]) que é comparado com a "cauda" de uma referência, começando do início da referência (portanto, um nome completo como refs/heads/foo corresponde) ou de um separador de barra (portanto, bar corresponde a refs/heads/bar, mas não a refs/heads/foobar).

SAÍDA

O resultado será no formato:

<oid> TAB <ref> LF

Ao exibir uma etiqueta anotada, a menos que a opção --refs seja usada, duas dessas linhas são exibidas: uma com o nome de referência da própria tag como <ref> e outra com <ref> seguido de ^{}. O <oid> na última linha mostra o nome do objeto para o qual a tag aponta.

EXEMPLOS

  • Liste todas as referências (inclusive simbólicas e pseudo referências), removendo as etiquetas:

    $ 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^{}
  • Lista todas as referências que correspondam com os padrões fornecidos:

    $ git ls-remote http://www.kernel.org/pub/scm/git/git.git master seen rc
    5fe978a5381f1fbad26a80e682ddd2a401966740	refs/heads/master
    c781a84b5204fb294c9ccc79f8b3baceeb32c061	refs/heads/seen
  • Lista apenas as etiquetas que correspondam a um determinado curinga padrão:

    $ 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

Parte do conjunto git[1]

scroll-to-top