NAMED-CHECKZONE(1) BIND 9 NAMED-CHECKZONE(1)

named-checkzone - ابزار بررسی صحت یا تبدیل پرونده منطقه (Zone) در سامانه نام دامنه

named-checkzone [-d] [-h] [-j] [-q] [-v] [-c class] [-C mode] [-f format] [-F format] [-J filename] [-i mode] [-k mode] [-m mode] [-M mode] [-n mode] [-l ttl] [-L serial] [-o filename] [-r mode] [-s style] [-S mode] [-t directory] [-T mode] [-w directory] [-D] [-W mode] {zonename} {filename}

دستور named-checkzone ساختار نحوی و یکپارچگی یک پرونده منطقه را بررسی می‌کند. این دستور همان بررسی‌هایی را انجام می‌دهد که named هنگام بارگذاری یک منطقه انجام می‌دهد. این امر باعث می‌شود named-checkzone برای بررسی پرونده‌های منطقه پیش از پیکربندی آن‌ها در کارساز نام (name server) بسیار مفید باشد.

این گزینه حالت اشکال‌زدایی (debugging) را فعال می‌کند.
این گزینه خلاصه راهنمای استفاده را چاپ کرده و خارج می‌شود.
این گزینه حالت بی‌صدا (quiet) را فعال می‌کند که در آن فقط یک کد خروج برای نشان دادن موفقیت یا شکست تنظیم می‌شود.
این گزینه نسخه برنامه named-checkzone را چاپ کرده و خارج می‌شود.
هنگام بارگذاری پرونده منطقه، این گزینه به named اعلام می‌کند که در صورت وجود دفتر وقایع (journal)، آن را بخواند. نام پرونده ژورنال همان نام پرونده منطقه به همراه پسوند .jnl در نظر گرفته می‌شود.
هنگام بارگذاری پرونده منطقه، این گزینه به named اعلام می‌کند که در صورت وجود پرونده ژورنال داده‌شده، آن را بخواند. این گزینه متضمن -j است.
این گزینه کلاس منطقه را مشخص می‌کند. در صورت عدم تعیین، مقدار IN پیش‌فرض خواهد بود.
این گزینه حالت بررسی را در هنگام بارگذاری پرونده‌های منطقه کنترل می‌کند. حالت‌های ممکن عبارتند از check-svcb:fail و check-svcb:ignore.

حالت check-svcb:fail بررسی‌های اضافی روی رکوردهای SVCB مربوط به _dns را فعال می‌کند و check-svcb:ignore این بررسی‌ها را غیرفعال می‌سازد. مقدار پیش‌فرض check-svcb:fail است.

این گزینه بررسی‌های یکپارچگی منطقه را پس از بارگذاری انجام می‌دهد. حالت‌های ممکن عبارتند از: full (پیش‌فرض)، full-sibling، local، local-sibling، و none.

حالت full بررسی می‌کند که رکوردهای MX به رکوردهای A یا AAAA اشاره داشته باشند (چه نام‌های میزبان درون منطقه و چه بیرون از منطقه). حالت local تنها رکوردهای MX را که به نام‌های میزبان درون منطقه اشاره دارند بررسی می‌کند.

حالت full بررسی می‌کند که رکوردهای SRV به رکوردهای A یا AAAA اشاره کنند (نام‌های میزبان درون یا بیرون منطقه). حالت local فقط رکوردهای SRV را که به نام‌های میزبان درون منطقه اشاره دارند بررسی می‌کند.

حالت full بررسی می‌کند که رکوردهای NS واگذاری (delegation) به رکوردهای A یا AAAA اشاره داشته باشند (میزبان‌های درون یا بیرون منطقه). همچنین بررسی می‌کند که رکوردهای آدرس چسبنده (glue address) در منطقه با موارد اعلام‌شده توسط فرزند همخوانی داشته باشد. حالت local تنها رکوردهای NS مرتبط با میزبان‌های درون منطقه را بررسی می‌کند یا وجود برخی رکوردهای چسبنده ضروری را تأیید می‌نماید (مانند زمانی که کارساز نام درون یک منطقه فرزند قرار دارد).

حالت‌های full-sibling و local-sibling بررسی‌های glue مربوط به همتاها (sibling) را غیرفعال می‌کنند، اما در سایر موارد به ترتیب مشابه full و local هستند.

حالت none این بررسی‌ها را غیرفعال می‌کند.

این گزینه قالب پرونده منطقه را مشخص می‌کند. قالب‌های ممکن عبارتند از: text (پیش‌فرض)، و raw.
این گزینه قالب پرونده خروجی مشخص‌شده را تعیین می‌کند. برای named-checkzone این گزینه اثری ندارد مگر اینکه محتویات منطقه تخلیه (dump) شود.

