.TH SQ 1 1.4.0 "Sequoia PGP" "دستورات کاربر"
.SH "نام (NAME)"
sq\-decrypt \- رمزگشایی یک پیام
.SH "خلاصه دستور (SYNOPSIS)"
.br
\fBsq decrypt\fR [\fIگزینه‌ها\fR] \fIپرونده\fR
.SH "توضیحات (DESCRIPTION)"
رمزگشایی یک پیام.
.PP
رمزگشایی یک پیام با استفاده از کلیدهای ارائه‌شده یا از طریق درخواست گذرواژه. اگر دستکاری در پیام تشخیص داده شود، یک خطا برگردانده می‌شود. برای جزئیات به بخش‌های زیر مراجعه کنید.
.PP
اگر گواهی‌ها با استفاده از گزینه
.B \-\-signer\-file
ارائه شوند، هر امضایی که یافت شود با استفاده از این گواهی‌ها بررسی می‌گردد. اعتبارسنجی تنها در صورتی موفقیت‌آمیز است که هیچ امضای نامعتبری وجود نداشته باشد و تعداد امضاهای با موفقیت اعتبارسنجی‌شده به آستانه پیکربندی‌شده با پارامتر
.B \-\-signatures
برسد.
.PP
اگر اعتبارسنجی امضا ناموفق باشد یا دستکاری در پیام تشخیص داده شود، برنامه با وضعیت خروجی نشان‌دهنده شکست خاتمه می‌یابد و فایل خروجی حذف می‌شود. اگر خروجی به خروجی استاندارد (stdout) ارسال شده باشد، ۲۵ مبی‌بایت (MiB) پایانی پیام نگه داشته می‌شود (در نتیجه اگر پیام کوچکتر از ۲۵ مبی‌بایت باشد، هیچ خروجی تولید نمی‌شود).
.PP
عملیات معکوس این دستور،
.B sq encrypt
است.
.SH "گزینه‌ها (OPTIONS)"
.SS "گزینه‌های زیردستور (Subcommand options)"
.TP
\fB\-\-dump\-session\-key\fR
چاپ کلید نشست (session key) در خطای استاندارد (stderr)
.TP
\fB\-\-output\fR=\fIپرونده\fR
نوشتن در پرونده، یا در صورت حذف، در خروجی استاندارد (stdout)
.IP
[پیش‌فرض: \fB\-\fR]
.TP
\fB\-\-recipient\-file\fR=\fIفایل_کلید\fR
رمزگشایی پیام با استفاده از کلید موجود در فایل_کلید
.TP
\fB\-\-session\-key\fR=\fIکلید_نشست\fR
رمزگشایی یک پیام رمزگذاری‌شده با استفاده از کلید_نشست
.TP
\fB\-\-signatures\fR=\fIN\fR
تنظیم آستانه امضاهای معتبر بر روی N
.IP
پیام تنها در صورتی معتبر در نظر گرفته می‌شود که این آستانه برآورده شود. [پیش‌فرض: ۱ اگر حداقل یک فایل گواهی امضاکننده داده شده باشد، در غیر این صورت ۰]
.TP
\fB\-\-signer\fR=\fIاثرانگشت|شناسه_کلید\fR
نیاز به امضا از یک گواهی با اثرانگشت (fingerprint) یا شناسه کلید (key ID) مشخص‌شده
.TP
\fB\-\-signer\-domain\fR=\fIدامنه\fR
نیاز به امضا از گواهی‌ای که در آن شناسه کاربری شامل یک آدرس ایمیل برای دامنه مشخص‌شده باشد
.TP
\fB\-\-signer\-email\fR=\fIرایانامه\fR
نیاز به امضا از گواهی‌ای که در آن شناسه کاربری شامل نشانی ایمیل مشخص‌شده باشد
.TP
\fB\-\-signer\-file\fR=\fIمسیر\fR
نیاز به امضا از یک گواهی خوانده‌شده از مسیر
.TP
\fB\-\-signer\-userid\fR=\fIشناسه_کاربری\fR
نیاز به امضا از یک گواهی با شناسه کاربری مشخص‌شده
.TP
\fIپرونده\fR
خواندن از پرونده، یا در صورت \fB\-\fR بودن پرونده، از ورودی استاندارد (stdin)
.IP
[پیش‌فرض: \fB\-\fR]
.SS "گزینه‌های عمومی (Global options)"
برای توضیحات گزینه‌های عمومی،
.BR sq (1)
را ببینید.
.SH "مثال‌ها (EXAMPLES)"
.PP
رمزگشایی یک فایل با استفاده از کلید مخفی:
.RS
.nf
sq decrypt \-\-recipient\-file juliet\-secret.pgp ciphertext.pgp
.fi
.RE
.PP
رمزگشایی یک فایل همراه با اعتبارسنجی امضاها:
.RS
.nf
sq decrypt \-\-recipient\-file juliet\-secret.pgp \-\-signer\-file \e
  romeo.pgp ciphertext.pgp
.fi
.RE
.PP
رمزگشایی یک فایل با استفاده از مخزن کلید:
.RS
.nf
sq decrypt ciphertext.pgp
.fi
.RE
.SH "همچنین ببینید (SEE ALSO)"
.nh
\fBsq\fR(1).
.hy
.PP
برای مستندات کامل به <https://book.sequoia\-pgp.org> مراجعه کنید.
.SH "نسخه (VERSION)"
1.4.0