8.8 Git на ниско ниво - Environment променливи

Някои от аспектите от работата на Git като компютърна програма зависят от environment променливите.

GIT_EXEC_PATH определя къде Git търси своите подпрограми (като git-commit, git-diff, и т.н.). Може да проверите текущата стойност с git --exec-path.

HOME нормално не се третира като настройваема променлива (защото твърде много други неща зависят от нейната стойност), от нея се определя къде Git търси глобалния си конфигурационен файл. Ако искате изцяло portable Git инсталация, завършена с глобални конфигурации, може да презапишете HOME в portable shell профила на Git.

PREFIX е подобна, но се използва за system-wide конфигурации. Git търси този файл в $PREFIX/etc/gitconfig.

GIT_CONFIG_NOSYSTEM, ако е зададена, забранява използването на system-wide конфигурационния файл. Това е полезно, ако системната конфигурация е в конфликт с командите ви, но нямате достъп до нея.

GIT_PAGER контролира програмата, която се използва за показване на дълъг изход в командния ред. Ако не е зададена, ще се използва стойността от PAGER.

GIT_EDITOR задава редактора, който Git ще стартира при нужда от редакция на текст (например за къмит съобщение). Ако не е зададена, използва се посоченото в EDITOR променливата.

Git използва няколко environment променливи за да определи как да оперира с текущото хранилище.

GIT_DIR е пътя за директорията .git. Ако не е указан, Git се качва по дървото с директориите докато стигне до ~ или / търсейки за .git на всяка стъпка.

GIT_CEILING_DIRECTORIES контролира маниера на търсене за .git директория. Ако посещавате директории, достъпа до които е бавен (например такива на лентово устройство или през бавна мрежова връзка), може да искате да инструктирате Git да спре да опитва по-рано отколкото би могъл.

GIT_WORK_TREE е root локацията на работната директория за non-bare хранилище. Ако са указани --git-dir или GIT_DIR, но нито едно от --work-tree, GIT_WORK_TREE и core.worktree, тогава за текуща работна директория се счита най-горното ниво на работното ви дърво.

GIT_INDEX_FILE е пътя до индексния файл (само за non-bare хранилища).

GIT_OBJECT_DIRECTORY може да се използва за задаване на мястото на директорията, която нормално е .git/objects.

GIT_ALTERNATE_OBJECT_DIRECTORIES е разделен с двуеточия списък (форматиран като /dir/one:/dir/two:…), който казва на Git къде да проверява за обекти, които не са в локацията от GIT_OBJECT_DIRECTORY. Ако се случи да имате много проекти с идентични големи файлове, това може да се използва като начин да избегнете съхранението на твърде много на брой техни копия.

Терминът “pathspec” се отнася до това как указвате пътища до неща в Git, включително използването на wildcards. Такива се използват в .gitignore файла, но също и в командния ред (git add \*.c).

GIT_GLOB_PATHSPECS и GIT_NOGLOB_PATHSPECS контролират поведението по подразбиране на wildcard символите в pathspecs. Ако GIT_GLOB_PATHSPECS е със стойност 1, wildcard символите работят като wildcards (така е по подразбиране); Ако GIT_NOGLOB_PATHSPECS е 1, тогава wildcard символите само съвпадат със самите тях, което значи, че *.c ще намери само файл с име “\*.c”, вместо всеки файл с окончание .c. Можете да променяте това в индивидуални случаи започвайки дадения pathspec с :(glob) или :(literal), както например :(glob)\*.c.

GIT_LITERAL_PATHSPECS забранява и двете горни поведения и никакви wildcard символи няма да работят, override префиксите също се забраняват.

GIT_ICASE_PATHSPECS указва всички pathspecs да работят в case-insensitive маниер.

Финалното създаване на Git къмит обект обикновено се прави с git-commit-tree, която използва тези environment променливи като основен източник на информация, използвайки конфигурационните стойности като резервен вариант, ако те не съществуват:

GIT_AUTHOR_NAME е human-readable име за полето “author”.

GIT_AUTHOR_EMAIL е имейл адреса за “author”.

GIT_AUTHOR_DATE е timestamp за “author” полето.

GIT_COMMITTER_NAME задава human име за полето “committer”.

GIT_COMMITTER_EMAIL е имейл адреса за “committer”.

