git-send-email - Online nel cloud

PROGRAMMA:

NOME

git-send-email - Invia una raccolta di patch come email

SINOSSI

git invia una email [opzioni] ...
git invia una email --dump-alias

DESCRIZIONE

Prende le patch fornite sulla riga di comando e le invia via email. È possibile specificare le patch
come file, directory (che invierà tutti i file nella directory) o direttamente come a
elenco revisioni. Nell'ultimo caso, qualsiasi formato accettato da git-formato-patch(1) può essere superato
a git send-email.

L'intestazione dell'e-mail è configurabile tramite le opzioni della riga di comando. Se non specificato nel
riga di comando, all'utente verrà richiesto con un'interfaccia abilitata ReadLine di fornire il file
informazione necessaria.

Sono accettati due formati per i file patch:

1. file in formato mbox

Questo è ciò git-formato-patch(1) genera. La maggior parte delle intestazioni e della formattazione MIME lo sono
ignorato.

2. Il formato originale utilizzato da Greg Kroah-Hartman send_lots_of_email.pl copione

Questo formato prevede che la prima riga del file contenga il valore "Cc:" e il file
"Oggetto:" del messaggio come seconda riga.

VERSIONI

Composizione
--annotare
Rivedi e modifica ogni patch che stai per inviare. L'impostazione predefinita è il valore di
sendemail.annotate. Consulta la sezione CONFIGURAZIONE per sendemail.multiModifica.

--bcc=,...
Specificare un valore "Ccn:" per ogni email. L'impostazione predefinita è il valore di sendemail.bcc.

Questa opzione può essere specificata più volte.

--cc=,...
Specificare un valore "Cc:" iniziale per ogni email. L'impostazione predefinita è il valore di sendemail.cc.

Questa opzione può essere specificata più volte.

--comporre
Richiama un editor di testo (vedi GIT_EDITOR in git-var(1)) per modificare un messaggio introduttivo
per la serie di patch.

Quando --comporre viene utilizzato, git send-email utilizzerà Da, Oggetto e In-Reply-To
intestazioni specificate nel messaggio. Se il corpo del messaggio (quello che digiti dopo il
intestazioni e una riga vuota) contiene solo righe vuote (o Git: prefisso), il riepilogo
non verranno inviati, ma verranno utilizzate le intestazioni From, Object e In-Reply-To, a meno che non lo siano
rimosso.

Verranno richieste le intestazioni From o In-Reply-To mancanti.

Consulta la sezione CONFIGURAZIONE per sendemail.multiModifica.

--from=
Specificare il mittente delle email. Se non specificato sulla riga di comando, il valore di
, il sendemail.from viene utilizzata l'opzione di configurazione. Se né l'opzione della riga di comando
né sendemail.from sono impostati, all'utente verrà richiesto il valore. Il predefinito
per il prompt sarà il valore di GIT_AUTHOR_IDENT o GIT_COMMITTER_IDENT se quello
non è impostato, come restituito da "git var -l".

--in-reply-to=
Fai apparire la prima mail (o tutte le mail con --no-thread) come risposta al dato
Message-Id, che evita l'interruzione dei thread per fornire una nuova serie di patch. Il secondo
e le email successive verranno inviate come risposte secondo --[no]-chain-reply-to
impostazione.

Quindi, ad esempio, quando vengono specificati --thread e --no-chain-reply-to, il secondo and
le patch successive saranno risposte alla prima come nell'illustrazione seguente
dove [PATCH v2 0/3] è in risposta a [PATCH 0/2]:

[PATCH 0/2] Ecco cosa ho fatto...
[PATCH 1/2] Ripulitura e test
[PATCH 2/2] Implementazione
[PATCH v2 0/3] Ecco un reroll
[PATCH v2 1/3] Pulisci
[PATCH v2 2/3] Nuovi test
[PATCH v2 3/3] Implementazione

Necessario solo se è impostato anche --compose. Se --compose non è impostato, lo sarà
richiesto per.

