.\" Copyright (c) 2004 Henrique de Moraes Holschuh -- hmh@debian.org
.\"
.TH RNGTEST 1 "March 2004" "rng-tools 6.17"

.SH "نام (NAME)"
rngtest \- بررسی تصادفی بودن داده‌ها با استفاده از آزمون‌های FIPS 140-2

.SH "خلاصه دستور (SYNOPSIS)"
.B rngtest
[\fB\-c\fR \fIn\fR | \fB\-\-blockcount=\fIn\fR]
[\fB\-b\fR \fIn\fR | \fB\-\-blockstats=\fIn\fR]
[\fB\-t\fR \fIn\fR | \fB\-\-timedstats=\fIn\fR]
[\fB\-p\fR | \fB\-\-pipe\fR]
[\fB\-?\fR] [\fB\-\-help\fR]
[\fB\-V\fR] [\fB\-\-version\fR]
.RI

.SH "توضیحات (DESCRIPTION)"
دستور
\fIrngtest\fR
روی بلوک‌هایی با اندازه ۲۰۰۰۰ بیت در هر نوبت کار می‌کند و از آزمون‌های FIPS 140-2 (اصلاحیه ۲۰۰۱-۱۰-۱۰) برای بررسی تصادفی بودن بلوک‌های داده استفاده می‌نماید.
.PP
ورودی را از
.I stdin
می‌گیرد و آمارها را در
.I stderr
خروجی می‌دهد؛ همچنین به‌صورت اختیاری بلوک‌هایی را که در آزمون‌های FIPS پذیرفته شده‌اند به
.I stdout
منتقل می‌کند (هنگام کار در حالت
\fIpipe\fR).
خطاها به
.I stderr
ارسال می‌شوند.
.PP
در هنگام راه‌اندازی، در صورت کار در حالت
\fIpipe\fR،
دستور
\fIrngtest\fR
نخستین ۳۲ بیت داده را دور می‌ریزد. این دستور از ۳۲ بیت بعدی برای راه‌اندازی اولیه (bootstrap) آزمون‌های FIPS استفاده می‌کند (حتی زمانی که در حالت
\fIpipe\fR
اجرا نشود). این بیت‌ها از نظر تصادفی بودن آزمایش نمی‌شوند.
.PP
هنگام خروج برنامه، آمارها در
.I stderr
تخلیه می‌شوند.

.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-p\fR, \fB\-\-pipe\fR
فعال کردن حالت
\fIpipe\fR.
تمام بلوک‌های داده‌ای که در آزمون‌های FIPS پذیرفته شوند به
.I stdout
ارسال می‌گردند و
\fIrngtest\fR
در حالت بی‌صدا کار می‌کند.
.TP
\fB\-c\fR \fIn\fR, \fB\-\-blockcount=\fIn\fR (پیش‌فرض: 0)
خروج پس از پردازش n بلوک ورودی، در صورتی که n غیرصفر باشد.
.TP
\fB\-b\fR \fIn\fR, \fB\-\-blockstats=\fIn\fR (پیش‌فرض: 0)
تخلیه آمارها پس از هر n بلوک، در صورتی که n غیرصفر باشد.
.TP
\fB\-t\fR \fIn\fR, \fB\-\-timedstats=\fIn\fR (پیش‌فرض: 0)
تخلیه آمارها پس از هر n ثانیه، در صورتی که n غیرصفر باشد.
.TP
\fB\-?\fR, \fB\-\-help\fR
ارائه خلاصه‌ای کوتاه از تمام گزینه‌های برنامه.
.TP
\fB\-V\fR, \fB\-\-version\fR
چاپ نسخه برنامه.

.SH "آمارها (STATISTICS)"
دستور
\fIrngtest\fR
هنگام خروج از برنامه، و همچنین هنگام فراخوانی توسط
\fIblockstats\fR
یا
\fItimedstats\fR،
آمارها را در
.I stderr
تخلیه می‌کند.
.PP
آمارهای
\fBFIPS 140-2 successes\fR
و
\fBFIPS 140-2 failures\fR
تعداد بلوک‌های ۲۰۰۰۰ بیتی پذیرفته‌شده یا ردشده در آزمون‌های FIPS 140-2 را شمارش می‌کنند. سایر آمارها تفکیک شکست‌های FIPS 140-2 را بر اساس نوع هر آزمون نشان می‌دهند. برای اطلاعات بیشتر به سند FIPS 140-2 مراجعه کنید (توجه داشته باشید که این آزمون‌ها در FIPS 140-1 و اصلاحیه ۲۰۰۱-۱۰-۱۰ از FIPS 140-2 تعریف شده‌اند. آن‌ها در اصلاحیه ۲۰۰۲-۱۲-۰۳ از FIPS 140-2 حذف شدند).
.PP
آمارهای سرعت برای هر بلوک ۲۰۰۰۰ بیتی منتقل‌شده یا پردازش‌شده محاسبه می‌شوند.

.SH "وضعیت خروج (EXIT STATUS)"
.TP
\fB0\fR
اگر هیچ خطایی رخ ندهد و هیچ بلوکی در آزمون‌های FIPS مردود نشود.
.TP
\fB1\fR
اگر هیچ خطایی رخ ندهد، اما دست‌کم یک بلوک در آزمون‌های FIPS مردود شود.
.TP
\fB10\fR
اگر در پارامترها مشکلی وجود داشته باشد.
.TP
\fB11\fR
اگر خطای ورودی/خروجی رخ دهد.
.TP
\fB12\fR
اگر خطای سیستم‌عامل یا کمبود منابع رخ دهد.

.SH "همچنین ببینید (SEE ALSO)"
random(4), rngd(8)
.TP
FIPS PUB 140-2 Security Requirements for Cryptographic Modules, NIST, 
http://csrc.nist.gov/groups/STM/cmvp/standards.html

.SH "نویسندگان (AUTHORS)"
Henrique de Moraes Holschuh <hmh@debian.org>