Setup and Config
Getting and Creating Projects
Basic Snapshotting
Branching and Merging
Sharing and Updating Projects
Inspection and Comparison
Patching
Debugging
External Systems
Server Admin
Guides
- gitattributes
- Command-line interface conventions
- Everyday Git
- Frequently Asked Questions (FAQ)
- Glossary
- Hooks
- gitignore
- gitmodules
- Revisions
- Submodules
- Tutorial
- Workflows
- All guides...
Administration
Plumbing Commands
- 2.42.1 → 2.43.0 no changes
- 2.42.0 08/21/23
- 2.40.1 → 2.41.0 no changes
- 2.40.0 03/12/23
- 2.28.1 → 2.39.3 no changes
- 2.28.0 07/27/20
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çãoversão:refname
também pode ser afetada pela variável de configuraçãoversionsort.sufix
. Para mais opções de classificação consulte git-for-each-ref[1], porém esteja ciente que chaves comocommitterdate
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 erromissing 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
ouLF
. 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
GIT
Parte do conjunto git[1]