git-send-email - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

git-send-email - Gửi bộ sưu tập các bản vá dưới dạng email

SYNOPSIS

git gửi email [tùy chọn] ...
git gửi email --dump-bí danh

MÔ TẢ

Lấy các bản vá được cung cấp trên dòng lệnh và gửi chúng qua email. Các bản vá có thể được chỉ định
dưới dạng tệp, thư mục (sẽ gửi tất cả các tệp trong thư mục) hoặc trực tiếp dưới dạng
danh sách sửa đổi. Trong trường hợp cuối cùng, bất kỳ định dạng nào được chấp nhận bởi git-format-patch(1) có thể được thông qua
để git gửi email.

Tiêu đề của email có thể được cấu hình thông qua các tùy chọn dòng lệnh. Nếu không được chỉ định trên
dòng lệnh, người dùng sẽ được nhắc nhở với giao diện kích hoạt ReadLine để cung cấp
thông tin cần thiết.

Có hai định dạng được chấp nhận cho các tệp vá:

1. tập tin định dạng mbox

Đây là cái gì git-format-patch(1) tạo ra. Hầu hết các tiêu đề và định dạng MIME đều
mặc kệ.

2. Định dạng ban đầu được sử dụng bởi Greg Kroah-Hartman send_lots_of_email.pl kịch bản

Định dạng này yêu cầu dòng đầu tiên của tệp chứa giá trị "Cc:" và
"Chủ đề:" của tin nhắn ở dòng thứ hai.

LỰA CHỌN

Sáng tác
--chú thích
Xem lại và chỉnh sửa từng bản vá bạn sắp gửi. Mặc định là giá trị của
gửiemail.annotate. Xem phần CẤU HÌNH để biết sendemail.multiSửa đổi.

--bcc= ,...
Chỉ định giá trị "Bcc:" cho mỗi email. Mặc định là giá trị của gửiemail.bcc.

Tùy chọn này có thể được chỉ định nhiều lần.

--cc= ,...
Chỉ định giá trị "Cc:" bắt đầu cho mỗi email. Mặc định là giá trị của gửiemail.cc.

Tùy chọn này có thể được chỉ định nhiều lần.

--soạn, biên soạn
Gọi trình soạn thảo văn bản (xem GIT_EDITOR trong git-var(1)) để chỉnh sửa tin nhắn giới thiệu
cho loạt bản vá.

Thời Gian --soạn, biên soạn được sử dụng, git send-email sẽ sử dụng Từ, Chủ đề và Trả lời
tiêu đề được chỉ định trong tin nhắn. Nếu nội dung của tin nhắn (nội dung bạn nhập sau
tiêu đề và một dòng trống) chỉ chứa các dòng trống (hoặc Git: có tiền tố), phần tóm tắt
sẽ không được gửi, nhưng các tiêu đề Từ, Chủ đề và Trả lời sẽ được sử dụng trừ khi chúng được gửi
loại bỏ.

Tiêu đề Thiếu Từ hoặc Trả lời sẽ được nhắc.

Xem phần CẤU HÌNH để biết sendemail.multiSửa đổi.

--từ=
Chỉ định người gửi email. Nếu không được chỉ định trên dòng lệnh, giá trị của
các gửiemail.from tùy chọn cấu hình được sử dụng. Nếu cả tùy chọn dòng lệnh đều không
cũng không gửiemail.from được đặt thì người dùng sẽ được nhắc về giá trị. Mặc định
đối với lời nhắc sẽ là giá trị của GIT_AUTHOR_IDENT hoặc GIT_COMMITTER_IDENT nếu điều đó
chưa được đặt, được trả về bởi "git var -l".

--in-trả lời-đến=
Làm cho thư đầu tiên (hoặc tất cả các thư có --no-thread) xuất hiện dưới dạng thư trả lời cho một
Id thông báo, tránh phá vỡ các chủ đề để cung cấp một loạt bản vá mới. Thư hai
và các email tiếp theo sẽ được gửi dưới dạng thư trả lời theo --[no]-chain-reply-to
thiết lập.

