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

NOME

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

RESUMO

git ls-remote [--heads] [--tags] [--refs] [--upload-pack=<exec>]
	      [-q | --quiet] [--exit-code] [--get-url] [--sort=<chave>]
	      [--symref] [<repositório> [<refs>…​]]

DESCRIÇÃO

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

OPÇÕES

-h
--heads
-t
--tags

Limite a apenas refs/heads e refs/tags, respectivamente. Essas opções não são reciprocamente exclusivas; ambas quando informadas, as referências armazenadas em refs/heads e refs/tags são exibidas. Note que o git ls-remote -h exibe a ajuda quando utilizado sem nada na linha de comando, consistente com outros subcomandos do git.

--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, exiba a referência subjacente apontada por ele ao exibir uma referência simbólica. Atualmente, o "upload-pack" exibe apenas a referência simbólica do HEAD, portanto será o único exibido pelo ls-remote.

--sort=<chave>

Classifique com base na chave informada. O prefixo - é utilizado para classificar em ordem decrescente. Supports "version:refname" or "v:refname" (tag names are treated as versions). A ordem de classificação versão:refname também pode ser afetada pela variável de configuração versionsort.sufix. Para mais opções de classificação consulte git-for-each-ref[1], porém esteja ciente que chaves como committerdate que requeiram acesso aos objetos em si não funcionarão com refs cujos objetos ainda não foram capturados remotamente e exibirão um erro missing object.

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

Transmita a sequência especificada para o servidor ao se comunicar utilizando o protocolo versão 2. A sequência informada não deve conter um caractere NUL ou LF. Quando a opção --server-option=<opção> forem utilizadas várias vezes, todos serão enviados para o outro lado na ordem listada na linha de comando.

<repositório>

O repositório "remoto" que será consultado. Este parâmetro pode ser uma URL ou o nome de um ramo remoto (consulte as seções URLs e REMOTOS do GIT no git-fetch[1]).

<refs>…​

Quando não for utilizado, todas as referências, após a filtragem feita com --heads e --tags, são exibidas. Quando as <refs>... é definido, apenas as referências que coincidam com os padrões informados são exibidas.

EXEMPLOS

$ 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

VEJA TAMBÉM

GIT

Parte do conjunto git[1]