نام (NAME)

openssl-list - فهرست کردن الگوریتم‌ها و قابلیت‌ها

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

openssl list [-help] [-verbose] [-select name] [-1] [-all-algorithms] [-commands] [-standard-commands] [-digest-algorithms] [-digest-commands] [-kdf-algorithms] [-mac-algorithms] [-random-instances] [-random-generators] [-cipher-algorithms] [-cipher-commands] [-encoders] [-decoders] [-key-managers] [-skey-managers] [-key-exchange-algorithms] [-kem-algorithms] [-tls-groups] [-all-tls-groups] [-tls1_2] [-tls1_3] [-signature-algorithms] [-tls-signature-algorithms] [-asymcipher-algorithms] [-public-key-algorithms] [-public-key-methods] [-store-loaders] [-providers] [-engines] [-disabled] [-objects] [-options command] [-provider name] [-provider-path path] [-provparam [name:]key=value] [-propquery propq]

توضیحات (DESCRIPTION)

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

گزینه‌ها (OPTIONS)

-help: نمایش پیام راهنمای نحوه استفاده.
-verbose: نمایش اطلاعات تکمیلی. در گزینه‌های زیر که حالت پرگو (verbose) برای آن‌ها کاربرد دارد، جزئیات بیشتری درباره مفهوم آن بیان شده است.
-select name: تنها الگوریتم‌هایی را فهرست می‌کند که با این نام مطابقت دارند.
-1: دستورات، digest-commands یا cipher-commands را در یک ستون منفرد فهرست می‌کند. در صورت استفاده، این گزینه باید به عنوان اولین گزینه مشخص شود.
-all-algorithms: نمایش فهرست‌هایی از تمام الگوریتم‌ها. این موارد شامل موارد زیر هستند:

رمزهای نامتقارن (Asymmetric ciphers)
رمزگشاها (Decoders)
چکیده‌ها (Digests)
رمزگذارها (Encoders)
الگوریتم‌های اشتقاق کلید (KDF)
روش‌های کپسوله‌سازی کلید (KEM)
الگوریتم‌های تبادل کلید (KEX)
مدیران کلید (Key managers)
مدیران کلید متقارن (Symmetric key managers)
الگوریتم‌های کد اصالت‌سنجی پیام (MAC)
مولدهای اعداد تصادفی (RNG, DRBG)
الگوریتم‌های امضا (Signature algorithms)
بارگذارهای مخزن (Store loaders)
رمزهای متقارن (Symmetric ciphers)

