.\"	$OpenBSD: smtp.1,v 1.14 2021/05/23 16:12:56 eric Exp $
.\"
.\" Copyright (c) 2018, Eric Faurot <eric@openbsd.org>
.\"
.\" Permission to use, copy, modify, and distribute this software for any
.\" purpose with or without fee is hereby granted, provided that the above
.\" copyright notice and this permission notice appear in all copies.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.Dd $Mdocdate: May 23 2021 $
.Dt SMTP 1
.Os
.Sh "نام (NAME)"
.Nm smtp
.Nd کارخواه Simple Mail Transfer Protocol
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm
.Op Fl Chnv
.Op Fl a Ar authfile
.Op Fl F Ar from
.Op Fl H Ar helo
.Op Fl s Ar server
.Op Fl T Ar params
.Op Ar recipient ...
.Sh "توضیحات (DESCRIPTION)"
ابزار
.Nm
یک کارخواه Simple Mail Transfer Protocol
.Pq SMTP
است که می‌تواند برای اجرای یک تراکنش SMTP در ارتباط با یک سرور SMTP استفاده شود.
.Pp
به‌طور پیش‌فرض،
.Nm
محتوای نامه را از ورودی استاندارد می‌خواند، یک نشست SMTP برقرار می‌کند، و یک تراکنش SMTP را برای تمام گیرندگان مشخص‌شده اجرا می‌کند.
محتوا بدون تغییر به‌عنوان داده‌های نامه ارسال می‌شود.
.Pp
گزینه‌ها به شرح زیر هستند:
.Bl -tag -width Ds
.It Fl a Ar authfile
پیش از ارسال پیام، احراز هویت را انجام می‌دهد.
نام کاربری و گذرواژه از
.Ar authfile
خوانده می‌شوند و به ترتیب باید در خط اول و دوم باشند.
این گزینه به یک
.Ar server
با پشتیبانی از TLS یا STARTTLS نیاز دارد.
.It Fl C
معتبر بودن گواهی سرور الزامی نیست.
این پرچم منسوخ شده است.
به جای آن از
.Dq Fl T Cm noverify
استفاده کنید.
.It Fl F Ar from
تنظیم مسیر بازگشت (MAIL FROM) برای تراکنش SMTP.
پیش‌فرض، نام کاربری فعلی است.
.It Fl H Ar helo
تعیین نام میزبان (hostname) برای معرفی (HELO) در هنگام برقراری نشست SMTP.
.It Fl h
نمایش نحوهٔ استفاده.
.It Fl n
تراکنشی را در عمل اجرا نمی‌کند،
صرفاً برای برقراری یک نشست SMTP تلاش کرده و خارج می‌شود.
هنگامی که این گزینه داده شود، هیچ پیامی از ورودی استاندارد خوانده نمی‌شود.
.It Fl s Ar server
سرور مورد نظر برای اتصال و پارامترهای اتصال را مشخص می‌کند.
قالب آن بدین صورت است:
.Sm off
.Op Ar proto No :// Op Ar user : pass No @
.Ar host Op : Ar port .
.Sm on
پروتکل‌های زیر در دسترس هستند:
.Pp
.Bl -tag -width "smtp+notls" -compact
.It smtp
نشست عادی SMTP با STARTTLS فرصت‌طلبانه (opportunistic).
.It smtp+tls
نشست عادی SMTP با STARTTLS اجباری.
.It smtp+notls
نشست متنی ساده (plain text) SMTP بدون TLS.
.It lmtp
نشست LMTP با STARTTLS فرصت‌طلبانه (opportunistic).
.It lmtp+tls
نشست LMTP با STARTTLS اجباری.
.It lmtp+notls
نشست متنی ساده (plain text) LMTP بدون TLS.
.It smtps
نشست SMTP با TLS اجباری در هنگام اتصال.
.El
.Pp
پیش‌فرض
.Dq smtp://localhost:25
است.
.It Fl T Ar params
تنظیم پارامترهای خاص برای نشست‌های TLS.
رشتهٔ
.Ar params
فهرستی از گزینه‌ها است که با کاما یا فاصله از هم جدا شده‌اند.
گزینه‌های موجود عبارتند از:
.Bl -tag -width Ds
.It Cm cafile Ns = Ns Ar filename
استفاده از
.Ar filename
به‌عنوان فایل گواهی‌های ریشه به جای پیش‌فرض سیستم.
.It Cm ciphers Ns = Ns Ar value
رمزهای مجاز (ciphers) را مشخص می‌کند.
برای
.Ar value
به
.Xr tls_config_set_ciphers 3
مراجعه کنید.
.It Cm nosni
غیرفعال کردن Server Name Indication (SNI).
.It Cm noverify
معتبر بودن گواهی سرور الزامی نیست.
.It Cm protocols Ns = Ns Ar value
پروتکل‌های مورد استفاده را مشخص می‌کند.
برای
.Ar value
به
.Xr tls_config_parse_protocols 3
مراجعه کنید.
.It Cm servername Ns = Ns Ar value
استفاده از
.Ar value
برای Server Name Indication (SNI).
پیش‌فرض، نام میزبان سرور مشخص‌شده است.
.El
.It Fl v
افزایش جزئیات خروجی (حالت پرگو).
این گزینه می‌تواند چندین بار مشخص شود.
.El
.Sh "همچنین ببینید (SEE ALSO)"
.Xr smtpd 8
.Sh "تاریخچه (HISTORY)"
برنامهٔ
.Nm
نخستین بار در
.Ox 6.4
ظاهر شد.