.\" -*- 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 1ssl"
.TH OPENSSL 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 \- ابزار خط فرمان رمزنگاری OpenSSL
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
\&\fBopenssl\fR
\&\fIcommand\fR
[ \fIoptions\fR ... ]
[ \fIparameters\fR ... ]
.PP
\&\fBopenssl\fR \fBno\-\fR\fIXXX\fR [ \fIoptions\fR ]
.PP
\&\fBopenssl\fR \fB\-help\fR | \fB\-version\fR
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
OpenSSL یک جعبه‌ابزار رمزنگاری است که پروتکل‌های شبکه لایه سوکت‌های امن (SSL)
و امنیت لایه انتقال (TLS) و استانداردهای رمزنگاری مرتبط مورد نیاز آن‌ها را پیاده‌سازی می‌کند.
.PP
برنامه \fBopenssl\fR یک برنامه خط فرمان برای استفاده از توابع گوناگون
رمزنگاری کتابخانه \fBcrypto\fR در OpenSSL از طریق شل است.
این برنامه می‌تواند برای موارد زیر استفاده شود:
.PP
.Vb 8
\& o  ایجاد و مدیریت کلیدهای خصوصی، کلیدهای عمومی و پارامترها
\& o  عملیات رمزنگاری با کلید عمومی
\& o  ایجاد گواهی‌های X.509، CSRها و CRLها
\& o  محاسبه خلاصه‌های پیام (Message Digests) و کدهای اصالت‌سنجی پیام (MAC)
\& o  رمزگذاری و رمزگشایی با رمزها (Ciphers)
\& o  آزمون‌های سرویس‌گیرنده و سرویس‌دهنده SSL/TLS
\& o  مدیریت نامه‌های امضا شده یا رمزگذاری شده با S/MIME
\& o  درخواست، تولید و اعتبارسنجی برچسب زمان (Timestamp)
.Ve
.SH "خلاصه دستورات (COMMAND SUMMARY)"
.IX Header "COMMAND SUMMARY"
برنامه \fBopenssl\fR تنوع گسترده‌ای از دستورها (\fIcommand\fR در
بخش "SYNOPSIS" بالا) را ارائه می‌دهد.
هر دستور می‌تواند گزینه‌ها و پارامترهای آرگومان متعددی داشته باشد که در بالا با
\&\fIoptions\fR و \fIparameters\fR نشان داده شده‌اند.
.PP
مستندات دقیق و موارد کاربرد برای اکثر زیردستورهای استاندارد در دسترس است
(مانند \fBopenssl\-x509\fR\|(1)). زیردستور \fBopenssl\-list\fR\|(1) می‌تواند برای فهرست کردن
زیردستورها استفاده شود.
.PP
دستور \fBno\-\fR\fIXXX\fR بررسی می‌کند که آیا دستوری با نام
مشخص‌شده در دسترس است یا خیر. اگر دستوری به نام \fIXXX\fR وجود نداشته باشد،
مقدار 0 (موفقیت) را برمی‌گرداند و عبارت \fBno\-\fR\fIXXX\fR را چاپ می‌کند؛ در غیر این صورت مقدار 1
را بازگردانده و \fIXXX\fR را چاپ می‌کند. در هر دو حالت، خروجی به \fBstdout\fR فرستاده شده و
چیزی در \fBstderr\fR چاپ نمی‌شود. آرگومان‌های خط فرمان اضافی همیشه
نادیده گرفته می‌شوند. از آنجا که برای هر رمز یک دستور با همان نام
وجود دارد، این قابلیت یک روش آسان برای اسکریپت‌های شل به منظور بررسی
در دسترس بودن رمزها در برنامه \fBopenssl\fR فراهم می‌کند.
(\fBno\-\fR\fIXXX\fR قادر به تشخیص شبه‌دستورهایی مانند \fBquit\fR،
\&\fBlist\fR یا خودِ \fBno\-\fR\fIXXX\fR نیست.)
.SS "گزینه پیکربندی (Configuration Option)"
.IX Subsection "Configuration Option"
بسیاری از دستورها از یک فایل پیکربندی خارجی برای برخی یا تمامی
آرگومان‌های خود استفاده می‌کنند و دارای یک گزینه \fB\-config\fR برای تعیین آن فایل هستند.
نام پیش‌فرض این فایل \fIopenssl.cnf\fR در محل پیش‌فرض ذخیره‌سازی
گواهی‌ها است، که می‌توان آن را از دستور \fBopenssl\-version\fR\|(1)
با استفاده از گزینه \fB\-d\fR یا \fB\-a\fR پیدا کرد.
متغیر محیطی \fBOPENSSL_CONF\fR می‌تواند برای تعیین مکان متفاوت
فایل یا غیرفعال کردن بارگذاری پیکربندی (با استفاده از رشته خالی) استفاده شود.
.PP
علاوه بر این، فایل پیکربندی می‌تواند برای بارگذاری ماژول‌ها
و تعیین پارامترها به منظور تولید گواهی‌ها و اعداد تصادفی به کار رود.
برای جزئیات بیشتر به \fBconfig\fR\|(5) مراجعه کنید.
.SS "دستورات استاندارد (Standard Commands)"
.IX Subsection "Standard Commands"
.IP \fBasn1parse\fR 4
.IX Item "asn1parse"
تجزیه یک توالی ASN.1.
.IP \fBca\fR 4
.IX Item "ca"
مدیریت مرجع صدور گواهی (CA).
.IP \fBciphers\fR 4
.IX Item "ciphers"
تعیین توصیف مجموعه رمزها (Cipher Suites).
.IP \fBcms\fR 4
.IX Item "cms"
دستور CMS (سینتکس پیام‌های رمزنگاری).
.IP \fBcrl\fR 4
.IX Item "crl"
مدیریت فهرست ابطال گواهی (CRL).
.IP \fBcrl2pkcs7\fR 4
.IX Item "crl2pkcs7"
تبدیل CRL به PKCS#7.
.IP \fBdgst\fR 4
.IX Item "dgst"
محاسبه خلاصه پیام (Message Digest). محاسبات MAC توسط
\&\fBopenssl\-mac\fR\|(1) جایگزین شده‌اند.
.IP \fBdhparam\fR 4
.IX Item "dhparam"
تولید و مدیریت پارامترهای دیفی-هلمن (Diffie-Hellman). توسط
\&\fBopenssl\-genpkey\fR\|(1) و \fBopenssl\-pkeyparam\fR\|(1) جایگزین شده است.
.IP \fBdsa\fR 4
.IX Item "dsa"
مدیریت داده‌های DSA.
.IP \fBdsaparam\fR 4
.IX Item "dsaparam"
تولید و مدیریت پارامترهای DSA. توسط
\&\fBopenssl\-genpkey\fR\|(1) و \fBopenssl\-pkeyparam\fR\|(1) جایگزین شده است.
.IP \fBec\fR 4
.IX Item "ec"
پردازش کلید EC (منحنی بیضوی).
.IP \fBecparam\fR 4
.IX Item "ecparam"
دستکاری و تولید پارامترهای EC.
.IP \fBenc\fR 4
.IX Item "enc"
رمزگذاری، رمزگشایی و کدگذاری.
.IP \fBengine\fR 4
.IX Item "engine"
اطلاعات و دستکاری موتور (ماژول قابل بارگذاری).
.IP \fBerrstr\fR 4
.IX Item "errstr"
تبدیل شماره خطا به رشته متنی خطا.
.IP \fBfipsinstall\fR 4
.IX Item "fipsinstall"
نصب پیکربندی FIPS.
.IP \fBgendsa\fR 4
.IX Item "gendsa"
تولید کلید خصوصی DSA از روی پارامترها. توسط
\&\fBopenssl\-genpkey\fR\|(1) و \fBopenssl\-pkey\fR\|(1) جایگزین شده است.
.IP \fBgenpkey\fR 4
.IX Item "genpkey"
تولید کلید خصوصی یا پارامترها.
.IP \fBgenrsa\fR 4
.IX Item "genrsa"
تولید کلید خصوصی RSA. توسط \fBopenssl\-genpkey\fR\|(1) جایگزین شده است.
.IP \fBhelp\fR 4
.IX Item "help"
نمایش اطلاعات درباره گزینه‌های یک دستور.
.IP \fBinfo\fR 4
.IX Item "info"
نمایش اطلاعات گوناگون تعبیه‌شده در کتابخانه‌های OpenSSL.
.IP \fBkdf\fR 4
.IX Item "kdf"
توابع اشتقاق کلید (KDF).
.IP \fBlist\fR 4
.IX Item "list"
فهرست کردن الگوریتم‌ها و قابلیت‌ها.
.IP \fBmac\fR 4
.IX Item "mac"
محاسبه کد اصالت‌سنجی پیام (MAC).
.IP \fBnseq\fR 4
.IX Item "nseq"
ایجاد یا بررسی یک توالی گواهی Netscape.
.IP \fBocsp\fR 4
.IX Item "ocsp"
دستور پروتکل بررسی آنلاین وضعیت گواهی (OCSP).
.IP \fBpasswd\fR 4
.IX Item "passwd"
تولید گذرواژه‌های هش‌شده.
.IP \fBpkcs12\fR 4
.IX Item "pkcs12"
مدیریت داده‌های PKCS#12.
.IP \fBpkcs7\fR 4
.IX Item "pkcs7"
مدیریت داده‌های PKCS#7.
.IP \fBpkcs8\fR 4
.IX Item "pkcs8"
دستور تبدیل کلید خصوصی با فرمت PKCS#8.
.IP \fBpkey\fR 4
.IX Item "pkey"
مدیریت کلیدهای عمومی و خصوصی.
.IP \fBpkeyparam\fR 4
.IX Item "pkeyparam"
مدیریت پارامترهای الگوریتم کلید عمومی.
.IP \fBpkeyutl\fR 4
.IX Item "pkeyutl"
دستور عملیات رمزنگاری با الگوریتم کلید عمومی.
.IP \fBprime\fR 4
.IX Item "prime"
محاسبه اعداد اول.
.IP \fBrand\fR 4
.IX Item "rand"
تولید بایت‌های شبه‌تصادفی.
.IP \fBrehash\fR 4
.IX Item "rehash"
ایجاد پیوندهای نمادین به فایل‌های گواهی و CRL نام‌گذاری شده با مقادیر هش.
.IP \fBreq\fR 4
.IX Item "req"
مدیریت درخواست امضای گواهی (CSR) استاندارد PKCS#10 X.509.
.IP \fBrsa\fR 4
.IX Item "rsa"
مدیریت کلید RSA.
.IP \fBrsautl\fR 4
.IX Item "rsautl"
دستور RSA برای امضا، اعتبارسنجی، رمزگذاری و رمزگشایی. توسط
\&\fBopenssl\-pkeyutl\fR\|(1) جایگزین شده است.
.IP \fBs_client\fR 4
.IX Item "s_client"
یک کلاینت جامع SSL/TLS را پیاده‌سازی می‌کند که می‌تواند یک اتصال
شفاف با یک سرور راه دور با پروتکل SSL/TLS برقرار کند. این ابزار صرفاً
برای اهداف آزمایشی در نظر گرفته شده و تنها عملکردهای ابتدایی رابط کاربری را ارائه می‌دهد،
اما در درون تقریباً از تمامی قابلیت‌های کتابخانه \fBssl\fR در OpenSSL استفاده می‌کند.
.IP \fBs_server\fR 4
.IX Item "s_server"
یک سرور جامع SSL/TLS را پیاده‌سازی می‌کند که اتصالات را از کلاینت‌های
راه دور با پروتکل SSL/TLS می‌پذیرد. این ابزار صرفاً برای اهداف آزمایشی در نظر گرفته شده
و تنها عملکردهای ابتدایی رابط کاربری را ارائه می‌دهد، اما در درون تقریباً از تمامی
قابلیت‌های کتابخانه \fBssl\fR در OpenSSL استفاده می‌کند. این ابزار هم یک پروتکل مبتنی بر خط فرمان
برای آزمودن توابع SSL و هم یک امکان ساده پاسخ‌دهی HTTP برای شبیه‌سازی
یک وب‌سرور آگاه از SSL/TLS را فراهم می‌کند.
.IP \fBs_time\fR 4
.IX Item "s_time"
زمان‌سنج اتصال SSL.
.IP \fBsess_id\fR 4
.IX Item "sess_id"
مدیریت داده‌های نشست SSL.
.IP \fBsmime\fR 4
.IX Item "smime"
پردازش نامه‌های S/MIME.
.IP \fBspeed\fR 4
.IX Item "speed"
سنجش سرعت الگوریتم‌ها.
.IP \fBspkac\fR 4
.IX Item "spkac"
دستور چاپ و تولید SPKAC.
.IP \fBsrp\fR 4
.IX Item "srp"
نگهداری فایل گذرواژه SRP. این دستور منسوخ شده است.
.IP \fBstoreutl\fR 4
.IX Item "storeutl"
دستور فهرست کردن و نمایش گواهی‌ها، کلیدها، CRLها و غیره.
.IP \fBts\fR 4
.IX Item "ts"
دستور مرجع برچسب‌گذاری زمان (TSA).
.IP \fBverify\fR 4
.IX Item "verify"
اعتبارسنجی گواهی X.509.
همچنین به صفحه راهنمای \fBopenssl\-verification\-options\fR\|(1) مراجعه کنید.
.IP \fBversion\fR 4
.IX Item "version"
اطلاعات نسخه OpenSSL.
.IP \fBx509\fR 4
.IX Item "x509"
مدیریت داده‌های گواهی X.509.
.SS "دستورات خلاصه پیام (Message Digest Commands)"
.IX Subsection "Message Digest Commands"
.IP \fBblake2b512\fR 4
.IX Item "blake2b512"
خلاصه پیام BLAKE2b\-512
.IP \fBblake2s256\fR 4
.IX Item "blake2s256"
خلاصه پیام BLAKE2s\-256
.IP \fBmd2\fR 4
.IX Item "md2"
خلاصه پیام MD2
.IP \fBmd4\fR 4
.IX Item "md4"
خلاصه پیام MD4
.IP \fBmd5\fR 4
.IX Item "md5"
خلاصه پیام MD5
.IP \fBmdc2\fR 4
.IX Item "mdc2"
خلاصه پیام MDC2
.IP \fBrmd160\fR 4
.IX Item "rmd160"
خلاصه پیام RMD\-160
.IP \fBsha1\fR 4
.IX Item "sha1"
خلاصه پیام SHA\-1
.IP \fBsha224\fR 4
.IX Item "sha224"
خلاصه پیام SHA\-2 224
.IP \fBsha256\fR 4
.IX Item "sha256"
خلاصه پیام SHA\-2 256
.IP \fBsha384\fR 4
.IX Item "sha384"
خلاصه پیام SHA\-2 384
.IP \fBsha512\fR 4
.IX Item "sha512"
خلاصه پیام SHA\-2 512
.IP \fBsha3\-224\fR 4
.IX Item "sha3-224"
خلاصه پیام SHA\-3 224
.IP \fBsha3\-256\fR 4
.IX Item "sha3-256"
خلاصه پیام SHA\-3 256
.IP \fBsha3\-384\fR 4
.IX Item "sha3-384"
خلاصه پیام SHA\-3 384
.IP \fBsha3\-512\fR 4
.IX Item "sha3-512"
خلاصه پیام SHA\-3 512
.IP \fBkeccak\-224\fR 4
.IX Item "keccak-224"
خلاصه پیام KECCAK 224
.IP \fBkeccak\-256\fR 4
.IX Item "keccak-256"
خلاصه پیام KECCAK 256
.IP \fBkeccak\-384\fR 4
.IX Item "keccak-384"
خلاصه پیام KECCAK 384
.IP \fBkeccak\-512\fR 4
.IX Item "keccak-512"
خلاصه پیام KECCAK 512
.IP \fBshake128\fR 4
.IX Item "shake128"
خلاصه پیام SHA\-3 SHAKE128
.IP \fBshake256\fR 4
.IX Item "shake256"
خلاصه پیام SHA\-3 SHAKE256
.IP \fBsm3\fR 4
.IX Item "sm3"
خلاصه پیام SM3
.SS "دستورات رمزگذاری، رمزگشایی و کدگذاری (Encryption, Decryption, and Encoding Commands)"
.IX Subsection "Encryption, Decryption, and Encoding Commands"
نام‌های مستعار زیر دسترسی آسانی را به پرکاربردترین کدگذاری‌ها
و رمزها فراهم می‌کنند.
.PP
بسته به نحوه پیکربندی و ساخت OpenSSL، ممکن است همه رمزهای فهرست‌شده
در اینجا موجود نباشند. برای اطلاعات بیشتر به \fBopenssl\-enc\fR\|(1) مراجعه کنید.
.IP "\fBaes128\fR, \fBaes\-128\-cbc\fR, \fBaes\-128\-cfb\fR, \fBaes\-128\-ctr\fR, \fBaes\-128\-ecb\fR, \fBaes\-128\-ofb\fR" 4
.IX Item "aes128, aes-128-cbc, aes-128-cfb, aes-128-ctr, aes-128-ecb, aes-128-ofb"
رمز AES\-128
.IP "\fBaes192\fR, \fBaes\-192\-cbc\fR, \fBaes\-192\-cfb\fR, \fBaes\-192\-ctr\fR, \fBaes\-192\-ecb\fR, \fBaes\-192\-ofb\fR" 4
.IX Item "aes192, aes-192-cbc, aes-192-cfb, aes-192-ctr, aes-192-ecb, aes-192-ofb"
رمز AES\-192
.IP "\fBaes256\fR, \fBaes\-256\-cbc\fR, \fBaes\-256\-cfb\fR, \fBaes\-256\-ctr\fR, \fBaes\-256\-ecb\fR, \fBaes\-256\-ofb\fR" 4
.IX Item "aes256, aes-256-cbc, aes-256-cfb, aes-256-ctr, aes-256-ecb, aes-256-ofb"
رمز AES\-256
.IP "\fBaria128\fR, \fBaria\-128\-cbc\fR, \fBaria\-128\-cfb\fR, \fBaria\-128\-ctr\fR, \fBaria\-128\-ecb\fR, \fBaria\-128\-ofb\fR" 4
.IX Item "aria128, aria-128-cbc, aria-128-cfb, aria-128-ctr, aria-128-ecb, aria-128-ofb"
رمز Aria\-128
.IP "\fBaria192\fR, \fBaria\-192\-cbc\fR, \fBaria\-192\-cfb\fR, \fBaria\-192\-ctr\fR, \fBaria\-192\-ecb\fR, \fBaria\-192\-ofb\fR" 4
.IX Item "aria192, aria-192-cbc, aria-192-cfb, aria-192-ctr, aria-192-ecb, aria-192-ofb"
رمز Aria\-192
.IP "\fBaria256\fR, \fBaria\-256\-cbc\fR, \fBaria\-256\-cfb\fR, \fBaria\-256\-ctr\fR, \fBaria\-256\-ecb\fR, \fBaria\-256\-ofb\fR" 4
.IX Item "aria256, aria-256-cbc, aria-256-cfb, aria-256-ctr, aria-256-ecb, aria-256-ofb"
رمز Aria\-256
.IP \fBbase64\fR 4
.IX Item "base64"
کدگذاری Base64
.IP "\fBbf\fR, \fBbf\-cbc\fR, \fBbf\-cfb\fR, \fBbf\-ecb\fR, \fBbf\-ofb\fR" 4
.IX Item "bf, bf-cbc, bf-cfb, bf-ecb, bf-ofb"
رمز Blowfish
.IP "\fBcamellia128\fR, \fBcamellia\-128\-cbc\fR, \fBcamellia\-128\-cfb\fR, \fBcamellia\-128\-ctr\fR, \fBcamellia\-128\-ecb\fR, \fBcamellia\-128\-ofb\fR" 4
.IX Item "camellia128, camellia-128-cbc, camellia-128-cfb, camellia-128-ctr, camellia-128-ecb, camellia-128-ofb"
رمز Camellia\-128
.IP "\fBcamellia192\fR, \fBcamellia\-192\-cbc\fR, \fBcamellia\-192\-cfb\fR, \fBcamellia\-192\-ctr\fR, \fBcamellia\-192\-ecb\fR, \fBcamellia\-192\-ofb\fR" 4
.IX Item "camellia192, camellia-192-cbc, camellia-192-cfb, camellia-192-ctr, camellia-192-ecb, camellia-192-ofb"
رمز Camellia\-192
.IP "\fBcamellia256\fR, \fBcamellia\-256\-cbc\fR, \fBcamellia\-256\-cfb\fR, \fBcamellia\-256\-ctr\fR, \fBcamellia\-256\-ecb\fR, \fBcamellia\-256\-ofb\fR" 4
.IX Item "camellia256, camellia-256-cbc, camellia-256-cfb, camellia-256-ctr, camellia-256-ecb, camellia-256-ofb"
رمز Camellia\-256
.IP "\fBcast\fR, \fBcast\-cbc\fR" 4
.IX Item "cast, cast-cbc"
رمز CAST
.IP "\fBcast5\-cbc\fR, \fBcast5\-cfb\fR, \fBcast5\-ecb\fR, \fBcast5\-ofb\fR" 4
.IX Item "cast5-cbc, cast5-cfb, cast5-ecb, cast5-ofb"
رمز CAST5
.IP \fBchacha20\fR 4
.IX Item "chacha20"
رمز Chacha20
.IP "\fBdes\fR, \fBdes\-cbc\fR, \fBdes\-cfb\fR, \fBdes\-ecb\fR, \fBdes\-ede\fR, \fBdes\-ede\-cbc\fR, \fBdes\-ede\-cfb\fR, \fBdes\-ede\-ofb\fR, \fBdes\-ofb\fR" 4
.IX Item "des, des-cbc, des-cfb, des-ecb, des-ede, des-ede-cbc, des-ede-cfb, des-ede-ofb, des-ofb"
رمز DES
.IP "\fBdes3\fR, \fBdesx\fR, \fBdes\-ede3\fR, \fBdes\-ede3\-cbc\fR, \fBdes\-ede3\-cfb\fR, \fBdes\-ede3\-ofb\fR" 4
.IX Item "des3, desx, des-ede3, des-ede3-cbc, des-ede3-cfb, des-ede3-ofb"
رمز Triple\-DES
.IP "\fBidea\fR, \fBidea\-cbc\fR, \fBidea\-cfb\fR, \fBidea\-ecb\fR, \fBidea\-ofb\fR" 4
.IX Item "idea, idea-cbc, idea-cfb, idea-ecb, idea-ofb"
رمز IDEA
.IP "\fBrc2\fR, \fBrc2\-cbc\fR, \fBrc2\-cfb\fR, \fBrc2\-ecb\fR, \fBrc2\-ofb\fR" 4
.IX Item "rc2, rc2-cbc, rc2-cfb, rc2-ecb, rc2-ofb"
رمز RC2
.IP \fBrc4\fR 4
.IX Item "rc4"
رمز RC4
.IP "\fBrc5\fR, \fBrc5\-cbc\fR, \fBrc5\-cfb\fR, \fBrc5\-ecb\fR, \fBrc5\-ofb\fR" 4
.IX Item "rc5, rc5-cbc, rc5-cfb, rc5-ecb, rc5-ofb"
رمز RC5
.IP "\fBseed\fR, \fBseed\-cbc\fR, \fBseed\-cfb\fR, \fBseed\-ecb\fR, \fBseed\-ofb\fR" 4
.IX Item "seed, seed-cbc, seed-cfb, seed-ecb, seed-ofb"
رمز SEED
.IP "\fBsm4\fR, \fBsm4\-cbc\fR, \fBsm4\-cfb\fR, \fBsm4\-ctr\fR, \fBsm4\-ecb\fR, \fBsm4\-ofb\fR" 4
.IX Item "sm4, sm4-cbc, sm4-cfb, sm4-ctr, sm4-ecb, sm4-ofb"
رمز SM4
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
جزئیات گزینه‌های در دسترس به دستور خاص مورد استفاده بستگی دارد.
این بخش برخی از گزینه‌های متداول با رفتارهای مشترک را شرح می‌دهد.
.SS "گزینه‌های برنامه (Program Options)"
.IX Subsection "Program Options"
این گزینه‌ها را می‌توان بدون مشخص کردن دستور، برای دریافت راهنما
یا اطلاعات نسخه تعیین کرد.
.IP \fB\-help\fR 4
.IX Item "-help"
خلاصه‌ای فشرده از تمامی گزینه‌ها ارائه می‌دهد.
برای اطلاعات دقیق‌تر، هر دستور از گزینه \fB\-help\fR پشتیبانی می‌کند.
عبارت \fB\-\-help\fR را نیز می‌پذیرد.
.IP \fB\-version\fR 4
.IX Item "-version"
خلاصه‌ای فشرده از نسخه برنامه \fBopenssl\fR ارائه می‌دهد.
برای اطلاعات تفصیلی به \fBopenssl\-version\fR\|(1) مراجعه کنید.
عبارت \fB\-\-version\fR را نیز می‌پذیرد.
.SS "گزینه‌های مشترک (Common Options)"
.IX Subsection "Common Options"
.IP \fB\-help\fR 4
.IX Item "-help"
اگر گزینه‌ای آرگومان بپذیرد، "نوع" آرگومان نیز داده می‌شود.
.IP \fB\-\-\fR 4
.IX Item "--"
به فهرست گزینه‌ها پایان می‌دهد. بیشترین کاربرد آن زمانی است که نام
فایل‌ها با علامت خط تیره (منفی) شروع شوند:
.Sp
.Vb 1
\& openssl verify [flags...] \-\- \-cert1.pem...
.Ve
.SS "گزینه‌های قالب (Format Options)"
.IX Subsection "Format Options"
به صفحه راهنمای \fBopenssl\-format\-options\fR\|(1) مراجعه کنید.
.SS "گزینه‌های عبارت عبور (Pass Phrase Options)"
.IX Subsection "Pass Phrase Options"
به صفحه راهنمای \fBopenssl\-passphrase\-options\fR\|(1) مراجعه کنید.
.SS "گزینه‌های وضعیت تصادفی (Random State Options)"
.IX Subsection "Random State Options"
پیش از OpenSSL 1.1.1، مرسوم بود که برنامه‌ها اطلاعات وضعیت
تولیدکننده اعداد تصادفی را در فایلی ذخیره کنند که هنگام راه‌اندازی بارگذاری
و هنگام خروج دوباره بازنویسی می‌شد. در سیستم‌عامل‌های امروزی، این امر
عموماً دیگر لازم نیست زیرا OpenSSL بذر تصادفی (seed) خود را از یک منبع آنتروپی
قابل اطمینان که توسط سیستم‌عامل فراهم می‌شود تأمین می‌کند. این فلگ‌ها همچنان
برای پلتفرم‌ها یا شرایط خاصی که ممکن است به آن‌ها نیاز داشته باشند پشتیبانی می‌شوند.
.PP
به طور کلی استفاده چندباره از یک فایل بذر تصادفی یک خطا محسوب می‌شود و
هر بار استفاده از \fB\-rand\fR باید با \fB\-writerand\fR جفت شود.
.IP "\fB\-rand\fR \fIfiles\fR" 4
.IX Item "-rand files"
یک یا چند فایل حاوی داده‌های تصادفی برای بذردهی به تولیدکننده
اعداد تصادفی.
می‌توان چندین فایل را با نویسه جداکننده وابسته به سیستم‌عامل تعیین کرد.
این جداکننده برای MS\-Windows برابر با \f(CW\*(C`;\*(C'\fR، برای OpenVMS برابر با \f(CW\*(C`,\*(C'\fR و برای
سایر سیستم‌ها \f(CW\*(C`:\*(C'\fR است. روش دیگر برای تعیین چندین فایل، تکرار این فلگ
با نام فایل‌های مختلف است.
.IP "\fB\-writerand\fR \fIfile\fR" 4
.IX Item "-writerand file"
داده‌های بذر تصادفی را هنگام خروج در \fIfile\fR مشخص‌شده می‌نویسد.
این فایل می‌تواند در فراخوانی‌های بعدی دستور استفاده شود.
.SS "گزینه‌های اعتبارسنجی گواهی (Certificate Verification Options)"
.IX Subsection "Certificate Verification Options"
به صفحه راهنمای \fBopenssl\-verification\-options\fR\|(1) مراجعه کنید.
.SS "گزینه‌های قالب نام (Name Format Options)"
.IX Subsection "Name Format Options"
به صفحه راهنمای \fBopenssl\-namedisplay\-options\fR\|(1) مراجعه کنید.
.SS "گزینه‌های نسخه TLS (TLS Version Options)"
.IX Subsection "TLS Version Options"
چندین دستور از SSL، TLS یا DTLS استفاده می‌کنند. به‌طور پیش‌فرض، دستورها از TLS استفاده می‌کنند و
سرویس‌گیرنده‌ها پایین‌ترین و بالاترین نسخه پروتکل پشتیبانی‌شده خود را پیشنهاد می‌دهند،
و سرویس‌دهنده‌ها بالاترین نسخه‌ای را که کلاینت پیشنهاد داده و توسط سرور نیز پشتیبانی می‌شود
انتخاب می‌کنند.
.PP
گزینه‌های زیر می‌توانند برای محدود کردن نسخه‌های پروتکل مورد استفاده،
و تعیین استفاده از TCP (پروتکل‌های SSL و TLS) یا UDP (پروتکل DTLS) به کار روند.
توجه داشته باشید که بسته به نحوه ساخت OpenSSL، ممکن است تمام پروتکل‌ها و فلگ‌ها
در دسترس نباشند.
.IP "\fB\-ssl3\fR, \fB\-tls1\fR, \fB\-tls1_1\fR, \fB\-tls1_2\fR, \fB\-tls1_3\fR, \fB\-no_ssl3\fR, \fB\-no_tls1\fR, \fB\-no_tls1_1\fR, \fB\-no_tls1_2\fR, \fB\-no_tls1_3\fR" 4
.IX Item "-ssl3, -tls1, -tls1_1, -tls1_2, -tls1_3, -no_ssl3, -no_tls1, -no_tls1_1, -no_tls1_2, -no_tls1_3"
این گزینه‌ها استفاده از پروتکل‌های مشخص‌شده SSL یا TLS را الزامی یا غیرفعال می‌کنند.
هنگامی که یک نسخه خاص TLS الزامی شود، فقط همان نسخه پیشنهاد یا پذیرفته
خواهد شد.
تنها یک پروتکل مشخص را می‌توان تعیین کرد و امکان ترکیب آن با هیچ‌یک از
گزینه‌های \fBno_\fR وجود ندارد.
گزینه‌های \fBno_*\fR با دستورهای \fBs_time\fR و \fBciphers\fR کار نمی‌کنند اما با
دستورهای \fBs_client\fR و \fBs_server\fR کار می‌کنند.
.IP "\fB\-dtls\fR, \fB\-dtls1\fR, \fB\-dtls1_2\fR" 4
.IX Item "-dtls, -dtls1, -dtls1_2"
این گزینه‌ها استفاده از DTLS را به جای TLS تعیین می‌کنند.
با گزینه \fB\-dtls\fR، کلاینت‌ها هر نسخه پشتیبانی‌شده از پروتکل DTLS را مذاکره خواهند کرد.
برای پشتیبانی اختصاصی از DTLS1.0 یا DTLS1.2، به ترتیب از گزینه‌های \fB\-dtls1\fR یا \fB\-dtls1_2\fR
استفاده کنید.
.SS "گزینه‌های موتور (Engine Options)"
.IX Subsection "Engine Options"
.IP "\fB\-engine\fR \fIid\fR" 4
.IX Item "-engine id"
موتور مشخص‌شده با شناسه \fIid\fR را بارگذاری کرده و از تمامی روش‌هایی که پیاده‌سازی می‌کند
(الگوریتم‌ها، ذخیره‌سازی کلید و غیره) استفاده می‌کند، مگر اینکه در مستندات
خاص دستور خلاف آن ذکر شده باشد یا طوری پیکربندی شده باشد که چنین کند، همان‌طور که در
"Engine Configuration" در \fBconfig\fR\|(5) توصیف شده است.
.Sp
هنگامی که گزینه‌ای مانند \fB\-keyform engine\fR داده شود، این موتور برای شناسه‌های کلید مشخص‌شده با
\&\fB\-key\fR و گزینه‌های مشابه استفاده خواهد شد.
.Sp
یک حالت خاص موتور \f(CW\*(C`loader_attic\*(C'\fR است که
صرفاً برای اهداف آزمایشی داخلی OpenSSL در نظر گرفته شده و
از بارگذاری کلیدها، پارامترها، گواهی‌ها و CRLها از فایل‌ها پشتیبانی می‌کند.
هنگامی که از این موتور استفاده شود، فایل‌های دارای چنین اعتبارهایی از طریق این موتور خوانده می‌شوند.
استفاده از طرح‌واره \f(CW\*(C`file:\*(C'\fR اختیاری است؛ یک نام فایل (مسیر) ساده کفایت می‌کند.
.PP
گزینه‌های مشخص‌کننده کلید، مانند \fB\-key\fR و موارد مشابه، می‌توانند از طرح‌واره عمومی URI بارگذاری کلید موتور OpenSSL یعنی \f(CW\*(C`org.openssl.engine:\*(C'\fR برای بازیابی
کلیدهای خصوصی و کلیدهای عمومی استفاده کنند. نحو URI به صورت ساده‌شده به شرح
زیر است:
.PP
.Vb 1
\&    org.openssl.engine:{engineid}:{keyid}
.Ve
.PP
که در آن \f(CW\*(C`{engineid}\*(C'\fR هویت یا نام موتور و \f(CW\*(C`{keyid}\*(C'\fR یک شناسه
کلید قابل پذیرش برای آن موتور است. به عنوان مثال، هنگام استفاده از موتوری
که با یک پیاده‌سازی PKCS#11 ارتباط برقرار می‌کند، URI عمومی کلید چیزی
شبیه به این خواهد بود (این نمونه‌ای برای موتور PKCS#11 است که
بخشی از OpenSC به شمار می‌رود):
.PP
.Vb 1
\&    \-key org.openssl.engine:pkcs11:label_some\-private\-key
.Ve
.PP
به عنوان امکان سوم، برای موتورها و ارائه‌دهندگانی که \fBOSSL_STORE_LOADER\fR\|(3) خود را
پیاده‌سازی کرده‌اند، نباید به \f(CW\*(C`org.openssl.engine:\*(C'\fR نیازی باشد. برای یک پیاده‌سازی PKCS#11
که چنین بارگذاری‌کننده‌ای را پیاده کرده است، باید بتوان از URI مربوط به PKCS#11 طبق تعریف RFC 7512 مستقیماً استفاده کرد:
.PP
.Vb 1
\&    \-key pkcs11:object=some\-private\-key;pin\-value=1234
.Ve
.SS "گزینه‌های ارائه‌دهنده (Provider Options)"
.IX Subsection "Provider Options"
.IP "\fB\-provider\fR \fIname\fR" 4
.IX Item "-provider name"
ارائه‌دهنده شناسایی‌شده با \fIname\fR را بارگذاری و مقداردهی اولیه می‌کند. مقدار \fIname\fR
می‌تواند مسیری به ماژول ارائه‌دهنده نیز باشد. در آن صورت، نام ارائه‌دهنده
مسیر مشخص‌شده خواهد بود و نه صرفاً نام ماژول ارائه‌دهنده.
تفسیر مسیرهای نسبی وابسته به پلتفرم است. مسیر پیکربندی‌شده "MODULESDIR"،
متغیر محیطی \fBOPENSSL_MODULES\fR، یا مسیر مشخص‌شده توسط \fB\-provider\-path\fR به ابتدای
مسیرهای نسبی افزوده می‌شود.
برای توضیحات دقیق‌تر به \fBprovider\fR\|(7) مراجعه کنید.
.IP "\fB\-provider\-path\fR \fIpath\fR" 4
.IX Item "-provider-path path"
مسیر جستجویی را که باید برای یافتن ارائه‌دهنده‌ها استفاده شود، مشخص می‌کند.
به همین ترتیب، متغیر محیطی \fBOPENSSL_MODULES\fR نیز می‌تواند تنظیم شود.
.IP "\fB\-provparam\fR \fI[name:]key=value\fR" 4
.IX Item "-provparam [name:]key=value"
پارامتر پیکربندی \fIkey\fR را به مقدار \fIval\fR در ارائه‌دهنده \fIname\fR تنظیم می‌کند
(اختیاری)؛ اگر \fIname\fR مشخص نشود، تنظیم بر روی تمامی ارائه‌دهنده‌های
بارگذاری‌شده اعمال خواهد شد.
این گزینه را می‌توان چندین بار برای تنظیم چند پارامتر مشخص کرد.
گزینه‌هایی که ارائه‌دهنده‌های غیرپیش‌فرض را برای بارگذاری تعیین می‌کنند باید پیش از این گزینه
بیایند، چنانچه هدف اعمال تنظیمات بر روی ارائه‌دهنده‌های در حال بارگذاری باشد.
پارامترهایی که تنها بر مقداردهی اولیه ارائه‌دهنده تأثیر می‌گذارند، فعلاً باید در
فایل پیکربندی تنظیم شوند؛ تنها پارامترهایی که بعداً در صورت نیاز استعلام می‌شوند
هنگام تنظیم از طریق این رابط مؤثر خواهند بود.
تنها پارامترهایی با مقدار رشته UTF8 پشتیبانی می‌شوند.
برای هرگونه پارامتر پشتیبانی‌شده به مستندات ارائه‌دهنده خاص و الگوریتم‌های مرتبط با آن مراجعه کنید.
.IP "\fB\-propquery\fR \fIpropq\fR" 4
.IX Item "-propquery propq"
بند پرس‌وجوی ویژگی (\fIproperty query clause\fR) را مشخص می‌کند که باید هنگام بازیابی الگوریتم‌ها
از ارائه‌دهنده‌های بارگذاری‌شده به کار رود.
برای توضیحات دقیق‌تر به \fBproperty\fR\|(7) مراجعه کنید.
.SH "محیط (ENVIRONMENT)"
.IX Header "ENVIRONMENT"
کتابخانه‌های OpenSSL می‌توانند برخی پارامترهای پیکربندی را از
محیط دریافت کنند.
.PP
برای کسب اطلاعات درباره تمامی متغیرهای محیطی مورد استفاده توسط کتابخانه‌های OpenSSL،
مانند \fBOPENSSL_CONF\fR، \fBOPENSSL_MODULES\fR و \fBOPENSSL_TRACE\fR،
به \fBopenssl\-env\fR\|(7) مراجعه کنید.
.PP
برای اطلاعات درباره نحوه استفاده از متغیرهای محیطی در پیکربندی،
به "ENVIRONMENT" در \fBconfig\fR\|(5) مراجعه کنید.
.PP
برای اطلاعات در خصوص دستورهای خاص، به \fBopenssl\-engine\fR\|(1)،
\&\fBopenssl\-rehash\fR\|(1) و \fBtsget\fR\|(1) مراجعه کنید.
.PP
برای کسب اطلاعات درباره استعلام یا تعیین فلگ‌های معماری پردازنده (CPU)، به
\&\fBOPENSSL_armcap\fR\|(3)، \fBOPENSSL_ia32cap\fR\|(3)، \fBOPENSSL_ppccap\fR\|(3)،
\&\fBOPENSSL_s390xcap\fR\|(3) و \fBOPENSSL_riscvcap\fR\|(3) مراجعه فرمایید.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBopenssl\-asn1parse\fR\|(1),
\&\fBopenssl\-ca\fR\|(1),
\&\fBopenssl\-ciphers\fR\|(1),
\&\fBopenssl\-cms\fR\|(1),
\&\fBopenssl\-crl\fR\|(1),
\&\fBopenssl\-crl2pkcs7\fR\|(1),
\&\fBopenssl\-dgst\fR\|(1),
\&\fBopenssl\-dhparam\fR\|(1),
\&\fBopenssl\-dsa\fR\|(1),
\&\fBopenssl\-dsaparam\fR\|(1),
\&\fBopenssl\-ec\fR\|(1),
\&\fBopenssl\-ecparam\fR\|(1),
\&\fBopenssl\-enc\fR\|(1),
\&\fBopenssl\-engine\fR\|(1),
\&\fBopenssl\-errstr\fR\|(1),
\&\fBopenssl\-gendsa\fR\|(1),
\&\fBopenssl\-genpkey\fR\|(1),
\&\fBopenssl\-genrsa\fR\|(1),
\&\fBopenssl\-kdf\fR\|(1),
\&\fBopenssl\-list\fR\|(1),
\&\fBopenssl\-mac\fR\|(1),
\&\fBopenssl\-nseq\fR\|(1),
\&\fBopenssl\-ocsp\fR\|(1),
\&\fBopenssl\-passwd\fR\|(1),
\&\fBopenssl\-pkcs12\fR\|(1),
\&\fBopenssl\-pkcs7\fR\|(1),
\&\fBopenssl\-pkcs8\fR\|(1),
\&\fBopenssl\-pkey\fR\|(1),
\&\fBopenssl\-pkeyparam\fR\|(1),
\&\fBopenssl\-pkeyutl\fR\|(1),
\&\fBopenssl\-prime\fR\|(1),
\&\fBopenssl\-rand\fR\|(1),
\&\fBopenssl\-rehash\fR\|(1),
\&\fBopenssl\-req\fR\|(1),
\&\fBopenssl\-rsa\fR\|(1),
\&\fBopenssl\-rsautl\fR\|(1),
\&\fBopenssl\-s_client\fR\|(1),
\&\fBopenssl\-s_server\fR\|(1),
\&\fBopenssl\-s_time\fR\|(1),
\&\fBopenssl\-sess_id\fR\|(1),
\&\fBopenssl\-smime\fR\|(1),
\&\fBopenssl\-speed\fR\|(1),
\&\fBopenssl\-spkac\fR\|(1),
\&\fBopenssl\-srp\fR\|(1),
\&\fBopenssl\-storeutl\fR\|(1),
\&\fBopenssl\-ts\fR\|(1),
\&\fBopenssl\-verify\fR\|(1),
\&\fBopenssl\-version\fR\|(1),
\&\fBopenssl\-x509\fR\|(1),
\&\fBconfig\fR\|(5),
\&\fBcrypto\fR\|(7),
\&\fBopenssl\-env\fR\|(7),
\&\fBssl\fR\|(7),
\&\fBx509v3_config\fR\|(5)
.SH "تاریخچه (HISTORY)"
.IX Header "HISTORY"
گزینه‌های \fBlist\fR \-\fIXXX\fR\fB\-algorithms\fR در OpenSSL 1.0.0 افزوده شدند؛
برای نکاتی درباره در دسترس بودن سایر دستورها، به صفحات راهنمای اختصاصی
آن‌ها مراجعه کنید.
.PP
گزینه \fB\-issuer_checks\fR از نسخه OpenSSL 1.1.0 منسوخ شده است و
به طور خودکار نادیده گرفته می‌شود.
.PP
گزینه‌های \fB\-xcertform\fR و \fB\-xkeyform\fR
از نسخه OpenSSL 3.0 منسوخ شده‌اند و هیچ اثری ندارند.
.PP
حالت تعاملی، که می‌توانست با اجرای \f(CW\*(C`openssl\*(C'\fR
بدون هیچ آرگومان دیگری فراخوانی شود، در OpenSSL 3.0 حذف شد، و اکنون
اجرای این برنامه بدون آرگومان معادل \f(CW\*(C`openssl help\*(C'\fR است.
.SH "حق نشر (COPYRIGHT)"
.IX Header "COPYRIGHT"
حق نشر 2000\-2026 نویسندگان پروژه OpenSSL. کلیه حقوق محفوظ است.
.PP
تحت مجوز آپاچی نسخه 2.0 ("مجوز") ارائه شده است. شما مجاز به استفاده از
این فایل نیستید مگر با رعایت کامل شرایط مجوز. می‌توانید یک نسخه از
مجوز را در فایل LICENSE در بسته توزیع منبع یا در نشانی
<https://www.openssl.org/source/license.html> بیابید.