git-send-email - Online w chmurze

PROGRAM:

IMIĘ

git-send-email - Wyślij kolekcję poprawek jako e-mail

STRESZCZENIE

odrzutowiec wysłać email [opcje] ...
odrzutowiec wysłać email --dump-aliasy

OPIS

Pobiera poprawki podane w wierszu poleceń i wysyła je e-mailem. Można określić poprawki
jako pliki, katalogi (które wyślą wszystkie pliki w katalogu) lub bezpośrednio jako plik
lista rewizji. W tym ostatnim przypadku dowolny format akceptowany przez łatka w formacie git(1) może zostać zaliczony
aby git wysłać e-mail.

Nagłówek wiadomości e-mail można skonfigurować za pomocą opcji wiersza poleceń. Jeśli nie określono na
wiersza poleceń, użytkownik zostanie poproszony o udostępnienie interfejsu obsługującego ReadLine
niezbędne informacje.

Akceptowane są dwa formaty plików poprawek:

1. pliki w formacie mbox

Co to jest łatka w formacie git(1) generuje. Większość nagłówków i formatowania MIME to
ignorowane.

2. Oryginalny format używany przez Grega Kroaha-Hartmana send_lots_of_email.pl scenariusz

Ten format oczekuje, że pierwsza linia pliku będzie zawierać wartość „Cc:” i rozszerzenie
„Temat:” wiadomości jako drugi wiersz.

OPCJE

Uspokajający
--komentować
Przejrzyj i edytuj każdą łatkę, którą masz zamiar wysłać. Wartość domyślna to wartość
wyślij e-mail.adnotuj. Patrz rozdział KONFIGURACJA wyślij e-mail.multiEdytuj.

--bcc= ,...
Określ wartość „UDW:” dla każdego e-maila. Wartość domyślna to wartość wyślij e-mail.bcc.

Opcję tę można określić wielokrotnie.

--cc= ,...
Określ początkową wartość „DW:” dla każdego e-maila. Wartość domyślna to wartość wyślij e-mail.cc.

Opcję tę można określić wielokrotnie.

--komponować
Wywołaj edytor tekstu (zobacz GIT_EDITOR w git-var(1)), aby edytować wiadomość wprowadzającą
dla serii poprawek.

Kiedy --komponować jest używany, git send-email użyje opcji Od, Temat i W odpowiedzi do
nagłówki określone w wiadomości. Jeśli treść wiadomości (to, co wpiszesz po
nagłówki i pustą linię) zawiera tylko puste (lub Git: z prefiksem) linie, czyli podsumowanie
nie zostaną wysłane, ale nagłówki From, Temat i In-Reply-To zostaną użyte, chyba że tak jest
oddalony.

Zostanie wyświetlony monit o podanie nagłówków Brakujące od lub In-Reply-To.

Patrz rozdział KONFIGURACJA wyślij e-mail.multiEdytuj.

--od=
Określ nadawcę wiadomości e-mail. Jeśli nie określono w wierszu poleceń, wartość
dotychczasowy wyślij e-mail.od używana jest opcja konfiguracji. Jeśli żadna z opcji wiersza poleceń
ani wyślij e-mail.od są ustawione, użytkownik zostanie poproszony o podanie wartości. Domyślny
dla zachęty będzie to wartość GIT_AUTHOR_IDENT lub GIT_COMMITTER_IDENT, jeśli tak
nie jest ustawiony, co zwraca „git var -l”.

--w-odpowiedzi-do=
Spraw, aby pierwsza wiadomość (lub wszystkie wiadomości z opcją --no-thread) pojawiła się jako odpowiedź na podane pytanie
Message-Id, który pozwala uniknąć przerywania wątków w celu zapewnienia nowej serii poprawek. Drugi
a kolejne e-maile będą wysyłane jako odpowiedzi zgodnie z --[no]-chain-reply-to
ustawienie.