--oggetto=
Specificare l'oggetto iniziale del thread di posta elettronica. Necessario solo se lo è anche --compose
impostato. Se --compose non è impostato, verrà richiesto.

--to=,...
Specificare il destinatario principale delle email generate. Generalmente, questo sarà il
manutentore a monte del progetto coinvolto. L'impostazione predefinita è il valore di sendemail.to
valore di configurazione; se questo non è specificato e --to-cmd non è specificato, lo farà
essere richiesto.

Questa opzione può essere specificata più volte.

--8bit-encoding=
Quando incontri un messaggio o un oggetto non ASCII che non dichiara la sua codifica,
aggiungi intestazioni/virgolette per indicare che è codificato in . L'impostazione predefinita è il valore di
, il sendemail.assume8bitEncoding; se non è specificato, verrà richiesto se
vengono rilevati file non ASCII.

Si noti che non viene effettuato alcun tentativo per convalidare la codifica.

--compose-encoding=
Specificare la codifica del messaggio di composizione. L'impostazione predefinita è il valore di
sendemail.composeencoding; se non è specificato, si presuppone UTF-8.

--transfer-encoding=(7bit|8bit|quoted-printable|base64)
Specificare la codifica di trasferimento da utilizzare per inviare il messaggio tramite SMTP. 7bit fallirà
quando si incontra un messaggio non ASCII. quoted-printable può essere utile quando il file
repository contiene file che contengono ritorni a capo, ma invia tramite email la patch non elaborata
file (come salvato da un MUA) molto più difficile da ispezionare manualmente. base64 è ancora più stupido
prova, ma anche ancora più opaca. L'impostazione predefinita è il valore di
sendemail.transferEncoding valore di configurazione; se non è specificato, verrà utilizzato da git
8 bit e non aggiungere un'intestazione Content-Transfer-Encoding.

--xmailer, --no-xmailer
Aggiungi (o impedisci di aggiungere) l'intestazione "X-Mailer:". Per impostazione predefinita, viene aggiunta l'intestazione, ma
può essere disattivato impostando la variabile di configurazione sendemail.xmailer su false.

invio
--envelope-sender=
Specificare il mittente della busta utilizzato per inviare le e-mail. Questo è utile se il tuo file default
L'indirizzo non è l'indirizzo iscritto a un elenco. Per poter utilizzare il Da
indirizzo, impostare il valore su "auto". Se usi il binario sendmail, devi averlo
privilegi adeguati per il parametro -f. L'impostazione predefinita è il valore di
sendemail.envelopeSender variabile di configurazione; se non è specificato, scegliendo the
il mittente della busta viene lasciato al tuo MTA.

--smtp-encryption=
Specificare anche la crittografia da utilizzare ssl or tls. Qualsiasi altro valore torna normale
SMTP. L'impostazione predefinita è il valore di sendemail.smtpEncryption.

--smtp-domain=
Specifica il nome di dominio completo (FQDN) utilizzato nel comando HELO/EHLO al file
server SMTP. Alcuni server richiedono che l'FQDN corrisponda al tuo indirizzo IP. Se non impostato, git
send-email tenta di determinare automaticamente il tuo FQDN. L'impostazione predefinita è il valore di
sendemail.smtpDominio.

--smtp-auth=
Elenco separato da spazi dei meccanismi SMTP-AUTH consentiti. Questa impostazione forza l'utilizzo
solo i meccanismi elencati. Esempio:

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

Se almeno uno dei meccanismi specificati corrisponde a quelli pubblicizzati dall'SMTP
server e se è supportato dalla libreria SASL utilizzata, viene utilizzato il meccanismo
autenticazione. Se nessuno dei due sendemail.smtpAuth né --smtp-auth è specificato, tutto
possono essere utilizzati meccanismi supportati dalla libreria SASL.

--smtp-pass[=]
Password per autenticazione SMTP. L'argomento è facoltativo: se non viene specificato alcun argomento, allora
la stringa vuota viene utilizzata come password. L'impostazione predefinita è il valore di sendemail.smtpPass,
tuttavia --smtp-pass sovrascrive sempre questo valore.

