Granska och redigera varje patch du ska skicka. Standardvärdet är sendemail.annotate. Se avsnittet KONFIGURATION för sendemail.multiEdit.

Ange ett Bcc:-värde för varje e-postmeddelande. Standardvärdet är sendemail.bcc.

Ange ett startvärde för Cc: för varje e-postadress. Standardvärdet är sendemail.cc.

Anropa en textredigerare (se GIT_EDITOR i git-var[1]) för att redigera ett introduktionsmeddelande för patchserien.

Ange avsändaren för e-postmeddelandena. Om det inte anges på kommandoraden används värdet för konfigurationsalternativet sendemail.from. Om varken kommandoradsalternativet eller sendemail.from är inställda kommer användaren att bli ombedd att ange värdet. Standardvärdet för ledtexten är värdet GIT_AUTHOR_IDENT, eller GIT_COMMITTER_IDENT om det inte är inställt, vilket returneras av git var -l.

Ange adressen dit svar från mottagare ska skickas. Använd detta om svar på meddelanden ska skickas till en annan adress än den som anges med parametern --from.

Få det första mejlet (eller alla mejl med --no-thread) att visas som ett svar på det angivna meddelande-ID:t, vilket undviker att trådar bryts för att skapa en ny patchserie. Det andra och efterföljande mejlen skickas som svar enligt inställningen --[no-]chain-reply-to.

[PATCH 0/2] Här är vad jag gjorde...
  [PATCH 1/2] Uppstädning och tester
  [PATCH 2/2] Implementering
  [PATCH v2 0/3] Här är en omrullning
    [PATCH v2 1/3] Uppstädning
    [PATCH v2 2/3] Nya tester
    [PATCH v2 3/3] Implementering

Microsoft Outlook SMTP-servrar ignorerar meddelande-ID:t som skickas via e-post och tilldelar ett nytt slumpmässigt meddelande-ID, vilket bryter trådar.

Ange det första ämnet för e-posttråden. Endast nödvändigt om --compose också är angivet. Om --compose inte är angivet kommer detta att efterfrågas.

Ange den primära mottagaren av de genererade e-postmeddelandena. I allmänhet är detta uppströmsförvaltaren av det berörda projektet. Standardvärdet är konfigurationsvärdet sendemail.to; om det inte är angivet och --to-cmd inte är angivet kommer detta att efterfrågas.

När du stöter på ett icke-ASCII-meddelande eller ämne som inte deklarerar sin kodning, lägg till huvuden/citat för att indikera att det är kodat i <kodning>. Standardvärdet är värdet för sendemail.assume8bitEncoding; om det inte är angivet kommer detta att efterfrågas om några icke-ASCII-filer påträffas.

Ange kodning för meddelandet. Standardvärdet är värdet för sendemail.composeEncoding; om det inte är angivet antas UTF-8.

Ange den överföringskodning som ska användas för att skicka meddelandet via SMTP. 7bit kommer att misslyckas vid påträffande av ett icke-ASCII-meddelande. quoted-printable kan vara användbart när kodförrådet innehåller filer som innehåller vagnreturer, men gör den råa patch-e-postfilen (som sparad från en MUA) mycket svårare att inspektera manuellt. base64 är ännu mer felsäker, men också ännu mer svårtolkad. auto kommer att använda 8bit när det är möjligt, och quoted-printable annars.

Lägg till (eller förhindra att du lägger till) X-Mailer:-huvud. Som standard läggs huvudet till, men den kan stängas av genom att ställa in konfigurationsvariabeln sendemail.xmailer till false.

Ange kuvertavsändaren som används för att skicka e-postmeddelandena. Detta är användbart om din standardadress inte är den adress som prenumererar på en lista. För att använda From-adressen ställer du in värdet till auto. Om du använder binärfilen sendmail måste du ha lämpliga behörigheter för parametern -f. Standardvärdet är värdet för konfigurationsvariabeln sendemail.envelopeSender; om den inte är angiven är det din MTA som väljer kuvertavsändare.

Ange ett kommando som ska köras för att skicka e-postmeddelandet. Kommandot bör vara sendmail-liknande; det måste uttryckligen stödja alternativet -i. Kommandot kommer att köras i skalet om det behövs. Standardvärdet är sendemail.sendmailCmd. Om det inte är angivet, och om --smtp-server inte heller är angivet, kommer git send-email att söka efter sendmail i /usr/sbin, /usr/lib och $PATH.

Ange på vilket sätt krypteringen börjar för SMTP-anslutningen. Giltiga värden är ssl och tls. Alla andra värden återgår till vanlig (okrypterad) SMTP, vilket som standard är port 25. Trots namnen kommer båda värdena att använda samma nyare version av TLS, men av historiska skäl har de dessa namn. ssl hänvisar till "implicit" kryptering (ibland kallad SMTPS), som använder port 465 som standard. tls hänvisar till "explicit" kryptering (ofta känd som STARTTLS), som använder port 25 som standard. Andra portar kan användas av SMTP-servern, vilka inte är standard. En vanlig alternativ port för tls och okrypterad är 587. Du måste kontrollera din leverantörs dokumentation eller din serverkonfiguration för att säkerställa ditt eget fall. Standardvärdet är värdet för sendemail.smtpEncryption.

Ange det fullständigt kvalificerade domännamnet (FQDN) som används i HELO/EHLO-kommandot till SMTP-servern. Vissa servrar kräver att FQDN matchar din IP-adress. Om den inte är inställd försöker git send-email att bestämma ditt FQDN automatiskt. Standardvärdet är sendemail.smtpDomain.

Blankteckenavgränsad lista över tillåtna SMTP-AUTH-mekanismer. Denna inställning tvingar fram användning av endast de listade mekanismerna. Exempel:

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

Lösenord för SMTP-AUTH. Argumentet är valfritt: Om inget argument anges används den tomma strängen som lösenord. Standardvärdet är sendemail.smtpPass, men --smtp-pass åsidosätter alltid detta värde.

Inaktivera SMTP-autentisering. Förkortning för --smtp-auth=none.

Ange vilken utgående SMTP-server som ska användas (t.ex. smtp.example.com eller en rå IP-adress). Om detta inte är angivet, och om --sendmail-cmd inte heller är angivet, är standardinställningen att söka efter sendmail i /usr/sbin, /usr/lib och $PATH om ett sådant program är tillgängligt, och annars använda localhost.

Ange en annan port än standardporten (SMTP-servrar lyssnar vanligtvis på smtp-port 25, men kan också lyssna på submission-port 587, eller den vanliga SSL-smtp-porten 465); symboliska portnamn (t.ex. submission i stället för 587) accepteras också. Porten kan också ställas in med konfigurationsvariabeln sendemail.smtpServerPort.

Ange vilket serveralternativ för utgående SMTP som ska användas. Standardvärdet kan anges med konfigurationsalternativet sendemail.smtpServerOption.

Äldre alias för --smtp-encryption ssl.

