نام (NAME)

gdnsd.zonefile - قالب پرونده‌های منطقه (zone) در gdnsd

خلاصه (SYNOPSIS)

example.com:

$TTL 86400
@     SOA ns1 dns-admin (
      1      ; serial
      7200   ; refresh
      30M    ; retry
      3D     ; expire
      900    ; ncache
)
@     NS      ns1.example.com.
@     NS      ns2
@     NS      ns.example.net.
ns1   A       192.0.2.1 ; a comment
ns2.example.com.      A       192.0.2.2
@     7200    MX      10 mail-a
@     7200    MX      100 mail-b
$ttl 86400
; a comment
mail-a        A 192.0.2.3
mail-b        A 192.0.2.4
subz          NS      ns1.subz
subz          NS      ns2.subz
ns1.subz      A       192.0.2.5
ns2.subz      A       192.0.2.6
www   600/10  DYNA    some_plugin!resource_name
alias         CNAME   www
_http._tcp    1800    SRV     5 500 80 www
foo           TXT     "blah blah" "blah"
_spf          TXT     "v=spf1 ..."

توضیحات (DESCRIPTION)

این نحوِ اصلی پرونده منطقه (zonefile) برای gdnsd(8) است. نحو طوری طراحی شده است که تا جای ممکن به نحو استاندارد پرونده منطقه از RFC 1035 (که قالب «استاندارد» دیده‌شده در کارگزارهای سنتی BIND است) نزدیک باشد. این سند تنها به چند نکته برجسته مهم و/یا انحرافات از قاعده استاندارد می‌پردازد.

دستورالعمل‌ها (DIRECTIVES)

دستورالعمل‌های استاندارد $TTL، $ORIGIN و $INCLUDE با نحو و معناشناسی معمول خود پشتیبانی می‌شوند:

$TTL مقدار پیش‌فرض TTL هر رکوردی را که پس از آن می‌آید تغییر می‌دهد و می‌تواند چندین بار تکرار شود. توجه داشته باشید که در نبود تنظیم $TTL در سطح پرونده منطقه، مقدار پیش‌فرض TTL از گزینه پیکربندی سراسری "zones_default_ttl" گرفته می‌شود که مقدار پیش‌فرض آن 86400 (۱ روز) است.

$ORIGIN آنچه را که از آن نقطه به بعد به نام‌های میزبان فاقد صلاحیت (unqualified hostnames، یعنی آن‌هایی که نقطه پایانی "." ندارند) و همچنین هر مدخل "@" (که نام مستعاری برای مبدا فعلی است) الحاق می‌شود، تغییر می‌دهد. خود $ORIGIN نیز ممکن است یک نام فاقد صلاحیت باشد، که در این حالت مبدا قبلی به انتهای آن اضافه می‌شود. هر $ORIGIN دارای صلاحیت کامل (fully-qualified) باید در محدوده منطقه‌ای باشد که توسط این پرونده منطقه توصیف شده است. مبدا پیش‌فرض، نام خود منطقه است.

$INCLUDE پرونده دیگری را طوری در بر می‌گیرد که گویی محتویات آن در همان نقطه دستورالعمل $INCLUDE قرار دارد. دستورالعمل‌های include می‌توانند یک مبدا اختیاری مشخص کنند که تاثیری مشابه $ORIGIN در بالای پرونده دربرگرفته‌شده دارد. تغییرات مبدا (و TTL پیش‌فرض) در پرونده‌های دربرگرفته‌شده هیچ تاثیری بر پرونده بیرونی ندارد.

افزونه $GENERATE مربوط به BIND در حال حاضر پشتیبانی نمی‌شود، اما هیچ دلیل بنیادینی وجود ندارد که نتواند در آینده اضافه شود.

نام‌ها و مبداهای ویژه (SPECIAL NAMES AND ORIGINS)

کاراکتر استاندارد "@"، به‌عنوان یک نام کامل، به‌صورت نام مستعاری برای مبدا فعلی پشتیبانی می‌شود. علاوه بر این، gdnsd دو افزونه ویژه @Z و @F را پیاده‌سازی می‌کند. این‌ها نام منطقه فعلی و مبدا اولیه (پیش از هرگونه اعلان درون‌پرونده‌ای $ORIGIN) پرونده‌ای که در حال پردازش است را نشان می‌دهند. بر خلاف "@"، آن‌ها می‌توانند به عنوان برچسب نهایی یک نام فاقد صلاحیت نیز استفاده شوند. @Z و @F در پرونده منطقه اصلی برای یک منطقه همیشه با یکدیگر معادل خواهند بود، اما هنگام پردازش پرونده‌های دربرگرفته‌شده از «$INCLUDE» ممکن است متفاوت باشند. به‌عنوان مثال:

* zones/example.org has the line "$INCLUDE includes/foo foo"
* zones/includes/foo has these lines:
   $ORIGIN bar
   asdf A 192.0.2.1
   $ORIGIN baz.@F
   asdf A 192.0.2.2
   $ORIGIN quux.@Z
   asdf A 192.0.2.3
* This results in creating all of these:
   asdf.bar.foo.example.org A 192.0.2.1
   asdf.baz.foo.example.org A 192.0.2.2
   asdf.quux.example.org    A 192.0.2.3

