git-send-email - En ligne dans le Cloud

PROGRAMME:

Nom

git-send-email - Envoyer une collection de correctifs sous forme d'e-mails

SYNOPSIS

jet envoyer-e-mail [options] ...
jet envoyer-e-mail --dump-alias

DESCRIPTION

Prend les correctifs donnés sur la ligne de commande et les envoie par e-mail. Les correctifs peuvent être spécifiés
sous forme de fichiers, de répertoires (qui enverront tous les fichiers du répertoire), ou directement sous forme de
liste de révision. Dans ce dernier cas, tout format accepté par git-format-correctif(1) peut être passé
à git send-email.

L'en-tête de l'e-mail est configurable via les options de ligne de commande. Si non spécifié sur le
ligne de commande, l'utilisateur sera invité avec une interface compatible ReadLine à fournir le
information nécessaire.

Il existe deux formats acceptés pour les fichiers de correctifs :

1. fichiers au format mbox

C'est quoi git-format-correctif(1) génère. La plupart des en-têtes et le formatage MIME sont
ignoré.

2. Le format original utilisé par Greg Kroah-Hartman send_lots_of_email.pl scénario

Ce format s'attend à ce que la première ligne du fichier contienne la valeur « Cc : » et le
« Sujet : » du message comme deuxième ligne.

OPTIONS

Composition
--annoter
Examinez et modifiez chaque patch que vous êtes sur le point d'envoyer. La valeur par défaut est
envoyer un e-mail. annoter. Voir la section CONFIGURATION pour sendemail.multiModifier.

--bcc= ,...
Spécifiez une valeur « Cci : » pour chaque e-mail. La valeur par défaut est envoyeremail.bcc.

Cette option peut être spécifiée plusieurs fois.

--cc= ,...
Spécifiez une valeur de départ « Cc : » pour chaque e-mail. La valeur par défaut est envoyeremail.cc.

Cette option peut être spécifiée plusieurs fois.

--composer
Appelez un éditeur de texte (voir GIT_EDITOR dans git-var(1)) pour éditer un message d'introduction
pour la série de patchs.

Quand --composer est utilisé, git send-email utilisera les champs From, Subject et In-Reply-To
en-têtes spécifiés dans le message. Si le corps du message (ce que vous tapez après le
en-têtes et une ligne vide) ne contient que des lignes vides (ou Git : préfixé), le résumé
ne sera pas envoyé, mais les en-têtes From, Subject et In-Reply-To seront utilisés à moins qu'ils ne soient
enlevé.

Les en-têtes manquants ou In-Reply-To seront demandés.

Voir la section CONFIGURATION pour sendemail.multiModifier.

--de=
Spécifiez l'expéditeur des e-mails. Si elle n'est pas spécifiée sur la ligne de commande, la valeur de
le envoyeremail.de l'option de configuration est utilisée. Si ni l'option de ligne de commande
ni envoyeremail.de sont définis, l'utilisateur sera alors invité à saisir la valeur. Le défaut
pour l'invite sera la valeur de GIT_AUTHOR_IDENT, ou GIT_COMMITTER_IDENT si cela
n'est pas défini, comme renvoyé par "git var -l".

--in-reply-to=
Faire apparaître le premier mail (ou tous les mails avec --no-thread) en réponse au
Message-Id, qui évite de casser les threads pour fournir une nouvelle série de correctifs. La deuxième
et les e-mails suivants seront envoyés en tant que réponses selon le --[no]-chain-reply-to
réglage.

Ainsi, par exemple, lorsque --thread et --no-chain-reply-to sont spécifiés, le deuxième et
les correctifs suivants seront des réponses au premier comme dans l'illustration ci-dessous
où [PATCH v2 0/3] est en réponse à [PATCH 0/2] :

[PATCH 0/2] Voici ce que j'ai fait...
[PATCH 1/2] Nettoyage et tests
[PATCH 2/2] Implémentation
[PATCH v2 0/3] Voici un reroll
[PATCH v2 1/3] Nettoyer
[PATCH v2 2/3] Nouveaux tests
[PATCH v2 3/3] Implémentation

