git-send-email - Online di Cloud

PROGRAM:

NAMA

git-send-email - Kirim koleksi tambalan sebagai email

RINGKASAN

git mengirim email [pilihan] ...
git mengirim email --dump-alias

DESKRIPSI

Mengambil tambalan yang diberikan pada baris perintah dan mengirimkannya melalui email. Patch dapat ditentukan
sebagai file, direktori (yang akan mengirim semua file dalam direktori), atau langsung sebagai
daftar revisi. Dalam kasus terakhir, format apa pun yang diterima oleh git-format-patch(1) dapat dilewati
ke git send-email.

Header email dapat dikonfigurasi melalui opsi baris perintah. Jika tidak ditentukan pada
baris perintah, pengguna akan diminta dengan antarmuka yang diaktifkan ReadLine untuk menyediakan
informasi yang perlu.

Ada dua format yang diterima untuk file patch:

1. file berformat mbox

Ini apa git-format-patch(1) menghasilkan. Sebagian besar format header dan MIME adalah
diabaikan.

2. Format asli yang digunakan oleh Greg Kroah-Hartman's send_lots_of_email.pl naskah

Format ini mengharapkan baris pertama file berisi nilai "Cc:" dan
"Subjek:" dari pesan sebagai baris kedua.

PILIHAN

Menulis
--membubuhi keterangan
Tinjau dan edit setiap tambalan yang akan Anda kirim. Defaultnya adalah nilai
sendemail.anotasi. Lihat bagian KONFIGURASI untuk sendemail.multiSunting.

--bcc= ,...
Tentukan nilai "Bcc:" untuk setiap email. Defaultnya adalah nilai sendemail.bcc.

Opsi ini dapat ditentukan beberapa kali.

--cc= ,...
Tentukan nilai awal "Cc:" untuk setiap email. Defaultnya adalah nilai sendemail.cc.

Opsi ini dapat ditentukan beberapa kali.

--menyusun
Panggil editor teks (lihat GIT_EDITOR di git-var(1)) untuk mengedit pesan pengantar
untuk seri tambalan.

Ketika --menyusun digunakan, git send-email akan menggunakan From, Subject, dan In-Reply-To
header yang ditentukan dalam pesan. Jika isi pesan (apa yang Anda ketik setelah
header dan baris kosong) hanya berisi baris kosong (atau Git: prefixed), ringkasannya
tidak akan dikirim, tetapi header Dari, Subjek, dan In-Reply-To akan digunakan kecuali jika ada
dihapus.

Header Hilang Dari atau In-Reply-To akan diminta.

Lihat bagian KONFIGURASI untuk sendemail.multiSunting.

--dari=
Tentukan pengirim email. Jika tidak ditentukan pada baris perintah, nilai
itu sendemail.dari opsi konfigurasi yang digunakan. Jika tidak ada opsi baris perintah
maupun sendemail.dari diatur, maka pengguna akan diminta untuk memasukkan nilainya. Standarnya
untuk prompt akan menjadi nilai GIT_AUTHOR_IDENT, atau GIT_COMMITTER_IDENT jika itu
tidak disetel, seperti yang dikembalikan oleh "git var -l".

--dalam-balas-ke=
Jadikan surat pertama (atau semua surat dengan --no-thread) muncul sebagai balasan atas yang diberikan
Message-Id, yang menghindari pemutusan utas untuk menyediakan seri tambalan baru. Kedua
dan email berikutnya akan dikirim sebagai balasan sesuai dengan --[no]-chain-reply-to
pengaturan.

Jadi misalnya ketika --thread dan --no-chain-reply-to ditentukan, yang kedua dan
tambalan berikutnya akan dibalas dengan yang pertama seperti pada ilustrasi di bawah ini
di mana [PATCH v2 0/3] sebagai balasan untuk [PATCH 0/2]:

[PATCH 0/2] Inilah yang saya lakukan...
[PATCH 1/2] Bersihkan dan uji
[PATCH 2/2] Implementasi
[PATCH v2 0/3] Ini rerollnya
[PATCH v2 1/3] Bersihkan
[PATCH v2 2/3] Tes baru
[PATCH v2 3/3] Implementasi

Hanya diperlukan jika --compose juga disetel. Jika --compose tidak disetel, ini akan menjadi
diminta untuk.

