.TH SQ 1 1.4.0 "Sequoia PGP" "User Commands"
.SH "نام (NAME)"
sq\-key\-subkey\-add \- افزودن یک زیرکلید جدید به یک گواهی
.SH "خلاصه دستور (SYNOPSIS)"
.br
\fBsq key subkey add\fR [\fIگزینه‌ها\fR]
.SH "توضیحات (DESCRIPTION)"
افزودن یک زیرکلید جدید به یک گواهی.
.PP
یک زیرکلید دارای یک یا چند قابلیت است.
.PP
گزینه
.B \-\-can\-sign
قابلیت امضا را تنظیم می‌کند و به این معناست که کلید می‌تواند برای امضا استفاده شود. گزینه
.B \-\-can\-authenticate
قابلیت اصالت‌سنجی را تنظیم می‌کند و به این معناست که کلید می‌تواند برای احراز هویت (مثلاً به عنوان کلید SSH) استفاده شود. گزینه
.B \-\-can\-certify
قابلیت صدور گواهی را تنظیم می‌کند و به این معناست که کلید می‌تواند برای صدور تاییدیه‌های شخص ثالث استفاده شود. این قابلیت‌ها را می‌توان با یکدیگر ترکیب کرد.
.PP
مقدار
.B \-\-can\-encrypt=storage
قابلیت رمزنگاری ذخیره‌سازی را تنظیم می‌کند و به این معناست که کلید می‌تواند برای رمزنگاری داده‌های ذخیره‌شده استفاده شود. مقدار
.B \-\-can\-encrypt=transport
قابلیت رمزنگاری انتقال را تنظیم می‌کند و به این معناست که کلید می‌تواند برای رمزنگاری انتقال داده استفاده شود. مقدار
.B \-\-can\-encrypt=universal
هر دو قابلیت رمزنگاری ذخیره‌سازی و انتقال را تنظیم می‌کند و به این معناست که کلید می‌تواند برای هر دو نوع رمزنگاری استفاده شود. قابلیت‌های رمزنگاری نباید با قابلیت‌های امضا یا اصالت‌سنجی ترکیب شوند.
.PP
به‌طور معمول، دستور
.B sq
از کاربر گذرواژه‌ای برای رمزنگاری داده‌های کلید خصوصی درخواست می‌کند. گذرواژه زیرکلید جدید می‌تواند با سایر کلیدها متفاوت باشد. هنگام استفاده از
.BR \-\-without\-password ،
دستور
.B sq
گذرواژه‌ای درخواست نمی‌کند و از زیرکلید با گذرواژه محافظت نخواهد کرد.
.PP
به‌طور پیش‌فرض، یک زیرکلید جدید خودبه‌خود منقضی نمی‌شود. با این حال، دوره اعتبار آن توسط گواهی محدود می‌شود. استفاده از آرگومان
.B \-\-expiration
امکان تنظیم زمان انقضای متفاوتی را فراهم می‌کند.
.PP
دستور
.B sq key subkey add
از زمان مرجع تعیین‌شده توسط آرگومان سطح بالای
.B \-\-time
پیروی می‌کند. این دستور زمان ساخت زیرکلید را روی زمان مشخص‌شده قرار می‌دهد.
.SH "گزینه‌ها (OPTIONS)"
.SS "گزینه‌های زیردستور (Subcommand options)"
.TP
\fB\-\-can\-authenticate\fR
افزودن یک زیرکلید با قابلیت اصالت‌سنجی
.TP
\fB\-\-can\-encrypt\fR=\fIPURPOSE\fR
افزودن یک زیرکلید با قابلیت رمزنگاری [پیش‌فرض: universal]
.IP
زیرکلیدهای دارای قابلیت رمزنگاری را می‌توان برای رمزنگاری انتقال، رمزنگاری ذخیره‌سازی، یا هر دو، یعنی عمومی (universal) مشخص کرد.
.IP
[مقادیر مجاز: \fBtransport\fR, \fBstorage\fR, \fBuniversal\fR]
.TP
\fB\-\-can\-sign\fR
افزودن یک زیرکلید با قابلیت امضا
.TP
\fB\-\-cert\fR=\fIFINGERPRINT|KEYID\fR
افزودن یک زیرکلید به کلید با اثرانگشت یا شناسه کلید مشخص‌شده
.TP
\fB\-\-cert\-email\fR=\fIEMAIL\fR
افزودن یک زیرکلید به کلیدی که یک شناسه کاربری آن شامل آدرس رایانامه مشخص‌شده است
.TP
\fB\-\-cert\-file\fR=\fIPATH\fR
افزودن یک زیرکلید به کلید خوانده‌شده از PATH
.TP
\fB\-\-cert\-userid\fR=\fIUSERID\fR
افزودن یک زیرکلید به کلید با شناسه کاربری مشخص‌شده
.TP
\fB\-\-cipher\-suite\fR=\fICIPHER\-SUITE\fR
انتخاب الگوریتم‌های رمزنگاری برای زیرکلید
.IP
مقدار پیش‌فرض را می‌توان در فایل پیکربندی با استفاده از تنظیم `key.generate.cipher\-suite` تغییر داد.
.IP
[پیش‌فرض: \fBcv25519\fR]
.IP
[مقادیر مجاز: \fBrsa2k\fR, \fBrsa3k\fR, \fBrsa4k\fR, \fBcv25519\fR, \fBcv448\fR, \fBmldsa65\-ed25519\fR, \fBmldsa87\-ed448\fR]
.TP
\fB\-\-expiration\fR=\fIEXPIRATION\fR
تنظیم زمان انقضا
.IP
مقدار EXPIRATION یا یک تاریخ در قالب ISO 8601 همراه با زمان اختیاری است یا یک مدت‌زمان سفارشی. یک مدت‌زمان به شکل `N[ymwds]` است که در آن حروف به ترتیب نشان‌دهنده سال، ماه، هفته، روز و ثانیه هستند. همچنین، کلمه کلیدی `never` هیچ زمان انقضایی تنظیم نمی‌کند.
.IP
[پیش‌فرض: \fBnever\fR]
.TP
\fB\-\-new\-password\-file\fR=\fIPASSWORD_FILE\fR
فایل حاوی گذرواژه برای رمزنگاری داده‌های کلید خصوصی
.IP
توجه داشته باشید که کل فایل به عنوان گذرواژه استفاده خواهد شد، از جمله هرگونه نویسه فاصله مانند خط جدید پایانی.
.TP
\fB\-\-output\fR=\fIFILE\fR
نوشتن در FILE مشخص‌شده
.IP
اگر مشخص نشود و گواهی از مخزن گواهی‌ها خوانده شده باشد، گواهی تغییریافته را در مخزن کلید وارد می‌کند. اگر مشخص نشود و گواهی از یک فایل خوانده شده باشد، گواهی تغییریافته را در stdout می‌نویسد.
.TP
\fB\-\-without\-password\fR
محافظت نکردن از داده‌های کلید خصوصی زیرکلید با گذرواژه
.SS "گزینه‌های عمومی (Global options)"
برای مشاهده شرح گزینه‌های عمومی، \fBsq\fR(1) را ببینید.
.SH "مثال‌ها (EXAMPLES)"
.PP
افزودن یک زیرکلید جدید با قابلیت امضا به کلید Alice.
.PP
.nf
.RS
sq key subkey add \-\-can\-sign \\
.RE
.RS
.RS
\-\-cert=EB28F26E2739A4870ECC47726F0073F60FD0CBF0
.RE
.RE
.fi
.SH "همچنین ببینید (SEE ALSO)"
.nh
\fBsq\fR(1), \fBsq\-key\fR(1), \fBsq\-key\-subkey\fR(1).
.hy
.PP
برای مستندات کامل به <https://book.sequoia\-pgp.org> مراجعه کنید.
.SH "نسخه (VERSION)"
1.4.0