git-send-email - クラウドでオンライン

プログラム：

NAME

git-send-email - パッチのコレクションを電子メールとして送信します

SYNOPSIS

git メールを送る 【オプション】 ...
git メールを送る --ダンプエイリアス

DESCRIPTION

コマンドラインで指定されたパッチを取得し、電子メールで送信します。 パッチを指定できる
ファイル、ディレクトリ（ディレクトリ内のすべてのファイルを送信します）として、または直接
リビジョンリスト。 最後のケースでは、受け入れられる任意の形式 git-format-パッチ(1)は通過できる
git send-email へ。

電子メールのヘッダーは、コマンドライン オプションを使用して構成できます。 に指定されていない場合は、
コマンド ラインでは、ユーザーは ReadLine 対応インターフェイスを使用して、
必要な情報。

パッチ ファイルとして受け入れられる形式は XNUMX つあります。

1.mbox形式のファイル

これは何 git-format-パッチ(1) が生成されます。 ほとんどのヘッダーと MIME 形式は次のとおりです。
無視されます。

2. Greg Kroah-Hartman のオリジナル形式 send_lots_of_email.pl スクリプト

この形式では、ファイルの最初の行に「Cc:」値と
メッセージのXNUMX行目の「件名:」。

OPTIONS

作曲
-注釈を付ける
送信しようとしている各パッチを確認して編集します。 デフォルトは次の値です
sendemail.annotate。 詳細については「構成」セクションを参照してください。 sendemail.multi編集.

--bcc= 、...
各メールの「Bcc:」値を指定します。 デフォルトは次の値です sendemail.bcc.

このオプションは複数回指定できます。

--cc= 、...
各メールの開始値「Cc:」を指定します。 デフォルトは次の値です sendemail.cc.

このオプションは複数回指定できます。

-- 作成する
テキスト エディタを起動します (「GIT_EDITOR」を参照)。 git-var(1)) 紹介メッセージを編集するには
パッチシリーズ用。

日時 -- 作成する git send-email を使用すると、From、Subject、In-Reply-To が使用されます。
メッセージで指定されたヘッダー。 メッセージの本文 (メッセージの後に入力した内容)
ヘッダーと空行）には空行（または Git: プレフィックス付き）のみが含まれており、概要
は送信されませんが、From、Subject、および In-Reply-To ヘッダーは、そうでない限り使用されます。
除去された。

From ヘッダーまたは In-Reply-To ヘッダーが欠落している場合は、入力を求めるプロンプトが表示されます。

詳細については「構成」セクションを参照してください。 sendemail.multi編集.

--から=
電子メールの送信者を指定します。 コマンドラインで指定しない場合、値は
　 sendemail.from 構成オプションが使用されます。 どちらのコマンドラインオプションも使用しない場合
また sendemail.from が設定されている場合、ユーザーは値の入力を求められます。 デフォルト
プロンプトの値は 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 が指定されている場合、XNUMX 番目と
後続のパッチは、以下の図のように最初のパッチに対する応答になります。
ここで、[PATCH v2 0/3] は [PATCH 0/2] への応答です。

[パッチ 0/2] これが私がやったことです...
[パッチ 1/2] クリーンアップとテスト
【PATCH2/2】実装
【PATCH v2 0/3】リセマラはこちら
[PATCH v2 1/3] クリーンアップ
[PATCH v2 2/3] 新しいテスト
[PATCH v2 3/3]実装

--compose も設定されている場合にのみ必要です。 --compose が設定されていない場合、これは次のようになります。
と促されました。

--件名=
電子メール スレッドの最初の件名を指定します。 --compose も指定されている場合にのみ必要です
セット。 --compose が設定されていない場合は、これを求めるプロンプトが表示されます。

--to= 、...
生成される電子メールの主受信者を指定します。 一般に、これは次のようになります。
関与するプロジェクトの上流メンテナ。 デフォルトは、 sendemail.to
設定値。 それが指定されておらず、 --to-cmd が指定されていない場合、これは
を求められます。

このオプションは複数回指定できます。

--8ビットエンコーディング=
エンコーディングが宣言されていない非 ASCII メッセージまたは件名に遭遇した場合、
ヘッダー/引用符を追加して、エンコードされていることを示します。 デフォルトは次の値です
　 sendemail.assume8bitEncoding; それが指定されていない場合は、次の場合にプロンプ​​トが表示されます。
非 ASCII ファイルが見つかった場合。

エンコードを検証する試みはまったく行われないことに注意してください。

--compose-encoding=
作成メッセージのエンコーディングを指定します。 デフォルトは、
sendemail.composeencoding; それが指定されていない場合は、UTF-8 が想定されます。

