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-show-ref - Liste as referências no repositório local

git show-ref [--head] [-d | --dereference]
	 [-s | --hash[=<n>]] [--abbrev[=<n>]] [--branches] [--tags]
	 [--] [<pattern>…​]
git show-ref --verify [-q | --quiet] [-d | --dereference]
	 [-s | --hash[=<n>]] [--abbrev[=<n>]]
	 [--] [<ref>…​]
git show-ref --exclude-existing[=<pattern>]
git show-ref --exists <ref>

Exiba as referências disponíveis em um repositório local, juntamente com as IDs dos commits associados. Os resultados podem ser filtrados utilizando um padrão e as tags podem perder as suas referências nas IDs dos objetos. Além disso, pode ser utilizado para fazer um teste e ver se existe uma "ref" específica.

É predefinido que se exiba as tags, cabeçalhos e as referências remotas.

O formulário --exclude-existing é um filtro que faz o inverso. Ele lê as refs do stdin, uma ref por linha, e mostra aquelas que não existem no repositório local.

A opção --exists pode ser usada para verificar a existência de uma única referência. Esta opção não verifica se a referência se refere a um objeto real.

O uso deste utilitário é incentivado em favor do acesso direto aos arquivos no diretório .git.

--head

Exibe a referência HEAD, mesmo que ela normalmente fosse filtrada.

--branches

--tags

Limit to 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 is a deprecated synonym for --branches and may be removed in the future.

-d

--dereference

Remova a referência e também as tags de referência nos IDs do objeto. Eles serão exibidos com ^{} anexado.

-s

--hash[=<n>]

Mostra apenas o OID, não o nome da referência. Quando combinada com --dereference, a tag com a referência removida ainda será exibida após o OID.

--verify

Ative a verificação de referência mais rigorosa, exigindo um caminho de referência exato. Além de retornar 1 como código de erro, ele também imprimirá uma mensagem de erro caso a opção --quiet não tiver sido usada.

--exists

Verifica se a referência fornecida existe. Retorna 0 como um código de encerramento, se for o caso, 2 se estiver ausente e 1 se a busca da referência falhar com um erro que não seja a ausência da referência.

--abbrev[=<n>]

Abreviar o nome do objeto. Ao usar a opção --hash, você não precisa usar --hash --abbrev; a penas a opção --hash=n será o suficiente.

-q

--quiet

Não gere nenhum resultado no stdout. Pode ser usado com --verify para verificar silenciosamente se uma referência existe.

--exclude-existing[=<padrão>]

Faça com que o git show-ref atue como um filtro que lê as refs do stdin no formato ^(?:<qualquer coisa>\s)?<refname>(?:\^{})?$ e executa as seguintes ações em cada uma delas: (1) strip ^{} no final da linha caso haja; (2) ignore caso a predefinição seja informada e não corresponder ao cabeçalho a "refname"; (3) avise caso o "refname" não seja um "refname" bem formado e ignore; (4) ignore caso o "refname" é uma "ref" que exista no repositório local; (5) caso contrário, imprima a linha.

<padrão>…​

Mostra as referências que correspondam a um ou mais padrões. Os padrões são correspondidos a partir do final do nome completo e apenas as partes completas são correspondidas, por exemplo, master corresponde a refs/heads/master, refs/remotes/origin/master, refs/tags/jedi/master, mas não a refs/heads/meumaster ou refs/remotes/master/jedi.

O resultado será no formato:

Por exemplo,

Ao usar --hash (e não --dereference), a saída está no formato:

Por exemplo,

Para exibir todas as referências chamadas "master", sejam tags, cabeçalhos ou qualquer outro, e independentemente da profundidade na hierarquia dos nomes de referência, utilize:

Exibirá "refs/heads/master" e também "refs/remote/other-repo/master", caso tais referências existam.

Quando utilizar a opção --verify, o comando precisa de um caminho exato:

coincidirá apenas ao ramo exato chamado "master".

Se nada corresponder, o git show-ref retornará um código de erro 1 e, no caso de verificação, exibirá uma mensagem de erro.

Para a criação de scripts, você pode pedir que ele fique quieto com a opção --quiet, que permite que você faça coisas como

para verificar se um ramo específico existe ou não (observe como na verdade não queremos exibir os resultados e queremos usar o nome completo da "ref" para ele, a fim de não desencadear o problema com coincidências parciais e ambíguas).

To show only tags, or only proper branch heads, use --tags and/or --branches respectively (using both means that it shows tags and branches, but not other random references under the refs/ subdirectory).

Para fazer a remoção da referência automática da tag do objeto, use a opção -d ou a opção --dereference, para que você possa fazer

para obter uma lista de todas as "tags" junto com a perda da referência feita.

.git/refs/*, .git/packed-refs

git-for-each-ref[1], git-ls-remote[1], git-update-ref[1], gitrepository-layout[5]

Parte do conjunto git[1]