.TH ldns-gen-zone 1 "10 June 2010"
.SH "نام (NAME)"
ldns-gen-zone \- خواندن فایل ناحیه و چاپ آن همراه با افزودن رکوردهای DS و RRهای اضافی
.SH "خلاصه دستور (SYNOPSIS)"
.B ldns-gen-zone 
.IR ZONEFILE 

.SH "توضیحات (DESCRIPTION)"

\fBldns-gen-zone\fR یک فایل ناحیه DNS را می‌خواند و آن را چاپ می‌کند. 

این ابزار برای سرعت بالا طراحی و ساخته شده است، نه برای قالب‌بندی زیبا. خروجی در هر خط شامل یک رکورد منبع (resource record) است و هیچ‌گونه آرایش ظاهری یا زیباسازی ندارد.

داده‌های DNSSEC (شامل NSEC، NSEC3، RRSIG یا DNSKEY) حذف نمی‌شوند (strip نمی‌گردند). در صورت نیاز به حذف آن‌ها می‌توانید از \fBldns-read-zone\fR استفاده کنید. رکوردهای DS موجود نیز حذف نمی‌شوند.

هدف این است که از این ابزار برای تولید سریع یک فایل ناحیه مصنوعی شاخص از روی یک فایل ناحیه واقعی به منظور مقاصد آزمایشی استفاده شود.

.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-a NUM\fR
افزودن \fINUM\fR مجموعه رکورد (RRSet) ساختگی اضافی از نوع NS به خروجی. نام‌های مالک این RRSetها با 'xn--' آغاز می‌شوند تا یکتا بودن آن‌ها تضمین شود (ناحیه nl. از دامنه‌های بین‌المللی‌شده یا IDN پشتیبانی نمی‌کند \- و این ابزار با در نظر داشتن این نکته نوشته شده است).

یک RRSet ساختگی NS شامل دو رکورد NS است: ns1.example.com و ns2.example.com.

.TP
\fB\-p NUM\fR
افزودن \fINUM\fR درصد مجموعه رکورد DS به مجموعه‌های رکورد NS (بین ۱ تا ۴ رکورد DS به ازای هر RRSet).

.TP
\fB\-o ORIGIN\fR
تنظیم یک ORIGIN$؛ این گزینه می‌تواند مفید باشد اگر برای مثال مقدار موجود در فایل ناحیه روی '@' تنظیم شده باشد. در صورتی که ORIGIN$ در فایل ناحیه وجود داشته باشد، این گزینه بدون هشدار نادیده گرفته خواهد شد.

.TP
\fB\-s\fR
این روش توصیه‌شده برای پردازش ناحیه‌های بزرگی است که از پیش مرتب‌سازی و استانداردسازی (canonicalize، یعنی تبدیل به حروف کوچک) شده‌اند. این گزینه از مراحل مرتب‌سازی و استانداردسازی که برای گروه‌بندی مناسب RRSetها در کنار هم (پیش از افزودن هرگونه رکورد DS به آن‌ها) لازم است صرف‌نظر می‌کند. چشم‌پوشی از این مرحله سرعت انجام کار را افزایش می‌دهد.

استفاده از این گزینه در صورتی که می‌خواهید رکوردهای DS را به ناحیه‌های مرتب‌نشده و استانداردنشده اضافه کنید، توصیه نمی‌شود.

.TP
\fB\-h\fR
نمایش راهنمای استفاده و خروج.

.TP
\fB\-v\fR
نمایش نسخه و خروج.

.SH "مثال‌ها (EXAMPLES)"

.TP
\fBldns\-gen\-zone \-a 100000 \-p 10 \-s ./zonefile.txt\fR
خواندن یک فایل ناحیه، افزودن ۱۰۰٫۰۰۰ مجموعه رکورد ساختگی NS و ۱۰ درصد رکورد DS، و چاپ آن در خروجی استاندارد. ناحیه مرتب‌سازی نمی‌شود (این کار تنها در صورتی به‌خوبی عمل می‌کند که فایل ناحیه ورودی از قبل مرتب و استانداردسازی شده باشد).

.TP
\fBldns\-gen\-zone \-p 10 \-s \-o nl zonefile.txt | named\-compilezone \-s relative \-i none \-o zonefile_10.txt nl /dev/stdin\fR
این دستور با کمک \fBnamed\-compilezone\fR یک فایل ناحیه با قالب‌بندی مرتب ایجاد می‌کند. این کار ۱۰ درصد رکورد DS به ناحیه nl. اضافه کرده، آن را بازقالب‌بندی نموده و در \fBzonefile_10.txt\fR ذخیره می‌نماید.

.SH "نویسندگان (AUTHORS)"
در ابتدا توسط Marco Davids نوشته شد، همراه با اصلاحات متعددی از سوی Miek Gieben، هر دو از SIDN.

.SH "گزارش اشکال (REPORTING BUGS)"
گزارش اشکالات به <dns-team@nlnetlabs.nl>.

.SH "اشکالات (BUGS)"
تنها مواردی که هنوز کشف نشده‌اند.

.SH "هشدارها (CAVEATS)"
ممکن است برای فایل‌های ناحیه بزرگ به سیستمی با مقدار قابل‌توجهی حافظه نیاز داشته باشد.

هش‌های رکوردهای ساختگی DS با نوع خلاصه پیام SHA-256 (بر اساس RFC4509) تولید می‌شوند. توجه داشته باشید که اگر می‌خواهید همه چیز واقع‌گرایانه بماند، تعریف \fB#define DIGESTTYPE\fR در کد منبع را به مقداری به جز ۲ تغییر ندهید.

به‌رغم تلاش‌های بسیار، این برنامه همچنان سریع‌ترین ابزار در جهان نیست.

.SH "حق نشر (COPYRIGHT)"
حق نشر \(co 2010 SIDN. این نرم‌افزار آزاد است. هیچ‌گونه ضمانتی وجود ندارد؛ حتی برای قابلیت فروش یا تناسب با یک هدف خاص.