git-send-email(1) Manual Page

送信しようとしている各パッチを確認して編集します。 デフォルトは sendemail.annotate の値です。 `sendemail.multiEdit`の「CONFIGURATION」セクションを参照してください。

メールごとに「Bcc:」の値を指定します。 デフォルトは sendemail.bcc の値です。

各電子メールの開始「Cc:」値(starting "Cc:" value)を指定します。 デフォルトは sendemail.cc の値です。

テキストエディタ(git-var(1)の GIT_EDITOR 参照)を呼び出して、パッチシリーズの紹介メッセージ(introductory message)を編集します。

電子メールの送信者(sender)を指定します。 コマンドラインで指定されていない場合は、sendemail.from 構成オプションの値が使用されます。 コマンドラインオプションも sendemail.from も設定されていない場合、ユーザーは値の入力を求められます。 そのプロンプトのデフォルトは、 git var -l によって返される、GIT_AUTHOR_IDENTの値、または、GIT_AUTHOR_IDENTが設定されていない場合はGIT_COMMITTER_IDENTの値になります。

受信者からの返信先(reply)のアドレスを指定します。 メッセージへの応答(reply)が --from パラメーターで指定されたものとは別のアドレスに送信される必要がある場合は、これを使用します。

最初のメール(または --no-thread 指定の全てのメール)を、指定の Message-ID への応答(reply)として表示します。これにより、スレッドが壊れて新しいパッチシリーズが提供されるのを防ぎます。 2回目以降のメールは、 --[no-]chain-reply-to 設定に従って返信(reply)として送信されます。

[PATCH 0/2] Here is what I did...
  [PATCH 1/2] Clean up and tests
  [PATCH 2/2] Implementation
  [PATCH v2 0/3] Here is a reroll
    [PATCH v2 1/3] Clean up
    [PATCH v2 2/3] New tests
    [PATCH v2 3/3] Implementation

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

生成された電子メールの主な受信者(primary recipient)を指定します。 通常、これは関連するプロジェクトの上流のメンテナになります。 デフォルトは、 sendemail.to 構成値の値です。 それが指定されておらず、 --to-cmd が指定されていない場合、プロンプトが表示されます。

エンコードを宣言していない非ASCIIメッセージまたは件名に遭遇した場合は、 ヘッダー/引用符 を追加して、<encoding>でエンコードされていることを示します。 デフォルトは sendemail.assume8bitEncoding の値です。 それが指定されていない場合に非ASCIIファイルが検出された場合はプロンプトが表示されます。

作成するッセージのエンコードを指定します。 デフォルトは sendemail.composeencoding の値です。 それが指定されていない場合は、UTF-8 を想定されます。

SMTP経由でメッセージを送信するために使用する転送エンコーディングを指定します。 非ASCIIメッセージに遭遇すると、 7bit は失敗します。 quoted-printable は、リポジトリにキャリッジリターンを含むファイルが含まれている場合に役立ちますが、生のパッチ電子メールファイル(MUAで保存されたもの)を手動で検査するのがとても難しくなります。 base64 はさらに確実ですが、さらに不透明です。 auto は、可能な場合は8ビットを使用し、それ以外の場合は quoted-printable を使用します。

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

メールの送信に使用するエンベロープ(envelope)の送信者を指定します。 これは、デフォルトのメールアドレスがメーリングリストに申し込まれているメールアドレスではない場合に役立ちます。 From アドレスを使用するには、値を auto 」に設定します。 sendmailバイナリを使用する場合は、 -f パラメータに適切な権限が必要です。 デフォルトは、 sendemail.envelopeSender 構成変数の値です。 それが指定されていない場合、エンベロープ送信者の選択はMTAに任されています。

電子メールを送信するために実行するコマンドを指定します。 コマンドはsendmailのようなものでなければなりません。 具体的には、 -i オプションをサポートする必要があります。 コマンドは、必要に応じてシェルで実行されます。 デフォルトは sendemail.sendmailcmd 構成の値です。 sendemail.sendmailcmd 構成の値が指定されていない場合、かつ、 --smtp-server も指定されていない場合、 git-send-email は /usr/sbin と /usr/lib と $PATH で sendmail を検索します。

