| Nom |
Description |
| --add |
Ce paramètre permet d'ajouter une nouvelle ligne à l'option sans modifier les valeurs existantes. Cela revient à fournir ^$ comme modèle de valeur (value-pattern) dans --replace-all. |
| --blob blob |
Ce paramètre est similaire à --file mais utilise le blob donné au lieu d'un fichier. Par exemple. vous pouvez utiliser master:.gitmodules pour lire les valeurs du fichier .gitmodules dans la branche master. |
| --bool |
Ce paramètre permet de canoniser les valeurs comme "true" ou "false". Ce paramètre permet d'indiquer des options historiques pour sélectionner un spécificateur de type. Il préférable d'utiliser le paramètre --type. |
| --bool-or-int |
Ce paramètre permet de canoniser selon bool ou int. Ce paramètre permet d'indiquer des options historiques pour sélectionner un spécificateur de type. Il préférable d'utiliser le paramètre --type. |
| --default value |
Ce paramètre permet d'indiquer la valeur par défaut. Lorsque vous utilisez --get et que la variable demandée est introuvable, agit comme si value était la valeur affectée à cette variable. |
| -e |
Ce paramètre permet d'ouvrir un éditeur pour modifier le fichier de configuration spécifié ; soit --system, --global ou le référentiel (par défaut). |
| --edit |
Ce paramètre permet d'ouvrir un éditeur pour modifier le fichier de configuration spécifié ; soit --system, --global ou le référentiel (par défaut). |
| --expiry-date |
Ce paramètre permet de canoniser en convertissant une chaîne de caractères de date fixe ou relative en un horodatage. Ce spécificateur n'a aucun effet lors de la définition de la valeur. Ce paramètre permet d'indiquer des options historiques pour sélectionner un spécificateur de type. Il préférable d'utiliser le paramètre --type. |
| -f config-file |
Ce paramètre permet d'indiquer le fichier de configuration. Pour les options d'écriture : écrivez dans le fichier spécifié plutôt que dans le référentiel .git/config. Pour les options de lecture : lecture uniquement à partir du fichier spécifié plutôt qu'à partir de tous les fichiers disponibles. |
| --file config-file |
Ce paramètre permet d'indiquer le fichier de configuration. Pour les options d'écriture : écrivez dans le fichier spécifié plutôt que dans le référentiel .git/config. Pour les options de lecture : lecture uniquement à partir du fichier spécifié plutôt qu'à partir de tous les fichiers disponibles. |
| --fixed-value |
Ce paramètre permet de traiter value-pattern comme une chaîne de caractères exacte au lieu d'une expression régulière lorsqu'il est utilisé avec le paramètre value-pattern. Cela limitera les paires nom/valeur correspondant uniquement à celles dont la valeur est exactement égale au modèle de valeur. |
| --get |
Ce paramètre permet de récupérer la valeur d'une clef donnée (éventuellement filtrée par une expression régulière correspondant à la valeur). Renvoie le code d'erreur 1 si la clef n'a pas été trouvée et la dernière valeur si plusieurs valeurs de clef ont été trouvées. |
| --get-all |
Ce paramètre permet de récupérer la valeur d'une clef donnée mais renvoie toutes les valeurs d'une clef multi-valued. |
| --get-color name [default] |
Ce paramètre permet de rechercher la couleur configurée pour le nom (par exemple, color.diff.new) et l'affiche en tant que séquence d'échappement de couleur ANSI sur la sortie standard. Le paramètre facultatif par défaut est utilisé à la place, si aucune couleur n'est configurée pour le nom. Le --type=color [--default=default] est préférable à --get-color (mais notez que --get-color omettra la nouvelle ligne de fin affichée par --type=color). |
| --get-colorbool name [stdout-is-tty] |
Ce paramètre permet de trouver le paramètre de couleur pour name (par exemple color.diff) et d'afficher "true" ou "false". stdout-is-tty doit être "true" ou "false", et est pris en compte lorsque la configuration indique "auto". Si stdout-is-tty est manquant, alors vérifie la sortie standard de la commande elle-même, et sort avec l'état 0 si la couleur doit être utilisée, ou sort avec l'état 1 sinon. Lorsque le paramètre de couleur pour le nom n'est pas défini, la commande utilise color.ui comme alternative. |
| --get-regexp |
Ce paramètre permet de récupérer la valeur d'une clef donnée mais renvoie toutes les valeurs d'une clef multi-valued., mais interprète le nom comme une expression régulière et écrit les noms des clefs. La correspondance des expressions régulières est actuellement sensible à la casse et effectuée par rapport à une version canonique de la clef dans laquelle les noms de section et de variable sont en minuscules, mais pas les noms de sous-section. |
| --get-urlmatch name URL |
Ce paramètre permet d'indiquer que lorsqu'on lui donne un nom en deux parties section.key, la valeur de section.<URL>.key dont la partie URL correspond le mieux à l'URL donnée est renvoyée (si aucune clef de ce type n'existe, la valeur de section.key est utilisée comme solution de repli). Lorsque vous ne donnez que la section comme nom, faites-le pour toutes les clefs de la section et listez-les. Renvoie le code d'erreur 1 si aucune valeur n'est trouvée. |
| --global |
Ce paramètre permet de faire une association globale. Pour les options d'écriture : écrivez dans le fichier global ~/.gitconfig plutôt que dans le référentiel .git/config, écrivez dans le fichier $XDG_CONFIG_HOME/git/config si ce fichier existe et que le fichier ~/.gitconfig n'existe pas. Pour les options de lecture : lire uniquement depuis global ~/.gitconfig et depuis $XDG_CONFIG_HOME/git/config plutôt que depuis tous les fichiers disponibles. |
| --int |
Ce paramètre permet de canoniser les valeurs sous forme de nombres décimaux simples. Un suffixe facultatif de k, m ou g entraînera la multiplication de la valeur par 1024, 1048576 ou 1073741824 lors de la saisie. Ce paramètre permet d'indiquer des options historiques pour sélectionner un spécificateur de type. Il préférable d'utiliser le paramètre --type. |
| -l |
Ce paramètre permet de lister toutes les variables définies dans le fichier de configuration, ainsi que leurs valeurs. |
| --list |
Ce paramètre permet de lister toutes les variables définies dans le fichier de configuration, ainsi que leurs valeurs. |
| --local |
Ce paramètre permet d'associer en local. Pour les options d'écriture : écrivez dans le fichier .git/config du référentiel. Ceci est le comportement par défaut. Pour les options de lecture : lire uniquement depuis le référentiel .git/config plutôt que depuis tous les fichiers disponibles. |
| --name-only |
Ce paramètre permet d'afficher uniquement les noms des variables de configuration pour --list ou --get-regexp. |
| --[no-]includes |
Ce paramètre permet de respecter les directives include.* dans les fichiers de configuration lors de la recherche de valeurs. Par défaut, désactivé lorsqu'un fichier spécifique est donné (par exemple, en utilisant --file, --global,...) et activé lors de la recherche de tous les fichiers de configuration. |
| --no-type |
Ce paramètre permet d'annuler la définition du spécificateur de type précédemment défini (s'il y en a un précédemment défini). Cette option demande à git config de ne pas canoniser la variable récupérée. --no-type n'a aucun effet sans --type=type ou --type. |
| --null |
Ce paramètre permet de terminer toujours les valeurs par le caractère nul (au lieu d'une nouvelle ligne) pour toutes les options générant des valeurs et/ou des clefs. Utilisez plutôt une nouvelle ligne comme délimiteur entre la clé et la valeur. Cela permet une analyse sécurisée de la sortie sans se confondre, par exemple par des valeurs contenant des sauts de ligne. |
| --path |
Ce paramètre permet de canoniser en ajoutant un ~ à la valeur de $HOME et ~user au répertoire personnel de l'utilisateur spécifié. Ce spécificateur n'a aucun effet lors de la définition de la valeur (mais vous pouvez utiliser git config section.variable ~/ depuis la ligne de commande pour laisser votre l'interpréteur de commande faire l'expansion.) Ce paramètre permet d'indiquer des options historiques pour sélectionner un spécificateur de type. Il préférable d'utiliser le paramètre --type. |
| --remove-section |
Ce paramètre permet de supprimer la section donnée du fichier de configuration. |
| --rename-section |
Ce paramètre permet de renommer la section donnée avec un nouveau nom. |
| --replace-all |
Ce paramètre permet d'indiquer que le comportement par défaut consiste à remplacer au plus une ligne. Cela remplace toutes les lignes correspondant à la clef (et éventuellement value-pattern). |
| --show-origin |
Ce paramètre permet d'augmenter la sortie de toutes les options de configuration interrogées avec le type d'origine (fichier, entrée standard, blob, ligne de commande) et l'origine réelle (chemin du fichier de configuration, référence ou identifiant de blob, le cas échéant). |
| --show-scope |
Ce paramètre permet d'augmenter la sortie de toutes les options de configuration interrogées avec la portée de cette valeur (worktree, local, global, système, command). |
| --system |
Ce paramètre permet d'associer au système. Pour écrire des options : écrivez dans le système $(prefix)/etc/gitconfig plutôt que dans le référentiel .git/config. Pour les options de lecture : lire uniquement à partir de $(prefix)/etc/gitconfig à l'échelle du système plutôt qu'à partir de tous les fichiers disponibles. |
| --type type |
Ce paramètre permet d'indiquer que toute entrée ou sortie est valide sous la ou les contraintes de type données et canonisera les valeurs sortantes sous la forme canonique de type. Les type valides incluent : |
| bool |
Ce type permet de canoniser les valeurs comme "true" ou "false". |
| int |
Ce type permet de canoniser les valeurs sous forme de nombres décimaux simples. Un suffixe facultatif de k, m ou g entraînera la multiplication de la valeur par 1024, 1048576 ou 1073741824 lors de la saisie. |
| bool-or-int |
Ce type permet de canoniser selon bool ou int, comme décrit ci-dessus. |
| path |
Ce type permet de canoniser en ajoutant un ~ à la valeur de $HOME et ~user au répertoire personnel de l'utilisateur spécifié. Ce spécificateur n'a aucun effet lors de la définition de la valeur (mais vous pouvez utiliser git config section.variable ~/ depuis la ligne de commande pour laisser votre interpréteur de commande faire l'expansion.) |
| expiry-date |
Ce type permet de canoniser en convertissant une chaîne de caractères de date fixe ou relative en un horodatage. Ce spécificateur n'a aucun effet lors de la définition de la valeur. |
| color |
Ce type permet d'indiquer la canoniser en la convertissant en une séquence d'échappement de couleur ANSI lors de l'obtention d'une valeur. Lors de la définition d'une valeur, une vérification d'intégrité est effectuée pour s'assurer que la valeur donnée peut être canonisée en tant que couleur ANSI, mais elle est écrite telle quelle. |
| --unset |
Ce paramètre permet de supprimer la ligne correspondant à la clef du fichier de configuration. |
| --unset-all |
Ce paramètre permet de supprimer toutes les lignes correspondant à la clef du fichier de configuration. |
| --worktree |
Ce paramètre Ce paramètre permet d'associer en local sauf que $GIT_DIR/config.worktree est lu ou écrit si extensions.worktreeConfig est activé. Sinon, c'est la même chose que --local. Notez que $GIT_DIR est égal à $GIT_COMMON_DIR pour l'arbre de travail principal, mais est de la forme $GIT_DIR/worktrees// pour les autres arbres de travail. |
| -z |
Ce paramètre permet de terminer toujours les valeurs par le caractère nul (au lieu d'une nouvelle ligne) pour toutes les options générant des valeurs et/ou des clefs. Utilisez plutôt une nouvelle ligne comme délimiteur entre la clé et la valeur. Cela permet une analyse sécurisée de la sortie sans se confondre, par exemple par des valeurs contenant des sauts de ligne. |
Cette commande permet de demander et de définir un référentiel ou des options globales.
L'exemple suivant permet d'autoriser de façon permanente tous les certificats invalide pour tous les autres commandes Git :