.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.2.
.TH GSASL "1" "June 2026" "GNU SASL 2.2.4" "دستورات کاربر"
.SH "نام (NAME)"
gsasl \- رابط خط فرمان کتابخانه SASL
.SH "خلاصه دستور (SYNOPSIS)"
.B gsasl
[\fI\,گزینه‌ها\/\fR]... [\fI\,میزبان \/\fR[\fI\,پورت\/\fR]]...
.SH "توضیحات (DESCRIPTION)"
احراز هویت کاربر در یک کارگزار با استفاده از لایه احراز هویت و امنیت ساده (SASL).
در حال حاضر کارگزارهای IMAP و SMTP پشتیبانی می‌شوند. این برنامه یک رابط خط فرمان برای کتابخانه GNU SASL است.
.TP
\fB\-h\fR, \fB\-\-help\fR
چاپ راهنما و خروج
.TP
\fB\-V\fR, \fB\-\-version\fR
چاپ نسخه و خروج
.SS "دستورها:"
.TP
\fB\-c\fR, \fB\-\-client\fR
عمل کردن در نقش کلاینت (پیش‌فرض: فعال)
.TP
\fB\-s\fR, \fB\-\-server\fR
عمل کردن در نقش کارگزار (پیش‌فرض: غیرفعال)
.TP
\fB\-\-client\-mechanisms\fR
نوشتن نام سازوکارهای پشتیبانی‌شده کلاینت در خروجی استاندارد (stdout) با فاصله به عنوان جداکننده (پیش‌فرض: غیرفعال)
.TP
\fB\-\-server\-mechanisms\fR
نوشتن نام سازوکارهای پشتیبانی‌شده کارگزار در خروجی استاندارد (stdout) با فاصله به عنوان جداکننده (پیش‌فرض: غیرفعال)
.TP
\fB\-k\fR, \fB\-\-mkpasswd\fR
مشتق‌سازی رمز عبور. مقدار \fB\-\-mechanism\fR باید SCRAM\-SHA\-1 یا SCRAM\-SHA\-256 باشد.
ورودی‌های اجباری شامل رمز عبور (از طریق \fB\-\-password\fR یا خوانده‌شده از ترمینال) هستند و ورودی‌های اختیاری شامل تعداد تکرار (از طریق \fB\-\-iteration\-count\fR، پیش‌فرض ۶۵۵۳۶) و سالت (از طریق \fB\-\-salt\fR یا تولید تصادفی) می‌باشند. خروجی رشته‌ای به این شکل است:
"{mech}count,salt,stored\-key,server\-key[,salted\-password]"
که در آن "mech" نام سازوکار، "count" تعداد دفعات هش شدن رمز عبور، "salt" سالت ارائه‌شده یا تولیدشده با کدگذاری base64، و "stored\-key" و "server\-key" دو کلید مشتق‌شده سمت سرور با کدگذاری base64 هستند. در صورت تعیین \fB\-\-verbose\fR، مقدار "salted\-password" نیز به‌صورت رمز عبور مشتق‌شده PBKDF2 با کدگذاری hex گنجانده می‌شود (پیش‌فرض: غیرفعال).
.SS "گزینه‌های شبکه:"
.TP
\fB\-\-connect\fR=\fI\,HOST[\/\fR:PORT]
اتصال به کارگزار TCP و مذاکره روی جریان به جای stdin/stdout. مقدار PORT سرویس پروتکل یا یک عدد مشخص‌کننده پورت است که در صورت تعیین نشدن، مقدار پیش‌فرض ۱۴۳ (imap) خواهد بود. همچنین مقدار پیش‌فرض \fB\-\-hostname\fR را نیز تنظیم می‌کند.
.SS "گزینه‌های عمومی:"
.TP
\fB\-d\fR, \fB\-\-application\-data\fR
پس از احراز هویت، داده‌ها را از stdin خوانده، از لایه امنیتی سازوکار عبور داده و با کدگذاری base64 در خروجی استاندارد چاپ کند. پیش‌فرض این است که پس از احراز هویت خاتمه یابد (پیش‌فرض: فعال).
.TP
\fB\-\-imap\fR
استفاده از رویه ورود مشابه IMAP (فقط کلاینت). همچنین مقدار پیش‌فرض \fB\-\-service\fR را به 'imap' تنظیم می‌کند (پیش‌فرض: غیرفعال).
.TP
\fB\-\-smtp\fR
استفاده از رویه ورود مشابه SMTP (فقط کلاینت). همچنین مقدار پیش‌فرض \fB\-\-service\fR را به 'smtp' تنظیم می‌کند (پیش‌فرض: غیرفعال).
.TP
\fB\-m\fR, \fB\-\-mechanism\fR=\fI\,STRING\/\fR
سازوکار مورد استفاده.
.TP
\fB\-\-no\-client\-first\fR
اجازه ندادن به کلاینت برای ارسال داده در ابتدا (فقط کلاینت؛ پیش‌فرض: غیرفعال).
.SS "گزینه‌های سازوکار SASL (در صورت نیاز پرسیده می‌شوند):"
.TP
\fB\-n\fR, \fB\-\-anonymous\-token\fR=\fI\,STRING\/\fR
توکن برای احراز هویت ناشناس، معمولاً آدرس ایمیل (فقط ANONYMOUS).
.TP
\fB\-a\fR, \fB\-\-authentication\-id\fR=\fI\,STRING\/\fR
هویت مالک اعتبارنامه.
.TP
\fB\-z\fR, \fB\-\-authorization\-id\fR=\fI\,STRING\/\fR
هویت مورد نیاز برای درخواست سرویس.
.TP
\fB\-p\fR, \fB\-\-password\fR=\fI\,STRING\/\fR
رمز عبور برای احراز هویت (برای مقاصد غیرآزمایشی ناامن است).
.TP
\fB\-r\fR, \fB\-\-realm\fR=\fI\,STRING\/\fR
قلمرو (Realm). به‌طور پیش‌فرض برابر با نام میزبان است.
.TP
\fB\-\-passcode\fR=\fI\,NUMBER\/\fR
رمز عبور یک‌بار مصرف برای احراز هویت (فقط SECURID).
.TP
\fB\-\-service\fR=\fI\,STRING\/\fR
تنظیم نام سرویس درخواستی (باید یک نام سرویس مبتنی بر میزبان ثبت‌شده در GSSAPI باشد).
.TP
\fB\-\-hostname\fR=\fI\,STRING\/\fR
تنظیم نام کارگزار دارای سرویس درخواستی.
.TP
\fB\-\-service\-name\fR=\fI\,STRING\/\fR
تنظیم نام عمومی کارگزار در صورت استفاده از کارگزار تکثیرشده (فقط DIGEST\-MD5).
.TP
\fB\-\-enable\-cram\-md5\-validate\fR
اعتبارسنجی چالش و پاسخ CRAM\-MD5 به‌صورت تعاملی (پیش‌فرض: غیرفعال).
.TP
\fB\-\-disable\-cleartext\-validate\fR
غیرفعال‌سازی قلاب اعتبارسنجی متن آشکار، و اجبار کارگزار به درخواست رمز عبور (پیش‌فرض: غیرفعال).
.TP
\fB\-\-quality\-of\-protection\fR=\fI\,TYPE\/\fR
نحوه محافظت از بار داده (payload) برنامه.
مقدار 'qop\-auth' به معنای عدم محافظت، 'qop\-int' به معنای محافظت از یکپارچگی، و 'qop\-conf' به معنای محافظت از یکپارچگی و محرمانگی است. در حال حاضر فقط در DIGEST\-MD5 استفاده می‌شود که پیش‌فرض آن 'qop\-int' است.
.TP
\fB\-\-iteration\-count\fR=\fI\,NUMBER\/\fR
مشخص کردن تعداد تکرار هش PBKDF2 (فقط SCRAM؛ پیش‌فرض: ۶۵۵۳۶).
.TP
\fB\-\-salt\fR=\fI\,B64DATA\/\fR
مشخص کردن سالت PBKDF2 به‌صورت رشته کدگذاری‌شده base64 (فقط SCRAM).
.TP
\fB\-\-scram\-salted\-password\fR=\fI\,STRING\/\fR
رمز عبور نمک‌دار SCRAM برای احراز هویت (فقط SCRAM؛ ۴۰ کاراکتر هگز برای SCRAM\-SHA\-1 و ۶۴ کاراکتر برای SCRAM\-SHA\-256).
.SS "گزینه‌های STARTTLS:"
.TP
\fB\-\-starttls\fR
اجبار به استفاده از STARTTLS. پیش‌فرض استفاده از STARTTLS در صورت در دسترس بودن است (پیش‌فرض: غیرفعال).
.TP
\fB\-\-no\-starttls\fR
غیرفعال کردن قطعی STARTTLS (پیش‌فرض: غیرفعال).
.TP
\fB\-\-no\-cb\fR
عدم استفاده از پیوندهای کانال (channel bindings) از TLS (پیش‌فرض: غیرفعال).
.TP
\fB\-\-x509\-ca\-file\fR=\fI\,FILE\/\fR
فایل حاوی یک یا چند گواهی مرجع صدور گواهی (CA) نوع X.509 با فرمت PEM، که برای اعتبارسنجی گواهی دریافت شده از کارگزار استفاده می‌شود. اگر مشخص نشود، اعتبارسنجی از تنظیمات اعتماد سیستم استفاده می‌کند. اگر FILE رشته‌ای خالی باشد، در صورت بروز خطای اعتبارسنجی گواهی‌های کارگزار X.509 با خطا متوقف نمی‌شود.
.TP
\fB\-\-x509\-cert\-file\fR=\fI\,FILE\/\fR
فایل حاوی گواهی X.509 کلاینت با فرمت PEM. همراه با \fB\-\-x509\-key\-file\fR برای تعیین جفت گواهی/کلید استفاده می‌شود.
.TP
\fB\-\-x509\-key\-file\fR=\fI\,FILE\/\fR
کلید خصوصی برای گواهی X.509 کلاینت با فرمت PEM. همراه با \fB\-\-x509\-cert\-file\fR برای تعیین جفت گواهی/کلید استفاده می‌شود.
.TP
\fB\-\-priority\fR=\fI\,STRING\/\fR
رشته اولویت الگوریتم‌های رمزنگاری.
.SS "سایر گزینه‌ها:"
.TP
\fB\-\-verbose\fR
تولید خروجی با جزئیات کامل (پیش‌فرض: غیرفعال).
.TP
\fB\-\-quiet\fR
عدم تولید خروجی‌های تشخیصی (پیش‌فرض: غیرفعال).
.SH "نویسنده (AUTHOR)"
نوشته شده توسط Simon Josefsson.
.SH "گزارش باگ‌ها (REPORTING BUGS)"
گزارش باگ‌ها به: bug\-gsasl@gnu.org
.br
صفحه خانگی GNU SASL: <https://www.gnu.org/software/gsasl>
.br
راهنمای عمومی استفاده از نرم‌افزارهای گنو: <https://www.gnu.org/gethelp>
.SH "حق نشر (COPYRIGHT)"
حق نشر \(co 2026 Simon Josefsson.
.br
مجوز GPLv3+: گنو GPL نسخه ۳ یا بالاتر <https://gnu.org/licenses/gpl.html>.
.br
این نرم‌افزار آزاد است: شما مجاز به تغییر و بازتوزیع آن هستید.
هیچ‌گونه ضمانتی وجود ندارد، تا حدی که قانون اجازه می‌دهد.
.SH "همچنین ببینید (SEE ALSO)"
مستندات کامل برای
.B gsasl
به صورت یک راهنمای Texinfo نگهداری می‌شود. اگر برنامه‌های
.B info
و
.B gsasl
به‌درستی روی سیستم شما نصب شده باشند، اجرای دستور
.IP
.B info gsasl
.PP
باید دسترسی شما به راهنمای کامل را فراهم کند.