.\" 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 "DDNS-CONFGEN" "8" "2026-08-19" "9.20.27" "BIND 9"
.SH "نام (NAME)"
ddns-confgen \- ابزار تولید کلید و پیکربندی DDNS
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBddns\-confgen\fP [\fB\-a\fP algorithm] [\fB\-h\fP] [\fB\-k\fP keyname] [\fB\-q\fP] [\fB\-s\fP name] [\fB\-z\fP zone]
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBddns\-confgen\fP ابزاری است که کلیدهایی را برای استفاده در امضای TSIG تولید می‌کند. کلیدهای حاصل می‌توانند برای مثال جهت ایمن‌سازی به‌روزرسانی‌های پویای DNS در یک ناحیه (zone) یا برای کانال دستور \fBrndc\fP \%<#\:std-iscman-rndc> استفاده شوند.
.sp
نام کلید می‌تواند با استفاده از پارامتر \fB\-k\fP مشخص شود و مقدار پیش‌فرض آن \fBddns\-key\fP است. کلید تولیدشده همراه با متن پیکربندی و دستورالعمل‌هایی ارائه می‌شود که می‌توانند هنگام راه‌اندازی DNS پویا به‌همراه \fBnsupdate\fP \%<#\:std-iscman-nsupdate> و \fBnamed\fP \%<#\:std-iscman-named> استفاده شوند، شامل یک عبارت نمونه \fBupdate\-policy\fP\&. (این کاربرد مشابه دستور \fBrndc\-confgen\fP \%<#\:std-iscman-rndc-confgen> برای راه‌اندازی امنیت کانال دستور است.)
.sp
توجه داشته باشید که خود \fBnamed\fP \%<#\:std-iscman-named> می‌تواند یک کلید DDNS محلی را برای استفاده با \fBnsupdate \-l\fP \%<#\:cmdoption-nsupdate-l> پیکربندی کند؛ این کار زمانی انجام می‌شود که یک ناحیه با \fBupdate\-policy local;\fP پیکربندی شده باشد. به \fBddns\-confgen\fP تنها زمانی نیاز است که به پیکربندی دقیق‌تر و پیشرفته‌تری احتیاج باشد: برای نمونه، اگر قرار باشد \fBnsupdate\fP \%<#\:std-iscman-nsupdate> از یک سیستم راه دور (remote) مورد استفاده قرار گیرد.
.SH "گزینه‌ها (OPTIONS)"
.INDENT 0.0
.TP
.B \-a algorithm
این گزینه الگوریتم مورد استفاده برای کلید TSIG را مشخص می‌کند. گزینه‌های موجود عبارتند از: hmac\-md5، hmac\-sha1، hmac\-sha224، hmac\-sha256، hmac\-sha384 و hmac\-sha512. مقدار پیش‌فرض hmac\-sha256 است. این گزینه‌ها به بزرگ و کوچک بودن حروف حساس نیستند (case\-insensitive) و پیشوند \(dqhmac\-\(dq می‌تواند نادیده گرفته شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-h
این گزینه خلاصه کوتاهی از گزینه‌ها و آرگومان‌ها را چاپ می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-k keyname
این گزینه نام کلید احراز هویت DDNS را مشخص می‌کند. در صورتی که هیچ‌یک از گزینه‌های \fB\-s\fP یا \fB\-z\fP مشخص نشده باشند، مقدار پیش‌فرض \fBddns\-key\fP است؛ در غیر این صورت، مقدار پیش‌فرض \fBddns\-key\fP به عنوان یک برچسب (label) جداگانه به همراه آرگومان آن گزینه خواهد بود، مانند \fBddns\-key.example.com.\fP\&. نام کلید باید قالبی از یک نام دامنه معتبر داشته باشد و شامل حروف، ارقام، خط تیره و نقطه باشد.
.UNINDENT
.INDENT 0.0
.TP
.B \-q
این گزینه حالت بی‌صدا (quiet mode) را فعال می‌کند، که تنها کلید را بدون هیچ متن توضیحی یا مثال‌های کاربردی چاپ می‌کند. این رفتار اساساً مشابه دستور \fBtsig\-keygen\fP \%<#\:std-iscman-tsig-keygen> است.
.UNINDENT
.INDENT 0.0
.TP
.B \-s name
این گزینه یک نمونه پیکربندی را جهت مجاز کردن به‌روزرسانی‌های پویای یک نام میزبان (hostname) منفرد تولید می‌کند. متن نمونه \fBnamed.conf\fP \%<#\:std-iscman-named\:.conf> نحوه تنظیم یک سیاست به‌روزرسانی را برای نام مشخص‌شده با استفاده از nametype از نوع \(dqname\(dq نشان می‌دهد. نام پیش‌فرض کلید \fBddns\-key.name\fP است. توجه داشته باشید که nametype از نوع \(dqself\(dq نمی‌تواند استفاده شود، زیرا نامی که باید به‌روزرسانی شود ممکن است با نام کلید تفاوت داشته باشد. این گزینه نمی‌تواند همزمان با گزینه \fB\-z\fP استفاده شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-z zone
این گزینه یک نمونه پیکربندی را جهت مجاز کردن به‌روزرسانی‌های پویای یک ناحیه (zone) تولید می‌کند. متن نمونه \fBnamed.conf\fP \%<#\:std-iscman-named\:.conf> نحوه تنظیم یک سیاست به‌روزرسانی را برای ناحیه مشخص‌شده با استفاده از nametype از نوع \(dqzonesub\(dq نشان می‌دهد که به‌روزرسانی تمام نام‌های زیردامنه (subdomain) در آن ناحیه را مجاز می‌سازد. این گزینه نمی‌تواند همزمان با گزینه \fB\-s\fP استفاده شود.
.UNINDENT
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBnsupdate(1)\fP \%<#\:std-iscman-nsupdate>، \fBnamed.conf(5)\fP \%<#\:std-iscman-named\:.conf>، \fBnamed(8)\fP \%<#\:std-iscman-named>، راهنمای مرجع مدیر BIND 9 (BIND 9 Administrator Reference Manual).
.SH "نویسندگان (AUTHORS)"
Internet Systems Consortium
.SH "حق نشر (COPYRIGHT)"
2026, Internet Systems Consortium
.\" End of generated man page.