Wenn ein oder mehrere <pattern> Parameter angegeben sind, werden nur Refs angezeigt, die mit mindestens einem Muster übereinstimmen, entweder unter Verwendung von fnmatch(3) oder wörtlich, wobei im letzteren Fall eine vollständige Übereinstimmung oder eine Übereinstimmung vom Anfang bis zu einem Schrägstrich erfolgt.

Die Liste der Muster wird von der Standardeingabe anstelle der Argumentliste gelesen.

Stoppt nach der Anzeige von <count> Refs.

Sortiert nach dem Feldnamen <key>. Ein Präfix - sortiert in absteigender Reihenfolge des Wertes. Wenn nicht spezifiziert, wird refname verwendet. Sie können die Option --sort=<key> mehrmals verwenden, wobei der letzte Schlüssel zum primären Schlüssel wird.

Eine Zeichenkette, die %(fieldname) von einem angezeigten Ref und dem Objekt, auf das es zeigt, interpoliert. Zusätzlich rendert die Zeichenkette %% als % und %xx - wobei xx Hexadezimalziffern sind - als das Zeichen mit dem Hex-Code xx. Zum Beispiel interpoliert %00 zu \0 (NUL), %09 zu \t (TAB) und %0a zu \n (LF).

Beachtet alle Farben, die in der Option --format angegeben sind. Das Feld <when_ muss einer der Werte always, never oder auto sein (wenn <when> fehlt, verhält es sich so, als wäre always angegeben).

Wenn angegeben, werden Zeichenketten, die %(fieldname) Platzhalter ersetzen, als Zeichenkettenliterale zitiert, die für die angegebene Host-Sprache geeignet sind. Dies soll ein Skript erzeugen, das direkt "evaluiert" werden kann.

Nur Refs auflisten, die auf das angegebene Objekt zeigen.

Nur Refs auflisten, deren Spitzen erreichbar sind von dem angegebenen Commit (HEAD, wenn nicht angegeben).

Nur Refs auflisten, deren Spitzen nicht erreichbar sind von <object> (HEAD, wenn nicht angegeben).

Nur Refs auflisten, die <object> enthalten (HEAD, wenn nicht angegeben).

Nur Refs auflisten, die <object> nicht enthalten (HEAD, wenn nicht angegeben).

Sortierung und Filterung von Refs sind case-insensitiv.

Druckt keine neue Zeile nach formatierten Refs, bei denen das Format zu einer leeren Zeichenkette expandiert.

Wenn eine oder mehrere --exclude Optionen angegeben sind, werden nur Refs angezeigt, die mit keinem der <excluded-pattern> Parameter übereinstimmen. Die Übereinstimmung erfolgt nach den gleichen Regeln wie bei <pattern> oben.

Root-Refs (HEAD und Pseudorefs) zusätzlich zu regulären Refs auflisten.

Ermöglicht die Paginierung der Ausgabe, indem Referenzen bis einschließlich des angegebenen Markers übersprungen werden. Beim Paginieren ist zu beachten, dass Referenzen zwischen den Aufrufen gelöscht, geändert oder hinzugefügt werden können. Die Ausgabe liefert nur die Referenzen, die alphabetisch nach dem Marker kommen. Die Ausgabe beginnt mit der ersten Referenz, die alphabetisch nach dem Marker kommt. Kann nicht mit --sort=<key> oder --stdin Optionen oder dem/den <pattern> Argument(en) zur Begrenzung der Refs verwendet werden.

