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.46.1 → 2.47.1 no changes
- 2.46.0 07/29/24
- 2.42.1 → 2.45.2 no changes
- 2.42.0 08/21/23
- 2.40.1 → 2.41.2 no changes
- 2.40.0 03/12/23
- 2.28.1 → 2.39.5 no changes
- 2.28.0 07/27/20
- 2.25.3 → 2.27.1 no changes
- 2.25.2 03/17/20
- 2.24.1 → 2.25.1 no changes
- 2.24.0 11/04/19
- 2.22.1 → 2.23.4 no changes
- 2.22.0 06/07/19
- 2.18.1 → 2.21.4 no changes
- 2.18.0 06/21/18
- 2.9.5 → 2.17.6 no changes
- 2.8.6 07/30/17
- 2.7.6 no changes
- 2.6.7 05/05/17
- 2.1.4 → 2.5.6 no changes
- 2.0.5 12/17/14
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 thatgit 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 comocommitterdate
, 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 deobjeto 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 (consulteglob
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 comorefs/heads/foo
corresponde) ou de um separador de barra (portanto,bar
corresponde arefs/heads/bar
, mas não arefs/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]