GIT_COMMITTER_DATE е timestamp за “committer” полето.

EMAIL се използва като резервен имейл адрес, ако нямаме стойност за конфигурацията user.email. Ако и тази променлива не е зададена, Git използва системните user и host имена.

Git използва библиотеката curl за мрежови активности през HTTP. Променливата GIT_CURL_VERBOSE указва на Git да печата всички съобщения, генерирани от библиотеката. Това е подобно на curl -v в командния ред.

GIT_SSL_NO_VERIFY казва на Git да не проверява SSL сертификати. Това понякога е необходимо, ако използвате self-signed сертификати за да обслужвате Git хранилища през HTTPS или ако изграждате Git сървър, но все още не сте инсталирали валиден сертификат.

Ако скоростта на HTTP операция е по-ниска от указаните в GIT_HTTP_LOW_SPEED_LIMIT байта в секунда за повече от GIT_HTTP_LOW_SPEED_TIME секунди, Git ще откаже тази операция. Тези стойности са с приоритет пред http.lowSpeedLimit и http.lowSpeedTime конфигурационните настройки.

GIT_HTTP_USER_AGENT определя user-agent стринга, който Git използва при комуникация през HTTP. По подразбиране се използва нещо като git/2.0.0.

GIT_DIFF_OPTS е леко заблуждаващо наименование. Единствено валидните стойности са -u<n> или --unified=<n>, което определя броя на context редовете показвани от команда git diff.

GIT_EXTERNAL_DIFF се използва за приоритет пред конфигурационната стойност diff.external. Ако е зададена, Git ще стартира съответната програма при изпълнение на git diff.

GIT_DIFF_PATH_COUNTER и GIT_DIFF_PATH_TOTAL са полезни за използване в програмата указана от GIT_EXTERNAL_DIFF или diff.external. Първата указва върху кой файл от серия такива ще се изпълни diff (започвайки с 1), а втората задава общия брой файлове за всяка batch операция.

GIT_MERGE_VERBOSITY контролира изхода за recursive merge стратегия. Позволените стойности са:

По подразбиране стойността е 2.

Искате наистина да знаете с какво се занимава Git? Git има сравнително завършен набор от вградени traces и просто трябва да ги включите. Възможните стойност за тези променливи са както следва:

GIT_TRACE управлява общи traces, които не попадат в нито една специфична категория. Това включва разширяването на aliases, и делегиране към други подпрограми.

GIT_TRACE_PACK_ACCESS контролира трасирането на packfile достъп. Първото поле е съответния packfile, второто е отстъпа в него:

GIT_TRACE_PACKET позволява packet-level tracing за мрежови операции.

GIT_TRACE_PERFORMANCE контролира записа на данните за производителността. Изходът показва колко време е отнела всяка отделна git команда.

GIT_TRACE_SETUP показва информация за това какво знае Git за хранилището и обкръжението, с които комуникира.

GIT_SSH, ако е указана, е програмата, която ще се използва вместо ssh, когато Git опитва да комуникира с SSH хост. Тя се извиква така: $GIT_SSH [username@]host [-p <port>] <command>. Това не е най-лесният начин да се промени настройката за повикване на ssh и няма да поддържа допълнителни параметри за командния ред, така че може би ще е по-добре да си напишете малък wrapper script и да зададете него като стойност на GIT_SSH. Вероятно е по-лесно просто да се използва ~/.ssh/config файла.

GIT_ASKPASS се използва за приоритет пред конфигурационната настройка core.askpass. Това е програмата, която се пуска всеки път когато Git трябва да пита потребителя зa логин информация, тя трябва да върне отговора в stdout. (Вижте Credential Storage система за повече информация).

GIT_NAMESPACE контролира достъпа до namespaced refs и е еквивалентна на флага --namespace. Това е най-полезно от страна на сървъра, където може да искате да съхранявате множество forks на единични хранилище в едно хранилище, пазейки отделни само референциите.

GIT_FLUSH може да се използва за да накарате Git да използва non-buffered I/O, когато пише инкрементално към stdout. Стойност 1 ще накара Git да flush-ва по-често, а 0 означава, че целият изход се буферира. Правилото по подразбиране (ако променливата не е настроена) е да се избере подходящата буферираща схема според активността и output режима.

GIT_REFLOG_ACTION позволява да укажете описателния текст, който се записва в reflog. Например: