Setup and Config
Getting and Creating Projects
Basic Snapshotting
Branching and Merging
Sharing and Updating Projects
Inspection and Comparison
Patching
Debugging
External Systems
Server Admin
Guides
- gitattributes
- Command-line interface conventions
- Everyday Git
- Frequently Asked Questions (FAQ)
- Glossary
- Hooks
- gitignore
- gitmodules
- Revisions
- Submodules
- Tutorial
- Workflows
- All guides...
Administration
Plumbing Commands
- 2.46.1 → 2.47.0 no changes
- 2.46.0 07/29/24
- 2.42.1 → 2.45.2 no changes
- 2.42.0 08/21/23
- 2.40.1 → 2.41.2 no changes
- 2.40.0 03/12/23
- 2.28.1 → 2.39.5 no changes
- 2.28.0 07/27/20
- 2.25.3 → 2.27.1 no changes
- 2.25.2 03/17/20
- 2.24.1 → 2.25.1 no changes
- 2.24.0 11/04/19
- 2.22.1 → 2.23.4 no changes
- 2.22.0 06/07/19
- 2.18.1 → 2.21.4 no changes
- 2.18.0 06/21/18
- 2.9.5 → 2.17.6 no changes
- 2.8.6 07/30/17
- 2.7.6 no changes
- 2.6.7 05/05/17
- 2.1.4 → 2.5.6 no changes
- 2.0.5 12/17/14
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 quegit 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 commecommitterdate
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 erreurmissing 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 commerefs/heads/foo
correspond), soit par un séparateur (ainsibar
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 .