10.8 Git Binnenwerk - Omgevingsvariabelen

Een bepaald deel van het algemene gedrag van Git als computer programma is afhankelijk van omgevingsvariabelen.

GIT_EXEC_PATH bepaalt waar Git zijn sub-programma’s zoekt (zoals git-commit, git-diff en andere). Je kunt de huidige waarde zien door git --exec-path aan te roepen.

HOME wordt over het algemeen niet beschouwd als aanpasbaar (te veel andere zaken zijn hiervan afhankelijk), maar dit is waar Git op zoek gaat naar het globale configuratie bestand. Als je een echte overdraagbare Git installatie wilt, compleet met globale configuratie, kan je HOME overschrijven in het shell profiel van de draagbare Git.

PREFIX is hiermee vergelijkbaar, maar voor de systeem-brede configuratie. Git kijkt naar dit bestand op $PREFIX/etc/gitconfig.

GIT_CONFIG_NOSYSTEM, indien gezet, schakelt dit het gebruik van het systeem-brede configuratie bestand uit. Dit kan nuttig zijn als je systeem configuratie je commando’s in de weg zit, maar je hebt hier geen toegang toe om het te wijzigen of te verwijderen.

GIT_PAGER bepaalt welk programma er gebruikt wordt om uitvoer van meerdere pagina’s op de commando regel te laten zien. Als deze waarde niet gezet is, wordt PAGER gebruikt als achtervang.

GIT_EDITOR is de editor die Git zal aanroepen als de gebruiker tekst moet wijzigen (een commit bericht, bijvoorbeeld). Als deze waarde niet is gezet, wordt EDITOR gebruikt.

Git gebruikt een aantal omgevingsvariabelen om te bepalen hoe het met de huidige repository samenwerkt.

GIT_DIR is de locatie van de .git folder. Als dit niet is opgegeven, loopt Git de directory structuur omhoog tot het op ~ of / uitkomt, bij elke stap opzoek naar een .git directory.

GIT_CEILING_DIRECTORIES bepaalt het gedrag bij het zoeken naar een .git directory. Als je directories in gaat die langzaam zijn (zoals die op een tape drive, of over een langzame netwerkverbinding), zou je ervoor kunnen kiezen om Git te eerder laten stoppen met proberen dan het anders zou doen, zeker als Git wordt aangeroepen als je shell prompt wordt opgebouwd.

GIT_WORK_TREE is de locatie van de root van de werkdirectory voor een non-bare repository. Als --git-dir of GIT-DIR wordt gespecificeerd maar geen van --work-tree, GIT_WORK_TREE of core.worktree is gegeven wordt de huidige werk-directory beschouwd als het hoogste niveau van je werk-tree.

GIT_INDEX_FILE is het pad naar het index bestand (alleen bij non-bare repositories).

GIT_OBJECT_DIRECTORY kan worden gebruikt om de locatie van de directory aan te geven die normaalgesproken onder .git/objects te vinden is.

GIT_ALTERNATE_OBJECT_DIRECTORIES is een met dubbele punt gescheiden lijst (geformatteerd als /dir/een:/dir/twee:…) die vertelt waar Git moet zoeken naar objecten als ze niet in GIT_OBJECT_DIRECTORY te vinden zijn. Als je toevallig veel projecten hebt met grote bestanden die precies dezelfde inhoud hebben, kan dit worden gebruiktom te voorkomen dat er teveel kopieën hiervan worden opgeslagen.

Een “pathspec” refereert aan hoe je paden opgeeft bij zaken in Git, inclusief het gebruik van wildcards. Deze worden gebruikt in het .gitignore bestand, maar ook op de commando-regel (git add *.c).

GIT_GLOB_PATHSPECS en GIT_NOGLOB_PATHSPECS bepalen het standaard gedrag van wildcards in pathspecs. Als GIT_GLOB_PATHSPECS de waarde 1 heeft, gedragen wildcard karakters als wildcards (wat het standaard gedrag is); als GIT_NOGLOB_PATHSPECS de waarde 1 heeft, passen wildcard karakters alleen op zichzelf, wat inhoudt dat iets als *c alleen een bestand met de naam “*.c” zou passen, in plaats van elk bestand waarvan de naam eindigt op .c. Je kunt dit gedrag in specifieke gevallen overschrijven door de pathspecs te laten beginnen met :(glob) of :(literal), als in :(glob)*.c.

GIT_LITERAL_PATHSPECS schakelt beide bovenstaande gedragingen uit; geen enkele wildcard karakter zal werken, en de overschrijvende prefixes worden ook uitgeschakeld.

GIT_ICASE_PATHSPECS zet alle pathspecs in voor ongevoelige werkwijze voor hoofdletters en kleine letters.

De uiteindelijke aanmaak van een Git commit object wordt normaalgesproken gedaan door git-commit-tree, die de omgevingsvariabelen gebruikt als zijn primaire bron van informatie, waarbij wordt teruggevallen op configuratiewaarden alleen als deze niet aanwezig zijn.

GIT_AUTHOR_NAME is de mens-leesbare naam in het “author” veld.

GIT_AUTHOR_EMAIL is de email voor het “author” veld.

GIT_AUTHOR_DATE is de datum/tijd waarde die voor het “author” veld wordt gebruikt.

GIT_COMMITTER_NAME bepaalt de mens-leesbare naam voor het “committer” veld.

GIT_COMMITTER_EMAIL is het email adres voor het “committer” veld.

