Git
Português (Brasil) ▾ Topics ▾ Latest version ▾ git-symbolic-ref last updated in 2.43.0

NOME

git-symbolic-ref - Lê, altera e exclui refs simbólicas

RESUMO

git symbolic-ref [-m <motivo>] <nome> <ref>
git symbolic-ref [-q] [--short] [--no-recurse] <nome>
git symbolic-ref --delete [-q] <nome>

DESCRIÇÃO

Com um argumento, lê o cabeçalho do ramo ao qual a referência simbólica fornecida se refere e gera seu caminho, relativo ao diretório .git/. Normalmente, você forneceria HEAD como o argumento <nome> para ver em qual ramo a sua árvore de trabalho está.

Quando foi dois argumentos fortem utilizados, cria ou atualiza uma referência simbólica <nome> para apontar para o ramo <ref> informado.

Ao utilizar --delete e um argumento adicional, exclui a referência simbólica informada.

Uma referência simbólica é um arquivo regular que armazena uma cadeia de caracteres que começa com ref: refs/. Por exemplo, seu .git/HEAD é um arquivo normal cujo conteúdo é ref: refs/heads/master.

OPÇÕES

-d
--delete

Exclua o <nome> da "ref" simbólica.

-q
--quiet

Não emita uma mensagem de erro caso o <nome> não seja uma referência simbólica, e sim um HEAD desanexado; em vez disso, saia com uma condição diferente de zero de forma silenciosa.

--short

Ao exibir o valor de um <nome> como uma "ref" simbólica, tente encurtar o valor, por exemplo, de refs/heads/master para master.

--recurse
--no-recurse

Ao exibir o valor do <nome> como uma referência simbólica, se o <nome> se referir a outra referência simbólica, siga essa cadeia de referências simbólicas até que o resultado não aponte mais para uma referência simbólica (--recurse, que é o padrão). A opção --no-recurse é interrompida após fazer uma referência a apenas um único nível de referência simbólica.

-m

Atualize o reflog para o <nome> com o <motivo>. Isso é válido apenas ao criar ou quando for atualizar uma referência simbólica.

OBSERVAÇÕES

No passado, o .git/HEAD era um link simbólico que apontava para refs/heads/master. Quando queríamos alternar para outra ramificação, fazíamos ln -sf refs/heads/newbranch .git/HEAD e, quando queríamos descobrir em qual ramificação estávamos, fazíamos readlink .git/HEAD. No entanto, os links simbólicos não são totalmente portáteis, por isso foram descontinuados e as referências simbólicas (conforme descrito acima) são usadas por padrão.

O comando git symbolic-ref encerrará com a condição 0 caso o conteúdo da ref simbólica tenha sido impresso corretamente, com a condição 1 caso o nome solicitado não seja uma ref simbólica ou 128 caso ocorra um outro erro.

GIT

Parte do conjunto git[1]

scroll-to-top