Réviser et modifier chaque rustine que vous allez envoyer. La valeur par défaut est celle de `sendemail.annotate ' . Voir la section CONFIGURATION pour `sendemail.multiEdit ' .

Précise une valeur Bcc: pour chaque email. Par défaut, c’est la valeur de sendemail.bcc.

Précise une valeur Cc: de départ pour chaque email. Par défaut, c’est la valeur de sendemail.cc.

Invoquer une éditeur de texte (voir GIT_EDITOR dans git-var[1]) pour éditer un message d’introduction à la série de rustines.

Spécifier l’expéditeur des emails. Si elle n’est pas spécifiée sur la ligne de commande, la valeur de l’option de configuration sendemail.from ' est utilisée. Si ni l'option de ligne de commande ni `sendemail.from ne sont définies, l’utilisateur sera invité à saisir la valeur. La valeur par défaut de l’invite sera la valeur de GIT_AUTHOR_IDENT, ou GIT_COMMITTER_IDENT si celle-ci n’est pas définie, telle que retournée par git var -l.

Préciser l’adresse où les réponses des destinataires doivent aller. Utiliser ceci si les réponses aux messages doivent aller à une autre adresse que ce qui est spécifié avec le paramètre --from.

Faire en sorte que le premier message (ou tous les messages si --no-thread est spécifié) apparaisse comme une réponse au id message donné, ce qui évite de casser les fils de discussion lors d’une nouvelle série de patchs. Le second courriel et les suivants seront envoyés en tant que réponses selon le paramètre --[no-]chain-reply-to.

[PATCH 0/2] Voici ce que j'ai fait..
  [PATCH 1/2] Nettoyage et essais
  [PATCH 2/2] Implémentation
  [PATCH v2 0/3] Voici une deuxième relance
    [PATCH v2 1/3] Nettoyage
    [PATCH v2 2/3] Nouveaux tests
    [PATCH v2 3/3] Implémentation

Les serveurs SMTP Microsoft Outlook rejettent le Message-ID envoyé par courriel et attribuent un nouveau Message-ID aléatoire, brisant ainsi les fils.

Spécifier le sujet initial du fil de courriel. Seulement nécessaire si --compose est également défini. Si --compose n’est pas réglé, cela sera demandé.

Précise le destinataire principal des emails générés. En général, ce sera le mainteneur upstream du projet. Par défaut, c’est la valeur de configuration sendemail.to ; si elle n’est pas précisée, et que --to-cmd n’est pas spécifié, elle sera demandée.

Lorsqu’un message ou un sujet non ASCII ne déclare son encodage, ajouter des en-têtes/signaler pour indiquer qu’il est encodé en <encodage>. Le défaut est la valeur du sendemail.assume8bitEncoding ; si cela n’est pas précisé, cela sera demandé si des fichiers non ASCII sont rencontrés.

Spécifier l’encodage du message. La valeur par défaut est celle de sendemail.composeEncoding ; si cela n’est pas précisé, UTF-8 est supposé.

Préciser l’encodage de transfert à utiliser pour envoyer le message sur SMTP. 7bit échouera sur un message non-ASCII. quoted-printable peut être utile lorsque le dépôt contient des fichiers contenant des retours chariot, mais rend le fichier brut d’email de rustine (comme sauvegardé depuis un MUA) beaucoup plus difficile à inspecter manuellement. base64 est encore plus infaillible, mais aussi plus opaque. auto utilisera 8bit si possible et quoted-printable autrement.

Ajouter (ou empêcher d’ajouter) l’en-tête X-Mailer:. Par défaut, l’en-tête est ajouté, mais il peut être désactivé en définissant la variable de configuration sendemail.xmailer ` à `false.

Spécifier l’expéditeur d’enveloppe utilisé pour envoyer les emails. Ceci est utile si votre adresse par défaut n’est pas l’adresse qui est souscrite à une liste. Afin d’utiliser l’adresse De, définir la valeur auto. Si vous utilisez le binaire sendmail, vous devez avoir des privilèges appropriés pour le paramètre -f. Par défaut, c’est la valeur de la variable de configuration sendemail.envelopeSender ; si elle n’est pas spécifiée, le choix de l’enveloppe est laissé à votre MTA.

Spécifier une commande à exécuter pour envoyer le courriel. La commande doit être similaire à sendmail ; plus précisément, elle doit gérer l’option -i. La commande sera exécutée dans le shell si nécessaire. Le défaut est la valeur de sendemail.sendmailCmd. Si elle n’est pas précisée, et si --smtp-server n’est pas précisé, git send-email cherchera sendmail dans /usr/sbin, /usr/lib et $PATH.

Spécifie comment le chiffrement commence pour la connexion SMTP. Les valeurs valides sont ssl et tls. Toute autre valeur revient à simple SMTP (non crypté), qui correspond par défaut au port 25. Malgré les noms, les deux valeurs utiliseront la même nouvelle version de TLS, mais pour des raisons historiques elles ont ces noms. ssl se réfère au chiffrement "implicite" (parfois appelé SMTPS), qui utilise le port 465 par défaut. tls se réfère au chiffrement "explicite" (souvent appelé STARTTLS), qui utilise le port 25 par défaut. D’autres ports peuvent être utilisés par le serveur SMTP, qui ne sont pas ceux par défaut. Un port alternatif commun pour les protocoles tls et non chiffré est 587. Vérifiez la documentation de votre fournisseur ou la configuration de votre serveur pour vous assurer de votre propre cas. La valeur par défaut est la valeur de `sendemail.smtpEncryption ` .

Spécifier le nom de domaine complet (FQDN) utilisé dans la commande HELO/EHLO au serveur SMTP. Certains serveurs exigent que le FQDN corresponde à votre adresse IP. Si ce n’est pas le cas, git send-email tente de déterminer votre FQDN automatiquement. La valeur par défaut est celle de `sendemail.smtpDomain ' .