GIT_COMMITTER_DATE wordt gebruikt voor de datum/tijd waarde in het “committer” veld.

EMAIL is de terugvalwaarde voor het email adres in geval de configuratie waarde in user.email niet is ingevuld. Als deze niet is ingevuld, valt Git terug op de systeemgebruiker en host naam.

Git gebruikt de curl library om netwerk operaties over HTTP te doen, dus GIT_CURL_VERBOSE vertelt Git om alle berichten uit te sturen die worden gegenereerd door deze library. Dit is gelijk aan het intypen van curl -v op de commandoregel.

GIT_SSL_NO_VERIFY vertelt Git om de SSL certificaten niet te controleren. Dit kan soms nodig zijn als je een door jezelf ondertekende certificaat gebruikt om Git repositories te bedienen via HTTPS, of je bent bezig met het opzetten van een Git server maar je hebt nog geen volwaardig certificaat geïnstalleerd.

Als de gegevenssnelheid van een HTTP operatie lager is dan GIT_HTTP_LOW_SPEED_LIMIT bytes per seconde voor langer dan GIT_HTTP_LOW_SPEED_TIME seconden, zal Git die operatie afbreken. Deze waarden overschrijven de http.lowSpeedLimit en http.lowSpeedTime configuratie waarden.

GIT_HTTP_USER_AGENT zet de user-agent tekenreeks die Git gebruikt wanneer het communiceert via HTTP. De standaard waarde is iets als git/2.0.0.

GIT_DIFF_OPTS is een beetje een misnomer. De enige geldige waarden zijn -u<n> of --unified=<n>, wat het aantal contextregels bepaalt die worden getoond met een git diff commando.

GIT_EXTERNAL_DIFF wordt gebruikt als een overschrijving voor de diff.external configuratie waarde. Als het een waarde heeft, zal Git dit programma gebruiken als git diff wordt aangeroepen.

GIT_DIFF_PATH_COUNTER en GIT_DIFF_PATH_TOTAL zijn nuttig binnen het programma die wordt gespecificeerd door GIT_EXTERNAL_DIFF of diff.external. Het eerste geeft aan welk bestand in een reeks van bestanden wordt gedifft (beginnend met 1), en de laatste is het totaal aantal bestanden in de reeks.

GIT_MERGE_VERBOSITY bepaalt de uitvoer voor de recursieve merge strategie. De toegestane waarden zijn als volgt:

De standaardwaarde is 2.

Wil je echt zien waar Git zoal mee bezig is? Git heeft een redelijk volledige set van traces ingebouwd, en alles wat je hoeft te doen is ze aan te zetten. De mogelijke waarden van deze variabelen zijn als volgt:

GIT_TRACE bepaalt traces over het algemeen die niet in een andere specifieke categorie valt. Dit is inclusief de expansie van aliassen, en het delegeren naar andere sub-programma’s.

GIT_TRACE_PACK_ACCESS bepaalt het traceren van packfile toegang. Het eerste veld is de packfile die wordt benaderd, het tweede is de relatieve afstand (offset) binnen dat bestand:

GIT_TRACE_PACKET zet traceren op pakket-niveau voor netwerk operaties aan.

GIT_TRACE_PERFORMANCE bepaalt het loggen van performance gegevens aan. De uitvoer laat zien hoe lang elk specifieke git aanroep duurt.

GIT_TRACE_SETUP laat informatie zien over wat Git ontdekt over de repository en de omgeving waar het mee samenwerkt.

GIT_SSH, indien meegegeven, is een programma dat wordt aangeroepen inplaats van ssh als Git probeert verbinding te leggen naar een SSH host. Het wordt aangeroepen als $GIT_SSH [gebruikersnaam@]host [-p <poort>] <commando>. Merk op dat dit niet de makkelijkste manier is om de manier waarop ssh wordt aangeroepen aan te passen; het zal extra commando-regel parameters niet ondersteunen, dus je zult een wrapper script moeten schrijven en GIT_SSH hiernaar moeten laten wijzen. Het is waarschijnlijk makkelijker om gewoon het ~/.ssh/config bestand hiervoor te gebruiken.

GIT_ASKPASS overschrijft de waarde van de core.askpass configuratie waarde. Dit is het programma dat wordt aangeroepen elke keer als Git de gebruiker moet vragen om de aanloggegevens, die een tekst prompt mag verwachten als een commando-regel argument, en het antwoord moet teruggeven op stdout. (Zie Het opslaan van inloggegevens voor meer over dit subsysteem.)

GIT_NAMESPACE bepaalt de toegang tot refs in een namespace, en is gelijjkwaardig aan de --namespace vlag. Dit wordt is voornamelijk nuttig aan de kant van de server, waar je misschien meerdere forks wilt opslaan van een enkele repository, waarbij alleen de refs apart wordt gehouden.

GIT_FLUSH kan gebruikt worden om Git te dwingen om niet gebufferde I/O te gebruiken als het incrementeel naar stdout schrijft. Een waarde van 1 heeft als gevolg dat Git vaker wegschrijft, een waarde van 0 heeft tot gevolg dat alle uitvoer eerst wordt gebufferd. De standaard waarde (als deze waarde niet wordt opgegeven) is om een toepasselijke bufferschema te kiezen afhankelijk van de aktiviteit en de uitvoer-modus.

GIT_REFLOG_ACTION* laat je de omschrijvende tekst bepalen die naar de reflog wordt geschreven. Hier is een voorbeeld: