10.8 Git Internals - Umgebungsvariablen

Einige allgemeine Verhaltensweisen von Git als Computerprogramm hängen von Umgebungsvariablen ab.

GIT_EXEC_PATH bestimmt, wo Git nach seinen Unterprogrammen sucht (wie git-commit, git-diff und andere). Sie können die aktuelle Einstellung überprüfen, indem Sie git --exec-path ausführen.

HOME wird normalerweise nicht als anpassbar betrachtet (zu viele andere Dinge hängen davon ab), aber es ist der Ort, an dem Git nach der globalen Konfigurationsdatei sucht. Wenn Sie eine wirklich portable Git-Installation wünschen, komplett mit globaler Konfiguration, können Sie HOME im Shell-Profil von portablem Git überschreiben.

PREFIX ist ähnlich, aber für die systemweite Konfiguration. Git sucht diese Datei unter $PREFIX/etc/gitconfig.

GIT_CONFIG_NOSYSTEM, wenn gesetzt, deaktiviert die Verwendung der systemweiten Konfigurationsdatei. Dies ist nützlich, wenn Ihre Systemkonfiguration Ihre Befehle beeinträchtigt, Sie aber keinen Zugriff haben, um sie zu ändern oder zu entfernen.

GIT_PAGER steuert das Programm, das verwendet wird, um mehrseitige Ausgaben auf der Kommandozeile anzuzeigen. Wenn dies nicht gesetzt ist, wird PAGER als Fallback verwendet.

GIT_EDITOR ist der Editor, den Git startet, wenn der Benutzer Text bearbeiten muss (z. B. eine Commit-Nachricht). Wenn nicht gesetzt, wird EDITOR verwendet.

Git verwendet mehrere Umgebungsvariablen, um zu bestimmen, wie es mit dem aktuellen Repository interagiert.

GIT_DIR ist der Speicherort des .git-Ordners. Wenn dies nicht angegeben ist, durchsucht Git den Verzeichnisbaum nach oben, bis es ~ oder / erreicht, und sucht bei jedem Schritt nach einem .git-Verzeichnis.

GIT_CEILING_DIRECTORIES steuert das Verhalten bei der Suche nach einem .git-Verzeichnis. Wenn Sie auf Verzeichnisse zugreifen, deren Laden langsam ist (z. B. auf einem Bandlaufwerk oder über eine langsame Netzwerkverbindung), möchten Sie vielleicht, dass Git früher aufhört zu suchen, als es sonst tun würde, insbesondere wenn Git beim Erstellen Ihrer Shell-Eingabeaufforderung aufgerufen wird.

GIT_WORK_TREE ist der Speicherort der Wurzel des Arbeitsverzeichnisses für ein Nicht-Bare-Repository. Wenn --git-dir oder GIT_DIR angegeben ist, aber keines von --work-tree, GIT_WORK_TREE oder core.worktree angegeben ist, wird das aktuelle Arbeitsverzeichnis als oberste Ebene Ihres Arbeitsbaums betrachtet.

GIT_INDEX_FILE ist der Pfad zur Indexdatei (nur für Nicht-Bare-Repositories).

GIT_OBJECT_DIRECTORY kann verwendet werden, um den Speicherort des Verzeichnisses anzugeben, das sich normalerweise unter .git/objects befindet.

GIT_ALTERNATE_OBJECT_DIRECTORIES ist eine durch Doppelpunkte getrennte Liste (formatiert als /dir/one:/dir/two:…), die Git mitteilt, wo nach Objekten gesucht werden soll, wenn sie sich nicht in GIT_OBJECT_DIRECTORY befinden. Wenn Sie viele Projekte mit großen Dateien haben, die exakt dieselben Inhalte haben, können Sie damit vermeiden, zu viele Kopien davon zu speichern.

Eine „Pfadspezifikation“ bezieht sich darauf, wie Sie Pfade zu Dingen in Git angeben, einschließlich der Verwendung von Wildcards. Diese werden in der Datei .gitignore verwendet, aber auch auf der Kommandozeile (git add *.c).

