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 .