Vì vậy, ví dụ khi --thread và --no-chain-reply-to được chỉ định, thứ hai và
các bản vá tiếp theo sẽ trả lời bản đầu tiên như trong hình minh họa bên dưới
trong đó [PATCH v2 0/3] trả lời [PATCH 0/2]:

[PATCH 0/2] Đây là những gì tôi đã làm...
[PATCH 1/2] Dọn dẹp và kiểm tra
[PATCH 2/2] Triển khai
[PATCH v2 0/3] Đây là bản reroll
[PATCH v2 1/3] Dọn dẹp
[PATCH v2 2/3] Các thử nghiệm mới
[PATCH v2 3/3] Triển khai

Chỉ cần thiết nếu --compose cũng được đặt. Nếu --compose không được đặt, đây sẽ là
được nhắc nhở cho.

--chủ đề=
Chỉ định chủ đề ban đầu của chuỗi email. Chỉ cần thiết nếu --compose cũng
bộ. Nếu --compose không được đặt, điều này sẽ được nhắc.

--đến= ,...
Chỉ định người nhận chính của các email được tạo. Nhìn chung, đây sẽ là
người duy trì thượng nguồn của dự án có liên quan. Mặc định là giá trị của gửi email đến
giá trị cấu hình; nếu điều đó không được chỉ định và --to-cmd không được chỉ định, điều này sẽ
được nhắc nhở.

Tùy chọn này có thể được chỉ định nhiều lần.

--Mã hóa 8bit=
Khi gặp một tin nhắn hoặc chủ đề không phải ASCII không khai báo mã hóa của nó,
thêm tiêu đề/trích dẫn để cho biết nó được mã hóa bằng . Mặc định là giá trị của
các sendemail.assume8bitEncoding; nếu điều đó không được chỉ định, điều này sẽ được nhắc nếu
gặp phải bất kỳ tệp không phải ASCII nào.

Lưu ý rằng không có nỗ lực nào được thực hiện để xác thực mã hóa.

--compose-encoding=
Chỉ định mã hóa tin nhắn soạn thảo. Mặc định là giá trị của
sendemail.composeencoding; nếu điều đó không được chỉ định, UTF-8 được giả định.

--transfer-encoding=(7bit|8bit|có thể in được trích dẫn|base64)
Chỉ định mã hóa truyền sẽ được sử dụng để gửi thư qua SMTP. 7bit sẽ thất bại
khi gặp một thông báo không phải ASCII. có thể in được trích dẫn có thể hữu ích khi
kho lưu trữ chứa các tệp chứa các dòng trả về đầu dòng, nhưng tạo ra email bản vá thô
(như được lưu từ MUA) khó kiểm tra thủ công hơn nhiều. base64 thậm chí còn ngu ngốc hơn
bằng chứng, nhưng thậm chí còn mờ ám hơn. Mặc định là giá trị của
sendemail.transferEncoding giá trị cấu hình; nếu điều đó không được chỉ định, git sẽ sử dụng
8bit và không thêm tiêu đề Mã hóa chuyển nội dung.

--xmailer, --no-xmailer
Thêm (hoặc ngăn thêm) tiêu đề "X-Mailer:". Theo mặc định, tiêu đề được thêm vào, nhưng
nó có thể được tắt bằng cách đặt biến cấu hình sendemail.xmailer thành false.

Gửi
--người gửi phong bì=
Chỉ định người gửi phong bì được sử dụng để gửi email. Điều này hữu ích nếu mặc định của bạn
địa chỉ không phải là địa chỉ được đăng ký vào danh sách. Để sử dụng Từ
địa chỉ, đặt giá trị thành "tự động". Nếu bạn sử dụng tệp nhị phân sendmail, bạn phải có
đặc quyền phù hợp cho tham số -f. Mặc định là giá trị của
sendemail.envelopeNgười gửi biến cấu hình; nếu điều đó không được chỉ định, hãy chọn
người gửi phong bì được giao cho MTA của bạn.

--smtp-mã hóa=
Chỉ định mã hóa để sử dụng ssl or tls. Bất kỳ giá trị nào khác trở lại đơn giản
SMTP. Mặc định là giá trị của sendemail.smtpMã hóa.