--transfer-encoding=(7 ビット|8 ビット|quoted-printable|base64)
SMTP 経由でメッセージを送信するために使用する転送エンコーディングを指定します。 7ビットは失敗する
非 ASCII メッセージに遭遇したとき。 quote-printable は、次のような場合に役立ちます。
リポジトリには改行を含むファイルが含まれていますが、生のパッチは電子メールで送信されます。
(MUA から保存された) ファイルを手動で検査するのははるかに困難です。 Base64はさらに愚かです
証拠ですが、さらに不透明でもあります。 デフォルトは、
sendemail.transferEncoding 設定値。 それが指定されていない場合、git は使用します
8 ビットであり、Content-Transfer-Encoding ヘッダーは追加されません。

--xmailer、--no-xmailer
「X-Mailer:」ヘッダーを追加します (または追加を禁止します)。 デフォルトではヘッダーが付加されますが、
sendemail.xmailer 構成変数を false に設定することでオフにできます。

送信
--エンベロープ送信者=
電子メールの送信に使用されるエンベロープ送信者を指定します。 これはデフォルトの場合に便利です
address はリストに登録されているアドレスではありません。 を使用するには、
アドレスの場合は、値を「auto」に設定します。 sendmail バイナリを使用する場合は、次のものが必要です。
-f パラメータに適切な権限。 デフォルトは、
sendemail.envelopeSender 構成変数。 それが指定されていない場合は、
エンベロープ送信者は MTA に任されています。

--smtp-暗号化=
使用する暗号化を指定します。 SSL or TLS。 他の値はプレーンに戻ります
SMTP。 デフォルトは次の値です 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" ...

指定されたメカニズムの少なくとも XNUMX つが SMTP によってアドバタイズされたメカニズムと一致する場合
サーバーで使用され、使用されている SASL ライブラリによってサポートされている場合、そのメカニズムは次の目的で使用されます。
認証。 どちらでもない場合 sendemail.smtpAuth また --smtp-auth 指定されている、すべて
SASL ライブラリでサポートされているメカニズムを使用できます。

--smtp-pass[= ]
SMTP-AUTHのパスワード。 引数はオプションです。引数が指定されていない場合は、
空の文字列がパスワードとして使用されます。 デフォルトは次の値です sendemail.smtpPass,
しかしながら --smtp-パス 常にこの値をオーバーライドします。

さらに、設定ファイルやコマンドでパスワードを指定する必要はありません。
ライン。 ユーザー名が指定されている場合 ( --smtp-user または sendemail.smtpUser
パスワードが指定されていません( --smtp-パス or sendemail.smtpPass）、次に
パスワードは次を使用して取得されます git-資格情報.

--smtp-server=
設定されている場合、使用する送信 SMTP サーバーを指定します (例: smtp.example.com または raw IP)
住所）。 あるいは、sendmail のようなプログラムのフルパス名を指定することもできます。
その代わり; プログラムは -i オプションをサポートする必要があります。 デフォルト値は次のように指定できます。
sendemail.smtpサーバー 構成オプション。 組み込みのデフォルトは / usr / sbin / sendmail
or /usr/lib/sendmail そのようなプログラムが利用可能な場合は、それ以外の場合は localhost です。

--smtp-サーバーポート=
デフォルトのポートとは異なるポートを指定します (SMTP サーバーは通常、
smtp ポート 25 ですが、送信ポート 587 または一般的な SSL smtp ポートをリッスンすることもできます。
465); シンボリックポート名 (例: 587 の代わりに「submission」) も受け入れられます。 の
ポートは次のコマンドでも設定できます。 sendemail.smtpServerPort 構成変数。

--smtp-サーバーオプション=
設定した場合、使用する送信 SMTP サーバー オプションを指定します。 デフォルト値は次のとおりです
によって指定された sendemail.smtpServerOption 構成オプション。

--smtp-server-option オプションは、渡したいオプションごとに繰り返す必要があります。
サーバー。 同様に、構成ファイル内の異なる行をそれぞれに使用する必要があります。
オプションを選択します。

--smtp-ssl
のレガシーエイリアス --smtp-暗号化 SSL.

--smtp-ssl-cert-path
SMTP SSL/TLS 証明書検証用の信頼された CA 証明書のストアへのパス
(によって処理されたディレクトリのいずれか) c_rehash、または以下を含む単一のファイル
連結された XNUMX つ以上の PEM 形式の証明書: を参照してください。 確認する(1) -CAfile および
詳細については、-CApath)。 無効にするには空の文字列に設定します
証明書の検証。 デフォルトは、 sendemail.smtpsslcertpath
構成変数 (設定されている場合)、またはバッキング SSL ライブラリのコンパイル済みデフォルト
それ以外の場合は (ほとんどのプラットフォームではこれが最良の選択です)。

--smtp-user=
SMTP-AUTH のユーザー名。 デフォルトは次の値です sendemail.smtpUser; ユーザー名が
指定なし（あり --smtp-user or sendemail.smtpUser)、その場合、認証は行われません
試みた。