قالب‌های ممکن عبارتند از text (پیش‌فرض)، که نمایش متنی استاندارد منطقه است، و raw و raw=N، که منطقه را در یک قالب باینری برای بارگذاری سریع توسط named ذخیره می‌کنند. گزینه raw=N نسخه قالب پرونده باینری خام را مشخص می‌کند: اگر N برابر با 0 باشد، پرونده خام توسط هر نسخه‌ای از named قابل خواندن است؛ اگر N برابر 1 باشد، پرونده فقط توسط نگارش 9.9.0 یا بالاتر قابل خواندن خواهد بود. پیش‌فرض 1 است.

این گزینه بررسی‌های check-names را با حالت شکست مشخص‌شده انجام می‌دهد. حالت‌های ممکن عبارتند از fail، warn (پیش‌فرض)، و ignore.
این گزینه حداکثر TTL مجاز را برای پرونده ورودی تعیین می‌کند. هر رکوردی با TTL بالاتر از این مقدار سبب رد شدن منطقه خواهد شد. این کار مشابه استفاده از گزینه max-zone-ttl در named.conf است.
هنگام کامپایل یک منطقه به قالب raw، این گزینه مقدار "source serial" را در سرآیند روی شماره سریال مشخص‌شده تنظیم می‌کند. این گزینه اساساً برای مقاصد آزمایشی کاربرد دارد.
این گزینه مشخص می‌کند آیا رکوردهای MX باید بررسی شوند تا اطمینان حاصل شود که آدرس IP نیستند یا خیر. حالت‌های ممکن عبارتند از fail، warn (پیش‌فرض)، و ignore.
این گزینه بررسی می‌کند که آیا یک رکورد MX به CNAME اشاره دارد یا خیر. حالت‌های ممکن عبارتند از fail، warn (پیش‌فرض)، و ignore.
این گزینه مشخص می‌کند آیا رکوردهای NS باید بررسی شوند تا آدرس نباشند. حالت‌های ممکن عبارتند از fail، warn (پیش‌فرض)، و ignore.
این گزینه خروجی منطقه را در filename می‌نویسد. اگر filename برابر با - باشد، خروجی در خروجی استاندارد نوشته می‌شود.
این گزینه رکوردهایی را بررسی می‌کند که در DNSSEC متفاوت شمرده می‌شوند اما در DNS معمولی از نظر معنایی برابر هستند. حالت‌های ممکن عبارتند از fail، warn (پیش‌فرض)، و ignore.
این گزینه سبک پرونده منطقه تخلیه‌شده را تعیین می‌کند. سبک‌های ممکن عبارتند از full (پیش‌فرض) و relative. قالب full برای پردازش خودکار توسط اسکریپت‌های جداگانه مناسب‌تر است. قالب relative خوانایی بهتری برای انسان دارد و برای ویرایش دستی مناسب است. این گزینه اثری ندارد مگر اینکه محتویات منطقه را تخلیه نماید. همچنین اگر قالب خروجی متنی نباشد معنایی نخواهد داشت.
این گزینه بررسی می‌کند که آیا یک رکورد SRV به یک CNAME اشاره دارد یا خیر. حالت‌های ممکن عبارتند از fail، warn (پیش‌فرض)، و ignore.
این گزینه به named دستور می‌دهد تا به directory تعویض ریشه (chroot) کند، به‌طوری که دستورات include در پرونده پیکربندی طوری پردازش شوند که گویی توسط یک named در همان محیط chroot اجرا شده‌اند.
این گزینه بررسی می‌کند که آیا رکوردهای Sender Policy Framework (SPF) وجود دارند یا خیر و در صورتی که یک رکورد TXT در قالب SPF نیز موجود نباشد، هشدار می‌دهد. حالت‌های ممکن عبارتند از warn (پیش‌فرض) و ignore.
این گزینه به named اعلام می‌کند تا دایرکتوری جاری خود را به directory تغییر دهد (chdir)، تا نام پرونده‌های نسبی در دستورات $INCLUDE پرونده اصلی کار کنند. این مشابه عبارت directory در named.conf است.
این گزینه پرونده منطقه را در قالب استاندارد (canonical) تخلیه می‌کند.
این گزینه تعیین می‌کند که آیا نویسه‌های عمومی غیرپایانی (non-terminal wildcards) بررسی شوند یا خیر. نویسه‌های عمومی غیرپایانی تقریباً همیشه نتیجه عدم درک صحیح از الگوریتم تطبیق نویسه‌های عمومی هستند (RFC 4592). حالت‌های ممکن عبارتند از warn (پیش‌فرض) و ignore.
نشان‌دهنده نام دامنه منطقه‌ای است که بررسی می‌شود.
نام پرونده منطقه است.

دستور named-checkzone در صورت شناسایی خطا وضعیت خروج 1 و در غیر این صورت 0 را برمی‌گرداند.

named(8), named-checkconf(8), named-compilezone(8), RFC 1035, BIND 9 Administrator Reference Manual.

Internet Systems Consortium

2026, Internet Systems Consortium

2026-08-19 9.20.27