SMTP 接続の暗号化を開始する方法を指定します。有効な値は ssl と tls です。その他の値はプレーン(暗号化されていない) SMTP に戻り、デフォルトはポート 25 になります。 ssl と tls という名前に関係なく、どちらの値も同じ新しいバージョンの TLS を使用しますが、歴史的な理由からこれらの名前が付けられています。 ssl とは「暗黙的」暗号化 (しばしば SMTPS とも呼ばれる)を指し、デフォルトでポート 465 を使用します。 tls とは、デフォルトでポート 25 を使用する「明示的」暗号化(しばしば STARTTLS と呼ばれる)を指します。 SMTP サーバーでは他のポートが使用される場合がありますが、これはデフォルトではありません。一般的に TLS および暗号化されていない代替ポートは 587 です。プロバイダーのドキュメントまたはサーバー構成を確認して、自分の場合にに当てはまるかどうかを確認する必要があります。 デフォルトは sendemail.smtpEncryption の値です。

SMTPサーバーへの HELO/EHLO コマンドで使用される完全修飾ドメイン名(FQDN)を指定します。 一部のサーバーでは、FQDNがIPアドレスと一致する必要があります。 設定されていない場合、 git send-email はFQDNを自動的に判別しようとします。 デフォルトは sendemail.smtpDomain の値です。

許可されたSMTP-AUTHメカニズムの空白で区切られた(Whitespace-separated)リスト。 この設定は、リストされたメカニズムのみを使用するように強制します。 例:

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

SMTP-AUTHのパスワード。 引数はオプションです。引数が指定されていない場合は、空の文字列がパスワードとして使用されます。 デフォルトは sendemail.smtpPass の値ですが、 --smtp-pass は常に sendemail.smtpPass の値を上書きします。

SMTP認証を無効にします。 --smtp-auth=none の省略形

設定されている場合、使用する送信SMTPサーバを指定します(例: smtp.example.com または生のIPアドレス)。 これが未指定の場合で、かつ、 --sendmail-cmd も未指定の場合、デフォルトでは /usr/sbin と /usr/lib と $PATH にある sendmail を探します。それが存在しなければ localhost にフォールバックされます。

デフォルトのポートとは異なるポートを指定します(SMTPサーバーは通常smtpポート25をリッスンしますが、送信ポート587または共通のSSL smtpポート465もリッスンする場合があります)。 シンボリックポート名(たとえば、587ではなく "submission")も受け入れられます。 ポートは、 sendemail.smtpServerPort 構成変数を使用して設定することもできます。

設定されている場合、使用する送信SMTPサーバーオプションを指定します。 デフォルト値は、 sendemail.smtpServerOption 構成オプションで指定できます。

--smtp-encryptionssl の、大昔からのエイリアス。

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

SMTP-AUTHのユーザー名。 デフォルトは sendemail.smtpUser の値です。 (--smtp-user または sendemail.smtpUser で)ユーザー名が指定されていない場合、認証は試行されません。

デバッグ出力を有効(1)または無効(0)にします。 有効にすると、SMTPコマンドとその応答が出力されます。 TLS接続と認証の問題をデバッグするのに役立ちます。

一部の電子メールサーバー(たとえば smtp.163.com)では、セッション(または接続)ごとに送信される電子メールの数が制限されているため、多くのメッセージを送信すると失敗します。 このオプションを使用すると、send-email は <num> メッセージの送信後に切断され、数秒待って(--relogin-delay 参照)、再接続して、このような制限を回避します。 これが発生するたびにパスワードを再入力する必要がないように、何らかの形式のクレデンシャルヘルパーを使用することをお勧めします。 デフォルトは sendemail.smtpBatchSize 構成変数です。

SMTPサーバーに再接続する前に <int> 秒待機します。 --batch-size オプションと一緒に使用します。 デフォルトは sendemail.smtpReloginDelay 構成変数です。