Inoltre, non è necessario specificare le password nei file di configurazione o nel comando
linea. Se è stato specificato un nome utente (con --smtp-utente o sendemail.smtpUtente), ma
non è stata specificata alcuna password (con --smtp-pass or sendemail.smtpPass), poi un
la password si ottiene utilizzando git-credenziali.

--smtp-server=
Se impostato, specifica il server SMTP in uscita da utilizzare (ad esempio smtp.example.com o un IP non elaborato
indirizzo). In alternativa può specificare il percorso completo di un programma simile a sendmail
Invece; il programma deve supportare l'opzione -i. Il valore predefinito può essere specificato da
sendemail.smtpServer opzione di configurazione; l'impostazione predefinita integrata è /usr/sbin/sendmail
or /usr/lib/sendmail se tale programma è disponibile, altrimenti localhost.

--smtp-server-port=
Specifica una porta diversa dalla porta predefinita (solitamente i server SMTP ascoltano
porta smtp 25, ma può anche ascoltare la porta di invio 587 o la porta smtp SSL comune
465); Sono accettati anche nomi di porta simbolici (ad esempio "submission" invece di 587). IL
la porta può essere impostata anche con sendemail.smtpServerPort configurazione variabile.

--smtp-server-opzione=
Se impostato, specifica l'opzione del server SMTP in uscita da utilizzare. Il valore predefinito può essere
specificato dal sendemail.smtpServerOption opzione di configurazione.

L'opzione --smtp-server-option deve essere ripetuta per ogni opzione a cui desideri passare
il server. Allo stesso modo, per ciascuno devono essere utilizzate righe diverse nei file di configurazione
opzione.

--smtp-ssl
Alias ​​legacy per --crittografia-smtp ssl.

--smtp-ssl-percorso-cert
Percorso a un archivio di certificati CA attendibili per la convalida del certificato SMTP SSL/TLS
(o una directory che è stata elaborata da c_rehasho un singolo file contenente
uno o più certificati in formato PEM concatenati tra loro: cfr verificare(1) -CAfile e
-CApath per ulteriori informazioni su questi). Impostalo su una stringa vuota per disabilitarlo
verifica del certificato. Il valore predefinito è il sendemail.smtpsslcertpath
variabile di configurazione, se impostata, o il valore predefinito compilato della libreria SSL di supporto
altrimenti (che dovrebbe essere la scelta migliore sulla maggior parte delle piattaforme).

--smtp-utente=
Nome utente per SMTP-AUTH. L'impostazione predefinita è il valore di sendemail.smtpUtente; se un nome utente è
non specificato (con --smtp-utente or sendemail.smtpUtente), l'autenticazione non lo è
tentato.

--smtp-debug=0|1
Abilita (1) o disabilita (0) l'output di debug. Se abilitato, i comandi e le risposte SMTP saranno
stampato. Utile per eseguire il debug dei problemi di connessione e autenticazione TLS.

Automatizzare
--to-cmd=
Specificare un comando da eseguire una volta per ogni file di patch che dovrebbe generare un file di patch
voci "A:" specifiche. L'output di questo comando deve essere un singolo indirizzo email per riga.
L'impostazione predefinita è il valore di sendemail.tocmd valore di configurazione.

--cc-cmd=
Specificare un comando da eseguire una volta per ogni file di patch che dovrebbe generare un file di patch
voci "Cc:" specifiche. L'output di questo comando deve essere un singolo indirizzo email per riga.
L'impostazione predefinita è il valore di sendemail.ccCmd valore di configurazione.

--[no-]catena-di-risposta-a
Se impostato, ogni email verrà inviata come risposta all'email inviata precedente. Se
disabilitato con "--no-chain-reply-to", tutte le email successive alla prima verranno inviate come
risposte alla prima email inviata. Quando si utilizza questo, si consiglia il primo
file fornito una panoramica dell'intera serie di patch. Disabilitato per impostazione predefinita, ma il file
sendemail.chainReplyTo la variabile di configurazione può essere utilizzata per abilitarlo.

