.\" Man page generated from reStructuredText
.\" by the Docutils 0.23 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "NAMED-CHECKZONE" "1" "2026-08-19" "9.20.27" "BIND 9"
.SH "نام (NAME)"
named-checkzone \- ابزار بررسی صحت یا تبدیل پرونده منطقه (Zone) در سامانه نام دامنه
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBnamed\-checkzone\fP [\fB\-d\fP] [\fB\-h\fP] [\fB\-j\fP] [\fB\-q\fP] [\fB\-v\fP] [\fB\-c\fP class] [\fB\-C\fP mode] [\fB\-f\fP format] [\fB\-F\fP format] [\fB\-J\fP filename] [\fB\-i\fP mode] [\fB\-k\fP mode] [\fB\-m\fP mode] [\fB\-M\fP mode] [\fB\-n\fP mode] [\fB\-l\fP ttl] [\fB\-L\fP serial] [\fB\-o\fP filename] [\fB\-r\fP mode] [\fB\-s\fP style] [\fB\-S\fP mode] [\fB\-t\fP directory] [\fB\-T\fP mode] [\fB\-w\fP directory] [\fB\-D\fP] [\fB\-W\fP mode] {zonename} {filename}
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBnamed\-checkzone\fP ساختار نحوی و یکپارچگی یک پرونده منطقه را بررسی می‌کند. این دستور همان بررسی‌هایی را انجام می‌دهد که \fBnamed\fP هنگام بارگذاری یک منطقه انجام می‌دهد. این امر باعث می‌شود \fBnamed\-checkzone\fP برای بررسی پرونده‌های منطقه پیش از پیکربندی آن‌ها در کارساز نام (name server) بسیار مفید باشد.
.SH "گزینه‌ها (OPTIONS)"
.INDENT 0.0
.TP
.B \-d
این گزینه حالت اشکال‌زدایی (debugging) را فعال می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-h
این گزینه خلاصه راهنمای استفاده را چاپ کرده و خارج می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-q
این گزینه حالت بی‌صدا (quiet) را فعال می‌کند که در آن فقط یک کد خروج برای نشان دادن موفقیت یا شکست تنظیم می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-v
این گزینه نسخه برنامه \fBnamed\-checkzone\fP را چاپ کرده و خارج می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-j
هنگام بارگذاری پرونده منطقه، این گزینه به \fBnamed\fP اعلام می‌کند که در صورت وجود دفتر وقایع (journal)، آن را بخواند. نام پرونده ژورنال همان نام پرونده منطقه به همراه پسوند \fB\&.jnl\fP در نظر گرفته می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-J filename
هنگام بارگذاری پرونده منطقه، این گزینه به \fBnamed\fP اعلام می‌کند که در صورت وجود پرونده ژورنال داده‌شده، آن را بخواند. این گزینه متضمن \fB\-j\fP است.
.UNINDENT
.INDENT 0.0
.TP
.B \-c class
این گزینه کلاس منطقه را مشخص می‌کند. در صورت عدم تعیین، مقدار \fBIN\fP پیش‌فرض خواهد بود.
.UNINDENT
.INDENT 0.0
.TP
.B \-C mode
این گزینه حالت بررسی را در هنگام بارگذاری پرونده‌های منطقه کنترل می‌کند.
حالت‌های ممکن عبارتند از \fBcheck\-svcb:fail\fP و \fBcheck\-svcb:ignore\fP\&.
.sp
حالت \fBcheck\-svcb:fail\fP بررسی‌های اضافی روی رکوردهای SVCB مربوط به \fB_dns\fP را فعال می‌کند و \fBcheck\-svcb:ignore\fP این بررسی‌ها را غیرفعال می‌سازد. مقدار پیش‌فرض \fBcheck\-svcb:fail\fP است.
.UNINDENT
.INDENT 0.0
.TP
.B \-i mode
این گزینه بررسی‌های یکپارچگی منطقه را پس از بارگذاری انجام می‌دهد. حالت‌های ممکن عبارتند از:
\fBfull\fP (پیش‌فرض)، \fBfull\-sibling\fP، \fBlocal\fP،
\fBlocal\-sibling\fP، و \fBnone\fP\&.
.sp
حالت \fBfull\fP بررسی می‌کند که رکوردهای MX به رکوردهای A یا AAAA اشاره داشته باشند (چه نام‌های میزبان درون منطقه و چه بیرون از منطقه). حالت \fBlocal\fP تنها رکوردهای MX را که به نام‌های میزبان درون منطقه اشاره دارند بررسی می‌کند.
.sp
حالت \fBfull\fP بررسی می‌کند که رکوردهای SRV به رکوردهای A یا AAAA اشاره کنند (نام‌های میزبان درون یا بیرون منطقه). حالت \fBlocal\fP فقط رکوردهای SRV را که به نام‌های میزبان درون منطقه اشاره دارند بررسی می‌کند.
.sp
حالت \fBfull\fP بررسی می‌کند که رکوردهای NS واگذاری (delegation) به رکوردهای A یا AAAA اشاره داشته باشند (میزبان‌های درون یا بیرون منطقه). همچنین بررسی می‌کند که رکوردهای آدرس چسبنده (glue address) در منطقه با موارد اعلام‌شده توسط فرزند همخوانی داشته باشد. حالت \fBlocal\fP تنها رکوردهای NS مرتبط با میزبان‌های درون منطقه را بررسی می‌کند یا وجود برخی رکوردهای چسبنده ضروری را تأیید می‌نماید (مانند زمانی که کارساز نام درون یک منطقه فرزند قرار دارد).
.sp
حالت‌های \fBfull\-sibling\fP و \fBlocal\-sibling\fP بررسی‌های glue مربوط به همتاها (sibling) را غیرفعال می‌کنند، اما در سایر موارد به ترتیب مشابه \fBfull\fP و \fBlocal\fP هستند.
.sp
حالت \fBnone\fP این بررسی‌ها را غیرفعال می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-f format
این گزینه قالب پرونده منطقه را مشخص می‌کند. قالب‌های ممکن عبارتند از:
\fBtext\fP (پیش‌فرض)، و \fBraw\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-F format
این گزینه قالب پرونده خروجی مشخص‌شده را تعیین می‌کند. برای \fBnamed\-checkzone\fP این گزینه اثری ندارد مگر اینکه محتویات منطقه تخلیه (dump) شود.
.sp
قالب‌های ممکن عبارتند از \fBtext\fP (پیش‌فرض)، که نمایش متنی استاندارد منطقه است، و \fBraw\fP و \fBraw=N\fP، که منطقه را در یک قالب باینری برای بارگذاری سریع توسط \fBnamed\fP ذخیره می‌کنند.
گزینه \fBraw=N\fP نسخه قالب پرونده باینری خام را مشخص می‌کند: اگر \fBN\fP برابر با 0 باشد، پرونده خام توسط هر نسخه‌ای از \fBnamed\fP قابل خواندن است؛ اگر N برابر 1 باشد، پرونده فقط توسط نگارش 9.9.0 یا بالاتر قابل خواندن خواهد بود. پیش‌فرض 1 است.
.UNINDENT
.INDENT 0.0
.TP
.B \-k mode
این گزینه بررسی‌های \fBcheck\-names\fP را با حالت شکست مشخص‌شده انجام می‌دهد. حالت‌های ممکن عبارتند از \fBfail\fP، \fBwarn\fP (پیش‌فرض)، و \fBignore\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-l ttl
این گزینه حداکثر TTL مجاز را برای پرونده ورودی تعیین می‌کند. هر رکوردی با TTL بالاتر از این مقدار سبب رد شدن منطقه خواهد شد. این کار مشابه استفاده از گزینه \fBmax\-zone\-ttl\fP در \fBnamed.conf\fP است.
.UNINDENT
.INDENT 0.0
.TP
.B \-L serial
هنگام کامپایل یک منطقه به قالب \fBraw\fP، این گزینه مقدار "source serial" را در سرآیند روی شماره سریال مشخص‌شده تنظیم می‌کند. این گزینه اساساً برای مقاصد آزمایشی کاربرد دارد.
.UNINDENT
.INDENT 0.0
.TP
.B \-m mode
این گزینه مشخص می‌کند آیا رکوردهای MX باید بررسی شوند تا اطمینان حاصل شود که آدرس IP نیستند یا خیر. حالت‌های ممکن عبارتند از \fBfail\fP، \fBwarn\fP (پیش‌فرض)، و \fBignore\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-M mode
این گزینه بررسی می‌کند که آیا یک رکورد MX به CNAME اشاره دارد یا خیر. حالت‌های ممکن عبارتند از \fBfail\fP، \fBwarn\fP (پیش‌فرض)، و \fBignore\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-n mode
این گزینه مشخص می‌کند آیا رکوردهای NS باید بررسی شوند تا آدرس نباشند. حالت‌های ممکن عبارتند از \fBfail\fP، \fBwarn\fP (پیش‌فرض)، و \fBignore\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-o filename
این گزینه خروجی منطقه را در \fBfilename\fP می‌نویسد. اگر \fBfilename\fP برابر با \fB\-\fP باشد، خروجی در خروجی استاندارد نوشته می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-r mode
این گزینه رکوردهایی را بررسی می‌کند که در DNSSEC متفاوت شمرده می‌شوند اما در DNS معمولی از نظر معنایی برابر هستند. حالت‌های ممکن عبارتند از \fBfail\fP، \fBwarn\fP (پیش‌فرض)، و \fBignore\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-s style
این گزینه سبک پرونده منطقه تخلیه‌شده را تعیین می‌کند. سبک‌های ممکن عبارتند از \fBfull\fP (پیش‌فرض) و \fBrelative\fP\&. قالب \fBfull\fP برای پردازش خودکار توسط اسکریپت‌های جداگانه مناسب‌تر است.
قالب relative خوانایی بهتری برای انسان دارد و برای ویرایش دستی مناسب است. این گزینه اثری ندارد مگر اینکه محتویات منطقه را تخلیه نماید. همچنین اگر قالب خروجی متنی نباشد معنایی نخواهد داشت.
.UNINDENT
.INDENT 0.0
.TP
.B \-S mode
این گزینه بررسی می‌کند که آیا یک رکورد SRV به یک CNAME اشاره دارد یا خیر. حالت‌های ممکن عبارتند از \fBfail\fP، \fBwarn\fP (پیش‌فرض)، و \fBignore\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-t directory
این گزینه به \fBnamed\fP دستور می‌دهد تا به \fBdirectory\fP تعویض ریشه (chroot) کند، به‌طوری که دستورات \fBinclude\fP در پرونده پیکربندی طوری پردازش شوند که گویی توسط یک \fBnamed\fP در همان محیط chroot اجرا شده‌اند.
.UNINDENT
.INDENT 0.0
.TP
.B \-T mode
این گزینه بررسی می‌کند که آیا رکوردهای Sender Policy Framework (SPF) وجود دارند یا خیر و در صورتی که یک رکورد TXT در قالب SPF نیز موجود نباشد، هشدار می‌دهد. حالت‌های ممکن عبارتند از \fBwarn\fP (پیش‌فرض) و \fBignore\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-w directory
این گزینه به \fBnamed\fP اعلام می‌کند تا دایرکتوری جاری خود را به \fBdirectory\fP تغییر دهد (chdir)، تا نام پرونده‌های نسبی در دستورات \fB$INCLUDE\fP پرونده اصلی کار کنند. این مشابه عبارت directory در \fBnamed.conf\fP است.
.UNINDENT
.INDENT 0.0
.TP
.B \-D
این گزینه پرونده منطقه را در قالب استاندارد (canonical) تخلیه می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-W mode
این گزینه تعیین می‌کند که آیا نویسه‌های عمومی غیرپایانی (non-terminal wildcards) بررسی شوند یا خیر. نویسه‌های عمومی غیرپایانی تقریباً همیشه نتیجه عدم درک صحیح از الگوریتم تطبیق نویسه‌های عمومی هستند (\fBRFC 4592\fP). حالت‌های ممکن عبارتند از \fBwarn\fP (پیش‌فرض) و \fBignore\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B zonename
نشان‌دهنده نام دامنه منطقه‌ای است که بررسی می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B filename
نام پرونده منطقه است.
.UNINDENT
.SH "مقادیر بازگشتی (RETURN VALUES)"
.sp
دستور \fBnamed\-checkzone\fP در صورت شناسایی خطا وضعیت خروج 1 و در غیر این صورت 0 را برمی‌گرداند.
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBnamed(8)\fP, \fBnamed\-checkconf(8)\fP, \fBnamed\-compilezone(8)\fP, \fBRFC 1035\fP, BIND 9 Administrator Reference Manual.
.SH "نویسنده (AUTHOR)"
Internet Systems Consortium
.SH "حق نشر (COPYRIGHT)"
2026, Internet Systems Consortium
.\" End of generated man page.