--smtp-debug=0|​​1
デバッグ出力を有効 (1) または無効 (0) にします。 有効にすると、SMTP コマンドと応答は次のようになります。
印刷された。 TLS 接続と認証の問題をデバッグするのに役立ちます。

自動化
--to-cmd=
パッチ ファイルを生成するパッチ ファイルごとに XNUMX 回実行するコマンドを指定します。
特定の「To:」エントリ。 このコマンドの出力は、XNUMX 行に XNUMX つの電子メール アドレスである必要があります。
デフォルトは次の値です sendemail.tocmd 設定値。

--cc-cmd=
パッチ ファイルを生成するパッチ ファイルごとに XNUMX 回実行するコマンドを指定します。
特定の「Cc:」エントリ。 このコマンドの出力は、XNUMX 行に XNUMX つの電子メール アドレスである必要があります。
デフォルトは次の値です sendemail.ccCmd 設定値。

--[no-]チェーン返信先
これを設定すると、各電子メールは、以前に送信された電子メールへの返信として送信されます。 もし
「--no-chain-reply-to」で無効にすると、最初のメール以降のすべてのメールは次のように送信されます。
最初に送信されたメールに返信します。 これを使用する場合は、最初に
ファイルには、パッチ シリーズ全体の概要が記載されています。 デフォルトでは無効になっていますが、
sendemail.chainReplyTo 構成変数を使用して有効にすることができます。

--アイデンティティ=
構成アイデンティティ。 指定すると、次の値が発生します。 メールを送る。
サブセクションの値よりも優先されます。 メールを送る セクション。 デフォルト
アイデンティティは次の値です sendemail.identity.

--[no-]cc によるサインオフ
これが設定されている場合、Signed-off-by: または Cc: 行で見つかった電子メールを CC リストに追加します。
デフォルトは次の値です sendemail.signedoffbycc 設定値。 それがあれば
未指定、デフォルトは --signed-off-by-cc です。

--[no-]cc-カバー
これが設定されている場合、シリーズの最初のパッチの Cc: ヘッダーで電子メールが検出されます。
(通常はカバーレター) は、各電子メール セットの cc リストに追加されます。 デフォルトは
の値 sendemail.cccover 設定値。 それが指定されていない場合は、デフォルトで
--cc-カバーなし。

--[no-]カバーする必要はありません
これが設定されている場合、シリーズの最初のパッチの To: ヘッダーで電子メールが検出されます。
(通常はカバーレター) が各電子メールセットの宛先リストに追加されます。 デフォルトは
の値 sendemail.tocover 設定値。 それが指定されていない場合は、デフォルトで
--カバーする必要はありません。

--suppress-cc=
受信者の追加カテゴリを指定して、次の自動 CC を抑制します。

· 著者 パッチの作成者を含めることを避けます

· 自己 送信者を含めないようにします

· cc パッチヘッダーの Cc 行に記載されている人物を含めることを避けます。
自分用（使う） 自己 そのため）。

· ボディcc パッチ本文の Cc 行に記載されている人物を含めることを避けます (コミット
メッセージ）自分以外（使用 自己 そのため）。

· すすり泣き 自分自身を除いて、サインオフ者行に記載されている人物を含めることを避けます
（つかいます 自己 そのため）。

· cccmd --cc-cmd の実行を回避します。

· ボディ に相当します すすり泣き + ボディcc

· を すべての auto cc 値を抑制します。

デフォルトは次の値です sendemail.suppresscc 設定値。 それがあれば
未指定、デフォルトは 自己 --suppress-from が指定されている場合、および ボディ if
--no-signed-off-cc が指定されています。

--[no-]抑制から
これが設定されている場合は、From: アドレスを cc: リストに追加しないでください。 デフォルトは次の値です
sendemail.suppressFrom 設定値。 それが指定されていない場合は、デフォルトで
--抑制なしから。

--[なし]スレッド
これを設定すると、In-Reply-To ヘッダーと References ヘッダーが各メールに追加されます。
送信済み。 各メールが前のメールを参照しているかどうか (ディープ スレッドごとに) git
フォーマットパッチ 文言) または最初のメール (浅いスレッド) は、次によって管理されます。
「--[no-]チェーン返信先」。

「--no-thread」で無効にすると、これらのヘッダーは追加されません（で指定されない限り）
--in-reply-to)。 デフォルトは、 sendemail.thread 設定値。 もし
これは未指定であり、デフォルトは --thread です。