Der Name des Refs (der Teil nach $GIT_DIR/). Für einen nicht-mehrdeutigen Kurznamen des Refs hängen Sie :short an. Die Option core.warnAmbiguousRefs wird verwendet, um den strengen Abkürzungsmodus auszuwählen. Wenn lstrip=<n> (rstrip=<n>) angehängt wird, werden <n> schrägstrichgetrennte Pfadkomponenten von vorne (hinten) des Refnamens entfernt (z.B. wird %(refname:lstrip=2) aus refs/tags/foo zu foo und %(refname:rstrip=2) aus refs/tags/foo zu refs). Wenn <n> eine negative Zahl ist, werden so viele Pfadkomponenten wie nötig vom angegebenen Ende entfernt, um -<n> Pfadkomponenten zu belassen (z.B. wird %(refname:lstrip=-2) aus refs/tags/foo zu tags/foo und %(refname:rstrip=-1) aus refs/tags/foo zu refs). Wenn der Ref nicht genügend Komponenten hat, wird das Ergebnis eine leere Zeichenkette, wenn mit positivem <n> gestrippt wird, oder es wird der vollständige Refname, wenn mit negativem <N> gestrippt wird. Keines davon ist ein Fehler.

Der Typ des Objekts (blob, tree, commit, tag).

Die Größe des Objekts (dieselbe wie von git cat-file -s gemeldet). Hängen Sie :disk an, um die Größe in Bytes zu erhalten, die das Objekt auf der Festplatte belegt. Siehe den Hinweis zu Festplattengrößen im Abschnitt HINWEISE unten.

Der Objektname (auch bekannt als SHA-1). Für eine nicht-mehrdeutige Abkürzung des Objektnamens hängen Sie :short an. Für eine Abkürzung des Objektnamens mit gewünschter Länge hängen Sie :short=<length> an, wobei die minimale Länge MINIMUM_ABBREV ist. Die Länge kann überschritten werden, um eindeutige Objektnamen zu gewährleisten.

Dies erweitert sich zum Objektname der Delta-Basis für das gegebene Objekt, wenn es als Delta gespeichert ist. Andernfalls erweitert es sich zum Null-Objekt-Namen (all Nullen).

Der Name eines lokalen Refs, der als "upstream" vom angezeigten Ref betrachtet werden kann. Berücksichtigt :short, :lstrip und :rstrip auf die gleiche Weise wie refname. Berücksichtigt zusätzlich :track, um "[ahead N, behind M]" anzuzeigen, und :trackshort, um die knappe Version anzuzeigen: ">" (ahead), "<" (behind), "<>" (ahead und behind) oder "=" (synchron). :track gibt auch "[gone]" aus, wenn ein unbekannter Upstream-Ref angetroffen wird. Hängen Sie :track,nobracket an, um Tracking-Informationen ohne Klammern anzuzeigen (d.h. "ahead N, behind M").

Der Name eines lokalen Refs, der den @{push} Ort für den angezeigten Ref darstellt. Berücksichtigt die Optionen :short, :lstrip, :rstrip, :track, :trackshort, :remotename und :remoteref, wie upstream. Erzeugt eine leere Zeichenkette, wenn kein @{push} Ref konfiguriert ist.

*, wenn HEAD mit dem aktuellen Ref übereinstimmt (dem ausgecheckten Branch), ansonsten ' '.

Ausgabe-Farbe ändern. Gefolgt von :<colorname>, wobei Farbnamen unter "Values" im Abschnitt "CONFIGURATION FILE" von git-config[1] beschrieben sind. Zum Beispiel %(color:bold red).

Links-, mittel- oder rechts-ausrichten des Inhalts zwischen %(align:...) und %(end). Der "align:" wird gefolgt von width=<width> und position=<position> in beliebiger Reihenfolge, durch Kommas getrennt, wobei <position> entweder left, right oder middle ist, Standard ist left und <width> ist die Gesamtlänge des Inhalts mit Ausrichtung. Zur Kürze können die Präfixe "width=" und/oder "position=" weggelassen und stattdessen bloße <width> und <position> verwendet werden. Zum Beispiel %(align:<width>,<position>). Wenn die Länge des Inhalts größer als die Breite ist, erfolgt keine Ausrichtung. Bei Verwendung mit --quote wird alles zwischen %(align:...) und %(end) zitiert, aber wenn verschachtelt, führt nur die oberste Ebene eine Zitierung durch.