Na przykład, gdy podano --thread i --no-chain-reply-to, drugie i
kolejne łatki będą odpowiedzią na pierwszą, jak na poniższej ilustracji
gdzie [PATCH v2 0/3] jest odpowiedzią na [PATCH 0/2]:

[PATCH 0/2] Oto co zrobiłem...
[PATCH 1/2] Oczyszczenie i testy
[PATCH 2/2] Implementacja
[PATCH v2 0/3] Oto powtórka
[PATCH v2 1/3] Posprzątaj
[PATCH v2 2/3] Nowe testy
[PATCH v2 3/3] Implementacja

Konieczne tylko wtedy, gdy ustawiono także opcję --compose. Jeśli --compose nie jest ustawione, tak będzie
poproszony o.

--temat=
Określ początkowy temat wątku wiadomości e-mail. Konieczne tylko wtedy, gdy --compose jest również
ustawić. Jeśli opcja --compose nie jest ustawiona, zostanie wyświetlony monit.

--do= ,...
Określ głównego odbiorcę generowanych wiadomości e-mail. Generalnie będzie to tzw
opiekun wyższego szczebla danego projektu. Wartość domyślna to wartość Wyślij email do
wartość konfiguracyjna; jeśli nie jest to określone i nie określono opcji --to-cmd, tak się stanie
zostać poproszony o.

Opcję tę można określić wielokrotnie.

--Kodowanie 8-bitowe=
W przypadku napotkania wiadomości lub tematu innego niż ASCII, który nie deklaruje swojego kodowania,
dodaj nagłówki/cytaty, aby wskazać, że są zakodowane . Wartość domyślna to wartość
dotychczasowy sendemail.assume8bitEncoding; jeśli nie jest to określone, zostanie wyświetlony monit o podanie if
napotkano jakiekolwiek pliki inne niż ASCII.

Należy pamiętać, że nie są podejmowane żadne próby sprawdzenia poprawności kodowania.

--kompozycja-kodowania=
Określ kodowanie tworzonej wiadomości. Wartość domyślna to wartość
wyślij e-mail.komponujkodowanie; jeśli nie jest to określone, zakłada się UTF-8.

--transfer-encoding=(7bit|8bit|cytowany-drukowalny|base64)
Określ kodowanie przesyłania, które będzie używane do wysyłania wiadomości przez SMTP. 7bit nie będzie działać
po napotkaniu komunikatu innego niż ASCII. cytowany-drukowalny może być przydatny, gdy
repozytorium zawiera pliki zawierające zwroty karetki, ale tworzy surową wiadomość e-mail z łatką
plik (zapisany z MUA) jest znacznie trudniejszy do ręcznego sprawdzenia. base64 jest jeszcze większym głupcem
dowód, ale także jeszcze bardziej nieprzejrzysty. Wartość domyślna to wartość
sendemail.transferKodowanie wartość konfiguracyjna; jeśli nie jest to określone, git użyje
8bit i nie dodawać nagłówka Content-Transfer-Encoding.

--xmailer, --no-xmailer
Dodaj (lub zablokuj dodanie) nagłówka „X-Mailer:”. Domyślnie nagłówek jest dodawany, ale
można to wyłączyć, ustawiając zmienną konfiguracyjną sendemail.xmailer na wartość false.

Wysyłanie
--nadawca-koperty=
Określ nadawcę kopertowego używanego do wysyłania wiadomości e-mail. Jest to przydatne, jeśli jest to ustawienie domyślne
adres nie jest adresem subskrybowanym na liście. Aby skorzystać z Cena Od
adres, ustaw wartość na „auto”. Jeśli używasz pliku binarnego sendmail, musisz go mieć
odpowiednie uprawnienia dla parametru -f. Wartość domyślna to wartość
wyślij e-mail.kopertaNadawca zmienna konfiguracyjna; jeśli nie jest to określone, wybierając
nadawca w kopercie pozostaje w gestii Twojego MTA.

