.TH opendkim-genzone 8 "The Trusted Domain Project"
.SH "نام (NAME)"
opendkim-genzone \- ابزار تولید رکوردهای زون DNS برای کلیدهای DKIM
.SH "خلاصه دستور (SYNOPSIS)"
.B opendkim-genzone
[\-C address]
[\-d domain]
[\-D]
[\-E secs]
[\-F]
[\-N ns[,...]]
[\-o file]
[\-r secs]
[\-R secs]
[\-s]
[\-S]
[\-t secs]
[\-T secs]
[\-u]
[\-v]
[\-x conffile]
[dataset]
.SH "توضیحات (DESCRIPTION)"
دستور
.B opendkim-genzone
فایلی مناسب برای استفاده با
.I named(8)
تولید می‌کند تا مجموعه‌ای از کلیدهای عمومی را منتشر کند.

پارامتر
.I dataset
باید مجموعه‌ای از داده‌ها را طبق آنچه در صفحه راهنمای
.I opendkim(8)
توضیح داده شده است مشخص کند. این پارامتر در حال حاضر می‌تواند به فایل‌های متنی ساده (flat files)، پایگاه‌های داده Sleepycat، فهرست‌های جداشده با کاما، دایرکتوری‌های LDAP یا پایگاه‌های داده SQL اشاره کند. در صورتی که یک فایل پیکربندی (از طریق گزینه خط فرمان
.IR \-x )
مشخص شده باشد که پارامتر
.I KeyTable
را تنظیم کند، می‌توان از
.I dataset
صرف‌نظر کرد که در این صورت از همان مقدار استفاده خواهد شد.

محتوای پایگاه داده باید طبق توضیحات ارائه‌شده برای پارامتر
.IR KeyTable ،
شرح داده شده در صفحه راهنمای
.IR opendkim.conf(5) ،
قالب‌بندی شود.
.SH "گزینه‌ها (OPTIONS)"
.TP
.I \-C contact
از
.I contact
به‌عنوان اطلاعات تماس مورد استفاده هنگام تولید رکورد SOA استفاده می‌کند (گزینه
.I \-S
در زیر را ببینید). اگر مشخص نشود، شناسه کاربری (userid) کاربر اجراکننده و نام میزبان محلی استفاده خواهد شد؛ اگر کاربر اجراکننده قابل تشخیص نباشد، از «hostmaster» استفاده می‌شود.
.TP
.I \-d domain
خروجی را تنها به رکوردهایی محدود می‌کند که فیلد دامنه آن‌ها،
.I domain
مشخص‌شده باشد.
.TP
.I \-D
پسوند
.B "._domainkey"
را به نام‌های انتخاب‌گر (selector) در فایل زون اضافه می‌کند.
.TP
.I \-E secs
هنگام تولید رکورد SOA (گزینه
.I \-S
در زیر را ببینید)، از
.I secs
به‌عنوان زمان انقضای پیش‌فرض رکورد استفاده می‌کند. مقدار پیش‌فرض ۶۰۴۸۰۰ ثانیه است.
.TP
.I \-F
پسوند
.B "._domainkey"
و نام دامنه را به نام‌های انتخاب‌گر در فایل زون اضافه می‌کند.
.TP
.I \-N nslist
فهرستی از کارگزارهای نام (nameservers) جداشده با کاما را مشخص می‌کند که در رکوردهای NS قبل از رکوردهای TXT در خروجی قرار می‌گیرند. اولین کارگزار نام در این فهرست، در صورت مشخص بودن گزینه
.IR \-S ،
در رکورد SOA نیز به‌عنوان نام میزبان مرجع (authority hostname) استفاده خواهد شد.
.TP
.I \-o file
خروجی را به جای خروجی استاندارد، به فایل تعیین‌شده
.I file
ارسال می‌کند.
.TP
.I \-r secs
هنگام تولید رکورد SOA (گزینه
.I \-S
در زیر را ببینید)، از
.I secs
به‌عنوان زمان تازه‌سازی (refresh) زون استفاده می‌کند. مقدار پیش‌فرض ۱۰۸۰۰ ثانیه است.
.TP
.I \-R secs
هنگام تولید رکورد SOA (گزینه
.I \-S
در زیر را ببینید)، از
.I secs
به‌عنوان زمان تلاش مجدد (retry) زون استفاده می‌کند. مقدار پیش‌فرض ۱۸۰۰ ثانیه است.
.TP
.I \-s
منطق گزینه
.B \-d
را برای شامل شدن زیردامنه‌ها گسترش می‌دهد.
.TP
.I \-S
درخواست می‌کند یک رکورد SOA در بالای خروجی تولید شود. محتوای این خروجی را می‌توان با استفاده از گزینه‌های
.IR \-E ،
.IR \-r ،
.IR \-R
و
.I \-T
کنترل کرد. شماره سریال بر اساس زمان جاری روز تولید خواهد شد.
.TP
.I \-t ttl
مقدار TTL (طول عمر) به اندازه
.I ttl
را روی تمام رکوردهای خروجی اعمال می‌کند. واحد آن بر حسب ثانیه است.
.TP
.I \-T secs
هنگام تولید رکورد SOA (گزینه
.I \-S
در زیر را ببینید)، از
.I secs
به‌عنوان زمان پیش‌فرض TTL رکورد استفاده می‌کند. مقدار پیش‌فرض ۸۶۴۰۰ ثانیه است.
.TP
.I \-u
خروجی مناسب برای استفاده به‌عنوان ورودی دستور
.B nsupdate(8)
تولید می‌کند.
.TP
.I \-v
میزان پرگویی و جزئیات خروجی اشکال‌زدایی نوشته‌شده در خطای استاندارد را افزایش می‌دهد.
.TP
.I \-x conffile
نام یک فایل
.I opendkim.conf(5)
را مشخص می‌کند تا هنگام ارائه مجموعه داده LDAP در خط فرمان، پارامترهای مربوط به LDAP از آن خوانده شود. برای سایر انواع مجموعه داده الزامی نیست. مقدار پیش‌فرض
.I /etc/opendkim/opendkim.conf
است.
.SH "نسخه (VERSION)"
این صفحه راهنما نسخه
.I opendkim-genzone
عرضه‌شده به همراه نسخه 2.11.0 نرم‌افزار
.I OpenDKIM
را پوشش می‌دهد.
.SH "حق نشر (COPYRIGHT)"
حق نشر (c) 2010, 2012, 2014, 2015 متعلق به The Trusted Domain Project است.
کلیه حقوق محفوظ است.
.SH "همچنین ببینید (SEE ALSO)"
.I nsupdate(8),
.I opendkim(8),
.I opendkim.conf(5)