--identity=
Un'identità di configurazione. Quando fornito, provoca i valori in sendemail.
sottosezione per avere la precedenza sui valori in invia una email sezione. Il predefinito
l'identità è il valore di sendemail.identity.

--[no-]firmato-da-cc
Se questa opzione è impostata, aggiungi i messaggi di posta elettronica trovati nelle righe Firmato da: o Cc: all'elenco cc.
L'impostazione predefinita è il valore di sendemail.signedoffbycc valore di configurazione; se è così
non specificato, predefinito su --signed-off-by-cc.

--[no-]cc-copertina
Se questa opzione è impostata, i messaggi di posta elettronica verranno trovati nelle intestazioni Cc: nella prima patch della serie
(in genere la lettera di accompagnamento) vengono aggiunti all'elenco cc per ciascun set di email. L'impostazione predefinita è
il valore di sendemail.cccover valore di configurazione; se non è specificato, il valore predefinito è
--no-cc-copertina.

--[no-]da-coprire
Se questa opzione è impostata, i messaggi di posta elettronica si trovano nelle intestazioni A: nella prima patch della serie
(in genere la lettera di accompagnamento) vengono aggiunti all'elenco di indirizzi per ciascun set di email. L'impostazione predefinita è
il valore di sendemail.tocover valore di configurazione; se non è specificato, il valore predefinito è
--no-da-coprire.

--suppress-cc=
Specificare un'ulteriore categoria di destinatari per eliminare il cc automatico di:

· autore eviterà di includere l'autore della patch

· auto eviterà di includere il mittente

· cc eviterà di includere chiunque sia menzionato nelle righe Cc nell'intestazione della patch tranne
per sé (usare auto per quello).

· bodycc eviterà di includere chiunque sia menzionato nelle righe Cc nel corpo della patch (commit
messaggio) tranne che per sé (use auto per quello).

· singhiozzo eviterà di includere chiunque sia menzionato nelle righe Firmato da tranne se stesso
(uso auto per quello).

· cccmd eviterà di eseguire --cc-cmd.

· stile di vita è equivalente singhiozzo + bodycc

· contro tutti i sopprimerà tutti i valori auto cc.

L'impostazione predefinita è il valore di sendemail.suppresscc valore di configurazione; se è così
non specificato, predefinito auto se è specificato --suppress-from, nonché stile di vita if
--no-signed-off-cc è specificato.

--[no-]sopprimi-da
Se è impostato, non aggiungere l'indirizzo Da: all'elenco cc:. L'impostazione predefinita è il valore di
sendemail.suppressFrom valore di configurazione; se non è specificato, il valore predefinito è
--no-sopprimi-da.

--[no-]thread
Se questa opzione è impostata, le intestazioni In-Reply-To e Riferimenti verranno aggiunte a ciascuna email
inviato. Se ogni email fa riferimento all'email precedente (threading profondo per git
formato-patch formulazione) o alla prima e-mail (threading superficiale) è regolato da
"--[no-]catena-di-risposta-a".

Se disabilitate con "--no-thread", tali intestazioni non verranno aggiunte (a meno che non siano specificate con
--in risposta a). L'impostazione predefinita è il valore di sendemail.thread valore di configurazione; Se
che non è specificato, il valore predefinito è --thread.