--smtp-szyfrowanie=
Określ także szyfrowanie, które ma zostać użyte ssl or Tls. Każda inna wartość powraca do zwykłego
SMTP. Wartość domyślna to wartość sendemail.smtpSzyfrowanie.

--smtp-domena=
Określa w pełni kwalifikowaną nazwę domeny (FQDN) używaną w komendzie HELO/EHLO
Serwer SMTP. Niektóre serwery wymagają, aby nazwa FQDN była zgodna z Twoim adresem IP. Jeśli nie ustawiono, git
send-email próbuje automatycznie określić Twoją nazwę FQDN. Wartość domyślna to wartość
sendemail.smtpDomena.

--smtp-auth=
Rozdzielana spacjami lista dozwolonych mechanizmów SMTP-AUTH. To ustawienie wymusza użycie
tylko wymienione mechanizmy. Przykład:

$ git send-email --smtp-auth="ZWYKŁE LOGOWANIE GSSAPI" ...

Jeśli co najmniej jeden z określonych mechanizmów odpowiada mechanizmom reklamowanym przez SMTP
serwera i jeśli jest to obsługiwane przez wykorzystywaną bibliotekę SASL, do czego służy ten mechanizm
uwierzytelnianie. Jeśli żadne wyślij e-mail.smtpAuth ani --smtp-auth jest określony, wszystko
można wykorzystać mechanizmy obsługiwane przez bibliotekę SASL.

--smtp-pass[= ]
Hasło do SMTP-AUTH. Argument jest opcjonalny: jeśli nie określono żadnego argumentu, wówczas
pusty ciąg znaków jest używany jako hasło. Wartość domyślna to wartość wyślij e-mail.smtpPass,
jednak --smtp-pass zawsze zastępuje tę wartość.

Co więcej, hasła nie muszą być podawane w plikach konfiguracyjnych ani w poleceniu
linia. Jeśli określono nazwę użytkownika (z --smtp-użytkownik lub sendemail.smtpUżytkownik), ale
nie określono hasła (z --smtp-pass or wyślij e-mail.smtpPass), następnie
hasło uzyskuje się za pomocą git-poświadczenia.

--smtp-serwer=
Jeśli jest ustawiony, określa wychodzący serwer SMTP, który ma być używany (np. smtp.example.com lub surowy adres IP
adres). Alternatywnie może podać pełną ścieżkę programu podobnego do sendmaila
Zamiast; program musi obsługiwać opcję -i. Wartość domyślną można określić poprzez
sendemail.smtpServer opcja konfiguracji; wbudowaną wartością domyślną jest /usr/sbin/sendmail
or /usr/lib/sendmail jeśli taki program jest dostępny, lub localhost w inny sposób.

--smtp-port-serwera=
Określa port inny niż domyślny (serwery SMTP zazwyczaj nasłuchują
smtp port 25, ale może także nasłuchiwać portu przesyłania 587 lub wspólnego portu smtp SSL
465); symboliczne nazwy portów (np. „submission” zamiast 587) również są akceptowane. The
Port można również ustawić za pomocą wyślij e-mail.smtpServerPort zmienna konfiguracyjna.

--smtp-opcja-serwera=
Jeśli jest ustawiony, określa opcję serwera poczty wychodzącej SMTP, która ma zostać użyta. Wartość domyślna może być
określone przez opcja sendemail.smtpServer opcja konfiguracji.

Opcję --smtp-server-option należy powtórzyć dla każdej opcji, do której chcesz przejść
serwer. Podobnie dla każdego z nich należy użyć różnych wierszy w plikach konfiguracyjnych
opcja.

--smtp-ssl
Starszy alias dla --smtp-szyfrowanie ssl.