Verwendet als %(if)...%(then)...%(end) oder %(if)...%(then)...%(else)...%(end). Wenn nach dem %(if) ein Atom mit einem Wert oder Zeichenkettenliteral vorhanden ist, wird alles nach dem %(then) ausgegeben. Andernfalls, wenn das %(else) Atom verwendet wird, wird alles nach %(else) ausgegeben. Wir ignorieren Leerzeichen bei der Auswertung der Zeichenkette vor %(then), was nützlich ist, wenn wir das %(HEAD) Atom verwenden, das entweder "*" oder " " ausgibt, und wir die if Bedingung nur auf den HEAD Ref anwenden wollen. Hängen Sie ":equals=<string>" oder ":notequals=<string>" an, um den Wert zwischen dem %(if:...) und %(then) Atom mit der gegebenen Zeichenkette zu vergleichen.

Der Ref, auf den der gegebene symbolische Ref verweist. Wenn es kein symbolischer Ref ist, wird nichts ausgegeben. Berücksichtigt die Optionen :short, :lstrip und :rstrip auf die gleiche Weise wie refname oben.

Die GPG-Signatur eines Commits.

Zeigt

Der Unterzeichner der GPG-Signatur eines Commits.

Der Schlüssel der GPG-Signatur eines Commits.

Der Fingerabdruck der GPG-Signatur eines Commits.

Der Fingerabdruck des Primärschlüssels der GPG-Signatur eines Commits.

Das Vertrauensniveau der GPG-Signatur eines Commits. Mögliche Ausgaben sind ultimate, fully, marginal, never und undefined.

Der absolute Pfad zum Arbeitsverzeichnis, in dem der Ref ausgecheckt ist, falls er in einem verknüpften Arbeitsverzeichnis ausgecheckt ist. Andernfalls eine leere Zeichenkette.

Zwei Ganzzahlen, durch ein Leerzeichen getrennt, die die Anzahl der "ahead" und "behind" Commits anzeigen, wenn der Ausgabereferenz mit dem in <committish> angegebenen Commit verglichen wird.

In maximal einer Zeile wird (<commit-ish>) angezeigt, um den Ref zu kennzeichnen, der höchstwahrscheinlich als Ausgangspunkt für den Branch verwendet wurde, der <commit-ish> erzeugt hat. Diese Wahl wird mit einer Heuristik getroffen: Wähle den Ref, der die Anzahl der Commits in der First-Parent-Historie von <commit-ish> minimiert und nicht in der First-Parent-Historie des Refs enthalten ist.

*--*--*--*--*--* refs/heads/A
\
 \
  *--*--*--* refs/heads/B
   \     \
    \     \
     *     * refs/heads/C
      \
       \
	*--* refs/heads/D

refs/heads/A:
refs/heads/B:(D)
refs/heads/C:

Ein menschenlesbarer Name, ähnlich wie bei git-describe[1]; eine leere Zeichenkette für nicht beschreibbare Commits. Die describe Zeichenkette kann von einem Doppelpunkt und einem oder mehreren durch Kommas getrennten Optionen gefolgt werden.

Die Rohdaten-Größe des Objekts.

Die Größe der Commit- oder Tag-Nachricht in Bytes.

Der erste Absatz der Nachricht, der typischerweise eine einzelne Zeile ist, wird als "Betreff" der Commit- oder Tag-Nachricht genommen. Anstelle von contents:subject kann auch das Feld subject verwendet werden, um dasselbe Ergebnis zu erzielen. :sanitize kann an subject angehängt werden, um eine für Dateinamen geeignete Betreffzeile zu erhalten.

Der Rest der Commit- oder Tag-Nachricht, der dem "Betreff" folgt.

Die optionale GPG-Signatur des Tags.

Die ersten <n> Zeilen der Nachricht.