English ▾ Themen ▾ Neueste Version ▾ git-symbolic-ref zuletzt aktualisiert in 2.48.0

NAME

git-symbolic-ref - Symbolische Referenzen lesen, ändern und löschen

SYNOPSIS

git symbolic-ref [-m <reason>] <name> <ref>
git symbolic-ref [-q] [--short] [--no-recurse] <name>
git symbolic-ref --delete [-q] <name>

BESCHREIBUNG

Mit einem Argument wird gelesen, auf welchen Branch-Head die gegebene symbolische Referenz verweist, und deren Pfad relativ zum .git/ Verzeichnis ausgegeben. Typischerweise geben Sie HEAD als <name> Argument an, um zu sehen, auf welchem Branch sich Ihr Arbeitsverzeichnis befindet.

Mit zwei Argumenten wird eine symbolische Referenz <name> erstellt oder aktualisiert, sodass sie auf den gegebenen Branch <ref> zeigt.

Mit --delete und einem zusätzlichen Argument wird die gegebene symbolische Referenz gelöscht.

Eine symbolische Referenz ist eine reguläre Datei, die einen String speichert, der mit ref: refs/ beginnt. Zum Beispiel ist Ihre .git/HEAD eine reguläre Datei, deren Inhalt ref: refs/heads/master ist.

OPTIONEN

-d
--delete

Lösche die symbolische Referenz <name>.

-q
--quiet

Geben Sie keine Fehlermeldung aus, wenn <name> keine symbolische Referenz, sondern ein gelöster HEAD ist; beenden Sie stattdessen stillschweigend mit einem Nicht-Null-Status.

--short

Beim Anzeigen des Werts von <name> als symbolische Referenz versuchen Sie, den Wert zu kürzen, z. B. von refs/heads/master zu master.

--recurse
--no-recurse

Beim Anzeigen des Werts von <name> als symbolische Referenz, wenn <name> auf eine andere symbolische Referenz verweist, folgen Sie einer solchen Kette von symbolischen Referenzen, bis das Ergebnis nicht mehr auf eine symbolische Referenz zeigt (--recurse, was der Standard ist). --no-recurse stoppt nach dem Dereferenzieren nur einer einzigen Ebene einer symbolischen Referenz.

-m

Aktualisieren Sie den Reflog für <name> mit <reason>. Dies ist nur beim Erstellen oder Aktualisieren einer symbolischen Referenz gültig.

ANMERKUNGEN

Früher war .git/HEAD ein symbolischer Link, der auf refs/heads/master zeigte. Wenn wir zu einem anderen Branch wechseln wollten, führten wir ln -sf refs/heads/newbranch .git/HEAD aus, und wenn wir herausfinden wollten, auf welchem Branch wir uns befanden, führten wir readlink .git/HEAD aus. Symbolische Links sind jedoch nicht vollständig portabel, daher sind sie jetzt veraltet und symbolische Referenzen (wie oben beschrieben) werden standardmäßig verwendet.

git symbolic-ref wird mit dem Status 0 beendet, wenn der Inhalt der symbolischen Referenz korrekt gedruckt wurde, mit dem Status 1, wenn der angeforderte Name keine symbolische Referenz ist, oder mit 128, wenn ein anderer Fehler auftritt.

SIEHE AUCH

git-update-ref[1]

GIT

Teil der git[1] Suite