--smtp-ssl-ścieżka-certyfikatu
Ścieżka do magazynu zaufanych certyfikatów CA na potrzeby sprawdzania poprawności certyfikatu SMTP SSL/TLS
(albo katalog, który został przetworzony przez c_rehashlub pojedynczy plik zawierający
jeden lub więcej certyfikatów w formacie PEM połączonych razem: zob zweryfikować(1) -CAfile i
-CApath, aby uzyskać więcej informacji na ten temat). Ustaw go na pusty ciąg, aby wyłączyć
weryfikacja certyfikatu. Domyślnie jest to wartość sendemail.smtpsslcertścieżka
zmienna konfiguracyjna, jeśli jest ustawiona, lub wkompilowana wartość domyślna pomocniczej biblioteki SSL
w przeciwnym razie (co powinno być najlepszym wyborem na większości platform).

--smtp-użytkownik=
Nazwa użytkownika dla SMTP-AUTH. Wartość domyślna to wartość sendemail.smtpUżytkownik; jeśli nazwa użytkownika to
nieokreślony (z --smtp-użytkownik or sendemail.smtpUżytkownik), to uwierzytelnianie nie jest
próbował.

--smtp-debug=0|1
Włącz (1) lub wyłącz (0) wyjście debugowania. Jeśli ta opcja jest włączona, polecenia i odpowiedzi SMTP będą
wydrukowane. Przydatne do debugowania problemów z połączeniem TLS i uwierzytelnianiem.

Automatyzacja
--to-cmd=
Określ polecenie do wykonania raz dla każdego pliku łatki, co powinno wygenerować plik łatki
określone wpisy „Do:”. Dane wyjściowe tego polecenia muszą zawierać pojedynczy adres e-mail w każdym wierszu.
Wartość domyślna to wartość wyślij e-mail.tocmd wartość konfiguracji.

--cc-cmd=
Określ polecenie do wykonania raz dla każdego pliku łatki, co powinno wygenerować plik łatki
określone wpisy „DW:”. Dane wyjściowe tego polecenia muszą zawierać pojedynczy adres e-mail w każdym wierszu.
Wartość domyślna to wartość wyślij e-mail.ccCmd wartość konfiguracji.

--[nie-]odpowiedź-łańcuchowa
Jeśli ta opcja jest ustawiona, każdy e-mail będzie wysyłany jako odpowiedź na poprzednio wysłany e-mail. Jeśli
wyłączone z opcją „--no-chain-reply-to”, wszystkie e-maile po pierwszym zostaną wysłane jako
odpowiedzi na pierwszego wysłanego e-maila. Podczas korzystania z tego zaleca się, aby pierwszy
podany plik będzie przeglądem całej serii poprawek. Domyślnie wyłączone, ale
wyślij e-mail.łańcuch odpowiedzi do Aby to włączyć, można użyć zmiennej konfiguracyjnej.

--tożsamość=
Tożsamość konfiguracji. Gdy jest podany, powoduje wartości w pliku wysłać email.
podsekcji, aby mieć pierwszeństwo przed wartościami w pliku wysłać email Sekcja. Domyślny
tożsamość jest wartością wyślij e-mail.tożsamość.

--[nie-]podpisany-przez-cc
Jeśli ta opcja jest ustawiona, dodaj e-maile znalezione w wierszach Podpisany przez: lub DW: do listy DW.
Wartość domyślna to wartość sendemail.signedoffbycc wartość konfiguracyjna; jeśli to jest
nieokreślony, domyślnie --signed-off-by-cc.

--[no-]cc-cover
Jeśli ta opcja jest ustawiona, e-maile będą znajdowane w nagłówkach DW: w pierwszym patchu z serii
(zwykle list motywacyjny) są dodawane do listy DW dla każdego zestawu e-maili. Domyślnie jest
wartość wyślij e-mail.cccover wartość konfiguracyjna; jeśli nie jest to określone, domyślnie
--no-cc-cover.

--[nie-]na pokrycie
Jeśli ta opcja jest ustawiona, e-maile będą znajdowane w nagłówkach To: w pierwszej łatce z tej serii
(zwykle list motywacyjny) są dodawane do listy do każdego zestawu e-maili. Domyślnie jest
wartość wyślij e-mail.do okładki wartość konfiguracyjna; jeśli nie jest to określone, domyślnie
--nie do zakrycia.

