English ▾ Themen ▾ Neueste Version ▾ git-show-ref zuletzt aktualisiert in 2.46.0

NAME

git-show-ref - Referenzen in einem lokalen Repository auflisten

SYNOPSIS

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>

BESCHREIBUNG

Zeigt verfügbare Referenzen in einem lokalen Repository zusammen mit den zugehörigen Commit-IDs an. Ergebnisse können mit einem Muster gefiltert werden und Tags können in Objekt-IDs dereferenziert werden. Zusätzlich kann es verwendet werden, um zu testen, ob eine bestimmte Referenz existiert.

Standardmäßig werden Tags, Heads und Remote-Referenzen angezeigt.

Die Form --exclude-existing ist ein Filter, der das Gegenteil tut. Er liest Referenzen von stdin, eine Referenz pro Zeile, und zeigt diejenigen an, die im lokalen Repository nicht existieren.

Die Form --exists kann verwendet werden, um die Existenz einer einzelnen Referenz zu überprüfen. Diese Form überprüft nicht, ob die Referenz auf ein tatsächliches Objekt verweist.

Die Verwendung dieses Dienstprogramms wird gegenüber dem direkten Zugriff auf Dateien unter dem .git-Verzeichnis empfohlen.

OPTIONEN

--head

Zeigt die HEAD-Referenz an, auch wenn sie normalerweise herausgefiltert würde.

--branches
--tags

Beschränkt auf lokale Branches bzw. lokale Tags. Diese Optionen sind nicht gegenseitig ausschließend; wenn beide angegeben sind, werden Referenzen angezeigt, die in "refs/heads" und "refs/tags" gespeichert sind. Beachten Sie, dass --heads ein veraltetes Synonym für --branches ist und in Zukunft entfernt werden könnte.

-d
--dereference

Dereferenziert auch Tags in Objekt-IDs. Sie werden mit angehängtem ^{} angezeigt.

-s
--hash[=<n>]

Zeigt nur die OID an, nicht den Referenznamen. In Kombination mit --dereference wird der dereferenzierte Tag weiterhin nach der OID angezeigt.

--verify

Aktiviert eine strengere Referenzprüfung, indem ein exakter Ref-Pfad verlangt wird. Abgesehen davon, dass ein Fehlercode von 1 zurückgegeben wird, wird auch eine Fehlermeldung ausgegeben, wenn --quiet nicht angegeben wurde.

--exists

Prüft, ob die angegebene Referenz existiert. Gibt den Exit-Code 0 zurück, wenn sie existiert, 2, wenn sie fehlt, und 1, falls beim Nachschlagen der Referenz ein anderer Fehler als das Fehlen der Referenz aufgetreten ist.

--abbrev[=<n>]

Kürzt den Objekt-Namen ab. Bei Verwendung von --hash müssen Sie nicht --hash --abbrev sagen; --hash=n würde genügen.

-q
--quiet

Gibt keine Ergebnisse an stdout aus. Kann mit --verify verwendet werden, um stillschweigend zu prüfen, ob eine Referenz existiert.

--exclude-existing[=<pattern>]

Lässt git show-ref als Filter fungieren, der Referenzen von stdin im Format ^(?:<beliebiges>\s)?<refname>(?:\^{})?$ liest und bei jeder der folgenden Aktionen ausführt: (1) streift ^{} am Ende der Zeile ab, falls vorhanden; (2) ignoriert, wenn ein Muster angegeben ist und nicht mit dem refname übereinstimmt; (3) warnt, wenn der refname kein wohlgeformter refname ist und überspringt; (4) ignoriert, wenn der refname eine Referenz ist, die im lokalen Repository existiert; (5) gibt ansonsten die Zeile aus.

<pattern>…​

Zeigt Referenzen an, die einem oder mehreren Mustern entsprechen. Muster werden vom Ende des vollständigen Namens aus abgeglichen, und nur vollständige Teile werden abgeglichen, z.B. master passt zu refs/heads/master, refs/remotes/origin/master, refs/tags/jedi/master, aber nicht zu refs/heads/mymaster oder refs/remotes/master/jedi.

AUSGABE

Die Ausgabe erfolgt im Format

<oid> SP <ref> LF

Zum Beispiel,

$ 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^{}
...

Bei Verwendung von --hash (und nicht --dereference) erfolgt die Ausgabe im Format

<oid> LF

Zum Beispiel,

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

BEISPIELE

Um alle Referenzen mit dem Namen "master" anzuzeigen, unabhängig davon, ob es sich um Tags, Heads oder etwas anderes handelt, und unabhängig davon, wie tief sie in der Referenzhierarchie verschachtelt sind, verwenden Sie

	git show-ref master

Dies zeigt "refs/heads/master", aber auch "refs/remote/other-repo/master", falls solche Referenzen existieren.

Bei Verwendung des Flags --verify erfordert der Befehl einen exakten Pfad

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

passt nur zum exakten Branch namens "master".

Wenn nichts übereinstimmt, gibt git show-ref einen Fehlercode von 1 zurück, und im Falle einer Verifizierung wird eine Fehlermeldung angezeigt.

Für Skripte können Sie mit dem Flag --quiet die Ausgabe unterdrücken, was Ihnen ermöglicht, Dinge wie dieses zu tun:

	git show-ref --quiet --verify -- "refs/heads/$headname" ||
		echo "$headname is not a valid branch"

um zu überprüfen, ob ein bestimmter Branch existiert oder nicht (beachten Sie, dass wir eigentlich keine Ergebnisse anzeigen möchten und den vollständigen Refname verwenden, um das Problem mehrdeutiger Teilübereinstimmungen zu vermeiden).

Um nur Tags oder nur reguläre Branch-Heads anzuzeigen, verwenden Sie --tags bzw. --branches (die Verwendung beider bedeutet, dass Tags und Branches, aber keine anderen zufälligen Referenzen unter dem Unterverzeichnis refs/ angezeigt werden).

Um eine automatische Dereferenzierung von Tag-Objekten durchzuführen, verwenden Sie das Flag -d oder --dereference, damit Sie tun können

	git show-ref --tags --dereference

um eine Liste aller Tags zusammen mit dem, worauf sie verweisen, zu erhalten.

DATEIEN

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

SIEHE AUCH

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

GIT

Teil der git[1] Suite