--smtp-miền=
Chỉ định Tên miền Đủ điều kiện (FQDN) được sử dụng trong lệnh HELO/EHLO cho
Máy chủ SMTP. Một số máy chủ yêu cầu FQDN khớp với địa chỉ IP của bạn. Nếu không được đặt, git
gửi email cố gắng tự động xác định FQDN của bạn. Mặc định là giá trị của
sendemail.smtpDomain.

--smtp-auth=
Danh sách các cơ chế SMTP-AUTH được phép được phân tách bằng khoảng trắng. Cài đặt này buộc sử dụng
chỉ các cơ chế được liệt kê. Ví dụ:

$ git send-email --smtp-auth="ĐĂNG NHẬP ĐƠN GIẢN GSSAPI" ...

Nếu ít nhất một trong các cơ chế được chỉ định khớp với các cơ chế được SMTP quảng cáo
máy chủ và nếu nó được hỗ trợ bởi thư viện SASL đã sử dụng thì cơ chế này sẽ được sử dụng để
xác thực. Nếu không gửiemail.smtpAuth cũng không --smtp-auth được chỉ định, tất cả
có thể sử dụng các cơ chế được thư viện SASL hỗ trợ.

--smtp-pass[= ]
Mật khẩu cho SMTP-AUTH. Đối số là tùy chọn: Nếu không có đối số nào được chỉ định thì
chuỗi trống được sử dụng làm mật khẩu. Mặc định là giá trị của gửiemail.smtpPass,
tuy nhiên --smtp-pass luôn ghi đè giá trị này.

Hơn nữa, mật khẩu không cần phải được chỉ định trong tập tin cấu hình hoặc trên lệnh
đường kẻ. Nếu tên người dùng đã được chỉ định (với --smtp-người dùng hoặc một sendemail.smtpNgười dùng), Nhưng
không có mật khẩu nào được chỉ định (với --smtp-pass or gửiemail.smtpPass), thì một
mật khẩu được lấy bằng cách sử dụng git-thông tin đăng nhập.

--smtp-máy chủ=
Nếu được đặt, hãy chỉ định máy chủ SMTP thư đi sẽ sử dụng (ví dụ: smtp.example.com hoặc IP thô
Địa chỉ). Ngoài ra, nó có thể chỉ định tên đường dẫn đầy đủ của chương trình giống như sendmail
thay vì; chương trình phải hỗ trợ tùy chọn -i. Giá trị mặc định có thể được chỉ định bởi
sendemail.smtpServer tùy chọn cấu hình; mặc định tích hợp là / usr / sbin / sendmail
or / usr / lib / sendmail nếu chương trình đó có sẵn, hoặc localhost nếu không.

--smtp-server-port=
Chỉ định một cổng khác với cổng mặc định (máy chủ SMTP thường lắng nghe
cổng smtp 25, nhưng cũng có thể nghe cổng gửi 587 hoặc cổng smtp SSL phổ biến
465); tên cổng tượng trưng (ví dụ: "gửi" thay vì 587) cũng được chấp nhận. Các
cổng cũng có thể được thiết lập với sendemail.smtpServerPort biến cấu hình.

--smtp-server-option=
Nếu được đặt, hãy chỉ định tùy chọn máy chủ SMTP gửi đi để sử dụng. Giá trị mặc định có thể là
được chỉ định bởi sendemail.smtpServerOption tùy chọn cấu hình.

Tùy chọn --smtp-server-option phải được lặp lại cho mỗi tùy chọn bạn muốn chuyển tới
máy chủ. Tương tự như vậy, các dòng khác nhau trong tệp cấu hình phải được sử dụng cho mỗi
tùy chọn.

--smtp-ssl
Bí danh kế thừa cho --mã hóa smtp ssl.

