git-send-email – Online in der Cloud

PROGRAMM:

NAME/FUNKTION

git-send-email – Senden Sie eine Sammlung von Patches als E-Mails

ZUSAMMENFASSUNG

git E-Mail senden [Optionen] ...
git E-Mail senden --dump-aliases

BESCHREIBUNG

Nimmt die in der Befehlszeile angegebenen Patches und versendet sie per E-Mail. Patches können angegeben werden
als Dateien, Verzeichnisse (die alle Dateien im Verzeichnis senden) oder direkt als
Revisionsliste. Im letzten Fall kann jedes von akzeptierte Format verwendet werden Git-Format-Patch(1) kann bestanden werden
git send-email.

Der Header der E-Mail kann über Befehlszeilenoptionen konfiguriert werden. Wenn nicht auf der angegeben
In der Befehlszeile wird der Benutzer mit einer ReadLine-fähigen Schnittstelle aufgefordert, die bereitzustellen
notwendige Informationen.

Für Patchdateien werden zwei Formate akzeptiert:

1. Dateien im Mbox-Format

Das ist was Git-Format-Patch(1) erzeugt. Die meisten Header und MIME-Formatierungen sind vorhanden
ignoriert.

2. Das von Greg Kroah-Hartman verwendete Originalformat send_lots_of_email.pl Skript

Bei diesem Format wird erwartet, dass die erste Zeile der Datei den Wert „Cc:“ und den enthält
„Betreff:“ der Nachricht als zweite Zeile.

OPTIONAL

Komponieren
--kommentieren
Überprüfen und bearbeiten Sie jeden Patch, den Sie senden möchten. Der Standardwert ist der Wert von
sendemail.annotate. Weitere Informationen finden Sie im Abschnitt KONFIGURATION sendemail.multiEdit.

--bcc= ,...
Geben Sie für jede E-Mail einen „Bcc:“-Wert an. Der Standardwert ist der Wert von sendemail.bcc.

Diese Option kann mehrfach angegeben werden.

--cc= ,...
Geben Sie für jede E-Mail einen Anfangswert „Cc:“ an. Der Standardwert ist der Wert von sendemail.cc.

Diese Option kann mehrfach angegeben werden.

--komponieren
Rufen Sie einen Texteditor auf (siehe GIT_EDITOR in git-var(1)), um eine Einführungsnachricht zu bearbeiten
für die Patch-Serie.

Wann --komponieren verwendet wird, verwendet git send-email „From“, „Subject“ und „In-Reply-To“.
Header, die in der Nachricht angegeben sind. Wenn der Nachrichtentext (was Sie nach dem eingeben)
Header und eine Leerzeile) enthält nur leere (oder Git: vorangestellte) Zeilen, die Zusammenfassung
wird nicht gesendet, aber die Header „From“, „Subject“ und „In-Reply-To“ werden verwendet, sofern dies nicht der Fall ist
entfernt.

Fehlende From- oder In-Reply-To-Header werden abgefragt.

Weitere Informationen finden Sie im Abschnitt KONFIGURATION sendemail.multiEdit.

--from=
Geben Sie den Absender der E-Mails an. Wenn nicht in der Befehlszeile angegeben, ist der Wert von
sendemail.from Konfigurationsoption verwendet wird. Wenn weder die Befehlszeilenoption
noch sendemail.from festgelegt sind, wird der Benutzer zur Eingabe des Werts aufgefordert. Der Standard
für die Eingabeaufforderung ist der Wert von GIT_AUTHOR_IDENT oder GIT_COMMITTER_IDENT, wenn dies der Fall ist
ist nicht gesetzt, wie von „git var -l“ zurückgegeben.

--in-reply-to=
Lassen Sie die erste E-Mail (oder alle E-Mails mit --no-thread) als Antwort auf die angegebene Nachricht erscheinen
Nachrichten-ID, die verhindert, dass Threads unterbrochen werden, um eine neue Patch-Serie bereitzustellen. Der Zweite
und nachfolgende E-Mails werden als Antworten gemäß --[no]-chain-reply-to gesendet
Einstellung.

Wenn also beispielsweise --thread und --no-chain-reply-to angegeben sind, werden das zweite und
Nachfolgende Patches sind Antworten auf den ersten, wie in der Abbildung unten dargestellt
wobei [PATCH v2 0/3] eine Antwort auf [PATCH 0/2] ist:

[PATCH 0/2] Folgendes habe ich getan ...
[PATCH 1/2] Aufräumen und Tests
[PATCH 2/2] Implementierung
[PATCH v2 0/3] Hier ist eine Wiederholung
[PATCH v2 1/3] Aufräumen
[PATCH v2 2/3] Neue Tests
[PATCH v2 3/3] Implementierung

Nur notwendig, wenn auch --compose gesetzt ist. Wenn --compose nicht festgelegt ist, ist dies der Fall
dazu aufgefordert.

--subject=
Geben Sie den ersten Betreff des E-Mail-Threads an. Nur notwendig, wenn --compose ebenfalls vorhanden ist
Satz. Wenn --compose nicht festgelegt ist, wird dies abgefragt.

--to= ,...
Geben Sie den primären Empfänger der generierten E-Mails an. Im Allgemeinen wird dies der Fall sein
Upstream-Betreuer des betreffenden Projekts. Der Standardwert ist der Wert von Schicke eine Email an
Konfigurationswert; Wenn dies nicht angegeben ist und --to-cmd nicht angegeben ist, wird dies der Fall sein
dazu aufgefordert werden.

Diese Option kann mehrfach angegeben werden.

--8bit-encoding=
Wenn Sie auf eine Nicht-ASCII-Nachricht oder einen Nicht-ASCII-Betreff stoßen, dessen Kodierung nicht angegeben ist,
Fügen Sie Überschriften/Anführungszeichen hinzu, um anzuzeigen, dass es codiert ist . Der Standardwert ist der Wert von
sendemail.assume8bitEncoding; Wenn dies nicht angegeben ist, wird dies abgefragt
Es werden alle Nicht-ASCII-Dateien gefunden.

Beachten Sie, dass keinerlei Versuche unternommen werden, die Kodierung zu validieren.

--compose-encoding=
Geben Sie die Codierung der Nachricht zum Verfassen an. Der Standardwert ist der Wert von
sendemail.composeencoding; Wenn dies nicht angegeben ist, wird UTF-8 angenommen.

--transfer-encoding=(7bit|8bit|quoted-printable|base64)
Geben Sie die Übertragungskodierung an, die zum Senden der Nachricht über SMTP verwendet werden soll. 7bit wird scheitern
wenn Sie auf eine Nicht-ASCII-Nachricht stoßen. quoted-printable kann nützlich sein, wenn die
Das Repository enthält Dateien, die Wagenrückläufe enthalten, erstellt aber den rohen Patch per E-Mail
Datei (wie sie von einer MUA gespeichert wurde) ist viel schwieriger manuell zu überprüfen. base64 ist noch dümmer
beweissicher, aber auch noch undurchsichtiger. Der Standardwert ist der Wert von
sendemail.transferEncoding Konfigurationswert; Wenn dies nicht angegeben ist, wird Git verwenden
8bit und keinen Content-Transfer-Encoding-Header hinzufügen.

--xmailer, --no-xmailer
Fügen Sie den Header „X-Mailer:“ hinzu (oder verhindern Sie das Hinzufügen). Standardmäßig wird der Header hinzugefügt, aber
Es kann deaktiviert werden, indem die Konfigurationsvariable sendemail.xmailer auf „false“ gesetzt wird.

Rechnungserstellung
--envelope-sender=
Geben Sie den Umschlagabsender an, der zum Versenden der E-Mails verwendet wird. Dies ist nützlich, wenn Sie die Standardeinstellung verwenden
Adresse ist nicht die Adresse, die in einer Liste abonniert ist. Um die zu nutzen Aus
Adresse, setzen Sie den Wert auf „auto“. Wenn Sie die Sendmail-Binärdatei verwenden, müssen Sie über Folgendes verfügen
geeignete Berechtigungen für den Parameter -f. Der Standardwert ist der Wert von
sendemail.envelopeSender Konfigurationsvariable; Wenn dies nicht angegeben ist, wählen Sie die
Der Absender des Umschlags bleibt Ihrem MTA überlassen.

--smtp-encryption=
Geben Sie auch die zu verwendende Verschlüsselung an ssl or tls. Jeder andere Wert wird auf „plain“ zurückgesetzt
SMTP. Der Standardwert ist der Wert von sendemail.smtpEncryption.

--smtp-domain=
Gibt den vollqualifizierten Domänennamen (FQDN) an, der im HELO/EHLO-Befehl verwendet wird
SMTP-Server. Bei einigen Servern muss der FQDN mit Ihrer IP-Adresse übereinstimmen. Wenn nicht festgelegt, git
send-email versucht, Ihren FQDN automatisch zu ermitteln. Der Standardwert ist der Wert von
sendemail.smtpDomain.

--smtp-auth=
Durch Leerzeichen getrennte Liste der zulässigen SMTP-AUTH-Mechanismen. Diese Einstellung erzwingt die Verwendung
nur die aufgeführten Mechanismen. Beispiel:

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

Wenn mindestens einer der angegebenen Mechanismen mit den vom SMTP angekündigten übereinstimmt
Server und sofern er von der verwendeten SASL-Bibliothek unterstützt wird, wird der Mechanismus verwendet
Authentifizierung. Wenn weder sendemail.smtpAuth noch --smtp-auth angegeben ist, alle
Von der SASL-Bibliothek unterstützte Mechanismen können genutzt werden.

--smtp-pass[= ]
Passwort für SMTP-AUTH. Das Argument ist optional: Wenn kein Argument angegeben ist, dann
Als Passwort wird die leere Zeichenfolge verwendet. Der Standardwert ist der Wert von sendemail.smtpPass,
aber --smtp-pass überschreibt immer diesen Wert.

Darüber hinaus müssen keine Passwörter in Konfigurationsdateien oder im Befehl angegeben werden
Linie. Wenn ein Benutzername angegeben wurde (mit --smtp-user oder eine sendemail.smtpUser), Aber
Es wurde kein Passwort angegeben (mit --smtp-pass or sendemail.smtpPass), dann ein
Das Passwort wird mit erhalten Git-Anmeldeinformationen.

--smtp-server=
Wenn festgelegt, wird der zu verwendende ausgehende SMTP-Server angegeben (z. B. smtp.example.com oder eine unformatierte IP).
Adresse). Alternativ kann ein vollständiger Pfadname eines sendmail-ähnlichen Programms angegeben werden
stattdessen; Das Programm muss die Option -i unterstützen. Der Standardwert kann durch angegeben werden
sendemail.smtpServer Konfigurationsoption; Die integrierte Standardeinstellung ist /usr/sbin/sendmail
or /usr/lib/sendmail wenn ein solches Programm verfügbar ist, andernfalls localhost.

--smtp-server-port=
Gibt einen Port an, der sich vom Standardport unterscheidet (den SMTP-Server normalerweise überwachen).
SMTP-Port 25, kann aber auch den Übermittlungsport 587 oder den allgemeinen SSL-SMTP-Port überwachen
465); Es werden auch symbolische Portnamen (z. B. „submission“ statt 587) akzeptiert. Der
Port kann auch mit eingestellt werden sendemail.smtpServerPort variable Konfiguration.

--smtp-server-option=
Wenn festgelegt, wird die zu verwendende Option für den ausgehenden SMTP-Server angegeben. Der Standardwert kann sein
angegeben durch die sendemail.smtpServerOption Konfigurationsoption.

Die Option --smtp-server-option muss für jede Option wiederholt werden, an die Sie übergeben möchten
der Kellner. Ebenso müssen jeweils unterschiedliche Zeilen in den Konfigurationsdateien verwendet werden
.

--smtp-ssl
Legacy-Alias ​​für --smtp-Verschlüsselung ssl.

--smtp-ssl-cert-path
Pfad zu einem Speicher vertrauenswürdiger CA-Zertifikate für die SMTP-SSL/TLS-Zertifikatsvalidierung
(entweder ein Verzeichnis, das von verarbeitet wurde c_rehashoder eine einzelne Datei mit
ein oder mehrere miteinander verkettete Zertifikate im PEM-Format: siehe überprüfen(1) -CAfile und
-CApath für weitere Informationen dazu). Setzen Sie es zum Deaktivieren auf eine leere Zeichenfolge
Zertifikatsüberprüfung. Standardmäßig wird der Wert verwendet sendemail.smtpsslcertpath
Konfigurationsvariable, falls festgelegt, oder der kompilierte Standardwert der unterstützenden SSL-Bibliothek
andernfalls (was auf den meisten Plattformen die beste Wahl sein sollte).

--smtp-user=
Benutzername für SMTP-AUTH. Der Standardwert ist der Wert von sendemail.smtpUser; wenn ein Benutzername ist
nicht angegeben (mit --smtp-user or sendemail.smtpUser), dann ist die Authentifizierung nicht möglich
versucht.

--smtp-debug=0|1
Aktivieren (1) oder deaktivieren (0) Sie die Debug-Ausgabe. Wenn diese Option aktiviert ist, werden SMTP-Befehle und -Antworten gesendet
gedruckt. Nützlich zum Debuggen von TLS-Verbindungs- und Authentifizierungsproblemen.

Automatisierung
--to-cmd=
Geben Sie einen Befehl an, der einmal pro Patch-Datei ausgeführt werden soll, um eine Patch-Datei zu generieren
spezifische „An:“-Einträge. Die Ausgabe dieses Befehls muss eine einzelne E-Mail-Adresse pro Zeile sein.
Der Standardwert ist der Wert von sendemail.tocmd Konfigurationswert.

--cc-cmd=
Geben Sie einen Befehl an, der einmal pro Patch-Datei ausgeführt werden soll, um eine Patch-Datei zu generieren
spezifische „Cc:“-Einträge. Die Ausgabe dieses Befehls muss eine einzelne E-Mail-Adresse pro Zeile sein.
Der Standardwert ist der Wert von sendemail.ccCmd Konfigurationswert.

--[no-]chain-reply-to
Wenn dies eingestellt ist, wird jede E-Mail als Antwort auf die zuvor gesendete E-Mail gesendet. Wenn
deaktiviert mit „--no-chain-reply-to“, alle E-Mails nach der ersten werden als gesendet
Antworten auf die erste gesendete E-Mail. Wenn Sie dies verwenden, wird empfohlen, zuerst
Die angegebene Datei bietet einen Überblick über die gesamte Patch-Serie. Standardmäßig deaktiviert, aber die
sendemail.chainReplyTo Zur Aktivierung kann eine Konfigurationsvariable verwendet werden.

--identity=
Eine Konfigurationsidentität. Wenn angegeben, werden Werte im angegeben E-Mail senden.
Unterabschnitt soll Vorrang vor Werten im haben E-Mail senden Abschnitt. Der Standard
Identität ist der Wert von sendemail.identity.

--[no-]signed-off-by-cc
Wenn dies festgelegt ist, fügen Sie E-Mails, die in den Zeilen „Signed-off-by:“ oder „Cc:“ gefunden werden, zur Cc-Liste hinzu.
Der Standardwert ist der Wert von sendemail.signedoffbycc Konfigurationswert; wenn das so ist
nicht angegeben, standardmäßig --signed-off-by-cc.

--[no-]cc-cover
Wenn dies festgelegt ist, werden E-Mails im ersten Patch der Serie in Cc:-Headern gefunden
(normalerweise das Anschreiben) werden der CC-Liste für jeden E-Mail-Satz hinzugefügt. Standard ist
der Wert sendemail.cccover Konfigurationswert; Wenn dies nicht angegeben ist, wird standardmäßig verwendet
--no-cc-cover.

--[no-]to-cover
Wenn dies festgelegt ist, werden E-Mails im ersten Patch der Serie in den An:-Headern gefunden
(normalerweise das Anschreiben) werden der An-Liste für jeden E-Mail-Satz hinzugefügt. Standard ist
der Wert sendemail.tocover Konfigurationswert; Wenn dies nicht angegeben ist, wird standardmäßig verwendet
--no-to-cover.