توجه داشته باشید که تغییرات مبدا که با @F و @Z انجام می‌شود، به سمت ریشه سلسله‌مراتب نام‌ها به عقب برمی‌گردد، و بنابراین معمولاً بدون استفاده صریح از نام خود منطقه امکان‌پذیر نخواهد بود. مزیت اصلی این دستورالعمل‌ها این است که امکان این نوع رفتار تغییر مبدا را فراهم می‌کنند در حالی که تمام داده‌های منطقه را به جای مطلق، نسبت به نام منطقه حفظ می‌نمایند. وقتی این موضوع با این واقعیت ترکیب شود که پویشگر مناطق پیوندهای نمادین را بارگذاری می‌کند، بدان معناست که پرونده بالا zones/example.org می‌تواند به صورت پیوند نمادین با نام zones/example.com نیز ایجاد شود، و تمام همان پرونده‌ها را بارگذاری کرده و بدون هیچ تداخلی درختی یکسان از داده‌ها را تحت نام منطقه دیگر ارائه دهد.

انواع رکوردهای منبع پشتیبانی‌شده (SUPPORTED RESOURCE RECORD TYPES)

تمام رکوردهای منبع (RRها) باید از کلاس "IN" باشند، که پیش‌فرض ضمنی است.

gdnsd(8) از انواع RR استاندارد زیر با قالب‌های استاندارد RDATA آنها پشتیبانی می‌کند:

سنتی: SOA، A، AAAA، NS، PTR، CNAME، MX، SRV، TXT، NAPTR
غیرسنتی: CAA
صریحاً پشتیبانی‌نشده: HINFO

همچنین از قالب عمومی برای انواع ناشناخته RR که در RFC 3597 مستند شده است پشتیبانی می‌کند، که نحوی مانند زیر دارد:

foo TYPE31337 \# 10 0123456789 ABCDEF0123

... که نشان‌دهنده یک RR از نوع عددی 31337 شامل ۱۰ بایت RDATA است، که در بخش نهایی RR به‌صورت یک جفت رشته هگزادسیمال ۵ بایتی مشخص شده است. برای جزئیات کامل به خود RFC 3597 مراجعه کنید.

برنامه gdnsd اجازه استفاده از قالب RFC3597 را برای مشخص کردن هیچ‌یک از انواع سنتی و استاندارد RRهای پشتیبانی‌شده نمی‌دهد، اما می‌توان از آن برای کدگذاری داده‌ها برای انواع غیرسنتی استفاده کرد. همچنین استفاده از RFC3597 برای مشخص کردن رکوردهای HINFO مجاز نیست، زیرا این رکوردها اکنون در gdnsd برای استفاده در مدیریت پرس‌وجوهای "ANY"، با استفاده از گزینه RFC 8482 HINFO رزرو شده‌اند.

مقدار TTL حافظه پنهان منفی رکوردهای "SOA" برابر با کمینه فیلد سنتی «minimum» (آخرین فیلد، که از زمان RFC 2308 همیشه به معنای «TTL حافظه پنهان منفی» است) و TTL واقعی خود رکورد SOA تنظیم می‌شود. این TTL به عنوان TTL واقعی رکورد SOA در هر زمان که صادر شود (چه برای پاسخ‌های منفی یا مثبت) استفاده می‌شود.

علاوه بر این، gdnsd از دو نوع رکورد منبع مجازی ویژه و غیراستاندارد DYNA و DYNC پشتیبانی می‌کند:

; asks plugin 'geoip' to provide address data from
;  its resource named 'pubwww' for address queries.
foo DYNA geoip!pubwww
foo MX 10 mail

; asks plugin 'geoip' to provide address data or a CNAME
;  (at the plugin's discretion) for its resource named
;  'www'.  No other RRs of any type for name 'foo' are
;  legal alongside this record.
foo DYNC geoip!www

; Explicit range of 30 - 300:
www 300/30 DYNC weighted!foo
; Implicit range of 150 - 300:
www 300 DYNA metafo!myservice
; Avoid all TTL-mangling and use a fixed value of 10 minutes:
www 600/600 DYNA geoip!foo-dist

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

gdnsd(8)، gdnsd.config(5)

راهنمای gdnsd.

حق نشر و مجوز (COPYRIGHT AND LICENSE)

حق نشر (c) 2012 متعلق به Brandon L Black <blblack@gmail.com>

این پرونده بخشی از gdnsd است.

نرم‌افزار gdnsd یک نرم‌افزار آزاد است: شما می‌توانید آن را تحت شرایط «مجوز عمومی همگانی گنو» (GNU General Public License) همان‌طور که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، چه نسخه ۳ این مجوز یا (به انتخاب خودتان) هر نسخه بعدی دیگری، بازتوزیع کرده و/یا تغییر دهید.

نرم‌افزار gdnsd با این امید توزیع شده است که سودمند باشد، اما بدون هرگونه ضمانتی؛ حتی بدون ضمانت ضمنی «قابل فروش بودن» یا «مناسب بودن برای یک هدف خاص». برای جزئیات بیشتر به «مجوز عمومی همگانی گنو» مراجعه کنید.

شما باید یک نسخه از «مجوز عمومی همگانی گنو» را به همراه gdnsd دریافت کرده باشید. در غیر این صورت، ببینید: http://www.gnu.org/licenses