نام (NAME)

openssl-speed - سنجش عملکرد کتابخانه

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

openssl speed [-help] [-config filename] [-elapsed] [-evp algo] [-hmac algo] [-cmac algo] [-mb] [-aead] [-kem-algorithms] [-signature-algorithms] [-multi num] [-async_jobs num] [-misalign num] [-decrypt] [-primes num] [-seconds num] [-bytes num] [-mr] [-mlock] [-testmode] [-rand files] [-writerand file] [-engine id] [-provider name] [-provider-path path] [-provparam [name:]key=value] [-propquery propq] [algorithm ...]

توضیحات (DESCRIPTION)

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

گزینه‌ها (OPTIONS)

-help: نمایش پیام راهنمای نحوه استفاده.
-config filename: فایل پیکربندی مورد استفاده را مشخص می‌کند. اختیاری است؛ برای شرح مقدار پیش‌فرض، به «خلاصه دستورات» (COMMAND SUMMARY) در openssl(1) مراجعه کنید.
-elapsed: هنگام محاسبه تعداد عملیات یا بایت بر ثانیه، به جای زمان کاربری CPU از زمان واقعی سپری‌شده (wall-clock time) به عنوان مقسوم‌علیه استفاده می‌کند. این گزینه هنگام سنجش سرعت موتورهای سخت‌افزاری می‌تواند مفید باشد.
-evp algo: استفاده از الگوریتم رمزنگاری یا خلاصه پیام مشخص‌شده از طریق رابط EVP. اگر algo یک رمزنگار AEAD باشد، می‌توانید -aead را برای بنچمارک یک دنباله شبه-TLS ارسال کنید. همچنین اگر algo رمزنگاری با قابلیت بافر چندگانه باشد، مانند aes-128-cbc-hmac-sha1، گزینهٔ -mb زمان اجرای عملیات چندبافره را اندازه‌گیری می‌کند.
برای مشاهده الگوریتم‌های پشتیبانی‌شده توسط این گزینه، از دستور "openssl list -digest-algorithms" یا "openssl list -cipher-algorithms" استفاده کنید.
-multi num: اجرای چندین عملیات به صورت موازی.
-async_jobs num: فعال‌سازی حالت ناهمگام (async) و آغاز تعداد مشخصی کار.
-misalign num: ناهمتراز کردن بافرها به تعداد بایت مشخص‌شده.
-hmac digest: زمان‌سنجی الگوریتم HMAC با استفاده از خلاصه پیام مشخص‌شده.
-cmac cipher: زمان‌سنجی الگوریتم CMAC با استفاده از رمزنگار مشخص‌شده، مانند: "openssl speed -cmac aes128";.
-decrypt: زمان‌سنجی رمزگشایی به جای رمزگذاری. تنها بر آزمون EVP تأثیر می‌گذارد.
-mb: فعال‌سازی حالت چندبلوکی روی رمزنگار نام‌گذاری‌شده در EVP.
-aead: بنچمارک رمزنگار AEAD نام‌گذاری‌شده در EVP در یک توالی شبه-TLS.
-kem-algorithms: بنچمارک الگوریتم‌های KEM: تولید کلید، کپسوله‌سازی و کپسوله‌گشایی.
-signature-algorithms: بنچمارک الگوریتم‌های امضا: تولید کلید، امضا و اعتبارسنجی.
-primes num: تولید یک کلید RSA با num عدد اول و استفاده از آن برای اجرای بنچمارک‌ها. این گزینه تنها در صورتی مؤثر است که الگوریتم RSA برای آزمایش مشخص شده باشد.
-seconds num: اجرای بنچمارک‌ها به مدت num ثانیه.
-bytes num: اجرای بنچمارک‌ها روی بافرهای num بایتی. بر رمزنگارها، خلاصه‌ها و CSPRNG تأثیر می‌گذارد. محدودیت اندازه بافر برابر با INT_MAX - 64 بایت است که برای یک عدد صحیح ۳۲ بیتی برابر با ۲۱۴۷۴۸۳۵۸۳ بایت خواهد بود.
-mr: تولید خلاصه در قالبی مکانیکی و ماشین‌خوان.
-mlock: قفل کردن حافظه در RAM برای دستیابی به اندازه‌گیری‌های قطعی‌تر.
-testmode: اجرای دستور speed در حالت آزمایشی (testmode). صرف‌نظر از مقدار گزینهٔ -seconds، تنها ۱ تکرار از آزمون هر الگوریتم اجرا می‌شود. در صورتی که هر عملیاتی شکست بخورد، دستور speed با نتیجه شکست بازمی‌گردد.
-rand files, -writerand file: برای جزئیات بیشتر به «گزینه‌های وضعیت تصادفی (Random State Options)» در openssl(1) مراجعه کنید.
-engine id: به «گزینه‌های موتور (Engine Options)» در openssl(1) مراجعه کنید. این گزینه منسوخ شده است.
-provider name
-provider-path path
-provparam [name:]key=value
-propquery propq: به «گزینه‌های ارائه‌دهنده (Provider Options)» در openssl(1)، provider(7) و property(7) مراجعه کنید.
algorithm ...: اگر هر algorithm مشخص شود، آن الگوریتم‌ها مورد آزمایش قرار می‌گیرند؛ در غیر این صورت مجموعه‌ای جامع از پیش کامپایل‌شده آزمایش می‌شود.

اشکالات (BUGS)

پارامتر algorithm تنها می‌تواند از میان زیرمجموعه‌ای از پیش کامپایل‌شده که دستور "openssl speed" می‌شناسد انتخاب شود. برای سنجش هرگونه الگوریتم رمزنگار یا خلاصه پیام دیگری که توسط OpenSSL پشتیبانی می‌شود، از گزینهٔ "-evp" استفاده کنید.

هیچ روشی برای سنجش سرعت الگوریتم‌های کلید عمومی دیگری که توسط ارائه‌دهندگان شخص ثالث پشتیبانی می‌شوند با استفاده از دستور "openssl speed" وجود ندارد.

تاریخچه (HISTORY)

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

الگوریتم DSA512 در OpenSSL 3.2 حذف گردید.

گزینهٔ -testmode در OpenSSL 3.4 اضافه شد.

حق نشر (COPYRIGHT)

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