نام (NAME)

named-checkconf - ابزار بررسی نحو (syntax) پرونده پیکربندی named

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

named-checkconf [-achjklvz] [-p [-x ]] [-t directory] {filename}

توضیحات (DESCRIPTION)

دستور named-checkconf نحو (و نه معناشناسی) پرونده پیکربندی named را بررسی می‌کند. این پرونده همراه با تمامی پرونده‌های گنجانده‌شده در آن تجزیه شده و خطاهای نحوی آن مشخص می‌گردد. اگر نام پرونده‌ای مشخص نشود، پرونده پیش‌فرض /etc/named.conf خوانده می‌شود.

توجه: پرونده‌هایی که named در محیط‌های تجزیه جداگانه می‌خواند، مانند rndc.conf یا rndc.key، به طور خودکار توسط named-checkconf خوانده نمی‌شوند. خطاهای پیکربندی در این پرونده‌ها ممکن است باعث شود named با شکست مواجه شود، حتی اگر بررسی named-checkconf موفقیت‌آمیز بوده باشد. با این حال، می‌توان named-checkconf را به صراحت روی این پرونده‌ها اجرا کرد.

گزینه‌ها (OPTIONS)

-a: الگوریتم‌های کلید DNSSEC در dnssec-policy را در برابر الگوریتم‌های پشتیبانی‌شده توسط ارائه‌دهنده رمزنگاری بررسی نمی‌کند. این گزینه هنگام بررسی پرونده named.conf که قرار است روی ماشین دیگری با مجموعه‌ای متفاوت از الگوریتم‌های DNSSEC اجرا شود، مفید است.

-h: این گزینه خلاصه راهنمای کاربرد را چاپ کرده و خارج می‌شود.

-j: هنگام بارگذاری پرونده ناحیه (zonefile)، این گزینه به named دستور می‌دهد در صورت وجود فایل ثبت وقایع (journal)، آن را بخواند.

-k: کلیدهای DNSSEC در dnssec-policy را در برابر پرونده‌های کلید در key-directory بررسی می‌کند. این گزینه برای اطمینان از تطابق خط‌مشی DNSSEC با کلیدهای موجود مفید است.

-l: این گزینه تمامی نواحی (zones) پیکربندی‌شده را فهرست می‌کند. هر خط از خروجی شامل نام ناحیه، کلاس (مانند IN)، نما (view) و نوع (مانند primary یا secondary) است.

-c: این گزینه مشخص می‌کند که فقط پیکربندی اصلی (core) بررسی شود. این کار بارگذاری ماژول‌های افزونه (plugin) را لغو کرده و باعث نادیده گرفته شدن پارامترهای دستورات plugin می‌شود.

-i: این گزینه هشدارهای مربوط به گزینه‌های منسوخ‌شده را نادیده می‌گیرد.

-p: اگر خطایی یافت نشود، این گزینه محتوای named.conf و پرونده‌های گنجانده‌شده در آن را به شکل استاندارد (canonical) چاپ می‌کند. گزینه -x را نیز ببینید.

-t directory: این گزینه به named دستور می‌دهد به دایرکتوری directory تغییر ریشه (chroot) دهد تا دستورالعمل‌های include در پرونده پیکربندی مانند شرایط اجرای واقعی در محیط chroot پردازش شوند.

-v: این گزینه نسخه برنامه named-checkconf را چاپ کرده و خارج می‌شود.

-x: هنگام چاپ پرونده‌های پیکربندی به شکل استاندارد، این گزینه اسرار مشترک و کلیدها را با رشته‌هایی از علامت سؤال (?) محو می‌کند. این امر اجازه می‌دهد محتوای named.conf و پرونده‌های مرتبط بدون به خطر انداختن اطلاعات خصوصی به اشتراک گذاشته شوند (برای مثال در گزارش‌های خطا). این گزینه بدون -p قابل استفاده نیست.

-z: این گزینه یک بارگذاری آزمایشی از تمام نواحی نوع primary موجود در named.conf انجام می‌دهد.

filename: نام پرونده پیکربندی که باید بررسی شود. در صورت عدم تعیین، پیش‌فرض /etc/named.conf است.

مقادیر بازگشتی (RETURN VALUES)

دستور named-checkconf در صورت وجود خطا مقدار 1 و در غیر این صورت مقدار 0 را برمی‌گرداند.

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

named(8), named-checkzone(8), BIND 9 Administrator Reference Manual.

نویسنده (AUTHOR)

Internet Systems Consortium

حق نشر (COPYRIGHT)

2026, Internet Systems Consortium