گزینه‌های زیردستور (Subcommand options)

--can-authenticate

افزودن یک زیرکلید با قابلیت احراز هویت

--can-encrypt=PURPOSE

افزودن یک زیرکلید با قابلیت رمزگذاری

زیرکلیدهای با قابلیت رمزگذاری می‌توانند مناسب برای رمزگذاری انتقال (transport)، رمزگذاری ذخیره‌سازی (storage)، یا هر دو، یعنی سراسری (universal) علامت‌گذاری شوند.

[مقادیر ممکن: transport، storage، universal]

--can-sign

افزودن یک زیرکلید با قابلیت امضا

--cannot-authenticate

عدم افزودن زیرکلید با قابلیت احراز هویت

--cannot-encrypt

عدم افزودن زیرکلید با قابلیت رمزگذاری

--cannot-sign

عدم افزودن زیرکلید با قابلیت امضا

--cert=FINGERPRINT|KEYID

استفاده از گواهی‌های دارای اثرانگشت یا شناسه کلید مشخص‌شده

--cert-email=EMAIL

استفاده از گواهی‌هایی که شناسهٔ کاربری آن‌ها شامل آدرس ایمیل مشخص‌شده باشد

--cert-file=PATH

خواندن گواهی‌ها از PATH

--cert-userid=USERID

استفاده از گواهی‌های دارای شناسهٔ کاربری مشخص‌شده

--cipher-suite=CIPHER-SUITE

انتخاب الگوریتم‌های رمزنگاری برای کلید

مقدار پیش‌فرض را می‌توان در فایل پیکربندی با استفاده از تنظیم `key.generate.cipher-suite` تغییر داد.

[پیش‌فرض: cv25519]

[مقادیر ممکن: rsa2k، rsa3k، rsa4k، cv25519، cv448، mldsa65-ed25519، mldsa87-ed448]

--expiration=EXPIRATION

تنظیم زمان انقضا

مقدار EXPIRATION یا یک تاریخ قالب‌بندی‌شده بر اساس ISO 8601 همراه با زمان اختیاری است یا یک مدت‌زمان سفارشی. مدت‌زمان به‌صورت `N[ymwds]` مشخص می‌شود که حروف آن به‌ترتیب نشان‌دهندهٔ سال، ماه، هفته، روز و ثانیه هستند. همچنین، کلمهٔ کلیدی `never` هیچ زمان انقضایی تعیین نمی‌کند.

[پیش‌فرض: 3y]

--new-password-file=PASSWORD_FILE

فایل حاوی گذرواژه برای رمزگذاری داده‌های کلید محرمانه

توجه داشته باشید که کل فایل کلید به‌عنوان گذرواژه استفاده خواهد شد، از جمله هرگونه فاصله خالی پیرامون آن مانند نویسهٔ خط جدید پایانی.

--output=FILE

نوشتن کلید در فایل مشخص‌شده

در صورت مشخص نشدن، کلید در مخزن کلید ذخیره می‌شود.

--own-key

علامت‌گذاری کلید به‌عنوان کلید شخصی خود

کلید تازه‌تولیدشده با تمامی شناسه‌های کاربری‌اش، به‌عنوان احرازهویت‌شده و یک معرفی‌کنندهٔ کاملاً مورد اعتماد علامت‌گذاری خواهد شد.

--profile=PROFILE

انتخاب استاندارد OpenPGP برای کلید

با تکامل OpenPGP، نسخه‌های جدیدی در دسترس قرار خواهند گرفت. این گزینه نسخهٔ OpenPGP مورد استفاده برای کلید تازه‌تولیدشده را انتخاب می‌کند.

در حال حاضر sq فقط از یک نسخه پشتیبانی می‌کند: RFC4880. در نتیجه، این نسخه پیش‌فرض است. با این حال، نسخهٔ جدیدتری از این استاندارد با نام RFC9580 وجود دارد، و مقدار پیش‌فرض در نسخه‌های آیندهٔ sq تغییر خواهد کرد.

مقدار پیش‌فرض را می‌توان در فایل پیکربندی با استفاده از تنظیم `key.generate.profile` تغییر داد.

[پیش‌فرض: rfc4880]

[مقادیر ممکن: rfc9580، rfc4880]

--retire-in=TIME

تنظیم زمانی که گواهی باید بازنشسته شود

مقدار TIME یا یک تاریخ با قالب‌بندی ISO 8601 همراه با زمان اختیاری است یا یک مدت‌زمان سفارشی. مدت‌زمان به‌شکل `N[ymwds]` مشخص می‌شود که حروف آن به‌ترتیب نشان‌دهندهٔ سال، ماه، هفته، روز و ثانیه هستند. به‌طور جایگزین، کلمهٔ کلیدی `never` از صدور گواهی ابطال صرف‌نظر می‌کند.

[پیش‌فرض: 26w]

--rev-cert=FILE

نوشتن گواهی ابطال اضطراری در FILE

هنگامی که کلید در مخزن کلید ذخیره می‌شود، گواهی ابطال به‌طور پیش‌فرض در $HOME/.local/share/sequoia/revocation-certificates نگهداری می‌شود.

هنگامی که `--output` مشخص شده باشد، گواهی ابطال در فایل تعیین‌شده توسط `--rev-cert` نوشته می‌شود.

اگر `--output` برابر با `-` باشد، این گزینه نباید `-` باشد.

--shared-key

علامت‌گذاری کلید به‌عنوان کلید اشتراکی

کلید تازه‌تولیدشده با تمامی شناسه‌های کاربری‌اش، به‌عنوان احرازهویت‌شده علامت‌گذاری می‌شود، اما نه به‌عنوان معرفی‌کنندهٔ معتمد. علاوه بر این، فرادادهٔ کلید مشخص خواهد کرد که این یک کلید اشتراکی است.

اگر قصد دارید این کلید را با دیگران به اشتراک بگذارید، از این گزینه استفاده کنید. در شرایط عادی نباید داده‌های کلید را به اشتراک بگذارید. نمونه‌ای که ممکن است بخواهید این کار را انجام دهید، یک صندوق پستی مشترک است.

--without-password

عدم محافظت از محتوای کلید محرمانه با گذرواژه

گزینه‌های سراسری (Global options)

برای شرح گزینه‌های سراسری sq(1) را ببینید.