.TH PSKTOOL 1 "2026-04-29" "3.8.13" "دستورهای کاربری"
.SH "نام (NAME)"
psktool \- ابزار کلید از پیش به‌اشتراک‌گذاشته‌شده (PSK) در GnuTLS
.SH "خلاصه دستور (SYNOPSIS)"
.B psktool
[\fB\-flags\fR]
[\fB\-flag\fR [\fIvalue\fR]]
[\fB\-\-option\-name\fR[[=| ]\fIvalue\fR]]
.PP
تمام آرگومان‌ها باید از نوع گزینه باشند.
.SH "توضیحات (DESCRIPTION)"
برنامه‌ای که کلیدهای تصادفی را برای استفاده در TLS\-PSK تولید می‌کند.
کلیدها در قالب هگزادسیمال در یک فایل کلید ذخیره می‌شوند.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-d\fR \fInum\fR, \fB\-\-debug\fR=\fInum\fR
فعال‌سازی اشکال‌زدایی.
این گزینه یک عدد صحیح را به عنوان آرگومان دریافت می‌کند.
مقدار
.I num
به موارد زیر محدود است:
.in +4
.nf
در محدوده 0 تا 9999
.fi
.in -4
سطح اشکال‌زدایی را تعیین می‌کند.
.TP
\fB\-s\fR \fInum\fR, \fB\-\-keysize\fR=\fInum\fR
تعیین اندازه کلید بر حسب بایت (پیش‌فرض ۳۲ بایت یا ۲۵۶ بیت است).
این گزینه یک عدد صحیح را به عنوان آرگومان دریافت می‌کند.
مقدار
.I num
به موارد زیر محدود است:
.in +4
.nf
در محدوده 0 تا 512
.fi
.in -4
.TP
\fB\-u\fR \fIstr\fR, \fB\-\-username\fR=\fIstr\fR
تعیین نام کاربری مورد استفاده.
.TP
\fB\-p\fR \fIstr\fR, \fB\-\-pskfile\fR=\fIstr\fR
تعیین یک فایل کلید از پیش به‌اشتراک‌گذاشته‌شده (PSK).
.sp
این گزینه فایل کلید از پیش به‌اشتراک‌گذاشته‌شده را برای ذخیره کلیدهای تولیدشده مشخص می‌کند.
.TP
\fB\-\-passwd\fR
این گزینه یک نام مستعار برای گزینه
.B \-\-pskfile
است.
.sp
.B
توجه: این گزینه منسوخ شده است (DEPRECATED).
.TP
\fB\-v\fR \fIarg\fR, \fB\-\-version\fR=\fIarg\fR
نمایش نسخه برنامه و خروج. حالت پیش‌فرض
.RB ' v '
است که یک نسخه ساده است. حالت
.RB ' c '
اطلاعات کپی‌رایت را چاپ می‌کند و حالت
.RB ' n '
متن کامل اعلان کپی‌رایت را نمایش می‌دهد.
.TP
\fB\-h\fR, \fB\-\-help\fR
نمایش اطلاعات نحوه استفاده و خروج.
.TP
\fB\-!\fR, \fB\-\-more\-help\fR
انتقال اطلاعات گسترده نحوه استفاده از طریق یک صفحه‌بند (pager).
.SH "مثال‌ها (EXAMPLES)"
برای افزودن یک کاربر به نام
.RB ' psk_identity '
در فایل
.I keys.psk
جهت استفاده با GnuTLS، دستور زیر را اجرا کنید:
.br
.in +4
.nf
$ ./psktool \-u psk_identity \-p keys.psk
Generating a random key for user 'psk_identity'
Key stored to keys.psk
$ cat keys.psk
psk_identity:88f3824b3e5659f52d00e959bacab954b6540344
$
.in -4
.fi
.sp
این دستور در صورتی که فایل
.I keys.psk
وجود نداشته باشد آن را ایجاد کرده و کاربر
.RB ' psk_identity '
را اضافه می‌کند.
.SH "وضعیت خروج (EXIT STATUS)"
یکی از مقادیر خروج زیر بازگردانده خواهد شد:
.TP
.B 0 " (EXIT_SUCCESS)"
اجرای موفقیت‌آمیز برنامه.
.TP
.B 1 " (EXIT_FAILURE)"
عملیات ناموفق بود یا ساختار دستوری نامعتبر بود.
.SH "همچنین ببینید (SEE ALSO)"
.BR gnutls\-cli\-debug (1),
.BR gnutls\-serv (1),
.BR srptool (1),
.BR certtool (1)
.SH "نویسندگان (AUTHORS)"
توسعه‌دهندگان پروژه GnuTLS و همکاران.
.SH "کپی‌رایت (COPYRIGHT)"
کپی‌رایت \(co 2020-2023 بنیاد نرم‌افزار آزاد (Free Software Foundation) و دیگران. تمامی حقوق محفوظ است.
.br
این برنامه تحت شرایط مجوز عمومی همگانی گنو (GNU General Public License) نسخه ۳ یا جدیدتر منتشر شده است.
.SH "گزارش باگ‌ها (REPORTING BUGS)"
لطفاً گزارش‌های باگ و اشکال را به نشانی زیر ارسال کنید:
.br
bugs@gnutls.org