.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "BASE 1"
.TH BASE 1 2025-05-03 "perl v5.40.2" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "نام (NAME)"
Swaks \- چاقوی سوئیسی SMTP، ابزار همه‌منظوره برای آزمودن تراکنش‌های SMTP
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
هدف اصلی طراحی Swaks این است که ابزاری منعطف، اسکریپت‌پذیر و مبتنی بر تراکنش برای آزمودن SMTP باشد. این ابزار از قابلیت‌ها و افزونه‌های SMTP نظیر TLS، احراز هویت (authentication) و pipelining؛ نسخه‌های متعددی از پروتکل SMTP شامل SMTP، ESMTP و LMTP؛ و روش‌های انتقال چندگانه شامل سوکت‌های دامنه یونیکس (UNIX-domain sockets)، سوکت‌های دامنه اینترنت (internet-domain sockets) و لوله‌ها (pipes) به فرایندهای ایجادشده پشتیبانی می‌کند. گزینه‌ها را می‌توان در متغیرهای محیطی، فایل‌های پیکربندی و خط فرمان مشخص کرد که حداکثر قابلیت پیکربندی و سهولت استفاده را برای مدیران سیستم و اسکریپت‌نویسان فراهم می‌آورد.
.SH "شروع سریع (QUICK START)"
.IX Header "QUICK START"
تحویل یک ایمیل آزمایشی استاندارد به user@example.com روی درگاه ۲۵ از test\-server.example.net:
.Sp
.Vb 1
\& swaks \-\-to user@example.com \-\-server test\-server.example.net
.Ve
.PP
تحویل یک ایمیل آزمایشی استاندارد با الزام به احراز هویت CRAM\-MD5 در نقش کاربر me@example.com. یک سرایند "X\-Test" به بدنه ایمیل اضافه خواهد شد. در صورتی که گذرواژه احراز هویت از فایل .netrc شما قابل دریافت نباشد، برای دریافت آن از شما درخواست خواهد شد:
.Sp
.Vb 1
\& swaks \-\-to user@example.com \-\-from me@example.com \-\-auth CRAM\-MD5 \-\-auth\-user me@example.com \-\-header\-X\-Test "test email"
.Ve
.PP
آزمودن یک اسکنر ضدویروس با استفاده از EICAR در یک پیوست. بخش DATA پیام نمایش داده نشود:
.Sp
.Vb 1
\& swaks \-t user@example.com \-\-attach \- \-\-server test\-server.example.com \-\-suppress\-data </path/to/eicar.txt
.Ve
.PP
آزمودن یک اسکنر هرزنامه با استفاده از GTUBE در بدنه ایمیل، که از طریق رکوردهای MX مربوط به example.com مسیریابی می‌شود:
.Sp
.Vb 1
\& swaks \-\-to user@example.com \-\-body @/path/to/gtube/file
.Ve
.PP
تحویل یک ایمیل آزمایشی استاندارد به user@example.com با استفاده از پروتکل LMTP از طریق یک فایل سوکت دامنه یونیکس:
.Sp
.Vb 1
\& swaks \-\-to user@example.com \-\-socket /var/lda.sock \-\-protocol LMTP
.Ve
.PP
گزارش تمامی گیرندگان موجود در یک فایل متنی که روی یک سرور آزمایشی قابل تأیید نیستند:
.Sp
.Vb 5
\& for E in \`cat /path/to/email/file\`
\& do
\&     swaks \-\-to $E \-\-server test\-server.example.com \-\-quit\-after RCPT \-\-hide\-all
\&     [ $? \-ne 0 ] && echo $E
\& done
.Ve
.SH "اصطلاحات و قراردادها (TERMS AND CONVENTIONS)"
.IX Header "TERMS AND CONVENTIONS"
این سند تلاش می‌کند در استفاده از اصطلاحات زیر یکپارچه و دقیق عمل کند تا از ابهام کاسته شود.
.IP Target 4
.IX Item "Target"
هدف (Target) یک تراکنش، آن چیزی است که Swaks به آن متصل می‌شود. این اصطلاح کلی در سرتاسر مستندات استفاده شده است زیرا اکثر اصطلاحات دیگر به اشتباه ماهیت خاصی از روش انتقال مورد استفاده را القا می‌کنند.
.IP Transport 4
.IX Item "Transport"
روش انتقال (Transport) روش زیرساختی مورد استفاده برای اتصال به هدف (target) است.
.IP Transaction 4
.IX Item "Transaction"
یک تراکنش (Transaction) عبارت است از باز کردن یک اتصال از طریق یک روش انتقال (transport) به یک هدف (target) و استفاده از یک پروتکل پیام‌رسانی به منظور تلاش برای تحویل پیام.
.IP Protocol 4
.IX Item "Protocol"
پروتکل (Protocol) زبان سطح کاربردی مورد استفاده برای ارتباط با هدف است. این سند از واژه SMTP برای اشاره به هر سه پروتکل پشتیبانی‌شده به صورت کلی استفاده می‌کند، مگر آنکه صراحتاً بیان شود که منظور صرفاً پروتکل خاص 'SMTP' است و موارد دیگر را شامل نمی‌شود.
.IP Message 4
.IX Item "Message"
پروتکل‌های SMTP برای انتقال پیام‌ها (Messages) وجود دارند؛ مجموعه‌ای از بایت‌ها در قالبی توافق‌شده که فرستنده و گیرنده دارند.
.IP Envelope 4
.IX Item "Envelope"
پاکت (Envelope) یک پیام حاوی فرستنده و گیرنده‌ی «واقعی» پیام است. همچنین می‌توان به اجزای آن به عنوان envelope-sender و envelope-recipients اشاره کرد. توجه به این نکته حائز اهمیت است که پاکت پیام لزوماً با سرایندهای \f(CW\*(C`To:\*(C'\fR و \f(CW\*(C`From:\*(C'\fR آن مطابقت ندارد.
.IP DATA 4
.IX Item "DATA"
بخش DATA در یک تراکنش SMTP همان پیام واقعی است که انتقال می‌یابد. این بخش شامل هر دوی سرایندها (headers) و بدنه (body) پیام می‌شود. گاهی اوقات DATA و بدنه به عنوان مترادف به کار می‌روند، اما در این سند همواره دو مفهوم کاملاً مجزا هستند.
.IP Headers 4
.IX Item "Headers"
سرایندهای (Headers) یک پیام به صورت تمام خطوط موجود در بخش DATA پیام قبل از اولین خط خالی تعریف می‌شوند. آن‌ها حاوی اطلاعاتی در مورد ایمیل هستند که به گیرنده نمایش داده خواهد شد، مانند \f(CW\*(C`To:\*(C'\fR، \f(CW\*(C`From:\*(C'\fR، \f(CW\*(C`Subject:\*(C'\fR و غیره. در این سند، سرایندها همواره با حرف اول بزرگ انگلیسی و یک دونقطه در انتها نوشته می‌شوند.
.IP Body 4
.IX Item "Body"
بدنه (Body) یک پیام، بخشی از قسمت DATA آن است که پس از اولین خط خالی قرار می‌گیرد.
.IP Option 4
.IX Item "Option"
یک گزینه (Option) پرچمی است که رفتار Swaks را تغییر می‌دهد. صرف‌نظر از شیوه ارائه آن، همیشه یک «گزینه» نامیده می‌شود. به عنوان مثال، \f(CW\*(C`\-\-no\-data\-fixup\*(C'\fR یک گزینه است.
.IP Argument 4
.IX Item "Argument"
هنگامی که یک گزینه، داده‌های اضافی علاوه بر خود گزینه دریافت می‌کند، آن داده اضافی یک آرگومان (Argument) نامیده می‌شود. در \f(CW\*(C`\-\-quit\-after <stop\-point>\*(Aq\*(C'\fR، مقدار \f(CW\*(C`<stop\-point>\*(C'\fR آرگومانِ گزینه \f(CW\*(C`\-\-quit\-after\*(C'\fR است.
.IP <literal\-string> 4
.IX Item "<literal-string>"
هنگامی که در تعریف یک گزینه به کار می‌رود، متنی که درون علامت‌های قلاب شکسته (\f(CW\*(C`<>\*(C'\fR) قرار دارد نشان‌دهنده یک برچسب توصیفی برای مقداری است که کاربر باید ارائه دهد. برای نمونه، \f(CW\*(C`\-\-quit\-after <stop\-point>\*(C'\fR نشان می‌دهد که \f(CW\*(C`<stop\-point>\*(C'\fR باید با یک مقدار معتبر نقطه توقف (stop-point) جایگزین شود.
.IP [<optional\-value>] 4
.IX Item "[<optional-value>]"
هنگامی که در تعریف یک گزینه به کار می‌رود، متنی که درون قلاب‌ها ([]) قرار دارد نشان می‌دهد که مقدار اختیاری است و می‌توان آن را حذف کرد. برای نمونه، \f(CW\*(C`\-\-to [<recipient>]\*(C'\fR نشان می‌دهد که گزینه \f(CW\*(C`\-\-to\*(C'\fR می‌تواند با یا بدون یک \f(CW\*(C`<recipient>\*(C'\fR مشخص‌شده استفاده شود..SH "پردازش گزینه‌ها (OPTION PROCESSING)"
.IX Header "OPTION PROCESSING"
برای جلوگیری از سردرگمی احتمالی در این مستند، یک پرچم در Swaks همواره با عنوان «گزینه» (option) نامیده می‌شود. اگر گزینه داده‌های بیشتری دریافت کند، آن داده‌های اضافی به عنوان یک «آرگومان» برای آن گزینه در نظر گرفته می‌شوند. برای نمونه، ممکن است \f(CW\*(C`\-\-from fred@example.com\*(C'\fR در خط فرمان به Swaks داده شود، که در آن \f(CW\*(C`\-\-from\*(C'\fR گزینه و \f(CW\*(C`fred@example.com\*(C'\fR آرگومان \f(CW\*(C`\-\-from\*(C'\fR است.
.PP
گزینه‌ها و آرگومان‌ها تنها راه ارائه اطلاعات به Swaks هستند. اگر Swaks در حین پردازش گزینه‌ها داده‌ای پیدا کند که نه گزینه است و نه آرگومان یک گزینه، با خطا متوقف شده و خارج می‌شود. برای نمونه، اگر \f(CW\*(C`\-\-no\-data\-fixup 1\*(C'\fR در خط فرمان پیدا شود، این مورد منجر به خطا خواهد شد زیرا \f(CW\*(C`\-\-no\-data\-fixup\*(C'\fR آرگومانی نمی‌پذیرد و بنابراین Swaks متوجه نخواهد شد با \f(CW1\fR چه کار کند.
.PP
گزینه‌ها را می‌توان به سه روش به Swaks ارسال کرد: می‌توان آن‌ها را در یک فایل پیکربندی، در متغیرهای محیطی، و در خط فرمان مشخص کرد. بسته به گزینه مربوطه و اینکه آیا آرگومانی به آن داده شده است یا خیر، Swaks ممکن است از کاربر درخواست کند آرگومان را وارد کند.
.PP
هنگامی که Swaks گزینه‌های خود را ارزیابی می‌کند، ابتدا به دنبال فایل پیکربندی می‌گردد (چه در یک مکان پیش‌فرض و چه مشخص‌شده با \f(CW\*(C`\-\-config\*(C'\fR). سپس هر گزینه‌ای را در متغیرهای محیطی ارزیابی می‌کند. در نهایت، گزینه‌های خط فرمان را ارزیابی می‌نماید. در هر مرحله از پردازش، گزینه‌هایی که پیش‌تر تنظیم شده‌اند بازنویسی (override) خواهند شد. علاوه بر این، به هر گزینه‌ای می‌توان پیشوند \f(CW\*(C`no\-\*(C'\fR را اضافه کرد تا Swaks فراموش کند که این متغیر قبلاً تنظیم شده است (چه در مرحله قبلی، چه زودتر در همان مرحله). این قابلیت ضروری است زیرا بسیاری از گزینه‌ها، حالت «تعریف‌شده بدون آرگومان» را متفاوت از «تعریف‌نشده» در نظر می‌گیرند.
.PP
به عنوان یک قاعده کلی، اگر یک گزینه چندین بار مشخص شود، آخرین باری که داده شده اعمال خواهد شد. این موضوع هم درون یک روش (اگر \f(CW\*(C`\-\-from user1@example.com \-\-from user2@example.com\*(C'\fR داده شود، مقدار \f(CW\*(C`user2@example.com\*(C'\fR استفاده خواهد شد) و هم بین روش‌های مختلف (اگر \f(CW\*(C`from user1@example.com\*(C'\fR در یک فایل پیکربندی داده شود و \f(CW\*(C`\-\-from user2@example.com\*(C'\fR در خط فرمان وارد شود، مقدار \f(CW\*(C`user2@example.com\*(C'\fR استفاده خواهد شد) صدق می‌کند.
.PP
تعریف هر گزینه با خلاصه‌ای درون پرانتز درباره نحوه رفتار آن پایان می‌یابد. کدهای زیر ممکن است استفاده شوند:
.IP "Arg-None, Arg-Optional, Arg-Required" 4
.IX Item "Arg-None, Arg-Optional, Arg-Required"
این سه کد مانعة‌الجمع هستند و مشخص می‌کنند که آیا گزینه آرگومان می‌گیرد یا خیر. توجه داشته باشید که این موضوع لزوماً مشخص نمی‌کند که آیا آرگومان باید مستقیماً ارائه شود، بلکه نشان می‌دهد که آیا در نهایت وجود آرگومان الزامی است یا خیر. برای نمونه، \f(CW\*(C`\-\-to\*(C'\fR با برچسب Arg-Required مشخص شده است، اما ارائه \f(CW\*(C`\-\-to\*(C'\fR در خط فرمان بدون آرگومان نیز مجاز است؛ زیرا در صورت عدم ارائه مستقیم، Swaks می‌تواند آرگومان لازم را از کاربر درخواست کند.
.IP From-Prompt 4
.IX Item "From-Prompt"
گزینه‌ای با برچسب From-Prompt، در صورتی که آرگومانی ارائه نشده باشد، به صورت تعاملی آن را از کاربر درخواست می‌کند.
.IP From-File 4
.IX Item "From-File"
گزینه‌ای با برچسب From-File، در شرایط خاصی آرگومان‌ها را به عنوان فایل مدیریت می‌کند.
.Sp
اگر آرگومان اولیه \f(CW\*(C`\-\*(C'\fR باشد، آرگومان نهایی محتویات \f(CW\*(C`STDIN\*(C'\fR خواهد بود. چندین گزینه همگی می‌توانند \f(CW\*(C`STDIN\*(C'\fR را مشخص کنند، اما محتوای یکسانی برای هر یک از آن‌ها استفاده خواهد شد.
.Sp
اگر آرگومان اولیه با پیشوند \f(CW\*(C`@\*(C'\fR مشخص شود، به عنوان مسیر یک فایل با آن برخورد خواهد شد. فایل باز شده و محتویات آن به عنوان آرگومان نهایی استفاده می‌شود. اگر محتویات فایل قابل خواندن نباشد، Swaks خارج خواهد شد. برای مشخص کردن یک مقدار رشته‌ای صریح که با \f(CW\*(C`@\*(C'\fR شروع می‌شود، از دو نماد \f(CW\*(C`@\*(C'\fR استفاده کنید؛ اولین نماد حذف خواهد شد. امکان مشخص کردن فایلی بدون مسیر مشخص که با علامت \f(CW\*(C`@\*(C'\fR شروع می‌شود وجود ندارد (مانند \f(CW\*(C`\-\-attach @file.txt\*(C'\fR یا \f(CW\*(C`\-\-attach @@file.txt\*(C'\fR)، اما اگر مسیری به فایل اضافه کنید که دو نماد \f(CW\*(C`@\*(C'\fR را جدا کند، کار خواهد کرد (برای نمونه \f(CW\*(C`\-\-attach @./@file.txt\*(C'\fR محتوای فایل \f(CW@file\fR.txt را شامل خواهد شد).
.IP Sensitive 4
.IX Item "Sensitive"
اگر گزینه‌ای با علامت Sensitive بخواهد آرگومانی را از کاربر درخواست کند و گزینه \f(CW\*(C`\-\-protect\-prompt\*(C'\fR تنظیم شده باشد، Swaks تلاش می‌کند ورودی کاربر را پنهان کند تا روی ترمینال نمایش داده نشود (اکو نشود). Swaks از چندین روش برای پنهان‌سازی ورودی تلاش می‌کند، اما اگر هیچ‌یک از آن‌ها کار نکند، روند اجرای برنامه با ورودی بدون پوشش ادامه خواهد یافت.
.IP Deprecated 4
.IX Item "Deprecated"
گزینه‌ای با برچسب Deprecated رسماً منسوخ شده است و در نسخه‌های آینده حذف خواهد شد. برای جزئیات بیشتر درباره موارد منسوخ، بخش «DEPRECATIONS» این مستند را ببینید.
.PP
سازوکار دقیق و قالب استفاده از هر یک از این انواع در زیر فهرست شده است.
.IP "فایل‌های پیکربندی (CONFIGURATION FILES)" 4
.IX Item "CONFIGURATION FILES"
می‌توان از یک فایل پیکربندی برای تنظیم گزینه‌های پرکاربرد یا بیش‌ازحد طولانی استفاده کرد. به‌طور پیش‌فرض، Swaks به ترتیب به دنبال \fR\f(CI$SWAKS_HOME\fR\fI/.swaksrc\fR، \fI\fR\f(CI$HOME\fR\fI/.swaksrc\fR، و \fI\fR\f(CI$LOGDIR\fR\fI/.swaksrc\fR می‌گردد. اگر یکی از آن‌ها وجود داشته باشد (و از \f(CW\*(C`\-\-config\*(C'\fR استفاده نشده باشد)، آن فایل به عنوان فایل پیکربندی استفاده می‌شود.
.Sp
علاوه بر این، یک فایل پیکربندی در مکانی غیرپیش‌فرض را می‌توان با استفاده از \f(CW\*(C`\-\-config\*(C'\fR مشخص کرد. اگر این گزینه تنظیم شود و آرگومانی به آن داده نشود، Swaks از هیچ فایل پیکربندی، از جمله هیچ فایل پیش‌فرضی، استفاده نخواهد کرد. اگر \f(CW\*(C`\-\-config\*(C'\fR به یک فایل خواندنی اشاره کند، به عنوان فایل پیکربندی استفاده می‌شود و هر پیش‌فرضی را که وجود داشته باشد لغو می‌کند. اگر به یک فایل غیرقابل‌خواندن اشاره کند، خطایی نشان داده شده و Swaks خارج خواهد شد.
.Sp
مجموعه‌ای از پیش‌فرض‌های «قابل حمل» (portable) را نیز می‌توان با افزودن گزینه‌ها به انتهای فایل برنامه Swaks ایجاد کرد. در نسخه توزیع‌شده، خط آخر Swaks باید \f(CW\*(C`_\|_END_\|_\*(C'\fR باشد. هر خطی که پس از \f(CW\*(C`_\|_END_\|_\*(C'\fR اضافه شود، به عنوان محتوای یک فایل پیکربندی در نظر گرفته خواهد شد. این امر امکان می‌دهد مجموعه‌ای از ترجیحات کاربر به طور خودکار در قالب یک فایل واحد از سروری به سرور دیگر کپی شود.
.Sp
اگر فایل‌های پیکربندی به صراحت غیرفعال نشده باشند، پیکربندی \f(CW\*(C`_\|_END_\|_\*(C'\fR همیشه خوانده می‌شود. در هر بار اجرای Swaks، تنها یک فایل پیکربندی دیگر استفاده خواهد شد، حتی اگر چندین فایل پیکربندی مشخص شده باشد. اگر قرار باشد پیکربندی \f(CW\*(C`_\|_END_\|_\*(C'\fR و پیکربندی دیگری خوانده شوند، ابتدا پیکربندی \f(CW\*(C`_\|_END_\|_\*(C'\fR پردازش خواهد شد. مشخص کردن گزینه \f(CW\*(C`\-\-config\*(C'\fR بدون آرگومان، پردازش هر دو پیکربندی \f(CW\*(C`_\|_END_\|_\*(C'\fR و هر فایل پیکربندی واقعی را غیرفعال می‌کند.
.Sp
در یک فایل پیکربندی، خطوطی که با علامت هش (\f(CW\*(C`#\*(C'\fR) شروع می‌شوند نادیده گرفته می‌شوند. سایر خطوط به عنوان گزینه‌ای برای Swaks در نظر گرفته می‌شوند که خط تیره یا خط تیره‌های ابتدای آن‌ها اختیاری است. هر چیزی پس از اولین فاصله در یک خط گزینه، به عنوان آرگومان آن گزینه در نظر گرفته می‌شود و پردازش شل روی آن انجام نمی‌گیرد. بنابراین، نقل‌قول (کوتیشن) معمولاً غیرضروری است و به صورت تحت‌اللفظی در آرگومان گنجانده خواهد شد.
.Sp
تفاوت ظریفی میان ارائه گزینه بدون آرگومان و ارائه گزینه با آرگومان خالی وجود دارد. اگر یک خط گزینه فاصله‌ای نداشته باشد، کل خط به عنوان گزینه در نظر گرفته می‌شود و آرگومانی وجود ندارد. اگر خط با یک فاصله تکی پایان یابد، به عنوان گزینه‌ای با آرگومان خالی پردازش می‌شود. بنابراین، \f(CW\*(C`apt\*(C'\fR مانند \f(CW\*(C`\-\-apt\*(C'\fR در نظر گرفته خواهد شد، اما \f(CW\*(C`apt \*(C'\fR مانند \f(CW\*(C`\-\-apt\ \*(Aq\*(Aq\*(C'\fR پردازش می‌شود.
.Sp
در اینجا مثالی از محتوای یک فایل پیکربندی آورده شده است:
.Sp
.Vb 6
\&    # always use this sender, no matter server or logged in user
\&    \-\-from fred@example.com
\&    # I prefer my test emails have a pretty from header.  Note
\&    # the lack of dashes on option and lack of quotes around
\&    # entire argument.
\&    h\-From: "Fred Example" <fred@example.com>
.Ve
.Sp
گزینه‌های ویژه فایل پیکربندی:
.RS 4
.IP "\-\-config [<config\-file>]" 4
.IX Item "--config [<config-file>]"
این گزینه مسیری را به یک فایل پیکربندی خاص برای استفاده مشخص می‌کند. اگر بدون آرگومان مشخص شود، هیچ فایل پیکربندی که به‌طور خودکار پیدا شده باشد (از طریق \f(CW$HOME\fR، و غیره، یا \f(CW\*(C`_\|_END_\|_\*(C'\fR) پردازش نخواهد شد. اگر آرگومان فایلی معتبر باشد، آن فایل به عنوان فایل پیکربندی استفاده می‌شود (پس از پیکربندی \f(CW\*(C`_\|_END_\|_\*(C'\fR). اگر آرگومان فایلی معتبر و خواندنی نباشد، Swaks خطا داده و خارج می‌شود. این گزینه را می‌توان چندین بار مشخص کرد، اما تنها اولین باری که مشخص شده است (در ترتیب جستجوی متغیرهای محیطی و خط فرمان) استفاده خواهد شد. (Arg-Optional)
.RE
.RS 4
.RE
.IP "متغیرهای محیطی پیکربندی (CONFIGURATION ENVIRONMENT VARIABLES)" 4
.IX Item "CONFIGURATION ENVIRONMENT VARIABLES"
گزینه‌ها را می‌توان از طریق متغیرهای محیطی نیز ارسال کرد. این متغیرها به صورت \f(CW$SWAKS_OPT_name\fR هستند، که در آن \f(CW\*(C`name\*(C'\fR نام گزینه‌ای است که در خط فرمان مشخص می‌شود. از آنجا که در اکثر شل‌های شبه‌یونیکس خط فاصله در نام متغیرهای محیطی مجاز نیست، نباید از خط فاصله‌های ابتدایی استفاده کرد و هر خط فاصله‌ای درون نام گزینه باید با زیرخط (underscore) جایگزین شود. دستورات زیر همان گزینه‌های نشان‌داده‌شده در مثال فایل پیکربندی را ایجاد می‌کنند:
.Sp
.Vb 2
\&    $ SWAKS_OPT_from=\*(Aqfred@example.com\*(Aq
\&    $ SWAKS_OPT_h_From=\*(Aq"Fred Example" <fred@example.com>\*(Aq
.Ve
.Sp
تنظیم یک متغیر روی مقداری خالی، معادل مشخص کردن آن در خط فرمان بدون آرگومان است. برای نمونه، تنظیم <SWAKS_OPT_server=""> باعث می‌شود Swaks در هر بار اجرا، سرور مقصد برای اتصال را از کاربر درخواست کند. در ویندوز، تنظیم متغیرهای محیطی خالی امکان‌پذیر نیست؛ این رفتار را می‌توان با تنظیم متغیر محیطی روی \f(CW\*(C`<>\*(C'\fR شبیه‌سازی کرد. علاوه بر این، گنجاندن نام سرآیند در گزینه header از طریق متغیر محیطی در ویندوز مجاز نیست (برای نمونه، \f(CW\*(C`SWAKS_OPT_header_Foo=bar\*(C'\fR منجر به خطا خواهد شد، اما \f(CW\*(C`SWAKS_OPT_header="Foo: bar"\*(C'\fR کار خواهد کرد).
.Sp
از آنجا که ترتیب ذاتی در گزینه‌های ارائه‌شده از طریق متغیرهای محیطی وجود ندارد، این گزینه‌ها قبل از پردازش مرتب‌سازی می‌شوند. این روش شاید عالی نباشد، اما دست‌کم رفتاری را تعیین می‌کند که در غیر این صورت نامشخص می‌ماند. به عنوان مثال، اگر هر دو متغیر \f(CW$SWAKS_OPT_from\fR و \f(CW$SWAKS_OPT_f\fR تنظیم شده باشند، مقدار \f(CW$SWAKS_OPT_from\fR استفاده خواهد شد، زیرا پس از \f(CW$SWAKS_OPT_f\fR مرتب می‌شود. همچنین به دلیل عدم وجود ترتیب ذاتی در پردازش محیط، غیرفعال کردن گزینه‌ها با پیشوند \f(CW\*(C`no\-\*(C'\fR قابل‌اعتماد نیست. این کار در صورتی عمل می‌کند که گزینه مورد نظر برای خاموش شدن، قبل از \f(CW\*(C`no\-\*(C'\fR مرتب شود، اما اگر بعد از آن مرتب شود ناموفق خواهد بود. از آنجا که هدف اصلی \f(CW\*(C`no\-\*(C'\fR کارکرد بین انواع روش‌های پیکربندی است (برای نمونه، لغو گزینه‌ای از خط فرمان که در فایل پیکربندی تنظیم شده بود)، بعید است این موضوع مشکلی ایجاد کند.
.Sp
علاوه بر تنظیم معادل گزینه‌های خط فرمان، می‌توان \f(CW$SWAKS_HOME\fR را روی دایرکتوری حاوی فایل پیش‌فرض \fI.swaksrc\fR برای استفاده تنظیم کرد.
.IP "گزینه‌های خط فرمان (COMMAND LINE OPTIONS)" 4
.IX Item "COMMAND LINE OPTIONS"
آخرین روش ارائه گزینه‌ها به Swaks از طریق خط فرمان است. رفتار گزینه‌ها با اکثر برنامه‌های خط فرمان شبه‌یونیکس سازگار است. بسیاری از گزینه‌ها دارای هر دو شکل کوتاه و بلند هستند (برای نمونه \f(CW\*(C`\-s\*(C'\fR و \f(CW\*(C`\-\-server\*(C'\fR). طبق قرارداد، گزینه‌های کوتاه با یک خط تیره و گزینه‌های بلند با دو خط تیره مشخص می‌شوند. این تنها یک قرارداد است و هر پیشوندی با هر دو نوع کار می‌کند.
.Sp
دستور زیر مثال نشان‌داده‌شده در بخش‌های فایل پیکربندی و متغیر محیطی را نشان می‌دهد:
.Sp
.Vb 1
\&    $ swaks \-\-from fred@example.com \-\-h\-From: \*(Aq"Fred Example" <fred@example.com>\*(Aq
.Ve
.SH "روش‌های انتقال (TRANSPORTS)"
.IX Header "TRANSPORTS"
برنامه Swaks می‌تواند از طریق پایپ‌های یونیکس («پایپ‌ها»)، سوکت‌های دامنه یونیکس («سوکت‌های یونیکس»)، یا سوکت‌های دامنه اینترنت («سوکت‌های شبکه») به یک هدف متصل شود. اتصال از طریق سوکت‌های شبکه رفتار پیش‌فرض است. با توجه به ماهیت منفرد بودن روش انتقال مورداستفاده، هر مجموعه از گزینه‌های بخش زیر مانعة‌الجمع هستند. مشخص کردن بیش از یکی از گزینه‌های \f(CW\*(C`\-\-server\*(C'\fR، \f(CW\*(C`\-\-pipe\*(C'\fR یا \f(CW\*(C`\-\-socket\*(C'\fR منجر به خطا خواهد شد. ترکیب سایر گزینه‌ها میان انواع روش‌های انتقال، صرفاً منجر به نادیده گرفته شدن گزینه‌های نامربوط می‌شود. در ادامه شرح مختصری از هر روش انتقال و گزینه‌های ویژه آن روش ارائه شده است.
.IP "سوکت‌های شبکه (NETWORK SOCKETS)" 4
.IX Item "NETWORK SOCKETS"
این روش انتقال تلاش می‌کند تا پیامی را از طریق TCP/IP، که روش استاندارد برای تحویل SMTP است، ارسال کند. این روش انتقال پیش‌فرض برای Swaks است. اگر هیچ‌یک از گزینه‌های \f(CW\*(C`\-\-server\*(C'\fR، \f(CW\*(C`\-\-pipe\*(C'\fR یا \f(CW\*(C`\-\-socket\*(C'\fR داده نشوند، از این انتقال استفاده می‌شود و سرور هدف از روی دامنه گیرنده تعیین می‌گردد (برای جزئیات بیشتر به \f(CW\*(C`\-\-server\*(C'\fR در زیر مراجعه کنید).
.Sp
این روش انتقال نیازمند ماژول IO::Socket::IP برای هر دو سوکت‌های IPv4 و IPv6 است. اگر این ماژول قابل بارگذاری نباشد، Swaks تلاش خواهد کرد از کتابخانه IO::Socket برای IPv4 و IO::Socket::INET6 برای پشتیبانی از IPv6 استفاده کند. تلاش برای استفاده از این روش انتقال در حالی که هیچ‌یک از این کتابخانه‌ها در دسترس نباشند، منجر به خطا و پایان اجرای برنامه خواهد شد.
.Sp
استفاده جایگزین از IO::Socket و IO::Socket::INET6 منسوخ شده است و در نسخه‌های آینده حذف خواهد شد. بخش DEPRECATIONS در زیر را ببینید.
.RS 4
.IP "\-s, \-\-server [<target\-server>[:<port>]]" 4
.IX Item "-s, --server [<target-server>[:<port>]]"
به‌طور صریح به Swaks می‌گوید که از سوکت‌های شبکه استفاده کند و نام میزبان یا نشانی IP مقصد برای اتصال را مشخص نماید، یا اگر آرگومانی ارائه نشود، آن را از کاربر درخواست کند. اگر این گزینه داده نشود و هیچ گزینه انتقال دیگری نیز مشخص نشده باشد، سرور ایمیل مقصد از روی رکوردهای DNS مناسب برای دامنه نشانی ایمیل گیرنده با استفاده از ماژول Net::DNS تعیین می‌شود. اگر Net::DNS در دسترس نباشد، Swaks تلاش می‌کند برای تحویل به localhost متصل شود. پورت هدف را نیز می‌توان به صورت اختیاری در اینجا تنظیم کرد. قالب‌های پشتیبانی‌شده برای این منظور شامل SERVER:PORT (پشتیبانی از نام‌ها و نشانی‌های IPv4)؛ [SERVER]:PORT و SERVER/PORT (پشتیبانی از نام‌ها، نشانی‌های IPv4 و IPv6) هستند. پورتی که از طریق این گزینه تنظیم شود فقط در صورتی استفاده می‌شود که گزینه \f(CW\*(C`\-\-port\*(C'\fR استفاده نشده باشد. همچنین \f(CW\*(C`\-\-copy\-routing\*(C'\fR را ببینید. (Arg-Required, From-Prompt)
.IP "\-p, \-\-port [<port>]" 4
.IX Item "-p, --port [<port>]"
مشخص می‌کند که از کدام پورت TCP در مقصد باید استفاده شود، یا اگر آرگومانی ذکر نشده باشد آن را درخواست می‌کند. آرگومان می‌تواند نام یک سرویس (مطابق دریافت‌شده توسط \fBgetservbyname\fR\|(3)) یا یک شماره پورت باشد. پورت پیش‌فرض smtp/25 است، مگر اینکه تحت تأثیر گزینه‌های \f(CW\*(C`\-\-protocol\*(C'\fR یا \f(CW\*(C`\-\-tls\-on\-connect\*(C'\fR تغییر کند. (Arg-Required, From-Prompt)
.IP "\-li, \-\-local\-interface [<local\-interface>[:<port>]]" 4
.IX Item "-li, --local-interface [<local-interface>[:<port>]]"
استفاده از آرگومان به عنوان رابط محلی برای اتصال خروجی SMTP، یا درخواست از کاربر در صورت ارائه نشدن آرگومان. آرگومان می‌تواند یک نشانی IP یا یک نام میزبان باشد. اقدام پیش‌فرض این است که اجازه داده شود سیستم‌عامل رابط محلی را انتخاب کند. برای توضیحات تکمیلی درباره قالب :<port> به \f(CW\*(C`\-\-server\*(C'\fR مراجعه کنید. پورتی که از طریق این گزینه تنظیم شود تنها در صورتی استفاده خواهد شد که از گزینه \f(CW\*(C`\-\-port\*(C'\fR استفاده نشده باشد. (Arg-Required, From-Prompt)
.IP "\-lp, \-\-local\-port, \-\-lport [<port>]" 4
.IX Item "-lp, --local-port, --lport [<port>]"
مشخص کردن پورت خروجی که تراکنش از آن آغاز می‌شود. آرگومان می‌تواند نام یک سرویس (همان‌طور که توسط \fBgetservbyname\fR\|(3) دریافت می‌شود) یا یک شماره پورت باشد. اگر این گزینه مشخص نشود، سیستم یک پورت موقت (ephemeral) انتخاب خواهد کرد. توجه داشته باشید که کاربران عادی نمی‌توانند برخی پورت‌ها را تعیین کنند. (Arg-Required, From-Prompt)
.IP "\-\-copy\-routing <domain>" 4
.IX Item "--copy-routing <domain>"
آرگومان به عنوان بخش دامنه یک نشانی ایمیل تفسیر می‌شود و برای یافتن سرور مقصد با همان منطقی به کار می‌رود که برای جستجوی سرور مقصد نشانی ایمیل گیرنده استفاده می‌شود. برای جزئیات بیشتر درباره نحوه تعیین هدف از روی دامنه ایمیل، گزینه \f(CW\*(C`\-\-to\*(C'\fR را ببینید. (Arg-Required)
.IP "\-4, \-6" 4
.IX Item "-4, -6"
اجبار به استفاده از IPv4 یا IPv6. (Arg-None)
.RE
.RS 4
.RE
.IP "سوکت‌های یونیکس (UNIX SOCKETS)" 4
.IX Item "UNIX SOCKETS"
این روش انتقال تلاش می‌کند پیام‌ها را از طریق یک فایل سوکت دامنه یونیکس (UNIX-domain socket) تحویل دهد. این قابلیت برای آزمایش MTA/MDAهایی که به فایل‌های سوکت گوش می‌دهند مفید است (برای نمونه، آزمایش تحویل LMTP به Cyrus). این روش انتقال نیازمند ماژول IO::Socket::UNIX است که بخشی از توزیع استاندارد Perl است. اگر این ماژول قابل بارگذاری نباشد، تلاش برای استفاده از این روش انتقال منجر به خطا و پایان اجرای برنامه خواهد شد.
.RS 4
.IP "\-\-socket [<socket\-file>]" 4
.IX Item "--socket [<socket-file>]"
این گزینه یک فایل سوکت دامنه یونیکس را به عنوان آرگومان خود دریافت می‌کند. اگر Swaks نتواند این سوکت را باز کند، پیامی مبنی بر خطا نمایش داده و خارج خواهد شد. (Arg-Required, From-Prompt)
.RE
.RS 4
.RE
.IP "پایپ‌ها (PIPES)" 4
.IX Item "PIPES"
این روش انتقال تلاش می‌کند تا پردازشی را ایجاد (spawn) کرده و از طریق پایپ‌ها با آن ارتباط برقرار کند. برنامه اجراشده باید آماده باشد تا روی \f(CW\*(C`STDIN\*(C'\fR/\f(CW\*(C`STDOUT\*(C'\fR مانند یک سرور ایمیل رفتار کند. هر MTA که برای اجرا از inet/xinet طراحی شده باشد باید از این حالت پشتیبانی کند. علاوه بر این، برخی از MTAها حالت‌های آزمایشی ارائه می‌دهند که می‌توان از طریق \f(CW\*(C`STDIN\*(C'\fR/\f(CW\*(C`STDOUT\*(C'\fR با آن‌ها ارتباط برقرار کرد. این روش انتقال را می‌توان برای خودکارسازی این آزمایش‌ها استفاده کرد. برای مثال، اگر بررسی DNSBL را با Exim پیاده‌سازی کرده‌اید و می‌خواهید مطمئن شوید که کار می‌کند، می‌توانید \f(CW\*(C`swaks \-\-pipe "exim \-bh 127.0.0.2"\*(C'\fR را اجرا کنید. در حالت ایده‌آل، پردازشی که با آن تعامل دارید باید روی \f(CW\*(C`STDIN\*(C'\fR و \f(CW\*(C`STDOUT\*(C'\fR دقیقاً مانند یک سرور SMTP عمل کند. هرگونه داده اشکال‌زدایی (debug) باید به \f(CW\*(C`STDERR\*(C'\fR فرستاده شود، که به ترمینال شما هدایت خواهد شد. در عمل، Swaks معمولاً می‌تواند مقداری داده اشکال‌زدایی را روی \f(CW\*(C`STDOUT\*(C'\fR پردازش فرزند مدیریت کند، اما هیچ تضمینی درباره مقدار قابل تحمل آن وجود ندارد.
.Sp
این روش انتقال نیازمند ماژول IPC::Open2 است که بخشی از توزیع استاندارد Perl است. اگر این ماژول قابل بارگذاری نباشد، تلاش برای استفاده از این روش انتقال منجر به خطا و خاتمه برنامه خواهد شد.
.RS 4
.IP "\-\-pipe [<command\-and\-arguments>]" 4
.IX Item "--pipe [<command-and-arguments>]"
یک نام پردازش و آرگومان‌های آن پردازش را ارائه می‌دهد. Swaks تلاش خواهد کرد تا پردازش را اجرا کرده و از طریق پایپ‌ها با آن ارتباط برقرار کند. اگر آرگومان یک فایل اجرایی نباشد، Swaks خطایی نمایش داده و خارج خواهد شد. (Arg-Required, From-Prompt)
.RE
.RS 4
.RE.SH "گزینه‌های پروتکل (PROTOCOL OPTIONS)"
.IX Header "PROTOCOL OPTIONS"
این گزینه‌ها به لایهٔ پروتکل مربوط می‌شوند.
.IP "\-t, \-\-to [<email\-address>[,<email\-address>[,...]]]" 4
.IX Item "-t, --to [<email-address>[,<email-address>[,...]]]"
.PD 0
.IP "\-\-cc [<email\-address>[,<email\-address>[,...]]]" 4
.IX Item "--cc [<email-address>[,<email-address>[,...]]]"
.IP "\-\-bcc [<email\-address>[,<email\-address>[,...]]]" 4
.IX Item "--bcc [<email-address>[,<email-address>[,...]]]"
.PD
همگی این گزینه‌ها به Swaks می‌گویند که از آرگومان(ها) به‌عنوان گیرندهٔ پاکت (envelope-recipient) برای رایانامه استفاده کند. تفاوت‌های ظریفی میان این سه گزینه وجود دارد که جزئیات آن‌ها در ادامه آمده است. اگر گزینه‌ای بدون آرگومان مشخص شود، Swaks از کاربر برای وارد کردن آرگومان درخواست می‌کند.
.Sp
\&\f(CW\*(C`\-\-to\*(C'\fR از این نظر ویژه است که تنها گزینهٔ الزامی در Swaks است. هیچ مقدار پیش‌فرضی برای این گزینه وجود ندارد. اگر گیرنده‌ای به هیچ طریقی مشخص نشده باشد، از کاربر به‌صورت تعاملی خواسته می‌شود تا مقداری وارد کند. تنها استثنا زمانی است که یک مقدار برای \f(CW\*(C`\-\-quit\-after\*(C'\fR تعیین شده باشد که سبب می‌شود تراکنش SMTP پیش از نیاز به گیرنده پایان یابد. اگر چندین گیرنده مشخص شده باشند و برای تعیین مسیر به دامنهٔ گیرنده نیاز باشد، دامنهٔ آخرین گیرنده در فهرست آرگومان‌های \f(CW\*(C`\-\-to\*(C'\fR استفاده می‌شود.
.Sp
تمایز اصلی میان این گزینه‌ها در نحوهٔ برخورد با آرگومان‌های آن‌ها هنگام تولید بخش DATA رایانامه است. هر یک از آن‌ها نشانهٔ جایگزین مخصوص به خود را دارند (به‌ترتیب \f(CW\*(C`%TO_ADDRESS%\*(C'\fR، \f(CW\*(C`%CC_ADDRESS%\*(C'\fR و \f(CW\*(C`%BCC_ADDRESS%\*(C'\fR) که هر کس می‌تواند هنگام ساخت یک DATA سفارشی از آن‌ها استفاده کند. در پیام پیش‌فرض Swaks، از \f(CW\*(C`%TO_ADDRESS%\*(C'\fR برای سربرگ To: استفاده می‌شود و در صورت پر بودن، از \f(CW\*(C`%CC_HEADER%\*(C'\fR برای سربرگ Cc: استفاده خواهد شد. \f(CW\*(C`%BCC_ADDRESS%\*(C'\fR در DATA پیش‌فرض استفاده نمی‌شود. (Arg-Required, From-Prompt)
.IP "\-f, \-\-from [<email\-address>]" 4
.IX Item "-f, --from [<email-address>]"
از آرگومان به‌عنوان فرستندهٔ پاکت (envelope-sender) برای رایانامه استفاده می‌کند، یا در صورت مشخص نشدن آرگومان از کاربر درخواست ورودی می‌کند. رشتهٔ \f(CW\*(C`<>\*(C'\fR می‌تواند به معنای فرستندهٔ تهی (null sender) داده شود. اگر کاربر نشانی فرستنده‌ای را مشخص نکند، از یک مقدار پیش‌فرض استفاده می‌شود. بخش دامنه (domain-part) فرستندهٔ پیش‌فرض، بهترین حدس از نام دامنهٔ کاملاً مشخص‌شدهٔ (FQDN) میزبان محلی است. روش تعیین بخش محلی (local-part) متغیر است. اگر متغیر محیطی \f(CW$LOGNAME\fR تنظیم شده باشد، به‌عنوان بخش محلی استفاده خواهد شد. در غیر این صورت، در ویندوز از مقدار \f(CWWin32::LoginName()\fR و در پلتفرم‌های شبه‌یونیکس از \fBgetpwuid\fR\|(3) استفاده می‌شود. همچنین \f(CW\*(C`\-\-force\-getpwuid\*(C'\fR را ببینید. اگر Swaks نتواند نام میزبان محلی را تشخیص دهد و نشانی فرستنده برای تراکنش لازم باشد، Swaks با خطا متوقف شده و خارج می‌شود. در این حالت، باید یک رشتهٔ معتبر از طریق این گزینه ارائه شود. (Arg-Required, From-Prompt)
.IP "\-\-ehlo, \-\-lhlo, \-h, \-\-helo [<helo\-string>]" 4
.IX Item "--ehlo, --lhlo, -h, --helo [<helo-string>]"
رشته‌ای که به‌عنوان آرگومان برای دستور HELO/EHLO/LHLO استفاده می‌شود، یا در صورت مشخص نشدن آرگومان از کاربر درخواست ورودی می‌کند. اگر از این گزینه استفاده نشود، بهترین حدس از نام دامنهٔ کاملاً مشخص‌شدهٔ میزبان محلی استفاده خواهد شد. اگر Swaks نتواند نام میزبان محلی را تشخیص دهد و رشتهٔ helo برای تراکنش مورد نیاز باشد، Swaks با خطا خارج می‌شود. در این حالت، باید رشته‌ای معتبر از طریق این گزینه ارائه گردد. (Arg-Required, From-Prompt)
.IP "\-q, \-\-quit, \-\-quit\-after <stop\-point>" 4
.IX Item "-q, --quit, --quit-after <stop-point>"
نقطه‌ای که تراکنش باید در آن متوقف شود. هنگامی که تراکنش به نقطهٔ توقف درخواستی برسد، و به شرطی که Swaks پیش از رسیدن به آن دچار خطا نشده باشد، دستور "QUIT" را ارسال کرده و تلاش می‌کند اتصال را به‌طور تمیز ببندد. آرگومان‌های معتبر و نکات مربوط به معنای آن‌ها به شرح زیر است. (Arg-Required)
.RS 4
.IP PROXY 4
.IX Item "PROXY"
پس از ارسال پاسخ از سوی سرور به یک درخواست PROXY خارج می‌شود. توجه داشته باشید که اگر خطایی در مذاکرهٔ پروکسی رخ ندهد، این گزینه با CONNECT مترادف خواهد بود.
.IP "CONNECT, BANNER" 4
.IX Item "CONNECT, BANNER"
پس از دریافت بنر خوش‌آمدگویی از مقصد، نشست را پایان می‌دهد.
.IP "FIRST-HELO, FIRST-EHLO, FIRST-LHLO" 4
.IX Item "FIRST-HELO, FIRST-EHLO, FIRST-LHLO"
در یک نشست STARTTLS (نه در حالت tls-on-connect)، تراکنش را پس از نخستین مورد از دو HELO خاتمه می‌دهد. در یک تراکنش غیر STARTTLS، همانند HELO رفتار می‌کند (پایین را ببینید).
.IP XCLIENT 4
.IX Item "XCLIENT"
پس از مذاکرهٔ XCLIENT خارج می‌شود. صرف‌نظر از اینکه تلاشی برای آن شده باشد یا خیر، این گزینه همیشه پس از نقطه‌ای که قرار بود XCLIENT مذاکره شود خارج می‌گردد.
.IP XCLIENT-HELO 4
.IX Item "XCLIENT-HELO"
پس از HELOای که با مذاکرهٔ XCLIENT برانگیخته می‌شود، خارج می‌شود. این مورد با HELO و FIRST-HELO تفاوت دارد زیرا مذاکرهٔ XCLIENT می‌تواند در چندین نقطه از تراکنش SMTP رخ دهد و امکان ارجاع دقیق به HELO متصل به XCLIENT با استفاده از نقاط توقف HELO یا FIRST-HELO وجود ندارد. این گزینه همیشه پس از نقطه‌ای که HELO برانگیخته از XCLIENT قرار بود رخ دهد خارج می‌شود، صرف‌نظر از اینکه تلاشی برای آن انجام شده باشد یا خیر.
.IP "STARTTLS, TLS" 4
.IX Item "STARTTLS, TLS"
بلافاصله پس از مذاکرهٔ TLS تراکنش را متوقف کرده و خارج می‌شود. توجه داشته باشید که بسته به استفاده از STARTTLS یا tls-on-connect، این اتفاق در مراحل متفاوتی رخ می‌دهد. صرف‌نظر از این که تلاشی برای آن انجام شده باشد یا خیر، همیشه پس از نقطه‌ای که TLS قرار بود مذاکره شود خارج می‌گردد.
.IP "HELO, EHLO, LHLO" 4
.IX Item "HELO, EHLO, LHLO"
در نشست STARTTLS یا XCLIENT، پس از دومین HELO خارج می‌شود. در غیر این صورت پس از نخستین و تنها HELO پایان می‌یابد.
.IP AUTH 4
.IX Item "AUTH"
پس از احراز هویت خارج می‌شود. صرف‌نظر از اینکه تلاشی انجام گرفته باشد یا خیر، همواره پس از نقطه‌ای که قرار بود احراز هویت مذاکره شود خارج می‌شود.
.IP "MAIL, FROM" 4
.IX Item "MAIL, FROM"
پس از ارسال MAIL FROM: خارج می‌شود.
.IP "RCPT, TO" 4
.IX Item "RCPT, TO"
پس از ارسال RCPT TO: خارج می‌شود.
.RE
.RS 4
.RE
.IP "\-\-da, \-\-drop\-after <stop\-point>" 4
.IX Item "--da, --drop-after <stop-point>"
این گزینه مشابه \f(CW\*(C`\-\-quit\-after\*(C'\fR است، اما به جای تلاش برای بستن تمیز نشست، صرفاً نشست را قطع می‌کند. این گزینه همان نقاط توقفِ \f(CW\*(C`\-\-quit\-after\*(C'\fR را می‌پذیرد و علاوه بر آن‌ها DATA و DOT را نیز قبول می‌کند که جزئیات آن‌ها در ادامه آمده است. (Arg-Required)
.RS 4
.IP DATA 4
.IX Item "DATA"
اتصال را پس از ارسال DATA توسط سرور قطع می‌کند.
.IP DOT 4
.IX Item "DOT"
اتصال را پس از ارسال «.» پایانی پیام توسط سرور قطع می‌کند.
.RE
.RS 4
.RE
.IP "\-\-das, \-\-drop\-after\-send <stop\-point>" 4
.IX Item "--das, --drop-after-send <stop-point>"
این گزینه شبیه به \f(CW\*(C`\-\-drop\-after\*(C'\fR است، اما به جای قطع ارتباط پس از خواندن پاسخ برای نقطهٔ توقف، بلافاصله پس از ارسال نقطهٔ توقف، اتصال را قطع می‌کند. این گزینه همان نقاط توقف \f(CW\*(C`\-\-drop\-after\*(C'\fR را می‌پذیرد. اگر نقطهٔ توقف برای بخشی اختیاری از تراکنش باشد که عملاً ارسال نشده است (برای نمونه STARTTLS یا AUTH)، این گزینه دقیقاً مانند \f(CW\*(C`\-\-drop\-after\*(C'\fR عمل خواهد کرد. برای جزئیات به موارد زیر مراجعه کنید. (Arg-Required)
.RS 4
.IP CONNECT 4
.IX Item "CONNECT"
به سرور متصل می‌شود و سپس پیش از دریافت بنر سرور، ارتباط را قطع می‌کند.
.IP "STARTTLS, TLS" 4
.IX Item "STARTTLS, TLS"
کاملاً یکسان با \f(CW\*(C`\-\-drop\-after\*(C'\fR عمل می‌کند.
.IP "HELO, EHLO, LHLO" 4
.IX Item "HELO, EHLO, LHLO"
لزوماً مطابق انتظار عمل نمی‌کند. اگر به نظر می‌رسد پاسخ HELO را به نادرستی می‌خواند، به جای آن از FIRST-HELO استفاده کنید.
.RE
.RS 4
.RE
.IP "\-\-timeout [<time>]" 4
.IX Item "--timeout [<time>]"
از آرگومان به‌عنوان زمان مهلت (تایم‌اوت) تراکنش SMTP استفاده می‌کند، یا در صورت مشخص نشدن آرگومان، از کاربر درخواست می‌کند. آرگومان می‌تواند یک عدد خالص باشد که به ثانیه تفسیر می‌شود، یا می‌تواند دارای پسوندهای s، m یا h باشد (5s = ۵ ثانیه، 3m = ۱۸۰ ثانیه، 1h = ۳۶۰۰ ثانیه). به‌عنوان یک حالت خاص، 0 به معنای نامحدود بودن زمان تراکنش است. مقدار پیش‌فرض 30s است. (Arg-Required, From-Prompt)
.IP "\-\-protocol <protocol>" 4
.IX Item "--protocol <protocol>"
مشخص می‌کند کدام پروتکل در تراکنش به کار رود. گزینه‌های معتبر در جدول زیر نشان داده شده‌اند. در حال حاضر پروتکل‌های اصلی SMTP، ESMTP و LMTP هستند. با استفاده از گونه‌های این انواع پروتکل، می‌توان پورت‌های پیش‌فرض، تلاش برای احراز هویت و نوع اتصال TLS مد نظر را به شکل خلاصه مشخص کرد. پروتکل پیش‌فرض ESMTP است. جدول زیر آرگومان‌های موجود برای \f(CW\*(C`\-\-protocol\*(C'\fR و گزینه‌هایی که هر کدام به‌طور جانبی تنظیم می‌کنند را نشان می‌دهد. (Arg-Required)
.RS 4
.IP SMTP 4
.IX Item "SMTP"
HELO, "\-p 25"
.IP SSMTP 4
.IX Item "SSMTP"
EHLO\->HELO, "\-tlsc \-p 465"
.IP SSMTPA 4
.IX Item "SSMTPA"
EHLO\->HELO, "\-a \-tlsc \-p 465"
.IP SMTPS 4
.IX Item "SMTPS"
HELO, "\-tlsc \-p 465"
.IP ESMTP 4
.IX Item "ESMTP"
EHLO\->HELO, "\-p 25"
.IP ESMTPA 4
.IX Item "ESMTPA"
EHLO\->HELO, "\-a \-p 25"
.IP ESMTPS 4
.IX Item "ESMTPS"
EHLO\->HELO, "\-tls \-p 25"
.IP ESMTPSA 4
.IX Item "ESMTPSA"
EHLO\->HELO, "\-a \-tls \-p 25"
.IP LMTP 4
.IX Item "LMTP"
LHLO, "\-p 24"
.IP LMTPA 4
.IX Item "LMTPA"
LHLO, "\-a \-p 24"
.IP LMTPS 4
.IX Item "LMTPS"
LHLO, "\-tls \-p 24"
.IP LMTPSA 4
.IX Item "LMTPSA"
LHLO, "\-a \-tls \-p 24"
.RE
.RS 4
.RE
.IP \-\-pipeline 4
.IX Item "--pipeline"
اگر سرور راه دور پشتیبانی کند، برای SMTP PIPELINING (RFC 2920) تلاش می‌کند. (Arg-None)
.IP \-\-prdr 4
.IX Item "--prdr"
اگر سرور پشتیبانی کند، برای Per-Recipient Data Response (PRDR) (<https://tools.ietf.org/html/draft\-hall\-prdr\-00.txt>) تلاش می‌کند. پروتکل PRDR هنوز استاندارد نشده است، اما MTAها شروع به پیاده‌سازی این پیشنهاد کرده‌اند. (Arg-None)
.IP \-\-force\-getpwuid 4
.IX Item "--force-getpwuid"
به Swaks اعلام می‌کند که به جای آزمایش اولیهٔ \f(CW$LOGNAME\fR، از روش پیش‌فرض سیستم برای تعیین نام کاربریِ کاربر جاری جهت بخش محلی پیش‌فرض فرستنده استفاده کند. با وجود نام گزینه که مختص شبه‌یونیکس به نظر می‌رسد، این گزینه در ویندوز نیز کار می‌کند. (Arg-None).SH "TLS / رمزنگاری (TLS / ENCRYPTION)"
.IX Header "TLS / ENCRYPTION"
این‌ها گزینه‌های مربوط به رمزنگاری تراکنش هستند. این گزینه‌ها آزمایش شده‌اند و کارکرد آن‌ها با هر سه روش انتقال تأیید شده است. هنگامی که رمزنگاری درخواست شود، از ماژول Net::SSLeay برای انجام آن استفاده می‌شود. اگر این ماژول قابل بارگذاری نباشد، Swaks بسته به اینکه درخواست اختیاری بوده یا خیر، درخواست TLS را نادیده می‌گیرد یا با خطا متوقف می‌شود. قابلیت STARTTLS به‌عنوان یک افزونه در پروتکل ESMTP تعریف شده است و اگر \f(CW\*(C`\-\-protocol\*(C'\fR روی یکی از انواع SMTP ساده تنظیم شده باشد، در دسترس نخواهد بود. از آنجا که این قابلیت در خود پروتکل تعریف نشده است، در صورت پشتیبانی مقصد، \f(CW\*(C`\-\-tls\-on\-connect\*(C'\fR برای هر نوع پروتکلی در دسترس است.
.PP
برای مذاکره یک اتصال TLS، نیازی به گواهی محلی نیست. با این حال، برخی از سرورها از بررسی گواهی کلاینت استفاده می‌کنند تا تأیید کنند کلاینت اجازه اتصال دارد. می‌توان با استفاده از گزینه‌های \f(CW\*(C`\-\-tls\-cert\*(C'\fR و \f(CW\*(C`\-\-tls\-key\*(C'\fR به Swaks گفت که از یک گواهی محلی مشخص استفاده کند، و اختیاری است که با گزینه \f(CW\*(C`\-\-tls\-chain\*(C'\fR از یک زنجیره گواهی استفاده نماید.
.IP \-tls 4
.IX Item "-tls"
اتصال را ملزم به استفاده از STARTTLS می‌کند. اگر TLS به هر دلیلی در دسترس نباشد (اعلام نشده باشد، مذاکره با شکست مواجه شود و غیره) برنامه خارج می‌شود. (بدون آرگومان)
.IP "\-tlso, \-\-tls\-optional" 4
.IX Item "-tlso, --tls-optional"
در صورت در دسترس بودن، برای استفاده از STARTTLS تلاش می‌کند؛ اگر مذاکره TLS به هر دلیلی ناموفق باشد، تراکنش عادی ادامه می‌یابد. توجه داشته باشید که این گزینه با پیاده‌سازی فعلی تقریباً بی‌استفاده است، زیرا پس از شکست در مذاکره، وضعیت اتصال نامشخص خواهد بود. در برخی موارد، مانند عدم تطابق نسخه، اتصال باید به‌صورت متن ساده باقی بماند. در موارد دیگر، مانند شکست در اعتبارسنجی، سمت سرور ممکن است تصور کند باید به تبادل از طریق TLS ادامه دهد، در حالی که کلاینت فکر می‌کند ارتباط به‌صورت متن ساده است. شاید در آینده تلاشی برای افزودن تشخیص دقیق‌تر وضعیت انجام شود، اما در حال حاضر فقط آگاه باشید که در صورت تلاش برای مذاکره TLS و شکست آن، با این گزینه ممکن است رفتارهای غیرمنتظره‌ای رخ دهد. (بدون آرگومان)
.IP "\-tlsos, \-\-tls\-optional\-strict" 4
.IX Item "-tlsos, --tls-optional-strict"
در صورت در دسترس بودن، برای استفاده از STARTTLS تلاش می‌کند. اگر TLS با موفقیت مذاکره شود یا STARTTLS اعلام نشده باشد، تراکنش ادامه می‌یابد. اگر STARTTLS اعلام شده باشد اما مذاکرات TLS شکست بخورد، این وضعیت به‌عنوان یک خطا تلقی شده و تراکنش متوقف می‌شود. با توجه به هشداری که در بالا ذکر شد، این گزینه بسیار منطقی‌تر از \f(CW\*(C`\-\-tls\-optional\*(C'\fR است. (بدون آرگومان)
.IP "\-tlsc, \-\-tls\-on\-connect" 4
.IX Item "-tlsc, --tls-on-connect"
بلافاصله پس از برقراری اتصال، یک ارتباط TLS را آغاز می‌کند. طبق عرف معمول، در صورت تعیین این گزینه، پورت پیش‌فرض از ۲۵ به ۴۶۵ تغییر می‌یابد، هرچند که همچنان می‌توان آن را با گزینه \-\-port لغو کرد. (بدون آرگومان)
.IP "\-tlsp, \-\-tls\-protocol <tls\-version\-specification>" 4
.IX Item "-tlsp, --tls-protocol <tls-version-specification>"
پروتکل‌هایی را که باید هنگام مذاکره TLS استفاده شوند (یا نشوند) مشخص می‌کند. در زمان نگارش این متن، پروتکل‌های موجود عبارتند از sslv2، sslv3، tlsv1، tlsv1_1، tlsv1_2 و tlsv1_3. در دسترس بودن این پروتکل‌ها به کتابخانه OpenSSL زیربنایی شما بستگی دارد، بنابراین ممکن است همه آن‌ها در دسترس نباشند. فهرست پروتکل‌های در دسترس در خروجی \f(CW\*(C`\-\-dump\*(C'\fR نمایش داده می‌شود (به شرطی که TLS اصلاً در دسترس باشد).
.Sp
رشته مشخص‌کننده، فهرستی از پروتکل‌ها است که با کاما از هم جدا شده‌اند و می‌توان از آن‌ها استفاده کرد یا نکرد. برای نمونه، \(aqtlsv1,tlsv1_1\(aq تنها در صورتی موفق خواهد شد که یکی از این دو پروتکل هم در کلاینت و هم در سرور موجود باشد. در مقابل، \(aqno_sslv2,no_sslv3\(aq تلاش می‌کند هر پروتکلی به جز sslv2 و sslv3 را مذاکره کند. این دو قالب تعیین پروتکل را نمی‌توان با یکدیگر ترکیب کرد. (آرگومان الزامی)
.IP "\-\-tls\-cipher <cipher\-string>" 4
.IX Item "--tls-cipher <cipher-string>"
آرگومان این گزینه به کتابخانه OpenSSL زیربنایی ارسال می‌شود تا فهرست رمزهای (ciphers) قابل قبول برای استفاده در اتصال تنظیم شود. ساختار این رشته برای Swaks مات و غیرمستقیم است و در <https://www.openssl.org/docs/manmaster/man1/openssl\-ciphers.html#CIPHER\-LIST\-FORMAT> تعریف شده است. یک مثال کوتاه می‌تواند \f(CW\*(C`\-\-tls\-cipher \*(Aq3DES:+RSA\*(Aq\*(C'\fR باشد. (آرگومان الزامی)
.IP \-\-tls\-verify 4
.IX Item "--tls-verify"
به Swaks دستور می‌دهد تا برای اعتبارسنجی گواهی سرور تلاش کند. این گزینه معادل با تعیین هم‌زمان هر دو گزینه \f(CW\*(C`\-\-tls\-verify\-ca\*(C'\fR و \f(CW\*(C`\-\-tls\-verify\-host\*(C'\fR است. برای توضیحات دقیق درباره چگونگی تنظیم دقیق هر نوع اعتبارسنجی، آن گزینه‌ها را ببینید.
.Sp
به‌طور پیش‌فرض، اعتبارسنجی TLS الزامی نیست. اگر اعتبارسنجی TLS توسط \f(CW\*(C`\-\-tls\-verify\*(C'\fR، \f(CW\*(C`\-\-tls\-verify\-ca\*(C'\fR یا \f(CW\*(C`\-\-tls\-verify\-host\*(C'\fR الزامی شده باشد و نوع اعتبارسنجی درخواست‌شده با شکست مواجه شود، مذاکره TLS موفق نخواهد بود. (بدون آرگومان)
.IP \-\-tls\-verify\-ca 4
.IX Item "--tls-verify-ca"
الزام می‌کند که گواهی سرور توسط یک مرجع صدور گواهی (CA) شناخته‌شده امضا شده باشد و منقضی نشده باشد. به‌طور پیش‌فرض فهرست CAهای شناخته‌شده همان چیزی خواهد بود که از طریق کلاینتی که Swaks روی آن اجرا می‌شود در دسترس است. برای ارائه یک CA سفارشی، \f(CW\*(C`\-\-tls\-ca\-path\*(C'\fR را ببینید. (بدون آرگومان)
.IP \-\-tls\-verify\-host 4
.IX Item "--tls-verify-host"
الزام می‌کند که مقصد اتصال فعلی در نام جایگزین موضوع (SAN) یا نام عمومی موضوع (CN) در گواهی سرور ذکر شده باشد.
.Sp
مقصدی که Swaks برای اعتبارسنجی استفاده می‌کند متغیر خواهد بود. این مقصد می‌تواند یک نام میزبان باشد، که یا مستقیماً از طریق گزینه \f(CW\*(C`\-\-server\*(C'\fR مشخص شده یا از طریق رکوردهای MX جستجو شده است. در این حالت، اعتبارسنجی طبق انتظار عمل می‌کند. اگر مقصد یک IP باشد، IP در گواهی جستجو می‌شود، که امکان‌پذیر است اما غیرمعمول است. اگر روش انتقال \f(CW\*(C`\-\-pipe\*(C'\fR یا \f(CW\*(C`\-\-socket\*(C'\fR باشد، مقصد معناداری برای اعتبارسنجی در گواهی وجود نخواهد داشت و اعتبارسنجی شکست خواهد خورد. در این شرایط بهتر است فقط از \f(CW\*(C`\-\-tls\-verify\-ca\*(C'\fR استفاده شود یا مقصدی که برای اعتبارسنجی استفاده می‌شود با گزینه \f(CW\*(C`\-\-tls\-verify\-target\*(C'\fR لغو شود. (بدون آرگومان)
.IP "\-\-tls\-verify\-target <verification\-string>" 4
.IX Item "--tls-verify-target <verification-string>"
در صورت تنظیم، آرگومان این گزینه به‌عنوان میزبانی که باید برای \f(CW\*(C`\-\-tls\-verify\-host\*(C'\fR اعتبارسنجی شود استفاده خواهد شد. این کار هنگام استفاده از \f(CW\*(C`\-\-tls\-verify\-host\*(C'\fR با روش‌های انتقال \f(CW\*(C`\-\-pipe\*(C'\fR یا \f(CW\*(C`\-\-socket\*(C'\fR ضروری است، چرا که این روش‌ها به‌طور پیش‌فرض مقصد قابل اعتبارسنجی ندارند. همچنین می‌تواند برای بازنویسی جستجوی پیش‌فرض مقصد هنگام استفاده از روش انتقال \f(CW\*(C`\-\-server\*(C'\fR به کار رود. برای نمونه، می‌توان از آن استفاده کرد تا بررسی شود آیا گواهی سروری که صریحاً از طریق IP به آن متصل شده‌اید، شامل نام مشخصی هست یا خیر. (آرگومان الزامی)
.IP "\-\-tls\-ca\-path <ca\-location>" 4
.IX Item "--tls-ca-path <ca-location>"
مکان متفاوتی را برای اطلاعات CA جهت اعتبارسنجی گواهی‌های سرور مشخص می‌کند. آرگومان می‌تواند به یک فایل یا پوشه اشاره کند. رفتار پیش‌فرض استفاده از اطلاعات پیش‌فرض کتابخانه OpenSSL زیربنایی است. (آرگومان الزامی)
.IP "\-\-tls\-cert <cert\-file>" 4
.IX Item "--tls-cert <cert-file>"
مسیری را به فایلی حاوی گواهی محلی مشخص می‌کند که در صورت مذاکره TLS، باید توسط Swaks استفاده شود. اگر نیاز به ارائه زنجیره گواهی باشد، می‌تواند از طریق این فایل یا از طریق یک فایل مجزا با \f(CW\*(C`\-\-tls\-chain\*(C'\fR ارائه شود. آرگومان مسیر فایل الزامی است. طبق پیاده‌سازی فعلی، گواهی موجود در فایل باید در قالب PEM باشد. اگر نیاز مبرمی به ASN1 دارید با نویسنده تماس بگیرید. اگر این گزینه تنظیم شده باشد، \f(CW\*(C`\-\-tls\-key\*(C'\fR نیز الزامی است. (آرگومان الزامی)
.IP "\-\-tls\-key <key\-file>" 4
.IX Item "--tls-key <key-file>"
مسیری را به فایلی حاوی کلید خصوصی محلی مشخص می‌کند که در صورت مذاکره TLS، باید توسط Swaks استفاده شود. آرگومان مسیر فایل الزامی است. طبق پیاده‌سازی فعلی، گواهی موجود در فایل باید در قالب PEM باشد. اگر نیاز مبرمی به ASN1 دارید با نویسنده تماس بگیرید. اگر این گزینه تنظیم شده باشد، \f(CW\*(C`\-\-tls\-cert\*(C'\fR نیز الزامی است. (آرگومان الزامی)
.IP "\-\-tls\-chain <chain\-file>" 4
.IX Item "--tls-chain <chain-file>"
مسیری را به فایلی حاوی زنجیره گواهی محلی مشخص می‌کند که در صورت مذاکره TLS، باید توسط Swaks استفاده شود. آرگومان مسیر فایل الزامی است. طبق پیاده‌سازی فعلی، گواهی موجود در فایل باید در قالب PEM باشد. اگر نیاز مبرمی به ASN1 دارید با نویسنده تماس بگیرید. اگر این گزینه تنظیم شده باشد، \f(CW\*(C`\-\-tls\-cert\*(C'\fR و \f(CW\*(C`\-\-tls\-key\*(C'\fR نیز الزامی هستند. (آرگومان الزامی)
.IP "\-\-tls\-get\-peer\-cert [<output\-file>]" 4
.IX Item "--tls-get-peer-cert [<output-file>]"
یک کپی از گواهی طرف مقابل در TLS دریافت می‌کند. اگر هیچ آرگومانی داده نشود، در \f(CW\*(C`STDOUT\*(C'\fR نمایش داده خواهد شد. اگر آرگومانی داده شود، به‌عنوان یک مسیر در سیستم‌فایل در نظر گرفته می‌شود که محل ذخیره گواهی را مشخص می‌کند. سپس گواهی ذخیره‌شده را می‌توان با ابزارهای استانداردی مانند دستور openssl بررسی کرد. اگر فایلی مشخص شود، محتویات آن بازنویسی خواهد شد. این گزینه همواره تنها یک گواهی را برمی‌گرداند. برای دریافت تمام گواهی‌های ارسال‌شده توسط سرور، \f(CW\*(C`\-\-tls\-get\-peer\-chain\*(C'\fR را ببینید. (آرگومان اختیاری)
.IP "\-\-tls\-get\-peer\-chain [<output\-file>]" 4
.IX Item "--tls-get-peer-chain [<output-file>]"
یک کپی از زنجیره گواهی TLS ارسال‌شده توسط سرور دریافت می‌کند. اگر هیچ آرگومانی داده نشود، در \f(CW\*(C`STDOUT\*(C'\fR نمایش داده خواهد شد. اگر آرگومانی داده شود، به‌عنوان یک مسیر در سیستم‌فایل در نظر گرفته می‌شود که محل ذخیره گواهی را مشخص می‌کند. سپس زنجیره ذخیره‌شده را می‌توان با ابزارهای استانداردی مانند دستور openssl بررسی کرد. اگر فایلی مشخص شود، محتویات آن بازنویسی خواهد شد. همچنین \f(CW\*(C`\-\-tls\-get\-peer\-cert\*(C'\fR را ببینید. (آرگومان اختیاری)
.IP "\-\-tls\-sni <sni\-string>" 4
.IX Item "--tls-sni <sni-string>"
فیلد Server Name Indication (SNI) را برای ارسال در هنگام برقراری اتصال TLS مشخص می‌کند. (آرگومان الزامی)
.SH "احراز هویت (AUTHENTICATION)"
.IX Header "AUTHENTICATION"
اگر به Swaks دستور داده شود، تلاش خواهد کرد تا در سرور ایمیل مقصد احراز هویت کند. این بخش به شرح انواع احراز هویت موجود، نیازمندی‌ها، گزینه‌ها و تعاملات آن‌ها و سایر نکات دقیق در استفاده از احراز هویت می‌پردازد. از آنجا که احراز هویت به‌عنوان یک افزونه در پروتکل ESMTP تعریف شده است، اگر \f(CW\*(C`\-\-protocol\*(C'\fR روی یکی از انواع SMTP تنظیم شده باشد، در دسترس نخواهد بود.
.PP
تمامی روش‌های احراز هویت نیازمند کدگذاری base64 هستند. اگر ماژول پرل MIME::Base64 قابل بارگذاری باشد، Swaks تلاش می‌کند از آن برای انجام این کدگذاری‌ها استفاده کند. اگر MIME::Base64 در دسترس نباشد، Swaks از توابع داخلی base64 خود استفاده خواهد کرد. این توابع کندتر از توابع MIME::Base64 هستند و کمتر بازبینی شده‌اند، هرچند به‌طور کامل آزمایش شده‌اند. استفاده از ماژول MIME::Base64 توصیه می‌شود.
.PP
اگر احراز هویت الزامی باشد (گزینه‌های زیر را برای زمان‌هایی که الزامی است یا نیست ببینید) و نیازمندی‌های نوع احراز هویتِ موجود برآورده نشود، Swaks یک خطا نمایش داده و خارج می‌شود. این وضعیت می‌تواند به دو شکل رخ دهد: اجبار Swaks به استفاده از یک نوع احراز هویت خاص که Swaks به دلیل فقدان نیازمندی‌ها قادر به استفاده از آن نیست، یا اجازه دادن به Swaks برای استفاده از هر نوع احراز هویت، اما سرور تنها انواعی را اعلام می‌کند که Swaks قادر به پشتیبانی از آن‌ها نیست. در حالت اول، Swaks در زمان پردازش گزینه‌ها با خطا متوقف می‌شود، زیرا از ابتدا می‌داند که قادر به احراز هویت نخواهد بود. در حالت دوم، Swaks در مرحله احراز هویت در تراکنش SMTP با خطا مواجه می‌شود، زیرا Swaks تا آن لحظه متوجه نخواهد شد که امکان احراز هویت وجود ندارد.
.PP
در ادامه انواع احراز هویت پشتیبانی‌شده به همراه نکات و نیازمندی‌های هر یک آورده شده است.
.PP
گزینه‌های زیر بر نحوه استفاده Swaks از احراز هویت تأثیر می‌گذارند. این گزینه‌ها همگی به یکدیگر وابسته‌اند. برای نمونه، تعیین \f(CW\*(C`\-\-auth\-user\*(C'\fR متضمن \f(CW\*(C`\-\-auth\*(C'\fR و \f(CW\*(C`\-\-auth\-password\*(C'\fR است. تعیین \f(CW\*(C`\-\-auth\-optional\*(C'\fR متضمن \f(CW\*(C`\-\-auth\-user\*(C'\fR و \f(CW\*(C`\-\-auth\-password\*(C'\fR است، و غیره.
.IP "\-a, \-\-auth [<auth\-type>[,<auth\-type>[,...]]]" 4
.IX Item "-a, --auth [<auth-type>[,<auth-type>[,...]]]"
Swaks را ملزم به احراز هویت می‌کند. اگر هیچ آرگومانی داده نشود، هر نوع احراز هویت پشتیبانی‌شده‌ای که توسط سرور اعلام شده باشد امتحان می‌شود تا زمانی که یکی موفق شود یا همه شکست بخورند. اگر یک یا چند نوع احراز هویت به‌عنوان آرگومان مشخص شده باشد، هر کدام که سرور نیز از آن پشتیبانی می‌کند به ترتیب امتحان می‌شود تا یکی موفق شود یا همه با شکست مواجه شوند. این گزینه Swaks را ملزم به احراز هویت می‌کند، بنابراین اگر نوع احراز هویت مشترکی یافت نشود یا اطلاعات کاربری موفق نباشند، Swaks یک خطا نمایش داده و خارج می‌شود. (آرگومان اختیاری)
.Sp
فهرست زیر انواع معتبر احراز هویت را مشخص می‌کند:
.RS 4
.IP "LOGIN, PLAIN" 4
.IX Item "LOGIN, PLAIN"
این انواع پایه‌ای احراز هویت به‌طور کامل پشتیبانی و آزمایش شده‌اند و هیچ نیازمندی اضافی ندارند.
.IP CRAM\-MD5 4
.IX Item "CRAM-MD5"
احراز هویت‌کننده CRAM\-MD5 به ماژول Digest::MD5 نیاز دارد. این روش کاملاً آزمایش شده و انتظار می‌رود با هر سروری که آن را پیاده‌سازی کرده است کار کند.
.IP DIGEST\-MD5 4
.IX Item "DIGEST-MD5"
احراز هویت‌کننده DIGEST\-MD5 (استاندارد RFC2831) به ماژول Authen::SASL نیاز دارد. نسخه 20100211.0 و نسخه‌های پیشین از Authen::DigestMD5 استفاده می‌کردند که خطاهایی در سطح پروتکل داشت و مانع کارکرد آن با برخی سرورها می‌شد. مدیریت DIGEST\-MD5 در Authen::SASL بسیار پایدارتر است.
.Sp
پیاده‌سازی DIGEST\-MD5 در Swaks نسبتاً ناپخته است. به‌عنوان مثال در حال حاضر تنها از نوع qop مقدار "auth" پشتیبانی می‌کند. اگر در زمینه DIGEST\-MD5 تجربه دارید و مایلید به Swaks در پشتیبانی بهتر از DIGEST\-MD5 کمک کنید، لطفاً با نویسنده تماس بگیرید.
.Sp
مقدار "realm" پروتکل DIGEST\-MD5 را می‌توان با استفاده از کلیدواژه "realm" در \f(CW\*(C`\-\-auth\-extra\*(C'\fR تنظیم کرد. اگر هیچ realm تعیین نشود، یک مقدار پیش‌فرض معقول استفاده خواهد شد.
.Sp
مقادیر "digest-uri" پروتکل DIGEST\-MD5 را می‌توان با استفاده از گزینه \f(CW\*(C`\-\-auth\-extra\*(C'\fR تنظیم کرد. برای نمونه، می‌توانید مقدار digest-uri-value با عنوان "lmtp/mail.example.com/example.com" را با گزینه \f(CW\*(C`\-\-auth\-extra dmd5\-serv\-type=lmtp,dmd5\-host=mail.example.com,dmd5\-serv\-name=example.com\*(C'\fR ایجاد کنید. رشته "digest-uri-value" و اجزای آن در RFC2831 تعریف شده‌اند. اگر هیچ‌یک از این مقادیر داده نشوند، مقادیر پیش‌فرض معقول به کار خواهند رفت.
.IP CRAM\-SHA1 4
.IX Item "CRAM-SHA1"
احراز هویت‌کننده CRAM\-SHA1 به ماژول Digest::SHA نیاز دارد. این نوع تنها در برابر یک پیاده‌سازی غیر استاندارد در یک سرور Exim آزمایش شده است و بنابراین ممکن است دارای برخی کاستی‌ها در پیاده‌سازی باشد.
.IP NTLM/SPA/MSN 4
.IX Item "NTLM/SPA/MSN"
این احراز هویت‌کننده‌ها به ماژول Authen::NTLM نیاز دارند. این نوع در برابر Exim، Communigate و Exchange 2007 آزمایش شده است.
.Sp
علاوه بر نام کاربری و گذرواژه استاندارد، این نوع احراز هویت می‌تواند یک "domain" را نیز تشخیص دهد. دامنه را می‌توان با استفاده از کلیدواژه "domain" در \f(CW\*(C`\-\-auth\-extra\*(C'\fR تنظیم کرد. توجه داشته باشید که این ویژگی هرگز با یک سرور ایمیل که DOMAIN را نادیده نگیرد آزمایش نشده است، بنابراین ممکن است به‌صورت نادرست پیاده‌سازی شده باشد.
.RE
.RS 4
.RE
.IP "\-ao, \-\-auth\-optional [<auth\-type>[,<auth\-type>[,...]]]" 4
.IX Item "-ao, --auth-optional [<auth-type>[,<auth-type>[,...]]]"
رفتار این گزینه دقیقاً مشابه \f(CW\*(C`\-\-auth\*(C'\fR است، با این تفاوت که به جای الزامی کردن احراز هویت، آن را درخواست می‌کند. اگر نوع احراز هویت مشترکی یافت نشود یا هیچ اعتبارسنجی‌ای موفق نباشد، Swaks به گونه‌ای پیش می‌رود که گویی احراز هویت درخواست نشده است. (آرگومان اختیاری)
.IP "\-aos, \-\-auth\-optional\-strict [<auth\-type>[,<auth\-type>[,...]]]" 4
.IX Item "-aos, --auth-optional-strict [<auth-type>[,<auth-type>[,...]]]"
این گزینه حد وسطی بین \f(CW\*(C`\-\-auth\*(C'\fR و \f(CW\*(C`\-\-auth\-optional\*(C'\fR است. اگر احراز هویت هرگز آغاز نشود (سرور احراز هویت را اعلام نکند یا هیچ نوع احراز هویت مشترکی یافت نشود)، مانند \f(CW\*(C`\-\-auth\-optional\*(C'\fR عمل کرده و تراکنش smtp ادامه می‌یابد. اگر احراز هویت آغاز شود اما شکست بخورد، مانند \f(CW\*(C`\-\-auth\*(C'\fR رفتار کرده و با خطا خارج می‌شود. (آرگومان اختیاری)
.IP "\-au, \-\-auth\-user [<username>]" 4
.IX Item "-au, --auth-user [<username>]"
نام کاربری مورد استفاده برای احراز هویت را تعیین می‌کند. اگر هیچ نام کاربری ارائه نشود، مشخص می‌کند که Swaks باید تلاش کند نام کاربری را از طریق \fI.netrc\fR بیابد (نیازمند ماژول Net::Netrc است). اگر نام کاربری داده نشود و در \fI.netrc\fR نیز یافت نشود، از کاربر خواسته می‌شود تا آن را وارد کند. رشته \f(CW\*(C`<>\*(C'\fR می‌تواند به معنای نام کاربری خالی وارد شود. (آرگومان الزامی، دریافت از اعلان)
.IP "\-ap, \-\-auth\-password [<password>]" 4
.IX Item "-ap, --auth-password [<password>]"
گذرواژه مورد استفاده برای احراز هویت را تعیین می‌کند. اگر گذرواژه‌ای ارائه نشود، مشخص می‌کند که Swaks باید تلاش کند گذرواژه را از طریق \fI.netrc\fR بیابد (نیازمند ماژول Net::Netrc است). اگر گذرواژه داده نشود و در \fI.netrc\fR نیز یافت نشود، از کاربر خواسته می‌شود تا آن را وارد کند. رشته \f(CW\*(C`<>\*(C'\fR می‌تواند به معنای گذرواژه خالی وارد شود. (آرگومان الزامی، دریافت از اعلان، حساس)
.IP "\-ae, \-\-auth\-extra <key\-value\-pair>[,<key\-value\-pair>[,...]]" 4
.IX Item "-ae, --auth-extra <key-value-pair>[,<key-value-pair>[,...]]"
برخی از انواع احراز هویت اجازه می‌دهند اطلاعات اضافی در فرایند احراز هویت گنجانده شود. به جای افزودن یک گزینه جدید برای هر بخش از هر احراز هویت‌کننده، گزینه \f(CW\*(C`\-\-auth\-extra\*(C'\fR امکان ارائه این اطلاعات را فراهم می‌کند. ساختار <key\-value\-pair> به‌صورت KEYWORD=VALUE است. (آرگومان الزامی)
.Sp
فهرست زیر کلیدواژه‌های شناخته‌شده فعلی و احراز هویت‌کننده‌هایی که از آن‌ها استفاده می‌کنند را نشان می‌دهد:
.RS 4
.IP "realm, domain" 4
.IX Item "realm, domain"
کلیدواژه‌های realm و domain مترادف هستند. استفاده از هر یک، گزینه "domain" را در NTLM/MSN/SPA و گزینه "realm" را در DIGEST\-MD5 تنظیم می‌کند.
.IP dmd5\-serv\-type 4
.IX Item "dmd5-serv-type"
کلیدواژه dmd5\-serv\-type توسط احراز هویت‌کننده DIGEST\-MD5 استفاده می‌شود و تا حدی برای ساخت رشته digest-uri-value به کار می‌رود (RFC2831 را ببینید).
.IP dmd5\-host 4
.IX Item "dmd5-host"
کلیدواژه dmd5\-host توسط احراز هویت‌کننده DIGEST\-MD5 استفاده می‌شود و تا حدی برای ساخت رشته digest-uri-value به کار می‌رود (RFC2831 را ببینید).
.IP dmd5\-serv\-name 4
.IX Item "dmd5-serv-name"
کلیدواژه dmd5\-serv\-name توسط احراز هویت‌کننده DIGEST\-MD5 استفاده می‌شود و تا حدی برای ساخت رشته digest-uri-value به کار می‌رود (RFC2831 را ببینید).
.RE
.RS 4
.RE
.IP "\-am, \-\-auth\-map <key\-value\-pair>[,<key\-value\-pair>[,...]]" 4
.IX Item "-am, --auth-map <key-value-pair>[,<key-value-pair>[,...]]"
روشی را برای نگاشت نام‌های جایگزین بر روی انواع اصلی احراز هویت فراهم می‌کند. برای پایگاه‌هایی که از نام‌های جایگزین برای انواع متداول استفاده می‌کنند کاربرد دارد. ساختار <key\-value\-pair> به‌صورت AUTH\-ALIAS=AUTH\-TYPE است. این قابلیت در واقع در درون برنامه برای نگاشت انواع SPA و MSN به نوع پایه NTLM استفاده می‌شود. آرگومان خط فرمان برای شبیه‌سازی این رفتار \f(CW\*(C`\-\-auth\-map SPA=NTLM,MSN=NTLM\*(C'\fR خواهد بود. تمام انواع احراز هویت فهرست‌شده در بالا به جز SPA و MSN مقصدهای معتبری برای نگاشت هستند. (آرگومان الزامی)
.IP "\-apt, \-\-auth\-plaintext" 4
.IX Item "-apt, --auth-plaintext"
به جای نمایش رشته‌های AUTH به‌صورت کدگذاری‌شده با base64 در هنگام ارسال، آن‌ها را پیش از چاپ بر روی صفحه به متن آشکار ترجمه می‌کند. (بدون آرگومان)
.IP "\-ahp, \-\-auth\-hide\-password [<replacement\-string>]" 4
.IX Item "-ahp, --auth-hide-password [<replacement-string>]"
اگر این گزینه مشخص شود، هر زمان که قرار باشد یک گذرواژه خوانا در ترمینال چاپ شود (به‌ویژه AUTH PLAIN و AUTH LOGIN)، گذرواژه با رشته \(aqPROVIDED_BUT_REMOVED\(aq (یا محتوای <replacement\-string> در صورت ارائه) جایگزین می‌شود. بسته به گزینه \f(CW\*(C`\-\-auth\-plaintext\*(C'\fR، رشته جایگزین ممکن است با base64 کدگذاری شود یا نشود.
.Sp
توجه داشته باشید که \f(CW\*(C`\-\-auth\-hide\-password\*(C'\fR مشابه گزینه \f(CW\*(C`\-\-protect\-prompt\*(C'\fR است، اما دقیقاً یکسان نیست. گزینه اول بدون در نظر گرفتن نحوه ورود گذرواژه‌ها، از نمایش آن‌ها در تراکنش SMTP جلوگیری می‌کند. گزینه دوم، رشته‌های حساس را هنگام تایپ توسط کاربر در ترمینال، صرف نظر از نحوه استفاده از رشته، پنهان می‌کند. (آرگومان اختیاری).SH "گزینه‌های XCLIENT (XCLIENT OPTIONS)"
.IX Header "XCLIENT OPTIONS"
دستور XCLIENT یک افزونهٔ SMTP است که توسط پروژهٔ Postfix معرفی شده است. XCLIENT به یک کلاینت (دارای مجوزهای لازم) اجازه می‌دهد تا به سرور بگوید از اطلاعات جایگزین، مانند آدرس IP یا نام میزبان (hostname)، برای آن کلاینت استفاده کند. این قابلیت مسیرهای بسیار ساده‌تری را برای آزمودن پیکربندی‌های کارساز ایمیل فراهم می‌کند. جزئیات کامل این پروتکل در <http://www.postfix.org/XCLIENT_README.html> موجود است.
.PP
دستور XCLIENT را می‌توان چندین بار در هر نشست SMTP با مشخصه‌های متفاوتی به سرور ارسال کرد. به عنوان مثال، HELO و PROTO ممکن است در یک فراخوانی ارسال شوند و NAME و ADDR در فراخوانی دوم ارسال گردند. از آنجا که این موضوع می‌تواند برای آزمایش مفید باشد، Swaks کنترل‌هایی را بر نحوهٔ گروه‌بندی مشخصه‌ها و ترتیب ارسال آن‌ها به سرور فراهم می‌آورد. گزینه‌های مختلف تلاش می‌کنند سادگی را برای کسانی که از Swaks به عنوان یک کلاینت استفاده می‌کنند، و پیچیدگی را برای کسانی که از Swaks برای سنجش نصب‌ها بهره می‌برند، فراهم کنند.
.IP "\-\-xclient\-addr [<string>]" 4
.IX Item "--xclient-addr [<string>]"
.PD 0
.IP "\-\-xclient\-name [<string>]" 4
.IX Item "--xclient-name [<string>]"
.IP "\-\-xclient\-port [<string>]" 4
.IX Item "--xclient-port [<string>]"
.IP "\-\-xclient\-proto [<string>]" 4
.IX Item "--xclient-proto [<string>]"
.IP "\-\-xclient\-destaddr [<string>]" 4
.IX Item "--xclient-destaddr [<string>]"
.IP "\-\-xclient\-destport [<string>]" 4
.IX Item "--xclient-destport [<string>]"
.IP "\-\-xclient\-helo [<string>]" 4
.IX Item "--xclient-helo [<string>]"
.IP "\-\-xclient\-login [<string>]" 4
.IX Item "--xclient-login [<string>]"
.IP "\-\-xclient\-reverse\-name [<string>]" 4
.IX Item "--xclient-reverse-name [<string>]"
.PD
این گزینه‌ها مشخصه‌های XCLIENT را که باید به سرور هدف ارسال شوند، تعیین می‌کنند. اگر <string> ارائه نشود، Swaks اعلان داده و مقدار را از \f(CW\*(C`STDIN\*(C'\fR می‌خواند. برای مستندات رسمی در مورد معنای این مشخصه‌ها و مقادیر مجاز آن‌ها، از جمله مقادیر خاص «[UNAVAILABLE]» و «[TEMPUNAVAIL]»، به <http://www.postfix.org/XCLIENT_README.html> مراجعه کنید.
.Sp
به عنوان یک مثال ساده، تنظیم \f(CW\*(C`\-\-xclient\-name foo.example.com \-\-xclient\-addr 192.168.1.1\*(C'\fR سبب می‌شود Swaks دستور SMTP معادل \f(CW\*(C`XCLIENT NAME=foo.example.com ADDR=192.168.1.1\*(C'\fR را ارسال کند.
.Sp
توجه داشته باشید که مشخصهٔ «REVERSE_NAME» ظاهراً در مستندات رسمی ذکر نشده است. یک بحث در فهرست پستی وجود دارد که آن را مستند کرده و در نشانی <http://comments.gmane.org/gmane.mail.postfix.user/192623> قابل مشاهده است.
.Sp
همهٔ این گزینه‌ها می‌توانند با یکدیگر ترکیب شوند، و همچنین می‌توان آن‌ها را با گزینهٔ \f(CW\*(C`\-\-xclient\*(C'\fR ترکیب کرد (پایین‌تر را ببینید). به‌طور پیش‌فرض تمام مشخصه‌ها در یک فراخوانی XCLIENT ترکیب می‌شوند، اما \f(CW\*(C`\-\-xclient\-delim\*(C'\fR را نیز بررسی کنید. (Arg-Required, From-Prompt)
.IP \-\-xclient\-delim 4
.IX Item "--xclient-delim"
هنگامی که این گزینه مشخص می‌شود، نشان‌دهندهٔ یک تفکیک و شکست در مشخصه‌های ارسالی XCLIENT است. برای نمونه، تنظیم \f(CW\*(C`\-\-xclient\-helo \*(Aqhelo string\*(Aq \-\-xclient\-delim \-\-xclient\-name foo.example.com \-\-xclient\-addr 192.168.1.1\*(C'\fR سبب می‌شود Swaks دو فراخوانی XCLIENT ارسال کند: \f(CW\*(C`XCLIENT HELO=helo+20string\*(C'\fR و \f(CW\*(C`XCLIENT NAME=foo.example.com ADDR=192.168.1.1\*(C'\fR. این گزینه در جاهایی که معنایی ندارد (در ابتدا یا انتهای گزینه‌های XCLIENT، به تنهایی، پشت سر هم، و غیره) نادیده گرفته می‌شود. (Arg-None)
.IP "\-\-xclient [<string>]" 4
.IX Item "--xclient [<string>]"
این گزینهٔ «فرم آزاد» (free form) برای XCLIENT است. هر مقداری که برای <string> ارائه شود عیناً به عنوان آرگومان به دستور SMTP بنام XCLIENT ارسال خواهد شد. به عنوان مثال، اگر از \f(CW\*(C`\-\-xclient \*(AqNAME= ADDR=192.168.1.1 FOO=bar\*(Aq\*(C'\fR استفاده شود، Swaks دستور SMTP معادل \f(CW\*(C`XCLIENT NAME= ADDR=192.168.1.1 FOO=bar\*(C'\fR را ارسال می‌کند. اگر هیچ آرگومانی در خط فرمان داده نشود، Swaks اعلان داده و مقدار را از STDIN می‌خواند.
.Sp
مزیت اصلی این گزینه نسبت به گزینه‌های اختصاصی‌ترِ بالا این است که در اینجا هیچ اعتبارسنجی نحوی برای XCLIENT صورت نمی‌گیرد. این ویژگی به شما اجازه می‌دهد تا برای آزمایش، دستورهای نامعتبر XCLIENT را به سرور هدف بفرستید. علاوه بر این، حداقل یک MTA (نرم‌افزار Momentum متعلق به Message Systems، که سابقاً ecelerity نام داشت) دستور XCLIENT را بدون اعلان مشخصه‌های پشتیبانی‌شده پیاده‌سازی می‌کند. گزینهٔ \f(CW\*(C`\-\-xclient\*(C'\fR به شما اجازه می‌دهد هنگام ارتباط با این نوع MTA، از بررسی «مشخصه‌های پشتیبانی‌شده» صرف‌نظر کنید (اگرچه \f(CW\*(C`\-\-xclient\-no\-verify\*(C'\fR را نیز ببینید).
.Sp
گزینهٔ \f(CW\*(C`\-\-xclient\*(C'\fR می‌تواند به‌صورت آزادانه با گزینه‌های \f(CW\*(C`\-\-xclient\-*\*(C'\fR که در بالا ذکر شدند ترکیب شود. آرگومان داده‌شده به \f(CW\*(C`\-\-xclient\*(C'\fR در گروه دستوری اختصاصی خود ارسال خواهد شد. برای نمونه، اگر \f(CW\*(C`\-\-xclient\-addr 192.168.0.1 \-\-xclient\-port 26 \-\-xclient \*(AqFOO=bar NAME=wind\*(Aq\*(C'\fR به Swaks داده شود، هر دو دستور \f(CW\*(C`XCLIENT ADDR=192.168.0.1 PORT=26\*(C'\fR و \f(CW\*(C`XCLIENT FOO=bar NAME=wind\*(C'\fR به سرور هدف ارسال خواهند شد. (Arg-Required, From-Prompt)
.IP \-\-xclient\-no\-verify 4
.IX Item "--xclient-no-verify"
الزام اینکه یک مشخصهٔ XCLIENT حتماً باید توسط سرور اعلان شده باشد تا Swaks بتواند آن را در یک دستور XCLIENT ارسال کند، اعمال نشود. این گزینه برای پشتیبانی از سرورهایی است که مشخصه‌ها را اعلان نمی‌کنند اما همچنان از آن‌ها پشتیبانی می‌نمایند. (Arg-None)
.IP \-\-xclient\-before\-starttls 4
.IX Item "--xclient-before-starttls"
اگر Swaks به گونه‌ای پیکربندی شده باشد که هم برای XCLIENT و هم STARTTLS اقدام کند، ابتدا STARTTLS را انجام می‌دهد. اگر این گزینه مشخص شود، ابتدا XCLIENT را امتحان خواهد کرد. (Arg-None)
.IP \-\-xclient\-optional 4
.IX Item "--xclient-optional"
.PD 0
.IP \-\-xclient\-optional\-strict 4
.IX Item "--xclient-optional-strict"
.PD
در حالت عادی، تنظیم یکی از گزینه‌های \f(CW\*(C`\-\-xclient*\*(C'\fR برای ادامهٔ کار نیازمند انجام موفقیت‌آمیز یک تراکنش XCLIENT است (یعنی XCLIENT باید اعلان شده باشد، تمام مشخصه‌های درخواستی کاربر باید اعلان شده باشند، و سرور باید درخواست XCLIENT از سوی Swaks را پذیرفته باشد). این گزینه‌ها این رفتار را تغییر می‌دهند. گزینهٔ \f(CW\*(C`\-\-xclient\-optional\*(C'\fR به Swaks می‌گوید بدون هیچ قید و شرطی از مرحلهٔ XCLIENT در تراکنش SMTP عبور کند، صرف‌نظر از اینکه موفقیت‌آمیز بوده است یا خیر. گزینهٔ \f(CW\*(C`\-\-xclient\-optional\-strict\*(C'\fR مشابه است اما با جزئیات دقیق‌تری عمل می‌کند. این نسخهٔ سخت‌گیرانه چنانچه XCLIENT اعلان نشده باشد ادامه می‌دهد، اما اگر اجرای XCLIENT تلاش شود ولی به موفقیت نرسد، با شکست متوقف می‌شود. (Arg-None)
.SH "گزینه‌های PROXY (PROXY OPTIONS)"
.IX Header "PROXY OPTIONS"
نرم‌افزار Swaks پروتکل Proxy را مطابق با تعریف ارائه‌شده در <http://www.haproxy.org/download/1.5/doc/proxy\-protocol.txt> پیاده‌سازی می‌کند. پروتکل Proxy امکان استفاده از یک متعادل‌کنندهٔ بار (load balancer) برنامه‌های کاربردی مانند HAProxy را در جلوی یک MTA فراهم می‌سازد، در حالی که به MTA اجازه می‌دهد همچنان به اطلاعات میزبان مبدأ دسترسی داشته باشد. پشتیبانی از Proxy در Swaks امکان آزمایش مستقیم یک MTA را که برای دریافت درخواست‌ها از یک پراکسی پیکربندی شده است، بدون نیاز به خود پراکسی در طول آزمایش، فراهم می‌کند.
.PP
نرم‌افزار Swaks هیچ تلاشی برای تضمین سازگاری درونی گزینه‌های Proxy مورد استفاده انجام نمی‌دهد. برای نمونه، انتظار می‌رود که \f(CW\*(C`\-\-proxy\-family\*(C'\fR (در نسخهٔ ۱) یکی از مقادیر «TCP4» یا «TCP6» باشد. هرچند به احتمال زیاد برای سرور مقصد نامفهوم خواهد بود، اما Swaks هیچ تلاشی نمی‌کند تا اطمینان حاصل کند که \f(CW\*(C`\-\-proxy\-source\*(C'\fR و \f(CW\*(C`\-\-proxy\-dest\*(C'\fR با \f(CW\*(C`\-\-proxy\-family\*(C'\fR یا با یکدیگر در یک خانوادهٔ پروتکل قرار دارند.
.PP
گزینهٔ \f(CW\*(C`\-\-proxy\*(C'\fR با تمام گزینه‌های دیگر \f(CW\*(C`\-\-proxy\-*\*(C'\fR به جز \f(CW\*(C`\-\-proxy\-version\*(C'\fR ناسازگار و مانعة‌الجمع است.
.PP
هنگامی که \f(CW\*(C`\-\-proxy\*(C'\fR استفاده نشود، تمام گزینه‌های \f(CW\*(C`\-\-proxy\-family\*(C'\fR، \f(CW\*(C`\-\-proxy\-source\*(C'\fR، \f(CW\*(C`\-\-proxy\-source\-port\*(C'\fR، \f(CW\*(C`\-\-proxy\-dest\*(C'\fR و \f(CW\*(C`\-\-proxy\-dest\-port\*(C'\fR الزامی هستند. علاوه بر این، هنگامی که \f(CW\*(C`\-\-proxy\-version\*(C'\fR برابر با ۲ باشد، گزینه‌های \f(CW\*(C`\-\-proxy\-protocol\*(C'\fR و \f(CW\*(C`\-\-proxy\-command\*(C'\fR اختیاری خواهند بود.
.IP "\-\-proxy\-version [ 1 | 2 ]" 4
.IX Item "--proxy-version [ 1 | 2 ]"
تعیین می‌کند که از نسخهٔ ۱ (خوانا برای انسان) یا نسخهٔ ۲ (باینری) پروتکل Proxy استفاده شود. نسخهٔ ۱ مقدار پیش‌فرض است. نسخهٔ ۲ تنها از طریق «بلوک آدرس» پیاده‌سازی شده و تقریباً هم‌سطح اطلاعات ارائه‌شده در نسخهٔ ۱ است. (Arg-Required, From-Prompt)
.IP "\-\-proxy [<string>]" 4
.IX Item "--proxy [<string>]"
این گزینه رشتهٔ خام پروتکل پراکسی را که به سرور ارسال می‌شود فراهم می‌کند. پیشوند پروتکل (برای نسخهٔ ۱ عبارت «PROXY » و برای نسخهٔ ۲ سرآیند ۱۲ بایتی پروتکل) می‌تواند در آرگومان موجود باشد یا نباشد. این گزینه امکان ارسال رشته‌های ناقص یا نادرست (malformed) پروتکل Proxy را به سرور هدف جهت آزمایش فراهم می‌کند. این گزینه با تمام گزینه‌های دیگر \f(CW\*(C`\-\-proxy\-*\*(C'\fR که اطلاعات جزئی پراکسی را ارائه می‌دهند مانعة‌الجمع است.
.Sp
از آنجا که نسخهٔ ۲ پروتکل Proxy یک پروتکل باینری است، راه‌های متعددی برای ارائهٔ آرگومان به این گزینه وجود دارد. اگر آرگومان با «base64:» شروع شود، این پیشوند حذف شده و بقیهٔ رشته پیش از استفاده به‌صورت base64 رمزگشایی می‌شود. اگر آرگومان با \f(CW\*(C`@\*(C'\fR شروع شود، به عنوان نام فایل تلقی شده و مقدار پراکسی از آن فایل خوانده می‌شود. هر مقدار دیگری به عنوان مقدار مستقیم (literal) برای رشتهٔ پراکسی در نظر گرفته خواهد شد. (Arg-Required, From-Prompt, From-File)
.IP "\-\-proxy\-family [<string>]" 4
.IX Item "--proxy-family [<string>]"
برای نسخهٔ ۱، هم خانوادهٔ آدرس و هم پروتکل انتقال را مشخص می‌کند. این پروتکل مقادیر TCP4 و TCP6 را تعریف می‌کند.
.Sp
برای نسخهٔ ۲، تنها خانوادهٔ آدرس را مشخص می‌کند. این پروتکل مقادیر AF_UNSPEC، AF_INET، AF_INET6 و AF_UNIX را تعریف می‌کند. (Arg-Required, From-Prompt)
.IP "\-\-proxy\-protocol [<string>]" 4
.IX Item "--proxy-protocol [<string>]"
برای نسخهٔ ۲، پروتکل انتقال را مشخص می‌کند. پروتکل مقادیر UNSPEC، STREAM و DGRAM را تعریف می‌کند. مقدار پیش‌فرض STREAM است. این گزینه در نسخهٔ ۱ استفاده نمی‌شود. (Arg-Required, From-Prompt)
.IP "\-\-proxy\-command [<string>]" 4
.IX Item "--proxy-command [<string>]"
برای نسخهٔ ۲، پروتکل انتقال/دستور را مشخص می‌کند. این پروتکل مقادیر LOCAL و PROXY را تعریف کرده است. مقدار پیش‌فرض PROXY است. این گزینه در نسخهٔ ۱ استفاده نمی‌شود. (Arg-Required, From-Prompt)
.IP "\-\-proxy\-source [<string>]" 4
.IX Item "--proxy-source [<string>]"
آدرس مبدأ اتصال پراکسی‌شده را تعیین می‌کند. (Arg-Required, From-Prompt)
.IP "\-\-proxy\-source\-port [<string>]" 4
.IX Item "--proxy-source-port [<string>]"
درگاه (پورت) مبدأ اتصال پراکسی‌شده را تعیین می‌کند. (Arg-Required, From-Prompt)
.IP "\-\-proxy\-dest [<string>]" 4
.IX Item "--proxy-dest [<string>]"
آدرس مقصد اتصال پراکسی‌شده را تعیین می‌کند. (Arg-Required, From-Prompt)
.IP "\-\-proxy\-dest\-port [<string>]" 4
.IX Item "--proxy-dest-port [<string>]"
درگاه (پورت) مقصد اتصال پراکسی‌شده را تعیین می‌کند. (Arg-Required, From-Prompt)
.SH "گزینه‌های DATA (DATA OPTIONS)"
.IX Header "DATA OPTIONS"
این گزینه‌ها به محتوای بخش DATA در تراکنش SMTP مربوط می‌شوند. به‌طور پیش‌فرض یک پیام بسیار ساده ارسال می‌شود. اگر از گزینه‌های \f(CW\*(C`\-\-attach\*(C'\fR یا \f(CW\*(C`\-\-attach\-body\*(C'\fR استفاده شود، Swaks تلاش می‌کند پیام را به یک پیام MIME ارتقا دهد.
.IP "\-d, \-\-data [<data\-portion>]" 4
.IX Item "-d, --data [<data-portion>]"
استفاده از آرگومان به عنوان کل محتوای بخش DATA.
.Sp
اگر هیچ آرگومانی ارائه نشود، برای وارد کردن مقدار از کاربر اعلان خواسته می‌شود.
.Sp
اگر آرگومان \f(CW\*(C`\-\*(C'\fR ارائه شود، داده‌ها بدون اعلان از \f(CW\*(C`STDIN\*(C'\fR خوانده خواهند شد.
.Sp
اگر آرگومان با \f(CW\*(C`@\*(C'\fR آغاز شود، به عنوان نام فایل تلقی خواهد شد. اگر می‌خواهید آرگومانی ارسال کنید که با \f(CW\*(C`@\*(C'\fR آغاز می‌شود اما نام فایل نیست، یک \f(CW\*(C`@\*(C'\fR اضافی پیشوند آن کنید. برای نمونه، \f(CW\*(C`@file.txt\*(C'\fR باعث پردازش فایل \fIfile.txt\fR می‌شود. مقدار \f(CW@@data\fR از رشتهٔ «@data» استفاده خواهد کرد.
.Sp
اگر آرگومان فاقد هرگونه نویسهٔ خط جدید واقعی (0x0a) یا نمایشی (0x5c, 0x6e یا \f(CW%NEWLINE\fR%) باشد، به عنوان نام فایل تلقی می‌شود. اگر فایل بازشدنی باشد، محتوای فایل به عنوان بخش داده (data) استفاده خواهد شد. اگر فایل باز نشود، Swaks با خطا خارج می‌شود. کل رفتار شرح‌داده‌شده در این پاراگراف منسوخ شده (deprecated) است و در نگارش‌های آینده حذف خواهد شد. به جای آن، از یک \f(CW\*(C`@\*(C'\fR در ابتدا استفاده کنید تا صراحتاً نشان دهد که آرگومان نام فایل است.
.Sp
هر آرگومان دیگری به عنوان محتوای DATA استفاده خواهد شد.
.Sp
مقدار می‌تواند در یک خط قرار گیرد، که در آن \f(CW\*(C`\en\*(C'\fR (کدهای اسکی 0x5c, 0x6e) نشان‌دهندهٔ محل شکست خطوط است. نقطه‌های ابتدای سطرها نقل‌قول (quote) خواهند شد. نقطهٔ پایانی الزامی نیست اما مجاز است. مقدار پیش‌فرض این گزینه عبارت است از: \f(CW\*(C`Date: %DATE%\enTo: %TO_ADDRESS%\enFrom: %FROM_ADDRESS%\enSubject: test %DATE%\enMessage\-Id: <%MESSAGEID%>\enX\-Mailer: swaks v%SWAKS_VERSION% jetmore.org/john/code/swaks/\en%NEW_HEADERS%\en%BODY%\en\*(C'\fR.
.Sp
یک تجزیهٔ توکن بسیار ابتدایی روی بخش DATA انجام می‌گیرد. جدول زیر توکن‌های شناخته‌شده و مقادیر جایگزین آن‌ها را نشان می‌دهد. (Arg-Required, From-Prompt, From-File)
.RS 4
.ie n .IP "%FROM_ADDRESS%, ..FROM_ADDRESS.." 4
.el .IP "\f(CW%FROM_ADDRESS\fR%, ..FROM_ADDRESS.." 4
.IX Item "%FROM_ADDRESS%, ..FROM_ADDRESS.."
با فرستندهٔ پاکت نامه (envelope-sender) جایگزین می‌شود.
.ie n .IP "%TO_ADDRESS%, ..TO_ADDRESS.." 4
.el .IP "\f(CW%TO_ADDRESS\fR%, ..TO_ADDRESS.." 4
.IX Item "%TO_ADDRESS%, ..TO_ADDRESS.."
با گیرنده(های) پاکت نامه تنظیم‌شده توسط گزینهٔ \f(CW\*(C`\-\-to\*(C'\fR جایگزین می‌شود.
.ie n .IP "%CC_ADDRESS%, ..CC_ADDRESS.." 4
.el .IP "\f(CW%CC_ADDRESS\fR%, ..CC_ADDRESS.." 4
.IX Item "%CC_ADDRESS%, ..CC_ADDRESS.."
با گیرنده(های) پاکت نامه تنظیم‌شده توسط گزینهٔ \f(CW\*(C`\-\-cc\*(C'\fR جایگزین می‌شود.
.ie n .IP "%BCC_ADDRESS%, ..BCC_ADDRESS.." 4
.el .IP "\f(CW%BCC_ADDRESS\fR%, ..BCC_ADDRESS.." 4
.IX Item "%BCC_ADDRESS%, ..BCC_ADDRESS.."
با گیرنده(های) پاکت نامه تنظیم‌شده توسط گزینهٔ \f(CW\*(C`\-\-bcc\*(C'\fR جایگزین می‌شود.
.ie n .IP "%DATE%, ..DATE.." 4
.el .IP "\f(CW%DATE\fR%, ..DATE.." 4
.IX Item "%DATE%, ..DATE.."
با زمان جاری در قالبی مناسب جهت گنجاندن در سرآیند Date: جایگزین می‌شود. توجه داشته باشید که این گزینه تلاش می‌کند از ماژول استاندارد POSIX برای محاسبات منطقهٔ زمانی استفاده کند. اگر این ماژول در دسترس نباشد یا محیط فعلی از توکن قالب‌بندی \f(CW%z\fR در strftime پشتیبانی نکند (مانند ویندوز)، رشتهٔ تاریخ بر حسب GMT خواهد بود.
.ie n .IP "%MESSAGEID%, ..MESSAGEID.." 4
.el .IP "\f(CW%MESSAGEID\fR%, ..MESSAGEID.." 4
.IX Item "%MESSAGEID%, ..MESSAGEID.."
با یک رشتهٔ شناسهٔ پیام مناسب جهت استفاده در سرآیند Message-Id جایگزین می‌شود. مقدار این توکن در طول عمر فرایند ثابت خواهد ماند.
.ie n .IP "%SWAKS_VERSION%, ..SWAKS_VERSION.." 4
.el .IP "\f(CW%SWAKS_VERSION\fR%, ..SWAKS_VERSION.." 4
.IX Item "%SWAKS_VERSION%, ..SWAKS_VERSION.."
با نگارش فرایند جاری Swaks جایگزین می‌شود.
.ie n .IP "%NEW_HEADERS%, ..NEW_HEADERS.." 4
.el .IP "\f(CW%NEW_HEADERS\fR%, ..NEW_HEADERS.." 4
.IX Item "%NEW_HEADERS%, ..NEW_HEADERS.."
با محتوای گزینهٔ \f(CW\*(C`\-\-add\-header\*(C'\fR جایگزین می‌شود. اگر \f(CW\*(C`\-\-add\-header\*(C'\fR مشخص نشده باشد، این توکن صرفاً حذف می‌گردد.
.ie n .IP "%BODY%, ..BODY.." 4
.el .IP "\f(CW%BODY\fR%, ..BODY.." 4
.IX Item "%BODY%, ..BODY.."
با مقدار تعیین‌شده توسط گزینهٔ \f(CW\*(C`\-\-body\*(C'\fR جایگزین می‌شود. برای مقدار پیش‌فرض به \f(CW\*(C`\-\-body\*(C'\fR مراجعه کنید.
.ie n .IP "%NEWLINE%, ..BODY.." 4
.el .IP "\f(CW%NEWLINE\fR%, ..BODY.." 4
.IX Item "%NEWLINE%, ..BODY.."
با نویسه‌های بازگشت به اول خط و خط جدید (0x0d, 0x0a) جایگزین می‌شود. این توکن مشابه استفاده از \f(CW\*(C`\en\*(C'\fR (کدهای 0x5c, 0x6e) است، اما نگرانی‌های مربوط به گریز دادن (escaping) بک‌اسلش برای خط جدید را به همراه ندارد.
.RE
.RS 4
.RE
.IP "\-dab, \-\-dump\-as\-body [<section>[,<section>[,...]]]" 4
.IX Item "-dab, --dump-as-body [<section>[,<section>[,...]]]"
اگر از \f(CW\*(C`\-\-dump\-as\-body\*(C'\fR استفاده شود و هیچ گزینهٔ دیگری برای تغییر بدنهٔ پیش‌فرض پیام به کار نرفته باشد، بدنه با خروجی مشابه آنچه توسط \f(CW\*(C`\-\-dump\*(C'\fR ارائه می‌شود جایگزین خواهد شد. بند (stanza) اولیهٔ قابلیت‌های برنامه در \f(CW\*(C`\-\-dump\*(C'\fR نمایش داده نمی‌شود و بخش «data» نیز گنجانده نمی‌شود. علاوه بر این، \f(CW\*(C`\-\-dump\*(C'\fR همیشه شامل گذرواژه‌ها است؛ به‌طور پیش‌فرض \f(CW\*(C`\-\-dump\-as\-body\*(C'\fR شامل گذرواژه‌ها نمی‌شود، هرچند می‌توان این رفتار را با \f(CW\*(C`\-\-dump\-as\-body\-shows\-password\*(C'\fR تغییر داد. گزینهٔ \f(CW\*(C`\-\-dump\-as\-body\*(C'\fR همان آرگومان‌های \f(CW\*(C`\-\-dump\*(C'\fR را می‌پذیرد به جز اینکه آرگومان‌های SUPPORT و DATA پشتیبانی نمی‌شوند. (Arg-Optional)
.IP "\-dabsp, \-\-dump\-as\-body\-shows\-password" 4
.IX Item "-dabsp, --dump-as-body-shows-password"
باعث می‌شود \f(CW\*(C`\-\-dump\-as\-body\*(C'\fR گذرواژه‌ها را به‌صورت متن آشکار (plaintext) بگنجاند. استفاده از این گزینه توصیه نمی‌شود. این گزینه متضمن \f(CW\*(C`\-\-dump\-as\-body\*(C'\fR نیز هست. (Arg-None)
.IP "\-\-body [<body\-specification>]" 4
.IX Item "--body [<body-specification>]"
بدنهٔ ایمیل را مشخص می‌کند. مقدار پیش‌فرض «This is a test mailing» است. اگر هیچ آرگومانی به \f(CW\*(C`\-\-body\*(C'\fR داده نشود، اعلانی برای ارائهٔ تعاملی آن نمایش داده می‌شود. اگر \f(CW\*(C`\-\*(C'\fR ارائه شود، بدنه از ورودی استاندارد خوانده خواهد شد. آرگومان‌هایی که با \f(CW\*(C`@\*(C'\fR آغاز می‌شوند به عنوان نام فایل‌های حاوی داده‌های بدنه تلقی می‌گردند (برای جزئیات بیشتر به \f(CW\*(C`\-\-data\*(C'\fR مراجعه کنید).
.Sp
اگر پس از پردازش فوق، آرگومان نشان‌دهندهٔ فایلی بازشدنی باشد، محتوای آن فایل به عنوان بدنه استفاده خواهد شد. این رفتار منسوخ شده است و در نگارش‌های آینده حذف خواهد شد. به جای آن، از یک \f(CW\*(C`@\*(C'\fR در ابتدا استفاده کنید تا صراحتاً نشان دهد آرگومان نام فایل است.
.Sp
اگر پیام به قالب MIME اجبار شود (به \f(CW\*(C`\-\-attach\*(C'\fR مراجعه کنید)، دستور \f(CW\*(C`\-\-body \*(Aqbody text\*(Aq\*(C'\fR معادل \f(CW\*(C`\-\-attach\-type text/plain \-\-attach\-body \*(Aqbody text\*(Aq\*(C'\fR خواهد بود. برای جزئیات مربوط به ایجاد یک بدنهٔ چندبخشی جایگزین (multipart/alternative)، گزینهٔ \f(CW\*(C`\-\-attach\-body\*(C'\fR را ببینید. (Arg-Required, From-Prompt, From-File)
.IP "\-\-attach [<attachment\-specification>]" 4
.IX Item "--attach [<attachment-specification>]"
هنگامی که یک یا چند گزینهٔ \f(CW\*(C`\-\-attach\*(C'\fR ارائه شود، پیام به یک پیام MIME چندبخشی ترکیبی (multipart/mixed) تبدیل می‌گردد. آرگومان‌های \f(CW\*(C`\-\-attach\*(C'\fR در رابطه با \f(CW\*(C`STDIN\*(C'\fR، محتویات فایل و غیره همانند \f(CW\*(C`\-\-body\*(C'\fR پردازش می‌شوند. گزینهٔ \f(CW\*(C`\-\-attach\*(C'\fR را می‌توان چندین بار برای ایجاد چندین پیوست ارائه کرد. به‌طور پیش‌فرض، هر پیوست به عنوان یک فایل application/octet\-stream ضمیمه می‌شود. برای تغییر این رفتار به \f(CW\*(C`\-\-attach\-type\*(C'\fR مراجعه کنید.
.Sp
اگر محتویات پیوست از طریق نام فایل ارائه شود، کدگذاری MIME شامل آن نام فایل خواهد بود. برای جزئیات بیشتر در مورد نام‌گذاری فایل‌ها به \f(CW\*(C`\-\-attach\-name\*(C'\fR مراجعه نمایید.
.Sp
مشخص کردن \f(CW\*(C`\-\*(C'\fR (\f(CW\*(C`STDIN\*(C'\fR) به عنوان آرگومان برای چندین بار (یک‌بار برای \f(CW\*(C`\-\-body\*(C'\fR و چند بار برای \f(CW\*(C`\-\-attach\*(C'\fR) مجاز است. در این حالت، همان محتوا هر بار که مشخص شده پیوست خواهد شد. این کار برای پیوست کردن یک محتوای یکسان با چندین نوع MIME مختلف مفید است. (Arg-Required, From-File)
.IP "\-\-attach\-body [<body\-specification>]" 4
.IX Item "--attach-body [<body-specification>]"
این یک گونهٔ متفاوت از \f(CW\*(C`\-\-attach\*(C'\fR است که به‌طور خاص برای بخش بدنهٔ ایمیل در نظر گرفته شده است. این گزینه رفتاری همسان با \f(CW\*(C`\-\-attach\*(C'\fR دارد، چرا که همان آرگومان‌ها را می‌گیرد و ساخت پیام MIME را الزامی می‌کند. با این حال، تفاوت آن در این است که صرف‌نظر از ترتیب پردازش گزینه‌ها، آرگومان آن همواره اولین بخش MIME در پیام خواهد بود. علاوه بر این، گزینه‌های \f(CW\*(C`\-\-attach\-body\*(C'\fR روی هم انباشته می‌شوند تا امکان ایجاد بدنه‌های multipart/alternative را فراهم کنند. به عنوان مثال، عبارت \f(CW\*(C`\-\-attach\-type text/plain \-\-attach\-body \*(Aqplain text body\*(Aq \-\-attach\-type text/html \-\-attach\-body \*(Aqhtml body\*(Aq\*(C'\fR یک بدنهٔ پیام چندبخشی جایگزین ایجاد می‌کند. (Arg-Required, From-File)
.IP "\-\-attach\-type <mime\-type>" 4
.IX Item "--attach-type <mime-type>"
به‌طور پیش‌فرض، محتوایی که با گزینهٔ \f(CW\*(C`\-\-attach\*(C'\fR به‌صورت MIME به پیام اضافه می‌شود، به عنوان application/octet\-stream کدگذاری می‌گردد (به جز بدنه، که به‌طور پیش‌فرض text/plain است). گزینهٔ \f(CW\*(C`\-\-attach\-type\*(C'\fR نوع MIME را برای تمام گزینه‌های \f(CW\*(C`\-\-attach\*(C'\fR پس از خود تغییر می‌دهد. این گزینه می‌تواند چندین بار مشخص شود. نوع MIME جاری در فاصلهٔ بین پردازش بخش‌های بدنه و سایر بخش‌ها، مجدداً به application/octet\-stream بازنشانی می‌شود. (Arg-Required)
.IP "\-\-attach\-name [<name>]" 4
.IX Item "--attach-name [<name>]"
این گزینه نام فایلی را تعیین می‌کند که در بخش MIME ایجادشده برای گزینهٔ \f(CW\*(C`\-\-attach\*(C'\fR بعدی گنجانده خواهد شد. اگر هیچ آرگومانی برای این گزینه تعیین نشود، سبب خواهد شد که هیچ اطلاعاتی از نام فایل برای بخش MIME بعدی درج نگردد، حتی اگر Swaks بتواند آن را از نام فایل محلی به دست آورد. (Arg-Optional)
.IP "\-ah, \-\-add\-header <header>" 4
.IX Item "-ah, --add-header <header>"
این گزینه امکان اضافه کردن سرآیندها را به DATA فراهم می‌کند. اگر \f(CW\*(C`%NEW_HEADERS%\*(C'\fR در DATA وجود داشته باشد، با آرگومان این گزینه جایگزین می‌شود. اگر \f(CW\*(C`%NEW_HEADERS%\*(C'\fR وجود نداشته باشد، آرگومان بین دو خط جدید متوالی ابتدایی در DATA درج می‌شود (یعنی در انتهای سرآیندهای موجود درج می‌گردد).
.Sp
این گزینه را می‌توان چندین بار مشخص کرد، یا یک بار با چندین سرآیند که به وسیلهٔ رشتهٔ \f(CW\*(C`\en\*(C'\fR از یکدیگر تفکیک شده‌اند. بنابراین، عبارات \f(CW\*(C`\-\-add\-header \*(AqFoo: bar\*(Aq \-\-add\-header \*(AqBaz: foo\*(Aq\*(C'\fR و \f(CW\*(C`\-\-add\-header \*(AqFoo: bar\enBaz: foo\*(Aq\*(C'\fR در نهایت همان دو سرآیند را اضافه می‌کنند. (Arg-Required)
.IP "\-\-header <header\-and\-data>, \-\-h\-<header> <data>" 4
.IX Item "--header <header-and-data>, --h-<header> <data>"
این گزینه‌ها روشی را برای تغییر سرآیندهایی که از قبل در DATA وجود دارند فراهم می‌کنند. گزینه‌های \f(CW\*(C`\-\-header \*(AqSubject: foo\*(Aq\*(C'\fR و \f(CW\*(C`\-\-h\-Subject foo\*(C'\fR معادل یکدیگرند. اگر سرآیند مربوطه از قبل در داده‌ها وجود نداشته باشد، این آرگومان رفتاری کاملاً مشابه با \f(CW\*(C`\-\-add\-header\*(C'\fR خواهد داشت. با این حال، اگر سرآیند از قبل موجود باشد، با مقدار جدید جایگزین می‌شود. نفی کردن نگارشی از این گزینه که نام سرآیند را در خود گزینه دارد (مانند \f(CW\*(C`\-\-no\-header\-Subject\*(C'\fR)، تمام گزینه‌های \f(CW\*(C`\-\-header\*(C'\fR قبلاً پردازش‌شده را حذف خواهد کرد، نه فقط موارد مربوط به 'Subject'. گنجاندن نام سرآیند در گزینه از طریق متغیر محیطی در ویندوز پشتیبانی نمی‌شود و منجر به خطا خواهد شد. (Arg-Required)
.IP \-g 4
.IX Item "-g"
این گزینه یک نام مستعار مستقیم برای \f(CW\*(C`\-\-data \-\*(C'\fR (خواندن DATA از \f(CW\*(C`STDIN\*(C'\fR) است. این گزینه کاملاً نسبت به \f(CW\*(C`\-\-data\*(C'\fR اولویت دوم دارد. هر بار ظاهر شدن گزینهٔ \f(CW\*(C`\-\-data\*(C'\fR سبب نادیده گرفته شدن \f(CW\*(C`\-g\*(C'\fR خواهد شد. این گزینه را نمی‌توان با پیشوند \f(CW\*(C`no\-\*(C'\fR نفی کرد. این گزینه منسوخ شده و در نگارش‌های آیندهٔ Swaks حذف خواهد شد. (Arg-None, Deprecated)
.IP "\-\-no\-data\-fixup, \-ndf" 4
.IX Item "--no-data-fixup, -ndf"
این گزینه Swaks را مجبور می‌کند که هیچ‌گونه تغییر و دستکاری در بخش DATA ایمیل انجام ندهد. این تغییرات شامل جایگزینی توکن‌ها، حذف خطوط From_، اضافه کردن نقطهٔ انتهایی، گنجاندن \f(CW\*(C`\-\-body\*(C'\fR/پیوست، و هرگونه افزودن سرآیند می‌شود. این گزینه تنها زمانی کاربرد دارد که همراه با \f(CW\*(C`\-\-data\*(C'\fR استفاده شود، زیرا بخش داخلی و پیش‌فرض DATA از توکن‌ها بهره می‌برد. (Arg-None).IP "\-\-no\-strip\-from, \-nsf" 4
.IX Item "--no-strip-from, -nsf"
خط \f(CWFrom_\fR را در صورت وجود، از بخش \f(CWDATA\fR حذف نمی‌کند. (بدون آرگومان)
.SH "گزینه‌های خروجی (OUTPUT OPTIONS)"
.IX Header "OUTPUT OPTIONS"
\fBSwaks\fR به‌طور پیش‌فرض رونوشتی از تراکنش‌های خود را به فراخواننده (\f(CW\*(C`STDOUT\*(C'\fR/\f(CW\*(C`STDERR\*(C'\fR) ارائه می‌دهد. هدف این رونوشت، ارائه تصویری تا حد امکان وفادار و دقیق از تراکنش است، اگرچه این خروجی را با افزودن پیشوندهای اطلاعاتی به خطوط و ارائه نسخه‌های متنی ساده از تراکنش‌های \f(CWTLS\fR تغییر می‌دهد.
.PP
«پیشوندهای اطلاعاتی» به عنوان نشانه‌های تراکنش (transaction hints) شناخته می‌شوند. این نشانه‌ها در ابتدا شامل مواردی هستند که خطوط خروجیِ خودِ \fBSwaks\fR (اعم از پیام‌های اطلاعاتی یا خطا) را مشخص می‌کنند، و مواردی که نمایانگر خطی از داده‌های ارسال‌شده یا دریافت‌شده‌ی واقعی در یک تراکنش هستند. این جدول نشانه‌ها و مفاهیم آن‌ها را نشان می‌دهد:
.ie n .IP """===""" 4
.el .IP \f(CW===\fR 4
.IX Item "==="
نمایانگر یک خط اطلاعاتی ایجادشده توسط \fBSwaks\fR است.
.ie n .IP """***""" 4
.el .IP \f(CW***\fR 4
.IX Item "***"
نمایانگر خطایی است که درون \fBSwaks\fR ایجاد شده است.
.ie n .IP """\ \->""" 4
.el .IP \f(CW\ \->\fR 4
.IX Item "\ ->"
نمایانگر خط مورد انتظار ارسال‌شده توسط \fBSwaks\fR به سرور هدف است.
.ie n .IP """\ ~>""" 4
.el .IP \f(CW\ ~>\fR 4
.IX Item "\ ~>"
نمایانگر خط مورد انتظار و رمزنگاری‌شده با \f(CWTLS\fR است که توسط \fBSwaks\fR به سرور هدف ارسال شده است.
.ie n .IP """**>""" 4
.el .IP \f(CW**>\fR 4
.IX Item "**>"
نمایانگر خط غیرمنتظره ارسال‌شده توسط \fBSwaks\fR به سرور هدف است.
.ie n .IP """*~>""" 4
.el .IP \f(CW*~>\fR 4
.IX Item "*~>"
نمایانگر خط غیرمنتظره و رمزنگاری‌شده با \f(CWTLS\fR است که توسط \fBSwaks\fR به سرور هدف ارسال شده است.
.ie n .IP """\ \ >""" 4
.el .IP \f(CW\ \ >\fR 4
.IX Item "\ \ >"
نمایانگر تکه متن خامی است که توسط \fBSwaks\fR به سرور هدف ارسال شده است (گزینه \f(CW\*(C`\-\-show\-raw\-text\*(C'\fR را ببینید). در این سطح، مفهومی به عنوان «مورد انتظار» یا «غیرمنتظره» وجود ندارد.
.ie n .IP """<\-\ """ 4
.el .IP \f(CW<\-\ \fR 4
.IX Item "<-\ "
نمایانگر خط مورد انتظار ارسال‌شده توسط سرور هدف به \fBSwaks\fR است.
.ie n .IP """<~\ """ 4
.el .IP \f(CW<~\ \fR 4
.IX Item "<~\ "
نمایانگر خط مورد انتظار و رمزنگاری‌شده با \f(CWTLS\fR است که توسط سرور هدف به \fBSwaks\fR ارسال شده است.
.ie n .IP """<**""" 4
.el .IP \f(CW<**\fR 4
.IX Item "<**"
نمایانگر خط غیرمنتظره ارسال‌شده توسط سرور هدف به \fBSwaks\fR است.
.ie n .IP """<~*""" 4
.el .IP \f(CW<~*\fR 4
.IX Item "<~*"
نمایانگر خط غیرمنتظره و رمزنگاری‌شده با \f(CWTLS\fR است که توسط سرور هدف به \fBSwaks\fR ارسال شده است.
.ie n .IP """<\ \ """ 4
.el .IP \f(CW<\ \ \fR 4
.IX Item "<\ \ "
نمایانگر تکه متن خامی است که توسط \fBSwaks\fR از یک سرور هدف دریافت شده است (گزینه \f(CW\*(C`\-\-show\-raw\-text\*(C'\fR را ببینید). در این سطح، مفهومی به عنوان «مورد انتظار» یا «غیرمنتظره» وجود ندارد.
.PP
گزینه‌های زیر چگونگی و محتوای خروجیِ نمایش‌داده‌شده به فراخواننده را کنترل می‌کنند.
.IP "\-n, \-\-suppress\-data" 4
.IX Item "-n, --suppress-data"
به جای چاپ تک‌تک خطوط، بخش \f(CWDATA\fR از تراکنش \f(CWSMTP\fR را خلاصه می‌کند. این گزینه هنگام استفاده از \fBSwaks\fR برای ارسال برخی ایمیل‌های آزمایشی بسیار مفید و تقریباً ضروری است. به عنوان مثال، اگر \f(CWDATA\fR خلاصه نشود، ایمیل‌های حاوی پیوست به سرعت ترمینال را اشباع می‌کنند. (بدون آرگومان)
.IP "\-stl, \-\-show\-time\-lapse [i]" 4
.IX Item "-stl, --show-time-lapse [i]"
مدت زمان سپری‌شده بین جفت‌های ارسال/دریافت را نمایش می‌دهد. این گزینه زمانی بیشترین کاربرد را دارد که ماژول \f(CWTime::HiRes\fR در دسترس باشد، که در این حالت زمان سپری‌شده بر حسب یک‌هزارم ثانیه نمایش داده می‌شود. اگر \f(CWTime::HiRes\fR در دسترس نباشد یا «\f(CWi\fR» به عنوان آرگومان داده شود، زمان سپری‌شده تنها با اعداد صحیح (ثانیه) نمایش داده خواهد شد. (آرگومان اختیاری)
.Sp
نشانه تراکنش را برای تراکنش‌های اطلاعاتی نمایش نمی‌دهد. این ویژگی زمانی بیشترین کاربرد را دارد که نیاز به کپی کردن بخشی از خطوط اطلاعاتی باشد، به عنوان مثال خروجی گواهی از گزینه \f(CW\*(C`\-\-tls\-get\-peer\-cert\*(C'\fR. (بدون آرگومان)
.IP "\-nih, \-\-no\-info\-hints" 4
.IX Item "-nih, --no-info-hints"
.PD 0
.IP "\-nsh, \-\-no\-send\-hints" 4
.IX Item "-nsh, --no-send-hints"
.IP "\-nrh, \-\-no\-receive\-hints" 4
.IX Item "-nrh, --no-receive-hints"
.IP "\-nth, \-\-no\-hints" 4
.IX Item "-nth, --no-hints"
.PD
گزینه‌های \f(CW\*(C`\-\-no\-info\-hints\*(C'\fR، \f(CW\*(C`\-\-no\-send\-hints\*(C'\fR و \f(CW\*(C`\-\-no\-receive\-hints\*(C'\fR به ترتیب نشانه‌های تراکنش را از خطوط اطلاعات، ارسال و دریافت حذف می‌کنند. این قابلیت معمولاً هنگام کپی کردن بخشی از تراکنش برای استفاده در جایی دیگر مفید است (به عنوان مثال، \f(CW\*(C`\-\-no\-send\-hints \-\-hide\-receive \-\-hide\-informational\*(C'\fR روش مناسبی برای دریافت تنها دستورهای سمت کلاینت در یک تراکنش معین است، و \f(CW\*(C`\-\-no\-info\-hints \-\-tls\-get\-peer\-cert\*(C'\fR برای کپی کردن گواهی طرف مقابل کاربرد دارد). گزینه \f(CW\*(C`\-\-no\-hints\*(C'\fR معادل با تعیین هم‌زمان \f(CW\*(C`\-\-no\-info\-hints \-\-no\-send\-hints \-\-no\-receive\-hints\*(C'\fR است. (بدون آرگومان)
.IP "\-raw, \-\-show\-raw\-text" 4
.IX Item "-raw, --show-raw-text"
این گزینه یک تخلیه شانزده‌شانزدهی (hex dump) از داده‌های خام ارسال‌شده و دریافت‌شده توسط \fBSwaks\fR را چاپ می‌کند. هر hex dump محتوای یک عملیات خواندن یا نوشتن منفرد روی شبکه است. این مقدار باید با آنچه که قبلاً نمایش داده می‌شد یکسان باشد (به استثنای حذف نویسه‌های \f(CW\*(C`\er\*(C'\fR). این گزینه برای مشاهده جزئیات زمانی مفید است که سرورها مقادیر زیادی داده را در بسته‌های منفرد ارسال می‌کنند، یا خطوط مجزا را به چندین بسته تقسیم می‌نمایند. اگر واقعاً نیاز به بررسی عمیق در این زمینه دارید، استفاده از یک ابزار شنود بسته (packet sniffer) برای شما مناسب‌تر خواهد بود، اما این گزینه اولین گام خوب برای مشاهده مشکلات عجیب اتصال است. (بدون آرگومان)
.IP "\-\-output, \-\-output\-file <file\-path>" 4
.IX Item "--output, --output-file <file-path>"
.PD 0
.IP "\-\-output\-file\-stdout <file\-path>" 4
.IX Item "--output-file-stdout <file-path>"
.IP "\-\-output\-file\-stderr <file\-path>" 4
.IX Item "--output-file-stderr <file-path>"
.PD
این گزینه‌ها به کاربر اجازه می‌دهند خروجی را به جای \f(CW\*(C`STDOUT\*(C'\fR/\f(CW\*(C`STDERR\*(C'\fR به فایل‌ها هدایت کند. گزینه اول هر دو را به یک فایل یکسان می‌فرستد. آرگومان‌های \f(CW&STDOUT\fR و \f(CW&STDERR\fR به صورت ویژه پردازش شده و به دستگیره‌های فایل «عادی» اشاره می‌کنند؛ بنابراین \f(CW\*(C`\-\-output\-file\-stderr \*(Aq&STDOUT\*(Aq\*(C'\fR خروجی \f(CW\*(C`STDERR\*(C'\fR را به \f(CW\*(C`STDOUT\*(C'\fR تغییر مسیر می‌دهد. این گزینه‌ها برای تمام خروجی‌ها به جز \f(CW\*(C`\-\-help\*(C'\fR و \f(CW\*(C`\-\-version\*(C'\fR اعمال می‌شوند. (آرگومان اجباری)
.IP "\-pp, \-\-protect\-prompt" 4
.IX Item "-pp, --protect-prompt"
از بازتاب (echo) ورودی کاربر در اعلان‌هایی که احتمالاً حساس هستند جلوگیری می‌کند (در حال حاضر فقط گذرواژه احراز هویت). به‌طور دقیق‌تر، هر گزینه‌ای که با عنوان «حساس» (Sensitive) مشخص شده باشد و در نهایت برای دریافت یک آرگومان اعلان نمایش دهد، تمام تلاش خود را می‌کند تا از بازتاب آن آرگومان جلوگیری کند. همچنین گزینه \f(CW\*(C`\-\-auth\-hide\-password\*(C'\fR را ببینید. (بدون آرگومان)
.IP "\-hr, \-\-hide\-receive" 4
.IX Item "-hr, --hide-receive"
خطوط ارسال‌شده از سرور دوردست که توسط \fBSwaks\fR دریافت می‌شوند را نمایش نمی‌دهد. (بدون آرگومان)
.IP "\-hs, \-\-hide\-send" 4
.IX Item "-hs, --hide-send"
خطوطی که توسط \fBSwaks\fR به سرور دوردست ارسال می‌شوند را نمایش نمی‌دهد. (بدون آرگومان)
.IP "\-hi, \-\-hide\-informational" 4
.IX Item "-hi, --hide-informational"
خطوط اطلاعاتیِ غیرخطا را که از خودِ \fBSwaks\fR تولید می‌شوند نمایش نمی‌دهد. (بدون آرگومان)
.IP "\-ha, \-\-hide\-all" 4
.IX Item "-ha, --hide-all"
هیچ محتوایی را در ترمینال نمایش نمی‌دهد. (بدون آرگومان)
.IP "\-S, \-\-silent [ 1 | 2 | 3 ]" 4
.IX Item "-S, --silent [ 1 | 2 | 3 ]"
باعث بی‌صدا شدن \fBSwaks\fR می‌شود. اگر هیچ آرگومانی داده نشود یا آرگومان «1» ارائه شود، هیچ خروجی چاپ نمی‌شود مگر اینکه خطایی رخ دهد که پس از آن تمام خروجی‌ها نمایش داده می‌شوند. اگر آرگومان «2» داده شود، تنها خطاها چاپ می‌شوند. اگر «3» داده شود، هیچ‌گاه هیچ خروجی نمایش داده نخواهد شد. گزینه \f(CW\*(C`\-\-silent\*(C'\fR بر بیشتر خروجی‌ها تأثیر می‌گذارد اما نه همه آن‌ها؛ به عنوان مثال گزینه‌های \f(CW\*(C`\-\-help\*(C'\fR، \f(CW\*(C`\-\-version\*(C'\fR، \f(CW\*(C`\-\-dump\*(C'\fR و \f(CW\*(C`\-\-dump\-mail\*(C'\fR تحت تأثیر قرار نمی‌گیرند. به دلایل تاریخی، \-S از طریق متغیر محیطی در ویندوز قابل تنظیم نیست؛ به جای آن از \f(CWSWAKS_OPT_silent\fR استفاده کنید. (آرگومان اختیاری)
.IP \-\-support 4
.IX Item "--support"
قابلیت‌ها را چاپ کرده و خارج می‌شود. برخی از ویژگی‌ها نیازمند ماژول‌های غیر استاندارد \f(CWPerl\fR هستند. این گزینه وجود این ماژول‌ها را بررسی کرده و نشان می‌دهد چه عملکردهایی در دسترس هستند و چه عملکردهایی در دسترس نیستند، و برای به‌دست آوردن عملکردهای مفقود باید چه ماژول‌هایی افزوده شوند. (بدون آرگومان)
.IP \-\-dump\-mail 4
.IX Item "--dump-mail"
باعث می‌شود \fBSwaks\fR تمام گزینه‌ها را برای تولید پیامی که قصد ارسال آن را داشت پردازش کند، سپس آن پیام را به جای ارسال، در \f(CW\*(C`STDOUT\*(C'\fR چاپ کند. این خروجی با بخش «data» از گزینه \f(CW\*(C`\-\-dump\*(C'\fR یکسان است، با این تفاوت که نقطه انتهایی را ندارد. (بدون آرگومان)
.IP "\-\-dump [<section>[,<section>[,...]]]" 4
.IX Item "--dump [<section>[,<section>[,...]]]"
این گزینه باعث می‌شود \fBSwaks\fR نتایج پردازش گزینه‌ها را درست پیش از ارسال ایمیل چاپ کند. هنگام استفاده از \f(CW\*(C`\-\-dump\*(C'\fR هیچ ایمیلی ارسال نخواهد شد. توجه داشته باشید که \f(CW\*(C`\-\-dump\*(C'\fR یک ابزار صرفاً خودعیب‌یابی است و هیچ تلاشی برای پوشاندن (mask) گذرواژه‌ها در خروجی \f(CW\*(C`\-\-dump\*(C'\fR انجام نشده و نخواهد شد. اگر یک بخش به عنوان آرگومان به این گزینه داده شود، تنها همان بخش درخواستی نمایش داده می‌شود. آرگومان‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از: \f(CWSUPPORT\fR، \f(CWAPP\fR، \f(CWOUTPUT\fR، \f(CWTRANSPORT\fR، \f(CWPROTOCOL\fR، \f(CWXCLIENT\fR، \f(CWPROXY\fR، \f(CWTLS\fR، \f(CWAUTH\fR، \f(CWDATA\fR و \f(CWALL\fR. اگر هیچ آرگومانی ارائه نشود، تمام بخش‌ها نمایش داده می‌شوند. (آرگومان اختیاری)
.IP \-\-help 4
.IX Item "--help"
این اطلاعات راهنما را نمایش داده و خارج می‌شود. (بدون آرگومان)
.IP \-\-version 4
.IX Item "--version"
اطلاعات نسخه را نمایش داده و خارج می‌شود. (بدون آرگومان).SH "موارد منسوخ (DEPRECATIONS)"
.IX Header "DEPRECATIONS"
قابلیت‌های زیر منسوخ شده‌اند و در نگارش‌های آینده Swaks حذف خواهند شد
.IP "استفاده از ماژول‌های IO::Socket و IO::Socket::INET6" 4
.IX Item "use of IO::Socket and IO::Socket::INET6 modules"
زودتر از (۱ فوریه ۲۰۲۵) حذف نخواهد شد.
.Sp
روش اصلی ارسال روی سوکت‌های IPv4 و IPv6 با استفاده از ماژول IO::Socket::IP پیاده‌سازی شده است. در حال حاضر، پشتیبانی قدیمی از ماژول‌های IO::Socket و IO::Socket::INET6 که پیش‌تر استفاده می‌شدند، همچنان حفظ شده است. لطفاً اطمینان حاصل کنید که ماژول IO::Socket::IP نصب شده است تا از کارکرد صحیح در آینده اطمینان یابید.
.SH "سازگاری و انتقال‌پذیری (PORTABILITY)"
.IX Header "PORTABILITY"
.IP "سیستم‌عامل‌ها (OPERATING SYSTEMS)" 4
.IX Item "OPERATING SYSTEMS"
این برنامه در اصل برای استفاده در سیستم‌عامل‌های شبه‌یونیکس (UNIX-like) در نظر گرفته شده بود و باید روی هر نسخه معقولی از آن‌ها کار کند. این برنامه روی Solaris، Linux و Mac OS X توسعه یافته و آزمایش شده و در همه آن‌ها از نظر قابلیت‌ها کامل است.
.Sp
مشخص شده است که این برنامه کارکردهای پایه‌ای را در Windows با استفاده از Strawberry Perl ارائه می‌دهد. در تمام مستندات، مگر در مواردی که خلاف آن ذکر شده باشد، «Windows» به اجرای Swaks از طریق CMD.exe اشاره دارد، نه WSL یا cygwin. این برنامه به‌طور کامل آزمایش نشده است، اما کارکرد قابلیت‌های پایه‌ای SMTP و انواع احراز هویت LOGIN، PLAIN و CRAM\-MD5 تأیید شده است. وضعیت کارکرد قابلیت‌های TLS و انواع احراز هویت NTLM/SPA و DIGEST\-MD5 نامشخص است. مشخص شده که برخی قابلیت‌ها در Windows محدود هستند، از جمله ناتوانی در گنجاندن نام سرایند در متغیرهای محیطی (بخش «CONFIGURATION ENVIRONMENT VARIABLES» و \f(CW\*(C`\-\-header\*(C'\fR را ببینید)، ناتوانی در تولید رشته تاریخ با منطقه زمانی محلی (نشانگر \f(CW\*(C`%DATE%\*(C'\fR ذیل \f(CW\*(C`\-\-data\*(C'\fR را ببینید)، ناتوانی در استفاده از گزینه \f(CW\*(C`\-S\*(C'\fR به عنوان یک متغیر محیطی (\f(CW\*(C`\-\-silent\*(C'\fR را ببینید)، و ناتوانی در داشتن مقدار «تنظیم‌شده اما خالی» در یک متغیر محیطی (برای راهکار موقت بخش «CONFIGURATION ENVIRONMENT VARIABLES» را ببینید).
.Sp
از آن‌جا که این برنامه باید در هر جایی که Perl اجرا می‌شود کار کند، خوشحال خواهم شد در جریان هر سیستم‌عامل جدیدی که Swaks را به‌طور کامل روی آن استفاده کرده‌اید و همچنین هرگونه مشکلی که در یک سیستم‌عامل جدید با آن مواجه شده‌اید قرار بگیرم.
.IP "سرورهای ایمیل (MAIL SERVERS)" 4
.IX Item "MAIL SERVERS"
این برنامه تقریباً به‌طور اختصاصی در تعامل با سرورهای ایمیل Exim توسعه یافته است. نویسنده گاه‌به‌گاه، اگرچه نه به‌طور کامل و دقیق، آن را با Sendmail، Smail، Exchange، Oracle Collaboration Suite، qpsmtpd و Communigate استفاده کرده است. از آن‌جا که تمامی قابلیت‌ها در Swaks بر پایه استانداردهای شناخته‌شده هستند، باید با هر سرور ایمیل نسبتاً مدرنی کار کند. در صورت یافتن مشکل، لطفاً آن را از طریق نشانی زیر به نویسنده گزارش دهید.
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.IX Header "ENVIRONMENT VARIABLES"
.IP LOGNAME 4
.IX Item "LOGNAME"
اگر Swaks مجبور به ایجاد یک نشانی فرستنده باشد، در صورتی که \f(CW$LOGNAME\fR مقداردهی شده باشد و مگر اینکه از \f(CW\*(C`\-\-force\-getpwuid\*(C'\fR استفاده شود، از آن به عنوان بخش محلی (local-part) پیام استفاده می‌شود.
.IP SWAKS_HOME 4
.IX Item "SWAKS_HOME"
هنگام جستجو برای فایل پیکربندی \fI.swaksrc\fR استفاده می‌شود. بخش OPTION PROCESSING \-> "CONFIGURATION FILES" در بالا را ببینید.
.IP SWAKS_OPT_* 4
.IX Item "SWAKS_OPT_*"
پیشوند متغیرهای محیطی برای مشخص کردن گزینه‌های Swaks از طریق متغیرهای محیطی. بخش OPTION PROCESSING \-> "CONFIGURATION ENVIRONMENT VARIABLES" در بالا را ببینید.
.SH "کدهای خروج (EXIT CODES)"
.IX Header "EXIT CODES"
.IP 0 4
هیچ خطایی رخ نداد
.IP 1 4
.IX Item "1"
خطا در تجزیه گزینه‌های خط فرمان
.IP 2 4
.IX Item "2"
خطا در اتصال به سرور راه دور
.IP 3 4
.IX Item "3"
نوع اتصال ناشناخته است
.IP 4 4
.IX Item "4"
هنگام اجرا با نوع اتصال «pipe»، بروز مشکل مهلک در نوشتن یا خواندن از فرآیند فرزند
.IP 5 4
.IX Item "5"
هنگام اجرا با نوع اتصال «pipe»، فرآیند فرزند به‌طور غیرمنتظره‌ای پایان یافت. این می‌تواند به این معنی باشد که برنامه مشخص‌شده با \f(CW\*(C`\-\-pipe\*(C'\fR وجود ندارد.
.IP 6 4
.IX Item "6"
اتصال به‌طور غیرمنتظره‌ای بسته شد. اگر بسته شدن اتصال در پاسخ به دستور «QUIT» که Swaks پس از یک پاسخ غیرمنتظره ارسال می‌کند تشخیص داده شود، به جای آن از کد خطای مربوط به همان پاسخ غیرمنتظره استفاده می‌شود. به عنوان مثال، اگر یک سرور ایمیل در پاسخ به MAIL FROM: پاسخ 550 بازگرداند و سپس بلافاصله اتصال را ببندد، Swaks بسته شدن اتصال را تشخیص می‌دهد، اما از کد خروج دقیق‌تر 23 برای مشخص کردن ماهیت شکست استفاده می‌کند. در مقابل اگر سرور کد 250 را بازگرداند و سپس بلافاصله اتصال را ببندد، Swaks از کد خروج 6 استفاده خواهد کرد زیرا کد خروج مشخص‌تری وجود ندارد.
.IP 10 4
.IX Item "10"
خطا در پیش‌نیازها (ماژول مورد نیاز در دسترس نیست)
.IP 21 4
.IX Item "21"
خطا در خواندن بنر اولیه از سرور
.IP 22 4
.IX Item "22"
خطا در تراکنش HELO
.IP 23 4
.IX Item "23"
خطا در تراکنش MAIL
.IP 24 4
.IX Item "24"
هیچ گیرنده‌ای (RCPT) پذیرفته نشد
.IP 25 4
.IX Item "25"
سرور در پاسخ به درخواست DATA خطا بازگرداند
.IP 26 4
.IX Item "26"
سرور پس از داده‌ها، ایمیل را نپذیرفت
.IP 27 4
.IX Item "27"
سرور پس از درخواست خروج (quit) در نشست عادی، خطا بازگرداند
.IP 28 4
.IX Item "28"
خطا در تراکنش AUTH
.IP 29 4
.IX Item "29"
خطا در تراکنش TLS
.IP 30 4
.IX Item "30"
قابلیت PRDR درخواست شده/الزامی است اما توسط سرور اعلان نشده است
.IP 32 4
.IX Item "32"
خطا در EHLO پس از مذاکره TLS
.IP 33 4
.IX Item "33"
خطا در تراکنش XCLIENT
.IP 34 4
.IX Item "34"
خطا در EHLO پس از XCLIENT
.IP 35 4
.IX Item "35"
خطا در پردازش گزینه PROXY
.IP 36 4
.IX Item "36"
خطا در ارسال بنر PROXY
.SH "درباره نام (ABOUT THE NAME)"
.IX Header "ABOUT THE NAME"
نام «Swaks» تا حدی سرواژه‌ای برای «SWiss Army Knife SMTP» (چاقوی سوئیسی SMTP) است. این نام به دلیل تمایز و قابلیت تلفظ آسان انتخاب شد. در حالی که «Swaks» به عنوان نام یک بسته نرم‌افزاری منحصربه‌فرد است، معانی دیگری خارج از دنیای نرم‌افزار نیز دارد. لطفاً کاربردهای دیگر «swak» یا «swaks» را برای گنجاندن در این بخش ارسال کنید.
.IP """Sealed With A Kiss""" 4
.IX Item """Sealed With A Kiss"""
عبارت SWAK/SWAKs گهگاه در اینترنت به معنای «با عشق» (مهر و موم شده با بوسه) دیده می‌شود.
.IP "bad / poor / ill (آفریکانس)" 4
.IX Item "bad / poor / ill (Afrikaans)"
در تیتر «SA se bes en swaks gekledes in 2011» دیده شده که توسط گویشوران بومی به «خوش‌پوش‌ترین‌ها و بدپوش‌ترین‌ها» ترجمه شده است. Google Translate میانه خوبی با «swaks gekledes» ندارد، اما «swak» را به «poor» (ضعیف/بد) و «swak geklede» را به «ill-dressed» (بدپوش) ترجمه می‌کند.
.SH "مجوز (LICENSE)"
.IX Header "LICENSE"
این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «مجوز عمومی همگانی گنو» (GNU General Public License) همان‌طور که توسط «بنیاد نرم‌افزارهای آزاد» (Free Software Foundation) منتشر شده است، چه نسخه ۲ مجوز و چه (به انتخاب خودتان) هر نسخه بعدی دیگری، بازتوزیع کرده و/یا تغییر دهید.
.PP
این برنامه با این امید توزیع شده است که مفید باشد، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی «قابل فروش بودن» یا «مناسب بودن برای یک هدف خاص». برای جزئیات بیشتر به «مجوز عمومی همگانی گنو» مراجعه کنید.
.PP
شما باید به همراه این برنامه یک نسخه از مجوز عمومی همگانی گنو را دریافت کرده باشید؛ در غیر این صورت، به نشانی زیر مکاتبه کنید:
Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110\-1301, USA..SH "اطلاعات تماس (CONTACT INFORMATION)"
.IX Header "CONTACT INFORMATION"
ارتباط عمومی، پرسش‌ها، وصله‌ها، درخواست‌ها و غیره به proj\-swaks@jetmore.net ارسال شوند.
.PP
گزارش تغییرات، این راهنما و آخرین نسخه در <http://www.jetmore.org/john/code/swaks> در دسترس هستند.
.PP
ابزار Swaks با عشق توسط John Jetmore از مزارع ذرت ایندیانا در ایالات متحده آمریکا ساخته شده است.
.SH "اعلان‌ها (NOTIFICATIONS)"
.IX Header "NOTIFICATIONS"
.IP "ایمیل" 4
.IX Item "ایمیل"
updates\-swaks@jetmore.net
.Sp
اگر مایلید در فهرستی قرار بگیرید تا با انتشار نسخه جدیدی از Swaks اعلان‌ها را دریافت کنید، لطفاً ایمیلی به این نشانی ارسال کنید. پاسخی به ایمیل شما داده نخواهد شد.
.IP "وبگاه" 4
.IX Item "وبگاه"
<http://www.jetmore.org/john/blog/c/swaks>
.IP "خوراک RSS" 4
.IX Item "خوراک RSS"
<http://www.jetmore.org/john/blog/c/swaks/feed>
.IP "توییتر" 4
.IX Item "توییتر"
<http://twitter.com/SwaksSMTP>