10.8 Git bakom kulisserna - Miljövariabler

En del av Gits allmänna beteende som program styrs av miljövariabler.

GIT_EXEC_PATH avgör var Git letar efter sina underprogram (som git-commit, git-diff och andra). Du kan kontrollera den aktuella inställningen genom att köra git --exec-path.

HOME brukar normalt inte betraktas som justerbar (för många andra saker beror på den), men det är där Git letar efter den globala konfigurationsfilen. Om du vill ha en verkligt portabel Git‑installation med global konfiguration kan du skriva över HOME i den portabla Git‑skalprofilen.

Liknande gäller PREFIX, men för systemomfattande konfiguration. Git letar efter denna fil vid $PREFIX/etc/gitconfig.

GIT_CONFIG_NOSYSTEM inaktiverar, om den är satt, användningen av den systemomfattande konfigurationsfilen. Det är användbart om din systemkonfiguration stör dina kommandon, men du inte har åtkomst att ändra eller ta bort den.

GIT_PAGER styr programmet som används för att visa flersidiga utdata på kommandoraden. Om den är osatt används PAGER som reserv.

GIT_EDITOR är redigeraren som Git startar när användaren behöver redigera text (till exempel ett incheckningsmeddelande). Om den är osatt används EDITOR.

Git använder flera miljövariabler för att avgöra hur det interagerar med det aktuella kodförrådet.

GIT_DIR är platsen för .git‑katalogen. Om detta inte anges går Git uppåt i katalogträdet tills det kommer till ~ eller /, och letar efter en .git‑katalog vid varje steg.

GIT_CEILING_DIRECTORIES styr beteendet när Git söker efter en .git‑katalog. Om du öppnar kataloger som är långsamma att läsa in (till exempel på en bandstation eller över en långsam nätverksanslutning) kan du vilja att Git slutar försöka tidigare än det annars skulle, särskilt om Git anropas när ditt skals prompt byggs.

GIT_WORK_TREE är platsen för roten av arbetskatalogen för ett icke‑bart kodförråd. Om --git-dir eller GIT_DIR anges men inget av --work-tree, GIT_WORK_TREE eller core.worktree anges, betraktas den aktuella arbetskatalogen som toppnivån i ditt arbetsträd.

GIT_INDEX_FILE är sökvägen till indexfilen (endast icke‑bara kodförråd).

GIT_OBJECT_DIRECTORY kan användas för att ange platsen för katalogen som vanligtvis ligger på .git/objects.

GIT_ALTERNATE_OBJECT_DIRECTORIES är en kolon‑separerad lista (formaterad som /dir/one:/dir/two:…) som talar om för Git var det ska leta efter objekt om de inte finns i GIT_OBJECT_DIRECTORY. Om du råkar ha många projekt med stora filer som har exakt samma innehåll kan detta användas för att undvika att lagra för många kopior av dem.

En “pathspec” beskriver hur du anger sökvägar till saker i Git, inklusive användning av jokertecken. Dessa används i .gitignore‑filen, men också på kommandoraden (git add *.c).

GIT_GLOB_PATHSPECS och GIT_NOGLOB_PATHSPECS styr standardbeteendet för jokertecken i pathspecar. Om GIT_GLOB_PATHSPECS är satt till 1 fungerar jokertecken som sådana (vilket är standard); om GIT_NOGLOB_PATHSPECS är satt till 1 matchar jokertecken bara sig själva, vilket betyder att något som *.c bara skulle matcha en fil som heter “\*.c”, i stället för varje fil vars namn slutar på .c. Du kan åsidosätta detta i enskilda fall genom att börja pathspecen med :(glob) eller :(literal), som i :(glob)\*.c.

GIT_LITERAL_PATHSPECS inaktiverar båda ovanstående beteenden; inga jokertecken fungerar, och åsidosättningsprefixen är också inaktiverade.

GIT_ICASE_PATHSPECS gör att alla pathspecar fungerar skiftlägesokänsligt.

Det slutliga skapandet av ett Git‑incheckningsobjekt görs vanligtvis av git-commit-tree, som använder dessa miljövariabler som sin primära informationskälla och bara faller tillbaka på konfigurationsvärden om dessa inte finns.

GIT_AUTHOR_NAME är det mänskligt läsbara namnet i fältet “author”.

GIT_AUTHOR_EMAIL är e‑postadressen för fältet “author”.

GIT_AUTHOR_DATE är tidsstämpeln som används för fältet “author”.

GIT_COMMITTER_NAME anger det mänskliga namnet för fältet “committer”.

GIT_COMMITTER_EMAIL är e‑postadressen för fältet “committer”.

GIT_COMMITTER_DATE används för tidsstämpeln i fältet “committer”.

EMAIL är reserv‑e‑postadressen ifall konfigurationsvärdet user.email inte är satt. Om det inte är satt faller Git tillbaka till systemets användar‑ och värdnamn.

Git använder curl‑biblioteket för nätverksoperationer över HTTP, så GIT_CURL_VERBOSE säger åt Git att skriva ut alla meddelanden som genereras av det biblioteket. Det liknar att köra curl -v på kommandoraden.

GIT_SSL_NO_VERIFY säger åt Git att inte verifiera SSL‑certifikat. Det kan ibland vara nödvändigt om du använder ett självsignerat certifikat för att servera Git‑kodförråd över HTTPS, eller om du håller på att sätta upp en Git‑server men ännu inte har installerat ett fullständigt certifikat.

Om datahastigheten för en HTTP‑operation är lägre än GIT_HTTP_LOW_SPEED_LIMIT byte per sekund under längre tid än GIT_HTTP_LOW_SPEED_TIME sekunder avbryter Git den operationen. Dessa värden åsidosätter konfigurationsvärdena http.lowSpeedLimit och http.lowSpeedTime.

GIT_HTTP_USER_AGENT sätter användaragent‑strängen som Git använder när den kommunicerar över HTTP. Standardvärdet är något i stil med git/2.0.0.

GIT_DIFF_OPTS är ett lite missvisande namn. De enda giltiga värdena är -u<n> eller --unified=<n>, som styr antalet kontextrader som visas i ett git diff‑kommando.

GIT_EXTERNAL_DIFF används som en åsidosättning av konfigurationsvärdet diff.external. Om den är satt kommer Git att anropa detta program när git diff anropas.

GIT_DIFF_PATH_COUNTER och GIT_DIFF_PATH_TOTAL är användbara inifrån programmet som anges av GIT_EXTERNAL_DIFF eller diff.external. Det förstnämnda representerar vilken fil i en serie som diffas (med start på 1), och det senare är det totala antalet filer i omgången.

GIT_MERGE_VERBOSITY styr utdata för den rekursiva sammanslagningsstrategin. Tillåtna värden är följande:

Standardvärdet är 2.

Vill du verkligen veta vad Git håller på med? Git har en ganska komplett uppsättning spårningar inbyggda, och allt du behöver göra är att slå på dem. De möjliga värdena för dessa variabler är följande:

GIT_TRACE styr allmänna spårningar, som inte passar i någon specifik kategori. Detta inkluderar expansion av alias och delegering till andra underprogram.

GIT_TRACE_PACK_ACCESS styr spårning av packfilåtkomst. Det första fältet är packfilen som används, det andra är offseten i den filen:

GIT_TRACE_PACKET aktiverar paketnivåspårning för nätverksoperationer.

GIT_TRACE_PERFORMANCE styr loggning av prestandadata. Utdata visar hur lång tid varje enskild git‑körning tar.

GIT_TRACE_SETUP visar information om vad Git upptäcker om kodförrådet och miljön det interagerar med.

GIT_SSH, om den är angiven, är ett program som anropas i stället för ssh när Git försöker ansluta till en SSH‑värd. Det anropas som $GIT_SSH [username@]host [-p <port>] <command>. Observera att detta inte är det enklaste sättet att anpassa hur ssh anropas; det stödjer inte extra kommandoradsparametrar. För att stödja extra kommandoradsparametrar kan du använda GIT_SSH_COMMAND, skriva ett omslagsskript och sätta GIT_SSH att peka på det eller använda filen ~/.ssh/config.

GIT_SSH_COMMAND sätter SSH‑kommandot som används när Git försöker ansluta till en SSH‑värd. Kommandot tolkas av skalet, och extra kommandoradsargument kan användas med ssh, som GIT_SSH_COMMAND="ssh -i ~/.ssh/my_key" git clone git\@example.com:my/repo.

GIT_ASKPASS är en åsidosättning av konfigurationsvärdet core.askpass. Det är programmet som anropas när Git behöver be användaren om autentiseringsuppgifter, vilket kan förvänta sig en textfråga som kommandoradsargument och ska returnera svaret på stdout (se Lagring av inloggningsuppgifter för mer om detta delsystem).

GIT_NAMESPACE styr åtkomst till namnrymda refs och är likvärdigt med flaggan --namespace. Det är mest användbart på serversidan, där du kan vilja lagra flera namnrymder för ett enda kodförråd i samma kodförråd och hålla refs separerade.

GIT_FLUSH kan användas för att tvinga Git att använda icke‑buffrad I/O när det skriver inkrementellt till stdout. Ett värde på 1 gör att Git flushar oftare, ett värde på 0 gör att all utdata buffras. Standardvärdet (om variabeln inte är satt) är att välja en lämplig buffringsstrategi beroende på aktivitet och utdataläge.

GIT_REFLOG_ACTION låter dig ange den beskrivande text som skrivs till refloggen. Här är ett exempel: