Le nom de l’objet à afficher. Pour une liste plus complète des façons d’épeler les noms d’objets, voir la section « SPÉCIFICATION DE RÉVISIONS" dans gitrevisions[7].

Au lieu du contenu, afficher le type d’objet identifié par <objet>.

Au lieu du contenu, afficher la taille de l’objet identifié par <objet>. Si utilisé avec l’option --use-mailmap, affichera la taille de l’objet mis à jour après le remplacement des identités en utilisant le mécanisme mailmap.

Sortir avec un statut nul si <objet> existe et est un objet valide. Si <objet> est d’un format invalide, sortir avec un état non-zéro et émettre une erreur sur stderr.

Formater l’affichage du contenu de <objet> en fonction de son type.

Typiquement, cela correspond au type réel de <objet> mais la demande d’un type qui peut trivialement être déréférencé à partir du <objet> donné est également autorisée. Un exemple est de demander un "tree" avec <objet> étant un objet commit qui le contient, ou de demander un "blob" avec <objet> étant un objet tag qui le pointe.

Utiliser le fichier mailmap pour correspondre les noms d’auteurs, de validateurs et d’étiqueteur, et les adresses email avec les vrais noms et adresses email canoniques. Voir git-shortlog[1].

Afficher le contenu tel que transformé par un filtre textconv. Dans ce cas, <objet> doit être de la forme <arbre-esque>:<chemin>, ou :<chemin> afin d’appliquer le filtre au contenu enregistré dans l’index à <chemin>.

Afficher le contenu tel qu’il a été converti par les filtres configurés dans l’arbre de travail actuel pour le <chemin> donné (c’est-à-dire les filtres de maculage, la conversion de fin de ligne, etc). Dans ce cas, <objet> doit être de la forme <arbre-esque>:<chemin>, ou :<chemin>.

Omettre des objets de la liste des objets affichés. Cela ne peut être utilisé qu’en combinaison avec l’un des modes par lot. Les objets exclus qui ont été explicitement demandés via l’un des modes de lot qui lisent des objets via l’entrée standard (--batch, --batch-check) seront déclarés comme "filtrés". Les objets exclus en mode --batch-all-objects ne seront pas affichés du tout. Le <spéc-de-filtre> peut être l’un des éléments suivants :

À utiliser avec --textconv ou --filters, pour permettre de spécifier un nom d’objet et un chemin séparément, par exemple lorsqu’il est difficile de déterminer la révision d’où provient le blob.

Afficher les informations et le contenu des objets pour chaque objet fourni sur stdin. Ne peut être combiné avec aucune autre option ou argument sauf --textconv, --filters ou --use-mailmap.

Afficher les informations sur les objets pour chaque objet fourni sur stdin. Ne peut être combiné avec aucune autre option ou argument sauf --textconv, --filters ou --use-mailmap.

Entrer dans un mode de commande qui lit les commandes et les arguments depuis stdin. Peut seulement être combiné avec --buffer, --textconv, --use-mailmap ou --filters.

Au lieu de lire une liste d’objets sur stdin, exécuter l’opération par lot demandée sur tous les objets du dépôt et de tous les magasins d’objets alternatifs (pas seulement les objets accessibles). Nécessite que --batch ou --batch-check soit spécifié. Par défaut, les objets sont visités dans l’ordre trié par leurs empreintes ; voir aussi --unordered ci-dessous. Les objets sont présentés tels quels, sans respecter le mécanisme "replace" de git-replace[1].

Normalement, la sortie par lot est vidée après la sortie de chaque objet, afin qu’un processus puisse lire et écrire de manière interactive depuis cat-file. Avec cette option, la sortie utilise la mise en tampon normale de stdio ; c’est beaucoup plus efficace quand on invoque --batch-check ou --batch-command sur un grand nombre d’objets.

Lorsque --batch-all-objects est utilisé, visiter les objets dans un ordre qui peut être plus efficace pour accéder au contenu des objets que l’ordre de hachage. Les détails exacts de l’ordre ne sont pas spécifiés, mais si vous n’avez pas besoin d’un ordre spécifique, ceci devrait généralement résulter en une sortie plus rapide, particulièrement avec --batch. Notez que cat-file ne montrera chaque objet qu’une seule fois, même s’il est stocké plusieurs fois dans le dépôt.

Avec --batch ou --batch-check, suivre les liens symboliques à l’intérieur du dépôt lors de la recherche des objets avec des expressions SHA-1 étendues de la forme arbre-esque:chemin-dans-l-arbre. Au lieu de fournir une sortie sur le lien lui-même, fournir une sortie sur l’objet lié. Si un lien symbolique pointe en dehors de l’arbre (par exemple un lien vers /foo ou un lien au niveau de la racine vers ../foo), la partie du lien qui est en dehors de l’arbre sera affichée.

f : un fichier contenant "hello\n".
link : un lien symbolique vers f
dir/link : un lien symbolique vers ../f
plink : un lien symbolique vers ../f
alink : un lien symbolique vers /etc/passwd

ce013625030ba8dba906f756967f9e9ca394464a blob 6

4d1ae35ba2c8ec712fa2a379db44ad639ca277bd blob 1

symlink 4
../f

symlink 11
/etc/passwd

Significatif uniquement avec --batch, --batch-check, ou --batch-command ; l’entrée et la sortie sont délimitées par NUL au lieu de sauts de ligne.

Significatif uniquement avec --batch, --batch-check, ou --batch-command ; l’entrée est délimitée par NUL au lieu de sauts de ligne. Cette option est obsolète au profit de -Z car la sortie peut autrement être compromise.

La représentation hexadécimale complète du nom de l’objet.

Le type de l’objet (le même que ce que cat-file -t renvoie).

Si l’objet spécifié a des informations de mode (comme un arbre ou une entrée d’index), le mode est affiché en tant qu’entier octal. Sinon, chaîne vide.

La taille, en octets, de l’objet (la même que celle que cat-file -s renvoie).

La taille, en octets, que l’objet occupe sur le disque. Voir la note sur les tailles sur disque dans la section MISES EN GARDES ci-dessous.

Si l’objet est stocké en tant que delta sur le disque, il se développe en représentation hexadécimale complète du nom de l’objet de base delta. Sinon, il se développe jusqu’à l’OID nul (tout à zéro). Voir MISES EN GARDE ci-dessous.

Si cet atome est utilisé dans la chaîne de sortie, les lignes d’entrée sont coupées à la première limite de caractères d’espace. Tous les caractères avant cet espace sont considérés comme le nom de l’objet ; les caractères après ce premier espace (c’est-à-dire le "reste" de la ligne) sont émis à la place de l’atome %(rest).