git-send-email - 云端在线

程序：

您的姓名

git-send-email - 将补丁集作为电子邮件发送

概要

混帐 发电子邮件 [选项] ...
混帐 发电子邮件 --dump-别名

商品描述

获取命令行上给出的补丁并将其通过电子邮件发送出去。 可以指定补丁
作为文件、目录（将发送目录中的所有文件），或直接作为
修订清单。 在最后一种情况下，任何格式接受 git-格式补丁(1)可以通过
git 发送电子邮件。

电子邮件的标题可通过命令行选项进行配置。 如果没有在
命令行，将提示用户提供启用 ReadLine 的界面以提供
必要的信息。

补丁文件接受两种格式：

1.mbox格式文件

这是什么 git-格式补丁(1) 产生。 大多数标题和 MIME 格式是
忽略了。

2. Greg Kroah-Hartman 使用的原始格式 send_lots_of_email.pl 脚本

这种格式要求文件的第一行包含“抄送：”值和
“主题：”作为邮件的第二行。

配置

构成
- 注释
查看和编辑您将要发送的每个补丁。 默认值为
发送邮件.注释. 参见配置部分 sendemail.multi编辑.

--密件抄送= ，...
为每封电子邮件指定一个“密件抄送：”值。 默认值为 发送邮件.bcc.

可以多次指定此选项。

--cc= ，...
为每封电子邮件指定一个起始的“抄送：”值。 默认值为 发送邮件.cc.

可以多次指定此选项。

- 撰写
调用文本编辑器（参见 GIT_EDITOR git-var(1)) 编辑介绍性消息
对于补丁系列。

什么时候 - 撰写 使用时，git send-email 将使用 From、Subject 和 In-Reply-To
消息中指定的标头。 如果消息的正文（您在
headers 和一个空行）只包含空白（或 Git：前缀）行，摘要
不会被发送，但除非他们是，否则将使用 From、Subject 和 In-Reply-To 头
除去。

将提示缺少 From 或 In-Reply-To 标头。

参见配置部分 sendemail.multi编辑.

--来自=
指定电子邮件的发件人。 如果未在命令行中指定，则为
此 发件人 使用配置选项。 如果命令行选项都没有
也不 发件人 设置，然后将提示用户输入该值。 默认的
提示将是 GIT_AUTHOR_IDENT 的值，如果是 GIT_COMMITTER_IDENT
未设置，由“git var -l”返回。

--in-reply-to=
使第一封邮件（或所有带有 --no-thread 的邮件）显示为对给定的回复
Message-Id，可避免中断线程以提供新的补丁系列。 第二
随后的电子邮件将根据 --[no]-chain-reply-to 作为回复发送
设置。

例如，当 --thread 和 --no-chain-reply-to 被指定时，第二个和
后续补丁将回复第一个补丁，如下图所示
其中 [PATCH v2 0/3] 是对 [PATCH 0/2] 的回复：

[PATCH 0/2] 这就是我所做的......
[PATCH 1/2] 清理和测试
[补丁 2/2] 实现
[PATCH v2 0/3] 这是重播
[PATCH v2 1/3] 清理
[PATCH v2 2/3] 新测试
[PATCH v2 3/3] 实现

仅当还设置了 --compose 时才需要。 如果 --compose 没有设置，这将是
提示。

--主题=
指定电子邮件线程的初始主题。 仅当 --compose 也是必需的
放。 如果未设置--compose，则会提示输入。

--to= ，...
指定生成的电子邮件的主要收件人。 一般来说，这将是
所涉及项目的上游维护者。 默认值为 发送电子邮件.to
配置值； 如果未指定，并且未指定 --to-cmd，这将
被提示。

可以多次指定此选项。

--8位编码=
当遇到未声明其编码的非 ASCII 消息或主题时，
添加标题/引用以表明它被编码. 默认值为
此 sendemail.assume8bitEncoding; 如果未指定，则会提示是否
遇到任何非 ASCII 文件。

请注意，不会进行任何尝试来验证编码。