Uniquement nécessaire si --compose est également défini. Si --compose n'est pas défini, ce sera
demandé.

--sujet=
Spécifiez l'objet initial du fil de discussion. Uniquement nécessaire si --compose est également
ensemble. Si --compose n'est pas défini, cela sera demandé.

--à= ,...
Spécifiez le destinataire principal des e-mails générés. En général, ce sera le
mainteneur en amont du projet concerné. La valeur par défaut est la valeur du envoyeremail.à
valeur de configuration ; si ce n'est pas spécifié et que --to-cmd n'est pas spécifié, cela
être invité.

Cette option peut être spécifiée plusieurs fois.

--8bit-encoding=
Lorsque vous rencontrez un message ou un sujet non ASCII qui ne déclare pas son codage,
ajouter des en-têtes/citations pour indiquer qu'il est encodé dans . La valeur par défaut est
le sendemail.assume8bitEncodage; si ce n'est pas spécifié, cela sera demandé si
tous les fichiers non ASCII sont rencontrés.

Notez qu'aucune tentative n'est faite pour valider l'encodage.

--compose-encoding=
Spécifiez l'encodage du message de composition. La valeur par défaut est la valeur du
envoyer un e-mail. composer un codage; si cela n'est pas spécifié, UTF-8 est supposé.

--transfer-encoding=(7bit|8bit|quoted-printable|base64)
Spécifiez le codage de transfert à utiliser pour envoyer le message via SMTP. 7bit échouera
lors de la rencontre d'un message non ASCII. quoted-printable peut être utile lorsque le
le référentiel contient des fichiers qui contiennent des retours chariot, mais envoie le correctif brut par e-mail
(tel qu'enregistré à partir d'un MUA) beaucoup plus difficile à inspecter manuellement. base64 est encore plus idiot
preuve, mais aussi encore plus opaque. La valeur par défaut est la valeur du
sendemail.transferEncoding valeur de configuration ; si ce n'est pas spécifié, git utilisera
8 bits et ne pas ajouter d'en-tête Content-Transfer-Encoding.

