Setup and Config

• git
• config
• help
• bugreport
• Credential helpers

Getting and Creating Projects

• init
• clone

Basic Snapshotting

• add
• status
• diff
• commit
• notes
• restore
• reset
• rm
• mv

Branching and Merging

• branch
• checkout
• switch
• merge
• mergetool
• log
• stash
• tag
• worktree

Sharing and Updating Projects

• fetch
• pull
• push
• remote
• submodule

Inspection and Comparison

• show
• log
• diff
• difftool
• range-diff
• shortlog
• describe

Patching

• apply
• cherry-pick
• diff
• rebase
• revert

Debugging

• bisect
• blame
• grep

Email

• am
• apply
• imap-send
• format-patch
• send-email
• request-pull

External Systems

• svn
• fast-import

Server Admin

• daemon
• update-server-info

Guides

• gitattributes
• Command-line interface conventions
• Everyday Git
• Frequently Asked Questions (FAQ)
• Glossary
• Hooks
• gitignore
• gitmodules
• Revisions
• Submodules
• Tutorial
• Workflows
• All guides...

Administration

• clean
• gc
• fsck
• reflog
• filter-branch
• instaweb
• archive
• bundle

Plumbing Commands

• cat-file
• check-ignore
• checkout-index
• commit-tree
• count-objects
• diff-index
• for-each-ref
• hash-object
• ls-files
• ls-tree
• merge-base
• read-tree
• rev-list
• rev-parse
• show-ref
• symbolic-ref
• update-index
• update-ref
• verify-pack
• write-tree

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

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

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

-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>

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 variable remote.<name>.serverOption are 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 --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).

O resultado será no formato:

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.

• 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-check-ref-format[1].

Parte do conjunto git[1]