--smtp-ssl-cert-path
Đường dẫn đến kho lưu trữ chứng chỉ CA đáng tin cậy để xác thực chứng chỉ SSL/TLS của SMTP
(hoặc một thư mục đã được xử lý bởi c_rehashhoặc một tệp chứa
một hoặc nhiều chứng chỉ định dạng PEM được nối với nhau: xem xác minh(1) -CAfile và
-CApath để biết thêm thông tin về những điều này). Đặt nó thành một chuỗi trống để tắt
xác minh chứng chỉ. Mặc định về giá trị của gửiemail.smtpsslcertpath
biến cấu hình, nếu được đặt hoặc mặc định được biên dịch sẵn của thư viện SSL dự phòng
mặt khác (nên là lựa chọn tốt nhất trên hầu hết các nền tảng).

--smtp-người dùng=
Tên người dùng cho SMTP-AUTH. Mặc định là giá trị của sendemail.smtpNgười dùng; nếu tên người dùng là
không được chỉ định (với --smtp-người dùng or sendemail.smtpNgười dùng), thì xác thực không được
đã cố gắng.

--smtp-debug=0|1
Bật (1) hoặc tắt (0) đầu ra gỡ lỗi. Nếu được bật, các lệnh và trả lời SMTP sẽ được
được in. Hữu ích để gỡ lỗi các vấn đề về kết nối và xác thực TLS.

Tự động hóa
--to-cmd=
Chỉ định một lệnh để thực thi một lần cho mỗi tệp bản vá sẽ tạo tệp bản vá
mục "Tới:" cụ thể. Đầu ra của lệnh này phải là một địa chỉ email duy nhất trên mỗi dòng.
Mặc định là giá trị của gửi email.tocmd giá trị cấu hình.

--cc-cmd=
Chỉ định một lệnh để thực thi một lần cho mỗi tệp bản vá sẽ tạo tệp bản vá
mục "Cc:" cụ thể. Đầu ra của lệnh này phải là một địa chỉ email duy nhất trên mỗi dòng.
Mặc định là giá trị của gửiemail.ccCmd giá trị cấu hình.

--[no-]chuỗi-trả lời
Nếu cài đặt này được đặt, mỗi email sẽ được gửi dưới dạng thư trả lời cho email đã gửi trước đó. Nếu như
bị vô hiệu hóa bằng "--no-chain-reply-to", tất cả email sau email đầu tiên sẽ được gửi dưới dạng
trả lời email đầu tiên được gửi. Khi sử dụng tính năng này, điều đầu tiên được khuyến nghị là
tập tin được đưa ra là một cái nhìn tổng quan về toàn bộ loạt bản vá. bị tắt theo mặc định, nhưng
sendemail.chainReplyTo biến cấu hình có thể được sử dụng để kích hoạt nó.

--danh tính=
Một danh tính cấu hình. Khi được đưa ra, sẽ gây ra các giá trị trong gửi email.
tiểu mục được ưu tiên hơn các giá trị trong gửi email phần. Mặc định
danh tính là giá trị của gửiemail.identity.

--[no-]đã ký-off-by-cc
Nếu điều này được đặt, hãy thêm các email được tìm thấy trong dòng Signed-off-by: hoặc Cc: vào danh sách cc.
Mặc định là giá trị của gửiemail.signedoffbycc giá trị cấu hình; Nếu đó là
không xác định, mặc định là --signed-off-by-cc.

--[không-]cc-che
Nếu cài đặt này được đặt, các email được tìm thấy trong tiêu đề Cc: trong bản vá đầu tiên của chuỗi
(thường là thư xin việc) được thêm vào danh sách cc cho mỗi bộ email. Mặc định là
giá trị của gửiemail.cccover giá trị cấu hình; nếu điều đó không được chỉ định, mặc định là
--no-cc-che.

--[không-]để che
Nếu cài đặt này được đặt, các email được tìm thấy trong tiêu đề To: trong bản vá đầu tiên của chuỗi
(thường là thư xin việc) được thêm vào danh sách cần gửi cho mỗi bộ email. Mặc định là
giá trị của gửiemail.tocover giá trị cấu hình; nếu điều đó không được chỉ định, mặc định là
--không-để-che đậy.

--suppress-cc=
Chỉ định danh mục người nhận bổ sung để ngăn chặn tự động cc của:

