Git 🌙
PortuguĂȘs (Brasil) â–Ÿ Topics â–Ÿ Latest version â–Ÿ git-show-ref last updated in 2.46.0

NOME

git-show-ref - Liste as referĂȘncias no repositĂłrio local

RESUMO

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>

DESCRIÇÃO

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.

OPÇÕES

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

SAÍDA

O resultado serĂĄ no formato:

<oid> SP <ref> LF

Por exemplo,

$ git show-ref --head --dereference
832e76a9899f560a90ffd62ae2ce83bbeff58f54 HEAD
832e76a9899f560a90ffd62ae2ce83bbeff58f54 refs/heads/master
832e76a9899f560a90ffd62ae2ce83bbeff58f54 refs/heads/origin
3521017556c5de4159da4615a39fa4d5d2c279b5 refs/tags/v0.99.9c
6ddc0964034342519a87fe013781abf31c6db6ad refs/tags/v0.99.9c^{}
055e4ae3ae6eb344cbabf2a5256a49ea66040131 refs/tags/v1.0rc4
423325a2d24638ddcc82ce47be5e40be550f4507 refs/tags/v1.0rc4^{}
...

Ao usar --hash (e nĂŁo --dereference), a saĂ­da estĂĄ no formato:

<oid> LF

Por exemplo,

$ git show-ref --branches --hash
2e3ba0114a1f52b47df29743d6915d056be13278
185008ae97960c8d551adcd9e23565194651b5d1
03adf42c988195b50e1a1935ba5fcbc39b2b029b
...

EXEMPLOS

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:

	git show-ref master

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:

	git show-ref --verify refs/heads/master

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

	git show-ref --quiet --verify -- "refs/heads/$headname" ||
		echo "O $headname nĂŁo Ă© um ramo vĂĄlido"

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

	git show-ref --tags --dereference

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

ARQUIVOS

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

VEJA TAMBÉM

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

GIT

Parte do conjunto git[1]

scroll-to-top