OPENSSL-ECPARAM(1ssl)               OpenSSL              OPENSSL-ECPARAM(1ssl)


نام (NAME)
       openssl-ecparam - دستکاری و تولید پارامترهای EC (خم بیضوی)

خلاصه دستور (SYNOPSIS)
       openssl ecparam [-help] [-inform DER|PEM] [-outform DER|PEM] [-in
       filename] [-out filename] [-noout] [-text] [-check] [-check_named]
       [-name arg] [-list_curves] [-conv_form arg] [-param_enc arg] [-no_seed]
       [-genkey] [-engine id] [-rand files] [-writerand file] [-provider name]
       [-provider-path path] [-provparam [name:]key=value] [-propquery propq]

توضیحات (DESCRIPTION)
       این دستور برای دستکاری یا تولید فایل‌های پارامتر EC (خم بیضوی) به کار
       می‌رود.

       اوپن‌اس‌اس‌ال در حال حاضر قادر به تولید گروه‌های جدید نیست و از این رو این
       دستور تنها می‌تواند پارامترهای EC را از خم‌های شناخته‌شده (نام‌گذاری‌شده)
       ایجاد کند.

گزینه‌ها (OPTIONS)
       -help
           پیام راهنمای نحوهٔ استفاده از دستور را نمایش می‌دهد.

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

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

           پارامترها همان‌طور که در RFC 3279 از IETF مشخص شده، به عنوان
           EcpkParameters کدگذاری می‌شوند.

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

       -out filename
           نام فایل خروجی را برای نوشتن پارامترها مشخص می‌کند. در صورت عدم حضور
           این گزینه از خروجی استاندارد استفاده می‌شود.  نام فایل خروجی می‌تواند
           با نام فایل ورودی یکسان باشد که منجر به جایگزینی محتوای فایل خواهد
           شد.  توجه داشته باشید که ورودی/خروجی فایل به‌صورت اتمیک (atomic)
           نیست. فایل خروجی ابتدا کوتاه‌سازی (truncate) شده و سپس نوشته می‌شود.

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

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

       -check
           پارامترهای خم بیضوی را اعتبارسنجی می‌کند.

       -check_named
           پارامترهای نام خم بیضوی را با بررسی مطابقت پارامترهای خم با هر یک
           از خم‌های توکار (built-in) اعتبارسنجی می‌کند.

       -name arg
           از پارامترهای EC با «نام کوتاه» مشخص‌شده استفاده می‌کند. برای دریافت
           فهرستی از تمام پارامترهای EC پیاده‌سازی‌شدهٔ فعلی از -list_curves
           استفاده کنید.

       -list_curves
           فهرستی از تمام نام‌های پارامترهای EC پیاده‌سازی‌شدهٔ کنونی را چاپ کرده
           و خارج می‌شود.

       -conv_form arg
           چگونگی تبدیل نقاط روی خم بیضوی به رشته‌های هشت‌بیتی (octet strings)
           را مشخص می‌کند. مقادیر ممکن عبارتند از: compressed، uncompressed
           (مقدار پیش‌فرض) و hybrid.  برای اطلاعات بیشتر درباره قالب‌های تبدیل
           نقطه لطفاً استاندارد X9.62 را مطالعه کنید.  نکته: به‌دلیل مسائل مربوط
           به حق اختراع (پتنت)، گزینهٔ compressed به‌طور پیش‌فرض برای خم‌های
           دودویی غیرفعال است و می‌تواند با تعریف ماکروی پیش‌پردازندهٔ
           OPENSSL_EC_BIN_PT_COMP در زمان کامپایل فعال شود.

       -param_enc arg
           نحوهٔ کدگذاری پارامترهای خم بیضوی را مشخص می‌کند.  مقادیر ممکن
           عبارتند از: named_curve، یعنی پارامترهای ec توسط یک OID مشخص
           می‌شوند، یا explicit که در آن پارامترهای ec به‌طور صریح ارائه می‌شوند
           (برای تعریف ساختارهای پارامترهای EC به RFC 3279 مراجعه کنید). مقدار
           پیش‌فرض named_curve است.  نکته: گزینهٔ جایگزین implicitlyCA، همان‌طور
           که در RFC 3279 مشخص شده، در حال حاضر در OpenSSL پیاده‌سازی نشده است.

       -no_seed
           این گزینه از گنجانده شدن «seed» برای تولید پارامتر در ساختار
           ECParameters جلوگیری می‌کند (به RFC 3279 مراجعه کنید).

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

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

       -rand files, -writerand file
           برای جزئیات بیشتر به «Random State Options» در openssl(1) مراجعه
           کنید.

       -provider name
       -provider-path path
       -provparam [name:]key=value
       -propquery propq
           به «Provider Options» در openssl(1)، provider(7) و property(7)
           مراجعه کنید.

       دستورهای openssl-genpkey(1) و openssl-pkeyparam(1) قادر به انجام تمامی
       عملیات‌هایی که این دستور انجام می‌دهد هستند، ضمن اینکه از انواع دیگر کلید
       عمومی نیز پشتیبانی می‌کنند.

مثال‌ها (EXAMPLES)
       مستندات دستورهای openssl-genpkey(1) و openssl-pkeyparam(1) شامل
       مثال‌هایی معادل موارد ذکرشده در اینجا است.

       برای ایجاد پارامترهای EC با گروه 'prime192v1':

         openssl ecparam -out ec_param.pem -name prime192v1

       برای ایجاد پارامترهای EC با پارامترهای صریح (explicit):

         openssl ecparam -out ec_param.pem -name prime192v1 -param_enc explicit

       برای اعتبارسنجی پارامترهای EC داده‌شده:

         openssl ecparam -in ec_param.pem -check

       برای ایجاد پارامترهای EC و یک کلید خصوصی:

         openssl ecparam -out ec_key.pem -name prime192v1 -genkey

       برای تغییر کدگذاری نقاط به حالت 'compressed' (فشرده):

         openssl ecparam -in ec_in.pem -out ec_out.pem -conv_form compressed

       برای چاپ پارامترهای EC در خروجی استاندارد:

         openssl ecparam -in ec_param.pem -noout -text

همچنین ببینید (SEE ALSO)
       openssl(1), openssl-pkeyparam(1), openssl-genpkey(1), openssl-ec(1),
       openssl-dsaparam(1)

تاریخچه (HISTORY)
       گزینهٔ -engine در OpenSSL 3.0 منسوخ شد.

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

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

       تحت مجوز آپاچی نسخه ۲.۰ («مجوز») منتشر شده است. شما نمی‌توانید از این
       فایل مگر در انطباق با این مجوز استفاده کنید. می‌توانید نسخه‌ای از مجوز را
       در فایل LICENSE توزیع مبدا یا در نشانی زیر دریافت کنید:
       <https://www.openssl.org/source/license.html>.

3.6.4                             2026-08-25             OPENSSL-ECPARAM(1ssl)