· tác giả sẽ tránh bao gồm tác giả bản vá

· tự sẽ tránh bao gồm người gửi

· cc sẽ tránh bao gồm bất kỳ ai được đề cập trong dòng Cc trong tiêu đề bản vá ngoại trừ
cho bản thân (sử dụng tự cho rằng).

· bodycc sẽ tránh bao gồm bất kỳ ai được đề cập trong dòng Cc trong nội dung bản vá (cam kết
tin nhắn) ngoại trừ bản thân (sử dụng tự cho rằng).

· nức nở sẽ tránh bao gồm bất kỳ ai được đề cập trong dòng Đã đăng xuất ngoại trừ bản thân
(sử dụng tự cho rằng).

· cccmd sẽ tránh chạy --cc-cmd.

· thân hình tương đương với nức nở + bodycc

· tất cả các sẽ chặn tất cả các giá trị cc tự động.

Mặc định là giá trị của gửiemail.suppresscc giá trị cấu hình; Nếu đó là
không xác định, mặc định là tự nếu --suppress-from được chỉ định, cũng như thân hình if
--no-signed-off-cc được chỉ định.

--[không-]chặn-từ
Nếu điều này được đặt, không thêm địa chỉ From: vào danh sách cc:. Mặc định là giá trị của
gửiemail.suppressFrom giá trị cấu hình; nếu điều đó không được chỉ định, mặc định là
--không-chặn-từ.

--[no-]chủ đề
Nếu điều này được đặt, tiêu đề Trả lời và Tài liệu tham khảo sẽ được thêm vào mỗi email
đã gửi. Liệu mỗi thư có đề cập đến email trước đó hay không (phân luồng sâu trên mỗi git
định dạng-bản vá từ ngữ) hoặc đến email đầu tiên (luồng nông) được điều chỉnh bởi
"--[không-]trả lời theo chuỗi".

Nếu bị tắt bằng "--no-thread", những tiêu đề đó sẽ không được thêm vào (trừ khi được chỉ định bằng
--trả lời). Mặc định là giá trị của gửiemail.thread giá trị cấu hình; nếu như
không được chỉ định, mặc định là --thread.

Người dùng có quyền đảm bảo rằng không có tiêu đề In-Reply-To nào tồn tại khi git
gửi email được yêu cầu thêm nó (đặc biệt lưu ý rằng git định dạng-bản vá có thể được cấu hình
để tự thực hiện việc xâu chuỗi). Nếu không làm như vậy có thể không mang lại kết quả mong đợi trong
MUA của người nhận.

Quản trị
--xác nhận=
Xác nhận ngay trước khi gửi:

· luôn luôn sẽ luôn xác nhận trước khi gửi

· không bao giờ sẽ không bao giờ xác nhận trước khi gửi

· cc sẽ xác nhận trước khi gửi khi email gửi tự động thêm địa chỉ
từ bản vá đến danh sách Cc

· soạn nhạc sẽ xác nhận trước khi gửi tin nhắn đầu tiên khi sử dụng --compose.

· tự động tương đương với cc + soạn nhạc

Mặc định là giá trị của gửi email.xác nhận giá trị cấu hình; nếu điều đó không được chỉ định,
mặc định là tự động trừ khi bất kỳ tùy chọn ngăn chặn nào được chỉ định, trong trường hợp đó
mặc định là soạn nhạc.

- chạy thử
Làm mọi thứ ngoại trừ việc thực sự gửi email.

--[no-]bản vá định dạng
Khi một đối số có thể được hiểu là tham chiếu hoặc tên tệp, hãy chọn
hiểu nó như một đối số bản vá định dạng (--format-patch) hoặc dưới dạng tên tệp
(--no-format-patch). Theo mặc định, khi xảy ra xung đột như vậy, git send-email sẽ
Thất bại.

--Yên lặng
Làm cho git-send-email bớt dài dòng hơn. Một dòng trên mỗi email sẽ là tất cả những gì được đưa ra.