--subyek=
Tentukan subjek awal utas email. Hanya diperlukan jika --compose juga
mengatur. Jika --compose tidak disetel, ini akan diminta.

--untuk= ,...
Tentukan penerima utama email yang dihasilkan. Umumnya, ini akan menjadi
pengelola hulu dari proyek yang terlibat. Defaultnya adalah nilai sendemail.ke
nilai konfigurasi; jika itu tidak ditentukan, dan --to-cmd tidak ditentukan, ini akan
diminta untuk.

Opsi ini dapat ditentukan beberapa kali.

--pengkodean-8bit=
Saat menemukan pesan atau subjek non-ASCII yang tidak menyatakan penyandiannya,
tambahkan tajuk/kutipan untuk menunjukkan bahwa itu dikodekan dalam . Defaultnya adalah nilai
itu sendemail.assume8bitEncoding; jika itu tidak ditentukan, ini akan diminta jika
file non-ASCII ditemukan.

Perhatikan bahwa tidak ada upaya apa pun yang dilakukan untuk memvalidasi pengkodean.

--compose-encoding=
Tentukan pengkodean pesan tulis. Defaultnya adalah nilai
sendemail.composeencoding; jika itu tidak ditentukan, diasumsikan UTF-8.

--transfer-encoding=(7bit|8bit|quoted-printable|base64)
Tentukan pengkodean transfer yang akan digunakan untuk mengirim pesan melalui SMTP. 7bit akan gagal
setelah menemukan pesan non-ASCII. dikutip-printable dapat berguna ketika
repositori berisi file yang berisi carriage return, tetapi membuat email tambalan mentah
file (seperti yang disimpan dari MUA) jauh lebih sulit untuk diperiksa secara manual. base64 bahkan lebih bodoh
bukti, tetapi juga lebih buram. Defaultnya adalah nilai
sendemail.transferEncoding nilai konfigurasi; jika itu tidak ditentukan, git akan menggunakan
8bit dan tidak menambahkan header Content-Transfer-Encoding.

--xmailer, --tidak ada-xmailer
Tambahkan (atau cegah penambahan) header "X-Mailer:". Secara default, tajuk ditambahkan, tetapi
itu dapat dimatikan dengan menyetel variabel konfigurasi sendemail.xmailer ke false.

mengirim
--amplop-pengirim=
Tentukan pengirim amplop yang digunakan untuk mengirim email. Ini berguna jika default Anda
alamat bukan alamat yang berlangganan daftar. Untuk menggunakan Dari
alamat, atur nilainya ke "otomatis". Jika Anda menggunakan biner sendmail, Anda harus memiliki
hak istimewa yang sesuai untuk parameter -f. Defaultnya adalah nilai
sendemail.envelopeSender variabel konfigurasi; jika itu tidak ditentukan, pilih
pengirim amplop diserahkan kepada MTA Anda.

--smtp-enkripsi=
Tentukan enkripsi yang akan digunakan ssl or tls. Nilai lain apa pun kembali ke polos
SMTP. Defaultnya adalah nilai sendemail.smtpEnkripsi.

--smtp-domain=
Menentukan Fully Qualified Domain Name (FQDN) yang digunakan dalam perintah HELO/EHLO untuk
server SMTP. Beberapa server memerlukan FQDN agar sesuai dengan alamat IP Anda. Jika tidak disetel, git
send-email mencoba untuk menentukan FQDN Anda secara otomatis. Defaultnya adalah nilai
sendemail.smtpDomain.

--smtp-auth=
Daftar yang dipisahkan spasi dari mekanisme SMTP-AUTH yang diizinkan. Pengaturan ini memaksa menggunakan
hanya mekanisme yang terdaftar. Contoh:

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

Jika setidaknya salah satu mekanisme yang ditentukan cocok dengan yang diiklankan oleh SMTP
server dan jika didukung oleh perpustakaan SASL yang digunakan, mekanisme tersebut digunakan untuk
autentikasi. Jika tidak sendemail.smtpAuth maupun --smtp-auth ditentukan, semua
mekanisme yang didukung oleh perpustakaan SASL dapat digunakan.

--smtp-pass[= ]
Kata sandi untuk SMTP-AUTH. Argumennya opsional: Jika tidak ada argumen yang ditentukan, maka
string kosong digunakan sebagai kata sandi. Defaultnya adalah nilai sendemail.smtpPass,
namun --smtp-lulus selalu menimpa nilai ini.