Liste séparée par espaces des mécanismes SMTP-AUTH autorisés. Ce réglage n’utilise que les mécanismes énumérés. Exemple :

$ git send-email --smtp-auth="PLAIN LOGIN GSSAPI" ...

Mot-de-passe pour SMTP-AUTH. L’argument est optionnel : si aucun argument n’est précisé, alors la chaîne de caractères vide est utilisée comme mot-de-passe. Par défaut, utilise la valeur de sendemail.smtpPass, cependant --smtp-pass a priorité et écrase toujours cette valeur.

Désactive l’authentification SMTP. Raccourcis pour --smtp-auth=none.

Spécifier le serveur SMTP sortant à utiliser (par exemple smtp.example.com ou une adresse IP brute). Si elle n’est pas précisée et que --sendmail-cmd n’est pas précisée, la valeur par défaut est de rechercher sendmail dans /usr/sbin, /usr/lib et $PATH si un tel programme est disponible, en revenant à localhost autrement.

Spécifier un port différent du port par défaut (les serveurs SMTP écoutent généralement sur le port smtp 25, mais peuvent également écouter sur le port 587, ou le port smtp SSL habituel 465) ; les noms de port symbolique (par exemple submission au lieu de 587) sont également acceptés. Le port peut également être indiqué avec la variable de configuration `sendemail.smtpServerPort.

Spécifier l’option de serveur SMTP sortante à utiliser. La valeur par défaut peut être spécifiée par l ' option de configuration `sendemail.smtpServerOption ' .

Alias historique pour --smtp-encryption ssl.

