.TH SQ 1 1.4.0 "Sequoia PGP" "User Commands"
.SH "نام (NAME)"
sq\-encrypt \- رمزنگاری یک پیام
.SH "خلاصه دستور (SYNOPSIS)"
.br
\fBsq encrypt\fR [\fIOPTIONS\fR] \fIFILE\fR
.SH "توضیحات (DESCRIPTION)"
رمزنگاری یک پیام.
.PP
رمزنگاری یک پیام برای هر تعداد گیرنده و با هر تعداد گذرواژه، همراه با امکان امضا کردن اختیاری پیام در حین فرایند.
.PP
عملیات معکوس آن `sq decrypt` است.
.PP
دستور `sq encrypt` به زمان مرجع تعیین‌شده توسط آرگومان سطح بالای `\-\-time` احترام می‌گذارد. این دستور هنگام انتخاب کلیدهای رمزنگاری از زمان مرجع استفاده می‌کند، و زمان ایجاد امضا را نیز روی زمان مرجع تنظیم می‌نماید.
.PP


.SH "گزینه‌ها (OPTIONS)"
.SS "گزینه‌های زیردستور (Subcommand options)"
.TP
\fB\-\-binary\fR
تولید داده‌های دودویی
.TP
\fB\-\-compression\fR=\fIKIND\fR
انتخاب روش فشرده‌سازی مورد استفاده
.IP
[پیش‌فرض: \fBpad\fR]
.IP
[مقادیر ممکن: \fBnone\fR، \fBpad\fR، \fBzip\fR، \fBzlib\fR، \fBbzip2\fR]
.TP
\fB\-\-encrypt\-for\fR=\fIPURPOSE\fR
انتخاب نوع کلیدهایی که برای رمزنگاری در نظر گرفته می‌شوند
.IP
[پیش‌فرض: \fBuniversal\fR]
.IP
[مقادیر ممکن: \fBtransport\fR، \fBstorage\fR، \fBuniversal\fR]
.TP
\fB\-\-for\fR=\fIFINGERPRINT|KEYID\fR
استفاده از گواهی‌های دارای اثرانگشت یا شناسه کلید مشخص‌شده
.TP
\fB\-\-for\-email\fR=\fIEMAIL\fR
استفاده از گواهی‌هایی که شناسه کاربری آن‌ها شامل نشانی رایانامه مشخص‌شده است
.TP
\fB\-\-for\-file\fR=\fIPATH\fR
خواندن گواهی‌ها از PATH
.TP
\fB\-\-for\-self\fR
رمزنگاری پیام برای خودتان
.IP
این گزینه گواهی‌های فهرست‌شده در فایل پیکربندی ذیل `encrypt.for\-self` را به فهرست گیرندگان اضافه می‌کند. این ویژگی می‌تواند برای اطمینان از اینکه خودتان هم قادر به رمزگشایی پیام خواهید بود استفاده شود.
.IP
در حال حاضر، فهرست گواهی‌هایی که باید اضافه شوند خالی است.

.TP
\fB\-\-for\-userid\fR=\fIUSERID\fR
استفاده از گواهی‌های دارای شناسه کاربری مشخص‌شده
.TP
\fB\-\-output\fR=\fIFILE\fR
نوشتن در FILE یا خروجی استاندارد (stdout) در صورت عدم تعیین
.IP
[پیش‌فرض: \fB\-\fR]
.TP
\fB\-\-profile\fR=\fIPROFILE\fR
انتخاب استاندارد پیش‌فرض OpenPGP برای ظرف رمزنگاری
.IP
هنگام رمزنگاری برای گواهی‌ها، ظرف رمزنگاری بر اساس ترجیحات اعلام‌شدهٔ گیرندگان انتخاب می‌شود. با این حال، اگر هیچ راهنمایی وجود نداشته باشد، به عنوان مثال به این دلیل که پیام تنها با گذرواژه‌ها رمزنگاری شده است، sq به این نمایه بازمی‌گردد.
.IP
با تکامل OpenPGP، نسخه‌های جدیدتری در دسترس قرار می‌گیرند. این گزینه نسخهٔ OpenPGP مورد استفاده برای رمزنگاری پیام‌ها را در صورتی که نسخه به شکل دیگری قابل تشخیص نباشد، انتخاب می‌کند.
.IP
در حال حاضر، sq از دو نمایه پشتیبانی می‌کند: RFC9580 و RFC4880. هم‌اکنون مقدار پیش‌فرض RFC4880 است. با این حال، هنگامی که پشتیبانی از RFC9580 بیشتر گسترش یابد، پیش‌فرض در نسخه‌های آیندهٔ sq تغییر خواهد کرد.
.IP
پیش‌فرض را می‌توان در فایل پیکربندی با استفاده از تنظیم `key.generate.profile` تغییر داد.
.IP
[پیش‌فرض: \fBrfc4880\fR]
.IP
[مقادیر ممکن: \fBrfc9580\fR، \fBrfc4880\fR]
.TP
\fB\-\-set\-metadata\-filename\fR=\fISET_METADATA_FILENAME\fR
تنظیم نام فایلِ فایل رمزنگاری‌شده به عنوان فراداده
.IP
توجه داشته باشید که این فراداده امضا نشده است و از این رو اتکا به آن \- چه در سمت فرستنده و چه در سمت گیرنده \- معمولاً خطرناک تلقی می‌شود.
.TP
\fB\-\-signature\-notation\fR \fINAME\fR \fIVALUE\fR
افزودن یک نشانه‌گذاری به امضا
.IP
نام یک نشانه‌گذاری تعریف‌شده توسط کاربر باید به شکل `name@a.domain.you.control.org` باشد. اگر نام نشانه‌گذاری با یک `!` آغاز شود، نشانه‌گذاری به عنوان حیاتی (critical) علامت‌گذاری می‌شود. چنانچه پردازش‌کنندهٔ امضا یک نشانه‌گذاری حیاتی را متوجه نشود، امضا را نادیده خواهد گرفت. این نشانه‌گذاری به عنوان خوانا برای انسان مشخص می‌شود.
.TP
\fB\-\-signer\fR=\fIFINGERPRINT|KEYID\fR
امضای پیام با استفاده از کلید دارای اثرانگشت یا شناسه کلید مشخص‌شده
.TP
\fB\-\-signer\-email\fR=\fIEMAIL\fR
امضای پیام با استفاده از کلیدی که شناسه کاربری آن شامل نشانی رایانامه مشخص‌شده است
.TP
\fB\-\-signer\-file\fR=\fIPATH\fR
امضای پیام با استفاده از کلید خوانده‌شده از PATH
.TP
\fB\-\-signer\-self\fR
امضا با استفاده از کلیدهای امضاکننده پیش‌فرض خودتان
.IP
این گزینه گواهی‌های فهرست‌شده در فایل پیکربندی ذیل `sign.signer\-self` را به فهرست کلیدهای امضاکننده اضافه می‌کند.
.IP
در حال حاضر، فهرست کلیدهایی که باید اضافه شوند خالی است.