Sökväg till ett lager med betrodda CA-certifikat för SMTP SSL/TLS-certifikatvalidering (antingen en katalog som har bearbetats av c_rehash, eller en enda fil som innehåller ett eller flera PEM-formatcertifikat sammanfogade: se beskrivningen av alternativen -CAfile <fil> och -CApath <kat> på https://docs.openssl.org/master/man1/openssl-verify/ [OpenSSLs manualsida för verify(1)] för mer information om dessa). Ställ in den till en tom sträng för att inaktivera certifikatverifiering. Standardvärdet är värdet för konfigurationsvariabeln sendemail.smtpSSLCertPath, om den är inställd, eller annars det stödjande SSL-bibliotekets kompilerade standardvärde (vilket borde vara det bästa valet på de flesta plattformar).

Användarnamn för SMTP-AUTH. Standardvärdet är sendemail.smtpUser; om ett användarnamn inte anges (med --smtp-user eller sendemail.smtpUser) görs inget autentiseringsförsök.

Aktivera (1) eller inaktivera (0) felsökningsutdata. Om aktiverat kommer SMTP-kommandon och svar att skrivas ut. Användbart för att felsöka TLS-anslutnings- och autentiseringsproblem.

Vissa e-postleverantörer (t.ex. iCloud) skickar inte en kopia av e-postmeddelanden som skickas med SMTP till mappen "Skickat" eller liknande i din inkorg. Använd det här alternativet för att använda git imap-send för att skicka en kopia av e-postmeddelandena till den mapp som anges med det här alternativet. Du kan köra git imap-send --list för att få en lista med giltiga mappnamn, inklusive det korrekta namnet på mappen "Skickat" i din inkorg. Du kan också använda det här alternativet för att skicka e-postmeddelanden till en dedikerad IMAP-mapp som du väljer.

Om detta är inställt kommer alla e-postmeddelanden endast att kopieras till IMAP-mappen som anges med --imap-sent-folder eller sendemail.imapSentFolder och kommer inte att skickas till mottagarna. Användbart om du bara vill skapa ett utkast av e-postmeddelandena och använda en annan e-postklient för att skicka dem. Om det inaktiveras med --no-use-imap-only kommer e-postmeddelandena att skickas som vanligt. Inaktiverat som standard, men konfigurationsvariabeln sendemail.useImapOnly kan användas för att aktivera den.

Vissa e-postservrar (t.ex. smtp.163.com) begränsar antalet e-postmeddelanden som kan skickas per session (anslutning), vilket leder till fel när många meddelanden skickas. Med det här alternativet kopplar send-email bort efter att <num> meddelanden har skickats, väntar i några sekunder (se --relogin-delay) och återansluter för att kringgå en sådan gräns. Du kanske vill använda någon form av autentiseringshjälpare för att slippa skriva in ditt lösenord varje gång detta händer. Standardinställningen är konfigurationsvariabeln sendemail.smtpBatchSize.

Väntar <int> sekunder innan återanslutning till SMTP-servern. Används tillsammans med alternativet --batch-size. Standardinställningen är konfigurationsvariabeln sendemail.smtpReloginDelay.

Rensa alla listor med adresser som tidigare ställts in via konfigurationen, som Till:, Cc: och Bcc:.

Rensa det tidigare lästa värdet för sendemail.identity som ställts in via konfigurationen, om sådan finns.

Ange ett kommando som ska köras en gång per patchfil och som ska generera specifika Till:-poster. Utdata från kommandot måste bestå av en enda e-postadress per rad. Standardvärdet är värdet i konfigurationsvariabeln sendemail.toCmd.

Ange ett kommando som ska köras en gång per patchfil och som ska generera specifika Cc:-poster. Utdata från kommandot måste bestå av en enda e-postadress per rad. Standardvärdet är värdet i konfigurationsvariabeln sendemail.ccCmd.

Ange ett kommando som körs en gång per utgående meddelande och som skriver ut rubrikrader i RFC 2822-stil som ska infogas i meddelandena. När konfigurationsvariabeln sendemail.headerCmd är satt används dess värde alltid. När --header-cmd anges på kommandoraden har dess värde företräde framför konfigurationsvariabeln sendemail.headerCmd.

Inaktivera eventuella rubrikkommandon som används.

Om detta är inställt kommer varje e-postmeddelande att skickas som ett svar på det föregående skickade e-postmeddelandet. Om det inaktiveras med --no-chain-reply-to kommer alla e-postmeddelanden efter det första att skickas som svar på det första skickade e-postmeddelandet. När du använder detta rekommenderas det att den första filen som anges är en översikt över hela patchserien. Inaktiverat som standard, men konfigurationsvariabeln sendemail.chainReplyTo kan användas för att aktivera den.

En konfigurationsidentitet. När den anges, gör den att värden i underavsnittet sendemail.<identitet> prioriteras framför värden i avsnittet sendemail. Standardidentiteten är värdet för sendemail.identity.

Om detta är inställt, lägg till e-postadresser som finns i Signed-off-by-slutraden eller Cc:-raderna i cc-listan. Standardvärdet är konfigurationsvärdet sendemail.signedOffByCc; om det inte är angivet används --signed-off-by-cc som standard.

Om detta är inställt, läggs e-postmeddelanden som finns i Cc:-huvuden i den första patchen i serien (vanligtvis följebrevet) till i cc-listan för varje e-postmeddelande i serien. Standardvärdet är värdet för konfigurationsvärdet sendemail.ccCover; om det inte är angivet, används --no-cc-cover som standard.

Om detta är inställt läggs e-postadresser som finns i To:-huvuden i den första patchen i serien (vanligtvis följebrevet) till i mottagarlistan för varje e-postmeddelande i serien. Standardvärdet är konfigurationsvärdet sendemail.toCover; om det inte är angivet används --no-to-cover som standard.

Ange ytterligare en kategori av mottagare för att undertrycka automatisk-cc av:

Om detta är inställt, lägg inte till From:-adressen i Cc:-listan. Standardvärdet är konfigurationsvärdet sendemail.suppressFrom; om det inte är angivet används --no-suppress-from som standard.

Om detta är inställt, kommer huvudena In-Reply-To och References att läggas till i varje e-postmeddelande som skickas. Huruvida varje e-postmeddelande refererar till föregående e-postmeddelande (djup trådning enligt git format-patch formulering) eller till det första e-postmeddelandet (grund trådning) styrs av --[no-]chain-reply-to.

Använd mailmap-filen (se gitmailmap[5]) för att mappa alla adresser till deras kanoniska riktiga namn och e-postadress. Ytterligare mailmap-data specifik för git send-email kan tillhandahållas med hjälp av konfigurationsvärdena sendemail.mailmap.file eller sendemail.mailmap.blob. Standardvärdet är sendemail.mailmap.

Bekräfta precis innan du skickar:

Gör allt utom att faktiskt skicka e-postmeddelandena.

När ett argument kan tolkas antingen som en referens eller som ett filnamn, välj att tolka det som ett format-patch-argument (--format-patch) eller som ett filnamn (--no-format-patch). Som standard misslyckas git send-email när en sådan konflikt uppstår.

Gör git send-email mindre utförligt. En rad per e-postmeddelande ska vara allt som matas ut.

Utför rimlighetskontroller på patchar. För närvarande, innebär validering följande:

Skicka e-post även om säkerhetskontroller skulle förhindra det.

I stället för den normala åtgärden, skriv ut de förkortade aliasnamnen från de konfigurerade aliasfilerna, ett per rad i alfabetisk ordning. Observera att detta endast visar aliasnamnet och inte dess expanderade e-postadresser. Se sendemail.aliasesFile för mer information om alias.

I stället för den normala åtgärden, läs från standardinmatningen och tolka varje rad som ett e-postalias. Översätt det enligt den/de konfigurerade aliasfilen/filerna. Skriv ut varje översatt namn och e-postadress till standardutmatning, ett per rad. Se sendemail.aliasFile för mer information om alias.