--suppress-cc=
Określ dodatkową kategorię odbiorców, aby wyłączyć automatyczne kopiowanie:

· autor będzie unikać włączania autora łatki

· samego siebie będzie unikać uwzględniania nadawcy

· cc będzie unikać włączania osób wymienionych w wierszach DW w nagłówku łatki, z wyjątkiem
dla siebie (użyj samego siebie za to).

· ciałocc będzie unikać włączania wszystkich osób wymienionych w wierszach DW w treści łatki (commit
Message) z wyjątkiem self (użyj samego siebie za to).

· szloch będzie unikać uwzględniania osób wymienionych w wierszach Podpisany przez, z wyjątkiem siebie
(posługiwać się samego siebie za to).

· cccmd pozwoli uniknąć uruchomienia --cc-cmd.

· ciało odpowiada szloch + ciałocc

· cała kolekcja pominie wszystkie wartości auto cc.

Wartość domyślna to wartość sendemail.suppresscc wartość konfiguracyjna; jeśli to jest
nieokreślony, domyślnie samego siebie jeśli określono --suppress-from, a także ciało if
Podano --no-signed-off-cc.

--[nie-]pomiń-od
Jeśli ta opcja jest ustawiona, nie dodawaj adresu Od: do listy DW:. Wartość domyślna to wartość
sendemail.suppressOd wartość konfiguracyjna; jeśli nie jest to określone, domyślnie
--nie-tłumić-od.

--[nie-]wątek
Jeśli ta opcja jest ustawiona, nagłówki In-Reply-To i References zostaną dodane do każdego e-maila
wysłano. Czy każda wiadomość odnosi się do poprzedniej wiadomości e-mail (głębokie wątki na odrzutowiec
poprawka formatu sformułowania) lub do pierwszego e-maila (płytkie wątki) regulują
„--[nie-]odpowiedź łańcuchowa”.

Jeśli opcja ta jest wyłączona z opcją „--no-thread”, te nagłówki nie zostaną dodane (chyba że określono to w opcji
--w odpowiedzi na). Wartość domyślna to wartość wyślij e-mail.wątek wartość konfiguracyjna; Jeśli
który nie jest określony, domyślnie --thread.

Do użytkownika należy upewnienie się, że nie istnieje już żaden nagłówek In-Reply-To odrzutowiec
wysłać email zostanie poproszony o dodanie go (zwłaszcza zwróć uwagę, że odrzutowiec poprawka formatu można skonfigurować
do samodzielnego wykonania gwintu). Niezastosowanie się do tego może nie dać oczekiwanego rezultatu
MUA odbiorcy.

Administrowanie
--potwierdź=
Potwierdź tuż przed wysłaniem:

· zawsze zawsze potwierdzi przed wysłaniem

· nigdy nigdy nie potwierdzi przed wysłaniem

· cc potwierdzi przed wysłaniem, gdy send-email automatycznie doda adresy
z łatki na listę DW

· komponować potwierdzi przed wysłaniem pierwszej wiadomości przy użyciu --compose.

· samochód odpowiada cc + komponować

Wartość domyślna to wartość wyślij e-mail.potwierdź wartość konfiguracyjna; jeśli nie jest to określone,
domyślnie samochód chyba że określono jakąkolwiek opcję pomijania, w takim przypadku
domyślnie komponować.

--próba
Rób wszystko oprócz faktycznego wysyłania e-maili.

--[no-]łatka-formatowa
Jeśli argument może być rozumiany albo jako odniesienie, albo jako nazwa pliku, wybierz tę opcję
zrozum to jako argument poprawki formatu (--łatka-formatowa) lub jako nazwa pliku
(--brak-łatki-formatowej). Domyślnie, gdy wystąpi taki konflikt, git send-email to zrobi
zawieść.

