نام (NAME)

openssl-rand - تولید بایت‌های شبه‌تصادفی

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

openssl rand [-help] [-out file] [-base64] [-hex] [-engine id] [-rand files] [-writerand file] [-provider name] [-provider-path path] [-provparam [name:]key=value] [-propquery propq] num[K|M|G|T]

توضیحات (DESCRIPTION)

این دستور با استفاده از یک مولد اعداد شبه‌تصادفی امن از نظر رمزنگاری (CSPRNG)، تعداد num بایت تصادفی تولید می‌کند. می‌توان پسوند [K|M|G|T] را به مقدار num افزود تا نشان دهد مقدار درخواستی به ترتیب به عنوان مضربی از KiB/MiB/GiB/TiB مقیاس‌بندی شود. توجه داشته باشید که پسوندها به بزرگی و کوچکی حروف حساس هستند و نمایانگر مضارب باینری (دودویی) می‌باشند (K = 1024 بایت، M = 1024*1024 بایت و غیره).

می‌توان رشته 'max' را به جای یک مقدار عددی در num قرار داد، تا حداکثر تعداد بایت‌هایی که CSPRNG می‌تواند در هر نمونه‌سازی تولید کند درخواست شود. در حال حاضر، مطابق با NIST SP 800-90C، این مقدار به 2^61 بایت محدود شده است.

بایت‌های تصادفی با استفاده از تابع RAND_bytes(3) تولید می‌شوند که سطح امنیت ۲۵۶ بیت را فراهم می‌کند، به شرطی که بتواند با موفقیت بذردهی اولیه (seed) خود را از یک منبع آنتروپی قابل اعتماد در سیستم‌عامل انجام دهد. در غیر این صورت، دستور با یک کد خطای غیرصفر با شکست مواجه خواهد شد. برای جزئیات بیشتر، به RAND_bytes(3)، RAND(7) و EVP_RAND(7) مراجعه کنید.

گزینه‌ها (OPTIONS)

-help: نمایش یک پیام راهنمای نحوه استفاده.
-out file: نوشتن در file به جای خروجی استاندارد.
-base64: انجام کدگذاری base64 روی خروجی.
-hex: نمایش خروجی به صورت یک رشته هگز (hex).
-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) ببینید.

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

openssl(1), RAND_bytes(3), RAND(7), EVP_RAND(7)

تاریخچه (HISTORY)

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

حق نشر (COPYRIGHT)

حق نشر 2000-2021 نویسندگان پروژه OpenSSL. تمام حقوق محفوظ است.

تحت مجوز آپاچی، نسخه 2.0 ("مجوز") مجوزدهی شده است. شما نمی‌توانید از این فایل استفاده کنید مگر با رعایت مجوز. می‌توانید نسخه‌ای از مجوز را در فایل LICENSE در توزیع مبدا یا در https://www.openssl.org/source/license.html دریافت کنید.