.TP
\fB\-\-signer\-userid\fR=\fIUSERID\fR
امضای پیام با استفاده از کلید دارای شناسه کاربری مشخص‌شده
.TP
\fB\-\-use\-expired\-subkey\fR
استفاده جایگزین از زیرکلیدهای رمزنگاری منقضی‌شده
.IP
اگر یک گواهی فقط دارای زیرکلیدهای منقضی‌شده با قابلیت رمزنگاری باشد، به عنوان جایگزین از زیرکلیدی که دیرتر از همه منقضی شده است استفاده می‌شود
.TP
\fB\-\-with\-password\fR
درخواست اعلان برای وارد کردن گذرواژه‌ای جهت رمزنگاری
.IP
هنگام استفاده از این گزینه، از کاربر خواسته می‌شود تا گذرواژه‌ای وارد کند که برای رمزنگاری پیام استفاده خواهد شد. این گزینه می‌تواند بیش از یک بار مشخص شود تا چندین گذرواژه تعیین گردد. داده‌های رمزنگاری‌شده پس از آن می‌توانند با هر یک از کلیدهای گیرنده یا هر یک از گذرواژه‌های ارائه‌شده رمزگشایی شوند.
.TP
\fB\-\-with\-password\-file\fR=\fIPATH\fR
فایل حاوی گذرواژه برای رمزنگاری پیام
.IP
توجه داشته باشید که کل فایل به عنوان گذرواژه استفاده خواهد شد، از جمله هرگونه فضای خالی اطراف مانند خط جدید پایانی.
.IP
این گزینه می‌تواند بیش از یک بار مشخص شود تا چندین گذرواژه تعیین گردد. داده‌های رمزنگاری‌شده پس از آن می‌توانند با هر یک از کلیدهای گیرنده یا هر یک از گذرواژه‌های ارائه‌شده رمزگشایی شوند.
.TP
\fB\-\-without\-signature\fR
عدم امضای پیام
.TP
 \fIFILE\fR
خواندن از FILE یا ورودی استاندارد (stdin) در صورتی که FILE مقدار '\-' باشد
.IP
[پیش‌فرض: \fB\-\fR]
.SS "گزینه‌های عمومی (Global options)"
برای شرح گزینه‌های عمومی، \fBsq\fR(1) را ببینید.
.SH "مثال‌ها (EXAMPLES)"
.PP

.PP
رمزنگاری یک فایل برای گیرنده‌ای که با اثرانگشت مشخص شده است.
.PP
.nf
.RS
sq encrypt \-\-for=EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \\
.RE
.RS
.RS
\-\-signer\-email=juliet@example.org document.txt
.RE
.RE
.PP
.fi

.PP
رمزنگاری یک فایل برای گیرنده‌ای که با رایانامه مشخص شده است.
.PP
.nf
.RS
sq encrypt \-\-for\-email=alice@example.org \\
.RE
.RS
.RS
\-\-signer\-email=juliet@example.org document.txt
.RE
.RE
.fi
.SH "همچنین ببینید (SEE ALSO)"
.nh
\fBsq\fR(1).
.hy
.PP
برای مستندات کامل، <https://book.sequoia\-pgp.org> را ببینید.
.SH "نسخه (VERSION)"
1.4.0