GIT_GLOB_PATHSPECS und GIT_NOGLOB_PATHSPECS steuern das Standardverhalten von Wildcards in Pfadspezifikationen. Wenn GIT_GLOB_PATHSPECS auf 1 gesetzt ist, verhalten sich Wildcard-Zeichen als Wildcards (was der Standard ist); wenn GIT_NOGLOB_PATHSPECS auf 1 gesetzt ist, passen sich Wildcard-Zeichen nur selbst an, was bedeutet, dass etwas wie *.c nur eine Datei *namens* „\*.c“ abgleichen würde, anstatt jede Datei, deren Name mit .c endet. Sie können dies in Einzelfällen überschreiben, indem Sie die Pfadspezifikation mit :(glob) oder :(literal) beginnen, wie in :(glob)\*.c.

GIT_LITERAL_PATHSPECS deaktiviert beide oben genannten Verhaltensweisen; keine Wildcard-Zeichen funktionieren, und die Override-Präfixe sind ebenfalls deaktiviert.

GIT_ICASE_PATHSPECS setzt alle Pfadspezifikationen auf den Fall-unabhängigen Betrieb.

Die endgültige Erstellung eines Git-Commit-Objekts erfolgt normalerweise durch git-commit-tree, das diese Umgebungsvariablen als primäre Informationsquelle verwendet und nur auf Konfigurationswerte zurückgreift, wenn diese nicht vorhanden sind.

GIT_AUTHOR_NAME ist der menschenlesbare Name im Feld „author“.

GIT_AUTHOR_EMAIL ist die E-Mail-Adresse für das Feld „author“.

GIT_AUTHOR_DATE ist der Zeitstempel, der für das Feld „author“ verwendet wird.

GIT_COMMITTER_NAME setzt den menschenlesbaren Namen für das Feld „committer“.

GIT_COMMITTER_EMAIL ist die E-Mail-Adresse für das Feld „committer“.

GIT_COMMITTER_DATE wird für den Zeitstempel im Feld „committer“ verwendet.

EMAIL ist die Fallback-E-Mail-Adresse, falls der Konfigurationswert user.email nicht gesetzt ist. Wenn *dieser* nicht gesetzt ist, greift Git auf den Systembenutzer und die Hostnamen zurück.

Git verwendet die curl-Bibliothek für Netzwerkoperationen über HTTP, daher gibt GIT_CURL_VERBOSE an, dass Git alle von dieser Bibliothek generierten Meldungen ausgeben soll. Dies ist ähnlich wie bei curl -v auf der Kommandozeile.

GIT_SSL_NO_VERIFY weist Git an, SSL-Zertifikate nicht zu überprüfen. Dies kann manchmal notwendig sein, wenn Sie ein selbstsigniertes Zertifikat verwenden, um Git-Repositories über HTTPS bereitzustellen, oder wenn Sie einen Git-Server einrichten, aber noch kein vollständiges Zertifikat installiert haben.

Wenn die Datenrate einer HTTP-Operation niedriger als GIT_HTTP_LOW_SPEED_LIMIT Bytes pro Sekunde für länger als GIT_HTTP_LOW_SPEED_TIME Sekunden ist, bricht Git diese Operation ab. Diese Werte überschreiben die Konfigurationswerte http.lowSpeedLimit und http.lowSpeedTime.

GIT_HTTP_USER_AGENT setzt den User-Agent-String, den Git bei der Kommunikation über HTTP verwendet. Der Standardwert ist ein Wert wie git#2.0.0.

GIT_DIFF_OPTS ist eine Fehlbezeichnung. Die einzig gültigen Werte sind -u<n> oder --unified=<n>, die die Anzahl der Kontextzeilen steuern, die in einem git diff-Befehl angezeigt werden.

GIT_EXTERNAL_DIFF wird als Überschreibung für den Konfigurationswert diff.external verwendet. Wenn er gesetzt ist, ruft Git dieses Programm auf, wenn git diff aufgerufen wird.