--compose-encoding=
指定撰写消息的编码。 默认值为
发送邮件.composeencoding; 如果未指定，则假定为 UTF-8。

--transfer-encoding=(7bit|8bit|quoted-printable|base64)
指定用于通过 SMTP 发送邮件的传输编码。 7bit 会失败
遇到非 ASCII 消息时。 当
存储库包含包含回车的文件，但使原始补丁电子邮件
文件（从 MUA 保存）更难手动检查。 base64 更傻
证明，但也更加不透明。 默认值为
发送邮件.transferEncoding 配置值； 如果未指定，git 将使用
8bit 并且不添加 Content-Transfer-Encoding 标头。

--xmailer, --no-xmailer
添加（或阻止添加）“X-Mailer:”标题。 默认情况下，添加标题，但
可以通过将 sendemail.xmailer 配置变量设置为 false 来关闭它。

发出
--信封发件人=
指定用于发送电子邮件的信封发件人。 如果您的默认设置，这很有用
地址不是订阅列表的地址。 为了使用 从
地址，将值设置为“自动”。 如果您使用 sendmail 二进制文件，则必须具有
-f 参数的合适权限。 默认值为
发送邮件.envelopeSender 配置变量； 如果未指定，则选择
信封发件人留给您的 MTA。

--smtp-加密=
指定要使用的加密，或者 SSL or TLS. 任何其他值都恢复为普通值
邮件发送。 默认值为 sendemail.smtp加密.

--smtp-域=
将 HELO/EHLO 命令中使用的完全限定域名 (FQDN) 指定给
SMTP 服务器。 某些服务器需要 FQDN 来匹配您的 IP 地址。 如果没有设置，git
send-email 尝试自动确定您的 FQDN。 默认值为
sendemail.smtp域.

--smtp-auth=
允许的 SMTP-AUTH 机制的空白分隔列表。 此设置强制使用
仅列出的机制。 例子：

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

如果至少一种指定的机制与 SMTP 通告的机制相匹配
服务器，如果使用的 SASL 库支持它，则该机制用于
验证。 如果两者都没有 发送邮件.smtpAuth 也不 --smtp 验证 被指定，所有
可以使用 SASL 库支持的机制。

--smtp-pass[= ]
SMTP-AUTH 的密码。 参数是可选的：如果没有指定参数，则
空字符串用作密码。 默认值为 发送邮件.smtpPass,
但 --smtp-通过 始终覆盖此值。

此外，不需要在配置文件或命令中指定密码
线。 如果已指定用户名（使用 --smtp-用户 或者 sendemail.smtp用户），但
没有指定密码（使用 --smtp-通过 or 发送邮件.smtpPass)，那么一个
密码是使用 git凭证.

--smtp-服务器=
如果设置，则指定要使用的外发 SMTP 服务器（例如 smtp.example.com 或原始 IP
地址）。 或者，它可以指定类似 sendmail 的程序的完整路径名
反而; 程序必须支持 -i 选项。 默认值可以由
发送邮件.smtpServer 配置选项； 内置默认值是 /usr/sbin/发送邮件
or /usr/lib/发送邮件 如果此类程序可用，否则为 localhost。

--smtp-server-port=
指定与默认端口不同的端口（SMTP 服务器通常侦听
smtp 端口 25，但也可以侦听提交端口 587，或常见的 SSL smtp 端口
第465章符号端口名称（例如“提交”而不是 587）也被接受。 这
端口也可以用 发送邮件.smtp服务器端口 配置变量。

--smtp-server-option=
如果设置，则指定要使用的外发 SMTP 服务器选项。 默认值可以是
由指定 sendemail.smtpServerOption 配置选项。

--smtp-server-option 选项必须为要传递给的每个选项重复
服务器。 同样，配置文件中的不同行必须用于每个
选项。

--smtp-ssl
旧别名 --smtp-加密 SSL.