--cichy
Spraw, aby git-send-email był mniej gadatliwy. Jedna linia na e-mail powinna wystarczyć.

--[nie-]weryfikacja
Wykonuj kontrole poprawności poprawek. Obecnie walidacja oznacza:

· Ostrzegaj o poprawkach zawierających linie dłuższe niż 998 znaków; jest to spowodowane SMTP
limity opisane przez http://www.ietf.org/rfc/rfc2821.txt.

Wartość domyślna to wartość wyślij e-mail.poprawność; jeśli nie jest to ustawione, domyślnie --uprawomocnić.

--siła
Wysyłaj e-maile, nawet jeśli kontrole bezpieczeństwa to uniemożliwiają.

Informacja
--dump-aliasy
Zamiast normalnej operacji, zrzuć skrócone nazwy aliasów z plikuconfigure
plik(i) aliasów, po jednym w wierszu w kolejności alfabetycznej. Uwaga: dotyczy to tylko aliasu
nazwę, a nie rozwinięte adresy e-mail. Widzieć wyślij e-mail.plik aliasów więcej
informacje o aliasach.

KONFIGURACJA

wyślij e-mail.aliasyPlik
Aby uniknąć wpisywania długich adresów e-mail, wskaż jeden lub więcej plików aliasów e-mail.
Musisz także zaopatrzyć się sendemail.aliasTypPliku.

sendemail.aliasTypPliku
Format plików określony w sendemail.aliasesFile. Musi być jednym z błazen, pocztarc,
sosna, wiązlub niesmaklub Wyślij maila.

Jak wygląda plik aliasów w każdym formacie, można znaleźć w dokumentacji pliku
program pocztowy o tej samej nazwie. Różnice i ograniczenia w stosunku do normy
formaty opisano poniżej:

Wyślij maila

· Cytowane aliasy i adresy nie są obsługiwane: linie zawierające znak „
symbole są ignorowane.

· Przekierowanie do pliku (/ścieżka/nazwa) lub potoku (|polecenie) nie jest obsługiwane.

· Dołączanie plików (:include: /path/name) nie jest obsługiwane.

· Ostrzeżenia są drukowane na standardowym wyjściu błędu dla dowolnego jawnie
nieobsługiwane konstrukcje i wszelkie inne linie, które nie są rozpoznawane przez
parser.

wyślij e-mail.multiEdytuj
Jeśli ma wartość true (domyślnie), zostanie uruchomiona pojedyncza instancja edytora, aby edytować pliki, które musisz
edit (poprawia kiedy --komentować jest używany, a podsumowanie kiedy --komponować Jest używane). Jeśli
false, pliki będą edytowane jeden po drugim, za każdym razem tworząc nowego edytora.

wyślij e-mail.potwierdź
Ustawia domyślną opcję potwierdzania przed wysłaniem. Musi być jednym z zawsze, nigdy,
cc, komponowaćlub samochód. Zobaczyć --potwierdzać w poprzedniej sekcji, aby poznać ich znaczenie
wartości.

PRZYKŁAD

Zastosowanie gmail as dotychczasowy SMTP serwer
Aby korzystać z odrzutowiec wysłać email aby wysłać poprawki przez serwer SMTP Gmaila, edytuj
~ / .gitconfig aby określić ustawienia konta:

[wysłać email]
smtpEncryption = tls
smtpServer = smtp.gmail.com
użytkownik smtp = [email chroniony]
smtpServerPort = 587

Gdy zatwierdzenia będą gotowe do wysłania na listę mailingową, uruchom następujące polecenia:

$ git format-patch --list-motywacyjny -M pochodzenie/master -o wychodzące/
$ edycja wychodzących/0000-*
$ git wyślij-e-mail wychodzący/*

Uwaga: wymagane są następujące moduły Perla Net::SMTP::SSL, MIME::Base64 i
Uwierzytelnianie::SASL

Użyj git-send-email online, korzystając z usług onworks.net