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.51.1 → 2.52.0 no changes
-
2.51.0
2025-08-18
- 2.43.2 → 2.50.1 no changes
-
2.43.1
2024-02-09
-
2.43.0
2023-11-20
- 2.38.1 → 2.42.4 no changes
-
2.38.0
2022-10-02
- 2.29.1 → 2.37.7 no changes
-
2.29.0
2020-10-19
- 2.20.1 → 2.28.1 no changes
-
2.20.0
2018-12-09
- 2.19.1 → 2.19.6 no changes
-
2.19.0
2018-09-10
- 2.18.1 → 2.18.5 no changes
-
2.18.0
2018-06-21
- 2.4.12 → 2.17.6 no changes
-
2.3.10
2015-09-28
-
2.2.3
2015-09-04
- 2.1.4 no changes
-
2.0.5
2014-12-17
DESCRIPTION
Cette commande téléverse une boîte aux lettres générée avec git format-patch dans un dossier de brouillons IMAP. Cela permet d’envoyer les rustines comme d’autres courriels lorsque l’on utilise des clients de messagerie qui ne peuvent pas lire directement les fichiers de boîtes aux lettres. La commande fonctionne également avec n’importe quelle boîte aux lettres générale dans laquelle les courriels comportent les champs From, Date et Subject dans cet ordre.
L’utilisation typique est quelque chose comme :
git format-patch --signoff --stdout --attach origin | git imap-send
OPTIONS
- -v
- --verbose
-
Mode bavard.
- -q
- --quiet
-
Être silencieux.
- -f <répertoire>
- --folder=<répertoire>
-
Spécifier le dossier dans lequel les courriels doivent être sauvegardés. For example :
--folder=[Gmail]/Draftsor-fINBOX/Drafts. - --curl
-
Utiliser libcurl pour communiquer avec le serveur IMAP, à moins qu’il ne s’agisse d’un tunnel. Ignoré si Git a été compilé sans l’option USE_CURL_FOR_IMAP_SEND.
- --no-curl
-
Communiquer avec le serveur IMAP en utilisant les propres routines IMAP de Git au lieu d’utiliser libcurl. Ignoré si Git a été compilé avec l’option NO_OPENSSL.
- --list
-
Run the IMAP LIST command to output a list of all the folders present.
CONFIGURATION
Pour utiliser l’outil, imap.folder et imap.tunnel ou imap.host doivent être réglés sur les valeurs appropriées.
Tout ce qui se trouve au-dessus de cette ligne dans cette section n’est pas inclus dans la documentation git-config[1]. Le contenu qui suit est le même que celui qui s’y trouve :
|
Warning
|
Missing See original version for this content. |
OBTENIR LA LISTE DES DOSSIERS DISPONIBLES
Pour envoyer un courriel dans un dossier spécifique, vous devez connaître le nom correct du dossier prévu dans votre boîte aux lettres. Les noms comme "Junk", "Trash" etc. affichés par divers clients de messagerie n’ont pas besoin d’être les noms réels des dossiers stockés dans le serveur de courrier de votre fournisseur de messagerie.
Pour obtenir le bon nom de dossier à utiliser avec git imap-send, vous pouvez exécuter git imap-send --list. Ceci affichera une liste de noms de dossiers valides. Un exemple d’une telle sortie en cours sur un compte Gmail est :
* LIST (\HasNoChildren) "/" "INBOX" * LIST (\HasChildren \Noselect) "/" "[Gmail]" * LIST (\All \HasNoChildren) "/" "[Gmail]/All Mail" * LIST (\Drafts \HasNoChildren) "/" "[Gmail]/Drafts" * LIST (\HasNoChildren \Important) "/" "[Gmail]/Important" * LIST (\HasNoChildren \Sent) "/" "[Gmail]/Sent Mail" * LIST (\HasNoChildren \Junk) "/" "[Gmail]/Spam" * LIST (\Flagged \HasNoChildren) "/" "[Gmail]/Starred" * LIST (\HasNoChildren \Trash) "/" "[Gmail]/Trash"
Ici, vous pouvez observer que le nom correct pour le dossier "Junk" est [Gmail]/Spam et pour le dossier "Trash" c’est [Gmail]/Trash. Une logique similaire peut également être utilisée pour déterminer d’autres dossiers.
EXEMPLES
Utilisation du mode tunnel :
[imap]
folder = "INBOX.Drafts"
tunnel = "ssh -q -C utilisateur@exemple.com /usr/bin/imapd ./Maildir 2> /dev/null"
Utilisation du mode direct :
[imap]
folder = "INBOX.Drafts"
host = imap://imap.exemple.com
user = bob
pass = p4ssw0rd
Utilisation du mode direct avec SSL :
[imap]
folder = "INBOX.Drafts"
host = imaps://imap.exemple.com
user = bob
pass = p4ssw0rd
port = 123
; sslVerify = false
|
Note
|
Vous pouvez utiliser sslVerify=false pendant le dépannage, si vous pensez que la raison pour laquelle vous avez des difficultés à vous connecter est que le certificat que vous utilisez sur le serveur privé exemple.com que vous essayez de mettre en place (ou que vous avez mis en place) peut ne pas être vérifié correctement.
|
Utilisation de l’interface IMAP de Gmail :
[imap]
folder = "[Gmail]/Drafts"
host = imaps://imap.gmail.com
user = user@gmail.com
port = 993
Gmail does not allow using your regular password for git imap-send. If you have multi-factor authentication set up on your Gmail account, you can generate an app-specific password for use with git imap-send. Visit https://security.google.com/settings/security/apppasswords to create it. Alternatively, use OAuth2.0 authentication as described below.
|
Note
|
Il se peut que vous deviez utiliser à la place : folder = "[Google Mail]/Drafts" si vous obtenez une erreur indiquant que le "Dossier n’existe pas". Vous pouvez aussi exécuter git imap-send --list pour obtenir une liste des répertoires disponibles.
|
|
Note
|
Si votre compte Gmail est configuré dans une autre langue que l’anglais, le nom du dossier "Brouillons" sera localisé. |
If you want to use OAuth2.0 based authentication, you can specify OAUTHBEARER or XOAUTH2 mechanism in your config. It is more secure than using app-specific passwords, and also does not enforce the need of having multi-factor authentication. You will have to use an OAuth2.0 access token in place of your password when using this authentication.
[imap] folder = "[Gmail]/Drafts" host = imaps://imap.gmail.com user = user@gmail.com port = 993 authmethod = OAUTHBEARER
Utilisation de l’interface IMAP d’Outlook :
Contrairement à Gmail, Outlook ne gère que l’authentification basée sur OAuth2.0. En outre, il ne prend en charge que le mécanisme XOAUTH2 .
[imap]
folder = "Drafts"
host = imaps://outlook.office365.com
user = user@outlook.com
port = 993
authmethod = XOAUTH2
Une fois que les commandes sont prêtes à être envoyées, exécutez la commande suivante :
$ git format-patch --cover-letter -M --stdout origin/master | git imap-send
Veillez simplement à désactiver le retour à la ligne dans le client de messagerie (l’interface web de Gmail revient à la ligne quoi qu’il arrive, vous devez donc utiliser un vrai client IMAP).
Au cas où vous utilisez l’authentification OAuth2.0, il est plus facile d’utiliser des assistant d’identification pour générer des jetons. Les assistants d’identification proposés dans git-send-email[1] peuvent également être utilisées pour git imap-send.
ATTENTION
Il est toujours de votre responsabilité de vous assurer que le message électronique envoyé par votre programme de messagerie répond aux normes de votre projet. De nombreux projets n’aiment pas que des correctifs soient joints. Certains agents de messagerie transforment les rustines (par exemple, en faisant passer les lignes, en les envoyant sous format=flowed) d’une manière qui les fait échouer. Si vous ne vérifiez pas cela, vous recevrez des flammes furieuses qui vous ridiculiseront.
Thunderbird, en particulier, est connu pour ses problèmes. Les utilisateurs de Thunderbird peuvent consulter cette page web pour plus d’informations : https://kb.mozillazine.org/Plain_text_e-mail_-_Thunderbird#Completely_plain_email
VOIR AUSSI
git-format-patch[1], git-send-email[1], mbox(5)
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 .