نام (NAME)

openssl-dsaparam - مدیریت و دستکاری پارامترهای الگوریتم DSA

خلاصه دستور (SYNOPSIS)

openssl dsaparam [-help] [-inform DER|PEM] [-outform DER|PEM] [-in filename] [-out filename] [-noout] [-text] [-genkey] [-verbose] [-quiet] [-rand files] [-writerand file] [-engine id] [-provider name] [-provider-path path] [-provparam [name:]key=value] [-propquery propq] [numbits] [numqbits]

توضیحات (DESCRIPTION)

این دستور برای مدیریت، دستکاری یا تولید فایل‌های پارامتر DSA به کار می‌رود.

تولید پارامترهای DSA می‌تواند فرآیندی زمان‌بر و کُند باشد و در نتیجه اغلب از یک مجموعه پارامتر یکسان برای تولید چندین کلید مجزا استفاده می‌شود.

گزینه‌ها (OPTIONS)

-help

نمایش پیام راهنمای نحوه استفاده از دستور.

-inform DER|PEM

قالب ورودی پارامترهای DSA؛ به‌طور پیش‌فرض تعیین نشده است. برای جزئیات بیشتر به openssl-format-options(1) مراجعه کنید.

-outform DER|PEM

قالب خروجی پارامترهای DSA؛ پیش‌فرض PEM است. برای جزئیات بیشتر به openssl-format-options(1) مراجعه کنید.

پارامترها توالی‌ای از مقادیر ASN.1 INTEGER هستند: p، q و g. این ساختار با ساختار DSS-Parms در RFC 2459 سازگار است.

-in filename

این گزینه فایل ورودی را برای خواندن پارامترها مشخص می‌کند؛ در صورت عدم تعیین این گزینه، از ورودی استاندارد استفاده می‌شود. اگر آرگومان numbits مشخص شده باشد، این گزینه نادیده گرفته خواهد شد.

-out filename

این گزینه فایل خروجی را برای نوشتن پارامترها مشخص می‌کند. در صورت عدم تعیین این گزینه، از خروجی استاندارد استفاده می‌شود. نام فایل خروجی می‌تواند همان نام فایل ورودی باشد که در این صورت محتوای فایل جایگزین خواهد شد. توجه داشته باشید که ورودی/خروجی فایل اتمیک (Atomic) نیست؛ فایل خروجی ابتدا خالی (Truncate) شده و سپس در آن نوشته می‌شود.

-noout

این گزینه از چاپ و تولید نسخه کُدگذاری‌شده پارامترها در خروجی جلوگیری می‌کند.

-text

این گزینه پارامترهای DSA را در قالبی خوانا برای انسان چاپ می‌کند.

-genkey

این گزینه یک کلید DSA را با استفاده از پارامترهای مشخص‌شده یا پارامترهای تولیدشده ایجاد می‌کند.

-verbose

چاپ جزئیات بیشتر درباره عملیات‌های در حال انجام.

-quiet

چاپ جزئیات کمتر درباره عملیات‌های در حال انجام؛ این قابلیت می‌تواند در اسکریپت‌های دسته‌ای (Batch) و خطوط لوله (Pipelines) سودمند باشد.

-rand files, -writerand file

برای جزئیات بیشتر به بخش «Random State Options» در openssl(1) مراجعه کنید.

-engine id

به بخش «Engine Options» در openssl(1) مراجعه کنید. این گزینه منسوخ شده است.

numbits

این آرگومان اختیاری مشخص می‌کند که یک مجموعه پارامتر با اندازه numbits تولید شود. در صورت ارائه این آرگومان، فایل ورودی (در صورت وجود) نادیده گرفته می‌شود.

numqbits

این آرگومان اختیاری مشخص می‌کند که مجموعه پارامترها با یک پارامتر زیر‌اول (Subprime) به نام q با اندازه numqbits تولید شود. این مورد باید آخرین آرگومان باشد. در صورت ارائه این آرگومان، فایل ورودی (در صورت وجود) نادیده گرفته می‌شود.

-provider name

-provider-path path

-provparam [name:]key=value

-propquery propq

به بخش «Provider Options» در openssl(1)، provider(7) و property(7) مراجعه کنید.

همچنین ببینید (SEE ALSO)

openssl(1), openssl-pkeyparam(1), openssl-gendsa(1), openssl-dsa(1), openssl-genrsa(1), openssl-rsa(1)

تاریخچه (HISTORY)

گزینه -engine در OpenSSL 3.0 منسوخ شد.

گزینه -C در OpenSSL 3.0 حذف شد.

حق نشر (COPYRIGHT)

حق نشر ۲۰۰۰-۲۰۲۳ نویسندگان پروژه OpenSSL. تمامی حقوق محفوظ است.

تحت مجوز آپاچی، نسخه ۲.۰ («مجوز») منتشر شده است. استفاده از این فایل تنها بر اساس شرایط و مقررات مندرج در مجوز مجاز است. شما می‌توانید نسخه‌ای از مجوز را در فایل LICENSE در توزیع منبع یا در نشانی زیر دریافت کنید:

https://www.openssl.org/source/license.html