Spetta all'utente assicurarsi che non esista già alcuna intestazione In-Reply-To quando git
invia una email viene chiesto di aggiungerlo (in particolare si noti che git formato-patch può essere configurato
per eseguire l'infilatura stessa). In caso contrario, potrebbe non produrre il risultato atteso
il MUA del destinatario.

Amministrazione
--conferma=
Conferma poco prima dell'invio:

· sempre confermerà sempre prima dell'invio

· mai non confermerà mai prima dell'invio

· cc confermerà prima dell'invio quando l'e-mail di invio avrà aggiunto automaticamente gli indirizzi
dalla patch all'elenco Cc

· comporre confermerà prima di inviare il primo messaggio quando si utilizza --compose.

· auto è equivalente cc + comporre

L'impostazione predefinita è il valore di sendemail.conferma valore di configurazione; se non è specificato,
predefinito su auto a meno che non sia stata specificata una delle opzioni di soppressione, nel qual caso
predefinito su comporre.

--funzionamento a secco
Fai tutto tranne inviare effettivamente le e-mail.

--[no-]patch di formato
Quando un argomento può essere interpretato come un riferimento o come un nome di file, scegli di farlo
interpretarlo come un argomento di formattazione (--format-patch) o come nome file
(--no-patch-formato). Per impostazione predefinita, quando si verifica un conflitto di questo tipo, git send-email lo farà
fallire.

--silenzioso
Rendi git-send-email meno dettagliato. L'output dovrebbe essere solo una riga per e-mail.

--[no-]convalidare
Esegui controlli di integrità sulle patch. Attualmente, la convalida significa quanto segue:

· Avvisa di patch che contengono righe più lunghe di 998 caratteri; ciò è dovuto a SMTP
limiti come descritto da http://www.ietf.org/rfc/rfc2821.txt.

L'impostazione predefinita è il valore di sendemail.validate; se non è impostato, il valore predefinito è --convalidare.

--vigore
Invia e-mail anche se i controlli di sicurezza lo impedirebbero.

Informazioni
--dump-alias
Invece della normale operazione, scarica i nomi alias abbreviati dal file configurato
file alias, uno per riga in ordine alfabetico. Nota: questo include solo l'alias
nome e non i suoi indirizzi email espansi. Vedere sendemail.aliasesfile per maggiori
informazioni sugli alias.

CONFIGURAZIONE

sendemail.aliasesFile
Per evitare di digitare indirizzi email lunghi, indirizzalo a uno o più file di alias email.
Devi anche fornire sendemail.aliasFileType.

sendemail.aliasFileType
Formato dei file specificati in sendemail.aliasesFile. Deve essere uno di cane bastardo, mailrc,
pino, olmo, o gnu, o sendmail.

L'aspetto di un file alias in ciascun formato può essere trovato nella documentazione del file
programma di posta elettronica con lo stesso nome. Le differenze e le limitazioni rispetto allo standard
i formati sono descritti di seguito:

sendmail

· Gli alias e gli indirizzi tra virgolette non sono supportati: righe che contengono un "
simbolo vengono ignorati.

· Il reindirizzamento a un file (/percorso/nome) o a una pipe (|comando) non è supportato.

· L'inclusione di file (:include: /percorso/nome) non è supportata.

· Gli avvisi vengono stampati esplicitamente sull'output degli errori standard
costrutti non supportati e qualsiasi altra riga non riconosciuta dal file
analizzatore.

sendemail.multiModifica
Se vero (impostazione predefinita), verrà generata una singola istanza dell'editor per modificare i file necessari
modifica (patch quando --annotare viene utilizzato e il riepilogo quando --comporre si usa). Se
false, i file verranno modificati uno dopo l'altro, generando ogni volta un nuovo editor.

sendemail.conferma
Imposta l'impostazione predefinita per la conferma prima dell'invio. Deve essere uno di sempre, mai,
cc, comporre, o auto. Vedere --Confermare nella sezione precedente per il loro significato
valori.

ESEMPIO

Usa il gmail as , il smtp server
Per utilizzare git invia una email per inviare le tue patch tramite il server SMTP di GMail, modifica
~ / .gitconfig per specificare le impostazioni dell'account:

[invia una email]
smtpEncryption = tls
smtpServer = smtp.gmail.com
utente smtp = [email protected]
smtpServerPort = 587

Una volta che i tuoi commit sono pronti per essere inviati alla mailing list, esegui i seguenti comandi:

$ git format-patch --cover-letter -M origin/master -o outgoing/
$ modifica in uscita/0000-*
$ git invia-e-mail in uscita/*

Nota: sono richiesti i seguenti moduli perl Net::SMTP::SSL, MIME::Base64 e
Autentico::SASL

Utilizza git-send-email online utilizzando i servizi onworks.net