'\" t
.\"     Title: git-send-email
.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 2026-06-29
.\"    Manual: Git Manual
.\"    Source: Git 2.55.0
.\"  Language: English
.\"
.TH "GIT\-SEND\-EMAIL" "1" "2026\-06\-29" "Git 2\&.55\&.0" "Git Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
git-send-email \- ارسال مجموعه‌ای از وصله‌ها به صورت ایمیل
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fIgit send\-email\fR [<options>] (<file>|<directory>)\&...
\fIgit send\-email\fR [<options>] <format\-patch\-options>
\fIgit send\-email\fR \-\-\dump\-aliases
\fIgit send\-email\fR \-\-\translate\-aliases
.fi
.sp
.SH "توضیحات (DESCRIPTION)"
.sp
وصله‌های داده‌شده در خط فرمان را دریافت کرده و آن‌ها را از طریق ایمیل ارسال می‌کند\&. وصله‌ها را می‌توان به صورت فایل، دایرکتوری (که تمام فایل‌های موجود در دایرکتوری را ارسال می‌کند)، یا مستقیماً به صورت فهرستی از بازنگری‌ها مشخص کرد\&. در حالت آخر، هر قالبی که توسط \fBgit-format-patch\fR(1) پذیرفته می‌شود و همچنین گزینه‌های قابل فهم برای \fBgit-format-patch\fR(1) را می‌توان به \fBgit\fR \fBsend\-email\fR ارسال کرد\&.
.sp
هدر ایمیل از طریق گزینه‌های خط فرمان قابل پیکربندی است\&. اگر در خط فرمان مشخص نشود، از طریق یک رابط با قابلیت ReadLine اطلاعات لازم از کاربر پرسیده خواهد شد\&.
.sp
دو قالب برای فایل‌های وصله پذیرفته می‌شود:
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
فایل‌های قالب mbox
.sp
این همان چیزی است که
\fBgit-format-patch\fR(1)
تولید می‌کند\&. اکثر هدرها و قالب‌بندی‌های MIME نادیده گرفته می‌شوند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
قالب اصلی استفاده‌شده توسط اسکریپت
\fBsend_lots_of_email\&.pl\fR
گرگ کروآ-هارتمن
.sp
این قالب انتظار دارد سطر اول فایل حاوی مقدار
\fBCc:\fR
و سطر دوم حاوی
\fBSubject:\fR
پیام باشد\&.
.RE
.SH "گزینه‌ها (OPTIONS)"
.SS "نگارش و آماده‌سازی (Composing)"
.PP
\-\-\annotate
.RS 4
بررسی و ویرایش هر وصله‌ای که در شرف ارسال آن هستید\&. مقدار پیش‌فرض مقدار
\fBsendemail\&.annotate\fR
است\&. برای
\fBsendemail\&.multiEdit\fR
بخش پیکربندی را ببینید\&.
.RE
.PP
\-\-\bcc=<address>,\&...
.RS 4
تعیین یک مقدار
\fBBcc:\fR
برای هر ایمیل\&. مقدار پیش‌فرض مقدار
\fBsendemail\&.bcc\fR
است\&.
.sp
این گزینه می‌تواند چندین بار مشخص شود\&.
.RE
.PP
\-\-\cc=<address>,\&...
.RS 4
تعیین یک مقدار اولیه
\fBCc:\fR
برای هر ایمیل\&. مقدار پیش‌فرض مقدار
\fBsendemail\&.cc\fR
است\&.
.sp
این گزینه می‌تواند چندین بار مشخص شود\&.
.RE
.PP
\-\-\compose
.RS 4
فراخوانی یک ویرایشگر متن (GIT_EDITOR را در
\fBgit-var\fR(1)
ببینید) برای ویرایش یک پیام مقدماتی برای مجموعه وصله‌ها\&.
.sp
هنگامی که از
\fB\-\-\compose\fR
استفاده می‌شود،
\fBgit\fR
\fBsend\-email\fR
از هدرهای
\fBFrom\fR،
\fBTo\fR،
\fBCc\fR،
\fBBcc\fR،
\fBSubject\fR،
\fBReply\-To\fR
و
\fBIn\-Reply\-To\fR
مشخص‌شده در پیام استفاده خواهد کرد\&. اگر بدنه پیام (آنچه بعد از هدرها و یک خط خالی تایپ می‌کنید) تنها شامل خطوط خالی (یا خطوطی با پیشوند
\fBGit:\fR)
باشد، خلاصه ارسال نخواهد شد، اما هدرهای ذکرشده در بالا استفاده می‌شوند مگر اینکه حذف شوند\&.
.sp
هدرهای مفقود
\fBFrom\fR
یا
\fBIn\-Reply\-To\fR
از کاربر پرسیده خواهند شد\&.
.sp
برای
\fBsendemail\&.multiEdit\fR
بخش پیکربندی را ببینید\&.
.RE
.PP
\-\-\from=<address>
.RS 4
فرستنده ایمیل‌ها را مشخص می‌کند\&. اگر در خط فرمان مشخص نشود، از مقدار گزینه پیکربندی
\fBsendemail\&.from\fR
استفاده می‌شود\&. اگر نه گزینه خط فرمان و نه
\fBsendemail\&.from\fR
تنظیم نشده باشند، مقدار از کاربر پرسیده می‌شود\&. پیش‌فرض در اعلان ورودی، مقدار
\fBGIT_AUTHOR_IDENT\fR
خواهد بود، یا اگر آن هم تنظیم نشده باشد
\fBGIT_COMMITTER_IDENT\fR،
همان‌طور که توسط
\fBgit\fR
\fBvar\fR
\fB\-l\fR
بازگردانده می‌شود\&.
.RE
.PP
\-\-\reply\-to=<address>
.RS 4
نشانی‌ای را که پاسخ‌های دریافت‌کنندگان باید به آن ارسال شود مشخص می‌کند\&. اگر پاسخ پیام‌ها باید به آدرسی غیر از آدرس مشخص‌شده با پارامتر
\fB\-\-\from\fR
ارسال شود، از این گزینه استفاده کنید\&.
.RE
.PP
\-\-\in\-reply\-to=<identifier>
.RS 4
باعث می‌شود اولین ایمیل (یا تمام ایمیل‌ها در صورت استفاده از
\fB\-\-\no\-thread\fR)
به عنوان پاسخی به Message\-ID داده‌شده ظاهر شوند، که از شکستن رشته‌ها (threads) برای ارائه یک مجموعه وصله جدید جلوگیری می‌کند\&. دومین و ایمیل‌های بعدی طبق تنظیمات
\fB\-\-\R[\fBno\-\fR]\fBchain\-reply\-to\fR
به عنوان پاسخ ارسال خواهند شد\&.
.sp
بنابراین برای مثال هنگامی که
\fB\-\-\thread\fR
و
\fB\-\-\no\-chain\-reply\-to\fR
مشخص شده باشند، وصله‌های دوم و بعد از آن به عنوان پاسخ به اولین وصله ارسال می‌شوند، همان‌طور که در تصویر زیر نشان داده شده است که [\fBPATCH\fR
\fBv2\fR
\fB0/3\fR]
در پاسخ به [\fBPATCH\fR
\fB0/2\fR]
است:
.sp
.if n \{\
.RS 4
.\}
.nf
[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
.fi
.if n \{\
.RE
.\}
.sp
تنها زمانی لازم است که
\fB\-\-\compose\fR
نیز تنظیم شده باشد\&. اگر
\fB\-\-\compose\fR
تنظیم نشده باشد، این مقدار از کاربر پرسیده خواهد شد\&.
.RE
.PP
\-\-\outlook\-id\-fix, \-\-\no\-outlook\-id\-fix
.RS 4
سرورهای SMTP مایکروسافت اوت‌لوک Message\-ID ارسالی از طریق ایمیل را نادیده گرفته و یک Message\-ID تصادفی جدید اختصاص می‌دهند، و بدین ترتیب ساختار رشته‌ها را می‌شکنند\&.
.sp
با
\fB\-\-\outlook\-id\-fix\fR،
دستور
\fBgit\fR
\fBsend\-email\fR
از سازوکاری ویژه سرورهای Outlook استفاده می‌کند تا Message\-ID اختصاص‌داده‌شده توسط سرور را بیاموزد و ساختار زنجیره پیام‌ها را اصلاح کند\&. تنها زمانی از آن استفاده کنید که می‌دانید سرور بازنویسی Message\-ID را به همان روش سرورهای Outlook گزارش می‌دهد\&.
.sp
بدون تعیین این گزینه، این اصلاح به طور پیش‌فرض هنگام برقراری ارتباط با
\fIsmtp\&.office365\&.com\fR
یا
\fIsmtp\-mail\&.outlook\&.com\fR
انجام می‌شود\&. برای غیرفعال کردن آن حتی در هنگام ارتباط با این دو سرور، از
\fB\-\-\no\-outlook\-id\-fix\fR
استفاده کنید\&.
.RE
.PP
\-\-\subject=<string>
.RS 4
موضوع اولیه زنجیره ایمیل را مشخص می‌کند\&. تنها زمانی لازم است که
\fB\-\-\compose\fR
نیز تنظیم شده باشد\&. اگر
\fB\-\-\compose\fR
تنظیم نشده باشد، این مقدار از کاربر پرسیده خواهد شد\&.
.RE
.PP
\-\-\to=<address>,\&...
.RS 4
گیرنده اصلی ایمیل‌های تولیدشده را مشخص می‌کند\&. معمولاً این شخص نگه‌دارنده بالادستی پروژه مربوطه خواهد بود\&. مقدار پیش‌فرض مقدار پیکربندی
\fBsendemail\&.to\fR
است؛ اگر مشخص نشده باشد و
\fB\-\-\to\-cmd\fR
نیز داده نشده باشد، از کاربر پرسیده خواهد شد\&.
.sp
این گزینه می‌تواند چندین بار مشخص شود\&.
.RE
.PP
\-\-\8bit\-encoding=<encoding>
.RS 4
هنگام مواجهه با یک پیام یا موضوع غیر-ASCII که کدگذاری خود را اعلام نکرده است، هدرها/نقل‌قول‌هایی اضافه می‌کند تا نشان دهد در <encoding> کدگذاری شده است\&. مقدار پیش‌فرض مقدار
\fBsendemail\&.assume8bitEncoding\fR
است؛ اگر تعیین نشده باشد، در صورت مواجهه با هر فایل غیر-ASCII از کاربر پرسیده خواهد شد\&.
.sp
توجه داشته باشید که هیچ تلاشی برای اعتبارسنجی کدگذاری انجام نمی‌شود\&.
.RE
.PP
\-\-\compose\-encoding=<encoding>
.RS 4
کدگذاری پیام compose را مشخص می‌کند\&. مقدار پیش‌فرض مقدار
\fBsendemail\&.composeEncoding\fR
است؛ اگر تعیین نشده باشد، UTF\-8 فرض می‌شود\&.
.RE
.PP
\-\-\transfer\-encoding=(7bit|8bit|quoted\-printable|base64|auto)
.RS 4
کدگذاری انتقال مورد استفاده برای ارسال پیام از طریق SMTP را مشخص می‌کند\&.
\fB7bit\fR
در صورت مواجهه با یک پیام غیر-ASCII با خطا متوقف می‌شود\&.
\fBquoted\-printable\fR
می‌تواند زمانی مفید باشد که مخزن شامل فایل‌هایی با کاراکترهای carriage return باشد، اما بررسی دستی فایل خام ایمیل وصله (همان‌طور که از یک MUA ذخیره شده) را بسیار دشوارتر می‌کند\&.
\fBbase64\fR
حتی خطاناپذیرتر است، اما بسیار ناخواناتر و غیرشفاف‌تر نیز هست\&.
\fBauto\fR
در صورت امکان از
\fB8bit\fR
و در غیر این صورت از
\fBquoted\-printable\fR
استفاده خواهد کرد\&.
.sp
پیش‌فرض مقدار پیکربندی
\fBsendemail\&.transferEncoding\fR
است؛ در صورت عدم تعیین، پیش‌فرض
\fBauto\fR
خواهد بود\&.
.RE
.PP
\-\-\xmailer, \-\-\no\-xmailer
.RS 4
افزودن (یا جلوگیری از افزودن) هدر
\fBX\-Mailer:\fR\&.
به‌طور پیش‌فرض، این هدر اضافه می‌شود، اما می‌توان با تنظیم متغیر پیکربندی
\fBsendemail\&.xmailer\fR
روی
\fBfalse\fR
آن را خاموش کرد\&.
.RE
.SS "ارسال (Sending)"
.PP
\-\-\envelope\-sender=<address>
.RS 4
فرستنده پاکت (envelope sender) مورد استفاده برای ارسال ایمیل‌ها را مشخص می‌کند\&. این زمانی مفید است که آدرس پیش‌فرض شما همان آدرسی نباشد که در یک لیست پستی عضو است\&. برای استفاده از آدرس
\fBFrom\fR،
مقدار را روی
\fBauto\fR
قرار دهید\&. اگر از باینری
\fBsendmail\fR
استفاده می‌کنید، باید امتیازات مناسبی برای پارامتر
\fB\-f\fR
داشته باشید\&. پیش‌فرض مقدار متغیر پیکربندی
\fBsendemail\&.envelopeSender\fR
است؛ اگر تعیین نشده باشد، انتخاب فرستنده پاکت به MTA شما واگذار می‌شود\&.
.RE
.PP
\-\-\sendmail\-cmd=<command>
.RS 4
دستوری را برای اجرا جهت ارسال ایمیل مشخص می‌کند\&. دستور باید شبیه به sendmail باشد؛ به‌ویژه باید از گزینه
\fB\-i\fR
پشتیبانی کند\&. دستور در صورت لزوم در شل اجرا خواهد شد\&. پیش‌فرض مقدار
\fBsendemail\&.sendmailCmd\fR
است\&. در صورت عدم تعیین، و اگر
\fB\-\-\smtp\-server\fR
نیز تعیین نشده باشد،
\fBgit\fR
\fBsend\-email\fR
به دنبال
\fBsendmail\fR
در مسیرهای
\fB/usr/sbin\fR،
\fB/usr/lib\fR
و
\fB$PATH\fR
می‌گردد\&.
.RE
.PP
\-\-\smtp\-encryption=<encryption>
.RS 4
مشخص می‌کند که رمزنگاری برای اتصال SMTP چگونه آغاز شود\&. مقادیر معتبر
\fBssl\fR
و
\fBtls\fR
هستند\&. هر مقدار دیگری به SMTP ساده (رمزنگاری‌نشده) برمی‌گردد که به پورت پیش‌فرض ۲۵ متصل می‌شود\&. علی‌رغم نام‌ها، هر دو مقدار از همان نسخه جدیدتر TLS استفاده می‌کنند، اما به دلایل تاریخی این نام‌ها را دارند\&.
\fBssl\fR
به رمزنگاری «ضمنی» (گاهی SMTPS نامیده می‌شود) اشاره دارد که به‌طور پیش‌فرض از پورت ۴۶۵ استفاده می‌کند\&.
\fBtls\fR
به رمزنگاری «صریح» (اغلب به عنوان STARTTLS شناخته می‌شود) اشاره دارد که به‌طور پیش‌فرض از پورت ۲۵ استفاده می‌کند\&. پورت‌های دیگری نیز ممکن است توسط سرور SMTP استفاده شوند که پیش‌فرض نیستند\&. پورت جایگزین رایج برای
\fBtls\fR
و رمزنگاری‌نشده ۵۸۷ است\&. برای اطمینان از وضعیت سیستم خود باید مستندات ارائه‌دهنده یا پیکربندی سرور خود را بررسی کنید\&. پیش‌فرض مقدار
\fBsendemail\&.smtpEncryption\fR
است\&.
.RE
.PP
\-\-\smtp\-domain=<FQDN>
.RS 4
نام دامنه کاملاً واجد شرایط (FQDN) مورد استفاده در دستور HELO/EHLO به سرور SMTP را مشخص می‌کند\&. برخی سرورها الزام دارند که FQDN با آدرس IP شما مطابقت داشته باشد\&. اگر تنظیم نشود،
\fBgit\fR
\fBsend\-email\fR
تلاش می‌کند FQDN شما را به صورت خودکار تشخیص دهد\&. پیش‌فرض مقدار
\fBsendemail\&.smtpDomain\fR
است\&.
.RE
.PP
\-\-\smtp\-auth=<mechanisms>
.RS 4
فهرستی از سازوکارهای مجاز SMTP\-AUTH که با فاصله جدا شده‌اند\&. این تنظیم استفاده از تنها سازوکارهای فهرست‌شده را تحمیل می‌کند\&. مثال:
.sp
.if n \{\
.RS 4
.\}
.nf
$ git send\-email \-\-\smtp\-auth="PLAIN LOGIN GSSAPI" \&.\&.\&.
.fi
.if n \{\
.RE
.\}
.sp
اگر حداقل یکی از سازوکارهای مشخص‌شده با موارد تبلیغ‌شده توسط سرور SMTP مطابقت داشته باشد و توسط کتابخانه SASL مورد استفاده پشتیبانی شود، آن سازوکار برای احراز هویت استفاده می‌شود\&. اگر نه
\fBsendemail\&.smtpAuth\fR
و نه
\fB\-\-\smtp\-auth\fR
مشخص نشده باشد، تمام سازوکارهای پشتیبانی‌شده توسط کتابخانه SASL قابل استفاده خواهند بود\&. مقدار ویژه
\fBnone\fR
می‌تواند برای غیرفعال کردن کامل احراز هویت به صورت مستقل از
\fB\-\-\smtp\-user\fR
مشخص شود\&.
.RE
.PP
\-\-\smtp\-pass[=<password>]
.RS 4
گذرواژه برای SMTP\-AUTH\&. آرگومان اختیاری است: اگر آرگومانی مشخص نشود، از رشته خالی به عنوان گذرواژه استفاده می‌شود\&. پیش‌فرض مقدار
\fBsendemail\&.smtpPass\fR
است، با این حال
\fB\-\-\smtp\-pass\fR
همیشه بر این مقدار اولویت دارد\&.
.sp
علاوه بر این، نیازی نیست گذرواژه‌ها در فایل‌های پیکربندی یا در خط فرمان مشخص شوند\&. اگر نام کاربری مشخص شده باشد (با
\fB\-\-\smtp\-user\fR
یا
\fBsendemail\&.smtpUser\fR)،
اما هیچ گذرواژه‌ای تعیین نشده باشد (با
\fB\-\-\smtp\-pass\fR
یا
\fBsendemail\&.smtpPass\fR)،
آنگاه گذرواژه با استفاده از
\fBgit-credential\fR(1)
به دست می‌آید\&.
.RE
.PP
\-\-\no\-smtp\-auth
.RS 4
غیرفعال کردن احراز هویت SMTP\&. فرم کوتاه برای
\fB\-\-\smtp\-auth=none\fR\&.
.RE
.PP
\-\-\smtp\-server=<host>
.RS 4
سرور خروجی SMTP را مشخص می‌کند (مانند
\fBsmtp\&.example\&.com\fR
یا یک آدرس IP خام)\&. در صورت عدم تعیین، و اگر
\fB\-\-\sendmail\-cmd\fR
نیز تعیین نشده باشد، پیش‌فرض جستجو برای
\fBsendmail\fR
در
\fB/usr/sbin\fR،
\fB/usr/lib\fR
و
\fB$PATH\fR
در صورت موجود بودن چنین برنامه‌ای است، و در غیر این صورت به
\fBlocalhost\fR
بازمی‌گردد\&.
.sp
برای سازگاری با گذشته، این گزینه می‌تواند مسیر کامل یک برنامه شبیه به sendmail را نیز مشخص کند؛ برنامه باید از گزینه
\fB\-i\fR
پشتیبانی کند\&. این روش از ارسال آرگومان یا استفاده از نام‌های دستور ساده پشتیبانی نمی‌کند\&. برای این موارد کاربرد، استفاده از
\fB\-\-\sendmail\-cmd\fR
را مد نظر قرار دهید\&.
.RE
.PP
\-\-\smtp\-server\-port=<port>
.RS 4
پورتی متفاوت از پورت پیش‌فرض را مشخص می‌کند (سرورهای SMTP معمولاً به پورت ۲۵ گوش می‌دهند، اما ممکن است به پورت ارسال ۵۸۷ یا پورت متداول SSL SMTP یعنی ۴۶۵ نیز گوش دهند)؛ نام‌های نمادین پورت (مانند
\fBsubmission\fR
به‌جای ۵۸۷) نیز پذیرفته می‌شوند\&. پورت را می‌توان با متغیر پیکربندی
\fBsendemail\&.smtpServerPort\fR
نیز تنظیم کرد\&.
.RE
.PP
\-\-\smtp\-server\-option=<option>
.RS 4
گزینه سرور SMTP خروجی را مشخص می‌کند\&. مقدار پیش‌فرض را می‌توان با گزینه پیکربندی
\fBsendemail\&.smtpServerOption\fR
مشخص کرد\&.
.sp
گزینه
\fB\-\-\smtp\-server\-option\fR
باید برای هر گزینه‌ای که می‌خواهید به سرور ارسال کنید تکرار شود\&. به همین ترتیب، خطوط متفاوتی در فایل‌های پیکربندی باید برای هر گزینه استفاده شوند\&.
.RE
.PP
\-\-\smtp\-ssl
.RS 4
نام مستعار قدیمی برای
\fB\-\-\smtp\-encryption\fR
\fBssl\fR\&.
.RE
.PP
\-\-\smtp\-ssl\-cert\-path <path>
.RS 4
مسیر ذخیره گواهی‌های CA معتمد برای اعتبارسنجی گواهی SSL/TLS در SMTP (یا دایرکتوری‌ای که توسط
\fBc_rehash\fR
پردازش شده است، یا یک فایل واحد حاوی یک یا چند گواهی فرمت PEM متصل به یکدیگر: برای اطلاعات بیشتر شرح گزینه‌های
\fB\-CAfile\fR
\fI<file>\fR
و
\fB\-CApath\fR
\fI<dir>\fR
را در راهنمای OpenSSL در
\m[blue]\fBhttps://docs\&.openssl\&.org/master/man1/openssl\-verify\fR\m[]
ببینید)\&. برای غیرفعال کردن اعتبارسنجی گواهی، آن را روی رشته خالی قرار دهید\&. مقدار پیش‌فرض مقدار متغیر پیکربندی
\fBsendemail\&.smtpSSLCertPath\fR
در صورت تنظیم، یا پیش‌فرض کامپایل‌شده کتابخانه SSL زیربنایی در غیر این صورت است (که باید بهترین انتخاب در اکثر پلتفرم‌ها باشد)\&.
.RE
.PP
\-\-\smtp\-ssl\-client\-cert <path>
.RS 4
مسیر فایل گواهی کلاینت که در صورت درخواست سرور ارائه می‌شود\&. این گزینه زمانی لازم است که سرور برای بررسی گواهی‌های کلاینت تنظیم شده باشد\&. اگر کلید خصوصی مربوطه در فایل گنجانده نشده باشد، باید با استفاده از متغیر پیکربندی
\fBsendemail\&.smtpSSLClientKey\fR
یا گزینه
\fB\-\-\smtp\-ssl\-client\-key\fR
ارائه شود\&. مقدار پیش‌فرض مقدار متغیر پیکربندی
\fBsendemail\&.smtpSSLClientCert\fR
در صورت تنظیم است\&.
.RE
.PP
\-\-\smtp\-ssl\-client\-key <path>
.RS 4
مسیر فایل کلید خصوصی کلاینت که با گواهی کلاینت مطابقت دارد\&. برای جلوگیری از پیکربندی نادرست، این گزینه باید همراه با متغیر پیکربندی
\fBsendemail\&.smtpSSLClientKey\fR
یا گزینه
\fB\-\-\smtp\-ssl\-client\-cert\fR
استفاده شود\&. اگر کلید کلاینت در گواهی کلاینت گنجانده شده باشد، انتخاب کلید خصوصی به فرمت گواهی بستگی دارد\&. برای جزئیات بیشتر به
\m[blue]\fBhttps://metacpan\&.org/pod/IO::Socket::SSL\fR\m[]
مراجعه کنید\&. مقدار پیش‌فرض مقدار متغیر پیکربندی
\fBsendemail\&.smtpSSLClientKey\fR
در صورت تنظیم است\&.
.RE
.PP
\-\-\smtp\-user=<user>
.RS 4
نام کاربری برای SMTP\-AUTH\&. مقدار پیش‌فرض مقدار
\fBsendemail\&.smtpUser\fR
است؛ اگر نام کاربری مشخص نشود (با
\fB\-\-\smtp\-user\fR
یا
\fBsendemail\&.smtpUser\fR)،
احراز هویت تلاش نخواهد شد\&.
.RE
.PP
\-\-\smtp\-debug=(0|1)
.RS 4
فعال‌سازی (1) یا غیرفعال‌سازی (0) خروجی اشکال‌زدایی\&. در صورت فعال بودن، دستورات و پاسخ‌های SMTP چاپ می‌شوند\&. برای رفع اشکال اتصال TLS و مشکلات احراز هویت مفید است\&.
.RE
.PP
\-\-\imap\-sent\-folder=<folder>
.RS 4
برخی ارائه‌دهندگان ایمیل (مانند iCloud) رونوشتی از ایمیل‌های ارسالی با استفاده از SMTP را به پوشه
\fBSent\fR
یا مشابه آن در صندوق پستی شما ارسال نمی‌کنند\&. از این گزینه استفاده کنید تا با استفاده از
\fBgit\fR
\fBimap\-send\fR
رونوشتی از ایمیل‌ها به پوشه مشخص‌شده ارسال شود\&. می‌توانید
\fBgit\fR
\fBimap\-send\fR
\fB\-\-\list\fR
را اجرا کنید تا فهرستی از نام‌های معتبر پوشه‌ها، از جمله نام صحیح پوشه
\fBSent\fR
در صندوق پستی خود را دریافت کنید\&. همچنین می‌توانید از این گزینه برای ارسال ایمیل‌ها به یک پوشه IMAP اختصاصی به انتخاب خود استفاده کنید\&.
.sp
این قابلیت نیازمند راه‌اندازی
\fBgit\fR
\fBimap\-send\fR
است\&. برای دستورالعمل‌ها به
\fBgit-imap-send\fR(1)
مراجعه کنید\&.
.RE
.PP
\-\-\use\-imap\-only, \-\-\no\-use\-imap\-only
.RS 4
اگر تنظیم شود، تمام ایمیل‌ها فقط در پوشه IMAP مشخص‌شده با
\fB\-\-\imap\-sent\-folder\fR
یا
\fBsendemail\&.imapSentFolder\fR
کپی می‌شوند و برای گیرندگان ارسال نخواهند شد\&. اگر فقط می‌خواهید پیش‌نویسی از ایمیل‌ها بسازید و از یک کلاینت ایمیل دیگر برای ارسال آن‌ها استفاده کنید مفید است\&. اگر با
\fB\-\-\no\-use\-imap\-only\fR
غیرفعال شود، ایمیل‌ها طبق معمول ارسال می‌شوند\&. به‌طور پیش‌فرض غیرفعال است، اما از متغیر پیکربندی
\fBsendemail\&.useImapOnly\fR
می‌توان برای فعال‌سازی آن استفاده کرد\&.
.sp
این قابلیت نیازمند راه‌اندازی
\fBgit\fR
\fBimap\-send\fR
است\&. برای دستورالعمل‌ها به
\fBgit-imap-send\fR(1)
مراجعه کنید\&.
.RE
.PP
\-\-\batch\-size=<num>
.RS 4
برخی سرورهای ایمیل (مانند
\fIsmtp\&.163\&.com\fR)
تعداد ایمیل‌های قابل ارسال در هر نشست (اتصال) را محدود می‌کنند و این امر هنگام ارسال پیام‌های متعدد منجر به خطا می‌شود\&. با این گزینه، send\-email پس از ارسال
\fI<num>\fR
پیام اتصال را قطع کرده و چند ثانیه منتظر می‌ماند (به
\fB\-\-\relogin\-delay\fR
مراجعه کنید) و مجدداً متصل می‌شود تا این محدودیت را دور بزند\&. ممکن است بخواهید از نوعی برنامه کمکی اطلاعات کاربری (credential helper) استفاده کنید تا مجبور نباشید هر بار که این اتفاق می‌افتد گذرواژه خود را دوباره وارد کنید\&. پیش‌فرض متغیر پیکربندی
\fBsendemail\&.smtpBatchSize\fR
است\&.
.RE
.PP
\-\-\relogin\-delay=<int>
.RS 4
صبر کردن به مدت
\fI<int>\fR
ثانیه پیش از اتصال مجدد به سرور SMTP\&. همراه با گزینه
\fB\-\-\batch\-size\fR
استفاده می‌شود\&. پیش‌فرض متغیر پیکربندی
\fBsendemail\&.smtpReloginDelay\fR
است\&.
.RE
.SS "خودکارسازی (Automating)"
.PP
\-\-\no\-to, \-\-\no\-cc, \-\-\no\-bcc
.RS 4
پاک کردن هر فهرستی از آدرس‌های
\fBTo:\fR،
\fBCc:\fR،
\fBBcc:\fR
که پیش‌تر از طریق تنظیمات پیکربندی تنظیم شده‌اند\&.
.RE
.PP
\-\-\no\-identity
.RS 4
پاک کردن مقدار از پیش خوانده‌شده
\fBsendemail\&.identity\fR
تنظیم‌شده از طریق پیکربندی، در صورت وجود\&.
.RE
.PP
\-\-\to\-cmd=<command>
.RS 4
دستوری را برای اجرا برای هر فایل وصله مشخص می‌کند که باید ورودی‌های اختصاصی
\fBTo:\fR
را برای فایل وصله تولید کند\&. خروجی این دستور باید یک نشانی ایمیل در هر خط باشد\&. پیش‌فرض مقدار پیکربندی
\fBsendemail\&.toCmd\fR
است\&.
.RE
.PP
\-\-\cc\-cmd=<command>
.RS 4
دستوری را برای اجرا برای هر فایل وصله مشخص می‌کند که باید ورودی‌های اختصاصی
\fBCc:\fR
را برای فایل وصله تولید کند\&. خروجی این دستور باید یک نشانی ایمیل در هر خط باشد\&. پیش‌فرض مقدار پیکربندی
\fBsendemail\&.ccCmd\fR
است\&.
.RE
.PP
\-\-\header\-cmd=<command>
.RS 4
دستوری را مشخص می‌کند که برای هر پیام خروجی اجرا می‌شود و خطوط هدر به سبک RFC 2822 را برای درج در آن‌ها تولید می‌کند\&. هنگامی که متغیر پیکربندی
\fBsendemail\&.headerCmd\fR
تنظیم شده باشد، مقدار آن همیشه استفاده می‌شود\&. هنگامی که
\fB\-\-\header\-cmd\fR
در خط فرمان ارائه شود، مقدار آن بر متغیر پیکربندی
\fBsendemail\&.headerCmd\fR
اولویت دارد\&.
.RE
.PP
\-\-\no\-header\-cmd
.RS 4
غیرفعال کردن هرگونه دستور هدر مورد استفاده\&.
.RE
.PP
\-\-\chain\-reply\-to, \-\-\no\-chain\-reply\-to
.RS 4
اگر این گزینه تنظیم شود، هر ایمیل به عنوان پاسخی به ایمیل قبلی ارسال خواهد شد\&. در صورت غیرفعال شدن با
\fB\-\-\no\-chain\-reply\-to\fR،
تمام ایمیل‌ها بعد از اولین ایمیل به عنوان پاسخ به اولین ایمیل ارسال می‌شوند\&. هنگام استفاده از این گزینه، توصیه می‌شود اولین فایل ارائه‌شده مروری کلی بر کل مجموعه وصله باشد\&. به‌طور پیش‌فرض غیرفعال است، اما می‌توان از متغیر پیکربندی
\fBsendemail\&.chainReplyTo\fR
برای فعال‌سازی آن استفاده کرد\&.
.RE
.PP
\-\-\identity=<identity>
.RS 4
یک هویت پیکربندی\&. در صورت تعیین، باعث می‌شود مقادیر در زیربخش
\fBsendemail\&.\fR\fI<identity>\fR
بر مقادیر در بخش
\fBsendemail\fR
اولویت پیدا کنند\&. هویت پیش‌فرض مقدار
\fBsendemail\&.identity\fR
است\&.
.RE
.PP
\-\-\signed\-off\-by\-cc, \-\-\no\-signed\-off\-by\-cc
.RS 4
اگر تنظیم شود، نشانی‌های ایمیل یافت‌شده در بخش پایانی
\fBSigned\-off\-by\fR
یا خطوط
\fBCc:\fR
را به فهرست رونوشت (cc) اضافه می‌کند\&. پیش‌فرض مقدار پیکربندی
\fBsendemail\&.signedOffByCc\fR
است؛ اگر تعیین نشده باشد، پیش‌فرض
\fB\-\-\signed\-off\-by\-cc\fR
خواهد بود\&.
.RE
.PP
\-\-\cc\-cover, \-\-\no\-cc\-cover
.RS 4
اگر تنظیم شود، نشانی‌های ایمیل یافت‌شده در هدرهای
\fBCc:\fR
در اولین وصله از مجموعه (معمولاً نامه پوششی یا cover letter) به فهرست رونوشت برای هر مجموعه ایمیل اضافه می‌شوند\&. پیش‌فرض مقدار پیکربندی
\fBsendemail\&.ccCover\fR
است؛ اگر تعیین نشده باشد، پیش‌فرض
\fB\-\-\no\-cc\-cover\fR
است\&.
.RE
.PP
\-\-\to\-cover, \-\-\no\-to\-cover
.RS 4
اگر تنظیم شود، نشانی‌های ایمیل یافت‌شده در هدرهای
\fBTo:\fR
در اولین وصله از مجموعه (معمولاً نامه پوششی) به فهرست گیرندگان برای هر مجموعه ایمیل اضافه می‌شوند\&. پیش‌فرض مقدار پیکربندی
\fBsendemail\&.toCover\fR
است؛ اگر تعیین نشده باشد، پیش‌فرض
\fB\-\-\no\-to\-cover\fR
است\&.
.RE
.PP
\-\-\suppress\-cc=<category>
.RS 4
یک دسته اضافی از دریافت‌کنندگان را برای جلوگیری از رونوشت خودکار (auto\-cc) مشخص می‌کند:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBauthor\fR
از گنجاندن نویسنده وصله خودداری می‌کند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBself\fR
از گنجاندن خود فرستنده خودداری می‌کند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBcc\fR
از گنجاندن هر کسی که در خطوط Cc در هدر وصله ذکر شده است خودداری می‌کند به‌جز خود فرستنده (برای آن از
\fBself\fR
استفاده کنید)\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBbodycc\fR
از گنجاندن هر کسی که در خطوط Cc در بدنه وصله (پیام کامیت) ذکر شده است خودداری می‌کند به‌جز خود فرستنده (برای آن از
\fBself\fR
استفاده کنید)\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBsob\fR
از گنجاندن هر کسی که در سطرهای Signed\-off\-by ذکر شده است خودداری می‌کند به‌جز خود فرستنده (برای آن از
\fBself\fR
استفاده کنید)\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBmisc\-by\fR
از گنجاندن هر کسی که در سطرهای Acked\-by، Reviewed\-by، Tested\-by و سایر خطوط "\-by" در بدنه وصله ذکر شده است خودداری می‌کند، به‌جز Signed\-off\-by (برای آن از
\fBsob\fR
استفاده کنید)\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBcccmd\fR
از اجرای \-\-\cc\-cmd خودداری می‌کند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBbody\fR
معادل است با
\fBsob\fR
+
\fBbodycc\fR
+
\fBmisc\-by\fR\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBall\fR
تمام مقادیر cc خودکار را سرکوب و متوقف می‌کند\&.
.RE
.sp
پیش‌فرض مقدار پیکربندی
\fBsendemail\&.suppressCc\fR
است؛ اگر تعیین نشده باشد، در صورت تعیین
\fB\-\-\suppress\-from\fR
پیش‌فرض
\fBself\fR
خواهد بود، و در صورت تعیین
\fB\-\-\no\-signed\-off\-by\-cc\fR
پیش‌فرض
\fBbody\fR
خواهد بود\&.
.RE
.PP
\-\-\suppress\-from, \-\-\no\-suppress\-from
.RS 4
اگر این گزینه تنظیم شود، آدرس
\fBFrom:\fR
را به فهرست
\fBCc:\fR
اضافه نمی‌کند\&. پیش‌فرض مقدار پیکربندی
\fBsendemail\&.suppressFrom\fR
است؛ اگر تعیین نشده باشد، پیش‌فرض
\fB\-\-\no\-suppress\-from\fR
است\&.
.RE
.PP
\-\-\thread, \-\-\no\-thread
.RS 4
اگر تنظیم شود، هدرهای
\fBIn\-Reply\-To\fR
و
\fBReferences\fR
به هر ایمیل ارسالی اضافه خواهند شد\&. اینکه هر ایمیل به ایمیل قبلی ارجاع می‌دهد (رشته‌بندی عمیق یا
\fBdeep\fR
بر اساس اصطلاحات
\fBgit\fR
\fBformat\-patch\fR)
یا به اولین ایمیل (رشته‌بندی کم‌عمق یا
\fBshallow\fR)
توسط
\fB\-\-\R[\fBno\-\fR]\fBchain\-reply\-to\fR
مدیریت می‌شود\&.
.sp
اگر با
\fB\-\-\no\-thread\fR
غیرفعال شود، این هدرها اضافه نخواهند شد (مگر اینکه با
\fB\-\-\in\-reply\-to\fR
مشخص شده باشند)\&. مقدار پیش‌فرض مقدار پیکربندی
\fBsendemail\&.thread\fR
است؛ اگر تعیین نشده باشد، پیش‌فرض
\fB\-\-\thread\fR
است\&.
.sp
بر عهده کاربر است که اطمینان حاصل کند هنگام درخواست از
\fBgit\fR
\fBsend\-email\fR
برای افزودن هدر In\-Reply\-To، چنین هدری از قبل وجود نداشته باشد (به‌ویژه توجه داشته باشید که
\fBgit\fR
\fBformat\-patch\fR
می‌تواند طوری پیکربندی شود که خودش رشته‌بندی را انجام دهد)\&. عدم رعایت این مورد ممکن است نتیجه مورد انتظار را در برنامه ایمیل (MUA) دریافت‌کننده ایجاد نکند\&.
.RE
.PP
\-\-\mailmap, \-\-\no\-mailmap
.RS 4
استفاده از فایل نگاشت ایمیل (mailmap) (به
\fBgitmailmap\fR(5)
مراجعه کنید) برای نگاشت تمام آدرس‌ها به نام واقعی و آدرس ایمیل استاندارد آن‌ها\&. داده‌های اضافی mailmap ویژه
\fBgit\fR
\fBsend\-email\fR
را می‌توان با استفاده از مقادیر پیکربندی
\fBsendemail\&.mailmap\&.file\fR
یا
\fBsendemail\&.mailmap\&.blob\fR
ارائه داد\&. پیش‌فرض
\fBsendemail\&.mailmap\fR
است\&.
.RE