--xmailer, --no-xmailer
Ajoutez (ou empêchez l'ajout) de 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 sur false.

Envoi
--envelope-sender=
Spécifiez l'expéditeur de l'enveloppe utilisée pour envoyer les e-mails. Ceci est utile si votre valeur par défaut
l'adresse n'est pas l'adresse qui est abonnée à une liste. Afin d'utiliser le Du
adresse, définissez la valeur sur "auto". Si vous utilisez le binaire sendmail, vous devez avoir
privilèges appropriés pour le paramètre -f. La valeur par défaut est la valeur du
sendemail.envelopeSender variable de configuration ; si cela n'est pas spécifié, en choisissant le
l'expéditeur de l'enveloppe est laissé à votre MTA.

--smtp-cryptage=
Spécifiez le cryptage à utiliser, soit ssl or tls. Toute autre valeur redevient simple
SMTP. La valeur par défaut est sendemail.smtpCryptage.

--smtp-domain=
Spécifie le nom de domaine complet (FQDN) utilisé dans la commande HELO/EHLO au
Serveur SMTP. Certains serveurs nécessitent que le FQDN corresponde à votre adresse IP. Si non défini, git
send-email tente de déterminer automatiquement votre nom de domaine complet. La valeur par défaut est
sendemail.smtpDomain.

--smtp-auth=
Liste séparée par des espaces des mécanismes SMTP-AUTH autorisés. Ce paramètre oblige à utiliser
uniquement les mécanismes énumérés. Exemple:

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

Si au moins un des mécanismes spécifiés correspond à ceux annoncés par le SMTP
serveur et s'il est pris en charge par la bibliothèque SASL utilisée, le mécanisme est utilisé pour
authentification. Si ni l'un ni l'autre sendemail.smtpAuth ni --smtp-auth est spécifié, tout
les mécanismes pris en charge par la bibliothèque SASL peuvent être utilisés.

--smtp-pass[= ]
Mot de passe pour SMTP-AUTH. L'argument est facultatif : si aucun argument n'est spécifié, alors
la chaîne vide est utilisée comme mot de passe. La valeur par défaut est sendemail.smtpPass,
toutefois --smtp-pass remplace toujours cette valeur.

De plus, les mots de passe n'ont pas besoin d'être spécifiés dans les fichiers de configuration ou sur la commande
ligne. Si un nom d'utilisateur a été spécifié (avec --smtp-utilisateur ou sendemail.smtpUser), Mais
aucun mot de passe n'a été spécifié (avec --smtp-pass or sendemail.smtpPass), puis un
le mot de passe est obtenu en utilisant git-informations d'identification.

--smtp-server=
Si défini, spécifie le serveur SMTP sortant à utiliser (par exemple smtp.example.com ou une adresse IP brute
adresse). Alternativement, il peut spécifier un chemin d'accès complet d'un programme de type sendmail
au lieu; le programme doit prendre en charge l'option -i. La valeur par défaut peut être spécifiée par le
sendemail.smtpServer option de configuration ; la valeur par défaut intégrée est /usr/sbin/sendmail
or /usr/lib/sendmail si un tel programme est disponible, ou localhost autrement.

--smtp-server-port=
Spécifie un port différent du port par défaut (les serveurs SMTP écoutent généralement
le port smtp 25, mais peut également écouter le port de soumission 587 ou le port smtp SSL commun
465) ; les noms de ports symboliques (par exemple "soumission" au lieu de 587) sont également acceptés. Les
le port peut également être réglé avec le sendemail.smtpServerPort variable de configuration.

--smtp-server-option=
Si défini, spécifie l'option de serveur SMTP sortant à utiliser. La valeur par défaut peut être
spécifié par le sendemail.smtpServerOption option de configuration.

L'option --smtp-server-option doit être répétée pour chaque option que vous souhaitez passer à
le serveur. De même, différentes lignes dans les fichiers de configuration doivent être utilisées pour chaque
option.

--smtp-ssl
Ancien alias pour --smtp-cryptage ssl.

--smtp-ssl-cert-chemin
Chemin d'accès à un magasin de certificats CA de confiance pour la validation des certificats SMTP SSL/TLS
(soit un répertoire qui a été traité par c_ressaisir, ou un seul fichier contenant
un ou plusieurs certificats au format PEM concaténés entre eux : voir vérifier(1) -CAfile et
-CApath pour plus d'informations sur ces derniers). Définissez-le sur une chaîne vide pour désactiver
vérification du certificat. La valeur par défaut est la sendemail.smtpsslcertpath
variable de configuration, si elle est définie, ou la valeur par défaut compilée de la bibliothèque SSL de sauvegarde
sinon (ce qui devrait être le meilleur choix sur la plupart des plateformes).

--smtp-user=
Nom d'utilisateur pour SMTP-AUTH. La valeur par défaut est sendemail.smtpUser; si un nom d'utilisateur est
non spécifié (avec --smtp-utilisateur or sendemail.smtpUser), alors l'authentification n'est pas
tenté.

--smtp-debug=0|1
Activer (1) ou désactiver (0) la sortie de débogage. Si activé, les commandes et réponses SMTP seront
imprimé. Utile pour déboguer les problèmes de connexion et d'authentification TLS.

Automatiser
--to-cmd=
Spécifiez une commande à exécuter une fois par fichier de correctif qui devrait générer un fichier de correctif
des entrées spécifiques « À : ». La sortie de cette commande doit être une seule adresse e-mail par ligne.
La valeur par défaut est envoyeremail.tocmd valeur de configuration.

--cc-cmd=
Spécifiez une commande à exécuter une fois par fichier de correctif qui devrait générer un fichier de correctif
des entrées spécifiques « Cc : ». La sortie de cette commande doit être une seule adresse e-mail par ligne.
La valeur par défaut est envoyeremail.ccCmd valeur de configuration.

--[no-]chaîne-répondre-à
Si cette option est définie, chaque e-mail sera envoyé en réponse au précédent e-mail envoyé. Si
désactivé avec "--no-chain-reply-to", tous les e-mails après le premier seront envoyés comme
répond au premier e-mail envoyé. Lors de son utilisation, il est recommandé que le premier
fichier donné être un aperçu de l'ensemble de la série de correctifs. Désactivé par défaut, mais le
sendemail.chainReplyTo La variable de configuration peut être utilisée pour l'activer.

--identité=
Une identité de configuration. Lorsqu'il est donné, provoque des valeurs dans le envoyeremail.
sous-section pour avoir préséance sur les valeurs dans le envoyeremail section. Le défaut
l'identité est la valeur de envoyeremail.identité.

--[non-]signé-par-cc
Si cela est défini, ajoutez les e-mails trouvés dans les lignes Signé par : ou Cc : à la liste cc.
La valeur par défaut est envoyeremail.signedoffbycc valeur de configuration ; si c'est
non spécifié, par défaut --signed-off-by-cc.

--[no-]cc-couverture
Si cette option est définie, les e-mails trouvés dans Cc : en-têtes dans le premier patch de la série
(généralement la lettre de motivation) sont ajoutés à la liste cc pour chaque ensemble d'e-mails. La valeur par défaut est
la valeur de envoyeremail.cccover valeur de configuration ; si cela n'est pas spécifié, par défaut
--pas de couverture cc.

--[non-]à-couvrir
Si cette option est définie, les e-mails trouvés dans À : en-têtes dans le premier patch de la série
(généralement la lettre d'accompagnement) sont ajoutés à la liste pour chaque ensemble d'e-mails. La valeur par défaut est
la valeur de envoyeremail.tocover valeur de configuration ; si cela n'est pas spécifié, par défaut
--pas de couverture.

--suppress-cc=
Spécifiez une catégorie supplémentaire de destinataires pour supprimer la copie automatique de :

· auteur évitera d'inclure l'auteur du patch

· soi évitera d'inclure l'expéditeur

· cc évitera d'inclure toute personne mentionnée dans les lignes Cc dans l'en-tête du correctif, sauf
pour soi (utiliser soi pour ça).

· corpscc évitera d'inclure toute personne mentionnée dans les lignes Cc dans le corps du patch (commit
message) sauf pour soi (utiliser soi pour ça).

· sanglot évitera d'inclure toute personne mentionnée dans les lignes Signé par, sauf pour vous-même
(utilisation soi pour ça).

· ccmd évitera d'exécuter le --cc-cmd.

· corps équivaut à sanglot + corpscc

· TOUTE supprimera toutes les valeurs cc automatiques.

La valeur par défaut est sendemail.suppresscc valeur de configuration ; si c'est
non spécifié, par défaut soi si --suppress-from est spécifié, ainsi que corps if
--no-signed-off-cc est spécifié.

--[no-]supprimer-de
Si cela est défini, n'ajoutez pas l'adresse De: à la liste cc:. La valeur par défaut est
sendemail.suppressFrom valeur de configuration ; si cela n'est pas spécifié, par défaut
--no-suppress-de.

--[no-] fil
Si cela est défini, les en-têtes In-Reply-To et References seront ajoutés à chaque e-mail
envoyé. Que chaque e-mail fasse référence à l'e-mail précédent (filage approfondi par jet
patch-format libellé) ou au premier e-mail (filetage superficiel) est régi par
"--[no-]chain-reply-to".

Si désactivé avec "--no-thread", ces en-têtes ne seront pas ajoutés (sauf si spécifié avec
--en réponse à). La valeur par défaut est la valeur du envoyer un e-mail.thread valeur de configuration ; si
qui n'est pas spécifié, la valeur par défaut est --thread.

Il appartient à l'utilisateur de s'assurer qu'aucun en-tête In-Reply-To n'existe déjà lorsque jet
envoyer-e-mail est invité à l'ajouter (notez en particulier que jet patch-format peut être configuré
pour faire l'enfilage lui-même). Ne pas le faire peut ne pas produire le résultat attendu dans
le MUA du destinataire.

Administrer
--confirm=
Confirmez juste avant d'envoyer :

· toujours confirmera toujours avant d'envoyer

· n'allons jamais ne confirmera jamais avant d'envoyer

· cc confirmera avant l'envoi lorsque send-email a automatiquement ajouté des adresses
du patch à la liste Cc

· composer confirmera avant d'envoyer le premier message lors de l'utilisation de --compose.

· auto équivaut à cc + composer

La valeur par défaut est envoyeremail.confirmer valeur de configuration ; si cela n'est pas précisé,
par défaut auto à moins que l'une des options de suppression n'ait été spécifiée, auquel cas
par défaut composer.

- à sec
Faites tout sauf envoyer les e-mails.

--[no-]format-correctif
Lorsqu'un argument peut être compris soit comme une référence, soit comme un nom de fichier, choisissez de
le comprendre comme un argument format-patch (--format-correctif) ou comme nom de fichier
(--no-format-correctif). Par défaut, lorsqu'un tel conflit se produit, git send-email
échouer.

--silencieux
Rendez git-send-email moins verbeux. Une ligne par e-mail devrait être tout ce qui est sorti.

--[no-]valider
Effectuez des vérifications d'intégrité sur les correctifs. Actuellement, la validation signifie ce qui suit :

· Avertir des correctifs qui contiennent des lignes de plus de 998 caractères ; c'est à cause de SMTP
limites telles que décrites par http://www.ietf.org/rfc/rfc2821.txt.

La valeur par défaut est envoyeremail.valider; si ce n'est pas défini, la valeur par défaut est --valider.

--Obliger
Envoyez des e-mails même si les contrôles de sécurité l'empêcheraient.

Informations
--dump-alias
Au lieu de l'opération normale, videz les noms d'alias abrégés du fichier configuré
fichier(s) d'alias, un par ligne par ordre alphabétique. Notez que cela n'inclut que l'alias
nom et non ses adresses e-mail étendues. Voir fichier sendemail.aliases pour plus d'
informations sur les alias.

CONFIGURATION

sendemail.aliasesFichier
Pour éviter de taper de longues adresses e-mail, pointez-le vers un ou plusieurs fichiers d'alias de messagerie.
Vous devez également fournir sendemail.aliasFileType.

sendemail.aliasFileType
Format du ou des fichiers spécifiés dans sendemail.aliasesFile. Doit être l'un des cabot, mailrc,
pin, ormeou dégoûterou sendmail.

À quoi ressemble un fichier d'alias dans chaque format peut être trouvé dans la documentation du
programme de messagerie du même nom. Les différences et limites par rapport à la norme
les formats sont décrits ci-dessous :

sendmail

· Les alias et adresses entre guillemets ne sont pas pris en charge : les lignes contenant un "
symbole sont ignorés.

· La redirection vers un fichier (/chemin/nom) ou un tube (|commande) n'est pas prise en charge.

· L'inclusion de fichier (:include: /path/name) n'est pas prise en charge.

· Les avertissements sont imprimés sur la sortie d'erreur standard pour tout
constructions non prises en charge, et toutes les autres lignes qui ne sont pas reconnues par le
analyseur.

sendemail.multiModifier
Si vrai (par défaut), une seule instance d'éditeur sera générée pour éditer les fichiers que vous devez
modifier (correctifs quand --annoter est utilisé, et le résumé lorsque --composer est utilisé). Si
false, les fichiers seront édités les uns après les autres, engendrant un nouvel éditeur à chaque fois.

envoyeremail.confirmer
Définit la valeur par défaut pour la confirmation avant l'envoi. Doit être l'un des toujours, n'allons jamais ,
cc, composerou auto. Voir --confirmer dans la section précédente pour la signification de ces
valeurs.

EXEMPLE

Utilisez gmail as le smtp serveur
Utiliser jet envoyer-e-mail pour envoyer vos correctifs via le serveur SMTP de GMail, modifiez
~ / .gitconfig pour spécifier les paramètres de votre compte :

[envoyeremail]
smtpEncryption = tls
smtpServer = smtp.gmail.com
smtpUtilisateur = [email protected]
smtpServerPort = 587

Une fois que vos commits sont prêts à être envoyés à la liste de diffusion, exécutez les commandes suivantes :

$ git format-patch --cover-letter -M origin/master -o sortant/
$ modifier sortant/0000-*
$ git send-email sortant/*

Remarque : les modules perl suivants sont requis Net::SMTP::SSL, MIME::Base64 et
Authentification :: SASL

Utilisez git-send-email en ligne en utilisant les services onworks.net