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.48.1 → 2.51.2 no changes
 - 
        2.48.0
          
            
              
            
              
            
              
            
            
              
            
              
            
            
              
            
              
            
              
            
              
            
              
            
          
          2025-01-10
        
         - 2.46.1 → 2.47.3 no changes
 - 
        2.46.0
          
            
              
            
              
            
              
            
              
            
              
            
            
              
            
              
            
              
            
            
              
            
              
            
          
          2024-07-29
        
         - 2.42.1 → 2.45.4 no changes
 - 
        2.42.0
          
            
              
            
              
            
              
            
              
            
              
            
              
            
            
              
            
              
            
            
              
            
              
            
          
          2023-08-21
        
         - 2.40.1 → 2.41.3 no changes
 - 
        2.40.0
          
            
              
            
              
            
              
            
              
            
              
            
            
              
            
              
            
              
            
            
              
            
              
            
          
          2023-03-12
        
         - 2.28.1 → 2.39.5 no changes
 - 
        2.28.0
          
            
              
            
              
            
            
              
            
              
            
            
              
            
              
            
              
            
              
            
          
          2020-07-27
        
         - 2.25.3 → 2.27.1 no changes
 - 
        2.25.2
          
            
              
            
              
            
              
            
            
              
            
            
              
            
              
            
              
            
              
            
          
          2020-03-17
        
         - 2.24.1 → 2.25.1 no changes
 - 
        2.24.0
          
            
              
            
              
            
              
            
              
            
            
              
            
              
            
              
            
              
            
            
              
            
              
            
          
          2019-11-04
        
         - 2.22.1 → 2.23.4 no changes
 - 
        2.22.0
          
            
              
            
            
              
            
            
              
            
              
            
              
            
              
            
              
            
              
            
          
          2019-06-07
        
         - 2.18.1 → 2.21.4 no changes
 - 
        2.18.0
          
            
              
            
              
            
              
            
              
            
              
            
              
            
              
            
              
            
            
              
            
              
            
            
              
            
              
            
          
          2018-06-21
        
         - 2.9.5 → 2.17.6 no changes
 - 
        2.8.6
          
            
              
            
              
            
              
            
              
            
              
            
              
            
              
            
            
              
            
            
              
            
              
            
          
          2017-07-30
        
         - 2.7.6 no changes
 - 
        2.6.7
          
            
              
            
            
              
            
              
            
            
              
            
              
            
              
            
              
            
              
            
          
          2017-05-05
        
         - 2.1.4 → 2.5.6 no changes
 - 
        2.0.5
          
            
              
            
              
            
              
            
              
            
              
            
              
            
              
            
              
            
            
              
            
              
            
            
              
            
              
            
          
          2014-12-17
        
         
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
--headsand-hare deprecated synonyms for--branchesand-band may be removed in the future. Also note thatgitls-remote-hused 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
HEADna 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 deobjetoausente. - -o <opção>
 - --server-option=<opção>
 - 
Transmit the given string to the server when communicating using protocol version 2. The given string must not contain a NUL or LF character. When multiple
--server-option=<option> are given, they are all sent to the other side in the order listed on the command line. When no--server-option=<option> is given from the command line, the values of configuration variableremote.<name>.serverOptionare used instead. - <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
--headse--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 (consulteglobdo 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/foocorresponde) ou de um separador de barra (portanto,barcorresponde 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]