|
git remote [-v | --verbose]
|
|
git remote add [-t branch] [-m master] [-f] [--[no-]tags] [--mirror=(fetch|push)] name url
|
|
git remote rename old new
|
|
git remote remove name
|
|
git remote set-head name (-a | --auto | -d | --delete | branch)
|
|
git remote set-branches [--add] name branch...
|
|
git remote get-url [--push] [--all] name
|
|
git remote set-url [--push] name newurl [oldurl]
|
|
git remote set-url --add [--push] name newurl
|
|
git remote set-url --delete [--push] name url
|
|
git remote [-v | --verbose] show [-n] name...
|
|
git remote prune [-n | --dry-run] name...
|
|
git remote [-v | --verbose] update [-p | --prune] [(group | remote)...]
|
| Nom |
Description |
| add |
Ce paramètre permet d'ajouter le nommée name à distance pour le dépôt au url. La commande «git fetch name» peut ensuite être utilisée pour créer et mettre à jour les branches de suivi à distance name/branch.
Avec le paramètre -f, «git fetch name» est exécuté immédiatement après la configuration des informations à distance.
Avec le paramètre --tags, «git fetch name» importe toutes les balises du dépôt à distance.
Avec le paramètre --no-tags, «git fetch name» n'importe pas les balises du dépôt à distance.
Par défaut, seules les balises sur les branches récupérées sont importées (voir git-fetch).
Avec le paramètre «-t branch», au lieu de la référence globale par défaut pour que l'appel à distance puisse suivre toutes les branches sous les «refs/remotes/name/namespace», une refspec pour
suivre uniquement branch est créée. Vous pouvez donner plus d'un «-t branch» pour suivre plusieurs branches sans saisir toutes les branches.
Avec le paramètre «-m master», une référence symbolique «refs/remotes/name/HEAD» est configurée pour pointer vers la branche master à distance.
Lorsqu'un miroir de récupération est créé avec --mirror=fetch, les refs ne seront pas entreposés dans l'espaces de noms refs/remotes/, mais plutôt tout ce qui se trouve dans refs/ à distance sera directement reflété dans refs/ dans le dépôt local. Ce paramètre n'a de sens que dans les dépôts vides, car une extraction écraserait tous les commits locaux.
Lorsqu'un miroir push est créé avec --mirror=push, alors git push se comportera toujours comme si --mirror était passé. |
| get-url |
Ce paramètre permet de demander les URL à distance. Les configurations pour insteadOf et pushInsteadOf sont développées ici. Par défaut, seule la première URL est répertoriée.
Avec --push, les URL de push sont interrogées plutôt que les URL de récupération. Avec --all, toutes les URL à disatnce seront répertoriées. |
| prune |
Ce paramètre permet de supprimer les références obsolètes associées à name. Par défaut, les branches obsolètes de suivi à distance sous name sont supprimées, mais en fonction de la configuration globale
et de la configuration à distance, nous pouvons même élaguer les balises locales n'y ayant pas été transmises. Équivaut à «git fetch --prune name», sauf qu'aucune nouvelle référence ne sera récupérée.
Avec le paramètre --dry-run, indiquez quelles branches seront élaguées, mais ne les élaguez pas réellement. |
| rename |
Ce paramètre permet de renommer à distance old en new. Toutes les branches de suivi à distance et les paramètres de configuration à distance sont mis à jour. Dans le cas où old et new sont identiques, et old est un fichier sous $GIT_DIR/remotes ou $GIT_DIR/branches, celle à distance est convertie au format de fichier de configuration. |
| remove |
Ce paramètre permet de supprimer à distance le nommée name. Toutes les branches de suivi à distance et les paramètres de configuration à distance sont supprimés. |
| rm |
Ce paramètre permet de supprimer à distance le nommée name. Toutes les branches de suivi à distance et les paramètres de configuration à distance sont supprimés. |
| set-head |
Ce paramètre permet de définir ou de supprimer la branche par défaut (c'est-à-dire la cible de la référence symbolique «refs/remotes/name/HEAD») à distance nommée. Il n'est pas nécessaire d'avoir une
branche par défaut à distance, mais permet de spécifier le nom à distance à la place d'une branche spécifique. Par exemple, si la branche par défaut de l'origine est définie sur master, l'origin peut être spécifiée
là où vous spécifiez normalement origin/master.
Avec les paramètres -d ou --delete, la référence symbolique «refs/remotes/name/HEAD» est supprimée.
Avec le paramètre -a ou --auto, l'élément à distance est interrogée pour déterminer sa HEAD, puis la référence symbolique «refs/remotes/name/HEAD» est définie sur la même branche.
Par exemple, si le HEAD à distance est pointé vers next, git remote set-head origin -a définira les refs/remotes/origin/HEAD sur refs/remotes/origin/next. Cela ne fonctionnera
que si refs/remotes/origin/next existe déjà; sinon, il doit être récupéré en premier.
Utilisez branch pour définir explicitement les références symboliques «refs/remotes/name/HEAD». Par exemple, git remote set-head origin master définira les références de symboles
refs/remotes/origin/HEAD sur refs/remotes/origin/master. Cela ne fonctionnera que si refs/remotes/origin/master existe déjà; sinon, il doit être récupéré en premier. |
| set-branches |
Ce paramètre permet de modifier la liste des branches suivies à distance nommée. Cela peut être utilisé pour suivre un sous-ensemble des branches à distances disponibles après la configuration initiale à distance.
Les branches nommées seront interprétées comme si elles étaient spécifiées avec le paramètre -t sur la ligne de commande git remote add.
Avec --add, au lieu de remplacer la liste des branches actuellement suivies, elle l'ajoute à cette liste. |
| set-url |
Ce paramètre permet de modifier les URL à distance. Il définit la première URL du name à distance correspondant à l'expression régulière oldurl (première URL si aucune oldurl
n'est donnée) sur newurl. Si oldurl ne correspond à aucune URL, une erreur se produit et rien n'est changé.
Avec --push, les URL de push sont manipulées au lieu des URL de récupération.
Avec --add, au lieu de modifier les URL existantes, une nouvelle URL est ajoutée.
Avec --delete, au lieu de changer les URL existantes, toutes les URL correspondant à l'expression régulière url sont supprimées pour name à distance. Essayer de supprimer toutes les
URL non push est une erreur.
Notez que l'URL de push et l'URL de récupération, même si elles peuvent être définies différemment, doivent toujours faire référence au même endroit. Ce que vous avez poussé vers l'URL de
push doit être ce que vous verriez si vous récupériez immédiatement l'URL de récupération. Si vous essayez de récupérer depuis un endroit (par exemple votre amont) et de pousser vers un autre (par exemple
votre dépôt de publication), utilisez-en deux à distance distinctes. |
| show |
Ce paramètre permet de donner des informations sur le name à distance. Avec le paramètre -n, les têtes à distances ne sont pas interrogées en premier avec «git ls-remote name»;
les informations mises en cache sont utilisées à la place. |
| update |
Ce paramètre permet de récupérer les mises à jour à distance ou les groupes à distances dans le dépôt comme défini à «remotes.group». Si ni group ni remote ne sont spécifiés sur la ligne de commande,
le paramètre de configuration remotes.default sera utilisé; si remotes.default n'est pas défini, tous ceux à distance n'ayant pas le paramètre de configuration «remote.name.skipDefaultUpdate»
défini sur true seront mises à jour. Voir git-config. Avec le paramètre --prune, exécutez l'élagage sur ceux à distance mises à jour. |
Cette commande permet de gérer un ensemble de référentiels de suivis.