Selanjutnya, kata sandi tidak perlu ditentukan dalam file konfigurasi atau pada perintah
garis. Jika nama pengguna telah ditentukan (dengan --smtp-pengguna atau sendemail.smtpPengguna), tapi
tidak ada kata sandi yang ditentukan (dengan --smtp-lulus or sendemail.smtpPass), maka
kata sandi diperoleh menggunakan git-kredensial.

--smtp-server=
Jika disetel, tentukan server SMTP keluar yang akan digunakan (mis. smtp.example.com atau IP mentah
alamat). Atau dapat menentukan nama path lengkap dari program seperti sendmail
sebagai gantinya; program harus mendukung opsi -i. Nilai default dapat ditentukan oleh
sendemail.smtpServer opsi konfigurasi; bawaan bawaannya adalah /usr/sbin/sendmail
or /usr/lib/sendmail jika program tersebut tersedia, atau localhost sebaliknya.

--smtp-server-port=
Menentukan port yang berbeda dari port default (server SMTP biasanya mendengarkan
port smtp 25, tetapi juga dapat mendengarkan port pengiriman 587, atau port smtp SSL umum
465); nama port simbolis (misalnya "pengajuan" bukan 587) juga diterima. Itu
port juga dapat diatur dengan sendemail.smtpServerPort variabel konfigurasi.

--smtp-server-option=
Jika disetel, tentukan opsi server SMTP keluar yang akan digunakan. Nilai default dapat berupa
ditentukan oleh sendemail.smtpServerOption opsi konfigurasi.

Opsi --smtp-server-option harus diulang untuk setiap opsi yang ingin Anda teruskan
server. Demikian juga, baris yang berbeda dalam file konfigurasi harus digunakan untuk masing-masing
.

--smtp-ssl
Alias ​​​​warisan untuk --smtp-enkripsi ssl.

--smtp-ssl-cert-jalur
Jalur ke penyimpanan sertifikat CA tepercaya untuk validasi sertifikat SSL/TLS SMTP
(baik direktori yang telah diproses oleh c_rehash, atau satu file yang berisi
satu atau lebih sertifikat format PEM digabungkan menjadi satu: lihat memeriksa(1) -CAfile dan
-CApath untuk informasi lebih lanjut tentang ini). Setel ke string kosong untuk menonaktifkan
verifikasi sertifikat. Default ke nilai sendemail.smtpsslcertpath
variabel konfigurasi, jika disetel, atau pustaka SSL pendukung yang dikompilasi secara default
jika tidak (yang seharusnya menjadi pilihan terbaik di sebagian besar platform).

--smtp-pengguna=
Nama pengguna untuk SMTP-AUTH. Defaultnya adalah nilai sendemail.smtpPengguna; jika nama pengguna adalah
tidak ditentukan (dengan --smtp-pengguna or sendemail.smtpPengguna), maka otentikasi tidak
berusaha.

--smtp-debug=0|1
Aktifkan (1) atau nonaktifkan (0) keluaran debug. Jika diaktifkan, perintah dan balasan SMTP akan menjadi
dicetak. Berguna untuk men-debug koneksi TLS dan masalah otentikasi.

Mengotomatisasi
--ke-cmd=
Tentukan perintah untuk dijalankan sekali per file tambalan yang seharusnya menghasilkan file tambalan
entri "Kepada:" tertentu. Output dari perintah ini harus berupa alamat email tunggal per baris.
Defaultnya adalah nilai sendemail.tocmd nilai konfigurasi.

--cc-cmd=
Tentukan perintah untuk dijalankan sekali per file tambalan yang seharusnya menghasilkan file tambalan
entri "Cc:" tertentu. Output dari perintah ini harus berupa alamat email tunggal per baris.
Defaultnya adalah nilai sendemail.ccCmd nilai konfigurasi.

--[tidak-]balasan-rantai-ke
Jika ini diatur, setiap email akan dikirim sebagai balasan dari email yang dikirim sebelumnya. Jika
dinonaktifkan dengan "--no-chain-reply-to", semua email setelah yang pertama akan dikirim sebagai
membalas email pertama yang dikirim. Saat menggunakan ini, disarankan agar yang pertama
file yang diberikan menjadi gambaran umum dari seluruh seri patch. Dinonaktifkan secara default, tetapi
sendemail.chainReplyTo variabel konfigurasi dapat digunakan untuk mengaktifkannya.