--smtp-ssl-证书路径
用于 SMTP SSL/TLS 证书验证的可信 CA 证书存储路径
（或者已经处理过的目录 c_rehash, 或包含
一个或多个 PEM 格式证书连接在一起：请参阅 确认(1) -CAfile 和
-CApath 有关这些的更多信息）。 将其设置为空字符串以禁用
证书验证。 默认为 发送邮件.smtpsslcertpath
配置变量（如果已设置）或支持 SSL 库的编译默认值
否则（这应该是大多数平台上的最佳选择）。

--smtp-用户=
SMTP-AUTH 的用户名。 默认值为 sendemail.smtp用户; 如果用户名是
未指定（与 --smtp-用户 or sendemail.smtp用户)，则身份验证不是
尝试过。

--smtp-debug=0|​​1
启用 (1) 或禁用 (0) 调试输出。 如果启用，SMTP 命令和回复将是
打印。 用于调试 TLS 连接和身份验证问题。

自动化
--to-cmd=
指定每个补丁文件执行一次的命令，该命令应生成补丁文件
特定的“收件人：”条目。 此命令的输出必须是每行单个电子邮件地址。
默认值为 发送邮件.tocmd 配置值。

--cc-cmd=
指定每个补丁文件执行一次的命令，该命令应生成补丁文件
特定的“抄送：”条目。 此命令的输出必须是每行单个电子邮件地址。
默认值为 发送邮件.ccCmd 配置值。

--[无-]连锁回复
如果设置了此项，则每封电子邮件都将作为对上一封电子邮件的回复发送。 如果
使用“--no-chain-reply-to”禁用，第一个之后的所有电子邮件将作为
回复发送的第一封电子邮件。 使用时，建议先
给出的文件是整个补丁系列的概述。 默认情况下禁用，但
sendemail.chainReplyTo 配置变量可用于启用它。

--身份=
配置标识。 当给定时，导致值在 发电子邮件。
小节优先于中的值 发电子邮件 部分。 默认的
身份是价值 发送邮件.identity.

--[no-] 签字人抄送
如果已设置，请将在 Signed-off-by: 或 Cc: 行中找到的电子邮件添加到抄送列表。
默认值为 sendemail.signedoffbycc 配置值； 如果那是
未指定，默认为 --signed-off-by-cc。

--[无-]抄送封面
如果设置了此项，则在 Cc: 系列第一个补丁中的标题中找到的电子邮件
（通常是求职信）被添加到每个电子邮件集的抄送列表中。 默认是
的值 发送邮件.cccover 配置值； 如果未指定，则默认为
--no-cc-cover。

--[无-]覆盖
如果设置了这个，在 To: 中找到的电子邮件系列的第一个补丁中的标题
（通常是求职信）被添加到每个电子邮件集的列表中。 默认是
的值 发送邮件.tocover 配置值； 如果未指定，则默认为
——无遮掩。

--suppress-cc=
指定额外的收件人类别以禁止自动抄送：

· 作者 将避免包括补丁作者

· 自 将避免包括发件人

· cc 将避免在补丁标题中包含 Cc 行中提到的任何人，除了
为自己（使用 自 为了那个原因）。

· 正文 将避免在补丁正文中包含 Cc 行中提到的任何人（提交
消息）除了自我（使用 自 为了那个原因）。

· 呜咽 将避免包括除 self 之外的 Signed-off-by 行中提到的任何人
（使用 自 为了那个原因）。

· CCMD 将避免运行 --cc-cmd。

· 身体 相当于 呜咽 + 正文

· 所有 将抑制所有 auto cc 值。

默认值为 发送邮件.suppresscc 配置值； 如果那是
未指定，默认为 自 如果指定了 --suppress-from，以及 身体 if
--no-signed-off-cc 已指定。

--[no-]抑制自
如果已设置，请勿将 From: 地址添加到 cc: 列表中。 默认值为
发送邮件.suppressFrom 配置值； 如果未指定，则默认为
--no-suppress-from。

--[无-]线程
如果设置了此项，则回复和引用标题将添加到每封电子邮件中
发送。 每封邮件是否引用前一封邮件（每封深线程 混帐
格式补丁 措辞）或第一封电子邮件（浅线程）受
“--[no-]chain-reply-to”。

