نام (NAME)

opendkim-genzone - ابزار تولید رکوردهای زون DNS برای کلیدهای DKIM

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

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]

توضیحات (DESCRIPTION)

دستور opendkim-genzone فایلی مناسب برای استفاده با named(8) تولید می‌کند تا مجموعه‌ای از کلیدهای عمومی را منتشر کند.

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

محتوای پایگاه داده باید طبق توضیحات ارائه‌شده برای پارامتر KeyTable، شرح داده شده در صفحه راهنمای opendkim.conf(5)، قالب‌بندی شود.

گزینه‌ها (OPTIONS)

-C contact

از contact به‌عنوان اطلاعات تماس مورد استفاده هنگام تولید رکورد SOA استفاده می‌کند (گزینه -S در زیر را ببینید). اگر مشخص نشود، شناسه کاربری (userid) کاربر اجراکننده و نام میزبان محلی استفاده خواهد شد؛ اگر کاربر اجراکننده قابل تشخیص نباشد، از «hostmaster» استفاده می‌شود.

-d domain

خروجی را تنها به رکوردهایی محدود می‌کند که فیلد دامنه آن‌ها، domain مشخص‌شده باشد.

-D

پسوند ._domainkey را به نام‌های انتخاب‌گر (selector) در فایل زون اضافه می‌کند.

-E secs

هنگام تولید رکورد SOA (گزینه -S در زیر را ببینید)، از secs به‌عنوان زمان انقضای پیش‌فرض رکورد استفاده می‌کند. مقدار پیش‌فرض ۶۰۴۸۰۰ ثانیه است.

-F

پسوند ._domainkey و نام دامنه را به نام‌های انتخاب‌گر در فایل زون اضافه می‌کند.

-N nslist

فهرستی از کارگزارهای نام (nameservers) جداشده با کاما را مشخص می‌کند که در رکوردهای NS قبل از رکوردهای TXT در خروجی قرار می‌گیرند. اولین کارگزار نام در این فهرست، در صورت مشخص بودن گزینه -S، در رکورد SOA نیز به‌عنوان نام میزبان مرجع (authority hostname) استفاده خواهد شد.

-o file

خروجی را به جای خروجی استاندارد، به فایل تعیین‌شده file ارسال می‌کند.

-r secs

هنگام تولید رکورد SOA (گزینه -S در زیر را ببینید)، از secs به‌عنوان زمان تازه‌سازی (refresh) زون استفاده می‌کند. مقدار پیش‌فرض ۱۰۸۰۰ ثانیه است.

-R secs

هنگام تولید رکورد SOA (گزینه -S در زیر را ببینید)، از secs به‌عنوان زمان تلاش مجدد (retry) زون استفاده می‌کند. مقدار پیش‌فرض ۱۸۰۰ ثانیه است.

-s

منطق گزینه -d را برای شامل شدن زیردامنه‌ها گسترش می‌دهد.

-S

درخواست می‌کند یک رکورد SOA در بالای خروجی تولید شود. محتوای این خروجی را می‌توان با استفاده از گزینه‌های -E، -r، -R و -T کنترل کرد. شماره سریال بر اساس زمان جاری روز تولید خواهد شد.

-t ttl

مقدار TTL (طول عمر) به اندازه ttl را روی تمام رکوردهای خروجی اعمال می‌کند. واحد آن بر حسب ثانیه است.

-T secs

هنگام تولید رکورد SOA (گزینه -S در زیر را ببینید)، از secs به‌عنوان زمان پیش‌فرض TTL رکورد استفاده می‌کند. مقدار پیش‌فرض ۸۶۴۰۰ ثانیه است.

-u

خروجی مناسب برای استفاده به‌عنوان ورودی دستور nsupdate(8) تولید می‌کند.

-v

میزان پرگویی و جزئیات خروجی اشکال‌زدایی نوشته‌شده در خطای استاندارد را افزایش می‌دهد.

-x conffile

نام یک فایل opendkim.conf(5) را مشخص می‌کند تا هنگام ارائه مجموعه داده LDAP در خط فرمان، پارامترهای مربوط به LDAP از آن خوانده شود. برای سایر انواع مجموعه داده الزامی نیست. مقدار پیش‌فرض /etc/opendkim/opendkim.conf است.

نسخه (VERSION)

این صفحه راهنما نسخه opendkim-genzone عرضه‌شده به همراه نسخه 2.11.0 نرم‌افزار OpenDKIM را پوشش می‌دهد.

حق نشر (COPYRIGHT)

حق نشر (c) 2010, 2012, 2014, 2015 متعلق به The Trusted Domain Project است. کلیه حقوق محفوظ است.

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

nsupdate(8), opendkim(8), opendkim.conf(5)