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

Microsoft Outlook の SMTP サーバーは、電子メールで送信された Message-ID を破棄して新しいランダムな Message-ID を割り当てるため、スレッドが壊れます。

メールスレッドの最初の件名を指定します。 --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 は、可能な場合は 8bit を使用し、それ以外の場合は 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 をリッスンしますが、submission ポート 587 や、一般的な SSL smtp ポート 465 をリッスンする場合もあります)。シンボリックなポート名(例: 587 の代わりに submission)も受け付けます。ポートは sendemail.smtpServerPort 設定変数でも設定できます。

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

--smtp-encryption ssl のレガシーなエイリアスです。

SMTP SSL/TLS 証明書検証のための、信頼された CA 証明書ストアへのパスです( c_rehash によって処理されたディレクトリ、または 1 つ以上の PEM 形式証明書を連結した単一ファイル。これらについての詳細は https://docs.openssl.org/master/man1/openssl-verify/ [OpenSSL の verify(1) マニュアルページ] の -CAfile <file> および -CApath <dir> オプションの説明を参照してください)。証明書検証を無効にするには空文字列を設定します。デフォルトは、設定されていれば sendemail.smtpSSLCertPath 設定変数の値、そうでなければ基盤となる SSL ライブラリにコンパイル時に組み込まれたデフォルト値です(ほとんどのプラットフォームで最良の選択になるはずです)。

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

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

一部のメールプロバイダー(例: iCloud)では、SMTP を使って送信したメールのコピーが、メールボックス内の Sent フォルダーなどに保存されません。このオプションを使うと、git imap-send を使って、指定したフォルダーへメールのコピーを送信します。git imap-send --list を実行すると、メールボックス内の Sent フォルダーの正しい名前を含む、有効なフォルダー名の一覧を取得できます。また、このオプションを使って、任意の専用 IMAP フォルダーへメールを送ることもできます。

これを設定すると、すべてのメールは --imap-sent-folder または sendemail.imapSentFolder で指定した IMAP フォルダーにのみコピーされ、受信者には送信されません。メールの下書きだけを作成し、別のメールクライアントを使って送信したい場合に便利です。--no-use-imap-only で無効にすると、メールは通常どおり送信されます。デフォルトでは無効ですが、sendemail.useImapOnly 設定変数を使って有効にできます。

一部のメールサーバー(例: smtp.163.com)は、セッション(接続)あたりに送信できるメール数を制限しており、多数のメッセージを送ると失敗することがあります。このオプションを使うと、send-email は <num> 通送信した後に切断し、数秒待って( --relogin-delay を参照)再接続することで、この制限を回避します。これが起きるたびにパスワードを再入力しなくて済むよう、何らかのクレデンシャルヘルパーを使うとよいでしょう。デフォルトは sendemail.smtpBatchSize 設定変数です。

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

設定で以前に指定した 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 設定値です。これが未指定の場合、デフォルトは --signed-off-by-cc になります。

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

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

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

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

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

mailmap ファイル(gitmailmap(5) 参照)を使用して、すべてのアドレスを正規の実名とメールアドレスにマッピングします。git send-email 固有の追加の mailmap データは sendemail.mailmap.file または sendemail.mailmap.blob 設定値を使って提供できます。デフォルトは sendemail.mailmap です。

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

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

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

git send-email の出力を少なくします。出力されるのはメール 1 通につき 1 行だけになるはずです。

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

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

通常の動作の代わりに、設定されたエイリアスファイルから短縮エイリアス名をダンプし、アルファベット順に 1 行に 1 つずつ出力します。これにはエイリアス名のみが含まれ、展開後のメールアドレスは含まれないことに注意してください。エイリアスの詳細は sendemail.aliasesFile を参照してください。

通常の動作の代わりに標準入力から読み込み、各行をメールエイリアスとして解釈します。設定されたエイリアスファイルに従って変換します。変換後の名前とメールアドレスを標準出力に 1 行ずつ出力します。エイリアスの詳細は sendemail.aliasFile を参照してください。