--identitas=
Sebuah identitas konfigurasi. Ketika diberikan, menyebabkan nilai dalam mengirim email.
subbagian untuk didahulukan dari nilai-nilai dalam mengirim email bagian. Standarnya
identitas adalah nilai dari sendemail.identitas.

--[tidak-]ditandatangani-oleh-cc
Jika ini disetel, tambahkan email yang ditemukan di baris Signed-off-by: atau Cc: ke daftar cc.
Defaultnya adalah nilai sendemail.signedoffbycc nilai konfigurasi; jika itu
tidak ditentukan, default ke --signed-off-by-cc.

--[tidak-]penutup-cc
Jika ini disetel, email ditemukan di Cc: header di tambalan pertama seri
(biasanya surat lamaran) ditambahkan ke daftar cc untuk setiap set email. Standarnya adalah
nilai sendemail.cccover nilai konfigurasi; jika itu tidak ditentukan, default ke
--tanpa-cc-penutup.

--[tidak-]untuk-menutupi
Jika ini diatur, email ditemukan di To: header di tambalan pertama seri
(biasanya surat lamaran) ditambahkan ke daftar untuk setiap set email. Standarnya adalah
nilai sendemail.tocover nilai konfigurasi; jika itu tidak ditentukan, default ke
--tidak-untuk-menutup.

--menekan-cc=
Tentukan kategori penerima tambahan untuk menekan cc otomatis dari:

· penulis akan menghindari menyertakan pembuat tambalan

· diri akan menghindari termasuk pengirim

· cc akan menghindari menyertakan siapa pun yang disebutkan dalam baris Cc di header patch kecuali
untuk diri sendiri (gunakan diri untuk itu).

· tubuhcc akan menghindari menyertakan siapa pun yang disebutkan dalam baris Cc di badan tambalan (komit
pesan) kecuali untuk diri sendiri (gunakan diri untuk itu).

· isak akan menghindari menyertakan siapa pun yang disebutkan dalam baris Signed-off-by kecuali untuk diri sendiri
(menggunakan diri untuk itu).

· cccmd akan menghindari menjalankan --cc-cmd.

· tubuh adalah setara dengan isak + tubuhcc

· semua akan menekan semua nilai cc otomatis.

Defaultnya adalah nilai sendemail.suppresscc nilai konfigurasi; jika itu
tidak ditentukan, default ke diri jika --suppress-from ditentukan, serta tubuh if
--no-signed-off-cc ditentukan.

--[tidak-]menekan-dari
Jika ini diatur, jangan tambahkan alamat From: ke daftar cc:. Defaultnya adalah nilai
sendemail.suppressDari nilai konfigurasi; jika itu tidak ditentukan, default ke
--no-menekan-dari.

--[tidak-]utas
Jika ini diatur, header In-Reply-To dan Referensi akan ditambahkan ke setiap email
terkirim. Apakah setiap email merujuk ke email sebelumnya (threading per git
format-patch kata-kata) atau ke email pertama (threading dangkal) diatur oleh
"--[tidak-]balasan-rantai-ke".

Jika dinonaktifkan dengan "--no-thread", header tersebut tidak akan ditambahkan (kecuali ditentukan dengan
--dalam-balas-ke). Defaultnya adalah nilai sendemail.thread nilai konfigurasi; jika
yang tidak ditentukan, default ke --thread.

Terserah pengguna untuk memastikan bahwa tidak ada header In-Reply-To yang sudah ada ketika git
mengirim email diminta untuk menambahkannya (terutama perhatikan bahwa git format-patch dapat dikonfigurasi
untuk melakukan threading itu sendiri). Kegagalan untuk melakukannya mungkin tidak memberikan hasil yang diharapkan dalam
MUA penerima.

Mengatur
--konfirmasi=
Konfirmasi sebelum mengirim:

· selalu akan selalu mengkonfirmasi sebelum mengirim

· tak pernah tidak akan pernah mengkonfirmasi sebelum mengirim

· cc akan mengkonfirmasi sebelum mengirim ketika send-email telah secara otomatis menambahkan alamat
dari patch ke daftar Cc

