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

--allow-non-canonical-userids

شناسه‌های کاربری که در قالب متعارف (canonical) نیستند را رد نمی‌کند

شناسه‌های کاربری متعارف به شکل `Name (Comment) <localpart@example.org>` هستند.

--can-authenticate

افزودن یک زیرکلید با قابلیت احراز هویت (پیش‌فرض)

--can-encrypt=PURPOSE

افزودن یک زیرکلید با قابلیت رمزنگاری [پیش‌فرض: universal]

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

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

--can-sign

افزودن یک زیرکلید با قابلیت امضا (پیش‌فرض)

--cannot-authenticate

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

--cannot-encrypt

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

--cannot-sign

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

--cipher-suite=CIPHER-SUITE

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

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

[پیش‌فرض: cv25519]

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

--email=ADDRESS

افزودن یک نشانی رایانامه (ایمیل) به عنوان شناسه کاربر به کلید

--encryption-algorithm=ALGORITHM

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

در صورت تعیین، این الگوریتم برای کلیدهای با قابلیت رمزنگاری استفاده می‌شود. این پارامتر بر پارامتر مجموعه‌رمز (cipher suite) اولویت دارد.

[مقادیر ممکن: rsa2k, rsa3k, rsa4k, elgamal2k, elgamal3k, cv25519, x25519, x448, nistp256, nistp384, nistp521, brainpoolp256, brainpoolp384, brainpoolp512, mlkem768-x25519, mlkem1024-x448]

--expiration=EXPIRATION

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

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

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

--name=NAME

افزودن یک نام به عنوان شناسه کاربر به کلید

--new-password-file=PASSWORD_FILE

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

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

--no-userids

ایجاد یک کلید بدون هیچ شناسه کاربری

--output=FILE

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

در صورت عدم تعیین، کلید در مخزن کلید (key store) ذخیره می‌شود.

--own-key

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

کلید تازه‌تولیدشده به همراه تمام شناسه‌های کاربری‌اش به عنوان احراز هویت‌شده و به عنوان یک معرفی‌کننده کاملاً مورد اعتماد (fully trusted introducer) علامت‌گذاری می‌شود.

--profile=PROFILE

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

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

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

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

[پیش‌فرض: rfc4880]

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

--rev-cert=FILE

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

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

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

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

--shared-key

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

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

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

--signing-algorithm=ALGORITHM

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

در صورت تنظیم، این الگوریتم برای کلیدهای مورد استفاده برای امضا به کار می‌رود. این شامل کلیدهای دارای قابلیت امضا، احراز هویت و صدور گواهی است. این پارامتر بر پارامتر مجموعه‌رمز (cipher suite) اولویت دارد.

[مقادیر ممکن: rsa2k, rsa3k, rsa4k, dsa2k, dsa3k, cv25519, ed25519, ed448, nistp256, nistp384, nistp521, brainpoolp256, brainpoolp384, brainpoolp512, mldsa65-ed25519, mldsa87-ed448, slhdsa128s, slhdsa128f, slhdsa256s]

--userid=USERID

افزودن یک شناسه کاربر به کلید

این شناسه کاربر می‌تواند نام و نشانی رایانامه را با هم ترکیب کند، می‌تواند به صورت اختیاری شامل یک توضیح (comment) باشد، یا حتی در صورت استفاده از `--allow-non-canonical-userids` به شکل آزاد باشد. با این حال، استدلال و تصمیم‌گیری درباره شناسه‌های کاربری که حاوی اطلاعات متفاوتی مانند نام و نشانی رایانامه هستند دشوارتر است، بنابراین امروزه استفاده از شناسه‌های کاربری مجزا برای نام و نشانی رایانامه ترجیح داده می‌شود.

در صورت تردید، استفاده از `--name` و `--email` را ترجیح دهید.

--without-password

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

گزینه‌های عمومی (Global options)

برای شرح گزینه‌های عمومی، sq(1) را ببینید.