configで以前に設定した "To:" と "Cc:" と "Bcc:" アドレスのリストをすべてクリアします。

configで設定された sendemail.identity から読み取られた値があるならば、その値をクリアします。

パッチファイルごとに1回実行するコマンドを指定し、パッチファイル固有の To: エントリーを生成するようにします。 このコマンドの出力は、1行に1つの電子メールアドレスでなければなりません。 デフォルトは、設定値 sendemail.tocmd の値です。

パッチファイルごとに1回実行するコマンドを指定し、パッチファイル固有の Cc: エントリを生成するようにします。 このコマンドの出力は、1行に1つの電子メールアドレスでなければなりません。 デフォルトは sendemail.ccCmd 設定値の値です。

送信メッセージごとに 1 回実行されるコマンドを指定し、 送信メッセージに挿入される RFC 2822 スタイルのヘッダー行を出力します。 sendemail.headerCmd 構成変数が設定されている場合、その値が常に使用されます。 --header-cmd がコマンド・ラインで指定された場合、その値は sendemail.headerCmd 構成変数よりも優先されます。

使用中のヘッダー・コマンドを無効にします。

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

構成ID。 指定すると、 sendemail.<identity> サブセクションの値が sendemail セクションの値よりも優先されます。 デフォルトのIDは、 `sendemail.identity`の値です。

これが設定されている場合は、 Signed-off-by トレーラーまたは Cc: 行にある電子メールアドレスをccリストに追加します。 デフォルトは sendemail.signedoffbycc 構成変数の値です。 sendemail.signedoffbycc 構成変数が指定されていない場合、デフォルトは --signed-off-by-cc です。

これが設定されている場合、シリーズの最初のパッチ(通常はカバーレター)の Cc: ヘッダー達で見つかった電子メールアドレスが、各電子メールアドレスのセットのccリストに追加されます。 デフォルトは、 sendemail.cccover 構成の値です。 sendemail.cccover 構成が指定されていない場合、デフォルトは --no-cc-cover です。

これが設定されている場合、シリーズの最初のパッチ(通常はカバーレター)の To: ヘッダー達で見つかった電子メールアドレスが、各電子メールアドレスのセットのtoリストに追加されます。 デフォルトは、 sendemail.tocover 構成の値です。 sendemail.tocover 構成の値が指定されていない場合、デフォルトで --no-to-cover になります。

自動CC(auto-cc)を抑制するために、以下の追加受信者カテゴリを指定します:

これが設定されている場合は、 From: アドレス を cc: リストに追加しないでください。 デフォルトは sendemail.suppressFrom 構成の値です。 sendemail.suppressFrom 構成が指定されていない場合、デフォルトは --no-suppress-from です。

これが設定されている場合、In-Reply-To と References ヘッダー達は送信される各メールアドレスに追加されます。 各メールが前のメールを参照するのか(git format-patch の文言に従った「深い」(deep)スレッディング)、最初のメールを参照するのか(「浅い」(shallow)スレッディング)については --[no-]chain-reply-to で制御されます。

送信する直前に確認(confirm)します:

実際にメールを送信する以外はすべて行います。

引数が参照またはファイル名として理解される場合は、それをformat-patch引数(--format-patch)またはファイル名(--no-format-patch)として理解することを選択します。 デフォルトでは、このような競合が発生すると、 git send-email は失敗します。

git-send-emailのおしゃべりを減らします。 電子メール１通につき1行出力するだけにします。

パッチの健全性チェックを実行します。 現状、検証(validation)とは以下のことを意味します:

安全チェックで防止できる場合でも、電子メールを送信してください。

通常の操作の代わりに、構成されたエイリアスファイルからアルファベット順に1行に1つずつ短縮エイリアス名をダンプします。 これにはエイリアス名のみが含まれ、拡張された電子メールアドレスは含まれないことに注意してください。 エイリアスの詳細については、 sendemail.aliasesfile を参照してください。