-commands: نمایش فهرستی از دستورات استاندارد.
-standard-commands: فهرست کردن دستورات استاندارد.
-digest-commands: این گزینه منسوخ شده است. به جای آن از digest-algorithms استفاده کنید.
نمایش فهرستی از دستورات چکیده پیام (message digest) که معمولاً به عنوان ورودی دستورات openssl-dgst(1) یا openssl-speed(1) استفاده می‌شوند.
-cipher-commands: این گزینه منسوخ شده است. به جای آن از cipher-algorithms استفاده کنید.
نمایش فهرستی از دستورات رمزنگاری (cipher) که معمولاً به عنوان ورودی دستورات openssl-enc(1) یا openssl-speed(1) استفاده می‌شوند.
-cipher-algorithms, -digest-algorithms, -kdf-algorithms, -mac-algorithms,: نمایش فهرستی از الگوریتم‌های رمز متقارن، چکیده (digest)، kdf و mac. برای آشنایی با نحوه نمایش نام‌ها، بخش «نحوه نمایش نام الگوریتم‌ها» را ببینید.
در حالت پرگو (verbose)، به الگوریتم‌های ارائه‌شده توسط یک ارائه‌دهنده، اطلاعات بیشتری در مورد پارامترهای پشتیبانی‌شده توسط هر پیاده‌سازی افزوده خواهد شد.
-random-instances: فهرست کردن جزئیات مولدهای اعداد تصادفی اصلی (primary)، عمومی (public) و خصوصی (private).
-random-generators: نمایش فهرستی از مولدهای اعداد تصادفی. برای آشنایی با نحوه نمایش نام‌ها، بخش «نحوه نمایش نام الگوریتم‌ها» را ببینید.
-encoders: نمایش فهرستی از رمزگذارها (encoders). برای آشنایی با نحوه نمایش نام‌ها، بخش «نحوه نمایش نام الگوریتم‌ها» را ببینید.
در حالت پرگو (verbose)، به الگوریتم‌های ارائه‌شده توسط یک ارائه‌دهنده، اطلاعات بیشتری در مورد پارامترهای پشتیبانی‌شده توسط هر پیاده‌سازی افزوده خواهد شد.
-decoders: نمایش فهرستی از رمزگشاها (decoders). برای آشنایی با نحوه نمایش نام‌ها، بخش «نحوه نمایش نام الگوریتم‌ها» را ببینید.
در حالت پرگو (verbose)، به الگوریتم‌های ارائه‌شده توسط یک ارائه‌دهنده، اطلاعات بیشتری در مورد پارامترهای پشتیبانی‌شده توسط هر پیاده‌سازی افزوده خواهد شد.
-public-key-algorithms: نمایش فهرستی از الگوریتم‌های کلید عمومی؛ هر الگوریتم به صورت یک بلوک چندخطی نمایش داده می‌شود که تمام خطوط آن به جز خط نخست دارای تورفتگی هستند. گزینه‌های key-exchange-algorithms، kem-algorithms، signature-algorithms و asymcipher-algorithms نیز اطلاعات مشابهی را نمایش می‌دهند.
-public-key-methods: نمایش فهرستی از روش‌های کلید عمومی (public key methods).
-key-managers: نمایش فهرستی از مدیران کلید (key managers).
-skey-managers: نمایش فهرستی از مدیران کلید متقارن (symmetric key managers).
-key-exchange-algorithms: نمایش فهرستی از الگوریتم‌های تبادل کلید (key exchange algorithms).
-kem-algorithms: نمایش فهرستی از الگوریتم‌های کپسوله‌سازی کلید (KEM).
-tls-groups: نمایش فهرستی از نام‌های IANA تمام گروه‌های TLS در دسترس (پیاده‌سازی‌شده). به‌طور پیش‌فرض، گروه‌های فهرست‌شده آن‌هایی هستند که با TLS 1.3 سازگاری دارند.
-all-tls-groups: نمایش فهرستی از نام‌های تمام گروه‌های TLS در دسترس (پیاده‌سازی‌شده)، از جمله تمامی نام‌های مستعار (aliases). برخی از گروه‌ها با چندین نام شناخته می‌شوند؛ به عنوان مثال، secp256r1 با نام P-256 نیز شناخته می‌شود. به‌طور پیش‌فرض، گروه‌های فهرست‌شده آن‌هایی هستند که با TLS 1.3 سازگاری دارند.
-tls1_2: هنگام فهرست کردن گروه‌های TLS، آن‌هایی را که با TLS 1.2 سازگار هستند فهرست می‌کند.
-tls1_3: هنگام فهرست کردن گروه‌های TLS، آن‌هایی را که با TLS 1.3 سازگار هستند در خروجی نمایش می‌دهد. در حال حاضر TLS 1.3 نسخه پیش‌فرض پروتکل است، اما نسخه پیش‌فرض ممکن است تغییر کند، بنابراین بهتر است نسخه به طور صریح مشخص شود.
-signature-algorithms: نمایش فهرستی از الگوریتم‌های امضا (signature algorithms).
-tls-signature-algorithms: نمایش فهرستی از الگوریتم‌های امضای موجود برای دست‌تکانی TLS (یا TLS handshake) که توسط تمامی ارائه‌دهندگان (providers) فعال کنونی عرضه شده‌اند. قالب خروجی با دونقطه (:) جدا شده و در شکلی است که مستقیماً در SSL_CONF_cmd(3) با تعیین SignatureAlgorithms قابل استفاده است.
-asymcipher-algorithms: نمایش فهرستی از الگوریتم‌های رمزنگاری نامتقارن (asymmetric cipher algorithms).
-store-loaders: نمایش فهرستی از بارگذارهای مخزن (store loaders).
-providers: نمایش فهرستی از تمام ارائه‌دهندگان (providers) بارگذاری‌شده به همراه نام، نسخه و وضعیت آن‌ها.
در حالت پرگو (verbose)، نسخه کامل و تمام پارامترهای ارائه‌دهنده نیز علاوه بر این نمایش داده خواهند شد.
-engines: این گزینه منسوخ شده است.
نمایش فهرستی از موتورهای (engines) بارگذاری‌شده.
-disabled: نمایش فهرستی از قابلیت‌های غیرفعال‌شده؛ مواردی که در هنگام کامپایل از نصب حذف شده‌اند.
-objects: نمایش فهرستی از اشیای توکار، یعنی OIDها به همراه نام‌ها. آن‌ها در قالبی که در بخش «ماژول پیکربندی شیء ASN1» در config(5) توضیح داده شده است فهرست می‌شوند.
-options command: خروجی دادن یک فهرست دو ستونی از گزینه‌های پذیرفته‌شده توسط command مشخص‌شده. مورد اول نام گزینه است و مورد دوم نشانه‌ای تک‌کاراکتری از نوع پارامتری است که در صورت وجود دریافت می‌کند. این یک گزینه داخلی است که برای بررسی کامل بودن مستندات به کار می‌رود.
-provider name
-provider-path path
-provparam [name:]key=value
-propquery propq: «گزینه‌های ارائه‌دهنده» (Provider Options) را در openssl(1)، provider(7) و property(7) ببینید.

نحوه نمایش نام الگوریتم‌ها (Display of algorithm names)

نام الگوریتم‌ها ممکن است به یکی از دو شیوه نمایش داده شود:

پیاده‌سازی‌های موروثی (Legacy implementations)

پیاده‌سازی‌های موروثی به سادگی نام اصلی الگوریتم را در یک خط مجزا، یا به قالب "<foo " bar>> نمایش می‌دهند تا نشان دهند که "foo" یک نام مستعار برای نام اصلی، یعنی "bar" است.

پیاده‌سازی‌های ارائه‌شده (Provided implementations)

پیاده‌سازی‌های حاصل از یک ارائه‌دهنده (provider) در صورتی که با یک نام منفرد برچسب خورده باشند به این شکل نمایش داده می‌شوند:

foo @ bar

یا در صورتی که با چند نام برچسب خورده باشند به این صورت نمایش می‌یابند:

{ foo1, foo2 } @bar

در هر دو حالت، "bar" نام ارائه‌دهنده است.

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

openssl(1), config(5), provider(7), property(7)

تاریخچه (HISTORY)

گزینه‌های -engines، -digest-commands و -cipher-commands در OpenSSL 3.0 منسوخ شدند.

گزینه -skey-managers در OpenSSL 3.5 اضافه شد.

حق نشر (COPYRIGHT)

حق نشر ۲۰۱۶-۲۰۲۵ نویسندگان پروژه OpenSSL. کلیه حقوق محفوظ است.

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