· menyusun akan mengonfirmasi sebelum mengirim pesan pertama saat menggunakan --compose.

· mobil adalah setara dengan cc + menyusun

Defaultnya adalah nilai sendemail.konfirmasi nilai konfigurasi; jika itu tidak ditentukan,
default untuk mobil kecuali salah satu opsi penekanan telah ditentukan, dalam hal ini
default untuk menyusun.

--lari-kering
Lakukan segalanya kecuali benar-benar mengirim email.

--[tanpa-]format-tambalan
Ketika argumen dapat dipahami baik sebagai referensi atau sebagai nama file, pilih untuk
memahaminya sebagai argumen format-patch (--format-patch) atau sebagai nama file
(--tidak ada-format-patch). Secara default, ketika konflik seperti itu terjadi, git send-email akan
gagal.

--diam
Jadikan git-send-email kurang bertele-tele. Satu baris per email harus menjadi semua yang dihasilkan.

--[tidak-]validasi
Lakukan pemeriksaan kewarasan pada tambalan. Saat ini, validasi berarti sebagai berikut:

· Peringatkan patch yang berisi baris lebih dari 998 karakter; ini karena SMTP
batas seperti yang dijelaskan oleh http://www.ietf.org/rfc/rfc2821.txt.

Defaultnya adalah nilai sendemail.validasi; jika ini tidak disetel, default ke --mengesahkan.

--memaksa
Kirim email bahkan jika pemeriksaan keamanan akan mencegahnya.

Informasi
--dump-alias
Alih-alih operasi normal, buang nama alias singkatan dari yang dikonfigurasi
alias file(s), satu per baris dalam urutan abjad. Catatan, ini hanya termasuk alias
nama dan bukan alamat email yang diperluas. Melihat sendemail.aliasesfile keahlian yang lebih
informasi tentang alias.

KONFIGURASI

sendemail.aliasesFile
Untuk menghindari mengetik alamat email yang panjang, arahkan ini ke satu atau beberapa file alias email.
Anda juga harus menyediakan sendemail.aliasFileType.

sendemail.aliasFileType
Format file yang ditentukan di sendemail.aliasesFile. Harus menjadi salah satu anjing kampung, mailrc,
pinus, elm, atau rusa kutub, atau kirim email.

Seperti apa file alias dalam setiap format dapat ditemukan dalam dokumentasi dari
program email dengan nama yang sama. Perbedaan dan batasan dari standar
format dijelaskan di bawah ini:

kirim email

· Alias ​​yang dikutip dan alamat yang dikutip tidak didukung: baris yang berisi "
simbol diabaikan.

· Pengalihan ke file (/path/name) atau pipa (|command) tidak didukung.

· Penyertaan file (:include: /path/name) tidak didukung.

· Peringatan dicetak pada output kesalahan standar untuk setiap eksplisit
konstruksi yang tidak didukung, dan baris lain apa pun yang tidak dikenali oleh
pengurai.

sendemail.multiSunting
Jika benar (default), instance editor tunggal akan muncul untuk mengedit file yang Anda harus
edit (tambal ketika --membubuhi keterangan digunakan, dan ringkasan ketika --menyusun digunakan). Jika
false, file akan diedit satu demi satu, memunculkan editor baru setiap kali.

sendemail.konfirmasi
Menyetel default apakah akan mengonfirmasi sebelum mengirim. Harus menjadi salah satu selalu, tak pernah,
cc, menyusun, atau mobil. Lihat --Konfirmasi di bagian sebelumnya untuk arti dari ini
nilai-nilai.

CONTOH

penggunaan gmail as itu smtp Server
Untuk menggunakan git mengirim email untuk mengirim tambalan Anda melalui server SMTP GMail, edit
~ / .gitconfig untuk menentukan pengaturan akun Anda:

[mengirim email]
smtpEnkripsi = tls
smtpServer = smtp.gmail.com
smtpPengguna = [email dilindungi]
smtpServerPort = 587

Setelah komit Anda siap untuk dikirim ke milis, jalankan perintah berikut:

$ git format-patch --cover-letter -M Asal/master -o keluar/
$ edit keluar/0000-*
$ git kirim-email keluar/*

Catatan: modul Perl berikut diperlukan Net::SMTP::SSL, MIME::Base64 dan
Otentik::SASL

Gunakan git-send-email online menggunakan layanan onworks.net