10.8 Les tripes de Git - Les variables d’environnement

Certains aspects du comportement général de Git en tant que programme dépend de variables d’environnement.

GIT_EXEC_PATH détermine l’endroit où Git va chercher ses sous-programmes (comme git-commit, git-diff, et d’autres). Vous pouvez vérifier le réglage actuel en lançant git --exec-path.

HOME n’est pas en général considérée comme modifiable (trop d’autres choses en dépendent), mais c’est l’endroit où Git va chercher le fichier de configuration général (global). Si vous voulez une installation de Git vraiment portable, complète du point de vue de la configuration générale, vous pouvez surcharger HOME dans le profil (profile).

PREFIX est l’équivalent pour la configuration au niveau du système. Git va chercher le fichier $PREFIX/etc/gitconfig.

GIT_CONFIG_NOSYSTEM, si elle est définie, invalide l’utilisation du fichier de configuration au niveau du système. Cette variable est utile si la configuration système interfère avec vos commandes et que vous n’avez pas les privilèges pour la changer ou la supprimer.

GIT_PAGER contrôle le programme que vous utilisez pour afficher les résultats sur plusieurs pages à la ligne de commande. Si elle n’est pas définie, Git utilisera PAGER à la place.

GIT_EDITOR est l’éditeur lancé par Git quand l’utilisateur doit taper du texte (un message de commit par exemple). Si elle n’est pas définie, Git utilisera EDITOR.

Git utilise plusieurs variables d’environnement pour déterminer comment interagir avec le dépôt courant.

GIT_DIR est l’emplacement du répertoire .git. S’il n’est pas spécifié, Git remonte l’arbre des répertoires jusqu’à ce qu’il arrive à ~ ou bien /, en cherchant un répertoire .git à chaque étape.

GIT_CEILING_DIRECTORIES contrôle le comportement de Git pendant la recherche d’un répertoire .git. Si vous êtes sur des répertoires qui se chargent lentement (par exemple sur une bande magnétique ou à travers une connexion réseau lente), vous pouvez souhaiter que Git s’arrête plus tôt qu’il ne le ferait habituellemnt, surtout si Git est appelé à la construction de votre appel shell (prompt).

GIT_WORK_TREE est l’emplacement de la racine du répertoire de travail pour un dépôt non nu. Si cette variable n’est pas spécifiée, c’est le répertoire parent de $GIT_DIR qui est utilisé.

GIT_INDEX_FILE est le chemin du fichier d’index (uniquement pour les dépôts non nus).

GIT_OBJECT_DIRECTORY peut être utilisé pour spécifier l’emplacement du répertoire qui se trouve habituellement à .git/objects.

GIT_ALTERNATE_OBJECT_DIRECTORIES est une liste séparée par des « : » (formattée comme ceci : /rep/un:/rep/deux:…) qui dit à Git où trouver les objets s’ils ne sont pas dans GIT_OBJECT_DIRECTORY. S’il vous arrive d’avoir beaucoup de projets avec des gros fichiers ayant exactement le même contenu, cette variable peut vous éviter d’en garder trop de copies.

Une "pathspec" fait référence à la façon dont on spécifie les chemins dans Git, y compris l’utilisation des jokers. Ils sont utilisés dans le fichier .gitignore, mais également à la ligne de commande (git add \*.c).

GIT_GLOB_PATHSPECS et GIT_NOGLOB_PATHSPECS contrôlent le comportement par défaut des jokers dans les pathspecs. Si GIT_GLOB_PATHSPECS vaut 1, les caractères jokers agissent comme des jokers (ce qui est le comportement par défaut) ; si GIT_NOGLOB_PATHSPECS vaut 1, les caractères jokers ne correspondent qu’à eux-même, ce qui veut dire que quelque chose comme *.c ne correspondrait qu’à un fichier nommé « \*.c », et non pas tout fichier dont le nom se termine par .c. Vous pouvez surcharger ce comportement pour certains cas en faisant commencer la pathspec par :(glob) pour utiliser le joker, ou bien :(literal) pour une correspondance stricte, comme dans :(glob)\*.c.

GIT_LITERAL_PATHSPECS empêche ces deux comportements ; aucun joker ne fonctionnera, et les préfixes de surcharge seront également inopérants.

GIT_ICASE_PATHSPECS rend toutes les pathspecs insensibles à la casse.

La création finale d’un objet Git commit est habituellement faite par git-commit-tree, qui utilise les variables d’environnement suivantes comme première source d’information, se repliant sur les valeurs de configuration seulement si celles-ci ne sont pas présentes :

GIT_AUTHOR_NAME est le nom lisible par un humain dans le champ « Auteur » (author).

GIT_AUTHOR_EMAIL est l’adresse de courriel pour le champ « Auteur ».

GIT_AUTHOR_DATE est l’horodatage utilisé pourle champ « Auteur ».

GIT_COMMITTER_NAME définit le nom humain pour le champ « Validateur » (commiter).

GIT_COMMITTER_EMAIL est l’adresse de courriel pour le champ « Validateur ».

GIT_COMMITTER_DATE est utilisé pour l’horodatage dans le champ « Validateur ».

EMAIL est l’adresse de courriel de repli pour le cas où la valeur de configuration user.email n’est pas définie. Si celle-ci n’est pas définie, Git se replie sur les noms d’utilisateur système et d’hôte.

Git utilise la bibliothèque curl pour effectuer des opérations sur HTTP, ainsi GIT_CURL_VERBOSE demande à Git d’émettre tous les messages générés par cette bibliothèque. C’est similaire à curl -v en ligne de commande.

GIT_SSL_NO_VERIFY demande à Git de ne pas vérifier les certificats SSL. Cela peut être parfois nécessaire si vous utilisez des certificats auto-signés pour servir des dépôts Git sur HTTPS, ou si vous êtes au milieu de l’installation d’un serveur Git mais n’avez pas encore installé un certificat complet.

Si le taux de données d’une opération HTTP est plus basse que GIT_HTTP_LOW_SPEED_LIMIT octets par seconde pendant plus longtemps que GIT_HTTP_LOW_SPEED_TIME secondes, Git annulera cette opération. Ces valeurs surchargent les valeurs de configuration http.lowSpeedLimit et http.lowSpeedTime.

GIT_HTTP_USER_AGENT définit la chaîne d’agent utilisateur utilisée par Git quand il communique sur HTTP. La valeur par défaut est quelque chose comme git/2.0.0.

GIT_DIFF_OPTS est un terme un peu inapproprié. Les seules valeurs valides sont -u<n> ou --unified=<n>, qui contrôlent le nombre de lignes de contexte affichées dans une commande git diff.

GIT_EXTERNAL_DIFF est utilisée comme une surcharge de la valeur de configuration diff.external. Si elle est définie, Git invoquera ce programme quand git diff sera invoquée.

GIT_DIFF_PATH_COUNTER et GIT_DIFF_PATH_TOTAL sont utiles à l’intérieur du programme spécifié par GIT_EXTERNAL_DIFF ou diff.external. Le premier represente le fichier de la série dont on est en train de visualiser les différences (en commençant par 1), et le dernier est le nombre total de fichiers dans le lot.

GIT_MERGE_VERBOSITY contrôle la sortie pour la stratégie de fusion récursive. Les valeurs admises sont les suivantes :

La valeur par défaut est 2.

Vous voulez vraiment savoir de quoi Git est capable ? Git comprend un ensemble de traces assez complet, et tout ce que vous avez à faire est de les activer. Les valeurs possibles de ces variables sont les suivantes :

GIT_TRACE contrôle les traces générales, qui ne rentrent dans aucune catégorie spécifique. Cela inclut le développement des alias et la délégation aux autres sous-programmes.

GIT_TRACE_PACK_ACCESS contrôle le traçage d’accès aux fichiers groupés. Le premier champ est le fichier groupé auquel on est en train d’accéder, le second est le décalage dans ce fichier :

GIT_TRACE_PACKET permet le traçage au niveau paquet pour les opérations sur le réseau.

GIT_TRACE_PERFORMANCE contrôle la journalisation d’information de performance. La sortie montre combien de temps prend chaque invocation particulère de Git.

GIT_TRACE_SETUP montre des informations sur ce que Git découvre sur le dépôt et l’environnement avec lequel il interagit.

GIT_SSH, si spécifié, est un programme qui est invoqué à la place de ssh quand Git essaie de se connecter à un hôte SSH. Il est invoqué comme $GIT_SSH [username@]host [-p <port>] <command>. Notez que ce n’est pas le moyen le plus facile de personnaliser la façon dont ssh est invoqué ; il ne prendra pas en compte des paramètres supplémentaires en ligne de commande, donc vous devriez écrire un script l’enveloppant et faire pointer GIT_SSH dessus. Il est sans doute plus facile d’utiliser le fichier ~/.ssh/config pour cela.

GIT_ASKPASS est une surcharge pour la valeur de configuration core.askpass. C’est le programme invoqué lorsque Git à besoin de demander ses identifiants à l’utilisateur, qui peut s’attendre à un texte comme argument en ligne de commande, et qui devrait retourner la réponse sur la sortie standard (stdout). (Consultez Stockage des identifiants pour plus d’information sur ce sous-système.)

GIT_NAMESPACE contrôle l’accès des références cloisonnées dans des espaces de nom, et est équivalent à l’option --namespace. C’est surtout utile côté serveur, où vous pourriez vouloir stocker plusieurs bifurcations (forks) d’un seul dépôt dans un seul dépôt, en gardant seulement les références séparées.

GIT_FLUSH peut être utilisée pour forcer Git à utiliser des entrées/sorties non mises en mémoire tampon (buffer) quand il écrit progressivement dans la sortie standard. Une valeur de 1 fait que Git évacue (flush) plus souvent, une valeur de 0 fait que la sortie est mise en mémoire tampon. La valeur par défaut (si la variable n’est pas définie) est à choisir selon un plan approprié de mise en mémoire tampon en fonction de l’activité et du mode de sortie.

GIT_REFLOG_ACTION vous permet de spécifier le texte descriptif écrit dans le reflog. Voici un exemple :