Français ▾ Topics ▾ Latest version ▾ git-show-ref last updated in 2.46.0

NOM

git-show-ref - Lister les références dans un dépôt local

SYNOPSIS

git show-ref [--head] [-d | --dereference]
	     [-s | --hash[=<n>]] [--abbrev[=<n>]] [--branches] [--tags]
	     [--] [<motif>…​]
git show-ref --verify [-q | --quiet] [-d | --dereference]
	     [-s | --hash[=<n>]] [--abbrev[=<n>]]
	     [--] [<réf>…​]
git show-ref --exclude-existing[=<motif>]
git show-ref --exists <réf>

DESCRIPTION

Affiche les références disponibles dans un dépôt local ainsi que les identifiants de commit associés. Les résultats peuvent être filtrés à l’aide d’un motif et les étiquettes peuvent être déréférencées en identifiants d’objet. De plus, elle peut être utilisée pour tester si une référence particulière existe.

Par défaut, affiche les étiquettes, les têtes et les références distantes.

La forme --exclude-existing est un filtre qui fait l’inverse. Elle lit les références depuis stdin, une référence par ligne, et affiche celles qui n’existent pas dans le dépôt local.

La forme --exists peut être utilisée pour vérifier l’existence d’une seule référence. Cette forme ne vérifie pas si la référence pointe vers un objet réel.

L’utilisation de cet utilitaire est encouragée au lieu d’accéder directement aux fichiers dans le répertoire .git.

OPTIONS

--head

Afficher la référence HEAD, même si elle serait normalement filtrée.

--branches
--tags

Limiter aux branches locales et aux étiquettes locales, respectivement. Ces options ne s’excluent pas mutuellement ; si les deux sont données, les références stockées dans refs/heads et refs/tags sont affichées. Notez que --heads est un synonyme obsolète pour --branches et pourra être supprimé à l’avenir.

-d
--dereference

Déréférencer également les étiquettes en identifiants d’objet. Elles seront affichées avec ^{} en suffixe.

-s
--hash[=<n>]

N’afficher que l’OID, pas le nom de la référence. Quand il est combiné avec --dereference, l’étiquette déréférencée sera toujours affichée après l’OID.

--verify

Activer une vérification plus stricte des références en exigeant un chemin de référence exact. En plus de renvoyer un code d’erreur 1, un message d’erreur sera également affiché si --quiet n’a pas été spécifié.

--exists

Vérifier si la référence donnée existe. Renvoie un code de sortie 0 si c’est le cas, 2 si elle est manquante, et 1 si la recherche de la référence a échoué avec une erreur autre que l’absence de la référence.

--abbrev[=<n>]

Abréger le nom de l’objet. Lors de l’utilisation de --hash, vous n’avez pas à dire --hash --abbrev ; --hash=n suffit.

-q
--quiet

Ne pas afficher de résultats sur stdout. Peut être utilisé avec --verify pour vérifier silencieusement si une référence existe.

--exclude-existing[=<motif>]

Faire agir git show-ref comme un filtre qui lit les références depuis stdin sous la forme ^(?:<quelque-chose>\s)?<nom-de-réf>(?:\^{})?$ et effectue les actions suivantes sur chacune : (1) supprimer ^{} en fin de ligne le cas échéant ; (2) ignorer si un motif est fourni et ne correspond pas en tête au nom de référence ; (3) avertir si le nom de référence n’est pas bien formé et sauter ; (4) ignorer si le nom de référence est une référence qui existe dans le dépôt local ; (5) sinon afficher la ligne.

<motif>…​

Afficher les références correspondant à un ou plusieurs motifs. Les motifs sont mis en correspondance depuis la fin du nom complet, et seules les parties complètes sont mises en correspondance, par exemple master correspond à refs/heads/master, refs/remotes/origin/master, refs/tags/jedi/master mais pas à refs/heads/mymaster ou refs/remotes/master/jedi.

SORTIE

La sortie est dans le format :

<oid> SP <réf> LF

Par exemple,

$ git show-ref --head --dereference
832e76a9899f560a90ffd62ae2ce83bbeff58f54 HEAD
832e76a9899f560a90ffd62ae2ce83bbeff58f54 refs/heads/master
832e76a9899f560a90ffd62ae2ce83bbeff58f54 refs/heads/origin
3521017556c5de4159da4615a39fa4d5d2c279b5 refs/tags/v0.99.9c
6ddc0964034342519a87fe013781abf31c6db6ad refs/tags/v0.99.9c^{}
055e4ae3ae6eb344cbabf2a5256a49ea66040131 refs/tags/v1.0rc4
423325a2d24638ddcc82ce47be5e40be550f4507 refs/tags/v1.0rc4^{}
...

Lors de l’utilisation de --hash (et non --dereference), la sortie est au format :

<oid> LF

Par exemple,

$ git show-ref --branches --hash
2e3ba0114a1f52b47df29743d6915d056be13278
185008ae97960c8d551adcd9e23565194651b5d1
03adf42c988195b50e1a1935ba5fcbc39b2b029b
...

EXEMPLES

Pour afficher toutes les références appelées « master », qu’il s’agisse d’étiquettes, de têtes ou d’autre chose, et indépendamment de la profondeur dans la hiérarchie de nommage des références, utiliser :

	git show-ref master

Cela affichera « refs/heads/master » mais aussi « refs/remote/other-repo/master », si de telles références existent.

Lors de l’utilisation de l’option --verify, la commande exige un chemin exact :

	git show-ref --verify refs/heads/master

ne correspondra qu’à la branche exacte appelée « master ».

Si rien ne correspond, git show-ref retournera un code d’erreur 1, et dans le cas d’une vérification, il affichera un message d’erreur.

Pour les scripts, vous pouvez lui demander d’être silencieux avec l’option --quiet, ce qui vous permet de faire des choses comme

	git show-ref --quiet --verify -- "refs/heads/$headname" ||
		echo "$headname n'est pas une branche valide"

pour vérifier si une branche particulière existe ou non (remarquez comment on ne veut pas réellement afficher de résultats, et on veut utiliser le nom de référence complet pour éviter le problème des correspondances partielles ambiguës).

Pour afficher uniquement les étiquettes ou uniquement les têtes de branches proprement dites, utiliser respectivement --tags et/ou --branches (utiliser les deux signifie qu’on affiche les étiquettes et les branches, mais pas les autres références sous le sous-répertoire refs/).

Pour déréférencer automatiquement les objets étiquette, utiliser l’option -d ou --dereference, afin de pouvoir faire

	git show-ref --tags --dereference

pour obtenir une liste de toutes les étiquettes avec ce à quoi elles se déréférencent.

FICHIERS

.git/refs/*, .git/packed-refs

VOIR AUSSI

git-for-each-ref[1], git-ls-remote[1], git-update-ref[1], gitrepository-layout[5]

GIT

Fait partie de la suite git[1]

TRADUCTION

Cette page de manuel a été traduite par Jean-Noël Avila <jn.avila AT free DOT fr> et les membres du projet git-manpages-l10n. Veuillez signaler toute erreur de traduction par un rapport de bogue sur le site https://github.com/jnavila/git-manpages-l10n .