.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Required to disable full justification in groff 1.23.0. .if n .ds AD l .\" ======================================================================== .\" .IX Title "OPENSSL-ECPARAM 1ssl" .TH OPENSSL-ECPARAM 1ssl 2026-08-25 3.6.4 OpenSSL .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "نام (NAME)" openssl\-ecparam \- دستکاری و تولید پارامترهای EC (خم بیضوی) .SH "خلاصه دستور (SYNOPSIS)" .IX Header "SYNOPSIS" \&\fBopenssl ecparam\fR [\fB\-help\fR] [\fB\-inform\fR \fBDER\fR|\fBPEM\fR] [\fB\-outform\fR \fBDER\fR|\fBPEM\fR] [\fB\-in\fR \fIfilename\fR] [\fB\-out\fR \fIfilename\fR] [\fB\-noout\fR] [\fB\-text\fR] [\fB\-check\fR] [\fB\-check_named\fR] [\fB\-name\fR \fIarg\fR] [\fB\-list_curves\fR] [\fB\-conv_form\fR \fIarg\fR] [\fB\-param_enc\fR \fIarg\fR] [\fB\-no_seed\fR] [\fB\-genkey\fR] [\fB\-engine\fR \fIid\fR] [\fB\-rand\fR \fIfiles\fR] [\fB\-writerand\fR \fIfile\fR] [\fB\-provider\fR \fIname\fR] [\fB\-provider\-path\fR \fIpath\fR] [\fB\-provparam\fR \fI[name:]key=value\fR] [\fB\-propquery\fR \fIpropq\fR] .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" این دستور برای دستکاری یا تولید فایل‌های پارامتر EC (خم بیضوی) به کار می‌رود. .PP اوپن‌اس‌اس‌ال در حال حاضر قادر به تولید گروه‌های جدید نیست و از این رو این دستور تنها می‌تواند پارامترهای EC را از خم‌های شناخته‌شده (نام‌گذاری‌شده) ایجاد کند. .SH "گزینه‌ها (OPTIONS)" .IX Header "OPTIONS" .IP \fB\-help\fR 4 .IX Item "-help" پیام راهنمای نحوهٔ استفاده از دستور را نمایش می‌دهد. .IP "\fB\-inform\fR \fBDER\fR|\fBPEM\fR" 4 .IX Item "-inform DER|PEM" قالب ورودی پارامترهای EC؛ به‌طور پیش‌فرض تعیین نشده است. برای جزئیات بیشتر به \fBopenssl\-format\-options\fR\|(1) مراجعه کنید. .IP "\fB\-outform\fR \fBDER\fR|\fBPEM\fR" 4 .IX Item "-outform DER|PEM" قالب خروجی پارامترهای EC؛ مقدار پیش‌فرض \fBPEM\fR است. برای جزئیات بیشتر به \fBopenssl\-format\-options\fR\|(1) مراجعه کنید. .Sp پارامترها همان‌طور که در RFC 3279 از IETF مشخص شده، به عنوان \fBEcpkParameters\fR کدگذاری می‌شوند. .IP "\fB\-in\fR \fIfilename\fR" 4 .IX Item "-in filename" فایل ورودی را برای خواندن پارامترها مشخص می‌کند، یا در صورت تعیین نشدن این گزینه، از ورودی استاندارد استفاده می‌شود. .IP "\fB\-out\fR \fIfilename\fR" 4 .IX Item "-out filename" نام فایل خروجی را برای نوشتن پارامترها مشخص می‌کند. در صورت عدم حضور این گزینه از خروجی استاندارد استفاده می‌شود. نام فایل خروجی می‌تواند با نام فایل ورودی یکسان باشد که منجر به جایگزینی محتوای فایل خواهد شد. توجه داشته باشید که ورودی/خروجی فایل به‌صورت اتمیک (atomic) نیست. فایل خروجی ابتدا کوتاه‌سازی (truncate) شده و سپس نوشته می‌شود. .IP \fB\-noout\fR 4 .IX Item "-noout" این گزینه از چاپ نسخهٔ کدگذاری‌شدهٔ پارامترها در خروجی جلوگیری می‌کند. .IP \fB\-text\fR 4 .IX Item "-text" این گزینه پارامترهای EC را در قالبی خوانا برای انسان چاپ می‌کند. .IP \fB\-check\fR 4 .IX Item "-check" پارامترهای خم بیضوی را اعتبارسنجی می‌کند. .IP \fB\-check_named\fR 4 .IX Item "-check_named" پارامترهای نام خم بیضوی را با بررسی مطابقت پارامترهای خم با هر یک از خم‌های توکار (built\-in) اعتبارسنجی می‌کند. .IP "\fB\-name\fR \fIarg\fR" 4 .IX Item "-name arg" از پارامترهای EC با «نام کوتاه» مشخص‌شده استفاده می‌کند. برای دریافت فهرستی از تمام پارامترهای EC پیاده‌سازی‌شدهٔ فعلی از \fB\-list_curves\fR استفاده کنید. .IP \fB\-list_curves\fR 4 .IX Item "-list_curves" فهرستی از تمام نام‌های پارامترهای EC پیاده‌سازی‌شدهٔ کنونی را چاپ کرده و خارج می‌شود. .IP "\fB\-conv_form\fR \fIarg\fR" 4 .IX Item "-conv_form arg" چگونگی تبدیل نقاط روی خم بیضوی به رشته‌های هشت‌بیتی (octet strings) را مشخص می‌کند. مقادیر ممکن عبارتند از: \fBcompressed\fR، \fBuncompressed\fR (مقدار پیش‌فرض) و \fBhybrid\fR. برای اطلاعات بیشتر درباره قالب‌های تبدیل نقطه لطفاً استاندارد X9.62 را مطالعه کنید. \&\fBنکته:\fR به‌دلیل مسائل مربوط به حق اختراع (پتنت)، گزینهٔ \fBcompressed\fR به‌طور پیش‌فرض برای خم‌های دودویی غیرفعال است و می‌تواند با تعریف ماکروی پیش‌پردازندهٔ \fBOPENSSL_EC_BIN_PT_COMP\fR در زمان کامپایل فعال شود. .IP "\fB\-param_enc\fR \fIarg\fR" 4 .IX Item "-param_enc arg" نحوهٔ کدگذاری پارامترهای خم بیضوی را مشخص می‌کند. مقادیر ممکن عبارتند از: \fBnamed_curve\fR، یعنی پارامترهای ec توسط یک OID مشخص می‌شوند، یا \fBexplicit\fR که در آن پارامترهای ec به‌طور صریح ارائه می‌شوند (برای تعریف ساختارهای پارامترهای EC به RFC 3279 مراجعه کنید). مقدار پیش‌فرض \fBnamed_curve\fR است. \&\fBنکته:\fR گزینهٔ جایگزین \fBimplicitlyCA\fR، همان‌طور که در RFC 3279 مشخص شده، در حال حاضر در OpenSSL پیاده‌سازی نشده است. .IP \fB\-no_seed\fR 4 .IX Item "-no_seed" این گزینه از گنجانده شدن «seed» برای تولید پارامتر در ساختار ECParameters جلوگیری می‌کند (به RFC 3279 مراجعه کنید). .IP \fB\-genkey\fR 4 .IX Item "-genkey" این گزینه با استفاده از پارامترهای مشخص‌شده یک کلید خصوصی EC تولید می‌کند. .IP "\fB\-engine\fR \fIid\fR" 4 .IX Item "-engine id" بخش «Engine Options» در \fBopenssl\fR\|(1) را ببینید. این گزینه منسوخ شده است. .IP "\fB\-rand\fR \fIfiles\fR, \fB\-writerand\fR \fIfile\fR" 4 .IX Item "-rand files, -writerand file" برای جزئیات بیشتر به «Random State Options» در \fBopenssl\fR\|(1) مراجعه کنید. .IP "\fB\-provider\fR \fIname\fR" 4 .IX Item "-provider name" .PD 0 .IP "\fB\-provider\-path\fR \fIpath\fR" 4 .IX Item "-provider-path path" .IP "\fB\-provparam\fR \fI[name:]key=value\fR" 4 .IX Item "-provparam [name:]key=value" .IP "\fB\-propquery\fR \fIpropq\fR" 4 .IX Item "-propquery propq" .PD به «Provider Options» در \fBopenssl\fR\|(1)، \fBprovider\fR\|(7) و \fBproperty\fR\|(7) مراجعه کنید. .PP دستورهای \fBopenssl\-genpkey\fR\|(1) و \fBopenssl\-pkeyparam\fR\|(1) قادر به انجام تمامی عملیات‌هایی که این دستور انجام می‌دهد هستند، ضمن اینکه از انواع دیگر کلید عمومی نیز پشتیبانی می‌کنند. .SH "مثال‌ها (EXAMPLES)" .IX Header "EXAMPLES" مستندات دستورهای \fBopenssl\-genpkey\fR\|(1) و \fBopenssl\-pkeyparam\fR\|(1) شامل مثال‌هایی معادل موارد ذکرشده در اینجا است. .PP برای ایجاد پارامترهای EC با گروه \*(Aqprime192v1\*(Aq: .PP .Vb 1 \& openssl ecparam \-out ec_param.pem \-name prime192v1 .Ve .PP برای ایجاد پارامترهای EC با پارامترهای صریح (explicit): .PP .Vb 1 \& openssl ecparam \-out ec_param.pem \-name prime192v1 \-param_enc explicit .Ve .PP برای اعتبارسنجی پارامترهای EC داده‌شده: .PP .Vb 1 \& openssl ecparam \-in ec_param.pem \-check .Ve .PP برای ایجاد پارامترهای EC و یک کلید خصوصی: .PP .Vb 1 \& openssl ecparam \-out ec_key.pem \-name prime192v1 \-genkey .Ve .PP برای تغییر کدگذاری نقاط به حالت \*(Aqcompressed\*(Aq (فشرده): .PP .Vb 1 \& openssl ecparam \-in ec_in.pem \-out ec_out.pem \-conv_form compressed .Ve .PP برای چاپ پارامترهای EC در خروجی استاندارد: .PP .Vb 1 \& openssl ecparam \-in ec_param.pem \-noout \-text .Ve .SH "همچنین ببینید (SEE ALSO)" .IX Header "SEE ALSO" \&\fBopenssl\fR\|(1), \&\fBopenssl\-pkeyparam\fR\|(1), \&\fBopenssl\-genpkey\fR\|(1), \&\fBopenssl\-ec\fR\|(1), \&\fBopenssl\-dsaparam\fR\|(1) .SH "تاریخچه (HISTORY)" .IX Header "HISTORY" گزینهٔ \fB\-engine\fR در OpenSSL 3.0 منسوخ شد. .PP گزینهٔ \fB\-C\fR در OpenSSL 3.0 حذف گردید. .SH "حق نشر (COPYRIGHT)" .IX Header "COPYRIGHT" حق نشر ۲۰۰۳\-۲۰۲۱ نویسندگان پروژه OpenSSL. تمامی حقوق محفوظ است. .PP تحت مجوز آپاچی نسخه ۲.۰ («مجوز») منتشر شده است. شما نمی‌توانید از این فایل مگر در انطباق با این مجوز استفاده کنید. می‌توانید نسخه‌ای از مجوز را در فایل LICENSE توزیع مبدا یا در نشانی زیر دریافت کنید: .