In-Reply-To ヘッダーが存在しないことを確認するのはユーザーの責任です。 git
メールを送る それを追加するように求められます（特に注意してください） git フォーマットパッチ 構成可能
スレッド自体を実行します)。 そうしないと、期待した結果が得られない可能性があります。
受信者の MUA。

管理者
--確認=
送信直前に確認:

· 常に 送信する前に必ず確認します

· 決して 送信前に決して確認しない

· cc send-email がアドレスを自動的に追加する場合、送信前に確認します
パッチからCcリストまで

· 構成します --compose を使用すると、最初のメッセージを送信する前に確認されます。

· オート に相当します cc + 構成します

デフォルトは次の値です sendemail.confirm 設定値。 それが指定されていない場合は、
デフォルトは オート 抑制オプションが指定されていない限り、その場合は
デフォルトは 構成します.

-ドライラン
実際にメールを送信する以外のすべての操作を行います。

--[no-]フォーマットパッチ
引数が参照またはファイル名として理解される場合は、次のいずれかを選択します。
これを format-patch 引数として理解してください (--フォーマットパッチ) またはファイル名として
(--フォーマットパッチなし）。 デフォルトでは、このような競合が発生した場合、git send-email は
失敗します。

- 静かな
git-send-email の冗長性を軽減します。 出力されるのは電子メールごとに XNUMX 行だけです。

--[いいえ-]検証します
パッチの健全性チェックを実行します。 現在、検証とは次のことを意味します。

· 998 文字を超える行を含むパッチを警告します。 これは SMTP が原因です
で説明されている制限 http://www.ietf.org/rfc/rfc2821.txt.

デフォルトは次の値です sendemail.validate; これが設定されていない場合、デフォルトで - 検証.

- 力
安全性チェックによって送信できない場合でも、電子メールを送信します。

情報
--ダンプエイリアス
通常の操作の代わりに、設定されたファイルから短縮エイリアス名をダンプします。
エイリアス ファイル (アルファベット順で XNUMX 行に XNUMX つ)。 これにはエイリアスのみが含まれることに注意してください
展開された電子メール アドレスではなく、名前。 見る sendemail.aliases ファイル 詳細については、
エイリアスに関する情報。

CONFIGURATION

sendemail.aliases ファイル
長い電子メール アドレスを入力しないようにするには、これを XNUMX つ以上の電子メール エイリアス ファイルに指定します。
また、供給する必要があります sendemail.aliasFileType.

sendemail.aliasFileType
sendemail.aliasesFile で指定されたファイルの形式。 次のいずれかである必要があります 突然, メールRC,
松, エルムまたは グヌスまたは sendmail.

各形式のエイリアス ファイルがどのようなものであるかについては、
同名の電子メール プログラム。 標準との違いと制限事項
フォーマットについては以下で説明します。

sendmail

· 引用符で囲まれたエイリアスと引用符で囲まれたアドレスはサポートされていません: " を含む行
記号は無視されます。

· ファイル (/path/name) またはパイプ (|command) へのリダイレクトはサポートされていません。

· ファイルのインクルード (:include: /path/name) はサポートされていません。

· 明示的に警告が表示された場合、標準エラー出力に出力されます。
サポートされていない構成体、および によって認識されないその他の行。
パーサー。

sendemail.multi編集
true (デフォルト) の場合、必要なファイルを編集するために単一のエディター インスタンスが生成されます。
編集（パッチの場合） -注釈を付ける を使用した場合の概要 -- 作成する 使用されている）。 もし
false の場合、ファイルは次々に編集され、そのたびに新しいエディターが生成されます。

sendemail.confirm
送信前に確認するかどうかのデフォルトを設定します。 次のいずれかである必要があります 常に, 決して,
cc, 構成しますまたは オート。 見る - 確認 これらの意味については前のセクションで説明しています
値。

実施例

　 Gmailの as 　 SMTP
使用するには git メールを送る GMail SMTP サーバー経由でパッチを送信するには、編集します
〜/ .gitconfig アカウント設定を指定するには:

[メールを送る]
smtp暗号化 = tls
smtpServer = smtp.gmail.com
smtpユーザー = [メール保護]
smtpサーバーポート = 587

コミットをメーリング リストに送信する準備ができたら、次のコマンドを実行します。

$ git format-patch --cover-letter -M オリジン/マスター -o 送信/
$ 送信編集/0000-*
$ git send-email outcoming/*

注: 次の Perl モジュールが必要です。 Net::SMTP::SSL、MIME::Base64、および
Authen :: SASL

onworks.net サービスを使用してオンラインで git-send-email を使用する