GIT_DIFF_PATH_COUNTER und GIT_DIFF_PATH_TOTAL sind nützlich innerhalb des Programms, das von GIT_EXTERNAL_DIFF oder diff.external angegeben wird. Ersteres repräsentiert, welche Datei in einer Serie diff-geändert wird (beginnend mit 1), und letzteres ist die Gesamtzahl der Dateien im Stapel.

GIT_MERGE_VERBOSITY steuert die Ausgabe für die rekursive Merge-Strategie. Die erlaubten Werte sind wie folgt:

Der Standardwert ist 2.

Möchten Sie *wirklich* wissen, was Git tut? Git verfügt über eine recht vollständige Reihe von Traces, und Sie müssen sie nur einschalten. Die möglichen Werte dieser Variablen sind wie folgt:

GIT_TRACE steuert allgemeine Traces, die in keine bestimmte Kategorie passen. Dazu gehört die Erweiterung von Aliassen und die Delegation an andere Unterprogramme.

GIT_TRACE_PACK_ACCESS steuert die Nachverfolgung des Zugriffs auf Packdateien. Das erste Feld ist die angesprochene Packdatei, das zweite ist der Offset innerhalb dieser Datei.

GIT_TRACE_PACKET aktiviert die Paket-Level-Nachverfolgung für Netzwerkoperationen.

GIT_TRACE_PERFORMANCE steuert die Protokollierung von Leistungsdaten. Die Ausgabe zeigt, wie lange jede einzelne git-Aufrufung dauert.

GIT_TRACE_SETUP zeigt Informationen darüber an, was Git über das Repository und die Umgebung entdeckt, mit der es interagiert.

GIT_SSH, wenn gesetzt, ist ein Programm, das anstelle von ssh aufgerufen wird, wenn Git versucht, eine Verbindung zu einem SSH-Host herzustellen. Es wird aufgerufen wie $GIT_SSH [username@]host [-p <port>] <command>. Beachten Sie, dass dies nicht der einfachste Weg ist, anzupassen, wie ssh aufgerufen wird; es unterstützt keine zusätzlichen Kommandozeilenparameter. Um zusätzliche Kommandozeilenparameter zu unterstützen, können Sie GIT_SSH_COMMAND verwenden, ein Wrapper-Skript schreiben und GIT_SSH darauf setzen oder die Datei ~/.ssh/config verwenden.

GIT_SSH_COMMAND setzt den SSH-Befehl, der verwendet wird, wenn Git versucht, eine Verbindung zu einem SSH-Host herzustellen. Der Befehl wird von der Shell interpretiert, und zusätzliche Kommandozeilenargumente können mit ssh verwendet werden, wie z. B. GIT_SSH_COMMAND="ssh -i ~/.ssh/my_key" git clone git@example.com:my/repo.

GIT_ASKPASS ist eine Überschreibung des Konfigurationswerts core.askpass. Dies ist das Programm, das immer dann aufgerufen wird, wenn Git den Benutzer nach Anmeldeinformationen fragen muss. Es kann eine Textaufforderung als Kommandozeilenargument erwarten und sollte die Antwort auf stdout zurückgeben (siehe Credential Storage für mehr zu diesem Untersystem).

GIT_NAMESPACE steuert den Zugriff auf Namespaced Refs und ist äquivalent zum Flag --namespace. Dies ist hauptsächlich auf der Serverseite nützlich, wo Sie möglicherweise mehrere Forks eines einzelnen Repositorys in einem Repository speichern möchten, wobei nur die Refs getrennt gehalten werden.

GIT_FLUSH kann verwendet werden, um Git zu zwingen, nicht gepufferte E/A zu verwenden, wenn inkrementell auf stdout geschrieben wird. Ein Wert von 1 bewirkt, dass Git häufiger flusht, ein Wert von 0 bewirkt, dass die gesamte Ausgabe gepuffert wird. Der Standardwert (wenn diese Variable nicht gesetzt ist) ist die Auswahl eines geeigneten Pufferungsschemas, abhängig von der Aktivität und dem Ausgabemodus.

GIT_REFLOG_ACTION ermöglicht es Ihnen, den beschreibenden Text festzulegen, der in das Reflog geschrieben wird. Hier ist ein Beispiel: