git-send-email - Online in de cloud

PROGRAMMA:

NAAM

git-send-email - Stuur een verzameling patches als e-mails

KORTE INHOUD

git e-mail verzenden [opties] ...
git e-mail verzenden --dump-aliassen

PRODUCTBESCHRIJVING

Neemt de patches die op de opdrachtregel worden gegeven en e-mailt ze naar buiten. Patches kunnen worden gespecificeerd
als bestanden, mappen (die alle bestanden in de map zullen verzenden), of rechtstreeks als a
revisie lijst. In het laatste geval, elk formaat dat wordt geaccepteerd door git-formaat-patch(1) kan worden doorgegeven
om e-mail te verzenden.

De kop van de e-mail is configureerbaar via opdrachtregelopties. Indien niet gespecificeerd op de
opdrachtregel, wordt de gebruiker gevraagd met een ReadLine-enabled interface om de
Nodige informatie.

Er zijn twee formaten die worden geaccepteerd voor patchbestanden:

1. bestanden in mbox-formaat

Dit is wat git-formaat-patch(1) genereert. De meeste headers en MIME-opmaak zijn:
buiten beschouwing gelaten.

2. Het originele formaat gebruikt door Greg Kroah-Hartman's verzend_veel_e-mail.pl script

Deze indeling verwacht dat de eerste regel van het bestand de waarde "Cc:" bevat en de
"Onderwerp:" van het bericht als de tweede regel.

OPTIES

samengesteld
--annoteren
Bekijk en bewerk elke patch die u gaat verzenden. Standaard is de waarde van
verzendemail.annoteren. Zie het gedeelte CONFIGURATIE voor: verzendemail.multiEdit.

--bcc= ,...
Geef voor elke e-mail een "Bcc:"-waarde op. Standaard is de waarde van verzendemail.bcc.

Deze optie kan meerdere keren worden opgegeven.

--cc= ,...
Geef voor elke e-mail een beginwaarde voor "Cc:" op. Standaard is de waarde van verzendemail.cc.

Deze optie kan meerdere keren worden opgegeven.

--componeren
Roep een teksteditor op (zie GIT_EDITOR in git-var(1)) om een ​​inleidend bericht te bewerken
voor de patch-serie.

. --componeren wordt gebruikt, gebruikt git send-email de Van, Onderwerp en In-Reply-To
koppen die in het bericht zijn opgegeven. Als de hoofdtekst van het bericht (wat u typt na de
headers en een lege regel) bevat alleen lege (of Git: prefix) regels, de samenvatting
worden niet verzonden, maar de headers Van, Onderwerp en In-Reply-To worden gebruikt, tenzij dit het geval is
verwijderd.

Er wordt gevraagd om ontbrekende Van- of In-Reply-To-headers.

Zie het gedeelte CONFIGURATIE voor: verzendemail.multiEdit.

--van=
Geef de afzender van de e-mails op. Indien niet opgegeven op de opdrachtregel, wordt de waarde van
de e-mail.vanuit configuratieoptie wordt gebruikt. Als geen van beide de opdrachtregeloptie
noch e-mail.vanuit zijn ingesteld, wordt de gebruiker om de waarde gevraagd. De standaard
voor de prompt is de waarde van GIT_AUTHOR_IDENT, of GIT_COMMITTER_IDENT als dat
is niet ingesteld, zoals geretourneerd door "git var -l".

--in-antwoord-op=
Laat de eerste mail (of alle mails met --no-thread) verschijnen als een antwoord op het gegeven
Message-Id, die voorkomt dat threads worden verbroken om een ​​nieuwe patchreeks te bieden. De seconde
en volgende e-mails worden verzonden als antwoorden volgens de --[no]-chain-reply-to
instellen.

Dus wanneer bijvoorbeeld --thread en --no-chain-reply-to zijn opgegeven, wordt de tweede en
volgende patches zijn antwoorden op de eerste zoals in de onderstaande afbeelding
waar [PATCH v2 0/3] is in antwoord op [PATCH 0/2]:

[PATCH 0/2] Dit is wat ik deed...
[PATCH 1/2] Opruimen en testen
[PATCH 2/2] Implementatie
[PATCH v2 0/3] Hier is een reroll
[PATCH v2 1/3] Opruimen
[PATCH v2 2/3] Nieuwe tests
[PATCH v2 3/3] Implementatie

Alleen nodig als --compose ook is ingesteld. Als --compose niet is ingesteld, is dit:
gevraagd.

--subject=
Geef het oorspronkelijke onderwerp van de e-mailthread op. Alleen nodig als --compose ook is
set. Als --compose niet is ingesteld, wordt hierom gevraagd.

--naar= ,...
Geef de primaire ontvanger van de gegenereerde e-mails op. Over het algemeen zal dit de
upstream beheerder van het betrokken project. Standaard is de waarde van de stuur een email naar
configuratiewaarde; als dat niet gespecificeerd is, en --to-cmd niet gespecificeerd is, zal dit
gevraagd worden.

Deze optie kan meerdere keren worden opgegeven.

--8bit-encoding=
Wanneer u een niet-ASCII-bericht of onderwerp tegenkomt dat de codering niet aangeeft,
voeg headers/citaten toe om aan te geven dat het is gecodeerd in . Standaard is de waarde van
de sendemail.assume8bitEncoding; als dat niet gespecificeerd is, wordt gevraagd of
er worden niet-ASCII-bestanden aangetroffen.

Merk op dat er geen enkele poging wordt ondernomen om de codering te valideren.

--compose-encoding=
Specificeer de codering van het opstelbericht. Standaard is de waarde van de
sendemail.composeencoding; als dat niet gespecificeerd is, wordt uitgegaan van UTF-8.

--transfer-encoding=(7bit|8bit|quoted-printable|base64)
Geef de overdrachtscodering op die moet worden gebruikt om het bericht via SMTP te verzenden. 7bit zal mislukken
bij het tegenkomen van een niet-ASCII-bericht. quoted-printable kan handig zijn wanneer de
repository bevat bestanden die regelterugloop bevatten, maar maakt de onbewerkte patch-e-mail
bestand (zoals opgeslagen van een MUA) veel moeilijker handmatig te inspecteren. base64 is nog dwazer
bewijs, maar ook nog ondoorzichtiger. Standaard is de waarde van de
sendemail.transferEncoding configuratiewaarde; als dat niet gespecificeerd is, gebruikt git
8bit en voeg geen Content-Transfer-Encoding-header toe.

--xmailer, --no-xmailer
Voeg de "X-Mailer:" header toe (of voorkom het toevoegen). Standaard wordt de koptekst toegevoegd, maar
het kan worden uitgeschakeld door de configuratievariabele sendemail.xmailer in te stellen op false.

Verzending
--envelop-afzender=
Geef de envelopafzender op die wordt gebruikt om de e-mails te verzenden. Dit is handig als uw standaard
adres is niet het adres dat op een lijst is geabonneerd. Om de . te gebruiken Van
adres, stel de waarde in op "auto". Als u het binaire bestand sendmail gebruikt, moet u:
geschikte privileges voor de parameter -f. Standaard is de waarde van de
sendemail.envelopeSender configuratievariabele; als dat niet gespecificeerd is, kiest u de
envelop afzender wordt overgelaten aan uw MTA.

--smtp-encryption=
Geef de te gebruiken codering op, ofwel: ssl or tls. Elke andere waarde wordt teruggezet naar gewoon
SMTP. Standaard is de waarde van sendemail.smtpEncryptie.

--smtp-domein=
Specificeert de Fully Qualified Domain Name (FQDN) die in de HELO/EHLO-opdracht wordt gebruikt om de
SMTP-server. Sommige servers vereisen dat de FQDN overeenkomt met uw IP-adres. Indien niet ingesteld, git
send-e-mail probeert uw FQDN automatisch te bepalen. Standaard is de waarde van
sendemail.smtpDomein.

--smtp-auth=
Door spaties gescheiden lijst van toegestane SMTP-AUTH-mechanismen. Deze instelling dwingt het gebruik van
alleen de genoemde mechanismen. Voorbeeld:

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

Als ten minste één van de gespecificeerde mechanismen overeenkomt met die geadverteerd door de SMTP
server en als het wordt ondersteund door de gebruikte SASL-bibliotheek, wordt het mechanisme gebruikt voor:
authenticatie. Als geen van beide verzendemail.smtpAuth noch --smtp-auth is gespecificeerd, alle
mechanismen die door de SASL-bibliotheek worden ondersteund, kunnen worden gebruikt.

--smtp-pas[= ]
Wachtwoord voor SMTP-AUTH. Het argument is optioneel: Als er geen argument is opgegeven, dan:
de lege string wordt gebruikt als het wachtwoord. Standaard is de waarde van sendemail.smtpPass,
echter --smtp-pas overschrijft deze waarde altijd.

Bovendien hoeven wachtwoorden niet te worden opgegeven in configuratiebestanden of op de opdracht
lijn. Als er een gebruikersnaam is opgegeven (met --smtp-gebruiker of sendemail.smtpGebruiker) doel
er is geen wachtwoord opgegeven (met --smtp-pas or sendemail.smtpPass), dan een
wachtwoord wordt verkregen met behulp van git-referentie.

--smtp-server=
Indien ingesteld, specificeert het de uitgaande SMTP-server die moet worden gebruikt (bijv. smtp.example.com of een onbewerkt IP-adres
adres). Als alternatief kan het een volledige padnaam van een sendmail-achtig programma specificeren
in plaats daarvan; het programma moet de -i optie ondersteunen. De standaardwaarde kan worden gespecificeerd door de
verzendemail.smtpServer configuratie optie; de ingebouwde standaard is /usr/sbin/sendmail
or /usr/lib/sendmail als een dergelijk programma beschikbaar is, of anders localhost.

--smtp-server-poort=
Specificeert een andere poort dan de standaardpoort (SMTP-servers luisteren meestal naar
smtp-poort 25, maar kan ook luisteren naar verzendpoort 587, of de gemeenschappelijke SSL smtp-poort
465); symbolische poortnamen (bijv. "submission" in plaats van 587) worden ook geaccepteerd. De
poort kan ook worden ingesteld met de sendemail.smtpServerPort variabele configuratie.

--smtp-server-optie=
Indien ingesteld, specificeert dit de uitgaande SMTP-serveroptie die moet worden gebruikt. Standaardwaarde kan zijn
gespecificeerd door de sendemail.smtpServerOption configuratie optie.

De optie --smtp-server-option moet worden herhaald voor elke optie waaraan u wilt doorgeven
de server. Evenzo moeten voor elk verschillende regels in de configuratiebestanden worden gebruikt
optie.

--smtp-ssl
Verouderde alias voor --smtp-encryptie ssl.

--smtp-ssl-cert-pad
Pad naar een winkel met vertrouwde CA-certificaten voor SMTP SSL/TLS-certificaatvalidatie
(ofwel een map die is verwerkt door c_rehash, of een enkel bestand met
een of meer certificaten in PEM-formaat samengevoegd: zie controleren(1) -CA-bestand en
-CApath voor meer informatie hierover). Stel het in op een lege tekenreeks om uit te schakelen
certificaat verificatie. Standaard ingesteld op de waarde van de sendemail.smtpsslcertpad
configuratievariabele, indien ingesteld, of de gecompileerde standaard van de ondersteunende SSL-bibliotheek
anders (wat op de meeste platforms de beste keuze zou moeten zijn).

--smtp-gebruiker=
Gebruikersnaam voor SMTP-AUTH. Standaard is de waarde van sendemail.smtpGebruiker; als een gebruikersnaam is
niet gespecificeerd (met --smtp-gebruiker or sendemail.smtpGebruiker), dan is authenticatie niet
geprobeerd.

--smtp-debug=0|1
Schakel (1) of deactiveer (0) debug-uitvoer in. Indien ingeschakeld, zijn SMTP-opdrachten en antwoorden:
gedrukt. Handig om TLS-verbindings- en authenticatieproblemen op te lossen.

automatiseren
--to-cmd=
Geef een opdracht op om één keer per patchbestand uit te voeren dat een patchbestand moet genereren
specifieke "Aan:"-items. De uitvoer van deze opdracht moet één e-mailadres per regel zijn.
Standaard is de waarde van verzendemail.tocmd configuratie waarde.

--cc-cmd=
Geef een opdracht op om één keer per patchbestand uit te voeren dat een patchbestand moet genereren
specifieke "Cc:"-items. De uitvoer van deze opdracht moet één e-mailadres per regel zijn.
Standaard is de waarde van verzendemail.ccCmd configuratie waarde.

--[geen-]ketenantwoord-op
Als dit is ingesteld, wordt elke e-mail verzonden als antwoord op de eerder verzonden e-mail. Indien
uitgeschakeld met "--no-chain-reply-to", alle e-mails na de eerste worden verzonden als
antwoorden op de eerste verzonden e-mail. Bij gebruik hiervan is het aan te raden om de eerste
bestand is een overzicht van de hele patchreeks. Standaard uitgeschakeld, maar de
sendemail.chainReplyTo configuratievariabele kan worden gebruikt om het in te schakelen.

--identity=
Een configuratie-identiteit. Wanneer gegeven, veroorzaakt waarden in de e-mail verzenden.
subsectie die voorrang heeft op waarden in de e-mail sturen sectie. De standaard
identiteit is de waarde van verzendemail.identiteit.

--[geen-]afgemeld-door-cc
Als dit is ingesteld, voegt u e-mails die zijn gevonden in Signed-off-by: of Cc:-regels toe aan de cc-lijst.
Standaard is de waarde van verzendemail.afgemelddoorcc configuratiewaarde; als dat zo is
niet gespecificeerd, standaard ingesteld op --signed-off-by-cc.

--[geen-]cc-cover
Als dit is ingesteld, worden e-mails gevonden in Cc: headers in de eerste patch van de serie
(meestal de begeleidende brief) worden toegevoegd aan de cc-lijst voor elke e-mailset. Standaard is
de waarde van verzendemail.cccover configuratiewaarde; als dat niet gespecificeerd is, standaard op
--geen-cc-cover.

--[geen-]te dekken
Als dit is ingesteld, worden e-mails gevonden in Aan: headers in de eerste patch van de serie
(meestal de begeleidende brief) worden toegevoegd aan de lijst voor elke e-mailset. Standaard is
de waarde van stuur een e-mail.naarcover configuratiewaarde; als dat niet gespecificeerd is, standaard op
--niet te dekken.

--suppress-cc=
Geef een extra categorie ontvangers op om de automatische cc te onderdrukken van:

· auteur zal vermijden om de auteur van de patch op te nemen

· zelf zal vermijden om de afzender op te nemen

· cc zal vermijden om iemand die wordt genoemd in Cc-regels in de patch-header op te nemen, behalve
voor zichzelf (gebruiken) zelf daarom).

· bodycc zal vermijden om iemand die wordt genoemd in Cc-regels in de patch-body op te nemen (commit
bericht) behalve voor mezelf (gebruik zelf daarom).

· snik zal vermijden om iemand op te nemen die wordt genoemd in de regels voor Afgemeld, behalve voor zichzelf
(gebruik zelf daarom).

· cccmd vermijdt het uitvoeren van de --cc-cmd.

· lichaam is gelijk aan snik + bodycc

· allen zal alle automatische cc-waarden onderdrukken.

Standaard is de waarde van verzendemail.suppresscc configuratiewaarde; als dat zo is
niet gespecificeerd, standaard op zelf als --suppress-from is opgegeven, evenals lichaam if
--no-signed-off-cc is opgegeven.

--[no-]onderdrukken-van
Als dit is ingesteld, voegt u het Van:-adres niet toe aan de cc:-lijst. Standaard is de waarde van
verzendemail.suppressFrom configuratiewaarde; als dat niet gespecificeerd is, standaard op
--geen-onderdrukken-van.

--[geen-]draad
Als dit is ingesteld, worden de headers In-Reply-To en References aan elke e-mail toegevoegd
verstuurd. Of elke e-mail verwijst naar de vorige e-mail (deep threading per git
formaat-patch formulering) of naar de eerste e-mail (ondiepe threading) wordt beheerst door:
"--[geen-]chain-reply-to".

Indien uitgeschakeld met "--no-thread", zullen die headers niet worden toegevoegd (tenzij gespecificeerd met
--als antwoord op). Standaard is de waarde van de verzendemail.thread configuratiewaarde; indien
dat is niet gespecificeerd, standaard ingesteld op --thread.

Het is aan de gebruiker om ervoor te zorgen dat er al geen In-Reply-To-header bestaat wanneer: git
e-mail verzenden wordt gevraagd om het toe te voegen (merk vooral op dat git formaat-patch kan worden geconfigureerd
om het inrijgen zelf te doen). Als u dit niet doet, levert dit mogelijk niet het verwachte resultaat op in:
de MUA van de ontvanger.

toedienen
--confirm=
Bevestig vlak voor verzending:

· altijd zal altijd bevestigen voor verzending

· nooit zal nooit bevestigen voor verzending

· cc zal bevestigen voordat het wordt verzonden wanneer de e-mail aan de verzend-e-mail automatisch adressen heeft toegevoegd
van de patch naar de Cc-lijst

· componeren zal bevestigen voordat het eerste bericht wordt verzonden bij gebruik van --compose.

· auto is gelijk aan cc + componeren

Standaard is de waarde van stuur een e-mail.bevestig configuratiewaarde; als dat niet gespecificeerd is,
standaard op auto tenzij een van de onderdrukkingsopties is opgegeven, in welk geval
standaard op componeren.

--oefening
Doe alles behalve de e-mails daadwerkelijk verzenden.

--[no-]format-patch
Wanneer een argument kan worden opgevat als een verwijzing of als een bestandsnaam, kies dan voor:
begrijp het als een format-patch-argument (--format-patch) of als bestandsnaam
(--no-format-patch). Wanneer een dergelijk conflict optreedt, zal git send-email standaard
mislukken.

--stil
Maak git-send-e-mail minder uitgebreid. Eén regel per e-mail zou alles moeten zijn dat wordt uitgevoerd.

--[nee-]valideren
Voer gezondheidscontroles uit op patches. Validatie betekent momenteel het volgende:

· Waarschuw voor patches die regels bevatten die langer zijn dan 998 tekens; dit komt door SMTP
limieten zoals beschreven door http://www.ietf.org/rfc/rfc2821.txt.

Standaard is de waarde van verzendemail.validate; als dit niet is ingesteld, standaard op --valideren.

--kracht
Stuur e-mails, zelfs als veiligheidscontroles dit zouden verhinderen.

Informatie
--dump-aliassen
In plaats van de normale bewerking, dumpt u de verkorte aliasnamen uit de geconfigureerde
aliasbestand(en), één per regel in alfabetische volgorde. Let op, dit omvat alleen de alias
naam en niet de uitgebreide e-mailadressen. Zien sendemail.aliasesbestand meer
informatie over aliassen.

CONFIGURATIE

sendemail.aliasesBestand
Om te voorkomen dat u lange e-mailadressen typt, verwijst u dit naar een of meer e-mailaliassenbestanden.
Je moet ook leveren sendemail.aliasFileType.

sendemail.aliasFileType
Formaat van het/de bestand(en) gespecificeerd in sendemail.aliasesFile. Moet een van zijn mormel, mailrc,
den, iepof walgingof Verzend mail.

Hoe een aliasbestand in elk formaat eruitziet, is te vinden in de documentatie van de
e-mailprogramma met dezelfde naam. De verschillen en beperkingen van de standaard
formaten worden hieronder beschreven:

Verzend mail

· Aangehaalde aliassen en aangehaalde adressen worden niet ondersteund: regels die een " bevatten
symbool worden genegeerd.

· Omleiding naar een bestand (/pad/naam) of pijp (|commando) wordt niet ondersteund.

· Bestandsopname (:include: /path/name) wordt niet ondersteund.

· Waarschuwingen worden afgedrukt op de standaardfoutuitvoer voor elke expliciete
niet-ondersteunde constructies en alle andere regels die niet worden herkend door de
ontleden.

verzendemail.multiEdit
Indien waar (standaard), wordt een enkele editor-instantie voortgebracht om bestanden te bewerken die u moet
bewerken (patches wanneer --annoteren wordt gebruikt, en de samenvatting wanneer --componeren is gebruikt). Indien
false, worden bestanden de een na de ander bewerkt, waardoor elke keer een nieuwe editor ontstaat.

stuur een e-mail.bevestig
Stelt de standaard in voor het al dan niet bevestigen voor verzending. Moet een van zijn altijd, nooit,
cc, componerenof auto. Zien --bevestigen in het vorige gedeelte voor de betekenis hiervan
waarden.

VOORBEELD

Te gebruiken gmail as de smtp server
Te gebruiken git e-mail verzenden om uw patches via de Gmail SMTP-server te verzenden, bewerk
~ / .gitconfig om uw accountinstellingen op te geven:

[verstuur een e-mail]
smtpEncryptie = tls
smtpServer = smtp.gmail.com
smtpGebruiker = [e-mail beveiligd]
smtpServerPort = 587

Zodra je commits klaar zijn om naar de mailinglijst te worden gestuurd, voer je de volgende opdrachten uit:

$ git format-patch --sollicitatiebrief -M origin/master -o uitgaand/
$ bewerken uitgaand/0000-*
$ git verzend-e-mail uitgaand/*

Opmerking: de volgende perl-modules zijn vereist Net::SMTP::SSL, MIME::Base64 en
Authentiek::SASL

Gebruik git-send-e-mail online met onworks.net-services