如果使用“--no-thread”禁用，则不会添加这些标头（除非指定
--in-reply-to）。 默认值为 发送邮件线程 配置值； 如果
这是未指定的，默认为--thread。

由用户确保在以下情况下不存在 In-Reply-To 标头 混帐
发电子邮件 被要求添加它（特别注意 混帐 格式补丁 可以配置
自己做线程）。 不这样做可能不会产生预期的结果
接收者的 MUA。

管理
--确认=
发送前确认：

· 时刻 将始终在发送前确认

· 决不要 永远不会在发送前确认

· cc 当发送电子邮件已自动添加地址时，将在发送前确认
从补丁到抄送列表

· 撰写 将在使用 --compose 发送第一条消息之前进行确认。

· 汽车 相当于 cc + 撰写

默认值为 发送邮件.confirm 配置值； 如果这是未指定的，
默认为 汽车 除非已指定任何抑制选项，在这种情况下
默认为 撰写.

--试运行
做除了实际发送电子邮件之外的所有事情。

--[no-] 格式补丁
当参数可以理解为引用或文件名时，选择
将其理解为格式补丁参数（--格式补丁) 或作为文件名
(--无格式补丁）。 默认情况下，当发生这种冲突时， git send-email 会
失败。

- 安静的
使 git-send-email 不那么冗长。 每封电子邮件的一行应该是全部输出。

--[no-] 验证
对补丁执行健全性检查。 目前，验证的含义如下：

· 警告包含超过 998 个字符的行的补丁； 这是由于 SMTP
所描述的限制 http://www.ietf.org/rfc/rfc2821.txt.

默认值为 发送邮件.验证; 如果没有设置，默认为 - 证实.

- 力量
即使安全检查会阻止它，也要发送电子邮件。

资讯
--dump-别名
代替正常操作，从配置中转储速记别名
别名文件，按字母顺序每行一个。 请注意，这仅包括别名
名称而不是其扩展的电子邮件地址。 看 sendemail.aliases 文件 更多
有关别名的信息。

配置

sendemail.aliases文件
为避免输入过长的电子邮件地址，请将其指向一个或多个电子邮件别名文件。
您还必须提供 sendemail.aliasFileType.

sendemail.aliasFileType
sendemail.aliasesFile 中指定的文件格式。 必须是其中之一 傻子, 邮箱,
松树, 榆树或 金牛座或 发邮件.

可以在文档中找到每种格式的别名文件的样子
同名的电子邮件程序。 与标准的差异和限制
格式描述如下：

发邮件

· 不支持带引号的别名和带引号的地址：包含“
符号被忽略。

· 不支持重定向到文件（/path/name）或管道（|command）。

· 不支持文件包含（:include: /path/name）。

· 任何明确的警告都打印在标准错误输出上
不受支持的结构，以及任何其他不被识别的行
解析器。

sendemail.multi编辑
如果为 true（默认），将生成一个编辑器实例来编辑您必须编辑的文件
编辑（补丁时 - 注释 使用，并且摘要时 - 撰写 用来）。 如果
false，文件将一个接一个地编辑，每次生成一个新的编辑器。

发送邮件.confirm
设置发送前是否确认的默认值。 必须是其中之一 时刻, 决不要,
cc, 撰写或 汽车。 看 - 确认 在上一节中，这些的含义
值。

例

使用 Gmail的 as 此 SMTP 服务器
使用 混帐 发电子邮件 要通过 GMail SMTP 服务器发送您的补丁，请编辑
〜/ .gitconfig 指定您的帐户设置：

[发电子邮件]
smtp加密= tls
smtp服务器 = smtp.gmail.com
smtp 用户 = [电子邮件保护]
SMTP 服务器端口 = 587

一旦您的提交准备好发送到邮件列表，请运行以下命令：

$ git format-patch --cover-letter -M origin/master -o out/
$ 编辑传出/0000-*
$ git send-email 传出/*

注意：需要以下 perl 模块 Net::SMTP::SSL、MIME::Base64 和
验证::SASL

使用 onworks.net 服务在线使用 git-send-email