Git 🌙
Français ▾ Topics ▾ Latest version ▾ git-ls-remote last updated in 2.46.0

NOM

git-ls-remote - Liste les références dans un dépôt distant

SYNOPSIS

git ls-remote [--branches] [--tags] [--refs] [--upload-pack=<exec>]
                     [-q | --quiet] [--exit-code] [--get-url] [--sort=<clé>}
                     [--symref] [<dĂ©pĂ´t> [<motif>…​]]

DESCRIPTION

Affiche les références disponibles dans un dépôt distant ainsi que les identifiants de validation associés.

OPTIONS

-b
--branches
-t
--tags

Limiter aux branches locales et aux Ă©tiquette 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 et -h sont des synonymes obsolètes pour --branches et -b et pourront ĂŞtre supprimĂ©s dans l’avenir. Notez aussi que git ls-remote -h utilisĂ© sans rien d’autre sur la ligne de commande donne de l’aide, comme les autres sous-commandes de git.

--refs

Ne pas afficher les étiquettes pelées ou les pseudorefs comme HEAD dans la sortie.

-q
--quiet

Ne pas afficher l’URL distante sur stderr.

--upload-pack=<exec>

SpĂ©cifier le chemin complet de git-upload-pack sur l’hĂ´te distant. Cela permet de lister des rĂ©fĂ©rences provenant de dĂ©pĂ´ts accessibles via SSH et pour lesquels le dĂ©mon SSH n’utilise pas le PATH configurĂ© par l’utilisateur.

--exit-code

Sortir avec l’Ă©tat "2" lorsqu’aucune rĂ©fĂ©rence correspondante n’est trouvĂ©e dans le dĂ©pĂ´t distant. En gĂ©nĂ©ral, la commande sort avec le statut "0" pour indiquer qu’elle a rĂ©ussi Ă  dialoguer avec le dĂ©pĂ´t distant, qu’elle ait trouvĂ© ou non des rĂ©fĂ©rences correspondantes.

--get-url

DĂ©velopper l’URL du dĂ©pĂ´t distant donnĂ© en prenant en compte tout paramètre de configuration "url.<base>.insteadOf" (Voir git-config[1]) et quitte sans parler au dĂ©pĂ´t distant.

--symref

En plus de l’objet pointĂ© par lui, afficher la rĂ©f sous-jacente pointĂ©e par lui lors de l’affichage d’une rĂ©f symbolique. Actuellement, upload-pack n’affiche que la symref HEAD, qui sera donc la seule affichĂ©e par ls-remote.

--sort=<clé>

Trier sur la base de la clĂ© donnĂ©e. PrĂ©fixe - pour trier par ordre dĂ©croissant de la valeur. Supporte "version:refname" ou "v:refname" (les noms de balises sont traitĂ©s comme des versions). L’ordre de tri "version:refname" peut Ă©galement ĂŞtre affectĂ© par la variable de configuration "versionsort.suffix". Voir git-for-each-ref[1] pour plus d’options de tri, mais soyez conscient que des clĂ©s comme committerdate qui requièrent l’accès aux objets eux-mĂŞmes ne fonctionneront pas pour les refs dont les objets n’ont pas encore Ă©tĂ© rĂ©cupĂ©rĂ©s du distant, et donneront une erreur missing object (objet manquant).

-o <option>
--server-option=<option>

Transmettre la chaĂ®ne donnĂ©e au serveur lors d’une communication utilisant la version 2 du protocole. La chaĂ®ne donnĂ©e ne doit pas contenir de caractère NUL ou LF. Lorsque plusieurs --server-option=<option> sont donnĂ©s, ils sont tous envoyĂ©s Ă  l’autre cĂ´tĂ© dans l’ordre indiquĂ© sur la ligne de commande.

<dépôt>

Le dĂ©pĂ´t "distant" Ă  interroger. Ce paramètre peut ĂŞtre une URL ou le nom d’un dĂ©pĂ´t distant (voir les sections GIT URLS et REMOTES de git-fetch[1]).

<motif>…​

Si elle n’est pas spĂ©cifiĂ©e, toutes les rĂ©fĂ©rences, après le filtrage effectuĂ© avec --heads et --tags, sont affichĂ©es. Lorsque <motif>…​ est spĂ©cifiĂ©, seules les rĂ©fĂ©rences correspondant Ă  un ou plusieurs des motifs donnĂ©s sont affichĂ©es. Chaque motif est interprĂ©tĂ© comme un glob (voir glob dans gitglossary[7]) qui est comparĂ© Ă  la "queue" d’une rĂ©fĂ©rence, en commençant soit par le dĂ©but de la rĂ©fĂ©rence (ainsi un nom complet comme refs/heads/foo correspond), soit par un sĂ©parateur (ainsi bar correspond Ă  refs/heads/bar mais pas Ă  refs/heads/foobar).

SORTIE

La sortie est dans le format :

<oid> TAB <réf> LF

Lors de l’affichage d’une Ă©tiquette annotĂ©e, Ă  moins qu’il n’y ait`--refs` , deux lignes de ce type sont affichĂ©es : l’une avec le nom de rĂ©fĂ©rence pour l’Ă©tiquette elle-mĂŞme comme <rĂ©f>, et l’autre avec <rĂ©f>' suivi de `^{}. Le <oid> sur la dernière ligne montre le nom de l’objet que l’Ă©tiquette pointe.

EXEMPLES

  • Lister toutes les rĂ©fĂ©rences (y compris les symboles et les pseudo-rĂ©fs), en pelant les Ă©tiquettes :

    $ git ls-remote
    27d43aaaf50ef0ae014b88bba294f93658016a2e	HEAD
    950264636c68591989456e3ba0a5442f93152c1a	refs/heads/main
    d9ab777d41f92a8c1684c91cfb02053d7dd1046b	refs/heads/next
    d4ca2e3147b409459955613c152220f4db848ee1	refs/tags/v2.40.0
    73876f4861cd3d187a4682290ab75c9dccadbc56	refs/tags/v2.40.0^{}
  • Lister toutes les rĂ©fĂ©rences correspondant aux motifs donnĂ©s :

    $ git ls-remote http://www.kernel.org/pub/scm/git/git.git master seen rc
    5fe978a5381f1fbad26a80e682ddd2a401966740	refs/heads/master
    c781a84b5204fb294c9ccc79f8b3baceeb32c061	refs/heads/seen
  • Lister seulement les Ă©tiquettes correspondant Ă  un motif Ă  joker donné :

    $ git ls-remote --tags http://www.kernel.org/pub/scm/git/git.git v\*
    485a869c64a68cc5795dd99689797c5900f4716d	refs/tags/v2.39.2
    cbf04937d5b9fcf0a76c28f69e6294e9e3ecd7e6	refs/tags/v2.39.2^{}
    d4ca2e3147b409459955613c152220f4db848ee1	refs/tags/v2.40.0
    73876f4861cd3d187a4682290ab75c9dccadbc56	refs/tags/v2.40.0^{}

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 .

scroll-to-top