Chemin vers un magasin de certificats de confiance de CA pour la validation de certificat SMTP SSL/TLS (soit un répertoire qui a été traité par c_rehash, ou un seul fichier contenant un ou plusieurs certificats de format PEM concaténés : voir la description de options -CAfile <fichier> et -CApath <chemin> de https://docs.openssl.org/master/man1/openssl-verify/ [La page de manuel de verify(1) d’OpenSSL] pour plus d’information sur ceux-ci). Réglez-le à une chaîne vide pour désactiver la vérification des certificats. Vaut par défaut la valeur de la variable de configuration sendemail.smtpSSLCertPath, si elle est définie ou le chemin compilé par défaut de la bibliothèque de gestion SSL (ce qui devrait être le meilleur choix sur la plupart des plateformes).

Nom d’utilisateur pour SMTP-AUTH. Par défaut, c’est la valeur de sendemail.smtpUser. Si un nom d’utilisateur n’est pas spécifié (avec --smtp-user ou sendemail.smtpUser), alors l’authentification n’est pas tentée.

Active (1) or désactive (0) les messages de débugage. S’ils sont activés, les commandes SMTP et réponses seront affichées. Utile pour débuguer les problèmes de connexion TLS et d’authentification.

Certains fournisseurs de courriel (par exemple iCloud) n’envoient pas une copie des courriels envoyés en utilisant SMTP dans le dossier Sent ou similaire dans votre boîte aux lettres. Utilisez cette option pour utiliser git imap-send pour envoyer une copie des courriels dans le dossier spécifié en utilisant cette option. Vous pouvez exécuter git imap-send --list pour obtenir une liste de noms de dossiers valides, y compris le nom correct du dossier Sent dans votre boîte aux lettres. Vous pouvez également utiliser cette option pour envoyer des courriels dans un dossier IMAP dédié de votre choix.

Si défini, tous les courriels seront copiés uniquement dans le dossier IMAP spécifié avec --imap-sent-folder ou sendemail.imapSentFolder et ne seront pas envoyés aux destinataires. Utile si vous voulez simplement créer une ébauche des courriels et utiliser un autre client courriel pour les envoyer. Si désactivé avec --no-use-imap-only, les courriels seront envoyés comme d’habitude. Désactivé par défaut, mais la variable de configuration ‘sendemail.useImapOnly’ peut être utilisée pour l’activer.

Certains serveurs de messagerie (p. ex. smtp.163.com) limitent le nombre maximum de courriel à envoyer par session (connexion) et cela entraînera un échec lors de l’envoi de nombreux messages. Avec cette option, send-email se déconnectera après l’envoi de <num> messages et attendra quelques secondes (voir --relogin-delay) et se reconnectera, pour contourner une telle limite. Vous pouvez utiliser un assistant d’identification pour éviter de devoir resaisir votre mot de passe à chaque fois que cela se produit. Vaut par défaut la variable de configuration `sendemail.smtpBatchSize.

Attend <int> secondes avant de se reconnecter à un serveur SMTP. Utilisé avec l’option --batch-size. Par défaut, utilise la variable de configuration sendemail.smtpReloginDelay.

Effacer toute liste des entêtes To:, Cc:, Bcc: précédemment définis par config.

Effacer la valeur précédemment lue de `sendemail.identity ' réglée par config, le cas échéant.

Spécifie une commande à exécuter une fois par fichier rustine qui devrait générer une entrée To: spécifique au fichier rustine. La sortie de cette commande doit être une seule adresse courriel par ligne. La valeur par défaut est la valeur de configuration `sendemail.toCmd ' .

Spécifie une commande à exécuter une fois par fichier rustine qui devrait générer une entrée Cc: spécifique par fichier rustine. La sortie de cette commande doit être une seule adresse courriel par ligne. La valeur par défaut est la valeur de configuration `sendemail.ccCmd ' .

Spécifie une commande qui est exécutée une fois par message sortant et sort des lignes d’entête RFC 2822 à insérer. Lorsque la variable de configuration sendemail.headerCmd est définie, sa valeur est toujours utilisée. Lorsque --header-cmd est fourni sur la ligne de commande, sa valeur a préséance sur la variable de configuration sendemail.headerCmd.

Désactive toute commande d’en-tête utilisée.

Si c’est le cas, chaque email sera envoyé en réponse à l’e-mail précédent envoyé. Si désactivé avec --no-chain-reply-to, tous les emails après le premier seront envoyés comme réponses au premier email envoyé. Lors de cette utilisation, il est recommandé que le premier fichier donné soit un aperçu de toute la série patch. Désactivé par défaut, mais la variable de configuration sendemail.chainReplyTo peut être utilisée pour l’activer.

Une identité de configuration. Lorsqu’elles sont données, les valeurs de la sous-section sendemail.<identité> prévalent sur les valeurs de la section sendemail. L’identité par défaut est la valeur de sendemail.identity .

Si tel est le cas, ajouter des courriels dans la ligne terminale Signed-off-by ou les lignes Cc: à la liste cc. La valeur par défaut est la valeur de la valeur de configuration sendemail.signedOffByCc ; si non spécifié, vaut par défaut --signed-off-by-cc.

Si défini, les courriels trouvés dans les entêtes Cc: dans la première rustine de la série (généralement la lettre de couverture) sont ajoutés à la liste cc pour chaque jeu de courriel. La valeur par défaut est la valeur de la variable de configuration sendemail.ccCover ; si non spécifiée, vaut par défaut à --no-cc-cover.

Si cela est défini, les courriels trouvés dans les entêtes To: dans la première rustine de la série (généralement la lettre de couverture) sont ajoutés à la liste pour chaque courriel. La valeur par défaut est la valeur de la variable de configuration sendemail.toCover ; si celle-ci est non spécifiée, elle vaut par défaut --no-to-cover.

Préciser une catégorie supplémentaire de destinataires pour supprimer l’auto-cc de :

Si actif, n’ajoute pas l’adresse From: à la liste Cc:. Par défaut, la valeur correspond à la valeur de configuration sendemail.suppressFrom. Si celle-ci n’est pas précisée, se rabat sur --no-suppress-from.

Si cela est défini, les en-têtes In-Reply-To' et References seront ajoutés à chaque courriel envoyé. Que chaque courriel se réfère à l’email précédent (filage profond deep en langage de git format-patch) ou au premier courriel (filage superficiel shallow) est régi par --[no-]chain-reply-to.

Utiliser le fichier mailmap (voir gitmailmap[5]) pour faire correspondre toutes les adresses à leur nom réel et adresse courriel canoniques . D’autres données de correspondances spécifiques aux valeurs de configuration git send-email peuvent être fournies en utilisant les variables de configuration sendemail.mailmap.file ou sendemail.mailmap.blob . Vaut par défaut sendemail.mailmap.

Confirmer juste avant d’envoyer :

Fait tout sauf envoyer réellement les courriels.

Lorsqu’un argument peut être compris soit comme une référence ou comme le nom d’un fichier, choisir de le comprendre comme argument de format-patch (--format-patch) ou comme un nom de fichier (--no-format-patch). Par défaut, quand un tel conflit se produit, git send-email échouera.

Rendre git send-email moins de verbeux. Une ligne par courriel devrait être tout ce qui est émis.

Effectuer une vérification de santé sur les rustines. Actuellement, la validation est la suivante :

Envoyer des courriels même si les contrôles de sécurité l’empêcheraient.

Au lieu de l’opération normale, décharger les noms d’alias courts du ou des fichiers d’alias configurés, un par ligne dans l’ordre alphabétique. Notez que cela ne comprend que le nom d’alias et non ses adresses courriel étendues. Voir sendemail.aliasesFile pour plus d’informations sur les alias.

Au lieu de l’opération normale, lire à partir de l’entrée standard et interpréter chaque ligne comme alias courriel. La traduire en fonctions des fichiers d’alias configurés. Fournir chaque nom traduit et adresse courriel à la sortie standard, une par ligne. Voir sendemail.aliasFile pour plus d’informations sur les alias.