--suppress-cc=
Geben Sie eine zusätzliche Empfängerkategorie an, um das automatische CC zu unterdrücken von:

· Autor wird es vermeiden, den Patch-Autor einzubeziehen

· selbst wird die Einbeziehung des Absenders vermeiden

· cc wird es vermeiden, alle in den Cc-Zeilen erwähnten Personen in den Patch-Header aufzunehmen, außer
für sich selbst (Verwendung selbst dafür).

· Körpercc wird vermeiden, alle in den Cc-Zeilen erwähnten Personen in den Patch-Körper aufzunehmen (commit
Nachricht) mit Ausnahme von self (use selbst dafür).

· Schluchzen wird es vermeiden, Personen außer sich selbst in die Zeilen „Abgezeichnet von“ aufzunehmen
(benutzen selbst dafür).

· cccmd wird die Ausführung von --cc-cmd vermeiden.

· Körper entspricht Schluchzen + Körpercc

· alle unterdrückt alle automatischen CC-Werte.

Der Standardwert ist der Wert von sendemail.suppresscc Konfigurationswert; wenn das so ist
nicht angegeben, Standardeinstellung ist selbst wenn --suppress-from angegeben ist, sowie Körper if
--no-signed-off-cc ist angegeben.

--[no-]suppress-from
Wenn dies festgelegt ist, fügen Sie die From:-Adresse nicht zur cc:-Liste hinzu. Der Standardwert ist der Wert von
sendemail.suppressFrom Konfigurationswert; Wenn dies nicht angegeben ist, wird standardmäßig verwendet
--no-suppress-from.

--[kein-]Thread
Wenn dies festgelegt ist, werden die Header „In-Reply-To“ und „References“ zu jeder E-Mail hinzugefügt
gesendet. Ob sich jede E-Mail auf die vorherige E-Mail bezieht (Deep Threading pro git
Format-Patch Formulierung) oder an die erste E-Mail (flaches Threading) unterliegt
„--[no-]chain-reply-to“.

Wenn mit „--no-thread“ deaktiviert, werden diese Header nicht hinzugefügt (sofern nicht mit angegeben).
--als Antwort auf). Der Standardwert ist der Wert von sendemail.thread Konfigurationswert; Wenn
das ist nicht spezifiziert, standardmäßig ist --thread.

Es liegt am Benutzer, sicherzustellen, dass zu diesem Zeitpunkt noch kein In-Reply-To-Header vorhanden ist git
E-Mail senden wird gebeten, es hinzuzufügen (beachten Sie insbesondere, dass git Format-Patch konfigurierbar
um das Einfädeln selbst durchzuführen). Andernfalls wird möglicherweise nicht das erwartete Ergebnis erzielt
die MUA des Empfängers.

Verabreichung
--confirm=
Bestätigen Sie kurz vor dem Absenden:

· immer Ich werde dies immer vor dem Senden bestätigen

· hört niemals Wird vor dem Senden niemals bestätigt

· cc bestätigt vor dem Senden, wenn send-email automatisch Adressen hinzugefügt hat
vom Patch zur Cc-Liste

· komponieren wird vor dem Senden der ersten Nachricht bestätigt, wenn --compose verwendet wird.

· Auto entspricht cc + komponieren

Der Standardwert ist der Wert von sendemail.confirm Konfigurationswert; wenn das nicht spezifiziert ist,
Standard auf Auto es sei denn, eine der Unterdrückungsoptionen wurde angegeben. In diesem Fall
Standard auf komponieren.

--Probelauf
Tun Sie alles, außer die E-Mails tatsächlich zu versenden.

--[no-]format-patch
Wenn ein Argument entweder als Referenz oder als Dateiname verstanden werden kann, wählen Sie dies
Verstehen Sie es als Format-Patch-Argument (--format-patch) oder als Dateiname
(--no-format-patch). Wenn ein solcher Konflikt auftritt, wird standardmäßig git send-email ausgeführt
Scheitern.

--ruhig
Machen Sie git-send-email weniger ausführlich. Es sollte lediglich eine Zeile pro E-Mail ausgegeben werden.

--[no-]validieren
Führen Sie Plausibilitätsprüfungen für Patches durch. Derzeit bedeutet Validierung Folgendes:

· Warnung vor Patches, die Zeilen mit mehr als 998 Zeichen enthalten; das liegt an SMTP
Grenzen wie beschrieben von http://www.ietf.org/rfc/rfc2821.txt.

Der Standardwert ist der Wert von sendemail.validate; Wenn dies nicht festgelegt ist, wird standardmäßig verwendet --bestätigen.

--Macht
Senden Sie E-Mails auch dann, wenn Sicherheitsüberprüfungen dies verhindern würden.

Informationen
--dump-aliases
Anstelle des normalen Vorgangs können Sie die Kurz-Aliasnamen aus der konfigurierten Datei ausgeben
Alias-Datei(en), eine pro Zeile in alphabetischer Reihenfolge. Beachten Sie, dass dies nur den Alias ​​umfasst
Namen und nicht die erweiterten E-Mail-Adressen. Sehen sendemail.aliasesfile Für weitere
Informationen zu Aliasnamen.

CONFIGURATION

sendemail.aliasesFile
Um die Eingabe langer E-Mail-Adressen zu vermeiden, verweisen Sie auf eine oder mehrere E-Mail-Aliasedateien.
Sie müssen auch liefern sendemail.aliasFileType.

sendemail.aliasFileType
Format der in sendemail.aliasesFile angegebenen Datei(en). Muss einer davon sein mutt, mailrc,
Kiefer, Ulme, oder Gnus, oder sendmail.

Wie eine Alias-Datei in den einzelnen Formaten aussieht, finden Sie in der Dokumentation von
gleichnamiges E-Mail-Programm. Die Unterschiede und Einschränkungen zum Standard
Formate werden im Folgenden beschrieben:

sendmail

· Anführungszeichen und Adressen in Anführungszeichen werden nicht unterstützt: Zeilen, die ein „ enthalten
Symbol werden ignoriert.

· Die Umleitung zu einer Datei (/Pfad/Name) oder Pipe (|Befehl) wird nicht unterstützt.

· Die Dateieinbindung (:include: /path/name) wird nicht unterstützt.

· Warnungen werden explizit in der Standardfehlerausgabe ausgegeben
nicht unterstützte Konstrukte und alle anderen Zeilen, die von der nicht erkannt werden
Parser.

sendemail.multiEdit
Bei „true“ (Standard) wird eine einzelne Editor-Instanz erstellt, um die erforderlichen Dateien zu bearbeiten
Bearbeiten (Patches wann --kommentieren verwendet wird, und die Zusammenfassung wann --komponieren wird eingesetzt). Wenn
false, Dateien werden nacheinander bearbeitet, wobei jedes Mal ein neuer Editor entsteht.

sendemail.confirm
Legt die Standardeinstellung fest, ob vor dem Senden eine Bestätigung erfolgen soll. Muss einer davon sein immer, hört niemals ,
cc, komponieren, oder Auto. Sehen --bestätigen Sie Im vorherigen Abschnitt erfahren Sie, welche Bedeutung diese haben
Werte.

BEISPIEL

Verwenden Sie die gmail as smtp Server
So verwenden Sie git E-Mail senden Bearbeiten Sie, um Ihre Patches über den GMail-SMTP-Server zu senden
~ / .gitconfig So legen Sie Ihre Kontoeinstellungen fest:

[E-Mail senden]
smtpEncryption = tls
smtpServer = smtp.gmail.com
smtpUser = [E-Mail geschützt]
smtpServerPort = 587

Sobald Ihre Commits bereit sind, an die Mailingliste gesendet zu werden, führen Sie die folgenden Befehle aus:

$ git format-patch --cover-letter -M origin/master -o outgoing/
$ ausgehend bearbeiten/0000-*
$ git send-email outgoing/*

Hinweis: Die folgenden Perl-Module sind erforderlich: Net::SMTP::SSL, MIME::Base64 und
Authen::SASL

Verwenden Sie git-send-email online über die Dienste von onworks.net