--[không-]xác nhận
Thực hiện kiểm tra độ tỉnh táo trên các bản vá. Hiện tại, xác nhận có nghĩa như sau:

· Cảnh báo các bản vá có dòng dài hơn 998 ký tự; điều này là do SMTP
giới hạn như được mô tả bởi http://www.ietf.org/rfc/rfc2821.txt.

Mặc định là giá trị của gửiemail.xác nhận; nếu điều này không được đặt, mặc định là - xác thực.

--lực lượng
Gửi email ngay cả khi việc kiểm tra an toàn sẽ ngăn cản việc đó.

Thông tin
--dump-bí danh
Thay vì hoạt động bình thường, hãy bỏ tên bí danh tốc ký từ cấu hình
(các) tệp bí danh, mỗi tệp một dòng theo thứ tự bảng chữ cái. Lưu ý, điều này chỉ bao gồm bí danh
tên chứ không phải địa chỉ email mở rộng của nó. Nhìn thấy gửi email.aliasesfile để biết thêm
thông tin về bí danh.

CẤU HÌNH

sendemail.aliasesTệp
Để tránh nhập địa chỉ email dài, hãy trỏ địa chỉ này vào một hoặc nhiều tệp bí danh email.
Bạn cũng phải cung cấp sendemail.aliasFileType.

sendemail.aliasFileType
Định dạng của (các) tệp được chỉ định trong sendemail.aliasesFile. Phải là một trong người đần độn, thưrc,
cây thông, cây du, hoặc là linh dương đầu bò, hoặc là gửi thư.

Bạn có thể tìm thấy tệp bí danh ở mỗi định dạng trông như thế nào trong tài liệu của
chương trình email cùng tên. Sự khác biệt và hạn chế của tiêu chuẩn
định dạng được mô tả dưới đây:

gửi thư

· Bí danh và địa chỉ được trích dẫn không được hỗ trợ: các dòng chứa "
biểu tượng được bỏ qua.

· Chuyển hướng đến một tập tin (/path/name) hoặc đường ống (|lệnh) không được hỗ trợ.

· Việc bao gồm tập tin (:include: /path/name) không được hỗ trợ.

· Cảnh báo được in trên đầu ra lỗi tiêu chuẩn cho bất kỳ lỗi nào một cách rõ ràng
các cấu trúc không được hỗ trợ và bất kỳ dòng nào khác không được công nhận bởi
trình phân tích cú pháp.

sendemail.multiSửa đổi
Nếu đúng (mặc định), một phiên bản trình soạn thảo duy nhất sẽ được tạo ra để chỉnh sửa các tệp bạn phải
chỉnh sửa (bản vá khi --chú thích được sử dụng và tóm tắt khi --soạn, biên soạn Được sử dụng). Nếu như
sai, các tệp sẽ được chỉnh sửa lần lượt, tạo ra một trình soạn thảo mới mỗi lần.

gửi email.xác nhận
Đặt mặc định cho việc có xác nhận hay không trước khi gửi. Phải là một trong luôn luôn, không bao giờ,
cc, soạn nhạc, hoặc là tự động. Thấy --xác nhận ở phần trước để biết ý nghĩa của những điều này
các giá trị.

THÍ DỤ

Sử dụng gmail as các smtp máy chủ
sử dụng git gửi email để gửi các bản vá của bạn thông qua máy chủ GMail SMTP, hãy chỉnh sửa
~ / .gitconfig để chỉ định cài đặt tài khoản của bạn:

[gửi email]
smtpMã hóa = tls
smtpServer = smtp.gmail.com
smtpNgười dùng = [email được bảo vệ]
smtpServerPort = 587

Khi các cam kết của bạn đã sẵn sàng để được gửi đến danh sách gửi thư, hãy chạy các lệnh sau:

$ git format-patch --cover-letter -M Origin/master -o gửi đi/
$ chỉnh sửa gửi đi/0000-*
$ git gửi email gửi đi/*

Lưu ý: cần có các mô-đun Perl sau Net::SMTP::SSL, MIME::Base64 và
Xác thực::SASL

Sử dụng git-send-email trực tuyến bằng dịch vụ onworks.net