.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH nethsm-random 1  "nethsm-random "
.SH "نام (NAME)"
nethsm\-random \- تولید بایت‌های تصادفی امن رمزنگاری‌شده توسط NetHSM
.SH "خلاصه دستور (SYNOPSIS)"
\fBnethsm random\fR [\fB\-f\fR|\fB\-\-force\fR] [\fB\-o\fR|\fB\-\-output\fR] [\fB\-a\fR|\fB\-\-auth\-passphrase\-file\fR] [\fB\-c\fR|\fB\-\-config\fR] [\fB\-l\fR|\fB\-\-label\fR] [\fB\-u\fR|\fB\-\-user\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fILENGTH\fR>
.SH "توضیحات (DESCRIPTION)"
دریافت بایت‌های تصادفی از دستگاه.
.PP
مگر اینکه فایل خروجی مشخصی انتخاب شده باشد، تعداد مشخص‌شده از بایت‌های تصادفی را در خروجی استاندارد (stdout) می‌نویسد.
.PP
نیازمند احراز هویت کاربری با نقش «اپراتور» (Operator) است.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-f\fR, \fB\-\-force\fR
نوشتن در فایل خروجی حتی اگر از قبل وجود داشته باشد
.RS
همچنین می‌تواند با متغیر محیطی \fBNETHSM_FORCE\fR مشخص شود.
.RE
.TP
\fB\-o\fR, \fB\-\-output\fR \fI<OUTPUT>\fR
مسیر اختیاری برای یک فایل خروجی مشخص
.RS
همچنین می‌تواند با متغیر محیطی \fBNETHSM_RANDOM_OUTPUT_FILE\fR مشخص شود.
.RE
.TP
\fB\-a\fR, \fB\-\-auth\-passphrase\-file\fR \fI<AUTH_PASSPHRASE_FILE>\fR
مسیر فایل حاوی عبارت عبور (passphrase) برای احراز هویت
.PP
عبارت عبور ارائه‌شده در فایل باید متعلق به کاربری باشد که برای این دستور انتخاب شده است.
.PP
این گزینه می‌تواند چندین بار مشخص شود، که برای دستوراتی که به‌طور هم‌زمان به چندین نقش نیاز دارند لازم است.
در صورت استفاده از چند فایل عبارت عبور، ترتیب آن‌ها اهمیت دارد، زیرا فایل‌ها به کاربر متناظر ارائه‌شده با گزینه «\-\-user» اختصاص می‌یابند.
.RS
همچنین می‌تواند با متغیر محیطی \fBNETHSM_AUTH_PASSPHRASE_FILE\fR مشخص شود.
.RE
.TP
\fB\-c\fR, \fB\-\-config\fR \fI<CONFIG>\fR
مسیر فایل پیکربندی سفارشی
.PP
در صورت تعیین، فایل پیکربندی سفارشی به‌جای مسیر پیش‌فرض فایل پیکربندی استفاده می‌شود.
.RS
همچنین می‌تواند با متغیر محیطی \fBNETHSM_CONFIG\fR مشخص شود.
.RE
.TP
\fB\-l\fR, \fB\-\-label\fR \fI<LABEL>\fR
برچسبی برای شناسایی یکتای دستگاه در فایل پیکربندی
.PP
اگر بیش از یک دستگاه در فایل پیکربندی تنظیم شده باشد، ارائه این گزینه الزامی است.
.RS
همچنین می‌تواند با متغیر محیطی \fBNETHSM_LABEL\fR مشخص شود.
.RE
.TP
\fB\-u\fR, \fB\-\-user\fR \fI<USER>\fR
نام کاربری مورد استفاده برای دستور
.PP
اگر در فایل پیکربندی هیچ نام کاربری برای دستگاه تنظیم نشده باشد، می‌تواند ارائه شود.
اگر چندین نام کاربری با همان نقش هدف در فایل پیکربندی برای یک دستگاه تنظیم شده باشد، ارائه این گزینه الزامی است.
.PP
این گزینه می‌تواند چندین بار مشخص شود، که برای دستوراتی که به‌طور هم‌زمان به چندین نقش نیاز دارند لازم است.
.RS
همچنین می‌تواند با متغیر محیطی \fBNETHSM_USER\fR مشخص شود.
.RE
.TP
\fB\-h\fR, \fB\-\-help\fR
نمایش راهنما (مشاهده خلاصه با \*(Aq\-h\*(Aq)
.TP
<\fILENGTH\fR>
تعداد بایت‌های تصادفی برای بازگرداندن
.RS
همچنین می‌تواند با متغیر محیطی \fBNETHSM_RANDOM_LENGTH\fR مشخص شود.
.RE