'\" t
.\" 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 "KEA-ARM" "1" "Jul 09, 2026" "3.2.0" "Kea"
.SH "نام (NAME)"
kea-arm \- مستندات راهنمای مرجع مدیر سیستم Kea
[تصویر]
.sp
‏Kea یک پیاده‌سازی متن‌باز از سرورهای پروتکل پیکربندی پویای میزبان (DHCP) است که توسط Internet Systems Consortium (ISC) توسعه یافته و نگهداری می‌شود.
.sp
این راهنمای مرجع برای Kea نسخهٔ 3.2.0\& است.
پیوندهای مربوط به جدیدترین نسخهٔ این سند (در قالب‌های PDF، HTML و متن ساده) را می‌توان در Read the Docs به نشانی \%<https://\:kea\:.readthedocs\:.io>\& یافت.
سایر اطلاعات مفید Kea در پایگاه دانش ما به نشانی \%<https://\:kb\:.isc\:.org>\& در دسترس است.
.SH "مقدمه (INTRODUCTION)"
.sp
‏Kea نسل بعدی نرم‌افزارهای DHCP است که توسط Internet Systems Consortium (ISC) توسعه یافته است. این برنامه هم از پروتکل‌های DHCPv4 و هم از DHCPv6 به همراه الحاقات آن‌ها، مانند واگذاری پیشوند (prefix delegation) و به‌روزرسانی‌های پویای DNS پشتیبانی می‌کند.
.sp
این راهنما نسخهٔ 3.2.0\& Kea را پوشش می‌دهد.
.sp
برای دریافت اطلاعات دربارهٔ پلتفرم‌های پشتیبانی‌شده، بخش پلتفرم‌های پشتیبانی‌شده (Supported Platforms)\& را ببینید.
.SS "پلتفرم‌های پشتیبانی‌شده (Supported Platforms)"
.sp
به‌طور کلی، این نسخه از Kea روی هر سیستم سازگار با POSIX که دارای کامپایلر ++C (با پشتیبانی از C++14)، کتابخانهٔ رمزنگاری Botan، کتابخانهٔ ثبت لاگ log4cplus و کتابخانهٔ سیستمی Boost باشد ساخته و اجرا می‌شود.
.sp
‏ISC به‌طور منظم Kea را روی سیستم‌عامل‌ها و معماری‌های متعددی آزمایش می‌کند، اما منابع کافی برای آزمایش همهٔ آن‌ها را ندارد. در نتیجه، ISC تنها می‌تواند پشتیبانی را بر پایهٔ \(dqبیشترین تلاش (best\-effort)\(dq برای برخی از آن‌ها ارائه دهد.
.SS "پلتفرم‌های آزمایش‌شده به‌طور منظم (Regularly Tested Platforms)"
.sp
‏Kea به‌طور رسمی روی سیستم‌های Alpine، Debian، Fedora، FreeBSD، RHEL و Ubuntu پشتیبانی می‌شود. ساخت‌های Kea\-3.2.0 روی سیستم‌های زیر آزمایش شده‌اند:
.INDENT 0.0
.IP \(bu 2
Alpine — 3.21, 3.22, 3.23, 3.24
.IP \(bu 2
Debian — 11, 12, 13
.IP \(bu 2
Fedora — 44
.IP \(bu 2
FreeBSD — 15
.IP \(bu 2
RHEL — 8, 9, 10
.IP \(bu 2
Ubuntu — 22.04, 24.04, 26.04
.UNINDENT
.sp
در حال حاضر برنامه‌ای برای پورت کردن Kea به سیستم‌های Windows وجود ندارد.
.SS "بیشترین تلاش (Best\-Effort)"
.sp
موارد زیر پلتفرم‌هایی هستند که ساخته‌شدن و اجرای Kea روی آن‌ها تأیید شده است.
‏ISC تمام توان خود را برای رفع باگ‌ها در این پلتفرم‌ها به کار می‌گیرد، اما ممکن است به دلیل کمبود سخت‌افزار، آشنایی کمتر کادر مهندسی و سایر محدودیت‌ها قادر به انجام سریع آن نباشد.
.INDENT 0.0
.IP \(bu 2
macOS — 14, 15, 26
.UNINDENT
.SS "نگه‌داری‌شده توسط جامعه (Community\-Maintained)"
.sp
این سیستم‌ها زمانی به‌طور منظم آزمایش می‌شدند، اما پشتیبانی رسمی از آن‌ها متوقف شده است؛ که معمولاً به دلیل پایان یافتن پشتیبانی از سوی توسعه‌دهندگان خود آن سیستم‌ها است. نسخه‌های قدیمی‌تر ممکن است پیش‌نیازهای لازم برای ساخت آسان Kea را در دسترس نداشته باشند، هرچند در بسیاری از موارد امکان کامپایل مستقیم از روی کد منبع روی آن‌ها وجود دارد. جامعهٔ کاربری و افراد علاقه‌مند می‌توانند در نگه‌داری کمک کنند و ما از مشارکت در قالب وصله (patch) استقبال می‌کنیم، اگرچه نمی‌توانیم پذیرش آن‌ها را تضمین نماییم. تمام مشارکت‌ها از نظر ریسک تأثیر منفی بر پلتفرم‌های رسماً پشتیبانی‌شده سنجیده می‌شوند.
.sp
این پلتفرم‌ها مواردی را در بر می‌گیرند که تاریخ پایان عمر (EOL) آن‌ها گذشته است، مانند:
.INDENT 0.0
.IP \(bu 2
Alpine — 3.20 (EOL 1 Apr 2026) و قدیمی‌تر
.IP \(bu 2
Debian — 10 (EOL 30 Jun 2024) و قدیمی‌تر
.IP \(bu 2
Fedora — 43 (EOL 9 Dec 2026) و قدیمی‌تر
.IP \(bu 2
FreeBSD — 14 (EOL 31 Dec 2026) و قدیمی‌تر
.IP \(bu 2
RHEL — 7 (EOL 30 Jun 2024) و قدیمی‌تر
.IP \(bu 2
Ubuntu — 20.04 (EOL 31 May 2025) و قدیمی‌تر
.IP \(bu 2
macOS — 13 (EOL 15 Sep 2025) و قدیمی‌تر
.UNINDENT.SS "پلتفرم‌های پشتیبانی‌نشده (Unsupported Platforms)"
.sp
این‌ها پلتفرم‌هایی هستند که مشخص شده است نسخه‌های Kea از نگارش 1.7 به بعد روی آن‌ها ساخته یا اجرا \fIنمی‌شوند\fP:
.INDENT 0.0
.IP \(bu 2
Windows (همه نسخه‌ها)
.IP \(bu 2
Windows Server (همه نسخه‌ها)
.IP \(bu 2
هر پلتفرمی با OpenSSL نسخه 1.0.1 یا قدیمی‌تر که به عنوان جایگزین Botan ندارد
.IP \(bu 2
هر پلتفرمی با log4cplus نسخه 1.0.2 یا قدیمی‌تر.
.IP \(bu 2
هر پلتفرمی با کامپایلری که از C++14 پشتیبانی نمی‌کند.
.UNINDENT
.SS "نرم‌افزارهای مورد نیاز هنگام اجرا (Required Software at Runtime)"
.sp
‏Kea از بسته‌های نرم‌افزاری جانبی متعددی استفاده می‌کند که ممکن است در نصب پیش‌فرض برخی از سیستم‌عامل‌ها یا در مخازن بسته‌های استاندارد ارائه نشده باشند. ممکن است لازم باشد این نرم‌افزارهای مورد نیاز به‌طور جداگانه نصب شوند. (برای پیش‌نیازهای ساخت، همچنین پیش‌نیازهای ساخت \%<#\:build-requirements>\& را ببینید.)
.INDENT 0.0
.IP \(bu 2
‏Kea از دو کتابخانه رمزنگاری پشتیبانی می‌کند: Botan و OpenSSL. در هنگام کامپایل تنها نصب یکی از آن‌ها الزامی است. Kea از کتابخانه Botan برای C++ (\%<https://\:botan\:.randombit\:.net>)، نسخه 2.0 یا جدیدتر استفاده می‌کند؛ پشتیبانی از نسخه‌های Botan قدیمی‌تر از 2.0 از زمان انتشار Kea 1.7.0 حذف شد. به عنوان جایگزینی برای Botan، نرم‌افزار Kea می‌تواند از کتابخانه رمزنگاری OpenSSL (\%<https://\:www\:.openssl\:.org>)، نسخه 1.0.2 یا بالاتر استفاده کند.
.IP \(bu 2
‏Kea از کتابخانه لاگ‌گیری log4cplus برای C++ (\%<https://\:sourceforge\:.net/\:p/\:log4cplus/\:wiki/\:Home>) استفاده می‌کند. این برنامه به log4cplus نسخه 1.0.3 یا جدیدتر نیاز دارد.
.IP \(bu 2
‏Kea به کتابخانه سیستمی Boost (\%<https://\:www\:.boost\:.org>) نیاز دارد. ساخت با نسخه header\-only کتابخانه Boost دیگر توصیه نمی‌شود.
.UNINDENT
.sp
برخی از ویژگی‌های اختیاری Kea دارای وابستگی‌های بیشتری هستند.
.INDENT 0.0
.IP \(bu 2
برای ذخیره اطلاعات اجاره (lease) در یک پایگاه داده MySQL، برنامه Kea به هدرها و کتابخانه‌های MySQL نیاز دارد. این یک وابستگی اختیاری است؛ Kea می‌تواند بدون پشتیبانی از MySQL ساخته شود.
.IP \(bu 2
برای ذخیره اطلاعات اجاره در یک پایگاه داده PostgreSQL، برنامه Kea به هدرها و کتابخانه‌های PostgreSQL نیاز دارد. این یک وابستگی اختیاری است؛ Kea می‌تواند بدون پشتیبانی از PostgreSQL ساخته شود.
.IP \(bu 2
‏Kea یک رابط NETCONF با عامل \fBkea\-netconf\fP ارائه می‌دهد. این ماژول Kea هنگام استفاده به نرم‌افزار Sysrepo نیاز دارد. ساخت Kea با پشتیبانی از NETCONF نیازمند نصب وابستگی‌های متعددی است که در نصب NETCONF \%<#\:netconf-install>\& با جزئیات بیشتر شرح داده شده است. این یک وابستگی اختیاری است؛ Kea می‌تواند بدون پشتیبانی از NETCONF ساخته شود.
.IP \(bu 2
برای امضا و اعتبارسنجی به‌روزرسانی‌های DNS، سرور Kea DDNS ممکن است از GSS\-TSIG استفاده کند که به کتابخانه‌های MIT Kerberos 5 یا Heimdal نیاز دارد. وابستگی‌هایی که باید نصب شوند با جزئیات بیشتر در کامپایل GSS\-TSIG \%<#\:gss-tsig-install>\& توضیح داده شده‌اند. این یک وابستگی اختیاری است؛ Kea می‌تواند بدون پشتیبانی از GSS\-TSIG ساخته شود.
.UNINDENT
.SS "نرم‌افزار Kea (Kea Software)"
.sp
‏Kea یک راهکار ماژولار سرور DHCP است. این ماژولار بودن با به‌کارگیری چندین فرآیند همکار محقق می‌شود که در کنار یکدیگر عملکردهای سرور را فراهم می‌آورند. نرم‌افزارهای زیر همراه با Kea ارائه شده‌اند:
.INDENT 0.0
.IP \(bu 2
\fBkeactrl\fP \%<#\:std-iscman-keactrl> — این ابزار سرورهای Kea را راه‌اندازی و متوقف کرده، مجدداً پیکربندی نموده و وضعیت آن‌ها را گزارش می‌دهد.
.IP \(bu 2
\fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> — فرآیند سرور DHCPv4. این فرآیند به درخواست‌های DHCPv4 از سوی کلاینت‌ها پاسخ می‌دهد.
.IP \(bu 2
\fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> — فرآیند سرور DHCPv6. این فرآیند به درخواست‌های DHCPv6 از سوی کلاینت‌ها پاسخ می‌دهد.
.IP \(bu 2
\fBkea\-dhcp\-ddns\fP \%<#\:std-iscman-kea-dhcp-ddns> — فرآیند Dynamic DNS مربوط به DHCP. این فرآیند به عنوان یک واسطه بین سرورهای DHCP و سرورهای خارجی DNS عمل می‌کند؛ درخواست‌های به‌روزرسانی نام را از سرورهای DHCP دریافت کرده و پیام‌های به‌روزرسانی DNS را به سرورهای DNS ارسال می‌کند.
.IP \(bu 2
\fBkea\-admin\fP \%<#\:std-iscman-kea-admin> — این ابزاری مفید برای نگهداری بک‌اند پایگاه داده است (ایجاد پایگاه داده جدید، بررسی نسخه‌ها، ارتقا و غیره).
.IP \(bu 2
\fBkea\-lfc\fP \%<#\:std-iscman-kea-lfc> — این فرآیند اطلاعات تکراری و اضافی را از فایل‌هایی که برای ذخیره‌سازی پایدار بک‌اند پایگاه داده memfile استفاده می‌شوند، حذف می‌کند. اگرچه می‌تواند به صورت مستقل اجرا شود، معمولاً در زمان و صورت نیاز توسط سرورهای DHCP Kea اجرا می‌شود.
.IP \(bu 2
\fBkea\-netconf\fP \%<#\:std-iscman-kea-netconf> \- عامل kea\-netconf رابطی بر پایه YANG/NETCONF برای پیکربندی Kea فراهم می‌کند.
.IP \(bu 2
\fBkea\-shell\fP \%<#\:std-iscman-kea-shell> — این کلاینت متنی ساده از رابط REST برای اتصال به سرور Kea استفاده می‌کند.
.IP \(bu 2
\fBperfdhcp\fP \%<#\:std-iscman-perfdhcp> — این ابزاری برای محک‌زدن (benchmarking) کارایی DHCP است که چندین کلاینت را شبیه‌سازی می‌کند تا عملکرد هر دو سرور DHCPv4 و DHCPv6 را آزمایش کند.
.UNINDENT
.sp
ابزارها و ماژول‌ها با جزئیات کامل در این راهنما پوشش داده شده‌اند. افزون بر این، صفحات راهنما (man pages) نیز در نصب پیش‌فرض ارائه شده‌اند.
.sp
‏Kea همچنین کتابخانه‌های C++ و رابط‌های برنامه‌نویسی برای DHCP فراهم می‌کند. این موارد شامل مستندات جامع توسعه‌دهنده و نمونه‌کدها هستند.
.SH "شروع سریع (QUICK START)"
.sp
این بخش گام‌های اولیه‌ی لازم برای راه‌اندازی و اجرای Kea را شرح می‌دهد. برای جزئیات بیشتر، سفارشی‌سازی‌های کامل و عیب‌یابی، به فصل‌های مربوطه در سایر بخش‌های این «راهنمای مرجع مدیر سیستم Kea» (ARM) مراجعه کنید.
.SS "راهنمای شروع سریع با استفاده از tarball (Quick Start Guide Using tarball)"
.INDENT 0.0
.IP 1. 3
وابستگی‌های لازم برای زمان اجرا و ساخت را نصب کنید. برای جزئیات به
پیش‌نیازهای ساخت \%<#\:build-requirements> مراجعه کنید.
.IP 2. 3
بسته tarball سورس Kea را از
صفحه اصلی دانلودهای isc.org \%<https://\:www\:.isc\:.org/\:download>،
سایت دانلودهای ISC \%<https://\:downloads\:.isc\:.org/\:isc/\:kea> یا
صفحه Cloudsmith مربوط به ISC \%<https://\:cloudsmith\:.io/\:~isc/\:packages/?\:q=format%3Araw>\& دریافت کنید.
.IP 3. 3
بسته tarball را استخراج کنید. برای مثال:
.INDENT 3.0
.INDENT 3.5
.sp
.EX
$ tar \-Jxvf kea\-3.2.0\&.tar.xz
.EE
.UNINDENT
.UNINDENT
.IP 4. 3
به دایرکتوری سورس بروید و فرآیند ساخت را برپا کنید:
.INDENT 3.0
.INDENT 3.5
.sp
.EX
$ cd kea\-3.2.0
$ meson setup build [your extra parameters]
.EE
.UNINDENT
.UNINDENT
.IP 5. 3
آن را بسازید:
.INDENT 3.0
.INDENT 3.5
.sp
.EX
$ meson compile \-C build
.EE
.UNINDENT
.UNINDENT
.IP 6. 3
آن را نصب کنید (به‌طور پیش‌فرض در \fB/usr/local/\fP قرار خواهد گرفت، بنابراین به احتمال زیاد برای این مرحله به دسترسی‌های ریشه (root) نیاز است):
.INDENT 3.0
.INDENT 3.5
.sp
.EX
$ meson install \-C build
.EE
.UNINDENT
.UNINDENT
.UNINDENT.SS راهنمای شروع سریع با استفاده از بسته‌های بومی (Native)
.sp
شرکت ISC بسته‌های بومی Alpine، deb و RPM را ارائه می‌دهد که نصب Kea را بسیار آسان‌تر از ساخت آن از کد منبع می‌سازد. مگر در مواردی که گزینه‌های کامپایل خاصی مد نظر باشد، معمولاً نصب Kea با استفاده از بسته‌های بومی ساده‌تر است.
.INDENT 0.0
.IP 1. 3
به صفحهٔ Kea در cloudsmith.io بروید: \%<https://\:cloudsmith\:.io/\:~isc/\:repos>\&.
.IP 2. 3
مخزن Cloudsmith مورد نظر را انتخاب کنید؛ برای نمونه kea\-3\-2 برای Kea 3.2.0\&.
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
تمامی نسخه‌های پایدار در مخازن جداگانه نگهداری می‌شوند، مانند kea\-2\-6، kea\-3\-0 و غیره.
تمامی نسخه‌های در حال توسعه، که استفاده از آن‌ها در محیط‌های عملیاتی توصیه نمی‌شود،
در مخزن kea\-dev قرار دارند.
.UNINDENT
.UNINDENT
.INDENT 0.0
.IP 3. 3
روی پیکان کنار دکمهٔ \(dqSet Me Up\(dq کلیک کرده و توزیع سیستم‌عامل مورد نظر را انتخاب کنید:
Alpine، Debian یا RedHat.
.IP 4. 3
دستورالعمل‌های روی صفحه را دنبال کنید.
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
برای نمونه، دستورالعمل‌های راه‌اندازی Debian برای Kea 3.0 در اینجا در دسترس است:
\%<https://\:cloudsmith\:.io/\:~isc/\:repos/\:kea-3-0/\:setup/#\:formats-deb>
.sp
منوی کشویی بالای صفحه، دستورالعمل‌های مربوط به
سایر سیستم‌عامل‌ها را ارائه می‌دهد.
.UNINDENT
.UNINDENT
.INDENT 0.0
.IP 5. 3
برنامهٔ Kea به بسته‌های گوناگونی تقسیم شده است. کل فهرست در صفحهٔ مخزن
Cloudsmith زیر بخش \fBPackages\fP موجود است، یا می‌توان آن را با
استفاده از \fBapk\fP/\fBapt\fP/\fBdnf\fP دریافت کرد\&.
.UNINDENT
.TS
box center;
l|l.
T{
Debian/Ubuntu
T}	T{
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ apt search isc\-kea
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
بسته‌های \fBisc\-kea\-dhcp4\-server\fP و \fBisc\-kea\-dhcp6\-server\fP بسته‌های خالی
انتقالی (transitional) هستند. بسته‌های اصلی سرور
\fBisc\-kea\-dhcp4\fP و \fBisc\-kea\-dhcp6\fP می‌باشند\&.
.UNINDENT
.UNINDENT
T}
_
T{
Fedora/RedHat
T}	T{
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ dnf search \(aqisc\-kea*\(aq
.EE
.UNINDENT
.UNINDENT
T}
_
T{
Alpine
T}	T{
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ apk search isc\-kea
.EE
.UNINDENT
.UNINDENT
T}
.TE
.INDENT 0.0
.IP 6. 3
نصب فرا\-بسته (metapackage) شامل تمامی ابزارها، کتابخانه‌ها، سرورها،
مستندات و هوک‌های (hooks) متن‌باز:
.UNINDENT
.TS
box center;
l|l.
T{
Debian/Ubuntu
T}	T{
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ sudo apt install isc\-kea
.EE
.UNINDENT
.UNINDENT
T}
_
T{
Fedora/RedHat
T}	T{
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ sudo dnf install isc\-kea
.EE
.UNINDENT
.UNINDENT
T}
_
T{
Alpine
T}	T{
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# apk add isc\-kea
.EE
.UNINDENT
.UNINDENT
T}
.TE
.sp
یا بسته‌های مشخص:
.TS
box center;
l|l.
T{
Debian/Ubuntu
T}	T{
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ sudo apt install isc\-kea\-dhcp6
.EE
.UNINDENT
.UNINDENT
T}
_
T{
Fedora/RedHat
T}	T{
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ sudo dnf install isc\-kea\-dhcp6
.EE
.UNINDENT
.UNINDENT
T}
_
T{
Alpine
T}	T{
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ apk add isc\-kea\-dhcp6
.EE
.UNINDENT
.UNINDENT
T}
.TE
.sp
یا تمامی بسته‌های مرتبط با Kea، شامل هدرهای توسعه، نمادهای
اشکال‌زدایی (debug symbols) و هوک‌های مشترکین (در صورت موجود بودن):
.TS
box center;
l|l.
T{
Debian/Ubuntu
T}	T{
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ sudo apt install \(aqisc\-kea*\(aq
.EE
.UNINDENT
.UNINDENT
T}
_
T{
Fedora/RedHat
T}	T{
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ sudo dnf install \(aqisc\-kea*\(aq
.EE
.UNINDENT
.UNINDENT
T}
_
T{
Alpine
T}	T{
نصب بسته‌ها از طریق الگوهای تطبیق نام (\fB*\fP) در Alpine در دسترس نیست،
اما می‌توان آن را با دستور زیر شبیه‌سازی کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# apk search isc\-kea | sed \(aqs/\-[0\-9].*//g\(aq | xargs apk add
.EE
.UNINDENT
.UNINDENT
T}
.TE
.sp
یا تمامی بسته‌ها با یک شماره نسخهٔ مشخص:
.TS
box center;
l|l.
T{
Debian/Ubuntu
T}	T{
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ sudo apt install \(aqisc\-kea*=2.4.0\-isc20230921141113\(aq
.EE
.UNINDENT
.UNINDENT
T}
_
T{
Fedora/RedHat
T}	T{
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ sudo dnf install \(aqisc\-kea*2.4.0\-isc20230921141113*\(aq
.EE
.UNINDENT
.UNINDENT
T}
_
T{
Alpine
T}	T{
نصب بسته‌ها از طریق الگوهای تطبیق نام (\fB*\fP) در Alpine در دسترس نیست،
اما می‌توان آن را با دستور زیر شبیه‌سازی کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# apk search isc\-kea | sed \(aqs/\-[0\-9].*//g\(aq | grep r20230921141113 | xargs apk add
.EE
.UNINDENT
.UNINDENT
T}
.TE
.INDENT 0.0.IP 8. 3
اکنون تمام بسته‌های نصب‌شده باید در دسترس باشند.
.INDENT 3.0
.INDENT 3.5
می‌توانید سرور را به‌صورت دستی راه‌اندازی کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# kea\-dhcp6 \-c /etc/kea/kea\-dhcp6.conf
.EE
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
یا با استفاده از systemd:
.INDENT 3.0
.INDENT 3.5
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# systemctl restart kea\-dhcp6
.EE
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
یا با استفاده از OpenRC در Alpine:
.INDENT 3.0
.INDENT 3.5
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# service kea\-dhcp6 restart
.EE
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
ابزار \fBkeactrl\fP \%<#\:std-iscman-keactrl> در بسته‌ها ارائه نشده است، چرا که عملکرد مشابه توسط اسکریپت‌های بومی systemctl فراهم شده است.
.UNINDENT
.UNINDENT
.INDENT 0.0
.IP 9. 3
در سیستم‌های Debian/Ubuntu، هنگام نصب بسته، سرویس به‌طور خودکار در زمان بوت فعال می‌شود. در Fedora/RHEL و Alpine، سرویس به‌صورت خودکار فعال نمی‌شود؛ بنابراین در صورت نیاز، باید به‌طور دستی فعال گردد.
.INDENT 3.0
.INDENT 3.5
با systemd در Fedora/RedHat:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# systemctl enable kea\-dhcp6
.EE
.UNINDENT
.UNINDENT
.sp
با OpenRC در Alpine:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# rc\-update add kea\-dhcp6
.EE
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.SS راهنمای شروع سریع با استفاده از کانتینرهای Docker
.INDENT 0.0
.IP 1. 3
به مخزن داکر ISC در cloudsmith.io \%<https://\:cloudsmith\:.io/\:~isc/\:repos/\:docker/\:packages>\& بروید.
.IP 2. 3
یک شبکه ipvlan متصل به رابط میزبان رو به کلاینت و اختصاص‌یافته به زیرشبکه‌ای که توسط Kea سرویس‌دهی می‌شود، ایجاد کنید.
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ docker network create \-\-driver ipvlan \-\-ipv6 \-\-subnet 2001:db8::/64 \-\-opt parent=eth0 ipvlan0
.EE
.UNINDENT
.UNINDENT
.INDENT 0.0
.IP 3. 3
ایمیج دلخواه را انتخاب کرده و آن را به‌صورت محلی pull کنید.
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ docker pull docker.cloudsmith.io/isc/docker/kea\-dhcp6
.EE
.UNINDENT
.UNINDENT
.INDENT 0.0
.IP 4. 3
یک کانتینر از ایمیج بسازید. در صورت نیاز، حجم پیکربندی و حجم داده را سوار (mount) کنید.
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ docker create \e
    \-\-name kea\-dhcp6 \e
    \-\-network ipvlan0 \e
    \-\-volume /local/kea/config:/etc/kea \e
    \-\-volume /local/kea/data:/var/lib/kea \e
    docker.cloudsmith.io/isc/docker/kea\-dhcp6
.EE
.UNINDENT
.UNINDENT
.INDENT 0.0
.IP 5. 3
کانتینر داکر را راه‌اندازی کنید.
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ docker start kea\-dhcp6
.EE
.UNINDENT
.UNINDENT
.INDENT 0.0
.IP 6. 3
برای متوقف کردن کانتینر داکر، اجرا کنید:
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ docker stop kea\-dhcp6
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
برای سناریوهای پیچیده‌تر، به راهنمای kea\-docker در \%<https://\:gitlab\:.isc\:.org/\:isc-projects/\:kea-docker#\:user-content-docker-files-for-building-kea-containers> مراجعه کنید.
.UNINDENT
.UNINDENT.SS راهنمای شروع سریع برای سرویس‌های DHCPv4 و DHCPv6
.INDENT 0.0
.IP 1. 3
فایل‌های پیکربندی Kea را که به‌طور پیش‌فرض در دایرکتوری
\fB\(dq[kea\-install\-dir]/etc/kea/\(dq\fP نصب می‌شوند ویرایش کنید. این فایل‌ها عبارتند از:
\fBkea\-dhcp4.conf\fP، \fBkea\-dhcp6.conf\fP، \fBkea\-dhcp\-ddns.conf\fP، و
\fBkeactrl.conf\fP که به‌ترتیب مربوط به کارساز DHCPv4، کارساز DHCPv6،
D2 و اسکریپت keactrl هستند.
.IP 2. 3
برای راه‌اندازی کارساز DHCPv4 در پس‌زمینه، دستور
زیر را (به‌عنوان root) اجرا کنید:
.INDENT 3.0
.INDENT 3.5
.sp
.EX
# keactrl start \-s dhcp4
.EE
.UNINDENT
.UNINDENT
.sp
یا دستور زیر را برای راه‌اندازی کارساز DHCPv6 اجرا کنید:
.INDENT 3.0
.INDENT 3.5
.sp
.EX
# keactrl start \-s dhcp6
.EE
.UNINDENT
.UNINDENT
.sp
توجه داشته باشید که راه‌اندازی هم‌زمان تمامی کارسازها نیز ممکن است:
.INDENT 3.0
.INDENT 3.5
.sp
.EX
# keactrl start
.EE
.UNINDENT
.UNINDENT
.IP 3. 3
بررسی کنید که کارساز(های) Kea در حال اجرا هستند:
.INDENT 3.0
.INDENT 3.5
.sp
.EX
# keactrl status
.EE
.UNINDENT
.UNINDENT
.sp
وضعیت \(dqinactive\(dq برای یک کارساز می‌تواند نشان‌دهنده خطای پیکربندی باشد.
لطفاً فایل گزارش لاگ را (که به‌طور پیش‌فرض با نام
\fB\(dq[kea\-install\-dir]/var/log/kea/kea\-dhcp4.log\(dq\fP،
\fB\(dq[kea\-install\-dir]/var/log/kea/kea\-dhcp6.log\(dq\fP، یا
\fB\(dq[kea\-install\-dir]/var/log/kea/kea\-ddns.log\(dq\fP شناخته می‌شود)
برای مشاهده جزئیات خطاها بررسی کنید.
.IP 4. 3
اگر کارساز با موفقیت راه‌اندازی شد، آزمایش کنید که آیا به پرس‌وجوهای DHCP پاسخ می‌دهد
و کلاینت پیکربندی را از کارساز دریافت می‌کند یا خیر؛ برای مثال، از کلاینت
ISC DHCP در \%<https://\:www\:.isc\:.org/\:download>\& استفاده کنید.
.IP 5. 3
برای متوقف کردن کارساز(ها):
.INDENT 3.0
.INDENT 3.5
.sp
.EX
# keactrl stop
.EE
.UNINDENT
.UNINDENT
.UNINDENT
.sp
برای دستورالعمل‌های ویژه‌ی هر سیستم، لطفاً یادداشت‌های اختصاصی سیستم
\%<https://\:kb\:.isc\:.org/\:docs/\:installing-kea> را که در بخش Kea در
پایگاه دانش ISC به نشانی \%<https://\:kb\:.isc\:.org/\:docs>\& موجود است مطالعه کنید.
.sp
جزئیات مربوط به نحوه استفاده از اسکریپت \fBkeactrl\fP \%<#\:std-iscman-keactrl> را می‌توانید در Managing Kea with keactrl \%<#\:keactrl>\& بیابید.
.sp
پس از راه‌اندازی و اجرای سرویس‌های Kea، استقرار یک راهکار داشبورد
را برای نظارت بر سرویس‌های فعال در نظر بگیرید. برای جزئیات بیشتر، Monitoring Kea With Stork \%<#\:stork>\& را ببینید.
.SS اجرای مستقیم کارسازهای Kea
.sp
کارسازهای Kea را می‌توان مستقیماً و بدون نیاز به استفاده از
\fBkeactrl\fP \%<#\:std-iscman-keactrl> یا \fBsystemctl\fP\& راه‌اندازی کرد. برای راه‌اندازی کارساز DHCPv4 دستور زیر را اجرا کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# kea\-dhcp4 \-c /path/to/your/kea4/config/file.json
.EE
.UNINDENT
.UNINDENT
.sp
به همین ترتیب، برای راه‌اندازی کارساز DHCPv6، دستور زیر را اجرا کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# kea\-dhcp6 \-c /path/to/your/kea6/config/file.json
.EE
.UNINDENT
.UNINDENT
.SH "نصب (INSTALLATION)"
.SS بسته‌ها
.sp
سازمان ISC بسته‌های محلی RPM، deb و APK و همچنین فایل‌های فشرده tarball
حاوی کد منبع را منتشر می‌کند. این بسته‌ها در مخازن Cloudsmith
مربوط به ISC به نشانی \%<https://\:cloudsmith\:.io/\:~isc/\:repos>\& در دسترس هستند.
بسته‌های بومی را می‌توان با استفاده از سیستم مدیریت بسته موجود در توزیع مورد نظر
(مانند dpkg یا rpm) دریافت و نصب کرد. همچنین می‌توان مخزن Kea را به سیستم
اضافه کرد تا نصب به‌روزرسانی‌ها آسان‌تر شود. برای دریافت جزئیات، لطفاً به
\%<https://\:cloudsmith\:.io/\:~isc/\:repos> مراجعه کرده، نسخه Kea مورد نظر را انتخاب نمایید،
و سپس بر روی دکمه \(dqSet Me Up\(dq کلیک کنید. برای دستورالعمل‌های دقیق‌تر،
لطفاً به این مقاله در پایگاه دانش \%<https://\:kb\:.isc\:.org/\:docs/\:isc-kea-packages>\& مراجعه فرمایید.
.sp
سازمان ISC دو نوع مخزن را نگهداری می‌کند: پایدار (stable) و توسعه (development).
مخازن پایدار شامل یک انتشار پایدار مشخص (مانند kea\-2\-6 یا kea\-3\-0) به همراه تمامی
به‌روزرسانی‌های نگهداری آن هستند. ایجاد مخازن مجزا برای به حداقل رساندن خطر
ارتقای ناخواسته از یک انتشار پایدار به انتشار پایدار دیگر صورت گرفته است.
.sp
مخزن توسعه، با عنوان kea\-dev، شامل نسخه‌های توسعه فعلی و آتی است که
ISC استفاده از آن‌ها را برای محیط‌های عملیاتی توصیه نمی‌کند. بسته‌های
موجود در مخزن kea\-dev مشمول پاک‌سازی دوره‌ای هستند و ممکن است نسخه‌های
قدیمی‌تر از روی آن حذف شوند..SS نصب از طریق بسته‌های Cloudsmith
.sp
شرکت ISC بسته‌های Kea را برای Alpine، Debian، Fedora، RHEL و Ubuntu ارائه می‌دهد.
روش پیشنهادی برای نصب Kea روی هر یک از این سیستم‌ها،
نصب فرابسته \fBisc\-kea\fP از مخزن Cloudsmith است.
این فرابسته در تمام توزیع‌های پشتیبانی‌شده موجود است و
تمامی سرویس‌های ارائه‌شده توسط مجموعه نرم‌افزاری Kea را نصب می‌کند.
.sp
اجزای خاص Kea را می‌توان به‌صورت جداگانه از طریق هر یک از بسته‌های زیر نصب کرد:
.INDENT 0.0
.IP \(bu 2
\fBisc\-kea\-dhcp4\fP — بسته کارگزار Kea DHCPv4
.IP \(bu 2
\fBisc\-kea\-dhcp6\fP — بسته کارگزار Kea DHCPv6
.IP \(bu 2
\fBisc\-kea\-dhcp\-ddns\fP — کارگزار Kea DHCP DDNS
.IP \(bu 2
\fBisc\-kea\-admin\fP — ابزارهای مدیریت پایگاه‌داده Kea
.IP \(bu 2
\fBisc\-kea\-hooks\fP — قلاب‌های متن‌باز Kea DHCP
.UNINDENT
.sp
بسته‌های قلاب مشترکین Kea در بسته \fBisc\-kea\-hooks\fP گنجانده نشده‌اند.
برای مشتریان ISC با دسترسی به قلاب‌های مشترکین، آن بسته‌ها دارای پیشوند
\fBisc\-kea\-subscriber\-\fP هستند. کاربرانی که علاقه‌مند به خرید خدمات پشتیبانی حرفه‌ای
از ISC و دسترسی به قلاب‌های مشترکین هستند، می‌توانند فرم تماس را
در \%<https://\:www\:.isc\:.org/\:contact>\& تکمیل نمایند.
.sp
پس از نصب، سرویس‌ها را می‌توان از طریق مدیر سرویس توزیع مدیریت کرد.
نام این سرویس‌ها عبارت است از: \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4>، \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6>
و \fBkea\-dhcp\-ddns\fP \%<#\:std-iscman-kea-dhcp-ddns>\&.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
نام‌های واقعی سرویس در Debian و Ubuntu جهت حفظ سازگاری با برخی اسکریپت‌های قدیمی‌تر،
کمی با نام بسته‌ها تفاوت دارند. از یک نام مستعار در سرویس systemd استفاده شده است تا کاربران
بتوانند با نام‌های کوتاه‌تر به آن‌ها ارجاع دهند. اجرای دستور \fBsystemctl enable\fP روی این
سرویس‌ها نیازمند نام‌های واقعی سرویس است، که عبارتند از: \fBisc\-kea\-dhcp4\-server\fP،
\fBisc\-kea\-dhcp6\-server\fP و \fBisc\-kea\-dhcp\-ddns\-server\fP\&.
.UNINDENT
.UNINDENT
.SS هشدارهای هنگام ارتقای بسته‌های Kea
.sp
برای ارتقا به نسخه فعلی Kea از نسخه 2.3.2 یا پیش‌تر روی سیستم‌های Debian
و Ubuntu، به جای دستور معمول \fBapt upgrade\fP دستور \fBapt dist\-upgrade\fP را اجرا کنید.
پس از تکمیل این ارتقا، می‌توان به‌صورت معمول با استفاده از \fBapt upgrade\fP در سیستم‌های
Debian و Ubuntu نسخه‌های بعدی را ارتقا داد.
.sp
کاربران ممکن است متوجه تفاوت‌هایی میان بسته‌های توزیع‌شده در نسخه‌های پیش از 2.3.2
نرم‌افزار Kea و بسته‌های ارائه‌شده در نسخه 2.3.2 و بعد از آن شوند. در پی بازنگری کلی در
طراحی بسته‌بندی در آن انتشار، برخی بسته‌ها تغییر نام یافته یا حذف شدند.
برای اطمینان از پیش رفتن هرچه روان‌تر فرایند ارتقا، دقت کنید که چه بسته‌هایی
طی تراکنش ارتقا حذف و نصب می‌شوند و مطمئن شوید که تمامی بسته‌های مورد نیاز
مجدداً نصب شده‌اند.
.sp
به‌ویژه، بسته به اینکه در ابتدا چه بسته‌هایی نصب شده بودند، احتمال دارد بسته‌های زیر
طی ارتقا حذف شوند:
.INDENT 0.0
.IP \(bu 2
\fBisc\-kea\-dhcp4\fP
.IP \(bu 2
\fBisc\-kea\-dhcp6\fP
.IP \(bu 2
\fBisc\-kea\-dhcp\-ddns\fP
.IP \(bu 2
\fBisc\-kea\-hooks\fP
.UNINDENT
.sp
برای نصب کامل مجموعه نرم‌افزاری Kea، کافی است پس از ارتقا دستور
\fBapt install isc\-kea\fP را اجرا کنید که
تمامی زیربسته‌های مرتبط تشکیل‌دهنده Kea را نصب خواهد کرد.
.sp
این مشکل مسیر ارتقا برای سیستم‌های RPM و Alpine وجود ندارد.
.sp
از مشتریان دارای قرارداد پشتیبانی ISC که در ارتقا با دشواری مواجه می‌شوند دعوت می‌شود
یک تیکت در صف پشتیبانی خود ثبت کنند. به سایر کاربران توصیه می‌شود وضعیت خود را در فهرست پستی kea\-users در
\%<https://\:lists\:.isc\:.org/\:mailman/\:listinfo/\:kea-users> مطرح کنند تا از پشتیبانی دیگر اعضای فهرست بهره‌مند گردند.
.SS ساختار سلسله‌مراتبی نصب
.sp
در زیر ساختار دایرکتوری‌های یک نصب کامل Kea آورده شده است.
(تمام مسیرهای دایرکتوری نسبت به دایرکتوری نصب در نظر گرفته شده‌اند.)
.INDENT 0.0
.IP \(bu 2
\fBetc/kea/\fP — فایل‌های پیکربندی.
.IP \(bu 2
\fBinclude/\fP — فایل‌های هدر توسعه C++.
.IP \(bu 2
\fBlib/\fP — کتابخانه‌ها.
.IP \(bu 2
\fBlib/kea/hooks\fP — کتابخانه‌های قلاب الحاقی.
.IP \(bu 2
\fBsbin/\fP — نرم‌افزار کارگزار و دستورهای مورد استفاده مدیر سیستم.
.IP \(bu 2
\fBshare/doc/kea/\fP — این راهنما، سایر مستندات تکمیلی، و مثال‌ها.
.IP \(bu 2
\fBshare/kea/\fP — مثال‌های دستورات API و اسکریپت‌های طرحواره پایگاه‌داده (schema).
.IP \(bu 2
\fBshare/man/\fP — صفحات راهنما (مستندات برخط).
.IP \(bu 2
\fBvar/lib/kea/\fP — فایل‌های شناسه کارگزار (DHCPv6) و پایگاه‌داده اجاره (lease).
.IP \(bu 2
\fBvar/log/kea/\fP \- فایل‌های گزارش (log).
.IP \(bu 2
\fBvar/run/kea\fP \- فایل PID و فایل قفل لاگر.
.UNINDENT
.SS پیش‌نیازهای ساخت
.sp
علاوه بر پیش‌نیازهای زمان اجرا (فهرست‌شده در
نرم‌افزارهای مورد نیاز در زمان اجرا \%<#\:required-software>)، ساخت Kea از کد منبع نیازمند
هدرهای مختلف توسعه و ابزارهای تولید برنامه است.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
برخی سیستم‌عامل‌ها بسته‌های توزیع خود را به دو بسته زمان اجرا و توسعه
تفکیک کرده‌اند. برای ساخت Kea از کد منبع، باید
نسخه‌های بسته توسعه که حاوی فایل‌های هدر و کتابخانه‌ها هستند
نصب شوند.
.UNINDENT
.UNINDENT
.sp
ساخت از کد منبع مستلزم نصب نرم‌افزارهای زیر روی
سیستم است:
.INDENT 0.0
.IP \(bu 2
ابزارهای توسعه meson، ninja و pkg\-config.
.IP \(bu 2
کتابخانه‌های C++ بست Boost (\%<https://\:www\:.boost\:.org>) (حداقل نسخه 1.66).
روی نسخه‌های قدیمی‌تر از 1.69 کتابخانه Boost system نیز باید نصب باشد.
.IP \(bu 2
‏OpenSSL (حداقل نسخه 1.0.2) یا Botan (حداقل نسخه 3.4.0).
نسخه 1.1.1 یا جدیدتر OpenSSL اکیداً توصیه می‌شود.
.IP \(bu 2
هدرهای توسعه log4cplus (حداقل نسخه 1.0.3).
.IP \(bu 2
یک کامپایلر C++ (با پشتیبانی از C++14) و هدرهای استاندارد توسعه.
.IP \(bu 2
کلاینت MySQL و کتابخانه‌های توسعه کلاینت، هنگام استفاده از پرچم
پیکربندی \fB\-D mysql=enabled\fP برای ساخت بک‌اند پایگاه‌داده MySQL نرم‌افزار Kea. در این حالت،
به یک نمونه در حال اجرای سرور MySQL به صورت محلی یا روی ماشینی در دسترس
از طریق شبکه نیاز است. توجه داشته باشید که اجرای آزمون‌های واحد (unit tests)
نیازمند سرور MySQL محلی است.
.IP \(bu 2
کلاینت PostgreSQL و کتابخانه‌های توسعه کلاینت، هنگام استفاده از پرچم
پیکربندی \fB\-D postgresql=enabled\fP برای ساخت بک‌اند پایگاه‌داده PostgreSQL نرم‌افزار Kea.
در این حالت به یک نمونه در حال اجرای سرور PostgreSQL به صورت محلی یا روی ماشینی
در دسترس از طریق شبکه نیاز است. توجه داشته باشید که اجرای آزمون‌های واحد
نیازمند سرور PostgreSQL محلی است.
.IP \(bu 2
‏Sysrepo نسخه 1.4.140 و libyang نسخه 1.0.240، که برای اتصال به یک پایگاه داده
Sysrepo مورد نیاز هستند. نسخه‌های قبلی دیگر پشتیبانی نمی‌شوند. هنگام کامپایل از
کد منبع، سوییچ پیکربندی قابل استفاده \fB\-D netconf=enabled\fP است.
اگر این وابستگی‌ها در مسیرهای سفارشی نصب شده‌اند، PKG_CONFIG_PATH را
به سمت آن‌ها تنظیم کنید.
.IP \(bu 2
کتابخانه‌های MIT Kerberos 5 یا Heimdal توسط سرور Kea DDNS برای
امضا و اعتبارسنجی به‌روزرسانی‌های DNS با استفاده از GSS\-TSIG نیاز هستند. سوییچ پیکربندی که
این قابلیت را فعال می‌کند \fB\-D krb5=enabled\fP است. اگر این وابستگی
در مسیری سفارشی نصب شده است، PKG_CONFIG_PATH را به فایل .pc یا PATH را به ابزار
krb5\-config هدایت نمایید.
.IP \(bu 2
‏googletest (نسخه 1.8 یا بالاتر) هنگام استفاده از گزینه پیکربندی \fB\-D tests=enabled\fP
برای ساخت آزمون‌های واحد الزامی است.
.IP \(bu 2
ابزارهای تولید مستندات Sphinx \%<https://\:www\:.sphinx-doc\:.org>،
‏texlive به همراه افزونه‌های آن، و Doxygen برای ایجاد مستندات.
به‌ویژه در Fedora بسته‌های \fBpython3\-sphinx\fP، \fBpython3\-sphinx_rtd_theme\fP،
\fBtexlive\fP و \fBtexlive\-collection\-latexextra\fP ضروری هستند.
در Ubuntu بسته‌های \fBpython3\-sphinx\fP، \fBpython3\-sphinx\-rtd\-theme\fP،
\fBtexlive\fP و \fBtexlive\-latex\-extra\fP مورد نیاز می‌باشند.
چنانچه بسته‌های LaTeX یافت نشوند، Kea از ساخت PDF صرف‌نظر کرده و تنها
اسناد HTML تولید می‌کند.
.UNINDENT
.sp
برای نکات نصب اختصاصی هر سیستم، از پایگاه دانش ISC به نشانی \%<https://\:kb\:.isc\:.org/\:docs/\:installing-kea>
دیدن کنید..SS نصب از کد منبع
.sp
اگرچه ممکن است Kea به‌صورت بسته‌های از پیش کامپایل‌شده و آمادهٔ استفاده از سوی توزیع‌کنندگان سیستم‌عامل ارائه شده باشد، اما این نرم‌افزار، یک نرم‌افزار متن‌باز است که به زبان ++C نوشته شده است. به همین جهت، به‌صورت کد منبع آزاد و در قالب یک فایل tar قابل بارگیری از سوی ISC عرضه می‌شود. همچنین کد منبع را می‌توان از مخزن گیت‌لب Kea در \%<https://\:gitlab\:.isc\:.org/\:isc-projects/\:kea>\& دریافت کرد. این بخش نحوهٔ ساخت Kea از روی کد منبع را شرح می‌دهد.
.SS بارگیری فایل Tar
.sp
فایل‌های فشردهٔ (tarball) انتشار Kea را می‌توان از نشانی زیر بارگیری کرد:
\%<https://\:downloads\:.isc\:.org/\:isc/\:kea>\&.
.SS اعتبارسنجی امضای فایل Tar
.sp
فایل tar حاوی کد منبع به همراه امضای GPG آن توزیع می‌شود. امضا، فایلی هم‌نام با فایل tar است که پسوند \fB\&.asc\fP به انتهای آن اضافه شده است. می‌توانید فایل امضا را در صفحهٔ بارگیری ما، FTP یا CloudSmith پیدا کنید.
.sp
این امضا با استفاده از کلید امضای کد ISC ایجاد شده است. مجموعهٔ فعلی کلیدهای امضای کد ISC از طریق وب‌سایت ISC در \%<https://\:www\:.isc\:.org/\:pgpkey> (پیوند Current Set of ISC Code\-Signing Keys در \%<https://\:www\:.isc\:.org/\:docs/\:isc-keyblock\:.asc>) در دسترس است.
.sp
امضا را می‌توان با استفاده از ابزار \fBgpg\fP از GnuPG اعتبارسنجی کرد. دستورهای زیر کلیدهای امضای کد (\fBisc\-keyblock.asc\fP) را وارد (import) کرده و امضا را بررسی می‌کنند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ gpg \-\-import isc\-keyblock.asc
$ gpg \-\-verify kea\-X.Y.Z.tar.xz.asc kea\-X.Y.Z.tar.xz
.EE
.UNINDENT
.UNINDENT
.sp
این اعتبارسنجی به کاربران اجازه می‌دهد مطمئن شوند فایل tar دستکاری نشده و توسط ISC ساخته شده است.
.SS دریافت از Git
.sp
جدیدترین کدهای در حال توسعه در GitLab در دسترس است (ببینید:
\%<https://\:gitlab\:.isc\:.org/\:isc-projects/\:kea>). کد منبع Kea عمومی است و توسعه در شاخهٔ «master» انجام می‌شود.
.sp
بارگیری این کدِ \(dqbleeding edge\(dq تنها به توسعه‌دهندگان یا کاربران پیشرفته پیشنهاد می‌شود. استفاده از کدهای در حال توسعه در محیط‌های عملیاتی توصیه نمی‌شود.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
هنگام ساخت از روی کد منبع دریافت‌شده از طریق git، به نرم‌افزارهای جانبی نیاز است: automake (نسخهٔ 1.11 یا بالاتر)، libtoolize و autoconf (نسخهٔ 2.69 یا بالاتر). ممکن است نیاز به نصب این موارد داشته باشید.
.UNINDENT
.UNINDENT
.sp
کد را می‌توان از \fBhttps://gitlab.isc.org/isc\-projects/kea.git\fP دریافت (clone) کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ git clone https://gitlab.isc.org/isc\-projects/kea.git
.EE
.UNINDENT
.UNINDENT
.sp
کد دریافت شده از مخزن git شامل فایل‌های ساخت نیست. آن‌ها را می‌توان با اجرای \fBmeson setup build\fP ایجاد کرد\&.
.sp
دسترسی نوشتن به مخزن Kea تنها به کارکنان ISC اعطا می‌شود. توسعه‌دهندگانی که قصد مشارکت در Kea را دارند باید به راهنمای مشارکت‌کنندگان (Contributor\(aqs
Guide) در \%<https://\:gitlab\:.isc\:.org/\:isc-projects/\:kea/\:blob/\:master/\:contributors-guide\:.md>\& مراجعه کنند. راهنمای توسعه‌دهندگان Kea (Kea Developer\(aqs
Guide) در \%<https://\:reports\:.kea\:.isc\:.org/\:dev_guide> حاوی اطلاعات بیشتری دربارهٔ این فرآیند است و نیازمندی‌های پذیرش کد مشارکت‌شده توسط ISC را شرح می‌دهد.
.SS آماده‌سازی ساخت
.sp
نرم‌افزار Kea از ابزار Meson برای شناسایی جزئیات محیط ساخت استفاده می‌کند. برای تولید فایل ninja با استفاده از مقادیر پیش‌فرض، کافی است دستور زیر را اجرا کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ meson setup build
.EE
.UNINDENT
.UNINDENT
.sp
برای مشاهدهٔ گزینه‌های مختلف ساخت، دستور \fBmeson configure\fP را اجرا کنید. برخی از گزینه‌های پرکاربرد عبارت‌اند از:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
\fB\-\-prefix\fP
تعیین محل نصب (پیش‌فرض \fB/usr/local\fP است).
.IP \(bu 2
\fB\-D mysql=enabled\fP
ساخت Kea به همراه کدی که امکان ذخیرهٔ اجاره‌ها (leases) و رزروهای میزبان (host reservations) را در یک پایگاه‌دادهٔ MySQL فراهم می‌کند.
.IP \(bu 2
\fB\-D postgresql=enabled\fP
ساخت Kea به همراه کدی که امکان ذخیرهٔ اجاره‌ها و رزروهای میزبان را در یک پایگاه‌دادهٔ PostgreSQL فراهم می‌کند.
.IP \(bu 2
\fB\-D krb5=enabled\fP
ساخت Kea با پشتیبانی از Kerberos5 به همراه GSS\-API که توسط \fBlibddns_gss_tsig.so\fP \%<#\:std-ischooklib-libddns_gss_tsig\:.so>\& الزامی است.
.IP \(bu 2
\fB\-D netconf=enabled\fP
ساخت Kea با پشتیبانی از libyang و sysrepo که توسط \fBkea\-netconf\fP \%<#\:std-iscman-kea-netconf>\& الزامی است.
.IP \(bu 2
\fB\-D crypto=botan\fP
استفاده از کتابخانهٔ رمزنگاری Botan به جای OpenSSL. ابزار Meson کتابخانه‌های pkg\-config مربوط به \(aqbotan\-3\(aq و \(aqbotan\(aq را جستجو می‌کند.
.IP \(bu 2
\fB\-\-D crypto=openssl\fP
استفاده از کتابخانهٔ رمزنگاری OpenSSL. به‌طور پیش‌فرض مقدار گزینهٔ \(aqcrypto\(aq برابر با \(aqopenssl\(aq است.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
برای دستورالعمل‌های مربوط به نصب و پیکربندی بک‌اند‌های پایگاه‌داده برای Kea، بخش DHCP Database Installation and Configuration را ببینید\&.
.UNINDENT
.UNINDENT
.sp
اگر اجرای \fBmeson setup build\fP ناموفق بود، ممکن است به دلیل وابستگی‌های مفقود یا قدیمی باشد.
.sp
هنگامی که \fBmeson setup build\fP با موفقیت انجام شود، گزارشی از پارامترهای استفاده‌شده برای ساخت کد را نمایش می‌دهد. این گزارش در فایل \fBbuild/config.report\fP ذخیره شده و همچنین در باینری‌های اجرایی تعبیه می‌شود؛ مانند \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6>\&..SS ساخت
.sp
پس از تکمیل مرحلهٔ برپایی (setup)، با اجرای فرمان زیر فایل‌های اجرایی را از کد C++ ساخته و اسکریپت‌های Python را آماده کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ meson compile \-C build
.EE
.UNINDENT
.UNINDENT
.SS نصب
.sp
برای نصب فایل‌های اجرایی، فایل‌های پشتیبان، و مستندات Kea، فرمان زیر را صادر کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ meson install \-C build
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
مرحلهٔ نصب ممکن است به دسترسی‌های مدیر سیستم (superuser) نیاز داشته باشد.
.UNINDENT
.UNINDENT
.sp
این کار نباید لازم باشد، اما اگر کتابخانه‌های اشتراکی در زمان اجرا پیدا نشدند، می‌توانید \fBldconfig\fP را با دسترسی ریشه (root) و قرار دادن \fB/usr/local/lib\fP (یا با \fB${prefix}/lib\fP اگر با \fB\-\-prefix\fP برپا شده باشد) در \fB/etc/ld.so.conf\fP (یا فایل پیکربندی مربوط به کش پیونددهنده در سیستم‌عامل) اجرا کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ ldconfig
.EE
.UNINDENT
.UNINDENT
.sp
اگر \fBldconfig\fP در جایی که لازم است اجرا نشود، کاربران ممکن است با خطاهایی مانند زیر مواجه شوند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
program: error while loading shared libraries: libkea\-something.so.1:
cannot open shared object file: No such file or directory
.EE
.UNINDENT
.UNINDENT
.SS نصب و پیکربندی پایگاه‌داده DHCP
.sp
Kea اطلاعات اجاره‌های خود (leases) را در یک پایگاه‌دادهٔ اجاره ذخیره می‌کند. این نرم‌افزار به گونه‌ای نوشته شده است که امکان انتخاب محصول پایگاه‌داده برای ذخیرهٔ اطلاعات اجاره را فراهم می‌سازد. Kea از سه backend پایگاه‌داده پشتیبانی می‌کند: MySQL، PostgreSQL، و memfile. برای محدود کردن وابستگی‌های خارجی، پشتیبانی از MySQL و PostgreSQL به‌طور پیش‌فرض غیرفعال است و تنها memfile در دسترس می‌باشد. پشتیبانی از backend اختیاری پایگاه‌دادهٔ خارجی باید هنگام ساخت Kea به‌صراحت گنجانده شود.
این بخش نحوهٔ ساخت Kea به همراه یکی از backendهای اختیاری و ایجاد پایگاه‌دادهٔ اجاره را پوشش می‌دهد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
هنگامی که آزمون‌های واحد (unit tests) به همراه Kea ساخته می‌شوند (یعنی گزینهٔ پیکربندی \fB\-D tests=enabled\fP مشخص شده باشد)، پایگاه‌های داده برای اجرای آزمون‌های واحد باید به‌صورت دستی از پیش پیکربندی شوند. جزئیات این پیکربندی را می‌توان در Kea Developer\(aqs Guide
\%<https://\:reports\:.kea\:.isc\:.org/\:dev_guide>\&
یافت.
.UNINDENT
.UNINDENT
.SS ساخت با پشتیبانی از MySQL
.sp
MySQL را بر اساس دستورالعمل‌های سیستم خود نصب کنید. کتابخانه‌های توسعهٔ کلاینت (client development libraries) باید نصب شده باشند.
.sp
Kea را طبق آنچه در بخش Installation شرح داده شده است بسازید و نصب کنید، با این تغییر که: برای فعال‌سازی کد پایگاه‌دادهٔ MySQL، در مرحلهٔ برپایی (نگاه کنید به Set Up the Build)، سوییچ \fB\-D mysql=enabled\fP باید مشخص شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ meson setup build \-D mysql=enabled
.EE
.UNINDENT
.UNINDENT
.sp
اگر MySQL در مکان پیش‌فرض نصب نشده باشد، می‌توان این مکان را با مقداردهی \fBPKG_CONFIG_PATH=/path/to/mariadb.pc:${PKG_CONFIG_PATH}\fP یا \fBPATH=/path/to/mariadb\-config:${PATH}\fP پیش از اجرای \fBmeson setup\fP مشخص کرد.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ PKG_CONFIG_PATH=/opt/mariadb/lib/pkgconfig PATH=/opt/mariadb/bin meson setup build \-D mysql=enabled
.EE
.UNINDENT
.UNINDENT
.sp
برای جزئیات مربوط به پیکربندی پایگاه‌دادهٔ MySQL، به First\-Time Creation of the MySQL Database \%<#\:mysql-database-create> مراجعه کنید.
.SS ساخت با پشتیبانی از PostgreSQL
.sp
PostgreSQL را بر اساس دستورالعمل‌های سیستم نصب کنید. کتابخانه‌های توسعهٔ کلاینت باید نصب شده باشند. کتابخانه‌های توسعهٔ کلاینت اغلب در بسته‌ای به نام \fBlibpq\fP عرضه می‌شوند.
.sp
Kea را همان‌طور که در بخش Installation شرح داده شده است بسازید و نصب کنید، با این تغییر که: برای فعال‌سازی کد پایگاه‌دادهٔ PostgreSQL، در مرحلهٔ برپایی (نگاه کنید به Set Up the Build)، سوییچ \fB\-D postgresql=enabled\fP باید مشخص شود.
.sp
اگر PostgreSQL در مکان پیش‌فرض نصب نشده باشد، می‌توان این مکان را با مقداردهی \fBPKG_CONFIG_PATH=/path/to/libpq.pc:${PKG_CONFIG_PATH}\fP یا \fBPATH=/path/to/pg_config:${PATH}\fP پیش از اجرای \fBmeson setup\fP تعیین کرد.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ PKG_CONFIG_PATH=/opt/postgresql/lib/pkgconfig PATH=/opt/postgresql/bin meson setup build \-D postgresql=enabled
.EE
.UNINDENT
.UNINDENT
.sp
برای جزئیات مربوط به پیکربندی پایگاه‌دادهٔ PostgreSQL، به First\-Time Creation of the PostgreSQL Database \%<#\:pgsql-database-create> مراجعه کنید..SS ابزار ساخت Hammer
.sp
برنامهٔ Hammer یک اسکریپت Python 3 است که به کاربران اجازه می‌دهد وظایف مربوط به ساخت
Kea را به‌طور خودکار انجام دهند، مانند راه‌اندازی ماشین‌های مجازی، نصب وابستگی‌های Kea،
کامپایل Kea با گزینه‌های گوناگون، اجرای unit\-testها و موارد دیگر. این
ابزار اساساً برای اهداف تضمین کیفیت (QA) داخلی در ISC ایجاد شده است و
در توزیع Kea گنجانده نشده است؛ با این حال، در مخزن git متعلق به Kea در
دسترس است. این ابزار اساساً برای اهداف داخلی توسعه یافته است
و ISC نمی‌تواند عملکرد صحیح آن را تضمین کند. مدیران سیستمی که تصمیم به استفاده از آن می‌گیرند
باید این کار را با احتیاط انجام دهند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
استفاده از این ابزار کاملاً اختیاری است. هر کاری که این ابزار انجام می‌دهد را می‌توان
به‌صورت دستی انجام داد.
.UNINDENT
.UNINDENT
.sp
به کاربری که برای نخستین بار از آن استفاده می‌کند اکیداً توصیه می‌شود به راهنمای توکار
Hammer نگاهی بیندازد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ ./hammer.py \-\-help
.EE
.UNINDENT
.UNINDENT
.sp
این دستور پارامترهای موجود را فهرست خواهد کرد.
.sp
ابزار Hammer قادر است سیستم‌عامل‌های گوناگونی را که در LXC یا
VirtualBox اجرا می‌شوند راه‌اندازی کند. برای مشاهدهٔ فهرستی از سیستم‌های پشتیبانی‌شده، از
دستور \fBsupported\-systems\fP استفاده کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ ./hammer.py supported\-systems
fedora:
  \- 37: lxc
  \- 38:
centos:
  \- 8: lxc, virtualbox
  \- 9:
rhel:
  \- 8: virtualbox
  \- 9:
ubuntu:
  \- 18.04: lxc, virtualbox
  \- 20.04: lxc
  \- 22.04: lxc
debian:
  \- 10: lxc, virtualbox
  \- 11: lxc
  \- 12: lxc
freebsd:
  \- 12.0: virtualbox
  \- 12.1:
  \- 13.0: virtualbox
alpine:
  \- 3.15: lxc
  \- 3.16: lxc
  \- 3.17: lxc
.EE
.UNINDENT
.UNINDENT
.sp
همچنین امکان اجرای ساخت به‌صورت محلی، در سیستم جاری وجود دارد (اگر سیستم‌عامل
پشتیبانی شود).
.sp
نخست، باید وابستگی‌های Hammer نصب شوند: Vagrant
و یکی از دو برنامهٔ VirtualBox یا LXC. برنامهٔ Hammer می‌تواند
Vagrant و افزونه‌های مورد نیاز Vagrant را با استفاده از دستور زیر نصب کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ ./hammer.py ensure\-hammer\-deps
.EE
.UNINDENT
.UNINDENT
.sp
برنامه‌های VirtualBox و LXC باید به‌صورت دستی نصب شوند.
.sp
کارکردهای پایه‌ای ارائه‌شده توسط Hammer عبارتند از آماده‌سازی محیط ساخت
و انجام فرآیند واقعی ساخت، و اجرای unit testها به‌صورت محلی در سیستم
جاری. این کار را می‌توان با اجرای دستور زیر انجام داد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ ./hammer.py build \-p local
.EE
.UNINDENT
.UNINDENT
.sp
دامنهٔ فرآیند را می‌توان با استفاده از گزینه‌های \fB\-\-with\fP (\fB\-w\fP) و \fB\-\-without\fP
(\fB\-x\fP) تعیین کرد. به‌طور پیش‌فرض، دستور \fBbuild\fP برنامهٔ Kea را به همراه
مستندات می‌سازد، آن را به‌صورت محلی نصب می‌کند، و unit testها را اجرا می‌نماید.
.sp
برای مستثنی کردن نصب و تولید مستندات، وارد کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ ./hammer.py build \-p local \-x install docs
.EE
.UNINDENT
.UNINDENT
.sp
دامنهٔ پایه را می‌توان با mysql، pgsql، native\-pkg، shell و forge گسترش داد.
لطفاً برای جزئیات بیشتر به \fB\&./hammer.py build \-\-help\fP مراجعه کنید.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
در صورت ساخت محلی Kea، به وابستگی‌های Hammer مانند Vagrant
نیازی نیست.
.UNINDENT
.UNINDENT
.sp
می‌توان به Hammer فرمان داد تا یک ماشین مجازی جدید با یک سیستم‌عامل
مشخص‌شده را بدون انجام ساخت راه‌اندازی کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ ./hammer.py prepare\-system \-p virtualbox \-s freebsd \-r 12.0
.EE
.UNINDENT
.UNINDENT
.sp
به این ترتیب، می‌توان سیستمی را برای استفادهٔ خود آماده کرد.
.sp
برای آماده‌سازی چنین سیستمی با استفاده از SSH، دستور زیر را اجرا کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ ./hammer.py ssh \-p virtualbox \-s freebsd \-r 12.0
.EE
.UNINDENT
.UNINDENT
.sp
می‌توان سرعت ساخت‌های بعدی Hammer را از طریق
ccache \%<https://\:ccache\:.samba\:.org>\& افزایش داد. در حین
کامپایل، ccache اشیاء را در یک پوشهٔ اشتراکی ذخیره می‌کند. در اجراهای بعدی،
ccache به‌جای انجام یک کامپایل واقعی، اشیاء ذخیره‌شدهٔ پیشین را
بازمی‌گرداند. حافظهٔ کش محتوی این اشیاء جهت استفادهٔ مجدد باید در خارج از VM
یا LXC ذخیره شود. برای مشخص کردن این پوشه، پارامتر \fB\-\-ccache\-dir\fP
باید برای Hammer درج شود. در پوشهٔ تعیین‌شده، برای هر سیستم‌عامل
مقصد اشیاء ذخیره‌شدهٔ جداگانه‌ای وجود دارد.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ ./hammer.py build \-p lxc \-s ubuntu \-r 18.04 \-\-ccache\-dir ~/kea\-ccache
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
در حال حاضر ccache در Hammer فقط برای LXC پشتیبانی می‌شود؛ پشتیبانی
از VirtualBox ممکن است بعداً افزوده شود.
.UNINDENT
.UNINDENT
.sp
برای اطلاعات بیشتر بررسی کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ ./hammer.py \-\-help
.EE
.UNINDENT
.UNINDENT.SS اجرای Kea از حساب کاربری غیرریشه (Non\-root) در لینوکس
.sp
هر دو کارساز DHCPv4 و DHCPv6 در Kea عملیاتی را انجام می‌دهند که به‌طور کلی نیازمند دسترسی‌ها و امتیازات کاربر ریشه (root) است. به‌ویژه، DHCPv4 سوکت‌های raw را باز می‌کند و هر دو کارساز DHCPv4 و DHCPv6 سوکت‌های UDP را روی درگاه‌های ممتاز (privileged) باز می‌کنند. با این حال، با انجام برخی پیکربندی‌های سیستمی اضافی، امکان اجرای Kea از حساب‌های کاربری غیرریشه وجود دارد.
.sp
ابتدا، باید یک حساب کاربری عادی ایجاد شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
useradd admin
.EE
.UNINDENT
.UNINDENT
.sp
سپس، مالکیت و گروه فایل‌های اجرایی (binaries) را به کاربر جدید تغییر دهید. توجه داشته باشید که مسیر دقیق ممکن است متفاوت باشد. لطفاً به پارامتر \fB\-\-prefix\fP که به \fBmeson setup\fP داده شده است مراجعه کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
chown \-R admin /opt/kea
chgrp \-R admin /opt/kea
chown \-R admin /var/log/kea/kea\-dhcp4.log
chgrp \-R admin /var/log/kea/kea\-dhcp4.log
chown \-R admin /var/log/kea/kea\-dhcp6.log
chgrp \-R admin /var/log/kea/kea\-dhcp6.log
.EE
.UNINDENT
.UNINDENT
.sp
در صورت استفاده از systemd، فایل سرویس آن را ویرایش کنید
(برای نمونه /etc/systemd/system/kea\-dhcp6.service):
.INDENT 0.0
.INDENT 3.5
.sp
.EX
User=admin
Group=admin
.EE
.UNINDENT
.UNINDENT
.sp
مهم‌ترین مرحله، تنظیم قابلیت‌های (capabilities) فایل‌های باینری است. برای اطلاعات بیشتر به صفحهٔ راهنمای سیستم‌عامل برای \fIcapabilities\fP مراجعه کنید.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
setcap \(aqcap_net_bind_service,cap_net_raw=+ep\(aq /opt/kea/sbin/kea\-dhcp4
setcap \(aqcap_net_bind_service=+ep\(aq /opt/kea/sbin/kea\-dhcp6
.EE
.UNINDENT
.UNINDENT
.sp
در صورت استفاده از systemd، این مقدار را نیز به فایل سرویس اضافه کنید
(برای نمونه /etc/systemd/system/kea\-dhcp6.service):
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ExecStartPre=setcap \(aqcap_net_bind_service=+ep\(aq /opt/kea/sbin/kea\-dhcp6
.EE
.UNINDENT
.UNINDENT
.sp
پس از تکمیل این مرحله، کاربر admin باید قادر به اجرای Kea باشد. توجه داشته باشید که کارساز DHCPv4 به‌طور پیش‌فرض سوکت‌های raw را باز می‌کند. اگر شبکه فقط از ترافیک بازپخش‌شده (relayed) استفاده می‌کند، می‌توان Kea را طوری تنظیم کرد که از سوکت‌های معمولی UDP استفاده کند (به پارامتر \fBdhcp\-socket\-type\fP در بخش پیکربندی رابط \%<#\:dhcp4-interface-configuration> مراجعه کنید) و در نتیجه می‌توان از قابلیت \fBcap_net_raw\fP صرف‌نظر کرد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
امکان جلوگیری از اجرای Kea با امتیازات ریشه با هدایت Kea به استفاده از درگاه‌های غیرممتاز (بزرگ‌تر از 1024) و بازهدایت (redirecting) ترافیک وجود دارد. با این حال، این روش فقط برای ترافیک رله‌شده کار می‌کند. این رویکرد به‌طور کلی آزمایشی در نظر گرفته می‌شود و برای به‌کارگیری در محیط‌های عملیاتی آزمایش نشده است. با احتیاط استفاده کنید!
.sp
برای استفاده از این روش، کارساز را طوری پیکربندی کنید که با اجرای فرایند به همراه گزینهٔ \fB\-p\fP در \fB/etc/systemd/system/kea\-dhcp4.service\fP روی دیگر درگاه‌های غیرممتاز (مانند 1547 و 1548) شنود کند:
.UNINDENT
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ExecStart=/opt/kea/sbin/kea\-dhcp4 \-d \-c /etc/kea/kea\-dhcp4.conf \-p 2067
.EE
.UNINDENT
.UNINDENT
.sp
و در \fB/etc/systemd/system/kea\-dhcp4.service\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ExecStart=/opt/kea/sbin/kea\-dhcp6 \-d \-c /etc/kea/kea\-dhcp6.conf \-p 1547
.EE
.UNINDENT
.UNINDENT
.sp
سپس بازهدایت درگاه را با iptables و ip6tables برای درگاه‌های جدید (مانند 1547 و 1548) پیکربندی کنید. حتماً \fBens4\fP را با نام رابط شبکهٔ موردنظر جایگزین کنید.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
iptables \-t nat \-A PREROUTING \-i ens4 \-p udp \-\-dport 67 \-j REDIRECT \-\-to\-port 2067
iptables \-t nat \-A PREROUTING \-i ens4 \-p udp \-\-dport 2068 \-j REDIRECT \-\-to\-port 68
ip6tables \-t nat \-A PREROUTING \-i ens4 \-p udp \-\-dport 547 \-j REDIRECT \-\-to\-port 1547
ip6tables \-t nat \-A PREROUTING \-i ens4 \-p udp \-\-dport 1548 \-j REDIRECT \-\-to\-port 548
.EE
.UNINDENT
.UNINDENT
.SS ویژگی‌های منسوخ‌شده (Deprecated Features)
.sp
این بخش ویژگی‌های مهمی را که حذف شده‌اند یا قرار است حذف شوند فهرست می‌کند. ما تلاش می‌کنیم پیش از حذف ویژگی‌ها، آن‌ها را منسوخ اعلام کنیم تا کاربران فعلی فرصت برنامه‌ریزی برای مهاجرت را داشته باشند. کاربران جدید نباید به ویژگی‌های منسوخ‌شده تکیه کنند..SS Sysrepo 0.x یا 1.x
.sp
در نسخه 2.3.2 از Kea پشتیبانی از Sysrepo 2.x معرفی شد. متأسفانه
Sysrepo همچنان دستخوش تغییرات اساسی ناسازگار با نسخه‌های پیشین (backward\-incompatible) است،
و نسخه‌های کنونی Kea از نگارش‌های پیش از 2.x در Sysrepo پشتیبانی نمی‌کنند.
.SH "مدیریت پایگاه داده KEA (KEA DATABASE ADMINISTRATION)"
.SS پایگاه‌های داده و نسخه‌های اسکیما (Databases and Schema Versions)
.sp
می‌توان Kea را به گونه‌ای پیکربندی کرد که از یک پایگاه داده به عنوان محل ذخیره‌سازی اجاره‌ها (leases) یا به
عنوان منبعی برای پیکربندی سرورها و رزروهای میزبان (یعنی تخصیص ایستا برای
نشانی‌ها، پیشوندها، گزینه‌ها و غیره) استفاده نماید. با به‌روزرسانی Kea،
اسکیماهای (schemas) جدیدی برای پایگاه داده معرفی می‌شوند تا پیاده‌سازی قابلیت‌های جدید
تسهیل شده و اشکالات کشف‌شده در اسکیماهای پیشین برطرف گردند.
.sp
هر نسخه از Kea ساختار اسکیمای مشخصی را انتظار دارد و با بررسی نسخه پایگاه داده‌ای که
استفاده می‌کند، این مورد را ارزیابی می‌نماید. شماره نسخه‌های مجزایی برای اسکیماها مستقل از
نسخه خودِ Kea نگهداری می‌شوند. این امکان وجود دارد که نسخه اسکیما در طول چندین بازنگری
Kea ثابت بماند؛ به همین ترتیب این احتمال وجود دارد که نسخه اسکیما در جریان یک ارتقای تکی
نسخه Kea، چندین نگارش افزایش یابد. نسخه‌ها برای هر نوع بک‌اند (backend) نیز مستقل هستند،
بنابراین افزایش نسخه در بک‌اند MySQL به معنای افزایش در نسخه PostgreSQL نخواهد بود.
.sp
نسخه‌های اسکیما در قالب major.minor مشخص می‌شوند. در جدیدترین نسخه‌ها، نسخه
minor همیشه صفر بوده و تنها نسخه major افزایش می‌یابد.
.sp
از نظر تاریخی، نسخه minor زمانی افزایش می‌یافت که تغییرات سازگار با گذشته (backward\-compatible)
در اسکیما اعمال می‌شد؛ برای نمونه، هنگامی که یک نمایه (index) جدید افزوده می‌شد. این امر در
مقابل افزایش نسخه major بود که تغییر ناسازگار در اسکیما را نشان می‌داد؛ برای نمونه تغییر نوع
یک ستون موجود. اگر Kea تلاش کند روی اسکیمایی اجرا شود که بیش از حد قدیمی است (همان‌طور که
از عدم تطابق نسخه اسکیما مشخص می‌شود)، ناموفق خواهد بود؛ در این حالت برای ارتقای اسکیما به اقدام مدیریتی نیاز است.
.SS ابزار \fBkea\-admin\fP \%<#\:std-iscman-kea-admin>
.sp
برای مدیریت پایگاه‌های داده، Kea ابزار \fBkea\-admin\fP \%<#\:std-iscman-kea-admin> را ارائه می‌دهد. این ابزار
می‌تواند یک بک‌اند جدید را مقداردهی اولیه کند، شماره نسخه آن را بررسی نماید، ارتقای بک‌اند را
انجام دهد، و داده‌های اجاره (lease) را در یک فایل متنی ذخیره (dump) کند.
.sp
دستور \fBkea\-admin\fP \%<#\:std-iscman-kea-admin> دو پارامتر اجباری دریافت می‌کند: \fBcommand\fP و
\fBbackend\fP\&. گزینه‌های غیراجباری دیگری نیز ممکن است مشخص شوند.
دستورهای پشتیبانی‌شده کنونی عبارتند از:
.INDENT 0.0
.IP \(bu 2
\fBdb\-init\fP — یک اسکیمای جدید پایگاه داده را مقداردهی اولیه می‌کند که هنگام
نصب تازه Kea سودمند است. پایگاه داده جدید مطابق با نسخه Kea در حال نصب به‌روزرسانی
می‌شود. در صورتی که حین راه‌اندازی یا پیکربندی مجدد سرورهای Kea DHCP عدم وجود اسکیما
تشخیص داده شود، \fBkea\-admin\fP \%<#\:std-iscman-kea-admin> به طور خودکار با این دستور فراخوانی می‌شود.
.IP \(bu 2
\fBdb\-version\fP — شماره نسخه بک‌اند پایگاه داده را گزارش می‌دهد. این
مقدار لزوماً با شماره نسخه Kea یکسان نیست، چرا که هر بک‌اند
طرح نسخه‌گذاری مختص به خود را دارد.
.IP \(bu 2
\fBdb\-upgrade\fP — یک ارتقای اسکیمای پایگاه داده را انجام می‌دهد. این
دستور هنگام ارتقای Kea کاربرد دارد.
.IP \(bu 2
\fBlease\-dump\fP — محتویات پایگاه داده اجاره را (برای بک‌اندهای MySQL یا
PostgreSQL) در یک فایل متنی CSV (مقادیر جداشده با کاما) استخراج می‌کند (dump).
.sp
خط نخست این فایل حاوی نام ستون‌ها است. این کار می‌تواند راهکاری برای تغییر
از یک بک‌اند پایگاه داده به یک بک‌اند memfile باشد. از سوی دیگر، می‌توان از آن به عنوان یک ابزار
عیب‌یابی استفاده کرد که قالب قابل حملی از داده‌های اجاره را فراهم می‌سازد.
.IP \(bu 2
\fBlease\-upload\fP — اجاره‌ها را از یک فایل متنی CSV (مقادیر جداشده با کاما)
به یک پایگاه داده اجاره MySQL یا PostgreSQL بارگذاری می‌کند. فایل CSV باید در
قالب memfile باشد.
.UNINDENT
.sp
پارامتر \fBbackend\fP نوع پایگاه داده بک‌اند را مشخص می‌کند. انواع
پشتیبانی‌شده کنونی عبارتند از:
.INDENT 0.0
.IP \(bu 2
\fBmemfile\fP — اطلاعات اجاره بر روی دیسک در یک فایل متنی ذخیره می‌شود.
.IP \(bu 2
\fBmysql\fP — اطلاعات در یک پایگاه داده رابطه‌ای MySQL ذخیره می‌شود.
.IP \(bu 2
\fBpgsql\fP — اطلاعات در یک پایگاه داده رابطه‌ای PostgreSQL
ذخیره می‌شود.
.UNINDENT
.sp
بسته به راه‌اندازی و عملیات مورد نظر، ممکن است به پارامترهای بیشتری نیاز باشد:
نام کاربری (username)، گذرواژه (password)، و نام پایگاه داده یا دایرکتوری محل قرارگیری
فایل‌های مشخص. برای جزئیات به صفحه راهنمای مربوطه مراجعه کنید (\fBman 8 kea\-admin\fP).
.SS بک‌اندهای پشتیبانی‌شده (Supported Backends)
.sp
جدول زیر قابلیت‌های بک‌اندهای موجود را نشان می‌دهد.
لطفاً برای درک بهتر توانایی‌ها و محدودیت‌ها به بخش‌های اختصاصی هر بک‌اند
مراجعه کنید. انتخاب بک‌اند مناسب برای موفقیت استقرار حیاتی است.
.SS فهرست بک‌اندهای موجود
.TS
box center;
l|l|l|l.
T{
ویژگی
T}	T{
Memfile
T}	T{
MySQL
T}	T{
PostgreSQL
T}
_
T{
وضعیت
T}	T{
پایدار
T}	T{
پایدار
T}	T{
پایدار
T}
_
T{
قالب داده
T}	T{
فایل CSV
T}	T{
SQL RMDB
T}	T{
SQL RMDB
T}
_
T{
اجاره‌ها
T}	T{
بله
T}	T{
بله
T}	T{
بله
T}
_
T{
رزروهای
میزبان
T}	T{
خیر
T}	T{
بله
T}	T{
بله
T}
_
T{
گزینه‌های
تعریف‌شده برای
هر میزبان
T}	T{
خیر
T}	T{
بله
T}	T{
بله
T}
_
T{
بک‌اند
پیکربندی
T}	T{
خیر
T}	T{
بله
T}	T{
بله
T}
.TE.SS Memfile
.sp
بک‌اند memfile قادر به ذخیره اطلاعات اجاره (lease) است، اما نمی‌تواند
جزئیات رزرو میزبان را ذخیره کند؛ این اطلاعات باید در فایل
پیکربندی ذخیره شوند. (هیچ برنامه‌ای برای افزودن قابلیت ذخیره‌سازی
رزروهای میزبان به این بک‌اند وجود ندارد.)
.sp
هیچ مرحله راه‌اندازی اولیه‌ی خاصی برای بک‌اند memfile لازم نیست.
در طول نخستین اجرا، هم \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> و هم \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> در
صورت عدم وجود فایل اجاره، یک فایل اجاره‌ی خالی ایجاد می‌کنند. داشتن
مجوز لازم برای نوشتن روی دیسک مورد نیاز است.
.SS "ارتقای فایل‌های اجاره Memfile از نسخه‌های پیشین Kea"
.sp
برای ارتقای فایل‌های اجاره memfile میان نسخه‌های Kea به هیچ
مرحله‌ی خاصی نیاز نیست. در زمان راه‌اندازی، کارسازها
نسخه شمای فایل‌های اجاره را با نسخه شمای خود بررسی و تطبیق می‌دهند.
اگر عدم تطابقی وجود داشته باشد، کارسازها به‌طور خودکار فرایند
LFC را اجرا می‌کنند تا فایل‌ها را به نسخه شمای کارساز تبدیل کند. در حالی که
هدف اصلی این سازوکار تسهیل فرایند ارتقا به نسخه‌های
جدیدتر Kea است، در صورت نیاز می‌تواند برای تنزیل نسخه (downgrade) نیز
به کار رود. هنگام ارتقا، به هر مقداری که در فایل‌های اجاره اولیه
موجود نباشد، مقادیر پیش‌فرض مناسب اختصاص می‌یابد. هنگام تنزیل، هر
داده‌ای که در فایل‌ها موجود باشد اما در شمای کارساز وجود نداشته باشد،
حذف می‌شود. برای تبدیل دستی فایل‌ها پیش از راه‌اندازی
کارسازها، فرایند پاک‌سازی فایل اجاره (LFC) را اجرا کنید. برای اطلاعات بیشتر بخش «فرایند LFC» \%<#\:kea-lfc> را ببینید.
.SS MySQL
.sp
پایگاه داده MySQL قادر است اجاره‌ها، رزروهای میزبان، گزینه‌های تعریف‌شده به‌ازای
هر میزبان، و زیرمجموعه‌ای از پارامترهای پیکربندی کارساز را ذخیره کند
(و به‌عنوان بک‌اند پیکربندی عمل نماید).
.SS "مقایسه MySQL 5.7 با MySQL 8 و MariaDB 10 و 11"
.sp
در آزمایش‌های کارایی Kea، نسخه MySQL 8 افتی ۶۰ تا ۹۰ درصدی در سرعت
در مقایسه با MySQL 5.7 نشان می‌دهد.
با توجه به پایان عمر (EOL) قریب‌الوقوع MySQL 5.7، توصیه می‌کنیم به جای MySQL 8 از MariaDB استفاده کنید.
.sp
نسخه‌های MySQL 5.7، MySQL 8، MariaDB 10، و MariaDB 11 کاملاً سازگار،
قابل جایگزینی با یکدیگر، و همراه با Kea آزمایش شده‌اند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
نگارش MySQL یا MariaDB مورد استفاده شما باید از پردازش JSON پشتیبانی کند. مواردی که در بالا
فهرست شده‌اند یا جدیدتر باید پشتیبانی کنند. این موضوع را می‌توان با دستور SQL زیر بررسی کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
mysql> SELECT JSON_EXTRACT(\(aq{ \(dqfoo\-bar\(dq: 1 }\(aq, \(aq$.\(dqfoo\-bar\(dq\(aq);
+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
| JSON_EXTRACT(\(aq{ \(dqfoo\-bar\(dq: 1 }\(aq, \(aq$.\(dqfoo\-bar\(dq\(aq) |
+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
| 1                                               |
+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
1 row in set (0.01 sec)
.EE
.UNINDENT
.UNINDENT
.sp
هر نتیجه‌ی دیگری نشان می‌دهد که از JSON پشتیبانی نمی‌شود.
.UNINDENT
.UNINDENT
.SS "ایجاد پایگاه داده MySQL برای نخستین بار"
.sp
پیش از آماده‌سازی هر پایگاه داده و جدول‌های ویژه Kea، پایگاه داده MySQL
باید طوری پیکربندی شود که از منطقه زمانی سیستم استفاده کند. توصیه می‌شود هم
برای سیستم و هم برای پایگاه داده MySQL از UTC به‌عنوان منطقه زمانی استفاده شود.
.sp
برای بررسی منطقه زمانی سیستم:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.INDENT 3.5
.sp
.EX
date +%Z
.EE
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
برای بررسی منطقه زمانی MySQL:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.INDENT 3.5
.sp
.EX
mysql> SELECT @@system_time_zone;
mysql> SELECT @@global.time_zone;
mysql> SELECT @@session.time_zone;
.EE
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
برای پیکربندی منطقه زمانی MySQL برای یک کارساز خاص، لطفاً به
مستندات نسخه نصب‌شده مراجعه کنید.
.sp
معمولاً این تنظیم در بخش [mysqld] در فایل‌های \fB/etc/mysql/my.cnf\fP،
\fB/etc/mysql/mysql.cnf\fP، \fB/etc/mysql/mysqld.cnf\fP، یا
\fB/etc/mysql/mysql.conf.d/mysqld.cnf\fP پیکربندی می‌شود\&.
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[mysqld]
# using default\-time\-zone
default\-time\-zone=\(aq+00:00\(aq

# or using timezone
timezone=\(aqUTC\(aq
.EE
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
هنگام راه‌اندازی پایگاه داده MySQL برای نخستین بار، فضای
پایگاه داده باید در MySQL ایجاد شده و شناسه کاربری MySQL که Kea از طریق
آن به پایگاه داده دسترسی خواهد داشت تنظیم شود. این کار باید به‌صورت دستی انجام شود،
نه از طریق \fBkea\-admin\fP \%<#\:std-iscman-kea-admin>\&.
.sp
برای ساخت پایگاه داده:
.INDENT 0.0
.IP 1. 3
با کاربر \(dqroot\(dq وارد MySQL شوید:
.INDENT 3.0
.INDENT 3.5
.sp
.EX
$ mysql \-u root \-p
Enter password:
mysql>
.EE
.UNINDENT
.UNINDENT
.IP 2. 3
پایگاه داده MySQL را ایجاد کنید:
.INDENT 3.0
.INDENT 3.5
.sp
.EX
mysql> CREATE DATABASE database_name;
.EE
.UNINDENT
.UNINDENT
.sp
(\fBdatabase_name\fP نام انتخاب‌شده برای پایگاه داده است.)
.IP 3. 3
کاربری را که Kea از طریق آن به پایگاه داده دسترسی خواهد داشت ایجاد کنید (و به
آن گذرواژه بدهید)، سپس دسترسی به جدول‌های پایگاه داده را به آن اعطا کنید:
.INDENT 3.0
.INDENT 3.5
.sp
.EX
mysql> CREATE USER \(aquser\-name\(aq@\(aqlocalhost\(aq IDENTIFIED BY \(aq1234\(aq;
mysql> GRANT ALL ON database\-name.* TO \(aquser\-name\(aq@\(aqlocalhost\(aq;
.EE
.UNINDENT
.UNINDENT
.sp
(\fBuser\-name\fP و \fBpassword\fP شناسه کاربری و گذرواژه‌ای هستند که برای
دسترسی دادن به Kea به نمونه MySQL استفاده می‌شوند. تمام علامت‌های آپوستروف در
خطوط فرمان بالا الزامی هستند.)
.IP 4. 3
پایگاه داده را بسازید.
.INDENT 3.0
.INDENT 3.5
از کلاینت MySQL خارج شوید
.INDENT 0.0
.INDENT 3.5
.sp
.EX
mysql> quit
Bye
.EE
.UNINDENT
.UNINDENT
.sp
سپس از ابزار \fBkea\-admin\fP \%<#\:std-iscman-kea-admin> برای ایجاد پایگاه داده استفاده کنید.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ kea\-admin db\-init mysql \-u database\-user \-p database\-password \-n database\-name
.EE
.UNINDENT
.UNINDENT
.sp
اگرچه امکان ساخت پایگاه داده از داخل کلاینت MySQL وجود دارد، توصیه می‌کنیم
از ابزار \fBkea\-admin\fP \%<#\:std-iscman-kea-admin> استفاده کنید؛ چرا که این ابزار برخی اعتبارسنجی‌های لازم را انجام می‌دهد تا اطمینان حاصل شود Kea می‌تواند
در زمان اجرا به پایگاه داده دسترسی داشته باشد. از جمله این بررسی‌ها، اطمینان از این است که شما فاقد
هرگونه جدول از پیش موجود باشد؛ هر جدول از پیش موجود باید به‌صورت
دستی حذف شود. یک بررسی دیگر، توانایی کاربر در ساخت توابع و
تریگرها را ارزیابی می‌کند. خطای زیر نشان می‌دهد که کاربر مجوزهای لازم
برای ایجاد توابع یا تریگرها را ندارد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ERROR 1419 (HY000) at line 1: You do not have the SUPER privilege and binary logging is
enabled (you *might* want to use the less safe log_bin_trust_function_creators variable)
ERROR/kea\-admin: mysql_can_create cannot trigger, check user permissions, mysql status = 1
mysql: [Warning] Using a password on the command line interface can be insecure.
ERROR/kea\-admin: Create failed, the user, keatest, has insufficient privileges.
.EE
.UNINDENT
.UNINDENT
.sp
ساده‌ترین راهکار برای حل این مشکل، تنظیم متغیر سراسری MySQL یعنی
\fBlog_bin_trust_function_creators\fP روی 1 از طریق کلاینت MySQL است.
توجه داشته باشید که این کار باید توسط کاربری با امتیازات SUPER انجام شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
mysql> set @@global.log_bin_trust_function_creators = 1;
Query OK, 0 rows affected (0.00 sec)
.EE
.UNINDENT
.UNINDENT
.sp
برای ایجاد مستقیم پایگاه داده با MySQL، مراحل زیر را دنبال کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
mysql> CONNECT database\-name;
mysql> SOURCE path\-to\-kea/share/kea/scripts/mysql/dhcpdb_create.mysql
.EE
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
(که در آن \fBpath\-to\-kea\fP مکانی است که Kea در آن نصب شده است.)
.INDENT 3.0
.INDENT 3.5
همچنین می‌توان پایگاه داده را به‌صورت دستی به شکل زیر حذف (drop) کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
mysql> CONNECT database\-name;
mysql> SOURCE path\-to\-kea/share/kea/scripts/mysql/dhcpdb_drop.mysql
.EE
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
(که در آن \fBpath\-to\-kea\fP مکانی است که Kea در آن نصب شده است.)
.UNINDENT
.sp
\fBهشدار:\fP
.INDENT 0.0
.INDENT 3.5
حذف پایگاه داده منجر به از دست رفتن غیرقابل بازیابی تمامی داده‌های موجود در آن می‌شود.
.UNINDENT
.UNINDENT
.INDENT 0.0.IP 5. 3
خروج از MySQL:
.INDENT 3.0
.INDENT 3.5
.sp
.EX
mysql> quit
Bye
.EE
.UNINDENT
.UNINDENT
.UNINDENT
.sp
اگر جدول‌ها در مرحله 4 ساخته نشده‌اند، اکنون ابزار \fBkea\-admin\fP \%<#\:std-iscman-kea-admin> را
برای ایجاد آن‌ها اجرا کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ kea\-admin db\-init mysql \-u database\-user \-p database\-password \-n database\-name
.EE
.UNINDENT
.UNINDENT
.sp
اگر جدول‌ها در مرحله 4 ساخته شده‌اند، این کار را انجام ندهید. ابزار \fBkea\-admin\fP \%<#\:std-iscman-kea-admin>
بررسی‌های اولیه‌ای انجام می‌دهد؛ اگر پایگاه داده حاوی هرگونه جدول موجود باشد، از مقداردهی
اولیه آن خودداری خواهد کرد. برای شروع از ابتدا،
همه داده‌ها باید به‌صورت دستی حذف شوند. (این فرآیند عمداً
یک عملیات دستی است تا از خطاهای تصادفی و جبران‌ناپذیر توسط \fBkea\-admin\fP \%<#\:std-iscman-kea-admin>\& جلوگیری شود.)
.SS ارتقای پایگاه داده MySQL از نسخه پیشین Kea
.sp
گاهی یک نسخه جدید Kea از شمای پایگاه داده جدیدتری استفاده می‌کند، بنابراین
پایگاه داده موجود باید ارتقا یابد. این کار را می‌توان با استفاده از
دستور \fBkea\-admin db\-upgrade\fP انجام داد.
.sp
برای بررسی نسخه فعلی پایگاه داده، از دستور زیر استفاده کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ kea\-admin db\-version mysql \-u database\-user \-p database\-password \-n database\-name
.EE
.UNINDENT
.UNINDENT
.sp
(برای بحث درباره نسخه‌بندی، بخش Databases and Schema Versions
را ببینید.) اگر نسخه با حداقل مقدار لازم برای نسخه جدید Kea
(همان‌طور که در یادداشت‌های انتشار آمده است) مطابقت ندارد، پایگاه داده باید ارتقا یابد.
.sp
پیش از ارتقا، لطفاً اطمینان حاصل کنید که از پایگاه داده نسخه پشتیبان تهیه شده است. فرآیند
ارتقا هیچ داده‌ای را حذف نمی‌کند، اما بسته به ماهیت تغییرات، ممکن است
پس از آن امکان بازگشت (downgrade) به نسخه پیشین وجود نداشته باشد.
.sp
برای انجام ارتقا، دستور زیر را اجرا کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ kea\-admin db\-upgrade mysql \-u database\-user \-p database\-password \-n database\-name
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
برای جستجوی رزروهای میزبان (host reservations) بر اساس hostname، بسیار حیاتی است که ترتیب تطبیق (collation)
ستون hostname در جدول host به بزرگی و کوچکی حروف حساس نباشد (case\-insensitive). خوشبختانه این
حالت پیش‌فرض در MySQL است، اما می‌توان با این دستور آن را تایید کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
mysql> SELECT COLLATION(\(aq\(aq);
+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
| COLLATION(\(aq\(aq)   |
+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
| utf8_general_ci |
+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
.EE
.UNINDENT
.UNINDENT
.sp
طبق قواعد نام‌گذاری MySQL، هنگامی که نام به \fB_ci\fP ختم می‌شود،
تطبیق (collation) به بزرگی و کوچکی حروف غیرحساس است.
.UNINDENT
.UNINDENT
.SS بهبود کارایی با MySQL
.sp
تغییر مقدار درونی MySQL یعنی \fBinnodb_flush_log_at_trx_commit\fP از مقدار پیش‌فرض
1 به 2 می‌تواند منجر به بهبود چشمگیری در کارایی Kea شود. در برخی از پیاده‌سازی‌ها، این
بهبود بیش از 1000% بوده است (هنگام تنظیم روی 2، در مقایسه با مقدار پیش‌فرض 1، ۱۰ برابر سریع‌تر شده است).
برای آزمایش، می‌توان آن را به‌ازای هر نشست (per\-session) تنظیم کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
mysql> SET GLOBAL innodb_flush_log_at_trx_commit=2;
mysql> SHOW SESSION VARIABLES LIKE \(aqinnodb_flush_log%\(aq;
.EE
.UNINDENT
.UNINDENT
.sp
یا به‌صورت دائمی در \fB/etc/mysql/my.cnf\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[mysqld]
innodb_flush_log_at_trx_commit=2
.EE
.UNINDENT
.UNINDENT
.sp
توجه داشته باشید که تغییر این مقدار ممکن است در طول بازیابی داده‌ها پس از فروپاشی (crash)
مشکلاتی ایجاد کند، بنابراین پیشنهاد می‌کنیم مستندات MySQL \%<https://\:dev\:.mysql\:.com/\:doc/\:refman/\:8\:.0/\:en/\:innodb-parameters\:.html#\:sysvar_innodb_flush_log_at_trx_commit>\& را بررسی کنید.
با مقدار پیش‌فرض 1، MySQL پس از هر پرس‌وجوی INSERT یا UPDATE تغییرات را روی دیسک می‌نویسد
(در اصطلاح Kea، هر بار که یک کلاینت یک اجاره جدید دریافت می‌کند یا اجاره موجود را تمدید می‌کند). هنگامی که
\fBinnodb_flush_log_at_trx_commit\fP روی 2 تنظیم شده باشد، MySQL تغییرات را در فواصل زمانی
حداکثر ۱ ثانیه می‌نویسد. دسته‌بندی عملیات‌های نوشتن، شتاب قابل‌توجهی به کارایی می‌دهد. با این حال،
موازنه این است که در بدترین سناریو، ممکن است تمام تغییرات در آخرین ثانیه قبل از فروپاشی
از دست بروند. با توجه به اینکه Kea نرم‌افزاری پایدار است و بسیار به‌ندرت دچار فروپاشی می‌شود،
بیشتر پیاده‌سازی‌ها این موازنه را سودمند می‌دانند..SS PostgreSQL
.sp
پایگاه داده‌ی PostgreSQL می‌تواند اجاره‌ها (leases)، رزروهای میزبان (host reservations) و گزینه‌های تعریف‌شده بر اساس هر میزبان (per\-host) را ذخیره کند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
نسخهٔ PostgreSQL مورد استفاده شما باید از پردازش JSON پشتیبانی کند. هر نسخه‌ای از 9.4 به بعد باید از آن پشتیبانی نماید. این موضوع را می‌توان با دستور SQL زیر بررسی کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
=> SELECT proname FROM pg_proc WHERE proname = \(aqjson_extract_path\(aq;
    proname
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
json_extract_path
(1 row)
.EE
.UNINDENT
.UNINDENT
.sp
هر نتیجهٔ دیگری نشان‌دهندهٔ عدم پشتیبانی از JSON است.
.UNINDENT
.UNINDENT
.SS ساخت اولیه پایگاه داده PostgreSQL
.sp
پیش از آماده‌سازی هرگونه پایگاه داده و جدول‌های ویژهٔ Kea، پایگاه دادهٔ PostgreSQL باید طوری پیکربندی شود که از منطقه زمانی (timezone) سیستم استفاده کند. توصیه می‌شود برای منطقه زمانی سیستم و پایگاه دادهٔ PostgreSQL از UTC استفاده شود.
.sp
برای بررسی منطقه زمانی سیستم:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.INDENT 3.5
.sp
.EX
date +%Z
.EE
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
برای بررسی منطقه زمانی PostgreSQL:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.INDENT 3.5
.sp
.EX
postgres=# show timezone;
postgres=# SELECT * FROM pg_timezone_names WHERE name = current_setting(\(aqTIMEZONE\(aq);
.EE
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
برای پیکربندی منطقه زمانی PostgreSQL برای یک سرور خاص، لطفاً به مستندات نسخهٔ نصب‌شده مراجعه کنید.
.sp
معمولاً این تنظیم در فایل \fBpostgresql.conf\fP با مسیر متغیر بر اساس نسخه یعنی \fB/etc/postgresql/<version>/main/postgresql.conf\fP پیکربندی می‌شود، اما در برخی سیستم‌ها ممکن است این فایل‌ها در \fB/var/lib/pgsql/data\fP قرار داشته باشند\&.
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.INDENT 3.5
.sp
.EX
timezone = \(aqUTC\(aq
.EE
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
نخستین کار، ساخت پایگاه داده و کاربری است که کارگزارها با آن به پایگاه داده دسترسی خواهند داشت. چندین مرحله لازم است:
.INDENT 0.0
.IP 1. 3
با کاربر \(dqpostgres\(dq به PostgreSQL وارد شوید:
.INDENT 3.0
.INDENT 3.5
.sp
.EX
$ sudo \-u postgres psql postgres
Enter password:
postgres=#
.EE
.UNINDENT
.UNINDENT
.IP 2. 3
پایگاه داده را بسازید:
.INDENT 3.0
.INDENT 3.5
.sp
.EX
postgres=# CREATE DATABASE database\-name;
CREATE DATABASE
postgres=#
.EE
.UNINDENT
.UNINDENT
.sp
(\fBdatabase\-name\fP نام انتخاب‌شده برای پایگاه داده است.)
.IP 3. 3
کاربری را که Kea از طریق آن به پایگاه داده دسترسی خواهد داشت بسازید (و برای آن گذرواژه‌ای تعیین کنید)، سپس دسترسی به پایگاه داده را به آن اعطا نمایید:
.INDENT 3.0
.INDENT 3.5
.sp
.EX
postgres=# CREATE USER user\-name WITH PASSWORD \(aq1234\(aq;
CREATE ROLE
postgres=# GRANT ALL PRIVILEGES ON DATABASE database\-name TO user\-name;
GRANT
postgres=# \ec database\-name
You are now connected to database \(dqdatabase\-name\(dq as user \(dqpostgres\(dq.
postgres=# GRANT ALL PRIVILEGES ON SCHEMA public TO user\-name;
GRANT
postgres=#
.EE
.UNINDENT
.UNINDENT
.IP 4. 3
از PostgreSQL خارج شوید:
.INDENT 3.0
.INDENT 3.5
.sp
.EX
postgres=# \eq
Bye
$
.EE
.UNINDENT
.UNINDENT
.IP 5. 3
در این مرحله، جدول‌های پایگاه داده را یا با استفاده از ابزار \fBkea\-admin\fP \%<#\:std-iscman-kea-admin> آن‌گونه که در بخش بعدی توضیح داده شده است بسازید (توصیه‌شده)، یا به صورت دستی. برای ساخت دستی جدول‌ها، دستور زیر را وارد کنید. PostgreSQL از مدیر سیستم می‌خواهد گذرواژهٔ کاربر جدید را که در مرحله ۳ تعیین شده بود وارد کند. پس از تکمیل دستور، Kea به اعلان خط فرمان بازخواهد گشت. خروجی باید شبیه به موارد زیر باشد:
.INDENT 3.0
.INDENT 3.5
.sp
.EX
$ psql \-d database\-name \-U user\-name \-f path\-to\-kea/share/kea/scripts/pgsql/dhcpdb_create.pgsql
Password for user user\-name:
CREATE TABLE
CREATE INDEX
CREATE INDEX
CREATE TABLE
CREATE INDEX
CREATE TABLE
START TRANSACTION
INSERT 0 1
INSERT 0 1
INSERT 0 1
COMMIT
CREATE TABLE
START TRANSACTION
INSERT 0 1
COMMIT
$
.EE
.UNINDENT
.UNINDENT
.sp
(\fBpath\-to\-kea\fP محل نصب Kea است.)
.sp
چنانچه به جای آن با خطایی مواجه شدید، مانند:
.INDENT 3.0
.INDENT 3.5
.sp
.EX
psql: FATAL:  no pg_hba.conf entry for host \(dq[local]\(dq, user \(dquser\-name\(dq, database \(dqdatabase\-name\(dq, SSL off
.EE
.UNINDENT
.UNINDENT
.sp
\&... پیکربندی PostgreSQL نیاز به تغییر خواهد داشت. Kea هنگام اتصال به پایگاه داده از احراز هویت با گذرواژه استفاده می‌کند و باید مدخل‌های مناسب به فایل pg_hba.conf در PostgreSQL اضافه شوند. این فایل معمولاً در دایرکتوری اصلی داده‌های کارگزار PostgreSQL قرار دارد. مسیر دقیق ممکن است بسته به سیستم‌عامل و نسخه متفاوت باشد، اما مکان پیش‌فرض برای PostgreSQL مسیر \fB/etc/postgresql/*/main/postgresql.conf\fP است\&. با این حال، در برخی سیستم‌ها این فایل ممکن است در \fB/var/lib/pgsql/data\fP قرار داشته باشد\&.
.sp
با این فرض که Kea روی همان میزبانِ PostgreSQL اجرا می‌شود، افزودن خطوطی شبیه به موارد زیر برای فراهم کردن دسترسی مبتنی بر احراز هویت گذرواژه‌ای به پایگاه دادهٔ Kea کافی خواهد بود:
.INDENT 3.0
.INDENT 3.5
.sp
.EX
local   database\-name    user\-name                                 password
host    database\-name    user\-name          127.0.0.1/32           password
host    database\-name    user\-name          ::1/128                password
.EE
.UNINDENT
.UNINDENT
.sp
این ویرایش‌ها عمدتاً به عنوان یک نقطهٔ شروع در نظر گرفته شده‌اند و مرجعی قطعی برای مدیریت PostgreSQL یا امنیت پایگاه داده نیستند. لطفاً پیش از اعمال این تغییرات با راهنمای کاربری PostgreSQL مشورت کنید، زیرا این کار ممکن است سایر پایگاه‌های دادهٔ در حال اجرا را در معرض دسترسی قرار دهد. برای اعمال تغییرات ممکن است راه‌اندازی مجدد PostgreSQL لازم باشد.
.UNINDENT.SS مقداردهی اولیه پایگاه داده PostgreSQL با استفاده از \fBkea\-admin\fP \%<#\:std-iscman-kea-admin>
.sp
اگر جدول‌ها به‌صورت دستی ایجاد نشده‌اند، اکنون با
اجرای ابزار \fBkea\-admin\fP \%<#\:std-iscman-kea-admin> این کار را انجام دهید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ kea\-admin db\-init pgsql \-u database\-user \-p database\-password \-n database\-name
.EE
.UNINDENT
.UNINDENT
.sp
اگر جدول‌ها قبلاً به‌صورت دستی ایجاد شده‌اند، این کار را انجام ندهید. \fBkea\-admin\fP \%<#\:std-iscman-kea-admin>
بررسی‌های اولیه‌ای انجام می‌دهد؛ اگر پایگاه داده شامل هرگونه جدول موجود باشد،
از مقداردهی اولیه آن خودداری خواهد کرد. برای شروع از ابتدا،
تمام داده‌ها باید به‌صورت دستی حذف شوند. (این فرآیند عمداً یک عملیات
دستی در نظر گرفته شده است تا از خطاهای تصادفی و جبران‌ناپذیر توسط \fBkea\-admin\fP \%<#\:std-iscman-kea-admin>\& جلوگیری شود.)
.SS ارتقای موتور PostgreSQL از یک نسخه قدیمی‌تر
.sp
اگر PostgreSQL خود را از نسخه‌ای قدیمی‌تر از 15.0 ارتقا داده‌اید، نیاز است
مجوزهای اضافی به کاربر اعطا کنید:
.sp
ابتدا، با عنوان کاربر \(dqpostgres\(dq وارد PostgreSQL شوید:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ sudo \-u postgres psql \-d database\-name \-U postgres
Enter password:
postgres=#
.EE
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
سپس، دسترسی به طرح‌واره (schema) \fBpublic\fP را اعطا کنید.
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.INDENT 3.5
.sp
.EX
postgres=# GRANT ALL PRIVILEGES ON SCHEMA public TO user\-name;
GRANT
postgres=#
.EE
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
اکنون، از کلاینت PostgreSQL خارج شوید:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.INDENT 3.5
.sp
.EX
postgres=# \eq
Bye
$
.EE
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.SS ارتقای پایگاه داده PostgreSQL از نسخه قدیمی‌تر Kea
.sp
طرح‌واره پایگاه داده PostgreSQL را می‌توان با استفاده از همان ابزار و
دستورهای شرح‌داده‌شده در «ارتقای پایگاه داده MySQL از نسخه قدیمی‌تر Kea» ارتقا داد، با این استثنا که باید
از نوع backend پایگاه داده \(dqpgsql\(dq در دستورها استفاده شود.
.sp
برای بررسی نسخه فعلی طرح‌واره از دستور زیر استفاده کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ kea\-admin db\-version pgsql \-u database\-user \-p database\-password \-n database\-name
.EE
.UNINDENT
.UNINDENT
.sp
برای انجام ارتقا از دستور زیر استفاده کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ kea\-admin db\-upgrade pgsql \-u database\-user \-p database\-password \-n database\-name
.EE
.UNINDENT
.UNINDENT
.SS بهبود کارایی با PostgreSQL
.sp
تغییر مقدار داخلی \fBsynchronous_commit\fP در PostgreSQL از مقدار پیش‌فرض
ON به OFF می‌تواند منجر به بهبود چشمگیر کارایی Kea شود؛ در سیستم‌های کند، این بهبود
می‌تواند بیش از ۱۰۰۰٪ باشد. برای آزمایش، می‌توان آن را به ازای هر نشست (per\-session) تنظیم کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
postgres=# SET synchronous_commit = OFF;
.EE
.UNINDENT
.UNINDENT
.sp
یا به صورت دائمی از طریق دستور (روش ترجیحی):
.INDENT 0.0
.INDENT 3.5
.sp
.EX
postgres=# ALTER SYSTEM SET synchronous_commit=OFF;
.EE
.UNINDENT
.UNINDENT
.sp
یا به صورت دائمی در فایل \fB/etc/postgresql/[version]/main/postgresql.conf\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
synchronous_commit = off
.EE
.UNINDENT
.UNINDENT
.sp
تغییر این مقدار می‌تواند در طول بازیابی داده‌ها پس از خرابی ناگهانی (crash)
مشکلاتی ایجاد کند، بنابراین توصیه می‌کنیم مستندات PostgreSQL را به نشانی \%<https://\:www\:.postgresql\:.org/\:docs/\:current/\:wal-async-commit\:.html>\& با دقت مطالعه کنید.
با مقدار پیش‌فرض ON، پایگاه داده PostgreSQL تغییرات را پس از هر پرس‌وجوی INSERT یا UPDATE روی دیسک می‌نویسد
(در اصطلاح Kea، هر بار که یک کلاینت یک اجاره (lease) جدید دریافت می‌کند یا اجاره موجود را تمدید می‌کند). هنگامی که
\fBsynchronous_commit\fP روی OFF تنظیم شود، PostgreSQL قبل از نوشتن تغییرات مقداری تأخیر ایجاد می‌کند.
دسته‌بندی نوشتن‌ها بهبود کارایی قابل‌توجهی به همراه دارد،
اما در بدترین سناریو، ممکن است تمام تغییرات در آخرین لحظات قبل از خرابی ناگهانی
از دست بروند. از آنجا که Kea نرم‌افزاری پایدار است و بسیار به‌ندرت دچار خرابی می‌شود،
در اغلب استقرارها مزایای کارایی بر خطرات احتمالی برتری دارد..SS استفاده از پایگاه‌های داده فقط‌خواندنی با رزروهای میزبان
.sp
اگر از یک پایگاه داده فقط‌خواندنی برای ذخیره رزروهای میزبان (host reservations) استفاده شود، Kea باید
صریحاً برای کار با پایگاه داده در حالت فقط‌خواندنی (read\-only) پیکربندی شود.
بخش‌های Using Read\-Only Databases for Host Reservations With DHCPv4 \%<#\:read-only-database-configuration4> و
Using Read\-Only Databases for Host Reservations with DHCPv6 \%<#\:read-only-database-configuration6> توضیح می‌دهند که چه زمانی
چنین پیکربندی‌ای ممکن است لازم باشد و چگونه Kea را برای کار به این شیوه برای هر دو پروتکل DHCPv4 و DHCPv6 پیکربندی کنید.
.SS محدودیت‌های مربوط به استفاده از پایگاه‌های داده SQL
.SS مسئله سال ۲۰۳۸
.sp
زمان انقضای اجاره (lease) در Kea برای هر اجاره به عنوان یک مقدار برچسب زمان (timestamp) در پایگاه داده SQL ذخیره
می‌شود. توسعه‌دهندگان Kea مشاهده کرده‌اند که پایگاه داده MySQL برچسب‌های زمانی فراتر از 2147483647 ثانیه (بیشینه عدد علامت‌دار
۳۲ بیتی) از ابتدای مبدأ یونیکس (00:00:00 در ۱ ژانویه ۱۹۷۰) را نمی‌پذیرد. برخی از نسخه‌های PostgreSQL مقادیر
بزرگ‌تر را می‌پذیرند، اما مقدار هنگام بازخوانی دستخوش تغییر می‌شود. به همین دلیل، بخش‌های پشتیبان (backends) پایگاه داده
اجاره، محدودیتی را بر روی بیشینه برچسب زمانی قابل ذخیره در پایگاه داده اعمال می‌کنند که برابر با بیشینه عدد علامت‌دار
۳۲ بیتی است. این امر عملاً به این معنی است که نسخه فعلی Kea نمی‌تواند اجاره‌هایی را ذخیره کند که زمان انقضای آن‌ها دیرتر
از 2147483647 ثانیه از آغاز مبدأ زمانی (حدود سال ۲۰۳۸) باشد. این مورد هنگامی که پشتیبانی پایگاه داده از برچسب‌های
زمانی طولانی‌تر فراهم شود، برطرف خواهد شد.
.SH "امنیت KEA (KEA SECURITY)"
.sp
نرم‌افزار Kea در ابتدا برای نصب در یک محیط محافظت‌شده، در یک مرکز داده شبکه طراحی شده بود؛ این نرم‌افزار امکانات امنیتی
سخت‌گیرانه‌ای ارائه نمی‌داد. با این حال، به دلیل تقاضای کاربران و نیازمندی‌های رو به تحول شبکه، پشتیبانی از احراز هویت
پایه‌ای HTTP و پروتکل امنیت لایه انتقال (TLS) به Kea اضافه شده است.
.SS پشتیبانی از TLS/HTTPS
.sp
از نسخه Kea 1.9.6، می‌توان از TLS برای امن‌سازی ارتباطات HTTP استفاده کرد. سه سطح حفاظتی ممکن وجود دارد:
.INDENT 0.0
.IP \(bu 2
بدون TLS. اتصال به صورت متن ساده (plain\-text) و HTTP رمزگذاری‌نشده است. (این تنها گزینه موجود در نسخه‌های پیش از Kea 1.9.6 است.)
.IP \(bu 2
رمزنگاری، که در برابر حملات غیرفعال (passive) و شنود محافظت می‌کند. در این حالت، هویت کارگزار احراز می‌شود اما کلاینت
احراز هویت نمی‌شود. این حالت معمول هنگام امن‌سازی یک وب‌سایت است، جایی که کلاینت‌ها و کارگزارها تحت کنترل یک نهاد
مشترک نیستند.
.IP \(bu 2
احراز هویت متقابل (دوطرفه) بین کلاینت و کارگزار. این سخت‌گیرانه‌ترین حالت امنیتی است و هنگامی که TLS فعال باشد،
حالت پیش‌فرض است.
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
احراز هویت متقابل TLS صرفاً مختص موجودیت‌های TLS است. هنگامی که TLS و یک طرح احراز هویت HTTP همراه با یکدیگر استفاده می‌شوند،
هیچ پیوندی بین این دو سازوکار امنیتی وجود ندارد، و بنابراین هیچ اثباتی مبنی بر اینکه کلاینت و کارگزار TLS همان کلاینت و کارگزار
احراز هویت HTTP هستند وجود ندارد.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
توصیه می‌شود برای مقابله با حملات محلی (توسط کاربرانی که به سیستمی که کارگزارها/عامل‌های Kea روی آن اجرا می‌شوند متصل هستند)،
از پورت‌های دارای دسترسی ویژه (privileged ports) برای HTTP/HTTPS استفاده شود. این اقدام همچنین از جعل هویت در HTTP و به‌طور
کلی از حملات منع خدمت (Denial of Service) جلوگیری می‌کند.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
کارگزار هنگام تغییر نوع سوکت از HTTP به HTTPS یا از HTTPS به HTTP با استفاده از آدرس و پورت یکسان، خطا صادر خواهد کرد.
این عمل مجاز نیست چرا که ممکن است به دلیل اشتباه سهوی کاربر، یک رخنه امنیتی ایجاد کند.
هنگام استفاده از دستور \(dqconfig\-set\(dq برای جابه‌جایی از HTTP به HTTPS یا از HTTPS به HTTP، باید یک آدرس یا پورت متفاوت
مشخص شود. همین موضوع هنگام ویرایش فایل پیکربندی و سپس اجرای دستور \(dqconfig\-reload\(dq نیز صدق می‌کند.
.UNINDENT
.UNINDENT
.SS ساخت Kea با پشتیبانی از TLS/HTTPS
.sp
پشتیبانی از TLS/HTTPS با هر دو کتابخانه رمزنگاری OpenSSL یا Botan در دسترس است. محدودیت‌هایی بر روی کتابخانه Boost وجود دارد
که باید رعایت شوند:
.INDENT 0.0
.IP \(bu 2
نسخه‌های OpenSSL قدیمی‌تر از 1.0.2 منسوخ شده‌اند و نباید استفاده شوند. پشتیبانی Kea از TLS با این نسخه‌ها آزمایش نشده و پشتیبانی نمی‌شود.
.IP \(bu 2
نسخه OpenSSL 1.0.2 دارای پشتیبانی تمدیدشده است، اما فقط برای مشتریان ویژه OpenSSL. پشتیبانی TLS در Kea با این نسخه آزمایش شده اما پشتیبانی نمی‌شود.
.IP \(bu 2
نسخه‌های OpenSSL 1.1.x و جدیدتر آزمایش شده‌اند و پشتیبانی می‌شوند. بسیاری از نسخه‌های اخیر سیستم‌عامل‌ها شامل پشتیبانی از TLS 1.3 هستند.
.IP \(bu 2
نسخه OpenSSL 3.x منتشر شده است و Kea با آن کامپایل و ساخته می‌شود.
.IP \(bu 2
نسخه LibreSSL 3.2.4 آزمایش شده است. LibreSSL دارای رابط برنامه‌نویسی (API) مشترک با OpenSSL 1.0.2 است، بنابراین باید کار کند، اما پشتیبانی نمی‌شود.
.IP \(bu 2
نسخه‌های Botan 1.x و 2.x منسوخ شده‌اند و نباید استفاده شوند.
.IP \(bu 2
نسخه‌های Botan 3.4.0 و جدیدتر آزمایش شده‌اند و پشتیبانی می‌شوند. پشتیبانی Kea از TLS نیازمند چهار فایل سرآیند Asio است که در بسته‌های
Botan گنجانده شده‌اند و تنها در صورتی نصب می‌شوند که Botan با گزینه \fB\-\-with\-boost\fP پیکربندی شده باشد.
.sp
بسیاری از بسته‌های ارائه‌شده توسط سیستم‌عامل‌ها، مانند Ubuntu 20.10، کتابخانه Botan را با پشتیبانی Boost نمی‌سازند،
که باعث می‌شود این بسته‌ها برای Kea همراه با TLS غیرقابل استفاده باشند.
.sp
همچنان امکان دریافت این فایل‌ها از توزیع متناظر Botan و نصب دستی آن‌ها در پوشه include مربوط به Botan وجود دارد،
اما این کار باید به عنوان آخرین راهکار در نظر گرفته شود.
.sp
بدون این فایل‌های سرآیند، یا با نسخه‌ای از Botan قدیمی‌تر از 3.4.0، برنامه Kea ساخته نمی‌شود زیرا پشتیبانی TLS/HTTPS
برای امنیت، ضروری در نظر گرفته می‌شود.
.IP \(bu 2
نسخه‌های بسیار قدیمی Boost پشتیبانی از SSL را (بر پایه OpenSSL) بدون ارائه امکان انتخاب نسخه TLS فراهم می‌کنند؛ Kea
همچنان می‌تواند از آن‌ها استفاده کند، اما توصیه نمی‌شوند.
.IP \(bu 2
نسخه‌های Boost پیش از 1.64 پشتیبانی از SSL را با یک نسخه ثابت TLS ارائه می‌دهند؛ Kea در این نسخه‌ها استفاده از TLS 1.2 را اجباری می‌کند.
.IP \(bu 2
نسخه‌های Boost 1.64 یا جدیدتر، پشتیبانی از SSL را با نسخه عمومی TLS ارائه می‌دهند؛ بهترین (بالاترین) نسخه موجود در هر دو
طرف ارتباط انتخاب می‌شود.
.UNINDENT.SS پیکربندی TLS/HTTPS
.sp
پارامترهای پیکربندی TLS عبارتند از:
.INDENT 0.0
.IP \(bu 2
\fBtrust\-anchor\fP \- این پارامتر رشته‌ای، نام یک فایل یا دایرکتوری را مشخص می‌کند که گواهی مرجع صدور گواهی (CA) طرف مقابل در آن یافت می‌شود. در OpenSSL، دایرکتوری باید شامل پیوندهای نمادین هش (hash symbolic links) باشد. در Botan، دایرکتوری به‌صورت بازگشتی برای یافتن گواهی‌ها جستجو می‌شود.
.IP \(bu 2
\fBcert\-file\fP \- این پارامتر رشته‌ای، نام فایلی را مشخص می‌کند که حاوی گواهی نهاد نهایی (end\-entity) نمونه‌ی Kea در حال پیکربندی است.
.IP \(bu 2
\fBkey\-file\fP \- این پارامتر رشته‌ای، کلید خصوصی گواهی نهاد نهایی نمونه‌ی Kea در حال پیکربندی را مشخص می‌کند. این فایل نباید رمزگذاری شده باشد؛ اکیداً توصیه می‌شود دسترسی به آن محدود گردد.
.UNINDENT
.sp
این سه پارامتر رشته‌ای باید یا همگی نامشخص باشند (TLS غیرفعال) یا همگی مشخص شوند (TLS فعال).
.sp
پروتکل TLS نامتقارن است: احراز هویت سرور توسط کلاینت اجباری است، اما احراز هویت کلاینت توسط سرور اختیاری می‌باشد. از نظر اصطلاحات TLS، این بدان معناست که سرور ممکن است گواهی کلاینت را الزامی بداند یا نداند؛ یک پارامتر TLS مخصوص سرور برای این منظور وجود دارد.
.INDENT 0.0
.IP \(bu 2
\fBcert\-required\fP \- این پارامتر بولی (boolean) به سرور اجازه می‌دهد که گواهی کلاینت را الزامی نداند. مقدار پیش‌فرض آن \fBtrue\fP است، به این معنی که گواهی کلاینت الزامی است و کلاینت باید احراز هویت شود. این پرچم در سمت کلاینت هیچ مفهومی ندارد؛ سرور همواره گواهی‌ای ارائه می‌دهد که توسط کلاینت اعتبارسنجی می‌شود.
.UNINDENT
.sp
اشیاء درون فایل‌ها باید در قالب PEM باشند. فایل‌ها می‌توانند حاوی بیش از یک گواهی باشند، اما این مورد آزمایش نشده و پشتیبانی نمی‌شود.
.sp
کتابخانه Botan الزام می‌کند که گواهی‌های CA دارای ویژگی‌های استاندارد گواهی CA باشند، بررسی می‌کند که گواهی‌های نهاد نهایی حتماً نسخه ۳ باشند (همان‌طور که استاندارد TLS الزامی کرده است)، و برای کلید خصوصی فقط از فایل‌های PKCS 8 پشتیبانی می‌کند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
برخی از کتابخانه‌های رمزنگاری (مانند Botan و نگارش‌های اخیر OpenSSL) حداقل استحکام (یعنی طول کلید) را اعمال می‌کنند، به عنوان مثال حداقل ۲۰۴۸ برای RSA.
.UNINDENT
.UNINDENT
.sp
مجموعه‌ای نمونه از گواهی‌ها و اشیاء وابسته در مسیر \fBsrc/lib/asiolink/testutils/ca\fP در سورس‌های Kea به همراه فایل \fBdoc.txt\fP که نحوه تولید آن‌ها با استفاده از دستور \fBopenssl\fP را توضیح می‌دهد، موجود است. این فایل‌ها صرفاً برای اهداف آزمایشی هستند. \fBاز آن‌ها در محیط عملیاتی استفاده نکنید.\fP
.sp
دست‌تکانی TLS (یا TLS handshake)، مرحله‌ای که در آن پارامترهای رمزنگاری تبادل شده و احراز هویت اعتبارسنجی می‌شود، می‌تواند به روش‌های گوناگونی با شکست مواجه شود. پیام‌های خطا اغلب برای شناسایی دقیق منبع مشکل کمکی نمی‌کنند. هر دو ابزار OpenSSL و Botan یک ابزار خط فرمانی به همراه دستور \fBverify\fP ارائه می‌دهند که می‌توان از آن برای درک و رفع مشکلات دست‌تکانی استفاده کرد.
.SS تنظیم دقیق OpenSSL
.sp
نرم‌افزار Kea پارامترهای پیش‌فرض پیکربندی OpenSSL را می‌پذیرد، اما مدیران سیستم همچنین می‌توانند تنظیمات OpenSSL را به‌دقت تنظیم کنند. به عنوان مثال، ممکن است محدود کردن نسخه TLS مطلوب باشد.
.sp
فایل پیکربندی پیش‌فرض OpenSSL با نام \fBopenssl.cnf\fP\& شناخته می‌شود. این فایل در یک دایرکتوری \fBetc\fP وابسته به سیستم قرار دارد و مکان آن را می‌توان با استفاده از متغیر محیطی \fBOPENSSL_CONF\fP بازنویسی کرد. برای نگارش‌های OpenSSL بالاتر از 1.0.2، حداقل پروتکل قابل قبول را می‌توان از طریق متغیر \fBMinProtocol\fP تعیین کرد.
.sp
برای این مثال‌ها فرض می‌کنیم که هیچ متغیری از قبل تنظیم نشده و هیچ بخشی از قبل وجود ندارد؛ البته امکان استفاده مجدد از متغیرها و بخش‌های موجود نیز وجود دارد.
.sp
در برنامه کاربردی پیش‌فرض، یعنی \fBopenssl_conf\fP، متغیر مربوطه باید روی نام بخشی تنظیم شود که مقادیر پیش‌فرض را مدیریت می‌کند: در این مثال، \fBdefault_conf\fP\&. اگر \fBopenssl_conf\fP هنوز تنظیم نشده است، این خط را در ابتدای فایل پیکربندی OpenSSL (پیش از بخش نخست) اضافه کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
openssl_conf = default_conf
.EE
.UNINDENT
.UNINDENT
.sp
در بخش \fBdefault_conf\fP، متغیر \fBssl_conf\fP باید روی نام بخشی تنظیم شود که پیش‌فرض‌های SSL/TLS را مدیریت می‌کند: در این مثال، \fBssl_sect\fP\&.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[ default_conf ]
ssl_conf = ssl_sect
.EE
.UNINDENT
.UNINDENT
.sp
در بخش \fBssl_sect\fP، متغیر \fBsystem_default\fP باید روی نام بخشی تنظیم شود که پیش‌فرض‌های سیستم را مدیریت می‌کند: در این مثال، \fBsystem_default_sect\fP\&.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[ ssl_sect ]
system_default = system_default_sect
.EE
.UNINDENT
.UNINDENT
.sp
در بخش \fBsystem_default_sect\fP، متغیر \fBMinProtocol\fP باید روی حداقل نگارش مطلوب SSL/TLS تنظیم شود: در این مثال، \fBTLSv1.2\fP\&.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[ system_default_sect ]
MinProtocol = TLSv1.2
.EE
.UNINDENT
.UNINDENT
.sp
در صورت تمایل، می‌توان از همین مراحل برای اعمال سایر پارامترهای رمزنگاری نیز استفاده کرد.
.sp
اکیداً توصیه می‌شود صفحه راهنمای \fBopenssl.cnf\fP مطالعه شود، که معمولاً \fBconfig.5ssl\fP نامیده شده و با دستور \fBman config\fP\& نمایش داده می‌شود..SS کانال کنترلی امن Kea
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این بخش مربوط به Kea Control Agent بود که اکنون منسوخ (حذف) شده است، اما برای سوکت‌های کنترلی HTTPS پشتیبانی‌شده توسط کارگزارهای Kea نیز صدق می‌کند.
.UNINDENT
.UNINDENT
.sp
سوکت‌های کنترلی کارگزارهای Kea به‌طور ذاتی از اتصال‌های امن HTTP با استفاده از TLS پشتیبانی می‌کنند. این امر امکان محافظت در برابر کاربرانی از گره محل اجرای عامل را فراهم می‌سازد؛ چیزی که یک پروکسی معکوس (reverse proxy) قادر به ارائهٔ آن نیست. اطلاعات بیشتر دربارهٔ پشتیبانی از TLS/HTTPS در Kea را می‌توان در TLS/HTTPS Support یافت\&.
.sp
پیکربندی TLS با استفاده از سه پارامتر رشته‌ای حاوی نام فایل‌ها و یک پارامتر بولی (boolean) انجام می‌شود:
.INDENT 0.0
.IP \(bu 2
پارامتر \fBtrust\-anchor\fP نام فایل یا مسیر دایرکتوری مرجع صدور گواهی (Certification Authority) را مشخص می‌کند.
.IP \(bu 2
پارامتر \fBcert\-file\fP نام فایل گواهی کارگزار را مشخص می‌کند.
.IP \(bu 2
پارامتر \fBkey\-file\fP نام فایل کلید خصوصی را مشخص می‌کند. این فایل نباید رمزنگاری شده باشد.
.IP \(bu 2
پارامتر \fBcert\-required\fP مشخص می‌کند که آیا گواهی‌های کلاینت الزامی هستند یا اختیاری. پیش‌فرض بر الزامی بودن آن‌ها و انجام احراز هویت متقابل (mutual authentication) است.
.UNINDENT
.sp
قالب فایل PEM است. یا باید تمام پارامترهای رشته‌ای مشخص شوند و HTTP روی TLS (همان HTTPS) استفاده گردد، یا هیچ‌کدام مشخص نشوند و HTTP معمولی به کار رود. پیکربندی تنها یک یا دو پارامتر رشته‌ای منجر به خطا خواهد شد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
هنگامی که گواهی‌های کلاینت الزامی نباشند، تنها سمت کارگزار احراز هویت می‌شود، یعنی ارتباط با یک کلاینت ناشناس رمزنگاری می‌گردد. این حالت تنها در برابر حملات غیرفعال (passive) محافظت می‌کند؛ حملات فعال مانند \(dqمرد میانی\(dq (man\-in\-the\-middle) همچنان امکان‌پذیر خواهند بود.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
هیچ طرح احراز هویت استاندارد HTTP موجودیت پایانی (end entity) خود را به‌صورت رمزنگاری‌شده به TLS مقید نمی‌کند. این بدان معناست که کلاینت و کارگزار TLS می‌توانند احراز هویت متقابل شوند، اما هیچ اثباتی وجود ندارد که آن‌ها همان هویت‌های احراز هویت HTTP باشند.
.UNINDENT
.UNINDENT
.sp
ابزار \fBkea\-shell\fP \%<#\:std-iscman-kea-shell> نیز از TLS پشتیبانی می‌کند.
.SS ایمن‌سازی استقرار Kea
.sp
در ادامه فهرستی از ملاحظات برای مدیران سیستمی که مایل به ارتقای امنیت Kea هستند آورده شده است. در بسیاری از موارد، بین راحتی و امنیت مصالحه‌هایی وجود دارد.
.SS طراحی مبتنی بر مؤلفه
.sp
معماری Kea ماژولار است و از دیمن‌های مجزا برای وظایف مختلف بهره می‌برد. یک استقرار Kea ممکن است شامل دیمن‌های DHCPv4، DHCPv6 و Dynamic DNS باشد؛ ابزار کمکی \fBkea\-lfc\fP \%<#\:std-iscman-kea-lfc> برای پاک‌سازی دوره‌ای فایل‌های اجاره (lease)؛ پایگاه‌های دادهٔ MySQL و یا PostgreSQL که یا به‌صورت محلی روی کارگزارهای برنامه اجرا می‌شوند یا از طریق شبکهٔ داخلی در دسترس هستند؛ یک دیمن Netconf برای انجام نظارت بر پیکربندی و آمار کارگزارهای Kea؛ و یک سامانهٔ مانیتورینگ Stork.
این معماری ماژولار به مدیر سیستم اجازه می‌دهد تا با به حداقل رساندن کدهای بارگذاری و اجرا شده، سطح حمله (attack surface) را به کمترین میزان برساند.
به‌عنوان مثال، \fBkea\-dhcp\-ddns\fP \%<#\:std-iscman-kea-dhcp-ddns> نباید اجرا شود مگر اینکه به‌روزرسانی‌های DNS مورد نیاز باشد.
به همین ترتیب، اگر memfile استفاده نشود، \fBkea\-lfc\fP \%<#\:std-iscman-kea-lfc> هرگز فراخوانی نمی‌شود (و می‌توان آن را با خیال راحت حذف کرد یا هرگز نصب ننمود).
مشکلات امنیتی بالقوهٔ Kea را می‌توان با اجرای تنها آن فرایندهایی که در محیط محلی مورد نیاز هستند به حداقل رساند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
از نسخهٔ Kea 2.7.9 به بعد، \fBdata\-directory\fP (فقط در DHCPv6) منسوخ شده است. فایل‌های اجاره (DHCPv4 و DHCPv6) و فایل duid (فقط در DHCPv6) تنها می‌توانند از دایرکتوری تعیین‌شده در حین کامپایل بارگذاری شوند: \fB\(dq[kea\-install\-dir]/var/lib/kea\(dq\fP\&.
این مسیر می‌تواند در هنگام راه‌اندازی با تنظیم متغیر محیطی \fBKEA_DHCP_DATA_DIR\fP به مسیر دلخواه بازنویسی شود. اگر مسیری غیر از این مقدار در \fBname\fP یا \fBdata\-directory\fP استفاده شود، Kea خطایی صادر کرده و از راه‌اندازی خودداری می‌کند یا در صورت در حال اجرا بودن، یک خطای غیرقابل‌بازیابی را ثبت می‌کند.
این محدودیت برای نوشتن فایل اجاره با استفاده از دستورهای \fBlease4\-write\fP و \fBlease6\-write\fP نیز اعمال می‌شود. اگر مسیری غیر از این مقدار در \fBfilename\fP استفاده شود، Kea خطایی صادر کرده و از راه‌اندازی خودداری می‌کند یا در صورت در حال اجرا بودن، یک خطای غیرقابل‌بازیابی را ثبت خواهد کرد. برای سهولت در تعیین یک نام فایل سفارشی، کافی است بخش مسیر را از \fBfilename\fP حذف کنید\&. همین محدودیت همچنین برای نوشتن فایل حافظهٔ پنهان (cache) با استفاده از دستور \fBcache\-write\fP اعمال می‌شود. برای سهولت در تعیین یک نام فایل سفارشی، کافی است بخش مسیر را از \fBfilename\fP حذف کنید\&.
متغیر محیطی \fBKEA_DHCP_DATA_DIR\fP همچنین برای تغییر مکان پیش‌فرض فایل شناسه کارگزار تولیدشدهٔ DHCPv6 (kea\-dhcp6\-serverid) استفاده می‌شود.
.UNINDENT
.UNINDENT
.SS محدود کردن مجوزهای برنامه کاربردی
.sp
پروتکل‌های DHCPv4 و DHCPv6 فرض می‌کنند که کارگزار پورت دارای امتیاز UDP 67 (در DHCPv4) یا 547 (در DHCPv6) را باز می‌کند که در شرایط عادی به دسترسی ریشه (root) نیاز دارد. با این حال، از طریق سازوکار قابلیت‌ها (capabilities) در سیستم‌های لینوکس، Kea می‌تواند از یک حساب کاربری بدون امتیاز اجرا شود. برای جزئیات در مورد نحوهٔ اجرای Kea بدون دسترسی ریشه، «Running Kea From a Non\-root Account on Linux» \%<#\:non-root> را ببینید.
.SS ایمن‌سازی دسترسی مدیریتی Kea
.sp
هر سه دیمن اصلی Kea (\fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4>، \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> و \fBkea\-dhcp\-ddns\fP \%<#\:std-iscman-kea-dhcp-ddns>) همگی از یک کانال کنترلی که به‌صورت سوکت UNIX پیاده‌سازی شده است پشتیبانی می‌کنند. این کانال کنترلی که یک سوکت UNIX باز می‌کند، به‌طور پیش‌فرض غیرفعال است؛ با این حال، نمونه‌های پیکربندی متعددی آن را فعال کرده‌اند، زیرا ویژگی بسیار محبوبی است. برای خواندن از این سوکت یا نوشتن در آن، عموماً به دسترسی ریشه (root) نیاز است، هرچند اگر Kea برای اجرا به عنوان کاربر غیرریشه (non\-root) پیکربندی شده باشد، مالک فرایند می‌تواند در آن بنویسد. دسترسی را می‌توان با استفاده از کنترل دسترسی معمول به فایل در سیستم‌های POSIX (مالک، گروه، سایرین، خواندن/نوشتن) کنترل کرد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
از نسخهٔ Kea 2.7.9 به بعد، سوکت‌های کنترلی تنها می‌توانند در دایرکتوری تعیین‌شده در حین کامپایل یعنی \fB\(dq[kea\-install\-dir]/var/run/kea\(dq\fP قرار گیرند که همچنین باید دارای مجوزهای دسترسی \fB0750\fP باشد. این مسیر می‌تواند در هنگام راه‌اندازی با تنظیم متغیر محیطی \fBKEA_CONTROL_SOCKET_DIR\fP به مسیر دلخواه بازنویسی شود. اگر مسیری غیر از این مقدار در \fBsocket\-name\fP استفاده شود، Kea خطایی صادر کرده و از راه‌اندازی امتناع می‌ورزد یا در صورت در حال اجرا بودن، یک خطای غیرقابل‌بازیابی را ثبت می‌کند. برای سهولت در استفاده، کافی است مؤلفهٔ مسیر را از \fBsocket\-name\fP حذف کنید\&.
.UNINDENT
.UNINDENT
.sp
از نسخهٔ Kea 2.7.2 به بعد، کارگزارهای DHCP از کانال‌های کنترلی HTTP/HTTPS پشتیبانی می‌کنند و از نسخهٔ Kea 3.1.8 عامل کنترلی (Control Agent) حذف شده است.
.sp
از نسخهٔ Kea\-2.7.6 به بعد، Kea از چندین اتصال HTTP/HTTPS پشتیبانی می‌کند. هر دو نشانی IPv4 و IPv6 قابل استفاده هستند. با پیکربندی اتصال‌های HTTPS برای تمام دیمن‌ها، می‌توان امنیت را ارتقا داد.
.sp
پیکربندی Kea توسط یک فایل JSON بر روی کارگزار Kea کنترل می‌شود. این فایل می‌تواند توسط هر کاربری با مجوزهای فایل مربوطه (که توسط سیستم‌عامل کنترل می‌شود) مشاهده یا ویرایش گردد. توجه داشته باشید که گذرواژه‌ها به‌صورت متن ساده (clear text) در فایل پیکربندی ذخیره می‌شوند، بنابراین هر کسی با دسترسی خواندن فایل پیکربندی می‌تواند این اطلاعات را بیابد. از منظر عملی، هر کسی با مجوز ویرایش فایل پیکربندی، کنترل Kea را در دست دارد.
محدود کردن مجوزهای کاربر برای خواندن یا نوشتن فایل پیکربندی Kea، یک اقدام امنیتی مهم است.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
از نسخهٔ Kea 2.7.9 به بعد، فایل پیکربندی (با استفاده از دستور \fBconfig\-write\fP) تنها می‌تواند در همان دایرکتوری‌ای نوشته شود که فایل پیکربندی استفاده‌شده هنگام راه‌اندازی Kea (ارائه‌شده به عنوان آرگومان \fB\-c\fP) در آن قرار دارد.
.UNINDENT
.UNINDENT.SS ایمن‌سازی اتصال‌های پایگاه داده
.sp
Kea می‌تواند از یک پایگاه داده خارجی MySQL یا PostgreSQL برای ذخیره‌سازی پیکربندی، رزروهای میزبان،
و/یا اجاره‌ها (leases)، و/یا برای لاگ‌گیری قانونی (forensic logging) استفاده کند. استفاده از پایگاه‌های داده یک ویژگی محبوب است، اما اختیاری است؛
همچنین ذخیره داده‌ها در یک فایل ساده (flat file) روی دیسک نیز امکان‌پذیر است.
.sp
هنگام استفاده از پایگاه داده، Kea مشخصات اعتبارسنجی زیر را برای احراز هویت در پایگاه داده ذخیره کرده و به کار می‌برد:
نام کاربری، گذرواژه، میزبان، درگاه (port) و نام پایگاه داده. \fBاین مقادیر به صورت متن آشکار (clear text)
در فایل پیکربندی ذخیره می‌شوند.\fP
.sp
بسته به پیکربندی پایگاه داده، بررسی تطابق کاربر سیستم با نام کاربری پایگاه داده نیز امکان‌پذیر است.
برای جزئیات بیشتر به راهنمای MySQL یا PostgreSQL مراجعه کنید.
.sp
Kea از تنظیمات کلاینت SSL/TLS برای پایگاه داده MySQL و PostgreSQL پشتیبانی می‌کند
و باید به‌طور صریح برای تمام اتصال‌های مورد استفاده (پیکربندی،
رزروها، اجاره‌ها، لاگ‌گیری قانونی) پیکربندی شود. برای جزئیات بخش
اتصال پایگاه داده (Database Connectivity \%<#\:database-connectivity>) را ببینید.
.SS نشت اطلاعات از طریق لاگ‌گیری
.sp
امکان دارد که Kea کل یک فایل پیکربندی، از جمله گذرواژه‌ها و داده‌های محرمانه را لاگ کند.
از نسخه 1.9.7 در Kea، این مشکل با جایگزینی مقدار تمام ورودی‌هایی که به
\fBpassword\fP یا \fBsecret\fP ختم می‌شوند با علامت ستاره برطرف شده است، همان‌طور که پیش‌تر برای لاگ‌های پایگاه داده انجام می‌شد.
.sp
لاگ‌ها به stdout، stderr، فایل‌ها یا syslog ارسال می‌شوند؛ مجوزهای فایل‌های سیستم برای
stdout/stderr و فایل‌ها اعمال می‌گردد. syslog ممکن است لاگ‌ها را روی شبکه ارسال کند که این امر آن‌ها را بیشتر در معرض شنود احتمالی قرار می‌دهد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
از نسخه 2.7.9 در Kea، فایل‌های لاگ فقط می‌توانند در دایرکتوری خروجی تعیین‌شده
در زمان کامپایل نوشته شوند: \fB\(dq[kea\-install\-dir]/var/log/kea\(dq\fP\&. این
مسیر می‌تواند هنگام راه‌اندازی با تنظیم متغیر محیطی
\fBKEA_LOG_FILE_DIR\fP به مسیر دلخواه جایگزین (override) شود. اگر مسیری غیر از
این مقدار در \fBoutput\fP استفاده شود، Kea خطا داده و از اجرا خودداری می‌کند
یا در صورت در حال اجرا بودن، یک خطای غیرقابل‌بازیابی ثبت خواهد کرد. برای سهولت در استفاده، بخش
مسیر را از \fBoutput\fP حذف کرده و تنها نام فایل را مشخص کنید.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
از نسخه 2.7.9 در Kea، فایل‌های لاگ قانونی (legal log) فقط می‌توانند در دایرکتوری خروجی
تعیین‌شده در زمان کامپایل نوشته شوند: \fB\(dq[kea\-install\-dir]/var/log/kea\(dq\fP\&. این
مسیر می‌تواند هنگام راه‌اندازی با تنظیم متغیر محیطی
\fBKEA_LEGAL_LOG_DIR\fP به مسیر دلخواه جایگزین شود. اگر مسیری غیر از این مقدار
در \fBpath\fP استفاده شود، Kea خطا داده و از راه‌اندازی امتناع می‌کند یا در صورت
در حال اجرا بودن، یک خطای غیرقابل‌بازیابی ثبت خواهد کرد. برای سهولت در استفاده، کافی است پارامتر
\fBpath\fP را حذف کنید.
.UNINDENT
.UNINDENT
.SS خلاصه‌ای از محدودیت‌های مسیر
.sp
محدودیت‌های مسیر ذکرشده در این بخش را می‌توان طبق جدول
زیر خلاصه کرد:
.TS
box center;
l|l|l.
T{
عنصر محدودشده
T}	T{
مقدار پیش‌فرض
T}	T{
بازنویسی با متغیر محیطی
T}
_
T{
فایل‌های پیکربندی (\fBconfig\-write\fP)
T}	T{
دایرکتوری یکسان با فایل پیکربندی اولیه
T}	T{
N/A
T}
_
T{
فایل‌های حافظه موقت میزبان (\fBcache\-write\fP)
T}	T{
\fBvar/lib/kea\fP
T}	T{
\fBKEA_DHCP_DATA_DIR\fP
T}
_
T{
فایل‌های اجاره (Lease)
T}	T{
\fBvar/lib/kea\fP
T}	T{
\fBKEA_DHCP_DATA_DIR\fP
T}
_
T{
فایل شناسه کارگزار DHCPv6
T}	T{
\fBvar/lib/kea\fP
T}	T{
\fBKEA_DHCP_DATA_DIR\fP
T}
_
T{
فایل‌های لاگ
T}	T{
\fBvar/log/kea\fP
T}	T{
\fBKEA_LOG_FILE_DIR\fP
T}
_
T{
فایل‌های لاگ قانونی (Forensic)
T}	T{
\fBvar/log/kea\fP
T}	T{
\fBKEA_LEGAL_LOG_DIR\fP
T}
_
T{
سوکت‌های یونیکس (Unix Sockets)
T}	T{
\fBvar/run/kea\fP
T}	T{
\fBKEA_CONTROL_SOCKET_DIR\fP
T}
_
T{
اسکریپت‌های مورد استفاده کتابخانه‌های Hook
T}	T{
\fBshare/kea/scripts/\fP
T}	T{
\fBKEA_HOOK_SCRIPTS_PATH\fP
T}
.TE.SS مؤلفه‌های رمزنگاری
.sp
Kea از هر یک از دو کتابخانه رمزنگاری زیر پشتیبانی می‌کند: Botan یا OpenSSL.
این انتخاب در زمان کامپایل انجام می‌شود و وابستگی‌های زمان کامپایل و زمان اجرا
را میان Kea و کتابخانه انتخاب‌شده ایجاد می‌کند. با وجود اینکه OpenSSL محبوب‌ترین
انتخاب برای محیط‌های عملیاتی است، Botan نیز یک جایگزین کاملاً پشتیبانی‌شده باقی می‌ماند.
.sp
موارد کاربرد اصلی کتابخانه‌های رمزنگاری عبارتند از:
.INDENT 0.0
.IP \(bu 2
پشتیبانی از TLS برای کانال‌های کنترلی HTTPS، معرفی‌شده در Kea 1.9.6.
.IP \(bu 2
امضاهای TSIG هنگام ارسال به‌روزرسانی‌های DNS.
.IP \(bu 2
محاسبه رکوردهای DHCID هنگام ارسال به‌روزرسانی‌های DNS.
.IP \(bu 2
تولید اعداد تصادفی (اما نه برای مواردی که به تولیدکننده در سطح رمزنگاری پیشرفته نیاز دارند).
.UNINDENT
.sp
برای OpenSSL و Botan، تنها از رابط رمزنگاری سطح پایین استفاده می‌شود (مانند libcrypto). برنامه Kea
با libssl پیوند (link) برقرار نمی‌کند. برخی از سامانه‌های نرم‌افزاری وابسته، مانند کتابخانه‌های کلاینت پایگاه داده،
نیز می‌توانند به یک کتابخانه رمزنگاری وابسته باشند.
.sp
یک راه برای محدود کردن خطرات ناشی از آسیب‌پذیری‌های بالقوه OpenSSL یا Botan، عدم استفاده از DDNS است.
کتابخانه‌ها همچنان برای ساخت و اجرای Kea مورد نیاز خواهند بود، اما کدهای آن‌ها هرگز اجرا نخواهد شد، بنابراین
هرگونه باگ بالقوه در کتابخانه‌ها قابل بهره‌برداری نخواهد بود.
.SS امضاهای TSIG
.sp
برنامه Kea هنگام امضای به‌روزرسانی‌های DNS با امضاهای TSIG، از الگوریتم‌های زیر پشتیبانی می‌کند:
.INDENT 0.0
.IP \(bu 2
HMAC\-MD5
.IP \(bu 2
HMAC\-SHA1
.IP \(bu 2
HMAC\-SHA224
.IP \(bu 2
HMAC\-SHA256
.IP \(bu 2
HMAC\-SHA384
.IP \(bu 2
HMAC\-SHA512
.UNINDENT
.sp
برای دیدن فهرست به‌روز، فهرست کلیدهای TSIG را در \%<#\:d2-tsig-key-list-config> ببینید.
.sp
برنامه Kea برای محاسبه رکوردهای DHCID از SHA256 استفاده می‌کند. این موضوع از دیدگاه رمزنگاری
حائز اهمیت نیست، زیرا رکورد DHCID صرفاً برای ایجاد شناسه‌های منحصربه‌فرد برای دو دستگاهی به کار می‌رود که
ممکن است در زمان‌های مختلف یک آدرس IP یکسان به آن‌ها اختصاص یافته باشد.
.SS پشتیبانی از سوکت خام (Raw Socket)
.sp
به طور کلی، Kea DHCPv4 از سوکت‌های خام (raw sockets) برای دریافت ترافیک از کلاینت‌ها استفاده می‌کند. چالش اصلی،
دریافت بسته‌ها از دستگاه‌هایی است که هنوز هیچ آدرس IPv4 ندارند. هنگام مدیریت ترافیک مستقیم
(حالتی که کلاینت و سرور هر دو به یک پیوند متصل هستند و رله‌ها آن‌ها را جدا نکرده‌اند)، کرنل
به طور پیش‌فرض بسته را دور می‌اندازد زیرا آدرس IP مبدأ 0.0.0.0 است. بنابراین، Kea باید سوکت‌های خام را باز کند
تا بتواند این ترافیک را دریافت کند.
.sp
با این حال، اگر تمام ترافیک از طریق رله‌ها عبور کند (که در بسیاری از شبکه‌ها رایج است)، این کار
ضرورتی ندارد. در این حالت می‌توان به‌جای آن از سوکت‌های استاندارد UDP استفاده کرد. پارامتری به نام
\fBdhcp\-socket\-type\fP وجود دارد که این رفتار را کنترل می‌کند.
.sp
حالت پیش‌فرض، مجاز دانستن استفاده از سوکت خام است، چرا که انعطاف‌پذیری بیشتری دارد.
.sp
هنگام استفاده از سوکت‌های خام، Kea می‌تواند بسته‌های خام لایه ۲ را دریافت کرده و اکثر فایروال‌ها
(شامل iptables) را دور بزند. این عملاً بدین معناست که هنگام استفاده از سوکت‌های خام، نمی‌توان از iptables برای
مسدود کردن ترافیک DHCP استفاده کرد. این ویژگی، از تصمیمات طراحی در کرنل لینوکس است.
.sp
می‌توان Kea را طوری تنظیم کرد که از سوکت‌های UDP استفاده کند. این گزینه زمانی کاربرد دارد که تمام ترافیک رله شود.
با این حال، برای دستگاه‌هایی که مستقیماً متصل هستند کارایی ندارد. اگر Kea به سوکت‌های UDP محدود شود،
iptables باید به درستی عمل کند.
.sp
در صورتی که نیازی به سوکت‌های خام نباشد، غیرفعال کردن این دسترسی می‌تواند امنیت را افزایش دهد.
.SS دسترسی مدیریتی از راه دور
.sp
سرورهای DHCP و DDNS یک RESTful API را روی HTTP یا HTTPS (یعنی HTTP بر بستر TLS) ارائه می‌دهند.
این کانال‌های کنترلی ویژگی‌های اختیاری هستند که به صورت پیش‌فرض غیرفعال‌اند، اما کاربرد فراوانی دارند. در صورت فعال‌سازی،
به صورت پیش‌فرض روی آدرس loopback (یعنی 127.0.0.1 یا ::1) شنود می‌کنند، مگر اینکه طور دیگری پیکربندی شده باشند. برای
کسب اطلاعات بیشتر در مورد حفاظت از ترافیک TLS، بخش پشتیبانی از TLS/HTTPS را ببینید. محدود کردن اتصالات ورودی با یک فایروال،
مانند iptables، اکیداً توصیه می‌شود.
.sp
توجه داشته باشید که در استقرارهای دارای دسترسی‌پذیری بالا (HA)، می‌توان یک شنونده اختصاصی چندنخی (multi\-threaded)
را برای ارائه پروتکل HA از طریق RESTful API با گره‌های همتا (peers) پیکربندی کرد.
.sp
برنامه Kea همچنین از چندین اتصال HTTP/HTTPS پشتیبانی می‌کند. هر دو آدرس IPv4 و IPv6 قابل استفاده هستند.
با پیکربندی اتصالات HTTPS برای تمامی دیمن‌ها، می‌توان امنیت را ارتقا داد.
.SS احراز هویت برای RESTful API در Kea
.sp
در Kea 1.9.0 پشتیبانی از احراز هویت پایه HTTP (استاندارد RFC 7617 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc7617>)
برای کنترل دسترسی دستورات ورودی REST روی HTTP اضافه شد. اطلاعات هویتی (نام کاربری، گذرواژه)
در یک فایل پیکربندی محلی Kea بر روی دیسک ذخیره می‌شوند. نام کاربری همراه با دستور API ثبت می‌شود، بنابراین
می‌توان مشخص کرد که کدام کاربر احراز هویت‌شده هر دستور را اجرا کرده است. جزئیات کنترل دسترسی با استفاده از یک
ثبت‌کننده وقایع (logger) اختصاصی به نام \fBauth\fP ثبت می‌شود. احراز هویت پایه HTTP به خودی خود ضعیف است زیرا
در معرض حملات دیکشنری شناخته‌شده قرار دارد، اما این حملات نیازمند یک «حمله مرد میانی» (\(dqman in the middle\(dq)
برای دستیابی به ترافیک HTTP هستند. این مشکل را می‌توان با استفاده انحصاری از احراز هویت پایه HTTP روی TLS برطرف کرد.
در حقیقت، در صورت امکان، استفاده از گواهی‌های کلاینت برای TLS بهتر از استفاده از احراز هویت پایه HTTP است.
.sp
در Kea 1.9.2 یک نقطه قلاب (hook point) جدید به نام \fBauth\fP معرفی شد. با استفاده از این نقطه قلاب جدید، می‌توان یک
کتابخانه قلاب خارجی را برای گسترش کنترل‌های دسترسی، ادغام با سایر مراجع احراز هویت، یا افزودن کنترل دسترسی مبتنی بر نقش (RBAC)
به کانال‌های کنترلی توسعه داد. این نقطه قلاب به \fBhttp_auth\fP تغییر نام یافت و از نسخه 2.7.2 Kea توسط سرورهای DHCP
و DDNS نیز پشتیبانی می‌شود.
.sp
هر سه دیمن اصلی Kea (\fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4>، \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> و \fBkea\-dhcp\-ddns\fP \%<#\:std-iscman-kea-dhcp-ddns>) همگی
از یک کانال کنترلی که به عنوان سوکت UNIX پیاده‌سازی شده، پشتیبانی می‌کنند. این کانال کنترلی که یک سوکت UNIX باز می‌کند، به صورت پیش‌فرض غیرفعال است.
.SS آسیب‌پذیری Blast RADIUS
.sp
آسیب‌پذیری Blast\-RADIUS نقصی است که بر پروتکل RADIUS پیاده‌سازی‌شده توسط
کتابخانه قلاب RADIUS تأثیر می‌گذارد. برای جزئیات بیشتر، هشدار امنیتی \%<#\:radius-security-warning> را ببینید.
.SS بررسی خط‌مشی امنیتی زمان اجرای Kea
.sp
بررسی خط‌مشی امنیتی در زمان اجرا ابتدا در نسخه 2.7.9 Kea به دیمن‌های Kea شامل \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4>،
\fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> و \fBkea\-dhcp\-ddns\fP \%<#\:std-iscman-kea-dhcp-ddns>\& اضافه شد. در Kea 3.0 بررسی‌های بیشتری افزوده شدند. به طور پیش‌فرض،
هنگامی که یک دیمن نقض خط‌مشی امنیتی را تشخیص می‌دهد، یک پیام خطای لاگ ارسال کرده و خارج می‌شود. بررسی‌های زیر
انجام می‌شوند:
.INDENT 0.0
.IP \(bu 2
استفاده از مسیرهای فایل یا مجوزهای پشتیبانی‌نشده بر اساس جزئیات ارائه‌شده در خلاصه محدودیت‌های مسیر
.IP \(bu 2
استفاده از عبارت متنی واضح (clear text) برای \(aquser\(aq یا \(aqpassword\(aq در احراز هویت HTTP (در Kea 3.0)
.IP \(bu 2
استفاده از عبارت متنی واضح برای \(aqsecret\(aq در پیکربندی کلید TSIG (در Kea 3.0)
.IP \(bu 2
استفاده از کانال‌های API پروتکل HTTP بدون احراز هویت (در Kea 3.0)
.IP \(bu 2
اجرای سرور Kea تحت کاربر root. (توجه داشته باشید که این مورد تنها یک لاگ هشدار ایجاد می‌کند و هرگز متوقف‌کننده نیست)
.UNINDENT
.sp
از نسخه 3.0 Kea، راه‌اندازی دیمن‌ها با گزینه خط فرمان \(aq\-X\(aq به آن‌ها دستور می‌دهد
که در مورد خطرات امنیتی هشدار دهند اما در هر صورت به کار خود ادامه دهند.
شناسه‌های پیام برای تمام این هشدارها به پسوند \(dq_SECURITY_WARNING\(dq ختم می‌شوند.
.sp
\fBهشدار:\fP
.INDENT 0.0
.INDENT 3.5
سرورها را بدون ارزیابی دقیق و اعمال اقدامات احتیاطی لازم با گزینه \(aq\-X\(aq
اجرا نکنید. عدم رعایت این نکته می‌تواند استقرارها را در معرض آسیب‌پذیری‌های
امنیتی قرار دهد.
.UNINDENT
.UNINDENT.SS فرآیندهای امنیتی Kea
.sp
بخش‌های زیر نحوه اطمینان تیم توسعه Kea DHCP از کیفیت کد و مدیریت آسیب‌پذیری‌ها را شرح می‌دهند.
.SS مدیریت آسیب‌پذیری‌ها (Vulnerability Handling)
.sp
مجموعه ISC مشارکت‌کننده‌ای باسابقه و فعال در فرآیند استاندارد صنعتی افشای آسیب‌پذیری‌ها است و مستندات دقیقی درباره فرآیندها و آسیب‌پذیری‌های نرم‌افزارهای ISC نگهداری می‌کند.
برای مشاهده خط‌مشی افشای نقایص نرم‌افزاری و آسیب‌پذیری‌های امنیتی ISC به \%<https://\:kb\:.isc\:.org/\:docs/\:aa-00861> مراجعه کنید.
.sp
در صورت بروز یک آسیب‌پذیری امنیتی در Kea، ISC پیش از هرگونه افشای عمومی، به مشتریان پشتیبانی اطلاع داده و وصله (patch) و/یا بسته نصبی به‌روزشده‌ای را برای رفع آسیب‌پذیری ارائه می‌دهد.
.sp
هنگامی که یک به‌روزرسانی امنیتی منتشر می‌شود، فایل‌های فشرده سورس (tarball) و بسته‌های نگهداری‌شده توسط ISC در همان روز منتشر می‌گردند. این امر کاربران سازوکارهای به‌روزرسانی بومی لینوکس (مانند apt در Debian و Ubuntu یا dnf در RedHat) را قادر می‌سازد تا سیستم‌های خود را فوراً به‌روزرسانی کنند.
.SS کیفیت کد و آزمایش (Code Quality and Testing)
.sp
پروژه Kea در طول فرآیند توسعه خود تحت آزمایش‌های گسترده‌ای قرار می‌گیرد. موارد زیر برخی از فرآیندهایی هستند که برای اطمینان از کیفیت مناسب کد استفاده می‌شوند:
.INDENT 0.0
.IP \(bu 2
هر خط کد پیش از پذیرفته شدن، از یک بازبینی رسمی (formal review) عبور می‌کند. فرآیند بازبینی مستند شده و به صورت عمومی در دسترس است.
.IP \(bu 2
تقریباً ۵۰٪ از کد منبع به آزمون‌های واحد (unit tests) اختصاص دارد. تا مه ۲۰۲۴، بیش از ۱۲۰۰۰ آزمون واحد وجود داشت و این تعداد با گذشت زمان در حال افزایش است. گذراندن آزمون‌های واحد برای commit کردن هر ویژگی جدید الزامی است.
.IP \(bu 2
حدود ۲۰۰۰ آزمون سیستم برای Kea وجود دارد. این آزمون‌ها هم وضعیت‌های صحیح و هم وضعیت‌های نامعتبر را شبیه‌سازی می‌کنند و بسته‌های شبکه (عمدتاً DHCP، و همچنین DNS، HTTP، HTTPS و غیره)، استفاده از خط فرمان، فراخوانی‌های API، تعاملات پایگاه داده، اسکریپت‌ها و موارد دیگر را پوشش می‌دهند.
.IP \(bu 2
آزمون‌های کارایی با بیش از ۸۰ سناریو وجود دارند که کارایی کلی و تاب‌آوری Kea را در سطوح مختلف ترافیک می‌سنجند و معیارهای گوناگونی را اندازه‌گیری می‌کنند (تأخیر، اجاره‌ها بر ثانیه، بسته‌ها بر ثانیه، مصرف CPU، بهره‌وری حافظه و موارد دیگر).
.IP \(bu 2
پروژه Kea از یکپارچه‌سازی مداوم (CI) استفاده می‌کند. این بدان معناست که بخش عمده آزمایش‌ها (همه آزمون‌های واحد و سیستم، و در برخی موارد آزمون‌های کارایی) به ازای هر commit اجرا می‌شوند. بسیاری از آزمایش‌های \(dqسبک‌تر\(dq روی شاخه‌ها، حتی پیش از پذیرفته شدن کد اجرا می‌شوند.
.IP \(bu 2
بسیاری از آزمون‌های واحد و سیستم سناریوهای منفی را بررسی می‌کنند؛ مانند بسته‌ها، دستورات API و فایل‌های پیکربندی ناقص، خراب یا بریده‌شده (truncated)، و همچنین توالی‌های نادرست (مانند ارسال بسته‌ها با ترتیبی نامعتبر) و موارد دیگر.
.IP \(bu 2
تیم توسعه Kea از ابزارهای متعددی استفاده می‌کند که بررسی‌های خودکار کیفیت کد را انجام می‌دهند، مانند danger و همچنین ابزارهای بررسی سلامت (sanity checkers) که در داخل تیم توسعه یافته‌اند.
.IP \(bu 2
تیم Kea از تحلیل‌گرهای ایستای کد (static code analyzers) زیر استفاده می‌کند: Coverity Scan، cppcheck، clang\-static\-analyzer، shellcheck، flawfinder، semgrep و danger.
.IP \(bu 2
تیم Kea از تحلیل‌گرهای پویای کد (dynamic code analyzers) زیر استفاده می‌کند: Valgrind، Thread Sanitizer (TSAN)، Address Sanitizer (ASAN) و Undefined Behavior Sanitizer (UBSAN).
.UNINDENT
.SS آزمون فازینگ (Fuzz Testing)
.sp
تیم Kea فرآیندی برای اجرای آزمون فازینگ دارد.
فازینگ یک روش آزمون نرم‌افزار است که در آن داده‌های تولیدشده گوناگونی به عنوان ورودی به برنامه داده می‌شود و رفتارهای غیرعادی برنامه مانند فروپاشی (crash) یا قفل کردن (hang) مورد پایش قرار می‌گیرد.
.sp
دو روش برای فاز کردن Kea وجود دارد:
.sp
گزینه ۱. با تابع مهارکننده (harness function) مربوط به libfuzzer به نام LLVMFuzzerTestOneInput.
.sp
گزینه ۲. با کامپایلر AFL (American Fuzzy Lop \%<https://\:github\:.com/\:google/\:AFL>).
.sp
استفاده از تابع مهارکننده LLVMFuzzerTestOneInput:
.sp
این حالت از فازینگ تقریباً با هر کامپایلری کار می‌کند.
.sp
چهار نوع فازر در این حالت پیاده‌سازی شده است:
.INDENT 0.0
.IP \(bu 2
فازر Config
.IP \(bu 2
فازر نقطه پایانی HTTP
.IP \(bu 2
فازر Packet
.IP \(bu 2
فازر سوکت Unix
.UNINDENT
.sp
دو فایل باینری تحت آزمون وجود دارند:
.INDENT 0.0
.IP \(bu 2
\fIkea\-dhcp4\fP
.IP \(bu 2
\fIkea\-dhcp6\fP
.UNINDENT
.SS یکپارچگی انتشار (Release Integrity)
.sp
تمام نسخه‌های منتشرشده نرم‌افزارهای ISC با PGP امضا شده و از طریق وب‌سایت ISC توزیع می‌شوند؛ وب‌سایتی که خود با DNSSEC امضا شده است، بنابراین کاربران می‌توانند مطمئن باشند که در نرم‌افزار دستکاری صورت نگرفته است.
.SS ضریب اتوبوس (Bus Factor)
.sp
طبق اعلام پروژه Core Infrastructure \%<https://\:bestpractices\:.coreinfrastructure\:.org>، \(dqضریب اتوبوس\(dq یا \(dqضریب کامیون\(dq حداقل تعداد اعضای پروژه است که باید ناگهان از پروژه ناپدید شوند (\(dqبا یک اتوبوس تصادف کنند\(dq) قبل از اینکه پروژه به دلیل کمبود افراد آگاه یا دارای صلاحیت متوقف شود. تخمین دقیق آن دشوار است، اما ضریب اتوبوس برای Kea حدود پنج نفر است. تا سال ۲۰۲۱، شش توسعه‌دهنده اصلی و دو مهندس تضمین کیفیت به همراه مشارکت‌کنندگان جانبی متعدد (مدیر محصول، تیم پشتیبانی، IT و غیره) وجود دارند. این تیم از نظر جغرافیایی پراکنده است.
.SS متفرقه (Miscellaneous)
.SS ایجاد فایل‌های core dump
.sp
کرنل‌ها در صورت فعال بودن این ویژگی، هنگام فروپاشی یک فرآیند یا دریافت سیگنالی متناظر با این عمل، فایل‌های core dump ایجاد می‌کنند. روش فعال‌سازی فایل‌های core dump وابسته به سیستم است، اما دارای کنترل‌های مشترکی نظیر محدودیت \fBcoredumpsize\fP یا \fBcore file size\fP است که می‌توان آن‌ها را با استفاده از دستورات \fBulimit\fP یا \fBlimit\fP یا دستورات توکار شل مشاهده کرد و تغییر داد.
.sp
مستند پایگاه دانش با عنوان «What to do if your BIND, Kea DHCP, Stork, or ISC DHCP server has crashed» در \%<https://\:kb\:.isc\:.org/\:docs/\:aa-00340> جزئیات مربوط به هر سیستم را در بخش \fIThings to check if a core file does not get generated\fP توضیح می‌دهد.
.sp
روش دیگر برای ایجاد یک فایل core dump، دستور \fBgcore\fP است که چنین فایل‌ها / ایمیج‌هایی را از یک فرآیند در حال اجرا ایجاد می‌کند. لطفاً برای درک نحوه استفاده از آن، به صفحه راهنمای آن مراجعه کنید. دو نکته حائز اهمیت است:
.INDENT 0.0
.IP \(bu 2
آیا \fBgcore\fP فرآیندی را که از آن dump گرفته می‌شود معلق (suspend) می‌کند یا گزینه‌ای برای تعلیق آن ارائه می‌دهد؟
.IP \(bu 2
نام فایل core dump تولیدشده (که برای فایل‌های core dump ایجادشده توسط هسته نیز کاربرد دارد).
.UNINDENT
.sp
\fBهشدار:\fP
.INDENT 0.0
.INDENT 3.5
توجه داشته باشید که فایل‌های core dump ممکن است بسیار حجیم باشند و به راحتی سیستم فایلی که در آن ذخیره می‌شوند را پر کنند... برای مثال فراموش نکنید در صورتی که نیازی به این ویژگی نیست یا دیگر نیازی به آن ندارید، آن را فعال رها نکنید.
.UNINDENT
.UNINDENT.SH "پیکربندی KEA (KEA CONFIGURATION)"
.sp
‏Kea از ساختارهای JSON برای نمایش پیکربندی‌های کارساز استفاده می‌کند. بخش‌های زیر نحوه سازمان‌دهی این ساختارهای پیکربندی را شرح می‌دهند.
.SS "پیکربندی JSON (JSON Configuration)"
.sp
‏JSON نشانه‌گذاری مورد استفاده در سراسر پروژه Kea است. آشکارترین کاربرد آن برای فایل پیکربندی است، اما از JSON برای ارسال دستورها از طریق Management API (ببینید: Management API \%<#\:ctrl-channel>) و ارتباط بین کارسازهای DHCP و دیمن به‌روزرسانی DDNS نیز استفاده می‌شود.
.sp
کاربرد معمول بر این فرض است که کارسازها از خط فرمان، به‌صورت مستقیم یا با استفاده از یک اسکریپت مانند \fBkeactrl\fP \%<#\:std-iscman-keactrl>\& راه‌اندازی می‌شوند. فایل پیکربندی هنگام راه‌اندازی با استفاده از پارامتر \fB\-c\fP مشخص می‌شود.
.SS "نحو JSON (JSON Syntax)"
.sp
فایل‌های پیکربندی برای ماژول‌های DHCPv4، DHCPv6، DDNS و NETCONF در قالب گسترش‌یافته‌ای از JSON تعریف می‌شوند. نگارش پایه JSON در RFC 7159 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc7159> و ECMA 404 \%<https://\:www\:.ecma-international\:.org/\:publications/\:standards/\:Ecma-404\:.htm>\& تعریف شده است. به‌ویژه، تنها مقادیر بولی مجاز true یا false (تماماً با حروف کوچک) هستند. نگارش‌های با حروف بزرگ (True یا False) پذیرفته نمی‌شوند.
.sp
اگرچه استاندارد JSON (یا ECMA 404) نیازی ندارد که اشیای JSON (یعنی نگاشت‌های نام/مقدار) ورودی‌های یکتا داشته باشند، Kea آن‌ها را با استفاده از map در C++ STL با ورودی‌های یکتا پیاده‌سازی می‌کند. از این رو، اگر چندین مقدار برای یک نام در یک شیء/نگاشت وجود داشته باشد، آخرین مقدار بر مقادیر قبلی بازنویسی می‌شود. از نسخه Kea 1.9.0 به بعد، تجزیه‌کننده‌های فایل پیکربندی در چنین مواردی خطای نحو برمی‌انگیزند.
.sp
مؤلفه‌های Kea از JSON گسترش‌یافته با قابلیت‌های اضافی مجاز زیر استفاده می‌کنند:
.INDENT 0.0
.IP \(bu 2
کامنت‌های شل: هر متنی پس از نویسه هش (#) نادیده گرفته می‌شود.
.IP \(bu 2
کامنت‌های C: هر متنی پس از نویسه دو اسلش (//) نادیده گرفته می‌شود.
.IP \(bu 2
کامنت‌های چندخطی: هر متنی بین /* و */ نادیده گرفته می‌شود. این کامنت می‌تواند در چند خط امتداد یابد.
.IP \(bu 2
شامل‌سازی فایل: فایل‌های JSON می‌توانند فایل‌های JSON دیگر را با استفاده از گزاره‌ای به شکل <?include \(dqfile.json\(dq?> شامل شوند.
.IP \(bu 2
ویرگول‌های اضافی: جهت رفع مشکل خطاهای ناشی از ویرگول‌های باقی‌مانده پس از اعمال تغییرات در پیکربندی. هنگام تجزیه، هشداری همراه با مکان ویرگول چاپ می‌شود تا به کاربر امکان اصلاح اشتباه احتمالی داده شود.
.UNINDENT
.sp
\fBهشدار:\fP
.INDENT 0.0
.INDENT 3.5
این قابلیت‌ها برای استفاده در فایل پیکربندی JSON در نظر گرفته شده‌اند. استفاده از آن‌ها به هر روش دیگر ممکن است به بروز خطا منجر شود.
.UNINDENT
.UNINDENT
.sp
فایل پیکربندی از یک شیء منفرد (که اغلب در اصطلاح عامیانه نگاشت نامیده می‌شود) تشکیل شده است که با یک آکوالاد باز شروع می‌شود. این فایل تنها شامل یکی از اشیای \(dqDhcp4\(dq، \(dqDhcp6\(dq، \(dqDhcpDdns\(dq یا \(dqNetconf\(dq است. تعریف عناصر اضافی امکان‌پذیر است اما نادیده گرفته خواهند شد.
.sp
یک پیکربندی بسیار ساده برای DHCPv4 می‌تواند به این شکل باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# The whole configuration starts here.
{
    # DHCPv4 specific configuration starts here.
    \(dqDhcp4\(dq: {
        \(dqinterfaces\-config\(dq: {
            \(dqinterfaces\(dq: [ \(dqeth0\(dq ],
            \(dqdhcp\-socket\-type\(dq: \(dqraw\(dq
        },
        \(dqvalid\-lifetime\(dq: 4000,
        \(dqrenew\-timer\(dq: 1000,
        \(dqrebind\-timer\(dq: 2000,
        \(dqsubnet4\(dq: [{
           \(dqpools\(dq: [ { \(dqpool\(dq: \(dq192.0.2.1\-192.0.2.200\(dq } ],
           \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
           \(dqid\(dq: 1
        }],

       # Now loggers are inside the DHCPv4 object.
       \(dqloggers\(dq: [{
            \(dqname\(dq: \(dq*\(dq,
            \(dqseverity\(dq: \(dqDEBUG\(dq
        }]
    }

# The whole configuration structure ends here.
}
.EE
.UNINDENT
.UNINDENT
.sp
مثال‌های بیشتر در دایرکتوری نصب‌شده \fBshare/doc/kea/examples\fP در دسترس هستند.
.sp
برای جلوگیری از تکرار ساختارهای عمدتاً مشابه، مثال‌های بخش‌های بعدی این راهنما تنها زیرمجموعه‌ای از پارامترهای مناسب برای یک بافت مشخص را نمایش می‌دهند. برای مثال، هنگام بحث درباره پیکربندی زیرشبکه‌های IPv6 در DHCPv6، تنها پارامترهای subnet6 ذکر خواهند شد. بدیهی است که سایر عناصر (نگاشت سراسری که شامل Dhcp6 است) وجود دارند، اما برای وضوح بیشتر حذف شده‌اند. معمولاً مکان‌هایی که پارامترهای اضافی ممکن است ظاهر شوند با سه‌نقطه (...) مشخص شده‌اند.
.SS "کامنت‌ها و بافت کاربری (Comments and User Context)"
.sp
در صورتی که فایل پیکربندی JSON به‌صورت محلی استفاده شود، کامنت‌های به سبک شل، C یا C++ همگی در آن مجاز هستند. این روش راحت است و در موارد ساده‌ای که پیکربندی به‌صورت ایستا با استفاده از یک فایل محلی نگهداری می‌شود کارایی دارد. با این حال، از آنجا که کامنت‌ها بخشی از نحو JSON نیستند، بیشتر ابزارهای JSON آن‌ها را به عنوان خطا تشخیص می‌دهند. مشکل دیگر این است که به محض بارگیری پیکربندی توسط Kea، کامنت‌های به سبک شل، C و C++ نادیده گرفته می‌شوند. اگر دستورهایی مانند \fBconfig\-get\fP \%<#\:std-isccmd-config-get> یا \fBconfig\-write\fP \%<#\:std-isccmd-config-write> استفاده شوند، آن کامنت‌ها از دست می‌روند. نمونه‌ای از این کامنت‌ها در بخش پیشین ارائه شد.
.sp
از نظر تاریخی، برای رفع این مشکل، کد Kea استفاده از رشته‌های \fIcomment\fP را به عنوان موجودیت‌های معتبر JSON مجاز دانست. این ویژگی این مزیت را داشت که در طول عملیات مختلف (مانند \fBconfig\-get\fP \%<#\:std-isccmd-config-get>) حفظ می‌شد یا امکان پردازش توسط ابزارهای JSON را فراهم می‌کرد. نمونه‌ای از یک کامنت JSON بدین صورت است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqsubnet4\(dq: [{
        \(dqid\(dq: 1,
        \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
        \(dqpools\(dq: [{ \(dqpool\(dq: \(dq192.0.2.10 \- 192.0.2.20\(dq }],
        \(dqcomment\(dq: \(dqsecond floor\(dq
    }]
}
.EE
.UNINDENT
.UNINDENT
.sp
با این حال، این واقعیت که کامنت تنها می‌توانست تک‌خطی باشد و امکان افزودن اطلاعات دیگر در قالبی ساختاریافته‌تر وجود نداشت، ناامیدکننده بود. یک نمونه مشخص، درخواست برای افزودن شماره طبقات و ساختمان‌ها به زیرشبکه‌ها بود. این امر یکی از دلایلی بود که مفهوم بافت کاربری (user context) معرفی شد؛ مفهومی که اجازه افزودن یک ساختار دلخواه JSON را به اکثر ساختارهای پیکربندی Kea می‌دهد.
.sp
این روش در مقایسه با رویکردهای پیشین مزایای متعددی دارد. اولاً کاملاً با ابزارهای JSON و دستورهای Kea سازگار است. ثانیاً علاوه بر ذخیره رشته‌های ساده کامنت، می‌تواند داده‌های بسیار پیچیده‌تری را ذخیره کند، مانند چند خط (به‌صورت آرایه‌ای از رشته‌ها)، داده‌های نوع‌دار اضافی (مانند شماره طبقات به‌صورت عددی واقعی) و موارد دیگر. ثالثاً این داده‌ها در دسترس قلاب‌ها قرار می‌گیرند، بنابراین امکان توسعه قلاب‌های شخص ثالث که از این اطلاعات اضافی بهره می‌برند وجود دارد. نمونه‌ای از یک بافت کاربری بدین شکل است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqsubnet4\(dq: [{
        \(dqid\(dq: 1,
        \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
        \(dqpools\(dq: [{ \(dqpool\(dq: \(dq192.0.2.10 \- 192.0.2.20\(dq }],
        \(dquser\-context\(dq: {
            \(dqcomment\(dq: \(dqsecond floor\(dq,
            \(dqfloor\(dq: 2
        }
    }]
}
.EE
.UNINDENT
.UNINDENT
.sp
بافت‌های کاربری تا زمانی که از نحو معتبر JSON پیروی کنند و عنصر سطح بالای آن‌ها یک نگاشت باشد (یعنی داده‌ها باید درون آکوالاد قرار گیرند)، می‌توانند هر فایل داده دلخواهی را ذخیره کنند. با این حال، برخی از کتابخانه‌های قلاب ممکن است قالب‌بندی خاصی را انتظار داشته باشند؛ لطفاً برای جزئیات به مستندات کتابخانه قلاب مربوطه مراجعه کنید.
.sp
سازوکار user\-context جایگزین قابلیت‌های کامنت JSON شده است؛ ISC به مدیران سیستم توصیه می‌کند به‌جای سازوکارهای قدیمی‌تر، از user context استفاده کنند. برای ترویج این شیوه ذخیره کامنت‌ها، Kea کامنت‌های JSON را به‌صورت خودکار و بلادرنگ به user context تبدیل می‌کند.
.sp
با این حال، اگر پیکربندی از روش قدیمی کامنت JSON استفاده کند، دستور \fBconfig\-get\fP \%<#\:std-isccmd-config-get> یک پیکربندی اندکی تغییریافته را برمی‌گرداند. این مورد غیرمعمول نیست که فراخوانی \fBconfig\-set\fP \%<#\:std-isccmd-config-set> و به دنبال آن \fBconfig\-get\fP \%<#\:std-isccmd-config-get> ساختاری کمی متفاوت را دریافت کند. بهترین راه برای جلوگیری از این مشکل این است که استفاده از کامنت‌های JSON را کنار گذاشته و از user context استفاده کنید.
.sp
‏Kea از بافت‌های کاربری در سطوح زیر پشتیبانی می‌کند: دامنه سراسری (global scope)، پیکربندی رابط‌ها (interfaces configuration)، چندریسمانی (multi\-threading)، شبکه‌های اشتراکی (shared networks)، زیرشبکه‌ها (subnets)، کلاس‌های کلاینت (client classes)، داده‌ها و تعاریف گزینه‌ها (option data and definitions)، استخرها (pools)، استخرهای واگذاری پیشوند (prefix delegation pools)، رزروهای میزبان (host reservations)، سوکت کنترل (control socket)، سرآیند HTTP، احراز هویت (authentication)، کلاینت‌ها (clients)، کنترل صف (queue control)، ‏DHCP\-DDNS، ثبت‌کننده‌ها (loggers)، اجاره‌ها (leases) و شناسه سرور (server ID). این موارد در هر دو DHCPv4 و DHCPv6 پشتیبانی می‌شوند، به استثنای استخرهای واگذاری پیشوند و شناسه سرور که تنها مختص DHCPv6 هستند.
.sp
بافت کاربری را می‌توان در ساختارهای پشتیبانی‌شده توسط دستورها افزود و ویرایش کرد.
.sp
ما کاربران Kea را تشویق می‌کنیم که از این توابع برای ذخیره اطلاعات مورد استفاده سایر سامانه‌ها و قلاب‌های سفارشی استفاده کنند.
.sp
برای مثال، می‌توان از دستور \fBsubnet4\-update\fP \%<#\:std-isccmd-subnet4-update> برای افزودن داده‌های بافت کاربری به یک زیرشبکه موجود استفاده کرد.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
\(dqsubnet4\(dq: [ {
   \(dqid\(dq: 1,
   \(dqsubnet\(dq: \(dq10.20.30.0/24\(dq,
   \(dquser\-context\(dq: {
      \(dqbuilding\(dq: \(dqMain\(dq,
      \(dqfloor\(dq: 1
      }
 } ]
 }
.EE
.UNINDENT
.UNINDENT
.sp
همین کار را می‌توان با بسیاری از دستورهای دیگر، مانند \fBlease6\-add\fP \%<#\:std-isccmd-lease6-add> و غیره نیز انجام داد.
.sp
‏Kea همچنین از بافت کاربری برای ذخیره داده‌های غیراستاندارد استفاده می‌کند. در حال حاضر، تنها Storing Extended Lease Information \%<#\:dhcp4-store-extended-info> از این قابلیت استفاده می‌کند.
.sp
در صورت فعال بودن، کلید ISC در \fBuser\-context\fP اضافه می‌شود تا محتوای اضافه‌شده خودکار را متمایز کند.
.sp
نمونه‌ای از اطلاعات رله ذخیره‌شده در یک اجاره:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
\(dqarguments\(dq: {
   \(dqclient\-id\(dq: \(dq42:42:42:42:42:42:42:42\(dq,
   \(dqcltt\(dq: 12345678,
   \(dqfqdn\-fwd\(dq: false,
   \(dqfqdn\-rev\(dq: true,
   \(dqhostname\(dq: \(dqmyhost.example.com.\(dq,
   \(dqhw\-address\(dq: \(dq08:08:08:08:08:08\(dq,
   \(dqip\-address\(dq: \(dq192.0.2.1\(dq,
   \(dqstate\(dq: 0,
   \(dqsubnet\-id\(dq: 44,
   \(dqvalid\-lft\(dq: 3600,
   \(dquser\-context\(dq: {
      \(dqISC\(dq: {
      \(dqrelays\(dq: [
      {
            \(dqhop\(dq: 2,
            \(dqlink\(dq: \(dq2001:db8::1\(dq,
            \(dqpeer\(dq: \(dq2001:db8::2\(dq
      },
      {
            \(dqhop\(dq: 1,
            \(dqlink\(dq: \(dq2001:db8::3\(dq,
            \(dqoptions\(dq: \(dq0x00C800080102030405060708\(dq,
            \(dqpeer\(dq: \(dq2001:db8::4\(dq
      }]
      }
   }
}
}
.EE
.UNINDENT
.UNINDENT
.sp
بافت کاربری می‌تواند پیکربندی مربوط به چندین قلاب و کامنت را به‌طور هم‌زمان ذخیره کند.
.sp
برای بررسی نحوه استفاده از بافت کاربری در قلاب‌ها، به User Contexts in Hooks \%<#\:user-context-hooks>\& مراجعه کنید..SS "نشانه‌گذاری ساده‌شده (Simplified Notation)"
.sp
گاهی اوقات ارجاع به یک عنصر خاص در سلسله‌مراتب پیکربندی راحت‌تر است. هر سطح سلسله‌مراتب با یک اسلش جدا می‌شود.
اگر آرایه‌ای وجود داشته باشد، به نمونه‌ای خاص درون آن آرایه با عددی در داخل قلاب‌ها ارجاع داده می‌شود (با شماره‌گذاری که از
صفر آغاز می‌شود). برای نمونه، در پیکربندی بالا، valid\-lifetime در مؤلفه
Dhcp4 می‌تواند به‌صورت Dhcp4/valid\-lifetime، و pool
در نخستین زیرشبکه تعریف‌شده در پیکربندی DHCPv4 به‌صورت
Dhcp4/subnet4[0]/pool ارجاع داده شود.
.SS "گنجاندن فایل‌های پیکربندی (Configuration Files Inclusion)"
.sp
تجزیه‌کننده قابلیت گنجاندن فایل‌ها را فراهم می‌آورد. نحو دستور به‌گونه‌ای انتخاب شده است
که شبیه به نحوه گنجاندن اسکریپت‌های PHP در کد HTML توسط Apache به نظر برسد. این نحو
خاص برای تأکید بر این موضوع انتخاب شده است که دستور include یک ویژگی اضافی است
و بخشی از نحو JSON به شمار نمی‌رود.
.sp
گنجاندن به‌صورت پشته‌ای از فایل‌ها پیاده‌سازی شده است. می‌توانید از دستور include
در گنجاندن‌های تودرتو استفاده کنید. حداکثر ده سطح تودرتویی پشتیبانی می‌شود. این محدودیت
که به‌طور دلخواه انتخاب شده، محافظتی در برابر گنجاندن‌های بازگشتی است.
.sp
دستور include فرم زیر را دارد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
<?include \(dq[PATH]\(dq?>
.EE
.UNINDENT
.UNINDENT
.sp
الگوی \fI[PATH]\fP باید با یک مسیر مطلق یا یک مسیر نسبت به
دایرکتوری کاری جاری در زمان اجرای فرایند Kea جایگزین شود.
.sp
برای گنجاندن یک فایل درون فایلی دیگر، از نحو زیر استفاده کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
   \(dqDhcp6\(dq: {
      \(dqinterfaces\-config\(dq: {
         \(dqinterfaces\(dq: [ \(dq*\(dq ]},
      \(dqpreferred\-lifetime\(dq: 3000,
      \(dqrebind\-timer\(dq: 2000,
      \(dqrenew\-timer\(dq: 1000,
      <?include \(dqsubnets.json\(dq?>
      \(dqvalid\-lifetime\(dq: 4000
   }
}
.EE
.UNINDENT
.UNINDENT
.sp
جایی که محتوای \(dqsubnets.json\(dq می‌تواند چنین باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
\(dqsubnet4\(dq: [
   {
      \(dqid\(dq: 123,
      \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq
   },
   {
      \(dqid\(dq: 234,
      \(dqsubnet\(dq: \(dq192.0.3.0/24\(dq
   },
   {
      \(dqid\(dq: 345,
      \(dqsubnet\(dq: \(dq10.0.0.0/8\(dq
   }
],
\&...
}
.EE
.UNINDENT
.UNINDENT
.SS "پس‌زمینه پیکربندی Kea (Kea Configuration Backend)"
.SS "کاربردپذیری (Applicability)"
.sp
پس‌زمینه پیکربندی Kea (به اختصار CB یا config backend) به سرورهای Kea این
قابلیت را می‌دهد تا تقریباً همه پیکربندی خود را در یک یا چند پایگاه‌داده ذخیره کنند.
.sp
ویژگی‌ها و مزایای بالقوه شامل موارد زیر است:
.INDENT 0.0
.IP \(bu 2
استفاده مجدد از بخش‌های پیکربندی یکسان در چندین سرور Kea
.IP \(bu 2
یک \(dqمنبع واحد حقیقت\(dq برای همه سرورهای Kea
.IP \(bu 2
انجام تمام پیکربندی‌ها از طریق یک API به همراه بررسی‌های منطقی بی‌درنگ
.IP \(bu 2
یکپارچه‌سازی آسان‌تر با ابزارهای شخص ثالث یا خودکارسازی‌های درون‌سازمانی
.IP \(bu 2
معماری پایگاه‌داده همزمانی، سازگاری و تفکیک‌ناپذیری (atomicity) را فراهم می‌کند
.IP \(bu 2
قابلیت کاوش در پایگاه‌داده برای استخراج آمار و گزارش‌گیری
.IP \(bu 2
استفاده از همانندسازی (replication) پایگاه‌داده برای تحمل خطای بی‌درنگ
.UNINDENT
.sp
معایب بالقوه شامل موارد زیر است:
.INDENT 0.0
.IP \(bu 2
تلاش اولیه قابل‌توجه برای آماده‌سازی یکپارچه‌سازی و/یا خودکارسازی
.IP \(bu 2
سناریوهای پشتیبانی‌شده برای بیشتر پیکربندی‌ها به استفاده از API نیاز دارند
.IP \(bu 2
این API تنها برای مشتریان ISC با یک قرارداد پشتیبانی پولی در دسترس است
.IP \(bu 2
ناسازگار با برخی کاربردها، نرم‌افزارها و سناریوها
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
استفاده از یک پایگاه‌داده برای ذخیره‌سازی اجاره‌ها (leases) و/یا رزروهای میزبان (host reservations)
بدون استفاده از CB امکان‌پذیر است. دستورالعمل‌های پیکربندی \fBhost\-databases\fP و
\fBlease\-database\fP را ببینید.
.UNINDENT
.UNINDENT.SS سناریوی نمونه
.sp
سازمان بزرگی را با چندین شعبه (site) در نظر بگیرید که در هر یک، یک جفت کارساز Kea در پیکربندی دسترسی‌پذیری بالا (HA) مستقر شده است. معمولاً چنین استقرارهایی از پیکربندی‌های استانداردسازی‌شده استفاده می‌کنند که منجر به پارامترهای پیکربندی مشابه برای هر شعبه می‌شود. اعضای هر جفت HA اغلب تقریباً کاملاً یکسان هستند و فقط در نام با یکدیگر تفاوت دارند. اغلب استقرارهایی با این ابعاد از سطح بالایی از اتوماسیون، شامل سامانه‌های تدارک (provisioning) و مدیریت بهره می‌برند.
.sp
بک‌اند پیکربندی (CB) برای چنین استقرارهایی ایده‌آل است. اگرچه ادغام آن با اتوماسیون تدارک به مقداری تلاش نیاز دارد، اما پس از انجام، استقرار کارسازهای جدید Kea می‌تواند تقریباً خودکار باشد. می‌توان از یک پیکربندی JSON اولیه و حداقلی (\(dqstub\(dq) که برای هر کارساز یکسان است استفاده کرد و تمام پیکربندی‌های باقی‌مانده (شبکه‌های مشترک، زیرشبکه‌ها، استخرها و غیره) را از پایگاه‌داده مرکزی CB بارگذاری نمود. هرگونه به‌روزرسانی در پایگاه‌داده مرکزی CB به‌طور خودکار به تمام نمونه‌های Kea منتشر می‌شود. بدین ترتیب CB به \(dqتنها منبع حقیقت\(dq (single source of truth) برای DHCP در سراسر سازمان تبدیل می‌شود.
.SS محدودیت‌ها و هشدارها
.SS دسترسی‌پذیری
.sp
\fBlibdhcp_cb_cmds.so\fP \%<#\:std-ischooklib-libdhcp_cb_cmds\:.so> تنها برای مشتریان ISC با قرارداد پشتیبانی تجاری در دسترس است. برای کسب اطلاعات بیشتر درباره گزینه‌های اشتراک، لطفاً فرم موجود در \%<https://\:www\:.isc\:.org/\:contact>\& را تکمیل کنید. اگرچه از نظر تئوری استفاده از CB بدون این قلاب (hook) امکان‌پذیر است، اما این کار نه پشتیبانی می‌شود و نه توصیه می‌گردد.
.SS نیازمندی به آماده‌سازی
.sp
بک‌اند پیکربندی (Configuration Backend) یک راهکار آماده و خودکار (\(dqplug\-and\-play\(dq) نیست. سناریوهای پشتیبانی‌شده به استفاده از دستورهای CB API نیاز دارند. اطلاعات پیکربندی باید با استفاده از API در پایگاه‌داده CB بارگذاری شوند تا CB تأثیرگذار باشد. هدف کلی این است که CB به عنوان بخشی از یک راهکار تدارک (provisioning) بزرگ‌تر یکپارچه شود. لطفاً تا زمانی که کارهای آماده‌سازی لازم را انجام نداده‌اید، \fBconfig\-databases\fP را تعریف نکنید.
.SS مدیریت پایگاه‌داده
.sp
تنها روش پشتیبانی‌شده برای مدیریت محتوای پایگاه‌داده CB، از طریق قلاب \fBlibdhcp_cb_cmds.so\fP \%<#\:std-ischooklib-libdhcp_cb_cmds\:.so> است که دستورهای API را برای بک‌اندهای پیکربندی ارائه می‌دهد. از نظر عملی، برای استفاده از CB، باید تقریباً تمام پیکربندی Kea را از طریق CB API انجام دهید.
.sp
اگرچه از نظر تئوری امکان استفاده از CB بدون API (با استفاده از ابزارهایی مانند MySQL Workbench یا کلاینت خط فرمانی MySQL) وجود دارد، اما این روش‌ها نه توصیه می‌شوند و نه پشتیبانی دارند.
.SS تداخل‌های پیکربندی
.sp
ما قویاً توصیه می‌کنیم از ادغام اطلاعات پیکربندی CB و فایل پیکربندی JSON خودداری کنید. به عبارت دیگر، از هر دو روش تعاریف پیکربندی JSON و CB برای پیکربندی انواع یکسان اشیاء استفاده نکنید. در حالت ایده‌آل، هنگام استفاده از CB، فایل‌های پیکربندی Kea باید حاوی حداقل‌های ضروری مطلق باشند و هر چیز دیگری از طریق CB تأمین شود.
.sp
استفاده هم‌زمان از CB و JSON به عنوان منبع پیکربندی، خطر تداخل تعاریف را به همراه دارد. چنین تداخل‌هایی در بهترین حالت گیج‌کننده هستند و معمولاً منجر به رفتارهای ناخواسته یا بروز خطا از جانب Kea می‌شوند.
.sp
در صورت بروز تداخل، دستورالعمل‌های پیکربندی پایگاه‌داده CB معمولاً نسبت به دستورالعمل‌های فایل JSON اولویت دارند.
.sp
در برخی سناریوهای به‌دقت کنترل‌شده، ممکن است از نظر فنی استفاده از هر دو روش امکان‌پذیر باشد. به عنوان مثال، تعریف یک زیرشبکه در فایل JSON و زیرشبکه دوم (متفاوت) در پایگاه‌داده CB تداخلی ایجاد نمی‌کند. با این حال، ساختارهای دیگر به طور کامل جایگزین می‌شوند. برای مثال، اگر کلاس‌های کلاینت (client classes) در پایگاه‌داده CB تعریف شده باشند، کارساز DHCP تمام کلاس‌های کلاینت تعریف‌شده در فایل JSON را نادیده می‌گیرد.
.sp
به طور خلاصه، اگر از CB استفاده می‌کنید، باید تنها از CB استفاده کنید.
.SS نرم‌افزارهای ناسازگار
.sp
دستورهای API که پیکربندی Kea را تغییر می‌دهند (به غیر از CB API) منع شده‌اند. این شامل قلاب \fBlibdhcp_subnet_cmds.so\fP \%<#\:std-ischooklib-libdhcp_subnet_cmds\:.so> نیز می‌شود. توابع API این قلاب پیکربندی درون حافظه (in\-memory) کارساز Kea را تغییر می‌دهند و این تغییرات تنها با استفاده از \fBconfig\-write\fP جهت نوشتن یک فایل پیکربندی JSON جدید ماندگار می‌شوند.
.sp
مجموعه مدیریتی Stork \%<https://\:stork\:.readthedocs\:.io> در حال حاضر از CB پشتیبانی نمی‌کند. Stork تمامی تغییرات پیکربندی را از طریق روش‌های API انجام می‌دهد که انتظار دارند تغییرات در فایل پیکربندی JSON نوشته شوند. پشتیبانی از CB برای انتشار آینده Stork برنامه‌ریزی شده است.
.sp
در برخی سناریوهای به‌دقت کنترل‌شده، ممکن است استفاده از این ابزارها همراه با CB امکان‌پذیر باشد؛ به ویژه اگر به صورت کاملاً \(dqفقط‌خواندنی\(dq (read\-only) صرفاً برای بازیابی اطلاعات Kea و نه هرگز برای تغییر آن به کار روند. با این حال، هیچ محافظتی در برابر تغییرات تصادفی وجود ندارد، بنابراین این روش توصیه نمی‌شود.
.SS محدودیت‌ها
.sp
در حال حاضر، Kea CB دارای محدودیت‌های زیر است:
.INDENT 0.0
.IP \(bu 2
تنها برای پایگاه‌های داده MySQL و PostgreSQL پشتیبانی می‌شود.
.IP \(bu 2
تنها برای دیمن‌های DHCPv4 و DHCPv6 پشتیبانی می‌شود؛ دیمن D2 و دیمن NETCONF را نمی‌توان از پایگاه‌داده پیکربندی کرد.
.IP \(bu 2
تنها پارامترهای پیکربندی خاصی از DHCP را می‌توان در پایگاه‌داده تنظیم کرد: پارامترهای سراسری، تعاریف گزینه‌ها، گزینه‌های سراسری، کلاس‌های کلاینت، شبکه‌های مشترک و زیرشبکه‌ها. سایر پارامترهای پیکربندی باید از یک فایل پیکربندی JSON تأمین شوند.
.UNINDENT
.SS گزینه‌های سفارشی
.sp
استفاده از قالب‌های گزینه‌ سفارشی نیازمند ایجاد تعاریف برای این گزینه‌ها است. فرض کنید کاربری بخواهد داده‌های گزینه را در بک‌اند پیکربندی تنظیم کند. در این صورت، توصیه می‌کنیم تعریف مربوط به آن گزینه را نیز در بک‌اند پیکربندی مشخص نمایید. این امر زمانی ضروری است که چندین کارساز از طریق بک‌اند پیکربندی مدیریت می‌شوند و ممکن است پیکربندی‌های متفاوتی داشته باشند. تجزیه‌گر داده‌های گزینه می‌تواند تعاریف گزینه‌ای را جستجو کند که متناسب با کارسازی باشد که داده‌های گزینه برای آن تعیین شده است.
.sp
در یک استقرار تک‌کارساز، یا زمانی که همه کارسازها اطلاعات فایل پیکربندی یکسانی را به اشتراک می‌گذارند، می‌توان تعاریف گزینه‌ها را در فایل‌های پیکربندی و داده‌های گزینه را در بک‌اند پیکربندی مشخص کرد. کارسازی که دستوری برای تنظیم داده‌های گزینه دریافت می‌کند، حتی زمانی که داده‌های گزینه را برای کارساز دیگری تنظیم می‌کند، باید تعریفی معتبر در فایل پیکربندی خود داشته باشد.
.sp
مشخص کردن تعاریف گزینه‌ها در بک‌اند پیکربندی و داده‌های متناظر گزینه در فایل‌های پیکربندی کارساز پشتیبانی نمی‌شود.
.SS اجزاء
.sp
راهکار Kea Configuration Backend متشکل از ماژول‌های CB (کتابخانه‌های قلاب)، رابط برنامه‌نویسی دستورهای CB (کتابخانه قلاب اختصاصی خود)، نرم‌افزار پایگاه‌داده خارجی (MySQL یا PostgreSQL)، طرح‌واره (schema) پایگاه‌داده و اطلاعات پیکربندی Kea ذخیره‌شده در پایگاه‌داده است.
.sp
در این مستندات، اصطلاح \(dqConfiguration Backend\(dq ممکن است به ماژول خاصی از Kea نیز اشاره داشته باشد که پشتیبانی از آن نوع پایگاه‌داده را فراهم می‌کند. به عنوان مثال، بک‌اند پیکربندی MySQL، یعنی \fBlibdhcp_mysql.so\fP \%<#\:std-ischooklib-libdhcp_mysql\:.so>، مجموعه‌ای کامل از توابع را برای مدیریت و واکشی اطلاعات پیکربندی از یک پایگاه‌داده MySQL فراهم می‌سازد. بک‌اند پیکربندی PostgreSQL، یعنی \fBlibdhcp_pgsql.so\fP \%<#\:std-ischooklib-libdhcp_pgsql\:.so>، ماژول متناظر برای PostgreSQL است. به همین ترتیب، اصطلاح \(dqپایگاه‌داده\(dq برای اشاره به هر دو پایگاه‌داده MySQL یا PostgreSQL به کار می‌رود.
.sp
رابط برنامه‌نویسی دستورهای CB مجموعه‌ای کامل از دستورها را برای مدیریت اطلاعات پیکربندی Kea، همان‌گونه که در پایگاه‌داده ذخیره شده است، ارائه می‌دهد. این API در کتابخانه قلاب اختصاصی خود، یعنی \fBlibdhcp_cb_cmds.so\fP \%<#\:std-ischooklib-libdhcp_cb_cmds\:.so>\& پیاده‌سازی شده است. این کتابخانه را می‌توان به هر دو نمونه کارساز DHCPv4 و DHCPv6 متصل کرد. این ماژول بسیاری از عملیات متداول، مانند فهرست‌کردن، افزودن، واکشی و حذف پارامترهای سراسری، شبکه‌های مشترک، زیرشبکه‌ها، استخرها، گزینه‌ها، تعاریف گزینه‌ها و کلاس‌های کلاینت را ساده می‌کند. علاوه بر این، منطق تجاری ضروری را برای تضمین یکپارچگی منطقی داده‌ها فراهم می‌آورد. تمامی دستورهای CB API با \fBremote\-\fP\& آغاز می‌شوند. برای اطلاعات بیشتر به libdhcp_cb_cmds.so: Configuration Backend Commands \%<#\:hooks-cb-cmds> مراجعه کنید.
.sp
نصب و نگهداری نرم‌افزارهای پایگاه‌داده خارجی فراتر از حوزه این راهنما است.
.sp
طرح‌واره (schema) پایگاه‌داده معمولاً از طریق ابزار \fBkea\-admin\fP \%<#\:std-iscman-kea-admin> نصب می‌شود. برای اطلاعات بیشتر به Installation مراجعه کنید. اسکریپت‌های خام ایجاد طرح‌واره عبارتند از:
dhcpdb_create.mysql \%<https://\:gitlab\:.isc\:.org/\:isc-projects/\:kea/\:blob/\:master/\:src/\:share/\:database/\:scripts/\:mysql/\:dhcpdb_create\:.mysql>
و
dhcpdb_create.pgsql \%<https://\:gitlab\:.isc\:.org/\:isc-projects/\:kea/\:blob/\:master/\:src/\:share/\:database/\:scripts/\:pgsql/\:dhcpdb_create\:.pgsql>\&.
.sp
برای مقداردهی و پر کردن پایگاه‌داده با اطلاعات پیکربندی Kea، از API دستورهای CB استفاده کنید.
.sp
اسناد طراحی مرتبط در GitLab ما در دسترس هستند:
.INDENT 0.0
.IP \(bu 2
طراحی CB \%<https://\:gitlab\:.isc\:.org/\:isc-projects/\:kea/\:-/\:wikis/\:Designs/\:configuration-in-db-design>
.IP \(bu 2
طراحی کلاس‌های کلاینت در CB \%<https://\:gitlab\:.isc\:.org/\:isc-projects/\:kea/\:-/\:wikis/\:Designs/\:client-classes-in-cb>
.UNINDENT.SS "نصب (Installation)"
.sp
برای استفاده از هر یک از Backendهای پیکربندی، کتابخانهٔ ماژول مناسب
(\fBlibdhcp_mysql.so\fP \%<#\:std-ischooklib-libdhcp_mysql\:.so> یا \fBlibdhcp_pgsql.so\fP \%<#\:std-ischooklib-libdhcp_pgsql\:.so>) باید
در حین ساخت Kea کامپایل شود. سوییچ \fB\-D\fP مشخص می‌کند که در صورت وجود،
کدام ماژول پایگاه‌داده ساخته شود: \fB\-D mysql=enabled\fP یا \fB\-D postgresql=enabled\fP\&. کتابخانه‌های
کلاینت پایگاه‌داده و فایل‌های هدر مناسب باید پیش از ساخت نصب شده باشند. برای
اطلاعات بیشتر دربارهٔ ساخت Kea با پشتیبانی از پایگاه‌داده، به «نصب و پیکربندی پایگاه‌دادهٔ DHCP» \%<#\:dhcp-install-configure> مراجعه کنید.
بسته‌بندی‌های Kea ارائه‌شده توسط ISC، و همچنین برخی از توزیع‌های شخص ثالث، بسته‌های
جداگانه‌ای را برای هر نوع پایگاه‌داده ارائه می‌دهند.
.sp
سرور پایگاه‌داده‌ای که میزبان جدول‌های CB است باید با شِمای Kea
آماده‌سازی شود. هنگام ارتقای یک نصب موجود از Kea، ممکن است شِمای پایگاه‌داده نیز
به ارتقا نیاز داشته باشد. از ابزار \fBkea\-admin\fP \%<#\:std-iscman-kea-admin> می‌توان برای اعمال
راحت‌تر شِما استفاده کرد، همان‌طور که در «ابزار kea\-admin» \%<#\:kea-admin> شرح داده شده است\&.
.sp
در زمان اجرا، سرورهای DHCP باید برای بارگیری ماژول در بخش
\fBhooks\-libraries\fP پیکربندی شوند. سپس باید از دستورالعمل \fBconfig\-databases\fP
برای هدایت Kea به بارگیری پیکربندی با استفاده از backend پایگاه‌داده استفاده شود.
پیکربندی‌های خاص سرورهای DHCPv4 و DHCPv6 برای CB و همچنین فهرست پارامترهای
پیکربندی پشتیبانی‌شده، به‌ترتیب در «Backend پیکربندی در DHCPv4» \%<#\:dhcp4-cb>
و «Backend پیکربندی در DHCPv6» \%<#\:dhcp6-cb> یافت می‌شوند.
.sp
پس از اتمام نصب، می‌توان از API دستورات CB برای پر کردن پایگاه‌داده با اطلاعات پیکربندی Kea استفاده کرد.
.SS "اشتراک‌گذاری پیکربندی و برچسب‌های سرور (Configuration Sharing and Server Tags)"
.sp
پایگاه‌دادهٔ پیکربندی برای ذخیرهٔ اطلاعات پیکربندی چندین سرور Kea طراحی شده است.
بسته به مورد استفاده، کل پیکربندی ممکن است میان تمام سرورها به اشتراک گذاشته شود؛
بخش‌هایی از پیکربندی ممکن است توسط چندین سرور به اشتراک گذاشته شده و باقی پیکربندی
برای این سرورها متفاوت باشد؛ یا هر سرور ممکن است پیکربندی غیرمشترک مخصوص به خود را داشته باشد.
.sp
عناصر پیکربندی در پایگاه‌داده با استفاده از \(dqبرچسب‌های سرور\(dq (server tags) به سرورها منتسب می‌شوند.
برچسب سرور یک رشتهٔ دلخواه حاوی نام نمونهٔ سرور Kea است. برچسب‌های سرورهای DHCPv4 و DHCPv6
در پایگاه‌داده مستقل هستند، یعنی می‌توان همان برچسب سرور را برای هر دو سرور DHCPv4 و DHCPv6 ایجاد کرد.
این مقدار با استفاده از پارامتر \fBserver\-tag\fP در حوزهٔ \fBDhcp4\fP یا \fBDhcp6\fP پیکربندی می‌شود.
برچسب سرور فعلی را می‌توان با دستور \fBserver\-tag\-get\fP \%<#\:std-isccmd-server-tag-get> بررسی کرد.
.sp
تعریف سرور، که شامل برچسب سرور و توضیحات سرور است، باید پیش از ایجاد
پیکربندی اختصاصی برای آن سرور، در پایگاه‌دادهٔ پیکربندی ذخیره شود. در مواردی
که همهٔ سرورها از پیکربندی یکسانی استفاده می‌کنند، مانند یک جفت سرور که به‌عنوان
همتایان دسترسی‌پذیری بالا (High Availability) اجرا می‌شوند، نیازی به پیکربندی
برچسب‌های سرور برای این سرورها در پایگاه‌داده نیست.
.sp
دستوراتی که شامل سرور منطقی \fIall\fP هستند بر تمام سرورهای متصل به
پایگاه‌داده اعمال می‌شوند. سرور \fIall\fP را نمی‌توان حذف یا ویرایش کرد،
و در نتیجهٔ دستورهای \fBremote\-server4\-get\-all\fP \%<#\:std-isccmd-remote-server4-get-all> و
\fBremote\-server6\-get\-all\fP \%<#\:std-isccmd-remote-server6-get-all> در میان سرورهای دیگر بازگردانده نمی‌شود.
.sp
در بیشتر موارد، هیچ برچسب سروری در پایگاه‌دادهٔ پیکربندی تعریف نشده است؛
همهٔ سرورهای متصل‌شونده، بدون در نظر گرفتن برچسب سروری که استفاده می‌کنند،
پیکربندی یکسانی دریافت می‌کنند. برچسب سروری که یک نمونهٔ خاص Kea برای دریافت
پیکربندی خود به پایگاه‌داده ارائه می‌دهد، در فایل پیکربندی Kea با استفاده از نگاشت
\fIconfig\-control\fP مشخص می‌شود (لطفاً برای جزئیات به «فعال‌سازی Backend پیکربندی» \%<#\:dhcp4-cb-json> و
«فعال‌سازی Backend پیکربندی» \%<#\:dhcp6-cb-json> مراجعه کنید). به تمام نمونه‌های Kea که برچسب سرور
یکسانی را به پایگاه‌دادهٔ پیکربندی ارائه می‌دهند، پیکربندی یکسانی داده می‌شود.
.sp
این به انتخاب مدیر سیستم بستگی دارد که چندین نمونهٔ Kea از یک برچسب سرور
استفاده کنند یا هر نمونهٔ Kea از برچسب سرور متفاوتی بهره ببرد. هیچ الزامی وجود
ندارد که نمونه‌های در حال اجرا بر روی یک ماشین فیزیکی یا مجازی یکسان، از برچسب
سرور مشابهی استفاده کنند. حتی امکان پیکربندی سرور Kea بدون انتساب برچسب سرور به آن نیز
وجود دارد. در چنین حالتی، به سرور پیکربندیِ مشخص‌شده برای سرورهای \fIall\fP داده خواهد شد.
.sp
برای تفکیک میان پیکربندی‌های مختلف سرور Kea، فهرستی از برچسب‌های سرور استفاده‌شده
توسط سرورها باید در پایگاه‌داده ذخیره شود. برای سرورهای DHCPv4 و DHCPv6، این کار می‌تواند با استفاده از
دستورهای \fBremote\-server4\-set\fP \%<#\:std-isccmd-remote-server4-set> و \fBremote\-server6\-set\fP \%<#\:std-isccmd-remote-server6-set> انجام شود.
سپس می‌توان از برچسب‌های سرور برای انتساب اطلاعات پیکربندی به سرورها استفاده کرد. با این حال،
توجه به این نکته مهم است که برخی از عناصر پیکربندی DHCP ممکن است با چندین برچسب سرور مرتبط شوند (معروف به
عناصر \(dqاشتراک‌پذیر\(dq)، در حالی که سایر عناصر پیکربندی ممکن است تنها با یک برچسب سرور مرتبط باشند
(عناصر \(dqغیرقابل‌اشتراک\(dq). بخش‌های «Backend پیکربندی در DHCPv4» \%<#\:dhcp4-cb>
و «Backend پیکربندی در DHCPv6» \%<#\:dhcp6-cb> عناصر پیکربندی اشتراک‌پذیر و غیرقابل‌اشتراک مختص DHCP را
فهرست می‌کنند؛ با این حال، در این بخش تفاوت‌های میان آن‌ها را به اختصار شرح می‌دهیم.
.sp
یک عنصر پیکربندی اشتراک‌پذیر عنصری است که دارای یک ویژگی منحصربه‌فردِ شناسایی‌کننده بوده
و ممکن است تنها یک‌بار در پایگاه‌داده وجود داشته باشد. مثالی از یک عنصر DHCP اشتراک‌پذیر،
نمونهٔ یک زیرشبکه (subnet) است: زیرشبکه بخشی از توپولوژی شبکه است و فرض می‌کنیم
که هر زیرشبکهٔ خاص تنها می‌تواند یک تعریف در این شبکه داشته باشد. هر زیرشبکه دارای دو شناسهٔ منحصربه‌فرد است:
شناسهٔ زیرشبکه و پیشوند زیرشبکه. شناسهٔ زیرشبکه در Kea برای شناسایی یکتای زیرشبکه در شبکه و
اتصال آن به سایر عناصر پیکربندی، مثلاً در رزروهای میزبان (host reservations)، استفاده می‌شود. برخی از دستورات
ارائه‌شده توسط \fBlibdhcp_cb_cmds.so\fP \%<#\:std-ischooklib-libdhcp_cb_cmds\:.so> امکان دسترسی
به اطلاعات زیرشبکه را از طریق شناسهٔ زیرشبکه یا پیشوند فراهم می‌کنند، و استفاده از برچسب سرور را برای
دسترسی به زیرشبکه صراحتاً منع می‌نمایند. علت این است که به‌طور کلی، تعریف زیرشبکه به‌جای یک سرور واحد،
با چندین سرور مرتبط است. در واقع، حتی ممکن است با هیچ سروری مرتبط نباشد (تخصیص‌نیافته یا unassigned). با این وجود،
زیرشبکهٔ تخصیص‌نیافته دارای شناسه و پیشوندی است که می‌توان از آن‌ها برای دسترسی به زیرشبکه استفاده کرد.
.sp
یک عنصر پیکربندی اشتراک‌پذیر ممکن است با چندین سرور، یک سرور، یا هیچ سروری مرتبط باشد.
حذف سروری که با عنصر اشتراک‌پذیر مرتبط است موجب حذف عنصر اشتراک‌پذیر نمی‌شود.
این کار صرفاً ارتباطِ سرورِ حذف‌شده را با آن عنصر پاک می‌کند.
.sp
برخلاف یک عنصر اشتراک‌پذیر، یک عنصر غیرقابل‌اشتراک نباید صراحتاً با بیش از یک سرور مرتبط شود
و پس از حذف سرور نباید باقی بماند (نباید بدون تخصیص باقی بماند). یک عنصر غیرقابل‌اشتراک
فقط در بافتار (context) سرور وجود دارد. نمونه‌ای از یک عنصر غیرقابل‌اشتراک در DHCP، یک پارامتر سراسری
مانند \fIrenew\-timer\fP\& است. تایمر تمدید مقداری است که باید توسط یک سرور خاص و صرفاً همین
سرور استفاده شود. سرورهای دیگر ممکن است تایمرهای تمدید مربوط به خود را با مقادیر یکسان یا متفاوتی
تنظیم کرده باشند. پارامتر تایمر تمدید فاقد هرگونه شناسهٔ منحصربه‌فردی است که بتوان از طریق آن بدان
دسترسی یافت، ویرایشش کرد، یا به شیوهٔ دیگری از آن استفاده نمود. پارامترهای سراسری مانند تایمر تمدید
می‌توانند با نام پارامتر و برچسب سروری که برای آن پیکربندی شده‌اند در دسترس قرار گیرند. برای مثال، دستورهای
\fBremote\-global\-parameter4\-get\fP \%<#\:std-isccmd-remote-global-parameter4-get> و
\fBremote\-global\-parameter6\-get\fP \%<#\:std-isccmd-remote-global-parameter6-get> امکان دریافت
مقدار پارامتر سراسری را با نام پارامتر و نام سرور فراهم می‌آورند. دریافت پارامتر سراسری صرفاً بر اساس نام آن
(بدون مشخص کردن برچسب سرور) امکان‌پذیر نیست، زیرا ممکن است پارامترهای سراسری متعددی با یک نام مشخص در پایگاه‌داده وجود داشته باشد.
.sp
هنگامی که سرور مرتبط با یک عنصر پیکربندی غیرقابل‌اشتراک حذف می‌شود، عنصر پیکربندی
به‌طور خودکار به همراه سرور از پایگاه‌داده حذف می‌گردد زیرا عنصر غیرقابل‌اشتراک باید همواره
به یک سرور (یا سرور منطقی \fIall\fP) تخصیص یافته باشد.
.sp
اصطلاحات \(dqاشتراک‌پذیر\(dq و \(dqغیرقابل‌اشتراک\(dq تنها برای ارتباطات با سرورهای تعریف‌شده توسط کاربر
به‌کار می‌روند؛ تمامی عناصر پیکربندی مرتبط با سرور منطقی \fIall\fP بنا به تعریف، اشتراک‌پذیر هستند.
برای مثال: پارامتر \fIrenew\-timer\fP مرتبط با سرورهای \fIall\fP توسط تمامی سرورهای متصل به پایگاه‌داده که
تایمرهای تمدید خاص خود را تعریف نکرده‌اند استفاده می‌شود. در یک حالت خاص، زمانی که هیچ‌یک از عناصر
پیکربندی با سرورهای تعریف‌شده توسط کاربر مرتبط نباشند، کل پیکربندی موجود در پایگاه‌داده اشتراک‌پذیر است زیرا
تمامی بخش‌های آن به سرورهای \fIall\fP تعلق دارند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
هنگام مرتبط کردن عناصر پیکربندی با برچسب‌های سرور مختلف بسیار محتاط باشید. Backend پیکربندی در
برابر برخی از پیکربندی‌های نادرست احتمالی که ممکن است ناشی از انتساب‌های اشتباه برچسب‌های سرور باشند،
محافظت نمی‌کند. برای مثال: اگر یک شبکهٔ مشترک (shared network) به یک سرور و زیرشبکه‌های متعلق به این
شبکهٔ مشترک به سرور دیگری اختصاص داده شوند، سرورها در هنگام تلاش برای دریافت و استفاده از این پیکربندی
با خطا مواجه خواهند شد. سروری که زیرشبکه‌ها را واکشی می‌کند آگاه خواهد بود که این زیرشبکه‌ها با شبکهٔ مشترک
مرتبط هستند، اما شبکهٔ مشترک توسط این سرور پیدا نخواهد شد زیرا متعلق به آن نیست. در چنین حالتی، هم شبکهٔ
مشترک و هم زیرشبکه‌ها باید به مجموعهٔ یکسانی از سرورها اختصاص یابند.
.UNINDENT
.UNINDENT.SH "مدیریت KEA با KEACTRL (MANAGING KEA WITH KEACTRL)"
.SS "نمای کلی (Overview)"
.sp
اسکریپت شل \fBkeactrl\fP \%<#\:std-iscman-keactrl> راه‌اندازی، خاموش کردن و پیکربندی مجدد سرورهای Kea (شامل \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4>، \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6>، \fBkea\-dhcp\-ddns\fP \%<#\:std-iscman-kea-dhcp-ddns> و \fBkea\-netconf\fP \%<#\:std-iscman-kea-netconf>) را کنترل می‌کند. این اسکریپت همچنین امکاناتی را برای بررسی وضعیت فعلی سرورها و تعیین فایل‌های پیکربندی در حال استفاده فراهم می‌آورد.
.sp
ابزار \fBkeactrl\fP \%<#\:std-iscman-keactrl> تنها زمانی در دسترس است که Kea از سورس ساخته شده باشد. هنگام نصب Kea با استفاده از بسته‌های بومی توزیع، اسکریپت‌های بومی \fBsystemd\fP ارائه می‌شوند. برای جزئیات، به بخش Native Packages and systemd مراجعه کنید.
.SS "گزینه‌های خط فرمان (Command Line Options)"
.sp
\fBkeactrl\fP \%<#\:std-iscman-keactrl> به صورت زیر اجرا می‌شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# keactrl <command> [\-c keactrl\-config\-file] [\-s server[,server,...]]
.EE
.UNINDENT
.UNINDENT
.sp
آرگومان \fB<command>\fP یکی از دستورات شرح داده شده در Commands است\&.
.sp
گزینه اختیاری \fB\-c keactrl\-config\-file\fP امکان تعیین یک فایل پیکربندی جایگزین برای \fBkeactrl\fP \%<#\:std-iscman-keactrl> را فراهم می‌کند. (\fB\-\-ctrl\-config\fP مترادفی برای \fB\-c\fP است\&.) در صورت عدم استفاده از \fB\-c\fP، \fBkeactrl\fP \%<#\:std-iscman-keactrl> از فایل پیکربندی پیش‌فرض \fB\(dq[kea\-install\-dir]/etc/kea/keactrl.conf\(dq\fP استفاده می‌کند\&.
.sp
گزینه اختیاری \fB\-s server[,server,...]\fP سرورهایی را که دستور برای آن‌ها صادر می‌شود مشخص می‌کند. (\fB\-\-server\fP مترادفی برای \fB\-s\fP است\&.) در صورت عدم استفاده، دستور به تمامی سرورهای فعال‌شده در فایل پیکربندی \fBkeactrl\fP \%<#\:std-iscman-keactrl> ارسال می‌شود. اگر چندین سرور مشخص شوند، باید با کاما و بدون فاصله میان آن‌ها از یکدیگر جدا شوند.
.SS "فایل پیکربندی \fBkeactrl\fP \%<#\:std-iscman-keactrl>"
.sp
بسته به نیازمندی‌های مدیر سیستم، ممکن است نیازی به اجرای تمام سرورهای موجود نباشد.
فایل پیکربندی \fBkeactrl\fP \%<#\:std-iscman-keactrl> مشخص می‌کند که کدام سرورها فعال و کدام غیرفعال هستند. فایل پیکربندی پیش‌فرض \fB\(dq[kea\-install\-dir]/etc/kea/keactrl.conf\(dq\fP است، اما می‌توان آن را برای هر دستور به صورت جداگانه با استفاده از گزینه \fB\-c\fP بازنویسی کرد.
.sp
محتویات \fBkeactrl.conf\fP به صورت زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# This is a configuration file for keactrl script which controls
# the startup, shutdown, reconfiguration and gathering the status
# of the Kea processes.

# prefix holds the location where the Kea is installed.
prefix=@prefix@

# Location of Kea configuration file.
kea_dhcp4_config_file=@sysconfdir@/@PACKAGE@/kea\-dhcp4.conf
kea_dhcp6_config_file=@sysconfdir@/@PACKAGE@/kea\-dhcp6.conf
kea_dhcp_ddns_config_file=@sysconfdir@/@PACKAGE@/kea\-dhcp\-ddns.conf
kea_netconf_config_file=@sysconfdir@/@PACKAGE@/kea\-netconf.conf

# Location of Kea binaries.
exec_prefix=@exec_prefix@
dhcp4_srv=@sbindir@/kea\-dhcp4
dhcp6_srv=@sbindir@/kea\-dhcp6
dhcp_ddns_srv=@sbindir@/kea\-dhcp\-ddns
netconf_srv=@sbindir@/kea\-netconf

# Start DHCPv4 server?
dhcp4=yes

# Start DHCPv6 server?
dhcp6=yes

# Start DHCP DDNS server?
dhcp_ddns=no

# Start Netconf?
netconf=no

# Be verbose?
kea_verbose=no
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
در مثال بالا، رشته‌هایی به شکل @something@ هنگام نصب Kea با مقادیر مناسب جایگزین می‌شوند.
.UNINDENT
.UNINDENT
.sp
تنظیم پارامترهای \fBdhcp4\fP، \fBdhcp6\fP، \fBdhcp_ddns\fP و \fBnetconf\fP روی مقدار \(dqyes\(dq، ابزار \fBkeactrl\fP \%<#\:std-iscman-keactrl> را برای مدیریت (راه‌اندازی، پیکربندی مجدد) تمام سرورها پیکربندی می‌کند، یعنی \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4>، \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6>، \fBkea\-dhcp\-ddns\fP \%<#\:std-iscman-kea-dhcp-ddns> و \fBkea\-netconf\fP \%<#\:std-iscman-kea-netconf>\&. هنگامی که هر یک از این پارامترها روی \(dqno\(dq تنظیم شود، \fBkeactrl\fP \%<#\:std-iscman-keactrl> سرور مربوطه را در هنگام راه‌اندازی یا پیکربندی مجدد Kea نادیده می‌گیرد. برخی دیمن‌ها (dhcp_ddns و netconf) به‌طور پیش‌فرض غیرفعال هستند.
.sp
به‌طور پیش‌فرض، سرورهای Kea که توسط \fBkeactrl\fP \%<#\:std-iscman-keactrl> مدیریت می‌شوند در مسیر \fB\(dq[kea\-install\-dir]/sbin\(dq\fP قرار دارند\&. این مسیر برای بیشتر نصب‌ها مناسب است. اگر نیاز به تغییر مکان پیش‌فرض باشد، باید مسیرهای مشخص‌شده در پارامترهای \fBdhcp4_srv\fP، \fBdhcp6_srv\fP، \fBdhcp_ddns_srv\fP و \fBnetconf_srv\fP ویرایش شوند.
.sp
پارامتر \fBkea_verbose\fP میزان پرگویی گزارش‌ها را برای سرورهای در حال راه‌اندازی مشخص می‌کند. هنگامی که \fBkea_verbose\fP روی \fByes\fP تنظیم شود، سطح گزارش‌گیری سرور روی DEBUG قرار می‌گیرد. تغییر سطح اهمیت گزارش‌گیری در فایل پیکربندی، همان‌طور که در Logging \%<#\:logging> شرح داده شده است، تا زمانی که \fBkea_verbose\fP روی \(dqyes\(dq تنظیم باشد هیچ اثری نخواهد داشت. تنظیم آن روی \(dqno\(dq باعث می‌شود سرور از سطوح گزارش‌گیری مشخص‌شده در فایل پیکربندی Kea استفاده کند. اگر هیچ پیکربندی برای گزارش‌گیری تعیین نشده باشد، تنظیمات پیش‌فرض به کار گرفته می‌شوند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
میزان پرگویی گزارش‌ها هنگام راه‌اندازی سرور تنظیم می‌شود. پس از راه‌اندازی، این میزان تنها با متوقف کردن سرور و اجرای مجدد آن با مقدار جدید پارامتر \fBkea_verbose\fP قابل تغییر است.
.UNINDENT
.UNINDENT.SS "دستورها (Commands)"
.sp
دستورهای زیر توسط \fBkeactrl\fP \%<#\:std-iscman-keactrl> پشتیبانی می‌شوند:
.INDENT 0.0
.IP \(bu 2
\fBstart\fP \- سرورهای انتخاب‌شده را راه‌اندازی می‌کند.
.IP \(bu 2
\fBstop\fP \- تمام سرورهای در حال اجرا را متوقف می‌کند.
.IP \(bu 2
\fBreload\fP \- با ارسال سیگنال SIGHUP به سرورهای انتخاب‌شده، پیکربندی مجدد آن‌ها را فعال می‌کند.
.IP \(bu 2
\fBstatus\fP \- وضعیت سرورها (فعال یا غیرفعال) و نام فایل‌های پیکربندی در حال استفاده را بازمی‌گرداند.
.IP \(bu 2
\fBversion\fP \- نسخه خود ابزار \fBkeactrl\fP \%<#\:std-iscman-keactrl> را به همراه نسخه دیمن‌های Kea چاپ می‌کند.
.UNINDENT
.sp
خروجی معمول \fBkeactrl\fP \%<#\:std-iscman-keactrl> هنگام راه‌اندازی سرورها شبیه به مورد زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ keactrl start
INFO/keactrl: Starting kea\-dhcp4 \-c /usr/local/etc/kea/kea\-dhcp4.conf \-d
INFO/keactrl: Starting kea\-dhcp6 \-c /usr/local/etc/kea/kea\-dhcp6.conf \-d
INFO/keactrl: Starting kea\-dhcp\-ddns \-c /usr/local/etc/kea/kea\-dhcp\-ddns.conf \-d
INFO/keactrl: Starting kea\-netconf \-c /usr/local/etc/kea/kea\-netconf.conf \-d
.EE
.UNINDENT
.UNINDENT
.sp
سرورهای Kea هنگام راه‌اندازی، فایل‌های PID ایجاد می‌کنند. این فایل‌ها توسط
\fBkeactrl\fP \%<#\:std-iscman-keactrl> برای تعیین اینکه آیا یک سرور مشخص در حال اجرا است یا خیر استفاده می‌شوند. اگر هنگام اجرای دستور start، یک یا چند
سرور در حال اجرا باشند، خروجی مشابه زیر خواهد بود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ keactrl start
INFO/keactrl: kea\-dhcp4 appears to be running, see: PID 10918, PID file: /usr/local/var/run/kea/kea.kea\-dhcp4.pid.
INFO/keactrl: kea\-dhcp6 appears to be running, see: PID 10924, PID file: /usr/local/var/run/kea/kea.kea\-dhcp6.pid.
INFO/keactrl: kea\-dhcp\-ddns appears to be running, see: PID 10930, PID file: /usr/local/var/run/kea/kea.kea\-dhcp\-ddns.pid.
INFO/keactrl: kea\-netconf appears to be running, see: PID 10123, PID file: /usr/local/var/run/kea/kea.kea\-netconf.pid.
.EE
.UNINDENT
.UNINDENT
.sp
در طول خاموش شدن‌های عادی، این فایل‌های PID حذف می‌شوند؛ با این حال، ممکن است
پس از فروپاشی سیستم (crash) به عنوان بقایا باقی بمانند. این امکان وجود دارد،
اگرچه بسیار بعید است، که پس از راه‌اندازی مجدد سیستم، PIDهایی که این فایل‌ها شامل می‌شوند در واقع به فرآیندهای نامرتبط با Kea اشاره کنند. این وضعیت
باعث می‌شود \fBkeactrl\fP \%<#\:std-iscman-keactrl> تشخیص دهد که سرورها در حال اجرا هستند، در حالی که در واقعیت این‌گونه
نیست. در چنین مواردی فایل‌های PID فهرست‌شده در خروجی \fBkeactrl\fP \%<#\:std-iscman-keactrl>
باید به صورت دستی حذف شوند.
.sp
دستور زیر تمام سرورها را متوقف می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ keactrl stop
INFO/keactrl: Stopping kea\-dhcp4...
INFO/keactrl: Stopping kea\-dhcp6...
INFO/keactrl: Stopping kea\-dhcp\-ddns...
INFO/keactrl: Stopping kea\-netconf...
.EE
.UNINDENT
.UNINDENT
.sp
توجه داشته باشید که دستور \fBstop\fP تلاش می‌کند تمام سرورها را صرف‌نظر از اینکه
در \fBkeactrl.conf\fP \(dqفعال\(dq (enabled) شده‌اند یا خیر متوقف کند. اگر هر یک
از سرورها در حال اجرا نباشند، یک پیام اطلاعاتی مانند خروجی دستور \fBstop\fP در زیر نمایش داده می‌شود.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ keactrl stop
INFO/keactrl: kea\-dhcp4 isn\(aqt running.
INFO/keactrl: kea\-dhcp6 isn\(aqt running.
INFO/keactrl: kea\-dhcp\-ddns isn\(aqt running.
INFO/keactrl: kea\-netconf isn\(aqt running.
.EE
.UNINDENT
.UNINDENT
.sp
همان‌طور که پیش‌تر اشاره شد، پیکربندی مجدد هر سرور Kea با
سیگنال SIGHUP آغاز می‌شود. دستور \fBreload\fP سیگنال SIGHUP را
به هر سروری که در فایل پیکربندی \fBkeactrl\fP \%<#\:std-iscman-keactrl> فعال شده باشد
و در حال حاضر در حال اجرا باشد ارسال می‌کند. هنگامی که یک سرور سیگنال SIGHUP را دریافت می‌کند،
فایل پیکربندی خود را دوباره می‌خواند و در صورتی که پیکربندی جدید معتبر باشد،
از پیکربندی جدید استفاده می‌کند.
اگر پیکربندی جدید نامعتبر باشد، سرور پیکربندی فعلی خود را حفظ می‌کند؛
با این حال، در برخی موارد یک پیام خطای مهلک ثبت می‌شود که نشان می‌دهد سرور
دیگر هیچ سرویسی ارائه نمی‌دهد: در این حالت یک پیکربندی سالم باید در اسرع وقت بارگذاری شود.
.sp
یک بارگذاری مجدد به صورت زیر اجرا می‌شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ keactrl reload
INFO/keactrl: Reloading kea\-dhcp4...
INFO/keactrl: Reloading kea\-dhcp6...
INFO/keactrl: Reloading kea\-dhcp\-ddns...
.EE
.UNINDENT
.UNINDENT
.sp
اگر هر یک از سرورها در حال اجرا نباشند، یک پیام اطلاعاتی مانند
خروجی دستور \fBreload\fP در زیر نمایش داده می‌شود.
\fBkea\-netconf\fP \%<#\:std-iscman-kea-netconf> از سیگنال SIGHUP پشتیبانی نمی‌کند. در صورتی
که پیکربندی آن تغییر کرده است، لطفاً آن را متوقف کرده و مجدداً راه‌اندازی کنید تا تغییرات
اعمال شوند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ keactrl stop
INFO/keactrl: kea\-dhcp4 isn\(aqt running.
INFO/keactrl: kea\-dhcp6 isn\(aqt running.
INFO/keactrl: kea\-dhcp\-ddns isn\(aqt running.
INFO/keactrl: kea\-netconf isn\(aqt running.
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
ویژگی NETCONF یک قابلیت اختیاری است که به صورت پیش‌فرض غیرفعال است و می‌تواند
در زمان کامپایل فعال شود. اگر Kea بدون پشتیبانی از NETCONF کامپایل شده باشد،
\fBkeactrl\fP \%<#\:std-iscman-keactrl> اطلاعاتی درباره آن ارائه نمی‌دهد. ورودی‌های NETCONF
همچنان در فایل \fBkeactrl.conf\fP موجود هستند، اما وضعیت NETCONF نمایش داده نمی‌شود و
سایر دستورها آن را نادیده می‌گیرند.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
در حال حاضر \fBkeactrl\fP \%<#\:std-iscman-keactrl> در هنگام راه‌اندازی یا پیکربندی مجدد سرور،
خطاهای پیکربندی را گزارش نمی‌کند. برای بررسی اینکه آیا پیکربندی سرور موفقیت‌آمیز بوده است یا خیر،
لاگ Kea باید برای یافتن خطاها بررسی شود. به صورت پیش‌فرض، لاگ‌ها در فایل \fIsyslog\fP
نوشته می‌شوند.
.UNINDENT
.UNINDENT
.sp
گاهی اوقات بررسی اینکه کدام سرورها در حال اجرا هستند مفید است.
دستور \fBstatus\fP این موضوع را گزارش می‌دهد و خروجی نمونه آن به صورت زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ keactrl status
DHCPv4 server: active
DHCPv6 server: inactive
DHCP DDNS: active
Netconf agent: inactive
Kea configuration file: /usr/local/etc/kea/kea.conf
Kea DHCPv4 configuration file: /usr/local/etc/kea/kea\-dhcp4.conf
Kea DHCPv6 configuration file: /usr/local/etc/kea/kea\-dhcp6.conf
Kea DHCP DDNS configuration file: /usr/local/etc/kea/kea\-dhcp\-ddns.conf
Kea Netconf configuration file: /usr/local/etc/kea/kea\-netconf.conf
keactrl configuration file: /usr/local/etc/kea/keactrl.conf
.EE
.UNINDENT
.UNINDENT
.sp
دستور \fBkeactrl status\fP قابلیت‌های گزارش‌دهی پایه‌ای را ارائه می‌دهد. برای به دست آوردن دیدگاه جامع‌تر
نسبت به سلامت و وضعیت Kea، استقرار Stork را مد نظر قرار دهید. برای اطلاعات بیشتر، به Monitoring Kea With Stork \%<#\:stork>\& مراجعه کنید..SS "بازنویسی انتخاب سرور (Overriding the Server Selection)"
.sp
گزینه اختیاری \fB\-s\fP امکان انتخاب سرور(هایی) را فراهم می‌کند که دستور \fBkeactrl\fP \%<#\:std-iscman-keactrl> برای آن‌ها صادر می‌شود. برای نمونه، دستور زیر به \fBkeactrl\fP \%<#\:std-iscman-keactrl> اعلام می‌کند که سرورهای \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> و \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> را متوقف کرده و اجازه دهد \fBkea\-dhcp\-ddns\fP \%<#\:std-iscman-kea-dhcp-ddns> در حال اجرا باقی بماند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ keactrl stop \-s dhcp4,dhcp6
.EE
.UNINDENT
.UNINDENT
.sp
به‌طور مشابه، دستور زیر تنها سرورهای \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> و \fBkea\-dhcp\-ddns\fP \%<#\:std-iscman-kea-dhcp-ddns> را اجرا می‌کند، اما نه \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6>\&.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ keactrl start \-s dhcp4,dhcp_ddns
.EE
.UNINDENT
.UNINDENT
.sp
توجه داشته باشید که رفتار گزینه \fB\-s\fP در دستورهای \fBstart\fP و \fBreload\fP با رفتار آن در دستور \fBstop\fP متفاوت است. در دستورهای \fBstart\fP و \fBreload\fP، برنامه \fBkeactrl\fP \%<#\:std-iscman-keactrl> بررسی می‌کند که آیا سرورهای ارائه‌شده به عنوان پارامتر به گزینه \fB\-s\fP در فایل پیکربندی \fBkeactrl\fP \%<#\:std-iscman-keactrl> فعال شده‌اند یا خیر؛ در غیر این صورت، سرور نادیده گرفته می‌شود. اما برای \fBstop\fP، این بررسی انجام نمی‌شود؛ دستور بدون در نظر گرفتن اینکه سرورها در فایل فعال شده باشند یا خیر، بر روی تمام سرورهای فهرست‌شده اعمال می‌گردد.
.sp
کلیدواژه‌های زیر می‌توانند با گزینه خط فرمان \fB\-s\fP استفاده شوند:
.INDENT 0.0
.IP \(bu 2
\fBdhcp4\fP برای \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4>\&.
.IP \(bu 2
\fBdhcp6\fP برای \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6>\&.
.IP \(bu 2
\fBdhcp_ddns\fP برای \fBkea\-dhcp\-ddns\fP \%<#\:std-iscman-kea-dhcp-ddns>\&.
.IP \(bu 2
\fBnetconf\fP برای \fBkea\-netconf\fP \%<#\:std-iscman-kea-netconf>\&.
.IP \(bu 2
\fBall\fP برای همه سرورها (پیش‌فرض).
.UNINDENT
.SS "بسته‌های بومی و \fBsystemd\fP (Native Packages and \fBsystemd\fP)"
.sp
اسکریپت \fBkeactrl\fP \%<#\:std-iscman-keactrl> برای کمک به مدیریت فرایندهای Kea توسعه یافته است.
با این حال، تمامی سیستم‌عامل‌های امروزی اسکریپت‌های مدیریت فرایند اختصاصی خود را دارند،
مانند \fBsystemd\fP\&. به‌طور کلی، توصیه می‌شود از این اسکریپت‌های بومی استفاده شود،
زیرا دارای چندین مزیت هستند. اسکریپت‌های \fBsystemd\fP فرایندها را به روشی یکپارچه
مدیریت می‌کنند، بنابراین با Kea مشابه با یک سرور HTTP یا سرور ایمیل
رفتار می‌شود. دوم و مهم‌تر از آن، \fBsystemd\fP امکان تعریف وابستگی‌ها بین سرویس‌ها را
فراهم می‌کند. برای نمونه، به‌راحتی می‌توان مشخص کرد که سرور Kea تا زمانی که رابط‌های
شبکه عملیاتی نشده‌اند شروع به کار نکند. استفاده از اسکریپت‌های بومی مزایای دیگری نیز دارد، مانند
امکان فعال‌سازی یا غیرفعال‌سازی سرویس‌ها با استفاده از دستورها، و قابلیت اجرای موقت یک
سرویس غیرفعال‌شده.
.sp
بنابراین، توصیه می‌شود در صورت دردسترس بودن، از دستورهای \fBsystemctl\fP استفاده شود. بسته‌های
بومی Kea اسکریپت \fBkeactrl\fP \%<#\:std-iscman-keactrl> را ارائه نمی‌دهند؛ در عوض تعاریف سرویس \fBsystemctl\fP
ارائه شده‌اند. برای جزئیات به مستندات سیستم مراجعه کنید.
.sp
به‌طور خلاصه، در اینجا نمونه دستورهایی برای بررسی وضعیت، آغاز، توقف، و راه‌اندازی دوباره دیمن‌های مختلف Kea آورده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# systemctl start kea\-dhcp4
# systemctl stop kea\-dhcp6
# systemctl restart kea\-dhcp\-ddns
.EE
.UNINDENT
.UNINDENT
.sp
توجه داشته باشید که نام سرویس‌ها ممکن است در توزیع‌های مختلف لینوکس کمی تفاوت داشته باشد؛ به‌طور کلی،
ما از قواعد نام‌گذاری بسته‌های شخص ثالث پیروی کرده‌ایم. به‌ویژه،
ممکن است در برخی سیستم‌ها پیشوند \fIisc\-\fP وجود نداشته باشد.
.SH "سرور DHCPV4 (THE DHCPV4 SERVER)"
.SS "راه‌اندازی و توقف سرور DHCPv4 (Starting and Stopping the DHCPv4 Server)"
.sp
توصیه می‌شود که سرور Kea DHCPv4 با استفاده از \fBkeactrl\fP \%<#\:std-iscman-keactrl> آغاز و متوقف
شود (که در «مدیریت Kea با keactrl» \%<#\:keactrl> توضیح داده شده است)؛ با این حال، اجرای
مستقیم سرور از طریق دستور \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> نیز امکان‌پذیر است، که
سوئیچ‌های خط فرمان زیر را می‌پذیرد:
.INDENT 0.0
.IP \(bu 2
\fB\-c file\fP \- فایل پیکربندی را مشخص می‌کند. این تنها
سوئیچ اجباری است.
.IP \(bu 2
\fB\-d\fP \- مشخص می‌کند که آیا ثبت وقایع سرور باید به حالت اشکال‌زدایی/پُرگویی
تغییر یابد یا خیر. در حالت پرگویی، سطح شدت ثبت وقایع و debuglevel
تعیین‌شده در فایل پیکربندی نادیده گرفته می‌شوند؛ شدت \(dqdebug\(dq
و بیشترین debuglevel (عدد 99) فرض می‌شوند. این پرچم برای
تغییر موقت سرور به حداکثر سطح گزارش‌دهی، مثلاً هنگام اشکال‌زدایی،
مناسب است.
.IP \(bu 2
\fB\-p server\-port\fP \- پورت محلی UDP را که سرور روی آن
گوش می‌دهد مشخص می‌کند. این گزینه فقط در حین آزمایش مفید است، زیرا یک سرور DHCPv4
که روی پورت‌هایی غیر از پورت‌های استاندارد گوش می‌دهد، قادر به
پردازش پرس‌وجوهای معمول DHCPv4 نخواهد بود.
.IP \(bu 2
\fB\-P client\-port\fP \- پورت دوردست UDP را مشخص می‌کند که
سرور تمام پاسخ‌ها را به آن ارسال می‌کند. این گزینه تنها در حین آزمایش کاربرد دارد،
زیرا یک سرور DHCPv4 که پاسخ‌ها را به پورت‌هایی غیر از پورت‌های استاندارد
ارسال می‌کند، قادر به مدیریت پرس‌وجوهای معمول DHCPv4 نخواهد بود.
.IP \(bu 2
\fB\-t file\fP \- یک فایل پیکربندی را برای آزمایش مشخص می‌کند. \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4>
آن را بارگذاری کرده، صحت آن را بررسی نموده و خارج می‌شود. در حین آزمایش، پیام‌های گزارش
در خروجی استاندارد و پیام‌های خطا در خطای استاندارد چاپ می‌شوند. نتیجه
آزمایش از طریق وضعیت خروج گزارش می‌شود (0 = پیکربندی
درست به نظر می‌رسد، 1 = خطا رخ داده است). این بررسی
جامع نیست؛ بررسی‌های مشخصی تنها هنگام اجرای زنده
سرور امکان‌پذیر هستند.
.IP \(bu 2
\fB\-T file\fP \- یک فایل پیکربندی را برای آزمایش مشخص می‌کند. \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4>
آن را بارگذاری کرده، بررسی می‌کند و خارج می‌شود. این گزینه بررسی‌های بیشتری فراتر از آنچه \fB\-t\fP
ارائه می‌دهد انجام می‌دهد، مانند برقراری اتصال‌های پایگاه‌داده (برای lease backend،
پیشانه host reservations، پیشانه configuration و پیشانه forensic logging)،
بارگذاری کتابخانه‌های قلاب (hook)، تجزیه پیکربندی‌های کتابخانه قلاب و غیره.
این گزینه سوکت‌های UNIX یا TCP/UDP را باز نمی‌کند، فایل‌ها را قفل نمی‌کند، و همچنین فایل‌ها را باز نکرده
یا دوره‌ای جایگزین (rotate) نمی‌کند، چرا که هرکدام از این اقدامات می‌تواند با یک فرایند در حال اجرا روی همان
ماشین تداخل داشته باشد.
.IP \(bu 2
\fB\-v\fP \- نسخه Kea را نمایش داده و خارج می‌شود.
.IP \(bu 2
\fB\-V\fP \- نسخه تفصیلی Kea را به همراه پارامترهای اضافی نمایش
داده و خارج می‌شود. این فهرست شامل نسخه‌های کتابخانه‌هایی است که
به‌طور پویا با Kea پیوند خورده‌اند.
.IP \(bu 2
\fB\-W\fP \- گزارش پیکربندی Kea را نمایش داده و خارج می‌شود. این گزارش
رونوشتی از فایل \fBconfig.report\fP است که توسط \fBmeson setup\fP تولید شده؛
این گزارش در فایل اجرایی باینری تعبیه شده است.
.sp
محتویات فایل \fBconfig.report\fP را همچنین می‌توان با بررسی
برخی کتابخانه‌ها در درخت نصب یا در درخت کد منبع به دست آورد.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
# from installation using libkea\-process.so
$ strings ${prefix}/lib/libkea\-process.so | sed \-n \(aqs/;;;; //p\(aq

# from sources using libkea\-process.so
$ strings src/lib/process/.libs/libkea\-process.so | sed \-n \(aqs/;;;; //p\(aq

# from sources using libkea\-process.a
$ strings src/lib/process/.libs/libkea\-process.a | sed \-n \(aqs/;;;; //p\(aq

# from sources using libcfgrpt.a
$ strings src/lib/process/cfgrpt/.libs/libcfgrpt.a | sed \-n \(aqs/;;;; //p\(aq
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
\fB\-X\fP \- از نسخه Kea 3.0 به بعد، محدودیت‌های امنیتی را غیرفعال می‌کند. سرور همچنان
موارد نقض را بررسی می‌کند، اما در صورت یافتن آن‌ها به جای متوقف شدن با خطا، هشدارهایی
صادر خواهد کرد. لطفاً برای جزئیات به
«بررسی خط‌مشی امنیتی زمان اجرای Kea» \%<#\:sec-kea-runtime-security-policy-checking> مراجعه کنید.
.UNINDENT
.sp
هنگام راه‌اندازی، سرور رابط‌های شبکه موجود را شناسایی کرده و
تلاش می‌کند سوکت‌های UDP را روی تمام رابط‌های فهرست‌شده در
فایل پیکربندی باز کند. از آنجا که سرور DHCPv4 پورت‌های ممتاز (privileged) را باز می‌کند،
به دسترسی ریشه (root) نیاز دارد؛ این دیمن باید توسط کاربر ریشه اجرا شود.
.sp
در طول راه‌اندازی، سرور تلاش می‌کند یک فایل PID به فرم
\fB[pidfile_dir]/[conf name].kea\-dhcp4.pid\fP ایجاد کند که در آن:
.INDENT 0.0
.IP \(bu 2
\fBpidfile_dir\fP \- برابر است با \fB[prefix]/[localstatedir]/run/kea\fP که در آن
\fBprefix\fP و \fBlocalstatedir\fP مقادیری هستند که با استفاده از \fB\-\-prefix\fP و
\fB\-\-localstatedir\fP به meson setup منتقل شده‌اند و به‌طور پیش‌فرض به ترتیب \fB/usr/local\fP و
\fBvar\fP هستند. بنابراین کل مسیر \fBpidfile_dir\fP به‌طور پیش‌فرض برابر با
\fB/usr/local/var\fP است\&. توجه داشته باشید که این مقدار ممکن است در زمان اجرا با
تنظیم متغیر محیطی \fBKEA_PIDFILE_DIR\fP که اساساً برای اهداف
آزمایشی در نظر گرفته شده، بازنویسی شود.
.IP \(bu 2
\fBconf name\fP: نام فایل پیکربندی که برای راه‌اندازی سرور استفاده شده است،
بدون تمام مسیرهای قبل از آن و پسوند فایل. برای مثال، به ازای
یک نام مسیر مانند \fB/usr/local/etc/kea/myconf.txt\fP، بخش استفاده‌شده
\fBmyconf\fP خواهد بود\&.
.UNINDENT
.sp
اگر این فایل از قبل وجود داشته باشد و شامل PID یک فرایند در حال اجرا باشد،
سرور یک پیام گزارش \fBDHCP4_ALREADY_RUNNING\fP صادر کرده و خارج می‌شود. این
احتمال وجود دارد، هرچند بعید، که فایل باقی‌مانده از یک فروپاشی سیستم (system crash)
باشد و فرایندی که PID متعلق به آن است ارتباطی به Kea نداشته باشد. در چنین
حالتی، حذف دستی فایل PID ضروری خواهد بود.
.sp
سرور را می‌توان با استفاده از دستور \fBkill\fP متوقف کرد. هنگام اجرا در یک
کنسول، سرور همچنین می‌تواند با فشردن Ctrl\-c متوقف شود. Kea این
ترکیب کلید را شناسایی کرده و به‌صورت روان و تمیز خاموش می‌شود.
.sp
پیکربندی مجدد هر سرور Kea با دریافت سیگنال SIGHUP آغاز می‌شود.
هنگامی که یک سرور سیگنال SIGHUP را دریافت می‌کند، فایل پیکربندی خود را دوباره می‌خواند و
اگر پیکربندی جدید معتبر باشد، از آن استفاده می‌کند.
چنانچه مشخص شود پیکربندی جدید نامعتبر است، سرور پیکربندی
فعلی خود را حفظ می‌کند؛ با این حال، در برخی موارد یک پیام خطای مهلک ثبت می‌شود
که نشان می‌دهد سرور دیگر هیچ سرویسی ارائه نمی‌دهد: در این صورت باید یک
پیکربندی سالم در اسرع وقت بارگذاری شود..SS پیکربندی سرور DHCPv4
.SS مقدمه
.sp
این بخش نحوهٔ پیکربندی سرور DHCPv4 مربوط به Kea را با استفاده از یک فایل
پیکربندی شرح می‌دهد.
.sp
پیش از راه‌اندازی DHCPv4، باید فایل پیکربندی آن ایجاد
شود. پیکربندی پایه به شرح زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
# DHCPv4 configuration starts on the next line
\(dqDhcp4\(dq: {

# First we set up global values
    \(dqvalid\-lifetime\(dq: 4000,
    \(dqrenew\-timer\(dq: 1000,
    \(dqrebind\-timer\(dq: 2000,

# Next we set up the interfaces to be used by the server.
    \(dqinterfaces\-config\(dq: {
        \(dqinterfaces\(dq: [ \(dqeth0\(dq ]
    },

# And we specify the type of lease database
    \(dqlease\-database\(dq: {
        \(dqtype\(dq: \(dqmemfile\(dq,
        \(dqpersist\(dq: true,
        \(dqname\(dq: \(dq/var/lib/kea/dhcp4.leases\(dq
    },

# Finally, we list the subnets from which we will be leasing addresses.
    \(dqsubnet4\(dq: [
        {
            \(dqid\(dq: 1,
            \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
            \(dqpools\(dq: [
                {
                    \(dqpool\(dq: \(dq192.0.2.1 \- 192.0.2.200\(dq
                }
            ]
        }
    ]
# DHCPv4 configuration ends with the next line
}

}
.EE
.UNINDENT
.UNINDENT
.sp
بندهای زیر پیش‌نمایشی اجمالی از پارامترهای موجود در مثال بالا به همراه
قالب آن‌ها ارائه می‌دهند. بخش‌های بعدی این فصل، این پارامترها و پارامترهای دیگر را با
جزئیات بسیار بیشتری بررسی می‌کنند.
.sp
خطوطی که با هش (#) آغاز می‌شوند، توضیح (کامنت) هستند و سرور آن‌ها را
نادیده می‌گیرد؛ آن‌ها به هیچ شکلی بر عملکرد آن اثر نمی‌گذارند.
.sp
پیکربندی در خط نخست با براکت مجعد بازشوندهٔ اولیه (یا آکولاد باز) شروع می‌شود. هر
پیکربندی باید شامل شیئی باشد که پیکربندی ماژول Kea به‌کارگیرندهٔ آن را مشخص
کند. در مثال بالا، این شیء \fBDhcp4\fP نام دارد\&.
.sp
پیکربندی \fBDhcp4\fP با خط \fB\(dqDhcp4\(dq: {\fP آغاز شده و با آکولاد بستهٔ
متناظر آن (در مثال بالا، آکولاد پس از آخرین توضیح) به پایان می‌رسد. هر آنچه میان
این خطوط تعریف شده باشد، پیکربندی \fBDhcp4\fP به شمار می‌آید.
.sp
به‌طور کلی، ترتیبی که این پارامترها درج می‌شوند اهمیتی ندارد،
اما دو نکته وجود دارد. نکتهٔ نخست این است که فایل
پیکربندی باید یک JSON خوش‌ساخت (well\-formed) باشد؛ بدین معنا که پارامترها برای
هر حوزهٔ (scope) معین باید با کاما از هم جدا شوند، و نباید بعد از آخرین پارامتر کامایی
قرار گیرد. هنگام مرتب‌سازی مجدد یک فایل پیکربندی، انتقال یک پارامتر به آخرین جایگاه
در یک حوزه یا خارج کردن آن از آخرین جایگاه ممکن است نیازمند جابه‌جایی کاما نیز باشد.
نکتهٔ دوم این است که تکرار چندین‌بارهٔ یک پارامتر، گرچه در ساختار JSON مجاز است،
اما نامعمول می‌باشد. در صورت وقوع این اتفاق، آخرین تکرار یک پارامتر معین در یک حوزهٔ
خاص استفاده می‌شود، در حالی که تمامی موارد پیشین نادیده گرفته می‌شوند. بعید است
این موضوع سبب سردرگمی شود، چرا که در عمل هیچ دلیلی برای نگهداری چندین نسخه از
یک پارامتر یکسان در فایل پیکربندی وجود ندارد.
.sp
چند مؤلفهٔ نخست پیکربندی DHCPv4 برخی پارامترهای سراسری (global) را
تعریف می‌کنند. \fBvalid\-lifetime\fP تعیین می‌کند نشانی‌های (اجاره‌های) واگذارشده
توسط سرور تا چه مدت معتبر هستند؛ حالت پیش‌فرض این است که یک کلاینت مجاز
باشد از یک نشانی مشخص برای ۴۰۰۰ ثانیه استفاده کند. (توجه داشته باشید که اعداد صحیح به همان
صورت، بدون هیچ‌گونه گیومه در اطرافشان، مشخص می‌شوند.) \fBrenew\-timer\fP و \fBrebind\-timer\fP
مقادیری (همچنین به ثانیه) هستند که زمان‌سنج‌های T1 و T2 را تعریف می‌کنند؛ این زمان‌سنج‌ها
زمان آغاز فرایندهای تمدید (renewal) و اتصال مجدد (rebind) توسط کلاینت را کنترل می‌کنند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
طول‌عمر معتبر اجاره به‌صورت یک سه‌تایی با مقادیر کمینه، پیش‌فرض، و
بیشینه با استفاده از مدخل‌های پیکربندی
\fBmin\-valid\-lifetime\fP، \fBvalid\-lifetime\fP و \fBmax\-valid\-lifetime\fP بیان می‌شود\&.
از نسخهٔ Kea 1.9.5 به بعد، این مقادیر می‌توانند در کلاس‌های کلاینت مشخص شوند. روالی
که سرور برای انتخاب مقدار طول‌عمر مورد استفاده به کار می‌برد به شرح زیر است:
.sp
اگر پرس‌وجوی کلاینت یک پرس‌وجوی BOOTP باشد، سرور همواره از زمان اجارهٔ
نامحدود (مانند 0xffffffff) استفاده می‌کند. در غیر این صورت، سرور باید با جستجو
در تمامی کلاس‌های اختصاص‌یافته به پرس‌وجو و سپس زیرشبکهٔ انتخاب‌شده برای
پرس‌وجو، تعیین کند کدام سه‌تاییِ پیکربندی‌شده باید استفاده شود.
.sp
کلاس‌ها به همان ترتیبی که به پرس‌وجو اختصاص یافته‌اند جستجو می‌شوند؛ سرور
از سه‌تاییِ نخستین کلاسی که آن را مشخص کرده باشد استفاده می‌کند.
اگر هیچ کلاسی این سه‌تایی را مشخص نکرده باشد، سرور از سه‌تایی مشخص‌شده
توسط زیرشبکهٔ انتخاب‌شده برای کلاینت استفاده می‌کند. اگر زیرشبکه صراحتاً
آن را مشخص نکرده باشد، سرور در مرحلهٔ بعد shared\-network مربوط به
زیرشبکه را (در صورت وجود) بررسی می‌کند، سپس به دنبال مشخصهٔ سراسری می‌گردد، و
در نهایت مقدار پیش‌فرض سراسری را به کار می‌گیرد.
.sp
اگر کلاینت مقدار طول‌عمری را از طریق DHCP option 51 درخواست کرده باشد، آن‌گاه
مقدار طول‌عمر استفاده‌شده همان مقدار درخواستی خواهد بود که توسط سه‌تاییِ
پیکربندی‌شده محدود می‌شود. به عبارت دیگر، اگر طول‌عمر درخواستی کمتر از کمینهٔ
پیکربندی‌شده باشد، کمینهٔ پیکربندی‌شده استفاده می‌شود؛ اگر بیشتر از بیشینهٔ
پیکربندی‌شده باشد، بیشینهٔ پیکربندی‌شده به کار می‌رود. اگر کلاینت مقداری را
درخواست نکرده باشد، مقدار طول‌عمر استفاده‌شده، مقدار پیش‌فرض سه‌تایی خواهد بود.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
هر دو پارامتر \fBrenew\-timer\fP و \fBrebind\-timer\fP
اختیاری هستند. سرور تنها در صورتی \fBrebind\-timer\fP را از طریق DHCPv4 option code 59 به کلاینت
ارسال می‌کند که کمتر از \fBvalid\-lifetime\fP باشد؛ و تنها در صورتی \fBrenew\-timer\fP را از طریق
DHCPv4 option code 58 ارسال می‌کند که کمتر از \fBrebind\-timer\fP باشد
(یا کمتر از \fBvalid\-lifetime\fP اگر \fBrebind\-timer\fP مشخص نشده باشد). در غیاب آن‌ها، کلاینت باید مقادیر
زمان‌سنج‌های T1 و T2 را بر اساس RFC 2131 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc2131>\& انتخاب کند.
برای جزئیات بیشتر در مورد تولید T1 و T2، به بخش Sending T1 (Option 58) and T2 (Option 59)
مراجعه کنید.
.UNINDENT
.UNINDENT
.sp
نگاشت \fBinterfaces\-config\fP رابط‌های شبکه‌ای را مشخص می‌کند که سرور
باید روی آن‌ها به پیام‌های DHCP گوش دهد. پارامتر \fBinterfaces\fP
فهرستی از رابط‌های شبکه را که سرور باید روی آن‌ها شنود کند مشخص می‌سازد. فهرست‌ها
با براکت‌های مربعی (قلاب) باز و بسته می‌شوند و عناصر با کاما از هم جدا می‌گردند. برای
شنود روی دو رابط، عنصر \fBinterfaces\-config\fP باید بدین صورت باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
\(dqinterfaces\-config\(dq: {
    \(dqinterfaces\(dq: [ \(dqeth0\(dq, \(dqeth1\(dq ]
},
\&...
}
.EE
.UNINDENT
.UNINDENT
.sp
خطوط بعدی پایگاه‌دادهٔ اجاره (lease database) را تعریف می‌کنند؛ محلی که
سرور اطلاعات اجاره‌های خود را در آن ذخیره می‌کند. این مثال ویژه به
سرور دستور می‌دهد از memfile استفاده کند که ساده‌ترین و سریع‌ترین backend پایگاه‌داده
است. این بک‌اند از یک پایگاه‌داده در حافظه (in\-memory) استفاده کرده و اجاره‌ها را روی دیسک
در یک فایل CSV (مقادیر جداشده با کاما) ذخیره می‌کند. این یک مثال پیکربندی بسیار ساده
است؛ معمولاً پیکربندی پایگاه‌دادهٔ اجاره جامع‌تر بوده و دربردارندهٔ
پارامترهای اضافی است. توجه داشته باشید که \fBlease\-database\fP یک شیء است و یک حوزهٔ
جدید را با استفاده از یک آکولاد باز آغاز می‌کند. پارامترهای آن (در این مثال تنها یک مورد:
\fBtype\fP) در ادامه می‌آیند. اگر بیش از یکی وجود داشت، با کاما از هم
جدا می‌شدند. این حوزه با یک آکولاد بسته خاتمه می‌یابد. از آنجا که پارامترهای
بیشتری برای تعریف \fBDhcp4\fP به دنبال آن می‌آیند، یک کامای پایانی وجود دارد.
.sp
در نهایت، باید فهرستی از زیرشبکه‌های IPv4 را تعریف کنیم. این مهم‌ترین
ساختار پیکربندی DHCPv4 است، چرا که سرور از این اطلاعات برای
پردازش درخواست‌های کلاینت‌ها استفاده می‌کند. این ساختار تمام زیرشبکه‌هایی را که
انتظار می‌رود سرور درخواست‌های DHCP را از آن‌ها دریافت کند، تعریف می‌کند. زیرشبکه‌ها
با پارامتر \fBsubnet4\fP مشخص می‌شوند. این پارامتر یک فهرست است، بنابراین با
براکت‌های مربعی باز و بسته می‌شود. هر تعریف زیرشبکه در فهرست، دارای
چندین مشخصهٔ مرتبط با خود است، بنابراین یک ساختار بوده و با
آکولاد باز و بسته می‌شود. در کمترین حالت، یک تعریف زیرشبکه باید دست‌کم
دو پارامتر داشته باشد: \fBsubnet\fP، که کل زیرشبکه را تعریف می‌کند؛ و
\fBpools\fP، که فهرستی از استخرهای تخصیص‌پذیر پویا (dynamically allocated pools) تحت
مدیریت سرور DHCP است.
.sp
این مثال شامل یک زیرشبکهٔ منفرد است. اگر بیش از یک مورد تعریف می‌شد،
عناصر اضافی در پارامتر \fBsubnet4\fP مشخص شده و با کاما از هم جدا می‌شدند.
برای نمونه، جهت تعریف سه زیرشبکه، از نحو (syntax) زیر استفاده می‌شد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
\(dqsubnet4\(dq: [
    {
        \(dqid\(dq: 1,
        \(dqpools\(dq: [ { \(dqpool\(dq:  \(dq192.0.2.1 \- 192.0.2.200\(dq } ],
        \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq
    },
    {
        \(dqid\(dq: 2,
        \(dqpools\(dq: [ { \(dqpool\(dq: \(dq192.0.3.100 \- 192.0.3.200\(dq } ],
        \(dqsubnet\(dq: \(dq192.0.3.0/24\(dq
    },
    {
        \(dqid\(dq: 3,
        \(dqpools\(dq: [ { \(dqpool\(dq: \(dq192.0.4.1 \- 192.0.4.254\(dq } ],
        \(dqsubnet\(dq: \(dq192.0.4.0/24\(dq
    }
],
\&...
}
.EE
.UNINDENT
.UNINDENT
.sp
توجه داشته باشید که تورفتگی اختیاری است و صرفاً برای خوانایی
و زیبایی به کار می‌رود. در برخی موارد ممکن است ترجیح داده شود از نشانه‌گذاری فشرده‌تری استفاده گردد.
.sp
پس از اینکه تمام پارامترها مشخص شدند، دو زمینه (context) باز وجود دارد:
\fBglobal\fP و \fBDhcp4\fP؛ از این رو، باید از دو براکت مجعد بسته (آکولاد بسته) برای بستن
آن‌ها استفاده شود..SS "ذخیره‌سازی اجاره‌ها (Lease Storage)"
.sp
همهٔ اجاره‌های صادرشده توسط سرور در پایگاه دادهٔ اجاره ذخیره می‌شوند.
سه بک‌اند پایگاه داده در دسترس است: memfile
(پیش‌فرض)، MySQL و PostgreSQL.
.SS "Memfile \- ذخیره‌سازی پایه برای اجاره‌ها (Memfile \- Basic Storage for Leases)"
.sp
سرور قادر است داده‌های اجاره را در مخازن مختلفی ذخیره کند. در استقرارهای
بزرگ‌تر ممکن است ذخیرهٔ اجاره‌ها در یک پایگاه داده ترجیح داده شود؛
بخش Lease Database Configuration این گزینه را شرح می‌دهد. با این حال، در
استقرارهای معمولی و کوچک‌تر، سرور اطلاعات اجاره را به جای پایگاه داده در
یک فایل CSV ذخیره می‌کند. استفاده از یک فایل برای ذخیره‌سازی علاوه بر اینکه
به مدیریت کمتری نیاز دارد، این مزیت را نیز دارد که
وابستگی به نرم‌افزارهای پایگاه دادهٔ شخص ثالث را از بین می‌برد.
.sp
پیکربندی بک‌اند memfile از طریق پارامترهای
\fBDhcp4\fP/\fBlease\-database\fP کنترل می‌شود. پارامتر \fBtype\fP اجباری است
و از طریق مقدار \fB\(dqmemfile\(dq\fP مشخص می‌کند که سرور باید از کدام فضای ذخیره‌سازی
برای اجاره‌ها استفاده کند. فهرست زیر پارامترهای اختیاری دیگری را ارائه می‌دهد
که می‌توان از آن‌ها برای پیکربندی بک‌اند memfile استفاده کرد.
.INDENT 0.0
.IP \(bu 2
\fBpersist\fP: کنترل می‌کند که آیا اجاره‌های جدید و به‌روزرسانی‌های اجاره‌های موجود
روی فایل نوشته شوند یا خیر. اکیداً توصیه می‌شود مقدار این پارامتر در تمام
طول فعالیت عادی سرور همواره روی \fBtrue\fP تنظیم باشد. ننوشتن اجاره‌ها روی دیسک به این معناست
که اگر سرور مجدداً راه‌اندازی شود (مثلاً پس از قطع برق)، متوجه نخواهد شد
که چه آدرس‌هایی اختصاص داده شده‌اند. در نتیجه، ممکن است به کلاینت‌های جدید
آدرس‌هایی را تخصیص دهد که هم‌اکنون در حال استفاده هستند. مقدار
\fBfalse\fP عمدتاً برای اهداف آزمایش عملکرد مفید است. مقدار
پیش‌فرض پارامتر \fBpersist\fP برابر با \fBtrue\fP است که فعال‌سازِ
نوشتن به‌روزرسانی‌های اجاره در فایل اجاره می‌باشد.
.IP \(bu 2
\fBname\fP: فایل اجاره‌ای را که اجاره‌های جدید و به‌روزرسانی‌های اجاره در آن
ثبت می‌شوند مشخص می‌کند. مقدار پیش‌فرض این پارامتر برابر است با:
\fB\(dq[kea\-install\-dir]/var/lib/kea/kea\-leases4.csv\(dq\fP\&.
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
از نسخهٔ Kea 2.7.9 به بعد، فایل‌های اجاره تنها می‌توانند از دایرکتوری داده‌ای که در
حین کامپایل مشخص شده است بارگذاری شوند: \fB\(dq[kea\-install\-dir]/var/lib/kea\(dq\fP\&. این
مسیر را می‌توان در هنگام راه‌اندازی با تنظیم متغیر محیطی
\fBKEA_DHCP_DATA_DIR\fP روی مسیر مورد نظر بازنویسی (override) کرد. اگر مسیری به غیر از
این مقدار در \fBname\fP استفاده شود، Kea با صدور خطا از راه‌اندازی خودداری می‌کند،
یا در صورتی که در حال اجرا باشد، یک خطای غیرقابل‌بازیابی را ثبت خواهد کرد. جهت سهولت در
تعیین یک نام فایل سفارشی، کافی است بخش مسیر را از \fBname\fP حذف کنید.
.UNINDENT
.UNINDENT
.INDENT 0.0
.IP \(bu 2
\fBlfc\-interval\fP: بازهٔ زمانی را بر حسب ثانیه مشخص می‌کند که سرور در آن،
پاک‌سازی فایل اجاره (LFC) را انجام می‌دهد. این عملیات اطلاعات
اضافی (تاریخچه‌ای) را از فایل اجاره حذف کرده و
به‌طور مؤثری حجم فایل اجاره را کاهش می‌دهد. فرایند پاک‌سازی
در ادامهٔ این بخش با جزئیات بیشتری توضیح داده شده است. مقدار پیش‌فرض
\fBlfc\-interval\fP برابر با \fB3600\fP است. مقدار \fB0\fP قابلیت LFC را غیرفعال می‌کند.
.IP \(bu 2
\fBmax\-row\-errors\fP: تعداد خطاهای ردیف را قبل از اینکه سرور از تلاش
برای بارگذاری فایل اجاره دست بکشد مشخص می‌کند. هنگامی که سرور یک فایل اجاره را بارگذاری می‌کند، آن را
ردیف به ردیف پردازش می‌نماید که هر ردیف حاوی یک اجاره است. اگر ردیفی معیوب باشد و
نتواند به درستی پردازش شود، سرور آن را لاگ کرده، ردیف را نادیده می‌گیرد
و به سراغ ردیف بعدی می‌رود. از این پارامتر می‌توان برای تعیین سقف مجاز بر روی
تعداد چنین ردیف‌های نادیده‌گرفته‌شده‌ای استفاده کرد، که پس از آن سرور تلاش را متوقف کرده و خارج می‌شود. مقدار پیش‌فرض
\fB0\fP این محدودیت را غیرفعال می‌کند و به سرور اجازه می‌دهد بدون در نظر گرفتن تعداد
ردیف‌های نادیده‌گرفته‌شده، کل فایل را پردازش کند.
.UNINDENT
.sp
یک نمونه از پیکربندی بک‌اند memfile در زیر ارائه شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqlease\-database\(dq: {
        \(dqtype\(dq: \(dqmemfile\(dq,
        \(dqpersist\(dq: true,
        \(dqname\(dq: \(dqkea\-leases4.csv\(dq,
        \(dqlfc\-interval\(dq: 1800,
        \(dqmax\-row\-errors\(dq: 100
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این پیکربندی، فایل \fBkea\-leases4.csv\fP را به عنوان فضای ذخیره‌سازی
اطلاعات اجاره انتخاب کرده و پایایی (نوشتن به‌روزرسانی‌های اجاره در این فایل) را
فعال می‌سازد. همچنین بک‌اند را به‌گونه‌ای تنظیم می‌کند که پاک‌سازی دوره‌ای فایل
اجاره را هر 1800 ثانیه (30 دقیقه) انجام دهد و حداکثر تعداد خطاهای ردیف
را روی 100 تعیین می‌نماید.
.SS "چرا پاک‌سازی فایل اجاره ضروری است؟ (Why Is Lease File Cleanup Necessary?)"
.sp
برای درک اینکه چرا پاک‌سازی دوره‌ای فایل اجاره ضروری است، مهم است بدانیم که محتویات
فایل اجاره چگونه سازمان‌دهی می‌شوند. هر بار که سرور اجاره‌ای را به‌روزرسانی می‌کند یا
اجارهٔ جدیدی برای یک کلاینت ایجاد می‌نماید، اطلاعات اجارهٔ جدید باید در فایل اجاره ثبت شود.
سرور به دلایل کارایی و عملکرد، اجارهٔ موجود کلاینت را در فایل بازنویسی نمی‌کند، چرا که
این کار بالقوه نیازمند بازنویسی کل فایل است. در عوض، به سادگی اطلاعات اجارهٔ جدید را به انتهای
فایل اضافه (append) می‌کند؛ ورودی‌های قبلی اجاره برای آن کلاینت حذف نمی‌شوند. هنگامی
که سرور اجاره‌ها را از فایل اجاره بارگذاری می‌کند (مثلاً هنگام راه‌اندازی سرور)، فرض را بر این می‌گذارد
که آخرین ورودی اجاره برای کلاینت، ورودی معتبر است. ورودی‌های پیشین نادیده گرفته می‌شوند،
بدین معنی که سرور می‌تواند اطلاعات دقیقی دربارهٔ اجاره‌ها بازسازی کند، حتی اگر
ورودی‌های متعددی برای هر کلاینت وجود داشته باشد. با این حال، ذخیرهٔ ورودی‌های زیاد
برای هر کلاینت منجر به حجیم شدن بیش از حد فایل اجاره شده و به عملکرد راه‌اندازی و
بازپیکربندی سرور آسیب می‌زند، چرا که نیاز به پردازش تعداد بیشتری از ورودی‌های اجاره خواهد داشت.
.sp
پاک‌سازی فایل اجاره (LFC) تمام ورودی‌های پیشین مربوط به هر کلاینت را حذف کرده و
تنها آخرین ورودی‌ها را باقی می‌گذارد. بازه‌ای که پاک‌سازی در آن انجام می‌شود قابل‌پیکربندی است
و باید با توجه به بسامد تمدید اجاره توسط کلاینت‌ها انتخاب گردد. هرچه تمدیدها مکررتر
باشد، مقدار \fBlfc\-interval\fP باید کوچک‌تر باشد. با این حال توجه داشته باشید که
عملیات LFC زمان‌بر است و بنابراین این احتمال (هرچند نامحتمل) وجود دارد که اگر \fBlfc\-interval\fP
بیش از حد کوتاه باشد، یک پاک‌سازی جدید در حالی آغاز شود که پاک‌سازی پیشین هنوز در حال اجراست.
سرور با نادیده گرفتن پاک‌سازی جدید در هنگام تشخیص در جریان بودن پاک‌سازی قبلی، این وضعیت را
مدیریت می‌کند، اما این امر بدین معناست که پاک‌سازی‌های واقعی در فواصل طولانی‌تری نسبت به بازهٔ
پیکربندی‌شده انجام خواهند شد. علاوه بر این، راه‌اندازی یک پاک‌سازی جدید بار اضافی (overhead) بر سرور
تحمیل می‌کند، زیرا در بازهٔ زمانی کوتاهی که فرایند پاک‌سازی جدید ایجاد (spawn) می‌شود،
سرور قادر به پاسخگویی به درخواست‌های جدید نیست. بنابراین، توصیه می‌شود مقدار
\fBlfc\-interval\fP به گونه‌ای انتخاب شود که به LFC اجازه دهد پیش از شروع یک پاک‌سازی جدید،
فرایند پاک‌سازی فعلی را تکمیل کند.
.sp
پاک‌سازی فایل اجاره توسط یک فرایند جداگانه (در پس‌زمینه) انجام می‌شود تا از تأثیر منفی
بر عملکرد فرایند اصلی سرور جلوگیری شود. برای جلوگیری از تداخل بین دو فرایند که از فایل‌های
اجارهٔ یکسانی استفاده می‌کنند، فرایند LFC با باز کردن یک فایل اجارهٔ جدید توسط Kea آغاز
می‌شود؛ فرایند واقعی LFC بر روی فایل اجاره‌ای عمل می‌کند که دیگر توسط سرور استفاده نمی‌شود.
همچنین فایل‌های دیگری نیز به عنوان اثر جانبی پاک‌سازی فایل اجاره ایجاد می‌شوند. شرح تفصیلی
فرایند LFC در بخش‌های بعدی این Kea Administrator\(aqs Reference Manual تحت عنوان
The LFC Process \%<#\:kea-lfc>\& آمده است..SS پیکربندی پایگاه‌داده اجاره‌ها (Lease Database Configuration)
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
اطلاعات دسترسی به پایگاه‌داده اجاره‌ها باید برای کارساز DHCPv4 پیکربندی شود، حتی اگر پیش‌تر برای کارساز DHCPv6 پیکربندی شده باشد. کارسازها اطلاعات خود را به‌طور مستقل ذخیره می‌کنند، بنابراین هر کارساز می‌تواند از یک پایگاه‌داده جداگانه استفاده کند یا هر دو کارساز می‌توانند از یک پایگاه‌داده یکسان استفاده نمایند.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
برنامه Kea نیازمند آن است که منطقه زمانی (timezone) پایگاه‌داده با منطقه زمانی سیستم مطابقت داشته باشد. برای جزئیات بیشتر، First\-Time Creation of the MySQL Database \%<#\:mysql-database-create> و First\-Time Creation of the PostgreSQL Database \%<#\:pgsql-database-create>\& را ببینید.
.UNINDENT
.UNINDENT
.sp
پیکربندی پایگاه‌داده اجاره‌ها از طریق پارامترهای \fBDhcp4\fP/\fBlease\-database\fP کنترل می‌شود. نوع پایگاه‌داده باید روی \fBmemfile\fP، \fBmysql\fP یا \fBpostgresql\fP تنظیم شود، برای مثال:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: { \(dqlease\-database\(dq: { \(dqtype\(dq: \(dqmysql\(dq, ... }, ... }
.EE
.UNINDENT
.UNINDENT
.sp
سپس، نام پایگاه‌داده‌ای که اجاره‌ها را در خود نگه می‌دارد باید مشخص شود؛ این همان نامی است که هنگام ایجاد پایگاه‌داده استفاده شده است (ببینید First\-Time Creation of the MySQL Database \%<#\:mysql-database-create> یا First\-Time Creation of the PostgreSQL Database \%<#\:pgsql-database-create>).
.sp
برای MySQL یا PostgreSQL:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: { \(dqlease\-database\(dq: { \(dqname\(dq: \(dqdatabase\-name\(dq , ... }, ... }
.EE
.UNINDENT
.UNINDENT
.sp
اگر پایگاه‌داده در سیستمی متفاوت از کارساز DHCPv4 قرار دارد، نام میزبان (host name) پایگاه‌داده نیز باید مشخص شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: { \(dqlease\-database\(dq: { \(dqhost\(dq: \(dqremote\-host\-name\(dq, ... }, ... }
.EE
.UNINDENT
.UNINDENT
.sp
به‌طور معمول، پایگاه‌داده روی همان ماشین کارساز DHCPv4 قرار دارد. در این حالت، مقدار را روی رشته خالی تنظیم کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: { \(dqlease\-database\(dq: { \(dqhost\(dq : \(dq\(dq, ... }, ... }
.EE
.UNINDENT
.UNINDENT
.sp
اگر پایگاه‌داده از درگاهی به غیر از درگاه پیش‌فرض استفاده کند، می‌توان آن را نیز مشخص کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: { \(dqlease\-database\(dq: { \(dqport\(dq : 12345, ... }, ... }
.EE
.UNINDENT
.UNINDENT
.sp
چنانچه پایگاه‌داده در سیستم دیگری قرار داشته باشد، ممکن است مدیر سیستم نیاز داشته باشد بازه زمانی طولانی‌تری را برای مهلت زمانی اتصال (connection timeout) مشخص کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: { \(dqlease\-database\(dq: { \(dqconnect\-timeout\(dq : timeout\-in\-seconds, ... }, ... }
.EE
.UNINDENT
.UNINDENT
.sp
مقدار پیش‌فرض پنج ثانیه باید برای اتصالات محلی کاملاً کافی باشد. با این حال، در صورت تعیین مهلت زمانی، این مقدار باید یک عدد صحیح بزرگ‌تر از صفر باشد.
.sp
حداکثر دفعاتی که کارساز پس از قطع ارتباط، به‌طور خودکار تلاش می‌کند تا دوباره به پایگاه‌داده اجاره‌ها متصل شود، می‌تواند مشخص شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: { \(dqlease\-database\(dq: { \(dqmax\-reconnect\-tries\(dq : number\-of\-tries, ... }, ... }
.EE
.UNINDENT
.UNINDENT
.sp
اگر کارساز پس از انجام حداکثر دفعات تلاش نتواند مجدداً به پایگاه‌داده متصل شود، کارساز خارج خواهد شد. مقدار 0 (پیش‌فرض) بازیابی خودکار را غیرفعال می‌کند و کارساز بلافاصله پس از تشخیص قطعی اتصال خارج می‌شود (فقط در MySQL و PostgreSQL).
.sp
تعداد میلی‌ثانیه‌هایی که کارساز بین دفعات تلاش برای اتصال مجدد به پایگاه‌داده اجاره‌ها پس از قطع اتصال منتظر می‌ماند نیز می‌تواند مشخص شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: { \(dqlease\-database\(dq: { \(dqreconnect\-wait\-time\(dq : number\-of\-milliseconds, ... }, ... }
.EE
.UNINDENT
.UNINDENT
.sp
مقدار پیش‌فرض برای MySQL و PostgreSQL برابر با 0 است که بازیابی خودکار را غیرفعال کرده و باعث می‌شود کارساز بلافاصله پس از تشخیص قطعی اتصال خارج شود.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: { \(dqlease\-database\(dq: { \(dqon\-fail\(dq : \(dqstop\-retry\-exit\(dq, ... }, ... }
.EE
.UNINDENT
.UNINDENT
.sp
مقادیر ممکن عبارتند از:
.INDENT 0.0
.IP \(bu 2
\fBstop\-retry\-exit\fP \- سرویس DHCP را در حین تلاش برای بازیابی خودکار اتصالات قطع‌شده غیرفعال می‌کند، و در صورت شکست پس از به پایان رسیدن \fBmax\-reconnect\-tries\fP، کارساز را خاموش می‌نماید. این مقدار پیش‌فرض برای بک‌اند اجاره‌ها، بک‌اند میزبان‌ها و بک‌اند پیکربندی است.
.IP \(bu 2
\fBserve\-retry\-exit\fP \- سرویس DHCP را در حین تلاش برای بازیابی خودکار اتصالات قطع‌شده ادامه می‌دهد، و در صورت شکست پس از به پایان رسیدن \fBmax\-reconnect\-tries\fP، کارساز را خاموش می‌کند.
.IP \(bu 2
\fBserve\-retry\-continue\fP \- سرویس DHCP را ادامه می‌دهد و حتی در صورت ناموفق بودن بازیابی، کارساز را خاموش نمی‌کند. این مقدار پیش‌فرض برای forensic logging است.
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
اتصال مجدد خودکار به بک‌اندهای پایگاه‌داده به‌طور مجزا برای هر بک‌اند پیکربندی می‌شود؛ این قابلیت به کاربران امکان می‌دهد تا پارامترهای بازیابی را متناسب با هر بک‌اندی که استفاده می‌کنند تنظیم نمایند. ما پیشنهاد می‌کنیم که کاربران آن را یا برای همه بک‌اندها فعال کنند یا برای هیچ‌کدام، تا رفتار سیستم یکپارچه و سازگار باشد.
.sp
از دست رفتن ارتباط با بک‌اندی که اتصال مجدد برای آن غیرفعال است (در صورت پیکربندی) منجر به خاموش شدن کارساز خواهد شد. این موضوع مواردی را نیز در بر می‌گیرد که بک‌اند پایگاه‌داده اجاره‌ها و بک‌اند پایگاه‌داده میزبان‌ها به یک نمونه (instance) پایگاه‌داده یکسان متصل هستند.
.sp
اکیداً توصیه می‌شود تنظیم پیش‌فرض \fBstop\-retry\-exit\fP را برای مدیر اجاره‌ها تغییر ندهید، چرا که فعال بودن اتصال در حین پردازش ترافیک DHCP بسیار حیاتی است. این مورد را تنها در صورتی تغییر دهید که کارساز منحصراً به‌عنوان یک ابزار پیکربندی استفاده شود.
.UNINDENT
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: { \(dqlease\-database\(dq: { \(dqretry\-on\-startup\(dq : true, ... }, ... }
.EE
.UNINDENT
.UNINDENT
.sp
در حین راه‌اندازی کارساز، ناتوانی در اتصال به هر یک از بک‌اندهای پیکربندی‌شده تنها در صورتی یک خطای مهلک تلقی می‌شود که \fBretry\-on\-startup\fP روی \fBfalse\fP (پیش‌فرض) تنظیم شده باشد. با این فرض که پیکربندی در زمان راه‌اندازی باید معتبر باشد، یک خطای مهلک ثبت شده و کارساز خارج می‌شود. خروج به سیستم‌عامل این امکان را به اسکریپت‌های ناظر (nanny scripts) می‌دهد تا مشکل را تشخیص دهند. اگر \fBretry\-on\-startup\fP روی \fBtrue\fP تنظیم شود، کارساز تلاش‌های اتصال مجدد را حتی در زمان راه‌اندازی کارساز یا در هنگام رویدادهای پیکربندی مجدد آغاز می‌کند و اقدام مشخص‌شده در پارامتر \fBon\-fail\fP را رعایت می‌نماید.
.sp
پارامتر host توسط بک‌اندهای MySQL و PostgreSQL استفاده می‌شود.
.sp
در نهایت، باید اعتبارنامه‌های حسابی که کارساز تحت آن به پایگاه‌داده دسترسی خواهد داشت تعیین شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqlease\-database\(dq: {
        \(dquser\(dq: \(dquser\-name\(dq,
        \(dqpassword\(dq: \(dq1234\(dq,
        ...
    },
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر حساب کاربری رمز عبور ندارد، گذرواژه را روی یک رشته خالی \fB\(dq\(dq\fP تنظیم کنید. (این حالت پیش‌فرض است.).SS تنظیم مهلت‌های زمانی پایگاه داده (Tuning Database Timeouts)
.sp
در موارد نادر، ممکن است عملیات خواندن یا نوشتن در پایگاه داده معلق شود (hang کند). این امر می‌تواند ناشی از یک مشکل موقتی شبکه، یا پیکربندی نادرست سرور پراکسی باشد که اتصال را میان نمونه‌های مختلف پایگاه داده جابه‌جا می‌کند. این شرایط نادر هستند، اما کاربران گزارش داده‌اند که Kea گاهی هنگام انجام عملیات‌های ورودی/خروجی (IO) پایگاه داده متوقف می‌شود. تنظیم مقادیر مناسب برای مهلت زمانی (timeout) می‌تواند چنین مشکلاتی را کاهش دهد.
.sp
پایگاه داده MySQL دو گزینهٔ اتصال مجزا را برای پیکربندی مهلت‌های زمانی خواندن و نوشتن ارائه می‌دهد. پارامترهای پیکربندی متناظر \fBread\-timeout\fP و \fBwrite\-timeout\fP در Kea، مهلت‌های زمانی را بر حسب ثانیه مشخص می‌کنند. برای نمونه:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: { \(dqlease\-database\(dq: { \(dqread\-timeout\(dq : 10, \(dqwrite\-timeout\(dq: 20, ... }, ... }
.EE
.UNINDENT
.UNINDENT
.sp
تنظیم این پارامترها روی 0 معادل مشخص نکردن آن‌ها است و سبب می‌شود سرور Kea با مقادیر پیش‌فرض MySQL به پایگاه داده متصل شود. در این حالت، Kea برای تکمیل عملیات‌های خواندن و نوشتن به‌طور نامحدود منتظر می‌ماند.
.sp
نسخه‌های قدیمی‌تر از 5.6 در MySQL از تنظیم مهلت زمانی برای عملیات خواندن و نوشتن پشتیبانی نمی‌کنند. علاوه‌بر این، پارامترهای \fBread\-timeout\fP و \fBwrite\-timeout\fP تنها می‌توانند برای بک‌اند MySQL مشخص شوند؛ تنظیم آن‌ها برای هر نوع بک‌اند پایگاه دادهٔ دیگر موجب خطای پیکربندی خواهد شد.
.sp
برای تنظیم مهلت زمانی بر حسب ثانیه در PostgreSQL، از پارامتر \fBtcp\-user\-timeout\fP استفاده کنید. برای نمونه:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: { \(dqlease\-database\(dq: { \(dqtcp\-user\-timeout\(dq : 10, ... }, ... }
.EE
.UNINDENT
.UNINDENT
.sp
مشخص کردن این پارامتر برای انواع دیگر بک‌اند موجب خطای پیکربندی خواهد شد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
مهلت‌های زمانی شرح داده شده در اینجا تنها برای اتصالات TCP مؤثر هستند. لطفاً توجه داشته باشید که کتابخانه کلاینت MySQL مورداستفاده در سرورهای Kea، معمولاً هنگامی که پارامتر \fBhost\fP روی \fBlocalhost\fP تنظیم شده باشد، از طریق یک سوکت دامنه یونیکس (UNIX domain socket) به پایگاه داده متصل می‌شود، اما برای \fB127.0.0.1\fP یک اتصال TCP برقرار می‌کند\&.
.UNINDENT
.UNINDENT
.sp
از Kea.2.7.4 به بعد، کتابخانهٔ قلاب libdhcp_mysql.so باید بارگذاری شود تا بتوان اجاره‌ها را در بک‌اند پایگاه دادهٔ اجارهٔ MySQL ذخیره کرد. مکان کتابخانهٔ قلاب بک‌اند اجاره را مشخص کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: { \(dqhooks\-libraries\(dq: [
    {
        // the MySQL lease backend hook library required for lease storage.
        \(dqlibrary\(dq: \(dqlibdhcp_mysql.so\(dq
    }, ... ], ... }
.EE
.UNINDENT
.UNINDENT
.sp
از Kea.2.7.4 به بعد، کتابخانهٔ قلاب libdhcp_pgsql.so باید بارگذاری شود تا بتوان اجاره‌ها را در بک‌اند پایگاه دادهٔ اجارهٔ PostgreSQL ذخیره کرد. مکان کتابخانهٔ قلاب بک‌اند اجاره را مشخص کنید.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: { \(dqhooks\-libraries\(dq: [
    {
        // the PostgreSQL lease backend hook library required for lease storage.
        \(dqlibrary\(dq: \(dqlibdhcp_pgsql.so\(dq
    }, ... ], ... }
.EE
.UNINDENT
.UNINDENT
.SS ذخیره‌سازی میزبان‌ها (Hosts Storage)
.sp
همچنین Kea قادر است اطلاعات مربوط به رزروهای میزبان (host reservations) را در پایگاه داده ذخیره کند. پیکربندی پایگاه دادهٔ میزبان‌ها از همان ساختار نحوی پایگاه دادهٔ اجاره‌ها استفاده می‌کند. در واقع، سرور Kea برای هر هدف، چه اطلاعات اجاره و چه میزبان‌ها، اتصال‌های مستقلی باز می‌کند که بیشترین انعطاف‌پذیری را فراهم می‌آورد. Kea می‌تواند اجاره‌ها و رزروهای میزبان را به‌طور جداگانه نگهداری کند، اما می‌تواند به یک پایگاه دادهٔ یکسان نیز اشاره داشته باشد. در حال حاضر، انواع پایگاه دادهٔ میزبان‌های پشتیبانی‌شده MySQL و PostgreSQL هستند.
.sp
از پیکربندی زیر می‌توان برای تنظیم اتصال به MySQL استفاده کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqhosts\-database\(dq: {
        \(dqtype\(dq: \(dqmysql\(dq,
        \(dqname\(dq: \(dqkea\(dq,
        \(dquser\(dq: \(dqkea\(dq,
        \(dqpassword\(dq: \(dq1234\(dq,
        \(dqhost\(dq: \(dqlocalhost\(dq,
        \(dqport\(dq: 3306
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
بسته به پیکربندی پایگاه داده، بسیاری از پارامترها ممکن است اختیاری باشند.
.sp
لطفاً توجه داشته باشید که استفاده از ذخیره‌سازی میزبان‌ها اختیاری است. کاربر می‌تواند تمامی رزروهای میزبان را در فایل پیکربندی تعریف کند و چنانچه تعداد رزروها اندک باشد، این شیوه توصیه‌شده است. با این حال، هنگامی که تعداد رزروها افزایش می‌یابد، استفاده از فضای ذخیره‌سازی میزبان راحت‌تر خواهد بود. لطفاً در نظر داشته باشید که هر دو روش ذخیره‌سازی (فایل پیکربندی و یکی از پایگاه‌های دادهٔ پشتیبانی‌شده) می‌توانند هم‌زمان استفاده شوند. اگر میزبان‌ها در هر دو مکان تعریف شده باشند، ابتدا تعاریف فایل پیکربندی بررسی می‌شوند و سپس در صورت لزوم، فضای ذخیره‌سازی خارجی بررسی خواهد شد.
.sp
اطلاعات میزبان می‌تواند در چندین مخزن قرار داده شود. عملیات‌ها بر اساس ترتیبی که مخازن در فایل پیکربندی تعریف شده‌اند روی آن‌ها انجام می‌شود، هرچند این امر در صورت افزودن رزرو میزبان به محدودیتی در ترتیب منجر می‌شود؛ مخازن فقط‌خواندنی (read\-only) باید پس از یک مخزن خواندنی\-نوشتنی (read\-write) الزامی پیکربندی شوند، وگرنه عملیات افزودن با شکست مواجه خواهد شد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
در Kea الزامی است که منطقه زمانی (timezone) پایگاه داده با منطقه زمانی سیستم مطابقت داشته باشد. برای جزئیات بیشتر، First\-Time Creation of the MySQL Database \%<#\:mysql-database-create> و First\-Time Creation of the PostgreSQL Database \%<#\:pgsql-database-create> را ببینید\&.
.UNINDENT
.UNINDENT.SS پیکربندی پایگاه‌داده میزبان‌های DHCPv4
.sp
پیکربندی پایگاه‌داده میزبان‌ها از طریق پارامترهای
\fBDhcp4\fP/\fBhosts\-database\fP کنترل می‌شود. در صورت فعال بودن، نوع پایگاه‌داده باید
روی \fBmysql\fP یا \fBpostgresql\fP تنظیم شود\&.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: { \(dqhosts\-database\(dq: { \(dqtype\(dq: \(dqmysql\(dq, ... }, ... }
.EE
.UNINDENT
.UNINDENT
.sp
سپس، نام پایگاه‌داده‌ای که رزروها را نگهداری می‌کند باید مشخص شود؛
این همان نامی است که هنگام ایجاد پایگاه‌داده اجاره‌ها (lease) استفاده شده است (برای دستورالعمل‌های
نحوه راه‌اندازی نوع پایگاه‌داده مورد نظر، بخش پس‌انه‌های پشتیبانی‌شده \%<#\:supported-databases> را ببینید):
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: { \(dqhosts\-database\(dq: { \(dqname\(dq: \(dqdatabase\-name\(dq , ... }, ... }
.EE
.UNINDENT
.UNINDENT
.sp
اگر پایگاه‌داده روی سیستمی متفاوت از کارساز DHCPv4 قرار دارد،
نام میزبان پایگاه‌داده نیز باید مشخص شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: { \(dqhosts\-database\(dq: { \(dqhost\(dq: remote\-host\-name, ... }, ... }
.EE
.UNINDENT
.UNINDENT
.sp
به طور معمول، پایگاه‌داده روی همان رایانه‌ای قرار دارد که کارساز DHCPv4 اجرا می‌شود.
در این حالت، مقدار را روی یک رشته خالی تنظیم کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: { \(dqhosts\-database\(dq: { \(dqhost\(dq : \(dq\(dq, ... }, ... }
.EE
.UNINDENT
.UNINDENT
.sp
اگر پایگاه‌داده از درگاهی غیر از پیش‌فرض استفاده کند، آن درگاه
نیز می‌تواند مشخص شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: { \(dqhosts\-database\(dq: { \(dqport\(dq : 12345, ... }, ... }
.EE
.UNINDENT
.UNINDENT
.sp
حداکثر دفعاتی که کارساز پس از قطع ارتباط، به طور خودکار برای
اتصال دوباره به پایگاه‌داده میزبان تلاش می‌کند را می‌توان
مشخص کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: { \(dqhosts\-database\(dq: { \(dqmax\-reconnect\-tries\(dq : number\-of\-tries, ... }, ... }
.EE
.UNINDENT
.UNINDENT
.sp
اگر کارساز پس از انجام حداکثر دفعات تلاش نتواند دوباره به پایگاه‌داده
متصل شود، کارساز خارج خواهد شد. مقدار 0 (پیش‌فرض) بازیابی
خودکار را غیرفعال می‌کند و کارساز بلافاصله پس از تشخیص قطعی اتصال
خارج می‌شود (تنها در MySQL و PostgreSQL).
.sp
تعداد میلی‌ثانیه‌هایی که کارساز میان دفعات تلاش برای اتصال دوباره
به پایگاه‌داده میزبان پس از قطعی اتصال منتظر می‌ماند نیز می‌تواند
تعیین شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: { \(dqhosts\-database\(dq: { \(dqreconnect\-wait\-time\(dq : number\-of\-milliseconds, ... }, ... }
.EE
.UNINDENT
.UNINDENT
.sp
مقدار پیش‌فرض برای MySQL و PostgreSQL برابر با 0 است که بازیابی
خودکار را غیرفعال کرده و باعث می‌شود کارساز بلافاصله پس از
تشخیص قطعی اتصال متوقف شود.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: { \(dqhosts\-database\(dq: { \(dqon\-fail\(dq : \(dqstop\-retry\-exit\(dq, ... }, ... }
.EE
.UNINDENT
.UNINDENT
.sp
مقدارهای ممکن عبارتند از:
.INDENT 0.0
.IP \(bu 2
\fBstop\-retry\-exit\fP \- هنگام تلاش برای بازیابی خودکار اتصالات قطع‌شده،
سرویس DHCP را غیرفعال می‌کند. در صورت شکست پس از پایان دفعات مجاز
\fBmax\-reconnect\-tries\fP، کارساز را خاموش می‌کند\&. این مقدار پیش‌فرض برای MySQL و PostgreSQL است.
.IP \(bu 2
\fBserve\-retry\-exit\fP \- هنگام تلاش برای بازیابی خودکار اتصالات قطع‌شده،
به سرویس‌دهی DHCP ادامه می‌دهد. در صورت شکست پس از پایان دفعات مجاز
\fBmax\-reconnect\-tries\fP، کارساز را خاموش می‌کند\&.
.IP \(bu 2
\fBserve\-retry\-continue\fP \- به سرویس‌دهی DHCP ادامه می‌دهد و حتی اگر
بازیابی شکست بخورد، کارساز را خاموش نمی‌کند.
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
اتصال دوباره خودکار به پس‌انه‌های پایگاه‌داده به صورت جداگانه برای هر
پس‌انه پیکربندی می‌شود. این به کاربران امکان می‌دهد پارامترهای بازیابی را متناسب با هر
پس‌انه‌ای که استفاده می‌کنند تنظیم کنند. پیشنهاد می‌کنیم کاربران آن را یا برای همه پس‌انه‌ها
فعال کنند یا برای هیچ‌کدام، تا رفتار سیستم یکپارچه باقی بماند.
.sp
از دست رفتن ارتباط با پس‌انه‌ای که اتصال مجدد برای آن غیرفعال است منجر
(در صورت پیکربندی) به خاموش شدن خودکار کارساز می‌شود. این مورد شامل شرایطی نیز
می‌شود که در آن، پس‌انه پایگاه‌داده اجاره‌ها و پس‌انه پایگاه‌داده میزبان‌ها به یک
نمونه یکسان از پایگاه‌داده متصل هستند.
.UNINDENT
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: { \(dqhosts\-database\(dq: { \(dqretry\-on\-startup\(dq : true, ... }, ... }
.EE
.UNINDENT
.UNINDENT
.sp
در طول راه‌اندازی کارساز، ناتوانی در اتصال به هر یک از پس‌انه‌های پیکربندی‌شده
تنها در صورتی مهلک تلقی می‌شود که \fBretry\-on\-startup\fP روی \fBfalse\fP
(پیش‌فرض) تنظیم شده باشد. یک خطای مهلک ثبت شده و کارساز خارج می‌شود، بر این مبنا
که پیکربندی در زمان راه‌اندازی باید معتبر باشد. خروج و بازگشت به سیستم‌عامل
به اسکریپت‌های ناظر (nanny scripts) امکان می‌دهد تا مشکل را شناسایی کنند.
اگر \fBretry\-on\-startup\fP روی \fBtrue\fP تنظیم شود، کارساز حتی در زمان راه‌اندازی
یا رویدادهای بازپیکربندی نیز تلاش‌ها برای اتصال دوباره را آغاز می‌کند و اقدام
مشخص‌شده در پارامتر \fBon\-fail\fP را به کار می‌بندد.
.sp
در پایان، اعتبارنامه‌های حسابی که کارساز تحت آن به پایگاه‌داده
دسترسی خواهد داشت باید تنظیم شوند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqhosts\-database\(dq: {
        \(dquser\(dq: \(dquser\-name\(dq,
        \(dqpassword\(dq: \(dq1234\(dq,
        ...
    },
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر حساب گذرواژه‌ای ندارد، گذرواژه را روی رشته خالی
\fB\(dq\(dq\fP تنظیم کنید\&. (این حالت پیش‌فرض است.)
.sp
افزونه multiple\-storage از نحو مشابهی استفاده می‌کند؛ پیکربندی به جای یک
مدخل \fBhosts\-database\fP در یک فهرست \fBhosts\-databases\fP قرار
می‌گیرد، مانند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: { \(dqhosts\-databases\(dq: [ { \(dqtype\(dq: \(dqmysql\(dq, ... }, ... ], ... }
.EE
.UNINDENT
.UNINDENT
.sp
اگر یک میزبان یکسان هم درون فایل (in\-file) و هم درون پایگاه‌داده (in\-database) پیکربندی شده باشد، Kea هشداری صادر نمی‌کند،
برخلاف زمانی که هر دو در یک منبع داده یکسان مشخص شده باشند.
در عوض، میزبان پیکربندی‌شده درون فایل نسبت به میزبان پیکربندی‌شده
درون پایگاه‌داده اولویت دارد..SS استفاده از پایگاه‌های داده فقط\-خواندنی برای رزروهای میزبان با DHCPv4
.sp
در برخی استقرارها، کاربری که نامش در پیکربندی backend پایگاه داده مشخص شده است، ممکن است مجوز نوشتن روی پایگاه داده را نداشته باشد. این موضوع اغلب ناشی از سیاست‌های یک شبکه برای محافظت از داده‌ها در برابر تغییرات ناخواسته است. در بسیاری از موارد مدیران سیستم پایگاه‌های داده انبارگردانی (inventory) را مستقر کرده‌اند که حاوی اطلاعات به مراتب بیشتری درباره میزبان‌ها نسبت به صرفاً رزروهای ایستا اختصاص‌یافته به آن‌هاست. پایگاه داده انبارگردانی می‌تواند برای ایجاد یک نما (view) از پایگاه داده میزبان‌های Kea مورد استفاده قرار گیرد و چنین نمایی اغلب فقط\-خواندنی (read\-only) است.
.sp
بک‌اندهای پایگاه داده میزبان Kea با یک پیکربندی ضمنی برای خواندن و نوشتن هم‌زمان در پایگاه داده کار می‌کنند. اگر کاربر دسترسی نوشتن به پایگاه داده میزبان را نداشته باشد، راه‌اندازی بک‌اند با شکست مواجه شده و سرور از شروع به کار (یا بازپیکربندی) سر باز می‌زند. با این حال، اگر دسترسی به یک پایگاه داده میزبانِ فقط\-خواندنی برای بازیابی رزروهای کلاینت‌ها و/یا انتساب نشانی‌ها و گزینه‌های خاص مورد نیاز باشد، می‌توان Kea را صریحاً برای اجرا در حالت \(dqread\-only\(dq پیکربندی کرد. این حالت توسط پارامتر بولی \fBreadonly\fP به صورت زیر کنترل می‌شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: { \(dqhosts\-database\(dq: { \(dqreadonly\(dq: true, ... }, ... }
.EE
.UNINDENT
.UNINDENT
.sp
تنظیم این پارامتر روی \fBfalse\fP، بک‌اند پایگاه داده را برای فعالیت در حالت \(dqread\-write\(dq پیکربندی می‌کند، که در صورت مشخص نشدن پارامتر، پیکربندی پیش‌فرض نیز همین است.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
پارامتر \fBreadonly\fP تنها برای پایگاه‌های داده MySQL و PostgreSQL پشتیبانی می‌شود.
.UNINDENT
.UNINDENT
.sp
از نسخه Kea.2.7.4 به بعد، کتابخانه قلاب (hook library) libdhcp_mysql.so باید بارگیری شود تا رزروهای میزبان در MySQL Host Database Backend ذخیره شوند.
مکان کتابخانه قلاب بک‌اند اجاره (lease) را مشخص کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: { \(dqhooks\-libraries\(dq: [
    {
        // the MySQL host backend hook library required for host storage.
        \(dqlibrary\(dq: \(dqlibdhcp_mysql.so\(dq
    }, ... ], ... }
.EE
.UNINDENT
.UNINDENT
.sp
از نسخه Kea.2.7.4 به بعد، کتابخانه قلاب libdhcp_pgsql.so باید بارگیری شود تا رزروهای میزبان در PostgreSQL Host Database Backend ذخیره شوند.
مکان کتابخانه قلاب بک‌اند اجاره را مشخص کنید.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: { \(dqhooks\-libraries\(dq: [
    {
        // the PostgreSQL host backend hook library required for host storage.
        \(dqlibrary\(dq: \(dqlibdhcp_pgsql.so\(dq
    }, ... ], ... }
.EE
.UNINDENT
.UNINDENT
.SS تنظیم مهلت‌های زمانی پایگاه داده برای ذخیره‌سازی میزبان‌ها
.sp
بخش Tuning Database Timeouts را ببینید\&.
.SS پیکربندی رابط‌های شبکه (Interface Configuration)
.sp
سرور DHCPv4 باید طوری پیکربندی شود که روی رابط‌های شبکه خاصی شنود کند. ساده‌ترین پیکربندی رابط شبکه به سرور می‌گوید روی تمام رابط‌های در دسترس گوش فرا دهد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqinterfaces\-config\(dq: {
        \(dqinterfaces\(dq: [ \(dq*\(dq ]
    },
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
علامت ستاره نقش یک کاراکتر عام (wildcard) را ایفا می‌کند و به معنای \(dqگوش دادن روی همه رابط‌ها\(dq است. با این حال، معمولاً بهتر است نام رابط‌ها را به‌طور صریح مشخص کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqinterfaces\-config\(dq: {
        \(dqinterfaces\(dq: [ \(dqeth1\(dq, \(dqeth3\(dq ]
    },
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
امکان استفاده از کاراکتر عام رابط (*) هم‌زمان با نام‌های صریح رابط‌ها وجود دارد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqinterfaces\-config\(dq: {
        \(dqinterfaces\(dq: [ \(dqeth1\(dq, \(dqeth3\(dq, \(dq*\(dq ]
    },
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
این قالب تنها زمانی باید استفاده شود که بخواهید موقتاً فهرستی از نام‌های رابط را نادیده گرفته و روی تمام رابط‌ها گوش دهید.
.sp
برخی از استقرارهای سرورهای DHCP نیازمند آن هستند که سرورها روی رابط‌هایی با چندین نشانی IPv4 پیکربندی‌شده گوش دهند. در این وضعیت‌ها، نشانی مورد نظر را می‌توان با پیوست کردن یک نشانی IPv4 به نام رابط به روش زیر انتخاب کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqinterfaces\-config\(dq: {
        \(dqinterfaces\(dq: [ \(dqeth1/10.0.0.1\(dq, \(dqeth3/192.0.2.3\(dq ]
    },
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر نیاز باشد سرور روی چندین نشانی IPv4 اختصاص‌یافته به یک رابط مشترک گوش دهد، می‌توان مانند مثال زیر چندین نشانی را برای یک رابط تعیین کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqinterfaces\-config\(dq: {
        \(dqinterfaces\(dq: [ \(dqeth1/10.0.0.1\(dq, \(dqeth1/10.0.0.2\(dq ]
    },
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
روش دیگر این است که اگر سرور باید روی تمام نشانی‌های یک رابط خاص گوش دهد، نام رابط بدون هیچ نشانی مشخص شود.
.sp
سرور Kea از پاسخ‌دهی به کلاینت‌های مستقیماً متصل که نشانی پیکربندی‌شده‌ای ندارند پشتیبانی می‌کند. این کار مستلزم آن است که سرور نشانی سخت‌افزاری مقصد را در لایه پیوند داده (data\-link layer) بسته ارسالی به کلاینت تزریق کند. سرور DHCPv4 برای دستیابی به این هدف از سوکت‌های خام (raw sockets) استفاده کرده و کل پشته IP/UDP را برای بسته‌های خروجی ایجاد می‌کند. با این حال، نکته منفی استفاده از سوکت خام این است که بسته‌های ورودی و خروجی فایروال‌ها (مانند iptables) را دور می‌زنند.
.sp
مدیریت ترافیک روی چندین نشانی IPv4 اختصاص‌یافته به یک رابط مشترک می‌تواند یک چالش باشد، چرا که سوکت‌های خام به خود رابط متصل (bind) می‌شوند. هنگامی که سرور DHCP پیکربندی می‌شود تا از سوکت خام روی یک رابط برای دریافت ترافیک DHCP استفاده کند، باید روش‌های پیشرفته فیلتر کردن بسته (مانند BPF) به کار گرفته شوند تا ترافیک تک‌پخشی (unicast) روی نشانی‌های مد نظر اختصاص‌یافته به رابط دریافت شود. اینکه کلاینت‌ها از سوکت خام یا سوکت UDP استفاده کنند، به این بستگی دارد که مستقیماً متصل شده‌اند (سوکت خام) یا بازپخش‌شده (relayed) هستند (سوکت خام یا سوکت UDP).
.sp
بنابراین، در استقرارهایی که نیازی نیست سرور کلاینت‌های مستقیماً متصل را پیکربندی کند و تنها بسته‌های تک‌پخشی (unicast) را از عامل‌های بازپخش (relay agents) دریافت می‌کند، سرور Kea باید طوری پیکربندی شود که به جای سوکت‌های خام از سوکت‌های UDP استفاده کند. پیکربندی زیر نشان می‌دهد که این کار چگونه انجام‌پذیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqinterfaces\-config\(dq: {
        \(dqinterfaces\(dq: [ \(dqeth1\(dq, \(dqeth3\(dq ],
        \(dqdhcp\-socket\-type\(dq: \(dqudp\(dq
    },
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
پارامتر \fBdhcp\-socket\-type\fP مشخص می‌کند که سوکت‌های IP/UDP روی تمام رابط‌هایی که سرور روی آن‌ها گوش می‌دهد (یعنی در این مثال \(dqeth1\(dq و \(dqeth3\(dq) باز خواهند شد. اگر \fBdhcp\-socket\-type\fP روی \fBraw\fP تنظیم شود، سرور را پیکربندی می‌کند تا در عوض از سوکت‌های خام استفاده کند. اگر مقدار \fBdhcp\-socket\-type\fP مشخص نشود، مقدار پیش‌فرض \fBraw\fP به کار می‌رود.
.sp
استفاده از سوکت‌های UDP به‌طور خودکار دریافت بسته‌های همگانی (broadcast) از کلاینت‌های متصل مستقیم را غیرفعال می‌کند. این عملاً بدین معناست که سوکت‌های UDP تنها برای ترافیک بازپخش‌شده (relayed) قابل استفاده هستند. هنگام استفاده از سوکت‌های خام، هم ترافیک کلاینت‌های متصل مستقیم و هم ترافیک بازپخش‌شده مدیریت می‌شوند.
.sp
هنگام پیکربندی سرور برای باز کردن چندین سوکت خام روی رابطی با چند نشانی IPv4 اختصاص‌یافته، باید احتیاط کرد. اگر کلاینت مستقیماً متصل پیامی را به نشانی همگانی (broadcast) ارسال کند، تمام سوکت‌های روی این پیوند این پیام را دریافت کرده و چندین پاسخ به کلاینت فرستاده خواهد شد. بنابراین، در صورتی که کلاینت‌های مستقیماً متصل روی آن پیوند فعالیت می‌کنند، نباید از پیکربندی با چندین نشانی IPv4 اختصاص‌یافته به رابط استفاده شود. برای استفاده از یک نشانی واحد در چنین رابطی، باید از ساختار \(dqinterface\-name/address\(dq استفاده شود.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
مشخص کردن مقدار \fBraw\fP به عنوان نوع سوکت تضمین نمی‌کند که حتماً از سوکت‌های خام استفاده خواهد شد! استفاده از سوکت‌های خام برای مدیریت ترافیک کلاینت‌های متصل مستقیم در حال حاضر تنها روی سیستم‌های Linux و BSD پشتیبانی می‌شود. اگر سوکت‌های خام در سیستم‌عامل مورد استفاده پشتیبانی نشوند، سرور یک هشدار صادر کرده و به استفاده از سوکت‌های IP/UDP بازمی‌گردد.
.UNINDENT
.UNINDENT
.sp
در یک محیط معمولی، انتظار می‌رود سرور DHCP پاسخ را روی همان رابط شبکه‌ای بازگرداند که پرس‌وجو از آن دریافت شده است. این رفتار پیش‌فرض است. با این حال، در برخی استقرارها مطلوب است که بسته‌های خروجی (پاسخ) به عنوان ترافیک عادی ارسال شوند و رابط خروجی توسط جدول‌های مسیریابی تعیین گردد. این نوع ترافیک نامتقارن، غیرمعمول اما معتبر است. سرور Kea از پارامتری به نام \fBoutbound\-interface\fP پشتیبانی می‌کند که این رفتار را کنترل می‌نماید. این پارامتر دو مقدار می‌پذیرد: مقدار نخست، \fBsame\-as\-inbound\fP، به Kea می‌گوید پاسخ را روی همان رابطی بازگرداند که بسته پرس‌وجو دریافت شده بود. این رفتار پیش‌فرض است. پارامتر دوم، \fBuse\-routing\fP، به Kea می‌گوید بسته‌های عادی UDP را ارسال کند و اجازه دهد جدول مسیریابی هسته مناسب‌ترین رابط را تعیین کند. این گزینه تنها زمانی کار می‌کند که \fBdhcp\-socket\-type\fP روی \fBudp\fP تنظیم شده باشد\&. یک نمونه پیکربندی به صورت زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqinterfaces\-config\(dq: {
        \(dqinterfaces\(dq: [ \(dqeth1\(dq, \(dqeth3\(dq ],
        \(dqdhcp\-socket\-type\(dq: \(dqudp\(dq,
        \(dqoutbound\-interface\(dq: \(dquse\-routing\(dq
    },
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
رابط‌ها در هر بازپیکربندی دوباره شناسایی می‌شوند. این رفتار را می‌توان با تنظیم مقدار \fBre\-detect\fP روی \fBfalse\fP غیرفعال کرد، برای نمونه:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqinterfaces\-config\(dq: {
        \(dqinterfaces\(dq: [ \(dqeth1\(dq, \(dqeth3\(dq ],
        \(dqre\-detect\(dq: false
    },
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
سازوکار شناسایی مجدد (re\-detect) معمولاً رابط‌های شناسایی‌شده پیشین را حذف کرده و سپس تمام رابط‌های شناسایی‌شده فعلی را اضافه می‌کند.
توجه داشته باشید که هنگام اجرای دستورات \fBconfig\-test\fP \%<#\:std-isccmd-config-test> یا \fBconfig\-set\fP \%<#\:std-isccmd-config-set> رابط‌ها مجدداً شناسایی نمی‌شوند.
با این حال، رابط‌های جدید شناسایی شده و برای استفاده توسط پیکربندی جدید ارسال‌شده به دستورات \fBconfig\-test\fP \%<#\:std-isccmd-config-test> و \fBconfig\-set\fP \%<#\:std-isccmd-config-set> در دسترس خواهند بود.
.sp
معمولاً رابط‌های بازگشتی (مانند رابط \fBlo\fP یا \fBlo0\fP) پیکربندی نمی‌شوند، اما اگر یک رابط بازگشتی به‌طور صریح پیکربندی شود و سوکت‌های IP/UDP مشخص گردند، رابط بازگشتی پذیرفته می‌شود.
.sp
برای مثال، این ساختار می‌تواند برای اجرای Kea در یک FreeBSD jail که تنها یک رابط بازگشتی دارد، جهت سرویس‌دهی به یک درخواست DHCP بازپخش‌شده (relayed) استفاده شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqinterfaces\-config\(dq: {
        \(dqinterfaces\(dq: [ \(dqlo0\(dq ],
        \(dqdhcp\-socket\-type\(dq: \(dqudp\(dq
    },
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
سرور Kea هنگام راه‌اندازی، سوکت‌های سرویس را به هر رابط متصل می‌کند (bind). اگر فرایند دیگری در حال استفاده از یک درگاه (port) باشد، Kea پیام مربوطه را ثبت کرده و از اعلام خطا جلوگیری می‌کند. در این حالت سرویس DHCP اجرا می‌شود، اما روی برخی رابط‌ها در دسترس نخواهد بود.
.sp
گزینه \(dqservice\-sockets\-require\-all\(dq باعث می‌شود Kea نیاز داشته باشد که تمام سوکت‌ها با موفقیت متصل شوند. در صورت بروز هرگونه شکست در باز کردن سوکت‌ها، Kea فرایند مقداردهی اولیه را متوقف کرده و با یک وضعیت غیرصفر خارج می‌شود (پیش‌فرض false است).
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqinterfaces\-config\(dq: {
        \(dqinterfaces\(dq: [ \(dqeth1\(dq, \(dqeth3\(dq ],
        \(dqservice\-sockets\-require\-all\(dq: true
    },
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
گاهی اوقات توقف فوری گزینه مناسبی نیست، چرا که درگاه ممکن است تنها به‌صورت موقت در دسترس نباشد. در این حالت، تلاش مجدد برای باز کردن ممکن است مشکل را رفع کند. سرور Kea دو گزینه برای تعیین تلاش مجدد فراهم می‌کند:
\fBservice\-sockets\-max\-retries\fP و \fBservice\-sockets\-retry\-wait\-time\fP\&.
.sp
گزینه اول حداکثر تعداد دفعاتی را تعیین می‌کند که Kea برای باز کردن یک سوکت دوباره تلاش می‌نماید. مقدار صفر (پیش‌فرض) بدین معناست که Kea این فرایند را تکرار نمی‌کند.
.sp
گزینه دوم زمان انتظار (بر حسب میلی‌ثانیه) بین تلاش‌ها را مشخص می‌کند. مقدار پیش‌فرض 5000 (5 ثانیه) است.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqinterfaces\-config\(dq: {
        \(dqinterfaces\(dq: [ \(dqeth1\(dq, \(dqeth3\(dq ],
        \(dqservice\-sockets\-max\-retries\(dq: 5,
        \(dqservice\-sockets\-retry\-wait\-time\(dq: 5000
    },
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر \(dqservice\-sockets\-max\-retries\(dq غیرصفر باشد و \(dqservice\-sockets\-require\-all\(dq روی false تنظیم شده باشد، Kea در صورت نیاز تلاش مجدد را انجام می‌دهد، اما در صورتی که هر سوکت همچنان باز نشود متوقف نخواهد شد..SS مشکلات پاسخ‌های تک‌پخشی (Unicast) به DHCPINFORM
.sp
استفاده از سوکت‌های UDP در استقرارهایی که کارگزار فقط ترافیک رله‌شده را
دریافت می‌کند، مزایای خاصی دارد؛ این مزایا در Interface Configuration
ذکر شده‌اند. از دیدگاه مدیر سیستم، اغلب مطلوب است که دیوار آتش سامانه برای
فیلتر کردن ترافیک ناخواسته پیکربندی شود، و استفاده از سوکت‌های UDP
این کار را تسهیل می‌کند. با این حال، مدیر سیستم باید از پیامدهای مربوط به
فیلتر کردن انواع خاصی از ترافیک نیز آگاه باشد، زیرا ممکن است عملکرد
کارگزار DHCP را مختل کند.
.sp
در این بخش، ما روی حالتی تمرکز می‌کنیم که کارگزار پیام DHCPINFORM را
از طریق یک رله از کلاینت دریافت می‌کند. بر اساس RFC 2131
\%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc2131>، کارگزار
باید پاسخ DHCPACK را به‌صورت unicast به آدرس موجود در فیلد \fBciaddr\fP ارسال
کند. هنگامی که سوکت UDP در حال استفاده است، کارگزار DHCP برای ساخت لایه‌های
پیوند داده (data link)، IP و UDP پیام خروجی، به توابع سطح پایین سیستم‌عامل
متکی است. معمولاً، اگر آدرس کلاینت از یک تراکنش قبلی کلاینت با کارگزار در حافظهٔ
موقت ذخیره نشده باشد، سیستم‌عامل ابتدا از ARP برای به‌دست آوردن آدرس لایهٔ پیوند
کلاینت جهت درج در سرآیند فریم استفاده می‌کند. هنگامی که تبادل ARP موفقیت‌آمیز
باشد، پیام DHCP می‌تواند با استفاده از آدرس به‌دست‌آمده، به‌صورت unicast به
کلاینت ارسال شود.
.sp
برخی از مدیران سیستم پیام‌های ARP را در شبکهٔ خود مسدود می‌کنند، که این امر
در هنگام پاسخ کارگزار به پیام‌های DHCPINFORM مشکلاتی ایجاد می‌کند؛ زیرا اگر
ارتباط ARP قبلی با شکست مواجه شود، کارگزار قادر به ارسال DHCPACK نخواهد بود.
از آنجا که سیستم‌عامل به‌طور کامل مسئول ارتباط ARP و سپس ارسال بستهٔ DHCP بر روی
بستر شبکه است، کارگزار DHCP راهی برای تشخیص شکست در تبادل ARP و دور انداخته
شدن (drop) پیام پاسخ DHCP ندارد. بنابراین، هنگامی که پاسخ DHCP خروجی دور انداخته
می‌شود، کارگزار هیچ پیام خطایی ثبت نمی‌کند. هم‌زمان، تمام قلاب‌های (hooks)
مربوط به عملیات ارسال بسته فراخوانی خواهند شد، حتی اگر پیام هرگز به مقصد خود نرسد.
.sp
توجه داشته باشید که مشکل توصیف‌شده در این بخش هنگام استفاده از سوکت‌های raw
مشاهده نمی‌شود، زیرا در این حالت، کارگزار DHCP تمام لایه‌های پیام خروجی را
خودش می‌سازد و از ARP استفاده نمی‌کند. در عوض، مقدار حمل‌شده در فیلد \fBchaddr\fP
از پیام DHCPINFORM را در لایهٔ پیوند درج می‌کند.
.sp
مدیران کارگزاری که مایل به پشتیبانی از پیام‌های DHCPINFORM از طریق رله‌ها هستند،
نباید ترافیک ARP را در شبکه‌های خود مسدود کنند، یا باید به‌جای سوکت‌های UDP
از سوکت‌های raw استفاده نمایند.
.SS شناسه زیرشبکه IPv4
.sp
شناسهٔ زیرشبکه (subnet ID) یک شمارهٔ یکتا است که با یک زیرشبکهٔ خاص
پیوند دارد. در اصل، برای مرتبط کردن اجاره‌های (leases) کلاینت‌ها با
زیرشبکه‌های مربوطه‌شان استفاده می‌شود. پیکربندی کارگزار باید شامل شناسه‌های
یکتا و پایدار برای تمام زیرشبکه‌ها باشد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
شناسه‌های زیرشبکه (Subnet ID) باید بزرگ‌تر از صفر و کوچک‌تر از 4294967295 باشند.
.UNINDENT
.UNINDENT
.sp
پیکربندی زیر شناسهٔ زیرشبکهٔ مشخص‌شده را به یک زیرشبکهٔ تازه‌پیکربندی‌شده
اختصاص می‌دهد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqsubnet4\(dq: [
        {
            \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
            \(dqid\(dq: 1024,
            ...
        }
    ]
}
.EE
.UNINDENT
.UNINDENT
.SS پیشوند زیرشبکه IPv4
.sp
پیشوند زیرشبکه راه دوم برای شناسایی یک زیرشبکه است. Kea می‌تواند
آدرس‌های زیرشبکهٔ غیرمعیار (non\-canonical) را بپذیرد؛ برای نمونه،
این پیکربندی پذیرفته می‌شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqsubnet4\(dq: [
        {
           \(dqsubnet\(dq: \(dq192.0.2.1/24\(dq,
            ...
        }
    ]
}
.EE
.UNINDENT
.UNINDENT
.sp
این قابلیت حتی در صورتی که زیرشبکهٔ دیگری با پیشوند \(dq192.0.2.0/24\(dq
وجود داشته باشد کار می‌کند؛ جهت جلوگیری از موارد تکراری، تنها شکل متنی
زیرشبکه‌ها با یکدیگر مقایسه می‌شوند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
سوءاستفاده از این ویژگی می‌تواند منجر به انتخاب نادرست زیرشبکه شود
(بخش How the DHCPv4 Server Selects a Subnet for the Client را ببینید).
.UNINDENT
.UNINDENT
.SS پیکربندی استخرهای آدرس IPv4
.sp
نقش اصلی یک کارگزار DHCPv4 تخصیص آدرس است. برای این منظور، کارگزار
باید با حداقل یک زیرشبکه و یک استخر (pool) از آدرس‌های پویا برای
مدیریت پیکربندی شود. برای مثال، فرض کنید کارگزار به یک بخش شبکه متصل است
که از پیشوند 192.0.2.0/24 استفاده می‌کند. مدیر آن شبکه تصمیم می‌گیرد
که آدرس‌های محدودهٔ 192.0.2.10 تا 192.0.2.20 توسط کارگزار DHCPv4 مدیریت
شوند. چنین پیکربندی‌ای می‌تواند به روش زیر انجام شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqsubnet4\(dq: [
        {
            \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
            \(dqpools\(dq: [
                { \(dqpool\(dq: \(dq192.0.2.10 \- 192.0.2.20\(dq }
            ],
            ...
        }
    ]
}
.EE
.UNINDENT
.UNINDENT
.sp
توجه داشته باشید که \fBsubnet\fP به عنوان یک رشتهٔ ساده تعریف شده است،
اما پارامتر \fBpools\fP در واقع فهرستی از استخرها است؛ به همین دلیل،
تعریف استخر درون براکت قرار گرفته است، حتی اگر فقط یک محدوده از آدرس‌ها
مشخص شده باشد.
.sp
هر \fBpool\fP ساختاری است که حاوی پارامترهای توصیف‌کنندهٔ یک استخر منفرد
می‌باشد. در حال حاضر تنها یک پارامتر وجود دارد، \fBpool\fP، که محدودهٔ
آدرس‌های درون استخر را مشخص می‌کند.
.sp
تعریف بیش از یک استخر در یک زیرشبکه امکان‌پذیر است؛ در ادامهٔ مثال قبلی،
فرض کنید 192.0.2.64/26 نیز باید توسط کارگزار مدیریت شود. این مقدار را
می‌توان به صورت 192.0.2.64 تا 192.0.2.127 نوشت، یا ساده‌تر به شکل
192.0.2.64/26 بیان کرد. هر دو قالب توسط \fBDhcp4\fP پشتیبانی می‌شوند
و می‌توان آن‌ها را در فهرست استخر ترکیب کرد. برای نمونه، استخرهای زیر
را می‌توان تعریف کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqsubnet4\(dq: [
        {
            \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
            \(dqpools\(dq: [
                { \(dqpool\(dq: \(dq192.0.2.10\-192.0.2.20\(dq },
                { \(dqpool\(dq: \(dq192.0.2.64/26\(dq }
            ],
            ...
        }
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
فاصله‌های خالی (white space) در تعریف استخرها نادیده گرفته می‌شوند،
بنابراین فاصله‌های قبل و بعد از خط تیره اختیاری هستند. می‌توان از آن‌ها
برای بهبود خوانایی استفاده کرد.
.sp
تعداد استخرها محدودیتی ندارد، اما به دلایل کارایی توصیه می‌شود تا جای
ممکن از تعداد کمتری استفاده شود.
.sp
کارگزار ممکن است برای سرویس‌دهی به بیش از یک زیرشبکه پیکربندی شود.
برای افزودن زیرشبکهٔ دوم، از ساختاری مشابه زیر استفاده کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqsubnet4\(dq: [
        {
            \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
            \(dqpools\(dq: [ { \(dqpool\(dq: \(dq192.0.2.1 \- 192.0.2.200\(dq } ],
            ...
        },
        {
            \(dqsubnet\(dq: \(dq192.0.3.0/24\(dq,
            \(dqpools\(dq: [ { \(dqpool\(dq: \(dq192.0.3.100 \- 192.0.3.200\(dq } ],
            ...
        },
        {
            \(dqsubnet\(dq: \(dq192.0.4.0/24\(dq,
            \(dqpools\(dq: [ { \(dqpool\(dq: \(dq192.0.4.1 \- 192.0.4.254\(dq } ],
            ...
        }
    ]
}
.EE
.UNINDENT
.UNINDENT
.sp
هنگام پیکربندی یک کارگزار DHCPv4 با استفاده از نمادگذاری پیشوند/طول
(prefix/length)، لطفاً به مقادیر مرزی توجه کنید. وقتی مشخص می‌کنید که
کارگزار می‌تواند از یک استخر مشخص استفاده کند، این کارگزار همچنین قادر است
اولین آدرس (معمولاً آدرس شبکه) و آخرین آدرس (معمولاً آدرس پخش همگانی یا
broadcast) آن استخر را نیز تخصیص دهد. در مثال پیشین استخر 192.0.3.0/24،
هر دو آدرس 192.0.3.0 و 192.0.3.255 نیز ممکن است تخصیص یابند. این امر در
برخی از پیکربندی‌های شبکه ممکن است نامعتبر باشد. برای جلوگیری از این موضوع،
از نمادگذاری \fBmin\-max\fP استفاده کنید.
.sp
در زیرشبکه‌ای که طول پیشوند آن کمتر از 24 است، ممکن است کاربران تمایل داشته باشند
همهٔ آدرس‌هایی را که به .0 و .255 ختم می‌شوند از تخصیص پویا مستثنی کنند.
به عنوان مثال، در زیرشبکهٔ 10.0.0.0/8، یک مدیر سیستم ممکن است بخواهد 10.x.y.0
و 10.x.y.255 را برای تمام مقادیر x و y مستثنی کند، با اینکه بر اساس
استانداردهای RFC تنها 10.0.0.0 و 10.255.255.255 باید مستثنی شوند.
پرچم سازگاری پیکربندی \fBexclude\-first\-last\-24\fP (بخش Kea DHCPv4 Compatibility Configuration Parameters)
این کار را به‌طور خودکار انجام می‌دهد، به‌جای اینکه نیاز به پیکربندی صریح
استخرهای متعدد یا رزرو برای میزبان‌های ساختگی باشد. هنگامی که مقدار آن
\fBtrue\fP باشد، تنها برای زیرشبکه‌هایی با طول پیشوند 24 یا کوچک‌تر (یعنی
فضای آدرس بزرگ‌تر) اعمال می‌شود؛ مقدار پیش‌فرض \fBfalse\fP است\&.
.sp
در این حالت، \(dqexclude\(dq (مستثنی کردن) به معنای نادیده گرفتن این آدرس‌ها
در روال انتخاب آدرس آزاد موتور تخصیص است؛ اگر یک کلاینت صریحاً آدرسی منتهی
به .0 یا .255 را درخواست کند یا رزرو میزبانی برای آن داشته باشد، آن را دریافت
خواهد کرد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
در ادامه برخی از اختیارات و محدودیت‌های مقادیری که زیرشبکه‌ها و استخرها
می‌توانند در پیکربندی‌های غیرمعمول Kea داشته باشند، آورده شده است:
.TS
box center;
l|l|l.
T{
حالت پیکربندی Kea
T}	T{
مجاز
T}	T{
توضیح
T}
_
T{
هم‌پوشانی زیرشبکه‌ها
T}	T{
بله
T}	T{
مدیر سیستم باید نحوهٔ تطبیق کلاینت‌ها با این زیرشبکه‌ها را در نظر بگیرد.
T}
_
T{
هم‌پوشانی استخرها در یک زیرشبکه
T}	T{
خیر
T}	T{
خطای راه‌اندازی: DHCP4_PARSER_FAIL
T}
_
T{
هم‌پوشانی استخرهای آدرس در زیرشبکه‌های متفاوت
T}	T{
بله
T}	T{
مشخص کردن یک استخر آدرس یکسان در زیرشبکه‌های مختلف می‌تواند به عنوان معادل یک استخر آدرس سراسری (global) استفاده شود. در این حالت، کارگزار می‌تواند صرف‌نظر از زیرشبکهٔ کلاینت، آدرس‌هایی را از همان محدوده تخصیص دهد. اگر آدرسی از چنین استخری به کلاینتی در یک زیرشبکه تخصیص یابد، در صورت جابه‌جایی کلاینت به زیرشبکه‌ای دیگر، همان آدرس برای این کلاینت تمدید خواهد شد. به کلاینت دیگری در یک زیرشبکهٔ متفاوت، آدرسی که قبلاً به این کلاینت در هر یک از زیرشبکه‌ها تخصیص داده شده است، تخصیص داده نخواهد شد.
T}
_
T{
استخرهایی که با پیشوند زیرشبکه مطابقت ندارند
T}	T{
خیر
T}	T{
خطای راه‌اندازی: DHCP4_PARSER_FAIL
T}
.TE
.UNINDENT
.UNINDENT.SS ارسال T1 (گزینه ۵۸) و T2 (گزینه ۵۹)
.sp
مطابق با RFC 2131 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc2131>،
کارگزارها باید برای T1 و T2 به ترتیب مقادیری معادل ۵۰٪ و ۸۷.۵٪ از طول‌عمر
اجاره را ارسال کنند. به‌طور پیش‌فرض، \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> هیچ‌یک
از این مقادیر را ارسال نمی‌کند؛ می‌توان آن را طوری پیکربندی کرد که مقادیر مشخص‌شده
به‌صورت صریح یا مقادیر محاسبه‌شده بر اساس درصدی از زمان اجاره را ارسال کند. رفتار
کارگزار توسط ترکیبی از پارامترهای پیکربندی کنترل می‌شود که دو مورد از آن‌ها پیش‌تر
ذکر شده است.
برای ارسال مقادیر مشخص و ثابت از دو پارامتر زیر استفاده کنید:
.INDENT 0.0
.IP \(bu 2
\fBrenew\-timer\fP \- مقدار T1 را بر حسب ثانیه مشخص می‌کند.
.IP \(bu 2
\fBrebind\-timer\fP \- مقدار T2 را بر حسب ثانیه مشخص می‌کند.
.UNINDENT
.sp
کارگزار تنها زمانی T2 را ارسال می‌کند که کمتر از زمان اجاره معتبر باشد. T1
تنها در صورتی ارسال می‌شود که T2 در حال ارسال بوده و T1 کمتر از T2 باشد؛ یا اینکه T2
ارسال نشود و T1 کمتر از زمان اجاره معتبر باشد.
.sp
محاسبه مقادیر توسط سه پارامتر زیر کنترل می‌شود:
.INDENT 0.0
.IP \(bu 2
\fBcalculate\-tee\-times\fP \- زمانی که \fBtrue\fP باشد، T1 و T2 به‌صورت
درصدی از زمان اجاره معتبر محاسبه می‌شوند. مقدار پیش‌فرض آن \fBfalse\fP است.
.IP \(bu 2
\fBt1\-percent\fP \- درصد زمان اجاره معتبر برای استفاده در
T1. این مقدار به‌صورت یک عدد حقیقی بین 0.0 و 1.0 بیان شده و باید
کمتر از \fBt2\-percent\fP باشد. مقدار پیش‌فرض آن طبق RFC 2131 برابر با 0.50 است.
.IP \(bu 2
\fBt2\-percent\fP \- درصد زمان اجاره معتبر برای استفاده در
T2. این مقدار به‌صورت یک عدد حقیقی بین 0.0 و 1.0 بیان شده و باید
بزرگتر از \fBt1\-percent\fP باشد. مقدار پیش‌فرض آن طبق RFC 2131 برابر با .875 است.
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
در صورتی که هم مقادیر صریح مشخص شده باشند و هم
\fBcalculate\-tee\-times\fP روی \fBtrue\fP تنظیم شده باشد، کارگزار از مقادیر صریح استفاده خواهد کرد.
مدیرانی با ساختاری که در آن برخی زیرشبکه‌ها یا shared\-networkها
از مقادیر صریح و برخی از مقادیر محاسبه‌شده استفاده می‌کنند، نباید
مقادیر صریح را در سطحی بالاتر از جایی که استفاده خواهند شد
تعریف کنند. به ارث بردن آن‌ها از یک محدوده بیش از حد بالا، مانند
محدوده سراسری (global)، باعث می‌شود در تمامی سطوح زیرین
(shared\-networks و زیرشبکه‌ها) دارای مقدار صریح شوند که عملاً مقادیر
محاسبه‌شده را غیرفعال می‌کند.
.UNINDENT
.UNINDENT
.SS گزینه‌های استاندارد DHCPv4
.sp
یکی از قابلیت‌های اصلی کارگزار DHCPv4، توانایی ارائه گزینه‌های
پیکربندی به کلاینت‌ها است. بیشتر گزینه‌ها تنها در صورتی توسط
کارگزار ارسال می‌شوند که کلاینت صراحتاً آن‌ها را با استفاده از گزینه
Parameter Request List درخواست کرده باشد. مواردی که نیازی به گنجانده شدن در
گزینه Parameter Request List ندارند گزینه‌های پرکاربرد هستند، مانند \(dqDomain
Server\(dq، و همچنین گزینه‌هایی که نیازمند رفتار خاصی هستند، مانند \(dqClient FQDN\(dq
که در صورت قرار گرفتن در پیام ارسالی کلاینت به کارگزار،
به کلاینت بازگردانده می‌شود.
.sp
«فهرست گزینه‌های استاندارد DHCPv4 قابل پیکربندی توسط مدیر»، دربرگیرنده فهرستی از
گزینه‌های استاندارد DHCPv4 است که مقادیر آن‌ها را می‌توان با استفاده از
ساختارهای پیکربندی شرح داده‌شده در این بخش تنظیم کرد. این جدول گزینه‌هایی
را که نیازمند پردازش خاص بوده و در نتیجه نمی‌توان آن‌ها را با
مقادیر ثابت پیکربندی کرد، مستثنی می‌کند. ستون آخر جدول
مشخص می‌کند کدام گزینه‌ها می‌توانند حتی در صورت عدم درخواست در
گزینه Parameter Request List توسط کارگزار ارسال شوند، و کدام موارد
تنها در صورت درخواست صریح ارسال می‌شوند.
.sp
مثال زیر نحوه پیکربندی نشانی‌های کارگزارهای DNS را نشان می‌دهد،
که یکی از پرکاربردترین گزینه‌ها است. گزینه‌هایی که
به این روش تعیین می‌شوند سراسری تلقی شده و به تمام زیرشبکه‌های
پیکربندی‌شده اعمال می‌شوند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqoption\-data\(dq: [
        {
           \(dqname\(dq: \(dqdomain\-name\-servers\(dq,
           \(dqcode\(dq: 6,
           \(dqspace\(dq: \(dqdhcp4\(dq,
           \(dqcsv\-format\(dq: true,
           \(dqdata\(dq: \(dq192.0.2.1, 192.0.2.2\(dq
        },
        ...
    ]
}
.EE
.UNINDENT
.UNINDENT
.sp
توجه داشته باشید که تعیین یکی از دو مورد \fBname\fP یا \fBcode\fP الزامی است؛ نیازی به
مشخص کردن هر دوی آن‌ها نیست. \fBspace\fP مقدار پیش‌فرض \fBdhcp4\fP دارد، بنابراین در صورت
تعریف یک گزینه معمولی (غیر کپسوله‌شده) DHCPv4 می‌توان از آن نیز صرف‌نظر کرد.
در نهایت، مقدار پیش‌فرض \fBcsv\-format\fP برابر با \fBtrue\fP است، بنابراین می‌توان از آن نیز
صرف‌نظر کرد، مگر اینکه مقدار گزینه به صورت یک رشته هگزادسیمال مشخص شود. بنابراین،
مثال بالا را می‌توان به این صورت ساده کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqoption\-data\(dq: [
        {
           \(dqname\(dq: \(dqdomain\-name\-servers\(dq,
           \(dqdata\(dq: \(dq192.0.2.1, 192.0.2.2\(dq
        },
        ...
    ]
}
.EE
.UNINDENT
.UNINDENT
.sp
گزینه‌های تعریف‌شده هنگام درخواست کلاینت به پاسخ اضافه می‌شوند،
به استثنای چند مورد خاص که همواره افزوده می‌گردند. برای اجبار به افزودن
یک گزینه خاص، پرچم \fBalways\-send\fP را مانند زیر روی \fBtrue\fP تنظیم کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqoption\-data\(dq: [
        {
           \(dqname\(dq: \(dqdomain\-name\-servers\(dq,
           \(dqdata\(dq: \(dq192.0.2.1, 192.0.2.2\(dq,
           \(dqalways\-send\(dq: true
        },
        ...
    ]
}
.EE
.UNINDENT
.UNINDENT
.sp
اثر این کار همانند آن است که کلاینت کد گزینه را در گزینه
Parameter Request List (یا معادل آن برای گزینه‌های سازنده/vendor) قرار داده باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqoption\-data\(dq: [
        {
           \(dqname\(dq: \(dqdomain\-name\-servers\(dq,
           \(dqdata\(dq: \(dq192.0.2.1, 192.0.2.2\(dq,
           \(dqalways\-send\(dq: true
        },
        ...
    ],
    \(dqsubnet4\(dq: [
        {
           \(dqsubnet\(dq: \(dq192.0.3.0/24\(dq,
           \(dqoption\-data\(dq: [
               {
                   \(dqname\(dq: \(dqdomain\-name\-servers\(dq,
                   \(dqdata\(dq: \(dq192.0.3.1, 192.0.3.2\(dq
               },
               ...
           ],
           ...
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
در مثال بالا، گزینه \fBdomain\-name\-servers\fP از پرچم سراسری
\fBalways\-send\fP پیروی کرده و همواره به پاسخ‌ها افزوده می‌شود، اما برای زیرشبکه
\fB192.0.3.0/24\fP، مقدار آن از مشخصات داده‌های گزینه در سطح زیرشبکه
برداشته می‌شود.
.sp
برخلاف \fBalways\-send\fP، اگر پرچم \fBnever\-send\fP برای یک گزینه
خاص روی \fBtrue\fP تنظیم شود، کارگزار آن را به پاسخ اضافه نمی‌کند.
اثر این کار همانند آن است که کلاینت کد گزینه را از گزینه
Parameter Request List (یا معادل آن برای گزینه‌های vendor) حذف کرده باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqoption\-data\(dq: [
        {
           \(dqname\(dq: \(dqdomain\-name\-servers\(dq,
           \(dqdata\(dq: \(dq192.0.2.1, 192.0.2.2\(dq
        },
        ...
    ],
    \(dqsubnet4\(dq: [
        {
           \(dqsubnet\(dq: \(dq192.0.3.0/24\(dq,
           \(dqoption\-data\(dq: [
               {
                   \(dqname\(dq: \(dqdomain\-name\-servers\(dq,
                   \(dqnever\-send\(dq: true
               },
               ...
           ],
           ...
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
در مثال بالا، گزینه \fBdomain\-name\-servers\fP هرگز به پاسخ‌ها
در زیرشبکه \fB192.0.3.0/24\fP افزوده نمی‌شود. \fBnever\-send\fP بر
\fBalways\-send\fP تقدم دارد؛ بنابراین اگر هر دو \fBtrue\fP باشند، گزینه اضافه نمی‌شود.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
پرچم‌های \fBalways\-send\fP و \fBnever\-send\fP چسبنده (sticky) هستند؛ بدین معنا
که از قوانین معمول توارث پیکربندی پیروی نمی‌کنند.
در عوض، اگر در طول زنجیره توارث پیکربندی حداقل یک‌بار فعال شوند، اعمال
می‌گردند \- حتی اگر در بخش‌های دیگری که معمولاً اولویت بالاتری دارند،
غیرفعال شده باشند. برای نمونه، اگر یکی از این پرچم‌ها در محدوده سراسری فعال باشد
اما در سطح زیرشبکه غیرفعال شود، با نادیده گرفتن تنظیمات سطح زیرشبکه،
فعال باقی خواهد ماند.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
پرچم \fBnever\-send\fP نسبت به \fBlibdhcp_flex_option.so\fP \%<#\:std-ischooklib-libdhcp_flex_option\:.so> قدرت کمتری دارد؛
برای نمونه، هیچ اثری بر گزینه‌هایی که توسط خود کارگزار مدیریت می‌شوند ندارد.
هر دو پرچم \fBalways\-send\fP و \fBnever\-send\fP بر گزینه‌هایی که قابل
درخواست نیستند، مانند گزینه‌های یک فضای سفارشی (custom space)، بی‌اثر هستند.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
از نسخه Kea 2.7.4 به بعد، گنجاندن گزینه‌ها را می‌توان از طریق
برچسب‌گذاری کلاس گزینه نیز کنترل کرد؛ به Option Class\-Tagging \%<#\:option-class-tagging>
مراجعه کنید.
.UNINDENT
.UNINDENT
.sp
پارامتر \fBname\fP نام گزینه را مشخص می‌کند. برای مشاهده فهرستی از
نام‌های پشتیبانی‌شده در حال حاضر، بخش «فهرست گزینه‌های استاندارد DHCPv4 قابل پیکربندی توسط مدیر»
در زیر را ببینید. پارامتر \fBcode\fP کد گزینه را مشخص می‌کند که باید با
یکی از مقادیر آن فهرست مطابقت داشته باشد. خط بعدی فضای گزینه (option space)
را مشخص می‌کند که همواره باید روی \fBdhcp4\fP تنظیم شود چرا که این‌ها گزینه‌های استاندارد
DHCPv4 هستند. برای سایر فضاهای گزینه، از جمله فضاهای گزینه سفارشی،
به Nested DHCPv4 Options (Custom Option Spaces) مراجعه کنید. خط بعدی قالبی
را مشخص می‌کند که داده‌ها در آن وارد می‌شوند؛ استفاده از CSV (مقادیر جداشده با کاما)
توصیه می‌شود. خط ششم مقدار واقعی ارسال‌شونده به کلاینت‌ها را
تعیین می‌کند. پارامتر data به صورت متن معمولی مشخص می‌شود و در صورتی که
بیش از یک مقدار مجاز باشد، مقادیر با کاما جدا می‌شوند.
.sp
گزینه‌ها را می‌توان به‌صورت مقادیر هگزادسیمال نیز پیکربندی کرد. اگر \fBcsv\-format\fP
روی \fBfalse\fP تنظیم شود، داده‌های گزینه باید به‌صورت یک رشته هگزادسیمال مشخص شوند.
دستورهای زیر گزینه \fBdomain\-name\-servers\fP را برای تمامی زیرشبکه‌ها
با نشانی‌های روبه‌رو پیکربندی می‌کنند: 192.0.3.1 و 192.0.3.2. توجه داشته باشید که
\fBcsv\-format\fP روی \fBfalse\fP تنظیم شده است.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqoption\-data\(dq: [
        {
            \(dqname\(dq: \(dqdomain\-name\-servers\(dq,
            \(dqcode\(dq: 6,
            \(dqspace\(dq: \(dqdhcp4\(dq,
            \(dqcsv\-format\(dq: false,
            \(dqdata\(dq: \(dqC0 00 03 01 C0 00 03 02\(dq
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
سامانه Kea هنگام تعیین داده‌های هگزادسیمال از قالب‌های زیر پشتیبانی می‌کند:
.INDENT 0.0.IP \(bu 2
\fBDelimited octets\fP \- یک یا چند اوکتت (بایت) که با دو‌نقطه یا فاصله (\(dq:\(dq یا \(dq \(dq) از یکدیگر جدا شده‌اند. گرچه هر اوکتت می‌تواند شامل یک یا دو رقم باشد، اکیداً توصیه می‌کنیم همیشه از دو رقم استفاده کنید. نمونه‌های معتبر شامل \(dqab:cd:ef\(dq و \(dqab cd ef\(dq هستند.
.IP \(bu 2
\fBString of digits\fP \- یک رشته پیوسته از ارقام هگزادسیمال با یا بدون پیشوند \(dq0x\(dq. نمونه‌های معتبر شامل \(dq0xabcdef\(dq و \(dqabcdef\(dq هستند.
.UNINDENT
.sp
هنگام استفاده از قالب هگزادسیمال باید در به‌کارگیری کدگذاری مناسب دقت شود؛ توانایی Kea در اعتبارسنجی صحت داده‌ها در قالب هگزادسیمال محدود است.
.sp
همچنین می‌توان داده‌ها را برای گزینه‌های باینری، مطابق آنچه نشان داده شده است، به صورت یک رشته متنی درون نقل‌قول تکی داخل نقل‌قول دوتایی تعیین کرد (توجه داشته باشید که \fBcsv\-format\fP باید روی \fBfalse\fP تنظیم شود):
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqoption\-data\(dq: [
        {
            \(dqname\(dq: \(dquser\-class\(dq,
            \(dqcode\(dq: 77,
            \(dqspace\(dq: \(dqdhcp4\(dq,
            \(dqcsv\-format\(dq: false,
            \(dqdata\(dq: \(dq\(aqconvert this text to binary\(aq\(dq
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
بیشتر پارامترها در ساختار \fBoption\-data\fP اختیاری هستند و در برخی شرایط می‌توان از آن‌ها صرف‌نظر کرد، همان‌طور که در Unspecified Parameters for DHCPv4 Option Configuration توضیح داده شده است.
.sp
امکان تعیین یا بازنویسی (override) گزینه‌ها بر پایه هر زیرشبکه وجود دارد. اگر انتظار می‌رود کلاینت‌های متصل به بیشتر زیرشبکه‌ها مقادیر یکسانی از یک گزینه خاص را دریافت کنند، مدیران سیستم باید از گزینه‌های سراسری (global) استفاده کنند. از سوی دیگر، اگر مقادیر متفاوتی در هر زیرشبکه استفاده می‌شود، مشخص کردن مقادیر سراسری برای گزینه‌ها منطقی نیست؛ بلکه فقط باید گزینه‌های مختص به هر زیرشبکه تنظیم شوند.
.sp
دستورات زیر گزینه سراسری کارسازهای DNS را برای یک زیرشبکه خاص بازنویسی کرده و یک کارساز DNS منفرد با نشانی 192.0.2.3 تعیین می‌کنند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqsubnet4\(dq: [
        {
            \(dqoption\-data\(dq: [
                {
                    \(dqname\(dq: \(dqdomain\-name\-servers\(dq,
                    \(dqcode\(dq: 6,
                    \(dqspace\(dq: \(dqdhcp4\(dq,
                    \(dqcsv\-format\(dq: true,
                    \(dqdata\(dq: \(dq192.0.2.3\(dq
                },
                ...
            ],
            ...
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
در برخی موارد، مرتبط ساختن برخی گزینه‌ها با یک استخر نشانی (address pool) که به کلاینت از آن اجاره داده می‌شود، مفید است. مقادیر گزینه‌های مختص استخر، مقادیر مختص زیرشبکه و سراسری را بازنویسی می‌کنند؛ اولویت‌بندی انتساب گزینه‌های مختص استخر از طریق ترتیب اعلان استخرها در پیکربندی سرور امکان‌پذیر نیست.
.sp
قطعه‌پیکربندی زیر نحوه تعیین گزینه سرورهای DNS را نشان می‌دهد که فقط در صورتی به کلاینت اختصاص می‌یابد که کلاینت نشانی خود را از استخر داده‌شده دریافت کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqsubnet4\(dq: [
        {
            \(dqpools\(dq: [
                {
                    \(dqpool\(dq: \(dq192.0.2.1 \- 192.0.2.200\(dq,
                    \(dqoption\-data\(dq: [
                        {
                            \(dqname\(dq: \(dqdomain\-name\-servers\(dq,
                            \(dqdata\(dq: \(dq192.0.2.3\(dq
                         },
                         ...
                    ],
                    ...
                },
                ...
            ],
            ...
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
گزینه‌ها را همچنین می‌توان در حوزه class یا host\-reservation مشخص کرد. ترتیب اولویت فعلی گزینه‌ها در Kea (از بیشترین به کمترین) عبارت است از: host reservation، سپس pool، سپس subnet، سپس shared network، سپس class و در نهایت global.
.sp
هنگامی که یک فیلد داده یک رشته باشد و آن رشته حاوی نویسه کاما (\fB,\fP؛ U+002C) باشد، کاما باید با دو بک‌اسلش (\fB\e\e,\fP؛ U+005C) گریز داده شود (escape شود). این گریز دوتایی به این دلیل لازم است که هم روال تفکیک داده‌های CSV به فیلدها و هم JSON از نویسه گریز یکسانی استفاده می‌کنند؛ یک گریز تکی (\fB\e,\fP) ساختار JSON را نامعتبر می‌کند. برای نمونه، رشته \(dqfoo,bar\(dq باید به صورت زیر نمایش داده شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqsubnet4\(dq: [
        {
            \(dqpools\(dq: [
                {
                    \(dqoption\-data\(dq: [
                        {
                            \(dqname\(dq: \(dqboot\-file\-name\(dq,
                            \(dqdata\(dq: \(dqfoo\e\e,bar\(dq
                        }
                    ]
                },
                ...
            ],
            ...
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
برخی گزینه‌ها به صورت آرایه تعیین شده‌اند، به این معنی که بیش از یک مقدار برای آن‌ها مجاز است. به عنوان مثال، گزینه \fBtime\-servers\fP امکان تعیین بیش از یک نشانی IPv4 را فراهم می‌آورد و کلاینت‌ها را قادر می‌سازد تا نشانی‌های چندین سرور NTP را به دست آورند.
.sp
بخش Custom DHCPv4 Options نحو پیکربندی را برای ایجاد تعاریف (قالب‌های) سفارشی گزینه شرح می‌دهد. ایجاد تعاریف سفارشی برای گزینه‌های استاندارد عموماً مجاز نیست، حتی اگر تعریف ایجادشده دقیقاً با قالب واقعی گزینه که در RFCها تعریف شده مطابقت داشته باشد. با این حال، یک استثنا برای این قاعده در مورد گزینه‌های استانداردی وجود دارد که Kea در حال حاضر تعریفی برای آن‌ها ارائه نمی‌دهد. برای استفاده از چنین گزینه‌هایی، مدیر سیستم باید تعریفی را همان‌طور که در Custom DHCPv4 Options شرح داده شده، در فضای گزینه \fBdhcp4\fP ایجاد کند. این تعریف باید با قالب گزینه شرح داده شده در RFC مربوطه مطابقت داشته باشد، اما سازوکار پیکربندی هر قالب گزینه‌ای را مجاز می‌داند زیرا در حال حاضر راهی برای اعتبارسنجی آن وجود ندارد.
.sp
گزینه‌های استاندارد DHCPv4 که در حال حاضر پشتیبانی می‌شوند در جدول زیر فهرست شده‌اند. \(dqName\(dq و \(dqCode\(dq مقادیری هستند که باید به عنوان name/code در ساختارهای option\-data استفاده شوند. \(dqType\(dq قالب داده‌ها را مشخص می‌کند؛ معانی انواع مختلف در List of standard DHCP option types ذکر شده است..SS فهرست گزینه‌های استاندارد DHCPv4 قابل پیکربندی توسط مدیر سیستم
.TS
box center;
l|l|l|l|l.
T{
نام
T}	T{
کد
T}	T{
نوع
T}	T{
آرایه؟
T}	T{
بازگردانی در
صورت عدم
درخواست؟
T}
_
T{
time\-offset
T}	T{
2
T}	T{
int32
T}	T{
false
T}	T{
false
T}
_
T{
routers
T}	T{
3
T}	T{
ipv4\-address
T}	T{
true
T}	T{
true
T}
_
T{
time\-servers
T}	T{
4
T}	T{
ipv4\-address
T}	T{
true
T}	T{
false
T}
_
T{
name\-servers
T}	T{
5
T}	T{
ipv4\-address
T}	T{
true
T}	T{
false
T}
_
T{
domain\-name\-servers
T}	T{
6
T}	T{
ipv4\-address
T}	T{
true
T}	T{
true
T}
_
T{
log\-servers
T}	T{
7
T}	T{
ipv4\-address
T}	T{
true
T}	T{
false
T}
_
T{
cookie\-servers
T}	T{
8
T}	T{
ipv4\-address
T}	T{
true
T}	T{
false
T}
_
T{
lpr\-servers
T}	T{
9
T}	T{
ipv4\-address
T}	T{
true
T}	T{
false
T}
_
T{
impress\-servers
T}	T{
10
T}	T{
ipv4\-address
T}	T{
true
T}	T{
false
T}
_
T{
resource\-location\-servers
T}	T{
11
T}	T{
ipv4\-address
T}	T{
true
T}	T{
false
T}
_
T{
boot\-size
T}	T{
13
T}	T{
uint16
T}	T{
false
T}	T{
false
T}
_
T{
merit\-dump
T}	T{
14
T}	T{
string
T}	T{
false
T}	T{
false
T}
_
T{
domain\-name
T}	T{
15
T}	T{
fqdn
T}	T{
false
T}	T{
true
T}
_
T{
swap\-server
T}	T{
16
T}	T{
ipv4\-address
T}	T{
false
T}	T{
false
T}
_
T{
root\-path
T}	T{
17
T}	T{
string
T}	T{
false
T}	T{
false
T}
_
T{
extensions\-path
T}	T{
18
T}	T{
string
T}	T{
false
T}	T{
false
T}
_
T{
ip\-forwarding
T}	T{
19
T}	T{
boolean
T}	T{
false
T}	T{
false
T}
_
T{
non\-local\-source\-routing
T}	T{
20
T}	T{
boolean
T}	T{
false
T}	T{
false
T}
_
T{
policy\-filter
T}	T{
21
T}	T{
ipv4\-address
T}	T{
true
T}	T{
false
T}
_
T{
max\-dgram\-reassembly
T}	T{
22
T}	T{
uint16
T}	T{
false
T}	T{
false
T}
_
T{
default\-ip\-ttl
T}	T{
23
T}	T{
uint8
T}	T{
false
T}	T{
false
T}
_
T{
path\-mtu\-aging\-timeout
T}	T{
24
T}	T{
uint32
T}	T{
false
T}	T{
false
T}
_
T{
path\-mtu\-plateau\-table
T}	T{
25
T}	T{
uint16
T}	T{
true
T}	T{
false
T}
_
T{
interface\-mtu
T}	T{
26
T}	T{
uint16
T}	T{
false
T}	T{
false
T}
_
T{
all\-subnets\-local
T}	T{
27
T}	T{
boolean
T}	T{
false
T}	T{
false
T}
_
T{
broadcast\-address
T}	T{
28
T}	T{
ipv4\-address
T}	T{
false
T}	T{
false
T}
_
T{
perform\-mask\-discovery
T}	T{
29
T}	T{
boolean
T}	T{
false
T}	T{
false
T}
_
T{
mask\-supplier
T}	T{
30
T}	T{
boolean
T}	T{
false
T}	T{
false
T}
_
T{
router\-discovery
T}	T{
31
T}	T{
boolean
T}	T{
false
T}	T{
false
T}
_
T{
router\-solicitation\-address
T}	T{
32
T}	T{
ipv4\-address
T}	T{
false
T}	T{
false
T}
_
T{
static\-routes
T}	T{
33
T}	T{
ipv4\-address
T}	T{
true
T}	T{
false
T}
_
T{
trailer\-encapsulation
T}	T{
34
T}	T{
boolean
T}	T{
false
T}	T{
false
T}
_
T{
arp\-cache\-timeout
T}	T{
35
T}	T{
uint32
T}	T{
false
T}	T{
false
T}
_
T{
ieee802\-3\-encapsulation
T}	T{
36
T}	T{
boolean
T}	T{
false
T}	T{
false
T}
_
T{
default\-tcp\-ttl
T}	T{
37
T}	T{
uint8
T}	T{
false
T}	T{
false
T}
_
T{
tcp\-keepalive\-interval
T}	T{
38
T}	T{
uint32
T}	T{
false
T}	T{
false
T}
_
T{
tcp\-keepalive\-garbage
T}	T{
39
T}	T{
boolean
T}	T{
false
T}	T{
false
T}
_
T{
nis\-domain
T}	T{
40
T}	T{
string
T}	T{
false
T}	T{
false
T}
_
T{
nis\-servers
T}	T{
41
T}	T{
ipv4\-address
T}	T{
true
T}	T{
false
T}
_
T{
ntp\-servers
T}	T{
42
T}	T{
ipv4\-address
T}	T{
true
T}	T{
false
T}
_
T{
vendor\-encapsulated\-options
T}	T{
43
T}	T{
empty
T}	T{
false
T}	T{
false
T}
_
T{
netbios\-name\-servers
T}	T{
44
T}	T{
ipv4\-address
T}	T{
true
T}	T{
false
T}
_
T{
netbios\-dd\-server
T}	T{
45
T}	T{
ipv4\-address
T}	T{
true
T}	T{
false
T}
_
T{
netbios\-node\-type
T}	T{
46
T}	T{
uint8
T}	T{
false
T}	T{
false
T}
_
T{
netbios\-scope
T}	T{
47
T}	T{
string
T}	T{
false
T}	T{
false
T}
_
T{
font\-servers
T}	T{
48
T}	T{
ipv4\-address
T}	T{
true
T}	T{
false
T}
_
T{
x\-display\-manager
T}	T{
49
T}	T{
ipv4\-address
T}	T{
true
T}	T{
false
T}
_
T{
dhcp\-option\-overload
T}	T{
52
T}	T{
uint8
T}	T{
false
T}	T{
false
T}
_
T{
dhcp\-server\-identifier
T}	T{
54
T}	T{
ipv4\-address
T}	T{
false
T}	T{
true
T}
_
T{
dhcp\-message
T}	T{
56
T}	T{
string
T}	T{
false
T}	T{
false
T}
_
T{
dhcp\-max\-message\-size
T}	T{
57
T}	T{
uint16
T}	T{
false
T}	T{
false
T}
_
T{
vendor\-class\-identifier
T}	T{
60
T}	T{
string
T}	T{
false
T}	T{
false
T}
_
T{
nwip\-domain\-name
T}	T{
62
T}	T{
string
T}	T{
false
T}	T{
false
T}
_
T{
nwip\-suboptions
T}	T{
63
T}	T{
binary
T}	T{
false
T}	T{
false
T}
_
T{
nisplus\-domain\-name
T}	T{
64
T}	T{
string
T}	T{
false
T}	T{
false
T}
_
T{
nisplus\-servers
T}	T{
65
T}	T{
ipv4\-address
T}	T{
true
T}	T{
false
T}
_
T{
tftp\-server\-name
T}	T{
66
T}	T{
string
T}	T{
false
T}	T{
false
T}
_
T{
boot\-file\-name
T}	T{
67
T}	T{
string
T}	T{
false
T}	T{
false
T}
_
T{
mobile\-ip\-home\-agent
T}	T{
68
T}	T{
ipv4\-address
T}	T{
true
T}	T{
false
T}
_
T{
smtp\-server
T}	T{
69
T}	T{
ipv4\-address
T}	T{
true
T}	T{
false
T}
_
T{
pop\-server
T}	T{
70
T}	T{
ipv4\-address
T}	T{
true
T}	T{
false
T}
_
T{
nntp\-server
T}	T{
71
T}	T{
ipv4\-address
T}	T{
true
T}	T{
false
T}
_
T{
www\-server
T}	T{
72
T}	T{
ipv4\-address
T}	T{
true
T}	T{
false
T}
_
T{
finger\-server
T}	T{
73
T}	T{
ipv4\-address
T}	T{
true
T}	T{
false
T}
_
T{
irc\-server
T}	T{
74
T}	T{
ipv4\-address
T}	T{
true
T}	T{
false
T}
_
T{
streettalk\-server
T}	T{
75
T}	T{
ipv4\-address
T}	T{
true
T}	T{
false
T}
_
T{
streettalk\-directory\-assistance\-server
T}	T{
76
T}	T{
ipv4\-address
T}	T{
true
T}	T{
false
T}
_
T{
user\-class
T}	T{
77
T}	T{
binary
T}	T{
false
T}	T{
false
T}
_
T{
slp\-directory\-agent
T}	T{
78
T}	T{
record (boolean,
ipv4\-address)
T}	T{
true
T}	T{
false
T}
_
T{
slp\-service\-scope
T}	T{
79
T}	T{
record (boolean, string)
T}	T{
false
T}	T{
false
T}
_
T{
nds\-servers
T}	T{
85
T}	T{
ipv4\-address
T}	T{
true
T}	T{
false
T}
_
T{
nds\-tree\-name
T}	T{
86
T}	T{
string
T}	T{
false
T}	T{
false
T}
_
T{
nds\-context
T}	T{
87
T}	T{
string
T}	T{
false
T}	T{
false
T}
_
T{
bcms\-controller\-names
T}	T{
88
T}	T{
fqdn
T}	T{
true
T}	T{
false
T}
_
T{
bcms\-controller\-address
T}	T{
89
T}	T{
ipv4\-address
T}	T{
true
T}	T{
false
T}
_
T{
client\-system
T}	T{
93
T}	T{
uint16
T}	T{
true
T}	T{
false
T}
_
T{
client\-ndi
T}	T{
94
T}	T{
record (uint8, uint8,
uint8)
T}	T{
false
T}	T{
false
T}
_
T{
uuid\-guid
T}	T{
97
T}	T{
record (uint8, binary)
T}	T{
false
T}	T{
false
T}
_
T{
uap\-servers
T}	T{
98
T}	T{
string
T}	T{
false
T}	T{
false
T}
_
T{
geoconf\-civic
T}	T{
99
T}	T{
binary
T}	T{
false
T}	T{
false
T}
_
T{
pcode
T}	T{
100
T}	T{
string
T}	T{
false
T}	T{
false
T}
_
T{
tcode
T}	T{
101
T}	T{
string
T}	T{
false
T}	T{
false
T}
_
T{
v6\-only\-preferred
T}	T{
108
T}	T{
uint32
T}	T{
false
T}	T{
false
T}
_
T{
netinfo\-server\-address
T}	T{
112
T}	T{
ipv4\-address
T}	T{
true
T}	T{
false
T}
_
T{
netinfo\-server\-tag
T}	T{
113
T}	T{
string
T}	T{
false
T}	T{
false
T}
_
T{
v4\-captive\-portal
T}	T{
114
T}	T{
string
T}	T{
false
T}	T{
false
T}
_
T{
auto\-config
T}	T{
116
T}	T{
uint8
T}	T{
false
T}	T{
false
T}
_
T{
name\-service\-search
T}	T{
117
T}	T{
uint16
T}	T{
true
T}	T{
false
T}
_
T{
domain\-search
T}	T{
119
T}	T{
fqdn
T}	T{
true
T}	T{
false
T}
_
T{
classless\-static\-route
T}	T{
121
T}	T{
internal
T}	T{
false
T}	T{
false
T}
_
T{
cablelabs\-client\-conf
T}	T{
122
T}	T{
empty
T}	T{
false
T}	T{
false
T}
_
T{
vivco\-suboptions
T}	T{
124
T}	T{
record (uint32, binary)
T}	T{
false
T}	T{
false
T}
_
T{
vivso\-suboptions
T}	T{
125
T}	T{
uint32
T}	T{
false
T}	T{
false
T}
_
T{
pana\-agent
T}	T{
136
T}	T{
ipv4\-address
T}	T{
true
T}	T{
false
T}
_
T{
v4\-lost
T}	T{
137
T}	T{
fqdn
T}	T{
false
T}	T{
false
T}
_
T{
capwap\-ac\-v4
T}	T{
138
T}	T{
ipv4\-address
T}	T{
true
T}	T{
false
T}
_
T{
sip\-ua\-cs\-domains
T}	T{
141
T}	T{
fqdn
T}	T{
true
T}	T{
false
T}
_
T{
v4\-sztp\-redirect
T}	T{
143
T}	T{
tuple
T}	T{
true
T}	T{
false
T}
_
T{
rdnss\-selection
T}	T{
146
T}	T{
record (uint8,
ipv4\-address,
ipv4\-address, fqdn)
T}	T{
true
T}	T{
false
T}
_
T{
v4\-portparams
T}	T{
159
T}	T{
record (uint8, psid)
T}	T{
false
T}	T{
false
T}
_
T{
v4\-dnr
T}	T{
162
T}	T{
record (uint16, uint16,
uint8, fqdn, binary)
T}	T{
false
T}	T{
false
T}
_
T{
option\-6rd
T}	T{
212
T}	T{
record (uint8, uint8,
ipv6\-address,
ipv4\-address)
T}	T{
true
T}	T{
false
T}
_
T{
v4\-access\-domain
T}	T{
213
T}	T{
fqdn
T}	T{
false
T}	T{
false
T}
.TE
.sp
می‌توانید نمونه‌ای از نحوه پیکربندی این گزینه‌ها را در kea4/all\-options.json \%<#\:config-example-kea4-all-options-json>\& مشاهده کنید.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
گزینه \fBdefault\-url\fP در Kea 2.1.2 با \fBv4\-captive\-portal\fP جایگزین شد، همان‌طور که در RFC 8910 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc8910>\& معرفی شده است. گزینه جدید دقیقاً همان ساختار گزینه پیشین را دارد. برداشت عمومی بر این است که \fBdefault\-url\fP به‌ندرت استفاده می‌شد. کاربرانی که در حال مهاجرت هستند باید \fBdefault\-url\fP را در پیکربندی‌های خود با \fBv4\-captive\-portal\fP جایگزین کنند.
.UNINDENT
.UNINDENT
.sp
Kea همچنین از گزینه‌های دیگری به‌جز موارد ذکرشده در بالا پشتیبانی می‌کند؛ گزینه‌های زیر توسط خود موتور Kea بازگردانده می‌شوند و به‌طور کلی نباید به‌صورت دستی پیکربندی شوند..SS فهرست گزینه‌های استاندارد DHCPv4 که به‌طور مستقل توسط Kea مدیریت می‌شوند و مستقیماً توسط مدیر سیستم قابل پیکربندی نیستند
.TS
box center;
l|l|l|l.
T{
نام
T}	T{
کد
T}	T{
نوع
T}	T{
توضیحات
T}
_
T{
subnet\-mask
T}	T{
1
T}	T{
ipv4\-address
T}	T{
به‌طور خودکار، بر اساس تعریف زیرشبکه محاسبه می‌شود.
T}
_
T{
host\-name
T}	T{
12
T}	T{
string
T}	T{
توسط کلاینت ارسال می‌شود، معمولاً توسط پیکربندی DNS تعیین می‌گردد.
T}
_
T{
dhcp\-requested\-address
T}	T{
50
T}	T{
ipv4\-address
T}	T{
ممکن است توسط کلاینت ارسال شود و سرور نباید آن را تنظیم کند.
T}
_
T{
dhcp\-lease\-time
T}	T{
51
T}	T{
uint32
T}	T{
به‌طور خودکار بر اساس پارامتر \fBvalid\-lifetime\fP تنظیم می‌شود.
T}
_
T{
dhcp\-message\-type
T}	T{
53
T}	T{
string
T}	T{
توسط کلاینت‌ها و سرورها ارسال می‌شود. بسته به شرایط توسط موتور Kea
تنظیم شده و هرگز نباید به‌طور صریح پیکربندی شود.
T}
_
T{
dhcp\-parameter\-request\-list
T}	T{
55
T}	T{
uint8 array
T}	T{
توسط کلاینت‌ها ارسال می‌شود و هرگز نباید توسط سرور ارسال گردد.
T}
_
T{
dhcp\-renewal\-time
T}	T{
58
T}	T{
uint32
T}	T{
توسط پارامتر \fBrenew\-timer\fP تعیین می‌شود.
T}
_
T{
dhcp\-rebinding\-time
T}	T{
59
T}	T{
uint32
T}	T{
توسط پارامتر \fBrebind\-timer\fP تعیین می‌شود.
T}
_
T{
dhcp\-client\-identifier
T}	T{
61
T}	T{
binary
T}	T{
توسط کلاینت ارسال می‌شود، با مقداری که کلاینت ارسال کرده بازتاب داده می‌شود.
T}
_
T{
fqdn
T}	T{
81
T}	T{
record (uint8, uint8, uint8, fqdn)
T}	T{
بخشی از پیکربندی DDNS و D2.
T}
_
T{
dhcp\-agent\-options
T}	T{
82
T}	T{
empty
T}	T{
توسط کارگزار رله (relay agent) ارسال می‌شود. این یک گزینهٔ دربرگیرندهٔ خالی است؛
به جزئیات گزینهٔ RAI در ادامهٔ این بخش مراجعه کنید.
T}
_
T{
authenticate
T}	T{
90
T}	T{
binary
T}	T{
توسط کلاینت ارسال می‌شود، Kea هنوز آن را اعتبارسنجی نمی‌کند.
T}
_
T{
client\-last\-transaction\-time
T}	T{
91
T}	T{
uint32
T}	T{
توسط کلاینت ارسال می‌شود، سرور آن را تنظیم نمی‌کند.
T}
_
T{
associated\-ip
T}	T{
92
T}	T{
ipv4\-address array
T}	T{
توسط کلاینت ارسال می‌شود، سرور با فهرستی از نشانی‌ها پاسخ می‌دهد.
T}
_
T{
subnet\-selection
T}	T{
118
T}	T{
ipv4\-address
T}	T{
اگر در پیام‌های کلاینت وجود داشته باشد، در فرآیند انتخاب زیرشبکه
استفاده خواهد شد.
T}
_
T{
status\-code
T}	T{
151
T}	T{
record (uint8, string)
T}	T{
توسط سرور در پاسخ‌های bulk leasequery تنظیم می‌شود.
T}
_
T{
base\-time
T}	T{
152
T}	T{
uint32
T}	T{
توسط سرور در پاسخ‌های bulk leasequery تنظیم می‌شود.
T}
_
T{
start\-time\-of\-state
T}	T{
153
T}	T{
uint32
T}	T{
توسط سرور در پاسخ‌های bulk leasequery تنظیم می‌شود.
T}
_
T{
query\-start\-time
T}	T{
154
T}	T{
uint32
T}	T{
توسط درخواست‌کننده در طول bulk leasequery تنظیم می‌شود.
T}
_
T{
query\-end\-time
T}	T{
155
T}	T{
uint32
T}	T{
توسط درخواست‌کننده در طول bulk leasequery تنظیم می‌شود.
T}
_
T{
dhcp\-state
T}	T{
156
T}	T{
uint8
T}	T{
توسط سرور در پاسخ‌های bulk leasequery تنظیم می‌شود.
T}
_
T{
data\-source
T}	T{
157
T}	T{
uint8
T}	T{
توسط سرور در پاسخ‌های bulk leasequery تنظیم می‌شود.
T}
.TE
.sp
جدول زیر تمام انواع گزینه‌های استفاده‌شده در دو جدول قبلی را همراه با توضیحی دربارهٔ مقادیر قابل‌قبول برای آن‌ها فهرست می‌کند..SS "فهرست انواع استاندارد گزینه‌های DHCP (List of standard DHCP option types)"
.TS
box center;
l|l.
T{
نام
T}	T{
مفهوم
T}
_
T{
binary
T}	T{
یک رشته دلخواه از بایت‌ها که به‌صورت مجموعه‌ای از ارقام هگزادسیمال مشخص می‌شود.
T}
_
T{
boolean
T}	T{
یک مقدار بولی با مقادیر مجاز true یا false.
T}
_
T{
empty
T}	T{
بدون مقدار؛ داده‌ها در زیرگزینه‌ها (sub\-options) حمل می‌شوند.
T}
_
T{
fqdn
T}	T{
نام دامنه کاملاً واجد شرایط (مانند www.example.com).
T}
_
T{
ipv4\-address
T}	T{
آدرس IPv4 در نماد نقطه‌ـ‌ده‌دهی معمول (مانند 192.0.2.1).
T}
_
T{
ipv6\-address
T}	T{
آدرس IPv6 در نماد دونقطه‌ای معمول (مانند 2001:db8::1).
T}
_
T{
ipv6\-prefix
T}	T{
پیشوند IPv6 و طول پیشوند مشخص‌شده با نمادگذاری CIDR، مانند 2001:db8:1::/64. این نوع داده برای نمایش یک فیلد ۸ بیتی حامل طول پیشوند و مقدار پیشوند با طول متغیر استفاده می‌شود.
T}
_
T{
psid
T}	T{
‏PSID و طول PSID که با ممیز از یکدیگر جدا شده‌اند، مثلاً 3/4 مشخص‌کننده PSID=3 و طول PSID برابر با ۴ است. در قالب انتقال روی شبکه (wire format)، با یک فیلد ۸ بیتی حامل طول PSID (در این حالت برابر با ۴) و فیلد ۱۶ بیتی مقدار PSID (در این حالت برابر با \(dq0011000000000000b\(dq در نماد دودویی) نمایش داده می‌شود. مقادیر مجاز برای طول PSID بین ۰ تا ۱۶ است. برای جزئیات مربوط به قالب نمایش PSID در شبکه به RFC 7597 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc7597> مراجعه کنید.
T}
_
T{
record
T}	T{
داده‌های ساختاریافته که می‌توانند از هر نوعی (به‌جز \(dqrecord\(dq و \(dqempty\(dq) تشکیل شوند. نشانگر (flag) آرایه فقط بر روی فیلد آخر اعمال می‌شود.
T}
_
T{
string
T}	T{
هر نوع متن. لطفاً توجه داشته باشید که Kea هنگام باز کردن بسته‌های دریافتی، کاراکترهای نال (null) پایانی را از انتهای گزینه‌های \(dqstring\(dq بدون هشدار حذف می‌کند. این رفتار مطابق با بخش ۲ از RFC 2132 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc2132#\:section-2>\& است.
T}
_
T{
tuple
T}	T{
یک فیلد طول که به‌صورت عدد صحیح بدون علامت ۸ یا ۱۶ بیتی کدگذاری شده و پس از آن رشته‌ای با همین طول می‌آید. معمولاً برای DHCPv4 طول ۸ بیتی و برای DHCPv6 طول ۱۶ بیتی است. با این حال، استثناهایی برای این قاعده وجود دارد؛ برای نمونه در گزینه DHCPv4 SZTP Redirect Option، مقدار bootstrap\-server\-list به‌صورت فهرستی از تاپل‌ها (tuples) کدگذاری می‌شود که در آن URI\-length در هر تاپل یک عدد صحیح بدون علامت ۱۶ بیتی است.
T}
_
T{
uint8
T}	T{
یک عدد صحیح بدون علامت ۸ بیتی با مقادیر مجاز ۰ تا ۲۵۵.
T}
_
T{
uint16
T}	T{
یک عدد صحیح بدون علامت ۱۶ بیتی با مقادیر مجاز ۰ تا ۶۵۵۳۵.
T}
_
T{
uint32
T}	T{
یک عدد صحیح بدون علامت ۳۲ بیتی با مقادیر مجاز ۰ تا ۴۲۹۴۹۶۷۲۹۵.
T}
_
T{
int8
T}	T{
یک عدد صحیح علامت‌دار ۸ بیتی با مقادیر مجاز \-128 تا 127.
T}
_
T{
int16
T}	T{
یک عدد صحیح علامت‌دار ۱۶ بیتی با مقادیر مجاز \-32768 تا 32767.
T}
_
T{
int32
T}	T{
یک عدد صحیح علامت‌دار ۳۲ بیتی با مقادیر مجاز \-2147483648 تا 2147483647.
T}
.TE
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
گزینه \fBclassless\-static\-route\fP دارای نوع داده اختصاصی خود یعنی \(dqinternal\(dq است و رشته‌ای با الگوی زیر را به‌عنوان مقدار می‌پذیرد: subnet1/prefix_len1 \- router1, subnetN/prefix_lenN \- routerN.
.sp
برای مثال: 10.229.0.128/25 \- 10.229.0.1, 10.198.122.47/32 \- 10.198.122.1
.UNINDENT
.UNINDENT
.sp
همچنین Kea از گزینه Relay Agent Information (اطلاعات کارگزار رله یا RAI، تعریف‌شده در RFC 3046 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc3046>) که گاهی اوقات relay option،‏ agent option یا به‌سادگی option 82 نامیده می‌شود، پشتیبانی می‌کند. خود این گزینه تنها یک نگه‌دارنده (container) است و به‌تنهایی هیچ اطلاعاتی را منتقل نمی‌کند. جدول زیر شامل فهرستی از زیرگزینه‌های RAI است که Kea قادر به درک آن‌هاست. گزینه RAI و زیرگزینه‌های آن توسط کارگزار رله درج شده و توسط Kea دریافت می‌شوند؛ نیازی به پیکربندی Kea با این گزینه‌ها وجود ندارد. قابلیت‌های دسته‌بندی و شناسه منعطف (flexible ID) در بخش رزروهای میزبان Kea می‌توانند برای پردازش این گزینه‌ها و سایر گزینه‌هایی که در جدول زیر ذکر نشده‌اند، مورد استفاده قرار گیرند..SS فهرست زیرگزینه‌های RAI قابل درک برای Kea
.TS
box center;
l|l|l.
T{
نام
T}	T{
کد
T}	T{
توضیحات
T}
_
T{
circuit\-id
T}	T{
1
T}	T{
هنگامی استفاده می‌شود که host\-reservation\-identifiers روی \fIcircuit\-id\fP تنظیم شده باشد\&.
T}
_
T{
remote\-id
T}	T{
2
T}	T{
می‌تواند همراه با flex\-id برای شناسایی میزبان‌ها استفاده شود\&.
T}
_
T{
link\-selection
T}	T{
5
T}	T{
در صورت وجود، برای انتخاب زیرشبکه مناسب استفاده می‌شود\&.
T}
_
T{
subscriber\-id
T}	T{
6
T}	T{
می‌تواند همراه با flex\-id برای شناسایی میزبان‌ها استفاده شود\&.
T}
_
T{
server\-id\-override
T}	T{
11
T}	T{
در صورت ارسال توسط رله، Kea آن را به عنوان \fIserver\-id\fP می‌پذیرد\&.
T}
_
T{
relay\-id
T}	T{
12
T}	T{
رله را شناسایی می‌کند
T}
_
T{
relay\-port
T}	T{
19
T}	T{
در صورت ارسال توسط رله، Kea پاسخ‌های خود را به این درگاه ارسال می‌کند\&.
T}
.TE
.sp
تمام زیرگزینه‌های دیگر RAI (از جمله مواردی که در اینجا ذکر نشده‌اند) را می‌توان در دسته‌بندی کلاینت‌ها برای اختصاص بسته‌های ورودی به کلاس‌های خاص، و/یا توسط \fBlibdhcp_flex_id.so\fP \%<#\:std-ischooklib-libdhcp_flex_id\:.so> جهت ایجاد یک شناسه دستگاه یکتا به کار برد. برای اطلاعات بیشتر درباره عبارات مورد استفاده در دسته‌بندی کلاینت و شناسه‌های انعطاف‌پذیر، «دسته‌بندی کلاینت» (Client Classification) \%<#\:classify>\& را ببینید. با استفاده از \fBrelay4[option\-code].hex\fP می‌توان به زیرگزینه‌های RAI ارجاع داد؛ برای نمونه، جهت دسته‌بندی بسته‌ها بر اساس \fBremote\-id\fP (کد زیرگزینه ۲)، از \fBrelay4[2].hex\fP استفاده می‌شود\&. نمونه‌ای از یک کلاس کلاینت که تمام بسته‌های دارای مقدار مشخصی از \fBremote\-id\fP را شامل می‌شود به شکل زیر خواهد بود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqclient\-classes\(dq: [
        {
            \(dqname\(dq: \(dqremote\-id\-1020304\(dq,
            \(dqtest\(dq: \(dqrelay4[2].hex == 0x01020304\(dq,
            ...
        }
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
از کلاس‌ها می‌توان برای تفکیک ترافیک به تعداد نسبتاً اندکی گروه استفاده کرد که سپس برای انتخاب زیرشبکه‌ها، استخرها (pools)، گزینه‌های اضافی و موارد دیگر به کار می‌روند. در صورتی که رفتار اختصاصی به ازای هر میزبان مورد نیاز باشد، استفاده از رزروهای میزبان (host reservations) همراه با شناسه‌های انعطاف‌پذیر اکیداً توصیه می‌شود.
.SS زیرگزینه‌های CableLabs Client Conf
.sp
گزینه پیکربندی کلاینت کیبل‌لبز (\(dqcablelabs\-client\-conf\(dq با کد ۱۲۲) حاوی زیرگزینه‌هایی در فضای \(dqcablelabs\-client\-conf\(dq است که در جدول زیر فهرست شده‌اند.
.SS فهرست زیرگزینه‌های CableLabs Client Conf قابل درک برای Kea
.TS
box center;
l|l|l.
T{
نام
T}	T{
کد
T}	T{
قالب
T}
_
T{
tsp\-primary\-server
T}	T{
1
T}	T{
آدرس IPv4
T}
_
T{
tsp\-secondary\-server
T}	T{
2
T}	T{
آدرس IPv4
T}
_
T{
tsp\-as\-parameters
T}	T{
4
T}	T{
رکوردی متشکل از ۳ مقدار uint32
T}
_
T{
tsp\-ap\-parameters
T}	T{
5
T}	T{
رکوردی متشکل از ۳ مقدار uint32
T}
_
T{
tsp\-realm
T}	T{
6
T}	T{
نام دامنه کاملاً مشخص (FQDN)
T}
_
T{
tsp\-use\-tgt
T}	T{
7
T}	T{
بولی (boolean)
T}
_
T{
tsp\-provisioning\-timer
T}	T{
8
T}	T{
uint8
T}
_
T{
tsp\-sct
T}	T{
9
T}	T{
uint16
T}
_
T{
kdc\-server
T}	T{
10
T}	T{
آرایه‌ای از آدرس‌های IPv4
T}
.TE
.sp
این زیرگزینه‌ها در RFC 3495 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc3495> (شامل اصلاحیه آن که قالب realm را مشخص می‌کند)، RFC 3594 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc3594> و RFC 3634 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc3634>\& تعریف شده‌اند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
زیرگزینه ۳ آدرس کارساز تامین TSP را یا به صورت آدرس IPv4 یا به صورت FQDN حمل می‌کند. این مورد را نمی‌توان در Kea تعریف کرد، بنابراین هیچ زیرگزینه استانداردی برای کد ۳ تعریف نشده است و این انتخاب باقی می‌ماند که محتوای آن به صورت یک مقدار باینری پیکربندی شود، یا اگر فقط به عنوان یک آدرس IPv4 یا FQDN استفاده می‌شود، به صورت رکوردی از یک \fBuint8\fP (تنظیم‌شده روی 0) و \fBipv4\-address\fP، یا رکوردی از یک \fBuint8\fP (تنظیم‌شده روی 1) و یک \fBfqdn\fP تعریف شود تا امکان استفاده از داده‌های با قالب CSV فراهم گردد.
.UNINDENT
.UNINDENT.SS گزینه‌های سفارشی DHCPv4 (Custom DHCPv4 Options)
.sp
Kea از گزینه‌های سفارشی (غیر استاندارد) DHCPv4 پشتیبانی می‌کند. فرض کنید می‌خواهیم
یک گزینهٔ جدید DHCPv4 به نام \fBfoo\fP تعریف کنیم که دارای کد 222
بوده و حامل یک مقدار عدد صحیح بی‌علامت 32 بیتی منفرد باشد.
چنین گزینه‌ای را می‌توان با قرار دادن ورودی زیر در فایل پیکربندی تعریف کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqoption\-def\(dq: [
        {
            \(dqname\(dq: \(dqfoo\(dq,
            \(dqcode\(dq: 222,
            \(dqtype\(dq: \(dquint32\(dq,
            \(dqarray\(dq: false,
            \(dqrecord\-types\(dq: \(dq\(dq,
            \(dqspace\(dq: \(dqdhcp4\(dq,
            \(dqencapsulate\(dq: \(dq\(dq
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
مقدار \fBfalse\fP برای پارامتر \fBarray\fP مشخص می‌کند که این
گزینه شامل آرایه‌ای از مقادیر \fBuint32\fP نیست، بلکه در عوض یک
مقدار منفرد است. دو پارامتر دیگر خالی گذاشته شده‌اند:
\fBrecord\-types\fP و \fBencapsulate\fP\&. پارامتر اول، در صورتی که گزینه شامل
رکوردی از فیلدهای داده باشد، فهرستی جداشده با کاما از فیلدهای دادهٔ گزینه را
مشخص می‌کند. مقدار \fBrecord\-types\fP در صورتی که \fBtype\fP بر روی
\(dqrecord\(dq تنظیم شده باشد باید غیرخالی باشد؛ در غیر این صورت باید خالی بماند. پارامتر دوم،
نام فضای گزینه‌ای را تعیین می‌کند که توسط این گزینهٔ خاص کپسوله‌سازی می‌شود.
اگر این گزینهٔ خاص هیچ فضای گزینه‌ای را کپسوله‌سازی نمی‌کند، این پارامتر باید خالی
رها شود. توجه داشته باشید که عبارت پیکربندی \fBoption\-def\fP
تنها قالب یک گزینه را تعریف می‌کند و مقدار (یا مقادیر) آن را
تنظیم نمی‌نماید.
.sp
پارامترهای \fBname\fP، \fBcode\fP و \fBtype\fP الزامی هستند؛ سایر پارامترها
اختیاری می‌باشند. مقدار پیش‌فرض پارامتر \fBarray\fP برابر با \fBfalse\fP است\&.
مقادیر پیش‌فرض پارامترهای \fBrecord\-types\fP و \fBencapsulate\fP خالی
(\fB\(dq\(dq\fP) می‌باشند. مقدار پیش‌فرض \fBspace\fP برابر با \fBdhcp4\fP است\&.
.sp
پس از تعریف قالب گزینهٔ جدید، مقدار آن به همان روش یک گزینهٔ
استاندارد تنظیم می‌شود. برای نمونه، دستورهای زیر مقداری
سراسری را تنظیم می‌کنند که بر تمام زیرشبکه‌ها اعمال می‌شود.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqoption\-data\(dq: [
        {
            \(dqname\(dq: \(dqfoo\(dq,
            \(dqcode\(dq: 222,
            \(dqspace\(dq: \(dqdhcp4\(dq,
            \(dqcsv\-format\(dq: true,
            \(dqdata\(dq: \(dq12345\(dq
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
گزینه‌های جدید می‌توانند اَشکال پیچیده‌تری نسبت به استفادهٔ ساده از انواع اولیه
(مانند uint8، string، ipv4\-address و غیره) به خود بگیرند؛ امکان تعریف گزینه‌ای
متشکل از چندین نوع اولیهٔ موجود وجود دارد.
.sp
برای مثال، فرض کنید می‌خواهیم گزینهٔ جدیدی تعریف کنیم که متشکل از
یک نشانی IPv4، به دنبال آن یک عدد صحیح بی‌علامت 16 بیتی، سپس یک
مقدار بولی (boolean) و در ادامه یک رشتهٔ متنی باشد. چنین گزینه‌ای را
می‌توان به شیوهٔ زیر تعریف کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqoption\-def\(dq: [
        {
            \(dqname\(dq: \(dqbar\(dq,
            \(dqcode\(dq: 223,
            \(dqspace\(dq: \(dqdhcp4\(dq,
            \(dqtype\(dq: \(dqrecord\(dq,
            \(dqarray\(dq: false,
            \(dqrecord\-types\(dq: \(dqipv4\-address, uint16, boolean, string\(dq,
            \(dqencapsulate\(dq: \(dq\(dq
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
پارامتر \fBtype\fP بر روی \fB\(dqrecord\(dq\fP تنظیم شده است تا نشان دهد که این گزینه
شامل چندین مقدار از انواع مختلف است. این نوع‌ها به‌صورت یک فهرست
جداشده با کاما در فیلد \fBrecord\-types\fP مشخص می‌شوند و باید از میان موارد فهرست‌شده
در «فهرست انواع استاندارد گزینه‌های DHCP» (List of standard DHCP option types) باشند\&.
.sp
مقادیر گزینه در یک عبارت \fBoption\-data\fP به شرح زیر تنظیم می‌شوند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqoption\-data\(dq: [
        {
            \(dqname\(dq: \(dqbar\(dq,
            \(dqspace\(dq: \(dqdhcp4\(dq,
            \(dqcode\(dq: 223,
            \(dqcsv\-format\(dq: true,
            \(dqdata\(dq: \(dq192.0.2.100, 123, true, Hello World\(dq
        }
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
پارامتر \fBcsv\-format\fP بر روی \fBtrue\fP تنظیم می‌شود تا نشان دهد فیلد \fBdata\fP
شامل فهرستی از مقادیر جداشده با کاما است. مقادیر موجود در \fBdata\fP باید
با نوع‌های تعیین‌شده در فیلد \fBrecord\-types\fP از تعریف گزینه مطابقت
داشته باشند.
.sp
هنگامی که \fBarray\fP بر روی \fBtrue\fP و \fBtype\fP بر روی \fB\(dqrecord\(dq\fP تنظیم شود،
فیلد پایانی یک آرایه خواهد بود؛ به این معنی که می‌تواند بیش از یک مقدار را شامل شود، مانند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqoption\-def\(dq: [
        {
            \(dqname\(dq: \(dqbar\(dq,
            \(dqcode\(dq: 223,
            \(dqspace\(dq: \(dqdhcp4\(dq,
            \(dqtype\(dq: \(dqrecord\(dq,
            \(dqarray\(dq: true,
            \(dqrecord\-types\(dq: \(dqipv4\-address, uint16\(dq,
            \(dqencapsulate\(dq: \(dq\(dq
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
محتوای گزینهٔ جدید، یک نشانی IPv4 و در پی آن یک یا چند عدد صحیح
بی‌علامت 16 بیتی خواهد بود.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
به‌طور کلی، مقادیر بولی به‌صورت \fBtrue\fP یا \fBfalse\fP،
بدون نقل‌قول مشخص می‌شوند. برخی پارامترهای بولی خاص ممکن است
\fB\(dqtrue\(dq\fP، \fB\(dqfalse\(dq\fP، \fB0\fP، \fB1\fP، \fB\(dq0\(dq\fP و \fB\(dq1\(dq\fP را نیز بپذیرند\&.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
اعداد را می‌توان در قالب ده‌دهی (decimal) یا هگزادسیمال (hexadecimal) مشخص کرد.
قالب هگزادسیمال می‌تواند به‌صورت ساده (مانند abcd) یا با پیشوند
0x (مانند 0xabcd) باشد.
.UNINDENT
.UNINDENT.SS گزینه‌های خصوصی DHCPv4 (DHCPv4 Private Options)
.sp
گزینه‌های دارای کدی بین 224 و 254 برای استفادهٔ خصوصی رزرو شده‌اند.
می‌توان آن‌ها را در حوزهٔ سراسری (global scope) یا در حوزهٔ محلی client\-class
تعریف کرد؛ این امر امکان استفاده از تعاریف گزینه‌ها را بسته به زمینه (context)
فراهم کرده و داده‌های گزینه نیز متناسب با آن تنظیم می‌شوند. برای نمونه، جهت
پیکربندی یک سازندهٔ قدیمی PXEClient:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqclient\-classes\(dq: [
        {
            \(dqname\(dq: \(dqpxeclient\(dq,
            \(dqtest\(dq: \(dqoption[vendor\-class\-identifier].text == \(aqPXEClient\(aq\(dq,
            \(dqoption\-def\(dq: [
                {
                    \(dqname\(dq: \(dqconfigfile\(dq,
                    \(dqcode\(dq: 209,
                    \(dqtype\(dq: \(dqstring\(dq
                }
            ],
            ...
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
از آنجا که گزینهٔ Vendor\-Specific Information (VSI) (کد 43) قالبی مختص
سازنده (vendor\-specific) دارد، یعنی می‌تواند حامل یک مقدار باینری خام یا
زیرگزینه‌ها (sub\-options) باشد، این سازوکار برای این گزینه نیز در دسترس است.
.sp
در مثال زیر که از یک پیکربندی واقعی برداشته شده است، دو کلاس سازنده از گزینهٔ 43
برای اهدافی متفاوت و ناسازگار استفاده می‌کنند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqoption\-def\(dq: [
        {
            \(dqname\(dq: \(dqcookie\(dq,
            \(dqcode\(dq: 1,
            \(dqtype\(dq: \(dqstring\(dq,
            \(dqspace\(dq: \(dqAPC\(dq
        },
        {
            \(dqname\(dq: \(dqmtftp\-ip\(dq,
            \(dqcode\(dq: 1,
            \(dqtype\(dq: \(dqipv4\-address\(dq,
            \(dqspace\(dq: \(dqPXE\(dq
        },
        ...
    ],
    \(dqclient\-classes\(dq: [
        {
            \(dqname\(dq: \(dqAPC\(dq,
            \(dqtest\(dq: \(dqoption[vendor\-class\-identifier].text == \(aqAPC\(aq\(dq,
            \(dqoption\-def\(dq: [
                {
                    \(dqname\(dq: \(dqvendor\-encapsulated\-options\(dq,
                    \(dqtype\(dq: \(dqempty\(dq,
                    \(dqencapsulate\(dq: \(dqAPC\(dq
                }
            ],
            \(dqoption\-data\(dq: [
                {
                    \(dqname\(dq: \(dqcookie\(dq,
                    \(dqspace\(dq: \(dqAPC\(dq,
                    \(dqdata\(dq: \(dq1APC\(dq
                },
                {
                    \(dqname\(dq: \(dqvendor\-encapsulated\-options\(dq
                },
                ...
            ],
            ...
        },
        {
            \(dqname\(dq: \(dqPXE\(dq,
            \(dqtest\(dq: \(dqoption[vendor\-class\-identifier].text == \(aqPXE\(aq\(dq,
            \(dqoption\-def\(dq: [
                {
                    \(dqname\(dq: \(dqvendor\-encapsulated\-options\(dq,
                    \(dqtype\(dq: \(dqempty\(dq,
                    \(dqencapsulate\(dq: \(dqPXE\(dq
                }
            ],
            \(dqoption\-data\(dq: [
                {
                    \(dqname\(dq: \(dqmtftp\-ip\(dq,
                    \(dqspace\(dq: \(dqPXE\(dq,
                    \(dqdata\(dq: \(dq0.0.0.0\(dq
                },
                {
                    \(dqname\(dq: \(dqvendor\-encapsulated\-options\(dq
                },
                ...
            ],
            ...
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
تعریف مورداستفاده برای رمزگشایی (decode) یک گزینهٔ VSI به شرح زیر است:
.INDENT 0.0
.IP 1. 3
تعریف محلی کلاس کلاینتی که بستهٔ ورودی به آن تعلق دارد؛
.IP 2. 3
در صورت عدم وجود، تعریف سراسری (global)؛
.IP 3. 3
در صورت عدم وجود، تعریف آخرین راه‌حل (last\-resort) توصیف‌شده در بخش بعدی،
DHCPv4 Vendor\-Specific Options (سازگار با نسخه‌های قبلی Kea).
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این تعریف آخرین راه‌حل برای گزینهٔ Vendor\-Specific Information
(کد 43) با مقادیر باینری خام سازگار نیست. در مواردی که مشخص است یک مقدار
باینری خام استفاده خواهد شد، باید یک client class تعریف شود که هم شامل
یک عبارت دسته‌بندی مطابق با این موارد و هم یک تعریف گزینه برای گزینهٔ VSI
با نوع binary و بدون کپسوله‌سازی (encapsulation) باشد.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
به‌طور پیش‌فرض، در گزینهٔ Vendor\-Specific Information (کد 43)، کدهای
زیرگزینهٔ 0 و 255 بر اساس RFC 2132 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc2132>\&
به ترتیب به معنای PAD و END هستند. به بیان دیگر، مقادیر کد زیرگزینهٔ
0 و 255 رزرو شده‌اند. با این حال، Kea به کاربران اجازه می‌دهد کدهای
زیرگزینه را از 0 تا 255 تعریف کنند. در صورتی که زیرگزینه‌هایی با کدهای 0
و/یا 255 تعریف شوند، بایت‌های دارای آن مقدار هنگام تجزیهٔ یک گزینهٔ VSI
در یک پرس‌وجوی ورودی، دیگر به عنوان PAD یا END در نظر گرفته نشده، بلکه
به عنوان کد زیرگزینه تلقی می‌شوند.
.sp
پردازش ورودی گزینهٔ 43 (که باز کردن بسته یا unpacking نیز نامیده می‌شود) به
تعویق می‌افتد تا پس از مرحلهٔ دسته‌بندی (classification) انجام شود. این بدان
معناست که کلاینت‌ها را نمی‌توان با استفاده از زیرگزینه‌های گزینهٔ 43 دسته‌بندی کرد.
تعریفی که برای unpack کردن گزینهٔ 43 استفاده می‌شود به صورت زیر تعیین می‌گردد:
.INDENT 0.0
.IP \(bu 2
اگر در حوزهٔ سراسری تعریف شده باشد، از این تعریف استفاده می‌شود.
.IP \(bu 2
اگر در حوزهٔ client class تعریف شده باشد و بسته به این کلاس تعلق داشته باشد،
از تعریف client class استفاده می‌شود.
.IP \(bu 2
اگر نه در حوزهٔ سراسری و نه در یک client class که بسته به آن تعلق دارد تعریف
نشده باشد، از تعریف پیش‌ساختهٔ آخرین راه‌حل استفاده می‌شود. این تعریف صرفاً
بیان می‌کند که فضای زیرگزینه برابر با
\fB\(dqvendor\-encapsulated\-options\-space\(dq\fP\& است.
.UNINDENT
.sp
انتخاب تعریف خروجی کمی ساده‌تر است:
.INDENT 0.0
.IP \(bu 2
اگر بسته به یک client class تعلق داشته باشد که گزینهٔ 43 را تعریف کرده است،
از این تعریف استفاده شود.
.IP \(bu 2
اگر در حوزهٔ سراسری تعریف شده باشد، از این تعریف استفاده شود.
.IP \(bu 2
در غیر این صورت، از تعریف پیش‌ساختهٔ آخرین راه‌حل استفاده شود.
.UNINDENT
.sp
از آنجا که زیرگزینه‌ها از یک فضای گزینهٔ خاص/به‌ازای هر سازنده (per vendor)
استفاده می‌کنند، در حوزهٔ سراسری تعریف می‌شوند.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
تعاریف گزینه در کلاس‌های کلاینت تنها برای این مجموعه گزینهٔ محدود
(کدهای 43 و از 224 تا 254)، و فقط برای DHCPv4 مجاز است.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
همچنین بازتعریف برخی از گزینه‌های استاندارد در Kea، از طریق قلاب (hook) مربوط به
libdhcp_flex_option.so: Flexible Option Actions for Option Value Settings \%<#\:hooks-flex-option>
امکان‌پذیر است. نمونه‌هایی از این سازوکار در این مقالهٔ پایگاه دانش (Knowledgebase) موجود است:
\%<https://\:kb\:.isc\:.org/\:docs/\:redefining-standard-options>\&.
.UNINDENT
.UNINDENT.SS گزینه‌های اختصاصی سازنده در DHCPv4 (DHCPv4 Vendor\-Specific Options)
.sp
در حال حاضر دو فضای گزینه (option space) برای \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> تعریف شده است:
\fBdhcp4\fP (برای گزینه‌های سطح بالای DHCPv4) و
\fB\(dqvendor\-encapsulated\-options\-space\(dq\fP، که به‌طور پیش‌فرض خالی است اما
می‌توان گزینه‌هایی را در آن تعریف کرد. این گزینه‌ها در گزینهٔ
اطلاعات اختصاصی سازنده (Vendor\-Specific Information - کد 43) حمل می‌شوند. مثال‌های زیر
نحوهٔ تعریف گزینهٔ \fBfoo\fP با کد 1 را نشان می‌دهند که
شامل یک آدرس IPv4، یک عدد صحیح بی‌علامت ۱۶ بیتی، و یک رشته است. گزینهٔ
\fBfoo\fP در یک گزینهٔ Vendor\-Specific Information منتقل می‌شود.
.sp
گام نخست، تعریف قالب گزینه است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqoption\-def\(dq: [
        {
            \(dqname\(dq: \(dqfoo\(dq,
            \(dqcode\(dq: 1,
            \(dqspace\(dq: \(dqvendor\-encapsulated\-options\-space\(dq,
            \(dqtype\(dq: \(dqrecord\(dq,
            \(dqarray\(dq: false,
            \(dqrecord\-types\(dq: \(dqipv4\-address, uint16, string\(dq,
            \(dqencapsulate\(dq: \(dq\(dq
        }
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
توجه داشته باشید که فضای گزینه روی \fB\(dqvendor\-encapsulated\-options\-space\(dq\fP تنظیم شده است\&.
پس از تعریف قالب گزینه، گام بعدی تعیین مقادیر واقعی برای آن گزینه است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqoption\-data\(dq: [
        {
            \(dqname\(dq: \(dqfoo\(dq,
            \(dqspace\(dq: \(dqvendor\-encapsulated\-options\-space\(dq,
            \(dqcode\(dq: 1,
            \(dqcsv\-format\(dq: true,
            \(dqdata\(dq: \(dq192.0.2.3, 123, Hello World\(dq
        }
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
در این مثال، ما گزینهٔ Vendor\-Specific Information را نیز که حامل
زیرگزینهٔ \fBfoo\fP ما است می‌گنجانیم\&. این کار الزامی است؛ در غیر این صورت، گزینه
در پیام‌های ارسال‌شده به کلاینت قرار نخواهد گرفت.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqoption\-data\(dq: [
        {
            \(dqname\(dq: \(dqvendor\-encapsulated\-options\(dq
        }
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
همچنین می‌توان گزینه را با استفاده از کد آن مشخص کرد.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqoption\-data\(dq: [
        {
            \(dqcode\(dq: 43
        }
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
گزینهٔ پرکاربرد دیگری که معمولاً تا حدی نادقیق \(dqvendor option\(dq نامیده می‌شود، گزینهٔ 125 است. نام درست آن \(dqvendor\-independent vendor\-specific information option\(dq یا \(dqvivso\(dq است. ایدهٔ پشت گزینه‌های vivso این است که هر سازنده مجموعهٔ منحصربه‌فردی از گزینه‌ها را با قالب‌های سفارشی خود دارد. سازنده با یک عدد صحیح بی‌علامت ۳۲ بیتی به نام \fBenterprise\-number\fP یا \fBvendor\-id\fP شناسایی می‌شود\&.
.sp
فضاهای استانداردی که در Kea تعریف شده‌اند و گزینه‌های آن‌ها عبارتند از:
.INDENT 0.0
.IP \(bu 2
\fBvendor\-4491\fP: متعلق به Cable Television Laboratories, Inc. برای گزینه‌های DOCSIS3:
.UNINDENT
.TS
box center;
l|l|l.
T{
کد گزینه
T}	T{
نام گزینه
T}	T{
توضیحات گزینه
T}
_
T{
1
T}	T{
oro
T}	T{
مخفف ORO (یا Option Request Option)، که توسط کلاینت‌ها برای درخواست فهرستی از گزینه‌های مورد نظرشان استفاده می‌شود.
T}
_
T{
2
T}	T{
tftp\-servers
T}	T{
فهرستی از آدرس‌های IPv4 سرورهای TFTP که باید توسط مودم کابلی استفاده شوند.
T}
.TE
.sp
در Kea، هر سازنده با فضای سازنده (vendor space) خاص خود مشخص می‌شود. از آنجا که صدها سازنده وجود دارند و گاهی برای سخت‌افزارهای مختلف از تعاریف گزینه‌های متفاوتی استفاده می‌کنند، پشتیبانی توکار Kea از همهٔ آن‌ها غیرممکن است. خوشبختانه، تعریف پشتیبانی برای گزینه‌های سازندگان جدید آسان است. به عنوان مثال، دستگاه درگاه خانگی (home gateway) شرکت Genexis نیازمند آن است که گزینهٔ vivso 125 همراه با زیرگزینهٔ 2 که حاوی رشته‌ای شامل URL سرور TFTP است ارسال شود. برای پشتیبانی از چنین دستگاهی سه مرحله لازم است: نخست، ایجاد تعاریف گزینه که مشخص می‌کند ساختار گزینه چگونه باید باشد؛ دوم، تعیین مقادیر گزینه؛ و سوم، مشخص کردن زمان ارسال آن گزینه‌های خاص برای Kea از طریق دسته‌بندی کلاینت (client classification).
.sp
یک نمونه قطعه از پیکربندی می‌تواند شبیه به مورد زیر باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    // First, we need to define that the sub\-option 2 in vivso option for
    // vendor\-id 25167 has a specific format (it\(aqs a plain string in this example).
    // After this definition, we can specify values for option tftp.
    \(dqoption\-def\(dq: [
        {
            // We define a short name, so the option can be referenced by name.
            // The option has code 2 and resides within vendor space 25167.
            // Its data is a plain string.
            \(dqname\(dq: \(dqtftp\(dq,
            \(dqcode\(dq: 2,
            \(dqspace\(dq: \(dqvendor\-25167\(dq,
            \(dqtype\(dq: \(dqstring\(dq
        }
    ],

    \(dqclient\-classes\(dq: [
        {
            // We now need to tell Kea how to recognize when to use vendor space 25167.
            // Usually we can use a simple expression, such as checking if the device
            // sent a vivso option with specific vendor\-id, e.g. \(dqvendor[4491].exists\(dq.
            // Unfortunately, Genexis is a bit unusual in this aspect, because it
            // doesn\(aqt send vivso. In this case we need to look into the vendor class
            // (option code 60) and see if there\(aqs a specific string that identifies
            // the device. Alternatively, one can make use of the automated \(gaVENDOR_CLASS_\(ga
            // client class and replace \(dqname\(dq and \(dqtest\(dq with \(ga\(dqname\(dq: \(dqVENDOR_CLASS_HMC1000\(dq\(ga
            // and no test expression.
            \(dqname\(dq: \(dqcpe_genexis\(dq,
            \(dqtest\(dq: \(dqsubstring(option[60].hex,0,7) == \(aqHMC1000\(aq\(dq,

            // Once the device is recognized, we want to send two options:
            // the vivso option with vendor\-id set to 25167, and a sub\-option 2.
            \(dqoption\-data\(dq: [
                {
                    \(dqname\(dq: \(dqvivso\-suboptions\(dq,
                    \(dqdata\(dq: \(dq25167\(dq
                },

                // The sub\-option 2 value is defined as any other option. However,
                // we want to send this sub\-option 2, even when the client didn\(aqt
                // explicitly request it (often there is no way to do that for
                // vendor options). Therefore we use always\-send to force Kea
                // to always send this option when 25167 vendor space is involved.
                {
                    \(dqname\(dq: \(dqtftp\(dq,
                    \(dqspace\(dq: \(dqvendor\-25167\(dq,
                    \(dqdata\(dq: \(dqtftp://192.0.2.1/genexis/HMC1000.v1.3.0\-R.img\(dq,
                    \(dqalways\-send\(dq: true
                }
            ]
        }
    ]
}
.EE
.UNINDENT
.UNINDENT
.sp
به‌طور پیش‌فرض، Kea تنها گزینه‌هایی را بازمی‌گرداند که توسط کلاینت درخواست شده باشند، مگر اینکه قواعد پروتکل به سرور DHCP دستور دهند که همواره گزینه‌ای را ارسال کند. این رویکرد در بیشتر موارد به‌خوبی عمل می‌کند و مانع از بروز مشکلاتی می‌شود که کلاینت‌ها پاسخ‌های حاوی گزینه‌های ناشناخته را رد می‌کنند. با این حال، وضعیت گزینه‌های سازنده پیچیده‌تر است، زیرا این گزینه‌ها مشابه سایر گزینه‌ها درخواست نمی‌شوند، در RFCهای رسمی به‌خوبی مستند نشده‌اند، یا بسته به سازنده متفاوت هستند.
.sp
برخی سازندگان (مانند DOCSIS که با گزینهٔ سازندهٔ 4491 مشخص می‌شود) سازوکاری برای درخواست گزینه‌های خاص سازنده دارند و Kea قادر است آن‌ها را رعایت کند (زیرگزینهٔ 1). متأسفانه برای بسیاری از سازندگان دیگر، مانند Genexis (شمارهٔ 25167 که در بالا بررسی شد)، Kea چنین سازوکاری ندارد، بنابراین نمی‌تواند هیچ زیرگزینه‌ای را به‌خودی‌خود ارسال کند. برای حل این مشکل، مفهوم گزینه‌های پایدار (persistent options) ابداع شده است. می‌توان به Kea دستور داد که گزینه‌ها را همیشه ارسال کند، حتی اگر کلاینت آن‌ها را درخواست نکرده باشد. این کار با افزودن \fB\(dqalways\-send\(dq: true\fP به ورودی داده‌های گزینه امکان‌پذیر است. توجه داشته باشید که در این مورد خاص، گزینه‌ای در فضای سازندهٔ 25167 تعریف شده است. با فعال بودن \fBalways\-send\fP، هر بار که نیازی به تعامل با فضای سازندهٔ 25167 باشد، این گزینه ارسال می‌شود.
.sp
همچنین به همین شیوه می‌توان \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> را برای ارسال چندین گزینهٔ سازنده از سازندگان مختلف، به همراه شناسهٔ سازندهٔ ویژهٔ هر کدام پیکربندی کرد.
اگر لازم است این گزینه‌ها بدون توجه به اینکه کلاینت شمارهٔ سازمانی (enterprise number) را مشخص کرده باشد یا خیر توسط سرور ارسال شوند، باید \fB\(dqalways\-send\(dq: true\fP برای زیرگزینه‌هایی که درون گزینهٔ \fBvivso\-suboptions\fP (کد 125) قرار می‌گیرند پیکربندی شود.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqoption\-data\(dq: [
        # Typically DHCPv4 clients will send a Parameter Request List option (code 55) for
        # vivso\-suboptions (code 125), and that is enough for Kea to understand that it needs to
        # send the option. These options still need to be defined in the configuration, one per
        # each vendor, but they don\(aqt need \(dqalways\-send\(dq enabled in that case. For misbehaving
        # clients that do not explicitly request it, one may alternatively set \(dqalways\-send\(dq
        # to true for them as well. This is referring to the following two entries in option\-data.
        {
            \(dqname\(dq: \(dqvivso\-suboptions\(dq,
            \(dqspace\(dq: \(dqdhcp4\(dq,
            \(dqdata\(dq: \(dq2234\(dq
        },
        {
            \(dqname\(dq: \(dqvivso\-suboptions\(dq,
            \(dqspace\(dq: \(dqdhcp4\(dq,
            \(dqdata\(dq: \(dq3561\(dq
        },
        {
            \(dqalways\-send\(dq: true,
            \(dqdata\(dq: \(dqtagged\(dq,
            \(dqname\(dq: \(dqtag\(dq,
            \(dqspace\(dq: \(dqvendor\-2234\(dq
        },
        {
            \(dqalways\-send\(dq: true,
            \(dqdata\(dq: \(dqhttps://example.com:1234/path\(dq,
            \(dqname\(dq: \(dqurl\(dq,
            \(dqspace\(dq: \(dqvendor\-3561\(dq
        }
    ],
    \(dqoption\-def\(dq: [
        {
            \(dqcode\(dq: 22,
            \(dqname\(dq: \(dqtag\(dq,
            \(dqspace\(dq: \(dqvendor\-2234\(dq,
            \(dqtype\(dq: \(dqstring\(dq
        },
        {
            \(dqcode\(dq: 11,
            \(dqname\(dq: \(dqurl\(dq,
            \(dqspace\(dq: \(dqvendor\-3561\(dq,
            \(dqtype\(dq: \(dqstring\(dq
        }
    ]
}
.EE
.UNINDENT
.UNINDENT
.sp
امکان دیگر بازتعریف گزینه است؛ بخش «DHCPv4 Private Options» را ببینید\&.
.sp
‏Kea به همراه چند فایل پیکربندی نمونه ارائه می‌شود. برخی از آن‌ها نحوهٔ پیکربندی گزینه‌های 60 و 43 را نشان می‌دهند. فایل‌های kea4/vendor\-specific.json \%<#\:config-example-kea4-vendor-specific-json> و kea4/vivso.json \%<#\:config-example-kea4-vivso-json> را ببینید\&.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
\fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> قادر است چندین گزینهٔ Vendor Class Identifier (کد 60) با شناسه‌های سازندهٔ مختلف را در درخواست‌های کلاینت تشخیص داده و چندین گزینهٔ vivso (کد 125) را در پاسخ‌ها، یکی به ازای هر سازنده، ارسال کند.
.sp
\fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> زیرگزینهٔ 1 در DOCSIS (یعنی ORO) را رعایت می‌کند و تنها در صورتی که این زیرگزینه در درخواست کلاینت موجود باشد، گزینه‌های درخواست‌شده را اضافه می‌نماید.
.sp
در حال حاضر تنها از یک سازنده برای گزینهٔ \fBvivco\-suboptions\fP (کد 124) پشتیبانی می‌شود. مشخص کردن چندین شمارهٔ سازمانی درون یک نمونه از گزینه یا چندین گزینه با شماره‌های سازمانی مختلف پشتیبانی نمی‌شود.
.UNINDENT
.UNINDENT.SS گزینه‌های تودرتوی DHCPv4 (فضاهای گزینه سفارشی)
.sp
گاهی اوقات تعریف یک فضای گزینه کاملاً جدید سودمند است، مانند زمانی که کاربر
گزینه جدیدی را در فضای استاندارد گزینه (\fBdhcp4\fP) ایجاد می‌کند و می‌خواهد
این گزینه زیرگزینه‌ها (sub\-options) را منتقل کند. از آنجا که زیرگزینه‌ها
در یک فضای جداگانه قرار دارند، کدهای آن‌ها از یک طرح شماره‌گذاری مجزا پیروی
می‌کنند و ممکن است با کدهای گزینه‌های استاندارد هم‌پوشانی داشته باشند.
.sp
توجه داشته باشید که هنگام تعریف زیرگزینه‌ها برای یک گزینه استاندارد، نیازی به
ایجاد فضای گزینه جدید نیست؛ چرا که اگر گزینه استاندارد قرار باشد زیرگزینه‌هایی را
منتقل کند، به طور پیش‌فرض یک فضا ایجاد می‌شود (بخش DHCPv4 Vendor\-Specific Options
را ببینید).
.sp
اگر یک گزینه DHCPv4 به نام \fBcontainer\fP با کد 222 بخواهیم که دو زیرگزینه با
کدهای 1 و 2 را منتقل کند، ابتدا باید زیرگزینه‌های جدید را تعریف کنیم:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqoption\-def\(dq: [
        {
            \(dqname\(dq: \(dqsubopt1\(dq,
            \(dqcode\(dq: 1,
            \(dqspace\(dq: \(dqisc\(dq,
            \(dqtype\(dq: \(dqipv4\-address\(dq,
            \(dqrecord\-types\(dq: \(dq\(dq,
            \(dqarray\(dq: false,
            \(dqencapsulate\(dq: \(dq\(dq
        },
        {
            \(dqname\(dq: \(dqsubopt2\(dq,
            \(dqcode\(dq: 2,
            \(dqspace\(dq: \(dqisc\(dq,
            \(dqtype\(dq: \(dqstring\(dq,
            \(dqrecord\-types\(dq: \(dq\(dq,
            \(dqarray\(dq: false,
            \(dqencapsulate\(dq: \(dq\(dq
        }
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
توجه داشته باشید که ما گزینه‌ها را طوری تعریف کرده‌ایم که متعلق به یک فضای
گزینه جدید باشند (در این مورد، \fB\(dqisc\(dq\fP).
.sp
مرحله بعد، تعریف یک گزینه معمولی DHCPv4 با کد مورد نظر و مشخص کردن این است
که باید شامل گزینه‌هایی از فضای گزینه جدید باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqoption\-def\(dq: [
        {
            \(dqname\(dq: \(dqcontainer\(dq,
            \(dqcode\(dq: 222,
            \(dqspace\(dq: \(dqdhcp4\(dq,
            \(dqtype\(dq: \(dqempty\(dq,
            \(dqarray\(dq: false,
            \(dqrecord\-types\(dq: \(dq\(dq,
            \(dqencapsulate\(dq: \(dqisc\(dq
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
نام فضای گزینه‌ای که زیرگزینه‌ها در آن تعریف شده‌اند در فیلد \fBencapsulate\fP
تنظیم می‌شود. فیلد \fBtype\fP روی \fB\(dqempty\(dq\fP تنظیم می‌شود تا نشان دهد این
گزینه هیچ داده‌ای به جز زیرگزینه‌ها را حمل نمی‌کند.
.sp
در نهایت، می‌توانیم مقادیر گزینه‌های جدید را مقداردهی کنیم:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp4\(dq: {
    \(dqoption\-data\(dq: [
        {
            \(dqname\(dq: \(dqsubopt1\(dq,
            \(dqcode\(dq: 1,
            \(dqspace\(dq: \(dqisc\(dq,
            \(dqdata\(dq: \(dq192.0.2.3\(dq
        },
        {
            \(dqname\(dq: \(dqsubopt2\(dq,
            \(dqcode\(dq: 2,
            \(dqspace\(dq: \(dqisc\(dq,
            \(dqdata\(dq: \(dqHello world\(dq
        },
        {
            \(dqname\(dq: \(dqcontainer\(dq,
            \(dqcode\(dq: 222,
            \(dqspace\(dq: \(dqdhcp4\(dq
        }
    ]
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
امکان ایجاد گزینه‌ای که علاوه بر زیرگزینه‌های تعریف‌شده در فضای گزینه
کپسوله‌شده، داده‌هایی را نیز با خود حمل کند وجود دارد. برای مثال، اگر در نمونه
قبلی نیاز بود که گزینه \fBcontainer\fP علاوه بر زیرگزینه‌ها یک مقدار uint16 را
نیز انتقال دهد، مقدار \fBtype\fP در تعریف گزینه باید روی \fB\(dquint16\(dq\fP تنظیم
می‌شد. (چنین گزینه‌ای در این صورت ساختار داده‌ای به این شکل خواهد داشت: سربرگ
DHCP، مقدار uint16، زیرگزینه‌ها.) سپس مقداری که با پارامتر \fBdata\fP مشخص
می‌شود — که باید یک عدد صحیح معتبر داخل نقل‌قول باشد، مانند \fB\(dq123\(dq\fP — به
فیلد \fBuint16\fP در گزینه \fBcontainer\fP اختصاص می‌یابد..SS پارامترهای مشخص‌نشده برای پیکربندی گزینه DHCPv4
.sp
در بسیاری از موارد نیازی به تعیین تمام پارامترها برای پیکربندی یک گزینه نیست
و می‌توان از مقادیر پیش‌فرض استفاده کرد. با این حال، درک پیامدهای عدم تعیین
برخی از آن‌ها مهم است، چرا که ممکن است به خطاهای پیکربندی منجر شود. فهرست
زیر رفتار سرور را در حالتی که پارامتر خاصی به طور صریح تعیین نشده باشد،
توضیح می‌دهد:
.INDENT 0.0
.IP \(bu 2
\fBname\fP \- سرور برای شناسایی یک گزینه، به نام گزینه یا کد گزینه نیاز دارد.
اگر این پارامتر مشخص نشده باشد، کد گزینه باید تعیین شود.
.IP \(bu 2
\fBcode\fP \- سرور برای شناسایی یک گزینه به نام یا کد گزینه نیاز دارد؛
در صورتی که پارامتر \fBname\fP مشخص شده باشد، این پارامتر می‌تواند تعیین‌نشده
باقی بماند. با این حال، این امر همچنین مستلزم آن است که گزینه مورد نظر تعریفی
داشته باشد (چه به عنوان یک گزینه استاندارد یا تعریفی که توسط مدیر سیستم برای
گزینه و با استفاده از ساختار \fBoption\-def\fP ایجاد شده باشد)، زیرا تعریف
گزینه، آن را به نامی مشخص مرتبط می‌سازد. امکان پیکربندی گزینه‌ای که برای آن
تعریفی وجود ندارد (قالب گزینه نامشخص) وجود دارد. پیکربندی چنین گزینه‌هایی
مستلزم استفاده از کد گزینه است.
.IP \(bu 2
\fBspace\fP \- اگر فضای گزینه مشخص نشده باشد، مقدار پیش‌فرض آن \fBdhcp4\fP
خواهد بود که فضای گزینه‌ای حاوی گزینه‌های استاندارد DHCPv4 است.
.IP \(bu 2
\fBdata\fP \- اگر داده‌های گزینه مشخص نشده باشد، مقدار پیش‌فرض آن تهی خواهد بود.
مقدار تهی عمدتاً برای گزینه‌های فاقد بار داده (گزینه‌های بولی / boolean)
استفاده می‌شود، اما تعیین مقادیر تهی برای برخی از گزینه‌های حامل داده با طول
متغیر که استاندارد آن‌ها طول ۰ را مجاز می‌داند، قانونی و معتبر است. برای
چنین گزینه‌هایی، پارامتر data می‌تواند در پیکربندی حذف شود.
.IP \(bu 2
\fBcsv\-format\fP \- اگر این مقدار مشخص نشود، سرور فرض می‌کند که داده‌های گزینه
به صورت فهرستی از مقادیر جداشده با کاما برای انتساب به فیلدهای منفرد گزینه
DHCP مشخص شده‌اند.
.UNINDENT
.SS پشتیبانی از گزینه‌های طولانی
.sp
سرور \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> تا حدی از گزینه‌های طولانی (RFC 3396)
پشتیبانی می‌کند. از نسخه Kea 2.1.6، سرور پیکربندی گزینه‌ها و زیرگزینه‌های
طولانی (بیشتر از ۲۵۵ بایت) را می‌پذیرد. گزینه‌ها و زیرگزینه‌ها به صورت داخلی
در قالب بسته‌بندی‌نشده (unwrapped) خود ذخیره می‌شوند و می‌توان آن‌ها را طبق
معمول با استفاده از زبان تجزیه‌گر پردازش کرد. در هنگام ارسال، سرور گزینه‌ها
و زیرگزینه‌های طولانی را با استفاده از کد گزینه مربوطه، به چندین گزینه
و زیرگزینه تقسیم می‌کند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
\(dqoption\-def\(dq: [
    {
        \(dqarray\(dq: false,
        \(dqcode\(dq: 240,
        \(dqencapsulate\(dq: \(dq\(dq,
        \(dqname\(dq: \(dqmy\-option\(dq,
        \(dqspace\(dq: \(dqdhcp4\(dq,
        \(dqtype\(dq: \(dqstring\(dq
    }
],
\(dqsubnet4\(dq: [
    {
        \(dqid\(dq: 1,
        \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
        \(dqreservations\(dq: [
            {
                \(dqhw\-address\(dq: \(dqaa:bb:cc:dd:ee:ff\(dq,
                \(dqoption\-data\(dq: [
                    {
                        \(dqalways\-send\(dq: false,
                        \(dqcode\(dq: 240,
                        \(dqname\(dq: \(dqmy\-option\(dq,
                        \(dqcsv\-format\(dq: true,
                        \(dqdata\(dq: \(dqdata \e
                                 \-00010203040506070809\-00010203040506070809\-00010203040506070809\-00010203040506070809 \e
                                 \-00010203040506070809\-00010203040506070809\-00010203040506070809\-00010203040506070809 \e
                                 \-00010203040506070809\-00010203040506070809\-00010203040506070809\-00010203040506070809 \e
                                 \-data\(dq,
                        \(dqspace\(dq: \(dqdhcp4\(dq
                    }
                ]
            }
        ]
    }
],
\&...
}
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
در مثال بالا، داده‌ها برای وضوح بیشتر در چند خط شکسته شده‌اند، اما Kea
از شکستن خطوط در فایل پیکربندی پشتیبانی نمی‌کند.
.UNINDENT
.UNINDENT
.sp
این مثال پیکربندی یک گزینه طولانی سفارشی (بیش از ۲۵۵ بایت) را در یک رزرو
نشان می‌دهد. هنگام ارسال پاسخ، سرور این گزینه را به دو گزینه تقسیم می‌کند
که هر کدام دارای کد ۲۴۰ هستند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
در حال حاضر سرور از ذخیره گزینه‌های طولانی در پایگاه‌های داده، چه از طریق
رزروهای میزبان و چه از طریق بک‌اند پیکربندی، پشتیبانی نمی‌کند.
.UNINDENT
.UNINDENT
.sp
سرور همچنین قادر به دریافت بسته‌هایی با گزینه‌های تقسیم‌شده (گزینه‌هایی با کد
گزینه یکسان) و ادغام تکه‌های داده در یک گزینه واحد است. این قابلیت برای
زیرگزینه‌ها نیز پشتیبانی می‌شود، مشروط بر اینکه هر تکه از داده‌های زیرگزینه
شامل کد زیرگزینه و طول زیرگزینه نیز باشد.
.SS پشتیبانی از گزینه IPv6\-Only Preferred
.sp
گزینه \fBv6\-only\-preferred\fP (کد ۱۰۸) در صورتی که در یک زیرشبکه یا یک شبکه
اشتراکی پیکربندی شده باشد، توسط \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4>
به شیوه خاصی که در RFC 8925 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc8925>
شرح داده شده است مدیریت می‌شود: هنگامی که کلاینت این گزینه را درخواست می‌کند
(یعنی کد ۱۰۸ را در گزینه فهرست درخواست پارامترهای DHCP قرار می‌دهد) و زیرشبکه
یا شبکه اشتراکی انتخاب می‌شود، آدرس 0.0.0.0 پیشنهاد شده و گزینه در پاسخ
بازگردانده می‌شود..SS پیکربندی بی‌حالت کارخواه‌های DHCPv4
.sp
کارساز DHCPv4 از پیکربندی بی‌حالت (stateless) کارخواه پشتیبانی می‌کند، که در آن یک نشانی IP برای کارخواه پیکربندی شده است (برای نمونه با استفاده از پیکربندی دستی) و تنها برای دریافت دیگر پارامترهای پیکربندی مانند نشانی کارسازهای DNS با کارساز ارتباط برقرار می‌کند. جهت دریافت پارامترهای پیکربندی بی‌حالت، کارخواه پیام DHCPINFORM را با مقداردهی \fBciaddr\fP به نشانی‌ای که کارخواه در حال حاضر استفاده می‌کند به کارساز می‌فرستد. کارساز پیام DHCPACK را به‌صورت تک‌پخشی (unicast) به کارخواه ارسال می‌کند که شامل پیکربندی بی‌حالت است (\(dqyiaddr\(dq تنظیم نشده است).
.sp
کارساز زمانی به DHCPINFORM پاسخ می‌دهد که کارخواه با زیرشبکه‌ای که در پیکربندی کارساز تعریف شده است مرتبط باشد. نمونه‌ای از پیکربندی زیرشبکه به این صورت است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqsubnet4\(dq: [
        {
            \(dqid\(dq: 1,
            \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
            \(dqoption\-data\(dq: [
            {
                \(dqname\(dq: \(dqdomain\-name\-servers\(dq,
                \(dqcode\(dq: 6,
                \(dqdata\(dq: \(dq192.0.2.200,192.0.2.201\(dq,
                \(dqcsv\-format\(dq: true,
                \(dqspace\(dq: \(dqdhcp4\(dq
            }
            ]
        }
    ]
}
.EE
.UNINDENT
.UNINDENT
.sp
این زیرشبکه گزینهٔ یکتایی را مشخص می‌کند که در پاسخ به DHCPINFORM، در پیام DHCPACK برای کارخواه گنجانده خواهد شد. اگر تعریف زیرشبکه صرفاً برای پیکربندی بی‌حالت به کار رود، نیازی به پیکربندی استخر نشانی (pool) ندارد.
.sp
کارساز در صورت برقراری یکی از شرایط زیر، زیرشبکه را با کارخواه مرتبط خواهد کرد:
.INDENT 0.0
.IP \(bu 2
پیام DHCPINFORM بازپخش (relay) شده باشد و \fBgiaddr\fP با زیرشبکهٔ پیکربندی‌شده مطابقت داشته باشد.
.IP \(bu 2
پیام DHCPINFORM به‌صورت تک‌پخشی از کارخواه ارسال شده باشد و \fBciaddr\fP با زیرشبکهٔ پیکربندی‌شده مطابقت داشته باشد.
.IP \(bu 2
پیام DHCPINFORM به‌صورت تک‌پخشی از کارخواه ارسال شده و \fBciaddr\fP تنظیم نشده باشد، اما نشانی مبدأ بستهٔ IP با زیرشبکهٔ پیکربندی‌شده مطابقت داشته باشد.
.IP \(bu 2
پیام DHCPINFORM بازپخش نشده باشد و نشانی IP روی رابطی که پیام در آن دریافت شده است با زیرشبکهٔ پیکربندی‌شده مطابقت داشته باشد.
.UNINDENT
.SS دسته‌بندی کارخواه‌ها در DHCPv4
.sp
کارساز DHCPv4 شامل پشتیبانی از دسته‌بندی کارخواه‌ها (client classification) است. برای بررسی دقیق‌تر فرایند دسته‌بندی، Client Classification \%<#\:classify>\& را ببینید.
.sp
در موارد خاص، پیکربندی کارساز برای تمایز قائل شدن میان انواع کارخواه‌های DHCP و رفتار متناسب با آن‌ها سودمند است. از دسته‌بندی کارخواه‌ها می‌توان برای تغییر رفتار تقریباً هر بخشی از پردازش پیام‌های DHCP استفاده کرد. Kea در حال حاضر دسته‌بندی کارخواه‌ها را از طریق گزینه‌های اختصاصی و باز کردن باتأخیر گزینهٔ ۴۳ (deferred unpacking)؛ انتخاب زیرشبکه؛ انتخاب استخر؛ تخصیص گزینه‌های گوناگون؛ و برای مودم‌های کابلی، گزینه‌های ویژه جهت استفاده با نشانی کارساز TFTP و فیلد فایل راه‌اندازی (boot file) فراهم می‌کند.
.sp
می‌توان به Kea دستور داد تا دسترسی به زیرشبکه‌های مشخص را بر پایهٔ اطلاعات دسته محدود سازد. این قابلیت به‌ویژه در مواردی سودمند است که دو نوع دستگاه پیوند (link) مشترکی دارند و انتظار می‌رود از دو زیرشبکهٔ متفاوت سرویس‌دهی شوند. کاربرد اصلی چنین سناریویی شبکه‌های کابلی است، جایی که دو دسته دستگاه وجود دارد: خود مودم کابلی، که باید یک اجاره (lease) از زیرشبکهٔ A به آن تخصیص یابد؛ و همهٔ دستگاه‌های دیگرِ پشت مودم، که باید اجاره‌هایی از زیرشبکهٔ B دریافت کنند. این جداسازی برای جلوگیری از کنجکاوی بیش‌ازحد کاربران نهایی و دستکاری مودم‌های کابلی‌شان ضروری است. برای جزئیات در مورد نحوهٔ برپایی محدودیت‌های دسته روی زیرشبکه‌ها، Configuring Subnets With Class Information \%<#\:classification-subnets>\& را ببینید.
.sp
زمانی که زیرشبکه‌ها متعلق به یک شبکهٔ اشتراکی (shared network) باشند، دسته‌بندی بر روی انتخاب زیرشبکه اعمال می‌شود و نه استخرها؛ بدین معنا که اگر استخری که انتظار می‌رود کارخواه‌ها از آن استفاده کنند تمام شود، استخری در یک زیرشبکه که به دستهٔ خاصی محدود شده است همچنان می‌تواند توسط کارخواه‌هایی که عضو آن دسته نیستند استفاده شود. محدودیت دسترسی بر پایهٔ اطلاعات دسته در سطح استخرِ درون یک زیرشبکه نیز در دسترس است: Configuring Pools With Class Information \%<#\:classification-pools>\& را ببینید. این ویژگی برای جداسازی کارخواه‌های متعلق به یک زیرشبکه در محدوده‌های نشانی متفاوت کارآمد است.
.sp
به روشی مشابه، می‌توان یک استخر را با استفاده از دسته‌های داخلی \fBKNOWN\fP یا \fBUNKNOWN\fP محدود کرد تا تنها به کارخواه‌های شناخته‌شده (کارخواه‌هایی که دارای رزرو هستند) سرویس‌دهی کند. نشانی‌ها می‌توانند بدون اختصاص یک نشانی متفاوت به ازای هر رزرو، به کارخواه‌های ثبت‌شده تخصیص یابند: برای نمونه، زمانی که نشانی‌های در دسترس کافی نباشد. تشخیص اینکه آیا رزروی برای یک کارخواه مشخص وجود دارد یا خیر پس از انتخاب زیرشبکه صورت می‌گیرد، بنابراین استفاده از دسته‌های \fBKNOWN\fP/\fBUNKNOWN\fP برای انتخاب یک شبکهٔ اشتراکی یا یک زیرشبکه امکان‌پذیر نیست.
.sp
فرایند دسته‌بندی در پنج گام انجام می‌شود. گام نخست، بررسی بستهٔ ورودی و تخصیص آن به صفر یا چند دسته است. گام دوم، گزینش زیرشبکه است که احتمالاً بر پایهٔ اطلاعات دسته انجام می‌پذیرد. هنگامی که بستهٔ ورودی در دستهٔ ویژهٔ \fBDROP\fP قرار گیرد، دور انداخته می‌شود (drop) و یک پیام اشکال‌زدایی (debug) ثبت می‌گردد. گام بعدی، ارزیابی عبارت‌های دسته وابسته به دسته‌های داخلی \fBKNOWN\fP/\fBUNKNOWN\fP پس از جستجوی رزرو میزبان (host reservation lookup)، استفاده از آن‌ها برای انتخاب استخر و تخصیص دسته‌ها از رزروهای میزبان است. سپس فهرست دسته‌های مورد نیاز ساخته شده و عبارت هر دسته از فهرست ارزیابی می‌شود؛ زمانی که نتیجه \fBtrue\fP باشد، بسته به‌عنوان عضوی از آن دسته افزوده می‌شود. گام پایانی، تخصیص گزینه‌هاست که این مورد نیز می‌تواند بر پایهٔ اطلاعات دسته باشد. اطلاعات کامل‌تر و دقیق‌تر در Client Classification \%<#\:classify>\& در دسترس است.
.sp
دو روش اصلی برای دسته‌بندی وجود دارد. روش نخست خودکار است و بر بررسی مقادیر موجود در گزینه‌های دستهٔ سازنده (vendor class options) یا وجود رزرو میزبان تکیه دارد. اطلاعات از این گزینه‌ها استخراج شده، نام دسته‌ای از آن ساخته می‌شود و به فهرست دسته‌های بسته افزوده می‌گردد. روش دوم، عبارتی را مشخص می‌کند که برای هر بسته ارزیابی می‌شود. چنانچه نتیجهٔ ارزیابی \fBtrue\fP باشد، بسته عضوی از آن دسته خواهد بود.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
پرچم پارامتر سراسری جدید \fBearly\-global\-reservations\-lookup\fP، امکان جستجو برای رزروهای سراسری را پیش از مرحلهٔ انتخاب زیرشبکه فعال می‌سازد. این جستجو شبیه به جستجوی عمومی شرح‌داده‌شده در بالا است، با دو تفاوت:
.INDENT 0.0
.IP \(bu 2
جستجو محدود به رزروهای سراسری میزبان است
.IP \(bu 2
دستهٔ \fBUNKNOWN\fP هرگز تنظیم نمی‌شود
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
در دسته‌بندی کارخواه‌ها باید دقت عمل به خرج داد، زیرا کارخواه‌هایی که معیارهای دسته را برآورده نمی‌کنند به‌سادگی ممکن است از دریافت هرگونه سرویسی محروم شوند.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
نسخهٔ 3.1.7 برنامهٔ Kea یک دستهٔ ویژهٔ دیگر به نام \fBREJECT\fP اضافه کرد که عملکردی مشابه دستهٔ \fBDROP\fP دارد، اما به‌جای نادیده گرفتن و دور انداختن کامل پرس‌وجوی ورودی، بخش تخصیص اجاره را رد می‌کند؛ بنابراین هیچ پاسخ DHCPOFFER در پاسخ به پرس‌وجوی DHCPDISCOVER ارسال نمی‌شود، و پاسخ به پرس‌وجوی DHCPREQUEST باید یک DHCPNAK باشد.
.UNINDENT
.UNINDENT.SS تنظیم فیلدهای ثابت در رده‌بندی
.sp
این امکان وجود دارد که مشخص شود کلاینت‌های متعلق به یک رده‌ی خاص، بسته‌هایی با مقادیر مشخص در فیلدهای ثابتِ معینی دریافت کنند. به‌طور خاص، سه فیلد ثابت پشتیبانی می‌شوند: \fBnext\-server\fP (حاوی یک آدرس IPv4 است که در فیلد \fBsiaddr\fP تنظیم می‌شود)، \fBserver\-hostname\fP (حاوی نام میزبان سرور است، می‌تواند تا ۶۴ بایت طول داشته باشد و در فیلد \fBsname\fP ارسال می‌شود) و \fBboot\-file\-name\fP (حاوی فایل پیکربندی است، می‌تواند تا ۱۲۸ بایت طول داشته باشد و با استفاده از فیلد \fBfile\fP ارسال می‌شود).
.sp
بدیهی است که راه‌های زیادی برای تخصیص کلاینت‌ها به رده‌های خاص وجود دارد، اما برای کلاینت‌های PXE، گزینه نوع معماری کلاینت (کد ۹۳) به‌طور ویژه‌ای برای ایجاد این تمایز مناسب به نظر می‌رسد. مثال زیر بررسی می‌کند که آیا کلاینت خود را به عنوان یک دستگاه PXE با معماری EFI x86\-64 معرفی می‌کند یا خیر، و در صورت تطابق، چندین فیلد را تنظیم می‌کند. برای مقادیر خاص، بخش 2.1 از RFC 4578 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc4578#\:section-2.1> اصلاح‌شده توسط بخش خطاهای آن (errata) یا مستندات کلاینت را ببینید.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqclient\-classes\(dq: [
        {
            \(dqname\(dq: \(dqipxe_efi_x64\(dq,
            \(dqtest\(dq: \(dqoption[93].hex == 0x0007\(dq,
            \(dqnext\-server\(dq: \(dq192.0.2.254\(dq,
            \(dqserver\-hostname\(dq: \(dqhal9000\(dq,
            \(dqboot\-file\-name\(dq: \(dq/dev/null\(dq
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر یک بسته ورودی با چندین رده مطابقت داشته باشد، مقدار استفاده‌شده برای هر فیلد از اولین رده‌ای خواهد آمد که آن فیلد را مشخص کرده است، بر اساس ترتیبی که رده‌ها به بسته تخصیص داده شده‌اند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
ترتیب رده‌ها همان‌گونه است که در پیکربندی مشخص شده است.
.UNINDENT
.UNINDENT
.SS استفاده از اطلاعات رده سازنده در رده‌بندی
.sp
سرور بررسی می‌کند که آیا بسته ورودی شامل گزینه شناسه رده سازنده (۶۰) است یا خیر. در صورت وجود، پیشوند \fBVENDOR_CLASS_\fP به محتوای آن گزینه اضافه شده و به عنوان یک رده تفسیر می‌شود. به عنوان مثال، مودم‌های کابلی مدرن این گزینه را با مقدار \fBdocsis3.0\fP ارسال می‌کنند، بنابراین بسته متعلق به رده \fBVENDOR_CLASS_docsis3.0\fP\& خواهد بود.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
اقدامات خاصی برای کلاینت‌های موجود در \fBVENDOR_CLASS_docsis3.0\fP را می‌توان با تعریف \fBVENDOR_CLASS_docsis3.0\fP و تنظیم مناسب مقادیر \fBnext\-server\fP و \fBboot\-file\-name\fP آن انجام داد.
.UNINDENT
.UNINDENT
.sp
این مثال پیکربندی‌ای را با استفاده از یک رده \fBVENDOR_CLASS_\fP که به‌صورت خودکار تولید شده نشان می‌دهد. مدیر شبکه تصمیم گرفته است که آدرس‌های محدوده 192.0.2.10 تا 192.0.2.20 توسط سرور Dhcp4 مدیریت شوند و تنها کلاینت‌های متعلق به رده کلاینت DOCSIS 3.0 مجاز به استفاده از این استخر (pool) باشند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqsubnet4\(dq: [
        {
            \(dqid\(dq: 1,
            \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
            \(dqpools\(dq: [ { \(dqpool\(dq: \(dq192.0.2.10 \- 192.0.2.20\(dq } ],
            \(dqclient\-classes\(dq: [ \(dqVENDOR_CLASS_docsis3.0\(dq ]
        }
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.SS تعریف و استفاده از رده‌های سفارشی
.sp
مثال زیر نشان می‌دهد که چگونه یک رده را با استفاده از یک عبارت و یک زیرشبکه (subnet) را با استفاده از آن رده پیکربندی کنید. این پیکربندی رده‌ای به نام \fBClient_foo\fP\& را تعریف می‌کند. این رده شامل همه کلاینت‌هایی است که شناسه کلاینت آن‌ها (گزینه ۶۱) با رشته \fBfoo\fP\& شروع می‌شود. به اعضای این رده آدرس‌هایی از 192.0.2.10 تا 192.0.2.20 اختصاص داده می‌شود و آدرس سرورهای DNS آن‌ها روی 192.0.2.1 و 192.0.2.2 تنظیم می‌گردد.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqclient\-classes\(dq: [
        {
            \(dqname\(dq: \(dqClient_foo\(dq,
            \(dqtest\(dq: \(dqsubstring(option[61].hex,0,3) == \(aqfoo\(aq\(dq,
            \(dqoption\-data\(dq: [
                {
                    \(dqname\(dq: \(dqdomain\-name\-servers\(dq,
                    \(dqcode\(dq: 6,
                    \(dqspace\(dq: \(dqdhcp4\(dq,
                    \(dqcsv\-format\(dq: true,
                    \(dqdata\(dq: \(dq192.0.2.1, 192.0.2.2\(dq
                }
            ]
        },
        ...
    ],
    \(dqsubnet4\(dq: [
        {
            \(dqid\(dq: 1,
            \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
            \(dqpools\(dq: [ { \(dqpool\(dq: \(dq192.0.2.10 \- 192.0.2.20\(dq } ],
            \(dqclient\-classes\(dq: [ \(dqClient_foo\(dq ]
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT.SS "دسته‌بندی تکمیلی (Additional Classification)"
.sp
در برخی موارد، محدود کردن دامنه (scope) یک کلاس به یک pool، subnet یا shared network سودمند است. دو پارامتر وجود دارند که برای محدود کردن دامنه کلاس از طریق هدایت سرور به ارزیابی عبارت‌های آزمون (test expressions) در زمان نیاز، به کار می‌روند.
.sp
پارامتر \fBevaluate\-additional\-classes\fP که فهرستی از نام‌های کلاس را می‌پذیرد و در دامنه pool، subnet و shared network معتبر است. کلاس‌های موجود در این فهرست‌ها به عنوان تکمیلی (additional) علامت‌گذاری شده و پس از انتخاب آن pool/subnet/shared network خاص و پیش از پردازش گزینه‌های خروجی (output\-option) ارزیابی می‌شوند.
.sp
مورد دوم پرچم مختص هر کلاس \fBonly\-in\-additional\-list\fP است که به‌طور پیش‌فرض \fBfalse\fP می‌باشد. هنگامی که روی \fBtrue\fP تنظیم شود، عبارت آزمون کلاس در زمان دریافت بسته ورودی ارزیابی نمی‌شود، بلکه دیرتر و تنها در صورتی که کلاس در یک فهرست \fBevaluate\-additional\-classes\fP موجود باشد ارزیابی خواهد شد.
.sp
در این مثال، هنگامی که subnet مشخص‌شده استفاده شود، یک کلاس به بسته ورودی اختصاص می‌یابد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqclient\-classes\(dq: [
       {
           \(dqname\(dq: \(dqClient_foo\(dq,
           \(dqtest\(dq: \(dqmember(\(aqALL\(aq)\(dq,
           \(dqonly\-in\-additional\-list\(dq: true
       },
       ...
    ],
    \(dqsubnet4\(dq: [
        {
            \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
            \(dqpools\(dq: [ { \(dqpool\(dq: \(dq192.0.2.10 \- 192.0.2.20\(dq } ],
            \(dqevaluate\-additional\-classes\(dq: [ \(dqClient_foo\(dq ],
            ...
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
ارزیابی تکمیلی می‌تواند برای بیان وابستگی‌های پیچیده مانند عضویت در subnet استفاده شود. همچنین می‌تواند برای معکوس کردن اولویت‌ها (precedence) به کار رود؛ اگر \fBoption\-data\fP در یک subnet تنظیم شود، نسبت به \fBoption\-data\fP در یک کلاس اولویت دارد. اگر \fBoption\-data\fP به یک کلاس الزامی منتقل شده و در subnet الزامی شود، کلاسی که زودتر ارزیابی شده است ممکن است اولویت یابد.
.sp
ارزیابی تکمیلی در سطوح shared network و pool نیز در دسترس است. ترتیبی که در آن کلاس‌های تکمیلی در نظر گرفته می‌شوند به این صورت است: pool، subnet و shared network؛ یعنی به همان ترتیبی که \fBoption\-data\fP پردازش می‌شود.
.sp
از نسخه 2.7.4 نرم‌افزار Kea، کلاس‌های تکمیلی پیکربندی‌شده بدون عبارت آزمون به‌طور بدون قید و شرط اضافه می‌شوند؛ یعنی در نظر گرفته می‌شود که همیشه به \fBtrue\fP ارزیابی می‌شوند\&.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
از آنجا که ارزیابی تکمیلی پس از تخصیص اجاره (lease assignment) رخ می‌دهد، پارامترهایی که در غیر این صورت بر طول عمر اجاره تأثیر می‌گذاشتند (مانند \fBvalid\-lifetime\fP و \fBoffer\-lifetime\fP)، هنگامی که در کلاسی مشخص شوند که \fBonly\-in\-additional\-list\fP آن نیز روی true تنظیم شده باشد، هیچ اثری نخواهند داشت.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
از نسخه 2.7.4 نرم‌افزار Kea، شناسه‌های \fBonly\-if\-required\fP و \fBrequire\-client\-classes\fP به‌ترتیب به \fBonly\-in\-additional\-list\fP و \fBevaluate\-additional\-classes\fP تغییر نام یافته‌اند. نام‌های اولیه همچنان به‌عنوان ورودی پذیرفته می‌شوند تا به کاربران اجازه مهاجرت داده شود، اما در نهایت رد خواهند شد.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
گزینه‌های Vendor\-Identifying Vendor Options یک حالت خاص هستند: برای سایر گزینه‌ها، یک گزینه بر اساس نقطه کد (code point) خود شناسایی می‌شود، اما \fBvivco\-suboptions\fP (کد 124) و \fBvivso\-suboptions\fP (کد 125) بر اساس جفت نقطه کد و شناسه فروشنده (vendor identifier) شناسایی می‌شوند. این موضوع تأثیر مشهودی بر \fBvivso\-suboptions\fP ندارد، چرا که مقدار آن همان شناسه فروشنده است، اما برای \fBvivco\-suboptions\fP متفاوت است؛ جایی که مقدار، یک رکورد شامل شناسه فروشنده و یک مقدار باینری است. برای نمونه، در:
.UNINDENT
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqoption\-data\(dq: [
       {
           \(dqname\(dq: \(dqvivco\-suboptions\(dq,
           \(dqalways\-send\(dq: true,
           \(dqdata\(dq: \(dq1234, 03666f6f\(dq
       },
       {
           \(dqname\(dq: \(dqvivco\-suboptions\(dq,
           \(dqalways\-send\(dq: true,
           \(dqdata\(dq: \(dq5678, 03626172\(dq
       },
       ...
     ],
     ...
 }
.EE
.UNINDENT
.UNINDENT
.sp
اولین مدخل \fBoption\-data\fP مدخل دوم را پنهان نمی‌کند، زیرا شناسه‌های فروشنده (1234 و 5678) متفاوت هستند: پاسخ‌ها حامل دو نمونه از گزینه \fBvivco\-suboptions\fP خواهند بود که هر کدام مربوط به یک فروشنده متفاوت است..SS "DDNS برای DHCPv4"
.sp
همان‌طور که پیش‌تر ذکر شد، \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> می‌تواند برای ایجاد درخواست‌ها به کارساز DHCP\-DDNS، یعنی \fBkea\-dhcp\-ddns\fP \%<#\:std-iscman-kea-dhcp-ddns>، (که در اینجا از آن با عنوان \(dqD2\(dq یاد می‌شود) جهت به‌روزرسانی مدخل‌های DNS پیکربندی شود. این درخواست‌ها تحت عنوان NameChangeRequests یا NCRها شناخته می‌شوند. هر NCR شامل اطلاعات زیر است:
.INDENT 0.0
.IP 1. 3
آیا درخواستی برای افزودن (به‌روزرسانی) یا حذف مدخل‌های DNS است.
.IP 2. 3
آیا تغییر، درخواست به‌روزرسانی‌های مستقیم DNS (رکوردهای A)، به‌روزرسانی‌های معکوس DNS (رکوردهای PTR) یا هر دو را دارد.
.IP 3. 3
نام دامنه کاملاً مشخص (FQDN)، نشانی اجاره (lease) و DHCID (اطلاعات شناسایی کلاینت مرتبط با FQDN).
.UNINDENT
.sp
پارامترهای مرتبط با DDNS به دو گروه تقسیم می‌شوند:
.INDENT 0.0
.IP 1. 3
پارامترهای اتصال (Connectivity Parameters)
.INDENT 3.0
.INDENT 3.5
این‌ها پارامترهایی هستند که مشخص می‌کنند \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> کجا و چگونه به D2 متصل شده و با آن ارتباط برقرار می‌کند. این پارامترها تنها می‌توانند در بخش سطح‌بالای \fBdhcp\-ddns\fP در پیکربندی \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> مشخص شوند. پارامترهای اتصال در زیر فهرست شده‌اند:
.INDENT 0.0
.IP \(bu 2
\fBenable\-updates\fP
.IP \(bu 2
\fBserver\-ip\fP
.IP \(bu 2
\fBserver\-port\fP
.IP \(bu 2
\fBsender\-ip\fP
.IP \(bu 2
\fBsender\-port\fP
.IP \(bu 2
\fBmax\-queue\-size\fP
.IP \(bu 2
\fBncr\-protocol\fP
.IP \(bu 2
\fBncr\-format\fP
.UNINDENT
.UNINDENT
.UNINDENT
.IP 2. 3
پارامترهای رفتاری (Behavioral Parameters)
.INDENT 3.0
.INDENT 3.5
این پارامترها بر رفتارهایی مانند نحوه مدیریت نام‌های میزبان کلاینت و گزینه‌های FQDN تأثیر می‌گذارند. آن‌ها از بخش \fBdhcp\-ddns\fP خارج شده‌اند تا بتوان آن‌ها را در سطوح global، shared\-network، subnet و/یا pool تعیین کرد. علاوه بر این، آن‌ها به صورت رو به پایین از global به shared\-network به subnet و به pool به ارث می‌رسند. به عبارت دیگر، اگر پارامتری در یک سطح معین مشخص نشده باشد، مقدار آن سطح از سطح بالایی گرفته می‌شود. پارامترهای رفتاری به شرح زیر هستند:
.INDENT 0.0
.IP \(bu 2
\fBddns\-send\-updates\fP
.IP \(bu 2
\fBddns\-override\-no\-update\fP
.IP \(bu 2
\fBddns\-override\-client\-update\fP
.IP \(bu 2
\fBddns\-replace\-client\-name\fP
.IP \(bu 2
\fBddns\-generated\-prefix\fP
.IP \(bu 2
\fBddns\-qualifying\-suffix\fP
.IP \(bu 2
\fBddns\-update\-on\-renew\fP
.IP \(bu 2
\fBddns\-conflict\-resolution\-mode\fP
.IP \(bu 2
\fBddns\-ttl\fP
.IP \(bu 2
\fBddns\-ttl\-percent\fP
.IP \(bu 2
\fBddns\-ttl\-min\fP
.IP \(bu 2
\fBddns\-ttl\-max\fP
.IP \(bu 2
\fBhostname\-char\-set\fP
.IP \(bu 2
\fBhostname\-char\-replacement\fP
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
Kea 2.7.6 پشتیبانی از این پارامترها را به سطح pool اضافه کرد.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
پارامترهای رفتاری که بر FQDN تأثیر می‌گذارند، حتی اگر هر دو پارامتر \fBenable\-updates\fP و \fBddns\-send\-updates\fP برابر \fBfalse\fP باشند نیز اعمال می‌شوند، تا از محیط‌هایی که در آن‌ها کلاینت‌ها خود مسئول به‌روزرسانی‌های DNS خود هستند پشتیبانی شود. این قاعده شامل \fBddns\-replace\-client\-name\fP، \fBddns\-generated\-prefix\fP، \fBddns\-qualifying\-suffix\fP، \fBhostname\-char\-set\fP و \fBhostname\-char\-replacement\fP\& می‌شود.
.UNINDENT
.UNINDENT
.sp
پیکربندی و مقادیر پیش‌فرض به شکل زیر خواهد بود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
     \(dqdhcp\-ddns\(dq: {
         // Connectivity parameters
         \(dqenable\-updates\(dq: false,
         \(dqserver\-ip\(dq: \(dq127.0.0.1\(dq,
         \(dqserver\-port\(dq:53001,
         \(dqsender\-ip\(dq:\(dq\(dq,
         \(dqsender\-port\(dq:0,
         \(dqmax\-queue\-size\(dq:1024,
         \(dqncr\-protocol\(dq:\(dqUDP\(dq,
         \(dqncr\-format\(dq:\(dqJSON\(dq
     },

     // Behavioral parameters (global)
     \(dqddns\-send\-updates\(dq: true,
     \(dqddns\-override\-no\-update\(dq: false,
     \(dqddns\-override\-client\-update\(dq: false,
     \(dqddns\-replace\-client\-name\(dq: \(dqnever\(dq,
     \(dqddns\-generated\-prefix\(dq: \(dqmyhost\(dq,
     \(dqddns\-qualifying\-suffix\(dq: \(dq\(dq,
     \(dqddns\-update\-on\-renew\(dq: false,
     \(dqddns\-conflict\-resolution\-mode\(dq: \(dqcheck\-with\-dhcid\(dq,
     \(dqhostname\-char\-set\(dq: \(dq[^A\-Za\-z0\-9.\-]\(dq,
     \(dqhostname\-char\-replacement\(dq: \(dqx\(dq,
     ...
}
.EE
.UNINDENT
.UNINDENT
.sp
دو پارامتر وجود دارند که تعیین می‌کنند آیا \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> می‌تواند درخواست‌های DDNS را به D2 ارسال کند یا خیر: پارامتر موجود \fBdhcp\-ddns:enable\-updates\fP که اکنون تنها کنترل می‌کند آیا \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> به D2 متصل شود یا خیر؛ و پارامتر رفتاری جدید، \fBddns\-send\-updates\fP، که مشخص می‌کند آیا به‌روزرسانی‌های DDNS در یک سطح مشخص (مانند global، shared\-network یا subnet) فعال هستند یا خیر. جدول زیر نحوه عملکرد هم‌زمان این دو پارامتر را نشان می‌دهد:.SS فعال‌سازی و غیرفعال‌سازی به‌روزرسانی‌های DDNS
.TS
box center;
l|l|l.
T{
dhcp\-ddns:
enable\-updates
T}	T{
سراسری
ddns\-send\-updates
T}	T{
نتیجه
T}
_
T{
false (پیش‌فرض)
T}	T{
false
T}	T{
عدم به‌روزرسانی در هیچ حوزه‌ای
T}
_
T{
false
T}	T{
true (پیش‌فرض)
T}	T{
عدم به‌روزرسانی در هیچ حوزه‌ای
T}
_
T{
true
T}	T{
false
T}	T{
به‌روزرسانی تنها در حوزه‌هایی با
مقدار محلی \fBtrue\fP برای
\fBddns\-enable\-updates\fP
T}
_
T{
true
T}	T{
true
T}	T{
به‌روزرسانی در تمام حوزه‌ها به جز مواردی
با مقدار محلی \fBfalse\fP
برای \fBddns\-enable\-updates\fP
T}
.TE
.sp
در Kea 1.9.1 دو پارامتر جدید اضافه شد؛ نخستین مورد \fBddns\-update\-on\-renew\fP است\&.
به‌طور معمول، هنگام تمدید اجاره‌ها، کارساز تنها در صورتی DNS را به‌روزرسانی می‌کند که
اطلاعات DNS مربوط به اجاره (مانند FQDN یا پرچم‌های جهت به‌روزرسانی DNS) تغییر کرده باشد.
تنظیم \fBddns\-update\-on\-renew\fP روی \fBtrue\fP به کارساز دستور می‌دهد هنگام تمدید اجاره
همواره اطلاعات DNS را به‌روز کند، حتی اگر اطلاعات DNS آن تغییر نکرده باشد.
این ویژگی به Kea امکان می‌دهد در صورتی که پیش‌تر نتوانسته ورودی‌های DNS را اضافه کند یا
آن‌ها به نحوی توسط کارساز DNS از دست رفته باشند، «خودترمیمی» (\(dqself\-heal\(dq) کند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
تنظیم \fBddns\-update\-on\-renew\fP روی \fBtrue\fP ممکن است بر کارایی تأثیر منفی بگذارد،
به‌ویژه برای کارسازهایی با کلاینت‌های متعدد که مکرراً تمدید انجام می‌دهند.
.UNINDENT
.UNINDENT
.sp
دومین پارامتر اضافه‌شده در Kea 1.9.1 پارامتر \fBddns\-use\-conflict\-resolution\fP است\&.
این پارامتر بولی به D2 فرستاده می‌شد و حل تداخل را طبق توصیفات
RFC 4703 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc4703> فعال یا غیرفعال می‌کرد\&.
از Kea 2.5.0 به بعد، این پارامتر منسوخ شده و با \fBddns\-conflict\-resolution\-mode\fP جایگزین
شده است که چهار حالت رفتاری مرتبط با حل تداخل را ارائه می‌دهد:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
\fBcheck\-with\-dhcid\fP \- این حالت (پیش‌فرض)، به D2 دستور می‌دهد تا حل تداخل منطبق با
RFC 4703 را انجام دهد. ورودی‌های موجود DNS تنها در صورتی ممکن است بازنویسی شوند که
دارای رکورد DHCID باشند و با DHCID کلاینت مطابقت داشته باشد.
این معادل \fBddns\-use\-conflict\-resolution\fP: \fBtrue\fP است؛
.IP \(bu 2
\fBno\-check\-with\-dhcid\fP \- ورودی‌های موجود DNS می‌توانند توسط هر کلاینتی بازنویسی شوند،
فارغ از اینکه آن ورودی‌ها شامل رکورد DHCID باشند یا خیر. ورودی‌های جدید
شامل رکورد DHCID برای کلاینتی خواهند بود که به آن تعلق دارند.
این معادل \fBddns\-use\-conflict\-resolution\fP: \fBfalse\fP است؛
.IP \(bu 2
\fBcheck\-exists\-with\-dhcid\fP \- ورودی‌های موجود DNS تنها در صورتی بازنویسی می‌شوند
که دارای رکورد DHCID باشند. لزومی ندارد رکورد DHCID با DHCID کلاینت مطابقت داشته باشد.
این حالت راهکاری برای محافظت از ورودی‌های ایستا DNS (آن‌هایی که رکورد DHCID ندارند) فراهم
می‌کند در حالی که اجازه می‌دهد ورودی‌های پویا (آن‌هایی که دارای رکورد DHCID هستند) توسط هر
کلاینتی بازنویسی شوند. این رفتار پیش از Kea 2.4.0 پشتیبانی نمی‌شد.
.IP \(bu 2
\fBno\-check\-without\-dhcid\fP \- ورودی‌های موجود DNS می‌توانند توسط هر کلاینتی بازنویسی شوند؛
ورودی‌های جدید شامل رکوردهای DHCID نخواهند بود. این رفتار پیش از Kea 2.4.0 پشتیبانی نمی‌شد.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
برای سازگاری رو به عقب، \fBddns\-use\-conflict\-resolution\fP همچنان در پیکربندی JSON پذیرفته می‌شود.
کارساز این مقدار را در درون خود با \fBddns\-conflict\-resolution\-mode\fP و مقدار مناسب جایگزین می‌کند:
\fBcheck\-with\-dhcid\fP برای \fBtrue\fP و \fBno\-check\-with\-dhcid\fP برای \fBfalse\fP\&.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
تنظیم \fBddns\-conflict\-resolution\-mode\fP روی هر مقداری غیر از
\fBcheck\-with\-dhcid\fP، تدابیر حفاظتی بازنویسی را که قواعد حل تداخل (برگرفته از
RFC 4703 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc4703>) به‌منظور جلوگیری
از آن‌ها تعبیه شده‌اند، غیرفعال می‌کند. این بدان معناست که ورودی‌های موجود برای یک FQDN
یا یک نشانی IP که برای Client\-A ایجاد شده‌اند، می‌توانند توسط ورودی‌های Client\-B حذف یا
جایگزین شوند. علاوه بر این، دو سناریو وجود دارد که طی آن‌ها ورودی‌های چند کلاینت برای یک کلید
یکسان (مانند FQDN یا IP) ایجاد می‌شود:
.sp
۱. کلاینت Client\-B از همان FQDN مربوط به Client\-A ولی یک نشانی IP متفاوت استفاده کند.
در این حالت، ورودی‌های رو به جلو DNS (رکوردهای منبع A و DHCID) برای Client\-A حذف خواهند شد
چون با FQDN مطابقت دارند، و ورودی‌های جدید برای Client\-B اضافه خواهند شد. با این حال، ورودی‌های
معکوس DNS (رکوردهای منبع PTR و DHCID) برای Client\-A حذف نخواهند شد زیرا به نشانی IP متفاوتی
تعلق دارند، در حالی که ورودی‌های جدید برای Client\-B همچنان افزوده خواهند شد.
.sp
۲. کلاینت Client\-B از همان نشانی IP مربوط به Client\-A ولی یک FQDN متفاوت استفاده کند.
در این حالت، ورودی‌های معکوس DNS (رکوردهای منبع PTR و DHCID) برای Client\-A حذف خواهند شد
چون با نشانی IP مطابقت دارند، و ورودی‌های جدید برای Client\-B اضافه خواهند شد. اما ورودی‌های
رو به جلو DNS (رکوردهای منبع A و DHCID) برای Client\-A حذف نخواهند شد، زیرا به یک FQDN متفاوت
تعلق دارند، در حالی که ورودی‌های جدید برای Client\-B همچنان افزوده خواهند شد.
.sp
غیرفعال‌سازی حل تداخل تنها باید پس از بررسی دقیق موارد کاربرد خاص انجام گیرد. بهترین راه برای
جلوگیری از ورودی‌های ناخواسته DNS این است که همیشه اطمینان حاصل شود پیش از تخصیص مجدد FQDNها
یا نشانی‌های IP، تغییرات اجاره‌ها از طریق Kea پردازش شوند؛ چه آزاد شوند، چه منقضی گردند یا از طریق
دستور \fBlease4\-del\fP \%<#\:std-isccmd-lease4-del> حذف شوند. انجام این کار باعث می‌شود
\fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> درخواست‌های حذف DNS را به D2 ارسال کند.
.UNINDENT
.UNINDENT
.sp
ورودی‌های DNS که Kea می‌سازد حاوی مقداری برای TTL (طول عمر) هستند.
به‌طور پیش‌فرض، کارساز \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> این مقدار را بر اساس
RFC 4702، بخش ۵ \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc4702#\:section-5>
محاسبه می‌کند که پیشنهاد می‌دهد مقدار TTL برابر ۱/۳ طول عمر اجاره با حداقل مقدار ۱۰ دقیقه
باشد. چهار پارامتر اختیاری وجود دارند که می‌توان از آن‌ها برای تأثیرگذاری بر محاسبه TTL استفاده کرد:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
\fBddns\-ttl\fP \- در صورت تعیین و بزرگ‌تر بودن از ۰، بدون قید و شرط به عنوان مقدار TTL
استفاده می‌شود. این مقدار بر حسب ثانیه مشخص می‌شود. به‌طور پیش‌فرض نامشخص است.
.IP \(bu 2
\fBddns\-ttl\-percent\fP \- در صورت تعیین و بزرگ‌تر بودن از صفر، به عنوان درصد طول عمر اجاره
استفاده می‌شود، در غیر این صورت از ۱/۳ (طبق RFC 4702) طول عمر اجاره استفاده خواهد شد.
این پارامتر به عنوان یک درصد اعشاری (مانند 0.75، 0.50) مشخص می‌شود و به‌طور پیش‌فرض نامشخص است.
.IP \(bu 2
\fBddns\-ttl\-min\fP \- در صورت تعیین و بزرگ‌تر بودن از ۰، به عنوان حداقل مقدار استفاده می‌شود؛
در غیر این صورت حداقل ۶۰۰ ثانیه (طبق RFC 4702) به کار می‌رود. اگر TTL محاسبه‌شده کمتر از مقدار
حداقل باشد، حداقل بازگردانده می‌شود. این پارامتر بر حسب ثانیه مشخص می‌شود. به‌طور پیش‌فرض نامشخص است.
.IP \(bu 2
\fBddns\-ttl\-max\fP \- در صورت تعیین و بزرگ‌تر بودن از صفر، مقدار محاسبه‌شده TTL را به
مقدار آن محدود می‌کند. این مقدار بر حسب ثانیه مشخص می‌شود. به‌طور پیش‌فرض نامشخص است.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
مقدار صفر برای هر یک از پارامترهای TTL می‌تواند برای باطل کردن (یعنی «نامشخص کردن» یا \(dqunspecify\(dq)
مقدار آن پارامتر که از یک حوزه بالاتر به ارث رسیده است، استفاده شود.
.UNINDENT
.UNINDENT.SS اتصال به سرور DHCP\-DDNS
.sp
برای اینکه NCRها به سرور D2 برسند، \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> باید قادر به برقراری ارتباط با آن باشد. \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> از پارامترهای پیکربندی زیر برای کنترل این ارتباط استفاده می‌کند:
.INDENT 0.0
.IP \(bu 2
\fBenable\-updates\fP \- اتصال به \fBkea\-dhcp\-ddns\fP \%<#\:std-iscman-kea-dhcp-ddns> را فعال می‌کند تا به‌روزرسانی‌های DDNS ساخته و ارسال شوند.
برای اینکه NCRها تولید و به D2 فرستاده شوند، این مقدار باید \fBtrue\fP باشد.
مقدار پیش‌فرض آن \fBfalse\fP است\&.
.IP \(bu 2
\fBserver\-ip\fP \- این آدرس IP است که D2 روی آن به درخواست‌ها گوش می‌دهد. مقدار پیش‌فرض رابط محلی لوپ‌بک با آدرس 127.0.0.1 است.
می‌توان هر یک از آدرس‌های IPv4 یا IPv6 را مشخص کرد.
.IP \(bu 2
\fBserver\-port\fP \- این پورتی است که D2 روی آن به درخواست‌ها گوش می‌دهد. مقدار پیش‌فرض \fB53001\fP است\&.
.IP \(bu 2
\fBsender\-ip\fP \- این آدرس IP است که \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> برای ارسال درخواست‌ها به D2 از آن استفاده می‌کند. مقدار پیش‌فرض خالی است، که به \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> دستور می‌دهد یک آدرس مناسب را انتخاب کند.
.IP \(bu 2
\fBsender\-port\fP \- این پورتی است که \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> برای ارسال درخواست‌ها به D2 از آن استفاده می‌کند.
مقدار پیش‌فرض \fB0\fP به \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> دستور می‌دهد یک پورت مناسب را انتخاب نماید.
.IP \(bu 2
\fBmax\-queue\-size\fP \- این حداکثر تعداد درخواست‌های مجاز برای قرارگیری در صف هنگام انتظار برای ارسال به D2 است. این مقدار از انباشت مهارنشدنی درخواست‌ها در صورتی که سریع‌تر از توان تحویل تولید شوند، جلوگیری می‌کند. اگر تعداد درخواست‌های در صف برای مخابره به این مقدار برسد، به‌روزرسانی DDNS غیرفعال می‌شود تا زمانی که تراکم صف به اندازه کافی کاهش یابد. هدف این است که به سرور \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> اجازه داده شود بدون پذیرش ریسک رشد نامحدود حافظه، به عملیات اجاره (lease) ادامه دهد. مقدار پیش‌فرض \fB1024\fP است\&.
.IP \(bu 2
\fBncr\-protocol\fP \- پروتکل سوکت مورد استفاده هنگام ارسال درخواست‌ها به D2 را مشخص می‌کند. در حال حاضر فقط UDP پشتیبانی می‌شود.
.IP \(bu 2
\fBncr\-format\fP \- قالب بسته (packet format) برای ارسال درخواست‌ها به D2 را مشخص می‌کند. در حال حاضر فقط قالب JSON پشتیبانی می‌شود.
.UNINDENT
.sp
به‌طور پیش‌فرض، فرض می‌شود که \fBkea\-dhcp\-ddns\fP \%<#\:std-iscman-kea-dhcp-ddns> روی همان ماشینی اجرا می‌شود که \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> روی آن فعال است، و تمام مقادیر پیش‌فرض ذکرشده در بالا باید کافی باشند. با این حال، اگر D2 به گونه‌ای پیکربندی شده باشد که روی آدرس یا پورت دیگری گوش دهد، این مقادیر باید بر همین اساس تغییر یابند. برای مثال، اگر D2 برای گوش دادن روی آدرس 192.168.1.10 و پورت 900 پیکربندی شده باشد، پیکربندی زیر الزامی است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqdhcp\-ddns\(dq: {
        \(dqserver\-ip\(dq: \(dq192.168.1.10\(dq,
        \(dqserver\-port\(dq: 900,
        ...
    },
    ...
}
.EE
.UNINDENT
.UNINDENT
.SS چه زمانی سرور \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> یک درخواست DDNS ایجاد می‌کند؟
.sp
سرور \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> از رفتار مقررشده برای سرورهای DHCP در RFC 4702 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc4702>\& پیروی می‌کند. توجه به این نکته مهم است که \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> تصمیم اولیه مبنی بر زمان و مواردی که باید به‌روزرسانی شوند را اتخاذ می‌کند و آن اطلاعات را در قالب NCRها به D2 می‌فرستد. انجام به‌روزرسانی‌های واقعی DNS و رسیدگی به مسائلی همچون حل تعارض (conflict resolution) در حیطه وظایف خود D2 است (بخش The DHCP\-DDNS Server \%<#\:dhcp-ddns-server> را ببینید). این بخش توضیح می‌دهد که \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> چه زمانی NCRها را ایجاد می‌کند و از چه پارامترهای پیکربندی می‌توان برای تأثیرگذاری بر این تصمیم استفاده نمود. فرض این بخش بر این است که هم پارامتر اتصال \fBenable\-updates\fP و هم پارامتر رفتاری \fBddns\-send\-updates\fP روی \fBtrue\fP تنظیم شده‌اند\&.
.sp
به‌طور کلی، \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> درخواست‌های به‌روزرسانی DDNS را در مواقع زیر ایجاد می‌کند:
.INDENT 0.0
.IP 1. 3
یک اجاره جدید در پاسخ به یک DHCPREQUEST اعطا شود؛
.IP 2. 3
یک اجاره موجود تمدید شود اما FQDN مرتبط با آن تغییر کرده باشد؛ یا
.IP 3. 3
یک اجاره موجود در پاسخ به یک DHCPRELEASE آزاد شود.
.UNINDENT
.sp
در حالت دوم (تمدید اجاره)، دو درخواست DDNS صادر می‌شود: یک درخواست برای حذف ورودی‌های مربوط به FQDN قبلی، و درخواست دوم برای افزودن ورودی‌های FQDN جدید. در حالت سوم (آزادسازی اجاره)، یک درخواست DDNS تکی برای حذف ورودی‌های آن ارسال می‌شود.
.sp
اما در مورد حالت اول، تصمیمات مرتبط با اعطای اجاره جدید پیچیده‌تر است. هنگامی که یک اجاره جدید اعطا می‌شود، چنانچه DHCPREQUEST شامل گزینه FQDN (کد 81) یا گزینه Host Name (کد 12) باشد، \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> یک درخواست به‌روزرسانی DDNS ایجاد می‌کند. اگر هر دو گزینه موجود باشند، سرور از گزینه FQDN استفاده می‌کند.
به‌طور پیش‌فرض، \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> به پرچم‌های N و S مشخص‌شده توسط کلاینت برای FQDN، مطابق با جدول زیر احترام می‌گذارد:
.SS رفتار پیش‌فرض پرچم‌های FQDN
.TS
box center;
l|l|l|l.
T{
پرچم‌های کلاینت:
N\-S
T}	T{
قصد کلاینت
T}	T{
پاسخ سرور
T}	T{
پرچم‌های سرور:
N\-S\-O
T}
_
T{
0\-0
T}	T{
کلاینت می‌خواهد به‌روزرسانی‌های
مستقیم را انجام دهد، سرور باید
به‌روزرسانی‌های معکوس را اعمال کند
T}	T{
سرور فقط درخواست
به‌روزرسانی معکوس
تولید می‌کند
T}	T{
1\-0\-0
T}
_
T{
0\-1
T}	T{
سرور باید هر دو به‌روزرسانی
مستقیم و معکوس را انجام دهد
T}	T{
سرور درخواستی برای
به‌روزرسانی هر دو جهت
تولید می‌کند
T}	T{
0\-1\-0
T}
_
T{
1\-0
T}	T{
کلاینت می‌خواهد هیچ
به‌روزرسانی‌ای انجام نشود
T}	T{
سرور درخواستی تولید
نمی‌کند
T}	T{
1\-0\-0
T}
.TE
.sp
سطر اول در جدول بالا بیانگر \(dqواگذاری به کلاینت (client delegation)\(dq است. در اینجا کلاینت DHCP اعلام می‌کند که قصد دارد به‌روزرسانی‌های مستقیم DNS را خود انجام دهد و سرور باید به‌روزرسانی‌های معکوس را اعمال کند. به‌طور پیش‌فرض، \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> به خواسته کلاینت احترام می‌گذارد و درخواستی برای DDNS به سرور D2 فقط جهت به‌روزرسانی داده‌های معکوس DNS ارسال می‌کند. از پارامتر \fBddns\-override\-client\-update\fP می‌توان برای واداشتن سرور به لغو و نادیده گرفتن درخواست‌های واگذاری به کلاینت استفاده کرد. هنگامی که این پارامتر \fBtrue\fP باشد، \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> درخواست‌های واگذاری به کلاینت را نادیده گرفته و یک درخواست DDNS برای به‌روزرسانی داده‌های مستقیم و معکوس DNS تولید می‌کند. در این حالت، پرچم‌های N\-S\-O در پاسخ سرور به کلاینت به ترتیب 0\-1\-1 خواهند بود.
.sp
(توجه داشته باشید که بر اساس RFC 4702 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc4702>\&، ترکیب پرچم‌های N=1, S=1 ممنوع است. در صورت دریافت چنین ترکیبی از سوی کلاینت، بسته توسط \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> دور انداخته می‌شود\&.)
.sp
برای لغو واگذاری به کلاینت، مقادیر زیر را در فایل پیکربندی تنظیم کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqddns\-override\-client\-update\(dq: true,
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
سطر سوم جدول بالا وضعیتی را توصیف می‌کند که در آن کلاینت درخواست می‌کند هیچ به‌روزرسانی در DNS انجام نشود. از پارامتر \fBddns\-override\-no\-update\fP می‌توان برای واداشتن سرور به نادیده گرفتن خواسته کلاینت استفاده کرد. هنگامی که این پارامتر \fBtrue\fP باشد، \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> حتی اگر کلاینت درخواست عدم به‌روزرسانی داده باشد، درخواست‌های به‌روزرسانی DDNS را به \fBkea\-dhcp\-ddns\fP \%<#\:std-iscman-kea-dhcp-ddns> ارسال می‌کند. پرچم‌های N\-S\-O در پاسخ سرور به کلاینت 0\-1\-1 خواهند بود.
.sp
برای لغو واگذاری به کلاینت، دستورات زیر را اعمال کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqddns\-override\-no\-update\(dq: true,
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
سرور \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> همواره در صورتی که درخواست کلاینت تنها شامل گزینه Host Name باشد، درخواست‌های به‌روزرسانی DDNS را تولید می‌کند. افزون بر این، یک گزینه FQDN را با پرچم‌های FQDN N\-S\-O که به ترتیب روی 0\-1\-0 تنظیم شده‌اند در پاسخ به کلاینت می‌گنجاند. بخش نام دامنه در گزینه FQDN، همان نامی است که در درخواست به‌روزرسانی DDNS به D2 ارسال می‌شود..SS \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> \- تولید نام برای درخواست‌های به‌روزرسانی DDNS
.sp
هر NameChangeRequest مسلماً باید شامل نام دامنه کاملاً واجد شرایط (FQDN) باشد که ورودی‌های DNS آن قرار است تحت تأثیر قرار گیرند. می‌توان \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> را طوری پیکربندی کرد که بر اساس آنچه در DHCPREQUEST از کلاینت دریافت می‌کند، بخشی از آن نام یا تمام آن را فراهم نماید.
.sp
قوانین پیش‌فرض برای ساخت FQDN که برای ورودی‌های DNS استفاده خواهد شد، عبارتند از:
.INDENT 0.0
.IP 1. 3
اگر DHCPREQUEST حاوی گزینه FQDN کلاینت باشد، نام کاندید از آن گرفته می‌شود؛ در غیر این صورت، از گزینه Host Name اخذ خواهد شد.
.IP 2. 3
اگر نام کاندید یک نام جزئی (یعنی کامل‌نشده یا unqualified) باشد، یک پسوند قابل‌پیکربندی به نام اضافه شده و نتیجه به عنوان FQDN استفاده می‌شود.
.IP 3. 3
اگر نام کاندید ارائه‌شده خالی باشد، با استفاده از یک پیشوند و پسوند قابل‌پیکربندی، یک FQDN تولید می‌شود.
.IP 4. 3
اگر کلاینت هیچ‌یک از این دو گزینه را ارائه نکند، هیچ عملیاتی روی DNS انجام نمی‌شود.
.UNINDENT
.sp
این قوانین را می‌توان با تنظیم پارامتر \fBddns\-replace\-client\-name\fP اصلاح کرد، که حالت‌های رفتاری زیر را فراهم می‌کند:
.INDENT 0.0
.IP \(bu 2
\fBnever\fP \- استفاده از نامی که کلاینت ارسال کرده است. اگر کلاینت نامی ارسال نکرد، نامی تولید نشود. این حالت پیش‌فرض است.
.IP \(bu 2
\fBalways\fP \- جایگزین کردن نام ارسالی کلاینت. اگر کلاینت نامی ارسال نکرد، یکی برای کلاینت تولید شود.
.IP \(bu 2
\fBwhen\-present\fP \- جایگزین کردن نام ارسالی کلاینت. اگر کلاینت نامی ارسال نکرد، نامی تولید نشود.
.IP \(bu 2
\fBwhen\-not\-present\fP \- استفاده از نامی که کلاینت ارسال کرده است. اگر کلاینت نامی ارسال نکرد، یکی برای کلاینت تولید شود.
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
در نسخه‌های اولیه Kea، این پارامتر بولی (boolean) بود و تنها مقادیر \fBtrue\fP و \fBfalse\fP\& را می‌پذیرفت. مقادیر بولی منسوخ شده‌اند و دیگر پذیرفته نمی‌شوند. مدیرانی که در حال حاضر از مقادیر بولی استفاده می‌کنند، باید آن‌ها را با نام حالت مورد نظر جایگزین کنند. مقدار \fBtrue\fP به \fBwhen\-present\fP و \fBfalse\fP به \fBnever\fP\& نگاشت می‌شود.
.UNINDENT
.UNINDENT
.sp
برای مثال، جهت هدایت \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> به تولید همیشگی FQDN برای یک کلاینت، پارامتر \fBddns\-replace\-client\-name\fP را مطابق زیر روی \fBalways\fP تنظیم کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqddns\-replace\-client\-name\(dq: \(dqalways\(dq,
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
پیشوندی که در تولید FQDN استفاده می‌شود توسط پارامتر \fBddns\-generated\-prefix\fP مشخص می‌گردد. مقدار پیش‌فرض \(dqmyhost\(dq است. برای تغییر مقدار آن، کافی است آن را روی رشته مورد نظر تنظیم کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqddns\-generated\-prefix\(dq: \(dqanother.host\(dq,
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
پسوندی که هنگام تولید یک FQDN یا هنگام کامل کردن (qualifying) یک نام جزئی استفاده می‌شود، توسط پارامتر \fBddns\-qualifying\-suffix\fP مشخص می‌گردد. اکیداً توصیه می‌شود در صورت فعال بودن به‌روزرسانی‌های DDNS، کاربر مقداری برای این پسوند تعیین کند. به دلایل واضح، نمی‌توان مقدار پیش‌فرض معنی‌داری برای آن ارائه داد.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqddns\-qualifying\-suffix\(dq: \(dqfoo.example.org\(dq,
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
هنگام کامل کردن یک نام جزئی، \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> نام را در این قالب می‌سازد:
.sp
\fB[candidate\-name].[ddns\-qualifying\-suffix].\fP
.sp
که در آن \fBcandidate\-name\fP نام جزئی ارائه‌شده در DHCPREQUEST است. برای مثال، اگر مقدار نام دامنه FQDN برابر \(dqsome\-computer\(dq و مقدار \fBddns\-qualifying\-suffix\fP برابر \(dqexample.com\(dq باشد، FQDN تولیدشده عبارت است از:
.sp
\fBsome\-computer.example.com.\fP
.sp
هنگام تولید کل نام، \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> نام را در این قالب می‌سازد:
.sp
\fB[ddns\-generated\-prefix]\-[address\-text].[ddns\-qualifying\-suffix].\fP
.sp
که در آن \fBaddress\-text\fP صرفاً آدرس IP اجاره است که به یک رشته دارای خط پیوند (hyphenated) تبدیل شده است. برای مثال، اگر آدرس اجاره 172.16.1.10 باشد، پسوند تعیین‌شده \(dqexample.com\(dq بوده، و مقدار پیش‌فرض برای \fBddns\-generated\-prefix\fP استفاده شود، FQDN تولیدشده به صورت زیر خواهد بود:
.sp
\fBmyhost\-172\-16\-1\-10.example.com.\fP
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
هنگامی که کلاینت گزینه host name را ارسال می‌کند، \fBkea\-dhcp4\fP هرگز نقطه‌ای به نام میزبان در گزینه بازگردانده‌شده اضافه نمی‌کند. این نام تنها در صورتی با نقطه پایان می‌یابد که کلاینت آن را از قبل به صورت واجد شرایط و منتهی به نقطه ارسال کرده باشد. هنگامی که کلاینت گزینه FQDN را ارسال می‌کند، FQDN بازگردانده‌شده در پاسخ همیشه با یک نقطه خاتمه می‌یابد.
.UNINDENT
.UNINDENT.SS پاک‌سازی نام میزبان و نام‌های FQDN کلاینت
.sp
برخی کلاینت‌های DHCP ممکن است در گزینهٔ Host Name
(کد گزینهٔ ۱۲) یا گزینهٔ FQDN (کد گزینهٔ ۸۱) مقادیری ارائه دهند که حاوی نویسه‌های
نامطلوب باشد. امکان پیکربندی \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> برای پاک‌سازی این
مقادیر وجود دارد. رایج‌ترین مورد استفاده، اطمینان از این است که تنها نویسه‌های
مجاز در RFC 1035 گنجانده شوند: A\-Z، a\-z، 0\-9، و \(dq\-\(dq. این کار می‌تواند
با استفاده از دو پارامتر زیر انجام شود:
.INDENT 0.0
.IP \(bu 2
\fBhostname\-char\-set\fP \- یک عبارت باقاعده که مجموعه نویسه‌های
نامعتبر را توصیف می‌کند. این می‌تواند هر عبارت باقاعدهٔ معتبری با استفاده از نحو
عبارات باقاعدهٔ گسترش‌یافتهٔ POSIX باشد. نویسه‌های تهی توکار (0x00) همیشه به عنوان
یک نویسهٔ نامعتبر برای جایگزینی (یا حذف) در نظر گرفته می‌شوند.
پیش‌فرض \fB\(dq[^A\-Za\-z0\-9.\-]\(dq\fP\& است. این الگو با هر نویسه‌ای به جز
یک حرف، رقم، نقطه یا خط تیره مطابقت دارد. اکیداً توصیه می‌شود که این پارامتر را
روی یک رشتهٔ خالی (\fB\(dq\(dq\fP) تنظیم نکنید، زیرا این کار اجازه می‌دهد نویسه‌های غیرقابل‌چاپ
در بخش نام میزبان استفاده شوند.
.IP \(bu 2
\fBhostname\-char\-replacement\fP \- رشته‌ای از صفر یا چند نویسه
که هر نویسهٔ نامعتبر در نام میزبان با آن جایگزین می‌شود. یک رشتهٔ خالی
باعث حذف شدن (OMITTED) نویسه‌های نامعتبر به جای جایگزینی آن‌ها می‌شود.
پیش‌فرض \fB\(dq\(dq\fP\& است.
.UNINDENT
.sp
پیکربندی زیر هر چیزی به جز یک حرف،
رقم، نقطه یا خط تیره را با حرف \(dqx\(dq جایگزین می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqhostname\-char\-set\(dq: \(dq[^A\-Za\-z0\-9.\-]\(dq,
    \(dqhostname\-char\-replacement\(dq: \(dqx\(dq,
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
بنابراین، مقدار ارائه‌شده از سوی کلاینت مانند \(dqmyhost\-$[123.org\(dq تبدیل به
\(dqmyhost\-xx123.org\(dq خواهد شد. پاک‌سازی تنها روی بخشی از نام انجام می‌شود که
توسط کلاینت ارائه شده است، و پیش از اعمال یک پسوند توصیف‌کننده (qualifying suffix، در صورت تعریف و نیاز)
انجام می‌پذیرد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
هدف از پاک‌سازی نام، مهار موارد متداول‌تر نویسه‌های نامعتبر
از طریق یک طرح نسبتاً سادهٔ جایگزینی نویسه است.
طراحی طرحی که در تمامی موارد، هم برای گزینهٔ Host Name و هم برای گزینهٔ FQDN
به خوبی کار کند دشوار است.
مدیرانی که متوجه می‌شوند کلاینت‌هایی با حالات خاص و پیچیده از
ترکیب نویسه‌ها دارند که به سادگی با این سازوکار قابل مدیریت نیست،
باید نوشتن یک هوک (hook) را مد نظر قرار دهند که بتواند منطق
به قدر کافی پیچیده‌ای را برای برآوردن نیازهای آن‌ها پیاده‌سازی کند.
.sp
اگر کلاینت‌ها نام‌های دامنه را در گزینهٔ Host Name بگنجانند و مدیر سیستم
بخواهد این‌ها حفظ شوند، باید اطمینان حاصل کند که نقطه، \(dq.\(dq،
توسط عبارت \fBhostname\-char\-set\fP به عنوان یک نویسهٔ معتبر در نظر گرفته شده باشد،
مانند این: \fB\(dq[^A\-Za\-z0\-9.\-]\(dq\fP\&. این امر روی نقطه‌ها در مقادیر
گزینهٔ FQDN تأثیری ندارد.
هنگام پاک‌سازی FQDNها، نقطه‌ها به عنوان جداکننده در نظر گرفته شده و برای تفکیک
مقدار گزینه به برچسب‌های دامنهٔ جداگانه استفاده می‌شوند که پاک‌سازی شده و
سپس مجدداً سرهم می‌گردند.
.sp
اگر کلاینت‌ها مقادیری ارسال می‌کنند که تنها در نویسه‌هایی که توسط
\fBhostname\-char\-set\fP نامعتبر شناخته شده‌اند تفاوت دارند، آگاه باشید که
پاک‌سازی آن‌ها مقادیر یکسانی تولید خواهد کرد. در چنین مواردی، قواعد
تداخل DDNS تنها به یکی از آن‌ها اجازهٔ ثبت نام را خواهد داد.
.sp
در نهایت، با توجه به دامنهٔ اختیاری که کلاینت‌ها در ارسال مقادیر دارند،
عملاً غیرممکن است تضمین کرد که ترکیبی از این دو پارامتر همیشه نامی معتبر
برای استفاده در DNS تولید کند. به عنوان مثال، استفاده از یک مقدار خالی برای
\fBhostname\-char\-replacement\fP می‌تواند منجر به یک برچسب دامنهٔ خالی در یک نام شود،
اگر آن برچسب تنها از نویسه‌های نامعتبر تشکیل شده باشد.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
امکان تعیین \fBhostname\-char\-set\fP
و/یا \fBhostname\-char\-replacement\fP در حوزهٔ سراسری (global scope) وجود دارد.
.sp
کتابخانهٔ هوک کی \fBlibdhcp_ddns_tuning.so\fP \%<#\:std-ischooklib-libdhcp_ddns_tuning\:.so> این امکان را
هم برای \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> و هم برای \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> فراهم می‌کند تا نام‌های میزبان را
به صورت رویه‌ای بر اساس یک عبارت تولید کنند، به‌روزرسانی‌های DDNS را به ازای هر کلاینت نادیده بگیرند،
یا جنبه‌های مختلف به‌روزرسانی DNS را به‌دقت تنظیم نمایند. لطفاً برای گزینه‌های پیکربندی به مستندات
libdhcp_ddns_tuning.so: DDNS Tuning \%<#\:hooks-ddns-tuning>
مراجعه کنید.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
با شروع از Kea 3.1.3، هنگامی که پاک‌سازی منجر به یک رشتهٔ خالی شود،
گزینه (hostname یا FQDN) به گونه‌ای نادیده گرفته خواهد شد که گویی کلاینت آن را ارسال نکرده است.
این حالت زمانی رخ می‌دهد که مقدار ارسال‌شده توسط کلاینت تنها شامل نویسه‌هایی باشد
که توسط عبارت در \(aqhostname\-char\-set\(aq نامعتبر تشخیص داده شده‌اند و
\(aqhostname\-char\-replacement\(aq خالی باشد، \(dq\(dq.
.UNINDENT
.UNINDENT
.SS سرور بعدی (\fBsiaddr\fP)
.sp
در برخی موارد، کلاینت‌ها تمایل دارند پیکربندی را از یک سرور TFTP دریافت کنند.
اگرچه گزینهٔ اختصاصی برای این منظور وجود دارد، اما برخی دستگاه‌ها ممکن است از
فیلد \fBsiaddr\fP در بستهٔ DHCPv4 برای این هدف استفاده کنند. این فیلد خاص
می‌تواند با استفاده از دستورالعمل \fBnext\-server\fP پیکربندی شود. امکان
تعریف آن در حوزهٔ سراسری یا تنها برای یک زیرشبکهٔ مشخص وجود دارد. اگر هر دو
تعریف شده باشند، مقدار زیرشبکه اولویت دارد. مقدار موجود در زیرشبکه می‌تواند
روی \(dq0.0.0.0\(dq تنظیم شود، که به این معنی است که \fBnext\-server\fP نباید ارسال شود.
همچنین می‌تواند روی یک رشتهٔ خالی تنظیم شود، که معادل با تعریف نشدن کامل آن است؛
یعنی از مقدار سراسری استفاده می‌کند.
.sp
دستورالعمل‌های \fBserver\-hostname\fP (که حامل یک نام میزبان سرور است، می‌تواند تا
۶۴ بایت طول داشته باشد، و در فیلد \fBsname\fP قرار دارد) و
\fBboot\-file\-name\fP (که حامل فایل پیکربندی است، می‌تواند تا
۱۲۸ بایت طول داشته باشد، و با استفاده از فیلد \fBfile\fP ارسال می‌شود)
به همان شیوهٔ \fBnext\-server\fP\& مدیریت می‌شوند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqnext\-server\(dq: \(dq192.0.2.123\(dq,
    \(dqboot\-file\-name\(dq: \(dq/dev/null\(dq,
    \(dqsubnet4\(dq: [
        {
            \(dqnext\-server\(dq: \(dq192.0.2.234\(dq,
            \(dqserver\-hostname\(dq: \(dqsome\-name.example.org\(dq,
            \(dqboot\-file\-name\(dq: \(dqbootfile.efi\(dq,
            ...
        }
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT.SS بازتاب Client\-ID (RFC 6842)
.sp
مشخصات اصلی DHCPv4 (سند RFC
2131 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc2131>) بیان می‌کند که سرور
DHCPv4 نباید هنگام پاسخ‌گویی به کلاینت‌ها، گزینه‌های client\-id را بازپس بفرستد.
با این وجود، در برخی موارد این امر باعث سردرگمی کلاینت‌هایی می‌شود که فاقد نشانی
MAC یا client\-id هستند؛ برای جزئیات به RFC
6842 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc6842> مراجعه کنید. این رفتار
با انتشار RFC
6842 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc6842> تغییر کرد، که RFC
2131 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc2131>\& را به‌روزرسانی نمود. آن به‌روزرسانی
بیان می‌کند که اگر کلاینت گزینه client\-id را فرستاده باشد سرور باید آن را بازپس بفرستد، و این رفتار
پیش‌فرض Kea است. با این حال، در بعضی موارد ممکن است دستگاه‌های قدیمی‌تری که از
RFC 6842 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc6842> پشتیبانی نمی‌کنند، از
پذیرش پاسخ‌های حاوی گزینه client\-id خودداری کنند. برای فعال‌سازی سازگاری رو به عقب،
یک پارامتر پیکربندی اختیاری معرفی شده است. برای پیکربندی آن، از عبارت پیکربندی زیر استفاده کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqecho\-client\-id\(dq: false,
    ...
}
.EE
.UNINDENT
.UNINDENT
.SS استفاده از شناسه کلاینت و نشانی سخت‌افزاری
.sp
سرور DHCP باید بتواند کلاینتی را که پیامی از آن دریافت می‌کند شناسایی کرده
و آن را از سایر کلاینت‌ها تمایز دهد. دلایل متعددی برای الزام این شناسایی
وجود دارد که مهم‌ترین آن‌ها عبارت‌اند از:
.INDENT 0.0
.IP \(bu 2
هنگامی که کلاینت برای تخصیص یک اجاره (lease) جدید با سرور ارتباط برقرار می‌کند،
سرور باید اطلاعات شناسایی کلاینت را به عنوان کلید جستجو در پایگاه‌داده اجاره
ذخیره کند.
.IP \(bu 2
هنگامی که کلاینت تلاش می‌کند اجاره موجود را تمدید کند یا آزاد سازد، سرور
باید بتواند با استفاده از اطلاعات شناسایی کلاینت به عنوان یک کلید جستجو،
مدخل اجاره موجود در پایگاه‌داده را برای این کلاینت پیدا کند.
.IP \(bu 2
برخی پیکربندی‌ها از رزروهای ایستا (static reservations) برای نشانی‌های IP و سایر
اطلاعات پیکربندی استفاده می‌کنند. مدیر سرور از اطلاعات شناسایی کلاینت برای ایجاد
این تخصیص‌های ایستا بهره می‌برد.
.IP \(bu 2
در شبکه‌های دوپشته‌ای (dual\-stack) اغلب نیاز است که اطلاعات اجاره ذخیره‌شده
در سرورهای DHCPv4 و DHCPv6 برای یک میزبان مشخص با یکدیگر تطبیق داده شوند.
استفاده از اطلاعات شناسایی مشترک توسط کلاینت‌های DHCPv4 و DHCPv6 به مدیر
شبکه اجازه می‌دهد تا این همبستگی را برقرار ساخته و شبکه را بهتر اداره نماید.
از نگارش 2.1.2 به بعد، Kea از DUIDهای DHCPv6 تعبیه‌شده در گزینه‌های
Client Identifier پروتکل DHCPv4، مطابق با آنچه در
RFC 4361 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc4361>\& تشریح شده، پشتیبانی می‌کند.
.UNINDENT
.sp
پروتکل DHCPv4 از دو شناسه متمایز استفاده می‌کند که توسط کلاینت در پرس‌وجوهای
ارسالی به سرور قرار می‌گیرند و توسط سرور در پاسخ‌های ارسالی به کلاینت کپی می‌شوند:
\fBchaddr\fP و \fBclient\-identifier\fP\&. مورد نخست به عنوان بخشی از مشخصات BOOTP معرفی
شد و همچنین توسط DHCP برای حمل نشانی سخت‌افزاری رابطی که برای ارسال پرس‌وجو به
سرور به کار رفته است (نشانی MAC برای اترنت) استفاده می‌شود. مورد دوم در گزینه
client\-identifier حمل می‌شود که در RFC
2132 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc2132>\& معرفی شده است.
.sp
سند RFC 2131 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc2131> مشخص می‌کند که
سرور می‌تواند از هر دوی این شناسه‌ها برای شناسایی کلاینت استفاده کند، اما در صورت
حضور شناسه کلاینت، بر \fBchaddr\fP اولویت و ارجحیت دارد. یکی از دلایل این امر آن است که
شناسه کلاینت مستقل از سخت‌افزاری است که کلاینت برای برقراری ارتباط با سرور به کار می‌برد.
برای مثال، اگر کلاینت با استفاده از یک کارت شبکه اجاره را دریافت کند و سپس کارت شبکه
به میزبان دیگری منتقل شود، سرور به اشتباه آن میزبان دیگر را همان دریافت‌کننده اجاره
شناسایی خواهد کرد. افزون بر این، سند RFC
4361 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc4361> توصیه می‌کند که هنگام استفاده
از شبکه‌های دوپشته‌ای، از یک DUID (ببینید RFC 9915 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc9915>،
مشخصات DHCPv6) که به عنوان یک شناسه کلاینت حمل می‌شود استفاده گردد تا بدون توجه به نوع
پروتکل مورد استفاده، اطلاعات شناسایی یکپارچه‌ای برای کلاینت ارائه شود. Kea به این
مشخصات پایبند است، و شناسه کلاینت به طور پیش‌فرض هنگام جستجو، ایجاد، به‌روزرسانی یا
حذف اجاره کلاینت توسط سرور، بر مقدار موجود در فیلد \fBchaddr\fP اولویت دارد.
.sp
هنگامی که سرور یک پیام DHCPDISCOVER یا DHCPREQUEST از کلاینت دریافت می‌کند، سعی می‌کند
بررسی کند که آیا کلاینت از پیش اجاره‌ای در پایگاه‌داده دارد یا خیر؛ در صورتی که داشته باشد، سرور
به جای تخصیص اجاره‌ای نو، همان اجاره را واگذار می‌کند. هر اجاره در پایگاه‌داده اجاره‌ها
با شناسه کلاینت و/یا \fBchaddr\fP مرتبط است. سرور ابتدا از شناسه کلاینت (در صورت وجود)
برای جستجوی اجاره استفاده می‌کند؛ اگر موردی یافت شود، سرور این اجاره را متعلق به کلاینت
در نظر می‌گیرد، حتی اگر \fBchaddr\fP کنونی و \fBchaddr\fP مرتبط با اجاره مطابقت نداشته
باشند. این ویژگی فرایند سناریویی را آسان می‌کند که در آن، کارت شبکه سامانه کلاینت تعویض
شده و در نتیجه نشانی MAC جدیدی در پیام‌های ارسالی کلاینت DHCP ظاهر می‌شود. اگر سرور موفق
به یافتن اجاره با استفاده از شناسه کلاینت نشود، جستجوی دیگری را با استفاده از
\fBchaddr\fP انجام می‌دهد. اگر این جستجو نیز نتیجه‌ای در بر نداشته باشد، کلاینت فاقد
اجاره در نظر گرفته شده و یک اجاره جدید ایجاد می‌شود.
.sp
یک مشکل متداول که توسط گردانندگان شبکه گزارش می‌شود این است که پیاده‌سازی‌های ضعیف
کلاینت‌ها از شناسه‌های کلاینت پایدار استفاده نمی‌کنند و در عوض، با هر بار اتصال کلاینت
به شبکه، یک شناسه کلاینت جدید تولید می‌کنند. مورد شناخته‌شده دیگر این است که کلاینت
شناسه کلاینت خود را در طول فرایند بوت چندمرحله‌ای (PXE) تغییر می‌دهد. در چنین مواردی،
نشانی MAC رابط کلاینت ثابت می‌ماند، و استفاده از فیلد \fBchaddr\fP برای شناسایی کلاینت
تضمین می‌کند که آن سامانه خاص با وجود تغییر یافتن شناسه کلاینتش، به عنوان همان کلاینت
واحد شناخته شود.
.sp
برای رفع این مشکل، Kea شامل یک گزینه پیکربندی است که شناسایی کلاینت را تنها با
استفاده از \fBchaddr\fP امکان‌پذیر می‌سازد. این امر به سرور دستور می‌دهد که در طول
جستجوها و تخصیص‌های اجاره برای یک زیرشبکه خاص، شناسه کلاینت را نادیده بگیرد. پیکربندی
ساده‌شده زیر از سرور را در نظر بگیرید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp4\(dq: {
    \(dqmatch\-client\-id\(dq: true,
    \(dqsubnet4\(dq: [
    {
        \(dqid\(dq: 1,
        \(dqsubnet\(dq: \(dq192.0.10.0/24\(dq,
        \(dqpools\(dq: [ { \(dqpool\(dq: \(dq192.0.2.23\-192.0.2.87\(dq } ],
        \(dqmatch\-client\-id\(dq: false
    },
    {
        \(dqid\(dq: 1,
        \(dqsubnet\(dq: \(dq10.0.0.0/8\(dq,
        \(dqpools\(dq: [ { \(dqpool\(dq: \(dq10.0.0.23\-10.0.2.99\(dq } ]
    }
    ]
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
پارامتر \fBmatch\-client\-id\fP یک مقدار بولی است که این رفتار را کنترل می‌کند. مقدار
پیش‌فرض \fBtrue\fP نشان می‌دهد که سرور از شناسه کلاینت برای جستجوهای اجاره استفاده
می‌کند و اگر جستجوی نخست نتیجه‌ای در بر نداشته باشد به سراغ \fBchaddr\fP می‌رود. مقدار
\fBfalse\fP بدین معناست که سرور تنها از \fBchaddr\fP برای جستجوی اجاره کلاینت استفاده
خواهد کرد. اینکه DHCID برای به‌روزرسانی‌های DNS از شناسه کلاینت تولید شود یا از
\fBchaddr\fP نیز از طریق همین پارامتر کنترل می‌شود.
.sp
پارامتر \fBmatch\-client\-id\fP می‌تواند هم در محدوده پیکربندی سراسری و هم ذیل هر
اعلان زیرشبکه‌ای قرار گیرد. در مثال نشان‌داده‌شده در بالا، مقدار مؤثر \fBmatch\-client\-id\fP
برای زیرشبکه 192.0.10.0/24 برابر با \fBfalse\fP خواهد بود، زیرا تنظیم مختص زیرشبکه این
پارامتر بر مقدار سراسری آن اولویت داشته و آن را بازنویسی می‌کند. مقدار مؤثر \fBmatch\-client\-id\fP
برای زیرشبکه 10.0.0.0/8 برابر با \fBtrue\fP تنظیم خواهد شد، زیرا اعلان زیرشبکه فاقد این
پارامتر است و تنظیم سراسری به طور پیش‌فرض برای این زیرشبکه استفاده می‌شود. در واقع، در
این حالت می‌شد از آوردن مدخل سراسری این پارامتر صرف‌نظر کرد، چرا که \fBtrue\fP مقدار
پیش‌فرض است.
.sp
درک این موضوع حائز اهمیت است که در صورت دریافت اجاره توسط کلاینت تحت یک تنظیم از
\fBmatch\-client\-id\fP و تمدید آن پس از تغییر یافتن این تنظیم، چه اتفاقی رخ می‌دهد. نخست، حالتی
را در نظر بگیرید که کلاینت اجاره را دریافت می‌کند و \fBmatch\-client\-id\fP روی \fBtrue\fP
تنظیم شده است. سرور اطلاعات اجاره را، شامل شناسه کلاینت (در صورت ارائه) و \fBchaddr\fP،
در پایگاه‌داده اجاره ذخیره می‌کند. زمانی که این تنظیم تغییر کند و کلاینت اقدام به تمدید
اجاره نماید، سرور تعیین می‌کند که باید از \fBchaddr\fP برای جستجوی اجاره موجود استفاده کند.
اگر کلاینت نشانی MAC خود را تغییر نداده باشد، سرور باید با موفقیت اجاره موجود را بیابد.
شناسه کلاینت مرتبط با اجاره بازگردانده‌شده نادیده گرفته خواهد شد و به کلاینت اجازه
داده می‌شود تا از این اجاره استفاده کند. هنگام تمدید اجاره، مطابق با تنظیمات جدید سرور،
تنها \fBchaddr\fP برای این اجاره ثبت خواهد شد.
.sp
در حالت دوم، کلاینت دارای اجاره‌ای است که تنها مقدار \fBchaddr\fP برای آن ثبت شده است. هنگامی
که تنظیم \fBmatch\-client\-id\fP به \fBtrue\fP تغییر می‌یابد، سرور ابتدا سعی می‌کند از
شناسه کلاینت برای پیدا کردن اجاره موجود کلاینت استفاده کند. این جستجو هیچ نتیجه‌ای در بر
نخواهد داشت زیرا شناسه کلاینت برای این اجاره ثبت نشده بود. سپس سرور از \fBchaddr\fP استفاده
خواهد کرد و اجاره یافت خواهد شد. اگر به نظر برسد که در اجاره هیچ شناسه کلاینتی ثبت
نشده است، سرور فرض می‌کند که این اجاره متعلق به همین کلاینت است و با تنظیم پیشین
\fBmatch\-client\-id\fP ایجاد شده است. با این حال، اگر اجاره حاوی شناسه کلاینتی باشد که
با شناسه کلاینت استفاده‌شده توسط کلاینت متفاوت است، فرض می‌شود که اجاره به کلاینت
دیگری تعلق دارد و یک اجاره جدید تخصیص داده خواهد شد.
.sp
برای نمای بصری‌تری از چگونگی بازشناسی کلاینت یکسان توسط Kea، لطفاً به بخش
How Kea Recognizes the Same Client In Different DHCP Messages \%<#\:uml-recognizing-same-client>\&
مراجعه فرمایید..SS رفتار کارگزار مقتدر DHCPv4
.sp
مشخصات اصلی DHCPv4 (RFC
2131 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc2131>) بیان می‌کند که اگر یک کلاینت
در وضعیت INIT\-REBOOT آدرسی را درخواست کند که کارگزار شناختی از آن ندارد،
کارگزار باید پاسخی ندهد (سکوت کند)، مگر اینکه کارگزار بداند کلاینت یک آدرس IP
از شبکه اشتباه درخواست کرده است. به‌طور پیش‌فرض، Kea به جای این مشخصات،
از رفتار دیمن ISC \fBdhcpd\fP پیروی می‌کند و در صورتی هم که کلاینت آدرس IP از شبکه
اشتباه درخواست کند پاسخی نمی‌دهد، زیرا مشخص نیست که اطلاعات پیکربندی یک بخش
شبکه (سگمنت) مشخص حتماً صحیح باشد. Kea تنها در صورتی درخواست DHCPREQUEST
کلاینت را با یک پیام DHCPNAK رد می‌کند که از قبل اجاره‌ای (lease) برای آن کلاینت
با یک آدرس IP متفاوت داشته باشد. مدیران سیستم می‌توانند با استفاده از تنظیم
بولی \fBauthoritative\fP (به‌طور پیش‌فرض \fBfalse\fP) این رفتار را تغییر دهند.
.sp
در حالت مقتدر، زمانی که \fBauthoritative\fP روی \fBtrue\fP تنظیم شده باشد، Kea
همواره درخواست‌های INIT\-REBOOT کلاینت‌های ناشناس را با پیام‌های DHCPNAK رد می‌کند.
تنظیم \fBauthoritative\fP می‌تواند در حوزه پیکربندی سراسری (global)، شبکه اشتراکی
(shared\-network) و زیرشبکه (subnet) مشخص شود و در صورت عدم تعیین، به‌طور خودکار
از حوزه والد به ارث برده می‌شود. تمام زیرشبکه‌ها در یک shared\-network باید تنظیم
\fBauthoritative\fP یکسانی داشته باشند.
.SS DHCPv4\-over\-DHCPv6: سمت DHCPv4
.sp
پشتیبانی از انتقال DHCPv4\-over\-DHCPv6 در RFC
7341 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc7341> شرح داده شده است و با استفاده
از همکاری کارگزارهای DHCPv4 و DHCPv6 پیاده‌سازی می‌شود. این بخش به
پیکربندی سمت DHCPv4 می‌پردازد (سمت DHCPv6 در بخش
DHCPv4\-over\-DHCPv6: سمت DHCPv6 \%<#\:dhcp6-dhcp4o6-config> شرح داده شده است).
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
جزئیات ارتباط بین‌پردازشی در DHCPv4\-over\-DHCPv6 ممکن است تغییر کند؛
برای نمونه، پشتیبانی از رله پورت (RFC 8357) تغییری ناسازگار ایجاد کرد.
هر دو سمت DHCPv4 و DHCPv6 باید از نسخه یکسانی از Kea استفاده کنند.
.UNINDENT
.UNINDENT
.sp
پارامتر سراسری \fBdhcp4o6\-port\fP نخستین پورت از دو پورت متوالی سوکت‌های UDP
مورد استفاده برای ارتباط میان کارگزارهای DHCPv6 و DHCPv4 را مشخص می‌کند.
کارگزار DHCPv4 روی ::1 در \fBport\fP + 1 متصل (bound) شده و به ::1 در
\fBport\fP متصل می‌شود.
.sp
در DHCPv4\-over\-DHCPv6، کارگزار DHCPv4 به چندین شناسه که به‌طور معمول
برای انتخاب زیرشبکه استفاده می‌کرد دسترسی ندارد. برای رفع این مشکل،
سه مدخل پیکربندی جدید فراهم شده است؛ وجود هر یک از این‌ها به زیرشبکه
اجازه می‌دهد با DHCPv4\-over\-DHCPv6 استفاده شود. این مدخل‌ها عبارتند از:
.INDENT 0.0
.IP \(bu 2
\fB4o6\-subnet\fP: یک پیشوند (یعنی یک آدرس IPv6 به همراه اسلش و طول پیشوند)
دریافت می‌کند که با آدرس مبدأ تطبیق داده می‌شود.
.IP \(bu 2
\fB4o6\-interface\-id\fP: مقدار گزینه شناسه رابط رله را دریافت می‌کند.
.IP \(bu 2
\fB4o6\-interface\fP: نام یک رابط را دریافت می‌کند که با نام رابط ورودی
تطبیق داده می‌شود.
.UNINDENT
.sp
شرکت ISC پیکربندی زیر را آزمایش کرده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{

# DHCPv4 conf
\(dqDhcp4\(dq: {

    \(dqinterfaces\-config\(dq: {
        \(dqinterfaces\(dq: [ \(dqeno33554984\(dq ]
    },

    \(dqlease\-database\(dq: {
        \(dqtype\(dq: \(dqmemfile\(dq,
        \(dqname\(dq: \(dqleases4\(dq
    },

    \(dqvalid\-lifetime\(dq: 4000,

    \(dqsubnet4\(dq: [
    {
        \(dqid\(dq: 1,
        \(dqsubnet\(dq: \(dq10.10.10.0/24\(dq,
        \(dq4o6\-interface\(dq: \(dqeno33554984\(dq,
        \(dq4o6\-subnet\(dq: \(dq2001:db8:1:1::/64\(dq,
        \(dqpools\(dq: [ { \(dqpool\(dq: \(dq10.10.10.100 \- 10.10.10.199\(dq } ]
    }
    ],

    \(dqdhcp4o6\-port\(dq: 786,

    \(dqloggers\(dq: [
    {
        \(dqname\(dq: \(dqkea\-dhcp4\(dq,
        \(dqoutput\-options\(dq: [
        {
            \(dqoutput\(dq: \(dqkea\-dhcp4.log\(dq
        }
        ],
        \(dqseverity\(dq: \(dqDEBUG\(dq,
        \(dqdebuglevel\(dq: 0
    }
    ]
}

}
.EE
.UNINDENT
.UNINDENT
.SS بررسی‌های صحت در DHCPv4
.sp
یک جنبه مهم در اجرای صحیح سامانه DHCP، اطمینان از سازگاری داده‌ها است؛ با این حال،
در برخی موارد ممکن است تحمل برخی از داده‌های ناسازگار مناسب باشد. برای نمونه،
مدیر شبکه‌ای که موقتاً یک زیرشبکه را از پیکربندی حذف می‌کند، مایل نیست تمامی
اجاره‌های مرتبط با آن از پایگاه‌داده اجاره‌ها ناپدید شوند. Kea سازوکاری برای اجرای
بررسی‌های صحت (sanity checks) در چنین شرایطی دارد.
.sp
‏Kea از یک حوزه پیکربندی به نام \fBsanity\-checks\fP پشتیبانی می‌کند.
پارامتری به نام \fBlease\-checks\fP، بر اعتبارسنجی انجام‌شده هنگام بارگیری یک اجاره
جدید از فایل اجاره نظارت دارد. این سازوکار به Kea امکان می‌دهد تا برای اصلاح داده‌های
ناسازگار تلاش کند.
.sp
هر زیرشبکه یک مقدار \fBsubnet\-id\fP دارد؛ این روشی است که Kea به‌صورت داخلی
زیرشبکه‌ها را شناسایی می‌کند. هر اجاره نیز یک پارامتر \fBsubnet\-id\fP دارد که مشخص می‌کند
متعلق به کدام زیرشبکه است. با این حال، در صورت تغییر پیکربندی، ممکن است اجاره‌ای
با یک \fBsubnet\-id\fP وجود داشته باشد اما هیچ زیرشبکه منطبقی با آن یافت نشود.
همچنین ممکن است پیکربندی زیرشبکه تغییر یافته باشد و اکنون \fBsubnet\-id\fP متعلق به
زیرشبکه‌ای باشد که با اجاره همخوانی ندارد.
.sp
الگوریتم تصحیح Kea ابتدا بررسی می‌کند که آیا زیرشبکه‌ای با \fBsubnet\-id\fP مشخص‌شده
توسط اجاره وجود دارد یا خیر. اگر وجود داشته باشد، بررسی می‌کند که آیا اجاره متعلق به
آن زیرشبکه است یا خیر. در غیر این صورت، بسته به تنظیم \fBlease\-checks\fP، اجاره نادیده
گرفته می‌شود، هشداری نمایش داده می‌شود، یا زیرشبکه جدیدی برای اجاره انتخاب می‌شود که
از لحاظ توپولوژیکی با آن مطابقت دارد.
.sp
پنج سطح پشتیبانی می‌شود:
.INDENT 0.0
.IP \(bu 2
\fBnone\fP \- هیچ بررسی خاصی انجام نده؛ اجاره را همان‌طور که هست بپذیر.
.IP \(bu 2
\fBwarn\fP \- در صورت تشخیص مشکل هشدار نمایش بده، اما در هر حال داده‌های
اجاره را بپذیر. این مقدار پیش‌فرض است.
.IP \(bu 2
\fBfix\fP \- در صورت مشاهده ناسازگاری در داده‌ها، سعی کن آن را تصحیح کنی. اگر
تصحیح موفقیت‌آمیز نبود، داده‌های نادرست را در هر صورت درج کن.
.IP \(bu 2
\fBfix\-del\fP \- در صورت مشاهده ناسازگاری در داده‌ها، سعی کن آن را تصحیح کنی.
اگر تصحیح موفقیت‌آمیز نبود، اجاره را رد کن. این تنظیم صحت داده‌ها را تضمین می‌کند،
اما ممکن است برخی از داده‌های نادرست از دست بروند. با احتیاط استفاده شود.
.IP \(bu 2
\fBdel\fP \- در صورت تشخیص هرگونه ناسازگاری، اجاره را رد کن. این سخت‌گیرانه‌ترین
حالت است؛ با احتیاط استفاده شود.
.UNINDENT
.sp
این قابلیت در حال حاضر برای بک‌اند memfile پیاده‌سازی شده است. بررسی صحت
بر روی پایگاه‌داده اجاره در حافظه اعمال می‌شود، نه بر روی فایل اجاره؛ بدین معنا که
اجاره‌های ناسازگار در فایل اجاره باقی می‌مانند.
.sp
یک نمونه پیکربندی که این پارامتر را تنظیم می‌کند به شرح زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqsanity\-checks\(dq: {
        \(dqlease\-checks\(dq: \(dqfix\-del\(dq
    },
    ...
}
.EE
.UNINDENT
.UNINDENT.SS ذخیره‌سازی اطلاعات گسترش‌یافتهٔ اجاره (Storing Extended Lease Information)
.sp
برای پشتیبانی از قابلیت‌هایی مانند DHCP Leasequery
(RFC 4388 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc4388>) و
گزینه‌های stash agent (Stash Agent Options)،
باید اطلاعات اضافی به همراه هر اجاره (lease) ذخیره شود. از آنجا که حجم
اطلاعات برای هر اجاره پیامدهایی از نظر
کارایی و مصرف منابع سیستم به دنبال دارد، ذخیره‌سازی این اطلاعات
اضافی از طریق پارامتر \fBstore\-extended\-info\fP قابل پیکربندی است.
مقدار پیش‌فرض آن \fBfalse\fP است و می‌تواند در سطوح global، shared\-network و
subnet تنظیم شود.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqstore\-extended\-info\(dq: true,
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
هنگامی که روی \fBtrue\fP تنظیم شود، اطلاعات مربوط به DHCPREQUEST درخواست‌کنندهٔ اجاره
به عنوان یک عنصر نگاشت با برچسب \(dqISC\(dq به زمینهٔ کاربر (user context) اجاره اضافه می‌شود.
هنگامی که DHCPREQUEST دریافت‌شده حاوی گزینهٔ
(DHCP Option 82) باشد، این نگاشت شامل نگاشت \fBrelay\-agent\-info\fP
با محتوای گزینهٔ (DHCP Option 82) در مدخل \fBsub\-options\fP و
در صورت وجود، گزینه‌های \fBremote\-id\fP و \fBrelay\-id\fP خواهد بود.
از آنجا که بعید است پیام‌های DHCPREQUEST ارسال‌شده به عنوان تمدید حاوی این
اطلاعات باشند، مقادیر برگرفته از آخرین DHCPREQUEST که حاوی آن بوده است در
اجاره حفظ می‌شوند. زمینهٔ کاربر اجاره شبیه به این خواهد بود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{ \(dqISC\(dq: { \(dqrelay\-agent\-info\(dq: { \(dqsub\-options\(dq: \(dq0x0104AABBCCDD\(dq } } }
.EE
.UNINDENT
.UNINDENT
.sp
یا همراه با زیرگزینه‌های remote و relay:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqISC\(dq: {
        \(dqrelay\-agent\-info\(dq: {
            \(dqsub\-options\(dq: \(dq0x02030102030C03AABBCC\(dq,
            \(dqremote\-id\(dq: \(dq03010203\(dq,
            \(dqrelay\-id\(dq: \(dqAABBCC\(dq
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
ممکن است سایر کتابخانه‌های قلاب (hook libraries) از قبل در حال استفاده از \fBuser\-context\fP باشند.
فعال کردن \fBstore\-extended\-info\fP نباید با هیچ‌یک از محتویات دیگر \fBuser\-context\fP
تداخلی ایجاد کند، تا زمانی که آن‌ها نیز از عنصری با برچسب \(dqISC\(dq استفاده نکنند. به
بیان دیگر، \fBuser\-context\fP به عنوان محفظه‌ای انعطاف‌پذیر برای مقاصد
متعدد در نظر گرفته شده است. تا زمانی که هدف دیگری نیز عنصری با نام \(dqISC\(dq را در
\fBuser\-context\fP ننویسد، تعارضی رخ نخواهد داد.
.UNINDENT
.UNINDENT
.sp
اطلاعات گسترش‌یافتهٔ اجاره همچنین مشمول بررسی صحت (sanity checking) قابل پیکربندی است.
پارامتر موجود در محدودهٔ \fBsanity\-checks\fP با نام \fBextended\-info\-checks\fP
شناخته می‌شود و از این سطوح پشتیبانی می‌کند:
.INDENT 0.0
.IP \(bu 2
\fBnone\fP \- هیچ بررسی یا ارتقایی انجام ندهد. این سطح تنها زمانی باید استفاده شود که
اطلاعات گسترش‌یافته اصلاً استفاده نمی‌شود یا انتظار نمی‌رود اطلاعات گسترش‌یافته
با قالب‌بندی نادرست (از جمله استفاده از قالب قدیمی) وجود داشته باشد.
.IP \(bu 2
\fBfix\fP \- رفع برخی ناسازگاری‌های متداول و ارتقای اطلاعات گسترش‌یافته
با قالب قدیمی به قالب جدید. این سطح پیش‌فرض است و
زمانی که کتابخانهٔ قلاب Leasequery بارگذاری نشده باشد، مناسب است.
.IP \(bu 2
\fBstrict\fP \- رفع تمامی ناسازگاری‌هایی که روی کتابخانهٔ قلاب (Bulk)
Leasequery تأثیر دارند.
.IP \(bu 2
\fBpedantic\fP \- اعمال انطباق کامل با قالبی که توسط کد
Kea تولید می‌شود؛ به عنوان مثال، هیچ مدخل اضافی به جز
\fBcomment\fP مجاز نیست.
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این قابلیت در حال حاضر تنها برای بک‌اند memfile
پیاده‌سازی شده است. بررسی صحت بر روی پایگاه‌دادهٔ اجاره در حافظه
اعمال می‌شود، نه روی فایل اجاره؛ بدین معنا که اجاره‌های ناسازگار در فایل
اجاره باقی می‌مانند.
.UNINDENT
.UNINDENT
.SS گزینه‌های Stash Agent (Stash Agent Options)
.sp
این پارامتر سراسری در نگارش 2.5.8 اضافه شد تا رفتاری مشابه قابلیتی را ارائه دهد که
پیش‌تر در ISC DHCP در دسترس بود. هنگامی که پارامتر \fBstash\-agent\-options\fP
روی \fBtrue\fP باشد، کارساز گزینه‌های اطلاعات کارگزار رله (relay agent information options) ارسال‌شده
در پیام DHCPREQUEST اولیهٔ کلاینت (زمانی که کلاینت در وضعیت
SELECTING بود) را ضبط می‌کند و به گونه‌ای عمل می‌کند که گویی آن گزینه‌ها در تمامی
پیام‌های DHCPREQUEST بعدی که در وضعیت RENEWING ارسال می‌شوند گنجانده شده‌اند. این سازوکار
مشکلی را دور می‌زند که در آن گزینه‌های اطلاعات کارگزار رله معمولاً
در پیام‌های DHCPREQUEST ارسال‌شده توسط کلاینت در وضعیت RENEWING ظاهر نمی‌شوند؛ زیرا این پیام‌ها به صورت
unicast مستقیماً به کارساز ارسال شده و از طریق یک کارگزار رله فرستاده نمی‌شوند.
.sp
مقدار پیش‌فرض \fBfalse\fP است.
.SS تنظیمات چندریسمانی (Multi\-Threading Settings)
.sp
کارساز Kea می‌تواند به گونه‌ای پیکربندی شود که بسته‌ها را به صورت موازی با استفاده از چندین
ریسمان (thread) پردازش کند. این تنظیمات در ساختار \fBmulti\-threading\fP یافت می‌شوند و
عبارتند از:
.INDENT 0.0
.IP \(bu 2
\fBenable\-multi\-threading\fP \- استفاده از چندین ریسمان برای پردازش موازی
بسته‌ها. مقدار پیش‌فرض \fBtrue\fP است.
.IP \(bu 2
\fBthread\-pool\-size\fP \- تعیین تعداد ریسمان‌ها برای پردازش موازی
بسته‌ها. می‌تواند روی \fB0\fP (تشخیص خودکار)، یا هر عدد مثبتی که
تعداد ریسمان را به صراحت مشخص کند، تنظیم شود. مقدار پیش‌فرض \fB0\fP است.
.IP \(bu 2
\fBpacket\-queue\-size\fP \- تعیین اندازهٔ صف مورد استفاده توسط استخر
ریسمان (thread pool) جهت پردازش بسته‌ها. می‌تواند روی \fB0\fP (نامحدود)، یا هر عدد مثبتی
که اندازهٔ صف را به صراحت تعیین می‌کند، تنظیم شود. مقدار پیش‌فرض \fB64\fP است.
.UNINDENT
.sp
یک نمونه پیکربندی که این پارامترها را تنظیم می‌کند به صورت زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqmulti\-threading\(dq: {
       \(dqenable\-multi\-threading\(dq: true,
       \(dqthread\-pool\-size\(dq: 4,
       \(dqpacket\-queue\-size\(dq: 16
    },
    ...
}
.EE
.UNINDENT
.UNINDENT.SS تنظیمات چندریسمانی با پایگاه‌های داده پشتیبان مختلف
.sp
سرور Kea DHCPv4 توسط ISC محک‌زنی می‌شود تا مشخص شود کدام تنظیمات بهترین کارایی را ارائه می‌دهند. اگرچه این بخش نتایج ما را شرح می‌دهد، اما آنها صرفاً پیشنهاد هستند و به سخت‌افزار خاص مورد استفاده برای محک‌زنی بسیار وابسته‌اند. ما اکیداً توصیه می‌کنیم که مدیران سیستم محک‌زنی‌های کارایی خود را اجرا کنند.
.sp
گزارش کاملی از نتایج عملکرد برای آخرین نسخه پایدار Kea را می‌توان در اینجا \%<https://\:reports\:.kea\:.isc\:.org>\& مشاهده کرد. این گزارش شامل شرح سخت‌افزار و سناریوهای محک‌زنی، و همچنین نتایج کنونی است.
.sp
پس از فعال‌سازی چندریسمانی (multi\-threading)، تعداد ریسمان‌ها با پارامتر \fBthread\-pool\-size\fP تنظیم می‌شود. نتایج حاصل از آزمایش‌های ما نشان می‌دهد که بهترین تنظیمات برای \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> عبارتند از:
.INDENT 0.0
.IP \(bu 2
\fBthread\-pool\-size\fP: مقدار ۴ هنگام استفاده از \fBmemfile\fP برای ذخیره اجاره‌ها.
.IP \(bu 2
\fBthread\-pool\-size\fP: مقدار ۱۲ یا بیشتر هنگام استفاده از \fBmysql\fP برای ذخیره اجاره‌ها.
.IP \(bu 2
\fBthread\-pool\-size\fP: مقدار ۸ هنگام استفاده از \fBpostgresql\fP\&.
.UNINDENT
.sp
پارامتر بسیار مهم دیگر \fBpacket\-queue\-size\fP است؛ در محک‌زنی‌هایمان، ما از آن به عنوان ضریبی از \fBthread\-pool\-size\fP استفاده کردیم. مقدار واقعی به شدت به \fBthread\-pool\-size\fP وابسته است.
.sp
ما در محک‌زنی‌های خود بهترین نتایج را با تنظیمات زیر مشاهده کردیم:
.INDENT 0.0
.IP \(bu 2
\fBpacket\-queue\-size\fP: برابر با 7 * \fBthread\-pool\-size\fP هنگام استفاده از \fBmemfile\fP برای ذخیره اجاره‌ها؛ در مورد ما 7 * 4 = 28 بود. این بدان معناست که در هر زمان، حداکثر تا ۲۸ بسته می‌توانست در صف قرار گیرد.
.IP \(bu 2
\fBpacket\-queue\-size\fP: برابر با 66 * \fBthread\-pool\-size\fP هنگام استفاده از \fBmysql\fP برای ذخیره اجاره‌ها؛ در مورد ما 66 * 12 = 792 بود. این بدان معناست که حداکثر تا ۷۹۲ بسته می‌توانست در صف قرار گیرد.
.IP \(bu 2
\fBpacket\-queue\-size\fP: برابر با 11 * \fBthread\-pool\-size\fP هنگام استفاده از \fBpostgresql\fP برای ذخیره اجاره‌ها؛ در مورد ما 11 * 8 = 88 بود.
.UNINDENT
.SS شبکه‌های با اولویت فقط IPv6
.sp
سند RFC 8925 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc8925> که اخیراً توسط IETF منتشر شده است، یک گزینه DHCPv4 را تعیین می‌کند تا نشان دهد میزبان از حالت فقط IPv6 پشتیبانی می‌کند و در صورتی که شبکه اتصال IPv6 را فراهم کند، مایل است از دریافت آدرس IPv4 صرف‌نظر کند. ایده کلی این است که مدیر شبکه می‌تواند این گزینه را فعال کند تا به دستگاه‌های دوپشته‌ای (dual\-stack) سازگار سیگنال دهد که اتصال IPv6 در دسترس است و می‌توانند پشته IPv4 خود را خاموش کنند. محتوای گزینه جدید \fBv6\-only\-preferred\fP یک عدد صحیح ۳۲ بیتی بدون علامت است و مشخص می‌کند که دستگاه چه مدت باید پشته خود را غیرفعال کند. این مقدار به ثانیه بیان می‌شود.
.sp
این RFC به تایمر \fBV6ONLY_WAIT\fP اشاره می‌کند. این قابلیت در Kea با تنظیم مقدار گزینه \fBv6\-only\-preferred\fP پیاده‌سازی شده است. این روند از شیوه معمول تنظیم گزینه‌ها پیروی می‌کند؛ مقدار گزینه را می‌توان در سطوح pool، subnet، shared network یا سطوح سراسری (global)، یا حتی از طریق رزروهای میزبان (host reservations) مشخص کرد.
.sp
هیچ پردازش خاصی درگیر نیست؛ این فرآیند از سازوکار استاندارد پردازش گزینه‌ها در Kea پیروی می‌کند. این گزینه پس فرستاده نمی‌شود مگر اینکه کارخواه صراحتاً آن را درخواست کند. برای مثال، جهت فعال‌سازی این گزینه برای کل زیرشبکه، می‌توان از پیکربندی زیر استفاده کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
\(dqsubnet4\(dq: [
    {
        \(dqid\(dq: 1,
        \(dqpools\(dq: [ { \(dqpool\(dq:  \(dq192.0.2.1 \- 192.0.2.200\(dq } ],
        \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
        \(dqoption\-data\(dq: [
            {
                // This will make the v6\-only capable devices to disable their
                // v4 stack for half an hour and then try again
                \(dqname\(dq: \(dqv6\-only\-preferred\(dq,
                \(dqdata\(dq: \(dq1800\(dq
            }
        ]
    }
],
\&...
}
.EE
.UNINDENT
.UNINDENT
.SS حافظه پنهان اجاره‌ها (Lease Caching)
.sp
کارخواه‌هایی که در مدت‌زمانی کوتاه اقدام به تمدید مکرر می‌کنند می‌توانند موجب شوند که سرور مرتباً پایگاه‌داده را به‌روزرسانی کرده و روی آن بنویسد، که نتیجه آن افت کارایی سرور خواهد بود. پارامترهای کش به سرور DHCP دستور می‌دهند که از به‌روزرسانی بیش از حد اجاره‌ها خودداری کند و بدین ترتیب از این رفتار جلوگیری شود. در عوض، سرور همان اجاره را بدون هیچ تغییری به جز CLTT (زمان آخرین ارسال کارخواه یا Client Last Transmission Time) که نیازی به عملیات دیسک ندارد، تخصیص می‌دهد (یعنی از آن مجدداً استفاده می‌کند).
.sp
این دو پارامتر عبارتند از عدد اعشاری \fBcache\-threshold\fP و عدد صحیح \fBcache\-max\-age\fP. این پارامترها را می‌توان در سطوح global، shared\-network و subnet پیکربندی کرد. سطح subnet بر سطح shared\-network اولویت دارد، در حالی که از سطح global به عنوان آخرین راهکار استفاده می‌شود. برای مثال:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
\(dqsubnet4\(dq: [
    {
        \(dqpools\(dq: [ { \(dqpool\(dq:  \(dq192.0.2.1 \- 192.0.2.200\(dq } ],
        \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
        \(dqcache\-threshold\(dq: .25,
        \(dqcache\-max\-age\(dq: 600,
        \(dqvalid\-lifetime\(dq: 2000,
        ...
    }
],
\&...
}
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
از نسخه Kea 3.0.0، مقدار پیش‌فرض برای \fBcache\-threshold\fP برابر 0.25 است در حالی که \fBcache\-max\-age\fP نامشخص رها شده است. این بدان معناست که کش کردن اجاره‌ها به صورت پیش‌فرض فعال است. می‌توان آن را در محدوده مورد نظر با تنظیم \fBcache\-threshold\fP روی 0.0 یا تنظیم \fBcache\-max\-age\fP روی 0 غیرفعال کرد.
.UNINDENT
.UNINDENT
.sp
هنگامی که یک اجاره از پیش واگذار شده بتواند پاسخگوی پرس‌وجوی کارخواه باشد:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
هرگونه تغییر مهم، مانند پارامتر DDNS، نام میزبان یا کاهش طول عمر معتبر، اجاره را غیرقابل استفاده مجدد می‌کند.
.IP \(bu 2
سن اجاره، یعنی اختلاف بین زمان ایجاد یا آخرین ویرایش و زمان فعلی محاسبه می‌شود (مدت‌زمان سپری‌شده).
.IP \(bu 2
اگر \fBcache\-max\-age\fP به طور صریح پیکربندی شده باشد، با سن اجاره مقایسه می‌شود؛ اجاره‌هایی که بیش از حد قدیمی باشند قابل استفاده مجدد نیستند. این بدان معناست که مقدار 0 برای \fBcache\-max\-age\fP قابلیت کش اجاره را غیرفعال می‌کند.
.IP \(bu 2
اگر \fBcache\-threshold\fP به طور صریح پیکربندی شده و بین 0.0 و 1.0 باشد، درصدی از طول عمر معتبر اجاره را بیان می‌کند که برای سن اجاره مجاز شمرده می‌شود. مقادیر کمتر و مساوی 0.0 و مقادیر بزرگتر از 1.0 قابلیت کش اجاره را غیرفعال می‌کنند.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
در مثال ما، اجاره‌ای با طول عمر معتبر ۲۰۰۰ ثانیه در صورتی می‌تواند مجدداً استفاده شود که کمتر از ۵۰۰ ثانیه پیش ثبت شده باشد. با طول عمر ۳۰۰۰ ثانیه، حداکثر سن ۶۰۰ ثانیه اعمال می‌شود.
.sp
در پاسخ‌های ارسالی به کارخواه (مانند پیام‌های DHCPACK)، گزینه \fBdhcp\-lease\-time\fP روی طول عمر معتبر قابل استفاده مجدد تنظیم می‌شود، یعنی تاریخ انقضا تغییر نمی‌کند. سایر گزینه‌های مبتنی بر طول عمر معتبر، مانند \fBdhcp\-renewal\-time\fP و \fBdhcp\-rebinding\-time\fP نیز به طول عمر قابل استفاده مجدد وابسته هستند..SS "تخصیص موقت در DHCPDISCOVER"
.sp
به‌طور پیش‌فرض، \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> هنگام پیشنهاد دادن یک آدرس به کلاینت در پاسخ به یک DHCPDISCOVER، اجاره‌ای را تخصیص نداده یا ذخیره نمی‌کند. به‌طور کلی، \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> می‌تواند با به تعویق انداختن تخصیص و ذخیره‌سازی اجاره تا زمان دریافت DHCPREQUESTها برای آن‌ها، درخواست‌های کلاینت را سریع‌تر برآورده کند. پارامتر \fBoffer\-lifetime\fP در \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> (زمانی که صفر نباشد) به سرور دستور می‌دهد هنگام تولید یک DHCPOFFER، یک اجاره را تخصیص داده و پایدار (persist) کند. علاوه بر این:
.INDENT 0.0
.IP \(bu 2
طول عمر اجاره‌ی پایدارشده برابر با \fBoffer\-lifetime\fP (به ثانیه) است.
.IP \(bu 2
طول عمری که در DHCPOFFER از طریق گزینه ۵۱ (option 51) برای کلاینت ارسال می‌شود، همچنان بر اساس \fBvalid\-lifetime\fP است\&. این کار از بروز مشکل با کلاینت‌هایی که ممکن است پیشنهادهایی با طول عمر بیش از حد کوتاه را رد کنند، جلوگیری می‌کند.
.IP \(bu 2
به‌روزرسانی‌های DDNS انجام نمی‌شوند. همانند رفتار پیش‌فرض، این به‌روزرسانی‌ها در DHCPREQUEST رخ می‌دهند.
.IP \(bu 2
به‌روزرسانی‌ها به همتایان HA ارسال نمی‌شوند.
.IP \(bu 2
آمار اجاره‌های تخصیص‌یافته افزایش می‌یابد.
.IP \(bu 2
پردازش انقضا و بازپس‌گیری (reclamation) دقیقاً همانند اجاره‌های تخصیص‌یافته در طول پردازش DHCPREQUEST رفتار می‌کنند.
.IP \(bu 2
کش‌کردن اجاره (Lease caching)، در صورت فعال بودن، رعایت می‌شود.
.IP \(bu 2
در مراکزی که چندین نمونه از \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> را در مقابل یک مخزن اجاره‌ی مشترک اجرا می‌کنند، رقابت‌ها (races) برای مقادیر مشخص آدرس در طول پردازش DHCPDISCOVER از دست می‌روند نه در طول پردازش DHCPREQUEST. سرورهایی که رقابت را برای آدرس ببازند، به‌سادگی به کلاینت پاسخ نمی‌دهند، به جای اینکه به آن‌ها NAK ارسال کنند. کلاینت نیز به نوبه خود به‌سادگی DHCPDISCOVER خود را مجدداً تلاش می‌کند. این امر باید میزان ترافیکی را که چنین تداخل‌هایی ایجاد می‌کنند، کاهش دهد.
.IP \(bu 2
به کلاینت‌هایی که DHCPDISCOVER را تکرار می‌کنند، هر بار همان آدرس پیشنهاد می‌شود.
.UNINDENT
.sp
یک نمونه پیکربندی زیرشبکه در زیر نشان داده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
\(dqsubnet4\(dq: [
    {
        \(dqpools\(dq: [ { \(dqpool\(dq:  \(dq192.0.2.1 \- 192.0.2.200\(dq } ],
        \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
        \(dqoffer\-lifetime\(dq: 60,
        \(dqvalid\-lifetime\(dq: 2000,
        ...
    }
],
\&...
}
.EE
.UNINDENT
.UNINDENT
.sp
در اینجا \fBoffer\-lifetime\fP روی ۶۰ ثانیه با یک \fBvalid\-lifetime\fP معادل ۲۰۰۰ ثانیه پیکربندی شده است. این به \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> دستور می‌دهد هنگام ارسال اجاره‌ها در DHCPOFFERها، آن‌ها را به مدت ۶۰ ثانیه پایدار کند و سپس هنگامی که کلاینت‌ها برای آن‌ها DHCPREQUEST ارسال می‌کنند، مدت آن‌ها را به ۲۰۰۰ ثانیه افزایش دهد.
.sp
این مقدار، که پیش‌فرض آن 0 است، در سطوح global، shared\-network، subnet و class پشتیبانی می‌شود. انتخاب یک مقدار مناسب برای \fBoffer\-lifetime\fP به‌شدت به ساختار شبکه وابسته است، اما مقداری بین ۶۰ تا ۱۲۰ ثانیه نقطه‌ی شروع معقولی است.
.SS "گزینه‌های DNR (Discovery of Network\-designated Resolvers) برای DHCPv4"
.sp
گزینه‌ی Discovery of Network\-designated Resolvers یا DNR، در RFC 9463 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc9463> به عنوان روشی برای اعلام مکان تحلیل‌کننده‌های DNS (resolvers) که از طریق روش‌هایی به غیر از DNS کلاسیک روی UDP روی پورت ۵۳ در دسترس هستند، معرفی شد. تا بهار ۲۰۲۴، فناوری‌های پشتیبانی‌شده عبارت‌اند از DoT (DNS\-over\-TLS)، DoH (DNS\-over\-HTTPS) و DoQ (DNS\-over\-QUIC)، اما این گزینه به‌گونه‌ای طراحی شده است که قابل توسعه باشد تا پروتکل‌های دیگر را در آینده در بر بگیرد.
.sp
گزینه‌ی DHCPv4 و گزینه‌های متناظر آن در DHCPv6 تقریباً کاملاً یکسان هستند، با این استثنا که در تعداد تفاوت دارند (cardinality): تنها یک گزینه‌ی DHCPv4 مجاز است، در حالی که گزینه‌های متعددی برای DHCPv6 مجازند. برای امکان انتقال چندین مدخل (entry)، گزینه‌ی DNR در DHCPv4 یک آرایه است که چندین نمونه‌ی DNS را ممکن می‌سازد. هر نمونه از نظر منطقی معادل یک گزینه‌ی DHCPv6 است؛ تنها تفاوت این است که به جای آدرس‌های IPv6 از آدرس‌های IPv4 استفاده می‌کند. گزینه‌های DNR در DHCPv4 امکان پیکربندی بیش از یک نمونه‌ی DNR را فراهم می‌کنند، و نمونه‌های DNR با نویسه‌ی «pipe» (\fB0x7C\fP) از یکدیگر جدا می‌شوند.
.sp
برای مشاهده‌ی یک مثال دقیق از نحوه‌ی پیکربندی گزینه‌ی DNR، به DNR (Discovery of Network\-designated Resolvers) Options for DHCPv6 \%<#\:dnr6-options>\& مراجعه کنید.
.sp
برای هر نمونه‌ی DNR، فیلدهای جداشده با کاما باید به ترتیب زیر ارائه شوند:
.INDENT 0.0
.IP \(bu 2
اولویت سرویس Service Priority (اجباری)،
.IP \(bu 2
نام دامنه کاملاً معین ADN FQDN (اجباری)،
.IP \(bu 2
آدرس(های) IP (اختیاری؛ در صورت وجود بیش از یکی، باید با فاصله از هم جدا شوند)
.IP \(bu 2
پارامترهای SvcParams به عنوان مجموعه‌ای از جفت‌های کلید=مقدار (key=value) (اختیاری؛ در صورت وجود بیش از یکی \- باید با فاصله از هم جدا شوند).
برای ارائه‌ی بیش از یک \fBalpn\-id\fP، آن‌ها را با کاماهایی که با دو بک‌اسلش گریز (escape) داده شده‌اند جدا کنید (همانند مثال زیر).
.UNINDENT
.sp
مثال استفاده:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqname\(dq: \(dqv4\-dnr\(dq,
  // 2 DNR Instances:
  // \- Service priority 2, ADN, resolver IPv4 address and Service Parameters
  // \- Service priority 3, ADN \- this is ADN\-only mode as per RFC 9463 3.1.6
  \(dqdata\(dq: \(dq2, resolver.example., 10.0.5.6, alpn=dot\e\e,doq port=8530 | 3, fooexp.resolver.example.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
اگر نویسه‌های «comma» یا «pipe» به جای جداکننده‌ی فیلد به عنوان متن استفاده شوند، باید با دو بک‌اسلش گریز داده شوند (\fB\e\e,\fP یا \fB\e\e|\fP). کاماهای گریز داده شده باید هنگام پیکربندی بیش از یک پروتکل \fBALPN\fP برای جداسازی آن‌ها استفاده شوند. نویسه‌ی «pipe» (\fB0x7C\fP) می‌تواند در پارامتر سرویس \fBdohpath\fP استفاده شود، زیرا در یک URI مجاز است.
.UNINDENT
.UNINDENT
.sp
مثال‌هایی برای گزینه‌های DNR در DHCPv4 که در سورس‌های Kea ارائه شده‌اند را می‌توان در kea4/all\-options.json \%<#\:config-example-kea4-all-options-json>\& یافت..SS "رزروهای میزبان در DHCPv4 (Host Reservations in DHCPv4)"
.sp
موارد بسیاری وجود دارد که در آن‌ها ارائهٔ پیکربندی بر پایهٔ هر میزبان (per\-host) مفید است. واضح‌ترین مورد، رزرو یک آدرس ثابت و مشخص برای استفادهٔ اختصاصی توسط یک کلاینت (میزبان) معین است؛ کلاینت هنگام بازگشت، هر بار همان آدرس را از سرور دریافت می‌کند و سایر کلاینت‌ها عموماً آن آدرس را دریافت نمی‌کنند. همچنین رزروهای میزبان زمانی که یک میزبان نیازمندی‌های خاصی دارد، مانند یک چاپگر که به گزینه‌های DHCP اضافی نیاز دارد، بسیار کارآمد هستند. یکی دیگر از کاربردهای ممکن، تعریف نام‌های یکتا برای میزبان‌ها است.
.sp
ممکن است مواردی پیش آید که رزرو جدیدی برای یک کلاینت روی آدرسی انجام شده باشد که در حال حاضر توسط کلاینت دیگری استفاده می‌شود. ما این وضعیت را \(dqتداخل\(dq (conflict) می‌نامیم. این تداخل‌ها با گذشت زمان به‌طور خودکار برطرف می‌شوند، همان‌طور که در بخش‌های بعدی شرح داده شده است. هنگامی که یک تداخل برطرف شد، کلاینت صحیح هنگام تمدید (renew)، پیکربندی رزروشده را دریافت خواهد کرد.
.sp
رزروهای میزبان به‌عنوان پارامترهایی برای هر زیرشبکه تعریف می‌شوند. هر میزبان باید شناسهٔ یکتای خود را داشته باشد، مانند آدرس سخت‌افزاری/MAC. یک آرایهٔ اختیاری \fBreservations\fP در ساختار \fBsubnet4\fP وجود دارد؛ هر عنصر در این آرایه ساختاری است که اطلاعات مربوط به رزروها را برای یک میزبان منفرد نگه می‌دارد. به‌ویژه، این ساختار دارای شناسه‌ای است که یک میزبان را به‌طور منحصربه‌فرد مشخص می‌کند. در زمینهٔ DHCPv4، این شناسه معمولاً یک آدرس سخت‌افزاری یا MAC است. در بیشتر موارد یک آدرس IP مشخص خواهد شد. همچنین می‌توان یک hostname، گزینه‌های مختص به میزبان، یا فیلدهای حمل‌شده در پیام DHCPv4 مانند \fBsiaddr\fP، \fBsname\fP یا \fBfile\fP را مشخص کرد\&.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
آدرس رزروشده باید درون زیرشبکه باشد.
.UNINDENT
.UNINDENT
.sp
مثال زیر نحوهٔ رزرو آدرس‌ها را برای میزبان‌های خاص در یک زیرشبکه نشان می‌دهد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
\(dqsubnet4\(dq: [
    {
        \(dqid\(dq: 1,
        \(dqpools\(dq: [ { \(dqpool\(dq:  \(dq192.0.2.1 \- 192.0.2.200\(dq } ],
        \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
        \(dqinterface\(dq: \(dqeth0\(dq,
        \(dqreservations\(dq: [
            {
                \(dqhw\-address\(dq: \(dq1a:1b:1c:1d:1e:1f\(dq,
                \(dqip\-address\(dq: \(dq192.0.2.202\(dq
            },
            {
                \(dqduid\(dq: \(dq0a:0b:0c:0d:0e:0f\(dq,
                \(dqip\-address\(dq: \(dq192.0.2.100\(dq,
                \(dqhostname\(dq: \(dqalice\-laptop\(dq
            },
            {
                \(dqcircuit\-id\(dq: \(dq\(aqcharter950\(aq\(dq,
                \(dqip\-address\(dq: \(dq192.0.2.203\(dq
            },
            {
                \(dqclient\-id\(dq: \(dq01:11:22:33:44:55:66\(dq,
                \(dqip\-address\(dq: \(dq192.0.2.204\(dq
            }
        ]
    }
],
\&...
}
.EE
.UNINDENT
.UNINDENT
.sp
مدخل نخست آدرس 192.0.2.202 را برای کلاینتی رزرو می‌کند که از آدرس MAC مقدار 1a:1b:1c:1d:1e:1f استفاده می‌کند. مدخل دوم آدرس 192.0.2.100 و نام میزبان \(dqalice\-laptop\(dq را برای کلاینتی که از DUID با مقدار 0a:0b:0c:0d:0e:0f استفاده می‌کند، رزرو می‌نماید. (اگر به‌روزرسانی‌های DNS برنامه‌ریزی شده باشند، اکیداً توصیه می‌شود که نام‌های میزبان یکتا باشند.) مثال سوم آدرس 192.0.3.203 را برای کلاینتی رزرو می‌کند که درخواست آن توسط یک کارگزار بازپخش (relay agent) رله می‌شود که گزینهٔ \fBcircuit\-id\fP را با مقدار \(dqcharter950\(dq درج می‌کند. مدخل چهارم آدرس 192.0.2.204 را برای کلاینتی که از شناسهٔ کلاینت با مقدار 01:11:22:33:44:55:66 استفاده می‌کند، رزرو می‌نماید.
.sp
مثال بالا صرفاً برای اهداف نمایشی آورده شده است؛ در استقرارهای واقعی توصیه می‌شود تا حد امکان از انواع کمتری (ترجیحاً فقط یک نوع) استفاده شود. برای بحث دقیق دربارهٔ این نکته، به Fine\-Tuning DHCPv4 Host Reservation مراجعه کنید.
.sp
ایجاد رزرو برای یک میزبان متحرک که ممکن است از چندین زیرشبکه بازدید کند، نیازمند تعریف میزبان جداگانه در هر زیرشبکه‌ای است که انتظار می‌رود آن میزبان در آن حضور یابد. تعریف چندین میزبان با آدرس سخت‌افزاری یکسان در یک زیرشبکهٔ واحد امکان‌پذیر نیست. تعاریف چندگانهٔ میزبان با آدرس سخت‌افزاری یکسان در صورتی معتبر هستند که هر یک در زیرشبکهٔ متفاوتی قرار داشته باشند.
.sp
افزودن رزروهای میزبان با افت کارایی همراه است. در اصل، زمانی که سروری که از رزرو میزبان پشتیبانی نمی‌کند به یک پرس‌وجو پاسخ می‌دهد، باید بررسی کند که آیا برای آدرس مورد نظر که برای تخصیص یا تمدید در نظر گرفته شده، اجاره‌ای (lease) وجود دارد یا خیر. سروری که از رزرو میزبان پشتیبانی می‌کند باید بررسی‌های بیشتری انجام دهد: نه تنها اینکه آیا آدرس در حال حاضر استفاده می‌شود (یعنی اجاره‌ای برای آن وجود دارد یا خیر)، بلکه اینکه آیا این آدرس ممکن است توسط شخص دیگری استفاده شود (یعنی رزروی برای آن وجود دارد یا خیر). این بررسی اضافی بار پردازشی بیشتری تحمیل می‌کند.
.SS "انواع رزرو آدرس (Address Reservation Types)"
.sp
در یک سناریوی معمول Kea، یک زیرشبکهٔ IPv4 تعریف می‌شود (مانند 192.0.2.0/24) که بخش مشخصی از آن به تخصیص پویا توسط سرور DHCPv4 اختصاص می‌یابد. به این بخش پویا، یک استخر پویا (dynamic pool) یا به‌سادگی pool گفته می‌شود. در اصل، یک رزرو میزبان می‌تواند هر آدرسی را که متعلق به زیرشبکه است رزرو کند. رزروهایی که آدرس‌های متعلق به استخرهای پیکربندی‌شده را مشخص می‌کنند، \(dqرزروهای درون‌استخری\(dq (in\-pool reservations) نامیده می‌شوند. در مقابل، آن‌هایی که متعلق به استخرهای پویا نیستند، \(dqرزروهای برون‌استخری\(dq (out\-of\-pool reservations) نام دارند. هیچ تفاوت رسمی در نحو (syntax) رزرو وجود ندارد و هر دو نوع رزرو به‌طور یکسان مدیریت می‌شوند.
.sp
ابزار Kea از رزروهای سراسری میزبان پشتیبانی می‌کند. این‌ها رزروهایی هستند که در سطح سراسری (global) در پیکربندی مشخص می‌شوند و متعلق به هیچ زیرشبکهٔ خاصی نیستند. Kea همچنان بسته‌های ورودی کلاینت را مانند قبل با یک زیرشبکه تطبیق می‌دهد، اما هنگامی که حالت رزرو زیرشبکه روی \(dqglobal\(dq تنظیم شده باشد، Kea رزروهای میزبان را فقط در میان رزروهای سراسریِ تعریف‌شده جستجو می‌کند. معمولاً چنین رزروهایی برای رزرو نام‌های میزبان برای کلاینت‌هایی استفاده می‌شوند که ممکن است از یک زیرشبکه به زیرشبکهٔ دیگری جابه‌جا شوند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
رزروهای سراسری، اگرچه در شرایط خاصی مفید هستند، دارای جنبه‌هایی هستند که هنگام استفاده از آن‌ها باید به‌دقت مورد توجه قرار گیرند. لطفاً برای جزئیات بیشتر به Conflicts in DHCPv4 Reservations مراجعه کنید.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
از نسخهٔ Kea 1.9.1 به بعد، حالت رزرو با سه پرچم بولی (boolean flags)، یعنی \fBreservations\-global\fP، \fBreservations\-in\-subnet\fP و \fBreservations\-out\-of\-pool\fP جایگزین شده است که امکان پیکربندی رزروهای میزبان را هم به‌صورت سراسری و هم درون زیرشبکه فراهم می‌کنند. در چنین مواردی، هنگامی که هر دو برای یک کلاینت یکسان وجود داشته باشند، رزرو میزبانِ زیرشبکه نسبت به رزرو سراسری اولویت دارد.
.UNINDENT
.UNINDENT.SS تداخل‌ها در رزروهای DHCPv4 (Conflicts in DHCPv4 Reservations)
.sp
از آنجا که اطلاعات مربوط به رزروها و اجاره‌ها به‌صورت جداگانه ذخیره می‌شوند، ممکن است تداخل‌هایی بروز کند. توالی رخدادهای زیر را در نظر بگیرید: کارساز استخر پویایی از نشانی‌ها را در محدودهٔ 192.0.2.10 تا 192.0.2.20 پیکربندی کرده است. میزبان Host A نشانی‌ای را درخواست می‌کند و 192.0.2.10 را دریافت می‌نماید. اکنون مدیر سیستم تصمیم می‌گیرد نشانی 192.0.2.10 را برای Host B رزرو کند. به‌طور کلی، رزرو نشانی‌ای که در حال حاضر به کس دیگری واگذار شده توصیه نمی‌شود، اما سناریوهای معتبری وجود دارد که چنین عملیاتی در آن‌ها توجیه‌پذیر است.
.sp
اکنون کارساز با تداخلی مواجه است که باید حل شود. اگر Host B بالا آمده و درخواستی برای یک نشانی ارسال کند، کارساز نمی‌تواند بلافاصله نشانی رزرو شدهٔ 192.0.2.10 را به آن اختصاص دهد. یک رویکرد ساده‌انگارانه این است که اجارهٔ فعلی Host A فوراً حذف شده و اجارهٔ جدیدی برای Host B ایجاد شود. با این حال این کار مشکل را برطرف نمی‌کند، زیرا به محض این‌که Host B نشانی را دریافت کند، متوجه می‌شود که این نشانی در حال حاضر (توسط Host A) در حال استفاده است و یک پیام DHCPDECLINE ارسال خواهد کرد. بنابراین، در چنین وضعیتی، کارساز باید موقتاً نشانی متفاوتی را از استخر پویا (که با آنچه رزرو شده مطابقت ندارد) به Host B اختصاص دهد.
.sp
هنگامی که Host A نشانی خود را تمدید می‌کند، کارساز متوجه خواهد شد نشانی‌ای که تمدید می‌شود اکنون برای میزبان دیگری \- Host B \- رزرو شده است. کارساز با ارسال یک پیام DHCPNAK به Host A اطلاع می‌دهد که دیگر مجاز به استفاده از آن نیست. با این حال کارساز اجاره را حذف نخواهد کرد، چرا که در شبکه‌های دارای اتلاف بسته (lossy)، احتمال اندکی وجود دارد که DHCPNAK تحویل داده نشود. اگر این اتفاق بیفتد، کلاینت هیچ پاسخی دریافت نمی‌کند و بنابراین بستهٔ DHCPREQUEST خود را دوباره ارسال خواهد کرد. به محض این‌که DHCPNAK توسط Host A دریافت شود، این میزبان به مرحلهٔ کشف کارساز (server discovery) بازگشته و در نهایت نشانی متفاوتی دریافت خواهد کرد. کارساز علاوه بر تخصیص اجارهٔ جدید، اجارهٔ قدیمی را نیز حذف خواهد کرد. در نتیجه، نشانی 192.0.2.10 آزاد خواهد شد.
.sp
هنگامی که Host B تلاش کند نشانی موقتاً تخصیص‌یافته‌اش را تمدید نماید، کارساز تشخیص می‌دهد که این میزبان دارای اجاره‌ای معتبر است، اما متوجه خواهد شد که یک رزرو برای نشانی دیگری وجود دارد. کارساز یک DHCPNAK ارسال می‌کند تا به Host B اطلاع دهد که نشانی آن دیگر قابل استفاده نیست، اما اجاره‌اش را نگه می‌دارد (مجدداً، ممکن است DHCPNAK گم شود، بنابراین کارساز آن را تا زمان بازگشت کلاینت برای دریافت نشانی جدید حفظ می‌کند). سپس Host B به فاز کشف کارساز بازگشته و سرانجام یک پیام DHCPREQUEST می‌فرستد. این بار کارساز درمی‌یابد که رزروی برای این میزبان ثبت شده و نشانی رزروشدهٔ 192.0.2.10 استفاده نمی‌شود، بنابراین آن را اعطا می‌کند. کارساز همچنین اجارهٔ مربوط به نشانی موقت قبلی Host B را حذف خواهد کرد.
.sp
این بازیابی حتی اگر سایر میزبان‌ها نیز تلاش کنند نشانی رزرو شده را دریافت نمایند، موفقیت‌آمیز خواهد بود. اگر Host C پس از ثبت رزرو، نشانی 192.0.2.10 را درخواست کند، کارساز یا نشانی دیگری را پیشنهاد می‌دهد (در پاسخ به DHCPDISCOVER) یا DHCPNAK ارسال می‌کند (در پاسخ به DHCPREQUEST).
.sp
این سازوکار به کارساز اجازه می‌دهد تا از شرایطی که رزروها با اجاره‌های موجود تداخل پیدا می‌کنند، به‌طور کامل بازیابی شود؛ با این حال، انجام این فرایند تقریباً به اندازهٔ مدت‌زمان تعیین‌شده در \fBrenew\-timer\fP\& زمان می‌برد. بهترین روش برای جلوگیری از چنین روندی، عدم تعریف رزروهای جدیدی است که با اجاره‌های موجود در تداخل هستند. توصیهٔ دیگر، استفاده از رزروهای خارج از استخر (out\-of\-pool) است؛ اگر نشانی رزروشده به هیچ استخری تعلق نداشته باشد، کلاینت‌های دیگر به هیچ وجه نمی‌توانند آن را دریافت کنند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
سازوکار حل تداخل برای رزروهای سراسری (global reservations) کار نمی‌کند. هرچند ویژگی رزرو سراسری نشانی ممکن است در پیکربندی‌های خاصی مفید باشد، عموماً توصیه می‌شود که از رزروهای سراسری برای نشانی‌ها استفاده نشود. مدیرانی که تصمیم به استفاده از رزروهای سراسری می‌گیرند، باید به‌صورت دستی اطمینان حاصل کنند که نشانی‌های رزروشده درون استخرهای پویا قرار ندارند.
.UNINDENT
.UNINDENT
.SS رزرو نام میزبان (Reserving a Hostname)
.sp
هنگامی که رزرو برای یک کلاینت شامل \fBhostname\fP باشد، کارساز این نام میزبان را در گزینهٔ Client FQDN یا Hostname به کلاینت بازمی‌گرداند. کارساز تنها در صورتی با گزینهٔ Client FQDN پاسخ می‌دهد که کلاینت گزینهٔ Client FQDN را در پیام ارسالی خود به کارساز گنجانده باشد. در صورتی که کلاینت گزینهٔ Hostname را در پیام خود گنجانده باشد یا گزینهٔ Hostname را از طریق گزینهٔ Parameter Request List درخواست کرده باشد، کارساز با گزینهٔ Hostname پاسخ می‌دهد. کارساز حتی اگر برای انجام به‌روزرسانی‌های DNS پیکربندی نشده باشد نیز گزینهٔ Hostname را بازمی‌گرداند. نام میزبان رزروشده همواره بر نام میزبان ارائه‌شده توسط کلاینت یا نام میزبان خودتولیدشده (از روی نشانی IPv4) اولویت دارد.
.sp
کارساز نام میزبان رزروشده را با مقدار پارامتر \fBddns\-qualifying\-suffix\fP تکمیل (qualify) می‌کند. برای نمونه، پیکربندی زیرشبکهٔ زیر:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqsubnet4\(dq: [
    {
        \(dqid\(dq: 1,
        \(dqsubnet\(dq: \(dq10.0.0.0/24\(dq,
        \(dqpools\(dq: [ { \(dqpool\(dq: \(dq10.0.0.10\-10.0.0.100\(dq } ],
        \(dqddns\-qualifying\-suffix\(dq: \(dqexample.isc.org.\(dq,
        \(dqreservations\(dq: [
           {
             \(dqhw\-address\(dq: \(dqaa:bb:cc:dd:ee:ff\(dq,
             \(dqhostname\(dq: \(dqalice\-laptop\(dq
           }
        ]
    }
    ],
    \(dqdhcp\-ddns\(dq: {
        \(dqenable\-updates\(dq: true
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
باعث تخصیص نام میزبان \(dqalice\-laptop.example.isc.org.\(dq به کلاینت دارای نشانی MAC برابر با \(dqaa:bb:cc:dd:ee:ff\(dq خواهد شد. اگر \fBddns\-qualifying\-suffix\fP مشخص نشده باشد، از مقدار پیش‌فرض (خالی) استفاده خواهد شد و در این حالت، مقدار ارائه‌شده در \fBhostname\fP به عنوان یک نام کاملاً واجد شرایط (FQDN) تلقی می‌شود. بدین ترتیب، با خالی گذاشتن \fBddns\-qualifying\-suffix\fP، امکان تخصیص نام‌های دامنهٔ متفاوت به کلاینت‌های گوناگون وجود خواهد داشت:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqsubnet4\(dq: [
    {
        \(dqid\(dq: 1,
        \(dqsubnet\(dq: \(dq10.0.0.0/24\(dq,
        \(dqpools\(dq: [ { \(dqpool\(dq: \(dq10.0.0.10\-10.0.0.100\(dq } ],
        \(dqreservations\(dq: [
           {
             \(dqhw\-address\(dq: \(dqaa:bb:cc:dd:ee:ff\(dq,
             \(dqhostname\(dq: \(dqalice\-laptop.isc.org.\(dq
           },
           {
             \(dqhw\-address\(dq: \(dq12:34:56:78:99:AA\(dq,
             \(dqhostname\(dq: \(dqmark\-desktop.example.org.\(dq
           }
        ]
    }
    ],
    \(dqdhcp\-ddns\(dq: {
        \(dqenable\-updates\(dq: true
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
مثال بالا منجر به اختصاص نام میزبان \(dqalice\-laptop.isc.org.\(dq به کلاینت با نشانی MAC برابر با \(dqaa:bb:cc:dd:ee:ff\(dq، و نام میزبان \(dqmark\-desktop.example.org.\(dq به کلاینت با نشانی MAC برابر با \(dq12:34:56:78:99:AA\(dq می‌گردد..SS گنجاندن گزینه‌های مشخص DHCPv4 در رزروها
.sp
Kea امکان تعیین گزینه‌ها را بر اساس هر میزبان فراهم می‌کند. این گزینه‌ها
از همان قوانین حاکم بر سایر گزینه‌ها پیروی می‌کنند. این موارد می‌توانند
گزینه‌های استاندارد (بخش Standard DHCPv4 Options را ببینید)،
گزینه‌های سفارشی (بخش Custom DHCPv4 Options را ببینید)،
یا گزینه‌های وابسته به سازنده (بخش DHCPv4 Vendor\-Specific Options را ببینید) باشند. مثال
زیر نحوهٔ تعریف گزینه‌های استاندارد را نشان می‌دهد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqsubnet4\(dq: [
    {
        \(dqreservations\(dq: [
        {
            \(dqhw\-address\(dq: \(dqaa:bb:cc:dd:ee:ff\(dq,
            \(dqip\-address\(dq: \(dq192.0.2.1\(dq,
            \(dqoption\-data\(dq: [
            {
                \(dqname\(dq: \(dqcookie\-servers\(dq,
                \(dqdata\(dq: \(dq10.1.1.202,10.1.1.203\(dq
            },
            {
                \(dqname\(dq: \(dqlog\-servers\(dq,
                \(dqdata\(dq: \(dq10.1.1.200,10.1.1.201\(dq
            }
            ]
        }
        ],
        ...
    }
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
گزینه‌های وابسته به سازنده را می‌توان به شیوه‌ای مشابه رزرو کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqsubnet4\(dq: [
    {
        \(dqreservations\(dq: [
        {
            \(dqhw\-address\(dq: \(dqaa:bb:cc:dd:ee:ff\(dq,
            \(dqip\-address\(dq: \(dq10.0.0.7\(dq,
            \(dqoption\-data\(dq: [
            {
                \(dqname\(dq: \(dqvivso\-suboptions\(dq,
                \(dqdata\(dq: \(dq4491\(dq
            },
            {
                \(dqname\(dq: \(dqtftp\-servers\(dq,
                \(dqspace\(dq: \(dqvendor\-4491\(dq,
                \(dqdata\(dq: \(dq10.1.1.202,10.1.1.203\(dq
            }
            ]
        }
        ],
        ...
    }
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
گزینه‌های تعریف‌شده در سطح میزبان بالاترین اولویت را دارند. به عبارت دیگر،
اگر گزینه‌هایی با نوع یکسان در سطوح سراسری، زیرشبکه،
کلاس و میزبان تعریف شده باشند، مقادیر ویژهٔ میزبان استفاده می‌شوند.
.SS رزرو Next Server، Server Hostname و Boot File Name
.sp
پیام‌های BOOTP/DHCPv4 شامل فیلدهای \(dqsiaddr\(dq، \(dqsname\(dq و \(dqfile\(dq هستند. اگرچه
DHCPv4 شامل گزینه‌های متناظر مانند گزینهٔ ۶۶ و
گزینهٔ ۶۷ است، اما ممکن است برخی کلاینت‌ها از این گزینه‌ها پشتیبانی نکنند. به همین دلیل،
مدیران سرور اغلب به جای آن از فیلدهای \(dqsiaddr\(dq، \(dqsname\(dq و \(dqfile\(dq
استفاده می‌کنند.
.sp
با Kea، انجام رزروهای ایستا برای این فیلدهای پیام DHCPv4
امکان‌پذیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqsubnet4\(dq: [
    {
        \(dqreservations\(dq: [
        {
            \(dqhw\-address\(dq: \(dqaa:bb:cc:dd:ee:ff\(dq,
            \(dqnext\-server\(dq: \(dq10.1.1.2\(dq,
            \(dqserver\-hostname\(dq: \(dqserver\-hostname.example.org\(dq,
            \(dqboot\-file\-name\(dq: \(dq/usr/local/share/kea/bootfile.efi\(dq
        }
        ],
        ...
    }
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
توجه داشته باشید که این پارامترها را می‌توان در ترکیب با سایر
پارامترها برای یک رزرو مشخص کرد، مانند یک نشانی IPv4 رزروشده. این
پارامترها اختیاری هستند؛ می‌توان زیرمجموعه‌ای از آن‌ها را مشخص کرد یا تمام
آن‌ها را نادیده گرفت.
.SS رزرو کلاس‌های کلاینت در DHCPv4
.sp
بخش Using Expressions in Classification \%<#\:classification-using-expressions> نحوهٔ پیکربندی
سرور را برای تخصیص کلاس‌ها به یک کلاینت، بر اساس محتوای
گزینه‌هایی که آن کلاینت به سرور ارسال می‌کند، توضیح می‌دهد. سازوکارهای رزرو میزبان
همچنین امکان تخصیص ایستای کلاس‌ها به کلاینت‌ها را فراهم می‌کنند.
تعاریف این کلاس‌ها در فایل پیکربندی Kea یا
یک پایگاه داده قرار می‌گیرد. قطعه‌پیکربندی زیر نحوهٔ تعیین تعلق یک
کلاینت به کلاس‌های \fBreserved\-class1\fP و \fBreserved\-class2\fP را نشان می‌دهد. این
کلاس‌ها با گزینه‌های خاصی که به کلاینت‌های متعلق به آن‌ها ارسال می‌شود، مرتبط
هستند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqclient\-classes\(dq: [
    {
       \(dqname\(dq: \(dqreserved\-class1\(dq,
       \(dqoption\-data\(dq: [
       {
           \(dqname\(dq: \(dqrouters\(dq,
           \(dqdata\(dq: \(dq10.0.0.200\(dq
       }
       ]
    },
    {
       \(dqname\(dq: \(dqreserved\-class2\(dq,
       \(dqoption\-data\(dq: [
       {
           \(dqname\(dq: \(dqdomain\-name\-servers\(dq,
           \(dqdata\(dq: \(dq10.0.0.201\(dq
       }
       ]
    }
    ],
    \(dqsubnet4\(dq: [
    {
        \(dqid\(dq: 1,
        \(dqsubnet\(dq: \(dq10.0.0.0/24\(dq,
        \(dqpools\(dq: [ { \(dqpool\(dq: \(dq10.0.0.10\-10.0.0.100\(dq } ],
        \(dqreservations\(dq: [
        {
            \(dqhw\-address\(dq: \(dqaa:bb:cc:dd:ee:ff\(dq,

            \(dqclient\-classes\(dq: [ \(dqreserved\-class1\(dq, \(dqreserved\-class2\(dq ]

        }
        ]
    }
    ]
 }
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
کلاس‌های فهرست‌شده در فهرست \fBclient\-classes\fP یک رزرو، بدون قید و شرط
به کلاینتِ آن رزرو اختصاص داده می‌شوند، چه آن کلاس‌ها حاوی یک عبارت
آزمون باشند و چه نباشند. برای جلوگیری از سردرگمی، پیشنهاد می‌شود که
کلاس‌های کلاینتی که صرفاً از طریق رزروهای میزبان تخصیص می‌یابند، فاقد عبارت‌های
آزمون باشند.
.UNINDENT
.UNINDENT
.sp
در برخی موارد می‌توان رزروهای میزبان را در ارتباط با کلاس‌های کلاینت
مشخص‌شده در پیکربندی Kea استفاده کرد. به‌ویژه، هنگامی که یک
رزرو میزبان برای یک کلاینت در یک زیرشبکهٔ معین وجود دارد، کلاس
توکار \(dqKNOWN\(dq به کلاینت اختصاص می‌یابد. در مقابل، هنگامی که هیچ
تخصیص ایستایی برای کلاینت وجود ندارد، کلاس \(dqUNKNOWN\(dq به
کلاینت اختصاص داده می‌شود. عبارت‌های کلاسی در فایل پیکربندی Kea می‌توانند
با استفاده از عملگر \(dqmember\(dq به کلاس‌های \(dqKNOWN\(dq یا \(dqUNKNOWN\(dq ارجاع دهند.
برای مثال:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqclient\-classes\(dq: [
        {
            \(dqname\(dq: \(dqdependent\-class\(dq,
            \(dqtest\(dq: \(dqmember(\(aqKNOWN\(aq)\(dq,
            \(dqonly\-in\-additional\-list\(dq: true
        }
    ]
}
.EE
.UNINDENT
.UNINDENT
.sp
پارامتر \fBonly\-in\-additional\-list\fP در اینجا برای اجبار به ارزیابی
کلاس پس از تخصیص اجاره لازم است، تا کلاس رزروشده
نیز تخصیص یافته باشد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
کلاس‌های مشخص‌شده در رزروهای میزبان غیرسراسری،
پس از ارزیابی تمام کلاس‌هایی که پارامتر
\fBonly\-in\-additional\-list\fP آن‌ها روی \fBfalse\fP تنظیم شده است، به بستهٔ پردازش‌شده تخصیص می‌یابند.
این بدان معناست که این کلاس‌ها نباید به
کلاس‌های تخصیص‌یافتهٔ ایستا از طریق رزروهای میزبان وابسته باشند. اگر
چنین وابستگی‌ای نیاز باشد، پارامتر \fBonly\-in\-additional\-list\fP برای
کلاس‌های وابسته باید روی \fBtrue\fP تنظیم شود. این کلاس‌ها
پس از اختصاص کلاس‌های ایستا به بسته، ارزیابی می‌شوند.
با این حال، این امر بار پیکربندی اضافی تحمیل می‌کند، زیرا
تمام کلاس‌هایی که با \fBonly\-in\-additional\-list\fP مشخص شده‌اند باید در فهرست
\fBevaluate\-additional\-classes\fP برای هر زیرشبکه‌ای که در آن استفاده می‌شوند، ذکر شوند.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
کلاس‌های کلاینت مشخص‌شده در فایل پیکربندی Kea ممکن است
به کلاس‌های مشخص‌شده در رزروهای سراسری میزبان وابسته باشند.
در چنین حالتی به پارامتر \fBonly\-in\-additional\-list\fP نیازی نیست.
برای موارد کاربرد خاص به بخش‌های Pool Selection with Client Class Reservations و
Subnet Selection with Client Class Reservations
مراجعه کنید.
.UNINDENT
.UNINDENT.SS ذخیره‌سازی رزروهای میزبان در MySQL یا PostgreSQL
.sp
کارساز Kea می‌تواند رزروهای میزبان را در MySQL یا PostgreSQL ذخیره کند.
برای کسب اطلاعات در مورد نحوه پیکربندی Kea جهت استفاده از رزروهای ذخیره‌شده در MySQL یا PostgreSQL، بخش Hosts Storage را ببینید.
کارساز Kea یک قلاب (hook) اختصاصی برای مدیریت رزروها در پایگاه داده ارائه می‌دهد؛ بخش libdhcp_host_cmds.so: Host Commands \%<#\:hooks-host-cmds> اطلاعات دقیقی را ارائه می‌کند.
ویکی Kea در \%<https://\:gitlab\:.isc\:.org/\:isc-projects/\:kea/\:-/\:wikis/\:Designs/\:commands#\:23-host-reservations-hr-management>
نمونه‌هایی از نحوه انجام عملیات‌های معمول رزرو میزبان ارائه می‌دهد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
در Kea، حداکثر طول گزینه‌ای که به ازای هر رزرو میزبان (per\-host\-reservation) مشخص می‌شود، به‌طور قراردادی بر روی ۴۰۹۶ بایت تنظیم شده است.
.UNINDENT
.UNINDENT
.SS تنظیم دقیق رزرو میزبان در DHCPv4
.sp
قابلیت رزرو میزبان محدودیت‌های بیشتری را برای موتور تخصیص (بخشی از Kea که آدرسی را برای یک کلاینت انتخاب می‌کند) هنگام انتخاب و تمدید اجاره (lease) اعمال می‌کند. به‌ویژه، سه بررسی عمده ضروری است. نخست، هنگام انتخاب یک اجاره جدید، کافی نیست که اجاره کاندید صرفاً توسط کلاینت DHCP دیگری در حال استفاده نباشد؛ بلکه نباید برای کلاینت دیگری نیز رزرو شده باشد. به همین ترتیب، هنگام تمدید یک اجاره، باید بررسی دیگری انجام شود تا مشخص گردد آیا آدرسی که تمدید می‌شود برای کلاینت دیگری رزرو شده است یا خیر. در نهایت، هنگامی که یک میزبان آدرسی را تمدید می‌کند، کارساز باید بررسی کند که آیا رزروی برای این میزبان وجود دارد یا خیر؛ وجود رزرو به این معنا خواهد بود که آدرس فعلی (که به‌صورت پویا تخصیص یافته) باید لغو شده و آدرس رزروشده به جای آن استفاده شود.
.sp
برخی از این بررسی‌ها ممکن است در برخی استقرارها غیرضروری باشند و عدم انجام آن‌ها می‌تواند عملکرد را بهبود بخشد. کارساز Kea پارامترهای پیکربندی \fBreservations\-global\fP، \fBreservations\-in\-subnet\fP و \fBreservations\-out\-of\-pool\fP را برای انتخاب انواع رزروهای مجاز برای یک زیرشبکه خاص ارائه می‌دهد. هر نوع رزرو محدودیت‌های متفاوتی برای بررسی‌هایی دارد که باید توسط کارساز هنگام تخصیص یا تمدید اجاره برای کلاینت انجام شوند.
.sp
پرچم‌های پیکربندی عبارتند از:
.INDENT 0.0
.IP \(bu 2
\fBreservations\-in\-subnet\fP \- هنگامی که روی \fBtrue\fP تنظیم شود، انواع رزرو میزبان درون استخر (in\-pool) را فعال می‌کند. این تنظیم مقدار پیش‌فرض بوده و امن‌ترین و انعطاف‌پذیرترین حالت است. با این حال، از آنجا که تمام بررسی‌ها انجام می‌شوند، کندترین حالت نیز هست. این پرچم بررسی در برابر رزروهای سراسری را انجام نمی‌دهد. مقدار پیش‌فرض این پرچم \fBtrue\fP است\&.
.IP \(bu 2
\fBreservations\-out\-of\-pool\fP \- هنگامی که روی \fBtrue\fP تنظیم شود، فقط رزروهای میزبان خارج از استخر (out\-of\-pool) را مجاز می‌کند. در این حالت کارساز فرض می‌کند که تمام رزروهای میزبان برای آدرس‌هایی هستند که به استخر پویا تعلق ندارند. بنابراین، می‌تواند بررسی‌های رزرو را هنگام سروکار داشتن با آدرس‌های درون استخر نادیده بگیرد و بدین ترتیب عملکرد را بهبود بخشد. در صورتی که هر یک از رزروها از آدرس‌های درون استخر استفاده می‌کنند از این حالت استفاده نکنید. هنگام استفاده از این تنظیم احتیاط توصیه می‌شود؛ Kea صحت رزروها را در برابر \fBreservations\-out\-of\-pool\fP بررسی نمی‌کند و پیکربندی نادرست ممکن است مشکلاتی ایجاد کند. مقدار پیش‌فرض این پرچم \fBfalse\fP است\&.
.IP \(bu 2
\fBreservations\-global\fP \- رزروهای سراسری میزبان را مجاز می‌کند. با این تنظیم، کارساز رزروهای مربوط به یک کلاینت را در میان رزروهای سراسری تعریف‌شده جستجو می‌کند. در صورت مشخص بودن یک آدرس، کارساز بررسی‌های رزرو انجام‌شده در حالت‌های دیگر را نادیده می‌گیرد و بنابراین کارایی را بهبود می‌بخشد. هنگام استفاده از این تنظیم احتیاط توصیه می‌شود؛ Kea در صورتی که \fBreservations\-global\fP روی \fBtrue\fP تنظیم شده باشد، صحت رزروها را بررسی نمی‌کند و پیکربندی نادرست ممکن است مشکلاتی به وجود آورد. مقدار پیش‌فرض این پرچم \fBfalse\fP است\&.
.UNINDENT
.INDENT 0.0
.TP
.B نکته: تنظیم تمام پرچم‌ها روی \fBfalse\fP پشتیبانی از رزرو میزبان را غیرفعال می‌کند.
از آنجا که هیچ رزروی وجود ندارد، کارساز تمام بررسی‌ها را نادیده می‌گیرد. هر رزرو تعریف‌شده‌ای کاملاً نادیده گرفته می‌شود. از آنجا که بررسی‌ها نادیده گرفته می‌شوند، کارساز ممکن است در این حالت سریع‌تر کار کند.
.UNINDENT
.sp
از Kea 1.9.1 به بعد پرچم‌های \fBreservations\-global\fP، \fBreservations\-in\-subnet\fP و \fBreservations\-out\-of\-pool\fP پشتیبانی می‌شوند.
.sp
پارامترهای \fBreservations\-global\fP، \fBreservations\-in\-subnet\fP و \fBreservations\-out\-of\-pool\fP می‌توانند در سطوح زیر مشخص شوند:
.INDENT 0.0
.IP \(bu 2
سطح سراسری (global): \fB\&.Dhcp4[\(dqreservations\-global\(dq]\fP (پایین‌ترین اولویت: توسط سایر سطوح رونویسی می‌شود)
.IP \(bu 2
سطح زیرشبکه (subnet): \fB\&.Dhcp4.subnet4[][\(dqreservations\-in\-subnet\(dq]\fP (اولویت پایین)
.IP \(bu 2
سطح شبکه مشترک (shared\-network): \fB\&.Dhcp4[\(dqshared\-networks\(dq][][\(dqreservations\-out\-of\-pool\(dq]\fP (اولویت بالا)
.IP \(bu 2
سطح زیرشبکه در شبکه مشترک (shared\-network subnet):
\fB\&.Dhcp4[\(dqshared\-networks\(dq][].subnet4[][\(dqreservations\-out\-of\-pool\(dq]\fP (بالاترین اولویت: سایر سطوح را رونویسی می‌کند)
.UNINDENT
.sp
برای تصمیم‌گیری در مورد استفاده از پرچم‌ها، نمودار تصمیم‌گیری زیر می‌تواند مفید باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
                              O
                              |
                              v
+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
|         Is per\-host configuration needed, such as          |
|                reserving specific addresses,               |
|               assigning specific options or                |
| assigning packets to specific classes on per\-device basis? |
+\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
  |                 |
no|              yes|
  |                 |   +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
  |                 |   |         For all given hosts,         |
  +\-\-> \(dqdisabled\(dq   +\-\->+      can the reserved resources      |
                        |  be used in all configured subnets?  |
                        +\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-+
                                 |                           |
+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+   |no                         |yes
|             Is             |   |                           |
|  at least one reservation  +<\-\-+               \(dqglobal\(dq <\-\-+
| used to reserve addresses? |
+\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-+
  |                        |
no|                     yes|   +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
  |                        |   | Is high leases\-per\-second |
  +\-\-> \(dqout\-of\-pool\(dq       +\-\->+ performance or efficient  |
        ^                      |      resource usage       |
        |                      |  (CPU ticks, RAM usage,   |
        |                      |   database roundtrips)    |
        |                      | important to your setup?  |
        |                      +\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-+
        |                        |                |
        |                     yes|              no|
        |                        |                |
        |          +\-\-\-\-\-\-\-\-\-\-\-\-\-+                |
        |          |                              |
        |          |   +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+   |
        |          |   | Can it be guaranteed |   |
        |          +\-\->+  that the reserved   |   |
        |              |      addresses       |   |
        |              |  aren\(aqt part of the  |   |
        |              |   pools configured   |   |
        |              |  in the respective   |   |
        |              |       subnet?        |   |
        |              +\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-+   |
        |                |                  |     |
        |             yes|                no|     |
        |                |                  |     V
        +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+                  +\-\-> \(dqin\-subnet\(dq
.EE
.UNINDENT
.UNINDENT
.sp
نمونه‌ای از پیکربندی که رزروها را غیرفعال می‌کند به صورت زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp4\(dq: {
    \(dqsubnet4\(dq: [
      {
        \(dqid\(dq: 1,
        \(dqpools\(dq: [
          {
            \(dqpool\(dq: \(dq192.0.2.10\-192.0.2.100\(dq
          }
        ],
        \(dqreservations\-global\(dq: false,
        \(dqreservations\-in\-subnet\(dq: false,
        \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq
      }
    ]
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
یک نمونه پیکربندی با استفاده از رزروهای سراسری در زیر نشان داده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp4\(dq: {
    \(dqreservations\-global\(dq: true,
    \(dqreservations\(dq: [
      {
        \(dqhostname\(dq: \(dqhost\-one\(dq,
        \(dqhw\-address\(dq: \(dq01:bb:cc:dd:ee:ff\(dq
      },
      {
        \(dqhostname\(dq: \(dqhost\-two\(dq,
        \(dqhw\-address\(dq: \(dq02:bb:cc:dd:ee:ff\(dq
      }
    ],
    \(dqsubnet4\(dq: [
      {
        \(dqid\(dq: 1,
        \(dqpools\(dq: [
          {
            \(dqpool\(dq: \(dq192.0.2.10\-192.0.2.100\(dq
          }
        ],
        \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq
      }
    ]
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
معنای پرچم‌های رزرو عبارتند از:
.INDENT 0.0.IP \(bu 2
\fBreservations\-global\fP: واکشی رزروهای سراسری.
.IP \(bu 2
\fBreservations\-in\-subnet\fP: واکشی رزروهای زیرشبکه. برای یک شبکهٔ اشتراکی
این شامل تمامی زیرشبکه‌های عضو آن شبکهٔ اشتراکی می‌شود.
.IP \(bu 2
\fBreservations\-out\-of\-pool\fP: این گزینه تنها زمانی کاربرد دارد که
پرچم \fBreservations\-in\-subnet\fP برابر با \fBtrue\fP باشد\&. هنگامی که \fBreservations\-out\-of\-pool\fP
برابر با \fBtrue\fP باشد، کارساز فرض می‌کند که تمامی رزروهای میزبان برای نشانی‌هایی هستند
که به استخر پویا تعلق ندارند. بنابراین، می‌تواند هنگام سروکار داشتن با نشانی‌های
درون استخر از بررسی‌های رزرو صرف‌نظر کرده و بدین‌صورت کارایی را بهبود بخشد.
کارساز نشانی‌های رزروشده‌ای را که درون استخرهای پویا قرار دارند به کلاینت‌های مربوطه
اختصاص نخواهد داد. این همچنین بدان معناست که نشانی‌های منطبق بر رزروهای مربوطه از درون
استخرهای پویا (در صورت وجود) می‌توانند به‌طور پویا به هر کلاینتی اختصاص یابند.
.UNINDENT
.sp
پیکربندی \fBdisabled\fP معادل است با:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp4\(dq: {
    \(dqreservations\-global\(dq: false,
    \(dqreservations\-in\-subnet\(dq: false
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
پیکربندی \fBglobal\fP با استفاده از \fBreservations\-global\fP معادل است با:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp4\(dq: {
    \(dqreservations\-global\(dq: true,
    \(dqreservations\-in\-subnet\(dq: false
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
پیکربندی \fBout\-of\-pool\fP با استفاده از \fBreservations\-out\-of\-pool\fP معادل است با:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp4\(dq: {
    \(dqreservations\-global\(dq: false,
    \(dqreservations\-in\-subnet\(dq: true,
    \(dqreservations\-out\-of\-pool\(dq: true
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
و پیکربندی \fBin\-subnet\fP با استفاده از \fBreservations\-in\-subnet\fP معادل است با:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp4\(dq: {
    \(dqreservations\-global\(dq: false,
    \(dqreservations\-in\-subnet\(dq: true,
    \(dqreservations\-out\-of\-pool\(dq: false
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
برای فعال‌سازی هم‌زمان \fBglobal\fP و \fBin\-subnet\fP، می‌توان از ترکیب زیر استفاده کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp4\(dq: {
    \(dqreservations\-global\(dq: true,
    \(dqreservations\-in\-subnet\(dq: true,
    \(dqreservations\-out\-of\-pool\(dq: false
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
برای فعال‌سازی هم‌زمان \fBglobal\fP و \fBout\-of\-pool\fP، می‌توان از ترکیب زیر
استفاده کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp4\(dq: {
    \(dqreservations\-global\(dq: true,
    \(dqreservations\-in\-subnet\(dq: true,
    \(dqreservations\-out\-of\-pool\(dq: true
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
فعال کردن \fBout\-of\-pool\fP و غیرفعال کردن \fBin\-subnet\fP به‌طور هم‌زمان
پیشنهاد نمی‌شود؛ زیرا \fBout\-of\-pool\fP بر رزروهای میزبان در یک زیرشبکه اعمال
می‌شود که تنها زمانی واکشی می‌شوند که پرچم \fBin\-subnet\fP برابر با \fBtrue\fP باشد\&.
.sp
این پارامتر می‌تواند در سطوح سراسری (global)، زیرشبکه (subnet) و شبکهٔ اشتراکی (shared\-network)
مشخص شود.
.sp
یک نمونه پیکربندی که رزروها را غیرفعال می‌کند به شرح زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp4\(dq: {
    \(dqsubnet4\(dq: [
      {
        \(dqreservations\-global\(dq: false,
        \(dqreservations\-in\-subnet\(dq: false,
        \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
        \(dqid\(dq: 1
      }
    ]
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
یک نمونه پیکربندی با استفاده از رزروهای سراسری در زیر نشان داده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp4\(dq: {
    \(dqreservations\(dq: [
      {
        \(dqhostname\(dq: \(dqhost\-one\(dq,
        \(dqhw\-address\(dq: \(dq01:bb:cc:dd:ee:ff\(dq
      },
      {
        \(dqhostname\(dq: \(dqhost\-two\(dq,
        \(dqhw\-address\(dq: \(dq02:bb:cc:dd:ee:ff\(dq
      }
    ],
    \(dqreservations\-global\(dq: true,
    \(dqreservations\-in\-subnet\(dq: false,
    \(dqsubnet4\(dq: [
      {
        \(dqpools\(dq: [
          {
            \(dqpool\(dq: \(dq192.0.2.10\-192.0.2.100\(dq
          }
        ],
        \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
        \(dqid\(dq: 1
      }
    ]
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
برای جزئیات بیشتر در رابطه با رزروهای سراسری، به Global Reservations in DHCPv4 مراجعه کنید\&.
.sp
جنبهٔ دیگری از رزروهای میزبان، انواع مختلف شناسه‌ها است. Kea در حال حاضر از چهار نوع شناسه
پشتیبانی می‌کند:
\fBhw\-address\fP، \fBduid\fP، \fBclient\-id\fP و \fBcircuit\-id\fP\&. این قابلیت از دیدگاه
کاربردپذیری سودمند است؛ با این حال، یک ایراد به همراه دارد. به ازای هر بستهٔ دریافتی،
Kea باید هر نوع شناسه را استخراج کرده و سپس پایگاه‌داده را پرس‌وجو کند تا مشخص شود
آیا رزروی با این شناسهٔ مشخص وجود دارد یا خیر. اگر موردی یافت نشود، شناسهٔ بعدی استخراج شده
و پرس‌وجوی بعدی ارسال می‌شود. این فرآیند تا زمانی که رزروی پیدا شود یا تمامی انواع
شناسه‌ها بررسی شوند ادامه می‌یابد. به مرور زمان و با افزایش تعداد انواع شناسه‌های
پشتیبانی‌شده، Kea کندتر و کندتر خواهد شد.
.sp
برای برطرف کردن این مشکل، پارامتری با عنوان
\fBhost\-reservation\-identifiers\fP ارائه شده است. این پارامتر فهرستی از
انواع شناسه را دریافت می‌کند. Kea تنها آن دسته از انواع شناسه را بررسی می‌کند
که در \fBhost\-reservation\-identifiers\fP برشمرده شده‌اند\&. از دیدگاه عملکرد،
تعداد انواع شناسه باید در کمترین حد ممکن، ترجیحاً یک مورد، نگه داشته شود.
اگر محیط شما از چندین نوع رزرو استفاده می‌کند، لطفاً آن‌ها را از پرکاربردترین
به کم‌کاربردترین فهرست کنید؛ زیرا این کار احتمال یافتن رزرو توسط Kea با کمترین
تعداد پرس‌وجو را بالا می‌برد. یک نمونه از پیکربندی \fBhost\-reservation\-identifiers\fP
به صورت زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
\(dqhost\-reservation\-identifiers\(dq: [ \(dqcircuit\-id\(dq, \(dqhw\-address\(dq, \(dqduid\(dq, \(dqclient\-id\(dq ],
\(dqsubnet4\(dq: [
    {
        \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
        ...
    }
],
\&...
}
.EE
.UNINDENT
.UNINDENT
.sp
در صورت عدم تعیین، مقدار پیش‌فرض به شرح زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqhost\-reservation\-identifiers\(dq: [ \(dqhw\-address\(dq, \(dqduid\(dq, \(dqcircuit\-id\(dq, \(dqclient\-id\(dq ]
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
به محض یافتن یک رزرو میزبان، جستجو متوقف می‌شود؛
هنگامی که یک کلاینت دارای دو رزرو میزبان با استفاده از انواع مختلفی از شناسه‌های فعال باشد،
همیشه نخستین مورد بازگردانده شده و مورد دوم نادیده گرفته می‌شود. به عبارت دیگر،
این حالت معمولاً یک خطای پیکربندی محسوب می‌شود. در موارد نادری که داشتن دو رزرو
برای یک میزبان منطقی باشد، رزروی که باید استفاده شود را می‌توان با مرتب‌سازی
فهرست انواع شناسه‌ها در \fBhost\-reservation\-identifiers\fP تعیین کرد\&.
.UNINDENT
.UNINDENT.SS "رزروهای سراسری در DHCPv4"
.sp
در برخی پیاده‌سازی‌ها، مانند شبکه‌های تلفن همراه، کلاینت‌ها می‌توانند درون شبکه جابه‌جا شوند (roam کنند) و برخی پارامترها باید بدون در نظر گرفتن مکان فعلی کلاینت مشخص شوند. برای برآورده ساختن چنین نیازی، Kea سازوکار رزرو سراسری (global reservation) را ارائه می‌دهد. ایدهٔ نهفته در این سازوکار این است که رزروهای معمول میزبان با استفاده از یک subnet ID مشخص، به زیرشبکه‌های خاصی وابسته هستند. Kea می‌تواند رزروی سراسری تعیین کند که در تمام زیرشبکه‌های دارای رزرو سراسریِ فعال، قابل استفاده باشد.
.sp
از این ویژگی می‌توان برای تخصیص پارامترهای مشخصی مانند hostname یا دیگر گزینه‌های اختصاصی و ویژهٔ میزبان استفاده کرد. همچنین می‌توان از آن برای تخصیص آدرس‌ها نیز بهره برد.
.sp
آدرسی که از طریق رزرو سراسری میزبان تخصیص می‌یابد باید برای زیرشبکه‌ای که سرور برای کلاینت انتخاب می‌کند، امکان‌پذیر (feasible) باشد. به عبارت دیگر، آدرس باید در محدودهٔ زیرشبکه قرار داشته باشد؛ در غیر این صورت، نادیده گرفته می‌شود و سرور تلاش خواهد کرد تا آدرسی را به‌صورت پویا تخصیص دهد. اگر زیرشبکهٔ انتخاب‌شده به یک shared network تعلق داشته باشد، سرور امکان‌پذیر بودن را در مقایسه با زیرشبکه‌های هم‌ردیف (siblings) بررسی کرده و نخستین زیرشبکهٔ در محدوده را انتخاب می‌نماید. اگر چنین زیرشبکه‌ای وجود نداشته باشد، سرور به تخصیص پویای آدرس بازمی‌گردد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
پیش از نسخهٔ 2.3.5، سرور بررسی‌های امکان‌پذیری را روی آدرس‌های رزروشده به‌صورت سراسری انجام نمی‌داد، که این امر اجازه می‌داد سرور به گونه‌ای پیکربندی شود که اجاره‌های (leases) بی‌معنی برای مقادیر دلخواه آدرس صادر کند. نسخه‌های بعدی Kea این بررسی‌ها را انجام می‌دهند.
.UNINDENT
.UNINDENT
.sp
برای استفاده از رزروهای سراسری میزبان، می‌توان از پیکربندی مشابه زیر استفاده کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    # This specifies global reservations.
    # They will apply to all subnets that
    # have global reservations enabled.

    \(dqreservations\(dq: [
    {
       \(dqhw\-address\(dq: \(dqaa:bb:cc:dd:ee:ff\(dq,
       \(dqhostname\(dq: \(dqhw\-host\-dynamic\(dq
    },
    {
       \(dqhw\-address\(dq: \(dq01:02:03:04:05:06\(dq,
       \(dqhostname\(dq: \(dqhw\-host\-fixed\(dq,

       # Use of IP addresses in global reservations is risky.
       # If used outside of a matching subnet, such as 192.0.1.0/24,
       # it will result in a broken configuration being handed
       # to the client.
       \(dqip\-address\(dq: \(dq192.0.1.77\(dq
    },
    {
       \(dqduid\(dq: \(dq01:02:03:04:05\(dq,
       \(dqhostname\(dq: \(dqduid\-host\(dq
    },
    {
       \(dqcircuit\-id\(dq: \(dq\(aqcharter950\(aq\(dq,
       \(dqhostname\(dq: \(dqcircuit\-id\-host\(dq
    },
    {
       \(dqclient\-id\(dq: \(dq01:11:22:33:44:55:66\(dq,
       \(dqhostname\(dq: \(dqclient\-id\-host\(dq
    }
    ],
    \(dqvalid\-lifetime\(dq: 600,
    \(dqsubnet4\(dq: [
    {
        \(dqid\(dq: 1,
        \(dqsubnet\(dq: \(dq10.0.0.0/24\(dq,
        # Specify if the server should look up global reservations.
        \(dqreservations\-global\(dq: true,
        # Specify if the server should look up in\-subnet reservations.
        \(dqreservations\-in\-subnet\(dq: false,
        # Specify if the server can assume that all reserved addresses
        # are out\-of\-pool. It can be ignored because \(dqreservations\-in\-subnet\(dq
        # is false.
        # \(dqreservations\-out\-of\-pool\(dq: false,
        \(dqpools\(dq: [ { \(dqpool\(dq: \(dq10.0.0.10\-10.0.0.100\(dq } ]
    }
    ]
}
.EE
.UNINDENT
.UNINDENT
.sp
هنگام استفاده از backendهای پایگاه‌داده، رزروهای سراسری میزبان با استفاده از مقدار 0 برای \fBsubnet\-id\fP از رزروهای عادی متمایز می‌شوند.
.SS "انتخاب استخر با رزروهای کلاس کلاینت"
.sp
کلاس‌های کلاینت (Client classes) می‌توانند در فایل پیکربندی Kea و/یا از طریق رزروهای میزبان تعیین شوند. کلاس‌های مشخص‌شده در فایل پیکربندی Kea بلافاصله پس از دریافت بستهٔ DHCP ارزیابی می‌شوند و بنابراین می‌توان از آن‌ها برای اثرگذاری بر انتخاب زیرشبکه با استفاده از پارامتر \fBclient\-classes\fP مشخص‌شده در حوزهٔ (scope) زیرشبکه استفاده کرد. کلاس‌های مشخص‌شده درون رزروهای میزبان، پس از آن‌که سرور زیرشبکه‌ای را برای کلاینت انتخاب کرد، واکشی شده و به بسته اختصاص می‌یابند. این بدان معناست که کلاس کلاینت مشخص‌شده درون یک رزرو میزبان نمی‌تواند برای تأثیرگذاری بر تخصیص زیرشبکه به این کلاینت استفاده شود، مگر اینکه زیرشبکه متعلق به یک shared network باشد. اگر زیرشبکه متعلق به یک shared network باشد، ممکن است سرور هنگام تلاش برای تخصیص اجاره (lease)، تخصیص زیرشبکه را به‌صورت پویا تغییر دهد. اگر زیرشبکه به یک shared network تعلق نداشته باشد، زیرشبکه پس از یک‌بار انتخاب شدن، دیگر تغییر نخواهد کرد.
.sp
اگر زیرشبکه متعلق به یک shared network نباشد، می‌توان از دسته‌بندی کلاینت مبتنی بر رزرو میزبان برای انتخاب یک استخر (pool) در زیرشبکه، به شرح زیر استفاده کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqDhcp4\(dq: {
        \(dqclient\-classes\(dq: [
            {
                \(dqname\(dq: \(dqreserved_class\(dq
            },
            {
                \(dqname\(dq: \(dqunreserved_class\(dq,
                \(dqtest\(dq: \(dqnot member(\(aqreserved_class\(aq)\(dq
            }
        ],
        \(dqsubnet4\(dq: [
            {
                \(dqid\(dq: 1,
                \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
                \(dqreservations\(dq: [
                    {
                        \(dqhw\-address\(dq: \(dqaa:bb:cc:dd:ee:fe\(dq,
                        \(dqclient\-classes\(dq: [ \(dqunreserved_class\(dq ]
                    }
                ],
                \(dqpools\(dq: [
                    {
                        \(dqpool\(dq: \(dq192.0.2.10 \- 192.0.2.20\(dq,
                        \(dqclient\-classes\(dq: [ \(dqunreserved_class\(dq ]
                    },
                    {
                        \(dqpool\(dq: \(dq192.0.2.30 \- 192.0.2.40\(dq,
                        \(dqclient\-classes\(dq: [ \(dqreserved_class\(dq ]
                    },
                    {
                        \(dqpool\(dq: \(dq192.0.2.50 \- 192.0.2.60\(dq
                    }
                ]
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
کلاس \fBreserved_class\fP بدون پارامتر \fBtest\fP اعلان شده است زیرا تنها می‌تواند از طریق سازوکار رزرو میزبان به یک کلاینت اختصاص یابد. کلاس دوم، \fBunreserved_class\fP، به کلاینت‌هایی اختصاص داده می‌شود که به \fBreserved_class\fP تعلق ندارند\&.
.sp
نخستین استخر در زیرشبکه برای کلاینت‌هایی استفاده می‌شود که چنین رزروی ندارند. استخر دوم تنها برای کلاینت‌هایی استفاده می‌شود که دارای رزروی برای \fBreserved_class\fP هستند\&. استخر سوم یک استخر بدون محدودیت برای همهٔ کلاینت‌هاست که شامل کلاینت‌های هر دو دستهٔ \fBreserved_class\fP و \fBunreserved_class\fP می‌شود\&.
.sp
این قطعه‌پیکربندی شامل یک رزرو میزبان است که باعث می‌شود کلاینت با آدرس MAC معادل \fBaa:bb:cc:dd:ee:fe\fP به \fBreserved_class\fP اختصاص یابد\&. بدین ترتیب، به این کلاینت یک آدرس IP از دومین استخر آدرس اختصاص داده می‌شود.
.sp
رزروهای تعریف‌شده در زیرشبکه‌ای که متعلق به یک shared network است، برای کلاینتی که در غیر این صورت با آن منطبق می‌بود قابل مشاهده نیستند؛ بنابراین نمی‌توان از آن‌ها برای انتخاب استخرها و همچنین زیرشبکه‌ها استفاده کرد..SS انتخاب زیرشبکه با رزروهای کلاس کلاینت (Subnet Selection with Client Class Reservations)
.sp
یک مورد کاربرد خاص وجود دارد که در آن انتخاب زیرشبکه ممکن است تحت تأثیر
کلاس‌های کلاینت مشخص‌شده درون رزروهای میزبان قرار گیرد: زمانی که
کلاینت به یک شبکهٔ اشتراکی (shared network) تعلق دارد. در چنین حالتی امکان استفاده
از رده‌بندی برای انتخاب یک زیرشبکه درون این شبکهٔ اشتراکی وجود دارد. مثال
زیر را در نظر بگیرید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqDhcp4\(dq: {
        \(dqclient\-classes\(dq: [
            {
                \(dqname\(dq: \(dqreserved_class\(dq
            },
            {
                \(dqname\(dq: \(dqunreserved_class\(dq,
                \(dqtest\(dq: \(dqnot member(\(aqreserved_class\(aq)\(dq
            }
        ],
        \(dqreservations\(dq: [
            {
                \(dqhw\-address\(dq: \(dqaa:bb:cc:dd:ee:fe\(dq,
                \(dqclient\-classes\(dq: [ \(dqreserved_class\(dq ]
            }
        ],
        \(dqreservations\-global\(dq: true,
        \(dqreservations\-in\-subnet\(dq: false,
        \(dqshared\-networks\(dq: [
            {
                \(dqname\(dq: \(dqnet\(dq,
                \(dqsubnet4\(dq: [
                    {
                        \(dqid\(dq: 1,
                        \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
                        \(dqpools\(dq: [
                            {
                                \(dqpool\(dq: \(dq192.0.2.10\-192.0.2.20\(dq,
                                \(dqclient\-classes\(dq: [ \(dqunreserved_class\(dq ]
                            },
                            {
                                \(dqpool\(dq: \(dq192.0.2.30\-192.0.2.40\(dq,
                                \(dqclient\-classes\(dq: [ \(dqunreserved_class\(dq ]
                            }
                        ]
                    },
                    {
                        \(dqid\(dq: 2,
                        \(dqsubnet\(dq: \(dq192.0.3.0/24\(dq,
                        \(dqpools\(dq: [
                            {
                                \(dqpool\(dq: \(dq192.0.3.10\-192.0.3.20\(dq,
                                \(dqclient\-classes\(dq: [ \(dqreserved_class\(dq ]
                            },
                            {
                                \(dqpool\(dq: \(dq192.0.3.30\-192.0.3.40\(dq,
                                \(dqclient\-classes\(dq: [ \(dqreserved_class\(dq ]
                            }
                        ]
                    },
                    {
                        \(dqid\(dq: 3,
                        \(dqsubnet\(dq: \(dq192.0.4.0/24\(dq,
                        \(dqpools\(dq: [
                            {
                                \(dqpool\(dq: \(dq192.0.4.10\-192.0.4.20\(dq
                            },
                            {
                                \(dqpool\(dq: \(dq192.0.4.30\-192.0.4.40\(dq
                            }
                        ]
                    }
                ]
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این شبیه به مثالی است که در
Pool Selection with Client Class Reservations\& شرح داده شده است. با این حال،
این بار سه زیرشبکه وجود دارد که استخرهای (pools) دو مورد اول هر کدام با یک کلاس
متفاوت مرتبط هستند.
.sp
به کلاینت‌هایی که رزروی برای \fBreserved_class\fP ندارند، نشانی‌ای از
زیرشبکهٔ اول تخصیص داده می‌شود و هنگامی که آن پر شد، از زیرشبکهٔ سوم.
به کلاینت‌های دارای رزرو برای \fBreserved_class\fP، نشانی‌ای از زیرشبکهٔ دوم
و هنگام پر شدن آن، از زیرشبکهٔ سوم تخصیص می‌یابد.
.sp
زیرشبکه‌ها باید متعلق به یک شبکهٔ اشتراکی یکسان باشند.
.sp
برای اینکه یک زیرشبکه به یک کلاس خاص محدود شود، یا از آن صرف‌نظر گردد، تمام استخرهای
درون آن زیرشبکه باید به ترتیب توسط \fBreserved_class\fP یا \fBunreserved_class\fP
محافظت شوند.
.sp
علاوه بر این، رزرو برای کلاس کلاینت باید در حوزهٔ سراسری (رزرو سراسری) مشخص شود
و مقدار \fBreservations\-global\fP باید روی \fBtrue\fP تنظیم شده باشد\&.
.sp
در مثال بالا، پارامتر پیکربندی \fBclient\-classes\fP می‌توانست به جای سطح استخر
در سطح زیرشبکه نیز مشخص شود و همان اثر را داشته باشد.
.sp
اگر زیرشبکه‌ها خارج از شبکه‌های اشتراکی تعریف می‌شدند و \fBclient\-classes\fP در
سطح زیرشبکه مشخص می‌شد، آنگاه برای کارکرد انتخاب زیرشبکه، فعال بودن
\fBearly\-global\-reservations\-lookup\fP نیز الزامی می‌بود.
.SS رزروهای چندگانه برای یک IP یکسان (Multiple Reservations for the Same IP)
.sp
رزروهای میزبان برای جلوگیری از ایجاد چندین رزرو برای یک نشانی IP یکسان
درون یک زیرشبکهٔ خاص طراحی شده‌اند تا از رقابت دو کلاینت مختلف بر سر
یک نشانی جلوگیری شود.
هنگام استفاده از تنظیمات پیش‌فرض، اگر سرور دو یا چند رزرو برای یک نشانی IP
یکسان در یک زیرشبکه درون فایل پیکربندی Kea پیدا کند، خطای پیکربندی برمی‌گرداند.
\fBlibdhcp_host_cmds.so\fP \%<#\:std-ischooklib-libdhcp_host_cmds\:.so>
در پاسخ به دستور \fBreservation\-add\fP \%<#\:std-isccmd-reservation-add>، در صورتی که
تشخیص دهد برای نشانی IP مورد نظری که رزرو جدید برای آن افزوده می‌شود رزروی در پایگاه داده
وجود دارد، یک خطا برمی‌گرداند.
.sp
در برخی استقرارها، یک میزبان واحد می‌تواند یکی از چندین رابط شبکه را برای
برقراری ارتباط با سرور DHCP انتخاب کند، و سرور باید بدون توجه به رابطِ
استفاده‌شده، نشانی IP یکسانی را به میزبان تخصیص دهد. از آنجا که به هر رابط
یک نشانی MAC متفاوت تخصیص می‌یابد، به این معنی است که باید چندین رزرو
میزبان ایجاد شود تا تمام نشانی‌های MAC موجود در این میزبان را با نشانی‌های
IP مرتبط کند. استفاده از نشانی‌های IP مختلف برای هر رابط غیرعملی است و اتلاف
فضای نشانی IPv4 تلقی می‌شود، به‌ویژه از آنجا که میزبان معمولاً تنها از یک
رابط برای ارتباط با سرور استفاده می‌کند و بنابراین تنها یک نشانی IP در حال
استفاده است.
.sp
این امر نیاز به ایجاد چندین رزرو میزبان برای یک نشانی IP واحد درون یک
زیرشبکه را ایجاد می‌کند؛ این امکان از نسخهٔ Kea 1.9.1 به عنوان یک حالت
عملیاتی اختیاری پشتیبانی می‌شود که با پارامتر سراسری \fBip\-reservations\-unique\fP
فعال می‌گردد.
.sp
پارامتر \fBip\-reservations\-unique\fP یک پارامتر بولی (boolean) است که مقدار
پیش‌فرض آن \fBtrue\fP است و تعیین بیش از یک رزرو برای یک نشانی IP یکسان
را در یک زیرشبکهٔ مشخص ممنوع می‌کند. تنظیم این پارامتر روی \fBfalse\fP
اجازه می‌دهد تا چنین رزروهایی هم در فایل پیکربندی Kea و هم در بک‌اند پایگاه
دادهٔ میزبان، از طریق \fBlibdhcp_host_cmds.so\fP \%<#\:std-ischooklib-libdhcp_host_cmds\:.so>\& ایجاد شوند.
.sp
تنظیم \fBip\-reservations\-unique\fP روی \fBfalse\fP هنگام استفاده از memfile، MySQL یا PostgreSQL پشتیبانی می‌شود.
این تنظیم هنگام استفاده از Host Cache (نگاه کنید به libdhcp_host_cache.so: Host Cache Reservations for Improved Performance \%<#\:hooks-host-cache>) یا بک‌اند RADIUS
(نگاه کنید به libdhcp_radius.so: RADIUS Server Support \%<#\:hooks-radius>) پشتیبانی نمی‌شود. این بک‌اندهای رزرو از چندین رزرو برای
یک IP یکسان پشتیبانی نمی‌کنند؛ اگر هر یک از این قلاب‌ها (hooks) بارگذاری شده باشد و \fBip\-reservations\-unique\fP روی \fBfalse\fP تنظیم شود، آنگاه
خطای پیکربندی صادر شده و سرور راه‌اندازی نمی‌شود.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
هنگامی که \fBip\-reservations\-unique\fP روی \fBtrue\fP (مقدار پیش‌فرض) تنظیم شده باشد،
سرور تضمین می‌کند که رزروهای IP برای یک زیرشبکه درون یک بک‌اند میزبان منفرد
و/یا فایل پیکربندی Kea یکتا هستند. این کار تضمین نمی‌کند که رزروها در چندین
بک‌اند یکتا باشند. هنگام راه‌اندازی سرور، تنها رزروهای IP تعریف‌شده در فایل
پیکربندی Kea از نظر یکتایی بررسی می‌شوند.
.UNINDENT
.UNINDENT
.sp
در ادامه یک پیکربندی نمونه با دو رزرو برای یک نشانی IP یکسان اما با نشانی‌های
MAC متفاوت آورده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqip\-reservations\-unique\(dq: false,
    \(dqsubnet4\(dq: [
        {
            \(dqid\(dq: 1,
            \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
            \(dqreservations\(dq: [
                {
                    \(dqhw\-address\(dq: \(dq1a:1b:1c:1d:1e:1f\(dq,
                    \(dqip\-address\(dq: \(dq192.0.2.11\(dq
                },
                {
                    \(dqhw\-address\(dq: \(dq2a:2b:2c:2d:2e:2f\(dq,
                    \(dqip\-address\(dq: \(dq192.0.2.11\(dq
                }
            ]
        }
    ]
}
.EE
.UNINDENT
.UNINDENT
.sp
امکان کنترل پارامتر \fBip\-reservations\-unique\fP از طریق Configuration Backend
در DHCPv4 وجود دارد\&. اگر تنظیم جدید این پارامتر با بک‌اندهای فعلی مورد استفاده در تضاد باشد
(یعنی بک‌اندها از تنظیم جدید پشتیبانی نکنند)، تنظیم جدید نادیده گرفته شده و یک پیام
ثبت وقایع هشداری ایجاد می‌شود. بک‌اندها با این فرض که رزروهای IP در هر زیرشبکه
یکتا هستند، به استفاده از تنظیم پیش‌فرض ادامه می‌دهند. برای مجاز کردن ایجاد رزروهای
IP غیریکتا، مدیر سیستم باید بک‌اندهایی را که از آن‌ها پشتیبانی نمی‌کنند از فایل
پیکربندی حذف کند.
.sp
مدیران سیستم باید هنگامی که از رزروهای چندگانه برای یک نشانی IP یکسان استفاده کرده‌اند
و بعداً تصمیم می‌گیرند به حالت پیش‌فرض بازگردند (که در آن این کار دیگر مجاز نیست)،
دقت لازم را به عمل آورند. آن‌ها باید پیش از بازگشت به حالت پیش‌فرض، اطمینان حاصل
کنند که حداکثر یک رزرو برای یک نشانی IP مشخص درون یک زیرشبکه وجود دارد.
اگر چنین موارد تکراری در فایل پیکربندی باقی بمانند، سرور خطای پیکربندی گزارش می‌دهد.
باقی گذاشتن چنین رزروهایی در پایگاه‌های دادهٔ میزبان باعث خطای پیکربندی نمی‌شود، اما
ممکن است در حین کارکرد سرور هنگامی که به‌طور غیرمنتظره با چندین رزرو برای یک
نشانی IP مواجه می‌شود، منجر به خطاهای تخصیص اجاره (lease) گردد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
در حال حاضر، سرور Kea بررسی نمی‌کند که آیا با به‌روزرسانی \fBip\-reservations\-unique\fP
از \fBfalse\fP به \fBtrue\fP، چندین رزرو برای یک نشانی IP در پایگاه‌های دادهٔ میزبان
MySQL و/یا PostgreSQL وجود دارد یا خیر\&. این امر ممکن است باعث ایجاد مشکلاتی در تخصیص اجاره‌ها
شود. مدیر سیستم باید پیش از به‌روزرسانی پیکربندی اطمینان حاصل کند که برای هر
نشانی IP در هر زیرشبکه حداکثر یک رزرو وجود دارد.
.UNINDENT
.UNINDENT
.sp
پارامتر \fBreservations\-lookup\-first\fP یک پارامتر بولی است که کنترل می‌کند آیا
جستجوی رزروهای میزبان باید پیش از جستجوی اجاره (lease lookup) انجام شود یا خیر. این پارامتر
تنها زمانی تأثیرگذار است که چندریسمانی (multi\-threading) غیرفعال باشد. هنگامی که چندریسمانی
فعال باشد، جستجوی رزروهای میزبان همواره ابتدا انجام می‌شود تا از قفل شدن منابع هنگام
جستجوی اجاره جلوگیری شود. مقدار پیش‌فرض پارامتر \fBreservations\-lookup\-first\fP در زمان
غیرفعال بودن چندریسمانی، \fBfalse\fP است..SS رزرو میزبان به‌عنوان کنترل دسترسی پایه‌ای
.sp
تعریف یک رزرو میزبان (host reservation) که تنها حاوی یک شناسه، بدون هیچ آدرس، گزینه یا مقداری باشد، امکان‌پذیر است. در برخی استقرارها این کار مفید است، چرا که میزبان‌های دارای رزرو به کلاس KNOWN تعلق دارند در حالی که سایر میزبان‌ها تعلق ندارند. از این قابلیت می‌توان به‌عنوان یک سازوکار پایه‌ای کنترل دسترسی استفاده کرد.
.sp
مثال زیر این مفهوم را نشان می‌دهد. این مثال یک زیرشبکه IPv4 واحد را مشخص می‌کند که تمام کارخواه‌ها آدرسی از آن دریافت خواهند کرد. با این حال، تنها کارخواه‌های شناخته‌شده (آن‌هایی که رزرو دارند) مسیریاب پیش‌فرضشان پیکربندی خواهد شد. رزروهای خالی، یعنی رزروهایی که تنها معیار شناسایی دارند، می‌توانند به‌عنوان روشی برای شناخته‌شدن کارخواه‌ها سودمند باشند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqclient\-classes\(dq: [
        {
            \(dqname\(dq: \(dqKNOWN\(dq,
            \(dqoption\-data\(dq: [
                {
                    \(dqname\(dq: \(dqrouters\(dq,
                    \(dqdata\(dq: \(dq192.0.2.250\(dq
                }
            ]
        }
    ],
    \(dqreservations\(dq: [
        // کارخواه‌های این فهرست به کلاس KNOWN افزوده خواهند شد.
        { \(dqhw\-address\(dq: \(dqaa:bb:cc:dd:ee:fe\(dq },
        { \(dqhw\-address\(dq: \(dq11:22:33:44:55:66\(dq }
    ],
    \(dqreservations\-global\(dq: true,

    \(dqsubnet4\(dq: [
        {
            \(dqid\(dq: 1,
            \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
            \(dqpools\(dq: [
                {
                    \(dqpool\(dq: \(dq192.0.2.1\-192.0.2.200\(dq
                }
            ]
        }
    ]
}
.EE
.UNINDENT
.UNINDENT
.sp
این مفهوم را می‌توان با استفاده از رزروها در ترکیب با برچسب‌گذاری کلاسی گزینه‌ها (ببینید Option Class\-Tagging \%<#\:option-class-tagging>) فراتر نیز گسترش داد. یک سناریوی واقعی مناسب می‌تواند وضعیتی باشد که در آن برخی از مشتریان یک ISP صورت‌حساب‌های خود را پرداخت نکرده‌اند. به این مشتریان باید یک مسیریاب جایگزین اختصاص داده شود که به‌جای هدایت و بازپخش ترافیک، آن‌ها را به یک پورتال ورود (captive portal) هدایت کرده و از آن‌ها بخواهد حساب‌های خود را تسویه کنند. می‌توان از رزروها برای تخصیص یک کارخواه به کلاس \(dqblocked\(dq استفاده کرد که متعاقباً برای تعیین مقدار گزینه مسیریاب همان‌طور که در زیر نشان داده شده است، به کار می‌رود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqclient\-classes\(dq: [
        {
            \(dqname\(dq: \(dqblocked\(dq
        }
    ],
    \(dqreservations\(dq: [
        // کارخواه‌های این فهرست به کلاس KNOWN افزوده خواهند شد. برخی
        // نیز به کلاس blocked افزوده می‌شوند.
        {
          \(dqhw\-address\(dq: \(dqaa:bb:cc:dd:ee:fe\(dq,
          \(dqclient\-classes\(dq: [ \(dqblocked\(dq ]
        },
        {
            \(dqhw\-address\(dq: \(dq11:22:33:44:55:66\(dq
        }
    ],
    \(dqreservations\-global\(dq: true,

    \(dqsubnet4\(dq: [
        {
            \(dqid\(dq: 1,
            \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
            \(dqpools\(dq: [
                {
                    \(dqpool\(dq: \(dq192.0.2.1\-192.0.2.200\(dq
                }
            ],
            \(dqoption\-data\(dq: [
                {
                    // مسیریاب برای مشتریان مسدودشده.
                    \(dqclient\-classes\(dq: [ \(dqblocked\(dq ],
                    \(dqname\(dq: \(dqrouters\(dq,
                    \(dqdata\(dq: \(dq192.0.2.251\(dq
                },
                {
                    // مسیریاب برای مشتریان خوش‌حساب.
                    \(dqname\(dq: \(dqrouters\(dq,
                    \(dqdata\(dq: \(dq192.0.2.250\(dq
                }
            ]
        }
    ]
}
.EE
.UNINDENT
.UNINDENT
.SS شبکه‌های اشتراکی در DHCPv4
.sp
کارسازهای DHCP اطلاعات زیرشبکه را به دو روش به کار می‌برند. این اطلاعات هم برای تعیین نقطه اتصال، یعنی جایی که کارخواه به شبکه متصل است، و هم برای گروه‌بندی اطلاعات مربوط به یک مکان خاص در شبکه استفاده می‌شود. گاهی اوقات استقرار بیش از یک زیرشبکه منطقی IP روی یک پیوند فیزیکی یکسان مفید است. درک این‌که دو یا چند زیرشبکه روی یک پیوند یکسان استفاده می‌شوند نیازمند منطق اضافی در کارساز DHCP است. این قابلیت در Kea با عنوان \(dqشبکه‌های اشتراکی\(dq (shared networks) و گاهی نیز \(dqshared subnets\(dq نامیده می‌شود؛ در نام‌گذاری Microsoft به آن \(dqmultinet\(dq گفته می‌شود.
.sp
موارد متعددی وجود دارد که ویژگی شبکه‌های اشتراکی در آن‌ها سودمند است؛ در این‌جا تنها به چند مورد از رایج‌ترین آن‌ها اشاره می‌کنیم. نخستین و تا حد زیادی رایج‌ترین مورد استفاده، یک شبکه IPv4 موجود است که گسترش یافته و فضای آدرس در دسترس آن رو به پایان است. به‌جای مهاجرت دادن تمام دستگاه‌ها به یک زیرشبکه جدید و بزرگ‌تر، آسان‌تر است که زیرشبکه‌های اضافی روی زیرشبکه موجود پیکربندی شوند. گاهی اوقات به دلیل تکه‌تکه شدن فضای آدرس (برای نمونه هنگامی که تنها چندین /24 ناپیوسته در دسترس است)، این تنها انتخاب ممکن است. همچنین، پیکربندی زیرشبکه‌های اضافی این مزیت را دارد که در عملکرد دستگاه‌های موجود اختلالی ایجاد نمی‌کند.
.sp
یک مورد استفاده بسیار متداول دیگر به شبکه‌های کابلی مربوط می‌شود. دو نوع دستگاه در شبکه‌های کابلی وجود دارد: مودم‌های کابلی و دستگاه‌های کاربر نهایی که پشت آن‌ها قرار دارند. این یک رویه معمول است که از زیرشبکه‌های متفاوتی برای مودم‌های کابلی استفاده شود تا از دستکاری آن‌ها توسط کاربران جلوگیری به عمل آید. در این حالت، تمایز بر اساس نوع دستگاه صورت می‌گیرد و نه بر اساس اتمام فضای آدرس.
.sp
به کارخواهی که به یک شبکه اشتراکی متصل است، ممکن است آدرسی از هر یک از استخرهای تعریف‌شده در زیرشبکه‌های متعلق به آن شبکه اشتراکی اختصاص داده شود. از نظر داخلی، کارساز یکی از زیرشبکه‌های متعلق به شبکه اشتراکی را انتخاب کرده و تلاش می‌کند آدرسی را از این زیرشبکه تخصیص دهد. اگر کارساز نتواند آدرسی از زیرشبکه انتخاب‌شده تخصیص دهد (به‌عنوان مثال به دلیل اتمام استخر آدرس)، از زیرشبکه دیگری از همان شبکه اشتراکی استفاده کرده و سعی می‌کند آدرسی از آن تخصیص دهد. کارساز معمولاً پیش از شروع تخصیص آدرس از سایر زیرشبکه‌های متعلق به همان شبکه اشتراکی، تمام آدرس‌های موجود در یک زیرشبکه مفروض را تخصیص می‌دهد. با این حال، در شرایط خاص ممکن است پیش از پایان یافتن استخرهای آدرس در زیرشبکه نخست، آدرسی از زیرشبکه دیگری به کارخواه اختصاص یابد؛ این حالت گاهی زمانی رخ می‌دهد که کارخواه یک نشانه (hint) متعلق به زیرشبکه دیگری ارائه دهد، یا کارخواه دارای رزروهایی در زیرشبکه‌ای غیر از پیش‌فرض باشد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
استقرارها نباید فرض کنند که Kea پیش از تخصیص آدرس از سایر زیرشبکه‌ها، حتماً منتظر می‌ماند تا تمام آدرس‌های زیرشبکه نخست در یک شبکه اشتراکی را تخصیص دهد.
.UNINDENT
.UNINDENT
.sp
برای تعریف یک شبکه اشتراکی، یک حوزه (scope) پیکربندی اضافی معرفی شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
\(dqDhcp4\(dq: {
    \(dqshared\-networks\(dq: [
        {
            # نام شبکه اشتراکی. این می‌تواند یک رشته دلخواه باشد
            # و باید میان تمام شبکه‌های اشتراکی یکتا باشد.
            \(dqname\(dq: \(dqmy\-secret\-lair\-level\-1\(dq,

            # انتخاب‌گر زیرشبکه می‌تواند در سطح shared\-network مشخص شود.
            # زیرشبکه‌های این شبکه اشتراکی برای کارخواه‌های متصل مستقیم
            # که درخواست‌ها را به رابط \(dqeth0\(dq کارساز می‌فرستند انتخاب خواهند شد.
            \(dqinterface\(dq: \(dqeth0\(dq,

            # این بخش فهرست زیرشبکه‌ها را در این شبکه اشتراکی آغاز می‌کند.
            # در این مثال دو زیرشبکه وجود دارد.
            \(dqsubnet4\(dq: [
                {
                    \(dqid\(dq: 1,
                    \(dqsubnet\(dq: \(dq10.0.0.0/8\(dq,
                    \(dqpools\(dq: [ { \(dqpool\(dq:  \(dq10.0.0.1 \- 10.0.0.99\(dq } ]
                },
                {
                    \(dqid\(dq: 2,
                    \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
                    \(dqpools\(dq: [ { \(dqpool\(dq:  \(dq192.0.2.100 \- 192.0.2.199\(dq } ]
                }
            ]
        }
    ],
    # پایان shared\-networks

    # احتمال دارد که در شبکه ترکیبی از زیرشبکه‌های عادی،
    # \(dqساده\(dq و شبکه‌های اشتراکی وجود داشته باشد. ترکیب آن‌ها
    # در همان فایل پیکربندی کاملاً مجاز است.
    #
    # این یک زیرشبکه عادی است. بخشی از هیچ شبکه اشتراکی نیست.
    \(dqsubnet4\(dq: [
        {
            \(dqid\(dq: 3,
            \(dqsubnet\(dq: \(dq192.0.3.0/24\(dq,
            \(dqpools\(dq: [ { \(dqpool\(dq:  \(dq192.0.3.1 \- 192.0.3.200\(dq } ],
            \(dqinterface\(dq: \(dqeth1\(dq
        }
    ]
}
}
.EE
.UNINDENT
.UNINDENT
.sp
همان‌طور که در مثال نشان داده شد، ترکیب زیرشبکه‌های اشتراکی و عادی (\(dqساده\(dq) امکان‌پذیر است. هر شبکه اشتراکی باید نامی یکتا داشته باشد. این نام مشابه شناسه (ID) برای زیرشبکه‌ها است، اما انعطاف‌پذیری بیشتری به مدیران سیستم می‌دهد. این نام برای ثبت وقایع (logging) و همچنین در سطوح داخلی برای شناسایی شبکه‌های اشتراکی به کار می‌رود.
.sp
در اصل، تعریف شبکه‌های اشتراکی که تنها شامل دو یا چند زیرشبکه باشند منطقی است. با این حال، برای اهداف آزمایشی، یک زیرشبکه خالی یا شبکه‌ای با تنها یک زیرشبکه مجاز است. این رویه در شبکه‌های عملیاتی توصیه نمی‌شود، چرا که منطق شبکه اشتراکی نیازمند پردازش اضافی بوده و در نتیجه کارایی کارساز را کاهش می‌دهد. برای جلوگیری از افت غیرضروری کارایی، زیرشبکه‌های اشتراکی تنها باید زمانی تعریف شوند که استقرار شبکه به آن‌ها نیاز داشته باشد.
.sp
شبکه‌های اشتراکی این امکان را فراهم می‌کنند که پارامترهای متعددی را در حوزه شبکه اشتراکی تعیین کنید که برای تمام زیرشبکه‌های درون آن اعمال می‌شوند. در صورت نیاز، این امکان وجود دارد که پارامتری در حوزه shared\-network مشخص شده و سپس مقدار آن در حوزه زیرشبکه بازنویسی شود. برای نمونه:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
\(dqshared\-networks\(dq: [
    {
        \(dqname\(dq: \(dqlab\-network3\(dq,

        \(dqinterface\(dq: \(dqeth0\(dq,

        # این مقدار برای تمام زیرشبکه‌های این شبکه اشتراکی اعمال می‌شود، مگر
        # این‌که مقادیر در حوزه زیرشبکه بازنویسی شوند.
        \(dqvalid\-lifetime\(dq: 600,

        # این گزینه در دسترس تمام زیرشبکه‌های این شبکه اشتراکی
        # قرار می‌گیرد.
        \(dqoption\-data\(dq: [
        {
            \(dqname\(dq: \(dqlog\-servers\(dq,
            \(dqdata\(dq: \(dq1.2.3.4\(dq
        }
        ],

        \(dqsubnet4\(dq: [
            {
                \(dqid\(dq: 1,
                \(dqsubnet\(dq: \(dq10.0.0.0/8\(dq,
                \(dqpools\(dq: [ { \(dqpool\(dq:  \(dq10.0.0.1 \- 10.0.0.99\(dq } ],

                # این زیرشبکه خاص از مقادیر متفاوتی استفاده می‌کند.
                \(dqvalid\-lifetime\(dq: 1200,
                \(dqoption\-data\(dq: [
                {
                    \(dqname\(dq: \(dqlog\-servers\(dq,
                    \(dqdata\(dq: \(dq10.0.0.254\(dq
                },
                {
                    \(dqname\(dq: \(dqrouters\(dq,
                    \(dqdata\(dq: \(dq10.0.0.254\(dq
                } ]
            },
            {
                 \(dqid\(dq: 2,
                 \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
                 \(dqpools\(dq: [ { \(dqpool\(dq:  \(dq192.0.2.100 \- 192.0.2.199\(dq } ],

                 # این زیرشبکه مقدار valid\-lifetime اختصاصی خود را مشخص نکرده است،
                 # بنابراین از حوزه شبکه اشتراکی به ارث برده می‌شود.
                 \(dqoption\-data\(dq: [
                 {
                     \(dqname\(dq: \(dqrouters\(dq,
                     \(dqdata\(dq: \(dq192.0.2.1\(dq
                 } ]
            }
        ]
    }
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
در این مثال، گزینه \fBlog\-servers\fP تعریف شده است که برای کارخواه‌ها در هر دو زیرشبکه این شبکه اشتراکی در دسترس است. همچنین، طول عمر معتبر (valid lifetime) روی ۱۰ دقیقه (600s) تنظیم شده است. با این حال، زیرشبکه نخست برخی از مقادیر را بازنویسی می‌کند (طول عمر معتبر ۲۰ دقیقه است و یک آدرس IP متفاوت برای \fBlog\-servers\fP وجود دارد)، و همچنین گزینه اختصاصی خود را اضافه می‌کند (آدرس مسیریاب). با فرض این‌که به کارخواهی که گزینه‌های مسیریاب و \fBlog\-servers\fP را درخواست می‌کند، یک اجاره (lease) از این زیرشبکه اختصاص یابد، اجاره‌ای به مدت ۲۰ دقیقه و مقدار 10.0.0.254 برای \fBlog\-servers\fP و routers دریافت خواهد کرد. اگر همان کارخواه به زیرشبکه دوم اختصاص یابد، یک اجاره ۱۰ دقیقه‌ای، مقدار 1.2.3.4 برای \fBlog\-servers\fP و routers تنظیم‌شده روی 192.0.2.1 را دریافت خواهد کرد..SS "ترافیک محلی و رله‌شده در شبکه‌های اشتراکی"
.sp
این امکان وجود دارد که نام یک رابط را در سطح shared\-network مشخص کنید تا به کارساز اعلام شود که این شبکه اشتراکیِ مشخص، مستقیماً (نه از طریق رله‌ها) و با استفاده از رابط شبکه محلی در دسترس است. از آنجا که انتظار می‌رود تمام زیرشبکه‌ها در یک شبکه اشتراکی روی پیوند فیزیکی یکسانی استفاده شوند، تلاش برای تعریف یک شبکه اشتراکی با زیرشبکه‌هایی که از طریق رابط‌های متفاوتی در دسترس هستند یک خطای پیکربندی محسوب می‌شود. به عبارت دیگر، تمام زیرشبکه‌های درون شبکه اشتراکی باید مقدار یکسانی برای پارامتر \fBinterface\fP داشته باشند. پیکربندی زیر نمونه‌ای از کاری است که \fBنباید\fP انجام داد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
\(dqshared\-networks\(dq: [
    {
        \(dqname\(dq: \(dqoffice\-floor\-2\(dq,
        \(dqsubnet4\(dq: [
            {
                \(dqid\(dq: 1,
                \(dqsubnet\(dq: \(dq10.0.0.0/8\(dq,
                \(dqpools\(dq: [ { \(dqpool\(dq:  \(dq10.0.0.1 \- 10.0.0.99\(dq } ],
                \(dqinterface\(dq: \(dqeth0\(dq
            },
            {
                 \(dqid\(dq: 2,
                 \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
                 \(dqpools\(dq: [ { \(dqpool\(dq:  \(dq192.0.2.100 \- 192.0.2.199\(dq } ],

                 # Specifying the different interface name is a configuration
                 # error. This value should rather be \(dqeth0\(dq or the interface
                 # name in the other subnet should be \(dqeth1\(dq.
                 \(dqinterface\(dq: \(dqeth1\(dq
            }
        ]
    }
],
\&...
}
.EE
.UNINDENT
.UNINDENT
.sp
برای به حداقل رساندن احتمال خطاهای پیکربندی، اغلب راحت‌تر است که نام رابط را به سادگی یک بار در سطح shared\-network مشخص کنید، همان‌طور که در مثال زیر نشان داده شده است.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
\(dqshared\-networks\(dq: [
    {
        \(dqname\(dq: \(dqoffice\-floor\-2\(dq,

        # This tells Kea that the whole shared network is reachable over a
        # local interface. This applies to all subnets in this network.
        \(dqinterface\(dq: \(dqeth0\(dq,

        \(dqsubnet4\(dq: [
            {
                \(dqid\(dq: 1,
                \(dqsubnet\(dq: \(dq10.0.0.0/8\(dq,
                \(dqpools\(dq: [ { \(dqpool\(dq:  \(dq10.0.0.1 \- 10.0.0.99\(dq } ]
            },
            {
                 \(dqid\(dq: 2,
                 \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
                 \(dqpools\(dq: [ { \(dqpool\(dq:  \(dq192.0.2.100 \- 192.0.2.199\(dq } ]
            }
        ]
    }
],
\&...
}
.EE
.UNINDENT
.UNINDENT
.sp
در ترافیک رله‌شده، زیرشبکه‌ها معمولاً با استفاده از نشانی‌های عامل‌های رله انتخاب می‌شوند. اگر زیرشبکه‌ها به طور مستقل استفاده شوند (در یک شبکه اشتراکی گروه‌بندی نشده باشند)، می‌توان یک نشانی رله متفاوت برای هر یک از این زیرشبکه‌ها مشخص کرد. هنگامی که چندین زیرشبکه متعلق به یک شبکه اشتراکی هستند، باید از طریق همان نشانی رله یکسان انتخاب شوند و مشابه مورد ترافیک محلی که در بالا شرح داده شد، تعیین نشانی‌های رله متفاوت برای زیرشبکه‌های مربوطه در شبکه اشتراکی یک خطای پیکربندی است. پیکربندی زیر نمونه دیگری از کارهایی است که \fBنباید\fP انجام داد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
\(dqshared\-networks\(dq: [
    {
        \(dqname\(dq: \(dqkakapo\(dq,
        \(dqsubnet4\(dq: [
            {
                \(dqid\(dq: 1,
                \(dqsubnet\(dq: \(dq192.0.2.0/26\(dq,
                \(dqrelay\(dq: {
                    \(dqip\-addresses\(dq: [ \(dq192.1.1.1\(dq ]
                },
                \(dqpools\(dq: [ { \(dqpool\(dq: \(dq192.0.2.63 \- 192.0.2.63\(dq } ]
            },
            {
                \(dqid\(dq: 2,
                \(dqsubnet\(dq: \(dq10.0.0.0/24\(dq,
                \(dqrelay\(dq: {
                    # Specifying a different relay address for this
                    # subnet is a configuration error. In this case
                    # it should be 192.1.1.1 or the relay address
                    # in the previous subnet should be 192.2.2.2.
                    \(dqip\-addresses\(dq: [ \(dq192.2.2.2\(dq ]
                },
                \(dqpools\(dq: [ { \(dqpool\(dq: \(dq10.0.0.16 \- 10.0.0.16\(dq } ]
            }
        ]
    }
],
\&...
}
.EE
.UNINDENT
.UNINDENT
.sp
مجدداً، بهتر است نشانی رله در سطح shared\-network مشخص شود؛ این مقدار توسط تمام زیرشبکه‌های متعلق به شبکه اشتراکی به ارث برده خواهد شد.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
\(dqshared\-networks\(dq: [
    {
        \(dqname\(dq: \(dqkakapo\(dq,
        \(dqrelay\(dq: {
            # This relay address is inherited by both subnets.
            \(dqip\-addresses\(dq: [ \(dq192.1.1.1\(dq ]
        },
        \(dqsubnet4\(dq: [
            {
                \(dqid\(dq: 1,
                \(dqsubnet\(dq: \(dq192.0.2.0/26\(dq,
                \(dqpools\(dq: [ { \(dqpool\(dq: \(dq192.0.2.63 \- 192.0.2.63\(dq } ]
            },
            {
                \(dqid\(dq: 2,
                \(dqsubnet\(dq: \(dq10.0.0.0/24\(dq,
                \(dqpools\(dq: [ { \(dqpool\(dq: \(dq10.0.0.16 \- 10.0.0.16\(dq } ]
            }
        ]
    }
],
\&...
}
.EE
.UNINDENT
.UNINDENT
.sp
اگرچه از نظر فنی امکان پیکربندی دو (یا چند) زیرشبکه در یک شبکه اشتراکی برای استفاده از نشانی‌های رله متفاوت وجود دارد، اما این کار تقریباً همیشه به رفتاری متفاوت از آنچه کاربر انتظار دارد منجر خواهد شد. در این حالت، کارساز Kea ابتدا یکی از زیرشبکه‌ها را با تطبیق نشانی رله در بسته کلاینت با پیکربندی زیرشبکه انتخاب می‌کند. با این حال، در صورتی که کلاینت از قبل اجاره‌ای در این زیرشبکه داشته باشد یا یک رزرو میزبان (host reservation) در این زیرشبکه داشته باشد، یا صرفاً اگر زیرشبکه انتخاب‌شده اولیه نشانی دردسترس دیگری نداشته باشد، کارساز ممکن است در نهایت از زیرشبکه دیگر استفاده کند (حتی اگر با نشانی رله مطابقت نداشته باشد). بنابراین، در صورتی که زیرشبکه‌ها متعلق به یک شبکه اشتراکی هستند، اکیداً توصیه می‌شود انتخاب‌کننده‌های زیرشبکه (رابط یا نشانی رله) همیشه در سطح shared\-network مشخص شوند، چرا که تعیین آن‌ها در سطح زیرشبکه به‌ندرت مفید است و ممکن است به خطاهای پیکربندی شرح داده شده در بالا منجر شود..SS کلاس‌بندی کلاینت در شبکه‌های اشتراکی
.sp
گاهی مطلوب است که کلاینت‌ها بر اساس ویژگی‌های معینی به زیرشبکه‌های مشخصی تفکیک شوند. این سازوکار «کلاس‌بندی کلاینت» نامیده می‌شود و در Client Classification \%<#\:classify>\& شرح داده شده است.
.sp
کلاس‌بندی کلاینت می‌تواند برای زیرشبکه‌های متعلق به شبکه‌های اشتراکی نیز دقیقاً به همان روشی که برای زیرشبکه‌های خارج از شبکه‌های اشتراکی به کار می‌رود، اعمال شود. درک نحوه انتخاب زیرشبکه برای کلاینت‌ها توسط سرور در زمان استفاده از کلاس‌بندی کلاینت اهمیت بالایی دارد، تا اطمینان حاصل شود که زیرشبکه مناسب برای یک نوع کلاینت خاص انتخاب می‌شود.
.sp
اگر یک زیرشبکه با یک یا چند کلاس مرتبط شده باشد، تنها کلاینت‌هایی که دست‌کم به یکی از این کلاس‌ها تعلق دارند می‌توانند از این زیرشبکه استفاده کنند. اگر کلاسی برای یک زیرشبکه مشخص نشده باشد، هر کلاینت متصل به یک شبکه اشتراکی مفروض می‌تواند از آن زیرشبکه استفاده کند. یک اشتباه رایج این است که فرض شود زیرشبکه‌ای که دارای کلاس کلاینت است بر زیرشبکه‌های بدون کلاس ترجیح داده می‌شود.
.sp
پارامتر \fBclient\-classes\fP را می‌توان در دامنه‌های شبکه اشتراکی (shared network)، زیرشبکه (subnet) و/یا استخر (pool) مشخص کرد. اگر برای یک شبکه اشتراکی مشخص شود، کلاینت‌ها باید حداقل عضو یکی از کلاس‌های تعیین‌شده برای آن شبکه باشند تا برای زیرشبکه‌های درون آن شبکه در نظر گرفته شوند. اگر برای یک زیرشبکه مشخص شود، کلاینت‌ها باید حداقل عضو یکی از کلاس‌های تعیین‌شده برای آن زیرشبکه باشند تا برای استخرها یا رزروهای میزبان (host reservations) آن زیرشبکه در نظر گرفته شوند. اگر برای یک pool مشخص شود، کلاینت‌ها باید حداقل به یکی از کلاس‌های مشخص‌شده برای آن pool تعلق داشته باشند تا یک اجاره (lease) از آن pool دریافت کنند.
.sp
مثال زیر را در نظر بگیرید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqclient\-classes\(dq: [
        {
            \(dqname\(dq: \(dqb\-devices\(dq,
            \(dqtest\(dq: \(dqoption[93].hex == 0x0002\(dq
        }
    ],
    \(dqshared\-networks\(dq: [
        {
            \(dqname\(dq: \(dqgalah\(dq,
            \(dqinterface\(dq: \(dqeth0\(dq,
            \(dqsubnet4\(dq: [
                {
                    \(dqid\(dq: 1,
                    \(dqsubnet\(dq: \(dq192.0.2.0/26\(dq,
                    \(dqpools\(dq: [ { \(dqpool\(dq: \(dq192.0.2.1 \- 192.0.2.63\(dq } ]
                },
                {
                    \(dqid\(dq: 2,
                    \(dqsubnet\(dq: \(dq10.0.0.0/24\(dq,
                    \(dqpools\(dq: [ { \(dqpool\(dq: \(dq10.0.0.2 \- 10.0.0.250\(dq } ],
                    \(dqclient\-classes\(dq: [ \(dqb\-devices\(dq ]
                }
            ]
        }
    ]
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر کلاینت به کلاس \(dqb\-devices\(dq تعلق داشته باشد (چون شامل option 93 با مقدار 0x0002 است)، این امر تضمین نمی‌کند که زیرشبکه 10.0.0.0/24 برای این کلاینت استفاده شود (یا ترجیح داده شود). سرور می‌تواند از هر یک از این دو زیرشبکه استفاده کند، چرا که زیرشبکه 192.0.2.0/26 نیز برای این کلاینت مجاز است. کلاس‌بندی کلاینت مورد استفاده در این مورد باید به عنوان راهکاری برای محدود کردن دسترسی به زیرشبکه‌های خاص در نظر گرفته شود، نه به عنوان روشی برای تعیین اولویت زیرشبکه. برای نمونه، اگر کلاینتی عضو کلاس \(dqb\-devices\(dq نباشد، فقط می‌تواند از زیرشبکه 192.0.2.0/26 استفاده کند و هرگز از زیرشبکه 10.0.0.0/24 استفاده نخواهد کرد.
.sp
یک کاربرد متداول برای کلاس‌بندی کلاینت در شبکه‌های کابلی (cable networks) است؛ جایی که مودم‌های کابلی باید از یک زیرشبکه و سایر دستگاه‌ها باید از زیرشبکه دیگری در همان شبکه اشتراکی استفاده کنند. در این حالت لازم است کلاس‌بندی بر روی تمام زیرشبکه‌ها اعمال شود. مثال زیر دو کلاس از دستگاه‌ها را تعریف می‌کند و انتخاب زیرشبکه بر اساس مقادیر option 93 صورت می‌گیرد.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqclient\-classes\(dq: [
        {

            \(dqname\(dq: \(dqa\-devices\(dq,
            \(dqtest\(dq: \(dqoption[93].hex == 0x0001\(dq
        },
        {
            \(dqname\(dq: \(dqb\-devices\(dq,
            \(dqtest\(dq: \(dqoption[93].hex == 0x0002\(dq
        }
    ],
    \(dqshared\-networks\(dq: [
        {
            \(dqname\(dq: \(dqgalah\(dq,
            \(dqinterface\(dq: \(dqeth0\(dq,
            \(dqsubnet4\(dq: [
                {
                    \(dqid\(dq: 1,
                    \(dqsubnet\(dq: \(dq192.0.2.0/26\(dq,
                    \(dqpools\(dq: [ { \(dqpool\(dq: \(dq192.0.2.1 \- 192.0.2.63\(dq } ],
                    \(dqclient\-classes\(dq: [ \(dqa\-devices\(dq ]
                },
                {
                    \(dqid\(dq: 2,
                    \(dqsubnet\(dq: \(dq10.0.0.0/24\(dq,
                    \(dqpools\(dq: [ { \(dqpool\(dq: \(dq10.0.0.2 \- 10.0.0.250\(dq } ],
                    \(dqclient\-classes\(dq: [ \(dqb\-devices\(dq ]
                }
            ]
        }
    ]
}
.EE
.UNINDENT
.UNINDENT
.sp
در این مثال هر کلاس محدودیت خاص خود را دارد. تنها کلاینت‌هایی که متعلق به کلاس \(dqa\-devices\(dq هستند می‌توانند از زیرشبکه 192.0.2.0/26 استفاده کنند و تنها کلاینت‌های متعلق به \(dqb\-devices\(dq مجاز به استفاده از زیرشبکه 10.0.0.0/24 هستند. باید مراقبت کرد که قوانین کلاس‌بندی بیش از حد محدودکننده تعریف نشوند، چرا که کلاینت‌هایی که نتوانند از هیچ زیرشبکه‌ای استفاده کنند، رد سرویس خواهند شد. با این حال، اگر هدف ارائه‌ی سرویس فقط به کلاینت‌هایی با ویژگی‌های مشخص باشد (برای مثال، تنها تلفن‌های VoIP مجاز به اتصال روی یک پیوند باشند)، این رفتار می‌تواند نتیجه‌ی مطلوب باشد.
.sp
دستیابی به اثری مشابه با آنچه در این بخش مطرح شد، بدون استفاده از شبکه‌های اشتراکی نیز ممکن است. اگر زیرشبکه‌ها به جای شبکه اشتراکی در دامنه سراسری زیرشبکه‌ها (global subnets scope) قرار گیرند، سرور همچنان از قوانین کلاس‌بندی برای انتخاب زیرشبکه مناسب برای کلاس مشخصی از دستگاه‌ها استفاده خواهد کرد. مزیت عمده قرار دادن زیرشبکه‌ها درون شبکه اشتراکی این است که پارامترهای مشترک برای زیرشبکه‌هایی که به صورت منطقی گروه‌بندی شده‌اند، می‌تواند یک‌بار در دامنه shared\-network تعیین شود؛ مانند پارامتر \fBinterface\fP یا \fBrelay\fP. تمامی زیرشبکه‌های متعلق به این شبکه اشتراکی این پارامترها را به ارث خواهند برد..SS رزروهای میزبان در شبکه‌های اشتراکی (Host Reservations in Shared Networks)
.sp
زیرشبکه‌هایی که بخشی از یک شبکه اشتراکی (shared network) هستند، مانند زیرشبکه‌های معمولی امکان رزرو میزبان را فراهم می‌کنند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqshared\-networks\(dq: [
    {
        \(dqname\(dq: \(dqfrog\(dq,
        \(dqinterface\(dq: \(dqeth0\(dq,
        \(dqsubnet4\(dq: [
            {
                \(dqsubnet\(dq: \(dq192.0.2.0/26\(dq,
                \(dqid\(dq: 100,
                \(dqpools\(dq: [ { \(dqpool\(dq: \(dq192.0.2.1 \- 192.0.2.63\(dq } ],
                \(dqreservations\(dq: [
                    {
                        \(dqhw\-address\(dq: \(dqaa:bb:cc:dd:ee:ff\(dq,
                        \(dqip\-address\(dq: \(dq192.0.2.28\(dq
                    }
                ]
            },
            {
                \(dqsubnet\(dq: \(dq10.0.0.0/24\(dq,
                \(dqid\(dq: 101,
                \(dqpools\(dq: [ { \(dqpool\(dq: \(dq10.0.0.1 \- 10.0.0.254\(dq } ],
                \(dqreservations\(dq: [
                    {
                        \(dqhw\-address\(dq: \(dq11:22:33:44:55:66\(dq,
                        \(dqip\-address\(dq: \(dq10.0.0.29\(dq
                    }
                ]
            }
        ]
    }
    ]
}
.EE
.UNINDENT
.UNINDENT
.sp
شایان ذکر است که در صورت تعریف شبکه‌های اشتراکی، Kea هنگام پردازش یک بسته، بررسی‌های بیشتری انجام می‌دهد. نخست، Kea به‌جای بررسی ساده این موضوع که آیا برای یک کلاینت معین در زیرشبکه نخستینِ انتخاب‌شده رزروی وجود دارد یا خیر، تمام زیرشبکه‌های موجود در یک شبکه اشتراکی را برای یافتن رزرو جستجو می‌کند. این یکی از دلایلی است که تعریف یک شبکه اشتراکی ممکن است بر کارایی تأثیر بگذارد. اگر در هر زیرشبکه‌ای رزروی برای یک کلاینت وجود داشته باشد، همان زیرشبکه خاص برای کلاینت انتخاب می‌شود. هرچند از نظر فنی این یک خطا محسوب نمی‌شود، اما تعریف رزرو برای یک میزبان یکسان در چندین زیرشبکه متعلق به یک شبکه اشتراکی، شیوه‌ای نادرست (bad practice) تلقی می‌شود.
.sp
اگرچه کاملاً اجباری نیست، اما در صورتی که قرار است از پایگاه داده برای ذخیره رزروهای میزبان استفاده شود، اکیداً توصیه می‌شود از مقادیر صریح \(dqid\(dq برای زیرشبکه‌ها استفاده کنید. اگر یک شناسه مشخص نشود، مقادیر آن به‌طور خودکار تولید می‌شوند؛ بدین معنا که Kea مقادیر صحیح افزایشی را با شروع از ۱ اختصاص می‌دهد. بنابراین، شناسه‌های تولیدشده به‌طور خودکار در صورت تغییر پیکربندی پایدار نخواهند ماند.
.SS شناسه سرور در DHCPv4 (Server Identifier in DHCPv4)
.sp
پروتکل DHCPv4 از یک \(dqشناسه سرور\(dq (server identifier) استفاده می‌کند تا به کلاینت‌ها امکان تمایز بین چندین سرور موجود روی یک پیوند (link) یکسان را بدهد؛ این مقدار، یک نشانی IPv4 متعلق به سرور است. سرور، نشانی IPv4 مربوط به رابطی را انتخاب می‌کند که پیام از کلاینت (یا عامل رله) روی آن دریافت شده است. یک نمونه منفرد سرور در صورتی که پرس‌وجوها را روی چندین رابط دریافت کند، از چندین شناسه سرور استفاده خواهد کرد.
.sp
امکان بازنویسی (override) مقادیر پیش‌فرض شناسه سرور با مشخص کردن گزینه \fBdhcp\-server\-identifier\fP وجود دارد. پیکربندی این گزینه تنها در سطوح زیرشبکه، شبکه اشتراکی، کلاس کلاینت و سراسری پشتیبانی می‌شود. این گزینه نباید در سطح رزرو میزبان (host-reservation) مشخص شود.
هنگام پیکربندی گزینه \fBdhcp\-server\-identifier\fP در سطح کلاس کلاینت، کلاس نباید پرچم \fBonly\-in\-additional\-list\fP را تنظیم کند؛ زیرا این کلاس پیش از آنکه سرور تعیین کند آیا پیام DHCP دریافت‌شده باید برای پردازش پذیرفته شود یا خیر، ارزیابی نمی‌شود. چنین کلاس‌هایی پس از انتخاب زیرشبکه ارزیابی می‌شوند.
برای جزئیات بیشتر به بخش دسته‌بندی اضافی (Additional Classification) مراجعه کنید.
.sp
مثال زیر نحوه بازنویسی شناسه سرور را برای یک زیرشبکه نشان می‌دهد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
\(dqsubnet4\(dq: [
    {
        \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
        \(dqoption\-data\(dq: [
            {
                \(dqname\(dq: \(dqdhcp\-server\-identifier\(dq,
                \(dqdata\(dq: \(dq10.2.5.76\(dq
            }
        ],
        ...
    }
],
\&...
}
.EE
.UNINDENT
.UNINDENT
.SS نحوه انتخاب زیرشبکه برای کلاینت توسط سرور DHCPv4
.sp
سرور DHCPv4 بین کلاینت‌های با اتصال مستقیم، کلاینت‌هایی که برای تمدید اجاره (lease) تلاش می‌کنند، و کلاینت‌هایی که پیام‌های خود را از طریق رله‌ها (relays) می‌فرستند تفاوت قائل می‌شود. برای کلاینت‌های مستقیماً متصل‌شده، سرور پیکربندی رابطی را که پیام روی آن دریافت شده بررسی می‌کند و در صورتی که پیکربندی سرور با هیچ زیرشبکه پیکربندی‌شده‌ای مطابقت نداشته باشد، پیام دور ریخته می‌شود.
.sp
یک پارامتر اختیاری interface در تعریف زیرشبکه در دسترس است تا مشخص کند زیرشبکه موردنظر محلی است؛ یعنی مستقیماً از طریق رابط تعیین‌شده قابل دسترسی است. به عنوان مثال، سروری که در نظر دارد از طریق eth0 به یک زیرشبکه محلی خدمات دهد، می‌تواند به صورت زیر پیکربندی شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqsubnet4\(dq: [
        {
            \(dqid\(dq: 1,
            \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
            \(dqpools\(dq: [
                 {
                     \(dqpool\(dq: \(dq192.0.2.100 \- 192.0.2.199\(dq
                 }
             ],
            \(dqinterface\(dq: \(dqeth0\(dq
        }
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
با فرض اینکه رابط سرور با نشانی IPv4 برابر 192.0.2.3 پیکربندی شده باشد، سرور پیام‌های دریافت‌شده از طریق این رابط از یک کلاینت با اتصال مستقیم را تنها در صورتی پردازش می‌کند که زیرشبکه‌ای پیکربندی شده باشد که این نشانی IPv4 به آن تعلق دارد، مانند 192.0.2.0/24. سرور از این زیرشبکه برای اختصاص یک نشانی IPv4 به کلاینت استفاده می‌کند.
.sp
قاعده بالا زمانی که کلاینت پیام خود را به‌صورت تک‌پخشی (unicast) ارسال می‌کند، یعنی در حال تلاش برای تمدید اجاره خود است، اعمال نمی‌شود؛ چنین پیامی از طریق هر رابطی پذیرفته می‌شود. کلاینتِ در حال تمدید، \fBciaddr\fP را روی نشانی IPv4 فعلی مورد استفاده قرار می‌دهد و سرور از این نشانی برای انتخاب زیرشبکه کلاینت استفاده می‌کند (به‌ویژه برای تمدید اجاره با استفاده از این نشانی).
.sp
اگر پیام از طریق رله منتقل شده باشد، از طریق هر رابطی پذیرفته می‌شود. مقدار \fBgiaddr\fP تنظیم‌شده توسط عامل رله برای انتخاب زیرشبکه کلاینت به کار می‌رود.
.sp
همچنین امکان تعیین یک نشانی IPv4 برای عامل رله در یک زیرشبکه مشخص وجود دارد. این مورد می‌تواند برای تطبیق بسته‌های ورودی به یک زیرشبکه در پیکربندی‌های غیرمعمول، مانند شبکه‌های اشتراکی، استفاده شود. برای جزئیات به بخش استفاده از یک عامل رله خاص برای یک زیرشبکه (Using a Specific Relay Agent for a Subnet) مراجعه کنید.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
سازوکار انتخاب زیرشبکه که در این بخش شرح داده شده، مبتنی بر این فرض است که از دسته‌بندی کلاینت (client classification) استفاده نمی‌شود. سازوکار دسته‌بندی، بسته به کلاس‌هایی که کلاینت به آن‌ها تعلق دارد، روش انتخاب زیرشبکه برای کلاینت را تغییر می‌دهد.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
هنگامی که زیرشبکه انتخاب‌شده عضوی از یک شبکه اشتراکی است، کل شبکه اشتراکی انتخاب می‌شود.
.UNINDENT
.UNINDENT.SS استفاده از یک عامل رله مشخص برای یک زیرشبکه
.sp
یک رله باید رابطی متصل به پیوندی داشته باشد که کلاینت‌ها روی آن پیکربندی می‌شوند. به‌طور معمول، رله دارای یک آدرس IPv4 پیکربندی‌شده روی آن رابط است که متعلق به زیرشبکه‌ای است که کارساز از آن آدرس تخصیص می‌دهد. در حالت عادی، کارساز قادر است از آدرس IPv4 درج‌شده توسط رله (در فیلد \fBgiaddr\fP بستهٔ DHCPv4) برای انتخاب زیرشبکهٔ مناسب استفاده کند.
.sp
با این حال، همیشه این‌گونه نیست. در برخی استقرارهای نامعمول — اما معتبر — ممکن است آدرس رله با زیرشبکه مطابقت نداشته باشد. این موضوع معمولاً به این معنی است که بیش از یک زیرشبکه برای یک پیوند مشخص تخصیص یافته است. دو مورد از رایج‌ترین نمونه‌های این وضعیت، شماره‌گذاری مجدد شبکه به‌صورت طولانی‌مدت (که در آن هر دو فضای آدرس قدیمی و جدید همچنان مورد استفاده قرار می‌گیرند) و یک شبکهٔ کابلی هستند. در یک شبکهٔ کابلی، هم مودم‌های کابلی و هم دستگاه‌های پشت آن‌ها به‌صورت فیزیکی به همان پیوند متصل هستند، اما از آدرس‌دهی متفاوتی استفاده می‌کنند. در چنین حالتی، کارساز DHCPv4 برای انتخاب صحیح زیرشبکهٔ مناسب به اطلاعات بیشتری (آدرس IPv4 رله) نیاز دارد.
.sp
مثال زیر فرض می‌کند که زیرشبکه‌ای با نشانی 192.0.2.0/24 وجود دارد که از طریق رله‌ای با آدرس IPv4 برابر با 10.0.0.1 قابل دسترسی است. کارساز می‌تواند این زیرشبکه را برای تمام بسته‌های ورودی که از سوی رله‌ای با آدرسی در زیرشبکهٔ 192.0.2.0/24 می‌آیند انتخاب کند. همچنین این زیرشبکه را برای رله‌ای با آدرس 10.0.0.1 نیز انتخاب می‌کند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp4\(dq: {
    \(dqsubnet4\(dq: [
        {
            \(dqid\(dq: 1,
            \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
            \(dqpools\(dq: [ { \(dqpool\(dq: \(dq192.0.2.10 \- 192.0.2.20\(dq } ],
            \(dqrelay\(dq: {
                \(dqip\-addresses\(dq: [ \(dq10.0.0.1\(dq ]
            }
        }
    ]
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر \fBrelay\fP مشخص شده باشد، پارامتر \fBip\-addresses\fP درون آن اجباری است. پارامتر \fBip\-addresses\fP از تعیین فهرستی از آدرس‌ها پشتیبانی می‌کند.
.SS تفکیک کلاینت‌های IPv4 در یک شبکه کابلی
.sp
در برخی موارد، ترکیب اطلاعات آدرس رله (معرفی‌شده در «استفاده از یک عامل رله مشخص برای یک زیرشبکه») با دسته‌بندی کلاینت (توضیح‌داده‌شده در Client Classification \%<#\:classify>) مفید است. یک نمونهٔ خاص در شبکهٔ کابلی است، جایی که مودم‌ها معمولاً آدرس‌هایی از زیرشبکه‌ای متفاوت نسبت به تمامی دستگاه‌های متصل پشت خود دریافت می‌کنند.
.sp
فرض کنید یک Cable Modem Termination System (CMTS) با یک CM MAC (یک پیوند فیزیکی که مودم‌ها به آن متصل هستند) وجود دارد. می‌خواهیم مودم‌ها آدرس‌هایی از زیرشبکهٔ 10.1.1.0/24 دریافت کنند، در حالی که همهٔ دستگاه‌های متصل پشت مودم‌ها باید آدرس‌هایی از زیرشبکهٔ 192.0.2.0/24 بگیرند. دستگاه CMTS که به عنوان رله عمل می‌کند از آدرس 10.1.1.1 استفاده می‌نماید. پیکربندی زیر می‌تواند پاسخگوی این وضعیت باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqsubnet4\(dq: [
        {
            \(dqid\(dq: 1,
            \(dqsubnet\(dq: \(dq10.1.1.0/24\(dq,
            \(dqpools\(dq: [ { \(dqpool\(dq: \(dq10.1.1.2 \- 10.1.1.20\(dq } ],
            \(dqclient\-classes\(dq: [ \(dqdocsis3.0\(dq ],
            \(dqrelay\(dq: {
                \(dqip\-addresses\(dq: [ \(dq10.1.1.1\(dq ]
            }
        },
        {
            \(dqid\(dq: 2,
            \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
            \(dqpools\(dq: [ { \(dqpool\(dq: \(dq192.0.2.10 \- 192.0.2.20\(dq } ],
            \(dqrelay\(dq: {
                \(dqip\-addresses\(dq: [ \(dq10.1.1.1\(dq ]
            }
        }
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.SS آدرس‌های تکراری (پشتیبانی از DHCPDECLINE)
.sp
کارساز DHCPv4 با استخر مشخصی از آدرس‌ها پیکربندی شده است که انتظار می‌رود آن‌ها را به کلاینت‌های DHCPv4 واگذار کند. فرض بر این است که کارساز معتبر (authoritative) بوده و اختیار کامل بر روی آن آدرس‌ها دارد. با این حال، به دلایل مختلفی مانند پیکربندی نادرست یا پیاده‌سازی معیوب در کلاینت که آدرس خود را پس از پایان طول‌عمر معتبر همچنان حفظ می‌کند، ممکن است دستگاه‌های متصلی وجود داشته باشند که بدون تأیید یا آگاهی کارساز از آن آدرس‌ها استفاده کنند.
.sp
چنین رویداد نامطلوبی را کلاینت‌های قانونی می‌توانند (با استفاده از سازوکارهای ARP یا ICMP Echo Request) شناسایی کرده و با استفاده از پیام DHCPDECLINE به کارساز DHCPv4 گزارش دهند. کارساز یک بررسی اعتبارسنجی اولیه (sanity check) انجام می‌دهد (تا ببیند آیا کلاینتی که آدرس را رد می‌کند واقعاً قرار بوده از آن استفاده کند یا خیر) و سپس یک عملیات پاک‌سازی را اجرا می‌کند. هرگونه مدخل DNS مرتبط با آن آدرس حذف شده، رویداد ثبت می‌شود و قلاب‌ها اجرا می‌گردند. پس از پایان این کار، آدرس به عنوان ردشده (declined) علامت‌گذاری می‌شود (که نشان می‌دهد توسط موجودیتی ناشناس در حال استفاده است و در نتیجه برای تخصیص در دسترس نیست) و یک زمان تعلیق (probation time) برای آن تعیین می‌شود. مگر اینکه خلاف آن پیکربندی شده باشد، دورهٔ تعلیق ۲۴ ساعت به طول می‌انجامد؛ پس از این زمان، کارساز اجاره (lease) را بازیابی می‌کند (یعنی آن را دوباره به وضعیت در دسترس بازمی‌گرداند) و آدرس مجدداً برای تخصیص در دسترس خواهد بود. باید توجه داشت که اگر مشکل بنیادین دستگاهی که پیکربندی نادرستی دارد حل نشود، سناریوی آدرس تکراری تکرار خواهد شد. در صورت پیکربندی صحیح، این سازوکار امکان بازیابی خودکار از چنین رویدادی را بدون نیاز به هیچ‌گونه مداخلهٔ مدیر سیستم فراهم می‌کند.
.sp
برای پیکربندی دورهٔ تعلیق رد شدن با مقداری غیر از پیش‌فرض، می‌توان از نحو دستوری زیر استفاده کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqdecline\-probation\-period\(dq: 3600,
    \(dqsubnet4\(dq: [
        {
            ...
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
این پارامتر بر حسب ثانیه بیان می‌شود، بنابراین مثال بالا به کارساز دستور می‌دهد تا اجاره‌های ردشده را پس از یک ساعت بازیافت کند.
.sp
چندین آمار و نقطهٔ قلاب (hook point) مرتبط با روال رسیدگی به رد شدن وجود دارد. نقطهٔ قلاب \fBlease4_decline\fP پس از اینکه پیام ورودی DHCPDECLINE اعتبارسنجی شد و کارساز در شرف رد کردن اجاره است فعال می‌شود. آمار \fBdeclined\-addresses\fP پس از بازگشت قلاب افزایش می‌یابد (هم در نوع سراسری و هم در نوع ویژهٔ زیرشبکه). (برای جزئیات بیشتر دربارهٔ آمارهای DHCPv4 و نقاط قلاب Kea، بخش Statistics in the DHCPv4 Server و Hook Libraries \%<#\:hooks-libraries> را ببینید.)
.sp
به محض سپری شدن زمان تعلیق، اجارهٔ ردشده با استفاده از روال استاندارد آزادسازی اجاره‌های منقضی‌شده، همراه با چند مرحلهٔ اضافی بازیابی می‌شود. به‌ویژه، هر دو آمار \fBdeclined\-addresses\fP (سراسری و ویژهٔ زیرشبکه) کاهش می‌یابند. در همان زمان، آمارهای \fBreclaimed\-declined\-addresses\fP (باز هم در دو گونهٔ سراسری و ویژهٔ زیرشبکه) افزایش می‌یابند.
.sp
یادداشتی دربارهٔ آمارها: کارساز Kea پس از دریافت و پردازش موفق یک DHCPDECLINE، آمار \fBassigned\-addresses\fP را کاهش نمی‌دهد. اگرچه از نظر فنی یک آدرس ردشده دیگر تخصیص‌یافته محسوب نمی‌شود، اما کاربرد اصلی آمار \fBassigned\-addresses\fP نظارت بر بهره‌برداری از استخر است. بیشتر افراد فراموش می‌کنند که \fBdeclined\-addresses\fP را در محاسبه بگنجانند و صرفاً از نسبت \fBassigned\-addresses\fP/\fBtotal\-addresses\fP\& استفاده می‌کنند. این امر باعث ایجاد تورش و کمتر نشان دادن میزان بهره‌برداری از استخر خواهد شد. از آنجا که این موضوع پتانسیل ایجاد سردرگمی جدی دارد، ISC تصمیم گرفت که بلافاصله پس از دریافت DHCPDECLINE آمار \fBassigned\-addresses\fP را کاهش ندهد، بلکه این کار را بعداً زمانی انجام دهد که Kea آدرس را دوباره به استخر در دسترس بازمی‌گرداند..SS "آمارها در کارساز DHCPv4"
.sp
کارساز DHCPv4 از آمارهای زیر پشتیبانی می‌کند:
.SS "آمارهای DHCPv4"
.TS
box center;
l|l|l.
T{
آماره
T}	T{
نوع داده
T}	T{
توضیحات
T}
_
T{
pkt4\-received
T}	T{
integer
T}	T{
تعداد بسته‌های DHCPv4 دریافت‌شده.
شامل همه بسته‌ها می‌شود: معتبر،
ساختگی، مخدوش، ردشده، و غیره.
انتظار می‌رود این آماره به سرعت
رشد کند.
T}
_
T{
pkt4\-discover\-received
T}	T{
integer
T}	T{
تعداد بسته‌های DHCPDISCOVER
دریافت‌شده. انتظار می‌رود این
آماره افزایش یابد؛ افزایش آن
بدین معناست که کارخواه‌هایی که
به‌تازگی راه‌اندازی شده‌اند فرایند
پیکربندی خود را آغاز کرده و بسته‌های
اولیه آن‌ها به کارساز Kea رسیده است.
T}
_
T{
pkt4\-offer\-received
T}	T{
integer
T}	T{
تعداد بسته‌های DHCPOFFER
دریافت‌شده. انتظار می‌رود این آماره
همواره صفر بماند، زیرا بسته‌های
DHCPOFFER توسط کارساز ارسال می‌شوند
و هرگز انتظار نمی‌رود کارساز آن‌ها را
دریافت کند. مقدار غیرصفر نشان‌دهنده یک
خطاست. یکی از علل محتمل می‌تواند یک
عامل رله با رفتار نادرست باشد که
پیام‌های DHCPOFFER را به اشتباه به
سمت کارساز بازمی‌فرستد، به جای آنکه
به کارخواه‌ها ارسال کند.
T}
_
T{
pkt4\-request\-received
T}	T{
integer
T}	T{
تعداد بسته‌های DHCPREQUEST
دریافت‌شده. انتظار می‌رود این آماره
افزایش یابد. رشد آن بدین معناست که
کارخواه‌هایی که به‌تازگی راه‌اندازی
شده‌اند، پاسخ کارساز (DHCPOFFER) را
دریافت و پذیرفته‌اند و اکنون در حال
درخواست یک نشانی (DHCPREQUEST) هستند.
T}
_
T{
pkt4\-ack\-received
T}	T{
integer
T}	T{
تعداد بسته‌های DHCPACK دریافت‌شده.
انتظار می‌رود این آماره همیشه صفر
بماند، چرا که بسته‌های DHCPACK توسط
کارساز ارسال می‌شوند و هرگز انتظار
نمی‌رود کارساز آن‌ها را دریافت کند.
یک مقدار غیرصفر نشان‌دهنده خطا است.
یکی از علل محتمل می‌تواند عامل رله‌ای
باشد که رفتار نادرست داشته و پیام‌های
DHCPACK را به جای کارخواه‌ها، به اشتباه
به سمت کارساز بازمی‌گرداند.
T}
_
T{
pkt4\-nak\-received
T}	T{
integer
T}	T{
تعداد بسته‌های DHCPNAK دریافت‌شده.
انتظار می‌رود این آماره همیشه صفر
بماند، چرا که بسته‌های DHCPNAK توسط
کارساز ارسال می‌شوند و هرگز انتظار
نمی‌رود کارساز آن‌ها را دریافت کند.
یک مقدار غیرصفر نشان‌دهنده خطا است.
یکی از علل محتمل می‌تواند عامل رله‌ای
باشد که رفتار نادرست داشته و پیام‌های
DHCPNAK را به جای کارخواه‌ها، به اشتباه
به سمت کارساز بازمی‌گرداند.
T}
_
T{
pkt4\-release\-received
T}	T{
integer
T}	T{
تعداد بسته‌های DHCPRELEASE
دریافت‌شده. انتظار می‌رود این آماره
افزایش یابد. رشد آن نشان می‌دهد
کارخواه‌هایی که دارای نشانی بوده‌اند
در حال خاموش شدن هستند یا از
استفاده از نشانی‌هایشان دست می‌کشند.
T}
_
T{
pkt4\-decline\-received
T}	T{
integer
T}	T{
تعداد بسته‌های DHCPDECLINE
دریافت‌شده. انتظار می‌رود این آماره
نزدیک به صفر باقی بماند. افزایش آن
نشان می‌دهد که یک کارخواه نشانی‌ای را
اجاره کرده، اما متوجه شده است که آن
نشانی در حال حاضر توسط یک دستگاه
ناشناس در جای دیگری از شبکه در حال
استفاده است.
T}
_
T{
pkt4\-inform\-received
T}	T{
integer
T}	T{
تعداد بسته‌های DHCPINFORM
دریافت‌شده. انتظار می‌رود این آماره
افزایش یابد. رشد آن بدان معناست که
کارخواه‌هایی وجود دارند که یا نیازی
به نشانی ندارند یا از قبل نشانی دارند
و تنها علاقه‌مند به دریافت پارامترهای
پیکربندی اضافی هستند.
T}
_
T{
pkt4\-lease\-query\-received
T}	T{
integer
T}	T{
تعداد بسته‌های DHCPLEASEQUERY
دریافت‌شده توسط کتابخانه قلاب
leasequery. انتظار می‌رود این آماره
افزایش یابد.
T}
_
T{
pkt4\-unknown\-received
T}	T{
integer
T}	T{
تعداد بسته‌های دریافتی با نوع ناشناخته.
مقدار غیرصفر این آماره نشان می‌دهد که
کارساز بسته‌ای را دریافت کرده که قادر به
تشخیص آن نبوده است؛ یا با نوعی پشتیبانی‌نشده
یا احتمالاً بدقواره (بدون گزینه message\-type).
T}
_
T{
pkt4\-sent
T}	T{
integer
T}	T{
تعداد بسته‌های DHCPv4 ارسال‌شده.
انتظار می‌رود این آماره با هر بار
ارسال یک بسته توسط کارساز، رشد کند.
به‌طور کلی، این مقدار باید تقریباً با
\fBpkt4\-received\fP همخوانی داشته باشد،
زیرا بیشتر بسته‌های ورودی باعث پاسخ دادن
کارساز می‌شوند. استثناهایی وجود دارد
(مانند DHCPRELEASE)، بنابراین اگر کمتر از
pkt4\-received بود جای نگرانی نیست.
T}
_
T{
pkt4\-offer\-sent
T}	T{
integer
T}	T{
تعداد بسته‌های DHCPOFFER ارسال‌شده.
انتظار می‌رود این آماره در بیشتر موارد پس از
پردازش یک DHCPDISCOVER افزایش یابد. مواردی
نامتداول اما معتبر وجود دارد که بسته‌های
ورودی DHCPDISCOVER دور انداخته می‌شوند، اما
به‌طور کلی انتظار می‌رود این آماره به
\fBpkt4\-discover\-received\fP نزدیک باشد\&.
T}
_
T{
pkt4\-ack\-sent
T}	T{
integer
T}	T{
تعداد بسته‌های DHCPACK ارسال‌شده.
انتظار می‌رود این آماره در بیشتر موارد پس از
پردازش یک DHCPREQUEST افزایش یابد؛ مواردی
وجود دارد که به جای آن DHCPNAK ارسال می‌شود.
به‌طور کلی، مجموع \fBpkt4\-ack\-sent\fP و
\fBpkt4\-nak\-sent\fP باید نزدیک به
\fBpkt4\-request\-received\fP باشد\&.
T}
_
T{
pkt4\-nak\-sent
T}	T{
integer
T}	T{
تعداد بسته‌های DHCPNAK ارسال‌شده.
انتظار می‌رود این آماره زمانی که کارساز
تصمیم می‌گیرد نشانی درخواست‌شده توسط کارخواه
را واگذار نکند، افزایش یابد. به‌طور کلی، مجموع
\fBpkt4\-ack\-sent\fP و \fBpkt4\-nak\-sent\fP باید
نزدیک به \fBpkt4\-request\-received\fP باشد\&.
T}
_
T{
pkt4\-lease\-query\-response\-unassigned\-sent
T}	T{
integer
T}	T{
تعداد بسته‌های DHCPLEASEUNASSIGNED
ارسال‌شده توسط کتابخانه قلاب leasequery.
انتظار می‌رود این آماره افزایش یابد.
T}
_
T{
pkt4\-lease\-query\-response\-unknown\-sent
T}	T{
integer
T}	T{
تعداد بسته‌های DHCPLEASEUNKNOWN
ارسال‌شده توسط کتابخانه قلاب leasequery.
انتظار می‌رود این آماره افزایش یابد.
T}
_
T{
pkt4\-lease\-query\-response\-active\-sent
T}	T{
integer
T}	T{
تعداد بسته‌های DHCPLEASEACTIVE
ارسال‌شده توسط کتابخانه قلاب leasequery.
انتظار می‌رود این آماره افزایش یابد.
T}
_
T{
pkt4\-service\-disabled
T}	T{
integer
T}	T{
تعداد بسته‌های ورودی که هنگام غیرفعال
بودن سرویس DHCP دور انداخته شدند.
T}
_
T{
pkt4\-parse\-failed
T}	T{
integer
T}	T{
تعداد بسته‌های ورودی که تجزیه آن‌ها
ناموفق بود. مقدار غیرصفر این آماره
نشان می‌دهد که کارساز بسته‌ای بدقواره
یا ناقص دریافت کرده است. این ممکن است
نشان‌دهنده مشکلات در شبکه، کارخواه‌های
معیوب، یا وجود باگ در کارساز باشد.
T}
_
T{
pkt4\-queue\-full
T}	T{
integer
T}	T{
تعداد بسته‌های ورودی که به دلیل پر
بودن صفی که قرار بود در آن قرار گیرند،
دور انداخته شدند.
T}
_
T{
pkt4\-duplicate
T}	T{
integer
T}	T{
تعداد بسته‌های ورودی که به دلیل تکراری
شناخته شدن دور انداخته شدند.
T}
_
T{
pkt4\-rfc\-violation
T}	T{
integer
T}	T{
تعداد بسته‌های ورودی که در راستای پیروی
از مشخصات پروتکل دور انداخته شدند.
T}
_
T{
pkt4\-admin\-filtered
T}	T{
integer
T}	T{
تعداد بسته‌های ورودی که به دلیل پیکربندی
کارساز برای این کار دور انداخته شدند، مثلاً
با دسته‌بندی پرس‌وجو در کلاس \fBDROP\fP\&.
T}
_
T{
pkt4\-not\-for\-us
T}	T{
integer
T}	T{
تعداد بسته‌های ورودی که دور انداخته شدند
زیرا باید توسط کارساز دیگری رسیدگی می‌شدند.
T}
_
T{
pkt4\-processing\-failed
T}	T{
integer
T}	T{
تعداد بسته‌های ورودی که دور انداخته شدند
به این دلیل که خطایی غیرمنتظره در حین
پردازش رخ داد.
T}
_
T{
pkt4\-limit\-exceeded
T}	T{
integer
T}	T{
تعداد بسته‌های ورودی که توسط کتابخانه
قلاب \fBlimits\fP دور انداخته شدند.
T}
_
T{
pkt4\-receive\-drop
T}	T{
integer
T}	T{
تعداد بسته‌های ورودی که دور انداخته
شدند. دلیل دقیق دور انداختن بسته‌ها در
گزارش‌ها ثبت می‌شود، اما رایج‌ترین دلایل
ممکن است دریافت نوع بسته غیرقابل‌قبول،
ممنوع بودن پاسخ مستقیم، عدم تطابق
شناسه کارساز ارسال‌شده توسط کارخواه
با شناسه کارساز، یا بروز خطایی غیرمنتظره
در حین پردازش باشد.
T}
_
T{
subnet[id].total\-addresses
T}	T{
integer
T}	T{
تعداد کل نشانی‌های موجود برای مدیریت
DHCPv4 برای یک زیرشبکه مشخص؛ به بیان
دیگر، این تعداد کل نشانی‌ها در همه
استخرهای پیکربندی‌شده است. این آماره
تنها هنگام به‌روزرسانی پیکربندی تغییر
می‌کند. نشانی‌هایی که ممکن است به دلیل
رزرو میزبان رزرو شده باشند را در نظر
نمی‌گیرد. شناسه \fIid\fP شناسه زیرشبکه
مربوط به یک زیرشبکه داده‌شده است.
این آماره برای هر زیرشبکه به صورت جداگانه
ارائه می‌شود و در طول رویداد پیکربندی
مجدد، بازنشانی می‌شود.
T}
_
T{
subnet[id].pool[pid].total\-addresses
T}	T{
integer
T}	T{
تعداد کل نشانی‌های موجود برای مدیریت
DHCPv4 برای یک استخر زیرشبکه مشخص؛ به بیان
دیگر، این تعداد کل نشانی‌ها در استخر
زیرشبکه پیکربندی‌شده است. این آماره تنها
هنگام به‌روزرسانی پیکربندی تغییر می‌کند.
نشانی‌هایی که ممکن است به دلیل رزرو میزبان
رزرو شده باشند را در نظر نمی‌گیرد. شناسه
\fIid\fP شناسه زیرشبکه مربوط به یک زیرشبکه
مشخص است. مقدار \fIpid\fP شناسه استخر مربوط به
یک استخر مشخص است. این آماره برای هر استخر
زیرشبکه به طور جداگانه ارائه شده و در زمان
رویداد پیکربندی مجدد، بازنشانی می‌شود.
T}
_
T{
assigned\-addresses
T}	T{
integer
T}	T{
تعداد نشانی‌های تخصیص‌یافته. با هر بار
اختصاص یک اجاره جدید (در نتیجه دریافت
پیام DHCPREQUEST) افزایش یافته و با هر بار
آزادسازی یک اجاره (دریافت پیام DHCPRELEASE)
یا انقضای آن کاهش می‌یابد، و در طول رویداد
پیکربندی مجدد بازنشانی می‌شود.
T}
_
T{
cumulative\-assigned\-addresses
T}	T{
integer
T}	T{
تعداد تجمعی نشانی‌هایی که از زمان
راه‌اندازی کارساز تخصیص داده شده‌اند.
با هر بار تخصیص یک نشانی افزایش می‌یابد
و در رویداد پیکربندی مجدد بازنشانی نمی‌شود.
T}
_
T{
subnet[id].cumulative\-assigned\-addresses
T}	T{
integer
T}	T{
تعداد تجمعی نشانی‌های تخصیص‌یافته
در یک زیرشبکه مشخص. با هر بار اختصاص
یک اجاره جدید (در نتیجه دریافت پیام
DHCPREQUEST) افزایش می‌یابد و هرگز کاهش
نمی‌یابد. شناسه \fIid\fP شناسه زیرشبکه
است. این آماره برای هر زیرشبکه به صورت
جداگانه ارائه می‌شود و در طول رویداد
پیکربندی مجدد، بازنشانی می‌شود.
T}
_
T{
subnet[id].pool[pid].cumulative\-assigned\-addresses
T}	T{
integer
T}	T{
تعداد تجمعی نشانی‌های تخصیص‌یافته در
یک استخر زیرشبکه مشخص. با هر بار اختصاص
یک اجاره جدید (در نتیجه دریافت پیام
DHCPREQUEST) افزایش می‌یابد و هرگز کاهش
نمی‌یابد. شناسه \fIid\fP شناسه زیرشبکه است.
مقدار \fIpid\fP شناسه استخر مربوط به استخر
است. این آماره برای هر استخر زیرشبکه به
صورت جداگانه ارائه می‌شود و در طول رویداد
پیکربندی مجدد، بازنشانی می‌شود.
T}
_
T{
subnet[id].assigned\-addresses
T}	T{
integer
T}	T{
تعداد نشانی‌های تخصیص‌یافته در یک
زیرشبکه مشخص. با هر بار اختصاص اجاره
جدید (در نتیجه دریافت پیام DHCPREQUEST)
افزایش یافته و با هر بار آزادسازی اجاره
(دریافت پیام DHCPRELEASE) یا انقضای آن
کاهش می‌یابد. شناسه \fIid\fP شناسه زیرشبکه
است. این آماره برای هر زیرشبکه به صورت
جداگانه ارائه می‌شود و در طول رویداد
پیکربندی مجدد، بازنشانی می‌شود.
T}
_
T{
subnet[id].pool[pid].assigned\-addresses
T}	T{
integer
T}	T{
تعداد نشانی‌های تخصیص‌یافته در یک
استخر زیرشبکه مشخص. با هر بار اختصاص
اجاره جدید (در نتیجه دریافت پیام DHCPREQUEST)
افزایش یافته و با هر بار آزادسازی اجاره
(دریافت پیام DHCPRELEASE) یا انقضای آن
کاهش می‌یابد. شناسه \fIid\fP شناسه زیرشبکه
است. شناسه \fIpid\fP شناسه استخر مربوطه
است. این آماره برای هر استخر زیرشبکه به
طور جداگانه ارائه می‌شود و در رویداد
پیکربندی مجدد، بازنشانی می‌گردد.
T}
_
T{
reclaimed\-leases
T}	T{
integer
T}	T{
تعداد اجاره‌های منقضی‌شده‌ای که از زمان
راه‌اندازی کارساز بازپس گرفته شده‌اند.
با هر بار بازپس‌گیری یک اجاره منقضی‌شده
افزایش یافته و هرگز کاهش نمی‌یابد. این آماره
می‌تواند به عنوان یک شاخص بلندمدت از تعداد
واقعی اجاره‌های بازپس‌گرفته‌شده استفاده
شود. این یک آماره سراسری است که همه
زیرشبکه‌ها را پوشش می‌دهد.
T}
_
T{
subnet[id].reclaimed\-leases
T}	T{
integer
T}	T{
تعداد اجاره‌های منقضی‌شده مرتبط با یک
زیرشبکه مشخص که از زمان راه‌اندازی کارساز
بازپس گرفته شده‌اند. با هر بار بازپس‌گیری
یک اجاره منقضی‌شده افزایش می‌یابد. شناسه
\fIid\fP شناسه زیرشبکه برای یک زیرشبکه مشخص
است. این آماره برای هر زیرشبکه به طور
جداگانه ارائه می‌شود.
T}
_
T{
subnet[id].pool[pid].reclaimed\-leases
T}	T{
integer
T}	T{
تعداد اجاره‌های منقضی‌شده مرتبط با یک
استخر زیرشبکه مشخص که از زمان راه‌اندازی
کارساز بازپس گرفته شده‌اند. با هر بار
بازپس‌گیری یک اجاره منقضی‌شده افزایش
می‌یابد. شناسه \fIid\fP شناسه زیرشبکه یک
زیرشبکه مشخص است. شناسه \fIpid\fP شناسه استخر
مربوطه است. این آماره برای هر استخر
زیرشبکه به طور جداگانه ارائه می‌شود.
T}
_
T{
declined\-addresses
T}	T{
integer
T}	T{
تعداد نشانی‌های IPv4 که در حال حاضر رد شده‌اند
(declined)؛ شمارشی از تعداد اجاره‌هایی که
اکنون در دسترس نیستند. به محض بازیابی یک
اجاره، این آماره کاهش می‌یابد؛ در حالت
ایده‌آل، این آماره باید صفر باشد. اگر این
آماره غیرصفر باشد یا افزایش یابد، مدیر شبکه
باید بررسی کند که آیا دستگاهی با رفتار
نادرست در شبکه وجود دارد یا خیر. این یک
آماره سراسری است که همه زیرشبکه‌ها را
پوشش می‌دهد.
T}
_
T{
subnet[id].declined\-addresses
T}	T{
integer
T}	T{
تعداد نشانی‌های IPv4 که در حال حاضر در یک
زیرشبکه مشخص رد شده‌اند؛ شمارشی از تعداد
اجاره‌هایی که در حال حاضر در دسترس نیستند.
به محض بازیابی یک اجاره، این آماره کاهش
می‌یابد؛ در حالت ایده‌آل، این آماره باید
صفر باشد. اگر این آماره غیرصفر باشد یا
افزایش یابد، مدیر شبکه باید بررسی کند که آیا
دستگاهی با رفتار نادرست در شبکه وجود دارد
یا خیر. شناسه \fIid\fP شناسه زیرشبکه مربوط
به یک زیرشبکه مشخص است. این آماره برای
هر زیرشبکه به صورت جداگانه ارائه می‌شود.
T}
_
T{
subnet[id].pool[pid].declined\-addresses
T}	T{
integer
T}	T{
تعداد نشانی‌های IPv4 که در حال حاضر در یک
استخر زیرشبکه مشخص رد شده‌اند؛ شمارشی از
تعداد اجاره‌هایی که در حال حاضر در دسترس
نیستند. به محض بازیابی یک اجاره، این آماره
کاهش می‌یابد؛ در حالت ایده‌آل، این آماره
باید صفر باشد. اگر این آماره غیرصفر باشد یا
افزایش یابد، مدیر شبکه باید بررسی کند که
آیا دستگاهی با رفتار نادرست در شبکه وجود
دارد یا خیر. شناسه \fIid\fP شناسه زیرشبکه یک
زیرشبکه مشخص است. شناسه \fIpid\fP شناسه استخر
مربوطه است. این آماره برای هر استخر زیرشبکه
به صورت جداگانه ارائه می‌شود.
T}
_
T{
reclaimed\-declined\-addresses
T}	T{
integer
T}	T{
تعداد نشانی‌های IPv4 که رد شده بودند، اما
اکنون بازیابی شده‌اند. بر خلاف
\fBdeclined\-addresses\fP، این آماره هرگز
کاهش نمی‌یابد. می‌توان از آن به عنوان یک
شاخص بلندمدت استفاده کرد که نشان می‌دهد چه
تعداد رد معتبر واقعی پردازش شده و نشانی
آن‌ها بازیابی شده است. این یک آماره سراسری
است که همه زیرشبکه‌ها را پوشش می‌دهد.
T}
_
T{
subnet[id].reclaimed\-declined\-addresses
T}	T{
integer
T}	T{
تعداد نشانی‌های IPv4 که رد شده بودند، اما
اکنون بازیابی شده‌اند. بر خلاف
\fBdeclined\-addresses\fP، این آماره هرگز
کاهش نمی‌یابد. می‌توان از آن به عنوان یک
شاخص بلندمدت استفاده کرد که نشان می‌دهد چه
تعداد رد معتبر واقعی پردازش شده و نشانی
آن‌ها بازیابی شده است. شناسه \fIid\fP شناسه
زیرشبکه یک زیرشبکه مشخص است. این آماره برای
هر زیرشبکه به صورت جداگانه ارائه می‌شود.
T}
_
T{
subnet[id].pool[pid].reclaimed\-declined\-addresses
T}	T{
integer
T}	T{
تعداد نشانی‌های IPv4 که رد شده بودند، اما
اکنون بازیابی شده‌اند. بر خلاف
\fBdeclined\-addresses\fP، این آماره هرگز
کاهش نمی‌یابد. می‌توان از آن به عنوان یک
شاخص بلندمدت استفاده کرد که نشان می‌دهد چه
تعداد رد معتبر واقعی پردازش شده و نشانی
آن‌ها بازیابی شده است. شناسه \fIid\fP شناسه
زیرشبکه یک زیرشبکه مشخص است. مقدار \fIpid\fP
شناسه استخر مربوطه است. این آماره برای هر
استخر زیرشبکه به صورت جداگانه ارائه می‌شود.
T}
_
T{
pkt4\-lease\-query\-received
T}	T{
integer
T}	T{
تعداد بسته‌های DHCPLEASEQUERY برای IPv4
که دریافت شده‌اند. (تنها در صورتی وجود دارد
که کتابخانه قلاب Leasequery بارگیری شده باشد.)
T}
_
T{
pkt4\-lease\-query\-response\-unknown\-sent
T}	T{
integer
T}	T{
تعداد پاسخ‌های DHCPLEASEUNKNOWN برای IPv4
که ارسال شده‌اند. (تنها در صورتی وجود دارد
که کتابخانه قلاب Leasequery بارگیری شده باشد.)
T}
_
T{
pkt4\-lease\-query\-response\-unassigned\-sent
T}	T{
integer
T}	T{
تعداد پاسخ‌های DHCPLEASEUNASSIGNED برای IPv4
که ارسال شده‌اند. (تنها در صورتی وجود دارد
که کتابخانه قلاب Leasequery بارگیری شده باشد.)
T}
_
T{
pkt4\-lease\-query\-response\-active\-sent
T}	T{
integer
T}	T{
تعداد پاسخ‌های DHCPLEASEACTIVE برای IPv4
که ارسال شده‌اند. (تنها در صورتی وجود دارد
که کتابخانه قلاب Leasequery بارگیری شده باشد.)
T}
_
T{
v4\-allocation\-fail
T}	T{
integer
T}	T{
تعداد کل شکست‌های تخصیص نشانی برای یک
کارخواه خاص. این شامل تعداد تلاش‌های تخصیص
اجاره است که کارساز پیش از انصراف انجام
داده، در صورتی که نتوانسته باشد از هیچ‌یک از
استخرهای نشانی استفاده کند. این یک آماره
سراسری است که تمام زیرشبکه‌ها را پوشش
می‌دهد.
T}
_
T{
subnet[id].v4\-allocation\-fail
T}	T{
integer
T}	T{
تعداد کل شکست‌های تخصیص نشانی برای یک
کارخواه خاص. این شامل تعداد تلاش‌های تخصیص
اجاره است که کارساز پیش از انصراف انجام
داده، در صورتی که نتوانسته باشد از هیچ‌یک از
استخرهای نشانی استفاده کند. شناسه \fIid\fP
شناسه زیرشبکه یک زیرشبکه مشخص است. این
آماره برای هر زیرشبکه به صورت جداگانه
ارائه می‌شود.
T}
_
T{
v4\-allocation\-fail\-shared\-network
T}	T{
integer
T}	T{
تعداد شکست‌های تخصیص نشانی برای یک
کارخواه خاص متصل به یک شبکه مشترک
(shared network). این یک آماره سراسری است
که تمام زیرشبکه‌ها را پوشش می‌دهد.
T}
_
T{
subnet[id].v4\-allocation\-fail\-shared\-network
T}	T{
integer
T}	T{
تعداد شکست‌های تخصیص نشانی برای یک
کارخواه خاص متصل به یک شبکه مشترک.
شناسه \fIid\fP شناسه زیرشبکه یک زیرشبکه
مشخص است. این آماره برای هر زیرشبکه به
صورت جداگانه ارائه می‌شود.
T}
_
T{
v4\-allocation\-fail\-subnet
T}	T{
integer
T}	T{
تعداد شکست‌های تخصیص نشانی برای یک
کارخواه خاص متصل به زیرشبکه‌ای که به
یک شبکه مشترک تعلق ندارد. این یک آماره
سراسری است که تمام زیرشبکه‌ها را پوشش
می‌دهد.
T}
_
T{
subnet[id].v4\-allocation\-fail\-subnet
T}	T{
integer
T}	T{
تعداد شکست‌های تخصیص نشانی برای یک
کارخواه خاص متصل به زیرشبکه‌ای که به
یک شبکه مشترک تعلق ندارد. شناسه \fIid\fP
شناسه زیرشبکه یک زیرشبکه مشخص است.
این آماره برای هر زیرشبکه به صورت
جداگانه ارائه می‌شود.
T}
_
T{
v4\-allocation\-fail\-no\-pools
T}	T{
integer
T}	T{
تعداد شکست‌های تخصیص نشانی به این دلیل که
کارساز نتوانست از هیچ‌یک از استخرهای
پیکربندی‌شده برای یک کارخواه خاص استفاده
کند. همچنین ممکن است تمام زیرشبکه‌هایی که
کارساز تلاش کرده از آن‌ها نشانی اختصاص دهد،
فاقد استخر نشانی باشند. در این حالت، اگر
اپراتور انتظار دارد به برخی کارخواه‌ها نشانی
پویا تخصیص یابد، این وضعیت باید یک پیکربندی
نادرست تلقی شود. این یک آماره سراسری است که
تمام زیرشبکه‌ها را پوشش می‌دهد.
T}
_
T{
subnet[id].v4\-allocation\-fail\-no\-pools
T}	T{
integer
T}	T{
تعداد شکست‌های تخصیص نشانی به این دلیل که
کارساز نتوانست از هیچ‌یک از استخرهای
پیکربندی‌شده برای یک کارخواه خاص استفاده
کند. همچنین ممکن است تمام زیرشبکه‌هایی که
کارساز تلاش کرده از آن‌ها نشانی اختصاص دهد،
فاقد استخر نشانی باشند. در این حالت، اگر
اپراتور انتظار دارد به برخی کارخواه‌ها نشانی
پویا تخصیص یابد، این وضعیت باید یک پیکربندی
نادرست تلقی شود. شناسه \fIid\fP شناسه زیرشبکه
یک زیرشبکه مشخص است. این آماره برای هر
زیرشبکه به صورت جداگانه ارائه می‌شود.
T}
_
T{
v4\-allocation\-fail\-classes
T}	T{
integer
T}	T{
تعداد شکست‌های تخصیص نشانی هنگامی که بسته
کارخواه متعلق به یک یا چند کلاس است. دلایل
متعددی ممکن است برای عدم اختصاص اجاره وجود
داشته باشد: به عنوان مثال، اگر همه استخرها
نیاز داشته باشند که بسته‌ها به کلاس‌های خاصی
تعلق داشته باشند و بسته ورودی به هیچ‌کدام
تعلق نداشته باشد. حالت دیگری که این اطلاعات
می‌تواند مفید باشد، نشان دادن این است که ظرفیت
نشانی‌های استخر رزروشده برای یک کلاس خاص
به پایان رسیده است. این یک آماره سراسری است
که تمام زیرشبکه‌ها را پوشش می‌دهد.
T}
_
T{
subnet[id].v4\-allocation\-fail\-classes
T}	T{
integer
T}	T{
تعداد شکست‌های تخصیص نشانی هنگامی که بسته
کارخواه متعلق به یک یا چند کلاس است. دلایل
متعددی ممکن است برای عدم اختصاص اجاره وجود
داشته باشد: به عنوان مثال، اگر همه استخرها
نیاز داشته باشند که بسته‌ها به کلاس‌های خاصی
تعلق داشته باشند و بسته ورودی به هیچ‌کدام
تعلق نداشته باشد. حالت دیگری که این اطلاعات
می‌تواند مفید باشد، نشان دادن این است که ظرفیت
نشانی‌های استخر رزروشده برای یک کلاس خاص
به پایان رسیده است. شناسه \fIid\fP شناسه
زیرشبکه یک زیرشبکه مشخص است. این آماره
برای هر زیرشبکه به صورت جداگانه ارائه می‌شود.
T}
_
T{
v4\-lease\-reuses
T}	T{
integer
T}	T{
تعداد دفعاتی که به عنوان بخشی از قابلیت
کَش کردن اجاره (lease caching)، مقدار CLTT
یک اجاره IPv4 در حافظه افزایش یافته و زمان
انقضای آن در حافظه پایدار دست‌نخورده باقی مانده
است. به این عمل «استفاده مجدد از اجاره»
(lease reuse) گفته می‌شود. این آماره
سراسری است.
T}
_
T{
subnet[id].v4\-lease\-reuses
T}	T{
integer
T}	T{
تعداد دفعاتی که به عنوان بخشی از قابلیت
کَش کردن اجاره (lease caching)، مقدار CLTT
یک اجاره IPv4 در حافظه افزایش یافته و زمان
انقضای آن در حافظه پایدار دست‌نخورده باقی مانده
است. به این عمل «استفاده مجدد از اجاره»
گفته می‌شود. این آماره بر پایه هر زیرشبکه
است. شناسه \fIid\fP شناسه زیرشبکه یک زیرشبکه
مشخص است.
T}
_
T{
v4\-reservation\-conflicts
T}	T{
integer
T}	T{
تعداد تداخل‌های تخصیص رزرو میزبان که در
تمامی زیرشبکه‌ها رخ داده است. هنگامی که یک
کارخواه DHCP Discover ارسال می‌کند و با یک
رزرو میزبان تطبیق داده می‌شود که پیش‌تر به
کارخواه دیگری اجاره داده شده است، این شمارنده
۱ واحد افزایش می‌یابد.
T}
_
T{
subnet[id].v4\-reservation\-conflicts
T}	T{
integer
T}	T{
تعداد تداخل‌های تخصیص رزرو میزبان که در یک
زیرشبکه مشخص رخ داده است. هنگامی که یک
کارخواه DHCP Discover ارسال می‌کند و با یک
رزرو میزبان تطبیق داده می‌شود که پیش‌تر به
کارخواه دیگری اجاره داده شده است، این شمارنده
۱ واحد افزایش می‌یابد.
T}
.TE
.sp
بسته‌های ورودی دور انداخته‌شده می‌توانند در \fBpkt4\-receive\-drop\fP و
یک شمارنده دوم با شرح علت دور انداختن شمرده شوند:
.INDENT 0.0.IP \(bu 2
\fBpkt4\-service\-disabled\fP \- سرویس DHCP غیرفعال است
.IP \(bu 2
\fBpkt4\-parse\-failed\fP \- تجزیه بسته با یک خطای مهلک مواجه شد
.IP \(bu 2
\fBpkt4\-queue\-full\fP \- بسته‌ای که قرار بود در صف قرار گیرد، اما صف پر بود
.IP \(bu 2
\fBpkt4\-duplicate\fP \- تکرار بسته‌ای که در حال پردازش است
.IP \(bu 2
\fBpkt4\-rfc\-violation\fP \- نقض RFC (یعنی مشخصات پروتکل دستور به دور انداختن آنها می‌دهد)
.IP \(bu 2
\fBpkt4\-admin\-filtered\fP \- توسط مدیر فیلتر شده است
.IP \(bu 2
\fBpkt4\-not\-for\-us\fP \- باید توسط سرور دیگری مدیریت شود
.IP \(bu 2
\fBpkt4\-processing\-failed\fP \- دریافت یک خطای غیرمنتظره در حین پردازش
.IP \(bu 2
\fBpkt4\-limit\-exceeded\fP \- توسط کتابخانه هوکِ محدودیت‌ها (libdhcp_limits.so: Limits to Manage Lease Allocation and Packet Processing \%<#\:hooks-limits>)
دور انداخته شد
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
شناسه استخر (pool ID) را می‌توان با تنظیم صریح پارامتر \fBpool\-id\fP
در نگاشت پارامترهای استخر، روی هر استخر پیکربندی کرد. در صورت عدم پیکربندی، مقدار پیش‌فرض \fBpool\-id\fP برابر 0 خواهد بود.
آمار مربوط به شناسه استخر 0 به تمام آمار همه استخرهایی اشاره دارد
که \fBpool\-id\fP آنها پیکربندی نشده است\&.
شناسه استخر نیازی نیست در درون زیرشبکه یا در میان زیرشبکه‌ها یکتا باشد.
آمار مربوط به یک شناسه استخر مشخص در یک زیرشبکه، با
سایر آمار تمام استخرهای دیگری که همان شناسه استخر را در آن زیرشبکه دارند ترکیب می‌شود.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این بخش آمار ویژه DHCPv4 را شرح می‌دهد. برای بررسی اجمالی و
نحوه استفاده از آمار، به Statistics \%<#\:stats>\& مراجعه کنید.
.UNINDENT
.UNINDENT
.sp
سرور DHCPv4 دو پارامتر سراسری را برای کنترل محدودیت‌های پیش‌فرض
نمونه‌های آماری ارائه می‌دهد:
.INDENT 0.0
.IP \(bu 2
\fBstatistic\-default\-sample\-count\fP \- حداکثر تعداد پیش‌فرض نمونه‌هایی
را که باید نگهداری شوند تعیین می‌کند. مقدار ویژه 0 نشان می‌دهد
که باید از حداکثر طول عمر پیش‌فرض استفاده شود.
.IP \(bu 2
\fBstatistic\-default\-sample\-age\fP \- حداکثر طول عمر پیش‌فرض
(به ثانیه) نمونه‌هایی که باید نگهداری شوند را تعیین می‌کند.
.UNINDENT
.sp
به عنوان مثال، برای کاهش بار سربار نگهداری آمار، حداکثر
تعداد نمونه پیش‌فرض را روی 1 تنظیم کنید تا فقط یک نمونه نگهداری شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqstatistic\-default\-sample\-count\(dq: 1,
    \(dqsubnet4\(dq: [
        {
            ...
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
آمارها را می‌توان به‌صورت دوره‌ای بازیابی کرد تا بینش بیشتری نسبت به عملکرد Kea به دست آید. یکی از ابزارهایی که
از این قابلیت بهره می‌برد ISC Stork است. برای جزئیات بیشتر به Monitoring Kea With Stork \%<#\:stork> مراجعه کنید.
.SS "رابط مدیریتی سرور DHCPv4 (Management API for the DHCPv4 Server)"
.sp
رابط مدیریتی (management API) امکان صدور دستورهای مدیریتی خاص،
مانند بازیابی آمار، بازپیکربندی، یا خاموش کردن را فراهم می‌کند. برای جزئیات
بیشتر، به Management API \%<#\:ctrl-channel>\& مراجعه کنید. به‌طور پیش‌فرض هیچ سوکتی
باز نیست؛ برای هدایت Kea به باز کردن یک سوکت، می‌توان از ورودی زیر
در فایل پیکربندی استفاده کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqcontrol\-sockets\(dq: [
        {
            \(dqsocket\-type\(dq: \(dqunix\(dq,
            \(dqsocket\-name\(dq: \(dq/path/to/the/unix/socket\(dq
        }
    ],

    \(dqsubnet4\(dq: [
        {
            ...
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.SS "سوکت کنترلی یونیکس (UNIX Control Socket)"
.sp
تا نسخه 2.7.2 سرور Kea، تنها نوع کانال ارتباطی پشتیبانی‌شده،
سوکت جریانی UNIX با \fBsocket\-type\fP تنظیم‌شده روی \fBunix\fP و
\fBsocket\-name\fP به مسیر فایل سوکت UNIX/LOCAL بود.
.sp
طول مسیر مشخص‌شده توسط پارامتر \fBsocket\-name\fP با حداکثر طول
نام سوکت UNIX در سیستم‌عامل مدیر سیستم، یعنی اندازه فیلد \fBsun_path\fP
در ساختار \fBsockaddr_un\fP منهای ۱ محدود شده است. این مقدار در
سیستم‌های عامل مختلف، بین ۹۱ تا ۱۰۷ نویسه متغیر است. مقادیر معمول
در Linux برابر ۱۰۷ و در FreeBSD برابر ۱۰۳ است.
.sp
برنامه Kea تنها از یک سوکت کنترلی \fBunix\fP در فهرست \(dqcontrol\-sockets\(dq پشتیبانی می‌کند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
از Kea 2.7.9 به بعد، سوکت‌های کنترلی فقط ممکن است در دایرکتوری تعیین‌شده
در حین کامپایل به عنوان \fB\(dq[kea\-install\-dir]/var/run/kea\(dq\fP قرار گیرند،
که همچنین باید دارای مجوزهای دسترسی \fB0750\fP باشد. این مسیر ممکن است در زمان
راه‌اندازی با تنظیم متغیر محیطی \fBKEA_CONTROL_SOCKET_DIR\fP روی مسیر دلخواه بازنویسی شود.
اگر مسیری غیر از این مقدار در \fBsocket\-name\fP استفاده شود، Kea خطایی صادر کرده و
از راه‌اندازی خودداری می‌کند یا اگر از قبل در حال اجرا باشد، یک خطای غیرقابل بازیابی را ثبت می‌کند.
برای سهولت در استفاده، کافی است بخش مسیر را از \fBsocket\-name\fP حذف کنید\&.
.UNINDENT
.UNINDENT
.sp
ارتباط از طریق کانال کنترلی با استفاده از ساختارهای JSON انجام می‌شود.
برای جزئیات بیشتر به بخش Control Channel در
راهنمای توسعه‌دهندگان Kea Developer\(aqs Guide \%<https://\:reports\:.kea\:.isc\:.org/\:dev_guide/\:d2/\:d96/\:ctrlSocket\:.html>
مراجعه کنید.
.sp
سرور DHCPv4 از دستورهای عملیاتی زیر پشتیبانی می‌کند:
.INDENT 0.0
.IP \(bu 2
\fBbuild\-report\fP \%<#\:std-isccmd-build-report>
.IP \(bu 2
\fBconfig\-get\fP \%<#\:std-isccmd-config-get>
.IP \(bu 2
\fBconfig\-hash\-get\fP \%<#\:std-isccmd-config-hash-get>
.IP \(bu 2
\fBconfig\-reload\fP \%<#\:std-isccmd-config-reload>
.IP \(bu 2
\fBconfig\-set\fP \%<#\:std-isccmd-config-set>
.IP \(bu 2
\fBconfig\-test\fP \%<#\:std-isccmd-config-test>
.IP \(bu 2
\fBconfig\-write\fP \%<#\:std-isccmd-config-write>
.IP \(bu 2
\fBdhcp\-disable\fP \%<#\:std-isccmd-dhcp-disable>
.IP \(bu 2
\fBdhcp\-enable\fP \%<#\:std-isccmd-dhcp-enable>
.IP \(bu 2
\fBinterface\-add\fP \%<#\:std-isccmd-interface-add>
.IP \(bu 2
\fBinterface\-list\fP \%<#\:std-isccmd-interface-list>
.IP \(bu 2
\fBinterface\-redetect\fP \%<#\:std-isccmd-interface-redetect>
.IP \(bu 2
\fBleases\-reclaim\fP \%<#\:std-isccmd-leases-reclaim>
.IP \(bu 2
\fBlist\-commands\fP \%<#\:std-isccmd-list-commands>
.IP \(bu 2
\fBshutdown\fP \%<#\:std-isccmd-shutdown>
.IP \(bu 2
\fBstatus\-get\fP \%<#\:std-isccmd-status-get>
.IP \(bu 2
\fBversion\-get\fP \%<#\:std-isccmd-version-get>
.UNINDENT
.sp
همان‌طور که در Commands Supported by Both the DHCPv4 and DHCPv6 Servers \%<#\:commands-common>\& شرح داده شده است. علاوه بر این، از دستورهای
زیر که مرتبط با آمار هستند نیز پشتیبانی می‌کند:
.INDENT 0.0
.IP \(bu 2
\fBstatistic\-get\fP \%<#\:std-isccmd-statistic-get>
.IP \(bu 2
\fBstatistic\-reset\fP \%<#\:std-isccmd-statistic-reset>
.IP \(bu 2
\fBstatistic\-remove\fP \%<#\:std-isccmd-statistic-remove>
.IP \(bu 2
\fBstatistic\-get\fP \%<#\:std-isccmd-statistic-get>\-all
.IP \(bu 2
\fBstatistic\-reset\fP \%<#\:std-isccmd-statistic-reset>\-all
.IP \(bu 2
\fBstatistic\-remove\fP \%<#\:std-isccmd-statistic-remove>\-all
.IP \(bu 2
\fBstatistic\-sample\-age\-set\fP \%<#\:std-isccmd-statistic-sample-age-set>
.IP \(bu 2
\fBstatistic\-sample\-age\-set\fP \%<#\:std-isccmd-statistic-sample-age-set>\-all
.IP \(bu 2
\fBstatistic\-sample\-count\-set\fP \%<#\:std-isccmd-statistic-sample-count-set>
.IP \(bu 2
\fBstatistic\-sample\-count\-set\fP \%<#\:std-isccmd-statistic-sample-count-set>\-all
.UNINDENT
.sp
همان‌طور که در Commands for Manipulating Statistics \%<#\:command-stats>\& شرح داده شده است..SS سوکت کنترل HTTP/HTTPS (HTTP/HTTPS Control Socket)
.sp
مقدار \fBsocket\-type\fP باید \fBhttp\fP یا \fBhttps\fP باشد (هنگامی که نوع \fBhttps\fP باشد،
TLS الزامی است). پارامترهای \fBsocket\-address\fP (پیش‌فرض \fB127.0.0.1\fP) و
\fBsocket\-port\fP (پیش‌فرض 8000) نشانی IP و درگاهی را مشخص می‌کنند که
سرویس HTTP به آن مقید (bound) خواهد شد.
.sp
از Kea 2.7.5 به بعد، پارامتر \fBhttp\-headers\fP فهرستی از سرآیندهای
اضافی HTTP را برای افزودن به پاسخ‌های HTTP مشخص می‌کند.
.sp
پارامترهای \fBtrust\-anchor\fP، \fBcert\-file\fP، \fBkey\-file\fP و \fBcert\-required\fP
راه‌اندازی TLS را برای HTTP، یعنی HTTPS، مشخص می‌کنند. اگر این پارامترها
مشخص نشوند، HTTP استفاده می‌شود. پشتیبانی از TLS/HTTPS در Kea در
TLS/HTTPS Support \%<#\:tls>\& شرح داده شده است.
.sp
احراز هویت پایه HTTP (Basic HTTP authentication) در برابر
استفاده‌های غیرمجاز از سرور توسط کاربران محلی محافظت می‌کند. برای
محافظت در برابر مهاجمان از راه دور، HTTPS و reverse proxy
امنیت قوی‌تری را فراهم می‌سازند.
.sp
احراز هویت در بلوک \fBauthentication\fP همراه با پارامتر
اجباری \fBtype\fP که نوع احراز هویت را انتخاب می‌کند، شرح داده شده است.
در حال حاضر تنها احراز هویت پایه HTTP (نوع basic) پشتیبانی می‌شود.
.sp
پارامتر احراز هویت \fBrealm\fP (پیش‌فرض \fBkea\-dhcpv4\-server\fP)
برای پیام‌های خطا در شرایطی که احراز هویت پایه HTTP الزامی است
اما کلاینت مجاز شناخته نشده، استفاده می‌شود.
.sp
هنگامی که فهرست احراز هویت \fBclients\fP پیکربندی شده و خالی نباشد،
احراز هویت پایه HTTP الزامی است. هر عنصر از فهرست
یک شناسه کاربر و یک گذرواژه را مشخص می‌کند. شناسه کاربر اجباری است، نباید
خالی باشد، و نباید حاوی نویسه دونقطه (:) باشد. گذرواژه
اختیاری است؛ هنگامی که مشخص نشود، یک گذرواژه خالی
استفاده می‌شود.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
شناسه کاربر و گذرواژه احراز هویت پایه HTTP با کدگذاری
UTF\-8 کدگذاری می‌شوند، اما نحو JSON فعلی Kea تنها از زیرمجموعه
یونیکد Latin\-1 (یعنی 0x00..0xff) پشتیبانی می‌کند.
.UNINDENT
.UNINDENT
.sp
برای جلوگیری از افشای شناسه کاربر و/یا گذرواژه
مرتبط، این مقادیر را می‌توان از فایل‌ها خواند. نحو پیکربندی با موارد زیر گسترش یافته است:
.INDENT 0.0
.IP \(bu 2
پارامتر احراز هویت \fBdirectory\fP، که بخش مشترک
مسیرهای فایل را مدیریت می‌کند. مقدار پیش‌فرض یک رشته خالی است.
.IP \(bu 2
پارامتر کلاینت \fBpassword\-file\fP، که در کنار پارامتر \fBdirectory\fP،
مسیر فایلی را مشخص می‌کند که می‌تواند حاوی گذرواژه باشد،
یا در صورتی که شناسه کاربر ارائه نشده باشد، کل عبارت محرمانه احراز هویت پایه HTTP را در بر گیرد.
.IP \(bu 2
پارامتر کلاینت \fBuser\-file\fP، که همراه با پارامتر \fBdirectory\fP،
مسیر فایلی را مشخص می‌کند که شناسه کاربر می‌تواند از آن خوانده شود.
.UNINDENT
.sp
از نسخه Kea\-2.7.6 به بعد، Kea از چندین اتصال HTTP/HTTPS پشتیبانی می‌کند.
هر دو نشانی IPv4 و IPv6 می‌توانند استفاده شوند.
سرور در صورت تغییر نوع سوکت از HTTP به HTTPS
یا از HTTPS به HTTP با استفاده از همان نشانی و درگاه، خطا صادر خواهد کرد. این عمل
مجاز نیست زیرا ممکن است موجب بروز یک مشکل امنیتی ناشی از اشتباه تصادفی
کاربر شود.
هنگام استفاده از دستور \(dqconfig\-set\(dq برای تغییر از HTTP به HTTPS یا
از HTTPS به HTTP، باید یک نشانی یا درگاه متفاوت مشخص شود. همین موضوع
هنگام تغییر فایل پیکربندی و سپس اجرای دستور \(dqconfig\-reload\(dq نیز صدق می‌کند.
.sp
هنگامی که از فایل‌ها استفاده می‌شود، آن‌ها در زمان بارگذاری پیکربندی خوانده می‌شوند
تا خطاهای پیکربندی در سریع‌ترین زمان ممکن شناسایی شوند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqcontrol\-sockets\(dq: [
        {
            \(dqsocket\-type\(dq: \(dqhttps\(dq,
            \(dqsocket\-address\(dq: \(dq10.20.30.40\(dq,
            \(dqsocket\-port\(dq: 8004,
            \(dqhttp\-headers\(dq: [
                {
                    \(dqname\(dq: \(dqStrict\-Transport\-Security\(dq,
                    \(dqvalue\(dq: \(dqmax\-age=31536000\(dq
                 }
            ],
            \(dqtrust\-anchor\(dq: \(dq/path/to/the/ca\-cert.pem\(dq,
            \(dqcert\-file\(dq: \(dq/path/to/the/agent\-cert.pem\(dq,
            \(dqkey\-file\(dq: \(dq/path/to/the/agent\-key.pem\(dq,
            \(dqcert\-required\(dq: true,
            \(dqauthentication\(dq: {
                \(dqtype\(dq: \(dqbasic\(dq,
                \(dqrealm\(dq: \(dqkea\-dhcpv4\-server\(dq,
                \(dqclients\(dq: [
                {
                    \(dquser\(dq: \(dqadmin\(dq,
                    \(dqpassword\(dq: \(dq1234\(dq
                } ]
            }
        },
        {
            \(dqsocket\-type\(dq: \(dqhttp\(dq,
            \(dqsocket\-address\(dq: \(dq2010:30:40::50\(dq,
            \(dqsocket\-port\(dq: 8004
        }
    ],

    \(dqsubnet4\(dq: [
        {
            ...
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.SS زمینه‌های کاربر در IPv4 (User Contexts in IPv4)
.sp
‏Kea امکان بارگذاری کتابخانه‌های قلاب (hook libraries) را فراهم می‌کند که گاهی می‌توانند
از پارامترهای اضافی بهره‌مند شوند. اگر چنین پارامتری مختص به کل
کتابخانه باشد، معمولاً به عنوان پارامتری برای کتابخانه قلاب تعریف می‌شود.
با این حال، گاهی اوقات لازم است پارامترهایی مشخص شوند که برای هر
استخر (pool) متفاوت باشند.
.sp
برای پیش‌زمینه تکمیلی در مورد ایده user\-context، بخش Comments and User Context \%<#\:user-context> را
ببینید. برای بررسی از دیدگاه قلاب‌ها، بخش User Contexts in Hooks \%<#\:user-context-hooks> را
مشاهده کنید.
.sp
زمینه‌های کاربر (User contexts) را می‌توان در محدوده سراسری (global scope)؛ در سطح
shared\-network، subnet، pool، client\-class، option\-data یا تعاریف (definition)؛
و از طریق رزرو میزبان (host reservation) مشخص کرد. یکی دیگر از ویژگی‌های مفید،
قابلیت ذخیره نظرات یا توضیحات است.
.sp
بیایید حالت فرضی دستگاه‌هایی را در نظر بگیریم که چراغ‌های LED رنگی دارند.
بسته به مکان قرارگیری، آن‌ها باید با نور قرمز، آبی یا سبز روشن شوند. نوشتن
یک کتابخانه قلاب که مقادیر مشخصی را، احتمالاً به عنوان یک گزینه فروشنده (vendor option)،
ارسال کند کار آسانی خواهد بود. با این حال، سرور باید راهی برای تعیین
آن مقدار برای هر pool داشته باشد. این نیاز توسط زمینه‌های کاربر (user contexts)
برطرف می‌شود. در اصل، هر داده کاربری می‌تواند در زمینه کاربر مشخص شود
تا زمانی که یک نگاشت معتبر JSON باشد. برای مثال، مورد دستگاه‌های LED یادشده
می‌تواند به روش زیر پیکربندی شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqsubnet4\(dq: [
        {
        \(dqid\(dq: 1,
        \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
        \(dqpools\(dq: [
        {
            \(dqpool\(dq: \(dq192.0.2.10 \- 192.0.2.20\(dq,
            # This is pool specific user context
            \(dquser\-context\(dq: { \(dqcolor\(dq: \(dqred\(dq }
        }
        ],

        # This is a subnet\-specific user context. Any type
        # of information can be entered here as long as it is valid JSON.
        \(dquser\-context\(dq: {
            \(dqcomment\(dq: \(dqnetwork on the second floor\(dq,
            \(dqlast\-modified\(dq: \(dq2017\-09\-04 13:32\(dq,
            \(dqdescription\(dq: \(dqyou can put anything you like here\(dq,
            \(dqphones\(dq: [ \(dqx1234\(dq, \(dqx2345\(dq ],
            \(dqdevices\-registered\(dq: 42,
            \(dqbilling\(dq: false
        }
    }
    ]
}
.EE
.UNINDENT
.UNINDENT
.sp
‏Kea اطلاعات user\-context را تفسیر یا استفاده نمی‌کند؛ صرفاً آن را
ذخیره می‌کند و در دسترس کتابخانه‌های قلاب قرار می‌دهد. استخراج این اطلاعات
و استفاده از آن به عهده هر کتابخانه قلاب است. تجزیه‌کننده یک مدخل
\fBcomment\fP را به یک زمینه کاربر همراه با آن مدخل ترجمه می‌کند که
امکان ضمیمه کردن یک نظر را در داخل خود پیکربندی فراهم می‌سازد..SS استانداردهای پشتیبانی‌شده DHCP (Supported DHCP Standards)
.sp
استانداردهای زیر در حال حاضر در Kea پشتیبانی می‌شوند:
.INDENT 0.0
.IP \(bu 2
\fIBOOTP Vendor Information Extensions\fP، RFC 1497 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc1497>: این مورد نیازمند بارگذاری قلاب (hook) متن‌باز BOOTP است. برای جزئیات libdhcp_bootp.so: Support for BOOTP Clients \%<#\:hooks-bootp> را ببینید.
.IP \(bu 2
\fIDynamic Host Configuration Protocol\fP، RFC 1531 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc1531>: این RFC منسوخ شده و با RFC 1541 جایگزین شده است که آن هم به نوبه خود با RFC 2131 جایگزین شد. Kea از هر سه RFC پشتیبانی می‌کند.
.IP \(bu 2
\fIClarifications and Extensions for the Bootstrap Protocol\fP، RFC 1532 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc1532>: این RFC خطای نگارشی دارد و به‌سرعت توسط RFC 1542 جایگزین شد. Kea از هر دوی آن‌ها پشتیبانی می‌کند.
.IP \(bu 2
\fIDHCP Options and BOOTP Vendor Extensions\fP، RFC 1533 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc1533>: این RFC منسوخ شده و با RFC 2132 جایگزین شد. با این وجود، Kea از گزینه‌های تعریف‌شده در آن پشتیبانی می‌کند.
.IP \(bu 2
\fIDynamic Host Configuration Protocol\fP، RFC 1541 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc1541>: این RFC منسوخ شده و با RFC 2131 جایگزین شد. Kea از هر دو پشتیبانی می‌کند.
.IP \(bu 2
\fIClarifications and Extensions for the Bootstrap Protocol\fP، RFC 1542 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc1542>: این RFC پشتیبانی می‌شود.
.IP \(bu 2
\fIDynamic Host Configuration Protocol\fP، RFC 2131 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc2131>: پیام‌های پشتیبانی‌شده عبارتند از DHCPDISCOVER (1)، DHCPOFFER (2)، DHCPREQUEST (3)، DHCPRELEASE (7)، DHCPINFORM (8)، DHCPACK (5) و DHCPNAK (6).
.IP \(bu 2
\fIDHCP Options and BOOTP Vendor Extensions\fP، RFC 2132 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc2132>: گزینه‌های پشتیبانی‌شده عبارتند از PAD (0)، END (255)، Message Type (53)، DHCP Server Identifier (54)، Domain Name (15)، DNS Servers (6)، IP Address Lease Time (51)، Subnet Mask (1) و Routers (3).
.IP \(bu 2
\fIDHCP Options for Novell Directory Services\fP، RFC 2241 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc2241>: هر سه گزینه پشتیبانی می‌شوند.
.IP \(bu 2
\fIManagement of IP numbers by peg\-dhcp\fP،
RFC 2322 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc2322>: این RFC پشتیبانی می‌شود، اگرچه برای استقرار کامل به سخت‌افزار اضافی نیاز است.
.IP \(bu 2
\fIDHCP Option for The Open Group\(aqs User Authentication Protocol\fP،
RFC 2485 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc2485>: این گزینه پشتیبانی می‌شود.
.IP \(bu 2
\fIDHCP Option to Disable Stateless Auto\-Configuration in IPv4 Clients\fP،
RFC 2563 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc2563>: این گزینه پشتیبانی می‌شود.
.IP \(bu 2
\fIDHCP Options for Service Location Protocol\fP، RFC 2610 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc2610>: هر دو گزینه پشتیبانی می‌شوند.
.IP \(bu 2
\fIThe Name Service Search Option for DHCP\fP، RFC 2937 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc2937>: این گزینه پشتیبانی می‌شود.
.IP \(bu 2
\fIThe User Class Option for DHCP\fP، RFC 3004 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc3004>:
کلاس کاربر پشتیبانی می‌شود و می‌تواند در هر عبارتی استفاده شود. ساختار گزینه تجزیه نمی‌شود و باید با استفاده از hex به آن ارجاع داده شود.
.IP \(bu 2
\fIThe IPv4 Subnet Selection Option for DHCP\fP، RFC 3011 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc3011>: گزینه subnet\-selection پشتیبانی می‌شود؛ در صورت دریافت در یک بسته، در فرایند انتخاب زیرشبکه استفاده می‌گردد.
.IP \(bu 2
\fIDHCP Relay Agent Information Option\fP، RFC 3046 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc3046>: گزینه‌های Relay Agent Information، Circuit ID و Remote ID پشتیبانی می‌شوند.
.IP \(bu 2
\fIThe DOCSIS (Data\-Over\-Cable Service Interface Specifications) Device Class
DHCP (Dynamic Host Configuration Protocol) Relay Agent Information Sub\-option\fP،
RFC 3256 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc3256>: زیرگزینه DOCSIS پشتیبانی می‌شود و می‌تواند در هر عبارتی استفاده شود.
.IP \(bu 2
\fIEncoding Long Options in the Dynamic Host Configuration Protocol (DHCPv4)\fP،
RFC 3396 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc3396>: کارساز Kea می‌تواند هم گزینه‌های طولانی را دریافت و هم ارسال کند. گزینه‌های طولانی قابل پیکربندی هستند و اگر طول بار داده (payload) بیشتر از ۲۵۵ بایت باشد، Kea آن‌ها را به صورت نمونه‌های جداگانه ارسال می‌کند.
.IP \(bu 2
\fIDynamic Host Configuration Protocol (DHCP) Domain Search Option\fP، RFC 3397 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc3397>: این گزینه پشتیبانی می‌شود.
.IP \(bu 2
\fIThe Classless Static Route Option for Dynamic Host Configuration Protocol
(DHCP) version 4\fP، RFC 3442 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc3442>:
این گزینه پشتیبانی می‌شود.
.IP \(bu 2
\fIDynamic Host Configuration Protocol (DHCP) Option for CableLabs Client
Configuration\fP، RFC 3495 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc3495>:
این گزینه و زیرگزینه‌های ۱، ۲، ۴، ۵، ۶، ۷ و ۸ آن پشتیبانی می‌شوند. برای جزئیات به بخش CableLabs Client Conf Suboptions مراجعه کنید.
.IP \(bu 2
\fILink Selection sub\-option for the Relay Agent Option\fP، RFC 3527 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc3527>: زیرگزینه link selection پشتیبانی می‌شود.
.IP \(bu 2
\fIPacketCable Security Ticket Control Sub\-Option for the DHCP CableLabs
Client Configuration (CCC) Option\fP، RFC 3594 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc3594>: زیرگزینه Security Ticket Control پشتیبانی می‌شود.
.IP \(bu 2
\fIKey Distribution Center (KDC) Server Address Sub\-option for the
Dynamic Host Configuration Protocol (DHCP) CableLabs Client
Configuration (CCC) Option\fP، RFC 3634 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc3634>: زیرگزینه نشانی IP مربوط به Key Distribution Center پشتیبانی می‌شود.
.IP \(bu 2
\fIUnused Dynamic Host Configuration Protocol (DHCP) Option Codes\fP، RFC 3679 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc3679>: Kea از هیچ‌یک از گزینه‌های قدیمی که توسط این RFC منسوخ شده‌اند پشتیبانی نمی‌کند.
.IP \(bu 2
\fIVendor\-Identifying Vendor Options for Dynamic Host Configuration
Protocol version 4\fP، RFC 3925 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc3925>: گزینه‌های Vendor\-Identifying Vendor Class و Vendor\-Identifying Vendor\-Specific Information پشتیبانی می‌شوند.
.IP \(bu 2
\fIReclassifying Dynamic Host Configuration Protocol version 4 (DHCPv4) Options\fP،
RFC 3942 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc3942>: Kea از گزینه‌هایی با کدهای بزرگتر از ۱۲۷ پشتیبانی می‌کند.
.IP \(bu 2
\fISubscriber\-ID Suboption for the DHCP Relay Agent Option\fP، RFC 3993 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc3993>: گزینه Subscriber\-ID پشتیبانی می‌شود.
.IP \(bu 2
\fIDynamic Host Configuration Protocol (DHCP) Options for Broadcast and Multicast
Control Servers\fP، RFC 4280 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc4280>:
گزینه‌های DHCPv4 پشتیبانی می‌شوند.
.IP \(bu 2
\fINode\-specific Client Identifiers for Dynamic Host Configuration Protocol
Version Four (DHCPv4)\fP، RFC 4361 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc4361>:
شناسه DUID در DHCPv4 پشتیبانی می‌شود.
.IP \(bu 2
\fIDynamic Host Configuration Protocol (DHCP) Leasequery\fP، RFC 4388 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc4388>: قابلیت‌های کارساز پشتیبانی می‌شود. این مورد نیازمند قلاب leasequery است. برای جزئیات libdhcp_lease_query.so: Leasequery Support \%<#\:hooks-lease-query> را ببینید.
.IP \(bu 2
\fIDynamic Host Configuration Protocol (DHCP) Options for the Intel Preboot
eXecution Environment (PXE)\fP، RFC 4578 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc4578>: هر سه گزینه تعریف‌شده پشتیبانی می‌شوند.
.IP \(bu 2
\fIA DNS Resource Record (RR) for Encoding Dynamic Host Configuration Protocol
(DHCP) Information (DHCID RR)\fP، RFC 4701 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc4701>:
کارساز DHCPv4 از رکوردهای DHCID پشتیبانی می‌کند. کارساز DHCP\-DDNS باید در حال اجرا باشد تا رکوردهای DHCID را اضافه، به‌روزرسانی و/یا حذف کند.
.IP \(bu 2
\fIThe Dynamic Host Configuration Protocol (DHCP) Client Fully
Qualified Domain Name (FQDN) Option\fP، RFC 4702 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc4702>: کارساز Kea قادر به مدیریت گزینه Client FQDN است. همچنین می‌تواند از مؤلفه \fBkea\-dhcp\-ddns\fP \%<#\:std-iscman-kea-dhcp-ddns> برای آغاز عملیات مناسب به‌روزرسانی DNS استفاده کند.
.IP \(bu 2
\fIResolution of Fully Qualified Domain Name (FQDN) Conflicts among Dynamic
Host Configuration Protocol (DHCP) Clients\fP، RFC 4703 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc4703>: کارساز DHCPv6 از یک کارساز DHCP\-DDNS برای حل تعارض‌ها استفاده می‌کند.
.IP \(bu 2
\fITimezone Options for DHCP\fP: RFC 4833 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc4833>:
هر دو گزینه DHCPv4 پشتیبانی می‌شوند.
.IP \(bu 2
\fIThe Dynamic Host Configuration Protocol Version 4 (DHCPv4) Relay Agent Flags
Suboption\fP: RFC 5010 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc5010>: زیرگزینه Relay Agent Flags برای Kea مفهوم است و می‌تواند در عبارات استفاده شود.
.IP \(bu 2
\fIServer Identifier Override sub\-option for the Relay Agent Option\fP، RFC 5107 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc5107>: زیرگزینه server identifier override پشتیبانی می‌شود. پیاده‌سازی طبق RFC کامل نیست، زیرا کارساز RAI را ذخیره نمی‌کند، اما این کارکرد موارد کاربرد مورد انتظار را پوشش می‌دهد.
.IP \(bu 2
\fIDHCP Options for Protocol for Carrying Authentication for Network Access
(PANA) Authentication Agents\fP: RFC 5192 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc5192>:
گزینه PANA پشتیبانی می‌شود.
.IP \(bu 2
\fIDiscovering Location\-to\-Service Translation (LoST) Servers Using the
Dynamic Host Configuration Protocol (DHCP)\fP: RFC 5223 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc5223>: گزینه LOST پشتیبانی می‌شود.
.IP \(bu 2
\fIControl And Provisioning of Wireless Access Points (CAPWAP) Access Controller
DHCP Option\fP: RFC 5417 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc5417>: گزینه CAPWAP برای IPv4 پشتیبانی می‌شود.
.IP \(bu 2
\fIDHCPv4 Lease Query by Relay Agent Remote ID\fP، RFC 6148 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc6148>: درخواست leasequery بر اساس remote\-id پشتیبانی می‌شود. این مورد نیازمند قلاب leasequery است. برای جزئیات libdhcp_lease_query.so: Leasequery Support \%<#\:hooks-lease-query> را ببینید.
.IP \(bu 2
\fIClient Identifier Option in DHCP Server Replies\fP، RFC 6842 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc6842>: کارساز به صورت پیش‌فرض گزینه \fBclient\-id\fP را بازمی‌گرداند. این قابلیت می‌تواند غیرفعال شود. برای جزئیات Echoing Client\-ID (RFC 6842) را ببینید.
.IP \(bu 2
\fIThe DHCPv4 Relay Agent Identifier Sub\-Option\fP، RFC 6925 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc6925>: گزینه relay\-id پشتیبانی می‌شود و می‌تواند در تمام ویژگی‌هایی که از عبارات استفاده می‌کنند (دسته‌بندی کلاینت، رزروهای flex\-id و غیره) به کار رود.
.IP \(bu 2
\fIDHCPv4 Bulk Leasequery\fP، RFC 6926 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc6926>: کارکرد کارساز (اتصال‌های TCP، انواع پرس‌وجو جدید، پاسخ‌های چندگانه و غیره) پشتیبانی می‌شود. این مورد نیازمند قلاب leasequery است. برای جزئیات libdhcp_lease_query.so: Leasequery Support \%<#\:hooks-lease-query> را ببینید.
.IP \(bu 2
\fIGeneralized UDP Source Port for the DHCP Relay Agent Option\fP، RFC 8357 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc8357>: کارساز Kea زیرگزینه Relay Agent Information Source Port را در پیام دریافت‌شده پردازش می‌کند، درگاه UDP را به خاطر می‌سپارد، و پاسخی را با استفاده از این درگاه UDP برای همان عامل رله بازمی‌فرستد.
.IP \(bu 2
\fICaptive\-Portal Identification in DHCP and Router Advertisements (RAs)\fP، RFC 8910 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc8910>: کارساز Kea می‌تواند هر دو نسخه v4 و v6 گزینه‌های پرتال محدودکننده (captive portal) را پیکربندی کند.
.IP \(bu 2
\fIIPv6\-Only Preferred Option for DHCPv4\fP، RFC 8925 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc8925>: کارساز Kea قادر است استخرها و زیرشبکه‌های خود را به عنوان IPv6\-Only Preferred تعیین کرده و گزینه \fBv6\-only\-preferred\fP را برای کلاینت‌هایی که آن را درخواست کرده‌اند بازپس فرستد.
.IP \(bu 2
\fIDHCP and Router Advertisement Options for the Discovery of Network\-designated
Resolvers (DNR)\fP، RFC 9463 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc9463>\&. کارساز Kea از گزینه DNR پشتیبانی می‌کند.
.UNINDENT.SS تخطی‌های شناخته‌شده از RFC
.sp
در اصل، Kea در پی آن است که یک پیاده‌سازی مرجع باشد و هدف آن پیاده‌سازی ۱۰۰٪ استانداردهای RFC است. با این حال، در برخی موارد جنبه‌های عملی وجود دارند که مانع از پایبندی کامل Kea به متن تمام اسناد RFC می‌شوند.
.INDENT 0.0
.IP \(bu 2
سند RFC 2131 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc2131>، صفحهٔ ۳۰، بیان می‌کند که اگر بستهٔ ورودی DHCPREQUEST فاقد گزینهٔ \(dqrequested IP address\(dq باشد و \fBciaddr\fP نیز تنظیم نشده باشد، کارساز باید با NAK پاسخ دهد. با این حال، کلاینت‌های معیوبی وجود دارند که همواره یک DHCPREQUEST را بدون مشخص کردن این گزینه‌ها ارسال می‌کنند. در این حالت، Kea بستهٔ DHCPREQUEST را می‌پذیرد، نشانی‌ای را اختصاص می‌دهد، و با یک ACK پاسخ می‌دهد.
.IP \(bu 2
سند RFC 2131 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc2131>، جدول ۵، بیان می‌کند که پیام‌های از نوع DHCPDECLINE یا DHCPRELEASE باید گزینهٔ شناسهٔ کارساز (server identifier) را تنظیم کرده باشند و در صورت نبود این گزینه باید رها (drop) شوند. با این حال، ISC DHCP این موضوع را اعمال نمی‌کند، که احتمالاً تلاشی در جهت سازگاری با کلاینت‌های معیوب است، و تیم Kea نیز تصمیم گرفت همین رویه را دنبال کند.
.UNINDENT
.SS محدودیت‌های کارساز DHCPv4
.sp
این موارد محدودیت‌های شناخته‌شدهٔ کنونی نرم‌افزار کارساز Kea DHCPv4 هستند. بیشتر آن‌ها بازتابی از مرحلهٔ فعلی توسعه هستند و باید به جای محدودیت‌های واقعی، به عنوان «هنوز پیاده‌سازی‌نشده» تلقی شوند. با این وجود، برخی از آن‌ها از پیامدهای تصمیمات اتخاذشده در طراحی هستند. این موارد به‌روشنی به همین صورت مشخص شده‌اند.
.INDENT 0.0
.IP \(bu 2
در خانوادهٔ سیستم‌های Linux و BSD، پیام‌های DHCP از طریق سوکت‌های خام (با استفاده از LPF و BPF) ارسال و دریافت می‌شوند و تمام سرآیندهای بسته (از جمله سرآیندهای لایهٔ پیوند داده، IP و UDP) به جای هستهٔ سیستم، توسط Kea ایجاد و تجزیه می‌شوند. در حال حاضر، Kea فقط می‌تواند سرآیندهای لایهٔ پیوند داده با قالبی مطابق با استاندارد IEEE 802.3 را تجزیه کند، و این قالب سرآیند لایهٔ پیوند داده را برای تمامی رابط‌ها فرض می‌گیرد. بنابراین، Kea روی رابط‌هایی که از قالب‌های سرآیند لایهٔ پیوند دادهٔ متفاوتی استفاده می‌کنند (مانند Infiniband) کار نمی‌کند.
.UNINDENT
.SS مثال‌های کارساز DHCPv4 در Kea
.sp
مجموعه‌ای از مثال‌های ساده و کاربردی برای مؤلفهٔ DHCPv4 در Kea همراه با فایل‌های منبع، در دایرکتوری \fBdoc/examples/kea4\fP در دسترس است.
.SS پسانهٔ پیکربندی در DHCPv4
.sp
در بخش پسانهٔ پیکربندی Kea \%<#\:config-backend>، قابلیت پسانهٔ پیکربندی (CB)، کاربردپذیری و محدودیت‌های آن را شرح داده‌ایم. این بخش بر استفاده از CB به همراه کارساز Kea DHCPv4 متمرکز است. این قسمت پارامترهای پشتیبانی‌شده را فهرست می‌کند، محدودیت‌ها را توضیح می‌دهد و مثال‌هایی از پیکربندی کارساز DHCPv4 برای بهره‌برداری از CB ارائه می‌دهد. لطفاً برای استفادهٔ مخصوص DHCPv6 از CB، به بخش متناظر پسانهٔ پیکربندی در DHCPv6 \%<#\:dhcp6-cb> نیز مراجعه کنید.
.SS پارامترهای پشتیبانی‌شده
.sp
هدف نهایی CB این است که به عنوان یک مخزن مرکزی پیکربندی برای یک یا چند کارساز Kea متصل به یک پایگاه‌داده عمل کند. در نسخه‌های کنونیِ پشتیبانی‌شدهٔ Kea، تنها زیرمجموعه‌ای از پارامترهای کارساز DHCPv4 را می‌توان در پایگاه‌داده پیکربندی کرد. سایر پارامترها در صورت نیاز باید در فایل پیکربندی JSON مشخص شوند.
.sp
تمامی پارامترهای پشتیبانی‌شده را می‌توان از طریق \fBlibdhcp_cb_cmds.so\fP \%<#\:std-ischooklib-libdhcp_cb_cmds\:.so>\& پیکربندی کرد. قاعدهٔ کلی بر این است که پارامترهای سراسری نردبانی با استفاده از \fBremote\-global\-parameter4\-set\fP \%<#\:std-isccmd-remote-global-parameter4-set> تنظیم می‌شوند؛ پارامترهای مختص شبکهٔ مشترک با استفاده از \fBremote\-network4\-set\fP \%<#\:std-isccmd-remote-network4-set> تعیین می‌گردند؛ و پارامترهای سطح زیرشبکه و سطح استخر با استفاده از \fBremote\-subnet4\-set\fP \%<#\:std-isccmd-remote-subnet4-set>\& تنظیم می‌شوند. هرگاه استثنایی بر این قاعدهٔ کلی وجود داشته باشد، در جدول برجسته شده است. پارامترهای سراسری غیرنردبانی دارای دستورات اختصاصی هستند؛ برای مثال، گزینه‌های سراسری DHCPv4 (\fBoption\-data\fP) با استفاده از \fBremote\-option4\-global\-set\fP \%<#\:std-isccmd-remote-option4-global-set>\& تغییر می‌یابند. کلاس‌های کلاینت به همراه تعاریف گزینه‌ها و گزینه‌های DHCPv4 مختص به آن کلاس، با استفاده از دستور \fBremote\-class4\-set\fP \%<#\:std-isccmd-remote-class4-set> پیکربندی می‌شوند.
.sp
بخش اشتراک‌گذاری پیکربندی و برچسب‌های کارساز \%<#\:cb-sharing> مفهوم عناصر پیکربندی قابل‌اشتراک و غیرقابل‌اشتراک و محدودیت‌های به‌اشتراک‌گذاری آن‌ها میان چند کارساز را توضیح می‌دهد. در پیکربندی DHCP (چه DHCPv4 و چه DHCPv6)، عناصر پیکربندی قابل‌اشتراک شامل زیرشبکه‌ها و شبکه‌های مشترک هستند. بنابراین، می‌توان آن‌ها را به‌طور صریح با چند برچسب کارساز مرتبط کرد. پارامترهای سراسری، تعاریف گزینه‌ها و گزینه‌های سراسری غیرقابل‌اشتراک هستند و تنها می‌توانند با یک برچسب کارساز مرتبط باشند. این قاعده شامل عناصر پیکربندیِ مرتبط با کارسازهای \fBall\fP نمی‌شود. هر عنصر پیکربندی مرتبط با کارسازهای \fBall\fP (با استفاده از کلمهٔ کلیدی \fBall\fP به عنوان برچسب کارساز) توسط تمام کارسازهایی که به پایگاه‌دادهٔ پیکربندی متصل می‌شوند، استفاده می‌شود.
.sp
جدول زیر پارامترهای مختص DHCPv4 پشتیبانی‌شده توسط پسانهٔ پیکربندی را به همراه سطح سلسله‌مراتبی که در حال حاضر در آن پشتیبانی می‌شود، فهرست می‌کند.
.SS فهرست پارامترهای DHCPv4 پشتیبانی‌شده توسط پسانهٔ پیکربندی
.TS
box center;
l|l|l|l|l|l.
T{
پارامتر
T}	T{
سراسری
T}	T{
کلاس
کلاینت
T}	T{
شبکهٔ
مشترک
T}	T{
زیرشبکه
T}	T{
استخر
T}
_
T{
4o6\-interface
T}	T{
n/a
T}	T{
n/a
T}	T{
n/a
T}	T{
بله
T}	T{
n/a
T}
_
T{
4o6\-interface\-id
T}	T{
n/a
T}	T{
n/a
T}	T{
n/a
T}	T{
بله
T}	T{
n/a
T}
_
T{
4o6\-subnet
T}	T{
n/a
T}	T{
n/a
T}	T{
n/a
T}	T{
بله
T}	T{
n/a
T}
_
T{
allocator
T}	T{
بله
T}	T{
n/a
T}	T{
بله
T}	T{
بله
T}	T{
n/a
T}
_
T{
boot\-file\-name
T}	T{
بله
T}	T{
بله
T}	T{
بله
T}	T{
بله
T}	T{
n/a
T}
_
T{
cache\-max\-age
T}	T{
بله
T}	T{
n/a
T}	T{
خیر
T}	T{
خیر
T}	T{
n/a
T}
_
T{
cache\-threshold
T}	T{
بله
T}	T{
n/a
T}	T{
خیر
T}	T{
خیر
T}	T{
n/a
T}
_
T{
calculate\-tee\-times
T}	T{
بله
T}	T{
n/a
T}	T{
بله
T}	T{
بله
T}	T{
n/a
T}
_
T{
client\-class
T}	T{
n/a
T}	T{
n/a
T}	T{
بله
T}	T{
بله
T}	T{
بله
T}
_
T{
ddns\-send\-update
T}	T{
بله
T}	T{
n/a
T}	T{
بله
T}	T{
بله
T}	T{
n/a
T}
_
T{
ddns\-override\-no\-update
T}	T{
بله
T}	T{
n/a
T}	T{
بله
T}	T{
بله
T}	T{
n/a
T}
_
T{
ddns\-override\-client\-update
T}	T{
بله
T}	T{
n/a
T}	T{
بله
T}	T{
بله
T}	T{
n/a
T}
_
T{
ddns\-replace\-client\-name
T}	T{
بله
T}	T{
n/a
T}	T{
بله
T}	T{
بله
T}	T{
n/a
T}
_
T{
ddns\-generated\-prefix
T}	T{
بله
T}	T{
n/a
T}	T{
بله
T}	T{
بله
T}	T{
n/a
T}
_
T{
ddns\-qualifying\-suffix
T}	T{
بله
T}	T{
n/a
T}	T{
بله
T}	T{
بله
T}	T{
n/a
T}
_
T{
decline\-probation\-period
T}	T{
بله
T}	T{
n/a
T}	T{
n/a
T}	T{
n/a
T}	T{
n/a
T}
_
T{
dhcp4o6\-port
T}	T{
بله
T}	T{
n/a
T}	T{
n/a
T}	T{
n/a
T}	T{
n/a
T}
_
T{
echo\-client\-id
T}	T{
بله
T}	T{
n/a
T}	T{
n/a
T}	T{
n/a
T}	T{
n/a
T}
_
T{
hostname\-char\-set
T}	T{
بله
T}	T{
n/a
T}	T{
بله
T}	T{
بله
T}	T{
n/a
T}
_
T{
hostname\-char\-replacement
T}	T{
بله
T}	T{
n/a
T}	T{
بله
T}	T{
بله
T}	T{
n/a
T}
_
T{
interface
T}	T{
n/a
T}	T{
n/a
T}	T{
بله
T}	T{
بله
T}	T{
n/a
T}
_
T{
match\-client\-id
T}	T{
بله
T}	T{
n/a
T}	T{
بله
T}	T{
بله
T}	T{
n/a
T}
_
T{
min\-valid\-lifetime
T}	T{
بله
T}	T{
بله
T}	T{
بله
T}	T{
بله
T}	T{
n/a
T}
_
T{
max\-valid\-lifetime
T}	T{
بله
T}	T{
بله
T}	T{
بله
T}	T{
بله
T}	T{
n/a
T}
_
T{
next\-server
T}	T{
بله
T}	T{
بله
T}	T{
بله
T}	T{
بله
T}	T{
n/a
T}
_
T{
option\-data
T}	T{
بله (از طریق
remote\-option4\-global\-set)
T}	T{
بله
T}	T{
بله
T}	T{
بله
T}	T{
بله
T}
_
T{
option\-def
T}	T{
بله (از طریق
remote\-option\-def4\-set)
T}	T{
بله
T}	T{
n/a
T}	T{
n/a
T}	T{
n/a
T}
_
T{
rebind\-timer
T}	T{
بله
T}	T{
n/a
T}	T{
بله
T}	T{
بله
T}	T{
n/a
T}
_
T{
renew\-timer
T}	T{
بله
T}	T{
n/a
T}	T{
بله
T}	T{
بله
T}	T{
n/a
T}
_
T{
server\-hostname
T}	T{
بله
T}	T{
بله
T}	T{
بله
T}	T{
بله
T}	T{
n/a
T}
_
T{
valid\-lifetime
T}	T{
بله
T}	T{
بله
T}	T{
بله
T}	T{
بله
T}	T{
n/a
T}
_
T{
relay
T}	T{
n/a
T}	T{
n/a
T}	T{
بله
T}	T{
بله
T}	T{
n/a
T}
_
T{
require\-client\-classes
T}	T{
خیر
T}	T{
n/a
T}	T{
بله
T}	T{
بله
T}	T{
بله
T}
_
T{
evaluate\-additional\-classes
T}	T{
خیر
T}	T{
n/a
T}	T{
بله
T}	T{
بله
T}	T{
بله
T}
_
T{
reservations\-global
T}	T{
بله
T}	T{
n/a
T}	T{
بله
T}	T{
بله
T}	T{
n/a
T}
_
T{
reservations\-in\-subnet
T}	T{
بله
T}	T{
n/a
T}	T{
بله
T}	T{
بله
T}	T{
n/a
T}
_
T{
reservations\-out\-of\-pool
T}	T{
بله
T}	T{
n/a
T}	T{
بله
T}	T{
بله
T}	T{
n/a
T}
_
T{
t1\-percent
T}	T{
بله
T}	T{
n/a
T}	T{
بله
T}	T{
بله
T}	T{
n/a
T}
_
T{
t2\-percent
T}	T{
بله
T}	T{
n/a
T}	T{
بله
T}	T{
بله
T}	T{
n/a
T}
.TE
.INDENT 0.0.IP \(bu 2
\fByes\fP \- نشان می‌دهد که این پارامتر در سطح مشخص‌شده از سلسله‌مراتب پشتیبانی می‌شود و از طریق بک‌اند پیکربندی قابل تنظیم است.
.IP \(bu 2
\fBno\fP \- نشان می‌دهد که یک پارامتر در سطح مشخص‌شده از سلسله‌مراتب پشتیبانی می‌شود، اما از طریق بک‌اند پیکربندی قابل تنظیم نیست.
.IP \(bu 2
\fBn/a\fP \- نشان می‌دهد که پارامتر مربوطه در سطح مشخص‌شده از سلسله‌مراتب قابل اعمال نیست یا سرور از آن پارامتر در آن سطح پشتیبانی نمی‌کند.
.UNINDENT
.sp
برخی از پارامترهای اسکالر موجود در نگاشت‌های سراسری سطح بالا توسط بک‌اند پیکربندی پشتیبانی می‌شوند.
.SS فهرست پارامترهای نگاشت DHCPv4 پشتیبانی‌شده توسط بک‌اند پیکربندی
.TS
box center;
l|l|l.
T{
نام پارامتر (قالب نام‌گذاری مسطح)
T}	T{
نگاشت سراسری
T}	T{
نام پارامتر
T}
_
T{
compatibility.ignore\-dhcp\-server\-identifier
T}	T{
compatibility
T}	T{
ignore\-dhcp\-server\-identifier
T}
_
T{
compatibility.ignore\-rai\-link\-selection
T}	T{
compatibility
T}	T{
ignore\-rai\-link\-selection
T}
_
T{
compatibility.lenient\-option\-parsing
T}	T{
compatibility
T}	T{
lenient\-option\-parsing
T}
_
T{
compatibility.exclude\-first\-last\-24
T}	T{
compatibility
T}	T{
exclude\-first\-last\-24
T}
_
T{
dhcp\-ddns.enable\-updates
T}	T{
dhcp\-ddns
T}	T{
enable\-updates
T}
_
T{
dhcp\-ddns.max\-queue\-size
T}	T{
dhcp\-ddns
T}	T{
max\-queue\-size
T}
_
T{
dhcp\-ddns.ncr\-format
T}	T{
dhcp\-ddns
T}	T{
ncr\-format
T}
_
T{
dhcp\-ddns.ncr\-protocol
T}	T{
dhcp\-ddns
T}	T{
ncr\-protocol
T}
_
T{
dhcp\-ddns.sender\-ip
T}	T{
dhcp\-ddns
T}	T{
sender\-ip
T}
_
T{
dhcp\-ddns.sender\-port
T}	T{
dhcp\-ddns
T}	T{
sender\-port
T}
_
T{
dhcp\-ddns.server\-ip
T}	T{
dhcp\-ddns
T}	T{
server\-ip
T}
_
T{
dhcp\-ddns.server\-port
T}	T{
dhcp\-ddns
T}	T{
server\-port
T}
_
T{
expired\-leases\-processing.flush\-reclaimed\-timer\-wait\-time
T}	T{
expired\-leases\-processing
T}	T{
flush\-reclaimed\-timer\-wait\-time
T}
_
T{
expired\-leases\-processing.hold\-reclaimed\-time
T}	T{
expired\-leases\-processing
T}	T{
hold\-reclaimed\-time
T}
_
T{
expired\-leases\-processing.max\-reclaim\-leases
T}	T{
expired\-leases\-processing
T}	T{
max\-reclaim\-leases
T}
_
T{
expired\-leases\-processing.max\-reclaim\-time
T}	T{
expired\-leases\-processing
T}	T{
max\-reclaim\-time
T}
_
T{
expired\-leases\-processing.reclaim\-timer\-wait\-time
T}	T{
expired\-leases\-processing
T}	T{
reclaim\-timer\-wait\-time
T}
_
T{
expired\-leases\-processing.unwarned\-reclaim\-cycles
T}	T{
expired\-leases\-processing
T}	T{
unwarned\-reclaim\-cycles
T}
_
T{
multi\-threading.enable\-multi\-threading
T}	T{
multi\-threading
T}	T{
enable\-multi\-threading
T}
_
T{
multi\-threading.thread\-pool\-size
T}	T{
multi\-threading
T}	T{
thread\-pool\-size
T}
_
T{
multi\-threading.packet\-queue\-size
T}	T{
multi\-threading
T}	T{
packet\-queue\-size
T}
_
T{
sanity\-checks.lease\-checks
T}	T{
sanity\-checks
T}	T{
lease\-checks
T}
_
T{
sanity\-checks.extended\-info\-checks
T}	T{
sanity\-checks
T}	T{
extended\-info\-checks
T}
_
T{
dhcp\-queue\-control.enable\-queue
T}	T{
dhcp\-queue\-control
T}	T{
enable\-queue
T}
_
T{
dhcp\-queue\-control.queue\-type
T}	T{
dhcp\-queue\-control
T}	T{
queue\-type
T}
_
T{
dhcp\-queue\-control.capacity
T}	T{
dhcp\-queue\-control
T}	T{
capacity
T}
.TE
.sp
برخی از پارامترهای فهرست سراسری که تنها حاوی انواع اسکالر هستند، توسط بک‌اند پیکربندی پشتیبانی می‌شوند..SS فهرست پارامترهای فهرستی DHCPv4 پشتیبانی‌شده توسط بک‌اند پیکربندی
.TS
box center;
l.
T{
نام پارامتر                   | نوع پارامتر نگه‌دارندهٔ فهرست
T}
_
T{
host\-reservation\-identifiers  | string
T}
.TE
.SS فعال‌سازی بک‌اند پیکربندی
.sp
قطعه‌پیکربندی زیر را در نظر بگیرید که از یک پایگاه‌دادهٔ پیکربندی MySQL استفاده می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqDhcp4\(dq: {
        \(dqserver\-tag\(dq: \(dqmy DHCPv4 server\(dq,
        \(dqconfig\-control\(dq: {
            \(dqconfig\-databases\(dq: [
                {
                    \(dqtype\(dq: \(dqmysql\(dq,
                    \(dqname\(dq: \(dqkea\(dq,
                    \(dquser\(dq: \(dqkea\(dq,
                    \(dqpassword\(dq: \(dq1234\(dq,
                    \(dqhost\(dq: \(dq192.0.2.1\(dq,
                    \(dqport\(dq: 3302
                }
            ],
            \(dqconfig\-fetch\-wait\-time\(dq: 20
        },
        \(dqhooks\-libraries\(dq: [
            {
                \(dqlibrary\(dq: \(dqlibdhcp_mysql.so\(dq
            },
            {
                \(dqlibrary\(dq: \(dqlibdhcp_cb_cmds.so\(dq
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
قطعه‌کد زیر استفاده از یک پایگاه‌دادهٔ PostgreSQL را نشان می‌دهد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqDhcp4\(dq: {
        \(dqserver\-tag\(dq: \(dqmy DHCPv4 server\(dq,
        \(dqconfig\-control\(dq: {
            \(dqconfig\-databases\(dq: [
                {
                    \(dqtype\(dq: \(dqpostgresql\(dq,
                    \(dqname\(dq: \(dqkea\(dq,
                    \(dquser\(dq: \(dqkea\(dq,
                    \(dqpassword\(dq: \(dq1234\(dq,
                    \(dqhost\(dq: \(dq192.0.2.1\(dq,
                    \(dqport\(dq: 3302
                }
            ],
            \(dqconfig\-fetch\-wait\-time\(dq: 20
        },
        \(dqhooks\-libraries\(dq: [
            {
                \(dqlibrary\(dq: \(dqlibdhcp_pgsql.so\(dq
            },
            {
                \(dqlibrary\(dq: \(dqlibdhcp_cb_cmds.so\(dq
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نگاشت \fBconfig\-control\fP شامل دو پارامتر است. \fBconfig\-databases\fP فهرستی حاوی یک عنصر است که نوع پایگاه‌داده، مکان آن و اطلاعات هویتی مورد استفاده برای اتصال به این پایگاه‌داده را شامل می‌شود. (توجه داشته باشید پارامترهایی که در اینجا مشخص شده‌اند، با مشخصات پایگاه‌داده برای بک‌اند پایگاه‌دادهٔ اجاره (lease) و بک‌اند پایگاه‌دادهٔ میزبان‌ها مطابقت دارند.) در حال حاضر تنها یک اتصال پایگاه‌داده را می‌توان در فهرست \fBconfig\-databases\fP مشخص کرد. سرور در طول راه‌اندازی یا پیکربندی مجدد به این پایگاه‌داده متصل می‌شود و پیکربندی موجود برای این سرور را از پایگاه‌داده واکشی می‌کند. این پیکربندی در پیکربندی خوانده‌شده از فایل پیکربندی ادغام می‌شود.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
هر زمان که تعارضی بین پارامترهای مشخص‌شده در فایل پیکربندی و پایگاه‌داده وجود داشته باشد، پارامترهای پایگاه‌داده اولویت دارند. ما اکیداً توصیه می‌کنیم از تکرار پارامترها در فایل و پایگاه‌داده خودداری کنید، اما این توصیه توسط سرورهای Kea اجبار نمی‌شود. به‌ویژه، اگر پیکربندی زیرشبکه‌ها از پایگاه‌داده تأمین می‌شود، توصیه می‌کنیم تمام زیرشبکه‌ها در پایگاه‌داده مشخص شوند و هیچ زیرشبکه‌ای در فایل پیکربندی مشخص نشود. امکان تعیین زیرشبکه‌ها در هر دو مکان وجود دارد، اما زیرشبکه‌های موجود در فایل پیکربندی که دارای شناسه‌ها (IDs) و/یا پیشوندهای هم‌پوشان با زیرشبکه‌های پایگاه‌داده باشند، توسط موارد موجود در پایگاه‌داده جایگزین خواهند شد.
.UNINDENT
.UNINDENT
.sp
پس از پیکربندی سرور Kea، این سرور به‌صورت دوره‌ای پایگاه‌داده را برای بررسی تغییرات پیکربندی وارسی (poll) می‌کند. بسامد وارسی توسط پارامتر \fBconfig\-fetch\-wait\-time\fP بر حسب ثانیه کنترل می‌شود؛ این مقدار فاصلهٔ زمانی بین لحظه‌ای است که سرور آخرین وارسی خود (و احتمالاً به‌روزرسانی پیکربندی محلی) را به پایان رسانده و زمانی است که وارسی مجدد را آغاز خواهد کرد. در مثال بالا، این دوره روی ۲۰ ثانیه تنظیم شده است. این بدان معناست که پس از افزودن یک پیکربندی جدید به پایگاه‌داده (مثلاً افزودن یک زیرشبکهٔ جدید)، تا ۲۰ ثانیه (به‌علاوهٔ زمان مورد نیاز برای واکشی و اعمال پیکربندی جدید) طول می‌کشد تا سرور شروع به استفاده از این زیرشبکه کند. هرچه مقدار \fBconfig\-fetch\-wait\-time\fP کمتر باشد، زمان واکنش سرور به به‌روزرسانی‌های افزایشی پیکربندی در پایگاه‌داده کوتاه‌تر خواهد بود. از سوی دیگر، وارسی بیش از حد پایگاه‌داده ممکن است بر عملکرد سرور DHCP تأثیر بگذارد، زیرا سرور باید حداقل یک پرس‌وجو به پایگاه‌داده ارسال کند تا هرگونه به‌روزرسانی معلق پیکربندی را کشف کند. مقدار پیش‌فرض \fBconfig\-fetch\-wait\-time\fP برابر با ۳۰ ثانیه است.
.sp
دستور \fBconfig\-backend\-pull\fP \%<#\:std-isccmd-config-backend-pull> می‌تواند برای وادار کردن سرور به وارسی فوری هرگونه تغییر پیکربندی از پایگاه‌داده و جلوگیری از انتظار برای چرخهٔ واکشی بعدی استفاده شود.
.sp
در مثال‌های پیکربندی بالا، دو کتابخانهٔ قلاب (hook library) بارگذاری شده‌اند. نخستین مورد کتابخانه‌ای است که بک‌اند پیکربندی را برای یک نوع پایگاه‌دادهٔ خاص پیاده‌سازی می‌کند: \fBlibdhcp_mysql.so\fP \%<#\:std-ischooklib-libdhcp_mysql\:.so> پشتیبانی از MySQL را ارائه می‌دهد و \fBlibdhcp_pgsql.so\fP \%<#\:std-ischooklib-libdhcp_pgsql\:.so> پشتیبانی از PostgreSQL را فراهم می‌کند. کتابخانهٔ بارگذاری‌شده باید با \fBtype\fP پایگاه‌داده که در پارامتر \fBconfig\-control\fP مشخص شده مطابقت داشته باشد؛ در غیر این صورت هنگامی که سرور تلاش می‌کند پیکربندی خود را بارگذاری کند، یک خطا ثبت شده و بارگذاری با شکست مواجه می‌شود.
.sp
کتابخانهٔ قلاب دوم، \fBlibdhcp_cb_cmds.so\fP \%<#\:std-ischooklib-libdhcp_cb_cmds\:.so>، اختیاری است. این کتابخانه زمانی باید بارگذاری شود که قرار است از نمونهٔ سرور Kea برای مدیریت پیکربندی در پایگاه‌داده استفاده شود. برای جزئیات بیشتر به بخش libdhcp_cb_cmds.so: Configuration Backend Commands \%<#\:hooks-cb-cmds> مراجعه کنید..SS پارامترهای پیکربندی سازگاری Kea DHCPv4
.sp
هدف ISC این است که Kea اسناد RFC را برای ارتقای سازگاری بهتر با استانداردها رعایت کند. با این حال، پیاده‌سازی‌های معیوب بسیاری از DHCP از قبل وجود دارند که نمی‌توان آن‌ها را به‌راحتی برطرف یا ارتقا داد. بنابراین، Kea یک حالت سازگاری با کاربرد آسان را برای کلاینت‌های خراب یا ناسازگار فراهم می‌کند. برای این منظور، گزینه سازگاری باید فعال شود تا رفتارهای غیرمعمول مجاز شمرده شوند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp4\(dq: {
    \(dqcompatibility\(dq: {
    }
  }
}
.EE
.UNINDENT
.UNINDENT
.SS تجزیه آسان‌گیرانه گزینه‌ها (Lenient Option Parsing)
.sp
به‌طور پیش‌فرض، فیلدهای چندتایی (tuple) تعریف‌شده در گزینه‌های سفارشی به‌عنوان مجموعه‌ای از جفت‌های طول\-مقدار (length\-value) تجزیه می‌شوند.
.sp
با \fB\(dqlenient\-option\-parsing\(dq: true\fP، اگر یک طول از باقی‌مانده بافر گزینه فراتر می‌رفت، نسخه‌های قبلی Kea پیام لاگ \fBunable to
parse the opaque data tuple, the buffer length is x, but the tuple length is y\fP
با شرط \fBx < y\fP را بازمی‌گرداندند؛ این اتفاق دیگر رخ نمی‌دهد. در عوض، مقدار برابر با باقی‌مانده بافر در نظر گرفته می‌شود، یا بر اساس پیام لاگ بالا، طول چندتایی \fBy\fP برابر با \fBx\fP می‌شود\&.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp4\(dq: {
    \(dqcompatibility\(dq: {
      \(dqlenient\-option\-parsing\(dq: true
    }
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
از نسخه 2.5.8 در Kea، این تجزیه گسترش یافته است تا گزینه‌های FQDN (81) دارای برخی نام‌های دامنه نامعتبر را بی‌صدا نادیده بگیرد، و از نسخه 3.1.9 در Kea برای تصحیح پرچم‌های نامعتبر توسعه یافته است، یعنی زمانی که هر دو پرچم \(aqS\(aq و \(aqN\(aq روی 1 تنظیم شده باشند، پرچم \(aqN\(aq جهت سازگاری با رفتار ISC DHCP به 0 بازنشانی می‌شود.
.SS نادیده گرفتن شناسه کارگزار DHCP (DHCP Server Identifier)
.sp
با \fB\(dqignore\-dhcp\-server\-identifier\(dq: true\fP، کارگزار نشانی موجود در گزینه DHCP Server Identifier را بررسی نمی‌کند، یعنی اینکه آیا پرس‌وجو به این کارگزار ارسال شده است یا کارگزاری دیگر (و در حالت دوم رها کردن پرس‌وجو).
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp4\(dq: {
    \(dqcompatibility\(dq: {
      \(dqignore\-dhcp\-server\-identifier\(dq: true
    }
  }
}
.EE
.UNINDENT
.UNINDENT
.SS نادیده گرفتن Link Selection در RAI
.sp
با \fB\(dqignore\-rai\-link\-selection\(dq: true\fP، داده‌های زیرگزینه Relay Agent Information Link Selection برای انتخاب زیرشبکه (subnet) استفاده نمی‌شود. در این حالت، منطق عادی، انتخاب زیرشبکه را هدایت می‌کند، به جای تلاش برای استفاده از زیرشبکه مشخص‌شده توسط این زیرگزینه. این گزینه منطبق بر RFC نیست و به‌طور پیش‌فرض روی \fBfalse\fP تنظیم شده است. تنظیم این گزینه روی \fBtrue\fP می‌تواند به انتخاب زیرشبکه در سناریوهای خاصی کمک کند؛ برای مثال، هنگامی که رله‌های DHCP به مدیر سیستم اجازه نمی‌دهند مشخص کند کدام زیرگزینه‌ها در گزینه Relay Agent Information گنجانده شوند، و اطلاعات Link Selection نادرست را وارد می‌کنند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp4\(dq: {
    \(dqcompatibility\(dq: {
      \(dqignore\-rai\-link\-selection\(dq: true
    }
  }
}
.EE
.UNINDENT
.UNINDENT
.SS مستثنی کردن اولین و آخرین نشانی‌ها در زیرشبکه‌های 24/ یا بزرگ‌تر
.sp
پرچم سازگاری \fBexclude\-first\-last\-24\fP در بخش پیکربندی مخازن نشانی‌های IPv4 توضیح داده شده است (در صورت تنظیم روی true، نشانی‌های 0. و 255. از زیرشبکه‌هایی با طول پیشوند کوچکتر یا مساوی 24 مستثنی می‌شوند).
.SS راهبردهای تخصیص نشانی در DHCPv4
.sp
یک کارگزار DHCP الگوریتم پیچیده‌ای را برای انتخاب یک نشانی IPv4 برای یک کلاینت دنبال می‌کند. این کارگزار ترجیح می‌دهد نشانی‌های خاص درخواست‌شده توسط کلاینت و نشانی‌هایی را که کلاینت برای آن‌ها رزرو دارد، تخصیص دهد.
.sp
اگر کلاینت نشانی خاصی را درخواست نکند و هیچ رزروی نداشته باشد، یا کلاینت‌های دیگر از قبل در حال استفاده از هر یک از نشانی‌های درخواستی باشند، کارگزار باید نشانی دردسترس دیگری را در مخازن پیکربندی‌شده بیابد. تابعی از کارگزار با عنوان \(dqallocator\(dq (تخصیص‌دهنده) در Kea مسئول یافتن یک نشانی در دسترس در چنین مواردی است.
.sp
کارگزار Kea DHCPv4 پارامترهای پیکربندی را برای انتخاب تخصیص‌دهنده‌های مختلف در سطوح سراسری (global)، شبکه مشترک (shared\-network) و زیرشبکه (subnet) ارائه می‌دهد. مثال زیر را در نظر بگیرید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqDhcp4\(dq: {
        \(dqallocator\(dq: \(dqrandom\(dq,
        \(dqsubnet4\(dq: [
            {
                \(dqid\(dq: 1,
                \(dqsubnet\(dq: \(dq10.0.0.0/8\(dq,
                \(dqallocator\(dq: \(dqiterative\(dq
            },
            {
                \(dqid\(dq: 2,
                \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این تخصیص‌دهنده، راهبرد تخصیص پیش‌فرض iterative (تکرارشونده) را در سطح سراسری لغو کرده و در عوض تخصیص random (تصادفی) را انتخاب می‌کند. تخصیص تصادفی برای زیرشبکه با شناسه 2 استفاده خواهد شد، در حالی که تخصیص تکرارشونده برای زیرشبکه با شناسه 1 به کار خواهد رفت.
.sp
بخش‌های زیر تخصیص‌دهنده‌های پشتیبانی‌شده و کاربردهای توصیه‌شده آن‌ها را شرح می‌دهند..SS مقایسه تخصیص‌دهنده‌ها (Allocators Comparison)
.sp
در جدول زیر، تخصیص‌دهنده‌های پشتیبانی‌شده را که همگی در بخش‌های بعدی به تفصیل شرح داده شده‌اند، به‌طور خلاصه مقایسه می‌کنیم.
.SS مقایسه تخصیص‌دهنده‌های اجاره پشتیبانی‌شده توسط Kea DHCPv4
.TS
box center;
l|l|l|l|l|l.
T{
تخصیص‌دهنده
T}	T{
عملکرد در بهره‌برداری پایین
T}	T{
عملکرد در بهره‌برداری بالا
T}	T{
تصادفی‌سازی اجاره
T}	T{
راه‌اندازی/پیکربندی
T}	T{
مصرف حافظه
T}
_
T{
Iterative
T}	T{
بسیار بالا
T}	T{
پایین
T}	T{
خیر
T}	T{
بسیار سریع
T}	T{
پایین
T}
_
T{
Random
T}	T{
بالا
T}	T{
پایین
T}	T{
بله
T}	T{
بسیار سریع
T}	T{
بالا (متغیر)
T}
_
T{
Free Lease Queue
T}	T{
بالا
T}	T{
بالا
T}	T{
بله
T}	T{
کند (بسته به اندازه poolها)
T}	T{
بالا (متغیر)
T}
_
T{
Shared FLQ
T}	T{
بالا
T}	T{
بالا
T}	T{
جزئی، poolهای درون
زیرشبکه‌ها تصادفی هستند
T}	T{
هنگام افزودن، کند؛
پس از افزودن، سریع
T}	T{
پایین
T}
.TE
.SS تخصیص‌دهنده ترتیبی (Iterative Allocator)
.sp
این تخصیص‌دهنده پیش‌فرض مورد استفاده توسط کارساز Kea DHCPv4 است. این تخصیص‌دهنده آخرین آدرس پیشنهادشده را به خاطر می‌سپارد و آن آدرس را به اضافه یک، به کلاینت بعدی پیشنهاد می‌دهد. برای مثال، ممکن است آدرس‌ها را به این ترتیب پیشنهاد دهد: \fB192.0.2.10\fP، \fB192.0.2.11\fP، \fB192.0.2.12\fP و غیره. زمان لازم برای یافتن و پیشنهاد آدرس بعدی بسیار کوتاه است؛ بنابراین، زمانی که میزان بهره‌برداری از pool پایین بوده و احتمال در دسترس بودن آدرس بعدی بالا باشد، این تخصیص‌دهنده بیشترین کارایی را دارد.
.sp
تخصیص ترتیبی زمانی که چند کارساز DHCP یک پایگاه داده اجاره را به اشتراک می‌گذارند یا به یک کلاستر متصل هستند، عملکرد ضعیفی دارد. کارسازها تمایل دارند بلوک‌های مشابهی از آدرس‌ها را به طور مستقل به کلاینت‌های مختلف پیشنهاد داده و تخصیص دهند، که این امر موجب تداخل‌های تخصیص فراوان میان کارسازها و ارسال مجدد درخواست‌ها توسط کلاینت‌ها می‌شود. تخصیص تصادفی با پراکنده‌سازی ترتیب تخصیص، این مشکل را برطرف می‌کند.
.SS تخصیص‌دهنده تصادفی (Random Allocator)
.sp
تخصیص‌دهنده تصادفی از یک تابع تصادفی‌سازی یکنواخت برای انتخاب آدرس‌های پیشنهادی از poolهای زیرشبکه استفاده می‌کند. این روش در استقرارهایی که چند کارساز به یک پایگاه داده مشترک یا یک کلاستر پایگاه داده متصل هستند، بسیار مناسب است. با پراکنده کردن آدرس‌های پیشنهادی، کارسازها خطر تخصیص هم‌زمان یا تقریباً هم‌زمان یک آدرس یکسان به دو کلاینت مختلف را به حداقل می‌رسانند. علاوه بر این، تاب‌آوری کارساز را در برابر حملات مبتنی بر پیش‌بینی‌پذیری تخصیص بهبود می‌بخشد.
.sp
با این حال، تخصیص‌دهنده تصادفی کمی کندتر از تخصیص‌دهنده ترتیبی است. افزون بر این، مصرف حافظه کارساز را افزایش می‌دهد زیرا باید آدرس‌های تصادفی‌شده را به خاطر بسپارد تا از پیشنهاد مکرر آن‌ها جلوگیری کند. مصرف حافظه با افزایش تعداد آدرس‌های پیشنهادی رشد می‌کند؛ به عبارت دیگر، poolهای بزرگ‌تر و کلاینت‌های بیشتر، مصرف حافظه را در تخصیص تصادفی بالا می‌برند.
.sp
قطعه‌پیکربندی زیر نحوه انتخاب تخصیص‌دهنده تصادفی را برای یک زیرشبکه نشان می‌دهد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqDhcp4\(dq: {
        \(dqallocator\(dq: \(dqrandom\(dq,
        \(dqsubnet4\(dq: [
            {
                \(dqid\(dq: 1,
                \(dqsubnet\(dq: \(dq10.0.0.0/8\(dq,
                \(dqallocator\(dq: \(dqrandom\(dq
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT.SS "تخصیص‌دهنده صف اجاره آزاد (Free Lease Queue Allocator)"
.sp
این یک تخصیص‌دهنده (allocator) پیشرفته است که استفاده از آن باید در زیرشبکه‌هایی
با استخرهای آدرس با بهره‌برداری بالا مورد توجه قرار گیرد. در چنین مواردی،
ممکن است زمان قابل‌توجهی طول بکشد تا تخصیص‌دهنده تکرارشونده (iterative)
یا تصادفی (random) یک آدرس در دسترس پیدا کند، زیرا آن‌ها باید مکرراً بررسی کنند
که آیا برای آدرسی که قصد ارائه آن را دارند، اجاره معتبری وجود دارد یا خیر.
هنگامی که استخرهای زیرشبکه به اتمام می‌رسند، تعداد این بررسی‌ها می‌تواند به اندازه
تعداد کل آدرس‌های موجود در زیرشبکه باشد که این امر می‌تواند تأثیر منفی مستقیمی
بر زمان پاسخ‌دهی DHCP به هر درخواست بگذارد.
.sp
تخصیص‌دهنده Free Lease Queue (FLQ) تخصیص‌ها و آزادسازی‌های اجاره را دنبال کرده
و فهرستی جاری از آدرس‌های در دسترس را برای هر استخر آدرس نگهداری می‌کند.
این تخصیص‌دهنده اجازه می‌دهد که یک اجاره در دسترس در زمانی ثابت، صرف‌نظر از میزان
بهره‌برداری استخرهای زیرشبکه، انتخاب شود. تخصیص‌دهنده به‌طور پیوسته فهرست
اجاره‌های آزاد را با حذف هر اجاره تخصیص‌یافته و افزودن موارد رهاشده (released)
یا بازیابی‌شده (reclaimed) به‌روزرسانی می‌کند.
.sp
قطعه‌پیکربندی زیر نحوه انتخاب تخصیص‌دهنده FLQ را برای یک زیرشبکه نشان می‌دهد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqDhcp4\(dq: {
        \(dqsubnet4\(dq: [
            {
                \(dqid\(dq: 1,
                \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
                \(dqallocator\(dq: \(dqflq\(dq
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
چندین ملاحظه وجود دارد که مدیر سیستم باید پیش از استفاده از این تخصیص‌دهنده
مد نظر قرار دهد. تخصیص‌دهنده FLQ می‌تواند تأثیر شدیدی بر زمان راه‌اندازی (startup)
و بازپیکربندی (reconfiguration) سرور بگذارد، زیرا تخصیص‌دهنده باید فهرست
اجاره‌های آزاد را برای هر زیرشبکه‌ای که در آن استفاده می‌شود، پر کند. این تأخیرها هم
در زمان بارگذاری مجدد پیکربندی و هم هنگامی که زیرشبکه‌ها با استفاده از
\fBlibdhcp_subnet_cmds.so\fP \%<#\:std-ischooklib-libdhcp_subnet_cmds\:.so>\& ایجاد می‌شوند، قابل مشاهده است.
این تخصیص‌دهنده مصرف حافظه را متناسب با اندازه کل استخرهای آدرسی که تخصیص‌دهنده FLQ
برای آن‌ها به کار رفته است، برای نگهداری فهرست اجاره‌های آزاد افزایش می‌دهد.
در نهایت، بازیابی اجاره (lease reclamation) باید با مقدار پایینی برای پارامتر
\fBreclaim\-timer\-wait\-time\fP فعال باشد تا اطمینان حاصل شود که سرور به‌طور
مکرر اجاره‌های منقضی‌شده را جمع‌آوری کرده و آن‌ها را از طریق صف اجاره آزاد برای تخصیص
در دسترس قرار می‌دهد؛ اجاره‌های منقضی‌شده تا زمانی که توسط سرور بازیابی نشوند،
از نظر تخصیص‌دهنده آزاد تلقی نمی‌شوند. برای جزئیات بیشتر درباره فرایند بازیابی اجاره،
به Lease Reclamation \%<#\:lease-reclamation> مراجعه کنید.
.sp
ما توصیه می‌کنیم که تخصیص‌دهنده FLQ تنها پس از بررسی دقیق انتخاب شود. برای نمونه،
استفاده از آن برای یک زیرشبکه با استخر \fB/8\fP ممکن است راه‌اندازی سرور را ۱۵ ثانیه
یا بیشتر به تأخیر بیندازد. از سوی دیگر، تأخیر راه‌اندازی و افزایش مصرف حافظه برای
زیرشبکه‌هایی با استخر \fB/16\fP یا کوچک‌تر باید قابل قبول باشد. ما همچنین توصیه
می‌کنیم نوع تخصیص‌دهنده دیگری را در تنظیمات پیکربندی سراسری (global) مشخص کرده
و این انتخاب را در سطح زیرشبکه یا شبکه اشتراکی (shared\-network) بازنویسی (override)
کنید تا تخصیص‌دهنده FLQ فقط برای زیرشبکه‌های منتخب استفاده شود. بدین ترتیب، هنگامی که
یک زیرشبکه جدید بدون تعیین تخصیص‌دهنده اضافه می‌شود، از تنظیم سراسری استفاده شده
و در نتیجه از اثرات نامطلوب و غیرضروری بر زمان راه‌اندازی سرور جلوگیری می‌شود.
.sp
\fBهشدار:\fP
.INDENT 0.0
.INDENT 3.5
تخصیص‌دهنده FLQ برای استفاده با پایگاه‌داده اجاره مشترک مناسب نیست (یعنی هنگامی که
چندین سرور Kea اجاره‌ها را در یک پایگاه‌داده یکسان ذخیره می‌کنند). سرورها از
اجاره‌های منقضی‌شده‌ای که توسط سرورهای همتا بازیابی شده‌اند بی‌خبر می‌مانند و
هرگز آن‌ها را به صف‌های محلی اجاره آزاد خود بازنمی‌گردانند. در نتیجه، سرورها قادر
نخواهند بود برخی از اجاره‌های موجود را به کلاینت‌ها پیشنهاد دهند. تنها سروری که یک
اجاره خاص را بازیابی می‌کند، قادر به ارائه آن خواهد بود.
.UNINDENT
.UNINDENT
.sp
در Kea 3.1.1 یک پارامتر جدید با نام \fBadaptive\-lease\-time\-threshold\fP اضافه شد.
این پارامتر می‌تواند در سطوح سراسری (global)، شبکه اشتراکی (shared network) و
زیرشبکه مشخص شود و مقداری ممیز شناور بین \fB0.0\fP (غیرشامل) و \fB1.0\fP می‌پذیرد\&.
این پارامتر به‌طور پیش‌فرض یا هنگامی که روی \fB1.0\fP تنظیم شده باشد، غیرفعال است\&.
این پارامتر فقط توسط تخصیص‌دهنده FLQ پشتیبانی می‌شود. هنگامی که نرخ اشغال استخرها
در یک زیرشبکه بالاتر از مقدار مشخص‌شده باشد، سرور طول‌عمر معتبر اجاره را برای
کلاینت‌های جدید به میزان مربوطه در \fBmin\-valid\-lifetime\fP کاهش می‌دهد. کلاینت‌هایی
که یک اجاره از پیش موجود را تمدید می‌کنند، حداقل طول‌عمر باقی‌مانده از اجاره فعلی را
دریافت می‌کنند. از آنجا که اجاره‌ها سریع‌تر منقضی می‌شوند، سرور ممکن است سریع‌تر
بازیابی شود یا به‌کلی از اتمام ظرفیت استخر جلوگیری کند.
.sp
نرخ اشغال به‌صورت تعداد آدرس‌های تخصیص‌یافته کنونی (شامل آدرسی که در حال تخصیص است)
تقسیم بر تعداد کل آدرس‌ها در استخرهایی که امکان تخصیص آدرس از آن‌ها وجود دارد، تعریف
می‌شود (یعنی اگر پرس‌وجو عضوی از گارد \fBclient\-classes\fP یک استخر نباشد، آن استخر
به حساب نمی‌آید).
.SS "تخصیص‌دهنده صف اجاره آزاد مشترک (Shared Free Lease Queue Allocator)"
.sp
\fBهشدار:\fP
.INDENT 0.0
.INDENT 3.5
تخصیص‌دهنده Shared Free Lease Queue Allocator که در Kea 3.1.9 اضافه شد، آزمایشی
(experimental) تلقی شده و برای استفاده در محیط عملیاتی (production) پشتیبانی نمی‌شود.
.UNINDENT
.UNINDENT
.sp
تخصیص‌دهنده Shared Free Lease Queue (SFLQ) برای سایت‌هایی با بک‌اندهای اجاره مشترک
(MySQL یا PostgreSQL) و زیرشبکه‌هایی با استخرهای آدرس با بهره‌برداری بالا در نظر گرفته شده
است. در چنین مواردی، ممکن است زمان قابل‌توجهی طول بکشد تا تخصیص‌دهنده تکرارشونده یا
تصادفی یک آدرس در دسترس پیدا کند، زیرا آن‌ها باید مکرراً بررسی کنند که آیا برای
آدرسی که قصد ارائه آن را دارند، اجاره معتبری وجود دارد یا خیر. هنگامی که استخرهای
زیرشبکه به اتمام می‌رسند، تعداد این بررسی‌ها می‌تواند به اندازه تعداد کل آدرس‌های
زیرشبکه باشد. از آنجا که هر بررسی نیازمند یک پرس‌وجو در پایگاه‌داده است، این موضوع
می‌تواند تأثیر منفی مستقیمی بر زمان پاسخ‌دهی DHCP به هر درخواست بگذارد.
.sp
مشابه تخصیص‌دهنده Free Lease Queue، تخصیص‌دهنده SFLQ نیز تخصیص‌ها و آزادسازی‌های
اجاره را دنبال کرده و فهرستی جاری از آدرس‌های در دسترس را برای هر استخر آدرس نگه
می‌دارد. به این فهرست‌ها داده‌های SFLQ گفته می‌شود. این امر اجازه می‌دهد که صرف‌نظر
از میزان بهره‌برداری استخرهای زیرشبکه، یک اجاره در دسترس در زمانی ثابت انتخاب شود.
داده‌های SFLQ از طریق به‌روزرسانی‌های اختصاصی اجاره که توسط سرور Kea برای اجاره‌های
متعلق به زیرشبکه‌های استفاده‌کننده از تخصیص SFLQ به کار گرفته می‌شوند، نگهداری می‌شوند.
.sp
تفاوت اساسی میان تخصیص‌دهنده‌های FLQ و SFLQ در این است که تخصیص SFLQ داده‌های SFLQ
را به‌جای حافظه محلی سرور Kea، به‌صورت متمرکز در بک‌اند اجاره ذخیره می‌کند. این کار
اجازه می‌دهد که این داده‌ها میان سرورها به اشتراک گذاشته شوند، به‌طوری که همگی
درک یکسانی از وضعیت فعلی اجاره‌ها داشته باشند. این امر همچنین بدان معناست که داده‌های
SFLQ پس از ایجاد، پایدار و ماندگار (persistent) هستند و بنابراین نیازی به ایجاد
مجدد آن‌ها هنگام راه‌اندازی یا بازپیکربندی سرور Kea نیست. قطعه‌پیکربندی زیر نحوه
انتخاب تخصیص‌دهنده SFLQ را برای یک زیرشبکه نشان می‌دهد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqDhcp4\(dq: {
        \(dqsubnet4\(dq: [
            {
                \(dqid\(dq: 1,
                \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
                \(dqallocator\(dq: \(dqshared\-flq\(dq
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
ملاحظاتی وجود دارد که مدیر سیستم باید پیش از استفاده از این تخصیص‌دهنده در نظر بگیرد.
همانند FLQ، تخصیص‌دهنده SFLQ می‌تواند تأثیر شدیدی بر زمان راه‌اندازی و بازپیکربندی سرور
بگذارد، زیرا تخصیص‌دهنده باید داده‌های SFLQ را برای هر استخر در هر زیرشبکه‌ای که در آن
استفاده می‌شود ایجاد و پر کند. این تأخیرها هم در هنگام بارگذاری مجدد پیکربندی و هم
زمانی که زیرشبکه‌ها با استفاده از \fBlibdhcp_subnet_cmds.so\fP \%<#\:std-ischooklib-libdhcp_subnet_cmds\:.so>\&
ایجاد می‌شوند، قابل مشاهده است. بر خلاف FLQ، این هزینه‌ها تنها در نخستین باری رخ
می‌دهند که یک زیرشبکه برای استفاده از SFLQ پیکربندی می‌شود یا تغییراتی در محدوده‌های
آدرس استخرهای آن اعمال می‌گردد. به بیانی دیگر، پس از راه‌اندازی مجدد یا بازپیکربندی،
داده‌های SFLQ تنها باید برای استخرهایی ایجاد شوند که پیش‌تر داده‌ای برای آن‌ها ایجاد
نشده است. بنابراین تأثیر آن بر راه‌اندازی‌های مجدد یا بازپیکربندی‌های بعدی زیرشبکه‌هایی
که هم‌اکنون از SFLQ استفاده می‌کنند، حداقلی و ناچیز است.
.sp
از آنجا که داده‌های SFLQ در بک‌اند اجاره نگهداری می‌شوند، هزینه ذخیره‌سازی آن‌ها در
فضای دیسک سرور پایگاه‌داده است نه در حافظه محلی سرور Kea. مصرف دیسک برای داده‌های SFLQ
کسری از اطلاعاتی است که در حال حاضر به ازای هر اجاره ذخیره می‌شود و با افزایش
بهره‌برداری از استخر، حجم داده‌های SFLQ کاهش می‌یابد.
.sp
ما توصیه می‌کنیم که تخصیص‌دهنده SFLQ تنها پس از بررسی دقیق انتخاب شود. همان‌طور که
در بالا بحث شد، تأثیر بر راه‌اندازی هنگام شروع استفاده از SFLQ می‌تواند قابل‌توجه
باشد. ایجاد داده‌های اولیه SFLQ برای استخرهای بزرگ (مانند \(ga\(ga/8\(ga\(ga) ممکن
است راه‌اندازی سرور را برای هر استخر چندین ثانیه یا بیشتر به تأخیر بیندازد. این کار
برای استخرهای کوچک‌تر (مانند \(ga\(ga/16\(ga\(ga یا کمتر) سریع‌تر است، اما در صورت
وجود تعداد زیادی از این استخرها، مجموع زمان صرف‌شده برای هر استخر می‌تواند قابل‌توجه
شود. برای کاهش این هزینه راه‌اندازی، توصیه می‌کنیم نوع دیگری از تخصیص‌دهنده را در
سطح سراسری مشخص کرده و تخصیص‌دهنده SFLQ را در سطح زیرشبکه یا شبکه اشتراکی فقط برای
زیرشبکه‌های منتخب تعیین کنید.
.sp
جنبه مهم دیگری از تخصیص‌دهنده SFLQ وجود دارد که بررسی آن ضروری است. همان‌طور که در بالا
اشاره شد، هنگامی که سروری از تخصیص SFLQ برای استخری مشخص استفاده می‌کند، از
به‌روزرسانی‌های اختصاصی بک‌اند که داده‌های SFLQ را نگهداری می‌کنند، بهره می‌برد.
بنابراین حیاتی است که تمام سرورهایی که یک بک‌اند اجاره را به اشتراک می‌گذارند،
در مورد اینکه کدام زیرشبکه‌ها از تخصیص SFLQ استفاده می‌کنند توافق داشته باشند.
در صورت عدم توافق، داده‌های SFLQ به‌سرعت نادقیق و نادرست خواهند شد. ممکن است آدرس‌ها
آزاد به نظر برسند در حالی که آزاد نیستند و بالعکس. در حالت اول، موتور تخصیص یک
اجاره موجود را شناسایی کرده و آدرس دیگری را امتحان می‌کند. در حالت دوم، اجاره به
کلاینت پیشنهاد نخواهد شد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
اکیداً توصیه می‌شود که پیکربندی زیرشبکه‌ها برای استفاده یا توقف استفاده از تخصیص
SFLQ در بازه‌های تعمیر و نگهداری (maintenance windows) انجام شود، تا در زمان اعمال
تغییرات، سرورها به‌طور فعال به کلاینت‌های آن زیرشبکه‌ها سرویس ندهند. این کار از ایجاد
ناهماهنگی در داده‌های SFLQ جلوگیری می‌کند.
.sp
داده‌های SFLQ بر حسب استخرها ردیابی می‌شوند؛ جایی که هر استخر دارای یک آدرس شروع و
یک آدرس پایان است. تغییرات پیکربندی که محدوده آدرس یک استخر را تغییر می‌دهند یا آن را
به چندین استخر جدید تقسیم می‌کنند، هنگام اعمال پیکربندی جدید باعث ایجاد داده‌های
SFLQ برای استخرهای جدید خواهند شد.
.UNINDENT
.UNINDENT
.sp
همان‌طور که پیش‌تر ذکر شد، هنگامی که یک سرور راه‌اندازی مجدد یا بازپیکربندی می‌شود،
روی زیرشبکه‌های خود پیمایش کرده و تخصیص‌دهنده پیکربندی‌شده را برای استخرهای آن
زیرشبکه راه‌اندازی اولیه (initialize) می‌کند. برای تخصیص‌دهنده SFLQ، این امر باعث
می‌شود سرور از بک‌اند اجاره درخواست کند تا داده‌های SFLQ را برای هر استخر در
زیرشبکه ایجاد کند. اگر داده‌های SFLQ از قبل برای یک استخر موجود باشد، درخواست
بلافاصله بازمی‌گردد. در غیر این صورت، پس از ایجاد داده‌های SFLQ برای آن استخر
بازخواهد گشت. ایجاد داده‌های SFLQ برای یک استخر خاص یک عملیات انحصاری (exclusive)
است. پس از شروع این عملیات توسط یک سرور، هرگونه درخواست از سوی سرورهای دیگر برای
ایجاد داده‌های SFLQ برای همان استخر مسدود (block) شده و تا زمانی که درخواست اول
ایجاد داده‌های SFLQ استخر را کامل نکند، بازنخواهد گشت. بدین ترتیب تنها یک سرور
داده‌های SFLQ استخر را ایجاد می‌کند و سایر سرورها تا زمانی که داده‌های SFLQ آن استخر
وجود نداشته باشد، از استفاده از آن منع می‌شوند. این رفتار برای حفظ نظم در طول
راه‌اندازی‌های مجدد و بازپیکربندی‌های هم‌زمان سرورها طراحی شده است.
.sp
موضوع استخرهای هم‌پوشان (overlapping pools) نیز مطرح است. Kea امکان پیکربندی
استخرهایی را می‌دهد که محدوده آدرس آن‌ها با استخرهای دیگر هم‌پوشانی دارد. تخصیص‌دهنده
SFLQ تا زمانی که تمام این استخرها برای استفاده از تخصیص‌دهنده SFLQ پیکربندی شده
باشند، به‌طور یکپارچه از این مورد پشتیبانی می‌کند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
بازیابی اجاره باید با مقدار پایینی برای پارامتر \fBreclaim\-timer\-wait\-time\fP فعال
باشد تا اطمینان حاصل شود که سرور به‌طور مکرر اجاره‌های منقضی‌شده را جمع‌آوری کرده و
آن‌ها را از طریق داده‌های SFLQ برای تخصیص در دسترس قرار می‌دهد. اجاره‌های منقضی‌شده تا
زمانی که توسط سرور بازیابی نشوند، از نظر تخصیص‌دهنده آزاد تلقی نمی‌شوند. برای جزئیات
بیشتر درباره فرایند بازیابی اجاره، به Lease Reclamation \%<#\:lease-reclamation> مراجعه کنید.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
تخصیص‌دهنده SFLQ به استفاده در استخرهایی محدود شده است که بزرگ‌تر از /8 نباشند
(به عنوان مثال ۱۶۷۷۷۲۱۶ آدرس). استخرهایی با ظرفیت بزرگ‌تر موجب خطای پیکربندی خواهند شد.
.UNINDENT
.UNINDENT
.sp
تخصیص‌دهنده SFLQ از \fBadaptive\-lease\-time\-threshold\fP پشتیبانی نمی‌کند\&..SH "سرور DHCPV6 (THE DHCPV6 SERVER)"
.SS "راه‌اندازی و توقف سرور DHCPv6 (Starting and Stopping the DHCPv6 Server)"
.sp
توصیه می‌شود که سرور Kea DHCPv6 با استفاده از \fBkeactrl\fP \%<#\:std-iscman-keactrl>
(توضیح داده شده در مدیریت Kea با keactrl \%<#\:keactrl>) راه‌اندازی و متوقف شود؛
با این حال، اجرای مستقیم سرور از طریق دستور \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6>
نیز امکان‌پذیر است، که گزینه‌های خط فرمان زیر را می‌پذیرد:
.INDENT 0.0
.IP \(bu 2
\fB\-c file\fP \- فایل پیکربندی را مشخص می‌کند. این تنها گزینه اجباری است.
.IP \(bu 2
\fB\-d\fP \- مشخص می‌کند که آیا ثبت وقایع سرور باید به حالت اشکال‌زدایی/پرگویی
(debug/verbose) تغییر کند یا خیر. در حالت پرگویی، سطح شدت گزارش‌گیری و
debuglevel مشخص‌شده در فایل پیکربندی نادیده گرفته می‌شوند؛ سطح شدت \(dqdebug\(dq
و حداکثر debuglevel (مقدار 99) فرض می‌شوند. این پرچم برای تغییر وضعیت موقت سرور
به حداکثر پرگویی، به عنوان مثال هنگام اشکال‌زدایی، بسیار مناسب است.
.IP \(bu 2
\fB\-p server\-port\fP \- پورت محلی UDP را که سرور روی آن گوش می‌دهد مشخص
می‌کند. این گزینه فقط هنگام آزمایش مفید است، زیرا یک سرور DHCPv6 که روی پورت‌هایی
غیر از پورت‌های استاندارد گوش می‌دهد، قادر به رسیدگی به پرس‌وجوهای عادی DHCPv6 نیست.
.IP \(bu 2
\fB\-P client\-port\fP \- پورت دوردست UDP را که سرور تمام پاسخ‌ها را به آن
ارسال می‌کند مشخص می‌کند. این گزینه فقط هنگام آزمایش مفید است، زیرا یک سرور
DHCPv6 که پاسخ‌ها را به پورت‌هایی غیر از پورت‌های استاندارد ارسال می‌کند، قادر
به رسیدگی به پرس‌وجوهای عادی DHCPv6 نیست.
.IP \(bu 2
\fB\-t file\fP \- یک فایل پیکربندی را جهت آزمایش مشخص می‌کند. \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6>
آن را بارگذاری کرده، بررسی می‌کند و خارج می‌شود. در طول آزمایش، پیام‌های گزارش در
خروجی استاندارد و پیام‌های خطا در خطای استاندارد چاپ می‌شوند. نتیجه آزمایش از
طریق کد خروج گزارش می‌شود (۰ = پیکربندی درست به نظر می‌رسد، ۱ = خطا رخ داده است).
این بررسی جامع نیست؛ برخی از بررسی‌ها فقط هنگام اجرای واقعی سرور امکان‌پذیر هستند.
.IP \(bu 2
\fB\-T file\fP \- یک فایل پیکربندی را جهت آزمایش مشخص می‌کند. \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6>
آن را بارگذاری کرده، بررسی می‌کند و خارج می‌شود. این گزینه بررسی‌های اضافی فراتر از
آنچه \fB\-t\fP ارائه می‌دهد انجام می‌دهد، مانند برقراری اتصالات پایگاه داده (برای
lease backend، host reservations backend، configuration backend و
forensic logging backend)، بارگذاری کتابخانه‌های hook، تجزیه پیکربندی‌های
hook\-library و غیره. این گزینه سوکت‌های UNIX یا TCP/UDP، فایل‌های قفل و همچنین
باز کردن یا چرخش (rotate) فایل‌ها را انجام نمی‌دهد، زیرا هر یک از این اقدامات
می‌تواند با فرایند در حال اجرا روی همان ماشین تداخل داشته باشد.
.IP \(bu 2
\fB\-v\fP \- نسخه Kea را نمایش داده و خارج می‌شود.
.IP \(bu 2
\fB\-V\fP \- نسخه گسترش‌یافته Kea را همراه با پارامترهای اضافی نمایش داده و
خارج می‌شود. این فهرست شامل نسخه کتابخانه‌هایی است که به صورت پویا به Kea
پیوند (link) داده شده‌اند.
.IP \(bu 2
\fB\-W\fP \- گزارش پیکربندی Kea را نمایش داده و خارج می‌شود. این گزارش رونوشتی
از فایل \fBconfig.report\fP تولید شده توسط \fBmeson setup\fP است؛ این گزارش
درون فایل اجرایی باینری گنجانده شده است.
.sp
محتویات فایل \fBconfig.report\fP همچنین می‌تواند با بررسی برخی از کتابخانه‌ها در
درخت نصب یا در درخت کد منبع در دسترس قرار گیرد.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
# from installation using libkea\-process.so
$ strings ${prefix}/lib/libkea\-process.so | sed \-n \(aqs/;;;; //p\(aq

# from sources using libkea\-process.so
$ strings src/lib/process/.libs/libkea\-process.so | sed \-n \(aqs/;;;; //p\(aq

# from sources using libkea\-process.a
$ strings src/lib/process/.libs/libkea\-process.a | sed \-n \(aqs/;;;; //p\(aq

# from sources using libcfgrpt.a
$ strings src/lib/process/cfgrpt/.libs/libcfgrpt.a | sed \-n \(aqs/;;;; //p\(aq
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
\fB\-X\fP \- از نسخه Kea 3.0، محدودیت‌های امنیتی را غیرفعال می‌کند. سرور
همچنان موارد نقض را بررسی می‌کند اما به جای توقف با خطا، هنگام مواجهه با
آن‌ها گزارش‌های هشدار صادر می‌کند. لطفاً برای جزئیات به
Kea Runtime Security Policy Checking \%<#\:sec-kea-runtime-security-policy-checking> مراجعه کنید.
.UNINDENT
.sp
هنگام راه‌اندازی، سرور رابط‌های شبکه موجود را شناسایی کرده و تلاش می‌کند سوکت‌های
UDP را روی تمام رابط‌های فهرست‌شده در فایل پیکربندی باز کند. از آنجا که سرور
DHCPv6 پورت‌های ممتاز (privileged) را باز می‌کند، به دسترسی root نیاز دارد؛
این دیمن باید به عنوان کاربر root اجرا شود.
.sp
در طول راه‌اندازی، سرور تلاش می‌کند یک فایل PID به فرم زیر ایجاد کند:
\fB[pidfile_dir]/[conf name].kea\-dhcp6.pid\fP، که در آن:
.INDENT 0.0
.IP \(bu 2
\fBpidfile_dir\fP \- برابر است با \fB[prefix]/[localstatedir]/run/kea\fP که
در آن \fBprefix\fP و \fBlocalstatedir\fP مقادیری هستند که به meson setup با
استفاده از \fB\-\-prefix\fP و \fB\-\-localstatedir\fP منتقل شده‌اند و به طور
پیش‌فرض به ترتیب \fB/usr/local\fP و \fBvar\fP می‌باشند. بنابراین کل مسیر
\fBpidfile_dir\fP به طور پیش‌فرض \fB/usr/local/var\fP\& است. توجه داشته باشید
که این مقدار ممکن است در زمان اجرا با تنظیم متغیر محیطی \fBKEA_PIDFILE_DIR\fP
که عمدتاً برای اهداف آزمایشی در نظر گرفته شده است، بازنویسی شود.
.IP \(bu 2
\fBconf name\fP: نام فایل پیکربندی مورد استفاده برای راه‌اندازی سرور، منهای تمام
مسیرهای پیشین و پسوند فایل است. به عنوان مثال، در صورت داشتن مسیر
\fB/usr/local/etc/kea/myconf.txt\fP، بخش استفاده‌شده \fBmyconf\fP\& خواهد بود.
.UNINDENT
.sp
اگر فایل از قبل موجود باشد و شامل PID یک فرایند فعال باشد، سرور پیام گزارش
\fBDHCP6_ALREADY_RUNNING\fP را صادر کرده و خارج می‌شود. این احتمال وجود دارد،
اگرچه بعید است، که فایل بازمانده‌ای از یک فروپاشی سیستم (crash) باشد و فرایندی
که PID متعلق به آن است ربطی به Kea نداشته باشد. در چنین حالتی، لازم است فایل
PID را به صورت دستی حذف کنید.
.sp
سرور را می‌توان با استفاده از دستور \fBkill\fP متوقف کرد. هنگام اجرا در کنسول،
سرور را می‌توان با فشردن Ctrl\-c نیز متوقف نمود. Kea این ترکیب کلید را تشخیص
داده و به آرامی و به درستی خاموش می‌شود.
.sp
پیکربندی مجدد هر سرور Kea با دریافت سیگنال SIGHUP آغاز می‌شود. هنگامی که یک
سرور سیگنال SIGHUP را دریافت می‌کند، فایل پیکربندی خود را دوباره می‌خواند و در
صورتی که پیکربندی جدید معتبر باشد، از آن استفاده می‌کند. اگر معلوم شود که
پیکربندی جدید نامعتبر است، سرور پیکربندی فعلی خود را حفظ می‌کند؛ با این حال، در
برخی موارد یک پیام خطای مهلک (fatal) ثبت می‌شود که نشان می‌دهد سرور دیگر هیچ
سرویسی ارائه نمی‌دهد: در این شرایط باید در اسرع وقت یک پیکربندی سالم بارگذاری شود..SS پیکربندی کارگزار DHCPv6
.SS مقدمه
.sp
این بخش نحوه پیکربندی کارگزار DHCPv6 مربوط به Kea را با استفاده از یک فایل
پیکربندی توضیح می‌دهد.
.sp
پیش از آغاز به کار DHCPv6، فایل پیکربندی آن باید
ایجاد شود. پیکربندی پایه‌ای به شرح زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
# DHCPv6 configuration starts on the next line
\(dqDhcp6\(dq: {

# First we set up global values
    \(dqvalid\-lifetime\(dq: 4000,
    \(dqrenew\-timer\(dq: 1000,
    \(dqrebind\-timer\(dq: 2000,
    \(dqpreferred\-lifetime\(dq: 3000,

# Next we set up the interfaces to be used by the server.
    \(dqinterfaces\-config\(dq: {
        \(dqinterfaces\(dq: [ \(dqeth0\(dq ]
    },

# And we specify the type of lease database
    \(dqlease\-database\(dq: {
        \(dqtype\(dq: \(dqmemfile\(dq,
        \(dqpersist\(dq: true,
        \(dqname\(dq: \(dq/var/lib/kea/dhcp6.leases\(dq
    },

# Finally, we list the subnets from which we will be leasing addresses.
    \(dqsubnet6\(dq: [
        {
            \(dqid\(dq: 1,
            \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
            \(dqpools\(dq: [
                {
                    \(dqpool\(dq: \(dq2001:db8:1::1\-2001:db8:1::ffff\(dq
                }
             ]
        }
    ]
# DHCPv6 configuration ends with the next line
}

}
.EE
.UNINDENT
.UNINDENT
.sp
بندهای زیر نمای کلی مختصری از پارامترهای موجود در مثال بالا و همچنین قالب آن‌ها را
ارائه می‌دهند. بخش‌های بعدی این فصل، این پارامترها و موارد دیگر را با جزئیات بسیار بیشتری
بررسی می‌کنند.
.sp
خطوطی که با علامت هش (#) آغاز می‌شوند، توضیح (comment) هستند و توسط کارگزار
نادیده گرفته می‌شوند؛ این خطوط به هیچ وجه بر عملکرد آن تأثیری ندارند.
.sp
پیکربندی در خط نخست با براکت مجعد بازشونده (یا آکولاد باز) اولیه آغاز می‌شود. هر پیکربندی
باید حاوی شیئی باشد که پیکربندی ماژول Kea مصرف‌کننده آن را مشخص می‌کند. در مثال
بالا، این شیء \fBDhcp6\fP نام دارد.
.sp
پیکربندی \fBDhcp6\fP با خط \fB\(dqDhcp6\(dq: {\fP آغاز شده و با آکولاد بسته متناظر
(در مثال بالا، آکولاد پس از آخرین توضیح) پایان می‌یابد. هر آنچه میان این خطوط تعریف
می‌شود، به عنوان پیکربندی \fBDhcp6\fP در نظر گرفته می‌شود.
.sp
به طور کلی، ترتیبی که این پارامترها ظاهر می‌شوند اهمیتی ندارد، اما دو نکته حائز اهمیت وجود
دارد. نخست آنکه فایل پیکربندی باید یک JSON با ساختار صحیح (well\-formed) باشد؛ بدین معنا که
پارامترها برای هر حوزه (scope) مشخص باید با یک کاما از هم جدا شوند، و نباید بعد از آخرین
پارامتر کاما قرار گیرد. هنگام بازچینی فایل پیکربندی، جابه‌جا کردن یک پارامتر به موقعیت آخر
یا از موقعیت آخر در یک حوزه، ممکن است نیازمند جابه‌جایی کاما نیز باشد. نکته دوم این است
که تکرار چندباره یک پارامتر امری نامتداول است — هرچند از نظر قواعد JSON مجاز می‌باشد. اگر چنین
اتفاقی بیفتد، آخرین رخداد یک پارامتر در یک حوزه معین استفاده می‌شود، در حالی که تمامی موارد
پیشین نادیده گرفته می‌شوند. بعید است این موضوع سردرگمی ایجاد کند، چرا که در عمل دلیلی
برای نگه‌داشتن چندین نسخه از یک پارامتر یکسان در فایل پیکربندی وجود ندارد.
.sp
چند مؤلفه نخست در پیکربندی DHCPv6 پارامترهایی سراسری (global) را تعریف
می‌کنند. \fBvalid\-lifetime\fP مشخص می‌کند نشانی‌هایی (اجاره‌هایی یا leases) که توسط کارگزار
واگذار می‌شوند تا چه مدت معتبر هستند؛ مقدار پیش‌فرض این است که کارخواه مجاز به استفاده از نشانی
مشخص‌شده برای مدت ۴۰۰۰ ثانیه باشد. (توجه داشته باشید که اعداد صحیح به همان صورت و بدون هیچ‌گونه
علامت نقل‌قول در اطرافشان مشخص می‌شوند.) این نشانی در ۳۰۰۰ ثانیه منسوخ (deprecated) خواهد شد؛
بدین معنا که کارخواه‌ها مجاز به حفظ اتصالات قدیمی هستند، اما نمی‌توانند از این نشانی برای
ایجاد اتصالات جدید استفاده کنند. \fBrenew\-timer\fP و \fBrebind\-timer\fP مقادیری (همچنین به ثانیه)
هستند که زمان‌سنج‌های T1 و T2 را تعریف می‌کنند؛ این زمان‌سنج‌ها تعیین می‌کنند چه زمانی کارخواه
رویه‌های تجدید (renewal) و اتصال مجدد (rebind) را آغاز کند.
.sp
نگاشت \fBinterfaces\-config\fP رابط‌های شبکه‌ای را مشخص می‌کند که کارگزار باید روی آن‌ها
به پیام‌های DHCP گوش فرا دهد. پارامتر \fBinterfaces\fP فهرستی از رابط‌های شبکه را تعیین
می‌کند که کارگزار باید به آن‌ها گوش دهد. فهرست‌ها با براکت‌های مربعی باز و بسته می‌شوند و
عناصر آن‌ها با کاما از یکدیگر جدا می‌گردند. برای گوش فرا دادن روی دو رابط، مؤلفه
\fBinterfaces\-config\fP باید شبیه به این باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
\(dqinterfaces\-config\(dq: {
    \(dqinterfaces\(dq: [ \(dqeth0\(dq, \(dqeth1\(dq ]
},
\&...
}
.EE
.UNINDENT
.UNINDENT
.sp
خطوط بعدی پایگاه‌داده اجاره (lease database) را تعریف می‌کنند؛ مکانی که کارگزار اطلاعات
اجاره خود را در آن ذخیره می‌نماید. این مثال خاص به کارگزار می‌گوید از memfile استفاده کند
که ساده‌ترین و سریع‌ترین زیرساخت (backend) پایگاه‌داده است. این زیرساخت از یک پایگاه‌داده
درون‌حافظه‌ای بهره می‌برد و اجاره‌ها را روی دیسک در یک فایل CSV (مقادیر جداشده با کاما)
ذخیره می‌کند. این یک مثال پیکربندی بسیار ساده است؛ معمولاً پیکربندی پایگاه‌داده اجاره
مفصل‌تر بوده و شامل پارامترهای تکمیلی است. توجه داشته باشید که \fBlease\-database\fP یک
شیء است و با استفاده از یک آکولاد باز، حوزه جدیدی باز می‌کند. پارامترهای آن (در این مثال
تنها یک مورد: \fBtype\fP) در ادامه می‌آیند. اگر بیش از یک پارامتر وجود داشت، با کاما جدا
می‌شدند. این حوزه با یک آکولاد بسته، پایان می‌یابد. از آنجا که پارامترهای بیشتری برای تعریف
\fBDhcp6\fP در ادامه می‌آیند، یک کاما در انتهای آن قرار گرفته است.
.sp
در نهایت، باید فهرستی از زیرشبکه‌های (subnets) مربوط به IPv6 را تعریف کنیم. این مهم‌ترین
ساختار پیکربندی DHCPv6 است، چرا که کارگزار از این اطلاعات برای پردازش درخواست‌های کارخواه‌ها
استفاده می‌کند. این بخش تمامی زیرشبکه‌هایی را مشخص می‌کند که انتظار می‌رود کارگزار
درخواست‌های DHCP را از آن‌ها دریافت کند. زیرشبکه‌ها با پارامتر \fBsubnet6\fP مشخص می‌شوند.
این پارامتر یک فهرست است، بنابراین با براکت‌های مربعی آغاز شده و پایان می‌یابد. هر تعریف
زیرشبکه در این فهرست دارای چندین صفت وابسته به خود است؛ بنابراین یک ساختار به شمار می‌رود
و با آکولاد باز و بسته می‌شود. در کمترین حالت، تعریف یک زیرشبکه باید حداقل شامل دو پارامتر
باشد: \fBsubnet\fP که کل زیرشبکه را تعریف می‌کند؛ و \fBpools\fP که فهرستی از استخرهای
تخصیص‌یافته به صورت پویا است که توسط کارگزار DHCP اداره می‌شوند.
.sp
این مثال شامل یک زیرشبکه تکی است. در صورتی که بیش از یک مورد تعریف می‌شد، عناصر بیشتری
در پارامتر \fBsubnet6\fP مشخص شده و با کاما از هم جدا می‌شدند. برای نمونه، جهت تعریف دو
زیرشبکه، نحو (syntax) زیر به کار می‌رفت:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
\(dqsubnet6\(dq: [
    {
        \(dqid\(dq: 1,
        \(dqpools\(dq: [ { \(dqpool\(dq: \(dq2001:db8:1::/112\(dq } ],
        \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq
    },
    {
        \(dqid\(dq: 2,
        \(dqpools\(dq: [ { \(dqpool\(dq: \(dq2001:db8:2::1\-2001:db8:2::ffff\(dq } ],
        \(dqsubnet\(dq: \(dq2001:db8:2::/64\(dq
    }
],
\&...
}
.EE
.UNINDENT
.UNINDENT
.sp
توجه داشته باشید که تورفتگی (indentation) اختیاری است و صرفاً به دلایل زیبایی‌شناختی
استفاده می‌شود. در برخی موارد ممکن است ترجیح داده شود از قالب نشانه‌گذاری فشرده‌تری
استفاده شود.
.sp
پس از آنکه تمام پارامترها مشخص شدند، دو زمینه (context) باز وجود دارد:
\fBglobal\fP و \fBDhcp6\fP؛ از این رو، برای بستن آن‌ها باید از دو براکت مجعد بسته (آکولاد بسته)
استفاده شود..SS ذخیره‌سازی اجاره‌ها (Lease Storage)
.sp
تمام اجاره‌های (leases) صادر شده توسط کارساز در پایگاه‌دادهٔ اجاره ذخیره می‌شوند.
سه بک‌اند پایگاه‌داده در دسترس است: memfile
(پیش‌فرض)، MySQL و PostgreSQL.
.SS Memfile \- ذخیره‌سازی پایه‌ای برای اجاره‌ها (Memfile \- Basic Storage for Leases)
.sp
کارساز قادر است داده‌های اجاره را در مخازن مختلفی ذخیره کند. استقرارهای
بزرگ‌تر ممکن است ذخیرهٔ اجاره‌ها در یک پایگاه‌داده را انتخاب کنند؛
بخش «پیکربندی پایگاه‌دادهٔ اجاره» (Lease Database Configuration) این گزینه را شرح می‌دهد. با این حال،
در استقرارهای معمولی و کوچک‌تر، کارساز اطلاعات اجاره را به جای پایگاه‌داده در یک فایل CSV
ذخیره می‌کند. علاوه بر نیاز به مدیریت کمتر، مزیت استفاده از فایل برای ذخیره‌سازی
این است که وابستگی به نرم‌افزارهای پایگاه‌دادهٔ شخص ثالث را برطرف می‌سازد.
.sp
پیکربندی بک‌اند memfile از طریق پارامترهای
\fBDhcp6\fP/\fBlease\-database\fP کنترل می‌شود. پارامتر \fBtype\fP اجباری است
و از طریق مقدار \fB\(dqmemfile\(dq\fP مشخص می‌کند که کارساز باید از کدام محل ذخیره‌سازی
برای اجاره‌ها استفاده کند. فهرست زیر پارامترهای اختیاری بیشتری را ارائه می‌دهد
که می‌توان از آن‌ها برای پیکربندی بک‌اند memfile استفاده کرد.
.INDENT 0.0
.IP \(bu 2
\fBpersist\fP: کنترل می‌کند که آیا اجاره‌های جدید و به‌روزرسانی‌های اجاره‌های
موجود روی فایل نوشته شوند یا خیر. اکیداً توصیه می‌شود که در تمام طول
کارکرد عادی کارساز، مقدار این پارامتر روی \fBtrue\fP تنظیم شده باشد. ننوشتن
اجاره‌ها روی دیسک بدین معناست که اگر کارساز راه‌اندازی مجدد شود (مثلاً پس از قطع برق)،
نخواهد دانست چه آدرس‌هایی واگذار شده‌اند. در نتیجه، ممکن است به کلاینت‌های جدید،
آدرس‌هایی را تخصیص دهد که هم‌اکنون در حال استفاده هستند. مقدار
\fBfalse\fP بیشتر برای اهداف آزمایش کارایی مفید است. مقدار
پیش‌فرض پارامتر \fBpersist\fP برابر با \fBtrue\fP است که
نوشتن به‌روزرسانی‌های اجاره در فایل اجاره را فعال می‌کند.
.IP \(bu 2
\fBname\fP: فایل اجاره‌ای را که اجاره‌های جدید و به‌روزرسانی‌های اجاره در آن
ثبت می‌شوند مشخص می‌کند. مقدار پیش‌فرض این پارامتر
\fB\(dq[kea\-install\-dir]/var/lib/kea/kea\-leases6.csv\(dq\fP\& است.
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
از نسخهٔ Kea 2.7.9 به بعد، فایل‌های اجاره تنها می‌توانند از دایرکتوری داده‌ای که
در زمان کامپایل تعیین شده است بارگیری شوند: \fB\(dq[kea\-install\-dir]/var/lib/kea\(dq\fP\&. این
مسیر را می‌توان در هنگام راه‌اندازی با تنظیم متغیر محیطی
\fBKEA_DHCP_DATA_DIR\fP روی مسیر مورد نظر بازنویسی (override) کرد. اگر در \fBname\fP
مسیری غیر از این مقدار استفاده شود، Kea خطایی صادر کرده و از شروع به کار خودداری می‌کند،
یا اگر از قبل در حال اجرا باشد، یک خطای جبران‌ناپذیر را ثبت می‌کند. برای سهولت در
مشخص کردن نام فایل سفارشی، کافی است بخش مسیر را از \fBname\fP حذف کنید.
.UNINDENT
.UNINDENT
.INDENT 0.0
.IP \(bu 2
\fBlfc\-interval\fP: بازهٔ زمانی (به ثانیه) را تعیین می‌کند که کارساز در آن
یک پاک‌سازی فایل اجاره (LFC) انجام می‌دهد. این فرآیند اطلاعات
مازاد (تاریخچه‌ای) را از فایل اجاره حذف کرده و
به‌طور مؤثری حجم فایل اجاره را کاهش می‌دهد. فرآیند پاک‌سازی
در ادامهٔ همین بخش با جزئیات بیشتری شرح داده شده است. مقدار پیش‌فرض
\fBlfc\-interval\fP برابر با \fB3600\fP است. مقدار \fB0\fP فرآیند LFC را غیرفعال می‌کند.
.IP \(bu 2
\fBmax\-row\-errors\fP: تعداد خطاهای ردیف را پیش از این‌که کارساز
تلاش برای بارگیری فایل اجاره را متوقف کند مشخص می‌کند. هنگامی که کارساز یک فایل اجاره را بارگیری می‌کند، آن را
ردیف به ردیف پردازش می‌کند، که هر ردیف شامل یک اجارهٔ تکی است. اگر یک ردیف معیوب باشد و
نتواند به درستی پردازش شود، کارساز آن را ثبت کرده، آن ردیف را نادیده می‌گیرد
و به ردیف بعدی می‌رود. این پارامتر می‌تواند برای تعیین حد مجاز برای
تعداد دفعات نادیده‌گرفته‌شدن ردیف‌ها استفاده شود، که پس از رسیدن به آن، کارساز
تلاش را متوقف کرده و خارج می‌شود. مقدار پیش‌فرض \fB0\fP این محدودیت را غیرفعال کرده
و به کارساز اجازه می‌دهد صرف‌نظر از این‌که چه تعداد ردیف نادیده گرفته می‌شوند،
کل فایل را پردازش کند.
.UNINDENT
.sp
یک نمونه پیکربندی از بک‌اند memfile در زیر آورده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqlease\-database\(dq: {
        \(dqtype\(dq: \(dqmemfile\(dq,
        \(dqpersist\(dq: true,
        \(dqname\(dq: \(dqkea\-leases6.csv\(dq,
        \(dqlfc\-interval\(dq: 1800,
        \(dqmax\-row\-errors\(dq: 100
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این پیکربندی \fBkea\-leases6.csv\fP را به عنوان فایل ذخیره‌سازی
اطلاعات اجاره انتخاب کرده و پایایی (نوشتن به‌روزرسانی‌های اجاره روی
این فایل) را فعال می‌کند. همچنین بک‌اند را طوری پیکربندی می‌کند که هر ۱۸۰۰ ثانیه
(۳۰ دقیقه) یک‌بار پاک‌سازی دوره‌ای فایل اجاره را انجام دهد و حداکثر تعداد خطاهای
ردیف را روی ۱۰۰ تنظیم می‌کند.
.SS چرا پاک‌سازی فایل اجاره ضروری است؟ (Why Is Lease File Cleanup Necessary?)
.sp
برای درک این‌که چرا پاک‌سازی دوره‌ای فایل اجاره لازم است، دانستن نحوهٔ سازمان‌دهی
محتویات فایل اجاره اهمیت دارد. هر بار که کارساز اجاره‌ای را به‌روزرسانی می‌کند یا اجارهٔ جدیدی
برای یک کلاینت ایجاد می‌کند، اطلاعات اجارهٔ جدید باید در فایل اجاره ثبت شود.
به دلایل کارایی، کارساز اجارهٔ فعلی کلاینت را در فایل به‌روزرسانی نمی‌کند،
زیرا این کار می‌تواند مستلزم بازنویسی کل فایل باشد.
در عوض، صرفاً اطلاعات اجارهٔ جدید را به انتهای فایل پیوست (append) می‌کند؛
مدخل‌های قبلی اجاره برای آن کلاینت حذف نمی‌شوند. هنگامی که
کارساز اجاره‌ها را از فایل اجاره بارگیری می‌کند، مثلاً در هنگام راه‌اندازی کارساز،
فرض می‌کند که آخرین مدخل اجاره برای کلاینت، مدخل معتبر است.
مدخل‌های قبلی نادیده گرفته می‌شوند، بدین معنا که کارساز می‌تواند
اطلاعات دقیقی را دربارهٔ اجاره‌ها بازسازی کند، حتی اگر مدخل‌های اجارهٔ متعددی
برای هر کلاینت وجود داشته باشد. با این وجود، ذخیرهٔ مدخل‌های زیاد
برای هر کلاینت منجر به حجیم شدن فایل اجاره شده و کارایی راه‌اندازی و
پیکربندی مجدد کارساز را دچار اختلال می‌کند، زیرا ناچار است تعداد بیشتری
از مدخل‌های اجاره را پردازش کند.
.sp
پاک‌سازی فایل اجاره (LFC) تمام مدخل‌های پیشین مربوط به هر کلاینت را حذف کرده
و تنها آخرین مدخل‌ها را نگه می‌دارد. بازهٔ زمانی اجرای پاک‌سازی قابل پیکربندی
است و باید متناسب با بسامد تمدیدهای اجاره که از سوی کلاینت‌ها آغاز می‌شود
انتخاب گردد. هرچه تمدیدها مکررتر باشند، مقدار \fBlfc\-interval\fP باید کوچک‌تر
باشد. با این حال، توجه داشته باشید که LFC زمان‌بر است و بنابراین این احتمال
(هرچند بعید) وجود دارد که اگر \fBlfc\-interval\fP بیش از حد کوتاه باشد، یک پاک‌سازی
جدید در حالی آغاز شود که پاک‌سازی قبلی هنوز در حال اجراست. کارساز در صورت تشخیص
این‌که پاک‌سازی پیشین هنوز در جریان است، با صرف‌نظر کردن از پاک‌سازی جدید این موضوع را
مدیریت می‌کند، اما این بدان معناست که پاک‌سازی‌های واقعی با فواصلی طولانی‌تر از بازهٔ
تنظیم‌شده اجرا خواهند شد. علاوه بر این، راه‌اندازی یک فرآیند پاک‌سازی جدید سرباری به کارساز
اضافه می‌کند که باعث می‌شود در بازهٔ زمانی کوتاهی که فرآیند پاک‌سازی جدید ایجاد (spawn) می‌شود،
قادر به پاسخگویی به درخواست‌های جدید نباشد. بنابراین، توصیه می‌شود که مقدار
\fBlfc\-interval\fP به گونه‌ای انتخاب شود که به LFC اجازه دهد پیش از شروع
یک پاک‌سازی جدید، کار خود را به پایان برساند.
.sp
پاک‌سازی فایل اجاره توسط یک فرآیند مجزا (در پس‌زمینه) انجام می‌شود تا
از تأثیر منفی بر کارایی فرآیند کارساز جلوگیری گردد. برای جلوگیری از تداخل
میان دو فرآیند که از فایل‌های اجارهٔ یکسانی استفاده می‌کنند، فرآیند LFC با
باز کردن یک فایل اجارهٔ جدید توسط Kea آغاز می‌شود؛ فرآیند واقعی LFC روی
فایل اجاره‌ای کار می‌کند که دیگر توسط کارساز استفاده نمی‌شود. همچنین فایل‌های
دیگری نیز به عنوان اثر جانبی پاک‌سازی فایل اجاره ایجاد می‌شوند. شرح تفصیلی فرآیند
LFC در ادامهٔ این کتابچهٔ راهنمای مدیران Kea آورده شده است: فرآیند LFC \%<#\:kea-lfc>\&..SS پیکربندی پایگاه دادهٔ اجاره (Lease Database Configuration)
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
اطلاعات دسترسی به پایگاه دادهٔ اجاره باید برای کارگزار DHCPv6 پیکربندی شود، حتی اگر پیش‌تر برای کارگزار DHCPv4 پیکربندی شده باشد. این کارگزارها اطلاعات خود را به طور مستقل ذخیره می‌کنند، بنابراین هر کارگزار می‌تواند از یک پایگاه دادهٔ جداگانه استفاده کند یا هر دو کارگزار می‌توانند از همان پایگاه دادهٔ یکسان استفاده نمایند.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
برنامهٔ Kea نیازمند آن است که منطقهٔ زمانی پایگاه داده با منطقهٔ زمانی سیستم همخوانی داشته باشد. برای جزئیات بیشتر، بخش «First\-Time Creation of the MySQL Database» \%<#\:mysql-database-create> و «First\-Time Creation of the PostgreSQL Database» \%<#\:pgsql-database-create>\& را ببینید.
.UNINDENT
.UNINDENT
.sp
پیکربندی پایگاه دادهٔ اجاره از طریق پارامترهای \fBDhcp6\fP/\fBlease\-database\fP کنترل می‌شود. نوع پایگاه داده باید روی \fBmemfile\fP، \fBmysql\fP یا \fBpostgresql\fP تنظیم شود؛ برای نمونه:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: { \(dqlease\-database\(dq: { \(dqtype\(dq: \(dqmysql\(dq, ... }, ... }
.EE
.UNINDENT
.UNINDENT
.sp
سپس، نام پایگاه داده‌ای که برای نگهداری اجاره‌ها استفاده می‌شود باید تعیین گردد؛ این همان نامی است که هنگام ایجاد پایگاه داده استفاده شده است (بخش «First\-Time Creation of the MySQL Database» \%<#\:mysql-database-create> یا «First\-Time Creation of the PostgreSQL Database» \%<#\:pgsql-database-create> را ببینید).
.sp
برای MySQL یا PostgreSQL:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: { \(dqlease\-database\(dq: { \(dqname\(dq: \(dqdatabase\-name\(dq , ... }, ... }
.EE
.UNINDENT
.UNINDENT
.sp
اگر پایگاه داده روی سیستمی متفاوت از کارگزار DHCPv6 قرار دارد، نام میزبان پایگاه داده نیز باید مشخص شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: { \(dqlease\-database\(dq: { \(dqhost\(dq: \(dqremote\-host\-name\(dq, ... }, ... }
.EE
.UNINDENT
.UNINDENT
.sp
به‌طور معمول، پایگاه داده روی همان ماشینی است که کارگزار DHCPv6 قرار دارد. در این حالت، مقدار را روی یک رشتهٔ خالی تنظیم کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: { \(dqlease\-database\(dq: { \(dqhost\(dq : \(dq\(dq, ... }, ... }
.EE
.UNINDENT
.UNINDENT
.sp
در صورتی که پایگاه داده از درگاهی غیر از درگاه پیش‌فرض استفاده کند، آن نیز می‌تواند مشخص شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: { \(dqlease\-database\(dq: { \(dqport\(dq : 12345, ... }, ... }
.EE
.UNINDENT
.UNINDENT
.sp
در صورتی که پایگاه داده روی سیستم دیگری قرار داشته باشد، ممکن است مدیر سیستم نیاز به تعیین بازهٔ طولانی‌تری برای مهلت زمانی اتصال (timeout) داشته باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: { \(dqlease\-database\(dq: { \(dqconnect\-timeout\(dq : timeout\-in\-seconds, ... }, ... }
.EE
.UNINDENT
.UNINDENT
.sp
مقدار پیش‌فرضِ پنج ثانیه باید برای اتصالات محلی بیش از حد کافی باشد. هرچند اگر یک مهلت زمانی تعیین شود، باید یک عدد صحیح بزرگ‌تر از صفر باشد.
.sp
حداکثر دفعاتی که کارگزار پس از قطع اتصال به طور خودکار برای اتصال مجدد به پایگاه دادهٔ اجاره تلاش می‌کند، می‌تواند مشخص شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: { \(dqlease\-database\(dq: { \(dqmax\-reconnect\-tries\(dq : number\-of\-tries, ... }, ... }
.EE
.UNINDENT
.UNINDENT
.sp
اگر کارگزار پس از انجام حداکثر دفعات تلاش نتواند دوباره به پایگاه داده متصل شود، خارج خواهد شد. مقدار 0 (پیش‌فرض) بازیابی خودکار را غیرفعال می‌کند و کارگزار بلافاصله پس از تشخیص قطع اتصال، خارج می‌شود (تنها در MySQL و PostgreSQL).
.sp
تعداد میلی‌ثانیه‌هایی که کارگزار پس از قطع اتصال، بین تلاش‌ها برای اتصال مجدد به پایگاه دادهٔ اجاره منتظر می‌ماند نیز می‌تواند مشخص شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: { \(dqlease\-database\(dq: { \(dqreconnect\-wait\-time\(dq : number\-of\-milliseconds, ... }, ... }
.EE
.UNINDENT
.UNINDENT
.sp
مقدار پیش‌فرض برای MySQL و PostgreSQL برابر با 0 است که بازیابی خودکار را غیرفعال کرده و باعث می‌شود کارگزار بلافاصله پس از تشخیص قطع اتصال خارج شود.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: { \(dqlease\-database\(dq: { \(dqon\-fail\(dq : \(dqstop\-retry\-exit\(dq, ... }, ... }
.EE
.UNINDENT
.UNINDENT
.sp
مقادیر ممکن عبارتند از:
.INDENT 0.0
.IP \(bu 2
\fBstop\-retry\-exit\fP \- سرویس DHCP را هنگام تلاش برای بازیابی خودکار اتصالات قطع‌شده غیرفعال می‌کند، و پس از اتمام \fBmax\-reconnect\-tries\fP در صورت عدم موفقیت، کارگزار را خاموش می‌کند. این مقدار پیش‌فرض برای بک‌اند اجاره، بک‌اند میزبان و بک‌اند پیکربندی است.
.IP \(bu 2
\fBserve\-retry\-exit\fP \- هنگام تلاش برای بازیابی خودکار اتصالات قطع‌شده، به سرویس‌دهی DHCP ادامه می‌دهد و پس از اتمام \fBmax\-reconnect\-tries\fP در صورت عدم موفقیت، کارگزار را خاموش می‌کند.
.IP \(bu 2
\fBserve\-retry\-continue\fP \- به سرویس‌دهی DHCP ادامه می‌دهد و حتی اگر بازیابی با شکست مواجه شود، کارگزار را خاموش نمی‌کند. این مقدار پیش‌فرض برای ثبت وقایع قانونی (forensic logging) است.
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
اتصال مجدد خودکار به بک‌اندهای پایگاه داده به طور جداگانه برای هر بک‌اند پیکربندی می‌شود؛ این قابلیت به کاربران اجازه می‌دهد تا پارامترهای بازیابی را متناسب با هر بک‌اندی که استفاده می‌کنند تنظیم کنند. ما پیشنهاد می‌کنیم که کاربران آن را یا برای همهٔ بک‌اندها فعال کنند یا برای هیچ‌کدام، تا رفتار سیستم سازگار و یکدست باشد.
.sp
قطع اتصال با بک‌اندی که اتصال مجدد برای آن غیرفعال است (در صورت پیکربندی)، منجر به خاموش شدن خودکار کارگزار می‌شود. این شامل مواردی نیز می‌شود که بک‌اند پایگاه دادهٔ اجاره و بک‌اند پایگاه دادهٔ میزبان‌ها به یک نمونهٔ پایگاه دادهٔ یکسان متصل باشند.
.sp
اکیداً توصیه می‌شود که تنظیم پیش‌فرض \fBstop\-retry\-exit\fP را برای مدیریت اجاره (lease manager) تغییر ندهید، چرا که فعال بودن اتصال در زمان پردازش ترافیک DHCP امری حیاتی است. این مورد را تنها در صورتی تغییر دهید که از کارگزار منحصراً به عنوان یک ابزار پیکربندی استفاده شود.
.UNINDENT
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: { \(dqlease\-database\(dq: { \(dqretry\-on\-startup\(dq : true, ... }, ... }
.EE
.UNINDENT
.UNINDENT
.sp
هنگام راه‌اندازی کارگزار، ناتوانی در اتصال به هر یک از بک‌اندهای پیکربندی‌شده تنها در صورتی مهلک (fatal) تلقی می‌شود که \fBretry\-on\-startup\fP روی \fBfalse\fP (پیش‌فرض) تنظیم شده باشد. یک خطای مهلک در گزارش ثبت می‌شود و کارگزار خارج می‌شود، بر این مبنا که پیکربندی باید در زمان راه‌اندازی معتبر باشد. خروج به سیستم‌عامل این امکان را به اسکریپت‌های نظارتی (nanny scripts) می‌دهد تا مشکل را تشخیص دهند. اگر \fBretry\-on\-startup\fP روی \fBtrue\fP تنظیم شود، کارگزار تلاش‌ها برای برقراری مجدد اتصال را حتی در زمان راه‌اندازی اولیه یا هنگام رویدادهای بازپیکربندی آغاز می‌کند و به عملیات مشخص‌شده در پارامتر \fBon\-fail\fP عمل می‌نماید.
.sp
پارامتر host توسط بک‌اندهای MySQL و PostgreSQL استفاده می‌شود.
.sp
در نهایت، اطلاعات احراز هویت حسابی که کارگزار تحت آن به پایگاه داده دسترسی خواهد داشت باید تنظیم شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqlease\-database\(dq: {
        \(dquser\(dq: \(dquser\-name\(dq,
        \(dqpassword\(dq: \(dq1234\(dq,
        ...
    },
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر گذرواژه‌ای برای حساب وجود ندارد، گذرواژه را روی یک رشتهٔ خالی \fB\(dq\(dq\fP تنظیم کنید. (این مقدار پیش‌فرض است.).SS تنظیم مهلت‌های زمانی پایگاه داده (Tuning Database Timeouts)
.sp
در موارد نادری، خواندن از پایگاه داده یا نوشتن در آن ممکن است متوقف شود (hang کند). این وضعیت می‌تواند به دلیل یک مشکل موقت شبکه یا پیکربندی نادرست سرور پراکسی باشد که اتصال را بین نمونه‌های مختلف پایگاه داده جابه‌جا می‌کند. این شرایط نادر هستند، اما کاربران گزارش کرده‌اند که Kea گاهی اوقات هنگام انجام عملیات I/O پایگاه داده معلق می‌شود. تنظیم مقادیر مهلت زمانی (timeout) مناسب می‌تواند چنین مشکلاتی را کاهش دهد.
.sp
پایگاه‌داده MySQL دو گزینه اتصال متمایز را برای پیکربندی مهلت‌های زمانی خواندن و نوشتن ارائه می‌دهد. پارامترهای پیکربندی متناظر Kea یعنی \fBread\-timeout\fP و \fBwrite\-timeout\fP این مهلت‌های زمانی را بر حسب ثانیه مشخص می‌کنند. برای مثال:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: { \(dqlease\-database\(dq: { \(dqread\-timeout\(dq : 10, \(dqwrite\-timeout\(dq: 20, ... }, ... }
.EE
.UNINDENT
.UNINDENT
.sp
تنظیم این پارامترها روی 0 معادل مشخص نکردن آن‌ها است و باعث می‌شود سرور Kea با مقادیر پیش‌فرض MySQL اتصالی به پایگاه داده برقرار کند. در این حالت، Kea به مدت نامحدود منتظر تکمیل عملیات خواندن و نوشتن می‌ماند.
.sp
نسخه‌های MySQL قدیمی‌تر از 5.6 از تنظیم مهلت زمانی برای عملیات خواندن و نوشتن پشتیبانی نمی‌کنند. علاوه بر این، پارامترهای \fBread\-timeout\fP و \fBwrite\-timeout\fP تنها برای بک‌اند MySQL قابل تعریف هستند؛ تنظیم آن‌ها برای هر نوع پایگاه داده بک‌اند دیگری موجب خطای پیکربندی می‌شود.
.sp
برای تنظیم مهلت زمانی بر حسب ثانیه برای PostgreSQL، از پارامتر \fBtcp\-user\-timeout\fP استفاده کنید. برای مثال:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: { \(dqlease\-database\(dq: { \(dqtcp\-user\-timeout\(dq : 10, ... }, ... }
.EE
.UNINDENT
.UNINDENT
.sp
مشخص کردن این پارامتر برای سایر انواع بک‌اند باعث خطای پیکربندی می‌شود.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
مهلت‌های زمانی شرح داده شده در اینجا فقط برای اتصالات TCP مؤثر هستند. لطفاً توجه داشته باشید که کتابخانه کلاینت MySQL مورد استفاده توسط سرورهای Kea معمولاً هنگامی که پارامتر \fBhost\fP مقدار \fBlocalhost\fP باشد از طریق سوکت دامنه یونیکس (UNIX domain socket) به پایگاه داده متصل می‌شود، اما برای \fB127.0.0.1\fP یک اتصال TCP برقرار می‌کند\&.
.UNINDENT
.UNINDENT
.sp
از نسخه 2.7.4 نرم‌افزار Kea به بعد، کتابخانه قلاب (hook library) به نام libdhcp_mysql.so باید بارگذاری شود تا اجاره‌ها در بک‌اند پایگاه داده اجاره MySQL ذخیره شوند. مکان کتابخانه قلاب بک‌اند اجاره را مشخص کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: { \(dqhooks\-libraries\(dq: [
    {
        // the MySQL lease backend hook library required for lease storage.
        \(dqlibrary\(dq: \(dqlibdhcp_mysql.so\(dq
    }, ... ], ... }
.EE
.UNINDENT
.UNINDENT
.sp
از نسخه 2.7.4 نرم‌افزار Kea به بعد، کتابخانه قلاب libdhcp_pgsql.so باید بارگذاری شود تا اجاره‌ها در بک‌اند پایگاه داده اجاره PostgreSQL ذخیره شوند. مکان کتابخانه قلاب بک‌اند اجاره را مشخص کنید.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: { \(dqhooks\-libraries\(dq: [
    {
        // the PostgreSQL lease backend hook library required for lease storage.
        \(dqlibrary\(dq: \(dqlibdhcp_pgsql.so\(dq
    }, ... ], ... }
.EE
.UNINDENT
.UNINDENT
.SS ذخیره‌سازی میزبان‌ها (Hosts Storage)
.sp
همچنین Kea قادر است اطلاعات مربوط به رزروهای میزبان (host reservations) را در پایگاه داده ذخیره کند. پیکربندی پایگاه داده میزبان‌ها از همان ساختار نحوی پایگاه داده اجاره‌ها استفاده می‌کند. در حقیقت، سرور Kea برای هر منظور، خواه اطلاعات اجاره باشد یا اطلاعات میزبان‌ها، اتصالات مستقلی باز می‌کند که این امر بالاترین انعطاف‌پذیری را فراهم می‌سازد. Kea می‌تواند اجاره‌ها و رزروهای میزبان را به طور جداگانه نگهداری کند، اما می‌تواند به همان پایگاه داده مشترک نیز اشاره نماید. در حال حاضر انواع پایگاه‌های داده پشتیبانی‌شده برای میزبان‌ها MySQL و PostgreSQL هستند.
.sp
پیکربندی زیر می‌تواند برای تنظیم اتصال به MySQL استفاده شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqhosts\-database\(dq: {
        \(dqtype\(dq: \(dqmysql\(dq,
        \(dqname\(dq: \(dqkea\(dq,
        \(dquser\(dq: \(dqkea\(dq,
        \(dqpassword\(dq: \(dq1234\(dq,
        \(dqhost\(dq: \(dqlocalhost\(dq,
        \(dqport\(dq: 3306
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
بسته به پیکربندی پایگاه داده، بسیاری از این پارامترها ممکن است اختیاری باشند.
.sp
لطفاً توجه داشته باشید که استفاده از ذخیره‌سازی میزبان‌ها اختیاری است. کاربر می‌تواند تمام رزروهای میزبان را درون فایل پیکربندی تعریف کند، و در صورتی که تعداد رزروها کم باشد این روش پیشنهادی است. با این حال، هنگامی که تعداد رزروها افزایش می‌یابد، استفاده از ذخیره‌سازی پایگاه داده میزبان‌ها راحت‌تر خواهد بود. لطفاً توجه داشته باشید که هر دو روش ذخیره‌سازی (فایل پیکربندی و یکی از پایگاه‌های داده پشتیبانی‌شده) می‌توانند به صورت همزمان استفاده شوند. اگر میزبان‌ها در هر دو مکان تعریف شده باشند، ابتدا تعاریف فایل پیکربندی بررسی می‌شوند و در صورت نیاز، فضای ذخیره‌سازی خارجی بعداً بررسی خواهد شد.
.sp
اطلاعات میزبان می‌تواند در چندین مخزن ذخیره‌سازی قرار گیرد. عملیات‌ها روی مخازن بر اساس همان ترتیبی که در فایل پیکربندی تعریف شده‌اند انجام می‌پذیرد، هرچند این موضوع در صورت افزودن یک رزرو میزبان به محدودیتی در اولویت‌بندی منجر می‌شود؛ مخازن فقط‌خواندنی (read\-only) باید حتماً بعد از یک مخزن خواندنی\-نوشتنی (read\-write) پیکربندی شوند، در غیر این صورت عملیات افزودن با خطا مواجه خواهد شد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
نرم‌افزار Kea مستلزم آن است که منطقه زمانی (timezone) پایگاه داده با منطقه زمانی سیستم یکسان باشد. برای جزئیات بیشتر، به بخش‌های First\-Time Creation of the MySQL Database \%<#\:mysql-database-create> و First\-Time Creation of the PostgreSQL Database \%<#\:pgsql-database-create>\& مراجعه کنید.
.UNINDENT
.UNINDENT.SS پیکربندی پایگاه‌داده میزبان‌های DHCPv6
.sp
پیکربندی پایگاه‌داده میزبان‌ها از طریق پارامترهای
\fBDhcp6\fP/\fBhosts\-database\fP کنترل می‌شود. در صورت فعال بودن، نوع پایگاه‌داده باید
بر روی \fBmysql\fP یا \fBpostgresql\fP تنظیم شود\&.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: { \(dqhosts\-database\(dq: { \(dqtype\(dq: \(dqmysql\(dq, ... }, ... }
.EE
.UNINDENT
.UNINDENT
.sp
سپس، نام پایگاه‌داده‌ای که رزروها را نگه‌داری می‌کند باید تنظیم شود؛
این همان نامی است که هنگام ایجاد پایگاه‌داده اجاره‌ها استفاده شده است (برای
دستورالعمل‌های نحوه راه‌اندازی نوع پایگاه‌داده مورد نظر، به بخش پشتیبان‌های پشتیبانی‌شده
\%<#\:supported-databases> مراجعه کنید):
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: { \(dqhosts\-database\(dq: { \(dqname\(dq: \(dqdatabase\-name\(dq , ... }, ... }
.EE
.UNINDENT
.UNINDENT
.sp
اگر پایگاه‌داده بر روی سامانه‌ای غیر از کارگزار DHCPv6 قرار دارد،
نام میزبان پایگاه‌داده نیز باید مشخص شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: { \(dqhosts\-database\(dq: { \(dqhost\(dq: remote\-host\-name, ... }, ... }
.EE
.UNINDENT
.UNINDENT
.sp
به طور معمول، پایگاه‌داده روی همان ماشین کارگزار DHCPv6 قرار دارد.
در این حالت، مقدار را روی یک رشته خالی تنظیم کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: { \(dqhosts\-database\(dq: { \(dqhost\(dq : \(dq\(dq, ... }, ... }
.EE
.UNINDENT
.UNINDENT
.sp
در صورتی که پایگاه‌داده از درگاهی به غیر از درگاه پیش‌فرض استفاده می‌کند،
می‌توان آن را نیز مشخص کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: { \(dqhosts\-database\(dq: { \(dqport\(dq : 12345, ... }, ... }
.EE
.UNINDENT
.UNINDENT
.sp
حداکثر دفعاتی که کارگزار پس از قطع اتصال به طور خودکار برای اتصال مجدد به
پایگاه‌داده میزبان تلاش می‌کند را می‌توان مشخص کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: { \(dqhosts\-database\(dq: { \(dqmax\-reconnect\-tries\(dq : number\-of\-tries, ... }, ... }
.EE
.UNINDENT
.UNINDENT
.sp
اگر کارگزار پس از انجام حداکثر دفعات تلاش قادر به اتصال مجدد به پایگاه‌داده
نباشد، کارگزار خارج خواهد شد. مقدار 0 (پیش‌فرض) بازیابی خودکار را غیرفعال
می‌کند و کارگزار بلافاصله پس از تشخیص قطع اتصال خارج می‌شود (تنها در MySQL
و PostgreSQL).
.sp
مدت‌زمانی که کارگزار بین تلاش‌ها برای اتصال مجدد به پایگاه‌داده میزبان پس از
قطع اتصال منتظر می‌ماند را نیز می‌توان بر حسب میلی‌ثانیه مشخص کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: { \(dqhosts\-database\(dq: { \(dqreconnect\-wait\-time\(dq : number\-of\-milliseconds, ... }, ... }
.EE
.UNINDENT
.UNINDENT
.sp
مقدار پیش‌فرض برای MySQL و PostgreSQL برابر با 0 است که بازیابی خودکار را
غیرفعال کرده و باعث می‌شود کارگزار بلافاصله پس از تشخیص قطع اتصال خارج شود.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: { \(dqhosts\-database\(dq: { \(dqon\-fail\(dq : \(dqstop\-retry\-exit\(dq, ... }, ... }
.EE
.UNINDENT
.UNINDENT
.sp
مقادیر مجاز عبارتند از:
.INDENT 0.0
.IP \(bu 2
\fBstop\-retry\-exit\fP \- سرویس DHCP را در هنگام تلاش برای بازیابی خودکار
اتصالات قطع‌شده غیرفعال می‌کند. در صورت عدم موفقیت پس از اتمام
\fBmax\-reconnect\-tries\fP، کارگزار را خاموش می‌کند. این مقدار پیش‌فرض برای MySQL و PostgreSQL است.
.IP \(bu 2
\fBserve\-retry\-exit\fP \- سرویس‌دهی DHCP را در حین تلاش برای بازیابی خودکار
اتصالات قطع‌شده ادامه می‌دهد. در صورت عدم موفقیت پس از اتمام
\fBmax\-reconnect\-tries\fP، کارگزار را خاموش می‌کند.
.IP \(bu 2
\fBserve\-retry\-continue\fP \- سرویس‌دهی DHCP را ادامه می‌دهد و حتی در صورت شکست
بازیابی نیز کارگزار را خاموش نمی‌کند.
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
اتصال مجدد خودکار به پشتیبان‌های پایگاه‌داده به طور جداگانه برای هر پشتیبان
پیکربندی می‌شود. این امر به کاربران امکان می‌دهد پارامترهای بازیابی را متناسب با هر
پشتیبانی که استفاده می‌کنند تنظیم کنند. پیشنهاد می‌کنیم کاربران آن را برای همه
پشتیبان‌ها فعال کرده یا برای هیچ‌کدام فعال نکنند تا رفتار سامانه یکدست باشد.
.sp
از دست رفتن اتصال به پشتیبانی که اتصال مجدد برای آن غیرفعال است (در صورت
پیکربندی) منجر به خاموش شدن خودکار کارگزار می‌شود. این شامل مواردی نیز می‌شود که
پشتیبان پایگاه‌داده اجاره‌ها و پشتیبان پایگاه‌داده میزبان‌ها به یک نمونه پایگاه‌داده یکسان
متصل باشند.
.UNINDENT
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: { \(dqhosts\-database\(dq: { \(dqretry\-on\-startup\(dq : true, ... }, ... }
.EE
.UNINDENT
.UNINDENT
.sp
در زمان راه‌اندازی کارگزار، ناتوانی در اتصال به هر یک از پشتیبان‌های پیکربندی‌شده
تنها در صورتی یک خطای مهلک در نظر گرفته می‌شود که \fBretry\-on\-startup\fP بر روی \fBfalse\fP
(پیش‌فرض) تنظیم شده باشد. یک خطای مهلک در گزارش‌ها ثبت شده و کارگزار خارج می‌شود،
بر پایه این رویکرد که پیکربندی در زمان راه‌اندازی باید معتبر باشد. خروج به سیستم‌عامل به
اسکریپت‌های ناظر اجازه می‌دهد تا مشکل را تشخیص دهند.
اگر \fBretry\-on\-startup\fP بر روی \fBtrue\fP تنظیم شود، کارگزار حتی هنگام راه‌اندازی
یا در زمان رخدادهای بازپیکربندی نیز تلاش‌های اتصال مجدد را آغاز کرده و رفتار
مشخص‌شده در پارامتر \fBon\-fail\fP را به کار می‌بندد.
.sp
در نهایت، اعتبارنامه‌های حسابی که کارگزار با استفاده از آن به پایگاه‌داده دسترسی خواهد داشت
باید مشخص شوند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqhosts\-database\(dq: {
        \(dquser\(dq: \(dquser\-name\(dq,
        \(dqpassword\(dq: \(dq1234\(dq,
        ...
    },
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر حساب کاربری گذرواژه‌ای ندارد، گذرواژه را روی رشته خالی \fB\(dq\(dq\fP تنظیم
کنید\&. (این مقدار پیش‌فرض است.)
.sp
افزونه چندذخیره‌سازی از ساختار مشابهی استفاده می‌کند؛ با این تفاوت که پیکربندی
به جای یک مدخل \fBhosts\-database\fP، درون یک فهرست \fBhosts\-databases\fP قرار
می‌گیرد، مانند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: { \(dqhosts\-databases\(dq: [ { \(dqtype\(dq: \(dqmysql\(dq, ... }, ... ], ... }
.EE
.UNINDENT
.UNINDENT
.sp
اگر میزبانی به صورت هم‌زمان هم درون فایل و هم درون پایگاه‌داده پیکربندی شده باشد،
Kea هیچ هشداری صادر نمی‌کند؛ برخلاف وضعیتی که هر دو در یک منبع داده یکسان تعریف شده باشند.
در عوض، میزبانی که درون فایل پیکربندی شده است، نسبت به میزبان پیکربندی‌شده در
پایگاه‌داده اولویت دارد..SS استفاده از پایگاه‌های داده فقط\-خواندنی برای رزروهای میزبان با DHCPv6
.sp
در برخی استقرارها، کاربری که نام آن در پیکربندی backend پایگاه داده مشخص شده است، ممکن است دسترسی نوشتن به پایگاه داده را نداشته باشد. این موضوع اغلب بر اساس سیاست‌های درون یک شبکه برای محافظت از داده‌ها در برابر تغییرات ناخواسته الزامی است. در بسیاری از موارد مدیران سیستم پایگاه‌های داده موجودی (inventory) را مستقر کرده‌اند که حاوی اطلاعات بسیار بیشتری درباره میزبان‌ها نسبت به صرفاً رزروهای ایستا اختصاص‌یافته به آن‌ها است. از پایگاه داده موجودی می‌توان برای ایجاد یک نما (view) از پایگاه داده میزبان‌های Kea استفاده کرد و چنین نمایی اغلب به‌صورت فقط\-خواندنی است.
.sp
بخش‌های backend پایگاه داده میزبان Kea با یک پیکربندی ضمنی برای خواندن و نوشتن در پایگاه داده عمل می‌کنند. اگر کاربر دسترسی نوشتن به پایگاه داده میزبان را نداشته باشد، backend در راه‌اندازی شکست می‌خورد و سرور از شروع به‌کار (یا بازپیکربندی) خودداری می‌کند. با این حال، اگر دسترسی به یک پایگاه داده میزبانِ فقط\-خواندنی جهت بازیابی رزروها برای کلاینت‌ها و/یا تخصیص آدرس‌ها و گزینه‌های خاص نیاز باشد، می‌توان Kea را صراحتاً برای شروع در حالت \(dqread\-only\(dq پیکربندی کرد. این عمل توسط پارامتر بولی \fBreadonly\fP به صورت زیر کنترل می‌شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: { \(dqhosts\-database\(dq: { \(dqreadonly\(dq: true, ... }, ... }
.EE
.UNINDENT
.UNINDENT
.sp
تنظیم این پارامتر روی \fBfalse\fP، پایگاه داده backend را برای کار در حالت \(dqread\-write\(dq پیکربندی می‌کند، که در صورت تعیین نشدن پارامتر، پیکربندی پیش‌فرض نیز همین است.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
پارامتر \fBreadonly\fP تنها برای پایگاه‌های داده MySQL و PostgreSQL پشتیبانی می‌شود.
.UNINDENT
.UNINDENT
.sp
از نسخه Kea.2.7.4، کتابخانه قلاب libdhcp_mysql.so باید بارگیری شود تا رزروهای میزبان در backend پایگاه داده میزبان MySQL ذخیره شوند. مکان کتابخانه قلاب backend اجاره (lease) را مشخص کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: { \(dqhooks\-libraries\(dq: [
    {
        // the MySQL host backend hook library required for host storage.
        \(dqlibrary\(dq: \(dqlibdhcp_mysql.so\(dq
    }, ... ], ... }
.EE
.UNINDENT
.UNINDENT
.sp
از نسخه Kea.2.7.4، کتابخانه قلاب libdhcp_pgsql.so باید بارگیری شود تا رزروهای میزبان در backend پایگاه داده میزبان PostgreSQL ذخیره شوند. مکان کتابخانه قلاب backend اجاره را مشخص کنید.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: { \(dqhooks\-libraries\(dq: [
    {
        // the PostgreSQL host backend hook library required for host storage.
        \(dqlibrary\(dq: \(dqlibdhcp_pgsql.so\(dq
    }, ... ], ... }
.EE
.UNINDENT
.UNINDENT
.SS تنظیم مهلت‌های زمانی پایگاه داده برای ذخیره‌سازی میزبان‌ها
.sp
بخش Tuning Database Timeouts\& را ببینید.
.SS پیکربندی رابط‌ها
.sp
سرور DHCPv6 باید برای شنود روی رابط‌های شبکه مشخصی پیکربندی شود. ساده‌ترین پیکربندی رابط شبکه به سرور می‌گوید روی تمام رابط‌های در دسترس شنود کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqinterfaces\-config\(dq: {
        \(dqinterfaces\(dq: [ \(dq*\(dq ]
    },
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
‏Kea به‌طور پیش‌فرض روی آدرس‌های عمومی IPv6 شنود نمی‌کند. برای فعال‌سازی ترافیک تک‌پخشی (unicast) بخش Unicast Traffic Support\& را ببینید.
.UNINDENT
.UNINDENT
.sp
نویسه ستاره نقش نویسه عمومی (wildcard) را بازی می‌کند و به معنای \(dqشنود روی تمام رابط‌ها\(dq است. با این حال، معمولاً بهتر است نام‌های رابط‌ها صراحتاً مشخص شوند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqinterfaces\-config\(dq: {
        \(dqinterfaces\(dq: [ \(dqeth1\(dq, \(dqeth3\(dq ]
    },
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
امکان استفاده از نویسه عمومی رابط (*) به‌طور هم‌زمان با نام‌های صریح رابط‌ها وجود دارد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqinterfaces\-config\(dq: {
        \(dqinterfaces\(dq: [ \(dqeth1\(dq, \(dqeth3\(dq, \(dq*\(dq ]
    },
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
این قالب تنها زمانی باید استفاده شود که نیاز باشد موقتاً فهرست نام رابط‌ها نادیده گرفته شده و روی تمام رابط‌ها شنود انجام شود.
.sp
همانند سرور DHCPv4، اتصال به آدرس‌های خاص و غیرفعال‌سازی تشخیص مجدد رابط‌ها پشتیبانی می‌شود. اما \fBdhcp\-socket\-type\fP پشتیبانی نمی‌شود، زیرا DHCPv6 تنها از سوکت‌های UDP/IPv6 استفاده می‌کند.
.sp
رابط‌ها در هر بار پیکربندی مجدد دوباره شناسایی می‌شوند. این رفتار را می‌توان با تنظیم مقدار \fBre\-detect\fP روی \fBfalse\fP غیرفعال کرد، برای مثال:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqinterfaces\-config\(dq: {
        \(dqinterfaces\(dq: [ \(dqeth1\(dq, \(dqeth3\(dq ],
        \(dqre\-detect\(dq: false
    },
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
سازوکار شناسایی مجدد معمولاً رابط‌های شناسایی‌شده قبلی را حذف کرده و سپس تمام رابط‌های شناسایی‌شده فعلی را اضافه می‌کند.
توجه داشته باشید که هنگام اجرای دستورهای \fBconfig\-test\fP \%<#\:std-isccmd-config-test>
یا \fBconfig\-set\fP \%<#\:std-isccmd-config-set> رابط‌ها دوباره شناسایی نمی‌شوند.
با این حال، رابط‌های جدید شناسایی می‌شوند و برای استفاده توسط پیکربندی جدیدِ ارسال‌شده به دستورهای \fBconfig\-test\fP \%<#\:std-isccmd-config-test> و
\fBconfig\-set\fP \%<#\:std-isccmd-config-set> در دسترس خواهند بود.
.sp
رابط‌های لوپ‌بک (مانند رابط \fBlo\fP یا \fBlo0\fP) به‌طور پیش‌فرض پیکربندی نمی‌شوند، مگر اینکه صراحتاً در پیکربندی ذکر شوند. توجه داشته باشید که Kea به یک آدرس پیوند\-محلی (link\-local) (که در همه سیستم‌ها وجود ندارد) یا یک آدرس مشخص تک‌پخشی (unicast) نیاز دارد، مانند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqinterfaces\-config\(dq: {
        \(dqinterfaces\(dq: [ \(dqenp0s2/2001:db8::1234:abcd\(dq ]
    },
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
‏Kea در هنگام راه‌اندازی، سوکت‌های سرویس را برای هر رابط مقیدسازی (bind) می‌کند. اگر فرایند دیگری قبلاً از یک درگاه (port) استفاده کرده باشد، Kea پیام را در لاگ ثبت کرده و از بروز خطا جلوگیری می‌کند. سرویس DHCP اجرا می‌شود، اما روی برخی رابط‌ها در دسترس نخواهد بود.
.sp
گزینه \(dqservice\-sockets\-require\-all\(dq باعث می‌شود Kea نیاز داشته باشد که تمام سوکت‌ها با موفقیت مقید شوند. اگر باز کردن هر سوکتی با شکست مواجه شود، Kea فرایند مقداردهی اولیه را قطع کرده و با یک وضعیت غیرصفر خارج می‌شود. (پیش‌فرض false است).
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqinterfaces\-config\(dq: {
        \(dqinterfaces\(dq: [ \(dqeth1\(dq, \(dqeth3\(dq ],
        \(dqservice\-sockets\-require\-all\(dq: true
    },
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
گاهی اوقات، قطع فوری فرایند انتخاب مناسبی نیست. درگاه ممکن است تنها موقتاً در دسترس نباشد. در این حالت، تلاش مجدد برای باز کردن ممکن است مشکل را حل کند. Kea دو گزینه را برای تعیین تلاش مجدد فراهم می‌کند:
\fBservice\-sockets\-max\-retries\fP و \fBservice\-sockets\-retry\-wait\-time\fP\&.
.sp
گزینه نخست حداکثر تعداد تلاش‌های مجددی را تعیین می‌کند که Kea برای باز کردن یک سوکت انجام می‌دهد. مقدار صفر (پیش‌فرض) بدین معناست که Kea فرایند را دوباره تلاش نمی‌کند.
.sp
گزینه دوم زمان انتظار (به میلی‌ثانیه) بین تلاش‌ها را تعیین می‌کند. مقدار پیش‌فرض 5000 (۵ ثانیه) است.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqinterfaces\-config\(dq: {
        \(dqinterfaces\(dq: [ \(dqeth1\(dq, \(dqeth3\(dq ],
        \(dqservice\-sockets\-max\-retries\(dq: 5,
        \(dqservice\-sockets\-retry\-wait\-time\(dq: 5000
    },
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر \(dqservice\-sockets\-max\-retries\(dq غیرصفر باشد و \(dqservice\-sockets\-require\-all\(dq
برابر با false باشد، آن‌گاه Kea باز کردن را (در صورت نیاز) دوباره تلاش می‌کند اما در صورتی که هر سوکتی همچنان باز نشده باشد با شکست مواجه نمی‌شود..SS شناسه زیرشبکه IPv6 (IPv6 Subnet Identifier)
.sp
شناسه زیرشبکه (subnet ID) عددی یکتا است که به یک زیرشبکه خاص اختصاص می‌یابد. در اصل، این شناسه برای مرتبط ساختن اجاره‌های (leases) کارخواه‌ها با زیرشبکه‌های مربوطه‌شان به کار می‌رود. پیکربندی کارساز باید شامل شناسه‌های یکتا و پایداری برای تمام زیرشبکه‌ها باشد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
شناسه‌های زیرشبکه باید بزرگ‌تر از صفر و کوچک‌تر از 4294967295 باشند.
.UNINDENT
.UNINDENT
.sp
پیکربندی زیر شناسه زیرشبکه مشخص‌شده را به یک زیرشبکه تازه پیکربندی‌شده تخصیص می‌دهد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqsubnet6\(dq: [
        {
            \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
            \(dqid\(dq: 1024,
            ...
        }
    ]
}
.EE
.UNINDENT
.UNINDENT
.SS پیشوند زیرشبکه IPv6 (IPv6 Subnet Prefix)
.sp
پیشوند زیرشبکه (subnet prefix) روش دوم برای شناسایی یک زیرشبکه است. Kea می‌تواند نشانی‌های غیرمتعارف (non\-canonical) زیرشبکه را نیز بپذیرد؛ برای نمونه، این پیکربندی پذیرفته می‌شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
   \(dqsubnet6\(dq: [
       {
            \(dqsubnet\(dq: \(dq2001:db8:1::1/64\(dq,
            ...
       }
    ]
}
.EE
.UNINDENT
.UNINDENT
.sp
این حالت حتی در صورتی که زیرشبکه دیگری با پیشوند \(dq2001:db8:1::/64\(dq وجود داشته باشد کار می‌کند؛ جهت جلوگیری از موارد تکراری، تنها شکل متنی زیرشبکه‌ها مقایسه می‌شوند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
استفاده نادرست از این قابلیت می‌تواند به انتخاب نادرست زیرشبکه منجر شود (به «انتخاب زیرشبکه IPv6» مراجعه کنید).
.UNINDENT
.UNINDENT
.SS پشتیبانی از ترافیک تک‌پخشی (Unicast Traffic Support)
.sp
هنگامی که کارساز DHCPv6 راه‌اندازی می‌شود، به‌طور پیش‌فرض به ترافیک DHCP ارسال‌شده به نشانی چندپخشی (multicast) ff02::1:2 بر روی هر رابطی که برای شنود پیکربندی شده باشد گوش می‌دهد (به «پیکربندی رابط» مراجعه کنید). در برخی موارد مفید است که کارساز را طوری پیکربندی کرد که ترافیک ورودی ارسال‌شده به نشانی‌های تک‌پخشی سراسری (global unicast) را نیز مدیریت کند؛ رایج‌ترین دلیل برای این کار، ارسال مستقیم ترافیک توسط بازپخش‌کننده‌ها (relays) به کارساز است. برای پیکربندی کارساز جهت شنود روی یک نشانی تک‌پخشی مشخص، یک اسلش (/) پس از نام رابط اضافه کنید و سپس نشانی تک‌پخشی سراسری را که کارساز باید روی آن گوش دهد بیاورید. کارساز علاوه‌بر مقیدسازی (binding) عادی محلی پیوند (link\-local) و شنود روی نشانی ff02::1:2، روی این نشانی نیز گوش خواهد داد. نمونه پیکربندی زیر نشان می‌دهد چگونه می‌توان روی نشانی 2001:db8::1 (یک نشانی سراسری) پیکربندی‌شده روی رابط \fBeth1\fP شنود کرد.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqinterfaces\-config\(dq: {
        \(dqinterfaces\(dq: [ \(dqeth1/2001:db8::1\(dq ]
    },
    \(dqoption\-data\(dq: [
        {
            \(dqname\(dq: \(dqunicast\(dq,
            \(dqdata\(dq: \(dq2001:db8::1\(dq
        } ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
این پیکربندی باعث می‌شود که کارساز روی رابط \fBeth1\fP بر روی نشانی link\-local، گروه چندپخشی (ff02::1:2)، و 2001:db8::1 گوش دهد.
.sp
معمولاً پشتیبانی از تک‌پخشی با گزینه تک‌پخشی کارساز (server unicast option) همراه است که به کارخواه‌ها اجازه می‌دهد پیام‌های تک‌پخشی را به کارساز ارسال کنند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
گزینه تک‌پخشی توسط RFC 9915 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc9915> منسوخ شده است؛ تلاش برای افزودن آن به پاسخ‌ها هشداری را ایجاد می‌کند و کارساز دیگر پرس‌وجوهای مستقیم تک‌پخشی را (در مقایسه با پرس‌وجوهای بازپخش‌شده تک‌پخشی) نمی‌پذیرد.
.UNINDENT
.UNINDENT
.sp
نمونه بالا شامل تعریف گزینه تک‌پخشی کارساز است که باعث می‌شود کارخواه پیام‌ها را به نشانی تک‌پخشی مشخص‌شده ارسال کند.
.sp
امکان ترکیب نام‌های رابط، نویسه‌های عام (wildcards)، و جفت‌های «نام رابط/نشانی» در فهرست رابط‌ها وجود دارد. با این حال، مشخص کردن بیش از یک نشانی تک‌پخشی روی یک رابط معین امکان‌پذیر نیست.
.sp
باید در مشخص کردن نشانی‌های تک‌پخشی مناسب دقت شود، زیرا کارساز بدون هیچ‌گونه بررسی اضافی، برای مقیدسازی (bind) به نشانی‌های مشخص‌شده تلاش خواهد کرد. این رویکرد عمداً انتخاب شده است تا نرم‌افزار در صورت تمایل بتواند از طریق نشانی‌های نامتعارف نیز ارتباط برقرار کند..SS پیکربندی استخرهای نشانی IPv6
.sp
نقش اصلی یک کارگزار DHCPv6، تخصیص نشانی است. بدین منظور، کارگزار
باید دست‌کم با یک زیرشبکه و یک استخر از نشانی‌های پویا برای مدیریت
پیکربندی شود. برای نمونه، فرض کنید کارگزار به یک بخش از شبکه متصل است
که از پیشوند 2001:db8:1::/64 استفاده می‌کند. مدیر آن شبکه تصمیم می‌گیرد
که نشانی‌های بازهٔ 2001:db8:1::1 تا 2001:db8:1::ffff توسط کارگزار DHCPv6
مدیریت شوند. چنین پیکربندی‌ای را می‌توان به روش زیر انجام داد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqsubnet6\(dq: [
       {
           \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
           \(dqpools\(dq: [
               {
                   \(dqpool\(dq: \(dq2001:db8:1::1\-2001:db8:1::ffff\(dq
               }
           ],
           ...
       }
    ]
}
.EE
.UNINDENT
.UNINDENT
.sp
توجه داشته باشید که \fBsubnet\fP به صورت یک رشتهٔ ساده تعریف می‌شود، اما
پارامتر \fBpools\fP در واقع فهرستی از استخرها است؛ به همین دلیل، تعریف استخر
درون قلاب‌ها (کروشه‌ها) قرار می‌گیرد، حتی اگر فقط یک بازه از نشانی‌ها
مشخص شده باشد.
.sp
هر \fBpool\fP ساختاری است که پارامترهای توصیف‌کنندهٔ یک استخر مجزا را در بر
دارد. در حال حاضر فقط یک پارامتر وجود دارد، \fBpool\fP، که بازهٔ نشانی‌های
موجود در استخر را تعیین می‌کند.
.sp
امکان تعریف بیش از یک استخر در یک زیرشبکه وجود دارد؛ در ادامهٔ مثال پیشین،
همچنین فرض کنید 2001:db8:1:0:5::/80 نیز باید توسط کارگزار مدیریت شود.
این را می‌توان به صورت 2001:db8:1:0:5:: تا 2001:db8:1::5:ffff:ffff:ffff
نوشت، اما تایپ این همه نویسهٔ \fBf\fP دشوار و طاقت‌فرسا است. این استخر می‌تواند
ساده‌تر به صورت 2001:db8:1:0:5::/80 بیان شود. هر دو قالب توسط \fBDhcp6\fP
پشتیبانی می‌شوند و می‌توان آن‌ها را در فهرست استخرها با یکدیگر ترکیب کرد. برای
نمونه، استخرهای زیر را می‌توان تعریف کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqsubnet6\(dq: [
    {
        \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
        \(dqpools\(dq: [
            { \(dqpool\(dq: \(dq2001:db8:1::1\-2001:db8:1::ffff\(dq },
            { \(dqpool\(dq: \(dq2001:db8:1:05::/80\(dq }
        ],
        ...
    }
    ]
}
.EE
.UNINDENT
.UNINDENT
.sp
فاصله‌های خالی در تعاریف استخر نادیده گرفته می‌شوند، بنابراین فاصله‌های
قبل و بعد از خط پیوند اختیاری هستند. می‌توان از آن‌ها برای بهبود خوانایی
استفاده کرد.
.sp
تعداد استخرها محدودیتی ندارد، اما به دلایل کارایی توصیه می‌شود تا جای ممکن
از تعداد کمتری استفاده شود.
.sp
کارگزار ممکن است طوری پیکربندی شود که به بیش از یک زیرشبکه سرویس‌دهی کند.
برای افزودن زیرشبکهٔ دوم، از دستوری مشابه زیر استفاده کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqsubnet6\(dq: [
    {
        \(dqid\(dq: 1,
        \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
        \(dqpools\(dq: [
            { \(dqpool\(dq: \(dq2001:db8:1::1\-2001:db8:1::ffff\(dq }
        ]
    },
    {
        \(dqid\(dq: 2,
        \(dqsubnet\(dq: \(dq2001:db8:2::/64\(dq,
        \(dqpools\(dq: [
            { \(dqpool\(dq: \(dq2001:db8:2::/64\(dq }
        ]
    },
    ...
    ]
}
.EE
.UNINDENT
.UNINDENT
.sp
در این مثال، ما به کارگزار اجازه می‌دهیم تمام نشانی‌های موجود در کل
زیرشبکه را به صورت پویا تخصیص دهد. گرچه تا حدی اسراف‌آمیز است، اما اختصاص دادن
کل زیرشبکهٔ /64 برای این منظور مسلماً یک پیکربندی معتبر است. توجه داشته باشید
که کارگزار Kea اجاره‌ها را از پیش تخصیص نمی‌دهد، بنابراین خطری در استفاده از
استخرهای نشانی غول‌پیکر وجود ندارد.
.sp
هنگام پیکربندی یک کارگزار DHCPv6 با استفاده از نمادگذاری پیشوند/طول
(prefix/length)، لطفاً به مقادیر مرزی دقت کنید. وقتی مشخص می‌کنید که کارگزار
می‌تواند از یک استخر داده‌شده استفاده کند، این کارگزار قادر است اولین نشانی
(که معمولاً یک نشانی شبکه است) را نیز از آن استخر تخصیص دهد. برای نمونه، برای
استخر 2001:db8:2::/64، ممکن است نشانی 2001:db8:2:: نیز اختصاص یابد. برای
جلوگیری از این امر، از نمادگذاری \fBmin\-max\fP استفاده کنید.
.SS استخرهای زیرشبکه و تفویض پیشوند (Prefix Delegation)
.sp
زیرشبکه‌ها همچنین می‌توانند برای تفویض پیشوندها پیکربندی شوند، همان‌گونه که در
بخش 6.3 از RFC 9915 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc9915>
تعریف شده است. یک زیرشبکه می‌تواند یک یا چند استخر تفویض پیشوند داشته باشد.
هر استخر دارای یک نشانی پیشوندی است که به عنوان یک پیشوند (\fBprefix\fP) و یک
طول پیشوند (\fBprefix\-len\fP)، به همراه طول پیشوند تفویض‌شده
(\fBdelegated\-len\fP) مشخص می‌شود. طول تفویض‌شده نباید کوتاه‌تر از طول
پیشوند باشد (یعنی باید از نظر عددی بزرگ‌تر یا مساوی با آن باشد). اگر هر دو طول
تفویض‌شده و پیشوند برابر باشند، کارگزار تنها قادر به تفویض یک پیشوند خواهد
بود. پیشوند تفویض‌شده الزامی ندارد که با پیشوند زیرشبکه یکسان باشد.
.sp
در زیر یک نمونه پیکربندی زیرشبکه آمده است که تفویض پیشوند را برای آن
فعال می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqsubnet6\(dq: [
        {
            \(dqid\(dq: 1,
            \(dqsubnet\(dq: \(dq2001:d8b:1::/64\(dq,
            \(dqpd\-pools\(dq: [
                {
                    \(dqprefix\(dq: \(dq3000:1::\(dq,
                    \(dqprefix\-len\(dq: 64,
                    \(dqdelegated\-len\(dq: 96
                }
            ]
        }
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT.SS گزینه استثنای پیشوند (Prefix Exclude Option)
.sp
برای هر پیشوند واگذارشده (delegated prefix)، روتر واگذارکننده می‌تواند طبق مشخصات RFC
6603 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc6603>\& تصمیم بگیرد که یک
پیشوند منفرد را از پیشوند واگذارشده استثنا کند. روتر درخواست‌کننده نباید
پیشوند مستثناشده را به هیچ‌یک از رابط‌های دست‌پایین (downstream interfaces) خود اختصاص دهد.
پیشوند مستثناشده با این هدف در نظر گرفته شده است که روی پیوندی استفاده شود که روتر واگذارکننده
از طریق آن پیام‌های DHCPv6 را با روتر درخواست‌کننده تبادل می‌کند. نمونه
پیکربندی زیر نحوه مشخص کردن یک پیشوند مستثناشده در تعاریف استخر
پیشوند (prefix pool) را نشان می‌دهد. پیشوند مستثناشدهٔ
\fB2001:db8:1:8000:cafe:80::/72\fP به روتر درخواست‌کننده‌ای ارسال خواهد شد
که گزینه Prefix Exclude را در گزینه درخواست گزینه (ORO یا Option Request option) قرار داده باشد
و پیشوندی از این استخر به آن واگذار شده باشد.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqsubnet6\(dq: [
        {
            \(dqid\(dq: 1,
            \(dqsubnet\(dq: \(dq2001:db8:1::/48\(dq,
            \(dqpd\-pools\(dq: [
                {
                    \(dqprefix\(dq: \(dq2001:db8:1:8000::\(dq,
                    \(dqprefix\-len\(dq: 56,
                    \(dqdelegated\-len\(dq: 64,
                    \(dqexcluded\-prefix\(dq: \(dq2001:db8:1:8000:cafe:80::\(dq,
                    \(dqexcluded\-prefix\-len\(dq: 72
                }
            ]
        }
    ]
}
.EE
.UNINDENT
.UNINDENT
.SS استخرهای هم‌پوشان (Overlapping Pools)
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
در اینجا برخی آزادی‌عمل‌ها و محدودیت‌ها برای مقادیری که زیرشبکه‌ها و استخرها
می‌توانند در پیکربندی‌های Kea فراتر از حالت معمول داشته باشند آورده شده است:
.TS
box center;
l|l|l.
T{
مورد پیکربندی Kea
T}	T{
مجاز
T}	T{
توضیح
T}
_
T{
زیرشبکه‌های هم‌پوشان
T}	T{
بله
T}	T{
مدیر سیستم باید به چگونگی تطبیق کلاینت‌ها با این زیرشبکه‌ها توجه داشته باشد.
T}
_
T{
استخرهای آدرس هم‌پوشان در یک زیرشبکه
T}	T{
خیر
T}	T{
خطای راه‌اندازی: DHCP6_PARSER_FAIL
T}
_
T{
استخرهای آدرس هم‌پوشان در زیرشبکه‌های مختلف
T}	T{
بله
T}	T{
مشخص کردن یک استخر آدرس یکسان در زیرشبکه‌های مختلف می‌تواند به عنوان معادل
استخر آدرس سراسری (global address pool) استفاده شود. در این حالت، سرور می‌تواند
فارغ از زیرشبکه کلاینت، آدرس‌ها را از همان محدوده تخصیص دهد. اگر آدرسی از چنین استخری
به کلاینتی در یک زیرشبکه اختصاص یابد، در صورت انتقال کلاینت به زیرشبکه‌ای دیگر،
همان آدرس برای این کلاینت تمدید خواهد شد. به کلاینت دیگری در یک زیرشبکه متفاوت،
آدرسی که پیش‌تر به این کلاینت در هر یک از زیرشبکه‌ها اختصاص یافته است، داده نخواهد شد.
T}
_
T{
استخرهای آدرسی که خارج از زیرشبکه تعریف‌شده خود هستند
T}	T{
خیر
T}	T{
خطای راه‌اندازی: DHCP6_PARSER_FAIL
T}
_
T{
استخرهای واگذاری پیشوند هم‌پوشان در یک زیرشبکه
T}	T{
خیر
T}	T{
خطای راه‌اندازی: DHCP6_PARSER_FAIL
T}
_
T{
استخرهای واگذاری پیشوند هم‌پوشان در زیرشبکه‌های مختلف
T}	T{
بله
T}	T{
مشخص کردن یک استخر واگذاری پیشوند یکسان در زیرشبکه‌های مختلف می‌تواند به عنوان
معادل استخر سراسری به کار رود. در این حالت، سرور می‌تواند صرف‌نظر از زیرشبکه کلاینت،
همان پیشوندها را واگذار کند. اگر پیشوندی از چنین استخری به کلاینتی در یک زیرشبکه
واگذار شود، در صورت جابجایی کلاینت به زیرشبکه‌ای دیگر، همان پیشوند برای این کلاینت
تمدید خواهد شد. به کلاینت دیگری در یک زیرشبکه متفاوت، پیشوندی که پیش‌تر به این کلاینت
در هر یک از زیرشبکه‌ها واگذار شده است، داده نخواهد شد.
T}
_
T{
استخرهای واگذاری پیشوندی که با پیشوند زیرشبکه مطابقت ندارند
T}	T{
بله
T}	T{
در بسیاری از پیاده‌سازی‌ها پیکربندی استخرهای واگذاری پیشوند به‌صورتی که با پیشوند
زیرشبکه مطابقت نداشته باشند رایج است؛ مانند یک استخر پیشوند 3000::/96 درون
زیرشبکه 2001:db8:1::/64. چنین مواردی توسط سرور Kea DHCPv6 پشتیبانی می‌شوند.
T}
.TE
.UNINDENT
.UNINDENT.SS گزینه‌های استاندارد DHCPv6 (Standard DHCPv6 Options)
.sp
یکی از ویژگی‌های اصلی کارساز DHCPv6، توانایی ارائه گزینه‌های پیکربندی به کلاینت‌ها است. با اینکه گزینه‌های متعددی وجود دارند که نیازمند رفتار خاصی هستند، اکثر گزینه‌ها تنها در صورتی توسط کارساز ارسال می‌شوند که کلاینت صراحتاً آن‌ها را درخواست کرده باشد. مثال زیر نحوه پیکربندی نشانی‌های کارسازهای DNS را نشان می‌دهد که یکی از پرکاربردترین گزینه‌ها است. گزینه‌هایی که به این صورت مشخص می‌شوند سراسری (global) تلقی شده و برای تمام زیرشبکه‌های پیکربندی‌شده اعمال می‌گردند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqoption\-data\(dq: [
        {
           \(dqname\(dq: \(dqdns\-servers\(dq,
           \(dqcode\(dq: 23,
           \(dqspace\(dq: \(dqdhcp6\(dq,
           \(dqcsv\-format\(dq: true,
           \(dqdata\(dq: \(dq2001:db8::cafe, 2001:db8::babe\(dq
        },
        ...
    ]
}
.EE
.UNINDENT
.UNINDENT
.sp
خط \fBoption\-data\fP یک مدخل جدید در جدول option\-data ایجاد می‌کند. این جدول حاوی اطلاعات مربوط به تمام گزینه‌های سراسری است که کارساز باید در تمام زیرشبکه‌ها پیکربندی کند. خط \fBname\fP نام گزینه را مشخص می‌کند. (برای مشاهده فهرست کامل نام‌های پشتیبانی‌شده کنونی، بخش «List of standard DHCPv6 options configurable by an administrator»\& را ببینید.) خط بعدی کد گزینه را مشخص می‌کند که باید با یکی از مقادیر آن فهرست مطابقت داشته باشد. خطی که با \fBspace\fP شروع می‌شود فضای گزینه را تعیین می‌کند که همواره باید روی \fBdhcp6\fP تنظیم شود، چرا که این‌ها گزینه‌های استاندارد DHCPv6 هستند. برای سایر فضاهای نام، از جمله فضاهای گزینه سفارشی، بخش «Nested DHCPv6 Options (Custom Option Spaces)»\& را ببینید. خط بعدی قالبی را که داده‌ها در آن وارد می‌شوند مشخص می‌کند؛ استفاده از CSV (مقادیر جداشده با کاما) توصیه می‌شود. در نهایت، خط \fBdata\fP مقدار واقعی ارسال‌شونده به کلاینت‌ها را مشخص می‌سازد. پارامتر data به صورت متن معمولی مشخص می‌شود و در صورتی که بیش از یک مقدار مجاز باشد، مقادیر با کاما از هم جدا می‌شوند.
.sp
گزینه‌ها را می‌توان به صورت مقادیر هگزادسیمال نیز پیکربندی کرد. اگر \fBcsv\-format\fP روی \fBfalse\fP تنظیم شده باشد، داده‌های گزینه باید به عنوان یک رشته هگزادسیمال مشخص شوند. دستورات زیر گزینه \fBdns\-servers\fP را برای تمام زیرشبکه‌ها با نشانی‌های 2001:db8:1::cafe و 2001:db8:1::babe پیکربندی می‌کنند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqoption\-data\(dq: [
        {
           \(dqname\(dq: \(dqdns\-servers\(dq,
           \(dqcode\(dq: 23,
           \(dqspace\(dq: \(dqdhcp6\(dq,
           \(dqcsv\-format\(dq: false,
           \(dqdata\(dq: \(dq20 01 0D B8 00 01 00 00 00 00 00 00 00 00 CA FE \e
                    20 01 0D B8 00 01 00 00 00 00 00 00 00 00 BA BE\(dq
        },
        ...
    ]
}
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
مقدار تنظیم‌شده برای عنصر \fBdata\fP در این مثال برای وضوح بیشتر در دو خط شکسته شده است؛ هنگام وارد کردن دستور، کل رشته باید در یک خط وارد شود.
.UNINDENT
.UNINDENT
.sp
Kea هنگام مشخص کردن داده‌های هگزادسیمال از قالب‌های زیر پشتیبانی می‌کند:
.INDENT 0.0
.IP \(bu 2
\fBاکتت‌های جداشده (Delimited octets)\fP \- یک یا چند اکتت که با دو‌نقطه یا فاصله (\(dq:\(dq یا \(dq \(dq) از یکدیگر جدا شده‌اند. اگرچه هر اکتت می‌تواند شامل یک یا دو رقم باشد، اکیداً توصیه می‌کنیم همواره از دو رقم استفاده کنید. مثال‌های معتبر عبارتند از \(dqab:cd:ef\(dq و \(dqab cd ef\(dq.
.IP \(bu 2
\fBرشته‌ای از ارقام (String of digits)\fP \- یک رشته پیوسته از ارقام هگزادسیمال همراه با پیشوند \(dq0x\(dq یا بدون آن. مثال‌های معتبر عبارتند از \(dq0xabcdef\(dq و \(dqabcdef\(dq.
.UNINDENT
.sp
هنگام استفاده از قالب هگزادسیمال باید دقت شود که کدگذاری مناسب به کار رود؛ توانایی Kea در اعتبارسنجی صحت داده‌ها در قالب هگزادسیمال محدود است.
.sp
همچنین می‌توان داده‌های گزینه‌های باینری را به صورت یک رشته متنی محصور در نقل‌قول تکی (single-quoted) درون نقل‌قول جفت (double quotes) مشخص کرد، همان‌طور که نشان داده شده است (توجه داشته باشید که \fBcsv\-format\fP باید روی \fBfalse\fP تنظیم شود):
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqoption\-data\(dq: [
        {
            \(dqname\(dq: \(dqsubscriber\-id\(dq,
            \(dqcode\(dq: 38,
            \(dqspace\(dq: \(dqdhcp6\(dq,
            \(dqcsv\-format\(dq: false,
            \(dqdata\(dq: \(dq\(aqconvert this text to binary\(aq\(dq
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
بسیاری از پارامترها در ساختار \fBoption\-data\fP اختیاری هستند و در برخی شرایط می‌توان آن‌ها را حذف کرد، همان‌طور که در «Unspecified Parameters for DHCPv6 Option Configuration»\& بحث شده است. تنها یکی از دو مورد \fBname\fP یا \fBcode\fP الزامی است؛ نیازی به مشخص کردن هر دوی آن‌ها نیست. مقدار پیش‌فرض Space برابر با \fBdhcp6\fP است، بنابراین اگر یک گزینه معمولی (غیر کپسوله‌شده) DHCPv6 تعریف شود، می‌توان از این مورد نیز صرف‌نظر کرد. در نهایت، مقدار پیش‌فرض \fBcsv\-format\fP برابر با \fBtrue\fP است، بنابراین از آن هم می‌توان صرف‌نظر کرد مگر اینکه مقدار گزینه به صورت رشته هگزادسیمال (hexstring) مشخص شده باشد. در نتیجه، مثال بالا را می‌توان به این صورت ساده‌سازی کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqoption\-data\(dq: [
        {
           \(dqname\(dq: \(dqdns\-servers\(dq,
           \(dqdata\(dq: \(dq2001:db8::cafe, 2001:db8::babe\(dq
        },
        ...
    ]
}
.EE
.UNINDENT
.UNINDENT
.sp
گزینه‌های تعریف‌شده در صورتی که کلاینت آن‌ها را درخواست کند، به همراه تمام گزینه‌های الزامی در پروتکل، به پاسخ اضافه می‌شوند. مدیر سیستم همچنین می‌تواند مشخص کند که یک گزینه همواره ارسال شود، حتی اگر کلاینت به طور مشخص آن را درخواست نکرده باشد. برای اجبار به افزودن یک گزینه خاص، پرچم \fBalways\-send\fP را روی \fBtrue\fP تنظیم کنید، مانند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqoption\-data\(dq: [
        {
           \(dqname\(dq: \(dqdns\-servers\(dq,
           \(dqdata\(dq: \(dq2001:db8::cafe, 2001:db8::babe\(dq,
           \(dqalways\-send\(dq: true
        },
        ...
    ]
}
.EE
.UNINDENT
.UNINDENT
.sp
اثر این کار همانند آن است که کلاینت کد گزینه را در Option Request Option (یا معادل آن برای گزینه‌های vendor) اضافه کرده باشد، مانند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqoption\-data\(dq: [
        {
           \(dqname\(dq: \(dqdns\-servers\(dq,
           \(dqdata\(dq: \(dq2001:db8::cafe, 2001:db8::babe\(dq,
           \(dqalways\-send\(dq: true
        },
        ...
    ],
    \(dqsubnet6\(dq: [
        {
           \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
           \(dqoption\-data\(dq: [
               {
                   \(dqname\(dq: \(dqdns\-servers\(dq,
                   \(dqdata\(dq: \(dq2001:db8:1::cafe, 2001:db8:1::babe\(dq
               },
               ...
           ],
           ...
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
در مثال بالا، گزینه \fBdns\-servers\fP از پرچم سراسری \fBalways\-send\fP تبعیت کرده و همواره به پاسخ‌ها اضافه می‌شود، اما برای زیرشبکه \fB2001:db8:1::/64\fP، مقدار آن از مشخصات داده‌های گزینه در سطح زیرشبکه دریافت می‌شود.
.sp
برخلاف \fBalways\-send\fP، اگر پرچم \fBnever\-send\fP برای یک گزینه خاص روی \fBtrue\fP تنظیم شود، کارساز آن را به پاسخ اضافه نمی‌کند. اثر این کار مانند آن است که کلاینت کد گزینه را از Option Request Option (یا معادل آن برای گزینه‌های vendor) حذف کرده باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqoption\-data\(dq: [
        {
           \(dqname\(dq: \(dqdns\-servers\(dq,
           \(dqdata\(dq: \(dq2001:db8::cafe, 2001:db8::babe\(dq
        },
        ...
    ],
    \(dqsubnet6\(dq: [
        {
           \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
           \(dqoption\-data\(dq: [
               {
                   \(dqname\(dq: \(dqdns\-servers\(dq,
                   \(dqnever\-send\(dq: true
               },
               ...
           ],
           ...
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
در مثال بالا، گزینه \fBdns\-server\fP هرگز به پاسخ‌ها در زیرشبکه \fB2001:db8:1::/64\fP اضافه نمی‌شود. \fBnever\-send\fP بر \fBalways\-send\fP اولویت دارد، بنابراین اگر هر دو روی \fBtrue\fP تنظیم شده باشند، گزینه اضافه نخواهد شد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
پرچم‌های \fBalways\-send\fP و \fBnever\-send\fP چسبنده (sticky) هستند، بدین معنا که از قواعد معمول توارث پیکربندی پیروی نمی‌کنند. در عوض، اگر حداقل یک بار در طول زنجیره توارث پیکربندی فعال شوند، اعمال می‌گردند \- حتی اگر در بخش‌های دیگری که معمولاً اولویت بالاتری دریافت می‌کنند غیرفعال شده باشند. برای نمونه، اگر یکی از این پرچم‌ها در دامنه سراسری فعال شده باشد اما در سطح زیرشبکه غیرفعال شود، صرف‌نظر از تنظیمات سطح زیرشبکه فعال در نظر گرفته می‌شود.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
پرچم \fBnever\-send\fP نسبت به \fBlibdhcp_flex_option.so\fP \%<#\:std-ischooklib-libdhcp_flex_option\:.so> قدرت کمتری دارد؛ به عنوان مثال، بر گزینه‌هایی که توسط خود کارساز مدیریت می‌شوند هیچ تاثیری ندارد. هر دو پرچم \fBalways\-send\fP و \fBnever\-send\fP بر گزینه‌هایی که قابل درخواست نیستند، مانند گزینه‌های یک فضای سفارشی، بی‌تاثیر هستند.
.UNINDENT
.UNINDENT
.sp
امکان بازنویسی گزینه‌ها بر پایه هر زیرشبکه وجود دارد. اگر انتظار می‌رود کلاینت‌های متصل به اغلب زیرشبکه‌ها مقادیر یکسانی از یک گزینه معین را دریافت کنند، مدیران سیستم باید از گزینه‌های سراسری استفاده کنند؛ همچنین این امکان وجود دارد که مقادیر خاصی برای تعداد اندکی از زیرشبکه‌ها بازنویسی شوند. از سوی دیگر، اگر در هر زیرشبکه از مقادیر متفاوتی استفاده می‌شود، مشخص کردن مقادیر گزینه‌های سراسری توجیهی ندارد؛ بلکه تنها باید گزینه‌های مختص زیرشبکه تنظیم شوند.
.sp
دستورات زیر گزینه سراسری \fBdns\-servers\fP را برای یک زیرشبکه خاص بازنویسی کرده و یک کارساز DNS منفرد با نشانی 2001:db8:1::3 تنظیم می‌کنند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqsubnet6\(dq: [
        {
            \(dqoption\-data\(dq: [
                {
                    \(dqname\(dq: \(dqdns\-servers\(dq,
                    \(dqcode\(dq: 23,
                    \(dqspace\(dq: \(dqdhcp6\(dq,
                    \(dqcsv\-format\(dq: true,
                    \(dqdata\(dq: \(dq2001:db8:1::3\(dq
                },
                ...
            ],
            ...
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
در برخی شرایط، اختصاص دادن برخی گزینه‌ها به یک استخر (pool) نشانی یا پیشوند که کلاینت اجاره (lease) خود را از آن دریافت می‌کند سودمند است. مقادیر گزینه‌های مختص استخر، مقادیر گزینه‌های مختص زیرشبکه و سراسری را بازنویسی می‌کنند. اگر کلاینت چندین اجاره از استخرهای مختلف دریافت کند، کارساز گزینه‌ها را از تمامی استخرهایی که اجاره‌ها از آن‌ها به دست آمده‌اند اختصاص می‌دهد. با این وجود، چنانچه گزینه خاصی در چندین استخر که کلاینت از آن‌ها اجاره می‌گیرد مشخص شده باشد، تنها یک نمونه از این گزینه به کلاینت تحویل داده می‌شود. مدیر کارساز نباید تلاش کند با تغییر ترتیب تعریف استخرها در پیکربندی کارساز، اقدام به اولویت‌بندی در تخصیص گزینه‌های مختص استخر نماید.
.sp
قطعه پیکربندی زیر نشان می‌دهد چگونه می‌توان گزینه \fBdns\-servers\fP را مشخص کرد تا تنها در صورتی که کلاینت نشانی خود را از استخر داده‌شده به دست آورد، به آن اختصاص یابد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqsubnet6\(dq: [
        {
            \(dqpools\(dq: [
                {
                    \(dqpool\(dq: \(dq2001:db8:1::100\-2001:db8:1::300\(dq,
                    \(dqoption\-data\(dq: [
                        {
                            \(dqname\(dq: \(dqdns\-servers\(dq,
                            \(dqdata\(dq: \(dq2001:db8:1::10\(dq
                        }
                    ]
                }
            ]
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
گزینه‌ها را می‌توان در دامنه کلاس یا رزرو میزبان (host\-reservation) نیز مشخص کرد. ترتیب اولویت گزینه‌ها در Kea در حال حاضر (از بیشترین اولویت به کمترین) به شرح زیر است: رزرو میزبان، استخر (pool)، زیرشبکه (subnet)، شبکه مشترک (shared network)، کلاس (class)، سراسری (global).
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
از نسخه 2.7.4 نرم‌افزار Kea به بعد، گنجاندن گزینه‌ها را می‌توان از طریق برچسب‌گذاری کلاس گزینه (option class\-tagging) نیز کنترل کرد؛ بخش «Option Class\-Tagging» \%<#\:option-class-tagging> را ببینید.
.UNINDENT
.UNINDENT
.sp
زمانی که یک فیلد داده به صورت رشته باشد و آن رشته حاوی نویسه کاما (\fB,\fP؛ U+002C) باشد، کاما باید با دو بک‌اسلش گریز داده شود (\fB\e\e,\fP؛ U+005C). این گریز دوگانه از این رو الزامی است که هم روال جداسازی داده‌های CSV به فیلدها و هم ساختار JSON از نویسه گریز یکسانی استفاده می‌کنند؛ یک تک‌گریز (\fB\e,\fP) ساختار JSON را نامعتبر خواهد کرد. برای مثال، رشته \(dqEST5EDT4,M3.2.0/02:00,M11.1.0/02:00\(dq باید به صورت زیر نمایش داده شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqsubnet6\(dq: [
        {
            \(dqpools\(dq: [
                {
                    \(dqoption\-data\(dq: [
                        {
                            \(dqname\(dq: \(dqnew\-posix\-timezone\(dq,
                            \(dqdata\(dq: \(dqEST5EDT4\e\e,M3.2.0/02:00\e\e,M11.1.0/02:00\(dq
                        }
                    ]
                },
                ...
            ],
            ...
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
برخی گزینه‌ها به عنوان آرایه تعیین شده‌اند، به این معنی که بیش از یک مقدار برای آن‌ها مجاز است. به عنوان مثال، گزینه \fBdns\-servers\fP امکان تعیین بیش از یک نشانی IPv6 را فراهم می‌سازد که به کلاینت‌ها اجازه می‌دهد نشانی‌های چندین کارساز DNS را به دست آورند.
.sp
بخش «Custom DHCPv6 Options» نحو (syntax) پیکربندی را جهت ایجاد تعاریف (قالب‌های) گزینه‌های سفارشی شرح می‌دهد. ایجاد تعاریف سفارشی برای گزینه‌های استاندارد عموماً مجاز نیست، حتی اگر تعریف در حال ایجاد دقیقاً با قالب گزینه تعریف‌شده در RFCها مطابقت داشته باشد. با این حال، یک استثنا برای این قاعده در مورد گزینه‌های استانداردی وجود دارد که Kea در حال حاضر تعریفی برای آن‌ها ارائه نمی‌دهد. برای استفاده از چنین گزینه‌هایی، مدیر کارساز باید همان‌طور که در «Custom DHCPv6 Options» شرح داده شده است، تعریفی در فضای گزینه \fBdhcp6\fP ایجاد کند. این تعریف باید با قالب گزینه شرح داده شده در RFC مربوطه مطابقت داشته باشد، اما سازوکار پیکربندی هر قالب گزینه‌ای را مجاز می‌داند زیرا در حال حاضر روشی برای اعتبارسنجی آن وجود ندارد.
.sp
گزینه‌های استاندارد DHCPv6 که در حال حاضر پشتیبانی می‌شوند در جدول زیر فهرست شده‌اند. مقادیر \(dqName\(dq و \(dqCode\(dq مقادیری هستند که باید به عنوان name/code در ساختارهای option\-data استفاده شوند. \(dqType\(dq قالب داده‌ها را مشخص می‌سازد؛ معانی انواع مختلف در «List of standard DHCP option types» \%<#\:dhcp-types>\& ارائه شده است..SS فهرست گزینه‌های استاندارد DHCPv6 قابل پیکربندی توسط مدیر سیستم
.TS
box center;
l|l|l|l.
T{
نام
T}	T{
کد
T}	T{
نوع
T}	T{
آرایه؟
T}
_
T{
preference
T}	T{
7
T}	T{
uint8
T}	T{
false
T}
_
T{
unicast
T}	T{
12
T}	T{
ipv6\-address
T}	T{
false
T}
_
T{
sip\-server\-dns
T}	T{
21
T}	T{
fqdn
T}	T{
true
T}
_
T{
sip\-server\-addr
T}	T{
22
T}	T{
ipv6\-address
T}	T{
true
T}
_
T{
dns\-servers
T}	T{
23
T}	T{
ipv6\-address
T}	T{
true
T}
_
T{
domain\-search
T}	T{
24
T}	T{
fqdn
T}	T{
true
T}
_
T{
nis\-servers
T}	T{
27
T}	T{
ipv6\-address
T}	T{
true
T}
_
T{
nisp\-servers
T}	T{
28
T}	T{
ipv6\-address
T}	T{
true
T}
_
T{
nis\-domain\-name
T}	T{
29
T}	T{
fqdn
T}	T{
true
T}
_
T{
nisp\-domain\-name
T}	T{
30
T}	T{
fqdn
T}	T{
true
T}
_
T{
sntp\-servers
T}	T{
31
T}	T{
ipv6\-address
T}	T{
true
T}
_
T{
information\-refresh\-time
T}	T{
32
T}	T{
uint32
T}	T{
false
T}
_
T{
bcmcs\-server\-dns
T}	T{
33
T}	T{
fqdn
T}	T{
true
T}
_
T{
bcmcs\-server\-addr
T}	T{
34
T}	T{
ipv6\-address
T}	T{
true
T}
_
T{
geoconf\-civic
T}	T{
36
T}	T{
record (uint8,
uint16, binary)
T}	T{
false
T}
_
T{
remote\-id
T}	T{
37
T}	T{
record (uint32,
binary)
T}	T{
false
T}
_
T{
subscriber\-id
T}	T{
38
T}	T{
binary
T}	T{
false
T}
_
T{
client\-fqdn
T}	T{
39
T}	T{
record (uint8,
fqdn)
T}	T{
false
T}
_
T{
pana\-agent
T}	T{
40
T}	T{
ipv6\-address
T}	T{
true
T}
_
T{
new\-posix\-timezone
T}	T{
41
T}	T{
string
T}	T{
false
T}
_
T{
new\-tzdb\-timezone
T}	T{
42
T}	T{
string
T}	T{
false
T}
_
T{
ero
T}	T{
43
T}	T{
uint16
T}	T{
true
T}
_
T{
lq\-query (1)
T}	T{
44
T}	T{
record (uint8,
ipv6\-address)
T}	T{
false
T}
_
T{
client\-data (1)
T}	T{
45
T}	T{
empty
T}	T{
false
T}
_
T{
clt\-time (1)
T}	T{
46
T}	T{
uint32
T}	T{
false
T}
_
T{
lq\-relay\-data (1)
T}	T{
47
T}	T{
record
(ipv6\-address,
binary)
T}	T{
false
T}
_
T{
lq\-client\-link (1)
T}	T{
48
T}	T{
ipv6\-address
T}	T{
true
T}
_
T{
v6\-lost
T}	T{
51
T}	T{
fqdn
T}	T{
false
T}
_
T{
capwap\-ac\-v6
T}	T{
52
T}	T{
ipv6\-address
T}	T{
true
T}
_
T{
relay\-id
T}	T{
53
T}	T{
binary
T}	T{
false
T}
_
T{
ntp\-server
T}	T{
56
T}	T{
empty
T}	T{
false
T}
_
T{
v6\-access\-domain
T}	T{
57
T}	T{
fqdn
T}	T{
false
T}
_
T{
sip\-ua\-cs\-list
T}	T{
58
T}	T{
fqdn
T}	T{
true
T}
_
T{
bootfile\-url
T}	T{
59
T}	T{
string
T}	T{
false
T}
_
T{
bootfile\-param
T}	T{
60
T}	T{
tuple
T}	T{
true
T}
_
T{
client\-arch\-type
T}	T{
61
T}	T{
uint16
T}	T{
true
T}
_
T{
nii
T}	T{
62
T}	T{
record (uint8,
uint8, uint8)
T}	T{
false
T}
_
T{
aftr\-name
T}	T{
64
T}	T{
fqdn
T}	T{
false
T}
_
T{
erp\-local\-domain\-name
T}	T{
65
T}	T{
fqdn
T}	T{
false
T}
_
T{
rsoo
T}	T{
66
T}	T{
empty
T}	T{
false
T}
_
T{
pd\-exclude
T}	T{
67
T}	T{
binary
T}	T{
false
T}
_
T{
rdnss\-selection
T}	T{
74
T}	T{
record
(ipv6\-address,
uint8, fqdn)
T}	T{
true
T}
_
T{
client\-linklayer\-addr
T}	T{
79
T}	T{
binary
T}	T{
false
T}
_
T{
link\-address
T}	T{
80
T}	T{
ipv6\-address
T}	T{
false
T}
_
T{
solmax\-rt
T}	T{
82
T}	T{
uint32
T}	T{
false
T}
_
T{
inf\-max\-rt
T}	T{
83
T}	T{
uint32
T}	T{
false
T}
_
T{
dhcp4o6\-server\-addr
T}	T{
88
T}	T{
ipv6\-address
T}	T{
true
T}
_
T{
s46\-rule
T}	T{
89
T}	T{
record (uint8,
uint8, uint8,
ipv4\-address,
ipv6\-prefix)
T}	T{
false
T}
_
T{
s46\-br
T}	T{
90
T}	T{
ipv6\-address
T}	T{
false
T}
_
T{
s46\-dmr
T}	T{
91
T}	T{
ipv6\-prefix
T}	T{
false
T}
_
T{
s46\-v4v6bind
T}	T{
92
T}	T{
record
(ipv4\-address,
ipv6\-prefix)
T}	T{
false
T}
_
T{
s46\-portparams
T}	T{
93
T}	T{
record(uint8,
psid)
T}	T{
false
T}
_
T{
s46\-cont\-mape
T}	T{
94
T}	T{
empty
T}	T{
false
T}
_
T{
s46\-cont\-mapt
T}	T{
95
T}	T{
empty
T}	T{
false
T}
_
T{
s46\-cont\-lw
T}	T{
96
T}	T{
empty
T}	T{
false
T}
_
T{
v6\-captive\-portal
T}	T{
103
T}	T{
string
T}	T{
false
T}
_
T{
v6\-sztp\-redirect
T}	T{
136
T}	T{
tuple
T}	T{
true
T}
_
T{
ipv6\-address\-andsf
T}	T{
143
T}	T{
ipv6\-address
T}	T{
true
T}
_
T{
v6\-dnr
T}	T{
144
T}	T{
record (uint16,
uint16, fqdn,
binary)
T}	T{
false
T}
_
T{
addr\-reg\-enable
T}	T{
148
T}	T{
empty
T}	T{
false
T}
.TE
.sp
می‌توانید نمونه‌ای از چگونگی پیکربندی این گزینه‌ها را در kea6/all\-options.json \%<#\:config-example-kea6-all-options-json>\& مشاهده کنید.
.sp
گزینهٔ unicast توسط RFC 9915 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc9915> منسوخ شده است؛ این گزینه همچنان پشتیبانی می‌شود اما نباید استفاده شود و در نگارش‌های بعدی Kea حذف خواهد شد.
.sp
گزینه‌های مشخص‌شده با (1) دارای تعاریف گزینه هستند، اما منطق پردازشیِ
پشت آن‌ها پیاده‌سازی نشده است. این بدان معناست که از نظر فنی، Kea می‌داند
چگونه آن‌ها را در پیام‌های دریافتی تجزیه کند یا در صورت پیکربندی، چگونه
ارسالشان نماید، اما نمی‌داند باید با آن‌ها چه کار کند. از آنجا که RFCهای مربوطه
نیازمند پردازش‌های ویژه‌ای هستند، پشتیبانی از این گزینه‌ها غیرعملیاتی (non\-functional)
است. با این حال، ممکن است در برخی آزمون‌های محدود آزمایشگاهی مفید باشد؛
از این رو ساختار تعاریف آن‌ها در اینجا فهرست شده است.
.sp
پیکربندی برخی گزینه‌ها نسبت به گزینه‌های دیگر پیچیده‌تر است. به‌ویژه، خانوادهٔ گزینه‌های Softwire46
و Discovery of Network\-designated Resolvers (DNR) در بخش‌های جداگانه‌ای در ادامه بررسی شده‌اند.
.sp
Kea از گزینه‌های بیشتری نسبت به موارد فهرست‌شده در بالا پشتیبانی می‌کند. فهرست زیر بیشتر برای خوانندگانی مفید است که
می‌خواهند بدانند آیا Kea قادر به پشتیبانی از گزینه‌های خاصی هست یا خیر. گزینه‌های زیر
توسط خود موتور Kea بازگردانده می‌شوند و به‌طور کلی نباید به‌صورت دستی پیکربندی شوند..SS فهرست گزینه‌های استاندارد DHCPv6 که به‌طور خودکار توسط Kea مدیریت شده و مستقیماً توسط مدیر سیستم قابل پیکربندی نیستند
.TS
box center;
l|l|l.
T{
نام
T}	T{
کد
T}	T{
توضیحات
T}
_
T{
client\-id
T}	T{
1
T}	T{
توسط کلاینت ارسال می‌شود؛ Kea از آن برای تمایز میان کلاینت‌ها استفاده می‌کند.
T}
_
T{
server\-id
T}	T{
2
T}	T{
توسط کلاینت‌ها برای درخواست عملیات از یک سرور مشخص، و توسط سرور برای
معرفی و شناسایی خود ارسال می‌شود. برای جزئیات به Server Identifier in DHCPv6 مراجعه کنید.
T}
_
T{
ia\-na
T}	T{
3
T}	T{
یک گزینه دربرگیرنده (container) که آدرس‌های IPv6 (گزینه‌های \fBiaddr\fP) را منتقل می‌کند. Kea
این گزینه‌ها را با استفاده از موتور تخصیص خود دریافت و ارسال می‌کند.
T}
_
T{
ia\-ta
T}	T{
4
T}	T{
آدرس‌های موقت را منتقل می‌کند. قابلیتی منسوخ‌شده است و پشتیبانی نمی‌شود.
T}
_
T{
iaaddr
T}	T{
5
T}	T{
آدرس‌ها را به همراه طول عمر در گزینه‌های \fBia\-na\fP و \fBia\-ta\fP منتقل می‌کند.
T}
_
T{
oro
T}	T{
6
T}	T{
گزینه ORO (یا Option Request Option) توسط کلاینت‌ها برای درخواست فهرستی
از گزینه‌های مورد نظر استفاده می‌شود. Kea از آن پشتیبانی می‌کند و در صورت
پیکربندی با گزینه‌های لازم، گزینه‌های درخواستی را بازمی‌گرداند.
T}
_
T{
elapsed\-time
T}	T{
8
T}	T{
توسط کلاینت‌ها ارسال می‌شود تا مشخص کند چه مدت در تلاش برای دریافت
پیکربندی بوده‌اند. Kea مقادیر بالای ارسال‌شده توسط کلاینت را به عنوان نشانه‌ای
از وجود مشکل تلقی می‌کند؛ این یکی از جنبه‌های مورد استفاده در HA برای تعیین
وضعیت سلامت شریک (partner) است.
T}
_
T{
relay\-msg
T}	T{
9
T}	T{
توسط رله‌ها برای کپسوله‌سازی پیام اصلی کلاینت استفاده می‌شود. Kea هنگام
بازگرداندن پاسخ‌های بازپخش‌شده به عامل رله (relay agent) از آن استفاده می‌کند.
T}
_
T{
auth
T}	T{
11
T}	T{
برای انتقال اطلاعات احراز هویت بین کلاینت‌ها و سرور استفاده می‌شود. پشتیبانی
از این گزینه بسیار محدود است.
T}
_
T{
status\-code
T}	T{
13
T}	T{
گزینه‌ای که سرور می‌تواند در صورت بروز شکست‌های مختلف، مانند تمام شدن
آدرس‌ها یا پیکربندی نشدن برای تخصیص پیشوندها، آن را ضمیمه کند.
T}
_
T{
rapid\-commit
T}	T{
14
T}	T{
برای نشان دادن تمایل کلاینت به پشتیبانی از \fBrapid\-commit\fP و
پذیرش این پیکربندی توسط سرور استفاده می‌شود. برای جزئیات به
Rapid Commit مراجعه کنید.
T}
_
T{
user\-class
T}	T{
15
T}	T{
توسط کلاینت برای شناسایی نوع دستگاه خود ارسال می‌شود. Kea
می‌تواند از این مورد برای رده‌بندی کلاینت (client classification) استفاده کند.
T}
_
T{
vendor\-class
T}	T{
16
T}	T{
مشابه \fBuser\-class\fP، اما وابسته به سازنده (vendor\-specific).
T}
_
T{
vendor\-opts
T}	T{
17
T}	T{
یک دربرگیرنده اختصاصی سازنده که توسط کلاینت و سرور برای تبادل گزینه‌های
ویژه سازنده استفاده می‌شود. منطق پشت این گزینه‌ها بین سازندگان مختلف متفاوت است.
گزینه‌های سازنده در DHCPv6 Vendor\-Specific Options توضیح داده شده‌اند\&.
T}
_
T{
interface\-id
T}	T{
18
T}	T{
ممکن است توسط عامل رله برای مشخص کردن رابطی که پیام اصلی کلاینت
روی آن دریافت شده درج شود. می‌توان به Kea دستور داد تا از این اطلاعات برای
انتخاب زیرشبکه‌های خاص استفاده کند. همچنین در صورت تعیین، Kea این گزینه را
بازتاب (echo) می‌دهد تا رله بداند از کدام رابط برای دسترسی به کلاینت استفاده کند.
T}
_
T{
ia\-pd
T}	T{
25
T}	T{
یک دربرگیرنده برای انتقال واگذاری پیشوند (Prefix Delegations یا PDs) که به
کلاینت‌ها واگذار می‌شود. برای جزئیات به Subnet and Prefix Delegation Pools مراجعه کنید.
T}
_
T{
iaprefix
T}	T{
26
T}	T{
پیشوند IPv6 را در گزینه \fBia\-pd\fP منتقل می‌کند. برای جزئیات به
Subnet and Prefix Delegation Pools مراجعه کنید.
T}
.TE.SS گزینه‌های مشترک Softwire46
.sp
گزینه‌های Softwire46 در تدارک و راه‌اندازی IPv4\-over\-IPv6 از طریق تونل‌زنی یا ترجمه، همان‌طور که در RFC
7598 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc7598>\& مشخص شده است، به کار می‌روند. بخش‌های
زیر مثال‌هایی از پیکربندی این گزینه‌ها را ارائه می‌دهند.
.SS گزینه‌های کانتینر Softwire46
.sp
گزینه‌های کانتینر Softwire46 (S46) قواعد و پارامترهای اختیاری درگاه (port) را برای یک
دامنه مشخص گروه‌بندی می‌کنند. سه گزینه کانتینر در فضای گزینه \(dqdhcp6\(dq
(سطح بالا) مشخص شده‌اند: گزینه کانتینر MAP\-E، گزینه کانتینر MAP\-T، و گزینه
کانتینر S46 Lightweight 4over6. این گزینه‌ها تنها شامل گزینه‌های کپسوله‌شده
مشخص‌شده در زیر هستند؛ آن‌ها شامل هیچ فیلد داده‌ای نمی‌باشند.
.sp
برای پیکربندی سرور جهت ارسال یک گزینه کانتینر خاص به همراه تمام گزینه‌های
کپسوله‌شده، گزینه کانتینر باید مطابق شکل زیر در پیکربندی سرور گنجانده شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqoption\-data\(dq: [
        {
            \(dqname\(dq: \(dqs46\-cont\-mape\(dq
        } ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
این پیکربندی باعث می‌شود سرور گزینه کانتینر MAP\-E را برای کلاینت ارسال کند. به ترتیب
از \fBs46\-cont\-mapt\fP یا \fBs46\-cont\-lw\fP برای گزینه‌های کانتینر MAP\-T و
کانتینر S46 Lightweight 4over6 استفاده کنید.
.sp
تمام گزینه‌های باقی‌مانده Softwire46 که در ادامه شرح داده شده‌اند، در یکی از گزینه‌های
کانتینر گنجانده می‌شوند. بنابراین، آن‌ها باید با انتخاب نام \fBspace\fP که مشخص‌کننده
گزینه‌ای است که باید در آن قرار گیرند، در فضاهای گزینه مناسب گنجانده شوند.
.SS گزینه S46 Rule
.sp
گزینه S46 Rule برای انتقال قاعده نگاشت پایه (BMR) و قاعده نگاشت بازارسال (FMR)
استفاده می‌شود.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqspace\(dq: \(dqs46\-cont\-mape\-options\(dq,
    \(dqname\(dq: \(dqs46\-rule\(dq,
    \(dqdata\(dq: \(dq128, 0, 24, 192.0.2.0, 2001:db8:1::/64\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
مقدار ممکن دیگر برای \fBspace\fP، مقدار \fBs46\-cont\-mapt\-options\fP است.
.sp
گزینه S46 Rule چندین پارامتر را منتقل می‌کند:
.INDENT 0.0
.IP \(bu 2
\fBflags\fP \- یک عدد صحیح بی‌علامت ۸ بیتی، که در حال حاضر تنها باارزش‌ترین بیت
آن مشخص شده است. این مقدار مشخص می‌کند که آیا قاعده می‌تواند برای بازارسال (forwarding)
استفاده شود (128) یا خیر (0).
.IP \(bu 2
\fBea\-len\fP \- طول آدرس تعبیه‌شده (Embedded Address) با طول ۸ بیت. مقادیر مجاز
در بازه 0 تا 48 قرار دارند.
.IP \(bu 2
\fBIPv4 prefix length\fP \- بیانی ۸ بیتی از طول پیشوند برای پیشوند IPv4 قاعده که
در فیلد \fBipv4\-prefix\fP مشخص شده است. مقادیر مجاز در بازه 0 تا 32 قرار دارند.
.IP \(bu 2
\fBIPv4 prefix\fP \- یک فیلد ۳۲ بیتی با طول ثابت که پیشوند IPv4 را برای قاعده S46
مشخص می‌کند. بیت‌های موجود در پیشوند پس از تعداد مشخصی بیت (تعریف‌شده در \fBprefix4\-len\fP)
رزرو شده‌اند و فرستنده باید حتماً آن‌ها را با صفر مقداردهی اولیه کرده و گیرنده باید آن‌ها را
نادیده بگیرد.
.IP \(bu 2
\fBIPv6 prefix\fP \- فیلدی با نمادگذاری پیشوند/طول که پیشوند دامنه IPv6 را برای قاعده
S46 مشخص می‌کند. هنگامی که \fBprefix6\-len\fP بخش‌پذیر بر 8 نباشد، این فیلد از سمت راست
با بیت‌های صفر تا نزدیک‌ترین مرز بایت (اکتت) پر (pad) می‌شود.
.UNINDENT
.SS گزینه S46 BR
.sp
گزینه S46 BR برای انتقال آدرس IPv6 رله مرزی (Border Relay) استفاده می‌شود.
این گزینه در گزینه کانتینر MAP\-E اجباری است و در گزینه‌های کانتینر MAP\-T و
S46 Lightweight 4over6 مجاز نیست.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqspace\(dq: \(dqs46\-cont\-mape\-options\(dq,
    \(dqname\(dq: \(dqs46\-br\(dq,
    \(dqdata\(dq: \(dq2001:db8:cafe::1\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
مقدار ممکن دیگر برای \fBspace\fP، مقدار \fBs46\-cont\-lw\-options\fP است.
.SS گزینه S46 DMR
.sp
گزینه S46 DMR برای انتقال مقادیر قاعده نگاشت پیش‌فرض (DMR) استفاده می‌شود.
این گزینه در گزینه کانتینر MAP\-T اجباری است و در گزینه‌های کانتینر MAP\-E و
S46 Lightweight 4over6 مجاز نیست.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqspace\(dq: \(dqs46\-cont\-mapt\-options\(dq,
    \(dqname\(dq: \(dqs46\-dmr\(dq,
    \(dqdata\(dq: \(dq2001:db8:cafe::/64\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
این گزینه نباید در کانتینرهای دیگر گنجانده شود..SS گزینه پیوند نشانی S46 IPv4/IPv6 (S46 IPv4/IPv6 Address Binding Option)
.sp
گزینه S46 IPv4/IPv6 Address Binding می‌تواند برای مشخص کردن نشانی کامل یا اشتراکی IPv4 سمت مشتری (Customer Edge یا CE) استفاده شود. فیلد پیشوند IPv6 توسط CE برای شناسایی پیشوند صحیح جهت استفاده به عنوان مبدأ تونل به کار می‌رود.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqspace\(dq: \(dqs46\-cont\-lw\(dq,
    \(dqname\(dq: \(dqs46\-v4v6bind\(dq,
    \(dqdata\(dq: \(dq192.0.2.3, 2001:db8:1:cafe::/64\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
این گزینه نباید در کانتینرهای دیگر گنجانده شود.
.SS پارامترهای پورت S46 (S46 Port Parameters)
.sp
گزینه S46 Port Parameters اطلاعات اختیاری مجموعه پورت‌ها (port\-set) را مشخص می‌کند که ممکن است در اختیار CEها قرار گیرد.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqspace\(dq: \(dqs46\-rule\-options\(dq,
    \(dqname\(dq: \(dqs46\-portparams\(dq,
    \(dqdata\(dq: \(dq2, 3/4\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
یک مقدار ممکن دیگر برای \fBspace\fP مقدار \fBs46\-v4v6bind\fP است تا این گزینه در گزینه S46 IPv4/IPv6 Address Binding قرار گیرد.
.sp
توجه داشته باشید که مقدار دوم در مثال بالا فیلدهای PSID و طول PSID (PSID\-length) را در قالب PSID/PSID length مشخص می‌کند. این معادل مقادیر \fBPSID\-len=4\fP و \fBPSID=12288\fP منتقل‌شده در گزینه S46 Port Parameters است.
.SS گزینه‌های DNR (Discovery of Network\-designated Resolvers) برای DHCPv6
.sp
گزینه کشف تحلیل‌کننده‌های تعیین‌شده توسط شبکه، یا گزینه DNR، در RFC 9463 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc9463> به عنوان روشی برای اعلام مکان تحلیل‌کننده‌های DNS در دسترس از طریقی غیر از DNS کلاسیک بر روی UDP و پورت ۵۳ معرفی شد. تا بهار ۲۰۲۴، فناوری‌های پشتیبانی‌شده عبارتند از DoT (DNS\-over\-TLS)، DoH (DNS\-over\-HTTPS) و DoQ (DNS\-over\-QUIC)، اما این گزینه به گونه‌ای طراحی شده است که توسعه‌پذیر بوده و در آینده پروتکل‌های دیگر را نیز در بر گیرد.
.sp
گزینه DNR را می‌توان با استفاده از نشانه‌گذاری مناسبی پیکربندی کرد: فیلدهای جداشده با کاما باید به ترتیب زیر ارائه شوند:
.INDENT 0.0
.IP \(bu 2
اولویت سرویس (Service Priority) (اجباری)،
.IP \(bu 2
نام دامنه کاملاً مشخص ADN (اجباری)،
.IP \(bu 2
نشانی(های) IP (اختیاری؛ اگر بیش از یکی باشد، باید با فاصله جدا شوند)
.IP \(bu 2
پارامترهای SvcParams به صورت مجموعه‌ای از جفت‌های کلید=مقدار (اختیاری؛ اگر بیش از یکی باشد، باید با فاصله جدا شوند. برای ارائه بیش از یک \fBalpn\-id\fP، آنها را با کاماهای گریز داده‌شده با دو بک‌اسلش مانند مثال زیر جدا کنید).
.UNINDENT
.sp
فرض کنیم می‌خواهیم یک سرور DoT در حال کار در \fBdot1.example.org\fP (که به دو نشانی IPv6 تحلیل می‌شود: \fB2001:db8::1\fP و \fB2001:db8::2\fP) روی یک پورت غیر استاندارد ۸۵۳۰ را اعلام کنیم. یک گزینه نمونه که این اطلاعات را منتقل می‌کند به شکل زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqname\(dq: \(dqv6\-dnr\(dq, // نام گزینه

  // فیلدهای زیر باید مشخص شوند:
  // \- اولویت سرویس (عدد صحیح ۱۶ بیتی بدون علامت)
  // \- authentication\-domain\-name (نام FQDN مربوط به تحلیل‌کننده رمزگذاری‌شده)
  // \- فهرستی از یک یا چند نشانی IPv6
  // \- فهرستی از پارامترها در قالب key=value که با فاصله جدا شده‌اند؛ هرگونه
  //   نویسه کاما در این فیلد باید با دو بک‌اسلش گریز داده شود
  \(dqdata\(dq: \(dq100, dot1.example.org., 2001:db8::1 2001:db8::2, alpn=dot port=8530\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
گزینه بالا در رسانه انتقال (on\-wire) به صورت زیر کدگذاری خواهد شد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
00 64 \- اولویت سرویس (۱۰۰ در هگز به صورت عدد صحیح ۱۶ بیتی بدون علامت)
00 12 \- طول FQDN نام دامنه احراز هویت (نام تحلیل‌کننده) (۱۸ در هگز به صورت عدد صحیح ۱۶ بیتی بدون علامت)
04 64 6f 74 31 07 65 78 61 6d 70 6c 65 03 6f 72 67 00 \- ۱۸ اوکتت از ADN FQDN
00 20 \- ۳۲ اوکتت، طول دو نشانی IPv6 پس از آن است
20 01 0d b8 00 00 00 00 00 00 00 00 00 00 00 01 \- 2001:db8::1
20 01 0d b8 00 00 00 00 00 00 00 00 00 00 00 02 \- 2001:db8::2
00 01 \- شروع SvcParams \- این alpn SvcParamKey است
00 04 \- طول فیلد alpn SvcParamValue (۴ اوکتت)
03    \- طول alpn\-id بعدی کدگذاری‌شده در یک اوکتت
64 6f 74 \- \(dqdot\(dq \- مقدار alpn
00 03 \- این port SvcParamKey است
00 02 \- طول فیلد SvcParamValue برابر ۲ اوکتت است
21 52 \- مقدار واقعی 0x2152 یا ۸۵۳۰ در مبنای ده‌دهی است
.EE
.UNINDENT
.UNINDENT
.sp
مثال زیر نحوه پیکربندی بیش از یک پروتکل \fBALPN\fP را در پارامترهای سرویس (Service Parameters) نشان می‌دهد. این مثال تحلیل‌کننده‌ای شناخته‌شده به نام \fBresolver.example\fP را مشخص می‌کند که از موارد زیر پشتیبانی می‌کند:
.INDENT 0.0
.IP \(bu 2
پروتکل DoT روی پورت پیش‌فرض ۸۵۳
.IP \(bu 2
پروتکل DoQ روی پورت پیش‌فرض ۸۵۳
.IP \(bu 2
پروتکل DoH در \fBhttps://resolver.example/q{?dns}\fP
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqname\(dq: \(dqv6\-dnr\(dq, // نام گزینه

  // به کاماهای گریز داده‌شده با دو بک‌اسلش در فهرست alpn\-id توجه کنید.
  \(dqdata\(dq: \(dq150, resolver.example., 2001:db8::1 2001:db8::2, alpn=dot\e\e,doq\e\e,h2\e\e,h3 dohpath=/q{?dns}\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
گزینه بالا در رسانه انتقال (on\-wire) به صورت زیر کدگذاری خواهد شد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
00 96 \- اولویت سرویس (۱۵۰ در هگز به صورت عدد صحیح ۱۶ بیتی بدون علامت)
00 12 \- طول FQDN نام دامنه احراز هویت (نام تحلیل‌کننده) (۱۸ در هگز به صورت عدد صحیح ۱۶ بیتی بدون علامت)
08 72 65 73 6f 6c 76 65 72 07 65 78 61 6d 70 6c 65 00 \- ۱۸ اوکتت از ADN FQDN
00 20 \- ۳۲ اوکتت، طول دو نشانی IPv6 پس از آن است
20 01 0d b8 00 00 00 00 00 00 00 00 00 00 00 01 \- 2001:db8::1
20 01 0d b8 00 00 00 00 00 00 00 00 00 00 00 02 \- 2001:db8::2
00 01 \- شروع SvcParams \- این alpn SvcParamKey است
00 0e \- طول فیلد alpn SvcParamValue (۱۴ اوکتت)
03    \- طول alpn\-id بعدی کدگذاری‌شده در یک اوکتت
64 6f 74 \- \(dqdot\(dq \- مقدار alpn
03    \- طول alpn\-id بعدی کدگذاری‌شده در یک اوکتت
64 6f 71 \- \(dqdoq\(dq \- مقدار alpn
02    \- طول alpn\-id بعدی کدگذاری‌شده در یک اوکتت
68 32 \- \(dqh2\(dq \- مقدار alpn \(dqHTTP/2 over TLS\(dq
02    \- طول alpn\-id بعدی کدگذاری‌شده در یک اوکتت
68 33 \- \(dqh3\(dq \- مقدار alpn \(dqHTTP/3\(dq
00 07 \- این dohpath SvcParamKey است
00 08 \- طول فیلد SvcParamValue برابر ۸ اوکتت است
2f 71 7b 3f 64 6e 73 7d \- \(dq/q{?dns}\(dq dohpath
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
اگر نویسه‌های «کاما» (\(dqcomma\(dq) یا «پایپ» (\(dqpipe\(dq) به جای جداکننده فیلد به عنوان متن استفاده شوند، باید با دو بک‌اسلش گریز داده شوند (\fB\e\e,\fP یا \fB\e\e|\fP). هنگام پیکربندی بیش از یک پروتکل \fBALPN\fP، باید از کاماهای گریزخورده برای جداسازی آنها استفاده شود. نویسه «پایپ» (\fB0x7C\fP) می‌تواند در پارامتر سرویس \fBdohpath\fP استفاده شود، زیرا در یک URI مجاز است.
.UNINDENT
.UNINDENT
.sp
بخش ۴.۱ از سند RFC 9463 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc9463#\:name-option-format> استفاده از SvcParam مربوط به \fBALPN\fP (Application\-Layer Protocol Negotiation) را تشویق می‌کند، زیرا در اکثر موارد مورد نیاز است. این پارامتر پروتکل دسترسی به تحلیل‌کننده رمزگذاری‌شده را تعریف می‌کند. رایج‌ترین مقادیر عبارتند از \fBdot\fP، \fBdoq\fP و \fBh2\fP (به معنای HTTP/2.0 بر روی TLS، که در DoH استفاده می‌شود).
.sp
طبق بخش ۵ از RFC 9461 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc9461#\:name-new-svcparamkey-dohpath>: اگر SvcParam مربوط به \fBalpn\fP نشان‌دهنده پشتیبانی از HTTP باشد، \fBdohpath\fP حتماً باید وجود داشته باشد. الگوی URI باید حاوی یک متغیر \(dqdns\(dq باشد. به عنوان مثال، هنگام معرفی یک تحلیل‌کننده DoH در دسترس در \fBhttps://doh1.example.org/query{?dns}\fP، مقدار \fBdohpath\fP باید روی URI نسبی \fB/query{?dns}\fP\& تنظیم شود.
.sp
به کاربرانی که علاقه‌مند به پیکربندی این گزینه هستند توصیه می‌شود مطالب زیر را مطالعه کنند:
.INDENT 0.0
.IP \(bu 2
مجموعه بسیار خوبی از مثال‌ها در بخش ۷ از RFC 9461 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc9461#\:name-examples>\& در دسترس است.
.IP \(bu 2
فهرستی از تمام پارامترهای سرویس تعریف‌شده کنونی در ثبت IANA \%<https://\:www\:.iana\:.org/\:assignments/\:dns-svcb/\:dns-svcb\:.xhtml>\& نگهداری می‌شود. این سند رکوردهایی را که می‌توان در فیلد svcParams گزینه DNR ذخیره کرد، مشخص می‌کند.
.IP \(bu 2
فهرستی از پروتکل‌های مجاز کنونی در پارامتر ALPN در یکی دیگر از ثبت‌های IANA \%<https://\:www\:.iana\:.org/\:assignments/\:tls-extensiontype-values/\:tls-extensiontype-values\:.xhtml#\:alpn-protocol-ids>\& نگهداری می‌شود.
.IP \(bu 2
سند RFC 9463 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc9463> تعاریف گزینه‌ها را ارائه می‌دهد. از نظر SvcParams، بیان می‌کند که \fBalpn\fP و \fBport\fP باید پشتیبانی شوند، و پشتیبانی از \fBdohpath\fP (استفاده‌شده برای DoH) توصیه می‌شود.
.IP \(bu 2
بخش ۲.۲ از RFC 9460 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc9460> قالب on\-wire را برای SvcParams تعریف می‌کند.
.IP \(bu 2
بخش‌های ۷.۱ و ۷.۲ از RFC 9460 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc9460> قالب on\-wire را برای alpn و port تعریف می‌کنند.
.IP \(bu 2
بخش ۵ از RFC 9461 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc9461#\:name-new-svcparamkey-dohpath> قالب on\-wire را برای \fBdohpath\fP\& تعریف می‌کند.
.UNINDENT
.sp
در حال حاضر Kea از پارامترهای سرویس زیر پشتیبانی می‌کند:
.INDENT 0.0
.INDENT 3.5
.TS
box center;
l|l|l.
T{
نام
T}	T{
کد
T}	T{
توضیحات
T}
_
T{
alpn
T}	T{
1
T}	T{
انواع پروتکل‌های جداشده با کاما را مشخص می‌کند (DoT، DoH و غیره)
T}
_
T{
port
T}	T{
3
T}	T{
عدد صحیح ۱۶ بیتی بدون علامت. نشان‌دهنده یک پورت غیر استاندارد TCP یا UDP است.
T}
_
T{
dohpath
T}	T{
7
T}	T{
برای DoH اجباری است. شامل مسیر URL برای تحلیل‌کننده DoT است.
T}
.TE
.UNINDENT
.UNINDENT
.sp
سایر پارامترهای سرویس تعریف‌شده کنونی شامل mandatory (0)، no\-default\-alpn (2)، ipv4hint (4)، ech (5)، ipv6hint (6) و ohttp (8) در گزینه DNR قابل استفاده نیستند.
.sp
مثال‌های بیشتر را می‌توان در kea6/all\-options.json \%<#\:config-example-kea6-all-options-json>\& یافت. گزینه DHCPv4 تقریباً یکسان است و در DNR (Discovery of Network\-designated Resolvers) Options for DHCPv4 \%<#\:dnr4-options>\& شرح داده شده است..SS زیرگزینه‌های سرور NTP (NTP Server Suboptions)
.sp
گزینهٔ سرور NTP حاوی مجموعه‌ای از زیرگزینه‌ها است: ntp\-server\-address (۱)، ntp\-server\-multicast (۲)
که حامل یک آدرس IPv6 است، و ntp\-server\-fqdn (۳) که حامل یک FQDN در قالب سیمی (wire format) تعریف‌شده
در فضای گزینهٔ \(dqv6\-ntp\-server\-suboptions\(dq است. طبق الزامات RFC 5908 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc5908>\&،
هر نمونه از گزینه تنها و فقط یک زیرگزینه را حمل می‌کند.
.sp
بنابراین با فرض اینکه گزینهٔ دربرگیرندهٔ ntp\-server از پیش در یک بند option\-data
تنظیم شده باشد، برای ارسال آن همراه با زیرگزینهٔ ntp\-server\-address برای
سرور عمومی 2.pool.ntp.org، پیکربندی باید شامل موارد زیر باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqoption\-data\(dq: [
        {
            \(dqspace\(dq: \(dqv6\-ntp\-server\-suboptions\(dq,
            \(dqname\(dq: \(dqntp\-server\-address\(dq,
            \(dqdata\(dq: \(dq2a02:8424:6fc4:3601:c13b:9426:51db:aa1\(dq
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
برای FQDN که امکان انتخاب یکی از ۴ آدرس آن را فراهم می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqoption\-data\(dq: [
        {
            \(dqspace\(dq: \(dqv6\-ntp\-server\-suboptions\(dq,
            \(dqname\(dq: \(dqntp\-server\-fqdn\(dq,
            \(dqdata\(dq: \(dq2.pool.ntp.org\(dq
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
یا برای یک سایت بسته با سرور NTP اختصاصی که از چندپخشی (multicast) استفاده می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqoption\-data\(dq: [
        {
            \(dqspace\(dq: \(dqv6\-ntp\-server\-suboptions\(dq,
            \(dqname\(dq: \(dqntp\-server\-multicast\(dq,
            \(dqdata\(dq: \(dqff05::101\(dq
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
توجه داشته باشید که استاندارد ایجاب می‌کند تنها یک زیرگزینه در گزینهٔ ntp\-server
گنجانده شود.
.SS گزینه‌های سفارشی DHCPv6 (Custom DHCPv6 Options)
.sp
نرم‌افزار Kea از گزینه‌های سفارشی (غیراستاندارد) DHCPv6 پشتیبانی می‌کند.
فرض کنید می‌خواهیم یک گزینهٔ DHCPv6 جدید به نام \fBfoo\fP تعریف کنیم که
کد ۱۰۰ خواهد داشت و یک مقدار عدد صحیح ۳۲ بیتی بدون علامت منفرد را منتقل
می‌کند. چنین گزینه‌ای را می‌توان با قرار دادن ورودی زیر در فایل پیکربندی
تعریف کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqoption\-def\(dq: [
        {
            \(dqname\(dq: \(dqfoo\(dq,
            \(dqcode\(dq: 100,
            \(dqtype\(dq: \(dquint32\(dq,
            \(dqarray\(dq: false,
            \(dqrecord\-types\(dq: \(dq\(dq,
            \(dqspace\(dq: \(dqdhcp6\(dq,
            \(dqencapsulate\(dq: \(dq\(dq
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
مقدار \fBfalse\fP در پارامتر \fBarray\fP مشخص می‌کند که گزینه شامل آرایه‌ای از
مقادیر \fBuint32\fP نیست، بلکه در عوض یک مقدار منفرد است. دو پارامتر دیگر خالی
گذاشته شده‌اند: \fBrecord\-types\fP و \fBencapsulate\fP\&. اولی در صورتی که گزینه شامل
رکوردی از فیلدهای داده باشد، فهرستی از فیلدهای دادهٔ گزینه را که با کاما جدا شده‌اند
مشخص می‌کند. در صورتی که \fBtype\fP روی \fBrecord\fP تنظیم شده باشد، مقدار
\fBrecord\-types\fP باید غیرخالی باشد؛ در غیر این صورت باید خالی گذاشته شود. پارامتر دومی
نام فضای گزینه‌ای را مشخص می‌کند که توسط این گزینهٔ خاص کپسوله‌سازی می‌شود.
اگر این گزینهٔ خاص هیچ فضای گزینه‌ای را کپسوله‌سازی نکند، پارامتر باید خالی گذاشته
شود. توجه داشته باشید که عبارت پیکربندی \fBoption\-def\fP تنها قالب یک گزینه را تعریف
می‌کند و مقدار (یا مقادیر) آن را تعیین نمی‌نماید.
.sp
پارامترهای \fBname\fP، \fBcode\fP و \fBtype\fP الزامی هستند؛ سایر پارامترها
اختیاری‌اند. مقدار پیش‌فرض پارامتر \fBarray\fP برابر با \fBfalse\fP است. مقادیر پیش‌فرض
پارامترهای \fBrecord\-types\fP و \fBencapsulate\fP خالی (\fB\(dq\(dq\fP) هستند.
مقدار پیش‌فرض \fBspace\fP نیز \fBdhcp6\fP است.
.sp
پس از تعریف قالب گزینهٔ جدید، مقدار آن به همان روش گزینه‌های استاندارد تنظیم
می‌شود. به عنوان مثال، دستورات زیر یک مقدار سراسری تنظیم می‌کنند که بر
تمام زیرشبکه‌ها اعمال می‌شود.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqoption\-data\(dq: [
        {
            \(dqname\(dq: \(dqfoo\(dq,
            \(dqcode\(dq: 100,
            \(dqspace\(dq: \(dqdhcp6\(dq,
            \(dqcsv\-format\(dq: true,
            \(dqdata\(dq: \(dq12345\(dq
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
گزینه‌های جدید می‌توانند اشکال پیچیده‌تری نسبت به استفادهٔ ساده از انواع اولیه
(uint8، string، ipv6\-address و غیره) به خود بگیرند؛ امکان تعریف گزینه‌ای
متشکل از چندین نوع اولیهٔ موجود وجود دارد.
.sp
برای مثال، فرض کنید می‌خواهیم گزینهٔ جدیدی تعریف کنیم که از یک آدرس IPv6،
به دنبال آن یک عدد صحیح ۱۶ بیتی بدون علامت، به دنبال آن یک مقدار بولی (boolean)،
و سپس یک رشتهٔ متنی تشکیل شده باشد. چنین گزینه‌ای را می‌توان به شیوهٔ زیر تعریف کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqoption\-def\(dq: [
        {
            \(dqname\(dq: \(dqbar\(dq,
            \(dqcode\(dq: 101,
            \(dqspace\(dq: \(dqdhcp6\(dq,
            \(dqtype\(dq: \(dqrecord\(dq,
            \(dqarray\(dq: false,
            \(dqrecord\-types\(dq: \(dqipv6\-address, uint16, boolean, string\(dq,
            \(dqencapsulate\(dq: \(dq\(dq
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
پارامتر \fBtype\fP روی \fB\(dqrecord\(dq\fP تنظیم می‌شود تا نشان دهد گزینه شامل مقادیر
متعددی از انواع مختلف است. این نوع‌ها به صورت فهرستی جداشده با کاما در فیلد
\fBrecord\-types\fP مشخص می‌شوند و باید از میان موارد ذکرشده در فهرست انواع گزینه‌های استاندارد DHCP \%<#\:dhcp-types>\&
باشند.
.sp
مقادیر گزینه‌ها در یک عبارت \fBoption\-data\fP به صورت زیر تنظیم می‌شوند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqoption\-data\(dq: [
        {
            \(dqname\(dq: \(dqbar\(dq,
            \(dqspace\(dq: \(dqdhcp6\(dq,
            \(dqcode\(dq: 101,
            \(dqcsv\-format\(dq: true,
            \(dqdata\(dq: \(dq2001:db8:1::10, 123, false, Hello World\(dq
        }
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
پارامتر \fBcsv\-format\fP روی \fBtrue\fP تنظیم شده است تا نشان دهد فیلد \fBdata\fP
شامل فهرستی از مقادیر جداشده با کاما است. مقادیر موجود در \fBdata\fP باید با
انواع تنظیم‌شده در فیلد \fBrecord\-types\fP در تعریف گزینه مطابقت داشته باشند.
.sp
هنگامی که \fBarray\fP روی \fBtrue\fP و \fBtype\fP روی \fB\(dqrecord\(dq\fP تنظیم شود،
آخرین فیلد یک آرایه خواهد بود، یعنی می‌تواند بیش از یک مقدار داشته باشد، مانند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqoption\-def\(dq: [
        {
            \(dqname\(dq: \(dqbar\(dq,
            \(dqcode\(dq: 101,
            \(dqspace\(dq: \(dqdhcp6\(dq,
            \(dqtype\(dq: \(dqrecord\(dq,
            \(dqarray\(dq: true,
            \(dqrecord\-types\(dq: \(dqipv6\-address, uint16\(dq,
            \(dqencapsulate\(dq: \(dq\(dq
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
محتوای گزینهٔ جدید یک آدرس IPv6 است که در ادامهٔ آن یک یا چند عدد صحیح ۱۶ بیتی
بدون علامت قرار دارد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
به‌طور کلی، مقادیر بولی بدون نقل‌قول و به صورت \fBtrue\fP یا \fBfalse\fP مشخص
می‌شوند. برخی پارامترهای بولی خاص ممکن است مقادیر \fB\(dqtrue\(dq\fP، \fB\(dqfalse\(dq\fP،
\fB0\fP، \fB1\fP، \fB\(dq0\(dq\fP و \fB\(dq1\(dq\fP را نیز بپذیرند.
.UNINDENT
.UNINDENT.SS گزینه‌های مختص سازنده در DHCPv6 (DHCPv6 Vendor\-Specific Options)
.sp
گزینه‌های سازنده در DHCPv6 از طریق گزینهٔ اطلاعات مختص سازنده (Vendor\-Specific Information option با کد ۱۷) منتقل می‌شوند. ایدهٔ پشت گزینهٔ ۱۷ این است که هر سازنده مجموعهٔ یکتای خود از گزینه‌ها را با قالب‌های سفارشی ویژهٔ خود دارد. سازنده با یک عدد صحیح بدون علامت ۳۲ بیتی با نام \fBenterprise\-number\fP یا \fBvendor\-id\fP مشخص می‌شود\&.
.sp
فضاهای استانداردی که در Kea تعریف شده‌اند و گزینه‌های آن‌ها عبارت‌اند از:
.INDENT 0.0
.IP \(bu 2
\fBvendor\-2495\fP: مربوط به Internet Systems Consortium, Inc. برای گزینه‌های 4o6:
.UNINDENT
.TS
box center;
l|l|l.
T{
کد گزینه
T}	T{
نام گزینه
T}	T{
شرح گزینه
T}
_
T{
60000
T}	T{
4o6\-interface
T}	T{
نام رابط سرور 4o6 که رو به سمت کلاینت است
T}
_
T{
60001
T}	T{
4o6\-source\-address
T}	T{
آدرسی که سرور 4o6 برای ارسال بسته‌ها به کلاینت استفاده می‌کند
T}
_
T{
60002
T}	T{
4o6\-source\-port
T}	T{
پورتی که سرور 4o6 برای ارسال بسته‌ها به کلاینت باز می‌کند
T}
.TE
.INDENT 0.0
.IP \(bu 2
\fBvendor\-4491\fP: مربوط به Cable Television Laboratories, Inc. برای گزینه‌های DOCSIS3:
.UNINDENT
.TS
box center;
l|l|l.
T{
کد گزینه
T}	T{
نام گزینه
T}	T{
شرح گزینه
T}
_
T{
1
T}	T{
oro
T}	T{
گزینهٔ ORO (یا Option Request Option) توسط کلاینت‌ها برای درخواست فهرستی از گزینه‌های مورد نظر آن‌ها استفاده می‌شود.
T}
_
T{
2
T}	T{
tftp\-servers
T}	T{
فهرستی از آدرس‌های IPv4 سرورهای TFTP که توسط مودم کابلی استفاده می‌شوند
T}
.TE
.sp
مثال‌های زیر نشان می‌دهند چگونه گزینهٔ \fB\(dqfoo\(dq\fP با کد ۱ تعریف شود که شامل یک آدرس IPv6، یک عدد صحیح ۱۶ بیتی بدون علامت، و یک رشته است. گزینهٔ \fB\(dqfoo\(dq\fP در یک گزینهٔ اطلاعات مختص سازنده (Vendor\-Specific Information) منتقل می‌شود که شامل یک مقدار uint32 واحد است که روی \fB12345\fP تنظیم شده است\&. زیرگزینهٔ \fB\(dqfoo\(dq\fP پس از فیلد داده‌ای که این مقدار را در خود نگه می‌دارد قرار می‌گیرد.
.sp
گام نخست، تعریف قالب گزینه است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqoption\-def\(dq: [
        {
            \(dqname\(dq: \(dqfoo\(dq,
            \(dqcode\(dq: 1,
            \(dqspace\(dq: \(dqvendor\-12345\(dq,
            \(dqtype\(dq: \(dqrecord\(dq,
            \(dqarray\(dq: false,
            \(dqrecord\-types\(dq: \(dqipv6\-address, uint16, string\(dq,
            \(dqencapsulate\(dq: \(dq\(dq
        }
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
توجه داشته باشید که فضای گزینه روی \fB\(dqvendor\-12345\(dq\fP تنظیم شده است\&.
پس از تعریف قالب گزینه، گام بعدی تعیین مقادیر واقعی برای آن گزینه است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqoption\-data\(dq: [
        {
            \(dqname\(dq: \(dqfoo\(dq,
            \(dqspace\(dq: \(dqvendor\-12345\(dq,
            \(dqdata\(dq: \(dq2001:db8:1::10, 123, Hello World\(dq
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
همچنین باید مقداری (\fB\(dqenterprise\-number\(dq\fP) برای گزینهٔ اطلاعات مختص سازنده تعریف کنیم تا گزینهٔ \fBfoo\fP را منتقل کند\&.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqoption\-data\(dq: [
        {
            \(dqname\(dq: \(dqvendor\-opts\(dq,
            \(dqdata\(dq: \(dq12345\(dq
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
از طرف دیگر، می‌توان گزینه را با استفاده از کد آن مشخص کرد.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqoption\-data\(dq: [
        {
            \(dqcode\(dq: 17,
            \(dqdata\(dq: \(dq12345\(dq
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
یک پیکربندی رایج این است که پرچم \fBalways\-send\fP روی \fBtrue\fP تنظیم شود، تا گزینهٔ سازنده حتی در صورتی که کلاینت آن را در پرس‌وجوی خود مشخص نکرده باشد نیز ارسال گردد.
.sp
همچنین به همین ترتیب می‌توان \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> را برای ارسال چندین گزینهٔ سازنده از سازندگان مختلف، به همراه شماره سازمانی اختصاصی هر یک از آن‌ها، پیکربندی نمود.
برای ارسال این گزینه‌ها صرف‌نظر از اینکه کلاینت یک شماره سازمانی مشخص کرده باشد یا خیر، سرور باید با \fB\(dqalways\-send\(dq: true\fP پیکربندی شود، از جمله گزینهٔ اطلاعات مختص سازنده (کد ۱۷).
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp6\(dq: {
    \(dqoption\-data\(dq: [
      {
        \(dqalways\-send\(dq: true,
        \(dqdata\(dq: \(dqtagged\(dq,
        \(dqname\(dq: \(dqtag\(dq,
        \(dqspace\(dq: \(dqvendor\-2234\(dq
      },
      {
        \(dqalways\-send\(dq: true,
        \(dqdata\(dq: \(dqhttps://example.com:1234/path\(dq,
        \(dqname\(dq: \(dqurl\(dq,
        \(dqspace\(dq: \(dqvendor\-3561\(dq
      }
    ],
    \(dqoption\-def\(dq: [
      {
        \(dqcode\(dq: 22,
        \(dqname\(dq: \(dqtag\(dq,
        \(dqspace\(dq: \(dqvendor\-2234\(dq,
        \(dqtype\(dq: \(dqstring\(dq
      },
      {
        \(dqcode\(dq: 11,
        \(dqname\(dq: \(dqurl\(dq,
        \(dqspace\(dq: \(dqvendor\-3561\(dq,
        \(dqtype\(dq: \(dqstring\(dq
      }
    ]
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
سرور \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> قادر است چندین گزینهٔ Vendor Class (کد ۱۶) با شماره‌های سازمانی مختلف را در درخواست‌های کلاینت شناسایی کند و چندین گزینهٔ اطلاعات مختص سازنده (کد ۱۷) را در پاسخ‌ها، به ازای هر سازنده یکی، ارسال نماید.
.UNINDENT
.UNINDENT.SS گزینه‌های تودرتوی DHCPv6 (فضاهای گزینهٔ سفارشی)
.sp
گاهی اوقات تعریف یک فضای گزینهٔ (option space) کاملاً جدید سودمند است: برای نمونه،
کاربر ممکن است گزینهٔ جدیدی برای انتقال زیرگزینه‌هایی ایجاد کند که
از یک طرح شماره‌گذاری جداگانه استفاده می‌کنند، مانند زیرگزینه‌هایی با کدهای ۱
و ۲. این کدهای گزینه با گزینه‌های استاندارد DHCPv6 تداخل دارند، بنابراین
باید یک فضای گزینهٔ جداگانه تعریف شود.
.sp
توجه داشته باشید که هنگام تعریف زیرگزینه‌ها برای یک گزینهٔ استاندارد، ایجاد یک
فضای گزینهٔ جدید لازم نیست؛ زیرا اگر قرار باشد یک گزینهٔ استاندارد زیرگزینه‌هایی را
منتقل کند، به‌طور پیش‌فرض یکی ایجاد می‌شود (به بخش
DHCPv6 Vendor\-Specific Options مراجعه کنید).
.sp
اگر بخواهیم یک گزینهٔ DHCPv6 به نام \fBcontainer\fP با کد 102 داشته باشیم
که دو زیرگزینه با کدهای 1 و 2 را منتقل می‌کند، ابتدا باید
زیرگزینه‌های جدید را تعریف کنیم:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqoption\-def\(dq: [
        {
            \(dqname\(dq: \(dqsubopt1\(dq,
            \(dqcode\(dq: 1,
            \(dqspace\(dq: \(dqisc\(dq,
            \(dqtype\(dq: \(dqipv6\-address\(dq,
            \(dqrecord\-types\(dq: \(dq\(dq,
            \(dqarray\(dq: false,
            \(dqencapsulate\(dq: \(dq\(dq
        },
        {
            \(dqname\(dq: \(dqsubopt2\(dq,
            \(dqcode\(dq: 2,
            \(dqspace\(dq: \(dqisc\(dq,
            \(dqtype\(dq: \(dqstring\(dq,
            \(dqrecord\-types\(dq: \(dq\(dq,
            \(dqarray\(dq: false,
            \(dqencapsulate\(dq: \(dq\(dq
        }
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
توجه داشته باشید که ما گزینه‌ها را طوری تعریف کرده‌ایم که به یک فضای گزینهٔ جدید
(در این حالت، \fB\(dqisc\(dq\fP) تعلق داشته باشند.
.sp
گام بعدی تعریف یک گزینهٔ معمولی DHCPv6 با کد مورد نظر و مشخص کردن این است
که باید گزینه‌های متعلق به فضای گزینهٔ جدید را شامل شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqoption\-def\(dq: [
        {
            \(dqname\(dq: \(dqcontainer\(dq,
            \(dqcode\(dq: 102,
            \(dqspace\(dq: \(dqdhcp6\(dq,
            \(dqtype\(dq: \(dqempty\(dq,
            \(dqarray\(dq: false,
            \(dqrecord\-types\(dq: \(dq\(dq,
            \(dqencapsulate\(dq: \(dqisc\(dq
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
نام فضای گزینه‌ای که زیرگزینه‌ها در آن تعریف شده‌اند در فیلد \fBencapsulate\fP
تنظیم می‌شود. فیلد \fBtype\fP روی \fB\(dqempty\(dq\fP تنظیم شده است تا
نشان دهد این گزینه داده‌ای غیر از زیرگزینه‌ها حمل نمی‌کند.
.sp
در نهایت، می‌توانیم مقادیر گزینه‌های جدید را مقداردهی کنیم:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp6\(dq: {
    \(dqoption\-data\(dq: [
        {
            \(dqname\(dq: \(dqsubopt1\(dq,
            \(dqcode\(dq: 1,
            \(dqspace\(dq: \(dqisc\(dq,
            \(dqdata\(dq: \(dq2001:db8::abcd\(dq
        },
        {
            \(dqname\(dq: \(dqsubopt2\(dq,
            \(dqcode\(dq: 2,
            \(dqspace\(dq: \(dqisc\(dq,
            \(dqdata\(dq: \(dqHello world\(dq
        },
        {
            \(dqname\(dq: \(dqcontainer\(dq,
            \(dqcode\(dq: 102,
            \(dqspace\(dq: \(dqdhcp6\(dq
        }
    ]
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
ایجاد گزینه‌ای که علاوه بر زیرگزینه‌های تعریف‌شده در فضای گزینهٔ کپسوله‌شده
داده‌هایی را نیز حمل کند ممکن است. برای نمونه، اگر گزینهٔ \fBcontainer\fP
از مثال قبلی ملزم به حمل یک مقدار uint16 در کنار زیرگزینه‌ها باشد،
مقدار \fBtype\fP در تعریف گزینه باید روی \fB\(dquint16\(dq\fP تنظیم شود.
(چنین گزینه‌ای در این صورت دارای این ساختار داده خواهد بود: هدر DHCP، مقدار uint16،
زیرگزینه‌ها.) سپس مقداری که با پارامتر \fBdata\fP مشخص شده است — که باید یک
عدد صحیح معتبر درون گیومه باشد، مانند \fB\(dq123\(dq\fP — به فیلد \fBuint16\fP
در گزینهٔ \fBcontainer\fP اختصاص می‌یابد..SS پارامترهای مشخص‌نشده برای پیکربندی گزینه‌های DHCPv6
.sp
در بسیاری از موارد نیازی به مشخص کردن تمام پارامترها برای پیکربندی یک گزینه نیست و می‌توان از مقادیر پیش‌فرض استفاده کرد. با این حال، درک پیامدهای مشخص نکردن برخی از آن‌ها مهم است، زیرا ممکن است منجر به خطاهای پیکربندی شود. فهرست زیر رفتار کارگزار را هنگام مشخص نشدن صریح یک پارامتر خاص توضیح می‌دهد:
.INDENT 0.0
.IP \(bu 2
\fBname\fP \- کارگزار برای شناسایی یک گزینه، یا به نام گزینه و یا به کد گزینه نیاز دارد. اگر این پارامتر مشخص نشده باشد، کد گزینه باید مشخص شود.
.IP \(bu 2
\fBcode\fP \- کارگزار برای شناسایی یک گزینه، یا به نام گزینه و یا به کد گزینه نیاز دارد؛ اگر پارامتر \fBname\fP مشخص شده باشد، این پارامتر می‌تواند مشخص‌نشده رها شود. با این حال، این امر همچنین مستلزم آن است که گزینه مورد نظر دارای تعریف باشد (خواه به عنوان یک گزینه استاندارد یا تعریفی ایجادشده توسط مدیر با استفاده از ساختار \fBoption\-def\fP)، چرا که تعریف گزینه، آن را با نامی خاص مرتبط می‌سازد. پیکربندی گزینه‌ای که تعریفی برای آن وجود ندارد (قالب گزینه نامشخص) امکان‌پذیر است. پیکربندی چنین گزینه‌هایی مستلزم استفاده از کد گزینه است.
.IP \(bu 2
\fBspace\fP \- اگر فضای گزینه مشخص نشده باشد، به طور پیش‌فرض \fBdhcp6\fP خواهد بود که فضای گزینه‌ای شامل گزینه‌های استاندارد DHCPv6 است.
.IP \(bu 2
\fBdata\fP \- اگر داده‌های گزینه مشخص نشده باشد، به طور پیش‌فرض یک مقدار خالی خواهد بود. مقدار خالی بیشتر برای گزینه‌هایی استفاده می‌شود که بار داده (payload) ندارند (گزینه‌های بولی)، اما مشخص کردن مقادیر خالی برای برخی گزینه‌ها که حامل داده‌های با طول متغیر هستند و مشخصات پروتکل طول 0 را برای آن‌ها مجاز می‌داند نیز معتبر است. برای چنین گزینه‌هایی، می‌توان از پارامتر data در پیکربندی صرف‌نظر کرد.
.IP \(bu 2
\fBcsv\-format\fP \- اگر این مقدار مشخص نشده باشد، کارگزار فرض می‌کند که داده‌های گزینه به صورت فهرستی از مقادیر جداشده با کاما مشخص شده‌اند تا به فیلدهای جداگانه گزینه DHCP اختصاص یابند.
.UNINDENT
.SS کنترل مقادیر ارسالی برای زمان‌های T1 و T2
.sp
مطابق با RFC 9915، بخش 21.4، مقادیر توصیه‌شده T1 و T2 به ترتیب ۵۰٪ و ۸۰٪ زمان اجاره ترجیحی (preferred lease time) هستند. Kea را می‌توان به گونه‌ای پیکربندی کرد که مقادیر مشخص‌شده به صورت صریح، یا مقادیر محاسبه‌شده به عنوان درصدی از زمان اجاره ترجیحی را ارسال کند. رفتار کارگزار با ترکیبی از پارامترهای پیکربندی تعیین می‌شود که T1 و T2 تنها دو مورد از آن‌ها هستند.
.sp
طول‌عمرهای ترجیحی و معتبر اجاره به صورت سه‌تایی‌هایی با مقادیر حداقل، پیش‌فرض و حداکثر با استفاده از ورودی‌های پیکربندی بیان می‌شوند:
.INDENT 0.0
.IP \(bu 2
\fBmin\-preferred\-lifetime\fP \- حداقل طول‌عمر ترجیحی را مشخص می‌کند (اختیاری).
.IP \(bu 2
\fBpreferred\-lifetime\fP \- طول‌عمر ترجیحی پیش‌فرض را مشخص می‌کند.
.IP \(bu 2
\fBmax\-preferred\-lifetime\fP \- حداکثر طول‌عمر ترجیحی را مشخص می‌کند (اختیاری).
.IP \(bu 2
\fBmin\-valid\-lifetime\fP \- حداقل طول‌عمر معتبر را مشخص می‌کند (اختیاری).
.IP \(bu 2
\fBvalid\-lifetime\fP \- طول‌عمر معتبر پیش‌فرض را مشخص می‌کند.
.IP \(bu 2
\fBmax\-valid\-lifetime\fP \- حداکثر طول‌عمر معتبر را مشخص می‌کند (اختیاری).
.UNINDENT
.sp
این مقادیر را می‌توان در کلاس‌های کلاینت (client classes) مشخص کرد.
.sp
هنگامی که کلاینت طول‌عمرها را مشخص نمی‌کند، از مقدار پیش‌فرض استفاده می‌شود. طول‌عمر مشخص‌شده \- با استفاده از زیرگزینه IAADDR یا IAPREFIX با مقادیر غیرصفر \- در صورتی از این مقادیر استفاده می‌کند که بین کران‌های حداقل و حداکثر پیکربندی‌شده قرار داشته باشند. مقادیر خارج از این کران‌ها بر حسب نیاز به سمت بالا یا پایین گرد می‌شوند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
اگر \fBpreferred\-lifetime\fP به صورت صریح مشخص نشده باشد، یا اگر مقدار مشخص‌شده بزرگ‌تر از مقدار \fBvalid\-lifetime\fP باشد، کارگزار از مقدار \fBvalid\-lifetime\fP ضرب در 0.625 استفاده می‌کند.
.UNINDENT
.UNINDENT
.sp
برای ارسال مقادیر ثابت مشخص، از دو پارامتر زیر استفاده کنید:
.INDENT 0.0
.IP \(bu 2
\fBrenew\-timer\fP \- مقدار T1 را به ثانیه مشخص می‌کند.
.IP \(bu 2
\fBrebind\-timer\fP \- مقدار T2 را به ثانیه مشخص می‌کند.
.UNINDENT
.sp
هر مقداری بزرگ‌تر یا مساوی صفر را می‌توان برای T2 مشخص کرد. T1، در صورت مشخص شدن، باید کمتر از T2 باشد. این انعطاف‌پذیری سناریویی را ممکن می‌سازد که مدیران بخواهند تمدیدها (renewals) و اتصال‌های مجدد (rebinds) کلاینت را با به تعویق انداختن آن‌ها فراتر از طول‌عمر اجاره، سرکوب کنند. این امر باعث منقضی شدن اجاره می‌شود، به جای آنکه توسط کلاینت‌ها تمدید گردد. اگر T1 بزرگ‌تر از T2 مشخص شود، T1 در IA خروجی بدون هشدار روی صفر تنظیم می‌شود.
.sp
در اکثریت قریب به اتفاق موارد، مقادیر باید از این قاعده پیروی کنند: T1 < T2 < طول‌عمر ترجیحی < طول‌عمر معتبر. از طرف دیگر، هر دو مقدار T1 و T2 را می‌توان روی 0 پیکربندی کرد، که علامتی به کلاینت‌های DHCPv6 است مبنی بر اینکه می‌توانند بر اساس صلاحدید خود اقدام به تمدید کنند. با این حال، پیاده‌سازی‌های معیوب شناخته‌شده‌ای از کلاینت‌ها در حال استفاده هستند که بلافاصله تمدید را آغاز می‌کنند. مدیرانی که قصد استفاده از مقادیر T1=T2=0 را دارند باید ابتدا آزمایش کرده و مطمئن شوند که کلاینت‌هایشان رفتار معقولی دارند.
.sp
در برخی موارد نادر ممکن است نیاز به غیرفعال کردن توانایی کلاینت در تمدید نشانی‌ها وجود داشته باشد. این امر از دیدگاه پروتکل نامطلوب است و در صورت امکان باید از آن اجتناب شود. با این حال، در صورت لزوم، مدیران می‌توانند مقادیر T1 و T2 را برابر یا بزرگ‌تر از طول‌عمر معتبر پیکربندی کنند. توجه داشته باشید که این کار باعث می‌شود کلاینت‌ها گهگاه نشانی‌های خود را از دست بدهند، که عموماً به عنوان سرویس‌دهی ضعیف تلقی می‌شود. با این حال، ممکن است موارد تجاری نادری وجود داشته باشد که این رفتار مطلوب باشد (مانند زمانی که قطع عمدی اتصالات طولانی‌مدت مد نظر است).
.sp
محاسبه مقادیر توسط سه پارامتر زیر کنترل می‌شود:
.INDENT 0.0
.IP \(bu 2
\fBcalculate\-tee\-times\fP \- هنگامی که \fBtrue\fP باشد، T1 و T2 به صورت درصدهایی از زمان اجاره معتبر محاسبه می‌شوند. مقدار پیش‌فرض آن \fBtrue\fP است.
.IP \(bu 2
\fBt1\-percent\fP \- درصدی از زمان اجاره معتبر که برای T1 استفاده می‌شود. این مقدار به صورت یک عدد حقیقی بین 0.0 و 1.0 بیان می‌شود و باید کمتر از \fBt2\-percent\fP باشد. مقدار پیش‌فرض طبق RFC 9915 برابر با 0.5 است.
.IP \(bu 2
\fBt2\-percent\fP \- درصدی از زمان اجاره معتبر که برای T2 استفاده می‌شود. این مقدار به صورت یک عدد حقیقی بین 0.0 و 1.0 بیان می‌شود و باید بزرگ‌تر از \fBt1\-percent\fP باشد. مقدار پیش‌فرض طبق RFC 9915 برابر با 0.8 است.
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
برخلاف DHCPv4، زمان‌های تی (T1، T2) همیشه در گزینه‌های نشانی و پیشوند DHCPv6 وجود دارند. بنابراین مقدار پیش‌فرض \fBcalculate\-tee\-times\fP برای \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> برابر با \fBtrue\fP است. این امر تضمین می‌کند که رفتار پیش‌فرض کارگزار منجر به ارسال زمان‌های تی غیرصفر به کلاینت‌ها شود. این کار به منظور جلوگیری از اشباع شدن کارگزار توسط کلاینت‌های بدرفتاری است که این زمان‌ها را برای خود محاسبه نمی‌کنند.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
اگر هم مقادیر صریح مشخص شده باشند و هم \fBcalculate\-tee\-times\fP برابر با \fBtrue\fP باشد، کارگزار از مقادیر صریح استفاده خواهد کرد. مدیرانی با پیکربندی‌ای که در آن برخی زیرشبکه‌ها یا shared\-networkها از مقادیر صریح و برخی از مقادیر محاسباتی استفاده می‌کنند، نباید مقادیر صریح را در سطحی بالاتر از جایی که به کار می‌روند تعریف کنند. به ارث بردن آن‌ها از حوزه‌ای بسیار بالا، مانند دامنه سراسری (global)، باعث می‌شود که آن‌ها در تمام سطوح زیرین (هم shared\-networkها و هم زیرشبکه‌ها) دارای مقدار باشند و عملاً مقادیر محاسباتی را غیرفعال کنند.
.UNINDENT
.UNINDENT.SS انتخاب زیرشبکه IPv6 (IPv6 Subnet Selection)
.sp
کارساز DHCPv6 ممکن است درخواست‌هایی را از کلاینت‌های محلی (متصل به همان
زیرشبکه کارساز) و دوردست (متصل از طریق رله‌ها یا relays) دریافت کند. از
آنجا که ممکن است پیکربندی‌های متعددی برای زیرشبکه‌ها در کارساز تعریف
شده باشد، باید زیرشبکه مناسب را برای درخواست داده‌شده انتخاب کند.
.sp
در IPv4، کارساز می‌تواند تشخیص دهد که کدام‌یک از زیرشبکه‌های پیکربندی‌شده
محلی هستند، زیرا این انتظار منطقی وجود دارد که کارساز دارای یک نشانی IPv4
(سراسری یا global) پیکربندی‌شده روی رابط شبکه (interface) باشد. این فرض
در IPv6 صادق نیست؛ کارساز DHCPv6 باید بتواند حتی در صورت استفاده صرف از
نشانی‌های link\-local نیز کار کند. بنابراین، پارامتر اختیاری \fBinterface\fP درون
تعریف زیرشبکه در دسترس است تا مشخص کند زیرشبکه مورد نظر محلی است، یعنی
مستقیماً از طریق رابط مشخص‌شده در دسترس قرار دارد. برای نمونه، کارسازی که
قرار است به یک زیرشبکه محلی روی eth0 سرویس دهد، می‌تواند به صورت زیر
پیکربندی شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqsubnet6\(dq: [
        {
            \(dqid\(dq: 1,
            \(dqsubnet\(dq: \(dq2001:db8:beef::/48\(dq,
            \(dqpools\(dq: [
                 {
                     \(dqpool\(dq: \(dq2001:db8:beef::/48\(dq
                 }
             ],
            \(dqinterface\(dq: \(dqeth0\(dq
        }
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.SS اختصاص سریع (Rapid Commit)
.sp
گزینه Rapid Commit، که در RFC
9915 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc9915> شرح داده شده است، توسط کارساز Kea
DHCPv6 پشتیبانی می‌شود. با این حال، این پشتیبانی به‌طور پیش‌فرض غیرفعال است.
می‌توان آن را به ازای هر زیرشبکه با استفاده از پارامتر \fBrapid\-commit\fP فعال کرد،
همان‌طور که در زیر نشان داده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp6\(dq: {
    \(dqsubnet6\(dq: [
        {
            \(dqid\(dq: 1,
            \(dqsubnet\(dq: \(dq2001:db8:beef::/48\(dq,
            \(dqrapid\-commit\(dq: true,
            \(dqpools\(dq: [
                 {
                     \(dqpool\(dq: \(dq2001:db8:beef::1\-2001:db8:beef::10\(dq
                 }
             ]
        }
    ]
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
این تنظیم تنها بر زیرشبکه‌ای تأثیر می‌گذارد که مقدار \fBrapid\-commit\fP برای آن
روی \fBtrue\fP تنظیم شده باشد\&. برای کلاینت‌های متصل به زیرشبکه‌های دیگر،
کارساز گزینه Rapid Commit ارسال‌شده توسط کلاینت را نادیده می‌گیرد و فرایند
مبادله ۴\-مرحله‌ای (4\-way exchange) را دنبال می‌کند؛ یعنی در پاسخ به یک
پیام Solicit که حاوی گزینه Rapid Commit است، پیام Advertise ارسال می‌کند.
.SS رله‌های DHCPv6 (DHCPv6 Relays)
.sp
یک کارساز DHCPv6 با چندین زیرشبکه تعریف‌شده، باید هنگام دریافت درخواست از
سوی کلاینت، زیرشبکه مناسب را انتخاب کند. برای کلاینت‌هایی که از طریق رله‌ها
متصل هستند، از دو سازوکار استفاده می‌شود:
.sp
سازوکار نخست از فیلد \fBlinkaddr\fP در پیام \fBRELAY_FORW\fP استفاده می‌کند. نام
این فیلد تا حدی گمراه‌کننده است، چرا که حاوی یک نشانی لایه پیوند (link\-layer)
نیست؛ بلکه نشانی‌ای (معمولاً یک نشانی سراسری یا global) را نگهداری می‌کند که
برای شناسایی یک پیوند به‌کار می‌رود. کارساز DHCPv6 بررسی می‌کند که آیا این نشانی
به یک زیرشبکه تعریف‌شده تعلق دارد یا خیر، و در صورت تعلق داشتن، آن زیرشبکه
برای درخواست کلاینت انتخاب می‌شود.
.sp
سازوکار دوم مبتنی بر گزینه‌های \fBinterface\-id\fP است. رله‌ها هنگام بازفرستادن
(forwarding) پیام کلاینت، ممکن است گزینه \fBinterface\-id\fP را در پیام درج کنند که
رابطی از رله را که پیام را دریافت کرده است مشخص می‌کند. (برخی رله‌ها امکان پیکربندی
این پارامتر را فراهم می‌کنند، اما این مقدار گاهی به‌صورت ثابت کدنویسی شده است
(hard\-coded) و ممکن است از بسیار ساده [مانند \(dqvlan100\(dq] تا بسیار مبهم و پیچیده
متغیر باشد؛ یک نمونه واقعی دیده شده روی سخت‌افزار \(dqISAM144|299|ipv6|nt:vp:1:110\(dq بود.)
کارساز می‌تواند از این اطلاعات برای انتخاب زیرشبکه مناسب استفاده کند. این اطلاعات
همچنین به رله بازگردانده می‌شود، تا رله بداند از کدام رابط برای ارسال پاسخ به کلاینت
استفاده کند. برای اینکه این فرایند با موفقیت کار کند، شناسه‌های رابط رله باید درون شبکه
یکتا باشند و پیکربندی کارساز نیز با آن مقادیر مطابقت داشته باشد.
.sp
هنگام پیکربندی کارساز DHCPv6، دو پارامتر با نام‌های مشابه را می‌توان برای یک زیرشبکه
پیکربندی کرد:
.INDENT 0.0
.IP \(bu 2
\fBinterface\fP \- تعیین می‌کند که کدام رابط شبکه محلی می‌تواند برای دسترسی به یک زیرشبکه
داده‌شده استفاده شود.
.IP \(bu 2
\fBinterface\-id\fP \- محتوای گزینه \fBinterface\-id\fP را تعیین می‌کند که توسط رله‌ها برای
شناسایی رابطی روی رله که بسته پاسخ به آن ارسال می‌شود، استفاده می‌گردد.
.UNINDENT
.sp
این دو گزینه مانعة‌الجمع هستند؛ یک زیرشبکه نمی‌تواند هم به‌صورت محلی (ترافیک مستقیم)
و هم از طریق رله‌ها (ترافیک راه‌دور) در دسترس باشد. تعیین هم‌زمان هر دو یک خطای
پیکربندی محسوب می‌شود و کارساز DHCPv6 چنین پیکربندی‌ای را نخواهد پذیرفت.
.sp
پیکربندی نمونه زیر نشان می‌دهد که چگونه می‌توان یک \fBinterface\-id\fP با مقدار
\(dqvlan123\(dq تعیین کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqsubnet6\(dq: [
        {
            \(dqid\(dq: 1,
            \(dqsubnet\(dq: \(dq2001:db8:beef::/48\(dq,
            \(dqpools\(dq: [
                 {
                     \(dqpool\(dq: \(dq2001:db8:beef::/48\(dq
                 }
             ],
            \(dqinterface\-id\(dq: \(dqvlan123\(dq
        }
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT.SS گزینه‌های ارائه‌شده توسط بازپخش (Relay\-Supplied Options)
.sp
سند RFC 6422 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc6422> سازوکاری به نام Relay\-Supplied DHCP Options را تعریف می‌کند. در موارد خاصی، کارگزاران بازپخش (relay agents) تنها موجودیت‌هایی هستند که ممکن است اطلاعات مشخصی را در اختیار داشته باشند، و می‌توانند هنگام بازپخش پیام‌ها از کلاینت به کارساز، گزینه‌ها را درج کنند. سپس کارساز بررسی‌های خاصی را انجام داده و آن گزینه‌ها را در پاسخی که برای کلاینت فرستاده می‌شود رونوشت می‌کند.
.sp
برای گنجانده شدن گزینه، شرایط خاصی وجود دارد که باید برآورده شوند. نخست، کارساز نباید خودش آن گزینه را ارائه دهد؛ به بیان دیگر، اگر هم بازپخش و هم کارساز گزینه‌ای را ارائه دهند، کارساز همواره اولویت دارد. دوم، گزینه باید دارای قابلیت RSOO باشد. (مخفف \(dqRelay Supplied Options option\(dq). نهاد IANA فهرستی از گزینه‌های فعال‌شده برای RSOO را در اینجا نگهداری می‌کند: \%<https://\:www\:.iana\:.org/\:assignments/\:dhcpv6-parameters/\:dhcpv6-parameters\:.xhtml#\:options-relay-supplied>\&. با این حال، ممکن است مواردی وجود داشته باشد که مدیران سیستم بخواهند گزینه‌های دیگری را بازتاب (echo) دهند. می‌توان Kea را طوری تنظیم کرد که با گزینه‌های دیگر نیز به‌صورت RSOO\-enabled رفتار کند؛ برای مثال، برای علامت‌گذاری گزینه‌های 110، 120 و 130 به‌عنوان RSOO\-enabled، باید از ساختار زیر استفاده شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqrelay\-supplied\-options\(dq: [ \(dq110\(dq, \(dq120\(dq, \(dq130\(dq ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
در حال حاضر، تنها گزینه 65 توسط IANA به‌صورت RSOO\-enabled درآمده است. این گزینه همیشه به‌صورت RSOO\-enabled در نظر گرفته می‌شود، بنابراین نیازی به علامت‌گذاری صریح آن نیست. هنگام فعال‌سازی گزینه‌های استاندارد، می‌توان به جای کد گزینه از نام آن‌ها نیز استفاده کرد؛ برای نمونه، استفاده از \fBdns\-servers\fP به جای \fB23\fP\&. برای مشاهده نام‌ها به ref:\fIdhcp6\-std\-options\-list\fP مراجعه کنید. در مواردی خاص، این کار ممکن است برای گزینه‌های سفارشی (custom options) نیز کار کند، اما به دلیل ماهیت کد تجزیه‌کننده (parser) ممکن است غیرقابل‌اتکا باشد و باید از آن اجتناب کرد.
.SS طبقه‌بندی کلاینت در DHCPv6 (Client Classification in DHCPv6)
.sp
کارساز DHCPv6 شامل پشتیبانی از طبقه‌بندی کلاینت (client classification) است. برای بررسی عمیق‌تر فرآیند طبقه‌بندی، Client Classification \%<#\:classify>\& را ببینید.
.sp
در مواردی خاص، پیکربندی کارساز برای تمایز قائل شدن بین انواع کلاینت‌های DHCP و رفتار متناسب با آن‌ها مفید است. طبقه‌بندی کلاینت را می‌توان برای تغییر رفتار تقریباً هر بخشی از پردازش پیام‌های DHCP به کار برد. Kea در حال حاضر سه سازوکار ارائه می‌دهد که در DHCPv6 از طبقه‌بندی کلاینت بهره می‌برند: انتخاب زیرشبکه (subnet selection)، انتخاب استخر آدرس (address pool selection)، و تخصیص گزینه‌های DHCP (DHCP options assignment).
.sp
می‌توان به Kea دستور داد تا دسترسی به زیرشبکه‌های مشخص‌شده را بر اساس اطلاعات کلاس محدود کند. این امر به‌ویژه برای مواردی مفید است که در آن دو نوع دستگاه پیوند یکسانی را به اشتراک می‌گذارند و انتظار می‌رود که از دو زیرشبکه مختلف به آن‌ها سرویس‌دهی شود. مورد کاربرد اصلی چنین سناریویی شبکه‌های کابلی است، که در آن دو کلاس از دستگاه‌ها وجود دارد: خود مودم کابلی، که باید اجاره‌ای (lease) از زیرشبکه A به آن تحویل داده شود؛ و تمامی دستگاه‌های دیگر پشت مودم، که باید اجاره‌هایی از زیرشبکه B دریافت کنند. این جداسازی برای جلوگیری از دستکاری مودم‌های کابلی توسط کاربران نهایی بیش از حد کنجکاو ضروری است. برای جزئیات در مورد نحوه راه‌اندازی محدودیت‌های کلاس روی زیرشبکه‌ها، Configuring Subnets With Class Information \%<#\:classification-subnets>\& را ببینید.
.sp
هنگامی که زیرشبکه‌ها به یک شبکه مشترک (shared network) تعلق دارند، طبقه‌بندی روی انتخاب زیرشبکه اعمال می‌شود اما روی استخرها اعمال نمی‌شود؛ یعنی یک استخر در زیرشبکه‌ای که به کلاس خاصی محدود شده است، در صورتی که استخر مورد انتظار کلاینت‌ها تمام شده باشد، همچنان می‌تواند توسط کلاینت‌هایی که به آن کلاس تعلق ندارند استفاده شود. محدودیت دسترسی بر اساس اطلاعات کلاس در سطح استخر آدرس/پیشوند درون یک زیرشبکه نیز در دسترس است: به Configuring Pools With Class Information \%<#\:classification-pools>\& مراجعه کنید. این قابلیت زمانی مفید است که کلاینت‌های متعلق به یک زیرشبکه را به محدوده‌های آدرس متفاوتی تفکیک می‌کنید.
.sp
به همین شیوه، با استفاده از کلاس‌های توکار \fBKNOWN\fP یا \fBUNKNOWN\fP، می‌توان یک استخر را محدود کرد تا تنها به کلاینت‌های شناخته‌شده، یعنی کلاینت‌هایی که دارای رزرو (reservation) هستند، سرویس دهد. می‌توان به کلاینت‌های ثبت‌شده آدرس اختصاص داد بدون اینکه برای هر رزرو یک آدرس متفاوت داده شود: برای نمونه، زمانی که آدرس‌های دردسترس کافی وجود ندارد. تعیین اینکه آیا رزروی برای یک کلاینت خاص وجود دارد یا خیر، پس از انتخاب زیرشبکه انجام می‌شود، بنابراین امکان استفاده از کلاس‌های \fBKNOWN\fP/\fBUNKNOWN\fP برای انتخاب یک شبکه مشترک یا یک زیرشبکه وجود ندارد.
.sp
فرآیند طبقه‌بندی در پنج مرحله انجام می‌شود. نخستین گام، ارزیابی بسته ورودی و انتساب آن به صفر یا چند کلاس است. دومین گام، انتخاب یک زیرشبکه است، که احتمالاً بر اساس اطلاعات کلاس صورت می‌گیرد. هنگامی که بسته ورودی در کلاس ویژه \fBDROP\fP قرار گیرد، دور انداخته می‌شود و یک پیام اشکال‌زدایی (debug) ثبت می‌گردد. گام بعدی، ارزیابی عبارت‌های کلاسیِ وابسته به کلاس‌های توکار \fBKNOWN\fP/\fBUNKNOWN\fP پس از جستجوی رزرو میزبان (host reservation lookup)، استفاده از آن‌ها برای انتخاب pool/pd\-pool و انتساب کلاس‌ها از روی رزروهای میزبان است. سپس فهرست کلاس‌های مورد نیاز ساخته می‌شود و عبارت هر کلاس از این فهرست ارزیابی می‌گردد؛ زمانی که خروجی آن \fBtrue\fP باشد، بسته به‌عنوان عضوی از آن کلاس اضافه می‌شود. گام پایانی تخصیص گزینه‌ها است که باز هم احتمالاً بر اساس اطلاعات کلاس انجام می‌شود. اطلاعات کامل‌تر و دقیق‌تر در Client Classification \%<#\:classify>\& در دسترس است.
.sp
دو روش اصلی برای طبقه‌بندی وجود دارد. روش اول خودکار است و بر بررسی مقادیر موجود در گزینه‌های vendor class یا وجود رزرو میزبان تکیه دارد. اطلاعات از این گزینه‌ها استخراج شده، و نام کلاسی از آن ساخته می‌شود و به فهرست کلاس‌های بسته افزوده می‌گردد. روش دوم، عبارتی را مشخص می‌کند که برای هر بسته ارزیابی می‌شود. اگر نتیجه \fBtrue\fP باشد، بسته عضوی از آن کلاس خواهد بود.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
پرچم پارامتر سراسری جدید \fBearly\-global\-reservations\-lookup\fP امکان جستجو برای رزروهای سراسری را قبل از مرحله انتخاب زیرشبکه فعال می‌کند. این جستجو شبیه به جستجوی عمومی شرح داده‌شده در بالا با دو تفاوت است:
.INDENT 0.0
.IP \(bu 2
جستجو به رزروهای میزبان سراسری (global host reservations) محدود است
.IP \(bu 2
کلاس \fBUNKNOWN\fP هرگز تنظیم نمی‌شود
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
در استفاده از طبقه‌بندی کلاینت باید دقت شود، زیرا کلاینت‌هایی که معیارهای کلاس را برآورده نمی‌کنند به‌سادگی ممکن است از دریافت هرگونه سرویسی محروم شوند.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
نگارش 3.1.7 از Kea کلاس ویژه دیگری به نام \fBREJECT\fP اضافه کرد که به شیوه‌ای مشابه با کلاس \fBDROP\fP کار می‌کند، اما به‌جای نادیده گرفتن و دور انداختن کامل پرس‌وجوی ورودی، از بخش تخصیص اجاره صرف‌نظر می‌کند تا IAها در پاسخ، کدهای وضعیت NoAddrsAvail یا NoPrefixAvail را دریافت کنند.
.UNINDENT
.UNINDENT.SS تعریف و استفاده از کلاس‌های سفارشی
.sp
مثال زیر نحوه پیکربندی یک کلاس با استفاده از یک عبارت (expression)
و یک زیرشبکه با استفاده از آن کلاس را نشان می‌دهد. این پیکربندی کلاسی
به نام \fBClient_enterprise\fP\& را تعریف می‌کند. این کلاس شامل تمام کلاینت‌هایی
است که شناسه کلاینت آن‌ها با رشته هگزادسیمال مشخص‌شده شروع می‌شود (که نشان‌دهنده
یک DUID بر اساس شناسه سازمانی 0xAABBCCDD است). به اعضای این کلاس آدرسی
از 2001:db8:1::0 تا 2001:db8:1::FFFF اختصاص می‌یابد و آدرس‌های کارسازهای
DNS آن‌ها روی 2001:db8:0::1 و 2001:db8:2::1 تنظیم می‌شود.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqclient\-classes\(dq: [
        {
            \(dqname\(dq: \(dqClient_enterprise\(dq,
            \(dqtest\(dq: \(dqsubstring(option[1].hex,0,6) == 0x0002AABBCCDD\(dq,
            \(dqoption\-data\(dq: [
                {
                    \(dqname\(dq: \(dqdns\-servers\(dq,
                    \(dqcode\(dq: 23,
                    \(dqspace\(dq: \(dqdhcp6\(dq,
                    \(dqcsv\-format\(dq: true,
                    \(dqdata\(dq: \(dq2001:db8:0::1, 2001:db8:2::1\(dq
                }
            ]
        },
        ...
    ],
    \(dqsubnet6\(dq: [
        {
            \(dqid\(dq: 1,
            \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
            \(dqpools\(dq: [ { \(dqpool\(dq: \(dq2001:db8:1::\-2001:db8:1::ffff\(dq } ],
            \(dqclient\-classes\(dq: [ \(dqClient_enterprise\(dq ]
        }
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
این مثال پیکربندی‌ای را با استفاده از کلاس تولیدشده خودکار
\fBVENDOR_CLASS_\fP نشان می‌دهد. مدیر شبکه تصمیم گرفته است که
آدرس‌ها در محدوده 2001:db8:1::1 تا 2001:db8:1::ffff توسط
کارساز DHCPv6 مدیریت شوند و فقط کلاینت‌های متعلق به کلاس کلاینت
eRouter1.0 مجاز به استفاده از آن استخر (pool) باشند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqsubnet6\(dq: [
        {
            \(dqid\(dq: 1,
            \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
            \(dqpools\(dq: [
                 {
                     \(dqpool\(dq: \(dq2001:db8:1::\-2001:db8:1::ffff\(dq
                 }
             ],
            \(dqclient\-classes\(dq: [ \(dqVENDOR_CLASS_eRouter1.0\(dq ]
        }
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.SS کلاس‌بندی تکمیلی
.sp
در برخی موارد، محدود کردن دامنه (scope) یک کلاس به یک pool،
subnet یا shared network مفید است. دو پارامتر وجود دارند که با دستور
دادن به کارساز برای ارزیابی عبارت‌های آزمون در زمان نیاز، برای محدود کردن
دامنه کلاس استفاده می‌شوند.
.sp
پارامتر نخست \fBevaluate\-additional\-classes\fP است که فهرستی از نام‌های
کلاس را می‌گیرد و در دامنه pool، subnet و shared network معتبر است.
کلاس‌های موجود در این فهرست‌ها به عنوان تکمیلی نشانه‌گذاری می‌شوند و پس از انتخاب
آن pool/subnet/shared network خاص و پیش از پردازش گزینه‌های خروجی ارزیابی می‌گردند.
.sp
پارامتر دوم، پرچم خاص هر کلاس به نام \fBonly\-in\-additional\-list\fP است
که به صورت پیش‌فرض \fBfalse\fP می‌باشد. هنگامی که روی \fBtrue\fP تنظیم شود،
عبارت آزمون کلاس هنگام دریافت بسته ورودی ارزیابی نمی‌شود، بلکه بعداً و تنها
در صورتی که کلاس در یک فهرست \fBevaluate\-additional\-classes\fP موجود باشد ارزیابی خواهد شد.
.sp
در این مثال، زمانی که زیرشبکه (subnet) مشخص‌شده استفاده شود، یک کلاس
به بسته ورودی اختصاص داده می‌شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqclient\-classes\(dq: [
       {
           \(dqname\(dq: \(dqClient_foo\(dq,
           \(dqtest\(dq: \(dqmember(\(aqALL\(aq)\(dq,
           \(dqonly\-in\-additional\-list\(dq: true
       },
       ...
    ],
    \(dqsubnet6\(dq: [
        {
            \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
            \(dqpools\(dq: [
                 {
                     \(dqpool\(dq: \(dq2001:db8:1::\-2001:db8:1::ffff\(dq
                 }
            ],
            \(dqevaluate\-additional\-classes\(dq: [ \(dqClient_foo\(dq ],
            ...
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
ارزیابی تکمیلی می‌تواند برای بیان وابستگی‌های پیچیده مانند عضویت در
زیرشبکه استفاده شود. همچنین می‌توان از آن برای معکوس کردن تقدم (precedence)
استفاده کرد؛ اگر \fBoption\-data\fP در یک subnet تنظیم شده باشد، بر
\fBoption\-data\fP در یک کلاس اولویت دارد. اگر \fBoption\-data\fP به یک
کلاس الزامی منتقل شود و در subnet فراخوانی شود، کلاسی که زودتر
ارزیابی شده است ممکن است تقدم پیدا کند.
.sp
ارزیابی تکمیلی در سطوح shared network و pool/pd\-pool نیز
در دسترس است. ترتیبی که در آن کلاس‌های تکمیلی بررسی می‌شوند عبارت است از:
(pd\-)pool، سپس subnet، و در نهایت shared network؛ یعنی به همان ترتیبی که
\fBoption\-data\fP پردازش می‌شود.
.sp
از نسخه 2.7.4 نرم‌افزار Kea، کلاس‌های تکمیلی که بدون عبارت آزمون پیکربندی شده‌اند
بدون قید و شرط اضافه می‌شوند؛ یعنی همواره با مقدار \fBtrue\fP ارزیابی می‌شوند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
از آنجا که ارزیابی تکمیلی پس از تخصیص اجاره (lease) رخ می‌دهد، پارامترهایی
که در غیر این صورت بر طول عمر اجاره تأثیر می‌گذاشتند (مانند \fBvalid\-lifetime\fP و
\fBpreferred\-lifetime\fP)، چنانچه در کلاسی تعیین شوند که پرچم
\fBonly\-in\-additional\-list\fP آن روی true تنظیم شده است، هیچ تأثیری نخواهند داشت.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
از نسخه 2.7.4 نرم‌افزار Kea، شناسه‌های \fBonly\-if\-required\fP و \fBrequire\-client\-classes\fP
به ترتیب به \fBonly\-in\-additional\-list\fP و \fBevaluate\-additional\-classes\fP
تغییر نام یافته‌اند. نام‌های قبلی همچنان به عنوان ورودی معتبر پذیرفته می‌شوند
تا کاربران فرصت مهاجرت به ساختار جدید را داشته باشند، اما در نهایت منسوخ و رد خواهند شد.
.UNINDENT
.UNINDENT.SS DDNS برای DHCPv6
.sp
همان‌طور که پیش‌تر اشاره شد، \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> می‌تواند به‌گونه‌ای پیکربندی شود که برای به‌روزرسانی مدخل‌های DNS، درخواست‌هایی را برای کارساز DHCP\-DDNS یعنی \fBkea\-dhcp\-ddns\fP \%<#\:std-iscman-kea-dhcp-ddns> (که در اینجا به آن \(dqD2\(dq گفته می‌شود) تولید کند. این درخواست‌ها با نام NameChangeRequests یا NCR شناخته می‌شوند. هر NCR شامل اطلاعات زیر است:
.INDENT 0.0
.IP 1. 3
اینکه آیا درخواستی برای افزودن (به‌روزرسانی) است یا حذف مدخل‌های DNS.
.IP 2. 3
اینکه آیا تغییر درخواستی برای به‌روزرسانی مستقیم DNS (رکورد‌های AAAA)، به‌روزرسانی معکوس DNS (رکورد‌های PTR)، یا هر دو است.
.IP 3. 3
نام دامنه کاملاً واجد شرایط (FQDN)، نشانی اجاره (lease address)، و DHCID (اطلاعات شناسایی کلاینت مرتبط با FQDN).
.UNINDENT
.sp
پارامترهای مرتبط با DDNS به دو گروه تقسیم می‌شوند:
.INDENT 0.0
.IP 1. 3
پارامترهای اتصال (Connectivity Parameters)
.INDENT 3.0
.INDENT 3.5
این‌ها پارامترهایی هستند که مشخص می‌کنند \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> کجا و چگونه به D2 متصل شده و با آن ارتباط برقرار می‌کند. این پارامترها فقط می‌توانند درون بخش سطح بالای \fBdhcp\-ddns\fP در پیکربندی \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> مشخص شوند. پارامترهای اتصال در زیر فهرست شده‌اند:
.INDENT 0.0
.IP \(bu 2
\fBenable\-updates\fP
.IP \(bu 2
\fBserver\-ip\fP
.IP \(bu 2
\fBserver\-port\fP
.IP \(bu 2
\fBsender\-ip\fP
.IP \(bu 2
\fBsender\-port\fP
.IP \(bu 2
\fBmax\-queue\-size\fP
.IP \(bu 2
\fBncr\-protocol\fP
.IP \(bu 2
\fBncr\-format\fP
.UNINDENT
.UNINDENT
.UNINDENT
.IP 2. 3
پارامترهای رفتاری (Behavioral Parameters)
.INDENT 3.0
.INDENT 3.5
این پارامترها بر رفتارهایی مانند نحوه مدیریت نام میزبان کلاینت و گزینه‌های FQDN تأثیر می‌گذارند. آن‌ها از بخش \fBdhcp\-ddns\fP خارج شده‌اند تا بتوان آن‌ها را در سطوح سراسری (global)، شبکه مشترک (shared\-network)، زیرشبکه (subnet) و/یا استخر (pool) مشخص کرد. علاوه بر این، آن‌ها از سطوح بالاتر به پایین به ارث می‌رسند: از سراسری به شبکه مشترک، به زیرشبکه و به استخر. به عبارت دیگر، اگر پارامتری در یک سطح خاص تعیین نشده باشد، مقدار آن سطح از سطح بالاتر دریافت می‌شود. پارامترهای رفتاری به شرح زیر هستند:
.INDENT 0.0
.IP \(bu 2
\fBddns\-send\-updates\fP
.IP \(bu 2
\fBddns\-override\-no\-update\fP
.IP \(bu 2
\fBddns\-override\-client\-update\fP
.IP \(bu 2
\fBddns\-replace\-client\-name\fP
.IP \(bu 2
\fBddns\-generated\-prefix\fP
.IP \(bu 2
\fBddns\-qualifying\-suffix\fP
.IP \(bu 2
\fBddns\-update\-on\-renew\fP
.IP \(bu 2
\fBddns\-conflict\-resolution\-mode\fP
.IP \(bu 2
\fBddns\-ttl\fP
.IP \(bu 2
\fBddns\-ttl\-percent\fP
.IP \(bu 2
\fBddns\-ttl\-min\fP
.IP \(bu 2
\fBddns\-ttl\-max\fP
.IP \(bu 2
\fBhostname\-char\-set\fP
.IP \(bu 2
\fBhostname\-char\-replacement\fP
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
در Kea 2.7.6 پشتیبانی از این پارامترها در سطح استخر (نشانی) افزوده شد. این پارامترها در pd\-pools پشتیبانی نمی‌شوند.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
پارامترهای رفتاری که بر FQDN تأثیر می‌گذارند، حتی اگر هر دو گزینهٔ \fBenable\-updates\fP و \fBddns\-send\-updates\fP برابر با \fBfalse\fP باشند نیز اعمال می‌شوند؛ این امر برای پشتیبانی از محیط‌هایی است که در آن‌ها کلاینت‌ها مسئول به‌روزرسانی DNS خود هستند. این موضوع برای \fBddns\-replace\-client\-name\fP، \fBddns\-generated\-prefix\fP، \fBddns\-qualifying\-suffix\fP، \fBhostname\-char\-set\fP، و \fBhostname\-char\-replacement\fP\& صدق می‌کند.
.UNINDENT
.UNINDENT
.sp
پیکربندی پیش‌فرض و مقادیر آن به صورت زیر خواهد بود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
     \(dqdhcp\-ddns\(dq: {
         // Connectivity parameters
         \(dqenable\-updates\(dq: false,
         \(dqserver\-ip\(dq: \(dq127.0.0.1\(dq,
         \(dqserver\-port\(dq:53001,
         \(dqsender\-ip\(dq:\(dq\(dq,
         \(dqsender\-port\(dq:0,
         \(dqmax\-queue\-size\(dq:1024,
         \(dqncr\-protocol\(dq:\(dqUDP\(dq,
         \(dqncr\-format\(dq:\(dqJSON\(dq
     },

     // Behavioral parameters (global)
     \(dqddns\-send\-updates\(dq: true,
     \(dqddns\-override\-no\-update\(dq: false,
     \(dqddns\-override\-client\-update\(dq: false,
     \(dqddns\-replace\-client\-name\(dq: \(dqnever\(dq,
     \(dqddns\-generated\-prefix\(dq: \(dqmyhost\(dq,
     \(dqddns\-qualifying\-suffix\(dq: \(dq\(dq,
     \(dqddns\-update\-on\-renew\(dq: false,
     \(dqddns\-conflict\-resolution\-mode\(dq: \(dqcheck\-with\-dhcid\(dq,
     \(dqhostname\-char\-set\(dq: \(dq[^A\-Za\-z0\-9.\-]\(dq,
     \(dqhostname\-char\-replacement\(dq: \(dqx\(dq,
     ...
}
.EE
.UNINDENT
.UNINDENT
.sp
دو پارامتر وجود دارند که تعیین می‌کنند آیا \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> می‌تواند درخواست‌های DDNS را برای D2 تولید کند یا خیر: پارامتر موجود \fBdhcp\-ddns:enable\-updates\fP که اکنون فقط کنترل می‌کند آیا \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> به D2 متصل شود یا خیر؛ و پارامتر رفتاری جدید \fBddns\-send\-updates\fP که مشخص می‌کند آیا به‌روزرسانی‌های DDNS در یک سطح مشخص (مانند سراسری، شبکه مشترک یا زیرشبکه) فعال هستند یا خیر. جدول زیر نحوه عملکرد هم‌زمان این دو پارامتر را نشان می‌دهد:.SS فعال و غیرفعال کردن به‌روزرسانی‌های DDNS
.TS
box center;
l|l|l.
T{
dhcp\-ddns:
enable\-updates
T}	T{
سراسری
ddns\-send\-updates
T}	T{
نتیجه
T}
_
T{
false (پیش‌فرض)
T}	T{
false
T}	T{
بدون به‌روزرسانی در هیچ حوزه‌ای
T}
_
T{
false
T}	T{
true (پیش‌فرض)
T}	T{
بدون به‌روزرسانی در هیچ حوزه‌ای
T}
_
T{
true
T}	T{
false
T}	T{
به‌روزرسانی تنها در حوزه‌هایی با
مقدار محلی \fBtrue\fP برای
\fBddns\-enable\-updates\fP
T}
_
T{
true
T}	T{
true
T}	T{
به‌روزرسانی در تمام حوزه‌ها به‌جز آن‌هایی
که مقدار محلی \fBfalse\fP برای
\fBddns\-enable\-updates\fP دارند
T}
.TE
.sp
در Kea 1.9.1 دو پارامتر جدید اضافه شد؛ اولین پارامتر \fBddns\-update\-on\-renew\fP است\&.
به‌طور معمول، هنگام تمدید اجاره‌ها (leases)، کارساز فقط در صورتی DNS را به‌روزرسانی می‌کند که اطلاعات DNS مربوط به اجاره (مانند FQDN، پرچم‌های جهت به‌روزرسانی DNS) تغییر کرده باشد.
تنظیم \fBddns\-update\-on\-renew\fP روی \fBtrue\fP به کارساز دستور می‌دهد که هنگام تمدید اجاره همواره اطلاعات DNS را به‌روزرسانی کند، حتی اگر اطلاعات DNS آن تغییری نکرده باشد. این ویژگی به Kea امکان می‌دهد در صورتی که پیش‌تر قادر به افزودن ورودی‌های DNS نبوده یا آن‌ها به هر دلیلی توسط کارساز DNS از دست رفته باشند، «خودترمیم» (\(dqself\-heal\(dq) انجام دهد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
تنظیم \fBddns\-update\-on\-renew\fP روی \fBtrue\fP ممکن است بر کارایی تأثیر بگذارد، به‌ویژه برای کارسازهایی با کارخواه‌های متعدد که مکرراً تمدید می‌شوند.
.UNINDENT
.UNINDENT
.sp
دومین پارامتر اضافه‌شده در Kea 1.9.1 پارامتر \fBddns\-use\-conflict\-resolution\fP است\&. این پارامتر بولی (boolean) به D2 منتقل می‌شد و حل تعارض را بر اساس شرح ارائه‌شده در RFC 4703 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc4703> فعال یا غیرفعال می‌کرد\&. از نسخه Kea 2.5.0 به بعد، این پارامتر منسوخ شده و با \fBddns\-conflict\-resolution\-mode\fP جایگزین شده است که چهار حالت رفتار مربوط به حل تعارض را ارائه می‌دهد:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
\fBcheck\-with\-dhcid\fP \- این حالت، که پیش‌فرض است، به D2 دستور می‌دهد تا حل تعارض منطبق بر RFC 4703 را انجام دهد. ورودی‌های موجود DNS فقط در صورتی بازنویسی می‌شوند که دارای یک رکورد DHCID باشند و این رکورد با DHCID کارخواه مطابقت داشته باشد. این حالت معادل \fBddns\-use\-conflict\-resolution\fP: \fBtrue\fP است؛
.IP \(bu 2
\fBno\-check\-with\-dhcid\fP \- ورودی‌های موجود DNS ممکن است توسط هر کارخواهی بازنویسی شوند، صرف‌نظر از اینکه آن ورودی‌ها شامل رکورد DHCID باشند یا خیر. ورودی‌های جدید شامل یک رکورد DHCID برای کارخواهی خواهند بود که به آن تعلق دارند. این حالت معادل \fBddns\-use\-conflict\-resolution\fP: \fBfalse\fP است؛
.IP \(bu 2
\fBcheck\-exists\-with\-dhcid\fP \- ورودی‌های موجود DNS تنها در صورتی بازنویسی می‌شوند که دارای رکورد DHCID باشند. نیازی نیست رکورد DHCID با DHCID کارخواه مطابقت داشته باشد. این حالت روشی برای محافظت از ورودی‌های ایستا DNS (آن‌هایی که رکورد DHCID ندارند) در حین اجازه دادن به بازنویسی ورودی‌های پویا (آن‌هایی که رکورد DHCID دارند) توسط هر کارخواهی فراهم می‌کند. این رفتار پیش از Kea 2.4.0 پشتیبانی نمی‌شد.
.IP \(bu 2
\fBno\-check\-without\-dhcid\fP \- ورودی‌های موجود DNS ممکن است توسط هر کارخواهی بازنویسی شوند؛ ورودی‌های جدید شامل رکوردهای DHCID نخواهند بود. این رفتار پیش از Kea 2.4.0 پشتیبانی نمی‌شد.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
جهت سازگاری با نسخه‌های پیشین، \fBddns\-use\-conflict\-resolution\fP همچنان در پیکربندی JSON پذیرفته می‌شود. کارساز این مقدار را در داخل به‌صورت خودکار با \fBddns\-conflict\-resolution\-mode\fP و مقدار مناسب جایگزین می‌کند: \(ga
\fBcheck\-with\-dhcid\fP برای \fBtrue\fP و \fBno\-check\-with\-dhcid\fP برای \fBfalse\fP\&.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
تنظیم \fBddns\-conflict\-resolution\-mode\fP روی هر مقداری به‌جز
\fBcheck\-with\-dhcid\fP، تمهیدات حفاظتی بازنویسی را که قواعد حل تعارض (از
RFC 4703 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc4703>) قصد پیشگیری از آن را دارند غیرفعال می‌کند. این بدان معناست که ورودی‌های موجود برای یک FQDN یا یک نشانی IP که برای Client\-A ایجاد شده‌اند می‌توانند توسط ورودی‌های Client\-B حذف یا جایگزین شوند. علاوه بر این، دو سناریو وجود دارد که از طریق آن‌ها ورودی‌های چند کارخواه برای یک کلید یکسان (مانند FQDN یا IP) ایجاد شود.
.sp
1. کارخواه Client\-B از همان FQDN مربوط به Client\-A اما با یک نشانی IP متفاوت استفاده می‌کند. در این حالت، ورودی‌های مستقیم DNS (رکوردهای AAAA و DHCID) مربوط به Client\-A حذف خواهند شد چرا که با FQDN مطابقت دارند، و ورودی‌های جدید برای Client\-B اضافه خواهند شد. با این حال، ورودی‌های معکوس DNS (رکوردهای PTR و DHCID) برای Client\-A حذف نخواهند شد زیرا متعلق به نشانی IP متفاوتی هستند، در حالی که ورودی‌های جدید برای Client\-B همچنان افزوده می‌شوند.
.sp
2. کارخواه Client\-B از همان نشانی IP مربوط به Client\-A اما با یک FQDN متفاوت استفاده می‌کند. در این حالت، ورودی‌های معکوس DNS (رکوردهای PTR و DHCID) مربوط به Client\-A حذف خواهند شد چرا که با نشانی IP مطابقت دارند، و ورودی‌های جدید برای Client\-B افزوده خواهند شد. با این حال، ورودی‌های مستقیم DNS (رکوردهای AAAA و DHCID) برای Client\-A حذف نخواهند شد، زیرا به یک FQDN متفاوت تعلق دارند، در حالی که ورودی‌های جدید برای Client\-B همچنان افزوده خواهند شد.
.sp
غیرفعال‌سازی حل تعارض تنها باید پس از بررسی دقیق موارد کاربرد خاص انجام شود. بهترین راه برای جلوگیری از ایجاد ورودی‌های ناخواسته DNS این است که همیشه اطمینان حاصل شود پیش از تخصیص مجدد FQDNها یا نشانی‌های IP، تغییرات اجاره از طریق Kea پردازش شوند—خواه آزاد شوند، منقضی شوند یا از طریق دستور \fBlease6\-del\fP \%<#\:std-isccmd-lease6-del> حذف شوند. انجام این کار باعث می‌شود \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> درخواست‌های حذف DNS را به D2 ارسال کند.
.UNINDENT
.UNINDENT
.sp
ورودی‌های DNS که توسط Kea ایجاد می‌شوند شامل مقداری برای TTL (طول عمر / time to live) هستند.
به‌طور پیش‌فرض، کارساز \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> این مقدار را بر اساس
RFC 4702، بخش ۵ \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc4702#\:section-5> محاسبه می‌کند،
که پیشنهاد می‌کند مقدار TTL برابر با ۱/۳ طول عمر اجاره باشد، با
حداقل مقدار ۱۰ دقیقه. چهار پارامتر اختیاری وجود دارند که
می‌توان از آن‌ها برای تأثیرگذاری بر محاسبه TTL استفاده کرد:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
\fBddns\-ttl\fP \- در صورت تعیین شدن و بزرگ‌تر بودن از ۰، بدون قید و شرط به عنوان مقدار TTL استفاده می‌شود. این پارامتر بر حسب ثانیه مشخص می‌شود. به‌طور پیش‌فرض تعیین‌نشده است.
.IP \(bu 2
\fBddns\-ttl\-percent\fP \- در صورت تعیین شدن و بزرگ‌تر بودن از صفر، به عنوان درصد طول عمر اجاره استفاده می‌شود، در غیر این صورت از ۱/۳ (بر اساس RFC 4702) طول عمر اجاره استفاده خواهد شد. این مقدار به‌صورت یک درصد اعشاری (مانند 0.75، 0.50) مشخص می‌شود و به‌طور پیش‌فرض تعیین‌نشده است.
.IP \(bu 2
\fBddns\-ttl\-min\fP \- در صورت تعیین شدن و بزرگ‌تر بودن از ۰، به عنوان حداقل مقدار استفاده می‌شود، در غیر این صورت حداقل ۶۰۰ ثانیه (بر اساس RFC 4702) در نظر گرفته خواهد شد. اگر TTL محاسبه‌شده کمتر از مقدار حداقل باشد، مقدار حداقل بازگردانده می‌شود. این پارامتر بر حسب ثانیه مشخص می‌شود. به‌طور پیش‌فرض تعیین‌نشده است.
.IP \(bu 2
\fBddns\-ttl\-max\fP \- در صورت تعیین شدن و بزرگ‌تر بودن از صفر، TTL محاسبه‌شده را به این مقدار محدود می‌کند. این پارامتر بر حسب ثانیه مشخص می‌شود. به‌طور پیش‌فرض تعیین‌نشده است.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
مقدار صفر برای هر یک از پارامترهای TTL می‌تواند برای ابطال (یعنی \(dqunspecify\(dq یا لغو تعیین) مقدار به ارث رسیده آن پارامتر از یک حوزه بالاتر استفاده شود.
.UNINDENT
.UNINDENT.SS اتصالات کارگزار DHCP\-DDNS
.sp
برای اینکه NCRها به کارگزار D2 برسند، \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> باید بتواند با آن ارتباط
برقرار کند. \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> از پارامترهای پیکربندی زیر برای
کنترل این ارتباط استفاده می‌کند:
.INDENT 0.0
.IP \(bu 2
\fBenable\-updates\fP \- این گزینه ارتباط با \fBkea\-dhcp\-ddns\fP \%<#\:std-iscman-kea-dhcp-ddns> را فعال می‌کند تا
به‌روزرسانی‌های DDNS ایجاد و ارسال شوند.
برای اینکه NCRها تولید و به D2 فرستاده شوند، مقدار آن باید \fBtrue\fP باشد.
مقدار پیش‌فرض آن \fBfalse\fP است\&.
.IP \(bu 2
\fBserver\-ip\fP \- نشانی IPای است که D2 روی آن به درخواست‌ها گوش می‌دهد. مقدار
پیش‌فرض، رابط محلی loopback روی نشانی 127.0.0.1 است.
می‌توان هر یک از نشانی‌های IPv4 یا IPv6 را مشخص کرد.
.IP \(bu 2
\fBserver\-port\fP \- درگاهی است که D2 روی آن به درخواست‌ها گوش می‌دهد. مقدار پیش‌فرض
\fB53001\fP است\&.
.IP \(bu 2
\fBsender\-ip\fP \- نشانی IPای است که \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> برای ارسال درخواست‌ها به
D2 از آن استفاده می‌کند. مقدار پیش‌فرض خالی است که به \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> دستور می‌دهد یک
نشانی مناسب را انتخاب کند.
.IP \(bu 2
\fBsender\-port\fP \- درگاهی است که \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> برای ارسال درخواست‌ها به D2 استفاده می‌کند.
مقدار پیش‌فرض \fB0\fP به \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> اعلام می‌کند یک درگاه مناسب انتخاب کند.
.IP \(bu 2
\fBmax\-queue\-size\fP \- حداکثر تعداد درخواست‌هایی است که مجازند در حین انتظار
برای ارسال به D2 در صف قرار گیرند. این مقدار از تجمع مهارنشدنی درخواست‌ها
در صورتی که سریع‌تر از تحویلشان تولید شوند، جلوگیری می‌کند. اگر تعداد
درخواست‌های در صف برای انتقال به این مقدار برسد، به‌روزرسانی DDNS تا
زمانی که انباشت صف به اندازه کافی کاهش یابد، متوقف می‌شود. هدف این است که به کارگزار
\fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> اجازه داده شود بدون مواجه شدن با خطر رشد بی‌رویه مصرف
حافظه، به عملیات‌های اجاره (lease) خود ادامه دهد. مقدار
پیش‌فرض \fB1024\fP است\&.
.IP \(bu 2
\fBncr\-protocol\fP \- پروتکل سوکت مورد استفاده هنگام ارسال درخواست‌ها به
D2 را مشخص می‌کند. در حال حاضر فقط از UDP پشتیبانی می‌شود.
.IP \(bu 2
\fBncr\-format\fP \- قالب بسته مورد استفاده هنگام ارسال درخواست‌ها به D2 را مشخص می‌کند.
در حال حاضر تنها قالب JSON پشتیبانی می‌شود.
.UNINDENT
.sp
به‌طور پیش‌فرض، فرض می‌شود که \fBkea\-dhcp\-ddns\fP \%<#\:std-iscman-kea-dhcp-ddns> روی همان دستگاهی اجرا می‌شود
که \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> در حال اجرا است، و تمام مقادیر پیش‌فرض ذکرشده در بالا باید
کافی باشند. با این حال، اگر D2 برای گوش دادن روی نشانی یا درگاه دیگری
پیکربندی شده باشد، این مقادیر باید متناسب با آن تغییر کنند. برای نمونه، اگر
D2 برای گوش دادن روی 2001:db8::5 درگاه 900 پیکربندی شده باشد، پیکربندی
زیر لازم است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqdhcp\-ddns\(dq: {
        \(dqserver\-ip\(dq: \(dq2001:db8::5\(dq,
        \(dqserver\-port\(dq: 900,
        ...
    },
    ...
}
.EE
.UNINDENT
.UNINDENT
.SS چه زمانی کارگزار \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> یک درخواست DDNS ایجاد می‌کند؟
.sp
کارگزار \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> از رفتار تعیین‌شده برای کارگزارهای DHCP در
RFC 4704 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc4704>\& پیروی می‌کند. باید در نظر
داشت که \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> تصمیم اولیه درباره زمان و موارد به‌روزرسانی را
اتخاذ کرده و این اطلاعات را در قالب NCRها به D2 هدایت می‌کند. انجام
به‌روزرسانی‌های واقعی DNS و مدیریت مواردی چون حل تعارض، در حیطه وظایف
خود D2 است
(نگاه کنید به کارگزار DHCP\-DDNS \%<#\:dhcp-ddns-server>). این بخش شرح می‌دهد که چه زمانی \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6>
اقدام به تولید NCRها می‌کند و کدام پارامترهای پیکربندی می‌توانند بر این
تصمیم اثر بگذارند. فرض بر این است که هم پارامتر ارتباطی
\fBenable\-updates\fP و هم پارامتر رفتاری \fBddns\-send\-updates\fP
برابر با \fBtrue\fP باشند\&.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
در حال حاضر رابط میان \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> و D2 تنها از درخواست‌هایی
پشتیبانی می‌کند که مدخل‌های DNS را برای یک نشانی IP منفرد به‌روزرسانی می‌کنند. اگر یک اجاره
بیش از یک نشانی اعطا کند، \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> درخواست به‌روزرسانی DDNS را
فقط برای نخستین نشانی از این نشانی‌ها تولید می‌کند.
.UNINDENT
.UNINDENT
.sp
به‌طور کلی، \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> درخواست‌های به‌روزرسانی DDNS را در شرایط زیر ایجاد می‌کند:
.INDENT 0.0
.IP 1. 3
یک اجاره جدید در پاسخ به یک DHCPREQUEST اعطا شود؛
.IP 2. 3
یک اجاره موجود تمدید شود اما FQDN مرتبط با آن
تغییر کرده باشد؛ یا
.IP 3. 3
یک اجاره موجود در پاسخ به یک DHCPRELEASE آزاد شود.
.UNINDENT
.sp
در حالت دوم، یعنی تمدید اجاره، دو درخواست DDNS صادر می‌شود: یک درخواست برای
حذف مدخل‌ها برای FQDN قبلی، و درخواست دوم برای افزودن مدخل‌ها برای FQDN جدید.
در حالت سوم، آزادسازی اجاره \- یک درخواست DDNS تکی \- برای حذف مدخل‌های آن ارسال خواهد شد.
.sp
اما در مورد حالت اول، تصمیم‌گیری‌های مربوط به اعطای اجاره جدید پیچیده‌تر
است. هنگامی که اجاره جدیدی اعطا می‌شود، \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> تنها در صورتی درخواست
به‌روزرسانی DDNS ایجاد می‌کند که DHCPREQUEST حاوی گزینه FQDN
(کد 39) باشد.
به‌طور پیش‌فرض، \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> به پرچم‌های N و S مربوط به FQDN
که توسط سرویس‌گیرنده مشخص شده‌اند همان‌گونه که در جدول زیر نشان داده شده، احترام می‌گذارد:
.SS رفتار پیش‌فرض پرچم‌های FQDN
.TS
box center;
l|l|l|l.
T{
پرچم‌های
سرویس‌گیرنده: N\-S
T}	T{
هدف سرویس‌گیرنده
T}	T{
پاسخ کارگزار
T}	T{
پرچم‌های
کارگزار: N\-S\-O
T}
_
T{
0\-0
T}	T{
سرویس‌گیرنده مایل به
انجام به‌روزرسانی‌های مستقیم
است، کارگزار باید
به‌روزرسانی‌های معکوس را
انجام دهد
T}	T{
کارگزار درخواستی
فقط برای معکوس
تولید می‌کند
T}	T{
1\-0\-0
T}
_
T{
0\-1
T}	T{
کارگزار باید هم
به‌روزرسانی‌های مستقیم
و هم معکوس را
انجام دهد
T}	T{
کارگزار درخواستی
برای به‌روزرسانی هر دو
جهت تولید می‌کند
T}	T{
0\-1\-0
T}
_
T{
1\-0
T}	T{
سرویس‌گیرنده مایل به
انجام هیچ به‌روزرسانی‌ای
نیست
T}	T{
کارگزار درخواستی
تولید نمی‌کند
T}	T{
1\-0\-0
T}
.TE
.sp
سطر نخست در جدول بالا نمایانگر \(dqواگذاری سرویس‌گیرنده\(dq (client delegation) است. در اینجا
سرویس‌گیرنده DHCP اعلام می‌کند که قصد دارد به‌روزرسانی‌های مستقیم DNS را خود انجام دهد و
کارگزار باید به‌روزرسانی‌های معکوس را انجام دهد. به‌طور پیش‌فرض، \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6>
به خواسته سرویس‌گیرنده احترام گذاشته و یک درخواست DDNS به کارگزار D2 برای به‌روزرسانی
داده‌های معکوس DNS تولید می‌کند. می‌توان از پارامتر
\fBddns\-override\-client\-update\fP برای دستور به کارگزار جهت نادیده‌گرفتن درخواست‌های
واگذاری سرویس‌گیرنده استفاده کرد. هنگامی که این پارامتر \fBtrue\fP باشد،
\fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> درخواست‌های واگذاری سرویس‌گیرنده را نادیده گرفته و یک
درخواست DDNS برای به‌روزرسانی داده‌های مستقیم و معکوس DNS تولید می‌کند. در این حالت،
پرچم‌های N\-S\-O در پاسخ کارگزار به سرویس‌گیرنده به ترتیب 0\-1\-1
خواهد بود.
.sp
(توجه داشته باشید که بر اساس RFC 4702 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc4702>\&،
ترکیب پرچم‌های N=1 و S=1 ممنوع است. در صورت دریافت چنین ترکیبی از
سرویس‌گیرنده، بسته توسط \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> دور انداخته خواهد شد\&.)
.sp
برای نادیده‌گرفتن واگذاری سرویس‌گیرنده، مقادیر زیر را در فایل
پیکربندی تنظیم کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqddns\-override\-client\-update\(dq: true,
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
سطر سوم جدول بالا حالتی را شرح می‌دهد که در آن سرویس‌گیرنده
درخواست می‌کند هیچ به‌روزرسانی DNS انجام نشود. می‌توان از پارامتر
\fBddns\-override\-no\-update\fP برای دستور به کارگزار جهت نادیده گرفتن خواسته
سرویس‌گیرنده استفاده کرد. هنگامی که این پارامتر \fBtrue\fP باشد، \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6>
حتی اگر سرویس‌گیرنده درخواست کرده باشد که هیچ به‌روزرسانی‌ای صورت نگیرد، درخواست‌های به‌روزرسانی DDNS
را به \fBkea\-dhcp\-ddns\fP \%<#\:std-iscman-kea-dhcp-ddns> ارسال می‌کند. پرچم‌های N\-S\-O در پاسخ کارگزار
به سرویس‌گیرنده 0\-1\-1 خواهد بود.
.sp
برای نادیده‌گرفتن واگذاری سرویس‌گیرنده، پیکربندی زیر را اعمال کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqddns\-override\-no\-update\(dq: true,
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
کارگزار \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> در صورتی که درخواست سرویس‌گیرنده فقط
شامل گزینه Host Name باشد، همیشه درخواست‌های به‌روزرسانی DDNS را تولید می‌کند.
علاوه بر این، یک گزینه FQDN را با پرچم‌های FQDN N\-S\-O که به ترتیب روی 0\-1\-0 تنظیم شده‌اند،
در پاسخ به سرویس‌گیرنده قرار می‌دهد. بخش نام دامنه از گزینه FQDN، همان نامی است که در
درخواست به‌روزرسانی DDNS به D2 ارسال می‌شود..SS \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> تولید نام برای درخواست‌های به‌روزرسانی DDNS
.sp
هر NameChangeRequest مسلماً باید شامل نام دامنه کاملاً واجد شرایط (FQDN) باشد که مدخل‌های DNS آن قرار است تحت تأثیر قرار گیرند. \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> می‌تواند به‌گونه‌ای پیکربندی شود که بخشی از آن نام یا تمامی آن را بر اساس آنچه از کارخواه در DHCPREQUEST دریافت می‌کند، تأمین نماید.
.sp
قوانین پیش‌فرض برای ساخت FQDN که برای مدخل‌های DNS استفاده خواهد شد عبارتند از:
.INDENT 0.0
.IP 1. 3
اگر DHCPREQUEST شامل گزینه FQDN کارخواه باشد، نام کاندید از آن گرفته می‌شود.
.IP 2. 3
اگر نام کاندید یک نام جزئی (یعنی نامشخص یا فاقد صلاحیت) باشد، یک پسوند قابل‌پیکربندی به نام افزوده شده و از نتیجه به‌عنوان FQDN استفاده می‌شود.
.IP 3. 3
اگر نام کاندید ارائه‌شده خالی باشد، با استفاده از یک پیشوند و پسوند قابل‌پیکربندی، یک FQDN تولید می‌شود.
.IP 4. 3
اگر کارخواه هیچ‌یک از گزینه‌ها را ارائه نکند، هیچ اقدامی روی DNS صورت نمی‌گیرد.
.UNINDENT
.sp
این قوانین را می‌توان با تنظیم پارامتر \fBddns\-replace\-client\-name\fP اصلاح کرد، که حالت‌های رفتاری زیر را فراهم می‌کند:
.INDENT 0.0
.IP \(bu 2
\fBnever\fP \- استفاده از نام ارسالی کارخواه. اگر کارخواه نامی ارسال نکرده باشد، نامی تولید نمی‌شود. این حالت پیش‌فرض است.
.IP \(bu 2
\fBalways\fP \- جایگزینی نام ارسالی کارخواه. اگر کارخواه نامی ارسال نکرده باشد، یک نام برای کارخواه تولید می‌شود.
.IP \(bu 2
\fBwhen\-present\fP \- جایگزینی نام ارسالی کارخواه. اگر کارخواه نامی ارسال نکرده باشد، نامی تولید نمی‌شود.
.IP \(bu 2
\fBwhen\-not\-present\fP \- استفاده از نام ارسالی کارخواه. اگر کارخواه نامی ارسال نکرده باشد، یک نام برای کارخواه تولید می‌شود.
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
در نسخه‌های اولیه Kea، این پارامتر بولی بود و فقط مقادیر \fBtrue\fP و \fBfalse\fP\& را مجاز می‌دانست. مقادیر بولی منسوخ شده‌اند و دیگر پذیرفته نمی‌شوند؛ مدیرانی که در حال حاضر از مقادیر بولی استفاده می‌کنند باید آن‌ها را با نام حالت مورد نظر جایگزین کنند. مقدار \fBtrue\fP به \fBwhen\-present\fP و مقدار \fBfalse\fP به \fBnever\fP\& نگاشت می‌شود.
.UNINDENT
.UNINDENT
.sp
برای نمونه، جهت دستور دادن به \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> برای تولید همیشگی FQDN برای یک کارخواه، پارامتر \fBddns\-replace\-client\-name\fP را مانند زیر روی \fBalways\fP تنظیم کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqddns\-replace\-client\-name\(dq: \(dqalways\(dq,
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
پیشوند مورداستفاده در تولید FQDN توسط پارامتر \fBddns\-generated\-prefix\fP مشخص می‌شود. مقدار پیش‌فرض \(dqmyhost\(dq است. برای تغییر مقدار آن، کافی است آن را روی رشته دلخواه تنظیم کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqddns\-generated\-prefix\(dq: \(dqanother.host\(dq,
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
پسوند مورداستفاده هنگام تولید یک FQDN، یا هنگام کامل‌سازی یک نام جزئی، توسط پارامتر \fBddns\-qualifying\-suffix\fP مشخص می‌شود. اکیداً توصیه می‌شود که در صورت فعال بودن به‌روزرسانی‌های DDNS، کاربر مقداری را برای پسوند صلاحیت‌بخش تعیین کند. به دلایل آشکار، ما نمی‌توانیم یک مقدار پیش‌فرض معنادار ارائه دهیم.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqddns\-qualifying\-suffix\(dq: \(dqfoo.example.org\(dq,
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
هنگام کامل‌سازی یک نام جزئی، \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> نام را در قالب زیر می‌سازد:
.sp
\fB[candidate\-name].[ddns\-qualifying\-suffix].\fP
.sp
که در آن \fBcandidate\-name\fP همان نام جزئی ارائه‌شده در DHCPREQUEST است. برای نمونه، اگر مقدار نام دامنه FQDN برابر با \(dqsome\-computer\(dq و مقدار \fBddns\-qualifying\-suffix\fP برابر با \(dqexample.com\(dq باشد، FQDN تولیدشده عبارت خواهد بود از:
.sp
\fBsome\-computer.example.com.\fP
.sp
هنگام تولید نام کامل، \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> نام را در قالب زیر می‌سازد:
.sp
\fB[ddns\-generated\-prefix]\-[address\-text].[ddns\-qualifying\-suffix].\fP
.sp
که در آن \fBaddress\-text\fP صرفاً همان آدرس IP اجاره (lease) است که به رشته‌ای جداشده با خط تیره تبدیل شده است. برای نمونه، اگر آدرس اجاره 3001:1::70E باشد، پسوند صلاحیت‌بخش \(dqexample.com\(dq باشد و از مقدار پیش‌فرض برای \fBddns\-generated\-prefix\fP استفاده شود، FQDN تولیدشده عبارت است از:
.sp
\fBmyhost\-3001\-1\-\-70E.example.com.\fP
.sp
از نسخه 2.7.8 برنامه Kea به بعد، پیشوندهای تولیدشده‌ای که به خط تیره ختم می‌شدند، یک صفر به انتهای آن‌ها اضافه خواهد شد. برای مثال، پیشوند تولیدشده برای آدرس \(dq2001:db8:1::\(dq به صورت \(dqmyhost\-2001\-db8\-1\-\-0\(dq خواهد بود..SS پالایش نام‌های FQDN کلاینت
.sp
برخی از کلاینت‌های DHCP ممکن است مقادیری را در مؤلفهٔ نام از گزینهٔ FQDN
(کد گزینهٔ ۳۹) ارائه دهند که حاوی نویسه‌های
نامطلوب باشد. می‌توان \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> را برای پالایش این
مقادیر پیکربندی کرد. معمول‌ترین مورد کاربرد، اطمینان از این است که تنها نویسه‌های
مجاز طبق RFC 1035 شامل شوند: A\-Z،‏ a\-z،‏ 0\-9 و \(dq\-\(dq. این کار می‌تواند با
دو پارامتر زیر انجام شود:
.INDENT 0.0
.IP \(bu 2
\fBhostname\-char\-set\fP \- یک عبارت باقاعده که مجموعه نویسه‌های نامعتبر را توصیف
می‌کند. این مقدار می‌تواند هر عبارت باقاعدهٔ معتبری با استفاده از نحو عبارات
گسترش‌یافتهٔ POSIX باشد. نویسه‌های تهی نشانده‌شده (0x00) همواره به عنوان
یک نویسهٔ نامعتبر در نظر گرفته می‌شوند تا جایگزین (یا حذف) شوند.
پیش‌فرض \fB\(dq[^A\-Za\-z0\-9.\-]\(dq\fP\& است. این عبارت با هر نویسه‌ای که
حرف، رقم، نقطه یا خط پیوند نباشد مطابقت دارد. اکیداً توصیه می‌شود که این مقدار
بر روی یک رشتهٔ خالی (\fB\(dq\(dq\fP) تنظیم نشود، زیرا این کار اجازه می‌دهد
نویسه‌های غیرقابل‌چاپ در مؤلفهٔ hostname استفاده شوند.
.IP \(bu 2
\fBhostname\-char\-replacement\fP \- رشته‌ای از صفر یا چند نویسه که هر نویسهٔ نامعتبر
در نام میزبان با آن جایگزین می‌شود. یک رشتهٔ خالی باعث می‌شود نویسه‌های نامعتبر
به‌جای جایگزین شدن، حذف (OMITTED) شوند.
پیش‌فرض \fB\(dq\(dq\fP\& است.
.UNINDENT
.sp
پیکربندی زیر هر چیزی غیر از یک حرف، رقم، نقطه یا خط پیوند را با حرف \(dqx\(dq جایگزین می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqhostname\-char\-set\(dq: \(dq[^A\-Za\-z0\-9.\-]\(dq,
    \(dqhostname\-char\-replacement\(dq: \(dqx\(dq,
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
بدین ترتیب، مقدار ارائه‌شده توسط کلاینت مانند \(dqmyhost\-$[123.org\(dq به
\(dqmyhost\-xx123.org\(dq تبدیل خواهد شد. پالایش تنها روی بخشی از نام که توسط
کلاینت ارائه شده انجام می‌گیرد، و قبل از اعمال پسوند صلاحیت‌بخش (در صورت تعریف
و نیاز) اعمال می‌شود.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
هدف از پالایش نام، پوشش دادن حالت‌های متداول‌تر نویسه‌های نامعتبر از طریق یک طرح
نسبتاً سادهٔ جایگزینی نویسه است. ابداع طرحی که در همهٔ موارد به‌خوبی کار کند
دشوار است. مدیرانی که کلاینت‌هایی با موارد خاص و نامتعارف از ترکیب نویسه‌ها دارند
که به‌سادگی با این سازوکار قابل مدیریت نیست، باید نوشتن یک قلاب (hook) را مد نظر
قرار دهند که بتواند منطق به‌اندازهٔ کافی پیچیده‌ای را برای برآورده کردن نیازهایشان اجرا کند.
.sp
اطمینان حاصل کنید که نقطه، یعنی \(dq.\(dq، توسط عبارت \fBhostname\-char\-set\fP به عنوان
یک نویسهٔ معتبر در نظر گرفته شود، مانند این: \fB\(dq[^A\-Za\-z0\-9.\-]\(dq\fP\&.
هنگام پالایش FQDNها، نقطه‌ها به عنوان جداکننده تلقی شده و برای تفکیک مقدار گزینه
به برچسب‌های دامنهٔ جداگانه که پالایش شده و سپس مجدداً سرهم می‌شوند، به کار می‌روند.
.sp
اگر کلاینت‌ها مقادیری را ارسال می‌کنند که تفاوت آن‌ها فقط در نویسه‌هایی است که توسط
\fBhostname\-char\-set\fP نامعتبر شمرده شده‌اند، آگاه باشید که پالایش آن‌ها به
مقادیر یکسان منجر خواهد شد. در چنین مواردی، قواعد تداخل DDNS تنها به یکی از
آن‌ها اجازهٔ ثبت نام را می‌دهد.
.sp
در نهایت، با توجه به اختیاری که کلاینت‌ها در ارسال مقادیر دارند، عملاً غیرممکن است
تضمین شود که ترکیبی از این دو پارامتر همیشه نامی معتبر برای استفاده در DNS به دست
دهد. برای نمونه، استفاده از یک مقدار خالی برای \fBhostname\-char\-replacement\fP
در صورتی که برچسب دامنه تنها از نویسه‌های نامعتبر تشکیل شده باشد، می‌تواند منجر به
یک برچسب خالی درون یک نام شود.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
امکان تعیین \fBhostname\-char\-set\fP و/یا \fBhostname\-char\-replacement\fP
در حوزهٔ سراسری (global scope) وجود دارد.
.sp
کتابخانهٔ قلاب کئا با نام \fBlibdhcp_ddns_tuning.so\fP \%<#\:std-ischooklib-libdhcp_ddns_tuning\:.so> این قابلیت را
برای هر دوی \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> و \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> فراهم می‌کند
تا نام‌های میزبان را به‌طور رویه‌ای بر پایه یک عبارت ایجاد کنند، از به‌روزرسانی‌های DDNS
به‌ازای هر کلاینت صرف‌نظر نمایند، یا جنبه‌های مختلف به‌روزرسانی DNS را به‌دقت تنظیم کنند.
لطفاً برای گزینه‌های پیکربندی به مستندات libdhcp_ddns_tuning.so: DDNS Tuning \%<#\:hooks-ddns-tuning>
مراجعه نمایید.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
از نسخهٔ Kea 3.1.3 به بعد، هنگامی که پالایش منجر به یک رشتهٔ خالی شود، گزینهٔ
FQDN به‌گونه‌ای نادیده گرفته خواهد شد که گویی کلاینت اصلاً آن را ارسال نکرده است.
این موضوع می‌تواند در صورتی رخ دهد که مقدار ارسال‌شده توسط کلاینت تنها شامل
نویسه‌هایی باشد که توسط عبارت در \(aqhostname\-char\-set\(aq نامعتبر شمرده شده
و \(aqhostname\-char\-replacement\(aq نیز خالی، یعنی \(dq\(dq باشد.
.UNINDENT
.UNINDENT
.SS DHCPv4\-over\-DHCPv6: سمت DHCPv6
.sp
پشتیبانی از انتقال DHCPv4\-over\-DHCPv6 در RFC 7341 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc7341> شرح
داده شده است و با استفاده از همکاری سرورهای DHCPv4 و DHCPv6 پیاده‌سازی می‌شود.
این بخش دربارهٔ پیکربندی سمت DHCPv6 است (سمت DHCPv4 در
DHCPv4\-over\-DHCPv6: DHCPv4 Side \%<#\:dhcp4-dhcp4o6-config> شرح داده شده است).
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
جزئیات ارتباط بین‌فرآیندی در DHCPv4\-over\-DHCPv6 ممکن است تغییر کند؛ برای نمونه،
پشتیبانی از رله پورت (RFC 8357) یک تغییر ناسازگار معرفی کرد.
هر دو سمت DHCPv4 و DHCPv6 باید نسخهٔ یکسانی از Kea را اجرا کنند.
.UNINDENT
.UNINDENT
.sp
تنها یک پارامتر ویژه برای سمت DHCPv6 وجود دارد:
\fBdhcp4o6\-port\fP، که نخستین پورت از دو پورت متوالی سوکت‌های UDP مورد استفاده
برای ارتباط میان سرورهای DHCPv6 و DHCPv4 را مشخص می‌کند. سرور DHCPv6 به ::1 روی
\fBport\fP مقید (bind) شده و به ::1 روی \fBport\fP + 1 متصل می‌شود.
.sp
دو مدخل پیکربندی دیگر نیز معمولاً الزامی هستند: پشتیبانی از ترافیک Unicast
(بخش Unicast Traffic Support را ببینید) و گزینهٔ آدرس سرور DHCP 4o6
(نام \(dqdhcp4o6\-server\-addr\(dq، کد 88).
.sp
شرکت ISC پیکربندی زیر را آزمایش کرده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{

# DHCPv6 conf
\(dqDhcp6\(dq: {

    \(dqinterfaces\-config\(dq: {
        \(dqinterfaces\(dq: [ \(dqeno33554984/2001:db8:1:1::1\(dq ]
    },

    \(dqlease\-database\(dq: {
        \(dqtype\(dq: \(dqmemfile\(dq,
        \(dqname\(dq: \(dqleases6\(dq
    },

    \(dqpreferred\-lifetime\(dq: 3000,
    \(dqvalid\-lifetime\(dq: 4000,
    \(dqrenew\-timer\(dq: 1000,
    \(dqrebind\-timer\(dq: 2000,

    \(dqsubnet6\(dq: [ {
        \(dqid\(dq: 1,
        \(dqsubnet\(dq: \(dq2001:db8:1:1::/64\(dq,
        \(dqinterface\(dq: \(dqeno33554984\(dq,
        \(dqpools\(dq: [ { \(dqpool\(dq: \(dq2001:db8:1:1::1:0/112\(dq } ]
    } ],

    \(dqdhcp4o6\-port\(dq: 786,

    \(dqoption\-data\(dq: [ {
        \(dqname\(dq: \(dqdhcp4o6\-server\-addr\(dq,
        \(dqcode\(dq: 88,
        \(dqspace\(dq: \(dqdhcp6\(dq,
        \(dqcsv\-format\(dq: true,
        \(dqdata\(dq: \(dq2001:db8:1:1::1\(dq
    } ],


    \(dqloggers\(dq: [ {
        \(dqname\(dq: \(dqkea\-dhcp6\(dq,
        \(dqoutput\-options\(dq: [ {
            \(dqoutput\(dq: \(dqkea\-dhcp6.log\(dq
        } ],
        \(dqseverity\(dq: \(dqDEBUG\(dq,
        \(dqdebuglevel\(dq: 0
    } ]
}

}
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
پیام‌های بازپخش‌شدهٔ (Relayed) DHCPv6 از نوع DHCPv4\-QUERY پشتیبانی نمی‌شوند.
.UNINDENT
.UNINDENT.SS بررسی‌های صحت در DHCPv6
.sp
یک جنبه مهم از یک سامانه DHCP با عملکرد مناسب، اطمینان از سازگار ماندن
داده‌ها است؛ با این حال، در برخی موارد ممکن است تحمل برخی داده‌های ناسازگار
مناسب باشد. برای مثال، یک مدیر شبکه که به طور موقت یک زیرشبکه را از
پیکربندی حذف می‌کند، مایل نیست تمام اجاره‌های مرتبط با آن از پایگاه‌داده
اجاره‌ها ناپدید شوند. Kea سازوکاری برای پیاده‌سازی بررسی‌های صحت برای شرایطی
از این دست دارد.
.sp
Kea از یک حوزه پیکربندی به نام \fBsanity\-checks\fP پشتیبانی می‌کند.
پارامتری به نام \fBlease\-checks\fP،
اعتبارسنجی انجام‌شده هنگام بارگذاری یک اجاره جدید از یک فایل اجاره را
کنترل می‌کند. این سازوکار به Kea اجازه می‌دهد تا برای اصلاح داده‌های ناسازگار تلاش کند.
.sp
هر زیرشبکه دارای یک مقدار \fBsubnet\-id\fP است؛ Kea به این صورت در داخل
زیرشبکه‌ها را شناسایی می‌کند. هر اجاره نیز دارای پارامتر \fBsubnet\-id\fP است که
زیرشبکه متعلق به آن را مشخص می‌کند. با این حال، اگر پیکربندی تغییر کرده باشد،
ممکن است اجاره‌ای با یک \fBsubnet\-id\fP وجود داشته باشد بدون اینکه هیچ زیرشبکه
منطبقی با آن یافت شود. همچنین، این احتمال وجود دارد که پیکربندی زیرشبکه تغییر
کرده باشد و \fBsubnet\-id\fP اکنون متعلق به زیرشبکه‌ای باشد که با اجاره مطابقت ندارد.
.sp
الگوریتم اصلاحی Kea ابتدا
بررسی می‌کند که آیا زیرشبکه‌ای با \fBsubnet\-id\fP مشخص‌شده توسط اجاره وجود دارد یا خیر.
اگر وجود داشته باشد، بررسی می‌کند که آیا اجاره متعلق به آن زیرشبکه است یا خیر.
در غیر این صورت، بسته به تنظیمات \fBlease\-checks\fP، اجاره دور انداخته می‌شود،
یک هشدار نمایش داده می‌شود، یا زیرشبکه جدیدی برای اجاره انتخاب می‌شود که از نظر
مکان‌شناسی (topologically) با آن همخوانی دارد.
.sp
از آنجا که پیشوندهای تفویض‌شده (delegated prefixes) لزوماً نباید متعلق به زیرشبکه‌ای
باشند که در آن ارائه می‌شوند، راهی برای پیاده‌سازی چنین سازوکاری برای پیشوندهای IPv6
وجود ندارد. به همین دلیل، این سازوکار تنها برای آدرس‌های IPv6 کار می‌کند.
.sp
پنج سطح پشتیبانی می‌شود:
.INDENT 0.0
.IP \(bu 2
\fBnone\fP \- هیچ بررسی خاصی انجام نده؛ اجاره را همان‌گونه که هست بپذیر.
.IP \(bu 2
\fBwarn\fP \- در صورت شناسایی مشکلات، یک هشدار نمایش بده، اما به هر حال
داده‌های اجاره را بپذیر. این مقدار پیش‌فرض است.
.IP \(bu 2
\fBfix\fP \- در صورت کشف ناسازگاری در داده‌ها، سعی در اصلاح آن کن. اگر
اصلاح موفقیت‌آمیز نبود، به هر حال داده‌های نادرست را درج کن.
.IP \(bu 2
\fBfix\-del\fP \- در صورت کشف ناسازگاری در داده‌ها، سعی در اصلاح آن کن.
اگر اصلاح موفقیت‌آمیز نبود، اجاره را رد کن. این تنظیم صحت داده‌ها را تضمین می‌کند،
اما ممکن است برخی از داده‌های نادرست از دست بروند. با احتیاط استفاده شود.
.IP \(bu 2
\fBdel\fP \- در صورت شناسایی هرگونه
ناسازگاری، اجاره را رد کن. این سخت‌گیرانه‌ترین حالت است؛ با احتیاط استفاده شود.
.UNINDENT
.sp
این ویژگی در حال حاضر برای backend memfile پیاده‌سازی شده است. بررسی صحت
روی پایگاه‌داده اجاره در حافظه اعمال می‌شود، نه روی فایل اجاره؛ یعنی اجاره‌های
ناسازگار در فایل اجاره باقی خواهند ماند.
.sp
یک نمونه پیکربندی که این پارامتر را تنظیم می‌کند به شرح زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqsanity\-checks\(dq: {
        \(dqlease\-checks\(dq: \(dqfix\-del\(dq
    },
    ...
}
.EE
.UNINDENT
.UNINDENT
.SS ذخیره‌سازی اطلاعات توسعه‌یافته اجاره
.sp
برای پشتیبانی از ویژگی‌هایی مانند DHCPv6 Reconfigure
(RFC 3315 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc3315>) و Leasequery
(RFC 5007 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc5007>)،
اطلاعات تکمیلی باید همراه با هر اجاره ذخیره شود. از آنجا که حجم اطلاعات ذخیره‌شده
برای هر اجاره پیامدهایی از نظر عملکرد و مصرف منابع سیستم دارد، ذخیره‌سازی این اطلاعات
تکمیلی از طریق پارامتر \fBstore\-extended\-info\fP قابل پیکربندی است.
مقدار پیش‌فرض آن \fBfalse\fP است و ممکن است در سطوح سراسری (global)، shared\-network، و
زیرشبکه تنظیم شود.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqstore\-extended\-info\(dq: true,
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
هنگامی که روی \fBtrue\fP تنظیم شود، اطلاعات مربوط به پرس‌وجوی DHCPv6 (مانند REQUEST، RENEW،
یا REBIND) که اجاره را درخواست می‌کند، به عنوان یک عنصر نگاشت با برچسب \(dqISC\(dq به
\fBuser\-context\fP اجاره اضافه می‌شود. در حال حاضر، اطلاعات موجود در این نگاشت
فهرستی از رله‌ها است؛ یکی برای هر لایه پیام رله که پرس‌وجوی کلاینت را در بر می‌گیرد.
\fBuser\-context\fP اجاره برای یک پرس‌وجوی با دو جهش (two\-hop) ممکن است چیزی شبیه به این باشد
(برای وضوح بیشتر به صورت ساختاریافته نمایش داده شده است):
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqISC\(dq: {
        \(dqrelay\-info\(dq: [
        {
            \(dqhop\(dq: 3,
            \(dqlink\(dq: \(dq2001:db8::1\(dq,
            \(dqpeer\(dq: \(dq2001:db8::2\(dq
        },
        {
            \(dqhop\(dq: 2,
            \(dqlink\(dq: \(dq2001:db8::3\(dq,
            \(dqoptions\(dq: \(dq0x00C800080102030405060708\(dq,
            \(dqpeer\(dq: \(dq2001:db8::4\(dq
        },
        {
            \(dqhop\(dq: 1,
            \(dqlink\(dq: \(dq2001:db8::5\(dq,
            \(dqoptions\(dq: \(dq0x00250006010203040506003500086464646464646464\(dq,
            \(dqremote\-id\(dq: \(dq010203040506\(dq,
            \(dqrelay\-id\(dq: \(dq6464646464646464\(dq
        }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
پیش از نسخه 2.3.2 برنامه Kea، این ورودی \fBrelays\fP نامیده می‌شد؛ گزینه‌های شناسه‌گر
راه دور (remote) و رله رمزگشایی نمی‌شدند.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این احتمال وجود دارد که سایر کتابخانه‌های قلاب (hook libraries) قبلاً از
\fBuser\-context\fP استفاده کرده باشند. فعال کردن \fBstore\-extended\-info\fP نباید با
محتوای دیگر \fBuser\-context\fP تداخلی ایجاد کند، تا زمانی که آن‌ها نیز از عنصری با
برچسب \(dqISC\(dq استفاده نکنند. به عبارت دیگر، \fBuser\-context\fP به عنوان یک ظرف
انعطاف‌پذیر برای برآورده کردن اهداف متعدد در نظر گرفته شده است. تا زمانی که هدف دیگری نیز
یک عنصر \(dqISC\(dq در \fBuser\-context\fP ننویسد، نباید هیچ تداخلی وجود داشته باشد.
.UNINDENT
.UNINDENT
.sp
اطلاعات توسعه‌یافته اجاره نیز مشمول بررسی صحت قابل پیکربندی است.
پارامتر موجود در حوزه \fBsanity\-checks\fP به نام \fBextended\-info\-checks\fP است
و از این سطوح پشتیبانی می‌کند:
.INDENT 0.0
.IP \(bu 2
\fBnone\fP \- هیچ بررسی یا ارتقایی انجام نده. این سطح فقط باید زمانی استفاده
شود که از اطلاعات توسعه‌یافته اصلاً استفاده نمی‌شود یا انتظار هیچ اطلاعات توسعه‌یافته
با قالب‌بندی نادرست، از جمله استفاده از قالب قدیمی، وجود ندارد.
.IP \(bu 2
\fBfix\fP \- برخی از ناسازگاری‌های رایج را برطرف کن و اطلاعات توسعه‌یافته
با قالب قدیمی را به قالب جدید ارتقا بده. این سطح پیش‌فرض است و زمانی مناسب
است که کتابخانه قلاب Leasequery بارگذاری نشده باشد.
.IP \(bu 2
\fBstrict\fP \- تمام ناسازگاری‌هایی را که بر کتابخانه قلاب (Bulk) Leasequery
تأثیر دارند، برطرف کن.
.IP \(bu 2
\fBpedantic\fP \- انطباق کامل با قالبی که توسط کد Kea تولید می‌شود را اعمال کن؛
برای مثال، به استثنای \fBcomment\fP هیچ ورودی اضافه دیگری مجاز نیست.
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این ویژگی در حال حاضر تنها برای backend memfile پیاده‌سازی شده است.
بررسی صحت روی پایگاه‌داده اجاره در حافظه اعمال می‌شود، نه روی فایل اجاره؛
یعنی اجاره‌های ناسازگار در فایل اجاره باقی می‌مانند.
.UNINDENT
.UNINDENT.SS تنظیمات چندریسمانی (Multi\-Threading Settings)
.sp
سرور Kea را می‌توان برای پردازش موازی بسته‌ها با استفاده از چند ریسمان (thread) پیکربندی کرد. این تنظیمات در ساختار \fBmulti\-threading\fP یافت می‌شوند و با پارامترهای زیر مشخص می‌گردند:
.INDENT 0.0
.IP \(bu 2
\fBenable\-multi\-threading\fP \- استفاده از چندین ریسمان برای پردازش موازی بسته‌ها. مقدار پیش‌فرض \fBtrue\fP است\&.
.IP \(bu 2
\fBthread\-pool\-size\fP \- تعیین تعداد ریسمان‌ها برای پردازش موازی بسته‌ها. می‌تواند روی \fB0\fP (تشخیص خودکار) یا هر عدد مثبتی که تعداد ریسمان‌ها را به‌طور صریح مشخص کند تنظیم شود. مقدار پیش‌فرض \fB0\fP است\&.
.IP \(bu 2
\fBpacket\-queue\-size\fP \- تعیین اندازهٔ صف مورد استفاده توسط استخر ریسمان (thread pool) برای پردازش بسته‌ها. می‌تواند روی \fB0\fP (نامحدود) یا هر عدد مثبتی که اندازهٔ صف را به‌طور صریح مشخص کند تنظیم شود. مقدار پیش‌فرض \fB64\fP است\&.
.UNINDENT
.sp
یک نمونه پیکربندی که این پارامترها را تنظیم می‌کند به صورت زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqmulti\-threading\(dq: {
       \(dqenable\-multi\-threading\(dq: true,
       \(dqthread\-pool\-size\(dq: 4,
       \(dqpacket\-queue\-size\(dq: 16
    },
    ...
}
.EE
.UNINDENT
.UNINDENT
.SS تنظیمات چندریسمانی با پس‌اندهای پایگاه‌داده مختلف (Multi\-Threading Settings With Different Database Backends)
.sp
سرور Kea DHCPv6 توسط ISC بنچمارک شده است تا مشخص شود چه تنظیماتی بهترین کارایی را ارائه می‌دهند. اگرچه این بخش نتایج ما را شرح می‌دهد، اما آنها صرفاً پیشنهاد هستند و به سخت‌افزار خاص مورد استفاده برای محک‌زنی بستگی زیادی دارند. قویاً توصیه می‌کنیم که مدیران سیستم بنچمارک‌های کارایی مختص به خود را اجرا کنند.
.sp
گزارش کاملی از نتایج کارایی برای آخرین نسخهٔ پایدار Kea را می‌توان در اینجا یافت: \%<https://\:reports\:.kea\:.isc\:.org>\&.
این گزارش شامل توضیحات سخت‌افزار و سناریوی بنچمارک، و همچنین نتایج فعلی است.
.sp
پس از فعال‌سازی چندریسمانی، تعداد ریسمان‌ها با پارامتر \fBthread\-pool\-size\fP تعیین می‌شود. نتایج حاصل از آزمایش‌های ما نشان می‌دهد که بهترین تنظیمات برای \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> عبارتند از:
.INDENT 0.0
.IP \(bu 2
\fBthread\-pool\-size\fP: برابر با 4 هنگام استفاده از \fBmemfile\fP برای ذخیرهٔ اجاره‌ها (leases).
.IP \(bu 2
\fBthread\-pool\-size\fP: برابر با 12 یا بیشتر هنگام استفاده از \fBmysql\fP برای ذخیرهٔ اجاره‌ها.
.IP \(bu 2
\fBthread\-pool\-size\fP: برابر با 6 هنگام استفاده از \fBpostgresql\fP\&.
.UNINDENT
.sp
پارامتر بسیار مهم دیگر \fBpacket\-queue\-size\fP است؛ در بنچمارک‌هایمان ما آن را به عنوان ضریبی از \fBthread\-pool\-size\fP استفاده کردیم. مقدار واقعی به‌شدت به \fBthread\-pool\-size\fP وابسته است.
.sp
ما در بنچمارک‌های خود با تنظیمات زیر به بهترین نتایج دست یافتیم:
.INDENT 0.0
.IP \(bu 2
\fBpacket\-queue\-size\fP: برابر با 150 * \fBthread\-pool\-size\fP هنگام استفاده از \fBmemfile\fP برای ذخیرهٔ اجاره‌ها؛ در مورد ما، این مقدار 150 * 4 = 600 بود. این بدان معناست که در هر لحظه، حداکثر تا ۶۰۰ بسته می‌توانند در صف قرار گیرند.
.IP \(bu 2
\fBpacket\-queue\-size\fP: برابر با 200 * \fBthread\-pool\-size\fP هنگام استفاده از \fBmysql\fP برای ذخیرهٔ اجاره‌ها؛ در مورد ما، این مقدار 200 * 12 = 2400 بود. این بدان معناست که حداکثر تا ۲۴۰۰ بسته می‌توانند در صف قرار گیرند.
.IP \(bu 2
\fBpacket\-queue\-size\fP: برابر با 11 * \fBthread\-pool\-size\fP هنگام استفاده از \fBpostgresql\fP برای ذخیرهٔ اجاره‌ها؛ در مورد ما، این مقدار 11 * 6 = 66 بود.
.UNINDENT
.SS حافظه‌نهان اجاره (Lease Caching)
.sp
کلاینت‌هایی که در بازهٔ زمانی کوتاهی چندین بار تلاش برای تمدید اجاره می‌کنند، می‌توانند باعث شوند سرور به‌طور مکرر پایگاه‌داده را به‌روزرسانی کرده و در آن بنویسد، که نتیجهٔ آن افت کارایی سرور خواهد بود. پارامترهای حافظه‌نهان (cache) به سرور DHCP دستور می‌دهند که از به‌روزرسانی بیش‌ازحد مکرر اجاره‌ها خودداری کند و بدین ترتیب از این رفتار جلوگیری شود. در عوض، سرور همان اجاره را بدون هیچ تغییری تخصیص می‌دهد (یعنی از آن دوباره استفاده می‌کند)، به‌جز CLTT (Client Last Transmission Time)، که نیازی به عملیات دیسک ندارد.
.sp
این دو پارامتر عبارتند از عدد اعشاری \fBcache\-threshold\fP و عدد صحیح \fBcache\-max\-age\fP\&. این پارامترها را می‌توان در سطوح سراسری (global)، شبکهٔ مشترک (shared\-network) و زیرشبکه (subnet) پیکربندی کرد. سطح زیرشبکه نسبت به سطح شبکهٔ مشترک اولویت دارد، در حالی که سطح سراسری به عنوان آخرین چاره استفاده می‌شود. به عنوان مثال:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
\(dqsubnet6\(dq: [
    {
        \(dqsubnet\(dq: \(dq2001:db8:1:1::/64\(dq,
        \(dqpools\(dq: [ { \(dqpool\(dq: \(dq2001:db8:1:1::1:0/112\(dq } ],
        \(dqcache\-threshold\(dq: .25,
        \(dqcache\-max\-age\(dq: 600,
        \(dqvalid\-lifetime\(dq: 2000,
        ...
    }
],
\&...
}
.EE
.UNINDENT
.UNINDENT
.sp
هنگامی که یک اجارهٔ از پیش تخصیص‌یافته بتواند به پرس‌وجوی کلاینت پاسخ دهد:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
هرگونه تغییر مهم، به عنوان مثال در پارامتر DDNS، نام میزبان (hostname)، یا کاهش طول عمر ترجیحی یا معتبر، مانع از استفادهٔ مجدد از اجاره می‌شود.
.IP \(bu 2
عمر اجاره (lease age)، یعنی تفاوت میان زمان ایجاد یا آخرین تغییر با زمان فعلی، محاسبه می‌شود (مدت‌زمان سپری‌شده).
.IP \(bu 2
اگر \fBcache\-max\-age\fP به‌طور صریح پیکربندی شده باشد، با عمر اجاره مقایسه می‌شود؛ اجاره‌هایی که بیش از حد قدیمی باشند قابل استفادهٔ مجدد نیستند. این بدان معناست که مقدار 0 برای \fBcache\-max\-age\fP، قابلیت حافظه‌نهان اجاره را غیرفعال می‌کند.
.IP \(bu 2
اگر \fBcache\-threshold\fP به‌طور صریح پیکربندی شده باشد و بین 0.0 و 1.0 باشد، بیانگر درصدی از طول عمر معتبر (valid lifetime) اجاره است که برای عمر اجاره مجاز است. مقادیر کمتر و مساوی 0.0 و مقادیر بیشتر از 1.0، قابلیت حافظه‌نهان اجاره را غیرفعال می‌کنند.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
در مثال ما، اجاره‌ای با طول عمر معتبر ۲۰۰۰ ثانیه در صورتی می‌تواند مجدداً استفاده شود که کمتر از ۵۰۰ ثانیه پیش ثبت شده باشد. با طول عمر ۳۰۰۰ ثانیه، حداکثر عمر ۶۰۰ ثانیه اعمال می‌شود.
.sp
در پاسخ‌های خروجی به کلاینت (مانند پیام‌های DHCPV6_REPLY)، طول عمرهای ترجیحی و معتبر استفاده‌شده همان مقادیر قابل استفادهٔ مجدد هستند، یعنی تاریخ‌های انقضا تغییر نمی‌کنند..SS رزروهای میزبان در DHCPv6
.sp
موارد متعددی وجود دارد که در آن‌ها ارائهٔ پیکربندی بر مبنای هر میزبان (per\-host) مفید است. بارزترین مورد، رزرو یک نشانی IPv6 یا/و پیشوند مشخص و ایستا برای استفادهٔ انحصاری یک کلاینت (میزبان) خاص است؛ کلاینتِ بازگشتی، هر بار همان نشانی یا/و پیشوند را دریافت می‌کند و سایر کلاینت‌ها هرگز آن نشانی را دریافت نخواهند کرد. همچنین رزروهای میزبان در مواقعی که یک میزبان نیازمندی‌های خاصی دارد، سودمند هستند؛ به عنوان مثال چاپگری که به گزینه‌های DHCP اضافی نیاز دارد یا یک مودم کابلی که به پارامترهای مشخصی نیازمند است. یکی دیگر از موارد کاربرد ممکن، تعریف نام‌های یکتا برای میزبان‌ها است.
.sp
ممکن است مواردی پیش بیاید که یک رزرو جدید برای کلاینتی انجام شده باشد، در حالی که آن نشانی یا پیشوند در حال حاضر توسط کلاینت دیگری استفاده می‌شود. ما این وضعیت را یک \(dqتداخل\(dq می‌نامیم. این تداخل‌ها، همان‌طور که در بخش‌های بعدی توضیح داده شده است، به مرور زمان به صورت خودکار برطرف می‌شوند. به محض برطرف شدن تداخل، کلاینت صحیح در زمان تمدید، پیکربندی رزروشده را دریافت خواهد کرد.
.sp
رزروهای میزبان به عنوان پارامترهایی برای هر زیرشبکه تعریف می‌شوند. هر میزبان باید یا با DUID یا با نشانی سخت‌افزاری/MAC خود شناسایی شود؛ برای جزئیات به MAC/Hardware Addresses in DHCPv6 مراجعه کنید. یک آرایهٔ اختیاری \fBreservations\fP در ساختار \fBsubnet6\fP وجود دارد؛ هر عنصر در آن آرایه ساختاری است که اطلاعات مربوط به رزروها را برای یک میزبان منفرد نگه می‌دارد. به طور خاص، این ساختار دارای یک شناسه است که یک میزبان را به طور یکتا مشخص می‌کند. در زمینهٔ DHCPv6، این شناسه معمولاً یک DUID است، اما می‌تواند یک نشانی سخت‌افزاری یا MAC نیز باشد. همچنین ممکن است یک یا چند نشانی یا پیشوند مشخص شود، و امکان تعیین hostname و گزینه‌های DHCPv6 برای یک میزبان معین وجود دارد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
نشانی رزروشده باید در محدودهٔ زیرشبکه باشد.
این موضوع در مورد پیشوندهای رزروشده صدق نمی‌کند.
.UNINDENT
.UNINDENT
.sp
مثال زیر نحوهٔ رزرو نشانی‌ها و پیشوندها را برای میزبان‌های مشخص نشان می‌دهد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
\(dqsubnet6\(dq: [
    {
        \(dqid\(dq: 1,
        \(dqsubnet\(dq: \(dq2001:db8:1::/48\(dq,
        \(dqpools\(dq: [ { \(dqpool\(dq: \(dq2001:db8:1::/80\(dq } ],
        \(dqpd\-pools\(dq: [
            {
                \(dqprefix\(dq: \(dq2001:db8:1:8000::\(dq,
                \(dqprefix\-len\(dq: 56,
                \(dqdelegated\-len\(dq: 64
            }
        ],
        \(dqreservations\(dq: [
            {
                \(dqduid\(dq: \(dq01:02:03:04:05:0A:0B:0C:0D:0E\(dq,
                \(dqip\-addresses\(dq: [ \(dq2001:db8:1::100\(dq ]
            },
            {
                \(dqhw\-address\(dq: \(dq00:01:02:03:04:05\(dq,
                \(dqip\-addresses\(dq: [ \(dq2001:db8:1::101\(dq, \(dq2001:db8:1::102\(dq ]
            },
            {
                \(dqduid\(dq: \(dq01:02:03:04:05:06:07:08:09:0A\(dq,
                \(dqip\-addresses\(dq: [ \(dq2001:db8:1::103\(dq ],
                \(dqprefixes\(dq: [ \(dq2001:db8:2:abcd::/64\(dq ],
                \(dqhostname\(dq: \(dqfoo.example.com\(dq
            }
        ]
    }
],
\&...
}
.EE
.UNINDENT
.UNINDENT
.sp
این مثال شامل رزروهایی برای سه کلاینت مختلف است. رزرو نخست برای نشانی 2001:db8:1::100 و برای کلاینتی است که از DUID با مقدار 01:02:03:04:05:0A:0B:0C:0D:0E استفاده می‌کند. رزرو دوم برای دو نشانی 2001:db8:1::101 و 2001:db8:1::102 برای کلاینتی است که از نشانی MAC با مقدار 00:01:02:03:04:05 استفاده می‌کند. در نهایت، نشانی 2001:db8:1::103 و پیشوند 2001:db8:2:abcd::/64 برای کلاینتی با DUID مقدار 01:02:03:04:05:06:07:08:09:0A رزرو شده‌اند. آخرین رزرو همچنین یک hostname به این کلاینت اختصاص می‌دهد.
.sp
پروتکل DHCPv6 به یک کلاینت اجازه می‌دهد به طور هم‌زمان چندین نشانی و چندین پیشوند را اجاره کند. بنابراین \fBip\-addresses\fP و \fBprefixes\fP به صورت جمع هستند و در واقع آرایه می‌باشند. هنگامی که کلاینت چندین گزینهٔ IA (از نوع IA_NA یا IA_PD) ارسال می‌کند، هر نشانی یا پیشوند رزروشده به یک IA جداگانه از نوع مناسب اختصاص می‌یابد. اگر تعداد IAهای یک نوع خاص کمتر از تعداد رزروهای آن نوع باشد، تعداد نشانی‌ها یا پیشوندهای رزروشدهٔ اختصاص‌یافته به کلاینت برابر با تعداد IA_NAها یا IA_PDهای ارسال‌شده توسط کلاینت خواهد بود؛ بدین معنی که برخی از نشانی‌ها یا پیشوندهای رزروشده اختصاص نمی‌یابند. با این حال، آن‌ها همچنان برای این کلاینت رزرو باقی می‌مانند و سرور آن‌ها را به هیچ کلاینت دیگری اختصاص نخواهد داد. اگر تعداد IAهای یک نوع خاص که توسط کلاینت ارسال شده است بیشتر از تعداد نشانی‌ها یا پیشوندهای رزروشده باشد، سرور تلاش می‌کند تا تمام نشانی‌ها یا پیشوندهای رزروشده را به تک‌تک IAها اختصاص دهد و نشانی‌ها یا پیشوندها را به صورت پویا به IAهای باقی‌مانده تخصیص دهد. چنانچه سرور نتواند یک نشانی یا پیشوند رزروشده را به دلیل در حال استفاده بودن اختصاص دهد، نشانی یا پیشوند رزروشدهٔ بعدی را انتخاب کرده و تلاش می‌کند آن را به کلاینت اختصاص دهد. اگر سرور متعاقباً دریابد که دیگر هیچ رزروی وجود ندارد که بتوان در آن لحظه به کلاینت اختصاص داد، تلاش خواهد کرد اجاره‌ها را به صورت پویا اختصاص دهد.
.sp
ایجاد رزرو برای یک میزبان متحرک که ممکن است در چندین زیرشبکه رفت‌وآمد داشته باشد، نیازمند تعریف میزبان جداگانه در هر زیرشبکه‌ای است که انتظار می‌رود میزبان در آن حضور یابد. امکان تعریف چندین تعریف میزبان با یک نشانی سخت‌افزاری یکسان در یک زیرشبکهٔ منفرد وجود ندارد. چند تعریف میزبان با یک نشانی سخت‌افزاری یکسان در صورتی معتبر هستند که هر کدام در زیرشبکهٔ متفاوتی باشند. رزرو برای یک میزبان معین باید تنها شامل یک شناسه باشد، یا DUID یا نشانی سخت‌افزاری؛ تعریف هر دو برای یک میزبان، خطای پیکربندی در نظر گرفته می‌شود.
.sp
افزودن رزروهای میزبان باعث افت کارایی می‌شود. در اصل، هنگامی که سروری بدون پشتیبانی از رزرو میزبان به یک پرس‌وجو پاسخ می‌دهد، تنها باید بررسی کند که آیا برای نشانی مورد نظر جهت تخصیص یا تمدید، اجاره‌ای وجود دارد یا خیر. اما سروری که از رزرو میزبان پشتیبانی می‌کند باید بررسی‌های بیشتری انجام دهد: نه تنها این که آیا نشانی در حال حاضر استفاده می‌شود (یعنی آیا اجاره‌ای برای آن وجود دارد یا خیر)، بلکه آیا نشانی می‌تواند توسط شخص دیگری استفاده شود (یعنی آیا رزروی برای آن وجود دارد یا خیر). این بررسی اضافی بار پردازشی بیشتری تحمیل می‌کند..SS انواع رزرو آدرس/پیشوند
.sp
در یک سناریوی معمول Kea، یک زیرشبکه IPv6 تعریف شده است که بخش معینی از آن به تخصیص پویای آدرس توسط کارساز DHCPv6 اختصاص دارد. ممکن است فضای آدرس بیشتری نیز برای واگذاری پیشوند (prefix delegation) تعریف شده باشد. این بخش‌های پویا با عنوان استخرهای پویا، استخرهای آدرس و پیشوند، یا به طور ساده استخرها (pools) شناخته می‌شوند. در اصل، یک رزرو میزبان می‌تواند هر آدرس یا پیشوندی را که متعلق به زیرشبکه است، رزرو کند. به رزروهایی که آدرس‌های متعلق به استخرهای پیکربندی‌شده را مشخص می‌کنند، \(dqرزروهای درون‌استخری\(dq گفته می‌شود. در مقابل، به رزروهایی که متعلق به استخرهای پویا نیستند، \(dqرزروهای بیرون‌استخری\(dq می‌گویند. هیچ تفاوت رسمی‌ای در ساختار نحوی رزرو وجود ندارد و با هر دو نوع رزرو به‌صورت یکسان رفتار می‌شود.
.sp
نرم‌افزار Kea از رزروهای سراسری میزبان پشتیبانی می‌کند. این‌ها رزروهایی هستند که در سطح سراسری در پیکربندی مشخص می‌شوند و متعلق به هیچ زیرشبکهٔ خاصی نیستند. Kea همچنان بسته‌های ورودی کلاینت را مطابق گذشته به یک زیرشبکه تطبیق می‌دهد، اما هنگامی که حالت رزرو زیرشبکه روی \(dqglobal\(dq تنظیم شده باشد، Kea رزروهای میزبان را تنها در میان رزروهای سراسریِ تعریف‌شده جستجو می‌کند. معمولاً چنین رزروهایی برای رزرو نام میزبان کلاینت‌هایی به کار می‌روند که ممکن است از یک زیرشبکه به زیرشبکهٔ دیگر جابجا شوند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
رزروهای سراسری، اگرچه در شرایط خاصی سودمند هستند، اما جنبه‌هایی دارند که هنگام استفاده از آن‌ها باید به‌دقت مد نظر قرار گیرند. لطفاً برای جزئیات بیشتر به بخش «تداخل‌ها در رزروهای DHCPv6» مراجعه کنید.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
از نسخه Kea 1.9.1، حالت رزرو با سه پرچم بولی \fBreservations\-global\fP، \fBreservations\-in\-subnet\fP و \fBreservations\-out\-of\-pool\fP جایگزین شده است که امکان پیکربندی رزروهای میزبان را هم به‌صورت سراسری و هم در یک زیرشبکه فراهم می‌سازند. در چنین مواردی، در صورتی که هر دو رزرو برای یک کلاینت یکسان وجود داشته باشند، رزرو میزبان زیرشبکه بر رزرو سراسری ارجحیت دارد.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
با شروع از Kea 2.7.3، ساختار نحوی رزرو میزبان از مدخل جدیدی با نام \fBexcluded\-prefixes\fP پشتیبانی می‌کند. از این مدخل می‌توان برای مشخص کردن پیشوندهایی که کلاینت باید از پیشوندهای واگذار شده استثنا کند استفاده کرد. در صورت وجود، این مدخل باید دقیقاً تعداد عناصری برابر با مدخل \fBprefixes\fP داشته باشد. هر دو مدخل حاوی رشته‌هایی هستند که پیشوندهای IPv6 را نشان می‌دهند. هر عنصر \fBexcluded\-prefixes\fP باید یک رشتهٔ خالی باشد یا با پیشوند موجود در همان جایگاه در \fBprefixes\fP مطابقت داشته باشد. یک فهرست \fBexcluded\-prefixes\fP خالی یا فهرستی که فقط حاوی رشته‌های خالی باشد را می‌توان حذف کرد. نمونه‌ای که \fB2001:db8:0:1::/64\fP را از \fB2001:db8::/48\fP مستثنی می‌کند در زیر نشان داده شده است:
.UNINDENT
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
\(dqreservations\(dq: [
    {
        \(dqduid\(dq: \(dq01:02:03:04:05:06:07:08:09:0A\(dq,
        \(dqip\-addresses\(dq: [ \(dq2001:db8:1::103\(dq ],
        \(dqprefixes\(dq: [ \(dq2001:db8::/48\(dq ],
        \(dqexcluded\-prefixes\(dq: [ \(dq2001:db8:0:1::/64\(dq ],
        \(dqhostname\(dq: \(dqfoo.example.com\(dq
    }
],
\&...
}
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
از آنجا که رزروهای میزبان نسبت به استخرهای پیشوند اولویت دارند، یک پیشوند رزروشدهٔ فاقد پیشوند استثنا شده، گزینهٔ pd\-exclude را به گزینهٔ پیشوند اضافه نخواهد کرد؛ حتی اگر پیشوند واگذار شده درون یک استخر پیشوند پیکربندی‌شده قرار داشته باشد که یک پیشوند استثنا شده را مشخص کرده است (برخلاف رفتار قبلی).
.UNINDENT
.UNINDENT
.SS تداخل‌ها در رزروهای DHCPv6
.sp
از آنجا که اطلاعات رزرو و اطلاعات اجاره به‌صورت جداگانه ذخیره می‌شوند، ممکن است تداخل رخ دهد. توالی رویدادهای زیر را در نظر بگیرید: کارساز یک استخر پویای آدرس را در بازهٔ 2001:db8::10 تا 2001:db8::20 پیکربندی کرده است. میزبان A درخواست آدرس می‌دهد و 2001:db8::10 را دریافت می‌کند. اکنون مدیر سیستم تصمیم می‌گیرد آدرس 2001:db8::10 را برای میزبان B رزرو کند. به‌طور کلی، رزرو آدرسی که در حال حاضر به شخص دیگری اختصاص داده شده است پیشنهاد نمی‌شود، اما سناریوهای معتبری وجود دارند که انجام چنین عملیاتی در آن‌ها موجه است.
.sp
اکنون کارساز تداخلی دارد که باید برطرف شود. اگر میزبان B راه‌اندازی شود و درخواست آدرس کند، کارساز نمی‌تواند بلافاصله آدرس رزروشدهٔ 2001:db8::10 را به آن تخصیص دهد. یک رویکرد ساده‌لوحانه این خواهد بود که فوراً اجارهٔ میزبان A حذف شده و یک اجارهٔ جدید برای میزبان B ایجاد شود. با این حال، این کار مشکل را حل نمی‌کند، زیرا به محض اینکه میزبان B آدرس را دریافت کند، متوجه می‌شود که این آدرس از قبل (توسط میزبان A) در حال استفاده است و یک پیام DHCPDECLINE ارسال می‌کند. بنابراین، در این وضعیت، کارساز باید موقتاً آدرس متفاوتی از استخر پویا (که با آنچه رزرو شده مطابقت ندارد) را به میزبان B تخصیص دهد.
.sp
هنگامی که میزبان A آدرس خود را تمدید می‌کند، کارساز متوجه می‌شود که آدرس در حال تمدید، اکنون برای فرد دیگری \- میزبان B \- رزرو شده است. کارساز اجارهٔ 2001:db8::10 را حذف کرده، آدرس جدیدی را انتخاب می‌کند و یک اجارهٔ جدید برای آن ایجاد می‌نماید. کارساز در پاسخ خود دو آدرس ارسال می‌کند: آدرس قدیمی با طول عمر (lifetime) تنظیم‌شده روی 0 تا صراحتاً نشان دهد که دیگر معتبر نیست؛ و آدرس جدید با یک طول عمر غیرصفر. هنگامی که میزبان B تلاش می‌کند آدرسِ موقتاً تخصیص‌یافتهٔ خود را تمدید کند، کارساز متوجه می‌شود که اجارهٔ موجود با رزرو مطابقت ندارد، بنابراین آدرس فعلیِ میزبان B را آزاد کرده و یک اجارهٔ جدید منطبق با رزرو می‌سازد. همانند قبل، کارساز دو آدرس ارسال می‌کند: آدرس موقتاً تخصیص‌یافته با طول عمر صفر، و آدرس جدیدِ مطابق با رزرو همراه با طول عمر مناسب.
.sp
این روند بازیابی حتی در صورتی که سایر میزبان‌ها برای دریافت آدرس رزروشده تلاش کنند نیز موفقیت‌آمیز خواهد بود. اگر میزبان C پس از ایجاد رزرو، آدرس 2001:db8::10 را درخواست کند، کارساز آدرس متفاوتی را پیشنهاد خواهد داد.
.sp
این سازوکار بازیابی به کارساز امکان می‌دهد تا از شرایطی که رزروها با اجاره‌های موجود تداخل دارند، به‌طور کامل بازیابی شود؛ هرچند اجرای این فرایند تقریباً به اندازه مقدار تنظیم‌شده برای \fBrenew\-timer\fP زمان می‌برد. بهترین روش برای جلوگیری از چنین روندی، تعریف نکردن رزروهای جدیدی است که با اجاره‌های موجود تداخل داشته باشند. توصیهٔ دیگر، استفاده از رزروهای بیرون‌استخری است؛ اگر آدرس رزروشده متعلق به یک استخر نباشد، کلاینت‌های دیگر به هیچ وجه نمی‌توانند آن را دریافت کنند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
سازوکار حل تداخل برای رزروهای سراسری کار نمی‌کند. اگرچه قابلیت رزرو سراسری آدرس ممکن است در شرایط خاصی کاربردی باشد، اما به‌طور کلی توصیه می‌شود از رزروهای سراسری برای آدرس‌ها استفاده نکنید. مدیرانی که تصمیم به استفاده از رزروهای سراسری می‌گیرند باید به‌صورت دستی اطمینان حاصل کنند که آدرس‌های رزروشده درون استخرهای پویا قرار ندارند.
.UNINDENT
.UNINDENT.SS "رزرو نام میزبان (Reserving a Hostname)"
.sp
هنگامی که رزرو برای یک کلاینت شامل \fBhostname\fP باشد، سرور
این نام میزبان را به کلاینت تخصیص داده و در صورتی که کلاینت گزینهٔ Client
FQDN را در پیام ارسالی خود به سرور گنجانده باشد، آن را در گزینهٔ Client
FQDN بازمی‌گرداند. نام میزبان رزروشده همواره نسبت به نام میزبان
ارائه‌شده توسط کلاینت (از طریق گزینهٔ FQDN) یا نام میزبان تولیدشده به‌صورت خودکار
(از روی نشانی IPv6) اولویت دارد.
.sp
سرور نام میزبان رزروشده را با مقدار پارامتر
\fBddns\-qualifying\-suffix\fP تکمیل می‌کند. برای نمونه، پیکربندی
زیرشبکهٔ زیر:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
\(dqsubnet6\(dq: [
    {
        \(dqid\(dq: 1,
        \(dqsubnet\(dq: \(dq2001:db8:1::/48\(dq,
        \(dqpools\(dq: [ { \(dqpool\(dq: \(dq2001:db8:1::/80\(dq } ],
        \(dqddns\-qualifying\-suffix\(dq: \(dqexample.isc.org.\(dq,
        \(dqreservations\(dq: [
            {
                \(dqduid\(dq: \(dq01:02:03:04:05:0A:0B:0C:0D:0E\(dq,
                \(dqip\-addresses\(dq: [ \(dq2001:db8:1::100\(dq ],
                \(dqhostname\(dq: \(dqalice\-laptop\(dq
            }
        ]
    }
],
\(dqdhcp\-ddns\(dq: {
    \(dqenable\-updates\(dq: true
},
\&...
}
.EE
.UNINDENT
.UNINDENT
.sp
باعث می‌شود نام میزبان \(dqalice\-laptop.example.isc.org.\(dq به
کلاینت دارای DUID با مقدار \(dq01:02:03:04:05:0A:0B:0C:0D:0E\(dq تخصیص یابد. اگر
\fBddns\-qualifying\-suffix\fP مشخص نشده باشد، مقدار پیش‌فرض (خالی)
استفاده خواهد شد و در این حالت مقدار مشخص‌شده برای \fBhostname\fP به عنوان
یک نام کامل دامنه (fully qualified name) در نظر گرفته می‌شود. بنابراین، با خالی گذاشتن
\fBddns\-qualifying\-suffix\fP می‌توان نام‌های میزبان را برای
کلاینت‌های مختلف با نام‌های دامنهٔ متفاوت تکمیل کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqsubnet6\(dq: [
    {
        \(dqid\(dq: 1,
        \(dqsubnet\(dq: \(dq2001:db8:1::/48\(dq,
        \(dqpools\(dq: [ { \(dqpool\(dq: \(dq2001:db8:1::/80\(dq } ],
        \(dqreservations\(dq: [
            {
                \(dqduid\(dq: \(dq01:02:03:04:05:0A:0B:0C:0D:0E\(dq,
                \(dqip\-addresses\(dq: [ \(dq2001:db8:1::100\(dq ],
                \(dqhostname\(dq: \(dqmark\-desktop.example.org.\(dq
            }
        ]
    }
  ],
  \(dqdhcp\-ddns\(dq: {
      \(dqenable\-updates\(dq: true
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
مثال بالا منجر به تخصیص نام میزبان
\(dqmark\-desktop.example.org.\(dq به کلاینت دارای DUID با مقدار
\(dq01:02:03:04:05:0A:0B:0C:0D:0E\(dq می‌شود.
.SS "گنجاندن گزینه‌های خاص DHCPv6 در رزروها (Including Specific DHCPv6 Options in Reservations)"
.sp
نرم‌افزار Kea امکان تعیین گزینه‌ها را بر پایهٔ هر میزبان فراهم می‌کند. این
گزینه‌ها از همان قواعد سایر گزینه‌ها پیروی می‌کنند. این موارد می‌توانند
گزینه‌های استاندارد (بخش Standard DHCPv6 Options را ببینید)،
گزینه‌های سفارشی (بخش Custom DHCPv6 Options را ببینید)،
یا گزینه‌های ویژهٔ سازنده (بخش DHCPv6 Vendor\-Specific Options را ببینید) باشند. مثال
زیر نحوهٔ تعریف گزینه‌های استاندارد را نشان می‌دهد.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
\(dqreservations\(dq: [
{
    \(dqduid\(dq: \(dq01:02:03:05:06:07:08\(dq,
    \(dqip\-addresses\(dq: [ \(dq2001:db8:1::2\(dq ],
    \(dqoption\-data\(dq: [
    {
        \(dqname\(dq: \(dqdns\-servers\(dq,
        \(dqdata\(dq: \(dq3000:1::234\(dq
    },
    {
        \(dqname\(dq: \(dqnis\-servers\(dq,
        \(dqdata\(dq: \(dq3000:1::234\(dq
    },
    ...
    ],
    ...
},
\&...
],
\&...
}
.EE
.UNINDENT
.UNINDENT
.sp
گزینه‌های ویژهٔ سازنده را می‌توان به شیوه‌ای مشابه رزرو کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
\(dqreservations\(dq: [
{
    \(dqduid\(dq: \(dqaa:bb:cc:dd:ee:ff\(dq,
    \(dqip\-addresses\(dq: [ \(dq2001:db8::1\(dq ],
    \(dqoption\-data\(dq: [
    {
        \(dqname\(dq: \(dqvendor\-opts\(dq,
        \(dqdata\(dq: 4491
    },
    {
        \(dqname\(dq: \(dqtftp\-servers\(dq,
        \(dqspace\(dq: \(dqvendor\-4491\(dq,
        \(dqdata\(dq: \(dq3000:1::234\(dq
    },
    ...
    ],
    ...
},
\&...
],
\&...
}
.EE
.UNINDENT
.UNINDENT
.sp
گزینه‌های تعریف‌شده در سطح میزبان بالاترین اولویت را دارند. به بیان دیگر،
اگر گزینه‌هایی با نوع یکسان در سطوح سراسری (global)، زیرشبکه (subnet)،
کلاس (class) و میزبان (host) تعریف شده باشند، مقادیر اختصاصی میزبان استفاده می‌شوند..SS رزرو کلاس‌های کلاینت در DHCPv6
.sp
بخش «استفاده از عبارت‌ها در دسته‌بندی» \%<#\:classification-using-expressions> توضیح می‌دهد که چگونه سرور را پیکربندی کنید تا بر اساس محتوای گزینه‌هایی که کلاینت به سرور ارسال می‌کند، کلاس‌هایی را به آن اختصاص دهد. سازوکارهای رزرو میزبان (Host reservation) نیز امکان تخصیص ایستای کلاس‌ها به کلاینت‌ها را فراهم می‌کنند. تعاریف این کلاس‌ها در فایل پیکربندی Kea یا در یک پایگاه داده قرار می‌گیرند. قطعه‌پیکربندی زیر نشان می‌دهد چگونه مشخص کنید که یک کلاینت متعلق به کلاس‌های \fBreserved\-class1\fP و \fBreserved\-class2\fP است. این کلاس‌ها با گزینه‌های خاصی که به کلاینت‌های متعلق به آن‌ها ارسال می‌شوند، مرتبط هستند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqclient\-classes\(dq: [
    {
       \(dqname\(dq: \(dqreserved\-class1\(dq,
       \(dqoption\-data\(dq: [
       {
           \(dqname\(dq: \(dqdns\-servers\(dq,
           \(dqdata\(dq: \(dq2001:db8:1::50\(dq
       }
       ]
    },
    {
       \(dqname\(dq: \(dqreserved\-class2\(dq,
       \(dqoption\-data\(dq: [
       {
           \(dqname\(dq: \(dqnis\-servers\(dq,
           \(dqdata\(dq: \(dq2001:db8:1::100\(dq
       }
       ]
    }
    ],
    \(dqsubnet6\(dq: [
    {
        \(dqid\(dq: 1,
        \(dqpools\(dq: [ { \(dqpool\(dq: \(dq2001:db8:1::/64\(dq } ],
        \(dqsubnet\(dq: \(dq2001:db8:1::/48\(dq,
        \(dqreservations\(dq: [
        {
            \(dqduid\(dq: \(dq01:02:03:04:05:06:07:08\(dq,

            \(dqclient\-classes\(dq: [ \(dqreserved\-class1\(dq, \(dqreserved\-class2\(dq ]

        }
        ]
    } ]
 }
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
کلاس‌های فهرست‌شده در فهرست \fBclient\-classes\fP یک رزرو، بدون قید و شرط به کلاینتِ آن رزرو اختصاص داده می‌شوند، چه آن کلاس‌ها شامل یک عبارت آزمون (test expression) باشند و چه نباشند. برای جلوگیری از سردرگمی، پیشنهاد می‌شود در کلاس‌های کلاینتی که صرفاً از طریق رزروهای میزبان اختصاص می‌یابند، عبارت‌های آزمون حذف شوند.
.UNINDENT
.UNINDENT
.sp
در برخی موارد، رزروهای میزبان می‌توانند همراه با کلاس‌های کلاینتِ مشخص‌شده در پیکربندی Kea استفاده شوند. به‌ویژه، هنگامی که یک رزرو میزبان برای یک کلاینت در یک زیرشبکه معین وجود دارد، کلاس توکار \(dqKNOWN\(dq به کلاینت اختصاص می‌یابد. در مقابل، هنگامی که هیچ تخصیص ایستایی برای کلاینت وجود ندارد، کلاس \(dqUNKNOWN\(dq به کلاینت اختصاص داده می‌شود. عبارت‌های کلاس در فایل پیکربندی Kea می‌توانند با استفاده از عملگر \(dqmember\(dq به کلاس‌های \(dqKNOWN\(dq یا \(dqUNKNOWN\(dq ارجاع دهند. برای مثال:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqclient\-classes\(dq: [
        {
            \(dqname\(dq: \(dqdependent\-class\(dq,
            \(dqtest\(dq: \(dqmember(\(aqKNOWN\(aq)\(dq,
            \(dqonly\-in\-additional\-list\(dq: true
        }
    ]
}
.EE
.UNINDENT
.UNINDENT
.sp
پارامتر \fBonly\-in\-additional\-list\fP در اینجا برای واداشتنِ ارزیابی کلاس پس از تخصیص اجاره (lease) و در نتیجه پس از تخصیص کلاس رزرو شده لازم است.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
کلاس‌های مشخص‌شده در رزروهای میزبان غیرسراسری (non\-global)، پس از اینکه تمام کلاس‌های دارای پارامتر \fBonly\-in\-additional\-list\fP با مقدار \fBfalse\fP ارزیابی شدند، به بستهٔ پردازش‌شده تخصیص می‌یابند. این بدان معناست که این کلاس‌ها نباید به کلاس‌های تخصیص‌یافتهٔ ایستا از رزروهای میزبان وابسته باشند. اگر چنین وابستگی‌ای لازم باشد، پارامتر \fBonly\-in\-additional\-list\fP برای کلاس‌های وابسته باید روی \fBtrue\fP تنظیم شود. چنین کلاس‌هایی پس از انتساب کلاس‌های ایستا به بسته ارزیابی می‌شوند. با این حال، این امر بار کاری اضافی در پیکربندی ایجاد می‌کند، زیرا تمام کلاس‌های علامت‌گذاری‌شده به عنوان \fBonly\-in\-additional\-list\fP باید در فهرست \fBevaluate\-additional\-classes\fP برای هر زیرشبکه‌ای که در آن استفاده می‌شوند قرار گیرند.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
کلاس‌های کلاینت مشخص‌شده در فایل پیکربندی Kea می‌توانند به کلاس‌های مشخص‌شده در رزروهای میزبان سراسری (global) وابسته باشند. در چنین حالتی به پارامتر \fBonly\-in\-additional\-list\fP نیازی نیست. برای سناریوهای کاربردی خاص، به بخش‌های «Pool Selection with Client Class Reservations» و «Subnet Selection with Client Class Reservations» مراجعه کنید.
.UNINDENT
.UNINDENT.SS ذخیره‌سازی رزروهای میزبان در MySQL یا PostgreSQL
.sp
کارساز Kea می‌تواند رزروهای میزبان را در MySQL یا PostgreSQL ذخیره کند.
برای اطلاعات بیشتر در مورد نحوه پیکربندی Kea جهت استفاده از رزروهای ذخیره‌شده در MySQL یا PostgreSQL، بخش Hosts Storage را ببینید.
کارساز Kea یک قلاب اختصاصی برای مدیریت رزروها در پایگاه‌داده ارائه می‌دهد؛ بخش libdhcp_host_cmds.so: Host Commands \%<#\:hooks-host-cmds> اطلاعات دقیقی را ارائه می‌کند.
ویکی Kea \%<https://\:gitlab\:.isc\:.org/\:isc-projects/\:kea/\:-/\:wikis/\:Designs/\:commands#\:23-host-reservations-hr-management>
چندین مثال از نحوه انجام عملیات رایج رزرو میزبان را ارائه می‌دهد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
در Kea، حداکثر طول گزینه‌ای که به ازای هر میزبان مشخص می‌شود، به‌طور قراردادی روی 4096 بایت تنظیم شده است.
.UNINDENT
.UNINDENT
.SS تنظیم دقیق رزرو میزبان DHCPv6
.sp
قابلیت رزرو میزبان، محدودیت‌های اضافی را برای موتور تخصیص (بخشی از Kea که آدرسی را برای کلاینت انتخاب می‌کند) در طول فرایند انتخاب و تمدید اجاره اعمال می‌کند. به طور خاص، سه بررسی عمده ضروری است. نخست، هنگام انتخاب یک اجاره جدید، تنها آزاد بودن اجاره و عدم استفاده از آن توسط کلاینت DHCP دیگر کافی نیست؛ بلکه نباید برای کلاینت دیگری نیز رزرو شده باشد. به طور مشابه، هنگام تمدید یک اجاره، باید بررسی دیگری انجام شود تا مشخص گردد آیا آدرسی که در حال تمدید است برای کلاینت دیگری رزرو شده است یا خیر. در نهایت، هنگامی که یک میزبان آدرس یا پیشوندی را تمدید می‌کند، کارساز باید بررسی کند که آیا رزروی برای این میزبان وجود دارد یا خیر، که در این صورت به این معنی است که آدرس موجود (تخصیص‌یافته به صورت پویا) باید باطل شده و به جای آن آدرس رزروشده استفاده شود.
.sp
برخی از این بررسی‌ها ممکن است در برخی استقرارها غیرضروری باشند، و انجام ندادن آن‌ها می‌تواند کارایی را بهبود بخشد. کارساز Kea پارامترهای پیکربندی \fBreservations\-global\fP، \fBreservations\-in\-subnet\fP و \fBreservations\-out\-of\-pool\fP را برای انتخاب انواع رزروهای مجاز برای یک زیرشبکه خاص ارائه می‌دهد. هر نوع رزرو، محدودیت‌های متفاوتی برای بررسی‌هایی دارد که کارساز هنگام تخصیص یا تمدید اجاره برای کلاینت باید انجام دهد.
.sp
پرچم‌های پیکربندی عبارتند از:
.INDENT 0.0
.IP \(bu 2
\fBreservations\-in\-subnet\fP \- هنگامی که روی \fBtrue\fP تنظیم شود، انواع رزرو میزبان درون استخر (in\-pool) را فعال می‌کند. این تنظیم مقدار پیش‌فرض بوده و امن‌ترین و انعطاف‌پذیرترین حالت است. با این حال، از آنجا که تمام بررسی‌ها انجام می‌شوند، کندترین حالت نیز هست. این گزینه رزروهای سراسری را بررسی نمی‌کند. مقدار پیش‌فرض این پرچم \fBtrue\fP است.
.IP \(bu 2
\fBreservations\-out\-of\-pool\fP \- هنگامی که روی \fBtrue\fP تنظیم شود، فقط به رزروهای میزبان خارج از استخر (out\-of\-pool) اجازه می‌دهد. در این حالت کارساز فرض می‌کند که تمام رزروهای میزبان برای آدرس‌هایی هستند که متعلق به استخر پویا نیستند. بنابراین، هنگام برخورد با آدرس‌های درون استخر می‌تواند از بررسی‌های رزرو صرف‌نظر کند، و در نتیجه کارایی را بهبود بخشد. اگر هر یک از رزروها از آدرس‌های درون استخر استفاده می‌کنند، از این حالت استفاده نکنید. هنگام استفاده از این تنظیم احتیاط توصیه می‌شود؛ Kea رزروها را در برابر \fBreservations\-out\-of\-pool\fP اعتبارسنجی منطقی نمی‌کند و پیکربندی نادرست ممکن است باعث بروز مشکلاتی شود. مقدار پیش‌فرض این پرچم \fBfalse\fP است.
.IP \(bu 2
\fBreservations\-global\fP \- رزروهای میزبان سراسری را مجاز می‌کند. با اعمال این تنظیم، کارساز رزروهای مربوط به یک کلاینت را در میان رزروهای سراسری تعریف‌شده جستجو می‌کند. اگر آدرسی مشخص شده باشد، کارساز از بررسی‌های رزرو که در سایر حالت‌ها انجام می‌شوند صرف‌نظر کرده، و در نتیجه کارایی را بهبود می‌بخشد. هنگام استفاده از این تنظیم احتیاط توصیه می‌شود؛ زمانی که \fBreservations\-global\fP روی \fBtrue\fP تنظیم شده باشد، Kea رزروها را اعتبارسنجی منطقی نمی‌کند و پیکربندی نادرست ممکن است باعث بروز مشکلاتی شود. مقدار پیش‌فرض این پرچم \fBfalse\fP است.
.UNINDENT
.INDENT 0.0
.TP
.B نکته: تنظیم تمام پرچم‌ها روی \fBfalse\fP پشتیبانی از رزرو میزبان را غیرفعال می‌کند.
از آنجا که هیچ رزروی وجود ندارد، کارساز از تمام بررسی‌ها صرف‌نظر می‌کند. هر رزرو تعریف‌شده کاملاً نادیده گرفته می‌شود. از آنجا که بررسی‌ها نادیده گرفته می‌شوند، کارساز ممکن است در این حالت سریع‌تر عمل کند.
.UNINDENT
.sp
از نسخه 1.9.1 Kea، پرچم‌های \fBreservations\-global\fP، \fBreservations\-in\-subnet\fP و
\fBreservations\-out\-of\-pool\fP پشتیبانی می‌شوند.
.sp
پارامترهای \fBreservations\-global\fP، \fBreservations\-in\-subnet\fP و
\fBreservations\-out\-of\-pool\fP را می‌توان در سطوح زیر مشخص کرد:
.INDENT 0.0
.IP \(bu 2
سطح سراسری: \fB\&.Dhcp6[\(dqreservations\-global\(dq]\fP (کمترین اولویت: توسط تمام سطوح دیگر بازنویسی می‌شود)
.IP \(bu 2
سطح زیرشبکه: \fB\&.Dhcp6.subnet6[][\(dqreservations\-in\-subnet\(dq]\fP (اولویت پایین)
.IP \(bu 2
سطح شبکه مشترک: \fB\&.Dhcp6[\(dqshared\-networks\(dq][][\(dqreservations\-out\-of\-pool\(dq]\fP (اولویت بالا)
.IP \(bu 2
سطح زیرشبکه در شبکه مشترک:
\fB\&.Dhcp6[\(dqshared\-networks\(dq][].subnet6[][\(dqreservations\-out\-of\-pool\(dq]\fP (بالاترین اولویت: بر تمام سطوح دیگر تقدم دارد)
.UNINDENT
.sp
برای تصمیم‌گیری در مورد اینکه کدام پرچم‌ها استفاده شوند، نمودار تصمیم‌گیری زیر ممکن است مفید باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
                              O
                              |
                              v
+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
|         Is per\-host configuration needed, such as          |
|                reserving specific addresses,               |
|               assigning specific options or                |
| assigning packets to specific classes on per\-device basis? |
+\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
  |                 |
no|              yes|
  |                 |   +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
  |                 |   |         For all given hosts,         |
  +\-\-> \(dqdisabled\(dq   +\-\->+      can the reserved resources      |
                        |  be used in all configured subnets?  |
                        +\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-+
                                 |                           |
+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+   |no                         |yes
|             Is             |   |                           |
|  at least one reservation  +<\-\-+               \(dqglobal\(dq <\-\-+
| used to reserve addresses  |
|        or prefixes?        |
+\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-+
  |                        |
no|                     yes|   +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
  |                        |   | Is high leases\-per\-second |
  +\-\-> \(dqout\-of\-pool\(dq       +\-\->+ performance or efficient  |
        ^                      |      resource usage       |
        |                      |  (CPU ticks, RAM usage,   |
        |                      |   database roundtrips)    |
        |                      | important to your setup?  |
        |                      +\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-+
        |                        |                |
        |                     yes|              no|
        |                        |                |
        |          +\-\-\-\-\-\-\-\-\-\-\-\-\-+                |
        |          |                              |
        |          |   +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+   |
        |          |   | Can it be guaranteed |   |
        |          +\-\->+  that the reserved   |   |
        |              |  addresses/prefixes  |   |
        |              |  aren\(aqt part of the  |   |
        |              |   pools configured   |   |
        |              |  in the respective   |   |
        |              |       subnet?        |   |
        |              +\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-+   |
        |                |                  |     |
        |             yes|                no|     |
        |                |                  |     V
        +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+                  +\-\-> \(dqin\-subnet\(dq
.EE
.UNINDENT
.UNINDENT
.sp
یک نمونه پیکربندی که رزروها را غیرفعال می‌کند به صورت زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp6\(dq: {
    \(dqsubnet6\(dq: [
      {
        \(dqid\(dq: 1,
        \(dqpools\(dq: [
          {
            \(dqpool\(dq: \(dq2001:db8:1::\-2001:db8:1::100\(dq
          }
        ],
        \(dqreservations\-global\(dq: false,
        \(dqreservations\-in\-subnet\(dq: false,
        \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq
      }
    ]
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
یک پیکربندی نمونه با استفاده از رزروهای سراسری در زیر نشان داده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp6\(dq: {
    \(dqreservations\-global\(dq: true,
    \(dqreservations\(dq: [
      {
        \(dqduid\(dq: \(dq00:03:00:01:11:22:33:44:55:66\(dq,
        \(dqhostname\(dq: \(dqhost\-one\(dq
      },
      {
        \(dqduid\(dq: \(dq00:03:00:01:99:88:77:66:55:44\(dq,
        \(dqhostname\(dq: \(dqhost\-two\(dq
      }
    ],
    \(dqsubnet6\(dq: [
      {
        \(dqid\(dq: 1,
        \(dqpools\(dq: [
          {
            \(dqpool\(dq: \(dq2001:db8:1::\-2001:db8:1::100\(dq
          }
        ],
        \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq
      }
    ]
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
معنی پرچم‌های رزرو عبارتند از:
.INDENT 0.0.IP \(bu 2
\fBreservations\-global\fP: واکشی رزروهای سراسری.
.IP \(bu 2
\fBreservations\-in\-subnet\fP: واکشی رزروهای زیرشبکه. برای یک shared network
این شامل تمام زیرشبکه‌های عضو آن shared network می‌شود.
.IP \(bu 2
\fBreservations\-out\-of\-pool\fP: این مورد تنها زمانی معنادار است که
پرچم \fBreservations\-in\-subnet\fP برابر با \fBtrue\fP باشد. هنگامی که \fBreservations\-out\-of\-pool\fP
برابر با \fBtrue\fP باشد، کارگزار فرض می‌کند که تمام رزروهای میزبان برای نشانی‌هایی
هستند که متعلق به استخر پویا (dynamic pool) نیستند. بنابراین، می‌تواند هنگام مواجهه
با نشانی‌های درون استخر از بررسی‌های رزرو صرف‌نظر کرده و کارایی را بهبود بخشد.
کارگزار نشانی‌های رزروشده‌ای را که درون استخرهای پویا قرار دارند به کلاینت‌های مربوطه
اختصاص نخواهد داد. این همچنین بدان معناست که نشانی‌های مطابق با رزروهای مربوطه
از درون استخرهای پویا (در صورت وجود) می‌توانند به‌صورت پویا به هر کلاینتی اختصاص داده شوند.
.UNINDENT
.sp
پیکربندی \fBdisabled\fP معادل است با:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp6\(dq: {
    \(dqreservations\-global\(dq: false,
    \(dqreservations\-in\-subnet\(dq: false
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
پیکربندی \fBglobal\fP با استفاده از \fBreservations\-global\fP معادل است با:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp6\(dq: {
    \(dqreservations\-global\(dq: true,
    \(dqreservations\-in\-subnet\(dq: false
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
پیکربندی \fBout\-of\-pool\fP با استفاده از \fBreservations\-out\-of\-pool\fP معادل است با:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp6\(dq: {
    \(dqreservations\-global\(dq: false,
    \(dqreservations\-in\-subnet\(dq: true,
    \(dqreservations\-out\-of\-pool\(dq: true
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
و پیکربندی \fBin\-subnet\fP با استفاده از \fBreservations\-in\-subnet\fP معادل است با:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp6\(dq: {
    \(dqreservations\-global\(dq: false,
    \(dqreservations\-in\-subnet\(dq: true,
    \(dqreservations\-out\-of\-pool\(dq: false
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
برای فعال‌سازی هم‌زمان \fBglobal\fP و \fBin\-subnet\fP، ترکیب زیر می‌تواند استفاده شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp6\(dq: {
    \(dqreservations\-global\(dq: true,
    \(dqreservations\-in\-subnet\(dq: true,
    \(dqreservations\-out\-of\-pool\(dq: false
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
برای فعال‌سازی هم‌زمان \fBglobal\fP و \fBout\-of\-pool\fP، ترکیب زیر می‌تواند
استفاده شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp6\(dq: {
    \(dqreservations\-global\(dq: true,
    \(dqreservations\-in\-subnet\(dq: true,
    \(dqreservations\-out\-of\-pool\(dq: true
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
فعال‌سازی \fBout\-of\-pool\fP و غیرفعال‌سازی هم‌زمان \fBin\-subnet\fP
توصیه نمی‌شود زیرا \fBout\-of\-pool\fP برای رزروهای میزبان در یک
زیرشبکه اعمال می‌شود که فقط در صورت \fBtrue\fP بودن پرچم \fBin\-subnet\fP واکشی می‌شوند.
.sp
این پارامتر می‌تواند در سطوح global، subnet و shared\-network
تعیین شود.
.sp
یک پیکربندی نمونه که رزروها را غیرفعال می‌کند به‌صورت زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp6\(dq: {
    \(dqsubnet6\(dq: [
      {
        \(dqreservations\-global\(dq: false,
        \(dqreservations\-in\-subnet\(dq: false,
        \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
        \(dqid\(dq: 1
      }
    ]
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
یک پیکربندی نمونه با استفاده از رزروهای سراسری در زیر نشان داده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp6\(dq: {
    \(dqreservations\(dq: [
      {
        \(dqduid\(dq: \(dq00:03:00:01:11:22:33:44:55:66\(dq,
        \(dqhostname\(dq: \(dqhost\-one\(dq
      },
      {
        \(dqduid\(dq: \(dq00:03:00:01:99:88:77:66:55:44\(dq,
        \(dqhostname\(dq: \(dqhost\-two\(dq
      }
    ],
    \(dqreservations\-global\(dq: true,
    \(dqreservations\-in\-subnet\(dq: false,
    \(dqsubnet6\(dq: [
      {
        \(dqpools\(dq: [
          {
            \(dqpool\(dq: \(dq2001:db8:1::\-2001:db8:1::100\(dq
          }
        ],
        \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
        \(dqid\(dq: 1
      }
    ]
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
برای جزئیات بیشتر در رابطه با رزروهای سراسری، به بخش Global Reservations in DHCPv6 مراجعه کنید.
.sp
جنبهٔ دیگر رزروهای میزبان، انواع مختلف شناسه‌ها است. Kea در حال حاضر از دو نوع شناسه
در DHCPv6 پشتیبانی می‌کند: نشانی سخت‌افزاری و DUID. این قابلیت از دیدگاه کاربری
مفید است؛ با این حال، یک عیب دارد. برای هر بستهٔ ورودی، Kea باید هر نوع شناسه
را استخراج کرده و سپس پایگاه‌داده را پرس‌وجو کند تا بررسی کند آیا رزروی با این شناسهٔ
خاص وجود دارد یا خیر. اگر چیزی یافت نشد، شناسهٔ بعدی استخراج شده و پرس‌وجوی بعدی
ارسال می‌شود. این فرایند تا زمانی که یک رزرو پیدا شود یا تمام انواع شناسه‌ها بررسی
شوند ادامه می‌یابد. به مرور زمان، با افزایش تعداد انواع شناسه‌های پشتیبانی‌شده، Kea کندتر
و کندتر خواهد شد.
.sp
برای حل این مشکل، پارامتری به نام \fBhost\-reservation\-identifiers\fP
در دسترس است. این پارامتر فهرستی از انواع شناسه را دریافت می‌کند. Kea تنها آن دسته از
انواع شناسه‌ها را که در \fBhost\-reservation\-identifiers\fP ذکر شده‌اند بررسی می‌کند.
از نظر کارایی، تعداد انواع شناسه‌ها باید در حداقل ممکن، در حالت ایده‌آل یک مورد، نگه داشته شود.
اگر در استقرار از چندین نوع رزرو استفاده می‌شود، لطفاً آن‌ها را از پرکاربردترین به کم‌کاربردترین
مرتب کنید، زیرا این کار شانس یافتن رزرو توسط Kea را با کمترین تعداد پرس‌وجو افزایش می‌دهد.
یک نمونه از پیکربندی \fBhost\-reservation\-identifiers\fP به‌صورت زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
\(dqhost\-reservation\-identifiers\(dq: [ \(dqduid\(dq, \(dqhw\-address\(dq ],
\(dqsubnet6\(dq: [
    {
        \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
        ...
    }
],
\&...
}
.EE
.UNINDENT
.UNINDENT
.sp
در صورت عدم تعیین، مقدار پیش‌فرض برابر است با:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqhost\-reservation\-identifiers\(dq: [ \(dqhw\-address\(dq, \(dqduid\(dq ]
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
به‌محض یافتن یک رزرو میزبان، جستجو متوقف می‌شود؛ هنگامی که یک کلاینت
دارای دو رزرو میزبان با استفاده از انواع شناسه‌های فعالِ متفاوت باشد،
همیشه نخستین مورد بازگردانده شده و دومی نادیده گرفته می‌شود.
این حالت معمولاً یک خطای پیکربندی است. در موارد نادری که داشتن دو رزرو
برای یک میزبان منطقی است، موردی که باید استفاده شود را می‌توان با
مرتب‌سازی فهرست انواع شناسه در \fBhost\-reservation\-identifiers\fP تعیین کرد.
.UNINDENT
.UNINDENT.SS "رزروهای سراسری در DHCPv6 (Global Reservations in DHCPv6)"
.sp
در برخی پیاده‌سازی‌ها، مانند شبکه‌های تلفن همراه، کلاینت‌ها می‌توانند در سراسر شبکه جابه‌جا شوند (roam کنند) و پارامترهای خاصی فارغ از مکان فعلی کلاینت باید مشخص گردند. برای برآورده ساختن چنین نیازی، Kea سازوکار رزرو سراسری (global reservation) را ارائه می‌دهد. ایدهٔ نهفته در پس آن این است که رزروهای میزبان معمولی، با استفاده از یک شناسهٔ زیرشبکه (subnet ID) مشخص، به زیرشبکه‌های خاصی وابسته هستند. Kea می‌تواند یک رزرو سراسری را مشخص کند که در تمامی زیرشبکه‌هایی که رزروهای سراسری در آن‌ها فعال است، قابل استفاده باشد.
.sp
این ویژگی می‌تواند برای تخصیص پارامترهای مشخصی مانند hostname یا سایر گزینه‌های اختصاصی و ویژهٔ میزبان (host\-specific) به کار رود. همچنین می‌توان از آن برای تخصیص نشانی‌ها یا پیشوندها استفاده کرد.
.sp
نشانی اختصاص‌یافته از طریق رزرو سراسری میزبان باید برای زیرشبکه‌ای که سرور برای کلاینت انتخاب می‌کند، امکان‌پذیر و معتبر باشد. به عبارت دیگر، نشانی باید در محدودهٔ زیرشبکه قرار داشته باشد؛ در غیر این صورت نادیده گرفته شده و سرور تلاش خواهد کرد نشانی را به‌صورت پویا تخصیص دهد. اگر زیرشبکهٔ انتخاب‌شده متعلق به یک شبکهٔ مشترک (shared network) باشد، سرور امکان‌پذیری را با زیرشبکه‌های همتای آن بررسی کرده و نخستین زیرشبکه‌ای را که نشانی در محدودهٔ آن قرار دارد انتخاب می‌نماید. اگر چنین زیرشبکه‌ای وجود نداشته باشد، سرور به تخصیص پویای نشانی بازمی‌گردد. این موضوع در مورد پیشوندهای رزروشدهٔ سراسری صدق نمی‌کند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
پیش از نسخهٔ 2.3.5، سرور بررسی‌های امکان‌پذیری را بر روی نشانی‌های رزروشدهٔ سراسری انجام نمی‌داد، که این موضوع به سرور اجازه می‌داد تا به‌گونه‌ای پیکربندی شود که اجاره‌های (leases) نامعقولی را برای مقادیر دلخواه نشانی صادر کند. نسخه‌های بعدی Kea این بررسی‌ها را انجام می‌دهند.
.UNINDENT
.UNINDENT
.sp
برای استفاده از رزروهای سراسری میزبان، می‌توان از پیکربندی مشابه زیر استفاده کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    # This specifies global reservations.
    # They will apply to all subnets that
    # have global reservations enabled.

    \(dqreservations\(dq: [
    {
       \(dqhw\-address\(dq: \(dqaa:bb:cc:dd:ee:ff\(dq,
       \(dqhostname\(dq: \(dqhw\-host\-dynamic\(dq
    },
    {
       \(dqhw\-address\(dq: \(dq01:02:03:04:05:06\(dq,
       \(dqhostname\(dq: \(dqhw\-host\-fixed\(dq,

       # Use of IP addresses in global reservations is risky.
       # If used outside of matching subnet, such as 3001::/64,
       # it will result in a broken configuration being handed
       # to the client.
       \(dqip\-address\(dq: \(dq2001:db8:ff::77\(dq
    },
    {
       \(dqduid\(dq: \(dq01:02:03:04:05\(dq,
       \(dqhostname\(dq: \(dqduid\-host\(dq
    }
    ],
    \(dqvalid\-lifetime\(dq: 600,
    \(dqsubnet4\(dq: [ {
        \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
        # Specify if the server should look up global reservations.
        \(dqreservations\-global\(dq: true,
        # Specify if the server should look up in\-subnet reservations.
        \(dqreservations\-in\-subnet\(dq: false,
        # Specify if the server can assume that all reserved addresses
        # are out\-of\-pool. It can be ignored because \(dqreservations\-in\-subnet\(dq
        # is false.
        # \(dqreservations\-out\-of\-pool\(dq: false,
        \(dqpools\(dq: [ { \(dqpool\(dq: \(dq2001:db8:1::\-2001:db8:1::100\(dq } ]
    } ]
}
.EE
.UNINDENT
.UNINDENT
.sp
هنگام استفاده از backendهای پایگاه داده، رزروهای سراسری میزبان با استفاده از مقدار 0 برای \fBsubnet\-id\fP از رزروهای معمولی متمایز می‌شوند.
.SS "انتخاب استخر با رزروهای کلاس کلاینت (Pool Selection with Client Class Reservations)"
.sp
کلاس‌های کلاینت می‌توانند هم در فایل پیکربندی Kea و هم از طریق رزروهای میزبان تعیین شوند. کلاس‌های مشخص‌شده در فایل پیکربندی Kea بلافاصله پس از دریافت بستهٔ DHCP ارزیابی می‌شوند و بنابراین می‌توان از آن‌ها برای تأثیرگذاری بر انتخاب زیرشبکه با استفاده از پارامتر \fBclient\-classes\fP مشخص‌شده در حوزهٔ زیرشبکه (subnet scope) استفاده کرد. کلاس‌های مشخص‌شده درون رزروهای میزبان، پس از آن‌که سرور از قبل زیرشبکه‌ای را برای کلاینت انتخاب کرد، واکشی شده و به بسته اختصاص داده می‌شوند. این بدان معناست که کلاس کلاینت مشخص‌شده درون یک رزرو میزبان نمی‌تواند بر تخصیص زیرشبکه برای این کلاینت تأثیر بگذارد، مگر اینکه زیرشبکه به یک شبکهٔ مشترک (shared network) تعلق داشته باشد. اگر زیرشبکه متعلق به یک شبکهٔ مشترک باشد، سرور ممکن است هنگام تلاش برای تخصیص اجاره (lease)، تخصیص زیرشبکه را به‌طور پویا تغییر دهد. اگر زیرشبکه متعلق به یک شبکهٔ مشترک نباشد، زیرشبکه پس از یک‌بار انتخاب شدن دیگر تغییر نخواهد کرد.
.sp
اگر زیرشبکه متعلق به یک شبکهٔ مشترک نباشد، می‌توان از دسته‌بندی کلاینت مبتنی بر رزرو میزبان برای انتخاب یک استخر (pool) در درون زیرشبکه به صورت زیر استفاده کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqDhcp6\(dq: {
        \(dqclient\-classes\(dq: [
            {
                \(dqname\(dq: \(dqreserved_class\(dq
            },
            {
                \(dqname\(dq: \(dqunreserved_class\(dq,
                \(dqtest\(dq: \(dqnot member(\(aqreserved_class\(aq)\(dq
            }
        ],
        \(dqsubnet6\(dq: [
            {
                \(dqid\(dq: 1,
                \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
                \(dqreservations\(dq: [
                    {
                        \(dqhw\-address\(dq: \(dqaa:bb:cc:dd:ee:fe\(dq,
                        \(dqclient\-classes\(dq: [ \(dqreserved_class\(dq ]
                    }
                ],
                \(dqpools\(dq: [
                    {
                        \(dqpool\(dq: \(dq2001:db8:1::10 \- 2001:db8:1::20\(dq,
                        \(dqclient\-classes\(dq: [ \(dqunreserved_class\(dq ]
                    },
                    {
                        \(dqpool\(dq: \(dq2001:db8:1::30 \- 2001:db8:1::40\(dq,
                        \(dqclient\-classes\(dq: [ \(dqreserved_class\(dq ]
                    },
                    {
                        \(dqpool\(dq: \(dq2001:db8:1::50 \- 2001:db8:1::60\(dq
                    }
                ]
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
کلاس \fBreserved_class\fP بدون پارامتر \fBtest\fP اعلان شده است زیرا تنها می‌تواند از طریق سازوکار رزرو میزبان به یک کلاینت اختصاص یابد. کلاس دوم، یعنی \fBunreserved_class\fP، به کلاینت‌هایی اختصاص می‌یابد که به \fBreserved_class\fP\& تعلق ندارند.
.sp
استخر نخست در زیرشبکه برای کلاینت‌هایی استفاده می‌شود که چنین رزروی ندارند. استخر دوم تنها برای کلاینت‌هایی استفاده می‌شود که رزروی برای \fBreserved_class\fP\& دارند. استخر سوم یک استخر بدون محدودیت برای تمامی کلاینت‌ها است که هم شامل کلاینت‌های \fBreserved_class\fP و هم شامل \fBunreserved_class\fP\& می‌شود.
.sp
این قطعه‌پیکربندی شامل یک رزرو میزبان است که باعث می‌شود کلاینتی با نشانی MAC به مقدار \fBaa:bb:cc:dd:ee:fe\fP به \fBreserved_class\fP\& اختصاص یابد. بنابراین، به این کلاینت نشانی IP از دومین استخر نشانی داده خواهد شد.
.sp
رزروهای تعریف‌شده در زیرشبکه‌ای که متعلق به یک شبکهٔ مشترک است برای کلاینتی که در غیر این صورت تطابق دارد قابل مشاهده نیست، بنابراین نمی‌توان از آن‌ها برای انتخاب استخرها، و به همین ترتیب زیرشبکه‌ها، استفاده کرد..SS انتخاب زیرشبکه با رزروهای کلاس کلاینت (Subnet Selection with Client Class Reservations)
.sp
یک حالت کاربردی خاص وجود دارد که در آن انتخاب زیرشبکه می‌تواند تحت تأثیر کلاس‌های کلاینت مشخص‌شده درون رزروهای میزبان قرار گیرد: زمانی که کلاینت به یک شبکهٔ مشترک (shared network) تعلق دارد. در چنین حالتی، می‌توان از کلاس‌بندی برای انتخاب یک زیرشبکه درون این شبکهٔ مشترک استفاده کرد. مثال زیر را در نظر بگیرید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqDhcp6\(dq: {
        \(dqclient\-classes\(dq: [
            {
                \(dqname\(dq: \(dqreserved_class\(dq
            },
            {
                \(dqname\(dq: \(dqunreserved_class\(dq,
                \(dqtest\(dq: \(dqnot member(\(aqreserved_class\(aq)\(dq
            }
        ],
        \(dqreservations\(dq: [
            {
                \(dqhw\-address\(dq: \(dqaa:bb:cc:dd:ee:fe\(dq,
                \(dqclient\-classes\(dq: [ \(dqreserved_class\(dq ]
            }
        ],
        \(dqreservations\-global\(dq: true,
        \(dqreservations\-in\-subnet\(dq: false,
        \(dqshared\-networks\(dq: [
            {
                \(dqname\(dq: \(dqnet\(dq,
                \(dqsubnet6\(dq: [
                    {
                        \(dqid\(dq: 1,
                        \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
                        \(dqpools\(dq: [
                            {
                                \(dqpool\(dq: \(dq2001:db8:1::10 \- 2001:db8:1::20\(dq,
                                \(dqclient\-classes\(dq: [ \(dqunreserved_class\(dq ]
                            },
                            {
                                \(dqpool\(dq: \(dq2001:db8:1::30 \- 2001:db8:1::40\(dq,
                                \(dqclient\-classes\(dq: [ \(dqunreserved_class\(dq ]
                            }
                        ]
                    },
                    {
                        \(dqid\(dq: 2,
                        \(dqsubnet\(dq: \(dq2001:db8:2::/64\(dq,
                        \(dqpools\(dq: [
                            {
                                \(dqpool\(dq: \(dq2001:db8:2::10 \- 2001:db8:2::20\(dq,
                                \(dqclient\-classes\(dq: [ \(dqreserved_class\(dq ]
                            },
                            {
                                \(dqpool\(dq: \(dq2001:db8:2::30 \- 2001:db8:2::40\(dq,
                                \(dqclient\-classes\(dq: [ \(dqreserved_class\(dq ]
                            }
                        ]
                    },
                    {
                        \(dqid\(dq: 3,
                        \(dqsubnet\(dq: \(dq2001:db8:3::/64\(dq,
                        \(dqpools\(dq: [
                            {
                                \(dqpool\(dq: \(dq2001:db8:3::10 \- 2001:db8:3::20\(dq
                            },
                            {
                                \(dqpool\(dq: \(dq2001:db8:3::30 \- 2001:db8:3::40\(dq
                            }
                        ]
                    }
                ]
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این مشابه مثالی است که در «Pool Selection with Client Class Reservations» شرح داده شد. با این حال، این بار سه زیرشبکه وجود دارد که استخر هر یک از دو تای اول با یک کلاس متفاوت مرتبط شده است.
.sp
به کلاینت‌هایی که رزروی برای \fBreserved_class\fP ندارند، نشانی‌ای از زیرشبکهٔ اول اختصاص می‌یابد و پس از پر شدن آن، از زیرشبکهٔ سوم. به کلاینت‌هایی با رزرو برای \fBreserved_class\fP، نشانی‌ای از زیرشبکهٔ دوم اختصاص می‌یابد و پس از پر شدن آن، از زیرشبکهٔ سوم.
.sp
زیرشبکه‌ها باید متعلق به همان شبکهٔ مشترک باشند.
.sp
برای اینکه یک زیرشبکه به کلاسی خاص محدود شود یا نادیده گرفته شود، تمامی استخرهای درون آن زیرشبکه باید به ترتیب توسط \fBreserved_class\fP یا \fBunreserved_class\fP محافظت شوند.
.sp
علاوه بر این، رزرو برای کلاس کلاینت باید در حوزهٔ سراسری (رزرو سراسری) تعیین شده باشد و \fBreservations\-global\fP نیز روی \fBtrue\fP تنظیم شده باشد\&.
.sp
در مثال بالا، پارامتر پیکربندی \fBclient\-classes\fP می‌توانست به جای سطح استخر، در سطح زیرشبکه نیز مشخص شود و همان نتیجه را در بر داشته باشد.
.sp
اگر زیرشبکه‌ها بیرون از شبکه‌های مشترک تعریف شده بودند و \fBclient\-classes\fP در سطح زیرشبکه مشخص شده بود، آن‌گاه \fBearly\-global\-reservations\-lookup\fP نیز باید فعال می‌شد تا انتخاب زیرشبکه به درستی کار کند.
.SS چند رزرو برای یک IP یکسان (Multiple Reservations for the Same IP)
.sp
رزروهای میزبان طوری طراحی شده بودند تا از ایجاد چندین رزرو برای یک نشانی IP یا پیشوند واگذارشده (delegated prefix) یکسان در یک زیرشبکهٔ خاص جلوگیری کنند، تا از رقابت دو کلاینت مختلف بر سر یک اجاره (lease) یکسان پرهیز شود. هنگام استفاده از تنظیمات پیش‌فرض، سرور هنگامی که دو یا چند رزرو را برای یک اجارهٔ یکسان درون یک زیرشبکه در فایل پیکربندی Kea بیابد، یک خطای پیکربندی برمی‌گرداند.
\fBlibdhcp_host_cmds.so\fP \%<#\:std-ischooklib-libdhcp_host_cmds\:.so> در پاسخ به دستور
\fBreservation\-add\fP \%<#\:std-isccmd-reservation-add> هنگامی که تشخیص دهد رزروی در پایگاه داده برای اجاره‌ای که رزرو جدید برای آن افزوده می‌شود وجود دارد، یک خطا برمی‌گرداند.
.sp
مشابه با DHCPv4 (ببینید Multiple Reservations for the Same IP \%<#\:multiple-reservations-same-ip4>)، سرور DHCPv6
نیز می‌تواند پیکربندی شود تا امکان ایجاد چندین رزرو برای یک نشانی IPv6 و/یا پیشوند واگذارشدهٔ یکسان در یک زیرشبکهٔ معین را فراهم کند. این
قابلیت از انتشار 1.9.1 برنامهٔ Kea به عنوان یک حالت عملیاتی اختیاری پشتیبانی می‌شود که
با پارامتر سراسری \fBip\-reservations\-unique\fP فعال می‌گردد.
.sp
پارامتر \fBip\-reservations\-unique\fP یک پارامتر بولی (boolean) است که مقدار پیش‌فرض آن
\fBtrue\fP است و تعیین بیش از یک رزرو را برای همان اجاره در یک زیرشبکهٔ معین ممنوع می‌کند. تنظیم این پارامتر روی \fBfalse\fP
اجازه می‌دهد چنین رزروهایی هم در فایل پیکربندی Kea و هم در بک‌اند پایگاه دادهٔ میزبان،
از طریق \fBlibdhcp_host_cmds.so\fP \%<#\:std-ischooklib-libdhcp_host_cmds\:.so> ایجاد شوند\&.
.sp
تنظیم \fBip\-reservations\-unique\fP روی \fBfalse\fP هنگام استفاده از memfile، MySQL یا PostgreSQL پشتیبانی می‌شود.
این تنظیم هنگام استفاده از Host Cache (ببینید libdhcp_host_cache.so: Host Cache Reservations for Improved Performance \%<#\:hooks-host-cache>) یا بک‌اند RADIUS
(ببینید libdhcp_radius.so: RADIUS Server Support \%<#\:hooks-radius>) پشتیبانی نمی‌شود. این بک‌اندهای رزرو از چندین رزرو برای
یک IP یکسان پشتیبانی نمی‌کنند؛ اگر هر یک از این هوک‌ها بارگیری شده باشد و \fBip\-reservations\-unique\fP روی \fBfalse\fP تنظیم شود، خطای
پیکربندی صادر شده و راه‌اندازی سرور ناموفق خواهد بود.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
هنگامی که \fBip\-reservations\-unique\fP روی \fBtrue\fP (مقدار پیش‌فرض) تنظیم است،
سرور اطمینان حاصل می‌کند که رزروهای IP برای یک زیرشبکه درون یک بک‌اند میزبان واحد و/یا
فایل پیکربندی Kea یکتا هستند. این امر یکتا بودن رزروها را در میان چندین بک‌اند
تضمین نمی‌کند. در زمان راه‌اندازی سرور، تنها یکتا بودن رزروهای IP تعریف‌شده در فایل پیکربندی Kea
بررسی می‌شود.
.UNINDENT
.UNINDENT
.sp
در ادامه یک پیکربندی نمونه با دو رزرو برای نشانی IPv6 یکسان اما با نشانی‌های MAC متفاوت آمده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqip\-reservations\-unique\(dq: false,
    \(dqsubnet6\(dq: [
        {
            \(dqid\(dq: 1,
            \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
            \(dqreservations\(dq: [
                {
                    \(dqhw\-address\(dq: \(dq1a:1b:1c:1d:1e:1f\(dq,
                    \(dqip\-address\(dq: \(dq2001:db8:1::11\(dq
                },
                {
                    \(dqhw\-address\(dq: \(dq2a:2b:2c:2d:2e:2f\(dq,
                    \(dqip\-address\(dq: \(dq2001:db8:1::11\(dq
                }
            ]
        }
    ]
}
.EE
.UNINDENT
.UNINDENT
.sp
کنترل پارامتر \fBip\-reservations\-unique\fP از طریق Configuration Backend در DHCPv6 امکان‌پذیر است\&. اگر تنظیم جدید این پارامتر با
بک‌اندهای مورد استفادهٔ فعلی تداخل داشته باشد (یعنی بک‌اندها از تنظیم جدید پشتیبانی نکنند)،
تنظیم جدید نادیده گرفته شده و یک پیام ثبت وقایع هشداری تولید می‌شود.
بک‌اندها با این انتظار که رزروهای IP در هر زیرشبکه یکتا هستند، به استفاده از تنظیم پیش‌فرض ادامه می‌دهند.
برای فراهم کردن امکان ایجاد رزروهای IP غیریکتا، مدیر سیستم باید بک‌اندهایی را که از آن‌ها
پشتیبانی نمی‌کنند از فایل پیکربندی حذف کند.
.sp
مدیران سیستم باید هنگام استفاده از چندین رزرو برای یک نشانی IP و/یا پیشوند واگذارشدهٔ یکسان،
در صورتی که بعداً تصمیم به بازگشت به حالت پیش‌فرض (که در آن این کار دیگر مجاز نیست) بگیرند، مراقب باشند.
آن‌ها باید پیش از بازگشت به حالت پیش‌فرض، اطمینان حاصل کنند که حداکثر یک رزرو برای
یک نشانی IP یا پیشوند واگذارشدهٔ مشخص در یک زیرشبکه وجود دارد. اگر چنین موارد تکراری در
فایل پیکربندی باقی بمانند، سرور خطای پیکربندی گزارش می‌دهد.
باقی گذاشتن چنین رزروهایی در پایگاه‌های دادهٔ میزبان باعث خطای پیکربندی نمی‌شود،
اما ممکن است در حین کارکرد سرور، هنگامی که به طور غیرمنتظره چندین رزرو برای همان نشانی IP یا
پیشوند واگذارشده پیدا می‌کند، منجر به خطاهای تخصیص اجاره (lease) شود.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
در حال حاضر، سرور Kea بررسی نمی‌کند که آیا هنگام به‌روزرسانی \fBip\-reservations\-unique\fP از \fBfalse\fP به \fBtrue\fP،
چندین رزرو برای یک نشانی IP و/یا پیشوند واگذارشدهٔ یکسان در پایگاه‌های دادهٔ میزبان
(MySQL و/یا PostgreSQL) وجود دارد یا خیر\&. این موضوع ممکن است باعث بروز مشکلاتی در
تخصیص اجاره‌ها شود. مدیر سیستم باید پیش از به‌روزرسانی پیکربندی اطمینان حاصل کند که
حداکثر یک رزرو برای هر نشانی IP و/یا پیشوند واگذارشده در هر زیرشبکه وجود دارد.
.UNINDENT
.UNINDENT
.sp
پارامتر \fBreservations\-lookup\-first\fP یک پارامتر بولی است که کنترل می‌کند آیا
جستجوی رزروهای میزبان باید پیش از جستجوی اجاره انجام شود یا خیر. این پارامتر
تنها زمانی مؤثر است که چندریسمانی (multi\-threading) غیرفعال باشد. هنگامی که چندریسمانی
فعال باشد، جستجوی رزروهای میزبان همواره ابتدا انجام می‌شود تا از قفل شدن منابع جستجوی اجاره
جلوگیری گردد. پارامتر \fBreservations\-lookup\-first\fP در صورت غیرفعال بودن چندریسمانی،
به طور پیش‌فرض روی \fBfalse\fP تنظیم است..SS رزرو میزبان به‌عنوان کنترل دسترسی پایه
.sp
تعریف یک رزرو میزبان (host reservation) که تنها شامل یک شناسه‌گر است، بدون هیچ نشانی، گزینه یا مقداری، امکان‌پذیر است. در برخی از پیاده‌سازی‌ها این کار مفید است، زیرا میزبان‌هایی که دارای رزرو هستند به کلاس KNOWN تعلق می‌گیرند در حالی که سایرین تعلق ندارند. این قابلیت می‌تواند به‌عنوان یک سازوکار ابتدایی برای کنترل دسترسی استفاده شود.
.sp
مثال زیر این مفهوم را نشان می‌دهد. این مثال یک زیرشبکه IPv6 منفرد را مشخص می‌کند که تمام کلاینت‌ها نشانی خود را از آن دریافت می‌کنند. با این حال، تنها کلاینت‌های شناخته‌شده (آن‌هایی که رزرو دارند) سرور DNS پیش‌فرض خود را پیکربندی‌شده دریافت خواهند کرد. رزروهای خالی، یعنی رزروهایی که فقط معیار شناسایی دارند، می‌توانند روشی مفید برای شناخته‌شده کردن کلاینت‌ها باشند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqclient\-classes\(dq: [
        {
            \(dqname\(dq: \(dqKNOWN\(dq,
            \(dqoption\-data\(dq: [
                {
                    \(dqname\(dq: \(dqdns\-servers\(dq,
                    \(dqdata\(dq: \(dq2001:db8::1\(dq
                }
            ]
        }
    ],
    \(dqreservations\(dq: [
        // Clients on this list will be added to the KNOWN class.
        { \(dqduid\(dq: \(dq01:02:03:04:05:0A:0B:0C:0D:0E\(dq },
        { \(dqduid\(dq: \(dq02:03:04:05:0A:0B:0C:0D:0E:0F\(dq }
    ],
    \(dqreservations\-global\(dq: true,

    \(dqsubnet6\(dq: [
        {
            \(dqid\(dq: 1,
            \(dqsubnet\(dq: \(dq2001:db8:1::/48\(dq,
            \(dqpools\(dq: [
                {
                    \(dqpool\(dq: \(dq2001:db8:1:1::/64\(dq
                }
            ]
        }
    ]
}
.EE
.UNINDENT
.UNINDENT
.sp
این مفهوم می‌تواند با استفاده از رزروها همراه با برچسب‌گذاری کلاس گزینه‌ها (بخش Option Class\-Tagging \%<#\:option-class-tagging> را ببینید) بیشتر گسترش یابد. یک سناریوی واقعی مناسب می‌تواند وضعیتی باشد که در آن برخی از مشترکان یک ISP صورت‌حساب‌های خود را پرداخت نکرده‌اند. به این مشتریان باید یک سرور DNS جایگزین تخصیص داده شود که به جای ارائه دسترسی به اینترنت، آن‌ها را به یک پورتال اسارتی (captive portal) هدایت کرده و از آن‌ها بخواهد حساب‌های خود را تسویه کنند. می‌توان از رزروها برای تخصیص یک کلاینت به کلاس \(dqblocked\(dq استفاده کرد که متعاقباً برای تعیین مقدار گزینه سرور DNS همان‌طور که در زیر نشان داده شده، به کار می‌رود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqclient\-classes\(dq: [
        {
            \(dqname\(dq: \(dqblocked\(dq
        }
    ],
    \(dqreservations\(dq: [
        // Clients on this list will be added to the KNOWN class. Some
        // will also be added to the blocked class.
        { \(dqduid\(dq: \(dq01:02:03:04:05:0A:0B:0C:0D:0E\(dq,
          \(dqclient\-classes\(dq: [ \(dqblocked\(dq ] },
        { \(dqduid\(dq: \(dq02:03:04:05:0A:0B:0C:0D:0E:0F\(dq }
    ],
    \(dqreservations\-global\(dq: true,

    \(dqsubnet6\(dq: [
        {
            \(dqid\(dq: 1,
            \(dqsubnet\(dq: \(dq2001:db8:1::/48\(dq,
            \(dqpools\(dq: [
                {
                    \(dqpool\(dq: \(dq2001:db8:1:1::/64\(dq
                }
            ],
            \(dqoption\-data\(dq: [
                {
                    // DNS server for blocked customers.
                    \(dqclient\-classes\(dq: [ \(dqblocked\(dq ],
                    \(dqname\(dq: \(dqdns\-servers\(dq,
                    \(dqdata\(dq: \(dq2001:db8::2\(dq
                },
                {
                    // DNS server for customers in good standing.
                    \(dqname\(dq: \(dqdns\-servers\(dq,
                    \(dqdata\(dq: \(dq2001:db8::1\(dq
                }
            ]
        }
    ]
}
.EE
.UNINDENT
.UNINDENT
.SS شبکه‌های اشتراکی در DHCPv6
.sp
سرورهای DHCP از اطلاعات زیرشبکه به دو روش استفاده می‌کنند. این اطلاعات هم برای تعیین نقطه اتصال (یعنی جایی که کلاینت به شبکه متصل است) و هم برای گروه‌بندی اطلاعات مربوط به یک مکان خاص در شبکه به کار می‌رود. گاهی اوقات استقرار بیش از یک زیرشبکه منطقی IP روی یک پیوند فیزیکی (physical link) یکسان مفید است. درک این موضوع که دو یا چند زیرشبکه روی یک پیوند یکسان استفاده می‌شوند، نیازمند منطق اضافی در سرور DHCP است. این قابلیت در Kea با نام \(dqshared networks\(dq (شبکه‌های اشتراکی) و گاهی نیز \(dqshared subnets\(dq نامیده می‌شود؛ در نام‌گذاری مایکروسافت، به آن \(dqmultinet\(dq گفته می‌شود.
.sp
موارد زیادی وجود دارد که ویژگی شبکه‌های اشتراکی در آن‌ها مفید است؛ در اینجا تنها به چند مورد از رایج‌ترین آن‌ها اشاره می‌کنیم. نخستین و تا حد زیادی متداول‌ترین مورد استفاده، یک شبکه IPv4 موجود است که گسترش یافته و فضای نشانی دردسترس آن رو به اتمام است. این موضوع در IPv6 کمتر رایج است، اما شبکه‌های اشتراکی همچنان مفید هستند: برای مثال، هنگام اتمام پیشوندهای واگذارشده (delegated prefixes) در IPv6 در یک زیرشبکه، یا تمایل به آزمایش یک طرح آدرس‌دهی جدید. با ظهور استقرار IPv6 و فضای نشانی گسترده، بسیاری از سازمان‌ها فضای نشانی را به زیرشبکه‌ها تقسیم کرده، آن را مستقر می‌کنند و سپس پس از مدتی متوجه می‌شوند که می‌خواهند آن را به شکل متفاوتی تقسیم‌بندی کنند. در دوره گذار، آن‌ها می‌خواهند هر دو آدرس‌دهی قدیمی و جدید در دسترس باشند؛ بنابراین به بیش از یک زیرشبکه روی یک پیوند فیزیکی یکسان نیاز خواهد بود.
.sp
در نهایت، مورد شبکه‌های کابلی مستقیماً در IPv6 کاربرد دارد. در شبکه‌های کابلی دو نوع دستگاه وجود دارد: مودم‌های کابلی و دستگاه‌های کاربر نهایی پشت آن‌ها. این یک روش معمول است که برای مودم‌های کابلی از زیرشبکه‌های متفاوتی استفاده شود تا از دستکاری آن‌ها توسط کاربران جلوگیری گردد. در این حالت، تمایز به جای اتمام فضای نشانی، بر اساس نوع دستگاه است.
.sp
به کلاینتی که به یک شبکه اشتراکی متصل است، ممکن است یک اجاره (نشانی یا پیشوند) از هر یک از استخرهای تعریف‌شده در زیرشبکه‌های متعلق به آن شبکه اشتراکی تخصیص داده شود. در داخل، سرور یکی از زیرشبکه‌های متعلق به یک شبکه اشتراکی را انتخاب کرده و تلاش می‌کند یک اجاره را از این زیرشبکه تخصیص دهد. اگر سرور نتواند اجاره‌ای را از زیرشبکه انتخابی تخصیص دهد (به‌عنوان مثال، به دلیل اتمام استخر)، از زیرشبکه دیگری در همان شبکه اشتراکی استفاده کرده و تلاش می‌کند اجاره را از آن تخصیص دهد. سرور معمولاً تمام اجاره‌های موجود در یک زیرشبکه مشخص را پیش از شروع تخصیص اجاره‌ها از سایر زیرشبکه‌های متعلق به همان شبکه اشتراکی واگذار می‌کند. با این حال، در شرایط خاصی ممکن است پیش از اتمام استخرهای زیرشبکه نخست، به کلاینت اجاره‌ای از زیرشبکه دیگری تخصیص یابد؛ این اتفاق گاهی زمانی رخ می‌دهد که کلاینت یک راهنمایی (hint) متعلق به زیرشبکه‌ای دیگر ارائه دهد، یا اینکه کلاینت دارای رزروهایی در زیرشبکه‌ای غیر از زیرشبکه پیش‌فرض باشد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
در پیاده‌سازی‌ها نباید این فرض در نظر گرفته شود که Kea پیش از تخصیص نشانی‌ها از سایر زیرشبکه‌ها، حتماً منتظر می‌ماند تا تمام نشانی‌های زیرشبکه نخست در یک شبکه اشتراکی را تخصیص دهد.
.UNINDENT
.UNINDENT
.sp
برای تعریف یک شبکه اشتراکی، یک دامنه پیکربندی اضافی معرفی شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
\(dqDhcp6\(dq: {
    \(dqshared\-networks\(dq: [
        {
        # Name of the shared network. It may be an arbitrary string
        # and it must be unique among all shared networks.
        \(dqname\(dq: \(dqipv6\-lab\-1\(dq,

        # The subnet selector can be specified on the shared network
        # level. Subnets from this shared network will be selected
        # for clients communicating via relay agent having
        # the specified IP address.
        \(dqrelay\(dq: {
            \(dqip\-addresses\(dq: [ \(dq2001:db8:2:34::1\(dq ]
        },

        # This starts a list of subnets in this shared network.
        # There are two subnets in this example.
        \(dqsubnet6\(dq: [
            {
                \(dqid\(dq: 1,
                \(dqsubnet\(dq: \(dq2001:db8::/48\(dq,
                \(dqpools\(dq: [ { \(dqpool\(dq:  \(dq2001:db8::1 \- 2001:db8::ffff\(dq } ]
            },
            {
                \(dqid\(dq: 2,
                \(dqsubnet\(dq: \(dq3ffe:ffe::/64\(dq,
                \(dqpools\(dq: [ { \(dqpool\(dq:  \(dq3ffe:ffe::/64\(dq } ]
            }
        ]
        }
    ],
    # end of shared\-networks

    # It is likely that in the network there will be a mix of regular,
    # \(dqplain\(dq subnets and shared networks. It is perfectly valid
    # to mix them in the same configuration file.
    #
    # This is a regular subnet. It is not part of any shared\-network.
    \(dqsubnet6\(dq: [
        {
            \(dqid\(dq: 3,
            \(dqsubnet\(dq: \(dq2001:db9::/48\(dq,
            \(dqpools\(dq: [ { \(dqpool\(dq:  \(dq2001:db9::/64\(dq } ],
            \(dqrelay\(dq: {
                \(dqip\-addresses\(dq: [ \(dq2001:db8:1:2::1\(dq ]
            }
        }
    ]
}
}
.EE
.UNINDENT
.UNINDENT
.sp
همان‌طور که در مثال نشان داده شد، امکان ترکیب زیرشبکه‌های اشتراکی و زیرشبکه‌های عادی (\(dqplain\(dq) وجود دارد. هر شبکه اشتراکی باید یک نام یکتا داشته باشد. این شبیه به شناسه (ID) برای زیرشبکه‌ها است، اما به مدیران سیستم انعطاف‌پذیری بیشتری می‌دهد. این نام برای ثبت وقایع و همچنین به طور داخلی برای شناسایی شبکه‌های اشتراکی استفاده می‌شود.
.sp
در اصل منطقی است که تنها شبکه‌های اشتراکی‌ای تعریف شوند که از دو یا چند زیرشبکه تشکیل شده باشند. با این حال، برای اهداف آزمایشی، یک زیرشبکه خالی یا شبکه‌ای با تنها یک زیرشبکه مجاز است. این یک روش توصیه‌شده در شبکه‌های عملیاتی نیست، زیرا منطق شبکه اشتراکی نیازمند پردازش اضافی است و در نتیجه کارایی سرور را کاهش می‌دهد. برای جلوگیری از افت غیرضروری کارایی، زیرشبکه‌های اشتراکی تنها باید در صورتی تعریف شوند که شرایط پیاده‌سازی آن را ایجاب کند.
.sp
شبکه‌های اشتراکی این امکان را فراهم می‌کنند که پارامترهای متعددی در دامنه شبکه اشتراکی مشخص شوند که بر تمام زیرشبکه‌های درون آن اعمال گردند. در صورت لزوم، می‌توان پارامتری را در دامنه shared\-network مشخص کرد و سپس مقدار آن را در دامنه زیرشبکه بازنویسی (override) نمود. برای مثال:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
\(dqshared\-networks\(dq: [
    {
        \(dqname\(dq: \(dqlab\-network3\(dq,
        \(dqrelay\(dq: {
             \(dqip\-addresses\(dq: [ \(dq2001:db8:2:34::1\(dq ]
        },

        # This applies to all subnets in this shared network, unless
        # values are overridden on subnet scope.
        \(dqvalid\-lifetime\(dq: 600,

        # This option is made available to all subnets in this shared
        # network.
        \(dqoption\-data\(dq: [ {
            \(dqname\(dq: \(dqdns\-servers\(dq,
            \(dqdata\(dq: \(dq2001:db8::8888\(dq
        } ],

        \(dqsubnet6\(dq: [
            {
                \(dqid\(dq: 1,
                \(dqsubnet\(dq: \(dq2001:db8:1::/48\(dq,
                \(dqpools\(dq: [ { \(dqpool\(dq:  \(dq2001:db8:1::1 \- 2001:db8:1::ffff\(dq } ],

                # This particular subnet uses different values.
                \(dqvalid\-lifetime\(dq: 1200,
                \(dqoption\-data\(dq: [
                {
                    \(dqname\(dq: \(dqdns\-servers\(dq,
                    \(dqdata\(dq: \(dq2001:db8::1:2\(dq
                },
                {
                    \(dqname\(dq: \(dqunicast\(dq,
                    \(dqdata\(dq: \(dq2001:abcd::1\(dq
                } ]
            },
            {
                 \(dqid\(dq: 2,
                 \(dqsubnet\(dq: \(dq2001:db8:2::/48\(dq,
                 \(dqpools\(dq: [ { \(dqpool\(dq:  \(dq2001:db8:2::1 \- 2001:db8:2::ffff\(dq } ],

                 # This subnet does not specify its own valid\-lifetime value,
                 # so it is inherited from shared network scope.
                 \(dqoption\-data\(dq: [
                 {
                     \(dqname\(dq: \(dqdns\-servers\(dq,
                     \(dqdata\(dq: \(dq2001:db8:cafe::1\(dq
                 } ]
            }
        ]
    }
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
در این مثال، گزینه \fBdns\-servers\fP به‌گونه‌ای تعریف شده که برای کلاینت‌ها در هر دو زیرشبکه این شبکه اشتراکی در دسترس است. همچنین، طول عمر معتبر (valid lifetime) روی ۱۰ دقیقه (۶۰۰ ثانیه) تنظیم شده است. با این حال، زیرشبکه نخست برخی از مقادیر را بازنویسی می‌کند (طول عمر معتبر ۲۰ دقیقه است، نشانی IP متفاوتی برای \fBdns\-servers\fP وجود دارد)، و همچنین گزینه اختصاصی خود را اضافه می‌کند (نشانی تک‌پخشی یا unicast). با فرض اینکه به کلاینتی که درخواست گزینه‌های server unicast و \fBdns\-servers\fP را دارد، اجاره‌ای از این زیرشبکه تخصیص یابد، اجاره‌ای به مدت ۲۰ دقیقه و گزینه \fBdns\-servers\fP را دریافت خواهد کرد و مجاز به استفاده از تک‌پخشی سرور در نشانی 2001:abcd::1 خواهد بود. اگر همان کلاینت به زیرشبکه دوم تخصیص داده شود، یک اجاره ۱۰ دقیقه‌ای، مقدار 2001:db8:cafe::1 برای \fBdns\-servers\fP دریافت خواهد کرد و هیچ نشانی تک‌پخشی سروری نخواهد داشت.
.sp
برخی پارامترها باید در تمام زیرشبکه‌های واقع در یک شبکه اشتراکی یکسان باشند. این محدودیت برای تنظیمات \fBinterface\fP و \fBrapid\-commit\fP اعمال می‌شود. راحت‌ترین روش، تعریف آن‌ها در دامنه shared\-network است، اما می‌توان آن‌ها را برای هر زیرشبکه نیز مشخص کرد. با این حال، هر زیرشبکه باید دارای مقدار یکسانی باشد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
هنگام استفاده از کلاینت‌هایی که چندین گزینه IA را در یک درخواست منفرد ارسال می‌کنند، و شبکه‌های اشتراکی که زیرشبکه‌های آن‌ها مقادیر متفاوتی برای گزینه‌ها و پارامترهای پیکربندی دارند، یک ابهام ذاتی وجود دارد. سرور گزینه‌های IA را به ترتیب وقوع آن‌ها در پرس‌وجوی کلاینت به صورت متوالی پردازش می‌کند؛ اگر اجاره‌های درخواست‌شده در گزینه‌های IA در نهایت از زیرشبکه‌های متفاوتی برآورده شوند، کدام پارامترها و گزینه‌ها باید اعمال شوند؟ در حال حاضر، کد سرور از مقادیر آخرین زیرشبکه مربوط به آخرین گزینه IA برآورده‌شده استفاده می‌کند.
.sp
ما این مسئله را تا حد زیادی به‌عنوان یک مشکل در پیکربندی سایت در نظر می‌گیریم. یک شبکه اشتراکی معمولاً به معنای همان پیوند فیزیکی است، بنابراین سرویس‌های پیکربندی‌شده توسط گزینه‌های زیرشبکه A باید به همان آسانی از زیرشبکه B قابل دسترسی باشند و برعکس. راه‌های متعددی برای اجتناب از این وضعیت وجود دارد:
.INDENT 0.0.IP \(bu 2
از مقادیر یکسان برای گزینه‌ها و پارامترها در زیرشبکه‌های درون شبکهٔ اشتراکی استفاده کنید.
.IP \(bu 2
از انتخاب‌گرهای زیرشبکه یا محافظ‌های کلاس کلاینت (client class guards) استفاده کنید که تضمین می‌کنند برای پرس‌وجوی یک کلاینت، برای تمام گزینه‌های IA در آن پرس‌وجو از همان زیرشبکه استفاده شود.
.IP \(bu 2
از به‌کارگیری شبکه‌های اشتراکی برای کلاینت‌هایی که در هر پرس‌وجو چندین گزینهٔ IA ارسال می‌کنند خودداری کنید.
.UNINDENT
.UNINDENT
.UNINDENT
.SS ترافیک محلی و رله‌شده در شبکه‌های اشتراکی (Local and Relayed Traffic in Shared Networks)
.sp
تعیین نام رابط (interface) در سطح shared\-network امکان‌پذیر است تا به سرور اعلام شود این شبکهٔ اشتراکی خاص، به‌طور مستقیم (نه از طریق رله‌ها) و با استفاده از رابط شبکهٔ محلی در دسترس است. از آنجا که انتظار می‌رود تمام زیرشبکه‌ها در یک شبکهٔ اشتراکی روی پیوند فیزیکی یکسانی استفاده شوند، تلاش برای تعریف یک شبکهٔ اشتراکی با زیرشبکه‌هایی که از طریق رابط‌های متفاوتی در دسترس هستند یک خطای پیکربندی است. به عبارت دیگر، تمام زیرشبکه‌های درون شبکهٔ اشتراکی باید مقدار یکسانی برای پارامتر \fBinterface\fP داشته باشند. پیکربندی زیر نمونه‌ای از کارهایی است که \fBنباید\fP انجام داد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
\(dqshared\-networks\(dq: [
    {
        \(dqname\(dq: \(dqoffice\-floor\-2\(dq,
        \(dqsubnet6\(dq: [
            {
                \(dqid\(dq: 1,
                \(dqsubnet\(dq: \(dq2001:db8::/64\(dq,
                \(dqpools\(dq: [ { \(dqpool\(dq:  \(dq2001:db8::1 \- 2001:db8::ffff\(dq } ],
                \(dqinterface\(dq: \(dqeth0\(dq
            },
            {
                 \(dqid\(dq: 2,
                 \(dqsubnet\(dq: \(dq3ffe:abcd::/64\(dq,
                 \(dqpools\(dq: [ { \(dqpool\(dq:  \(dq3ffe:abcd::1 \- 3ffe:abcd::ffff\(dq } ],
                 ...
                 # Specifying a different interface name is a configuration
                 # error. This value should rather be \(dqeth0\(dq or the interface
                 # name in the other subnet should be \(dqeth1\(dq.
                 # \(dqinterface\(dq: \(dqeth1\(dq
            }
        ]
    }
],
\&...
}
.EE
.UNINDENT
.UNINDENT
.sp
برای به حداقل رساندن احتمال خطاهای پیکربندی، اغلب راحت‌تر است که نام رابط به سادگی یک بار در سطح shared\-network تعیین شود، همان‌طور که در مثال زیر نشان داده شده است.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
\(dqshared\-networks\(dq: [
    {
        \(dqname\(dq: \(dqoffice\-floor\-2\(dq,

        # This tells Kea that the whole shared network is reachable over a
        # local interface. This applies to all subnets in this network.
        \(dqinterface\(dq: \(dqeth0\(dq,

        \(dqsubnet6\(dq: [
            {
                \(dqid\(dq: 1,
                \(dqsubnet\(dq: \(dq2001:db8::/64\(dq,
                \(dqpools\(dq: [ { \(dqpool\(dq:  \(dq2001:db8::1 \- 2001:db8::ffff\(dq } ]
            },
            {
                 \(dqid\(dq: 2,
                 \(dqsubnet\(dq: \(dq3ffe:abcd::/64\(dq,
                 \(dqpools\(dq: [ { \(dqpool\(dq:  \(dq3ffe:abcd::1 \- 3ffe:abcd::ffff\(dq } ]
            }
        ]
    }
],
\&...
}
.EE
.UNINDENT
.UNINDENT
.sp
در ترافیک رله‌شده، زیرشبکه‌ها معمولاً با استفاده از نشانی‌های عامل‌های رله (relay agents) انتخاب می‌شوند. اگر زیرشبکه‌ها به‌طور مستقل (بدون گروه‌بندی در یک شبکهٔ اشتراکی) استفاده شوند، می‌توان برای هر یک از این زیرشبکه‌ها نشانی رلهٔ متفاوتی تعیین کرد. هنگامی که چندین زیرشبکه به یک شبکهٔ اشتراکی تعلق دارند، باید از طریق نشانی رلهٔ یکسانی انتخاب شوند و مانند مورد ترافیک محلی شرح داده شده در بالا، تعیین نشانی‌های رلهٔ متفاوت برای زیرشبکه‌های مربوطه در شبکهٔ اشتراکی یک خطای پیکربندی است. پیکربندی زیر نمونهٔ دیگری از کارهایی است که \fBنباید\fP انجام داد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
\(dqshared\-networks\(dq: [
    {
        \(dqname\(dq: \(dqkakapo\(dq,
        \(dqsubnet6\(dq: [
            {
                \(dqid\(dq: 1,
                \(dqsubnet\(dq: \(dq2001:db8::/64\(dq,
                \(dqrelay\(dq: {
                    \(dqip\-addresses\(dq: [ \(dq2001:db8::1234\(dq ]
                },
                \(dqpools\(dq: [ { \(dqpool\(dq:  \(dq2001:db8::1 \- 2001:db8::ffff\(dq } ]
            },
            {
                \(dqid\(dq: 2,
                \(dqsubnet\(dq: \(dq3ffe:abcd::/64\(dq,
                \(dqpools\(dq: [ { \(dqpool\(dq:  \(dq3ffe:abcd::1 \- 3ffe:abcd::ffff\(dq } ],
                \(dqrelay\(dq: {
                    # Specifying a different relay address for this
                    # subnet is a configuration error. In this case
                    # it should be 2001:db8::1234 or the relay address
                    # in the previous subnet should be 3ffe:abcd::cafe.
                    \(dqip\-addresses\(dq: [ \(dq3ffe:abcd::cafe\(dq ]
                }
            }
        ]
    }
],
\&...
}
.EE
.UNINDENT
.UNINDENT
.sp
مجدداً، بهتر است نشانی رله در سطح shared\-network تعیین شود؛ این مقدار توسط تمام زیرشبکه‌های متعلق به شبکهٔ اشتراکی به ارث برده خواهد شد.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
\(dqshared\-networks\(dq: [
    {
        \(dqname\(dq: \(dqkakapo\(dq,
        \(dqrelay\(dq: {
            # This relay address is inherited by both subnets.
            \(dqip\-addresses\(dq: [ \(dq2001:db8::1234\(dq ]
        },
        \(dqsubnet6\(dq: [
            {
                \(dqid\(dq: 1,
                \(dqsubnet\(dq: \(dq2001:db8::/64\(dq,
                \(dqpools\(dq: [ { \(dqpool\(dq:  \(dq2001:db8::1 \- 2001:db8::ffff\(dq } ]
            },
            {
                 \(dqid\(dq: 2,
                 \(dqsubnet\(dq: \(dq3ffe:abcd::/64\(dq,
                 \(dqpools\(dq: [ { \(dqpool\(dq:  \(dq3ffe:abcd::1 \- 3ffe:abcd::ffff\(dq } ]
            }
        ]
    }
],
\&...
}
.EE
.UNINDENT
.UNINDENT
.sp
اگرچه از نظر فنی امکان پیکربندی دو (یا چند) زیرشبکه در شبکهٔ اشتراکی برای استفاده از نشانی‌های رلهٔ متفاوت وجود دارد، اما این کار تقریباً همیشه به رفتاری متفاوت از انتظار کاربر منجر خواهد شد. در این حالت، سرور Kea در ابتدا یکی از زیرشبکه‌ها را با تطبیق نشانی رله در بستهٔ کلاینت با پیکربندی زیرشبکه انتخاب می‌کند. با این حال، اگر کلاینت از قبل اجاره‌ای (lease) در زیرشبکهٔ دیگر داشته باشد یا یک رزرو میزبان (host reservation) در آن زیرشبکه داشته باشد، یا صرفاً اگر زیرشبکهٔ انتخاب‌شده در ابتدا نشانی در دسترس دیگری نداشته باشد، سرور ممکن است در نهایت از زیرشبکهٔ دیگر استفاده کند (حتی اگر با نشانی رله مطابقت نداشته باشد). بنابراین، اکیداً توصیه می‌شود در صورتی که زیرشبکه‌ها متعلق به یک شبکهٔ اشتراکی هستند، همیشه انتخاب‌گرهای زیرشبکه (interface یا نشانی relay) در سطح shared\-network تعیین شوند، چرا که تعیین آن‌ها در سطح subnet به‌ندرت مفید است و می‌تواند منجر به خطاهای پیکربندی شرح داده شده در بالا شود..SS "طبقه‌بندی کلاینت‌ها در شبکه‌های مشترک (Client Classification in Shared Networks)"
.sp
گاهی مطلوب است که کلاینت‌ها بر اساس ویژگی‌های معینی در زیرشبکه‌های خاصی تفکیک شوند. این سازوکار طبقه‌بندی کلاینت (client classification) نامیده می‌شود و در Client Classification \%<#\:classify>\& شرح داده شده است. طبقه‌بندی کلاینت را می‌توان به همان شیوه‌ای که برای زیرشبکه‌های تعریف‌شده در خارج از شبکه‌های مشترک استفاده می‌شود، برای زیرشبکه‌های متعلق به شبکه‌های مشترک (shared networks) نیز اعمال کرد. درک نحوهٔ انتخاب زیرشبکه‌ها برای کلاینت‌ها توسط سرور هنگام استفاده از طبقه‌بندی کلاینت اهمیت دارد، تا اطمینان حاصل شود که زیرشبکهٔ مناسب برای یک نوع کلاینت مشخص انتخاب می‌شود.
.sp
اگر یک زیرشبکه با یک کلاس مرتبط شده باشد، تنها کلاینت‌های متعلق به این کلاس می‌توانند از این زیرشبکه استفاده کنند. چنانچه هیچ کلاسی برای یک زیرشبکه تعیین نشده باشد، هر کلاینت متصل به یک شبکهٔ مشترک معین می‌تواند از این زیرشبکه استفاده نماید. یک اشتباه رایج این است که فرض شود زیرشبکهٔ شامل کلاس کلاینت، بر زیرشبکه‌های بدون کلاس کلاینت ارجحیت دارد.
.sp
پارامتر \fBclient\-classes\fP ممکن است در دامنه‌های shared network، subnet و/یا pool تعیین شود. اگر برای یک shared network تعیین شود، کلاینت‌ها باید حداقل عضو یکی از کلاس‌های مشخص‌شده برای آن شبکه باشند تا برای زیرشبکه‌های درون آن شبکه در نظر گرفته شوند. اگر برای یک subnet مشخص گردد، کلاینت‌ها باید دست‌کم متعلق به یکی از کلاس‌های مشخص‌شده برای آن زیرشبکه باشند تا برای هر یک از استخرها (pools) یا رزروهای میزبان (host reservations) آن زیرشبکه مد نظر قرار گیرند. اگر برای یک pool مشخص شود، کلاینت‌ها باید حداقل عضو یکی از کلاس‌های مشخص‌شده برای آن استخر باشند تا یک اجاره (lease) از آن pool دریافت کنند.
.sp
مثال زیر را در نظر بگیرید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqclient\-classes\(dq: [
        {
            \(dqname\(dq: \(dqb\-devices\(dq,
            \(dqtest\(dq: \(dqoption[1234].hex == 0x0002\(dq
        }
    ],
    \(dqshared\-networks\(dq: [
        {
            \(dqname\(dq: \(dqgalah\(dq,
            \(dqrelay\(dq: {
                \(dqip\-address\(dq: [ \(dq2001:db8:2:34::1\(dq ]
            },
            \(dqsubnet6\(dq: [
                {
                    \(dqid\(dq: 1,
                    \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
                    \(dqpools\(dq: [ { \(dqpool\(dq: \(dq2001:db8:1::20 \- 2001:db8:1::ff\(dq } ]
                },
                {
                    \(dqid\(dq: 2,
                    \(dqsubnet\(dq: \(dq2001:db8:3::/64\(dq,
                    \(dqpools\(dq: [ { \(dqpool\(dq: \(dq2001:db8:3::20 \- 2001:db8:3::ff\(dq } ],
                    \(dqclient\-classes\(dq: \(dqb\-devices\(dq
                }
            ]
        }
    ]
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر کلاینت متعلق به کلاس \(dqb\-devices\(dq باشد (به این دلیل که شامل option 1234 با مقدار 0x0002 است)، این تضمین نمی‌کند که زیرشبکهٔ 2001:db8:3::/64 برای این کلاینت استفاده (یا ترجیح داده) شود. سرور می‌تواند از هر یک از این دو زیرشبکه استفاده کند، چرا که زیرشبکهٔ 2001:db8:1::/64 نیز برای این کلاینت مجاز است. طبقه‌بندی کلاینت به‌کاررفته در این مورد باید به عنوان راهی برای محدود کردن دسترسی به زیرشبکه‌های خاص تلقی شود، نه روشی برای اولویت‌بندی زیرشبکه‌ها. برای مثال، اگر کلاینت متعلق به کلاس \(dqb\-devices\(dq نباشد، فقط می‌تواند از زیرشبکهٔ 2001:db8:1::/64 استفاده کند و هرگز از زیرشبکهٔ 2001:db8:3::/64 استفاده نخواهد کرد.
.sp
یک کاربرد معمول برای طبقه‌بندی کلاینت در شبکه‌های کابلی (cable network) است؛ جایی که مودم‌های کابلی باید از یک زیرشبکه و سایر دستگاه‌ها باید از زیرشبکهٔ دیگری درون همان شبکهٔ مشترک استفاده کنند. در این حالت، اعمال طبقه‌بندی بر روی تمام زیرشبکه‌ها ضروری است. مثال زیر دو کلاس از دستگاه‌ها را تعریف می‌کند و انتخاب زیرشبکه بر اساس مقادیر option 1234 انجام می‌گیرد.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqclient\-classes\(dq: [
        {

            \(dqname\(dq: \(dqa\-devices\(dq,
            \(dqtest\(dq: \(dqoption[1234].hex == 0x0001\(dq
        },
        {
            \(dqname\(dq: \(dqb\-devices\(dq,
            \(dqtest\(dq: \(dqoption[1234].hex == 0x0002\(dq
        }
    ],
    \(dqshared\-networks\(dq: [
        {
            \(dqname\(dq: \(dqgalah\(dq,
            \(dqrelay\(dq: {
                \(dqip\-addresses\(dq: [ \(dq2001:db8:2:34::1\(dq ]
            },
            \(dqsubnet6\(dq: [
                {
                    \(dqid\(dq: 1,
                    \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
                    \(dqpools\(dq: [ { \(dqpool\(dq: \(dq2001:db8:1::20 \- 2001:db8:1::ff\(dq } ],
                    \(dqclient\-classes\(dq: [ \(dqa\-devices\(dq ]
                },
                {
                    \(dqid\(dq: 2,
                    \(dqsubnet\(dq: \(dq2001:db8:3::/64\(dq,
                    \(dqpools\(dq: [ { \(dqpool\(dq: \(dq2001:db8:3::20 \- 2001:db8:3::ff\(dq } ],
                    \(dqclient\-classes\(dq: [ \(dqb\-devices\(dq ]
                }
            ]
        }
    ]
}
.EE
.UNINDENT
.UNINDENT
.sp
در این مثال هر کلاس محدودیت خاص خود را دارد. تنها کلاینت‌هایی که متعلق به کلاس \(dqa\-devices\(dq هستند می‌توانند از زیرشبکهٔ 2001:db8:1::/64 استفاده کنند و تنها کلاینت‌های متعلق به \(dqb\-devices\(dq قادر به استفاده از زیرشبکهٔ 2001:db8:3::/64 خواهند بود. باید دقت شود که قواعد طبقه‌بندی بیش از حد محدودکننده تعریف نشوند، زیرا از ارائهٔ سرویس به کلاینت‌هایی که قادر به استفاده از هیچ زیرشبکه‌ای نیستند امتناع خواهد شد. با این حال، چنانچه هدف ارائهٔ سرویس صرفاً به کلاینت‌هایی با ویژگی‌های مشخص باشد (مثلاً فقط تلفن‌های VoIP مجاز به اتصال به یک پیوند خاص باشند)، این می‌تواند یک نتیجهٔ مطلوب باشد.
.sp
می‌توان بدون استفاده از shared networks نیز به نتیجه‌ای مشابه با آنچه در این بخش مطرح شد دست یافت. اگر زیرشبکه‌ها به جای قرار گرفتن در shared network، در دامنهٔ سراسری زیرشبکه‌ها (global subnets scope) قرار گیرند، سرور همچنان از قواعد طبقه‌بندی برای انتخاب زیرشبکهٔ مناسب برای یک کلاس خاص از دستگاه‌ها استفاده خواهد کرد. مزیت اصلی قرار دادن زیرشبکه‌ها در یک shared network این است که پارامترهای مشترک برای زیرشبکه‌هایی که از نظر منطقی گروه‌بندی شده‌اند را می‌توان یک‌بار در دامنهٔ shared network مشخص کرد؛ مانند پارامترهای \fBinterface\fP یا \fBrelay\fP. تمام زیرشبکه‌های متعلق به این شبکه مشترک، آن پارامترها را به ارث خواهند برد..SS رزروهای میزبان در شبکه‌های اشتراکی (Shared Networks)
.sp
زیرشبکه‌هایی که بخشی از یک شبکه اشتراکی هستند، همانند زیرشبکه‌های معمولی اجازه رزرو میزبان را می‌دهند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqshared\-networks\(dq: [
    {
        \(dqname\(dq: \(dqfrog\(dq,
        \(dqrelay\(dq: {
            \(dqip\-addresses\(dq: [ \(dq2001:db8:2:34::1\(dq ]
        },
        \(dqsubnet6\(dq: [
            {
                \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
                \(dqid\(dq: 100,
                \(dqpools\(dq: [ { \(dqpool\(dq: \(dq2001:db8:1::1 \- 2001:db8:1::64\(dq } ],
                \(dqreservations\(dq: [
                {
                    \(dqduid\(dq: \(dq00:03:00:01:11:22:33:44:55:66\(dq,
                    \(dqip\-addresses\(dq: [ \(dq2001:db8:1::28\(dq ]
                }
                ]
            },
            {
                \(dqsubnet\(dq: \(dq2001:db8:3::/64\(dq,
                \(dqid\(dq: 101,
                \(dqpools\(dq: [ { \(dqpool\(dq: \(dq2001:db8:3::1 \- 2001:db8:3::64\(dq } ],
                \(dqreservations\(dq: [
                    {
                        \(dqduid\(dq: \(dq00:03:00:01:aa:bb:cc:dd:ee:ff\(dq,
                        \(dqip\-addresses\(dq: [ \(dq2001:db8:2::28\(dq ]
                    }
                ]
            }
        ]
    }
    ]
}
.EE
.UNINDENT
.UNINDENT
.sp
شایان ذکر است که در صورت تعریف شبکه‌های اشتراکی، Kea هنگام پردازش بسته، بررسی‌های بیشتری انجام می‌دهد. نخست، Kea به جای اینکه صرفاً بررسی کند آیا برای کلاینت مورد نظر در زیرشبکه اولیه انتخاب‌شده رزروی وجود دارد یا خیر، تمام زیرشبکه‌های موجود در یک شبکه اشتراکی را برای یافتن رزرو جستجو می‌کند. این یکی از دلایلی است که چرا تعریف یک شبکه اشتراکی ممکن است بر کارایی تأثیر بگذارد. اگر در هر یک از زیرشبکه‌ها رزروی برای کلاینت وجود داشته باشد، همان زیرشبکه خاص برای کلاینت انتخاب می‌شود. اگرچه از نظر فنی خطا محسوب نمی‌شود، اما تعریف رزرو برای یک میزبان یکسان در چندین زیرشبکه متعلق به یک شبکه اشتراکی، روشی نادرست تلقی می‌شود.
.sp
اگرچه استفاده از مقادیر صریح \(dqid\(dq برای زیرشبکه‌ها کاملاً اجباری نیست، اما در صورتی که قرار باشد از ذخیره‌سازی پایگاه‌داده برای رزروهای میزبان استفاده شود، به‌شدت توصیه می‌شود. اگر یک شناسه مشخص نشود، مقادیر آن به‌طور خودکار تولید می‌شوند؛ بدین معنا که Kea مقادیر صحیح افزایشی را از ۱ تخصیص می‌دهد. بنابراین، شناسه‌های تولیدشده به‌طور خودکار در طول تغییرات پیکربندی پایدار نخواهند بود.
.SS شناسه سرور در DHCPv6
.sp
پروتکل DHCPv6 از یک \(dqشناسه سرور\(dq (که با نام DUID نیز شناخته می‌شود) استفاده می‌کند تا به کلاینت‌ها امکان دهد بین چندین سرور موجود در یک پیوند (link) یکسان تمایز قائل شوند. استاندارد RFC 9915 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc9915> در حال حاضر چهار نوع DUID را تعریف می‌کند: DUID\-LLT، DUID\-EN، DUID\-LL و DUID\-UUID.
.sp
سرور DHCPv6 در Kea یک‌بار در هنگام نخستین راه‌اندازی، یک شناسه سرور تولید کرده و آن را در یک فایل ذخیره می‌کند. این شناسه در طول راه‌اندازی‌های مجدد سرور تغییر نمی‌کند و از این رو شناسه‌ای پایدار است.
.sp
نرم‌افزار Kea از توصیه مطرح‌شده در RFC 9915 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc9915> مبنی بر استفاده از DUID\-LLT به عنوان شناسه سرور پیش‌فرض پیروی می‌کند. با این حال، ISC گزارش‌هایی دریافت کرده است مبنی بر اینکه برخی استقرارها به انواع متفاوتی از DUID نیاز دارند، و لازم است نوع DUID و/یا محتوای آن به صورت مدیریتی تعیین شود.
.sp
شناسه سرور را می‌توان با استفاده از پارامترهای موجود در عنصر نگاشت \fBserver\-id\fP در حوزه سراسری فایل پیکربندی Kea پیکربندی کرد. مثال زیر نحوه انتخاب DUID\-EN را به عنوان شناسه سرور نشان می‌دهد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqserver\-id\(dq: {
        \(dqtype\(dq: \(dqEN\(dq
    },
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
مقادیر پشتیبانی‌شده کنونی برای پارامتر \fBtype\fP به ترتیب عبارتند از: \(dqLLT\(dq، \(dqEN\(dq و \(dqLL\(dq، به ترتیب برای DUID\-LLT، DUID\-EN و DUID\-LL.
.sp
هنگامی که یک نوع DUID جدید انتخاب می‌شود، سرور مقدار آن را تولید کرده و جایگزین هر DUID موجود در فایل می‌کند. سپس سرور از شناسه سرور جدید در تمامی تعاملات بعدی با کلاینت‌ها استفاده خواهد کرد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
اگر شناسه سرور جدید پس از دریافت اجاره‌ها (leases) توسط برخی کلاینت‌ها ایجاد شود، کلاینت‌هایی که از شناسه قدیمی استفاده می‌کنند قادر به تمدید اجاره‌های خود نخواهند بود؛ سرور پیام‌های حاوی شناسه سرور قدیمی را نادیده خواهد گرفت. کلاینت‌ها به ارسال پیام‌های RENEW ادامه می‌دهند تا زمانی که به وضعیت rebinding منتقل شوند. در این وضعیت، آنها شروع به ارسال پیام‌های REBIND به آدرس چندپخشی (multicast) بدون شناسه سرور می‌کنند. سرور با شناسه سرور جدید به پیام‌های REBIND پاسخ می‌دهد و کلاینت‌ها شناسه سرور جدید را با اجاره‌های خود مرتبط می‌سازند. اگرچه کلاینت‌ها قادر به حفظ اجاره‌های خود خواهند بود و در نهایت شناسه سرور جدید را یاد می‌گیرند، اما این امر به بهای افزایش تعداد درخواست‌های تمدید و ترافیک چندپخشی ناشی از نیاز به rebind تمام خواهد شد. بنابراین، توصیه می‌شود در صورتی که سرور از قبل اجاره‌هایی تخصیص داده و این اجاره‌ها همچنان معتبر هستند، از تغییر نوع و مقدار شناسه سرور خودداری شود.
.UNINDENT
.UNINDENT
.sp
مواردی وجود دارد که مدیر سیستم به جای اجازه دادن به سرور برای تولید مقدار DUID، نیاز به تعیین صریح آن دارد. مثال زیر نحوه تنظیم صریح تمامی مؤلفه‌های یک DUID\-LLT را نشان می‌دهد.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqserver\-id\(dq: {
        \(dqtype\(dq: \(dqLLT\(dq,
        \(dqhtype\(dq: 8,
        \(dqidentifier\(dq: \(dqA65DC7410F05\(dq,
        \(dqtime\(dq: 2518920166
    },
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
که در آن:
.INDENT 0.0
.IP \(bu 2
\fBhtype\fP یک مقدار ۱۶ بیتی بدون علامت است که نوع سخت‌افزار را مشخص می‌کند،
.IP \(bu 2
\fBidentifier\fP یک آدرس لایه پیوند (link\-layer) است که به صورت رشته‌ای از ارقام هگزادسیمال مشخص می‌شود، و
.IP \(bu 2
\fBtime\fP یک مقدار زمان ۳۲ بیتی بدون علامت است.
.UNINDENT
.sp
نمایش هگزادسیمال DUID تولیدشده در نتیجه پیکربندی مشخص‌شده در بالا به صورت زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
 00:01:00:08:96:23:AB:E6:A6:5D:C7:41:0F:05
|type |htype|   time    |   identifier    |
.EE
.UNINDENT
.UNINDENT
.sp
مقدار ویژه \(dq0\(dq برای \fBhtype\fP و \fBtime\fP مجاز است، که نشان می‌دهد سرور باید از هر مقداری برای این مؤلفه‌ها استفاده کند. اگر سرور از قبل از یک DUID\-LLT استفاده کند، از مقادیر موجود در همین DUID استفاده خواهد کرد؛ اگر سرور از DUID با نوع متفاوتی استفاده کند یا هنوز از هیچ DUID استفاده نکرده باشد، این مقادیر را تولید خواهد کرد. به همین ترتیب، اگر به \fBidentifier\fP یک رشته خالی اختصاص داده شود، مقدار \fBidentifier\fP تولید خواهد شد. حذف هر یک از این پارامترها معادل تنظیم آنها بر روی این مقادیر ویژه است.
.sp
برای نمونه، پیکربندی زیر:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqserver\-id\(dq: {
        \(dqtype\(dq: \(dqLLT\(dq,
        \(dqhtype\(dq: 0,
        \(dqidentifier\(dq: \(dq\(dq,
        \(dqtime\(dq: 2518920166
    },
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
نشان می‌دهد که سرور باید از هر آدرس لایه پیوند و نوع سخت‌افزاری استفاده کند. اگر سرور از قبل از DUID\-LLT استفاده کند، از آدرس لایه پیوند و نوع سخت‌افزار موجود در DUID فعلی استفاده خواهد کرد. اگر سرور هنوز از هیچ DUID استفاده نمی‌کند، از آدرس لایه پیوند و نوع سخت‌افزار یکی از رابط‌های شبکه موجود استفاده خواهد کرد. سرور از مقدار زمانی صریح استفاده خواهد کرد؛ اگر این مقدار با مقدار زمان موجود در DUID کنونی متفاوت باشد، آن مقدار جایگزین خواهد شد که عملاً شناسه سرور فعلی را تغییر می‌دهد.
.sp
مثال زیر یک پیکربندی صریح از یک DUID\-EN را نشان می‌دهد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqserver\-id\(dq: {
        \(dqtype\(dq: \(dqEN\(dq,
        \(dqenterprise\-id\(dq: 2495,
        \(dqidentifier\(dq: \(dq87ABEF7A5BB545\(dq
    },
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
که در آن:
.INDENT 0.0.IP \(bu 2
\fBenterprise\-id\fP یک مقدار ۳۲\-بیتی بدون علامت است که شماره سازمانی (enterprise number) را نگه می‌دارد، و
.IP \(bu 2
\fBidentifier\fP یک شناسه با طول متغیر در DUID\-EN است.
.UNINDENT
.sp
نمایش هگزادسیمال DUID\-EN ایجادشده طبق پیکربندی بالا به صورت زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
 00:02:00:00:09:BF:87:AB:EF:7A:5B:B5:45
|type |  ent\-id   |     identifier     |
.EE
.UNINDENT
.UNINDENT
.sp
همانند حالت DUID\-LLT، می‌توان از مقادیر ویژه‌ای برای پیکربندی DUID\-EN استفاده کرد. اگر \fBenterprise\-id\fP برابر \(dq0\(dq باشد، سرور از مقدار موجود در DUID\-EN فعلی استفاده خواهد کرد. اگر سرور از هیچ DUID استفاده نکند یا DUID موجود از نوع متفاوتی باشد، شناسه سازمانی ISC استفاده خواهد شد. هنگامی که یک رشته خالی برای \fBidentifier\fP وارد شود، از شناسه موجود در DUID\-EN فعلی استفاده می‌شود. اگر سرور از هیچ DUID\-EN استفاده نکند، یک \fBidentifier\fP جدید با طول ۶ بایت ایجاد خواهد شد.
.sp
پیکربندی DUID\-LL به همان روش DUID\-LLT انجام می‌شود، با این تفاوت که پارامتر \fBtime\fP هیچ تأثیری بر DUID\-LL ندارد، زیرا این نوع DUID تنها شامل یک نوع سخت‌افزار و نشانی لایه پیوند است. مثال زیر نحوه پیکربندی DUID\-LL را نشان می‌دهد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqserver\-id\(dq: {
        \(dqtype\(dq: \(dqLL\(dq,
        \(dqhtype\(dq: 8,
        \(dqidentifier\(dq: \(dqA65DC7410F05\(dq
    },
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
که به شناسه سرور زیر منجر خواهد شد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
 00:03:00:08:A6:5D:C7:41:0F:05
|type |htype|   identifier    |
.EE
.UNINDENT
.UNINDENT
.sp
سرور شناسه سرور ایجادشده را در مکان زیر ذخیره می‌کند: \fB\(dq[kea\-install\-dir]/var/lib/kea/kea\-dhcp6\-serverid\(dq\fP\&.
.sp
از Kea نسخه 2.7.9 به بعد، این مسیر می‌تواند هنگام راه‌اندازی با تنظیم متغیر محیطی \fBKEA_DHCP_DATA_DIR\fP به مسیر دلخواه بازنویسی شود.
.sp
در برخی استقرارهای نامتداول که هیچ فضای ذخیره‌سازی پایداری در دسترس نیست، سرور باید طوری پیکربندی شود که برای ذخیره شناسه سرور تلاش نکند. این انتخاب با مقدار پارامتر بولی \fBpersist\fP کنترل می‌شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqserver\-id\(dq: {
        \(dqtype\(dq: \(dqEN\(dq,
        \(dqenterprise\-id\(dq: 2495,
        \(dqidentifier\(dq: \(dq87ABEF7A5BB545\(dq,
        \(dqpersist\(dq: false
    },
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
مقدار پیش‌فرض پارامتر \fBpersist\fP برابر با \fBtrue\fP است، که سرور را طوری پیکربندی می‌کند که شناسه سرور را روی یک دیسک ذخیره کند.
.sp
در مثال بالا، سرور طوری پیکربندی شده است که شناسه سرور تولیدشده را روی دیسک ذخیره نکند. اما اگر شناسه سرور در پیکربندی تغییر داده نشود، پس از راه‌اندازی مجدد سرور از همان مقدار استفاده می‌شود، چرا که کل شناسه سرور به صورت صریح در پیکربندی مشخص شده است.
.SS "دایرکتوری داده‌های DHCPv6 (DHCPv6 Data Directory)"
.sp
سرور Kea DHCPv6 فایل شناسه سرور و فایل پیش‌فرض اجاره‌های حافظه را در دایرکتوری داده‌های خود قرار می‌دهد. به طور پیش‌فرض این دایرکتوری \fB\(dq[kea\-install\-dir]/var/lib/kea\(dq\fP است، اما این مکان را می‌توان با استفاده از پارامتر سراسری \fBdata\-directory\fP تغییر داد، مانند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqdata\-directory\(dq: \(dq/var/lib/kea/kea\-server6\(dq,
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
از Kea نسخه 2.7.9، پارامتر \fBdata\-directory\fP منسوخ شده است. فایل‌های duid و اجاره (lease) ممکن است فقط از دایرکتوری تعیین‌شده در زمان کامپایل بارگیری شوند: \fB\(dq[kea\-install\-dir]/var/lib/kea\(dq\fP\&. این مسیر می‌تواند هنگام راه‌اندازی با تنظیم متغیر محیطی \fBKEA_DHCP_DATA_DIR\fP به مسیر مورد نظر بازنویسی شود. اگر مسیری غیر از این مقدار در \fBdata\-directory\fP استفاده شود، Kea خطایی صادر کرده و از شروع به کار خودداری می‌کند یا در صورت در حال اجرا بودن، یک خطای غیرقابل‌بازیابی را ثبت می‌کند.
.UNINDENT
.UNINDENT.SS DHCPv6 بدون‌حالت (پیام INFORMATION\-REQUEST)
.sp
به‌طور معمول DHCPv6 برای تخصیص هر دو مورد نشانی‌ها و گزینه‌ها به کار می‌رود. این
تخصیص‌ها (اجاره‌ها) دارای وضعیتی هستند که در طول زمان تغییر می‌کند، از این رو به
عنوان \(dqبا‌حالت\(dq توصیف می‌شوند. پروتکل DHCPv6 همچنین از یک حالت \(dqبدون‌حالت\(dq پشتیبانی
می‌کند که در آن کلاینت‌ها تنها گزینه‌های پیکربندی را درخواست می‌کنند. این حالت از دیدگاه
سرور سبک به شمار می‌آید، زیرا به هیچ‌گونه رهگیری وضعیت نیاز ندارد.
.sp
سرور Kea از حالت بدون‌حالت پشتیبانی می‌کند. هنگامی که کلاینت‌ها پیام‌های
INFORMATION\-REQUEST ارسال می‌کنند، سرور در صورت موجود بودن گزینه‌ها در
پیکربندی سرور، پاسخ‌ها را به همراه گزینه‌های درخواستی بازمی‌گرداند. سرور ابتدا تلاش
می‌کند از گزینه‌های مختص به هر زیرشبکه استفاده کند؛ اگر این کار ناموفق باشد، سپس سعی
می‌کند گزینه‌های تعریف‌شده در حوزه سراسری را ارائه دهد.
.sp
حالت‌های بدون‌حالت و با‌حالت می‌توانند در کنار یکدیگر استفاده شوند. برای مدیریت
این موضوع به هیچ دستورالعمل پیکربندی خاصی نیاز نیست؛ کافی است از پیکربندی
مربوط به کلاینت‌های با‌حالت استفاده شود و کلاینت‌های بدون‌حالت تنها گزینه‌هایی را که
درخواست کرده‌اند دریافت خواهند کرد.
.sp
امکان اجرای سروری که تنها گزینه‌ها را ارائه دهد و هیچ نشانی یا پیشوندی تخصیص ندهد
وجود دارد. اگر گزینه‌ها در هر زیرشبکه مقدار یکسانی داشته باشند، می‌توان گزینه‌های مورد
نیاز را در حوزه سراسری تعریف کرد و تعاریف زیرشبکه را به‌کلی نادیده گرفت. در اینجا
نمونه ساده‌ای از چنین پیکربندی آورده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqinterfaces\-config\(dq: {
        \(dqinterfaces\(dq: [ \(dqethX\(dq ]
    },
    \(dqoption\-data\(dq: [ {
        \(dqname\(dq: \(dqdns\-servers\(dq,
        \(dqdata\(dq: \(dq2001:db8::1, 2001:db8::2\(dq
    } ],
    \(dqlease\-database\(dq: {
        \(dqtype\(dq: \(dqmemfile\(dq
    }
 }
.EE
.UNINDENT
.UNINDENT
.sp
این پیکربندی بسیار ساده، اطلاعات سرور DNS را بدون در نظر گرفتن موقعیت مکانی
کلاینت‌ها در اختیار تمام کلاینت‌های شبکه قرار می‌دهد. پایگاه داده اجاره memfile
باید مشخص شود، زیرا Kea نیازمند مشخص شدن یک پایگاه داده اجاره است حتی اگر
از آن استفاده نشود.
.SS پشتیبانی از RFC 7550 (اکنون بخشی از RFC 9915)
.sp
مستند RFC 7550 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc7550> تغییراتی
را در مشخصات قبلی DHCPv6، یعنی RFC
3315 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc3315> و RFC
3633 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc3633> ایجاد کرد تا مشکلات
ناشی از همزیستی چند گزینه با‌حالت در پیام‌های مبادله‌شده میان کلاینت‌ها و سرورها برطرف
شود. این تغییرات بعداً در جدیدترین مشخصات پروتکل DHCPv6، یعنی RFC
9915 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc9915> گنجانده شدند که
جایگزین RFC 7550 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc7550>\& گردید.
پروتکل Kea از RFC 9915 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc9915> به
همراه این تغییرات پروتکل پشتیبانی می‌کند که در ادامه به طور خلاصه شرح داده شده‌اند.
.sp
هنگامی که یک کلاینت، مانند یک مسیریاب درخواست‌کننده، در طول تبادل ۴ مرحله‌ای (SARR)
با سرور درخواست تخصیص هم‌زمان نشانی‌ها و پیشوندها را ارسال کند و سرور برای تخصیص
هیچ پیشوندی پیکربندی نشده باشد اما بتواند تعدادی نشانی تخصیص دهد، با IA_NA(ها) حاوی
نشانی‌های تخصیص‌یافته و IA_PD(ها) حاوی کد وضعیت NoPrefixAvail پاسخ خواهد داد.
مطابق با مشخصات به‌روزرسانی‌شده، اگر کلاینت بتواند بدون پیشوندها به کار خود ادامه دهد،
باید نشانی‌های تخصیص‌یافته را بپذیرد و به وضعیت \(dqbound\(dq منتقل شود. هنگامی که کلاینت
متعاقباً پیام‌های RENEW/REBIND را به منظور تمدید طول عمر نشانی‌های تخصیص‌یافته، بر اساس
زمان‌های T1 و T2 به سرور ارسال می‌کند، در صورتی که کلاینت همچنان مایل به دریافت پیشوندها
از سرور باشد، می‌تواند یک IA_PD را نیز در RENEW/REBIND برای درخواست تخصیص پیشوندها
بگنجاند. اگر سرور همچنان قادر به تخصیص پیشوندها نباشد، با IA_PD(ها) حاوی کد وضعیت
NoPrefixAvail پاسخ خواهد داد. با این حال، اگر سرور بتواند پیشوندها را تخصیص دهد، آن‌ها را
تخصیص داده و در IA_PD(ها) به کلاینت ارسال می‌کند. وضعیت مشابهی زمانی رخ می‌دهد که
سرور قادر به تخصیص نشانی برای کلاینت نباشد اما امکان تفویض پیشوندها را داشته باشد:
کلاینت می‌تواند هنگام تمدید پیشوندهای تفویض‌شده، درخواست تخصیص نشانی‌ها را مطرح کند.
تخصیص اجاره‌ها برای سایر انواع IA در حین تمدید اجاره‌های موجود، به‌طور پیش‌فرض توسط
سرور Kea DHCPv6 پشتیبانی می‌شود و سرور هیچ سازوکار پیکربندی‌ای برای غیرفعال کردن
این رفتار ارائه نمی‌دهد.
.sp
موارد زیر رفتارهای دیگری هستند که ابتدا در RFC
7550 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc7550> (اکنون بخشی از RFC
9915 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc9915>) معرفی شدند و توسط
سرور Kea DHCPv6 پشتیبانی می‌شوند:
.INDENT 0.0
.IP \(bu 2
تنظیم تایمرهای T1/T2 روی مقدار یکسان برای تمام گزینه‌های با‌حالت (IA_NA و IA_PD)
به منظور تسهیل تمدید هم‌زمان همه اجاره‌های یک کلاینت (در یک تبادل پیام واحد).
.IP \(bu 2
قرار دادن کدهای وضعیت NoAddrsAvail و NoPrefixAvail در گزینه‌های IA_NA و
IA_PD در پیام ADVERTISE، به جای قرار دادن آن‌ها به عنوان گزینه‌های سطح بالا.
.UNINDENT
.SS استفاده از یک عامل رله مشخص برای یک زیرشبکه
.sp
سرور DHCPv6 برای انتخاب یک زیرشبکه جهت کلاینت، از اصول مشابهی با سرور DHCPv4
پیروی می‌کند؛ البته با تفاوت‌های قابل‌توجهی که عمدتاً مربوط به رله‌ها است.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
هنگامی که زیرشبکه انتخاب‌شده عضوی از یک شبکه مشترک باشد، کل شبکه مشترک
انتخاب می‌شود.
.UNINDENT
.UNINDENT
.sp
یک رله باید رابطی متصل به پیوندی داشته باشد که کلاینت‌ها روی آن پیکربندی می‌شوند.
به‌طور معمول رله یک نشانی IPv6 سراسری پیکربندی‌شده روی آن رابط دارد که متعلق
به زیرشبکه‌ای است که سرور نشانی‌ها را از آن تخصیص می‌دهد. در شرایط عادی، سرور
قادر است از نشانی IPv6 درج‌شده توسط رله (در فیلد \fBlink\-addr\fP در پیام RELAY\-FORW)
برای انتخاب زیرشبکه مناسب استفاده کند.
.sp
با این حال، همیشه این‌طور نیست؛ نشانی رله ممکن است در برخی استقرارها با زیرشبکه
مطابقت نداشته باشد. این موضوع معمولاً به این معنی است که بیش از یک زیرشبکه برای
یک پیوند خاص تخصیص یافته است. دو نمونه رایج از این حالت، بازشماره‌گذاری طولانی‌مدت
شبکه (جایی که هر دو فضای نشانی قدیم و جدید همچنان مورد استفاده قرار می‌گیرند) و
شبکه کابلی هستند. در یک شبکه کابلی، هم مودم‌های کابلی و هم دستگاه‌های پشت آن‌ها
به صورت فیزیکی به یک پیوند متصل هستند، اما از آدرس‌دهی متفاوتی استفاده می‌کنند.
در چنین حالتی، سرور DHCPv6 به اطلاعات اضافی (مقدار گزینه \fBinterface\-id\fP
یا نشانی IPv6 درج‌شده در فیلد \fBlink\-addr\fP در پیام RELAY\-FORW) نیاز دارد تا بتواند
زیرشبکه مناسب را به‌درستی انتخاب کند.
.sp
مثال زیر فرض می‌کند که زیرشبکه 2001:db8:1::/64 وجود دارد که از طریق رله‌ای با
نشانی IPv6 معادل 3000::1 در دسترس است. سرور قادر است این زیرشبکه را برای
هر بسته ورودی که از سوی رله‌ای با نشانی موجود در زیرشبکه 2001:db8:1::/64 می‌آید،
انتخاب کند. همچنین آن زیرشبکه را برای رله‌ای با نشانی 3000::1 انتخاب می‌نماید.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqsubnet6\(dq: [
        {
            \(dqid\(dq: 1,
            \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
            \(dqpools\(dq: [
                 {
                     \(dqpool\(dq: \(dq2001:db8:1::1\-2001:db8:1::ffff\(dq
                 }
            ],
            \(dqrelay\(dq: {
                \(dqip\-addresses\(dq: [ \(dq3000::1\(dq ]
            }
        }
    ]
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر \fBrelay\fP مشخص شده باشد، پارامتر \fBip\-addresses\fP در داخل آن الزامی است.
پارامتر \fBip\-addresses\fP از مشخص کردن فهرستی از نشانی‌ها پشتیبانی می‌کند..SS "جداسازی کلاینت‌های IPv6 در یک شبکه کابلی (Segregating IPv6 Clients in a Cable Network)"
.sp
در برخی موارد، ترکیب اطلاعات آدرس رله (معرفی‌شده در «Using a Specific Relay Agent for a Subnet») با طبقه‌بندی کلاینت (توضیح‌داده‌شده در «Client Classification» \%<#\:classify>) مفید است. یک نمونه خاص، شبکه‌های کابلی است که در آن‌ها مودم‌ها معمولاً آدرس‌هایی از یک زیرشبکه متفاوت نسبت به تمام دستگاه‌های متصل در پشت خود دریافت می‌کنند.
.sp
فرض کنیم یک Cable Modem Termination System (CMTS) با یک CM MAC (یک پیوند فیزیکی که مودم‌ها به آن متصل هستند) وجود دارد. ما می‌خواهیم مودم‌ها آدرس‌هایی از زیرشبکه 3000::/64 دریافت کنند، در حالی که تمام دستگاه‌های متصل در پشت مودم‌ها باید آدرس‌هایی از زیرشبکه 2001:db8:1::/64 دریافت کنند. CMTS که به عنوان رله عمل می‌کند از آدرس 3000::1 استفاده می‌کند. پیکربندی زیر می‌تواند پاسخگوی این وضعیت باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqsubnet6\(dq: [
        {
            \(dqid\(dq: 1,
            \(dqsubnet\(dq: \(dq3000::/64\(dq,
            \(dqpools\(dq: [
                { \(dqpool\(dq: \(dq3000::2 \- 3000::ffff\(dq }
            ],
            \(dqclient\-classes\(dq: [ \(dqVENDOR_CLASS_docsis3.0\(dq ],
            \(dqrelay\(dq: {
                \(dqip\-addresses\(dq: [ \(dq3000::1\(dq ]
            }
        },
        {
            \(dqid\(dq: 2,
            \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
            \(dqpools\(dq: [
                 {
                     \(dqpool\(dq: \(dq2001:db8:1::1\-2001:db8:1::ffff\(dq
                 }
            ],
            \(dqrelay\(dq: {
                \(dqip\-addresses\(dq: [ \(dq3000::1\(dq ]
            }
        }
    ]
}
.EE
.UNINDENT
.UNINDENT
.SS "آدرس‌های سخت‌افزاری/MAC در DHCPv6 (MAC/Hardware Addresses in DHCPv6)"
.sp
آدرس‌های سخت‌افزاری/MAC در پیام‌های DHCPv4 ارسالی از سوی کلاینت‌ها در دسترس هستند و مدیران سیستم معمولاً از این اطلاعات برای انجام وظایف خاصی مانند پیکربندی به ازای هر میزبان (per\-host configuration) و رزرو آدرس برای آدرس‌های MAC مشخص استفاده می‌کنند. متأسفانه، پروتکل DHCPv6 هیچ راهکار کاملاً قابل اعتمادی برای بازیابی این اطلاعات ارائه نمی‌دهد. برای کاهش این مشکل، سازوکارهای متعددی در Kea پیاده‌سازی شده است. هر یک از این سازوکارها در موارد خاصی کار می‌کنند، اما ممکن است در شرایط دیگر کارایی نداشته باشند. کارکردن این سازوکار در یک استقرار مشخص، تا حدودی به توپولوژی شبکه و فناوری‌های مورد استفاده بستگی دارد.
.sp
نرم‌افزار Kea امکان تعیین این موضوع را فراهم می‌کند که کدام‌یک از روش‌های پشتیبانی‌شده و با چه ترتیبی، از طریق پارامتر \fBmac\-sources\fP استفاده شوند. این پیکربندی را می‌توان نوعی تنظیم دقیق (fine tuning) برای استقرار DHCP به شمار آورد.
.sp
در اینجا یک مثال آمده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqmac\-sources\(dq: [
        \(dqmethod1\(dq,
        \(dqmethod2\(dq,
        \(dqmethod3\(dq,
        ...
    ],

    \(dqsubnet6\(dq: [
        {
            ...
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
در صورت عدم تعیین، مقدار \(dqany\(dq استفاده می‌شود که به سرور دستور می‌دهد تمام روش‌ها را به ترتیب امتحان کرده و از مقدار بازگردانده‌شده توسط اولین روشی که موفق می‌شود استفاده کند. در یک استقرار معمولی، مقدار پیش‌فرض \(dqany\(dq کافی است و نیازی به انتخاب روش‌های خاص نیست. تغییر مقدار این پارامتر بیشتر در مواردی مفید است که مدیر سیستم بخواهد روش‌های خاصی را غیرفعال کند؛ به عنوان مثال، اگر مدیر سیستم به زیرساخت شبکه بیشتر از اطلاعات ارائه‌شده توسط خود کلاینت‌ها اعتماد داشته باشد، ممکن است اطلاعات ارائه‌شده توسط رله‌ها را به اطلاعات ارائه‌شده توسط کلاینت‌ها ترجیح دهد.
.sp
در صورت مشخص شدن، \fBmac\-sources\fP باید حداقل دارای یک مقدار باشد.
.sp
روش‌های پشتیبانی‌شده عبارتند از:
.INDENT 0.0
.IP \(bu 2
\fBany\fP \- این یک روش واقعی نیست، بلکه صرفاً کلمه‌ای کلیدی است که به Kea دستور می‌دهد تمام روش‌های دیگر را امتحان کرده و از نخستین روشی که موفق می‌شود استفاده کند. اگر هیچ \fBmac\-sources\fP تعریف نشده باشد، این رفتار پیش‌فرض است.
.IP \(bu 2
\fBraw\fP \- در اصل، یک سرور DHCPv6 می‌تواند از سوکت‌های خام (raw sockets) برای دریافت ترافیک ورودی و استخراج اطلاعات آدرس سخت‌افزاری/MAC استفاده کند. این قابلیت در حال حاضر برای DHCPv6 پیاده‌سازی نشده است و این مقدار هیچ اثری ندارد.
.IP \(bu 2
\fBduid\fP \- پروتکل DHCPv6 به جای آدرس‌های MAC از شناساگرهای DUID استفاده می‌کند. در حال حاضر چهار نوع DUID تعریف شده است و دو مورد از آن‌ها (DUID\-LLT که پیش‌فرض است، و DUID\-LL) اطلاعات آدرس MAC را منتقل می‌کنند. گرچه RFC 9915 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc9915> آن را منع کرده است، اما تجزیه این DUIDها و استخراج اطلاعات لازم از آن‌ها امکان‌پذیر است. این روش کاملاً قابل اعتماد نیست، زیرا کلاینت‌ها ممکن است از انواع دیگر DUID، یعنی DUID\-EN یا DUID\-UUID استفاده کنند.
.IP \(bu 2
\fBipv6\-link\-local\fP \- روش ممکن دیگر برای کسب اطلاعات از آدرس IPv6 مبدأ به دست می‌آید. در استفاده معمول، کلاینت‌ها بسته‌های خود را از آدرس‌های محلی پیوند (link\-local) پروتکل IPv6 ارسال می‌کنند. احتمال زیادی وجود دارد که این آدرس‌ها بر پایه EUI\-64 باشند که شامل آدرس MAC است. این روش کاملاً قابل اعتماد نیست، چرا که ممکن است کلاینت‌ها از انواع دیگر آدرس‌های link\-local استفاده کنند. به‌ویژه، افزونه‌های حریم خصوصی (privacy extensions) تعریف‌شده در RFC 4941 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc4941> از آدرس‌های MAC استفاده نمی‌کنند. همچنین توجه داشته باشید که استخراج موفقیت‌آمیز مستلزم آن است که بیت u آدرس روی \(dq1\(dq و بیت g آن روی \(dq0\(dq تنظیم شده باشد که نشان‌دهنده شناسه رابط (interface identifier) مطابق با بخش 2.5.1 از RFC 2373 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc2373#\:section-2\:.5.1>\& است.
.IP \(bu 2
\fBclient\-link\-addr\-option\fP \- یکی از افزونه‌های تعریف‌شده برای کاهش مشکلات نبود MAC، گزینه آدرس لایه پیوند کلاینت (client link\-layer address option) است که در RFC 6939 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc6939>\& تعریف شده است. این گزینه‌ای است که توسط یک رله درج می‌شود و حاوی اطلاعاتی پیرامون آدرس MAC کلاینت است. این روش نیازمند یک عامل رله است که از این گزینه پشتیبانی کند و برای درج آن پیکربندی شده باشد. این روش برای کلاینت‌هایی که اتصال مستقیم دارند بی‌فایده است. مقدار \fBrfc6939\fP یک نام مستعار برای \fBclient\-link\-addr\-option\fP است\&.
.IP \(bu 2
\fBremote\-id\fP \- سند RFC 4649 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc4649> گزینه \fBremote\-id\fP را تعریف می‌کند که توسط یک عامل رله درج می‌شود. بسته به پیکربندی عامل رله، گزینه درج‌شده ممکن است حاوی اطلاعات آدرس MAC کلاینت باشد. مقدار \fBrfc4649\fP یک نام مستعار برای \fBremote\-id\fP است\&.
.IP \(bu 2
\fBsubscriber\-id\fP \- تعریف‌شده در RFC 4580 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc4580>، گزینه \fBsubscriber\-id\fP تا حدی مشابه \fBremote\-id\fP است؛ این گزینه نیز توسط یک عامل رله درج می‌شود. مقدار \fBrfc4580\fP یک نام مستعار برای \fBsubscriber\-id\fP است\&. این روش در حال حاضر پیاده‌سازی نشده است.
.IP \(bu 2
\fBdocsis\-cmts\fP \- یکی دیگر از منابع احتمالی اطلاعات آدرس MAC، گزینه‌های DOCSIS درج‌شده توسط یک CMTS است که به عنوان عامل رله DHCPv6 در شبکه‌های کابلی عمل می‌کند. این روش تلاش می‌کند اطلاعات آدرس MAC را از زیرگزینه 1026 (cm mac) از گزینه خاص سازنده با \fBvendor\-id=4491\fP استخراج کند\&. این گزینه سازنده از پیام Relay\-forward استخراج می‌شود، نه از پیام اصلی کلاینت.
.IP \(bu 2
\fBdocsis\-modem\fP \- آخرین منبع احتمالی اطلاعات آدرس MAC، گزینه‌های DOCSIS درج‌شده توسط خود مودم کابلی است. این روش تلاش می‌کند اطلاعات آدرس MAC را از زیرگزینه 36 (\fBdevice\-id\fP) از گزینه خاص سازنده با \fBvendor\-id=4491\fP استخراج کند\&. این گزینه سازنده از پیام اصلی کلاینت استخراج می‌شود، نه از گزینه‌های رله.
.UNINDENT
.sp
یک پارامتر \fBmac\-sources\fP خالی مجاز نیست. مدیرانی که تمایلی به تعیین آن ندارند، باید یا تعریف \fBmac\-sources\fP را کاملاً حذف کنند یا آن را با مقدار \(dqany\(dq که حالت پیش‌فرض است مشخص نمایند..SS نشانی‌های تکراری (پشتیبانی از DHCPDECLINE)
.sp
کارساز DHCPv6 با استخر مشخصی از نشانی‌ها پیکربندی می‌شود که انتظار می‌رود آن‌ها را به کلاینت‌های DHCPv6 واگذار کند. فرض بر این است که کارساز معتبر (authoritative) بوده و اختیار تام بر روی آن نشانی‌ها دارد. با این حال، به دلایل مختلفی مانند پیکربندی نادرست یا پیاده‌سازی معیوب یک کلاینت که نشانی خود را فراتر از طول‌عمر معتبر (valid lifetime) حفظ می‌کند، ممکن است دستگاه‌های متصلی وجود داشته باشند که از آن نشانی‌ها بدون تایید یا آگاهی کارساز استفاده کنند.
.sp
چنین رویداد نامطلوبی می‌تواند توسط کلاینت‌های مجاز (با استفاده از Duplicate Address Detection) تشخیص داده شده و با استفاده از یک پیام DHCPDECLINE به کارساز DHCPv6 گزارش شود. کارساز یک بررسی صحت (sanity check) انجام می‌دهد (تا ببیند آیا کلاینتی که نشانی را رد می‌کند، واقعاً قرار بوده از آن استفاده کند یا خیر)، سپس یک عملیات پاک‌سازی انجام داده و با ارسال مجدد پیام REPLY، پیام DHCPDECLINE را تایید می‌کند. هرگونه مدخل DNS مربوط به آن نشانی حذف می‌شود، رویداد لاگ می‌شود و قلاب‌ها (hooks) فعال می‌گردند. پس از تکمیل این روند، نشانی به عنوان ردشده (declined) علامت‌گذاری می‌شود (که نشان می‌دهد توسط یک موجودیت ناشناس استفاده شده و در نتیجه برای تخصیص در دسترس نیست) و یک زمان تعلیق (probation time) روی آن تنظیم می‌شود. مگر اینکه به شکل دیگری پیکربندی شده باشد، دوره تعلیق ۲۴ ساعت طول می‌کشد؛ پس از آن زمان، کارساز اجاره (lease) را بازیابی می‌کند (یعنی آن را دوباره به وضعیت در دسترس بازمی‌گرداند) و نشانی دوباره برای تخصیص در دسترس خواهد بود. لازم به ذکر است که اگر مشکل اساسی دستگاه دارای پیکربندی نادرست برطرف نشود، سناریوی نشانی تکراری مجدداً تکرار خواهد شد. در صورت پیکربندی صحیح، این سازوکار فرصتی را برای بهبود و بازیابی خودکار از چنین رویدادی، بدون هیچ‌گونه دخالت مدیر سیستم، فراهم می‌کند.
.sp
برای پیکربندی دوره تعلیق رد نشانی با مقداری غیر از مقدار پیش‌فرض، می‌توان از نحو (syntax) زیر استفاده کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqdecline\-probation\-period\(dq: 3600,
    \(dqsubnet6\(dq: [
        {
            ...
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
این پارامتر بر حسب ثانیه بیان می‌شود، بنابراین مثال بالا به کارساز دستور می‌دهد تا اجاره‌های ردشده را پس از یک ساعت بازیافت کند.
.sp
چندین آمار و نقطه قلاب (hook point) مربوط به رویه رسیدگی به رد نشانی وجود دارد. نقطه قلاب \fBlease6_decline\fP پس از اینکه پیام ورودی DHCPDECLINE بررسی صحت شد و کارساز در شرف رد کردن اجاره است، فعال می‌شود. آمار \fBdeclined\-addresses\fP پس از بازگشت قلاب افزایش می‌یابد (هم نسخه سراسری و هم نسخه ویژه زیرشبکه). (برای جزئیات بیشتر درباره آمارهای DHCPv6 و نقاط قلاب Kea، بخش Statistics in the DHCPv6 Server and Hook Libraries \%<#\:hooks-libraries> را ببینید.)
.sp
به‌محض پایان زمان تعلیق، اجاره ردشده با استفاده از رویه استاندارد بازپس‌گیری اجاره‌های منقضی‌شده، همراه با چند مرحله اضافی بازیابی می‌شود. به‌ویژه، هر دو آمار \fBdeclined\-addresses\fP (سراسری و ویژه زیرشبکه) کاهش می‌یابند. در همان زمان، آمارهای \fBreclaimed\-declined\-addresses\fP (باز هم در دو گونه سراسری و ویژه زیرشبکه) افزایش می‌یابند.
.sp
نکته‌ای درباره آمارها: کارساز Kea هنگام دریافت و پردازش موفقیت‌آمیز پیام DHCPDECLINE، آمار \fBassigned\-nas\fP را کاهش نمی‌دهد. اگرچه از نظر فنی یک نشانی ردشده دیگر تخصیص‌یافته نیست، کاربرد اصلی آمار \fBassigned\-nas\fP پایش میزان بهره‌وری از استخر است. اکثر افراد فراموش می‌کنند که \fBdeclined\-addresses\fP را در محاسبه بگنجانند و صرفاً از \fBassigned\-nas\fP/\fBtotal\-nas\fP\& استفاده می‌کنند. این امر باعث ایجاد سوگیری در جهت کمتر نشان دادن استفاده از استخر می‌شود. از آنجا که این موضوع پتانسیل ایجاد سردرگمی جدی دارد، ISC تصمیم گرفت که بلافاصله پس از دریافت DHCPDECLINE مقدار \fBassigned\-nas\fP را کاهش ندهد، بلکه این کار را بعداً هنگامی که Kea نشانی را به استخر در دسترس بازمی‌گرداند انجام دهد.
.SS ثبت نشانی (پشتیبانی از RFC 9686)
.sp
نسخه 2.7.7 کارساز Kea پشتیبانی از ثبت نشانی خودتولید (self\-generated) را همان‌طور که در RFC 9686 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc9686> تعریف شده معرفی می‌کند؛ یعنی هنگامی که یک پیام معتبر ADDR\-REG\-INFORM (36) دریافت می‌شود، یک اجاره ثبت‌شده افزوده یا به‌روزرسانی شده و یک ADDR\-REG\-REPLY (37) به کلاینت بازگردانده می‌شود.
.sp
از نسخه 3.1.4 کارساز Kea، این ویژگی می‌تواند با تنظیم پارامتر \fBallow\-address\-registration\fP به ترتیب روی true یا false، به‌صورت سراسری فعال یا غیرفعال شود. این ویژگی به‌طور پیش‌فرض فعال است.
.sp
سند RFC 9686 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc9686> از کارسازهایی که از ثبت نشانی پشتیبانی می‌کنند می‌خواهد که در صورت درخواست کلاینت‌ها از طریق گزینه ORO، گزینه 148 را به آن‌ها بازگردانند. مانند هر گزینه استاندارد دیگری، این گزینه نیز باید در پیکربندی کارساز مشخص شود تا به کلاینت‌ها ارسال گردد و این رفتار مستقل از \fBallow\-address\-registration\fP\& است.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
حتی اگر آن‌ها پایگاه‌داده اجاره مشترکی با اجاره‌ها در وضعیت‌های دیگر داشته باشند، اجاره‌های ثبت‌شده مستقل هستند: هنگامی که یک اجاره در وضعیتی دیگر از قبل برای یک نشانی وجود دارد، این نشانی در حال استفاده تلقی شده و نمی‌تواند ثبت شود. به‌طور مشابه، یک اجاره ثبت‌شده نمی‌تواند به وضعیت دیگری تغییر یابد؛ برای مثال، بازپس‌گیری اجاره‌های ثبت‌شده منقضی، آن‌ها را حذف می‌کند.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
کارساز Kea گزینه Option Request را در پیام ADDR\-REG\-INFORM می‌پذیرد و پردازش می‌کند (سند RFC مشخص کرده است که کلاینت نباید چنین گزینه‌ای را در آن قرار دهد).
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
کارساز Kea در حال حاضر فقط نشانی‌هایی را می‌پذیرد که \(dqمناسب پیوند\(dq (\(dqappropriate to the link\(dq) هستند، اما نشانی‌هایی را که \(dqدرون پیشوند واگذارشده به کلاینت\(dq (\(dqwithin a prefix delegated to the client\(dq) هستند هنوز نمی‌پذیرد، که این امر با شیوه توصیف توپولوژی در پیکربندی Kea سازگار نیست.
.UNINDENT
.UNINDENT.SS آمارها در کارساز DHCPv6
.sp
کارساز DHCPv6 از آمارهای زیر پشتیبانی می‌کند:
.SS آمارهای DHCPv6
.TS
box center;
l|l|l.
T{
آماره
T}	T{
نوع داده
T}	T{
توضیحات
T}
_
T{
pkt6\-received
T}	T{
عدد صحیح
T}	T{
تعداد بسته‌های DHCPv6 دریافت‌شده.
این مقدار شامل همهٔ بسته‌ها می‌شود: معتبر،
جعلی، خراب، رد شده و غیره.
انتظار می‌رود این آماره به سرعت رشد کند.
T}
_
T{
pkt6\-service\-disabled
T}	T{
عدد صحیح
T}	T{
تعداد بسته‌های ورودی که هنگام غیرفعال
بودن سرویس DHCP دور ریخته شده‌اند.
T}
_
T{
pkt6\-parse\-failed
T}	T{
عدد صحیح
T}	T{
تعداد بسته‌های ورودی که قابل تجزیه
نبودند. مقدار غیرصفر برای این آماره
نشان می‌دهد که کارساز یک بستهٔ بدشکل
یا ناقص دریافت کرده است. این وضعیت
ممکن است نشان‌دهندهٔ مشکلاتی در شبکه،
کلاینت‌های معیوب، رله‌های معیوب، یا نقصی
در کارساز باشد.
T}
_
T{
pkt6\-queue\-full
T}	T{
عدد صحیح
T}	T{
تعداد بسته‌های ورودی که به دلیل پر
بودن صف نگه‌داری، دور ریخته شده‌اند.
T}
_
T{
pkt6\-duplicate
T}	T{
عدد صحیح
T}	T{
تعداد بسته‌های ورودی که پس از تشخیص
به عنوان تکراری، دور ریخته شده‌اند.
T}
_
T{
pkt6\-rfc\-violation
T}	T{
عدد صحیح
T}	T{
تعداد بسته‌های ورودی که به دلیل عدم
تطابق با مشخصات پروتکل دور ریخته شده‌اند.
T}
_
T{
pkt6\-admin\-filtered
T}	T{
عدد صحیح
T}	T{
تعداد بسته‌های ورودی که بر اساس
پیکربندی کارساز دور ریخته شده‌اند،
برای نمونه با دسته‌بندی پرس‌وجو در
کلاس \fBDROP\fP\&.
T}
_
T{
pkt6\-not\-for\-us
T}	T{
عدد صحیح
T}	T{
تعداد بسته‌های ورودی که دور ریخته
شدند زیرا باید توسط کارساز دیگری
پردازش می‌شدند.
T}
_
T{
pkt6\-processing\-failed
T}	T{
عدد صحیح
T}	T{
تعداد بسته‌های ورودی که به دلیل رخ
دادن خطایی غیرمنتظره در حین پردازش،
دور ریخته شدند.
T}
_
T{
pkt6\-limit\-exceeded
T}	T{
عدد صحیح
T}	T{
تعداد بسته‌های ورودی که توسط
کتابخانهٔ قلاب \fBlimits\fP دور
ریخته شده‌اند.
T}
_
T{
pkt6\-receive\-drop
T}	T{
عدد صحیح
T}	T{
تعداد بسته‌های ورودی که دور ریخته شده‌اند.
علت دقیق دور ریختن بسته‌ها ثبت می‌شود، اما
شایع‌ترین دلایل ممکن است دریافت نوع بستهٔ
غیرقابل‌قبول یا پشتیبانی‌نشده، ممنوع بودن
پاسخ‌های مستقیم، عدم تطابق شناسهٔ کارساز
ارسال‌شده توسط کلاینت با شناسهٔ کارساز،
بدشکل بودن بسته، یا رخ دادن خطایی غیرمنتظره
در حین پردازش باشد.
T}
_
T{
pkt6\-solicit\-received
T}	T{
عدد صحیح
T}	T{
تعداد بسته‌های SOLICIT دریافت‌شده.
انتظار می‌رود این آماره افزایش یابد؛
رشد آن یعنی کلاینت‌هایی که تازه راه‌اندازی
شده‌اند فرآیند پیکربندی خود را آغاز
کرده و بسته‌های اولیهٔ آن‌ها به کارساز
Kea رسیده است.
T}
_
T{
pkt6\-advertise\-received
T}	T{
عدد صحیح
T}	T{
تعداد بسته‌های ADVERTISE دریافت‌شده.
بسته‌های ADVERTISE توسط کارساز ارسال
می‌شوند و هرگز انتظار نمی‌رود کارساز آن‌ها
را دریافت کند؛ مقدار غیرصفر برای این آماره
نشان‌دهندهٔ خطایی در شبکه است. یک دلیل
محتمل می‌تواند یک عامل رلهٔ نادرست باشد که
پیام‌های ADVERTISE را به جای بازگرداندن
به کلاینت‌ها، به اشتباه به سمت کارساز
بازپخش می‌کند.
T}
_
T{
pkt6\-request\-received
T}	T{
عدد صحیح
T}	T{
تعداد بسته‌های DHCPREQUEST دریافت‌شده.
انتظار می‌رود این آماره رشد کند. افزایش آن
بدین معنی است که کلاینت‌های تازه راه‌اندازی‌شده
پاسخ کارساز (DHCPADVERTISE) را دریافت و قبول
کرده‌اند، و اکنون در حال درخواست یک نشانی
(DHCPREQUEST) هستند.
T}
_
T{
pkt6\-reply\-received
T}	T{
عدد صحیح
T}	T{
تعداد بسته‌های REPLY دریافت‌شده. انتظار
می‌رود این آماره همواره صفر بماند، زیرا
بسته‌های REPLY توسط کارساز ارسال می‌شوند
و هرگز نباید دریافت شوند. مقدار غیرصفر
نشان‌دهندهٔ خطا است. یک علت محتمل می‌تواند
یک عامل رلهٔ نادرست باشد که پیام‌های REPLY
را به جای کلاینت‌ها، به اشتباه به سمت کارساز
بازپخش می‌کند.
T}
_
T{
pkt6\-renew\-received
T}	T{
عدد صحیح
T}	T{
تعداد بسته‌های RENEW دریافت‌شده.
انتظار می‌رود این آماره افزایش یابد؛ رشد
آن بدین معنا است که کلاینت‌ها نشانی‌ها و
پیشوندهای خود را دریافت کرده و در تلاش برای
تمدید آن‌ها هستند.
T}
_
T{
pkt6\-rebind\-received
T}	T{
عدد صحیح
T}	T{
تعداد بسته‌های REBIND دریافت‌شده. مقدار
غیرصفر نشان می‌دهد کلاینت‌ها پاسخی برای
پیام‌های RENEW خود (از طریق سازوکار عادی
تمدید اجاره) دریافت نکرده‌اند و در تلاشند هر
کارسازی را که بتواند اجاره‌های آن‌ها را به
عهده بگیرد، بیابند. این وضعیت ممکن است به این
معنی باشد که پیام‌های REPLY برخی کارسازها هرگز
به کلاینت‌ها نرسیده است.
T}
_
T{
pkt6\-release\-received
T}	T{
عدد صحیح
T}	T{
تعداد بسته‌های RELEASE دریافت‌شده. انتظار
می‌رود هنگام خاموش شدن یک دستگاه در شبکه، این
آماره رشد کند؛ این آماره نشان می‌دهد که نشانی
یا پیشوند واگذارشده دیگر مورد نیاز نیست. توجه
داشته باشید که بسیاری از دستگاه‌ها، به‌ویژه
دستگاه‌های بی‌سیم، چه به دلیل طراحی و چه به دلیل
خارج شدن کلاینت از محدوده، بستهٔ RELEASE ارسال
نمی‌کنند.
T}
_
T{
pkt6\-decline\-received
T}	T{
عدد صحیح
T}	T{
تعداد بسته‌های DECLINE دریافت‌شده. انتظار
می‌رود این آماره نزدیک به صفر بماند. افزایش
آن نشان می‌دهد کلاینتی یک نشانی را اجاره کرده،
اما متوجه شده که نشانی هم‌اکنون توسط دستگاهی
ناشناخته در شبکه در حال استفاده است. اگر این
آماره در حال رشد باشد، ممکن است نشان‌دهندهٔ
کارساز با پیکربندی نادرست یا وجود دستگاه‌هایی
با نشانی‌های ایستای متداخل باشد.
T}
_
T{
pkt6\-infrequest\-received
T}	T{
عدد صحیح
T}	T{
تعداد بسته‌های INFORMATION\-REQUEST
دریافت‌شده. انتظار می‌رود در صورت وجود
دستگاه‌هایی که از DHCPv6 بدون‌حالت استفاده
می‌کنند، این آماره افزایش یابد. پیام‌های
INFORMATION\-REQUEST توسط کلاینت‌هایی استفاده
می‌شود که پیکربندی بدون‌حالت، یعنی گزینه‌ها و
پارامترهایی غیر از نشانی‌ها یا پیشوندها را
درخواست می‌کنند.
T}
_
T{
pkt6\-lease\-query\-received
T}	T{
عدد صحیح
T}	T{
تعداد بسته‌های LEASEQUERY دریافت‌شده توسط
کتابخانهٔ قلاب leasequery. انتظار می‌رود
این آماره افزایش یابد.
T}
_
T{
pkt6\-dhcpv4\-query\-received
T}	T{
عدد صحیح
T}	T{
تعداد بسته‌های DHCPv4\-QUERY دریافت‌شده.
انتظار می‌رود در صورت وجود دستگاه‌هایی که
از DHCPv4\-over\-DHCPv6 استفاده می‌کنند،
این آماره رشد کند. پیام‌های DHCPv4\-QUERY
توسط کلاینت‌های DHCPv4 روی یک خط فقط\-IPv6
استفاده می‌شود که درخواست‌ها را روی DHCPv6
کپسوله‌سازی می‌کند.
T}
_
T{
pkt6\-dhcpv4\-response\-received
T}	T{
عدد صحیح
T}	T{
تعداد بسته‌های DHCPv4\-RESPONSE دریافت‌شده.
انتظار می‌رود این آماره همیشه صفر بماند،
زیرا بسته‌های DHCPv4\-RESPONSE توسط کارساز
ارسال می‌شوند و انتظار نمی‌رود کارساز هرگز
آن‌ها را دریافت کند. مقدار غیرصفر نشان‌دهندهٔ
خطا است. یک دلیل محتمل می‌تواند یک عامل رلهٔ
نادرست باشد که پیام DHCPv4\-RESPONSE را به
جای کلاینت‌ها، به اشتباه به سمت کارساز
بازپخش می‌کند.
T}
_
T{
pkt6\-addr\-reg\-inform\-received
T}	T{
عدد صحیح
T}	T{
تعداد بسته‌های ADDR\-REG\-INFORM دریافت‌شده.
انتظار می‌رود در صورت وجود دستگاه‌هایی که از
ثبت نشانی استفاده می‌کنند، این آماره رشد کند.
T}
_
T{
pkt6\-addr\-reg\-reply\-received
T}	T{
عدد صحیح
T}	T{
تعداد بسته‌های ADDR\-REG\-REPLY دریافت‌شده.
انتظار می‌رود این آماره همیشه صفر بماند، زیرا
بسته‌های ADDR\-REG\-REPLY توسط کارساز ارسال
می‌شوند و کارساز هرگز نباید آن‌ها را دریافت کند.
مقدار غیرصفر نشان‌دهندهٔ خطا است. یک دلیل محتمل
می‌تواند عامل رله‌ای باشد که به اشتباه پیام
ADDR\-REG\-REPLY را به سمت کارساز بازپخش می‌کند.
T}
_
T{
pkt6\-unknown\-received
T}	T{
عدد صحیح
T}	T{
تعداد بسته‌های دریافت‌شده با نوع ناشناخته.
مقدار غیرصفر برای این آماره نشان می‌دهد کارساز
بسته‌ای را دریافت کرده که قادر به شناسایی آن
نبوده است؛ یا نوع آن پشتیبانی‌نشده بوده یا
احتمالاً مخدوش بوده است.
T}
_
T{
pkt6\-sent
T}	T{
عدد صحیح
T}	T{
تعداد بسته‌های DHCPv6 ارسال‌شده. انتظار
می‌رود با هر بار ارسال بسته توسط کارساز، این
آماره رشد کند. به طور کلی، این مقدار باید
تقریباً با \fBpkt6\-received\fP همخوانی داشته
باشد، زیرا بیشتر بسته‌های ورودی باعث پاسخ دادن
کارساز می‌شوند. استثناهایی وجود دارد (مانند
دریافت یک REQUEST با شناسهٔ کارساز متعلق به
کارسازی دیگر)، بنابراین اگر از \fBpkt6\-received\fP
کمتر بود جای نگرانی نیست.
T}
_
T{
pkt6\-advertise\-sent
T}	T{
عدد صحیح
T}	T{
تعداد بسته‌های ADVERTISE ارسال‌شده. انتظار
می‌رود در بیشتر موارد پس از پردازش یک SOLICIT،
این آماره افزایش یابد. موارد نامعمول اما معتبری
وجود دارد که در آن‌ها بسته‌های SOLICIT ورودی
دور ریخته می‌شوند، اما در کل انتظار می‌رود این
آماره به \fBpkt6\-solicit\-received\fP نزدیک باشد.
T}
_
T{
pkt6\-reply\-sent
T}	T{
عدد صحیح
T}	T{
تعداد بسته‌های REPLY ارسال‌شده. انتظار می‌رود
در بیشتر موارد پس از پردازش SOLICIT (با
rapid\-commit)،‏ REQUEST،‏ RENEW،‏ REBIND،‏
RELEASE،‏ DECLINE، یا INFORMATION\-REQUEST
این آماره رشد کند. در موارد خاصی پاسخی ارسال
نمی‌شود.
T}
_
T{
pkt6\-lease\-query\-reply\-sent
T}	T{
عدد صحیح
T}	T{
تعداد بسته‌های LEASEQUERY\-REPLY ارسال‌شده
توسط کتابخانهٔ قلاب leasequery. انتظار می‌رود
این آماره افزایش یابد.
T}
_
T{
pkt6\-dhcpv4\-response\-sent
T}	T{
عدد صحیح
T}	T{
تعداد بسته‌های DHCPv4\-RESPONSE ارسال‌شده.
انتظار می‌رود در بیشتر موارد پس از پردازش یک
DHCPv4\-QUERY این آماره افزایش یابد. در موارد
خاصی پاسخی ارسال نمی‌شود.
T}
_
T{
pkt6\-addr\-reg\-reply\-sent
T}	T{
عدد صحیح
T}	T{
تعداد بسته‌های ADDR\-REG\-REPLY ارسال‌شده.
انتظار می‌رود در بیشتر موارد پس از پردازش یک
ADDR\-REG\-INFORM این آماره رشد کند. در موارد
خاصی پاسخی ارسال نمی‌شود.
T}
_
T{
subnet[id].total\-nas
T}	T{
عدد صحیح بزرگ
T}	T{
تعداد کل نشانی‌های NA موجود برای مدیریت DHCPv6
در یک زیرشبکهٔ مشخص؛ به عبارت دیگر، این مقدار
شمارش همهٔ نشانی‌ها در تمامی استخرهای
پیکربندی‌شده است. این آماره فقط در طول تغییرات
پیکربندی تغییر می‌کند. این مقدار نشانی‌هایی را که
ممکن است به دلیل رزرو میزبان رزرو شده باشند شامل
نمی‌شود. شناسهٔ \fIid\fP شناسهٔ زیرشبکهٔ مربوطه است.
این آماره برای هر زیرشبکه به طور جداگانه ارائه
می‌شود، و در حین رویداد پیکربندی مجدد بازنشانی
می‌گردد.
T}
_
T{
subnet[id].pool[pid].total\-nas
T}	T{
عدد صحیح بزرگ
T}	T{
تعداد کل نشانی‌های NA موجود برای مدیریت DHCPv6
در یک استخر زیرشبکهٔ مشخص؛ به بیان دیگر، این
تعداد همهٔ نشانی‌های موجود در استخر زیرشبکهٔ
پیکربندی‌شده است. این آماره فقط در طول تغییرات
پیکربندی تغییر می‌کند. نشانی‌هایی که به دلیل
رزرو میزبان رزرو شده باشند به حساب نمی‌آیند.
شناسهٔ \fIid\fP شناسهٔ زیرشبکه و \fIpid\fP شناسهٔ
استخر مربوطه است. این آماره برای هر استخر زیرشبکه
به طور جداگانه ارائه شده و در حین رویداد پیکربندی
مجدد بازنشانی می‌شود.
T}
_
T{
assigned\-nas
T}	T{
عدد صحیح
T}	T{
تعداد نشانی‌های NA که واگذار شده‌اند. این
مقدار با هر بار تخصیص اجارهٔ جدید (در نتیجهٔ
دریافت پیام REQUEST) افزایش یافته و با هر بار
آزادسازی اجاره (دریافت پیام RELEASE) یا انقضای
آن کاهش می‌یابد، و در حین رویداد پیکربندی مجدد
بازنشانی می‌شود.
T}
_
T{
cumulative\-assigned\-nas
T}	T{
عدد صحیح
T}	T{
تعداد تجمعی نشانی‌های NA که از زمان راه‌اندازی
کارساز واگذار شده‌اند. این آماره با هر بار واگذاری
نشانی NA افزایش می‌یابد و هنگام پیکربندی مجدد
کارساز بازنشانی نمی‌شود.
T}
_
T{
subnet[id].cumulative\-assigned\-nas
T}	T{
عدد صحیح
T}	T{
تعداد تجمعی نشانی‌های NA در یک زیرشبکهٔ مشخص
که واگذار شده‌اند. این مقدار با هر بار تخصیص
اجارهٔ جدید (در نتیجهٔ دریافت پیام REQUEST)
افزایش یافته و هرگز کاهش نمی‌یابد. شناسهٔ
\fIid\fP شناسهٔ زیرشبکه است. این آماره برای هر
زیرشبکه به طور جداگانه ارائه می‌شود، و در حین
رویداد پیکربندی مجدد بازنشانی می‌گردد.
T}
_
T{
subnet[id].pool[pid].cumulative\-assigned\-nas
T}	T{
عدد صحیح
T}	T{
تعداد تجمعی نشانی‌های NA در یک استخر زیرشبکهٔ
مشخص که واگذار شده‌اند. این مقدار با هر بار
تخصیص اجارهٔ جدید (در نتیجهٔ دریافت پیام
REQUEST) افزایش یافته و هرگز کاهش پیدا نمی‌کند.
شناسهٔ \fIid\fP شناسهٔ زیرشبکه و \fIpid\fP شناسهٔ
استخر مربوطه است. این آماره برای هر استخر
زیرشبکه جداگانه ارائه می‌شود و در رویداد پیکربندی
مجدد بازنشانی می‌گردد.
T}
_
T{
subnet[id].assigned\-nas
T}	T{
عدد صحیح
T}	T{
تعداد نشانی‌های NA در یک زیرشبکهٔ مشخص که
واگذار شده‌اند. این مقدار با هر بار تخصیص
اجارهٔ جدید (در نتیجهٔ دریافت پیام REQUEST)
افزایش یافته و با هر بار آزادسازی اجاره (دریافت
پیام RELEASE) یا انقضای آن کاهش می‌یابد. شناسهٔ
\fIid\fP شناسهٔ زیرشبکه است. این آماره برای هر
زیرشبکه جداگانه ارائه می‌شود و در حین پیکربندی
مجدد بازنشانی می‌گردد.
T}
_
T{
subnet[id].pool[pid].assigned\-nas
T}	T{
عدد صحیح
T}	T{
تعداد نشانی‌های NA در یک استخر زیرشبکهٔ مشخص
که واگذار شده‌اند. این مقدار با هر بار تخصیص
اجارهٔ جدید (در نتیجهٔ دریافت پیام REQUEST)
افزایش یافته و با هر بار آزادسازی اجاره (دریافت
پیام RELEASE) یا انقضای آن کاهش می‌یابد. شناسهٔ
\fIid\fP شناسهٔ زیرشبکه و \fIpid\fP شناسهٔ استخر
است. این آماره برای هر استخر زیرشبکه جداگانه
ارائه شده و در حین پیکربندی مجدد بازنشانی می‌گردد.
T}
_
T{
subnet[id].total\-pds
T}	T{
عدد صحیح بزرگ
T}	T{
تعداد کل پیشوندهای PD موجود برای مدیریت DHCPv6
در یک زیرشبکهٔ مشخص؛ به عبارت دیگر، این مقدار
شمارش همهٔ پیشوندها در تمامی استخرهای
پیکربندی‌شده است. این آماره فقط در طول تغییرات
پیکربندی تغییر می‌کند. توجه داشته باشید که هیچ‌یک
از پیشوندهایی که ممکن است به دلیل رزرو میزبان
رزرو شده باشند به حساب نمی‌آیند. شناسهٔ \fIid\fP
شناسهٔ زیرشبکه است. این آماره برای هر زیرشبکه
جداگانه ارائه می‌شود و در حین رویداد پیکربندی
مجدد بازنشانی می‌گردد.
T}
_
T{
subnet[id].pd\-pool[pid].total\-pds
T}	T{
عدد صحیح بزرگ
T}	T{
تعداد کل پیشوندهای PD موجود برای مدیریت DHCPv6
در یک استخر زیرشبکهٔ مشخص؛ به عبارت دیگر، این
تعداد کل پیشوندها در یک استخر PD زیرشبکهٔ
پیکربندی‌شده است. این آماره فقط در حین تغییرات
پیکربندی تغییر می‌کند. این مقدار پیشوندهای رزروشده
به دلیل رزرو میزبان را شامل نمی‌شود. شناسهٔ
\fIid\fP شناسهٔ زیرشبکه و \fIpid\fP شناسهٔ استخر
مشخص است. این آماره برای هر استخر PD زیرشبکه
جداگانه ارائه شده و در حین رویداد پیکربندی مجدد
بازنشانی می‌شود.
T}
_
T{
assigned\-pds
T}	T{
عدد صحیح
T}	T{
تعداد پیشوندهای PD که واگذار شده‌اند. این
مقدار با هر بار تخصیص اجارهٔ جدید (در نتیجهٔ
دریافت پیام REQUEST) افزایش یافته و با هر بار
آزادسازی اجاره (دریافت پیام RELEASE) یا انقضای
آن کاهش می‌یابد، و در حین رویداد پیکربندی مجدد
بازنشانی می‌شود.
T}
_
T{
cumulative\-assigned\-pds
T}	T{
عدد صحیح
T}	T{
تعداد تجمعی پیشوندهای PD که از زمان راه‌اندازی
کارساز واگذار شده‌اند. این مقدار با هر بار واگذاری
پیشوند PD افزایش می‌یابد و هنگام پیکربندی مجدد
کارساز بازنشانی نمی‌شود.
T}
_
T{
subnet[id].cumulative\-assigned\-pds
T}	T{
عدد صحیح
T}	T{
تعداد تجمعی پیشوندهای PD در یک زیرشبکهٔ مشخص
که واگذار شده‌اند. این مقدار با هر بار تخصیص
اجارهٔ جدید (در نتیجهٔ دریافت پیام REQUEST)
افزایش یافته و هرگز کاهش نمی‌یابد. شناسهٔ
\fIid\fP شناسهٔ زیرشبکه است. این آماره برای هر
زیرشبکه جداگانه ارائه می‌شود و در حین پیکربندی
مجدد بازنشانی می‌گردد.
T}
_
T{
subnet[id].pd\-pool[pid].cumulative\-assigned\-pds
T}	T{
عدد صحیح
T}	T{
تعداد تجمعی پیشوندهای PD در یک استخر PD
زیرشبکهٔ مشخص که واگذار شده‌اند. این مقدار با
هر بار تخصیص اجارهٔ جدید (در نتیجهٔ دریافت پیام
REQUEST) افزایش می‌یابد و هرگز کاهش نمی‌یابد.
شناسهٔ \fIid\fP شناسهٔ زیرشبکه و \fIpid\fP شناسهٔ
استخر PD مربوطه است. این آماره برای هر استخر PD
زیرشبکه جداگانه ارائه شده و در حین رویداد
پیکربندی مجدد بازنشانی می‌گردد.
T}
_
T{
subnet[id].assigned\-pds
T}	T{
عدد صحیح
T}	T{
تعداد پیشوندهای PD در یک زیرشبکهٔ مشخص که
واگذار شده‌اند. این مقدار با هر بار تخصیص
اجارهٔ جدید (در نتیجهٔ دریافت پیام REQUEST)
افزایش یافته و با هر بار آزادسازی اجاره (دریافت
پیام RELEASE) یا انقضای آن کاهش می‌یابد. شناسهٔ
\fIid\fP شناسهٔ زیرشبکه است. این آماره برای هر
زیرشبکه جداگانه ارائه شده و در حین پیکربندی
مجدد بازنشانی می‌گردد.
T}
_
T{
subnet[id].pd\-pool[pid].assigned\-pds
T}	T{
عدد صحیح
T}	T{
تعداد پیشوندهای PD در یک pd\-pool زیرشبکهٔ مشخص
که واگذار شده‌اند. این مقدار با هر بار تخصیص
اجارهٔ جدید (در نتیجهٔ دریافت پیام REQUEST)
افزایش یافته و با هر بار آزادسازی اجاره (دریافت
پیام RELEASE) یا انقضای آن کاهش می‌یابد. شناسهٔ
\fIid\fP شناسهٔ زیرشبکه و \fIpid\fP شناسهٔ استخر
PD است. این آماره برای هر استخر PD زیرشبکه
جداگانه ارائه شده و در حین رویداد پیکربندی مجدد
بازنشانی می‌شود.
T}
_
T{
reclaimed\-leases
T}	T{
عدد صحیح
T}	T{
تعداد اجاره‌های منقضی‌شده‌ای که از زمان راه‌اندازی
کارساز بازپس‌گیری شده‌اند. این آماره با هر بار
بازپس‌گیری یک اجارهٔ منقضی‌شده افزایش می‌یابد
(هر دو بازپس‌گیری NA و PD را شامل می‌شود).
این آماره هرگز کاهش نمی‌یابد. می‌توان از آن به
عنوان یک شاخص بلندمدت برای تعداد کل اجاره‌های
واقعی بازپس‌گرفته‌شده استفاده کرد. این یک آمارهٔ
سراسری است که تمام زیرشبکه‌ها را پوشش می‌دهد.
T}
_
T{
subnet[id].reclaimed\-leases
T}	T{
عدد صحیح
T}	T{
تعداد اجاره‌های منقضی‌شدهٔ وابسته به یک زیرشبکهٔ
مشخص که از زمان راه‌اندازی کارساز بازپس‌گیری
شده‌اند. این آماره با هر بار بازپس‌گیری یک اجارهٔ
منقضی‌شده افزایش می‌یابد (شامل هر دو بازپس‌گیری
NA و PD). شناسهٔ \fIid\fP شناسهٔ زیرشبکه است.
این آماره برای هر زیرشبکه جداگانه ارائه می‌شود.
T}
_
T{
subnet[id].pool[pid].reclaimed\-leases
T}	T{
عدد صحیح
T}	T{
تعداد نشانی‌های NA منقضی‌شدهٔ وابسته به یک
استخر زیرشبکهٔ مشخص که از زمان راه‌اندازی
کارساز بازپس‌گیری شده‌اند. این آماره با هر بار
بازپس‌گیری اجارهٔ منقضی‌شده افزایش می‌یابد. شناسهٔ
\fIid\fP شناسهٔ زیرشبکه و \fIpid\fP شناسهٔ استخر
است. این آماره برای هر استخر زیرشبکه جداگانه
ارائه شده و در حین رویداد پیکربندی مجدد بازنشانی
می‌گردد.
T}
_
T{
subnet[id].pd\-pool[pid].reclaimed\-leases
T}	T{
عدد صحیح
T}	T{
تعداد پیشوندهای PD منقضی‌شدهٔ وابسته به یک
استخر PD زیرشبکهٔ مشخص که از زمان راه‌اندازی
کارساز بازپس‌گیری شده‌اند. این آماره با هر بار
بازپس‌گیری اجارهٔ منقضی‌شده افزایش می‌یابد. شناسهٔ
\fIid\fP شناسهٔ زیرشبکه و \fIpid\fP شناسهٔ استخر
PD است. این آماره برای هر استخر PD زیرشبکه
جداگانه ارائه شده و در حین رویداد پیکربندی مجدد
بازنشانی می‌گردد.
T}
_
T{
declined\-addresses
T}	T{
عدد صحیح
T}	T{
تعداد نشانی‌های IPv6 که هم‌اکنون رد شده‌اند
(declined)؛ شمارشی از تعداد اجاره‌هایی که
در حال حاضر در دسترس نیستند. به محض بازیابی
یک اجاره، این آماره کاهش می‌یابد؛ در حالت
ایده‌آل، این آماره باید صفر باشد. اگر این مقدار
غیرصفر بوده یا رو به افزایش باشد، مدیر شبکه باید
بررسی کند که آیا دستگاه ناهنجاری در شبکه وجود
دارد یا خیر. این یک آمارهٔ سراسری است که تمامی
زیرشبکه‌ها را پوشش می‌دهد.
T}
_
T{
subnet[id].declined\-addresses
T}	T{
عدد صحیح
T}	T{
تعداد نشانی‌های IPv6 که در حال حاضر در یک
زیرشبکهٔ مشخص رد شده‌اند؛ شمارشی از تعداد
اجاره‌هایی که فعلاً در دسترس نیستند. به محض
بازیابی اجاره، این آماره کاهش می‌یابد؛ در حالت
ایده‌آل، این آماره باید صفر باشد. اگر این مقدار
غیرصفر باشد یا افزایش یابد، مدیر شبکه باید بررسی
کند که آیا دستگاه ناهنجاری در شبکه وجود دارد یا
خیر. شناسهٔ \fIid\fP شناسهٔ زیرشبکه است. این
آماره برای هر زیرشبکه جداگانه ارائه می‌شود.
T}
_
T{
subnet[id].pool[pid].declined\-addresses
T}	T{
عدد صحیح
T}	T{
تعداد نشانی‌های IPv6 که هم‌اکنون در یک استخر
زیرشبکهٔ مشخص رد شده‌اند؛ شمارشی از تعداد
اجاره‌هایی که فعلاً در دسترس نیستند. به محض
بازیابی اجاره، این آماره کاهش می‌یابد؛ در حالت
ایده‌آل، این آماره باید صفر باشد. اگر این مقدار
غیرصفر بوده یا در حال افزایش باشد، مدیر شبکه
باید وجود دستگاه ناهنجار در شبکه را بررسی کند.
شناسهٔ \fIid\fP شناسهٔ زیرشبکه و \fIpid\fP شناسهٔ
استخر است. این آماره برای هر استخر زیرشبکه به طور
جداگانه ارائه می‌شود.
T}
_
T{
reclaimed\-declined\-addresses
T}	T{
عدد صحیح
T}	T{
تعداد نشانی‌های IPv6 که رد شده بودند، اما اکنون
بازیابی شده‌اند. بر خلاف \fBdeclined\-addresses\fP،
این آماره هرگز کاهش نمی‌یابد. می‌توان از آن به
عنوان یک شاخص بلندمدت برای تعداد کل ردشدگی‌های
معتبری که پردازش و بازیابی شده‌اند استفاده کرد.
این یک آمارهٔ سراسری است که همهٔ زیرشبکه‌ها را
پوشش می‌دهد.
T}
_
T{
subnet[id].reclaimed\-declined\-addresses
T}	T{
عدد صحیح
T}	T{
تعداد نشانی‌های IPv6 که رد شده بودند، اما اکنون
بازیابی شده‌اند. بر خلاف \fBdeclined\-addresses\fP،
این آماره هرگز کاهش نمی‌یابد. می‌توان از آن به
عنوان شاخصی بلندمدت برای تعداد کل ردشدگی‌های
معتبری که پردازش و بازیابی شده‌اند استفاده کرد.
شناسهٔ \fIid\fP شناسهٔ زیرشبکه است. این آماره برای
هر زیرشبکه جداگانه ارائه می‌شود.
T}
_
T{
subnet[id].pool[pid].reclaimed\-declined\-addresses
T}	T{
عدد صحیح
T}	T{
تعداد نشانی‌های IPv6 که رد شده بودند، اما اکنون
بازیابی شده‌اند. بر خلاف \fBdeclined\-addresses\fP،
این آماره هرگز کاهش نمی‌یابد. می‌توان از آن به
عنوان شاخصی بلندمدت برای تعداد ردشدگی‌های معتبری
که پردازش و بازیابی شده‌اند استفاده کرد. شناسهٔ
\fIid\fP شناسهٔ زیرشبکه و \fIpid\fP شناسهٔ استخر
است. این آماره برای هر استخر زیرشبکه جداگانه
ارائه می‌گردد.
T}
_
T{
v6\-allocation\-fail
T}	T{
عدد صحیح
T}	T{
تعداد کل شکست‌ها در تخصیص نشانی برای یک کلاینت
خاص. این شامل تعداد تلاش‌هایی برای تخصیص اجاره است
که کارساز پیش از انصراف انجام داده است، در صورتی
که قادر به استفاده از هیچ‌یک از استخرهای نشانی
نبوده باشد. این یک آمارهٔ سراسری است که همهٔ
زیرشبکه‌ها را پوشش می‌دهد.
T}
_
T{
subnet[id].v6\-allocation\-fail
T}	T{
عدد صحیح
T}	T{
تعداد کل شکست‌ها در تخصیص نشانی برای یک کلاینت
خاص. این شامل تعداد تلاش‌های تخصیص اجاره است که
کارساز پیش از انصراف انجام داده است، در صورتی که
نتوانسته باشد از هیچ‌یک از استخرهای نشانی استفاده
کند. شناسهٔ \fIid\fP شناسهٔ زیرشبکه است. این آماره
برای هر زیرشبکه جداگانه ارائه می‌شود.
T}
_
T{
v6\-allocation\-fail\-shared\-network
T}	T{
عدد صحیح
T}	T{
تعداد شکست‌ها در تخصیص نشانی برای یک کلاینت خاص
متصل به یک شبکهٔ اشتراکی (shared network). این یک
آمارهٔ سراسری است که همهٔ زیرشبکه‌ها را پوشش می‌دهد.
T}
_
T{
subnet[id].v6\-allocation\-fail\-shared\-network
T}	T{
عدد صحیح
T}	T{
تعداد شکست‌ها در تخصیص نشانی برای یک کلاینت خاص
متصل به یک شبکهٔ اشتراکی. شناسهٔ \fIid\fP شناسهٔ
زیرشبکه است. این آماره برای هر زیرشبکه جداگانه
ارائه می‌شود.
T}
_
T{
v6\-allocation\-fail\-subnet
T}	T{
عدد صحیح
T}	T{
تعداد شکست‌های تخصیص نشانی برای یک کلاینت خاص
متصل به زیرشبکه‌ای که به یک شبکهٔ اشتراکی تعلق
ندارد. این یک آمارهٔ سراسری است که همهٔ
زیرشبکه‌ها را پوشش می‌دهد.
T}
_
T{
subnet[id].v6\-allocation\-fail\-subnet
T}	T{
عدد صحیح
T}	T{
تعداد شکست‌های تخصیص نشانی برای یک کلاینت خاص
متصل به زیرشبکه‌ای که به یک شبکهٔ اشتراکی تعلق
ندارد. شناسهٔ \fIid\fP شناسهٔ زیرشبکه است. این
آماره برای هر زیرشبکه جداگانه ارائه می‌شود.
T}
_
T{
v6\-allocation\-fail\-no\-pools
T}	T{
عدد صحیح
T}	T{
تعداد شکست‌های تخصیص نشانی به این دلیل که کارساز
نتوانسته است از هیچ استخر پیکربندی‌شده‌ای برای یک
کلاینت خاص استفاده کند. همچنین این احتمال وجود
دارد که تمام زیرشبکه‌هایی که کارساز تلاش کرده از
آن‌ها نشانی تخصیص دهد فاقد استخر نشانی باشند.
در این وضعیت، چنانچه مدیر سیستم انتظار داشته باشد
که به برخی کلاینت‌ها نشانی‌های پویا تخصیص یابد،
این مورد باید یک پیکربندی نادرست تلقی شود. این
یک آمارهٔ سراسری است که همهٔ زیرشبکه‌ها را پوشش
می‌دهد.
T}
_
T{
subnet[id].v6\-allocation\-fail\-no\-pools
T}	T{
عدد صحیح
T}	T{
تعداد شکست‌های تخصیص نشانی به این دلیل که کارساز
نتوانسته است از هیچ استخر پیکربندی‌شده‌ای برای یک
کلاینت خاص استفاده کند. همچنین ممکن است همهٔ
زیرشبکه‌هایی که کارساز سعی در تخصیص نشانی از آن‌ها
داشته فاقد استخر نشانی باشند. در این صورت، اگر
مدیر انتظار تخصیص نشانی پویا به کلاینت‌ها را داشته
باشد، این یک پیکربندی نادرست است. شناسهٔ \fIid\fP
شناسهٔ زیرشبکه است. این آماره برای هر زیرشبکه
جداگانه ارائه می‌شود.
T}
_
T{
v6\-allocation\-fail\-classes
T}	T{
عدد صحیح
T}	T{
تعداد شکست‌های تخصیص نشانی هنگامی که بستهٔ
کلاینت به یک یا چند کلاس تعلق دارد. دلایل مختلفی
برای عدم تخصیص اجاره وجود دارد: برای نمونه، اگر همهٔ
استخرها نیازمند عضویت بسته‌ها در کلاس‌های خاصی
باشند و بستهٔ ورودی به هیچ‌کدام تعلق نداشته باشد.
حالت دیگر مفید بودن این اطلاعات، نشان دادن پایان
یافتن نشانی‌های استخر رزروشده برای یک کلاس خاص است.
این یک آمارهٔ سراسری است که همهٔ زیرشبکه‌ها را
پوشش می‌دهد.
T}
_
T{
subnet[id].v6\-allocation\-fail\-classes
T}	T{
عدد صحیح
T}	T{
تعداد شکست‌های تخصیص نشانی هنگامی که بستهٔ
کلاینت به یک یا چند کلاس تعلق دارد. دلایل مختلفی
برای عدم تخصیص اجاره وجود دارد: برای نمونه، اگر
همهٔ استخرها نیازمند عضویت بسته‌ها در کلاس‌های
خاصی باشند و بستهٔ ورودی به هیچ‌کدام تعلق نداشته
باشد. حالت دیگر مفید بودن این اطلاعات، نشان دادن
اتمام نشانی‌های استخر رزروشده برای یک کلاس خاص
است. شناسهٔ \fIid\fP شناسهٔ زیرشبکه است. این
آماره برای هر زیرشبکه جداگانه ارائه می‌شود.
T}
_
T{
v6\-ia\-na\-lease\-reuses
T}	T{
عدد صحیح
T}	T{
تعداد دفعاتی که به عنوان بخشی از قابلیت
lease caching، مقدار CLTT یک اجارهٔ IA_NA در
حافظه افزایش یافته و زمان انقضای آن در فضای
ذخیره‌سازی پایدار دست‌نخورده باقی مانده است.
به این فرآیند «استفادهٔ مجدد از اجاره» (lease reuse)
گفته می‌شود. این یک آمارهٔ سراسری است.
T}
_
T{
subnet[id].v6\-ia\-na\-lease\-reuses
T}	T{
عدد صحیح
T}	T{
تعداد دفعاتی که به عنوان بخشی از قابلیت
lease caching، مقدار CLTT یک اجارهٔ IA_NA در
حافظه افزایش یافته و زمان انقضای آن در فضای
ذخیره‌سازی پایدار دست‌نخورده باقی مانده است.
به این فرآیند استفادهٔ مجدد از اجاره گفته
می‌شود. این آماره به ازای هر زیرشبکه است.
شناسهٔ \fIid\fP شناسهٔ زیرشبکهٔ مورد نظر است.
T}
_
T{
v6\-ia\-pd\-lease\-reuses
T}	T{
عدد صحیح
T}	T{
تعداد دفعاتی که به عنوان بخشی از قابلیت
lease caching، مقدار CLTT یک اجارهٔ IA_PD در
حافظه افزایش یافته و زمان انقضای آن در فضای
ذخیره‌سازی پایدار بدون تغییر رها شده است. به این
فرآیند استفادهٔ مجدد از اجاره گفته می‌شود. این
یک آمارهٔ سراسری است.
T}
_
T{
subnet[id].v6\-ia\-pd\-lease\-reuses
T}	T{
عدد صحیح
T}	T{
تعداد دفعاتی که به عنوان بخشی از قابلیت
lease caching، مقدار CLTT یک اجارهٔ IA_PD در
حافظه افزایش یافته و زمان انقضای آن در فضای
ذخیره‌سازی پایدار بدون تغییر رها شده است. به این
فرآیند استفادهٔ مجدد از اجاره گفته می‌شود. این
آماره به ازای هر زیرشبکه است. شناسهٔ \fIid\fP
شناسهٔ زیرشبکهٔ مورد نظر است.
T}
_
T{
cumulative\-registered
T}	T{
عدد صحیح
T}	T{
تعداد تجمعی نشانی‌های NA که از زمان راه‌اندازی
کارساز به ثبت رسیده‌اند. این آماره با هر بار ثبت
یک نشانی NA افزایش یافته و هنگام پیکربندی مجدد
کارساز بازنشانی نمی‌شود.
T}
_
T{
subnet[id].cumulative\-registered
T}	T{
عدد صحیح
T}	T{
تعداد تجمعی نشانی‌های NA در یک زیرشبکهٔ مشخص
که به ثبت رسیده‌اند. این مقدار با هر بار ثبت یک
نشانی جدید (در نتیجهٔ دریافت پیام ADDR\-REG\-INFORM)
افزایش می‌یابد و هرگز کاهش پیدا نمی‌کند. شناسهٔ
\fIid\fP شناسهٔ زیرشبکه است. این آماره برای هر
زیرشبکه جداگانه ارائه می‌شود و در حین رویداد
پیکربندی مجدد بازنشانی می‌گردد.
T}
_
T{
subnet[id].registered
T}	T{
عدد صحیح
T}	T{
تعداد نشانی‌های NA در یک زیرشبکهٔ مشخص که به
ثبت رسیده‌اند. این مقدار با هر بار ثبت یک نشانی
جدید (در نتیجهٔ دریافت پیام ADDR\-REG\-INFORM)
افزایش یافته و با هر بار انقضای یک ثبت کاهش
می‌یابد. شناسهٔ \fIid\fP شناسهٔ زیرشبکه است. این
آماره برای هر زیرشبکه جداگانه ارائه می‌شود و در
حین رویداد پیکربندی مجدد بازنشانی می‌گردد.
T}
.TE
.sp
بسته‌های ورودی دور ریخته‌شده را می‌توان در \fBpkt6\-receive\-drop\fP و
شمارندهٔ دومی که جزئیات دلیل دور انداختن را شرح می‌دهد، شمارش کرد:
.INDENT 0.0.IP \(bu 2
\fBpkt6\-service\-disabled\fP \- سرویس DHCP غیرفعال است
.IP \(bu 2
\fBpkt6\-parse\-failed\fP \- تجزیه بسته با یک خطای مهلک مواجه شد
.IP \(bu 2
\fBpkt6\-queue\-full\fP \- بسته‌ای که قرار بود در صفی که پر بود نگهداری شود
.IP \(bu 2
\fBpkt6\-duplicate\fP \- نسخه تکراری از بسته‌ای که در حال پردازش است
.IP \(bu 2
\fBpkt6\-rfc\-violation\fP \- نقض RFC (یعنی مشخصات پروتکل دستور به دور انداختن آنها می‌دهد)
.IP \(bu 2
\fBpkt6\-admin\-filtered\fP \- توسط مدیر سیستم فیلتر شده است
.IP \(bu 2
\fBpkt6\-not\-for\-us\fP \- باید توسط سرور دیگری مدیریت شود
.IP \(bu 2
\fBpkt6\-processing\-failed\fP \- هنگام پردازش با خطای غیرمنتظره‌ای مواجه شد
.IP \(bu 2
\fBpkt6\-limit\-exceeded\fP \- توسط کتابخانه قلاب محدودیت‌ها (libdhcp_limits.so: Limits to Manage Lease Allocation and Packet Processing \%<#\:hooks-limits>) دور انداخته شد
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
شناسه استخر (pool ID) را می‌توان با تنظیم صریح پارامتر \fBpool\-id\fP در نگاشت پارامترهای استخر، روی هر استخر پیکربندی کرد. در صورت عدم پیکربندی، مقدار پیش‌فرض \fBpool\-id\fP برابر 0 خواهد بود. آمارهای مربوط به شناسه استخر 0 به تمام آمارهای همه استخرهایی اشاره دارد که \fBpool\-id\fP آنها پیکربندی نشده است\&. شناسه استخر نیازی نیست که در داخل یک زیرشبکه یا در میان زیرشبکه‌ها یکتا باشد. آمارهای مربوط به یک شناسه استخر مشخص در یک زیرشبکه با سایر آمارهای تمام استخرهای دیگری که همان شناسه استخر را در آن زیرشبکه دارند ادغام می‌شود.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این بخش، آمارهای مختص DHCPv6 را شرح می‌دهد. برای بررسی اجمالی و نحوه استفاده از آمارها، Statistics \%<#\:stats>\& را ببینید.
.UNINDENT
.UNINDENT
.sp
سرور DHCPv6 دو پارامتر سراسری برای کنترل محدودیت‌های نمونه پیش‌فرض آمارها ارائه می‌دهد:
.INDENT 0.0
.IP \(bu 2
\fBstatistic\-default\-sample\-count\fP \- حداکثر تعداد پیش‌فرض نمونه‌هایی را که باید نگهداری شوند تعیین می‌کند. مقدار ویژه 0 نشان می‌دهد که باید از یک حداکثر سن پیش‌فرض استفاده شود.
.IP \(bu 2
\fBstatistic\-default\-sample\-age\fP \- حداکثر سن پیش‌فرض نمونه‌هایی را که باید نگهداری شوند، بر حسب ثانیه، تعیین می‌کند.
.UNINDENT
.sp
برای نمونه، جهت کاهش بار اضافی نگهداری آمار، حداکثر تعداد پیش‌فرض نمونه‌ها را روی 1 تنظیم کنید تا تنها یک نمونه نگهداری شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqstatistic\-default\-sample\-count\(dq: 1,
    \(dqsubnet6\(dq: [
        {
            ...
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
آمارها را می‌توان به‌صورت دوره‌ای بازیابی کرد تا بینش بیشتری درباره عملیات Kea به دست آورد. ابزاری که از این قابلیت بهره می‌برد ISC Stork است. برای جزئیات به Monitoring Kea With Stork \%<#\:stork> مراجعه کنید.
.SS رابط مدیریت برای سرور DHCPv6 (Management API for the DHCPv6 Server)
.sp
رابط مدیریتی (Management API) امکان صدور دستورهای مدیریتی مشخص، نظیر بازیابی آمار، پیکربندی مجدد یا خاموش‌سازی را فراهم می‌کند. برای جزئیات بیشتر، Management API \%<#\:ctrl-channel>\& را ببینید. به‌طور پیش‌فرض هیچ سوکتی باز نیست؛ برای صدور دستور به Kea جهت باز کردن یک سوکت، می‌توان از مدخل زیر در فایل پیکربندی استفاده کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqcontrol\-sockets\(dq: [
        {
            \(dqsocket\-type\(dq: \(dqunix\(dq,
            \(dqsocket\-name\(dq: \(dq/path/to/the/unix/socket\(dq
        }
    ],

    \(dqsubnet6\(dq: [
        {
            ...
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.SS سوکت کنترل یونیکس (UNIX Control Socket)
.sp
تا سرور Kea نسخه 2.7.2، تنها نوع کانال ارتباطی پشتیبانی‌شده سوکت جریان UNIX با تنظیم \fBsocket\-type\fP روی \fBunix\fP و \fBsocket\-name\fP روی مسیر فایل سوکت UNIX/LOCAL بود.
.sp
طول مسیر مشخص‌شده توسط پارامتر \fBsocket\-name\fP به حداکثر طول مجاز برای نام سوکت UNIX در سیستم‌عامل مدیر سیستم، یعنی اندازه فیلد \fBsun_path\fP در ساختار \fBsockaddr_un\fP منهای 1، محدود است. این مقدار در سیستم‌عامل‌های گوناگون متغیر بوده و بین 91 تا 107 نویسه است. مقادیر معمول، 107 در Linux و 103 در FreeBSD هستند.
.sp
برنامه Kea تنها از یک سوکت کنترلی \fBunix\fP در فهرست \(dqcontrol\-sockets\(dq پشتیبانی می‌کند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
از نسخه Kea 2.7.9 به بعد، سوکت‌های کنترل فقط می‌توانند در دایرکتوری تعیین‌شده در زمان کامپایل یعنی \fB\(dq[kea\-install\-dir]/var/run/kea\(dq\fP قرار گیرند، که این دایرکتوری نیز باید دارای مجوزهای دسترسی \fB0750\fP باشد. این مسیر ممکن است در زمان راه‌اندازی با تنظیم متغیر محیطی \fBKEA_CONTROL_SOCKET_DIR\fP به مسیر مورد نظر بازنویسی شود. اگر مسیری غیر از این مقدار در \fBsocket\-name\fP استفاده شود، Kea خطایی صادر کرده و از شروع به کار خودداری می‌کند یا در صورتی که از قبل در حال اجرا باشد، یک خطای غیرقابل‌بازیابی ثبت می‌کند. برای سهولت در استفاده، کافی است بخش مسیر را از \fBsocket\-name\fP حذف کنید\&.
.UNINDENT
.UNINDENT
.sp
ارتباط روی کانال کنترل با استفاده از ساختارهای JSON انجام می‌شود. برای جزئیات بیشتر، بخش Control Channel در Kea Developer\(aqs Guide \%<https://\:reports\:.kea\:.isc\:.org/\:dev_guide/\:d2/\:d96/\:ctrlSocket\:.html> را ببینید.
.sp
سرور DHCPv6 از دستورهای عملیاتی زیر پشتیبانی می‌کند:
.INDENT 0.0
.IP \(bu 2
\fBbuild\-report\fP \%<#\:std-isccmd-build-report>
.IP \(bu 2
\fBconfig\-get\fP \%<#\:std-isccmd-config-get>
.IP \(bu 2
\fBconfig\-hash\-get\fP \%<#\:std-isccmd-config-hash-get>
.IP \(bu 2
\fBconfig\-reload\fP \%<#\:std-isccmd-config-reload>
.IP \(bu 2
\fBconfig\-set\fP \%<#\:std-isccmd-config-set>
.IP \(bu 2
\fBconfig\-test\fP \%<#\:std-isccmd-config-test>
.IP \(bu 2
\fBconfig\-write\fP \%<#\:std-isccmd-config-write>
.IP \(bu 2
\fBdhcp\-disable\fP \%<#\:std-isccmd-dhcp-disable>
.IP \(bu 2
\fBdhcp\-enable\fP \%<#\:std-isccmd-dhcp-enable>
.IP \(bu 2
\fBinterface\-add\fP \%<#\:std-isccmd-interface-add>
.IP \(bu 2
\fBinterface\-list\fP \%<#\:std-isccmd-interface-list>
.IP \(bu 2
\fBinterface\-redetect\fP \%<#\:std-isccmd-interface-redetect>
.IP \(bu 2
\fBleases\-reclaim\fP \%<#\:std-isccmd-leases-reclaim>
.IP \(bu 2
\fBlist\-commands\fP \%<#\:std-isccmd-list-commands>
.IP \(bu 2
\fBshutdown\fP \%<#\:std-isccmd-shutdown>
.IP \(bu 2
\fBstatus\-get\fP \%<#\:std-isccmd-status-get>
.IP \(bu 2
\fBversion\-get\fP \%<#\:std-isccmd-version-get>
.UNINDENT
.sp
همان‌طور که در Commands Supported by Both the DHCPv4 and DHCPv6 Servers \%<#\:commands-common>\& شرح داده شده است. علاوه بر این، از دستورهای مرتبط با آمار زیر پشتیبانی می‌کند:
.INDENT 0.0
.IP \(bu 2
\fBstatistic\-get\fP \%<#\:std-isccmd-statistic-get>
.IP \(bu 2
\fBstatistic\-reset\fP \%<#\:std-isccmd-statistic-reset>
.IP \(bu 2
\fBstatistic\-remove\fP \%<#\:std-isccmd-statistic-remove>
.IP \(bu 2
\fBstatistic\-get\fP \%<#\:std-isccmd-statistic-get>\-all
.IP \(bu 2
\fBstatistic\-reset\fP \%<#\:std-isccmd-statistic-reset>\-all
.IP \(bu 2
\fBstatistic\-remove\fP \%<#\:std-isccmd-statistic-remove>\-all
.IP \(bu 2
\fBstatistic\-sample\-age\-set\fP \%<#\:std-isccmd-statistic-sample-age-set>
.IP \(bu 2
\fBstatistic\-sample\-age\-set\fP \%<#\:std-isccmd-statistic-sample-age-set>\-all
.IP \(bu 2
\fBstatistic\-sample\-count\-set\fP \%<#\:std-isccmd-statistic-sample-count-set>
.IP \(bu 2
\fBstatistic\-sample\-count\-set\fP \%<#\:std-isccmd-statistic-sample-count-set>\-all
.UNINDENT
.sp
همان‌طور که در Commands for Manipulating Statistics \%<#\:command-stats>\& شرح داده شده است..SS سوکت کنترلی HTTP/HTTPS
.sp
مقدار \fBsocket\-type\fP باید \fBhttp\fP یا \fBhttps\fP باشد (زمانی که نوع \fBhttps\fP باشد،
TLS الزامی است). پارامترهای \fBsocket\-address\fP (پیش‌فرض \fB::1\fP) و
\fBsocket\-port\fP (پیش‌فرض 8000) آدرس IP و درگاهی را مشخص می‌کنند که
سرویس HTTP به آن مقید (bind) خواهد شد.
.sp
از نسخه Kea 2.7.5، پارامتر \fBhttp\-headers\fP فهرستی از
سرفصل‌های HTTP اضافی را برای افزودن به پاسخ‌های HTTP مشخص می‌کند.
.sp
پارامترهای \fBtrust\-anchor\fP، \fBcert\-file\fP، \fBkey\-file\fP و \fBcert\-required\fP
پیکربندی TLS را برای HTTP، یعنی HTTPS، مشخص می‌کنند. اگر این پارامترها
مشخص نشوند، HTTP استفاده می‌شود. پشتیبانی از TLS/HTTPS در Kea در
بخش TLS/HTTPS Support \%<#\:tls>\& شرح داده شده است.
.sp
احراز هویت پایه HTTP (Basic authentication) از سرور در برابر
استفاده‌های غیرمجاز توسط کاربران محلی محافظت می‌کند. برای
محافظت در برابر مهاجمان از راه دور، HTTPS و پراکسی معکوس (reverse proxy)
امنیت قوی‌تری فراهم می‌کنند.
.sp
احراز هویت در بلوک \fBauthentication\fP با پارامتر اجباری
\fBtype\fP که نوع احراز هویت را انتخاب می‌کند، شرح داده می‌شود.
در حال حاضر تنها احراز هویت پایه HTTP (نوع basic) پشتیبانی می‌شود.
.sp
پارامتر احراز هویت \fBrealm\fP (پیش‌فرض \fBkea\-dhcpv6\-server\fP)
برای پیام‌های خطا در هنگامی استفاده می‌شود که احراز هویت پایه HTTP الزامی است
اما کلاینت مجاز شناخته نشده است.
.sp
هنگامی که فهرست احراز هویت \fBclients\fP پیکربندی شده و خالی نباشد،
احراز هویت پایه HTTP الزامی است. هر عنصر از فهرست،
یک شناسه کاربری و یک گذرواژه را مشخص می‌کند. شناسه کاربری الزامی است،
نباید خالی باشد و نباید شامل نویسه دونقطه (:) باشد.
گذرواژه اختیاری است؛ در صورت عدم تعیین آن، از یک گذرواژه خالی
استفاده می‌شود.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
شناسه کاربری و گذرواژه در احراز هویت پایه HTTP با کدگذاری
UTF\-8 ذخیره می‌شوند، اما نحو JSON فعلی Kea تنها از زیرمجموعه یونی‌کد Latin\-1
(یعنی 0x00..0xff) پشتیبانی می‌کند.
.UNINDENT
.UNINDENT
.sp
برای جلوگیری از افشای شناسه کاربری و/یا گذرواژه مرتبط با آن،
می‌توان این مقادیر را از فایل‌ها خواند. نحو با موارد زیر گسترش یافته است:
.INDENT 0.0
.IP \(bu 2
پارامتر احراز هویت \fBdirectory\fP، که بخش مشترک مسیر فایل‌ها را مدیریت می‌کند.
مقدار پیش‌فرض، رشته خالی است.
.IP \(bu 2
پارامتر کلاینت \fBpassword\-file\fP، که همراه با پارامتر \fBdirectory\fP،
مسیر فایلی را مشخص می‌کند که می‌تواند حاوی گذرواژه باشد، یا اگر هیچ شناسه کاربری
ارائه نشده باشد، کل راز احراز هویت پایه HTTP را در بر گیرد.
.IP \(bu 2
پارامتر کلاینت \fBuser\-file\fP، که به همراه پارامتر \fBdirectory\fP،
مسیر فایلی را مشخص می‌کند که شناسه کاربری را می‌توان از آن خواند.
.UNINDENT
.sp
از نسخه Kea\-2.7.6، برنامه Kea از چندین اتصال HTTP/HTTPS پشتیبانی می‌کند.
هم از آدرس‌های IPv4 و هم IPv6 می‌توان استفاده کرد.
در صورت تغییر نوع سوکت از HTTP به HTTPS یا از HTTPS به HTTP با استفاده از
همان آدرس و درگاه، سرور خطا صادر خواهد کرد. این عمل مجاز نیست، زیرا ممکن است
به دلیل اشتباه سهوی کاربر، یک رخنه امنیتی ایجاد کند.
هنگام استفاده از دستور \(dqconfig\-set\(dq برای جابه‌جایی از HTTP به HTTPS یا از
HTTPS به HTTP، باید آدرس یا درگاه متفاوتی مشخص شود. همین امر هنگام تغییر
فایل پیکربندی و سپس اجرای دستور \(dqconfig\-reload\(dq نیز صدق می‌کند.
.sp
هنگامی که از فایل‌ها استفاده می‌شود، آن‌ها در زمان بارگذاری پیکربندی خوانده می‌شوند
تا خطاهای پیکربندی در سریع‌ترین زمان ممکن شناسایی شوند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqcontrol\-sockets\(dq: [
        {
            \(dqsocket\-type\(dq: \(dqhttps\(dq,
            \(dqsocket\-address\(dq: \(dq2010:30:40::50\(dq,
            \(dqsocket\-port\(dq: 8005,
            \(dqhttp\-headers\(dq: [
                {
                    \(dqname\(dq: \(dqStrict\-Transport\-Security\(dq,
                    \(dqvalue\(dq: \(dqmax\-age=31536000\(dq
                 }
            ],
            \(dqtrust\-anchor\(dq: \(dq/path/to/the/ca\-cert.pem\(dq,
            \(dqcert\-file\(dq: \(dq/path/to/the/agent\-cert.pem\(dq,
            \(dqkey\-file\(dq: \(dq/path/to/the/agent\-key.pem\(dq,
            \(dqcert\-required\(dq: true,
            \(dqauthentication\(dq: {
               \(dqtype\(dq: \(dqbasic\(dq,
               \(dqrealm\(dq: \(dqkea\-dhcpv6\-server\(dq,
               \(dqclients\(dq: [
                   {
                       \(dquser\(dq: \(dqadmin\(dq,
                       \(dqpassword\(dq: \(dq1234\(dq
                   } ]
            }
        },
        {
            \(dqsocket\-type\(dq: \(dqhttp\(dq,
            \(dqsocket\-address\(dq: \(dq10.20.30.40\(dq,
            \(dqsocket\-port\(dq: 8005
        }
    ],

    \(dqsubnet6\(dq: [
        {
            ...
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.SS زمینه‌های کاربر در IPv6
.sp
برنامه Kea امکان بارگذاری کتابخانه‌های قلاب (hook libraries) را فراهم می‌کند که گاهی می‌توانند
از پارامترهای اضافی بهره‌مند شوند. اگر چنین پارامتری مختص کل کتابخانه باشد،
معمولاً به عنوان پارامتری برای کتابخانه قلاب تعریف می‌شود. با این حال،
گاهی اوقات نیاز است پارامترهایی مشخص شوند که برای هر استخر (pool) متفاوت باشند.
.sp
برای پیش‌زمینه بیشتر در رابطه با ایده user\-context، به بخش Comments and User Context \%<#\:user-context>
مراجعه کنید. برای بررسی موضوع از دیدگاه قلاب‌ها، به User Contexts in Hooks \%<#\:user-context-hooks> مراجعه کنید.
.sp
زمینه‌های کاربر (user contexts) را می‌توان در دامنه سراسری (global scope)؛ در سطح shared\-network،
subnet، pool، client\-class، option\-data یا definition؛ و از طریق رزرو میزبان (host reservation)
مشخص کرد. یکی دیگر از ویژگی‌های کاربردی، امکان ذخیره یادداشت‌ها یا توضیحات است.
.sp
بیایید استقرار نمونه‌ای از lightweight 4over6 را در نظر بگیریم؛ فناوری گذار به IPv6 که
امکان نگاشت پیشوندهای IPv6 به آدرس‌های IPv4 کامل یا جزئی را فراهم می‌کند. در زمینه DHCP،
این‌ها پارامترهای خاصی هستند که قرار است در قالب گزینه‌های اضافی به کلاینت‌ها تحویل
داده شوند. مقادیر این گزینه‌ها با پیشوندهای تفویض‌شده (delegated prefixes) همبستگی دارند،
بنابراین منطقی است که این پارامترها به همراه استخر تفویض پیشوند (PD pool) نگهداری شوند.
از سوی دیگر، lightweight 4over6 قابلیتی نیست که به طور متداول استفاده شود، بنابراین بخشی از کد پایه
Kea محسوب نمی‌شود. راه‌حل این مسئله، تعیین یک زمینه کاربر است. برای هر استخر PD که انتظار می‌رود
برای lightweight 4over6 استفاده شود، یک زمینه کاربر با پارامترهای اضافی تعریف می‌شود.
آن پارامترهای اضافی توسط یک کتابخانه قلاب استفاده شده و تنها در صورتی بارگذاری می‌شوند که محاسبه
پویای گزینه lightweight 4over6 واقعاً مورد نیاز باشد. نمونه‌ای از این پیکربندی به صورت زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqsubnet6\(dq: [ {
        \(dqpd\-pools\(dq: [
        {
            \(dqprefix\(dq: \(dq2001:db8::\(dq,
            \(dqprefix\-len\(dq: 56,
            \(dqdelegated\-len\(dq: 64,

            # This is a pool\-specific context.
            \(dquser\-context\(dq: {
                \(dqthreshold\-percent\(dq: 85,
                \(dqv4\-network\(dq: \(dq192.168.0.0/16\(dq,
                \(dqv4\-overflow\(dq: \(dq10.0.0.0/16\(dq,
                \(dqlw4over6\-sharing\-ratio\(dq: 64,
                \(dqlw4over6\-v4\-pool\(dq: \(dq192.0.2.0/24\(dq,
                \(dqlw4over6\-sysports\-exclude\(dq: true,
                \(dqlw4over6\-bind\-prefix\-len\(dq: 56
            }
        } ],
        \(dqid\(dq: 1,
        \(dqsubnet\(dq: \(dq2001:db8::/32\(dq,

        # This is a subnet\-specific context. Any type of
        # information can be entered here as long as it is valid JSON.
        \(dquser\-context\(dq: {
            \(dqcomment\(dq: \(dqThose v4\-v6 migration technologies are tricky.\(dq,
            \(dqexperimental\(dq: true,
            \(dqbilling\-department\(dq: 42,
            \(dqcontacts\(dq: [ \(dqAlice\(dq, \(dqBob\(dq ]
        }
    } ]
}
.EE
.UNINDENT
.UNINDENT
.sp
برنامه Kea اطلاعات user\-context را تفسیر یا استفاده نمی‌کند؛ این برنامه صرفاً
آن را ذخیره کرده و در دسترس کتابخانه‌های قلاب قرار می‌دهد. استخراج و استفاده
از این اطلاعات به عهده هر کتابخانه قلاب است. تجزیه‌کننده (parser)، ورودی
\fBcomment\fP را به یک زمینه کاربر به همراه آن ورودی تبدیل می‌کند، که این امر
امکان پیوست کردن یادداشت درون خود پیکربندی را فراهم می‌سازد..SS "استانداردهای پشتیبانی‌شده DHCPv6"
.sp
استانداردهای زیر در حال حاضر در Kea پشتیبانی می‌شوند:
.INDENT 0.0
.IP \(bu 2
\fIDynamic Host Configuration Protocol for IPv6\fP, RFC
3315 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc3315>: پیام‌های پشتیبانی‌شده عبارتند از
SOLICIT، ADVERTISE، REQUEST، RELEASE، RENEW، REBIND،
INFORMATION\-REQUEST، CONFIRM، DECLINE و REPLY. تنها
پیام پشتیبانی‌نشده RECONFIGURE است. تقریباً تمامی گزینه‌ها پشتیبانی می‌شوند،
به جز AUTHENTICATION و RECONFIGURE\-ACCEPT.
.IP \(bu 2
\fIDynamic Host Configuration Protocol (DHCPv6) Options for
Session Initiation Protocol (SIP) Servers\fP, RFC 3319 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc3319>: تمامی گزینه‌های تعریف‌شده پشتیبانی می‌شوند.
.IP \(bu 2
\fIIPv6 Prefix Options for Dynamic Host Configuration Protocol (DHCP)
version 6\fP, RFC 3633 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc3633>:
گزینه‌های پشتیبانی‌شده IA_PD و IA_PREFIX هستند. همچنین
کد وضعیت NoPrefixAvail نیز پشتیبانی می‌شود.
.IP \(bu 2
\fIDNS Configuration options for Dynamic Host Configuration Protocol for IPv6
(DHCPv6)\fP, RFC 3646 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc3646>: تمامی گزینه‌های
تعریف‌شده پشتیبانی می‌شوند.
.IP \(bu 2
\fIStateless Dynamic Host Configuration Protocol (DHCP) Service for IPv6\fP, RFC
3736 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc3736>: عملکرد سرور در
حالت بدون حالت (stateless) پشتیبانی می‌شود. Kea در حال حاضر تنها در سمت سرور (server\-only) است،
بنابراین سمت کلاینت پیاده‌سازی نشده است.
.IP \(bu 2
\fISimple Network Time Protocol (SNTP) Configuration Option for DHCPv6\fP, RFC
4075 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc4075>: گزینه SNTP پشتیبانی می‌شود.
.IP \(bu 2
\fIRenumbering Requirements for Stateless Dynamic Host Configuration Protocol for
IPv6 (DHCPv6)\fP, RFC 4076 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc4076>: سرور
از تمامی نیازمندی‌های شماره‌گذاری مجدد در حالت بدون حالت پشتیبانی می‌کند.
.IP \(bu 2
\fIInformation Refresh Time Option for Dynamic Host Configuration Protocol for
IPv6 (DHCPv6)\fP, RFC 4242 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc4242>: تنها
گزینه تعریف‌شده (\fBinformation\-refresh\-time\fP) پشتیبانی می‌شود.
.IP \(bu 2
\fIDynamic Host Configuration Protocol (DHCP) Options for Broadcast and Multicast
Control Servers\fP, RFC 4280 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc4280>:
گزینه‌های DHCPv6 پشتیبانی می‌شوند.
.IP \(bu 2
\fIDynamic Host Configuration Protocol for IPv6 (DHCPv6) Relay Agent Subscriber\-ID
Option\fP, RFC 4580 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc4580>: گزینه
subscribed\-id پشتیبانی می‌شود و می‌تواند در هر عبارتی استفاده شود.
.IP \(bu 2
\fIThe Dynamic Host Configuration Protocol for IPv6 (DHCPv6) Relay
Agent Remote\-ID Option\fP, RFC
4649 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc4649>: گزینه Remote\-ID پشتیبانی
می‌شود.
.IP \(bu 2
\fIA DNS Resource Record (RR) for Encoding Dynamic Host Configuration Protocol
(DHCP) Information (DHCID RR)\fP, RFC 4701 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc4701>:
سرور DHCPv6 از رکوردهای DHCID پشتیبانی می‌کند. سرور DHCP\-DDNS برای
افزودن، به‌روزرسانی و/یا حذف رکوردهای DHCID باید در حال اجرا باشد.
.IP \(bu 2
\fIResolution of Fully Qualified Domain Name (FQDN) Conflicts among Dynamic Host
Configuration Protocol (DHCP) Clients\fP, RFC 4703 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc4703>: سرور
DHCPv6 برای حل تداخل‌ها از سرور DHCP\-DDNS استفاده می‌کند.
.IP \(bu 2
\fIThe Dynamic Host Configuration Protocol for IPv6 (DHCPv6) Client
Fully Qualified Domain Name (FQDN) Option\fP, RFC
4704 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc4704>: گزینه پشتیبانی‌شده
CLIENT_FQDN است.
.IP \(bu 2
\fITimezone Options for DHCP\fP: RFC 4833 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc4833>:
هر دو گزینه DHCPv6 پشتیبانی می‌شوند.
.IP \(bu 2
\fIDHCPv6 Leasequery\fP: RFC 5007 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc5007>: قابلیت‌های
سرور (انواع پیام‌ها، گزینه‌ها) پشتیبانی می‌شود. این ویژگی نیازمند
قلاب leasequery است. برای جزئیات به libdhcp_lease_query.so: Leasequery Support \%<#\:hooks-lease-query> مراجعه کنید.
.IP \(bu 2
\fIDHCP Options for Protocol for Carrying Authentication for Network Access
(PANA) Authentication Agents\fP: RFC 5192 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc5192>:
گزینه PANA پشتیبانی می‌شود.
.IP \(bu 2
\fIDiscovering Location\-to\-Service Translation (LoST) Servers Using the
Dynamic Host Configuration Protocol (DHCP)\fP: RFC 5223 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc5223>: گزینه LOST پشتیبانی می‌شود.
.IP \(bu 2
\fIControl And Provisioning of Wireless Access Points (CAPWAP) Access Controller
DHCP Option\fP: RFC 5417 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc5417>: گزینه CAPWAP for IPv6
پشتیبانی می‌شود.
.IP \(bu 2
\fIDHCPv6 Bulk Leasequery\fP: RFC 5460 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc5460>:
قابلیت‌های سرور (اتصال TCP، انواع پیام‌ها و گزینه‌های جدید،
انواع پرس‌وجوهای جدید) پشتیبانی می‌شود. این ویژگی نیازمند قلاب leasequery است. برای جزئیات به
libdhcp_lease_query.so: Leasequery Support \%<#\:hooks-lease-query> مراجعه کنید.
.IP \(bu 2
\fINetwork Time Protocol (NTP) Server Option for DHCPv6\fP:
RFC 5908 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc5908>: گزینه سرور NTP و
زیرگزینه‌های آن پشتیبانی می‌شوند. برای جزئیات به NTP Server Suboptions مراجعه کنید.
.IP \(bu 2
\fIDHCPv6 Options for Network Boot\fP: RFC 5970 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc5970>:
گزینه‌های بوت شبکه پشتیبانی می‌شوند.
.IP \(bu 2
\fILightweight DHCPv6 Relay Agent\fP, RFC 6221 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc6221>: برنامه Kea می‌تواند پیام‌های
رله سبک‌وزن را مدیریت کند و از روش‌هایی به غیر از آدرس پیوند برای انتخاب زیرشبکه استفاده نماید.
.IP \(bu 2
\fIDynamic Host Configuration Protocol for IPv6 (DHCPv6) Option for
Dual\-Stack Lite\fP, RFC 6334 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc6334>:
گزینه DHCPv6 با عنوان AFTR\-Name پشتیبانی می‌شود.
.IP \(bu 2
\fIRelay\-Supplied DHCP Options\fP, RFC
6422 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc6422>: قابلیت کامل
پشتیبانی می‌شود، از جمله OPTION_RSOO؛ توانایی سرور برای بازتاب دادن
گزینه‌ها؛ بررسی فعال بودن RSOO برای یک گزینه؛ و امکان علامت‌گذاری
گزینه‌های اضافی به عنوان فعال‌شده با RSOO.
.IP \(bu 2
\fIThe EAP Re\-authentication Protocol (ERP) Local Domain Name DHCPv6 Option\fP,
RFC 6440 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc6440>: این گزینه پشتیبانی می‌شود.
.IP \(bu 2
\fIPrefix Exclude Option for DHCPv6\-based Prefix Delegation\fP, RFC
6603 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc6603>: گزینه Prefix Exclude
پشتیبانی می‌شود.
.IP \(bu 2
\fIClient Link\-Layer Address Option in DHCPv6\fP, RFC
6939 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc6939>: گزینه پشتیبانی‌شده
گزینه client link\-layer address است.
.IP \(bu 2
\fIModification to Default values of SOL_MAX_RT and INF_MAX_RT\fP, RFC 7083 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc7083>: گزینه‌های جدید
پشتیبانی می‌شوند.
.IP \(bu 2
\fIIssues and Recommendations with Multiple Stateful DHCPv6 Options\fP,
RFC 7550 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc7550>: تمامی
توصیه‌های مربوط به عملکرد سرور DHCPv6 پشتیبانی می‌شوند.
.IP \(bu 2
\fIDHCPv6 Options for Configuration of Softwire Address and Port\-Mapped
Clients\fP, RFC 7598 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc7598>: تمامی
گزینه‌های مشخص‌شده در این سند، توسط سرور DHCPv6
پشتیبانی می‌شوند.
.IP \(bu 2
\fIGeneralized UDP Source Port for DHCP Relay\fP, RFC 8357 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc8357>: سرور Kea قادر است
گزینه Relay Source Port را در پیام دریافتی Relay\-forward مدیریت کند،
درگاه UDP را به خاطر بسپارد، و پاسخ Relay\-reply را همراه با رونوشتی از این
گزینه و با استفاده از همین درگاه UDP به عامل رله بازپس بفرستد.
.IP \(bu 2
\fIDynamic Host Configuration Protocol for IPv6 (DHCPv6)\fP, RFC 9915 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc9915>: این مشخصه جدید پروتکل DHCPv6،
استانداردهای RFC 3315، RFC 3633، RFC 3736، RFC 4242، RFC 7083، RFC 7283، RFC 7550
و RFC 8415 را منسوخ می‌کند. تمامی ویژگی‌ها، به استثنای سازوکار RECONFIGURE و
سازوکار اکنون منسوخ‌شده آدرس‌های موقت (IA_TA)، پشتیبانی می‌شوند.
.IP \(bu 2
\fICaptive\-Portal Identification in DHCP and Router Advertisements (RAs)\fP, RFC 8910 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc8910>: سرور Kea می‌تواند هر دو نگارش
v4 و v6 گزینه‌های captive portal را پیکربندی کند.
.IP \(bu 2
\fIDHCP and Router Advertisement Options for the Discovery of Network\-designated
Resolvers (DNR)\fP, RFC 9463 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc9463>\&. سرور Kea
از گزینه DNR پشتیبانی می‌کند.
.IP \(bu 2
\fIRegistering Self\-Generated IPv6 Addresses Using DHCPv6\fP, RFC 9686 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc9686>\&. سرور Kea از ثبت آدرس‌های خودساخته پشتیبانی می‌کند. برای جزئیات به Address Registration (RFC 9686 Support) مراجعه کنید.
.UNINDENT.SS محدودیت‌های سرور DHCPv6
.sp
این موارد محدودیت‌های شناخته‌شدهٔ کنونی نرم‌افزار سرور Kea DHCPv6 هستند. بیشتر آن‌ها
بازتابی از مرحلهٔ کنونی توسعه هستند و به جای محدودیت‌های واقعی،
باید به عنوان «هنوز پیاده‌سازی‌نشده» در نظر گرفته شوند.
.INDENT 0.0
.IP \(bu 2
سرور برای هر گزینهٔ IA خاص (IA_NA یا IA_PD) ارسال‌شده توسط کلاینت، حداکثر یک
اجاره (lease) را تخصیص داده، تمدید کرده یا بازنشانی (rebind) می‌کند. سند RFC
9915 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc9915> اجازه می‌دهد چندین
نشانی یا پیشوند برای یک IA واحد تخصیص یابد.
.IP \(bu 2
نشانی‌های موقت پشتیبانی نمی‌شوند. هیچ برنامه‌ای برای پیاده‌سازی این
ویژگی وجود ندارد، زیرا در RFC 9915 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc9915>\& منسوخ شده است.
.IP \(bu 2
پیکربندی مجدد کلاینت (RECONFIGURE) هنوز پشتیبانی نمی‌شود.
.UNINDENT
.SS مثال‌های سرور Kea DHCPv6
.sp
مجموعه‌ای از مثال‌های ساده و کاربردی برای مؤلفهٔ DHCPv6 از Kea
به همراه فایل‌های منبع، در دایرکتوری \fBdoc/examples/kea6\fP
در دسترس است.
.SS بک‌اند پیکربندی در DHCPv6
.sp
در بخش Kea Configuration Backend \%<#\:config-backend> ویژگی بک‌اند
پیکربندی (CB)، کاربرد آن و محدودیت‌هایش را توضیح داده‌ایم. این بخش بر
استفاده از CB با سرور DHCPv6 تمرکز دارد. این قسمت پارامترهای پشتیبانی‌شده
را فهرست می‌کند، محدودیت‌ها را توضیح می‌دهد و برای بهره‌گیری از CB،
مثال‌هایی از پیکربندی سرور DHCPv6 ارائه می‌دهد. لطفاً برای استفادهٔ مخصوص
DHCPv4 از CB، به بخش متناظر Configuration Backend in DHCPv4 \%<#\:dhcp4-cb> نیز
مراجعه کنید.
.SS پارامترهای پشتیبانی‌شده
.sp
هدف نهایی CB این است که به عنوان یک مخزن مرکزی پیکربندی
برای یک یا چند سرور Kea متصل به یک پایگاه‌داده عمل کند.
در نسخه‌های کنونی پشتیبانی‌شدهٔ Kea، تنها زیرمجموعه‌ای از
پارامترهای سرور DHCPv6 را می‌توان در پایگاه‌داده پیکربندی کرد. سایر
پارامترها در صورت نیاز باید در فایل پیکربندی JSON مشخص
شوند.
.sp
تمام پارامترهای پشتیبانی‌شده را می‌توان از طریق \fBlibdhcp_cb_cmds.so\fP \%<#\:std-ischooklib-libdhcp_cb_cmds\:.so>\& پیکربندی کرد.
قاعدهٔ کلی این است که
پارامترهای سراسری اسکالر با استفاده از
\fBremote\-global\-parameter6\-set\fP \%<#\:std-isccmd-remote-global-parameter6-set> تنظیم می‌شوند؛ پارامترهای ویژهٔ شبکهٔ مشترک
با استفاده از \fBremote\-network6\-set\fP \%<#\:std-isccmd-remote-network6-set> تنظیم می‌شوند؛ و پارامترهای سطح زیرشبکه و استخر
با استفاده از \fBremote\-subnet6\-set\fP \%<#\:std-isccmd-remote-subnet6-set>\& تنظیم می‌گردند. هرگاه
استثنایی برای این قاعدهٔ کلی وجود داشته باشد، در جدول
مشخص شده است. پارامترهای سراسری غیراسکالر دستورهای اختصاصی خود را دارند؛ برای مثال،
گزینه‌های سراسری DHCPv6 (\fBoption\-data\fP) با استفاده از
\fBremote\-option6\-global\-set\fP \%<#\:std-isccmd-remote-option6-global-set>\& تغییر داده می‌شوند. کلاس‌های کلاینت به همراه تعاریف
گزینه‌ها و گزینه‌های DHCPv6 ویژهٔ کلاس، با استفاده از
دستور \fBremote\-class6\-set\fP \%<#\:std-isccmd-remote-class6-set> پیکربندی می‌شوند.
.sp
بخش Configuration Sharing and Server Tags \%<#\:cb-sharing> مفهوم عناصر پیکربندی
اشتراک‌پذیر و غیراشتراک‌پذیر و محدودیت‌های به‌اشتراک‌گذاری آن‌ها میان چندین
سرور را توضیح می‌دهد. در پیکربندی DHCP (هم DHCPv4 و هم DHCPv6)، عناصر
پیکربندی اشتراک‌پذیر زیرشبکه‌ها و شبکه‌های مشترک هستند. بنابراین، می‌توان آن‌ها را به‌طور صریح با چندین برچسب سرور مرتبط ساخت.
پارامترهای سراسری، تعاریف گزینه‌ها و گزینه‌های سراسری غیراشتراک‌پذیر
هستند و تنها می‌توانند با یک برچسب سرور مرتبط شوند. این قاعده برای
عناصر پیکربندی مرتبط با سرورهای \fBall\fP صدق نمی‌کند. هر عنصر
پیکربندی مرتبط با سرورهای \fBall\fP (با استفاده از کلمهٔ کلیدی \fBall\fP به عنوان برچسب سرور)
توسط تمام سرورهای متصل به پایگاه‌دادهٔ پیکربندی مورد استفاده قرار می‌گیرد.
.sp
جدول زیر پارامترهای ویژهٔ DHCPv6 پشتیبانی‌شده توسط بک‌اند
پیکربندی را به همراه سطحی از سلسله‌مراتب که در آن پشتیبانی
می‌شود، فهرست می‌کند.
.SS فهرست پارامترهای DHCPv6 پشتیبانی‌شده توسط بک‌اند پیکربندی
.TS
box center;
l|l|l|l|l|l|l.
T{
پارامتر
T}	T{
سراسری
T}	T{
کلاس
کلاینت
T}	T{
شبکهٔ
مشترک
T}	T{
زیرشبکه
T}	T{
استخر
T}	T{
استخر
واگذاری
پیشوند
T}
_
T{
allocator
T}	T{
بله
T}	T{
نامربوط
T}	T{
بله
T}	T{
بله
T}	T{
نامربوط
T}	T{
نامربوط
T}
_
T{
cache\-max\-age
T}	T{
بله
T}	T{
نامربوط
T}	T{
خیر
T}	T{
خیر
T}	T{
نامربوط
T}	T{
نامربوط
T}
_
T{
cache\-threshold
T}	T{
بله
T}	T{
نامربوط
T}	T{
خیر
T}	T{
خیر
T}	T{
نامربوط
T}	T{
نامربوط
T}
_
T{
calculate\-tee\-times
T}	T{
بله
T}	T{
نامربوط
T}	T{
بله
T}	T{
بله
T}	T{
نامربوط
T}	T{
نامربوط
T}
_
T{
client\-class
T}	T{
نامربوط
T}	T{
نامربوط
T}	T{
بله
T}	T{
بله
T}	T{
بله
T}	T{
بله
T}
_
T{
ddns\-send\-update
T}	T{
بله
T}	T{
نامربوط
T}	T{
بله
T}	T{
بله
T}	T{
نامربوط
T}	T{
نامربوط
T}
_
T{
ddns\-override\-no\-update
T}	T{
بله
T}	T{
نامربوط
T}	T{
بله
T}	T{
بله
T}	T{
نامربوط
T}	T{
نامربوط
T}
_
T{
ddns\-override\-client\-update
T}	T{
بله
T}	T{
نامربوط
T}	T{
بله
T}	T{
بله
T}	T{
نامربوط
T}	T{
نامربوط
T}
_
T{
ddns\-replace\-client\-name
T}	T{
بله
T}	T{
نامربوط
T}	T{
بله
T}	T{
بله
T}	T{
نامربوط
T}	T{
نامربوط
T}
_
T{
ddns\-generated\-prefix
T}	T{
بله
T}	T{
نامربوط
T}	T{
بله
T}	T{
بله
T}	T{
نامربوط
T}	T{
نامربوط
T}
_
T{
ddns\-qualifying\-suffix
T}	T{
بله
T}	T{
نامربوط
T}	T{
بله
T}	T{
بله
T}	T{
نامربوط
T}	T{
نامربوط
T}
_
T{
decline\-probation\-period
T}	T{
بله
T}	T{
نامربوط
T}	T{
نامربوط
T}	T{
نامربوط
T}	T{
نامربوط
T}	T{
نامربوط
T}
_
T{
delegated\-len
T}	T{
نامربوط
T}	T{
نامربوط
T}	T{
نامربوط
T}	T{
نامربوط
T}	T{
نامربوط
T}	T{
بله
T}
_
T{
dhcp4o6\-port
T}	T{
بله
T}	T{
نامربوط
T}	T{
نامربوط
T}	T{
نامربوط
T}	T{
نامربوط
T}	T{
نامربوط
T}
_
T{
excluded\-prefix
T}	T{
نامربوط
T}	T{
نامربوط
T}	T{
نامربوط
T}	T{
نامربوط
T}	T{
نامربوط
T}	T{
بله
T}
_
T{
excluded\-prefix\-len
T}	T{
نامربوط
T}	T{
نامربوط
T}	T{
نامربوط
T}	T{
نامربوط
T}	T{
نامربوط
T}	T{
بله
T}
_
T{
hostname\-char\-set
T}	T{
بله
T}	T{
نامربوط
T}	T{
بله
T}	T{
بله
T}	T{
نامربوط
T}	T{
نامربوط
T}
_
T{
hostname\-char\-replacement
T}	T{
بله
T}	T{
نامربوط
T}	T{
بله
T}	T{
بله
T}	T{
نامربوط
T}	T{
نامربوط
T}
_
T{
interface
T}	T{
نامربوط
T}	T{
نامربوط
T}	T{
بله
T}	T{
بله
T}	T{
نامربوط
T}	T{
نامربوط
T}
_
T{
interface\-id
T}	T{
نامربوط
T}	T{
نامربوط
T}	T{
بله
T}	T{
بله
T}	T{
نامربوط
T}	T{
نامربوط
T}
_
T{
max\-preferred\-lifetime
T}	T{
بله
T}	T{
بله
T}	T{
بله
T}	T{
بله
T}	T{
نامربوط
T}	T{
نامربوط
T}
_
T{
max\-valid\-lifetime
T}	T{
بله
T}	T{
بله
T}	T{
بله
T}	T{
بله
T}	T{
نامربوط
T}	T{
نامربوط
T}
_
T{
min\-preferred\-lifetime
T}	T{
بله
T}	T{
بله
T}	T{
بله
T}	T{
بله
T}	T{
نامربوط
T}	T{
نامربوط
T}
_
T{
min\-valid\-lifetime
T}	T{
بله
T}	T{
بله
T}	T{
بله
T}	T{
بله
T}	T{
نامربوط
T}	T{
نامربوط
T}
_
T{
option\-data
T}	T{
بله (از طریق
remote\-option6\-global\-set)
T}	T{
بله
T}	T{
بله
T}	T{
بله
T}	T{
بله
T}	T{
بله
T}
_
T{
option\-def
T}	T{
بله (از طریق
remote\-option\-def6\-set)
T}	T{
بله
T}	T{
نامربوط
T}	T{
نامربوط
T}	T{
نامربوط
T}	T{
نامربوط
T}
_
T{
pd\-allocator
T}	T{
بله
T}	T{
نامربوط
T}	T{
بله
T}	T{
بله
T}	T{
نامربوط
T}	T{
نامربوط
T}
_
T{
preferred\-lifetime
T}	T{
بله
T}	T{
بله
T}	T{
بله
T}	T{
بله
T}	T{
نامربوط
T}	T{
نامربوط
T}
_
T{
prefix
T}	T{
نامربوط
T}	T{
نامربوط
T}	T{
نامربوط
T}	T{
نامربوط
T}	T{
نامربوط
T}	T{
بله
T}
_
T{
prefix\-len
T}	T{
نامربوط
T}	T{
نامربوط
T}	T{
نامربوط
T}	T{
نامربوط
T}	T{
نامربوط
T}	T{
بله
T}
_
T{
rapid\-commit
T}	T{
بله
T}	T{
نامربوط
T}	T{
بله
T}	T{
بله
T}	T{
نامربوط
T}	T{
نامربوط
T}
_
T{
rebind\-timer
T}	T{
بله
T}	T{
نامربوط
T}	T{
بله
T}	T{
بله
T}	T{
نامربوط
T}	T{
نامربوط
T}
_
T{
relay
T}	T{
نامربوط
T}	T{
نامربوط
T}	T{
بله
T}	T{
بله
T}	T{
نامربوط
T}	T{
نامربوط
T}
_
T{
renew\-timer
T}	T{
بله
T}	T{
نامربوط
T}	T{
بله
T}	T{
بله
T}	T{
نامربوط
T}	T{
نامربوط
T}
_
T{
require\-client\-classes
T}	T{
خیر
T}	T{
نامربوط
T}	T{
بله
T}	T{
بله
T}	T{
بله
T}	T{
بله
T}
_
T{
evaluate\-additional\-classes
T}	T{
خیر
T}	T{
نامربوط
T}	T{
بله
T}	T{
بله
T}	T{
بله
T}	T{
بله
T}
_
T{
reservations\-global
T}	T{
بله
T}	T{
نامربوط
T}	T{
بله
T}	T{
بله
T}	T{
نامربوط
T}	T{
نامربوط
T}
_
T{
reservations\-in\-subnet
T}	T{
بله
T}	T{
نامربوط
T}	T{
بله
T}	T{
بله
T}	T{
نامربوط
T}	T{
نامربوط
T}
_
T{
reservations\-out\-of\-pool
T}	T{
بله
T}	T{
نامربوط
T}	T{
بله
T}	T{
بله
T}	T{
نامربوط
T}	T{
نامربوط
T}
_
T{
t1\-percent
T}	T{
بله
T}	T{
نامربوط
T}	T{
بله
T}	T{
بله
T}	T{
نامربوط
T}	T{
نامربوط
T}
_
T{
t2\-percent
T}	T{
بله
T}	T{
نامربوط
T}	T{
بله
T}	T{
بله
T}	T{
نامربوط
T}	T{
نامربوط
T}
_
T{
valid\-lifetime
T}	T{
بله
T}	T{
بله
T}	T{
بله
T}	T{
بله
T}	T{
نامربوط
T}	T{
نامربوط
T}
.TE
.INDENT 0.0.IP \(bu 2
\fByes\fP \- نشان می‌دهد که پارامتر در سطح مشخص‌شده از سلسله‌مراتب پشتیبانی می‌شود و از طریق backend پیکربندی قابل تنظیم است.
.IP \(bu 2
\fBno\fP \- نشان می‌دهد که پارامتر در سطح مشخص‌شده از سلسله‌مراتب پشتیبانی می‌شود اما از طریق backend پیکربندی قابل تنظیم نیست.
.IP \(bu 2
\fBn/a\fP \- نشان می‌دهد که پارامتر داده‌شده در سطح خاصی از سلسله‌مراتب کاربرد ندارد یا سرور از پارامتر در آن سطح پشتیبانی نمی‌کند.
.UNINDENT
.sp
برخی از پارامترهای اسکالر موجود در نگاشت‌های سراسری سطح بالا توسط backend پیکربندی پشتیبانی می‌شوند.
.SS فهرست پارامترهای نگاشت DHCPv6 پشتیبانی‌شده توسط backend پیکربندی (List of DHCPv6 map parameters supported by the configuration backend)
.TS
box center;
l|l|l.
T{
نام پارامتر (قالب نام‌گذاری مسطح)
T}	T{
نگاشت سراسری
T}	T{
نام پارامتر
T}
_
T{
compatibility.lenient\-option\-parsing
T}	T{
compatibility
T}	T{
lenient\-option\-parsing
T}
_
T{
dhcp\-ddns.enable\-updates
T}	T{
dhcp\-ddns
T}	T{
enable\-updates
T}
_
T{
dhcp\-ddns.max\-queue\-size
T}	T{
dhcp\-ddns
T}	T{
max\-queue\-size
T}
_
T{
dhcp\-ddns.ncr\-format
T}	T{
dhcp\-ddns
T}	T{
ncr\-format
T}
_
T{
dhcp\-ddns.ncr\-protocol
T}	T{
dhcp\-ddns
T}	T{
ncr\-protocol
T}
_
T{
dhcp\-ddns.sender\-ip
T}	T{
dhcp\-ddns
T}	T{
sender\-ip
T}
_
T{
dhcp\-ddns.sender\-port
T}	T{
dhcp\-ddns
T}	T{
sender\-port
T}
_
T{
dhcp\-ddns.server\-ip
T}	T{
dhcp\-ddns
T}	T{
server\-ip
T}
_
T{
dhcp\-ddns.server\-port
T}	T{
dhcp\-ddns
T}	T{
server\-port
T}
_
T{
expired\-leases\-processing.flush\-reclaimed\-timer\-wait\-time
T}	T{
expired\-leases\-processing
T}	T{
flush\-reclaimed\-timer\-wait\-time
T}
_
T{
expired\-leases\-processing.hold\-reclaimed\-time
T}	T{
expired\-leases\-processing
T}	T{
hold\-reclaimed\-time
T}
_
T{
expired\-leases\-processing.max\-reclaim\-leases
T}	T{
expired\-leases\-processing
T}	T{
max\-reclaim\-leases
T}
_
T{
expired\-leases\-processing.max\-reclaim\-time
T}	T{
expired\-leases\-processing
T}	T{
max\-reclaim\-time
T}
_
T{
expired\-leases\-processing.reclaim\-timer\-wait\-time
T}	T{
expired\-leases\-processing
T}	T{
reclaim\-timer\-wait\-time
T}
_
T{
expired\-leases\-processing.unwarned\-reclaim\-cycles
T}	T{
expired\-leases\-processing
T}	T{
unwarned\-reclaim\-cycles
T}
_
T{
multi\-threading.enable\-multi\-threading
T}	T{
multi\-threading
T}	T{
enable\-multi\-threading
T}
_
T{
multi\-threading.thread\-pool\-size
T}	T{
multi\-threading
T}	T{
thread\-pool\-size
T}
_
T{
multi\-threading.packet\-queue\-size
T}	T{
multi\-threading
T}	T{
packet\-queue\-size
T}
_
T{
sanity\-checks.lease\-checks
T}	T{
sanity\-checks
T}	T{
lease\-checks
T}
_
T{
sanity\-checks.extended\-info\-checks
T}	T{
sanity\-checks
T}	T{
extended\-info\-checks
T}
_
T{
server\-id.type
T}	T{
server\-id
T}	T{
type
T}
_
T{
server\-id.enterprise\-id
T}	T{
server\-id
T}	T{
enterprise\-id
T}
_
T{
server\-id.identifier
T}	T{
server\-id
T}	T{
identifier
T}
_
T{
server\-id.persist
T}	T{
server\-id
T}	T{
persist
T}
_
T{
dhcp\-queue\-control.enable\-queue
T}	T{
dhcp\-queue\-control
T}	T{
enable\-queue
T}
_
T{
dhcp\-queue\-control.queue\-type
T}	T{
dhcp\-queue\-control
T}	T{
queue\-type
T}
_
T{
dhcp\-queue\-control.capacity
T}	T{
dhcp\-queue\-control
T}	T{
capacity
T}
.TE
.sp
برخی از پارامترهای فهرست سراسری که تنها حاوی انواع اسکالر هستند، توسط backend پیکربندی پشتیبانی می‌شوند..SS فهرست پارامترهای فهرستی DHCPv6 پشتیبانی‌شده توسط پس‌بند پیکربندی
.TS
box center;
l.
T{
نام پارامتر                    | نوع پارامتر نگه‌دارنده فهرست
T}
_
T{
host\-reservation\-identifiers  | string
T}
.TE
.SS فعال‌سازی پس‌بند پیکربندی
.sp
قطعه‌پیکربندی زیر را در نظر بگیرید که از یک پایگاه‌داده پیکربندی MySQL استفاده می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqDhcp6\(dq: {
        \(dqserver\-tag\(dq: \(dqmy DHCPv6 server\(dq,
        \(dqconfig\-control\(dq: {
            \(dqconfig\-databases\(dq: [
                {
                    \(dqtype\(dq: \(dqmysql\(dq,
                    \(dqname\(dq: \(dqkea\(dq,
                    \(dquser\(dq: \(dqkea\(dq,
                    \(dqpassword\(dq: \(dq1234\(dq,
                    \(dqhost\(dq: \(dq2001:db8:1::1\(dq,
                    \(dqport\(dq: 3302
                }
            ],
            \(dqconfig\-fetch\-wait\-time\(dq: 20
        },
        \(dqhooks\-libraries\(dq: [
            {
                \(dqlibrary\(dq: \(dqlibdhcp_mysql.so\(dq
            },
            {
                \(dqlibrary\(dq: \(dqlibdhcp_cb_cmds.so\(dq
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
قطعه‌کد زیر استفاده از یک پایگاه‌داده PostgreSQL را نشان می‌دهد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqDhcp6\(dq: {
        \(dqserver\-tag\(dq: \(dqmy DHCPv6 server\(dq,
        \(dqconfig\-control\(dq: {
            \(dqconfig\-databases\(dq: [
                {
                    \(dqtype\(dq: \(dqpostgresql\(dq,
                    \(dqname\(dq: \(dqkea\(dq,
                    \(dquser\(dq: \(dqkea\(dq,
                    \(dqpassword\(dq: \(dq1234\(dq,
                    \(dqhost\(dq: \(dq2001:db8:1::1\(dq,
                    \(dqport\(dq: 3302
                }
            ],
            \(dqconfig\-fetch\-wait\-time\(dq: 20
        },
        \(dqhooks\-libraries\(dq: [
            {
                \(dqlibrary\(dq: \(dqlibdhcp_pgsql.so\(dq
            },
            {
                \(dqlibrary\(dq: \(dqlibdhcp_cb_cmds.so\(dq
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
ساختار پیکربندی تقریباً مشابه با کارساز DHCPv4 است
(برای توضیحات دقیق، فعال‌سازی پس‌بند پیکربندی \%<#\:dhcp4-cb-json> را ببینید).
.SS پارامترهای پیکربندی سازگاری Kea DHCPv6
.sp
هدف ISC این است که Kea از اسناد RFC پیروی کند تا سازگاری بهتری با استانداردها ارتقا یابد. با این حال، پیاده‌سازی‌های معیوب بسیاری از DHCP وجود دارند که نمی‌توان به آسانی آن‌ها را اصلاح یا ارتقا داد. بنابراین، Kea یک حالت سازگاری با استفاده آسان برای کلاینت‌های معیوب یا ناسازگار فراهم می‌کند. به همین منظور، باید گزینه سازگاری فعال شود تا رفتارهای نامتعارف مجاز گردند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp6\(dq: {
    \(dqcompatibility\(dq: {
    }
  }
}
.EE
.UNINDENT
.UNINDENT
.SS تجزیه آسان‌گیرانه گزینه‌ها
.sp
به‌طور پیش‌فرض، فیلد \fBvendor\-class\-data\fP در گزینه ۱۶ DHCPv6 به‌صورت مجموعه‌ای از جفت‌های طول\-مقدار تجزیه می‌شود؛ همین امر برای فیلدهای چندتایی (tuple) تعریف‌شده در گزینه‌های سفارشی نیز صادق است.
.sp
با \fB\(dqlenient\-option\-parsing\(dq: true\fP، اگر یک طول از باقی‌مانده بافر گزینه فراتر رود، نسخه‌های پیشین Kea پیام گزارشی با مضمون \fBunable to parse the opaque data tuple, the buffer length is x, but the tuple length is y\fP با \fBx < y\fP بازمی‌گرداندند؛ این وضعیت دیگر رخ نمی‌دهد. در عوض، مقدار برابر با باقی‌مانده بافر در نظر گرفته می‌شود، یا به بیان پیام گزارش بالا، طول تاپل \fBy\fP به \fBx\fP تبدیل می‌شود\&.
.sp
انتظار می‌رود فعال کردن این پرچم، سازگاری با دستگاه‌هایی مانند RAD MiNID را بهبود بخشد.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp6\(dq: {
    \(dqcompatibility\(dq: {
      \(dqlenient\-option\-parsing\(dq: true
    }
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
از نسخه 2.5.8 به بعد Kea، این شیوه تجزیه گسترش یافته است تا گزینه‌های client\-fqdn (39) با برخی نام‌های دامنه نامعتبر را بدون هشدار نادیده بگیرد؛ همچنین از نسخه 3.1.9 به بعد Kea، پرچم‌های نامعتبر را اصلاح می‌کند، بدین معنا که وقتی پرچم‌های \(aqS\(aq و \(aqN\(aq روی 1 تنظیم شده باشند، پرچم \(aqN\(aq جهت سازگاری با رفتار ISC DHCP به 0 بازنشانی می‌شود..SS راهبردهای تخصیص در DHCPv6
.sp
یک سرور DHCP از الگوریتم پیچیده‌ای برای انتخاب اجارهٔ (lease) DHCPv6 برای کلاینت پیروی می‌کند.
این سرور واگذاری آدرس‌های خاص یا پیشوندهای تفویض‌شدهٔ درخواست‌شده توسط کلاینت
و مواردی را که کلاینت برای آن‌ها رزرو دارد، در اولویت قرار می‌دهد.
.sp
هنگامی که کلاینت یک پیشوند تفویض‌شدهٔ مشخص را درخواست می‌کند،
\fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> مجموعه‌ای از مراحل را برای برآورده کردن درخواست، به این
ترتیب دنبال می‌کند:
.INDENT 0.0
.IP 1. 3
به‌دنبال اجاره‌ای می‌گردد که با پیشوند و طول پیشوند درخواست‌شده مطابقت داشته باشد.
.IP 2. 3
به‌دنبال اجاره‌ای می‌گردد که با طول پیشوند مطابقت داشته باشد.
.IP 3. 3
به‌دنبال اجاره‌ای با فضای آدرس بزرگ‌تر (طول پیشوند کوچک‌تر) می‌گردد.
.IP 4. 3
به‌دنبال اجاره‌ای با فضای آدرس کوچک‌تر (طول پیشوند بزرگ‌تر) می‌گردد.
.UNINDENT
.sp
اگر کلاینت هیچ اجارهٔ خاصی را درخواست نکند و هیچ رزروی نداشته باشد، یا کلاینت‌های دیگر در حال حاضر از اجاره‌های درخواستی استفاده کنند، سرور باید
اجارهٔ دردسترس دیگری را در استخرهای (pools) پیکربندی‌شده پیدا کند. تابعی در سرور موسوم به
\(dqallocator\(dq (تخصیص‌دهنده) در Kea مسئول یافتن اجارهٔ دردسترس در چنین شرایطی است.
.sp
سرور Kea DHCPv6 پارامترهای پیکربندی مختلفی را برای انتخاب تخصیص‌دهنده‌های گوناگون
در سطوح سراسری (global)، شبکهٔ مشترک (shared\-network) و زیرشبکه (subnet) فراهم می‌کند. همچنین
امکان انتخاب راهبردهای تخصیص متفاوت را برای واگذاری آدرس‌ها و
تفویض پیشوند (prefix delegation) مهیا می‌سازد.
.sp
مثال زیر را در نظر بگیرید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqDhcp6\(dq: {
        \(dqallocator\(dq: \(dqiterative\(dq,
        \(dqpd\-allocator\(dq: \(dqrandom\(dq,
        \(dqsubnet6\(dq: [
            {
                \(dqid\(dq: 1,
                \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
                \(dqallocator\(dq: \(dqrandom\(dq
            },
            {
                \(dqid\(dq: 2,
                \(dqsubnet\(dq: \(dq2001:db8:2::/64\(dq,
                \(dqpd\-allocator\(dq: \(dqiterative\(dq
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
تخصیص‌دهندهٔ iterative به‌صورت سراسری برای واگذاری آدرس‌ها انتخاب شده است، در حالی که
تخصیص‌دهندهٔ random به‌صورت سراسری برای تفویض پیشوند تعیین شده است. این تنظیمات
به‌صورت انتخابی در سطح زیرشبکه بازنویسی (override) می‌شوند.
.sp
بخش‌های زیر تخصیص‌دهنده‌های پشتیبانی‌شده و کاربردهای
توصیه‌شدهٔ آن‌ها را شرح می‌دهند.
.SS مقایسهٔ تخصیص‌دهنده‌ها
.sp
در جدول زیر، تخصیص‌دهنده‌های پشتیبانی‌شده را به‌طور خلاصه مقایسه می‌کنیم؛
تمامی آن‌ها در بخش‌های بعدی با جزئیات شرح داده شده‌اند.
.SS مقایسهٔ تخصیص‌دهنده‌های اجارهٔ پشتیبانی‌شده توسط Kea DHCPv6
.TS
box center;
l|l|l|l|l|l.
T{
تخصیص‌دهنده
T}	T{
کارایی در بهره‌برداری کم
T}	T{
کارایی در بهره‌برداری زیاد
T}	T{
تصادفی‌سازی اجاره
T}	T{
راه‌اندازی/پیکربندی
T}	T{
مصرف حافظه
T}
_
T{
Iterative
T}	T{
بسیار بالا
T}	T{
پایین
T}	T{
خیر
T}	T{
بسیار سریع
T}	T{
کم
T}
_
T{
Random
T}	T{
بالا
T}	T{
پایین
T}	T{
بله
T}	T{
بسیار سریع
T}	T{
زیاد (متغیر)
T}
_
T{
Free Lease Queue
T}	T{
بالا
T}	T{
بالا
T}	T{
بله
T}	T{
کند (بسته به اندازهٔ استخرها)
T}	T{
زیاد (متغیر)
T}
_
T{
Shared FLQ
T}	T{
بالا
T}	T{
بالا
T}	T{
جزئی، استخرهای درون
زیرشبکه‌ها تصادفی هستند
T}	T{
کند هنگام افزودن استفاده؛
سریع پس از افزودن
T}	T{
کم
T}
.TE.SS تخصیص‌دهنده تکرارشونده (Iterative Allocator)
.sp
این تخصیص‌دهنده پیش‌فرضی است که توسط کارگزار Kea DHCPv6 استفاده می‌شود. این تخصیص‌دهنده آخرین اجارهٔ پیشنهادشده را به خاطر می‌سپارد و اجارهٔ ترتیبی بعدی را به کلاینت بعدی پیشنهاد می‌دهد. برای نمونه، ممکن است نشانی‌ها را به این ترتیب پیشنهاد دهد: \fB2001:db8:1::10\fP، \fB2001:db8:1::11\fP، \fB2001:db8:1::12\fP و غیره. به همین ترتیب، پیشوند واگذارشدهٔ ترتیبی بعدی را پس از مورد قبلی به کلاینت بعدی پیشنهاد می‌کند. زمان لازم برای یافتن و پیشنهاد دادن اجاره یا پیشوند واگذارشدهٔ بعدی بسیار کوتاه است؛ بنابراین، زمانی که بهره‌برداری از استخر پایین بوده و احتمال در دسترس بودن اجارهٔ انتخابی بعدی بالا باشد، این کارآمدترین تخصیص‌دهنده است.
.sp
تخصیص تکرارشونده زمانی که چندین کارگزار DHCP یک پایگاه‌دادهٔ اجاره را به اشتراک می‌گذارند یا به یک کلاستر متصل هستند، عملکرد ضعیفی ارائه می‌دهد. کارگزارها تمایل دارند همان بلوک‌های نشانی را به‌طور مستقل به کلاینت‌های مختلف پیشنهاد داده و تخصیص دهند، که باعث تداخل‌های تخصیص فراوان بین کارگزارها و ارسال‌های مجدد توسط کلاینت‌ها می‌شود. یک تخصیص تصادفی با پراکنده‌سازی ترتیب تخصیص، این مشکل را برطرف می‌کند.
.SS تخصیص‌دهنده تصادفی (Random Allocator)
.sp
تخصیص‌دهنده تصادفی از یک تابع تصادفی‌سازی یکنواخت برای انتخاب نشانی‌ها و پیشوندهای واگذارشدهٔ پیشنهادی از استخرهای زیرشبکه استفاده می‌کند. این تخصیص‌دهنده در استقرارهایی مناسب است که چندین کارگزار به یک پایگاه‌دادهٔ مشترک یا یک کلاستر پایگاه‌داده متصل هستند. کارگزارها با پراکنده‌سازی اجاره‌های پیشنهادی، خطر تخصیص هم‌زمان یا تقریباً هم‌زمان یک اجارهٔ یکسان به دو کلاینت مختلف را به حداقل می‌رسانند. علاوه بر این، تاب‌آوری کارگزار را در برابر حملات مبتنی بر پیش‌بینی‌پذیری تخصیص بهبود می‌بخشد.
.sp
با این حال، تخصیص‌دهنده تصادفی اندکی از تخصیص‌دهنده تکرارشونده کندتر است. افزون بر این، مصرف حافظهٔ کارگزار را افزایش می‌دهد زیرا باید اجاره‌های تصادفی‌شده را به خاطر بسپارد تا از پیشنهاد دوبارهٔ آن‌ها جلوگیری کند. مصرف حافظه با تعداد اجاره‌های پیشنهادشده رشد می‌کند؛ به عبارت دیگر، استخرهای بزرگ‌تر و کلاینت‌های بیشتر، مصرف حافظه را در تخصیص تصادفی افزایش می‌دهند.
.SS تخصیص‌دهنده صف اجاره‌های آزاد (فقط واگذاری پیشوند)
.sp
این یک تخصیص‌دهنده پیشرفته است که استفاده از آن باید در زیرشبکه‌هایی با استخرهای پیشوند واگذارشده با میزان مصرف بالا مد نظر قرار گیرد. در چنین مواردی، ممکن است یافتن یک پیشوند در دسترس برای تخصیص‌دهنده تکرارشونده یا تصادفی زمان قابل‌توجهی ببرد، زیرا آن‌ها باید مکرراً بررسی کنند که آیا برای پیشوندی که قصد پیشنهاد آن را دارند یک اجارهٔ معتبر وجود دارد یا خیر. زمانی که ظرفیت استخرهای زیرشبکه تکمیل شده باشد، تعداد بررسی‌ها می‌تواند به اندازهٔ تعداد کل پیشوندهای واگذارشده در زیرشبکه بالا برود که این امر می‌تواند تأثیر منفی مستقیمی بر زمان پاسخ DHCP برای هر درخواست بگذارد.
.sp
تخصیص‌دهنده Free Lease Queue (FLQ) تخصیص‌ها و لغو تخصیص‌های اجاره را ردیابی کرده و فهرستی پویا از پیشوندهای واگذارشدهٔ در دسترس را برای هر استخر نگهداری می‌کند. این تخصیص‌دهنده اجازه می‌دهد که بدون در نظر گرفتن میزان استفاده از استخرهای زیرشبکه، یک اجارهٔ در دسترس در یک زمان ثابت انتخاب شود. تخصیص‌دهنده با حذف اجاره‌های تخصیص‌یافته و افزودن اجاره‌های آزادشده یا بازپس‌گرفته‌شده، فهرست اجاره‌های آزاد را به‌طور مداوم به‌روزرسانی می‌کند.
.sp
قطعه پیکربندی زیر نحوه انتخاب تخصیص‌دهنده FLQ را برای واگذاری پیشوند در یک زیرشبکه نشان می‌دهد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqDhcp6\(dq: {
        \(dqsubnet6\(dq: [
            {
                \(dqid\(dq: 1,
                \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
                \(dqpd\-allocator\(dq: \(dqflq\(dq
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
تخصیص‌دهنده Free Lease Queue تنها می‌تواند برای واگذاری پیشوند DHCPv6 استفاده شود. تلاش برای استفاده از این تخصیص‌دهنده جهت انتساب نشانی (با پارامتر \fBallocator\fP) منجر به خطای پیکربندی خواهد شد. استخرهای نشانی DHCPv6 معمولاً بسیار بزرگ هستند و میزان استفاده از آن‌ها پایین است؛ در این وضعیت، مزایای استفاده از تخصیص‌دهنده FLQ کم‌رنگ می‌شود. مدت‌زمان مورد نیاز تخصیص‌دهنده برای پر کردن صف اجاره‌های آزاد، باعث قفل شدن کارگزار در هنگام راه‌اندازی می‌شود.
.UNINDENT
.UNINDENT
.sp
چندین نکته وجود دارد که مدیر سیستم باید پیش از استفاده از این تخصیص‌دهنده برای واگذاری پیشوند مد نظر قرار دهد. تخصیص‌دهنده FLQ می‌تواند تأثیر شدیدی بر زمان راه‌اندازی و بازپیکربندی کارگزار بگذارد، زیرا تخصیص‌دهنده باید فهرست اجاره‌های آزاد را برای هر زیرشبکه‌ای که در آن استفاده می‌شود پر کند. این تأخیرها هم در طول بارگذاری مجدد پیکربندی و هم هنگامی که زیرشبکه‌ها با استفاده از \fBlibdhcp_subnet_cmds.so\fP \%<#\:std-ischooklib-libdhcp_subnet_cmds\:.so>\& ایجاد می‌شوند، قابل مشاهده است. این تخصیص‌دهنده برای نگهداری فهرست اجاره‌های آزاد، مصرف حافظه را متناسب با اندازهٔ کل استخرهایی که برای آن‌ها به کار رفته است افزایش می‌دهد. در نهایت، بازپس‌گیری اجاره باید با مقدار پایینی برای پارامتر \fBreclaim\-timer\-wait\-time\fP فعال شود، تا اطمینان حاصل گردد که کارگزار به‌طور مکرر اجاره‌های منقضی‌شده را جمع‌آوری کرده و آن‌ها را از طریق صف اجاره‌های آزاد برای تخصیص مجدد در دسترس قرار می‌دهد. اجاره‌های منقضی‌شده تا زمانی که توسط کارگزار بازپس‌گرفته نشوند، از نظر تخصیص‌دهنده آزاد به شمار نمی‌آیند. برای جزئیات بیشتر درباره فرایند بازپس‌گیری اجاره، بخش Lease Reclamation \%<#\:lease-reclamation> را ببینید.
.sp
پیشنهاد می‌کنیم تخصیص‌دهنده FLQ تنها پس از بررسی دقیق انتخاب شود. کارگزار هیچ محدودیتی بر اندازه استخرهای delegated\-prefix مورد استفاده با تخصیص‌دهنده FLQ اعمال نمی‌کند، بنابراین به کاربران توصیه می‌کنیم قبل از استقرار پیکربندی دارای تخصیص‌دهنده FLQ در محیط عملیاتی، زمان لازم برای بارگذاری استخرها توسط کارگزار را آزمایش کنند. همچنین توصیه می‌کنیم نوع تخصیص‌دهنده دیگری را در تنظیمات پیکربندی سراسری مشخص کرده و این انتخاب را در سطح subnet یا shared\-network بازنویسی کنید، تا از تخصیص‌دهنده FLQ فقط برای زیرشبکه‌های انتخابی استفاده شود. به این ترتیب، زمانی که یک زیرشبکه جدید بدون مشخص کردن تخصیص‌دهنده افزوده می‌شود، تنظیمات سراسری استفاده می‌شود و در نتیجه از تحمیل اثر غیرضروری بر زمان راه‌اندازی کارگزار جلوگیری می‌شود.
.sp
\fBهشدار:\fP
.INDENT 0.0
.INDENT 3.5
تخصیص‌دهنده FLQ برای استفاده با پایگاه‌دادهٔ اجاره مشترک مناسب نیست (یعنی زمانی که چندین کارگزار Kea اجاره‌ها را در یک پایگاه‌داده یکسان ذخیره می‌کنند). کارگزارها از اجاره‌های منقضی‌شده‌ای که توسط کارگزارهای همتا بازپس‌گرفته شده‌اند اطلاعی ندارند و هرگز آن‌ها را به صف‌های محلی اجاره‌های آزاد خود بازنمی‌گردانند. در نتیجه، کارگزارها قادر نخواهند بود برخی از اجاره‌های در دسترس را به کلاینت‌ها پیشنهاد دهند. تنها کارگزاری که یک اجارهٔ مشخص را بازپس می‌گیرد قادر به پیشنهاد دادن آن خواهد بود.
.UNINDENT
.UNINDENT
.sp
در Kea 3.1.1 یک پارامتر جدید با نام \fBadaptive\-lease\-time\-threshold\fP اضافه شد. این پارامتر می‌تواند در سطوح global، shared network و subnet مشخص شود و یک مقدار اعشاری بین \fB0.0\fP (به‌جز خود آن) و \fB1.0\fP می‌پذیرد. این پارامتر به‌طور پیش‌فرض یا در صورت تنظیم بر روی \fB1.0\fP غیرفعال است. این پارامتر تنها توسط تخصیص‌دهنده FLQ پشتیبانی می‌شود. هنگامی که نرخ اشغال استخرها در یک زیرشبکه بالاتر از مقدار مشخص‌شده باشد، کارگزار طول‌عمر معتبر اجاره را برای کلاینت‌های جدید به مقدار مربوط در \fBmin\-valid\-lifetime\fP کاهش می‌دهد. کلاینت‌هایی که یک اجارهٔ موجود را تمدید می‌کنند، حداقل طول‌عمر باقی‌مانده از اجارهٔ فعلی را دریافت خواهند کرد. از آنجا که اجاره‌ها سریع‌تر منقضی می‌شوند، کارگزار می‌تواند سریع‌تر بازیابی شود یا به‌طور کامل از اتمام ظرفیت استخر جلوگیری کند.
.sp
نرخ اشغال به‌صورت تعداد پیشوندهای واگذارشدهٔ پیش‌تر تخصیص‌یافته (شامل نشانی در حال تخصیص) تقسیم بر تعداد کل پیشوندها در استخرهایی که امکان تخصیص نشانی از آن‌ها وجود دارد، تعریف می‌شود (یعنی اگر پرس‌وجو عضو محافظ \fBclient\-classes\fP یک استخر نباشد، یا اگر طول پیشوند واگذارشده سازگار نباشد، آن استخر در نظر گرفته نمی‌شود)..SS تخصیص‌دهنده Shared Free Lease Queue
.sp
\fBهشدار:\fP
.INDENT 0.0
.INDENT 3.5
این ویژگی که در Kea 3.1.9 افزوده شده است، آزمایشی در نظر گرفته می‌شود و برای استفاده در محیط عملیاتی پشتیبانی نمی‌شود.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
تخصیص‌دهنده SFLQ می‌تواند برای استخرهای آدرس یا پیشوند (prefix) استفاده شود. برای شفافیت، این ویژگی در ادامه بر اساس استخرهای آدرس توضیح داده شده است، اما به‌طور یکسان در مورد استخرهای پیشوند نیز صدق می‌کند.
.UNINDENT
.UNINDENT
.sp
تخصیص‌دهنده Shared Free Lease Queue (SFLQ) برای سایت‌هایی در نظر گرفته شده است که دارای پشتیبان‌های اجاره اشتراکی (MySQL یا PostgreSQL) و زیرشبکه‌هایی با استخرهای آدرس دارای مصرف بالا هستند. در چنین مواردی، پیدا کردن یک آدرس آزاد برای تخصیص‌دهنده تکرارشونده (iterative) یا تصادفی (random) می‌تواند زمان قابل توجهی ببرد، زیرا آن‌ها باید مکرراً بررسی کنند که آیا برای آدرسی که پیشنهاد می‌دهند اجاره معتبری وجود دارد یا خیر. زمانی که استخرهای زیرشبکه رو به اتمام باشند، تعداد بررسی‌ها می‌تواند به اندازه تعداد آدرس‌های موجود در زیرشبکه بالا برود. از آنجا که هر بررسی نیازمند یک پرس‌وجو از پایگاه داده است، این مسئله می‌تواند تأثیر منفی مستقیمی بر زمان پاسخ DHCP برای هر درخواست بگذارد.
.sp
مشابه تخصیص‌دهنده Free Lease Queue، تخصیص‌دهنده SFLQ تخصیص‌ها و آزادسازی‌های اجاره را ردیابی کرده و فهرستی پویا از آدرس‌های در دسترس برای هر استخر آدرس نگهداری می‌کند. به این فهرست‌ها داده‌های SFLQ گفته می‌شود. این قابلیت امکان انتخاب یک اجاره در دسترس را در زمانی ثابت، صرف‌نظر از میزان مصرف استخرهای زیرشبکه، فراهم می‌کند. داده‌های SFLQ از طریق به‌روزرسانی‌های اختصاصی اجاره که توسط سرور Kea برای اجاره‌های متعلق به زیرشبکه‌های دارای تخصیص SFLQ به کار می‌رود، نگهداری می‌شوند.
.sp
تفاوت بنیادین میان تخصیص‌دهنده‌های FLQ و SFLQ در این است که تخصیص SFLQ داده‌های SFLQ را به‌جای حافظه محلی سرور Kea، به‌صورت متمرکز در پشتیبان اجاره ذخیره می‌کند. این امر اجازه می‌دهد داده‌ها بین سرورها به اشتراک گذاشته شوند تا همگی درک یکسانی از وضعیت فعلی اجاره‌ها داشته باشند. این ویژگی همچنین به این معناست که داده‌های SFLQ پس از ایجاد پایدار می‌مانند و بنابراین نیازی به ایجاد مجدد آن‌ها هنگام راه‌اندازی یا بازپیکربندی سرور Kea نیست.
.sp
از آنجا که استخرهای آدرس v6 می‌توانند بسیار بزرگ باشند و معمولاً نرخ مصرف پایینی دارند، تخصیص‌دهنده پیش‌فرض Iterative باید کارایی مناسبی ارائه دهد. تخصیص‌دهنده SFLQ می‌تواند برای استخرهای تفویض پیشوند (prefix delegation) که در آن‌ها تعداد پیشوندها در یک استخر مشخص محدودتر بوده و مصرف استخر می‌تواند بسیار بالا باشد، بسیار مفید واقع شود.
.sp
تخصیص‌دهنده‌ها برای v6 به‌طور مستقل برای آدرس‌ها و پیشوندهای تفویض‌شده تعیین می‌شوند. تخصیص‌دهنده SFLQ ممکن است برای هر دو نوع استخر استفاده شود. قطعه پیکربندی زیر نشان می‌دهد که چگونه تخصیص‌دهنده‌های SFLQ را برای تمام استخرهای هر دو نوع در یک زیرشبکه انتخاب کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqDhcp6\(dq: {
        \(dqsubnet6\(dq: [
            {
                \(dqid\(dq: 1,
                 \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
                 \(dqallocator\(dq: \(dqshared\-flq\(dq,
                 \(dqpd\-allocator\(dq: \(dqshared\-flq\(dq
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
ملاحظاتی وجود دارد که مدیر سیستم باید پیش از استفاده از این تخصیص‌دهنده در نظر بگیرد. همانند FLQ، تخصیص‌دهنده SFLQ می‌تواند تأثیر شدیدی بر زمان راه‌اندازی و بازپیکربندی سرور بگذارد، زیرا تخصیص‌دهنده باید داده‌های SFLQ را برای هر استخر در هر زیرشبکه‌ای که در آن به کار رفته پر کند. این تأخیرها هم در طول بارگذاری مجدد پیکربندی و هم زمانی که زیرشبکه‌ها با استفاده از \fBlibdhcp_subnet_cmds.so\fP \%<#\:std-ischooklib-libdhcp_subnet_cmds\:.so>\& ایجاد می‌شوند، قابل مشاهده است. برخلاف FLQ، این هزینه‌ها تنها اولین باری رخ می‌دهند که یک زیرشبکه برای استفاده از SFLQ پیکربندی می‌شود یا تغییراتی در بازه‌های آدرس استخرهای آن اعمال می‌گردد. به عبارت دیگر، پس از راه‌اندازی مجدد یا بازپیکربندی، داده‌های SFLQ فقط باید برای استخرهایی ایجاد شوند که از قبل داده‌ای برای آن‌ها وجود ندارد. بنابراین تأثیر آن بر راه‌اندازی‌های مجدد یا بازپیکربندی‌های بعدی زیرشبکه‌هایی که از قبل از SFLQ استفاده می‌کنند، حداقلی است.
.sp
از آنجا که داده‌های SFLQ در پشتیبان اجاره نگهداری می‌شوند، هزینه ذخیره‌سازی آن بر دوش فضای دیسک سرور پایگاه داده است تا حافظه محلی سرور Kea. مصرف دیسک برای داده‌های SFLQ کسری از مقداری است که از پیش به ازای هر اجاره ذخیره شده است، و با افزایش مصرف استخر، حجم داده‌های SFLQ کاهش می‌یابد.
.sp
ما توصیه می‌کنیم تخصیص‌دهنده SFLQ تنها پس از بررسی دقیق انتخاب شود. همان‌طور که در بالا اشاره شد، هنگام آغاز استفاده از SFLQ تأثیر بر زمان راه‌اندازی می‌تواند قابل توجه باشد. ایجاد داده‌های اولیه SFLQ برای استخرهای بزرگ (مثلاً بیش از ۵۰۰ هزار آدرس یا پیشوند) ممکن است راه‌اندازی سرور را چند ثانیه یا بیشتر به ازای هر استخر به تأخیر بیندازد. این فرآیند برای استخرهای کوچک‌تر (مثلاً ۶۵ هزار آدرس یا پیشوند) سریع‌تر است، اما در صورت وجود استخرهای زیاد، مجموع زمان آن‌ها انباشته می‌شود. برای کاهش این هزینه راه‌اندازی، توصیه می‌کنیم نوع تخصیص‌دهنده دیگری را در سطح سراسری (global) مشخص کرده و تخصیص‌دهنده SFLQ را در سطح زیرشبکه یا shared\-network تنها برای زیرشبکه‌های گزینش‌شده تعیین نمایید.
.sp
جنبه مهم دیگری از تخصیص‌دهنده SFLQ وجود دارد که نیازمند توجه است. همان‌طور که پیش‌تر ذکر شد، هنگامی که یک سرور از تخصیص SFLQ برای استخری معین استفاده می‌کند، به‌روزرسانی‌های اختصاصی در پشتیبان را برای نگهداری داده‌های SFLQ به کار می‌گیرد. بنابراین حیاتی است که تمام سرورهایی که در یک پشتیبان اجاره سهیم هستند، در مورد اینکه کدام زیرشبکه‌ها از تخصیص SFLQ استفاده می‌کنند هماهنگ باشند. اگر آن‌ها هماهنگ نباشند، داده‌های SFLQ به‌سرعت نادقیق می‌شوند؛ آدرس‌ها ممکن است آزاد به نظر برسند در حالی که آزاد نیستند و برعکس. در حالت اول، موتور تخصیص یک اجاره موجود را شناسایی کرده و آدرس دیگری را امتحان می‌کند؛ در حالت دوم، اجاره پیشنهاد داده نخواهد شد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
اکیداً توصیه می‌شود که پیکربندی زیرشبکه‌ها برای شروع یا توقف استفاده از تخصیص SFLQ در بازه‌های تعمیر و نگهداری (maintenance windows) انجام گیرد تا در حین اعمال تغییرات، سرورها به‌طور فعال به کلاینت‌های آن زیرشبکه‌ها سرویس ندهند. این کار از بروز ناسازگاری در داده‌های SFLQ جلوگیری می‌کند.
.sp
داده‌های SFLQ بر پایه استخرها ردیابی می‌شوند که در آن‌ها هر استخر دارای یک آدرس شروع و یک آدرس پایان است. تغییرات پیکربندی که بازه آدرس یک استخر را تغییر می‌دهند یا آن را به چندین استخر جدید تقسیم می‌کنند، هنگام اعمال پیکربندی جدید باعث ایجاد داده‌های SFLQ برای استخرهای جدید خواهند شد.
.UNINDENT
.UNINDENT
.sp
همان‌طور که قبلاً اشاره شد، زمانی که سرور راه‌اندازی مجدد یا بازپیکربندی می‌شود، روی زیرشبکه‌های خود پیمایش کرده و تخصیص‌دهنده پیکربندی‌شده را برای استخرهای آن زیرشبکه مقداردهی اولیه می‌کند. برای تخصیص‌دهنده SFLQ، این امر موجب می‌شود سرور از پشتیبان اجاره درخواست کند تا داده‌های SFLQ را برای هر استخر موجود در زیرشبکه بسازد. اگر داده‌های SFLQ از قبل برای یک استخر وجود داشته باشد، درخواست فوراً بازمی‌گردد. در غیر این صورت، پس از ایجاد داده‌های SFLQ برای آن استخر بازخواهد گشت. ایجاد داده‌های SFLQ برای یک استخر مشخص، یک عملیات انحصاری (exclusive) است. هنگامی که این عملیات توسط یک سرور آغاز شد، هر درخواستی از سوی دیگر سرورها برای ایجاد داده‌های SFLQ همان استخر مسدود (block) شده و تا زمانی که نخستین درخواست ساخت داده‌های SFLQ استخر را کامل نکند، بازنخواهد گشت. به این ترتیب، فقط یک سرور واقعاً داده‌های SFLQ استخر را ایجاد می‌کند و تمام سرورهای دیگر تا زمانی که داده‌های SFLQ استخر موجود نباشد، از استفاده از آن منع می‌شوند. این رفتار برای حفظ نظم در حین راه‌اندازی‌ها و بازپیکربندی‌های هم‌زمان سرورها در نظر گرفته شده است.
.sp
در نهایت، موضوع استخرهای هم‌پوشان مطرح است. Kea پیکربندی استخرهایی را که بازه‌های آدرس آن‌ها با استخرهای دیگر هم‌پوشانی دارند، مجاز می‌داند (به Overlapping Pools مراجعه کنید). تخصیص‌دهنده SFLQ به‌طور کلی از این سناریوها پشتیبانی می‌کند، تا زمانی که تمام چنین استخرهایی روی همه سرورها:
.INDENT 0.0
.IP \(bu 2
برای استفاده از تخصیص‌دهنده SFLQ پیکربندی شده باشند
.IP \(bu 2
از یک نوع اجاره یکسان باشند (همگی \fBTYPE_NA\fP یا همگی \fBTYPE_PD\fP)
.IP \(bu 2
برای استخرهای تفویض پیشوند، مقدار delegated_len یکسانی داشته باشند
.UNINDENT
.sp
استفاده از استخرهای تفویض پیشوند هم‌پوشان در هر شرایطی غیر از تعریف یک استخر یکسان در چندین زیرشبکه، توصیه نمی‌شود.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
بازیابی اجاره (Lease reclamation) باید با مقداری کم برای پارامتر \fBreclaim\-timer\-wait\-time\fP فعال باشد تا اطمینان حاصل شود که سرور به‌طور مرتب اجاره‌های منقضی‌شده را جمع‌آوری کرده و آن‌ها را از طریق داده‌های SFLQ برای تخصیص در دسترس قرار می‌دهد. اجاره‌های منقضی‌شده تا زمانی که توسط سرور بازیابی نشوند، از نظر تخصیص‌دهنده آزاد محسوب نمی‌شوند. برای جزئیات بیشتر درباره فرآیند بازیابی اجاره، به Lease Reclamation \%<#\:lease-reclamation> مراجعه کنید.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
تخصیص‌دهنده SFLQ محدود به استفاده در استخرهایی با ظرفیت حداکثر 16777216 آدرس یا پیشوند است. استخرهایی با ظرفیت بزرگ‌تر باعث ایجاد خطای پیکربندی خواهند شد.
.UNINDENT
.UNINDENT
.sp
تخصیص‌دهنده SFLQ از \fBadaptive\-lease\-time\-threshold\fP پشتیبانی نمی‌کند..SH "اتصال به پایگاه داده (DATABASE CONNECTIVITY)"
.sp
سرورهای Kea (\fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> و \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6>) می‌توانند برای استفاده از بک‌اندهای مختلف پایگاه داده جهت اجاره‌ها (leases)، میزبان‌ها (hosts) و پیکربندی تنظیم شوند. آن‌ها می‌توانند از طریق پارامترهای \fBon\-fail\fP و \fBretry\-on\-startup\fP برای پشتیبانی از بازیابی خودکار در زمان قطع اتصال پیکربندی شوند.
(پارامترهای \fBreconnect\-wait\-time\fP و \fBmax\-reconnect\-tries\fP در بخش «Lease Database Configuration» \%<#\:database-configuration4> و «Lease Database Configuration» \%<#\:database-configuration6>\& شرح داده شده‌اند.)
.sp
درک این موضوع که بازیابی خودکار چگونه و چه زمانی وارد عمل می‌شود بسیار حائز اهمیت است.
بازیابی خودکار، در صورت پیکربندی، تنها پس از یک راه‌اندازی یا بازپیکربندی موفقیت‌آمیز که در طول آن اتصال به تمام بک‌اندها با موفقیت برقرار شده باشد، کار می‌کند.
.sp
در زمان راه‌اندازی سرور، ناتوانی در برقراری اتصال به هر یک از بک‌اندهای پیکربندی‌شده تنها در صورتی یک خطای مهلک در نظر گرفته می‌شود که \fBretry\-on\-startup\fP روی \fBfalse\fP (مقدار پیش‌فرض) تنظیم شده باشد. یک خطای مهلک در گزارش ثبت شده و بر این اساس که پیکربندی در زمان راه‌اندازی باید معتبر باشد، سرور خارج می‌شود. خروج به سیستم‌عامل این امکان را به اسکریپت‌های ناظر (nanny scripts) می‌دهد تا مشکل را تشخیص دهند.
اگر \fBretry\-on\-startup\fP روی \fBtrue\fP تنظیم شده باشد، سرور حتی در هنگام راه‌اندازی سرور یا رویدادهای بازپیکربندی نیز تلاش برای اتصال مجدد را آغاز کرده و از اقدام مشخص‌شده در پارامتر \fBon\-fail\fP پیروی خواهد کرد.
.sp
در طول بازپیکربندی پویا، اتصال تمام بک‌اندها قطع شده و سپس با استفاده از پیکربندی جدید مجدداً برقرار می‌شود. اگر اتصال به هر یک از بک‌اندها برقرار نشود، سرور یک خطای مهلک ثبت می‌کند اما فعال باقی می‌ماند. سرور قادر به پردازش دستورها خواهد بود، اما به کلاینت‌ها سرویس‌دهی نمی‌کند. این امر اجازه می‌دهد تا در صورت نیاز، پیکربندی از طریق دستورهای \fBconfig\-set\fP \%<#\:std-isccmd-config-set> یا \fBremote\-*\fP تصحیح شود.
.sp
در طول عملیات عادی، در صورتی که اتصال به هر یک از بک‌اندها قطع شود و بازیابی خودکار برای آن بک‌اند فعال باشد، سرور اتصال خود را از بک‌اند مربوطه قطع کرده و سپس تلاش می‌کند مجدداً متصل شود. در طول فرآیند بازیابی، سرور طبق گزینهٔ پیکربندی‌شدهٔ \fBon\-fail\fP سرویس‌دهی به کلاینت‌ها را متوقف می‌کند، اما همچنان به دستورها پاسخ می‌دهد.
.sp
پارامتر \fBon\-fail\fP اقداماتی را که سرور باید هنگام قطع اتصال انجام دهد، تعیین می‌کند. این پارامتر می‌تواند یکی از مقادیر زیر را داشته باشد:
.INDENT 0.0
.IP \(bu 2
\fBstop\-retry\-exit\fP \- نشان می‌دهد که سرور باید هنگام تلاش برای بازیابی اتصال، سرویس‌دهی را متوقف کرده و در صورتی که بازیابی پس از \fBmax\-reconnect\-tries\fP موفقیت‌آمیز نبود، خارج شود.
.IP \(bu 2
\fBserve\-retry\-exit\fP \- نشان می‌دهد که سرور نباید هنگام تلاش برای بازیابی اتصال سرویس‌دهی را متوقف کند، اما در صورتی که بازیابی پس از \fBmax\-reconnect\-tries\fP موفقیت‌آمیز نبود، باید خارج شود.
.IP \(bu 2
\fBserve\-retry\-continue\fP \- نشان می‌دهد که سرور نباید هنگام تلاش برای بازیابی اتصال سرویس‌دهی را متوقف کند، و در صورتی که بازیابی پس از \fBmax\-reconnect\-tries\fP موفقیت‌آمیز نبود نیز نباید خارج شود.
.UNINDENT
.sp
اگر اتصال به تمام بک‌اندها بازیابی شود، سرور به عملیات عادی بازمی‌گردد. اگر اتصال نتواند بازیابی شود و سرور برای خروج پیکربندی شده باشد، قبل از خاموش شدن یک خطای مهلک صادر می‌کند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
از نسخهٔ Kea 3.1.5، بک‌اند اجارهٔ memfile از پارامتر \fBon\-fail\fP پشتیبانی می‌کند. اگر هنگام نوشتن در فایل اجاره، خطایی مانند \(dqno space on device\(dq رخ دهد و \fBon\-fail\fP برابر با \fBstop\-retry\-exit\fP (پیش‌فرض) یا \fBserve\-retry\-exit\fP باشد، سرور بلافاصله خارج خواهد شد. اگر \fBon\-fail\fP برابر با \fBserve\-retry\-continue\fP باشد، سرور فعال باقی می‌ماند، هرچند خطاهای نوشتن تا زمان انجام اقدام اصلاحی ادامه خواهند داشت. مقادیری غیر از صفر برای \fBmax\-reconnect\-tries\fP و \fBreconnect\-wait\-time\fP توسط memfile پشتیبانی نمی‌شوند.
.UNINDENT
.UNINDENT
.sp
برای اینکه سرورهای Kea DHCP بتوانند با بک‌اندهای پایگاه داده کار کنند، طرح‌وارهٔ (schema) پایگاه داده باید ایجاد شده و با نسخهٔ سرور Kea مطابقت داشته باشد. اگر بررسی نسخه با شکست مواجه شود و بک‌اند پایگاه داده به‌صورت فقط‌خواندنی (read\-only) پیکربندی نشده باشد، Kea تلاش می‌کند تا طرح‌واره را مقداردهی اولیه کند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
سرور Kea به‌طور خودکار اقدام به ارتقای یک طرح‌وارهٔ موجود نمی‌کند؛ چرا که انجام این کار ممکن است کاربران را از فرصت اتخاذ اقدامات احتیاطی، مانند پشتیبان‌گیری از پایگاه داده یا خاموش کردن موقت سرورهای در حال اجرای Kea که در حال حاضر روی پایگاه داده کار می‌کنند، محروم سازد.
.UNINDENT
.UNINDENT
.sp
اتصال به سرور پایگاه داده می‌تواند به‌صورت اختیاری توسط TLS محافظت شود. پارامترهای پیکربندی متناظر پایگاه داده برای سرورهای Kea عبارتند از:
.INDENT 0.0
.IP \(bu 2
پارامتر \fBtrust\-anchor\fP نام فایل یا مسیر دایرکتوری مرجع صدور گواهی (CA) را مشخص می‌کند.
.IP \(bu 2
پارامتر \fBcert\-file\fP نام فایل گواهی کلاینت را مشخص می‌کند.
.IP \(bu 2
پارامتر \fBkey\-file\fP نام فایل کلید خصوصی را مشخص می‌کند.
.IP \(bu 2
پارامتر \fBssl\-mode\fP حالت SSL را مشخص می‌کند: \fBdisable\fP، \fBprefer\fP، \fBrequire\fP، \fBverify\-ca\fP یا \fBverify\-full\fP\&.
.IP \(bu 2
پارامتر \fBcipher\-list\fP فهرست سایفرهای TLS را مشخص می‌کند (نحوهٔ نگارش محتوای این پارامتر در راهنمای سایفرهای OpenSSL شرح داده شده است).
.UNINDENT
.sp
در حال حاضر، میزان پشتیبانی برای هر پایگاه داده به شرح زیر است:
.INDENT 0.0
.IP \(bu 2
پایگاه دادهٔ MySQL از تمام این مجموعه، به جز \fBssl\-mode\fP پشتیبانی می‌کند؛ پیکربندی‌های بیشتر باید در تنظیمات محلی MySQL انجام شوند، مانند فهرست ابطال گواهی (CRL)، انتخاب نسخهٔ خاصی از TLS، احراز هویت دوطرفه و غیره. هنگامی که یک اتصال TLS الزامی باشد اما اتصال واقعی به‌صورت متن آشکار (clear text) برقرار شود، یک گزارش خطا ثبت می‌گردد.
.IP \(bu 2
پایگاه دادهٔ PostgreSQL از تمام این مجموعه، به جز \fBcipher\-list\fP پشتیبانی می‌کند؛ پیکربندی‌های اضافی باید در کتابخانهٔ کلاینت (libpq) انجام شود. سایر موارد باید در پیکربندی محلی PostgreSQL صورت گیرد.
.UNINDENT
.sp
برای جزئیات بیشتر دربارهٔ ایمن‌سازی اتصال پایگاه داده، به بخش «Securing Database Connections» \%<#\:sec-database-connection>\& مراجعه کنید..SH "انقضای اجاره (LEASE EXPIRATION)"
.sp
نقش اصلی کارگزار DHCP تخصیص نشانی‌ها و/یا واگذاری پیشوندها به کلاینت‌های DHCP است. این نشانی‌ها و پیشوندها اغلب به عنوان «اجاره‌ها» (\(dqleases\(dq) نامیده می‌شوند. اجاره‌ها معمولاً برای مدت زمان محدودی که به عنوان «طول عمر معتبر» (\(dqvalid lifetime\(dq) شناخته می‌شود به کلاینت‌ها تخصیص می‌یابند. کلاینت‌های DHCP که مایلند به استفاده از اجاره‌های تخصیص‌یافته خود ادامه دهند، آن‌ها را به صورت دوره‌ای با ارسال پیام مناسب به کارگزار DHCP تمدید می‌کنند. کارگزار DHCP زمان تمدید این اجاره‌ها را ثبت کرده و زمان انقضای جدیدی برای آن‌ها محاسبه می‌کند.
.sp
اگر کلاینت اجاره‌ای را پیش از به پایان رسیدن طول عمر معتبر آن تمدید نکند، اجاره منقضی‌شده تلقی می‌شود. شرایط متعددی وجود دارد که ممکن است کلاینت تمدید اجاره را متوقف کند؛ سناریوهای رایج شامل مواردی است که دستگاه اجراکننده کلاینت برای مدت طولانی خاموش می‌شود یا دستگاه همراه از محدوده شبکه خارج می‌گردد.
.sp
فرآیندی که کارگزار DHCP طی آن اجاره‌های منقضی‌شده را برای تخصیص مجدد در دسترس قرار می‌دهد، «بازپس‌گیری اجاره» (\(dqlease reclamation\(dq) نامیده می‌شود، و اجاره‌های منقضی‌شده‌ای که از طریق این فرآیند مجدداً در دسترس قرار می‌گیرند «بازپس‌گرفته‌شده» (\(dqreclaimed\(dq) نام دارند. کارگزار DHCP به محض تشخیص انقضای یک اجاره، برای بازپس‌گیری آن تلاش می‌کند. کارگزار چندین راه ممکن برای تشخیص انقضا دارد: ممکن است تلاش کند اجاره‌ای را به یک کلاینت اختصاص دهد اما متوجه شود این اجاره در پایگاه‌داده وجود دارد و منقضی شده است؛ یا می‌تواند به‌طور دوره‌ای پایگاه‌داده اجاره را برای یافتن اجاره‌های منقضی‌شده پرس‌وجو کند. صرف‌نظر از چگونگی تشخیص اجاره منقضی‌شده، این اجاره باید پیش از تخصیص مجدد به یک کلاینت بازپس‌گیری شود.
.sp
این فصل نحوه پیکربندی کارگزار را برای پرس‌وجوی دوره‌ای اجاره‌های منقضی‌شده و چگونگی به حداقل رساندن تأثیر فرآیند دوره‌ای بازپس‌گیری اجاره بر پاسخگویی کارگزار شرح می‌دهد. در نهایت، «وابستگی اجاره» (\(dqlease affinity\(dq) را توضیح می‌دهد که سازوکاری برای تخصیص همان اجاره به یک کلاینت بازگشتی پس از انقضای اجاره‌اش فراهم می‌آورد.
.sp
اگرچه تمام مثال‌های پیکربندی در این بخش برای کارگزار DHCPv4 ارائه شده‌اند، اما همین پارامترها را می‌توان برای پیکربندی کارگزار DHCPv6 نیز به کار برد.
.SS "بازپس‌گیری اجاره (Lease Reclamation)"
.sp
بازپس‌گیری اجاره فرآیندی است که طی آن یک اجاره منقضی‌شده برای تخصیص به همان کلاینت یا کلاینتی دیگر در دسترس قرار می‌گیرد. این فرآیند شامل مراحل زیر برای هر اجاره بازپس‌گرفته‌شده است:
.INDENT 0.0
.IP \(bu 2
فراخوانی calloutها برای نقاط قلاب \fBlease4_expire\fP یا \fBlease6_expire\fP، در صورتی که کتابخانه‌های قلاب پشتیبانی‌کننده از آن calloutها بارگذاری شده باشند.
.IP \(bu 2
به‌روزرسانی DNS؛ یعنی حذف هرگونه مدخل DNS مرتبط با اجاره منقضی‌شده.
.IP \(bu 2
به‌روزرسانی اطلاعات اجاره در پایگاه‌داده اجاره‌ها به منظور نشان دادن اینکه اجاره اکنون برای تخصیص مجدد در دسترس است.
.IP \(bu 2
به‌روزرسانی شمارنده‌ها در کارگزار؛ فرآیندی که شامل افزایش تعداد اجاره‌های بازپس‌گرفته‌شده و کاهش تعداد نشانی‌های تخصیص‌یافته یا پیشوندهای واگذارشده است.
.UNINDENT
.sp
لطفاً برای مشاهده نحوه پیکربندی به‌روزرسانی‌های DNS در Kea به The DHCP\-DDNS Server \%<#\:dhcp-ddns-server> و برای اطلاعات درباره استفاده از کتابخانه‌های قلاب به Hook Libraries \%<#\:hooks-libraries> مراجعه کنید.
.SS "پارامترهای پیکربندی بازپس‌گیری اجاره (Lease Reclamation Configuration Parameters)"
.sp
فهرست زیر تمام پارامترهای پیکربندی مربوط به پردازش اجاره‌های منقضی‌شده را به همراه مقادیر پیش‌فرض آن‌ها ارائه می‌دهد:
.INDENT 0.0
.IP \(bu 2
\fBreclaim\-timer\-wait\-time\fP \- این پارامتر فاصله‌های زمانی بین اتمام چرخه بازپس‌گیری قبلی و شروع چرخه بعدی را تنظیم می‌کند. بر حسب ثانیه مشخص می‌شود؛ مقدار پیش‌فرض 10 است.
.IP \(bu 2
\fBflush\-reclaimed\-timer\-wait\-time\fP \- این پارامتر مشخص می‌کند کارگزار با چه تواتری روند بازپس‌گیری اجاره را آغاز می‌کند. بر حسب ثانیه بیان می‌شود؛ مقدار پیش‌فرض 25 است. اگر هر دو پارامتر \fBflush\-reclaimed\-timer\-wait\-time\fP و \fBhold\-reclaimed\-time\fP غیر صفر باشند، هنگامی که کلاینت پیام release ارسال می‌کند، اجاره به جای حذف شدن از فضای ذخیره‌سازی اجاره‌ها، منقضی می‌شود.
.IP \(bu 2
\fBhold\-reclaimed\-time\fP \- این پارامتر تعیین می‌کند که اجاره پس از بازپس‌گیری تا چه مدت باید نگهداری شود. مقدار غیر صفر این پارامتر، قابلیت وابستگی اجاره را فعال می‌کند. بر حسب ثانیه بیان می‌شود؛ مقدار پیش‌فرض 3600 است. اگر هر دو پارامتر \fBflush\-reclaimed\-timer\-wait\-time\fP و \fBhold\-reclaimed\-time\fP غیر صفر باشند، هنگامی که کلاینت پیام release ارسال می‌کند، اجاره به جای حذف شدن از فضای ذخیره‌سازی اجاره‌ها، منقضی می‌شود.
.IP \(bu 2
\fBmax\-reclaim\-leases\fP \- این پارامتر حداکثر تعداد اجاره‌های بازپس‌گرفته‌شده‌ای را که می‌توان در یک نوبت پردازش کرد مشخص می‌کند. مقدار صفر به معنی نامحدود است (یعنی پردازش تمام اجاره‌های بازپس‌گرفته‌شده). مقدار پیش‌فرض 100 است.
.IP \(bu 2
\fBmax\-reclaim\-time\fP \- این پارامتر حد بالایی برای مدت زمانی که یک فرآیند بازپس‌گیری اجاره می‌تواند طول بکشد تعیین می‌کند. مقدار صفر به معنای نبود محدودیت زمانی است. بر حسب میلی‌ثانیه بیان می‌شود؛ مقدار پیش‌فرض 250 است.
.IP \(bu 2
\fBunwarned\-reclaim\-cycles\fP \- در صورت تعیین محدودیت‌های بازپس‌گیری اجاره (\fBmax\-reclaim\-leases\fP و/یا \fBmax\-reclaim\-time\fP)، تحت شرایط خاصی ممکن است کارگزار نتواند اجاره‌های آماده بازپس‌گیری را با سرعت کافی پردازش کند. این پارامتر مشخص می‌کند چند چرخه پاک‌سازی متوالی باید با باقی ماندن اجاره‌های در صف پردازش خاتمه یابند پیش از آنکه هشداری چاپ شود. مقدار پیش‌فرض 5 چرخه است.
.UNINDENT
.sp
این پارامترها با جزئیات بیشتر در ادامه این فصل توضیح داده شده‌اند.
.sp
در صورتی که پارامتری صراحتاً در پیکربندی مشخص نشده باشد، مقدار پیش‌فرض آن به کار می‌رود. اگر نگاشت \fBexpired\-leases\-processing\fP به‌طور کامل در پیکربندی حذف شده باشد، مقادیر پیش‌فرض برای تمام پارامترهای فهرست‌شده در بالا استفاده می‌شوند.
.SS "پیکربندی بازپس‌گیری اجاره (Configuring Lease Reclamation)"
.sp
برنامه Kea را می‌توان به گونه‌ای پیکربندی کرد که اجاره‌های منقضی‌شده را به‌طور دوره‌ای شناسایی و بازپس‌گیری کند. در طول این فرآیند، مدخل‌های اجاره در پایگاه‌داده اصلاح یا حذف می‌شوند. در حین وقوع این امر، کارگزار پیام‌های ورودی DHCP را پردازش نمی‌کند تا از بروز تداخل دسترسی هم‌روند به اطلاعات پایگاه‌داده جلوگیری شود. در نتیجه، کارگزار در هنگام انجام بازپس‌گیری اجاره پاسخگو نخواهد بود و پرس‌وجوهای DHCP انباشته می‌شوند؛ پاسخ‌ها پس از اتمام چرخه بازپس‌گیری اجاره ارسال خواهند شد.
.sp
در پیاده‌سازی‌هایی که زمان پاسخ‌دهی در آن‌ها حیاتی است، مدیران سیستم ممکن است تمایل داشته باشند وقفه‌های سرویس‌دهی ناشی از بازپس‌گیری اجاره را به حداقل برسانند. به این منظور، Kea پارامترهای پیکربندی متعددی برای کنترل بسامد چرخه‌های بازپس‌گیری اجاره، حداکثر تعداد اجاره‌های پردازش‌شده در یک چرخه و حداکثر مدت زمانی که یک چرخه بازپس‌گیری اجازه دارد پیش از قطع شدن اجرا شود ارائه می‌دهد. مثال‌های زیر نحوه استفاده از این پارامترها را نشان می‌دهند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp4\(dq: {
    \(dqexpired\-leases\-processing\(dq: {
        \(dqreclaim\-timer\-wait\-time\(dq: 5,
        \(dqmax\-reclaim\-leases\(dq: 0,
        \(dqmax\-reclaim\-time\(dq: 0
    }
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
پارامتر اول بر حسب ثانیه بیان می‌شود و فاصله زمانی بین دو چرخه متوالی بازپس‌گیری اجاره را مشخص می‌کند. این موضوع با نمودار زیر توضیح داده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
|  c1  |            | c2 |            |c3|            | c4 |
|<\-\-\-\->|<\-\-\-\-\-\-\-\-\-\->|<\-\->|<\-\-\-\-\-\-\-\-\-\->|<>|<\-\-\-\-\-\-\-\-\-\->|<\-\->|<\-\-
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\->
|      |     5s     |    |     5s     |  |     5s     |    | time
.EE
.UNINDENT
.UNINDENT
.sp
این نمودار چهار چرخه بازپس‌گیری اجاره (c1 تا c4) با مدت زمان متغیر را نشان می‌دهد. مدت زمان چرخه بازپس‌گیری به تعداد اجاره‌های منقضی‌شده شناسایی و پردازش‌شده در آن چرخه خاص بستگی دارد. این مدت زمان معمولاً به میزان قابل توجهی کوتاه‌تر از فاصله بین چرخه‌ها است.
.sp
با توجه به \fBreclaim\-timer\-wait\-time\fP، کارگزار فاصله‌های زمانی ثابت پنج ثانیه‌ای بین پایان یک چرخه و شروع چرخه بعدی حفظ می‌کند. این امر وجود دوره‌های ۵ ثانیه‌ای را تضمین می‌کند که طی آن کارگزار به پرس‌وجوهای DHCP پاسخگو باقی می‌ماند و بازپس‌گیری اجاره را انجام نمی‌دهد. مقادیر \fBmax\-reclaim\-leases\fP و \fBmax\-reclaim\-time\fP روی 0 تنظیم شده‌اند که هیچ محدودیتی بر حداکثر تعداد اجاره‌های بازپس‌گرفته‌شده در چرخه مشخص یا حداکثر مدت زمان هر چرخه اعمال نمی‌کند.
.sp
در پیاده‌سازی‌هایی با بهره‌برداری بالای مخزن اجاره (lease pool)، طول عمرهای معتبر نسبتاً کوتاه، و کلاینت‌هایی با قطع ارتباط مکرر که باعث انقضای اجاره‌ها می‌شوند، ممکن است تعداد اجاره‌های منقضی‌شده نیازمند بازپس‌گیری در هر زمان معین به طور چشمگیری افزایش یابد. در این حالت، اغلب مطلوب است که محدودیت‌هایی بر حداکثر مدت زمان یک چرخه بازپس‌گیری یا حداکثر تعداد اجاره‌های بازپس‌گرفته‌شده در یک چرخه اعمال شود. پیکربندی زیر نشان می‌دهد چگونه می‌توان این کار را انجام داد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp4\(dq: {
    \(dqexpired\-leases\-processing\(dq: {
        \(dqreclaim\-timer\-wait\-time\(dq: 3,
        \(dqmax\-reclaim\-leases\(dq: 100,
        \(dqmax\-reclaim\-time\(dq: 50,
        \(dqunwarned\-reclaim\-cycles\(dq: 10
    }
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
در این مثال، پارامتر \fBmax\-reclaim\-leases\fP تعداد اجاره‌های بازپس‌گرفته‌شده در یک چرخه واحد را به 100 محدود می‌کند و \fBmax\-reclaim\-time\fP حداکثر مدت زمان هر چرخه را به 50 میلی‌ثانیه محدود می‌سازد. در صورت رسیدن به هر یک از این محدودیت‌ها، چرخه بازپس‌گیری اجاره متوقف خواهد شد. بازپس‌گیری هرگونه اجاره بازپس‌گرفته‌نشده در چرخه‌های بعدی انجام خواهد گرفت.
.sp
نمودار زیر رفتار سامانه را در حضور تعداد زیادی اجاره منقضی‌شده، زمانی که محدودیت‌ها بر چرخه‌های بازپس‌گیری اعمال شده‌اند، نشان می‌دهد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
| c1 |                | c2 |                | c3 |                | c4 |
|<\-\->|<\-\-\-\-\-\-\-\-\-\-\-\-\-\->|<\-\->|<\-\-\-\-\-\-\-\-\-\-\-\-\-\->|<\-\->|<\-\-\-\-\-\-\-\-\-\-\-\-\-\->|<\-\->|<\-\-
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\->
|50ms|       3s       |50ms|       3s       |50ms|       3s       |50ms|  time
.EE
.UNINDENT
.UNINDENT
.sp
در این حالت، اگر هر چرخه بازپس‌گیری بیش از 50 میلی‌ثانیه طول بکشد، بر اساس مقدار \fBmax\-reclaim\-time\fP متوقف می‌شود. این موضوع باعث برابری مدت زمان تمام چرخه‌های بازپس‌گیری در طول زمان می‌گردد. در این مثال، به محدودیت حداکثر 100 اجاره دسترسی پیدا نمی‌شود. این سناریو ممکن است زمانی رخ دهد که تراکنش‌های پایگاه‌داده یا calloutها در کتابخانه‌های قلاب متصل به کارگزار کند باشند. با این حال، مقادیر انتخاب‌شده برای حداکثر تعداد اجاره‌ها یا حداکثر زمان چرخه به شدت به نوع پیاده‌سازی، backend پایگاه‌داده اجاره مورد استفاده، کتابخانه‌های قلاب و غیره وابسته است. مدیران سیستم ممکن است برای تنظیم سامانه متناسب با شرایط استقرار خود، نیاز به آزمون و ارزیابی داشته باشند.
.sp
درک این نکته حائز اهمیت است که با اعمال این محدودیت‌ها، این خطر وجود دارد که اجاره‌های منقضی‌شده سریع‌تر از توانایی کارگزار در بازپس‌گیری آن‌ها انباشته شوند. اگر کارگزار با موج موقتی از انقضاها مواجه باشد مشکلی ایجاد نخواهد شد، چرا که می‌تواند به مرور زمان آن‌ها را پردازش کند. با این حال، اگر اجاره‌ها برای مدت طولانی با نرخ بالایی منقضی شوند، اجاره‌های بازپس‌گرفته‌نشده در پایگاه‌داده انباشته خواهند شد. به منظور مطلع ساختن مدیر سیستم از این موضوع که پیکربندی فعلی پاسخگوی نیازهای بازپس‌گیری اجاره‌های منقضی‌شده نیست، کارگزار در صورتی که نتواند تمام اجاره‌ها را طی چندین چرخه بازپس‌گیری کند، یک پیام هشدار در وقایع‌نگاری (log) صادر می‌کند. تعداد چرخه‌هایی که پس از آن‌ها چنین هشداری صادر می‌شود با پارامتر پیکربندی \fBunwarned\-reclaim\-cycles\fP تعیین می‌گردد.
.sp
تنظیم \fBreclaim\-timer\-wait\-time\fP روی 0، بازپس‌گیری دوره‌ای اجاره‌های منقضی‌شده را غیرفعال می‌کند..SS "پیکربندی تمایل اجاره (Configuring Lease Affinity)"
.sp
فرض کنید یک لپ‌تاپ پس از مدتی عدم فعالیت کاربر به حالت خواب (sleep mode) می‌رود. در حالی که لپ‌تاپ در حالت خواب است، کلاینت DHCP آن اجاره‌های دریافت‌شده از سرور را تمدید نمی‌کند و این اجاره‌ها در نهایت منقضی خواهند شد. هنگامی که لپ‌تاپ بیدار می‌شود، اغلب مطلوب است که همچنان به استفاده از آدرس‌های IP قبلیِ اختصاص‌یافته به خود ادامه دهد. برای تسهیل این امر، سرور باید کلاینت‌های بازگشتی را با اجاره‌های منقضی‌شدهٔ آن‌ها مرتبط سازد. هنگامی که کلاینت بازمی‌گردد، سرور ابتدا وجود آن اجاره‌ها را بررسی کرده و در صورتی که به کلاینت دیگری اختصاص نیافته باشند، آن‌ها را دوباره اختصاص می‌دهد. توانایی سرور در اختصاص مجدد همان اجاره به یک کلاینت بازگشتی، \(dqتمایل اجاره\(dq (lease affinity) نامیده می‌شود.
.sp
هنگامی که تمایل اجاره فعال باشد (یعنی زمانی که \fBhold\-reclaimed\-time\fP روی مقداری بزرگ‌تر از صفر پیکربندی شده باشد)، سرور همچنان اجاره‌ها را بر اساس پارامترهای شرح‌داده‌شده در بخش پیکربندی بازپس‌گیری اجاره (Configuring Lease Reclamation) بازپس می‌گیرد، اما اجاره‌های بازپس‌گرفته‌شده به جای حذف شدن، برای مدت‌زمان مشخصی در پایگاه داده نگهداری می‌شوند. اگر هر دو پارامتر \fBflush\-reclaimed\-timer\-wait\-time\fP و \fBhold\-reclaimed\-time\fP بزرگ‌تر از صفر باشند، زمانی که کلاینت یک پیام آزادسازی (release) ارسال می‌کند، اجاره به جای حذف شدن از فضای ذخیره‌سازی اجاره‌ها، بلافاصله منقضی می‌شود. هنگامی که کلاینت بازمی‌گردد، سرور ابتدا بررسی می‌کند که آیا اجارهٔ بازپس‌گرفته‌شده‌ای مرتبط با این کلاینت وجود دارد یا خیر و سپس در صورت امکان آن‌ها را دوباره اختصاص می‌دهد. با این حال، توجه به این نکته مهم است که هر اجارهٔ بازپس‌گرفته‌شده در صورتی که کلاینت دیگری مشخصاً آن را درخواست کند، ممکن است به آن کلاینت اختصاص یابد. بنابراین، تمایل اجاره تضمین نمی‌کند که اجارهٔ بازپس‌گرفته‌شده در دسترس کلاینتی که قبلاً از آن استفاده می‌کرده قرار گیرد؛ بلکه صرفاً احتمال اختصاص همان اجاره به کلاینت را افزایش می‌دهد. اگر استخر اجاره (lease pool) کوچک باشد \- به‌ویژه در DHCPv4 که فضای آدرس محدود است \- احتمال این‌که اجارهٔ منقضی‌شده به کلاینت دیگری اختصاص یابد افزایش می‌یابد.
.sp
پیکربندی زیر را در نظر بگیرید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqexpired\-leases\-processing\(dq: {
        \(dqreclaim\-timer\-wait\-time\(dq: 3,
        \(dqhold\-reclaimed\-time\(dq: 1800,
        \(dqflush\-reclaimed\-timer\-wait\-time\(dq: 5
    },
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
پارامتر \fBhold\-reclaimed\-time\fP مشخص می‌کند که یک اجارهٔ بازپس‌گرفته‌شده چند ثانیه پس از انقضا باید برای تخصیص مجدد به همان کلاینت در پایگاه داده نگهداری شود. در مثال فوق، اجاره‌های بازپس‌گرفته‌شده به مدت ۳۰ دقیقه (۱۸۰۰ ثانیه) پس از انقضایشان نگهداری می‌شوند. در طول این مدت، به احتمال زیاد سرور قادر خواهد بود همان اجاره را به کلاینت بازگشتی اختصاص دهد، مگر اینکه کلاینت دیگری صراحتاً این اجاره را درخواست کند و سرور آن را واگذار نماید.
.sp
سرور باید به‌صورت دوره‌ای اجاره‌های بازپس‌گرفته‌شده‌ای را که زمان مشخص‌شده توسط \fBhold\-reclaimed\-time\fP برای آن‌ها سپری شده است، حذف کند. پارامتر \fBflush\-reclaimed\-timer\-wait\-time\fP کنترل می‌کند که سرور هر چند وقت یک‌بار این‌گونه اجاره‌ها را حذف نماید. در مثال ارائه‌شده در بالا، سرور پنج ثانیه پس از تکمیل تلاش قبلی برای حذف، اقدام به حذف چنین اجاره‌هایی می‌کند. تنظیم این مقدار روی 0 تمایل اجاره را غیرفعال می‌کند، به این معنی که اجاره‌ها به محض بازپس‌گیری از پایگاه دادهٔ اجاره‌ها حذف می‌شوند. در صورت فعال بودن تمایل اجاره، توصیه می‌شود که \fBhold\-reclaimed\-time\fP روی مقداری به‌مراتب بالاتر از \fBreclaim\-timer\-wait\-time\fP تنظیم شود، زیرا حذف به‌موقع اجاره‌های منقضی/بازپس‌گرفته‌شده اهمیت کمتری نسبت به خودِ فرایند حذف دارد که می‌تواند بر پاسخ‌دهی سرور تأثیر بگذارد.
.sp
هیچ تضمینی وجود ندارد که تمایل اجاره همیشه کار کند؛ اگر سرور با کمبود آدرس مواجه شود، آدرس‌های منقضی‌شده را به کلاینت‌های جدید اختصاص خواهد داد. همچنین، کلاینت‌ها می‌توانند آدرس‌های خاصی را درخواست کنند و سرور در صورت امکان سعی می‌کند چنین درخواست‌هایی را برآورده سازد. مدیرانی که می‌خواهند مطمئن شوند یک کلاینت آدرس خود را حتی پس از دوره‌های عدم فعالیت حفظ می‌کند، باید استفاده از رزروهای میزبان (host reservations) یا اجاره‌هایی با طول عمر بسیار طولانی را در نظر بگیرند.
.SS "بازپس‌گیری اجاره‌های منقضی‌شده از طریق فرمان (Reclaiming Expired Leases via Command)"
.sp
دستور \fBleases\-reclaim\fP \%<#\:std-isccmd-leases-reclaim> می‌تواند برای راه‌اندازی بازپس‌گیری اجاره در هر زمان استفاده شود. لطفاً برای جزئیات مربوط به نحوهٔ استفاده از این دستور، به بخش The leases\-reclaim Command \%<#\:command-leases-reclaim> مراجعه کنید.
.SH "مدیریت ازدحام (CONGESTION HANDLING)"
.SS "ازدحام چیست؟ (What is Congestion?)"
.sp
ازدحام زمانی رخ می‌دهد که پرس‌وجوهای کلاینت‌ها با سرعتی فراتر از توان پردازش آن‌ها به سرورها سرازیر شوند. در نتیجه، سرورها شروع به انباشت صف معوقه‌ای از پرس‌وجوهای معلق می‌کنند. هرچه نرخ بالای ترافیک بیشتر ادامه یابد، سرورها عقب‌تر می‌مانند. بسته به پیاده‌سازی‌های کلاینت، کلاینت‌هایی که موفق به دریافت اجاره نمی‌شوند یا منصرف می‌شوند یا به‌سادگی برای همیشه به تلاش مجدد ادامه می‌دهند. در حالت اول، سرور ممکن است در نهایت بازیابی شود، اما حالت دوم یک چرخه معیوب است که سرور قادر به رهایی از آن نیست.
.sp
ازدحام معمولاً زمانی رخ می‌دهد که یک رخداد شبکه‌ای سبب شود تعداد بیش از حد زیادی از کلاینت‌ها به‌طور هم‌زمان به اجاره نیاز پیدا کنند؛ مانند بازیابی پس از قطعی شبکه. در یک استقرار خوب برنامه‌ریزی‌شده، تعداد و ظرفیت سرورها با حداکثر بار مورد انتظار کلاینت‌ها تطابق داده می‌شود. اگر بار به‌طور معمول بیش از حد سنگین باشد، باید در استقرار بازنگری شود.
.sp
هدف از مدیریت ازدحام، کمک به سرورها در کاهش اثر پیک ترافیک با پاسخ‌گویی به بیشترین تعداد ممکن از مرتبط‌ترین درخواست‌ها است تا زمانی که ازدحام فروکش کند.
.SS "پیکربندی مدیریت ازدحام (Configuring Congestion Handling)"
.sp
مدیریت ازدحام این امکان را فراهم می‌کند که سرور به‌گونه‌ای پیکربندی شود تا از یک رشته (thread) جداگانه برای خواندن بسته‌ها از بافرهای سوکت رابط استفاده کند. با خواندن بسته‌ها از بافرها توسط این رشته، آن‌ها به یک صف بستهٔ داخلی اضافه می‌شوند و رشتهٔ برنامهٔ اصلی سرور، بسته‌ها را به جای بافرهای سوکت از این صف پردازش می‌کند. با ساختاربندی به این روش، لایه‌ای قابل‌پیکربندی معرفی شده است که می‌تواند در مورد اینکه کدام بسته‌ها پردازش شوند، چگونه ذخیره گردند، و ترتیبی که توسط سرور پردازش می‌شوند تصمیم‌گیری کند.
.sp
پیاده‌سازی پیش‌فرض صف بسته برای هر دو \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> و \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> یک بافر حلقوی (ring buffer) ساده است. هنگامی که ظرفیت آن تکمیل شود، بسته‌های جدید با دور انداختن بسته‌ها از ابتدای صف، به انتهای صف اضافه می‌شوند. به جای دور انداختن همیشگی جدیدترین بسته‌ها، Kea اکنون همواره قدیمی‌ترین بسته‌ها را دور می‌اندازد. ظرفیت بافر، یعنی حداکثر تعداد بسته‌هایی که بافر می‌تواند در بر گیرد، قابل‌پیکربندی است. یک نقطهٔ شروع منطقی این است که ظرفیت را با تعداد اجاره‌ها بر ثانیه که یک نصب خاص از Kea می‌تواند مدیریت کند، تطبیق داد. این رقم بسته به مشخصات هر استقرار بسیار متغیر است.
.sp
از آنجا که هیچ الگوریتم یگانه‌ای وجود ندارد که بتواند پویایی همهٔ سایت‌ها را به بهترین شکل مدیریت کند، و با گذشت زمان رویکردهای جدیدی توسعه خواهند یافت، صف بسته به صورت یک پلاگین پیاده‌سازی شده است که می‌تواند با یک پیاده‌سازی صف سفارشی از طریق یک کتابخانهٔ قلاب (hook library) جایگزین شود. این امر باید آزمایش راه‌حل‌های اختصاصی را برای افراد علاقه‌مند ساده سازد. (توسعه‌دهندگان می‌توانند به \fBisc::dhcp::PacketQueue\fP و \fBisc::dhcp::PacketQueueMgr\fP که در راهنمای توسعه‌دهندهٔ Kea (Kea Developer\(aqs Guide) \%<https://\:reports\:.kea\:.isc\:.org/\:dev_guide/\:index\:.html>\& شرح داده شده‌اند مراجعه کنند.)
.sp
رفتار صف بسته در هر دو سرور \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> و \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> از طریق یک عنصر پیکربندی اختیاری در بالاترین سطح، یعنی \fBdhcp\-queue\-control\fP پیکربندی می‌شود. حذف این عنصر صف‌بندی بسته‌ها را غیرفعال می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqdhcp\-queue\-control\(dq: {
    \(dqenable\-queue\(dq: true, // true|false
    \(dqqueue\-type\(dq: \(dqqueue type\(dq,
    \(dqcapacity\(dq : 256 // n packets
}
.EE
.UNINDENT
.UNINDENT
.sp
که در آن:
.INDENT 0.0
.IP \(bu 2
\fBenable\-queue\fP \- صف‌بندی بسته‌ها را فعال یا غیرفعال می‌کند. هنگامی که مقدار آن \fBtrue\fP باشد، سرور بسته‌ها را از صف بسته که توسط یک رشتهٔ جداگانه پر می‌شود پردازش می‌کند. هنگامی که \fBfalse\fP باشد، سرور بسته‌ها را مستقیماً از بافرهای سوکت در رشتهٔ اصلی پردازش می‌نماید. این گزینه به‌طور پیش‌فرض غیرفعال (\fBfalse\fP) است.
.IP \(bu 2
\fBqueue\-type\fP \- نام پیاده‌سازی صف مورد استفاده. این مقدار به این منظور وجود دارد که بتوان پیاده‌سازی‌های سفارشی را (از طریق یک کتابخانهٔ قلاب) ثبت و سپس انتخاب کرد. یک پیاده‌سازی پیش‌فرض صف بسته وجود دارد که هنگام راه‌اندازی سرور از پیش ثبت شده است: \(dqkea\-ring4\(dq برای \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> و \(dqkea\-ring6\(dq برای \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6>\&.
.IP \(bu 2
\fBcapacity\fP \- این پارامتر حداکثر تعداد بسته‌هایی است که صف می‌تواند پیش از دور انداختن بسته‌ها در خود نگه دارد. مقدار بهینه برای این گزینه به‌شدت به ساختار سایت وابسته است. مقدار پیش‌فرض برای هر دو \(dqkea\-ring4\(dq و \(dqkea\-ring6\(dq برابر با 64 است.
.UNINDENT
.sp
مثال زیر صف بستهٔ پیش‌فرض را برای \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> با ظرفیت صف 250 بسته فعال می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq:
{
    \(dqdhcp\-queue\-control\(dq: {
       \(dqenable\-queue\(dq: true,
       \(dqqueue\-type\(dq: \(dqkea\-ring4\(dq,
       \(dqcapacity\(dq : 250
    },
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
مثال زیر صف بستهٔ پیش‌فرض را برای \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> با ظرفیت صف 300 بسته فعال می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq:
{
    \(dqdhcp\-queue\-control\(dq: {
       \(dqenable\-queue\(dq: true,
       \(dqqueue\-type\(dq: \(dqkea\-ring6\(dq,
       \(dqcapacity\(dq : 300
    },
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
مدیریت ازدحام در حال حاضر با چندرشتگی (multi\-threading) ناسازگار است؛ هنگامی که هر دو فعال باشند، مدیریت ازدحام در سکوت غیرفعال می‌شود.
.UNINDENT
.UNINDENT.SH "کارساز DHCP-DDNS (THE DHCP-DDNS SERVER)"
.SS "نمای کلی (Overview)"
.sp
کارساز DHCP\-DDNS (\fBkea\-dhcp\-ddns\fP \%<#\:std-iscman-kea-dhcp-ddns>، که به‌طور غیررسمی با نام D2 شناخته می‌شود) سمت کلاینت پروتکل DNS پویا (DDNS، تعریف‌شده در RFC 2136 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc2136>) را به نیابت از کارسازهای DHCPv4 و DHCPv6 (به‌ترتیب \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> و \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6>) مدیریت می‌کند. کارسازهای DHCP بر اساس رویدادهای تغییر اجاره در DHCP، درخواست‌های به‌روزرسانی DDNS را که با عنوان درخواست‌های تغییر نام (NameChangeRequests یا NCRs) شناخته می‌شوند ایجاد کرده و سپس به D2 ارسال می‌کنند. D2 تلاش می‌کند هر درخواست را با کارساز(های) DNS مناسب تطبیق دهد و تبادل لازم را با آن کارسازها برای به‌روزرسانی داده‌های DNS به انجام برساند.
.sp
کتابخانهٔ قلاب (hook) در Kea به نام \fBlibdhcp_ddns_tuning.so\fP \%<#\:std-ischooklib-libdhcp_ddns_tuning\:.so> این امکان را برای هر دو کارساز \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> و \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> فراهم می‌کند تا نام‌های میزبان را به‌صورت رویه‌ای بر اساس یک عبارت تولید کنند، به‌روزرسانی‌های DDNS را به‌ازای هر کلاینت نادیده بگیرند، یا جنبه‌های مختلف به‌روزرسانی DNS را به‌دقت تنظیم نمایند. لطفاً برای گزینه‌های پیکربندی به مستندات libdhcp_ddns_tuning.so: DDNS Tuning \%<#\:hooks-ddns-tuning> مراجعه کنید.
.SS "انتخاب کارساز DNS (DNS Server Selection)"
.sp
برای مطابقت دادن یک درخواست با کارسازهای DNS مناسب، D2 باید کاتالوگی از کارسازها داشته باشد تا از میان آن‌ها انتخاب کند. در واقع، D2 دو کاتالوگ از این دست دارد: یکی برای DNS مستقیم (forward) و دیگری برای DNS معکوس (reverse)؛ به این کاتالوگ‌ها «فهرست‌های دامنه‌های DDNS» (\(dqDDNS domain lists\(dq) گفته می‌شود. هر فهرست از یک یا چند دامنهٔ نام‌گذاری‌شدهٔ DDNS تشکیل شده است. علاوه بر این، هر دامنهٔ DDNS فهرستی از یک یا چند کارساز DNS دارد که داده‌های DNS آن دامنه را منتشر می‌کنند.
.sp
هنگام انجام تطبیق دامنهٔ مستقیم، D2 نام دامنهٔ کاملاً مشخص (FQDN) موجود در درخواست را با نام هر یک از دامنه‌های DDNS مستقیم در کاتالوگ خود مقایسه می‌کند. دامنه‌ای که نام آن با طولانی‌ترین بخش از FQDN مطابقت داشته باشد، بهترین تطابق در نظر گرفته می‌شود. به عنوان مثال، اگر FQDN برابر با \(dqmyhost.sample.example.com.\(dq باشد و دو دامنهٔ مستقیم در کاتالوگ به نام‌های \(dqsample.example.com.\(dq و \(dqexample.com.\(dq وجود داشته باشد، مورد اول بهترین تطابق محسوب می‌شود. در برخی موارد، ممکن است یافتن تطابق مناسب امکان‌پذیر نباشد. با فرض وجود همان دو دامنهٔ مستقیم، هیچ تطابقی برای FQDN با مقدار \(dqbogus.net\(dq وجود نخواهد داشت، بنابراین درخواست رد خواهد شد. در نهایت، اگر هیچ دامنهٔ DDNS مستقیمی تعریف نشده باشد، D2 به‌سادگی بخش به‌روزرسانی مستقیم درخواست‌ها را نادیده می‌گیرد.
.sp
هنگام انجام تطبیق دامنهٔ معکوس، D2 یک FQDN معکوس از آدرس اجاره در درخواست می‌سازد و آن را با نام هر دامنهٔ DDNS معکوس مقایسه می‌کند. مجدداً، دامنه‌ای که نام آن با طولانی‌ترین بخش از FQDN مطابقت داشته باشد، بهترین تطابق به شمار می‌آید. برای نمونه، اگر آدرس اجاره \(dq172.16.1.40\(dq باشد و دو دامنهٔ معکوس در کاتالوگ با نام‌های \(dq1.16.172.in\-addr.arpa.\(dq و \(dq16.172.in\-addr.arpa\(dq وجود داشته باشند، مورد اول بهترین تطابق است. همانند تطبیق مستقیم، ممکن است D2 تطابق مناسبی پیدا نکند. با فرض وجود همان دو دامنه، هیچ تطابقی برای آدرس اجارهٔ \(dq192.168.1.50\(dq وجود نخواهد داشت و درخواست رد خواهد شد. همانند تطبیق دامنهٔ مستقیم، اگر هیچ دامنهٔ DDNS معکوسی تعریف نشده باشد، D2 به‌سادگی بخش به‌روزرسانی معکوس درخواست‌ها را نادیده می‌گیرد.
.SS "رفع تعارض (Conflict Resolution)"
.sp
D2 راهبرد رفع تعارض تجویز‌شده توسط RFC 4703 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc4703>\& را پیاده‌سازی می‌کند. هدف از رفع تعارض، جلوگیری از نگاشت هم‌زمان کلاینت‌های مختلف به یک FQDN یکسان است. برای ممکن ساختن این امر، RFC الزامی می‌داند که مدخل‌های DNS مستقیم برای یک FQDN مشخص باید همراه با یک رکورد منبع (RR) از نوع DHCID باشند. این رکورد شامل یک شناسهٔ کلاینت است که کلاینت متعلق به آن نام را به‌صورت یکتا مشخص می‌کند. علاوه بر این، هر به‌روزرسان DNS که بخواهد مدخل‌های مستقیم موجود برای یک FQDN را به‌روزرسانی یا حذف کند، تنها در صورتی مجاز به انجام این کار است که کلاینت آن با رکورد DHCID RR همخوانی داشته باشد.
.sp
به عبارت دیگر، DHCID RR یک FQDN را به کلاینتی که به آن تعلق دارد نگاشت می‌کند و پس از آن، تغییرات در آن نگاشت تنها توسط آن کلاینت یا به درخواست آن امکان‌پذیر است.
.sp
رفع تعارض می‌تواند به‌طور غیرمستقیم از طریق پارامتر پیکربندی \fBddns\-use\-conflict\-resolution\fP که توسط هر دو کارساز \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> و \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6>\& پشتیبانی می‌شود، فعال یا غیرفعال گردد. این کارسازها از این پارامتر برای تنظیم یک پرچم در هر NameChangeRequest ارسالی استفاده می‌کنند که به D2 اعلام می‌کند آیا باید رفع تعارض برای آن درخواست اعمال شود یا خیر. به‌طور پیش‌فرض، رفع تعارض فعال است. برای جزئیات بیشتر، لطفاً به مباحث مربوط به \fBddns\-use\-conflict\-resolution\fP در DDNS for DHCPv4 \%<#\:dhcp4-ddns-config> و DDNS for DHCPv6 \%<#\:dhcp6-ddns-config>\& مراجعه کنید.
.sp
هنگامی که رفع تعارض غیرفعال باشد، D2 همچنان رکوردهای DHCID RR را اضافه می‌کند اما از آن‌ها برای اعمال مالکیت کلاینت بر مدخل‌های DNS استفاده نمی‌کند. غیرفعال کردن آن تنها پس از بررسی دقیق باید انجام شود.
.SS "محیط‌های دو پشته‌ای (Dual\-Stack Environments)"
.sp
بخش ۵.۲ از RFC 4703 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc4703#\:section-5.2> مسائلی را توصیف می‌کند که ممکن است با کلاینت‌های دو پشته‌ای (dual\-stack) رخ دهد. این‌ها کلاینت‌هایی هستند که تمایل دارند هر دو نگاشت IPv4 و IPv6 را برای یک FQDN یکسان داشته باشند. برای عملکرد صحیح، کلاینت‌ها باید DUID مربوط به IPv6 خود را در گزینهٔ شناسهٔ کلاینت IPv4 بگنجانند، همان‌طور که در RFC 4361 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc4361>\& تشریح شده است. بدین ترتیب، به‌روزرسانی‌های DNS هم برای IPv4 و هم برای IPv6 می‌توانند تحت یک رکورد DHCID RR یکسان مدیریت شوند. این ویژگی از نگارش 2.1.2 به بعد در Kea پشتیبانی می‌شود.
.SS "راه‌اندازی و متوقف‌کردن کارساز DHCP\-DDNS (Starting and Stopping the DHCP\-DDNS Server)"
.sp
برنامهٔ \fBkea\-dhcp\-ddns\fP \%<#\:std-iscman-kea-dhcp-ddns> کارساز DHCP\-DDNS در Kea است و با توجه به ماهیت DDNS، در کنار مؤلفهٔ DHCPv4 یا DHCPv6 (یا هر دو) اجرا می‌شود. مانند سایر بخش‌های Kea، این برنامه یک باینری مجزا است که می‌تواند به صورت مستقل یا از طریق \fBkeactrl\fP \%<#\:std-iscman-keactrl> اجرا شود (ببینید Managing Kea with keactrl \%<#\:keactrl>). در حالت عادی، کنترل کردن \fBkea\-dhcp\-ddns\fP \%<#\:std-iscman-kea-dhcp-ddns> با \fBkeactrl\fP \%<#\:std-iscman-keactrl> توصیه می‌شود؛ با این حال، اجرای مستقیم کارساز DHCP\-DDNS نیز امکان‌پذیر است. این برنامه سوئیچ‌های خط فرمان زیر را می‌پذیرد:
.INDENT 0.0
.IP \(bu 2
\fB\-c file\fP \- فایل پیکربندی را مشخص می‌کند. این تنها سوئیچ الزامی است.
.IP \(bu 2
\fB\-d\fP \- مشخص می‌کند که آیا ثبت وقایع (لاگین) کارساز باید به حالت اشکال‌زدایی/پُرگویی (debug/verbose) تغییر کند یا خیر. در حالت پُرگو، سطح اهمیت ثبت وقایع و debuglevel مشخص‌شده در فایل پیکربندی نادیده گرفته می‌شوند و سطح اهمیت \(dqdebug\(dq و حداکثر debuglevel یعنی (99) در نظر گرفته می‌شود. این پرچم برای تغییر موقت کارساز به بیشترین حد پُرگویی، مثلاً هنگام اشکال‌زدایی، مناسب است.
.IP \(bu 2
\fB\-t file\fP \- فایل پیکربندی را برای آزمایش مشخص می‌کند. \fBkea\-dhcp\-ddns\fP \%<#\:std-iscman-kea-dhcp-ddns> تلاش می‌کند آن را بارگذاری کرده و بررسی‌های سلامت را انجام دهد. برخی بررسی‌ها تنها هنگام اجرای کارساز واقعی امکان‌پذیر است. وضعیت واقعی با یک کد خروج گزارش می‌شود (0 = پیکربندی مناسب به نظر می‌رسد، 1 = خطا رخ داده است). هنگام آزمایش پیکربندی، Kea پیام‌های لاگ را در خروجی استاندارد و خطاها را در خطای استاندارد چاپ می‌کند.
.IP \(bu 2
\fB\-v\fP \- نگارش Kea را نمایش داده و خارج می‌شود.
.IP \(bu 2
\fB\-V\fP \- نگارش تفصیلی Kea را نمایش داده و خارج می‌شود.
.IP \(bu 2
\fB\-W\fP \- گزارش پیکربندی Kea را نمایش داده و خارج می‌شود. این گزارش رونوشتی از فایل \fBconfig.report\fP تولیدشده توسط \fBmeson setup\fP است؛ این گزارش درون باینری اجرایی جاسازی شده است.
.sp
محتویات فایل \fBconfig.report\fP همچنین از طریق بررسی کتابخانه‌های خاصی در درخت نصب یا در درخت سورس قابل دسترسی است.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
# from installation using libkea\-process.so
$ strings ${prefix}/lib/libkea\-process.so | sed \-n \(aqs/;;;; //p\(aq

# from sources using libkea\-process.so
$ strings src/lib/process/.libs/libkea\-process.so | sed \-n \(aqs/;;;; //p\(aq

# from sources using libkea\-process.a
$ strings src/lib/process/.libs/libkea\-process.a | sed \-n \(aqs/;;;; //p\(aq

# from sources using libcfgrpt.a
$ strings src/lib/process/cfgrpt/.libs/libcfgrpt.a | sed \-n \(aqs/;;;; //p\(aq
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
\fB\-X\fP \- از نسخهٔ Kea 3.0، محدودیت‌های امنیتی را غیرفعال می‌کند. کارساز همچنان نقض‌ها را بررسی می‌کند اما به جای شکست همراه با خطا، هنگام یافتن آن‌ها پیام‌های هشدار ثبت خواهد کرد. لطفاً برای جزئیات به Kea Runtime Security Policy Checking \%<#\:sec-kea-runtime-security-policy-checking> مراجعه کنید.
.UNINDENT
.sp
پس از راه‌اندازی، ماژول پیکربندی خود را بارگذاری کرده و بر اساس آن پیکربندی، گوش‌دادن به NCRها را آغاز می‌کند.
.sp
در حین راه‌اندازی، کارساز تلاش می‌کند یک فایل PID به این شکل ایجاد کند: \fB[pidfile_dir]/[conf name].kea\-dhcp\-ddns.pid\fP که در آن:
.INDENT 0.0
.IP \(bu 2
\fBpidfile_dir\fP \- برابر است با \fB[prefix]/[localstatedir]/run/kea\fP که در آن \fBprefix\fP و \fBlocalstatedir\fP مقادیری هستند که با استفاده از \fB\-\-prefix\fP و \fB\-\-localstatedir\fP به meson setup ارسال شده‌اند و به‌ترتیب به‌طور پیش‌فرض \fB/usr/local\fP و \fBvar\fP می‌باشند. بنابراین کل مسیر \fBpidfile_dir\fP به‌طور پیش‌فرض \fB/usr/local/var\fP است. توجه داشته باشید که این مقدار ممکن است در زمان اجرا با تنظیم متغیر محیطی \fBKEA_PIDFILE_DIR\fP که در درجهٔ اول برای اهداف آزمایشی در نظر گرفته شده است، بازنویسی شود.
.IP \(bu 2
\fBconf name\fP \- نام فایل پیکربندی استفاده‌شده برای راه‌اندازی کارساز است، منهای تمام مسیرهای پیش از آن و پسوند فایل. برای مثال، با داشتن مسیر \fB/usr/local/etc/kea/myconf.txt\fP، بخش مورداستفاده \fBmyconf\fP خواهد بود.
.UNINDENT
.sp
اگر فایل از قبل موجود باشد و حاوی PID یک فرایند زنده باشد، کارساز پیام ثبت وقایع \fBDHCP_DDNS_ALREADY_RUNNING\fP را صادر کرده و خارج می‌شود. این احتمال وجود دارد (هرچند بعید) که این فایل بازماندهٔ یک فروپاشی سیستم باشد و فرایندی که PID متعلق به آن است به Kea نامربوط باشد. در چنین حالتی، حذف دستی فایل PID ضروری است..SS پیکربندی کارگزار DHCP\-DDNS
.sp
پیش از راه‌اندازی ماژول \fBkea\-dhcp\-ddns\fP \%<#\:std-iscman-kea-dhcp-ddns> برای نخستین بار، باید یک فایل پیکربندی ایجاد شود. پیکربندی پیش‌فرض زیر قالبی است که می‌تواند بر اساس نیازهای اختصاصی سفارشی‌سازی شود.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcpDdns\(dq: {
    \(dqip\-address\(dq: \(dq127.0.0.1\(dq,
    \(dqport\(dq: 53001,
    \(dqdns\-server\-timeout\(dq: 500,
    \(dqncr\-protocol\(dq: \(dqUDP\(dq,
    \(dqncr\-format\(dq: \(dqJSON\(dq,
    \(dqtsig\-keys\(dq: [ ],
    \(dqforward\-ddns\(dq: {
        \(dqddns\-domains\(dq: [ ]
    },
    \(dqreverse\-ddns\(dq: {
        \(dqddns\-domains\(dq: [ ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پیکربندی را می‌توان به بخش‌های زیر تقسیم کرد که هر یک در ادامه توضیح داده شده‌اند:
.INDENT 0.0
.IP \(bu 2
\fIپارامترهای سراسری کارگزار (Global Server Parameters)\fP \- مقادیری را تعریف می‌کند که برقراری ارتباط و رفتار سراسری کارگزار را کنترل می‌کنند.
.IP \(bu 2
\fIسوکت‌های کنترلی (Control Sockets)\fP \- فهرست سوکت‌های کنترلی را تعریف می‌کند.
.IP \(bu 2
\fIاطلاعات کلید TSIG (TSIG Key Info)\fP \- کلیدهای TSIG مورد استفاده برای تبادل امن داده با کارگزارهای DNS را تعریف می‌کند.
.IP \(bu 2
\fIDDNS مستقیم (Forward DDNS)\fP \- فهرست دامنه‌های DDNS مستقیم را تعریف می‌کند.
.IP \(bu 2
\fIDDNS معکوس (Reverse DDNS)\fP \- فهرست دامنه‌های DDNS معکوس را تعریف می‌کند.
.UNINDENT
.SS پارامترهای سراسری کارگزار (Global Server Parameters)
.INDENT 0.0
.IP \(bu 2
\fBip\-address\fP \- نشانی IP که D2 روی آن به درخواست‌ها گوش می‌دهد. مقدار پیش‌فرض، رابط محلی loopback روی نشانی 127.0.0.1 است. می‌توان یک نشانی IPv4 یا IPv6 تعیین کرد.
.IP \(bu 2
\fBport\fP \- درگاهی (port) که D2 روی آن به درخواست‌ها گوش می‌دهد. مقدار پیش‌فرض 53001 است.
.IP \(bu 2
\fBdns\-server\-timeout\fP \- حداکثر زمانی (بر حسب میلی‌ثانیه) که D2 برای دریافت پاسخ از کارگزار DNS برای یک پیام به‌روزرسانی منفرد DNS منتظر می‌ماند. مقدار پیش‌فرض 500 میلی‌ثانیه است.
.IP \(bu 2
\fBncr\-protocol\fP \- پروتکل سوکت مورد استفاده هنگام ارسال درخواست‌ها به D2. در حال حاضر فقط UDP پشتیبانی می‌شود.
.IP \(bu 2
\fBncr\-format\fP \- قالب بسته مورد استفاده هنگام ارسال درخواست‌ها به D2. در حال حاضر فقط قالب JSON پشتیبانی می‌شود.
.UNINDENT
.sp
D2 باید روی یک نشانی و درگاه مشخص به درخواست‌های تغییر گوش دهد. به‌طور پیش‌فرض، روی 127.0.0.1 و درگاه 53001 گوش می‌دهد. مثال زیر نشان می‌دهد که چگونه می‌توان پارامترهای سراسری D2 را تغییر داد تا روی 192.168.1.10 و درگاه 900 گوش دهد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcpDdns\(dq: {
    \(dqip\-address\(dq: \(dq192.168.1.10\(dq,
    \(dqport\(dq: 900,
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
\fBهشدار:\fP
.INDENT 0.0
.INDENT 3.5
این امکان وجود دارد که یک مهاجم مخرب درخواست‌های جعلی NameChangeRequests را به کارگزار DHCP\-DDNS ارسال کند. نشانی‌هایی غیر از نشانی‌های loopback در IPv4 یا IPv6 (یعنی 127.0.0.1 یا ::1) باید صرفاً برای مقاصد آزمایشی استفاده شوند؛ توجه داشته باشید که کاربران محلی همچنان می‌توانند با کارگزار DHCP\-DDNS ارتباط برقرار کنند.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
اگر \fBip\-address\fP و \fBport\fP تغییر کنند، مقادیر متناظر در بخش پیکربندی \fBdhcp\-ddns\fP در کارگزارهای DHCP نیز باید تغییر یابند.
.UNINDENT
.UNINDENT
.SS رابط برنامه‌نویسی مدیریت (Management API) برای کارگزار D2
.sp
رابط برنامه‌نویسی مدیریت امکان صدور دستورهای مدیریتی مشخص، مانند بازخوانی پیکربندی یا خاموش کردن را فراهم می‌کند. برای جزئیات بیشتر، Management API \%<#\:ctrl-channel>\& را ببینید. به‌طور پیش‌فرض هیچ سوکتی باز نیست؛ برای این‌که به Kea دستور دهید سوکتی را باز کند، می‌توان از مدخل زیر در فایل پیکربندی استفاده کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcpDdns\(dq: {
    \(dqcontrol\-sockets\(dq: [
        {
            \(dqsocket\-type\(dq: \(dqunix\(dq,
            \(dqsocket\-name\(dq: \(dq/path/to/the/unix/socket\(dq
        }
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT.SS سوکت کنترلی UNIX
.sp
تا قبل از سرور Kea نسخهٔ 2.7.2، تنها نوع کانال ارتباطی پشتیبانی‌شده سوکت جریان UNIX با مقداردهی \fBsocket\-type\fP به \fBunix\fP و \fBsocket\-name\fP به مسیر فایل سوکت UNIX/LOCAL بود.
.sp
طول مسیر مشخص‌شده توسط پارامتر \fBsocket\-name\fP به حداکثر طول مجاز برای نام سوکت UNIX در سیستم‌عامل، یعنی اندازهٔ فیلد \fBsun_path\fP در ساختار \fBsockaddr_un\fP منهای ۱، محدود است. این مقدار در سیستم‌عامل‌های مختلف بین ۹۱ تا ۱۰۷ نویسه متغیر است. مقادیر معمول ۱۰۷ در Linux و ۱۰۳ در FreeBSD هستند.
.sp
نرم‌افزار Kea تنها از یک سوکت کنترلی \fBunix\fP در فهرست \(dqcontrol\-sockets\(dq پشتیبانی می‌کند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
از نسخهٔ 2.7.9 در Kea، سوکت‌های کنترلی فقط می‌توانند در دایرکتوری تعیین‌شده در زمان کامپایل یعنی \fB\(dq[kea\-install\-dir]/var/run/kea\(dq\fP قرار گیرند که این مسیر نیز باید دارای مجوزهای دسترسی \fB0750\fP باشد. این مسیر را می‌توان هنگام راه‌اندازی با تنظیم متغیر محیطی \fBKEA_CONTROL_SOCKET_DIR\fP به مسیر دلخواه بازنویسی (override) کرد. اگر مسیری غیر از این مقدار در \fBsocket\-name\fP استفاده شود، Kea خطایی صادر کرده و از شروع به کار امتناع می‌کند، یا در صورت در حال اجرا بودن، یک خطای غیرقابل‌بازیابی را ثبت می‌کند. برای سهولت در استفاده، کافی است بخش مسیر را از \fBsocket\-name\fP حذف کنید\&.
.UNINDENT
.UNINDENT
.sp
ارتباط از طریق کانال کنترلی با استفاده از ساختارهای JSON انجام می‌شود. برای جزئیات بیشتر به بخش Control Channel در Kea Developer\(aqs Guide \%<https://\:reports\:.kea\:.isc\:.org/\:dev_guide/\:d2/\:d96/\:ctrlSocket\:.html> مراجعه کنید.
.sp
سرور D2 از دستورهای عملیاتی زیر پشتیبانی می‌کند:
.INDENT 0.0
.IP \(bu 2
\fBbuild\-report\fP \%<#\:std-isccmd-build-report>
.IP \(bu 2
\fBconfig\-get\fP \%<#\:std-isccmd-config-get>
.IP \(bu 2
\fBconfig\-hash\-get\fP \%<#\:std-isccmd-config-hash-get>
.IP \(bu 2
\fBconfig\-reload\fP \%<#\:std-isccmd-config-reload>
.IP \(bu 2
\fBconfig\-set\fP \%<#\:std-isccmd-config-set>
.IP \(bu 2
\fBconfig\-test\fP \%<#\:std-isccmd-config-test>
.IP \(bu 2
\fBconfig\-write\fP \%<#\:std-isccmd-config-write>
.IP \(bu 2
\fBlist\-commands\fP \%<#\:std-isccmd-list-commands>
.IP \(bu 2
\fBshutdown\fP \%<#\:std-isccmd-shutdown>
.IP \(bu 2
\fBstatus\-get\fP \%<#\:std-isccmd-status-get>
.IP \(bu 2
\fBversion\-get\fP \%<#\:std-isccmd-version-get>
.UNINDENT
.sp
از نسخهٔ 2.0.0 در Kea، سرور D2 از دستورهای عملیاتی زیر نیز برای آمار پشتیبانی می‌کند:
.INDENT 0.0
.IP \(bu 2
\fBstatistic\-get\fP \%<#\:std-isccmd-statistic-get>
.IP \(bu 2
\fBstatistic\-get\fP \%<#\:std-isccmd-statistic-get>\-all
.IP \(bu 2
\fBstatistic\-reset\fP \%<#\:std-isccmd-statistic-reset>
.IP \(bu 2
\fBstatistic\-reset\fP \%<#\:std-isccmd-statistic-reset>\-all
.UNINDENT
.sp
دستور \fBshutdown\fP \%<#\:std-isccmd-shutdown> از آرگومان اضافی \fBtype\fP پشتیبانی می‌کند که نحوهٔ پاک‌سازی سرور D2 هنگام خروج را کنترل می‌کند. انواع خاموش‌سازی پشتیبانی‌شده عبارتند از:
.INDENT 0.0
.IP \(bu 2
\fBnormal\fP \- مدیر صف را متوقف کرده و قبل از خروج، تمام تراکنش‌های جاری را به پایان می‌رساند. این مقدار پیش‌فرض است.
.IP \(bu 2
\fBdrain_first\fP \- مدیر صف را متوقف می‌کند، اما به پردازش درخواست‌ها از صف تا خالی شدن آن ادامه می‌دهد.
.IP \(bu 2
\fBnow\fP \- بلافاصله خارج می‌شود.
.UNINDENT
.sp
یک دستور نمونه می‌تواند به این صورت باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqshutdown\(dq,
    \(dqarguments\(dq: {
        \(dqexit\-value\(dq: 3,
        \(dqtype\(dq: \(dqdrain_first\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.SS سوکت کنترلی HTTP/HTTPS
.sp
مقدار \fBsocket\-type\fP باید \fBhttp\fP یا \fBhttps\fP باشد (هنگامی که نوع آن \fBhttps\fP باشد، TLS الزامی است). پارامترهای \fBsocket\-address\fP (پیش‌فرض \fB127.0.0.1\fP) و \fBsocket\-port\fP (پیش‌فرض 8000) آدرس IP و درگاهی را مشخص می‌کنند که سرویس HTTP به آن متصل (bind) خواهد شد.
.sp
پارامترهای \fBtrust\-anchor\fP، \fBcert\-file\fP، \fBkey\-file\fP و \fBcert\-required\fP پیکربندی TLS را برای HTTP، یعنی HTTPS، مشخص می‌کنند. اگر این پارامترها مشخص نشوند، از HTTP استفاده می‌شود. پشتیبانی از TLS/HTTPS در Kea در بخش TLS/HTTPS Support \%<#\:tls>\& شرح داده شده است.
.sp
احراز هویت پایه HTTP (Basic HTTP authentication) از سرور در برابر استفاده‌های غیرمجاز توسط کاربران محلی محافظت می‌کند. برای محافظت در برابر مهاجمان از راه دور، HTTPS و پراکسی معکوس (reverse proxy) امنیت قوی‌تری فراهم می‌کنند.
.sp
احراز هویت در بلوک \fBauthentication\fP همراه با پارامتر اجباری \fBtype\fP شرح داده می‌شود که روش احراز هویت را تعیین می‌کند. در حال حاضر تنها احراز هویت پایه HTTP (نوع basic) پشتیبانی می‌شود.
.sp
پارامتر احراز هویت \fBrealm\fP (پیش‌فرض \fBkea\-dhcp\-ddns\-server\fP) برای پیام‌های خطا در شرایطی استفاده می‌شود که احراز هویت پایه HTTP الزامی است اما کلاینت مجاز شناخته نشده است.
.sp
هنگامی که فهرست احراز هویت \fBclients\fP پیکربندی شده و خالی نباشد، احراز هویت پایه HTTP الزامی است. هر عنصر از فهرست، یک شناسه کاربری و یک گذرواژه را مشخص می‌کند. شناسه کاربری الزامی است، نباید خالی باشد و نباید حاوی نویسهٔ دونقطه (:) باشد. گذرواژه اختیاری است؛ در صورت عدم تعیین، گذرواژهٔ خالی استفاده می‌شود.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
شناسه کاربری و گذرواژه در احراز هویت پایه HTTP با استاندارد UTF\-8 کدگذاری می‌شوند، اما نحو JSON کنونی Kea تنها از زیرمجموعه یونیکد Latin\-1 (یعنی 0x00..0xff) پشتیبانی می‌کند.
.UNINDENT
.UNINDENT
.sp
برای جلوگیری از افشای شناسه کاربری و/یا گذرواژه مرتبط، می‌توان این مقادیر را از فایل‌ها خواند. نحو دستورها با موارد زیر گسترش یافته است:
.INDENT 0.0
.IP \(bu 2
پارامتر احراز هویت \fBdirectory\fP، که بخش مشترک مسیرهای فایل را مدیریت می‌کند. مقدار پیش‌فرض آن یک رشتهٔ خالی است.
.IP \(bu 2
پارامتر کلاینت \fBpassword\-file\fP، که همراه با پارامتر \fBdirectory\fP، مسیر فایلی را مشخص می‌کند که می‌تواند حاوی گذرواژه باشد، یا در صورتی که هیچ شناسه کاربری داده نشده باشد، کل راز احراز هویت پایه HTTP را در بر گیرد.
.IP \(bu 2
پارامتر کلاینت \fBuser\-file\fP، که همراه با پارامتر \fBdirectory\fP، مسیر فایلی را مشخص می‌کند که شناسه کاربری از آن خوانده می‌شود.
.UNINDENT
.sp
از نسخهٔ 2.7.6 در Kea، از چندین اتصال HTTP/HTTPS پشتیبانی می‌شود. هر دو نوع آدرس IPv4 و IPv6 قابل استفاده هستند. سرور در صورت تغییر نوع سوکت از HTTP به HTTPS یا از HTTPS به HTTP با استفاده از همان آدرس و درگاه، خطایی صادر خواهد کرد. این عمل مجاز نیست زیرا ممکن است موجب بروز یک مشکل امنیتی تصادفی ناشی از اشتباه کاربر شود. هنگام استفاده از دستور \(dqconfig\-set\(dq برای تغییر از HTTP به HTTPS یا از HTTPS به HTTP، باید آدرس یا درگاه متفاوتی مشخص شود. همین موضوع هنگام تغییر فایل پیکربندی و سپس اجرای دستور \(dqconfig\-reload\(dq نیز صدق می‌کند.
.sp
هنگامی که از فایل‌ها استفاده می‌شود، آن‌ها در زمان بارگذاری پیکربندی خوانده می‌شوند تا خطاهای پیکربندی در سریع‌ترین زمان ممکن شناسایی شوند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcpDdns\(dq: {
    \(dqcontrol\-sockets\(dq: [
        {
            \(dqsocket\-type\(dq: \(dqhttps\(dq,
            \(dqsocket\-address\(dq: \(dq10.20.30.40\(dq,
            \(dqsocket\-port\(dq: 8005,
            \(dqtrust\-anchor\(dq: \(dq/path/to/the/ca\-cert.pem\(dq,
            \(dqcert\-file\(dq: \(dq/path/to/the/agent\-cert.pem\(dq,
            \(dqkey\-file\(dq: \(dq/path/to/the/agent\-key.pem\(dq,
            \(dqcert\-required\(dq: true,
            \(dqauthentication\(dq: {
                \(dqtype\(dq: \(dqbasic\(dq,
                \(dqrealm\(dq: \(dqkea\-dhcp\-ddns\-server\(dq,
                \(dqclients\(dq: [
                {
                    \(dquser\(dq: \(dqadmin\(dq,
                    \(dqpassword\(dq: \(dq1234\(dq
                } ]
            }
        },
        {
            \(dqsocket\-type\(dq: \(dqhttp\(dq,
            \(dqsocket\-address\(dq: \(dq2010:30:40::50\(dq,
            \(dqsocket\-port\(dq: 8004
        }
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT.SS فهرست کلیدهای TSIG (TSIG Key List)
.sp
یک تبادل در پروتکل DDNS می‌تواند با یا بدون امضای تراکنش یا TSIG (تعریف‌شده
در RFC 2845 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc2845>) انجام شود. این
بخش از پیکربندی به مدیر سیستم امکان می‌دهد مجموعه‌ای از کلیدهای TSIG را
که ممکن است در چنین تبادلاتی استفاده شوند، تعریف کند.
.sp
برای استفاده از TSIG هنگام به‌روزرسانی مدخل‌ها در یک دامنهٔ DNS، باید یک کلید
در فهرست کلیدهای TSIG تعریف شده و با نام در مدخل پیکربندی آن دامنه به آن
ارجاع داده شود. هنگامی که D2 یک درخواست تغییر را با یک دامنه مطابقت می‌دهد،
بررسی می‌کند که آیا آن دامنه کلید TSIG مرتبطی دارد یا خیر. در صورت وجود، D2
از آن کلید برای امضای پیام‌های به‌روزرسانی DNS ارسالی به سرور(های) DNS دامنه
و اعتبارسنجی پاسخ‌های دریافتی از آن‌ها استفاده می‌کند. به ازای هر کلید TSIG مورد نیاز
سرورهای DNS که D2 با آن‌ها کار می‌کند، باید یک کلید TSIG متناظر در فهرست
کلیدهای TSIG وجود داشته باشد.
.sp
همان‌طور که ممکن است از نام آن مشخص باشد، بخش \fBtsig\-key\fP در پیکربندی D2
کلیدهای TSIG را فهرست می‌کند. هر مدخل، یک کلید TSIG را توصیف می‌کند که توسط
یک یا چند سرور DNS برای احراز هویت درخواست‌ها و امضای پاسخ‌ها استفاده می‌شود.
هر مدخل در این فهرست سه پارامتر دارد:
.INDENT 0.0
.IP \(bu 2
\fBname\fP \- یک برچسب متنی یکتا است که برای شناسایی این کلید در فهرست استفاده
می‌شود. این مقدار مشخص می‌کند که هنگام به‌روزرسانی یک دامنهٔ خاص، باید از کدام
کلید (در صورت وجود) استفاده شود. تا زمانی که این نام یکتا باشد محتوای آن اختیاری
است، اگرچه برای وضوح و سهولت در نگهداری توصیه می‌شود که با نام استفاده‌شده در
سرور(های) DNS مطابقت داشته باشد. این فیلد نمی‌تواند خالی باشد.
.IP \(bu 2
\fBalgorithm\fP \- مشخص می‌کند که کدام الگوریتم درهم‌سازی (هش) باید با این کلید
استفاده شود. این مقدار باید همان الگوریتمی را مشخص کند که برای کلید در
سرور(های) DNS به کار رفته است. الگوریتم‌های پشتیبانی‌شده در زیر فهرست شده‌اند:
.INDENT 2.0
.IP \(bu 2
HMAC\-MD5
.IP \(bu 2
HMAC\-SHA1
.IP \(bu 2
HMAC\-SHA224
.IP \(bu 2
HMAC\-SHA256
.IP \(bu 2
HMAC\-SHA384
.IP \(bu 2
HMAC\-SHA512
.UNINDENT
.sp
این مقدار به حروف بزرگ و کوچک حساس نیست.
.IP \(bu 2
\fBdigest\-bits\fP \- برای تعیین حداقل طول خلاصه‌سازی‌شده بر حسب بیت استفاده می‌شود.
مقدار پیش‌فرض 0 به این معنی است که کوتاه‌سازی ممنوع است؛ مقادیر غیرصفر باید یک عدد
صحیح از هشت‌بیت‌ها (اکتت‌ها) بوده و هم از 80 و هم از نصف طول کامل بزرگ‌تر باشند.
(توجه داشته باشید که در BIND 9 این پارامتر بعد از یک خط تیره به انتهای نام الگوریتم اضافه می‌شود.)
.IP \(bu 2
\fBsecret\fP \- برای تعیین کد کلید مخفی مشترک (shared secret) برای این کلید
استفاده می‌شود. این مقدار به حروف بزرگ و کوچک حساس است و باید دقیقاً با مقدار
مشخص‌شده در سرور(های) DNS مطابقت داشته باشد. این مقدار یک متن کدگذاری‌شده با base64 است.
.IP \(bu 2
\fBsecret\-file\fP \- از نسخهٔ Kea 2.5.8، این جایگزین امن‌تر پشتیبانی می‌شود.
این مقدار نام فایلی را مشخص می‌کند که کلید مخفی در آن قرار دارد، به این معنی که کلید
مخفیِ کدگذاری‌شده با base64 محتوای فایل است.
.UNINDENT
.sp
به عنوان مثال، فرض کنید دامنه‌ای که D2 به‌روزرسانی خواهد کرد توسط یک سرور DNS از نوع BIND 9
نگهداری می‌شود که نیاز دارد به‌روزرسانی‌های پویا با TSIG امن شوند. همچنین فرض کنید مدخل مربوط
به کلید TSIG در فایل named.conf سرور BIND 9 به این شکل است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
:
key \(dqkey.four.example.com.\(dq {
    algorithm hmac\-sha224;
    secret \(dqbZEG7Ow8OgAUPfLWV3aAUQ==\(dq;
};
:
.EE
.UNINDENT
.UNINDENT
.sp
به‌طور پیش‌فرض، فهرست کلیدهای TSIG خالی است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcpDdns\(dq: {
   \(dqtsig\-keys\(dq: [ ],
   ...
}
.EE
.UNINDENT
.UNINDENT
.sp
یک کلید جدید باید به فهرست اضافه شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcpDdns\(dq: {
    \(dqtsig\-keys\(dq: [
        {
            \(dqname\(dq: \(dqkey.four.example.com.\(dq,
            \(dqalgorithm\(dq: \(dqHMAC\-SHA224\(dq,
            \(dqsecret\(dq: \(dqbZEG7Ow8OgAUPfLWV3aAUQ==\(dq
        }
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
این مراحل باید برای هر کلید TSIG مورد نیاز تکرار شوند، هرچند یک کلید TSIG
یکسان می‌تواند برای بیش از یک دامنه استفاده شود.
.SS DDNS مستقیم (Forward DDNS)
.sp
بخش forward DDNS برای پیکربندی رفتار به‌روزرسانی مستقیم (forward\-update) در D2
استفاده می‌شود. در حال حاضر این بخش شامل یک پارامتر واحد است: کاتالوگ دامنه‌های
forward DDNS، که فهرستی از ساختارها است.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcpDdns\(dq: {
    \(dqforward\-ddns\(dq: {
        \(dqddns\-domains\(dq: [ ]
    },
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
به‌طور پیش‌فرض، این فهرست خالی است که موجب می‌شود سرور بخش‌های مربوط
به به‌روزرسانی مستقیم در درخواست‌ها را نادیده بگیرد..SS افزودن دامنه‌های DDNS مستقیم
.sp
یک دامنهٔ DDNS مستقیم، یک ناحیهٔ (zone) مستقیم DNS را به مجموعه‌ای از سرورهای DNS نگاشت می‌کند که داده‌های مستقیم DNS (یعنی نگاشت نام به آدرس) را برای آن ناحیه نگهداری می‌کنند. هر ناحیهٔ ارائه‌شده به یک دامنهٔ DDNS مستقیم نیاز دارد. ممکن است برخی یا همهٔ ناحیه‌ها توسط سرورهای یکسانی نگهداری شوند، اما همچنان برای هر ناحیه به یک دامنهٔ DDNS نیاز است. به یاد داشته باشید که تطبیق یک درخواست با سرور(های) مناسب بر اساس ناحیه انجام می‌شود و یک دامنهٔ DDNS تنها یک ناحیه را تعریف می‌کند.
.sp
این بخش نحوهٔ افزودن دامنه‌های DDNS مستقیم را شرح می‌دهد؛ این مراحل را برای هر دامنهٔ DDNS مستقیمِ موردنظر تکرار کنید. هر دامنهٔ DDNS مستقیم دارای پارامترهای زیر است:
.INDENT 0.0
.IP \(bu 2
\fBname\fP \- این نام دامنهٔ کاملاً مشخص (یا ناحیه) است که این دامنهٔ DDNS می‌تواند آن را به‌روزرسانی کند. این مقدار هنگام تطبیق مستقیم با FQDN درخواست مقایسه می‌شود. این مقدار باید در کاتالوگ (catalog) یکتا باشد.
.IP \(bu 2
\fBkey\-name\fP \- اگر از TSIG همراه با سرورهای این دامنه استفاده می‌شود، این مقدار باید نام کلید از فهرست کلیدهای TSIG باشد. اگر مقدار خالی باشد (پیش‌فرض)، از TSIG در تبادلات DDNS با سرورهای این دامنه استفاده نخواهد شد.
.IP \(bu 2
\fBdns\-servers\fP \- فهرستی از یک یا چند سرور DNS است که می‌توانند سمتِ سرورِ پروتکل DDNS را برای این دامنه اداره کنند. سرورها به ترتیب اولویت از نخستین تا آخرین استفاده می‌شوند؛ به عبارت دیگر، هنگامی که D2 پردازش یک درخواست را برای این دامنه آغاز می‌کند، نخستین سرور در این فهرست را انتخاب کرده و تلاش می‌کند با آن ارتباط برقرار کند. اگر آن تلاش ناموفق باشد، D2 به سراغ سرور بعدی در فهرست می‌رود و به همین ترتیب، تا زمانی که یا عملیات موفقیت‌آمیز باشد یا فهرست به پایان برسد.
.UNINDENT
.sp
برای ایجاد یک دامنهٔ DDNS مستقیم جدید، یک عنصر دامنهٔ جدید اضافه کرده و پارامترهای آن را تنظیم کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcpDdns\(dq: {
    \(dqforward\-ddns\(dq: {
        \(dqddns\-domains\(dq: [
            {
                \(dqname\(dq: \(dqother.example.com.\(dq,
                \(dqkey\-name\(dq: \(dq\(dq,
                \(dqdns\-servers\(dq: [
                ]
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
امکان افزودن یک دامنه بدون هیچ سروری وجود دارد؛ با این حال، اگر آن دامنه با درخواستی تطبیق یابد، درخواست با شکست مواجه می‌شود. برای اینکه دامنه کاربردی باشد، باید دست‌کم یک سرور DNS به آن اضافه شود.
.SS افزودن سرورهای مستقیم DNS
.sp
این بخش نحوهٔ افزودن سرورهای DNS به یک دامنهٔ DDNS مستقیم را شرح می‌دهد. این دستورالعمل‌ها را برحسب نیاز برای تمام سرورهای هر دامنه تکرار کنید.
.sp
مدخل‌های سرور مستقیم DNS نمایانگر سرورهای واقعی DNS هستند که از سمت سرور پروتکل DDNS پشتیبانی می‌کنند. هر سرور مستقیم DNS دارای پارامترهای زیر است:
.INDENT 0.0
.IP \(bu 2
\fBhostname\fP \- نام میزبان قابل‌حلِ (resolvable) سرور DNS؛ این پارامتر هنوز پیاده‌سازی نشده است.
.IP \(bu 2
\fBip\-address\fP \- آدرس IP که سرور روی آن به درخواست‌های DDNS گوش می‌دهد. این آدرس می‌تواند یک آدرس IPv4 یا IPv6 باشد.
.IP \(bu 2
\fBport\fP \- پورتی که سرور روی آن به درخواست‌های DDNS گوش می‌دهد. مقدار پیش‌فرض آن پورت استاندارد سرویس DNS یعنی 53 است.
.UNINDENT
.sp
برای ایجاد یک سرور مستقیم DNS جدید، باید یک عنصر سرور جدید به دامنه اضافه شده و پارامترهای آن تکمیل شود. به عنوان مثال، اگر سرویس روی \(dq172.88.99.10\(dq در حال اجرا باشد، سرور مستقیم DNS را به صورت زیر تنظیم کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcpDdns\(dq: {
    \(dqforward\-ddns\(dq: {
        \(dqddns\-domains\(dq: [
            {
                \(dqname\(dq: \(dqother.example.com.\(dq,
                \(dqkey\-name\(dq: \(dq\(dq,
                \(dqdns\-servers\(dq: [
                    {
                        \(dqip\-address\(dq: \(dq172.88.99.10\(dq,
                        \(dqport\(dq: 53
                    }
                ]
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
از آنجا که \fBhostname\fP هنوز پشتیبانی نمی‌شود، پارامتر \fBip\-address\fP باید روی آدرس سرور DNS تنظیم شود.
.UNINDENT
.UNINDENT
.SS DDNS معکوس
.sp
بخش DDNS معکوس برای پیکربندی رفتار به‌روزرسانی معکوس D2 به کار می‌رود و مفاهیم آن مشابه بخش DDNS مستقیم است. در حال حاضر این بخش شامل یک پارامتر منفرد، یعنی کاتالوگ (catalog) دامنه‌های DDNS معکوس است که فهرستی از ساختارها می‌باشد.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcpDdns\(dq: {
    \(dqreverse\-ddns\(dq: {
        \(dqddns\-domains\(dq: [ ]
    },
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
به‌طور پیش‌فرض، این فهرست خالی است که باعث می‌شود سرور بخش‌های به‌روزرسانی معکوس در درخواست‌ها را نادیده بگیرد..SS افزودن دامنه‌های DDNS معکوس
.sp
یک دامنهٔ DDNS معکوس، یک زون معکوس DNS را به مجموعه‌ای از کارگزارهای DNS که داده‌های معکوس DNS (نگاشت نشانی به نام) را برای آن زون نگهداری می‌کنند، نگاشت می‌نماید. هر زون سرویس‌دهی‌شده به یک دامنهٔ DDNS معکوس نیاز دارد.
ممکن است برخی یا همهٔ زون‌ها توسط کارگزارهای یکسانی نگهداری شوند، اما برای هر زون به یک مدخل دامنهٔ DDNS نیاز است. به یاد داشته باشید که تطبیق یک درخواست با کارگزار(های) مناسب بر پایهٔ زون انجام می‌شود و هر دامنهٔ DDNS تنها یک زون منفرد را تعریف می‌کند.
.sp
این بخش نحوهٔ افزودن دامنه‌های DDNS معکوس را شرح می‌دهد؛ این مراحل را برای هر دامنهٔ DDNS معکوس دلخواه تکرار کنید. هر دامنهٔ DDNS معکوس دارای پارامترهای زیر است:
.INDENT 0.0
.IP \(bu 2
\fBname\fP \- این زون معکوس کاملاً واجد شرایط (FQDN) است که این دامنهٔ DDNS می‌تواند آن را به‌روزرسانی کند. این همان مقداری است که در طول تطبیق معکوس استفاده می‌شود و با نسخهٔ معکوس‌شدهٔ نشانی واگذاری (lease address) درخواست مقایسه می‌گردد. نام زون باید از استانداردهای مربوطه پیروی کند؛ برای مثال، جهت پشتیبانی از زیرشبکهٔ IPv4 به‌صورت 172.16.1، نام باید
\(dq1.16.172.in\-addr.arpa.\(dq باشد. به همین ترتیب، برای پشتیبانی از یک زیرشبکهٔ IPv6 مانند
2001:db8:1، نام باید \(dq1.0.0.0.8.B.D.0.1.0.0.2.ip6.arpa.\(dq باشد.
این نام باید در سرتاسر کاتالوگ یکتا باشد.
.IP \(bu 2
\fBkey\-name\fP \- اگر در ارتباط با کارگزارهای این دامنه از TSIG استفاده می‌شود،
این مقدار باید نام کلید از فهرست کلیدهای TSIG باشد. اگر
مقدار خالی باشد (پیش‌فرض)، در تبادلات DDNS با کارگزارهای این دامنه از TSIG استفاده نخواهد شد.
.IP \(bu 2
\fBdns\-servers\fP \- فهرستی از یک یا چند کارگزار DNS است که می‌توانند
سمت سرور پروتکل DDNS را برای این دامنه اجرا کنند. در حال حاضر،
کارگزارها با اولویت نخستین به آخرین استفاده می‌شوند؛ به عبارت دیگر، هنگامی که
D2 پردازش درخواستی را برای این دامنه آغاز می‌کند، نخستین
کارگزار این فهرست را برمی‌گزیند و برای برقراری ارتباط با آن تلاش می‌کند. اگر آن
تلاش ناموفق باشد، D2 به سراغ کارگزار بعدی در فهرست می‌رود و به همین ترتیب،
تا زمانی که عملیات با موفقیت انجام شود یا فهرست به پایان برسد.
.UNINDENT
.sp
برای ایجاد یک دامنهٔ DDNS معکوس جدید، باید یک عنصر دامنهٔ جدید اضافه شده
و پارامترهای آن مقداردهی گردند. برای نمونه، برای پشتیبانی از زیرشبکهٔ 2001:db8:1::،
می‌توان از پیکربندی زیر استفاده کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcpDdns\(dq: {
    \(dqreverse\-ddns\(dq: {
        \(dqddns\-domains\(dq: [
            {
                \(dqname\(dq: \(dq1.0.0.0.8.B.D.0.1.0.0.2.ip6.arpa.\(dq,
                \(dqkey\-name\(dq: \(dq\(dq,
                \(dqdns\-servers\(dq: [
                ]
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
افزودن یک دامنه بدون هیچ‌گونه کارگزاری امکان‌پذیر است؛ با این حال، اگر آن
دامنه با درخواستی تطبیق یابد، درخواست با شکست مواجه خواهد شد. برای کاربردی
ساختن دامنه، دست‌کم یک کارگزار DNS باید به آن افزوده شود.
.SS افزودن کارگزارهای DNS معکوس
.sp
این بخش نحوهٔ افزودن کارگزارهای DNS به یک دامنهٔ DDNS معکوس را شرح می‌دهد.
این دستورالعمل‌ها را در صورت نیاز برای تمام کارگزارها در هر دامنه تکرار کنید.
.sp
مدخل‌های کارگزار DNS معکوس نمایانگر کارگزارهای واقعی DNS هستند که از
سمت سرور پروتکل DDNS پشتیبانی می‌کنند. هر کارگزار DNS معکوس دارای
پارامترهای زیر است:
.INDENT 0.0
.IP \(bu 2
\fBhostname\fP \- نام میزبان قابل‌حلِ کارگزار DNS؛ این مقدار
در حال حاضر نادیده گرفته می‌شود.
.IP \(bu 2
\fBip\-address\fP \- نشانی IP که کارگزار روی آن به درخواست‌های DDNS
گوش فرا می‌دهد.
.IP \(bu 2
\fBport\fP \- پورتی که کارگزار روی آن به درخواست‌های DDNS گوش فرا می‌دهد.
مقدار پیش‌فرض آن پورت استاندارد سرویس DNS یعنی 53 است.
.UNINDENT
.sp
جهت ایجاد یک کارگزار DNS معکوس جدید، باید یک عنصر کارگزار
جدید به دامنه افزوده شده و پارامترهای آن تعیین شوند. اگر به عنوان مثال،
سرویس روی \(dq172.88.99.10\(dq در حال اجراست، آن را به شکل زیر تنظیم کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcpDdns\(dq: {
    \(dqreverse\-ddns\(dq: {
        \(dqddns\-domains\(dq: [
            {
                \(dqname\(dq: \(dq1.0.0.0.8.B.D.0.1.0.0.2.ip6.arpa.\(dq,
                \(dqkey\-name\(dq: \(dq\(dq,
                \(dqdns\-servers\(dq: [
                    {
                        \(dqip\-address\(dq: \(dq172.88.99.10\(dq,
                        \(dqport\(dq: 53
                    }
                ]
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
از آنجا که \fBhostname\fP هنوز پشتیبانی نمی‌شود، پارامتر \fBip\-address\fP
باید روی نشانی کارگزار DNS تنظیم شود.
.UNINDENT
.UNINDENT
.SS کلیدهای TSIG به ازای هر کارگزار DNS
.sp
از نسخهٔ 2.0.0 در Kea، می‌توان یک کلید TSIG را در پیکربندی کارگزار DNS
مشخص کرد. قاعدهٔ اولویت بدین شرح است:
.INDENT 0.0
.IP \(bu 2
اگر یک نام کلید غیرخالی در مدخل کارگزار DNS مشخص شده باشد، این کلید TSIG
از به‌روزرسانی‌های DNS ارسال‌شده به این کارگزار محافظت می‌کند.
.IP \(bu 2
اگر مدخل کارگزار DNS خالی باشد، اما یک
نام کلید غیرخالی در مدخل دامنهٔ والد مشخص شده باشد، کلید TSIG دامنهٔ والد
از به‌روزرسانی‌های DNS ارسال‌شده به این کارگزار محافظت می‌کند.
.IP \(bu 2
اگر مدخل کارگزار DNS خالی باشد و هیچ نام کلیدی در مدخل دامنهٔ والد آن
مشخص نشده باشد، هیچ TSIGای از به‌روزرسانی‌های DNS ارسال‌شده به این کارگزار محافظت نمی‌کند.
.UNINDENT
.sp
برای نمونه، در این پیکربندی:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcpDdns\(dq: {
    \(dqforward\-ddns\(dq: {
        \(dqddns\-domains\(dq: [
            {
                \(dqname\(dq: \(dqother.example.com.\(dq,
                \(dqkey\-name\(dq: \(dqfoo\(dq,
                \(dqdns\-servers\(dq: [
                    {
                        \(dqip\-address\(dq: \(dq172.88.99.10\(dq,
                        \(dqport\(dq: 53
                    },
                    {
                        \(dqip\-address\(dq: \(dq172.88.99.11\(dq,
                        \(dqport\(dq: 53,
                        \(dqkey\-name\(dq: \(dqbar\(dq
                    }
                ]
            }
        ]
    },
    \(dqreverse\-ddns\(dq: {
        \(dqddns\-domains\(dq: [
            {
                \(dqname\(dq: \(dq1.0.0.0.8.B.D.0.1.0.0.2.ip6.arpa.\(dq,
                \(dqdns\-servers\(dq: [
                    {
                        \(dqip\-address\(dq: \(dq172.88.99.12\(dq,
                        \(dqport\(dq: 53
                    },
                    {
                        \(dqip\-address\(dq: \(dq172.88.99.13\(dq,
                        \(dqport\(dq: 53,
                        \(dqkey\-name\(dq: \(dqbar\(dq
                    }
                ]
            }
        ]
    },
    \(dqtsig\-keys\(dq: [
        {
            \(dqname\(dq: \(dqfoo\(dq,
            \(dqalgorithm\(dq: \(dqHMAC\-MD5\(dq,
            \(dqsecret\(dq: \(dqLSWXnfkKZjdPJI5QxlpnfQ==\(dq
        },
        {
            \(dqname\(dq: \(dqbar\(dq,
            \(dqalgorithm\(dq: \(dqHMAC\-SHA224\(dq,
            \(dqsecret\(dq: \(dqbZEG7Ow8OgAUPfLWV3aAUQ==\(dq
        }
    ]
}
.EE
.UNINDENT
.UNINDENT
.sp
کارگزار 172.88.99.10 از کلید TSIG با نام \(dqfoo\(dq استفاده خواهد کرد، کارگزارهای 172.88.99.11 و
172.88.99.13 از کلید \(dqbar\(dq استفاده خواهند کرد و 172.88.99.12 از TSIG استفاده نخواهد کرد..SS زمینه‌های کاربری در DDNS
.sp
برای پیش‌زمینه بیشتر درباره ایده زمینه کاربر (user context)، بخش نظرات و زمینه کاربر \%<#\:user-context> را ببینید.
.sp
زمینه‌های کاربر را می‌توان در حوزه سراسری (global scope)، یک دامنه DDNS، یک کارساز DNS،
یک کلید TSIG و ثبت‌کننده‌ها (loggers) مشخص کرد. یکی دیگر از کاربردهای مفید، قابلیت ذخیره
نظرات یا توضیحات است؛ تجزیه‌گر یک مدخل \(dqcomment\(dq را به یک زمینه کاربر به همراه
آن مدخل ترجمه می‌کند، که اجازه می‌دهد نظر در داخل خود پیکربندی ضمیمه شود.
.SS نمونه پیکربندی کارساز DHCP\-DDNS
.sp
این بخش یک نمونه پیکربندی کارساز DHCP\-DDNS را بر اساس یک شبکه نمونه کوچک ارائه می‌دهد.
فرض کنیم شبکه نمونه ما دارای سه دامنه است که هر کدام زیرشبکه خود را دارند.
.SS شبکه نمونه ما
.TS
box center;
l|l|l|l.
T{
دامنه
T}	T{
زیرشبکه
T}	T{
کارسازهای DNS
مستقیم
T}	T{
کارسازهای DNS
معکوس
T}
_
T{
four.example.com
T}	T{
192.0.2.0/24
T}	T{
172.16.1.5,
172.16.2.5
T}	T{
172.16.1.5,
172.16.2.5
T}
_
T{
six.example.com
T}	T{
2001:db8:1::/64
T}	T{
3001:1::50
T}	T{
3001:1::51
T}
_
T{
example.com
T}	T{
192.0.0.0/16
T}	T{
172.16.2.5
T}	T{
172.16.2.5
T}
.TE
.sp
ما باید سه دامنه DDNS مستقیم بسازیم:
.SS دامنه‌های DDNS مستقیم مورد نیاز
.TS
box center;
l|l|l.
T{
#
T}	T{
نام دامنه DDNS
T}	T{
کارسازهای DNS
T}
_
T{
.INDENT 0.0
.IP 1. 3
.UNINDENT
T}	T{
four.example.com.
T}	T{
172.16.1.5, 172.16.2.5
T}
_
T{
.INDENT 0.0
.IP 2. 3
.UNINDENT
T}	T{
six.example.com.
T}	T{
3001:1::50
T}
_
T{
.INDENT 0.0
.IP 3. 3
.UNINDENT
T}	T{
example.com.
T}	T{
172.16.2.5
T}
.TE
.sp
همان‌طور که پیش‌تر توضیح داده شد، تطبیق FQDN به دامنه بر اساس طولانی‌ترین تطابق (longest match)
است. عبارت FQDN \(dqmyhost.four.example.com.\(dq با دامنه اول (\(dqfour.example.com\(dq)
تطابق دارد، در حالی که \(dqadmin.example.com.\(dq با دامنه سوم (\(dqexample.com\(dq)
مطابقت پیدا می‌کند. عبارت FQDN \(dqother.example.net.\(dq با هیچ دامنه‌ای تطبیق ندارد
و رد می‌شود.
.sp
پیکربندی نمونه زیر دامنه‌های DDNS مستقیم را مشخص می‌کند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcpDdns\(dq: {
    \(dqcomment\(dq: \(dqexample configuration: forward part\(dq,
    \(dqforward\-ddns\(dq: {
        \(dqddns\-domains\(dq: [
            {
                \(dqname\(dq: \(dqfour.example.com.\(dq,
                \(dqkey\-name\(dq: \(dq\(dq,
                \(dqdns\-servers\(dq: [
                    { \(dqip\-address\(dq: \(dq172.16.1.5\(dq },
                    { \(dqip\-address\(dq: \(dq172.16.2.5\(dq }
                ]
            },
            {
                \(dqname\(dq: \(dqsix.example.com.\(dq,
                \(dqkey\-name\(dq: \(dq\(dq,
                \(dqdns\-servers\(dq: [
                    { \(dqip\-address\(dq: \(dq2001:db8::1\(dq }
                ]
            },
            {
                \(dqname\(dq: \(dqexample.com.\(dq,
                \(dqkey\-name\(dq: \(dq\(dq,
                \(dqdns\-servers\(dq: [
                    { \(dqip\-address\(dq: \(dq172.16.2.5\(dq }
                ],
                \(dquser\-context\(dq: { \(dqbackup\(dq: false }
            },
            ...
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
به طور مشابه، ما باید سه دامنه DDNS معکوس را بسازیم:.SS دامنه‌های معکوس DDNS مورد نیاز
.TS
box center;
l|l|l.
T{
#
T}	T{
نام دامنه DDNS
T}	T{
کارسازهای DNS
T}
_
T{
.INDENT 0.0
.IP 1. 3
.UNINDENT
T}	T{
2.0.192.in\-addr.arpa.
T}	T{
172.16.1.5, 172.16.2.5
T}
_
T{
.INDENT 0.0
.IP 2. 3
.UNINDENT
T}	T{
1.0.0.0.8.d.b.0.1.0.0.2.ip6.arpa.
T}	T{
3001:1::50
T}
_
T{
.INDENT 0.0
.IP 3. 3
.UNINDENT
T}	T{
0.182.in\-addr.arpa.
T}	T{
172.16.2.5
T}
.TE
.sp
آدرس \(dq192.0.2.150\(dq با دامنه نخست،
\(dq2001:db8:1::10\(dq با دامنه دوم، و \(dq192.0.50.77\(dq با دامنه
سوم مطابقت دارد.
.sp
این دامنه‌های معکوس DDNS به صورت زیر مشخص می‌شوند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcpDdns\(dq: {
    \(dqcomment\(dq: \(dqexample configuration: reverse part\(dq,
    \(dqreverse\-ddns\(dq: {
        \(dqddns\-domains\(dq: [
            {
                \(dqname\(dq: \(dq2.0.192.in\-addr.arpa.\(dq,
                \(dqkey\-name\(dq: \(dq\(dq,
                \(dqdns\-servers\(dq: [
                    { \(dqip\-address\(dq: \(dq172.16.1.5\(dq },
                    { \(dqip\-address\(dq: \(dq172.16.2.5\(dq }
                ]
            },
            {
                \(dqname\(dq: \(dq1.0.0.0.8.B.D.0.1.0.0.2.ip6.arpa.\(dq,
                \(dqkey\-name\(dq: \(dq\(dq,
                \(dqdns\-servers\(dq: [
                    { \(dqip\-address\(dq: \(dq2001:db8::1\(dq }
                ]
            },
            {
                \(dqname\(dq: \(dq0.192.in\-addr.arpa.\(dq,
                \(dqkey\-name\(dq: \(dq\(dq,
                \(dqdns\-servers\(dq: [
                    { \(dqip\-address\(dq: \(dq172.16.2.5\(dq }
                ]
            },
            ...
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.SS آمارهای کارساز DHCP\-DDNS
.sp
نسخه 2.0.0 از Kea، پشتیبانی از آمارها را برای DHCP\-DDNS ارائه کرد.
.sp
آمارها به سه گروه تقسیم می‌شوند: NameChangeRequests، به‌روزرسانی‌های DNS،
و به‌روزرسانی‌های DNS بر پایه هر کلید TSIG (per\-TSIG\-key). در حالی که آمارهای دو گروه نخست
تجمعی هستند، یعنی با تغییر پیکربندی یا بارگذاری مجدد تحت تأثیر قرار نمی‌گیرند،
آمارهای بر پایه هر کلید با ایجاد (یا ایجاد مجدد) شیء مربوطه، به ۰ بازنشانی می‌شوند.
.sp
در حال حاضر مدیریت آمارهای Kea دارای محدودیت‌های زیر است:
.INDENT 0.0
.IP \(bu 2
تنها نمونه‌های عدد صحیح (یعنی یک شمارنده و یک برچسب زمانی) استفاده می‌شوند؛
.IP \(bu 2
بیشینه تعداد نمونه ۱ است؛
.IP \(bu 2
هیچ رابط برنامه‌نویسی‌ای (API) برای حذف یک یا تمام آمارها وجود ندارد؛
.IP \(bu 2
هیچ APIای برای تنظیم بیشینه تعداد نمونه یا طول عمر آن وجود ندارد.
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
کتابخانه‌های قلاب (Hook libraries)، مانند کتابخانه GSS\-TSIG،
آمارهای جدیدی را در Kea در دسترس قرار می‌دهند.
.UNINDENT
.UNINDENT
.sp
اطلاعات بیشتر درباره آمارهای Kea را می‌توان در بخش Statistics \%<#\:stats>\& یافت.
.SS آمارهای NCR
.sp
آمارهای مربوط به NameChangeRequest عبارتند از:
.INDENT 0.0
.IP \(bu 2
\fBncr\-received\fP \- تعداد NCRهای معتبر دریافتی
.IP \(bu 2
\fBncr\-invalid\fP \- تعداد NCRهای نامعتبر دریافتی
.IP \(bu 2
\fBncr\-error\fP \- تعداد خطاها در دریافت NCR به‌جز لغو ورودی/خروجی (I/O cancel) هنگام خاموش‌سازی
.IP \(bu 2
\fBqueue\-mgr\-queue\-full\fP \- تعداد دفعاتی که صف دریافت NCR به حداکثر ظرفیت خود رسیده است
.UNINDENT.SS "آمارهای به‌روزرسانی DNS (DNS Update Statistics)"
.sp
آمارهای سراسری به‌روزرسانی DNS عبارتند از:
.INDENT 0.0
.IP \(bu 2
\fBupdate\-sent\fP \- تعداد به‌روزرسانی‌های DNS ارسال‌شده
.IP \(bu 2
\fBupdate\-signed\fP \- تعداد به‌روزرسانی‌های DNS ارسال‌شده و محافظت‌شده با TSIG
.IP \(bu 2
\fBupdate\-unsigned\fP \- تعداد به‌روزرسانی‌های DNS ارسال‌شده و محافظت‌نشده با TSIG
.IP \(bu 2
\fBupdate\-success\fP \- تعداد به‌روزرسانی‌های DNS که با موفقیت تکمیل شده‌اند
.IP \(bu 2
\fBupdate\-timeout\fP \- تعداد به‌روزرسانی‌های DNS که با اتمام مهلت زمانی (timeout) پایان یافته‌اند
.IP \(bu 2
\fBupdate\-error\fP \- تعداد به‌روزرسانی‌های DNS که با خطایی غیر از اتمام مهلت زمانی پایان یافته‌اند
.UNINDENT
.SS "آمارهای به‌روزرسانی DNS بر پایه کلید TSIG (Per\-TSIG\-Key DNS Update Statistics)"
.sp
آمارهای به‌روزرسانی DNS برای هر کلید TSIG عبارتند از:
.INDENT 0.0
.IP \(bu 2
\fBupdate\-sent\fP \- تعداد به‌روزرسانی‌های DNS ارسال‌شده
.IP \(bu 2
\fBupdate\-success\fP \- تعداد به‌روزرسانی‌های DNS که با موفقیت تکمیل شده‌اند
.IP \(bu 2
\fBupdate\-timeout\fP \- تعداد به‌روزرسانی‌های DNS که با اتمام مهلت زمانی (timeout) پایان یافته‌اند
.IP \(bu 2
\fBupdate\-error\fP \- تعداد به‌روزرسانی‌های DNS که با خطایی غیر از اتمام مهلت زمانی پایان یافته‌اند
.UNINDENT
.sp
قالب نام برای آمارهای بر پایه کلید، به صورت \fBkey[<key\-DNS\-name>].<stat\-name>\fP است؛
برای نمونه، نام آمار \fBupdate\-sent\fP برای کلید TSIG با عنوان
\fBkey.example.com.\fP برابر با \fBkey[key.example.com.].update\-sent\fP\& است.
.SS "محدودیت‌های کارگزار DHCP\-DDNS (DHCP\-DDNS Server Limitations)"
.sp
موارد زیر محدودیت‌های کنونی کارگزار DHCP\-DDNS هستند.
.INDENT 0.0
.IP \(bu 2
درخواست‌های دریافتی از کارگزارهای DHCP تا زمان پردازش در صف قرار می‌گیرند.
در حال حاضر، در صورت خاموش شدن کارگزار، تمام درخواست‌های موجود در صف از دست می‌روند.
.UNINDENT
.SS "استانداردهای پشتیبانی‌شده (Supported Standards)"
.sp
RFCهای زیر توسط کارگزار DHCP\-DDNS پشتیبانی می‌شوند:
.INDENT 0.0
.IP \(bu 2
\fISecret Key Transaction Authentication for DNS (TSIG)\fP، RFC 2845 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc2845>: تمام بسته‌های به‌روزرسانی DNS ارسال‌شده و دریافت‌شده توسط کارگزار DHCP\-DDNS می‌توانند با امضاهای TSIG محافظت شوند.
.IP \(bu 2
\fIDynamic Updates in the Domain Name System (DNS UPDATE)\fP، RFC 2136 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc2136>: سازوکار کامل به‌روزرسانی DNS پشتیبانی می‌شود.
.IP \(bu 2
\fIResolution of Fully Qualified Domain Name (FQDN) Conflicts among Dynamic Host Configuration Protocol (DHCP) Clients\fP، RFC 4703 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc4703>: DHCP\-DDNS وظیفه حل تعارض را برای هر دو کارگزار DHCPv4 و DHCPv6 انجام می‌دهد.
.IP \(bu 2
\fIA DNS Resource Record (RR) for Encoding Dynamic Host Configuration Protocol (DHCP) Information (DHCID RR)\fP، RFC 4701 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc4701>: کارگزار DHCP\-DDNS از رکوردهای DHCID استفاده می‌کند.
.UNINDENT
.SH "فرآیند LFC (THE LFC PROCESS)"
.SS "نمای کلی (Overview)"
.sp
\fBkea\-lfc\fP \%<#\:std-iscman-kea-lfc> یک فرآیند سرویس است که اطلاعات زائد را از فایل‌های مورد استفاده برای ذخیره‌سازی پایدار در بک‌اند پایگاه‌داده memfile پاک‌سازی می‌کند. این سرویس برای اجرا به عنوان یک فرآیند مستقل نوشته شده است.
.sp
اگرچه \fBkea\-lfc\fP \%<#\:std-iscman-kea-lfc> را می‌توان به صورت خارجی آغاز کرد، معمولاً نیازی به انجام این کار نیست. \fBkea\-lfc\fP \%<#\:std-iscman-kea-lfc> به صورت دوره‌ای توسط کارگزارهای Kea DHCP اجرا می‌شود و از نسخه Kea 3.1.2 می‌تواند با استفاده از دستور \fBkea\-lfc\-start\fP راه‌اندازی شود.
.sp
این فرآیند روی مجموعه‌ای از فایل‌ها کار می‌کند و از آن‌ها برای دریافت ورودی و ثبت خروجی ورودی‌های اجاره (lease entries) و نشان دادن مرحله‌ای که فرآیند در صورت بروز وقفه در آن قرار دارد، استفاده می‌کند. در حال حاضر فراخواننده باید نام همه این فایل‌ها را مشخص کند.
.SS "گزینه‌های خط فرمان (Command\-Line Options)"
.sp
\fBkea\-lfc\fP \%<#\:std-iscman-kea-lfc> به صورت زیر اجرا می‌شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
kea\-lfc [\-4 | \-6] \-c config\-file \-p pid\-file \-x previous\-file \-i copy\-file \-o output\-file \-f finish\-file
.EE
.UNINDENT
.UNINDENT
.sp
آرگومان \fB\-4\fP یا \fB\-6\fP نسخه پروتکل فایل‌های اجاره را انتخاب می‌کند.
.sp
آرگومان \fB\-c\fP فایل پیکربندی را مشخص می‌کند. این آرگومان الزامی است، اما در حال حاضر توسط فرآیند استفاده نمی‌شود.
.sp
آرگومان \fB\-p\fP فایل PID را مشخص می‌کند. هنگامی که فرآیند \fBkea\-lfc\fP \%<#\:std-iscman-kea-lfc> آغاز می‌شود، با بررسی فایل PID تلاش می‌کند تشخیص دهد که آیا نمونه دیگری از فرآیند از قبل در حال اجرا است یا خیر. اگر نمونه‌ای در حال اجرا باشد، فرآیند جدید خاتمه می‌یابد؛ اگر در حال اجرا نباشد، Kea شناسه فرآیند (PID) خود را در فایل PID می‌نویسد.
.sp
سایر نام‌های فایل مشخص می‌کنند که فرآیند \fBkea\-lfc\fP \%<#\:std-iscman-kea-lfc> کجا باید به دنبال ورودی بگردد، خروجی خود را بنویسد و وظایف ثبت وضعیت (bookkeeping) خود را انجام دهد:
.INDENT 0.0
.IP \(bu 2
\fBprevious\fP — هنگامی که \fBkea\-lfc\fP \%<#\:std-iscman-kea-lfc> آغاز می‌شود، این فایل نتیجه اجرای قبلی \fBkea\-lfc\fP \%<#\:std-iscman-kea-lfc>\& است. هنگامی که \fBkea\-lfc\fP \%<#\:std-iscman-kea-lfc> پایان می‌یابد، نتیجه این اجرا خواهد بود. اگر اجرای \fBkea\-lfc\fP \%<#\:std-iscman-kea-lfc> پیش از تکمیل متوقف شود، ممکن است این فایل وجود نداشته باشد.
.IP \(bu 2
\fBinput\fP — پیش از آنکه کارگزار DHCP فرآیند \fBkea\-lfc\fP \%<#\:std-iscman-kea-lfc> را فراخوانی کند، فایل اجاره فعلی را به اینجا منتقل کرده و سپس \fBkea\-lfc\fP \%<#\:std-iscman-kea-lfc> را با این فایل فراخوانی می‌کند.
.IP \(bu 2
\fBoutput\fP — این فایل موقتی است که \fBkea\-lfc\fP \%<#\:std-iscman-kea-lfc> اجاره‌ها را در آن می‌نویسد. پس از پایان نوشتن در فایل، به فایل \fBfinish\fP منتقل می‌شود (در ادامه ببینید).
.IP \(bu 2
\fBfinish\fP — این یک فایل موقت دیگر است که \fBkea\-lfc\fP \%<#\:std-iscman-kea-lfc> برای ثبت وضعیت استفاده می‌کند. هنگامی که \fBkea\-lfc\fP \%<#\:std-iscman-kea-lfc> نوشتن در فایل \fBoutput\fP را تکمیل کرد، محتویات را به فایلی با این نام منتقل می‌کند. پس از اینکه \fBkea\-lfc\fP \%<#\:std-iscman-kea-lfc> حذف فایل‌های دیگر (\fBprevious\fP و \fBinput\fP) را به پایان رساند، این فایل را به فایل اجاره \fBprevious\fP منتقل می‌کند. با انتقال فایل‌ها به این روش، فرآیندهای \fBkea\-lfc\fP \%<#\:std-iscman-kea-lfc> و کارگزار DHCP می‌توانند حتی در صورتی که یکی از فرآیندها پیش از پایان وظیفه خود دچار وقفه شود، فایل درست را برای استفاده تشخیص دهند.
.UNINDENT
.sp
چندین آرگومان دیگر نیز وجود دارند که بیشتر برای اهداف اشکال‌زدایی به کار می‌روند.
\fB\-d\fP سطح ثبت وقایع (logging) را روی حالت اشکال‌زدایی (debug) تنظیم می‌کند.
\fB\-v\fP و \fB\-V\fP برچسب‌های نسخه را چاپ می‌کنند که \fB\-V\fP قالب طولانی‌تری ارائه می‌دهد.
\fB\-h\fP متن راهنمای استفاده را نمایش می‌دهد..SH "دسته‌بندی کلاینت (CLIENT CLASSIFICATION)"
.SS "نمای کلی دسته‌بندی کلاینت (Client Classification Overview)"
.sp
در موارد خاص، تفکیک بین انواع مختلف کلاینت‌ها و رفتار مناسب با هر یک مفید است. دلایل متداول عبارتند از:
.INDENT 0.0
.IP \(bu 2
کلاینت‌ها بخش‌های متفاوتی از توپولوژی را نشان می‌دهند؛ به عنوان مثال، یک مودم کابلی (cable modem) با کلاینت‌های پشت آن مودم یکسان نیست.
.IP \(bu 2
کلاینت‌ها رفتار متفاوتی دارند؛ به عنوان مثال، رفتار یک گوشی هوشمند با یک لپ‌تاپ تفاوت دارد.
.IP \(bu 2
کلاینت‌ها برای برخی گزینه‌ها به مقادیر متفاوتی نیاز دارند؛ به عنوان مثال، یک مودم کابلی docsis3.0 به تنظیماتی متفاوت نسبت به یک مودم کابلی docsis2.0 نیاز دارد.
.UNINDENT
.sp
برای ساده‌تر شدن مدیریت، کلاینت‌های مختلف می‌توانند در یک کلاس کلاینت (client class) گروه‌بندی شوند تا گزینه‌های مشترکی را دریافت کنند.
.sp
یک بسته ورودی می‌تواند به چندین روش به یک کلاس کلاینت منتسب شود:
.INDENT 0.0
.IP \(bu 2
به‌طور ضمنی، با استفاده از یک گزینه vendor class یا شرط داخلی (built\-in) دیگر.
.IP \(bu 2
با استفاده از عبارتی که مقدار آن به \fBtrue\fP ارزیابی شود.
.IP \(bu 2
با استفاده از رزروهای میزبان ایستا (static host reservations)، یک shared network، یک subnet و غیره.
.IP \(bu 2
با استفاده از یک hook.
.UNINDENT
.sp
دسته‌بندی کلاینت می‌تواند برای تغییر رفتار تقریباً هر بخشی از پردازش پیام‌های DHCP استفاده شود. در حال حاضر ۹ سازوکار وجود دارند که از دسته‌بندی کلاینت بهره می‌برند:
.INDENT 0.0
.IP \(bu 2
دور انداختن پرس‌وجوها (Dropping queries).
.IP \(bu 2
انتخاب زیرشبکه (Subnet selection).
.IP \(bu 2
انتخاب استخر (Pool selection).
.IP \(bu 2
محدود کردن اجاره (Lease limiting).
.IP \(bu 2
محدود کردن نرخ (Rate limiting).
.IP \(bu 2
تنظیم DDNS.
.IP \(bu 2
تعریف گزینه‌های اختصاصی DHCPv4 (کدهای ۲۲۴\-۲۵۴) و گزینه‌های کد ۴۳.
.IP \(bu 2
اختصاص گزینه‌های متفاوت.
.IP \(bu 2
تنظیم گزینه‌های خاص برای استفاده با آدرس سرور TFTP و فیلد فایل بوت (boot file) برای مودم‌های کابلی DHCPv4.
.UNINDENT
.SS "مراحل دسته‌بندی (Classification Steps)"
.sp
فرایند دسته‌بندی در چندین مرحله انجام می‌شود:
.INDENT 0.0
.IP 1. 3
کلاس \fBALL\fP به بسته ورودی منتسب می‌شود.
.IP 2. 3
گزینه‌های vendor class پردازش می‌شوند.
.IP 3. 3
کلاس‌های دارای عبارات منطبق‌سازی که برای ارزیابی بعدی نشانه‌گذاری نشده‌اند (\(dqon request\(dq یا وابسته به کلاس‌های داخلی \fBKNOWN\fP/\fBUNKNOWN\fP)، به ترتیبی که در پیکربندی تعریف شده‌اند پردازش می‌شوند؛ عبارت بولی ارزیابی شده و در صورتی که مقدار \fBtrue\fP (تطابق) را برگرداند، بسته ورودی به آن کلاس منتسب می‌شود.
.IP 4. 3
در صورت دریافت گزینه اختصاصی یا گزینه کد ۴۳ در DHCPv4، آن گزینه بر اساس تعریف client\-class یا سراسری (یا برای گزینه ۴۳، آخرین راهکار/last\-resort) رمزگشایی می‌شود.
.IP 5. 3
هنگامی که بسته ورودی متعلق به کلاس ویژه \fBDROP\fP باشد، دور انداخته می‌شود و یک پیام اطلاع‌رسانی به همراه اطلاعات بسته ثبت می‌شود.
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
فراخوان‌های \fBpkt4_receive\fP و \fBpkt6_receive\fP در اینجا اجرا می‌شوند.
.UNINDENT
.UNINDENT
.INDENT 0.0
.IP 6. 3
هنگامی که پارامتر سراسری \fBearly\-global\-reservations\-lookup\fP بر روی \fBtrue\fP تنظیم شده باشد، این فرایند به جستجوی رزروهای سراسری پرداخته و مراحل ۸، ۹ و ۱۰ را به‌طور جزئی اجرا می‌کند. این جستجو محدود به رزروهای سراسری است؛ اگر موردی یافت شود، کلاس \fBKNOWN\fP تنظیم می‌شود، اما در صورت عدم یافتن، کلاس \fBUNKNOWN\fP تنظیم \fBنمی‌شود\fP.
.IP 7. 3
یک زیرشبکه انتخاب می‌شود، احتمالاً بر اساس اطلاعات کلاس، زمانی که برخی از زیرشبکه‌ها رزرو شده باشند. دقیق‌تر: هنگام انتخاب یک زیرشبکه، سرور در میان تمام زیرشبکه‌هایی که با توجه به اطلاعات موجود در بسته (آدرس کلاینت، آدرس رله و غیره) امکان‌پذیر هستند، پیمایش می‌کند. سرور از اولین زیرشبکه‌ای استفاده می‌کند که یا هیچ کلاسی به آن منتسب نشده باشد، یا دارای کلاسی باشد که با یکی از کلاس‌های بسته مطابقت دارد.
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
فراخوان‌های \fBsubnet4_select\fP و \fBsubnet6_select\fP در اینجا اجرا می‌شوند.
.UNINDENT
.UNINDENT
.INDENT 0.0
.IP 8. 3
سرور به دنبال رزروهای میزبان (host reservations) می‌گردد. اگر شناسه‌ای از بسته ورودی با یک رزرو میزبان در زیرشبکه یا shared network مطابقت داشته باشد، بسته به کلاس \fBKNOWN\fP و تمام کلاس‌های آن رزرو میزبان منتسب می‌شود. اگر رزروی یافت نشود، بسته به کلاس \fBUNKNOWN\fP تخصیص می‌یابد.
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
اگر یک رزرو منطبق از زیرشبکه انتخاب‌شده وجود داشته باشد و آن زیرشبکه متعلق به یک shared\-network باشد، انتساب هر کلاسی که در رزرو مشخص شده است تا پس از تخصیص اجاره به تعویق می‌افتد. این کار به دلیل در نظر گرفتن این احتمال انجام می‌شود که ممکن است انتخاب زیرشبکه در طول تخصیص اجاره تغییر کند و این امر تطابق رزرو اولیه را باطل کرده و احتمالاً جایگزین نماید.
.UNINDENT
.UNINDENT
.INDENT 0.0
.IP 9. 3
کلاس‌های دارای عبارات تطابق \- چه به صورت مستقیم یا غیرمستقیم با استفاده از کلاس‌های داخلی \fBKNOWN\fP/\fBUNKNOWN\fP و بدون نشانه‌گذاری برای ارزیابی بعدی (\(dqon request\(dq) \- به ترتیبی که در پیکربندی تعریف شده‌اند پردازش می‌شوند؛ عبارت بولی ارزیابی می‌شود و در صورت بازگرداندن \fBtrue\fP (تطابق)، بسته ورودی به آن کلاس منتسب می‌گردد. پس از انتخاب یک زیرشبکه، سرور مشخص می‌کند که آیا رزروی برای کلاینت مشخص وجود دارد یا خیر. بنابراین، استفاده از کلاس \fBUNKNOWN\fP برای انتخاب یک shared network یا یک subnet امکان‌پذیر نیست. برای کلاس \fBKNOWN\fP، تنها از رزروهای سراسری استفاده می‌شود و پارامتر \fBearly\-global\-reservations\-lookup\fP باید روی \fBtrue\fP تنظیم شده باشد.
.IP 10. 3
هنگامی که بسته ورودی متعلق به کلاس ویژه \fBDROP\fP باشد، دور انداخته می‌شود و یک پیام اطلاع‌رسانی به همراه اطلاعات بسته ثبت می‌شود. از نگارش ۱.۹.۸ برنامه Kea به بعد، وابسته کردن کلاس \fBDROP\fP به کلاس‌های \fBKNOWN\fP/\fBUNKNOWN\fP مجاز است.
.IP 11. 3
در صورت نیاز، آدرس‌ها و پیشوندها از استخرها (pools) تخصیص می‌یابند، که در صورت رزرو بودن برخی استخرها برای اعضای کلاس، ممکن است بر اساس اطلاعات کلاس انجام پذیرد.
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
فراخوان‌های \fBlease4_select\fP، \fBlease4_renew\fP، \fBlease6_select\fP، \fBlease6_renew\fP و \fBlease6_rebind\fP در اینجا اجرا می‌شوند.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
اگر یک رزرو میزبان منطبق از زیرشبکه انتخاب‌شده وجود داشته باشد و آن زیرشبکه متعلق به یک shared\-network باشد، هر کلاسی که در رزرو مشخص شده است تخصیص داده می‌شود.
.UNINDENT
.UNINDENT
.INDENT 0.0
.IP 12. 4
فهرست‌های \fBevaluate\-additional\-classes\fP (در صورت وجود) ابتدا برای pool، سپس subnet و در نهایت shared\-network که منابع تخصیص‌یافته به آن تعلق دارند، ارزیابی می‌شوند. کلاس‌ها به همان ترتیبی که در هر فهرست آمده‌اند ارزیابی می‌شوند.
.IP 13. 4
گزینه‌ها مجدداً احتمالاً بر اساس اطلاعات کلاس و به ترتیبی که کلاس‌ها به بسته ورودی منتسب شده‌اند، اختصاص داده می‌شوند. اولین کلاسی که با بسته تطابق داشته و گزینه مشخص‌شده‌ای را معین کند، اولویت دارد. برای گزینه‌های اختصاصی و کد ۴۳ در DHCPv4، این شامل تعاریف گزینه مشخص‌شده درون کلاس‌ها نیز می‌شود. ترتیب اولویت گزینه‌ها به صورت زیر است:
.INDENT 4.0
.IP 1. 3
گزینه‌های میزبان (Host options)
.IP 2. 3
گزینه‌های استخر (Pool options)
.IP 3. 3
گزینه‌های زیرشبکه (Subnet options)
.IP 4. 3
گزینه‌های شبکه مشترک (Shared network options)
.IP 5. 3
گزینه‌های کلاس‌های اختصاص‌یافته در طول دسته‌بندی عادی:
.INDENT 4.0
.INDENT 3.5
.INDENT 0.0
.IP a. 3
کلاس \fBALL\fP.IP b. 3
کلاس‌های سازنده (Vendor classes)
.IP c. 3
کلاس‌های میزبان (Host classes)
.IP d. 3
کلاس‌های ارزیابی‌شده‌ای که به کلاس \fBKNOWN\fP وابسته نیستند
.IP e. 3
کلاس‌های \fBKNOWN\fP و \fBUNKNOWN\fP
.IP f. 3
کلاس‌های ارزیابی‌شده‌ای که به کلاس \fBKNOWN\fP وابسته‌اند
.UNINDENT
.UNINDENT
.UNINDENT
.IP 6. 3
گزینه‌های مربوط به کلاس‌ها در \fBevaluate\-additional\-classes\fP از:
.INDENT 4.0
.INDENT 3.5
.INDENT 0.0
.IP a. 3
استخر (Pool)
.IP b. 3
زیرشبکه (Subnet)
.IP c. 3
شبکه مشترک (Shared network)
.UNINDENT
.UNINDENT
.UNINDENT
.IP 7. 3
گزینه‌های سراسری (Global options)
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
در دسته‌بندی کلاینت‌ها باید دقت به خرج داد، زیرا برای کلاینت‌هایی که معیارهای هیچ کلاسی را
برآورده نمی‌کنند، این احتمال به سادگی وجود دارد که به کلی از دریافت سرویس
محروم شوند.
.UNINDENT
.UNINDENT
.SS کلاس‌های توکار کلاینت (Built\-in Client Classes)
.sp
برخی کلاس‌ها توکار هستند، بنابراین نیازی به تعریف صریح آن‌ها نیست. در صورت
نیاز به پیوند دادن طول عمر اجاره (lease lifetime)، داده‌های گزینه و
غیره با آن‌ها، می‌توان آن‌ها را تعریف کرد.
.sp
اطلاعات کلاس سازنده (vendor class) نمونه اصلی این مورد است: سرور بررسی می‌کند که آیا
بسته ورودی DHCPv4 شامل گزینه شناسه کلاس سازنده (60) هست یا بسته
ورودی DHCPv6 شامل گزینه کلاس سازنده (16) می‌باشد. اگر چنین باشد،
محتوای آن گزینه با پیشوند \fBVENDOR_CLASS_\fP همراه شده و نتیجه به
عنوان کلاسی برای آن بسته تفسیر می‌شود. محتوایی که در نظر گرفته می‌شود کل شناسه کلاس
برای DHCPv4، و اولین فیلد داده کلاس سازنده برای DHCPv6 است. شماره سازمانی (enterprise number)
و فیلدهای داده کلاس سازنده پس از آن برای اهداف دسته‌بندی استفاده نمی‌شوند. برای مثال، مودم‌های
کابلی امروزی چنین گزینه‌هایی را با مقدار \fBdocsis3.0\fP ارسال می‌کنند، بنابراین بسته متعلق به
کلاس \fBVENDOR_CLASS_docsis3.0\fP خواهد بود\&.
.sp
پیشوند \fBHA_\fP توسط \fBlibdhcp_ha.so\fP \%<#\:std-ischooklib-libdhcp_ha\:.so> برای
تعیین سرورهای خاصی جهت پردازش بسته‌های DHCP در نتیجه توازن بار (load
balancing) استفاده می‌شود. نام کلاس با اضافه کردن پیشوند \fBHA_\fP به
ابتدای نام سروری که باید بسته DHCP را پردازش کند ساخته می‌شود. این
سرور بر اساس کلاس‌های کلاینت اختصاص‌یافته، از استخر یا زیرشبکه مناسبی برای تخصیص آدرس‌های IP
(و/یا پیشوندها) استفاده می‌کند. جزئیات را می‌توان در libdhcp_ha.so: High Availability Outage Resilience for Kea Servers \%<#\:hooks-high-availability>\& یافت.
.sp
پیشوند \fBSPAWN_\fP توسط کلاس‌های الگو (template classes) برای تولید نام‌های کلاس
مشتق‌شده (spawned) در زمان اجرا استفاده می‌شود. نام کلاس مشتق‌شده با الحاق پیشوند
\fBSPAWN_\fP به ابتدای نام کلاس الگو و مقدار ارزیابی‌شده ساخته می‌شود:
\fBSPAWN_<template\-class\-name>_<evaluated\-value>\fP\&.
جزئیات بیشتر را می‌توان در Configuring Classes یافت\&.
.sp
کلاس \fBBOOTP\fP توسط \fBlibdhcp_bootp.so\fP \%<#\:std-ischooklib-libdhcp_bootp\:.so> برای دسته‌بندی و
پاسخ‌گویی به پرس‌وجوهای ورودی BOOTP استفاده می‌شود.
.sp
کلاس \fBSKIP_DDNS\fP توسط کتابخانه قلابِ تنظیم DDNS (DDNS\-tuning hook library) برای لغو
به‌روزرسانی‌های DDNS بر اساس هر کلاینت استفاده می‌شود.
.sp
نمونه‌های دیگر شامل کلاس \fBALL\fP است که تمامی بسته‌های ورودی به آن تعلق دارند،
و کلاس \fBKNOWN\fP که هنگام وجود رزرو میزبان (host reservation) برای یک
کلاینت خاص اختصاص می‌یابد. طبق قرارداد، نام کلاس‌های توکار همگی با حروف
بزرگ آغاز می‌شود.
.sp
نام‌های کلاس‌های توکار که در حال حاضر شناسایی می‌شوند عبارتند از \fBALL\fP، \fBKNOWN\fP و \fBUNKNOWN\fP،
و پیشوندهای \fBVENDOR_CLASS_\fP، \fBHA_\fP، \fBAFTER_\fP، \fBEXTERNAL_\fP،
\fBSKIP_DDNS\fP\&. اگرچه پیشوند \fBAFTER_\fP تمهیدی برای یک قلاب (hook)
هنوز نوشته‌نشده است، پیشوند \fBEXTERNAL_\fP را می‌توان آزادانه استفاده کرد؛ کلاس‌های توکار
به صورت ضمنی تعریف شده‌اند، بنابراین اگر در پیکربندی ظاهر نشوند، هرگز هشداری صادر نمی‌کنند.
.SS استفاده از عبارت‌ها در دسته‌بندی (Using Expressions in Classification)
.sp
بخش عبارت (expression) از یک تعریف دسته‌بندی شامل عملگرها
و مقادیر است. در حال حاضر تمامی مقادیر رشته هستند؛ عملگرها یک یا چند رشته را به عنوان ورودی
گرفته و رشته دیگری برمی‌گردانند. هنگامی که تمام عملیات پایان یافت،
نتیجه باید مقداری از نوع \fBtrue\fP یا \fBfalse\fP باشد\&. در صورتی که نتیجه \fBtrue\fP باشد،
بسته متعلق به آن کلاس است (و نام کلاس به فهرست کلاس‌ها
اضافه می‌شود)\&. عبارت‌ها در قالب استاندارد نوشته می‌شوند و می‌توانند تودرتو باشند.
.sp
عبارت‌ها هنگام تجزیه فایل پیکربندی پیش‌پردازش شده و به یک نمایش داخلی
تبدیل می‌شوند. این امر امکان شناسایی و ثبت انواع خاصی از خطاها را
در زمان تجزیه فراهم می‌کند. نمونه‌هایی از این خطاها شامل تعداد یا نوع
نادرست آرگومان ورودی برای یک عملگر است. کد ارزیابی نیز این دسته از خطاها را بررسی
کرده و معمولاً یک استثنا صادر می‌کند (throw exception)، اگرچه این حالت در یک
سیستم با عملکرد عادی نباید رخ دهد.
.sp
سایر موارد، از جمله قرار گرفتن موقعیت شروع یک زیررشته در خارج از
محدوده آن زیررشته یا عدم وجود یک گزینه در بسته، منجر به بازگرداندن
یک رشته خالی توسط عملگر می‌شود.
.sp
وابستگی‌های بین کلاس‌ها نیز بررسی می‌شوند. برای نمونه، وابستگی‌های رو به جلو
(forward dependencies) هنگام تجزیه پیکربندی رد می‌شوند؛ یک عبارت تنها می‌تواند
به کلاس‌های از پیش تعریف‌شده (از جمله کلاس‌های توکار) وابسته باشد که در یک مرحله
ارزیابی قبلی یا همان مرحله ارزیابی شده‌اند. این موضوع برای کلاس‌های \fBKNOWN\fP یا \fBUNKNOWN\fP
اعمال نمی‌شود.
.SS فهرست مقادیر دسته‌بندی (List of classification values)
.TS
box center;
l|l|l.
T{
نام
T}	T{
عبارت نمونه
T}	T{
مقدار نمونه
T}
_
T{
رشته لفظی
T}	T{
\(aqexample\(aq
T}	T{
\(aqexample\(aq
T}
_
T{
رشته هگزادسیمال
لفظی
T}	T{
0x5a7d
T}	T{
\(aqZ}\(aq
T}
_
T{
آدرس IP لفظی
T}	T{
10.0.0.1
T}	T{
0x0a000001
T}
_
T{
عدد صحیح لفظی
T}	T{
123
T}	T{
\(aq123\(aq
T}
_
T{
محتوای باینری
گزینه
T}	T{
option[123].hex
T}	T{
\(aq(content of the
option)\(aq
T}
_
T{
وجود گزینه
T}	T{
option[123].exists
T}	T{
\(aqtrue\(aq
T}
_
T{
محتوای باینری
زیرگزینه
T}	T{
option[12].option[34].hex
T}	T{
\(aq(content of the
sub\-option)\(aq
T}
_
T{
وجود زیرگزینه
T}	T{
option[12].option[34].exists
T}	T{
\(aqtrue\(aq
T}
_
T{
عضویت در کلاس
کلاینت
T}	T{
member(\(aqfoobar\(aq)
T}	T{
\(aqtrue\(aq
T}
_
T{
کلاینت شناخته‌شده
T}	T{
known
T}	T{
member(\(aqKNOWN\(aq)
T}
_
T{
کلاینت ناشناخته
T}	T{
unknown
T}	T{
not member(\(aqKNOWN\(aq)
T}
_
T{
زیرگزینه عامل رله
DHCPv4
T}	T{
relay4[123].hex
T}	T{
\(aq(content of the RAI
sub\-option)\(aq
T}
_
T{
گزینه‌های رله DHCPv6
T}	T{
relay6[nest].option[code].hex
T}	T{
(value of the option)
T}
_
T{
آدرس همتای رله
DHCPv6
T}	T{
relay6[nest].peeraddr
T}	T{
2001:DB8::1
T}
_
T{
آدرس پیوند رله
DHCPv6
T}	T{
relay6[nest].linkaddr
T}	T{
2001:DB8::1
T}
_
T{
نام رابط
بسته
T}	T{
pkt.iface
T}	T{
eth0
T}
_
T{
آدرس مبدأ
بسته
T}	T{
pkt.src
T}	T{
10.1.2.3
T}
_
T{
آدرس مقصد
بسته
T}	T{
pkt.dst
T}	T{
10.1.2.3
T}
_
T{
طول بسته
T}	T{
pkt.len
T}	T{
513
T}
_
T{
آدرس سخت‌افزاری در
بسته DHCPv4
T}	T{
pkt4.mac
T}	T{
0x010203040506
T}
_
T{
طول سخت‌افزار در
بسته DHCPv4
T}	T{
pkt4.hlen
T}	T{
6
T}
_
T{
نوع سخت‌افزار در
بسته DHCPv4
T}	T{
pkt4.htype
T}	T{
6
T}
_
T{
فیلد ciaddr در
بسته DHCPv4
T}	T{
pkt4.ciaddr
T}	T{
192.0.2.1
T}
_
T{
فیلد giaddr در
بسته DHCPv4
T}	T{
pkt4.giaddr
T}	T{
192.0.2.1
T}
_
T{
فیلد yiaddr در
بسته DHCPv4
T}	T{
pkt4.yiaddr
T}	T{
192.0.2.1
T}
_
T{
فیلد siaddr در
بسته DHCPv4
T}	T{
pkt4.siaddr
T}	T{
192.0.2.1
T}
_
T{
نوع پیام در
بسته DHCPv4
T}	T{
pkt4.msgtype
T}	T{
1
T}
_
T{
شناسه تراکنش (xid)
در بسته DHCPv4
T}	T{
pkt4.transid
T}	T{
12345
T}
_
T{
نوع پیام در
بسته DHCPv6
T}	T{
pkt6.msgtype
T}	T{
1
T}
_
T{
شناسه تراکنش در
بسته DHCPv6
T}	T{
pkt6.transid
T}	T{
12345
T}
_
T{
وجود گزینه سازنده
(هر سازنده‌ای)
T}	T{
vendor[*].exists
T}	T{
\(aqtrue\(aq
T}
_
T{
وجود گزینه سازنده
(سازنده خاص)
T}	T{
vendor[4491].exists
T}	T{
\(aqtrue\(aq
T}
_
T{
شناسه سازمانی (enterprise\-id)
از گزینه سازنده
T}	T{
vendor.enterprise
T}	T{
4491
T}
_
T{
وجود زیرگزینه
سازنده
T}	T{
vendor[4491].option[1].exists
T}	T{
\(aqtrue\(aq
T}
_
T{
محتوای زیرگزینه
سازنده
T}	T{
vendor[4491].option[1].hex
T}	T{
docsis3.0
T}
_
T{
وجود گزینه کلاس سازنده
(هر سازنده‌ای)
T}	T{
vendor\-class[*].exists
T}	T{
\(aqtrue\(aq
T}
_
T{
وجود گزینه کلاس سازنده
(سازنده خاص)
T}	T{
vendor\-class[4491].exists
T}	T{
\(aqtrue\(aq
T}
_
T{
شناسه سازمانی (enterprise\-id)
از گزینه کلاس سازنده
T}	T{
vendor\-class.enterprise
T}	T{
4491
T}
_
T{
نخستین بخش داده از
گزینه کلاس سازنده
T}	T{
vendor\-class[4491].data
T}	T{
docsis3.0
T}
_
T{
بخش داده خاص از
گزینه کلاس سازنده
T}	T{
vendor\-class[4491].data[3]
T}	T{
docsis3.0
T}
.TE
.sp
نکات:
.INDENT 0.0.IP \(bu 2
رشته‌های هگزادسیمال همان‌گونه که انتظار می‌رود به یک رشته تبدیل می‌شوند.
\fB0X\fP یا \fB0x\fP ابتدایی حذف می‌شود، و اگر تعداد نویسه‌های رشته فرد
باشد، یک \(dq0\(dq به ابتدای آن افزوده می‌شود.
.IP \(bu 2
آدرس‌های IP به رشته‌هایی به طول ۴ یا ۱۶ تبدیل می‌شوند. آدرس‌های IPv4،‏
IPv6 و IPv4 تعبیه‌شده در IPv6 (مانند IPv4\-mapped IPv6) پشتیبانی
می‌شوند.
.IP \(bu 2
اعداد صحیح در یک عبارت به اعداد صحیح ۳۲\-بیتی بدون علامت تبدیل می‌شوند
و به‌صورت رشته‌های چهار بایتی نشان داده می‌شوند؛ برای نمونه، 123 به‌صورت
\fB0x0000007b\fP\& نمایش داده می‌شود. تمام عبارت‌هایی که مقادیر عددی برمی‌گردانند،
از اعداد صحیح ۳۲\-بیتی بدون علامت استفاده می‌کنند، حتی اگر فیلد مربوطه در
بسته کوچک‌تر باشد. به‌طور کلی، استفاده از نماد ده‌دهی برای نمایش اعداد
صحیح آسان‌تر است، اما استفاده از نماد هگزادسیمال نیز امکان‌پذیر است. هنگام
نوشتن یک عدد صحیح در مبنای شانزده، باید دقت شود که مقدار حتماً به‌صورت ۳۲
بیت نشان داده شود، مثلاً به‌جای \fB0x1\fP یا \fB0x01\fP\& از \fB0x00000001\fP
استفاده کنید. همچنین، مطمئن شوید که مقدار در ترتیب بایت شبکه (network order)
مشخص شده باشد، برای نمونه 1 به‌صورت \fB0x00000001\fP\& نمایش می‌یابد.
.IP \(bu 2
عبارت \fBoption[code].hex\fP مقدار گزینه‌ای با کد \fBcode\fP را از بستهٔ
دریافتی استخراج می‌کند. اگر بسته فاقد این گزینه باشد، یک رشتهٔ خالی
برمی‌گرداند. این رشته به‌صورت یک رشتهٔ بایتی از بار دادهٔ (payload) گزینه،
بدون فیلدهای کد نوع یا طول ارائه می‌شود.
.IP \(bu 2
عبارت \fBoption[code].exists\fP بررسی می‌کند که آیا گزینه‌ای با کد \fBcode\fP
در بستهٔ دریافتی وجود دارد یا خیر. این عبارت را می‌توان با گزینه‌های خالی
نیز به‌کار برد.
.IP \(bu 2
عبارت \fBmember(\(aqfoobar\(aq)\fP بررسی می‌کند که آیا بسته متعلق به کلاس
کلاینت \fBfoobar\fP\& است یا خیر. برای جلوگیری از حلقه‌های وابستگی،
تجزیه‌گر فایل پیکربندی بررسی می‌کند که آیا کلاس‌های کلاینت از قبل تعریف
شده‌اند یا توکار هستند، یعنی با \fBVENDOR_CLASS_\fP، \fBAFTER_\fP (برای
قلابِ آیندهٔ \(dqafter\(dq) و \fBEXTERNAL_\fP آغاز می‌شوند یا برابر با
\fBALL\fP، \fBKNOWN\fP، \fBUNKNOWN\fP و غیره هستند.
.sp
کلمات \fBknown\fP و \fBunknown\fP حالت‌های کوتاه‌شده برای \fBmember(\(aqKNOWN\(aq)\fP
و \fBnot member(\(aqKNOWN\(aq)\fP\& هستند. توجه داشته باشید که ارزیابی هر
عبارتی که از کلاس \fBKNOWN\fP (به‌صورت مستقیم یا غیرمستقیم) استفاده می‌کند،
به پس از جستجوی رزرو میزبان موکول می‌شود (یعنی زمانی که افرازِ \fBKNOWN\fP
یا \fBUNKNOWN\fP مشخص شده باشد).
.IP \(bu 2
عبارت \fBrelay4[code].hex\fP تلاش می‌کند تا مقدار زیرگزینهٔ \fBcode\fP را از
گزینه‌ای که به‌عنوان گزینهٔ اطلاعات عامل رلهٔ DHCPv4 یا
DHCPv4 Relay Agent Information (82) درج شده است، استخراج کند. اگر بسته فاقد
گزینهٔ RAI باشد، یا گزینهٔ RAI شامل زیرگزینهٔ درخواستی نباشد، عبارت یک
رشتهٔ خالی برمی‌گرداند. این رشته به‌صورت یک رشتهٔ بایتی از بار دادهٔ گزینه
بدون فیلدهای کد نوع یا طول ارائه می‌شود. استفاده از این عبارت تنها در
DHCPv4 مجاز است.
.IP \(bu 2
عبارت \fBrelay4\fP از همان انواع نمایش مشابه با \fBoption\fP استفاده می‌کند؛
برای نمونه، \fBrelay4[code].exists\fP پشتیبانی می‌شود.
.IP \(bu 2
عبارت \fBrelay6[nest]\fP امکان دسترسی به کپسوله‌سازی‌های استفاده‌شده توسط
هر رلهٔ DHCPv6 را که بسته را هدایت کرده است فراهم می‌کند. سطح \fBnest\fP
رله‌ای را مشخص می‌کند که اطلاعات باید از آن استخراج شود، به‌طوری که مقدار 0
نشان‌دهندهٔ نزدیک‌ترین رله به کارساز DHCPv6 است. مقادیر منفی امکان شمارش
رله‌ها را از سمت کلاینت DHCPv6 فراهم می‌کنند، به‌طوری که \-1 نشان‌دهندهٔ
نزدیک‌ترین رله به کلاینت است. اگر کپسوله‌سازی درخواستی وجود نداشته باشد،
رشتهٔ خالی \fB\(dq\(dq\fP برگردانده می‌شود. این عبارت تنها در DHCPv6 مجاز است.
.IP \(bu 2
عبارت \fBrelay6[nest].option[code]\fP از همان انواع نمایش مشابه با
\fBoption\fP استفاده می‌کند؛ برای نمونه، \fBrelay6[nest].option[code].exists\fP
پشتیبانی می‌شود.
.IP \(bu 2
عبارت‌هایی که با \fBpkt4\fP آغاز می‌شوند تنها در DHCPv4 قابل استفاده هستند.
آن‌ها امکان دسترسی به فیلدهای پیام DHCPv4 را فراهم می‌کنند.
.IP \(bu 2
عبارت \fBpkt6\fP به اطلاعات درخواست کلاینت اشاره دارد. برای دسترسی به
اطلاعات رله‌های میانی، از \fBrelay6\fP\& استفاده کنید. \fBpkt6.msgtype\fP
و \fBpkt6.transid\fP یک رشتهٔ باینری ۴ بایتی را برای نوع پیام یا شناسهٔ
تراکنش خروجی می‌دهند. برای نمونه، نوع پیام \fBSOLICIT\fP برابر با
\fB0x00000001\fP یا به‌سادگی 1 است، مانند \fBpkt6.msgtype == 1\fP\&.
.IP \(bu 2
منظور از \(dqگزینهٔ سازنده\(dq (Vendor option)، گزینهٔ Vendor\-Identifying
Vendor\-Specific Information در DHCPv4 (کد 125؛ بخش ۴ از RFC
3925 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc3925#\:section-4> را ببینید)
و گزینهٔ Vendor\-Specific Information Option در DHCPv6 (کد 17، تعریف‌شده در
بخش ۲۱.۱۷ از RFC
9915 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc9915#\:section-21\:.17>)
است. منظور از \(dqگزینهٔ کلاس سازنده\(dq (Vendor class option)، گزینهٔ
Vendor\-Identifying Vendor Class Option در DHCPv4 (کد 124؛ بخش ۳ از RFC
3925 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc3925#\:section-3> را ببینید)
در DHCPv4 و گزینهٔ Class Option در DHCPv6 (کد 16؛ بخش ۲۱.۱۶ از RFC
9915 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc9915#\:section-21\:.16>)
است. گزینه‌های سازنده ممکن است زیرگزینه‌هایی داشته باشند که با کد مربوطه‌شان
ارجاع داده می‌شوند. گزینه‌های کلاس سازنده فاقد زیرگزینه هستند، بلکه تکه‌های
داده (data chunks) دارند که با مقدار نمایه ارجاع داده می‌شوند. نمایهٔ 0 به
معنای نخستین تکهٔ داده، نمایهٔ 1 برای دومین تکهٔ داده (در صورت وجود) و به
همین ترتیب است.
.IP \(bu 2
در ساختارهای vendor و vendor\-class می‌توان از یک ستاره (*) یا 0 برای
مشخص کردن مقدار عام‌کارت (wildcard) برای \fBenterprise\-id\fP استفاده کرد،
به این معنی که با هر مقدار \fBenterprise\-id\fP مطابقت خواهد داشت.
.IP \(bu 2
شناسهٔ کلاس سازنده یا Vendor Class Identifier (گزینهٔ 60 در DHCPv4) با
استفاده از عبارت option[60] قابل دسترسی است.
.IP \(bu 2
استانداردهای RFC 3925 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc3925> و
RFC 9915 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc9915> اجازه می‌دهند
که چندین نمونه از گزینه‌های سازنده در یک پیام ظاهر شوند. کد طبقه‌بندی کلاینت
در حال حاضر در صورتی که بیش از یک مورد ظاهر شود، نخستین نمونه را بررسی می‌کند.
برای عبارت‌های \fBvendor.enterprise\fP و \fBvendor\-class.enterprise\fP،
مقدار اولین نمونه برگردانده می‌شود. لطفاً برای درخواست پشتیبانی از چندین
نمونه، یک درخواست قابلیت (feature request) در وب‌گاه گیت‌لب Kea به آدرس
\%<https://\:gitlab\:.isc\:.org/\:isc-projects/\:kea> ثبت کنید.
.UNINDENT
.SS "فهرست عبارت‌های طبقه‌بندی (List of classification expressions)"
.TS
box center;
l|l|l.
T{
نام
T}	T{
مثال
T}	T{
توضیحات
T}
_
T{
Equal
T}	T{
\(aqfoo\(aq == \(aqbar\(aq
T}	T{
مقایسهٔ دو مقدار و
برگرداندن \fBtrue\fP یا \fBfalse\fP
T}
_
T{
Match
T}	T{
match(\(aqfoo.*\(aq, \(aqfoobar\(aq)
T}	T{
تطبیق یک عبارت باقاعده
با یک مقدار.
T}
_
T{
Not
T}	T{
not (\(aqfoo\(aq == \(aqbar\(aq)
T}	T{
نقیض منطقی
T}
_
T{
And
T}	T{
(\(aqfoo\(aq == \(aqbar\(aq) and
(\(aqbar\(aq == \(aqfoo\(aq)
T}	T{
«و»ی منطقی
T}
_
T{
Or
T}	T{
(\(aqfoo\(aq == \(aqbar\(aq) or
(\(aqbar\(aq == \(aqfoo\(aq)
T}	T{
«یا»ی منطقی
T}
_
T{
Substring
T}	T{
substring(\(aqfoobar\(aq,0,3)
T}	T{
برگرداندن زیررشتهٔ
درخواست‌شده
T}
_
T{
Concat
T}	T{
concat(\(aqfoo\(aq,\(aqbar\(aq)
T}	T{
برگرداندن الحاق
رشته‌ها
T}
_
T{
Concat (عملگر +)
T}	T{
\(aqfoo\(aq + \(aqbar\(aq
T}	T{
برگرداندن الحاق
رشته‌ها
T}
_
T{
Ifelse
T}	T{
ifelse(\(aqfoo\(aq ==
\(aqbar\(aq,\(aqus\(aq,\(aqthem\(aq)
T}	T{
برگرداندن مقدار شاخه
بر اساس شرط
T}
_
T{
Hexstring
T}	T{
hexstring(\(aqfoo\(aq, \(aq\-\(aq)
T}	T{
تبدیل مقدار به یک رشتهٔ
هگزادسیمال،
مانند 66\-6F\-6F
T}
_
T{
Lcase
T}	T{
lcase(\(aqLoWeR\(aq)
T}	T{
تبدیل مقدار یک عبارت
رشته‌ای به حروف کوچک،
مانند \(aqlower\(aq
T}
_
T{
Ucase
T}	T{
ucase(\(aquPpEr\(aq)
T}	T{
تبدیل مقدار یک عبارت
رشته‌ای به حروف بزرگ،
مانند \(aqUPPER\(aq
T}
_
T{
Split
T}	T{
split(\(aqfoo.bar\(aq, \(aq.\(aq, 2)
T}	T{
برگرداندن فیلد دوم، با
تفکیک بر اساس نقطه.
T}
.TE.SS فهرست عبارت‌های تبدیل به متن (conversion\-to\-text)
.TS
box center;
l|l|l.
T{
نام
T}	T{
مثال
T}	T{
توضیحات
T}
_
T{
AddressToText
T}	T{
addrtotext (192.10.0.1)
addrtotext (2003:db8::)
T}	T{
نمایش ۴ بایت از یک
آدرس IPv4 یا ۱۶ بایت
از یک آدرس IPv6 در
قالب خوانا برای انسان
T}
_
T{
Int8ToText
T}	T{
int8totext (\-1)
T}	T{
نمایش عدد صحیح
علامت‌دار ۸ بیتی در
قالب متنی
T}
_
T{
Int16ToText
T}	T{
int16totext (\-1)
T}	T{
نمایش عدد صحیح
علامت‌دار ۱۶ بیتی در
قالب متنی
T}
_
T{
Int32ToText
T}	T{
int32totext (\-1)
T}	T{
نمایش عدد صحیح
علامت‌دار ۳۲ بیتی در
قالب متنی
T}
_
T{
UInt8ToText
T}	T{
uint8totext (255)
T}	T{
نمایش عدد صحیح
بدون علامت ۸ بیتی در
قالب متنی
T}
_
T{
UInt16ToText
T}	T{
uint16totext (65535)
T}	T{
نمایش عدد صحیح
بدون علامت ۱۶ بیتی در
قالب متنی
T}
_
T{
UInt32ToText
T}	T{
uint32totext (4294967295)
T}	T{
نمایش عدد صحیح
بدون علامت ۳۲ بیتی در
قالب متنی
T}
.TE
.sp
نکات:
.sp
عملگرهای تبدیل می‌توانند برای تبدیل داده‌ها از بازنمود باینری به متنی استفاده شوند. تنها شرط این است که طول نوع دادهٔ ورودی با مقدار مورد انتظار همخوانی داشته باشد.
.sp
نشانهٔ \fBAddressToText\fP برای آدرس‌های IPv4 انتظار ۴ بایت و برای آدرس‌های IPv6 انتظار ۱۶ بایت را دارد. نشانه‌های \fBInt8ToText\fP و \fBUInt8ToText\fP انتظار ۱ بایت، نشانه‌های \fBInt16ToText\fP و \fBUInt16ToText\fP انتظار ۲ بایت، و نشانه‌های \fBInt32ToText\fP و \fBUInt32ToText\fP انتظار ۴ بایت دارند. برای تمام نشانه‌های تبدیل، اگر طول داده ۰ باشد، رشتهٔ حاصل خالی خواهد بود.
.SS گزاره‌ها (Predicates)
.sp
دو گزارهٔ موجود Equal و Match هستند. می‌توان از آن‌ها برای ساخت سایر گزاره‌های متداول استفاده کرد، به عنوان مثال:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
not (substring(\(aqfoobar\(aq, 3, 3) == \(aqbar\(aq)
match(\(aqfoo.*\(aq, lcase(\(aqFooBar\(aq))
match(\(aq.*foo.*\(aq, \(aqis it foo or bar\(aq)
match(\(aq^.*foo.*$\(aq, \(aqis it foo or bar\(aq)
.EE
.UNINDENT
.UNINDENT
.sp
بنابراین نابرابری، تطبیق الگوی مستقل از بزرگی و کوچکی حروف یا جستجوی الگو حاصل می‌شود.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
عبارت‌های باقاعدهٔ نامعتبرِ شناسایی‌شده به عنوان خطای نحوی تلقی می‌شوند، و استثناهای زمان اجرا در حین تطبیق، به عنوان عدم تطبیق در نظر گرفته می‌شوند.
.UNINDENT
.UNINDENT
.sp
\fBهشدار:\fP
.INDENT 0.0
.INDENT 3.5
در استفاده از عملگر match مراقب باشید، زیرا می‌تواند منجر به کارایی بسیار ضعیف شده و به انکار سرویس ناشی از عبارت باقاعده (ReDoS) بیانجامد.
.UNINDENT
.UNINDENT.SS عملگرهای منطقی (Logical Operators)
.sp
عملگرهای منطقی Not، And و Or از عملگرهای رایج هستند. Not بالاترین اولویت و Or پایین‌ترین اولویت را دارد. And و Or شرکت‌پذیر (از چپ) هستند. پرانتزها در اطراف یک عبارت منطقی می‌توانند برای اعمال یک گروه‌بندی مشخص استفاده شوند؛ برای نمونه در \(dqA and (B or C)\(dq. بدون پرانتز، \(dqA and B or C\(dq به معنای \(dq(A and B) or C\(dq است.
.SS زیررشته (Substring)
.sp
عملگر زیررشته \fBsubstring(value, start, length)\fP مقادیر مثبت و منفی را برای موقعیت آغازین و طول می‌پذیرد. برای \fBstart\fP، مقدار 0 بایت نخست در رشته است در حالی که \-1 آخرین بایت است. اگر نقطه آغاز بیرون از رشته اصلی باشد، یک رشته خالی بازگردانده می‌شود. \fBlength\fP تعداد بایت‌های مورد نظر برای استخراج است. یک مقدار منفی به معنای شمارش به سمت ابتدای رشته است اما بایتی را که توسط \fBstart\fP مشخص شده شامل نمی‌شود\&. مقدار ویژه \fBall\fP به معنای بازگرداندن تمامی بایت‌ها از نقطه آغاز تا انتهای رشته است. اگر طول بیشتر از بخش باقی‌مانده رشته باشد، کل بخش باقی‌مانده بازگردانده می‌شود. ذکر چند مثال می‌تواند مفید باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
substring(\(aqfoobar\(aq, 0, 6) == \(aqfoobar\(aq
substring(\(aqfoobar\(aq, 3, 3) == \(aqbar\(aq
substring(\(aqfoobar\(aq, 3, all) == \(aqbar\(aq
substring(\(aqfoobar\(aq, 1, 4) == \(aqooba\(aq
substring(\(aqfoobar\(aq, \-5, 4) == \(aqooba\(aq
substring(\(aqfoobar\(aq, \-1, \-3) == \(aqoba\(aq
substring(\(aqfoobar\(aq, 4, \-2) == \(aqob\(aq
substring(\(aqfoobar\(aq, 10, 2) == \(aq\(aq
.EE
.UNINDENT
.UNINDENT
.SS الحاق (Concat)
.sp
تابع \fBconcat(string1, string2)\fP حاصل الحاق دو آرگومان خود را برمی‌گرداند. برای نمونه:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
concat(\(aqfoo\(aq, \(aqbar\(aq) == \(aqfoobar\(aq
.EE
.UNINDENT
.UNINDENT
.sp
برای راحتی کاربر، نگارش 1.9.8 از Kea یک نسخه عملگر شرکت‌پذیر از تابع concat اضافه کرده است. برای نمونه:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(aqabc\(aq + \(aqdef\(aq + \(aqghi\(aq + \(aqjkl\(aq + \(aq...\(aq
.EE
.UNINDENT
.UNINDENT
.sp
هم‌ارز است با:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
concat(concat(concat(concat(\(aqabc\(aq, \(aqdef\(aq), \(aqghi\(aq), \(aqjkl\(aq), \(aq...\(aq)
.EE
.UNINDENT
.UNINDENT
.sp
یا:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
concat(\(aqabc\(aq, concat(\(aqdef\(aq, concat(\(aqghi\(aq, concat(\(aqjkl\(aq, \(aq...\(aq))))
.EE
.UNINDENT
.UNINDENT
.sp
یا:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(aqabcdefghijkl...\(aq
.EE
.UNINDENT
.UNINDENT
.SS تفکیک (Split)
.sp
عملگر تفکیک \fBsplit(value, delimiters, field\-number)\fP فهرستی از نویسه‌ها را به عنوان جداکننده (delimiters) و یک شماره فیلد مثبت از فیلد مورد نظر پس از تقسیم مقدار به فیلدهای جداشده توسط جداکننده‌ها می‌پذیرد. جداکننده‌های مجاور ادغام و فشرده نمی‌شوند، بلکه منجر به یک رشته خالی برای آن شماره فیلد خواهند شد. اگر value یک رشته خالی باشد، خروجی یک رشته خالی خواهد بود. اگر فهرست delimiters خالی باشد، خروجی همان مقدار اولیه خواهد بود. اگر field\-number کمتر از یک یا بیشتر از تعداد فیلدها باشد، خروجی رشته‌ای خالی خواهد بود. در ادامه چند مثال آورده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
split (\(aqone.two..four\(aq, \(aq.\(aq, 1) == \(aqone\(aq
split (\(aqone.two..four\(aq, \(aq.\(aq, 2) == \(aqtwo\(aq
split (\(aqone.two..four\(aq, \(aq.\(aq, 3) == \(aq\(aq
split (\(aqone.two..four\(aq, \(aq.\(aq, 4) == \(aqfour\(aq
split (\(aqone.two..four\(aq, \(aq.\(aq, 5) == \(aq\(aq
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
برای استفاده از نویسه‌ای با گریز (escape) دشوار به عنوان جداکننده، از مقدار هگزادسیمال ASCII آن استفاده کنید. برای نمونه، جداسازی با \fBsingle quote\fP با استفاده از \fB0x27\fP:
\fBsplit(option[39].text, 0x27, 1)\fP
.UNINDENT
.UNINDENT
.SS شرط (Ifelse)
.sp
تابع \fBifelse(cond, iftrue, ifelse)\fP مقدار شاخه \fBiftrue\fP یا \fBifelse\fP را با توجه به شرط بولی \fBcond\fP برمی‌گرداند\&. برای نمونه:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ifelse(option[230].exists, option[230].hex, \(aqnone\(aq)
.EE
.UNINDENT
.UNINDENT.SS Hexstring
.sp
تابع \fBhexstring(binary, separator)\fP مقدار دودویی (binary) را به صورت نمایه‌ی رشته هگزادسیمال آن بازمی‌گرداند: جفت‌هایی از ارقام هگزادسیمال که با جداکننده از هم جدا شده‌اند، مانند \fB\(aq:\(aq\fP، \fB\(aq\-\(aq\fP، \fB\(aq\(aq\fP (جداکننده خالی).
.INDENT 0.0
.INDENT 3.5
.sp
.EX
hexstring(pkt4.mac, \(aq:\(aq)
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
عبارت مربوط به هر کلاس با دریافت هر بسته پردازش و اجرا می‌شود. در صورتی که عبارت‌ها بیش از اندازه پیچیده باشند، زمان لازم برای اجرای آن‌ها ممکن است عملکرد سرور را تحت تأثیر قرار دهد. مدیران سیستمی که به عبارت‌های پیچیده یا زمان‌بر نیاز دارند باید نوشتن یک قلاب \%<#\:hooks-libraries> را برای انجام کارهای لازم مد نظر قرار دهند.
.UNINDENT
.UNINDENT
.SS پیکربندی کلاس‌ها (Configuring Classes)
.INDENT 0.0
.TP
.B تعریف یک کلاس کلاینت می‌تواند شامل مشخصه‌های زیر باشد:
.INDENT 7.0
.IP \(bu 2
پارامتر \fBname\fP اجباری است و باید میان تمامی کلاس‌ها یکتا باشد.
.IP \(bu 2
عبارت \fBtest\fP اجباری نیست و نشان‌دهنده رشته‌ای حاوی عبارت منطقی مورد استفاده برای تعیین عضویت در کلاس است. کل عبارت در علامت نقل‌قول جفتی (\fB\(dq\fP) قرار می‌گیرد. نتیجه باید به یک مقدار بولی (\fBtrue\fP یا \fBfalse\fP) ارزیابی شود.
.IP \(bu 2
عبارت \fBtemplate\-test\fP اجباری نیست و نشان‌دهنده رشته‌ای حاوی عبارت منطقی مورد استفاده برای تولید یک کلاس انشعابی (spawning class) است. کل عبارت در علامت نقل‌قول جفتی (\fB\(dq\fP) قرار می‌گیرد. نتیجه باید به یک مقدار رشته‌ای ارزیابی شود که بخش متغیرِ نام کلاس انشعاب‌یافته (spawned class) را نشان می‌دهد. اگر رشته حاصل خالی باشد، هیچ کلاس انشعابی تولید نمی‌شود. کلاس انشعاب‌یافته حاصل دارای قالب نام تولیدشده به این صورت خواهد بود:
\fBSPAWN_<template\-class\-name>_<evaluated\-value>\fP\&.
پس از ارزیابی کلاس‌ها و تولید کلاس انشعاب‌یافته، نام کلاس الگوی متناظر نیز با بسته پیوند می‌یابد. گزینه‌ای (Option) که در یک کلاس انشعاب‌یافته مشخص شده باشد بر همان گزینه در صورت تنظیم در کلاس الگوی آن، ارجحیت خواهد داشت.
.IP \(bu 2
فهرست \fBoption\-data\fP اجباری نیست و شامل گزینه‌هایی است که باید به اعضای این کلاس اختصاص داده شوند. در مورد یک کلاس الگو، این گزینه‌ها به کلاس انشعاب‌یافتهٔ تولیدشده اختصاص می‌یابند.
.IP \(bu 2
فهرست \fBoption\-def\fP اجباری نیست و برای تعریف گزینه‌های سفارشی به کار می‌رود.
.IP \(bu 2
مشخصه \fBonly\-if\-required\fP با \fBonly\-in\-additional\-list\fP جایگزین شده و اکنون منسوخ است. این مقدار برای مدتی به عنوان ورودی پذیرفته می‌شود تا به کاربران اجازه مهاجرت داده شود، اما در نهایت پشتیبانی از آن متوقف خواهد شد.
.IP \(bu 2
پرچم \fBonly\-in\-additional\-list\fP اجباری نیست؛ هنگامی که مقدار آن روی \fBfalse\fP (پیش‌فرض) تنظیم شود، عضویت در طول دسته‌بندی تعیین شده و برای نمونه جهت انتخاب زیرشبکه در دسترس است. هنگامی که مقدار روی \fBtrue\fP تنظیم شود، عضویت تنها در صورتی ارزیابی می‌شود که کلاس در فهرست \fBevaluate\-additional\-classes\fP وجود داشته باشد و تنها برای پیکربندی گزینه‌ها قابل استفاده خواهد بود.
.IP \(bu 2
مشخصه \fBuser\-context\fP اجباری نیست و نشان‌دهنده یک نگاشت با داده‌های تعریف‌شده توسط کاربر و احتمالاً گزینه‌های پیکربندی برای کتابخانه‌های قلاب (hook libraries) است.
.IP \(bu 2
پارامتر \fBnext\-server\fP اجباری نیست و فیلد \fBsiaddr\fP را در بسته‌های مرتبط با این کلاس پیکربندی می‌کند. این پارامتر تنها در DHCPv4 کاربرد دارد.
.IP \(bu 2
مشخصه \fBserver\-hostname\fP اجباری نیست و فیلد \fBsname\fP را در بسته‌های مرتبط با این کلاس پیکربندی می‌کند. این مشخصه تنها در DHCPv4 کاربرد دارد.
.IP \(bu 2
مشخصه \fBboot\-file\-name\fP اجباری نیست و فیلد \fBfile\fP را در بسته‌های مرتبط با این کلاس پیکربندی می‌کند. این مشخصه تنها در DHCPv4 کاربرد دارد.
.IP \(bu 2
مشخصه‌های \fBvalid\-lifetime\fP، \fBmin\-valid\-lifetime\fP و \fBmax\-valid\-lifetime\fP اجباری نیستند و فیلدهای طول عمر معتبر را برای این کلاس کلاینت پیکربندی می‌کنند.
.IP \(bu 2
مشخصه‌های \fBpreferred\-lifetime\fP، \fBmin\-preferred\-lifetime\fP و \fBmax\-preferred\-lifetime\fP اجباری نیستند و فیلدهای طول عمر ترجیحی را برای این کلاس کلاینت پیکربندی می‌کنند. این مشخصه‌ها تنها در DHCPv6 کاربرد دارند.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
\fBtest\fP و \fBtemplate\-test\fP در تعریف یک کلاس کلاینت مانعة‌الجمع هستند. از یکی از آن‌ها استفاده کنید، یا از هیچ‌کدام، اما نه هر دو. در صورت ارائه هر دو، پیکربندی رد می‌شود.
.UNINDENT
.UNINDENT
.sp
در مثال زیر، کلاسی به نام \fBClient_foo\fP تعریف شده است. این کلاس شامل تمام کلاینت‌هایی است که شناسه کلاینت (گزینه ۶۱) آن‌ها با رشته \fBfoo\fP آغاز می‌شود. به اعضای این کلاس، 192.0.2.1 و 192.0.2.2 به عنوان کارگزارهای نام دامنه اختصاص خواهد یافت.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqclient\-classes\(dq: [
        {
            \(dqname\(dq: \(dqClient_foo\(dq,
            \(dqtest\(dq: \(dqsubstring(option[61].hex,0,3) == \(aqfoo\(aq\(dq,
            \(dqoption\-data\(dq: [
                {
                    \(dqname\(dq: \(dqdomain\-name\-servers\(dq,
                    \(dqcode\(dq: 6,
                    \(dqspace\(dq: \(dqdhcp4\(dq,
                    \(dqcsv\-format\(dq: true,
                    \(dqdata\(dq: \(dq192.0.2.1, 192.0.2.2\(dq
                }
            ]
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
مثال بعدی تعریف یک کلاس کلاینت با نام \(dqClient_enterprise\(dq را برای استفاده توسط سرور DHCPv6 نشان می‌دهد. این کلاس شامل تمام کلاینت‌هایی است که شناسه کلاینت آن‌ها با رشته هگزادسیمال مشخص‌شده آغاز می‌شود، که نشان‌دهنده یک DUID بر اساس شناسه سازمانی \fB0x0002AABBCCDD\fP است. به اعضای این کلاس، 2001:db8:0::1 و 2001:db8:2::1 به عنوان کارگزارهای نام دامنه اختصاص داده خواهد شد.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqclient\-classes\(dq: [
        {
            \(dqname\(dq: \(dqClient_enterprise\(dq,
            \(dqtest\(dq: \(dqsubstring(option[1].hex,0,6) == 0x0002AABBCCDD\(dq,
            \(dqoption\-data\(dq: [
                {
                    \(dqname\(dq: \(dqdns\-servers\(dq,
                    \(dqcode\(dq: 23,
                    \(dqspace\(dq: \(dqdhcp6\(dq,
                    \(dqcsv\-format\(dq: true,
                    \(dqdata\(dq: \(dq2001:db8:0::1, 2001:db8:2::1\(dq
                }
            ]
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
همچنین این امکان وجود دارد که هر دو عملوند چپ و راست عبارت ارزیابی‌شده در زمان اجرا پردازش شوند. عبارت‌های مربوط به بسته‌ها می‌توانند به هر تعداد مورد نیاز در عبارت ظاهر شوند؛ هیچ محدودیتی وجود ندارد. با این حال، هر نشانه (token) تأثیر اندکی بر عملکرد دارد و عبارت‌های بیش از اندازه پیچیده ممکن است باعث ایجاد گلوگاه شوند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqclient\-classes\(dq: [
        {
            \(dqname\(dq: \(dqInfrastructure\(dq,
            \(dqtest\(dq: \(dqoption[82].option[2].hex == pkt4.mac\(dq,
            ...
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT.SS کلاس‌های الگو (Template Classes)
.sp
پارامتر \fBtemplate\-test\fP مشخص می‌کند که کلاس مربوطه یک کلاس الگو است.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqclient\-classes\(dq: [
        {
            \(dqname\(dq: \(dqClient\-ID\(dq,
            \(dqtemplate\-test\(dq: \(dqsubstring(option[61].hex,0,3)\(dq,
            ...
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر بسته DHCPv4 دریافت‌شده حاوی option 61 باشد، سه بایت اول نشان‌دهنده مقدار \fBfoo\fP در ASCII خواهد بود و کلاس ایجادشده (spawned) از نام \fBSPAWN_Client\-ID_foo\fP استفاده می‌کند.
هر دو کلاس \fBSPAWN_Client\-ID_foo\fP و \fBClient\-ID\fP به بسته منتسب می‌شوند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
کلاس‌های الگو همچنین می‌توانند برای ایجاد کلاس‌هایی استفاده شوند که با کلاس‌های عادی (regular) مطابقت دارند و بدین‌ترتیب عملاً کلاس عادی را به بسته منتسب می‌کنند.
برای دستیابی به این هدف، کلاس عادی نیز باید شامل بخش ثابتِ نام کلاس ایجادشده باشد:
.sp
\fBSPAWN_<template\-class\-name\-used\-to\-activate\-this\-regular\-class>_<evaluated\-value\-filtering\-this\-regular\-class>\fP
.UNINDENT
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqclient\-classes\(dq: [
        {
            \(dqname\(dq: \(dqSPAWN_Client\-ID_foobar\(dq,
            \(dqtest\(dq: \(dqsubstring(option[1].hex,0,6) == 0x0002AABBCCDD\(dq,
            ...
        },
        {
            \(dqname\(dq: \(dqClient\-ID\(dq,
            \(dqtemplate\-test\(dq: \(dqsubstring(option[1].hex,0,6)\(dq,
            ...
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر بسته DHCPv6 دریافت‌شده حاوی option 1 (شناسه کلاینت) با مقدار هگزادسیمال \fB0x0002AABBCCDD\fP باشد، کلاس \fBSPAWN_Client\-ID_foobar\fP به بسته منتسب می‌شود. علاوه بر این، اگر شش بایت اول نمایانگر مقدار \fBfoobar\fP در ASCII باشد، کلاس ایجادشده از نام \fBSPAWN_Client\-ID_foobar\fP استفاده کرده و عملاً کلاس عادی را به بسته منتسب می‌نماید. در این حالت دوم، هر دو کلاس \fBSPAWN_Client\-ID_foobar\fP و \fBClient\-ID\fP به بسته منتسب می‌شوند.
عبارت \fBtest\fP در کلاس عادی \fBSPAWN_Client\-ID_foobar\fP اجباری نیست و می‌تواند حذف شود، اما در اینجا با یک عبارت تطبیق متفاوت صرفاً با هدف مثال به کار رفته است.
.sp
معمولاً عبارت‌های \fBtest\fP و \fBtemplate\-test\fP پیش از انتخاب زیرشبکه (subnet) ارزیابی می‌شوند، اما در برخی موارد ارزیابی آن‌ها در مراحل بعد، زمانی که subnet، شبکه مشترک (shared network) یا poolها مشخص شده‌اند ولی پردازش گزینه‌های خروجی (output\-option processing) هنوز انجام نشده است، مفید خواهد بود. برای این منظور، پرچم \fBonly\-in\-additional\-list\fP که به‌طور پیش‌فرض \fBfalse\fP است، اجازه می‌دهد عبارت \fBtest\fP یا عبارت \fBtemplate\-test\fP تنها در صورتی ارزیابی شوند که به‌واسطه حضور کلاس در فهرست \fBevaluate\-additional\-classes\fP متعلق به pool، subnet یا shared network انتخاب‌شده درخواست شده باشند.
.sp
فهرست \fBevaluate\-additional\-classes\fP که برای دامنه‌های pool، subnet و shared\-network معتبر است، کلاس‌هایی را مشخص می‌کند که در دور دوم ارزیابی و پیش از پردازش گزینه‌های خروجی بررسی می‌شوند. این فهرست با همان اولویت داده‌های گزینه (option data) ساخته می‌شود؛ یعنی یک داده گزینه در subnet نسبت به مورد مشابه در shared network اولویت دارد. یک کلاس اضافی در subnet، پیش از کلاسی در shared network اضافه می‌شود. این سازوکار با پرچم \fBonly\-in\-additional\-list\fP مرتبط است، اما اجباری نیست که این پرچم حتماً روی \fBtrue\fP تنظیم شده باشد\&.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
عبارت \fBtemplate\-test\fP همچنین می‌تواند برای فیلتر کردن کلاس‌های ایجادشده به کار رود، به‌طوری که با استفاده از دستور \fBifelse\fP این کلاس‌ها فقط در صورت نیاز ساخته شوند.
.UNINDENT
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqclient\-classes\(dq: [
        {
            \(dqname\(dq: \(dqClient\-ID\(dq,
            \(dqtemplate\-test\(dq: \(dqifelse(substring(option[61].hex,4,3) == \(aqfoo\(aq, substring(option[12].hex,0,12), \(aq\(aq)\(dq,
            ...
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
کلاس‌های الگو را می‌توان برای پیکربندی محدودیت‌ها (limits) به کار برد که دقیقاً مانند گزینه‌ها، به کلاس ایجادشده منتسب می‌شوند. این امر امکان پیکربندی محدودیت‌هایی را فراهم می‌سازد که بر تمام بسته‌های منتسب به کلاسی که در زمان اجرا (runtime) بر اساس عبارت \fBtemplate\-test\fP در کلاس الگوی والد ایجاد شده است، اعمال شوند. برای توضیحات دقیق‌تر درباره نحوه پیکربندی محدودیت‌ها با استفاده از کتابخانه قلاب limits، به Configuration \%<#\:hooks-limits-configuration>\& مراجعه کنید.
برای مثال، با استفاده از پیکربندی زیر، بسته‌های DHCPv6 ورودی (ingress) که دارای مقادیر شناسه کلاینت (در قالبی که توسط ارزیاب Kea بیان می‌شود) \fBfoobar\fP و \fBfoofoo\fP باشند، هر دو مشمول همان سقف ۶۰ بسته در روز می‌شوند، در حالی که بسته‌های دیگر که سه هگزاست (hextet) اول آن‌ها مقداری غیر از \fBfoo\fP دارد، در سطل‌های مجزای محدودسازی نرخ (rate\-limiting buckets) قرار می‌گیرند.
.UNINDENT
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqclient\-classes\(dq: [
        {
            \(dqname\(dq: \(dqClient\-ID\(dq,
            \(dqtemplate\-test\(dq: \(dqsubstring(option[1].hex,0,3)\(dq,
            \(dquser\-context\(dq : {
                \(dqlimits\(dq: {
                    \(dqrate\-limit\(dq: \(dq60 packets per day\(dq
                }
            },
            ...
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT.SS استفاده از رزروهای ایستای میزبان در کلاس‌بندی
.sp
کلاس‌ها می‌توانند با استفاده از روش‌های شرح‌داده‌شده در «رزرو کلاس‌های کلاینت در DHCPv4» \%<#\:reservation4-client-classes> و «رزرو کلاس‌های کلاینت در DHCPv6» \%<#\:reservation6-client-classes>\& به صورت ایستا به کلاینت‌ها اختصاص یابند.
.sp
رزروهای میزبان در سطح زیرشبکه (subnet)، پس از انتخاب زیرشبکه جستجو می‌شوند.
رزروهای سراسری میزبان (global) به طور پیش‌فرض در همان زمان جستجو می‌شوند، اما
پارامتر \fBearly\-global\-reservations\-lookup\fP امکان تغییر این رفتار را
برای جستجوی آن‌ها پیش از انتخاب زیرشبکه فراهم می‌کند.
.sp
انتخاب استخر (pool) پس از تمام جستجوهای رزرو میزبان انجام می‌شود.
.SS پیکربندی زیرشبکه‌ها با اطلاعات کلاس
.sp
در موارد خاص، محدود کردن دسترسی به برخی زیرشبکه‌ها تنها به کلاینت‌هایی که متعلق به یک کلاس مشخص هستند، با استفاده از پارامتر \fBclient\-classes\fP هنگام تعریف زیرشبکه سودمند است. این پارامتر می‌تواند برای تعیین فهرستی از یک یا چند کلاس به کار رود که کلاینت‌ها به منظور استفاده از زیرشبکه باید متعلق به آن‌ها باشند. این سازوکار را می‌توان به عنوان «محافظ کلاس» (class guard) برای زیرشبکه در نظر گرفت، یا به عبارت دیگر، زیرشبکه توسط یک کلاس کلاینت محافظت می‌شود.
.sp
فرض کنید سرور به بخشی از شبکه متصل است که از پیشوند 192.0.2.0/24 استفاده می‌کند. مدیر آن شبکه تصمیم گرفته است که نشانی‌های بازه 192.0.2.10 تا 192.0.2.20 توسط سرور DHCPv4 مدیریت شوند. تنها کلاینت‌های متعلق به کلاس کلاینت \fBClient_foo\fP مجاز به استفاده از این زیرشبکه هستند. چنین پیکربندی‌ای را می‌توان به روش زیر انجام داد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqclient\-classes\(dq: [
        {
            \(dqname\(dq: \(dqClient_foo\(dq,
            \(dqtest\(dq: \(dqsubstring(option[61].hex,0,3) == \(aqfoo\(aq\(dq,
            \(dqoption\-data\(dq: [
                {
                    \(dqname\(dq: \(dqdomain\-name\-servers\(dq,
                    \(dqcode\(dq: 6,
                    \(dqspace\(dq: \(dqdhcp4\(dq,
                    \(dqcsv\-format\(dq: true,
                    \(dqdata\(dq: \(dq192.0.2.1, 192.0.2.2\(dq
                }
            ]
        },
        ...
    ],
    \(dqsubnet4\(dq: [
        {
            \(dqid\(dq: 1,
            \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
            \(dqpools\(dq: [ { \(dqpool\(dq: \(dq192.0.2.10 \- 192.0.2.20\(dq } ],
            \(dqclient\-classes\(dq: [ \(dqClient_foo\(dq ]
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
مثال زیر نحوه محدود کردن دسترسی به یک زیرشبکه DHCPv6 را نشان می‌دهد. این پیکربندی، استفاده از نشانی‌های بازه 2001:db8:1::1 تا 2001:db8:1::FFFF را به اعضای کلاس \(dqClient_enterprise\(dq محدود می‌کند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqclient\-classes\(dq: [
        {
            \(dqname\(dq: \(dqClient_enterprise\(dq,
            \(dqtest\(dq: \(dqsubstring(option[1].hex,0,6) == 0x0002AABBCCDD\(dq,
            \(dqoption\-data\(dq: [
                {
                    \(dqname\(dq: \(dqdns\-servers\(dq,
                    \(dqcode\(dq: 23,
                    \(dqspace\(dq: \(dqdhcp6\(dq,
                    \(dqcsv\-format\(dq: true,
                    \(dqdata\(dq: \(dq2001:db8:0::1, 2001:db8:2::1\(dq
                }
            ]
        },
        ...
    ],
    \(dqsubnet6\(dq: [
        {
            \(dqid\(dq: 1,
            \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
            \(dqpools\(dq: [ { \(dqpool\(dq: \(dq2001:db8:1::\-2001:db8:1::ffff\(dq } ],
            \(dqclient\-classes\(dq: \(dqClient_enterprise\(dq
        }
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.SS پیکربندی استخرها با اطلاعات کلاس
.sp
مشابه زیرشبکه‌ها، در موارد خاص دسترسی به برخی استخرهای نشانی یا پیشوند باید تنها به کلاینت‌هایی محدود شود که دست‌کم به یکی از کلاس‌های مشخص‌شده در فهرست تعلق دارند؛ این کار با استفاده از پارامتر \fBclient\-classes\fP هنگام تعریف استخر انجام می‌گیرد. این موضوع را می‌توان به عنوان «محافظ کلاس» (class guard) برای استخر در نظر گرفت، یا به عبارت دیگر، استخر توسط یک کلاس کلاینت محافظت می‌شود.
.sp
فرض کنید سرور به بخشی از شبکه متصل است که از پیشوند 192.0.2.0/24 استفاده می‌کند. مدیر آن شبکه تصمیم گرفته است که نشانی‌های بازه 192.0.2.10 تا 192.0.2.20 توسط سرور DHCPv4 مدیریت شوند. تنها کلاینت‌های متعلق به کلاس کلاینت \fBClient_foo\fP مجاز به استفاده از این استخر هستند. چنین پیکربندی‌ای را می‌توان به روش زیر انجام داد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqclient\-classes\(dq: [
        {
            \(dqname\(dq: \(dqClient_foo\(dq,
            \(dqtest\(dq: \(dqsubstring(option[61].hex,0,3) == \(aqfoo\(aq\(dq,
            \(dqoption\-data\(dq: [
                {
                    \(dqname\(dq: \(dqdomain\-name\-servers\(dq,
                    \(dqcode\(dq: 6,
                    \(dqspace\(dq: \(dqdhcp4\(dq,
                    \(dqcsv\-format\(dq: true,
                    \(dqdata\(dq: \(dq192.0.2.1, 192.0.2.2\(dq
                }
            ]
        },
        ...
    ],
    \(dqsubnet4\(dq: [
        {
            \(dqid\(dq: 1,
            \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
            \(dqpools\(dq: [
                {
                    \(dqpool\(dq: \(dq192.0.2.10 \- 192.0.2.20\(dq,
                    \(dqclient\-classes\(dq: [ \(dqClient_foo\(dq ]
                }
            ]
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
مثال زیر نحوه محدود کردن دسترسی به یک استخر نشانی را نشان می‌دهد. این پیکربندی، استفاده از نشانی‌های بازه 2001:db8:1::1 تا 2001:db8:1::FFFF را به اعضای کلاس \(dqClient_enterprise\(dq محدود می‌کند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqclient\-classes\(dq: [
        {
            \(dqname\(dq: \(dqClient_enterprise_\(dq,
            \(dqtest\(dq: \(dqsubstring(option[1].hex,0,6) == 0x0002AABBCCDD\(dq,
            \(dqoption\-data\(dq: [
                {
                    \(dqname\(dq: \(dqdns\-servers\(dq,
                    \(dqcode\(dq: 23,
                    \(dqspace\(dq: \(dqdhcp6\(dq,
                    \(dqcsv\-format\(dq: true,
                    \(dqdata\(dq: \(dq2001:db8:0::1, 2001:db8:2::1\(dq
                }
            ]
        },
        ...
    ],
    \(dqsubnet6\(dq: [
        {
            \(dqid\(dq: 1,

            \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,

            \(dqpools\(dq: [
                {
                    \(dqpool\(dq: \(dq2001:db8:1::\-2001:db8:1::ffff\(dq,
                    \(dqclient\-classes\(dq: [ \(dqClient_foo\(dq ]
                }
            ]
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT.SS "اولویت کلاس‌ها (Class Priority)"
.sp
کلاس‌های کلاینت در Kea از ترتیبی که در پیکربندی مشخص شده‌اند پیروی می‌کنند (در مقایسه با ترتیب الفبایی). کلاس‌های اضافی به ترتیبِ pool، سپس subnet و سپس shared\-network، و در هر محدوده (scope) بر اساس ترتیبی که در \fBevaluate\-additional\-classes\fP ظاهر می‌شوند، مرتب می‌گردند.
.sp
هنگام تعیین اینکه کدام اطلاعات client\-class (شامل گزینه‌ها، طول‌عمر اجاره‌ها، یا مقادیر فیلد DHCPv4) بخشی از تعاریف کلاس هستند که باید در پاسخ گنجانده شوند، کارساز اجتماعِ گزینه‌های تمام کلاس‌های انتساب‌یافته را بررسی می‌کند. اگر دو یا چند کلاس شامل اطلاعات کلاس یکسانی باشند، مقدار اولین کلاسِ انتساب‌یافته استفاده می‌شود. \fBALL\fP همیشه اولین کلاس است، یعنی کلاسی با بالاترین اولویت، و کلاس‌های منطبقِ الزامی (required) در انتها قرار دارند، بنابراین کمترین اولویت را دارند.
.sp
گزینه‌های تعریف‌شده در کلاس‌ها بر هر گزینه سراسری (global) اولویت داشته و جایگزین آن می‌شوند، و به نوبه خود توسط گزینه‌های تعریف‌شده برای یک subnet، shared network، pool یا reservation جداگانه لغو و بازنویسی (override) می‌شوند.
.sp
از سوی دیگر، طول‌عمر اجاره‌ها و مقادیر فیلدهای DHCPv4 تعریف‌شده در محدوده کلاس، بر هر مقدار تعریف‌شده به‌صورت سراسری، در محدوده subnet یا در محدوده shared\-network اولویت دارند و جایگزین آن‌ها می‌شوند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
از آنجا که ارزیابی اضافی پس از تخصیص اجاره رخ می‌دهد، پارامترهایی که در غیر این صورت بر طول‌عمر اجاره تأثیر می‌گذاشتند (مانند \fBvalid\-lifetime\fP و \fBoffer\-lifetime\fP) هنگامی که در کلاسی مشخص شوند که \fBonly\-in\-additional\-list\fP را نیز برابر با true قرار داده است، هیچ تأثیری نخواهند داشت.
.UNINDENT
.UNINDENT
.sp
به عنوان مثال، تصور کنید یک بسته ورودی با دو کلاس مطابقت دارد. کلاس \fBfoo\fP مقادیری برای یک سرور NTP (گزینه 42 در DHCPv4) و یک سرور SMTP (گزینه 69 در DHCPv4) تعریف می‌کند، در حالی که کلاس \fBbar\fP مقادیری برای یک سرور NTP و یک سرور POP3 (گزینه 70 در DHCPv4) تعریف می‌کند. کارساز سه گزینه \- یعنی NTP، SMTP و POP3 \- را بررسی کرده و هر کدام را که کلاینت درخواست کرده باشد بازمی‌گرداند. از آنجا که سرور NTP دو بار تعریف شده است، کارساز فقط یکی از مقادیر را برای پاسخ انتخاب می‌کند؛ کلاسی که مقدار از آن گرفته می‌شود طبق توضیحات بندهای قبلی تعیین می‌گردد.
.SS "برچسب‌گذاری کلاسی گزینه‌ها (Option Class\-Tagging)"
.sp
برچسب‌گذاری کلاسی گزینه‌ها (Option class\-tagging) اجازه می‌دهد تا مقدار یک گزینه بر اساس عضویت کلاینت در کلاس، به‌صورت مشروط بر پاسخ اعمال شود. تأثیر آن مشابه استفاده از یک بلوک if در ISC DHCP برای گنجاندن شرطی گزینه‌ها در یک محدوده مشخص است. برچسب‌گذاری کلاسی با مشخص کردن فهرستی از یک یا چند نام کلاس در مدخل \fBclient\-classes\fP مربوط به گزینه انجام می‌شود.
.sp
حالتی را در نظر بگیرید که در آن اعضای یک کلاس معین به مقداری یکسان برای یک گزینه، اما مقداری مختص به زیرشبکه (subnet\-specific) برای گزینه‌ای دیگر نیاز دارند. مثال زیر نشان می‌دهد که چگونه از برچسب‌گذاری کلاسی استفاده شده تا به کلاینت‌های متعلق به \(dqGROUP1\(dq یک مقدار مختص زیرشبکه برای گزینه \(dqbar\(dq اختصاص داده شود، در حالی که به تمام اعضای \(dqGROUP1\(dq همان مقدار یکسان برای گزینه \(dqfoo\(dq داده می‌شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqclient\-classes\(dq: [
    {
        \(dqname\(dq: \(dqGROUP1\(dq,
        \(dqtest\(dq:\(dqsubstring(option[123].hex,0,4) == \(aqONE\(aq\(dq,
        \(dqoption\-data\(dq: [{
            \(dqname\(dq: \(dqfoo\(dq,
            \(dqdata\(dq: \(dqsomefile.txt\(dq
        }]
    }],
    \(dqsubnet4\(dq: [
    {
        \(dqid\(dq: 1,
        \(dqsubnet\(dq: \(dq178.16.1.0/24\(dq,
        \(dqoption\-data\(dq: [{
            \(dqclient\-classes\(dq: [\(dqGROUP1\(dq],
            \(dqname\(dq: \(dqbar\(dq,
            \(dqdata\(dq: 123
        }]
    },
    {
        \(dqid\(dq: 2,
        \(dqsubnet\(dq: \(dq178.16.2.0/24\(dq,
        \(dqoption\-data\(dq: [
        {
            \(dqclient\-classes\(dq: [\(dqGROUP1\(dq],
            \(dqname\(dq: \(dqbar\(dq,
            \(dqdata\(dq: 789
        }]
    }]
}
.EE
.UNINDENT
.UNINDENT
.sp
فهرست \fBclient\-classes\fP در مشخصات گزینه در هر محدوده‌ای (scope) مجاز است. برچسب‌گذاری کلاسی گزینه در زمان اضافه شدن گزینه‌ها به پاسخ اعمال می‌شود؛ یعنی پس از تخصیص اجاره و درست قبل از ارسال پاسخ به کلاینت.
.sp
هنگامی که \fBnever\-send\fP برای یک گزینه در هر محدوده‌ای برابر با true باشد، تمام مدخل‌های \fBclient\-classes\fP برای آن گزینه نادیده گرفته می‌شوند. این گزینه گنجانده نخواهد شد.
.sp
هنگامی که \fBalways\-send\fP در هر محدوده‌ای برابر با true باشد، گزینه گنجانده خواهد شد؛ مگر اینکه گزینه تعیین‌شده بر اساس محدوده، فهرست \fBclient\-classes\fP را به‌گونه‌ای مشخص کرده باشد که شامل هیچ‌یک از کلاس‌های کلاینت نباشد.
.sp
در غیر این صورت، گزینه درخواست‌شده توسط کلاینت در صورتی در پاسخ گنجانده می‌شود که یا آن گزینه \fBclient\-classes\fP را مشخص نکرده باشد، یا کلاینت حداقل به یکی از کلاس‌های موجود در \fBclient\-classes\fP تعلق داشته باشد\&.
.sp
هنگامی که برچسب کلاسی یک گزینه مطابقت ندارد، درست مانند این است که گزینه در آن محدوده مشخص نشده باشد. در مثال زیر، گزینه \(dqfoo\(dq هم برای subnet و هم برای pool مشخص شده است. مشخصات pool شامل یک برچسب کلاسی است که این گزینه را به اعضای کلاس \(dqmelon\(dq محدود می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqid\(dq: 100,
    \(dqsubnet\(dq: \(dq178.16.1.0/24\(dq,
    \(dqoption\-data\(dq: [{
        \(dqname\(dq: \(dqfoo\(dq,
        \(dqdata\(dq: 456
    }],
    \(dqpools\(dq: [{
        \(dqpool\(dq: \(dq178.16.1.100 \- 178.16.1.200\(dq,
        \(dqoption\-data\(dq: [{
            \(dqname\(dq: \(dqfoo\(dq,
            \(dqdata\(dq: 123,
            \(dqclient\-classes\(dq : [ \(dqmelon\(dq ]
        }]
    }]
}
.EE
.UNINDENT
.UNINDENT
.sp
کلاینت‌هایی که با کلاس \(dqmelon\(dq مطابقت دارند مقدار 123 را برای گزینه \(dqfoo\(dq خواهند داشت، در حالی که کلاینت‌هایی که با \(dqmelon\(dq مطابقت ندارند مقدار 456 را برای گزینه \(dqfoo\(dq دریافت خواهند کرد.
.sp
می‌توان با مشخص کردن بیش از یک باره یک گزینه با برچسب‌های کلاسی و مقادیر مختلف، به رفتاری مشابه if\-elseif\-else دست یافت. پیکربندی زیر را برای یک زیرشبکه در نظر بگیرید که سه مقدار ممکن را برای گزینه \(dqserver\-str\(dq فراهم می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqid\(dq: 1,
    \(dqsubnet\(dq: \(dq192.0.1.0/24\(dq,
    \(dqpools\(dq: [{ \(dqpool\(dq: \(dq192.0.1.1 \- 192.0.1.255\(dq }],
    \(dqoption\-data\(dq: [{
        \(dqclient\-classes\(dq:  [ \(dqclass\-one\(dq ],
        \(dqname\(dq: \(dqserver\-str\(dq,
        \(dqdata\(dq: \(dqstring.one\(dq
    },{
        \(dqclient\-classes\(dq:  [ \(dqclass\-two\(dq ],
        \(dqname\(dq: \(dqserver\-str\(dq,
        \(dqdata\(dq: \(dqstring.two\(dq
    },{
        \(dqname\(dq: \(dqserver\-str\(dq,
        \(dqdata\(dq: \(dqstring.other\(dq
   }]
}
.EE
.UNINDENT
.UNINDENT
.sp
کلاینت‌های متعلق به \(dqclass\-one\(dq مقدار \(dqstring.one\(dq، کلاینت‌های متعلق به \(dqclass\-two\(dq مقدار \(dqstring.two\(dq، و کلاینت‌هایی که نه به \(dqclass\-one\(dq و نه به \(dqclass\-two\(dq تعلق دارند، مقدار \(dqstring.other\(dq را دریافت خواهند کرد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
ترتیب بررسی گزینه‌ها تضمین‌شده نیست، به جز اینکه گزینه‌ای با فهرست خالی \(dqclient\-classes\(dq در انتها بررسی می‌شود.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
اگرچه مثال‌های بالا برای DHCPv4 هستند، نحو و رفتار برچسب‌گذاری کلاسی برای DHCPv6 نیز یکسان است.
.UNINDENT
.UNINDENT.SS "کلاس‌ها و قلاب‌ها (Classes and Hooks)"
.sp
می‌توان از قلاب‌ها (hooks) برای دسته‌بندی بسته‌ها استفاده کرد. این کار ممکن است زمانی مفید باشد که نوشتن عبارت پیچیده یا زمان‌بر باشد، و بتوان آن را بهتر یا ساده‌تر به‌صورت کد نوشت. هنگامی که قلاب نام کلاس مناسب را به بسته اضافه کرد، بقیهٔ سیستم دسته‌بندی طبق انتظار در انتخاب یک زیرشبکه و گزینه‌ها عمل خواهد کرد. برای توضیحات دربارهٔ قلاب‌ها، به Hook Libraries \%<#\:hooks-libraries> مراجعه کنید؛ برای اطلاعات دربارهٔ پیکربندی کلاس‌ها، به Configuring Classes and Configuring Subnets With Class Information\& مراجعه نمایید.
.SS "اشکال‌زدایی عبارت‌ها (Debugging Expressions)"
.sp
هنگام ساخت عبارت‌های دسته‌بندی، مدیران سیستم ممکن است فعال‌سازی ثبت وقایع (logging) را مفید بیابند؛ برای توضیحات کامل‌تر دربارهٔ امکانات ثبت وقایع، به Logging \%<#\:logging> مراجعه کنید.
.sp
برای فعال‌سازی گزاره‌های اشکال‌زدایی در سیستم دسته‌بندی، سطح اهمیت باید روی \fBDEBUG\fP و سطح اشکال‌زدایی حداقل روی ۵۵ تنظیم شود. لاگرهای اختصاصی عبارتند از \fBkea\-dhcp4.eval\fP و \fBkea\-dhcp6.eval\fP\&.
.sp
برای درک گزاره‌های ثبت وقایع، ضروری است تا حدودی با نحوهٔ ارزیابی عبارت‌ها آشنا باشید؛ برای توضیحات کامل‌تر، به [سند طراحی](\%<https://\:gitlab\:.isc\:.org/\:isc-projects/\:kea/\:-/\:wikis/\:Designs/\:client-classification-design>) مراجعه کنید. به‌طور خلاصه، در طول ارزیابی یک عبارت از دو ساختار استفاده می‌شود: فهرستی از نشانه‌ها (tokens) که نمایانگر عبارت‌ها هستند، و یک پشتهٔ مقادیر (value stack) که نمایانگر مقادیر در حال دستکاری است.
.sp
فهرست نشانه‌ها هنگام پردازش فایل پیکربندی ایجاد می‌شود و بیشتر عبارت‌ها و مقادیر به یک نشانه تبدیل می‌شوند. این فهرست بر اساس نمادگذاری معکوس لهستانی (RPN) سازماندهی شده است. در طول اجرا، فهرست به ترتیب پیمایش می‌شود؛ با اجرای هر نشانه، امکان برداشتن (pop) مقادیر از بالای پشته و در نهایت قرار دادن (push) نتیجه روی بالای پشته فراهم می‌شود. عبارت زیر را در نظر بگیرید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqtest\(dq: \(dqsubstring(option[61].hex,0,3) == \(aqfoo\(aq\(dq,
.EE
.UNINDENT
.UNINDENT
.sp
این دستور به نشانه‌های زیر منجر خواهد شد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
option, number (0), number (3), substring, text (\(aqfoo\(aq), equals
.EE
.UNINDENT
.UNINDENT
.sp
در این مثال، سه نشانهٔ اول صرفاً مقادیر را روی پشته قرار می‌دهند. سپس نشانهٔ substring آن سه مقدار را برمی‌دارد و نتیجه‌ای را محاسبه می‌کند که روی پشته قرار می‌دهد. گزینهٔ text نیز مقداری را روی پشته می‌گذارد، و در نهایت نشانهٔ equals دو نشانهٔ روی پشته را برمی‌دارد و نتیجه‌اش را روی پشته می‌گذارد.
.sp
هنگامی که ثبت وقایع اشکال‌زدایی فعال باشد، با هر بار ارزیابی یک نشانه، پیام گزارشی صادر می‌شود که نشان‌دهندهٔ مقادیر هر شیء برداشته‌شده از پشتهٔ مقادیر و هر شیء قرار‌گرفته روی پشتهٔ مقادیر است.
.sp
مقادیر در صورتی که مشخص باشد دستور از مقادیر متنی استفاده می‌کند به‌صورت متن، یا اگر دستور از مقادیر باینری استفاده کند یا بتواند مقادیر متنی یا باینری را پردازش کند به‌صورت هگزادسیمال نمایش داده می‌شوند. برای عبارت‌هایی که چندین مقدار را از پشته برمی‌دارند، مقادیر به همان ترتیبی که برداشته شده‌اند نمایش می‌یابند. برای اکثر عبارت‌ها این موضوع اهمیتی نخواهد داشت، اما برای عبارت concat مقادیر به ترتیبی معکوس نسبت به ترتیب نوشته‌شدنشان در عبارت نمایش داده می‌شوند.
.sp
فرض کنیم آزمایش زیر در پیکربندی وارد شده است. این مثال از بخش عمدهٔ پیکربندی صرف‌نظر می‌کند تا روی آزمایش تمرکز کند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqtest\(dq: \(dqsubstring(option[61].hex,0,3) == \(aqfoo\(aq\(dq,
.EE
.UNINDENT
.UNINDENT
.sp
ثبت وقایع ممکن است به این شکل باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
2016\-05\-19 13:35:04.163 DEBUG [kea.eval/44478] EVAL_DEBUG_OPTION Pushing option 61 with value 0x666F6F626172
2016\-05\-19 13:35:04.164 DEBUG [kea.eval/44478] EVAL_DEBUG_STRING Pushing text string \(aq0\(aq
2016\-05\-19 13:35:04.165 DEBUG [kea.eval/44478] EVAL_DEBUG_STRING Pushing text string \(aq3\(aq
2016\-05\-19 13:35:04.166 DEBUG [kea.eval/44478] EVAL_DEBUG_SUBSTRING Popping length 3, start 0, string 0x666F6F626172 pushing result 0x666F6F
2016\-05\-19 13:35:04.167 DEBUG [kea.eval/44478] EVAL_DEBUG_STRING Pushing text string \(aqfoo\(aq
2016\-05\-19 13:35:04.168 DEBUG [kea.eval/44478] EVAL_DEBUG_EQUAL Popping 0x666F6F and 0x666F6F pushing result \(aqtrue\(aq
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
در صورت وجود چندین عبارت برای ارزیابی، ثبت وقایع اشکال‌زدایی ممکن است بسیار پرحجم باشد؛ هدف از آن، کمک به ایجاد و اشکال‌زدایی عبارت‌ها است. مدیران سیستم باید پس از اطمینان از عملکرد صحیح عبارت‌ها، ثبت وقایع اشکال‌زدایی را غیرفعال کنند. همچنین کاربران ممکن است ترجیح دهند در زمان اشکال‌زدایی، تنها یک مجموعه از عبارت‌ها را در فایل پیکربندی قرار دهند تا گزاره‌های گزارش محدود شوند. به عنوان مثال، هنگام افزودن یک مجموعه عبارت جدید، ممکن است برای مدیر سیستم راحت‌تر باشد که فایلی از پیکربندی بسازد که تنها شامل عبارت‌های جدید باشد تا زمانی که به درستی کار کنند، و سپس مجموعهٔ جدید را به فایل پیکربندی اصلی اضافه کند.
.UNINDENT
.UNINDENT
.SH "کتابخانه‌های قلاب (HOOK LIBRARIES)"
.SS "مقدمه (Introduction)"
.sp
‏Kea از طریق استفاده از «قلاب‌ها» (\(dqhooks\(dq)، هم انعطاف‌پذیر و هم قابل سفارشی‌سازی است. این ویژگی به Kea اجازه می‌دهد یک یا چند کتابخانه با پیوند پویا (که به نام «کتابخانه‌های قلاب» یا \(dqhook libraries\(dq شناخته می‌شوند) را بارگذاری کرده و توابع درون آن‌ها را در نقاط مختلفی از پردازش خود («نقاط قلاب» یا \(dqhook points\(dq) فراخوانی کند. این توابع هر پردازش سفارشی لازم را انجام می‌دهند.
.sp
مفهوم قلاب‌ها به کد اصلی Kea اجازه می‌دهد تا با انتقال قابلیت‌هایی که فقط برای برخی (نه همه) از کاربران مفید است به کتابخانه‌های خارجی، در حجمی مناسب باقی بماند. کاربرانی که به توابع خاصی نیاز ندارند می‌توانند به‌سادگی از بارگذاری آن کتابخانه‌ها صرف‌نظر کنند.
.sp
کتابخانه‌های قلاب توسط هر یک از فرآیندهای مجزای Kea بارگذاری می‌شوند، نه به صورت کلی توسط کل Kea. این یعنی در میان موارد دیگر، می‌توان یک مجموعه از کتابخانه‌ها را به کارگزار DHCPv4 و مجموعه‌ای دیگر را به کارگزار DHCPv6 اختصاص داد.
.sp
همچنین برای یک فرآیند این امکان وجود دارد که چندین کتابخانه را بارگذاری کند. هنگامی که پردازش به یک نقطهٔ قلاب می‌رسد، Kea توابع کتابخانهٔ قلاب متصل به آن را فراخوانی می‌کند. اگر چندین کتابخانه تابعی را به یک نقطهٔ قلاب مشخص پیوند زده باشند، Kea همهٔ آن‌ها را به ترتیبی که در فایل پیکربندی مشخص شده است فراخوانی می‌کند. این ترتیب ممکن است اهمیت داشته باشد؛ برای جزئیات به مستندات کتابخانه‌ها مراجعه کنید.
.sp
هنگامی که یک فرآیند Kea کتابخانه‌ای را تخلیه (unload) می‌کند، انتظار دارد تابع \fBdlclose\fP تمام نمادهای کتابخانه و همچنین کد آن را از فضای آدرس حذف کند. گرچه بیشتر سیستم‌عامل‌ها تابع \fBdlclose\fP را پیاده‌سازی کرده‌اند، اما این رفتار طبق استاندارد POSIX الزامی نیست و همهٔ سیستم‌ها از آن پشتیبانی نمی‌کنند؛ برای نمونه، کتابخانهٔ musl که به‌طور پیش‌فرض در Alpine Linux استفاده می‌شود، تابع \fBdlclose\fP را به‌صورت بی‌عملیات (no-op) پیاده‌سازی کرده است. در چنین سیستم‌هایی، کتابخانه در عمل در تمام طول عمر فرآیند بارگذاری‌شده باقی می‌ماند، به این معنی که برای به‌روزرسانی کتابخانه‌ها به نسخه‌های جدیدتر، فرآیند باید دوباره راه‌اندازی (restart) شود؛ صرفِ پیکربندی مجدد یا بارگذاری مجدد (reload) فرآیند Kea کافی نخواهد بود.
.sp
بخش‌های بعدی نحوهٔ نصب و پیکربندی کتابخانه‌های قلاب را شرح می‌دهند. کاربرانی که علاقه‌مند به نوشتن کتابخانهٔ قلاب خود هستند می‌توانند اطلاعات لازم را در بخش Hooks Developer\(aqs Guide از راهنمای Kea Developer\(aqs Guide \%<https://\:reports\:.kea\:.isc\:.org/\:dev_guide/\:df/\:d46/\:hooksdgDevelopersGuide\:.html>\& بیابند.
.sp
توجه داشته باشید که برخی از کتابخانه‌ها تحت مجوزهای متفاوتی عرضه می‌شوند.
.sp
همچنین لطفاً توجه داشته باشید که برخی از کتابخانه‌ها ممکن است به وابستگی‌های اضافی و/یا فعال بودن کلیدهای کامپایل خاصی نیاز داشته باشند..SS "نصب بسته‌های قلاب (Hook Packages)"
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
برای جزئیات بیشتر درباره نصب قلاب‌های مشترکین Kea، لطفاً
این مقاله پایگاه دانش را بخوانید: \%<https://\:kb\:.isc\:.org/\:docs/\:aa-01587>\&.
.UNINDENT
.UNINDENT
.sp
بیشتر بسته‌های قلاب اکنون در سورس‌های اصلی Kea گنجانده شده‌اند. نیازی
به انجام کار خاصی برای کامپایل یا نصب آن‌ها نیست، چرا که آن‌ها توسط
روال‌های معمول ساخت و نصب پوشش داده می‌شوند. لطفاً برای یک نمای کلی
از فرآیند نصب، به Installation \%<#\:installation> مراجعه کنید.
.sp
شرکت ISC چندین قلاب اضافی مخصوص مشترکین را در قالب بسته ارائه می‌دهد که
روال نصب مشابهی دارند اما نیازمند چند مرحله بیشتر هستند.
جهت راحتی کاربران، فرآیند نصب قلاب‌های مشترکین در این بخش شرح داده شده است.
.sp
1. بسته را دانلود کنید؛ دستورالعمل‌های دقیق در مقاله پایگاه دانش بالا
ارائه شده است. بسته فایلی با نامی مشابه
\fBkea\-subscriber\-|release|.tar.xz\fP\& خواهد بود.
.sp
2. مدیران سیستمی که از زمان نصب اولیه Kea، سورس‌های نسخه مربوط به
بسته متن‌باز Kea را روی سیستم خود دارند، باید این مرحله را نادیده بگیرند. در غیر این صورت،
سورس Kea را از tarball اصلی دانلود شده استخراج کنید. برای مثال، با دانلود Kea 3.2.0،
باید یک tarball به نام \fBkea\-|release|.tar.xz\fP روی سیستم موجود باشد.
این tarball را استخراج کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ tar \-Jxvf kea\-3.2.0\&.tar.xz
.EE
.UNINDENT
.UNINDENT
.sp
این کار tarball را در زیردایرکتوری \fBkea\-|release|\fP از دایرکتوری
کاری فعلی استخراج می‌کند.
.sp
3. بسته tarball قلاب‌های مشترکین Kea را در همان دایرکتوری که سورس
اصلی Kea در آن قرار دارد استخراج کنید. هنگامی که Kea 3.2.0 در زیردایرکتوری \fBkea\-|release|\fP
استخراج شد و tarball مشترکین Kea در دایرکتوری فعلی قرار گرفت، مراحل
زیر tarball مشترکین را در مکان مناسب استخراج خواهند کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ cd kea\-3.2.0
$ tar \-Jxvf ../kea\-subscriber\-3.2.0\&.tar.xz
.EE
.UNINDENT
.UNINDENT
.sp
توجه داشته باشید که استخراج بسته مشترکین Kea، فایل‌ها را در
دایرکتوری با نام \fBpremium\fP\& قرار می‌دهد. صرف‌نظر از نام بسته، این
دایرکتوری همیشه \fBpremium\fP\& نامیده می‌شود.
.INDENT 0.0
.IP 4. 3
فرآیند ساخت (build) را آماده‌سازی کنید. مطمئن شوید که \fBmeson\fP و \fBninja\fP روی
سیستم شما نصب شده‌اند. بخش اول خروجی باید چیزی شبیه به این باشد:
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ meson setup build
.EE
.UNINDENT
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Package:
  Name:               kea
  Version:            3.2.0
  Extended version:   3.2.0 (tarball)
  Version type:       development
  OS Family:          Linux

  Prefix:             /opt/kea
  Hooks directory:    /opt/kea/lib/kea/hooks
  Premium hooks:      yes
.EE
.UNINDENT
.UNINDENT
.INDENT 0.0
.IP 6. 3
کامپایل Kea.
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ meson compile \-C build
.EE
.UNINDENT
.UNINDENT
.INDENT 0.0
.IP 7. 3
نصب سورس‌های Kea همراه با قلاب‌ها:
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ sudo make install
.EE
.UNINDENT
.UNINDENT
.sp
مکان نصب کتابخانه‌های قلاب به این بستگی دارد که آیا پارامتر
\fB\-\-prefix\fP در مرحله \fBmeson setup\fP مشخص شده بود یا خیر. در غیر این صورت،
مکان پیش‌فرض \fB/usr/local/lib/kea/hooks\fP\& خواهد بود. نصب صحیح
کتابخانه‌ها را می‌توان با این دستور بررسی کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ ls \-l /usr/local/lib/kea/hooks/*.so
/usr/local/lib/kea/hooks/libddns_gss_tsig.so
/usr/local/lib/kea/hooks/libdhcp_bootp.so
/usr/local/lib/kea/hooks/libdhcp_class_cmds.so
/usr/local/lib/kea/hooks/libdhcp_ddns_tuning.so
/usr/local/lib/kea/hooks/libdhcp_flex_id.so
/usr/local/lib/kea/hooks/libdhcp_flex_option.so
/usr/local/lib/kea/hooks/libdhcp_ha.so
/usr/local/lib/kea/hooks/libdhcp_host_cache.so
/usr/local/lib/kea/hooks/libdhcp_host_cmds.so
/usr/local/lib/kea/hooks/libdhcp_lease_cmds.so
/usr/local/lib/kea/hooks/libdhcp_lease_query.so
/usr/local/lib/kea/hooks/libdhcp_legal_log.so
/usr/local/lib/kea/hooks/libdhcp_limits.so
/usr/local/lib/kea/hooks/libdhcp_mysql.so
/usr/local/lib/kea/hooks/libdhcp_perfmon.so
/usr/local/lib/kea/hooks/libdhcp_pgsql.so
/usr/local/lib/kea/hooks/libdhcp_ping_check.so
/usr/local/lib/kea/hooks/libdhcp_radius.so
/usr/local/lib/kea/hooks/libdhcp_run_script.so
/usr/local/lib/kea/hooks/libdhcp_stat_cmds.so
/usr/local/lib/kea/hooks/libdhcp_subnet_cmds.so
.EE
.UNINDENT
.UNINDENT
.sp
همراه با کتابخانه‌های مشترکین زیر:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
/usr/local/lib/kea/hooks/libdhcp_cb_cmds.so
/usr/local/lib/kea/hooks/libdhcp_rbac.so
.EE
.UNINDENT
.UNINDENT
.sp
فهرست دقیق بازگردانده شده به بسته‌های نصب‌شده بستگی دارد. اگر
دایرکتوری از طریق \fB\-\-prefix\fP مشخص شده باشد، کتابخانه‌های قلاب در
\fB{prefix directory}/lib/kea/hooks\fP\& قرار خواهند گرفت..SS پیکربندی کتابخانه‌های هوک (Configuring Hook Libraries)
.sp
کتابخانه‌های هوک (hook libraries) برای یک فرآیند مشخص با استفاده از کلمهٔ کلیدی
\fBhooks\-libraries\fP در پیکربندی آن فرآیند پیکربندی می‌شوند. (توجه
داشته باشید که واژهٔ \(dqhooks\(dq جمع است.) مقدار این کلمهٔ کلیدی آرایه‌ای
از ساختارهای نگاشت (map structures) است، که هر ساختار متناظر با یک کتابخانهٔ هوک می‌باشد. برای
نمونه، جهت راه‌اندازی دو کتابخانهٔ هوک برای سرور DHCPv4،
پیکربندی به صورت زیر خواهد بود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqDhcp6\(dq: {
        \(dqhooks\-libraries\(dq: [
            {
                \(dqlibrary\(dq: \(dqfirst_custom_hooks_example.so\(dq
            },
            {
                \(dqlibrary\(dq: \(dqsecond_custom_hooks_example.so\(dq,
                \(dqparameters\(dq: {
                    \(dqmail\(dq: \(dqspam@example.com\(dq,
                    \(dqfloor\(dq: 13,
                    \(dqdebug\(dq: false,
                    \(dqusers\(dq: [
                        \(dqalice\(dq,
                        \(dqbob\(dq,
                        \(dqcharlie\(dq
                    ],
                    \(dqlanguages\(dq: {
                        \(dqfrench\(dq: \(dqbonjour\(dq,
                        \(dqklingon\(dq: \(dqyl\(aqel\(dq
                    }
                }
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
کتابخانه‌ها حتی اگر فهرست آن‌ها تغییری نکرده باشد مجدداً بارگذاری می‌شوند،
زیرا ممکن است پارامترهای تعیین‌شده برای کتابخانه (یا فایل‌هایی که آن
پارامترها به آن‌ها اشاره دارند) تغییر کرده باشند.
.UNINDENT
.UNINDENT
.sp
از نسخهٔ Kea 2.7.9، کتابخانه‌های هوک تنها می‌توانند از دایرکتوری پیش‌فرض نصب
که در زمان کامپایل تعیین شده و در گزارش پیکربندی به عنوان
\(dqHooks directory\(dq نشان داده شده است، بارگذاری شوند. این مقدار ممکن است در زمان راه‌اندازی با تنظیم
متغیر محیطی \fBKEA_HOOKS_PATH\fP بر روی مسیر دلخواه بازنویسی شود. اگر مسیری غیر
از این مقدار در یک عنصر \fBlibrary\fP استفاده شود، Kea خطایی صادر کرده و از بارگذاری
کتابخانه خودداری خواهد کرد. برای سهولت در استفاده، عناصر \fBlibrary\fP باید بخش‌های مسیر
را حذف کنند و تنها نام فایل را همان‌طور که در زیر نشان داده شده مشخص نمایند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqDhcp6\(dq: {
        \(dqhooks\-libraries\(dq: [
            {
                \(dqlibrary\(dq: \(dqfirst_custom_hooks_example.so\(dq
            },
            {
                \(dqlibrary\(dq: \(dqsecond_custom_hooks_example.so\(dq
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
پشتیبانی از بخش‌های مسیر در عناصر \fBlibrary\fP از نسخهٔ 2.7.8 منسوخ شده است و
در نهایت حذف خواهد شد.
.UNINDENT
.UNINDENT
.sp
کتابخانه‌ها ممکن است پارامترهای اضافی داشته باشند که اجباری نیستند، به این
معنا که ممکن است کتابخانه‌هایی وجود داشته باشند که نیازی به آن‌ها نداشته باشند. با این حال، برای هر
کتابخانهٔ مشخص اغلب الزامی برای تعیین مجموعه‌ای خاص از
پارامترها وجود دارد. لطفاً برای جزئیات به مستندات هر کتابخانهٔ مجزا
مراجعه کنید. در مثال بالا، کتابخانهٔ نخست (\fB/opt/first_custom_hooks_example.so\fP)
هیچ پارامتری ندارد. کتابخانهٔ دوم (\fB/opt/local/second_custom_hooks_example.so\fP)
دارای پنج پارامتر است: تعیین mail (پارامتر رشته‌ای)، floor (پارامتر عددی صحیح)،
debug (پارامتر بولی)، لیست‌ها (فهرستی از رشته‌ها)، و نگاشت‌ها (شامل رشته‌ها).
در صورت پشتیبانی کتابخانه، می‌توان از پارامترهای تو در تو استفاده کرد. این موضوع به تفصیل
در بخش Hooks Developer\(aqs Guide از راهنمای توسعه‌دهندهٔ Kea توضیح داده شده است \%<https://\:reports\:.kea\:.isc\:.org/\:dev_guide/\:df/\:d46/\:hooksdgDevelopersGuide\:.html>\&.
.sp
برخی هوک‌ها برای تنظیم پارامترها از بافتار کاربر (user context) استفاده می‌کنند. بخش User Contexts in Hooks را ببینید\&.
.sp
نکات:
.INDENT 0.0
.IP \(bu 2
مسیر کامل هر کتابخانه باید مشخص شود.
.IP \(bu 2
همان‌طور که در بالا اشاره شد، ترتیبی که هوک‌ها فراخوانی می‌شوند ممکن است حائز اهمیت باشد؛
برای جزئیات به مستندات مربوط به هر کتابخانه مراجعه کنید.
.IP \(bu 2
یک فهرست خالی همان اثری را دارد که گویی عنصر پیکربندی \fBhooks\-libraries\fP
به‌طور کلی حذف شده است.
.sp
\fBنکته:\fP
.INDENT 2.0
.INDENT 3.5
یک حالت وجود دارد که این موضوع در آن صادق نیست: اگر Kea با پیکربندی‌ای
در حال اجرا باشد که شامل یک مورد \fBhooks\-libraries\fP است، و آن
مورد حذف شده و پیکربندی مجدداً بارگذاری شود، این حذف نادیده
گرفته شده و کتابخانه‌ها بارگذاری‌شده باقی می‌مانند. به عنوان یک راهکار موقت،
به جای حذف مورد \fBhooks\-libraries\fP، آن را به یک
فهرست خالی تغییر دهید.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
در حال حاضر، تنها فرآیندهای \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> و \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> از
کتابخانه‌های هوک پشتیبانی می‌کنند..SS ترتیب پیکربندی (Order of Configuration):
.sp
بسیار مهم است توجه داشته باشید که ترتیب پیکربندی کتابخانه‌های قلاب (hook libraries)، تعیین‌کنندهٔ ترتیب اجرای فراخوانی‌های آن‌ها (callouts) در مواردی است که بیش از یک کتابخانهٔ قلاب، یک فراخوانی یکسان را پیاده‌سازی کرده باشند. برای مثال، جهت استفاده از کتابخانهٔ قلاب Flexible Identifier (که Flex ID نیز نامیده می‌شود) برای فرمول‌بندی شناسه‌های کلاینت در کنار کتابخانهٔ قلاب High Availability (HA) جهت توازن بار HA، ضروری است که کتابخانهٔ Flex ID ابتدا در بخش \fBhooks\-libraries\fP سرور مشخص شود. این کار تضمین می‌کند که شناسهٔ کلاینت پیش از آن‌که کتابخانهٔ HA از آن برای توازن بار استفاده کند، توسط کتابخانهٔ Flex ID شکل گرفته باشد. به همین ترتیب، بهتر است کتابخانهٔ Forensic Logging در انتها مشخص شود تا اطمینان حاصل گردد پیش از بارگذاری آن، سایر قلاب‌های نصب‌شده سهم خود را در پردازش بسته اعمال کرده‌اند.
.SS زمینه‌های کاربر در قلاب‌ها (User Contexts in Hooks)
.sp
کتابخانه‌های قلاب می‌توانند پارامترهای پیکربندی مختص به خود را داشته باشند، که در صورت اعمال پارامتر بر کل کتابخانه، بسیار مناسب و کاربردی است. با این حال، گاهی اوقات سودمند است که موجودیت‌های پیکربندی خاصی را با داده‌های پیکربندی اضافی گسترش داد. اینجاست که مفهوم زمینه‌های کاربر (user contexts) مطرح می‌شود. مدیر سیستم می‌تواند مجموعه‌ای اختیاری از داده‌ها را تعریف کرده و تا زمانی که داده‌ها به صورت یک نگاشت (map) در قالب JSON مشخص شده باشند، آن‌ها را به ساختارهای Kea متصل کند. به‌ویژه، تعریف فیلدهایی از نوع اعداد صحیح (integers)، رشته‌ها (strings)، مقادیر بولی (boolean)، فهرست‌ها (lists) یا نگاشت‌ها (maps) امکان‌پذیر است. همچنین می‌توان ساختارهای تو‌در‌تو با هر میزان پیچیدگی را تعریف نمود. Kea به‌خودی‌خود از این داده‌ها استفاده نمی‌کند؛ بلکه صرفاً آن‌ها را ذخیره کرده و در دسترس کتابخانه‌های قلاب قرار می‌دهد.
.sp
کاربرد دیگر برای user contexts می‌تواند ذخیره‌سازی یادداشت‌ها و سایر اطلاعاتی باشد که توسط Kea نگهداری خواهند شد. کامنت‌های معمولی هنگام بارگذاری پیکربندی نادیده گرفته و دور ریخته می‌شوند، اما زمینه‌های کاربر حفظ می‌گردند. این ویژگی برای مواردی مفید است که مدیران سیستم بخواهند یادداشت‌هایشان برای مثال در طول عملیات‌های \fBconfig\-set\fP \%<#\:std-isccmd-config-set> یا \fBconfig\-get\fP \%<#\:std-isccmd-config-get> پابرجا بمانند.
.sp
اگر زمینهٔ کاربر در یک بافت خاص پشتیبانی شود، تجزیه‌کننده (parser) مدخل‌های \(dqcomment\(dq را به زمینهٔ کاربر حاوی یک مدخل \(dqcomment\(dq تبدیل می‌کند.
.sp
زمینهٔ کاربر می‌تواند پیکربندی مربوط به چندین قلاب و یادداشت‌ها را به‌طور هم‌زمان در خود ذخیره کند.
.sp
برخی از قلاب‌ها از زمینهٔ کاربر برای پیکربندی‌هایی استفاده می‌کنند که می‌توان بدون نیاز به راه‌اندازی مجدد سرور، آن‌ها را به‌سادگی ویرایش کرد.
.sp
قلاب DDNS Tuning از user context برای پیکربندی رفتار به ازای هر زیرشبکه (per\-subnet) استفاده می‌کند. نمونه‌ای از این پیکربندی در ادامه آمده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqsubnet4\(dq: [{
    \(dqid\(dq: 1,
    \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
    \(dqpools\(dq: [{
        \(dqpool\(dq: \(dq192.0.2.10 \- 192.0.2.20\(dq
    } ],
    \(dquser\-context\(dq: {
        \(dqddns\-tuning\(dq: {
            \(dqhostname\-expr\(dq: \(dq\(aqguest\-\(aq+int8totext(substring(pkt4.yiaddr, 0,1))+\(aq\-\(aq \e
                                      +int8totext(substring(pkt4.yiaddr, 1,2))+\(aq\-\(aq \e
                                      +int8totext(substring(pkt4.yiaddr, 2,3))+\(aq\-\(aq \e
                                      +int8totext(substring(pkt4.yiaddr, 3,4))\(dq
        },
        \(dqlast\-modified\(dq: \(dq2017\-09\-04 13:32\(dq,
        \(dqphones\(dq: [ \(dqx1234\(dq, \(dqx2345\(dq ],
        \(dqdevices\-registered\(dq: 42,
        \(dqbilling\(dq: false
    }
}]
.EE
.UNINDENT
.UNINDENT
.sp
قلاب Limits از user\-context در کلاس‌ها و زیرشبکه‌ها برای تنظیم پارامترها استفاده می‌کند. برای نمونه:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp6\(dq: {
    \(dqclient\-classes\(dq: [
      {
        \(dqname\(dq: \(dqgold\(dq,
        \(dquser\-context\(dq: {
          \(dqlimits\(dq: {
            \(dqaddress\-limit\(dq: 2,
            \(dqprefix\-limit\(dq: 1,
            \(dqrate\-limit\(dq: \(dq1000 packets per second\(dq
          }
        }
      }
    ],
    \(dqhooks\-libraries\(dq: [
      {
        \(dqlibrary\(dq: \(dqlibdhcp_limits.so\(dq
      }
    ],
    \(dqsubnet6\(dq: [
      {
        \(dqid\(dq: 1,
        \(dqpools\(dq: [
          {
            \(dqpool\(dq: \(dq2001:db8::/64\(dq
          }
        ],
        \(dqsubnet\(dq: \(dq2001:db8::/64\(dq,
        \(dquser\-context\(dq: {
          \(dqlimits\(dq: {
            \(dqaddress\-limit\(dq: 4,
            \(dqprefix\-limit\(dq: 2,
            \(dqrate\-limit\(dq: \(dq10 packets per minute\(dq
          }
        }
      }
    ]
  }
}
.EE
.UNINDENT
.UNINDENT
.SS محدودیت بسته‌های متوقف‌شده (Parked\-Packet Limit)
.sp
سرورهای Kea شامل سازوکاری هستند که به موجب آن، پاسخ به یک بستهٔ کلاینت می‌تواند تا زمان اتمام کار کتابخانهٔ قلاب معلق نگه داشته شود. ما از این فرایند با عنوان \(dqپارک کردن بسته\(dq یاد می‌کنیم. هنگامی که ادامهٔ کار آماده شد، سرور پاسخ را از حالت پارک خارج کرده و پردازش را ادامه می‌دهد.
.sp
یک پارامتر سراسری به نام \fBparked\-packet\-limit\fP وجود دارد که می‌توان از آن برای محدود کردن تعداد پاسخ‌هایی که در هر لحظه می‌توانند پارک شوند، استفاده کرد. این پارامتر به عنوان روشی برای مدیریت ازدحام عمل کرده و زمانی که حجم پرس‌وجوهای کلاینت‌ها از توان پاسخ‌گویی سرور پیشی می‌گیرد، از غرق شدن سرور زیر بار ترافیک جلوگیری می‌کند. هنگامی که این حد نصاب تکمیل شود، سرور یک لاگ ثبت کرده و هر پاسخ جدیدی را تا زمان خالی شدن ظرفیت پارک دور می‌اندازد (drop می‌کند).
.sp
به‌طور کلی، مقادیر کوچک‌تر برای محدودیت ظرفیت پارک احتمالاً باعث ریزش (drop) بیشتر اما با زمان پاسخ‌گویی کوتاه‌تر می‌شوند؛ مقادیر بزرگ‌تر احتمالاً به ریزش کمتر اما با زمان پاسخ‌گویی طولانی‌تر می‌انجامند. در حال حاضر، مقدار پیش‌فرض برای \fBparked\-packet\-limit\fP برابر با 256 است.
.sp
\fBهشدار:\fP
.INDENT 0.0
.INDENT 3.5
استفاده از یک مقدار بسیار کوچک ممکن است منجر به نرخ ریزش (drop rate) غیرضروری و بالایی شود، در حالی که استفاده از مقداری بیش از حد بزرگ می‌تواند زمان پاسخ‌گویی را تا حدی طولانی کند که عملاً دیگر کارآمد نباشد. مقدار 0 با اینکه مجاز است، این محدودیت را به‌کلی غیرفعال می‌کند، اما این کار اکیداً نهی می‌شود؛ چرا که ممکن است منجر به عدم پاسخ‌گویی سرورهای Kea به کلاینت‌ها شود. انتخاب بهترین مقدار بسیار وابسته به شرایط هر سامانه است؛ توصیه می‌کنیم کاربران در ابتدا آن را روی مقدار پیش‌فرض 256 بگذارند و نحوهٔ رفتار سیستم را در طول زمان تحت شرایط مختلف بار ترافیکی مشاهده کنند.
.UNINDENT
.UNINDENT
.sp
در ادامه مثالی از پارامتر سراسری آورده شده است که به همراه \fBlibdhcp_ha.so\fP استفاده شده است.
این تنظیم، تعداد بسته‌های متوقف‌شدهٔ هم‌زمان را به 128 کاهش می‌دهد.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp6\(dq: {
    \(dqparked\-packet\-limit\(dq: 128
    \(dqhooks\-libraries\(dq: [
      {
        \(dqlibrary\(dq: \(dqlibdhcp_lease_cmds.so\(dq
      },
      {
        \(dqlibrary\(dq: \(dqlibdhcp_ha.so\(dq,
        \(dqparameters\(dq: {
          \(dqhigh\-availability\(dq: [
            {
              \(dqmode\(dq: \(dqhot\-standby\(dq,
              \(dqpeers\(dq: [
                {
                  \(dqname\(dq: \(dqserver1\(dq,
                  \(dqrole\(dq: \(dqprimary\(dq,
                  \(dqurl\(dq: \(dqhttp://127.0.0.1:8080/\(dq
                },
                {
                  \(dqname\(dq: \(dqserver2\(dq,
                  \(dqrole\(dq: \(dqstandby\(dq,
                  \(dqurl\(dq: \(dqhttp://127.0.0.1:8088/\(dq
                }
              ],
              \(dqthis\-server\-name\(dq: \(dqserver1\(dq
            }
          ]
        }
      }
    ]
  }
}
.EE
.UNINDENT
.UNINDENT.SS کتابخانه‌های هوک دردسترس
.sp
همان‌طور که در بالا توضیح داده شد، سازوکار هوک روشی را برای سفارشی‌سازی یک کارساز Kea بدون تغییر در کد اصلی (core) فراهم می‌کند. ISC تصمیم گرفته است با بهره‌گیری از این ویژگی، قابلیت‌هایی را ارائه دهد که ممکن است تنها برای زیرمجموعه‌ای از کاربران Kea مفید باشند. بدین منظور، ISC چندین کتابخانهٔ هوک ایجاد کرده است که در بخش‌های بعدی به آن‌ها پرداخته می‌شود.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
از نسخهٔ Kea 3.0.0، بیشتر این کتابخانه‌ها بدون هزینه همراه با کد پایهٔ متن‌باز در دسترس هستند؛ تعداد اندکی تنها برای سازمان‌هایی در دسترس هستند که از طریق قراردادهای پشتیبانی غیررایگان ISC در توسعهٔ Kea مشارکت دارند. پشتیبانی غیررایگان شامل کمک‌های مهندسی حرفه‌ای، اعلان‌های امنیتی زودهنگام، مشارکت در برنامه‌ریزی نقشهٔ راه ISC و مزایای بسیار دیگر است، و هم‌زمان به پایداری Kea در بلندمدت کمک می‌کند. ISC شرکت‌ها و سازمان‌ها را تشویق می‌کند تا خرید قرارداد پشتیبانی را مد نظر قرار دهند؛ اطلاعات بیشتر را می‌توان با تکمیل فرم در \%<https://\:www\:.isc\:.org/\:contact>\& به دست آورد.
.UNINDENT
.UNINDENT
.sp
جدول زیر فهرستی از کتابخانه‌های هوک را که در حال حاضر از سوی ISC ارائه می‌شوند نشان می‌دهد. توجه به این که کدام کتابخانه‌ها می‌توانند توسط کدام فرایندهای Kea بارگذاری شوند دارای اهمیت است. اگر کتابخانه‌ای از سوی ISC مطابق انتظار کار نکرد، لطفاً مطمئن شوید که بر اساس جدول زیر توسط فرایند صحیح بارگذاری شده باشد.
.SS فهرست کتابخانه‌های هوک دردسترس
.TS
box center;
l|l|l.
T{
نام
T}	T{
دسترسی
T}	T{
توضیحات
T}
_
T{
BOOTP
T}	T{
متن‌باز
Kea
T}	T{
این کتابخانهٔ هوک، پشتیبانی از BOOTP را مطابق با تعریف
RFC 1497 اضافه می‌کند. این کتابخانه درخواست‌های دریافت‌شدهٔ BOOTP را شناسایی می‌کند:
این درخواست‌ها به بسته‌های DHCPREQUEST ترجمه می‌شوند، در کلاس
کلاینت BOOTP قرار می‌گیرند و اجاره‌هایی با طول عمر نامحدود دریافت می‌کنند.
T}
_
T{
Class Commands
T}	T{
متن‌باز
Kea
T}	T{
این کتابخانهٔ هوک امکان افزودن، به‌روزرسانی، حذف و
واکشی کلاس‌های کلاینتِ پیکربندی‌شدهٔ DHCP را بدون نیاز به
راه‌اندازی مجدد کارساز DHCP فراهم می‌کند.
T}
_
T{
Configuration Backend Commands
T}	T{
مشتریان پشتیبانی
ISC
T}	T{
این کتابخانهٔ
هوک مجموعه‌ای از دستورها را برای مدیریت اطلاعات
پیکربندی Kea در یک پایگاه داده پیاده‌سازی می‌کند. این کتابخانه فقط در کنار
یکی از پیاده‌سازی‌های پشتیبانی‌شدهٔ Configuration Backend قابل استفاده است.
T}
_
T{
DDNS Tuning
T}	T{
متن‌باز
Kea
T}	T{
این کتابخانهٔ هوک رفتارهای سفارشی مربوط به به‌روزرسانی‌های Dynamic
DNS را بر پایهٔ هر کلاینت اضافه می‌کند. ویژگی اصلی آن امکان
محاسبهٔ نام میزبان مورداستفاده برای DNS با
استفاده از یک عبارت است.
T}
_
T{
Flexible Identifier
T}	T{
متن‌باز
Kea
T}	T{
نرم‌افزار Kea روشی را برای مدیریت رزروهای میزبان فراهم می‌کند
که شامل آدرس‌ها، پیشوندها، گزینه‌ها، کلاس‌های کلاینت و سایر
ویژگی‌ها است. رزرو می‌تواند بر اساس آدرس سخت‌افزاری،
DUID، circuit\-id یا client\-id در DHCPv4 و بر اساس
آدرس سخت‌افزاری یا DUID در DHCPv6 انجام شود. با این حال،
گاهی سناریوهایی رخ می‌دهد که در آن‌ها رزرو پیچیده‌تر است،
مانند استفاده از گزینه‌هایی غیر از موارد یادشده، استفاده از بخش‌هایی
از گزینه‌هایی خاص، یا شاید استفاده از ترکیبی از چندین گزینه و فیلد
برای شناسایی یکتای یک کلاینت. این سناریوها توسط برنامهٔ هوک
Flexible Identifier پوشش داده می‌شوند. این برنامه امکان تعریف یک
عبارت، مشابه عبارت مورد استفاده در کلاس‌بندی کلاینت، مانند
\fBsubstring(relay6[0].option[37],0,6)\fP\& را می‌دهد. هر بستهٔ
ورودی بر اساس آن عبارت ارزیابی شده و سپس مقدار آن در پایگاه
دادهٔ رزروها جستجو می‌شود.
T}
_
T{
Flexible Option
T}	T{
متن‌باز
Kea
T}	T{
این کتابخانه هوک‌هایی را ارائه می‌دهد که مقادیر گزینه را به‌جای
مقادیر ایستای پیکربندی‌شده محاسبه می‌کنند. یک عبارت بر روی
بستهٔ پرس‌وجو ارزیابی می‌شود. عملیات‌های تعریف‌شدهٔ add، supersede و
remove با استفاده از نتیجهٔ ارزیابی، پیش از ارسال روی بستهٔ
پاسخ اعمال می‌شوند.
T}
_
T{
Forensic Logging
T}	T{
متن‌باز
Kea
T}	T{
این کتابخانه هوک‌هایی را فراهم می‌آورد که گزارشی تفصیلی از
تخصیص‌ها و تمدیدهای اجاره را در مجموعه‌ای از فایل‌های لاگ ثبت
می‌کنند. در بسیاری از حوزه‌های قضایی، شرکت‌ها \(en به‌ویژه ISPها \(en موظف‌اند
اطلاعات مربوط به آدرس‌هایی را که به کلاینت‌های DHCP اجاره داده‌اند ثبت کنند.
این کتابخانه برای کمک به این الزام طراحی شده است. اگر اطلاعاتی
که ثبت می‌کند کافی باشد، می‌توان مستقیماً از آن استفاده کرد. اگر حوزه‌ای
قضایی نیازمند ذخیرهٔ مجموعهٔ متفاوتی از اطلاعات باشد، می‌توان
از آن به عنوان الگو یا مثالی برای ایجاد هوک‌های لاگ‌گیری سفارشی
استفاده نمود. در Kea 1.9.8، پارامترهای بیشتری اضافه شد تا انعطاف‌پذیری
بیشتری در رابطه با این که چه اطلاعاتی باید ثبت شوند به کاربران داده شود.
T}
_
T{
GSS\-TSIG
T}	T{
متن‌باز
Kea
T}	T{
این کتابخانهٔ هوک پشتیبانی از استفاده از GSS\-TSIG برای امضای به‌روزرسانی‌های
DNS را به کارساز Kea D2 (kea\-dhcp\-ddns) اضافه می‌کند.
T}
_
T{
High Availability
T}	T{
متن‌باز
Kea
T}	T{
خطر از دسترس خارج شدن سرویس DHCP را می‌توان با برپایی
یک جفت کارساز DHCP در یک شبکه به حداقل رساند. دو حالت
عملیاتی پشتیبانی می‌شود. حالت اول موازنهٔ بار نام دارد و گاهی
از آن با عنوان \(dqactive\-active\(dq یاد می‌شود. هر کارساز می‌تواند
گروه‌های منتخبی از کلاینت‌ها را در این شبکه مدیریت کند، یا در صورتی
که تشخیص دهد همتایش از دسترس خارج شده، تمام کلاینت‌ها را مدیریت
نماید. همچنین می‌توان یک کارساز را برای پاسخگویی به همهٔ کلاینت‌های
DHCP تعیین کرد و کارساز دیگر را در حالت آماده‌باش قرار داد. این
حالت \(dqhot standby\(dq نامیده می‌شود و گاهی به آن \(dqactive\-passive\(dq
می‌گویند. این کارساز تنها زمانی عملکرد DHCP خود را فعال می‌کند که
تشخیص دهد همتایش در دسترس نیست. چنین همکاری‌ای میان کارسازهای
DHCP مستلزم آن است که این کارسازها پیوسته با یکدیگر در ارتباط باشند تا
به‌روزرسانی‌های مربوط به اجاره‌های اختصاص‌یافته را ارسال کنند و به صورت دوره‌ای
عملیاتی بودن همتای خود را بیازمایند. این کتابخانهٔ هوک همچنین امکان
ارسال به‌روزرسانی‌های اجاره را به کارسازهای پشتیبان خارجی فراهم می‌کند
که داشتن یک جایگزین کاملاً به‌روز را بسیار ساده‌تر می‌سازد.
T}
_
T{
Host Cache
T}	T{
متن‌باز
Kea
T}	T{
پاسخ‌دهی برخی از Backendهای پایگاه داده، مانند
RADIUS، ممکن است زمان زیادی ببرد. از آنجا که
Kea به‌طور کلی همگام است، کارایی Backend
مستقیماً بر کارایی DHCP اثر می‌گذارد. برای به حداقل رساندن
افت کارایی، این کتابخانه روشی را برای کَش کردن
پاسخ‌های سایر میزبان‌ها فراهم می‌کند. این شامل کَش منفی نیز
می‌شود، یعنی توانایی به‌خاطرسپاری اینکه هیچ اطلاعات کلاینتی
در پایگاه داده وجود ندارد.
T}
_
T{
Host Commands
T}	T{
متن‌باز
Kea
T}	T{
کارساز Kea روشی برای ذخیرهٔ رزروهای میزبان در یک
پایگاه داده فراهم می‌کند. در بسیاری از استقرارهای بزرگ‌تر، مدیریت
این اطلاعات در زمان اجرای کارساز سودمند است. این کتابخانه
دستورهای مدیریتی را برای افزودن، پرس‌وجو و حذف رزروهای
میزبان به شکلی امن و بدون راه‌اندازی دوبارهٔ کارساز ارائه می‌دهد.
به‌ویژه، پارامترها را اعتبارسنجی می‌کند، بنابراین تلاشی برای درج
داده‌های نادرست، مانند افزودن میزبانی با شناسهٔ متداخل در همان
زیرشبکه، رد خواهد شد. این دستورها از طریق کانال فرمان
(JSON از طریق سوکت‌های UNIX یا HTTP/HTTPS) ارائه می‌شوند،
T}
_
T{
Lease Commands
T}	T{
متن‌باز
Kea
T}	T{
این کتابخانهٔ هوک مجموعه‌ای از دستورها را برای مدیریت
اجاره‌ها ارائه می‌دهد. Kea می‌تواند اطلاعات اجاره را در Backendهای
مختلفی ذخیره کند: memfile، MySQL و PostgreSQL. این کتابخانه
رابطی یکپارچه برای دستکاری اجاره‌ها به روشی هماهنگ و امن
فراهم می‌کند. به‌ویژه، دستکاری اجاره‌های memfile در زمان اجرای
Kea، بررسی درستی تغییرات، بررسی وجود اجاره، و حذف تمام
اجاره‌های متعلق به یک زیرشبکهٔ خاص را امکان‌پذیر می‌کند. همچنین
می‌تواند خطاهای پنهان را شناسایی کند، مانند افزودن اجاره‌ای با
subnet\-id که در پیکربندی وجود ندارد، یا پیکربندی یک اجاره
برای استفاده از آدرسی خارج از زیرشبکه‌ای که باید به آن تعلق
داشته باشد. این کتابخانه مدیریت آسان بسترهای کاربری (user contexts)
مرتبط با اجاره‌ها را ممکن می‌سازد.
T}
_
T{
Leasequery
T}	T{
متن‌باز
Kea
T}	T{
این کتابخانه پشتیبانی از DHCPv4 Leasequery (RFC 4388)،
DHCPv4 Bulk Leasequery (RFC6926)، DHCPv6 Leasequery
(RFC 5007) و DHCPv6 Bulk Leasequery (RFC5460) را اضافه می‌کند.
T}
_
T{
Limits
T}	T{
متن‌باز
Kea
T}	T{
با این کتابخانهٔ هوک، کارسازهای \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> و
\fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> می‌توانند نرخی را که بسته‌ها بر
اساس آن پاسخ دریافت می‌کنند محدود نمایند. این محدودیت می‌تواند
بر پایهٔ هر کلاس کلاینت یا هر زیرشبکه اعمال شود.
T}
_
T{
MySQL Support Library
T}	T{
متن‌باز
Kea
T}	T{
این کتابخانهٔ هوک، پشتیبانی از استفاده از پایگاه(های) دادهٔ
MySQL را برای Backendهای Lease، Host و Configuration در Kea ارائه می‌دهد.
T}
_
T{
PerfMon
T}	T{
متن‌باز
Kea
T}	T{
با این کتابخانهٔ هوک، کارسازهای \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> و
\fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> می‌توانند داده‌های مربوط به کارایی را
رصد و گزارش کنند.
T}
_
T{
Ping Check
T}	T{
متن‌باز
Kea
T}	T{
با این کتابخانهٔ هوک، کارساز \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> می‌تواند
پیش از پیشنهاد آدرس‌های نامزد اجاره به کلاینت‌ها،
بررسی پینگ را روی آن‌ها انجام دهد.
T}
_
T{
PostgreSQL Support Library
T}	T{
متن‌باز
Kea
T}	T{
این کتابخانهٔ هوک، پشتیبانی از استفاده از پایگاه(های) دادهٔ
PostgreSQL را برای Backendهای Lease، Host و Configuration در Kea ارائه می‌دهد.
T}
_
T{
RADIUS
T}	T{
متن‌باز
Kea
T}	T{
کتابخانهٔ هوک RADIUS به Kea اجازه می‌دهد با استفاده از سازوکارهای
access و accounting با کارسازهای RADIUS در ارتباط باشد. سازوکار
access می‌تواند برای کنترل دسترسی، تخصیص آدرس‌های IPv4 یا IPv6
خاصِ رزروشده توسط RADIUS، تخصیص پویای آدرس‌ها از مخزن‌های (pools)
تعیین‌شده توسط RADIUS، یا رد کامل پیام‌های کلاینت استفاده شود.
سازوکار accounting به کارساز RADIUS اجازه می‌دهد فعالیت دستگاه را
در گذر زمان رهگیری کند.
T}
_
T{
RBAC
T}	T{
مشتریان پشتیبانی
ISC
T}	T{
این کتابخانهٔ هوک پشتیبانی از پالایش دستورها بر اساس کنترل دسترسی
نقش‌محور (Role\-Based Access Control) را به کارسازهای Kea
(شامل kea\-dhcp4، kea\-dhcp6 و kea\-dhcp\-ddns) اضافه می‌کند.
T}
_
T{
Run Script
T}	T{
متن‌باز
Kea
T}	T{
این کتابخانهٔ هوک پشتیبانی از اجرای اسکریپت‌های
خارجی را برای نقاط هوک خاص در پردازش بسته‌ها اضافه
می‌کند. چندین متغیر محیطی صادرشده وجود دارند که
در اختیار اسکریپت قرار می‌گیرند.
T}
_
T{
Statistics Commands
T}	T{
متن‌باز
Kea
T}	T{
این کتابخانه دستورهای بیشتری را برای بازیابی
آمارهای دقیق اجارهٔ DHCP، برای کارسازهای Kea DHCP که از
یک پایگاه دادهٔ اجارهٔ مشترک بهره می‌برند، ارائه می‌دهد. این پیکربندی
در استقرارهایی متداول است که به افزونگی سرویس DHCP نیاز دارند
و از یک پایگاه دادهٔ اجارهٔ مشترک برای اجتناب از تکرار داده‌های اجاره
بین کارسازهای DHCP استفاده می‌کنند. این کتابخانهٔ هوک آمارهای
اجاره را برای هر زیرشبکه بازمی‌گرداند.
T}
_
T{
Subnet Commands
T}	T{
متن‌باز
Kea
T}	T{
در استقرارهایی که پیکربندی زیرشبکه باید به طور مکرر به‌روزرسانی
شود، این یک الزام حیاتی است که چنین به‌روزرسانی‌هایی بدون نیاز به
پیکربندی مجددِ کامل یا راه‌اندازی دوبارهٔ کارساز DHCP انجام شوند.
این کتابخانهٔ هوک امکان اعمال تغییرات تدریجی بر پیکربندی زیرشبکه،
مانند افزودن یا حذف یک زیرشبکه را ممکن می‌سازد. همچنین امکان
فهرست کردن تمام زیرشبکه‌های موجود و واکشی اطلاعات دقیق
دربارهٔ یک زیرشبکهٔ انتخاب‌شده را فراهم می‌کند. دستورهای ارائه‌شده توسط
این کتابخانه بر دیگر زیرشبکه‌ها یا پارامترهای پیکربندی که در حال حاضر
توسط کارساز استفاده می‌شوند اثری نمی‌گذارند.
T}
_
T{
User Check
T}	T{
متن‌باز
Kea
T}	T{
فهرست کاربران شناخته‌شده را از یک فایل می‌خواند. به کاربران
ناشناخته، اجاره‌ای از آخرین زیرشبکهٔ تعریف‌شده در فایل پیکربندی
اختصاص داده خواهد شد، برای مثال برای هدایت آن‌ها به یک پورتال
محصور (captive portal). این عملکرد نشان می‌دهد که چگونه می‌توان
از یک منبع خارجی اطلاعات برای اثرگذاری بر موتور تخصیص Kea
استفاده کرد. این هوک بخشی از کد منبع Kea است و در دایرکتوری
\fBsrc/hooks/dhcp/user_chk\fP در دسترس است.
T}
.TE
.sp
سازمان ISC امیدوار است با گذشت زمان، شاهد در دسترس قرار گرفتن کتابخانه‌های
هوک بیشتری باشد که چه به صورت داخلی و چه خارجی توسعه یافته باشند. از آنجا
که این فهرست ممکن است به صورت پویا تغییر کند، در یک صفحهٔ ویکی نگهداری می‌شود
که در \%<https://\:gitlab\:.isc\:.org/\:isc-projects/\:kea/\:-/\:wikis/\:Hooks-Available>\& در دسترس است.
از توسعه‌دهندگان یا دیگر افرادی که از کتابخانه‌های هوک ذکرنشده در آنجا آگاهی
دارند، تقاضا می‌شود یادداشتی به فهرست‌های پستی kea\-users یا kea\-dev جهت
به‌روزرسانی ارسال نمایند. (اطلاعات مربوط به تمام فهرست‌های پستی عمومی ISC را می‌توان
در \%<https://\:www\:.isc\:.org/\:mailinglists>\& یافت.)
.sp
کتابخانه‌های توسعه‌یافته توسط ISC در بخش‌های بعدی با جزئیات شرح داده شده‌اند..SS \fBlibdhcp_bootp.so\fP: پشتیبانی از کلاینت‌های BOOTP
.sp
این کتابخانهٔ قلاب (hook library) پشتیبانی از BOOTP را به همراه افزونه‌های اطلاعات ارائه‌دهنده (vendor\-information extensions)
(RFC 1497 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc1497>) اضافه می‌کند. درخواست‌های دریافتی BOOTP
تشخیص داده شده، با افزودن گزینهٔ \fBdhcp\-message\-type\fP به بسته‌های DHCPREQUEST تبدیل شده
و در کلاس کلاینت \(dqBOOTP\(dq قرار می‌گیرند.
اعضای این کلاس اجاره‌هایی با طول عمر نامحدود دریافت می‌کنند، اما از این کلاس می‌توان
برای محافظت از یک استخر (pool) آدرس نیز استفاده کرد.
.sp
گزینه‌های ویژهٔ DHCP، مانند \fBdhcp\-message\-type\fP، از پاسخ‌های سرور حذف می‌شوند؛
پاسخ‌های کوتاه‌تر از حداقل اندازهٔ BOOTP یعنی ۳۰۰ بایت (octet)، تا این اندازه با داده‌های پرکننده تکمیل می‌شوند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
\fBlibdhcp_bootp.so\fP بخشی از کد متن‌باز است و در دسترس
تمامی کاربران Kea قرار دارد.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این کتابخانه تنها می‌تواند توسط فرایند \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> بارگذاری شود،
زیرا پروتکل BOOTP برای IPv6 وجود ندارد.
.UNINDENT
.UNINDENT
.sp
این کتابخانه مشابه سایر کتابخانه‌های قلاب بارگذاری می‌شود و
هیچ پارامتری دریافت نمی‌کند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqhooks\-libraries\(dq: [
        {   \(dqlibrary\(dq: \(dqlibdhcp_bootp.so\(dq },
        ...
    ]
}
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
رزرو میزبان (host reservation) برای یک کلاینت BOOTP باید از آدرس سخت‌افزاری به عنوان
شناسه استفاده کند (گزینهٔ \fBclient\-id\fP یک گزینهٔ ویژهٔ DHCP است).
.UNINDENT
.UNINDENT
.sp
بسته‌های ورودی BOOTP به کلاس BOOTP اضافه می‌شوند که به مدیران سیستم امکان می‌دهد
کلاینت‌های BOOTP را در استخرهای جداگانه تفکیک کنند. برای مثال:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqclient\-classes\(dq: [
        {
            // The DHCP class is the complement of the BOOTP class
            \(dqname\(dq: \(dqDHCP\(dq,
            \(dqtest\(dq: \(dqnot member(\(aqBOOTP\(aq)\(dq
        }
    ],
    \(dqsubnet4\(dq: [
        {
            \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
            \(dqpools\(dq: [
            {
                // BOOTP clients will be handled here
                \(dqpool\(dq: \(dq192.0.2.200 \- 192.0.2.254\(dq,
                \(dqclient\-classes\(dq: [ \(dqBOOTP\(dq ]
            },
            {
                // Regular DHCP clients will be handled here
                \(dqpool\(dq: \(dq192.0.2.1 \- 192.0.2.199\(dq,
                \(dqclient\-classes\(dq: [ \(dqDHCP\(dq ]
            }],
            ...
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.SS محدودیت‌های قلاب‌های BOOTP
.sp
در حال حاضر کتابخانهٔ BOOTP دارای محدودیت زیر است:
.INDENT 0.0
.IP \(bu 2
پروتکل BOOTP پایه، مطابق با تعریف RFC 951 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc951>، پشتیبانی نمی‌شود. Kea تنها
از BOOTP همراه با افزونه‌های اطلاعات ارائه‌دهنده پشتیبانی می‌کند.
.UNINDENT
.SS \fBlibdhcp_cb_cmds.so\fP: دستورهای بک‌اند پیکربندی
.sp
این کتابخانهٔ قلاب برای مدیریت پیکربندی‌های سرورهای Kea در یک پایگاه‌دادهٔ بک‌اند پیکربندی (configuration backend)
به کار می‌رود. این کتابخانه باید همراه با کتابخانه‌های قلاب CB موجود که APIهای مشترک را برای ایجاد، خواندن،
به‌روزرسانی و حذف (CRUD) اطلاعات پیکربندی در پایگاه‌های دادهٔ مربوطه پیاده‌سازی می‌کنند، استفاده شود.
برای مثال: \fBlibdhcp_mysql.so\fP این API را برای MySQL پیاده‌سازی می‌کند در حالی که \fBlibdhcp_pgsql.so\fP این API
را برای PostgreSQL پیاده‌سازی می‌نماید. برای مدیریت اطلاعات پیکربندی در یک پایگاه‌دادهٔ MySQL، هر دو کتابخانهٔ
\fBlibdhcp_mysql.so\fP و \fBlibdhcp_cb_cmds.so\fP باید توسط سروری که برای مدیریت پیکربندی استفاده می‌شود بارگذاری شوند.
برای مدیریت اطلاعات پیکربندی در یک پایگاه‌دادهٔ PostgreSQL، هر دو کتابخانهٔ
\fBlibdhcp_pgsql.so\fP و \fBlibdhcp_cb_cmds.so\fP باید توسط سروری که برای مدیریت پیکربندی استفاده می‌شود بارگذاری شوند.
.sp
اطلاعات بیشتر دربارهٔ چگونگی پیکربندی کتابخانهٔ قلاب بک‌اند پیکربندی برای
استفاده با یک پایگاه‌دادهٔ MySQL یا PostgreSQL را می‌توان در بخش‌های Configuration Backend in DHCPv4 \%<#\:dhcp4-cb>
و Configuration Backend in DHCPv6 \%<#\:dhcp6-cb> مشاهده کرد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
\fBlibdhcp_cb_cmds.so\fP تنها برای مشتریان ISC دارای قرارداد پشتیبانی تجاری
در دسترس است. برای کسب اطلاعات بیشتر دربارهٔ گزینه‌های اشتراک،
لطفاً فرم موجود در \%<https://\:www\:.isc\:.org/\:contact>\& را تکمیل کنید.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این کتابخانه تنها می‌تواند توسط فرایندهای \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> یا
\fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> بارگذاری شود.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
لطفاً پیش از به‌کارگیری دستورهای شرح داده شده در این بخش، بخش
محدودیت‌ها و هشدارها (Limitations and Warnings) \%<#\:cb-limitations> را مطالعه کنید.
.UNINDENT
.UNINDENT.SS ساختار دستور (Command Structure)
.sp
این کتابخانه از ۵ نوع دستور پشتیبانی می‌کند:
.INDENT 0.0
.IP \(bu 2
\fBdel\fP \- حذف شیء انتخاب‌شده از پایگاه داده، مانند
\fBremote\-global\-parameter4\-del\fP\&.
.IP \(bu 2
\fBget\fP \- واکشی شیء انتخاب‌شده از پایگاه داده، مانند
\fBremote\-subnet4\-get\-by\-id\fP\&.
.IP \(bu 2
\fBget\-all\fP \- واکشی تمام اشیاء یک نوع خاص از
پایگاه داده، مانند \fBremote\-option\-def4\-get\-all\fP\&.
.IP \(bu 2
\fBlist\fP \- فهرست کردن تمام اشیاء یک نوع خاص در پایگاه داده،
مانند \fBremote\-network4\-list\fP؛ این دسته از دستورات در مقایسه
با خروجی \fBget\-all\fP اطلاعات خلاصه‌تری درباره هر شیء برمی‌گردانند\&.
.IP \(bu 2
\fBset\fP \- ایجاد یا جایگزینی شیئی از نوع داده‌شده در
پایگاه داده، مانند \fBremote\-option4\-global\-set\fP\&.
.UNINDENT
.sp
همه انواع دستورات یک نگاشت اختیاری \fBremote\fP را می‌پذیرند که
نمونه پایگاه داده مورد اشاره دستور را مشخص می‌کند. برای مثال:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-subnet4\-list\(dq,
    \(dqarguments\(dq: {
        \(dqremote\(dq: {
            \(dqtype\(dq: \(dqmysql\(dq,
            \(dqhost\(dq: \(dq192.0.2.33\(dq,
            \(dqport\(dq: 3302
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پایگاه داده MySQL را که روی میزبان 192.0.2.33 و درگاه 3302 در حال اجراست برای
واکشی فهرست زیرشبکه‌ها انتخاب می‌کند. تمام پارامترها در آرگومان \fBremote\fP
اختیاری هستند. پارامتر \fBport\fP تنها همراه با \fBhost\fP قابل تعیین
است\&. اگر قرار نیست هیچ گزینه‌ای در پارامتر \fBremote\fP مشخص شود، این
پارامتر باید حذف گردد. در این حالت، سرور از نخستین پشتیبان (backend) فهرست‌شده
در نگاشت \fBconfig\-control\fP در پیکربندی سرورِ دریافت‌کننده دستور استفاده خواهد کرد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
در نگارش کنونی Kea، تنها می‌توان سرور Kea را برای استفاده از یک پشتیبان
پیکربندی واحد تنظیم کرد. به بیان دقیق‌تر، با استفاده از پارامتر \fBconfig\-control\fP
تنها می‌توان سرور Kea را حداکثر به یک پایگاه داده (یا MySQL یا PostgreSQL) متصل
کرد. بنابراین، پارامتر \fBremote\fP می‌تواند در دستورات نادیده گرفته شود و
\fBlibdhcp_cb_cmds.so\fP به‌طور پیش‌فرض از همان تنها پشتیبان موجود استفاده می‌کند.
دستورات نمونه زیر اغلب مقدار \(dqmysql\(dq را برای پارامتر \fBtype\fP نشان می‌دهند؛
در صورتی که از پایگاه داده PostgreSQL استفاده می‌کنید باید فرض شود که این
مقدار \(dqpostgresql\(dq است.
.UNINDENT
.UNINDENT
.SS دستورات کنترلی برای سرورهای DHCP (Control Commands for DHCP Servers)
.sp
این بخش به شرح و ارائه مثال‌هایی از دستورات کنترلی پیاده‌سازی‌شده
توسط \fBlibdhcp_cb_cmds.so\fP برای مدیریت اطلاعات پیکربندی
سرورهای DHCPv4 و DHCPv6 می‌پردازد. بسیاری از این دستورات بین
DHCPv4 و DHCPv6 تقریباً یکسان هستند و تنها در نام دستور با یکدیگر
تفاوت دارند. سایر دستورات تفاوت جزئی در ساختار داده‌های درج‌شده دارند؛
برای مثال، ساختار اطلاعات زیرشبکه IPv4 با زیرشبکه IPv6 متفاوت است.
با این حال، ساختار آرگومان‌های دستورات آن‌ها یکسان است و از این رو
توضیح دادن آن‌ها در کنار یکدیگر منطقی است.
.sp
علاوه بر این، در بخش‌های بعدی هر جا در متن به یک دستور DHCP یا
پارامتر DHCP اشاره شود، به هر دو گونه DHCPv4 و DHCPv6 اشاره دارد.
متن‌های مختص یک نوع سرور خاص، آن‌ها را با عنوان‌های: دستور DHCPv4،
پارامتر DHCPv4، دستور DHCPv6، پارامتر DHCPv6 و غیره مشخص می‌کنند.
.SS متاداده (Metadata)
.sp
پاسخ معمول به دستور \fBget\fP یا \fBlist\fP شامل فهرستی از اشیاء بازگردانده‌شده
(مانند زیرشبکه‌ها) است و هر شیء حاوی نگاشت \fBmetadata\fP با اطلاعاتی
مختص پایگاه داده برای توصیف آن شیء می‌باشد. به عبارت دیگر، متاداده
حاوی هرگونه اطلاعاتی درباره شیء واکشی‌شده است که ممکن است برای مدیر سیستم
مفید باشد اما از دیدگاه سرور DHCP جزئی از مشخصات فنی شیء به شمار نمی‌رود.
در نگارش کنونی Kea، متاداده به \fBserver\-tag\fP محدود شده است\&.
این مقدار، ارتباط شیء با یک سرور خاص یا همه سرورها را مشخص می‌کند.
.sp
در زیر یک نمونه پاسخ برای دستور \fBremote\-network4\-list\fP آمده است
که شامل متاداده می‌باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq1 IPv4 shared network(s) found.\(dq,
    \(dqarguments\(dq: {
        \(dqshared\-networks\(dq: [
            {
                \(dqname\(dq: \(dqlevel3\(dq,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ \(dqall\(dq ]
                }
            }
        ],
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پیاده‌سازی‌های کلاینت نباید فرض کنند که متاداده تنها شامل پارامتر
\fBserver\-tags\fP است. در نگارش‌های آینده انتظار می‌رود این نگاشت با
اطلاعات بیشتری گسترش یابد، از جمله زمان تغییر شیء، پیام ثبت‌شده در لاگ
هنگام آخرین ویرایش و موارد مشابه..SS برچسب‌های کلاس گزینه به‌عنوان کلید (Option Class\-tags as Keys)
.sp
قابلیت برچسب‌گذاری کلاس گزینه (Option Class\-Tagging) \%<#\:option-class-tagging> فهرستی از کلاس‌های کلاینت، \fBclient\-classes\fP، را به مشخصات گزینه‌ها اضافه کرد. بنابراین در هر فهرستی از مشخصات گزینه‌ها (مانند \fIoption\-data\fP)، ممکن است بیش از یک مشخصه برای همان \fBcode\fP و \fBspace\fP وجود داشته باشد، اما با فهرست‌های \fBclient\-classes\fP متفاوت و محتوای داده‌ای گوناگون.
.sp
برای پشتیبانی از این ساختار، Kea افزون بر code و space، از فهرست \fBclient\-classes\fP گزینه نیز جهت شناسایی یکتای هر گزینه استفاده می‌کند. هنگام استفاده از Management API برای تغییر پیکربندی، به‌خاطر داشتن این موضوع مهم است. از نسخهٔ Kea 3.1.1، دستورهایی که یک گزینهٔ منفرد را دریافت، تنظیم یا حذف می‌کنند، علاوه بر پارامترهای \fBcode\fP و \fBspace\fP، یک پارامتر اختیاری \fBclient\-classes\fP را نیز می‌پذیرند.
.sp
اگر پارامتر \fBclient\-classes\fP قید نشود:
.INDENT 0.0
.IP 1. 3
Get \- یکی از n موردی را که با code و space مطابقت دارد واکشی می‌کند. در صورتی که بیش از یک تطابق وجود داشته باشد، این‌که کدام گزینه بازگردانده می‌شود نامشخص است.
.IP 2. 3
Set \- تنها گزینه‌ای را به‌روزرسانی می‌کند که با code و space مطابقت داشته و فهرست client\-classes آن خالی باشد. اگر تطابقی یافت نشود، گزینه ایجاد می‌شود.
.IP 3. 3
Delete \- تمام گزینه‌هایی را که با code و space تطابق دارند، در صورت وجود، حذف می‌کند.
.UNINDENT
.sp
اگر پارامتر \fBclient\-classes\fP مشخص شود:
.INDENT 0.0
.IP 1. 3
Get \- در صورت وجود، گزینه‌ای را که با code، space و client\-classes تطابق دارد واکشی می‌کند.
.IP 2. 3
Set \- فقط گزینه‌ای را به‌روزرسانی می‌کند که با code، space و client\-classes مطابقت داشته باشد. اگر تطابقی یافت نشود، گزینه ایجاد می‌شود.
.IP 3. 3
Delete \- در صورت وجود، فقط گزینه‌ای را حذف می‌کند که با code، space و client\-classes تطابق دارد.
.UNINDENT
.sp
یک فهرست خالی \fBclient\-classes\fP به‌صورت \(aq[  ]\(aq با یا بدون فاصله میان براکت‌ها مشخص می‌شود. هنگام مدیریت فهرست گزینه‌هایی که از برچسب‌گذاری کلاس کلاینت استفاده نمی‌کنند، می‌توان پارامتر \fBclient\-classes\fP را به‌سادگی نادیده گرفت.
.SS دستورهای \fBremote\-server4\-del\fP و \fBremote\-server6\-del\fP (The \fBremote\-server4\-del\fP, \fBremote\-server6\-del\fP Commands)
.sp
این دستور برای حذف اطلاعات یک سرور DHCP انتخاب‌شده از پایگاه‌دادهٔ پیکربندی استفاده می‌شود. سرور با یک برچسب سرور (server tag) یکتا و غیرحساس به بزرگ و کوچکی حروف شناسایی می‌شود. برای مثال:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-server4\-del\(dq,
    \(dqarguments\(dq: {
        \(dqservers\(dq: [
            {
                \(dqserver\-tag\(dq: \(dqserver1\(dq
            }
        ],
        \(dqremote\(dq: {
            \(dqtype\(dq: \(dqpostgresql\(dq
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
در نتیجهٔ این دستور، تمام وابستگی‌های پیکربندی مربوط به سرور تعریف‌شده توسط کاربر با نام \(dqserver1\(dq از پایگاه‌داده حذف می‌شوند، از جمله اطلاعات پیکربندی غیرقابل‌اشتراک، مانند پارامترهای سراسری، تعاریف گزینه‌ها و گزینه‌های سراسری. هرگونه اطلاعات پیکربندی قابل‌اشتراک، یعنی عناصر پیکربندی که ممکن است با بیش از یک سرور مرتبط باشند، حفظ می‌شوند. به‌ویژه، زیرشبکه‌ها و شبکه‌های مشترک مرتبط با سرورهای حذف‌شده حفظ می‌گردند. اگر هر یک از عناصر پیکربندی قابل‌اشتراک تنها با سرور حذف‌شده در ارتباط بوده باشد، آن شیء بدون انتساب (یتیم یا orphaned) می‌شود. برای مثال: اگر یک زیرشبکه با استفاده از دستور \fBremote\-subnet4\-set\fP ایجاد شده و به \(dqserver1\(dq اختصاص یافته باشد و متعاقباً \(dqserver1\(dq حذف شود، زیرشبکه در پایگاه‌داده باقی می‌ماند اما هیچ سروری نمی‌تواند از این زیرشبکه استفاده کند. این زیرشبکه می‌تواند با دستور \fBremote\-subnet4\-set\fP به‌روزرسانی شود و با استفاده از برچسب سرور ویژهٔ \(dqall\(dq، به سرور دیگری یا به همهٔ سرورها اختصاص یابد. چنین زیرشبکه‌ای را می‌توان در صورت عدم نیاز، با استفاده از دستور \fBremote\-subnet4\-del\-by\-id\fP یا \fBremote\-subnet4\-del\-by\-prefix\fP نیز از پایگاه‌داده حذف کرد.
.sp
پاسخ موفقیت‌آمیز به دستور \fBremote\-server4\-del\fP به صورت زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq1 DHCPv4 server(s) deleted.\(dq,
    \(dqarguments\(dq: {
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
\fBهشدار:\fP
.INDENT 0.0
.INDENT 3.5
دستورهای \fBremote\-server4\-del\fP و \fBremote\-server6\-del\fP باید با احتیاط استفاده شوند، زیرا حذف تصادفی سرور می‌تواند باعث شود بخش‌هایی از پیکربندی‌های موجود برای همیشه از پایگاه‌داده از بین بروند. این عملیات برگشت‌پذیر نیست. ایجاد دوبارهٔ سروری که به‌طور تصادفی حذف شده، پیکربندی ازدست‌رفتهٔ آن سرور را بازنمی‌گرداند و این پیکربندی باید به‌صورت دستی توسط کاربر دوباره ایجاد شود.
.UNINDENT
.UNINDENT
.SS دستورهای \fBremote\-server4\-get\fP و \fBremote\-server6\-get\fP (The \fBremote\-server4\-get\fP, \fBremote\-server6\-get\fP Commands)
.sp
این دستور برای واکشی اطلاعات یک سرور DHCP انتخاب‌شده از پایگاه‌دادهٔ پیکربندی استفاده می‌شود. برای مثال:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-server6\-get\(dq,
    \(dqarguments\(dq: {
        \(dqservers\(dq: [
            {
                \(dqserver\-tag\(dq: \(dqserver1\(dq
            }
        ],
        \(dqremote\(dq: {
            \(dqtype\(dq: \(dqmysql\(dq
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور اطلاعات سرور DHCPv6 را که با برچسب سرور \(dqserver1\(dq مشخص شده است واکشی می‌کند. برچسب سرور به حروف بزرگ و کوچک حساس نیست. یک پاسخ موفقیت‌آمیز، اطلاعات پایه‌ای دربارهٔ سرور مانند برچسب سرور و توضیحات کاربر دربارهٔ سرور را بازمی‌گرداند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqDHCP server server1 found.\(dq,
    \(dqarguments\(dq: {
        \(dqservers\(dq: [
            {
                \(dqserver\-tag\(dq: \(dqserver1\(dq,
                \(dqdescription\(dq: \(dqA DHCPv6 server located on the first floor.\(dq
            }
        ],
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT.SS دستورهای \fBremote\-server4\-get\-all\fP و \fBremote\-server6\-get\-all\fP
.sp
این دستور برای واکشی تمام کارگزارهای DHCPv4 یا DHCPv6 تعریف‌شده توسط کاربر از
پایگاه‌داده به کار می‌رود. ساختار دستور بسیار ساده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-server4\-get\-all\(dq,
    \(dqarguments\(dq: {
        \(dqremote\(dq: {
            \(dqtype\(dq: \(dqmysql\(dq
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ شامل اطلاعات پایه‌ای درباره هر کارگزار، مانند برچسب کارگزار و
توضیحات آن است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqDHCPv4 servers found.\(dq,
    \(dqarguments\(dq: {
        \(dqservers\(dq: [
            {
                \(dqserver\-tag\(dq: \(dqserver1\(dq,
                \(dqdescription\(dq: \(dqA DHCP server located on the first floor.\(dq
            },
            {
                \(dqserver\-tag\(dq: \(dqserver2\(dq,
                \(dqdescription\(dq: \(dqAn old DHCP server to be soon replaced.\(dq
            }
        ],
       \(dqcount\(dq: 2
    }
}
.EE
.UNINDENT
.UNINDENT
.SS دستورهای \fBremote\-server4\-set\fP و \fBremote\-server6\-set\fP
.sp
این دستور برای ایجاد یا جایگزینی اطلاعات مربوط به یک کارگزار DHCP در
پایگاه‌داده به کار می‌رود. اطلاعات کارگزار زمانی باید ایجاد شود که نیاز به تفکیک
پیکربندی‌های استفاده‌شده توسط نمونه‌های گوناگون Kea متصل به یک پایگاه‌داده
وجود داشته باشد. عناصر مختلف پیکربندی، مانند پارامترهای سراسری، زیرشبکه‌ها و
غیره را می‌توان به‌طور صریح به کارگزارهای انتخاب‌شده پیوند داد (با استفاده از
برچسب‌های کارگزار به‌عنوان شناسه)، که بدین ترتیب تنها این کارگزارها اجازه خواهند
داشت از عناصر پیکربندی مربوطه استفاده کنند. استفاده از یک برچسب کارگزار مشخص
برای برقراری چنین پیوندهایی تنها زمانی امکان‌پذیر است که اطلاعات کارگزار از طریق
دستورهای \fBremote\-server4\-set\fP یا \fBremote\-server6\-set\fP در
پایگاه‌داده ذخیره شده باشد. دستور زیر یک کارگزار DHCPv6 جدید را در پایگاه‌داده
ایجاد می‌کند (یا اطلاعات موجود را به‌روزرسانی می‌کند):
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-server6\-set\(dq,
    \(dqarguments\(dq: {
        \(dqservers\(dq: [
            {
                \(dqserver\-tag\(dq: \(dqserver1\(dq,
                \(dqdescription\(dq: \(dqA DHCP server on the ground floor.\(dq
            }
        ],
        \(dqremote\(dq: {
            \(dqtype\(dq: \(dqmysql\(dq
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
برچسب کارگزار باید در میان تمام کارگزارهای موجود در پایگاه‌داده یکتا باشد. هنگامی
که اطلاعات کارگزار تحت برچسب داده‌شده از قبل موجود باشد، با اطلاعات جدید جایگزین
می‌شود. برچسب کارگزار مشخص‌شده به حروف بزرگ و کوچک حساس نیست، و حداکثر طول
آن ۲۵۶ نویسه است. کلیدواژه‌های زیر رزرو شده‌اند و نمی‌توان از آن‌ها به عنوان برچسب
کارگزار استفاده کرد: \(dqall\(dq و \(dqany\(dq.
.sp
در ادامه نمونه‌ای از پاسخ دستور بالا آمده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqDHCPv6 server successfully set.\(dq,
    \(dqarguments\(dq: {
        \(dqservers\(dq: [
            {
                \(dqserver\-tag\(dq: \(dqserver1\(dq,
                \(dqdescription\(dq: \(dqA DHCP server on the ground floor.\(dq
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.SS دستورهای \fBremote\-global\-parameter4\-del\fP و \fBremote\-global\-parameter6\-del\fP
.sp
این دستورها برای حذف یک پارامتر سراسری DHCP از پایگاه‌دادهٔ پیکربندی
به کار می‌روند. هنگامی که پارامتر از پایگاه‌داده حذف می‌شود، کارگزار از مقدار
مشخص‌شده در فایل پیکربندی برای این پارامتر استفاده می‌کند، یا اگر پارامتر در
فایل پیکربندی مشخص نشده باشد، مقدار پیش‌فرض را به کار می‌برد.
.sp
دستور زیر تلاش می‌کند پارامتر DHCPv4 به نام \fBrenew\-timer\fP را که میان
همهٔ کارگزارها مشترک است از پایگاه‌داده حذف کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-global\-parameter4\-del\(dq,
    \(dqarguments\(dq: {
        \(dqparameters\(dq: [ \(dqrenew\-timer\(dq ],
        \(dqremote\(dq: {
            \(dqtype\(dq: \(dqmysql\(dq
         },
        \(dqserver\-tags\(dq: [ \(dqall\(dq ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر قرار است پارامتری مختص به یک کارگزار خاص حذف شود، فهرست
\fBserver\-tags\fP باید شامل برچسب کارگزار مربوطه باشد. باید
دقیقاً یک برچسب کارگزار در این فهرست مشخص شده باشد..SS دستورهای \fBremote\-global\-parameter4\-get\fP و \fBremote\-global\-parameter6\-get\fP
.sp
این دستورها برای دریافت یک پارامتر سراسری اسکالر (scalar) DHCP از پایگاه‌داده پیکربندی به کار می‌روند.
.sp
دستور زیر تلاش می‌کند پارامتر \fBboot\-file\-name\fP را برای \(dqserver1\(dq واکشی کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-global\-parameter4\-get\(dq,
    \(dqarguments\(dq: {
        \(dqparameters\(dq: [ \(dqboot\-file\-name\(dq ],
         \(dqremote\(dq: {
             \(dqtype\(dq: \(dqmysql\(dq
         },
         \(dqserver\-tags\(dq: [ \(dqserver1\(dq ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
مقدار بازگردانده‌شده دارای یکی از چهار نوع داده اسکالر است: رشته (string)، عدد صحیح (integer)، عدد حقیقی (real)، یا بولی (boolean). پارامترهای پیکربندی سراسری غیر اسکالر، مانند map یا list، توسط این دستور بازگردانده نمی‌شوند.
.sp
در مورد مثال بالا، مقدار رشته‌ای بازگردانده می‌شود، مانند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq1 DHCPv4 global parameter found.\(dq,
    \(dqarguments\(dq: {
        \(dqparameters\(dq: {
            \(dqboot\-file\-name\(dq: \(dq/dev/null\(dq,
            \(dqmetadata\(dq: {
                \(dqserver\-tags\(dq: [ \(dqall\(dq ]
            }
        },
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
توجه داشته باشید که پاسخ بالا نشان می‌دهد پارامتر بازگردانده‌شده به‌جای \(dqserver1\(dq استفاده‌شده در دستور، با سرورهای \(dqall\(dq مرتبط است. این نشان می‌دهد که هیچ مقدار خاصی برای \(dqserver1\(dq در پایگاه‌داده وجود ندارد و از این رو، مقدار مشترک بین همه سرورها بازگردانده شده است. اگر مقداری مختص \(dqserver1\(dq در پایگاه‌داده وجود داشت، آن مقدار به‌جای این بازگردانده می‌شد.
.sp
پاسخ نمونه برای مقدار عدد صحیح عبارت است از:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq1 DHCPv4 global parameter found.\(dq,
    \(dqarguments\(dq: {
        \(dqparameters\(dq: {
            \(dqrenew\-timer\(dq: 2000,
            \(dqmetadata\(dq: {
                \(dqserver\-tags\(dq: [ \(dqserver1\(dq ]
            }
        },
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
مقدار عدد حقیقی:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq1 DHCPv4 global parameter found.\(dq,
    \(dqarguments\(dq: {
        \(dqparameters\(dq: {
            \(dqt1\-percent\(dq: 0.85,
            \(dqmetadata\(dq: {
                \(dqserver\-tags\(dq: [ \(dqall\(dq ]
            }
        },
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
در نهایت، مقدار بولی:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq1 DHCPv4 global parameter found.\(dq,
    \(dqarguments\(dq: {
        \(dqparameters\(dq: {
            \(dqmatch\-client\-id\(dq: true,
            \(dqmetadata\(dq: {
                \(dqserver\-tags\(dq: [ \(dqserver2\(dq ]
            }
        },
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT.SS دستورهای \fBremote\-global\-parameter4\-get\-all\fP و \fBremote\-global\-parameter6\-get\-all\fP
.sp
این دستورها برای واکشی تمام پارامترهای سراسری DHCP از پایگاه داده برای سرور مشخص‌شده به کار می‌روند. مثال زیر نحوهٔ واکشی تمام پارامترهای سراسری مورد استفاده توسط سرور \(dqserver1\(dq را نشان می‌دهد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-global\-parameter4\-get\-all\(dq,
    \(dqarguments\(dq: {
        \(dqremote\(dq: {
            \(dqtype\(dq: \(dqmysql\(dq
        },
        \(dqserver\-tags\(dq: [ \(dqserver1\(dq ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ نمونه ممکن است به صورت زیر باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqDHCPv4 global parameters found.\(dq,
    \(dqarguments\(dq: {
        \(dqparameters\(dq: [
            {
                \(dqboot\-file\-name\(dq: \(dq/dev/null\(dq,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ \(dqserver1\(dq ]
                }
            },
            {
                \(dqmatch\-client\-id\(dq: true,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ \(dqall\(dq ]
                }
            }
        ],
        \(dqcount\(dq: 2
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ نمونه شامل دو پارامتر است: یک پارامتر رشته‌ای و یک پارامتر بولی (boolean). فرادادهٔ (metadata) بازگردانده‌شده برای هر پارامتر نشان می‌دهد که آیا این پارامتر مختص \(dqserver1\(dq است یا برای همهٔ سرورها اعمال می‌شود. از آنجا که مقدار \fBmatch\-client\-id\fP با سرورهای \(dqall\(dq مرتبط است، نشان می‌دهد که تنظیم خاصی مختص \(dqserver1\(dq برای این پارامتر وجود ندارد. هر پارامتر همیشه دقیقاً یک برچسب سرور مرتبط با خود دارد، چرا که پارامترهای سراسری عناصر پیکربندی غیرقابل‌اشتراک هستند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
اگر برچسب سرور در دستور روی \(dqall\(dq تنظیم شده باشد، پاسخ تنها شامل پارامترهای سراسری مرتبط با سرور منطقی \(dqall\(dq خواهد بود. هنگامی که برچسب سرور به سرور خاصی اشاره کند (مانند مثال بالا)، فهرست بازگردانده‌شده پارامترهای مرتبط با این سرور و همهٔ سرورها را ترکیب می‌کند، اما اولویت با پارامترهای سرور خاص است.
.UNINDENT
.UNINDENT
.SS دستورهای \fBremote\-global\-parameter4\-set\fP و \fBremote\-global\-parameter6\-set\fP
.sp
این دستور برای ایجاد پارامترهای سراسری اسکالر DHCP در پایگاه داده به کار می‌رود. اگر هر یک از پارامترها از قبل وجود داشته باشد، مقدار آن در نتیجهٔ این دستور جایگزین می‌شود. امکان تنظیم چندین پارامتر در قالب یک دستور واحد وجود دارد که هر کدام می‌توانند یکی از چهار نوع رشته (string)، عدد صحیح (integer)، عدد حقیقی (real) یا بولی (boolean) را داشته باشند. برای مثال:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-global\-parameter4\-set\(dq,
    \(dqarguments\(dq: {
        \(dqparameters\(dq: {
            \(dqboot\-file\-name\(dq: \(dq/dev/null\(dq,
            \(dqrenew\-timer\(dq: 2000,
            \(dqt1\-percent\(dq: 0.85,
            \(dqmatch\-client\-id\(dq: true
        },
        \(dqremote\(dq: {
            \(dqtype\(dq: \(dqmysql\(dq
        },
        \(dqserver\-tags\(dq: [ \(dqserver1\(dq ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر هر یک از پارامترها توسط سرور DHCP پشتیبانی نشود یا نوع آن مطابقت نداشته باشد، خطایی بازگردانده می‌شود. هنگام تعیین چندین پارامتر در یک دستور واحد باید دقت شود، زیرا ممکن است فقط برخی از پارامترها با موفقیت ذخیره شوند و برخی دیگر با خطا مواجه شوند. در صورت بروز خطا هنگام پردازش این دستور، توصیه می‌شود از \fBremote\-global\-parameter4\-get\-all\fP یا \fBremote\-global\-parameter6\-get\-all\fP برای بررسی اینکه کدام پارامترها با موفقیت ذخیره/به‌روزرسانی شده‌اند و کدام با شکست مواجه شده‌اند، استفاده کنید.
.sp
فهرست \fBserver\-tags\fP اجباری است و باید شامل یک برچسب سرور واحد یا کلیدواژهٔ \(dqall\(dq باشد. در مثال بالا، تمام پارامترهای مشخص‌شده با سرور \(dqserver1\(dq مرتبط هستند.
.SS دستورهای \fBremote\-network4\-del\fP و \fBremote\-network6\-del\fP
.sp
این دستورها برای حذف یک شبکهٔ اشتراکی (shared network) از نوع IPv4 یا IPv6 از پایگاه داده به کار می‌روند. پارامتر اختیاری \fBsubnets\-action\fP تعیین می‌کند که آیا زیرشبکه‌های متعلق به شبکهٔ اشتراکی حذف‌شده نیز باید حذف شوند یا حفظ گردند. پارامتر \fBsubnets\-action\fP به‌طور پیش‌فرض روی \fBkeep\fP تنظیم است که زیرشبکه‌ها را حفظ می‌کند. اگر روی \fBdelete\fP تنظیم شود، زیرشبکه‌ها همراه با شبکهٔ اشتراکی حذف می‌شوند.
.sp
دستور زیر:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-network6\-del\(dq,
    \(dqarguments\(dq: {
        \(dqshared\-networks\(dq: [
            {
                \(dqname\(dq: \(dqlevel3\(dq
            }
        ],
        \(dqsubnets\-action\(dq: \(dqkeep\(dq,
        \(dqremote\(dq: {
            \(dqtype\(dq: \(dqmysql\(dq
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
شبکهٔ اشتراکی IPv6 با نام \(dqlevel3\(dq را حذف می‌کند. زیرشبکه‌ها حفظ می‌شوند، اما وابستگی آن‌ها از شبکهٔ اشتراکی حذف‌شده قطع شده و سراسری می‌شوند. این رفتار مطابق با رفتار دستورهای \fBnetwork4\-del\fP و \fBnetwork6\-del\fP با توجه به پارامتر \fBsubnets\-action\fP است.
.sp
توجه داشته باشید که پارامتر \fBserver\-tags\fP را نمی‌توان برای این دستور استفاده کرد..SS دستورهای \fBremote\-network4\-get\fP و \fBremote\-network6\-get\fP
.sp
این دستورها برای بازیابی اطلاعات مربوط به یک شبکه مشترک (shared network) از نوع IPv4 یا
IPv6 به کار می‌روند. پارامتر اختیاری \fBsubnets\-include\fP مشخص می‌کند
که آیا زیرشبکه‌های متعلق به شبکه مشترک نیز باید بازگردانده شوند یا خیر. مقدار
پیش‌فرض این پارامتر \fBno\fP است که در این حالت زیرشبکه‌ها بازگردانده
نمی‌شوند. اگر این پارامتر روی \fBfull\fP تنظیم شود، زیرشبکه‌ها همراه
با شبکه مشترک بازگردانده می‌شوند.
.sp
دستور زیر شبکه مشترک IPv6 با نام \(dqlevel3\(dq را به همراه اطلاعات کامل
زیرشبکه‌های متعلق به آن واکشی می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-network6\-get\(dq,
    \(dqarguments\(dq: {
        \(dqshared\-networks\(dq: [
            {
                \(dqname\(dq: \(dqlevel3\(dq
            }
        ],
        \(dqsubnets\-include\(dq: \(dqfull\(dq,
        \(dqremote\(dq: {
            \(dqtype\(dq: \(dqmysql\(dq
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
توجه داشته باشید که پارامتر \fBserver\-tags\fP را نمی‌توان برای این دستور استفاده کرد.
.SS دستورهای \fBremote\-network4\-list\fP و \fBremote\-network6\-list\fP
.sp
این دستورها برای فهرست کردن تمام شبکه‌های مشترک IPv4 یا IPv6 برای یک سرور به کار می‌روند.
.sp
دستور زیر تمام شبکه‌های مشترکی را که قرار است توسط \(dqserver1\(dq
و \(dqserver2\(dq استفاده شوند بازیابی می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-network4\-list\(dq,
    \(dqarguments\(dq: {
        \(dqremote\(dq: {
            \(dqtype\(dq: \(dqmysql\(dq
        },
        \(dqserver\-tags\(dq: [ \(dqserver1\(dq, \(dqserver2\(dq ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پارامتر \fBserver\-tags\fP اجباری است و شامل یک یا چند برچسب سرور
می‌باشد. این پارامتر می‌تواند حاوی کلیدواژه \(dqall\(dq باشد تا شبکه‌های مشترک مرتبط
با همه سرورها را واکشی کند. هنگامی که فهرست \fBserver\-tags\fP حاوی
مقدار \fBnull\fP باشد، پاسخ بازگردانده شده شامل فهرستی از شبکه‌های مشترک تخصیص‌نیافته
خواهد بود؛ یعنی شبکه‌هایی که با هیچ سروری مرتبط نیستند. برای مثال:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-network4\-list\(dq,
    \(dqarguments\(dq: {
        \(dqremote\(dq: {
            \(dqtype\(dq: \(dqmysql\(dq
        },
        \(dqserver\-tags\(dq: [ null ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ نمونه به این دستور در حالتی که برچسب‌های سرور غیر null مشخص شده باشند،
مشابه این خواهد بود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq3 IPv4 shared network(s) found.\(dq,
    \(dqarguments\(dq: {
        \(dqshared\-networks\(dq: [
            {
                \(dqname\(dq: \(dqground floor\(dq,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ \(dqall\(dq ]
                }
            },
            {
                \(dqname\(dq: \(dqfloor2\(dq,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ \(dqserver1\(dq ]
                }
            },
            {
                \(dqname\(dq: \(dqfloor3\(dq,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ \(dqserver2\(dq ]
                }
            }
        ],
        \(dqcount\(dq: 3
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
اطلاعات بازگردانده شده درباره هر شبکه مشترک صرفاً شامل نام شبکه مشترک
و متادیتا است. برای واکشی اطلاعات دقیق‌تر درباره شبکه مشترک
انتخاب‌شده، از دستور \fBremote\-network4\-get\fP یا
\fBremote\-network6\-get\fP استفاده کنید.
.sp
پاسخ نمونه بالا شامل سه شبکه مشترک است. یکی از شبکه‌های
مشترک با تمام سرورها مرتبط است، بنابراین در فهرست شبکه‌های مشترکی که باید
توسط \(dqserver1\(dq و \(dqserver2\(dq استفاده شوند گنجانده شده است.
دو شبکه مشترک باقی‌مانده بازگردانده شده‌اند زیرا یکی از آن‌ها با
\(dqserver1\(dq و دیگری با \(dqserver2\(dq مرتبط است.
.sp
هنگام فهرست کردن شبکه‌های مشترک تخصیص‌نیافته، پاسخ مشابه
این خواهد بود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq1 IPv4 shared network(s) found.\(dq,
    \(dqarguments\(dq: {
        \(dqshared\-networks\(dq: [
            {
                \(dqname\(dq: \(dqfancy\(dq,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ null ]
                }
            }
        ],
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
مقدار \fBnull\fP در متادیتا نشان می‌دهد که شبکه مشترک بازگردانده‌شده
تخصیص نیافته است..SS دستورهای \fBremote\-network4\-set\fP و \fBremote\-network6\-set\fP
.sp
این دستورها یک شبکهٔ اشتراکی IPv4 یا IPv6 جدید در پایگاه‌داده ایجاد کرده یا جایگزین نمونهٔ موجود می‌کنند. ساختار اطلاعات شبکهٔ اشتراکی همانند فایل پیکربندی Kea است (برای جزئیات به Shared Networks in DHCPv4 \%<#\:shared-network4> و Shared Networks in DHCPv6 \%<#\:shared-network6> مراجعه کنید)، با این تفاوت که مشخص کردن زیرشبکه‌ها همراه با اطلاعات شبکهٔ اشتراکی مجاز نیست. گنجاندن پارامتر \fBsubnet4\fP یا \fBsubnet6\fP درون اطلاعات شبکهٔ اشتراکی منجر به بروز خطا می‌شود.
.sp
این دستورها به منظور مدیریت اطلاعات مختص شبکهٔ اشتراکی و گزینه‌های DHCP طراحی شده‌اند. برای مرتبط‌سازی و لغو ارتباط زیرشبکه‌ها با شبکه‌های اشتراکی، باید از دستورهای \fBremote\-subnet4\-set\fP و \fBremote\-subnet6\-set\fP استفاده شود.
.sp
دستور زیر، شبکهٔ اشتراکی IPv6 با نام \(dqlevel3\(dq را به پایگاه‌داده اضافه می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-network6\-set\(dq,
    \(dqarguments\(dq: {
        \(dqshared\-networks\(dq: [
            {
                \(dqname\(dq: \(dqlevel3\(dq,
                \(dqinterface\(dq: \(dqeth0\(dq,
                \(dqoption\-data\(dq: [ {
                    \(dqname\(dq: \(dqsntp\-servers\(dq,
                    \(dqdata\(dq: \(dq2001:db8:1::1\(dq
                } ]
            }
        ],
        \(dqremote\(dq: {
            \(dqtype\(dq: \(dqmysql\(dq
        },
        \(dqserver\-tags\(dq: [ \(dqall\(dq ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور شامل پارامتر \fBinterface\fP است که نام رابط را در سطح شبکهٔ اشتراکی تعیین می‌کند. سایر پارامترهای سطح شبکهٔ اشتراکی که با این دستور مشخص نشده باشند، در پایگاه‌داده به عنوان \(dqunspecified\(dq علامت‌گذاری خواهند شد. کارگزار DHCP برای پارامترهای مشخص‌نشده از مقادیر سراسری استفاده می‌کند یا در صورتی که مقادیر سراسری تعیین نشده باشند، مقادیر پیش‌فرض به کار گرفته می‌شوند.
.sp
فهرست \fBserver\-tags\fP برای این دستور اجباری است و باید شامل یک یا چند برچسب کارگزار باشد. در نتیجه، شبکهٔ اشتراکی با تمامی کارگزارهای فهرست‌شده مرتبط می‌شود. هنگامی که کلیدواژهٔ \(dqall\(dq در آن قرار گیرد، شبکهٔ اشتراکی با تمامی کارگزارهایی که به پایگاه‌داده متصل می‌شوند مرتبط خواهد شد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
مشابه سایر دستورهای \(dqset\(dq، در صورتی که شبکهٔ اشتراکی از قبل وجود داشته باشد، این دستور تمام اطلاعات مربوط به آن شبکهٔ اشتراکی مشخص‌شده را در پایگاه‌داده جایگزین می‌کند. بنابراین، هنگام ارسال این دستور، اطمینان حاصل کنید که همیشه تمام پارامترهایی را که باید برای نمونهٔ به‌روزشدهٔ شبکهٔ اشتراکی مشخص باشند، بگنجانید. هر پارامتر نامشخص، حتی اگر مقدار آن قبل از ارسال دستور در پایگاه‌داده موجود بوده باشد، به عنوان نامشخص (unspecified) علامت‌گذاری خواهد شد.
.UNINDENT
.UNINDENT
.SS دستورهای \fBremote\-option\-def4\-del\fP و \fBremote\-option\-def6\-del\fP
.sp
این دستورها برای حذف تعریف یک گزینهٔ DHCP از پایگاه‌داده استفاده می‌شوند. تعریف گزینه توسط یک کد گزینه و فضای گزینه مشخص می‌شود. برای مثال:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-option\-def6\-del\(dq,
    \(dqarguments\(dq: {
        \(dqoption\-defs\(dq: [
            {
                \(dqcode\(dq: 1,
                \(dqspace\(dq: \(dqisc\(dq
            }
        ],
        \(dqremote\(dq: {
            \(dqtype\(dq: \(dqmysql\(dq
        },
        \(dqserver\-tags\(dq: [ \(dqserver1\(dq ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
تعریف گزینهٔ مرتبط با \(dqserver1\(dq را که دارای کد 1 و متعلق به فضای گزینهٔ \(dqisc\(dq است حذف می‌کند. فضاهای گزینهٔ پیش‌فرض برای گزینه‌های سطح بالای DHCPv4 و DHCPv6 به ترتیب \(dqdhcp4\(dq و \(dqdhcp6\(dq هستند. اگر چنین تعریف گزینه‌ای به‌طور صریح با \(dqserver1\(dq مرتبط نباشد، هیچ تعریفی حذف نمی‌شود. برای حذف تعریف گزینه‌ای که متعلق به کارگزارهای \(dqall\(dq است، باید از کلیدواژهٔ \(dqall\(dq به عنوان برچسب کارگزار استفاده شود. فهرست \fBserver\-tags\fP باید دقیقاً شامل یک برچسب باشد و نمی‌تواند مقدار \fBnull\fP داشته باشد.
.sp
از نگارش Kea 3.1.2 به بعد، کارگزار قبل از حذف تعریف گزینه، ابتدا بررسی می‌کند که آیا گزینه‌ای وجود دارد که به آن تعریف وابسته باشد یا خیر. در این صورت، دستور حذف به همراه پیام خطایی که دلیل آن را شرح می‌دهد رد خواهد شد. این رفتار پیش‌فرض را می‌توان با تنظیم پارامتر اختیاری \fBforce\fP روی مقدار true مطابق شکل زیر نادیده گرفت:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-option\-def6\-del\(dq,
    \(dqarguments\(dq: {
        \(dqoption\-defs\(dq: [
            {
                \(dqcode\(dq: 1,
                \(dqspace\(dq: \(dqisc\(dq,
                \(dqforce\(dq: true
            }
        ],
        \(dqremote\(dq: {
            \(dqtype\(dq: \(dqmysql\(dq
        },
        \(dqserver\-tags\(dq: [ \(dqserver1\(dq ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
پارامتر \fBforce\fP تنها پس از بررسی دقیق باید استفاده شود. حذف یک تعریف گزینه در حالی که مشخصات گزینه‌ای وابسته وجود دارد، باعث کنار گذاشته شدن آن گزینه از پیکربندی در حال اجرا خواهد شد. این پارامتر برای مواردی در نظر گرفته شده که ممکن است نیاز به اصلاح تعریف باشد در حالی که خود گزینه در جای خود باقی بماند.
.UNINDENT
.UNINDENT.SS دستورهای \fBremote\-option\-def4\-get\fP و \fBremote\-option\-def6\-get\fP
.sp
این دستورها برای واکشی تعریف یک گزینه (option definition) مشخص DHCP از پایگاه‌داده به کار می‌روند.
تعریف گزینه از طریق کد گزینه و فضای گزینه (option space) مشخص می‌شود. فضاهای پیش‌فرض گزینه
برای گزینه‌های سطح بالای DHCPv4 و DHCPv6 به ترتیب \(dqdhcp4\(dq و \(dqdhcp6\(dq هستند.
.sp
دستور زیر یک تعریف گزینه DHCPv4 مرتبط با تمام سرورها را با کد ۱ و متعلق به فضای گزینه \(dqisc\(dq بازیابی می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-option\-def4\-get\(dq,
    \(dqarguments\(dq: {
        \(dqoption\-defs\(dq: [
            {
                \(dqcode\(dq: 1,
                \(dqspace\(dq: \(dqisc\(dq
            }
        ],
        \(dqremote\(dq: {
            \(dqtype\(dq: \(dqmysql\(dq
        },
        \(dqserver\-tags\(dq: [ \(dqall\(dq ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
فهرست \fBserver\-tags\fP باید دقیقاً شامل یک برچسب سرور یا کلیدواژه \(dqall\(dq باشد و نمی‌تواند
شامل مقدار \fInull\fP باشد.
.SS دستورهای \fBremote\-option\-def4\-get\-all\fP و \fBremote\-option\-def6\-get\-all\fP
.sp
این دستورها برای واکشی تمام تعاریف گزینه‌های DHCP از پایگاه‌داده برای سرور مشخص‌شده
یا تمام سرورها استفاده می‌شوند. برای مثال:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-option\-def6\-get\-all\(dq,
    \(dqarguments\(dq: {
        \(dqremote\(dq: {
            \(dqtype\(dq: \(dqmysql\(dq
        },
        \(dqserver\-tags\(dq: [ \(dqall\(dq ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور تلاش می‌کند تمام تعاریف گزینه‌های DHCPv6 مرتبط با سرورهای \(dqall\(dq را واکشی کند.
فهرست \fBserver\-tags\fP برای این دستور اجباری است و باید دقیقاً شامل یک برچسب سرور یا کلیدواژه
\(dqall\(dq باشد. این مقدار نمی‌تواند \fBnull\fP باشد.
.sp
نمونه پاسخ به این دستور به شرح زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq1 DHCPv6 option definition(s) found.\(dq,
    \(dqarguments\(dq: {
        \(dqoption\-defs\(dq: [
            {
                \(dqname\(dq: \(dqbar\(dq,
                \(dqcode\(dq: 1012,
                \(dqspace\(dq: \(dqdhcp6\(dq,
                \(dqtype\(dq: \(dqrecord\(dq,
                \(dqarray\(dq: true,
                \(dqrecord\-types\(dq: \(dqipv6\-address, uint16\(dq,
                \(dqencapsulate\(dq: \(dq\(dq,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ \(dqall\(dq ]
                }
            }
        ],
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ شامل تعریف گزینه‌ای مرتبط با تمام سرورها است، همان‌طور که در متادیتا مشخص شده است.
.SS دستورهای \fBremote\-option\-def4\-set\fP و \fBremote\-option\-def6\-set\fP
.sp
این دستورها یک تعریف گزینه DHCP جدید ایجاد می‌کنند یا تعریف گزینه موجود در پایگاه‌داده
را جایگزین می‌نمایند. ساختار اطلاعات تعریف گزینه مشابه فایل پیکربندی Kea است (نگاه کنید به
گزینه‌های سفارشی DHCPv4 \%<#\:dhcp4-custom-options> و گزینه‌های سفارشی DHCPv6 \%<#\:dhcp6-custom-options>).
دستور زیر تعریف گزینه DHCPv4 را در فضای گزینه سطح بالای \(dqdhcp4\(dq ایجاد کرده و آن را
به \(dqserver1\(dq اختصاص می‌دهد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-option\-def4\-set\(dq,
    \(dqarguments\(dq: {
        \(dqoption\-defs\(dq: [
            {
                \(dqname\(dq: \(dqfoo\(dq,
                \(dqcode\(dq: 222,
                \(dqtype\(dq: \(dquint32\(dq,
                \(dqarray\(dq: false,
                \(dqrecord\-types\(dq: \(dq\(dq,
                \(dqspace\(dq: \(dqdhcp4\(dq,
                \(dqencapsulate\(dq: \(dq\(dq
            }
        ],
        \(dqremote\(dq: {
            \(dqtype\(dq: \(dqmysql\(dq
        },
        \(dqserver\-tags\(dq: [ \(dqserver1\(dq ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
فهرست \fBserver\-tags\fP باید دقیقاً شامل یک برچسب سرور یا کلیدواژه \(dqall\(dq باشد و
نمی‌تواند شامل مقدار \fBnull\fP باشد..SS دستورهای \fBremote\-option4\-global\-del\fP و \fBremote\-option6\-global\-del\fP
.sp
این دستورها برای حذف یک گزینه سراسری DHCP از پایگاه داده استفاده می‌شوند.
گزینه بر اساس کد گزینه و فضای گزینه شناسایی می‌شود.
از نسخه Kea 3.1.1 به بعد، یک پارامتر اختیاری \fBclient\-classes\fP نیز می‌تواند
مشخص شود (به بخش Option Class\-tags as Keys مراجعه کنید).
.sp
برای مثال:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-option4\-global\-del\(dq,
    \(dqarguments\(dq: {
        \(dqoptions\(dq: [
            {
                \(dqcode\(dq: 5,
                \(dqspace\(dq: \(dqdhcp4\(dq,
                \(dqclient\-classes\(dq: [ \(dqclass\-one\(dq ]
            }
        ],
        \(dqremote\(dq: {
            \(dqtype\(dq: \(dqmysql\(dq
        },
        \(dqserver\-tags\(dq: [ \(dqserver1\(dq ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
مقدار \(dqdhcp4\(dq نشان‌دهنده فضای گزینه سطح بالایی است که گزینه‌های استاندارد DHCPv4
به آن تعلق دارند. پارامتر \fBserver\-tags\fP اجباری است و باید شامل یک
برچسب گزینه تکی یا کلیدواژه \(dqall\(dq باشد. اگر برچسب سرور صریح مشخص شده باشد،
این دستور تلاش می‌کند گزینه سراسری مرتبط با این سرور را حذف کند. اگر چنین گزینه‌ای
مرتبط با سرور مشخص‌شده وجود نداشته باشد، هیچ گزینه‌ای حذف نمی‌شود. برای حذف گزینه‌ای
که با همه سرورها مرتبط است، باید کلیدواژه \(dqall\(dq مشخص شود.
.SS دستورهای \fBremote\-option4\-global\-get\fP و \fBremote\-option6\-global\-get\fP
.sp
این دستورها برای واکشی یک گزینه سراسری DHCP از پایگاه داده استفاده می‌شوند.
گزینه بر اساس کد و فضای گزینه شناسایی می‌شود. بالاترین سطح فضاهای گزینه که
گزینه‌های استاندارد DHCP به آن‌ها تعلق دارند، به ترتیب برای سرورهای DHCPv4 و DHCPv6
با نام‌های \(dqdhcp4\(dq و \(dqdhcp6\(dq شناخته می‌شوند.
از نسخه Kea 3.1.1 به بعد، یک پارامتر اختیاری \fBclient\-classes\fP نیز می‌تواند
مشخص شود (به بخش Option Class\-tags as Keys مراجعه کنید).
.sp
دستور زیر گزینه \(dqDNS Servers\(dq در IPv6 (کد 23) که با همه سرورها
مرتبط است را بازیابی می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-option6\-global\-get\(dq,
    \(dqarguments\(dq: {
        \(dqoptions\(dq: [
            {
                \(dqcode\(dq: 23,
                \(dqspace\(dq: \(dqdhcp6\(dq,
                \(dqclient\-classes\(dq: [ \(dqclass\-one\(dq ]
            }
        ],
        \(dqremote\(dq: {
            \(dqtype\(dq: \(dqmysql\(dq
        },
        \(dqserver\-tags\(dq: [ \(dqall\(dq ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پارامتر \fBserver\-tags\fP اجباری است و باید دقیقا شامل یک برچسب
سرور یا کلیدواژه \(dqall\(dq باشد. این پارامتر نمی‌تواند حاوی مقدار \fBnull\fP
باشد.
.SS دستورهای \fBremote\-option4\-global\-get\-all\fP و \fBremote\-option6\-global\-get\-all\fP
.sp
این دستورها برای واکشی تمام گزینه‌های سراسری DHCP از پایگاه داده پیکربندی
برای سرور داده‌شده یا برای همه سرورها استفاده می‌شوند. دستور زیر
همه گزینه‌های سراسری DHCPv4 را برای \(dqserver1\(dq واکشی می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-option6\-global\-get\-all\(dq,
    \(dqarguments\(dq: {
        \(dqremote\(dq: {
            \(dqtype\(dq: \(dqmysql\(dq
        },
        \(dqserver\-tags\(dq: [ \(dqserver1\(dq ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
فهرست \fBserver\-tags\fP برای این دستور اجباری است و
باید دقیقا شامل یک برچسب سرور یا کلیدواژه \(dqall\(dq باشد؛ این فهرست نمی‌تواند
شامل مقدار \fBnull\fP باشد.
.sp
در زیر یک پاسخ نمونه به این دستور آورده شده است که
در آن یک گزینه تکی مرتبط با \(dqserver1\(dq بازگردانده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqDHCPv4 options found.\(dq,
    \(dqarguments\(dq: {
        \(dqoptions\(dq: [
            {
                \(dqname\(dq: \(dqdomain\-name\-servers\(dq,
                \(dqcode\(dq: 6,
                \(dqspace\(dq: \(dqdhcp4\(dq,
                \(dqcsv\-format\(dq: false,
                \(dqdata\(dq: \(dq192.0.2.3\(dq,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ \(dqserver1\(dq ]
                }
            }
        ],
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT.SS دستورهای \fBremote\-option4\-global\-set\fP و \fBremote\-option6\-global\-set\fP
.sp
این دستورها یک گزینهٔ سراسری جدید DHCP ایجاد کرده یا یک گزینهٔ
موجود در پایگاه‌داده را جایگزین می‌کنند. ساختار اطلاعات گزینه مشابه
ساختار موجود در فایل پیکربندی Kea است (بخش گزینه‌های استاندارد DHCPv4 در \%<#\:dhcp4-std-options>
و گزینه‌های استاندارد DHCPv6 در \%<#\:dhcp6-std-options> را ببینید). برای مثال:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-option6\-global\-set\(dq,
    \(dqarguments\(dq: {
        \(dqoptions\(dq: [
            {
                \(dqname\(dq: \(dqdns\-servers\(dq,
                \(dqdata\(dq: \(dq2001:db8:1::1\(dq
            }
        ],
        \(dqremote\(dq: {
            \(dqtype\(dq: \(dqmysql\(dq
        },
        \(dqserver\-tags\(dq: [ \(dqserver1\(dq ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
فهرست \fBserver\-tags\fP برای این دستور اجباری است
و باید دقیقاً شامل یک برچسب سرور یا کلیدواژهٔ \(dqall\(dq باشد؛ این مقدار
نمی‌تواند حاوی مقدار \fBnull\fP باشد. دستور بالا گزینه را
به سرور \(dqserver1\(dq مرتبط می‌سازد.
.sp
توجه داشته باشید که مشخص کردن نام گزینه به جای کد گزینه تنها
برای گزینه‌های استاندارد DHCP به‌طور قابل‌اطمینان کار می‌کند. هنگام تعیین
مقداری برای یک گزینهٔ سفارشی DHCP، باید به جای نام،
کد گزینه مشخص شود. برای مثال:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-option6\-global\-set\(dq,
    \(dqarguments\(dq: {
        \(dqoptions\(dq: [
            {
                \(dqcode\(dq: 1,
                \(dqspace\(dq: \(dqisc\(dq,
                \(dqdata\(dq: \(dq2001:db8:1::1\(dq
            }
        ],
        \(dqserver\-tags\(dq: [ \(dqserver1\(dq ]
    }
}
.EE
.UNINDENT
.UNINDENT
.SS دستورهای \fBremote\-option4\-network\-del\fP و \fBremote\-option6\-network\-del\fP
.sp
این دستورها برای حذف یک گزینهٔ DHCP مختص شبکهٔ اشتراکی (shared network)
از پایگاه‌داده به کار می‌روند. گزینه با یک کد گزینه و فضای گزینه شناسایی
می‌شود، و از Kea 3.1.1 به بعد، یک پارامتر اختیاری \fBclient\-classes\fP
نیز می‌تواند تعیین گردد (بخش Option Class\-tags as Keys را ببینید).
این پارامترها در داخل فهرست \fBoptions\fP ارسال می‌شوند.
فهرست دیگر، \fBshared\-networks\fP، شامل یک مَپ با نام شبکهٔ اشتراکی است
که گزینه باید از آن حذف شود. اگر گزینه به‌طور صریح برای این شبکهٔ
اشتراکی مشخص نشده باشد، هیچ گزینه‌ای حذف نمی‌شود. به‌ویژه، گزینهٔ
مورد نظر ممکن است برای یک زیرشبکهٔ متعلق به آن شبکهٔ اشتراکی وجود
داشته باشد. چنین موردی تحت تأثیر این دستور قرار نمی‌گیرد زیرا این دستور
صرفاً گزینهٔ سطح شبکهٔ اشتراکی را حذف می‌کند. برای حذف یک گزینه در سطح
زیرشبکه، باید به جای آن از دستورهای \fBremote\-option4\-subnet\-del\fP
و \fBremote\-option6\-subnet\-del\fP استفاده شود.
.sp
دستور زیر تلاش می‌کند گزینه‌ای با کد گزینهٔ ۵ در بالاترین سطح فضای
گزینه (top\-level option space) و یک فهرست خالی client\-classes را از
شبکهٔ اشتراکی \(dqfancy\(dq حذف کند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-option4\-network\-del\(dq,
    \(dqarguments\(dq: {
        \(dqshared\-networks\(dq: [
            {
                \(dqname\(dq: \(dqfancy\(dq
            }
        ],
        \(dqoptions\(dq: [
            {
                \(dqcode\(dq: 5,
                \(dqspace\(dq: \(dqdhcp4\(dq,
                \(dqclient\-classes\(dq : [ ]
            }
        ],
        \(dqremote\(dq: {
            \(dqtype\(dq: \(dqmysql\(dq
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
مقدار \(dqdhcp4\(dq نشان‌دهندهٔ بالاترین سطح فضای گزینه است که گزینه‌های استاندارد
DHCPv4 به آن تعلق دارند. پارامتر \fBserver\-tags\fP نمی‌تواند برای این دستور مشخص شود.
.SS دستورهای \fBremote\-option4\-network\-set\fP و \fBremote\-option6\-network\-set\fP
.sp
این دستورها یک گزینهٔ DHCP جدید مختص شبکهٔ اشتراکی ایجاد کرده یا
یک گزینهٔ موجود در پایگاه‌داده را جایگزین می‌کنند. ساختار اطلاعات گزینه
مشابه فایل پیکربندی Kea است (بخش گزینه‌های استاندارد DHCPv4 در \%<#\:dhcp4-std-options>
و گزینه‌های استاندارد DHCPv6 در \%<#\:dhcp6-std-options> را ببینید). اطلاعات گزینه در
فهرست \fBoptions\fP منتقل می‌شود. فهرست دیگری به نام \fBshared\-networks\fP شامل یک مَپ با
نام شبکهٔ اشتراکی است که گزینه برای آن تنظیم می‌شود. اگر چنین گزینه‌ای
از قبل برای شبکهٔ اشتراکی وجود داشته باشد، با نمونهٔ جدید جایگزین می‌شود.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-option6\-network\-set\(dq,
    \(dqarguments\(dq: {
        \(dqshared\-networks\(dq: [
            {
                \(dqname\(dq: \(dqfancy\(dq
            }
        ],
        \(dqoptions\(dq: [
            {
                \(dqname\(dq: \(dqdns\-servers\(dq,
                \(dqdata\(dq: \(dq2001:db8:1::1\(dq
            }
        ],
        \(dqremote\(dq: {
            \(dqtype\(dq: \(dqmysql\(dq
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پارامتر \fBserver\-tags\fP نمی‌تواند برای این دستور مشخص شود.
.sp
مشخص کردن نام گزینه به جای کد گزینه فقط برای گزینه‌های استاندارد DHCP
به‌طور قابل‌اطمینان عمل می‌کند. هنگام تعیین یک مقدار برای گزینهٔ سفارشی
DHCP، باید به جای نام، از کد گزینه استفاده شود..SS دستور \fBremote\-option6\-pd\-pool\-del\fP
.sp
این دستور برای حذف یک گزینه DHCPv6 مختص استخر واگذاری پیشوند (prefix delegation pool) از پایگاه‌داده به کار می‌رود. گزینه با یک کد گزینه و فضای گزینه شناسایی می‌شود، و از نسخه Kea 3.1.1 به بعد، پارامتر اختیاری \fBclient\-classes\fP نیز می‌تواند مشخص شود (به Option Class\-tags as Keys مراجعه کنید). این پارامترها درون فهرست \fBoptions\fP ارسال می‌شوند. فهرست دیگری به نام \fBpd\-pools\fP شامل یک نگاشت با پیشوند و طول استخر واگذاری پیشوند است که استخر را مشخص می‌کند. اگر گزینه به‌طور صریح برای این استخر مشخص نشده باشد، هیچ گزینه‌ای حذف نمی‌شود. به‌ویژه، گزینه داده‌شده ممکن است برای زیرشبکه‌ای شامل استخر مشخص‌شده وجود داشته باشد. چنین نمونه‌ای از گزینه تحت تأثیر این دستور قرار نمی‌گیرد، زیرا این دستور صرفاً یک گزینه در سطح استخر واگذاری پیشوند را حذف می‌کند. برای حذف گزینه‌ای در سطح زیرشبکه، باید به جای آن از دستور \fBremote\-option6\-subnet\-del\fP استفاده شود.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-option6\-pd\-pool\-del\(dq,
    \(dqarguments\(dq: {
        \(dqpd\-pools\(dq: [
            {
                \(dqprefix\(dq: \(dq3000::\(dq,
                \(dqprefix\-len\(dq: 64
            }
        ],
        \(dqoptions\(dq: [
            {
                \(dqcode\(dq: 23,
                \(dqspace\(dq: \(dqdhcp6\(dq
            }
        ],
        \(dqremote\(dq: {
            \(dqtype\(dq: \(dqmysql\(dq
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
مقدار \(dqdhcp6\(dq نشان‌دهنده فضای گزینه سطح بالا است که گزینه‌های استاندارد DHCPv6 به آن تعلق دارند. پارامتر \fBserver\-tags\fP را نمی‌توان برای این دستور مشخص کرد.
.SS دستور \fBremote\-option6\-pd\-pool\-set\fP
.sp
این دستور یک گزینه DHCPv6 جدید مختص استخر واگذاری پیشوند ایجاد کرده یا گزینه‌ای موجود در پایگاه‌داده را جایگزین می‌کند. ساختار اطلاعات گزینه مشابه پرونده پیکربندی Kea است (به Standard DHCPv4 Options \%<#\:dhcp4-std-options> و Standard DHCPv6 Options \%<#\:dhcp6-std-options> مراجعه کنید). اطلاعات گزینه در فهرست \fBoptions\fP حمل می‌شود. فهرست دیگری به نام \fBpd\-pools\fP شامل نگاشتی با پیشوند استخر واگذاری پیشوند و طول پیشوند است که استخر را شناسایی می‌کند. اگر چنین گزینه‌ای از قبل برای استخر واگذاری پیشوند وجود داشته باشد، با نمونه جدید جایگزین می‌شود.
.sp
برای مثال:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-option6\-pd\-pool\-set\(dq,
    \(dqarguments\(dq: {
        \(dqpd\-pools\(dq: [
            {
                \(dqprefix\(dq: \(dq3001:1::\(dq,
                \(dqlength\(dq: 64
            }
        ],
        \(dqoptions\(dq: [
            {
                \(dqname\(dq: \(dqdns\-servers\(dq,
                \(dqdata\(dq: \(dq2001:db8:1::1\(dq
            }
        ],
        \(dqremote\(dq: {
            \(dqtype\(dq: \(dqmysql\(dq
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پارامتر \fBserver\-tags\fP را نمی‌توان برای این دستور مشخص کرد.
.sp
مشخص کردن نام گزینه به جای کد گزینه، تنها برای گزینه‌های استاندارد DHCP به‌درستی کار می‌کند. هنگام تعیین مقدار برای یک گزینه DHCP تعریف‌شده توسط کاربر، باید کد گزینه به جای نام آن قید شود.
.SS دستورهای \fBremote\-option4\-pool\-del\fP و \fBremote\-option6\-pool\-del\fP
.sp
این دستورها برای حذف یک گزینه DHCP مختص استخر نشانی از پایگاه‌داده به کار می‌روند. گزینه با یک کد گزینه و فضای گزینه شناسایی می‌شود، و از نسخه Kea 3.1.1 به بعد، پارامتر اختیاری \fBclient\-classes\fP نیز ممکن است مشخص شود (به Option Class\-tags as Keys مراجعه کنید). این پارامترها در فهرست \fBoptions\fP ارسال می‌شوند. فهرست دیگری به نام \fBpools\fP شامل یک نگاشت با محدوده نشانی IP یا پیشوند مشخص‌کننده استخر است. اگر گزینه به‌طور صریح برای این استخر مشخص نشده باشد، هیچ گزینه‌ای حذف نخواهد شد. به‌ویژه، گزینه داده‌شده ممکن است برای زیرشبکه‌ای شامل استخر مشخص‌شده وجود داشته باشد. چنین نمونه‌ای از گزینه تحت تأثیر این دستور قرار نمی‌گیرد، چرا که این دستور صرفاً گزینه‌ای در سطح استخر را حذف می‌کند. برای حذف گزینه‌ای در سطح زیرشبکه، باید به جای آن از دستور \fBremote\-option4\-subnet\-del\fP یا \fBremote\-option6\-subnet\-del\fP استفاده شود.
.sp
دستور زیر تلاش می‌کند گزینه‌ای با کد گزینه 5 در فضای گزینه سطح بالا را از یک استخر نشانی IPv4 حذف کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-option4\-pool\-del\(dq,
    \(dqarguments\(dq: {
        \(dqpools\(dq: [
            {
                \(dqpool\(dq: \(dq192.0.2.10 \- 192.0.2.100\(dq
            }
        ],
        \(dqoptions\(dq: [
            {
                \(dqcode\(dq: 5,
                \(dqspace\(dq: \(dqdhcp4\(dq
            }
        ],
        \(dqremote\(dq: {
            \(dqtype\(dq: \(dqmysql\(dq
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
مقدار \(dqdhcp4\(dq نشان‌دهنده فضای گزینه سطح بالا است که گزینه‌های استاندارد DHCPv4 به آن تعلق دارند. پارامتر \fBserver\-tags\fP را نمی‌توان برای این دستور مشخص کرد..SS دستورهای \fBremote\-option4\-pool\-set\fP و \fBremote\-option6\-pool\-set\fP
.sp
این دستورها یک گزینهٔ DHCP جدیدِ مختص استخر آدرس ایجاد کرده یا گزینه‌ای موجود را در پایگاه داده جایگزین می‌کنند. ساختار اطلاعات گزینه همانند پروندهٔ پیکربندی Kea است (بخش گزینه‌های استاندارد DHCPv4 \%<#\:dhcp4-std-options> و گزینه‌های استاندارد DHCPv6 \%<#\:dhcp6-std-options> را ببینید). اطلاعات گزینه در فهرست \fBoptions\fP منتقل می‌شود. فهرست دیگری به نام \fBpools\fP شامل نگاشتی با بازهٔ نشانی IP یا پیشوندی است که استخر را مشخص می‌سازد. اگر چنین گزینه‌ای از قبل برای استخر وجود داشته باشد، با نمونهٔ جدید جایگزین می‌شود.
.sp
برای نمونه:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-option4\-pool\-set\(dq,
    \(dqarguments\(dq: {
        \(dqpools\(dq: [
            {
                \(dqpool\(dq: \(dq192.0.2.10 \- 192.0.2.100\(dq
            }
        ],
        \(dqoptions\(dq: [
            {
                \(dqname\(dq: \(dqdomain\-name\-servers\(dq,
                \(dqdata\(dq: \(dq10.0.0.1\(dq
            }
        ],
        \(dqremote\(dq: {
            \(dqtype\(dq: \(dqmysql\(dq
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پارامتر \fBserver\-tags\fP را نمی‌توان برای این دستور مشخص کرد.
.sp
مشخص کردن نام گزینه به جای کد گزینه، فقط برای گزینه‌های استاندارد DHCP به‌طور قابل‌اطمینان کار می‌کند. هنگام تعیین مقدار برای یک گزینهٔ DHCP تعریف‌شده توسط کاربر (user\-defined)، باید کد گزینه به جای نام آن درج شود.
.SS دستورهای \fBremote\-option4\-subnet\-del\fP و \fBremote\-option6\-subnet\-del\fP
.sp
این دستورها برای حذف یک گزینهٔ DHCP مختص زیرشبکه از پایگاه داده به کار می‌روند. گزینه با یک کد گزینه، فضای گزینه (option space) و از نسخهٔ Kea 3.1.1 به بعد، با یک پارامتر اختیاری \fBclient\-classes\fP شناسایی می‌شود (بخش Option Class\-tags as Keys را ببینید).
این پارامترها درون فهرست \fBoptions\fP ارسال می‌شوند.
فهرست دیگر، \fBsubnets\fP، شامل نگاشتی با شناسهٔ زیرشبکه‌ای است که گزینه باید از آن حذف شود.
اگر گزینه به‌طور صریح برای این زیرشبکه مشخص نشده باشد، هیچ گزینه‌ای حذف نمی‌شود.
.sp
دستور زیر تلاش می‌کند گزینه‌ای با کد گزینهٔ 5 را در فضای گزینهٔ سطح‌بالا (top\-level) از زیرشبکه‌ای با شناسهٔ 123 حذف کند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-option4\-subnet\-del\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [
            {
                \(dqid\(dq: 123
            }
        ],
        \(dqoptions\(dq: [
            {
                \(dqcode\(dq: 5,
                \(dqspace\(dq: \(dqdhcp4\(dq
            }
        ],
        \(dqremote\(dq: {
            \(dqtype\(dq: \(dqmysql\(dq
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
مقدار \(dqdhcp4\(dq نشان‌دهندهٔ فضای گزینهٔ سطح‌بالاست که گزینه‌های استاندارد DHCPv4 به آن تعلق دارند. پارامتر \fBserver\-tags\fP را نمی‌توان برای این دستور مشخص کرد.
.SS دستورهای \fBremote\-option4\-subnet\-set\fP و \fBremote\-option6\-subnet\-set\fP
.sp
این دستورها یک گزینهٔ DHCP جدیدِ مختص زیرشبکه ایجاد کرده یا گزینه‌ای موجود را در پایگاه داده جایگزین می‌کنند. ساختار اطلاعات گزینه مشابه پروندهٔ پیکربندی Kea است (بخش گزینه‌های استاندارد DHCPv4 \%<#\:dhcp4-std-options> و گزینه‌های استاندارد DHCPv6 \%<#\:dhcp6-std-options> را ببینید). اطلاعات گزینه در فهرست \fBoptions\fP منتقل می‌شود. فهرست دیگری به نام \fBsubnets\fP شامل نگاشتی با شناسهٔ زیرشبکه‌ای است که گزینه باید برای آن تنظیم شود. اگر چنین گزینه‌ای از قبل برای زیرشبکه وجود داشته باشد، با نمونهٔ جدید جایگزین خواهد شد.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-option6\-subnet\-set\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [
            {
                \(dqid\(dq: 123
            }
        ],
        \(dqoptions\(dq: [
            {
                \(dqname\(dq: \(dqdns\-servers\(dq,
                \(dqdata\(dq: \(dq2001:db8:1::1\(dq
            }
        ],
        \(dqremote\(dq: {
            \(dqtype\(dq: \(dqmysql\(dq
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پارامتر \fBserver\-tags\fP را نمی‌توان برای این دستور مشخص کرد.
.sp
مشخص کردن نام گزینه به جای کد گزینه، فقط برای گزینه‌های استاندارد DHCP به‌طور قابل‌اطمینان کار می‌کند. هنگام تعیین مقدار برای گزینهٔ DHCP تعریف‌شده توسط کاربر، باید کد گزینه به جای نام آن مشخص شود..SS دستورهای \fBremote\-subnet4\-del\-by\-id\fP و \fBremote\-subnet6\-del\-by\-id\fP
.sp
این نخستین گونه از دستورهایی است که برای حذف یک زیرشبکه IPv4 یا IPv6 از پایگاه‌داده به کار می‌روند. این دستور از شناسهٔ زیرشبکه برای شناسایی آن استفاده می‌کند. برای نمونه، جهت حذف زیرشبکهٔ IPv4 با شناسهٔ ۵:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-subnet4\-del\-by\-id\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [
            {
                \(dqid\(dq: 5
            }
        ],
        \(dqremote\(dq: {
            \(dqtype\(dq: \(dqmysql\(dq
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پارامتر \fBserver\-tags\fP نمی‌تواند همراه با این دستور استفاده شود.
.SS دستورهای \fBremote\-subnet4\-del\-by\-prefix\fP و \fBremote\-subnet6\-del\-by\-prefix\fP
.sp
این دومین گونه از دستورهایی است که برای حذف یک زیرشبکه IPv4 یا IPv6 از پایگاه‌داده به کار می‌روند. این دستور از پیشوند زیرشبکه برای شناسایی آن استفاده می‌کند. برای نمونه:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-subnet6\-del\-by\-prefix\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [
            {
                \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq
            }
        ],
        \(dqremote\(dq: {
            \(dqtype\(dq: \(dqmysql\(dq
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پارامتر \fBserver\-tags\fP نمی‌تواند همراه با این دستور استفاده شود.
.SS دستورهای \fBremote\-subnet4\-get\-by\-id\fP و \fBremote\-subnet6\-get\-by\-id\fP
.sp
این نخستین گونه از دستورهایی است که برای واکشی یک زیرشبکه IPv4 یا IPv6 از پایگاه‌داده به کار می‌روند. این دستور از شناسهٔ زیرشبکه برای شناسایی آن استفاده می‌کند. برای نمونه:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-subnet4\-get\-by\-id\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [
            {
                \(dqid\(dq: 5
            }
        ],
        \(dqremote\(dq: {
            \(dqtype\(dq: \(dqmysql\(dq
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پارامتر \fBserver\-tags\fP نمی‌تواند همراه با این دستور استفاده شود.
.SS دستورهای \fBremote\-subnet4\-get\-by\-prefix\fP و \fBremote\-subnet6\-get\-by\-prefix\fP
.sp
این دومین گونه از دستورهایی است که برای واکشی یک زیرشبکه IPv4 یا IPv6 از پایگاه‌داده به کار می‌روند. این دستور از پیشوند زیرشبکه برای شناسایی آن استفاده می‌کند. برای نمونه:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-subnet6\-get\-by\-prefix\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [
            {
                \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq
            }
        ],
        \(dqremote\(dq: {
            \(dqtype\(dq: \(dqmysql\(dq
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پارامتر \fBserver\-tags\fP نمی‌تواند همراه با این دستور استفاده شود.
.SS دستورهای \fBremote\-subnet4\-list\fP و \fBremote\-subnet6\-list\fP
.sp
این دستورها برای فهرست کردن تمام زیرشبکه‌های IPv4 یا IPv6 از پایگاه‌داده برای سرورهای برگزیده یا همهٔ سرورها به کار می‌روند. دستور زیر تمامی سرورهای مورد استفاده توسط \(dqserver1\(dq و \(dqserver2\(dq را بازیابی می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-subnet4\-list\(dq,
    \(dqarguments\(dq: {
        \(dqremote\(dq: {
            \(dqtype\(dq: \(dqmysql\(dq
        },
        \(dqserver\-tags\(dq: [ \(dqserver1\(dq, \(dqserver2\(dq ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پارامتر \fBserver\-tags\fP اجباری است و شامل یک یا چند برچسب سرور است. این پارامتر می‌تواند حاوی کلیدواژهٔ \(dqall\(dq باشد تا زیرشبکه‌های مرتبط با همهٔ سرورها را واکشی کند. هنگامی که فهرست \fBserver\-tags\fP حاوی مقدار \fBnull\fP باشد، پاسخ بازگردانده‌شده شامل فهرستی از زیرشبکه‌های تخصیص‌نیافته خواهد بود، یعنی زیرشبکه‌هایی که با هیچ سروری مرتبط نیستند. برای نمونه:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-subnet4\-list\(dq,
    \(dqarguments\(dq: {
        \(dqremote\(dq: {
            \(dqtype\(dq: \(dqmysql\(dq
        },
        \(dqserver\-tags\(dq: [ null ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ نمونه به این دستور هنگامی که برچسب‌های سرور غیر \fBnull\fP مشخص شده باشند، شبیه به این خواهد بود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq2 IPv4 subnet(s) found.\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [
            {
                \(dqid\(dq: 1,
                \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
                \(dqshared\-network\-name\(dq: null,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ \(dqserver1\(dq, \(dqserver2\(dq ]
                }
            },
            {
                \(dqid\(dq: 2,
                \(dqsubnet\(dq: \(dq192.0.3.0/24\(dq,
                \(dqshared\-network\-name\(dq: null,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ \(dqall\(dq ]
                }
            }
        ],
        \(dqcount\(dq: 2
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
اطلاعات بازگردانده‌شده دربارهٔ هر زیرشبکه به شناسهٔ زیرشبکه، پیشوند و نام شبکهٔ مشترک مرتبط محدود می‌شود. برای بازیابی اطلاعات کامل دربارهٔ زیرشبکهٔ برگزیده، از دستور \fBremote\-subnet4\-get\-by\-id\fP / \fBremote\-subnet6\-get\-by\-id\fP یا دستور \fBremote\-subnet4\-get\-by\-prefix\fP / \fBremote\-subnet6\-get\-by\-prefix\fP استفاده کنید.
.sp
پاسخ نمونهٔ بالا شامل دو زیرشبکه است. یکی از زیرشبکه‌ها با هر دو سرور \(dqserver1\(dq و \(dqserver2\(dq مرتبط است. زیرشبکهٔ دوم با همهٔ سرورها مرتبط است، بنابراین در پیکربندی‌های \(dqserver1\(dq و \(dqserver2\(dq نیز حضور دارد.
.sp
هنگام فهرست کردن زیرشبکه‌های تخصیص‌نیافته، پاسخ مشابه این خواهد بود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq1 IPv4 subnet(s) found.\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [
            {
                \(dqid\(dq: 3,
                \(dqsubnet\(dq: \(dq192.0.4.0/24\(dq,
                \(dqshared\-network\-name\(dq: null,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ null ]
                }
            }
        ],
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
مقدار \fBnull\fP در متادیتا نشان می‌دهد که زیرشبکهٔ بازگردانده‌شده تخصیص‌نیافته است..SS دستورهای \fBremote\-subnet4\-set\fP و \fBremote\-subnet6\-set\fP
.sp
این دستورها برای ایجاد یک زیرشبکه جدید IPv4 یا IPv6 و یا جایگزینی یک زیرشبکه
موجود در پایگاه داده به کار می‌روند. تنظیم زیرشبکه همچنین آن را به یک
شبکه مشترک (shared network) منتسب یا از آن منفصل می‌کند.
.sp
ساختار اطلاعات زیرشبکه مشابه ساختاری است که در فایل پیکربندی استفاده می‌شود
(نگاه کنید به پیکربندی کارساز DHCPv4 \%<#\:dhcp4-configuration> و
پیکربندی کارساز DHCPv6 \%<#\:dhcp6-configuration>). اطلاعات زیرشبکه منتقل‌شده در
دستور \fBremote\-subnet4\-set\fP یا \fBremote\-subnet6\-set\fP
باید شامل پارامتر اضافی
\fBshared\-network\-name\fP باشد که مشخص می‌کند آیا زیرشبکه به یک
شبکه مشترک تعلق دارد یا خیر.
.sp
مثال زیر را در نظر بگیرید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-subnet4\-set\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [
            {
                \(dqid\(dq: 5,
                \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
                \(dqshared\-network\-name\(dq: \(dqlevel3\(dq,
                \(dqpools\(dq: [ { \(dqpool\(dq: \(dq192.0.2.100\-192.0.2.200\(dq } ],
                \(dqoption\-data\(dq: [ {
                    \(dqname\(dq: \(dqrouters\(dq,
                    \(dqdata\(dq: \(dq192.0.2.1\(dq
                } ]
            }
        ],
        \(dqremote\(dq: {
            \(dqtype\(dq: \(dqmysql\(dq
        },
        \(dqserver\-tags\(dq: [ \(dqall\(dq ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور زیرشبکه را ایجاد کرده و آن را به شبکه مشترک \(dqlevel3\(dq
منتسب می‌کند. شبکه مشترک \(dqlevel3\(dq باید پیش از ایجاد زیرشبکه با دستور
\fBremote\-network4\-set\fP ایجاد شده باشد.
.sp
اگر زیرشبکه ایجادشده باید سراسری (global) باشد \- یعنی به هیچ شبکه مشترکی
منتسب نباشد \- پارامتر \fBshared\-network\-name\fP باید صریحاً روی
\fBnull\fP تنظیم شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-subnet4\-set\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [
            {
                \(dqid\(dq: 5,
                \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
                \(dqshared\-network\-name\(dq: null,
                \(dqpools\(dq: [ { \(dqpool\(dq: \(dq192.0.2.100\-192.0.2.200\(dq } ],
                \(dqoption\-data\(dq: [ {
                    \(dqname\(dq: \(dqrouters\(dq,
                    \(dqdata\(dq: \(dq192.0.2.1\(dq
                } ]
           }
        ],
        \(dqserver\-tags\(dq: [ \(dqall\(dq ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
زیرشبکه ایجادشده در مثال قبلی با زیرشبکه جدیدی با همان پارامترها جایگزین می‌شود،
اما به صورت سراسری درمی‌آید.
.sp
پارامتر \fBshared\-network\-name\fP برای دستور
\fBremote\-subnet4\-set\fP اجباری است. فهرست \fBserver\-tags\fP اجباری است و باید
شامل یک یا چند برچسب کارساز باشد. در نتیجه، زیرشبکه به تمام
کارسازهای فهرست‌شده منتسب می‌شود. همچنین در صورتی که کلیدواژه \(dqall\(dq به عنوان
برچسب کارساز استفاده شود، ممکن است به تمام کارسازهای متصل به پایگاه داده منتسب گردد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
همانند سایر دستورهای \(dqset\(dq، این دستور در صورتی که اطلاعات زیرشبکه
از قبل موجود باشد، تمام اطلاعات مربوط به آن زیرشبکه خاص را در پایگاه داده
جایگزین می‌کند. بنابراین، هنگام ارسال این دستور، اطمینان حاصل کنید که همیشه تمام
پارامترهایی را که باید برای نمونه به‌روزشدهٔ زیرشبکه مشخص شوند بگنجانید.
هر پارامتر نامشخصی در پایگاه داده به عنوان نامشخص علامت‌گذاری خواهد شد، حتی اگر
مقدار آن پیش از ارسال دستور وجود داشته باشد.
.UNINDENT
.UNINDENT
.SS دستورهای \fBremote\-class4\-del\fP و \fBremote\-class6\-del\fP
.sp
این دستورها یک کلاس کلاینت DHCPv4 یا DHCPv6 را بر اساس نام حذف می‌کنند. اگر هر یک از
کلاس‌های کلاینت در پایگاه داده به کلاس حذف‌شده وابسته باشند، در پاسخ به این دستور یک
خطا بازگردانده می‌شود. در این حالت، برای حذف موفقیت‌آمیز کلاس، کلاس‌های کلاینت وابسته
باید ابتدا حذف شوند. از دستور \fBremote\-class4\-get\-all\fP برای دریافت همه
کلاس‌های کلاینت و پیدا کردن موارد وابسته استفاده کنید.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-class4\-del\(dq,
    \(dqarguments\(dq: {
        \(dqclient\-classes\(dq: [
            {
                \(dqname\(dq: \(dqfoo\(dq
            }
        ],
        \(dqremote\(dq: {
            \(dqtype\(dq: \(dqmysql\(dq
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پارامتر \fBserver\-tags\fP نمی‌تواند برای این دستور استفاده شود، زیرا کلاس‌های کلاینت
به صورت یکتا با نام شناسایی می‌شوند..SS دستورهای \fBremote\-class4\-get\fP و \fBremote\-class6\-get\fP
.sp
این دستورها اطلاعات کلاس کلاینت DHCPv4 یا DHCPv6 را بر اساس نام کلاس کلاینت بازیابی می‌کنند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-class4\-get\(dq,
    \(dqarguments\(dq: {
        \(dqclient\-classes\(dq: [
            {
                \(dqname\(dq: \(dqfoo\(dq
            }
        ],
        \(dqremote\(dq: {
            \(dqtype\(dq: \(dqmysql\(dq
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پارامتر \fBserver\-tags\fP نمی‌تواند برای این دستور استفاده شود، زیرا کلاس‌های کلاینت به صورت یکتا با نام شناسایی می‌شوند.
.sp
پاسخ این دستور شبیه به این است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqDHCPv4 client class \(aqfoo\(aq found.\(dq,
    \(dqarguments\(dq: {
        \(dqclient\-classes\(dq: [
            {
                \(dqname\(dq: \(dqfoo\(dq,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ \(dqall\(dq ]
                }
            }
        ],
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.SS دستورهای \fBremote\-class4\-get\-all\fP و \fBremote\-class6\-get\-all\fP
.sp
این دستورها تمام کلاس‌های کلاینت DHCPv4 یا DHCPv6 را برای یک سرور خاص، چندین سرور مشخص‌شده به طور صریح، و/یا همهٔ سرورها بازیابی می‌کنند. هر سرور معین، برچسب سرور اختصاصی خود را دارد و همچنین برچسب سرور \(dqall\(dq را داراست؛ این دستورها کلاس‌ها را هم برای یک سرور مستقل و هم برای سرورهای \(dqall\(dq بازیابی می‌کنند. برای مثال، دستور زیر تمام کلاس‌های کلاینت تعریف‌شده برای \(dqserver1\(dq و همچنین کلاس‌های کلاینت تعریف‌شده برای سرورهای \(dqall\(dq را بازیابی می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-class4\-get\-all\(dq,
    \(dqarguments\(dq: {
        \(dqremote\(dq: {
            \(dqtype\(dq: \(dqmysql\(dq
        },
        \(dqserver\-tags\(dq: [ \(dqserver1\(dq ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پارامتر \fBserver\-tags\fP اجباری است و شامل یک یا چند برچسب سرور می‌باشد. اگر برچسب‌های سرور دیگری مشخص شوند، نیازی به قرار دادن \(dqall\(dq در \fBserver\-tags\fP نیست، زیرا هر سرور به طور خودکار برچسب سرور \(dqall\(dq را نیز دارد. اگر \fBserver\-tags\fP تنها شامل کلیدواژهٔ \(dqall\(dq باشد، فقط کلاس‌های کلاینت مرتبط با سرورهای \(dqall\(dq بازگردانده می‌شوند. هنگامی که فهرست \fBserver\-tags\fP شامل مقدار \fBnull\fP باشد، پاسخ بازگردانده‌شده حاوی فهرستی از کلاس‌های کلاینت تخصیص‌نیافته خواهد بود، یعنی شبکه‌هایی که با هیچ سروری مرتبط نیستند.
.sp
پاسخ این دستور شبیه به این است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq2 DHCPv4 client class(es) found.\(dq,
    \(dqarguments\(dq: {
        \(dqclient\-classes\(dq: [
            {
                \(dqname\(dq: \(dqfoo\(dq,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ \(dqall\(dq ]
                }
            },
            {
                \(dqname\(dq: \(dqbar\(dq,
                \(dqtest\(dq: \(dqmember(\(aqfoo\(aq)\(dq,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ \(dqall\(dq ]
                }
            }
        ],
        \(dqcount\(dq: 2
    }
}
.EE
.UNINDENT
.UNINDENT
.SS دستورهای \fBremote\-class4\-set\fP و \fBremote\-class6\-set\fP
.sp
این دستورها یک کلاس کلاینت جدید DHCPv4 یا DHCPv6 را در پایگاه داده درج کرده یا یک کلاس موجود را جایگزین می‌کنند. ساختار اطلاعات کلاس کلاینت همانند فایل پیکربندی Kea است (برای جزئیات به Client Classification in DHCPv4 \%<#\:dhcp4-client-classifier> و Client Classification in DHCPv6 \%<#\:dhcp6-client-classifier> مراجعه کنید).
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-class4\-set\(dq,
    \(dqarguments\(dq: {
        \(dqclient\-classes\(dq: [
            {
                \(dqname\(dq: \(dqfoo\(dq,
                \(dqtest\(dq: \(dqmember(\(aqKNOWN\(aq) or member(\(aqbar\(aq)\(dq,
                \(dqoption\-def\(dq: [
                    {
                        \(dqname\(dq: \(dqconfigfile\(dq,
                        \(dqcode\(dq: 224,
                        \(dqtype\(dq: \(dqstring\(dq
                    }
                ],
                \(dqoption\-data\(dq: [
                    {
                        \(dqname\(dq: \(dqconfigfile\(dq,
                        \(dqdata\(dq: \(dq1APC\(dq
                    }
                ]
            }
        ],
        \(dqremote\(dq: {
            \(dqtype\(dq: \(dqmysql\(dq
        },
        \(dqserver\-tags\(dq: [ \(dqall\(dq ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
قوانین ترتیب کلاس‌های کلاینت که در Using Expressions in Classification \%<#\:classification-using-expressions> شرح داده شده‌اند، برای کلاس‌های درج‌شده در پایگاه داده نیز اعمال می‌شوند. این قوانین ایجاب می‌کنند کلاسی مانند \fIbar\fP که در عبارت ارزیابی (test) به آن ارجاع داده شده است، هنگام اجرای دستور بالا باید در پایگاه داده موجود باشد.
.sp
به صورت پیش‌فرض، یک کلاس کلاینت جدید در انتهای سلسله‌مراتب کلاس‌ها در پایگاه داده درج می‌شود و می‌تواند به هر کلاسی که با همان برچسب سرور یا با برچسب ویژهٔ سرور \(dqall\(dq مرتبط است ارجاع دهد. اگر یک کلاس موجود به‌روزرسانی شود، در موقعیت فعلی خود در سلسله‌مراتب کلاس‌ها باقی می‌ماند.
.sp
با این حال، دستورهای کلاس امکان مشخص کردن موقعیت کلاس کلاینتِ درج‌شده یا به‌روزرسانی‌شده را فراهم می‌سازند. پارامتر اختیاری \fBfollow\-class\-name\fP می‌تواند در دستور گنجانده شود تا نام کلاس موجودی را نشان دهد که کلاس مدیریت‌شده باید بعد از آن قرار گیرد. فرض کنید دو کلاس DHCPv6 در پایگاه داده وجود دارد: \fIfirst\-class\fP و \fIsecond\-class\fP\&. برای افزودن یک کلاس جدید، \fIthird\-class\fP، در بین این دو، از دستوری شبیه به این استفاده کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-class6\-set\(dq,
    \(dqarguments\(dq: {
        \(dqclient\-classes\(dq: [
            {
                \(dqname\(dq: \(dqthird\-class\(dq,
                \(dqtest\(dq: \(dqmember(\(aqfirst\-class\(aq)\(dq
            }
        ],
        \(dqfollow\-class\-name\(dq: \(dqfirst\-class\(dq,
        \(dqremote\(dq: {
            \(dqtype\(dq: \(dqmysql\(dq
        },
        \(dqserver\-tags\(dq: [ \(dqall\(dq ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
توجه داشته باشید که \fIthird\-class\fP می‌تواند به \fIfirst\-class\fP وابسته باشد زیرا پس از \fIfirst\-class\fP قرار گرفته است؛ اما \fIthird\-class\fP نمی‌تواند به \fIsecond\-class\fP وابسته باشد زیرا قبل از آن قرار دارد. با این حال، می‌توان \fIsecond\-class\fP را به‌روزرسانی کرد تا به \fIthird\-class\fP وابسته شود.
.sp
پارامتر \fBfollow\-class\-name\fP می‌تواند به صراحت روی \fBnull\fP تنظیم شود، مانند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-class6\-set\(dq,
    \(dqarguments\(dq: {
        \(dqclient\-classes\(dq: [
            {
                \(dqname\(dq: \(dqthird\-class\(dq,
                \(dqtest\(dq: \(dqmember(\(aqfirst\-class\(aq)\(dq
            }
        ],
        \(dqfollow\-class\-name\(dq: null,
        \(dqremote\(dq: {
            \(dqtype\(dq: \(dqmysql\(dq
        },
        \(dqserver\-tags\(dq: [ \(dqall\(dq ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این رفتار مشابه زمانی است که پارامتر \fBfollow\-class\-name\fP اصلاً گنجانده نشود؛ یعنی کلاس جدید به انتهای سلسله‌مراتب کلاس‌ها افزوده می‌شود و کلاس به‌روزرسانی‌شده در موقعیت فعلی خود باقی می‌ماند..SS \fBlibdhcp_class_cmds.so\fP: دستورات کلاس (Class Commands)
.sp
این کتابخانهٔ قلاب (hook library) چندین دستور کنترلی را برای دستکاری
کلاس‌های کلاینت (بخشی از پیکربندی سرورهای Kea DHCP) بدون نیاز به
راه‌اندازی مجدد این سرورها فراهم می‌کند. با استفاده از این دستورات،
افزودن، به‌روزرسانی، حذف و فهرست‌کردن کلاس‌های کلاینت پیکربندی‌شده
برای یک سرور معین امکان‌پذیر است.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
\fBlibdhcp_class_cmds.so\fP بخشی از کد متن‌باز است و برای همهٔ کاربران
Kea در دسترس است. این کتابخانه پیش‌تر فقط برای مشتریان ISC با قرارداد
پشتیبانی تجاری در دسترس بود.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این کتابخانه تنها توسط فرایند \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> یا
\fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> قابل بارگذاری است.
.UNINDENT
.UNINDENT
.SS دستور \fBclass\-add\fP
.sp
دستور \fBclass\-add\fP یک کلاس کلاینت جدید را به پیکربندی سرور DHCP
اضافه می‌کند. این کلاس به انتهای فهرست کلاس‌های مورد استفادهٔ سرور
پیوست می‌شود و می‌تواند به هر یک از کلاس‌های کلاینتی که قبلاً پیکربندی
شده‌اند وابسته باشد.
.sp
مثال زیر نحوهٔ افزودن یک کلاس کلاینت جدید را به پیکربندی سرور DHCPv4 نشان می‌دهد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqclass\-add\(dq,
    \(dqarguments\(dq: {
        \(dqclient\-classes\(dq: [
            {
                \(dqname\(dq: \(dqipxe_efi_x64\(dq,
                \(dqtest\(dq: \(dqoption[93].hex == 0x0009\(dq,
                \(dqnext\-server\(dq: \(dq192.0.2.254\(dq,
                \(dqserver\-hostname\(dq: \(dqhal9000\(dq,
                \(dqboot\-file\-name\(dq: \(dq/dev/null\(dq
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
توجه داشته باشید که پارامتر \fBclient\-classes\fP یک فهرست JSON است،
اما تنها اجازه می‌دهد یک کلاس کلاینت در آن قرار گیرد.
.sp
در اینجا پاسخ به دستور \fBclass\-add\fP در مثال ما آمده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqClass \(aqipxe_efi_x64\(aq added.\(dq
}
.EE
.UNINDENT
.UNINDENT
.SS دستور \fBclass\-update\fP
.sp
دستور \fBclass\-update\fP یک کلاس کلاینت موجود را در پیکربندی سرور
DHCP به‌روزرسانی می‌کند. اگر کلاس کلاینت با نام ارائه‌شده وجود نداشته
باشد، سرور کد نتیجهٔ 3 را برمی‌گرداند؛ به این معنی که پیکربندی سرور
تغییری نکرده و کلاس کلاینت وجود ندارد. در این صورت باید از دستور
\fBclass\-add\fP برای ایجاد کلاس کلاینت جدید استفاده شود.
.sp
دستور \fBclass\-update\fP همان ساختار آرگومان دستور \fBclass\-add\fP را دارد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqclass\-update\(dq,
    \(dqarguments\(dq: {
        \(dqclient\-classes\(dq: [
            {
                \(dqname\(dq: \(dqipxe_efi_x64\(dq,
                \(dqtest\(dq: \(dqoption[93].hex == 0x0017\(dq,
                \(dqnext\-server\(dq: \(dq0.0.0.0\(dq,
                \(dqserver\-hostname\(dq: \(dqxfce\(dq,
                \(dqboot\-file\-name\(dq: \(dq/dev/null\(dq
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
در اینجا پاسخ برای مثال ما آمده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqClass \(aqipxe_efi_x64\(aq updated.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
هر پارامتری از کلاس کلاینت را می‌توان با این دستور تغییر داد، به جز
\fBname\fP\&. در حال حاضر روشی برای تغییر نام کلاس وجود ندارد، زیرا
نام کلاس به‌عنوان کلید جستجوی کلاسی که باید به‌روزرسانی شود استفاده
می‌شود. برای دستیابی به اثری مشابه تغییر نام کلاس، می‌توان یک کلاس موجود
را با دستور \fBclass\-del\fP حذف کرد و سپس با استفاده از \fBclass\-add\fP
مجدداً آن را با نام متفاوتی اضافه نمود. با این حال توجه داشته باشید که کلاس
با نام جدید به انتهای فهرست کلاس‌های پیکربندی‌شده اضافه خواهد شد.
.sp
همانند دیگر دستورات به‌روزرسانی، این دستور تمام محتویات یک مدخل را
رونویسی (overwrite) می‌کند. اگر کلاس کلاینت قبلاً منبعی به آن اختصاص
یافته بود و در دستور \fBclass\-update\fP آن منبع ذکر نشده باشد، از
پیکربندی سرور حذف می‌شود. اگر به‌روزرسانی افزایشی کلاس مد نظر باشد،
می‌توان با اجرای یک \fBclass\-get\fP برای دریافت وضعیت فعلی کلاس کلاینت،
انتخاب کلاس کلاینت از پاسخ، اصلاح آن به نتیجهٔ دلخواه و سپس صدور
دستور \fBclient\-update\fP همراه با کلاس کلاینت حاصل به این هدف دست یافت..SS دستور \fBclass\-del\fP
.sp
دستور \fBclass\-del\fP برای حذف یک کلاس خاص از پیکربندی کارگزار استفاده می‌شود. کلاسی که باید حذف شود بر اساس نام شناسایی می‌شود. اگر کلاس‌های دیگری به آن وابسته باشند، کلاس حذف نمی‌شود؛ برای حذف چنین کلاسی، باید ابتدا کلاس‌های وابسته حذف شوند.
.sp
نمونه دستور زیر برای حذف کلاس \fBipxe_efi_x64\fP آورده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqclass\-del\(dq,
    \(dqarguments\(dq: {
        \(dqname\(dq: \(dqipxe_efi_x64\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
در اینجا پاسخ به دستور \fBclass\-del\fP در مثال ما، هنگامی که کلاس کلاینت مشخص‌شده پیدا شده است، مشاهده می‌شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqClass \(aqipxe_efi_x64\(aq deleted.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر کلاس وجود نداشته باشد، نتیجه‌ی ۳ بازگردانده می‌شود.
.SS دستور \fBclass\-list\fP
.sp
دستور \fBclass\-list\fP برای دریافت فهرستی از تمام کلاس‌های کلاینت به کار می‌رود. این دستور هیچ آرگومانی ندارد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqclass\-list\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
در اینجا پاسخ کارگزار در این مثال، شامل فهرست کلاس‌های کلاینت، آورده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq2 classes found\(dq,
    \(dqarguments\(dq: {
        \(dqclient\-classes\(dq: [
            {
                \(dqname\(dq: \(dqipxe_efi_x64\(dq
            },
            {
                \(dqname\(dq: \(dqpxeclient\(dq
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
توجه داشته باشید که فهرست بازگردانده‌شده شامل تعاریف کامل کلاس نیست، بلکه صرفاً نام کلاس‌ها را دربردارد. برای دریافت اطلاعات کامل کلاس، باید از دستور \fBclass\-get\fP استفاده شود.
.SS دستور \fBclass\-get\fP
.sp
دستور \fBclass\-get\fP برای بازیابی اطلاعات دقیق درباره یک کلاس مشخص استفاده می‌شود. ساختار این دستور بسیار ساده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqclass\-get\(dq,
    \(dqarguments\(dq: {
        \(dqname\(dq: \(dqpxeclient\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر کلاسی با نام مشخص‌شده وجود نداشته باشد، کد وضعیت ۳ بازگردانده می‌شود. اگر کلاس کلاینت مشخص‌شده وجود داشته باشد، جزئیات کلاس در قالب زیر بازگردانده می‌شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqClass \(aqpxeclient\(aq definition returned\(dq,
    \(dqarguments\(dq: {
        \(dqclient\-classes\(dq: [
            {
                \(dqname\(dq: \(dqpxeclient\(dq,
                \(dqonly\-in\-additional\-list\(dq: true,
                \(dqtest\(dq: \(dqoption[vendor\-class\-identifier].text == \(aqPXEClient\(aq\(dq,
                \(dqoption\-def\(dq: [
                    {
                        \(dqname\(dq: \(dqconfigfile\(dq,
                        \(dqcode\(dq: 209,
                        \(dqtype\(dq: \(dqstring\(dq
                    }
                ],
                \(dqoption\-data\(dq: [ ],
                \(dqnext\-server\(dq: \(dq0.0.0.0\(dq,
                \(dqserver\-hostname\(dq: \(dqxfce\(dq,
                \(dqboot\-file\-name\(dq: \(dq/dev/null\(dq
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
توجه داشته باشید که مثال بالا مختص DHCPv4 است؛ سه پارامتر پایانی تنها توسط کارگزار DHCPv4 بازگردانده می‌شوند و هرگز توسط کارگزار DHCPv6 بازگردانده نخواهند شد. همچنین، ممکن است برخی از پارامترهای ارائه‌شده در این مثال در صورتی که برای کلاس تعیین نشده باشند، بازگردانده نشوند. به‌طور مشخص، در صورتی که \fBonly\-in\-additional\-list\fP، \fBtest\fP و \fBoption\-def\fP برای کلاس مشخص نشده باشند، بازگردانده نمی‌شوند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
از نگارش 2.7.4 نرم‌افزار Kea، پارامتر \fBonly\-if\-required\fP با \fBonly\-in\-additional\-list\fP جایگزین شده و منسوخ گردیده است. برای اینکه به کاربران فرصت مهاجرت داده شود، دستورهای کلاس همچنان آن را به عنوان ورودی می‌پذیرند اما در خروجی به \fBonly\-in\-additional\-list\fP تبدیل می‌کنند. در نهایت، پشتیبانی از این نام قدیمی حذف خواهد شد.
.UNINDENT
.UNINDENT.SS \fBlibdhcp_ddns_tuning.so\fP: تنظیم دقیق DDNS
.sp
این کتابخانه قلاب (hook library) پشتیبانی از تنظیم دقیق جنبه‌های گوناگون به‌روزرسانی‌های DNS را اضافه می‌کند.
این کتابخانه در حال حاضر از تولید رویه‌ای نام میزبان و امکان چشم‌پوشی از انجام
به‌روزرسانی‌های DDNS برای کلاینت‌های مشخص پشتیبانی می‌کند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
کتابخانه \fBlibdhcp_ddns_tuning.so\fP بخشی از کد متن‌باز است و
برای تمام کاربران Kea در دسترس می‌باشد.
این کتابخانه پیش‌تر تنها در اختیار مشتریان ISC با قرارداد پشتیبانی تجاری قرار داشت.
.UNINDENT
.UNINDENT
.sp
این کتابخانه، که در Kea 2.1.5 افزوده شد، می‌تواند توسط دیمن‌های \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4>
و \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> با اضافه کردن آن به عنصر \fBhooks\-libraries\fP در پیکربندی
سرور بارگذاری شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqhooks\-libraries\(dq: [
        {
            \(dqlibrary\(dq: \(dqlibdhcp_ddns_tuning.so\(dq,
            \(dqparameters\(dq: {
                ...
            }
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.SS تولید رویه‌ای نام میزبان (Procedural Host\-Name Generation)
.sp
این کتابخانه قلاب امکان تولید رویه‌ای نام‌های میزبان را بر اساس یک عبارت فراهم می‌سازد.
این عبارت را می‌توان به‌صورت سراسری در پارامترهای قلاب با استفاده از \fIhostname\-expr\fP
تعریف کرد. در صورت تعریف سراسری، این عبارت برای تمامی میزبان‌ها در تمامی زیرشبکه‌ها اعمال می‌شود.
عبارت‌ها می‌توانند از تمام نشانه‌های (tokens) تعریف‌شده در Client Classification \%<#\:classify> استفاده کنند.
نمونه‌ای از یک عبارت سراسری در زیر نشان داده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqhooks\-libraries\(dq: [
        {
            \(dqlibrary\(dq: \(dqlibdhcp_ddns_tuning.so\(dq,
            \(dqparameters\(dq: {
                \(dqhostname\-expr\(dq: \(dq\(aqhost\-\(aq+hexstring(pkt4.mac,\(aq\-\(aq)\(dq,
                ...
            }
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
رفتار پیش‌فرض \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> این است که در صورت ارسال هر دو گزینه توسط یک کلاینت،
گزینه FQDN (کد 81) را بر گزینه نام میزبان (کد 12) ترجیح دهد. مثال زیر
\fBhostname\-expr\fP مورد نیاز برای معکوس کردن این قاعده را نشان می‌دهد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqhooks\-libraries\(dq: [
        {
            \(dqlibrary\(dq: \(dqlibdhcp_ddns_tuning.so\(dq,
            \(dqparameters\(dq: {
                \(dqhostname\-expr\(dq : \(dqifelse(option[12].exists, option[host\-name].text, option[81].text)\(dq
            }
        }
    ]
}
.EE
.UNINDENT
.UNINDENT
.sp
همچنین می‌توان این پارامتر را در یک زیرشبکه با استفاده از سازوکار user\-context تعریف کرد.
در صورت تعریف در سطح زیرشبکه، عبارت تنها برای آن زیرشبکه خاص اعمال خواهد شد. اگر عبارت
زیرشبکه به‌صورت تهی، \fB\(dq\(dq\fP، تعریف شود، استفاده از عبارت سراسری را برای آن زیرشبکه لغو (یا غیرفعال)
می‌کند. نمونه‌ای از یک عبارت در سطح زیرشبکه در زیر آورده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
 \(dqsubnet4\(dq: [{
     \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
     \(dqpools\(dq: [{
         \(dqpool\(dq: \(dq192.0.2.10 \- 192.0.2.20\(dq
     } ],

     \(dquser\-context\(dq: {
         \(dqddns\-tuning\(dq: {
             \(dqhostname\-expr\(dq: \(dq\(aqguest\-\(aq+int8totext(substring(pkt4.yiaddr, 0,1))+\(aq\-\(aq \e
                                       +int8totext(substring(pkt4.yiaddr, 1,2))+\(aq\-\(aq \e
                                       +int8totext(substring(pkt4.yiaddr, 2,3))+\(aq\-\(aq \e
                                       +int8totext(substring(pkt4.yiaddr, 3,4))\(dq
         }
     }
 }],
 ...
}
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
مقدار عبارت بالا از یک بک‌اسلش، \fB\e\fP، برای نمایش ادامه خط استفاده کرده است. این کار صرفاً
برای خوانایی بهتر است و یک ساختار معتبر JSON که توسط تجزیه‌گر Kea پشتیبانی شود نیست. مقدار واقعی باید
در یک خط ممتد نوشته شود.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
هنگام تولید نام میزبان باید به مسائل مربوط به حریم خصوصی توجه کرد. نام میزبان
معمولاً در سامانه عمومی DNS درج می‌شود. افشای شناسه‌هایی که می‌توان از آن‌ها
برای ردیابی دستگاه‌ها استفاده کرد، مانند آدرس MAC، معمولاً ایده بسیار نامناسبی است.
در مثال عبارت سراسری فوق، صرفاً جهت سادگی از آدرس MAC استفاده شده است.
.UNINDENT
.UNINDENT.SS تولید نام میزبان در DHCPv4
.sp
با نصب این کتابخانه، رفتار \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> هنگام ساخت نام‌های میزبان در پاسخ به پرس‌وجوی کلاینت (مانند DISCOVER یا REQUEST) به شرح زیر است:
.INDENT 0.0
.INDENT 3.5
1. اگر نام میزبان از طریق یک رزرو میزبان (host reservation) ارائه شده باشد، از آن به همراه پارامترهای رفتاری DDNS برای ساخت نام میزبان نهایی استفاده کنید. به مرحله 4 بروید.
.sp
2. اگر کلاینت گزینهٔ FQDN (گزینهٔ 81) را ارائه داده باشد، از مقدار نام دامنهٔ مشخص‌شده در آن، به همراه پارامترهای رفتاری DDNS، برای ساخت نام میزبان نهایی استفاده کنید. به مرحله 4 بروید.
.sp
3. اگر کلاینت گزینهٔ host\-name (گزینهٔ 12) را ارائه داده باشد، از نام میزبان مشخص‌شده در آن، به همراه پارامترهای رفتاری DDNS، برای ساخت نام میزبان نهایی استفاده کنید.
.sp
4. اگر یک عبارت host\-name مربوط به \fBddns\-tuning\fP در حوزهٔ کاری معتبر (چه سراسری یا زیرشبکه) وجود داشته باشد، نام میزبان را با استفاده از آن عبارت محاسبه کنید. اگر مقدار محاسبه‌شده یک نام کاملاً واجد شرایط (FQDN) نباشد و یک \fBddns\-qualifying\-suffix\fP در حوزهٔ کاری معتبر وجود داشته باشد، پسوند را به آن الحاق کنید.
.sp
5. اگر مقدار محاسبه‌شده توسط hook یک رشتهٔ خالی نباشد و با نام میزبان ساخته‌شده در مراحل 1 یا 2 تفاوت داشته باشد، مقدار محاسبه‌شده تبدیل به نام میزبان نهایی می‌شود.
.UNINDENT
.UNINDENT
.SS تولید نام میزبان در DHCPv6
.sp
با نصب این کتابخانه، رفتار \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> هنگام ساخت نام‌های میزبان در پاسخ به پرس‌وجوی کلاینت (مانند SOLICIT، REQUEST، RENEW یا REBIND) به شرح زیر است:
.INDENT 0.0
.INDENT 3.5
1. اگر کلاینت گزینهٔ FQDN (گزینهٔ 39) را ارائه داده باشد، از مقدار نام دامنهٔ مشخص‌شده در آن، به همراه پارامترهای رفتاری DDNS، برای ساخت نام میزبان نهایی استفاده کنید. به مرحله 4 بروید.
.sp
2. اگر کلاینت FQDN ارائه نداده باشد اما \fBddns\-replace\-client\-name\fP برابر با \fBalways\fP یا \fBwhen\-not\-present\fP باشد، شکل نهایی نام میزبان را محاسبه کرده و از آن برای ایجاد یک FQDN خروجی استفاده کنید. به مرحله 4 بروید.
.sp
3. اگر در این نقطه هیچ FQDN خروجی‌ای وجود نداشته باشد، پردازش client\-name برای این بسته متوقف می‌شود. بدون یک FQDN خروجی، هیچ راهی برای انتقال نام میزبان به کلاینت وجود ندارد.
.sp
4. اگر نام میزبان از طریق یک host reservation ارائه شده باشد، از آن به همراه پارامترهای رفتاری DDNS برای ساخت نام میزبان نهایی استفاده کنید؛ این مقدار جایگزین مقدار FQDN محاسبه‌شده در مراحل 1 یا 2 می‌شود.
.sp
5. اگر یک عبارت host name مربوط به \fBddns\-tuning\fP در حوزهٔ کاری معتبر (چه سراسری یا زیرشبکه) وجود داشته باشد، نام میزبان را با استفاده از آن عبارت محاسبه کنید. اگر مقدار محاسبه‌شده یک نام کاملاً واجد شرایط (FQDN) نباشد و یک \fBddns\-qualifying\-suffix\fP در حوزهٔ کاری معتبر وجود داشته باشد، پسوند را به آن الحاق کنید.
.sp
6. اگر مقدار محاسبه‌شده توسط hook یک رشتهٔ خالی نباشد و با نام میزبان ساخته‌شده در مراحل 1 یا 2 تفاوت داشته باشد، مقدار محاسبه‌شده تبدیل به نام میزبان نهایی می‌شود.
.UNINDENT
.UNINDENT
.SS نادیده گرفتن به‌روزرسانی‌های DDNS
.sp
\fBlibdhcp_ddns_tuning.so\fP همچنین امکان نادیده‌گرفتن به‌روزرسانی‌های DDNS را به‌ازای هر کلاینت فراهم می‌کند. این کتابخانه یک کلاس کلاینت ویژه به نام \(dqSKIP_DDNS\(dq را شناسایی می‌کند؛ هنگامی که یک کلاینت با این کلاس مطابقت داده شود، سرورهای Kea (\fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> و \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6>) درخواست‌های به‌روزرسانی DDNS (یا NCRها) را به \fBkea\-dhcp\-ddns\fP \%<#\:std-iscman-kea-dhcp-ddns>\& ارسال نمی‌کنند. یک مورد کاربرد رایج، نادیده‌گرفتن به‌روزرسانی‌های DDNS برای رزروهای میزبان با آدرس ثابت است. این کار به سادگی و تنها با انتساب این کلاس به host reservation، همان‌طور که در زیر نشان داده شده است، انجام می‌شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqreservations\(dq: [
    {
        \(dqhw\-address\(dq: \(dq01:02:03:04:05:06\(dq,
        \(dqip\-address\(dq: \(dq192.0.2.1\(dq,
        \(dqclient\-classes\(dq: [ \(dqSKIP_DDNS\(dq, \(dqfoo\(dq, \(dqbar\(dq ]
    }]
}
.EE
.UNINDENT
.UNINDENT
.sp
کتابخانهٔ هوک \fBlibdhcp_ddns_tuning.so\fP با هر بار درخواست، تمدید یا آزادسازی اجاره (lease) توسط کلاینت، وجود کلاس \fB\(dqSKIP_DDNS\(dq\fP را در فهرست کلاس‌های کلاینت بررسی کرده و به \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> دستور می‌دهد از ارسال به‌روزرسانی‌های DDNS صرف‌نظر کند. روند کاری مشابهی برای \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> نیز پشتیبانی می‌شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqreservations\(dq: [
    {
        \(dqduid\(dq: \(dq01:02:03:04:05:06\(dq,
        \(dqip\-address\(dq: \(dq2001:db8::1\(dq,
        \(dqclient\-classes\(dq: [ \(dqSKIP_DDNS\(dq, \(dqfoo\(dq, \(dqbar\(dq ]
    }]
}
.EE
.UNINDENT
.UNINDENT
.sp
اگرچه \(dqSKIP_DDNS\(dq یک کلاس ویژه است، اما می‌توان آن را با یک عبارت آزمایشی (test expression) تعریف کرد. تعریف آن به صورت زیر، به‌روزرسانی‌های DDNS را برای تمام کلاینت‌های KNOWN نادیده می‌گیرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqclient\-classes\(dq:[
    {
        \(dqname\(dq: \(dqSKIP_DDNS\(dq,
        \(dqtest\(dq: \(dqmember(\(aqKNOWN\(aq)\(dq
    }]
}
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
برای اینکه کلاس \fB\(dqSKIP_DDNS\(dq\fP اثرگذار باشد، کتابخانهٔ هوک \fBlibdhcp_ddns_tuning.so\fP باید بارگذاری شده باشد.
.UNINDENT
.UNINDENT.SS \fBlibdhcp_flex_id.so\fP: شناسه انعطاف‌پذیر برای رزروهای میزبان
.sp
نرم‌افزار Kea روشی برای مدیریت رزروهای میزبان فراهم می‌کند که شامل نشانی‌ها، پیشوندها، گزینه‌ها، کلاس‌های کلاینت و سایر قابلیت‌ها می‌شود. رزرو در DHCPv4 می‌تواند بر اساس نشانی سخت‌افزاری، DUID، circuit\-id، یا client\-id باشد، و در DHCPv6 بر اساس نشانی سخت‌افزاری یا DUID. با این حال، گاهی سناریوهایی وجود دارند که در آن‌ها رزرو پیچیده‌تر است؛ ممکن است از گزینه‌هایی غیر از موارد یادشده در بالا استفاده شود، بخش‌هایی از گزینه‌هایی خاص به کار رود، یا شاید حتی ترکیبی از چندین گزینه و فیلد برای شناسایی منحصربه‌فرد یک کلاینت استفاده شود. این سناریوها توسط برنامه قلاب (hook application) شناسه انعطاف‌پذیر (Flexible Identifiers) پوشش داده می‌شوند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
\fBlibdhcp_flex_id.so\fP بخشی از کد منبع‌باز است و در دسترس تمام کاربران Kea قرار دارد.
این کتابخانه پیش‌تر تنها برای مشتریان ISC با قرارداد پشتیبانی تجاری در دسترس بود.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این کتابخانه تنها می‌تواند توسط فرآیند \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> یا \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> بارگذاری شود.
.UNINDENT
.UNINDENT
.sp
\fBlibdhcp_flex_id.so\fP امکان تعریف یک عبارت (expression) را با استفاده از شیوه‌نگارشی که در ابتدا تنها برای دسته‌بندی کلاینت به کار می‌رفت فراهم می‌کند. (برای شرح مفصل ساختار نحوی موجود، Using Expressions in Classification \%<#\:classification-using-expressions> را ببینید.) یک تفاوت چشمگیر این است که برای دسته‌بندی کلاینت، عبارت در حال حاضر باید به \fBtrue\fP یا \fBfalse\fP ارزیابی شود، در حالی که انتظار می‌رود عبارت شناسه انعطاف‌پذیر به رشته‌ای ارزیابی گردد که به عنوان یک شناسه استفاده خواهد شد. این که عبارت به یک رشته خالی ارزیابی شود حالتی معتبر است (برای نمونه در مواردی که کلاینت گزینه‌های خاصی را ارسال نمی‌کند). سپس این عبارت برای هر بسته دریافتی ارزیابی شده و این ارزیابی شناسه‌ای تولید می‌کند که برای شناسایی کلاینت استفاده می‌شود. به‌ویژه، ممکن است رزروهای میزبانی وجود داشته باشند که به مقادیر خاصی از شناسه انعطاف‌پذیر گره خورده باشند.
.sp
این کتابخانه می‌تواند مشابه سایر کتابخانه‌های hook بارگذاری شود. این کتابخانه از پارامترهای زیر پشتیبانی می‌کند: \fBidentifier\-expression\fP، \fBreplace\-client\-id\fP و \fBignore\-iaid\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqhooks\-libraries\(dq: [
        {
            \(dqlibrary\(dq: \(dqlibdhcp_flex_id.so\(dq,
            \(dqparameters\(dq: {
                \(dqidentifier\-expression\(dq: \(dqexpression\(dq,
                \(dqreplace\-client\-id\(dq: false,
                \(dqignore\-iaid\(dq: false
            }
        },
        ...
    ]
}
.EE
.UNINDENT
.UNINDENT
.sp
کتابخانه شناسه انعطاف‌پذیر از هر دو پروتکل DHCPv4 و DHCPv6 پشتیبانی می‌کند.
.sp
بیایید موردی از یک شبکه IPv6 را در نظر بگیریم که برای هر یک از مشتریان متصل خود دارای یک رابط مستقل است. مشتریان می‌توانند هر دستگاهی را که می‌خواهند متصل کنند، بنابراین هر نوع شناسه‌ای (مانند یک client\-id) غیرقابل اتکا است. از این رو، مدیر شبکه ممکن است تصمیم بگیرد از گزینه‌ای که توسط یک relay agent درج شده برای تمایز بین کلاینت‌ها استفاده کند. در این استقرار خاص، مدیر شبکه تأیید کرده است که interface\-id برای هر رابطِ سمت مشتری منحصربه‌فرد است، بنابراین برای استفاده به عنوان رزرو مناسب است. با این حال، تنها شش بایت نخست interface\-id مد نظر است، زیرا بایت‌های باقی‌مانده یا به صورت تصادفی تغییر می‌کنند یا بین دستگاه‌ها یکتا نیستند. بنابراین، کاربر تصمیم می‌گیرد از شش بایت نخست گزینه interface\-id درج‌شده توسط relay agent استفاده کند. پس از افزودن \fBflex\-id\fP، هدف \fBhost\-reservation\-identifiers\fP می‌تواند با استفاده از پیکربندی زیر حاصل شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqsubnet6\(dq: [{
    # subnet definition starts here
    \(dqreservations\(dq: [{
        \(dqflex\-id\(dq: \(dq\(aqport1234\(aq\(dq,
        # value of the first 8 bytes of the interface\-id
        \(dqip\-addresses\(dq: [ \(dq2001:db8::1\(dq ]
    },
    ...
    ],
    ...
    },
    ...
    ],
    # end of subnet definitions
    \(dqhost\-reservation\-identifiers\(dq: [\(dqduid\(dq, \(dqflex\-id\(dq],
    # add \(dqflex\-id\(dq to reservation identifiers
    \(dqhooks\-libraries\(dq: [
        {
            \(dqlibrary\(dq: \(dqlibdhcp_flex_id.so\(dq,
            \(dqparameters\(dq: {
                \(dqidentifier\-expression\(dq: \(dqsubstring(relay6[0].option[18].hex,0,8)\(dq
            }
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
هنگام تنظیم عبارت باید دقت شود. اگر عبارت تغییر کند، ممکن است تمام مقادیر \fBflex\-id\fP تغییر کنند و احتمالاً تمام رزروهای مبتنی بر \fBflex\-id\fP تا زمانی که به صورت دستی به‌روزرسانی شوند غیرقابل استفاده گردند. اکیداً به مدیران سیستم توصیه می‌شود که کار را با عبارت و تعداد اندکی از رزروها شروع کرده و سپس در صورت نیاز عبارت را تنظیم کنند. به محض اینکه نتیجه مطلوب با عبارت حاصل شد، رزروهای میزبان می‌توانند در مقیاس وسیع‌تری مستقر شوند.
.UNINDENT
.UNINDENT
.sp
مقادیر \fBflex\-id\fP در رزروهای میزبان را می‌توان به دو شیوه مشخص کرد. نخست، می‌توانند به عنوان یک رشته هگز (hex string) بیان شوند؛ برای نمونه رشته \(dqbar\(dq می‌تواند به صورت 626174 نمایش داده شود. در غیر این صورت، می‌تواند به عنوان یک مقدار درون نقل‌قول (با استفاده از نقل‌قول‌های دوتایی و تکی) بیان شود، مانند \(dq\(aqbar\(aq\(dq. حالت نخست برای نویسه‌های قابل چاپ مناسب‌تر است، در حالی که مقادیر رشته هگز برای نویسه‌های غیرقابل چاپ راحت‌تر بوده و نیازی به استفاده از عملگر \fBhexstring\fP ندارند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqsubnet6\(dq: [{
    # subnet definition starts here
    \(dqreservations\(dq: [{
        \(dqflex\-id\(dq: \(dq01:02:03:04:05:06\(dq,
        # value of the first 8 bytes of the interface\-id
        \(dqip\-addresses\(dq: [ \(dq2001:db8::1\(dq ]
    },
    ...
    ],
    ...
    },
    ...
    ],
    # end of subnet definitions
    \(dqhost\-reservation\-identifiers\(dq: [\(dqduid\(dq, \(dqflex\-id\(dq],
    # add \(dqflex\-id\(dq to reservation identifiers
    \(dqhooks\-libraries\(dq: [
        {
            \(dqlibrary\(dq: \(dqlibdhcp_flex_id.so\(dq,
            \(dqparameters\(dq: {
                \(dqidentifier\-expression\(dq: \(dqvendor[4491].option[1026].hex\(dq
            }
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
یک سناریوی کمتر رایج که مثال‌های بالا ممکن است در آن سودمند واقع شوند، برای کلاینت‌های DHCPv6 است که DUID خود را بین تبادل‌ها تغییر می‌دهند. شناخته شده است که کلاینت‌های PXE خاصی بدین شیوه رفتار می‌کنند.
.UNINDENT
.UNINDENT.SS پرچم \fBreplace\-client\-id\fP
.sp
هنگامی که \fBreplace\-client\-id\fP روی \fBfalse\fP تنظیم شده باشد (که تنظیم پیش‌فرض است)،
\fBlibdhcp_flex_id.so\fP از شناسهٔ منعطف ارزیابی‌شده صرفاً برای
شناسایی رزروهای میزبان، یعنی جستجو برای رزروها در یک پایگاه داده،
استفاده می‌کند. این معادل عملکردی سایر شناسه‌ها، مشابه با آدرس سخت‌افزاری
یا circuit\-id است. با این حال، این حالت عملکردی به این معنی است که اگر
یک دستگاه کلاینت تعویض شود، ممکن است باعث ایجاد تداخل میان یک اجارهٔ موجود
(تخصیص‌یافته به دستگاه قدیمی) و اجارهٔ جدید در حال تخصیص به دستگاه جدید
شود. این تداخل به این دلیل رخ می‌دهد که شناسهٔ منعطف یکسانی برای دستگاه جایگزین‌شده
محاسبه می‌شود، بنابراین کارساز تلاش خواهد کرد همان اجاره را تخصیص دهد. عدم تطابق میان
شناسه‌های کلاینت ارسال‌شده توسط دستگاه جدید و دستگاه قدیمی باعث می‌شود که کارساز از این
تخصیص جدید تا زمان منقضی شدن اجارهٔ قبلی امتناع ورزد. بروز این مشکل به عبارت
خاصی که به عنوان شناسهٔ منعطف استفاده می‌شود وابسته است و در صورتی که فقط از
گزینه‌ها و سایر پارامترهایی استفاده شود که محل اتصال دستگاه را مشخص می‌کنند
(مانند circuit\-id)، به جای شناسایی خود دستگاه (مانند آدرس MAC)، احتمال
رخ دادن آن بیشتر است.
.sp
کتابخانهٔ \fBlibdhcp_flex_id.so\fP روشی برای غلبه بر مشکل تداخل‌های
اجاره از طریق جایگزینی پویای شناسهٔ کلاینت (یا DUID در DHCPv6) با مقداری
مشتق‌شده از شناسهٔ منعطف ارائه می‌دهد. کارساز پرس‌وجوی کلاینت را به گونه‌ای
پردازش می‌کند که گویی شناسهٔ منعطف در گزینهٔ شناسهٔ کلاینت (یا DUID) ارسال
شده است. این امر تضمین می‌کند که به کلاینت بازگشتی (که همان شناسهٔ منعطف برای آن
ارزیابی می‌شود)، علیرغم تغییر شناسهٔ کلاینت و/یا آدرس MAC، همان اجاره اختصاص
داده شود.
.sp
در ادامه یک پیکربندی نمونه که این رفتار را فعال می‌کند آورده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqhooks\-libraries\(dq: [
        {
            \(dqlibrary\(dq: \(dqlibdhcp_flex_id.so\(dq,
            \(dqparameters\(dq: {
                \(dqidentifier\-expression\(dq: \(dqexpression\(dq,
                \(dqreplace\-client\-id\(dq: true
            }
        },
        ...
    ]
}
.EE
.UNINDENT
.UNINDENT
.sp
در مورد DHCPv4، مقدار مشتق‌شده از شناسهٔ منعطف با افزودن یک بایت با
مقدار صفر به ابتدای شناسهٔ منعطف تشکیل می‌شود. در مورد DHCPv6، با افزودن دو بایت
صفر پیش از شناسهٔ منعطف تشکیل می‌گردد.
.sp
توجه داشته باشید که برای اعمال این سازوکار، کارساز DHCPv4 باید طوری پیکربندی
شود که مقدار گزینهٔ شناسهٔ کلاینت را در طول تخصیص اجاره رعایت کند، یعنی
\fBmatch\-client\-id\fP باید روی \fBtrue\fP تنظیم شده باشد\&. برای جزئیات به
Using Client Identifier and Hardware Address \%<#\:dhcp4-match-client-id> مراجعه کنید. هیچ تنظیم
اضافی برای DHCPv6 لازم نیست.
.sp
اگر گزینهٔ \fBreplace\-client\-id\fP روی \fBtrue\fP تنظیم شود، مقدار پارامتر
\fBecho\-client\-id\fP (که ارسال مجدد گزینهٔ client\-id را کنترل می‌کند)
نادیده گرفته می‌شود.
.sp
بخش libdhcp_lease_cmds.so: Lease Commands for Easier Lease Management دستورهایی را شرح می‌دهد که برای
بازیابی، به‌روزرسانی و حذف اجاره‌ها با استفاده از شناسه‌های گوناگون، مانند \fBhw\-address\fP و
\fBclient\-id\fP استفاده می‌شوند\&. \fBlibdhcp_lease_cmds.so\fP به طور بومی از پرس‌وجوی
اجاره‌ها بر اساس شناسهٔ منعطف پشتیبانی نمی‌کند. با این حال، هنگامی که \fBreplace\-client\-id\fP
روی \fBtrue\fP تنظیم شده باشد، امکان پرس‌وجوی اجاره‌ها را با استفاده از مقداری
مشتق‌شده از شناسهٔ منعطف فراهم می‌سازد. در DHCPv4، پرس‌وجو شبیه به این
است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqlease4\-get\(dq,
    \(dqarguments\(dq: {
        \(dqidentifier\-type\(dq: \(dqclient\-id\(dq,
        \(dqidentifier\(dq: \(dq00:54:64:45:66\(dq,
        \(dqsubnet\-id\(dq: 44
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
که در آن مقدار هگزادسیمال \(dq54:64:45:66\(dq یک شناسهٔ منعطف محاسبه‌شده
برای کلاینت است.
.sp
در DHCPv6، پرس‌وجوی متناظر چیزی شبیه به این است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqlease6\-get\(dq,
    \(dqarguments\(dq: {
        \(dqidentifier\-type\(dq: \(dqduid\(dq,
        \(dqidentifier\(dq: \(dq00:00:54:64:45:66\(dq,
        \(dqsubnet\-id\(dq: 10
    }
}
.EE
.UNINDENT
.UNINDENT
.SS پرچم \fBignore\-iaid\fP
.sp
هنگامی که \fBignore\-iaid\fP روی \fBtrue\fP تنظیم شود (مقدار پیش‌فرض \fBfalse\fP است)،
\fBlibdhcp_flex_id.so\fP باعث می‌شود کارساز Kea DHCPv6 مقدار IAID را از
بسته‌های ورودی IPv6 نادیده بگیرد. این پارامتر توسط کارساز Kea DHCPv4 نادیده گرفته می‌شود.
.sp
اگر بسته تنها شامل یک IA_NA باشد، مقدار IAID به \fB0\fP تغییر کرده
و به همین صورت در مخزن اجاره ذخیره خواهد شد. به طور مشابه، اگر بسته تنها
شامل یک IA_PD باشد، مقدار IAID به \fB0\fP تغییر یافته و به همین صورت در
مخزن اجاره ذخیره می‌شود. IAID در پاسخ بازگشتی به کلاینت به مقدار اولیهٔ خود
بازگردانده می‌شود. این تغییر در عبارت شناسه (identifier expression) در صورتی که IAID
بخشی از عبارت باشد، قابل مشاهده است.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
برای جلوگیری از تداخل اجاره‌ها، اگر بستهٔ ورودی شامل بیش از یک IA_NA باشد،
مقدار IAID روی هیچ‌یک از IA_NAها تغییر نخواهد کرد. به طور مشابه،
اگر بستهٔ ورودی شامل بیش از یک IA_PD باشد، مقدار IAID روی هیچ‌یک
از IA_PDها تغییر نمی‌کند.
.UNINDENT
.UNINDENT
.sp
\fBهشدار:\fP
.INDENT 0.0
.INDENT 3.5
این قابلیت با استانداردهای RFC مغایرت دارد و فقط در صورت لزوم باید
فعال شود. در صورت فعال شدن، یک پیام هشدار در زمان پیکربندی صادر می‌شود.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
پارامتر \fBignore\-iaid\fP مستقل از قابلیت شناسهٔ منعطف عمل می‌کند
و می‌توان از آن بدون مشخص کردن مقداری برای \fBidentifier\-expression\fP استفاده کرد\&.
هنگامی که \fBidentifier\-expression\fP حذف شود یا به عنوان یک رشتهٔ خالی، \fI\(dq\(dq\fP،
مشخص گردد، قابلیت شناسهٔ منعطف غیرفعال می‌شود. نسخه‌های Kea پیش از 3.1.2 نیازمند
مقداری برای \fBidentifier\-expression\fP هستند اما مقدار رشتهٔ خالی را می‌پذیرند. از
نسخهٔ Kea 3.1.2 به بعد، این پارامتر اختیاری است.
.UNINDENT
.UNINDENT.SS \fBlibdhcp_flex_option.so\fP: کنش‌های انعطاف‌پذیر گزینه برای تنظیم مقادیر گزینه‌ها
.sp
این کتابخانه به مدیران سیستم اجازه می‌دهد تا بر اساس نتیجه یک عبارت، کنشی را برای یک گزینه مشخص تعریف کنند. این کنش‌ها در مراحل نهایی ساخت بسته پاسخ پرسش (query response)، درست پیش از ارسال آن به کلاینت، اجرا می‌شوند. سه کنشی که در حال حاضر پشتیبانی می‌شوند عبارتند از \fBadd\fP، \fBsupersede\fP و \fBremove\fP\&.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
\fBlibdhcp_flex_option.so\fP بخشی از کد متن‌باز است و برای همه کاربران Kea در دسترس است.
.UNINDENT
.UNINDENT
.sp
سینتکس مورد استفاده برای عبارات کنش، همان سینتکسی است که برای طبقه‌بندی کلاینت (client classification) و کتابخانه قلاب (hook) شناسه منعطف (Flexible Identifier) استفاده می‌شود؛ برای شرح دقیق سینتکس، بخش Using Expressions in Classification \%<#\:classification-using-expressions> یا libdhcp_flex_id.so: Flexible Identifier for Host Reservations را ببینید.
.sp
کنش‌های \fBadd\fP و \fBsupersede\fP از عبارتی استفاده می‌کنند که یک رشته برمی‌گرداند، و در صورتی که رشته خالی باشد کاری انجام نمی‌دهند. کاربرد \fBremove\fP از عبارتی استفاده می‌کند که مقدار \fBtrue\fP یا \fBfalse\fP برمی‌گرداند، و در صورت \fBfalse\fP بودن کاری انجام نمی‌دهد. هنگامی که لازم باشد یک گزینه روی مقدار خالی تنظیم شود، این سازوکار کارایی ندارد، اما در عوض می‌توان از یک کلاس کلاینت (client class) استفاده کرد.
.sp
کنش \fBadd\fP تنها زمانی یک گزینه را اضافه می‌کند که آن گزینه از قبل وجود نداشته باشد و عبارت به رشته خالی ارزیابی نشود. کنش \fBsupersede\fP مشابه است، اما در صورتی که گزینه از قبل وجود داشته باشد، مقدار آن را بازنویسی می‌کند. کنش \fBremove\fP در صورتی که گزینه از قبل وجود داشته باشد و عبارت به \fBtrue\fP ارزیابی شود، آن گزینه را از بسته پاسخ حذف می‌کند.
.sp
گزینه‌ای که کنش بر آن اعمال می‌شود را می‌توان از طریق کد عددی یا نام آن مشخص کرد؛ مشخص کردن کد یا نام الزامی است. فضای گزینه (option space) بسته به سروری که کتابخانه هوک در آن بارگذاری شده است، DHCPv4 یا DHCPv6 خواهد بود.
.sp
\fBlibdhcp_flex_option.so\fP می‌تواند توسط هر یک از فرایندهای \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> یا \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> بارگذاری شود. این کتابخانه یک پارامتر اجباری \fBoptions\fP به همراه فهرستی از نگاشت‌های پارامتری به ازای هر گزینه دریافت می‌کند که شامل کنش‌های \fBcode\fP، \fBname\fP، \fBadd\fP، \fBsupersede\fP و \fBremove\fP است. مدخل‌های کنش یک مقدار رشته‌ای می‌پذیرند که نشان‌دهنده یک عبارت است.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
   \(dqDhcp4\(dq: {
       \(dqhooks\-libraries\(dq: [
           {
               \(dqlibrary\(dq: \(dqlibdhcp_flex_option.so\(dq,
               \(dqparameters\(dq: {
                   \(dqoptions\(dq: [
                       {
                           \(dqcode\(dq: 67,
                           \(dqadd\(dq: \(dqifelse(option[host\-name].exists,concat(option[host\-name].text,\(aq.boot\(aq),\(aq\(aq)\(dq
                       }
                   ]
               }
           }
       ]
   }
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر (و تنها اگر) بسته \fBquery\fP شامل گزینه \fBhost\-name\fP (کد ۱۲) باشد، گزینه \fBboot\-file\-name\fP (کد ۶۷) با محتوای نام میزبان به همراه پسوند \fB\&.boot\fP به پاسخ افزوده می‌شود.
.sp
یکی از کاربردهای متداول، تغییر دادن گزینه subnet mask در DHCPv4 (کد ۱) است. مثال زیر این قابلیت را نشان می‌دهد، که در آن به تمامی بسته‌های ورودی شناسایی‌شده با آدرس درگاه 192.168.0.1، با یک ماسک زیرشبکه ۳۲/ در پاسخ پاسخ داده می‌شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqDhcp4\(dq: {
        \(dqhooks\-libraries\(dq: [
            {
                \(dqlibrary\(dq: \(dqlibdhcp_flex_option.so\(dq,
                \(dqparameters\(dq: {
                    \(dqoptions\(dq: [
                        {
                            \(dqcode\(dq: 1,
                            \(dqsupersede\(dq: \(dqifelse(pkt4.giaddr==192.168.0.1, \(aq255.255.255.255\(aq, \(aq\(aq)\(dq
                        }
                    ]
                }
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
کتابخانه Flexible Option هم از DHCPv4 و هم از DHCPv6 پشتیبانی می‌کند.
.sp
کنش‌های \fBadd\fP و \fBsupersede\fP یک پارامتر بولی اختیاری \fBcsv\-format\fP دریافت می‌کنند. اگر مشخص نشود یا روی \fBfalse\fP تنظیم شود، داده‌های گزینه با استفاده از مقدار خام عبارت ارزیابی‌شده تنظیم می‌شوند. هنگامی که روی \fBtrue\fP پیکربندی شده باشد، این مقدار با استفاده از تعریف گزینه برگرفته از داده‌های گزینه مشخص‌شده در فایل پیکربندی تجزیه می‌شود. این قابلیت تنظیم مقادیر را برای گزینه‌هایی که از ساختارهای رکوردی پیچیده یا نام‌های دامنه کاملاً واجد شرایط (FQDN) استفاده می‌کنند، آسان می‌سازد.
.sp
برای نمونه، اگر ارزیابی عبارت مقدار \(dqexample.com\(dq را برگرداند و گزینه با نوع \fBfqdn\fP تعریف شده باشد، نام دامنه به قالب باینری DNS کدگذاری می‌شود.
.sp
از نسخه 2.1.4 نرم‌افزار Kea به بعد، پارامتر \fBclient\-class\fP یک محافظ کلاس (class guard) را مشخص می‌کند و نام یک client\-class را می‌پذیرد. در صورتی که خالی نباشد، بسته کلاینت برای استفاده از این مدخل باید به کلاس مشخص‌شده تعلق داشته باشد.
.sp
همچنین امکان داشتن چندین مدخل برای یک گزینه یکسان وجود دارد، اما هر مدخل باید دقیقاً دارای یک کنش باشد. اگر گزینه در \fBdhcp4\fP برای DHCPv4 یا در \fBdhcp6\fP برای DHCPv6 تعریف نشده باشد، محل تعریف گزینه را می‌توان با استفاده از نام آن، از طریق پارامتر جدید \fBspace\fP مشخص کرد.
.sp
از نسخه 2.1.4 نرم‌افزار Kea به بعد، زیرگزینه‌ها (sub\-options) با مدخل جدید \fBsub\-options\fP پشتیبانی می‌شوند که جایگزین کنش در پیکربندی گزینه دربرگیرنده (یعنی گزینه‌ای که زیرگزینه‌ها در آن قرار دارند) می‌شود.
.sp
پارامتر \fBsub\-options\fP فهرستی از مدخل‌های زیرگزینه را دریافت می‌کند که هر یک شامل موارد زیر است:
.INDENT 0.0
.IP \(bu 2
\fBcode\fP \- کد زیرگزینه را مشخص می‌کند؛ مشخص کردن \fBcode\fP یا \fBname\fP الزامی است. اگر هر دو ارائه شوند، باید با یکدیگر مطابقت داشته باشند وگرنه پیکربندی در زمان بارگذاری رد می‌شود.
.IP \(bu 2
\fBname\fP \- نام زیرگزینه را مشخص می‌کند؛ مشخص کردن \fBcode\fP یا \fBname\fP الزامی است. اگر هر دو ارائه شوند، باید با یکدیگر مطابقت داشته باشند وگرنه پیکربندی در زمان بارگذاری رد می‌شود.
.IP \(bu 2
\fBspace\fP \- فضایی را مشخص می‌کند که زیرگزینه می‌تواند در آن تعریف شود. این پارامتر اختیاری است، زیرا می‌تواند از تعریف گزینه دربرگیرنده استخراج شود. اگر هیچ نام فضای معتبری در زمان بارگذاری موجود نباشد، پیکربندی رد می‌شود. توجه داشته باشید که فضاهای سازنده (vendor spaces) هم برای \fBvivso\-suboptions\fP در DHCPv4 و هم برای \fBvendor\-opts\fP در DHCPv6، چه از پیش‌تعریف‌شده (مانند شناسه سازنده DoCSIS با کد 4491) و چه سفارشی، پشتیبانی می‌شوند.
.IP \(bu 2
\fBadd\fP \- (کنش) زیرگزینه را تنها در صورتی اضافه می‌کند که از قبل وجود نداشته باشد و عبارت به رشته خالی ارزیابی نشود.
.IP \(bu 2
\fBsupersede\fP \- (کنش) در صورتی که عبارت به رشته خالی ارزیابی نشود، زیرگزینه را اضافه یا بازنویسی می‌کند.
.IP \(bu 2
\fBremove\fP \- (کنش) در صورتی که زیرگزینه از قبل وجود داشته باشد و عبارت به true ارزیابی شود، آن را حذف می‌کند.
.IP \(bu 2
\fBcontainer\-add\fP \- یک مقدار بولی است که مشخص می‌کند آیا در صورت عدم وجود گزینه دربرگیرنده در کنش‌های \fBadd\fP و \fBsupersede\fP، این گزینه باید ایجاد شود یا خیر. در صورت عدم تعیین، مقدار پیش‌فرض آن \fBtrue\fP است\&.
.IP \(bu 2
\fBcontainer\-remove\fP \- یک مقدار بولی است که مشخص می‌کند آیا پس از حذف یک زیرگزینه توسط کنش \fBremove\fP، در صورتی که گزینه دربرگیرنده خالی بماند، باید حذف شود یا خیر. در صورت عدم تعیین، مقدار پیش‌فرض آن \fBtrue\fP است\&.
.IP \(bu 2
\fBcsv\-format\fP \- یک مقدار بولی است که مشخص می‌کند آیا مقدار خام عبارت ارزیابی‌شده استفاده شود (false، پیش‌فرض) یا با استفاده از تعریف زیرگزینه تجزیه شود (true).
.IP \(bu 2
\fBclient\-class\fP \- مشخص می‌کند که آیا در صورت عدم تعلق \fBquery\fP به کلاس کلاینت مشخص‌شده، باید از مدخل زیرگزینه صرف‌نظر شود یا خیر. توجه داشته باشید که پارامتر مشابه در مدخل گزینه دربرگیرنده، بر کل فهرست \fBsub\-options\fP اعمال می‌شود.
.UNINDENT
.sp
برای نمونه، این پیکربندی یک زیرگزینه رشته‌ای را به گزینه \fBvendor\-encapsulated\-options\fP در DHCPv4 (کد ۴۳) اضافه می‌کند. این گزینه فضای \fBvendor\-encapsulated\-options\fP را کپسوله‌سازی می‌کند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
   \(dqDhcp4\(dq: {
       \(dqhooks\-libraries\(dq: [
           {
               \(dqlibrary\(dq: \(dqlibdhcp_flex_option.so\(dq,
               \(dqparameters\(dq: {
                   \(dqoptions\(dq: [
                       {
                           \(dqcode\(dq: 43,
                           \(dqsub\-options\(dq: [
                               {
                                  \(dqcode\(dq: 1,
                                  \(dqadd\(dq: \(dq\(aqfoobar\(aq\(dq
                               }
                           ]
                       }
                   ]
               }
           }
       ]
   }
}
.EE
.UNINDENT
.UNINDENT.SS \fBlibddns_gss_tsig.so\fP: امضای به‌روزرسانی‌های DNS با GSS\-TSIG
.sp
این کتابخانهٔ قلاب به سرور \fBkea\-dhcp\-ddns\fP \%<#\:std-iscman-kea-dhcp-ddns> اجازه می‌دهد تا از
GSS\-TSIG برای امضای به‌روزرسانی‌های DNS استفاده کند. برای بحث و بررسی کامل دربارهٔ GSS\-TSIG در Kea،
لطفاً به GSS\-TSIG \%<#\:gss-tsig>\& مراجعه کنید.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
\fBlibddns_gss_tsig.so\fP بخشی از کد متن‌باز است و
برای تمامی کاربران Kea در دسترس است.
این کتابخانه پیش‌تر تنها برای مشتریان ISC دارای قرارداد پشتیبانی تجاری در دسترس بود.
.UNINDENT
.UNINDENT
.SS \fBlibdhcp_ha.so\fP: تاب‌آوری در برابر قطعی با دسترسی‌پذیری بالا برای سرورهای Kea
.sp
این کتابخانهٔ قلاب می‌تواند بر روی یک جفت سرور DHCPv4 یا DHCPv6 بارگذاری شود تا
قابلیت اطمینان سرویس DHCP در صورت وقوع قطعی در یک سرور افزایش یابد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
\fBlibdhcp_ha.so\fP بخشی از کد متن‌باز است و
برای تمامی کاربران Kea در دسترس است.
این کتابخانه پیش‌تر تنها برای مشتریان ISC دارای قرارداد پشتیبانی تجاری در دسترس بود.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این کتابخانه تنها می‌تواند توسط فرایند \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> یا \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> بارگذاری شود.
.UNINDENT
.UNINDENT
.sp
دسترسی‌پذیری بالا (HA) برای سرویس DHCP از طریق اجرای چندین نمونه سرور همکار
فراهم می‌شود. اگر هر یک از این نمونه‌ها به هر دلیلی (از کار افتادن نرم‌افزار DHCP، قطعی برق،
خرابی سخت‌افزار) از دسترس خارج شود، نمونه سرور بازمانده می‌تواند به ارائهٔ سرویس قابل‌اطمینان
به کلاینت‌ها ادامه دهد. بسیاری از پیاده‌سازی‌های سرور DHCP شامل پروتکل \(dqDHCP Failover\(dq
هستند که مهم‌ترین ویژگی‌های آن ارتباط میان سرورها،
تشخیص خرابی همتا، و همگام‌سازی اجاره‌ها میان سرورها است.
با این حال، فرایند استانداردسازی failover برای DHCPv4 هرگز توسط
IETF تکمیل نشد. استاندارد failover برای DHCPv6 (RFC 8156) منتشر شد، اما پیچیده
و استفاده از آن دشوار است، محدودیت‌های عملیاتی چشمگیری دارد، و با همتای
v4 خود متفاوت است. اگرچه استفاده از یک پروتکل failover \(dqاستاندارد\(dq ممکن است مفید باشد،
بیشتر کاربران Kea صرفاً به دنبال یک راهکار کاربردی هستند که
دسترسی‌پذیری بالای سرویس DHCP را تضمین کند. از این رو، کتابخانهٔ قلاب Kea HA
مفاهیم اصلی را از پروتکل DHCP failover برگرفته، اما از راهکارهای
اختصاصی خود برای ارتباطات و پیکربندی استفاده می‌کند. این کتابخانه ماشین وضعیت اختصاصی خود را ارائه می‌دهد
که پیاده‌سازی آن را بسیار ساده‌تر کرده و به‌طور کلی سازگاری بهتری با Kea دارد،
و قابلیت‌های یکسانی را در هر دو DHCPv4 و DHCPv6 فراهم می‌آورد. این سند
عمداً از اصطلاح \(dqhigh availability\(dq به جای \(dqfailover\(dq استفاده می‌کند تا
تأکید کند که این پیاده‌سازیِ پروتکل failover نیست.
.sp
بخش‌های بعدی به شرح پیکربندی و نحوهٔ کارکرد کتابخانهٔ قلاب
Kea HA می‌پردازند.
.SS پیکربندی‌های پشتیبانی‌شده (Supported Configurations)
.sp
کتابخانهٔ قلاب Kea HA از سه پیکربندی، که با عنوان حالت‌های HA نیز شناخته می‌شوند، پشتیبانی می‌کند:
\fBload\-balancing\fP، \fBhot\-standby\fP و \fBpassive\-backup\fP\&. در حالت
\fBload\-balancing\fP، دو سرور به درخواست‌های DHCP پاسخ می‌دهند. عملکرد
\fBload\-balancing\fP همان‌گونه که در RFC
3074 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc3074> شرح داده شده پیاده‌سازی گردیده است، و هر سرور به
نیمی از پرس‌وجوهای DHCP دریافتی پاسخ می‌دهد. هنگامی که یکی از سرورها اجاره‌ای را برای یک
کلاینت تخصیص می‌دهد، از طریق کانال کنترل (از طریق RESTful
API) به سرور همتا اطلاع می‌دهد تا همتا بتواند اطلاعات اجاره را در پایگاه دادهٔ خود ذخیره کند. اگر
ارتباط با سرور همتا ناموفق باشد، پرس‌وجوی DHCP دور انداخته می‌شود و
پاسخی به کلاینت DHCP بازگردانده نخواهد شد. اگر به‌روزرسانی اجاره
موفقیت‌آمیز باشد، پاسخ توسط سروری که اجاره را
تخصیص داده به کلاینت DHCP ارسال می‌شود. با تبادل به‌روزرسانی‌های اجاره، هر دو سرور رونوشتی از تمامی
اجاره‌های تخصیص‌یافته توسط کل راه‌اندازی HA را دریافت می‌کنند، و در صورت از دسترس خارج شدن همتا،
هر یک از سرورها می‌توانند برای مدیریت کل ترافیک DHCP تغییر وضعیت دهند.
.sp
در پیکربندی \fBload\-balancing\fP، یکی از سرورها باید به عنوان
\fBprimary\fP و دیگری به عنوان \fBsecondary\fP تعیین شود. از نظر عملکردی، تفاوتی
میان این دو در طول کارکرد عادی وجود ندارد. با این حال، این تمایز
هنگامی لازم است که دو سرور (تقریباً) در یک زمان راه‌اندازی شوند و ناچار باشند
پایگاه‌های دادهٔ اجارهٔ خود را همگام‌سازی کنند. سرور primary ابتدا پایگاه داده را
همگام می‌کند. سرور secondary قبل از شروع همگام‌سازی خود، منتظر می‌ماند تا سرور primary
همگام‌سازی پایگاه دادهٔ اجاره را به پایان برساند.
.sp
در پیکربندی \fBhot\-standby\fP، یکی از سرورها به عنوان
\fBprimary\fP و دیگری به عنوان \fBstandby\fP تعیین می‌شود. در طول کارکرد عادی، سرور primary
تنها سروری است که به درخواست‌های DHCP پاسخ می‌دهد. سرور standby
به‌روزرسانی‌های اجاره را از سرور primary از طریق کانال کنترل دریافت می‌کند؛ با این حال،
تا زمانی که primary در حال اجرا باشد، یا به بیان دقیق‌تر،
تا زمانی که standby سرور primary را آفلاین نداند، به هیچ پرس‌وجوی DHCP پاسخ نمی‌دهد. اگر
سرور standby خرابی سرور primary را تشخیص دهد، شروع به پاسخ‌گویی به تمام
پرس‌وجوهای DHCP می‌کند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
مدیران سیستم اغلب در این فکرند که آیا از حالت \fBload\-balancing\fP استفاده کنند یا
\fBhot\-standby\fP. حالت \fBload\-balancing\fP این مزیت را دارد که بار DHCP را
بین دو نمونه تقسیم کرده و ترافیک پردازش‌شده توسط هر یک از آن‌ها را کاهش می‌دهد.
با این حال، همیشه برای مدیران سیستم واضح نیست که استفاده از
حالت \fBload\-balancing\fP مستلزم تقسیم دستی استخرهای آدرس بین
دو نمونهٔ Kea با استفاده از کلاس‌بندی کلاینت است، تا از تخصیص
آدرس یکسان توسط هر دو سرور به کلاینت‌های مختلف ممانعت به عمل آید.
چنین تفکیکی در حالت \fBhot\-standby\fP مورد نیاز نیست. بنابراین، مزیت
استفاده از \fBhot\-standby\fP نسبت به \fBload\-balancing\fP این است که پیکربندی
ساده‌تری دارد. در مقابل، \fBload\-balancing\fP پتانسیل کارایی بالاتری دارد
اما به بهای پیکربندی پیچیده‌تر تمام می‌شود.
برای جزئیات بیشتر در مورد چگونگی تقسیم استخرها با
استفاده از کلاس‌بندی کلاینت، Load\-Balancing Configuration را ببینید.
.UNINDENT
.UNINDENT
.sp
در پیکربندی‌های شرح‌داده‌شده در بالا، هم سرور primary و هم سرور secondary/standby
به عنوان سرورهای \fBactive\fP نامیده می‌شوند، چرا که آن‌ها به‌روزرسانی‌های اجاره را دریافت می‌کنند و
می‌توانند با پاسخ دادن به پرس‌وجوهای DHCP که معمولاً توسط همتا رسیدگی می‌شد،
به‌طور خودکار به خرابی‌های همتا واکنش نشان دهند. کتابخانهٔ قلاب HA
از یک نوع/نقش سرور دیگر نیز پشتیبانی می‌کند: \fBbackup\fP\&. استفاده از سرور backup
اختیاری است، و علاوه‌بر سرورهای فعال، می‌تواند در هر دو ساختار \fBload\-balancing\fP و
\fBhot\-standby\fP پیاده‌سازی شود. هیچ محدودیتی در تعداد سرورهای
backup در راه‌اندازی HA وجود ندارد؛ با این وجود، حضور سرورهای backup ممکن است
تأخیر پاسخ‌های DHCP را افزایش دهد، چرا که سرورهای فعال نه‌تنها به‌روزرسانی‌های
اجاره را برای یکدیگر، بلکه برای سرورهای backup نیز ارسال می‌کنند. سرورهای فعال
پیش از پاسخ دادن به کلاینت‌های DHCP منتظر تأییدیه از جانب سرورهای backup نمی‌مانند،
بنابراین بار اضافی ناشی از ارسال به‌روزرسانی‌های اجاره به سرورهای backup به حداقل می‌رسد.
.sp
در آخرین پیکربندی پشتیبانی‌شده، یعنی \fBpassive\-backup\fP، تنها یک
سرور فعال و معمولاً یک یا چند سرور backup وجود دارد. یک پیکربندی
\fBpassive\-backup\fP بدون هیچ سرور backup نیز پذیرفته می‌شود، اما
تفاوتی با اجرای یک سرور تک بدون هیچ قابلیت HA ندارد.
.sp
پیکربندی \fBpassive\-backup\fP در شرایطی به کار می‌رود که مدیر سیستم
بخواهد بدون اجرای یک ساختار کامل failover، از سرور(های) backup به عنوان فضایی اضافی
برای ذخیره‌سازی اجاره‌ها بهره ببرد. در این حالت، در صورت خرابی
سرور primary، سرویس DHCP از دست می‌رود؛ و مستلزم آن است که مدیر سیستم
سرور primary را به صورت دستی مجدداً راه‌اندازی کند تا سرویس DHCP بازیابی شود. مدیر سیستم همچنین
می‌تواند یکی از سرورهای backup را برای ارائهٔ سرویس DHCP به کلاینت‌ها پیکربندی کند،
زیرا این سرورها باید اطلاعات دقیق یا تقریباً دقیقی از
اجاره‌های تخصیص‌یافته داشته باشند. مزیت اصلی حالت \fBpassive\-backup\fP این است که
مقداری افزونگی در اطلاعات اجاره فراهم می‌کند، اما با عملکرد بهتر
سرور primary در پاسخ‌گویی به پرس‌وجوهای DHCP همراه است.
سرور primary مجبور نیست پیش از ارسال پاسخ به کلاینت DHCP، منتظر دریافت تأییدیه‌های
به‌روزرسانی اجاره از سرورهای backup بماند.
این کار زمان پاسخ‌گویی را در مقایسه با حالت‌های \fBload\-balancing\fP و
\fBhot\-standby\fP کاهش می‌دهد؛ حالت‌هایی که در آن‌ها سرور پاسخ‌دهنده به پرس‌وجوی DHCP باید
پیش از پاسخ‌دهی به کلاینت، منتظر تأییدیه از سوی دیگر سرور فعال بماند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
یک مورد کاربرد جالب برای یک سرور فعال منفرد در
حالت \fBpassive\-backup\fP، سرویس اعلان است که در آن نرم‌افزاری
با معرفی خود به عنوان سرور backup، اعلان‌های هم‌زمان دربارهٔ اجاره‌های
تخصیص‌یافته و حذف‌شده را از سرور primary دریافت می‌کند و می‌تواند آن‌ها را در یک
صفحهٔ پایش نمایش دهد، هشدارها را به کار اندازد، و غیره.
.UNINDENT
.UNINDENT.SS "ساعت‌ها در سرورهای فعال (Clocks on Active Servers)"
.sp
همگام‌سازی ساعت‌ها برای کارکرد قابل‌اطمینان پیکربندی HA ضروری است.
سرورها اطلاعات اجاره را \- از طریق به‌روزرسانی‌های اجاره و در طول
همگام‌سازی پایگاه‌های داده \- از جمله زمان تخصیص اجاره و زمان انقضای آن،
به اشتراک می‌گذارند. معمولاً مقداری انحراف ساعت (clock skew) بین سرورهای
حاضر در راه‌اندازی HA وجود دارد؛ این موضوع تا زمانی که انحراف ساعت در مقایسه
با طول عمر اجاره‌ها نسبتاً کم باشد، قابل قبول است. با این حال، اگر انحراف ساعت
بیش از حد زیاد شود، زمان‌های انقضای متفاوت اجاره در سرورهای گوناگون ممکن است
باعث اختلال در عملکرد سامانهٔ HA شود. برای نمونه، یک سرور ممکن است اجاره‌ای را
منقضی‌شده تلقی کند در حالی که در واقعیت هنوز معتبر است. فرایند بازپس‌گیری اجاره
ممکن است نام مرتبط با این اجاره را از DNS حذف کند و بعداً هنگامی که کلاینت سعی
در تمدید اجاره دارد، مشکلاتی به وجود آورد.
.sp
هر سرور فعال با مقایسهٔ زمان فعلی خود با زمان بازگردانده‌شده توسط شریک خود در
پاسخ به دستور \fBha\-heartbeat\fP، انحراف ساعت را پایش می‌کند. این کار تقریب
مناسبی از انحراف ساعت ارائه می‌دهد، اگرچه بازهٔ زمانی بین ارسال پاسخ توسط شریک
و دریافت آن توسط سروری که دستور \fBha\-heartbeat\fP را فرستاده است در نظر نمی‌گیرد.
اگر انحراف ساعت از ۳۰ ثانیه بیشتر شود، یک پیام لاگ هشدار صادر می‌شود. مدیر سیستم
می‌تواند با همگام‌سازی ساعت‌ها (برای مثال با استفاده از NTP) این مشکل را برطرف کند؛
سرورها باید اصلاح انحراف ساعت را تشخیص داده و صدور هشدار را متوقف کنند.
.sp
اگر انحراف ساعت اصلاح نشود و از ۶۰ ثانیه فراتر رود، سرویس HA در هر یک از
سرورها خاتمه می‌یابد، به این معنی که ماشین حالت وارد وضعیت \fBterminated\fP
می‌شود. سرورها به پاسخ‌گویی به کلاینت‌های DHCP (مانند حالت \fBload\-balancing\fP
یا \fBhot\-standby\fP) ادامه خواهند داد، اما نه به‌روزرسانی‌های اجاره و نه ضربان‌های
قلب (heartbeats) را رد و بدل نخواهند کرد و پایگاه‌های دادهٔ اجارهٔ آن‌ها از یکدیگر
واگرا می‌شوند. در این حالت، مدیر سیستم باید ساعت‌ها را همگام کرده و سرورها را
مجدداً راه‌اندازی کند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
راه‌اندازی مجدد سرورها به صورت تک‌تک و بدون ترتیب خاصی امکان‌پذیر است.
پیش از راه‌اندازی مجدد سرورها، ساعت‌ها حتماً باید همگام باشند. سرور ری‌استارت‌شده
تا زمانی که شریک آن نیز ری‌استارت شود در وضعیت \fBwaiting\fP باقی می‌ماند. اگر
شریک ظرف مدت ۱۰ دقیقه راه‌اندازی مجدد نشود، سرورِ ری‌استارت‌شده برای ادامهٔ
پاسخ‌گویی به کلاینت‌های DHCP دوباره به وضعیت \fBterminated\fP بازمی‌گردد. برای
از سر گرفتن سرویس عادی HA، هر دو سرور را مجدداً راه‌اندازی کنید.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
انحراف ساعت تنها بین دو سرور فعال سنجیده می‌شود، و تنها سرورهای فعال در صورت
بالا بودن بیش از حد انحراف وارد وضعیت \fBterminated\fP می‌شوند. انحراف ساعت
بین سرورهای فعال و پشتیبان (backup) ارزیابی نمی‌شود، زیرا سرورهای فعال پیام‌های
ضربان قلب را با سرورهای پشتیبان تبادل نمی‌کنند.
.UNINDENT
.UNINDENT
.SS "پشتیبانی از HTTPS (HTTPS Support)"
.sp
از نسخهٔ Kea 1.9.7، کتابخانهٔ هوک دسترس‌پذیری بالا (High Availability) از
HTTPS بر بستر TLS پشتیبانی می‌کند، همان‌گونه که در پشتیبانی از TLS/HTTPS \%<#\:tls>\&
شرح داده شده است.
.sp
پارامترهای پیکربندی HTTPS عبارتند از:
.INDENT 0.0
.IP \(bu 2
\fBtrust\-anchor\fP \- نام فایل یا دایرکتوری‌ای را مشخص می‌کند که گواهی مرجع
صدور گواهی (CA) مربوط به یک موجودیت Kea در آن یافت می‌شود.
.IP \(bu 2
\fBcert\-file\fP \- نام فایل حاوی گواهی نهاد پایانی (end\-entity) مورد استفاده
را مشخص می‌کند.
.IP \(bu 2
\fBkey\-file\fP \- کلید خصوصی گواهی نهاد پایانی مورد استفاده را مشخص می‌کند.
.UNINDENT
.sp
این پارامترها را می‌توان در هر دو سطح سراسری (global) و نظیر (peer) پیکربندی
کرد. در صورت پیکربندی در هر دو سطح، مقدار peer استفاده می‌شود که امکان اشتراک‌گذاری
مقادیر عمومی را فراهم می‌سازد.
.sp
هر سه پارامتر یا باید همگی تعیین نشده باشند (HTTPS غیرفعال) یا همگی مشخص
شده باشند (HTTPS فعال). تعیین رشتهٔ خالی به عنوان مشخص‌نشده در نظر گرفته می‌شود؛
این قابلیت می‌تواند به عنوان مثال برای غیرفعال کردن HTTPS برای یک peer خاص در
زمانی که در سطح سراسری فعال است، به کار رود.
.sp
از آنجا که کتابخانهٔ هوک High Availability یک کلاینت HTTPS است، هیچ پارامتر
\fBcert\-required\fP در پیکربندی این هوک وجود ندارد.
این پارامتر می‌تواند در سمت سرور تنظیم شود تا گواهی کلاینت در ارتباط کلاینت\-سرور
الزامی شده و اعتبارسنجی شود. این پارامتر ارتباط بین نظیرهای HA را در سمت کلاینت
تحت تأثیر قرار نمی‌دهد؛ برای اطلاعات دربارهٔ سمت سرور، به بخش زیر مراجعه کنید.
.sp
از نسخهٔ Kea 2.1.7 به بعد، سمت سرور HTTPS نیز پشتیبانی می‌شود:
.INDENT 0.0
.IP \(bu 2
مدخل peer مربوط به نام سرور برای تنظیمات TLS استفاده می‌شود.
.IP \(bu 2
پارامتر جدید \fBrequire\-client\-certs\fP مشخص می‌کند که آیا گواهی‌های کلاینت
الزامی و اعتبارسنجی می‌شوند یا خیر، یعنی رفتاری مشابه \fBcert\-required\fP\& دارد.
مقدار پیش‌فرض آن \fBtrue\fP است و یک پارامتر پیکربندی در سطح HA (در مقایسه با
پیکربندی peer) به شمار می‌رود.
.UNINDENT
.sp
نسخهٔ Kea 2.1.7 یک ویژگی امنیتی جدید با پارامتر پیکربندی HA به نام
\fBrestrict\-commands\fP اضافه کرد: در صورت تنظیم روی \fBtrue\fP، دستوراتی که
توسط این هوک استفاده نمی‌شوند رد خواهند شد. مقدار پیش‌فرض از نسخهٔ Kea 3.0.0
برابر با \fBtrue\fP است.
.sp
در ادامه نمونه‌ای از یک جفت سرور HA برای حالت \fBhot\-standby\fP به همراه TLS آورده شده است.
.sp
سرور ۱:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp4\(dq: {
    \(dqhooks\-libraries\(dq: [{
        \(dqlibrary\(dq: \(dqlibdhcp_lease_cmds.so\(dq,
        \(dqparameters\(dq: { }
    }, {
        \(dqlibrary\(dq: \(dqlibdhcp_ha.so\(dq,
        \(dqparameters\(dq: {
            \(dqhigh\-availability\(dq: [{
                \(dqthis\-server\-name\(dq: \(dqserver1\(dq,
                \(dqtrust\-anchor\(dq: \(dq/usr/lib/kea/CA.pem\(dq,
                \(dqcert\-file\(dq: \(dq/usr/lib/kea/server1_cert.pem\(dq,
                \(dqkey\-file\(dq: \(dq/usr/lib/kea/server1_key.pem\(dq,
                \(dqmode\(dq: \(dqhot\-standby\(dq,
                \(dqheartbeat\-delay\(dq: 10000,
                \(dqmax\-response\-delay\(dq: 60000,
                \(dqmax\-ack\-delay\(dq: 5000,
                \(dqmax\-unacked\-clients\(dq: 5,
                \(dqpeers\(dq: [{
                    \(dqname\(dq: \(dqserver1\(dq,
                    \(dqurl\(dq: \(dqhttp://192.168.56.33:8005/\(dq,
                    \(dqrole\(dq: \(dqprimary\(dq,
                    \(dqauto\-failover\(dq: true
                }, {
                    \(dqname\(dq: \(dqserver2\(dq,
                    \(dqurl\(dq: \(dqhttp://192.168.56.66:8005/\(dq,
                    \(dqrole\(dq: \(dqstandby\(dq,
                    \(dqauto\-failover\(dq: true
                }]
            }]
        }
    }],

    \(dqsubnet4\(dq: [{
        \(dqid\(dq: 1,
        \(dqsubnet\(dq: \(dq192.0.3.0/24\(dq,
        \(dqpools\(dq: [{
            \(dqpool\(dq: \(dq192.0.3.100 \- 192.0.3.250\(dq
            }]
    }],

    \(dqcontrol\-sockets\(dq: [{
        \(dqsocket\-type\(dq: \(dqhttps\(dq,
        \(dqsocket\-address\(dq: \(dq192.168.56.33\(dq,
        \(dqsocket\-port\(dq: 8000,
        \(dqtrust\-anchor\(dq: \(dq/var/lib/kea/CA.pem\(dq,
        \(dqcert\-file\(dq: \(dq/var/lib/kea/server1_cert.pem\(dq,
        \(dqkey\-file\(dq: \(dq/var/lib/kea/server1_key.pem\(dq,
        \(dqcert\-required\(dq: true
     }]
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
سرور ۲:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp4\(dq: {
    \(dqhooks\-libraries\(dq: [{
        \(dqlibrary\(dq: \(dqlibdhcp_lease_cmds.so\(dq,
        \(dqparameters\(dq: { }
    }, {
        \(dqlibrary\(dq: \(dqlibdhcp_ha.so\(dq,
        \(dqparameters\(dq: {
            \(dqhigh\-availability\(dq: [{
                \(dqthis\-server\-name\(dq: \(dqserver2\(dq,
                \(dqtrust\-anchor\(dq: \(dq/usr/lib/kea/CA.pem\(dq,
                \(dqcert\-file\(dq: \(dq/usr/lib/kea/server2_cert.pem\(dq,
                \(dqkey\-file\(dq: \(dq/usr/lib/kea/server2_key.pem\(dq,
                \(dqmode\(dq: \(dqhot\-standby\(dq,
                \(dqheartbeat\-delay\(dq: 10000,
                \(dqmax\-response\-delay\(dq: 60000,
                \(dqmax\-ack\-delay\(dq: 5000,
                \(dqmax\-unacked\-clients\(dq: 5,
                \(dqpeers\(dq: [{
                    \(dqname\(dq: \(dqserver1\(dq,
                    \(dqurl\(dq: \(dqhttp://192.168.56.33:8005/\(dq,
                    \(dqrole\(dq: \(dqprimary\(dq,
                    \(dqauto\-failover\(dq: true
                }, {
                    \(dqname\(dq: \(dqserver2\(dq,
                    \(dqurl\(dq: \(dqhttp://192.168.56.66:8005/\(dq,
                    \(dqrole\(dq: \(dqstandby\(dq,
                    \(dqauto\-failover\(dq: true
                }]
            }]
        }
    }],

    \(dqsubnet4\(dq: [{
        \(dqid\(dq: 1,
        \(dqsubnet\(dq: \(dq192.0.3.0/24\(dq,
        \(dqpools\(dq: [{
            \(dqpool\(dq: \(dq192.0.3.100 \- 192.0.3.250\(dq
            }]
    }],

    \(dqcontrol\-sockets\(dq:[{
        \(dqsocket\-type\(dq: \(dqhttps\(dq,
        \(dqsocket\-address\(dq: \(dq192.168.56.66\(dq,
        \(dqsocket\-port\(dq: 8000,
        \(dqtrust\-anchor\(dq: \(dq/var/lib/kea/CA.pem\(dq,
        \(dqcert\-file\(dq: \(dq/var/lib/kea/server2_cert.pem\(dq,
        \(dqkey\-file\(dq: \(dq/var/lib/kea/server2_key.pem\(dq,
        \(dqcert\-required\(dq: true
    }]

  }
}
.EE
.UNINDENT
.UNINDENT.SS "وضعیت‌های سرور (Server States)"
.sp
یک سرور DHCP که در یک ساختار HA (دسترس‌پذیری بالا) کار می‌کند، یک ماشین وضعیت (state machine) را اجرا می‌نماید و وضعیت سرور می‌تواند توسط همتایانش با استفاده از دستور \fBha\-heartbeat\fP که از طریق RESTful API ارسال می‌شود، دریافت گردد. اگر سرور شریک (partner) در مدت‌زمان مشخص‌شده به دستور \fBha\-heartbeat\fP پاسخ ندهد، ارتباط قطع‌شده تلقی می‌شود و سرور ممکن است، بسته به پیکربندی، از تدابیر اضافی (که در ادامه این سند شرح داده شده است) برای بررسی اینکه آیا شریک همچنان فعال است یا خیر، استفاده کند. اگر مشخص شود که شریک کار نمی‌کند، سرور به وضعیت \fBpartner\-down\fP تغییر وضعیت می‌دهد تا تمام ترافیک DHCP هدایت‌شده به سیستم را مدیریت کند.
.sp
در این حالت، سرور بازمانده به ارسال دستور \fBha\-heartbeat\fP ادامه می‌دهد تا زمان فعال شدن مجدد شریک را تشخیص دهد. در آن هنگام، سرور شریک پایگاه‌داده اجاره‌ها (leases) را همگام‌سازی می‌کند. هنگامی که مجدداً آماده کار شد، سرور بازمانده به عملکرد عادی بازمی‌گردد؛ یعنی به وضعیت \fBload\-balancing\fP یا \fBhot\-standby\fP.
.sp
فهرست زیر شامل تمام وضعیت‌های ممکن سرور است:
.INDENT 0.0
.IP \(bu 2
\fBbackup\fP \- عملکرد عادی سرور پشتیبان. در این وضعیت، به‌روزرسانی‌های اجاره را از سرور(های) فعال دریافت می‌کند.
.IP \(bu 2
\fBcommunication\-recovery\fP \- یک سرور فعال که در حالت \fBload\-balancing\fP اجرا می‌شود، هنگامی که در کانال کنترلی با سرور شریک دچار مشکلات ارتباطی شود، ممکن است به این وضعیت منتقل گردد. این یک وضعیت میانی بین وضعیت‌های \fBload\-balancing\fP و \fBpartner\-down\fP است. در این وضعیت، سرور همچنان به پرس‌وجوهای DHCP پاسخ می‌دهد اما به‌روزرسانی‌های اجاره را برای شریک ارسال نمی‌کند؛ به‌روزرسانی‌های اجاره در صف قرار می‌گیرند و پس از برقراری مجدد ارتباط عادی ارسال می‌شوند. اگر ارتباط در مدت‌زمان مشخص‌شده از سر گرفته نشود، سرور اصلی (primary) به وضعیت \fBpartner\-down\fP تغییر وضعیت می‌دهد. وضعیت \fBcommunication\-recovery\fP برای اطمینان از سرویس‌دهی مطمئن DHCP در شرایطی معرفی شد که هر دو سرور فعال همچنان مشغول به کار هستند اما ارتباط بین آنها برای مدتی طولانی قطع شده است. می‌توان هر یک از سرورها را طوری پیکربندی کرد که هرگز وارد این وضعیت نشوند، با تنظیم \fBdelayed\-updates\-limit\fP روی 0 (برای جزئیات بیشتر درباره این پارامتر، به بخش Load\-Balancing Configuration در ادامه این فصل مراجعه کنید). غیرفعال کردن ورود به وضعیت \fBcommunication\-recovery\fP باعث می‌شود سرور به‌محض عدم توانایی در برقراری ارتباط با شریک خود، بررسی وضعیت \fBpartner\-down\fP را آغاز کند.
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
در Kea 1.9.4، با معرفی \fBdelayed\-updates\-limit\fP، رفتار پیش‌فرض سرور در حالت \fBload\-balancing\fP تغییر کرد. اکنون هنگامی که یک سرور با شریک خود دچار مشکلات ارتباطی می‌شود، وارد وضعیت \fBcommunication\-recovery\fP شده و تا زمان برقراری مجدد ارتباط، به‌روزرسانی‌های اجاره را صف‌بندی می‌کند. پیش از Kea 1.9.4، سروری که در حالت \fBload\-balancing\fP قادر به برقراری ارتباط با شریک خود نبود، بلافاصله انتقال به وضعیت \fBpartner\-down\fP را آغاز می‌کرد.
.UNINDENT
.UNINDENT
.INDENT 0.0
.IP \(bu 2
\fBhot\-standby\fP \- عملکرد عادی سرور فعال در حال اجرا در حالت \fBhot\-standby\fP؛ هم سرور اصلی و هم سرور standby در حین عملکرد عادی خود در این وضعیت قرار دارند. سرور اصلی به پرس‌وجوهای DHCP پاسخ می‌دهد و به‌روزرسانی‌های اجاره را به سرور standby و هر سرور backup موجود ارسال می‌کند.
.IP \(bu 2
\fBload\-balancing\fP \- عملکرد عادی سرور فعال در حال اجرا در حالت \fBload\-balancing\fP؛ هم سرور اصلی و هم سرور ثانویه (secondary) در حین عملکرد عادی خود در این وضعیت قرار دارند. هر دو سرور به پرس‌وجوهای DHCP پاسخ می‌دهند و به‌روزرسانی‌های اجاره را برای یکدیگر و هر سرور backup موجود ارسال می‌کنند.
.IP \(bu 2
\fBin\-maintenance\fP \- یک سرور فعال در نتیجه دریافت اعلان از طرف شریک خود مبنی بر درخواست تعمیر و نگهداری ساختار HA توسط مدیر سیستم، به این وضعیت منتقل می‌شود. مدیر سیستم با ارسال دستور \fBha\-maintenance\-start\fP به سروری که قرار است مسئولیت پاسخ‌گویی به کلاینت‌های DHCP را در حین آفلاین شدن سرور دیگر برای تعمیرات بر عهده بگیرد، درخواست تعمیر و نگهداری را ثبت می‌کند. اگر سرور در وضعیت \fBin\-maintenance\fP باشد، می‌توان آن را با خیال راحت خاموش کرد. سرور شریک بلافاصله پس از پی بردن به خاموش شدن سرورِ در حال تعمیر، به وضعیت \fBpartner\-down\fP تغییر وضعیت می‌دهد.
.IP \(bu 2
\fBpartner\-down\fP \- یک سرور فعال پس از تشخیص آفلاین بودن شریک خود (سرور فعال دیگر)، به این وضعیت منتقل می‌شود. اگر صرفاً یک سرور backup در دسترس نباشد، سرور به این وضعیت تغییر حالت نمی‌دهد. در وضعیت \fBpartner\-down\fP، سرور فعال به تمام پرس‌وجوهای DHCP پاسخ می‌دهد؛ از جمله پرس‌وجوهایی که در حالت عادی توسط سروری که اکنون در دسترس نیست مدیریت می‌شدند.
.IP \(bu 2
\fBpartner\-in\-maintenance\fP \- یک سرور فعال پس از دریافت دستور \fBha\-maintenance\-start\fP از مدیر سیستم به این وضعیت منتقل می‌شود. سرور در این وضعیت مسئول پاسخ‌گویی به تمام درخواست‌های DHCP می‌شود. سرور دستور \fBha\-maintenance\-notify\fP را به شریک ارسال می‌کند که آن شریک باید وارد وضعیت \fBin\-maintenance\fP شود. سروری که در وضعیت \fBpartner\-in\-maintenance\fP باقی می‌ماند، به ارسال به‌روزرسانی‌های اجاره به شریک ادامه می‌دهد تا زمانی که متوجه شود شریک پاسخ دادن به این به‌روزرسانی‌ها، ضربان‌های قلب (heartbeats) یا هر دستور دیگری را متوقف کرده است. در این صورت، سرورِ در وضعیت \fBpartner\-in\-maintenance\fP به وضعیت \fBpartner\-down\fP تغییر حالت داده و به پاسخ‌گویی به پرس‌وجوها ادامه می‌دهد، اما دیگر به‌روزرسانی‌های اجاره را ارسال نمی‌کند.
.IP \(bu 2
\fBpassive\-backup\fP \- یک سرور اصلی که در حالت HA به صورت \fBpassive\-backup\fP اجرا می‌شود، بلافاصله پس از راه‌اندازی (boot) به این وضعیت منتقل می‌شود. سرور اصلی در این وضعیت به تمام ترافیک DHCP پاسخ می‌دهد و به‌روزرسانی‌های اجاره را به سرورهای پشتیبان متصل به خود ارسال می‌کند. به‌طور پیش‌فرض، سرور اصلی منتظر تاییدیه از سرورهای پشتیبان نمی‌ماند و بلافاصله پس از ارسال به‌روزرسانی‌های اجاره به تمامی سرورهای پشتیبان، به پرس‌وجوی DHCP پاسخ می‌دهد. اگر هر یک از به‌روزرسانی‌های اجاره با شکست مواجه شود، سرور پشتیبان آن به‌روزرسانی را از دست می‌دهد اما کلاینت DHCP همچنان پیکربندی می‌شود. این پیکربندی پیش‌فرض را می‌توان با تنظیم پارامتر پیکربندی \fBwait\-backup\-ack\fP روی \fBtrue\fP تغییر داد؛ در این حالت، سرور اصلی همواره منتظر تاییدیه‌ها می‌ماند و اگر ارسال هر یک از به‌روزرسانی‌های مربوطه با شکست مواجه شود، پرس‌وجوی DHCP را نادیده می‌گیرد. این کار یکپارچگی پایگاه‌داده اجاره‌ها بین سرور اصلی و ثانویه را بهبود می‌بخشد. با این حال، در صورت بروز اختلال در ارتباط بین سرور فعال و هر یک از سرورهای پشتیبان، از دیدگاه کلاینت‌های DHCP در عمل منجر به از کار افتادن سرویس DHCP می‌شود.
.IP \(bu 2
\fBready\fP \- یک سرور فعال پس از همگام‌سازی پایگاه‌داده اجاره‌های خود با یک شریک فعال، به این وضعیت منتقل می‌شود. این وضعیت به شریک (که ممکن است در وضعیت \fBpartner\-down\fP باشد) نشان می‌دهد که باید به عملکرد عادی بازگردد. اگر و هنگامی که این کار را انجام دهد، سرور در وضعیت \fBready\fP نیز عملکرد عادی خود را آغاز می‌کند.
.IP \(bu 2
\fBsyncing\fP \- یک سرور فعال برای واکشی اجاره‌ها از شریک فعال و به‌روزرسانی پایگاه‌داده محلی اجاره‌ها، به این وضعیت منتقل می‌شود. هنگام قرار داشتن در این وضعیت، سرور دستور \fBdhcp\-disable\fP \%<#\:std-isccmd-dhcp-disable> را صادر می‌کند تا سرویس DHCP شریکی را که اجاره‌ها از آن واکشی می‌شوند، غیرفعال کند. سرویس DHCP حداکثر به مدت ۶۰ ثانیه غیرفعال می‌شود و در صورتی که شریک همگام‌کننده نتواند سرویس را مجدداً فعال کند، پس از این مدت به‌طور خودکار دوباره فعال می‌شود. اگر همگام‌سازی با موفقیت انجام شود، سرور همگام‌کننده دستور \fBha\-sync\-complete\-notify\fP را جهت اطلاع به شریک صادر می‌کند. در اکثر وضعیت‌ها، سرور شریک سرویس DHCP خود را مجدداً فعال می‌کند تا به پاسخ‌گویی به پرس‌وجوهای DHCP ادامه دهد. در وضعیت \fBpartner\-down\fP، شریک ابتدا پیش از فعال کردن سرویس DHCP اطمینان حاصل می‌کند که ارتباط بین سرورها دوباره برقرار شده است. عملیات همگام‌سازی به صورت همگام (synchronous) انجام می‌شود؛ سرور منتظر پاسخی از سوی شریک می‌ماند و در حین انجام همگام‌سازی اجاره‌ها کار دیگری انجام نمی‌دهد. سروری که پیکربندی شده تا پایگاه‌داده اجاره‌ها را با شریک خود همگام نکند، یعنی زمانی که پارامتر پیکربندی \fBsync\-leases\fP روی \fBfalse\fP تنظیم شده باشد، هرگز به این وضعیت منتقل نمی‌شود. در عوض، مستقیماً از وضعیت \fBwaiting\fP به وضعیت \fBready\fP منتقل می‌گردد.
.IP \(bu 2
\fBterminated\fP \- یک سرور فعال زمانی به این وضعیت منتقل می‌شود که کتابخانه قلاب (hook library) دسترس‌پذیری بالا دیگر قادر به ارائه سرویس مطمئن نباشد و برای حل مشکل نیاز به مداخله دستی مدیر سیستم باشد. مشکلات مختلف در پیکربندی HA ممکن است باعث انتقال سرور به این وضعیت شود. در زمان قرار داشتن در این وضعیت، سرور بر اساس حالت HA انتخاب‌شده (\fBload\-balancing\fP یا \fBhot\-standby\fP) به پاسخ‌گویی به کلاینت‌های DHCP ادامه می‌دهد، اما به‌روزرسانی‌های اجاره ردوبدل نشده و ضربان‌های قلب ارسال نمی‌شوند. هنگامی که سرور وارد وضعیت \fBterminated\fP شد، تا زمانی که مجدداً راه‌اندازی نشود در این وضعیت باقی می‌ماند. مدیر سیستم باید پیش از راه‌اندازی مجدد سرور، مشکلی که این وضعیت را ایجاد کرده است برطرف کند (مانند همگام‌سازی ساعت‌ها)؛ در غیر این صورت، سرور به محض اینکه دریابد مشکل همچنان پابرجاست، مجدداً به وضعیت \fBterminated\fP بازخواهد گشت.
.IP \(bu 2
\fBwaiting\fP \- هر نمونه سرورِ راه‌اندازی‌شده وارد این وضعیت می‌شود. یک سرور پشتیبان (backup) مستقیماً از این وضعیت به وضعیت \fBbackup\fP می‌رود. یک سرور فعال برای بررسی وضعیت شریک خود، یک ضربان قلب به آن ارسال می‌کند؛ اگر به نظر برسد که شریک در دسترس نیست، سرور به وضعیت \fBpartner\-down\fP منتقل می‌شود. اگر شریک در دسترس باشد، بسته به تنظیم پارامتر پیکربندی \fBsync\-leases\fP، سرور به وضعیت \fBsyncing\fP یا \fBready\fP منتقل می‌گردد. اگر به نظر برسد هر دو سرور در وضعیت \fBwaiting\fP قرار دارند (راه‌اندازی هم‌زمان)، ابتدا سرور اصلی به وضعیت بعدی منتقل می‌شود. سرور ثانویه یا standby تا زمانی که سرور اصلی به وضعیت \fBready\fP منتقل نشود، در وضعیت \fBwaiting\fP باقی می‌ماند.
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
در حال حاضر، راه‌اندازی مجدد سرویس HA از وضعیت \fBterminated\fP نیازمند راه‌اندازی مجدد سرور DHCP یا بارگذاری مجدد پیکربندی آن است.
.UNINDENT
.UNINDENT
.sp
اینکه آیا سرور به پرس‌وجوهای DHCP پاسخ می‌دهد و به کدام پرس‌وجوها پاسخ می‌دهد، در صورتی که هیچ اقدام مدیریتی برای پیکربندی دیگر سرور انجام نگرفته باشد، به وضعیت سرور بستگی دارد. جدول زیر رفتار پیش‌فرض را برای وضعیت‌های مختلف ارائه می‌دهد.
.sp
عبارت \fBDHCP Service Scopes\fP مشخص می‌کند که سرور در یک وضعیت معین به کدام گروه از پرس‌وجوهای DHCP دریافت‌شده پاسخ می‌دهد. پیکربندی HA باید نامی یکتا را برای هر سرور درون ساختار HA تعیین کند. این سند در مثال‌های ارائه‌شده از این قرارداد استفاده می‌کند: \(dqserver1\(dq برای سرور اصلی، \(dqserver2\(dq برای سرور ثانویه یا standby، و \(dqserver3\(dq برای سرور backup. در عمل تا زمانی که نام‌ها یکتا باقی بمانند، می‌توان از هر نامی استفاده کرد.
.sp
توضیحات دقیق این حوزه‌ها (scopes) در ادامه آمده است..SS رفتار پیش‌فرض سرور در وضعیت‌های گوناگون HA
.TS
box center;
l|l|l|l.
T{
وضعیت
T}	T{
نوع سرور
T}	T{
سرویس DHCP
T}	T{
محدوده‌های سرویس
DHCP
T}
_
T{
backup
T}	T{
سرور backup
T}	T{
غیرفعال
T}	T{
هیچ‌کدام
T}
_
T{
communication\-recovery
T}	T{
primary یا
secondary
(تنها در حالت
load\-balancing)
T}	T{
فعال
T}	T{
\(dqHA_server1\(dq
یا
\(dqHA_server2\(dq
T}
_
T{
hot\-standby
T}	T{
primary یا
standby
(حالت
hot\-standby)
T}	T{
فعال
T}	T{
\(dqHA_server1\(dq
در صورت primary بودن،
در غیر این صورت هیچ‌کدام
T}
_
T{
load\-balancing
T}	T{
primary یا
secondary
(حالت
load\-balancing)
T}	T{
فعال
T}	T{
\(dqHA_server1\(dq
یا
\(dqHA_server2\(dq
T}
_
T{
in\-maintenance
T}	T{
سرور فعال
T}	T{
غیرفعال
T}	T{
هیچ‌کدام
T}
_
T{
partner\-down
T}	T{
سرور فعال
T}	T{
فعال
T}	T{
تمام محدوده‌ها
T}
_
T{
partner\-in\-maintenance
T}	T{
سرور فعال
T}	T{
فعال
T}	T{
تمام محدوده‌ها
T}
_
T{
passive\-backup
T}	T{
سرور فعال
T}	T{
فعال
T}	T{
تمام محدوده‌ها
T}
_
T{
ready
T}	T{
سرور فعال
T}	T{
غیرفعال
T}	T{
هیچ‌کدام
T}
_
T{
syncing
T}	T{
سرور فعال
T}	T{
غیرفعال
T}	T{
هیچ‌کدام
T}
_
T{
terminated
T}	T{
سرور فعال
T}	T{
فعال
T}	T{
مشابه با وضعیت
load\-balancing
یا hot\-standby
T}
_
T{
waiting
T}	T{
هر سروری
T}	T{
غیرفعال
T}	T{
هیچ‌کدام
T}
.TE
.sp
در حالت \fBload\-balancing\fP دو محدوده برای سرورهای فعال مشخص شده است: \(dqHA_server1\(dq و \(dqHA_server2\(dq. پرس‌وجوهای DHCP که به \fBserver1\fP موازنه‌بار می‌شوند متعلق به محدودهٔ \(dqHA_server1\(dq و پرس‌وجوهایی که به \fBserver2\fP موازنه‌بار می‌شوند متعلق به محدودهٔ \(dqHA_server2\(dq هستند. اگر هر یک از سرورها در وضعیت \fBpartner\-down\fP باشد، شریک فعال مسئول پاسخگویی به هر دو محدوده است.
.sp
در حالت \fBhot\-standby\fP، تنها یک محدوده وجود دارد \- \(dqHA_server1\(dq \- زیرا تنها \fBserver1\fP به پرس‌وجوهای DHCP پاسخ می‌دهد. اگر آن سرور از دسترس خارج شود، \fBserver2\fP مسئول این محدوده خواهد بود.
.sp
سرورهای backup محدودهٔ اختصاصی خود را ندارند. در برخی موارد می‌توان از آن‌ها برای پاسخگویی به پرس‌وجوهای متعلق به محدوده‌های سرورهای فعال استفاده کرد. همچنین، سرور backup که نه در وضعیت \fBpartner\-down\fP و نه در عملکرد عادی باشد، به هیچ محدوده‌ای سرویس نمی‌دهد.
.sp
نام‌های محدوده می‌توانند برای مرتبط‌سازی استخرها (pools)، زیرشبکه‌ها و شبکه‌ها با سرورهای مشخص استفاده شوند، به طوری که فقط این سرورها بتوانند نشانی‌ها یا پیشوندها را از آن استخرها، زیرشبکه‌ها یا شبکه‌ها تخصیص دهند. این کار از طریق سازوکار طبقه‌بندی کلاینت (client classification) انجام می‌شود (برای جزئیات بیشتر به Load Balancing With Advanced Classification مراجعه کنید)..SS انتقال قلمرو در وضعیت Partner\-Down
.sp
هنگامی که یکی از سرورها درمی‌یابد شریک آن در دسترس نیست، شروع به سرویس‌دهی به کلاینت‌ها هم از قلمرو (scope) خود و هم از قلمرو شریک خارج از دسترس می‌کند. این فرایند برای کلاینت‌های جدید، یعنی آن‌هایی که پیام‌های DHCPDISCOVER (در DHCPv4) یا Solicit (در DHCPv6) را ارسال می‌کنند، سرراست است، زیرا آن درخواست‌ها به سرور خاصی فرستاده نمی‌شوند. سرورِ در دسترس هنگامی که در وضعیت \fBpartner\-down\fP قرار دارد، به تمام این‌گونه پرس‌وجوها پاسخ می‌دهد.
.sp
هنگامی که یک کلاینت اجاره‌ای را تجدید می‌کند، پیام DHCPREQUEST (در DHCPv4) یا Renew (در DHCPv6) خود را مستقیماً به سروری می‌فرستد که اجاره در حال تجدید را تخصیص داده است. اگر این سرور دیگر در دسترس نباشد، کلاینت پاسخی دریافت نخواهد کرد. در این حالت، کلاینت به استفاده از اجاره خود ادامه داده و تا زمان سپری شدن زمان‌سنج اتصال مجدد (T2)، برای تجدید آن تلاش می‌کند. سپس کلاینت وارد مرحله اتصال مجدد (rebinding) می‌شود که در آن پیام DHCPREQUEST (در DHCPv4) یا Rebind (در DHCPv6) را به هر سرور در دسترسی ارسال می‌کند. سرور برجا مانده درخواست اتصال مجدد را دریافت کرده و معمولاً طول عمر اجاره را تمدید می‌کند. سپس کلاینت بر حسب نیاز، برای تجدید اجاره خود به تماس با آن سرور جدید ادامه می‌دهد.
.sp
اگر و هنگامی که سرور دیگر دوباره در دسترس قرار گیرد، هر دو سرور فعال در نهایت به وضعیت \fBload\-balancing\fP یا \fBhot\-standby\fP تغییر حالت می‌دهند، که در آن مجدداً مسئول قلمروهای خود خواهند بود. برخی کلاینت‌های متعلق به قلمرو سرور راه‌اندازی‌مجددشده تلاش خواهند کرد اجاره‌های خود را از طریق سرور برجا مانده تجدید کنند، اما این سرور دیگر به آن‌ها پاسخ نخواهد داد؛ کلاینت در نهایت از طریق سازوکار اتصال مجدد (rebinding) دوباره به سرور صحیح بازخواهد گشت.
.SS پیکربندی Load\-Balancing
.sp
در ادامه قطعه‌پیکربندی برای فعال‌سازی دسترسی‌پذیری بالا (HA) روی سرور primary در پیکربندی \fBload\-balancing\fP آمده است. همین پیکربندی باید روی سرورهای secondary و backup نیز اعمال شود، با این تفاوت که \fBthis\-server\-name\fP روی آن سرورها باید به ترتیب برابر \(dqserver2\(dq و \(dqserver3\(dq تنظیم شود.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
به یاد داشته باشید که حالت \fBload\-balancing\fP نیازمند آن است که استخرهای آدرس (address pools) و استخرهای پیشوند واگذارشده (delegated prefix pools) بین سرورهای فعال تقسیم شوند. در طول عملکرد عادی، سرورها از استخرهای غیرهم‌پوشان استفاده می‌کنند تا از تخصیص یک اجاره یکسان به کلاینت‌های مختلف توسط هر دو نمونه جلوگیری شود. سرور تنها زمانی از بخش‌های استخر متعلق به شریک استفاده می‌کند که شریک در حال اجرا نباشد. یادداشت‌های موجود در بخش Supported Configurations را که تفاوت‌های میان حالت‌های \fBload\-balancing\fP و \fBhot\-standby\fP را مشخص می‌کنند، ببینید. معناشناسی افرازبندی استخر (pool partitioning) در ادامه این بخش توضیح داده شده است. بخش Load Balancing With Advanced Classification مثال‌های پیشرفته‌ای از افرازبندی استخر ارائه می‌دهد.
.UNINDENT
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqhooks\-libraries\(dq: [{
        \(dqlibrary\(dq: \(dqlibdhcp_lease_cmds.so\(dq,
        \(dqparameters\(dq: { }
    }, {
        \(dqlibrary\(dq: \(dqlibdhcp_ha.so\(dq,
        \(dqparameters\(dq: {
            \(dqhigh\-availability\(dq: [{
                \(dqthis\-server\-name\(dq: \(dqserver1\(dq,
                \(dqmode\(dq: \(dqload\-balancing\(dq,
                \(dqheartbeat\-delay\(dq: 10000,
                \(dqmax\-response\-delay\(dq: 60000,
                \(dqmax\-ack\-delay\(dq: 5000,
                \(dqmax\-unacked\-clients\(dq: 5,
                \(dqmax\-rejected\-lease\-updates\(dq: 10,
                \(dqdelayed\-updates\-limit\(dq: 100,
                \(dqpeers\(dq: [{
                    \(dqname\(dq: \(dqserver1\(dq,
                    \(dqurl\(dq: \(dqhttp://192.168.56.33:8005/\(dq,
                    \(dqrole\(dq: \(dqprimary\(dq,
                    \(dqauto\-failover\(dq: true
                }, {
                    \(dqname\(dq: \(dqserver2\(dq,
                    \(dqurl\(dq: \(dqhttp://192.168.56.66:8005/\(dq,
                    \(dqrole\(dq: \(dqsecondary\(dq,
                    \(dqauto\-failover\(dq: true
                }, {
                    \(dqname\(dq: \(dqserver3\(dq,
                    \(dqurl\(dq: \(dqhttp://192.168.56.99:8005/\(dq,
                    \(dqrole\(dq: \(dqbackup\(dq,
                    \(dqbasic\-auth\-user\(dq: \(dqfoo\(dq,
                    \(dqbasic\-auth\-password\(dq: \(dq1234\(dq,
                    \(dqauto\-failover\(dq: false
                }]
            }]
        }
    }],

    \(dqsubnet4\(dq: [{
        \(dqid\(dq: 1,
        \(dqsubnet\(dq: \(dq192.0.3.0/24\(dq,
        \(dqpools\(dq: [{
            \(dqpool\(dq: \(dq192.0.3.100 \- 192.0.3.150\(dq,
            \(dqclient\-classes\(dq: [ \(dqHA_server1\(dq ]
         }, {
            \(dqpool\(dq: \(dq192.0.3.200 \- 192.0.3.250\(dq,
            \(dqclient\-classes\(dq: [ \(dqHA_server2\(dq ]
         }],

         \(dqoption\-data\(dq: [{
            \(dqname\(dq: \(dqrouters\(dq,
            \(dqdata\(dq: \(dq192.0.3.1\(dq
         }],

         \(dqrelay\(dq: { \(dqip\-address\(dq: \(dq10.1.2.3\(dq }
    }]
}
.EE
.UNINDENT
.UNINDENT
.sp
برای فعال‌سازی HA دو کتابخانه هوک (hook) باید بارگیری شوند: \fBlibdhcp_lease_cmds.so\fP و \fBlibdhcp_ha.so\fP\&. دومی ویژگی HA را پیاده‌سازی می‌کند، در حالی که اولی دستورهای کنترلی مورد نیاز HA را برای دریافت و دستکاری اجاره‌ها در سرورهای دوردست فعال می‌سازد. در مثال ارائه‌شده در بالا، فرض شده است که کتابخانه‌های Kea در دایرکتوری \fB/usr/lib\fP نصب شده‌اند. اگر Kea در دایرکتوری \fB/usr\fP نصب نشده باشد، مکان کتابخانه‌های هوک باید متناسب با آن به‌روزرسانی شود.
.sp
پیکربندی HA در محدوده \fBlibdhcp_ha.so\fP مشخص می‌شود. توجه داشته باشید در حالی که پارامتر سطح بالای \fBhigh\-availability\fP یک فهرست است، در حال حاضر فقط یک ورودی پشتیبانی می‌شود.
.sp
پارامترهای سراسری زیر رفتار سرور را در رابطه با HA کنترل می‌کنند:
.INDENT 0.0
.IP \(bu 2
\fBthis\-server\-name\fP \- شناسه یکتای سرور در این راه‌اندازی HA است. این شناسه باید با یکی از سرورهای مشخص‌شده در فهرست \fBpeers\fP مطابقت داشته باشد.
.IP \(bu 2
\fBmode\fP \- حالت عملکرد HA را مشخص می‌کند. حالت‌هایی که در حال حاضر پشتیبانی می‌شوند \fBload\-balancing\fP و \fBhot\-standby\fP هستند.
.IP \(bu 2
\fBheartbeat\-delay\fP \- مدت زمان بر حسب میلی‌ثانیه میان ارسال آخرین ضربان قلب (heartbeat) (یا دستور دیگری که برای شریک ارسال شده) و ضربان قلب بعدی را مشخص می‌کند. ضربان‌های قلب به صورت دوره‌ای برای دریافت وضعیت شریک و بررسی در حال کار بودن آن ارسال می‌شوند. مقدار پیش‌فرض این پارامتر 10000 میلی‌ثانیه است.
.IP \(bu 2
\fBmax\-response\-delay\fP \- مدت زمان بر حسب میلی‌ثانیه از زمان آخرین ارتباط موفق با شریک را مشخص می‌کند که پس از آن سرور فرض می‌کند ارتباط با شریک قطع شده است. این مدت زمان باید بزرگتر از \fBheartbeat\-delay\fP باشد؛ معمولاً باید مضربی از \fBheartbeat\-delay\fP باشد. هنگامی که سرور تشخیص دهد ارتباط قطع شده است، ممکن است به وضعیت \fBpartner\-down\fP تغییر حالت دهد (زمانی که \fBmax\-unacked\-clients\fP برابر 0 است) یا رویه تشخیص خرابی را با استفاده از مقادیر دو پارامتر زیر فعال کند. مقدار پیش‌فرض این پارامتر 60000 میلی‌ثانیه است.
.IP \(bu 2
\fBmax\-ack\-delay\fP \- یکی از پارامترهایی است که تشخیص خرابی شریک را کنترل می‌کند. هنگامی که ارتباط با شریک قطع می‌شود، سرور مقادیر فیلد \(dqsecs\(dq (در DHCPv4) یا گزینه \(dqelapsed time\(dq (در DHCPv6) را که نشان‌دهنده مدت زمانی است که کلاینت DHCP سعی در برقراری ارتباط با سرور DHCP داشته است، بررسی می‌کند. این پارامتر حداکثر زمان بر حسب میلی‌ثانیه برای تلاش کلاینت جهت ارتباط با سرور DHCP را مشخص می‌کند که پس از آن، این سرور فرض می‌کند ارتباط کلاینت با سرور DHCP ناموفق بوده است (تأییدنشده یا \(dqunacked\(dq است). مقدار پیش‌فرض این پارامتر 10000 است.
.IP \(bu 2
\fBmax\-unacked\-clients\fP \- مشخص می‌کند چه تعداد کلاینت \(dqunacked\(dq مجاز هستند (به \fBmax\-ack\-delay\fP مراجعه کنید) پیش از آنکه این سرور فرض کند شریک آفلاین است و به وضعیت \fBpartner\-down\fP تغییر حالت دهد. مقدار ویژه 0 برای این پارامتر مجاز است که سازوکار تشخیص خرابی را غیرفعال می‌کند. در این حالت، سروری که نتواند از طریق کانال کنترلی با شریک خود ارتباط برقرار کند، فرض می‌کند که سرور شریک از کار افتاده است و بلافاصله به وضعیت \fBpartner\-down\fP می‌رود. مقدار پیش‌فرض این پارامتر 10 است.
.IP \(bu 2
\fBmax\-rejected\-lease\-updates\fP \- مشخص می‌کند چه تعداد به‌روزرسانی اجاره برای کلاینت‌های متمایز، به دلیل تعارض میان اجاره و پیکربندی یا وضعیت شریک، می‌تواند با شکست مواجه شود پیش از آنکه سرور به وضعیت \fBterminated\fP تغییر حالت دهد. تعارض می‌تواند نشانه‌ای از پیکربندی نادرست باشد؛ معمولاً تعداد کمی از اجاره‌های دارای تعارض قابل قبول هستند زیرا فقط بر تعداد کمی از دستگاه‌ها تأثیر می‌گذارند. با این حال، اگر تعارض‌ها برای دستگاه‌های زیادی رخ دهد (برای مثال، کل یک زیرشبکه)، سرویس HA غیرقابل‌اعتماد شده و باید خاتمه یابد، و مشکل باید به صورت دستی توسط یک مدیر سیستم برطرف شود. انتخاب بالاترین مقدار قابل قبول برای \fBmax\-rejected\-lease\-updates\fP بر عهده مدیر سیستم است. مقدار پیش‌فرض 10 است. مقدار ویژه 0 سرور را به گونه‌ای پیکربندی می‌کند که هرگز سرویس HA را به دلیل تعارض‌های اجاره خاتمه ندهد. اگر مقدار 1 باشد، سرور با رخ دادن اولین تعارض به وضعیت \fBterminated\fP تغییر حالت می‌دهد. این پارامتر به به‌روزرسانی‌های دارای تعارض اجاره که به سرورهای پشتیبان (backup) ارسال می‌شوند ارتباطی ندارد.
.IP \(bu 2
\fBdelayed\-updates\-limit\fP \- حداکثر تعداد به‌روزرسانی‌های اجاره را مشخص می‌کند که می‌توانند در زمانی که سرور در وضعیت \fBcommunication\-recovery\fP قرار دارد در صف قرار گیرند. این پارامتر در Kea 1.9.4 معرفی شد. مقدار ویژه 0 سرور را به گونه‌ای پیکربندی می‌کند که هرگز به وضعیت \fBcommunication\-recovery\fP تغییر حالت ندهد و رفتار سرور مشابه نسخه‌های قبلی Kea خواهد بود، یعنی اگر سرور نتواند به شریک خود دسترسی پیدا کند، مستقیماً به وضعیت \fBpartner\-down\fP می‌رود. مقدار پیش‌فرض این پارامتر 100 است.
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
پارامتر \fBmax\-rejected\-lease\-updates\fP در Kea 2.3.1 معرفی شد. پیش از این، سرور بین شکست در به‌روزرسانی اجاره به دلیل کار نکردن شریک و شکست به دلیل تعارض (مانند مشکلات پیکربندی) تمایزی قائل نمی‌شد. در نتیجه، گاهی اوقات سرور حتی با وجود این که شریک به طور عادی کار می‌کرد اما فقط برخی اجاره‌ها مشکل داشتند، می‌توانست به وضعیت \fBpartner\-down\fP تغییر حالت دهد. تعارض‌ها دیگر نباید باعث چنین انتقالی شوند. با این حال، بسته به تنظیمات \fBmax\-rejected\-lease\-updates\fP، تعارض‌های بیش از حد می‌تواند به خاتمه سرویس High Availability منجر شود. در آن حالت، هر دو سرور به پاسخ دادن به پرس‌وجوهای DHCP ادامه می‌دهند اما دیگر به‌روزرسانی‌های اجاره را ارسال نمی‌کنند.
.UNINDENT
.UNINDENT
.sp
مقادیر \fBmax\-ack\-delay\fP و \fBmax\-unacked\-clients\fP باید با دقت و با در نظر گرفتن ویژگی‌های شبکه‌ای که سرورهای DHCP در آن فعالیت می‌کنند انتخاب شوند. سرور مورد نظر ممکن است بر اساس سیاست‌های مدیریتی به برخی از کلاینت‌های DHCP پاسخ ندهد، یا سرور ممکن است پرس‌وجوهای ناقص یا نامعتبر کلاینت‌ها را دور بیندازد (drop کند). بنابراین، انتخاب مقداری بسیار پایین برای پارامتر \fBmax\-unacked\-clients\fP ممکن است باعث انتقال به وضعیت \fBpartner\-down\fP شود حتی اگر شریک همچنان در حال کار باشد. از سوی دیگر، انتخاب مقداری بیش از حد بالا ممکن است باعث شود در صورتی که ترافیک DHCP در شبکه بسیار کم باشد (مانند هنگام شب)، هرگز انتقالی به وضعیت \fBpartner\-down\fP صورت نگیرد، زیرا تعداد کلاینت‌های متمایزی که سعی در ارتباط با سرور دارند می‌تواند کمتر از مقدار تنظیم‌شده برای \fBmax\-unacked\-clients\fP باشد.
.sp
در برخی موارد ممکن است غیرفعال کردن کامل سازوکار تشخیص خرابی سودمند باشد، به ویژه اگر سرورها بسیار نزدیک به یکدیگر مستقر باشند و تفکیک شبکه (network partitioning) نامحتمل باشد، به این معنی که عدم پاسخ به ضربان‌های قلب تنها زمانی امکان‌پذیر باشد که شریک آفلاین باشد. در چنین مواردی، \fBmax\-unacked\-clients\fP را روی 0 تنظیم کنید.
.sp
پارامتر \fBdelayed\-updates\-limit\fP برای فعال یا غیرفعال کردن رویه \fBcommunication\-recovery\fP استفاده می‌شود و رفتار سرور را در وضعیت \fBcommunication\-recovery\fP کنترل می‌کند. این پارامتر تنها می‌تواند در حالت \fBload\-balancing\fP استفاده شود.
.sp
اگر سروری در وضعیت \fBload\-balancing\fP دچار مشکلات ارتباطی با شریک خود شود (شکست در ضربان قلب یا به‌روزرسانی اجاره)، سرور به وضعیت \fBcommunication\-recovery\fP تغییر حالت می‌دهد. در این وضعیت، سرور به پاسخ دادن به پرس‌وجوهای DHCP ادامه می‌دهد اما به‌روزرسانی‌های اجاره را برای شریک ارسال نمی‌کند. به‌روزرسانی‌های اجاره تا زمان برقراری مجدد ارتباط در صف قرار می‌گیرند تا اطمینان حاصل شود که سرویس DHCP حتی در صورت قطع ارتباط میان شرکا، در دسترس باقی می‌ماند. ممکن است قطع ارتباط در دو حالت رخ دهد: زمانی که یکی از سرورها متوقف شده باشد، یا زمانی که هر دو سرور در دسترس باقی بمانند اما نتوانند با یکدیگر ارتباط برقرار کنند. در حالت اول، سرور برجا مانده رویه عادی را دنبال کرده و در نهایت باید به وضعیت \fBpartner\-down\fP منتقل شود. در حالت دوم، هر دو سرور باید به وضعیت \fBcommunication\-recovery\fP بروند و هرگز نباید به وضعیت \fBpartner\-down\fP تغییر حالت دهند (اگر \fBmax\-unacked\-clients\fP روی یک مقدار غیرصفر تنظیم شده باشد)، زیرا به تمام پرس‌وجوهای DHCP پاسخ داده می‌شود و هیچ‌یک از سرورها هیچ پرس‌وجوی DHCP تأییدنشده‌ای (unacked) را مشاهده نخواهد کرد.
.sp
انگیزه معرفی رویه \fBcommunication\-recovery\fP مشکلاتی بود که ممکن است هنگامی رخ دهد که دو سرور آنلاین بمانند اما ارتباط بین آن‌ها برای مدتی قطع شود. در نسخه‌های قبلی Kea، سرورهایی که با مشکلات ارتباطی مواجه می‌شدند پیش از تغییر حالت به وضعیت \fBpartner\-down\fP، بسته‌های DHCP را دور می‌انداختند (drop می‌کردند). در برخی موارد هر دوی آن‌ها به وضعیت \fBpartner\-down\fP منتقل می‌شدند که این امر به طور بالقوه می‌توانست منجر به تخصیص آدرس‌های IP یا پیشوندهای واگذارشده یکسان به کلاینت‌های مختلف توسط هر دو سرور شود. با ورود به وضعیت میانی \fBcommunication\-recovery\fP، از این مشکلات جلوگیری می‌شود.
.sp
اگر سروری در وضعیت \fBcommunication\-recovery\fP ارتباط با شریک خود را مجدداً برقرار کند، تلاش می‌کند تمام به‌روزرسانی‌های معوقه اجاره را که در صف قرار داده است برای شریک ارسال کند. این کار به صورت همگام (synchronous) انجام می‌شود و ممکن است زمان قابل توجهی طول بکشد تا سرور به وضعیت \fBload\-balancing\fP تغییر حالت دهد و عملکرد عادی خود را از سر بگیرد. حداکثر تعداد به‌روزرسانی‌های اجاره که می‌توانند در وضعیت \fBcommunication\-recovery\fP صف‌بندی شوند با \fBdelayed\-updates\-limit\fP کنترل می‌شود. اگر از این حد فراتر رود، سرور صف‌بندی به‌روزرسانی‌های اجاره را متوقف کرده و پس از برقراری مجدد اتصال با شریک، به جای ارسال به‌روزرسانی‌های معوقه اجاره پیش از تغییر وضعیت به \fBload\-balancing\fP، یک همگام‌سازی کامل پایگاه‌داده انجام می‌دهد. حتی در صورت فراتر رفتن از این حد، سرور در وضعیت \fBcommunication\-recovery\fP همچنان پاسخگوی کلاینت‌های DHCP باقی می‌ماند.
.sp
شاید ترجیح داده شود در مواردی که خطر قطع طولانی‌مدت ارتباط بین سرورها وجود دارد و پایگاه‌داده اجاره بزرگ است، مقادیر بالاتری برای \fBdelayed\-updates\-limit\fP تنظیم شود تا از همگام‌سازی پرهزینه پایگاه‌داده اجاره جلوگیری گردد. از سوی دیگر، اگر پایگاه‌داده اجاره کوچک باشد، زمان مورد نیاز برای ارسال به‌روزرسانی‌های معوقه اجاره ممکن است طولانی‌تر از همگام‌سازی پایگاه‌داده اجاره باشد. در چنین مواردی شاید بهتر باشد از مقدار کمتری، مثلاً 10 استفاده شود. مقدار پیش‌فرض 100 یک سازش معقول است و باید در اکثر استقرارها با ترافیک متوسط به خوبی کار کند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پارامتر جدید است و مقادیری از آن که در برخی محیط‌ها به خوبی کار می‌کنند ممکن است در محیط‌های دیگر کارایی خوبی نداشته باشند. بازخورد کاربران به ما در ایجاد مجموعه‌ای بهتر از توصیه‌های کاربردی کمک خواهد کرد.
.UNINDENT
.UNINDENT
.sp
پارامتر \fBpeers\fP شامل فهرستی از سرورهای درون این راه‌اندازی HA است. این پیکربندی باید حداقل شامل یک سرور primary (اولیه) و یک سرور secondary (ثانویه) باشد. همچنین می‌تواند شامل تعداد نامحدودی سرور backup (پشتیبان) باشد. در این مثال، یک سرور پشتیبان وجود دارد که به‌روزرسانی‌های اجاره را از سرورهای فعال دریافت می‌کند.
.sp
این‌ها پارامترهایی هستند که برای هر یک از همتایان در این فهرست مشخص می‌شوند:
.INDENT 0.0.IP \(bu 2
\fBname\fP \- نام یکتایی را برای کارساز مشخص می‌کند.
.IP \(bu 2
\fBurl\fP \- نشانی URL مورد استفاده برای برقراری ارتباط با این کارساز از طریق
کانال کنترلی را مشخص می‌کند. سایر کارسازها از این URL برای ارسال دستورهای کنترلی به این
کارساز استفاده می‌کنند.
.IP \(bu 2
\fBbasic\-auth\-user\fP \- شناسه کاربر (user ID) را برای احراز هویت پایه‌ای HTTP مشخص می‌کند. اگر
مشخص نشود یا به صورت یک رشته خالی تعیین شود، هیچ سرآیند احراز هویتی
به تراکنش‌های HTTP افزوده نمی‌شود. این مقدار نباید شامل نویسه دونقطه (:) باشد.
.IP \(bu 2
\fBbasic\-auth\-user\-file\fP \- جایگزینی برای \fBbasic\-auth\-user\fP است:
به جای درج شناسه کاربر در فایل پیکربندی، این شناسه در سطر نخست
فایل مشخص‌شده توسط این پارامتر تعیین می‌شود.
.IP \(bu 2
\fBbasic\-auth\-password\fP \- گذرواژه را برای احراز هویت پایه‌ای HTTP
مشخص می‌کند. هنگامی که شناسه کاربر مشخص نشده باشد یا خالی باشد، این پارامتر نادیده
گرفته می‌شود. گذرواژه اختیاری است؛ اگر مشخص نشود، یک گذرواژه خالی استفاده
می‌شود.
.IP \(bu 2
\fBbasic\-auth\-password\-file\fP \- جایگزینی برای \fBbasic\-auth\-password\fP است:
به جای درج گذرواژه در فایل پیکربندی، این گذرواژه در سطر نخست
فایل مشخص‌شده توسط این پارامتر تعیین می‌شود.
.IP \(bu 2
\fBrole\fP \- نقش کارساز را در ساختار HA مشخص می‌کند. نقش‌های زیر
در پیکربندی \fBload\-balancing\fP پشتیبانی می‌شوند: \fBprimary\fP،
\fBsecondary\fP و \fBbackup\fP\&. در ساختار \fBload\-balancing\fP باید دقیقاً یک کارساز
primary و یک کارساز secondary وجود داشته باشد.
.IP \(bu 2
\fBauto\-failover\fP \- مقداری بولی است که تعیین می‌کند آیا کارسازی که از کار افتادن
همتای خود را تشخیص می‌دهد، باید به صورت خودکار شروع به پاسخ‌گویی به کلاینت‌های همتا کند یا خیر.
مقدار پیش‌فرض این پارامتر \fBtrue\fP است\&.
.UNINDENT
.sp
در پیکربندی نمونه ما در بالا، هر دو کارساز فعال می‌توانند اجاره‌ها (leases) را از
زیرشبکه \(dq192.0.3.0/24\(dq تخصیص دهند. این زیرشبکه شامل دو استخر آدرس است:
\(dq192.0.3.100 \- 192.0.3.150\(dq و \(dq192.0.3.200 \- 192.0.3.250\(dq که با
استفاده از رده‌بندی کلاینت به دامنه‌های کارساز HA مرتبط شده‌اند. هنگامی که \fBserver1\fP
یک پرس‌وجوی DHCP را پردازش می‌کند، از استخر نخست برای تخصیص اجاره استفاده می‌نماید. در مقابل،
هنگامی که \fBserver2\fP یک پرس‌وجوی DHCP را پردازش می‌کند، از استخر دوم استفاده می‌کند. اگر هر یک
از کارسازها در وضعیت \fBpartner\-down\fP باشد، دیگری می‌تواند اجاره‌ها را از
هر دو استخر ارائه دهد؛ و استخری را انتخاب می‌کند که برای پرس‌وجوی دریافت‌شده مناسب باشد. به
بیان دیگر، اگر پرس‌وجو در حالت عادی توسط \fBserver2\fP پردازش می‌شد اما این
کارساز در دسترس نباشد، \fBserver1\fP اجاره را از استخر
\(dq192.0.3.200 \- 192.0.3.250\(dq تخصیص می‌دهد. سوکت کنترلی HTTP مربوط به \fIserver3\(ga\fP
نیازمند احراز هویت پایه‌ای HTTP است و شناسه کاربر \(dqfoo\(dq را با
گذرواژه \(dq1234\(dq مجاز می‌شناسد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
طرح‌واره \fBurl\fP می‌تواند \fBhttp\fP یا \fBhttps\fP باشد، اما از نسخه 1.9.6 نرم‌افزار Kea
طرح‌واره \fBhttps\fP نیازمند راه‌اندازی TLS است. بخش نام میزبان باید یک آدرس
IPv4 یا یک آدرس IPv6 داخل کروشه باشد، مانند
\fBhttp://[2001:db8::1]:8080\fP\&. نام‌ها پذیرفته نمی‌شوند.
.UNINDENT
.UNINDENT
.SS توازن بار با رده‌بندی پیشرفته (Load Balancing With Advanced Classification)
.sp
در بخش پیشین، مثالی از پیکربندی \fBload\-balancing\fP با رده‌بندی کلاینت
محدود به کلاس‌های \(dqHA_server1\(dq و \(dqHA_server2\(dq ارائه دادیم
که به صورت پویا به پرس‌وجوهای DHCP دریافتی اختصاص می‌یابند. در بسیاری از موارد، HA
در استقرارهایی مورد نیاز است که از پیش از رده‌بندی‌های کلاینت دیگری استفاده می‌کنند.
.sp
سیستمی را فرض کنید که دستگاه‌ها را بر اساس معیارهای رده‌بندی مشخص‌شده در فایل پیکربندی
Kea به دو گروه دسته‌بندی می‌کند: \(dqphones\(dq و \(dqlaptops\(dq.
به هر دو نوع دستگاه از استخرهای آدرس متفاوتی اجاره تخصیص داده می‌شود. اضافه کردن HA در حالت
\fBload\-balancing\fP منجر به تقسیم بیشتر هر یک از این استخرها می‌شود، چرا که هر کارساز
اجاره‌ها را برای برخی گوشی‌ها و برخی لپ‌تاپ‌ها تخصیص می‌دهد. این موضوع نیازمند آن است که
هر یک از استخرهای موجود بین \(dqHA_server1\(dq و \(dqHA_server2\(dq تقسیم شوند، بنابراین در
نهایت کلاس‌های زیر را خواهیم داشت:
.INDENT 0.0
.IP \(bu 2
\(dqphones_server1\(dq
.IP \(bu 2
\(dqlaptops_server1\(dq
.IP \(bu 2
\(dqphones_server2\(dq
.IP \(bu 2
\(dqlaptops_server2\(dq
.UNINDENT
.sp
پیکربندی متناظر کارساز با استفاده از رده‌بندی پیشرفته (و عبارت
\fBmember\fP) در زیر آورده شده است. به منظور اختصار، پیکربندی کتابخانه قلاب HA
از این مثال حذف شده است.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp4\(dq: {
    \(dqclient\-classes\(dq: [{
        \(dqname\(dq: \(dqphones\(dq,
        \(dqtest\(dq: \(dqsubstring(option[60].hex,0,6) == \(aqAastra\(aq\(dq
    }, {
        \(dqname\(dq: \(dqlaptops\(dq,
        \(dqtest\(dq: \(dqnot member(\(aqphones\(aq)\(dq
    }, {
        \(dqname\(dq: \(dqphones_server1\(dq,
        \(dqtest\(dq: \(dqmember(\(aqphones\(aq) and member(\(aqHA_server1\(aq)\(dq
    }, {
        \(dqname\(dq: \(dqphones_server2\(dq,
        \(dqtest\(dq: \(dqmember(\(aqphones\(aq) and member(\(aqHA_server2\(aq)\(dq
    }, {
        \(dqname\(dq: \(dqlaptops_server1\(dq,
        \(dqtest\(dq: \(dqmember(\(aqlaptops\(aq) and member(\(aqHA_server1\(aq)\(dq
    }, {
        \(dqname\(dq: \(dqlaptops_server2\(dq,
        \(dqtest\(dq: \(dqmember(\(aqlaptops\(aq) and member(\(aqHA_server2\(aq)\(dq
    }],

    \(dqhooks\-libraries\(dq: [{
        \(dqlibrary\(dq: \(dqlibdhcp_lease_cmds.so\(dq,
        \(dqparameters\(dq: { }
    }, {
        \(dqlibrary\(dq: \(dqlibdhcp_ha.so\(dq,
        \(dqparameters\(dq: {
            \(dqhigh\-availability\(dq: [{
            }]
        }
    }],

    \(dqsubnet4\(dq: [{
        \(dqid\(dq: 1,
        \(dqsubnet\(dq: \(dq192.0.3.0/24\(dq,
        \(dqpools\(dq: [{
            \(dqpool\(dq: \(dq192.0.3.100 \- 192.0.3.125\(dq,
            \(dqclient\-classes\(dq: [ \(dqphones_server1\(dq ]
        }, {
            \(dqpool\(dq: \(dq192.0.3.126 \- 192.0.3.150\(dq,
            \(dqclient\-classes\(dq: [ \(dqlaptops_server1\(dq ]
        }, {
            \(dqpool\(dq: \(dq192.0.3.200 \- 192.0.3.225\(dq,
            \(dqclient\-classes\(dq: [ \(dqphones_server2\(dq ]
        }, {
            \(dqpool\(dq: \(dq192.0.3.226 \- 192.0.3.250\(dq,
            \(dqclient\-classes\(dq: [ \(dqlaptops_server2\(dq ]
        }],

        \(dqoption\-data\(dq: [{
            \(dqname\(dq: \(dqrouters\(dq,
            \(dqdata\(dq: \(dq192.0.3.1\(dq
        }],

        \(dqrelay\(dq: { \(dqip\-address\(dq: \(dq10.1.2.3\(dq }
    }]
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
پیکربندی ارائه‌شده در بالا، محدوده نشانی را به چهار استخر تقسیم می‌کند: دو استخر
اختصاص‌یافته به \(dqHA_server1\(dq و دو استخر به \(dqHA_server2\(dq. هر کارساز می‌تواند اجاره‌ها
را به هر دو گروه گوشی‌ها و لپ‌تاپ‌ها اختصاص دهد. به هر دو گروه دستگاه‌ها از استخرهای
متفاوتی نشانی تخصیص داده می‌شود. کلاس‌های \(dqHA_server1\(dq و \(dqHA_server2\(dq توکار (built\-in)
هستند (بخش «کلاس‌های توکار کلاینت» (Built\-in Client Classes) \%<#\:built-in-client-classes> را ببینید) و نیازی به تعریف آن‌ها نیست.
آن‌ها به صورت پویا توسط کتابخانه قلاب HA بر اساس الگوریتم
\fBload\-balancing\fP تخصیص می‌یابند. هنگامی که پرس‌وجو متعلق به ترکیب معینی از سایر کلاس‌ها باشد،
مانند \(dqHA_server1\(dq و \(dqphones\(dq، عبارت‌های \(dqphones_*\(dq و \(dqlaptop_*\(dq به \fBtrue\fP
ارزیابی می‌شوند. استخر نیز بر اساس نتیجه چنین ارزیابی‌ای انتخاب می‌گردد.
.sp
برای آگاهی از جزئیات چگونگی استفاده از عبارت \fBmember\fP و وابستگی‌های
کلاس، به «رده‌بندی کلاینت» (Client Classification) \%<#\:classify> مراجعه کنید..SS پیکربندی Hot\-Standby
.sp
در ادامه نمونه‌ای از پیکربندی سرور اصلی (primary) در پیکربندی \fBhot\-standby\fP آورده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqhooks\-libraries\(dq: [{
        \(dqlibrary\(dq: \(dqlibdhcp_lease_cmds.so\(dq,
        \(dqparameters\(dq: { }
    }, {
        \(dqlibrary\(dq: \(dqlibdhcp_ha.so\(dq,
        \(dqparameters\(dq: {
            \(dqhigh\-availability\(dq: [{
                \(dqthis\-server\-name\(dq: \(dqserver1\(dq,
                \(dqmode\(dq: \(dqhot\-standby\(dq,
                \(dqheartbeat\-delay\(dq: 10000,
                \(dqmax\-response\-delay\(dq: 60000,
                \(dqmax\-ack\-delay\(dq: 5000,
                \(dqmax\-unacked\-clients\(dq: 5,
                \(dqmax\-rejected\-lease\-updates\(dq: 10,
                \(dqpeers\(dq: [{
                    \(dqname\(dq: \(dqserver1\(dq,
                    \(dqurl\(dq: \(dqhttp://192.168.56.33:8005/\(dq,
                    \(dqrole\(dq: \(dqprimary\(dq,
                    \(dqauto\-failover\(dq: true
                }, {
                    \(dqname\(dq: \(dqserver2\(dq,
                    \(dqurl\(dq: \(dqhttp://192.168.56.66:8005/\(dq,
                    \(dqrole\(dq: \(dqstandby\(dq,
                    \(dqauto\-failover\(dq: true
                }, {
                    \(dqname\(dq: \(dqserver3\(dq,
                    \(dqurl\(dq: \(dqhttp://192.168.56.99:8005/\(dq,
                    \(dqbasic\-auth\-user\(dq: \(dqfoo\(dq,
                    \(dqbasic\-auth\-password\(dq: \(dq1234\(dq,
                    \(dqrole\(dq: \(dqbackup\(dq,
                    \(dqauto\-failover\(dq: false
                }]
            }]
        }
    }],

    \(dqsubnet4\(dq: [{
        \(dqid\(dq: 1,
        \(dqsubnet\(dq: \(dq192.0.3.0/24\(dq,
        \(dqpools\(dq: [{
            \(dqpool\(dq: \(dq192.0.3.100 \- 192.0.3.250\(dq,
            \(dqclient\-classes\(dq: [ \(dqHA_server1\(dq ]
        }],

        \(dqoption\-data\(dq: [{
            \(dqname\(dq: \(dqrouters\(dq,
            \(dqdata\(dq: \(dq192.0.3.1\(dq
        }],

        \(dqrelay\(dq: { \(dqip\-address\(dq: \(dq10.1.2.3\(dq }
    }]
}
.EE
.UNINDENT
.UNINDENT
.sp
این پیکربندی شباهت بسیاری به پیکربندی \fBload\-balancing\fP شرح داده شده در «پیکربندی Load\-Balancing» دارد، با چند تفاوت قابل توجه.
.sp
پارامتر \fBmode\fP اکنون روی \fBhot\-standby\fP تنظیم شده است که در آن تنها یک سرور به کلاینت‌های DHCP پاسخ می‌دهد. اگر سرور اصلی (primary) برخط باشد، به تمام درخواست‌های DHCP پاسخ می‌دهد. سرور \fBstandby\fP تنها در صورتی تمام ترافیک DHCP را بر عهده می‌گیرد که متوجه در دسترس نبودن سرور اصلی شود.
.sp
در این حالت، سرور فعال غیر اصلی (non\-primary) \fBstandby\fP نامیده می‌شود و نقش آن نیز همین است.
.sp
در نهایت، از آنجا که همواره تنها یک سرور به پرس‌وجوهای DHCP پاسخ می‌دهد، تنها یک محدوده \- \(dqHA_server1\(dq \- درون تعاریف pool استفاده می‌شود. در واقع، پارامتر \fBclient\-class\fP را می‌توان بدون مشکل از این پیکربندی حذف کرد، زیرا با توجه به اینکه سرورها به صورت هم‌زمان اجاره‌ها را تخصیص نمی‌دهند، هیچ تداخلی در تخصیص اجاره‌ها توسط سرورهای مختلف رخ نخواهد داد. پارامتر \fBclient\-class\fP در این مثال بیشتر به منظور نمایش و برجسته کردن تفاوت‌های بین حالت‌های عملیاتی \fBhot\-standby\fP و \fBload\-balancing\fP باقی مانده است.
.SS پیکربندی Passive\-Backup
.sp
در ادامه نمونه‌ای از فایل پیکربندی برای سرور اصلی در پیکربندی \fBpassive\-backup\fP آمده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp4\(dq: {
    \(dqhooks\-libraries\(dq: [{
        \(dqlibrary\(dq: \(dqlibdhcp_lease_cmds.so\(dq,
        \(dqparameters\(dq: { }
    }, {
        \(dqlibrary\(dq: \(dqlibdhcp_ha.so\(dq,
        \(dqparameters\(dq: {
            \(dqhigh\-availability\(dq: [{
                \(dqthis\-server\-name\(dq: \(dqserver1\(dq,
                \(dqmode\(dq: \(dqpassive\-backup\(dq,
                \(dqwait\-backup\-ack\(dq: false,
                \(dqpeers\(dq: [{
                    \(dqname\(dq: \(dqserver1\(dq,
                    \(dqurl\(dq: \(dqhttp://192.168.56.33:8005/\(dq,
                    \(dqrole\(dq: \(dqprimary\(dq
                }, {
                    \(dqname\(dq: \(dqserver2\(dq,
                    \(dqurl\(dq: \(dqhttp://192.168.56.66:8005/\(dq,
                    \(dqrole\(dq: \(dqbackup\(dq
                }, {
                    \(dqname\(dq: \(dqserver3\(dq,
                    \(dqurl\(dq: \(dqhttp://192.168.56.99:8005/\(dq,
                    \(dqbasic\-auth\-user\(dq: \(dqfoo\(dq,
                    \(dqbasic\-auth\-password\(dq: \(dq1234\(dq,
                    \(dqrole\(dq: \(dqbackup\(dq
                }]
            }]
        }
    }],

    \(dqsubnet4\(dq: [{
        \(dqid\(dq: 1,
        \(dqsubnet\(dq: \(dq192.0.3.0/24\(dq,
        \(dqpools\(dq: [{
            \(dqpool\(dq: \(dq192.0.3.100 \- 192.0.3.250\(dq
        }],

        \(dqoption\-data\(dq: [{
            \(dqname\(dq: \(dqrouters\(dq,
            \(dqdata\(dq: \(dq192.0.3.1\(dq
        }],

        \(dqrelay\(dq: { \(dqip\-address\(dq: \(dq10.1.2.3\(dq }
    }]
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
پیکربندی‌های سه همتا (peer) گنجانده شده است: یکی برای سرور اصلی (primary) و دو تا برای سرورهای پشتیبان (backup).
.sp
بسیاری از پارامترهای موجود در مثال‌های پیکربندی \fBload\-balancing\fP و \fBhot\-standby\fP در حالت \fBpassive\-backup\fP کاربردی ندارند، بنابراین در اینجا مشخص نشده‌اند. به عنوان مثال: \fBheartbeat\-delay\fP، \fBmax\-unacked\-clients\fP، \fBmax\-rejected\-lease\-updates\fP و موارد دیگری که به سازوکار failover مربوط می‌شوند، نباید در حالت \fBpassive\-backup\fP مشخص شوند.
.sp
پارامتر \fBwait\-backup\-ack\fP یک پارامتر بولی (boolean) است که در مثال‌های قبلی وجود نداشت. مقدار پیش‌فرض آن \fBfalse\fP است و نباید در حالت‌های \fBload\-balancing\fP و \fBhot\-standby\fP تغییر داده شود. در حالت \fBpassive\-backup\fP این پارامتر می‌تواند روی \fBtrue\fP تنظیم شود، که باعث می‌شود سرور اصلی قبل از پاسخ دادن به کلاینت DHCP، منتظر دریافت تأییدیه‌ها (acknowledgments) برای به‌روزرسانی‌های اجاره از سرورهای پشتیبان باشد. این کار تضمین می‌کند که اجاره قبل از اعطا به کلاینت در تمام سرورها منتشر شده است، اما در صورت بروز مشکل ارتباطی با یکی از سرورهای پشتیبان، خطر از دست رفتن سرویس DHCP را به همراه دارد. این تنظیم همچنین به دلیل زمانی که سرور اصلی صرف انتظار برای تأییدیه‌ها می‌کند، تأخیر (latency) پاسخ DHCP را افزایش می‌دهد. توصیه می‌کنیم در صورتی که قابلیت اطمینان سرویس DHCP از یکپارچگی اطلاعات اجاره بین سرور اصلی و سرورهای پشتیبان مهم‌تر است، و در تمام مواردی که تأخیر سرویس DHCP باید حداقل باشد، تنظیم \fBwait\-backup\-ack\fP روی مقدار پیش‌فرض خود (\fBfalse\fP) باقی بماند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
در حال حاضر، سرورهای فعال به‌روزرسانی‌های اجاره را برای ارسال به همتاها در صف‌های داخلی قرار می‌دهند (یک صف برای هر همتا/URL). در حالت \fBpassive\-backup\fP، سرورهای فعال منتظر تأیید به‌روزرسانی‌های اجاره نمی‌مانند؛ بنابراین در زمان‌های ترافیک سنگین کلاینت‌ها، این احتمال وجود دارد که تعداد به‌روزرسانی‌های اجاره در صف ارسال سریع‌تر از توان تحویل آنها انباشته شود. با کاهش ترافیک کلاینت، صف‌ها شروع به خالی شدن می‌کنند. از نسخه Kea 2.0.0 به بعد، سرورهای فعال اندازه این صف‌ها را پایش می‌کنند و اگر تشخیص دهند که صفی بیش از حد سریع رشد می‌کند، هشدارهای دوره‌ای صادر می‌کنند (به HTTP_CLIENT_QUEUE_SIZE_GROWING در Kea Messages Manual \%<#\:kea-messages> مراجعه کنید). این هشدارها به محض شروع کوچک شدن صف متوقف می‌شوند. این پیام‌ها به عنوان یک شاخص پیش‌آگاهی در نظر گرفته شده‌اند و مشاهده گاه‌به‌گاه آن‌ها در زمان بار ترافیکی سنگین لزوماً نشان‌دهنده مشکل نیست. با این حال، اگر این هشدارها به طور مداوم در شرایط بار ترافیکی معمول رخ دهند، به احتمال زیاد نشان‌دهنده عدم تطابق در توانایی‌های سرور و/یا پیکربندی آن هستند؛ این موضوع باید بررسی شود، زیرا اندازه صف‌ها در نهایت ممکن است توانایی سرور فعال را در پاسخ‌گویی به موقع به کلاینت‌ها مختل کند.
.UNINDENT
.UNINDENT.SS اشتراک‌گذاری اطلاعات اجاره (Lease Information Sharing)
.sp
یک سرور مجهز به HA با ارسال دستورات کنترلی مناسب، شریک فعال خود را از اجاره‌های تخصیص‌یافته یا تمدیدشده مطلع می‌سازد، و شریک نیز اطلاعات اجاره را در پایگاه داده خود به‌روزرسانی می‌کند. هنگامی که سرور برای نخستین بار راه‌اندازی می‌شود یا پس از یک خرابی بازیابی می‌گردد، پایگاه داده اجاره‌های خود را با شریکش همگام‌سازی می‌کند. این دو سازوکار، سازگاری اطلاعات اجاره میان سرورها را تضمین کرده و اجازه می‌دهند در صورت از دسترس خارج شدن یکی از سرورها، سرور دیگر کل بار ترافیک DHCP را مدیریت کند.
.sp
با این حال در برخی موارد، چنانچه تبادل اطلاعات درباره اجاره‌های تخصیص‌یافته با استفاده از سازوکار دیگری انجام گیرد، غیرفعال کردن به‌روزرسانی‌های اجاره و/یا همگام‌سازی پایگاه داده میان سرورهای فعال مطلوب خواهد بود. Kea از انواع مختلف پایگاه‌های داده که می‌توانند برای ذخیره اجاره‌ها استفاده شوند، از جمله MySQL و PostgreSQL پشتیبانی می‌کند. این پایگاه‌های داده شامل راهکارهای توکار برای تکثیر داده‌ها (data replication) هستند که اغلب توسط مدیران Kea جهت فراهم آوردن افزونگی (redundancy) به کار گرفته می‌شوند.
.sp
کتابخانه قلاب HA از چنین سناریوهایی با غیرفعال کردن به‌روزرسانی‌های اجاره از طریق کانال کنترلی و/یا همگام‌سازی پایگاه داده اجاره پشتیبانی می‌کند و سرور را بر سازوکار تکثیر پایگاه داده متکی می‌سازد. این رفتار توسط دو پارامتر بولی \fBsend\-lease\-updates\fP و \fBsync\-leases\fP کنترل می‌شود که مقادیر پیش‌فرض آن‌ها \fBtrue\fP است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqhooks\-libraries\(dq: [
        {
            \(dqlibrary\(dq: \(dqlibdhcp_lease_cmds.so\(dq,
            \(dqparameters\(dq: { }
        },
        {
            \(dqlibrary\(dq: \(dqlibdhcp_ha.so\(dq,
            \(dqparameters\(dq: {
                \(dqhigh\-availability\(dq: [ {
                    \(dqthis\-server\-name\(dq: \(dqserver1\(dq,
                    \(dqmode\(dq: \(dqload\-balancing\(dq,
                    \(dqsend\-lease\-updates\(dq: false,
                    \(dqsync\-leases\(dq: false,
                    \(dqpeers\(dq: [
                        {
                            \(dqname\(dq: \(dqserver1\(dq,
                            \(dqurl\(dq: \(dqhttp://192.168.56.33:8005/\(dq,
                            \(dqrole\(dq: \(dqprimary\(dq
                        },
                        {
                            \(dqname\(dq: \(dqserver2\(dq,
                            \(dqurl\(dq: \(dqhttp://192.168.56.66:8005/\(dq,
                            \(dqrole\(dq: \(dqsecondary\(dq
                        }
                    ]
                } ]
            }
        }
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
در متداول‌ترین حالت استفاده، هر دو پارامتر روی یک مقدار یکسان تنظیم می‌شوند؛ یعنی در صورت استفاده از تکثیر پایگاه داده هر دو روی \fBfalse\fP و در غیر این صورت هر دو روی \fBtrue\fP قرار می‌گیرند. معرفی دو پارامتر مجزا برای کنترل به‌روزرسانی‌های اجاره و همگام‌سازی پایگاه داده اجاره، با هدف پشتیبانی از موارد استفاده خاص صورت گرفته است؛ به عنوان مثال، زمانی که همگام‌سازی با کپی کردن یک فایل اجاره انجام می‌شود (بنابراین \fBsync\-leases\fP روی \fBfalse\fP تنظیم می‌گردد)، اما به‌روزرسانی‌های اجاره باید طبق روال عادی ارسال شوند (\fBsend\-lease\-updates\fP روی \fBtrue\fP تنظیم می‌شود). لازم به ذکر است که Kea به‌صورت توکار از چنین مواردی پشتیبانی نمی‌کند، اما کاربران می‌توانند اسکریپت‌ها و ابزارهای اختصاصی خود را پیرامون Kea توسعه دهند تا چنین سازوکارهایی فراهم شود. پیکربندی کتابخانه قلاب HA طوری طراحی شده است که انعطاف‌پذیری مدیریت را به حداکثر برساند.
.SS کنترل حد اندازه صفحه اجاره (Controlling Lease\-Page Size Limit)
.sp
یک سرور مجهز به HA، پس از توقف فعالیت یا پس از دریافت دستور \fBha\-sync\fP، همگام‌سازی پایگاه داده اجاره را آغاز می‌کند. سرور از دستورات \fBlease4\-get\-page\fP و \fBlease6\-get\-page\fP برای واکشی اجاره‌ها از سرور شریک خود استفاده می‌کند (پرس‌وجوهای اجاره). اندازه صفحه نتایج (حداکثر تعداد اجاره‌هایی که در یک پاسخ واحد به یکی از این دستورات بازگردانده می‌شوند) از طریق پیکربندی کتابخانه قلاب HA قابل کنترل است. افزایش اندازه صفحه، تعداد پرس‌وجوهای اجاره ارسالی به سرور شریک را کاهش می‌دهد، اما باعث می‌شود سرور شریک پاسخ‌های حجیم‌تری تولید کند که موجب افزایش زمان انتقال و همچنین افزایش مصرف حافظه و CPU در هر دو سرور می‌گردد. کاهش اندازه صفحه به کاهش مصرف منابع کمک می‌کند، اما نیازمند ارسال پرس‌وجوهای اجاره بیشتری جهت واکشی کل پایگاه داده اجاره است.
.sp
مقدار پیش‌فرض دستور \fBsync\-page\-limit\fP که اندازه صفحه را کنترل می‌کند 10000 است. این بدان معناست که اگر اندازه پایگاه داده برابر یا کمتر از 10000 خط باشد، کل پایگاه داده اجاره می‌تواند با یک دستور واحد واکشی شود.
.SS مهلت‌های زمانی (Timeouts)
.sp
در استقرارهایی با تعداد زیادی کلاینت متصل به شبکه، همگام‌سازی پایگاه داده اجاره پس از خرابی یک سرور ممکن است عملیاتی زمان‌بر باشد. سرور همگام‌ساز باید تمام اجاره‌ها را از شریک خود جمع‌آوری کند که پاسخی بزرگ را از طریق رابط RESTful به همراه دارد. سرور، اجاره‌ها را با استفاده از سازوکار صفحه‌بندی توضیح داده شده در «کنترل حد اندازه صفحه اجاره» دریافت می‌کند. پیش از واکشی صفحه اجاره‌ها، سرور همگام‌ساز دستور \fBdhcp\-disable\fP \%<#\:std-isccmd-dhcp-disable> را برای غیرفعال کردن سرویس DHCP در سرور شریک ارسال می‌کند. اگر این سرویس از قبل غیرفعال باشد، این دستور مهلت زمانی غیرفعال بودن سرویس DHCP را بازنشانی می‌کند که به‌طور پیش‌فرض روی 60 ثانیه تنظیم شده است. اگر واکشی یک صفحه واحد از اجاره‌ها بیش از زمان تعیین‌شده طول بکشد، سرور شریک فرض می‌کند که سرور همگام‌ساز از کار افتاده است و سرویس DHCP خود را از سر می‌گیرد. اتصال سرور همگام‌ساز با شریک خود نیز توسط مهلت زمانی محافظت می‌شود. اگر همگام‌سازی یک صفحه از اجاره‌ها بیشتر از زمان مشخص‌شده به طول بینجامد، سرور همگام‌ساز اتصال را قطع کرده و همگام‌سازی با شکست مواجه می‌شود. هر دو مقدار مهلت زمانی توسط یک پارامتر پیکربندی واحد به نام \fBsync\-timeout\fP کنترل می‌شوند. قطعه‌پیکربندی زیر نحوه اصلاح مهلت زمانی برای فعال‌سازی مجدد خودکار سرویس DHCP در سرور شریک و نحوه افزایش مهلت زمانی برای واکشی یک صفحه از اجاره‌ها از 60 ثانیه به 90 ثانیه را نشان می‌دهد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqhooks\-libraries\(dq: [
        {
            \(dqlibrary\(dq: \(dqlibdhcp_lease_cmds.so\(dq,
            \(dqparameters\(dq: { }
        },
        {
            \(dqlibrary\(dq: \(dqlibdhcp_ha.so\(dq,
            \(dqparameters\(dq: {
                \(dqhigh\-availability\(dq: [ {
                    \(dqthis\-server\-name\(dq: \(dqserver1\(dq,
                    \(dqmode\(dq: \(dqload\-balancing\(dq,
                    \(dqsync\-timeout\(dq: 90000,
                    \(dqpeers\(dq: [
                        {
                            \(dqname\(dq: \(dqserver1\(dq,
                            \(dqurl\(dq: \(dqhttp://192.168.56.33:8005/\(dq,
                            \(dqrole\(dq: \(dqprimary\(dq
                        },
                        {
                            \(dqname\(dq: \(dqserver2\(dq,
                            \(dqurl\(dq: \(dqhttp://192.168.56.66:8005/\(dq,
                            \(dqrole\(dq: \(dqsecondary\(dq
                        }
                    ]
                } ]
            }
        }
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
توجه به این نکته مهم است که افزایش این مقدار \fBsync\-timeout\fP ممکن است گاهی اوقات برای جلوگیری از بروز مشکلات مهلت زمانی در حین همگام‌سازی پایگاه داده اجاره کافی نباشد. سرور DHCP همچنین اتصال از سمت همتا را برای بررسی مهلت‌های زمانی زیر نظر می‌گیرد. این مهلت‌های زمانی در حال حاضر از طریق پیکربندی قابل تغییر نیستند؛ افزایش این مهلت‌های زمانی تنها با اصلاح آن‌ها در کد Kea و کامپایل مجدد سرور امکان‌پذیر است. ثابت‌های مربوطه در سورس Kea در مسیر \fBsrc/lib/config/timeouts.h\fP\& قرار دارند..SS توقف موقت ماشین وضعیت HA
.sp
ماشین وضعیت \fBhigh\-availability\fP شامل وضعیت‌های مختلف بسیاری است که با جزئیات در Server States شرح داده شده‌اند\&. کارساز هنگامی وارد هر وضعیت می‌شود که شرایط خاصی برآورده شوند، که اغلب اوقات وضعیت کارساز همکار را نیز در نظر می‌گیرد. در برخی وضعیت‌ها کارساز اقدامات خاصی انجام می‌دهد؛ برای مثال، همگام‌سازی پایگاه‌داده واگذاری‌ها در وضعیت \fBsyncing\fP، یا پاسخ‌گویی به پرس‌وجوهای DHCP مطابق با حالت عملیاتی پیکربندی‌شده در وضعیت‌های \fBload\-balancing\fP و \fBhot\-standby\fP.
.sp
به‌طور پیش‌فرض، گذارها بین وضعیت‌ها به‌صورت خودکار انجام می‌شوند و مدیر کارساز کنترل مستقیمی بر زمان وقوع گذارها ندارد؛ در بیشتر موارد، مدیر به چنین کنترلی نیاز ندارد. با این حال، در برخی شرایط ممکن است مدیر بخواهد ماشین وضعیت HA را در یک وضعیت مشخص \(dqمتوقف\(dq کند تا پیش از گذار کارساز به وضعیت بعدی، اقدامات مدیریتی بیشتری را انجام دهد.
.sp
خرابی کارسازی را در نظر بگیرید که منجر به از دست رفتن کل پایگاه‌داده واگذاری‌ها می‌شود. به‌طور معمول، کارساز با استعلام واگذاری‌ها از کارساز همکار به هنگام ورود به وضعیت \fBsyncing\fP، پایگاه‌داده واگذاری‌های خود را بازسازی می‌کند، اما این احتمال وجود دارد که همکار نیز دچار خرابی شده و فاقد اطلاعات واگذاری باشد. در این حالت، ممکن است نیاز باشد پایگاه‌داده واگذاری‌ها در هر دو کارساز از یک منبع خارجی، مانند یک کارساز پشتیبان، بازسازی شود. اگر قرار است پایگاه‌داده واگذاری‌ها از طریق RESTful API بازسازی شود، کارسازها باید در وضعیت اولیه، یعنی \fBwaiting\fP، راه‌اندازی شوند و در حین افزودن واگذاری‌ها در همین وضعیت باقی بمانند. به‌ویژه، کارسازها نباید برای همگام‌سازی پایگاه‌داده واگذاری‌های خود تلاشی کنند و نباید سرویس‌دهی به کلاینت‌های DHCP را آغاز نمایند.
.sp
کتابخانه قلاب HA پارامترهای پیکربندی و دستوری را برای کنترل توقف موقت و ازسرگیری ماشین وضعیت HA فراهم می‌کند. پیکربندی زیر باعث می‌شود که ماشین وضعیت HA پس از راه‌اندازی کارساز در وضعیت \fBwaiting\fP متوقف شود.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqhooks\-libraries\(dq: [
        {
            \(dqlibrary\(dq: \(dqlibdhcp_lease_cmds.so\(dq,
            \(dqparameters\(dq: { }
        },
        {
            \(dqlibrary\(dq: \(dqlibdhcp_ha.so\(dq,
            \(dqparameters\(dq: {
                \(dqhigh\-availability\(dq: [ {
                    \(dqthis\-server\-name\(dq: \(dqserver1\(dq,
                    \(dqmode\(dq: \(dqload\-balancing\(dq,
                    \(dqpeers\(dq: [
                        {
                            \(dqname\(dq: \(dqserver1\(dq,
                            \(dqurl\(dq: \(dqhttp://192.168.56.33:8005/\(dq,
                            \(dqrole\(dq: \(dqprimary\(dq
                        },
                        {
                            \(dqname\(dq: \(dqserver2\(dq,
                            \(dqurl\(dq: \(dqhttp://192.168.56.66:8005/\(dq,
                            \(dqrole\(dq: \(dqsecondary\(dq
                        }
                    ],
                    \(dqstate\-machine\(dq: {
                        \(dqstates\(dq: [
                            {
                                \(dqstate\(dq: \(dqwaiting\(dq,
                                \(dqpause\(dq: \(dqonce\(dq
                            }
                        ]
                    }
                } ]
            }
        }
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
مقدار \fBonce\fP برای پارامتر \fBpause\fP نشان می‌دهد که ماشین وضعیت باید در نخستین گذار به وضعیت \fBwaiting\fP متوقف شود؛ گذارهای بعدی به این وضعیت موجب توقف ماشین وضعیت نخواهند شد. دو مقدار پشتیبانی‌شده دیگر برای پارامتر \fBpause\fP مقادیر \fBalways\fP و \fBnever\fP هستند\&. مقدار اخیر مقدار پیش‌فرض برای هر وضعیت است که به کارساز دستور می‌دهد هرگز ماشین وضعیت را متوقف نکند.
.sp
به منظور خروج ماشین وضعیت از حالت توقف، باید دستور \fBha\-continue\fP به کارساز متوقف‌شده ارسال شود. این دستور هیچ آرگومانی نمی‌پذیرد. برای جزئیات درباره دستورهای ویژه \fBlibdhcp_ha.so\fP به Control Commands for High Availability مراجعه کنید\&.
.sp
پیکربندی ماشین وضعیت برای توقف در بیش از یک وضعیت امکان‌پذیر است. پیکربندی زیر را در نظر بگیرید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqhooks\-libraries\(dq: [
        {
            \(dqlibrary\(dq: \(dqlibdhcp_lease_cmds.so\(dq,
            \(dqparameters\(dq: { }
        },
        {
            \(dqlibrary\(dq: \(dqlibdhcp_ha.so\(dq,
            \(dqparameters\(dq: {
                \(dqhigh\-availability\(dq: [ {
                    \(dqthis\-server\-name\(dq: \(dqserver1\(dq,
                    \(dqmode\(dq: \(dqload\-balancing\(dq,
                    \(dqpeers\(dq: [
                        {
                            \(dqname\(dq: \(dqserver1\(dq,
                            \(dqurl\(dq: \(dqhttp://192.168.56.33:8005/\(dq,
                            \(dqrole\(dq: \(dqprimary\(dq
                        },
                        {
                            \(dqname\(dq: \(dqserver2\(dq,
                            \(dqurl\(dq: \(dqhttp://192.168.56.66:8005/\(dq,
                            \(dqrole\(dq: \(dqsecondary\(dq
                        }
                    ],
                    \(dqstate\-machine\(dq: {
                        \(dqstates\(dq: [
                            {
                                \(dqstate\(dq: \(dqready\(dq,
                                \(dqpause\(dq: \(dqalways\(dq
                            },
                            {
                                \(dqstate\(dq: \(dqpartner\-down\(dq,
                                \(dqpause\(dq: \(dqonce\(dq
                            }
                        ]
                    }
                } ]
            }
        }
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
این پیکربندی به کارساز دستور می‌دهد که هر بار پس از گذار به وضعیت \fBready\fP و همچنین در نخستین گذار به وضعیت \fBpartner\-down\fP، ماشین وضعیت را متوقف کند.
.sp
برای مشاهده فهرست کامل وضعیت‌های کارساز به Server States مراجعه کنید. ماشین وضعیت را می‌توان در هر یک از وضعیت‌های پشتیبانی‌شده متوقف کرد؛ با این حال، متوقف کردن در وضعیت‌های \fBbackup\fP یا \fBterminated\fP کاربردی ندارد، زیرا کارساز در هر صورت هرگز از این وضعیت‌ها خارج نمی‌شود.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
در وضعیت \fBsyncing\fP کارساز پیش از تلاش برای همگام‌سازی پایگاه‌داده واگذاری‌ها با کارساز همکار متوقف می‌شود. برای متوقف کردن ماشین وضعیت پس از همگام‌سازی پایگاه‌داده واگذاری‌ها، به جای آن از وضعیت \fBready\fP استفاده کنید.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
وضعیت ماشین وضعیت HA به وضعیت کارساز همکار وابسته است. بنابراین، متوقف کردن ماشین وضعیت یک کارساز ممکن است بر عملکرد کارساز همکار تأثیر بگذارد. برای مثال: اگر کارساز اصلی در وضعیت \fBwaiting\fP متوقف شود، کارساز همکار نیز تا زمانی که ماشین وضعیت کارساز اصلی از سر گرفته نشده و آن کارساز به وضعیت \fBready\fP گذار نکند، در وضعیت \fBwaiting\fP باقی خواهد ماند.
.UNINDENT
.UNINDENT.SS پیکربندی چندنخی (HA+MT)
.sp
امکان پیکربندی HA برای استفاده از ارتباط مستقیم چندنخی بین همتایان (peers) وجود دارد. ما این حالت را HA+MT می‌نامیم. با فعال بودن HA+MT، هر همتا شنونده (کارساز) HTTP اختصاصی و داخلی خود را اجرا می‌کند که مستقیماً دستورها را دریافت کرده و به آن‌ها پاسخ می‌دهد؛ بنابراین ترتیبی بودن پردازش دستورها از جمله برای پروتکل HA میان همتایان حذف می‌شود. افزون بر این، هر دو جزء شنونده و کلاینت از چندنخی برای پشتیبانی از چندین اتصال هم‌روند میان همتایان استفاده می‌کنند. با حذف بار اضافی از کانال کنترلی و اجرای موازی مبادلات چندگانه دستورها، توان عملیاتی HA بین همتایان در بیشتر شرایط در مقایسه با نسخه‌های پیشین Kea به طور چشمگیری بهبود می‌یابد.
.sp
پارامترهای زیر برای پشتیبانی از عملکرد HA+MT به پیکربندی HA افزوده شده‌اند:
.INDENT 0.0
.IP \(bu 2
\fBenable\-multi\-threading\fP \- ارتباط چندنخی همتایان HA‏ (HA+MT) را فعال یا غیرفعال می‌کند. برای عملکرد HA+MT، قابلیت چندنخی در هسته Kea باید فعال باشد. هنگامی که روی \fBfalse\fP باشد، کارساز برای ارتباط با همتای خود به یک سوکت کنترلی HTTP متکی خواهد بود و از پردازش کلاینت HTTP تک‌نخی استفاده می‌کند. مقدار پیش‌فرض \fBtrue\fP است\&.
.IP \(bu 2
\fBhttp\-dedicated\-listener\fP \- ایجاد یک شنونده HTTP داخلی و اختصاصی را که کارساز از طریق آن پیام‌های HA را از همتایان خود دریافت می‌کند، فعال یا غیرفعال می‌کند. شنونده داخلی جایگزین ترافیک سوکت کنترلی می‌شود و به همتایان اجازه می‌دهد دستورهای HA خود را مستقیماً برای یکدیگر ارسال کنند. شنونده روی \fBurl\fP متعلق به همتا به شنود می‌پردازد\&. در صورت تنظیم روی \fBfalse\fP، کارساز به سوکت کنترلی HTTP متکی می‌شود. این پارامتر عمدتاً برای انعطاف‌پذیری و آزمون ارائه شده است؛ اجرای HA+MT بدون فعال بودن شنونده‌های اختصاصی، توان عملیاتی HA را به شدت محدود خواهد کرد. مقدار پیش‌فرض \fBtrue\fP است\&.
.IP \(bu 2
\fBhttp\-listener\-threads\fP \- حداکثر تعداد نخ‌هایی را که شنونده اختصاصی باید استفاده کند مشخص می‌کند. مقدار \fB0\fP به کارساز دستور می‌دهد از همان تعداد نخ‌هایی استفاده کند که هسته Kea برای چندنخی DHCP به کار می‌برد. مقدار پیش‌فرض \fB0\fP است\&.
.IP \(bu 2
\fBhttp\-client\-threads\fP \- حداکثر تعداد نخ‌هایی را که باید برای ارسال پیام‌های HA به همتایان استفاده شود، مشخص می‌کند. مقدار \fB0\fP به کارساز دستور می‌دهد از همان تعداد نخ‌هایی استفاده کند که هسته Kea برای چندنخی DHCP به کار می‌برد. مقدار پیش‌فرض \fB0\fP است\&.
.UNINDENT
.sp
این پارامترها همان‌طور که در زیر نشان داده شده است، در قالب یک عنصر نگاشت با نام \fBmulti\-threading\fP با یکدیگر گروه‌بندی می‌شوند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {
    \(dqhooks\-libraries\(dq: [
        {
            \(dqlibrary\(dq: \(dqlibdhcp_lease_cmds.so\(dq,
            \(dqparameters\(dq: { }
        },
        {
            \(dqlibrary\(dq: \(dqlibdhcp_ha.so\(dq,
            \(dqparameters\(dq: {
                \(dqhigh\-availability\(dq: [ {
                    \(dqthis\-server\-name\(dq: \(dqserver1\(dq,
                    \(dqmulti\-threading\(dq: {
                        \(dqenable\-multi\-threading\(dq: true,
                        \(dqhttp\-dedicated\-listener\(dq: true,
                        \(dqhttp\-listener\-threads\(dq: 4,
                        \(dqhttp\-client\-threads\(dq: 4
                    },
                    \(dqpeers\(dq: [
                      // This is the configuration of this server instance.
                      {
                          \(dqname\(dq: \(dqserver1\(dq,
                          // This specifies the URL of our server instance.
                          // Since the HA+MT uses a direct connection, the
                          // DHCPv4 server open its own socket. Note that it
                          // must be different than the one used by the control
                          // socket (typically 8000). In this example, 8005 is used.
                          \(dqurl\(dq: \(dqhttp://192.0.2.1:8005/\(dq,
                          // This server is primary. The other one must be
                          // secondary.
                          \(dqrole\(dq: \(dqprimary\(dq
                      },
                      // This is the configuration of our HA peer.
                      {
                          \(dqname\(dq: \(dqserver2\(dq,
                          // This specifies the URL of our server instance.
                          // Since the HA+MT uses a direct connection, the
                          // DHCPv4 server open its own socket. Note that it
                          // must be different than the one used by the control
                          // socket (typically 8000). In this example, 8005 is used.
                          \(dqurl\(dq: \(dqhttp://192.0.2.2:8005/\(dq,
                          // The partner is a secondary. This server is a
                          // primary as specified in the previous \(dqpeers\(dq
                          // entry and in \(dqthis\-server\-name\(dq before that.
                          \(dqrole\(dq: \(dqsecondary\(dq
                      },
                      ...
                    ],
                    ...
                },
                ...
                ]
            }
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
در مثال بالا، HA+MT با چهار نخ برای شنونده و چهار نخ برای کلاینت فعال شده است.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
پیکربندی درست پورت‌ها امری حیاتی است. یک اشتباه رایج، پیکربندی سوکت کنترلی برای شنود روی پورت 8000 و همچنین تنظیم شنونده‌های اختصاصی روی پورت 8000 است. در چنین پیکربندی، ارتباط همچنان از طریق سوکت کنترلی (در حالت تک‌نخی) کار خواهد کرد، اما کُند خواهد بود و کارساز DHCP در مقیدسازی سوکت‌ها (در حالت چندنخی) با شکست مواجه خواهد شد. مدیران سیستم باید اطمینان حاصل کنند که شنونده‌های اختصاصی از پورت دیگری استفاده می‌کنند (8001 یک جایگزین پیشنهادی است)؛ در صورتی که پورت‌ها نادرست پیکربندی شوند یا از پورت‌های اختصاص‌یافته به سوکت کنترلی استفاده شود، گلوگاه‌های کارایی ناشی از حالت تک‌نخی کارساز DHCP یا ماهیت ترتیبی سوکت کنترلی کارسازهای DHCP، هرگونه بهبود کارایی حاصل از HA+MT را بی‌اثر خواهند کرد.
.UNINDENT
.UNINDENT.SS محدودیت بسته‌های پارک‌شده (Parked\-Packet Limit)
.sp
برای آشنایی مقدماتی با پارک کردن بسته‌ها، به «محدودیت بسته‌های پارک‌شده» مراجعه کنید.
.sp
کتابخانه قلاب HA از این سازوکار استفاده می‌کند. هنگامی که یک سرور HA
نیاز دارد یک به‌روزرسانی اجاره را برای همتایان خود ارسال کند تا آن‌ها را از تغییرات
اجاره مطلع سازد، پاسخ به کلاینت را تا زمانی که همتایان به‌روزرسانی اجاره را
تایید کنند، پارک می‌کند. در آن هنگام، سرور پاسخ را از حالت پارک خارج کرده و آن را
به کلاینت ارسال می‌کند. این موضوع برای پرس‌وجوهای کلاینت که منجر به تغییرات اجاره می‌شوند اعمال می‌گردد، مانند
DHCPREQUEST برای DHCPv4 و Request، Renew و Rebind برای DHCPv6. این سازوکار
شامل DHCPDISCOVER (در نسخه ۴) یا Solicit (در نسخه ۶) نمی‌شود.
.SS خاموش‌سازی کنترل‌شده و نگهداری سرورهای DHCP
.sp
داشتن یک جفت سرور ارائه‌دهنده دسترس‌پذیری بالا (High Availability) امکان
خاموش‌سازی کنترل‌شده و نگهداری آن سرورها را بدون اختلال در سرویس DHCP فراهم می‌کند.
برای مثال، مدیر سیستم می‌تواند یکی از سرورها را ارتقا دهد در حالی که
سرور دیگر همچنان به پرس‌وجوهای DHCP پاسخ می‌دهد. هنگامی که سرور اول
ارتقا یافت و دوباره برخط شد، می‌توان ارتقا را برای سرور دوم انجام داد.
.sp
مشکل متداولی که در نسخه‌های اولیه کتابخانه قلاب High Availability
گزارش شده بود این بود که مدیر سیستم کنترل مستقیمی بر وضعیت سرور
DHCP نداشت. خاموش کردن یکی از سرورها برای نگهداری لزوماً
باعث نمی‌شد که سرور دیگر شروع به پاسخ دادن به تمام پرس‌وجوهای DHCP کند؛
زیرا الگوریتم تشخیص خرابی توضیح‌داده‌شده در «انتقال حوزه در حالت از کار افتادن شریک»
نیازمند این است که شریک برای یک بازه زمانی پیکربندی‌شده پاسخ ندهد و
بسته به پیکربندی، ممکن است همچنین نیاز داشته باشد که به تعدادی از درخواست‌های DHCP
برای بازه زمانی مشخصی پاسخ داده نشود. با این حال، روند نگهداری
ایجاب می‌کند که مدیر سیستم بتواند به یکی از سرورها دستور دهد
که بلافاصله سرویس‌دهی به تمام کلاینت‌های DHCP را آغاز کند و سرور دیگر بلافاصله
سرویس‌دهی به کلاینت‌های DHCP را متوقف کند تا بتوان آن را با ایمنی خاموش کرد.
.sp
قابلیت نگهداری در کتابخانه قلاب High Availability به این
وضعیت رسیدگی می‌کند. دستور \fBha\-maintenance\-start\fP به
مدیر سیستم امکان می‌دهد جفت سرورهای فعال را در وضعیتی قرار دهد که در آن یکی از
آن‌ها به تمام پرس‌وجوهای DHCP پاسخ می‌دهد و دیگری منتظر خاموش شدن است.
.sp
فرض کنید راه‌اندازی HA شامل دو سرور فعال \fBserver1\fP و
\fBserver2\fP است و سرور دوم باید برای نگهداری خاموش شود.
مدیر سیستم می‌تواند دستور \fBha\-maintenance\-start\fP را به \fBserver1\fP ارسال کند،
زیرا این سروری است که قرار است ترافیک DHCP را در زمان آفلاین بودن دیگری
مدیریت کند. اگر وضعیت \fBserver1\fP یا وضعیت شریک آن
اجازه خاموش‌سازی برای نگهداری را ندهد، \fBserver1\fP با یک خطا پاسخ می‌دهد؛ برای مثال، اگر نگهداری
برای سرور پشتیبان پشتیبانی نشود یا سرور در وضعیت \fBterminated\fP
باشد. همچنین، اگر درخواست \fBha\-maintenance\-start\fP پیش‌تر
به سرور دیگر ارسال شده باشد، خطایی بازگردانده می‌شود.
.sp
با دریافت دستور \fBha\-maintenance\-start\fP، \fBserver1\fP دستور
\fBha\-maintenance\-notify\fP را به \fBserver2\fP ارسال می‌کند تا آن را در
وضعیت \fBin\-maintenance\fP قرار دهد. اگر \fBserver2\fP تایید کند، \fBserver1\fP به
وضعیت \fBpartner\-in\-maintenance\fP تغییر وضعیت می‌دهد. این شبیه به وضعیت \fBpartner\-down\fP
است، با این تفاوت که در وضعیت \fBpartner\-in\-maintenance\fP سرور \fBserver1\fP تا زمانی که مدیر سیستم
\fBserver2\fP را خاموش کند، به ارسال به‌روزرسانی‌های اجاره به \fBserver2\fP ادامه می‌دهد\&.
اکنون \fBserver1\fP به تمام پرس‌وجوهای DHCP پاسخ می‌دهد.
.sp
اکنون مدیر سیستم می‌تواند با ایمنی \fBserver2\fP را در وضعیت \fBin\-maintenance\fP
خاموش کرده و اقدامات لازم برای نگهداری را انجام دهد. در حالی که \fBserver2\fP
آفلاین است، بدیهی است که \fBserver1\fP قادر به برقراری ارتباط با شریک خود نخواهد بود،
بنابراین بلافاصله به وضعیت \fBpartner\-down\fP منتقل می‌شود؛ این سرور
همچنان به تمام پرس‌وجوهای DHCP پاسخ خواهد داد، اما دیگر به‌روزرسانی‌های اجاره را به
\fBserver2\fP ارسال نمی‌کند\&. راه‌اندازی مجدد \fBserver2\fP پس از نگهداری، مذاکره عادی
وضعیت، همگام‌سازی پایگاه‌داده اجاره‌ها و در نهایت گذار به
وضعیت عادی \fBload\-balancing\fP یا \fBhot\-standby\fP را آغاز می‌کند. سپس می‌توان
نگهداری را پس از ارسال دستور \fBha\-maintenance\-start\fP به \fBserver2\fP، روی \fBserver1\fP انجام داد\&.
.sp
اگر دستور \fBha\-maintenance\-start\fP به سرور ارسال شده باشد و سرور
به وضعیت \fBpartner\-in\-maintenance\fP رفته باشد، بازگرداندن هر دوی آن و شریکش به
وضعیت‌های قبلی‌شان به منظور از سرگیری عملکرد عادی جفت HA امکان‌پذیر است.
این کار با ارسال دستور \fBha\-maintenance\-cancel\fP به سروری که در
وضعیت \fBpartner\-in\-maintenance\fP قرار دارد انجام می‌شود. با این حال، اگر سرور در
نتیجه تشخیص آفلاین بودن شریک، قبلاً به وضعیت \fBpartner\-down\fP تغییر وضعیت داده باشد،
لغو نگهداری دیگر امکان‌پذیر نیست. در این حالت، لازم است سرور دیگر را دوباره
راه‌اندازی کرده و اجازه داد فرایند عادی مذاکره وضعیت خود را تکمیل کند.
.sp
اگر سرور رابطه‌های متعددی با شرکای مختلف داشته باشد، دستور \fBha\-maintenance\-start\fP
تلاش می‌کند تا تمام این رابطه‌ها را با ارسال \fBha\-maintenance\-notify\fP به همه
سرورهای شریک، به وضعیت \fBpartner\-in\-maintenance\fP انتقال دهد. اگر این مرحله برای هر یک از سرورها با شکست مواجه شود، خطایی بازگردانده می‌شود.
در صورت وقوع این رویداد، می‌توان از دستور \fBha\-maintenance\-cancel\fP برای از سرگیری عملکردهای عادی
و رفع مشکل استفاده کرد.
.SS دستورهای کنترلی برای دسترس‌پذیری بالا (High Availability)
.sp
اگرچه کتابخانه قلاب HA برای برطرف کردن خودکار مشکلات مربوط به
قطعی سرویس DHCP از طریق هدایت مجدد ترافیک DHCP به سرور فعال باقی‌مانده
و همگام‌سازی پایگاه‌داده اجاره‌ها در صورت نیاز طراحی شده است، ممکن است برای
مدیر سیستم کنترل بیشتر بر رفتار هر دو سرور مفید باشد. به‌ویژه،
ممکن است راه‌اندازی همگام‌سازی پایگاه‌داده اجاره‌ها بر حسب تقاضا،
یا تنظیم دستی حوزه‌های در حال سرویس‌دهی HA سودمند باشد.
.sp
در صورتی که هر دو سرور فعال از کار بیفتند، گاهی اوقات می‌توان از سرور پشتیبان برای رسیدگی به ترافیک DHCP استفاده کرد. سرور پشتیبان عمل جایگزینی خودکار (failover)
را انجام نمی‌دهد؛ بنابراین، برای استفاده از سرور پشتیبان جهت پاسخ‌گویی به
پرس‌وجوهای DHCP، مدیر سرور باید این تابع را به صورت دستی فعال کند.
.sp
بخش‌های زیر دستورهای پشتیبانی‌شده توسط کتابخانه قلاب HA را که
در دسترس مدیر سیستم هستند، شرح می‌دهند.
.SS دستور \fBha\-sync\fP
.sp
دستور \fBha\-sync\fP به سرور فرمان می‌دهد که پایگاه‌داده محلی
اجاره‌های خود را با همتای انتخابی همگام کند. سرور تمام اجاره‌ها را از همتا واکشی کرده و
هرگونه اجاره محلی ذخیره‌شده را که قدیمی‌تر از موارد واکشی‌شده باشد، به‌روزرسانی می‌کند. همچنین
در صورتی که هر یک از موارد واکشی‌شده در پایگاه‌داده محلی وجود نداشته باشد، اجاره‌های جدید ایجاد می‌کند.
تمام اجاره‌هایی که توسط همتا بازگردانده نشده‌اند اما در پایگاه‌داده محلی موجود هستند،
حفظ می‌شوند. همگام‌سازی پایگاه‌داده یک‌طرفه است؛ تنها پایگاه‌داده روی
سروری که دستور به آن ارسال شده است به‌روزرسانی می‌شود. برای همگام‌سازی
پایگاه‌داده همتا، باید یک دستور \fBha\-sync\fP جداگانه به آن همتا فرستاده شود.
.sp
همگام‌سازی پایگاه‌داده ممکن است برای هر دو نوع سرور فعال و پشتیبان
اجرا شود. دستور \fBha\-sync\fP دارای ساختار زیر است (در یک مثال برای DHCPv4):
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqha\-sync\(dq,
    \(dqservice\(dq: [ \(dqdhcp4 \(dq],
    \(dqarguments\(dq: {
        \(dqserver\-name\(dq: \(dqserver2\(dq,
        \(dqmax\-period\(dq: 60
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
هنگامی که سرور این دستور را دریافت می‌کند، ابتدا سرویس DHCP سروری را که
قرار است اجاره‌ها از آن واکشی شوند، با ارسال دستور \fBdhcp\-disable\fP \%<#\:std-isccmd-dhcp-disable>
به آن سرور، غیرفعال می‌سازد. پارامتر \fBmax\-period\fP حداکثر
مدت زمانی را (به ثانیه) مشخص می‌کند که سرویس DHCP باید غیرفعال باشد. اگر سرویس
DHCP با موفقیت غیرفعال شود، سرور همگام‌کننده با صدور یک یا چند دستور \fBlease4\-get\-page\fP
اجاره‌ها را از سرور دوردست واکشی می‌کند. هنگامی که همگام‌سازی پایگاه‌داده اجاره‌ها
کامل شد، سرور همگام‌کننده دستور
\fBdhcp\-enable\fP \%<#\:std-isccmd-dhcp-enable> را به همتا ارسال می‌کند تا سرویس DHCP آن را دوباره فعال کند.
.sp
مقدار \fBmax\-period\fP باید به اندازه کافی طولانی باشد تا تضمین شود که پیش از
تکمیل همگام‌سازی به پایان نمی‌رسد. در غیر این صورت، سرور DHCP
در حالی که همگام‌سازی هنوز در جریان است، عملکرد DHCP خود را به طور خودکار فعال
خواهد کرد. اگر سرور DHCP متعاقباً در طول همگام‌سازی هرگونه اجاره‌ای را تخصیص دهد،
آن اجاره‌های جدید (یا به‌روزرسانی‌شده) توسط سرور همگام‌کننده واکشی نخواهند شد
که این امر منجر به ناسازگاری پایگاه‌داده می‌شود..SS دستور \fBha\-scopes\fP
.sp
این دستور به مدیر سیستم اجازه می‌دهد حوزه‌های (scopes) HA در حال سرویس‌دهی را تغییر دهد.
این دستور هنگام بازیابی از خرابی یا هنگام انجام عملیات نگهداری می‌تواند مفید باشد.
برای آگاهی از این که کدام حوزه‌ها برای حالت‌های عملیاتی مختلف HA در دسترس هستند، به Load\-Balancing Configuration و Hot\-Standby Configuration مراجعه کنید.
.sp
\fBهشدار:\fP
.INDENT 0.0
.INDENT 3.5
دستور \fBha\-scopes\fP می‌تواند سرورهای Kea را در وضعیت‌های متناقضی قرار دهد که ممکن است منجر به رفتارهای غیرمنتظره شود. تغییر حوزه‌ها وضعیت سرور یا رابطه آن با شریک (partner) را به طور خودکار تغییر نمی‌دهد.
.sp
به عنوان مثال، هنگامی که حوزه‌های اصلی (primary) را به سرور آماده‌به‌خدمت (standby) اضافه می‌کنیم، شروع به پاسخ‌گویی به ترافیک DHCP برای آن حوزه‌ها خواهد کرد. این موضوع می‌تواند به وضعیتی بیانجامد که در آن هر دو سرور به ترافیک یکسانی پاسخ می‌دهند که ممکن است باعث تداخل آدرس‌های IP شود.
.UNINDENT
.UNINDENT
.sp
دستور \fBha\-scopes\fP ساختار زیر را دارد؛ با استفاده از یک مثال در DHCPv4:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqha\-scopes\(dq,
    \(dqservice\(dq: [ \(dqdhcp4\(dq ],
    \(dqarguments\(dq: {
        \(dqscopes\(dq: [ \(dqHA_server1\(dq, \(dqHA_server2\(dq ],
        \(dqserver\-name\(dq: \(dqserver2\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور سرور را برای رسیدگی به ترافیک حاصل از هر دو حوزه \(dqHA_server1\(dq و \(dqHA_server2\(dq پیکربندی می‌کند. برای غیرفعال کردن تمامی حوزه‌ها، یک فهرست خالی مشخص کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqha\-scopes\(dq,
    \(dqservice\(dq: [ \(dqdhcp4 \(dq],
    \(dqarguments\(dq: {
        \(dqscopes\(dq: [ ],
        \(dqserver\-name\(dq: \(dqserver2\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پارامتر اختیاری \fBserver\-name\fP نام یکی از شرکا را در رابطه HA که این دستور مربوط به آن است، مشخص می‌کند. اگر سرور دریافت‌کننده این دستور تنها یک رابطه HA در پیکربندی خود داشته باشد، می‌توان از این پارامتر صرف‌نظر کرد.
.SS دستور \fBha\-continue\fP
.sp
این دستور برای ازسرگیری عملکرد ماشین وضعیت متوقف‌شده HA استفاده می‌شود، همان‌طور که در Pausing the HA State Machine شرح داده شده است. این دستور هیچ آرگومانی نمی‌پذیرد، بنابراین ساختار دستور به سادگی به شکل زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqha\-continue\(dq,
    \(dqservice\(dq: [ \(dqdhcp4\(dq ],
    \(dqarguments\(dq: {
        \(dqscopes\(dq: [ ],
        \(dqserver\-name\(dq: \(dqserver2\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پارامتر اختیاری \fBserver\-name\fP نام یکی از شرکا را در رابطه HA که این دستور مربوط به آن است، مشخص می‌کند. اگر سرور دریافت‌کننده این دستور تنها یک رابطه HA در پیکربندی خود داشته باشد، می‌توان از این پارامتر صرف‌نظر کرد.
.SS دستور \fBha\-heartbeat\fP
.sp
بخش Server States توصیف می‌کند که چگونه دستور \fBha\-heartbeat\fP توسط یک جفت سرور فعال HA برای تشخیص خرابی یکی از شرکا استفاده می‌شود. با این حال، این دستور می‌تواند توسط مدیر سیستم نیز به یک یا هر دو سرور فرستاده شود تا وضعیت HA آن‌ها بررسی شود. این قابلیت امکان استقرار یک سامانه مانیتورینگ را بر روی سرورهای دارای قابلیت HA فراهم می‌سازد تا به صورت دوره‌ای بررسی کند که آیا آن‌ها فعال هستند یا نیاز به دخالت دستی وجود دارد. دستور \fBha\-heartbeat\fP هیچ آرگومانی نمی‌پذیرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqha\-heartbeat\(dq,
    \(dqservice\(dq: [ \(dqdhcp4\(dq ],
    \(dqarguments\(dq: {
        \(dqscopes\(dq: [ ],
        \(dqserver\-name\(dq: \(dqserver2\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پارامتر اختیاری \fBserver\-name\fP نام یکی از شرکا را در رابطه HA که این دستور مربوط به آن است، مشخص می‌کند. اگر سرور دریافت‌کننده این دستور تنها یک رابطه HA در پیکربندی خود داشته باشد، می‌توان از این پارامتر صرف‌نظر کرد.
.sp
پس از برقراری ارتباط موفق با سرور، پاسخی مشابه زیر باید بازگردانده شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
   \(dqresult\(dq: 0,
   \(dqtext\(dq: \(dqHA peer status returned.\(dq,
   \(dqarguments\(dq:
       {
           \(dqstate\(dq: \(dqpartner\-down\(dq,
           \(dqdate\-time\(dq: \(dqThu, 07 Nov 2019 08:49:37 GMT\(dq,
           \(dqscopes\(dq: [ \(dqserver1\(dq ],
           \(dqunsent\-update\-count\(dq: 123
       }
}
.EE
.UNINDENT
.UNINDENT
.sp
مقدار بازگردانده شده \fBstate\fP باید یکی از مقادیر فهرست‌شده در Server States باشد. در مثال بالا، وضعیت \fBpartner\-down\fP بازگردانده شده است که نشان می‌دهد سروری که به دستور پاسخ داده معتقد است شریک آن آفلاین است؛ بنابراین، به تمامی درخواست‌های DHCP فرستاده شده به سرورها پاسخ می‌دهد. برای اطمینان از اینکه شریک واقعاً آفلاین است، مدیر سیستم باید دستور \fBha\-heartbeat\fP را به سرور دوم بفرستد. اگر ارسال دستور ناموفق باشد، به عنوان مثال به دلیل ناتوانی در برقراری اتصال TCP به سرور DHCP، به احتمال بسیار زیاد سرور در حال اجرا نیست.
.sp
پارامتر \fBdate\-time\fP درک سرور از زمان را منتقل می‌کند.
.sp
مقدار \fBunsent\-update\-count\fP تعداد تجمعی تمام به‌روزرسانی‌های ارسال‌نشده اجاره (lease) از زمان بوت شدن سرور است؛ مقدار آن هنگام راه‌اندازی سرور روی 0 تنظیم می‌شود. این مقدار در طول کارکرد سرور هرگز به 0 بازنشانی نمی‌شود، حتی پس از آنکه شریک پایگاه داده را همگام‌سازی کند. این مقدار توسط شریکی که پاسخ ضربان قلب (heartbeat) را ارسال می‌کند، در صورتی که نتواند به‌روزرسانی اجاره را ارسال کند، افزایش می‌یابد. به عنوان مثال، فرض کنید خرابی در نتیجه یک قطعی موقت در ارتباط باشد. در آن صورت، شریکی که پاسخ ضربان قلب \fBpartner\-down\fP را دریافت می‌کند تغییرات مقدار را ردیابی کرده و می‌تواند پس از برقراری مجدد ارتباط تعیین کند که آیا به‌روزرسانی‌های اجاره جدیدی وجود دارد که دریافت نکرده باشد یا خیر. اگر مقادیر در هر دو سرور مطابقت نداشته باشند، نشانه‌ای است از این که شریک باید پایگاه داده اجاره‌های خود را همگام‌سازی کند. مقدار غیر صفر به خودی خود نشان‌دهنده مشکلی در حال حاضر با به‌روزرسانی‌های اجاره نیست، اما مقداری که مدام در حال افزایش باشد چنین است.
.sp
پاسخ معمول بازگردانده شده توسط یک سرور زمانی که هر دو سرور عملیاتی هستند، به این صورت است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
   \(dqresult\(dq: 0,
   \(dqtext\(dq: \(dqHA peer status returned.\(dq,
   \(dqarguments\(dq:
       {
           \(dqstate\(dq: \(dqload\-balancing\(dq,
           \(dqdate\-time\(dq: \(dqThu, 07 Nov 2019 08:49:37 GMT\(dq,
           \(dqscopes\(dq: [ \(dqserver1\(dq ],
           \(dqunsent\-update\-count\(dq: 0
       }
}
.EE
.UNINDENT
.UNINDENT
.sp
در بیشتر موارد، دستور \fBha\-heartbeat\fP باید به هر دو سرور دارای قابلیت HA ارسال شود تا وضعیت کل پیکربندی HA بررسی شود. به ویژه، اگر یکی از سرورها نشان دهد که در وضعیت \fBload\-balancing\fP قرار دارد، به این معنی است که این سرور طوری عمل می‌کند که گویی شریک آن سالم است و کار می‌کند. وقتی یک شریک از کار می‌افتد، مدتی طول می‌کشد تا سرور بازمانده متوجه آن شود. بخش Scope Transition in a Partner\-Down Case الگوریتمی را که سرور بازمانده قبل از انتقال به وضعیت \fBpartner\-down\fP دنبال می‌کند، شرح می‌دهد. اگر دستور \fBha\-heartbeat\fP در بازه زمانی بین از کار افتادن یکی از سرورها و انتقال سرور بازمانده به وضعیت \fBpartner\-down\fP ارسال شود، پاسخ دریافتی از سرور بازمانده این خرابی را بازتاب نمی‌دهد. ارسال مجدد دستور پس از اینکه سرور بازمانده وارد وضعیت \fBpartner\-down\fP شد، خرابی را تشخیص خواهد داد..SS دستور \fBstatus\-get\fP
.sp
دستور \fBstatus\-get\fP \%<#\:std-isccmd-status-get> یک دستور عمومی است که علاوه بر کارسازهای DHCP، توسط چندین دیمن Kea نیز پشتیبانی می‌شود. با این حال، هنگام ارسال به یک کارساز DHCP با HA فعال، می‌توان از آن برای آگاهی از جزئیات وضعیت کارساز مختص HA استفاده کرد. پاسخ نه تنها حاوی اطلاعات وضعیت کارساز دریافت‌کنندهٔ این دستور است، بلکه در صورت در دسترس بودن، شامل اطلاعات مربوط به شریک (partner) آن نیز می‌شود.
.sp
در ادامه یک نمونه پاسخ به دستور \fBstatus\-get\fP \%<#\:std-isccmd-status-get>، شامل وضعیت HA دو کارساز \fBload\-balancing\fP آورده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq\(dq,
    \(dqarguments\(dq: {
        \(dqpid\(dq: 1234,
        \(dquptime\(dq: 3024,
        \(dqreload\(dq: 1111,
        \(dqhigh\-availability\(dq: [
            {
                \(dqha\-mode\(dq: \(dqload\-balancing\(dq,
                \(dqha\-servers\(dq: {
                    \(dqlocal\(dq: {
                        \(dqrole\(dq: \(dqprimary\(dq,
                        \(dqscopes\(dq: [ \(dqserver1\(dq ],
                        \(dqserver\-name\(dq: \(dqserver1\(dq,
                        \(dqstate\(dq: \(dqload\-balancing\(dq,
                        \(dqsystem\-time\(dq: \(dq2024\-01\-01 12:00:00\(dq
                    },
                    \(dqremote\(dq: {
                        \(dqage\(dq: 10,
                        \(dqanalyzed\-packets\(dq: 8,
                        \(dqclock\-skew\(dq: 0,
                        \(dqcommunication\-interrupted\(dq: true,
                        \(dqconnecting\-clients\(dq: 2,
                        \(dqin\-touch\(dq: true,
                        \(dqlast\-scopes\(dq: [ \(dqserver2\(dq ],
                        \(dqlast\-state\(dq: \(dqload\-balancing\(dq,
                        \(dqrole\(dq: \(dqsecondary\(dq,
                        \(dqserver\-name\(dq: \(dqserver2\(dq,
                        \(dqsystem\-time\(dq: \(dq2024\-01\-01 12:00:00\(dq,
                        \(dqunacked\-clients\(dq: 1,
                        \(dqunacked\-clients\-left\(dq: 2
                    }
                }
            }
        ],
        \(dqmulti\-threading\-enabled\(dq: true,
        \(dqthread\-pool\-size\(dq: 4,
        \(dqpacket\-queue\-size\(dq: 64,
        \(dqpacket\-queue\-statistics\(dq: [ 0.2, 0.1, 0.1 ],
        \(dqsockets\(dq: {
            \(dqstatus\(dq: \(dqready\(dq
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
آرگومان \fBhigh\-availability\fP فهرستی است که در حال حاضر تنها از یک عنصر تشکیل شده است.
.sp
نگاشت \fBha\-servers\fP شامل دو ساختار است: \fBlocal\fP و \fBremote\fP\&. اولی حاوی اطلاعات وضعیت کارسازی است که دستور را دریافت کرده است، در حالی که دومی دربردارندهٔ اطلاعات وضعیتی است که کارساز محلی از شریک خود دارد. مقدار \fBrole\fP برای کارساز شریک از فایل پیکربندی محلی جمع‌آوری می‌شود، بنابراین همواره باید در دسترس باشد. سایر اطلاعات وضعیت، مانند \fBlast\-scopes\fP و \fBlast\-state\fP، تا زمانی که کارساز محلی با ارسال موفقیت‌آمیز دستور \fBha\-heartbeat\fP با کارساز دوردست ارتباط برقرار نکند در دسترس نخواهند بود. اگر حداقل یک ارتباط از این دست انجام شده باشد، مقدار بازگشتی پارامتر \fBin\-touch\fP برابر با \fBtrue\fP قرار می‌گیرد. با بررسی این مقدار، فرستندهٔ دستور می‌تواند مشخص کند که آیا اطلاعات مربوط به کارساز دوردست قابل اعتماد است یا خیر.
.sp
پارامترهای \fBlast\-scopes\fP و \fBlast\-state\fP حاوی اطلاعاتی دربارهٔ حوزه‌های HA ارائه‌شده توسط شریک و وضعیت آن هستند. این اطلاعات هنگام تبادل دستور \fBha\-heartbeat\fP جمع‌آوری می‌شوند، بنابراین اگر مشکلی در ارتباط میان شرکا رخ دهد و این اطلاعات وضعیت تازه‌سازی نشوند، ممکن است دقیق نباشند. در چنین حالتی، ممکن است ارسال مستقیم دستور \fBstatus\-get\fP \%<#\:std-isccmd-status-get> به کارساز شریک برای بررسی وضعیت فعلی آن سودمند باشد. پارامتر \fBage\fP، سن اطلاعات دریافتی از شریک را بر حسب ثانیه مشخص می‌کند.
.sp
مقدار بولی \fBcommunication\-interrupted\fP مشخص می‌کند که آیا کارساز دریافت‌کنندهٔ دستور \fBstatus\-get\fP \%<#\:std-isccmd-status-get> (کارساز محلی) برای مدتی طولانی‌تر از زمان مشخص‌شده در \fBmax\-response\-delay\fP از برقراری ارتباط با شریک ناتوان بوده است یا خیر. در چنین شرایطی، کارسازهای فعال در وضعیت \fBcommunication\-interrupted\fP در نظر گرفته می‌شوند. در این نقطه، کارساز محلی ممکن است پایش ترافیک DHCP هدایت‌شده به سمت شریک را آغاز کند تا ببیند آیا شریک به این ترافیک پاسخ می‌دهد یا خیر. اطلاعات بیشتر دربارهٔ روال failover را می‌توان در پیکربندی Load\-Balancing یافت.
.sp
پارامتر \fBsystem\-time\fP زمان UTC را در لحظه‌ای که انحراف زمان میان گره محلی و شریک آخرین بار محاسبه شده است، نگه می‌دارد. این مقدار در قالب \fB%Y\-%m\-%d %H:%M:%S\fP به ترتیب برای هر گره فعال، یعنی محلی و دوردست، نمایش داده می‌شود. پارامتر \fBclock\-skew\fP در نگاشت \fBremote\fP در دسترس است و اختلاف این دو زمان را بر حسب ثانیه نگه می‌دارد. زمان محلی از زمان شریک کسر می‌شود. یک مقدار مثبت به این معنی است که ساعت شریک جلوتر است، در حالی که مقدار منفی نشان می‌دهد که شریک عقب‌تر است. اگر انحراف ساعت هنوز محاسبه نشده باشد، هر دو پارامتر \fBsystem\-time\fP و \fBclock\-skew\fP می‌توانند null باشند.
.sp
پارامترهای \fBconnecting\-clients\fP، \fBunacked\-clients\fP، \fBunacked\-clients\-left\fP و \fBanalyzed\-packets\fP همراه با پارامتر \fBcommunication\-interrupted\fP معرفی شده‌اند و اطلاعات مفیدی دربارهٔ وضعیت پایش ترافیک DHCP در حالت \fBcommunication\-interrupted\fP ارائه می‌دهند. به محض خروج کارساز از حالت \fBcommunication\-interrupted\fP، تمامی این پارامترها به 0 بازنشانی می‌شوند.
.sp
این پارامترها در حالت \fBcommunication\-interrupted\fP دارای معانی زیر هستند:
.INDENT 0.0
.IP \(bu 2
\fBconnecting\-clients\fP \- این تعداد کلاینت‌های متفاوتی است که برای دریافت اجاره (lease) از کارساز دوردست تلاش کرده‌اند. این کلاینت‌ها با نشانی MAC و شناسهٔ کلاینت (در DHCPv4) یا DUID (در DHCPv6) متمایز می‌شوند. این تعداد شامل کلاینت‌های \(dqunacked\(dq (که مقدار فیلد \(dqsecs\(dq یا زمان سپری‌شده \(dqelapsed time\(dq برای آن‌ها از \fBmax\-response\-delay\fP فراتر رفته است) نیز می‌شود.
.IP \(bu 2
\fBunacked\-clients\fP \- این تعداد کلاینت‌های متفاوتی است که \(dqunacked\(dq در نظر گرفته شده‌اند؛ یعنی کلاینت‌هایی که تلاششان برای دریافت اجاره بیشتر از مقدار فیلد \(dqsecs\(dq طول کشیده است، یا زمان سپری‌شده \(dqelapsed time\(dq برای آن‌ها از مقدار \fBmax\-response\-delay\fP فراتر رفته است.
.IP \(bu 2
\fBunacked\-clients\-left\fP \- این مشخص‌کنندهٔ تعداد کلاینت‌های دیگری است که قبل از ورود کارساز به وضعیت \fBpartner\-down\fP باید \(dqunacked\(dq تلقی شوند. با افزایش مقدار \fBunacked\-clients\fP، این مقدار کاهش می‌یابد. زمانی که این مقدار به 0 برسد، کارساز محلی وارد وضعیت \fBpartner\-down\fP می‌شود.
.IP \(bu 2
\fBanalyzed\-packets\fP \- این تعداد کل بسته‌های هدایت‌شده به کارساز شریک است که از زمان ورود به وضعیت قطع ارتباط، توسط کارساز محلی تحلیل شده‌اند. این عدد شامل ارسال‌های مجدد از سوی همان کلاینت‌ها نیز می‌باشد.
.UNINDENT
.sp
پایش این مقادیر به پیش‌بینی زمان ورود کارساز محلی به حالت \fBpartner\-down\fP یا درک چرایی عدم ورود کارساز به این حالت کمک می‌کند.
.sp
پارامتر \fBha\-mode\fP حالت عملیاتی HA را که با استفاده از پارامتر \fBmode\fP در فایل پیکربندی انتخاب شده است، برمی‌گرداند. این پارامتر می‌تواند یکی از مقادیر زیر را داشته باشد: \fBload\-balancing\fP، \fBhot\-standby\fP، یا \fBpassive\-backup\fP\&.
.sp
پاسخ \fBstatus\-get\fP \%<#\:std-isccmd-status-get> تنها در حالت‌های \fBload\-balancing\fP و \fBhot\-standby\fP قالبی به صورت شرح‌داده‌شده در بالا دارد. در حالت \fBpassive\-backup\fP، نگاشت \fBremote\fP در پاسخ گنجانده نمی‌شود، زیرا در این حالت تنها یک کارساز فعال (محلی) وجود دارد. پاسخ شامل هیچ اطلاعاتی دربارهٔ وضعیت کارسازهای پشتیبان نیست..SS دستور \fBha\-maintenance\-start\fP
.sp
این دستور انتقال شرکای سرور به وضعیت \fBin\-maintenance\fP و انتقال سرورِ دریافت‌کنندهٔ دستور به وضعیت \fBpartner\-in\-maintenance\fP را در هر رابطهٔ HA آغاز می‌کند. برای جزئیات بیشتر به بخش «خاموشی کنترل‌شده و نگهداری سرورهای DHCP» (Controlled Shutdown and Maintenance of DHCP Servers) مراجعه کنید.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqha\-maintenance\-start\(dq,
    \(dqservice\(dq: [ \(dqdhcp4\(dq ]
}
.EE
.UNINDENT
.UNINDENT
.SS دستور \fBha\-maintenance\-cancel\fP
.sp
این دستور برای لغو فرآیند نگهداری‌ای که پیش‌تر با استفاده از دستور \fBha\-maintenance\-start\fP آغاز شده بود، استفاده می‌شود. سرور دریافت‌کنندهٔ این دستور ابتدا دستور \fBha\-maintenance\-notify\fP را در حالی که پرچم \fBcancel\fP روی \fBtrue\fP تنظیم شده است، به شرکای خود ارسال می‌کند. سپس سرور از وضعیت \fBpartner\-in\-maintenance\fP به وضعیت پیشین خود بازمی‌گردد. برای جزئیات به بخش «خاموشی کنترل‌شده و نگهداری سرورهای DHCP» (Controlled Shutdown and Maintenance of DHCP Servers) مراجعه کنید.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqha\-maintenance\-cancel\(dq,
    \(dqservice\(dq: [ \(dqdhcp4\(dq ]
}
.EE
.UNINDENT
.UNINDENT
.SS دستور \fBha\-maintenance\-notify\fP
.sp
این دستور توسط سروری که دستور \fBha\-maintenance\-start\fP یا \fBha\-maintenance\-cancel\fP را دریافت کرده است به شریک خود فرستاده می‌شود، تا موجب انتقال شریک به وضعیت \fBin\-maintenance\fP یا بازگشت آن از این وضعیت به وضعیت پیشین شود. برای جزئیات به بخش «خاموشی کنترل‌شده و نگهداری سرورهای DHCP» (Controlled Shutdown and Maintenance of DHCP Servers) مراجعه کنید.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqha\-maintenance\-notify\(dq,
    \(dqservice\(dq: [ \(dqdhcp4\(dq ],
    \(dqarguments\(dq: {
        \(dqcancel\(dq: false,
        \(dqstate\(dq: \(dqready\(dq,
        \(dqserver\-name\(dq: \(dqserver2\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
آرگومان \fBstate\fP گیرنده را از وضعیت سرور فرستنده مطلع می‌سازد. گیرنده می‌تواند فوراً عملکرد ماشین وضعیت را بدون نیاز به ارسال یک ضربان قلب (heartbeat) جهت بررسی وضعیت شریک، از سر بگیرد.
.sp
پارامتر اختیاری \fBserver\-name\fP نام یکی از شرکا را در رابطهٔ HA که این دستور مربوط به آن است، مشخص می‌کند. اگر سرور دریافت‌کنندهٔ این دستور فقط یک رابطهٔ HA در پیکربندی خود داشته باشد، می‌توان از این پارامتر صرف‌نظر کرد.
.sp
\fBهشدار:\fP
.INDENT 0.0
.INDENT 3.5
دستور \fBha\-maintenance\-notify\fP برای استفاده توسط مدیران سیستم در نظر گرفته نشده است. این دستور برای ارتباطات داخلی بین یک جفت سرور DHCP فعال‌شده با قابلیت HA استفاده می‌شود. استفادهٔ مستقیم از این دستور پشتیبانی نمی‌شود و ممکن است عواقب ناخواسته‌ای ایجاد کند.
.UNINDENT
.UNINDENT
.SS دستور \fBha\-reset\fP
.sp
این دستور موجب می‌شود سرور ماشین وضعیت دسترس‌پذیری بالا (High Availability) خود را با انتقال به وضعیت \fBwaiting\fP بازنشانی کند. یک شریک در وضعیت \fBcommunication\-recovery\fP ممکن است این دستور را ارسال کند تا سرور پایگاه دادهٔ اجاره‌های (lease database) خود را همگام‌سازی کند. همگام‌سازی پایگاه داده زمانی لازم است که شریک، پس از برقراری مجدد ارتباط متعاقب یک قطعی موقت، نتواند تمام به‌روزرسانی‌های پایگاه دادهٔ اجاره را ارسال نماید. همچنین زمانی که سرور در وضعیت \fBcommunication\-recovery\fP قرار دارد و مقدار \fBdelayed\-updates\-limit\fP فراتر رود، انجام این کار الزامی است.
.sp
یک مدیر سرور ممکن است این دستور را برای بازنشانی یک ماشین وضعیت که رفتار نادرستی دارد ارسال نماید.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqha\-reset\(dq,
    \(dqservice\(dq: [ \(dqdhcp4\(dq ],
    \(dqarguments\(dq: {
        \(dqserver\-name\(dq: \(dqserver2\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پارامتر اختیاری \fBserver\-name\fP نام یکی از شرکا را در رابطهٔ HA که این دستور مربوط به آن است، مشخص می‌کند. اگر سرور دریافت‌کنندهٔ این دستور تنها یک رابطهٔ HA در پیکربندی خود داشته باشد، می‌توان این پارامتر را نادیده گرفت.
.sp
این دستور پاسخ زیر را ایجاد می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqHA state machine reset.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر سرور دریافت‌کنندهٔ این دستور از قبل در وضعیت \fBwaiting\fP باشد، دستور هیچ اثری نخواهد داشت..SS دستور \fBha\-sync\-complete\-notify\fP
.sp
یک کارگزار این دستور را برای همتای خود ارسال می‌کند تا اعلام کند که همگام‌سازی پایگاه‌داده اجاره‌ها (lease\-database) را به پایان رسانده است. همتا در صورتی که بتواند در وضعیت فعلی خود اجاره‌های جدیدی تخصیص دهد، ممکن است سرویس DHCP خود را فعال کند. همتا در وضعیت \fBpartner\-down\fP تا زمانی که یک آزمون موفقیت‌آمیز \fBha\-heartbeat\fP به کارگزار همتای خود ارسال نکند، سرویس DHCP را فعال نمی‌کند. اگر اتصال همچنان در دسترس نباشد، کارگزار در وضعیت \fBpartner\-down\fP سرویس DHCP خود را فعال می‌کند تا به پاسخ‌دهی به کلاینت‌ها ادامه دهد.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqha\-sync\-complete\-notify\(dq,
    \(dqservice\(dq: [ \(dqdhcp4\(dq ],
    \(dqarguments\(dq: {
        \(dqorigin\-id\(dq: 2000,
        \(dqserver\-name\(dq: \(dqserver2\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پارامتر اختیاری \fBserver\-name\fP نام یکی از همتاها را در رابطه HA که این دستور به آن مربوط می‌شود مشخص می‌کند. اگر کارگزار دریافت‌کننده این دستور تنها یک رابطه HA در پیکربندی خود داشته باشد، می‌توان این پارامتر را نادیده گرفت.
.sp
پارامتر \fBorigin\-id\fP برای انتخاب سرویس HA استفاده می‌شود که کارگزار دریافت‌کننده هنگام دریافت این اعلان، باید سرویس DHCP را برای آن فعال کند. این همان مبدأیی است که کارگزار فرستنده پیش‌تر برای غیرفعال کردن سرویس DHCP پیش از همگام‌سازی استفاده کرده بود. پارامتر \fBorigin\-id\fP جایگزین پارامتر منسوخ‌شده \fBorigin\fP است که در برخی از نسخه‌های پیشین Kea استفاده می‌شد.
.sp
این دستور پاسخ زیر را به همراه دارد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqServer successfully notified about the synchronization completion.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
\fBهشدار:\fP
.INDENT 0.0
.INDENT 3.5
دستور \fBha\-sync\-complete\-notify\fP برای استفاده توسط مدیران سیستم در نظر گرفته نشده است. این دستور برای ارتباط داخلی میان یک جفت کارگزار DHCP با قابلیت HA استفاده می‌شود. استفاده مستقیم از این دستور پشتیبانی نمی‌شود و ممکن است پیامدهای ناخواسته‌ای به همراه داشته باشد.
.UNINDENT
.UNINDENT
.SS پیکربندی هاب و اسپوک (Hub and Spoke)
.sp
یک چیدمان هاب و اسپوک (hub\-and\-spoke)، با یک کارگزار مرکزی و چندین کارگزار شعبه، روشی متداول برای اطمینان از تاب‌آوری کارگزارهای DHCP است. کارگزارهای شعبه، کارگزارهای اصلی در حالت \fBhot\-standby\fP هستند و به ترافیک محلی DHCP در مکان‌های مربوط به خود پاسخ می‌دهند. کارگزار مرکزی به عنوان یک کارگزار آماده‌به‌خدمت (standby) برای هر کارگزار شعبه عمل می‌کند. این کارگزار ماشین‌های وضعیت مستقلی را با کارگزارهای شعبه نگه می‌دارد که روابط (relationships) نامیده می‌شوند. اگر یکی از کارگزارهای شعبه دچار خرابی شود، کارگزار مرکزی می‌تواند ترافیک DHCP آن را به عهده بگیرد. در این حالت، یکی از روابط کارگزار مرکزی در وضعیت \fBpartner\-down\fP قرار می‌گیرد. سایر روابط ممکن است همچنان در وضعیت \fBhot\-standby\fP باقی بمانند و به طور فعال به ترافیک DHCP پاسخ ندهند. هنگامی که کارگزار شعبه دوباره فعال می‌شود، پایگاه‌داده اجاره را با کارگزار مرکزی همگام‌سازی می‌کند و کارگزار مرکزی دوباره کاملاً غیرفعال (passive) می‌شود. در موارد نادر، اگر چندین کارگزار شعبه متوقف شوند، کارگزار مرکزی مسئولیت تمام ترافیک آن‌ها را به عهده می‌گیرد و در صورتی که همه کارگزارهای شعبه از کار بیفتند، بالقوه کل ترافیک DHCP در کل شبکه را مدیریت خواهد کرد. یک ساختار ساده هاب و اسپوک متشکل از دو کارگزار شعبه و یک کارگزار مرکزی در زیر نشان داده شده است.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
                            +\-\-\-\-\- Central Server \-\-\-\-\-\-+
                            |                           |
+\-\-\-\-\-\-\-\-\-\-+ relationship 1 |  +\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-+  | relationship 2 +\-\-\-\-\-\-\-\-\-\-+
| Server 1 |===================| Server 2 | Server 4 |===================| Server 3 |
+\-\-\-\-\-\-\-\-\-\-+                |  +\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-+  |                +\-\-\-\-\-\-\-\-\-\-+
                            |                           |
                            +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
.EE
.UNINDENT
.UNINDENT
.sp
پیکربندی هر کارگزار شعبه شامل مجموعه‌ای از زیرشبکه‌های مناسب برای آن کارگزار شعبه است؛ کارگزارهای شعبه مختلف به زیرشبکه‌های متفاوتی سرویس می‌دهند. پیکربندی کارگزار مرکزی شامل تمام زیرشبکه‌های کارگزارهای شعبه است، به طوری که بتواند به ترافیک DHCP هدایت‌شده به هر کارگزار شعبه‌ای که دچار خرابی شده است پاسخ دهد. زیرشبکه‌ها در کارگزار مرکزی باید مانند قطعه‌کد زیر در قالب روابط گروه‌بندی شوند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqDhcp6\(dq: {
        \(dqinterfaces\-config\(dq: {
            \(dqinterfaces\(dq: [ \(dqenp0s8\(dq, \(dqenp0s9\(dq ]
        },
        \(dqhooks\-libraries\(dq: [
            {
                \(dqlibrary\(dq: \(dqlibdhcp_lease_cmds.so\(dq,
                \(dqparameters\(dq: {}
            },
            {
                \(dqlibrary\(dq: \(dqlibdhcp_ha.so\(dq,
                \(dqparameters\(dq: {
                    \(dqhigh\-availability\(dq: [
                        {
                            \(dqthis\-server\-name\(dq: \(dqserver2\(dq,
                            \(dqmode\(dq: \(dqhot\-standby\(dq,
                            \(dqmulti\-threading\(dq: {
                                \(dqenable\-multi\-threading\(dq: true,
                                \(dqhttp\-dedicated\-listener\(dq: true,
                                \(dqhttp\-listener\-threads\(dq: 4,
                                \(dqhttp\-client\-threads\(dq: 4
                            },
                            \(dqpeers\(dq: [
                                {
                                    \(dqname\(dq: \(dqserver1\(dq,
                                    \(dqurl\(dq: \(dqhttp://192.168.56.66:8007/\(dq,
                                    \(dqrole\(dq: \(dqprimary\(dq,
                                    \(dqauto\-failover\(dq: true
                                },
                                {
                                    \(dqname\(dq: \(dqserver2\(dq,
                                    \(dqurl\(dq: \(dqhttp://192.168.56.33:8007/\(dq,
                                    \(dqrole\(dq: \(dqstandby\(dq,
                                    \(dqauto\-failover\(dq: true
                                }
                            ]
                        },
                        {
                            \(dqthis\-server\-name\(dq: \(dqserver4\(dq,
                            \(dqmode\(dq: \(dqhot\-standby\(dq,
                            \(dqmulti\-threading\(dq: {
                                \(dqenable\-multi\-threading\(dq: true,
                                \(dqhttp\-dedicated\-listener\(dq: true,
                                \(dqhttp\-listener\-threads\(dq: 4,
                                \(dqhttp\-client\-threads\(dq: 4
                            },
                            \(dqpeers\(dq: [
                                {
                                    \(dqname\(dq: \(dqserver3\(dq,
                                    \(dqurl\(dq: \(dqhttp://192.168.57.99:8007/\(dq,
                                    \(dqrole\(dq: \(dqprimary\(dq,
                                    \(dqauto\-failover\(dq: true
                                },
                                {
                                    \(dqname\(dq: \(dqserver4\(dq,
                                    \(dqurl\(dq: \(dqhttp://192.168.57.33:8007/\(dq,
                                    \(dqrole\(dq: \(dqstandby\(dq,
                                    \(dqauto\-failover\(dq: true
                                }
                            ]
                        }
                    ]
                }
            }
        ],
        \(dqsubnet6\(dq: [
            {
                \(dqid\(dq: 1,
                \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
                \(dqpools\(dq: [ { \(dqpool\(dq: \(dq2001:db8:1::/80\(dq } ],
                \(dqinterface\(dq: \(dqenp0s8\(dq,
                \(dquser\-context\(dq: {
                    \(dqha\-server\-name\(dq: \(dqserver2\(dq
                }
            },
            {
                \(dqid\(dq: 2,
                \(dqsubnet\(dq: \(dq2001:db8:2::/64\(dq,
                \(dqpools\(dq: [ { \(dqpool\(dq: \(dq2001:db8:2::/80\(dq } ],
                \(dqinterface\(dq: \(dqenp0s9\(dq,
                \(dquser\-context\(dq: {
                    \(dqha\-server\-name\(dq: \(dqserver4\(dq
                }
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نام‌های همتا در روابط باید یکتا باشند. بافت کاربر (user context) برای هر زیرشبکه شامل پارامتر \fBha\-server\-name\fP است که یک زیرشبکه را با یک رابطه مرتبط می‌کند. مقدار \fBha\-server\-name\fP می‌تواند هر یک از نام‌های همتا در رابطه باشد. به عنوان مثال، اگر یک رابطه شامل نام‌های همتای \fBserver1\fP و \fBserver2\fP باشد، فرقی نمی‌کند که \fBha\-server\-name\fP برابر با \fBserver1\fP باشد یا \fBserver2\fP\&. در هر دو حالت، زیرشبکه را با آن رابطه مرتبط می‌سازد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
توجه به این نکته مهم است که هر همتا در یک کارگزار Kea مشخص باید از ترکیب نشانی/پورت شنود یکتا استفاده کند. اگر نشانی و پورت یکسانی برای چندین همتا تعریف شود، سرویس Kea با خطایی مشابه زیر در راه‌اندازی شکست می‌خورد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCP4_INIT_FAIL failed to initialize Kea server: configuration error using
file \(aqkea\-dhcp4.conf\(aq: Error initializing hooks: CmdHttpListener::run failed:
unable to setup TCP acceptor for listening to the incoming HTTP requests:
bind: Address already in use
.EE
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
مشخص کردن \fBha\-server\-name\fP در کارگزارهای شعبه الزامی نیست، با این فرض که کارگزارهای شعبه فقط شامل زیرشبکه‌هایی باشند که به آن‌ها سرویس می‌دهند. پیکربندی زیر را برای شعبه \fBserver3\fP در نظر بگیرید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqDhcp6\(dq: {
        \(dqinterfaces\-config\(dq: {
            \(dqinterfaces\(dq: [ \(dqenp0s8\(dq ]
        },
        \(dqhooks\-libraries\(dq: [
            {
                \(dqlibrary\(dq: \(dqlibdhcp_lease_cmds.so\(dq,
                \(dqparameters\(dq: {}
            },
            {
                \(dqlibrary\(dq: \(dqlibdhcp_ha.so\(dq,
                \(dqparameters\(dq: {
                    \(dqhigh\-availability\(dq: [
                        {
                            \(dqthis\-server\-name\(dq: \(dqserver3\(dq,
                            \(dqmode\(dq: \(dqhot\-standby\(dq,
                            \(dqmulti\-threading\(dq: {
                                \(dqenable\-multi\-threading\(dq: true,
                                \(dqhttp\-dedicated\-listener\(dq: true,
                                \(dqhttp\-listener\-threads\(dq: 4,
                                \(dqhttp\-client\-threads\(dq: 4
                            },
                            \(dqpeers\(dq: [
                                {
                                    \(dqname\(dq: \(dqserver3\(dq,
                                    \(dqurl\(dq: \(dqhttp://192.168.57.99:8007/\(dq,
                                    \(dqrole\(dq: \(dqprimary\(dq,
                                    \(dqauto\-failover\(dq: true
                                },
                                {
                                    \(dqname\(dq: \(dqserver4\(dq,
                                    \(dqurl\(dq: \(dqhttp://192.168.57.33:8007/\(dq,
                                    \(dqrole\(dq: \(dqstandby\(dq,
                                    \(dqauto\-failover\(dq: true
                                }
                            ]
                        }
                    ]
                }
            }
        ],
        \(dqsubnet6\(dq: [
            {
                \(dqid\(dq: 2,
                \(dqsubnet\(dq: \(dq2001:db8:2::/64\(dq,
                \(dqpools\(dq: [
                    {
                        \(dqpool\(dq: \(dq2001:db8:2::/80\(dq
                    }
                ],
                \(dqinterface\(dq: \(dqenp0s8\(dq,
                \(dquser\-context\(dq: {
                    \(dqha\-server\-name\(dq: \(dqserver3\(dq
                }
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
اگرچه می‌توان پارامترهای بافت کاربر \fBha\-server\-name\fP را در کارگزارهای شعبه نادیده گرفت، توصیه می‌کنیم آن‌ها را درج کنید. کارگزارها هنگام همگام‌سازی پایگاه‌داده، تمام اجاره‌ها را از همتاها دریافت می‌کنند؛ اگر زیرشبکه‌ها به صراحت با رابطه مرتبط نشده باشند، کارگزار شعبه تمام اجاره‌های دریافت شده از کارگزار مرکزی (شامل اجاره‌های مربوط به سایر روابط) را در پایگاه‌داده خود وارد می‌کند. مشخص کردن پارامتر \fBha\-server\-name\fP برای هر زیرشبکه پیکربندی‌شده در کارگزار شعبه، تضمین می‌کند که فقط اجاره‌های متعلق به رابطه خود در پایگاه‌داده کارگزار شعبه وارد شوند.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
نام‌های همتا در کارگزارهای شعبه باید با نام‌های همتا در روابط متناظر کارگزار مرکزی مطابقت داشته باشند، زیرا این نام‌ها برای ارسال سیگنال میان همتاهای HA استفاده می‌شوند.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
پیکربندی هاب و اسپوک در حال حاضر با پارامترهای \fBreselect\-subnet\-address\fP و \fBreselect\-subnet\-pool\fP از کتابخانه \fBlibdhcp_radius.so\fP ناسازگار است. کتابخانه قلاب دسترس‌پذیری بالا (High Availability hook library) از زیرشبکه انتخاب‌شده اولیه برای برگزیدن یک رابطه HA جهت پردازش بسته استفاده می‌کند. انتخاب مجدد زیرشبکه ممکن است با این فرایند تداخل ایجاد کند. برای جزئیات بیشتر، به بخش پیکربندی کتابخانه قلاب RADIUS در \%<#\:radius-config> مراجعه کنید.
.UNINDENT
.UNINDENT.SS \fBlibdhcp_host_cache.so\fP: رزروهای حافظه موقت میزبان برای بهبود کارایی
.sp
برخی از پس‌اندهای پایگاه‌داده، مانند RADIUS، کند هستند و ممکن است پاسخ‌دهی
آن‌ها زمان زیادی ببرد. از آن‌جا که Kea به‌طور کلی همگام (synchronous) است،
کارایی پس‌اند مستقیماً بر کارایی DHCP تأثیر می‌گذارد. به منظور به حداقل
رساندن این اثر و بهبود کارایی، کتابخانهٔ Host Cache روشی برای ذخیره‌سازی
محلی اطلاعات پایگاه‌داده در حافظه موقت (cache) فراهم می‌کند. این قابلیت شامل
حافظه موقت منفی (negative caching)، یعنی توانایی به‌خاطر سپردن این که
هیچ اطلاعاتی از کلاینت در پایگاه‌داده وجود ندارد، نیز می‌شود.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
\fBlibdhcp_host_cache.so\fP بخشی از کد منبع‌باز است و برای همهٔ کاربران Kea در دسترس است.
این قابلیت پیش‌تر تنها برای مشتریان ISC با قرارداد پشتیبانی تجاری در دسترس بود.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این کتابخانه تنها می‌تواند توسط فرایند \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> یا
\fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> بارگذاری شود.
.UNINDENT
.UNINDENT
.sp
در اصل، این کتابخانهٔ قلاب (hook library) می‌تواند با هر پس‌اندی که ممکن است
موجب افت کارایی شود (MySQL، PostgreSQL یا RADIUS) استفاده شود. برای کارکرد
سازوکار حسابرسی (accounting) در RADIUS، بارگذاری Host Cache الزامی است.
.sp
کتابخانهٔ قلاب Host Cache بسیار ساده است. این کتابخانه تنها یک پارامتر
اختیاری (\fBmaximum\fP) می‌گیرد که حداکثر تعداد میزبان‌های ذخیره‌شده در حافظه
موقت را مشخص می‌کند. در صورت عدم تعیین، مقدار پیش‌فرض 0 استفاده می‌شود که
به معنای نبود محدودیت است. این کتابخانهٔ قلاب را می‌توان همانند هر کتابخانهٔ
قلاب دیگری بارگذاری کرد؛ برای نمونه، این پیکربندی می‌تواند استفاده شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp4\(dq: {

# Your regular DHCPv4 configuration parameters here.

\(dqhooks\-libraries\(dq: [
{
    \(dqlibrary\(dq: \(dqlibdhcp_host_cache.so\(dq,
    \(dqparameters\(dq: {

        # Tells Kea to never cache more than 1000 hosts.
        \(dqmaximum\(dq: 1000

    }
} ],
\&...
}
.EE
.UNINDENT
.UNINDENT
.sp
پس از بارگذاری، کتابخانهٔ قلاب Host Cache تعدادی دستور جدید ارائه می‌دهد
که می‌توانند از طریق کانال کنترل (بخش
Using the Control Channel \%<#\:ctrl-channel-client> را ببینید) استفاده شوند.
یک نمونه کلاینت RESTful API در
Overview of the Kea Shell \%<#\:shell-overview>\& شرح داده شده است. بخش‌های زیر دستورهای
موجود را شرح می‌دهند.
.SS دستور \fBcache\-flush\fP
.sp
این دستور امکان حذف تعداد مشخصی از مدخل‌های ذخیره‌شدهٔ میزبان را فراهم
می‌کند. این دستور یک پارامتر می‌گیرد که تعداد میزبان‌های حذفی را مشخص
می‌کند. یک نمونه کاربرد به صورت زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqcache\-flush\(dq,
    \(dqarguments\(dq: 1000
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور 1000 میزبان را حذف می‌کند؛ برای حذف \fIتمام\fP میزبان‌های ذخیره‌شده،
در عوض از \fBcache\-clear\fP استفاده کنید. میزبان‌ها با ترتیب FIFO
(نخستین ورودی، نخستین خروجی) ذخیره می‌شوند، بنابراین همیشه قدیمی‌ترین مدخل‌ها حذف می‌گردند.
.SS دستور \fBcache\-clear\fP
.sp
این دستور امکان حذف تمام مدخل‌های ذخیره‌شدهٔ میزبان را فراهم می‌کند. یک نمونه کاربرد
به صورت زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqcache\-clear\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور تمام میزبان‌ها را حذف می‌کند. برای حذف تنها تعداد مشخصی
از میزبان‌های ذخیره‌شده، لطفاً در عوض از \fBcache\-flush\fP استفاده کنید.
.SS دستور \fBcache\-size\fP
.sp
این دستور تعداد مدخل‌های میزبان را بازمی‌گرداند. یک نمونه کاربرد به
صورت زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqcache\-size\(dq
}
.EE
.UNINDENT
.UNINDENT
.SS دستور \fBcache\-write\fP
.sp
به‌طور کلی، محتوای حافظه موقت یک وضعیت زمان اجرا در نظر گرفته می‌شود و
کارساز می‌تواند طبق معمول خاموش یا بازراه‌اندازی شود؛ سپس حافظه موقت پس
از بازراه‌اندازی مجدداً پر می‌شود. با این حال، در برخی موارد ذخیره کردن
محتویات حافظه موقت سودمند است. یک نمونه از این موارد RADIUS است،
که در آن میزبان‌های ذخیره‌شده همچنین صفت‌های اضافیِ ذخیره‌شدهٔ RADIUS را حفظ می‌کنند؛
روش آسانی برای به‌دست آوردن دوبارهٔ این اطلاعات وجود ندارد، زیرا کلاینت‌های در حال تمدید
بسته‌های خود را مستقیماً به کارساز DHCP ارسال می‌کنند. مورد کاربرد دیگر
زمانی است که مدیر سیستم می‌خواهد کارساز را بازراه‌اندازی کند و به دلایل کارایی،
مایل است کارساز با یک حافظه موقت گرم و از پیش پرشده (hot/populated) شروع به کار کند.
.sp
این دستور امکان نوشتن محتویات حافظه موقت درون‌حافظه‌ای را در یک فایل
روی دیسک فراهم می‌کند. این دستور یک پارامتر می‌پذیرد که نام فایل را مشخص
می‌کند. یک نمونه کاربرد به صورت زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqcache\-write\(dq,
    \(dqarguments\(dq: \(dq/var/lib/kea/kea\-host\-cache.json\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
این کار موجب ذخیره شدن محتویات در فایل \fB/var/lib/kea/kea\-host\-cache.json\fP
می‌شود. سپس می‌توان آن فایل را با دستور \fBcache\-load\fP بارگذاری کرد یا
توسط هر ابزار دیگری که قادر به تجزیه و فهم قالب JSON باشد پردازش نمود.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
از نسخهٔ 2.7.9 در Kea، فایل حافظه موقت تنها می‌تواند در دایرکتوری داده‌ای که
در زمان کامپایل مشخص شده است نوشته شود: \fB\(dq[kea\-install\-dir]/var/lib/kea\(dq\fP\&. این
مسیر می‌تواند در هنگام راه‌اندازی با مقداردهی متغیر محیطی
\fBKEA_DHCP_DATA_DIR\fP به مسیر دلخواه بازنویسی شود. برای راحتی کار هنگام
تعیین نام فایل سفارشی، کافی است بخش مسیر را از \fBfilename\fP حذف کنید.
.UNINDENT
.UNINDENT.SS دستور \fBcache\-load\fP
.sp
برای بررسی سناریوهای کاربردی که در آن‌ها نوشتن و بارگذاری محتویات حافظهٔ نهان میزبان روی دیسک می‌تواند مفید باشد، به بخش قبل مراجعه کنید.
.sp
این دستور اجازه می‌دهد محتویات یک فایل روی دیسک در یک حافظهٔ نهان درون حافظه (in\-memory cache) بارگذاری شود. این دستور یک پارامتر می‌گیرد که نام فایل را مشخص می‌کند. نمونه‌ای از کاربرد آن به صورت زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqcache\-load\(dq,
    \(dqarguments\(dq: \(dq/usr/local/share/kea/kea\-host\-cache.json\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور محتویات را در فایل \fB/usr/local/share/kea/kea\-host\-cache.json\fP ذخیره می‌کند. سپس می‌توان آن فایل را با دستور \fBcache\-load\fP بارگذاری کرد یا توسط هر ابزار دیگری که قادر به درک قالب JSON باشد پردازش نمود.
.SS دستور \fBcache\-get\fP
.sp
این دستور مشابه \fBcache\-write\fP است، اما به جای نوشتن محتویات حافظهٔ نهان روی دیسک، محتویات را به ارسال‌کنندهٔ دستور بازمی‌گرداند.
.sp
این دستور اجازه می‌دهد محتویات یک فایل روی دیسک در یک حافظهٔ نهان درون حافظه بارگذاری شود. این دستور یک پارامتر می‌گیرد که نام فایل را مشخص می‌کند. نمونه‌ای از کاربرد آن به صورت زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqcache\-get\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور تمام میزبان‌های ذخیره‌شده در حافظهٔ نهان را برمی‌گرداند؛ پاسخ ممکن است حجیم باشد.
.SS دستور \fBcache\-get\-by\-id\fP
.sp
این دستور مشابه \fBcache\-get\fP است، اما به جای بازگرداندن کل محتوا، تنها ورودی‌های منطبق با شناسهٔ ارائه‌شده را بازمی‌گرداند.
.sp
این دستور یک پارامتر می‌گیرد که شناسهٔ رزروهای میزبان موردنظر در حافظهٔ نهان را مشخص می‌کند. نمونه‌ای از کاربرد آن به صورت زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqcache\-get\-by\-id\(dq,
    \(dqarguments\(dq: {
        \(dqhw\-address\(dq: \(dq01:02:03:04:05:06\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور تمام میزبان‌های ذخیره‌شده در حافظهٔ نهان را با آدرس سخت‌افزاری ارائه‌شده بازمی‌گرداند.
.SS دستور \fBcache\-insert\fP
.sp
از این دستور می‌توان برای درج دستی یک میزبان در حافظهٔ نهان استفاده کرد؛ سناریوهای کاربردی بسیار اندکی وجود دارند که در آن‌ها این دستور ممکن است مفید باشد. این دستور انتظار دارد آرگومان‌های آن از نحو معمول برای تعیین رزروهای میزبان پیروی کنند (بخش رزروهای میزبان در DHCPv4 \%<#\:host-reservation-v4> یا رزروهای میزبان در DHCPv6 \%<#\:host-reservation-v6> را ببینید)، با یک تفاوت: مقدار \fBsubnet\-id\fP باید صراحتاً مشخص شود.
.sp
نمونه‌ای از دستور برای درج یک میزبان IPv4 در حافظهٔ نهان میزبان به صورت زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqcache\-insert\(dq,
    \(dqarguments\(dq: {
        \(dqhw\-address\(dq: \(dq01:02:03:04:05:06\(dq,
        \(dqsubnet\-id4\(dq: 4,
        \(dqsubnet\-id6\(dq: 0,
        \(dqip\-address\(dq: \(dq192.0.2.100\(dq,
        \(dqhostname\(dq: \(dqsomehost.example.org\(dq,
        \(dqclient\-classes4\(dq: [ ],
        \(dqclient\-classes6\(dq: [ ],
        \(dqoption\-data4\(dq: [ ],
        \(dqoption\-data6\(dq: [ ],
        \(dqnext\-server\(dq: \(dq192.0.0.2\(dq,
        \(dqserver\-hostname\(dq: \(dqserver\-hostname.example.org\(dq,
        \(dqboot\-file\-name\(dq: \(dqbootfile.efi\(dq,
        \(dqhost\-id\(dq: 0
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نمونه‌ای از دستور برای درج یک میزبان IPv6 در حافظهٔ نهان میزبان به صورت زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqcache\-insert\(dq,
    \(dqarguments\(dq: {
        \(dqhw\-address\(dq: \(dq01:02:03:04:05:06\(dq,
        \(dqsubnet\-id4\(dq: 0,
        \(dqsubnet\-id6\(dq: 6,
        \(dqip\-addresses\(dq: [ \(dq2001:db8::cafe:babe\(dq ],
        \(dqprefixes\(dq: [ \(dq2001:db8:dead:beef::/64\(dq ],
        \(dqhostname\(dq: \(dq\(dq,
        \(dqclient\-classes4\(dq: [ ],
        \(dqclient\-classes6\(dq: [ ],
        \(dqoption\-data4\(dq: [ ],
        \(dqoption\-data6\(dq: [ ],
        \(dqnext\-server\(dq: \(dq0.0.0.0\(dq,
        \(dqserver\-hostname\(dq: \(dq\(dq,
        \(dqboot\-file\-name\(dq: \(dq\(dq,
        \(dqhost\-id\(dq: 0
    }
}
.EE
.UNINDENT
.UNINDENT.SS دستور \fBcache\-remove\fP
.sp
گاهی اوقات حذف یک مدخل مشخص از کَش میزبان مفید است: برای
مثال وضعیتی را در نظر بگیرید که دستگاه فعال است، Kea از پیش
پیکربندی را ارائه داده، و مدخل میزبان در کَش قرار دارد. در پی یک
اقدام مدیریتی (مثلاً مشتری قبوض خود را پرداخت نکرده یا به
یک سرویس بهتر ارتقا یافته است)، اطلاعات در پایگاه‌دادهٔ پسین
(مانند MySQL یا RADIUS) به‌روزرسانی می‌شود. با این حال، از آنجا که کَش در حال استفاده است،
Kea متوجه تغییرات نمی‌شود زیرا مقادیر کَش‌شده به کار گرفته می‌شوند. دستور
\fBcache\-remove\fP می‌تواند با حذف مدخل کَش‌شده پس از اعمال تغییرات مدیریتی،
این مشکل را برطرف کند.
.sp
دستور \fBcache\-remove\fP به شیوه‌ای مشابه با دستور \fBreservation\-get\fP عمل می‌کند.
این دستور امکان پرس‌وجو با استفاده از دو پارامتر را فراهم می‌کند: یا \fBsubnet\-id4\fP یا \fBsubnet\-id6\fP؛
یا \fBip\-address\fP (می‌تواند یک آدرس IPv4 یا IPv6 باشد)، \fBhw\-address\fP (مشخص‌کنندهٔ
آدرس سخت‌افزاری/MAC)، \fBduid\fP، \fBcircuit\-id\fP، \fBclient\-id\fP، یا \fBflex\-id\fP\&.
.sp
یک دستور نمونه برای حذف یک میزبان IPv4 با آدرس رزروشدهٔ
192.0.2.1 از زیرشبکه‌ای با \fBsubnet\-id\fP برابر با 123 به صورت زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqcache\-remove\(dq,
    \(dqarguments\(dq: {
        \(dqip\-address\(dq: \(dq192.0.2.1\(dq,
        \(dqsubnet\-id\(dq: 123
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نمونه‌ای دیگر که یک شناسهٔ میزبان IPv6 را بر اساس DUID و
یک \fBsubnet\-id\fP مشخص حذف می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqcache\-remove\(dq,
    \(dqarguments\(dq: {
        \(dqduid\(dq: \(dq00:01:ab:cd:f0:a1:c2:d3:e4\(dq,
        \(dqsubnet\-id\(dq: 123
    }
}
.EE
.UNINDENT
.UNINDENT
.SS \fBlibdhcp_host_cmds.so\fP: دستورهای میزبان
.sp
Kea می‌تواند رزروهای میزبان را در یک پایگاه‌داده ذخیره کند؛ در بسیاری از استقرارهای بزرگ‌تر،
اینکه بتوان این اطلاعات را در حین اجرای کارساز مدیریت کرد بسیار سودمند است. کتابخانهٔ دستورهای میزبان (Host Commands)، دستورهای مدیریتی را برای افزودن، پرس‌وجو،
و حذف رزروهای میزبان به شکلی امن و بدون راه‌اندازی مجدد
کارساز ارائه می‌دهد. به‌ویژه، این کتابخانه پارامترها را اعتبارسنجی می‌کند، بنابراین تلاش برای
درج داده‌های نادرست \- مانند افزودن میزبانی با شناسهٔ متداخل در
همان زیرشبکه \- رد می‌شود. این دستورها از طریق کانال فرمان
(JSON بر بستر سوکت‌های UNIX یا HTTP/HTTPS) ارائه می‌شوند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
\fBlibdhcp_host_cmds.so\fP بخشی از کد منبع‌باز است و در دسترس
تمامی کاربران Kea قرار دارد.
این قابلیت پیش‌تر تنها برای مشتریان ISC با قرارداد پشتیبانی تجاری در دسترس بود.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این کتابخانه تنها می‌تواند توسط فرایند \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> یا \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6>
بارگذاری شود.
.UNINDENT
.UNINDENT
.sp
در حال حاضر دستورهای زیر پشتیبانی می‌شوند:
.INDENT 0.0
.IP \(bu 2
\fBreservation\-add\fP، که یک رزرو میزبان جدید اضافه می‌کند.
.IP \(bu 2
\fBreservation\-get\fP، که در صورت تطابق با معیارهای مشخص‌شده،
یک رزرو موجود را بازمی‌گرداند.
.IP \(bu 2
\fBreservation\-get\-all\fP، که تمام رزروهای موجود در یک زیرشبکهٔ مشخص را بازمی‌گرداند.
.IP \(bu 2
\fBreservation\-get\-page\fP، نوعی از \fBreservation\-get\-all\fP که رزروها را
به صورت صفحه‌بندی‌شده بازمی‌گرداند؛ خواه تمام آن‌ها و خواه در یک زیرشبکهٔ مشخص.
.IP \(bu 2
\fBreservation\-get\-by\-address\fP، که تمام رزروهای دارای یک آدرس IP مشخص
یا یک پیشوند واگذارشده (بدون طول پیشوند)، و به‌طور اختیاری یک شناسهٔ زیرشبکه را بازمی‌گرداند.
.IP \(bu 2
\fBreservation\-get\-by\-hostname\fP، که تمام رزروهای دارای یک نام میزبان
مشخص و به‌طور اختیاری درون یک زیرشبکه را بازمی‌گرداند.
.IP \(bu 2
\fBreservation\-get\-by\-id\fP، که تمام رزروهای دارای شناسهٔ مشخص را
بازمی‌گرداند (از نسخهٔ 1.9.0 در Kea).
.IP \(bu 2
\fBreservation\-del\fP، که برای حذف رزرو منطبق با معیارهای مشخص‌شده
تلاش می‌کند.
.IP \(bu 2
\fBreservation\-update\fP، که یک رزرو موجود منطبق با شناسه‌های ارائه‌شده
در یک زیرشبکه را به‌روزرسانی (جایگزین) می‌کند.
.UNINDENT
.sp
برای استفاده از دستورهایی که اطلاعات رزرو را تغییر می‌دهند
(یعنی \fBreservation\-add\fP، \fBreservation\-del\fP، و \fBreservation\-update\fP) جهت
تغییر داده‌های ذخیره‌شده در پایگاه‌دادهٔ میزبان، پایگاه‌دادهٔ میزبان‌ها باید مشخص شده باشد
و نباید در حالت فقط‌خواندنی (read\-only) اجرا شود (برای جزئیات، به
توضیحات \fBhosts\-databases\fP در بخش پیکربندی پایگاه‌دادهٔ میزبان‌های DHCPv4 \%<#\:hosts-databases-configuration4> و
پیکربندی پایگاه‌دادهٔ میزبان‌های DHCPv6 \%<#\:hosts-databases-configuration6> مراجعه کنید). چنانچه \fBhosts\-databases\fP مشخص
نشده باشد یا در حالت فقط‌خواندنی کار کند، \fBlibdhcp_host_cmds.so\fP بارگذاری
خواهد شد، اما هرگونه تلاش برای استفاده از \fBreservation\-add\fP، \fBreservation\-del\fP، و
\fBreservation\-update\fP جهت اصلاح داده‌ها در آن پایگاه‌داده با شکست مواجه خواهد شد.
.sp
این دستورها همچنین می‌توانند میزبان‌ها را از پیکربندی JSON، مستقل
از پایگاه‌دادهٔ میزبان‌ها اصلاح کنند. تغییرات اعمال‌شده در پیکربندی JSON به صورت فرار
(volatile) هستند و می‌توان با ارسال دستور \fBconfig\-write\fP \%<#\:std-isccmd-config-write> آن‌ها را دائمی کرد.
.sp
برای مشاهدهٔ شرح دستورهای پیشنهادی در آینده، به سند الزامات رابط کنترلی (Control API Requirements)
در نشانی \%<https://\:gitlab\:.isc\:.org/\:isc-projects/\:kea/\:-/\:wikis/\:Designs/\:commands>
مراجعه کنید.
.sp
تمامی دستورهای میزبان از نحو JSON استفاده می‌کنند. این دستورها را می‌توان با
استفاده از کانال کنترل صادر کرد (به رابط مدیریتی یا Management API \%<#\:ctrl-channel> مراجعه کنید).
.sp
این کتابخانه می‌تواند مشابه سایر کتابخانه‌های قلاب (hook libraries) بارگذاری شود. این کتابخانه
هیچ پارامتری دریافت نمی‌کند و از هر دو کارساز DHCPv4 و DHCPv6
پشتیبانی می‌کند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqhooks\-libraries\(dq: [
        {
            \(dqlibrary\(dq: \(dqlibdhcp_host_cmds.so\(dq
        },
        ...
    ]
}
.EE
.UNINDENT
.UNINDENT.SS پارامتر \fBsubnet\-id\fP
.sp
پیش از بررسی هر دستور به طور مجزا، شایسته است در مورد پارامتر \fBsubnet\-id\fP بحث شود\&. در حال حاضر، این پارامتر برای تمام دستورات ارائه‌شده توسط این کتابخانه اجباری است، به استثنای \fBreservation\-get\-by\-hostname\fP و \fBreservation\-get\-by\-address\fP که در آن‌ها اختیاری است. \fBsubnet\-id\fP همچنین در \fBreservation\-get\-page\fP اختیاری بوده و در \fBreservation\-get\-by\-id\fP غیرمجاز است\&.
.sp
رزروها می‌توانند به صورت سراسری (global) مشخص شوند و لزوماً محدود به زیرشبکه خاصی نیستند. هنگامی که رزروها از طریق فایل پیکربندی ارائه می‌شوند، شناسه (ID) زیرشبکه دربرگیرنده (یا عدم وجود آن) در ساختار پیکربندی به صورت ضمنی مشخص است. با این حال، هنگام مدیریت رزروها با استفاده از دستورات host، لازم است حوزه‌ای (scope) که رزرو به آن تعلق دارد، به طور صریح مشخص شود. این کار از طریق پارامتر \fBsubnet\-id\fP انجام می‌شود. برای رزروهای سراسری، از مقدار صفر (0) استفاده کنید. برای رزروهای محدود به یک زیرشبکه خاص، از شناسه (ID) آن زیرشبکه استفاده نمایید. همچنین به یادداشت موجود در بخش دستور reservation\-add درباره دستور \fBreservation\-add\fP برای رزرو خالی (یعنی بدون آدرس یا پیشوند رزرو شده) مراجعه کنید.
.sp
از سوی دیگر، اگر \fBsubnet\-id\fP در پارامترهای دستور مشخص نشده باشد، به هر میزبان (host) در پاسخ‌ها اضافه می‌شود. اگر \fBsubnet\-id\fP دارای مقدار ویژه استفاده‌نشده باشد، بدان معناست که مدخل میزبان تنها به نسخه دیگر IP تعلق دارد (یعنی IPv6 در سرور DHCPv4 یا IPv4 در سرور DHCPv6) و این مدخل نادیده گرفته می‌شود.
.SS پارامتر \fBoperation\-target\fP
.sp
اکثر دستورات host پارامتر \fBoperation\-target\fP را می‌پذیرند که منبع داده میزبان را انتخاب می‌کند. دستورات ممکن است داده‌ها را از پیکربندی سرور (یعنی مقصد عملیاتی حافظه - memory)، یک پایگاه داده (مقصد database) یا هر دو (تمام منابع) پردازش کنند. پارامتر operation\-target اختیاری است. به طور پیش‌فرض، دستوراتی که فقط داده‌ها را می‌خوانند از تمام منابع داده (حافظه و پایگاه داده) استفاده می‌کنند؛ دستوراتی که وضعیت را تغییر می‌دهند (یعنی \fBreservation\-add\fP، \fBreservation\-del\fP و \fBreservation\-update\fP) تنها از مقصد پایگاه داده (database) استفاده می‌کنند.
.sp
پارامتر \fBoperation\-target\fP مقادیر زیر را می‌پذیرد:
.INDENT 0.0
.IP \(bu 2
\fBmemory\fP \- پرس‌وجو یا به‌روزرسانی پیکربندی زمان اجرای سرور
.IP \(bu 2
\fBdatabase\fP \- پرس‌وجو یا به‌روزرسانی پایگاه(های) داده میزبان
.IP \(bu 2
\fBall\fP \- پرس‌وجو یا به‌روزرسانی هم پیکربندی زمان اجرا و هم پایگاه(های) داده میزبان
.IP \(bu 2
\fBdefault\fP \- پرس‌وجو یا به‌روزرسانی منبع داده پیش‌فرض میزبان \- بسته به دستور متفاوت است
.UNINDENT
.SS دستور \fBreservation\-add\fP
.sp
دستور \fBreservation\-add\fP امکان درج یک میزبان جدید را فراهم می‌کند. این دستور مجموعه‌ای از آرگومان‌ها را دریافت می‌کند که بسته به ماهیت رزرو میزبان متفاوت است. هر پارامتر مجاز در فایل پیکربندی که مربوط به رزرو میزبان باشد، در اینجا نیز مجاز است. برای جزئیات مربوط به رزروهای IPv4، بخش Host Reservations in DHCPv4 \%<#\:host-reservation-v4> را ببینید؛ برای رزروهای IPv6، بخش Host Reservations in DHCPv6 \%<#\:host-reservation-v6>\& را ببینید. پارامتر \fBsubnet\-id\fP اجباری است. از مقدار صفر (0) برای افزودن یک رزرو سراسری، یا شناسه (ID) زیرشبکه‌ای که رزرو باید به آن اضافه شود، استفاده کنید. این دستور می‌تواند به سادگیِ داشتن تنها دو مدخل اجباری باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqreservation\-add\(dq,
    \(dqarguments\(dq: {
        \(dqreservation\(dq: {
            \(dqsubnet\-id\(dq: 1,
            \(dqhw\-address\(dq: \(dq1a:1b:1c:1d:1e:1f\(dq
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
با این حال، در این حالت هیچ منبعی به میزبان اختصاص داده نمی‌شود. یک آدرس IPv4 را می‌توان مانند این مثال اختصاص داد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqreservation\-add\(dq,
    \(dqarguments\(dq: {
        \(dqreservation\(dq: {
            \(dqsubnet\-id\(dq: 1,
            \(dqhw\-address\(dq: \(dq1a:1b:1c:1d:1e:1f\(dq,
            \(dqip\-address\(dq: \(dq192.0.2.202\(dq
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
همچنین می‌تواند پارامترهای بسیار بیشتری را بپذیرد، مانند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqreservation\-add\(dq,
    \(dqarguments\(dq: {
        \(dqreservation\(dq: {
            \(dqsubnet\-id\(dq: 1,
            \(dqclient\-id\(dq: \(dq01:0a:0b:0c:0d:0e:0f\(dq,
            \(dqip\-address\(dq: \(dq192.0.2.205\(dq,
            \(dqnext\-server\(dq: \(dq192.0.2.1\(dq,
            \(dqserver\-hostname\(dq: \(dqhal9000\(dq,
            \(dqboot\-file\-name\(dq: \(dq/dev/null\(dq,
            \(dqoption\-data\(dq: [
                {
                    \(dqname\(dq: \(dqdomain\-name\-servers\(dq,
                    \(dqdata\(dq: \(dq10.1.1.202,10.1.1.203\(dq
                }
            ],
            \(dqclient\-classes\(dq: [ \(dqspecial_snowflake\(dq, \(dqoffice\(dq ]
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
در اینجا یک مثال از رزرو پیچیده IPv6 آورده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqreservation\-add\(dq,
    \(dqarguments\(dq: {
        \(dqreservation\(dq: {
            \(dqsubnet\-id\(dq: 1,
            \(dqduid\(dq: \(dq01:02:03:04:05:06:07:08:09:0A\(dq,
            \(dqip\-addresses\(dq: [ \(dq2001:db8:1:cafe::1\(dq ],
            \(dqprefixes\(dq: [ \(dq2001:db8:2:abcd::/64\(dq ],
            \(dqhostname\(dq: \(dqfoo.example.com\(dq,
            \(dqoption\-data\(dq: [
                {
                    \(dqname\(dq: \(dqvendor\-opts\(dq,
                    \(dqdata\(dq: \(dq4491\(dq
                },
                {
                    \(dqname\(dq: \(dqtftp\-servers\(dq,
                    \(dqspace\(dq: \(dqvendor\-4491\(dq,
                    \(dqdata\(dq: \(dq3000:1::234\(dq
                }
            ]
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور آرگومان \fBoperation\-target\fP را می‌پذیرد. به طور پیش‌فرض، رزرو را فقط به پایگاه داده میزبان‌ها اضافه می‌کند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqreservation\-add\(dq,
    \(dqarguments\(dq: {
        \(dqreservation\(dq: {},
        \(dqoperation\-target\(dq: \(dqall\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور وضعیتی را بازمی‌گرداند که نشان‌دهنده موفقیت (result 0) یا شکست (result 1) است. یک دستور ناموفق همیشه شامل یک پارامتر text است که علت شکست را توضیح می‌دهد. در اینجا یک نمونه از افزودن موفقیت‌آمیز آورده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqHost added.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
و در اینجا یک مثال از شکست آورده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 1,
    \(dqtext\(dq: \(dqMandatory \(aqsubnet\-id\(aq parameter missing.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
از آنجا که انتظار می‌رود \fBreservation\-add\fP میزبان را ذخیره کند، پارامتر \fBhosts\-databases\fP باید در پیکربندی مشخص شده باشد و پایگاه‌های داده نباید در حالت فقط‌خواندنی (read\-only) اجرا شوند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
از نسخه 2.7.0 kea به بعد، یک رزرو خالی به صورت ضمنی سراسری است؛ یعنی اگر هیچ مدخل \fBsubnet\-id\fP وجود نداشته باشد و برای DHCPv4 پارامتر \fBip\-address\fP یا برای DHCPv6 پارامترهای \fBip\-addresses\fP و \fBprefixes\fP آدرس یا پیشوند رزروشده‌ای را مشخص نکنند، دستور معتبر است و یک رزرو میزبان سراسری (subnet\-id 0) اضافه می‌کند.
.UNINDENT
.UNINDENT.SS دستور \fBreservation\-get\fP
.sp
از \fBreservation\-get\fP می‌توان برای پرس‌وجوی پایگاه‌داده میزبان و بازیابی
رزروهای موجود استفاده کرد. این دستور از دو نوع پارامتر پشتیبانی می‌کند:
(\fBsubnet\-id\fP, \fBaddress\fP) یا (\fBsubnet\-id\fP, \fBidentifier\-type\fP,
\fBidentifier\fP). نوع اول پرس‌وجو زمانی استفاده می‌شود که آدرس (چه
IPv4 یا IPv6) مشخص است، اما جزئیات رزرو مشخص نیست. یک
کاربرد رایج برای این نوع پرس‌وجو، بررسی رزرو بودن یک
آدرس مشخص است. پرس‌وجوی دوم از شناسه‌ها استفاده می‌کند. برای
بیشترین انعطاف‌پذیری، Kea اطلاعات شناسایی میزبان را به صورت یک
جفت مقدار ذخیره می‌کند: نوع و شناسه واقعی. شناسه‌هایی که در حال حاضر
پشتیبانی می‌شوند عبارتند از \fB\(dqhw\-address\(dq\fP، \fB\(dqduid\(dq\fP، \fB\(dqcircuit\-id\(dq\fP، \fB\(dqclient\-id\(dq\fP و
\fB\(dqflex\-id\(dq\fP\&. مقدار \fBsubnet\-id\fP اجباری است. برای
دریافت یک رزرو سراسری، از مقدار صفر (0) استفاده کنید، یا شناسه زیرشبکه‌ای که
رزرو متعلق به آن است را وارد نمایید.
.sp
یک نمونه دستور برای دریافت رزرو میزبان با یک جفت (\fBsubnet\-id\fP,
\fBaddress\fP) به صورت زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqreservation\-get\(dq,
    \(dqarguments\(dq: {
        \(dqsubnet\-id\(dq: 1,
        \(dqip\-address\(dq: \(dq192.0.2.202\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
یک نمونه پرس‌وجو بر اساس (\fBsubnet\-id\fP, \fBidentifier\-type\fP, \fBidentifier\fP) به
صورت زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqreservation\-get\(dq,
    \(dqarguments\(dq: {
        \(dqsubnet\-id\(dq: 4,
        \(dqidentifier\-type\(dq: \(dqhw\-address\(dq,
        \(dqidentifier\(dq: \(dq01:02:03:04:05:06\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور آرگومان \fBoperation\-target\fP را می‌پذیرد. به طور پیش‌فرض،
رزرو را هم از حافظه موقت و هم از پایگاه‌داده میزبان‌ها دریافت می‌کند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqreservation\-get\(dq,
    \(dqarguments\(dq: {
        \(dqsubnet\-id\(dq: 1,
        \(dqip\-address\(dq: \(dq192.0.2.202\(dq,
        \(dqoperation\-target\(dq: \(dqdatabase\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
دستور \fBreservation\-get\fP معمولاً هنگامی که یک پرس‌وجو به درستی
انجام شده باشد نتیجه 0 را برمی‌گرداند. به ویژه، زمانی که میزبان پیدا
نشود، مقدار 0 بازگردانده می‌شود. اگر پرس‌وجو موفقیت‌آمیز باشد، پارامترهای
میزبان بازگردانده می‌شوند. نمونه‌ای از پرس‌وجویی که میزبان را پیدا نکرده است به
صورت زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{ \(dqresult\(dq: 0, \(dqtext\(dq: \(dqHost not found.\(dq }
.EE
.UNINDENT
.UNINDENT
.sp
در اینجا نمونه‌ای از نتیجه بازگردانده شده در صورت یافتن موفقیت‌آمیز میزبان آمده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqarguments\(dq: {
    \(dqboot\-file\-name\(dq: \(dqbootfile.efi\(dq,
    \(dqclient\-classes\(dq: [

    ],
    \(dqhostname\(dq: \(dqsomehost.example.org\(dq,
    \(dqhw\-address\(dq: \(dq01:02:03:04:05:06\(dq,
    \(dqip\-address\(dq: \(dq192.0.2.100\(dq,
    \(dqnext\-server\(dq: \(dq192.0.0.2\(dq,
    \(dqoption\-data\(dq: [

    ],
    \(dqserver\-hostname\(dq: \(dqserver\-hostname.example.org\(dq,
    \(dqsubnet\-id\(dq: 4
  },
  \(dqresult\(dq: 0,
  \(dqtext\(dq: \(dqHost found.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نمونه نتیجه بازگردانده شده در زمانی که پرس‌وجو ساختار نادرستی داشته باشد ممکن است به این شکل باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{ \(dqresult\(dq: 1, \(dqtext\(dq: \(dqNo \(aqip\-address\(aq provided and \(aqidentifier\-type\(aq is either missing or not a string.\(dq }
.EE
.UNINDENT
.UNINDENT.SS دستور \fBreservation\-get\-all\fP
.sp
\fBreservation\-get\-all\fP می‌تواند برای پرس‌وجو از پایگاه‌دادهٔ میزبان و
دریافت تمام رزروها در یک زیرشبکهٔ مشخص به کار رود. این دستور از
پارامترهایی استفاده می‌کند که \fBsubnet\-id\fP اجباری را فراهم می‌کنند\&. رزروهای سراسری میزبان
می‌توانند با استفاده از مقدار صفر (0) برای \fBsubnet\-id\fP دریافت شوند.
.sp
برای نمونه، دریافت رزروهای میزبان برای زیرشبکهٔ 1:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqreservation\-get\-all\(dq,
    \(dqarguments\(dq: {
        \(dqsubnet\-id\(dq: 1
     }
}
.EE
.UNINDENT
.UNINDENT
.sp
برخی میزبان‌های IPv4 را برمی‌گرداند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqarguments\(dq: {
        \(dqhosts\(dq: [
            {
                \(dqboot\-file\-name\(dq: \(dqbootfile.efi\(dq,
                \(dqclient\-classes\(dq: [ ],
                \(dqhostname\(dq: \(dqsomehost.example.org\(dq,
                \(dqhw\-address\(dq: \(dq01:02:03:04:05:06\(dq,
                \(dqip\-address\(dq: \(dq192.0.2.100\(dq,
                \(dqnext\-server\(dq: \(dq192.0.0.2\(dq,
                \(dqoption\-data\(dq: [ ],
                \(dqserver\-hostname\(dq: \(dqserver\-hostname.example.org\(dq,
                \(dqsubnet\-id\(dq: 1
            },
            {
                \(dqboot\-file\-name\(dq: \(dqbootfile.efi\(dq,
                \(dqclient\-classes\(dq: [ ],
                \(dqhostname\(dq: \(dqotherhost.example.org\(dq,
                \(dqhw\-address\(dq: \(dq01:02:03:04:05:ff\(dq,
                \(dqip\-address\(dq: \(dq192.0.2.200\(dq,
                \(dqnext\-server\(dq: \(dq192.0.0.2\(dq,
                \(dqoption\-data\(dq: [ ],
                \(dqserver\-hostname\(dq: \(dqserver\-hostname.example.org\(dq,
                \(dqsubnet\-id\(dq: 1
            },
            ...
        ]
    },
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq72 IPv4 host(s) found.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ بازگردانده‌شده توسط \fBreservation\-get\-all\fP می‌تواند بسیار طولانی باشد. سرور
DHCP هنگام آماده‌سازی پاسخ برای \fBreservation\-get\-all\fP ترافیک DHCP را پردازش نمی‌کند،
بنابراین اگر رزروهای زیادی در یک زیرشبکه وجود داشته باشد، این کار ممکن است
مختل‌کننده باشد؛ با احتیاط استفاده کنید. برای استقرارهای بزرگ‌تر، لطفاً استفاده از
\fBreservation\-get\-page\fP را به عنوان جایگزین در نظر بگیرید.
.sp
این دستور آرگومان \fBoperation\-target\fP را می‌پذیرد. به‌طور پیش‌فرض، رزروها را
از هر دو حافظهٔ مقیم و پایگاه‌دادهٔ میزبان‌ها دریافت می‌کند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqreservation\-get\-all\(dq,
    \(dqarguments\(dq: {
        \(dqsubnet\-id\(dq: 1,
        \(dqoperation\-target\(dq: \(dqdatabase\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
برای اطلاعات بیشتر، «دستور reservation\-get\-all» را ببینید\&.
.SS دستور \fBreservation\-get\-page\fP
.sp
\fBreservation\-get\-page\fP می‌تواند برای پرس‌وجو از پایگاه‌دادهٔ میزبان و
دریافت تمام رزروها در یک زیرشبکهٔ مشخص، به‌صورت صفحه‌بندی‌شده به کار رود. این دستور
از پارامترهایی استفاده می‌کند که \fBsubnet\-id\fP اجباری را فراهم می‌کنند\&. برای دریافت رزروهای
سراسری از مقدار صفر (0) استفاده کنید. دومین پارامتر اجباری، حد اندازهٔ صفحه است. پارامترهای اختیاری
\fBsource\-index\fP و \fBfrom\-host\-id\fP که هر دو به‌طور پیش‌فرض 0 هستند، برای زنجیره‌سازی
پرسمان‌های صفحه‌ای استفاده می‌شوند.
از نسخهٔ 1.9.0 نرم‌افزار Kea، پارامتر \fBsubnet\-id\fP اختیاری است.
.sp
استفاده از پارامترهای \fBfrom\fP و \fBsource\-index\fP نیازمند توضیحات بیشتری است.
برای فراخوانی اول، نباید این پارامترها مشخص شوند (یا باید صفر تعیین شوند). برای هرگونه
فراخوانی بعدی، آنها باید روی مقادیر بازگردانده‌شده در فراخوانی‌های قبلی در نگاشت next شامل مقادیر
\fBfrom\fP و \fBsource\-index\fP تنظیم گردند. فراخوانی‌های بعدی باید تا زمانی که همهٔ
رزروها برگردانده شوند، ارسال گردند. پایان زمانی حاصل می‌شود که فهرست بازگردانده‌شده
خالی باشد، تعداد 0 باشد، هیچ نگاشت next وجود نداشته باشد، و وضعیت نتیجهٔ 3 (empty)
بازگردانده شود.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
پارامترهای \fBfrom\fP و \fBsource\-index\fP بازتاب‌دهندهٔ وضعیت درونی
جست‌وجو هستند. نیازی به درک معنای آن‌ها نیست؛ تنها مقداری هستند که
باید از یک پاسخ به پرسمان بعدی کپی شوند. با این حال، برای علاقه‌مندان، فیلد \fBfrom\fP یک
نمایش ۶۴ بیتی از شناسهٔ میزبان است که توسط یک بک‌اند میزبان استفاده می‌شود. فیلد
\fBsource\-index\fP یک نمایش درونی از چندین بک‌اند میزبان است: 0 برای نشان دادن
میزبان‌های تعریف‌شده در یک فایل پیکربندی به کار می‌رود، و 1 نشان‌دهندهٔ نخستین بک‌اند پایگاه‌داده است.
در برخی موارد نادر ممکن است بیش از یک بک‌اند پایگاه‌داده پیکربندی شده باشد، بنابراین
احتمالاً مقدار 2 نیز وجود دارد. در هر صورت، Kea روی تمام بک‌اندهای پیکربندی‌شده پیمایش می‌کند.
.UNINDENT
.UNINDENT
.sp
برای نمونه، دریافت رزروهای میزبان برای زیرشبکهٔ 1 و
درخواست صفحهٔ نخست می‌تواند به این صورت انجام شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqreservation\-get\-page\(dq,
    \(dqarguments\(dq: {
        \(dqsubnet\-id\(dq: 1,
        \(dqlimit\(dq: 10
     }
}
.EE
.UNINDENT
.UNINDENT
.sp
از آنجا که این اولین فراخوانی است، \fBsource\-index\fP و \fBfrom\fP نباید
مشخص شوند. آن‌ها روی مقادیر پیش‌فرض صفر خود تنظیم شده‌اند.
.sp
تعدادی میزبان همراه با اطلاعات برای دریافت صفحهٔ بعدی بازگردانده می‌شوند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqarguments\(dq: {
        \(dqcount\(dq: 72,
        \(dqhosts\(dq: [
            {
                \(dqboot\-file\-name\(dq: \(dqbootfile.efi\(dq,
                \(dqclient\-classes\(dq: [ ],
                \(dqhostname\(dq: \(dqsomehost.example.org\(dq,
                \(dqhw\-address\(dq: \(dq01:02:03:04:05:06\(dq,
                \(dqip\-address\(dq: \(dq192.0.2.100\(dq,
                \(dqnext\-server\(dq: \(dq192.0.0.2\(dq,
                \(dqoption\-data\(dq: [ ],
                \(dqserver\-hostname\(dq: \(dqserver\-hostname.example.org\(dq
            },
            {
                \(dqboot\-file\-name\(dq: \(dqbootfile.efi\(dq,
                \(dqclient\-classes\(dq: [ ],
                \(dqhostname\(dq: \(dqotherhost.example.org\(dq,
                \(dqhw\-address\(dq: \(dq01:02:03:04:05:ff\(dq,
                \(dqip\-address\(dq: \(dq192.0.2.200\(dq,
                \(dqnext\-server\(dq: \(dq192.0.0.2\(dq,
                \(dqoption\-data\(dq: [ ],
                \(dqserver\-hostname\(dq: \(dqserver\-hostname.example.org\(dq
            },
            ...
        ],
        \(dqnext\(dq: {
            \(dqfrom\(dq: 1234567,
            \(dqsource\-index\(dq: 1
        }
    },
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq72 IPv4 host(s) found.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
توجه داشته باشید که فیلدهای \fBfrom\fP و \fBsource\-index\fP در پاسخ، داخل
نگاشت next مشخص شده‌اند. این دو باید در دستور بعدی کپی شوند تا Kea
کار را از همان جایی که دستور قبلی به پایان رسید ادامه دهد. برای دریافت
صفحهٔ بعدی دستور زیر می‌تواند ارسال شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqreservation\-get\-page\(dq,
    \(dqarguments\(dq: {
        \(dqsubnet\-id\(dq: 1,
        \(dqsource\-index\(dq: 1,
        \(dqfrom\(dq: 1234567,
        \(dqlimit\(dq: 10
     }
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ شامل فهرستی از میزبان‌ها با فیلدهای به‌روزشدهٔ \fBsource\-index\fP
و \fBfrom\fP خواهد بود. فراخوانی دستور را ادامه دهید تا آخرین
صفحه دریافت شود. پاسخ آن به این شکل خواهد بود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqarguments\(dq: {
        \(dqcount\(dq: 0,
        \(dqhosts\(dq: [ ]
    },
    \(dqresult\(dq: 3,
    \(dqtext\(dq: \(dq0 IPv4 host(s) found.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور آرگومان \fBoperation\-target\fP را نمی‌پذیرد.
.sp
این دستور پیچیده‌تر از \fBreservation\-get\-all\fP است، اما به کاربران اجازه می‌دهد
فهرست‌های بزرگ‌تر رزرو میزبان را در بخش‌های کوچک‌تر دریافت کنند. برای
استقرارهای کوچک با رزروهای اندک، استفاده از \fBreservation\-get\-all\fP ساده‌تر است\&..SS دستور \fBreservation\-get\-by\-address\fP
.sp
دستور \fBreservation\-get\-by\-address\fP می‌تواند برای پرس‌وجو از پایگاه داده میزبان و دریافت تمام رزروها برای یک نشانی IP مشخص یا یک پیشوند واگذارشده (بدون طول پیشوند)، در یک زیرشبکه تعیین‌شده یا در تمامی زیرشبکه‌ها استفاده شود. این دستور از پارامترهایی استفاده می‌کند که پارامتر اجباری \fBip\-address\fP و پارامترهای اختیاری \fBsubnet\-id\fP و \fBoperation\-target\fP را فراهم می‌آورند\&.
.sp
به عنوان مثال، دریافت رزروهای میزبان برای نشانی IPv4 با مقدار \(dq192.0.200.181\(dq در زیرشبکه ۱:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqreservation\-get\-by\-address\(dq,
    \(dqarguments\(dq: {
        \(dqip\-address\(dq: \(dq192.0.200.181\(dq,
        \(dqsubnet\-id\(dq: 1
    },
    \(dqservice\(dq: [
        \(dqdhcp4\(dq
    ]
}
.EE
.UNINDENT
.UNINDENT
.sp
می‌تواند دو میزبان IPv4 را بازگرداند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqarguments\(dq: {
        \(dqhosts\(dq: [
            {
                \(dqboot\-file\-name\(dq: \(dq\(dq,
                \(dqclient\-classes\(dq: [],
                \(dqhostname\(dq: \(dq\(dq,
                \(dqhw\-address\(dq: \(dq99:99:99:99:99:01\(dq,
                \(dqip\-address\(dq: \(dq192.0.200.181\(dq,
                \(dqnext\-server\(dq: \(dq0.0.0.0\(dq,
                \(dqoption\-data\(dq: [],
                \(dqserver\-hostname\(dq: \(dq\(dq,
                \(dqsubnet\-id\(dq: 1
            },
            {
                \(dqboot\-file\-name\(dq: \(dq\(dq,
                \(dqcircuit\-id\(dq: \(dq1234\(dq,
                \(dqclient\-classes\(dq: [],
                \(dqhostname\(dq: \(dq\(dq,
                \(dqip\-address\(dq: \(dq192.0.200.181\(dq,
                \(dqnext\-server\(dq: \(dq0.0.0.0\(dq,
                \(dqoption\-data\(dq: [],
                \(dqserver\-hostname\(dq: \(dq\(dq,
                \(dqsubnet\-id\(dq: 1
            }
        ]
    },
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq2 IPv4 host(s) found.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
برای جستجوی تمامی رزروها در همه زیرشبکه‌ها، کافی است از پارامتر \fBsubnet\-id\fP صرف‌نظر کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqreservation\-get\-by\-address\(dq,
    \(dqarguments\(dq: {
        \(dqip\-address\(dq: \(dq192.0.200.181\(dq
    },
    \(dqservice\(dq: [
        \(dqdhcp4\(dq
    ]
}
.EE
.UNINDENT
.UNINDENT
.sp
یک نمونه پاسخ می‌تواند به این صورت باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqarguments\(dq: {
        \(dqhosts\(dq: [
            {
                \(dqboot\-file\-name\(dq: \(dq\(dq,
                \(dqclient\-classes\(dq: [],
                \(dqhostname\(dq: \(dq\(dq,
                \(dqhw\-address\(dq: \(dq99:99:99:99:99:02\(dq,
                \(dqip\-address\(dq: \(dq192.0.200.181\(dq,
                \(dqnext\-server\(dq: \(dq0.0.0.0\(dq,
                \(dqoption\-data\(dq: [],
                \(dqserver\-hostname\(dq: \(dq\(dq,
                \(dqsubnet\-id\(dq: 1
            },
            {
                \(dqboot\-file\-name\(dq: \(dq\(dq,
                \(dqcircuit\-id\(dq: \(dq1234\(dq,
                \(dqclient\-classes\(dq: [],
                \(dqhostname\(dq: \(dq\(dq,
                \(dqip\-address\(dq: \(dq192.0.200.181\(dq,
                \(dqnext\-server\(dq: \(dq0.0.0.0\(dq,
                \(dqoption\-data\(dq: [],
                \(dqserver\-hostname\(dq: \(dq\(dq,
                \(dqsubnet\-id\(dq: 1
            },
            {
                \(dqboot\-file\-name\(dq: \(dq\(dq,
                \(dqclient\-classes\(dq: [],
                \(dqhostname\(dq: \(dq\(dq,
                \(dqhw\-address\(dq: \(dq99:99:99:99:99:02\(dq,
                \(dqip\-address\(dq: \(dq192.0.200.181\(dq,
                \(dqnext\-server\(dq: \(dq0.0.0.0\(dq,
                \(dqoption\-data\(dq: [],
                \(dqserver\-hostname\(dq: \(dq\(dq,
                \(dqsubnet\-id\(dq: 0
            },
            {
                \(dqboot\-file\-name\(dq: \(dq\(dq,
                \(dqclient\-classes\(dq: [],
                \(dqhostname\(dq: \(dq\(dq,
                \(dqhw\-address\(dq: \(dq99:99:99:99:99:03\(dq,
                \(dqip\-address\(dq: \(dq192.0.200.181\(dq,
                \(dqnext\-server\(dq: \(dq0.0.0.0\(dq,
                \(dqoption\-data\(dq: [],
                \(dqserver\-hostname\(dq: \(dq\(dq,
                \(dqsubnet\-id\(dq: 2
            }
        ]
    },
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq4 IPv4 host(s) found.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
هنگام استفاده از این دستور برای دریافت رزروهای میزبان DHCP6، می‌توان یک نشانی IPv6 یا یک پیشوند واگذارشده (delegated prefix) را به عنوان پارامتر \fBip\-address\fP ارائه داد. لطفاً توجه داشته باشید که این دستور در پیاده‌سازی فعلی طول پیشوند را به عنوان پارامتر نمی‌پذیرد. بنابراین، جستجو بر اساس نشانی IP مانند \fB2001:db8:2:cafe::\fP می‌تواند رزروهای میزبانی با پیشوندهای واگذارشده با طول‌های متفاوتی که با این جستجو مطابقت دارند را برگرداند. برای مثال: \fB2001:db8:2:cafe::/63\fP، \fB2001:db8:2:cafe::/64\fP و غیره. لطفاً مثال زیر را در نظر بگیرید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqreservation\-get\-by\-address\(dq,
    \(dqarguments\(dq: {
        \(dqip\-address\(dq: \(dq2001:db8:2:cafa::\(dq
    },
    \(dqservice\(dq: [
        \(dqdhcp6\(dq
    ]
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqarguments\(dq: {
        \(dqhosts\(dq: [
            {
                \(dqclient\-classes\(dq: [],
                \(dqduid\(dq: \(dq01:02:03:04:05:06:07:88:98:fa\(dq,
                \(dqhostname\(dq: \(dqfoo.example.com\(dq,
                \(dqip\-addresses\(dq: [
                    \(dq2001:db8:1:cafe::2\(dq
                ],
                \(dqoption\-data\(dq: [],
                \(dqprefixes\(dq: [
                    \(dq2001:db8:2:abcd::/64\(dq,
                    \(dq2001:db8:2:cafa::/63\(dq
                ],
                \(dqsubnet\-id\(dq: 8
            },
            {
                \(dqclient\-classes\(dq: [],
                \(dqduid\(dq: \(dq01:02:03:04:05:06:07:88:98:fb\(dq,
                \(dqhostname\(dq: \(dqfoo.example.com\(dq,
                \(dqip\-addresses\(dq: [
                    \(dq2001:db8:1:cafe::2\(dq
                ],
                \(dqoption\-data\(dq: [],
                \(dqprefixes\(dq: [
                    \(dq2001:db8:2:abcd::/64\(dq,
                    \(dq2001:db8:2:cafa::/64\(dq
                ],
                \(dqsubnet\-id\(dq: 8
            }
        ]
    },
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq2 IPv6 host(s) found.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور آرگومان \fBoperation\-target\fP را می‌پذیرد. به طور پیش‌فرض، این دستور رزرو را هم از فضای ذخیره‌سازی در حافظه (in-memory) و هم از پایگاه داده میزبان‌ها دریافت می‌کند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqreservation\-get\-by\-address\(dq,
    \(dqarguments\(dq: {
        \(dqip\-address\(dq: \(dq192.0.200.181\(dq,
        \(dqsubnet\-id\(dq: 1,
        \(dqoperation\-target\(dq: \(dqdatabase\(dq
    },
    \(dqservice\(dq: [
        \(dqdhcp4\(dq
    ]
}
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این دستور در موارد خاصی کاربرد دارد. به طور پیش‌فرض، داشتن بیش از یک رزرو میزبان برای یک نشانی IP یکسان در یک زیرشبکه معین مجاز نیست؛ همان‌طور که در
Multiple Reservations for the Same IPv4 \%<#\:multiple-reservations-same-ip4>
یا
Multiple Reservations for the Same IPv6 \%<#\:multiple-reservations-same-ip6>\&
توضیح داده شده است. به همین دلیل این دستور زمانی به کار می‌آید که پارامتر بولی \fBip\-reservations\-unique\fP روی \fBfalse\fP تنظیم شده باشد\&. کاربرد دیگر این دستور در زمان وجود زیرشبکه‌های دارای هم‌پوشانی با رزروهای نشانی IP یکسان (اما با شناسه‌های متفاوت) در زیرشبکه‌های مختلف است.
.UNINDENT
.UNINDENT.SS دستور \fBreservation\-get\-by\-hostname\fP
.sp
از \fBreservation\-get\-by\-hostname\fP می‌توان برای پرس‌وجو در پایگاه دادهٔ میزبان و
واکشی تمام رزروها با یک نام میزبان مشخص یا در
یک زیرشبکهٔ تعیین‌شده استفاده کرد. این دستور از پارامترهایی استفاده می‌کند که \fBhostname\fP
اجباری و \fBsubnet\-id\fP اختیاری را فراهم می‌کنند\&. رزروهای سراسری میزبان را
می‌توان با استفاده از مقدار صفر (0) برای \fBsubnet\-id\fP واکشی کرد.
تطابق نام میزبان به بزرگی و کوچکی حروف حساس نیست.
.sp
برای نمونه، واکشی رزروهای میزبان برای \(dqfoobar\(dq در زیرشبکهٔ 1:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqreservation\-get\-by\-hostname\(dq,
    \(dqarguments\(dq: {
        \(dqhostname\(dq: \(dqfoobar.example.org\(dq,
        \(dqsubnet\-id\(dq: 1
     }
}
.EE
.UNINDENT
.UNINDENT
.sp
برخی از میزبان‌های IPv4 را بازمی‌گرداند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqarguments\(dq: {
        \(dqhosts\(dq: [
            {
                \(dqboot\-file\-name\(dq: \(dqbootfile.efi\(dq,
                \(dqclient\-classes\(dq: [ ],
                \(dqhostname\(dq: \(dqfoobar.example.org\(dq,
                \(dqhw\-address\(dq: \(dq01:02:03:04:05:06\(dq,
                \(dqip\-address\(dq: \(dq192.0.2.100\(dq,
                \(dqnext\-server\(dq: \(dq192.0.0.2\(dq,
                \(dqoption\-data\(dq: [ ],
                \(dqserver\-hostname\(dq: \(dqserver\-hostname.example.org\(dq
            },
            {
                \(dqboot\-file\-name\(dq: \(dqbootfile.efi\(dq,
                \(dqclient\-classes\(dq: [ ],
                \(dqhostname\(dq: \(dqfoobar.example.org\(dq,
                \(dqhw\-address\(dq: \(dq01:02:03:04:05:ff\(dq,
                \(dqip\-address\(dq: \(dq192.0.2.200\(dq,
                \(dqnext\-server\(dq: \(dq192.0.0.2\(dq,
                \(dqoption\-data\(dq: [ ],
                \(dqserver\-hostname\(dq: \(dqserver\-hostname.example.org\(dq
            },
            ...
        ]
    },
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq5 IPv4 host(s) found.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ بازگردانده شده توسط \fBreservation\-get\-by\-hostname\fP می‌تواند طولانی باشد،
به‌ویژه زمانی که پاسخ‌ها به یک زیرشبکه محدود نشده باشند.
.sp
این دستور آرگومان \fBoperation\-target\fP را می‌پذیرد. به‌طور پیش‌فرض، رزرو را
هم از حافظهٔ موقت و هم از پایگاه دادهٔ میزبان‌ها دریافت می‌کند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqreservation\-get\-by\-hostname\(dq,
    \(dqarguments\(dq: {
        \(dqhostname\(dq: \(dqfoobar.example.org\(dq,
        \(dqsubnet\-id\(dq: 1,
        \(dqoperation\-target\(dq: \(dqdatabase\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
برای اطلاعات بیشتر، بخش دستور reservation\-get\-by\-hostname را ببینید\&.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
هنگام استفاده از MySQL به‌عنوان بک‌اند میزبان، این دستور به این موضوع متکی است
که ستون hostname در جدول hosts از یک چینش (collation) غیرحساس به حروف بزرگ و کوچک
استفاده می‌کند، همان‌طور که در بخش MySQL \%<#\:mysql-database> از
مستندات Kea Database Administration \%<#\:admin> توضیح داده شده است\&.
.UNINDENT
.UNINDENT
.SS دستور \fBreservation\-get\-by\-id\fP
.sp
از \fBreservation\-get\-by\-id\fP می‌توان برای پرس‌وجو در پایگاه دادهٔ میزبان و
واکشی تمام رزروها با یک شناسه‌گر مشخص (پارامترهای \fBidentifier\-type\fP
و \fBidentifier\fP)، مستقل از زیرشبکه‌ها استفاده کرد. ساختار نحوی
پارامترها همانند دستور \fBreservation\-get\fP است\&.
برای جلوگیری از سردرگمی، امکان استفاده از پارامتر \fBsubnet\-id\fP وجود ندارد.
این دستور از نسخهٔ 1.9.0 در Kea در دسترس است.
.sp
برای نمونه، واکشی رزروهای میزبان برای نشانی مک 01:02:03:04:05:06:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqreservation\-get\-by\-id\(dq,
    \(dqarguments\(dq: {
        \(dqidentifier\-type\(dq: \(dqhw\-address\(dq,
        \(dqidentifier\(dq: \(dq01:02:03:04:05:06\(dq
     }
 }
.EE
.UNINDENT
.UNINDENT
.sp
برخی از میزبان‌های IPv4 را بازمی‌گرداند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqarguments\(dq: {
        \(dqhosts\(dq: [
            {
                \(dqboot\-file\-name\(dq: \(dqbootfile.efi\(dq,
                \(dqclient\-classes\(dq: [ ],
                \(dqhostname\(dq: \(dqfoo.example.org\(dq,
                \(dqhw\-address\(dq: \(dq01:02:03:04:05:06\(dq,
                \(dqip\-address\(dq: \(dq192.0.2.100\(dq,
                \(dqnext\-server\(dq: \(dq192.0.0.2\(dq,
                \(dqoption\-data\(dq: [ ],
                \(dqserver\-hostname\(dq: \(dqserver\-hostname.example.org\(dq,
                \(dqsubnet\-id\(dq: 123
            },
            {
                \(dqboot\-file\-name\(dq: \(dqbootfile.efi\(dq,
                \(dqclient\-classes\(dq: [ ],
                \(dqhostname\(dq: \(dqbar.example.org\(dq,
                \(dqhw\-address\(dq: \(dq01:02:03:04:05:06\(dq,
                \(dqip\-address\(dq: \(dq192.0.2.200\(dq,
                \(dqnext\-server\(dq: \(dq192.0.0.2\(dq,
                \(dqoption\-data\(dq: [ ],
                \(dqserver\-hostname\(dq: \(dqserver\-hostname.example.org\(dq,
                \(dqsubnet\-id\(dq: 345
            },
            ...
        ]
    },
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq5 IPv4 host(s) found.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ بازگردانده شده توسط \fBreservation\-get\-by\-id\fP می‌تواند طولانی باشد،
به‌ویژه زمانی که پاسخ‌ها به یک زیرشبکه محدود نشده باشند.
.sp
این دستور آرگومان \fBoperation\-target\fP را می‌پذیرد. به‌طور پیش‌فرض، رزرو را
هم از حافظهٔ موقت و هم از پایگاه دادهٔ میزبان‌ها واکشی می‌کند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqreservation\-get\-by\-id\(dq,
    \(dqarguments\(dq: {
        \(dqidentifier\-type\(dq: \(dqhw\-address\(dq,
        \(dqidentifier\(dq: \(dq01:02:03:04:05:06\(dq,
        \(dqoperation\-target\(dq: \(dqdatabase\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
برای اطلاعات بیشتر، بخش دستور reservation\-get\-by\-id را ببینید\&..SS دستور \fBreservation\-del\fP
.sp
دستور \fBreservation\-del\fP می‌تواند برای حذف یک رزرو از پایگاه‌داده میزبان‌ها و/یا پیکربندی JSON استفاده شود. این دستور از دو نوع پارامتر پشتیبانی می‌کند:
(\fBsubnet\-id\fP, \fBaddress\fP) یا (\fBsubnet\-id\fP, \fBidentifier\-type\fP, \fBidentifier\fP).
نوع اول پرس‌وجو زمانی استفاده می‌شود که آدرس (خواه IPv4 یا IPv6) مشخص است، اما جزئیات رزرو مشخص نیست. یکی از کاربردهای رایج این نوع پرس‌وجو، حذف یک رزرو است (به عنوان مثال، یک آدرس مشخص دیگر نباید رزرو بماند). پرس‌وجوی دوم از شناسه‌ها استفاده می‌کند.
برای حداکثر انعطاف‌پذیری، Kea اطلاعات شناسایی میزبان را به صورت یک جفت مقدار ذخیره می‌کند: نوع و شناسه واقعی. شناسه‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از \fB\(dqhw\-address\(dq\fP، \fB\(dqduid\(dq\fP، \fB\(dqcircuit\-id\(dq\fP، \fB\(dqclient\-id\(dq\fP و
\fB\(dqflex\-id\(dq\fP\&. مقدار \fBsubnet\-id\fP الزامی است. از مقدار صفر (0) برای حذف یک رزرو سراسری (global)، یا شناسه زیرشبکه‌ای که رزرو باید از آن حذف شود، استفاده کنید.
.sp
یک نمونه دستور برای حذف یک رزرو میزبان با جفت (\fBsubnet\-id\fP,
\fBaddress\fP) به صورت زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqreservation\-del\(dq,
    \(dqarguments\(dq: {
        \(dqsubnet\-id\(dq: 1,
        \(dqip\-address\(dq: \(dq192.0.2.202\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
یک نمونه حذف بر اساس (\fBsubnet\-id\fP, \fBidentifier\-type\fP, \fBidentifier\fP) به صورت زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqreservation\-del\(dq,
    \(dqarguments\(dq: {
        \(dqsubnet\-id\(dq: 4,
        \(dqidentifier\-type\(dq: \(dqhw\-address\(dq,
        \(dqidentifier\(dq: \(dq01:02:03:04:05:06\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
دستور \fBreservation\-del\fP در صورت موفقیت‌آمیز بودن حذف میزبان مقدار 0، و در صورت شکست مقدار 1 را برمی‌گرداند. در صورت بروز خطا، متن توضیحی ارائه می‌شود. در اینجا چند نمونه از نتایج احتمالی آورده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 1,
    \(dqtext\(dq: \(dqHost not deleted (not found).\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
یا
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqHost deleted.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
یا
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 1,
    \(dqtext\(dq: \(dqUnable to delete a host because there is no hosts\-database configured.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور آرگومان \fBoperation\-target\fP را می‌پذیرد. به طور پیش‌فرض، رزرو را فقط از پایگاه‌داده میزبان‌ها حذف می‌کند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqreservation\-del\(dq,
    \(dqarguments\(dq: {
        \(dqsubnet\-id\(dq: 4,
        \(dqidentifier\-type\(dq: \(dqhw\-address\(dq,
        \(dqidentifier\(dq: \(dq01:02:03:04:05:06\(dq,
        \(dqoperation\-target\(dq: \(dqmemory\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.SS دستور \fBreservation\-update\fP
.sp
دستور \fBreservation\-update\fP امکان به‌روزرسانی یک میزبان موجود را فراهم می‌کند. این دستور همان مجموعه آرگومان‌های \fBreservation\-add\fP را دریافت می‌کند و همچنین برای شناسایی میزبانی که به‌روزرسانی می‌شود، به یک شناسه میزبان و یک شناسه زیرشبکه (subnet ID) نیاز دارد. این دستور می‌تواند به سادگیِ داشتن تنها دو مدخل الزامی باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqreservation\-update\(dq,
    \(dqarguments\(dq: {
        \(dqreservation\(dq: {
            \(dqsubnet\-id\(dq: 1,
            \(dqhw\-address\(dq: \(dq1a:1b:1c:1d:1e:1f\(dq
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
با این حال، در این حالت هیچ منبعی به میزبان اختصاص داده نمی‌شود. یک آدرس IPv4 را می‌توان مانند این مثال اختصاص داد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqreservation\-update\(dq,
    \(dqarguments\(dq: {
        \(dqreservation\(dq: {
            \(dqsubnet\-id\(dq: 1,
            \(dqhw\-address\(dq: \(dq1a:1b:1c:1d:1e:1f\(dq,
            \(dqip\-address\(dq: \(dq192.0.2.202\(dq
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
همچنین می‌تواند پارامترهای بسیار بیشتری را بپذیرد، مانند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqreservation\-update\(dq,
    \(dqarguments\(dq: {
        \(dqreservation\(dq: {
            \(dqsubnet\-id\(dq: 1,
            \(dqclient\-id\(dq: \(dq01:0a:0b:0c:0d:0e:0f\(dq,
            \(dqip\-address\(dq: \(dq192.0.2.205\(dq,
            \(dqnext\-server\(dq: \(dq192.0.2.1\(dq,
            \(dqserver\-hostname\(dq: \(dqhal9000\(dq,
            \(dqboot\-file\-name\(dq: \(dq/dev/null\(dq,
            \(dqoption\-data\(dq: [
                {
                    \(dqname\(dq: \(dqdomain\-name\-servers\(dq,
                    \(dqdata\(dq: \(dq10.1.1.202,10.1.1.203\(dq
                }
            ],
            \(dqclient\-classes\(dq: [
                \(dqoffice\(dq,
                \(dqspecial_snowflake\(dq
            ]
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
در اینجا نمونه‌ای از یک به‌روزرسانی رزرو پیچیده IPv6 آورده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqreservation\-update\(dq,
    \(dqarguments\(dq: {
        \(dqreservation\(dq: {
            \(dqsubnet\-id\(dq: 1,
            \(dqduid\(dq: \(dq01:02:03:04:05:06:07:08:09:0A\(dq,
            \(dqip\-addresses\(dq: [
                \(dq2001:db8:1:cafe::1\(dq
            ],
            \(dqprefixes\(dq: [
                \(dq2001:db8:2:abcd::/64\(dq
            ],
            \(dqhostname\(dq: \(dqfoo.example.com\(dq,
            \(dqoption\-data\(dq: [
                {
                    \(dqname\(dq: \(dqvendor\-opts\(dq,
                    \(dqdata\(dq: \(dq4491\(dq
                },
                {
                    \(dqname\(dq: \(dqtftp\-servers\(dq,
                    \(dqspace\(dq: \(dqvendor\-4491\(dq,
                    \(dqdata\(dq: \(dq3000:1::234\(dq
                }
            ]
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
دستور وضعیتی را بازمی‌گرداند که نشان‌دهنده موفقیت (نتیجه \fB0\fP) یا
شکست (نتیجه \fB1\fP) است، و یک پارامتر متنی که موفقیت را تأیید کرده یا
علت شکست را توضیح می‌دهد. در اینجا نمونه‌ای از یک به‌روزرسانی موفق آورده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqHost updated.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
و در اینجا نمونه‌ای از یک شکست آمده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 1,
    \(dqtext\(dq: \(dqMandatory \(aqsubnet\-id\(aq parameter missing.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور آرگومان \fBoperation\-target\fP را می‌پذیرد. به طور پیش‌فرض، رزرو را تنها به پایگاه‌داده میزبان‌ها اضافه می‌کند. از آنجا که انتظار می‌رود \fBreservation\-update\fP میزبان را ذخیره کند، پارامتر \fBhosts\-databases\fP باید در پیکربندی مشخص شده باشد، و اگر هدف عملیات پیکربندی JSON نباشد، پایگاه‌های داده نباید در حالت فقط‌خواندنی (read\-only) اجرا شوند.
.sp
همانند سایر دستورهای به‌روزرسانی و تنظیم، این دستور تمام محتویات مدخل را بازنویسی می‌کند. اگر میزبان قبلاً منبعی به آن اختصاص داده شده بود و دستور \fBreservation\-update\fP فاقد آن منبع باشد، آن منبع از پایگاه‌داده حذف می‌شود. اگر به‌روزرسانی افزایشی میزبان مد نظر باشد، این امر می‌تواند با اجرای دستور \fBreservation\-get\-by\-id\fP برای دریافت وضعیت فعلی میزبان، انتخاب میزبان از پاسخ، اصلاح آن به نتیجه مورد نظر و سپس اجرای دستور \fBreservation\-update\fP به همراه میزبان حاصل انجام گیرد..SS نکات کلی (General Mentions)
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
بک‌اندهای میزبان برای کتابخانه‌های قلابِ حافظهٔ پنهان میزبان (host cache) و RADIUS به دستورهایی که مجموعه‌ای از رزروهای میزبان را برمی‌گردانند، مانند \fBreservation\-get\-all\fP\&، پاسخ نمی‌دهند. در عوض باید از دستورهایی که یک مدخل میزبان را برمی‌گردانند یا دستورهای اختصاصی حافظهٔ پنهان میزبان استفاده شود.
.UNINDENT
.UNINDENT
.SS \fBlibdhcp_lease_cmds.so\fP: دستورهای اجاره برای مدیریت آسان‌تر اجاره‌ها (Lease Commands for Easier Lease Management)
.sp
Kea به کاربران امکان می‌دهد اطلاعات اجاره (lease) را در چندین بک‌اند (memfile، MySQL و PostgreSQL) ذخیره کنند، و کتابخانهٔ Lease Commands رابطی فراهم می‌سازد که می‌تواند اجاره‌ها را به شیوه‌ای یکپارچه و ایمن دستکاری کند.
به‌ویژه، انجام کارهایی را ممکن می‌سازد که پیش‌تر غیرممکن بودند: دستکاری اجاره در memfile در زمان اجرای Kea، بررسی صحت تغییرات (sanity check)، بررسی وجود اجاره، و حذف تمامی اجاره‌های متعلق به یک زیرشبکهٔ (subnet) خاص. این کتابخانهٔ قلاب همچنین می‌تواند خطاهای مبهم‌تر را شناسایی کند، مانند تلاش برای افزودن یک اجاره با یک \fBsubnet\-id\fP که در پیکربندی وجود ندارد، یا پیکربندی یک اجاره برای استفاده از نشانی‌ای که خارج از زیرشبکهٔ تعیین‌شده قرار دارد. این کتابخانه همچنین روشی غیربرنامه‌نویسی برای مدیریت بافتارهای کاربری (user contexts) مرتبط با اجاره‌ها ارائه می‌دهد.
.sp
از Kea 2.7.7، این کتابخانه همچنین از \fBbinding\-variables\fP پشتیبانی می‌کند. متغیرهای مقیدسازی (Binding variables) به کاربر امکان می‌دهند مقادیر سفارشی را برای هر اجاره ذخیره کند. این متغیرها در این بخش بررسی شده‌اند: Binding Variables\&.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
\fBlibdhcp_lease_cmds.so\fP بخشی از کد متن‌باز است و در دسترس تمام کاربران Kea قرار دارد.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این کتابخانه تنها می‌تواند توسط فرایند \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> یا
\fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> بارگذاری شود.
.UNINDENT
.UNINDENT
.sp
موقعیت‌های فراوانی وجود دارد که در آن‌ها یک دستور مدیریتی می‌تواند مفید باشد؛ برای نمونه، در زمان مهاجرت میان سرورها یا ارائه‌دهندگان مختلف، هنگامی که یک شبکهٔ خاص در حال از رده خارج شدن است، یا زمانی که دستگاهی قطع شده و مدیر سیستم می‌داند که دیگر بازنخواهد گشت. پرس‌وجوهای \fBget\fP ممکن است برای خودکارسازی برخی وظایف مدیریتی و نظارتی مفید باشند، و همچنین می‌توانند به‌عنوان گام‌های مقدماتی برای به‌روزرسانی و حذف اجاره‌ها عمل کنند.
.sp
این کتابخانه دستورهای زیر را ارائه می‌دهد:
.INDENT 0.0
.IP \(bu 2
\fBlease4\-add\fP \- یک اجارهٔ IPv4 جدید اضافه می‌کند.
.IP \(bu 2
\fBlease6\-add\fP \- یک اجارهٔ IPv6 جدید اضافه می‌کند.
.IP \(bu 2
\fBlease6\-bulk\-apply\fP \- چندین اجارهٔ IPv6 را در یک تراکنش منفرد ایجاد، به‌روزرسانی، و/یا حذف می‌کند.
.IP \(bu 2
\fBlease4\-get\fP \- بررسی می‌کند که آیا یک اجارهٔ IPv4 با پارامترهای مشخص‌شده وجود دارد یا خیر و در صورت وجود آن را برمی‌گرداند.
.IP \(bu 2
\fBlease6\-get\fP \- بررسی می‌کند که آیا یک اجارهٔ IPv6 با پارامترهای مشخص‌شده وجود دارد یا خیر و در صورت وجود آن را برمی‌گرداند.
.IP \(bu 2
\fBlease4\-get\-all\fP \- تمام اجاره‌های IPv4 یا تمام اجاره‌های IPv4 زیرشبکه‌های مشخص‌شده را برمی‌گرداند.
.IP \(bu 2
\fBlease6\-get\-all\fP \- تمام اجاره‌های IPv6 یا تمام اجاره‌های IPv6 زیرشبکه‌های مشخص‌شده را برمی‌گرداند.
.IP \(bu 2
\fBlease4\-get\-page\fP \- مجموعه‌ای (\(dqصفحه\(dq) از اجاره‌ها را از فهرست تمامی اجاره‌های IPv4 در پایگاه‌داده برمی‌گرداند. با پیمایش صفحات می‌توان تمامی اجاره‌ها را بازیابی کرد.
.IP \(bu 2
\fBlease6\-get\-page\fP \- مجموعه‌ای (\(dqصفحه\(dq) از اجاره‌ها را از فهرست تمامی اجاره‌های IPv6 در پایگاه‌داده برمی‌گرداند. با پیمایش صفحات می‌توان تمامی اجاره‌ها را بازیابی کرد.
.IP \(bu 2
\fBlease4\-get\-by\-hw\-address\fP \- تمام اجاره‌های IPv4 با نشانی سخت‌افزاری مشخص‌شده را برمی‌گرداند.
.IP \(bu 2
\fBlease6\-get\-by\-hw\-address\fP \- تمام اجاره‌های IPv6 با نشانی سخت‌افزاری مشخص‌شده را برمی‌گرداند.
.IP \(bu 2
\fBlease4\-get\-by\-client\-id\fP \- تمام اجاره‌های IPv4 با \fBclient\-id\fP مشخص‌شده را برمی‌گرداند.
.IP \(bu 2
\fBlease6\-get\-by\-duid\fP \- تمام اجاره‌های IPv6 با DUID مشخص‌شده را برمی‌گرداند.
.IP \(bu 2
\fBlease4\-get\-by\-state\fP \- تمام اجاره‌های IPv4 با وضعیت مشخص‌شده را برمی‌گرداند.
.IP \(bu 2
\fBlease6\-get\-by\-state\fP \- تمام اجاره‌های IPv6 با وضعیت مشخص‌شده را برمی‌گرداند.
.IP \(bu 2
\fBlease4\-get\-by\-hostname\fP \- تمام اجاره‌های IPv4 با نام میزبان مشخص‌شده را برمی‌گرداند.
.IP \(bu 2
\fBlease6\-get\-by\-hostname\fP \- تمام اجاره‌های IPv6 با نام میزبان مشخص‌شده را برمی‌گرداند.
.IP \(bu 2
\fBlease4\-del\fP \- یک اجارهٔ IPv4 با پارامترهای مشخص‌شده را حذف می‌کند.
.IP \(bu 2
\fBlease6\-del\fP \- یک اجارهٔ IPv6 با پارامترهای مشخص‌شده را حذف می‌کند.
.IP \(bu 2
\fBlease4\-update\fP \- یک اجارهٔ IPv4 موجود را به‌روزرسانی (جایگزین) می‌کند.
.IP \(bu 2
\fBlease6\-update\fP \- یک اجارهٔ IPv6 موجود را به‌روزرسانی (جایگزین) می‌کند.
.IP \(bu 2
\fBlease4\-wipe\fP \- تمام اجاره‌ها را از یک زیرشبکهٔ IPv4 خاص یا از تمام زیرشبکه‌ها حذف می‌کند.
.IP \(bu 2
\fBlease6\-wipe\fP \- تمام اجاره‌ها را از یک زیرشبکهٔ IPv6 خاص یا از تمام زیرشبکه‌ها حذف می‌کند.
.IP \(bu 2
\fBlease4\-resend\-ddns\fP \- درخواست به‌روزرسانی مدخل‌های DNS را برای یک اجارهٔ موجود دوباره ارسال می‌کند.
.IP \(bu 2
\fBlease6\-resend\-ddns\fP \- درخواست به‌روزرسانی مدخل‌های DNS را برای یک اجارهٔ موجود دوباره ارسال می‌کند.
.IP \(bu 2
\fBlease4\-write\fP \- پایگاه‌دادهٔ اجاره‌های memfile مربوط به IPv4 را درون یک فایل می‌نویسد.
.IP \(bu 2
\fBlease6\-write\fP \- پایگاه‌دادهٔ اجاره‌های memfile مربوط به IPv6 را درون یک فایل می‌نویسد.
.IP \(bu 2
\fBsflq\-pool4\-rebuild\fP \- یک استخر SFLQ مربوط به IPv4 را در بک‌اند اجاره بازسازی می‌کند.
.IP \(bu 2
\fBsflq\-pool6\-rebuild\fP \- یک استخر SFLQ مربوط به IPv6 را در بک‌اند اجاره بازسازی می‌کند.
.IP \(bu 2
\fBsflq\-pool4\-get\-all\fP \- تمام استخرهای SFLQ مربوط به IPv4 را از بک‌اند اجاره واکشی می‌کند.
.IP \(bu 2
\fBsflq\-pool6\-get\-all\fP \- تمام استخرهای SFLQ مربوط به IPv6 را از بک‌اند اجاره واکشی می‌کند.
.IP \(bu 2
\fBsflq\-pool4\-get\-by\-subnet\fP \- تمام استخرهای SFLQ مربوط به IPv4 متعلق به یک زیرشبکه را از بک‌اند اجاره واکشی می‌کند.
.IP \(bu 2
\fBsflq\-pool6\-get\-by\-subnet\fP \- تمام استخرهای SFLQ مربوط به IPv6 متعلق به یک زیرشبکه را از بک‌اند اجاره واکشی می‌کند.
.IP \(bu 2
\fBsflq\-pool4\-get\-by\-range\fP \- تمام استخرهای SFLQ مربوط به IPv4 که با یک محدودهٔ نشانی هم‌پوشانی دارند را از بک‌اند اجاره واکشی می‌کند.
.IP \(bu 2
\fBsflq\-pool6\-get\-by\-range\fP \- تمام استخرهای SFLQ مربوط به IPv6 که با یک محدودهٔ نشانی هم‌پوشانی دارند را از بک‌اند اجاره واکشی می‌کند.
.IP \(bu 2
\fBsflq\-pool4\-del\fP \- یک استخر SFLQ مربوط به IPv4 مطابق با یک محدودهٔ نشانی را از بک‌اند اجاره حذف می‌کند.
.IP \(bu 2
\fBsflq\-pool6\-del\fP \- یک استخر SFLQ مربوط به IPv6 مطابق با یک محدودهٔ نشانی را از بک‌اند اجاره حذف می‌کند.
.UNINDENT
.sp
تمامی دستورها از نحو JSON استفاده می‌کنند و می‌توان آن‌ها را از طریق کانال کنترل (ببینید Management API \%<#\:ctrl-channel>) صادر کرد.
.sp
این کتابخانه را می‌توان به همان شیوهٔ سایر کتابخانه‌های قلاب بارگذاری کرد و هیچ پارامتری دریافت نمی‌کند. این کتابخانه از هر دو سرور DHCPv4 و DHCPv6 پشتیبانی می‌کند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqhooks\-libraries\(dq: [
        {
            \(dqlibrary\(dq: \(dqlibdhcp_lease_cmds.so\(dq
        },
        ...
    ]
}
.EE
.UNINDENT
.UNINDENT.SS دستورهای \fBlease4\-add\fP و \fBlease6\-add\fP
.sp
دستورهای \fBlease4\-add\fP و
\fBlease6\-add\fP امکان ایجاد یک اجاره (lease) جدید
را فراهم می‌کنند. به طور معمول Kea هنگامی که دستگاه جدیدی را
برای نخستین بار مشاهده می‌کند یک اجاره ایجاد می‌نماید؛ با این حال، گاهی ممکن است
ایجاد دستی اجاره سودمند باشد. دستور \fBlease4\-add\fP حداقل به دو پارامتر نیاز دارد:
یک نشانی IPv4 و یک شناسه، یعنی نشانی سخت‌افزاری (MAC). پارامتر
سوم، \fBsubnet\-id\fP، اختیاری است. اگر \fBsubnet\-id\fP مشخص نشده باشد یا
مقدار مشخص‌شده 0 باشد، Kea تلاش می‌کند با اجرای یک فرایند
انتخاب زیرشبکه، مقدار آن را تعیین کند. با این حال، در صورت تعیین، مقدار آن باید
با زیرشبکه موجود همخوانی داشته باشد. ساده‌ترین فراخوانی موفق ممکن است
به شکل زیر باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqlease4\-add\(dq,
    \(dqarguments\(dq: {
        \(dqip\-address\(dq: \(dq192.0.2.202\(dq,
        \(dqhw\-address\(dq: \(dq1a:1b:1c:1d:1e:1f\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
دستور \fBlease6\-add\fP به سه پارامتر نیاز دارد: یک نشانی IPv6،
یک مقدار IAID (شناسه ارتباط هویتی، مقداری که توسط
کلاینت‌ها ارسال می‌شود)، و یک DUID. همانند \fBlease4\-add\fP، پارامتر \fBsubnet\-id\fP
اختیاری است. اگر \fBsubnet\-id\fP مشخص نشده باشد یا مقدار ارائه‌شده 0 باشد،
Kea تلاش می‌کند با اجرای یک فرایند انتخاب زیرشبکه
مقدار آن را تعیین کند. با این حال، در صورت مشخص شدن، مقدار آن باید با زیرشبکه
موجود مطابقت داشته باشد. برای مثال:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqlease6\-add\(dq,
    \(dqarguments\(dq: {
        \(dqsubnet\-id\(dq: 66,
        \(dqip\-address\(dq: \(dq2001:db8::3\(dq,
        \(dqduid\(dq: \(dq1a:1b:1c:1d:1e:1f:20:21:22:23:24\(dq,
        \(dqiaid\(dq: 1234
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
دستور \fBlease6\-add\fP همچنین می‌تواند برای افزودن اجاره‌ها برای پیشوندهای IPv6 استفاده شود.
در این حالت سه پارامتر دیگر وجود دارد که باید مشخص شوند:
\fBsubnet\-id\fP، \fBtype\fP (تنظیم‌شده بر روی \(dqIA_PD\(dq)، و طول پیشوند. پیشوند اصلی
با استفاده از فیلد \fBip\-address\fP تنظیم می‌شود. توجه داشته باشید که Kea نمی‌تواند مقادیر
\fBsubnet\-id\fP را برای پیشوندها حدس بزند؛ این مقادیر باید صریحاً مشخص شوند. برای
نمونه، برای پیکربندی یک اجاره برای پیشوند 2001:db8:abcd::/48،
می‌توان از دستور زیر استفاده کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqlease6\-add\(dq,
    \(dqarguments\(dq: {
        \(dqsubnet\-id\(dq: 66,
        \(dqtype\(dq: \(dqIA_PD\(dq,
        \(dqip\-address\(dq: \(dq2001:db8:abcd::\(dq,
        \(dqprefix\-len\(dq: 48,
        \(dqduid\(dq: \(dq1a:1b:1c:1d:1e:1f:20:21:22:23:24\(dq,
        \(dqiaid\(dq: 1234
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستورها می‌توانند چندین پارامتر اختیاری اضافی دریافت کنند:
.INDENT 0.0
.IP \(bu 2
\fBvalid\-lft\fP \- طول عمر اجاره را بر حسب ثانیه مشخص می‌کند.
در صورت عدم تعیین، از مقدار پیکربندی‌شده در زیرشبکه مربوط
به \fBsubnet\-id\fP مشخص‌شده استفاده می‌شود.
.IP \(bu 2
\fBexpire\fP \- یک مهر زمانی از زمان انقضای اجاره بر حسب
قالب یونیکس (ثانیه‌ها از ۱ ژانویه ۱۹۷۰) ایجاد می‌کند. در صورت عدم
تعیین، مقدار پیش‌فرض زمان فعلی به علاوه طول عمر اجاره (مقدار
\fBvalid\-lft\fP) خواهد بود.
.IP \(bu 2
\fBfqdn\-fwd\fP \- مشخص می‌کند که آیا اجاره باید طوری علامت‌گذاری شود که گویی
یک به‌روزرسانی مستقیم DNS انجام شده است یا خیر. این مورد فقط بر
داده‌های ذخیره‌شده در پایگاه‌داده اجاره اثر می‌گذارد و هیچ به‌روزرسانی DNS انجام
نخواهد شد. در صورت پیکربندی، هنگام حذف اجاره به دلیل انقضا
یا آزادسازی توسط یک کلاینت، یک به‌روزرسانی DNS برای حذف رکوردهای A یا AAAA
انجام خواهد شد. در صورت عدم تعیین، مقدار پیش‌فرض
\fBfalse\fP است. در صورتی که \fBfqdn\-fwd\fP بر روی
\fBtrue\fP تنظیم شده باشد، پارامتر hostname باید مشخص گردد.
.IP \(bu 2
\fBfqdn\-rev\fP \- مشخص می‌کند که آیا اجاره باید طوری علامت‌گذاری شود که گویی
یک به‌روزرسانی معکوس DNS انجام شده است یا خیر. این مورد فقط بر
داده‌های ذخیره‌شده در پایگاه‌داده اجاره اثر می‌گذارد و هیچ به‌روزرسانی DNS انجام
نخواهد شد. در صورت پیکربندی، هنگام حذف اجاره به دلیل انقضا یا
آزادسازی توسط یک کلاینت، یک به‌روزرسانی DNS برای حذف رکورد PTR انجام
خواهد شد. در صورت عدم تعیین، مقدار پیش‌فرض \fBfalse\fP است.
در صورتی که \fBfqdn\-fwd\fP بر روی \fBtrue\fP تنظیم شده باشد، پارامتر hostname باید مشخص گردد.
.IP \(bu 2
\fBhostname\fP \- نام میزبان (hostname) مرتبط با این
اجاره را مشخص می‌کند. در صورتی که هر یک از \fBfqdn\-fwd\fP یا \fBfqdn\-rev\fP بر روی
\fBtrue\fP تنظیم شده باشند، مقدار آن نباید خالی باشد. در صورت عدم تعیین، مقدار پیش‌فرض یک رشته خالی است.
.IP \(bu 2
\fBhw\-address\fP \- به صورت اختیاری نشانی سخت‌افزاری (MAC) را برای یک
اجاره IPv6 مشخص می‌کند. این پارامتر برای اجاره IPv4 اجباری است.
.IP \(bu 2
\fBclient\-id\fP \- به صورت اختیاری یک شناسه کلاینت را برای یک اجاره
IPv4 مشخص می‌کند.
.IP \(bu 2
\fBpreferred\-lft\fP \- به صورت اختیاری طول عمر ترجیحی را برای
اجاره‌های IPv6 مشخص می‌کند. در صورت عدم تعیین، از مقدار پیکربندی‌شده برای زیرشبکه
متناظر با \fBsubnet\-id\fP مشخص‌شده استفاده می‌شود. این پارامتر هنگام
افزودن اجاره IPv4 استفاده نمی‌شود.
.IP \(bu 2
\fBstate\fP \- وضعیت یک اجاره افزوده‌شده را مشخص می‌کند که می‌تواند 0 برای \fBdefault\fP،
1 برای \fBdeclined\fP، 2 برای \fBexpired\-reclaimed\fP و 3 برای وضعیت \fBreleased\fP باشد.
هر مقدار دیگری باعث خطا می‌شود. استفاده از 1 برای نوع اجاره \fB\(dqIA_PD\(dq\fP
غیرمجاز است و رد خواهد شد.
.IP \(bu 2
\fBuser\-context\fP \- بافت کاربری (user context) مرتبط با
این اجاره را مشخص می‌کند. این مقدار باید یک نگاشت JSON باشد.
.UNINDENT
.sp
در اینجا نمونه‌ای از یک افزودن اجاره نسبتاً پیچیده آورده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqlease6\-add\(dq,
    \(dqarguments\(dq: {
        \(dqsubnet\-id\(dq: 66,
        \(dqip\-address\(dq: \(dq2001:db8::3\(dq,
        \(dqduid\(dq: \(dq01:02:03:04:05:06:07:08\(dq,
        \(dqiaid\(dq: 1234,
        \(dqhw\-address\(dq: \(dq1a:1b:1c:1d:1e:1f\(dq,
        \(dqpreferred\-lft\(dq: 500,
        \(dqvalid\-lft\(dq: 1000,
        \(dqexpire\(dq: 12345678,
        \(dqfqdn\-fwd\(dq: true,
        \(dqfqdn\-rev\(dq: true,
        \(dqstate\(dq: 0,
        \(dqhostname\(dq: \(dqurania.example.org\(dq,
        \(dquser\-context\(dq: { \(dqversion\(dq: 1 }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور وضعیتی را برمی‌گرداند که نشان‌دهنده موفقیت (نتیجه 0)
یا شکست (نتیجه 1) است. دستور شکست‌خورده همیشه شامل یک پارامتر
متنی است که علت شکست را شرح می‌دهد. برای مثال:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{ \(dqresult\(dq: 0, \(dqtext\(dq: \(dqLease added.\(dq }
.EE
.UNINDENT
.UNINDENT
.sp
نمونه شکست:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{ \(dqresult\(dq: 1, \(dqtext\(dq: \(dqmissing parameter \(aqip\-address\(aq (<string>:3:19)\(dq }
.EE
.UNINDENT
.UNINDENT.SS دستور \fBlease6\-bulk\-apply\fP
.sp
دستور \fBlease6\-bulk\-apply\fP برای رفع افت کارایی در حالت دسترس‌پذیری بالا (High\-Availability) پیاده‌سازی شده است؛ در این حالت زمانی که چندین اجارهٔ آدرس و/یا پیشوند تخصیص داده می‌شود، یک تراکنش منفرد DHCPv6 منجر به ارسال چندین به‌روزرسانی اجاره به کارگزار همتا (partner) می‌گردد. حالتی را در نظر بگیرید که یک کلاینت DHCPv6 درخواست تخصیص دو آدرس IPv6 و دو پیشوند IPv6 را می‌دهد: این امر ممکن است منجر به تخصیص چهار اجاره شود. علاوه‌بر این، DHCPv6 ممکن است در مرحلهٔ تمدید (renew) یا اتصال مجدد (rebind)، آدرسی متفاوت از آدرس درخواستی کلاینت اختصاص دهد و اجاره‌هایی را که پیش‌تر توسط این کلاینت استفاده می‌شدند، حذف کند. در این حالت شش تغییر اجاره میان همتاهای HA ارسال می‌شود. ارسال این به‌روزرسانی‌ها در قالب دستورهای مجزا، مثلاً از طریق \fBlease6\-update\fP، بسیار ناکارآمد است و تأخیرهای غیرضروری در ارتباطات، هم میان همتاهای HA و هم در ارسال پاسخ به کلاینت DHCPv6، ایجاد می‌کند.
.sp
دستور \fBlease6\-bulk\-apply\fP با تجمیع تمام تغییرات اجاره \- چه اجاره‌های حذف‌شده و چه اجاره‌های جدید یا به‌روزرسانی‌شده \- در قالب یک دستور واحد با این مشکل مقابله می‌کند. کارگزار دریافت‌کننده روی اجاره‌های حذف‌شده پیمایش کرده و آن‌ها را از پایگاه دادهٔ اجاره‌های خود حذف می‌کند. سپس، روی اجاره‌های جدید/به‌روزرسانی‌شده پیمایش کرده و آن‌ها را به پایگاه داده اضافه نموده یا در صورت وجود، به‌روزرسانی می‌کند.
.sp
اگرچه دسترس‌پذیری بالا (High Availability) کاربرد اصلی این دستور است، اما در تمامی مواردی که ارسال چندین تغییر اجاره در قالب یک دستور واحد مد نظر باشد، می‌توان آزادانه از آن استفاده کرد.
.sp
در مثال زیر، دو اجاره را حذف کرده و دو اجارهٔ دیگر را در پایگاه داده اضافه یا به‌روزرسانی می‌کنیم:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
 {
   \(dqcommand\(dq: \(dqlease6\-bulk\-apply\(dq,
   \(dqarguments\(dq: {
       \(dqdeleted\-leases\(dq: [
           {
               \(dqip\-address\(dq: \(dq2001:db8:abcd::\(dq,
               \(dqtype\(dq: \(dqIA_PD\(dq,
               ...
           },
           {
               \(dqip\-address\(dq: \(dq2001:db8:abcd::234\(dq,
               \(dqtype\(dq: \(dqIA_NA\(dq,
               ...
           }
       ],
       \(dqleases\(dq: [
           {
               \(dqsubnet\-id\(dq: 66,
               \(dqip\-address\(dq: \(dq2001:db8:cafe::\(dq,
               \(dqtype\(dq: \(dqIA_PD\(dq,
                ...
           },
           {
               \(dqsubnet\-id\(dq: 66,
               \(dqip\-address\(dq: \(dq2001:db8:abcd::333\(dq,
               \(dqtype\(dq: \(dqIA_NA\(dq,
               ...
           }
       ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر هر یک از اجاره‌ها ساختار ناصحیحی داشته باشند (malformed)، هیچ تغییری در پایگاه دادهٔ اجاره‌ها اعمال نمی‌شود. اگر اجاره‌ها ساختار معتبری داشته باشند اما در اعمال هر یک از تغییرات اجاره در پایگاه داده خطایی رخ دهد، پردازش دستور برای سایر اجاره‌ها ادامه می‌یابد. تمام اجاره‌هایی که دستور نتوانسته تغییرات آن‌ها را در پایگاه داده اعمال کند، در پاسخ فهرست می‌شوند. برای نمونه:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqBulk apply of 2 IPv6 leases completed\(dq,
    \(dqarguments\(dq: {
        \(dqfailed\-deleted\-leases\(dq: [
            {
                \(dqip\-address\(dq: \(dq2001:db8:abcd::\(dq,
                \(dqtype\(dq: \(dqIA_PD\(dq,
                \(dqresult\(dq: 3,
                \(dqerror\-message\(dq: \(dqno lease found\(dq
            }
        ],
        \(dqfailed\-leases\(dq: [
            {
                \(dqip\-address\(dq: \(dq2001:db8:cafe::\(dq,
                \(dqtype\(dq: \(dqIA_PD\(dq,
                \(dqresult\(dq: 1,
                \(dqerror\-message\(dq: \(dqunable to communicate with the lease database\(dq
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ بالا نشان می‌دهد که کتابخانهٔ قلاب (hook library) نتوانسته است اجارهٔ مربوط به پیشوند \(dq2001:db8:abcd::\(dq را حذف کرده و اجارهٔ مربوط به پیشوند \(dq2001:db8:cafe::\(dq را اضافه یا به‌روزرسانی کند. با این حال، همان‌طور که در پیام متنی مشخص است، دو تغییر اجارهٔ دیگر اعمال شده‌اند. مقدار \fBresult\fP ثابتی از وضعیت است که نوع خطای رخ‌داده برای اجارهٔ مشخص را نشان می‌دهد. معانی کدهای بازگردانده‌شده همانند نتایج بازگردانده‌شده برای دستورها است. به‌ویژه، نتیجهٔ 1 نشان‌دهندهٔ خطا در حین پردازش اجاره است، مانند خطای ارتباط با پایگاه داده. نتیجهٔ 3 نشان می‌دهد که تلاش برای حذف اجاره ناموفق بوده است زیرا چنین اجاره‌ای وجود ندارد (یک نتیجهٔ خالی).
.SS دستورهای \fBlease4\-get\fP و \fBlease6\-get\fP
.sp
از دستورهای \fBlease4\-get\fP و \fBlease6\-get\fP می‌توان برای پرس‌وجوی پایگاه دادهٔ اجاره و بازیابی اجاره‌های موجود استفاده کرد. دستور \fBlease4\-get\fP از دو نوع پارامتر پشتیبانی می‌کند: (\fBaddress\fP) یا (\fBsubnet\-id\fP، \fBidentifier\-type\fP، \fBidentifier\fP). همچنین برای \fBlease6\-get\fP دو نوع وجود دارد: (\fBaddress\fP، \fBtype\fP) یا (\fBsubnet\-id\fP، \fBidentifier\-type\fP، \fBidentifier\fP، \fBIAID\fP، \fBtype\fP). نوع اول پرس‌وجو زمانی استفاده می‌شود که آدرس (چه IPv4 و چه IPv6) مشخص است، اما جزئیات اجاره مشخص نیست؛ یکی از موارد کاربرد رایج این نوع پرس‌وجو پی بردن به این است که آیا آدرس مورد نظر در حال استفاده است یا خیر. پرس‌وجوی دوم از شناسه‌ها استفاده می‌کند؛ شناسه‌هایی که در حال حاضر برای اجاره‌ها پشتیبانی می‌شوند عبارتند از: \fB\(dqhw\-address\(dq\fP (فقط IPv4)، \fB\(dqclient\-id\(dq\fP (فقط IPv4) و \fB\(dqduid\(dq\fP (فقط IPv6).
.sp
یک نمونه دستور \fBlease4\-get\fP برای دریافت اجاره با استفاده از آدرس IPv4:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqlease4\-get\(dq,
    \(dqarguments\(dq: {
        \(dqip\-address\(dq: \(dq192.0.2.1\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
یک نمونه از پرس‌وجوی \fBlease6\-get\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqcommand\(dq: \(dqlease6\-get\(dq,
  \(dqarguments\(dq: {
    \(dqip\-address\(dq: \(dq2001:db8:1234:ab::\(dq,
    \(dqtype\(dq: \(dqIA_PD\(dq
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
یک نمونه پرس‌وجو بر اساس \fB\(dqhw\-address\(dq\fP برای یک اجارهٔ IPv4 به صورت زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqlease4\-get\(dq,
    \(dqarguments\(dq: {
        \(dqidentifier\-type\(dq: \(dqhw\-address\(dq,
        \(dqidentifier\(dq: \(dq08:08:08:08:08:08\(dq,
        \(dqsubnet\-id\(dq: 44
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
یک نمونه پرس‌وجو بر اساس \fB\(dqclient\-id\(dq\fP برای یک اجارهٔ IPv4 به صورت زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqlease4\-get\(dq,
    \(dqarguments\(dq: {
        \(dqidentifier\-type\(dq: \(dqclient\-id\(dq,
        \(dqidentifier\(dq: \(dq01:01:02:03:04:05:06\(dq,
        \(dqsubnet\-id\(dq: 44
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
یک نمونه پرس‌وجو بر اساس (\fBsubnet\-id\fP، \fBidentifier\-type\fP، \fBidentifier\fP، \fBiaid\fP، \fBtype\fP) برای یک اجارهٔ IPv6:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqlease6\-get\(dq,
    \(dqarguments\(dq: {
        \(dqidentifier\-type\(dq: \(dqduid\(dq,
        \(dqidentifier\(dq: \(dq08:08:08:08:08:08\(dq,
        \(dqiaid\(dq: 1234567,
        \(dqtype\(dq: \(dqIA_NA\(dq,
        \(dqsubnet\-id\(dq: 44
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پارامتر \fBtype\fP اختیاری است. مقادیر پشتیبانی‌شده عبارتند از: \fBIA_NA\fP (آدرس غیرموقت) و \fBIA_PD\fP (پیشوند IPv6). در صورت عدم تعیین، \fBIA_NA\fP در نظر گرفته می‌شود.
.sp
دستورهای \fBlease4\-get\fP و \fBlease6\-get\fP در صورت یافتن، نشانگری از نتیجهٔ عملیات و جزئیات اجاره را بازمی‌گردانند. نتیجه دارای یکی از مقادیر زیر است: 0 (موفقیت)، 1 (خطا)، یا 3 (خالی). نتیجهٔ خالی بدین معناست که پرس‌وجو به‌درستی انجام شده، اما شیء مورد نظر (در اینجا یک اجاره) یافت نشده است. در صورت یافت شدن، پارامترهای اجاره در قالب آرگومان‌ها بازگردانده می‌شوند. مقدار \fBclient\-id\fP در صورت خالی بودن بازگردانده نمی‌شود.
.sp
یک نمونه نتیجهٔ بازگردانده‌شده در زمانی که میزبان پیدا شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqarguments\(dq: {
    \(dqclient\-id\(dq: \(dq42:42:42:42:42:42:42:42\(dq,
    \(dqcltt\(dq: 12345678,
    \(dqfqdn\-fwd\(dq: false,
    \(dqfqdn\-rev\(dq: true,
    \(dqhostname\(dq: \(dqmyhost.example.com.\(dq,
    \(dqhw\-address\(dq: \(dq08:08:08:08:08:08\(dq,
    \(dqip\-address\(dq: \(dq192.0.2.1\(dq,
    \(dqstate\(dq: 0,
    \(dqsubnet\-id\(dq: 44,
    \(dqvalid\-lft\(dq: 3600
  },
  \(dqresult\(dq: 0,
  \(dqtext\(dq: \(dqIPv4 lease found.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
زمان آخرین تراکنش کلاینت (فیلد \fBcltt\fP) با معادلهٔ زیر به مدت‌زمان اعتبار (\fBvalid\-lft\fP) و تاریخ انقضا (که در اینجا گزارش نمی‌شود اما در پایگاه‌های داده ذخیره می‌گردد) پیوند خورده است:
cltt + valid\e_lft = expire
.sp
به استثنای مدت‌زمان اعتبار نامحدود که با مقدار ویژهٔ 0xfffffff (4294967295) کدگذاری شده است و باعث سرریز (overflow) مقدار expire در backendهای MySQL و نگارش‌های قدیمی PostgreSQL می‌شود که در آن‌ها مهر زمانی ۳۲ بیتی است. بنابراین در این پایگاه‌های دادهٔ اجاره، تاریخ انقضا همان cltt است؛ یعنی:
cltt = expire زمانی که valid\e_lft = 4294967295 باشد و backend اجاره MySQL یا PostgreSQL باشد.
.UNINDENT
.UNINDENT.SS دستورهای \fBlease4\-get\-all\fP و \fBlease6\-get\-all\fP
.sp
دستورهای \fBlease4\-get\-all\fP و \fBlease6\-get\-all\fP برای دریافت تمام اجاره‌های (leases) IPv4
یا IPv6، یا تمام اجاره‌های مربوط به مجموعه‌ای مشخص از زیرشبکه‌ها به کار می‌روند. اگر
هیچ آرگومانی همراه با دستور مشخص نشده باشد، تمام اجاره‌ها بازگردانده می‌شوند، همان‌طور
که در مثال زیر آمده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqlease4\-get\-all\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
در صورت ارائه آرگومان‌ها، انتظار می‌رود که شامل پارامتر \fB\(dqsubnets\(dq\fP باشند؛
این پارامتر فهرستی از شناسه‌های زیرشبکه‌ای است که اجاره‌های آن‌ها باید بازگردانده شوند.
به عنوان مثال، برای دریافت تمام اجاره‌های IPv6 متعلق به زیرشبکه‌هایی با شناسه‌های 1، 2، 3 و 4:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqlease6\-get\-all\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [ 1, 2, 3, 4 ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ بازگردانده‌شده شامل فهرست دقیقی از اجاره‌ها با قالب زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqarguments\(dq: {
        \(dqleases\(dq: [
            {
                \(dqcltt\(dq: 12345678,
                \(dqduid\(dq: \(dq42:42:42:42:42:42:42:42\(dq,
                \(dqfqdn\-fwd\(dq: false,
                \(dqfqdn\-rev\(dq: true,
                \(dqhostname\(dq: \(dqmyhost.example.com.\(dq,
                \(dqhw\-address\(dq: \(dq08:08:08:08:08:08\(dq,
                \(dqiaid\(dq: 1,
                \(dqip\-address\(dq: \(dq2001:db8:2::1\(dq,
                \(dqpreferred\-lft\(dq: 500,
                \(dqstate\(dq: 0,
                \(dqsubnet\-id\(dq: 44,
                \(dqtype\(dq: \(dqIA_NA\(dq,
                \(dqvalid\-lft\(dq: 3600
            },
            {
                \(dqcltt\(dq: 12345678,
                \(dqduid\(dq: \(dq21:21:21:21:21:21:21:21\(dq,
                \(dqfqdn\-fwd\(dq: false,
                \(dqfqdn\-rev\(dq: true,
                \(dqhostname\(dq: \(dq\(dq,
                \(dqiaid\(dq: 1,
                \(dqip\-address\(dq: \(dq2001:db8:0:0:2::\(dq,
                \(dqpreferred\-lft\(dq: 500,
                \(dqprefix\-len\(dq: 80,
                \(dqstate\(dq: 0,
                \(dqsubnet\-id\(dq: 44,
                \(dqtype\(dq: \(dqIA_PD\(dq,
                \(dqvalid\-lft\(dq: 3600
            }
        ]
    },
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq2 IPv6 lease(s) found.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
\fBهشدار:\fP
.INDENT 0.0
.INDENT 3.5
دستورهای \fBlease4\-get\-all\fP و
\fBlease6\-get\-all\fP ممکن است به پاسخ‌های
بسیار بزرگی منجر شوند. از آنجا که کارگزار محدودیتی بر روی تعداد
اجاره‌های بازگردانده‌شده در نتیجه این دستور اعمال نمی‌کند، این امر ممکن است
در حین تولید پاسخ و ارسال آن از طریق کانال کنترل، بر پاسخ‌گویی کارگزار DHCP
اثر منفی بگذارد.
.UNINDENT
.UNINDENT
.SS دستورهای \fBlease4\-get\-page\fP و \fBlease6\-get\-page\fP
.sp
دستورهای \fBlease4\-get\-all\fP و
\fBlease6\-get\-all\fP ممکن است منجر به پاسخ‌های
بسیار بزرگی شوند؛ تولید چنین پاسخی ممکن است توان پردازشی CPU و همچنین
حافظه را مصرف کند. حتی ممکن است باعث عدم پاسخ‌گویی کارگزار شود.
در پایگاه‌داده‌های بزرگ اجاره، معمولاً بهتر است اجاره‌ها به‌صورت تکه‌تکه
و با استفاده از سازوکار صفحه‌بندی دریافت شوند.
\fBlease4\-get\-page\fP و \fBlease6\-get\-page\fP به ترتیب یک سازوکار صفحه‌بندی
برای کارگزارهای DHCPv4 و DHCPv6 پیاده‌سازی می‌کنند. دستور زیر
1024 اجاره اول IPv4 را دریافت می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqlease4\-get\-page\(dq,
    \(dqarguments\(dq: {
        \(dqfrom\(dq: \(dqstart\(dq,
        \(dqlimit\(dq: 1024
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
کلمه کلیدی \fBstart\fP نشان می‌دهد که صفحه اول اجاره‌ها باید دریافت شود.
به عنوان جایگزین، می‌توان یک آدرس صفر IPv4 را برای دریافت صفحه اول مشخص کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqlease4\-get\-page\(dq,
    \(dqarguments\(dq: {
        \(dqfrom\(dq: \(dq0.0.0.0\(dq,
        \(dqlimit\(dq: 1024
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
به طور مشابه، می‌توان آدرس صفر IPv6 را در دستور
\fBlease6\-get\-page\fP مشخص نمود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqlease6\-get\-page\(dq,
    \(dqarguments\(dq: {
        \(dqfrom\(dq: \(dq::\(dq,
        \(dqlimit\(dq: 6
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ دارای ساختار زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqarguments\(dq: {
        \(dqleases\(dq: [
            {
                \(dqip\-address\(dq: \(dq2001:db8:2::1\(dq,
                ...
            },
            {
                \(dqip\-address\(dq: \(dq2001:db8:2::9\(dq,
                ...
            },
            {
                \(dqip\-address\(dq: \(dq2001:db8:3::1\(dq,
                ...
            },
            {
                \(dqip\-address\(dq: \(dq2001:db8:5::3\(dq,
                ...
            },
            {
                \(dqip\-address\(dq: \(dq2001:db8:4::1\(dq,
                ...
            },
            {
                \(dqip\-address\(dq: \(dq2001:db8:2::7\(dq,
                ...
            },
            ...
        ],
        \(dqcount\(dq: 6
    },
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq6 IPv6 lease(s) found.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
توجه داشته باشید که جزئیات اجاره‌ها در پاسخ بالا به منظور اختصار حذف شده‌اند.
.sp
به طور کلی، فهرست بازگردانده‌شده بر اساس ترتیب خاصی مرتب نشده است. برخی از
بک‌اندهای پایگاه‌داده اجاره ممکن است اجاره‌ها را به ترتیب صعودی آدرس‌ها مرتب کنند،
اما کلاینت کنترل‌کننده نباید به این رفتار اتکا کند.
.sp
پارامتر \fBcount\fP حاوی تعداد اجاره‌های بازگردانده‌شده در این صفحه است.
.sp
برای واکشی صفحه بعدی، کلاینت باید آخرین آدرس صفحه فعلی را به عنوان ورودی برای فراخوانی
دستور بعدی \fBlease4\-get\-page\fP یا \fBlease6\-get\-page\fP استفاده کند. در این مثال،
این آدرس به صورت زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqlease6\-get\-page\(dq,
    \(dqarguments\(dq: {
        \(dqfrom\(dq: \(dq2001:db8:2::7\(dq,
        \(dqcount\(dq: 6
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
زیرا 2001:db8:2::7 آخرین آدرس در صفحه فعلی است.
.sp
کلاینت می‌تواند هنگامی که مقدار \fBcount\fP کمتر از مقدار مشخص‌شده در دستور باشد، فرض کند
که به آخرین صفحه رسیده است؛ این شامل حالتی نیز می‌شود که \fBcount\fP برابر با 0 باشد،
به این معنی که هیچ اجاره‌ای پیدا نشده است..SS دستورهای \fBlease4\-get\-by\-*\fP و \fBlease6\-get\-by\-*\fP
.sp
دستورهای \fBlease4\-get\-by\-*\fP و \fBlease6\-get\-by\-*\fP می‌توانند برای پرس‌وجو از پایگاه داده اجاره‌ها و دریافت تمام اجاره‌های موجودِ منطبق با یک ویژگی مشخص (که با \fB*\fP نشان داده شده است) استفاده شوند. این موارد می‌توانند شامل یک آدرس سخت‌افزاری مشخص (فقط IPv4)، شناسه‌های \fBclient\-id\fP (فقط IPv4)، \fBduid\fP (فقط IPv6)، یا hostname باشند.
.sp
یک مثال از دستور \fBlease4\-get\-by\-hw\-address\fP برای دریافت اجاره‌های IPv4 با یک آدرس سخت‌افزاری مشخص:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqlease4\-get\-by\-hw\-address\(dq,
    \(dqarguments\(dq: {
        \(dqhw\-address\(dq: \(dq08:08:08:08:08:08\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
یک مثال از \fBlease6\-get\-by\-hostname\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqlease6\-get\-by\-hostname\(dq,
    \(dqarguments\(dq: {
        \(dqhostname\(dq: \(dqmyhost.example.org\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
کلید \fBby\fP تنها پارامتر است. پاسخ بازگردانده شده شامل فهرستی با جزئیات از اجاره‌ها با همان قالب \fBlease4\-get\-all\fP یا \fBlease6\-get\-all\fP\& است. این فهرست می‌تواند خالی باشد و معمولاً بزرگ نیست.
.sp
از نسخه 3.1.5 Kea، دستورهای \fBby\-state\fP اضافه شده‌اند به طوری که:
.INDENT 0.0
.IP \(bu 2
پارامتر \fBstate\fP همچنین یک رشته (در مقابل یک عدد) را برای نام‌های معمول وضعیت می‌پذیرد (default (یا assigned) (0)، declined (1)، expired\-reclaimed (2)، released (3)، و registered (4)).
.IP \(bu 2
یک پارامتر اختیاری subnet\-id که اجاره‌ها را به زیرشبکه مشخص‌شده محدود می‌کند. هنگامی که حذف شود یا روی 0 تنظیم گردد، تمام اجاره‌ها با وضعیت داده‌شده بازگردانده می‌شوند.
.UNINDENT
.SS دستورهای \fBlease4\-del\fP و \fBlease6\-del\fP
.sp
\fBlease4\-del\fP و \fBlease6\-del\fP می‌توانند برای حذف یک اجاره از پایگاه داده اجاره‌ها استفاده شوند. این دستورها مانند دستورهای \fBlease4\-get\fP و \fBlease6\-get\fP از دو نوع پارامتر پشتیبانی می‌کنند: (\fBaddress\fP) برای هر دو نسخه v4 و v6، همچنین (\fBsubnet\-id\fP، \fBidentifier\-type\fP، \fBidentifier\fP) برای v4، و (\fBsubnet\-id\fP، \fBidentifier\-type\fP، \fBidentifier\fP، \fBtype\fP، \fBIAID\fP) برای v6. نوع اول پرس‌وجو زمانی استفاده می‌شود که آدرس (چه IPv4 یا IPv6) مشخص است، اما جزئیات اجاره مشخص نیست. یک مورد استفاده معمول زمانی است که مدیر سیستم می‌خواهد یک آدرس مشخص دیگر استفاده نشود. شکل دوم دستور از شناسه‌ها استفاده می‌کند. برای حداکثر انعطاف‌پذیری، این رابط کاربری از شناسه‌ها به صورت یک جفت مقدار استفاده می‌کند: نوع و شناسه واقعی. شناسه‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از \fB\(dqhw\-address\(dq\fP (فقط IPv4)، \fB\(dqclient\-id\(dq\fP (فقط IPv4)، و \fB\(dqduid\(dq\fP (فقط IPv6).
.sp
یک مثال از دستور برای حذف یک اجاره IPv4 بر اساس آدرس:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqlease4\-del\(dq,
    \(dqarguments\(dq: {
        \(dqip\-address\(dq: \(dq192.0.2.202\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
یک مثال از حذف اجاره IPv4 بر اساس \fB\(dqhw\-address\(dq\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqcommand\(dq: \(dqlease4\-del\(dq,
  \(dqarguments\(dq: {
    \(dqidentifier\(dq: \(dq08:08:08:08:08:08\(dq,
    \(dqidentifier\-type\(dq: \(dqhw\-address\(dq,
    \(dqsubnet\-id\(dq: 44
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
اجاره‌های آدرس IPv6 نیز به همین روش حذف می‌شوند، اما با استفاده از \fBlease6\-del\fP\&. اجاره‌های پیشوند IPv6 نیز با استفاده از \fBlease6\-del\fP حذف می‌شوند، اما با چند مرحله اضافی. به پیشوند باید از طریق آدرس آن ارجاع داده شود و از طول پیشوند صرف‌نظر شود. برای مثال، جهت حذف 2001:db8:1::/48 می‌توان از دستور زیر استفاده کرد. پارامتر \fBsubnet\-id\fP اختیاری است.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqlease6\-del\(dq,
    \(dqarguments\(dq: {
        \(dqip\-address\(dq: \(dq2001:db8:1::\(dq,
        \(dqtype\(dq: \(dqIA_PD\(dq,
        \(dqsubnet\-id\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پارامتر دیگری با نام \fBupdate\-ddns\fP، در صورت \fBtrue\fP بودن، به سرور دستور می‌دهد که در صورت برقراری شرایط زیر، پس از حذف موفقیت‌آمیز اجاره، درخواستی را به \fBkea\-dhcp\-ddns\fP \%<#\:std-iscman-kea-dhcp-ddns> جهت حذف مدخل‌های DNS در صف قرار دهد:
.INDENT 0.0
.IP \(bu 2
به‌روزرسانی DDNS فعال باشد (یعنی \fB\(dqdhcp\-ddns\(dq:{ \(dqenable\-updates\(dq: true }\fP).
.IP \(bu 2
نام میزبان (hostname) اجاره خالی نباشد.
.IP \(bu 2
حداقل یکی از پرچم‌های جهت DNS اجاره (\fBfqdn_fwd\fP یا \fBfqdn_rev\fP) برابر با true باشد.
.UNINDENT
.sp
مقدار پیش‌فرض این پارامتر \fBfalse\fP\& است. مثالی از کاربرد آن در زیر نشان داده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqlease4\-del\(dq,
    \(dqarguments\(dq: {
        \(dqip\-address\(dq: \(dq192.0.2.202\(dq,
        \(dqupdate\-ddns\(dq: true
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
دستورهای \fBlease4\-del\fP و \fBlease6\-del\fP نتیجه‌ای را برمی‌گردانند که بیانگر پیامد عملیات است. این نتیجه یکی از مقادیر زیر را دارد: 0 (موفقیت)، 1 (خطا)، یا 3 (خالی). نتیجه خالی به این معنی است که پرس‌وجو به درستی انجام شده، اما شیء مورد نظر (در اینجا، یک اجاره) یافت نشده است..SS دستورهای \fBlease4\-update\fP و \fBlease6\-update\fP
.sp
دستورهای \fBlease4\-update\fP و
\fBlease6\-update\fP می‌توانند برای به‌روزرسانی اجاره‌های موجود به کار روند.
از آنجا که تمام پایگاه‌های داده پس‌زمینه اجاره‌ها بر اساس نشانی‌های IP نمایه شده‌اند،
امکان به‌روزرسانی خود نشانی وجود ندارد، اما تمام فیلدهای دیگر قابل تغییر هستند.
اگر نیاز به تغییر نشانی باشد، لطفاً از \fBlease4\-del\fP / \fBlease6\-del\fP و به دنبال آن
از \fBlease4\-add\fP / \fBlease6\-add\fP استفاده کنید\&.
.sp
پارامتر \fBsubnet\-id\fP اختیاری است. اگر مشخص نشود، یا مقدار تعیین‌شده 0 باشد،
Kea تلاش می‌کند مقدار آن را با اجرای یک رویه انتخاب زیرشبکه تعیین کند.
با این حال اگر مشخص شده باشد، مقدار آن باید با زیرشبکه موجود مطابقت داشته باشد.
.sp
پارامتر بولی اختیاری \fB\(dqforce\-create\(dq\fP مشخص می‌کند که آیا در صورت عدم وجود
اجاره در پایگاه داده، باید ایجاد شود یا خیر. مقدار پیش‌فرض آن \fBfalse\fP است که نشان
می‌دهد در صورت عدم وجود اجاره، ایجاد نخواهد شد. در چنین حالتی، هنگام تلاش برای به‌روزرسانی
یک اجاره ناموجود، خطا بازگردانده می‌شود. اگر پارامتر \fB\(dqforce\-create\(dq\fP روی
\fBtrue\fP تنظیم شده باشد و اجاره مورد نظر وجود نداشته باشد، با دریافت دستور
\fBlease4\-update\fP / \fBlease6\-update\fP، اجاره جدید ایجاد می‌شود.
.sp
نمونه‌ای از دستور برای به‌روزرسانی یک اجاره IPv4:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqcommand\(dq: \(dqlease4\-update\(dq,
  \(dqarguments\(dq: {
    \(dqip\-address\(dq: \(dq192.0.2.1\(dq,
    \(dqhostname\(dq: \(dqnewhostname.example.org\(dq,
    \(dqhw\-address\(dq: \(dq1a:1b:1c:1d:1e:1f\(dq,
    \(dqsubnet\-id\(dq: 44,
    \(dqforce\-create\(dq: true
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
نمونه‌ای از دستور برای به‌روزرسانی یک اجاره IPv6:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqcommand\(dq: \(dqlease6\-update\(dq,
  \(dqarguments\(dq: {
    \(dqip\-address\(dq: \(dq2001:db8::1\(dq,
    \(dqduid\(dq: \(dq88:88:88:88:88:88:88:88\(dq,
    \(dqiaid\(dq: 7654321,
    \(dqhostname\(dq: \(dqnewhostname.example.org\(dq,
    \(dqsubnet\-id\(dq: 66,
    \(dqforce\-create\(dq: false
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
همانند سایر دستورهای به‌روزرسانی، این دستور تمام محتویات مدخل را بازنویسی می‌کند.
اگر اجاره قبلاً منبعی تخصیص داده شده داشت، و در دستور \fBlease4\-update\fP / \fBlease6\-update\fP
آن منبع وجود نداشته باشد، از پایگاه داده اجاره‌ها حذف خواهد شد. اگر به‌روزرسانی تدریجی
اجاره مد نظر باشد، این کار با ارسال دستور \fBlease4\-get\fP / \fBlease6\-get\fP برای
دریافت وضعیت فعلی اجاره، انتخاب اجاره از پاسخ، تغییر آن به وضعیت مطلوب، و سپس ارسال
دستور \fBlease4\-update\fP / \fBlease6\-update\fP همراه با اجاره حاصل، قابل انجام است.
.SS دستورهای \fBlease4\-wipe\fP و \fBlease6\-wipe\fP
.sp
دستورهای \fBlease4\-wipe\fP و \fBlease6\-wipe\fP برای حذف تمام اجاره‌های مرتبط
با یک زیرشبکه مشخص طراحی شده‌اند. انتظار می‌رود این وظیفه مدیریتی زمانی استفاده
شود که یک زیرشبکه موجود در حال بازنشستگی و خروج از سرویس است. این اجاره‌ها به درستی
منقضی نمی‌شوند؛ هیچ به‌روزرسانی DNS انجام نمی‌گیرد، هیچ پیام لاگی ایجاد نمی‌شود،
و برای اجاره‌های در حال حذف هیچ قلابی (hook) فراخوانی نمی‌گردد.
.sp
نمونه‌ای از \fBlease4\-wipe\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqcommand\(dq: \(dqlease4\-wipe\(dq,
  \(dqarguments\(dq: {
    \(dqsubnet\-id\(dq: 44
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
نمونه‌ای از \fBlease6\-wipe\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqcommand\(dq: \(dqlease6\-wipe\(dq,
  \(dqarguments\(dq: {
    \(dqsubnet\-id\(dq: 66
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستورها یک توصیف متنی از تعداد اجاره‌های حذف‌شده، به علاوه کد وضعیت 0 (موفقیت) در صورت
حذف هرگونه اجاره یا 3 (خالی) در صورت عدم وجود اجاره را بازمی‌گردانند. اگر پارامترها
نادرست باشند یا استثنای دیگری رخ دهد، ممکن است کد وضعیت 1 (خطا) بازگردانده شود.
.sp
شناسه \fBsubnet\-id\fP 0 دارای معنای خاصی است؛ این مقدار به Kea اعلام می‌کند که
اجاره‌ها را از تمام زیرشبکه‌های پیکربندی‌شده حذف کند. همچنین، پارامتر \fBsubnet\-id\fP
می‌تواند حذف شود. اگر مشخص نشود، اجاره‌های تمام زیرشبکه‌ها پاک‌سازی خواهند شد.
.sp
نکته: در حال حاضر تنها فضای ذخیره‌سازی اجاره memfile از این دستور پشتیبانی می‌کند.
.SS دستورهای \fBlease4\-resend\-ddns\fP و \fBlease6\-resend\-ddns\fP
.sp
دستورهای \fBlease4\-resend\-ddns\fP و \fBlease6\-resend\-ddns\fP می‌توانند برای ایجاد یک درخواست
به \fBkea\-dhcp\-ddns\fP \%<#\:std-iscman-kea-dhcp-ddns> جهت به‌روزرسانی مدخل‌های DNS برای یک
اجاره موجود استفاده شوند. اجاره مورد نظر با یک پارامتر واحد به نام \fB\(dqip\-address\(dq\fP
انتخاب می‌شود\&. برای ایجاد درخواست به‌روزرسانی، باید به‌روزرسانی DDNS فعال باشد و پیش‌تر
مدخل‌های DNS برای این اجاره ثبت شده (یا اقدام به ثبت شده) باشند. به عبارت دیگر، تمام موارد
زیر باید برقرار باشند:
.INDENT 0.0
.IP \(bu 2
به‌روزرسانی DDNS باید فعال باشد (یعنی \fB\(dqdhcp\-ddns\(dq:{ \(dqenable\-updates\(dq: true\(dq}\fP).
.IP \(bu 2
نام میزبان (hostname) اجاره نباید خالی باشد.
.IP \(bu 2
حداقل یکی از پرچم‌های جهت DNS اجاره (\fBfqdn_fwd\fP یا \fBfqdn_rev\fP) باید true باشد.
.UNINDENT
.sp
نمونه‌ای از دستور \fBlease4\-resend\-ddns\fP برای دریافت اجاره با استفاده از نشانی IPv4:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqlease4\-resend\-ddns\(dq,
    \(dqarguments\(dq: {
        \(dqip\-address\(dq: \(dq192.0.2.1\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نمونه‌ای از پرس‌وجوی \fBlease6\-resend\-ddns\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqcommand\(dq: \(dqlease6\-resend\-ddns\(dq,
  \(dqarguments\(dq: {
    \(dqip\-address\(dq: \(dq2001:db8:1::1\(dq
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
دستورهای \fBlease4\-resend\-ddns\fP و \fBlease6\-resend\-ddns\fP وضعیت نتیجه عملیات را
بازمی‌گردانند. این وضعیت یکی از مقادیر زیر است: 0 (موفقیت)، 1 (خطا)، یا 3 (خالی). نتیجه خالی
بدین معناست که پرس‌وجو به درستی تکمیل شده، اما شیء (در این مورد یک اجاره) پیدا نشده است.
.sp
نتیجه موفقیت‌آمیز به این معنا نیست که DNS با موفقیت به‌روزرسانی شده است؛ بلکه نشان می‌دهد
درخواستی برای به‌روزرسانی DNS با موفقیت ایجاد شده و برای ارسال به
\fBkea\-dhcp\-ddns\fP \%<#\:std-iscman-kea-dhcp-ddns> در صف قرار گرفته است\&.
.sp
در اینجا نمونه‌ای از نتیجه بازگردانده‌شده در صورت یافتن اجاره آمده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqresult\(dq: 0,
  \(dqtext\(dq: \(dqNCR generated for: 2001:db8:1::1, hostname: example.com.\(dq
}
.EE
.UNINDENT
.UNINDENT.SS دستورهای \fBlease4\-write\fP و \fBlease6\-write\fP
.sp
دستورهای \fBlease4\-write\fP و \fBlease6\-write\fP می‌توانند برای بازیابی در شرایط اضطراری که فایل اجاره memfile آسیب دیده است (برای نمونه به اشتباه حذف شده یا به دلیل پر شدن سیستم‌فایل ناقص شده است)، اما پایگاه‌داده درون‌حافظه‌ای (in\-memory) همچنان معتبر است، استفاده شوند. این دستورها تنها توسط بک‌اند پایگاه‌داده memfile پشتیبانی می‌شوند و پایگاه‌داده اجاره را در یک فایل CSV می‌نویسند. آن‌ها مسیر فایل را به عنوان آرگومان \fBfilename\fP دریافت می‌کنند. اگر فایل خروجی مشخص‌شده با فایل پیکربندی‌شده memfile یکسان باشد، بک‌اند در تلاشی برای همگام‌سازی هر دو فایل و تصویرهای درون‌حافظه‌ای پایگاه‌داده اجاره، فایل را بسته و دوباره باز می‌کند. پسوند \fB\&.bak\fP و شماره PID سرور به نام فایل قبلی افزوده می‌شوند؛ برای نمونه: \fB\&.bak14326\fP\&.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
از Kea 2.7.9 به این سو، فایل اجاره تنها ممکن است در دایرکتوری داده تعیین‌شده هنگام کامپایل نوشته شود: \fB\(dq[kea\-install\-dir]/var/lib/kea\(dq\fP\&. این مسیر ممکن است در زمان راه‌اندازی با تنظیم متغیر محیطی \fBKEA_DHCP_DATA_DIR\fP به مسیر دلخواه بازنویسی شود. اگر مسیری به غیر از این مقدار در \fBfilename\fP استفاده شود، Kea خطایی صادر کرده و از راه‌اندازی امتناع می‌کند یا در صورت در حال اجرا بودن، یک خطای غیرقابل‌بازیابی را ثبت می‌کند. برای سهولت در مشخص کردن نام فایل سفارشی، کافی است بخش مسیر را از \fBfilename\fP حذف کنید.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این دستورها جایگزین سازوکار LFC نمی‌شوند؛ آن‌ها باید تنها در شرایط استثنایی استفاده شوند، مانند بازیابی پس از اتمام فضای دیسک.
.UNINDENT
.UNINDENT
.SS دستورهای مدیریت استخرهای SFLQ
.sp
دستورهای زیر می‌توانند برای مدیریت داده‌های SFLQ (مانند استخرها و اجاره‌های آزاد) موجود در بک‌اند اجاره برای زیرشبکه‌هایی که از Shared FLQ Allocator استفاده می‌کنند، به کار روند. در شرایط عادی، این اطلاعات به طور خودکار توسط سازوکارهای SFLQ Allocator ایجاد و نگهداری می‌شوند. با این دستورهای API، امکان مشاهده، ساخت (مجدد) و حذف استخرهای SFLQ فراهم می‌شود.
.sp
نخست، درک این نکته مهم است که استخرهای SFLQ به طور یکتا بر اساس آدرس‌های آغازین و پایانی خود شناسایی می‌شوند. برای هر محدوده معتبر IPv4 یا IPv6، تنها می‌تواند یک استخر وجود داشته باشد. با این حال، استخرها می‌توانند محدوده‌های همپوشان داشته باشند.
.sp
دستورهایی که استخرها را واکشی می‌کنند، مقادیر زیر را برای هر استخر بازمی‌گردانند:
.INDENT 0.0
.IP \(bu 2
\fBstart\-address\fP \- آدرس آغازین استخر
.IP \(bu 2
\fBend\-address\fP \- آدرس پایانی استخر
.IP \(bu 2
\fBsubnet\-id\fP \- شناسه زیرشبکه‌ای که استخر برای آن ایجاد شده است
.IP \(bu 2
\fBlease\-type\fP \- برای IPv4 همیشه \(dqV4\(dq است، برای IPv6 یا \(dqIA_NA\(dq است یا \(dqIA_PD\(dq
.IP \(bu 2
\fBdelegated\-len\fP \- برای استخرهای \(dqV4\(dq و \(dqIA_NA\(dq همیشه ۱۲۸ است. برای استخرهای \(dqIA_PD\(dq طول پیشوند واگذارشده است.
.IP \(bu 2
\fBcreated\-ts\fP \- زمان ایجاد استخر.
.IP \(bu 2
\fBmodified\-ts\fP \- زمان آخرین به‌روزرسانی استخر. این مقدار در ابتدا پس از تکمیل ایجاد استخر تنظیم می‌شود. پس از آن، هر بار که تخصیص SFLQ یک اجاره آزاد را از استخر برمی‌دارد، به‌روزرسانی می‌شود.
.IP \(bu 2
\fBfree\-leases\fP تعداد آدرس‌های در حال حاضر آزاد در استخر.
.UNINDENT
.sp
حداقل سه حالت وجود دارد که این دستورها در آن‌ها به احتمال زیاد بیشترین کاربرد را خواهند داشت. نخست، به عنوان راهکاری برای جست‌وجو و حذف استخرهای منسوخ‌شده. از آنجا که استخرها می‌توانند بین تعداد دلخواهی از سرورها به اشتراک گذاشته شوند، و هیچ‌یک از آن‌ها نمی‌توانند با قطعیت بدانند چه زمانی یک استخر دیگر مورد نیاز نیست، داده‌های SFLQ یک استخر را نمی‌توان هنگامی که طرح تخصیص آن به چیزی غیر از SFLQ Allocator تغییر می‌کند، به طور خودکار حذف کرد. اگرچه استخرهای غیرفعال نباید باعث اختلال در عملکرد سرورها شوند، اما فضا و نمایه‌ها را در بک‌اند اجاره مصرف می‌کنند.
.sp
حالت دوم، طرح‌های تخصیص ترکیبی است. برای اینکه تخصیص SFLQ به درستی کار کند، همه سرورهایی که از یک استخر معین (یعنی محدوده آدرس یا پیشوند) تخصیص می‌دهند، باید از SFLQ استفاده کنند. اگر برخی از سرورها استفاده کنند در حالی که برخی دیگر استفاده نکنند، داده‌های SFLQ می‌توانند به سرعت نادرست شوند. این مشکل را می‌توان با متوقف کردن سرورهایی که از SFLQ برای استخر(های) مربوطه استفاده نمی‌کنند، بازسازی استخر(ها) با استفاده از دستورهای sflq\-pool*\-rebuild، تغییر آن سرورها برای استفاده از SFLQ برای استخر(ها) و سپس راه‌اندازی مجدد آن‌ها رفع کرد.
.sp
حالت سوم، استخرهای همپوشان است (یعنی استخرهایی که محدوده‌های آدرس/پیشوند آن‌ها با یکدیگر تداخل دارند). Kea این موضوع را به عنوان یک پیکربندی عامدانه پشتیبانی می‌کند، اما همچنین ممکن است به صورت ناخواسته در صورتی رخ دهد که تغییرات پیکربندی به صورت یکپارچه در چندین سرور اعمال نشوند. واکشی استخرهای SFLQ بر اساس محدوده آدرس، تمام استخرهای SFLQ که با محدوده ورودی همپوشانی دارند را برمی‌گرداند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
ایجاد یا حذف استخرهای SFLQ در زمانی که سرورها به طور فعال از محدوده‌های آدرس آن‌ها تخصیص می‌دهند، می‌تواند منجر به نتایج متناقض شود و به طور کلی توصیه نمی‌شود. دستورهایی که استخرهای SFLQ را واکشی می‌کنند می‌توانند در هر زمان با اطمینان استفاده شوند.
.UNINDENT
.UNINDENT
.SS دستورهای \fBsflq\-pool4\-rebuild\fP و \fBsflq\-pool6\-rebuild\fP
.sp
دستورهای \fBsflq\-pool4\-rebuild\fP و \fBsflq\-pool6\-rebuild\fP می‌توانند برای بازسازی داده‌های اجاره آزاد برای استخرهای SFLQ موجود استفاده شوند. این امر در مواردی مفید است که یک یا چند سرور از سایر طرح‌های تخصیص برای محدوده‌های آدرسی که شامل استخرهای SFLQ هستند استفاده کرده باشند. اجرای این دستور باعث می‌شود که بک‌اند اجاره، داده‌های اجاره آزاد برای استخر مشخص‌شده را دور ریخته و سپس مجدداً بازسازی کند. تنها استخری بازسازی خواهد شد که دقیقاً با آدرس آغازین و پایانی ارائه‌شده مطابقت داشته باشد.
.sp
یک نمونه از دستور \fBsflq\-pool4\-rebuild\fP برای بازسازی استخر SFLQ مربوط به IPv4 در زیر نشان داده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqsflq\-pool4\-rebuild\(dq,
    \(dqarguments\(dq: {
        \(dqstart\-address\(dq: \(dq192.0.2.0\(dq,
        \(dqend\-address\(dq: \(dq192.0.2.255\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
یک نمونه از دستور \fBsflq\-pool6\-rebuild\fP برای بازسازی استخر SFLQ مربوط به IPv6 برای یک استخر آدرس در زیر نشان داده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqsflq\-pool6\-rebuild\(dq,
    \(dqarguments\(dq: {
        \(dqstart\-address\(dq: \(dq2001:db8:1::\(dq,
        \(dqend\-address\(dq: \(dq2001:db8:1::FFFF\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
برای استخرهای بزرگ (برای مثال >= ۱ میلیون آدرس/پیشوند)، این دستور می‌تواند بیست ثانیه یا بیشتر زمان ببرد. در طول این مدت سرور درخواست‌های کلاینت‌ها را پردازش نخواهد کرد. اطمینان حاصل کنید ابزاری که با آن دستورها را ارسال می‌کنید برای مهلت‌های زمانی (time outs) طولانی پیکربندی شده باشد. هنگامی که درخواست به بک‌اند اجاره ارسال شود، پرس‌وجو به اجرای خود ادامه خواهد داد، حتی اگر اتصال کلاینت API قطع شود.
.UNINDENT
.UNINDENT
.sp
این دستور وضعیتی را بازمی‌گرداند که نشان‌دهنده موفقیت (result 0) یا شکست (result 1) است. دستور شکست‌خورده همواره حاوی پارامتر متنی است که علت شکست را شرح می‌دهد. برای نمونه:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{ \(dqresult\(dq: 0, \(dqtext\(dq: \(dqSFLQ pool rebuilt.\(dq }
.EE
.UNINDENT
.UNINDENT.SS دستورهای \fBsflq\-pool4\-get\-all\fP و \fBsflq\-pool6\-get\-all\fP
.sp
از \fBsflq\-pool4\-get\-all\fP و \fBsflq\-pool6\-get\-all\fP می‌توان برای واکشی
فهرستی از تمامی استخرهای IPv4 یا IPv6 در SFLQ استفاده کرد. آن‌ها هیچ آرگومانی نمی‌پذیرند.
.sp
یک نمونه دستور \fBsflq\-pool4\-get\-all\fP برای واکشی استخرهای IPv4 در SFLQ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqsflq\-pool4\-get\-all\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ بازگردانده‌شده شامل یک فهرست تفصیلی از تمام استخرهای IPv4 در SLFQ به قالب زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqarguments\(dq: {
        \(dqpools\(dq: [
            {
                \(dqcreated\-ts\(dq: \(dq2026\-05\-05 11:16:36.000000\(dq,
                \(dqdelegated\-len\(dq: 128,
                \(dqend\-address\(dq: \(dq178.0.255.255\(dq,
                \(dqfree\-leases\(dq: 65535,
                \(dqlease\-type\(dq: \(dqV4\(dq,
                \(dqmodified\-ts\(dq: \(dq2026\-05\-05 11:16:36.000000\(dq,
                \(dqstart\-address\(dq: \(dq178.0.0.1\(dq,
                \(dqsubnet\-id\(dq: 1
            },
        {
            \(dqcreated\-ts\(dq: \(dq2026\-05\-05 11:18:02.000000\(dq,
            \(dqdelegated\-len\(dq: 128,
            \(dqend\-address\(dq: \(dq192.0.2.255\(dq,
            \(dqfree\-leases\(dq: 256,
            \(dqlease\-type\(dq: \(dqV4\(dq,
            \(dqmodified\-ts\(dq: \(dq2026\-05\-05 11:18:02.000000\(dq,
            \(dqstart\-address\(dq: \(dq192.0.2.0\(dq,
            \(dqsubnet\-id\(dq: 2
        }
        ]
    },
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq1 pool(s) found.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
یک نمونه دستور \fBsflq\-pool6\-get\-all\fP برای واکشی استخرهای IPv6 در SFLQ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqsflq\-pool6\-get\-all\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ بازگردانده‌شده شامل یک فهرست تفصیلی از تمام استخرهای IPv6 در SLFQ به قالب زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqarguments\(dq: {
        \(dqpools\(dq: [
            {
                \(dqcreated\-ts\(dq: \(dq2026\-05\-05 13:21:10.000000\(dq,
                \(dqdelegated\-len\(dq: 120,
                \(dqend\-address\(dq: \(dq2001:db8:1::ffff\(dq,
                \(dqfree\-leases\(dq: 256,
                \(dqlease\-type\(dq: \(dqIA_PD\(dq,
                \(dqmodified\-ts\(dq: \(dq2026\-05\-05 13:21:10.000000\(dq,
                \(dqstart\-address\(dq: \(dq2001:db8:1::\(dq,
                \(dqsubnet\-id\(dq: 1
            },
            {
                \(dqcreated\-ts\(dq: \(dq2026\-05\-05 08:40:40.000000\(dq,
                \(dqdelegated\-len\(dq: 128,
                \(dqend\-address\(dq: \(dq3001::ffff\(dq,
                \(dqfree\-leases\(dq: 65520,
                \(dqlease\-type\(dq: \(dqIA_NA\(dq,
                \(dqmodified\-ts\(dq: \(dq2026\-05\-05 08:40:41.000000\(dq,
                \(dqstart\-address\(dq: \(dq3001::10\(dq,
                \(dqsubnet\-id\(dq: 2
            }
        ]
    },
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq2 pool(s) found.\(dq
}
.EE
.UNINDENT
.UNINDENT
.SS دستورهای \fBsflq\-pool4\-get\-by\-subnet\fP و \fBsflq\-pool6\-get\-by\-subnet\fP
.sp
از \fBsflq\-pool4\-get\-by\-subnet\fP و \fBsflq\-pool6\-get\-by\-subnet\fP
می‌توان برای واکشی فهرستی از تمامی استخرهای IPv4 یا IPv6 در SFLQ که برای
یک زیرشبکه ایجاد شده‌اند، استفاده کرد.
.sp
یک نمونه دستور \fBsflq\-pool4\-get\-by\-subnet\fP برای واکشی استخرهای IPv4 در SFLQ در زیر نشان داده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqsflq\-pool4\-get\-by\-subnet\(dq,
    \(dqarguments\(dq: {
        \(dqsubnet\-id\(dq : 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ بازگردانده‌شده شامل یک فهرست تفصیلی از استخرهای IPv4 در SLFQ به قالب زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqarguments\(dq: {
        \(dqpools\(dq: [
            {
                \(dqcreated\-ts\(dq: \(dq2026\-05\-05 11:18:02.000000\(dq,
                \(dqdelegated\-len\(dq: 128,
                \(dqend\-address\(dq: \(dq192.0.2.255\(dq,
                \(dqfree\-leases\(dq: 256,
                \(dqlease\-type\(dq: \(dqV4\(dq,
                \(dqmodified\-ts\(dq: \(dq2026\-05\-05 11:18:02.000000\(dq,
                \(dqstart\-address\(dq: \(dq192.0.2.0\(dq,
                \(dqsubnet\-id\(dq: 1
            }
        ]
    },
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq1 pool(s) found.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
یک نمونه دستور \fBsflq\-pool6\-get\-by\-subnet\fP برای واکشی استخرهای IPv6 در SFLQ در زیر نشان داده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqsflq\-pool6\-get\-by\-subnet\(dq,
    \(dqarguments\(dq: {
        \(dqsubnet\-id\(dq : 100
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ بازگردانده‌شده شامل یک فهرست تفصیلی از استخرهای IPv6 در SLFQ به قالب زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqarguments\(dq: {
        \(dqpools\(dq: [
            {
                \(dqcreated\-ts\(dq: \(dq2026\-05\-05 13:21:10.000000\(dq,
                \(dqdelegated\-len\(dq: 120,
                \(dqend\-address\(dq: \(dq2001:db8:1::ffff\(dq,
                \(dqfree\-leases\(dq: 256,
                \(dqlease\-type\(dq: \(dqIA_PD\(dq,
                \(dqmodified\-ts\(dq: \(dq2026\-05\-05 13:21:10.000000\(dq,
                \(dqstart\-address\(dq: \(dq2001:db8:1::\(dq,
                \(dqsubnet\-id\(dq: 100
            }
        ]
    },
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq1 pool(s) found.\(dq
}
.EE
.UNINDENT
.UNINDENT.SS دستورات \fBsflq\-pool4\-get\-by\-range\fP و \fBsflq\-pool6\-get\-by\-range\fP
.sp
\fBsflq\-pool4\-get\-by\-range\fP و \fBsflq\-pool6\-get\-by\-range\fP
می‌توانند برای دریافت فهرستی از تمام استخرهای SFLQ مربوط به IPv4 یا IPv6 که برای یک زیرشبکه ساخته شده‌اند، استفاده شوند.
.sp
یک نمونه دستور \fBsflq\-pool4\-get\-by\-range\fP برای دریافت استخرهای SFLQ مربوط به IPv4 در زیر نشان داده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqsflq\-pool4\-get\-by\-range\(dq,
    \(dqarguments\(dq: {
        \(dqstart\-address\(dq: \(dq178.0.0.0\(dq,
        \(dqend\-address\(dq: \(dq178.255.255.255\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ بازگردانده‌شده شامل یک فهرست دقیق از استخرهای SFLQ مربوط به IPv4 به قالب زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqarguments\(dq: {
        \(dqpools\(dq: [
            {
                \(dqcreated\-ts\(dq: \(dq2026\-05\-05 11:16:36.000000\(dq,
                \(dqdelegated\-len\(dq: 128,
                \(dqend\-address\(dq: \(dq178.0.255.255\(dq,
                \(dqfree\-leases\(dq: 65535,
                \(dqlease\-type\(dq: \(dqV4\(dq,
                \(dqmodified\-ts\(dq: \(dq2026\-05\-05 11:16:36.000000\(dq,
                \(dqstart\-address\(dq: \(dq178.0.0.1\(dq,
                \(dqsubnet\-id\(dq: 1
            }
        ]
    },
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq1 pool(s) found.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
یک نمونه دستور \fBsflq\-pool6\-get\-by\-range\fP برای دریافت استخرهای SFLQ مربوط به IPv6 در زیر نشان داده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqsflq\-pool6\-get\-by\-range\(dq,
    \(dqarguments\(dq: {
        \(dqstart\-address\(dq: \(dq3001::\(dq,
        \(dqend\-address\(dq: \(dq3002::\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ بازگردانده‌شده شامل یک فهرست دقیق از استخرهای SFLQ مربوط به IPv6 به قالب زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqarguments\(dq: {
        \(dqpools\(dq: [
            {
                \(dqcreated\-ts\(dq: \(dq2026\-05\-05 08:40:40.000000\(dq,
                \(dqdelegated\-len\(dq: 128,
                \(dqend\-address\(dq: \(dq3001::ffff\(dq,
                \(dqfree\-leases\(dq: 65520,
                \(dqlease\-type\(dq: \(dqIA_NA\(dq,
                \(dqmodified\-ts\(dq: \(dq2026\-05\-05 08:40:41.000000\(dq,
                \(dqstart\-address\(dq: \(dq3001::10\(dq,
                \(dqsubnet\-id\(dq: 3001
            },
            {
                \(dqcreated\-ts\(dq: \(dq2026\-05\-05 08:40:41.000000\(dq,
                \(dqdelegated\-len\(dq: 64,
                \(dqend\-address\(dq: \(dq3001:20:0:ff:ffff:ffff:ffff:ffff\(dq,
                \(dqfree\-leases\(dq: 256,
                \(dqlease\-type\(dq: \(dqIA_PD\(dq,
                \(dqmodified\-ts\(dq: \(dq2026\-05\-05 08:40:41.000000\(dq,
                \(dqstart\-address\(dq: \(dq3001:20::\(dq,
                \(dqsubnet\-id\(dq: 3001
            }
        ]
    },
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq2 pool(s) found.\(dq
}
.EE
.UNINDENT
.UNINDENT
.SS دستورات \fBsflq\-pool4\-del\fP و \fBsflq\-pool6\-del\fP
.sp
از \fBsflq\-pool4\-del\fP و \fBsflq\-pool6\-del\fP می‌توان برای حذف یک استخر SFLQ مربوط به IPv4 یا IPv6 استفاده کرد. آن‌ها به دو آرگومان \fBstart\-address\fP و \fBend\-address\fP نیاز دارند. تنها استخری حذف خواهد شد که بازه آن با این مقادیر مطابقت داشته باشد و آن هم تنها در صورتی که هیچ استخر SFLQ دیگری با بازه توصیف‌شده توسط این مقادیر هم‌پوشانی نداشته باشد. اگر هرگونه استخر هم‌پوشانی شناسایی شود، عملیات حذف با پیام خطایی مبنی بر این وضعیت شکست خواهد خورد. یک پارامتر اختیاری \fBforce\fP وجود دارد که می‌تواند برای نادیده گرفتن این محافظت استفاده شود. هنگامی که روی \fBtrue\fP تنظیم شود، استخر منطبق بدون بررسی استخرهای هم‌پوشان حذف خواهد شد.
.sp
حذف یک استخر در زمانی که استخرهای هم‌پوشان وجود دارند، می‌تواند باعث ایجاد حفره‌هایی در داده‌های اجاره‌های آزاد (free lease) در محل‌های هم‌پوشانی شود. اگر قرار است استخرهای هم‌پوشان همچنان مورد استفاده قرار گیرند، باید از دستورات \fBsflq\-poolX\-rebuild\fP برای بازسازی داده‌های اجاره‌های آزاد برای استخرهای باقی‌مانده استفاده شود.
.sp
به عنوان راهکار دیگر، می‌توان تمام استخرهای هم‌پوشان را حذف کرد و راه‌اندازی (مجدد) یا پیکربندی (مجدد) بعدی کارساز Kea، تمام استخرهای مورد نیاز را به صورت خودکار بازآفرینی خواهد کرد.
.sp
یک نمونه دستور \fBsflq\-pool4\-del\fP برای حذف یک استخر SFLQ مربوط به IPv4 در زیر نشان داده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqsflq\-pool4\-del\(dq,
    \(dqarguments\(dq: {
        \(dqstart\-address\(dq: \(dq192.0.2.10\(dq,
        \(dqend\-address\(dq: \(dq192.0.2.20\(dq,
        \(dqforce\(dq: false
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ بازگردانده‌شده، در صورتی که استخرهای هم‌پوشان وجود داشته باشند، ممکن است به شکل زیر باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 1,
    \(dqtext\(dq: \(dqDelete would affect 2 overlapping pools\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
و اگر هیچ استخر هم‌پوشانی وجود نداشته باشد یا \fBforce\fP روی true تنظیم شده باشد و استخر منطبق موجود باشد، نتیجه مشابه مورد نشان‌داده‌شده در زیر خواهد بود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqSFLQ pool deleted\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
یک نمونه دستور \fBsflq\-pool6\-del\fP برای حذف یک استخر SFLQ مربوط به IPv6 در زیر نشان داده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqsflq\-pool6\-del\(dq,
    \(dqarguments\(dq: {
        \(dqstart\-address\(dq: \(dq3001::\(dq,
        \(dqend\-address\(dq: \(dq3001::10:FFFF\(dq,
        \(dqforce\(dq: false
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ بازگردانده‌شده، در صورتی که استخرهای هم‌پوشان وجود داشته باشند، ممکن است به شکل زیر باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 1,
    \(dqtext\(dq: \(dqDelete would affect 3 overlapping pools\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
و اگر هیچ استخر هم‌پوشانی وجود نداشته باشد یا \fBforce\fP روی true تنظیم شده باشد و استخر منطبق موجود باشد، نتیجه مشابه مورد نشان‌داده‌شده در زیر خواهد بود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqSFLQ pool deleted\(dq
}
.EE
.UNINDENT
.UNINDENT.SS متغیرهای انتساب (Binding Variables)
.sp
متغیرهای انتساب به کاربران اجازه می‌دهند مقادیر سفارشی را همراه با هر اجاره (lease) ذخیره کنند. این
مقادیر با استفاده از عبارت‌ها محاسبه شده و در \fBuser\-context\fP مربوط به اجاره
ذخیره می‌شوند. این قابلیت شبیه به دستور \fBset\fP در ISC DHCP است.
.sp
آن‌ها به عنوان پارامترهایی برای کتابخانه قلاب lease\-cmds پیکربندی می‌شوند. هر
متغیر دارای پارامترهای زیر است:
.INDENT 0.0
.IP \(bu 2
.INDENT 2.0
.TP
.B name
نام متغیری که در \fBuser\-context\fP نمایش داده خواهد شد. این
نام باید در فهرست متغیرهای انتساب یکتا باشد.
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B expression
عبارتی که برای محاسبه مقدار متغیر استفاده می‌شود (نگاه کنید به: :ref:
\fIclassification\-using\-expressions\fP).
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B source
بسته‌ای که به عنوان ورودی عبارت استفاده می‌شود. این مقدار می‌تواند \fBquery\fP
(بسته ارسال‌شده توسط کلاینت) یا \fBresponse\fP (بسته‌ای که سرور
در پاسخ ارسال می‌کند) باشد.
.UNINDENT
.UNINDENT
.sp
مثال زیر یک گزینه تعریف‌شده توسط کاربر ارسال‌شده از طرف
کلاینت را به همراه domain\-name ارسال‌شده توسط سرور برای هر اجاره DHCPv4
ذخیره می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqhooks\-libraries\(dq: [{
        \(dqlibrary\(dq: \(dqlibdhcp_lease_cmds.so\(dq,
        \(dqparameters\(dq: {
            \(dqbinding\-variables\(dq: [{
                \(dqname\(dq: \(dqopt\-222\(dq,
                \(dqexpression\(dq: \(dqhexstring(option[222].hex, \(aq:\(aq)\(dq,
                \(dqsource\(dq: \(dqquery\(dq
            },{
                \(dqname\(dq: \(dqdomain\-name\(dq,
                \(dqexpression\(dq: \(dqoption[15].text\(dq,
                \(dqsource\(dq: \(dqresponse\(dq
            }]
        }
    }]
}
.EE
.UNINDENT
.UNINDENT
.sp
مقادیر به صورت جفت‌های نام\-مقدار در نگاشت \fBISC\fP در \fBuser\-context\fP اجاره ذخیره می‌شوند
و محتویات آن شبیه به موارد زیر خواهد بود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqISC\(dq: {
        \(dqbinding\-variables\(dq: [{
            \(dqdomain\-name\(dq: \(dqexample.org\(dq,
            \(dqopt\-222\(dq: \(dq01:02:03:04\(dq
        }
    ]}
}
.EE
.UNINDENT
.UNINDENT
.sp
هنگام ذخیره‌سازی در بک‌اندهای پایگاه‌داده، user\-context فاقد شکست‌های خط
نشان داده شده در بالا خواهد بود و به صورت زیر نمایش می‌یابد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{ \(dqISC\(dq: { \(dqbinding\-variables\(dq: { \(dqdomain\-name\(dq: \(dqexample.org\(dq, \(dqopt\-222\(dq: \(dq01:02:03:04\(dq } } }
.EE
.UNINDENT
.UNINDENT
.sp
هنگام استفاده از فضای ذخیره‌سازی اجاره memfile، مقدار \fBuser\-context\fP با جایگزینی کاماها با
توالی گریز \(dq&#x2c\(dq در خروجی قرار می‌گیرد. این امر برای جلوگیری از تداخل در
تجزیه فایل اجاره ضروری است. خروجی مثال بالا در یک فایل اجاره memfile به صورت زیر خواهد بود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{ \(dqISC\(dq: { \(dqbinding\-variables\(dq: { \(dqdomain\-name\(dq: \(dqexample.org\(dq&#x2c \(dqopt\-222\(dq: \(dq01:02:03:04\(dq } } }
.EE
.UNINDENT
.UNINDENT
.sp
مقادیر متغیر انتساب هر زمان که اجاره‌ای تخصیص داده شده یا تمدید گردد ارزیابی می‌شوند.
برای \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4>، در صورتی که \fBoffer\-lifetime\fP بزرگتر از صفر باشد نیز اضافه می‌شوند.
اجاره در بک‌اند تنها زمانی به‌روزرسانی می‌شود که مقادیر تغییر کرده باشند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
هنگام استفاده هم‌زمان با کتابخانه قلاب Ping Check،
کتابخانه قلاب lease\-cmds باید پس از Ping Check در
بخش \fBhooks\-libraries\fP در پیکربندی سرور فهرست شود.
.sp
هنگام استفاده هم‌زمان با کتابخانه قلاب HA، کتابخانه قلاب lease\-cmds
باید قبل از HA در بخش \fBhooks\-libraries\fP در پیکربندی
سرور فهرست شود. این امر تضمین می‌کند که متغیرهای انتساب
پیش از ارسال به‌روزرسانی‌های اجاره توسط HA به همتایانش (peer(s)) ارزیابی شوند.
.UNINDENT
.UNINDENT
.SS \fBlibdhcp_lease_query.so\fP: پشتیبانی از Leasequery
.sp
این کتابخانه پشتیبانی از DHCPv4 Leasequery مطابق با
RFC 4388 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc4388>؛ و برای DHCPv6
Leasequery مطابق با (RFC 5007 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc5007>) را فراهم می‌کند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
\fBlibdhcp_lease_query.so\fP بخشی از کد متن‌باز بوده و
در دسترس تمام کاربران Kea است.
این قابلیت پیش‌تر تنها برای مشتریان ISC با قرارداد پشتیبانی تجاری در دسترس بود.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این کتابخانه تنها می‌تواند توسط فرایندهای \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> یا
\fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> بارگذاری شود.
.UNINDENT
.UNINDENT
.sp
نسخه 2.3.4 از Kea پشتیبانی از DHCPv6 Bulk Leasequery
(RFC 5460 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc5460>) را اضافه کرد؛
نسخه 2.3.5 از Kea پشتیبانی از DHCPv4 Bulk Leasequery
(RFC 6926 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc6926>) را با استفاده
از بک‌اند اجاره memfile اضافه نمود..SS پرسمان اجاره DHCPv4 (DHCPv4 Leasequery)
.sp
قابلیت پرسمان اجاره ساده DHCPv4 (DHCPv4 simple Leasequery) به درخواست‌کننده امکان استعلام اطلاعات اجاره‌های فعال را برای یک آدرس IP مشخص یا یک کلاینت مشخص فراهم می‌کند. استاندارد RFC 4388 سه نوع از این پرسمان‌ها را معین کرده است:
.INDENT 0.0
.IP \(bu 2
پرسمان بر اساس آدرس IP
.INDENT 2.0
.INDENT 3.5
آدرس IP مورد نظر در فیلد \fBciaddr\fP پرسمان قرار می‌گیرد.
.UNINDENT
.UNINDENT
.IP \(bu 2
پرسمان بر اساس آدرس سخت‌افزاری
.INDENT 2.0
.INDENT 3.5
آدرس سخت‌افزاری مورد نظر در فیلد \fBchaddr\fP پرسمان قرار می‌گیرد.
.UNINDENT
.UNINDENT
.IP \(bu 2
پرسمان بر اساس شناسه کلاینت
.INDENT 2.0
.INDENT 3.5
شناسه کلاینت مورد نظر در گزینه \fBdhcp\-client\-identifier\fP (کد 61) پرسمان ارسال می‌شود.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
بسته ورودی DHCPLEASEQUERY باید تنها یکی از سه مقدار بالا را ارائه دهد. پرسمان‌هایی که بیش از یکی از این مقادیر را ارائه دهند دور ریخته می‌شوند.
.sp
علاوه بر این، پرسمان باید حاوی آدرس IP درخواست‌کننده در فیلد \fBgiaddr\fP\& باشد. این مقدار نه تنها به عنوان مقصد پاسخ پرسمان استفاده می‌شود، بلکه برای اعتبارسنجی درخواست‌کننده در برابر فهرستی شناخته‌شده از آدرس‌های IP مجاز به پرسمان نیز به کار می‌رود. این فهرست از آدرس‌های درخواست‌کننده معتبر به عنوان بخشی از پیکربندی کتابخانه قلاب (hook library) مربوط به Leasequery مشخص می‌شود (بخش پیکربندی در زیر را ببینید).
.sp
سرور در پاسخ به یک پرسمان معتبر، یکی از سه نوع پیام زیر را برمی‌گرداند:
.INDENT 0.0
.IP \(bu 2
DHCPLEASEUNKNOWN
.INDENT 2.0
.INDENT 3.5
زمانی بازگردانده می‌شود که آدرس IP مورد نظر برای سرور ناشناخته باشد (پرسمان بر اساس آدرس IP)؛ یا هیچ اجاره فعالی برای کلاینت مورد نظر وجود نداشته باشد (پرسمان بر اساس آدرس سخت‌افزاری یا شناسه کلاینت).
.UNINDENT
.UNINDENT
.IP \(bu 2
DHCPLEASEUNASSIGNED
.INDENT 2.0
.INDENT 3.5
زمانی بازگردانده می‌شود که آدرس IP برای سرور شناخته‌شده باشد اما هیچ اجاره فعالی برای آن وجود نداشته باشد (تنها برای پرسمان بر اساس آدرس IP اعمال می‌شود).
.UNINDENT
.UNINDENT
.IP \(bu 2
DHCPLEASEACTIVE
.INDENT 2.0
.INDENT 3.5
زمانی بازگردانده می‌شود که حداقل یک اجاره فعال منطبق با معیارها یافت شود.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
برای هر دو پاسخ DHCPLEASEUNKNOWN و DHCPLEASEUNASSIGNED، تنها اطلاعاتی که در پاسخ به درخواست‌کننده بازگردانده می‌شود، همان پارامتر پرسمان است (یعنی یکی از موارد: آدرس IP، آدرس سخت‌افزاری یا شناسه کلاینت).
.sp
برای DHCPLEASEACTIVE، سرور اطلاعات زیر را برای جدیدترین اجاره فعال منطبق با معیارها در پاسخ ارائه می‌دهد:
.INDENT 0.0
.IP \(bu 2
\fBciaddr\fP \- روی آدرس IP اجاره تنظیم می‌شود
.IP \(bu 2
\fBchaddr\fP \- روی آدرس سخت‌افزاری اجاره تنظیم می‌شود
.UNINDENT
.sp
علاوه بر این، یک یا چند مورد از گزینه‌های زیر نیز گنجانده می‌شوند:
.SS گزینه‌های DHCPLEASEACTIVE
.TS
box center;
l|l|l.
T{
گزینه
T}	T{
کد
T}	T{
محتوا
T}
_
T{
dhcp\-client\-identifier
T}	T{
61
T}	T{
از روی اجاره کپی می‌شود (در صورت وجود)
T}
_
T{
client\-last\-transaction\-time
T}	T{
91
T}	T{
مدت زمانی که از client\-last\-transaction\-time
(CLTT) اجاره سپری شده است. این مقدار
همچنین توسط سرور برای تنظیم مقادیر طول عمر
و زمان‌سنج‌ها استفاده می‌شود.
T}
_
T{
dhcp\-lease\-time
T}	T{
51
T}	T{
طول عمر اجاره که مقدار CLTT از آن کسر شده است
T}
_
T{
dhcp\-renewal\-time
T}	T{
58
T}	T{
همان‌طور که توسط پیکربندی kea\-dhcp4 کنترل
شده و سپس مقدار CLTT از آن کسر شده است
T}
_
T{
dhcp\-rebind\-time
T}	T{
59
T}	T{
همان‌طور که توسط پیکربندی kea\-dhcp4 تعیین
شده و سپس مقدار CLTT از آن کسر شده است
T}
_
T{
dhcp\-agent\-options
T}	T{
82
T}	T{
در صورتی که روی اجاره ذخیره شده باشد. (ببینید:
ذخیره‌سازی اطلاعات توسعه‌یافته اجاره \%<#\:dhcp4-store-extended-info>)
T}
_
T{
associated\-ip
T}	T{
92
T}	T{
فهرستی از تمام آدرس‌های IP دیگری که
کلاینت برای آن‌ها اجاره فعال دارد. (برای
پرسمان بر اساس آدرس IP اعمال نمی‌شود)
T}
.TE
.sp
گزینه \fBdhcp\-server\-identifier\fP (کد 54) در تمام پاسخ‌ها در راستای مطابقت با RFC 2131، بخش 4.3.1 بازگردانده می‌شود.
.sp
استاندارد RFC 4388 به درخواست‌کنندگان اجازه می‌دهد تا گزینه‌های خاصی را از طریق \fBdhcp\-parameter\-request\-list\fP (PRL، گزینه 55) درخواست کنند. این مورد در حال حاضر در Kea پشتیبانی نمی‌شود..SS پیکربندی Leasequery در DHCPv4
.sp
پیکربندی کتابخانه قلاب (hook library) Leasequery برای استفاده سرراست است. این کتابخانه از یک پارامتر منفرد، \fBrequesters\fP، پشتیبانی می‌کند که فهرستی از نشانی‌های IP است که بسته‌های DHCPLEASEQUERY از آن‌ها پذیرفته می‌شوند. به عبارت دیگر، این فهرستی از درخواست‌دهندگان شناخته‌شده است. کد زیر یک نمونه پیکربندی را با دو نشانی درخواست‌دهنده نشان می‌دهد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
 \(dqhooks\-libraries\(dq: [
     {
         \(dqlibrary\(dq: \(dqlibdhcp_lease_query.so\(dq,
         \(dqparameters\(dq: {
             \(dqrequesters\(dq: [ \(dq192.0.1.1\(dq, \(dq10.0.0.2\(dq ]
         }
     }
 ],
 ...
}
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
از Kea 3.1.4 به بعد، امکان گنجاندن محدوده‌های نشانی درخواست‌دهنده در قالب CIDR مانند \(dq192.0.1.0/24\(dq نیز وجود دارد. لطفاً توجه داشته باشید که مشخص کردن محدوده‌ها ممکن است امنیت کمتری نسبت به استفاده صرف از نشانی‌های IP صریح داشته باشد.
.UNINDENT
.UNINDENT
.SS پرس‌وجوی Leasequery در DHCPv6
.sp
قابلیت Leasequery ساده در DHCPv6 به درخواست‌دهنده این امکان را می‌دهد که اطلاعات اجاره (lease) فعال را برای یک نشانی IP منفرد یا یک DUID کلاینت منفرد پرس‌وجو کند. نوع پرس‌وجو و پارامترها در یک گزینه \fBlq\-query\fP (44) متصل به پیام \fBDHCPV6_LEASEQUERY\fP منتقل می‌شوند:
.INDENT 0.0
.IP \(bu 2
\fBquery\-type\fP
.INDENT 2.0
.INDENT 3.5
این مقدار یا \fBquery\-by\-address\fP (1) است یا \fBquery\-by\-clientid\fP (2).
.UNINDENT
.UNINDENT
.IP \(bu 2
\fBlink\-address\fP
.INDENT 2.0
.INDENT 3.5
نشانی پیوند سراسری (global link address)، هنگامی که خالی نباشد، پرس‌وجو را ملزم می‌کند که به اجاره‌های درون آن \(dqپیوند\(dq محدود شود. Kea از این مقدار برای انتخاب تنها آن دسته از اجاره‌هایی استفاده می‌کند که به زیرشبکه‌هایی با پیشوند منطبق بر این مقدار تعلق دارند. اجاره‌های فعال برای تفویض‌های پیشوند (prefix delegations) مربوط به یک زیرشبکه منطبق، در پاسخ پرس‌وجو گنجانده می‌شوند، حتی اگر خود پیشوند تفویض‌شده خارج از پیشوند زیرشبکه قرار گیرد.
.UNINDENT
.UNINDENT
.IP \(bu 2
\fBquery\-options\fP
.INDENT 2.0
.INDENT 3.5
هنگام پرس‌وجو بر اساس نشانی، باید یک گزینه منفرد \fBiaaddr\fP (12) ارائه شود. هنگام پرس‌وجو بر اساس شناسه کلاینت (client ID)، باید یک گزینه منفرد \fBclientid\fP (1) ارائه شود. استاندارد RFC 5007 همچنین یک گزینه اختیاری \fBoro\fP (6) را برای درخواست بازگرداندن گزینه‌های خاص برای اجاره‌های منطبق مشخص کرده است. این قابلیت در حال حاضر پیاده‌سازی نشده است.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
بخش 3.3 استاندارد RFC 5007 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc5007#\:section-3.3>
بیان می‌کند که پرس‌وجو بر اساس نشانی IP باید یا یک اجاره (مثلاً انتساب) برای خود نشانی، یا یک اجاره برای پیشوند تفویض‌شده‌ای که شامل آن نشانی است بازگرداند.
.UNINDENT
.UNINDENT
.sp
پرس‌وجوهای \fBDHCPV6_LEASEQUERY\fP تنها در صورتی پذیرفته می‌شوند که نشانی مبدأ پرس‌وجو با مدخلی در فهرست نشانی‌های IP شناخته‌شده و مجاز برای پرس‌وجو مطابقت داشته باشد. این فهرست از نشانی‌های معتبر درخواست‌دهنده به عنوان بخشی از پیکربندی کتابخانه قلاب Leasequery مشخص می‌شود (به بخش پیکربندی در زیر مراجعه کنید). پرس‌وجوهای دریافتی از درخواست‌دهندگان ناشناس ثبت (log) و دور انداخته می‌شوند.
.sp
سرور در پاسخ به یک پرس‌وجوی معتبر، فعالیت‌های لازم را انجام داده و یک \fBDHCPV6_LEASEQUERY_REPLY\fP برمی‌گرداند. همه پاسخ‌ها حداقل شامل یک گزینه \fBstatus\-code\fP (13) هستند که نتیجه پرس‌وجو را مطابق با جدول زیر نشان می‌دهد:
.SS مقادیر گزینه وضعیت DHCPV6_LEASEQUERY_REPLY بر اساس نتیجه پرس‌وجو
.TS
box center;
l|l|l|l.
T{
نتیجه پرس‌وجو
T}	T{
برچسب
وضعیت
T}	T{
کد
وضعیت
T}	T{
متن
وضعیت
T}
_
T{
فیلد نوع پرس‌وجوی نامعتبر
T}	T{
STATUS_UnknownQueryType
T}	T{
7
T}	T{
\(dqunknown query\-type\(dq
T}
_
T{
پرس‌وجو بر اساس نشانی IP فاقد
گزینه نشانی
T}	T{
STATUS_Malformed
T}	T{
10
T}	T{
\(dqmissing D6O_IAADDR\(dq
T}
_
T{
پرس‌وجو بر اساس نشانی IP برای نشانی‌ای
که در هیچ استخر پیکربندی‌شده‌ای
قرار ندارد
T}	T{
STATUS_NotConfigured
T}	T{
9
T}	T{
\(dqaddress not in a configured
pool\(dq
T}
_
T{
پرس‌وجو بر اساس نشانی IP که تنها یک
اجاره غیرفعال یافت (مانند منقضی‌شده،
ردشده، بازپس‌گرفته‌شده\-منقضی‌شده)
T}	T{
STATUS_Success
T}	T{
0
T}	T{
\(dqinactive lease exists\(dq
T}
_
T{
پرس‌وجو بر اساس نشانی IP که هیچ
اجاره‌ای (فعال یا غیرفعال) نیافت
T}	T{
STATUS_Success
T}	T{
0
T}	T{
\(dqno active lease\(dq
T}
_
T{
پرس‌وجو بر اساس نشانی IP که یک
اجاره فعال برای نشانی یافت
T}	T{
STATUS_Success
T}	T{
0
T}	T{
\(dqactive lease found\(dq
T}
_
T{
پرس‌وجو بر اساس شناسه کلاینت فاقد
گزینه شناسه کلاینت
T}	T{
STATUS_Malformed
T}	T{
10
T}	T{
\(dqmissing D6O_CLIENTID\(dq
T}
_
T{
پرس‌وجو بر اساس شناسه کلاینت با نشانی
پیوندی که با هیچ زیرشبکه
پیکربندی‌شده‌ای مطابقت ندارد
T}	T{
STATUS_NotConfigured
T}	T{
9
T}	T{
\(dqnot a configured link\(dq
T}
_
T{
پرس‌وجو بر اساس شناسه کلاینت که هیچ
اجاره منطبقی نیافت
T}	T{
STATUS_Success
T}	T{
0
T}	T{
\(dqno active leases\(dq
T}
_
T{
پرس‌وجو بر اساس شناسه کلاینت که یک
یا چند اجاره فعال یافت
T}	T{
STATUS_Success
T}	T{
0
T}	T{
\(dqactive lease(s) found\(dq
T}
.TE
.sp
برای سناریوهایی که در آن‌ها پرس‌وجو یا نامعتبر بوده یا هیچ اجاره فعال منطبقی برای آن یافت نشده است، \fBDHCPV6_LEASEQUERY_REPLY\fP طبق جدول فوق تنها شامل گزینه \fBstatus\-code\fP (12) خواهد بود.
.sp
هنگامی که یک پرس‌وجو اجاره‌های فعال را در بیش از یک زیرشبکه بیابد و \fBlink\-address\fP پرس‌وجو خالی باشد، آنگاه علاوه بر status\-code، پیام \fBDHCPV6_LEASEQUERY_REPLY\fP شامل یک گزینه \fBlq\-client\-link\fP (48) خواهد بود. گزینه \fBlq\-client\-link\fP شامل فهرستی از نشانی‌های IPv6 است، یک نشانی برای هر زیرشبکه‌ای که در آن اجاره‌ای یافت شده است (به RFC 5007، بخش 4.1.2.5 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc5007#\:section-4\:.1\:.2.5> مراجعه کنید).
با این حال، اگر \fBlink\-address\fP پرس‌وجو خالی نباشد، فهرست پرس‌وجوها هرس می‌شود تا فقط شامل اجاره‌هایی باشد که متعلق به آن زیرشبکه هستند.
.sp
هنگامی که پرس‌وجو منجر به یک یا چند اجاره فعال شود که همگی به یک زیرشبکه منفرد تعلق دارند، علاوه بر \fBstatus\-code\fP، پیام \fBDHCPV6_LEASEQUERY_REPLY\fP شامل یک گزینه \fBclient\-data\fP (45) خواهد بود (به RFC 5007، بخش 4.1.2.2 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc5007#\:section-4\:.1\:.2.2> مراجعه کنید). گزینه client\-data گزینه‌های زیر را کپسوله‌سازی می‌کند:.SS OPTION_CLIENT_DATA بازگردانده‌شده هنگام یافتن اجاره(های) فعال
.TS
box center;
l|l|l.
T{
گزینه
T}	T{
کد
T}	T{
محتوا
T}
_
T{
clientid
T}	T{
1
T}	T{
رونویسی‌شده از روی اجاره (در صورت وجود)
T}
_
T{
clt\-time
T}	T{
46
T}	T{
مدت زمانی که از زمان آخرین تراکنش کلاینت (CLTT)
اجاره سپری شده است. این مقدار توسط کارگزار نیز برای
تنظیم طول‌عمر و مقادیر تایمر استفاده خواهد شد.
T}
_
T{
iaaddr
T}	T{
5
T}	T{
یک گزینه به ازای هر نشانی منطبق‌شده. فیلدها در
هر گزینه:
\- نشانی اجاره
\- طول‌عمر معتبر کاهش‌یافته با CLTT
\- طول‌عمر ترجیحی کاهش‌یافته با CLTT
T}
_
T{
iaprefix
T}	T{
26
T}	T{
یک گزینه به ازای هر پیشوند منطبق‌شده. فیلدها در
هر گزینه:
\- پیشوند
\- طول پیشوند
\- طول‌عمر معتبر کاهش‌یافته با CLTT
\- طول‌عمر ترجیحی کاهش‌یافته با CLTT
T}
.TE
.sp
اگر اجاره با تازه‌ترین مقدار client\-last\-transaction\-time (CLTT)
دارای اطلاعات رله (relay) در بافت کاربری (user context) خود باشد (ببینید
ذخیره‌سازی اطلاعات گسترش‌یافته اجاره \%<#\:store-extended-info-v6>)، آنگاه یک گزینه \fBOPTION_LQ_RELAY_DATA\fP به
پاسخ افزوده می‌شود (ببینید
RFC 5007, Section 4.1.2.4 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc5007#\:section-4\:.1\:.2.4>).
.sp
اطلاعات رله در اجاره، فهرستی با یک مدخل برای هر
لایه رله است که بسته کلاینت (برای نمونه \fBDHCPV6_REQUEST\fP) از آن عبور کرده است؛ به‌طوری‌که
نخستین مدخل در فهرست، بیرونی‌ترین لایه (نزدیک‌ترین به کارگزار) است. فیلد
\fBpeer\-address\fP از \fBlq\-rely\-option\fP بر روی نشانی همتای این
رله تنظیم می‌شود. سپس از فهرست رله‌ها برای ساخت یک پیام \fBDHCPV6_RELAY_FORW\fP
معادل پیامی که حاوی بسته کلاینت بود (منهای بسته کلاینت) استفاده می‌شود.
این پیام در فیلد \fBDHCP\-relay\-message\fP از گزینه \fBlq\-relay\-data\fP ذخیره می‌شود.
.SS پیکربندی DHCPv6 Leasequery
.sp
پیکربندی کتابخانه قلاب (hook library) Leasequery برای استفاده سرراست است. این
کتابخانه از یک پارامتر منفرد، یعنی \fBrequesters\fP پشتیبانی می‌کند که فهرستی از نشانی‌های IP است که
بسته‌های DHCPV6_LEASEQUERY از آن‌ها پذیرفته می‌شوند. به عبارت دیگر، این فهرستی از
درخواست‌کنندگان شناخته‌شده است. کد زیر یک پیکربندی نمونه را با دو نشانی
درخواست‌کننده نشان می‌دهد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
 \(dqhooks\-libraries\(dq: [
     {
         \(dqlibrary\(dq: \(dqlibdhcp_lease_query.so\(dq,
         \(dqparameters\(dq: {
             \(dqrequesters\(dq: [ \(dq2001:db8:1::1\(dq, \(dq2001:db8:2::1\(dq ],
             \(dqprefix\-lengths\(dq: [ 72 ]
         }
     }
 ],
 ...
}
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
از Kea 3.1.4 به بعد، گنجاندن محدوده‌هایی از نشانی‌های درخواست‌کننده در قالب CIDR
مانند \(dq2001:db8:1::/64\(dq نیز امکان‌پذیر است. لطفاً توجه داشته باشید که تعیین محدوده‌ها ممکن است امنیت کمتری
نسبت به استفاده انحصاری از نشانی‌های صریح IP داشته باشد.
.UNINDENT
.UNINDENT
.sp
هنگامی که یک پرس‌وجو بر پایه نشانی IP با هیچ اجاره نشانی موجودی منطبق نشود،
جستجویی برای یافتن یک پیشوند واگذارشده (delegated prefix) منطبق انجام می‌پذیرد. این کار
با پیمایش روی فهرستی از طول‌های پیشوند به ترتیب نزولی،
استخراج پیشوندی با آن طول از نشانی مورد پرس‌وجو، و جستجو
برای واگذاری منطبق با پیشوند حاصل انجام می‌شود. این فرآیند برای هر
طول در فهرست تا زمانی که تطابقی یافت شود یا فهرست به پایان برسد ادامه می‌یابد.
.sp
به‌طور پیش‌فرض، فهرست طول‌های پیشوند مورد استفاده در جستجو،
پس از رویدادهای پیکربندی (یا پیکربندی مجدد) به‌صورت پویا تعیین می‌شود. فهرست حاصل
شامل مقادیر یکتای \fBdelegated\-len\fP است که از مجموعه استخرهای PD پیکربندی‌شده فعلی
گردآوری شده است.
.sp
یک پارامتر اختیاری به نام \fBprefix\-lengths\fP وجود دارد که
امکان پیکربندی صریح فهرست را به‌جای تعیین پویای آن
فراهم می‌آورد. این امر کنترل دقیق‌تری را بر روی اینکه کدام طول‌های پیشوند
جستجو شوند ممکن می‌سازد. در مثال بالا، جستجوی طول پیشوند
صرف‌نظر از اینکه استخرهایی با مقادیر دیگر برای \fBdelegated\-len\fP وجود داشته باشند یا خیر،
به یک دور با استفاده از طول 72 محدود شده است\&.
مشخص کردن یک فهرست خالی، همان‌گونه که در زیر نشان داده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
:
               \(dqprefix\-lengths\(dq: [ ]
:
.EE
.UNINDENT
.UNINDENT
.sp
جستجو برای پیشوندهای واگذارشده را برای پرس‌وجو بر پایه نشانی IP غیرفعال می‌کند..SS پرسش دسته‌ای اجاره در DHCPv4 (DHCPv4 Bulk Leasequery)
.sp
قابلیت DHCPv4 Bulk Leasequery به یک درخواست‌کننده امکان می‌دهد تا اطلاعات اجاره‌های فعال را روی یک اتصال TCP پرس‌وجو کند. این ویژگی به سرور اجازه می‌دهد تا تمام اجاره‌های منطبق با یک پرس‌وجوی داده‌شده را برگرداند.
.sp
دو مورد از انواع پرس‌وجوهای مشخص‌شده در RFC 4388 \- پرسش بر اساس نشانی MAC و پرسش بر اساس Client\-identifier \- انواع پرسش‌های دسته‌ای اجاره (Bulk Leasequery) تعیین‌شده در RFC 6926 هستند. آن RFC همچنین این انواع جدید Bulk Leasequery را تعریف می‌کند:
.INDENT 0.0
.IP \(bu 2
پرسش بر اساس شناسه رله (Query by Relay Identifier)
.INDENT 2.0
.INDENT 3.5
این پرس‌وجو حامل یک گزینه RAI (dhcp\-agent\-options (82)) به همراه زیرگزینه relay\-id (12) است.
.UNINDENT
.UNINDENT
.IP \(bu 2
پرسش بر اساس شناسه دوردست (Query by Remote ID)
.INDENT 2.0
.INDENT 3.5
این پرس‌وجو حامل یک گزینه RAI (گزینه dhcp\-agent\-options (82)) به همراه زیرگزینه remote\-id (2) است.
.UNINDENT
.UNINDENT
.IP \(bu 2
پرسش برای تمام نشانی‌های IP پیکربندی‌شده (Query for All Configured IP Addresses)
.INDENT 2.0
.INDENT 3.5
این نوع پرس‌وجو زمانی انتخاب می‌شود که هیچ نوع پرس‌وجوی دیگری مشخص نشده باشد.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
استاندارد RFC 6926 همچنین گزینه‌های جدیدی را برای Bulk Leasequery تعریف می‌کند:
.INDENT 0.0
.IP \(bu 2
status\-code (151)
.INDENT 2.0
.INDENT 3.5
این گزینه پاسخ، یک کد وضعیت نظیر MalformedQuery یا NotAllowed را به همراه یک پیام متنی اختیاری حمل می‌کند.
.UNINDENT
.UNINDENT
.IP \(bu 2
base\-time (152)
.INDENT 2.0
.INDENT 3.5
این گزینه پاسخ، زمان مطلق فعلی را که پاسخ در آن ایجاد شده است حمل می‌کند. تمام گزینه‌های پاسخ دیگرِ مبتنی بر زمان، وابسته به این مقدار هستند.
.UNINDENT
.UNINDENT
.IP \(bu 2
start\-time\-of\-state (153)
.INDENT 2.0
.INDENT 3.5
این گزینه پاسخ، زمان انتقال اجاره به وضعیت فعلی‌اش را حمل می‌کند.
.UNINDENT
.UNINDENT
.IP \(bu 2
query\-start\-time (154)
.INDENT 2.0
.INDENT 3.5
این گزینه پرس‌وجو یک زمان شروع پرس‌وجو را تعیین می‌کند؛ پاسخ‌ها فقط شامل اجاره‌هایی خواهند بود که قدیمی‌تر از این مقدار باشند.
.UNINDENT
.UNINDENT
.IP \(bu 2
query\-end\-time (155)
.INDENT 2.0
.INDENT 3.5
این گزینه پرس‌وجو یک زمان پایان پرس‌وجو را تعیین می‌کند؛ پاسخ‌ها فقط شامل اجاره‌هایی خواهند بود که جدیدتر از این مقدار باشند.
.UNINDENT
.UNINDENT
.IP \(bu 2
dhcp\-state (156)
.INDENT 2.0
.INDENT 3.5
این گزینه پاسخ، وضعیت اجاره را حمل می‌کند.
.UNINDENT
.UNINDENT
.IP \(bu 2
data\-source (157)
.INDENT 2.0
.INDENT 3.5
این گزینه پاسخ، منبع داده را به عنوان یک پرچم دوردست (remote flag) حمل می‌کند.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
استاندارد RFC 6926 از گزینه Virtual Subnet Selection (221) تعریف‌شده در RFC 6607 مجدداً استفاده کرده و آن را گسترش می‌دهد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
برنامه Kea هنوز از پرس‌وجوی تمام نشانی‌های IP پیکربندی‌شده پشتیبانی نمی‌کند، بنابراین گزینه dhcp\-state قابل استفاده نیست، زیرا تنها اجاره‌های فعال می‌توانند در پاسخ‌ها بازگردانده شوند. Kea زمان شروع وضعیت اجاره و همچنین اطلاعات محلی/دوردست را نگهداری نمی‌کند، از این رو نمی‌تواند گزینه‌های متناظر start\-time\-of\-state و data\-source را منتشر کند. Kea از VPNها پشتیبانی نمی‌کند، بنابراین وجود گزینه 221 در پرس‌وجو به عنوان خطای (NotAllowed) در نظر گرفته می‌شود.
.UNINDENT
.UNINDENT
.SS پرسش دسته‌ای اجاره در DHCPv6 (DHCPv6 Bulk Leasequery)
.sp
قابلیت DHCPv6 Bulk Leasequery به یک درخواست‌کننده توانایی پرس‌وجوی اطلاعات اجاره‌های فعال را روی یک اتصال TCP می‌دهد. این امر به سرور امکان می‌دهد تا تمام اجاره‌های فعال منطبق با پرس‌وجو را بازگرداند.
.sp
انواع جدیدی از پرس‌وجو در دسترس هستند: \fBquery\-by\-relay\-id\fP (3)، \fBquery\-by\-link\-address\fP (4) و \fBquery\-by\-remote\-id\fP (5).
.sp
یک کد وضعیت جدید، \fBSTATUS_QueryTerminated\fP (11)، تعریف شده است اما هنوز توسط کتابخانه قلاب (hook library) استفاده نمی‌شود.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
برنامه Kea تلاش می‌کند تا پارامترهای نشانی پیوند (link address) را به پیشوندهای زیرشبکه‌های پیکربندی‌شده نگاشت کند. اگر نشانی داده‌شده خارج از تمام پیشوندهای زیرشبکه پیکربندی‌شده قرار گیرد، پرس‌وجو با کد وضعیت \fBSTATUS_NotConfigured\fP\& با شکست مواجه می‌شود. چنانچه پارامتر link address برای \fBquery\-by\-relay\-id\fP یا \fBquery\-by\-remote\-id\fP برابر با \fB::\fP نباشد (یعنی خالی نباشد)، تنها پیشوندهای واگذارشده‌ای که درون پیشوندهای زیرشبکه منطبق قرار دارند بازگردانده می‌شوند. در حال حاضر، \fBquery\-by\-address\fP از یافتن پیشوندهای واگذارشده با مشخص کردن نشانی‌ای که درون پیشوند قرار دارد، پشتیبانی نمی‌کند.
.UNINDENT
.UNINDENT.SS پیکربندی Bulk Leasequery
.sp
پیکربندی Bulk Leasequery از طریق یک پارامتر نگاشت (map) جدید به نام \fBadvanced\fP
با این ورودی‌های ممکن مشخص می‌شود:
.INDENT 0.0
.IP \(bu 2
\fBbulk\-query\-enabled\fP
.INDENT 2.0
.INDENT 3.5
هنگامی که \fBtrue\fP باشد، Kea اتصال‌ها را از نشانی‌های IP موجود در فهرست
requesters می‌پذیرد و bulk leasequeryهای دریافتی را پردازش می‌کند. مقدار پیش‌فرض \fBfalse\fP است\&.
.UNINDENT
.UNINDENT
.IP \(bu 2
\fBactive\-query\-enabled\fP
.INDENT 2.0
.INDENT 3.5
این یک پارامتر پیش‌بینی‌شده است: در صورت تنظیم، باید \fBfalse\fP باشد\&.
.UNINDENT
.UNINDENT
.IP \(bu 2
\fBextended\-info\-tables\-enabled\fP
.INDENT 2.0
.INDENT 3.5
هنگامی که \fBtrue\fP باشد، پسانه اجاره (lease backend) اطلاعات تکمیلی اجاره DHCPv6
(اطلاعات رله) را در جدول‌ها مدیریت می‌کند تا از انواع جدید DHCPv6 Bulk Leasequery
شامل by\-relay\-id و by\-remote\-id پشتیبانی کند. مقدار پیش‌فرض، استفاده از
همان مقدار \fBbulk\-query\-enabled\fP است\&.
.UNINDENT
.UNINDENT
.IP \(bu 2
\fBlease\-query\-ip\fP
.INDENT 2.0
.INDENT 3.5
این نشانی IP است که باید برای اتصال‌ها روی آن شنود انجام شود. این نشانی باید
از همان خانواده سرور باشد، برای مثال IPv6 برای سرور DHCPv6\&.
.UNINDENT
.UNINDENT
.IP \(bu 2
\fBlease\-query\-port\fP
.INDENT 2.0
.INDENT 3.5
این درگاهی (پورت) است که باید روی آن شنود شود. مقدار پیش‌فرض 67 برای IPv4 و 547 برای IPv6 است؛
یعنی همان مقدار سرویس UDP DHCP، اما برای TCP\&.
.UNINDENT
.UNINDENT
.IP \(bu 2
\fBmax\-bulk\-query\-threads\fP
.INDENT 2.0
.INDENT 3.5
این مقدار حداکثر تعداد ریسه‌هایی (threads) را نشان می‌دهد که پردازش bulk leasequery
باید استفاده کند. مقدار 0 به سرور دستور می‌دهد از همان تعداد ریسه‌هایی استفاده کند
که هسته Kea برای چندریسمانی (multi\-threading) پروتکل DHCP به کار می‌برد.
مقدار پیش‌فرض 0 است\&.
.UNINDENT
.UNINDENT
.IP \(bu 2
\fBmax\-requester\-connections\fP
.INDENT 2.0
.INDENT 3.5
این حداکثر تعداد اتصال‌های هم‌زمان درخواست‌کننده است. مقدار پیش‌فرض
10 است؛ مقدار باید بزرگ‌تر از 0 باشد\&.
.UNINDENT
.UNINDENT
.IP \(bu 2
\fBmax\-concurrent\-queries\fP
.INDENT 2.0
.INDENT 3.5
این حداکثر تعداد پرس‌وجوهای هم‌زمان به ازای هر اتصال است. مقدار 0
به Kea امکان می‌دهد که تعداد را تعیین کند، و مقدار پیش‌فرض است\&.
.UNINDENT
.UNINDENT
.IP \(bu 2
\fBmax\-requester\-idle\-time\fP
.INDENT 2.0
.INDENT 3.5
این مدت‌زمانی است که پس از دریافت داده از یک درخواست‌کننده، پیش از اینکه اتصال آن
به دلیل بیکار بودن (idle) بسته شود، می‌تواند سپری شود (به ثانیه). مقدار پیش‌فرض
300 است\&.
.UNINDENT
.UNINDENT
.IP \(bu 2
\fBmax\-leases\-per\-fetch\fP
.INDENT 2.0
.INDENT 3.5
این حداکثر تعداد اجاره‌ها برای بازگرداندن در یک واکشی (fetch) منفرد است. مقدار پیش‌فرض 100 است\&.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
پس از پشتیبانی از TLS، انتظار داریم پارامترهای مشترک TLS پیاده‌سازی شوند.
.sp
برای نمونه، برای DHCPv4:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqhooks\-libraries\(dq: [
      {
          \(dqlibrary\(dq: \(dqlibdhcp_lease_query.so\(dq,
          \(dqparameters\(dq: {
              \(dqrequesters\(dq: [ \(dq192.0.2.1\(dq, \(dq192.0.2.2\(dq ],
              \(dqadvanced\(dq : {
                   \(dqbulk\-query\-enabled\(dq: true,
                   \(dqactive\-query\-enabled\(dq: false,

                   \(dqlease\-query\-ip\(dq: \(dq127.0.0.1\(dq,
                   \(dqlease\-query\-tcp\-port\(dq: 67,

                   \(dqmax\-bulk\-query\-threads\(dq: 0,
                   \(dqmax\-requester\-connections\(dq: 10,
                   \(dqmax\-concurrent\-queries\(dq: 4,
                   \(dqmax\-requester\-idle\-time\(dq: 300,
                   \(dqmax\-leases\-per\-fetch\(dq: 100
              }
          }
      }
  ],
  ...
}
.EE
.UNINDENT
.UNINDENT
.sp
یا برای DHCPv6:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqhooks\-libraries\(dq: [
      {
          \(dqlibrary\(dq: \(dqlibdhcp_lease_query.so\(dq,
          \(dqparameters\(dq: {
              \(dqrequesters\(dq: [ \(dq2001:db8:1::1\(dq, \(dq2001:db8:2::1\(dq ],
              \(dqadvanced\(dq : {
                   \(dqbulk\-query\-enabled\(dq: true,
                   \(dqactive\-query\-enabled\(dq: false,

                   \(dqextended\-info\-tables\-enabled\(dq: true,

                   \(dqlease\-query\-ip\(dq: \(dq::1\(dq,
                   \(dqlease\-query\-tcp\-port\(dq: 547,

                   \(dqmax\-bulk\-query\-threads\(dq: 0,
                   \(dqmax\-requester\-connections\(dq: 10,
                   \(dqmax\-concurrent\-queries\(dq: 4,
                   \(dqmax\-requester\-idle\-time\(dq: 300,
                   \(dqmax\-leases\-per\-fetch\(dq: 100
              }
          }
      }
  ],
  ...
}
.EE
.UNINDENT
.UNINDENT.SS به‌روزرسانی اجاره‌های موجود در بک‌اندهای اجارهٔ SQL
.sp
ویژگی Bulk Leasequery نیازمند داده‌های اضافه‌تری برای اطلاعات اجارهٔ ذخیره‌شده است. در بک‌اندهای اجارهٔ SQL، اجاره‌هایی که پیش از پیکربندی کارساز برای Bulk Leasequery ایجاد شده‌اند، فاقد این داده‌های جدید مورد نیاز هستند. برای پر کردن این داده‌ها، اجرای این دستورهای API ضروری است:
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
اجاره‌های موجود باید توسط Kea با فعال بودن \fBstore\-extended\-info\fP ایجاد شده باشند تا داده‌های جدید از اطلاعات تکمیلی (extended info) قابل استخراج و ذخیره‌سازی باشند.
.UNINDENT
.UNINDENT
.sp
برای داده‌های اجارهٔ DHCPv4، دستور به این صورت است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqextended\-info4\-upgrade\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
برای داده‌های اجارهٔ DHCPv6، دستور به این صورت است:
.sp
برای اطلاعات تکمیلی مورد استفاده توسط relay ID و توسط remote ID، دستور به این صورت است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqextended\-info6\-upgrade\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
در تمام موارد، پاسخ نشان می‌دهد که عملیات با موفقیت انجام شده یا شکست خورده است و شامل تعداد اجاره‌های به‌روزشده یا ماهیت خطا خواهد بود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqUpgraded 1000 leases\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور \fBextended\-info6\-upgrade\fP باید در شرایط زیر اجرا شود:
.INDENT 0.0
.IP \(bu 2
طرحوارهٔ (schema) پایگاه داده از نگارش 2.4.1 یا نگارش‌های قدیمی‌تر ارتقا یافته باشد.
هنگام ارتقا از نگارش 2.3.8 یا قدیمی‌تر می‌توان از \fBextended\-info4\-upgrade\fP استفاده کرد.
.IP \(bu 2
قابلیت Bulk Leasequery فعال نبوده باشد؛ جدول‌ها تنها زمانی نگهداری می‌شوند که v6 BLQ فعال باشد.
.IP \(bu 2
داده‌های موجود در جدول‌ها سازگار به نظر نرسند؛ جدول‌ها به صورت اتمیک نگهداری نمی‌شوند، بنابراین سازگاری تضمین نمی‌شود. برای نمونه، هنگامی که یک پایگاه داده میان چند کارساز به اشتراک گذاشته شده است، ممکن است بین به‌روزرسانی‌ها شرایط رقابتی رخ دهد.
.UNINDENT
.sp
عملکرد دستور extended info توسط پارامتر \fBextended\-info\-checks\fP زیر عنصر \fBsanity\-checks\fP کنترل می‌شود. لطفاً «بررسی‌های سلامت در DHCPv4» \%<#\:sanity-checks4> یا «بررسی‌های سلامت در DHCPv6» \%<#\:sanity-checks6>\& را ببینید.
.sp
برای تعداد زیادی از اجاره‌ها، ممکن است تکمیل این دستور مدتی زمان ببرد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
هر دو دستور \fBextended\-info4\-upgrade\fP و \fBextended\-info6\-upgrade\fP برای استفادهٔ یک‌باره پس از ارتقا به نگارشی از Kea در نظر گرفته شده‌اند که به طور کامل از Bulk Leasequery در بک‌اندهای پایگاه داده پشتیبانی می‌کند. این دستورها برای استفادهٔ مکرر نیستند و در نگارش‌های آیندهٔ Kea حذف خواهند شد.
.UNINDENT
.UNINDENT
.SS \fBlibdhcp_legal_log.so\fP: ثبت وقایع قانونی (Forensic Logging)
.sp
کتابخانهٔ قلاب Forensic Logging، قلاب‌هایی را فراهم می‌کند که گزارش تفصیلی تخصیص‌ها، تمدیدها، آزادسازی‌ها و سایر رویدادهای مربوط به اجاره را در مجموعه‌ای از فایل‌های لاگ ثبت می‌نمایند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
کتابخانهٔ \fBlibdhcp_legal_log.so\fP بخشی از کد منبع‌باز است و در دسترس همهٔ کاربران Kea قرار دارد.
این کتابخانه پیش‌تر تنها در دسترس مشتریان ISC دارای قرارداد پشتیبانی تجاری بود.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این کتابخانه فقط می‌تواند توسط فرایندهای \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> یا \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> بارگذاری شود.
.UNINDENT
.UNINDENT
.sp
در بسیاری از حوزه‌های قضایی، شرکت‌ها \- به ویژه ISPها \- باید اطلاعات مربوط به نشانی‌هایی را که به کلاینت‌های DHCP اجاره داده‌اند ثبت کنند. این کتابخانه برای کمک به برآورده کردن این الزام طراحی شده است. اگر اطلاعاتی که ثبت می‌کند کافی باشد، می‌توان مستقیماً از آن استفاده کرد.
.sp
چنانچه حوزه‌ای قضایی نیازمند ذخیرهٔ اطلاعات متفاوتی باشد، کاربران می‌توانند از قابلیت قالب‌بندی سفارشی برای استخراج اطلاعات از بستهٔ درخواست ورودی یا بستهٔ پاسخ خروجی استفاده کنند. به مدیران سیستم توصیه می‌شود با احتیاط از این ویژگی استفاده نمایند، زیرا ممکن است بر کارایی کارساز اثر بگذارد. از قالب سفارشی نمی‌توان برای دستورهای کانال کنترل استفاده کرد.
.sp
همچنین می‌توان از این کتابخانه به عنوان الگو یا نمونه‌ای برای قلاب ثبت گزارش سفارشی خود کاربر استفاده کرد. ثبت گزارش به عنوان مجموعه‌ای از قلاب‌ها انجام می‌شود تا امکان سفارشی‌سازی آن برای هر نیاز خاصی وجود داشته باشد؛ تغییر دادن یک کتابخانهٔ قلاب بسیار ساده‌تر و امن‌تر از دستکاری کد هسته است. علاوه بر این، با استفاده از ویژگی‌های قلاب، کاربرانی که نیازی به ثبت این اطلاعات ندارند می‌توانند آن را کنار بگذارند و از افت کارایی جلوگیری کنند..SS نام‌گذاری فایل لاگ (Log File Naming)
.sp
نام‌های فایل‌های لاگ از یک الگوی مشخص پیروی می‌کنند.
.sp
در صورت استفاده از \fBday\fP، \fBmonth\fP یا \fByear\fP به‌عنوان واحد زمانی، نام فایل از قالب زیر
پیروی می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
path/base\-name.CCYYMMDD.txt
.EE
.UNINDENT
.UNINDENT
.sp
که در آن \fBCC\fP بیانگر قرن، \fBYY\fP نشان‌دهندهٔ سال،
\fBMM\fP نشان‌دهندهٔ ماه، و \fBDD\fP نشان‌دهندهٔ روز است.
.sp
در صورت استفاده از \fBsecond\fP به‌عنوان واحد زمانی، نام فایل از قالب زیر پیروی می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
path/base\-name.TXXXXXXXXXXXXXXXXXXXX.txt
.EE
.UNINDENT
.UNINDENT
.sp
که در آن \fBXXXXXXXXXXXXXXXXXXXX\fP بیانگر زمان بر حسب ثانیه از ابتدای
مبدأ یونیکس (UNIX epoch) است.
.sp
هنگام استفاده از \fBsecond\fP به‌عنوان واحد زمانی، فایل پس از سپری شدن
تعداد ثانیه‌های مشخص‌شده در \fBcount\fP چرخانده می‌شود. در مقابل، هنگام استفاده از \fBday\fP، \fBmonth\fP
یا \fByear\fP به‌عنوان واحد زمانی، فایل هر زمان که بر اساس مورد، شمارش (\fBcount\fP) روز،
ماه یا سال آغاز شود، چرخانده می‌شود.
.sp
مقدارهای \fB\(dqpath\(dq\fP و \fB\(dqbase\-name\(dq\fP همان‌طور که در زیر شرح داده شده
در پیکربندی مشخص می‌شوند؛ بخش «پیکربندی قلاب‌های ثبت لاگ قضایی (Configuring the Forensic Logging Hooks)» را ببینید\&.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
هنگام اجرای کارسازهای Kea برای هر دو پروتکل DHCPv4 و DHCPv6، نام‌های لاگ
باید متمایز باشند. مثال‌های موجود در «پیکربندی قلاب‌های ثبت لاگ قضایی (Configuring the Forensic Logging Hooks)» را ببینید\&.
.UNINDENT
.UNINDENT
.SS پیکربندی قلاب‌های ثبت لاگ قضایی (Configuring the Forensic Logging Hooks)
.sp
برای استفاده از این قابلیت، کتابخانهٔ قلاب (hook library) باید در
پیکربندی پودمان‌های کارساز DHCP مورد نظر گنجانده شود. \fBlibdhcp_legal_log.so\fP
می‌تواند لاگ‌ها را در یک فایل متنی یا در یک پایگاه‌داده ذخیره کند (ایجاد شده با استفاده از
\fBkea\-admin\fP \%<#\:std-iscman-kea-admin>؛ بخش‌های «ساخت اولیهٔ پایگاه‌دادهٔ MySQL» \%<#\:mysql-database-create> و «ساخت اولیهٔ پایگاه‌دادهٔ PostgreSQL» \%<#\:pgsql-database-create> را ببینید).
این کتابخانه در کنار کتابخانه‌های Kea در
\fB\(dq[kea\-install\-dir]/var/log/kea\(dq\fP نصب می‌شود، که در آن \fBkea\-install\-dir\fP توسط
گزینهٔ \fB\-\-prefix\fP در meson setup تعیین می‌شود و به‌طور پیش‌فرض
\fB/usr/local\fP است\&. با فرض مقدار پیش‌فرض، \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> را می‌توان به‌صورت زیر برای
بارگذاری \fBlibdhcp_legal_log.so\fP پیکربندی کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqDhcp4\(dq: {
        \(dqhooks\-libraries\(dq: [
            {
                \(dqlibrary\(dq: \(dqlibdhcp_legal_log.so\(dq,
                \(dqparameters\(dq: {
                    \(dqpath\(dq: \(dq/var/log/kea\(dq,
                    \(dqbase\-name\(dq: \(dqkea\-forensic4\(dq
                }
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
برای \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6>، پیکربندی به این صورت است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqDhcp6\(dq: {
        \(dqhooks\-libraries\(dq: [
            {
                \(dqlibrary\(dq: \(dqlibdhcp_legal_log.so\(dq,
                \(dqparameters\(dq: {
                    \(dqpath\(dq: \(dq/var/log/kea\(dq,
                    \(dqbase\-name\(dq: \(dqkea\-forensic6\(dq
                }
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پارامترهای کتابخانهٔ قلاب برای پیکربندی فایل متنی عبارتند از:
.INDENT 0.0
.IP \(bu 2
\fBpath\fP \- دایرکتوری‌ای که فایل(های) لاگ قضایی در آن نوشته خواهند شد.
مقدار پیش‌فرض \fB\(dq[kea\-install\-dir]/var/log/kea\(dq\fP است\&. این دایرکتوری
باید وجود داشته باشد.
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
از نسخهٔ Kea 2.7.9 به بعد، فایل‌های لاگ قانونی فقط می‌توانند در دایرکتوری خروجی
تعیین‌شده در حین کامپایل نوشته شوند: \fB\(dq[kea\-install\-dir]/var/log/kea\(dq\fP\&. این
مسیر را می‌توان در زمان راه‌اندازی با تنظیم متغیر محیطی
\fBKEA_LEGAL_LOG_DIR\fP روی مسیر دلخواه بازنویسی کرد. اگر مسیری غیر از این مقدار
در \fBpath\fP استفاده شود، Kea خطایی صادر کرده و از شروع به کار خودداری می‌کند، یا در صورت
در حال اجرا بودن، یک خطای جبران‌ناپذیر ثبت می‌کند. برای سهولت در استفاده، کافی است پارامتر \fBpath\fP
را حذف کنید.
.UNINDENT
.UNINDENT
.INDENT 0.0
.IP \(bu 2
\fBbase\-name\fP \- یک مقدار دلخواه که همراه با تاریخ فعلی سیستم برای
تشکیل نام فایل لاگ قضایی جاری استفاده می‌شود. مقدار پیش‌فرض آن
\fBkea\-legal\fP است\&.
.IP \(bu 2
\fBtime\-unit\fP \- واحد زمانی مورد استفاده برای چرخش فایل لاگ را پیکربندی می‌کند. مقدارهای
معتبر عبارتند از \fBsecond\fP، \fBday\fP، \fBmonth\fP یا \fByear\fP\&. مقدار پیش‌فرض آن
\fBday\fP است\&.
.IP \(bu 2
\fBcount\fP \- تعداد واحدهای زمانی که باید تا زمان چرخش فایل لاگ
سپری شوند را پیکربندی می‌کند. این مقدار می‌تواند هر عدد مثبتی باشد، یا 0 که چرخش لاگ
را غیرفعال می‌کند. مقدار پیش‌فرض آن 1 است.
.UNINDENT
.sp
اگر چرخش لاگ غیرفعال باشد، هنگام بارگذاری کتابخانه یک فایل جدید ایجاد می‌شود؛
نام فایل جدید با هر نام فایل قبلی متفاوت خواهد بود.
.sp
اقدامات اضافی را می‌توان درست قبل از بستن فایل قدیمی و پس از باز کردن فایل جدید
انجام داد. این اقدامات باید به یک فایل اجرایی یا اسکریپت خارجی اشاره داشته باشند
و با تنظیمات زیر پیکربندی می‌شوند:
.INDENT 0.0
.IP \(bu 2
\fBprerotate\fP \- یک فایل اجرایی یا اسکریپت خارجی که با نام فایلی که
قرار است بسته شود فراخوانی می‌شود. Kea منتظر پایان فرایند نمی‌ماند.
.IP \(bu 2
\fBpostrotate\fP \- یک فایل اجرایی یا اسکریپت خارجی که با نام فایلی که
باز شده است فراخوانی می‌شود. Kea منتظر پایان فرایند نمی‌ماند.
.UNINDENT
.sp
این فایل‌های اجرایی باید در دایرکتوری \fB\(dq[kea\-install\-dir]/share/kea/scripts/\(dq\fP
ذخیره شوند که می‌توان آن را هنگام راه‌اندازی با تنظیم متغیر محیطی
\fBKEA_HOOK_SCRIPTS_PATH\fP روی یک مسیر متفاوت بازنویسی کرد.
.sp
می‌توان قالب‌بندی سفارشی را برای ثبت اطلاعاتی فعال کرد که از بستهٔ درخواست
کلاینت یا از بستهٔ پاسخ کارساز قابل استخراج هستند.
با احتیاط استفاده کنید زیرا ممکن است بر عملکرد کارساز تأثیر بگذارد.
قالب سفارشی نمی‌تواند برای دستورهای کانال کنترلی استفاده شود.
دو پارامتر را می‌توان برای این هدف، به‌صورت هم‌زمان یا جداگانه استفاده کرد:
.INDENT 0.0
.IP \(bu 2
\fBrequest\-parser\-format\fP \- یک عبارت ارزیابی‌شده و تجزیه‌شده که برای استخراج و
ثبت داده‌ها از بستهٔ ورودی استفاده می‌شود.
.IP \(bu 2
\fBresponse\-parser\-format\fP \- یک عبارت ارزیابی‌شده و تجزیه‌شده که برای استخراج و
ثبت داده‌ها از بستهٔ پاسخ کارساز استفاده می‌شود.
.UNINDENT
.sp
برای مشاهدهٔ فهرستی از عبارت‌ها، به بخش «استفاده از عبارت‌ها در دسته‌بندی» \%<#\:classification-using-expressions> مراجعه کنید.
در صورت پیکربندی هر یک از \fBrequest\-parser\-format\fP یا \fBresponse\-parser\-format\fP،
قالب لاگ پیش‌فرض استفاده نخواهد شد. اگر هر دوی آن‌ها پیکربندی شوند، پیام لاگ حاصل با
الحاق داده‌های استخراج‌شده از درخواست و داده‌های استخراج‌شده از پاسخ ساخته می‌شود.
.sp
قالب‌بندی سفارشی ثبت لاگ در چندین خط را با استفاده از رشتهٔ هگز 0x0a
(کد ASCII برای خط جدید) امکان‌پذیر می‌کند. در فایل لاگ، در ابتدای هر خط
برچسب زمانی لاگ اضافه می‌شود. برای بک‌اند پایگاه‌داده، داده‌ها
(شامل نویسهٔ خط جدید) در همان مدخل ذخیره می‌شوند.
.sp
مثال‌ها:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqDhcp6\(dq: {
        \(dqhooks\-libraries\(dq: [
            {
                \(dqlibrary\(dq: \(dqlibdhcp_legal_log.so\(dq,
                \(dqparameters\(dq: {
                    \(dqpath\(dq: \(dq/var/log/kea\(dq,
                    \(dqbase\-name\(dq: \(dqkea\-forensic6\(dq,
                    \(dqrequest\-parser\-format\(dq: \(dq\(aqfirst line\(aq + 0x0a + \(aqsecond line\(aq\(dq,
                    \(dqresponse\-parser\-format\(dq: \(dq\(aqalso second line\(aq + 0x0a + \(aqthird line\(aq\(dq
                }
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
برخی داده‌ها ممکن است در درخواست یا فقط در پاسخ در دسترس باشند؛
داده‌های موجود در بستهٔ درخواست ممکن است با داده‌های موجود در بستهٔ پاسخ تفاوت داشته باشند.
.sp
زمینهٔ lease\-client فقط با استفاده از قالب پیش‌فرض قابل چاپ است، زیرا این
اطلاعات مستقیماً در بستهٔ درخواست یا بستهٔ پاسخ ذخیره نمی‌شود.
.sp
پارامتر \fBtimestamp\-format\fP می‌تواند برای تغییر برچسب زمانی ثبت‌شده
در ابتدای هر خط استفاده شود. قالب‌بندی‌های مجاز مواردی هستند که توسط
strftime پشتیبانی می‌شوند به‌علاوهٔ قالب اضافی \(aq%Q\(aq که زیرواحدهای میکروثانیه را اضافه می‌کند.
مقدار پیش‌فرض عبارت است از: \(dq%Y\-%m\-%d %H:%M:%S %Z\(dq. این پارامتر برای
بک‌اندهای پایگاه‌داده که در آن‌ها برچسب زمانی در سطح طرحواره (schema) تعریف شده است، اثری ندارد.
.sp
مثال‌ها:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqDhcp6\(dq: {
        \(dqhooks\-libraries\(dq: [
            {
                \(dqlibrary\(dq: \(dqlibdhcp_legal_log.so\(dq,
                \(dqparameters\(dq: {
                    \(dqpath\(dq: \(dq/var/log/kea\(dq,
                    \(dqbase\-name\(dq: \(dqkea\-forensic6\(dq,
                    \(dqtimestamp\-format\(dq: \(dq%H%t%w %F%%\(dq
                }
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پارامترهای اضافی برای اتصال پایگاه‌داده را می‌توان مشخص کرد، برای مثال:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp6\(dq: {
    \(dqhooks\-libraries\(dq: [
      {
        \(dqlibrary\(dq: \(dqlibdhcp_legal_log.so\(dq,
        \(dqparameters\(dq: {
          \(dqname\(dq: \(dqdatabase\-name\(dq,
          \(dqpassword\(dq: \(dq1234\(dq,
          \(dqtype\(dq: \(dqmysql\(dq,
          \(dquser\(dq: \(dquser\-name\(dq
        }
      }
    ]
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
برای اطلاعات مشخص‌تر دربارهٔ پارامترهای مرتبط با پایگاه‌داده، لطفاً به
«پیکربندی پایگاه‌دادهٔ اجاره‌ها» \%<#\:database-configuration4> و «پیکربندی پایگاه‌دادهٔ اجاره‌ها» \%<#\:database-configuration6>\& مراجعه کنید.
.sp
اگر تمایل دارید ثبت لاگ قضایی را به زیرشبکه‌های خاصی محدود کنید،
پارامتر بولی \fB\(dqlegal\-logging\(dq\fP می‌تواند در یک زمینهٔ کاربری (user context)
از این زیرشبکه‌ها مشخص شود. برای مثال:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqDhcp4\(dq: {
        \(dqsubnet4\(dq: [
            {
                \(dqid\(dq: 1,
                \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
                \(dqpools\(dq: [
                    {
                        \(dqpool\(dq: \(dq192.0.2.1 \- 192.0.2.200\(dq
                    }
                ],
                \(dquser\-context\(dq: {
                    \(dqlegal\-logging\(dq: false
                }
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این پیکربندی ثبت لاگ قضایی را برای زیرشبکهٔ \(dq192.0.2.0/24\(dq غیرفعال می‌کند. اگر
پارامتر \fB\(dqlegal\-logging\(dq\fP مشخص نشده باشد، مقدار پیش‌فرض آن \fBtrue\fP خواهد بود که
ثبت لاگ قضایی را برای زیرشبکه فعال می‌کند.
.sp
مثال زیر نحوهٔ غیرفعال کردن انتخابی ثبت لاگ قضایی را برای یک
زیرشبکهٔ IPv6 نشان می‌دهد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqDhcp6\(dq: {
        \(dqsubnet6\(dq: [
            {
                \(dqid\(dq: 1,
                \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
                \(dqpools\(dq: [
                    {
                        \(dqpool\(dq: \(dq2001:db8:1::1\-2001:db8:1::ffff\(dq
                    }
                ],
                \(dquser\-context\(dq: {
                    \(dqlegal\-logging\(dq: false
                }
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
برای کسب اطلاعات بیشتر دربارهٔ زمینه‌های کاربری در پیکربندی Kea، به
«زمینه‌های کاربری در IPv4» \%<#\:dhcp4-user-contexts> و «زمینه‌های کاربری در IPv6» \%<#\:dhcp6-user-contexts> مراجعه کنید..SS "ورودی‌های گزارش DHCPv4 (DHCPv4 Log Entries)"
.sp
برای DHCPv4، این کتابخانه بر اساس پیام‌های DHCPREQUEST،‏ DHCPDECLINE،‏ DHCPRELEASE و غیره، و پاسخ‌های آن‌ها ورودی ایجاد می‌کند. بسته‌ها و اجاره‌های حاصل با رهگیری از طریق نقاط قلاب (hook points) زیر در نظر گرفته می‌شوند:
.INDENT 0.0
.IP \(bu 2
\fBpkt4_receive\fP
.IP \(bu 2
\fBleases4_committed\fP
.IP \(bu 2
\fBpkt4_send\fP
.IP \(bu 2
\fBlease4_release\fP
.IP \(bu 2
\fBlease4_decline\fP
.UNINDENT
.sp
هر ورودی یک رشته‌ی واحد بدون نشانگرهای انتهای خط درون‌متنی و همراه با برچسب زمان در ابتدا است، و بخش‌های زیر را دارد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
timestamp address duration device\-id {client\-info} {relay\-info} {user\-context}
.EE
.UNINDENT
.UNINDENT
.sp
به طوری که:
.INDENT 0.0
.IP \(bu 2
\fBtimestamp\fP \- تاریخ و زمانی که ورودی گزارش نوشته شده است، در قالب strftime با فرمت
\(dq%Y\-%m\-%d %H:%M:%S %Z\(dq (\(dq%Z\(dq نام منطقه زمانی است).
.IP \(bu 2
\fBaddress\fP \- نشانی IPv4 اجاره‌داده‌شده‌ی اعطا شده، و اینکه آیا واگذار (assigned)،
تمدید (renewed)، یا آزاد (released) شده است.
.IP \(bu 2
\fBduration\fP \- طول عمر اجاره که بر حسب روز (در صورت وجود)، ساعت،
دقیقه و ثانیه بیان می‌شود. طول عمر اجاره‌ی 0xFFFFFFFF با متن
\(dqinfinite duration\(dq مشخص می‌شود. این اطلاعات هنگام
آزادسازی اجاره ارائه نمی‌شود.
.IP \(bu 2
\fBdevice\-id\fP \- نشانی سخت‌افزاری کلاینت که به صورت یک نوع عددی و
رشته‌ای از ارقام هگزادسیمال نشان داده می‌شود.
.IP \(bu 2
\fBclient\-info\fP \- گزینه‌ی شناسه کلاینت DHCP (گزینه 61) در صورت وجود، که به صورت یک
رشته هگز نمایش داده می‌شود. هنگامی که محتوای آن قابل چاپ باشد، نمایش داده می‌شود.
.IP \(bu 2
\fBrelay\-info\fP \- برای بسته‌های رله‌شده، مقادیر \fBgiaddr\fP و گزینه‌های RAI شامل \fBcircuit\-id\fP،
\fBremote\-id\fP، و \fBsubscriber\-id\fP (زیرگزینه‌های ۱، ۲ و ۶ از گزینه ۸۲)،
در صورت وجود. مقادیر \fBcircuit\-id\fP و \fBremote\-id\fP به صورت رشته‌های
هگز ارائه می‌شوند. هنگامی که محتوای آن‌ها قابل چاپ باشد، نمایش داده می‌شود.
.IP \(bu 2
\fBuser\-context\fP \- بافت کاربری اختیاری مرتبط با اجاره.
.UNINDENT
.sp
برای مثال (شکست‌های خط در اینجا صرفاً برای خوانایی اضافه شده‌اند؛ آن‌ها در فایل
گزارش وجود ندارند):
.INDENT 0.0
.INDENT 3.5
.sp
.EX
2018\-01\-06 01:02:03 CET Address: 192.2.1.100 has been renewed for 1 hrs 52 min 15 secs to a device with hardware address:
hwtype=1 08:00:2b:02:3f:4e, client\-id: 17:34:e2:ff:09:92:54 connected via relay at address: 192.2.16.33,
identified by circuit\-id: 68:6f:77:64:79 (howdy) and remote\-id: 87:f6:79:77:ef
.EE
.UNINDENT
.UNINDENT
.sp
یا برای آزادسازی:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
2018\-01\-06 01:02:03 CET Address: 192.2.1.100 has been released from a device with hardware address:
hwtype=1 08:00:2b:02:3f:4e, client\-id: 17:34:e2:ff:09:92:54 connected via relay at address: 192.2.16.33,
identified by circuit\-id: 68:6f:77:64:79 (howdy) and remote\-id: 87:f6:79:77:ef
.EE
.UNINDENT
.UNINDENT
.sp
علاوه بر ثبت فعالیت‌های اجاره بر اساس ترافیک کلاینت DHCPv4،
این کتابخانه‌ی قلاب همچنین ورودی‌هایی را برای دستورهای کانال کنترلی مدیریت اجاره
زیر ثبت می‌کند: \fBlease4\-add\fP،‏ \fBlease4\-update\fP، و \fBlease4\-del\fP\&. این موارد نمی‌توانند
قالب‌بندی سفارشی داشته باشند. هر ورودی یک رشته‌ی واحد بدون نشانگرهای انتهای خط
درون‌متنی است، و به طور معمول ساختاری به شکل زیر دارد:
.sp
\fBlease4\-add:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
*timestamp* Administrator added a lease of address: *address* to a device with hardware address: *device\-id*
.EE
.UNINDENT
.UNINDENT
.sp
بسته به آرگومان‌های دستور add، ممکن است شامل
client\-id و duration نیز باشد.
.sp
مثال:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
2018\-01\-06 01:02:03 CET Administrator added a lease of address: 192.0.2.202 to a device with hardware address:
1a:1b:1c:1d:1e:1f for 1 days 0 hrs 0 mins 0 secs
.EE
.UNINDENT
.UNINDENT
.sp
\fBlease4\-update:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
*timestamp* Administrator updated information on the lease of address: *address* to a device with hardware address: *device\-id*
.EE
.UNINDENT
.UNINDENT
.sp
بسته به آرگومان‌های دستور update، ممکن است شامل
client\-id و مدت‌زمان اجاره (lease duration) نیز باشد.
.sp
مثال:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
2018\-01\-06 01:02:03 CET Administrator updated information on the lease of address: 192.0.2.202 to a device
with hardware address: 1a:1b:1c:1d:1e:1f, client\-id: 1234567890
.EE
.UNINDENT
.UNINDENT
.sp
\fBlease4\-del:\fP عملیات حذف دارای دو شکل است، یکی بر اساس نشانی و دیگری بر اساس
شناسه و نوع شناسه:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
*timestamp* Administrator deleted the lease for address: *address*
.EE
.UNINDENT
.UNINDENT
.sp
یا
.INDENT 0.0
.INDENT 3.5
.sp
.EX
*timestamp* Administrator deleted a lease for a device identified by: *identifier\-type* of *identifier*
.EE
.UNINDENT
.UNINDENT
.sp
در حال حاضر تنها نوع \fB@b hw\-address\fP (نشانی سخت‌افزاری) پشتیبانی می‌شود.
.sp
مثال‌ها:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
2018\-01\-06 01:02:03 CET Administrator deleted the lease for address: 192.0.2.202

2018\-01\-06 01:02:12 CET Administrator deleted a lease for a device identified by: hw\-address of 1a:1b:1c:1d:1e:1f
.EE
.UNINDENT
.UNINDENT
.sp
اگر کتابخانه‌ی قلاب دسترسی‌پذیری بالا (High Availability) فعال باشد، شریک (partner) به طور دوره‌ای دستورهای
اجاره را با قالبی مشابه ارسال می‌کند؛ تنها تفاوت این است که صادرکننده‌ی
دستور به جای \(dqAdministrator\(dq برابر \(dqHA partner\(dq خواهد بود.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
*timestamp* HA partner added ...
.EE
.UNINDENT
.UNINDENT
.sp
یا
.INDENT 0.0
.INDENT 3.5
.sp
.EX
*timestamp* HA partner updated ...
.EE
.UNINDENT
.UNINDENT
.sp
یا
.INDENT 0.0
.INDENT 3.5
.sp
.EX
*timestamp* HA partner deleted ...
.EE
.UNINDENT
.UNINDENT
.sp
گزینه‌های \fBrequest\-parser\-format\fP و \fBresponse\-parser\-format\fP می‌توانند به ترتیب
برای استخراج و ثبت داده‌ها از بسته‌ی ورودی و بسته‌ی پاسخ کارساز استفاده شوند.
مقدار پیکربندی‌شده، یک عبارت تجزیه‌شده‌ی ارزیابی‌شونده است که یک رشته را بازمی‌گرداند.
فهرستی از توکن‌ها در فرآیند رده‌بندی کارساز توصیف شده است.
با احتیاط استفاده شود زیرا ممکن است بر کارایی کارساز تأثیر بگذارد.
اگر هر یک از آن‌ها پیکربندی شود، قالب پیش‌فرض ثبت گزارش استفاده نمی‌شود.
اگر هر دوی آن‌ها پیکربندی شوند، پیام گزارش حاصل با الحاق داده‌های ثبت‌شده‌ی
استخراج‌شده از درخواست و داده‌های ثبت‌شده‌ی استخراج‌شده از پاسخ ساخته می‌شود.
.sp
قالب‌بندی سفارشی امکان ثبت گزارش در چند خط را با استفاده از رشته هگز 0x0a
(کد ASCII برای خط جدید) فراهم می‌کند. در مورد فایل گزارش، در ابتدای هر خط برچسب
زمان گزارش قرار می‌گیرد. برای بک‌اند پایگاه داده، داده‌ها (شامل نویسه خط جدید)
در همان ورودی ذخیره می‌شوند.
.sp
مثال‌ها:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp4\(dq: {
    \(dqhooks\-libraries\(dq: [
      {
        \(dqlibrary\(dq: \(dqlibdhcp_legal_log.so\(dq,
        \(dqparameters\(dq: {
          \(dqname\(dq: \(dqdatabase\-name\(dq,
          \(dqpassword\(dq: \(dq1234\(dq,
          \(dqtype\(dq: \(dqmysql\(dq,
          \(dquser\(dq: \(dquser\-name\(dq,
          \(dqrequest\-parser\-format\(dq: \(dq\(aqlog entry\(aq + 0x0a + \(aqsame log entry\(aq\(dq,
          \(dqresponse\-parser\-format\(dq: \(dq\(aqalso same log entry\(aq + 0x0a + \(aqagain same log entry\(aq\(dq
        }
      }
    ]
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
برخی داده‌ها ممکن است فقط در درخواست یا فقط در پاسخ در دسترس باشند، و برخی
داده‌ها در بسته‌ی ورودی ممکن است با داده‌های موجود در بسته‌ی پاسخ تفاوت داشته باشند.
.sp
مثال‌ها:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqrequest\-parser\-format\(dq: \(dqifelse(pkt4.msgtype == 4 or pkt4.msgtype == 7, \(aqAddress: \(aq + ifelse(option[50].exists, addrtotext(option[50].hex), addrtotext(pkt4.ciaddr)) + \(aq has been released from a device with hardware address: hwtype=\(aq + substring(hexstring(pkt4.htype, \(aq\(aq), 7, 1) + \(aq \(aq + hexstring(pkt4.mac, \(aq:\(aq) + ifelse(option[61].exists, \(aq, client\-id: \(aq + hexstring(option[61].hex, \(aq:\(aq), \(aq\(aq) + ifelse(pkt4.giaddr == 0.0.0.0, \(aq\(aq, \(aq connected via relay at address: \(aq + addrtotext(pkt4.giaddr) + ifelse(option[82].option[1].exists, \(aq, circuit\-id: \(aq + hexstring(option[82].option[1].hex, \(aq:\(aq), \(aq\(aq) + ifelse(option[82].option[2].exists, \(aq, remote\-id: \(aq + hexstring(option[82].option[2].hex, \(aq:\(aq), \(aq\(aq) + ifelse(option[82].option[6].exists, \(aq, subscriber\-id: \(aq + hexstring(option[82].option[6].hex, \(aq:\(aq), \(aq\(aq)), \(aq\(aq)\(dq,
    \(dqresponse\-parser\-format\(dq: \(dqifelse(pkt4.msgtype == 5, \(aqAddress: \(aq + addrtotext(pkt4.yiaddr) + \(aq has been assigned for \(aq + uint32totext(option[51].hex) + \(aq seconds to a device with hardware address: hwtype=\(aq + substring(hexstring(pkt4.htype, \(aq\(aq), 7, 1) + \(aq \(aq + hexstring(pkt4.mac, \(aq:\(aq) + ifelse(option[61].exists, \(aq, client\-id: \(aq + hexstring(option[61].hex, \(aq:\(aq), \(aq\(aq) + ifelse(pkt4.giaddr == 0.0.0.0, \(aq\(aq, \(aq connected via relay at address: \(aq + addrtotext(pkt4.giaddr) + ifelse(option[82].option[1].exists, \(aq, circuit\-id: \(aq + hexstring(option[82].option[1].hex, \(aq:\(aq), \(aq\(aq) + ifelse(option[82].option[2].exists, \(aq, remote\-id: \(aq + hexstring(option[82].option[2].hex, \(aq:\(aq), \(aq\(aq) + ifelse(option[82].option[6].exists, \(aq, subscriber\-id: \(aq + hexstring(option[82].option[6].hex, \(aq:\(aq), \(aq\(aq)), \(aq\(aq)\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
جزئیات:
.sp
این پیکربندی داده‌های زیر را در هنگام درخواست (request) و تمدید (renew) ثبت خواهد کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Address: 192.2.1.100 has been assigned for 6735 seconds to a device with hardware address: hwtype=1 08:00:2b:02:3f:4e, client\-id: 17:34:e2:ff:09:92:54 connected via relay at address: 192.2.16.33, circuit\-id: 68:6f:77:64:79, remote\-id: 87:f6:79:77:ef, subscriber\-id: 1a:2b:3c:4d:5e:6f
.EE
.UNINDENT
.UNINDENT
.sp
این پیکربندی داده‌های زیر را در هنگام آزادسازی (release) و رد کردن (decline) ثبت خواهد کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Address: 192.2.1.100 has been released from a device with hardware address: hwtype=1 08:00:2b:02:3f:4e, client\-id: 17:34:e2:ff:09:92:54 connected via relay at address: 192.2.16.33, circuit\-id: 68:6f:77:64:79, remote\-id: 87:f6:79:77:ef, subscriber\-id: 1a:2b:3c:4d:5e:6f
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه‌ی مشابهی را می‌توان تنها با پیکربندی \fBrequest\-parser\-format\fP به دست آورد.
.sp
مثال‌ها:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqrequest\-parser\-format\(dq: \(dqifelse(pkt4.msgtype == 3, \(aqAddress: \(aq + ifelse(option[50].exists, addrtotext(option[50].hex), addrtotext(pkt4.ciaddr)) + \(aq has been assigned\(aq + ifelse(option[51].exists, \(aq for \(aq + uint32totext(option[51].hex) + \(aq seconds\(aq, \(aq\(aq) + \(aq to a device with hardware address: hwtype=\(aq + substring(hexstring(pkt4.htype, \(aq\(aq), 7, 1) + \(aq \(aq + hexstring(pkt4.mac, \(aq:\(aq) + ifelse(option[61].exists, \(aq, client\-id: \(aq + hexstring(option[61].hex, \(aq:\(aq), \(aq\(aq) + ifelse(pkt4.giaddr == 0.0.0.0, \(aq\(aq, \(aq connected via relay at address: \(aq + addrtotext(pkt4.giaddr) + ifelse(option[82].option[1].exists, \(aq, circuit\-id: \(aq + hexstring(option[82].option[1].hex, \(aq:\(aq), \(aq\(aq) + ifelse(option[82].option[2].exists, \(aq, remote\-id: \(aq + hexstring(option[82].option[2].hex, \(aq:\(aq), \(aq\(aq) + ifelse(option[82].option[6].exists, \(aq, subscriber\-id: \(aq + hexstring(option[82].option[6].hex, \(aq:\(aq), \(aq\(aq)), ifelse(pkt4.msgtype == 4 or pkt4.msgtype == 7, \(aqAddress: \(aq + ifelse(option[50].exists, addrtotext(option[50].hex), addrtotext(pkt4.ciaddr)) + \(aq has been released from a device with hardware address: hwtype=\(aq + substring(hexstring(pkt4.htype, \(aq\(aq), 7, 1) + \(aq \(aq + hexstring(pkt4.mac, \(aq:\(aq) + ifelse(option[61].exists, \(aq, client\-id: \(aq + hexstring(option[61].hex, \(aq:\(aq), \(aq\(aq) + ifelse(pkt4.giaddr == 0.0.0.0, \(aq\(aq, \(aq connected via relay at address: \(aq + addrtotext(pkt4.giaddr) + ifelse(option[82].option[1].exists, \(aq, circuit\-id: \(aq + hexstring(option[82].option[1].hex, \(aq:\(aq), \(aq\(aq) + ifelse(option[82].option[2].exists, \(aq, remote\-id: \(aq + hexstring(option[82].option[2].hex, \(aq:\(aq), \(aq\(aq) + ifelse(option[82].option[6].exists, \(aq, subscriber\-id: \(aq + hexstring(option[82].option[6].hex, \(aq:\(aq), \(aq\(aq)), \(aq\(aq))\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
جزئیات:.SS "ورودی‌های گزارش DHCPv6 (DHCPv6 Log Entries)"
.sp
برای DHCPv6، کتابخانه بر اساس پیام‌های REQUEST،‏ RENEW،‏ RELEASE و DECLINE و غیره و پاسخ‌های آن‌ها ورودی ایجاد می‌کند. بسته‌ها و اجاره‌های حاصل در نظر گرفته شده و از طریق نقاط قلاب (hook points) زیر رهگیری می‌شوند:
.INDENT 0.0
.IP \(bu 2
\fBpkt6_receive\fP
.IP \(bu 2
\fBleases6_committed\fP
.IP \(bu 2
\fBpkt6_send\fP
.IP \(bu 2
\fBlease6_release\fP
.IP \(bu 2
\fBlease6_decline\fP
.UNINDENT
.sp
هر ورودی یک رشته منفرد بدون نشانگرهای انتهای خط درون‌متنی و با یک برچسب زمانی (timestamp) در ابتدا است که بخش‌های زیر را شامل می‌شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
timestamp address duration device\-id {relay\-info}* {user\-context}
.EE
.UNINDENT
.UNINDENT
.sp
که در آن:
.INDENT 0.0
.IP \(bu 2
\fBtimestamp\fP \- تاریخ و زمان ثبت ورودی گزارش، در قالب strftime به صورت
\(dq%Y\-%m\-%d %H:%M:%S %Z\(dq (که \(dq%Z\(dq نام منطقه زمانی است).
.IP \(bu 2
\fBaddress\fP \- آدرس یا پیشوند IPv6 اجاره داده‌شده، و وضعیت آن از نظر
تخصیص‌یافته، تمدیدشده یا آزادشده بودن.
.IP \(bu 2
\fBduration\fP \- طول عمر اجاره بیان‌شده به روز (در صورت وجود)، ساعت،
دقیقه و ثانیه. طول عمر اجاره با مقدار 0xFFFFFFFF با متن
\(dqinfinite duration.\(dq مشخص خواهد شد. این اطلاعات هنگام
آزادسازی اجاره ارائه نمی‌شود.
.IP \(bu 2
\fBdevice\-id\fP \- شناسه DUID و آدرس سخت‌افزاری کلاینت (در صورت وجود).
.IP \(bu 2
\fBrelay\-info\fP \- برای بسته‌های رله‌شده، محتوای پیام‌های کارگزار رله، و گزینه‌های
\fBremote\-id\fP (کد ۳۷)، \fBsubscriber\-id\fP (کد ۳۸) و \fBinterface\-id\fP (کد ۱۸)
در صورت وجود. توجه داشته باشید که گزینه \fBinterface\-id\fP، در صورت وجود،
کل رابطی را که کارگزار رله پیام را روی آن دریافت کرده مشخص می‌کند.
این معمولاً به یک پیوند واحد در شبکه ترجمه می‌شود، اما
به توپولوژی خاص شبکه بستگی دارد. با این وجود، این
اطلاعات مفیدی برای تعیین دقیق‌تر مکان دستگاه است،
بنابراین در صورت وجود ثبت می‌شود.
.IP \(bu 2
\fBuser\-context\fP \- بافت کاربر (user context) اختیاری مرتبط با اجاره.
.UNINDENT
.sp
به عنوان مثال (شکست‌های خط در اینجا برای خوانایی اضافه شده‌اند؛ آن‌ها
در فایل گزارش وجود ندارند):
.INDENT 0.0
.INDENT 3.5
.sp
.EX
2018\-01\-06 01:02:03 PST Address:2001:db8:1:: has been assigned for 0 hrs 11 mins 53 secs
to a device with DUID: 17:34:e2:ff:09:92:54 and hardware address: hwtype=1 08:00:2b:02:3f:4e
(from Raw Socket) connected via relay at address: fe80::abcd for client on link address: 3001::1,
hop count: 1, identified by remote\-id: 01:02:03:04:0a:0b:0c:0d:0e:0f and subscriber\-id: 1a:2b:3c:4d:5e:6f
.EE
.UNINDENT
.UNINDENT
.sp
یا برای آزادسازی:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
2018\-01\-06 01:02:03 PST Address:2001:db8:1:: has been released
from a device with DUID: 17:34:e2:ff:09:92:54 and hardware address: hwtype=1 08:00:2b:02:3f:4e
(from Raw Socket) connected via relay at address: fe80::abcd for client on link address: 3001::1,
hop count: 1, identified by remote\-id: 01:02:03:04:0a:0b:0c:0d:0e:0f and subscriber\-id: 1a:2b:3c:4d:5e:6f
.EE
.UNINDENT
.UNINDENT
.sp
علاوه بر ثبت فعالیت‌های اجاره ناشی از ترافیک کلاینت DHCPv6،
کتابخانه قلاب ورودی‌هایی را نیز برای دستورهای کانال کنترلی مدیریت اجاره
زیر ثبت می‌کند: \fBlease6\-add\fP، \fBlease6\-update\fP و \fBlease6\-del\fP\&. هر ورودی یک
رشته منفرد بدون نشانگرهای انتهای خط درون‌متنی است، و معمولاً
شکل زیر را خواهد داشت:
.sp
\fBlease6\-add:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
*timestamp* Administrator added a lease of address: *address* to a device with DUID: *DUID*
.EE
.UNINDENT
.UNINDENT
.sp
بسته به آرگومان‌های دستور add، ممکن است شامل
آدرس سخت‌افزاری و مدت‌زمان نیز باشد.
.sp
مثال:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
2018\-01\-06 01:02:03 PST Administrator added a lease of address: 2001:db8::3 to a device with DUID:
1a:1b:1c:1d:1e:1f:20:21:22:23:24 for 1 days 0 hrs 0 mins 0 secs
.EE
.UNINDENT
.UNINDENT
.sp
\fBlease6\-update:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
*timestamp* Administrator updated information on the lease of address: *address* to a device with DUID: *DUID*
.EE
.UNINDENT
.UNINDENT
.sp
بسته به آرگومان‌های دستور update، ممکن است شامل
آدرس سخت‌افزاری و مدت‌زمان اجاره نیز باشد.
.sp
مثال:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
2018\-01\-06 01:02:03 PST Administrator updated information on the lease of address: 2001:db8::3 to a device with
DUID: 1a:1b:1c:1d:1e:1f:20:21:22:23:24, hardware address: 1a:1b:1c:1d:1e:1f
.EE
.UNINDENT
.UNINDENT
.sp
\fBlease6\-del:\fP عملیات حذف دارای دو شکل است، یکی بر اساس آدرس و دیگری بر اساس
شناسه و نوع شناسه:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
*timestamp* Administrator deleted the lease for address: *address*
.EE
.UNINDENT
.UNINDENT
.sp
یا
.INDENT 0.0
.INDENT 3.5
.sp
.EX
*timestamp* Administrator deleted a lease for a device identified by: *identifier\-type* of *identifier*
.EE
.UNINDENT
.UNINDENT
.sp
در حال حاضر تنها نوع \fBDUID\fP پشتیبانی می‌شود.
.sp
مثال‌ها:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
2018\-01\-06 01:02:03 PST Administrator deleted the lease for address: 2001:db8::3

2018\-01\-06 01:02:11 PST Administrator deleted a lease for a device identified by: duid of 1a:1b:1c:1d:1e:1f:20:21:22:23:24
.EE
.UNINDENT
.UNINDENT
.sp
اگر کتابخانه قلاب High Availability فعال باشد، شریک (partner) به صورت دوره‌ای دستورهای
اجاره را با قالبی مشابه ارسال می‌کند؛ تنها تفاوت این است که صادرکننده
دستور به جای \(dqAdministrator\(dq عبارت \(dqHA partner\(dq است.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
*timestamp* HA partner added ...
.EE
.UNINDENT
.UNINDENT
.sp
یا
.INDENT 0.0
.INDENT 3.5
.sp
.EX
*timestamp* HA partner updated ...
.EE
.UNINDENT
.UNINDENT
.sp
یا
.INDENT 0.0
.INDENT 3.5
.sp
.EX
*timestamp* HA partner deleted ...
.EE
.UNINDENT
.UNINDENT
.sp
گزینه‌های \fBrequest\-parser\-format\fP و \fBresponse\-parser\-format\fP می‌توانند به ترتیب
برای استخراج و ثبت داده‌ها از بسته ورودی و بسته پاسخ سرور
استفاده شوند. مقدار پیکربندی‌شده یک عبارت ارزیابی‌شده و تجزیه‌شده است که یک
رشته برمی‌گرداند. فهرستی از نشانه‌ها (tokens) در فرآیند دسته‌بندی سرور شرح داده شده است.
با احتیاط استفاده کنید زیرا ممکن است بر عملکرد سرور تأثیر بگذارد.
اگر هر یک از آن‌ها پیکربندی شود، قالب پیش‌فرض ثبت وقایع استفاده نمی‌شود.
اگر هر دوی آن‌ها پیکربندی شوند، پیام گزارش حاصل با الحاق
داده‌های ثبت‌شده استخراج‌شده از درخواست و داده‌های ثبت‌شده
استخراج‌شده از پاسخ ساخته می‌شود.
.sp
قالب‌بندی سفارشی ثبت گزارش در چند خط را با استفاده از رشته هگز 0x0a
(کد اسکی خط جدید) مجاز می‌سازد. در مورد فایل گزارش، در ابتدای هر خط
برچسب زمانی گزارش اضافه می‌شود. برای بک‌اند پایگاه داده، داده‌ها
(شامل نویسه خط جدید) در همان ورودی ذخیره می‌شوند.
.sp
مثال‌ها:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp6\(dq: {
    \(dqhooks\-libraries\(dq: [
      {
        \(dqlibrary\(dq: \(dqlibdhcp_legal_log.so\(dq,
        \(dqparameters\(dq: {
          \(dqname\(dq: \(dqdatabase\-name\(dq,
          \(dqpassword\(dq: \(dq1234\(dq,
          \(dqtype\(dq: \(dqmysql\(dq,
          \(dquser\(dq: \(dquser\-name\(dq,
          \(dqrequest\-parser\-format\(dq: \(dq\(aqlog entry\(aq + 0x0a + \(aqsame log entry\(aq\(dq,
          \(dqresponse\-parser\-format\(dq: \(dq\(aqalso same log entry\(aq + 0x0a + \(aqagain same log entry\(aq\(dq
        }
      }
    ]
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
برخی داده‌ها ممکن است فقط در درخواست یا فقط در پاسخ موجود باشند، و برخی
داده‌ها در بسته ورودی ممکن است با داده‌های بسته پاسخ تفاوت داشته باشند.
.sp
نکات:
.sp
در مورد IPv6، بسته‌ها می‌توانند حاوی چندین گزینه IA_NA (۳) یا IA_PD (۲۵)
باشند که هر کدام شامل چندین گزینه از جمله زیرگزینه‌های OPTION_IAADDR (۵) یا
OPTION_IAPREFIX (۲۵) هستند.
برای اینکه بتوان اجاره فعلی مرتبط با ورودی گزارش را چاپ کرد،
کتابخانه قلاب forensic log به طور داخلی گزینه IA_NA یا IA_PD متناظر
و زیرگزینه مربوطه که با اجاره فعلی مطابقت دارد را تفکیک می‌کند.
کتابخانه قلاب روی تمام آدرس‌های تازه تخصیص‌یافته و همه آدرس‌های
حذف‌شده پیمایش خواهد کرد و هر آدرس را برای ثبت به عنوان اجاره فعلی برای
ورودی گزارش مربوطه در دسترس قرار می‌دهد.
.sp
آن‌ها با استفاده از عبارت‌های تجزیه‌کننده زیر در دسترس هستند:
.sp
اجاره فعلی مرتبط با OPTION_IAADDR:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
addrtotext(substring(option[3].option[5].hex, 0, 16))
.EE
.UNINDENT
.UNINDENT
.sp
اجاره فعلی مرتبط با OPTION_IAPREFIX:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
addrtotext(substring(option[25].option[26].hex, 9, 16))
.EE
.UNINDENT
.UNINDENT
.sp
سایر پارامترهای گزینه‌ها در آفست‌های مربوط به خود در گزینه در دسترس هستند.
لطفاً برای جزئیات بیشتر RFC9915 را مطالعه کنید.
.sp
مثال‌ها:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqrequest\-parser\-format\(dq: \(dqifelse(pkt6.msgtype == 8 or pkt6.msgtype == 9, ifelse(option[3].option[5].exists, \(aqAddress: \(aq + addrtotext(substring(option[3].option[5].hex, 0, 16)) + \(aq has been released from a device with DUID: \(aq + hexstring(option[1].hex, \(aq:\(aq) + ifelse(relay6[0].peeraddr == \(aq\(aq, \(aq\(aq, \(aq connected via relay at address: \(aq + addrtotext(relay6[0].peeraddr) + \(aq for client on link address: \(aq + addrtotext(relay6[0].linkaddr) + ifelse(relay6[0].option[37].exists, \(aq, remote\-id: \(aq + hexstring(relay6[0].option[37].hex, \(aq:\(aq), \(aq\(aq) + ifelse(relay6[0].option[38].exists, \(aq, subscriber\-id: \(aq + hexstring(relay6[0].option[38].hex, \(aq:\(aq), \(aq\(aq) + ifelse(relay6[0].option[18].exists, \(aq, connected at location interface\-id: \(aq + hexstring(relay6[0].option[18].hex, \(aq:\(aq), \(aq\(aq)), \(aq\(aq) + ifelse(option[25].option[26].exists, \(aqPrefix: \(aq + addrtotext(substring(option[25].option[26].hex, 9, 16)) + \(aq/\(aq + uint8totext(substring(option[25].option[26].hex, 8, 1)) + \(aq has been released from a device with DUID: \(aq + hexstring(option[1].hex, \(aq:\(aq) + ifelse(relay6[0].peeraddr == \(aq\(aq, \(aq\(aq, \(aq connected via relay at address: \(aq + addrtotext(relay6[0].peeraddr) + \(aq for client on link address: \(aq + addrtotext(relay6[0].linkaddr) + ifelse(relay6[0].option[37].exists, \(aq, remote\-id: \(aq + hexstring(relay6[0].option[37].hex, \(aq:\(aq), \(aq\(aq) + ifelse(relay6[0].option[38].exists, \(aq, subscriber\-id: \(aq + hexstring(relay6[0].option[38].hex, \(aq:\(aq), \(aq\(aq) + ifelse(relay6[0].option[18].exists, \(aq, connected at location interface\-id: \(aq + hexstring(relay6[0].option[18].hex, \(aq:\(aq), \(aq\(aq)), \(aq\(aq), \(aq\(aq)\(dq,
    \(dqresponse\-parser\-format\(dq: \(dqifelse(pkt6.msgtype == 7, ifelse(option[3].option[5].exists and not (substring(option[3].option[5].hex, 20, 4) == 0), \(aqAddress: \(aq + addrtotext(substring(option[3].option[5].hex, 0, 16)) + \(aq has been assigned for \(aq + uint32totext(substring(option[3].option[5].hex, 20, 4)) + \(aq seconds to a device with DUID: \(aq + hexstring(option[1].hex, \(aq:\(aq) + ifelse(relay6[0].peeraddr == \(aq\(aq, \(aq\(aq, \(aq connected via relay at address: \(aq + addrtotext(relay6[0].peeraddr) + \(aq for client on link address: \(aq + addrtotext(relay6[0].linkaddr) + ifelse(relay6[0].option[37].exists, \(aq, remote\-id: \(aq + hexstring(relay6[0].option[37].hex, \(aq:\(aq), \(aq\(aq) + ifelse(relay6[0].option[38].exists, \(aq, subscriber\-id: \(aq + hexstring(relay6[0].option[38].hex, \(aq:\(aq), \(aq\(aq) + ifelse(relay6[0].option[18].exists, \(aq, connected at location interface\-id: \(aq + hexstring(relay6[0].option[18].hex, \(aq:\(aq), \(aq\(aq)), \(aq\(aq) + ifelse(option[25].option[26].exists and not (substring(option[25].option[26].hex, 4, 4) == 0), \(aqPrefix: \(aq + addrtotext(substring(option[25].option[26].hex, 9, 16)) + \(aq/\(aq + uint8totext(substring(option[25].option[26].hex, 8, 1)) + \(aq has been assigned for \(aq + uint32totext(substring(option[25].option[26].hex, 4, 4)) + \(aq seconds to a device with DUID: \(aq + hexstring(option[1].hex, \(aq:\(aq) + ifelse(relay6[0].peeraddr == \(aq\(aq, \(aq\(aq, \(aq connected via relay at address: \(aq + addrtotext(relay6[0].peeraddr) + \(aq for client on link address: \(aq + addrtotext(relay6[0].linkaddr) + ifelse(relay6[0].option[37].exists, \(aq, remote\-id: \(aq + hexstring(relay6[0].option[37].hex, \(aq:\(aq), \(aq\(aq) + ifelse(relay6[0].option[38].exists, \(aq, subscriber\-id: \(aq + hexstring(relay6[0].option[38].hex, \(aq:\(aq), \(aq\(aq) + ifelse(relay6[0].option[18].exists, \(aq, connected at location interface\-id: \(aq + hexstring(relay6[0].option[18].hex, \(aq:\(aq), \(aq\(aq)), \(aq\(aq), \(aq\(aq)\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
جزئیات:
.sp
این پیکربندی داده‌های زیر را هنگام request،‏ renew و rebind برای NA ثبت می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Address: 2001:db8:1:: has been assigned for 713 seconds to a device with DUID: 17:34:e2:ff:09:92:54 connected via relay at address: fe80::abcd for client on link address: 3001::1, remote\-id: 01:02:03:04:0a:0b:0c:0d:0e:0f, subscriber\-id: 1a:2b:3c:4d:5e:6f, connected at location interface\-id: 72:65:6c:61:79:31:3a:65:74:68:30
.EE
.UNINDENT
.UNINDENT
.sp
این پیکربندی داده‌های زیر را هنگام request،‏ renew و rebind برای PD ثبت می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Prefix: 2001:db8:1::/64 has been assigned for 713 seconds to a device with DUID: 17:34:e2:ff:09:92:54 connected via relay at address: fe80::abcd for client on link address: 3001::1, remote\-id: 01:02:03:04:0a:0b:0c:0d:0e:0f, subscriber\-id: 1a:2b:3c:4d:5e:6f, connected at location interface\-id: 72:65:6c:61:79:31:3a:65:74:68:30
.EE
.UNINDENT
.UNINDENT
.sp
این پیکربندی داده‌های زیر را هنگام release و decline برای NA ثبت می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Address: 2001:db8:1:: has been released from a device with DUID: 17:34:e2:ff:09:92:54 connected via relay at address: fe80::abcd for client on link address: 3001::1, remote\-id: 01:02:03:04:0a:0b:0c:0d:0e:0f, subscriber\-id: 1a:2b:3c:4d:5e:6f, connected at location interface\-id: 72:65:6c:61:79:31:3a:65:74:68:30
.EE
.UNINDENT
.UNINDENT
.sp
این پیکربندی داده‌های زیر را هنگام release و decline برای PD ثبت می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Prefix: 2001:db8:1::/64 has been released from a device with DUID: 17:34:e2:ff:09:92:54 connected via relay at address: fe80::abcd for client on link address: 3001::1, remote\-id: 01:02:03:04:0a:0b:0c:0d:0e:0f, subscriber\-id: 1a:2b:3c:4d:5e:6f, connected at location interface\-id: 72:65:6c:61:79:31:3a:65:74:68:30
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه مشابهی را می‌توان تنها با پیکربندی \fBrequest\-parser\-format\fP به دست آورد.
.sp
مثال‌ها:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqrequest\-parser\-format\(dq: \(dqifelse(pkt6.msgtype == 3 or pkt6.msgtype == 5 or pkt6.msgtype == 6, ifelse(option[3].option[5].exists, \(aqAddress: \(aq + addrtotext(substring(option[3].option[5].hex, 0, 16)) + \(aq has been assigned for \(aq + uint32totext(substring(option[3].option[5].hex, 20, 4)) + \(aq seconds to a device with DUID: \(aq + hexstring(option[1].hex, \(aq:\(aq) + ifelse(relay6[0].peeraddr == \(aq\(aq, \(aq\(aq, \(aq connected via relay at address: \(aq + addrtotext(relay6[0].peeraddr) + \(aq for client on link address: \(aq + addrtotext(relay6[0].linkaddr) + ifelse(relay6[0].option[37].exists, \(aq, remote\-id: \(aq + hexstring(relay6[0].option[37].hex, \(aq:\(aq), \(aq\(aq) + ifelse(relay6[0].option[38].exists, \(aq, subscriber\-id: \(aq + hexstring(relay6[0].option[38].hex, \(aq:\(aq), \(aq\(aq) + ifelse(relay6[0].option[18].exists, \(aq, connected at location interface\-id: \(aq + hexstring(relay6[0].option[18].hex, \(aq:\(aq), \(aq\(aq)), \(aq\(aq) + ifelse(option[25].option[26].exists, \(aqPrefix: \(aq + addrtotext(substring(option[25].option[26].hex, 9, 16)) + \(aq/\(aq + uint8totext(substring(option[25].option[26].hex, 8, 1)) + \(aq has been assigned for \(aq + uint32totext(substring(option[25].option[26].hex, 4, 4)) + \(aq seconds to a device with DUID: \(aq + hexstring(option[1].hex, \(aq:\(aq) + ifelse(relay6[0].peeraddr == \(aq\(aq, \(aq\(aq, \(aq connected via relay at address: \(aq + addrtotext(relay6[0].peeraddr) + \(aq for client on link address: \(aq + addrtotext(relay6[0].linkaddr) + ifelse(relay6[0].option[37].exists, \(aq, remote\-id: \(aq + hexstring(relay6[0].option[37].hex, \(aq:\(aq), \(aq\(aq) + ifelse(relay6[0].option[38].exists, \(aq, subscriber\-id: \(aq + hexstring(relay6[0].option[38].hex, \(aq:\(aq), \(aq\(aq) + ifelse(relay6[0].option[18].exists, \(aq, connected at location interface\-id: \(aq + hexstring(relay6[0].option[18].hex, \(aq:\(aq), \(aq\(aq)), \(aq\(aq), ifelse(pkt6.msgtype == 8 or pkt6.msgtype == 9, ifelse(option[3].option[5].exists, \(aqAddress: \(aq + addrtotext(substring(option[3].option[5].hex, 0, 16)) + \(aq has been released from a device with DUID: \(aq + hexstring(option[1].hex, \(aq:\(aq) + ifelse(relay6[0].peeraddr == \(aq\(aq, \(aq\(aq, \(aq connected via relay at address: \(aq + addrtotext(relay6[0].peeraddr) + \(aq for client on link address: \(aq + addrtotext(relay6[0].linkaddr) + ifelse(relay6[0].option[37].exists, \(aq, remote\-id: \(aq + hexstring(relay6[0].option[37].hex, \(aq:\(aq), \(aq\(aq) + ifelse(relay6[0].option[38].exists, \(aq, subscriber\-id: \(aq + hexstring(relay6[0].option[38].hex, \(aq:\(aq), \(aq\(aq) + ifelse(relay6[0].option[18].exists, \(aq, connected at location interface\-id: \(aq + hexstring(relay6[0].option[18].hex, \(aq:\(aq), \(aq\(aq)), \(aq\(aq) + ifelse(option[25].option[26].exists, \(aqPrefix: \(aq + addrtotext(substring(option[25].option[26].hex, 9, 16)) + \(aq/\(aq + uint8totext(substring(option[25].option[26].hex, 8, 1)) + \(aq has been released from a device with DUID: \(aq + hexstring(option[1].hex, \(aq:\(aq) + ifelse(relay6[0].peeraddr == \(aq\(aq, \(aq\(aq, \(aq connected via relay at address: \(aq + addrtotext(relay6[0].peeraddr) + \(aq for client on link address: \(aq + addrtotext(relay6[0].linkaddr) + ifelse(relay6[0].option[37].exists, \(aq, remote\-id: \(aq + hexstring(relay6[0].option[37].hex, \(aq:\(aq), \(aq\(aq) + ifelse(relay6[0].option[38].exists, \(aq, subscriber\-id: \(aq + hexstring(relay6[0].option[38].hex, \(aq:\(aq), \(aq\(aq) + ifelse(relay6[0].option[18].exists, \(aq, connected at location interface\-id: \(aq + hexstring(relay6[0].option[18].hex, \(aq:\(aq), \(aq\(aq)), \(aq\(aq), \(aq\(aq))\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
جزئیات:.SS پس‌بند پایگاه داده (Database Backend)
.sp
هنگامی که Kea با پشتیبانی از پس‌بند پایگاه داده پیکربندی شده باشد، مدخل‌های لاگ می‌توانند درون یک پایگاه داده درج شوند. Kea از جدول با نام \fBlogs\fP استفاده می‌کند که شامل یک برچسب زمانی تولید شده توسط نرم‌افزار پایگاه داده و یک لاگ متنی با همان قالب فایل‌ها بدون برچسب زمانی است.
.sp
لطفاً برای اطلاعات در مورد استفاده از پایگاه داده MySQL به MySQL \%<#\:mysql-database>، یا برای اطلاعات پایگاه داده PostgreSQL به PostgreSQL \%<#\:pgsql-database> مراجعه کنید. جدول \fBlogs\fP بخشی از طرح‌واره‌های پایگاه داده Kea است.
.sp
پارامترهای پیکربندی بر اساس پارامترهای استاندارد پایگاه داده اجاره (lease)، همان‌طور که در Lease Database Configuration \%<#\:database-configuration4>\& تعریف شده است، گسترش می‌یابند. پارامتر \fBtype\fP باید \fBmysql\fP، \fBpostgresql\fP، \fBlogfile\fP یا \fBsyslog\fP باشد؛ هنگامی که وجود نداشته باشد یا روی \fBlogfile\fP تنظیم شده باشد، از فایل‌ها استفاده می‌شود.
.sp
هیچ ابزار خاصی برای کار با پایگاه داده ارائه نشده است، اما می‌توان از ابزارهای استاندارد استفاده کرد؛ به عنوان مثال، برای استخراج جدول logs از یک پایگاه داده MySQL:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ mysql \-\-user keatest \-\-password 1234 \-e \(dqselect * from logs;\(dq
+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-+
| timestamp           | address      | log                                                                                                                                                             | id |
+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-+
| 2022\-03\-30 17:38:41 | 192.168.50.1 | Address: 192.168.50.1 has been assigned for 0 hrs 10 mins 0 secs to a device with hardware address: hwtype=1 ff:01:02:03:ff:04, client\-id: 00:01:02:03:04:05:06 | 31 |
| 2022\-03\-30 17:38:43 | 192.168.50.1 | Address: 192.168.50.1 has been assigned for 0 hrs 10 mins 0 secs to a device with hardware address: hwtype=1 ff:01:02:03:ff:04, client\-id: 00:01:02:03:04:05:06 | 32 |
| 2022\-03\-30 17:38:45 | 192.168.50.1 | Address: 192.168.50.1 has been assigned for 0 hrs 10 mins 0 secs to a device with hardware address: hwtype=1 ff:01:02:03:ff:04, client\-id: 00:01:02:03:04:05:06 | 33 |
+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-+
.EE
.UNINDENT
.UNINDENT
.sp
همانند سایر ویژگی‌های مبتنی بر پایگاه داده، ثبت لاگ قانونی (forensic logging) از بازیابی اتصال پایگاه داده پشتیبانی می‌کند که می‌تواند با تنظیم پارامتر \fBon\-fail\fP فعال شود.
در صورت عدم تعیین، مقدار پارامتر \fBon\-fail\fP در ثبت لاگ قانونی به‌طور پیش‌فرض برابر با
\fBserve\-retry\-continue\fP\& است. این بر خلاف کتابخانه‌های
\fBlibdhcp_lease_cmds.so\fP، \fBlibdhcp_host_cmds.so\fP و
\fBlibdhcp_cb_cmds.so\fP است که در آن‌ها
\fBon\-fail\fP به‌طور پیش‌فرض برابر با \fBstop\-retry\-exit\fP\& می‌باشد. در این حالت، کارساز به خدمت‌رسانی به کلاینت‌ها ادامه می‌دهد و حتی در صورت شکست سازوکار بازیابی نیز خاموش نمی‌شود.
اگر \fBon\-fail\fP بر روی \fBserve\-retry\-exit\fP تنظیم شود، در صورتی که اتصال به پس‌بند پایگاه داده طبق پارامترهای
\fBmax\-reconnect\-tries\fP و \fBreconnect\-wait\-time\fP بازیابی نشود، کارساز خاموش خواهد شد، اما تا زمانی که این سازوکار فعال است به سرویس‌دهی به کلاینت‌ها ادامه می‌دهد.
.sp
در هنگام راه‌اندازی کارساز، ناتوانی در اتصال به هر یک از پس‌بندهای پیکربندی‌شده تنها در صورتی مهلک تلقی می‌شود که \fBretry\-on\-startup\fP بر روی \fBfalse\fP
(پیش‌فرض) تنظیم شده باشد. یک خطای مهلک ثبت شده و کارساز خارج می‌شود، بر این فرض که پیکربندی باید در زمان راه‌اندازی معتبر باشد. خروج به سیستم‌عامل به اسکریپت‌های ناظر (nanny scripts) اجازه می‌دهد تا مشکل را تشخیص دهند.
اگر \fBretry\-on\-startup\fP بر روی \fBtrue\fP تنظیم شود، کارساز تلاش‌ها برای اتصال مجدد را حتی در زمان راه‌اندازی کارساز یا در هنگام رخدادهای پیکربندی مجدد آغاز می‌کند و اقدام مشخص‌شده در پارامتر \fBon\-fail\fP را اعمال می‌نماید.
.SS پس‌بند Syslog (Syslog Backend)
.sp
مدخل‌های لاگ را می‌توان با تنظیم \fBtype\fP بر روی \fBsyslog\fP\& در syslog درج کرد.
هنگامی که نوع syslog پیکربندی شده باشد، پارامتر \fBpattern\fP جزئیاتی را که برای ثبت لاگ استفاده می‌شوند مشخص می‌کند. برای جزئیات بیشتر به Logging \%<#\:logging>\& مراجعه کنید. در صورت عدم پیکربندی، پیش‌فرض آن به شرح زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dq%\-5p [%c.%t] %m\en\(dq
.EE
.UNINDENT
.UNINDENT
.sp
پارامتر \fBfacility\fP بخش (facility) مورد نظر در syslog را مشخص می‌کند و مقدار پیش‌فرض آن \fBlocal0\fP\& است.
.SS \fBlibdhcp_limits.so\fP: محدودیت‌ها برای مدیریت تخصیص اجاره و پردازش بسته (Limits to Manage Lease Allocation and Packet Processing)
.sp
این کتابخانه قلاب (hook library) دو نوع محدودیت را فعال می‌کند:
.INDENT 0.0
.IP 1. 3
محدودسازی اجاره: حداکثر اجازه تخصیص \fBn\fP اجاره را در هر لحظه می‌دهد.
.IP 2. 3
محدودسازی نرخ: اجازه می‌دهد در هر \fBtime_unit\fP حداکثر به \fBn\fP بسته پاسخ داده شود.
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
\fBlibdhcp_limits.so\fP بخشی از کد متن‌باز است و در دسترس تمام کاربران Kea قرار دارد.
این کتابخانه پیش‌تر تنها برای مشتریان ISC دارای قرارداد پشتیبانی تجاری در دسترس بود.
.UNINDENT
.UNINDENT
.SS پیکربندی (Configuration)
.sp
مثال‌های زیر مربوط به \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> هستند، اما به همان ترتیب برای
\fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4>\& نیز صدق می‌کنند. نویسه‌های عام \fB\(dq<limit\-type>\(dq\fP و \fB\(dq<limit\-value>\(dq\fP باید
با کلیدها و مقادیر مربوطه برای هر نوع محدودیت شرح داده شده در بخش‌های بعد جایگزین شوند.
.sp
این کتابخانه می‌تواند توسط هر دو کارساز \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> و \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> با افزودن مسیر آن در
عنصر \fB\(dqhooks\-libraries\(dq\fP از پیکربندی کارساز بارگذاری شود.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp6\(dq: {
    \(dqhooks\-libraries\(dq: [
      {
        \(dqlibrary\(dq: \(dqlibdhcp_limits.so\(dq
      }
    ]
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
این اقدام به تنهایی هیچ چیزی را محدود نمی‌کند. محدودیت‌های مورد نظر به بافت کاربر (user context) در بخش پیکربندی عنصری که کلاینت‌های مشمول محدودیت را مشخص می‌کند اضافه می‌شوند: یک کلاس کلاینت یا یک زیرشبکه. پس از پیکربندی مجدد، در صورتی که Kea محدودیت‌های پیکربندی‌شده را تشخیص دهد، یک خط برای هر محدودیت پیکربندی‌شده لاگ می‌اندازد. پیام لاگ حاوی شناسه \fBLIMITS_CONFIGURED\fP خواهد بود.
.sp
نحوه تعریف محدودیت اجاره برای یک کلاس کلاینت به این صورت است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp6\(dq: {
    \(dqclient\-classes\(dq: [
      {
        \(dqname\(dq: \(dqcable\-modem\-1\(dq,
        \(dqtest\(dq: \(dqoption[123].hex == 0x000C4B1E\(dq,
        \(dquser\-context\(dq: {
          \(dqlimits\(dq: {
            \(dq<limit>\(dq: \(dq<limit\-value>\(dq
          }
        }
      }
    ]
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحوه تعریف محدودیت اجاره برای یک زیرشبکه سراسری (global subnet) به این صورت است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp6\(dq: {
    \(dqsubnet6\(dq: [
      {
        \(dqid\(dq: 1,
        \(dqsubnet\(dq: \(dq2001:db8::/64\(dq,
        \(dquser\-context\(dq: {
          \(dqlimits\(dq: {
            \(dq<limit>\(dq: \(dq<limit\-value>\(dq
          }
        }
      }
    ]
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحوه تعریف محدودیت اجاره برای یک زیرشبکه درون یک شبکه اشتراکی (shared network) به این صورت است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp6\(dq: {
    \(dqshared\-networks\(dq: [
      {
        \(dqsubnet6\(dq: [
          {
            \(dqid\(dq: 1,
            \(dqsubnet\(dq: \(dq2001:db8::/64\(dq,
            \(dquser\-context\(dq: {
              \(dqlimits\(dq: {
                \(dq<limit>\(dq: \(dq<limit\-value>\(dq
              }
            }
          }
        ]
      }
    ]
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
کتابخانه قلاب Limits از نام کلاس برای شناسایی کلاس کلاینت و از شناسه زیرشبکه (subnet ID) برای شناسایی یک زیرشبکه استفاده می‌کند. تغییر عبارت آزمون (test expression) در یک کلاس کلاینت یا محدوده شبکه یک زیرشبکه در حالی که نام یا شناسه بدون تغییر باقی بماند، شمارنده اجاره را برای کلاس کلاینت یا زیرشبکه مربوطه بازنشانی نمی‌کند. برای بازنشانی شمارنده اجاره، نام کلاس کلاینت یا شناسه زیرشبکه را تغییر دهید.
.UNINDENT
.UNINDENT.SS محدودسازی اجاره (Lease Limiting)
.sp
این امکان وجود دارد که تعداد اجاره‌هایی که یک گروه از کلاینت‌ها می‌توانند از یک سرور Kea DHCP یا از مجموعه‌ای از سرورهای همکار Kea DHCP دریافت کنند، محدود شود.
.sp
مقدار محدودیت اجاره می‌تواند به صورت یک عدد صحیح ۳۲ بیتی بدون علامت، یعنی بین \fB0\fP و
\fB4,294,967,295\fP مشخص شود. هر نوع اجاره را می‌توان به صورت جداگانه محدود کرد. اجاره‌های IPv4 و اجاره‌های IA_NA در IPv6
از طریق مدخل پیکربندی \fB\(dqaddress\-limit\(dq\fP محدود می‌شوند. اجاره‌های IA_PD در IPv6 از طریق
مدخل پیکربندی \fB\(dqprefix\-limit\(dq\fP محدود می‌شوند. در اینجا چند مثال آورده شده است:
.INDENT 0.0
.IP \(bu 2
\fB\(dqaddress\-limit\(dq: 4\fP
.IP \(bu 2
\fB\(dqprefix\-limit\(dq: 2\fP
.UNINDENT
.sp
برای محدودسازی اجاره، کلاس‌های کلاینت و تعداد اجاره‌های مرتبط با آن‌ها \- که در برابر
محدودیت‌های پیکربندی‌شده سنجیده می‌شوند \- برای هر اجاره در فراخوان‌های قلاب (hook callouts) زیر به‌روزرسانی می‌شوند:
.INDENT 0.0
.IP \(bu 2
\fBlease4_select\fP
.IP \(bu 2
\fBlease4_renew\fP
.IP \(bu 2
\fBlease6_select\fP
.IP \(bu 2
\fBlease6_renew\fP
.IP \(bu 2
\fBlease6_rebind\fP
.UNINDENT
.sp
در نتیجه، کلاس‌هایی که مقدار \fB\(dqonly\-in\-additional\-list\(dq\fP برای آن‌ها \(dqtrue\(dq است، نمی‌توانند تحت محدودیت اجاره قرار گیرند.
لطفاً برای اطلاعات بیشتر درباره اینکه کدام کلاس‌های کلاینت می‌توانند برای محدود کردن تعداد اجاره‌ها استفاده شوند، به مراحل دسته‌بندی \%<#\:classify-classification-steps> مراجعه کنید.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
تحت بار کاری بالا، ممکن است یک سرور Kea DHCP اجاره‌های بیشتری نسبت به آنچه محدودیت دقیقاً اجازه می‌دهد تخصیص دهد. این موضوع فقط در زمان جهش‌های ترافیکی شدید رخ می‌دهد که از کلاینت‌های متعلق به همان کلاس یا همان زیرشبکه (بسته به آنچه محدود شده است) ناشی می‌شوند. کاربران ممکن است علاقه‌مند به دنبال کردن روند توسعه محدودیت‌های اجاره اتمیک \%<https://\:gitlab\:.isc\:.org/\:isc-projects/\:kea/\:-/\:issues/\:2449> در گیت‌لب ISC باشند.
.UNINDENT
.UNINDENT
.SS محدودسازی نرخ (Rate Limiting)
.sp
امکان محدود کردن بسامد یا نرخی که بسته‌های ورودی بر اساس آن پاسخ دریافت می‌کنند وجود دارد.
.sp
مقدار محدودیت نرخ می‌تواند با قالب \fB\(dq<p> packets per <time\-unit>\(dq\fP مشخص شود. \fB<p>\fP
هر عددی است که بتوان آن را به صورت یک عدد صحیح ۳۲ بیتی بدون علامت نمایش داد، یعنی بین \fB0\fP و
\fB4,294,967,295\fP\&. \fB<time\-unit>\fP می‌تواند هر یک از مقادیر \fBsecond\fP، \fBminute\fP، \fBhour\fP، \fBday\fP،
\fBweek\fP، \fBmonth\fP، یا \fByear\fP باشد. برای سادگی، یک \fBmonth\fP معادل ۳۰ روز در نظر گرفته می‌شود؛
به طور مشابه، یک \fByear\fP برای اهداف محدودسازی ۳۶۵ روز در نظر گرفته می‌شود. این ساختار نحوی
طیف گسترده‌ای از نرخ‌ها را از یک اجاره در سال تا چهار میلیارد اجاره در ثانیه
پوشش می‌دهد. این مقدار به مدخل پیکربندی \fB\(dqrate\-limit\(dq\fP اختصاص داده می‌شود.
در اینجا چند مثال آورده شده است:
.INDENT 0.0
.IP \(bu 2
\fB\(dqrate\-limit\(dq: 1 packet per second\fP
.IP \(bu 2
\fB\(dqrate\-limit\(dq: 4 packets per minute\fP
.IP \(bu 2
\fB\(dqrate\-limit\(dq: 16 packets per hour\fP
.UNINDENT
.sp
مقدار پیکربندی‌شده \fB0\fP بسته، روشی مناسب برای غیرفعال‌سازی کامل پردازش بسته برای برخی از کلاینت‌های
خاص است. به این ترتیب، این مقدار بیانگر معنای تحت‌اللفظی خود است و برخلاف آنچه ممکن است تصور شود،
یک مقدار ویژه برای غیرفعال کردن کلی محدودسازی نیست. غیرفعال کردن کامل محدودسازی با حذف
مدخل پیکربندی برگ (leaf) \fB\(dqrate\-limit\(dq\fP، نگاشت یا زمینه کاربری (user context) \fB\(dqlimits\(dq\fP
پیرامون آن، یا پیکربندی کتابخانه قلاب حاصل می‌شود. همین امر برای مقدار \fB0\fP در محدودسازی اجاره
نیز صدق می‌کند. با این حال، دستیابی به آن مورد کاربرد با محدودسازی نرخ بهتر انجام می‌شود؛ زیرا بار
محاسباتی کمتری به Kea وارد می‌کند، چرا که تصمیم برای نادیده‌گرفتن (drop) درخواست یا ارسال NAK در مراحل اولیه گرفته می‌شود.
.sp
از نظر محدودسازی نرخ، کلاس‌های کلاینت به ترتیب در فراخوان‌های \fBpkt4_receive\fP و
\fBpkt6_receive\fP ارزیابی می‌شوند تا محدودیت‌های نرخ در زودترین زمان ممکن در
چرخه پردازش بسته بررسی شوند. بدین ترتیب، تنها کلاس‌هایی که صرفاً از طریق یک عبارت آزمون مستقل به بسته اختصاص یافته‌اند،
قابل استفاده هستند. کلاس‌هایی که به رزروهای میزبان (host reservations) یا کلاس‌های ویژه
\fBBOOTP\fP یا \fBKNOWN\fP وابسته‌اند، و همچنین کلاس‌هایی که با \fB\(dqonly\-in\-additional\-list\(dq: true\fP مشخص شده‌اند،
نمی‌توانند مشمول محدودسازی نرخ شوند. برای جزئیات بیشتر درباره اینکه کدام کلاس‌های کلاینت می‌توانند برای محدود کردن نرخ بسته به کار روند،
به مراحل دسته‌بندی \%<#\:classify-classification-steps> مراجعه کنید.
.sp
محدودیت‌های نرخ مبتنی بر زیرشبکه فقط بر روی زیرشبکه اولیه‌ای که برای یک بسته مشخص انتخاب شده اعمال می‌شوند.
اگر زیرشبکه انتخاب‌شده متعاقباً تغییر کند (همان‌طور که ممکن است برای زیرشبکه‌های یک
شبکه اشتراکی یا هنگام فعال بودن انتخاب مجدد در کتابخانه‌هایی مانند قلاب RADIUS رخ دهد)، محدودیت‌های
نرخ در زیرشبکه جدیدِ انتخاب‌شده نادیده گرفته می‌شوند. به بیان دیگر، بسته‌ها فقط با
محدودیت نرخ زیرشبکه اصلی کنترل می‌شوند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
شاید منطقی به نظر برسد که تعیین محدودیت نرخ \fBn\fP بسته در هر واحد زمانی منجر
به \fBn\fP تبادل DORA یا \fBn\fP تبادل SARR می‌شود. با این حال، به طور پیش‌فرض، تمام بسته‌های ورودی شمرده می‌شوند \- یعنی
یک تبادل پیام کامل معادل دو بسته به حساب می‌آید. برای رسیدن به این نتیجه که یک
تبادل پیام فقط یک بار شمرده شود، از محدودسازی نرخ کلاس کلاینت همراه با یک عبارت آزمون استفاده کنید که
\fBpkt4.msgtype\fP را به پیام‌های DHCPDISCOVER یا \fBpkt6.msgtype\fP را به پیام‌های SOLICIT مقید کند.
.UNINDENT
.UNINDENT
.SS \fBlibdhcp_mysql.so\fP: پس‌زمینه پایگاه داده برای MySQL (Database Backend for MySQL)
.INDENT 0.0
.TP
.B این کتابخانه قلاب، ذخیره‌سازی در پایگاه داده MySQL را برای موارد زیر پیاده‌سازی می‌کند:
.INDENT 7.0
.IP \(bu 2
پس‌زمینه اجاره (Lease Backend)
.IP \(bu 2
پس‌زمینه میزبان (Host Backend)
.IP \(bu 2
پس‌زمینه پیکربندی (Configuration Backend)
.UNINDENT
.UNINDENT
.SS پس‌زمینه پیکربندی MySQL (MySQL Configuration Backend)
.sp
این کتابخانه قلاب همراه با \fBlibdhcp_cb_cmds.so\fP کار می‌کند تا
API لازم برای ایجاد، خواندن، به‌روزرسانی و حذف (CRUD) پیکربندی
در یک پایگاه داده MySQL را پیاده‌سازی کند. لطفاً برای جزئیات بیشتر به libdhcp_cb_cmds.so: Configuration Backend Commands مراجعه کنید.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
\fBlibdhcp_mysql.so\fP بخشی از کد منبع‌باز است و برای
همه کاربران Kea در دسترس است. با این حال، این کتابخانه قلاب فقط با
\fBlibdhcp_cb_cmds.so\fP کار می‌کند که مدیریت آسان پیکربندی
را با استفاده از دستورات API فراهم می‌سازد. \fBlibdhcp_cb_cmds.so\fP
تنها در دسترس مشتریان ISC با قرارداد پشتیبانی پولی است؛ برای اطلاعات
بیشتر درباره گزینه‌های اشتراک، لطفاً فرم موجود در
\%<https://\:www\:.isc\:.org/\:contact>\& را تکمیل کنید.
.UNINDENT
.UNINDENT.SS \fBlibdhcp_perfmon.so\fP: پایش کارایی (Performance Monitoring)
.sp
کتابخانه قلاب پایش کارایی (perfmon) به کارسازهای Kea DHCPv4 و DHCPv6 قابلیت رهگیری و گزارش داده‌های مرتبط با کارایی را می‌دهد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
\fBlibdhcp_perfmon.so\fP بخشی از کد متن‌باز است و برای هر کاربر Kea در دسترس می‌باشد.
.UNINDENT
.UNINDENT
.SS نمای کلی (Overview)
.sp
کتابخانه perfmon که در Kea 2.5.6 افزوده شده است، می‌تواند توسط دیمن‌های \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> یا
\fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> با افزودن آن به عنصر \fBhooks\-libraries\fP در
پیکربندی کارساز بارگذاری شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqhooks\-libraries\(dq: [
        {
            \(dqlibrary\(dq: \(dqlibdhcp_perfmon.so\(dq,
            \(dqparameters\(dq: {
                ...
            }
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
این کتابخانه چرخه حیات بسته‌های پرس‌وجوی کلاینت را هنگام پردازش توسط Kea،
از زمان دریافت پرس‌وجو توسط هسته تا آماده شدن پاسخ
برای ارسال رهگیری می‌کند. این رهگیری توسط یک پشته رویداد بسته هدایت می‌شود که
شامل فهرستی از جفت‌های رویداد/برچسب زمانی برای نقاط عطف مهم در
طول پردازش پرس‌وجوی کلاینت است. فهرست رویدادهای ممکن در
زیر آورده شده است:
.INDENT 0.0
.IP 1. 3
socket_received \- هسته پرس‌وجوی کلاینت را در بافر سوکت قرار داد
.IP 2. 3
buffer_read \- کارساز پرس‌وجوی کلاینت را از بافر سوکت خواند
.IP 3. 3
mt_queued \- کارساز پرس‌وجوی کلاینت را در صف کار استخر ریسه خود قرار داد (فقط در حالت چندریسمانی)
.IP 4. 3
process_started \- کارساز پردازش پرس‌وجو را آغاز کرده است
.IP 5. 3
process_completed \- کارساز پاسخ را ساخته و آماده ارسال آن است
.UNINDENT
.sp
این فهرست احتمالاً در طول زمان گسترش خواهد یافت؛ همچنین برای توسعه‌دهندگان قلاب‌ها این امکان
فراهم خواهد بود که رویدادهای اختصاصی خود را اضافه کنند. این موضوع در نسخه‌های بعدی با جزئیات تشریح خواهد شد.
.SS ثبت غیرفعال رویدادها (Passive Event Logging)
.sp
هنگامی که کتابخانه قلاب perfmon بارگذاری می‌شود، محتویات پشته رویداد بسته را
برای هر پرس‌وجوی کلاینت که یک بسته پاسخ تولید می‌کند در گزارش ثبت می‌کند. مدخل گزارش
شامل شناسه‌های پرس‌وجوی کلاینت است و به دنبال آن فهرستی از جفت‌های رویداد/برچسب زمانی
به همان ترتیبی که رخ داده‌اند می‌آید.
.sp
برای \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4>، گزارش با برچسب \fBPERFMON_DHCP4_PKT_EVENTS\fP مشخص شده
و در سطح اشکال‌زدایی (debug) ۵۰ یا بالاتر لاگر منتشر می‌شود. برای یک DHCPDISCOVER، این گزارش
پس از آماده شدن DHCPOFFER برای ارسال منتشر می‌شود و مشابه تصویر زیر خواهد بود (به
مدخل دوم نگاه کنید):
.INDENT 0.0
.INDENT 3.5
.sp
.EX
2024\-03\-20 10:52:20.069 INFO  [kea\-dhcp4.leases/50033.140261252249344] DHCP4_LEASE_OFFER [hwtype=1 08:00:27:25:d3:f4], cid=[no info], tid=0xc288f9: lease 178.16.2.0 will be offered
2024\-03\-20 10:52:20.070 DEBUG [kea\-dhcp4.perfmon\-hooks/50033.140261252249344] PERFMON_DHCP4_PKT_EVENTS query: [hwtype=1 08:00:27:25:d3:f4], cid=[no info], tid=0xc288f9 events=[2024\-Mar\-20 14:52:20.067563 : socket_received, 2024\-Mar\-20 14:52:20.067810 : buffer_read, 2024\-Mar\-20 14:52:20.067897 : mt_queued, 2024\-Mar\-20 14:52:20.067952 : process_started, 2024\-Mar\-20 14:52:20.069614 : process_completed]
.EE
.UNINDENT
.UNINDENT
.sp
برای \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6>، گزارش با برچسب \fBPERFMON_DHCP6_PKT_EVENTS\fP مشخص شده
و در سطح اشکال‌زدایی (debug) ۵۰ یا بالاتر لاگر منتشر می‌شود. برای یک DHCPV6_SOLICIT، این گزارش
پس از آماده شدن DHCPV6_ADVERTISE برای ارسال منتشر می‌شود و مشابه تصویر زیر خواهد بود (به
مدخل دوم نگاه کنید):
.INDENT 0.0
.INDENT 3.5
.sp
.EX
2024\-03\-20 10:22:14.030 INFO  [kea\-dhcp6.leases/47195.139913679886272] DHCP6_LEASE_ADVERT duid=[00:03:00:01:08:00:27:25:d3:f4], [no hwaddr info], tid=0xb54806: lease for address 3002:: and iaid=11189196 will be advertised
2024\-03\-20 10:22:14.031 DEBUG [kea\-dhcp6.perfmon\-hooks/47195.139913679886272] PERFMON_DHCP6_PKT_EVENTS query: duid=[00:03:00:01:08:00:27:25:d3:f4], [no hwaddr info], tid=0xb54806 events=[2024\-Mar\-20 14:22:14.028729 : socket_received, 2024\-Mar\-20 14:22:14.028924 : buffer_read, 2024\-Mar\-20 14:22:14.029005 : process_started, 2024\-Mar\-20 14:22:14.030566 : process_completed]
.EE
.UNINDENT
.UNINDENT
.SS پایش مدت‌زمان (Duration Monitoring)
.sp
هنگامی که پایش فعال باشد، داده‌های رویداد پشته در یک بازه زمانی مشخص تجمیع می‌شوند. این
تجمیع‌ها با عنوان \(dqمدت‌زمان‌های پایش‌شده\(dq یا برای راحتی به سادگی \(dqمدت‌زمان‌ها\(dq شناخته می‌شوند. مدت‌زمان‌ها
به طور یکتا با یک \(dqکلید مدت‌زمان\(dq مشخص می‌شوند که شامل مقادیر زیر است:
.INDENT 0.0
.IP \(bu 2
query message type \- نوع پیام پرس‌وجوی کلاینت (مانند DHCPDISCOVER، DHCPV6_REQUEST)
.IP \(bu 2
response message type \- نوع پیام پاسخ کارساز (مانند DHCPOFFER، DHCPV6_REPLY)
.IP \(bu 2
start event label \- رویدادی که آغاز فعالیت را مشخص می‌کند (مانند socket_received، process_started)
.IP \(bu 2
stop event label \- رویدادی که پایان فعالیت را مشخص می‌کند (مانند buffer_read، process_completed)
.IP \(bu 2
subnet id \- زیرشبکه انتخاب‌شده در حین پردازش پیام (یا 0 برای مدت‌زمان‌های سراسری)
.UNINDENT
.sp
به محض اینکه کارساز ساخت پاسخ برای یک پرس‌وجو را تمام کند، پشته رویداد آن پرس‌وجو
به مجموعه‌ای از به‌روزرسانی‌ها برای مدت‌زمان‌های پایش‌شده پردازش می‌شود. اگر پس از به‌روزرسانی مشخص شود که
بازه نمونه‌برداری یک مدت‌زمان کامل شده است، برای گزارش‌دهی ارسال می‌شود
و یک بازه نمونه‌برداری جدید آغاز می‌گردد. طول بازه توسط پارامتر پیکربندی
\fBinterval\-width\-secs\fP تعیین می‌شود.
.sp
پشته رویداد برای چرخه DHCPDISCOVER/DHCPOFFER در حالت چندریسمانی که در بالا نمایش داده شد
شامل رویدادهای زیر است:
.INDENT 0.0
.INDENT 3.5
.TS
box center;
l|l.
T{
برچسب زمانی رویداد
T}	T{
برچسب رویداد
T}
_
T{
2024\-Mar\-20 14:52:20.067563
T}	T{
socket_received
T}
_
T{
2024\-Mar\-20 14:52:20.067810
T}	T{
buffer_read
T}
_
T{
2024\-Mar\-20 14:52:20.067897
T}	T{
mt_queued
T}
_
T{
2024\-Mar\-20 14:52:20.067952
T}	T{
process_started
T}
_
T{
2024\-Mar\-20 14:52:20.069614
T}	T{
process_completed
T}
.TE
.UNINDENT
.UNINDENT
.sp
با فرض اینکه شناسه زیرشبکه (subnet ID) انتخاب‌شده 100 بوده باشد، به‌روزرسانی‌های مدت‌زمان ایجادشده توسط perfmon
بر اساس این رویدادها در زیر نمایش داده شده است:
.INDENT 0.0
.INDENT 3.5
.TS
box center;
l|l.
T{
کلیدهای مدت‌زمان برای شناسه زیرشبکه 100
T}	T{
به‌روزرسانی به
میکروثانیه
T}
_
T{
DHCPDISCOVER.DHCPOFFER.socket_received\-buffer_read.100
T}	T{
247
T}
_
T{
DHCPDISCOVER.DHCPOFFER.buffer_read\-mt_queue.100
T}	T{
87
T}
_
T{
DHCPDISCOVER.DHCPOFFER.mt_queued\-process_started.100
T}	T{
55
T}
_
T{
DHCPDISCOVER.DHCPOFFER.process_started\-process_completed.100
T}	T{
1662
T}
_
T{
DHCPDISCOVER.DHCPOFFER.composite\-total_response.100
T}	T{
2051
T}
.TE
.UNINDENT
.UNINDENT
.sp
توجه داشته باشید که علاوه بر به‌روزرسانی‌های رویدادهای مجاور، یک به‌روزرسانی مدت‌زمان اضافی
برای مدت‌زمان کل تمام پشته وجود دارد که کلید آن شامل جفت‌رویداد
\fBcomposite\-total_response\fP است. این مقدار، کل زمان لازم برای پاسخگویی را از هنگام دریافت پرس‌وجو
تا زمان آماده شدن پاسخ برای ارسال رهگیری می‌کند. در نهایت، به‌روزرسانی‌های مدت‌زمان سراسری نیز
برای هر یک از موارد فوق وجود دارد:
.INDENT 0.0
.INDENT 3.5
.TS
box center;
l|l.
T{
کلیدهای مدت‌زمان سراسری
T}	T{
به‌روزرسانی به
میکروثانیه
T}
_
T{
DHCPDISCOVER.DHCPOFFER.socket_received\-buffer_read.0
T}	T{
247
T}
_
T{
DHCPDISCOVER.DHCPOFFER.buffer_read\-mt_queue.0
T}	T{
87
T}
_
T{
DHCPDISCOVER.DHCPOFFER.mt_queued\-process_started.0
T}	T{
55
T}
_
T{
DHCPDISCOVER.DHCPOFFER.process_started\-process_completed.0
T}	T{
1662
T}
_
T{
DHCPDISCOVER.DHCPOFFER.composite\-total_response.0
T}	T{
2051
T}
.TE
.UNINDENT
.UNINDENT.SS گزارش‌دهی آمارها (Statistics Reporting)
.sp
هنگامی که فعال باشد، perfmon در هر بار تکمیل یک بازه نمونه‌برداری توسط یک مدت‌زمان (duration)، داده‌های آن را گزارش می‌دهد (به \fBstats\-mgr\-reporting\fP در بخش پیکربندی مراجعه کنید). هر آمار از قرارداد نام‌گذاری زیر پیروی می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{subnet\-id[x]}.perfmon.<query type>\-<response type>.<start event>\-<end event>.<value\-name>
.EE
.UNINDENT
.UNINDENT
.sp
برای هر مورد، هم یک مقدار سراسری و هم یک مقدار ویژهٔ زیرشبکه وجود دارد. در حال حاضر، تنها مقداری که برای یک کلید مدت‌زمان مشخص گزارش می‌شود \fBmean\-usecs\fP است؛ این آمار میانگین زمان بین جفت‌رویدادِ آن مدت‌زمان در طول آخرین بازهٔ تکمیل‌شده است. به عبارت دیگر، اگر در طول یک بازهٔ مشخص هفت رخداد (یعنی به‌روزرسانی) با مجموع 3500us رخ داده باشد، مقدار \fBmean\-usecs\fP گزارش‌شده 500us خواهد بود. با ادامهٔ مثال بالا، آمارهای گزارش‌شده برای مقادیر در سطح زیرشبکه به صورت زیر نام‌گذاری می‌شوند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
subnet[100].perfmon.DHCPDISCOVER.DHCPOFFER.socket_received\-buffer_read.mean\-usecs
subnet[100].perfmon.DHCPDISCOVER.DHCPOFFER.buffer_read\-mt_queue.mean\-usecs
subnet[100].perfmon.DHCPDISCOVER.DHCPOFFER.mt_queued\-process_started.mean\-usecs
subnet[100].perfmon.DHCPDISCOVER.DHCPOFFER.process_started\-process_completed.mean\-usecs
subnet[100].perfmon.DHCPDISCOVER.DHCPOFFER.composite\-total_response.mean\-usecs
.EE
.UNINDENT
.UNINDENT
.sp
و برای مقادیر سراسری به این صورت نمایش داده می‌شوند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
perfmon.DHCPDISCOVER.DHCPOFFER.socket_received\-buffer_read.mean\-usecs
perfmon.DHCPDISCOVER.DHCPOFFER.buffer_read\-mt_queue.mean\-usecs
perfmon.DHCPDISCOVER.DHCPOFFER.mt_queued\-process_started.mean\-usecs
perfmon.DHCPDISCOVER.DHCPOFFER.process_started\-process_completed.mean\-usecs
perfmon.DHCPDISCOVER.DHCPOFFER.composite\-total_response.mean\-usecs
.EE
.UNINDENT
.UNINDENT
.sp
نتایج به StatsMgr گزارش می‌شوند؛ مؤلفه‌ای داخلی در Kea که داده‌ها را به عنوان آمارهایی گزارش می‌کند که می‌توان با دستورهای آماری آن‌ها را دریافت کرد. این داده‌ها با استفاده از دستورهای \fBstatistic\-get\-all\fP \%<#\:std-isccmd-statistic-get-all>، \fBstatistic\-global\-get\-all\fP \%<#\:std-isccmd-statistic-global-get-all>، یا \fBstatistic\-get\fP \%<#\:std-isccmd-statistic-get>\& قابل واکشی هستند.
.SS هشدارها (Alarms)
.sp
می‌توان هشدارها را برای نظارت بر مدت‌زمان‌های خاصی تعریف کرد. هر هشدار یک حد بالا، \fBhigh\-water\-ms\fP، و یک حد پایین، \fBlow\-water\-ms\fP تعریف می‌کند. اگر میانگین مقدار گزارش‌شده برای مدت‌زمان از حد بالا فراتر رود، یک لاگ هشدار در سطح WARN صادر می‌شود، که در این مرحله هشدار «فعال‌شده» (\(dqtriggered\(dq) در نظر گرفته می‌شود. پس از فعال شدن، تا زمانی که میانگین گزارش‌شده برای مدت‌زمان بالاتر از حد پایین باقی بماند، لاگ سطح WARN در بازه گزارش هشدار که توسط \fBalarm\-report\-secs\fP مشخص شده تکرار می‌شود. هنگامی که میانگین به زیر حد پایین افت کند، هشدار پاک شده و یک لاگ در سطح INFO صادر می‌شود.
.sp
لاگ سطح WARN ناشی از فعال شدن هشدار شبیه به نمونه زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
2024\-03\-20 10:22:14.030 WARN [kea\-dhcp6.leases/47195.139913679886272] PERFMON_ALARM_TRIGGERED Alarm for DHCPDISCOVER.DHCPOFFER.composite\-total_response.0 has been triggered since 2024\-03\-20 10:18:20.070000, reported mean duration 00:00:00.700000 exceeds high\-water\-ms: 500
.EE
.UNINDENT
.UNINDENT
.sp
لاگ سطح INFO ناشی از پاک شدن هشدار به این صورت است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
2024\-03\-20 10:30:14.030 INFO [kea\-dhcp6.leases/47195.139913679886272] PERFMON_ALARM_CLEARED Alarm for DHCPDISCOVER.DHCPOFFER.composite\-total_response.0 has been cleared, reported mean duration 00:00:00.010000 is now below low\-water\-ms: 25
.EE
.UNINDENT
.UNINDENT
.SS دستورهای API (API Commands)
.SS دستور \fBperfmon\-control\fP
.sp
از این دستور می‌توان برای فعال یا غیرفعال کردن پایش فعال و گزارش‌دهی آمارها در زمان اجرا، بدون تغییر یا بارگذاری مجدد پیکربندی، استفاده کرد.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
     \(dqcommand\(dq: \(dqperfmon\-control\(dq,
     \(dqarguments\(dq: {
         \(dqenable\-monitoring\(dq: true,
         \(dqstats\-mgr\-reporting\(dq: false
     }
}
.EE
.UNINDENT
.UNINDENT
.sp
صرف‌نظر از آرگومان‌های ارائه‌شده (در صورت وجود)، مقادیر حاصل از هر دو پرچم همواره بازگردانده می‌شوند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqperfmon\-control success\(dq,
    \(dqarguments\(dq: {
         \(dqenable\-monitoring\(dq: true,
         \(dqstats\-mgr\-reporting\(dq: false
    }
}
.EE
.UNINDENT
.UNINDENT
.SS دستور \fBperfmon\-get\-all\-durations\fP
.sp
این دستور تمام داده‌های مدت‌زمان پایش‌شده را که در حال حاضر توسط کتابخانه قلاب (hook library) Perfmon در حافظه نگه‌داری می‌شوند، واکشی می‌کند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqperfmon\-get\-all\-durations\(dq,
    \(dqarguments\(dq: {
        \(dqresult\-set\-format\(dq: true
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
در صورت موفقیت دستور، نتیجه 0 همراه با داده‌های مدت‌زمان پایش‌شده بازگردانده می‌شود، در حالی که در صورت نامعتبر بودن دستور یا بروز خطا در پردازش دستور، نتیجه 1 بازگردانده می‌شود.
.sp
قالب داده‌های مدت‌زمان پایش‌شده بازگردانده‌شده، توسط آرگومان اختیاری \fBresult\-set\-format\fP تعیین می‌شود. هنگامی که false باشد (پیش‌فرض)، فهرست مدت‌زمان‌ها به صورت فهرستی از عناصر تکی مطابق شکل زیر بازگردانده خواهد شد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqarguments\(dq: {
       \(dqdurations\(dq: [{
           \(dqduration\-key\(dq: {
               \(dqquery\-type\(dq: \(dqDHCPDISCOVER\(dq,
               \(dqresponse\-type\(dq: \(dqDHCPOFFER\(dq,
               \(dqstart\-event\(dq: \(dqbuffer_read\(dq,
               \(dqstop\-event\(dq: \(dqmt_queued\(dq,
               \(dqsubnet\-id\(dq: 0
           },
           \(dqmax\-duration\-usecs\(dq: 118,
           \(dqmin\-duration\-usecs\(dq: 31,
           \(dqoccurrences\(dq: 501,
           \(dqstart\-time\(dq: \(dq2024\-06\-12 17:52:06.814884\(dq,
           \(dqtotal\-duration\-usecs\(dq: 23951,
           \(dqmean\-duration\-usecs\(dq: 47
        },
        ...
       ],
       \(dqresult\-set\-format\(dq: false,
       \(dqinterval\-width\-secs\(dq: 5,
       \(dqtimestamp\(dq: \(dq2024\-06\-12 17:52:22.397233\(dq
   },
\(dqresult\(dq: 0,
\(dqtext\(dq: \(dqperfmon\-get\-all\-durations: n found\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
هنگامی که \fBresult\-set\-format\fP برابر با true باشد، فهرست مدت‌زمان‌ها در قالبی مشابه با مجموعه نتایج (result set) پایگاه‌داده SQL به صورت زیر بازگردانده می‌شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqarguments\(dq: {
        \(dqdurations\-result\-set\(dq: {
            \(dqcolumns\(dq: [
                \(dqquery\-type\(dq,
                \(dqresponse\-type\(dq,
                \(dqstart\-event\(dq,
                \(dqend\-event\(dq,
                \(dqsubnet\-id\(dq,
                \(dqinterval\-start\(dq,
                \(dqoccurrence\(dq,
                \(dqmin\-duration\-usecs\(dq,
                \(dqmax\-duration\-usecs\(dq,
                \(dqtotal\-duration\-usecs\(dq,
                \(dqmean\-duration\-usecs\(dq
            ],
            \(dqrows\(dq: [ [
                \(dqDHCPDISCOVER\(dq,
                \(dqDHCPOFFER\(dq,
                \(dqbuffer_read\(dq,
                \(dqmt_queued\(dq,
                0,
                \(dq2024\-06\-12 17:52:06.814884\(dq,
                501,
                31,
                118,
                23951,
                47
                ],
                ...
            ]
        },
        \(dqresult\-set\-format\(dq: true,
        \(dqinterval\-width\-secs\(dq: 5,
        \(dqtimestamp\(dq: \(dq2024\-06\-12 17:52:22.397233\(dq
    },
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqperfmon\-get\-all\-durations: n found\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
مقادیر داده برای هر مدت‌زمان از آخرین بازه داده‌های تکمیل‌شده آن مدت‌زمان خواهد بود. اگر یک مدت‌زمان فاقد چنین بازه‌ای باشد، مقدار \fBinterval\-start\fP برابر با \(dq<none>\(dq گزارش شده و مقادیر باقی‌مانده صفر خواهند بود..SS "پیکربندی (Configuration)"
.sp
استفاده از کتابخانه قلاب پایش کارایی از طریق چندین پارامتر پیکربندی می‌شود:
.INDENT 0.0
.IP \(bu 2
.INDENT 2.0
.TP
.B enable\-monitoring
این پارامتر تجمیع داده‌های رویداد را برای گزارش‌گیری، آمار و هشدارها فعال می‌کند. مقدار پیش‌فرض آن \fBfalse\fP\& است.
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B interval\-width\-secs
مدت‌زمانی را بر حسب ثانیه مشخص می‌کند که طی آن، مدت‌زمان انجام وظایف مجزا پیش از گزارش شدن در یک مجموعه تجمیع می‌شوند. مقدار پیش‌فرض ۶۰ ثانیه است.
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B stats\-mgr\-reporting
گزارش‌دهی مقادیر تجمیع‌شده به StatsMgr را فعال می‌کند. مقدار پیش‌فرض آن \fBtrue\fP\& است.
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B alarm\-report\-secs
مدت‌زمانی را بر حسب ثانیه میان دفعات ثبت لاگ برای یک هشدار پس از برانگیخته شدن آن مشخص می‌کند. مقدار پیش‌فرض ۳۰۰ ثانیه است.
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B alarms
فهرستی اختیاری از هشدارهایی است که مقادیر تجمیعی مدت‌زمان‌های خاصی را پایش می‌کنند. هر هشدار با این چهار پارامتر تعریف می‌شود:
.UNINDENT
.INDENT 2.0
.IP \(bu 2
.INDENT 2.0
.TP
.B duration\-key
مدت‌زمان پایش‌شده را برای موارد زیر مشخص می‌کند:
.UNINDENT
.INDENT 2.0
.IP \(bu 2
query\-type \- نوع پیام پرس‌وجوی کلاینت (مانند DHCPDISCOVER، DHCPV6_REQUEST)
.IP \(bu 2
response\-type \- نوع پیام پاسخ سرور (مانند DHCPOFFER، DHCPV6_REPLY)
.IP \(bu 2
start\-event \- رویدادی که آغاز وظیفه را مشخص می‌کند (مانند socket_received، process_started)
.IP \(bu 2
stop\-event \- رویدادی که پایان وظیفه را مشخص می‌کند
.IP \(bu 2
subnet\-id \- زیرشبکه انتخاب‌شده هنگام پردازش پیام (یا 0 برای مدت‌زمان‌های سراسری)
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B enable\-alarm
این هشدار را فعال یا غیرفعال می‌کند؛ مقدار پیش‌فرض \fBtrue\fP\& است.
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B high\-water\-ms
مقداری را بر حسب میلی‌ثانیه مشخص می‌کند که مدت‌زمان باید بیش از آن باشد تا این هشدار برانگیخته شود؛ باید بزرگ‌تر از صفر باشد.
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B low\-water\-ms
مقداری را بر حسب میلی‌ثانیه مشخص می‌کند که مدت‌زمان باید به کمتر از آن افت کند تا این هشدار پاک شود؛ باید بزرگ‌تر از صفر اما کمتر از \fBhigh\-water\-ms\fP\& باشد.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
ثبت غیرفعال وقایع رویدادها همواره فعال است، حتی بدون مشخص کردن بخش \(dqparameters\(dq.
.UNINDENT
.UNINDENT
.sp
نمونه‌ای از پیکربندی در زیر نشان داده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqhooks\-libraries\(dq: [
    {
        \(dqlibrary\(dq: \(dqlibdhcp_perfmon.so\(dq,
        \(dqparameters\(dq: {
            \(dqenable\-monitoring\(dq: true,
            \(dqinterval\-width\-secs\(dq: 5,
            \(dqstats\-mgr\-reporting\(dq: true,
            \(dqalarm\-report\-secs\(dq: 600,
            \(dqalarms\(dq: [
            {
                \(dqduration\-key\(dq: {
                    \(dqquery\-type\(dq: \(dqDHCPDISCOVER\(dq,
                    \(dqresponse\-type\(dq: \(dqDHCPOFFER\(dq,
                    \(dqstart\-event\(dq: \(dqprocess\-started\(dq,
                    \(dqstop\-event\(dq: \(dqprocess\-completed\(dq,
                    \(dqsubnet\-id\(dq: 0
                },
                \(dqenable\-alarm\(dq: true,
                \(dqhigh\-water\-ms\(dq: 500,
                \(dqlow\-water\-ms\(dq: 25
            }]
        }
    }]
}
.EE
.UNINDENT
.UNINDENT
.SS "\fBlibdhcp_ping_check.so\fP: بررسی پینگ (Ping Check)"
.sp
این کتابخانه قلاب قابلیت انجام «بررسی پینگ» (\(dqping check\(dq) روی یک آدرس IPv4 نامزد را پیش از پیشنهاد آن به یک کلاینت DHCP می‌افزاید. این ویژگی مشابه رفتاری است که در ISC DHCP وجود دارد و در RFC 2131 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc2131>، بخش ۳.۱، بند ۲ پیشنهاد شده است.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
کتابخانه \fBlibdhcp_ping_check.so\fP بخشی از کد متن‌باز است و برای همه کاربران Kea در دسترس است. این قابلیت پیش‌تر تنها برای مشتریان ISC با قرارداد پشتیبانی تجاری در دسترس بود.
.UNINDENT
.UNINDENT.SS "نمای کلی (Overview)"
.sp
کتابخانهٔ Ping Check، که در Kea 2.5.4 اضافه شده است، می‌تواند با افزوده شدن به عنصر \fBhooks\-libraries\fP در پیکربندی کارگزار، توسط دیمن \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> بارگذاری شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqhooks\-libraries\(dq: [
        {
            \(dqlibrary\(dq: \(dqlibdhcp_ping_check.so\(dq,
            \(dqparameters\(dq: {
                ...
            }
        },
        ...
    ],
    ...
}
.EE
.UNINDENT
.UNINDENT
.sp
هنگامی که این کتابخانه بارگذاری شود، در صورتی که همهٔ شرایط زیر برقرار باشند، \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> پیش از پیشنهاد یک اجاره به کلاینت، یک بررسی پینگ (ping check) انجام می‌دهد:
.INDENT 0.0
.IP 1. 3
کتابخانهٔ قلاب ping check بارگذاری شده باشد.
.IP 2. 3
بررسی پینگ فعال باشد.
.IP 3. 3
کارگزار در حال پاسخ‌گویی به یک DHCPDISCOVER باشد.
.IP 4. 3
اجارهٔ کاندید نه فعال باشد و نه رزرو شده.
.IP 5. 3
هر یک از موارد زیر درست باشد:
.INDENT 3.0
.INDENT 3.5
a. این نخستین پیشنهاد این اجاره به این کلاینت باشد. این بررسی تنها در صورتی قابل انجام است که \fBoffer\-lifetime\fP بزرگ‌تر از صفر باشد (یعنی تخصیص موقت در DHCPDISCOVER فعال باشد). اگر \fBoffer\-lifetime\fP صفر باشد، بررسی‌های پینگ برای هر DHCPOFFER انجام می‌شوند، زیرا کارگزار راهی برای دانستن اینکه آیا پیش‌تر پیشنهادی ارائه شده است یا خیر ندارد.
.INDENT 0.0
.IP b. 3
اجاره به کلاینتی غیر از مالک پیشین آن در حال پیشنهاد داده شدن باشد.
.UNINDENT
.sp
c. اجاره به مالک پیشین آن پیشنهاد داده شود و بیش از تعداد ثانیه‌های مشخص‌شده توسط \fBping\-cltt\-secs\fP از CLTT اجارهٔ اولیه سپری شده باشد.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
هنگامی که کتابخانهٔ ping check بارگذاری شده باشد، کارگزار \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> با انجام مراحل زیر به یک DHCPDISCOVER پاسخ می‌دهد:
.sp
1. انتخاب یک آدرس IPv4 کاندید از طریق روندهای معمول و استفاده از آن برای ساخت یک DHCPOFFER.
.sp
2. پارک کردن DHCPOFFER و درخواست یک بررسی پینگ از کتابخانهٔ قلاب ping check از طریق فراخوان \fBlease4_offer\fP آن. برای آشنایی مقدماتی با پارک بسته‌ها، به Parked\-Packet Limit مراجعه کنید.
.sp
3. آزمودن شرایط فراخوان که در بالا شرح داده شد: اگر برقرار نباشند، بدون انجام بررسی بازمی‌گردد و کارگزار DHCPOFFER را به کلاینت ارسال می‌کند. در غیر این صورت، فراخوان یک بررسی پینگ برای آدرس اجاره آغاز می‌کند.
.sp
4. پس از پایان بررسی پینگ، در صورتی که نتیجهٔ بررسی حاکی از در دسترس بودن آدرس باشد، کارگزار DHCPOFFER را به کلاینت ارسال می‌کند؛ در غیر این صورت، DHCPFOFFER را دور انداخته و یک اجارهٔ DECLINED برای آن آدرس ایجاد می‌کند.
.sp
هر بررسی پینگ شامل مراحل زیر است:
.sp
1. اگر تعداد ECHO REPLYهای ارسال‌شده کمتر از حداقل تعداد پیکربندی‌شده برای ارسال باشد، یک ICMP ECHO REQUEST به آدرس اجاره ارسال می‌شود. در غیر این صورت، نتیجه گرفته می‌شود که آدرس در دسترس است.
.sp
2. اگر هیچ ECHO REPLYای در بازهٔ زمانی قابل‌پیکربندی دریافت نشود، بازگشت به مرحلهٔ 1.
.INDENT 0.0
.IP 3. 3
به محض دریافت یک ICMP ECHO REPLY، نتیجه گرفته می‌شود که اجاره در دسترس نیست (NOT available).
.IP 4. 3
اگر هر یک از موارد زیر رخ دهد:
.INDENT 3.0
.INDENT 3.5
.INDENT 0.0
.IP a. 3
دریافت پیام ICMP DESTINATION UNREACHABLE
.IP b. 3
شکست در ارسال ICMP ECHO REQUEST به دلیل خطای شبکه (مانند غیرقابل‌دسترس بودن شبکه)
.IP c. 3
شکست در ارسال ICMP ECHO REQUEST به دلیل خطای دسترسی و مجوزها (مانند اینکه آدرس اجاره یک آدرس برودکست باشد)
.IP d. 3
شکست در ارسال ICMP ECHO REQUEST با خطای پر بودن بافر سوکت (socket buffer full)
.UNINDENT
.sp
از بررسی آدرس صرف‌نظر کرده و آن را در دسترس تلقی می‌کند.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
خطاهای \(dqSocket buffer full\(dq نشان می‌دهند که محدودیت‌های نرخ (rate limits) سیستم‌عامل روی ICMP رد شده است. کارگزار آن‌ها را دوباره تلاش نمی‌کند، زیرا احتمالاً تنها وضعیت را وخیم‌تر خواهد کرد. اگر این اتفاق به طور مداوم رخ دهد، ممکن است بار کلاینت‌ها روی کارگزار برای انجام بررسی پینگ بیش از حد زیاد باشد. بررسی پینگ برای سیستم‌هایی با توان عملیاتی (throughput) بالا توصیه نمی‌شود.
.UNINDENT
.UNINDENT
.SS "پیکربندی (Configuration)"
.sp
کتابخانهٔ قلاب ping check در حال حاضر از پارامترهای پیکربندی زیر پشتیبانی می‌کند که می‌توانند در سطوح سراسری (global) و زیرشبکه (subnet) تنظیم شوند؛ مقادیر سطح زیرشبکه بر مقادیر سراسری تقدم دارند:
.INDENT 0.0
.IP \(bu 2
\fBenable\-ping\-check\fP \- این پارامتر بررسی پینگ را در یک حوزهٔ مشخص فعال یا غیرفعال می‌کند.
.IP \(bu 2
\fBmin\-ping\-requests\fP \- حداقل تعداد ECHO REQUESTهای ارسال‌شده بدون دریافت پاسخ، پیش از اعلام در دسترس بودن یک آدرس. مقدار پیش‌فرض 1 است؛ این مقدار باید بزرگ‌تر از صفر باشد.
.IP \(bu 2
\fBreply\-timeout\fP \- حداکثر مدت زمانی که برای دریافت پاسخ به یک ECHO REQUEST منفرد منتظر می‌ماند. این مقدار بر حسب میلی‌ثانیه مشخص شده و باید بزرگ‌تر از صفر باشد؛ مقدار پیش‌فرض 100 است.
.IP \(bu 2
\fBping\-cltt\-secs\fP \- تعداد ثانیه‌هایی را مشخص می‌کند که در صورت تعلق کلاینت به عنوان مالک قبلی اجاره، باید پس از CLTT اجاره سپری شود تا بررسی پینگ انجام شود. مقدار پیش‌فرض 60 ثانیه است.
.UNINDENT
.sp
پارامتر زیر تنها در سطح سراسری پشتیبانی می‌شود:
.INDENT 0.0
.IP \(bu 2
\fBping\-channel\-threads\fP \- در حالت چندنخی (multi\-threaded)، این تعداد نخ‌ها در استخر نخ (thread pool) کانال است. مقدار پیش‌فرض 0 است که به کتابخانه دستور می‌دهد از همان تعداد نخ‌های هستهٔ Kea استفاده کند. اگر این مقدار در حالت تک‌نخی بودن Kea مشخص شود، نادیده گرفته خواهد شد.
.UNINDENT
.sp
گزیدهٔ پیکربندی زیر یک پیکربندی در سطح سراسری را نمایش می‌دهد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqhooks\-libraries\(dq: [{
        \(dqlibrary\(dq: \(dqlibdhcp_ping_check.so\(dq,
        \(dqparameters\(dq: {
            \(dqenable\-ping\-check\(dq : true,
            \(dqmin\-ping\-requests\(dq : 1,
            \(dqreply\-timeout\(dq : 100,
            \(dqping\-cltt\-secs\(dq : 60,
            \(dqping\-channel\-threads\(dq : 0
        }
    }]
}
.EE
.UNINDENT
.UNINDENT
.sp
گزیدهٔ زیر یک پیکربندی در سطح زیرشبکه را نشان می‌دهد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
 {
 \(dqsubnet4\(dq: [{
     \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
     \(dqpools\(dq: [{
         \(dqpool\(dq: \(dq192.0.2.10 \- 192.0.2.20\(dq
     }],

     \(dquser\-context\(dq: {
         \(dqping\-check\(dq: {
             \(dqenable\-ping\-check\(dq : true,
             \(dqmin\-ping\-requests\(dq : 2,
             \(dqreply\-timeout\(dq : 250,
             \(dqping\-cltt\-secs\(dq : 120
         }
     }
 }]
}
.EE
.UNINDENT
.UNINDENT.SS \fBlibdhcp_pgsql.so\fP: بک‌اند پایگاه‌داده برای PostgreSQL
.INDENT 0.0
.TP
.B این کتابخانه هوک ذخیره‌سازی پایگاه‌داده PostgreSQL را برای موارد زیر پیاده‌سازی می‌کند:
.INDENT 7.0
.IP \(bu 2
بک‌اند اجاره (Lease Backend)
.IP \(bu 2
بک‌اند میزبان (Host Backend)
.IP \(bu 2
بک‌اند پیکربندی (Configuration Backend)
.UNINDENT
.UNINDENT
.SS بک‌اند پیکربندی PostgreSQL
.sp
این کتابخانه هوک در ارتباط با \fBlibdhcp_cb_cmds.so\fP کار می‌کند تا
API لازم جهت ایجاد، خواندن، به‌روزرسانی و حذف (CRUD) پیکربندی را
در یک پایگاه‌داده PostgreSQL پیاده‌سازی کند. لطفاً برای جزئیات بیشتر به libdhcp_cb_cmds.so: Configuration Backend Commands مراجعه کنید.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
\fBlibdhcp_pgsql.so\fP بخشی از کد متن‌باز است و
برای تمام کاربران Kea در دسترس می‌باشد. با این حال، این کتابخانه هوک تنها با
\fBlibdhcp_cb_cmds.so\fP کار می‌کند که مدیریت آسان پیکربندی را با استفاده از
دستورات API ممکن می‌سازد. \fBlibdhcp_cb_cmds.so\fP
تنها برای مشتریان ISC دارای قرارداد پشتیبانی تجاری در دسترس است؛ برای اطلاعات
بیشتر درباره گزینه‌های اشتراک، لطفاً فرم موجود در
\%<https://\:www\:.isc\:.org/\:contact>\& را تکمیل نمایید.
.UNINDENT
.UNINDENT
.SS \fBlibdhcp_radius.so\fP: پشتیبانی از سرور RADIUS
.sp
این کتابخانه هوک به سرورهای DHCP در Kea امکان می‌دهد تا از پروتکل RADIUS برای
احراز صلاحیت کلاینت‌های DHCP از طریق سرویس دسترسی (access service)، یا برای ژورنال‌سازی اجاره‌های DHCP
از طریق سرویس حسابرسی (accounting service) استفاده کنند. برای جزئیات مربوط به RADIUS در Kea، لطفاً
RADIUS \%<#\:radius>\& را ببینید.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
\fBlibdhcp_radius.so\fP بخشی از کد متن‌باز است و
برای تمامی کاربران Kea در دسترس می‌باشد.
این مورد پیش‌تر تنها برای مشتریان ISC با قرارداد پشتیبانی تجاری در دسترس بود.
.UNINDENT
.UNINDENT
.SS \fBlibdhcp_rbac.so\fP: کنترل دسترسی مبتنی بر نقش (RBAC)
.SS نمای کلی کنترل دسترسی مبتنی بر نقش (RBAC)
.sp
پیش از پردازش دستورات در درخواست‌های HTTP دریافتی، \fBlibdhcp_rbac.so\fP
پارامترهای مشخصی را دریافت می‌کند، مانند بخش common\-name در نام موضوع (subject name) گواهی
کلاینت، تا نقشی را به درخواست اختصاص دهد.
پیکربندی مرتبط با این نقش برای پذیرش یا رد دستور
استفاده می‌شود. پس از پردازش، پاسخ می‌تواند بازنویسی شود؛ مثلاً
بخش‌هایی از آن حذف گردند.
.INDENT 0.0
.TP
.B خلاصه‌ای از مراحل پردازش یک درخواست:
.INDENT 7.0
.IP \(bu 2
کتابخانه HTTP برخی از اطلاعات را برای استفاده‌های بعدی ثبت می‌کند، مانند
آدرس دوردست (remote address).
.IP \(bu 2
هنگامی که TLS الزامی باشد اما درخواست توسط TLS محافظت نشده باشد،
درخواست با ارسال پاسخ \(dqunauthorized\(dq رد می‌شود.
.IP \(bu 2
دستور از درخواست استخراج می‌شود.
.IP \(bu 2
با استفاده از اطلاعات ثبت‌شده در درخواست، یک نقش اختصاص داده می‌شود.
.IP \(bu 2
نقش برای پذیرش (عبور دادن) یا رد کردن (ارسال
یک پاسخ forbidden به) دستور استفاده می‌شود.
.UNINDENT
.TP
.B خلاصه‌ای از مراحل پردازش یک پاسخ:
.INDENT 7.0
.IP \(bu 2
اطلاعات پیوست‌شده به درخواست، در طول پردازش درخواست
(هنگامی که درخواست پذیرفته شد) بازیابی می‌شوند.
.IP \(bu 2
فیلترهای درخواست بر روی پاسخ اعمال می‌شوند.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
\fBlibdhcp_rbac.so\fP تنها برای مشتریان ISC دارای
قرارداد پشتیبانی تجاری در دسترس است. برای اطلاعات بیشتر درباره گزینه‌های اشتراک،
لطفاً فرم موجود در \%<https://\:www\:.isc\:.org/\:contact>\& را تکمیل نمایید.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
از نسخه 2.7.2 در Kea، کنترل دسترسی مبتنی بر نقش (RBAC) دیگر محدود به Control Agent نیست:
می‌تواند توسط هر سرور دیگری که از سوکت‌های کنترلی HTTP/HTTPS پشتیبانی می‌کند
مانند سرورهای DHCPv4، DHCPv6 و DDNS استفاده شود.
از نسخه 3.1.8 در Kea، مؤلفه منسوخ‌شده Control Agent حذف گردیده است.
.UNINDENT
.UNINDENT
.SS پیکربندی کنترل دسترسی مبتنی بر نقش
.SS تخصیص نقش
.sp
تخصیص نقش توسط روش role\-assignment پیکربندی‌شده مدیریت می‌شود.
.SS روش‌های تخصیص نقش
.TS
box center;
l|l.
T{
نام
T}	T{
توضیحات
T}
_
T{
remote\-address
T}	T{
آدرس IP دوردست/کلاینت
T}
_
T{
cert\-subject
T}	T{
بخش common\-name از نام موضوع (subject name) گواهی کلاینت
T}
_
T{
cert\-issuer
T}	T{
بخش common\-name از نام صادرکننده (issuer name) گواهی کلاینت
T}
_
T{
basic\-authentication
T}	T{
شناسه کاربری در احراز هویت اولیه HTTP
T}
_
T{
custom\-value
T}	T{
یک نقش دیگر می‌تواند در هوک‌های خارجی طراحی شود
T}
.TE.SS "پیکربندی نقش (Role Configuration)"
.SS "پارامترهای پیکربندی نقش (Role Configuration Parameters)"
.TS
box center;
l|l.
T{
نام
T}	T{
توضیحات
T}
_
T{
name
T}	T{
نام نقش (به‌استثنای نقش‌های پیش‌فرض و ناشناخته)
T}
_
T{
accept\-commands
T}	T{
فهرست دسترسی مجاز (accept)
T}
_
T{
reject\-commands
T}	T{
فهرست دسترسی ردشده (reject)
T}
_
T{
other\-commands
T}	T{
مشخص می‌کند برای دستوراتی که با فهرست‌های مجاز و
ردشده مطابقت ندارند چه عملی انجام شود (پیش‌فرض: reject)
T}
_
T{
list\-match\-first
T}	T{
با تعیین فهرستی که باید ابتدا بررسی و اعمال شود، مشخص
می‌کند برای دستوراتی که با هر دو فهرست مجاز و ردشده
تطابق دارند چه اقدامی صورت گیرد (پیش‌فرض: accept)
T}
_
T{
response\-filters
T}	T{
فیلترهایی که باید روی پاسخ‌ها اعمال شوند
T}
.TE
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
تخصیص نقش ممکن است با \fBcert\-subject\fP شکست بخورد، هنگامی که گواهی کلاینت الزامی نبوده باشد، یا ممکن است فاقد نام عمومی موضوع (subject common name) بوده و در عوض دارای یک نام جایگزین موضوع DNS باشد. در این حالت، تخصیص نقش یک نقش خالی بازمی‌گرداند و از مدخل \fBdefault\-role\fP استفاده می‌شود.
.sp
تخصیص نقش می‌تواند مقداری غیرمنتظره بازگرداند، مثلاً در صورت وجود یک نام نقش ثبت‌نشده یا یک اشتباه تایپی. در این حالت، مدخل \fBunknown\-role\fP به کار گرفته می‌شود.
.sp
رفتار پیش‌فرض برای هر دوی \fBdefault\-role\fP و \fBunknown\-role\fP رد کردن (reject) تمام دستورات است.
.UNINDENT
.UNINDENT
.SS "دستورات API (API Commands)"
.sp
تمام دستورات REST API در فایل‌هایی درون دایرکتوری سورس \fBsrc/share/api\fP، یا در نسخهٔ نصب‌شدهٔ Kea در \fB\&.../share/kea/api\fP شرح داده شده‌اند. \fBlibdhcp_rbac.so\fP این فایل‌ها را می‌خواند تا نام، حق دسترسی (یعنی \fBread\fP یا \fBwrite\fP)، و نام قلاب (hook) را دریافت کند. حق دسترسی را می‌توان در فایل تغییر داد اما تغییرات تنها پس از راه‌اندازی مجدد سرور یا کارگزار اعمال می‌شوند. حذف تعاریف دستور از \fB\&.../share/kea/api\fP پیامدهایی به همراه دارد: اگر فهرست کنترل دسترسی مبتنی بر \fBread\fP یا \fBwrite\fP باشد و فایل تعریف موجود نباشد، سرور یا کارگزار همواره چنین دستوری را رد می‌کند. اگر فهرست کنترل دسترسی از \fBcommands\fP برای تعیین نام یک دستور استفاده کند و فایل تعریف آن دستور خاص در \fB\&.../share/kea/api\fP مفقود باشد، سرور Kea هنگام راه‌اندازی و خروج یک خطا لاگ می‌کند.
.SS "پارامترهای اضافی تعریف دستور (Extra Command-Definition Parameters)"
.TS
box center;
l|l.
T{
نام
T}	T{
توضیحات
T}
_
T{
name
T}	T{
(اجباری) نام دستور
T}
_
T{
access
T}	T{
(اجباری) حق دسترسی، یعنی \fBread\fP یا \fBwrite\fP
T}
_
T{
hook
T}	T{
(اختیاری) نام قلاب (برای دستورات سرورها یا کارگزارها
خالی است یا وجود ندارد)
T}
.TE
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این فایل‌های شرح دستور از نظر امنیتی حساس هستند؛ به عنوان مثال با مجوزهای دسترسی بیش از حد آزادانه، یک مهاجم محلی ممکن است آن‌ها را تغییر داده و هدف RBAC را بی‌اثر سازد.
.UNINDENT
.UNINDENT
.SS "فهرست‌های کنترل دسترسی (Access Control Lists)"
.sp
فهرست‌های کنترل دسترسی را می‌توان با استفاده از یک نام (رشته) یا یک نگاشت تک‌مدخلی مشخص کرد..SS فهرست دسترسی نام‌گذاری‌شده از پیش تعریف‌شده
.TS
box center;
l|l.
T{
نام
T}	T{
توضیحات
T}
_
T{
ALL
T}	T{
با همه‌چیز مطابقت دارد
T}
_
T{
NONE
T}	T{
با هیچ‌چیز مطابقت ندارد
T}
_
T{
READ
T}	T{
با دستورهای دارای حق دسترسی خواندن (read\-access) مطابقت دارد
T}
_
T{
WRITE
T}	T{
با دستورهای دارای حق دسترسی نوشتن (write\-access) مطابقت دارد
T}
.TE
.sp
مشخصات فهرست دسترسی نگاشتی، از یک نوع فهرست در نام تک‌ورودی و از پارامتر در مقدار آن استفاده می‌کنند.
.SS انواع فهرست دسترسی
.TS
box center;
l|l|l.
T{
نام
T}	T{
توضیحات
T}	T{
پارامتر
T}
_
T{
not
T}	T{
نقیض منطقی
T}	T{
فهرست دسترسی
T}
_
T{
and
T}	T{
عطف منطقی
T}	T{
فهرستی از فهرست‌های دسترسی
T}
_
T{
or
T}	T{
فصل منطقی
T}	T{
فهرستی از فهرست‌های دسترسی
T}
_
T{
command
T}	T{
فهرست صریح
T}	T{
فهرستی از نام‌های دستور
T}
_
T{
access
T}	T{
بر اساس حق دسترسی
T}	T{
حق دسترسی (\fBread\fP یا \fBwrite\fP)
T}
_
T{
hook
T}	T{
بر اساس قلاب
T}	T{
نام قلاب (می‌تواند خالی باشد)
T}
.TE
.SS فیلترهای پاسخ
.SS فیلترهای پاسخ از پیش تعریف‌شده
.TS
box center;
l|l.
T{
نام
T}	T{
توضیحات
T}
_
T{
list\-commands
T}	T{
دستورهای غیرمجاز را از پاسخ
list\-commands حذف می‌کند
T}
.TE
.SS پارامترهای سراسری
.sp
پارامترهای سراسری عبارتند از:
.INDENT 0.0
.IP \(bu 2
\fBassign\-role\-method\fP: نام روشی که برای تخصیص نقش استفاده می‌شود. این پارامتر اجباری است.
.IP \(bu 2
\fBapi\-files\fP: مسیر دایرکتوری‌ای که فایل‌های API توصیف‌کننده دستورها در آن یافت می‌شوند. این پارامتر اجباری است.
.IP \(bu 2
\fBrequire\-tls\fP: تعیین اینکه آیا درخواست‌های دریافت‌شده از طریق HTTP (در مقایسه با HTTPS) رد شوند یا خیر. مقدار پیش‌فرض آن زمانی که روش تخصیص نقش مبتنی بر گواهی‌ها نباشد، \fBfalse\fP است.
.IP \(bu 2
\fBcommands\fP: فهرست پیکربندی‌های دستورهای اضافی.
.IP \(bu 2
\fBaccess\-control\-lists\fP: تعاریف فهرست‌های کنترل دسترسی نام‌گذاری‌شده (هر تعریف یک نگاشت تک‌مدخلی است؛ نام مدخل، نام فهرست دسترسی و مقدار آن، مشخصات مربوطه است). این نام در بخش‌های دیگر پیکربندی، مانند \(dqaccept\-commands\(dq استفاده می‌شود.
.IP \(bu 2
\fBroles\fP: پیکربندی‌های نقش.
.IP \(bu 2
\fBdefault\-role\fP: پیکربندی نقش پیش‌فرض (زمانی استفاده می‌شود که \(dq\(dq تخصیص یافته باشد).
.IP \(bu 2
\fBunknown\-role\fP: پیکربندی نقش ناشناخته (زمانی استفاده می‌شود که نقش تخصیص‌یافتهٔ غیرخالی هیچ پیکربندی‌ای نداشته باشد).
.UNINDENT.SS "پیکربندی‌های نمونه (Sample Configurations)"
.sp
پیکربندی‌های نمونه در kea4/hooks\-rbac.json \%<#\:config-example-kea4-hooks-rbac-json>
و kea6/hooks\-rbac.json \%<#\:config-example-kea6-hooks-rbac-json>\& موجود هستند.
.SS "الگوریتم پذیرش/رد (Accept/Reject Algorithm)"
.sp
این شبه‌کدِ الگوریتم تصمیم‌گیری پذیرش/رد است که مقدار
\fBtrue\fP (پذیرش) یا \fBfalse\fP (رد) را برمی‌گرداند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
bool match(command) {
    if (list\-match\-first == accept) {
        if (accept_list && accept_list\->match(command)) {
            return (true);
        }
        if (reject_list && reject_list\->match(command)) {
            return (false);
        }
    } else {
        if (reject_list && reject_list\->match(command)) {
            return (false);
        }
        if (accept_list && accept_list\->match(command)) {
            return (true);
        }
    }
    if (others == reject) {
       return (false);
    } else {
       return (true);
    }
}
.EE
.UNINDENT
.UNINDENT
.SS "دستورات هوک سفارشی و بازتعریف دستور (Custom Hook Commands and Command Redefinition)"
.sp
امکان داشتن یک هوک سفارشی همراه با دستورات جدید وجود دارد. در این حالت،
می‌توان از کنترل دسترسی بر پایه نقش (Role Based Access Control) به دو روش برای مدیریت دستور جدید استفاده کرد.
.sp
پارامتر سراسری \fBcommand\fP می‌تواند برای تعریف نام، نوع دسترسی
و نام هوک آن به کار رود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
\(dqcommands\(dq: [
        {
            \(dqname\(dq: \(dqmy\-new\-command\(dq,
            \(dqaccess\(dq: \(dqwrite\(dq,
            \(dqhook\(dq: \(dqmy\-custom\-hook\(dq
        }
    ],
\&...
}
.EE
.UNINDENT
.UNINDENT
.sp
سپس دستور جدید می‌تواند در \fBroles\fP مشخص شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
\(dqroles\(dq: [
    {
        \(dqname\(dq: \(dquser1\(dq,
        \(dqaccept\-commands\(dq: {
            \(dqcommands\(dq: [ \(dqmy\-new\-command\(dq ] },
        \(dqreject\-commands\(dq: \(dqWRITE\(dq,
        \(dqlist\-match\-first\(dq: \(dqaccept\(dq
    },
    {
        \(dqname\(dq: \(dquser2\(dq,
        \(dqaccept\-commands\(dq: { \(dqhook\(dq: \(dqmy\-custom\-hook\(dq },
        \(dqreject\-commands\(dq: \(dqALL\(dq,
        \(dqlist\-match\-first\(dq: \(dqaccept\(dq
    }
],
\&...
}
.EE
.UNINDENT
.UNINDENT
.sp
روش دوم، ایجاد یک فایل سفارشی در \fB\&.../share/kea/api\fP و تعریف
نوع دسترسی دستور(های) سفارشی است.
.sp
همچنین امکان بازتعریف یک دستور موجود با حذف فایل تعریف آن
از \fB\&.../share/kea/api\fP و تعریف آن در پارامتر سراسری \fBcommands\fP وجود دارد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
\(dqcommands\(dq: [
        {
            \(dqname\(dq: \(dqdhcp\-disable\(dq,
            \(dqaccess\(dq: \(dqread\(dq,
            \(dqhook\(dq: \(dqmy\-custom\-hook\-3\(dq
        }
    ]
}
.EE
.UNINDENT
.UNINDENT
.sp
با این رویکرد، مدیر سیستم می‌تواند پیکربندی‌های تمام دستورهای موجود
را در فایل پیکربندی سرور قرار دهد.
.SS "مثال جامع (Extensive Example)"
.sp
در اینجا مثالی جامع برای نقشی آورده شده است که همهٔ دستورهای خواندن را،
به استثنای \fBconfig\-get\fP \%<#\:std-isccmd-config-get> می‌پذیرد (برای نمونه، جهت پنهان‌سازی گذرواژه‌ها). برای هر کاربر
راه‌دور که به عنوان \(dquser1\(dq شناخته نشده باشد، تمام دستورها باید رد شوند.
.sp
گزینهٔ نخست، قرار دادن دستورهای مجاز در فهرست \(dqaccept\-commands\(dq
و رد کردن هر چیز دیگری است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
\(dqroles\(dq: [
{
    \(dqname\(dq: \(dquser1\(dq,
    \(dqaccept\-commands\(dq:
    {
        \(dqand\(dq: [
            \(dqREAD\(dq,
            { \(dqnot\(dq:
                { \(dqcommands\(dq: [ \(dqconfig\-get\(dq ] }
            }
        ]
    },
    \(dqreject\-commands\(dq: \(dqALL\(dq,
    // This is the default but as the config relies on it
    // it is explicitly set.
    \(dqlist\-match\-first\(dq: \(dqaccept\(dq
},
\&...
],
\&...
}
.EE
.UNINDENT
.UNINDENT
.sp
یک جایگزین رایج، تنظیم نکردن فهرست \(dqreject\-commands\(dq است، یعنی
خالی گذاشتن آن و تکیه بر \(dqother\-commands\(dq برای رد کردن هر چیز دیگر.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
\(dqroles\(dq: [
{
    \(dqname\(dq: \(dquser2\(dq,
    \(dqaccept\-commands\(dq:
    {
        \(dqand\(dq: [
            \(dqREAD\(dq,
            { \(dqnot\(dq:
                { \(dqcommands\(dq: [ \(dqconfig\-get\(dq ] }
            }
        ]
    },
    // This is the default but as the config relies on it
    // it is explicitly set.
    \(dqother\-commands\(dq: \(dqreject\(dq
},
\&...
],
\&...
}
.EE
.UNINDENT
.UNINDENT
.sp
همچنین می‌توان عکس آن را انجام داد، یعنی تنها فهرست \(dqreject\-commands\(dq تنظیم شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
\(dqroles\(dq: [
{
    \(dqname\(dq: \(dquser3\(dq,
    \(dqreject\-commands\(dq:
    {
        \(dqor\(dq: [
            \(dqWRITE\(dq,
            { \(dqcommands\(dq: [ \(dqconfig\-get\(dq ] }
        ]
    },
    \(dqother\-commands\(dq: \(dqaccept\(dq
},
\&...
],
\&...
}
.EE
.UNINDENT
.UNINDENT
.sp
یا از هر دو فهرست استفاده شود به گونه‌ای که استثنا در فهرست \(dqreject\-commands\(dq قرار گیرد؛
این فهرست باید ابتدا بررسی شود زیرا \(dqconfig\-get\(dq دارای حق دسترسی خواندن (read\-access) است.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
\(dqroles\(dq: [
{
    \(dqname\(dq: \(dquser4\(dq,
    \(dqaccept\-commands\(dq: \(dqREAD\(dq,
    \(dqreject\-commands\(dq: { \(dqcommands\(dq: [ \(dqconfig\-get\(dq ] },
    \(dqlist\-match\-first\(dq: \(dqreject\(dq
},
\&...
],
\&...
}
.EE
.UNINDENT
.UNINDENT
.sp
برای بررسی هر پیکربندی، ایدهٔ خوبی است که از فیلتر پاسخ \(dqlist\-commands\(dq
استفاده شود که خطاهایی مانند دستورهای مفقود (رد شده)
و دستورهای اضافی (پذیرفته شده) را نشان می‌دهد.
.sp
می‌توان از \fBaccess\-control\-lists\fP برای تعریف فهرست‌های کنترل دسترسی
و سپس استفادهٔ مجدد در \fBroles\fP بهره برد:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
\(dqaccess\-control\-lists\(dq:[
    {
        \(dqmy\-list\-one\(dq:{
            \(dqor\(dq:[
            {
                \(dqhook\(dq: \(dqsubnet_cmds\(dq
            },
            {
                \(dqcommands\(dq:[ \(dqlist\-commands\(dq ]
            }
            ]
        }
    },
    {
        \(dqmy\-list\-two\(dq:{
            \(dqand\(dq:[
            \(dqREAD\(dq,
            {
                \(dqnot\(dq:{
                    \(dqcommands\(dq:[ \(dqconfig\-get\(dq ]
                }
            }
            ]
        }
    },
    {
        \(dqmy\-list\-three\(dq:{
            \(dqor\(dq:[
            { \(dqhook\(dq:\(dqsubnet_cmds\(dq },
            { \(dqhook\(dq:\(dqclass_cmds\(dq },
            { \(dqhook\(dq:\(dqlease_cmds\(dq }
            ]
        }
    }
],
\(dqroles\(dq:[
    {
        \(dqname\(dq:\(dqadmin\(dq,
        \(dqaccept\-commands\(dq:\(dqmy\-list\-one\(dq,
        \(dqreject\-commands\(dq:\(dqALL\(dq,
        \(dqlist\-match\-first\(dq:\(dqaccept\(dq
    },
    {
        \(dqname\(dq:\(dqadmin2\(dq,
        \(dqaccept\-commands\(dq:\(dqmy\-list\-two\(dq,
        \(dqreject\-commands\(dq:\(dqALL\(dq,
        \(dqlist\-match\-first\(dq:\(dqaccept\(dq
    }
],
\(dqunknown\-role\(dq:{
    \(dqaccept\-commands\(dq:\(dqmy\-list\-three\(dq,
    \(dqreject\-commands\(dq:\(dqALL\(dq
},
\&...
}
.EE
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT.SS \fBlibdhcp_run_script.so\fP: پشتیبانی اجرای اسکریپت برای اسکریپت‌های قلاب خارجی
.sp
کتابخانه قلاب Run Script، پشتیبانی از فراخوانی یک اسکریپت خارجی را برای نقاط قلاب (hook points) خاص در پردازش بسته‌ها اضافه می‌کند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
\fBlibdhcp_run_script.so\fP بخشی از کد منبع‌باز است و برای هر کاربر Kea در دسترس است.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این کتابخانه تنها می‌تواند توسط فرآیند \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> یا
\fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> بارگذاری شود.
.UNINDENT
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqhooks\-libraries\(dq: [
        {
            \(dqlibrary\(dq: \(dqlibdhcp_run_script.so\(dq,
            \(dqparameters\(dq: {
                \(dqname\(dq: \(dq/full_path_to/script_name.sh\(dq,
                \(dqsync\(dq: false
            }
        }
    ]
}
.EE
.UNINDENT
.UNINDENT
.sp
پارامترها شامل \fBname\fP هستند که مسیر کامل اسکریپت خارجی را برای فراخوانی در هر نقطه قلاب مشخص می‌کند، و همچنین گزینه \fBsync\fP، تا بتوان به‌طور همگام (synchronous) برای اتمام اجرای اسکریپت منتظر ماند.
اگر پارامتر \fBsync\fP برابر با \fBfalse\fP باشد، اسکریپت راه‌اندازی شده و Kea منتظر پایان اجرای آن نخواهد ماند، که باعث می‌شود تمام پارامترهای خروجی (OUT) اسکریپت (از جمله گام بعدی) نادیده گرفته شوند.
.sp
اسکریپت خارجی باید در دایرکتوری \fB\(dq[kea\-install\-dir]/share/kea/scripts/\(dq\fP
ذخیره شود که می‌توان آن را هنگام راه‌اندازی با تنظیم متغیر محیطی
\fBKEA_HOOK_SCRIPTS_PATH\fP به یک مسیر دیگر بازنویسی کرد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
اسکریپت تمام امتیازات و دسترسی‌ها را از سروری که آن را فراخوانی می‌کند به ارث می‌برد.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
در حال حاضر، فعال‌سازی فراخوانی‌های همگام به اسکریپت‌های خارجی پشتیبانی نمی‌شود.
.UNINDENT
.UNINDENT
.sp
این کتابخانه توابع نقطه قلاب متعددی را پیاده‌سازی کرده است که در مرحله خاصی از پردازش بسته فراخوانی می‌شوند.
.sp
نقاط قلاب dhcpv4:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
lease4_renew
lease4_expire
lease4_recover
leases4_committed
lease4_release
lease4_decline
.EE
.UNINDENT
.UNINDENT
.sp
نقاط قلاب dhcpv6:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
lease6_renew
lease6_rebind
lease6_expire
lease6_recover
leases6_committed
lease6_release
lease6_decline
addr6_register
.EE
.UNINDENT
.UNINDENT
.sp
هر نقطه قلاب داده‌های داخلی Kea را استخراج کرده و آن‌ها را به‌صورت متغیرهای محیطی رشته‌ای صادر (export) می‌کند. این پارامترها با استفاده از محیط فرآیند فرزند با اسکریپت مقصد به اشتراک گذاشته می‌شوند.
تنها پارامتری که به فراخوانی اسکریپت مقصد ارسال می‌شود، نام نقطه قلاب است.
.sp
نمونه‌ای از یک اسکریپت که تمامی نقاط قلاب را پیاده‌سازی می‌کند در زیر ارائه شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
#!/bin/sh

unknown_handle() {
    echo \(dqUnhandled function call ${*}\(dq
    exit 123
}


lease4_renew () {
    ...
}

lease4_expire () {
    ...
}

lease4_recover () {
    ...
}

leases4_committed () {
    ...
}

lease4_release () {
    ...
}

lease4_decline () {
    ...
}

lease6_renew () {
    ...
}

lease6_rebind () {
    ...
}

lease6_expire () {
    ...
}

lease6_recover () {
    ...
}

leases6_committed () {
    ...
}

lease6_release () {
    ...
}

lease6_decline () {
    ...
}

addr6_register () {
    ...
}

case \(dq$1\(dq in
    \(dqlease4_renew\(dq)
        lease4_renew
        ;;
    \(dqlease4_expire\(dq)
        lease4_expire
        ;;
    \(dqlease4_recover\(dq)
        lease4_recover
        ;;
    \(dqleases4_committed\(dq)
        leases4_committed
        ;;
    \(dqlease4_release\(dq)
        lease4_release
        ;;
    \(dqlease4_decline\(dq)
        lease4_decline
        ;;
    \(dqlease6_renew\(dq)
        lease6_renew
        ;;
    \(dqlease6_rebind\(dq)
        lease6_rebind
        ;;
    \(dqlease6_expire\(dq)
        lease6_expire
        ;;
    \(dqlease6_recover\(dq)
        lease6_recover
        ;;
    \(dqleases6_committed\(dq)
        leases6_committed
        ;;
    \(dqlease6_release\(dq)
        lease6_release
        ;;
    \(dqlease6_decline\(dq)
        lease6_decline
        ;;
    \(dqaddr6_register\(dq)
        addr6_register
        ;;
    *)
        unknown_handle \(dq${@}\(dq
        ;;
esac
.EE
.UNINDENT
.UNINDENT
.sp
پارامترهای موجود برای هر نقطه قلاب در زیر ارائه شده است.
.sp
DHCPv4:
.sp
\fBlease4_renew\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
QUERY4_TYPE
QUERY4_TXID
QUERY4_LOCAL_ADDR
QUERY4_LOCAL_PORT
QUERY4_REMOTE_ADDR
QUERY4_REMOTE_PORT
QUERY4_IFACE_INDEX
QUERY4_IFACE_NAME
QUERY4_HOPS
QUERY4_SECS
QUERY4_FLAGS
QUERY4_CIADDR
QUERY4_SIADDR
QUERY4_YIADDR
QUERY4_GIADDR
QUERY4_RELAYED
QUERY4_HWADDR
QUERY4_HWADDR_TYPE
QUERY4_LOCAL_HWADDR
QUERY4_LOCAL_HWADDR_TYPE
QUERY4_REMOTE_HWADDR
QUERY4_REMOTE_HWADDR_TYPE
QUERY4_OPTION_82
QUERY4_OPTION_82_SUB_OPTION_1
QUERY4_OPTION_82_SUB_OPTION_2
SUBNET4_ID
SUBNET4_NAME
SUBNET4_PREFIX
SUBNET4_PREFIX_LEN
PKT4_CLIENT_ID
PKT4_HWADDR
PKT4_HWADDR_TYPE
LEASE4_ADDRESS
LEASE4_CLTT
LEASE4_HOSTNAME
LEASE4_HWADDR
LEASE4_HWADDR_TYPE
LEASE4_STATE
LEASE4_SUBNET_ID
LEASE4_VALID_LIFETIME
LEASE4_CLIENT_ID
.EE
.UNINDENT
.UNINDENT
.sp
\fBlease4_expire\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
LEASE4_ADDRESS
LEASE4_CLTT
LEASE4_HOSTNAME
LEASE4_HWADDR
LEASE4_HWADDR_TYPE
LEASE4_STATE
LEASE4_SUBNET_ID
LEASE4_VALID_LIFETIME
LEASE4_CLIENT_ID
REMOVE_LEASE
.EE
.UNINDENT
.UNINDENT
.sp
\fBlease4_recover\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
LEASE4_ADDRESS
LEASE4_CLTT
LEASE4_HOSTNAME
LEASE4_HWADDR
LEASE4_HWADDR_TYPE
LEASE4_STATE
LEASE4_SUBNET_ID
LEASE4_VALID_LIFETIME
LEASE4_CLIENT_ID
.EE
.UNINDENT
.UNINDENT
.sp
\fBleases4_committed\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
QUERY4_TYPE
QUERY4_TXID
QUERY4_LOCAL_ADDR
QUERY4_LOCAL_PORT
QUERY4_REMOTE_ADDR
QUERY4_REMOTE_PORT
QUERY4_IFACE_INDEX
QUERY4_IFACE_NAME
QUERY4_HOPS
QUERY4_SECS
QUERY4_FLAGS
QUERY4_CIADDR
QUERY4_SIADDR
QUERY4_YIADDR
QUERY4_GIADDR
QUERY4_RELAYED
QUERY4_HWADDR
QUERY4_HWADDR_TYPE
QUERY4_LOCAL_HWADDR
QUERY4_LOCAL_HWADDR_TYPE
QUERY4_REMOTE_HWADDR
QUERY4_REMOTE_HWADDR_TYPE
QUERY4_OPTION_82
QUERY4_OPTION_82_SUB_OPTION_1
QUERY4_OPTION_82_SUB_OPTION_2
LEASES4_SIZE
DELETED_LEASES4_SIZE
.EE
.UNINDENT
.UNINDENT
.sp
اگر \fBLEASES4_SIZE\fP یا \fBDELETED_LEASES4_SIZE\fP غیر صفر باشد، آنگاه هر اجاره (lease)
دارای شناسه یکتای خود خواهد بود، همان‌طور که در زیر نشان داده شده است. اولین نمایه از ۰ آغاز می‌شود.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
LEASES4_AT0_ADDRESS
LEASES4_AT0_CLTT
LEASES4_AT0_HOSTNAME
LEASES4_AT0_HWADDR
LEASES4_AT0_HWADDR_TYPE
LEASES4_AT0_STATE
LEASES4_AT0_SUBNET_ID
LEASES4_AT0_VALID_LIFETIME
LEASES4_AT0_CLIENT_ID
DELETED_LEASES4_AT0_ADDRESS
DELETED_LEASES4_AT0_CLTT
DELETED_LEASES4_AT0_HOSTNAME
DELETED_LEASES4_AT0_HWADDR
DELETED_LEASES4_AT0_HWADDR_TYPE
DELETED_LEASES4_AT0_STATE
DELETED_LEASES4_AT0_SUBNET_ID
DELETED_LEASES4_AT0_VALID_LIFETIME
DELETED_LEASES4_AT0_CLIENT_ID
.EE
.UNINDENT
.UNINDENT
.sp
\fBlease4_release\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
QUERY4_TYPE
QUERY4_TXID
QUERY4_LOCAL_ADDR
QUERY4_LOCAL_PORT
QUERY4_REMOTE_ADDR
QUERY4_REMOTE_PORT
QUERY4_IFACE_INDEX
QUERY4_IFACE_NAME
QUERY4_HOPS
QUERY4_SECS
QUERY4_FLAGS
QUERY4_CIADDR
QUERY4_SIADDR
QUERY4_YIADDR
QUERY4_GIADDR
QUERY4_RELAYED
QUERY4_HWADDR
QUERY4_HWADDR_TYPE
QUERY4_LOCAL_HWADDR
QUERY4_LOCAL_HWADDR_TYPE
QUERY4_REMOTE_HWADDR
QUERY4_REMOTE_HWADDR_TYPE
QUERY4_OPTION_82
QUERY4_OPTION_82_SUB_OPTION_1
QUERY4_OPTION_82_SUB_OPTION_2
LEASE4_ADDRESS
LEASE4_CLTT
LEASE4_HOSTNAME
LEASE4_HWADDR
LEASE4_HWADDR_TYPE
LEASE4_STATE
LEASE4_SUBNET_ID
LEASE4_VALID_LIFETIME
LEASE4_CLIENT_ID
.EE
.UNINDENT
.UNINDENT
.sp
\fBlease4_decline\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
QUERY4_TYPE
QUERY4_TXID
QUERY4_LOCAL_ADDR
QUERY4_LOCAL_PORT
QUERY4_REMOTE_ADDR
QUERY4_REMOTE_PORT
QUERY4_IFACE_INDEX
QUERY4_IFACE_NAME
QUERY4_HOPS
QUERY4_SECS
QUERY4_FLAGS
QUERY4_CIADDR
QUERY4_SIADDR
QUERY4_YIADDR
QUERY4_GIADDR
QUERY4_RELAYED
QUERY4_HWADDR
QUERY4_HWADDR_TYPE
QUERY4_LOCAL_HWADDR
QUERY4_LOCAL_HWADDR_TYPE
QUERY4_REMOTE_HWADDR
QUERY4_REMOTE_HWADDR_TYPE
QUERY4_OPTION_82
QUERY4_OPTION_82_SUB_OPTION_1
QUERY4_OPTION_82_SUB_OPTION_2
LEASE4_ADDRESS
LEASE4_CLTT
LEASE4_HOSTNAME
LEASE4_HWADDR
LEASE4_HWADDR_TYPE
LEASE4_STATE
LEASE4_SUBNET_ID
LEASE4_VALID_LIFETIME
LEASE4_CLIENT_ID
.EE
.UNINDENT
.UNINDENT
.sp
DHCPv6:
.sp
\fBlease6_renew\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
QUERY6_TYPE
QUERY6_TXID
QUERY6_LOCAL_ADDR
QUERY6_LOCAL_PORT
QUERY6_REMOTE_ADDR
QUERY6_REMOTE_PORT
QUERY6_IFACE_INDEX
QUERY6_IFACE_NAME
QUERY6_REMOTE_HWADDR
QUERY6_REMOTE_HWADDR_TYPE
QUERY6_PROTO
QUERY6_CLIENT_ID
LEASE6_ADDRESS
LEASE6_CLTT
LEASE6_HOSTNAME
LEASE6_HWADDR
LEASE6_HWADDR_TYPE
LEASE6_STATE
LEASE6_SUBNET_ID
LEASE6_VALID_LIFETIME
LEASE6_DUID
LEASE6_IAID
LEASE6_PREFERRED_LIFETIME
LEASE6_PREFIX_LEN
LEASE6_TYPE
PKT6_IA_IAID
PKT6_IA_IA_TYPE
PKT6_IA_IA_T1
PKT6_IA_IA_T2
.EE
.UNINDENT
.UNINDENT
.sp
\fBlease6_rebind\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
QUERY6_TYPE
QUERY6_TXID
QUERY6_LOCAL_ADDR
QUERY6_LOCAL_PORT
QUERY6_REMOTE_ADDR
QUERY6_REMOTE_PORT
QUERY6_IFACE_INDEX
QUERY6_IFACE_NAME
QUERY6_REMOTE_HWADDR
QUERY6_REMOTE_HWADDR_TYPE
QUERY6_PROTO
QUERY6_CLIENT_ID
LEASE6_ADDRESS
LEASE6_CLTT
LEASE6_HOSTNAME
LEASE6_HWADDR
LEASE6_HWADDR_TYPE
LEASE6_STATE
LEASE6_SUBNET_ID
LEASE6_VALID_LIFETIME
LEASE6_DUID
LEASE6_IAID
LEASE6_PREFERRED_LIFETIME
LEASE6_PREFIX_LEN
LEASE6_TYPE
PKT6_IA_IAID
PKT6_IA_IA_TYPE
PKT6_IA_IA_T1
PKT6_IA_IA_T2
.EE
.UNINDENT
.UNINDENT
.sp
\fBlease6_expire\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
LEASE6_ADDRESS
LEASE6_CLTT
LEASE6_HOSTNAME
LEASE6_HWADDR
LEASE6_HWADDR_TYPE
LEASE6_STATE
LEASE6_SUBNET_ID
LEASE6_VALID_LIFETIME
LEASE6_DUID
LEASE6_IAID
LEASE6_PREFERRED_LIFETIME
LEASE6_PREFIX_LEN
LEASE6_TYPE
REMOVE_LEASE
.EE
.UNINDENT
.UNINDENT
.sp
\fBlease6_recover\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
LEASE6_ADDRESS
LEASE6_CLTT
LEASE6_HOSTNAME
LEASE6_HWADDR
LEASE6_HWADDR_TYPE
LEASE6_STATE
LEASE6_SUBNET_ID
LEASE6_VALID_LIFETIME
LEASE6_DUID
LEASE6_IAID
LEASE6_PREFERRED_LIFETIME
LEASE6_PREFIX_LEN
LEASE6_TYPE
.EE
.UNINDENT
.UNINDENT
.sp
\fBleases6_committed\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
QUERY6_TYPE
QUERY6_TXID
QUERY6_LOCAL_ADDR
QUERY6_LOCAL_PORT
QUERY6_REMOTE_ADDR
QUERY6_REMOTE_PORT
QUERY6_IFACE_INDEX
QUERY6_IFACE_NAME
QUERY6_REMOTE_HWADDR
QUERY6_REMOTE_HWADDR_TYPE
QUERY6_PROTO
QUERY6_CLIENT_ID
LEASES6_SIZE
DELETED_LEASES6_SIZE
.EE
.UNINDENT
.UNINDENT
.sp
اگر \fBLEASES6_SIZE\fP یا \fBDELETED_LEASES6_SIZE\fP غیر صفر باشد، آنگاه هر اجاره
دارای شناسه یکتای خود خواهد بود، همان‌طور که در زیر نشان داده شده است. اولین نمایه از ۰ آغاز می‌شود.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
LEASES6_AT0_ADDRESS
LEASES6_AT0_CLTT
LEASES6_AT0_HOSTNAME
LEASES6_AT0_HWADDR
LEASES6_AT0_HWADDR_TYPE
LEASES6_AT0_STATE
LEASES6_AT0_SUBNET_ID
LEASES6_AT0_VALID_LIFETIME
LEASES6_AT0_DUID
LEASES6_AT0_IAID
LEASES6_AT0_PREFERRED_LIFETIME
LEASES6_AT0_PREFIX_LEN
LEASES6_AT0_TYPE
DELETED_LEASES6_AT0_ADDRESS
DELETED_LEASES6_AT0_CLTT
DELETED_LEASES6_AT0_HOSTNAME
DELETED_LEASES6_AT0_HWADDR
DELETED_LEASES6_AT0_HWADDR_TYPE
DELETED_LEASES6_AT0_STATE
DELETED_LEASES6_AT0_SUBNET_ID
DELETED_LEASES6_AT0_VALID_LIFETIME
DELETED_LEASES6_AT0_DUID
DELETED_LEASES6_AT0_IAID
DELETED_LEASES6_AT0_PREFERRED_LIFETIME
DELETED_LEASES6_AT0_PREFIX_LEN
DELETED_LEASES6_AT0_TYPE
.EE
.UNINDENT
.UNINDENT
.sp
\fBlease6_release\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
QUERY6_TYPE
QUERY6_TXID
QUERY6_LOCAL_ADDR
QUERY6_LOCAL_PORT
QUERY6_REMOTE_ADDR
QUERY6_REMOTE_PORT
QUERY6_IFACE_INDEX
QUERY6_IFACE_NAME
QUERY6_REMOTE_HWADDR
QUERY6_REMOTE_HWADDR_TYPE
QUERY6_PROTO
QUERY6_CLIENT_ID
LEASE6_ADDRESS
LEASE6_CLTT
LEASE6_HOSTNAME
LEASE6_HWADDR
LEASE6_HWADDR_TYPE
LEASE6_STATE
LEASE6_SUBNET_ID
LEASE6_VALID_LIFETIME
LEASE6_DUID
LEASE6_IAID
LEASE6_PREFERRED_LIFETIME
LEASE6_PREFIX_LEN
LEASE6_TYPE
.EE
.UNINDENT
.UNINDENT
.sp
\fBlease6_decline\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
QUERY6_TYPE
QUERY6_TXID
QUERY6_LOCAL_ADDR
QUERY6_LOCAL_PORT
QUERY6_REMOTE_ADDR
QUERY6_REMOTE_PORT
QUERY6_IFACE_INDEX
QUERY6_IFACE_NAME
QUERY6_REMOTE_HWADDR
QUERY6_REMOTE_HWADDR_TYPE
QUERY6_PROTO
QUERY6_CLIENT_ID
LEASE6_ADDRESS
LEASE6_CLTT
LEASE6_HOSTNAME
LEASE6_HWADDR
LEASE6_HWADDR_TYPE
LEASE6_STATE
LEASE6_SUBNET_ID
LEASE6_VALID_LIFETIME
LEASE6_DUID
LEASE6_IAID
LEASE6_PREFERRED_LIFETIME
LEASE6_PREFIX_LEN
LEASE6_TYPE
.EE
.UNINDENT
.UNINDENT
.sp
\fBaddr6_register\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
QUERY6_TYPE
QUERY6_TXID
QUERY6_LOCAL_ADDR
QUERY6_LOCAL_PORT
QUERY6_REMOTE_ADDR
QUERY6_REMOTE_PORT
QUERY6_IFACE_INDEX
QUERY6_IFACE_NAME
QUERY6_REMOTE_HWADDR
QUERY6_REMOTE_HWADDR_TYPE
QUERY6_PROTO
QUERY6_CLIENT_ID
ADDRESS6
OLD_LEASE6_ADDRESS
OLD_LEASE6_CLTT
OLD_LEASE6_HOSTNAME
OLD_LEASE6_HWADDR
OLD_LEASE6_HWADDR_TYPE
OLD_LEASE6_STATE
OLD_LEASE6_SUBNET_ID
OLD_LEASE6_VALID_LIFETIME
OLD_LEASE6_DUID
OLD_LEASE6_IAID
OLD_LEASE6_PREFERRED_LIFETIME
OLD_LEASE6_PREFIX_LEN
OLD_LEASE6_TYPE
NEW_LEASE6_ADDRESS
NEW_LEASE6_CLTT
NEW_LEASE6_HOSTNAME
NEW_LEASE6_HWADDR
NEW_LEASE6_HWADDR_TYPE
NEW_LEASE6_STATE
NEW_LEASE6_SUBNET_ID
NEW_LEASE6_VALID_LIFETIME
NEW_LEASE6_DUID
NEW_LEASE6_IAID
NEW_LEASE6_PREFERRED_LIFETIME
NEW_LEASE6_PREFIX_LEN
NEW_LEASE6_TYPE
.EE
.UNINDENT
.UNINDENT
.sp
متغیر OLD_LEASE6 همیشه وجود ندارد.
.sp
نقطه قلاب leases4_committed برای مدیریت فهرست آدرس‌ها به حلقه‌های for نیاز دارد. این کار را می‌توان به صورت زیر انجام داد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
leases4_committed() {
    for i in $(seq 0 $((LEASES4_SIZE\-1))); do
        LEASE4_ADDRESS=$(eval \(dqecho \e$LEASES4_AT${i}_ADDRESS\(dq)
        ...
    done

    for i in $(seq 0 $((DELETED_LEASES4_SIZE\-1))); do
        DELETED_LEASE4_ADDRESS=$(eval \(dqecho \e$DELETED_LEASES4_AT${i}_ADDRESS\(dq)
        ...
    done
    exit 0
}
.EE
.UNINDENT
.UNINDENT
.sp
نقطه قلاب leases6_committed برای مدیریت فهرست آدرس‌ها به حلقه‌های for نیاز دارد. این کار را می‌توان به صورت زیر انجام داد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
leases6_committed() {
    for i in $(seq 0 $((LEASES6_SIZE\-1))); do
        LEASE6_ADDRESS=$(eval \(dqecho \e$LEASES6_AT${i}_ADDRESS\(dq)
        ...
    done

    for i in $(seq 0 $((DELETED_LEASES6_SIZE\-1))); do
        DELETED_LEASE6_ADDRESS=$(eval \(dqecho \e$DELETED_LEASES6_AT${i}_ADDRESS\(dq)
        ...
    done
    exit 0
}
.EE
.UNINDENT
.UNINDENT.SS \fBlibdhcp_stat_cmds.so\fP: دستورات آماری برای آمار تکمیلی اجاره‌ها
.sp
این کتابخانه دستورات بیشتری را برای واکشی آمار اجاره‌ها (leases) از کارسازهای Kea DHCP فراهم می‌کند. این دستورات برای برطرف کردن مشکلی در به‌دست آوردن آمار دقیق اجاره‌ها در استقرارهایی با چندین کارساز Kea که از یک پس‌بند (backend) اجاره مشترک استفاده می‌کنند، اضافه شده‌اند. آمار درون حافظه‌ای (in\-memory) نگهداری‌شده توسط هر یک از کارسازها تنها تغییرات اجاره انجام‌شده توسط همان کارساز را ردیابی می‌کند؛ بنابراین، در استقراری با چندین کارساز (برای مثال دو کارساز \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> که از یک پایگاه‌داده PostgreSQL یکسان برای ذخیره‌سازی اجاره‌ها استفاده می‌کنند)، این آمار ناقص هستند. پس‌بندهای MySQL و PostgreSQL در Kea تغییرات تخصیص اجاره را به محض وقوع از طریق تریگرهای پایگاه‌داده ردیابی می‌کنند. علاوه بر این، تمام پس‌بندهای اجاره برای پشتیبانی از واکشی آمار اجاره‌ها برای یک زیرشبکه، بازه‌ای از زیرشبکه‌ها یا تمام زیرشبکه‌ها توسعه یافته‌اند. در نهایت، این کتابخانه دستوراتی را برای واکشی این آمار ارائه می‌دهد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
کتابخانه \fBlibdhcp_stat_cmds.so\fP بخشی از کد منبع‌باز است و برای تمام کاربران Kea در دسترس است.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این کتابخانه تنها می‌تواند توسط فرایند \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> یا \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> بارگذاری شود.
.UNINDENT
.UNINDENT
.sp
دستورات ارائه‌شده توسط این کتابخانه عبارتند از:
.INDENT 0.0
.IP \(bu 2
\fBstat\-lease4\-get\fP \- آمار اجاره‌های DHCPv4 را واکشی می‌کند.
.IP \(bu 2
\fBstat\-lease6\-get\fP \- آمار اجاره‌های DHCPv6 را واکشی می‌کند.
.UNINDENT
.sp
کتابخانه دستورات آماری (Statistics Commands) بخشی از کد منبع‌باز است و برای تمام کاربران Kea در دسترس است.
.sp
تمام دستورات از ساختار JSON استفاده می‌کنند و می‌توانند مستقیماً از طریق کانال کنترل (بخش Management API \%<#\:ctrl-channel> را ببینید) به کارسازها ارسال شوند.
.sp
این کتابخانه همانند سایر کتابخانه‌ها بارگذاری می‌شود و در حال حاضر هیچ پارامتری ندارد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqDhcp6\(dq: {
    \(dqhooks\-libraries\(dq: [
        {
            \(dqlibrary\(dq: \(dqlibdhcp_stat_cmds.so\(dq
        },
        ...
    ]
}
.EE
.UNINDENT
.UNINDENT
.sp
در استقراری با چندین کارساز Kea DHCP که یک فضای ذخیره‌سازی مشترک اجاره را به اشتراک می‌گذارند، این کتابخانه قلاب (hook library) می‌تواند توسط یک یا تمام کارسازها بارگذاری شود. با این حال، پاسخ یک کارساز به دستور \fBstat\-lease4\-get\fP / \fBstat\-lease6\-get\fP تنها شامل داده‌های مربوط به زیرشبکه‌های شناخته‌شده برای آن کارساز خواهد بود. به عبارت دیگر، اگر زیرشبکه‌ای در پیکربندی کارساز وجود نداشته باشد، Kea آماری برای آن واکشی نخواهد کرد.
.SS دستورات \fBstat\-lease4\-get\fP و \fBstat\-lease6\-get\fP
.sp
دستورات \fBstat\-lease4\-get\fP و \fBstat\-lease6\-get\fP آمار اجاره را برای بازه‌ای از زیرشبکه‌های شناخته‌شده واکشی می‌کنند. بازه زیرشبکه‌ها از طریق استفاده از پارامترهای اختیاری ورودی دستور مشخص می‌شود:
.INDENT 0.0
.IP \(bu 2
\fBsubnet\-id\fP \- شناسه زیرشبکه‌ای که آمار اجاره برای آن باید واکشی شود؛ برای دریافت آمار یک زیرشبکه تکی به کار می‌رود. اگر زیرشبکه وجود نداشته باشد، کد نتیجه دستور ۳ خواهد بود (یعنی \fBCONTROL_RESULT_EMPTY\fP).
.IP \(bu 2
\fBsubnet\-range\fP \- جفتی از شناسه‌های زیرشبکه که بازه فراگیری (شامل هر دو سر بازه) از زیرشبکه‌ها را که آمار برای آن‌ها باید واکشی شود توصیف می‌کند. این بازه ممکن است شامل یک یا چند شناسه باشد که با هیچ زیرشبکه‌ای مطابقت ندارند؛ در این حالت، دستور تنها آمار اجاره را برای آن‌هایی که وجود دارند در خروجی می‌آورد. با این حال، اگر بازه شامل هیچ زیرشبکه شناخته‌شده‌ای نباشد، کد نتیجه دستور ۳ خواهد بود (یعنی \fBCONTROL_RESULT_EMPTY\fP).
.INDENT 2.0
.IP \(bu 2
\fBfirst\-subnet\-id\fP \- شناسه نخستین زیرشبکه در بازه.
.IP \(bu 2
\fBlast\-subnet\-id\fP \- شناسه آخرین زیرشبکه در بازه.
.UNINDENT
.UNINDENT
.sp
استفاده از \fBsubnet\-id\fP و \fBsubnet\-range\fP مانعة‌الجمع است (نمی‌توان هم‌زمان از هر دو استفاده کرد). اگر هیچ پارامتری داده نشود، نتیجه حاوی داده‌های تمام زیرشبکه‌های شناخته‌شده خواهد بود. توجه داشته باشید که در پیکربندی‌هایی با زیرشبکه‌های متعدد، این امر می‌تواند منجر به پاسخی حجیم شود.
.sp
دستور زیر آمار اجاره را برای تمام زیرشبکه‌های شناخته‌شده از یک کارساز \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> واکشی می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqcommand\(dq: \(dqstat\-lease4\-get\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
دستور زیر آمار اجاره را برای زیرشبکه با شناسه ۱۰ از یک کارساز \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> واکشی می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqcommand\(dq: \(dqstat\-lease6\-get\(dq,
  \(dqarguments\(dq: {
    \(dqsubnet\-id\(dq : 10
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
دستور زیر آمار اجاره را برای تمام زیرشبکه‌های با شناسه‌ای در بازه ۱۰ تا ۵۰ از یک کارساز \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> واکشی می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqcommand\(dq: \(dqstat\-lease4\-get\(dq,
  \(dqarguments\(dq: {
    \(dqsubnet\-range\(dq: {
      \(dqfirst\-subnet\-id\(dq: 10,
      \(dqlast\-subnet\-id\(dq: 50
    }
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ هر یک از این دو دستور شامل سه عنصر خواهد بود:
.INDENT 0.0
.IP \(bu 2
\fBresult\fP \- یک مقدار عددی که نتیجه دستور را مشخص می‌کند به طوری که:
.INDENT 2.0
.IP \(bu 2
\fB0\fP \- دستور موفقیت‌آمیز بود؛
.IP \(bu 2
\fB1\fP \- خطایی رخ داد، و توضیح آن در عنصر \(dqtext\(dq است؛ یا
.IP \(bu 2
\fB2\fP \- واکشی هیچ داده منطبقی نیافت.
.UNINDENT
.IP \(bu 2
\fBtext\fP \- توضیحی درباره نتیجه دستور. هنگامی که دستور با موفقیت انجام شود، شامل نام دستور به همراه تعداد سطرهای بازگردانده‌شده است.
.IP \(bu 2
\fBarguments\fP \- یک نگاشت حاوی داده‌های بازگردانده‌شده توسط دستور به عنوان عنصر \(dqresult\-set\(dq، که از الگوی پاسخ‌های دستورات SQL پیروی می‌کند:
.INDENT 2.0
.IP \(bu 2
\fBcolumns\fP \- فهرستی از برچسب‌های متنی ستون‌ها.
.sp
ستون‌های بازگردانده‌شده برای DHCPv4 عبارتند از:
.INDENT 2.0
.IP \(bu 2
\fBsubnet\-id\fP \- شناسه زیرشبکه.
.IP \(bu 2
\fBtotal\-addresses\fP \- تعداد کل نشانی‌های موجود برای مدیریت DHCPv4 در زیرشبکه. به عبارت دیگر، این شمارش تمام نشانی‌ها در همه استخرهای (pools) پیکربندی‌شده در زیرشبکه است.
.IP \(bu 2
\fBcumulative\-assigned\-addresses\fP \- تعداد تجمعی نشانی‌هایی در زیرشبکه که از زمان شروع به کار کارساز توسط آن به یک کلاینت تخصیص داده شده‌اند.
.IP \(bu 2
\fBassigned\-addresses\fP \- تعداد نشانی‌هایی در زیرشبکه که در حال حاضر به یک کلاینت تخصیص داده شده‌اند.
.IP \(bu 2
\fBdeclined\-addresses\fP \- تعداد نشانی‌هایی در زیرشبکه که در حال حاضر رد شده‌اند (declined) و بنابراین برای تخصیص در دسترس نیستند.
.UNINDENT
.sp
ستون‌های بازگردانده‌شده برای DHCPv6 عبارتند از:
.INDENT 2.0
.IP \(bu 2
\fBsubnet\-id\fP \- شناسه زیرشبکه..IP \(bu 2
\fBtotal\-nas\fP \- تعداد آدرس‌های NA موجود برای مدیریت DHCPv6
در زیرشبکه. به عبارت دیگر، این تعداد کل آدرس‌های NA در تمام
استخرهای NA پیکربندی‌شده در زیرشبکه است.
.IP \(bu 2
\fBcumulative\-assigned\-nas\fP \- تعداد تجمعی آدرس‌های NA در زیرشبکه
که از زمان راه‌اندازی سرور به یک کلاینت اختصاص داده شده‌اند.
.IP \(bu 2
\fBassigned\-nas\fP \- تعداد آدرس‌های NA در زیرشبکه که در حال حاضر
به یک کلاینت اختصاص داده شده‌اند.
.IP \(bu 2
\fBdeclined\-addresses\fP \- تعداد آدرس‌های NA که در حال حاضر
رد شده‌اند (declined) و در نتیجه برای تخصیص در دسترس نیستند.
.IP \(bu 2
\fBtotal\-pds\fP \- تعداد کل پیشوندهای PD موجود برای مدیریت DHCPv6
در زیرشبکه. به عبارت دیگر، این تعداد کل پیشوندها در تمام
استخرهای پیشوند پیکربندی‌شده در زیرشبکه است.
.IP \(bu 2
\fBcumulative\-assigned\-pds\fP \- تعداد تجمعی پیشوندهای PD در زیرشبکه
که از زمان راه‌اندازی سرور به یک کلاینت اختصاص یافته‌اند.
.IP \(bu 2
\fBassigned\-pds\fP \- تعداد پیشوندهای PD در زیرشبکه که در حال حاضر
به یک کلاینت اختصاص داده شده‌اند.
.UNINDENT
.IP \(bu 2
\fBrows\fP \- فهرستی از سطرها، یک سطر به ازای هر شناسه زیرشبکه (subnet ID).
هر سطر شامل مقادیر داده‌ای متناظر با ستون‌های فهرست‌شده در
\(dqcolumns\(dq و به همان ترتیب برای یک زیرشبکه مشخص است.
.IP \(bu 2
\fBtimestamp\fP \- تاریخ و زمان متنیِ واکشی داده‌ها،
بیان‌شده بر اساس GMT.
.UNINDENT
.UNINDENT
.sp
پاسخ به یک دستور DHCPv4 ممکن است به صورت زیر باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqresult\(dq: 0,
  \(dqtext\(dq: \(dqstat\-lease4\-get: 2 rows found\(dq,
  \(dqarguments\(dq: {
    \(dqresult\-set\(dq: {
      \(dqcolumns\(dq: [ \(dqsubnet\-id\(dq, \(dqtotal\-addresses\(dq, \(dqcumulative\-assigned\-addresses\(dq, \(dqassigned\-addresses\(dq, \(dqdeclined\-addresses\(dq ],
      \(dqrows\(dq: [
        [ 10, 256, 300, 111, 0 ],
        [ 20, 4098, 2034, 2034, 4 ]
      ],
      \(dqtimestamp\(dq: \(dq2018\-05\-04 15:03:37.000000\(dq
    }
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ به یک دستور DHCPv6 با این فرض که زیرشبکه 10 هیچ استخر پیشوندی ندارد،
زیرشبکه 20 هیچ استخر NA ندارد، و زیرشبکه 30 دارای هر دو استخر NA و
PD است، ممکن است به شکل زیر باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqresult\(dq: 0,
  \(dqtext\(dq: \(dqstat\-lease6\-get: 2 rows found\(dq,
  \(dqarguments\(dq: {
    \(dqresult\-set\(dq: {
      \(dqcolumns\(dq: [ \(dqsubnet\-id\(dq, \(dqtotal\-nas\(dq, \(dqcumulative\-assigned\-nas\(dq, \(dqassigned\-nas\(dq, \(dqdeclined\-addresses\(dq, \(dqtotal\-pds\(dq, \(dqcumulative\-assigned\-pds\(dq, \(dqassigned\-pds\(dq ],
      \(dqrows\(dq: [
        [ 10, 4096, 5000, 2400, 3, 0, 0, 0],
        [ 20, 0, 0, 0, 0, 1048, 300, 233 ],
        [ 30, 256, 60, 60, 0, 1048, 15, 15 ]
      ],
      \(dqtimestamp\(dq: \(dq2018\-05\-04 15:03:37.000000\(dq
    }
  }
}
.EE
.UNINDENT
.UNINDENT
.SS \fBlibdhcp_subnet_cmds.so\fP: دستورهای زیرشبکه برای مدیریت زیرشبکه‌ها و شبکه‌های اشتراکی
.sp
این کتابخانه دستورهایی را برای پرس‌وجو و دستکاری پیکربندی‌های زیرشبکه
و شبکه اشتراکی (shared network) در Kea ارائه می‌دهد. این دستورها می‌توانند در
استقرارهایی با تعداد زیادی زیرشبکه که توسط سرورهای DHCP مدیریت می‌شوند،
هنگامی که آن زیرشبکه‌ها مکرراً به‌روزرسانی می‌شوند، بسیار مفید باشند. این دستورها
رویکردی سبک را برای دستکاری زیرشبکه‌ها بدون نیاز به پیکربندی مجددِ کامل سرور،
و بدون تأثیر بر پیکربندی‌های موجود سرور فراهم می‌کنند. همچنین قابلیت مدیریت
شبکه‌های اشتراکی (فهرست‌کردن، بازیابی جزئیات، افزودن موارد جدید، حذف موارد
موجود، و افزودن زیرشبکه‌ها به شبکه‌های اشتراکی و حذف آن‌ها از شبکه اشتراکی)
نیز ارائه شده است.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
\fBlibdhcp_subnet_cmds.so\fP بخشی از کد متن‌باز است و برای
همه کاربران Kea در دسترس است.
این کتابخانه پیش‌تر فقط برای مشتریان ISC با قرارداد پشتیبانی پولی در دسترس بود.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این کتابخانه فقط می‌تواند توسط فرایند \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> یا \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6>
بارگذاری شود.
.UNINDENT
.UNINDENT
.sp
در حال حاضر دستورهای زیر پشتیبانی می‌شوند:
.INDENT 0.0
.IP \(bu 2
\fBsubnet4\-list\fP / \fBsubnet6\-list\fP \- تمام زیرشبکه‌های پیکربندی‌شده را فهرست می‌کند.
.IP \(bu 2
\fBsubnet4\-get\fP / \fBsubnet6\-get\fP \- اطلاعات تفصیلی مربوط به یک
زیرشبکه مشخص را بازیابی می‌کند.
.IP \(bu 2
\fBsubnet4\-add\fP / \fBsubnet6\-add\fP \- یک زیرشبکه جدید به پیکربندی
سرور اضافه می‌کند.
.IP \(bu 2
\fBsubnet4\-update\fP / \fBsubnet6\-update\fP \- یک زیرشبکه مشخص را در
پیکربندی سرور به‌روزرسانی (جایگزین) می‌کند.
.IP \(bu 2
\fBsubnet4\-del\fP / \fBsubnet6\-del\fP \- یک زیرشبکه را از پیکربندی
سرور حذف می‌کند.
.IP \(bu 2
\fBsubnet4\-delta\-add\fP / \fBsubnet6\-delta\-add\fP \- بخش‌هایی از یک
زیرشبکه مشخص را در پیکربندی سرور به‌روزرسانی (جایگزین) می‌کند.
.IP \(bu 2
\fBsubnet4\-delta\-del\fP / \fBsubnet6\-delta\-del\fP \- بخش‌هایی از یک زیرشبکه مشخص را
در پیکربندی سرور حذف می‌کند.
.IP \(bu 2
\fBnetwork4\-list\fP / \fBnetwork6\-list\fP \- تمام شبکه‌های اشتراکی پیکربندی‌شده را فهرست می‌کند.
.IP \(bu 2
\fBnetwork4\-get\fP / \fBnetwork6\-get\fP \- اطلاعات تفصیلی مربوط به یک
شبکه اشتراکی مشخص را بازیابی می‌کند.
.IP \(bu 2
\fBnetwork4\-add\fP / \fBnetwork6\-add\fP \- یک شبکه اشتراکی جدید به
پیکربندی سرور اضافه می‌کند.
.IP \(bu 2
\fBnetwork4\-del\fP / \fBnetwork6\-del\fP \- یک شبکه اشتراکی را از
پیکربندی سرور حذف می‌کند.
.IP \(bu 2
\fBnetwork4\-subnet\-add\fP / \fBnetwork6\-subnet\-add\fP \- یک زیرشبکه موجود را به
یک شبکه اشتراکی موجود اضافه می‌کند.
.IP \(bu 2
\fBnetwork4\-subnet\-del\fP / \fBnetwork6\-subnet\-del\fP \- یک زیرشبکه را از
یک شبکه اشتراکی موجود حذف کرده و آن را به یک زیرشبکه عادی تنزل می‌دهد.
.UNINDENT.SS دستور \fBsubnet4\-list\fP
.sp
این دستور برای فهرست کردن تمام زیرشبکه‌های پیکربندی‌شده فعلی به کار می‌رود. هر زیرشبکه به همراه شناسه زیرشبکه، پیشوند زیرشبکه و نام شبکه مشترک (در صورت موجود بودن) بازگردانده می‌شود. برای بازیابی اطلاعات دقیق درباره زیرشبکه، از دستور \fBsubnet4\-get\fP استفاده کنید.
.sp
این دستور ساختار ساده‌ای دارد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqsubnet4\-list\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
فهرست زیرشبکه‌ها با قالب زیر بازگردانده می‌شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq2 IPv4 subnets found\(dq,
    \(dqarguments\(dq: {
    \(dqsubnets\(dq: [
        {
            \(dqid\(dq: 10,
            \(dqshared\-network\-name\(dq: \(dqnet1\(dq,
            \(dqsubnet\(dq: \(dq10.0.0.0/8\(dq
        },
        {
            \(dqid\(dq: 100,
            \(dqshared\-network\-name\(dq: null,
            \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq
        }
    ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر هیچ زیرشبکه IPv4ای پیدا نشود، یک کد خطا به همراه شرح خطا بازگردانده می‌شود.
.SS دستور \fBsubnet6\-list\fP
.sp
این دستور برای فهرست کردن تمام زیرشبکه‌های پیکربندی‌شده فعلی به کار می‌رود. هر زیرشبکه به همراه شناسه زیرشبکه، پیشوند زیرشبکه و نام شبکه مشترک (در صورت موجود بودن) بازگردانده می‌شود. برای بازیابی اطلاعات دقیق درباره زیرشبکه، از دستور \fBsubnet6\-get\fP استفاده کنید.
.sp
این دستور ساختار ساده‌ای دارد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqsubnet6\-list\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
فهرست زیرشبکه‌ها با قالب زیر بازگردانده می‌شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq2 IPv6 subnets found\(dq,
    \(dqarguments\(dq: {
    \(dqsubnets\(dq: [
        {
            \(dqid\(dq: 11,
            \(dqshared\-network\-name\(dq: null,
            \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq
        },
        {
            \(dqid\(dq: 233,
            \(dqshared\-network\-name\(dq: \(dqsome\-net\(dq,
            \(dqsubnet\(dq: \(dq3000::/16\(dq
        }
    ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر هیچ زیرشبکه IPv6ای پیدا نشود، یک کد خطا به همراه شرح خطا بازگردانده می‌شود.
.SS دستور \fBsubnet4\-get\fP
.sp
این دستور برای بازیابی اطلاعات دقیق درباره زیرشبکه مشخص‌شده به کار می‌رود. این دستور معمولاً پس از \fBsubnet4\-list\fP استفاده می‌شود، که برای کشف زیرشبکه‌های موجود به همراه شناسه‌ها و پیشوندهای زیرشبکه مربوطه‌شان به کار می‌رود. سپس از هر کدام از این پارامترها می‌توان در \fBsubnet4\-get\fP برای دریافت اطلاعات زیرشبکه استفاده کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqsubnet4\-get\(dq,
    \(dqarguments\(dq: {
        \(dqid\(dq: 10
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
یا
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqsubnet4\-get\(dq,
    \(dqarguments\(dq: {
        \(dqsubnet\(dq: \(dq10.0.0.0/8\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر زیرشبکه وجود داشته باشد، پاسخ مشابه زیر خواهد بود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqInfo about IPv4 subnet 10.0.0.0/8 (id 10) returned\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [
            {
                \(dqsubnet\(dq: \(dq10.0.0.0/8\(dq,
                \(dqid\(dq: 1,
                \(dqoption\-data\(dq: [
                    {
                        ...
                    },
                    ...
                ],
                ...
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT.SS دستور \fBsubnet6\-get\fP
.sp
این دستور برای بازیابی اطلاعات تفصیلی درباره زیرشبکه مشخص‌شده به کار می‌رود. این دستور معمولاً پس از \fBsubnet6\-list\fP اجرا می‌شود که برای یافتن زیرشبکه‌های موجود به همراه شناسه‌ها و پیشوندهای زیرشبکه مربوطه‌شان استفاده می‌گردد. سپس می‌توان از هر یک از این پارامترها در \fBsubnet6\-get\fP برای دریافت اطلاعات زیرشبکه استفاده کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqsubnet6\-get\(dq,
    \(dqarguments\(dq: {
        \(dqid\(dq: 11
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
یا
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqsubnet6\-get\(dq,
    \(dqarguments\(dq: {
        \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر زیرشبکه وجود داشته باشد، پاسخ مشابه این خواهد بود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqInfo about IPv6 subnet 2001:db8:1::/64 (id 11) returned\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [
            {
                \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
                \(dqid\(dq: 1,
                \(dqoption\-data\(dq: [
                    {
                        ...
                    },
                    ...
                ],
                ...
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.SS دستور \fBsubnet4\-add\fP
.sp
این دستور برای ایجاد و افزودن یک زیرشبکه جدید به پیکربندی موجود سرور به کار می‌رود. این عملیات هیچ تاثیری بر سایر زیرشبکه‌ها ندارد. شناسه زیرشبکه باید مشخص شود و در میان تمام زیرشبکه‌ها یکتا باشد. اگر شناسه یا پیشوند زیرشبکه یکتا نباشد، خطایی گزارش شده و زیرشبکه افزوده نمی‌شود.
.sp
اطلاعات زیرشبکه درون این دستور دارای همان ساختار اطلاعات زیرشبکه در فایل پیکربندی سرور است، با این استثنا که رزروهای ایستای میزبان را نمی‌توان درون \fBsubnet4\-add\fP\& مشخص کرد. برای افزودن، حذف و ویرایش رزروهای ایستا باید از دستورهای شرح‌داده‌شده در libdhcp_host_cmds.so: Host Commands استفاده شود.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqsubnet4\-add\(dq,
    \(dqarguments\(dq: {
        \(dqsubnet4\(dq: [ {
            \(dqid\(dq: 123,
            \(dqsubnet\(dq: \(dq10.20.30.0/24\(dq,
            ...
        } ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ به این دستور ساختار زیر را دارد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqIPv4 subnet added\(dq,
    \(dqarguments\(dq: {
        \(dqsubnet4\(dq: [
            {
                \(dqid\(dq: 123,
                \(dqsubnet\(dq: \(dq10.20.30.0/24\(dq
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.SS دستور \fBsubnet6\-add\fP
.sp
این دستور برای ایجاد و افزودن یک زیرشبکه جدید به پیکربندی موجود سرور به کار می‌رود. این عملیات هیچ تاثیری بر سایر زیرشبکه‌ها ندارد. شناسه زیرشبکه باید مشخص شود و در میان تمام زیرشبکه‌ها یکتا باشد. اگر شناسه یا پیشوند زیرشبکه یکتا نباشد، خطایی گزارش شده و زیرشبکه افزوده نمی‌شود.
.sp
اطلاعات زیرشبکه درون این دستور دارای همان ساختار اطلاعات زیرشبکه در فایل پیکربندی سرور است، با این استثنا که رزروهای ایستای میزبان را نمی‌توان درون \fBsubnet6\-add\fP\& مشخص کرد. برای افزودن، حذف و ویرایش رزروهای ایستا باید از دستورهای شرح‌داده‌شده در libdhcp_host_cmds.so: Host Commands استفاده شود.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqsubnet6\-add\(dq,
    \(dqarguments\(dq: {
        \(dqsubnet6\(dq: [ {
            \(dqid\(dq: 234,
            \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
            ...
        } ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ به این دستور ساختار زیر را دارد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqIPv6 subnet added\(dq,
    \(dqarguments\(dq: {
        \(dqsubnet6\(dq: [
            {
                \(dqid\(dq: 234,
                \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
از Kea 2.6.0 به بعد، Kea دیگر شناسه‌های زیرشبکه را به‌طور خودکار تولید نمی‌کند؛ آن‌ها باید برای \fBsubnet4\-add\fP و \fBsubnet6\-add\fP\& مشخص شوند. در صورت عدم تعیین، Kea تلاش می‌کند مقدار بعدی \fBsubnet\-id\fP را اختصاص دهد. این تولیدکننده خودکار مقادیر شناسه ساده است؛ مقدار اختصاص‌یافته خودکار قبلی را به علاوه ۱ برمی‌گرداند. این سازوکار به خوبی کار می‌کند، مگر اینکه یک زیرشبکه به‌صورت دستی با مقداری بزرگ‌تر از مقادیر قبلاً استفاده‌شده ایجاد شود. برای مثال، اگر \fBsubnet4\-add\fP پنج بار فراخوانی شود، هر بار بدون شناسه، Kea شناسه‌های ۱، ۲، ۳، ۴ و ۵ را اختصاص خواهد داد و همه‌چیز به درستی کار خواهد کرد. با این حال، اگر \fBsubnet4\-add\fP پنج بار فراخوانی شود، در حالی که اولین زیرشبکه دارای \fBsubnet\-id\fP با مقدار ۳ باشد و باقی آن‌ها فاقد \fBsubnet\-id\fP باشند، عملیات با شکست مواجه خواهد شد. اولین دستور (با مقدار صریح) از \fBsubnet\-id\fP مقدار ۳ استفاده خواهد کرد؛ دومین دستور زیرشبکه‌ای با شناسه ۱ ایجاد می‌کند؛ سومی از مقدار ۲ استفاده خواهد کرد؛ و سرانجام مقدار \fBsubnet\-id\fP چهارمی به‌طور خودکار برابر با ۳ تولید خواهد شد. اما از آن‌جا که هم‌اکنون زیرشبکه‌ای با آن شناسه وجود دارد، فرآیند با شکست مواجه خواهد شد.
.sp
توصیه عمومی این است که یا هرگز از مقادیر صریح استفاده نکنید تا مقادیر تولید‌شده به‌طور خودکار همیشه کار کنند؛ یا همیشه از مقادیر صریح استفاده کنید تا از تولید خودکار هرگز استفاده نشود. این دو رویکرد تنها در صورتی می‌توانند با هم ترکیب شوند که مدیر سیستم از نحوه کارکرد تولید خودکار داخلی \fBsubnet\-id\fP در Kea آگاه باشد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
شناسه‌های زیرشبکه باید بزرگ‌تر از صفر و کوچک‌تر از 4294967295 باشند.
.UNINDENT
.UNINDENT.SS دستور \fBsubnet4\-update\fP
.sp
این دستور برای به‌روزرسانی (بازنویسی) یک زیرشبکهٔ منفرد در پیکربندی موجود
سرور استفاده می‌شود. این عملیات هیچ اثری بر سایر زیرشبکه‌ها ندارد. شناسهٔ
زیرشبکه برای شناسایی زیرشبکه‌ای که باید جایگزین شود به‌کار می‌رود؛ این شناسه
باید مشخص شده و در میان تمام زیرشبکه‌ها یکتا باشد. پیشوند زیرشبکه
نباید به‌روزرسانی شود.
.sp
اطلاعات زیرشبکه در این دستور ساختاری مشابه با اطلاعات زیرشبکه در فایل
پیکربندی سرور دارد، با این استثنا که رزروهای میزبان ایستا را نمی‌توان در
\fBsubnet4\-update\fP\& مشخص کرد. برای به‌روزرسانی، حذف و ویرایش رزروهای ایستا باید
از دستورهای شرح داده‌شده در libdhcp_host_cmds.so: Host Commands استفاده شود.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqsubnet4\-update\(dq,
    \(dqarguments\(dq: {
        \(dqsubnet4\(dq: [ {
            \(dqid\(dq: 123,
            \(dqsubnet\(dq: \(dq10.20.30.0/24\(dq,
            ...
        } ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ به این دستور ساختار زیر را دارد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqIPv4 subnet updated\(dq,
    \(dqarguments\(dq: {
        \(dqsubnet4\(dq: [
            {
                \(dqid\(dq: 123,
                \(dqsubnet\(dq: \(dq10.20.30.0/24\(dq
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
همانند سایر دستورهای به‌روزرسانی، این دستور تمام محتویات مدخل را بازنویسی
می‌کند. اگر زیرشبکهٔ IPv4 پیش‌تر منبعی به آن تخصیص یافته بود و دستور
\fBsubnet4\-update\fP فاقد آن منبع باشد، آن منبع از پیکربندی سرور حذف
خواهد شد. چنانچه به‌روزرسانی افزایشی زیرشبکه مد نظر باشد، از
\fBsubnet4\-delta\-add\fP\& استفاده کنید.
.SS دستور \fBsubnet6\-update\fP
.sp
این دستور برای به‌روزرسانی (بازنویسی) یک زیرشبکهٔ منفرد در پیکربندی موجود
سرور استفاده می‌شود. این عملیات هیچ اثری بر سایر زیرشبکه‌ها ندارد. شناسهٔ
زیرشبکه برای شناسایی زیرشبکه‌ای که باید جایگزین شود به‌کار می‌رود؛ این شناسه
باید مشخص شده و در میان تمام زیرشبکه‌ها یکتا باشد. پیشوند زیرشبکه
نباید به‌روزرسانی شود.
.sp
اطلاعات زیرشبکه در این دستور ساختاری مشابه با اطلاعات زیرشبکه در فایل
پیکربندی سرور دارد، با این استثنا که رزروهای میزبان ایستا را نمی‌توان در
\fBsubnet6\-update\fP\& مشخص کرد. برای به‌روزرسانی، حذف و ویرایش رزروهای ایستا باید
از دستورهای شرح داده‌شده در libdhcp_host_cmds.so: Host Commands استفاده شود.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqsubnet6\-update\(dq,
    \(dqarguments\(dq: {
        \(dqsubnet6\(dq: [ {
            \(dqid\(dq: 234,
            \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
            ...
        } ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ به این دستور ساختار زیر را دارد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqIPv6 subnet updated\(dq,
    \(dqarguments\(dq: {
        \(dqsubnet6\(dq: [
            {
                \(dqid\(dq: 234,
                \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
همانند سایر دستورهای به‌روزرسانی، این دستور تمام محتویات مدخل را بازنویسی
می‌کند. اگر زیرشبکهٔ IPv6 پیش‌تر منبعی به آن تخصیص یافته بود و دستور
\fBsubnet6\-update\fP فاقد آن منبع باشد، آن منبع از پیکربندی سرور حذف
خواهد شد. چنانچه به‌روزرسانی افزایشی زیرشبکه مد نظر باشد، از
\fBsubnet6\-delta\-add\fP\& استفاده کنید.
.SS دستور \fBsubnet4\-del\fP
.sp
این دستور برای حذف یک زیرشبکه از پیکربندی سرور به‌کار می‌رود.
این دستور اثری بر سایر زیرشبکه‌های پیکربندی‌شده ندارد، اما حذف یک
زیرشبکه پیامدهای خاصی به همراه دارد.
.sp
در بیشتر موارد، سرور اجاره‌هایی (leases) را به کلاینت‌های متعلق به آن زیرشبکه
تخصیص داده است. همچنین ممکن است سرور با رزروهای میزبان ایستایی پیکربندی شده
باشد که به این زیرشبکه مرتبط هستند. پیاده‌سازی کنونی دستور \fBsubnet4\-del\fP
نه اجاره‌ها و نه رزروهای میزبان مرتبط با زیرشبکه را حذف نمی‌کند. این امن‌ترین
رویکرد است زیرا سرور ردیابی اجاره‌های تخصیص‌یافته به کلاینت‌های این زیرشبکه را
از دست نمی‌دهد. با این حال، حذف زیرشبکه ممکن است همچنان باعث بروز خطاها و
تداخل‌های پیکربندی شود. برای مثال: پس از حذف زیرشبکه، ممکن است مدیر سرور زیرشبکهٔ
جدیدی را با همان شناسه‌ای که پیش‌تر برای زیرشبکهٔ حذف‌شده استفاده شده بود، به‌روزرسانی
کند. این بدان معناست که اجاره‌های موجود و رزروهای ایستا با این زیرشبکهٔ جدید تداخل
خواهند داشت؛ بنابراین، توصیه می‌کنیم که این دستور با احتیاط بسیار بالا استفاده شود.
.sp
این دستور همچنین می‌تواند برای حذف کامل یک زیرشبکهٔ IPv4 که بخشی از یک شبکهٔ مشترک
(shared network) است استفاده شود. برای حذف صرف زیرشبکه از یک شبکهٔ مشترک و نگه‌داشتن
پیکربندی آن زیرشبکه، در عوض از دستور \fBnetwork4\-subnet\-del\fP استفاده کنید.
.sp
این دستور ساختار زیر را دارد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqsubnet4\-del\(dq,
    \(dqarguments\(dq: {
        \(dqid\(dq: 123
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
یک پاسخ موفقیت‌آمیز ممکن است به این شکل باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqIPv4 subnet 192.0.2.0/24 (id 123) deleted\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [
            {
                \(dqid\(dq: 123,
                \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT.SS دستور \fBsubnet6\-del\fP
.sp
این دستور برای حذف یک زیرشبکه از پیکربندی سرور استفاده می‌شود.
این دستور هیچ تأثیری بر سایر زیرشبکه‌های پیکربندی‌شده ندارد، اما حذف
یک زیرشبکه پیامدهای خاصی به همراه دارد.
.sp
در بیشتر موارد، سرور اجاره‌هایی را به کلاینت‌های متعلق به این زیرشبکه
اختصاص داده است. سرور همچنین ممکن است با رزروهای ایستای میزبان که با
این زیرشبکه مرتبط هستند، پیکربندی شده باشد. پیاده‌سازی فعلی دستور
\fBsubnet6\-del\fP نه اجاره‌ها و نه رزروهای میزبان مرتبط با یک زیرشبکه را
حذف نمی‌کند. این امن‌ترین رویکرد است چرا که سرور ردیابی اجاره‌های اختصاص‌یافته
به کلاینت‌های این زیرشبکه را از دست نمی‌دهد. با این حال، حذف زیرشبکه
ممکن است همچنان باعث بروز خطاها و تداخل‌های پیکربندی شود. برای مثال:
پس از حذف زیرشبکه، مدیر سرور ممکن است یک زیرشبکه جدید با شناسه‌ای که
پیش‌تر برای زیرشبکه حذف‌شده استفاده می‌شد، اضافه کند. این بدان معناست که
اجاره‌های موجود و رزروهای ایستا با این زیرشبکه جدید در تداخل خواهند بود.
بنابراین، توصیه می‌کنیم که این دستور با احتیاط بسیار زیاد استفاده شود.
.sp
این دستور همچنین می‌تواند برای حذف کامل یک زیرشبکه IPv6 که بخشی از یک
شبکه مشترک است استفاده شود. برای صرفاً حذف زیرشبکه از یک شبکه مشترک و
حفظ پیکربندی زیرشبکه، به جای آن از دستور \fBnetwork6\-subnet\-del\fP
استفاده کنید.
.sp
این دستور ساختار زیر را دارد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqsubnet6\-del\(dq,
    \(dqarguments\(dq: {
        \(dqid\(dq: 234
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
یک پاسخ موفق ممکن است به این شکل باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqIPv6 subnet 2001:db8:1::/64 (id 234) deleted\(dq,
    \(dqsubnets\(dq: [
        {
            \(dqid\(dq: 234,
            \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq
        }
    ]
}
.EE
.UNINDENT
.UNINDENT
.SS دستور \fBsubnet4\-delta\-add\fP
.sp
این دستور برای به‌روزرسانی یک زیرشبکه از طریق افزودن یا بازنویسی بخش‌هایی از
آن در پیکربندی موجود سرور استفاده می‌شود. این عملیات هیچ تأثیری بر سایر
زیرشبکه‌ها ندارد. از شناسه زیرشبکه برای تعیین زیرشبکه جهت به‌روزرسانی استفاده می‌شود؛
این شناسه باید مشخص شود و باید در میان تمام زیرشبکه‌ها یکتا باشد. پیشوند زیرشبکه
نباید به‌روزرسانی شود.
.sp
اطلاعات زیرشبکه در این دستور ساختاری مشابه با اطلاعات زیرشبکه در فایل
پیکربندی سرور دارد، با این استثنا که رزروهای ایستای میزبان را نمی‌توان در
\fBsubnet4\-delta\-add\fP\& مشخص کرد. برای به‌روزرسانی، حذف و ویرایش رزروهای
ایستا باید از دستورهای شرح‌داده‌شده در libdhcp_host_cmds.so: Host Commands استفاده شود.
.sp
این دستور از کلیدها برای شناسایی شیء مربوطه استفاده می‌کند. کلیدها قابل به‌روزرسانی نیستند.
برای افزودن اشیای دیگر با کلیدهای متداخل، ابتدا باید اشیاء حذف شوند.
استخرهای آدرس با پارامتر \fIpool\fP شناسایی می‌شوند؛ گزینه‌ها با پارامترهای
\fIname\fP یا \fIcode\fP و \fIspace\fP شناسایی می‌شوند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqsubnet4\-delta\-add\(dq,
    \(dqarguments\(dq: {
        \(dqsubnet4\(dq: [ {
            \(dqvalid\-lifetime\(dq: 120,
            \(dqid\(dq: 123,
            \(dqsubnet\(dq: \(dq10.20.30.0/24\(dq,
            \(dqoption\-data\(dq: [
                {
                    \(dqalways\-send\(dq: false,
                    \(dqcode\(dq: 3,
                    \(dqcsv\-format\(dq: true,
                    \(dqdata\(dq: \(dq192.0.3.1\(dq,
                    \(dqname\(dq: \(dqrouters\(dq,
                    \(dqspace\(dq: \(dqdhcp4\(dq
                }
            ],
            \(dqpools\(dq: [
                {
                    \(dqpool\(dq: \(dq10.20.30.1\-10.20.30.10\(dq,
                    \(dqoption\-data\(dq: [
                        {
                            \(dqalways\-send\(dq: false,
                            \(dqcode\(dq: 4,
                            \(dqcsv\-format\(dq: true,
                            \(dqdata\(dq: \(dq192.0.4.1\(dq,
                            \(dqname\(dq: \(dqtime\-servers\(dq,
                            \(dqspace\(dq: \(dqdhcp4\(dq
                        }
                    ]
                }
            ]
        } ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ به این دستور ساختار زیر را دارد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqIPv4 subnet updated\(dq,
    \(dqarguments\(dq: {
        \(dqsubnet4\(dq: [
            {
                \(dqid\(dq: 123,
                \(dqsubnet\(dq: \(dq10.20.30.0/24\(dq
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور زیرشبکه \(dq10.20.30.0/24\(dq با شناسه 123 را با تغییر طول‌عمر معتبر،
با افزودن یا تغییر گزینه سطح زیرشبکه 3 (\(dqrouters\(dq)، با افزودن یا تغییر
پارامترهای استخر \(dq10.20.30.1\-10.20.30.10\(dq، و با افزودن یا تغییر گزینه
سطح استخر 4 (\(dqtime\-servers\(dq) به‌روزرسانی می‌کند..SS دستور \fBsubnet6\-delta\-add\fP
.sp
این دستور برای به‌روزرسانی یک زیرشبکه با افزودن یا بازنویسی بخش‌هایی از آن در
پیکربندی موجود سرور استفاده می‌شود. این عملیات هیچ اثری بر سایر
زیرشبکه‌ها ندارد. شناسهٔ زیرشبکه برای شناسایی زیرشبکه‌ای که باید به‌روزرسانی شود استفاده می‌شود؛ این مقدار باید
مشخص گردد و در میان تمام زیرشبکه‌ها منحصربه‌فرد باشد. پیشوند زیرشبکه نباید
به‌روزرسانی شود.
.sp
اطلاعات زیرشبکه در این دستور ساختاری یکسان با اطلاعات
زیرشبکه در فایل پیکربندی سرور دارد، با این استثنا
که رزروهای ایستای میزبان نمی‌توانند درون
\fBsubnet6\-delta\-add\fP\& مشخص شوند. برای به‌روزرسانی، حذف و ویرایش رزروهای ایستا باید
از دستورهای شرح‌داده‌شده در libdhcp_host_cmds.so: Host Commands استفاده شود.
.sp
این دستور از کلیدها برای شناسایی شیء مربوطه استفاده می‌کند. کلیدها قابل به‌روزرسانی نیستند.
اشیاء ابتدا باید حذف شوند تا بتوان اشیاء دیگری را با کلیدهای متداخل اضافه کرد.
استخرهای آدرس با پارامتر \fIpool\fP شناسایی می‌شوند؛ استخرهای پیشوند
با پارامترهای \fIprefix\fP، \fIprefix\-len\fP و \fIdelegated\-len\fP شناسایی می‌شوند؛ و گزینه‌ها
با پارامترهای \fIname\fP یا \fIcode\fP و \fIspace\fP شناسایی می‌گردند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqsubnet6\-delta\-add\(dq,
    \(dqarguments\(dq: {
        \(dqsubnet6\(dq: [ {
            \(dqvalid\-lifetime\(dq: 120,
            \(dqid\(dq: 243,
            \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
            \(dqoption\-data\(dq: [
                {
                    \(dqalways\-send\(dq: false,
                    \(dqcode\(dq: 23,
                    \(dqcsv\-format\(dq: true,
                    \(dqdata\(dq: \(dq3000::3:1\(dq,
                    \(dqname\(dq: \(dqdns\-servers\(dq,
                    \(dqspace\(dq: \(dqdhcp6\(dq
                }
            ],
            \(dqpd\-pools\(dq: [
                {
                    \(dqprefix\(dq: \(dq2001:db8:2::\(dq,
                    \(dqprefix\-len\(dq: 48,
                    \(dqdelegated\-len\(dq: 64,
                    \(dqoption\-data\(dq: [
                        {
                            \(dqalways\-send\(dq: false,
                            \(dqcode\(dq: 22,
                            \(dqcsv\-format\(dq: true,
                            \(dqdata\(dq: \(dq3000::4:1\(dq,
                            \(dqname\(dq: \(dqsip\-server\-addr\(dq,
                            \(dqspace\(dq: \(dqdhcp6\(dq
                        }
                    ]
                }
            ],
            \(dqpools\(dq: [
                {
                    \(dqpool\(dq: \(dq2001:db8:1::1\-2001:db8:1::10\(dq,
                    \(dqoption\-data\(dq: [
                        {
                            \(dqalways\-send\(dq: false,
                            \(dqcode\(dq: 31,
                            \(dqcsv\-format\(dq: true,
                            \(dqdata\(dq: \(dq3000::5:1\(dq,
                            \(dqname\(dq: \(dqsntp\-servers\(dq,
                            \(dqspace\(dq: \(dqdhcp6\(dq
                        }
                    ]
                }
            ]
        } ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ این دستور ساختار زیر را دارد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqIPv6 subnet updated\(dq,
    \(dqarguments\(dq: {
        \(dqsubnet6\(dq: [
            {
                \(dqid\(dq: 234,
                \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور زیرشبکهٔ \(dq2001:db8:1::/64\(dq با شناسهٔ 243 را با تغییر طول عمر
معتبر (valid lifetime)، افزودن یا تغییر گزینهٔ سطح زیرشبکهٔ 23 (\(dqdns\-servers\(dq)،
افزودن یا تغییر پارامترهای استخر \(dq2001:db8:1::1\-2001:db8:1::10\(dq،
افزودن یا تغییر گزینهٔ سطح استخر 31 (\(dqsntp\-servers\(dq)، افزودن یا
تغییر پارامترهای pd\-pool با عنوان \(dq2001:db8:2::\(dq با prefix\-len برابر با 48، و افزودن
یا تغییر گزینهٔ سطح pd\-pool شمارهٔ 22 (\(dqsip\-server\-addr\(dq) به‌روزرسانی می‌کند.
.SS دستور \fBsubnet4\-delta\-del\fP
.sp
این دستور برای به‌روزرسانی یک زیرشبکه با حذف بخش‌هایی از آن در پیکربندی
موجود سرور استفاده می‌شود. این عملیات هیچ اثری بر سایر زیرشبکه‌ها ندارد.
شناسهٔ زیرشبکه برای شناسایی زیرشبکه‌ای که باید به‌روزرسانی شود استفاده می‌شود؛ این مقدار باید
مشخص گردد و در میان تمام زیرشبکه‌ها منحصربه‌فرد باشد. پیشوند زیرشبکه نباید
به‌روزرسانی شود.
.sp
اطلاعات زیرشبکه در این دستور ساختاری یکسان با اطلاعات
زیرشبکه در فایل پیکربندی سرور دارد، با این استثنا
که رزروهای ایستای میزبان نمی‌توانند درون
\fBsubnet4\-delta\-del\fP\& مشخص شوند. برای به‌روزرسانی، حذف و ویرایش رزروهای ایستا باید
از دستورهای شرح‌داده‌شده در libdhcp_host_cmds.so: Host Commands استفاده شود.
.sp
این دستور انعطاف‌پذیر است و می‌تواند بخشی از زیرشبکه را با مشخص کردن
کل شیئی که باید حذف شود، یا صرفاً با مشخص کردن کلیدهای
شناسایی‌کنندهٔ شیء مربوطه حذف کند. استخرهای آدرس با پارامتر
\fIpool\fP شناسایی می‌شوند؛ و گزینه‌ها با پارامترهای \fIname\fP یا \fIcode\fP، و
\fIspace\fP شناسایی می‌گردند. اگر گزینه متعلق به فضای پیش‌فرض
\fIdhcp4\fP باشد، پارامتر \fIspace\fP می‌تواند نادیده گرفته شود.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqsubnet4\-delta\-del\(dq,
    \(dqarguments\(dq: {
        \(dqsubnet4\(dq: [ {
            \(dqvalid\-lifetime\(dq: 0,
            \(dqid\(dq: 123,
            \(dqsubnet\(dq: \(dq10.20.30.0/24\(dq,
            \(dqoption\-data\(dq: [
                { \(dqname\(dq: \(dqrouters\(dq }
            ],
            \(dqpools\(dq: [
                {
                    \(dqoption\-data\(dq: [
                        { \(dqcode\(dq: 4 }
                    ],
                    \(dqpool\(dq: \(dq10.20.30.11\-10.20.30.20\(dq
                },
                {
                    \(dqpool\(dq: \(dq10.20.30.21\-10.20.30.30\(dq
                }
            ]
        } ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ این دستور ساختار زیر را دارد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqIPv4 subnet updated\(dq,
    \(dqarguments\(dq: {
        \(dqsubnet4\(dq: [
            {
                \(dqid\(dq: 123,
                \(dqsubnet\(dq: \(dq10.20.30.0/24\(dq
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور زیرشبکهٔ \(dq10.20.30.0/24\(dq با شناسهٔ 123 را با حذف طول عمر
معتبر (valid lifetime)، حذف گزینهٔ سطح زیرشبکهٔ 3 (\(dqrouters\(dq)، حذف استخر
\(dq10.20.30.21\-10.20.30.30\(dq و حذف گزینهٔ سطح استخر 4
(\(dqtime\-servers\(dq) در استخر \(dq10.20.30.11\-10.20.30.20\(dq به‌روزرسانی می‌کند.
نیازی نیست مقادیر اسکالر با آنچه پیکربندی شده مطابقت داشته باشند، اما همچنان باید
حضور داشته باشند تا ساختار معتبر JSON حفظ شود و مقدار معتبری برای
تجزیه شدن (parse) باشند..SS دستور \fBsubnet6\-delta\-del\fP
.sp
این دستور برای به‌روزرسانی یک زیرشبکه از طریق حذف بخش‌هایی از آن در پیکربندی موجود
کارساز به کار می‌رود. این عملیات هیچ تأثیری بر سایر زیرشبکه‌ها ندارد.
از شناسهٔ زیرشبکه برای تعیین زیرشبکه جهت به‌روزرسانی استفاده می‌شود؛ این شناسه باید
مشخص شده و در میان تمام زیرشبکه‌ها یکتا باشد. پیشوند زیرشبکه نباید
به‌روزرسانی شود.
.sp
اطلاعات زیرشبکه در این دستور ساختاری مشابه با اطلاعات زیرشبکه در فایل پیکربندی
کارساز دارد، با این استثنا که رزروهای ایستا برای میزبان را نمی‌توان درون
\fBsubnet6\-delta\-del\fP\& مشخص کرد. برای به‌روزرسانی، حذف و اصلاح رزروهای ایستا
باید از دستورهای شرح داده شده در libdhcp_host_cmds.so: Host Commands استفاده
شود.
.sp
این دستور انعطاف‌پذیر است و می‌تواند با مشخص کردن کل شیئی که باید حذف شود، یا تنها با
مشخص کردن کلیدهای شناسایی‌کنندهٔ آن شیء، بخش مربوطه از زیرشبکه را حذف کند. استخرهای
آدرس با پارامتر \fIpool\fP مشخص می‌شوند؛ استخرهای پیشوند با پارامترهای \fIprefix\fP، \fIprefix\-len\fP
و \fIdelegated\-len\fP شناسایی می‌شوند؛ و گزینه‌ها با پارامترهای \fIname\fP یا
\fIcode\fP و \fIspace\fP مشخص می‌گردند. در صورتی که گزینه متعلق به فضای پیش‌فرض
\fIdhcp6\fP باشد، می‌توان پارامتر \fIspace\fP را نادیده گرفت.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqsubnet6\-delta\-del\(dq,
    \(dqarguments\(dq: {
        \(dqsubnet6\(dq: [ {
            \(dqvalid\-lifetime\(dq: 0,
            \(dqid\(dq: 234,
            \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
            \(dqoption\-data\(dq: [
                { \(dqname\(dq: \(dqdns\-servers\(dq }
            ],
            \(dqpd\-pools\(dq: [
                {
                    \(dqprefix\(dq: \(dq2001:db8:3::\(dq,
                    \(dqprefix\-len\(dq: 48,
                    \(dqdelegated\-len\(dq: 64,
                    \(dqoption\-data\(dq: [
                        { \(dqcode\(dq: 22 }
                    ]
                },
                {
                    \(dqprefix\(dq: \(dq2001:db8:4::\(dq,
                    \(dqprefix\-len\(dq: 48,
                    \(dqdelegated\-len\(dq: 64
                }
            ],
            \(dqpools\(dq: [
                {
                    \(dqoption\-data\(dq: [
                        { \(dqcode\(dq: 31 }
                    ],
                    \(dqpool\(dq: \(dq2001:db8:1::11\-2001:db8:1::20\(dq
                },
                {
                    \(dqpool\(dq: \(dq2001:db8:1::21\-2001:db8:1::30\(dq
                }
            ]
        } ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ این دستور ساختار زیر را دارد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqIPv6 subnet updated\(dq,
    \(dqarguments\(dq: {
        \(dqsubnet6\(dq: [
            {
                \(dqid\(dq: 234,
                \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور زیرشبکهٔ \(dq2001:db8:1::/64\(dq با شناسهٔ 243 را با حذف valid lifetime،
حذف گزینهٔ 23 در سطح زیرشبکه (\(dqdns\-servers\(dq)، حذف استخر
\(dq2001:db8:1::21\-2001:db8:1::30\(dq، حذف گزینهٔ 31 در سطح استخر
(\(dqsntp\-servers\(dq) در استخر \(dq2001:db8:1::11\-2001:db8:1::20\(dq، حذف
pd\-pool با عنوان \(dq2001:db8:4::\(dq با prefix\-len برابر با 48، و حذف گزینهٔ 22 در
سطح pd\-pool (\(dqsip\-server\-addr\(dq) در pd\-pool با عنوان \(dq2001:db8:3::\(dq با
prefix\-len برابر با 48 به‌روزرسانی می‌کند.
نیازی نیست مقادیر اسکالر با آنچه پیکربندی شده مطابقت داشته باشند، اما برای حفظ ساختار
معتبر json و داشتن یک مقدار معتبر جهت امکان تجزیه شدن، همچنان باید مشخص
شوند.
.SS دستورهای \fBnetwork4\-list\fP و \fBnetwork6\-list\fP
.sp
این دستورها برای دریافت فهرست کامل شبکه‌های اشتراکی پیکربندی‌شده در حال حاضر به کار
می‌روند. این فهرست تنها شامل اطلاعات بسیار پایه‌ای دربارهٔ هر شبکهٔ اشتراکی است.
اگر به جزئیات بیشتری نیاز است، لطفاً از \fBnetwork4\-get\fP یا \fBnetwork6\-get\fP
برای بازیابی تمامی اطلاعات موجود استفاده کنید. این دستور به هیچ پارامتری نیاز ندارد و
فراخوانی آن بسیار ساده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqnetwork4\-list\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
یک نمونه پاسخ برای \fBnetwork4\-list\fP به صورت زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqarguments\(dq: {
        \(dqshared\-networks\(dq: [
            { \(dqname\(dq: \(dqfloor1\(dq },
            { \(dqname\(dq: \(dqoffice\(dq }
        ]
    },
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq2 IPv4 network(s) found\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
دستور \fBnetwork6\-list\fP برای هر دو بخش دستور و پاسخ، دقیقاً از ساختار نحوی یکسانی
استفاده می‌کند..SS دستورهای \fBnetwork4\-get\fP و \fBnetwork6\-get\fP
.sp
این دستورها برای دریافت اطلاعات دقیق درباره شبکه‌های اشتراکی (shared networks)، شامل زیرشبکه‌هایی که در حال حاضر بخشی از یک شبکه مشخص هستند، استفاده می‌شوند. هر دو دستور یک پارامتر اجباری به نام \fBname\fP می‌گیرند که نام شبکه اشتراکی را مشخص می‌کند. یک دستور نمونه برای دریافت جزئیات یک شبکه اشتراکی IPv4 با نام \(dqfloor13\(dq به صورت زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqnetwork4\-get\(dq,
    \(dqarguments\(dq: {
        \(dqname\(dq: \(dqfloor13\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
یک پاسخ نمونه می‌تواند به صورت زیر باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqInfo about IPv4 shared network \(aqfloor13\(aq returned\(dq,
    \(dqarguments\(dq: {
        \(dqshared\-networks\(dq: [
        {
            \(dqmatch\-client\-id\(dq: true,
            \(dqname\(dq: \(dqfloor13\(dq,
            \(dqoption\-data\(dq: [ ],
            \(dqrebind\-timer\(dq: 90,
            \(dqrelay\(dq: {
                \(dqip\-address\(dq: \(dq0.0.0.0\(dq
            },
            \(dqrenew\-timer\(dq: 60,
            # Specify if the server should look up global reservations.
            \(dqreservations\-global\(dq: false,
            # Specify if the server should look up in\-subnet reservations.
            \(dqreservations\-in\-subnet\(dq: true,
            # Specify if the server can assume that all reserved addresses
            # are out\-of\-pool.
            \(dqreservations\-out\-of\-pool\(dq: false,
            \(dqsubnet4\(dq: [
                {
                    \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
                    \(dqid\(dq: 5,
                    ...
                    # many other subnet\-specific details here
                },
                {
                    \(dqid\(dq: 6,
                    \(dqsubnet\(dq: \(dq192.0.3.0/31\(dq,
                    ...
                    # many other subnet\-specific details here
                }
            ],
            \(dqvalid\-lifetime\(dq: 120
        }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ واقعی شامل فیلدهای اضافی بسیاری است که در اینجا برای وضوح بیشتر حذف شده‌اند. قالب پاسخ دقیقاً همان قالبی است که در \fBconfig\-get\fP \%<#\:std-isccmd-config-get> استفاده می‌شود، با این تفاوت که تنها به بازگرداندن اطلاعات شبکه اشتراکی محدود شده است.
.SS دستورهای \fBnetwork4\-add\fP و \fBnetwork6\-add\fP
.sp
این دستورها برای افزودن یک شبکه اشتراکی جدید استفاده می‌شوند که باید نامی یکتا داشته باشد. این دستور به یک پارامتر به نام \fBshared\-networks\fP نیاز دارد که یک لیست است و باید دقیقاً شامل یک مدخل (entry) باشد که شبکه را تعریف می‌کند. تنها عنصر اجباری برای یک شبکه، نام آن است. اگرچه از نظر عملیاتی منطقی به نظر نمی‌رسد، اما امکان افزودن یک شبکه اشتراکی خالی که هیچ زیرشبکه‌ای در آن وجود ندارد، ممکن است. این کار برای اهداف آزمایشی مجاز است، اما داشتن شبکه‌های خالی (یا شبکه‌هایی با تنها یک زیرشبکه) در محیط‌های عملیاتی (production) توصیه نمی‌شود. برای جزئیات مربوط به نحو (syntax)، به Shared Networks in DHCPv4 \%<#\:shared-network4> و Shared Networks in DHCPv6 \%<#\:shared-network6>\& مراجعه کنید.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
برخلاف توارث پارامترها در حین پردازش یک پیکربندی کامل جدید، این دستور توارث پارامتر را به طور کامل مدیریت نمی‌کند. هر پارامتر مفقود به جای این که از محدوده سراسری (global scope) به ارث برده شود، با مقادیر پیش‌فرض پر خواهد شد.
.UNINDENT
.UNINDENT
.sp
یک نمونه که نحوه افزودن یک شبکه اشتراکی IPv4 جدید را نشان می‌دهد به صورت زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqnetwork4\-add\(dq,
    \(dqarguments\(dq: {
        \(dqshared\-networks\(dq: [ {
            \(dqname\(dq: \(dqfloor13\(dq,
            \(dqsubnet4\(dq: [
            {
                \(dqid\(dq: 100,
                \(dqpools\(dq: [ { \(dqpool\(dq: \(dq192.0.2.2\-192.0.2.99\(dq } ],
                \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
                \(dqoption\-data\(dq: [
                    {
                        \(dqname\(dq: \(dqrouters\(dq,
                        \(dqdata\(dq: \(dq192.0.2.1\(dq
                    }
                ]
            },
            {
                \(dqid\(dq: 101,
                \(dqpools\(dq: [ { \(dqpool\(dq: \(dq192.0.3.2\-192.0.3.99\(dq } ],
                \(dqsubnet\(dq: \(dq192.0.3.0/24\(dq,
                \(dqoption\-data\(dq: [
                    {
                        \(dqname\(dq: \(dqrouters\(dq,
                        \(dqdata\(dq: \(dq192.0.3.1\(dq
                    }
                ]
            } ]
        } ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
با فرض اینکه قبلاً هیچ شبکه اشتراکی با نام \(dqfloor13\(dq و هیچ زیرشبکه‌ای با شناسه‌های 100 و 101 پیکربندی نشده باشد، دستور با موفقیت اجرا خواهد شد و پاسخ زیر را برمی‌گرداند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqarguments\(dq: {
        \(dqshared\-networks\(dq: [ { \(dqname\(dq: \(dqfloor13\(dq } ]
    },
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqA new IPv4 shared network \(aqfloor13\(aq added\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
دستور \fBnetwork6\-add\fP هم برای پرس‌وجو و هم برای پاسخ از همین نحو استفاده می‌کند. با این حال، برخی پارامترها فقط مخصوص IPv4 هستند (مانند \fBmatch\-client\-id\fP) و برخی دیگر فقط مخصوص IPv6 هستند (مانند \fBinterface\-id\fP). همین موضوع برای زیرشبکه‌های درون شبکه نیز صدق می‌کند..SS دستورهای \fBnetwork4\-del\fP و \fBnetwork6\-del\fP
.sp
این دستورها برای حذف شبکه‌های اشتراکی موجود به کار می‌روند. هر دو
دستور دقیقاً یک پارامتر می‌گیرند، \fBname\fP، که نام شبکه مورد نظر
برای حذف را مشخص می‌کند. نمونه‌ای از فراخوانی دستور \fBnetwork4\-del\fP
به صورت زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqnetwork4\-del\(dq,
    \(dqarguments\(dq: {
        \(dqname\(dq: \(dqfloor13\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
با فرض اینکه چنین شبکه‌ای پیکربندی شده باشد، پاسخ مشابه نمونه
زیر خواهد بود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqarguments\(dq: {
        \(dqshared\-networks\(dq: [
            {
                \(dqname\(dq: \(dqfloor13\(dq
            }
        ]
    },
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqIPv4 shared network \(aqfloor13\(aq deleted\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
دستور \fBnetwork6\-del\fP دقیقاً از همان نحو برای هر دوی دستور
و پاسخ استفاده می‌کند.
.sp
اگر زیرشبکه‌هایی متعلق به شبکه اشتراکیِ در حال حذف وجود داشته باشند،
آن‌ها به یک زیرشبکه ساده تنزل داده می‌شوند. یک پارامتر اختیاری به نام
\fBsubnets\-action\fP وجود دارد که در صورت تعیین شدن، یکی از دو مقدار
ممکن را می‌پذیرد: \fBkeep\fP (که پیش‌فرض است) و \fBdelete\fP\&. این گزینه
مشخص می‌کند که آیا زیرشبکه‌ها به زیرشبکه‌های ساده تنزل یابند یا حذف شوند. یک نمونه
استفاده در دستور \fBnetwork6\-del\fP که شبکه اشتراکی و تمام زیرشبکه‌های
درون آن را حذف می‌کند می‌تواند به صورت زیر باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqnetwork4\-del\(dq,
    \(dqarguments\(dq: {
        \(dqname\(dq: \(dqfloor13\(dq,
        \(dqsubnets\-action\(dq: \(dqdelete\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
همچنین برای حذف کامل زیرشبکه‌ها، استفاده از دستورهای
\fBsubnet4\-del\fP یا \fBsubnet6\-del\fP امکان‌پذیر است.
.SS دستورهای \fBnetwork4\-subnet\-add\fP و \fBnetwork6\-subnet\-add\fP
.sp
این دستورها برای افزودن زیرشبکه‌های موجود به شبکه‌های اشتراکی موجود
به کار می‌روند. چندین روش برای افزودن یک شبکه اشتراکی جدید وجود دارد. مدیر
سیستم می‌تواند کل شبکه اشتراکی را یک‌جا اضافه کند، چه از طریق
ویرایش فایل پیکربندی یا با فراخوانی دستور \fBnetwork4\-add\fP یا
\fBnetwork6\-add\fP به همراه زیرشبکه‌های مورد نظر در آن. این رویکرد
برای زیرشبکه‌های اشتراکی کاملاً جدید به خوبی عمل می‌کند. با این حال، ممکن است
مواردی پیش بیاید که آدرس‌های یک زیرشبکه موجود رو به اتمام باشد و لازم باشد
با فضای آدرس‌دهی بیشتر گسترش یابد؛ به عبارت دیگر، باید زیرشبکه دیگری
بر روی آن افزوده شود. برای این سناریو، مدیر سیستم می‌تواند
از \fBnetwork4\-add\fP یا \fBnetwork6\-add\fP استفاده کرده و سپس با استفاده از
\fBnetwork4\-subnet\-add\fP یا \fBnetwork6\-subnet\-add\fP، یک زیرشبکه
موجود را به این شبکه اشتراکی تازه ایجاد شده اضافه کند.
.sp
دستورهای \fBnetwork4\-subnet\-add\fP و
\fBnetwork6\-subnet\-add\fP
دو پارامتر دریافت می‌کنند: \fBid\fP، که یک عدد صحیح است و شناسه (ID)
یک زیرشبکه موجود را برای افزوده شدن به یک شبکه اشتراکی مشخص می‌کند؛ و \fBname\fP، که
نام شبکه اشتراکی‌ای را که زیرشبکه به آن اضافه خواهد شد مشخص می‌سازد. زیرشبکه
نباید به هیچ شبکه موجودی تعلق داشته باشد؛ برای
انتساب مجدد یک زیرشبکه از یک شبکه اشتراکی به شبکه دیگر، ابتدا از دستورهای
\fBnetwork4\-subnet\-del\fP یا
\fBnetwork6\-subnet\-del\fP استفاده کنید.
.sp
نمونه‌ای از فراخوانی دستور \fBnetwork4\-subnet\-add\fP به صورت
زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqnetwork4\-subnet\-add\(dq,
    \(dqarguments\(dq: {
        \(dqname\(dq: \(dqfloor13\(dq,
        \(dqid\(dq: 5
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
با فرض وجود شبکه‌ای به نام \(dqfloor13\(dq، و وجود زیرشبکه‌ای با
\fBsubnet\-id\fP برابر با 5 که بخشی از شبکه موجود نیست، این دستور
پاسخی مشابه زیر را بازمی‌گرداند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqIPv4 subnet 10.0.0.0/8 (id 5) is now part of shared network \(aqfloor13\(aq\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
دستور \fBnetwork6\-subnet\-add\fP دقیقاً از همان نحو برای هر دوی دستور
و پاسخ استفاده می‌کند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
برخلاف توارث پارامترها در طول پردازش یک پیکربندی کامل و جدید
یا هنگام افزودن یک شبکه اشتراکی جدید به همراه زیرشبکه‌های جدید،
این دستور وراثت پارامترها را به طور کامل مدیریت نمی‌کند.
هر پارامتر مشخص‌نشده به جای به ارث رسیدن از دامنه سراسری یا از شبکه اشتراکی،
با مقادیر پیش‌فرض پر خواهد شد.
.UNINDENT
.UNINDENT.SS دستورهای \fBnetwork4\-subnet\-del\fP و \fBnetwork6\-subnet\-del\fP
.sp
این دستورها برای حذف یک زیرشبکه که بخشی از یک شبکهٔ اشتراکی (shared network) موجود است و تنزل آن به یک زیرشبکهٔ مستقل و عادی به کار می‌روند.
برای حذف کامل یک زیرشبکه، در عوض از دستورهای \fBsubnet4\-del\fP یا \fBsubnet6\-del\fP
استفاده کنید. دستورهای \fBnetwork4\-subnet\-del\fP و
\fBnetwork6\-subnet\-del\fP دو پارامتر می‌گیرند: \fBid\fP که یک عدد صحیح
است و شناسهٔ زیرشبکهٔ موجودی را مشخص می‌کند که باید از یک شبکهٔ اشتراکی
حذف شود؛ و \fBname\fP که نام شبکهٔ اشتراکی را که زیرشبکه از آن حذف خواهد شد
مشخص می‌کند.
.sp
یک نمونه از فراخوانی دستور \fBnetwork4\-subnet\-del\fP به صورت زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
   \(dqcommand\(dq: \(dqnetwork4\-subnet\-del\(dq,
   \(dqarguments\(dq: {
       \(dqname\(dq: \(dqfloor13\(dq,
       \(dqid\(dq: 5
   }
}
.EE
.UNINDENT
.UNINDENT
.sp
با فرض اینکه زیرشبکه‌ای با \fBsubnet\-id\fP برابر با ۵ وجود داشته که بخشی از یک
شبکهٔ اشتراکی با نام \(dqfloor13\(dq بوده است، پاسخ مشابه زیر خواهد بود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqIPv4 subnet 10.0.0.0/8 (id 5) is now removed from shared network \(aqfloor13\(aq\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
دستور \fBnetwork6\-subnet\-del\fP برای هر دوی دستور و پاسخ از همان ساختار نحوی استفاده می‌کند.
.SS \fBlibdhcp_user_chk.so\fP: بررسی کاربر (User Check)
.sp
این کتابخانه چندین هدف را دنبال می‌کند:
.INDENT 0.0
.IP \(bu 2
تخصیص کاربران «جدید» یا «ثبت‌نشده» به یک زیرشبکهٔ محدود، در حالی که کاربران
«شناخته‌شده» یا «ثبت‌شده» به زیرشبکه‌های بدون محدودیت تخصیص می‌یابند.
.IP \(bu 2
امکان سفارشی‌سازی گزینه‌های پاسخ DHCP یا مقادیر گزینه‌های سازنده بر اساس هویت کاربر.
.IP \(bu 2
فراهم آوردن یک گزارش بی‌درنگ از فعالیت ثبت کاربران، که می‌تواند توسط یک
مصرف‌کنندهٔ خارجی نمونه‌برداری شود.
.IP \(bu 2
ارائه به عنوان نمونه‌ای نمایشی از قابلیت‌های گوناگونی که می‌توان با استفاده
از رابط قلاب‌ها (hooks interface) پیاده‌سازی کرد.
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
\fBlibdhcp_user_chk.so\fP بخشی از کد متن‌باز است و در دسترس تمام کاربران Kea قرار دارد.
.UNINDENT
.UNINDENT
.sp
این کتابخانه پس از بارگذاری، امکان جداسازی درخواست‌های دریافتی به کلاینت‌های شناخته‌شده
و ناشناخته را فراهم می‌کند. برای کلاینت‌های شناخته‌شده، بسته‌ها طبق روال معمول
پردازش می‌شوند، هرچند امکان بازنویسی ارسال برخی گزینه‌ها به ازای هر میزبان وجود دارد.
کلاینت‌هایی که در فهرست میزبان‌های شناخته‌شده نیستند، به عنوان ناشناخته تلقی شده و
به آخرین زیرشبکهٔ تعریف‌شده در فایل پیکربندی تخصیص می‌یابند.
.sp
به عنوان نمونه‌ای از یک مورد کاربرد، این رفتار می‌تواند برای قرار دادن کاربران ناشناخته
در یک زیرشبکهٔ مجزا پیاده‌سازی شود که به یک «باغ محصور» (walled garden) منتهی می‌شود؛
جایی که آن‌ها تنها به یک درگاه ثبت‌نام دسترسی دارند. پس از اینکه داده‌های لازم را پر کردند،
مشخصات آن‌ها به فایل کلاینت‌های شناخته‌شده افزوده می‌شود و پس از راه‌اندازی مجدد دستگاه،
یک آدرس مناسب دریافت می‌کنند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این کتابخانه چندین سال قبل از در دسترس قرار گرفتن سازوکار رزرو میزبان (host reservation)
توسعه یافته بود. رزرو میزبان بسیار قدرتمندتر و انعطاف‌پذیرتر است، اما توانایی
\fBuser_chk\fP در مراجعه به یک منبع اطلاعات خارجی دربارهٔ کلاینت‌ها و تغییر
رفتار Kea همچنان مفید و دارای ارزش آموزشی است.
.UNINDENT
.UNINDENT
.sp
این کتابخانه در زمان بارگذاری و هر بار که یک بستهٔ دریافتی پردازش می‌شود، فایل
\fB/usr/local/share/kea/user_chk_registry.txt\fP را می‌خواند. انتظار می‌رود هر خط از فایل
شامل یک قطعه کد JSON مستقل باشد که باید دارای دو مدخل زیر باشد:
.INDENT 0.0
.IP \(bu 2
\fBtype\fP \- که مقدار آن برای کاربران IPv4 برابر با \fB\(dqHW_ADDR\(dq\fP یا برای کاربران IPv6 برابر با \fB\(dqDUID\(dq\fP است.
.IP \(bu 2
\fBid\fP \- که مقدار آن یا آدرس سخت‌افزاری یا DUID از درخواست است، که در
قالب رشته‌ای از ارقام هگزادسیمال، با یا بدون جداکننده‌های \(dq:\(dq قالب‌بندی شده است.
.UNINDENT
.sp
و می‌تواند صفر یا تعداد بیشتری از مدخل‌های زیر را داشته باشد:
.INDENT 0.0
.IP \(bu 2
\fBbootfile\fP \- که مقدار آن مسیر فایل مورد نظر است.
.IP \(bu 2
\fBtftp_server\fP \- که مقدار آن نام میزبان یا آدرس IP کارساز مورد نظر است.
.UNINDENT
.sp
نمونه‌ای از یک فایل ثبت کاربر در زیر نشان داده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{ \(dqtype\(dq : \(dqHW_ADDR\(dq, \(dqid\(dq : \(dq0c:0e:0a:01:ff:04\(dq, \(dqbootfile\(dq : \(dq/usr/local/share/kea/v4bootfile\(dq }
{ \(dqtype\(dq : \(dqHW_ADDR\(dq, \(dqid\(dq : \(dq0c:0e:0a:01:ff:06\(dq, \(dqtftp_server\(dq : \(dqtftp.v4.example.com\(dq }
{ \(dqtype\(dq : \(dqDUID\(dq, \(dqid\(dq : \(dq00:01:00:01:19:ef:e6:3b:00:0c:01:02:03:04\(dq, \(dqbootfile\(dq : \(dq/usr/local/share/kea/v6bootfile\(dq }
{ \(dqtype\(dq : \(dqDUID\(dq, \(dqid\(dq : \(dq00:01:00:01:19:ef:e6:3b:00:0c:01:02:03:06\(dq, \(dqtftp_server\(dq : \(dqtftp.v6.example.com\(dq }
.EE
.UNINDENT
.UNINDENT
.sp
همانند هر کتابخانهٔ قلاب دیگری که توسط ISC ارائه می‌شود، سازوکار درونی کد
\fBuser_chk\fP به خوبی مستند شده است. کاربران برای کسب اطلاعات دربارهٔ چگونگی عملکرد
درونی کد، می‌توانند به بخش کتابخانهٔ user_chk در راهنمای توسعه‌دهندگان Kea \%<https://\:reports\:.kea\:.isc\:.org/\:dev_guide/\:d8/\:db2/\:libdhcp_user_chk\:.html>
مراجعه کنند. این بخش به همراه بخش چارچوب قلاب‌ها در راهنمای توسعه‌دهندگان Kea \%<https://\:reports\:.kea\:.isc\:.org/\:dev_guide/\:index\:.html#\:hooksFramework> باید
راهنمایی‌های لازم را در اختیار کاربران قرار دهد تا این کتابخانه را توسعه دهند و شاید
حتی کتابخانه‌ای را از ابتدا بنویسند..SH "آمارها (STATISTICS)"
.SS "نمای کلی آمارها (Statistics Overview)"
.sp
هر دو کارگزار Kea DHCP از جمع‌آوری آمارها پشتیبانی می‌کنند. یک کارگزار DHCP
فعال با رویدادهای گوناگونی مواجه می‌شود که می‌توانند باعث جمع‌آوری آمارهای مشخصی
گردند. برای نمونه، یک کارگزار DHCPv4 ممکن است بسته‌ای دریافت کند
(آمار \fBpkt4\-received\fP یک واحد افزایش می‌یابد) که پس از تجزیه،
به‌عنوان DHCPDISCOVER شناسایی می‌شود (\fBpkt4\-discover\-received\fP). کارگزار
آن را پردازش کرده و تصمیم می‌گیرد یک DHCPOFFER را به‌عنوان پاسخ خود ارسال کند
(آمارهای \fBpkt4\-offer\-sent\fP و \fBpkt4\-sent\fP یک واحد افزایش می‌یابند). چنین
رویدادهایی مکرراً رخ می‌دهند، بنابراین داشتن مقادیری در مرتبه چند ده هزار برای
آمارها غیرمعمول نیست. آن‌ها می‌توانند ابزاری آسان و قدرتمند برای نظارت بر سلامت
یک کارگزار و یک شبکه باشند. برای مثال، اگر رشد آمار \fBpkt4\-received\fP
متوقف شود، به این معنی است که بسته‌های کلاینت‌ها به کارگزار نمی‌رسند.
.sp
چهار نوع آمار وجود دارد:
.INDENT 0.0
.IP \(bu 2
\fIinteger\fP \- این رایج‌ترین نوع است. به‌صورت یک عدد صحیح ۶۴ بیتی
(int64_t در C++) پیاده‌سازی شده است، بنابراین می‌تواند هر مقداری بین
\-2^63 تا 2^63\-1 را در خود نگه دارد.
.IP \(bu 2
\fIbig integer\fP \- این نوع برای نگهداری اعداد بزرگ در نظر گرفته شده است.
به‌صورت یک عدد صحیح ۱۲۸ بیتی (boost::multiprecision::int128_t در C++) پیاده‌سازی
شده است، بنابراین می‌تواند هر مقداری بین \-2^127 تا 2^127\-1 را نگهداری کند.
.IP \(bu 2
\fIfloating point\fP \- این نوع برای ذخیره دقت ممیز شناور طراحی شده است.
به‌صورت نوع double در C++ پیاده‌سازی شده است.
.IP \(bu 2
\fIduration\fP \- این نوع برای ثبت بازه‌های زمانی در نظر گرفته شده است.
این نوع از \(gaboost::posix_time::time_duration استفاده می‌کند که ساعت‌ها،
دقیقه‌ها، ثانیه‌ها و میکروثانیه‌ها را ذخیره می‌نماید.
.IP \(bu 2
\fIstring\fP \- این نوع برای ثبت آمارها به شکل متنی در نظر گرفته شده است.
این نوع از std::string در C++ استفاده می‌کند.
.UNINDENT
.sp
در طول عملکرد عادی، کارگزارهای DHCPv4 و DHCPv6 آمارها را جمع‌آوری می‌کنند.
برای فهرستی از آمارهای DHCPv4 و DHCPv6، به‌ترتیب به
Statistics in the DHCPv4 Server \%<#\:dhcp4-stats> و Statistics in the DHCPv6 Server \%<#\:dhcp6-stats> مراجعه کنید.
.sp
برای استخراج داده‌ها از ماژول آمار، می‌توان از کانال کنترل استفاده کرد.
برای جزئیات به Management API \%<#\:ctrl-channel> مراجعه کنید. بازیابی یک
آمار منفرد یا همه آمارها، بازنشانی آمارها (یعنی تنظیم آن‌ها روی یک مقدار
خنثی، معمولاً صفر)، یا حتی حذف کامل یک آمار مشخص یا تمام آمارها امکان‌پذیر
است. برای فهرستی از دستورات مربوط به آمار به بخش Commands for Manipulating Statistics
مراجعه کنید.
.sp
ابزارهای خارجی می‌توانند از آمارها برای نظارت بر Kea استفاده کنند. یک نمونه از
چنین ابزارهایی Stork است. برای جزئیات درباره نحوه استفاده از آن و سایر منابع
داده جهت بازیابی دوره‌ای آمارها برای کسب دید بهتر از سلامت و وضعیت عملیاتی Kea،
به Monitoring Kea With Stork \%<#\:stork> مراجعه نمایید.
.SS "چرخه حیات آمارها (Statistics Lifecycle)"
.sp
تمام آمارهای پشتیبانی‌شده توسط کارگزارهای Kea هنگام راه‌اندازی کارگزار مقداردهی
اولیه می‌شوند و در پاسخ به دستوراتی مانند \fBstatistic\-get\-all\fP بازگردانده
می‌شوند. آمارهای زمان اجرا مربوط به بسته‌های DHCP پردازش‌شده، در ابتدا روی ۰
تنظیم شده و هنگام راه‌اندازی مجدد کارگزار بازنشانی می‌گردند.
.sp
آمارهای مربوط به هر زیرشبکه (Per\-subnet) هنگام انجام پیکربندی مجدد، دوباره محاسبه می‌شوند.
.sp
به‌طور کلی، زمانی که یک آمار مقداردهی اولیه شد، تا زمانی که صراحتاً از طریق
\fBstatistic\-remove\fP یا \fBstatistic\-remove\-all\fP حذف نشود، یا زمانی که
کارگزار خاموش گردد، در مدیر (manager) نگهداری می‌شود.
.sp
حذف آماری که مکرراً به‌روزرسانی می‌شود منطقی نیست، زیرا با ثبت بعدی آن توسط کد
کارگزار، دوباره اضافه خواهد شد. دستورات \fBstatistic\-remove\fP و
\fBstatistic\-remove\-all\fP برای حذف آمارهایی در نظر گرفته شده‌اند که انتظار
نمی‌رود در آینده نزدیک مشاهده شوند. برای نمونه، یک دستگاه با پیکربندی نادرست
در شبکه ممکن است باعث شود کلاینت‌ها نشانی‌های تکراری را گزارش کنند، بنابراین
کارگزار مقادیر رو به رشدی از \fBpkt4\-decline\-received\fP را گزارش خواهد داد.
پس از یافتن مشکل و حذف دستگاه، مدیر سیستم ممکن است بخواهد آمار
\fBpkt4\-decline\-received\fP را حذف کند تا دیگر گزارش نشود، مگر اینکه و تا زمانی
که دوباره یک نشانی تکراری شناسایی گردد.
.SS "دستورات دستکاری آمارها (Commands for Manipulating Statistics)"
.sp
چندین دستور تعریف شده است که می‌توان از آن‌ها برای دسترسی (\fB\-get\fP)،
بازنشانی به صفر یا یک مقدار خنثی (\fB\-reset\fP)، یا حذف کامل یک آمار
(\fB\-remove\fP) استفاده کرد. حد زمانی آمار (\fB\-sample\-age\-set\fP) و
حد اندازه بر اساس تعداد (\fB\-sample\-count\-set\fP)، که کنترل می‌کنند نمونه‌های
یک آمار معین چه مدت یا به چه تعداد نگهداری شوند، نیز قابل تغییر هستند.
.sp
تفاوت بین \fB\-reset\fP و \fB\-remove\fP تا حدی ظریف است. دستور \fB\-reset\fP
مقدار آمار را روی صفر یا یک مقدار خنثی تنظیم می‌کند، به‌طوری که پس از این
عملیات، آمار مقداری برابر با 0 (integer)، 0.0 (float)، 0h0m0s0us (duration)، یا
\(dq\(dq (string) خواهد داشت. هنگام درخواست، آماری با مقادیر ذکرشده بازگردانده
می‌شود. \fB\-remove\fP یک آمار را به‌طور کامل حذف می‌کند، به‌طوری که آمار دیگر
گزارش نمی‌شود. با این حال، کد کارگزار در صورت وجود دلیلی برای ثبت، ممکن است مجدداً
آن را اضافه کند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
بخش‌های زیر دستوراتی را شرح می‌دهند که می‌توانند به کارگزار ارسال شوند؛ این
مثال‌ها تکه‌هایی از یک فایل پیکربندی نیستند. برای اطلاعات بیشتر درباره ارسال
دستورات به Kea، به Management API \%<#\:ctrl-channel>\& مراجعه کنید.
.UNINDENT
.UNINDENT
.SS "دستور \fBstatistic\-get\fP (The \fBstatistic\-get\fP Command)"
.sp
دستور \fBstatistic\-get\fP یک آمار منفرد را بازیابی می‌کند. این دستور یک
پارامتر تک‌رشته‌ای به نام \fBname\fP می‌گیرد که نام آمار را مشخص می‌سازد.
یک نمونه دستور می‌تواند مانند این باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqstatistic\-get\(dq,
    \(dqarguments\(dq: {
        \(dqname\(dq: \(dqpkt4\-received\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
کارگزار جزئیات آمار درخواست‌شده را بازمی‌گرداند؛ نتیجه 0 نشان‌دهنده موفقیت
و مقدار پارامتر \fBarguments\fP همان آمار مشخص‌شده است. اگر آمار درخواست‌شده
یافت نشود، پاسخ حاوی یک نگاشت خالی خواهد بود، یعنی فقط { } به‌عنوان آرگومان،
اما کد وضعیت همچنان نشان‌دهنده موفقیت (0) است.
.sp
در اینجا یک نمونه پاسخ آمده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqstatistic\-get\(dq,
    \(dqarguments\(dq: {
        \(dqpkt4\-received\(dq: [ [ 125, \(dq2019\-07\-30 10:11:19.498739\(dq ], [ 100, \(dq2019\-07\-30 10:11:19.498662\(dq ] ]
    },
    \(dqresult\(dq: 0
}
.EE
.UNINDENT
.UNINDENT.SS دستور \fBstatistic\-reset\fP
.sp
دستور \fBstatistic\-reset\fP آمار مشخص‌شده را به مقدار خنثی آن تنظیم می‌کند: 0 برای عدد صحیح، 0.0 برای ممیز شناور، 0h0m0s0us برای بازه زمانی، و \(dq\(dq برای نوع رشته‌ای. این دستور یک پارامتر تک‌رشته‌ای به نام \fBname\fP می‌گیرد که نام آمار را مشخص می‌کند. یک نمونه دستور ممکن است بدین صورت باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqstatistic\-reset\(dq,
    \(dqarguments\(dq: {
        \(dqname\(dq: \(dqpkt4\-received\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر آمار مشخص‌شده یافت شود و بازنشانی با موفقیت انجام گیرد، کارساز پاسخی با وضعیت 0 که نشان‌دهنده موفقیت است و یک فیلد پارامترهای خالی بازمی‌گرداند. در صورت بروز خطا (برای نمونه، آمار درخواستی یافت نشود)، کارساز کد وضعیت 1 (خطا) را بازمی‌گرداند و فیلد متن شامل شرح خطا خواهد بود.
.SS دستور \fBstatistic\-remove\fP
.sp
دستور \fBstatistic\-remove\fP یک آمار را حذف می‌کند. این دستور یک پارامتر تک‌رشته‌ای به نام \fBname\fP می‌گیرد که نام آمار را مشخص می‌کند. یک نمونه دستور ممکن است بدین صورت باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqstatistic\-remove\(dq,
    \(dqarguments\(dq: {
        \(dqname\(dq: \(dqpkt4\-received\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر آمار مشخص‌شده یافت شود و حذف آن با موفقیت صورت گیرد، کارساز پاسخی با وضعیت 0 که نشان‌دهنده موفقیت است و یک فیلد پارامترهای خالی بازمی‌گرداند. در صورت بروز خطا (برای نمونه، آمار درخواستی یافت نشود)، کارساز کد وضعیت 1 (خطا) را بازمی‌گرداند و فیلد متن شامل شرح خطا خواهد بود.
.SS دستور \fBstatistic\-get\-all\fP
.sp
دستور \fBstatistic\-get\-all\fP تمامی آمارهای ثبت‌شده را بازیابی می‌کند. یک نمونه دستور ممکن است بدین صورت باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqstatistic\-get\-all\(dq,
    \(dqarguments\(dq: { }
}
.EE
.UNINDENT
.UNINDENT
.sp
در اینجا یک نمونه پاسخ که تمامی آمارهای جمع‌آوری‌شده را بازمی‌گرداند آورده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqstatistic\-get\-all\(dq,
    \(dqarguments\(dq: {
        \(dqassigned\-addresses\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.836096\(dq
            ]
        ],
        \(dqcumulative\-assigned\-addresses\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.836166\(dq
            ]
        ],
        \(dqdeclined\-addresses\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.836156\(dq
            ]
        ],
        \(dqpkt4\-ack\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616247\(dq
            ]
        ],
        \(dqpkt4\-ack\-sent\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616290\(dq
            ]
        ],
        \(dqpkt4\-admin\-filtered\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616352\(dq
            ]
        ],
        \(dqpkt4\-decline\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616296\(dq
            ]
        ],
        \(dqpkt4\-duplicate\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616352\(dq
            ]
        ],
        \(dqpkt4\-discover\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616303\(dq
            ]
        ],
        \(dqpkt4\-inform\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616308\(dq
            ]
        ],
        \(dqpkt4\-limit\-exceeded\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616310\(dq
            ]
        ],
        \(dqpkt4\-nak\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616312\(dq
            ]
        ],
        \(dqpkt4\-nak\-sent\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616314\(dq
            ]
        ],
        \(dqpkt4\-not\-for\-us\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616351\(dq
            ]
        ],
        \(dqpkt4\-offer\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616318\(dq
            ]
        ],
        \(dqpkt4\-offer\-sent\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616323\(dq
            ]
        ],
        \(dqpkt4\-parse\-failed\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616326\(dq
            ]
        ],
        \(dqpkt4\-processing\-failed\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616351\(dq
            ]
        ],
        \(dqpkt4\-queue\-full\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616352\(dq
            ]
        ],
        \(dqpkt4\-receive\-drop\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616330\(dq
            ]
        ],
        \(dqpkt4\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616335\(dq
            ]
        ],
        \(dqpkt4\-release\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616339\(dq
            ]
        ],
        \(dqpkt4\-request\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616343\(dq
            ]
        ],
        \(dqpkt4\-rfc\-violation\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616351\(dq
            ]
        ],
        \(dqpkt4\-sent\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616348\(dq
            ]
        ],
        \(dqpkt4\-service\-disabled\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616351\(dq
            ]
        ],
        \(dqpkt4\-unknown\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616354\(dq
            ]
        ],
        \(dqreclaimed\-declined\-addresses\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.836159\(dq
            ]
        ],
        \(dqreclaimed\-leases\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.836163\(dq
            ]
        ],
        \(dqsubnet[1].assigned\-addresses\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.836173\(dq
            ]
        ],
        \(dqsubnet[1].cumulative\-assigned\-addresses\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.836098\(dq
            ]
        ],
        \(dqsubnet[1].declined\-addresses\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.836178\(dq
            ]
        ],
        \(dqsubnet[1].pool[0].assigned\-addresses\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.836205\(dq
            ]
        ],
        \(dqsubnet[1].pool[0].cumulative\-assigned\-addresses\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.836137\(dq
            ]
        ],
        \(dqsubnet[1].pool[0].declined\-addresses\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.836213\(dq
            ]
        ],
        \(dqsubnet[1].pool[0].reclaimed\-declined\-addresses\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.836225\(dq
            ]
        ],
        \(dqsubnet[1].pool[0].reclaimed\-leases\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.836236\(dq
            ]
        ],
        \(dqsubnet[1].pool[0].total\-addresses\(dq: [
            [
                11010049,
                \(dq2023\-06\-13 20:42:46.836128\(dq
            ]
        ],
        \(dqsubnet[1].reclaimed\-declined\-addresses\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.836186\(dq
            ]
        ],
        \(dqsubnet[1].reclaimed\-leases\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.836194\(dq
            ]
        ],
        \(dqsubnet[1].total\-addresses\(dq: [
            [
                11010049,
                \(dq2023\-06\-13 20:42:46.836083\(dq
            ]
        ],
        \(dqsubnet[1].v4\-lease\-reuses\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.836105\(dq
            ]
        ],
        \(dqsubnet[1].v4\-reservation\-conflicts\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.836111\(dq
            ]
        ],
        \(dqv4\-allocation\-fail\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616358\(dq
            ]
        ],
        \(dqv4\-allocation\-fail\-classes\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616363\(dq
            ]
        ],
        \(dqv4\-allocation\-fail\-no\-pools\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616368\(dq
            ]
        ],
        \(dqv4\-allocation\-fail\-shared\-network\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616372\(dq
            ]
        ],
        \(dqv4\-allocation\-fail\-subnet\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616376\(dq
            ]
        ],
        \(dqv4\-lease\-reuses\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616410\(dq
            ]
        ],
        \(dqv4\-reservation\-conflicts\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616412\(dq
            ]
        ]
    },
    \(dqresult\(dq: 0
}
.EE
.UNINDENT
.UNINDENT
.sp
یا
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqstatistic\-get\-all\(dq,
    \(dqarguments\(dq: {
        \(dqassigned\-nas\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196757\(dq
            ]
        ],
        \(dqassigned\-pds\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196757\(dq
            ]
        ],
        \(dqcumulative\-assigned\-nas\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196757\(dq
            ]
        ],
        \(dqcumulative\-assigned\-pds\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196758\(dq
            ]
        ],
        \(dqcumulative\-registered\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196758\(dq
            ]
        ],
        \(dqdeclined\-addresses\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196754\(dq
            ]
        ],
        \(dqpkt6\-addr\-reg\-inform\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177731\(dq
            ]
        ],
        \(dqpkt6\-addr\-reg\-reply\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177731\(dq
            ]
        ],
        \(dqpkt6\-addr\-reg\-reply\-sent\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177731\(dq
            ]
        ],
        \(dqpkt6\-admin\-filtered\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177747\(dq
            ]
        ],
        \(dqpkt6\-advertise\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177731\(dq
            ]
        ],
        \(dqpkt6\-advertise\-sent\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177739\(dq
            ]
        ],
        \(dqpkt6\-decline\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177739\(dq
            ]
        ],
        \(dqpkt6\-dhcpv4\-query\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177740\(dq
            ]
        ],
        \(dqpkt6\-dhcpv4\-response\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177740\(dq
            ]
        ],
        \(dqpkt6\-dhcpv4\-response\-sent\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177741\(dq
            ]
        ],
        \(dqpkt6\-duplicate\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177747\(dq
            ]
        ],
        \(dqpkt6\-infrequest\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177742\(dq
            ]
        ],
        \(dqpkt6\-limit\-exceeded\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177742\(dq
            ]
        ],
        \(dqpkt6\-not\-for\-us\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177747\(dq
            ]
        ],
        \(dqpkt6\-parse\-failed\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177742\(dq
            ]
        ],
        \(dqpkt6\-processing\-failed\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177747\(dq
            ]
        ],
        \(dqpkt6\-queue\-full\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177747\(dq
            ]
        ],
        \(dqpkt6\-rebind\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177743\(dq
            ]
        ],
        \(dqpkt6\-receive\-drop\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177743\(dq
            ]
        ],
        \(dqpkt6\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177744\(dq
            ]
        ],
        \(dqpkt6\-release\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177744\(dq
            ]
        ],
        \(dqpkt6\-renew\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177745\(dq
            ]
        ],
        \(dqpkt6\-reply\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177745\(dq
            ]
        ],
        \(dqpkt6\-reply\-sent\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177746\(dq
            ]
        ],
        \(dqpkt6\-request\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177747\(dq
            ]
        ],
        \(dqpkt6\-rfc\-violation\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177747\(dq
            ]
        ],
        \(dqpkt6\-sent\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177747\(dq
            ]
        ],
        \(dqpkt6\-service\-disabled\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177747\(dq
            ]
        ],
        \(dqpkt6\-solicit\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177748\(dq
            ]
        ],
        \(dqpkt6\-unknown\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177748\(dq
            ]
        ],
        \(dqreclaimed\-declined\-addresses\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196755\(dq
            ]
        ],
        \(dqreclaimed\-leases\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196756\(dq
            ]
        ],
        \(dqsubnet[1].assigned\-nas\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196760\(dq
            ]
        ],
        \(dqsubnet[1].assigned\-pds\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196761\(dq
            ]
        ],
        \(dqsubnet[1].cumulative\-assigned\-nas\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196727\(dq
            ]
        ],
        \(dqsubnet[1].cumulative\-assigned\-pds\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196729\(dq
            ]
        ],
        \(dqsubnet[1].cumulative\-registered\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196727\(dq
            ]
        ],
        \(dqsubnet[1].declined\-addresses\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196763\(dq
            ]
        ],
        \(dqsubnet[1].pd\-pool[0].assigned\-pds\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196785\(dq
            ]
        ],
        \(dqsubnet[1].pd\-pool[0].cumulative\-assigned\-pds\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196744\(dq
            ]
        ],
        \(dqsubnet[1].pd\-pool[0].reclaimed\-leases\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196789\(dq
            ]
        ],
        \(dqsubnet[1].pd\-pool[0].total\-pds\(dq: [
            [
                256,
                \(dq2023\-06\-13 21:28:57.196741\(dq
            ]
        ],
        \(dqsubnet[1].pool[0].assigned\-nas\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196773\(dq
            ]
        ],
        \(dqsubnet[1].pool[0].cumulative\-assigned\-nas\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196739\(dq
            ]
        ],
        \(dqsubnet[1].pool[0].declined\-addresses\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196775\(dq
            ]
        ],
        \(dqsubnet[1].pool[0].reclaimed\-declined\-addresses\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196779\(dq
            ]
        ],
        \(dqsubnet[1].pool[0].reclaimed\-leases\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196783\(dq
            ]
        ],
        \(dqsubnet[1].pool[0].total\-nas\(dq: [
            [
                281474976710656,
                \(dq2023\-06\-13 21:28:57.196736\(dq
            ]
        ],
        \(dqsubnet[1].reclaimed\-declined\-addresses\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196766\(dq
            ]
        ],
        \(dqsubnet[1].reclaimed\-leases\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196770\(dq
            ]
        ],
        \(dqsubnet[1].registered\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196727\(dq
            ]
        ],
        \(dqsubnet[1].total\-nas\(dq: [
            [
                281474976710656,
                \(dq2023\-06\-13 21:28:57.196720\(dq
            ]
        ],
        \(dqsubnet[1].total\-pds\(dq: [
            [
                256,
                \(dq2023\-06\-13 21:28:57.196724\(dq
            ]
        ],
        \(dqsubnet[1].v6\-ia\-na\-lease\-reuses\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196731\(dq
            ]
        ],
        \(dqsubnet[1].v6\-ia\-pd\-lease\-reuses\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196733\(dq
            ]
        ],
        \(dqv6\-allocation\-fail\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177749\(dq
            ]
        ],
        \(dqv6\-allocation\-fail\-classes\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177755\(dq
            ]
        ],
        \(dqv6\-allocation\-fail\-no\-pools\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177756\(dq
            ]
        ],
        \(dqv6\-allocation\-fail\-shared\-network\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177756\(dq
            ]
        ],
        \(dqv6\-allocation\-fail\-subnet\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177757\(dq
            ]
        ],
        \(dqv6\-ia\-na\-lease\-reuses\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177757\(dq
            ]
        ],
        \(dqv6\-ia\-pd\-lease\-reuses\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177758\(dq
            ]
        ]
    },
    \(dqresult\(dq: 0
}
.EE
.UNINDENT
.UNINDENT
.sp
یا
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqstatistic\-get\-all\(dq,
    \(dqarguments\(dq: {
        \(dqncr\-error\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:42:54.627751\(dq
            ]
        ],
        \(dqncr\-invalid\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:42:54.627749\(dq
            ]
        ],
        \(dqncr\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:42:54.627737\(dq
            ]
        ],
        \(dqqueue\-mgr\-queue\-full\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:42:54.627737\(dq
            ]
        ],
        \(dqupdate\-error\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:42:54.627759\(dq
            ]
        ],
        \(dqupdate\-sent\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:42:54.627752\(dq
            ]
        ],
        \(dqupdate\-signed\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:42:54.627753\(dq
            ]
        ],
        \(dqupdate\-success\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:42:54.627755\(dq
            ]
        ],
        \(dqupdate\-timeout\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:42:54.627757\(dq
            ]
        ],
        \(dqupdate\-unsigned\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:42:54.627754\(dq
            ]
        ]
    },
    \(dqresult\(dq: 0
}
.EE
.UNINDENT
.UNINDENT.SS دستور \fBstatistic\-global\-get\-all\fP
.sp
دستور \fBstatistic\-global\-get\-all\fP تمام آمارهای سراسری ثبت‌شده را بازیابی می‌کند (مشابه \fBstatistic\-get\-all\fP، اما بدون آمارهای زیرشبکه). یک دستور نمونه می‌تواند به این صورت باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqstatistic\-global\-get\-all\(dq,
    \(dqarguments\(dq: { }
}
.EE
.UNINDENT
.UNINDENT
.sp
در ادامه یک نمونه پاسخ که تمام آمارهای جمع‌آوری‌شده را بازمی‌گرداند آمده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqstatistic\-global\-get\-all\(dq,
    \(dqarguments\(dq: {
        \(dqassigned\-addresses\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.836096\(dq
            ]
        ],
        \(dqcumulative\-assigned\-addresses\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.836166\(dq
            ]
        ],
        \(dqdeclined\-addresses\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.836156\(dq
            ]
        ],
        \(dqpkt4\-ack\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616247\(dq
            ]
        ],
        \(dqpkt4\-ack\-sent\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616290\(dq
            ]
        ],
        \(dqpkt4\-admin\-filtered\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616352\(dq
            ]
        ],
        \(dqpkt4\-decline\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616296\(dq
            ]
        ],
        \(dqpkt4\-discover\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616303\(dq
            ]
        ],
        \(dqpkt4\-duplicate\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616352\(dq
            ]
        ],
        \(dqpkt4\-inform\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616308\(dq
            ]
        ],
        \(dqpkt4\-limit\-exceeded\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616310\(dq
            ]
        ],
        \(dqpkt4\-nak\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616312\(dq
            ]
        ],
        \(dqpkt4\-nak\-sent\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616314\(dq
            ]
        ],
        \(dqpkt4\-not\-for\-us\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616351\(dq
            ]
        ],
        \(dqpkt4\-offer\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616318\(dq
            ]
        ],
        \(dqpkt4\-offer\-sent\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616323\(dq
            ]
        ],
        \(dqpkt4\-parse\-failed\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616326\(dq
            ]
        ],
        \(dqpkt4\-processing\-failed\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616351\(dq
            ]
        ],
        \(dqpkt4\-queue\-full\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616352\(dq
            ]
        ],
        \(dqpkt4\-receive\-drop\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616330\(dq
            ]
        ],
        \(dqpkt4\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616335\(dq
            ]
        ],
        \(dqpkt4\-release\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616339\(dq
            ]
        ],
        \(dqpkt4\-request\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616343\(dq
            ]
        ],
        \(dqpkt4\-rfc\-violation\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616351\(dq
            ]
        ],
        \(dqpkt4\-sent\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616348\(dq
            ]
        ],
        \(dqpkt4\-service\-disabled\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616351\(dq
            ]
        ],
        \(dqpkt4\-unknown\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616354\(dq
            ]
        ],
        \(dqreclaimed\-declined\-addresses\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.836159\(dq
            ]
        ],
        \(dqreclaimed\-leases\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.836163\(dq
            ]
        ],
        \(dqv4\-allocation\-fail\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616358\(dq
            ]
        ],
        \(dqv4\-allocation\-fail\-classes\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616363\(dq
            ]
        ],
        \(dqv4\-allocation\-fail\-no\-pools\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616368\(dq
            ]
        ],
        \(dqv4\-allocation\-fail\-shared\-network\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616372\(dq
            ]
        ],
        \(dqv4\-allocation\-fail\-subnet\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616376\(dq
            ]
        ],
        \(dqv4\-lease\-reuses\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616410\(dq
            ]
        ],
        \(dqv4\-reservation\-conflicts\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616412\(dq
            ]
        ]
    },
    \(dqresult\(dq: 0
}
.EE
.UNINDENT
.UNINDENT
.sp
یا
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqstatistic\-global\-get\-all\(dq,
    \(dqarguments\(dq: {
        \(dqassigned\-nas\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196757\(dq
            ]
        ],
        \(dqassigned\-pds\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196757\(dq
            ]
        ],
        \(dqcumulative\-assigned\-nas\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196757\(dq
            ]
        ],
        \(dqcumulative\-assigned\-pds\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196758\(dq
            ]
        ],
        \(dqcumulative\-registered\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196758\(dq
            ]
        ],
        \(dqdeclined\-addresses\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196754\(dq
            ]
        ],
        \(dqpkt6\-addr\-reg\-inform\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177731\(dq
            ]
        ],
        \(dqpkt6\-addr\-reg\-reply\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177731\(dq
            ]
        ],
        \(dqpkt6\-addr\-reg\-reply\-sent\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177731\(dq
            ]
        ],
        \(dqpkt6\-admin\-filtered\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177747\(dq
            ]
        ],
        \(dqpkt6\-advertise\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177731\(dq
            ]
        ],
        \(dqpkt6\-advertise\-sent\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177739\(dq
            ]
        ],
        \(dqpkt6\-decline\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177739\(dq
            ]
        ],
        \(dqpkt6\-dhcpv4\-query\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177740\(dq
            ]
        ],
        \(dqpkt6\-dhcpv4\-response\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177740\(dq
            ]
        ],
        \(dqpkt6\-dhcpv4\-response\-sent\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177741\(dq
            ]
        ],
        \(dqpkt6\-duplicate\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177747\(dq
            ]
        ],
        \(dqpkt6\-infrequest\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177742\(dq
            ]
        ],
        \(dqpkt6\-limit\-exceeded\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177742\(dq
            ]
        ],
        \(dqpkt6\-not\-for\-us\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177747\(dq
            ]
        ],
        \(dqpkt6\-parse\-failed\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177742\(dq
            ]
        ],
        \(dqpkt6\-processing\-failed\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177747\(dq
            ]
        ],
        \(dqpkt6\-queue\-full\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177747\(dq
            ]
        ],
        \(dqpkt6\-rebind\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177743\(dq
            ]
        ],
        \(dqpkt6\-receive\-drop\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177743\(dq
            ]
        ],
        \(dqpkt6\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177744\(dq
            ]
        ],
        \(dqpkt6\-release\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177744\(dq
            ]
        ],
        \(dqpkt6\-renew\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177745\(dq
            ]
        ],
        \(dqpkt6\-reply\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177745\(dq
            ]
        ],
        \(dqpkt6\-reply\-sent\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177746\(dq
            ]
        ],
        \(dqpkt6\-request\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177747\(dq
            ]
        ],
        \(dqpkt6\-rfc\-violation\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177747\(dq
            ]
        ],
        \(dqpkt6\-sent\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177747\(dq
            ]
        ],
        \(dqpkt6\-service\-disabled\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177747\(dq
            ]
        ],
        \(dqpkt6\-solicit\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177748\(dq
            ]
        ],
        \(dqpkt6\-unknown\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177748\(dq
            ]
        ],
        \(dqreclaimed\-declined\-addresses\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196755\(dq
            ]
        ],
        \(dqreclaimed\-leases\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196756\(dq
            ]
        ],
        \(dqv6\-allocation\-fail\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177749\(dq
            ]
        ],
        \(dqv6\-allocation\-fail\-classes\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177755\(dq
            ]
        ],
        \(dqv6\-allocation\-fail\-no\-pools\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177756\(dq
            ]
        ],
        \(dqv6\-allocation\-fail\-shared\-network\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177756\(dq
            ]
        ],
        \(dqv6\-allocation\-fail\-subnet\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177757\(dq
            ]
        ],
        \(dqv6\-ia\-na\-lease\-reuses\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177757\(dq
            ]
        ],
        \(dqv6\-ia\-pd\-lease\-reuses\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177758\(dq
            ]
        ]
    },
    \(dqresult\(dq: 0
}
.EE
.UNINDENT
.UNINDENT.SS دستور \fBstatistic\-reset\-all\fP
.sp
دستور \fBstatistic\-reset\fP تمام آمارها را به مقادیر خنثای آن‌ها بازنشانی می‌کند: 0 برای عدد صحیح (integer)، 0.0 برای ممیز شناور (float)، 0h0m0s0us برای بازه زمانی، و \(dq\(dq برای نوع رشته (string). یک نمونه دستور می‌تواند به این صورت باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqstatistic\-reset\-all\(dq,
    \(dqarguments\(dq: { }
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر عملیات موفقیت‌آمیز باشد، سرور با وضعیت 0 که نشان‌دهنده موفقیت است و یک فیلد parameters خالی پاسخ می‌دهد. در صورت بروز خطا، سرور یک کد وضعیت 1 (خطا) را بازمی‌گرداند و فیلد text حاوی شرح خطا خواهد بود.
.SS دستور \fBstatistic\-remove\-all\fP
.sp
دستور \fBstatistic\-remove\-all\fP برای حذف تمامی آمارها تلاش می‌کند. یک نمونه دستور می‌تواند به این صورت باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqstatistic\-remove\-all\(dq,
    \(dqarguments\(dq: { }
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر حذف تمامی آمارها موفقیت‌آمیز باشد، سرور با وضعیت 0 که نشان‌دهنده موفقیت است و یک فیلد parameters خالی پاسخ می‌دهد. در صورت بروز خطا، سرور یک کد وضعیت 1 (خطا) را بازمی‌گرداند و فیلد text حاوی شرح خطا خواهد بود.
.SS دستور \fBstatistic\-sample\-age\-set\fP
.sp
دستور \fBstatistic\-sample\-age\-set\fP یک محدودیت زمانی بر روی نمونه‌های یک آماره مشخص تنظیم می‌کند. این دستور دو پارامتر دریافت می‌کند: یک رشته به نام \fBname\fP که نام آماره را مشخص می‌کند، و یک مقدار عدد صحیح به نام \fBduration\fP که محدودیت زمانی آماره مشخص‌شده را بر حسب ثانیه تعیین می‌کند. یک نمونه دستور می‌تواند به این صورت باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqstatistic\-sample\-age\-set\(dq,
    \(dqarguments\(dq: {
        \(dqname\(dq: \(dqpkt4\-received\(dq,
        \(dqduration\(dq: 1245
    }

}
.EE
.UNINDENT
.UNINDENT
.sp
اگر دستور موفقیت‌آمیز باشد، سرور با وضعیت 0 به نشانه موفقیت و یک فیلد parameters خالی پاسخ می‌دهد. در صورت بروز خطا (مانند پیدا نشدن آماره درخواستی)، سرور کد وضعیت 1 (خطا) را بازمی‌گرداند و فیلد text حاوی شرح خطا خواهد بود.
.SS دستور \fBstatistic\-sample\-age\-set\-all\fP
.sp
دستور \fBstatistic\-sample\-age\-set\-all\fP محدودیت‌های مبتنی بر زمان را بر روی نمونه‌های تمامی آمارها تنظیم می‌کند. این دستور یک پارامتر عدد صحیح به نام \fBduration\fP دریافت می‌کند که محدودیت زمانی آماره را بر حسب ثانیه تعیین می‌کند. یک نمونه دستور می‌تواند به این صورت باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqstatistic\-sample\-age\-set\-all\(dq,
    \(dqarguments\(dq: {
        \(dqduration\(dq: 1245
    }

}
.EE
.UNINDENT
.UNINDENT
.sp
اگر دستور موفقیت‌آمیز باشد، سرور با وضعیت 0 به نشانه موفقیت و یک فیلد parameters خالی پاسخ می‌دهد. در صورت بروز خطا، سرور یک کد وضعیت 1 (خطا) را بازمی‌گرداند و فیلد text حاوی شرح خطا خواهد بود.
.SS دستور \fBstatistic\-sample\-count\-set\fP
.sp
دستور \fBstatistic\-sample\-count\-set\fP یک محدودیت مبتنی بر اندازه (تعداد) بر روی نمونه‌های یک آماره مشخص تنظیم می‌کند. یک نمونه دستور می‌تواند به این صورت باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqstatistic\-sample\-count\-set\(dq,
    \(dqarguments\(dq: {
        \(dqname\(dq: \(dqpkt4\-received\(dq,
        \(dqmax\-samples\(dq: 100
    }

}
.EE
.UNINDENT
.UNINDENT
.sp
اگر دستور موفقیت‌آمیز باشد، سرور با وضعیت 0 به نشانه موفقیت و یک فیلد parameters خالی پاسخ می‌دهد. در صورت بروز خطا (مانند پیدا نشدن آماره درخواستی)، سرور کد وضعیت 1 (خطا) را بازمی‌گرداند و فیلد text حاوی شرح خطا خواهد بود..SS دستور \fBstatistic\-sample\-count\-set\-all\fP
.sp
دستور \fBstatistic\-sample\-count\-set\-all\fP محدودیت‌های مبتنی بر اندازه را
بر روی نمونه‌های تمامی آمارها تنظیم می‌کند. یک نمونه از این دستور می‌تواند
به شکل زیر باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqstatistic\-sample\-count\-set\-all\(dq,
    \(dqarguments\(dq: {
        \(dqmax\-samples\(dq: 100
    }

}
.EE
.UNINDENT
.UNINDENT
.sp
اگر دستور با موفقیت اجرا شود، سرور با وضعیت 0 که نشان‌دهنده موفقیت است
و یک فیلد خالی parameters پاسخ می‌دهد. در صورت بروز خطا، سرور یک
کد وضعیت 1 (خطا) بازمی‌گرداند و فیلد text حاوی شرح خطا خواهد بود.
.SS سری‌های زمانی (Time Series)
.sp
در برخی آمارها، یک نقطه داده منفرد و جداگانه ممکن است مفید باشد. با این حال،
برخی از آمارها، مانند اندازه بسته‌های دریافتی، زمان پردازش بسته، یا تعداد
پرس‌وجوهای پایگاه داده مورد نیاز برای پردازش یک بسته، تجمعی نیستند و نگهداری
چندین نقطه داده، احتمالاً برای انجام تحلیل‌های آماری در آینده، مفید خواهد بود.
.sp
هر یک از آمارهای Kea تا ۲۰ نقطه داده را در خود نگه می‌دارند؛ تعیین چنین
محدودیتی از رشد نامحدود حافظه جلوگیری می‌کند.
دو روش برای تعیین محدودیت‌ها وجود دارد: بر پایه زمان (برای مثال، نگهداری نمونه‌های
۵ دقیقه گذشته) و بر پایه اندازه. محدودیت بر پایه اندازه را می‌توان با استفاده
از یکی از دو دستور تغییر داد: \fBstatistic\-sample\-count\-set\fP، برای
تعیین محدودیت اندازه برای یک آمار منفرد، و \fBstatistic\-sample\-count\-set\-all\fP،
برای تنظیم محدودیت‌های مبتنی بر اندازه برای تمامی آمارها. برای تنظیم محدودیت‌های
بر پایه زمان برای یک آمار مشخص، از \fBstatistic\-sample\-age\-set\fP استفاده کنید؛
از \fBstatistic\-sample\-age\-set\-all\fP نیز برای تعیین محدودیت‌های بر پایه زمان برای
تمامی آمارها استفاده نمایید. برای هر آمار معین تنها یک نوع محدودیت می‌تواند فعال
باشد؛ فضای ذخیره‌سازی یا بر پایه زمان محدود می‌شود یا اندازه، نه هر دو.
.SH "رابط مدیریتی (MANAGEMENT API)"
.sp
یک رویکرد سنتی در پیکربندی دیمن‌ها (daemons) فرض می‌کند که پیکربندی
سرور در فایل‌های پیکربندی ذخیره شده است و با تغییر پیکربندی، دیمن
مجدداً راه‌اندازی می‌شود. این رویکرد این عیب عمده را دارد که دوره‌هایی
از توقف سرویس‌دهی (downtime) را به وجود می‌آورد که در آن ترافیک کلاینت‌ها
رسیدگی نمی‌شود. ریسک دیگر این است که اگر پیکربندی جدید به هر دلیلی
نامعتبر باشد، ممکن است سرور از راه‌اندازی خودداری کند، که این موضوع زمان
خاموشی را تا رفع مشکل بیشتر افزایش می‌دهد.
.sp
برای جلوگیری از چنین مشکلاتی، سرورهای DHCPv4، DHCPv6 و D2 در Kea از
سازوکاری پشتیبانی می‌کنند که امکان پیکربندی مجدد به‌صورت برخط را بدون نیاز
به خاموش کردن سرور فراهم می‌سازد. به سرورها می‌توان دستور داد تا سوکت‌های
کنترلی را که یک کانال ارتباطی است باز کنند. سرور قادر است دستورها را
روی این کانال دریافت کرده، آن‌ها را اجرا کند و وضعیت را گزارش دهد.
.sp
سرورهای DHCPv4، DHCPv6 و D2 دستورها را از طریق سوکت‌های دامنه یونیکس
(UNIX domain sockets) دریافت می‌کنند. برای جزئیات بیشتر در مورد نحوه پیکربندی
این سوکت‌ها، بخش‌های UNIX Control Socket \%<#\:dhcp4-unix-ctrl-channel>،
UNIX Control Socket \%<#\:dhcp6-unix-ctrl-channel> و
UNIX Control Socket \%<#\:d2-unix-ctrl-channel>\& را ببینید. در حالی
که امکان کنترل مستقیم سرورها با استفاده از سوکت‌های دامنه یونیکس وجود دارد،
اما این کار مستلزم آن است که کلاینت کنترل‌کننده روی همان ماشین سرور
در حال اجرا باشد. معمولاً از SSH برای اتصال از راه دور به ماشین تحت کنترل
استفاده می‌شود.
.sp
مدیران شبکه معمولاً ترجیح می‌دهند به جای استفاده مستقیم از سوکت‌های دامنه یونیکس،
از نوعی RESTful API برای کنترل سرورها بهره ببرند.
Kea نسخه ۳ سرورها را با سوکت‌های HTTP/HTTPS گسترش می‌دهد. برای جزئیات
درباره نحوه پیکربندی این سوکت‌ها، بخش‌های HTTP/HTTPS Control Socket \%<#\:dhcp4-http-ctrl-channel>،
HTTP/HTTPS Control Socket \%<#\:dhcp6-http-ctrl-channel> و
HTTP/HTTPS Control Socket \%<#\:d2-http-ctrl-channel>\& را ببینید.
.sp
اتصال‌های کنترلی بر روی هر دو سوکت‌ HTTP و دامنه یونیکس با زمان‌های انتظار (timeout)
محافظت می‌شوند. مقدار زمان انتظار روی ۱۰ ثانیه تنظیم شده و غیرقابل
پیکربندی است.
.sp
این API می‌تواند توسط ابزارهای خارجی برای مدیریت و پایش عملکرد Kea مورد استفاده
قرار گیرد. نمونه‌ای از این ابزارهای نظارتی، ISC Stork است. برای جزئیات،
بخش Monitoring Kea With Stork \%<#\:stork>\& را ببینید.
.SS ساختار داده‌ها (Data Syntax)
.sp
ارتباط از طریق کانال کنترلی با استفاده از ساختارهای JSON انجام می‌شود.
در صورت پیکربندی، Kea یک سوکت باز کرده و به اتصال‌های ورودی گوش می‌دهد.
فرآیندی که به این سوکت متصل می‌شود باید دستورهای JSON را با ساختاری مانند
زیر ارسال کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqfoo\(dq,
    \(dqarguments\(dq: {
        \(dqparam1\(dq: \(dqvalue1\(dq,
        \(dqparam2\(dq: \(dqvalue2\(dq,
        ...
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
همان دستور هنگامی که از طریق رابط RESTful به سرور ارسال می‌شود دارای
ساختار زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
POST / HTTP/1.1\er\en
Content\-Type: application/json\er\en
Content\-Length: 147\er\en\er\en
{
    \(dqcommand\(dq: \(dqfoo\(dq,
    \(dqarguments\(dq: {
        \(dqparam1\(dq: \(dqvalue1\(dq,
        \(dqparam2\(dq: \(dqvalue2\(dq,
        ...
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پارامتر \fBcommand\fP حاوی نام دستوری است که باید اجرا شود و وجود آن
اجباری است.
نگاشت \fBarguments\fP شامل پارامترهای مورد نیاز برای اجرای دستور داده‌شده
است. محتوا و قالب دقیق این نگاشت مختص هر دستور می‌باشد.
.sp
سروری که دستور ورودی را پردازش می‌کند، پاسخی به این شکل
ارسال می‌نماید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0, // 0|1|2|3|4
    \(dqtext\(dq: \(dqtextual description\(dq,
    \(dqarguments\(dq: {
        \(dqargument1\(dq: \(dqvalue1\(dq,
        \(dqargument2\(dq: \(dqvalue2\(dq,
        ...
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
مقدار \fBresult\fP یک کد وضعیت است که نتیجه دستور را نشان می‌دهد. کدهای
وضعیت عمومی زیر در حال حاضر پشتیبانی می‌شوند:
.INDENT 0.0
.IP \(bu 2
\fB0\fP \- دستور با موفقیت پردازش شده است.
.IP \(bu 2
\fB1\fP \- در حین پردازش دستور، یک خطا یا شکست عمومی رخ داده است.
.IP \(bu 2
\fB2\fP \- دستور مشخص‌شده توسط سرور دریافت‌کننده پشتیبانی نمی‌شود.
.IP \(bu 2
\fB3\fP \- عملیات درخواستی انجام شده است اما منبع درخواستی پیدا نشد.
این کد وضعیت زمانی بازگردانده می‌شود که یک دستور هیچ منبعی را بازنگرداند
یا بر هیچ منبعی تأثیر نگذارد.
.IP \(bu 2
\fB4\fP \- دستور خوش‌ساخت پردازش شده است اما تغییرات درخواستی اعمال نشد،
زیرا با وضعیت سرور یا درک آن از پیکربندی در تضاد بود.
.IP \(bu 2
\fB5\fP \- دستور پردازش‌شده با شکست مواجه شد و پیکربندی به طور جزئی
تغییر یافته است. سازوکار بازگردانی (rollback) قادر به بازگرداندن پیکربندی
قبلی نبود.
.UNINDENT
.sp
برای نمونه، یک دستور با ساختار صحیح که زیرشبکه‌ای موجود در پیکربندی سرور
را درخواست می‌کند، نتیجه 0 را بازمی‌گرداند. اگر سرور با وضعیت خطا مواجه شود،
1 را بازمی‌گرداند. اگر دستور یک زیرشبکه IPv6 را درخواست کند، اما به سرور
DHCPv4 ارسال شده باشد، نتیجه 2 خواهد بود. اگر پرس‌وجو به دنبال زیرشبکه‌ای
با \fBsubnet\-id\fP باشد که تطابقی دارد، نتیجه 3 است.
اگر دستور تلاش کند یک اجاره (lease) را به‌روزرسانی کند اما \fBsubnet\-id\fP
مشخص‌شده با شناسه موجود در پیکربندی سرور مطابقت نداشته باشد، نتیجه
4 خواهد بود.
.sp
کتابخانه‌های هوک (Hook libraries) گاهی اوقات می‌توانند کدهای وضعیت
بیشتری متناسب با شرایط استفاده خود بازگردانند.
.sp
فیلد \fBtext\fP معمولاً هنگامی ظاهر می‌شود که نتیجه غیرصفر باشد و حاوی
شرح خطای رخ‌داده است، اما اغلب برای نتایج موفقیت‌آمیز نیز نمایش می‌یابد.
متن دقیق مختص هر دستور است، اما به‌طور کلی از متن واضح انگلیسی برای توصیف
نتیجه دستور استفاده می‌کند. نگاشت \fBarguments\fP شامل مقادیر داده‌های اضافی
بازگردانده‌شده توسط سرور است که مختص دستور صادرشده می‌باشد. ممکن است
این نگاشت وجود داشته باشد، اما این به دستور مربوطه بستگی دارد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
از نسخه 1.9.7 Kea، همانند فایل پیکربندی، امکان قرار دادن کامنت
در دستورها نیز وجود دارد. برای نمونه:
.UNINDENT
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqfoo\(dq,
    # command arguments are here.
    \(dqarguments\(dq: {
        \(dqparam1\(dq: \(dqvalue1\(dq,
        ...
        /*
        \(dqparam2\(dq: \(dqvalue2\(dq,
        ...
        */
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
از نسخه 2.7.5 Kea، امکان تعیین سرآیندهای (headers) اضافی HTTP
که به پاسخ‌های HTTP افزوده می‌شوند، وجود دارد. هر سرآیند با نام
و مقدار خود و به‌صورت اختیاری یک زمینه کاربری (user context) مشخص می‌شود.
برای نمونه:
.UNINDENT
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqhttp\-headers\(dq: [
        {
            \(dqname\(dq: \(dqStrict\-Transport\-Security\(dq,
            \(dqvalue\(dq: \(dqmax\-age=31536000\(dq
        }
     ],
 ...
 }
.EE
.UNINDENT
.UNINDENT
.sp
یک سرآیند HSTS اضافه می‌کند که اعلام می‌دارد HTTPS (در مقایسه با HTTP) باید
به مدت یک سال استفاده شود..SS قالب پاسخ دستور HTTP
.sp
برای سازگاری با نسخه‌های پیشین با Control Agent منسوخ‌شده (حذف‌شده)،
پاسخ‌های دریافتی از طریق HTTP همواره درون یک آرایه (فهرست JSON)
تک‌عضوی قرار می‌گیرند.
.sp
برای نمونه، پاسخ برای یک دستور ارسال‌شده ساختاری به شرح زیر خواهد داشت:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[
    {
        \(dqresult\(dq: 0, // 0|1|2|3|4
        \(dqtext\(dq: \(dqtextual description\(dq,
        \(dqarguments\(dq: {
            \(dqargument1\(dq: \(dqvalue1\(dq,
            \(dqargument2\(dq: \(dqvalue2\(dq,
            ...
        }
    }
]
.EE
.UNINDENT
.UNINDENT
.sp
یک استثنا برای این مورد، خطاهای احراز هویت یا تعیین سطح دسترسی هستند که باعث
می‌شوند سرور دستور را به طور کامل رد کند. پاسخ به چنین خطایی در قالب
یک مدخل تکی (نگاشت JSON) به شرح زیر ساختاردهی می‌شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 403,
    \(dqtext\(dq: \(dqForbidden\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
این نوع خطاها روی سیستم‌هایی که برای احراز هویت اولیه (basic authentication) پیکربندی شده‌اند
یا سرورهایی که \fBlibdhcp_rbac.so\fP \%<#\:std-ischooklib-libdhcp_rbac\:.so>\& را بارگذاری می‌کنند، امکان‌پذیر است.
.SS استفاده از کانال کنترل
.sp
ساده‌ترین راه برای شروع تعامل با API کنترل، استفاده از ابزارهای
متداول UNIX/Linux مانند \fBsocat\fP و \fBcurl\fP است\&.
.sp
به منظور کنترل سرویس مورد نظر Kea از طریق یک UNIX domain socket،
از \fBsocat\fP در حالت تعاملی به شرح زیر استفاده کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ socat UNIX:/path/to/the/kea/socket \-
.EE
.UNINDENT
.UNINDENT
.sp
یا در حالت دسته‌ای (batch mode)، گزینه \(dqignoreeof\(dq را همانند زیر درج کنید
تا اطمینان حاصل شود \fBsocat\fP به اندازه کافی منتظر پاسخ سرور می‌ماند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ echo \(dq{ some command...}\(dq | socat UNIX:/path/to/the/kea/socket \-,ignoreeof
.EE
.UNINDENT
.UNINDENT
.sp
که در آن \fB/path/to/the/kea/socket\fP مسیری است که در پارامتر
\fBDhcp4/control\-socket/socket\-name\fP در فایل پیکربندی Kea مشخص شده است.
متن ارسال‌شده به \fBsocat\fP به Kea فرستاده می‌شود و پاسخ‌های دریافتی
از Kea در خروجی استاندارد چاپ می‌شوند. این روش به طور مستقیم با سرور مورد نظر ارتباط برقرار می‌کند.
.sp
همچنین باز کردن برنامه‌نویسی‌شده‌ی یک سوکت UNIX آسان است. نمونه‌ای از
یک کلاینت ساده که به زبان C نوشته شده است در Kea Developer\(aqs Guide، در
فصل Control Channel Overview و در بخش
Using Control Channel \%<https://\:reports\:.kea\:.isc\:.org/\:dev_guide/\:d2/\:d96/\:ctrlSocket\:.html#\:ctrlSocketClient>
در دسترس است.
.sp
برای استفاده از RESTful API نرم‌افزار Kea با \fBcurl\fP، دستور زیر را به کار ببرید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ curl \-X POST \-H \(dqContent\-Type: application/json\(dq \-d \(aq{ \(dqcommand\(dq: \(dqconfig\-get\(dq }\(aq http://kea.example.org:8000
.EE
.UNINDENT
.UNINDENT
.sp
این دستور فرض می‌کند که سرور روی میزبان
\fBkea.example.org\fP در حال اجرا بوده و سرویس RESTful را روی درگاه 8000 اجرا می‌کند.
.SS دستورهای پشتیبانی‌شده توسط هر دو سرور DHCPv4 و DHCPv6
.SS دستور \fBbuild\-report\fP
.sp
دستور \fBbuild\-report\fP همان چیزی را که آرگومان خط فرمان \fB\-W\fP
نمایش می‌دهد روی کانال کنترل بازمی‌گرداند؛ یعنی محتوای تعبیه‌شده در فایل
\fBconfig.report\fP. این دستور هیچ پارامتری دریافت نمی‌کند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqbuild\-report\(dq
}
.EE
.UNINDENT
.UNINDENT
.SS دستور \fBconfig\-get\fP
.sp
دستور \fBconfig\-get\fP پیکربندی فعلی مورد استفاده توسط سرور را بازیابی
می‌کند. این دستور هیچ پارامتری دریافت نمی‌کند. پیکربندی بازگردانده‌شده تقریباً
معادل پیکربندی است که با استفاده از گزینه خط فرمان \fB\-c\fP در زمان راه‌اندازی
سرور بارگذاری شده بود، یا بعداً با استفاده از دستور \fBconfig\-set\fP تنظیم شده
است. با این حال، ممکن است تفاوت‌های خاصی وجود داشته باشد، زیرا کامنت‌ها نگهداری
نمی‌شوند. اگر در پیکربندی اصلی از گنجاندن فایل (file inclusion) استفاده شده باشد،
پیکربندی بازگردانده‌شده شامل تمام پارامترها از همه فایل‌های گنجانده‌شده خواهد بود.
در Kea 2.4.0 و نسخه‌های بعدی، پاسخ موفقیت‌آمیز همچنین حاوی یک خلاصه (digest)
از نوع SHA\-256 است که می‌توان از آن برای تشخیص آسان تغییر پیکربندی استفاده کرد.
.sp
\fBهشدار:\fP
.INDENT 0.0
.INDENT 3.5
پیکربندی بازگردانده‌شده پنهان‌سازی (redact) نمی‌شود؛ یعنی اگر گذرواژه‌های
پایگاه داده در پیکربندی اصلی مشخص شده باشند، به صورت متن خام (plain text) خواهند بود.
باید دقت شود که کانال دستور در دسترس کاربران بدون امتیاز قرار نگیرد.
.UNINDENT
.UNINDENT
.sp
یک نمونه فراخوانی دستور به صورت زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqconfig\-get\(dq
}
.EE
.UNINDENT
.UNINDENT.SS دستور \fBconfig\-hash\-get\fP
.sp
دستور \fBconfig\-hash\-get\fP هش SHA\-256 پیکربندی فعلی مورد استفاده توسط کارگزار را بازیابی می‌کند. این دستور هیچ پارامتری دریافت نمی‌کند. هش بازگردانده‌شده می‌تواند برای تشخیص تغییرات پیکربندی استفاده شود.
.sp
نمونه‌ای از فراخوانی دستور به این صورت است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqconfig\-hash\-get\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
و پاسخ کارگزار:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqarguments\(dq: {
        \(dqhash\(dq: \(dq5C3C90EF7035249E2FF74D003C19F34EE0B83A3D329E741B52B2EF95A2C9CC5C\(dq
     }
 }
.EE
.UNINDENT
.UNINDENT
.sp
در Kea نسخه 2.4.0 و بالاتر، دستورهای \fBconfig\-set\fP و \fBconfig\-get\fP نیز هش SHA\-256 پیکربندی جدید یا فعلی را برمی‌گردانند. این ویژگی می‌تواند برای تشخیص اینکه آیا پیکربندی تغییر کرده است یا خیر استفاده شود.
.SS دستور \fBconfig\-reload\fP
.sp
دستور \fBconfig\-reload\fP به Kea فرمان می‌دهد که فایل پیکربندی قبلی را دوباره بارگذاری کند. این عملیات در صورتی مفید است که فایل پیکربندی توسط یک منبع خارجی تغییر کرده باشد؛ برای مثال، یک مدیر سیستم می‌تواند فایل پیکربندی را دستکاری کند و از این دستور برای واداشتن Kea به اعمال تغییرات استفاده نماید.
.sp
هنگام استفاده از این دستور همراه با دستور \fBconfig\-set\fP باید احتیاط کرد. Kea مکان فایل پیکربندی را که با آن راه‌اندازی شده بود به خاطر می‌سپارد، و این پیکربندی می‌تواند از طریق دستور \fBconfig\-set\fP دچار تغییرات چشمگیری شده باشد. هنگامی که \fBconfig\-reload\fP پس از \fBconfig\-set\fP صادر شود، Kea تلاش می‌کند پیکربندی اولیه خود را دوباره از فایل بارگذاری کند، که در نتیجه آن ممکن است تمام تغییرات اعمال‌شده از طریق \fBconfig\-set\fP یا سایر دستورها از دست برود.
.sp
دستور \fBconfig\-reload\fP هیچ پارامتری دریافت نمی‌کند. نمونه‌ای از فراخوانی دستور به این صورت است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqconfig\-reload\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر فایل پیکربندی نادرست باشد، بارگذاری مجدد آن می‌تواند منجر به بروز خطایی شود که کارگزار را در وضعیتی غیرقابل استفاده رها می‌کند. برای یادگیری نحوه بازیابی از وضعیت کارگزار از کار افتاده، به بخش دستور config\-set مراجعه کنید.
.SS دستور \fBconfig\-test\fP
.sp
دستور \fBconfig\-test\fP به کارگزار فرمان می‌دهد بررسی کند که آیا پیکربندی جدید ارائه‌شده در آرگومان‌های دستور قابل بارگذاری است یا خیر. انتظار می‌رود پیکربندی ارائه‌شده، پیکربندی کامل کارگزار مورد نظر به همراه پیکربندی اختیاری ثبات وقایع (logger) باشد. پیکربندی تا حد امکان بدون تلاش واقعی کارگزار برای بارگذاری آن اعتبارسنجی (sanity\-check) می‌شود؛ با این حال ممکن است پیکربندی‌ای که این دستور را با موفقیت پشت سر می‌گذارد، همچنان در دستور \fBconfig\-set\fP یا هنگام راه‌اندازی با خطا مواجه شود. ساختار دستور به صورت زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqconfig\-test\(dq,
    \(dqarguments\(dq:  {
        \(dq<server>\(dq: {
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
که در آن <server> نام مؤلفه پیکربندی برای یک کارگزار معین، مانند \(dqDhcp4\(dq یا \(dqDhcp6\(dq است. برای مثال:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqconfig\-test\(dq,
    \(dqarguments\(dq:  {
        \(dqDhcp6\(dq: {
            ...
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ کارگزار شامل یک کد عددی به نام \fBresult\fP (صفر برای موفقیت، غیر صفر در صورت شکست)، و یک رشته به نام \fBtext\fP است که نتیجه را شرح می‌دهد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{ \(dqresult\(dq: 0, \(dqtext\(dq: \(dqConfiguration seems sane...\(dq }

یا

{ \(dqresult\(dq: 1, \(dqtext\(dq: \(dqunsupported parameter: BOGUS (<string>:16:26)\(dq }
.EE
.UNINDENT
.UNINDENT.SS دستور \fBconfig\-write\fP
.sp
دستور \fBconfig\-write\fP به کارساز Kea اعلام می‌کند که پیکربندی فعلی خود را درون فایلی روی دیسک بنویسد. این دستور یک آرگومان اختیاری به نام \(dqfilename\(dq می‌پذیرد که نام فایل مقصد برای نوشتن پیکربندی را مشخص می‌کند. در صورت عدم تعیین، از نام استفاده‌شده در هنگام راه‌اندازی Kea (که به عنوان آرگومان \fB\-c\fP داده شده است) استفاده می‌شود. اگر یک مسیر نسبی تعیین شود، Kea فایل‌های خود را فقط در دایرکتوری محل اجرای خود می‌نویسد.
.sp
یک نمونه از فراخوانی دستور به شکل زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqconfig\-write\(dq,
    \(dqarguments\(dq: {
        \(dqfilename\(dq: \(dqconfig\-modified\-2017\-03\-15.json\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
از نسخه 2.7.9 Kea به بعد، فایل پیکربندی تنها می‌تواند در همان دایرکتوری فایل پیکربندی اولیه استفاده‌شده هنگام راه‌اندازی Kea (که به عنوان آرگومان \fB\-c\fP داده شده است) نوشته شود.
.UNINDENT
.UNINDENT
.SS دستور \fBleases\-reclaim\fP
.sp
دستور \fBleases\-reclaim\fP به کارساز دستور می‌دهد که تمام اجاره‌های منقضی‌شده را فوراً بازپس‌گیری کند. این دستور ساختار نحوی JSON زیر را دارد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqleases\-reclaim\(dq,
    \(dqarguments\(dq: {
        \(dqremove\(dq: true
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پارامتر بولی \fBremove\fP اجباری است و مشخص می‌کند که آیا اجاره‌های بازپس‌گرفته‌شده باید از پایگاه‌داده اجاره‌ها حذف شوند (در صورت \fBtrue\fP)، یا در وضعیت \fBexpired\-reclaimed\fP باقی بمانند (در صورت \fBfalse\fP). حالت دوم قابلیت وابستگی اجاره (lease affinity) را تسهیل می‌کند؛ یعنی امکان تخصیص مجدد یک اجاره منقضی‌شده به یک کلاینت بازگشتی که پیش‌تر از آن اجاره استفاده می‌کرده است. برای جزئیات به Configuring Lease Affinity \%<#\:lease-affinity> مراجعه کنید. همچنین، برای اطلاعات عمومی درباره پردازش اجاره‌های منقضی‌شده (بازپس‌گیری اجاره)، به Lease Reclamation \%<#\:lease-reclamation> مراجعه نمایید.
.SS دستور \fBinterface\-add\fP
.sp
دستور \fBinterface\-add\fP فهرست رابط‌های استفاده‌شده برای پردازش ترافیک DHCP را به‌روزرسانی می‌کند.
این دستور فهرستی از رابط‌ها را به همراه آدرس‌های مربوطه (در صورت تعیین) که کارساز باید شنود ترافیک DHCP را روی آن‌ها آغاز کند، به عنوان پارامتر دریافت می‌کند. اگر مدخل‌های تکراری در فهرست دستور وجود داشته باشند یا مدخل‌های موجود در پیکربندی در حال اجرا را تکرار کنند، این مدخل‌ها هیچ تأثیری بر پیکربندی جدید نخواهند داشت.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این دستور تنها می‌تواند به فهرست موجود رابط‌ها اضافه کند.
هیچ راهی برای حذف یک رابط پس از اضافه شدن آن و شروع شنود ترافیک DHCP توسط کارساز وجود ندارد.
.UNINDENT
.UNINDENT
.sp
لطفاً توجه داشته باشید که پیکربندی جدید تنها در حافظه نگهداری می‌شود؛ اگر کارساز بازراه‌اندازی شود یا بارگذاری مجدد پیکربندی از طریق یک سیگنال صورت گیرد، کارساز از پیکربندی ذخیره‌شده در فایل پیکربندی خود استفاده خواهد کرد. پاسخ کارساز شامل یک کد عددی، \fBresult\fP (۰ برای موفقیت و غیر صفر برای شکست)، و یک رشته، \fBtext\fP، است که نتیجه را توصیف می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{ \(dqresult\(dq: 0, \(dqtext\(dq: \(dqInterface configuration successfully updated.\(dq }
.EE
.UNINDENT
.UNINDENT
.sp
پیکربندی به‌روزرسانی‌شده همچنین می‌تواند با استفاده از دستور \fBconfig\-get\fP (درون مپ پیکربندی \(dqinterfaces\-config\(dq) بازیابی شود.
.SS دستور \fBinterface\-list\fP
.sp
دستور \fBinterface\-list\fP فهرست رابط‌های شناسایی‌شده را بازیابی می‌کند.
این دستور هیچ پارامتری نمی‌پذیرد.
.SS دستور \fBinterface\-redetect\fP
.sp
دستور \fBinterface\-redetect\fP پس از اجرای یک روند شناسایی مجدد که تنها رابط‌ها و آدرس‌های جدیداً کشف‌شده را اضافه می‌کند، بدون آنکه رابط‌ها یا آدرس‌های شناسایی‌شده قبلی را حذف کند، فهرست رابط‌های شناسایی‌شده را بازیابی می‌نماید.
این دستور هیچ پارامتری دریافت نمی‌کند.\(dq
.SS دستور \fBlist\-commands\fP
.sp
دستور \fBlist\-commands\fP فهرستی از تمام دستورهای پشتیبانی‌شده توسط کارساز را بازیابی می‌کند. این دستور هیچ آرگومانی نمی‌پذیرد. یک نمونه فراخوانی ممکن است به شکل زیر باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqlist\-commands\(dq,
    \(dqarguments\(dq: { }
}
.EE
.UNINDENT
.UNINDENT
.sp
کارساز با فهرستی از تمامی دستورهای پشتیبانی‌شده پاسخ می‌دهد. عنصر arguments فهرستی از رشته‌ها است که هر کدام نشان‌دهنده یک دستور پشتیبانی‌شده است..SS دستور \fBconfig\-set\fP
.sp
دستور \fBconfig\-set\fP به سرور اعلام می‌کند که پیکربندی فعلی خود را با
پیکربندی جدید ارائه‌شده در آرگومان‌های دستور جایگزین کند. انتظار می‌رود
پیکربندی ارائه‌شده، پیکربندی کامل سرور مورد نظر به همراه پیکربندی
اختیاری ثبات وقایع (logger) باشد. اگرچه پیکربندی logger اختیاری است،
اکیداً توصیه می‌شود؛ چرا که بدون آن سرور به پیکربندی پیش‌فرض ثبت وقایع
خود بازمی‌گردد. ساختار دستور به شرح زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqconfig\-set\(dq,
    \(dqarguments\(dq:  {
        \(dq<server>\(dq: {
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
که در آن <server> نام مؤلفه پیکربندی برای یک سرور مشخص است،
مانند \(dqDhcp4\(dq یا \(dqDhcp6\(dq. برای مثال:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqconfig\-set\(dq,
    \(dqarguments\(dq:  {
        \(dqDhcp6\(dq: {
            ...
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
چنانچه نامعتبر بودن پیکربندی جدید محرز شود، سرور پیکربندی فعلی
خود را حفظ می‌کند؛ با این حال، در برخی موارد یک پیام خطای مهلک ثبت
می‌شود که نشان می‌دهد سرور دیگر هیچ سرویسی ارائه نمی‌دهد: در این شرایط
باید در اسرع وقت یک پیکربندی کارآمد بارگذاری شود. در صورتی که
کانال کنترل (control channel) از کار افتاده باشد، همچنان می‌توان
با استفاده از سیگنال \fBSIGHUP\fP فایل پیکربندی را مجدداً بارگذاری کرد.
اگر این روش نیز ناموفق بود، سرور را مجدداً راه‌اندازی کنید.
.sp
لطفاً توجه داشته باشید که پیکربندی جدید تنها در حافظه نگه‌داری
می‌شود؛ اگر سرور مجدداً راه‌اندازی شود یا بارگذاری مجدد پیکربندی
از طریق یک سیگنال فعال گردد، سرور از پیکربندی ذخیره‌شده در فایل
پیکربندی خود استفاده خواهد کرد. پاسخ سرور شامل یک کد عددی به نام
\fBresult\fP (صفر برای موفقیت، و مقداری غیر صفر در صورت شکست) و یک
رشته متنی به نام \fBtext\fP است که نتیجه را شرح می‌دهد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{ \(dqresult\(dq: 0, \(dqtext\(dq: \(dqConfiguration successful.\(dq }

یا

{ \(dqresult\(dq: 1, \(dqtext\(dq: \(dqunsupported parameter: BOGUS (<string>:16:26)\(dq }
.EE
.UNINDENT
.UNINDENT
.sp
در Kea 2.4.0 و نسخه‌های بعدی، پاسخ موفقیت‌آمیز دریافتی از دیمن‌های
DHCPv4، DHCPv6، یا DHCP\-DDNS همچنین حاوی یک خلاصه درهم‌ساز (digest)
از نوع SHA\-256 از پیکربندی جدید اعمال‌شده است. از این خلاصه می‌توان
به‌سادگی برای تشخیص اینکه آیا پیکربندی تغییر کرده است یا خیر استفاده کرد.
.SS دستور \fBshutdown\fP
.sp
دستور \fBshutdown\fP به سرور دستور می‌دهد تا روال خاموش شدن خود را
آغاز کند؛ این دستور معادل ارسال سیگنال \fBSIGTERM\fP به فرایند است.
این دستور هیچ آرگومانی نمی‌پذیرد. یک نمونه دستور ممکن است به شکل
زیر باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqshutdown\(dq,
    \(dqarguments\(dq: {
        \(dqexit\-value\(dq: 3
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
سرور با تأییدیه‌ای مبنی بر آغاز شدن فرایند خاموش‌سازی پاسخ می‌دهد.
پارامتر اختیاری \fBexit\-value\fP مقدار عددی خروج فرایند سرور به سیستم را
مشخص می‌کند. مقدار پیش‌فرض صفر است.
.sp
دیمن DDNS از یک پارامتر اضافی به نام \fBtype\fP پشتیبانی می‌کند که نحوه
پاک‌سازی فرایند هنگام خروج را کنترل می‌نماید. حالت‌های خاموش‌سازی
پشتیبانی‌شده عبارتند از:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
\(dqnormal\(dq \- مدیر صف را متوقف کرده و قبل از خروج، تمامی تراکنش‌های جاری را به پایان می‌رساند. این حالت پیش‌فرض است.
.IP \(bu 2
\(dqdrain_first\(dq \- مدیر صف را متوقف می‌کند، اما به پردازش درخواست‌های درون صف تا خالی شدن کامل آن ادامه می‌دهد.
.IP \(bu 2
\(dqnow\(dq \- فوراً خارج می‌شود.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
یک نمونه دستور ممکن است به این صورت باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqshutdown\(dq,
    \(dqarguments\(dq: {
        \(dqexit\-value\(dq: 3,
        \(dqtype\(dq: \(dqdrain_first\(dq
    }
}
.EE
.UNINDENT
.UNINDENT.SS دستور \fBdhcp\-disable\fP
.sp
دستور \fBdhcp\-disable\fP سرویس DHCP را به‌طور سراسری غیرفعال می‌کند.
کارکرد کارساز ادامه می‌یابد، اما تمام پیام‌های دریافتی DHCP را دور می‌اندازد (drop می‌کند).
این دستور زمانی مفید است که نگهداری کارساز مستلزم آن باشد که کارساز موقتاً
تخصیص اجاره‌های جدید و تمدید اجاره‌های موجود را متوقف کند.
همچنین در پیکربندی‌های مشابه failover در طول همگام‌سازی پایگاه‌های داده اجاره
هنگام راه‌اندازی، یا بازیابی پس از خرابی مفید است. پارامتر اختیاری \fBmax\-period\fP
مدت زمان بر حسب ثانیه را مشخص می‌کند که پس از آن سرویس DHCP باید به‌طور خودکار
دوباره فعال شود، چنانچه دستور \fBdhcp\-enable\fP پیش از سپری شدن این زمان ارسال نشده باشد.
.sp
از Kea 1.9.4، یک پارامتر اضافی به نام \fBorigin\fP وجود دارد که منبع دستور را
مشخص می‌کند. مدیر کارساز معمولاً باید این پارامتر را نادیده بگیرد، زیرا مقدار پیش‌فرض
\(dquser\(dq نشان‌دهنده آن است که مدیر دستور را ارسال کرده است. در Kea نسخه ۲.۵.۵
تا ۲.۵.۷، این پارامتر همچنین در ارتباط میان شرکای HA برای مشخص کردن شناسه سرویس HA
ارسال‌کننده دستور در قالب عددی به کار می‌رفت. با این حال، به دلیل مسائل سازگاری با
نسخه‌های قدیمی‌تر Kea که مقادیر عددی را به‌درستی تجزیه نمی‌کردند، معرفی پارامتر
جدید \fBorigin\-id\fP در Kea 2.5.8 ضروری شد.
.sp
این پارامتر حاوی یک مقدار عددی است که منشأ دستور را نشان می‌دهد. همان مقدار را همچنان
می‌توان با استفاده از پارامتر \fBorigin\fP ارسال کرد، اما ممکن است باعث مسائل سازگاری
یادشده میان شرکای HA با نسخه‌های متفاوت Kea شود؛ اگر از هر دو استفاده شود،
\fBorigin\-id\fP اولویت دارد. نسخه‌های جدید Kea استفاده از \fBorigin\-id\fP را در ارتباط
میان شرکای HA ترجیح می‌دهند، اما در کل توصیه می‌شود هر دو پارامتر نادیده گرفته شوند
و از مقدار پیش‌فرض استفاده شود.
.sp
کدهای زیر منشأهای پشتیبانی‌شده را در قالب عددی نشان می‌دهند:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
\fB1\fP \- یک دستور کاربری؛ معادل با تعیین \fB\(dqorigin\(dq: \(dquser\(dq\fP\&.
.IP \(bu 2
\fB2000\fP، \fB2001\fP، \fB2002\fP و غیره \- منشأهای تعیین‌شده توسط شرکای HA که در آن
مقادیر افزایشی بالای \fB2000\fP، شناسه‌های متمایز سرویس HA هستند که در صورت وجود روابط
متعدد میان شرکا استفاده می‌شوند.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
در مثال زیر:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqdhcp\-disable\(dq,
    \(dqarguments\(dq: {
        \(dqmax\-period\(dq: 20,
        \(dqorigin\-id\(dq: 2002,
        \(dqorigin\(dq: \(dquser\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
منشأ مؤثر \fB2002\fP است، که نشان می‌دهد یکی از شرکای HA در حال ارسال دستور
برای سرویسی با شناسه \fB2\fP است. در این حالت، پارامتر \fBorigin\fP نادیده
گرفته خواهد شد.
.SS دستور \fBdhcp\-enable\fP
.sp
دستور \fBdhcp\-enable\fP سرویس DHCP را به‌طور سراسری فعال می‌کند.
.sp
از Kea 1.9.4، یک پارامتر اضافی به نام \fBorigin\fP وجود دارد که منبع دستور را
مشخص می‌کند. مدیر کارساز معمولاً باید این پارامتر را نادیده بگیرد، زیرا مقدار پیش‌فرض
\(dquser\(dq نشان می‌دهد که مدیر دستور را ارسال کرده است. در Kea نسخه ۲.۵.۵
تا ۲.۵.۷، این پارامتر همچنین در ارتباط میان شرکای HA برای مشخص کردن شناسه سرویس HA
ارسال‌کننده دستور در قالب عددی استفاده می‌شد. با این حال، به دلیل مسائل سازگاری با
نسخه‌های قدیمی‌تر Kea که مقادیر عددی را به‌درستی تجزیه نمی‌کردند، معرفی پارامتر
جدید \fBorigin\-id\fP در Kea 2.5.8 ضروری شد.
.sp
این پارامتر حاوی یک مقدار عددی است که منشأ دستور را نشان می‌دهد. همان مقدار را همچنان
می‌توان با استفاده از پارامتر \fBorigin\fP ارسال کرد، اما می‌تواند باعث ایجاد مسائل
سازگاری یادشده میان شرکای HA با نسخه‌های متفاوت Kea شود؛ اگر از هر دو استفاده شود،
\fBorigin\-id\fP اولویت دارد. نسخه‌های جدید Kea استفاده از \fBorigin\-id\fP را در ارتباط
میان شرکای HA ترجیح می‌دهند، اما در کل توصیه می‌شود هر دو پارامتر نادیده گرفته شوند
و از مقدار پیش‌فرض استفاده شود.
.sp
کدهای زیر منشأهای پشتیبانی‌شده را در قالب عددی نشان می‌دهند:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
\fB1\fP \- یک دستور کاربری؛ معادل با تعیین \fB\(dqorigin\(dq: \(dquser\(dq\fP\&.
.IP \(bu 2
\fB2000\fP، \fB2001\fP، \fB2002\fP و غیره \- منشأهای تعیین‌شده توسط شرکای HA که در آن
مقادیر افزایشی بالای \fB2000\fP، شناسه‌های متمایز سرویس HA هستند که در صورت وجود روابط
متعدد میان شرکا استفاده می‌شوند.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
در مثال زیر:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqdhcp\-enable\(dq,
    \(dqarguments\(dq: {
        \(dqorigin\-id\(dq: 2002,
        \(dqorigin\(dq: \(dquser\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
منشأ مؤثر \fB2002\fP است، که نشان می‌دهد یکی از شرکای HA در حال ارسال دستور
برای سرویسی با شناسه \fB2\fP است. در این حالت، پارامتر \fBorigin\fP نادیده
گرفته خواهد شد.
.SS دستور \fBstatus\-get\fP
.sp
دستور \fBstatus\-get\fP اطلاعات زمان اجرای کارساز را برمی‌گرداند:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
\fBpid\fP: شناسه فرایند (PID).
.IP \(bu 2
\fBuptime\fP: تعداد ثانیه‌های سپری‌شده از زمان شروع به کار کارساز.
.IP \(bu 2
\fBreload\fP: تعداد ثانیه‌های سپری‌شده از آخرین بارگذاری (مجدد) پیکربندی.
.IP \(bu 2
\fBhigh\-availability\fP: اطلاعات وضعیت مختص HA درباره کارسازهای DHCP
پیکربندی‌شده برای استفاده از کتابخانه قلاب (hook) مربوط به HA:
.INDENT 2.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
\fBlocal\fP: وضعیت، نقش (primary، secondary و...)، و دامنه‌های
(یعنی آنچه کارساز عملاً در حال پردازش آن است) کارساز محلی.
.IP \(bu 2
\fBremote\fP: آخرین وضعیت شناخته‌شده کارساز دوردست، دامنه‌های HA
ارائه‌شده توسط آن، و نقش کارساز دوردست در رابطه HA.
.UNINDENT
.UNINDENT
.UNINDENT
.IP \(bu 2
\fBmulti\-threading\-enabled\fP: پرچمی که نشان می‌دهد آیا چندنخی فعال است یا خیر.
.IP \(bu 2
\fBthread\-pool\-size\fP: تعداد نخ‌های سرویس DHCP.
.IP \(bu 2
\fBpacket\-queue\-size\fP: حداکثر اندازه صف بسته‌ها. صرف‌نظر از تعداد
نخ‌های در حال اجرا، تنها یک صف وجود دارد.
.IP \(bu 2
\fBpacket\-queue\-statistics\fP: میانگین اندازه صف برای ۱۰، ۱۰۰ و ۱۰۰۰ بسته
آخر، با استفاده از رویکردی مشابه با دستور \fBtop\fP در UNIX.
میانگین اندازه صف برای ۱۰ بسته آخر را می‌توان یک مقدار لحظه‌ای در نظر گرفت،
در حالی که میانگین برای ۱۰۰۰ بسته آخر روندی بلندمدت‌تر را نشان می‌دهد.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
اطلاعات \fBhigh\-availability\fP تنها زمانی بازگردانده می‌شود که دستور
به کارسازهای DHCP در یک راه‌اندازی HA ارسال شود. این پارامتر هنگامی که
دستور \fBstatus\-get\fP به دیمن DDNS ارسال شود، هرگز بازگردانده نمی‌شود.
.sp
پارامترهای \fBthread\-pool\-size\fP، \fBpacket\-queue\-size\fP و
\fBpacket\-queue\-statistics\fP تنها زمانی بازگردانده می‌شوند که دستور
به کارسازهای DHCP با چندنخی فعال ارسال شود. این سه پارامتر و
\fBmulti\-threading\-enabled\fP هرگز هنگامی که دستور \fBstatus\-get\fP
به دیمن DDNS ارسال شود، بازگردانده نمی‌شوند.
.sp
برای کسب اطلاعات بیشتر درباره وضعیت HA بازگردانده‌شده توسط دستور
\fBstatus\-get\fP، لطفاً به بخش دستور status\-get \%<#\:command-ha-status-get>
مراجعه کنید..SS دستور \fBserver\-tag\-get\fP:
.sp
دستور \fBserver\-tag\-get\fP برچسب کارگزار (server tag) پیکربندی‌شده برای
کارگزار DHCPv4 یا DHCPv6 را بازمی‌گرداند (بخش Configuration Sharing and Server Tags \%<#\:cb-sharing> مفهوم server tag را شرح می‌دهد).
.SS دستور \fBconfig\-backend\-pull\fP:
.sp
دستور \fBconfig\-backend\-pull\fP بررسی دوره‌ای (polling) بک‌اندهای پیکربندی را آغاز می‌کند
(که برای اثربخشی این دستور باید پیکربندی شده باشند)،
همان‌طور که در Enabling the Configuration Backend \%<#\:dhcp4-cb-json>\& توضیح داده شده است.
.SS دستور \fBversion\-get\fP
.sp
دستور \fBversion\-get\fP اطلاعات گسترش‌یافته‌ای را دربارهٔ نسخهٔ Kea
بازمی‌گرداند؛ این همان اطلاعاتی است که از طریق آرگومان
خط فرمان \fB\-V\fP در دسترس است. این دستور هیچ پارامتری دریافت نمی‌کند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqversion\-get\(dq
}
.EE
.UNINDENT
.UNINDENT
.SS دستور \fBkea\-lfc\-start\fP
.sp
دستور \fBkea\-lfc\-start\fP فرایند \fBkea\-lfc\fP را آغاز می‌کند که
فایل اجاره‌ها را پاک‌سازی می‌نماید (بخش The LFC Process \%<#\:kea-lfc> را ببینید). این دستور هیچ آرگومانی نمی‌پذیرد و
در مواردی که بک‌اند اجاره \fBmemfile\fP نباشد، پارامتر
\fBpersist\fP در \fBlease\-database\fP روی
\fBfalse\fP پیکربندی شده باشد (اما نه زمانی که \fBlfc\-interval\fP برابر با \fB0\fP است)، تشخیص دهد
که یک فرایند LFC در حال حاضر در حال اجرا است، یا خطایی مانع از آغاز یک فرایند LFC جدید
شود، وضعیت موفقیت‌آمیز را برنمی‌گرداند.
.SS دستورهای پشتیبانی‌شده توسط کارگزار DHCPv4
.SS دستور \fBsubnet4\-select\-test\fP
.sp
دستور \fBsubnet4\-select\-test\fP روشی را برای آزمایش انتخاب زیرشبکهٔ DHCPv4 بر اساس
مجموعه‌ای از پارامترهای ورودی فراهم می‌کند که معمولاً در بستهٔ کارخواه ارائه می‌شوند.
پارامترهای شناخته‌شده رشته دریافت می‌کنند و عبارتند از:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
\fBinterface\fP \- نام رابط ورودی
.IP \(bu 2
\fBaddress\fP \- نشانی کارخواه
.IP \(bu 2
\fBrelay\fP \- نشانی رله/دروازه
.IP \(bu 2
\fBlocal\fP \- نشانی محلی/مقصد
.IP \(bu 2
\fBremote\fP \- نشانی دوردست/مبدأ
.IP \(bu 2
\fBlink\fP \- نشانی link\-selection مربوط به RAI
.IP \(bu 2
\fBsubnet\fP \- نشانی subnet\-selection
.IP \(bu 2
\fBclasses\fP \- (فهرستی از رشته‌ها) کلاس‌های کارخواه (جهت امکان انتخاب یک زیرشبکهٔ حفاظت‌شده)
.UNINDENT
.UNINDENT
.UNINDENT
.sp
هنگامی که پرچم سازگاری \fBignore\-rai\-link\-selection\fP
برابر با \fBtrue\fP باشد، RAI link\-selection نادیده گرفته می‌شود\&. هنگامی که نادیده گرفته نشود، نسبت
به subnet\-selection اولویت دارد.
.sp
صرف‌نظر از خطاها، نتایج احتمالی عبارتند از:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
(خالی) \(dqno selected subnet\(dq
.IP \(bu 2
\(dqselected shared network \(aq<name>\(aq starting with subnet \(aq<subnet>\(aq id <id>\(dq
.IP \(bu 2
\(dqselected subnet \(aq<subnet>\(aq id <id>\(dq
.UNINDENT
.UNINDENT
.UNINDENT
.SS دستور \fBsubnet4o6\-select\-test\fP
.sp
دستور \fBsubnet4o6\-select\-test\fP روشی را برای آزمایش انتخاب زیرشبکهٔ
DHCPv4\-over\-DHCPv6 بر اساس مجموعه‌ای از پارامترهای ورودی فراهم می‌کند که معمولاً در بستهٔ
کارخواه ارائه می‌شوند. پارامترهای شناخته‌شده رشته دریافت می‌کنند و عبارتند از:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
\fBinterface\fP \- نام رابط ورودی کارگزار DHCPv6
.IP \(bu 2
\fBinterface\-id\fP \- محتوای دودویی گزینهٔ رلهٔ interface\-id
.IP \(bu 2
\fBaddress\fP \- نشانی کارخواه
.IP \(bu 2
\fBrelay\fP \- نشانی رله/دروازه
.IP \(bu 2
\fBlocal\fP \- نشانی محلی/مقصد
.IP \(bu 2
\fBremote\fP \- نشانی IPv6 دوردست/مبدأ کارگزار DHCPv6
.IP \(bu 2
\fBlink\fP \- نشانی IPv6 اولین پیوند رله
.IP \(bu 2
\fBsubnet\fP \- نشانی subnet\-selection
.IP \(bu 2
\fBclasses\fP \- (فهرستی از رشته‌ها) کلاس‌های کارخواه (جهت امکان انتخاب یک زیرشبکهٔ حفاظت‌شده)
.UNINDENT
.UNINDENT
.UNINDENT
.sp
طبق کد، تنها گزینش‌گرهای \fBremote\fP، \fBinterface\-id\fP و \fBinterface\fP
استفاده می‌شوند. در پیاده‌سازی DHCPv4\-over\-DHCPv6 مقادیر \fBinterface\fP و
\fBremote\fP از کارگزار DHCPv6 منتقل می‌شوند، \fBinterface\-id\fP
و \fBlink\fP در بخش اطلاعات رلهٔ بستهٔ DHCPv6 حمل می‌شوند و در نتیجه
مانند کارگزار DHCPv6 هستند.
.sp
صرف‌نظر از خطاها، نتایج احتمالی عبارتند از:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
(خالی) \(dqno selected subnet\(dq
.IP \(bu 2
\(dqselected shared network \(aq<name>\(aq starting with subnet \(aq<subnet>\(aq id <id>\(dq
.IP \(bu 2
\(dqselected subnet \(aq<subnet>\(aq id <id>\(dq
.UNINDENT
.UNINDENT
.UNINDENT.SS دستورات پشتیبانی‌شده توسط کارساز DHCPv6
.SS دستور \fBsubnet6\-select\-test\fP
.sp
دستور \fBsubnet6\-select\-test\fP روشی را برای آزمایش انتخاب زیرشبکه DHCPv6 بر اساس مجموعه‌ای از پارامترهای ورودی که معمولاً در بسته کارخواه (client) ارائه می‌شوند، فراهم می‌کند.
پارامترهای شناخته‌شده رشته می‌پذیرند و عبارتند از:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
\fBinterface\fP \- نام رابط ورودی
.IP \(bu 2
\fBinterface\-id\fP \- محتوای دودویی گزینه بازپخش (relay) مربوط به interface\-id
.IP \(bu 2
\fBremote\fP \- نشانی دوردست/مبدأ
.IP \(bu 2
\fBlink\fP \- نخستین نشانی پیوند رله
.IP \(bu 2
\fBclasses\fP \- (فهرستی از رشته‌ها) کلاس‌های کارخواه (جهت امکان انتخاب یک زیرشبکه محافظت‌شده)
.UNINDENT
.UNINDENT
.UNINDENT
.sp
جدا از خطاها، نتایج احتمالی عبارتند از:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
(خالی) \(dqno selected subnet\(dq
.IP \(bu 2
\(dqselected shared network \(aq<name>\(aq starting with subnet \(aq<subnet>\(aq id <id>\(dq
.IP \(bu 2
\(dqselected subnet \(aq<subnet>\(aq id <id>\(dq
.UNINDENT
.UNINDENT
.UNINDENT
.SS دستورات پشتیبانی‌شده توسط کارساز D2
.sp
کارساز D2 تنها از زیرمجموعه‌ای از دستورات کارسازهای DHCPv4/DHCPv6 پشتیبانی می‌کند:
.INDENT 0.0
.IP \(bu 2
\fBbuild\-report\fP
.IP \(bu 2
\fBconfig\-get\fP
.IP \(bu 2
\fBconfig\-hash\-get\fP
.IP \(bu 2
\fBconfig\-reload\fP
.IP \(bu 2
\fBconfig\-set\fP
.IP \(bu 2
\fBconfig\-test\fP
.IP \(bu 2
\fBconfig\-write\fP
.IP \(bu 2
\fBlist\-commands\fP
.IP \(bu 2
\fBshutdown\fP
.IP \(bu 2
\fBstatus\-get\fP
.IP \(bu 2
\fBversion\-get\fP
.UNINDENT
.SS مهاجرت از Control Agent منسوخ‌شده (حذف‌شده)
.sp
از نسخه 2.7.2 Kea، کارسازهای DHCP از کانال‌های کنترلی HTTP/HTTPS پشتیبانی می‌کنند؛ بنابراین به Control Agent (CA) دیگر نیازی نیست، و از نسخه 3.1.8 Kea، این مؤلفه (CA) به‌طور کامل حذف شده است.
.sp
کارسازهای DHCPv4، DHCPv6 و D2 مدخل \fBcontrol\-socket\fP را به فهرست \fBcontrol\-sockets\fP گسترش داده‌اند. برای مهاجرت پیکربندی CA، عنصری را با مشخصات زیر به این فهرست اضافه کنید:
.INDENT 0.0
.IP \(bu 2
\fBsocket\-type\fP تنظیم‌شده روی \fBhttp\fP یا \fBhttps\fP
.IP \(bu 2
\fBsocket\-address\fP با محتوای \fBhttp\-host\fP مربوط به CA
.IP \(bu 2
\fBsocket\-port\fP با محتوای \fBhttp\-port\fP مربوط به CA
.IP \(bu 2
\fBtrust\-anchor\fP (بدون تغییر)
.IP \(bu 2
\fBcert\-file\fP (بدون تغییر)
.IP \(bu 2
\fBkey\-file\fP (بدون تغییر)
.IP \(bu 2
\fBcert\-required\fP (بدون تغییر)
.IP \(bu 2
\fBauthentication\fP (بدون تغییر)
.UNINDENT
.sp
بافتار کاربر (User context) نیز پشتیبانی می‌شود. لطفاً برای مقادیر پیش‌فرض و سایر جزئیات، بخش‌های مربوط به سوکت کنترلی HTTP را ببینید:
سوکت کنترلی HTTP/HTTPS برای DHCP4 \%<#\:dhcp4-http-ctrl-channel>، سوکت کنترلی HTTP/HTTPS برای DHCP6 \%<#\:dhcp6-http-ctrl-channel> و سوکت کنترلی HTTP/HTTPS برای DHCP\-DDNS \%<#\:d2-http-ctrl-channel>\&.
.sp
توجه داشته باشید که دو کارساز باید از جفت‌های نشانی / درگاه متفاوتی استفاده کنند. این قاعده برای شنوندگان HA نیز صدق می‌کند.
.sp
به‌منظور حفظ سازگاری، نتیجه JSON این سوکت‌های کنترلی HTTP/HTTPS همچنان درون یک فهرست کپسوله‌سازی می‌شود.
.SH "ثبت وقایع (LOGGING)"
.SS پیکربندی ثبت وقایع
.sp
در طول اجرای برنامه، Kea ممکن است پیام‌های ثبتی (log) متعددی ایجاد کند. این پیام‌ها از نظر سطح اهمیت (برخی مهم‌تر از بقیه هستند) و منبع تولید (مؤلفه‌های مختلف، مانند قلاب‌ها، پیام‌های متفاوتی صادر می‌کنند) فرق دارند. آگاهی از اینکه کدام پیام‌ها حیاتی و کدام غیرحیاتی هستند و پیکربندی متناسب سازوکار ثبت وقایع بسیار مفید است. برای نمونه، پیام‌های سطح اشکال‌زدایی (debug\-level) را می‌توان با اطمینان در یک استقرار عادی نادیده گرفت. هرچند، این پیام‌ها هنگام عیب‌یابی یک مشکل بسیار کارآمد هستند.
.sp
سامانه ثبت وقایع در Kea از طریق مدخل \fBloggers\fP در بخش server فایل پیکربندی تنظیم می‌شود.
.SS ثبت‌کننده‌ها (Loggers)
.sp
در Kea، پیام‌ها از طریق موجودیتی موسوم به \(dqlogger\(dq (ثبت‌کننده) ثبت می‌شوند. مؤلفه‌های گوناگون پیام‌ها را از طریق ثبت‌کننده‌های مختلفی به ثبت می‌رسانند و هر ثبت‌کننده می‌تواند مستقل از سایرین پیکربندی شود. برخی از مؤلفه‌ها، به‌ویژه فرایندهای کارساز DHCP، ممکن است از چندین ثبت‌کننده جهت ثبت پیام‌های مربوط به بخش‌های منطقی مختلفِ آن مؤلفه استفاده کنند. برای مثال، کارساز DHCPv4 از یک ثبت‌کننده برای پیام‌های دریافت و ارسال بسته‌ها، و از ثبت‌کننده‌ای دیگر برای پیام‌های مرتبط با تخصیص اجاره (lease) و مواردی از این دست استفاده می‌کند. برخی از کتابخانه‌های مورداستفاده در کارساز Kea مانند libdhcpsrv از ثبت‌کننده‌های مختص به خود بهره می‌برند.
.sp
کاربرانی که کتابخانه‌های قلاب (hook libraries - کدی که در زمان اجرا به کارساز پیوست می‌شود) را توسعه می‌دهند، وظیفه ایجاد ثبت‌کننده‌های مورد استفاده در آن کتابخانه‌ها را بر عهده دارند. این ثبت‌کننده‌ها باید نام‌های منحصربه‌فردی داشته باشند که با نام‌های استفاده‌شده توسط Kea تداخل نداشته باشد. بدین ترتیب، پیام‌های صادرشده توسط کتابخانه قلاب از پیام‌های بخش مرکزی کد Kea قابل تفکیک خواهند بود. همچنین نام‌های متمایز این امکان را می‌دهند که ثبت‌کننده‌های قلاب به‌طور مستقل از ثبت‌کننده‌های Kea پیکربندی شوند. در صورت لزوم، یک کتابخانه قلاب می‌تواند از چندین ثبت‌کننده جهت ثبت پیام‌های مربوط به بخش‌های منطقی متفاوت کتابخانه بهره ببرد.
.sp
در بخش server فایل پیکربندی، می‌توان تنظیمات مربوط به صفر یا چند ثبت‌کننده (از جمله ثبت‌کننده‌های مورداستفاده در کتابخانه‌های قلاب اختصاصی) را تعیین کرد. در صورت عدم تعیین ثبت‌کننده‌ها، کد از مقادیر پیش‌فرض استفاده می‌کند؛ در این حالت Kea پیام‌های با سطح اهمیت INFO یا بیشتر را در خروجی استاندارد ثبت می‌کند. یک بازه زمانی کوتاه میان شروع به کار Kea تا زمان خواندن پیکربندی وجود دارد؛ ثبت وقایع در این بازه کوتاه را می‌توان از طریق متغیرهای محیطی کنترل نمود. برای کسب اطلاعات بیشتر، بخش Logging During Kea Startup را ببینید\&.
.sp
سه مؤلفه اصلی در پیکربندی یک ثبت‌کننده عبارتند از: \fBname\fP (مؤلفه‌ای که پیام‌ها را ایجاد می‌کند)، \fBseverity\fP (چه چیزی ثبت شود)، و \fBoutput_commands\fP (محل ذخیره یا ارسال لاگ). علاوه بر این، گزینه \fBdebuglevel\fP نیز وجود دارد که تنها در صورت انتخاب سطح ثبت وقایع debug کاربرد دارد..SS ثبت‌کنندهٔ \fBname\fP (رشته)
.sp
هر ثبت‌کننده (logger) در سامانه یک نام دارد: نام فایل باینری مؤلفه‌ای که
از آن برای ثبت پیام‌ها استفاده می‌کند. برای نمونه، جهت پیکربندی ثبت رخدادها
برای سرور DHCPv4، مدخلی برای ثبت‌کننده‌ای با نام «kea\-dhcp4» اضافه کنید.
این پیکربندی سپس توسط ثبت‌کننده‌های موجود در سرور DHCPv4 و تمامی کتابخانه‌های
مورد استفادهٔ آن به کار گرفته خواهد شد، مگر آن‌که کتابخانه‌ای ثبت‌کنندهٔ
ویژهٔ خود را تعریف کرده باشد و پیکربندی ثبت‌کنندهٔ مشخصی وجود داشته باشد که
بر آن ثبت‌کننده اعمال شود.
.sp
هنگام ردیابی یک مشکل در عملکرد سرور، استفاده از ثبت در سطح DEBUG برای به‌دست
آوردن خروجی با جزئیات کامل جهت عیب‌یابی مورد نیاز است. با این حال، احتمال
دارد این حجم زیاد از جزئیات در مواردی که سرور ترافیک بالایی را پردازش می‌کند،
سامانهٔ ثبت رخداد را تحت فشار شدید قرار دهد. برای کاهش این مشکل، Kea می‌تواند
از چندین ثبت‌کننده برای بخش‌های عملکردی مختلف سرور استفاده کند که هر کدام را
می‌توان به طور مستقل پیکربندی کرد. اگر کاربر تا حد قابل قبولی مطمئن باشد که
مشکل از بخش خاصی از سرور سرچشمه می‌گیرد، یا مشکل به نوع خاصی از عملیات مربوط
است، می‌تواند سطح جزئیات بالا را تنها برای ثبت‌کنندهٔ مربوطه فعال کند و از این
طریق پیام‌های DEBUG را به حداقلِ لازم محدود سازد.
.sp
ثبت‌کننده‌ها به یک کتابخانه یا فایل باینریِ مشخص از Kea وابسته هستند. با
این وجود، هر کتابخانه یا فایل باینری می‌تواند (و معمولاً چنین است) شامل
چندین ثبت‌کننده باشد. برای نمونه، فایل باینری سرور DHCPv4 شامل ثبت‌کننده‌های
مجزایی برای تجزیهٔ بسته‌ها (packet parsing)، بسته‌های دور انداخته‌شده
(dropped packets)، فراخوانی‌ها (callouts) و غیره است.
.sp
ثبت‌کننده‌ها یک سلسله‌مراتب را تشکیل می‌دهند. برای هر برنامه در Kea، یک
ثبت‌کنندهٔ «ریشه» (\(dqroot\(dq) وجود دارد که هم‌نام با آن برنامه است (برای
نمونه، ثبت‌کنندهٔ ریشه برای \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4>، یعنی
سرور DHCPv4، نامش \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> است). سایر
ثبت‌کننده‌ها فرزندان این ثبت‌کننده به شمار می‌روند و متناسب با آن نام‌گذاری
می‌شوند؛ مثلاً موتور تخصیص در سرور DHCPv4، پیام‌ها را با استفاده از
ثبت‌کننده‌ای به نام \fBkea\-dhcp4.alloc\-engine\fP\& ثبت می‌کند.
.sp
این رابطه اهمیت دارد، زیرا هر ثبت‌کنندهٔ فرزند، پیکربندی پیش‌فرض خود را از
ثبت‌کنندهٔ ریشهٔ والد خود دریافت می‌کند. در حالت معمول، پیکربندی ثبت‌کنندهٔ
ریشه تنها پیکربندیِ ثبتی است که در فایل پیکربندی مشخص می‌شود و بنابراین برای
همهٔ ثبت‌کننده‌ها اعمال می‌گردد. اگر مدخلی برای یک ثبت‌کنندهٔ معین ایجاد شود،
هر ویژگیِ مشخص‌شده بر ویژگی‌های ثبت‌کنندهٔ ریشه ارجحیت خواهد داشت، در حالی
که ویژگی‌های مشخص‌نشده از آن به ارث برده می‌شوند.
.sp
برای روشن‌تر شدن موضوع، فرض کنید در حال استفاده از سرور DHCPv4 با
ثبت‌کنندهٔ ریشهٔ \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> هستیم که در سطح
INFO ثبت می‌کند. به منظور فعال‌سازی سطح جزئیات DEBUG برای بسته‌های دور
انداخته‌شدهٔ DHCPv4، باید مدخل پیکربندی‌ای برای این ثبت‌کننده با
\fB\(dqname\(dq: \(dqkea\-dhcp4.bad\-packets”\fP،
\fB\(dqseverity\(dq: \(dqDEBUG\(dq\fP و یک سطح اشکال‌زدایی صریح بسازیم. تمام
پارامترهای پیکربندی دیگر می‌توانند برای این ثبت‌کننده حذف شوند در صورتی که
قرار باشد از مقادیر پیش‌فرض تعیین‌شده در پیکربندی ثبت‌کنندهٔ ریشه استفاده کند.
.sp
ویژگی \fBdebuglevel\fP تنها در صورتی به ارث می‌رسد که \fBseverity\fP نیز وجود
نداشته باشد. برای به‌دست آمدن نتایج قابل پیش‌بینی، اگر \fBseverity\fP برابر
\fB\(dqDEBUG\(dq\fP باشد، این دو ویژگی همیشه باید یا با هم به صراحت مشخص شوند
یا هر دو حذف شوند. مدخلی با شدت صریح \fB\(dqDEBUG\(dq\fP، مقدار \fBdebuglevel\fP
را از ثبت‌کنندهٔ ریشه به ارث نمی‌برد و در صورت عدم تعیین، به طور پیش‌فرض
\fB0\fP در نظر گرفته می‌شود که در نتیجه هیچ پیام اشکال‌زدایی‌ای ثبت نخواهد شد.
این پیامدِ تکیه بر سازوکار توارث log4cplus است.
.sp
اگر چندین مشخصهٔ ثبت‌کننده در پیکربندی وجود داشته باشد که ممکن است با یک
ثبت‌کنندهٔ خاص تطابق داشته باشند، مشخصه‌ای که نام ثبت‌کنندهٔ دقیق‌تری دارد
اولویت خواهد داشت. برای نمونه، اگر مدخل‌هایی هم برای
\fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> و هم برای \fBkea\-dhcp4.dhcpsrv\fP
وجود داشته باشد، برنامهٔ اصلی سرور DHCPv4 — و تمام کتابخانه‌های مورد استفادهٔ
آن به جز کتابخانهٔ \fBdhcpsrv\fP (کتابخانهٔ libdhcpsrv) — پیام‌ها را بر اساس
پیکربندی موجود در مدخل اول (\fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4>) ثبت
می‌کنند. پیام‌های تولیدشده توسط کتابخانهٔ \fBdhcpsrv\fP بر اساس پیکربندی
تعیین‌شده در مدخل دوم ثبت می‌شوند.
.sp
ثبت‌کننده‌هایی که در حال حاضر تعریف شده‌اند در جدول زیر فهرست شده‌اند.
ستون «بستهٔ نرم‌افزاری» (\(dqSoftware Package\(dq) در این جدول مشخص می‌کند که
آیا ثبت‌کننده‌های خاص متعلق به کد اصلی Kea (فایل‌های باینری و کتابخانه‌های
متن‌باز Kea) هستند، یا کتابخانه‌های قلاب (hook) (متن‌باز یا اشتراکی).
.SS فهرست ثبت‌کننده‌های پشتیبانی‌شده توسط سرورهای Kea و کتابخانه‌های قلاب ارائه‌شده همراه با بسته‌های Kea/اشتراکی
.TS
box center;
l|l|l.
T{
نام ثبت‌کننده
T}	T{
بستهٔ نرم‌افزاری
T}	T{
توضیحات
T}
_
T{
\fBkea\-dhcp4\fP
T}	T{
core
T}	T{
ثبت‌کنندهٔ ریشه برای سرور
DHCPv4. تمام مؤلفه‌های مورد استفادهٔ
سرور DHCPv4 تنظیمات را از این
ثبت‌کننده به ارث می‌برند.
T}
_
T{
\fBkea\-dhcp6\fP
T}	T{
core
T}	T{
ثبت‌کنندهٔ ریشه برای سرور
DHCPv6. تمام مؤلفه‌های مورد استفادهٔ
سرور DHCPv6 تنظیمات را از این
ثبت‌کننده به ارث می‌برند.
T}
_
T{
\fBkea\-dhcp4.alloc\-engine\fP,
\fBkea\-dhcp6.alloc\-engine\fP
T}	T{
core
T}	T{
مورد استفاده توسط موتور تخصیص
اجاره، که مسئول مدیریت اجاره‌ها در
پایگاه دادهٔ اجاره است؛ یعنی ایجاد،
تغییر، و حذف اجاره‌های DHCP در
نتیجهٔ پردازش پیام‌های دریافتی از
کلاینت‌ها.
T}
_
T{
\fBkea\-dhcp4.auth\fP,
\fBkea\-dhcp6.auth\fP
T}	T{
core
T}	T{
برای ثبت بسته‌های ناهنجار HTTP
در هنگام استفاده از احراز هویت
پایه (basic authentication).
T}
_
T{
\fBkea\-dhcp4.bad\-packets\fP,
\fBkea\-dhcp6.bad\-packets\fP
T}	T{
core
T}	T{
مورد استفاده توسط سرورهای DHCP
برای ثبت بسته‌های ورودی کلاینت که
دور انداخته شده‌اند یا سرور با یک
DHCPNAK به آن‌ها پاسخ داده است. این
قابلیت به مدیران سیستم امکان می‌دهد تا
یک خروجی ثبت مجزا پیکربندی کنند که
تنها حاوی موارد دور انداختن و رد
بسته باشد.
T}
_
T{
\fBkea\-dhcp4.bootp\-hooks\fP
T}	T{
کتابخانهٔ قلاب متن‌باز
\fBlibdhcp_bootp.so\fP \%<#\:std-ischooklib-libdhcp_bootp\:.so>
T}	T{
این ثبت‌کننده برای ثبت پیام‌های
مرتبط با عملکرد کتابخانهٔ قلاب
BOOTP به کار می‌رود.
T}
_
T{
\fBkea\-dhcp4.callouts\fP,
\fBkea\-dhcp6.callouts\fP,
\fBkea\-dhcp\-ddns.callouts\fP
T}	T{
core
T}	T{
برای ثبت پیام‌های مربوط به ثبت و
اجرای فراخوانی‌ها (callouts) برای
یک نقطهٔ قلاب خاص.
T}
_
T{
\fBkea\-dhcp4.cb\-cmds\-hooks\fP,
\fBkea\-dhcp6.cb\-cmds\-hooks\fP
T}	T{
کتابخانهٔ قلاب اشتراکی
\fBlibdhcp_cb_cmds.so\fP \%<#\:std-ischooklib-libdhcp_cb_cmds\:.so>
T}	T{
برای ثبت پیام‌های مرتبط با عملکرد
کتابخانهٔ قلاب Config Backend Commands.
T}
_
T{
\fBkea\-dhcp4.class\-cmds\-hooks\fP,
\fBkea\-dhcp6.class\-cmds\-hooks\fP
T}	T{
کتابخانهٔ قلاب متن‌باز
\fBlibdhcp_class_cmds.so\fP \%<#\:std-ischooklib-libdhcp_class_cmds\:.so>
T}	T{
برای ثبت پیام‌های مرتبط با عملکرد
کتابخانهٔ قلاب Class Commands.
T}
_
T{
\fBkea\-dhcp4.commands\fP,
\fBkea\-dhcp6.commands\fP
T}	T{
core
T}	T{
برای ثبت پیام‌های مرتبط با رسیدگی به
دستورهای دریافت شده توسط سرور DHCP
از طریق کانال دستور (command channel).
T}
_
T{
\fBkea\-dhcp4.database\fP,
\fBkea\-dhcp6.database\fP
T}	T{
core
T}	T{
برای ثبت پیام‌های مرتبط با عملیات
عمومی پایگاه‌های دادهٔ رابطه‌ای.
T}
_
T{
\fBkea\-dhcp4.ddns\-tuning\-hooks\fP,
\fBkea\-dhcp6.ddns\-tuning\-hooks\fP
T}	T{
کتابخانهٔ قلاب متن‌باز
\fBlibdhcp_ddns_tuning.so\fP \%<#\:std-ischooklib-libdhcp_ddns_tuning\:.so>
T}	T{
برای ثبت پیام‌های مرتبط با عملکرد
کتابخانهٔ قلاب DDNS Tuning.
T}
_
T{
\fBkea\-dhcp4.ddns\fP,
\fBkea\-dhcp6.ddns\fP
T}	T{
core
T}	T{
مورد استفاده توسط سرور DHCP برای
ثبت پیام‌های مرتبط با پردازش گزینه‌های
Client FQDN و Hostname. همچنین شامل
پیام‌های ثبت مربوط به به‌روزرسانی‌های
مرتبط با DNS است.
T}
_
T{
\fBkea\-dhcp4.dhcp4\fP,
\fBkea\-dhcp6.dhcp6\fP
T}	T{
core
T}	T{
برای ثبت عملیات پایه به کار می‌رود.
T}
_
T{
\fBkea\-dhcp4.dhcpsrv\fP,
\fBkea\-dhcp6.dhcpsrv\fP
T}	T{
core
T}	T{
ثبت‌کننده‌های پایه برای کتابخانهٔ
\fBlibkea\-dhcpsrv.so\fP\&.
T}
_
T{
\fBkea\-dhcp4.eval\fP,
\fBkea\-dhcp6.eval\fP
T}	T{
core
T}	T{
برای ثبت پیام‌های مرتبط با کد
ارزیابی عبارت دسته‌بندی کلاینت.
T}
_
T{
\fBkea\-dhcp4.flex\-id\-hooks\fP,
\fBkea\-dhcp6.flex\-id\-hooks\fP
T}	T{
کتابخانهٔ قلاب متن‌باز
\fBlibdhcp_flex_id.so\fP \%<#\:std-ischooklib-libdhcp_flex_id\:.so>
T}	T{
برای ثبت پیام‌های مرتبط با عملکرد
کتابخانهٔ قلاب Flexible Identifier.
T}
_
T{
\fBkea\-dhcp4.flex\-option\-hooks\fP,
\fBkea\-dhcp6.flex\-option\-hooks\fP
T}	T{
کتابخانهٔ قلاب متن‌باز
\fBlibdhcp_flex_option.so\fP \%<#\:std-ischooklib-libdhcp_flex_option\:.so>
T}	T{
برای ثبت پیام‌های مرتبط با عملکرد
کتابخانهٔ قلاب Flexible Option.
T}
_
T{
\fBkea\-dhcp4.ha\-hooks\fP,
\fBkea\-dhcp6.ha\-hooks\fP
T}	T{
کتابخانهٔ قلاب متن‌باز
\fBlibdhcp_ha.so\fP \%<#\:std-ischooklib-libdhcp_ha\:.so>
T}	T{
برای ثبت پیام‌های مرتبط با عملکرد
کتابخانهٔ قلاب دسترسی‌پذیری بالا
(High Availability).
T}
_
T{
\fBkea\-dhcp4.hooks\fP,
\fBkea\-dhcp6.hooks\fP,
\fBkea\-dhcp\-ddns.hooks\fP
T}	T{
core
T}	T{
برای ثبت پیام‌های مرتبط با مدیریت
کتابخانه‌های قلاب، مانند ثبت و لغو
ثبت کتابخانه‌ها، و مقداردهی اولیهٔ
اجرای فراخوانی‌ها برای نقاط قلاب
مختلف در سرور DHCP به کار می‌رود.
T}
_
T{
\fBkea\-dhcp4.host\-cache\-hooks\fP,
\fBkea\-dhcp6.host\-cache\-hooks\fP
T}	T{
کتابخانهٔ قلاب متن‌باز
\fBlibdhcp_host_cache.so\fP \%<#\:std-ischooklib-libdhcp_host_cache\:.so>
T}	T{
برای ثبت پیام‌های مرتبط با عملکرد
کتابخانهٔ قلاب Host Cache.
T}
_
T{
\fBkea\-dhcp4.host\-cmds\-hooks\fP,
\fBkea\-dhcp6.host\-cmds\-hooks\fP
T}	T{
کتابخانهٔ قلاب متن‌باز
\fBlibdhcp_host_cmds.so\fP \%<#\:std-ischooklib-libdhcp_host_cmds\:.so>
T}	T{
برای ثبت پیام‌های مرتبط با عملکرد
کتابخانهٔ قلاب Host Commands. به طور
کلی، این پیام‌ها مربوط به بارگذاری و
تخلیهٔ کتابخانه و اجرای دستورها توسط
کتابخانه هستند.
T}
_
T{
\fBkea\-dhcp4.hosts\fP,
\fBkea\-dhcp6.hosts\fP
T}	T{
core
T}	T{
درون \fBlibkea\-dhcpsrv.so\fP برای
ثبت پیام‌های مربوط به مدیریت رزروهای
میزبان در DHCP (یعنی بازیابی رزروها و
افزودن رزروهای جدید) استفاده می‌شود.
T}
_
T{
\fBkea\-dhcp4.lease\-cmds\-hooks\fP,
\fBkea\-dhcp6.lease\-cmds\-hooks\fP
T}	T{
کتابخانهٔ قلاب متن‌باز
\fBlibdhcp_lease_cmds.so\fP \%<#\:std-ischooklib-libdhcp_lease_cmds\:.so>
T}	T{
برای ثبت پیام‌های مرتبط با عملکرد
کتابخانهٔ قلاب Lease Commands. به طور
کلی، این پیام‌ها مربوط به بارگذاری و
تخلیهٔ کتابخانه و اجرای دستورها توسط
کتابخانه هستند.
T}
_
T{
\fBkea\-dhcp4.limits\-hooks\fP,
\fBkea\-dhcp6.limits\-hooks\fP
T}	T{
کتابخانهٔ قلاب متن‌باز
\fBlibdhcp_limits.so\fP \%<#\:std-ischooklib-libdhcp_limits\:.so>
T}	T{
برای ثبت پیام‌های مرتبط با عملکرد
کتابخانهٔ قلاب Limits.
T}
_
T{
\fBkea\-dhcp4.lease\-query\-hooks\fP,
\fBkea\-dhcp6.lease\-query\-hooks\fP
T}	T{
کتابخانهٔ قلاب متن‌باز
\fBlibdhcp_lease_query.so\fP \%<#\:std-ischooklib-libdhcp_lease_query\:.so>
T}	T{
برای ثبت پیام‌های مرتبط با عملکرد
کتابخانهٔ قلاب Leasequery.
T}
_
T{
\fBkea\-dhcp4.leases\fP,
\fBkea\-dhcp6.leases\fP
T}	T{
core
T}	T{
توسط سرور DHCP برای ثبت پیام‌های
مرتبط با تخصیص اجاره به کار می‌رود.
این پیام‌ها شامل اطلاعات دقیق دربارهٔ
اجاره‌های تخصیص‌یافته یا ارائه‌شده،
خطاها در طول تخصیص اجاره و غیره
می‌باشند.
T}
_
T{
\fBkea\-dhcp4.legal\-log\-hooks\fP,
\fBkea\-dhcp6.legal\-log\-hooks\fP
T}	T{
کتابخانهٔ قلاب متن‌باز
\fBlibdhcp_legal_log.so\fP \%<#\:std-ischooklib-libdhcp_legal_log\:.so>
T}	T{
برای ثبت پیام‌های مرتبط با عملکرد
کتابخانهٔ قلاب Forensic Logging.
T}
_
T{
\fBkea\-dhcp4.mysql\-cb\-hooks\fP,
\fBkea\-dhcp6.mysql\-cb\-hooks\fP
T}	T{
کتابخانهٔ قلاب متن‌باز
\fBlibdhcp_mysql.so\fP \%<#\:std-ischooklib-libdhcp_mysql\:.so>
T}	T{
برای ثبت پیام‌های مرتبط با عملکرد
کتابخانهٔ قلاب MySQL Configuration
Backend.
T}
_
T{
\fBkea\-dhcp4.mysql\-hb\-hooks\fP,
\fBkea\-dhcp6.mysql\-hb\-hooks\fP
T}	T{
کتابخانهٔ قلاب متن‌باز
\fBlibdhcp_mysql.so\fP \%<#\:std-ischooklib-libdhcp_mysql\:.so>
T}	T{
برای ثبت پیام‌های مرتبط با عملکرد
کتابخانهٔ قلاب MySQL Host Backend.
T}
_
T{
\fBkea\-dhcp4.mysql\-lb\-hooks\fP,
\fBkea\-dhcp6.mysql\-lb\-hooks\fP
T}	T{
کتابخانهٔ قلاب متن‌باز
\fBlibdhcp_mysql.so\fP \%<#\:std-ischooklib-libdhcp_mysql\:.so>
T}	T{
برای ثبت پیام‌های مرتبط با عملکرد
کتابخانهٔ قلاب MySQL Lease Backend.
T}
_
T{
\fBkea\-dhcp4.options\fP,
\fBkea\-dhcp6.options\fP
T}	T{
core
T}	T{
توسط سرور DHCP برای ثبت پیام‌های
مربوط به پردازش گزینه‌ها در پیام‌های
DHCP به کار می‌رود؛ مانند تجزیهٔ
گزینه‌ها، کدگذاری گزینه‌ها به قالب
on\-wire، و دسته‌بندی بسته‌ها با
استفاده از گزینه‌های موجود در بسته‌های
دریافتی.
T}
_
T{
\fBkea\-dhcp4.packets\fP,
\fBkea\-dhcp6.packets\fP
T}	T{
core
T}	T{
بیشتر برای ثبت پیام‌های مرتبط با
انتقال بسته‌های DHCP استفاده می‌شود؛ یعنی
دریافت بسته و ارسال پاسخ. چنین
پیام‌هایی شامل اطلاعاتی دربارهٔ نشانی‌های
IP مبدأ و مقصد و رابط‌های مورد استفاده
برای انتقال بسته‌ها هستند. این ثبت‌کننده
همچنین برای ثبت پیام‌های مرتبط با انتخاب
زیرشبکه به کار می‌رود، چرا که این انتخاب
معمولاً بر اساس نشانی‌های IP، نشانی‌های
رله، و/یا نام رابط‌ها صورت می‌گیرد که می‌توان
آن‌ها را حتی پیش از تجزیه شدن پیام DHCP درون
بسته، از بستهٔ دریافتی استخراج کرد.
T}
_
T{
\fBkea\-dhcp4.perfmon\-hooks\fP,
\fBkea\-dhcp6.perfmon\-hooks\fP
T}	T{
کتابخانهٔ قلاب متن‌باز
\fBlibdhcp_perfmon.so\fP \%<#\:std-ischooklib-libdhcp_perfmon\:.so>
T}	T{
برای ثبت پیام‌های مرتبط با عملکرد
کتابخانهٔ قلاب Performance Monitoring.
T}
_
T{
\fBkea\-dhcp4.ping\-check\-hooks\fP
T}	T{
کتابخانهٔ قلاب متن‌باز
\fBlibdhcp_ping_check.so\fP \%<#\:std-ischooklib-libdhcp_ping_check\:.so>
T}	T{
برای ثبت پیام‌های مرتبط با عملکرد
کتابخانهٔ قلاب Ping Check.
T}
_
T{
\fBkea\-dhcp4.pgsql\-cb\-hooks\fP,
\fBkea\-dhcp6.pgsql\-cb\-hooks\fP
T}	T{
کتابخانهٔ قلاب متن‌باز
\fBlibdhcp_pgsql.so\fP \%<#\:std-ischooklib-libdhcp_pgsql\:.so>
T}	T{
برای ثبت پیام‌های مرتبط با عملکرد
کتابخانهٔ قلاب PostgreSQL
Configuration Backend.
T}
_
T{
\fBkea\-dhcp4.pgsql\-hb\-hooks\fP,
\fBkea\-dhcp6.pgsql\-hb\-hooks\fP
T}	T{
کتابخانهٔ قلاب متن‌باز
\fBlibdhcp_pgsql.so\fP \%<#\:std-ischooklib-libdhcp_pgsql\:.so>
T}	T{
برای ثبت پیام‌های مرتبط با عملکرد
کتابخانهٔ قلاب PostgreSQL Host
Backend.
T}
_
T{
\fBkea\-dhcp4.pgsql\-lb\-hooks\fP,
\fBkea\-dhcp6.pgsql\-lb\-hooks\fP
T}	T{
کتابخانهٔ قلاب متن‌باز
\fBlibdhcp_pgsql.so\fP \%<#\:std-ischooklib-libdhcp_pgsql\:.so>
T}	T{
برای ثبت پیام‌های مرتبط با عملکرد
کتابخانهٔ قلاب PostgreSQL Lease
Backend.
T}
_
T{
\fBkea\-dhcp4.run\-script\-hooks\fP,
\fBkea\-dhcp6.run\-script\-hooks\fP
T}	T{
کتابخانهٔ قلاب متن‌باز
\fBlibdhcp_run_script.so\fP \%<#\:std-ischooklib-libdhcp_run_script\:.so>
T}	T{
برای ثبت پیام‌های مرتبط با عملکرد
کتابخانهٔ قلاب Run Script.
T}
_
T{
\fBkea\-dhcp4.radius\-hooks\fP,
\fBkea\-dhcp6.radius\-hooks\fP
T}	T{
کتابخانهٔ قلاب متن‌باز
\fBlibdhcp_radius.so\fP \%<#\:std-ischooklib-libdhcp_radius\:.so>
T}	T{
برای ثبت پیام‌های مرتبط با عملکرد
کتابخانهٔ قلاب RADIUS.
T}
_
T{
\fBkea\-dhcp4.stat\-cmds\-hooks\fP,
\fBkea\-dhcp6.stat\-cmds\-hooks\fP
T}	T{
کتابخانهٔ قلاب متن‌باز
\fBlibdhcp_stat_cmds.so\fP \%<#\:std-ischooklib-libdhcp_stat_cmds\:.so>
T}	T{
برای ثبت پیام‌های مرتبط با عملکرد
کتابخانهٔ قلاب Statistics Commands.
به طور کلی، این پیام‌ها مربوط به
بارگذاری و تخلیهٔ کتابخانه و اجرای
دستورها توسط کتابخانه هستند.
T}
_
T{
\fBkea\-dhcp4.subnet\-cmds\-hooks\fP,
\fBkea\-dhcp6.subnet\-cmds\-hooks\fP
T}	T{
کتابخانهٔ قلاب متن‌باز
\fBlibdhcp_subnet_cmds.so\fP \%<#\:std-ischooklib-libdhcp_subnet_cmds\:.so>
T}	T{
برای ثبت پیام‌های مرتبط با عملکرد
کتابخانهٔ قلاب Subnet Commands.
به طور کلی، این پیام‌ها مربوط به
بارگذاری و تخلیهٔ کتابخانه و اجرای
دستورها توسط کتابخانه هستند.
T}
_
T{
\fBkea\-dhcp4.tcp\fP,
\fBkea\-dhcp6.tcp\fP
T}	T{
core
T}	T{
برای ثبت پیام‌های مرتبط با
ترافیک TCP.
T}
_
T{
\fBkea\-dhcp4.user_chk\fP,
\fBkea\-dhcp6.user_chk\fP
T}	T{
کتابخانهٔ قلاب متن‌باز
\fBlibdhcp_user_chk.so\fP \%<#\:std-ischooklib-libdhcp_user_chk\:.so>
T}	T{
برای ثبت پیام‌های مرتبط با عملکرد
کتابخانهٔ قلاب User Check.
T}
_
T{
\fBkea\-dhcp\-ddns\fP
T}	T{
core
T}	T{
ثبت‌کنندهٔ ریشه برای دیمن
\fBkea\-dhcp\-ddns\fP \%<#\:std-iscman-kea-dhcp-ddns>\&.
تمام مؤلفه‌های مورد استفاده توسط این
دیمن تنظیمات را از این ثبت‌کننده به ارث
می‌برند، مگر اینکه پیکربندی‌هایی برای
ثبت‌کننده‌های تخصصی‌تر وجود داشته باشد.
T}
_
T{
\fBkea\-dhcp\-ddns.dctl\fP
T}	T{
core
T}	T{
برای ثبت اطلاعات اولیه دربارهٔ
فرآیند، سیگنال‌های دریافتی، و
پیکربندی‌های مجدد فراخوانی‌شده.
T}
_
T{
\fBkea\-dhcp\-ddns.asiodns\fP
T}	T{
core
T}	T{
برای ثبت پیام‌ها دربارهٔ رخدادهای
شبکه در عملیات DDNS.
T}
_
T{
\fBkea\-dhcp\-ddns.dhcpddns\fP
T}	T{
core
T}	T{
توسط دیمن
\fBkea\-dhcp\-ddns\fP \%<#\:std-iscman-kea-dhcp-ddns>
برای ثبت رخدادهای مرتبط با
عملیات DDNS استفاده می‌شود.
T}
_
T{
\fBkea\-dhcp\-ddns.dhcp\-to\-d2\fP
T}	T{
core
T}	T{
توسط دیمن
\fBkea\-dhcp\-ddns\fP \%<#\:std-iscman-kea-dhcp-ddns>
برای ثبت اطلاعات دربارهٔ رخدادهای
مربوط به دریافت پیام‌ها از سرورهای DHCP
و افزودن آن‌ها به صف پردازش استفاده
می‌شود.
T}
_
T{
\fBkea\-dhcp\-ddns.d2\-to\-dns\fP
T}	T{
core
T}	T{
توسط دیمن
\fBkea\-dhcp\-ddns\fP \%<#\:std-iscman-kea-dhcp-ddns>
برای ثبت اطلاعات دربارهٔ رخدادهای
مربوط به ارسال و دریافت پیام‌ها به و
از سرورهای DNS استفاده می‌شود.
T}
_
T{
\fBkea\-dhcp\-ddns.gss\-tsig\-hooks\fP
T}	T{
کتابخانهٔ قلاب متن‌باز
\fBlibddns_gss_tsig.so\fP \%<#\:std-ischooklib-libddns_gss_tsig\:.so>
T}	T{
برای ثبت پیام‌های مرتبط با عملکرد
کتابخانهٔ قلاب GSS\-TSIG.
T}
_
T{
\fBkea\-dhcp\-ddns.libdhcp\-ddns\fP
T}	T{
core
T}	T{
برای ثبت رخدادهای مرتبط با
عملیات DDNS استفاده می‌شود.
T}
_
T{
\fBkea\-netconf\fP
T}	T{
core
T}	T{
ثبت‌کنندهٔ ریشه برای عامل NETCONF.
تمام مؤلفه‌های مورد استفادهٔ NETCONF
تنظیمات را از این ثبت‌کننده به ارث
می‌برند در صورتی که ثبت‌کنندهٔ تخصصی‌تری
ارائه نشده باشد.
T}
.TE
.sp
توجه داشته باشید که کتابخانه‌های قلابِ تعریف‌شده توسط کاربر نباید از
هیچ‌یک از ثبت‌کننده‌های ذکرشده در بالا استفاده کنند، بلکه باید
ثبت‌کننده‌های جدیدی با نام‌هایی متناسب با کتابخانه‌های استفاده‌کننده از
آن‌ها تعریف نمایند. فرض کنید کاربری کتابخانه‌ای به نام
«libdhcp\-packet\-capture» ایجاد کرده است تا بسته‌های دریافتی و ارسالی توسط
سرور را در یک فایل ذخیره کند. نام مناسب برای این ثبت‌کننده می‌تواند
\fBkea\-dhcp4.packet\-capture\-hooks\fP\& باشد. (توجه داشته باشید که پیاده‌ساز
کتابخانهٔ قلاب تنها بخش دوم این نام، یعنی «packet\-capture» را مشخص
می‌کند؛ بخش اول نام ثبت‌کنندهٔ ریشه است و توسط سامانهٔ ثبت رخداد Kea به
ابتدای آن افزوده می‌شود). همچنین ذکر این نکته حائز اهمیت است که چون این
ثبت‌کنندهٔ جدید فرزندی از یک ثبت‌کنندهٔ ریشه است، پیکربندی را از ثبت‌کنندهٔ
ریشه به ارث می‌برد؛ امری که می‌توان با ایجاد مدخلی در فایل پیکربندی آن را
بازنویسی کرد.
.sp
ساده‌ترین راه برای یافتن نام یک ثبت‌کننده این است که تمام عملیات ثبت رخداد
را طوری پیکربندی کنید که به یک مقصد واحد ارسال شود و در آن‌جا به دنبال
نام‌های ثبت‌کنندهٔ خاص بگردید. برای جزئیات بیشتر به بخش «قالب پیام‌های ثبت»
(Logging Message Format) مراجعه کنید..SS ثبت‌کننده \fBseverity\fP (رشته)
.sp
این مورد ردهٔ پیام‌های ثبت‌شده را مشخص می‌کند. هر پیام به همراه یک سطح اهمیت مرتبط ثبت می‌شود که ممکن است یکی از موارد زیر باشد (به ترتیب نزولی سطح اهمیت):
.INDENT 0.0
.IP \(bu 2
FATAL \- مرتبط با پیام‌های تولیدشده در شرایطی که آن‌چنان وخیم است که کارساز نمی‌تواند به اجرای خود ادامه دهد.
.IP \(bu 2
ERROR \- مرتبط با پیام‌های تولیدشده در وضعیت خطا. کارساز به اجرای خود ادامه می‌دهد، اما نتایج ممکن است مطابق انتظار نباشد.
.IP \(bu 2
WARN \- بیانگر یک وضعیت غیرعادی است. با این حال، کارساز به طور عادی به اجرای خود ادامه می‌دهد.
.IP \(bu 2
INFO \- یک پیام اطلاع‌رسانی که نشان‌دهندهٔ وقوع یک رویداد است.
.IP \(bu 2
DEBUG \- پیام‌های تولیدشده برای اهداف اشکال‌زدایی.
.UNINDENT
.sp
هنگامی که سطح اهمیت یک ثبت‌کننده روی یکی از این مقادیر تنظیم شود، تنها پیام‌های مربوط به همان سطح و سطوح بالاتر ثبت می‌شوند (برای مثال، تنظیم سطح اهمیت گزارش‌گیری روی INFO باعث ثبت پیام‌های INFO، WARN، ERROR و FATAL می‌شود). همچنین می‌توان سطح اهمیت را روی NONE تنظیم کرد که در این صورت از ثبت تمامی پیام‌های آن ثبت‌کننده جلوگیری می‌شود.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
ابزار \fBkeactrl\fP \%<#\:std-iscman-keactrl>، که در «مدیریت Kea با keactrl» \%<#\:keactrl> شرح داده شده است، می‌تواند طوری پیکربندی شود که کارسازها را در حالت پرحرف (verbose) راه‌اندازی کند. در این صورت، تنظیمات سطح اهمیت گزارش‌گیری در فایل پیکربندی هیچ اثری نخواهد داشت؛ کارسازها بدون توجه به تنظیمات گزارش‌گیری مشخص‌شده در فایل پیکربندی، از سطح اهمیت DEBUG استفاده می‌کنند. برای کنترل سطح اهمیت از طریق فایل پیکربندی، لطفاً مطمئن شوید که مقدار \fBkea_verbose\fP درون پیکربندی \fBkeactrl\fP \%<#\:std-iscman-keactrl> روی \(dqno\(dq تنظیم شده باشد.
.UNINDENT
.UNINDENT
.SS ثبت‌کننده \fBdebuglevel\fP (عدد صحیح)
.sp
هنگامی که سطح اهمیت یک ثبت‌کننده روی DEBUG تنظیم شده باشد، این مقدار سطح پیام‌های اشکال‌زدایی برای چاپ را مشخص می‌کند. این مقدار در بازهٔ 0 (کمترین جزئیات) تا 99 (بیشترین جزئیات) قرار دارد. اگر سطح اهمیت ثبت‌کننده روی DEBUG نباشد، این مقدار نادیده گرفته می‌شود.
.SS ثبت‌کننده \fBoutput\-options\fP (فهرست)
.sp
هر ثبت‌کننده می‌تواند صفر یا چند \fBoutput\-options\fP داشته باشد. این گزینه‌ها محل ارسال پیام‌های گزارش را مشخص می‌کنند و در ادامه به تفصیل توضیح داده شده‌اند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
نام مستعار \fBoutput\-options\fP در Kea 2.5.1 اضافه شد تا بتوان آن را به‌جای کلید پیکربندی قبلی یعنی \fBoutput_options\fP به کار برد. این کار برای حفظ یکپارچگی تمامی کلیدهای پیکربندی انجام شد، یعنی استفاده از خط تیره (\fI\-\fP) به جای زیرخط (\fI_\fP) در نام کلید.
.sp
از نسخهٔ Kea 2.5.2، کلید \fBoutput\-options\fP به کلید پیکربندی پیش‌فرض تبدیل شده و از \fBoutput_options\fP می‌توان به عنوان یک نام مستعار استفاده کرد.
.sp
از نسخهٔ Kea 2.7.4، کلید پیکربندی \fBoutput_options\fP منسوخ شده است و در نسخه‌های آینده حذف خواهد شد. لطفاً با جایگزین کردن آن با \fBoutput\-options\fP، پیکربندی خود را به‌روزرسانی کنید.
.UNINDENT
.UNINDENT
.SS گزینهٔ \fBoutput\fP (رشته)
.sp
این مقدار نوع خروجی را تعیین می‌کند. چندین مقدار خاص در اینجا مجاز هستند: \fBstdout\fP (پیام‌ها روی خروجی استاندارد چاپ می‌شوند)، \fBstderr\fP (پیام‌ها روی خطای استاندارد چاپ می‌شوند)، \fBsyslog\fP (پیام‌ها با استفاده از نام پیش‌فرض در syslog ثبت می‌شوند)، \fBsyslog:name\fP (پیام‌ها با استفاده از نام مشخص‌شده در syslog ثبت می‌شوند). هر مقدار دیگری به عنوان نام فایلی که پیام‌ها باید در آن نوشته شوند تفسیر می‌شود.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
از نسخهٔ Kea 2.7.9، فایل‌های گزارش تنها می‌توانند در پوشهٔ خروجی تعیین‌شده در حین کامپایل نوشته شوند: \fB\(dq[kea\-install\-dir]/var/log/kea\(dq\fP\&. این مسیر را می‌توان در زمان راه‌اندازی با تنظیم متغیر محیطی \fBKEA_LOG_FILE_DIR\fP روی مسیر دلخواه بازنویسی کرد. اگر مسیری غیر از این مقدار در \fBoutput\fP استفاده شود، Kea خطایی صادر کرده و از راه‌اندازی خودداری می‌کند یا در صورت در حال اجرا بودن، یک خطای غیرقابل‌جبران ثبت خواهد کرد. برای سهولت در استفاده، کافی است بخش مسیر را از \fBoutput\fP حذف کرده و فقط نام فایل را مشخص کنید.
.UNINDENT
.UNINDENT
.SS گزینهٔ \fBflush\fP (بولی)
.sp
این گزینه بافرها را پس از هر پیام گزارش تخلیه می‌کند. انجام این کار کارایی را کاهش می‌دهد اما تضمین می‌کند که در صورت خاتمهٔ غیرعادی برنامه، تمامی پیام‌ها تا لحظهٔ خاتمه ثبت شوند. مقدار پیش‌فرض \fBtrue\fP است.
.SS گزینهٔ \fBmaxsize\fP (عدد صحیح)
.sp
این گزینه تنها زمانی که مقصد یک فایل باشد کاربرد دارد؛ این مقدار حداکثر اندازه‌ای به بایت است که یک فایل گزارش می‌تواند داشته باشد. هنگامی که اندازه به حداکثر رسید، نام فایل تغییر یافته و یک فایل جدید ایجاد می‌شود. در ابتدا یک \(dq.1\(dq به انتهای نام افزوده می‌شود؛ اگر فایلی با پسوند \(dq.1\(dq وجود داشته باشد، نام آن به \(dq.2\(dq تغییر می‌یابد و به همین ترتیب ادامه پیدا می‌کند. به این فرآیند چرخش گفته می‌شود.
.sp
مقدار پیش‌فرض 10240000 (۱۰ مگابایت) است. کوچک‌ترین مقداری که می‌توان بدون غیرفعال کردن چرخش تعیین کرد، 204800 است. هر مقداری کمتر از این مقدار، از جمله 0، چرخش را غیرفعال می‌کند. بزرگ‌ترین مقدار ممکن INT_MAX مگابایت است که تقریباً برابر با ۲ پتابایت می‌باشد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
به دلیل محدودیتی در کتابخانهٔ گزارش‌گیری زیربنایی (log4cplus)، چرخش فایل‌های گزارش (از \(dq.1\(dq به \(dq.2\(dq و غیره) ممکن است نتایج عجیبی نشان دهد؛ ممکن است در زمان چرخش، چندین فایل کوچک وجود داشته باشند. این امر زمانی رخ می‌دهد که چندین فرآیند تلاش کنند فایل‌ها را به طور هم‌زمان بچرخانند. نسخهٔ 1.1.0 کتابخانهٔ log4cplus این مشکل را برطرف کرد، بنابراین اگر برای ساخت Kea از این نسخه یا نسخه‌های جدیدتر log4cplus استفاده شود، این مشکل نباید رخ دهد. حتی با نسخه‌های قدیمی‌تر نیز انتظار می‌رود که این مسئله به ندرت رخ دهد، مگر اینکه پیام‌های گزارش با بسامد بسیار بالا توسط چندین فرآیند مختلف تولید شوند.
.UNINDENT
.UNINDENT.SS گزینهٔ \fBmaxver\fP (عدد صحیح)
.sp
این گزینه تنها زمانی کاربرد دارد که مقصد یک فایل بوده و چرخش فعال باشد
(یعنی \fBmaxsize\fP به اندازهٔ کافی بزرگ باشد). این پارامتر، حداکثر تعداد
نسخه‌های چرخیده‌ای است که نگهداری می‌شوند. هنگامی که تعداد فایل‌ها به این
حد نصاب برسد، در هر بار چرخش لاگ، قدیمی‌ترین فایل، یعنی \(dqlog\-name.maxver\(dq،
دور ریخته می‌شود. به عبارت دیگر، حداکثر فایل لاگ فعال به همراه
\fBmaxver\fP فایل چرخیده وجود خواهد داشت. کمترین مقدار و مقدار پیش‌فرض ۱ است.
.SS گزینهٔ \fBpattern\fP (رشته)
.sp
از این گزینه می‌توان برای مشخص کردن الگوی چیدمان پیام‌ها برای یک ثبت‌کننده (logger)
استفاده کرد. سیستم ثبت گزارش Kea با استفاده از کتابخانهٔ log4cplus پیاده‌سازی
شده و قالب‌بندی خروجی آن، از نظر مفهومی بر پایهٔ قالب‌بندی printf در زبان C است؛
این موضوع با جزئیات در بخش بعدی،
قالب پیام‌های ثبت وقایع، بررسی شده است\&.
.sp
هر نوع خروجی (\fBstdout\fP، فایل یا \fBsyslog\fP) یک \fBpattern\fP پیش‌فرض دارد که
محتوای پیام‌های لاگ آن را شرح می‌دهد. از این پارامتر می‌توان برای مشخص کردن
الگوی دلخواه استفاده کرد. الگوی هر ثبت‌کننده به صورت جداگانه تعیین می‌شود، بنابراین
هر ثبت‌کنندهٔ پیکربندی‌شده می‌تواند الگوی مخصوص به خود را داشته باشد. حذف کردن
پارامتر \fBpattern\fP یا مقداردهی آن با یک رشتهٔ خالی، \(dq\(dq، باعث می‌شود
Kea از الگوی پیش‌فرض برای نوع خروجی آن ثبت‌کننده استفاده کند.
.sp
علاوه بر خود متن لاگ، الگوهای پیش‌فرض استفاده‌شده برای \fBstdout\fP و فایل‌ها حاوی
اطلاعاتی نظیر تاریخ و زمان، سطح ثبت‌کننده و اطلاعات فرایند هستند. الگوی پیش‌فرض
برای \fBsyslog\fP عمدتاً به سطح لاگ، منبع و متن لاگ محدود می‌شود. این امر از
تکرار اطلاعاتی که معمولاً توسط syslog ارائه می‌شوند جلوگیری می‌کند.
.sp
\fBهشدار:\fP
.INDENT 0.0
.INDENT 3.5
اکیداً به کاربران توصیه می‌شود که الگو(های) خود را بر روی یک نمونهٔ محلی
و غیرعملیاتی از Kea که در پیش‌زمینه اجرا شده و لاگ‌ها را در \fBstdout\fP
می‌نویسد، آزمایش کنند\&.
.UNINDENT
.UNINDENT
.SS قالب پیام‌های ثبت وقایع
.sp
همان‌طور که در بالا اشاره شد، محتوای پیام لاگ Kea از طریق ساختاری شبیه به قالب‌بندی
printf در زبان C کنترل می‌شود. «الگو» (\(dqpattern\(dq) استفاده‌شده برای هر پیام،
با رشته‌ای توصیف می‌شود که حاوی یک یا چند جزء قالب‌بندی به عنوان بخشی از یک رشتهٔ
متنی است. این رشته علاوه بر اجزا می‌تواند شامل هر متن مفید دیگری برای مدیر سیستم نیز باشد.
.sp
رفتار رشته‌های قالب‌بندی Kea توسط log4cplus تعیین می‌شود. گزینه‌های قالب‌بندی زمان
زیر درون \fB%D{}\fP یا \fB%d{}\fP امکان‌پذیر هستند:
.SS فهرست اجزای رشته‌های قالب زمان پشتیبانی‌شده توسط ثبت‌کنندهٔ Kea
.TS
box center;
l|l.
T{
جزء
T}	T{
مقدار
T}
_
T{
\fB%a\fP
T}	T{
نام اختصاری روز هفته
T}
_
T{
\fB%A\fP
T}	T{
نام کامل روز هفته
T}
_
T{
\fB%b\fP
T}	T{
نام اختصاری ماه
T}
_
T{
\fB%B\fP
T}	T{
نام کامل ماه
T}
_
T{
\fB%c\fP
T}	T{
رشتهٔ استاندارد تاریخ و زمان
T}
_
T{
\fB%d\fP
T}	T{
روزِ ماه به صورت ده‌دهی (1\-31)
T}
_
T{
\fB%H\fP
T}	T{
ساعت (0\-23)
T}
_
T{
\fB%I\fP
T}	T{
ساعت (1\-12)
T}
_
T{
\fB%j\fP
T}	T{
روزِ سال به صورت ده‌دهی (1\-366)
T}
_
T{
\fB%m\fP
T}	T{
ماه به صورت ده‌دهی (1\-12)
T}
_
T{
\fB%M\fP
T}	T{
دقیقه به صورت ده‌دهی (0\-59)
T}
_
T{
\fB%p\fP
T}	T{
معادل محلی (locale) برای AM یا PM
T}
_
T{
\fB%q\fP
T}	T{
میلی‌ثانیه به صورت ده‌دهی (0\-999)
T}
_
T{
\fB%Q\fP
T}	T{
میکروثانیه به صورت ده‌دهی (0\-999.999)
T}
_
T{
\fB%S\fP
T}	T{
ثانیه به صورت ده‌دهی (0\-59)
T}
_
T{
\fB%U\fP
T}	T{
هفتهٔ سال، با یکشنبه به عنوان روز نخست (0\-53)
T}
_
T{
\fB%w\fP
T}	T{
روز هفته به صورت ده‌دهی (0\-6، یکشنبه برابر 0 است)
T}
_
T{
\fB%W\fP
T}	T{
هفتهٔ سال، با دوشنبه به عنوان روز نخست (0\-53)
T}
_
T{
\fB%x\fP
T}	T{
رشتهٔ استاندارد تاریخ
T}
_
T{
\fB%X\fP
T}	T{
رشتهٔ استاندارد زمان
T}
_
T{
\fB%y\fP
T}	T{
سال به صورت ده‌دهی بدون قرن (0\-99)
T}
_
T{
\fB%Y\fP
T}	T{
سال به صورت ده‌دهی شامل قرن
T}
_
T{
\fB%Z\fP
T}	T{
نام منطقهٔ زمانی
T}
_
T{
\fB%%\fP
T}	T{
علامت درصد
T}
.TE
.sp
برای اطلاعات بیشتر، به مستندات تابع \fBstrftime()\fP موجود در هدر
\fB<ctime>\fP یا صفحهٔ راهنمای یونیکس \fBstrftime(3)\fP مراجعه کنید.
.sp
احتمالاً ساده‌ترین راه برای درک این موضوع، بررسی الگوی پیش‌فرض برای
\fBstdout\fP و فایل‌ها است؛ در حال حاضر هر دوی آن‌ها یکسان هستند. این الگو در
زیر نشان داده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dq%D{%Y\-%m\-%d %H:%M:%S.%q} %\-5p [%c/%i.%t] %m\en\(dq
.EE
.UNINDENT
.UNINDENT
.sp
و یک لاگ معمول تولیدشده توسط این الگو چیزی شبیه به این خواهد بود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
2019\-08\-05 14:27:45.871 DEBUG [kea\-dhcp4.dhcpsrv/8475.12345] DHCPSRV_TIMERMGR_START_TIMER starting timer: reclaim\-expired\-leases
.EE
.UNINDENT
.UNINDENT
.sp
که به صورت زیر تفکیک می‌شود:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0.IP \(bu 2
\fB%D{%Y\-%m\-%d %H:%M:%S.%q}\fP
عبارت \(dq%D\(dq تاریخ و زمان محلی هنگام تولید پیام گزارش است،
در حالی که همه چیز میان آکولادها، \(dq{}\(dq، مؤلفه‌های تاریخ و زمان هستند.
بر اساس گزارش نمونه بالا، این عبارت مقدار زیر را تولید می‌کند:
\fB2019\-08\-05 14:27:45.871\fP
.IP \(bu 2
\fB%\-5p\fP
میزان شدت پیام، که در حداقل پنج نویسه با استفاده از فاصله‌گذاری از راست (right-padding) با فاصله‌ها در خروجی درج می‌شود. در گزارش نمونه ما: \fBDEBUG\fP
.IP \(bu 2
\fB%c\fP
منبع گزارش. این مورد شامل دو بخش است: فرایند Kea تولیدکننده پیام، در این مورد، \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4>؛ و مؤلفه درون برنامه‌ای که پیام از آن صادر شده است، \fBdhcpsrv\fP (برای مثال نام کتابخانه استفاده‌شده توسط پیاده‌سازی‌های کارگزار DHCP).
.IP \(bu 2
\fB%i\fP
شناسه فرایند (PID). از گزارش نمونه: \fB8475\fP\&.
.IP \(bu 2
\fB%t\fP
شناسه ریسه (thread ID). از گزارش نمونه: \fB12345\fP\&.
قالب شناسه ریسه به سیستم‌عامل وابسته است: برای مثال در برخی سیستم‌ها یک آدرس است، بنابراین در مبنای شانزده (هگزادسیمال) نمایش داده می‌شود.
.IP \(bu 2
\fB%m\fP
خود متن پیام گزارش. تمام پیام‌های گزارش Kea با یک شناسه پیام شروع شده و به دنبال آن متن دلخواه گزارش می‌آید. هر پیام در Kea دارای یک شناسه یکتا است که می‌تواند به عنوان نمایه‌ای برای راهنمای پیام‌های Kea \%<#\:kea-messages> استفاده شود، جایی که می‌توان اطلاعات بیشتری کسب کرد. در گزارش نمونه بالا، شناسه عبارت است از \fBDHCPSRV_TIMERMGR_START_TIMER\fP\&. متن گزارش معمولاً شرح مختصری با جزئیات شرایطی است که باعث ثبت گزارش شده است. در نمونه ما، اطلاعات ثبت‌شده،
\fBstarting timer: reclaim\-expired\-leases\fP، توضیح می‌دهد که زمان‌سنج مربوط به چرخه بازپس‌گیری اجاره‌های منقضی‌شده شروع شده است.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBهشدار:\fP
.INDENT 0.0
.INDENT 3.5
حذف \fB%m\fP متن پیام گزارش را از خروجی حذف کرده و آن را تا حدودی بی‌فایده می‌سازد. \fB%m\fP باید اجباری در نظر گرفته شود.
.UNINDENT
.UNINDENT
.sp
در نهایت، توجه داشته باشید که فاصله‌گذاری بین مؤلفه‌ها، کروشه‌های دور منبع گزارش و PID، و نویسه بازگشت به خط بعد پایانی \fB\en\fP همگی متن‌های عینی هستند که به عنوان بخشی از الگو مشخص شده‌اند.
.sp
\fBهشدار:\fP
.INDENT 0.0
.INDENT 3.5
برای اطمینان از اینکه هر مدخل گزارش در یک خط جداگانه قرار می‌گیرد، الگوها باید به یک \fB\en\fP ختم شوند\&. ممکن است سناریوهایی وجود داشته باشد که این امر مطلوب نباشد، بنابراین گنجاندن آن را اجباری نمی‌کنیم. اگر این مورد از الگو حذف شود، ورودی‌های گزارش در یک \(dqخط\(dq طولانی و به هم پیوسته قرار خواهند گرفت.
.UNINDENT
.UNINDENT
.sp
الگوی پیش‌فرض برای خروجی \fBsyslog\fP عبارت است از:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dq%\-5p [%c.%t] %m\en\(dq
.EE
.UNINDENT
.UNINDENT
.sp
این الگو تاریخ و زمان و همچنین شناسه فرایند را حذف می‌کند، زیرا این اطلاعات معمولاً توسط \fBsyslog\fP در خروجی قرار داده می‌شوند\&. توجه داشته باشید که Kea از این الگو برای ساختن متنی که به \fBsyslog\fP (یا هر مقصد دیگری) می‌فرستد، استفاده می‌کند. این مورد هیچ تأثیری بر محتوایی که ممکن است \fBsyslog\fP اضافه کند یا قالب‌بندی که ممکن است انجام دهد، ندارد.
.sp
برای بررسی رفتار \fBsyslog\fP به مستندات سیستم‌عامل مراجعه کنید، زیرا پیاده‌سازی‌های متعددی از آن وجود دارد.
.sp
فهرست کاملی از پارامترهای گزارش‌گیری پشتیبانی‌شده توسط Kea در جدول زیر نشان داده شده است:
.SS فهرست مؤلفه‌های رشته قالب‌بندی پشتیبانی‌شده توسط ثبت‌کننده Kea
.TS
box center;
l|l.
T{
مؤلفه
T}	T{
مقدار
T}
_
T{
\fB%b\fP
T}	T{
فایلی که گزارش را فراخوانی کرده در خروجی می‌آورد، مثلاً logger_impl.cc
T}
_
T{
\fB%c\fP
T}	T{
ثبت‌کننده (logger) رویداد را در خروجی می‌آورد، مثلاً kea\-dhcp4.hosts
T}
_
T{
\fB%d\fP
T}	T{
الگوی \fB%d{}\fP خروجی زمان UTC را قالب‌بندی می‌کند، مثلاً \fB%d{%Y\-%m\-%d %H:%M:%S.%q}\fP
T}
_
T{
\fB%D\fP
T}	T{
الگوی \fB%D{}\fP خروجی زمان محلی (LOCAL) را قالب‌بندی می‌کند، مثلاً \fB%D{%Y\-%m\-%d %H:%M:%S.%q}\fP
T}
_
T{
\fB%E\fP
T}	T{
متغیرهای محیط را در خروجی می‌آورد، مثلاً \fB%E{PATH}\fP
T}
_
T{
\fB%F\fP
T}	T{
نام فایلی که درخواست گزارش از آنجا صادر شده را در خروجی می‌آورد، مثلاً logger_impl.cc
T}
_
T{
\fB%h\fP
T}	T{
نام میزبان سیستم را در خروجی می‌آورد، مثلاً host\-1
T}
_
T{
\fB%H\fP
T}	T{
نام دامنه کاملاً مشخص (FQDN) را در خروجی می‌آورد، مثلاً host\-1.example.com
T}
_
T{
\fB%l\fP
T}	T{
معادل \fB%F:%L\fP است، مثلاً logger_impl.cc:179
T}
_
T{
\fB%L\fP
T}	T{
شماره خطی که گزارش در آن فراخوانی شده را در خروجی می‌آورد، مثلاً 179
T}
_
T{
\fB%m\fP
T}	T{
پیام واقعی گزارش را در خروجی می‌آورد
T}
_
T{
\fB%M\fP
T}	T{
فراخواننده (نام تابع) پیام گزارش را در خروجی می‌آورد
T}
_
T{
\fB%n\fP
T}	T{
جداکننده خط پشتیبانی‌شده توسط سیستم‌عامل را در خروجی می‌آورد، مثلاً \fB\en\fP در Linux
T}
_
T{
\fB%p\fP
T}	T{
میزان شدت گزارش را در خروجی می‌آورد، مثلاً INFO
T}
_
T{
\fB%r\fP
T}	T{
میلی‌ثانیه‌های سپری‌شده از شروع برنامه را در خروجی می‌آورد، مثلاً 1235
T}
_
T{
\fB%t\fP
T}	T{
شناسه ریسه‌ای (thread ID) را که پیام گزارش را تولید کرده در خروجی می‌آورد، مثلاً 281472855306256
T}
_
T{
\fB%T\fP
T}	T{
نام ریسه‌ای را که پیام گزارش را تولید کرده در خروجی می‌آورد، مثلاً 168005
T}
_
T{
\fB%i\fP
T}	T{
شناسه فرایندی (PID) را که پیام گزارش را تولید کرده در خروجی می‌آورد، مثلاً 168030
T}
_
T{
\fB%%\fP
T}	T{
یک علامت درصد واقعی را در خروجی درج می‌کند
T}
.TE
.sp
فاصله‌گذاری (Padding) و کوتاه‌سازی (truncation) نیز با استفاده از اصلاح‌کننده‌های قبل از مؤلفه امکان‌پذیر هستند؛ این کار با قرار دادن یک عدد و سایر نویسه‌های اصلاح‌کننده بین مؤلفه و علامت % انجام می‌شود. پنج روش برای اصلاح خروجی وجود دارد:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0.IP \(bu 2
\fB%20p\fP
در صورتی که سطح اهمیت (severity) کوتاه‌تر از ۲۰ نویسه باشد، از سمت چپ با فاصله پر می‌شود (راست‌چین).
.IP \(bu 2
\fB%\-15r\fP
در صورتی که میلی‌ثانیه‌های سپری‌شده از زمان شروع برنامه کوتاه‌تر از ۱۵ نویسه باشد، از سمت راست با فاصله پر می‌شود (چپ‌چین).
.IP \(bu 2
\fB%.30m\fP
در صورتی که پیام طولانی‌تر از ۳۰ نویسه باشد، از ابتدای پیام برش می‌خورد.
.IP \(bu 2
\fB%10.35E{PATH}\fP
در صورتی که متغیر محیطی \(dqPATH\(dq کوتاه‌تر از ۱۰ نویسه باشد، از سمت چپ با فاصله پر می‌شود (راست‌چین). اگر طول محتوا بیشتر از ۳۵ نویسه باشد، از ابتدای رشته برش می‌خورد.
.IP \(bu 2
\fB%\-15.40m\fP
در صورتی که پیام لاگ کوتاه‌تر از ۱۵ نویسه باشد، از سمت راست با فاصله پر می‌شود (چپ‌چین). اگر طول پیام بیشتر از ۴۰ نویسه باشد، از ابتدا برش می‌خورد.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
پارامترهای پشتیبانی‌شده به نسخه liblog4cplus استفاده‌شده برای کامپایل Kea بستگی دارد، که می‌توان آن را با اجرای دستور \fBkea\-dhcp4 \-W | grep \-i log4cplus\fP\& بررسی کرد. این کار خروجی‌ای مانند \fBLOG4CPLUS_VERSION:  2.0.5\fP\& تولید می‌کند. برای دریافت اطلاعات بیشتر درباره نسخه نصب‌شده، مستندات موجود در ویکی log4cplus را در \%<https://\:github\:.com/\:log4cplus/\:log4cplus/\:wiki> بررسی کنید.
.SS "پیکربندی‌های نمونه لاگر (Example Logger Configurations)"
.sp
در این مثال، می‌خواهیم ثبت گزارش (logging) کارساز را طوری تنظیم کنیم که با استفاده از خروجی استاندارد روی کنسول بنویسد.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqServer\(dq: {
    \(dqloggers\(dq: [
        {
            \(dqname\(dq: \(dqkea\-dhcp4\(dq,
            \(dqoutput\-options\(dq: [
                {
                    \(dqoutput\(dq: \(dqstdout\(dq
                }
            ],
            \(dqseverity\(dq: \(dqWARN\(dq
        }
    ]
}
.EE
.UNINDENT
.UNINDENT
.sp
به عنوان مثال دوم، می‌خواهیم پیام‌های لاگ سطح DEBUG را در فایلی حداکثر با حجم ۲ مگابایت ذخیره کنیم و تا هشت نسخه از فایل‌های لاگ قدیمی را نگه داریم. به محض اینکه اندازه فایل لاگ به ۲ مگابایت برسد، باید تغییر نام داده شده و یک فایل جدید ایجاد شود.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqServer\(dq: {
    \(dqloggers\(dq: [
        {
            \(dqname\(dq: \(dqkea\-dhcp6\(dq,
            \(dqoutput\-options\(dq: [
                {
                    \(dqoutput\(dq: \(dq/var/log/kea/kea\-debug.log\(dq,
                    \(dqmaxver\(dq: 8,
                    \(dqmaxsize\(dq: 204800,
                    \(dqflush\(dq: true,
                    \(dqpattern\(dq: \(dq%d{%j %H:%M:%S.%q} %c %m\en\(dq
                }
            ],
            \(dqseverity\(dq: \(dqDEBUG\(dq,
            \(dqdebuglevel\(dq: 99
        }
   ]
}
.EE
.UNINDENT
.UNINDENT
.sp
توجه داشته باشید که پیکربندی بالا از یک الگوی سفارشی استفاده می‌کند که خروجی‌ای مانند زیر تولید می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
220 13:50:31.783 kea\-dhcp4.dhcp4 DHCP4_STARTED Kea DHCPv4 server version 1.6.0\-beta2\-git started
.EE
.UNINDENT
.UNINDENT
.SS "لاگ‌گیری هنگام راه‌اندازی Kea (Logging During Kea Startup)"
.sp
پیکربندی لاگ‌گیری در فایل پیکربندی مشخص می‌شود. با این حال، هنگامی که Kea شروع به کار می‌کند، فایل پیکربندی تا رسیدن به بخشی از فرایند مقداردهی اولیه خوانده نمی‌شود. پیش از آن، تنظیمات لاگ‌گیری روی مقادیر پیش‌فرض قرار دارند، اگرچه امکان تغییر برخی جنبه‌های تنظیمات با استفاده از متغیرهای محیطی وجود دارد. در صورت عدم وجود هرگونه پیکربندی لاگ‌گیری در فایل پیکربندی، تنظیمات پیکربندی پیش‌فرض (که احتمالاً تغییر یافته است) در تمام طول اجرای برنامه پابرجا می‌ماند.
.sp
متغیرهای محیطی زیر می‌توانند برای کنترل رفتار لاگ‌گیری در هنگام راه‌اندازی استفاده شوند:
.sp
\fBKEA_LOCKFILE_DIR\fP
.INDENT 0.0
.INDENT 3.5
دایرکتوری‌ای را مشخص می‌کند که سیستم ثبت لاگ باید فایل قفل (lock file) خود را در آن ایجاد کند. در صورت عدم تعیین، مقدار آن prefix/var/run/kea است که در آن \(dqprefix\(dq به طور پیش‌فرض /usr/local می‌باشد. این متغیر نباید با یک اسلش خاتمه یابد. یک مقدار ویژه وجود دارد: \(dqnone\(dq، که به Kea اعلام می‌کند اصلاً فایل قفل ایجاد نکند. این موضوع در صورتی که چند فرایند در یک فایل مشترک لاگ بنویسند ممکن است باعث بروز مشکل شود.
.UNINDENT
.UNINDENT
.sp
\fBKEA_LOGGER_DESTINATION\fP
.INDENT 0.0
.INDENT 3.5
مقصد خروجی لاگ را مشخص می‌کند. چندین مقدار ویژه وجود دارد:
.sp
\fBstdout\fP
ثبت لاگ در خروجی استاندارد.
.sp
\fBstderr\fP
ثبت لاگ در خطای استاندارد.
.sp
\fBsyslog[:fac]\fP
ثبت لاگ از طریق syslog. بخش اختیاری \(dqfac\(dq (که با دونقطه از کلمه \(dqsyslog\(dq جدا می‌شود) تسهیلات (facility) مورد استفاده برای پیام‌های لاگ را مشخص می‌کند. در صورت عدم تعیین، پیام‌ها با استفاده از تسهیلات \(dqlocal0\(dq ثبت می‌شوند.
.sp
هر مقدار دیگری به عنوان نام فایل خروجی در نظر گرفته می‌شود. اگر وضعیت دیگری تعیین نشده باشد، Kea در خروجی استاندارد لاگ می‌اندازد.
.UNINDENT
.UNINDENT.SS "سطوح ثبت وقایع (Logging Levels)"
.sp
تمام کارسازهای Kea از این رویکرد کلی پیروی می‌کنند که بدون تحمیل بار اضافی و اطلاعات بیش از حد به سیستم ثبت وقایع (logging)، کاربر را از رویدادهای جاری آگاه سازند؛ چرا که بارگذاری بیش از حد می‌تواند به سادگی به عنوان حمله‌ای از نوع محروم‌سازی از سرویس (denial\-of\-service) مورد سوءاستفاده قرار گیرد.
.sp
برخلاف سطوح FATAL، ERROR، WARN و INFO، سطح DEBUG پارامترهای بیشتری دارد. فهرست زیر اطلاعات پایه‌ای را که در هر سطح ثبت می‌شود به تفصیل شرح می‌دهد. گاهی شرایط مشخص می‌کند که یک مورد از اطلاعات در سطحی بالاتر ثبت شود یا پایین‌تر. به عنوان مثال، اگر یک بسته به دلیل دسته‌بندیِ پیکربندی‌شده دور انداخته (drop) شود، این امر ناشی از اجرای سیاست پیکربندی‌شده است و در debuglevel 15 ثبت می‌گردد. با این حال، اگر بسته به دلیل بروز یک استثنا (exception) دور انداخته شود، اهمیت بسیار بیشتری دارد؛ چرا که ممکن است نشان‌دهنده یک باگ نرم‌افزاری، مشکلات جدی در حافظه، یا ایرادات اتصال به پایگاه داده باشد. از این رو ممکن است در سطوح بسیار بالاتری مانند WARN یا حتی ERROR ثبت شود.
.INDENT 0.0
.IP \(bu 2
0 \- پیام‌های منفردی که هنگام راه‌اندازی یا خاموش شدن کارساز چاپ می‌شوند.
.IP \(bu 2
10 \- ثبت اطلاعات مربوط به دستورات دریافتی API.
.IP \(bu 2
15 \- اطلاعات درباره دلایل دور انداخته شدن بسته.
.IP \(bu 2
40 \- اطلاعات ردگیری (tracing)، از جمله تصمیمات پردازشی، نتایج ارزیابی عبارت‌ها و موارد بیشتر.
.IP \(bu 2
45 \- مشابه سطح 40، اما با جزئیات بیشتر؛ برای مثال، زیرشبکه‌ای که برای یک بسته ورودی انتخاب می‌شود.
.IP \(bu 2
50 \- ارزیابی عبارت‌ها، وضعیت دریافتی از نقاط هوک (hook points)، پردازش اجاره (lease)، جزئیات پردازش بسته شامل باز کردن بسته (unpacking)، بسته‌بندی، ارسال و غیره.
.IP \(bu 2
55 \- شامل تمام جزئیات در دسترس، از جمله محتوای کامل بسته به همراه چاپ تمام گزینه‌ها.
.UNINDENT
.sp
سطوح دیباگ فقط برای پیام‌های ثبت‌شده در DEBUG اعمال می‌شوند و با استفاده از گزینه \fBdebuglevel\fP پیکربندی می‌گردند. برای جزئیات بیشتر به بخش The debuglevel (integer) Logger مراجعه کنید.
.SH "پوسته KEA (THE KEA SHELL)"
.SS "نمای کلی پوسته KEA (Overview of the Kea Shell)"
.sp
کارسازهای Kea یک رابط کنترلی RESTful بر روی HTTP فراهم می‌کنند. معمولاً انتظار می‌رود که این API توسط IPAMهای گوناگون و سیستم‌های مدیریتی مشابه استفاده شود. با این وجود، ممکن است مواردی پیش بیاید که مدیر سیستم بخواهد فرمانی را مستقیماً به کارساز بفرستد، و پوسته Kea راهکاری برای انجام این کار فراهم می‌کند. این ابزار یک کلاینت متنی خط فرمانیِ ساده و سازگار با اسکریپت‌نویسی است که می‌تواند به کارساز متصل شود، دستورها را همراه با پارامترها به آن ارسال کند، پاسخ‌ها را بازیابی کرده و نمایش دهد.
.sp
از آنجا که هدف اصلی پوسته Kea به کارگیری به عنوان ابزاری در محیط اسکریپت‌نویسی است، تعاملی (interactive) نیست. با این حال، با دنبال کردن دستورالعمل‌های ساده می‌توان آن را به صورت دستی نیز اجرا کرد.
.sp
نسخه 1.9.0 از Kea پشتیبانی از احراز هویت پایه‌ای HTTP (basic HTTP authentication) را معرفی کرد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
نسخه 2.7.2 از Kea پشتیبانی مستقیم از کانال کنترلی HTTP/HTTPS را توسط کارسازهای Kea (\fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4>، \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> و \fBkea\-dhcp\-ddns\fP \%<#\:std-iscman-kea-dhcp-ddns>) معرفی کرده است. ابزار \fBkea\-shell\fP \%<#\:std-iscman-kea-shell> می‌تواند با این کارسازها استفاده شود؛ تنها تفاوت این است که آرگومان \fB\-\-service\fP بی‌فایده شده و توسط کارسازهای Kea نادیده گرفته می‌شود. توجه داشته باشید که نتیجه جهت سازگاری با نسخه‌های پیشین (backward compatibility) در قالب یک لیست کپسوله‌بندی می‌شود.
.UNINDENT
.UNINDENT
.SS "کاربرد پوسته (Shell Usage)"
.sp
\fBkea\-shell\fP \%<#\:std-iscman-kea-shell> به شکل زیر اجرا می‌شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ kea\-shell [\-\-host hostname] [\-\-port number] [\-\-path path] [\-\-auth\-user] [\-\-auth\-password] [\-\-auth\-password\-file] [\-\-timeout seconds] [command]
.EE
.UNINDENT
.UNINDENT
.sp
که در آن:
.INDENT 0.0
.IP \(bu 2
\fB\-\-host hostname\fP نام میزبان (hostname) کارساز را مشخص می‌کند. در صورت عدم تعیین، \(dqlocalhost\(dq استفاده می‌شود.
.IP \(bu 2
\fB\-\-port number\fP درگاه (port) TCP را که کارساز روی آن گوش می‌دهد مشخص می‌کند. در صورت عدم تعیین، 8000 استفاده می‌شود.
.IP \(bu 2
\fB\-\-path path\fP مسیر موجود در URL را برای اتصال مشخص می‌کند. اگر تعیین نشود، یک مسیر خالی استفاده خواهد شد. از آنجا که کارساز روی مسیر خالی گوش می‌دهد، این پارامتر تنها هنگام استفاده از یک پراکسی معکوس (reverse proxy) کاربرد دارد.
.IP \(bu 2
\fB\-\-auth\-user\fP شناسه کاربری را برای احراز هویت پایه‌ای HTTP مشخص می‌کند. اگر تعیین نشود یا به صورت یک رشته خالی مشخص شود، احراز هویت استفاده نخواهد شد.
.IP \(bu 2
\fB\-\-auth\-password\fP گذرواژه را برای احراز هویت پایه‌ای HTTP مشخص می‌کند. در صورتی که مشخص نشده باشد اما شناسه کاربری تعیین شده باشد، یک گذرواژه خالی استفاده می‌شود. اگر همراه با \fB\-\-auth\-password\-file\fP به کار رود، نادیده گرفته می‌شود.
.IP \(bu 2
\fB\-\-auth\-password\-file\fP یک فایل متنی را مشخص می‌کند که خط اول آن حاوی گذرواژه مورد استفاده برای احراز هویت پایه‌ای HTTP است. این پرچم بر پرچم \fB\-\-auth\-password\fP اولویت دارد. توصیه می‌شود هنگام تنظیم مجوزهای دسترسی برای فایل حاوی گذرواژه احتیاط شود. دسترسی به فایل باید تا حد امکان محدود بوده و تنها به مدیران Kea محدود شود.
.IP \(bu 2
\fB\-\-timeout seconds\fP مهلت زمانی (timeout بر حسب ثانیه) را برای اتصال مشخص می‌کند. اگر داده نشود، 10 ثانیه استفاده می‌شود.
.IP \(bu 2
\fB\-\-service service\-name\fP اکنون منسوخ شده است اما برای سازگاری با گذشته همچنان شناسایی می‌شود.
.IP \(bu 2
\fBcommand\fP دستوری را که باید ارسال شود مشخص می‌کند. در صورت عدم تعیین، دستور \fBlist\-commands\fP \%<#\:std-isccmd-list-commands> استفاده می‌شود.
.UNINDENT
.sp
سایر سوییچ‌ها عبارتند از:
.INDENT 0.0
.IP \(bu 2
\fB\-h\fP \- یک پیام راهنما چاپ می‌کند.
.IP \(bu 2
\fB\-v\fP \- نسخه Kea را نمایش می‌دهد.
.IP \(bu 2
\fB\-V\fP \- نسخه گسترده Kea را نمایش می‌دهد.
.UNINDENT
.sp
برای آرگومان‌های خط فرمان جدید مربوط به پشتیبانی از TLS/HTTPS، به بخش TLS Support مراجعه کنید.
.sp
پس از اجرا، پوسته پارامترهای دستور را از ورودی استاندارد می‌خواند که انتظار می‌رود در قالب JSON باشند. هنگامی که همه خوانده شدند، پوسته با استفاده از HTTP ارتباطی را با کارساز برقرار می‌کند، دستور را می‌فرستد و منتظر پاسخ می‌ماند. پس از دریافت پاسخ، آن را در خروجی استاندارد نمایش می‌دهد.
.sp
برای فهرستی از دستورات در دسترس، به Management API \%<#\:ctrl-channel> مراجعه کنید؛ ممکن است دستورات اضافی توسط کتابخانه‌های هوک (hook) ارائه شوند. برای دریافت فهرستی از تمام دستورات پشتیبانی‌شده توسط کارساز، از دستور \fBlist\-commands\fP \%<#\:std-isccmd-list-commands> استفاده کنید.
.sp
نمونه ساده‌ای از نحوه استفاده در زیر نشان داده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ kea\-shell \-\-host 192.0.2.1 \-\-port 8001 \-\-auth\-user foo \-\-auth\-password\-file secret_file list\-commands
^D
.EE
.UNINDENT
.UNINDENT
.sp
پس از وارد کردن خط فرمان، برنامه منتظر ورود پارامترهای دستور می‌ماند. از آنجا که \fBlist\-commands\fP \%<#\:std-isccmd-list-commands> هیچ آرگومانی نمی‌پذیرد، Ctrl\-D (که در مثال بالا با \(dq^D\(dq نشان داده شده است) بیانگر پایان فایل (end\-of\-file) بوده و ورودی پارامترها را خاتمه می‌دهد. سپس پوسته با کارساز ارتباط برقرار کرده و فهرست دستورات در دسترس بازگردانده‌شده برای کارساز را چاپ می‌کند.
.sp
پوسته Kea احتمالاً بیشتر در اسکریپت‌ها مورد استفاده قرار خواهد گرفت؛ مثال بعدی یک اجرای اسکریپت‌شده ساده را نشان می‌دهد. این مثال دستور \fBconfig\-write\fP \%<#\:std-isccmd-config-write> را به همراه پارامترهای مشخص‌شده در param.json به کارساز ارسال می‌کند. نتیجه در result.json ذخیره خواهد شد.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ cat param.json
\(dqfilename\(dq: \(dqmy\-config\-file.json\(dq
$ cat param.json | kea\-shell \-\-host 192.0.2.1 config\-write > result.json
.EE
.UNINDENT
.UNINDENT
.sp
هنگامی که از یک پراکسی معکوس برای تفکیک (de\-multiplex) درخواست‌ها به کارسازهای مختلف استفاده می‌شود، مسیر خالیِ پیش‌فرض در URL کافی نیست؛ بنابراین باید از پارامتر \fB\-\-path\fP استفاده شود. برای نمونه، اگر درخواست‌های ارسال‌شده به مسیر \(dq/kea\(dq به کارساز هدایت شوند، می‌توان این مورد را به کار برد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ kea\-shell \-\-host 192.0.2.1 \-\-port 8001 \-\-path kea ...
.EE
.UNINDENT
.UNINDENT
.sp
پوسته Kea نیازمند نصب بودن Python روی سیستم است. این ابزار با نسخه‌های مختلف Python 3 آزمایش شده است.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
از نسخه 2.4.0 کی‌آ به بعد، \fBkea\-shell\fP \%<#\:std-iscman-kea-shell> دیگر از Python 2.7 پشتیبانی نمی‌کند.
.UNINDENT
.UNINDENT
.sp
پوسته Kea بیش از آنکه یک کلاینت مدیریتی جدی باشد، با این هدف طراحی شده که نمایانگر قابلیت‌های رابط RESTful (و شاید نمونه‌ای برای افرادی که علاقه‌مند به یکپارچه‌سازی محیط‌های مدیریتی خود با Kea هستند) باشد. بعید است که در آینده به طور چشمگیری توسعه یابد؛ این ابزار یک ابزار ساده است و ساده باقی خواهد ماند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
هنگام استفاده از این ابزار با احراز هویت پایه‌ای HTTP، لطفاً به یاد داشته باشید که آرگومان‌های خط فرمان از دید کاربران محلی پنهان نیستند.
.UNINDENT
.UNINDENT.SS "پشتیبانی از TLS"
.sp
ابزار \fBkea\-shell\fP \%<#\:std-iscman-kea-shell> از اتصالات HTTPS پشتیبانی می‌کند؛ پشتیبانی
از TLS/HTTPS نیازمند Python 3 است. آرگومان‌های اضافی خط فرمان عبارتند از:
.INDENT 0.0
.IP \(bu 2
\fB\-\-ca\fP نام فایل یا دایرکتوری مرجع صدور گواهی (CA) را مشخص می‌کند. در صورت عدم
تعیین، از HTTPS استفاده نمی‌شود.
.IP \(bu 2
\fB\-\-cert\fP نام فایل گواهی کلید عمومی نهاد نهایی (end\-entity) کاربر را مشخص می‌کند.
در صورت تعیین، نام فایل کلید کاربر نیز باید مشخص شود.
.IP \(bu 2
\fB\-\-key\fP نام فایل کلید کاربر را مشخص می‌کند. در صورت تعیین،
نام فایل گواهی کاربر نیز باید مشخص شود.
فایل‌های کلید رمزنگاری‌شده پشتیبانی نمی‌شوند.
.UNINDENT
.sp
برای مثال، یک درخواست پایه HTTPS برای دریافت فهرست دستورات می‌تواند
به این صورت باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ kea\-shell \-\-host 127.0.0.1 \-\-port 8000 \-\-ca ./kea\-ca.crt list\-commands
.EE
.UNINDENT
.UNINDENT
.SH "یکپارچه‌سازی با سیستم‌های خارجی (INTEGRATION WITH EXTERNAL SYSTEMS)"
.sp
سامانه Kea پشتیبانی اختیاری از انواع سیستم‌های خارجی مانند RADIUS، NETCONF،
YANG و GSS\-TSIG را فراهم می‌آورد. بخش‌های زیر نحوه کامپایل Kea به همراه این قابلیت‌های
اضافی و چگونگی پیکربندی آن‌ها را شرح می‌دهند.
.SS "YANG/NETCONF"
.SS "نمای کلی (Overview)"
.sp
پروتکل پیکربندی شبکه یا NETCONF، یک پروتکل مدیریت شبکه است که در
RFC 6241 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc6241>\& تعریف شده است. این پروتکل از زبان مدل‌سازی YANG،
تعریف‌شده در RFC 6020 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc6020>، برای ایجاد روشی یکپارچه
جهت مدیریت ساختار نحوی پیکربندی دستگاه‌های مختلف شبکه بهره می‌برد. Kea پشتیبانی
اختیاری از یک رابط YANG/NETCONF را از طریق عامل \fBkea\-netconf\fP \%<#\:std-iscman-kea-netconf> فراهم می‌کند.
.SS "نصب NETCONF"
.sp
برای دستیابی به قابلیت‌های NETCONF، نرم‌افزار Kea به نسخه‌های v3 از libyang و
Sysrepo نیاز دارد. نسخه‌های خاصی که به طور کامل با Kea آزمایش شده‌اند عبارتند از:
.INDENT 0.0
.IP \(bu 2
libyang v3.13.5 (کامیت efe43e3790822a3dc64d7d28db935d03fff8b81f)
.IP \(bu 2
sysrepo v3.7.11 (کامیت 1b720b196f630f348d9e0c131d326b3fb8c6aca7)
.IP \(bu 2
libyang\-cpp v3 (کامیت f3cd4e05462a16e81d6bfd0c4a5b385cf88a8549)
.IP \(bu 2
sysrepo\-cpp v3 (کامیت fe4edfa3998fdf312099ee1fb08a06983b6907f6)
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
\fBkea\-netconf\fP \%<#\:std-iscman-kea-netconf> ممکن است با نسخه‌های جدیدتر libyang و
Sysrepo سازگار باشد، اما تنها نسخه‌های ذکرشده در بالا به طور کامل توسط ISC
آزمایش شده‌اند.
.UNINDENT
.UNINDENT
.sp
در صورتی که بسته‌ها توسط سیستم ارائه شده باشند، نصب از طریق بسته‌ها پیشنهاد می‌شود.
در غیر این صورت، کاربران می‌توانند طبق راهنمای زیر برنامه را از روی کد منبع بسازند
که باید بر روی تمام سیستم‌عامل‌های رایج کار کند.
.SS "نصب \fBlibyang\fP از کد منبع"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ git clone https://github.com/CESNET/libyang.git
$ cd libyang
$ git checkout v3.13.5
$ mkdir build
$ cd build
$ cmake ..
$ make
$ make install
.EE
.UNINDENT
.UNINDENT
.SS "نصب \fBsysrepo\fP از کد منبع"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ git clone https://github.com/sysrepo/sysrepo.git
$ cd sysrepo
$ git checkout v3.7.11
$ mkdir build
$ cd build
$ cmake \-DREPO_PATH=/etc/sysrepo ..
$ make
$ make install  # without sudo if you\(aqre doing development and want to run unit tests
.EE
.UNINDENT
.UNINDENT
.SS "نصب \fBlibyang\-cpp\fP از کد منبع"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ git clone https://github.com/CESNET/libyang\-cpp.git
$ cd libyang\-cpp
$ git checkout v3
$ mkdir build
$ cd build
$ cmake \-DBUILD_TESTING=OFF ..
$ make
$ make install
.EE
.UNINDENT
.UNINDENT
.SS "نصب \fBsysrepo\-cpp\fP از کد منبع"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ git clone https://github.com/sysrepo/sysrepo\-cpp.git
$ cd sysrepo\-cpp
$ git checkout v3
$ mkdir build
$ cd build
$ cmake \-DBUILD_TESTING=OFF ..
$ make
$ make install
.EE
.UNINDENT
.UNINDENT.SS "کامپایل به همراه NETCONF"
.INDENT 0.0
.IP 1. 3
دریافت سورس‌کدهای Kea.
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ git clone gitlab.isc.org/isc\-projects/kea.git
$ cd kea
.EE
.UNINDENT
.UNINDENT
.INDENT 0.0
.IP 2. 3
آماده‌سازی ساخت.
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ meson setup build \-D netconf=enabled \-D cpp_std=c++20
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
اگر هر یک از کتابخانه‌ها در یک مکان سفارشی نصب شده باشند، متغیر PKG_CONFIG_PATH می‌تواند به فایل‌های .pc اشاره کند.
.UNINDENT
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
PKG_CONFIG_PATH=:/opt/libyang/lib/pkgconfig:/opt/libyang\-cpp/lib/pkgconfig:/opt/sysrepo/lib/pkgconfig:/opt/sysrepo\-cpp/lib/pkgconfig
.EE
.UNINDENT
.UNINDENT
.INDENT 0.0
.IP 3. 3
برای بررسی پشتیبانی از NETCONF، فایل \fBbuild/config.report\fP را بررسی کنید.
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
NETCONF:
  YANG:               2.1.4
  YANG_PREFIX:        /opt/libyang
  YANGCPP:            1.1.0
  YANGCPP_PREFIX:     /opt/libyang\-cpp
  SYSREPO:            2.2.12
  SYSREPO_PREFIX:     /opt/sysrepo
  SYSREPOCPP:         1.1.0
  SYSREPOCPP_PREFIX:  /opt/sysrepo\-cpp
.EE
.UNINDENT
.UNINDENT
.INDENT 0.0
.IP 4. 3
طبق معمول کامپایل کنید.
.INDENT 3.0
.INDENT 3.5
$ meson compile \-C build
.UNINDENT
.UNINDENT
.UNINDENT
.SS "بررسی اجمالی و سریع Sysrepo"
.sp
این بخش مرور کوتاهی بر زیرمجموعه‌ای از قابلیت‌های موجود در Sysrepo ارائه می‌دهد. برای اطلاعات کامل‌تر، به صفحه اصلی Sysrepo در \%<https://www.sysrepo.org>\& مراجعه کنید.
.sp
در YANG، پیکربندی‌ها و داده‌های وضعیت با نحو YANG در فایل‌های ماژولی به نام \fB<module\-name>[@<revision>].yang\fP توصیف می‌شوند.
.sp
بخش بازبینی (revision) اختیاری است و از قالب \fBYYYY\-MM\-DD\fP پیروی می‌کند. یک نحو XML جایگزین به نام YIN نیز تعریف شده است اما کاربرپسندی کمتری دارد. ماژول‌های سطح بالا در مدل‌های Kea (نسخه کوتاه‌شده مدل‌های طرح‌واره) نام‌گذاری می‌شوند.
.sp
دو ماژول اصلی وجود دارند که Kea قادر به پشتیبانی از آن‌هاست: \fBkea\-dhcp4\-server\fP و \fBkea\-dhcp6\-server\fP\&. اگرچه تلاشی فعال در کارگروه DHC در IETF برای توسعه مدل YANG برای DHCPv6 در جریان است، ابتکار مشابهی در گذشته برای DHCPv4 با شکست مواجه شد. بنابراین، Kea از مدل‌های اختصاصی خود برای DHCPv4 و DHCPv6 استفاده می‌کند اما به صورت جزئی از مدل IETF برای DHCPv6 نیز پشتیبانی می‌کند.
.sp
همه این مدل‌ها دارای ماژول‌های اضافی به عنوان پیش‌نیاز هستند که آن‌ها نیز ارائه شده‌اند. تمام این ماژول‌ها را می‌توان در \fBsrc/share/yang/modules\fP در سورس‌کدها و در \fBshare/kea/yang/modules\fP در دایرکتوری محل نصب یافت. در دستورهای زیر، از این دایرکتوری با عنوان \fI${share_directory}\fP یاد می‌شود.
.sp
برای نصب ماژول‌ها از سورس‌کد یا ارتقای آن‌ها از نسخه‌های بازبینی قبلی، دستور زیر را اجرا کنید. در صورت ارتقای نسخه، داده‌های YANG به طور خودکار به طرح‌واره ماژول جدید مهاجرت داده می‌شوند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ ${share_directory}/yang/modules/utils/reinstall.sh
.EE
.UNINDENT
.UNINDENT
.sp
با این حال، اگر در طول فرآیند ارتقا مشکلی پیش بیاید و بتوان داده‌ها را از طریق یک کلاینت NETCONF یا روش‌های دیگر دوباره ایجاد کرد، ماژول‌های Kea را می‌توان قبل از نصب مجدد، به راحتی با این دستور حذف نصب کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ ${share_directory}/yang/modules/utils/reinstall.sh \-u
.EE
.UNINDENT
.UNINDENT
.sp
این اسکریپت باید بتواند Sysrepo را مجدداً نصب کند. با این حال، از پرچم \fB\-s\fP نیز می‌توان برای مشخص کردن یک مسیر استفاده کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ ./build/src/share/yang/modules/utils/reinstall.sh \-s /path/to/sysrepo
.EE
.UNINDENT
.UNINDENT
.sp
برای نصب تک‌تک تمام ماژول‌ها:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ cd ./src/share/yang/modules
$ sysrepoctl \-i ./ietf\-dhcpv6\-server*.yang
$ sysrepoctl \-i ./kea\-dhcp4\-server*.yang
$ sysrepoctl \-i ./kea\-dhcp6\-server*.yang
\&...
.EE
.UNINDENT
.UNINDENT
.sp
فرآیند نصب باید مشابه موارد زیر باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ ./build/src/share/yang/modules/utils/reinstall.sh
[INF] Connection 2 created.
[INF] Module \(dqkeatest\-module\(dq was installed.
[INF] File \(dqkeatest\-module@2022\-11\-30.yang\(dq was installed.
[INF] No datastore changes to apply.
[INF] Connection 4 created.
[ERR] Module \(dqietf\-interfaces@2018\-02\-20\(dq already installed.
[INF] No datastore changes to apply.
[INF] Connection 7 created.
[ERR] Module \(dqietf\-dhcpv6\-client\(dq is already in sysrepo.
[INF] No datastore changes to apply.
[INF] Connection 9 created.
[ERR] Module \(dqietf\-dhcpv6\-relay\(dq is already in sysrepo.
[INF] No datastore changes to apply.
[INF] Connection 11 created.
[ERR] Module \(dqietf\-dhcpv6\-server\(dq is already in sysrepo.
[INF] No datastore changes to apply.
[INF] Connection 13 created.
[ERR] Write permission \(dqietf\-yang\-types\(dq check failed.
[INF] No datastore changes to apply.
[INF] Connection 15 created.
[ERR] Module \(dqietf\-dhcpv6\-options\(dq is already in sysrepo.
[INF] No datastore changes to apply.
[INF] Connection 17 created.
[ERR] Module \(dqietf\-dhcpv6\-types\(dq is already in sysrepo.
[INF] No datastore changes to apply.
[INF] Connection 21 created.
[INF] Module \(dqkea\-types\(dq was installed.
[INF] File \(dqkea\-types@2019\-08\-12.yang\(dq was installed.
[INF] No datastore changes to apply.
[INF] Connection 23 created.
[INF] Module \(dqkea\-dhcp\-types\(dq was installed.
[INF] File \(dqkea\-dhcp\-types@2022\-11\-30.yang\(dq was installed.
[INF] No datastore changes to apply.
[INF] Connection 25 created.
[INF] Module \(dqkea\-dhcp\-ddns\(dq was installed.
[INF] File \(dqkea\-dhcp\-ddns@2022\-07\-27.yang\(dq was installed.
[INF] No datastore changes to apply.
[INF] Connection 27 created.
[INF] Connection 28 created.
[INF] Module \(dqkea\-dhcp4\-server\(dq was installed.
[INF] File \(dqkea\-dhcp4\-server@2022\-11\-30.yang\(dq was installed.
[INF] No datastore changes to apply.
[INF] Connection 30 created.
[INF] Module \(dqkea\-dhcp6\-server\(dq was installed.
[INF] File \(dqkea\-dhcp6\-server@2022\-11\-30.yang\(dq was installed.
[INF] No datastore changes to apply.
.EE
.UNINDENT
.UNINDENT
.sp
برای اطمینان از اینکه ماژول‌ها به درستی وارد (import) شده‌اند، فهرست ماژول‌های YANG نصب‌شده فعلی را بررسی کنید. باید مشابه این باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ sysrepoctl \-l
Sysrepo repository: /etc/sysrepo

Module Name                | Revision   | Flags | Owner     | Startup Perms | Submodules | Features
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
ietf\-datastores            | 2018\-02\-14 | I     | user:user | 444           |            |
ietf\-dhcpv6\-client         | 2018\-09\-04 | I     | user:user | 600           |            |
ietf\-dhcpv6\-options        | 2018\-09\-04 | I     | user:user | 600           |            |
ietf\-dhcpv6\-relay          | 2018\-09\-04 | I     | user:user | 600           |            |
ietf\-dhcpv6\-server         | 2018\-09\-04 | I     | user:user | 600           |            |
ietf\-dhcpv6\-types          | 2018\-09\-04 | I     | user:user | 600           |            |
ietf\-inet\-types            | 2013\-07\-15 | I     | user:user | 444           |            |
ietf\-interfaces            | 2018\-02\-20 | I     | user:user | 600           |            |
ietf\-netconf               | 2013\-09\-29 | I     | user:user | 644           |            |
ietf\-netconf\-acm           | 2018\-02\-14 | I     | user:user | 600           |            |
ietf\-netconf\-notifications | 2012\-02\-06 | I     | user:user | 644           |            |
ietf\-netconf\-with\-defaults | 2011\-06\-01 | I     | user:user | 444           |            |
ietf\-origin                | 2018\-02\-14 | I     | user:user | 444           |            |
ietf\-yang\-library          | 2019\-01\-04 | I     | user:user | 644           |            |
ietf\-yang\-metadata         | 2016\-08\-05 | i     |           |               |            |
ietf\-yang\-schema\-mount     | 2019\-01\-14 | I     | user:user | 644           |            |
ietf\-yang\-types            | 2013\-07\-15 | I     | user:user | 444           |            |
kea\-dhcp\-ddns              | 2022\-07\-27 | I     | user:user | 600           |            |
kea\-dhcp\-types             | 2022\-11\-30 | I     | user:user | 600           |            |
kea\-dhcp4\-server           | 2022\-11\-30 | I     | user:user | 600           |            |
kea\-dhcp6\-server           | 2022\-11\-30 | I     | user:user | 600           |            |
kea\-types                  | 2019\-08\-12 | I     | user:user | 600           |            |
keatest\-module             | 2022\-11\-30 | I     | user:user | 600           |            |
sysrepo\-monitoring         | 2022\-04\-08 | I     | user:user | 600           |            |
sysrepo\-plugind            | 2022\-03\-10 | I     | user:user | 644           |            |
yang                       | 2022\-06\-16 | I     | user:user | 444           |            |

Flags meaning: I \- Installed/i \- Imported; R \- Replay support
.EE
.UNINDENT
.UNINDENT
.sp
برای نصب مجدد یک ماژول، اگر مدخل بازبینی (revision) در YANG افزایش یافته باشد، نصب ساده آن را به طور خودکار به‌روزرسانی خواهد کرد. در غیر این صورت، ابتدا باید حذف نصب شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ sysrepoctl \-u kea\-dhcp4\-server
.EE
.UNINDENT
.UNINDENT
.sp
اگر ماژول توسط ماژول‌های دیگر استفاده (یعنی وارد/import) شده باشد، تنها پس از آنکه ماژول‌های وابسته ابتدا حذف نصب شدند، می‌توان آن را حذف نصب کرد. نصب و حذف نصب باید به ترتیب وابستگی و ترتیب معکوس وابستگی، بسته به مورد، انجام گیرد..SS مدل‌های پشتیبانی‌شدهٔ YANG (Supported YANG Models)
.sp
مدل‌های پشتیبانی‌شده در حال حاضر \fBkea\-dhcp4\-server\fP و
\fBkea\-dhcp6\-server\fP هستند\&. پشتیبانی جزئی از
\fBietf\-dhcpv6\-server\fP وجود دارد، اما تمرکز اصلی آزمایش‌ها روی سرورهای Kea DHCP
بوده است. سایر مدل‌ها (مانند \fBkea\-dhcp\-ddns\fP \%<#\:std-iscman-kea-dhcp-ddns>) در حال حاضر پشتیبانی نمی‌شوند.
.SS استفاده از کارگزار NETCONF (Using the NETCONF Agent)
.sp
کارگزار NETCONF از این الگوریتم پیروی می‌کند:
.INDENT 0.0
.IP \(bu 2
برای هر سرور مدیریت‌شده، پیکربندی اولیه را از طریق سوکت کنترل
از سرور دریافت می‌کند.
.IP \(bu 2
یک اتصال با محیط Sysrepo باز کرده و دو نشست با مخازن دادهٔ startup و running برقرار می‌سازد.
.IP \(bu 2
بررسی می‌کند که ماژول‌های استفاده‌شده (غیرضروری / not\-essential) و مورد نیاز (ضروری / essential)
با نسخهٔ بازبینی (revision) صحیح در مخزن Sysrepo نصب شده باشند. اگر یک ماژول
ضروری \- یعنی ماژولی که طرح‌وارهٔ (schema) پیکربندی برای یک سرور مدیریت‌شده در آن
تعریف شده است \- نصب نشده باشد، یک خطای مهلک (fatal error) صادر می‌کند.
.IP \(bu 2
برای هر سرور مدیریت‌شده، پیکربندی YANG را از مخزن دادهٔ startup دریافت کرده،
آن را به JSON ترجمه می‌کند و روی سروری که در حال پیکربندی است بارگذاری می‌نماید.
.IP \(bu 2
برای هر سرور مدیریت‌شده، یک فراخوانی برگشتی (callback) تغییر ماژول را با استفاده از
نام مدل آن ثبت (subscribe) می‌کند.
.IP \(bu 2
هنگامی که یک پیکربندی running تغییر می‌کند، تلاش می‌کند تا پیکربندی به‌روزرسانی‌شده
را از طریق فراخوانی برگشتی به سرور مدیریت‌شده اعتبارسنجی یا بارگذاری کند.
.UNINDENT
.SS پیکربندی (Configuration)
.sp
رفتار شرح‌داده‌شده در «استفاده از کارگزار NETCONF»
توسط چندین پرچم پیکربندی کنترل می‌شود، که می‌توانند در دامنهٔ سراسری (global scope)
یا در دامنهٔ یک سرور مدیریت‌شدهٔ خاص تنظیم شوند. در صورت مورد دوم،
مقدار تعریف‌شده در دامنهٔ سرور مدیریت‌شده اولویت دارد. این
پرچم‌ها عبارتند از:
.INDENT 0.0
.IP \(bu 2
\fBboot\-update\fP \- فاز پیکربندی اولیه را کنترل می‌کند؛ هنگامی که
\fBtrue\fP باشد (پیش‌فرض)، ابتدا پیکربندی اولیهٔ دریافت‌شده از فایل پیکربندی
کلاسیک JSON سرور Kea بارگذاری شده و سپس مدل YANG در زمان راه‌اندازی (startup)
بارگذاری می‌شود. این تنظیم به مدیران سیستم امکان می‌دهد یک سوکت کنترل را در فایل
JSON محلی تعریف کرده و سپس پیکربندی را از YANG بارگیری کنند. در صورت تنظیم روی
\fBfalse\fP، از این فاز صرف‌نظر می‌شود.
.IP \(bu 2
\fBsubscribe\-changes\fP \- اشتراک تغییرات ماژول را کنترل
می‌کند؛ هنگامی که \fBtrue\fP باشد (پیش‌فرض)، یک فراخوانی برگشتی تغییر ماژول
ثبت می‌شود، اما هنگامی که \fBfalse\fP باشد از این فاز صرف‌نظر شده و به‌روزرسانی‌های
پیکربندی running غیرفعال می‌شوند. هنگامی که روی \fBtrue\fP تنظیم شود، از مخزن
دادهٔ running برای اشتراک تغییرات استفاده می‌شود.
.IP \(bu 2
\fBvalidate\-changes\fP \- نحوهٔ نظارت Kea بر تغییرات پیکربندی
Sysrepo را کنترل می‌کند. Sysrepo دو مرحله را ارائه می‌دهد که Kea می‌تواند در آن‌ها
تعامل داشته باشد: اعتبارسنجی (validation) و اِعمال (application). در مرحلهٔ اعتبارسنجی (یا
رویداد \fBSR_EV_CHANGE\fP طبق نام‌گذاری در Sysrepo)، Kea پیکربندی تازه نهایی‌شده (committed)
را دریافت کرده و آن را راستی‌آزمایی می‌کند. اگر پیکربندی به هر دلیلی نادرست باشد،
سرورهای Kea آن را رد می‌کنند و خطا به Sysrepo پس فرستاده می‌شود، که متعاقباً یک
خطا بازمی‌گرداند. این مرحله تنها در صورتی انجام می‌شود که \fBvalidate\-changes\fP روی
\fBtrue\fP تنظیم شده باشد\&. در مرحلهٔ اِعمال (یا رویداد \fBSR_EV_UPDATE\fP طبق نام‌گذاری
در Sysrepo)، پیکربندی واقعی اِعمال می‌شود. در این مرحله Kea می‌تواند پیکربندی را دریافت کند،
اما برای گزارش هرگونه خطا به عقب بسیار دیر است چرا که پیکربندی قبلاً نهایی شده است.
.UNINDENT
.sp
ایدهٔ نهفته در فاز پیکربندی اولیه این است که سرورهای Kea با حداقل پیکربندی که
تنها شامل یک سوکت کنترل است راه‌اندازی شوند تا مدیریت‌پذیر گردند. برای نمونه، برای سرور DHCPv4:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqDhcp4\(dq: {
        \(dqcontrol\-socket\(dq: {
           \(dqsocket\-name\(dq: \(dqkea\-dhcp4\-ctrl.sock\(dq,
           \(dqsocket\-type\(dq: \(dqunix\(dq
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
با فعال بودن اشتراک‌های تغییرات ماژول، دیمن \fBkea\-netconf\fP \%<#\:std-iscman-kea-netconf>
هرگونه تغییر پیکربندی را به محض پدیدار شدن در Sysrepo نظارت می‌کند. چنین
تغییراتی را می‌توان با استفاده از ابزار \fBsysrepocfg\fP یا از راه دور با استفاده از
هر کلاینت NETCONF انجام داد. برای جزئیات، لطفاً به مستندات Sysrepo یا
A Step\-by\-Step NETCONF Agent Operation Example مراجعه کنید\&.
از این ابزارها می‌توان برای اصلاح پیکربندی‌های YANG در مخزن دادهٔ
running استفاده کرد. توجه داشته باشید که پیکربندی‌های ثبت‌شده (committed) تنها در مخزن
دادهٔ running به‌روزرسانی می‌شوند؛ برای حفظ آن‌ها در بین راه‌اندازی‌های مجدد سرور، باید در
مخزن دادهٔ startup کپی شوند.
.sp
هنگامی که تغییرات ماژول ردیابی می‌شوند (با استفاده از \fBsubscribe\-changes\fP تنظیم‌شده روی
\fBtrue\fP) و پیکربندی running تغییر کرده است (مثلاً با استفاده از
\fBsysrepocfg\fP یا هر کلاینت NETCONF)، فراخوانی برگشتی پیکربندی اصلاح‌شده
را اعتبارسنجی کرده (اگر \fBvalidate\-changes\fP روی \fBfalse\fP تنظیم نشده باشد)
و برای دومین بار جهت اِعمال پیکربندی جدید اجرا می‌شود. اگر اعتبارسنجی
ناموفق باشد، فراخوانی برگشتی همچنان دوباره فراخوانی می‌شود اما با یک رویداد \fBSR_EV_ABORT\fP
(در مقابل \fBSR_EV_DONE\fP) به همراه تغییرات بازگردانی (rollback).
.sp
کد بازگشتی فراخوانی برگشتی در رویداد \fBSR_EV_DONE\fP نادیده گرفته می‌شود، زیرا
برای رد کردن یک پیکربندی نامناسب دیگر خیلی دیر است.
.sp
چهار حالت وجود دارد که در آن‌ها ممکن است یک پیکربندی اصلاح‌شدهٔ YANG
نادرست باشد:
.INDENT 0.0
.IP 1. 3
ممکن است با طرح‌واره (schema) ناسازگار باشد؛ برای نمونه یک مدخل ناشناخته، نبودِ
یک مدخل اجباری، مقداری با نوع نادرست، یا عدم تطابق با یک قید (constraint).
.IP 2. 3
ممکن است در ترجمه از YANG به JSON شکست بخورد؛ مانند یک بافت کاربری (user context) نامعتبر.
.IP 3. 3
ممکن است در بررسی‌های سلامت (sanity checks) سرور Kea رد شود؛ مانند یک محدودهٔ خارج از استخر زیرشبکه (out\-of\-subnet\-pool)
یا یک نوع پایگاه‌دادهٔ پشتیبانی‌نشده.
.IP 4. 3
نحو ممکن است درست باشد و بررسی‌های سلامت سرور را با موفقیت بگذراند، اما
پیکربندی در زمان اجرا با شکست مواجه شود؛ برای نمونه، پیکربندی حاوی اطلاعات احراز هویت پایگاه‌داده
باشد اما پایگاه‌داده اتصال را رد کند.
.UNINDENT
.sp
حالت نخست توسط Sysrepo مدیریت می‌شود. حالت‌های دوم و سوم توسط
\fBkea\-netconf\fP \%<#\:std-iscman-kea-netconf> در فاز اعتبارسنجی رسیدگی می‌شوند (در صورتی که با
تنظیم \fBvalidate\-changes\fP روی \fBtrue\fP غیرفعال نشده باشد). مورد آخر باعث می‌شود
فاز اِعمال بدون گزارشی معقول به Sysrepo با شکست مواجه شود.
.sp
سرورها و کارگزارهای مدیریت‌شدهٔ Kea در بخش
\fBmanaged\-servers\fP شرح داده شده‌اند. هر زیربخش با نام سرویس آغاز می‌شود:
\fBdhcp4\fP، \fBdhcp6\fP و \fBd2\fP\&.
.sp
هر مدخل سرور مدیریت‌شده می‌تواند شامل موارد زیر باشد:
.INDENT 0.0
.IP \(bu 2
پرچم‌های کنترلی \- \fBboot\-update\fP، \fBsubscribe\-changes\fP و/یا \fBvalidate\-changes\fP\&.
.IP \(bu 2
\fBmodel\fP \- نام مدل/ماژول YANG را مشخص می‌کند. برای هر سرویس،
پیش‌فرض مدل متناظر Kea YANG است؛ به عنوان نمونه برای \fB\(dqdhcp4\(dq\fP
برابر با \fB\(dqkea\-dhcp4\-server\(dq\fP است\&.
.IP \(bu 2
\fBcontrol\-socket\fP \- سوکت کنترل را برای مدیریت پیکربندی سرویس
مشخص می‌کند.
.UNINDENT
.sp
یک سوکت کنترل با موارد زیر مشخص می‌شود:
.INDENT 0.0
.IP \(bu 2
\fBsocket\-type\fP \- نوع سوکت یکی از موارد \fBstdout\fP، \fBunix\fP یا \fBhttp\fP است\&.
\fBstdout\fP مقدار پیش‌فرض است؛
این گزینه در واقع یک سوکت نیست، اما به \fBkea\-netconf\fP \%<#\:std-iscman-kea-netconf> اجازه می‌دهد
در حالت اشکال‌زدایی اجرا شود که در آن همه‌چیز در stdout چاپ می‌شود، و همچنین
می‌تواند برای هدایت مجدد آسان دستورات استفاده شود. \fBunix\fP کانال کنترل مستقیم
و استاندارد سرور است که از سوکت‌های UNIX استفاده می‌کند؛ \fBhttp\fP از
یک کانال کنترل استفاده می‌کند که اتصالات HTTP را می‌پذیرد.
.IP \(bu 2
\fBsocket\-name\fP \- نام سوکت محلی برای نوع سوکت \fBunix\fP
(پیش‌فرض یک رشتهٔ خالی است).
.IP \(bu 2
\fBsocket\-url\fP \- آدرس URL مبتنی بر HTTP برای نوع سوکت \fBhttp\fP (پیش‌فرض
\fBhttp://127.0.0.1:8000\fP).
.UNINDENT
.sp
بافت‌های کاربری (User contexts) می‌توانند داده‌های دلخواه را تا زمانی که دارای نحو معتبر
JSON باشند و عنصر سطح بالای آن‌ها یک نگاشت (map) باشد (یعنی داده‌ها باید در آکولاد
محصور شده باشند) ذخیره کنند. آن‌ها در مدخل NETCONF، یعنی در دامنه‌های زیرِ سطح بالا،
مدخل managed\-service و مدخل control\-socket پذیرفته می‌شوند.
.sp
کتابخانه‌های قلاب (Hook libraries) می‌توانند درست مانند سایر سرورها یا کارگزارها
توسط کارگزار NETCONF بارگذاری شوند؛ با این حال، در حال حاضر هیچ نقطهٔ قلابی (hook point)
تعریف نشده است. فهرست \fBhooks\-libraries\fP حاوی فهرستی از کتابخانه‌های قلاب است که
باید توسط \fBkea\-netconf\fP \%<#\:std-iscman-kea-netconf> بارگذاری شوند، به همراه اطلاعات
پیکربندی آن‌ها که با \fBparameters\fP مشخص می‌شود\&.
.sp
لطفاً برای جزئیات مربوط به نحوهٔ پیکربندی ثبت رویدادها، Logging \%<#\:logging> را بررسی
کنید. نام ثبت‌کنندهٔ اصلی کارگزار NETCONF برابر با \fBkea\-netconf\fP \%<#\:std-iscman-kea-netconf>
است، همان‌طور که در مثال بالا نشان داده شده است..SS نمونه‌ای از پیکربندی \fBkea\-netconf\fP \%<#\:std-iscman-kea-netconf>
.sp
مثال زیر پیکربندی پایه NETCONF را نشان می‌دهد. مثال‌های بیشتری در
دایرکتوری \fBdoc/examples/netconf\fP در کدهای منبع Kea در دسترس است.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک مثال ساده از پیکربندی برای عامل NETCONF است.
// این سرور یک رابط YANG برای تمامی سرورهای Kea و عامل فراهم می‌کند.
{
    \(dqNetconf\(dq:
    {
        // پرچم‌های کنترلی را می‌توان در حوزه سراسری یا
        // در حوزه یک سرور مدیریت‌شده تعریف کرد. ترتیب اولویت‌ها عبارتند از:
        // \- استفاده از مقدار پیش‌فرض (true)
        // \- استفاده از مقدار سراسری
        // \- استفاده از مقدار محلی.
        // بنابراین این گزینه، مقدار پیش‌فرض را بازنویسی می‌کند:
        \(dqboot\-update\(dq: false,

        // این نگاشت مشخص می‌کند هر سرور چگونه مدیریت می‌شود. برای هر سرور
        // یک نام از مدل YANG برای استفاده و کانال کنترل وجود دارد.
        // در حال حاضر سه نوع کانال کنترل پشتیبانی می‌شوند:
        // \(dqstdout\(dq که پیکربندی را در خروجی استاندارد چاپ می‌کند،
        // \(dqunix\(dq که از کانال کنترل محلی پشتیبانی‌شده توسط سرورهای
        // \(dqdhcp4\(dq و \(dqdhcp6\(dq استفاده می‌کند (پشتیبانی از \(dqd2\(dq هنوز در دسترس نیست)،
        // و \(dqhttp\(dq که از کانال‌های کنترل HTTP/HTTPS استفاده می‌کند.
        \(dqmanaged\-servers\(dq:
        {
            // به این روش kea\-netconf می‌تواند با سرور DHCPv4 ارتباط برقرار کند.
            \(dqdhcp4\(dq:
            {
                \(dqcomment\(dq: \(dqDHCPv4 server\(dq,
                \(dqmodel\(dq: \(dqkea\-dhcp4\-server\(dq,
                \(dqcontrol\-socket\(dq:
                {
                    \(dqsocket\-type\(dq: \(dqunix\(dq,
                    \(dqsocket\-name\(dq: \(dqkea4\-ctrl\-socket\(dq
                }
            },

            // پارامترهای DHCPv6.
            \(dqdhcp6\(dq:
            {
                \(dqmodel\(dq: \(dqkea\-dhcp6\-server\(dq,
                \(dqcontrol\-socket\(dq:
                {
                    \(dqsocket\-type\(dq: \(dqunix\(dq,
                    \(dqsocket\-name\(dq: \(dqkea6\-ctrl\-socket\(dq
                }
            },

            \(dqd2\(dq:
            {
                \(dqmodel\(dq: \(dqkea\-dhcp\-ddns\(dq,
                \(dqcontrol\-socket\(dq:
                {
                    \(dqsocket\-type\(dq: \(dqunix\(dq,
                    \(dqsocket\-name\(dq: \(dqkea\-ddns\-ctrl\-socket\(dq,
                    \(dquser\-context\(dq: { \(dqin\-use\(dq: true }
                }
            },

            \(dqdhcp4\-http\(dq:
            {
                \(dqcomment\(dq: \(dqDHCPv4 server using HTTP\(dq,
                \(dqmodel\(dq: \(dqkea\-dhcp4\-server\(dq,
                \(dqcontrol\-socket\(dq:
                {
                    \(dqsocket\-type\(dq: \(dqhttp\(dq,
                    \(dqsocket\-url\(dq: \(dqhttp://127.0.0.1:8000/\(dq
                }
            }
        },

        // ابزار kea\-netconf قادر است کتابخانه‌های hook را برای ارتقای عملکرد خود بارگذاری کند.
        // در حال حاضر هیچ نقطه hookای در پردازش kea\-netconf
        // تعریف نشده است.
        \(dqhooks\-libraries\(dq: [
            // فهرست کتابخانه‌های hook می‌تواند شامل بیش از یک کتابخانه باشد.
            {
                // تنها پارامتر ضروری، نام فایل کتابخانه است.
                \(dqlibrary\(dq: \(dqcustom_hooks_example.so\(dq,

                // برخی کتابخانه‌ها ممکن است از پارامترها پشتیبانی کنند. دقت کنید
                // که این بخش را با دقت وارد کنید، زیرا kea\-netconf آن را
                // اعتبارسنجی نمی‌کند (چرا که قالب آن مختص همان کتابخانه است).
                \(dqparameters\(dq: {
                    \(dqparam1\(dq: \(dqfoo\(dq
                }
            }
        ],

        // همانند سایر مؤلفه‌های Kea، بخش NETCONF نیز از ثبت گزارش استفاده می‌کند.
        \(dqloggers\(dq: [
            {
                \(dqname\(dq: \(dqkea\-netconf\(dq,
                \(dqoutput\-options\(dq: [
                    {
                        \(dqoutput\(dq: \(dq/var/log/kea/kea\-netconf.log\(dq,
                        // علاوه بر خروجی معمول، چندین پارامتر
                        // اضافی نیز ممکن است.
                        // پارامتر Flush تعیین می‌کند آیا ثبت‌کننده خروجی را
                        //  در فایل تخلیه می‌کند یا خیر.
                        // پارامتر Maxsize حداکثر اندازه فایل را پیش از چرخش
                        // آن تعیین می‌کند.
                        // پارامتر Maxver حداکثر تعداد فایل‌های چرخیده‌شده
                        //  برای نگهداری را مشخص می‌کند.
                        \(dqflush\(dq: true,
                        \(dqmaxsize\(dq: 204800,
                        \(dqmaxver\(dq: 4
                    }
                ],
                \(dqseverity\(dq: \(dqINFO\(dq,
                \(dqdebuglevel\(dq: 0
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT.SS راه‌اندازی و متوقف‌سازی عامل NETCONF
.sp
\fBkea\-netconf\fP \%<#\:std-iscman-kea-netconf> گزینه‌های خط فرمان زیر را می‌پذیرد:
.INDENT 0.0
.IP \(bu 2
\fB\-c file\fP \- فایل پیکربندی را مشخص می‌کند.
.IP \(bu 2
\fB\-d\fP \- مشخص می‌کند که آیا ثبت گزارش‌های عامل باید به حالت اشکال‌زدایی/پرجزئیات تغییر کند یا خیر. در حالت پرجزئیات، شدت ثبت گزارش و debuglevel مشخص‌شده در فایل پیکربندی نادیده گرفته شده و شدت \(dqdebug\(dq و بیشترین سطح اشکال‌زدایی (99) فرض می‌شود. این پرچم برای تغییر موقت سرور به حداکثر جزئیات، مثلاً هنگام اشکال‌زدایی، مناسب است.
.IP \(bu 2
\fB\-t file\fP \- فایل پیکربندی را برای آزمودن مشخص می‌کند.
\fBkea\-netconf\fP \%<#\:std-iscman-kea-netconf> تلاش می‌کند آن را بارگذاری کرده و بررسی‌های سلامت را انجام دهد؛ برخی بررسی‌ها تنها هنگام اجرای سرور واقعی امکان‌پذیر هستند. وضعیت واقعی با کد خروج گزارش می‌شود (0 = پیکربندی معتبر به نظر می‌رسد، 1 = با خطا مواجه شد). هنگام آزمودن پیکربندی، Kea پیام‌های گزارش را به خروجی استاندارد و خطاها را به خطای استاندارد ارسال می‌کند.
.IP \(bu 2
\fB\-v\fP \- نسخه \fBkea\-netconf\fP \%<#\:std-iscman-kea-netconf> را نمایش داده و خارج می‌شود.
.IP \(bu 2
\fB\-V\fP \- اطلاعات تفصیلی نسخه \fBkea\-netconf\fP \%<#\:std-iscman-kea-netconf> را نمایش داده و خارج می‌شود. این فهرست شامل نسخه‌های کتابخانه‌هایی است که به صورت پویا به Kea پیوند خورده‌اند.
.IP \(bu 2
\fB\-W\fP \- گزارش پیکربندی Kea را نمایش داده و خارج می‌شود. این گزارش رونوشتی از فایل \fBconfig.report\fP تولیدشده توسط \fBmeson setup\fP است؛ این گزارش در باینری اجرایی تعبیه شده است.
.sp
محتوای فایل \fBconfig.report\fP همچنین می‌تواند با بررسی برخی کتابخانه‌ها در درخت نصب یا درخت کد مبدا در دسترس قرار گیرد.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
# from installation using libkea\-process.so
$ strings ${prefix}/lib/libkea\-process.so | sed \-n \(aqs/;;;; //p\(aq

# from sources using libkea\-process.so
$ strings src/lib/process/.libs/libkea\-process.so | sed \-n \(aqs/;;;; //p\(aq

# from sources using libkea\-process.a
$ strings src/lib/process/.libs/libkea\-process.a | sed \-n \(aqs/;;;; //p\(aq

# from sources using libcfgrpt.a
$ strings src/lib/process/cfgrpt/.libs/libcfgrpt.a | sed \-n \(aqs/;;;; //p\(aq
.EE
.UNINDENT
.UNINDENT
.UNINDENT
.SS نمونه گام‌به‌گام عملکرد عامل NETCONF
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
نسخه‌هایی از پیکربندی‌های نمونه ارائه‌شده در این بخش را می‌توان در کد مبدا Kea، تحت مسیر \fBdoc/examples/netconf/kea\-dhcp6\-operations\fP یافت.
.UNINDENT
.UNINDENT
.SS راه‌اندازی نمونه عملکرد عامل NETCONF
.sp
سیستم آزمایشی دارای یک رابط اترنت به نام eth1 است. در برخی سیستم‌ها امکان تغییر نام رابط‌ها وجود دارد؛ برای نمونه، در لینوکس با یک رابط ens38:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# ip link set down dev ens38
# ip link set name eth1 dev ens38
# ip link set up dev eth1
.EE
.UNINDENT
.UNINDENT
.sp
این رابط باید آدرسی در پیشوند آزمایشی داشته باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# ip \-6 addr add 2001:db8::1/64 dev eth1
.EE
.UNINDENT
.UNINDENT
.sp
سرور Kea DHCPv6 باید با پیکربندی مشخص‌کننده یک سوکت کنترلی برای دریافت دستورات کنترلی اجرا شود. فرایند \fBkea\-netconf\fP \%<#\:std-iscman-kea-netconf> از این سوکت برای برقراری ارتباط با سرور DHCPv6 استفاده می‌کند، یعنی پیکربندی‌های ترجمه‌شده را با استفاده از دستورات کنترلی به آن سرور ارسال می‌نماید. در ادامه نمونه‌ای از پیکربندی سوکت کنترلی برای سرور Kea DHCPv6 آورده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqDhcp6\(dq: {
        \(dqcontrol\-socket\(dq: {
           \(dqsocket\-name\(dq: \(dqkea\-dhcp6\-ctrl.sock\(dq,
           \(dqsocket\-type\(dq: \(dqunix\(dq
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
به منظور اجرای سرور Kea DHCPv6 با استفاده از پیکربندی موجود در فایل netconf/kea\-dhcp6\-operations/boot.json \%<#\:config-example-netconf-kea-dhcp6-operations-boot-json>، دستور زیر را اجرا کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# kea\-dhcp6 \-d \-c boot.json
.EE
.UNINDENT
.UNINDENT
.sp
پیکربندی فعلی سرور را می‌توان از طریق یک سوکت کنترلی با اجرای دستور زیر دریافت کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# echo \(aq{ \(dqcommand\(dq: \(dqconfig\-get\(dq }\(aq | socat UNIX:/opt/kea/var/run/kea/kea\-dhcp6\-ctrl.sock \(aq\-,ignoreeof\(aq
.EE
.UNINDENT
.UNINDENT
.sp
پیکربندی نمونه netconf/kea\-dhcp6\-operations/netconf.json \%<#\:config-example-netconf-kea-dhcp6-operations-netconf-json> برای \fBkea\-netconf\fP \%<#\:std-iscman-kea-netconf>، جهت مدیریت سرور Kea DHCPv6 به شرح زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqNetconf\(dq: {
    \(dqloggers\(dq: [
      {
        \(dqdebuglevel\(dq: 99,
        \(dqname\(dq: \(dqkea\-netconf\(dq,
        \(dqoutput\-options\(dq: [
          {
            \(dqoutput\(dq: \(dqstderr\(dq
          }
        ],
        \(dqseverity\(dq: \(dqDEBUG\(dq
      }
    ],
    \(dqmanaged\-servers\(dq: {
      \(dqdhcp6\(dq: {
        \(dqcontrol\-socket\(dq: {
          \(dqsocket\-name\(dq: \(dqkea\-dhcp6\-ctrl.sock\(dq,
          \(dqsocket\-type\(dq: \(dqunix\(dq
        }
      }
    }
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
توجه داشته باشید که در محیط‌های عملیاتی نباید نیازی به ثبت گزارش در سطح DEBUG وجود داشته باشد.
.sp
عامل Kea NETCONF با دستور زیر راه‌اندازی می‌شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# kea\-netconf \-d \-c netconf.json
.EE
.UNINDENT
.UNINDENT
.sp
اکنون که هر دو \fBkea\-netconf\fP \%<#\:std-iscman-kea-netconf> و \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> در حال اجرا هستند، می‌توان به‌روزرسانی‌های پیکربندی را به سرور DHCPv6 اعمال کرد. در ادامه پیکربندی استخراج‌شده از \fBstartup.xml\fP آمده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
<config xmlns=\(dqurn:ietf:params:xml:ns:yang:kea\-dhcp6\-server\(dq>
  <subnet6>
    <id>1</id>
    <pool>
      <start\-address>2001:db8::1:0</start\-address>
      <end\-address>2001:db8::1:ffff</end\-address>
      <prefix>2001:db8::1:0/112</prefix>
    </pool>
    <subnet>2001:db8::/64</subnet>
  </subnet6>
  <interfaces\-config>
    <interfaces>eth1</interfaces>
  </interfaces\-config>
  <control\-socket>
    <socket\-name>kea\-dhcp6\-ctrl.sock</socket\-name>
    <socket\-type>unix</socket\-type>
  </control\-socket>
</config>
.EE
.UNINDENT
.UNINDENT
.sp
برای اعمال این پیکربندی جدید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ sysrepocfg \-d startup \-f xml \-m kea\-dhcp6\-server \-\-import=startup.xml
.EE
.UNINDENT
.UNINDENT
.sp
\fBkea\-netconf\fP \%<#\:std-iscman-kea-netconf> در فاز مقداردهی اولیه خود، پس از مشترک شدن در تغییرات ماژول در مخزن داده running نرم‌افزار Sysrepo، پیکربندی موجود در مخزن داده startup را به تمام سرورهای Kea ارسال می‌کند. این اقدام، پیکربندی را از مخزن داده startup به مخزن داده running کپی کرده و مخزن داده running را فعال و دردسترس می‌سازد.
.sp
تغییرات اعمال‌شده بر مخزن داده running، پس از اعتبارسنجی روی سرورهای Kea اعمال می‌شوند. توجه داشته باشید که این تغییرات به‌طور پیش‌فرض به مخزن داده startup کپی نمی‌شوند؛ بدین معنا که تغییرات دائمی نیستند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
\fBkea\-netconf\fP \%<#\:std-iscman-kea-netconf> تمام پیکربندی را از هر مخزن داده Sysrepo در یک عملیات واحد \fBget\-config\fP در NETCONF دریافت می‌کند. پیش از Kea 2.3.2، عملیات \fBget\-config\fP برای هر گره برگ (leaf) و لیست برگ (leaf\-list) به‌طور جداگانه انجام می‌شد.
.UNINDENT
.UNINDENT.SS نمونه‌ای از مدیریت خطا در عملیات NETCONF
.sp
چهار دسته مشکل در پیکربندی‌های اعمال‌شده از طریق NETCONF وجود دارد:
.INDENT 0.0
.IP 1. 3
پیکربندی با شِمای (schema) YANG مطابقت ندارد.
.IP 2. 3
پیکربندی نمی‌تواند از YANG به JSON مربوط به Kea ترجمه شود.
.IP 3. 3
پیکربندی توسط سرور Kea رد می‌شود.
.IP 4. 3
پیکربندی توسط سرور Kea اعتبارسنجی شده اما قابل اعمال نیست.
.UNINDENT
.sp
در حالت نخست، فایل پیکربندی \fBBAD\-schema.xml\fP زیر را در نظر بگیرید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
<config xmlns=\(dqurn:ietf:params:xml:ns:yang:kea\-dhcp6\-server\(dq>
  <subnet4>
    <id>1</id>
    <pool>
      <start\-address>2001:db8::1:0</start\-address>
      <end\-address>2001:db8::1:ffff</end\-address>
      <prefix>2001:db8::1:0/112</prefix>
    </pool>
    <subnet>2001:db8::/64</subnet>
  </subnet4>
  <interfaces\-config>
    <interfaces>eth1</interfaces>
  </interfaces\-config>
  <control\-socket>
    <socket\-name>kea\-dhcp6\-ctrl.sock</socket\-name>
    <socket\-type>unix</socket\-type>
  </control\-socket>
</config>
.EE
.UNINDENT
.UNINDENT
.sp
این فایل مستقیماً توسط \fBsysrepocfg\fP رد می‌شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ sysrepocfg \-d running \-f xml \-m kea\-dhcp6\-server \-\-import=BAD\-schema.xml
.EE
.UNINDENT
.UNINDENT
.sp
در حالت دوم، پیکربندی توسط \fBkea\-netconf\fP \%<#\:std-iscman-kea-netconf>\& رد می‌شود.
برای نمونه، این فایل \fBBAD\-translator.xml\fP را در نظر بگیرید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
<config xmlns=\(dqurn:ietf:params:xml:ns:yang:kea\-dhcp6\-server\(dq>
  <subnet6>
    <id>1</id>
    <pool>
      <start\-address>2001:db8::1:0</start\-address>
      <end\-address>2001:db8::1:ffff</end\-address>
      <prefix>2001:db8::1:0/112</prefix>
    </pool>
    <subnet>2001:db8::/64</subnet>
  </subnet6>
  <interfaces\-config>
    <interfaces>eth1</interfaces>
  </interfaces\-config>
  <control\-socket>
    <socket\-name>kea\-dhcp6\-ctrl.sock</socket\-name>
    <socket\-type>unix</socket\-type>
  </control\-socket>
  <user\-context>bad</user\-context>
</config>
.EE
.UNINDENT
.UNINDENT
.sp
در حالت سوم، پیکربندی به سرور Kea DHCPv6 ارائه شده و اعتبارسنجی آن با شکست مواجه می‌شود، مانند این فایل \fBBAD\-config.xml\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
<config xmlns=\(dqurn:ietf:params:xml:ns:yang:kea\-dhcp6\-server\(dq>
  <subnet6>
    <id>1</id>
    <pool>
      <start\-address>2001:db8:1::0</start\-address>
      <end\-address>2001:db8:1::ffff</end\-address>
      <prefix>2001:db8:1::0/112</prefix>
    </pool>
    <subnet>2001:db8::/64</subnet>
  </subnet6>
  <interfaces\-config>
    <interfaces>eth1</interfaces>
  </interfaces\-config>
  <control\-socket>
    <socket\-name>kea\-dhcp6\-ctrl.sock</socket\-name>
    <socket\-type>unix</socket\-type>
  </control\-socket>
</config>
.EE
.UNINDENT
.UNINDENT
.sp
در حالت آخر، پیکربندی نادرست خیلی دیر تشخیص داده می‌شود و تغییرات باید در Sysrepo بازگردانی (revert) شوند، مثلاً با استفاده از پایگاه داده (datastore) آغازین (startup) به عنوان پشتیبان.
.SS نمونه عملیات NETCONF با دو استخر (Pool)
.sp
این نمونه یک استخر دوم را به پیکربندی اولیه (یعنی startup) در فایل \fBtwopools.xml\fP اضافه می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
<config xmlns=\(dqurn:ietf:params:xml:ns:yang:kea\-dhcp6\-server\(dq>
  <subnet6>
    <id>1</id>
    <pool>
      <start\-address>2001:db8::1:0</start\-address>
      <end\-address>2001:db8::1:ffff</end\-address>
      <prefix>2001:db8::1:0/112</prefix>
    </pool>
    <pool>
      <start\-address>2001:db8::2:0</start\-address>
      <end\-address>2001:db8::2:ffff</end\-address>
      <prefix>2001:db8::2:0/112</prefix>
    </pool>
    <subnet>2001:db8::/64</subnet>
  </subnet6>
  <interfaces\-config>
    <interfaces>eth1</interfaces>
  </interfaces\-config>
  <control\-socket>
    <socket\-name>kea\-dhcp6\-ctrl.sock</socket\-name>
    <socket\-type>unix</socket\-type>
  </control\-socket>
</config>
.EE
.UNINDENT
.UNINDENT
.sp
این پیکربندی با دستور زیر نصب می‌شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ sysrepocfg \-d running \-f xml \-m kea\-dhcp6\-server \-\-import=twopools.xml
.EE
.UNINDENT
.UNINDENT.SS نمونه عملیات NETCONF با دو زیرشبکه
.sp
این مثال دو زیرشبکه را در فایل \fBtwosubnets.xml\fP مشخص می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
<config xmlns=\(dqurn:ietf:params:xml:ns:yang:kea\-dhcp6\-server\(dq>
  <subnet6>
    <id>1</id>
    <pool>
      <start\-address>2001:db8:1::</start\-address>
      <end\-address>2001:db8:1::ffff</end\-address>
      <prefix>2001:db8:1::/112</prefix>
    </pool>
    <subnet>2001:db8:1::/64</subnet>
  </subnet6>
  <subnet6>
    <id>2</id>
    <pool>
      <start\-address>2001:db8:2::</start\-address>
      <end\-address>2001:db8:2::ffff</end\-address>
      <prefix>2001:db8:2::/112</prefix>
    </pool>
    <subnet>2001:db8:2::/64</subnet>
  </subnet6>
  <interfaces\-config>
    <interfaces>eth1</interfaces>
  </interfaces\-config>
  <control\-socket>
    <socket\-name>kea\-dhcp6\-ctrl.sock</socket\-name>
    <socket\-type>unix</socket\-type>
  </control\-socket>
</config>
.EE
.UNINDENT
.UNINDENT
.sp
این پیکربندی با دستور زیر نصب می‌شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ sysrepocfg \-d running \-f xml \-m kea\-dhcp6\-server \-\-import=twosubnets.xml
.EE
.UNINDENT
.UNINDENT
.SS نمونه عملیات NETCONF به همراه ثبت وقایع
.sp
این مثال یک مدخل ثبت وقایع (logger) را به پیکربندی اولیه (یعنی هنگام راه‌اندازی)
در فایل \fBlogging.xml\fP اضافه می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
<config xmlns=\(dqurn:ietf:params:xml:ns:yang:kea\-dhcp6\-server\(dq>
  <interfaces\-config>
    <interfaces>eth1</interfaces>
  </interfaces\-config>
  <subnet6>
    <id>1</id>
    <pool>
      <start\-address>2001:db8::1:0</start\-address>
      <end\-address>2001:db8::1:ffff</end\-address>
      <prefix>2001:db8::1:0/112</prefix>
    </pool>
    <subnet>2001:db8::/64</subnet>
  </subnet6>
  <control\-socket>
    <socket\-name>kea\-dhcp6\-ctrl.sock</socket\-name>
    <socket\-type>unix</socket\-type>
  </control\-socket>
  <logger>
    <name>kea\-dhcp6</name>
    <output\-option>
      <output>stderr</output>
    </output\-option>
    <debuglevel>99</debuglevel>
    <severity>DEBUG</severity>
  </logger>
</config>
.EE
.UNINDENT
.UNINDENT
.sp
پیکربندی متناظر Kea در قالب JSON عبارت است از:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp6\(dq: {
    \(dqcontrol\-socket\(dq: {
      \(dqsocket\-name\(dq: \(dqkea\-dhcp6\-ctrl.sock\(dq,
      \(dqsocket\-type\(dq: \(dqunix\(dq
    },
    \(dqinterfaces\-config\(dq: {
      \(dqinterfaces\(dq: [ \(dqeth1\(dq ]
    },
    \(dqsubnet6\(dq: [
      {
        \(dqid\(dq: 1,
        \(dqpools\(dq: [
          {
            \(dqpool\(dq: \(dq2001:db8::1:0/112\(dq
          }
        ],
        \(dqsubnet\(dq: \(dq2001:db8::/64\(dq
      }
    ],
    \(dqloggers\(dq: [
      {
        \(dqname\(dq: \(dqkea\-dhcp6\(dq,
        \(dqoutput\-options\(dq: [
          {
            \(dqoutput\(dq: \(dqstderr\(dq
          }
        ],
        \(dqseverity\(dq: \(dqDEBUG\(dq,
        \(dqdebuglevel\(dq: 99
      }
    ]
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
در نهایت، هر یک از مثال‌های پیشین را می‌توان با استفاده از
\fBsysrepocfg\fP در حالت ویرایش به صورت زیر مجدداً اجرا کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ sysrepocfg \-d running \-f xml \-m kea\-dhcp6\-server \-\-edit
.EE
.UNINDENT
.UNINDENT
.sp
یا با استفاده از یک کلاینت NETCONF مانند \fBnetopeer2\-cli\fP از
مجموعه ابزار NETCONF پروژه Netopeer2 \%<https://\:github\:.com/\:CESNET/\:Netopeer2>..SS مهاجرت داده‌های YANG از نسخه پیشین Sysrepo
.sp
1. برنامه \fBkea\-netconf\fP \%<#\:std-iscman-kea-netconf>\& را متوقف کنید. این کار تضمین می‌کند که پشتیبان‌گیری از هر دو datastore در یک وضعیت پیکربندی یکسان انجام شود و هیچ تغییری میان برون‌بری (export) آن‌ها رخ ندهد.
.INDENT 0.0
.IP 2. 3
از تمام ماژول‌های YANG نسخه پشتیبان تهیه کنید، به‌طوری که برای هر datastore یک فایل XML ایجاد شود.
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ sysrepocfg \-\-datastore running \-\-export=save.xml \-\-format=xml
$ sysrepocfg \-\-datastore startup \-\-export=save.xml \-\-format=xml
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
نسخه Sysrepo v0 از درون‌ریزی/برون‌بری تمام ماژول‌های YANG پشتیبانی نمی‌کند؛ این قابلیت در Sysrepo v1 افزوده شده است. کاربرانی که از Sysrepo v0 مهاجرت می‌کنند باید پشتیبان‌گیری را به ازای هر ماژول به‌طور جداگانه انجام دهند. این کار مزیت مضاعفی در جداسازی خرابی‌های احتمالی و جلوگیری از اثرگذاری آن‌ها بر روی تمام ماژول‌ها دارد. دستور مورد استفاده یکسان است، با این تفاوت که نام ماژول در پایان به آن افزوده می‌شود.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ sysrepocfg \-\-datastore running \-\-export=save.xml \-\-format=xml kea\-dhcp6\-server
$ sysrepocfg \-\-datastore startup \-\-export=save.xml \-\-format=xml kea\-dhcp6\-server
.EE
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.IP 3. 3
نرم‌افزار Sysrepo را به نسخه جدیدتر ارتقا دهید و سپس دستورات زیر را اجرا کنید:
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ sysrepocfg \-\-datastore running \-\-import=save.xml
$ sysrepocfg \-\-datastore startup \-\-import=save.xml
.EE
.UNINDENT
.UNINDENT
.SS GSS\-TSIG
.SS بررسی اجمالی GSS\-TSIG
.sp
نرم‌افزار Kea از به‌روزرسانی‌های DNS پشتیبانی می‌کند که می‌توان آن‌ها را با استفاده از امضاهای تراکنش (Transaction Signatures یا TSIG) محافظت کرد. این سطح از محافظت اغلب کافی است. با این حال، برخی سیستم‌ها، به‌ویژه Active Directory (AD) در سرورهای Microsoft Windows، رویکرد پیچیده‌تر GSS\-TSIG را برگزیده‌اند که قابلیت‌های بیشتری همچون استفاده از کلیدهای پویای مذاکره‌شده را ارائه می‌دهد.
.sp
نرم‌افزار Kea از GSS\-TSIG برای محافظت از به‌روزرسانی‌های DNS ارسال‌شده توسط سرور Kea DHCP\-DDNS (D2) از طریق یک هوک (hook) به نام \fBlibddns_gss_tsig.so\fP \%<#\:std-ischooklib-libddns_gss_tsig\:.so>\& پشتیبانی می‌کند.
.sp
استاندارد GSS\-TSIG در RFC 3645 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc3645>\& تعریف شده است. خود پروتکل GSS\-TSIG پیاده‌سازی سرویس‌های عمومی GSS\-API v2 است که در RFC 2743 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc2743>\& تعریف شده است.
.sp
پروتکل‌های متعددی در این سازوکار دخیل هستند:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
پروتکل Kerberos 5 \- RFC 4120 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc4120>، که چارچوب امنیتی را فراهم می‌کند؛
.IP \(bu 2
رابط GSS\-API (Generic Security Services Application Program Interface) \- سند RFC 2743 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc2743> برای API، سند RFC 2744 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc2743> برای انقیادهای C، و RFC 4121 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc4121> برای به‌کارگیری در Kerberos 5؛
.IP \(bu 2
سازوکار SPNEGO (Simple and Protected GSS\-API Negotiation Mechanism) \- RFC 4178 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc4178> برای انجام مذاکره؛
.IP \(bu 2
به‌روزرسانی DNS بر اساس RFC 2136 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc2136>؛
.IP \(bu 2
پروتکل TSIG (Secret Key Transaction Authentication for DNS) \- RFC 8945 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc8945>، که از تبادلات DNS محافظت می‌کند؛
.IP \(bu 2
به‌روزرسانی پویای امن در سامانه نام دامنه (Secure Domain Name System Dynamic Update) \- RFC 3007 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc3007>، که کاربرد TSIG در محافظت از به‌روزرسانی‌های DNS است؛
.IP \(bu 2
پروتکل TKEY (Secret Key Establishment for DNS) \- RFC 2930 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc2930>، که کلیدهای سری را برای TSIG از طریق انتقال داده‌های رمزنگاری میان طرف‌های DNS برقرار می‌کند؛ و
.IP \(bu 2
پروتکل GSS\-TSIG \- RFC 3645 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc3645>، که کاربرد GSS\-API در TSIG است.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
به‌طور خلاصه، GSS\-API برای Kerberos 5 به همراه SPNEGO و TKEY برای مذاکره بر سر یک بافتار امنیتی (security context) میان سرور Kea D2 و یک سرور DNS استفاده می‌شوند:
.INDENT 0.0
.INDENT 2.5
[تصویر]
.UNINDENT
.UNINDENT
.sp
سپس این بافتار امنیتی توسط GSS\-TSIG برای محافظت از به‌روزرسانی‌ها به کار گرفته می‌شود:
.INDENT 0.0
.INDENT 2.5
[تصویر]
.UNINDENT
.UNINDENT
.sp
پیاده‌سازی Kea از GSS\-TSIG از یک کتابخانه GSS\-API برای Kerberos 5 به همراه SPNEGO استفاده می‌کند. دو پیاده‌سازی این معیارها را برآورده می‌کنند: MIT Kerberos 5 و Heimdal..SS کامپایل GSS\-TSIG
.sp
روال زیر روی دبیان ۱۲ (Debian 12) آزمایش شده است. رویکرد مشابهی را می‌توان
برای سایر سیستم‌ها نیز به کار برد.
.INDENT 0.0
.IP 1. 3
یکی از کتابخانه‌های MIT (\fBlibkrb5\-dev\fP) یا Heimdal (\fBheimdal\-dev\fP) را نصب کنید،
برای نمونه:
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
sudo apt install libkrb5\-dev
.EE
.UNINDENT
.UNINDENT
.INDENT 0.0
.IP 2. 3
سورس‌کدهای Kea را دریافت کرده و آن‌ها را استخراج کنید.
.IP 3. 3
مراحل ساخت را برپا کنید:
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
meson setup build \-D krb5=enabled
.EE
.UNINDENT
.UNINDENT
.INDENT 0.0
.IP 4. 3
مطمئن شوید که \fBbuild/config.report\fP مدخل \fBKerberos5 GSS\-API\fP را نمایش می‌دهد.
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Kerberos5 GSS\-API:
  VERSION:         1.20.1
  VENDOR:          MIT
.EE
.UNINDENT
.UNINDENT
.sp
حضور فایل \fBkrb5.pc\fP یا ابزار \fBkrb5\-config\fP الزامی است. این موارد توسط هر دو
پیاده‌سازی MIT Kerberos 5 و Heimdal ارائه می‌شوند؛ با این حال، در برخی سیستم‌ها که هر دو
مورد Kerberos 5 و Heimdal نصب شده‌اند، این ابزار یک پیوند نمادین (symbolic link) به
یکی از آن‌ها است. اگر ابزار در مکان استاندارد قرار ندارد، می‌توان آن را با تنظیم
\fBPKG_CONFIG_PATH=/path/to/krb5.pc:${PKG_CONFIG_PATH}\fP یا
\fBPATH=/path/to/krb5\-config:${PATH}\fP پیش از \fBmeson setup\fP مشخص کرد\&.
.INDENT 0.0
.IP 6. 3
با دستور \fBmeson compile \-C build\fP کامپایل کنید\&.
.IP 7. 3
.INDENT 3.0
.TP
.B پس از کامپایل، \fBlibddns_gss_tsig.so\fP \%<#\:std-ischooklib-libddns_gss_tsig\:.so> در
دایرکتوری \fBbuild/src/hooks/d2/gss_tsig\fP در دسترس خواهد بود. این پرونده می‌تواند توسط
\fBkea\-dhcp\-ddns\fP \%<#\:std-iscman-kea-dhcp-ddns> بارگذاری شود\&.
.UNINDENT
.UNINDENT
.sp
پرونده \fBlibddns_gss_tsig.so\fP \%<#\:std-ischooklib-libddns_gss_tsig\:.so> از هر دو
پیاده‌سازی MIT Kerberos 5 و Heimdal پشتیبانی می‌کند. پیاده‌سازی Heimdal درباره
دسترسی‌های فایل‌های حساس امنیتی بسیار سخت‌گیر است و معروف است که پیام خطای نامفهومی
صادر می‌کند. ایده خوبی است که این فایل‌ها ساده، با یک پیوند و بدون دسترسی برای گروه یا
سایر کاربران نگه‌داشته شوند.
.sp
اسکریپت \fBkrb5\-config\fP باید یک گزینه \fB\-\-vendor\fP فراهم کند که پیاده‌سازی را مشخص می‌سازد.
.SS استقرار GSS\-TSIG
.sp
پیش از استفاده از GSS\-TSIG، یک سرور DNS با قابلیت پشتیبانی از GSS\-TSIG، مانند BIND 9
یا Microsoft Active Directory (AD) باید مستقر شده باشد. سایر پیاده‌سازی‌های دارای
قابلیت GSS\-TSIG ممکن است کار کنند، اما آزمایش نشده‌اند.
.SS راه‌اندازی Kerberos 5
.sp
دو نوع جدول کلید (فایل‌های keytab) وجود دارد: جدول سیستمی که توسط سرورها استفاده می‌شود،
و جدول‌های کلاینت که توسط کلاینت‌ها به کار می‌روند. برای Kerberos 5، نرم‌افزار Kea یک
\fBclient\fP (کلاینت) محسوب می‌شود\&.
.sp
کتابخانه کلاینت Kerberos 5 و ابزار \fBkadmin\fP را نصب کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
sudo apt install krb5\-kdc krb5\-admin\-server
.EE
.UNINDENT
.UNINDENT
.sp
مثال‌های زیر از قلمرو (realm) فرضی \fBEXAMPLE.ORG\fP برای نمایش مراحل پیکربندی و
تنظیمات مورد نیاز استفاده می‌کنند.
.sp
کتابخانه کلاینت Kerberos 5 باید از طریق به‌روزرسانی فایل \fBkrb5.conf\fP
(برای نمونه در لینوکس: /etc/krb5.conf) برای پذیرش درخواست‌های ورودی مربوط به قلمرو
\fBEXAMPLE.ORG\fP پیکربندی شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[libdefaults]
    default_realm = EXAMPLE.ORG
    kdc_timesync = 1
    ccache_type = 4
    forwardable = true
    proxiable = true

[realms]
    EXAMPLE.ORG = {
            kdc = kdc.example.org
            admin_server = kdc.example.org
    }
.EE
.UNINDENT
.UNINDENT
.sp
علاوه بر فایل \fBkrb5.conf\fP، فایل \fBkdc.conf\fP نیز می‌تواند استفاده شود
(برای نمونه در لینوکس: /etc/krb5kdc/kdc.conf):
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[kdcdefaults]
    kdc_ports = 750,88

[realms]
    EXAMPLE.ORG = {
        database_name = /var/lib/krb5kdc/principal
        admin_keytab = FILE:/etc/krb5kdc/kadm5.keytab
        acl_file = /etc/krb5kdc/kadm5.acl
        key_stash_file = /etc/krb5kdc/stash
        kdc_ports = 750,88
        max_life = 10h 0m 0s
        max_renewable_life = 7d 0h 0m 0s
        master_key_type = des3\-hmac\-sha1
        #supported_enctypes = aes256\-cts:normal aes128\-cts:normal
        default_principal_flags = +preauth
    }
.EE
.UNINDENT
.UNINDENT
.sp
لیست کنترل دسترسی (ACL) دیمن \fBkadmind\fP باید طوری پیکربندی شود که به
پرینسیپال (principal) کلاینت DNS برای دسترسی به پایگاه‌داده Kerberos 5 مجوز دهد
(برای نمونه در لینوکس: /etc/krb5kdc/kadm5.acl):
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCP/admin.example.org@EXAMPLE.ORG       *
.EE
.UNINDENT
.UNINDENT
.sp
گذرواژه مدیر سیستم برای قلمرو پیش‌فرض باید تنظیم شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
krb5_newrealm
.EE
.UNINDENT
.UNINDENT
.sp
پس از نمایش پیام زیر، گذرواژه قلمرو پیش‌فرض را وارد کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
This script should be run on the master KDC/admin server to initialize
a Kerberos realm.  It will ask you to type in a master key password.
This password will be used to generate a key that is stored in
/etc/krb5kdc/stash.  You should try to remember this password, but it
is much more important that it be a strong password than that it be
remembered.  However, if you lose the password and /etc/krb5kdc/stash,
you cannot decrypt your Kerberos database.
Loading random data
Initializing database \(aq/var/lib/krb5kdc/principal\(aq for realm \(aqEXAMPLE.ORG\(aq,
master key name \(aqK/M@EXAMPLE.ORG\(aq
You will be prompted for the database Master Password.
It is important that you NOT FORGET this password.
Enter KDC database master key:
.EE
.UNINDENT
.UNINDENT
.sp
سپس گذرواژه را دوباره وارد کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Re\-enter KDC database master key to verify:
.EE
.UNINDENT
.UNINDENT
.sp
در صورت اعمال موفقیت‌آمیز، پیام زیر نمایش داده می‌شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Now that your realm is set up you may wish to create an administrative
principal using the addprinc subcommand of the kadmin.local program.
Then, this principal can be added to /etc/krb5kdc/kadm5.acl so that
you can use the kadmin program on other computers.  Kerberos admin
principals usually belong to a single user and end in /admin.  For
example, if jruser is a Kerberos administrator, then in addition to
the normal jruser principal, a jruser/admin principal should be
created.

Don\(aqt forget to set up DNS information so your clients can find your
KDC and admin servers.  Doing so is documented in the administration
guide.
.EE
.UNINDENT
.UNINDENT
.sp
گام بعدی، ایجاد پرینسیپال‌ها برای سرور BIND 9 DNS (سرویسی که توسط GSS\-TSIG TKEY
محافظت می‌شود) و برای کلاینت DNS (سرور Kea DHCP\-DDNS) است.
.sp
پرینسیپال سرور BIND 9 DNS (مورد استفاده برای احراز هویت) به شیوه زیر ایجاد می‌شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
kadmin.local \-q \(dqaddprinc \-randkey DNS/server.example.org\(dq
.EE
.UNINDENT
.UNINDENT
.sp
در صورت ایجاد موفقیت‌آمیز، پیام زیر نمایش داده می‌شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
No policy specified for DNS/server.example.org@EXAMPLE.ORG; defaulting to no policy
Authenticating as principal root/admin@EXAMPLE.ORG with password.
Principal \(dqDNS/server.example.org@EXAMPLE.ORG\(dq created.
.EE
.UNINDENT
.UNINDENT
.sp
پرینسیپال سرور DNS باید برون‌بری شود تا بتواند توسط سرور BIND 9 DNS استفاده شود.
تنها به این پرینسیپال نیاز است، و در فایل keytab با نام \fBdns.keytab\fP برون‌بری می‌شود\&.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
kadmin.local \-q \(dqktadd \-k /usr/local/share/kea/dns.keytab DNS/server.example.org\(dq
.EE
.UNINDENT
.UNINDENT
.sp
در صورت برون‌بری موفق، پیام زیر نمایش داده می‌شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Authenticating as principal root/admin@EXAMPLE.ORG with password.
Entry for principal DNS/server.example.org with kvno 2, encryption type aes256\-cts\-hmac\-sha1\-96 added to keytab WRFILE:/usr/local/share/kea/dns.keytab.
Entry for principal DNS/server.example.org with kvno 2, encryption type aes128\-cts\-hmac\-sha1\-96 added to keytab WRFILE:/usr/local/share/kea/dns.keytab.
.EE
.UNINDENT
.UNINDENT
.sp
پرینسیپال کلاینت DHCP (مورد استفاده توسط سرور Kea DHCP\-DDNS) به این ترتیب ایجاد می‌شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
kadmin.local \-q \(dqaddprinc \-randkey DHCP/admin.example.org\(dq
.EE
.UNINDENT
.UNINDENT
.sp
در صورت ایجاد موفقیت‌آمیز، پیام زیر نمایش داده می‌شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
No policy specified for DHCP/admin.example.org@EXAMPLE.ORG; defaulting to no policy
Authenticating as principal root/admin@EXAMPLE.ORG with password.
Principal \(dqDHCP/admin.example.org@EXAMPLE.ORG\(dq created.
.EE
.UNINDENT
.UNINDENT
.sp
پرینسیپال کلاینت DHCP باید برون‌بری شود تا بتواند توسط سرور Kea DHCP\-DDNS و
کتابخانه قلاب (hook) مربوط به GSS\-TSIG استفاده شود. این پرینسیپال به فایل keytab
کلاینت با نام \fBdhcp.keytab\fP صادر می‌شود\&.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
kadmin.local \-q \(dqktadd \-k /usr/local/share/kea/dhcp.keytab DHCP/admin.example.org\(dq
.EE
.UNINDENT
.UNINDENT
.sp
در نهایت، سرویس \fBkrb5\-admin\-server\fP باید بازراه‌اندازی شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
systemctl restart krb5\-admin\-server.service
.EE
.UNINDENT
.UNINDENT.SS پیکربندی BIND 9 با GSS\-TSIG
.sp
کارساز DNS برنامه‌ی BIND 9 باید برای استفاده از GSS\-TSIG و به‌کارگیری principal کارساز DNS که پیش‌تر از فایل keytab با نام \fBdns.keytab\fP صادر شده است، پیکربندی شود.
به‌روزرسانی فایل \fBnamed.conf\fP الزامی است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
options {
    ...
    directory \(dq/var/cache/bind\(dq;
    dnssec\-validation auto;
    listen\-on\-v6 { any; };
    tkey\-gssapi\-keytab \(dq/etc/bind/dns.keytab\(dq;
};
zone \(dqexample.org\(dq {
    type master;
    file \(dq/var/lib/bind/db.example.org\(dq;
    update\-policy {
        grant \(dqDHCP/admin.example.org@EXAMPLE.ORG\(dq zonesub any;
    };
};
zone \(dq84.102.10.in\-addr.arpa\(dq {
    type master;
    file \(dq/etc/bind/db.10\(dq;
};
.EE
.UNINDENT
.UNINDENT
.sp
فایل‌های zone باید شامل مدخلی برای FQDN پرینسیپال کارساز یعنی \fBserver.example.org\fP باشند.
.sp
فایل \fB/etc/bind/db.10\fP باید ایجاد یا به‌روزرسانی شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
;
; BIND reverse data file for local loopback interface
;
$TTL    604800                      ; 1 week
@       IN      SOA      server.example.org. root.example.org. (
                         2          ; Serial
                         604800     ; Refresh
                         86400      ; Retry
                         2419200    ; Expire
                         604800     ; Negative Cache TTL
                         )
;
@       IN      NS      ns.
40      IN      PTR     ns.example.org.
.EE
.UNINDENT
.UNINDENT
.sp
فایل \fB/var/lib/bind/db.example.org\fP باید ایجاد یا به‌روزرسانی شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ORIGIN .
$TTL                604800             ; 1 week
example.org         IN SOA  server.example.org. root.example.org. (
                            8          ; serial
                            604800     ; refresh (1 week)
                            86400      ; retry (1 day)
                            2419200    ; expire (4 weeks)
                            604800     ; minimum (1 week)
                            )
                    NS      example.org.
                    A       ${BIND9_IP_ADDR}
                    AAAA    ::1
$ORIGIN example.org.
kdc                 A       ${KDC_IP_ADDR}
server              A       ${BIND9_IP_ADDR}
.EE
.UNINDENT
.UNINDENT
.sp
پس از هرگونه تغییر در پیکربندی، کارساز باید دوباره بارگذاری یا راه‌اندازی مجدد شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
systemctl restart named.service
.EE
.UNINDENT
.UNINDENT
.sp
امکان دریافت وضعیت یا بررسی لاگ‌ها وجود دارد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
systemctl status named.service
journalctl \-u named | tail \-n 30
.EE
.UNINDENT
.UNINDENT
.SS پیکربندی Windows Active Directory
.sp
این زیربخش بر پایه‌ی Microsoft Windows Server 2016 ارائه‌شده توسط Amazon AWS با Active Directory از پیش نصب‌شده است، بنابراین تنها مراحلی را که برای استقرار GSS\-TSIG به کار رفته‌اند شرح می‌دهد. (برای فرایند کامل پیکربندی، لطفاً به مستندات Microsoft یا سایر منابع خارجی مراجعه کنید. ما این راهنمای آموزشی را در \%<https://\:www\:.tenforums\:.com/\:tutorials/\:51456-windows-server-2016-setup-local-domain-controller\:.html> هنگام پیکربندی سیستم‌های آزمایش تضمین کیفیت (QA) داخلی خود بسیار مفید یافتیم.)
.INDENT 0.0
.TP
.B به دو حساب کاربری Active Directory (AD) نیاز است:
.INDENT 7.0
.IP \(bu 2
حساب نخست برای دریافت اطلاعات AD، مانند جدول کلید (key table) کلاینت Kea استفاده می‌شود
.IP \(bu 2
حساب دوم به principal کلاینت Kea DHCP نگاشت می‌شود
.UNINDENT
.TP
.B برنامه‌ی Kea باید از موارد زیر مطلع باشد:
.INDENT 7.0
.IP \(bu 2
نشانی IP کارساز
.IP \(bu 2
نام دامنه/realm: نام دامنه با حروف کوچک و realm با حروف بزرگ، هر دو بدون نقطه در انتها
.IP \(bu 2
نام کارساز
.UNINDENT
.UNINDENT
.sp
حساب دوم (که در زیر \fBkea\fP نامیده شده است) برای ایجاد یک Service Principal Name (SPN) به کار می‌رود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
setspn \-S DHCP/kea.<domain> kea
.EE
.UNINDENT
.UNINDENT
.sp
سپس یک کلید مخفی مشترک تولید شده و در یک فایل جدول کلید (key table) قرار می‌گیرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ktpass \-princ DHCP/kea.<domain>@<REALM> \-mapuser kea +rndpass \-mapop set \-ptype KRB5_NT_PRINCIPAL \-out dhcp.keytab
.EE
.UNINDENT
.UNINDENT
.sp
فایل \fBdhcp.keytab\fP کاربردی مشابه با UNIX Kerberos دارد..SS عیب‌یابی GSS\-TSIG
.sp
هنگام آزمایش یکپارچه‌سازی GSS\-TSIG با Active Directory به یک خطای بسیار مبهم برخوردیم:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
INFO  [kea\-dhcp\-ddns.gss\-tsig\-hooks/4678.139690935890624] GSS_TSIG_VERIFY_FAILED GSS\-TSIG verify failed: gss_verify_mic failed with GSSAPI error:
Major = \(aqA token had an invalid Message Integrity Check (MIC)\(aq (393216), Minor = \(aqPacket was replayed in wrong direction\(aq (100002).
.EE
.UNINDENT
.UNINDENT
.sp
در مورد ما، مشکل این بود که کارساز Kea D2 تلاش می‌کرد یک ناحیهٔ معکوس DNS را در حالی به‌روزرسانی کند که پیکربندی نشده بود. یک راه‌حل ساده، افزودن یک ناحیهٔ معکوس DNS مشابه آنچه در Kea پیکربندی شده است می‌باشد. برای این کار، \(dqDNS Manager\(dq را باز کرده و \(dqDNS\(dq را از فهرست انتخاب کنید؛ سپس از فهرست کشویی، \(dqReverse Lookup Zones\(dq را برگزینید؛ بعد روی \(dqAction\(dq و \(dqNew Zone\(dq کلیک کنید؛ در نهایت، New Zone Wizard را برای افزودن یک ناحیهٔ جدید دنبال کنید.
.sp
استاندارد به هر دو سرویس ضد بازپخش (anti\-replay) و توالی (sequence) نیاز دارد. تجربیات به‌دست‌آمده با nsupdate در BIND 9 نشان داد که سرویس توالی منجر به بروز مشکلاتی می‌شود، بنابراین به‌طور پیش‌فرض در hook غیرفعال شده است. به نظر می‌رسد سرویس ضد بازپخش نیز می‌تواند باعث ایجاد مشکل در کارسازهای DNS مایکروسافت شود، بنابراین اکنون قابل پیکربندی است. توجه داشته باشید که این سرویس‌های امنیتی برای به‌روزرسانی پویای DNS، که برای اجرا روی UDP و در نتیجه همراه با پیام‌های نامرتب و تکراری طراحی شده، کاربردی ندارند.
.SS استفاده از GSS\-TSIG
.sp
برای فعال‌سازی سازوکار GSS\-TSIG، چند مرحله لازم است:
.INDENT 0.0
.IP 1. 3
\fBlibddns_gss_tsig.so\fP \%<#\:std-ischooklib-libddns_gss_tsig\:.so> باید توسط \fBkea\-dhcp\-ddns\fP \%<#\:std-iscman-kea-dhcp-ddns>\& بارگذاری شود.
.IP 2. 3
کارسازهای DNS با قابلیت پشتیبانی از GSS\-TSIG باید به همراه پارامترهایشان مشخص شوند.
.UNINDENT
.sp
گزیده‌ای از پیکربندی کارساز D2 در زیر ارائه شده است؛ مثال‌های بیشتر در دایرکتوری \fBdoc/examples/ddns\fP در سورس‌های Kea موجود است.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
 {
 \(dqDhcpDdns\(dq: {
     // The following parameters are used to receive NCRs (NameChangeRequests)
     // from the local Kea DHCP server. Make sure your kea\-dhcp4 and kea\-dhcp6
     // matches this.
     \(dqip\-address\(dq: \(dq127.0.0.1\(dq,
     \(dqport\(dq: 53001,
     \(dqdns\-server\-timeout\(dq : 1000,

     // Forward zone: secure.example.org. It uses GSS\-TSIG. It is served
     // by two DNS servers, which listen for DDNS requests at 192.0.2.1
     // and 192.0.2.2.
     \(dqforward\-ddns\(dq:
     {
         \(dqddns\-domains\(dq:
         [
             // DdnsDomain for zone \(dqsecure.example.org.\(dq
             {
                 \(dqname\(dq: \(dqsecure.example.org.\(dq,
                 \(dqcomment\(dq: \(dqDdnsDomain example\(dq,
                 \(dqdns\-servers\(dq:
                 [
                     { // This server has an entry in gss/servers and
                       // thus will use GSS\-TSIG.
                         \(dqip\-address\(dq: \(dq192.0.2.1\(dq
                     },
                     { // This server also has an entry there, so will
                       // use GSS\-TSIG, too.
                         \(dqip\-address\(dq: \(dq192.0.2.2\(dq,
                         \(dqport\(dq: 5300
                     }
                 ]
             }
         ]
     },

     // Reverse zone: we want to update the reverse zone \(dq2.0.192.in\-addr.arpa\(dq.
     \(dqreverse\-ddns\(dq:
     {
         \(dqddns\-domains\(dq:
         [
             {
                 \(dqname\(dq: \(dq2.0.192.in\-addr.arpa.\(dq,
                 \(dqdns\-servers\(dq:
                 [
                     {
                         // There is a GSS\-TSIG definition for this server (see
                         // DhcpDdns/gss\-tsig/servers), so it will use
                         // Krb/GSS\-TSIG.
                         \(dqip\-address\(dq: \(dq192.0.2.1\(dq
                     }
                 ]
             }
         ]
     },

     // The GSS\-TSIG hook is loaded and its configuration is specified here.
     \(dqhooks\-libraries\(dq: [
     {
         \(dqlibrary\(dq: \(dqlibddns_gss_tsig.so\(dq,
         \(dqparameters\(dq: {
             // This section governs the GSS\-TSIG integration. Each server
             // mentioned in forward\-ddns and/or reverse\-ddns needs to have
             // an entry here to be able to use GSS\-TSIG defaults (optional,
             // if specified they apply to all the GSS\-TSIG servers, unless
             // overwritten on specific server level).

             \(dqserver\-principal\(dq: \(dqDNS/server.example.org@EXAMPLE.ORG\(dq,
             \(dqclient\-principal\(dq: \(dqDHCP/admin.example.org@EXAMPLE.ORG\(dq,

             // client\-keytab and credentials\-cache can both be used to
             // store client keys. As credentials cache is more flexible,
             // it is recommended to use it. Typically, using both at the
             // same time may cause problems.
             // \(dqclient\-keytab\(dq: \(dqFILE:/etc/dhcp.keytab\(dq, // toplevel only
             \(dqcredentials\-cache\(dq: \(dqFILE:/etc/ccache\(dq, // toplevel only
             \(dqgss\-replay\-flag\(dq: true, // GSS anti replay service
             \(dqgss\-sequence\-flag\(dq: false, // no GSS sequence service
             \(dqtkey\-lifetime\(dq: 3600, // 1 hour
             \(dqrekey\-interval\(dq: 2700, // 45 minutes
             \(dqretry\-interval\(dq: 120, // 2 minutes
             \(dqtkey\-protocol\(dq: \(dqTCP\(dq,
             \(dqfallback\(dq: false,

             // The list of GSS\-TSIG capable servers
             \(dqservers\(dq: [
                 {
                     // First server (identification is required)
                     \(dqid\(dq: \(dqserver1\(dq,
                     \(dqdomain\-names\(dq: [ ], // if not specified or empty, will
                                          // match all domains that want to
                                          // use this IP+port pair
                     \(dqip\-address\(dq: \(dq192.0.2.1\(dq,
                     \(dqport\(dq: 53,
                     \(dqserver\-principal\(dq: \(dqDNS/server1.example.org@EXAMPLE.ORG\(dq,
                     \(dqclient\-principal\(dq: \(dqDHCP/admin1.example.org@EXAMPLE.ORG\(dq,
                     \(dqgss\-replay\-flag\(dq: false, // no GSS anti replay service
                     \(dqgss\-sequence\-flag\(dq: false, // no GSS sequence service
                     \(dqtkey\-lifetime\(dq: 7200, // 2 hours
                     \(dqrekey\-interval\(dq: 5400, // 90 minutes
                     \(dqretry\-interval\(dq: 240, // 4 minutes
                     \(dqtkey\-protocol\(dq: \(dqTCP\(dq,
                     \(dqfallback\(dq: true // if no key is available fallback to the
                                      // standard behavior (vs skip this server)
                 },
                 {
                     // The second server (it has most of the parameters missing
                     // as those are using the defaults specified above)
                     \(dqid\(dq: \(dqserver2\(dq,
                     \(dqip\-address\(dq: \(dq192.0.2.2\(dq,
                     \(dqport\(dq: 5300
                 }
             ]
         }
     }
     ]

     // Additional parameters, such as logging, control socket and
     // others omitted for clarity.
 }

 }
.EE
.UNINDENT
.UNINDENT
.sp
این فایل پیکربندی شامل تعدادی عنصر اضافی است.
.sp
نخست، فهرستی از دامنه‌های مستقیم و/یا معکوس همراه با کارسازهای DNS مربوطه که با جفت‌های IP+port مشخص شده‌اند، تعریف می‌شود. اگر پورت مشخص نشده باشد، مقدار پیش‌فرض 53 در نظر گرفته می‌شود. این مشابه حالت پایه است که در آن هیچ احراز هویتی با استفاده از کلیدهای TSIG انجام نمی‌شود، با این تفاوت که به کلیدهای استاتیک TSIG با نام ارجاع داده نمی‌شود.
.sp
دوم، \fBlibddns_gss_tsig.so\fP \%<#\:std-ischooklib-libddns_gss_tsig\:.so> باید در فهرست \fBhooks\-libraries\fP مشخص شود. این hook پارامترهای متعددی می‌گیرد. مهم‌ترین آن‌ها \fBservers\fP است که فهرستی از کارسازهای با قابلیت GSS\-TSIG می‌باشد. اگر چندین کارساز وجود داشته باشد و ویژگی‌های مشترکی داشته باشند، مقادیر می‌توانند در حوزهٔ \fBparameters\fP به عنوان مقادیر پیش‌فرض تعیین شوند. در مثال بالا، مقادیر پیش‌فرضی که برای همهٔ کارسازها اعمال می‌شوند (مگر اینکه در سطح هر کارساز به‌طور خاص بازنویسی شده باشند)، در خطوط 63 تا 68 تعریف شده‌اند. اگر تنها یک کارساز تعریف شده باشد، یا اگر همهٔ کارسازها مقادیر متفاوتی داشته باشند، می‌توان از این مقادیر پیش‌فرض صرف‌نظر کرد..SS فهرست پارامترهای موجود
.TS
box center;
l|l|l|l|l.
T{
نام
T}	T{
محدوده
T}	T{
نوع
T}	T{
مقدار پیش‌فرض
T}	T{
توضیحات
T}
_
T{
client\-keytab
T}	T{
سراسری /
سرور
T}	T{
رشته
T}	T{
خالی
T}	T{
جدول کلید \fBکلاینت\fP در Kerberos
T}
_
T{
credentials\-cache
T}	T{
سراسری /
سرور
T}	T{
رشته
T}	T{
خالی
T}	T{
کَش گواهی‌های Kerberos
T}
_
T{
server\-principal
T}	T{
سراسری /
سرور
T}	T{
رشته
T}	T{
خالی
T}	T{
نام Kerberos principal کارگزار DNS که
به‌روزرسانی‌ها را دریافت خواهد کرد
T}
_
T{
client\-principal
T}	T{
سراسری /
سرور
T}	T{
رشته
T}	T{
خالی
T}	T{
نام Kerberos principal سرویس Kea D2
T}
_
T{
gss\-replay\-flag
T}	T{
سراسری /
سرور
T}	T{
true /
false
T}	T{
true
T}	T{
الزام سرویس ضددوباره‌رسانی GSS
(GSS_C_REPLAY_FLAG)
T}
_
T{
gss\-sequence\-flag
T}	T{
سراسری /
سرور
T}	T{
true /
false
T}	T{
false
T}	T{
الزام سرویس توالی GSS
(GSS_C_SEQUENCE_FLAG)
T}
_
T{
tkey\-protocol
T}	T{
سراسری /
سرور
T}	T{
رشته
\(dqTCP\(dq /
\(dqUDP\(dq
T}	T{
\(dqTCP\(dq
T}	T{
پروتکل مورد استفاده برای برقراری
زمینهٔ امنیتی (security context) با
کارگزارهای DNS
T}
_
T{
tkey\-lifetime
T}	T{
سراسری /
سرور
T}	T{
uint32
T}	T{
.nf
3600 ثانیه
( 1 ساعت )
.fi
T}	T{
مدت‌زمان اعتبار کلیدهای GSS\-TSIG
T}
_
T{
rekey\-interval
T}	T{
سراسری /
سرور
T}	T{
uint32
T}	T{
.nf
2700 ثانیه
( 45 دقیقه )
.fi
T}	T{
بازهٔ زمانی بررسی کلیدها جهت
کلیدگذاری مجدد (rekeying)
T}
_
T{
retry\-interval
T}	T{
سراسری /
سرور
T}	T{
uint32
T}	T{
.nf
120 ثانیه
( 2 دقیقه )
.fi
T}	T{
بازهٔ زمانی تلاش مجدد برای ایجاد کلید در
صورت وقوع هرگونه خطا در دفعات پیشین
T}
_
T{
fallback
T}	T{
سراسری /
سرور
T}	T{
true /
false
T}	T{
false
T}	T{
رفتار بازگشت به حالت غیر GSS\-TSIG در
شرایطی که GSS\-TSIG باید استفاده شود
اما هیچ کلید GSS\-TSIGای موجود نیست.
T}
_
T{
exchange\-timeout
T}	T{
سراسری /
سرور
T}	T{
uint32
T}	T{
.nf
3000 میلی‌ثانیه
( 3 ثانیه )
.fi
T}	T{
مدت‌زمان انتظار برای اتمام تبادل
GSS\-TSIG TKEY پیش از آنکه مهلت زمانی
آن به پایان برسد (timeout)
T}
_
T{
ignore\-bad\-direction
T}	T{
سراسری
T}	T{
true /
false
T}	T{
false
T}	T{
نادیده گرفتن خطاهای اعتبارسنجی
MIC نامعتبر / جهت نادرست (bad direction).
T}
_
T{
user\-context
T}	T{
سراسری /
سرور
T}	T{
رشته
T}	T{
خالی
T}	T{
داده‌های ارائه‌شده توسط کاربر در قالب
JSON (توسط قلاب GSS\-TSIG استفاده
نمی‌شود)
T}
_
T{
comment
T}	T{
سراسری /
سرور
T}	T{
رشته
T}	T{
خالی
T}	T{
نادیده گرفته می‌شود
T}
_
T{
id
T}	T{
سرور
T}	T{
رشته
T}	T{
خالی
T}	T{
شناسهٔ یک کارگزار DNS
(الزامی)
T}
_
T{
domain\-names
T}	T{
سرور
T}	T{
فهرستی از
رشته‌ها
T}	T{
خالی
T}	T{
رابطهٔ چندبه‌یک بین کارگزارهای DNS
در D2 و کارگزارهای DNS در GSS\-TSIG
T}
_
T{
ip\-address
T}	T{
سرور
T}	T{
آدرس
IPv4 /
IPv6
T}	T{
خالی
T}	T{
آدرس IP که کارگزار DNS در GSS\-TSIG
برای درخواست‌های DDNS و TKEY روی آن
گوش می‌دهد (الزامی)
T}
_
T{
port
T}	T{
سرور
T}	T{
uint16
T}	T{
53
T}	T{
درگاه انتقال DNS که کارگزار DNS در
GSS\-TSIG برای درخواست‌های DDNS و
TKEY روی آن گوش می‌دهد
T}
.TE
.sp
پارامترهای سراسری در ادامه شرح داده شده‌اند:
.INDENT 0.0.IP \(bu 2
\fBclient\-keytab\fP جدول کلید (key table) \fBclient\fP مربوط به Kerberos را مشخص می‌کند.
برای نمونه، \fBFILE:<filename>\fP می‌تواند برای اشاره به یک فایل مشخص استفاده شود.
این پارامتر تنها یک بار در حوزه (scope) پارامترها قابل تعیین است
و معادل تنظیم متغیر محیطی \fBKRB5_CLIENT_KTNAME\fP می‌باشد.
یک مقدار خالی بدون ایجاد پیام نادیده گرفته می‌شود.
.IP \(bu 2
\fBcredentials\-cache\fP حافظه موقت مدارک هویتی (credentials cache) مربوط به Kerberos را تعیین می‌کند.
به عنوان مثال، \fBFILE:<filename>\fP می‌تواند برای اشاره به یک فایل به کار رود یا
در صورت استفاده از دایرکتوری‌ای که از بیش از یک principal پشتیبانی می‌کند،
\fBDIR:<directory\-path>\fP\&.
این پارامتر تنها یک بار در حوزه پارامترها قابل تعیین است
و معادل مقداردهی به متغیر محیطی \fBKRB5CCNAME\fP می‌باشد.
یک مقدار خالی بدون پیام نادیده گرفته می‌شود.
.IP \(bu 2
\fBserver\-principal\fP نام principal مربوط به Kerberos برای کارساز DNS است
که به‌روزرسانی‌ها را دریافت می‌کند. به عبارت دیگر، این نام
کارساز DNS در سامانه Kerberos است. این پارامتر
اجباری است و از نشانه‌گذاری معمول Kerberos استفاده می‌کند:
\fB<SERVICE\-NAME>/<server\-domain\-name>@<REALM>\fP\&.
.IP \(bu 2
\fBclient\-principal\fP نام principal در Kerberos برای سرویس Kea D2
است. این پارامتر اختیاری است و از نشانه‌گذاری معمول Kerberos استفاده می‌کند:
\fB<SERVICE\-NAME>/<server\-domain\-name>@<REALM>\fP\&.
.IP \(bu 2
\fBgss\-replay\-flag\fP مشخص می‌کند که آیا سرویس ضد تکرار (anti replay) در GSS
مورد نیاز است یا خیر. به طور پیش‌فرض فعال است اما می‌توان آن را غیرفعال کرد.
.IP \(bu 2
\fBgss\-sequence\-flag\fP مشخص می‌کند که آیا سرویس توالی (sequence) در GSS
مورد نیاز است یا خیر. به طور پیش‌فرض فعال نیست، اما توسط استاندارد ملزم شده است
بنابراین می‌تواند فعال شود.
.IP \(bu 2
\fBtkey\-protocol\fP تعیین می‌کند که کدام پروتکل برای برقراری بافت امنیتی (security context)
با کارسازهای DNS به کار رود. در حال حاضر، تنها مقادیر پشتیبانی‌شده
TCP (پیش‌فرض) و UDP هستند.
.IP \(bu 2
\fBtkey\-lifetime\fP طول عمر کلیدهای GSS\-TSIG را در
پروتکل TKEY مشخص می‌کند. این مقدار باید بیشتر از مقدار \fBrekey\-interval\fP
باشد. این پارامتر بر حسب ثانیه بیان شده و پیش‌فرض آن 3600 (یک ساعت) است.
.IP \(bu 2
\fBrekey\-interval\fP فاصله زمانی بررسی کلیدها برای کلیدزنی مجدد (rekeying) به ازای هر کارساز
پیکربندی‌شده را مدیریت می‌کند؛ به این معنی که اگر سن کلید قابل استفاده فعلی بیش از مقدار \fBrekey\-interval\fP باشد،
کلید جدیدی جایگزین آن می‌شود.
این مقدار باید کمتر از مقدار \fBtkey\-lifetime\fP باشد (توصیه می‌شود
بین ۵۰٪ تا ۸۰٪ مقدار \fBtkey\-lifetime\fP تنظیم شود). این پارامتر بر حسب
ثانیه بیان شده و مقدار پیش‌فرض آن 2700 (۴۵ دقیقه، یا ۷۵٪ از یک ساعت) است.
.IP \(bu 2
\fBretry\-interval\fP فاصله زمانی برای تلاش مجدد جهت ساخت کلید را، در صورت وقوع هرگونه خطای قبلی برای هر کارساز پیکربندی‌شده،
مدیریت می‌کند. این مقدار باید کمتر از
مقدار \fBrekey\-interval\fP باشد، و حداکثر باید ۱/۳ اختلاف بین
\fBtkey\-lifetime\fP و \fBrekey\-interval\fP باشد. این پارامتر بر حسب ثانیه
بیان شده و پیش‌فرض آن 120 (۲ دقیقه) است.
.IP \(bu 2
\fBfallback\fP رفتار سامانه را در زمانی که GSS\-TSIG باید استفاده شود (یک
کارساز DNS منطبق پیکربندی شده است) اما هیچ کلید GSS\-TSIG در دسترسی نیست، کنترل می‌کند.
اگر روی \fBfalse\fP (پیش‌فرض) تنظیم شود، از این کارساز صرف‌نظر می‌شود؛ اگر
روی \fBtrue\fP تنظیم شود، کارساز DNS نادیده گرفته شده و به‌روزرسانی DNS
با محافظت DHCP\-DDNS پیکربندی‌شده (مانند کلید TSIG)، یا
بدون هیچ حفاظتی (در صورت عدم پیکربندی) ارسال می‌شود.
.IP \(bu 2
\fBexchange\-timeout\fP مدت زمانی را تعیین می‌کند که فرآیند پیش از اتمام مهلت (timeout)
برای پایان تبادل TKEY در GSS\-TSIG منتظر می‌ماند. این مقدار بر حسب میلی‌ثانیه بیان شده
و پیش‌فرض آن 3000 (۳ ثانیه) است.
.IP \(bu 2
\fBuser\-context\fP یک پارامتر اختیاری است (برای توضیحات عمومی درباره زمینه‌های کاربری در Kea،
بخش Comments and User Context \%<#\:user-context> را ببینید).
.IP \(bu 2
\fBcomment\fP مجاز است اما در حال حاضر نادیده گرفته می‌شود.
.IP \(bu 2
\fBservers\fP فهرست کارسازهای DNS که GSS\-TSIG در آن‌ها فعال است را مشخص می‌کند.
.UNINDENT
.sp
پارامترهای نقشه کارساز (server map) در زیر شرح داده شده‌اند:
.INDENT 0.0
.IP \(bu 2
\fBid\fP یک شناسه به کارساز DNS اختصاص می‌دهد. از آن برای آمار
و دستورها استفاده می‌شود. این پارامتر الزامی است و نباید خالی باشد و باید یکتا باشد.
.IP \(bu 2
\fBdomain\-names\fP رابطه چندبه‌یک میان کارسازهای DNS مربوط به D2
و کارسازهای DNS مربوط به GSS\-TSIG را مدیریت می‌کند: برای هر نام دامنه در این فهرست،
Kea به دنبال کارساز DNS در D2 برای این دامنه با آدرس IP و درگاه (port)
مشخص‌شده می‌گردد. یک فهرست خالی (پیش‌فرض) به این معناست که تمام دامنه‌ها
منطبق هستند.
.IP \(bu 2
\fBip\-address\fP آدرس IP که کارساز DNS مربوط به GSS\-TSIG
روی آن به درخواست‌های DDNS و TKEY گوش می‌دهد را مشخص می‌کند. این یک پارامتر الزامی است.
.IP \(bu 2
\fBport\fP درگاه انتقال DNS که کارساز DNS مربوط به GSS\-TSIG
روی آن به درخواست‌های DDNS و TKEY گوش می‌دهد را مشخص می‌کند. مقدار پیش‌فرض آن 53 است.
.IP \(bu 2
\fBserver\-principal\fP نام principal در Kerberos برای کارساز DNS است
که به‌روزرسانی‌ها را دریافت می‌کند. پارامتر \fBserver\-principal\fP تنظیم‌شده در سطح
هر کارساز بر مقداری که در سطح سراسری تنظیم شده، اولویت دارد. این پارامتر الزامی است و باید در
سطح سراسری یا در سطح کارساز مشخص شود.
.IP \(bu 2
\fBclient\-principal\fP نام principal در Kerberos برای سرویس Kea D2
جهت این کارساز DNS است. پارامتر \fBclient\-principal\fP تنظیم‌شده در سطح هر کارساز
بر مقداری که در سطح سراسری تعیین شده اولویت دارد. این یک پارامتر اختیاری است.
.IP \(bu 2
\fBgss\-replay\-flag\fP مشخص می‌کند که آیا سرویس ضد تکرار GSS
مورد نیاز است یا خیر. پارامتر \fBgss\-replay\-flag\fP تنظیم‌شده در سطح هر کارساز
بر مقدار تنظیم‌شده در سطح سراسری اولویت دارد. این یک پارامتر اختیاری است
که پیش‌فرض آن true می‌باشد.
.IP \(bu 2
\fBgss\-sequence\-flag\fP مشخص می‌کند که آیا سرویس توالی GSS
مورد نیاز است یا خیر. پارامتر \fBgss\-sequence\-flag\fP تنظیم‌شده در سطح هر کارساز
بر مقدار تنظیم‌شده در سطح سراسری اولویت دارد. این یک پارامتر اختیاری است
که مقدار پیش‌فرض آن false می‌باشد.
.IP \(bu 2
\fBtkey\-protocol\fP مشخص می‌کند که چه پروتکلی برای برقراری بافت
امنیتی با کارساز DNS به کار رود. پارامتر \fBtkey\-protocol\fP تنظیم‌شده در سطح
هر کارساز بر مقدار تنظیم‌شده در سطح سراسری اولویت دارد. مقادیر پیش‌فرض و پشتیبانی‌شده
برای پارامتر سطح هر کارساز همانند مقادیر
پارامتر سطح سراسری است.
.IP \(bu 2
\fBtkey\-lifetime\fP طول عمر کلیدهای GSS\-TSIG را در
پروتکل TKEY برای کارساز DNS مشخص می‌کند. پارامتر \fBtkey\-lifetime\fP تنظیم‌شده در سطح
هر کارساز بر مقدار تعیین‌شده در سطح سراسری اولویت دارد. مقادیر پیش‌فرض و پشتیبانی‌شده
برای پارامتر در سطح هر کارساز با مقادیر
پارامتر در سطح سراسری یکسان است.
.IP \(bu 2
\fBrekey\-interval\fP بازه زمانی را تعیین می‌کند که در آن کلیدهای این کارساز
خاص برای کلیدزنی مجدد بررسی می‌شوند؛ بدین معنا که اگر سن کلید قابل استفاده فعلی از مقدار \fBrekey\-interval\fP بیشتر باشد،
کلید جدیدی جایگزین آن خواهد شد.
این مقدار باید از مقدار \fBtkey\-lifetime\fP کوچکتر باشد (توصیه می‌شود
بین ۵۰٪ تا ۸۰٪ مقدار \fBtkey\-lifetime\fP تنظیم گردد). پارامتر \fBrekey\-interval\fP
تنظیم‌شده در سطح هر کارساز بر مقداری که در سطح سراسری تنظیم شده اولویت
دارد. مقادیر پیش‌فرض و پشتیبانی‌شده برای پارامتر در سطح هر کارساز مانند
پارامتر در سطح سراسری است.
.IP \(bu 2
\fBretry\-interval\fP بازه زمانی تلاش مجدد برای ساخت کلید را در صورت وقوع هرگونه
خطای قبلی برای این کارساز خاص مدیریت می‌کند. این مقدار باید
از مقدار \fBrekey\-interval\fP کوچکتر باشد و حداکثر ۱/۳ اختلاف بین
\fBtkey\-lifetime\fP و \fBrekey\-interval\fP باشد.
پارامتر \fBretry\-interval\fP تنظیم‌شده در سطح هر کارساز بر مقدار تنظیم‌شده در سطح سراسری
اولویت دارد. مقادیر پیش‌فرض و پشتیبانی‌شده برای پارامتر در سطح هر کارساز همانند
پارامتر در سطح سراسری است.
.IP \(bu 2
\fBfallback\fP رفتار سامانه را هنگامی که GSS\-TSIG باید استفاده شود (یک
کارساز DNS متناظر پیکربندی شده است) اما کلید GSS\-TSIG در دسترس نیست کنترل می‌کند.
پارامتر \fBfallback\fP تنظیم‌شده در سطح هر کارساز بر مقدار تعیین‌شده در سطح سراسری
اولویت دارد. مقادیر پیش‌فرض و پشتیبانی‌شده برای پارامتر سطح کارساز همانند
مقادیر پارامتر در سطح سراسری است.
.IP \(bu 2
\fBexchange\-timeout\fP مدت زمانی که پیش از اتمام مهلت فرآیند باید منتظر تبادل
GSS\-TSIG TKEY ماند را مدیریت می‌کند. پارامتر \fBexchange\-timeout\fP
تنظیم‌شده در سطح هر کارساز بر مقدار تعیین‌شده در سطح سراسری
اولویت دارد. مقادیر پیش‌فرض و پشتیبانی‌شده برای پارامتر در سطح هر کارساز مانند
پارامتر در سطح سراسری است.
.IP \(bu 2
\fBignore\-bad\-direction\fP یک راه‌حل موقت (workaround) برای باگ کارساز Microsoft را مدیریت می‌کند.
هنگامی که به طور صریح روی true تنظیم شود، پاسخ‌های به‌روزرسانی DNS ارسالی حتی اگر پیش‌نیازها
با امضای درخواست شکست بخورند، به عنوان تأییدشده پذیرفته می‌شوند.
.IP \(bu 2
\fBuser\-context\fP یک پارامتر اختیاری است (برای توضیحات عمومی درباره زمینه‌های کاربری در Kea،
بخش Comments and User Context \%<#\:user-context> را ببینید).
.IP \(bu 2
\fBcomment\fP مجاز است اما در حال حاضر نادیده گرفته می‌شود.
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
به طور کلی تعیین همزمان جدول کلید کلاینت (\fBclient\-keytab\fP)
و حافظه موقت مدارک هویتی (\fBcredentials\-cache\fP) توصیه نمی‌شود، هرچند ممکن است این مورد
در پیاده‌سازی‌های مختلف Kerberos متفاوت باشد. جدول کلید کلاینت تنها برای
کلید کلاینت است و به طور معمول برای تعیین صریح کلید به روشی ایستا‌تر
به کار می‌رود، در حالی که حافظه موقت مدارک هویتی می‌تواند چندین مدرک
را ذخیره کند و می‌تواند توسط کتابخانه Kerberos به صورت پویا به‌روزرسانی شود. به همین دلیل،
\fBcredentials\-cache\fP انعطاف‌پذیرتر بوده و در نتیجه گزینه توصیه‌شده است.
.sp
همچنین توجه داشته باشید که برای استفاده از این حافظه موقت، تنها مجوز دسترسی خواندن لازم است.
واکشی مدارک هویتی و به‌روزرسانی حافظه موقت نیازمند مجوز دسترسی نوشتن
است.
.UNINDENT
.UNINDENT.SS حذف خودکار کلید GSS\-TSIG
.sp
سرور به‌صورت دوره‌ای کلیدها را پس از این‌که مدت زمان انقضای آن‌ها بیش از سه برابر حداکثر عمر کلید (پارامتر \fBtkey\-lifetime\fP) گذشته باشد، حذف می‌کند. کاربر این گزینه را دارد که با استفاده از دستور \fBgss\-tsig\-purge\-all\fP یا دستور \fBgss\-tsig\-purge\fP کلیدها را بر حسب نیاز پاکسازی کند.
.SS پیکربندی GSS\-TSIG برای استقرار
.sp
هنگام استفاده از Kerberos 5 و BIND 9 همان‌طور که در GSS\-TSIG Deployment شرح داده شده است، تحلیل‌گر محلی (local resolver) باید به نشانی سرور \fBnamed\fP در BIND 9 اشاره کند. همچنین Kerberos محلی باید با قرار دادن متن زیر در فایل \fBkrb5.conf\fP پیکربندی شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[libdefaults]
    default_realm = EXAMPLE.ORG
    kdc_timesync = 1
    ccache_type = 4
    forwardable = true
    proxiable = true
[realms]
    EXAMPLE.ORG = {
            kdc = kdc.example.org
            admin_server = kdc.example.org
    }
.EE
.UNINDENT
.UNINDENT
.sp
در Windows AD، سرویس DNS توسط AD ارائه می‌شود که سرویس Kerberos را نیز فراهم می‌کند. متن مورد نیاز در فایل \fBkrb5.conf\fP به صورت زیر خواهد بود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[libdefaults]
    default_realm = <REALM>
    kdc_timesync = 1
    ccache_type = 4
    forwardable = true
    proxiable = true
[realms]
    ${REALM} = {
            kdc = <AD_IP_ADDR>
            admin_server = <AD_IP_ADDR>
    }
.EE
.UNINDENT
.UNINDENT
.sp
حتی زمانی که کتابخانه GSS\-API می‌تواند از کلید محرمانه موجود در جدول کلید (key table) کلاینت استفاده کند، از نظر کارایی، دریافت و کش کردن اعتبارنامه‌ها (credentials) به مراتب بهتر است.
.sp
این کار می‌تواند به صورت دستی با دستور زیر انجام شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
kinit \-k \-t /usr/local/share/kea/dhcp.keytab DHCP/admin.example.org
.EE
.UNINDENT
.UNINDENT
.sp
یا هنگام استفاده از AD:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
kinit \-k \-t /usr/local/share/kea/dhcp.keytab DHCP/kea.<domain>
.EE
.UNINDENT
.UNINDENT
.sp
کش اعتبارنامه را می‌توان با استفاده از \fBklist\fP\& نمایش داد.
.sp
در محیط عملیاتی، بهتر است به یک مدیریت‌کننده اعتبارنامه Kerberos مانند System Security Services Daemon (\fBsssd\fP) تکیه شود.
.sp
هنگام استفاده از BIND 9، پرینسیپال سرور (server principal) به شکل \(dq\%<DNS/\:server\:.example\:.org@\:EXAMPLE>\&.ORG¨ است؛ با AD، قالب به صورت \(dqDNS/<server>.<domain>@<REALM>\(dq می‌باشد.
.SS آمار GSS\-TSIG
.sp
کتابخانه قلاب GSS\-TSIG آمارهای جدیدی را در سطوح سراسری و به ازای هر سرور DNS معرفی می‌کند:
.INDENT 0.0
.IP \(bu 2
\fBgss\-tsig\-key\-created\fP \- تعداد کلیدهای GSS\-TSIG ایجادشده
.IP \(bu 2
\fBtkey\-sent\fP \- تعداد درخواست‌های اولیه ارسالی برای تبادل TKEY
.IP \(bu 2
\fBtkey\-success\fP \- تعداد تبادلات TKEY که با موفقیت انجام شده‌اند
.IP \(bu 2
\fBtkey\-timeout\fP \- تعداد تبادلات TKEY که با اتمام مهلت زمانی (timeout) پایان یافته‌اند
.IP \(bu 2
\fBtkey\-error\fP \- تعداد تبادلات TKEY که با خطایی غیر از اتمام مهلت زمانی به پایان رسیده‌اند
.UNINDENT
.sp
رابطه بین کلیدها و سرورهای DNS بین کد D2 و کلیدهای ایستای TSIG، در مقایسه با کلیدهای GSS\-TSIG و سرورهای DNS بسیار متفاوت است:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
یک کلید ایستای TSIG می‌تواند بین چندین سرور DNS به اشتراک گذاشته شود؛
.IP \(bu 2
یک کلید GSS\-TSIG تنها توسط یک سرور DNS درون یک مجموعه اختصاصی از کلیدها استفاده می‌شود.
.UNINDENT
.UNINDENT
.UNINDENT
.SS دستورهای GSS\-TSIG
.sp
کتابخانه قلاب GSS\-TSIG از چند دستور پشتیبانی می‌کند که در زیر توضیح داده شده‌اند.
.SS دستور \fBgss\-tsig\-get\-all\fP
.sp
این دستور تمامی سرورها و کلیدهای GSS\-TSIG را فهرست می‌کند.
.sp
یک نمونه از فراخوانی دستور به این صورت است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqgss\-tsig\-get\-all\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
اینجا نمونه‌ای از پاسخی که یک سرور GSS\-TSIG و یک کلید را بازمی‌گرداند آورده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq1 GSS\-TSIG servers and 1 keys\(dq,
    \(dqarguments\(dq: {
        \(dqgss\-tsig\-servers\(dq: [
            {
                \(dqid\(dq: \(dqfoo\(dq,
                \(dqip\-address\(dq: \(dq192.1.2.3\(dq,
                \(dqport\(dq: 53,
                \(dqserver\-principal\(dq: \(dqDNS/foo.com@FOO.COM\(dq,
                \(dqkey\-name\-suffix\(dq: \(dqfoo.com.\(dq,
                \(dqtkey\-lifetime\(dq: 3600,
                \(dqtkey\-protocol\(dq: \(dqTCP\(dq,
                \(dqkeys\(dq: [
                    {
                        \(dqname\(dq: \(dq1234.sig\-foo.com.\(dq,
                        \(dqinception\-date\(dq: \(dq2021\-09\-05 12:23:36.281176\(dq,
                        \(dqserver\-id\(dq: \(dqfoo\(dq,
                        \(dqexpire\-date\(dq: \(dq2021\-09\-05 13:23:36.281176\(dq,
                        \(dqstatus\(dq: \(dqnot yet ready\(dq,
                        \(dqtkey\-exchange\(dq: true
                    }
                ]
            },
            {
                \(dqid\(dq: \(dqbar\(dq,
                \(dqip\-address\(dq: \(dq192.1.2.4\(dq,
                \(dqport\(dq: 53,
                \(dqserver\-principal\(dq: \(dqDNS/bar.com@FOO.COM\(dq,
                \(dqkey\-name\-suffix\(dq: \(dqbar.com.\(dq,
                \(dqtkey\-lifetime\(dq: 7200,
                \(dqtkey\-protocol\(dq: \(dqUDP\(dq,
                \(dqkeys\(dq: [ ]
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT.SS دستور \fBgss\-tsig\-get\fP
.sp
این دستور اطلاعات مربوط به سرور GSS\-TSIG مشخص‌شده را بازیابی می‌کند.
.sp
نمونه‌ای از فراخوانی دستور به این شکل است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqgss\-tsig\-get\(dq,
    \(dqarguments\(dq: {
        \(dqserver\-id\(dq: \(dqfoo\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
در اینجا نمونه‌ای از یک پاسخ که اطلاعات مربوط به سرور \(dqfoo\(dq را بازمی‌گرداند آورده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqGSS\-TSIG server[foo] found\(dq,
    \(dqarguments\(dq: {
        \(dqid\(dq: \(dqfoo\(dq,
        \(dqip\-address\(dq: \(dq192.1.2.3\(dq,
        \(dqport\(dq: 53,
        \(dqserver\-principal\(dq: \(dqDNS/foo.com@FOO.COM\(dq,
        \(dqkey\-name\-suffix\(dq: \(dqfoo.com.\(dq,
        \(dqtkey\-lifetime\(dq: 3600,
        \(dqtkey\-protocol\(dq: \(dqTCP\(dq,
        \(dqkeys\(dq: [
            {
                \(dqname\(dq: \(dq1234.sig\-foo.com.\(dq,
                \(dqserver\-id\(dq: \(dqfoo\(dq,
                \(dqinception\-date\(dq: \(dq2021\-09\-05 12:23:36.281176\(dq,
                \(dqexpire\-date\(dq: \(dq2021\-09\-05 13:23:36.281176\(dq,
                \(dqstatus\(dq: \(dqnot yet ready\(dq,
                \(dqtkey\-exchange\(dq: true
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.SS دستور \fBgss\-tsig\-list\fP
.sp
این دستور فهرستی از شناسه سرورهای GSS\-TSIG و نام کلیدها را ایجاد می‌کند.
.sp
نمونه‌ای از فراخوانی دستور به این شکل است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqgss\-tsig\-list\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
در اینجا نمونه‌ای از یک پاسخ که دو سرور GSS\-TSIG و سه کلید را بازمی‌گرداند آورده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq2 GSS\-TSIG servers and 3 keys\(dq,
    \(dqarguments\(dq: {
        \(dqgss\-tsig\-servers\(dq: [
            \(dqfoo\(dq,
            \(dqbar\(dq
        ],
        \(dqgss\-tsig\-keys\(dq: [
            \(dq1234.example.com.\(dq,
            \(dq5678.example.com.\(dq,
            \(dq43888.example.org.\(dq
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.SS دستور \fBgss\-tsig\-key\-get\fP
.sp
این دستور اطلاعات مربوط به کلید GSS\-TSIG مشخص‌شده را بازیابی می‌کند.
.sp
نمونه‌ای از فراخوانی دستور به این شکل است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqgss\-tsig\-key\-get\(dq,
    \(dqarguments\(dq: {
        \(dqkey\-name\(dq: \(dq1234.sig\-foo.com.\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
در اینجا نمونه‌ای از یک پاسخ که اطلاعات مربوط به کلید GSS\-TSIG با عنوان \(dq1234.sig\-foo.com.\(dq را بازمی‌گرداند آورده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqGSS\-TSIG key \(aq1234.sig\-foo.com.\(aq found\(dq,
    \(dqarguments\(dq: {
        \(dqname\(dq: \(dq1234.sig\-foo.com.\(dq,
        \(dqserver\-id\(dq: \(dqfoo\(dq,
        \(dqinception\-date\(dq: \(dq2021\-09\-05 12:23:36.281176\(dq,
        \(dqexpire\-date\(dq: \(dq2021\-09\-05 13:23:36.281176\(dq,
        \(dqstatus\(dq: \(dqnot yet ready\(dq,
        \(dqtkey\-exchange\(dq: true
    }
}
.EE
.UNINDENT
.UNINDENT.SS دستور \fBgss\-tsig\-key\-expire\fP
.sp
این دستور کلید GSS\-TSIG مشخص‌شده را منقضی می‌کند.
.sp
نمونه‌ای از فراخوانی دستور به صورت زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqgss\-tsig\-key\-expire\(dq,
    \(dqarguments\(dq: {
        \(dqkey\-name\(dq: \(dq1234.sig\-foo.com.\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
در اینجا نمونه‌ای از یک پاسخ آورده شده است که نشان می‌دهد کلید GSS\-TSIG با نام \(dq1234.sig\-foo.com.\(dq منقضی شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqGSS\-TSIG key \(aq1234.sig\-foo.com.\(aq expired\(dq
}
.EE
.UNINDENT
.UNINDENT
.SS دستور \fBgss\-tsig\-key\-del\fP
.sp
این دستور کلید GSS\-TSIG مشخص‌شده را حذف می‌کند.
.sp
نمونه‌ای از فراخوانی دستور به صورت زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqgss\-tsig\-key\-del\(dq,
    \(dqarguments\(dq: {
        \(dqkey\-name\(dq: \(dq1234.sig\-foo.com.\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
در اینجا نمونه‌ای از یک پاسخ آورده شده است که نشان می‌دهد کلید GSS\-TSIG با نام \(dq1234.sig\-foo.com.\(dq حذف شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqGSS\-TSIG key \(aq1234.sig\-foo.com.\(aq deleted\(dq
}
.EE
.UNINDENT
.UNINDENT
.SS دستور \fBgss\-tsig\-purge\-all\fP
.sp
این دستور تمام کلیدهای غیرقابل‌استفاده‌ی GSS\-TSIG را پاک‌سازی می‌کند.
.sp
نمونه‌ای از فراخوانی دستور به صورت زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqgss\-tsig\-purge\-all\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
در اینجا نمونه‌ای از یک پاسخ آورده شده است که نشان می‌دهد دو کلید GSS\-TSIG پاک‌سازی شده‌اند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq2 purged GSS\-TSIG keys\(dq
}
.EE
.UNINDENT
.UNINDENT
.SS دستور \fBgss\-tsig\-purge\fP
.sp
این دستور کلیدهای غیرقابل‌استفاده‌ی GSS\-TSIG را برای سرور مشخص‌شده پاک‌سازی می‌کند.
.sp
نمونه‌ای از فراخوانی دستور به صورت زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqgss\-tsig\-purge\(dq,
    \(dqarguments\(dq: {
        \(dqserver\-id\(dq: \(dqfoo\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
در اینجا نمونه‌ای از یک پاسخ آورده شده است که نشان می‌دهد دو کلید GSS\-TSIG برای سرور \(dqfoo\(dq پاک‌سازی شده‌اند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq2 purged keys for GSS\-TSIG server[foo]\(dq
}
.EE
.UNINDENT
.UNINDENT.SS دستور \fBgss\-tsig\-rekey\-all\fP
.sp
این دستور بدون قید و شرط کلیدهای جدید GSS\-TSIG را برای تمام کارگزارهای DNS مجدداً ایجاد می‌کند (عملیات تجدید کلید یا rekey).
.sp
نمونه‌ای از فراخوانی این دستور به شکل زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqgss\-tsig\-rekey\-all\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
در ادامه نمونه‌ای از پاسخی که نشان می‌دهد تجدید کلید انجام شده است آورده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqrekeyed\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور به عنوان مثال هنگامی که کارگزار DHCP\-DDNS مجدداً به شبکه متصل می‌شود مفید است.
.SS دستور \fBgss\-tsig\-rekey\fP
.sp
این دستور بدون قید و شرط کلیدهای جدید GSS\-TSIG را برای یک کارگزار DNS مشخص بازتولید می‌کند (عملیات rekey).
.sp
نمونه‌ای از فراخوانی این دستور به شکل زیر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqgss\-tsig\-rekey\(dq,
    \(dqarguments\(dq: {
        \(dqserver\-id\(dq: \(dqfoo\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
در ادامه نمونه‌ای از پاسخی که نشان می‌دهد تجدید کلید انجام شده است آورده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqGSS\-TSIG server[foo] rekeyed\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور معمولاً زمانی استفاده می‌شود که یک کارگزار DNS بازراه‌اندازی (reboot) شده باشد، به طوری که کلیدهای GSS\-TSIG مشترک فعلی با این کارگزار دیگر قابل استفاده نباشند.
.SS RADIUS
.SS هشدار امنیتی (Security Warning)
.sp
امنیت RADIUS/UDP (و RADIUS/TCP) مبتنی بر استفاده مستقیم از MD5 به همراه کلید مخفی مشترک (shared secret) و گذرواژه دسترسی کاربر است. این سازوکارهای امنیتی به ضعیف بودن شناخته می‌شدند، اما این موضوع با انتشار آسیب‌پذیری Blast\-RADIUS در \%<https://\:www\:.blastradius\:.fail>
(شناسه CVE\-2024\-3596 در \%<https://\:www\:.cve\:.org/\:CVERecord?\:id=CVE-2024-3596>) دگرگون شد.
.sp
به طور خلاصه، زمانی که زیرساخت ارتباطی میان کلاینت RADIUS (در اینجا کارگزار Kea DHCP) و کارگزار RADIUS محافظت‌نشده باشد، یک مهاجم مرد میانی (man\-in\-the\-middle) می‌تواند در پاسخ به یک درخواست دسترسی / احراز هویت ناموفق، یک پیام پذیرش (accept) معتبر جعل کند.
.sp
برخی از کارگزارهای RADIUS از جمله کارگزار پرکاربرد FreeRADIUS از هم‌اکنون به صورت پیش‌فرض از پاسخ‌گویی به درخواست‌هایی که به دلیل عدم محافظت توسط مشخصه Message\-Authenticator ناامن تلقی می‌شوند خودداری می‌کنند (این مشخصه مبتنی بر HMAC\-MD5 است و بنابراین آسیب‌پذیر نبوده و از Kea 3.1.5 به بعد پشتیبانی می‌شود)؛ بنابراین حتی زمانی که زیرساخت محافظت‌شده باشد، استقرار RADIUS تحت تأثیر Blast\-RADIUS قرار می‌گیرد.
.sp
راهکارهای ارائه‌شده توسط نسخه 3.1.6 از Kea عبارتند از:
.sp
۱. پشتیبانی از RADIUS/TLS که حفاظت رمزنگاری‌شده توکار را برای ارتباط میان کلاینت‌ها و کارگزارهای RADIUS فراهم می‌کند. این روش به عنوان راهکار بلندمدت شناخته می‌شود.
.sp
۲. پشتیبانی از راهکار کوتاه‌مدت با افزودن مشخصه Message\-Authenticator به تمام پیام‌های ارسالی و الزام به وجود آن در تمام پیام‌های دریافتی (توجه داشته باشید که مورد دوم تنها توسط کارگزارهای جدید RADIUS اعمال می‌شود).
.sp
این راهکارها آزمایشی (experimental) هستند.
.SS نمای کلی RADIUS (RADIUS Overview)
.sp
این کتابخانه قلاب (hook library) به Kea امکان می‌دهد با دو نوع از خدمات RADIUS تعامل داشته باشد: دسترسی (access) و حسابرسی (accounting). متداول‌ترین شیوه یکپارچه‌سازی DHCP و RADIUS در سطح عامل رله DHCP (relay\-agent) انجام می‌شود: کلاینت‌های DHCP بسته‌های DHCP را به رله‌های DHCP می‌فرستند؛ این رله‌ها با کارگزار RADIUS ارتباط برقرار کرده و بسته به پاسخ، بسته را به کارگزار DHCP ارسال می‌کنند یا آن را نادیده می‌گیرند (drop می‌کنند). با این حال، این کار مستلزم پشتیبانی سخت‌افزار رله DHCP از ارتباطات RADIUS است، و حتی اگر رله پشتیبانی لازم را داشته باشد، اغلب به اندازه کافی انعطاف‌پذیر نیست تا مشخصه‌های اضافی RADIUS را ارسال و دریافت کند. یک جایگزین جذاب‌تر وجود دارد: توسعه دادن کارگزار DHCP برای برقراری ارتباط مستقیم با RADIUS. این موضوع، هدف اصلی این کتابخانه است.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این کتابخانه تنها می‌تواند توسط فرایندهای \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> یا
\fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> بارگذاری شود.
.UNINDENT
.UNINDENT
.sp
ویژگی عمده این کتابخانه قلاب، امکان استفاده از مجوزدهی (authorization) توسط RADIUS است. هنگامی که یک بسته DHCP دریافت می‌شود، کارگزار Kea یک Access\-Request به کارگزار RADIUS ارسال کرده و منتظر پاسخ می‌ماند. سپس کارگزار پاسخی به صورت Access\-Accept با مشخصه‌های خاص کلاینت یا Access\-Reject برمی‌گرداند. در اینجا دو حالت پشتیبانی می‌شود: نخست، Access\-Accept شامل مشخصه Framed\-IP\-Address (برای DHCPv4) یا مشخصه Framed\-IPv6\-Address/Delegated\-IPv6\-Prefix (برای DHCPv6) است که توسط Kea به عنوان دستورالعملی برای اختصاص آدرس IPv4 یا IPv6 یا پیشوند IPv6 مشخص‌شده تفسیر می‌شود. این سازوکار در عمل بدان معناست که RADIUS می‌تواند به عنوان یک پایگاه داده رزرو آدرس عمل کند.
.sp
دومین حالت پشتیبانی‌شده، قابلیت تخصیص کلاینت‌ها به استخرهای (pools) خاص بر اساس پاسخ RADIUS است. در این حالت، کارگزار RADIUS یک Access\-Accept همراه با مشخصه Framed\-Pool ارسال می‌کند. برای هر دو پروتکل DHCPv4 و DHCPv6، کارگزار Kea این مشخصه را به عنوان یک کلاس کلاینت (client class) در نظر می‌گیرد. با افزودن قابلیت محدودسازی دسترسی به استخرها برای کلاس‌های خاص (به بخش پیکربندی استخرها با اطلاعات کلاس \%<#\:classification-pools> مراجعه کنید)، می‌توان از RADIUS برای واداشتن کلاینت به تخصیص یک نشانی پویا یا پیشوند از استخری خاص استفاده کرد. علاوه بر این، در صورتی که گزینه‌های DHCP برای یک کلاس مشخص تعریف شده باشند، می‌توان از همین سازوکار برای کنترل اینکه کلاینت چه نوع گزینه‌هایی را دریافت می‌کند نیز بهره گرفت..SS پیکربندی کتابخانه هوک RADIUS
.sp
هوک RADIUS کتابخانه‌ای است که باید توسط کارسازهای \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> یا
\fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6> بارگذاری شود. برخلاف برخی دیگر از کتابخانه‌های هوک موجود، این کتابخانه
پارامترهای متعددی می‌گیرد. برای نمونه، می‌توان از این پیکربندی استفاده کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqDhcp4\(dq: {

    // پارامترهای پیکربندی معمول DHCPv4 شما در اینجا قرار می‌گیرند.

    \(dqhooks\-libraries\(dq: [
      {
        // توجه داشته باشید که سرویس دسترسی RADIUS برای عملکرد صحیح به host\-cache نیاز دارد،
        // بنابراین این کتابخانه نیز بارگذاری می‌شود.
        \(dqlibrary\(dq: \(dqlibdhcp_host_cache.so\(dq
      },
      {
        \(dqlibrary\(dq: \(dqlibdhcp_radius.so\(dq,
        \(dqparameters\(dq: {

          // مشخص کنید لغت‌نامه در کجا قرار دارد.
          \(dqdictionary\(dq: \(dq/etc/kea/radius/dictionary\(dq,

          // مشخص کنید از کدام آدرس برای برقراری ارتباط با کارسازهای RADIUS استفاده شود
          \(dqbindaddr\(dq: \(dq*\(dq

          // پارامترهای بیشتر RADIUS در اینجا قرار می‌گیرند.
        }
      }
    ]
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
محیط RADIUS پیچیده است. از این رو، ارائه یک پیکربندی پیش‌فرض که
برای همگان کارآمد باشد امکان‌پذیر نیست.
با این حال، ما نمونه‌ای داریم که برخی از ویژگی‌های رایج‌تر را
نشان می‌دهد؛ لطفاً kea4/hooks\-radius.json \%<#\:config-example-kea4-hooks-radius-json>\& را ببینید.
.sp
کتابخانه هوک RADIUS از پرچم‌های پیکربندی سراسری زیر پشتیبانی
می‌کند:
.INDENT 0.0
.IP \(bu 2
\fBbindaddr\fP (پیش‌فرض \fB\(dq*\(dq\fP) \- آدرسی را که باید توسط کتابخانه هوک در
ارتباط با کارسازهای RADIUS استفاده شود مشخص می‌کند. مقدار ویژه \fB\(dq*\(dq\fP
به هسته می‌گوید که آدرس را در زمان بارگذاری کتابخانه هوک انتخاب کند.
.IP \(bu 2
\fBcanonical\-mac\-address\fP (پیش‌فرض \fBfalse\fP) \- مشخص می‌کند که آیا نشانی‌های MAC
در صفت‌ها از قالب رسمی RADIUS (جفت‌رقم‌های هگزادسیمال کوچک جداشده با \fB\-\fP)
پیروی کنند یا خیر.
.IP \(bu 2
\fBclient\-id\-pop0\fP (پیش‌فرض \fBfalse\fP) \- همراه با
\fBlibdhcp_flex_id.so\fP \%<#\:std-ischooklib-libdhcp_flex_id\:.so> استفاده می‌شود؛ صفر ابتدایی (یا جفت صفر
در DHCPv6) نوع شناسه کلاینت (DUID در DHCPv6) را حذف می‌کند. برای
هرگونه پیامدهای مقداری در صورت استفاده هم‌زمان با آن، به
\fBclient\-id\-printable\fP مراجعه کنید.
.IP \(bu 2
\fBclient\-id\-printable\fP (پیش‌فرض \fBfalse\fP) \- بررسی می‌کند که آیا محتوای
\fBclient\-id\fP/\fBduid\fP قابل‌چاپ است یا خیر و به جای هگزادسیمال، آن را همان‌طور که هست
استفاده می‌کند. این گزینه مستلزم اعمال خودکار \fBclient\-id\-pop0\fP و \fBextract\-duid\fP است، زیرا 0 و 255
قابل‌چاپ نیستند.
.IP \(bu 2
\fBdeadtime\fP (پیش‌فرض \fB0\fP) \- سازوکاری است که به مرتب‌سازی کارسازها کمک می‌کند
تا ابتدا با کارسازهایی که تا کنون پاسخگو بوده‌اند ارتباط برقرار شود،
و کارسازهایی که پاسخگو نبوده‌اند برای تلاش‌های بعدی گذاشته شوند. مقدار
deadtime تعداد ثانیه‌هایی را مشخص می‌کند که پس از آن یک کارساز غیرپاسخگو
در نظر گرفته می‌شود. مقدار 0 این سازوکار را غیرفعال می‌کند.
.IP \(bu 2
\fBdictionary\fP (پیش‌فرض \fB\(dq/etc/kea/radius/dictionary\(dq\fP) \- لغت‌نامه
صفت‌ها و مقادیر است؛ توجه داشته باشید که این یک پارامتر حیاتی است.
یک لغت‌نامه توسط Kea ارائه شده و به صورت پیش‌فرض تنظیم گردیده است.
.IP \(bu 2
\fBextract\-duid\fP (پیش‌فرض \fBtrue\fP) \- مقدار DUID تعبیه‌شده را از یک
شناسه کلاینت DHCPv4 منطبق با RFC 4361 استخراج می‌کند. برای هرگونه پیامدهای
مقداری در صورت استفاده هم‌زمان با آن، به \fBclient\-id\-printable\fP مراجعه کنید.
.IP \(bu 2
\fBidentifier\-type4\fP (پیش‌فرض \fB\(dqclient\-id\(dq\fP) \- نوع شناسه را برای
ساخت صفت User\-Name برای DHCPv4 مشخص می‌کند؛ این مقدار باید با شناسه میزبان
یکسان باشد. هنگامی که از \fBlibdhcp_flex_id.so\fP \%<#\:std-ischooklib-libdhcp_flex_id\:.so> استفاده می‌شود،
\fBreplace\-client\-id\fP باید روی \fBtrue\fP تنظیم شده و \fBclient\-id\fP همراه با
فعال بودن \fBclient\-id\-pop0\fP به کار رود.
.IP \(bu 2
\fBidentifier\-type6\fP (پیش‌فرض \fB\(dqduid\(dq\fP) \- نوع شناسه را برای ساخت
صفت User\-Name برای DHCPv6 مشخص می‌کند؛ این مقدار باید با شناسه میزبان
یکسان باشد. هنگامی که از \fBlibdhcp_flex_id.so\fP \%<#\:std-ischooklib-libdhcp_flex_id\:.so> استفاده می‌شود،
\fBreplace\-client\-id\fP باید روی \fBtrue\fP تنظیم شده و \fBduid\fP همراه با
فعال بودن \fBclient\-id\-pop0\fP به کار رود.
.IP \(bu 2
\fBnas\-ports\fP (پیش‌فرض \fB[]\fP) \- پورت NAS را برای استفاده به جای
شناسه زیرشبکه (رفتار پیش‌فرض) مشخص می‌کند. این یک آرایه از نگاشت‌ها است که هر نگاشت حداکثر دو
عنصر دارد: مقدار الزامی پورت NAS، و به صورت اختیاری، یک انتخاب‌گر
متشکل از شناسه زیرشبکه، پیشوند زیرشبکه یا نام شبکه اشتراکی (shared\-network).
اگر انتخاب‌گر بر روی بسته اعمال شود، پورت NAS به جای شناسه زیرشبکه
استفاده خواهد شد. زمانی که شناسه زیرشبکه 0 باشد یا وجود نداشته باشد، پورت NAS مشخص‌شده به عنوان
پیش‌فرض عمل می‌کند. این جایگزینی برای تمامی بسته‌هایی که با هیچ انتخاب‌گری
مطابقت نداشته‌اند رخ می‌دهد.
.IP \(bu 2
\fBprotocol\fP (پیش‌فرض \fBUDP\fP) \- از نسخه Kea 3.1.6، پروتکل لایه
انتقال را مشخص می‌کند. مقادیر پذیرفته‌شده عبارتند از \fBUDP\fP و \fBTLS\fP\&.
.IP \(bu 2
\fBreselect\-subnet\-address\fP (پیش‌فرض \fBfalse\fP) \- انتخاب مجدد زیرشبکه را
با توجه به مقدار صفت Framed\-IP\-Address یا به ترتیب
Framed\-IPv6\-Address دریافتی از پاسخ دسترسی RADIUS فعال می‌کند. با فعال بودن
این پرچم، اگر نشانی IP در محدوده زیرشبکه فعلیِ انتخاب‌شده نباشد، اما در محدوده
زیرشبکه دیگری باشد که با توجه به معیارهای دیگر قابل انتخاب است، زیرشبکه دوم
انتخاب شده و در مراحل بعدی تخصیص اجاره به کار می‌رود.
.IP \(bu 2
\fBreselect\-subnet\-pool\fP (پیش‌فرض \fBfalse\fP) \- انتخاب مجدد زیرشبکه را
با توجه به مقدار صفت Framed\-Pool دریافتی از پاسخ دسترسی RADIUS
فعال می‌کند. با فعال بودن این پرچم، اگر زیرشبکه انتخاب‌شده فعلی
توسط کلاس کلاینت نشان‌داده‌شده با مقدار صفت محافظت نشده باشد، اما
زیرشبکه قابل‌انتخاب دیگری وجود داشته باشد که توسط آن محافظت شده است، زیرشبکه
دوم انتخاب شده و در ادامه فرایند تخصیص اجاره استفاده می‌شود.
این انتخاب مجدد ابتدا امتحان می‌شود و در صورت موفقیت، از به کار افتادن
عملکرد \fBreselect\-subnet\-address\fP جلوگیری می‌کند.
.IP \(bu 2
\fBretries\fP (پیش‌فرض \fB3\fP) \- تعداد تلاش‌های مجدد پیش از امتحان کردن
کارساز بعدی است.
.IP \(bu 2
\fBsession\-history\fP (پیش‌فرض \fB\(dq\(dq\fP) \- نام فایلی است که حافظه
پایدار را برای تاریخچه نشست‌های حسابرسی فراهم می‌کند.
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
\fBthread\-pool\-size\fP (پیش‌فرض \fB0\fP) نشان‌دهنده تعداد ریسه‌هایی است
که برای ارسال درخواست‌های RADIUS و پردازش پاسخ‌های RADIUS برای هر دو سرویس
دسترسی و حسابرسی قبل از انتقال آن‌ها به استخر ریسه هسته استفاده می‌شوند.
مقدار \fB0\fP به کتابخانه هوک RADIUS دستور می‌دهد تا از همان تعداد ریسه‌های
استفاده‌شده برای پردازش هسته DHCP استفاده کند. این مقدار تنها در صورتی
اهمیت دارد که هسته Kea به صورت چندریسه‌ای پیکربندی شده باشد؛ یک هسته تک‌ریسه‌ای
Kea منجر به پردازش تک‌ریسه‌ای RADIUS خواهد شد.
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.IP \(bu 2
\fBtimeout\fP (پیش‌فرض \fB10\fP) \- تعداد ثانیه‌هایی است که طی آن برای
یک پاسخ انتظار کشیده می‌شود.
.IP \(bu 2
\fBuse\-message\-authenticator\fP (پیش‌فرض \fBtrue\fP هنگامی که پروتکل
\fBTLS\fP نیست) \- یک صفت Message\-Authenticator به تمامی پیام‌های ارسالی اضافه می‌کند
و وجود آن را در تمامی پیام‌های دریافتی الزامی می‌سازد. این می‌تواند به عنوان یک
راهکار کاهش موقت در برابر آسیب‌پذیری BLAST استفاده شود، اما تنها با نسخه‌های
اخیر کارسازهای RADIUS کار می‌کند که می‌توان آن‌ها را طوری پیکربندی کرد که این صفت
را در تمام پاسخ‌ها قرار دهند.
.UNINDENT
.sp
دو سرویس پشتیبانی می‌شوند:
.INDENT 0.0
.IP \(bu 2
\fBaccess\fP \- سرویس مجوزدهی.
.IP \(bu 2
\fBaccounting\fP \- سرویس حسابرسی.
.UNINDENT
.sp
در سطح سرویس، سه بخش قابل پیکربندی است:
.INDENT 0.0
.IP \(bu 2
کارسازهایی که سرویس‌های RADIUS را که انتظار می‌رود کتابخانه با آن‌ها
ارتباط برقرار کند تعریف می‌کنند. برای هر کارساز می‌توان موارد زیر را مشخص کرد:
.INDENT 2.0
.IP \(bu 2
\fBname\fP \- نشانی IP کارساز را مشخص می‌کند. می‌توان از یک نام دامنه
استفاده کرد که در زمان بارگذاری کتابخانه هوک تحلیل خواهد شد.
.IP \(bu 2
\fBport\fP \- پورت UDP کارساز را مشخص می‌کند. به صورت پیش‌فرض، 1812
برای دسترسی و 1813 برای حسابرسی است.
.IP \(bu 2
\fBsecret\fP \- پیام‌ها را اصالت‌سنجی می‌کند.
.IP \(bu 2
\fBtrust\-anchor\fP \- از نسخه Kea 3.1.6، نام فایل یا دایرکتوری‌ای را
مشخص می‌کند که گواهی مرجع صدور گواهی (CA) در آن یافت می‌شود.
همراه با پروتکل TLS الزامی است و در غیر این صورت نادیده گرفته می‌شود.
.IP \(bu 2
\fBcert\-file\fP \- از نسخه Kea 3.1.6، نام فایل حاوی گواهی
نهاد نهایی (end\-entity) مورد استفاده را مشخص می‌کند. همراه با پروتکل
TLS الزامی است و در غیر این صورت نادیده گرفته می‌شود.
.IP \(bu 2
\fBkey\-file\fP \- از نسخه Kea 3.1.6، کلید خصوصی گواهی
نهاد نهایی مورد استفاده را مشخص می‌کند. همراه با پروتکل TLS
الزامی است و در غیر این صورت نادیده گرفته می‌شود.
.UNINDENT
.sp
هنگامی که هیچ کارسازی مشخص نشده باشد، سرویس غیرفعال است.
.IP \(bu 2
صفت‌هایی که اطلاعات اضافی ارسالی توسط کارساز Kea به یک کارساز
RADIUS را تعریف می‌کنند. این پارامتر باید با یک نام یا نوع
شناسایی شود. مقدار آن می‌تواند به یکی از سه روش ممکن مشخص گردد:
\fBdata\fP (که یک مقدار متن ساده را تعریف می‌کند)، \fBraw\fP (که
مقدار را به صورت هگزادسیمال تعریف می‌کند)، یا \fBexpr\fP (که عبارتی را
تعریف می‌کند که برای هر بسته ورودی به طور مستقل ارزیابی می‌شود).
.INDENT 2.0.IP \(bu 2
\fBname\fP \- نام صفت است.
.IP \(bu 2
\fBtype\fP \- نوع صفت است. باید نوع یا نام مشخص شود، و صفت باید در لغت‌نامه (dictionary) تعریف شده باشد.
.IP \(bu 2
\fBdata\fP \- نخستین روش از سه روش برای مشخص کردن محتوای صفت است. این گزینه نمایش متنی محتوای صفت را مشخص می‌کند.
.IP \(bu 2
\fBraw\fP \- دومین روش از سه روش برای مشخص کردن محتوای صفت است. این گزینه محتوا را در قالب شانزده‌شانزدهی (hexadecimal) مشخص می‌کند.
.IP \(bu 2
\fBexpr\fP \- آخرین روش از سه روش برای مشخص کردن محتوای صفت است. این گزینه یک عبارت ارزیابی را روی بسته پرسمان DHCP مشخص می‌کند.
.IP \(bu 2
\fBvendor\fP \- از Kea 3.1.2 به بعد، شناسه سازنده (vendor id) صفت است. این مقدار همواره حاوی یک رشته با نام سازنده یا یک لیترال عدد صحیح است.
.UNINDENT
.INDENT 2.0
.INDENT 3.5
صفت‌ها فقط برای سرویس access پشتیبانی می‌شوند.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
صفت Vendor\-Specific را می‌توان به دو روش مشخص کرد: استفاده از یک مقدار \fBraw\fP که باید شامل سازنده و داده‌های vsa باشد؛ توجه داشته باشید که مقدار \fBdata\fP از نسخه Kea 3.1.2 دیگر پشتیبانی نمی‌شود، و مقدار \fBexpr\fP به محتوای صفت ارزیابی می‌شود. روش دوم در نسخه 3.1.2 افزوده شد و امکان مشخص کردن یک صفت سازنده را می‌دهد که به‌طور خودکار درون یک صفت Vendor\-Specific تعبیه می‌شود.
.UNINDENT
.UNINDENT
.INDENT 0.0
.IP \(bu 2
پرچم بولی \fBpeer\-updates\fP (پیش‌فرض \fBtrue\fP) مشخص می‌کند که آیا به‌روزرسانی‌های اجاره (lease) که از یک همتای فعال دسترسی‌پذیری بالا (HA) می‌آیند باید منجر به یک درخواست accounting شوند یا خیر. این امر ممکن است برای حذف موارد تکراری در صورتی که همتاهای HA برای ارسال درخواست به همان کارساز RADIUS پیکربندی شده باشند، مطلوب باشد. این پرچم تنها توسط سرویس accounting پشتیبانی می‌شود. فرایند همگام‌سازی اجاره در هنگام راه‌اندازی یک گره HA، صرف‌نظر از مقدار این پرچم، درخواست RADIUS accounting ایجاد نمی‌کند.
.IP \(bu 2
عدد صحیح مثبت \fBmax\-pending\-requests\fP (پیش‌فرض \fB0\fP) تعداد درخواست‌های معلق RADIUS را محدود می‌کند. این مقدار فقط توسط سرویس access پشتیبانی می‌شود. مقدار \fB0\fP به معنای عدم وجود محدودیت است؛ مقدار \fB64\fP یک تنظیم توصیه‌شده است.
.IP \(bu 2
عدد صحیح مثبت \fBidle\-timer\-interval\fP (پیش‌فرض \fB0\fP) فاصله زمانی بین آخرین پاسخ معتبر از کارسازها و ارسال یک پیام \fBStatus\-Server\fP را مشخص می‌کند. مقدار \fB0\fP به معنای غیرفعال کردن این سازوکار است که در نسخه Kea 3.1.5 افزوده شد.
.IP \(bu 2
از نسخه Kea 3.1.6 با پروتکل TLS، پرچم بولی \fBenabled\fP (پیش‌فرض \fBtrue\fP) امکان فعال یا غیرفعال کردن سرویس‌های \fBaccess\fP و \fBaccounting\fP را فراهم می‌کند.
.UNINDENT
.sp
برای نمونه، جهت مشخص کردن یک تک‌کارساز access موجود روی localhost که از \fB\(dq1234\(dq\fP به عنوان رمز (secret) استفاده می‌کند، و دستور به Kea برای ارسال سه صفت اضافی (\fBUser\-Password\fP، \fBConnect\-Info\fP و \fBConfiguration\-Token\fP)، قطعه‌کد زیر می‌تواند استفاده شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqparameters\(dq: {

    // Other RADIUS parameters here

    \(dqaccess\(dq: {

      // This starts the list of access servers.
      \(dqservers\(dq: [
        {
          // These are parameters for the first (and only) access server
          \(dqname\(dq: \(dq127.0.0.1\(dq,
          \(dqport\(dq: 1812,
          \(dqsecret\(dq: \(dq1234\(dq
        }
      // Additional access servers could be specified here.
      ],

      // This defines a list of additional attributes Kea will send to each
      // access server in Access\-Request.
      \(dqattributes\(dq: [
        {
          // This attribute is identified by name (must be present in the
          // dictionary) and has static value (i.e. the same value will be
          // sent to every server for every packet).
          \(dqname\(dq: \(dqUser\-Password\(dq,
          \(dqdata\(dq: \(dqmysecretpassword\(dq
        },
        {
          // It is also possible to specify an attribute using its type,
          // rather than a name. 77 is Connect\-Info. The value is specified
          // using hex. Again, this is a static value. It will be sent the
          // same for every packet and to every server.
          \(dqtype\(dq: 77,
          \(dqraw\(dq: \(dq65666a6a71\(dq
        },
        {
           // This example shows how an expression can be used to send dynamic value.
           // The expression (see Using Expressions in Classification \%<#\:classification-using-expressions>) may take any
           // value from the incoming packet or even its metadata e.g. the
           // interface it was received over from.
           \(dqname\(dq: \(dqConfiguration\-Token\(dq,
           \(dqexpr\(dq: \(dqhexstring(pkt4.mac,\(aq:\(aq)\(dq
        }
      ] // End of attributes
    }, // End of access

    // Accounting parameters.
    \(dqaccounting\(dq: {
      // This starts the list of accounting servers.
      \(dqservers\(dq: [
        {
          // These are parameters for the first (and only) accounting server
          \(dqname\(dq: \(dq127.0.0.1\(dq,
          \(dqport\(dq: 1813,
          \(dqsecret\(dq: \(dq1234\(dq
        }
        // Additional accounting servers could be specified here.
      ]
    }
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
گاهی اوقات سفارشی‌سازی برای برخی از صفت‌ها توسط دستگاه‌های متعلق به سازندگان مختلف مورد نیاز است. این یک روش عالی برای بهره‌گیری از سازوکار ارزیابی عبارت است. برای نمونه، نشانی‌های MAC که ممکن است به عنوان یک مقدار برای صفت \fBUser\-Password\fP استفاده شوند، به احتمال زیاد در قالب نمایش دونقطه\-شانزده‌شانزدهی (\fBde:ad:be:ef:ca:fe\fP) ظاهر می‌شوند، اما ممکن است لازم باشد در قالب خط‌تیره\-شانزده‌شانزدهی (\fBde\-ad\-be\-ef\-ca\-fe\fP) بیان شوند. روش مشخص کردن آن در اینجا آمده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
   \(dqparameters\(dq: {
      \(dqaccess\(dq: {
         \(dqattributes\(dq: [
            {
               \(dqname\(dq: \(dqUser\-Password\(dq,
               \(dqexpr\(dq: \(dqhexstring(pkt4.mac, \(aq\-\(aq)\(dq
            }
         ]
      }
   }
}
.EE
.UNINDENT
.UNINDENT
.sp
و در اینجا نحوه مشخص کردن نماد شانزده‌شانزدهی جداشده با نقطه (\fBdead.beef.cafe\fP) که توسط دستگاه‌های Cisco ترجیح داده می‌شود، آورده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
   \(dqparameters\(dq: {
      \(dqaccess\(dq: {
         \(dqattributes\(dq: [
            {
               \(dqname\(dq: \(dqUser\-Password\(dq,
               \(dqexpr\(dq: \(dqsubstring(hexstring(pkt4.mac, \(aq\(aq), 0, 4) + \(aq.\(aq + substring(hexstring(pkt4.mac, \(aq\(aq), 4, 4) + \(aq.\(aq + substring(hexstring(pkt4.mac, \(aq\(aq), 8, 4)\(dq
            }
         ]
      }
   }
}
.EE
.UNINDENT
.UNINDENT
.sp
برای اینکه سرویس access در \fBlibdhcp_radius.so\fP \%<#\:std-ischooklib-libdhcp_radius\:.so> به درستی کار کند، \fBlibdhcp_host_cache.so\fP \%<#\:std-ischooklib-libdhcp_host_cache\:.so> نیز باید بارگذاری شود. دلیل این امر تا حدی پیچیده است. در یک استقرار معمولی، کلاینت‌های DHCP بسته‌های خود را از طریق DHCP relay ارسال می‌کنند، که گزینه‌های مشخصی از Relay Agent Information را درج می‌کند، مانند \fBcircuit\-id\fP یا \fBremote\-id\fP\&. سپس مقادیر آن گزینه‌ها توسط کارساز Kea DHCP برای فرمول‌بندی صفت‌های لازم در پیام Access\-Request ارسال‌شده به کارساز RADIUS استفاده می‌شوند. با این حال، هنگامی که کلاینت DHCP نشانی خود را دریافت کرد، با ارسال مستقیم بسته‌ها به کارساز DHCP آن را تمدید می‌کند. رله‌ها در آن مرحله نمی‌توانند گزینه‌های RAI خود را درج کنند، و کارساز DHCP نمی‌تواند تنها با استفاده از اطلاعات بسته‌های دریافتی، پرسمان‌های Access\-Request را به کارساز RADIUS ارسال کند. Kea باید اطلاعات دریافت شده در تبادلات اولیه Discover/Offer را نگه دارد و بعداً هنگام ارسال پیام‌های accounting دوباره از آن‌ها استفاده کند.
.sp
این سازوکار بر اساس بافت کاربر (user context) در رزروهای میزبان پیاده‌سازی شده است. (برای جزئیات بیشتر به Comments and User Context \%<#\:user-context> و User Contexts in Hooks \%<#\:user-context-hooks> مراجعه کنید.) سازوکار host\-cache امکان ذخیره و استفاده مجدد از اطلاعات دریافت‌شده توسط RADIUS را فراهم می‌کند، به جای اینکه یک رفت‌وبرگشت احراز هویت دیگر به کارساز RADIUS انجام شود. به عبارت دیگر، سازوکار host\-cache برای سرویس access الزامی است. اگر \fBlibdhcp_host_cache.so\fP \%<#\:std-ischooklib-libdhcp_host_cache\:.so> در کنار \fBlibdhcp_radius.so\fP \%<#\:std-ischooklib-libdhcp_radius\:.so> بارگذاری نشود، پیکربندی Kea رد می‌شود.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
در حال حاضر کتابخانه قلاب RADIUS با پارامتر سراسری \fBearly\-global\-reservations\-lookup\fP ناسازگار است؛ به این معنی که تنظیم این پارامتر روی \fBtrue\fP هنگام بارگذاری کتابخانه قلاب، خطایی ایجاد می‌کند.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
در حال حاضر کتابخانه قلاب RADIUS با شبکه‌های اشتراکی چندزیرشبکه‌ای که دارای رزرو میزبان غیرسراسری هستند ناسازگار است. بارگذاری کتابخانه قلاب RADIUS در یک کارساز Kea DHCP که دارای چنین پیکربندی‌ای باشد، خطایی ایجاد می‌کند.
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
در حال حاضر پارامترهای \fBreselect\-subnet\-address\fP و \fBreselect\-subnet\-pool\fP با پیکربندی hub\-and\-spoke در \fBlibdhcp_ha.so\fP \%<#\:std-ischooklib-libdhcp_ha\:.so> ناسازگار هستند. این کتابخانه قلاب از یک زیرشبکه انتخاب‌شده اولیه برای تعیین رابطه HA جهت پردازش بسته استفاده می‌کند. انتخاب مجدد زیرشبکه ممکن است با این انتخاب تداخل پیدا کند. برای جزئیات به Hub and Spoke Configuration \%<#\:ha-hub-and-spoke> مراجعه کنید.
.UNINDENT
.UNINDENT.SS "پیکربندی RADIUS/TLS"
.sp
در Kea 3.1.6 پشتیبانی از RADIUS/TLS با اعمال تغییراتی در
پیکربندی ارائه شده است، عمدتاً به این دلیل که در TLS از یک اتصال اشتراکی
استفاده می‌شود (در برابر درگاه‌های مختلف UDP).
.INDENT 0.0
.IP \(bu 2
پارامتر جدید \fBprotocol\fP باید روی \fBTLS\fP تنظیم شود\&.
.IP \(bu 2
یک مدخل سرویس جدید به نام \fBtls\fP باید برای تعریف
پارامترهای \fBservers\fP و \fBidle\-timer\-interval\fP استفاده شود.
.IP \(bu 2
این پارامترها دیگر در مدخل‌های سرویس \fBaccess\(ga و \(ga\(gaaccounting\fP
مجاز نیستند.
.IP \(bu 2
از آنجا که مدخل \fBservers\fP وجود ندارد، سرویس‌های \fBaccess\fP و \fBaccounting\fP
می‌توانند با تنظیم پرچم \fBenabled\fP روی \fBfalse\fP غیرفعال شوند\&.
.IP \(bu 2
مدخل‌های سرور برای تنظیم پارامترهای TLS شامل \fBtrust\-anchor\fP، \fBcert\-file\fP
و \fBkey\-file\fP الزامی هستند.
.IP \(bu 2
درگاه سرور پیش‌فرض (و یکتا) \fB2083\fP است\&.
.IP \(bu 2
مدخل \fBsecret\fP دیگر الزامی نیست و مقدار پیش‌فرض آن \fBradsec\fP است\&.
.UNINDENT
.sp
برای نمونه، پیکربندی یک تک‌سرور access با RADIUS/TLS به این صورت درمی‌آید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqparameters\(dq: {

    // Set the protocol to TLS (default is UDP).
    \(dqprotocol\(dq: \(dqTLS\(dq,

    // Other RADIUS parameters here

    // Access parameters.
    \(dqaccess\(dq: {

      // This defines a list of additional attributes Kea will send to each
      // access server in Access\-Request.
      \(dqattributes\(dq: [
        {
          // This attribute is identified by name (must be present in the
          // dictionary) and has static value (i.e. the same value will be
          // sent to every server for every packet).
          \(dqname\(dq: \(dqUser\-Password\(dq,
          \(dqdata\(dq: \(dqmysecretpassword\(dq
        }
      ] // End of attributes
    }, // End of access

    // Accounting parameters.
    \(dqaccounting\(dq: {

      // Disabling this service.
      \(dqenabled\(dq: false
    }, // End of accounting

    // TLS parameters.
    \(dqtls\(dq: {

      // This starts the list of servers.
      \(dqservers\(dq: [
        {
          \(dqname\(dq: \(dq127.0.0.1\(dq,
          \(dqport\(dq: 2083,
          \(dqsecret\(dq: \(dqradsec\(dq,
          \(dqtrust\-anchor\(dq: \(dq/usr/lib/kea/CA.pem\(dq,
          \(dqcert\-file\(dq: \(dq/usr/lib/kea/server_cert.pem\(dq,
          \(dqkey\-file\(dq: \(dq/usr/lib/kea/server_key.pem\(dq
        }
      ]
    }
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
در حال حاضر تنها نخستین سرور پیکربندی‌شده استفاده می‌شود. پارامترهای \fBretries\fP و
\fBdeadtime\fP بدون هیچ هشداری نادیده گرفته می‌شوند. به‌دلیل برخی محدودیت‌ها در
پیاده‌سازی کلاینت TCP، نشانی محلی را نمی‌توان تنظیم کرد (یعنی
تنظیم پارامتر \fBbindaddr\fP نادیده گرفته می‌شود)، و درخواست‌ها
پایپ‌لاین (pipelined) نمی‌شوند؛ بدین معنی که پیش از ارسال درخواستی دیگر بر روی
همان اتصال، باید منتظر پاسخ ماند. زمانی که چندریسمانی (multi\-threading) فعال باشد، چندین
اتصال (تا سقف تعداد ریسمان‌ها) را می‌توان به‌طور موازی باز کرد.
.UNINDENT
.UNINDENT
.SS "نمونه راه‌اندازی سرور RADIUS"
.sp
کتابخانه قلاب (hook) RADIUS برای کارکرد به حداقل یک سرور RADIUS نیاز دارد. یکی
از پیاده‌سازی‌های متن‌باز و محبوب FreeRADIUS است؛ در اینجا نحوه
راه‌اندازی آن برای فعال‌سازی قابلیت‌های پایه‌ای در Kea آمده است.
.INDENT 0.0
.IP 1. 3
نرم‌افزار FreeRADIUS را از طریق مدیر بسته یا از پرونده‌های tarball موجود
در [صفحه بارگیری freeradius.org](\%<https://\:freeradius\:.org/\:releases>) نصب کنید.
.IP 2. 3
شاخه پیکربندی FreeRADIUS را مشخص کنید. این شاخه معمولاً
\fB/etc/freeradius\fP است، اما ممکن است \fB/etc/raddb\fP نیز باشد\&.
.IP 3. 3
گواهی‌ها را ایجاد کنید. به مسیر \fB/etc/freeradius/certs\fP بروید\&.
دستور \fB\&./bootstrap\fP یا \fBmake\fP را اجرا کنید\&.
تا پایان کار منتظر بمانید. این فرآیند باید چند ثانیه طول بکشد.
.IP 4. 3
بررسی کنید که سرور قادر به اجرا شدن باشد.
اجرا با پرچم \fB\-X\fP روشی مناسب برای نمایش خطاهای احتمالی است.
بسته به این که کدام دستور موجود است، \fBradiusd \-X\fP یا \fBfreeradius \-X\fP را اجرا کنید.
در سطر پایانی باید عبارت \fBReady to process requests\fP نمایش داده شود.
.IP 5. 3
اگر سرور DHCP در Kea و سرور RADIUS بر روی ماشین‌های جداگانه‌ای قرار دارند،
فایل \fB/etc/freeradius/clients.conf\fP را با نشانی مناسب ذیل
\fBipadddr\fP ویرایش کنید\&. این فایل همچنین مکانی است که رمز (secret) در آن تنظیم می‌شود؛ این مقدار
باید با آنچه در پیکربندی کتابخانه قلاب تنظیم شده مطابقت داشته باشد.
.IP 6. 3
اگر از RADIUS برای احراز مجوز کلاینت‌های DHCP استفاده می‌شود، هر
کلاینت DHCP باید یک مدخل در فایل authorize داشته باشد که معمولاً
در مسیرهای زیر یافت می‌شود:
.INDENT 3.0
.IP \(bu 2
\fB/etc/raddb/mods\-config/files/authorize\fP
.IP \(bu 2
\fB/etc/freeradius/3.0/mods\-config/files/authorize\fP
.IP \(bu 2
\fB/etc/freeradius/users\fP (برای سری RADIUS 2.x)
.UNINDENT
.sp
گذرواژه‌های این مدخل‌ها باید با گذرواژه‌های موجود
در پیکربندی کتابخانه قلاب RADIUS تحت مشخصه
\fBUser\-Password\fP مطابقت داشته باشد. هر مدخل می‌تواند دارای صفر یا چند
مشخصه باشد.
.sp
در مثال زیر، شش مدخل وجود دارد که گذرواژه آن‌ها بر روی شناسه کلاینت
تنظیم شده است؛ این مقدار باید به‌صورت پویا در پیکربندی کتابخانه قلاب
تنظیم شود. شکل مدخل‌ها ممکن است به این صورت باشد:
.INDENT 3.0
.INDENT 3.5
.sp
.EX
01:00:0c:01:02:03:04    Cleartext\-password := \(dq00:0c:01:02:03:04\(dq

01:00:0c:01:02:03:05    Cleartext\-password := \(dq00:0c:01:02:03:05\(dq
    Framed\-IP\-Address = \(dq192.0.2.5\(dq

01:00:0c:01:02:03:06    Cleartext\-password := \(dq00:0c:01:02:03:06\(dq
    Framed\-IP\-Address = \(dq192.0.2.6\(dq,
    Framed\-Pool = \(dqclassical\(dq

00:03:00:01:00:0c:01:02:03:07    Cleartext\-password := \(dq00:0c:01:02:03:07\(dq

00:03:00:01:00:0c:01:02:03:08    Cleartext\-password := \(dq00:0c:01:02:03:08\(dq
    Framed\-IPv6\-Address = \(dq2001:db8::8\(dq

00:03:00:01:00:0c:01:02:03:09    Cleartext\-password := \(dq00:0c:01:02:03:09\(dq
    Framed\-IPv6\-Address = \(dq2001:db8::9\(dq,
    Framed\-Pool = \(dqclassroom\(dq
.EE
.UNINDENT
.UNINDENT
.IP 7. 3
نیازی به تغییر accounting برای کار با Kea نیست، اما امکان اعمال سفارشی‌سازی‌ها
در فایل accounting وجود دارد، فایلی که معمولاً در مسیرهای زیر یافت می‌شود:
.INDENT 3.0
.IP \(bu 2
\fB/etc/radius\-config/mods\-config/files/accounting\fP
.IP \(bu 2
\fB/etc/freeradius/3.0/mods\-config/files/accounting\fP
.UNINDENT
.IP 8. 3
هنگامی که RADIUS/TLS استفاده می‌شود، بهتر است اعتبارنامه‌های TLS
را به هویت کلاینت مقید (bind) کنید. این کار با استفاده از عبارت زیر امکان‌پذیر است:
.INDENT 3.0
.INDENT 3.5
.sp
.EX
check_cert_cn = %{User\-Name}
.EE
.UNINDENT
.UNINDENT
.sp
که Common Name مربوط به موضوع (subject) گواهی کلاینت TLS (یعنی Kea)
را با User\-Name در RADIUS مطابقت می‌دهد.
.UNINDENT.SS جریان‌های کاری RADIUS برای تخصیص اجاره (Lease Allocation)
.sp
نمودارهای زیر نمای کلی سطح بالایی از نحوه کمک RADIUS به فرایند تخصیص اجاره در \fBkea\-dhcp4\fP \%<#\:std-iscman-kea-dhcp4> و \fBkea\-dhcp6\fP \%<#\:std-iscman-kea-dhcp6>\& را نشان می‌دهند.
.INDENT 0.0
.INDENT 2.5
[تصویر]
.UNINDENT
.UNINDENT
.sp
مورد فراخوانی (callout) \fBcommand_processed\fP که تا حدودی خارج از مبحث تخصیص اجاره است و در نمودارهای بالا نشان داده نشده است، هنگام دریافت یک فرمان اجاره (lease command)، پیام‌های Accounting\-Request را ارسال می‌کند.
.SS محدودیت Parked\-Packet
.sp
برای آشنایی اولیه با نگه‌داری بسته (packet parking)، به Parked\-Packet Limit \%<#\:parked-packet-limit> مراجعه کنید.
.sp
کتابخانه هوک (hook) RADIUS از این سازوکار استفاده می‌کند. برای فراهم کردن امکان ارتباط ناهمگام (asynchronous) میان Kea و سرور RADIUS و پردازش هم‌روند بسته‌های DHCP توسط سرور Kea، پیش از ارسال درخواست دسترسی (access request) در فراخوانیِ subnet select، درخواست DHCP متوقف (park) می‌شود. زمانی که پاسخ دسترسی در دسترس سرور DHCP Kea قرار گرفت، درخواست از حالت توقف خارج شده (unparked) و سرور به پردازش آن ادامه می‌دهد.
.SS تفاوت‌های میان کتابخانه‌های هوک RADIUS پیش از Kea 2.4.0 و از نسخه 2.6.0 به بعد
.sp
کتابخانه هوک RADIUS در نسخه 2.4.0 و نسخه‌های پیشین برای کارکرد خود به کتابخانه کلاینت FreeRADIUS متکی بود. از نسخه 2.6.0 به بعد، کتابخانه هوک RADIUS مستقل است و پیاده‌سازی کلاینت RADIUS و دیکشنری RADIUS اختصاصی خود را دارد. تفاوت‌ها عبارتند از:
.TS
box center;
l|l|l.
T{
ویژگی
T}	T{
قدیمی
T}	T{
جدید
T}
_
T{
پشتیبانی از انواع داده مشخصه (Attribute)
T}	T{
string, ipaddr, ipv4prefix, integer, integer64, date, ifid, ipv6addr, ipv6prefix, tlv, abinary, byte, ether, short, signed, octets
T}	T{
string (می‌تواند هر نوع داده پشتیبانی‌نشده دیگر را نیز شبیه‌سازی کند)، ipaddr، integer، date (به عنوان integer تفسیر می‌شود)، ipv6addr، ipv6prefix
T}
_
T{
نام‌های مشخصه‌های استاندارد
T}	T{
گرفته‌شده از دیکشنری FreeRADIUS.
T}	T{
گرفته‌شده از دیکشنری RADIUS در Kea و رجیستری IANA. یک سازوکار نام مستعار (aliasing) در کتابخانه تعبیه شده است که سازگاری رو به عقب را تضمین می‌کند؛ برای نمونه \fBPassword\fP به نام استاندارد مشخصه \fBUser\-Password\fP ترجمه می‌شود.\&
T}
_
T{
تفکیک نام دامنه سرورهای RADIUS
T}	T{
در زمان اجرا (run time).
T}	T{
در زمان بارگذاری کتابخانه هوک.
T}
_
T{
استنتاج خودکار آدرس مبدأ برای دسترسی به سرورهای RADIUS (پیکربندی‌شده با \fBbindaddr: \(dq*\(dq\fP)
T}	T{
در زمان اجرا (run time).
T}	T{
در زمان بارگذاری کتابخانه هوک.
T}
_
T{
محدودیت سرور RADIUS به ازای هر سرویس
T}	T{
8
T}	T{
نامحدود
T}
_
T{
پشتیبانی از گنجاندن دیکشنری‌ها درون دیکشنری‌ها
T}	T{
بله
T}	T{
از Kea 3.1.2 به بعد
T}
_
T{
پشتیبانی از مشخصه‌های فروشنده (Vendor Attributes)
T}	T{
بله
T}	T{
از Kea 3.1.2 به بعد
T}
_
T{
نام‌ها و مقادیر مشخصه‌ها
T}	T{
غیرحساس به حروف کوچک و بزرگ
T}	T{
حساس به حروف کوچک و بزرگ
T}
_
T{
مقادیر عدد صحیح (Integer)
T}	T{
نیازی به تعریف مشخصه ندارند.
T}	T{
باید تعریف مشخصه مرتبط در دیکشنری داشته باشند.
T}
_
T{
فضاهای نام مشخصه و مقدار عددی
T}	T{
فضاهای نام مسطح (flat) که مقادیر تکراری را مجاز می‌دانند.
T}	T{
از Kea 3.1.2 به بعد فضاهای نام مجزا به ازای هر فروشنده (vendor).
T}
_
T{
حضور Reply\-Message در لاگ‌های Kea
T}	T{
فقط به عنوان بخشی از فهرست تجمیعی مشخصه‌ها در پیام‌های لاگ \fBRADIUS_AUTHENTICATION_ACCEPTED\fP، \fBRADIUS_ACCESS_CACHE_INSERT\fP و \fBRADIUS_ACCESS_CACHE_GET\fP.
T}	T{
همچنین دارای یک پیام اختصاصی \fBRADIUS_REPLY_MESSAGE_ATTRIBUTE\fP به ازای هر مشخصه Reply\-Message است که پس از دریافت پاسخ معتبر RADIUS ثبت می‌شود.
T}
_
T{
رفتار در مواجهه با چندین مشخصه از یک نوع (به جز Reply\-Message)
T}	T{
به صورت تجربی، تنها \fBنخستین\fP مشخصه روی سیم (on the wire) از یک پیام Access\-Accept در نظر گرفته می‌شود.
T}	T{
به صورت تجربی، تنها \fBآخرین\fP مشخصه روی سیم (on the wire) از یک پیام Access\-Accept در نظر گرفته می‌شود.
T}
.TE.SS استانداردهای RADIUS پشتیبانی‌شده
.sp
پروتکل Remote Authentication Dial In User Service (RADIUS) در RFC 2865 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc2865>\& مشخص شده است.
.sp
بخش RADIUS Accounting در RFC 2866 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc2866>\& مشخص شده است.
.sp
صفت Message\-Authenticator در افزونه EAP در RFC 3579 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc3579>\& مشخص شده است.
.sp
پیام Status\-Server در RFC 5997 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc5997>\& مشخص شده است.
.sp
انتقال TCP (پشتیبانی‌نشده، اما برای TLS ارجاع فراوانی به آن داده شده است) در RFC 6613 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc6613>\& مشخص شده است.
.sp
انتقال TLS (شناخته‌شده با عنوان RADIUS/TLS یا \fBradsec\fP) در RFC 6614 \%<https://\:datatracker\:.ietf\:.org/\:doc/\:html/\:rfc6614>\& مشخص شده است.
.SH "پایش KEA با STORK (MONITORING KEA WITH STORK)"
.sp
بیشتر مدیران سیستم تمایل دارند بتوانند سرویس‌های Kea در حال اجرا را پایش کنند. Kea اطلاعات بسیار متنوعی ارائه می‌دهد \- فایل‌های پیکربندی، API، آمارها، گزارش‌ها (logs)، محتوای پایگاه داده باز و موارد دیگر \- به‌گونه‌ای که دنبال کردن همه‌ی آن‌ها گاهی ممکن است دشوار باشد. پروژه Stork متعلق به ISC با هدف رفع این مشکل برای هر دو نرم‌افزار Kea و BIND 9 طراحی شده است. Stork از جنبه‌های گوناگونی سودمند است:
.INDENT 0.0
.IP \(bu 2
ابزار Stork می‌تواند به‌عنوان داشبورد استفاده شود. این ابزار دید عمیقی از آنچه دقیقاً در سرورها رخ می‌دهد فراهم می‌آورد. به‌ویژه، به کاربران امکان می‌دهد: جزئیات به‌روز مربوط به بهره‌برداری از pool در زیرشبکه‌ها و شبکه‌های اشتراکی (shared networks) را مشاهده کنند؛ وضعیت جفت HA را پایش نمایند (و در صورت بروز رخدادهای تغییر وضعیت خرابی (failover) و بازیابی، اطلاعات بیشتری فراهم کند)؛ رزروهای میزبان (host reservations) خاص را فهرست، پالایش و جستجو کنند؛ و موارد بیشتر. فقط کافی است یک سرور واحد Stork و بر روی هر ماشینی که باید پایش شود یک Stork agent مستقر گردد.
.IP \(bu 2
عامل Stork می‌تواند Kea را با Prometheus و Grafana یکپارچه‌سازی کند. به‌محض فعال شدن Stork agent در سرور، به‌عنوان یک صادرکننده Prometheus (Prometheus exporter) عمل می‌کند. کاربرانی که Prometheus را در شبکه‌های خود مستقر کرده‌اند می‌توانند آمارها را به‌صورت سری زمانی با استفاده از Grafana بصری‌سازی کنند.
.IP \(bu 2
ابزار Stork می‌تواند هم به‌عنوان داشبورد و هم به‌عنوان یکپارچه‌ساز برای Prometheus/Grafana عمل کند. پس از اتصال Stork به محل استقرار Grafana در شبکه، کاربران می‌توانند وضعیت فعلی را بررسی کرده و با باز کردن پیوند سفارشی در Grafana، رفتار یک مشخصه خاص را در گذر زمان مشاهده نمایند.
.UNINDENT
.sp
ابزار Stork هم به‌صورت کد منبع و هم در قالب بسته‌های بومی deb و RPM در دسترس است که نصب آن را روی اکثر سیستم‌های متداول آسان می‌سازد. برای جزئیات بیشتر، لطفاً به راهنمای مرجع Stork ARM \%<https://\:stork\:.readthedocs\:.io> یا صفحه پروژه Stork \%<https://\:gitlab\:.isc\:.org/\:isc-projects/\:stork>\& مراجعه کنید. سند ARM مجموعه‌ای مناسب از نماگرفت‌ها دارد که مکرراً به‌روزرسانی می‌شود تا تصویری از آنچه اکنون در دسترس است به کاربران ارائه دهد. Stork در میانه فرایند توسعه همه‌جانبه با انتشارهای ماهانه است، بنابراین پیشنهاد می‌شود مرتباً آن را بررسی کنید.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
ابزار Stork از فراخوانی‌های Kea API از قلاب‌های \fBlibdhcp_host_cmds.so\fP \%<#\:std-ischooklib-libdhcp_host_cmds\:.so> و \fBlibdhcp_subnet_cmds.so\fP \%<#\:std-ischooklib-libdhcp_subnet_cmds\:.so> برای اعمال تغییرات در پیکربندی Kea استفاده می‌کند. چنین استفاده‌ای با Kea Configuration Backend \%<#\:config-backend> (CB) ناسازگار است. در حال حاضر Stork پشتیبانی از \fBlibdhcp_cb_cmds.so\fP \%<#\:std-ischooklib-libdhcp_cb_cmds\:.so> را که برای اعمال تغییرات در پیکربندی CB مورد نیاز است، پیاده‌سازی نکرده است. در صورت استفاده از Kea CB، ابزار Stork را تنها می‌توان با اطمینان در حالت \(dqread\-only\(dq (فقط‌خواندنی) به کار برد. پشتیبانی از CB برای نسخه‌های آتی Stork برنامه‌ریزی شده است.
.UNINDENT
.UNINDENT
.SS آمارهای Kea در Grafana
.sp
پروژه ISC Stork عاملی را ارائه می‌دهد که می‌تواند در کنار Kea مستقر شود. این عامل آمارهای Kea را در قالبی که توسط Prometheus پذیرفته می‌شود ارائه می‌دهد. یکی از مزایای عمده Prometheus این است که مشاهدات تکرارشونده یک‌باره را به سری‌های زمانی تبدیل می‌کند؛ امری که به کاربران امکان می‌دهد تغییرات رفتارهای مشخص را در گذر زمان پایش کنند. استفاده از سایر ابزارها برای بصری‌سازی داده‌های موجود در Prometheus آسان است؛ متداول‌ترین رویکرد، استفاده از Grafana جهت ارائه داشبوردهای بصری است. پروژه Stork تعاریف داشبوردی را برای Kea ارائه می‌کند که به‌سادگی در Grafana قابل درون‌ریزی است.
.sp
درباره Prometheus و Grafana در وب‌سایت‌های آن‌ها بیشتر بیاموزید: \fIPrometheus <https://prometheus.io>\fP و \fIGrafana <https://grafana.com>\fP\&.
.SH "مرجع API (API REFERENCE)"
.sp
در حال حاضر Kea از ۲۱۹ دستور در دیمن‌های kea\-dhcp\-ddns، kea\-dhcp4 و kea\-dhcp6 و کتابخانه‌های قلاب cb_cmds، class_cmds، gss_tsig، high_availability، host_cache، host_cmds، lease_cmds، lease_query، perfmon، stat_cmds و subnet_cmds پشتیبانی می‌کند.
.sp
دستورهای پشتیبانی‌شده توسط دیمن \fIkea\-dhcp\-ddns\fP: build\-report, config\-get, config\-hash\-get, config\-reload, config\-set, config\-test, config\-write, gss\-tsig\-get, gss\-tsig\-get\-all, gss\-tsig\-key\-del, gss\-tsig\-key\-expire, gss\-tsig\-key\-get, gss\-tsig\-list, gss\-tsig\-purge, gss\-tsig\-purge\-all, gss\-tsig\-rekey, gss\-tsig\-rekey\-all, list\-commands, shutdown, statistic\-get, statistic\-get\-all, statistic\-reset, statistic\-reset\-all, status\-get, version\-get\&.
.sp
دستورهای پشتیبانی‌شده توسط دیمن \fIkea\-dhcp4\fP: build\-report, cache\-clear, cache\-flush, cache\-get, cache\-get\-by\-id, cache\-insert, cache\-load, cache\-remove, cache\-size, cache\-write, class\-add, class\-del, class\-get, class\-list, class\-update, config\-backend\-pull, config\-get, config\-hash\-get, config\-reload, config\-set, config\-test, config\-write, dhcp\-disable, dhcp\-enable, extended\-info4\-upgrade, ha\-continue, ha\-heartbeat, ha\-maintenance\-cancel, ha\-maintenance\-notify, ha\-maintenance\-start, ha\-reset, ha\-scopes, ha\-sync, ha\-sync\-complete\-notify, interface\-add, interface\-list, interface\-redetect, kea\-lfc\-start, lease4\-add, lease4\-del, lease4\-get, lease4\-get\-all, lease4\-get\-by\-client\-id, lease4\-get\-by\-hostname, lease4\-get\-by\-hw\-address, lease4\-get\-by\-state, lease4\-get\-page, lease4\-resend\-ddns, lease4\-update, lease4\-wipe, lease4\-write, leases\-reclaim, list\-commands, network4\-add, network4\-del, network4\-get, network4\-list, network4\-subnet\-add, network4\-subnet\-del, perfmon\-control, perfmon\-get\-all\-durations, remote\-class4\-del, remote\-class4\-get, remote\-class4\-get\-all, remote\-class4\-set, remote\-global\-parameter4\-del, remote\-global\-parameter4\-get, remote\-global\-parameter4\-get\-all, remote\-global\-parameter4\-set, remote\-network4\-del, remote\-network4\-get, remote\-network4\-list, remote\-network4\-set, remote\-option\-def4\-del, remote\-option\-def4\-get, remote\-option\-def4\-get\-all, remote\-option\-def4\-set, remote\-option4\-global\-del, remote\-option4\-global\-get, remote\-option4\-global\-get\-all, remote\-option4\-global\-set, remote\-option4\-network\-del, remote\-option4\-network\-set, remote\-option4\-pool\-del, remote\-option4\-pool\-set, remote\-option4\-subnet\-del, remote\-option4\-subnet\-set, remote\-server4\-del, remote\-server4\-get, remote\-server4\-get\-all, remote\-server4\-set, remote\-subnet4\-del\-by\-id, remote\-subnet4\-del\-by\-prefix, remote\-subnet4\-get\-by\-id, remote\-subnet4\-get\-by\-prefix, remote\-subnet4\-list, remote\-subnet4\-set, reservation\-add, reservation\-del, reservation\-get, reservation\-get\-all, reservation\-get\-by\-address, reservation\-get\-by\-hostname, reservation\-get\-by\-id, reservation\-get\-page, reservation\-update, server\-tag\-get, sflq\-pool4\-del, sflq\-pool4\-get\-all, sflq\-pool4\-get\-by\-range, sflq\-pool4\-get\-by\-subnet, sflq\-pool4\-rebuild, sflq\-pool6\-del, sflq\-pool6\-get\-all, sflq\-pool6\-get\-by\-range, sflq\-pool6\-get\-by\-subnet, sflq\-pool6\-rebuild, shutdown, stat\-lease4\-get, statistic\-get, statistic\-get\-all, statistic\-global\-get\-all, statistic\-remove, statistic\-remove\-all, statistic\-reset, statistic\-reset\-all, statistic\-sample\-age\-set, statistic\-sample\-age\-set\-all, statistic\-sample\-count\-set, statistic\-sample\-count\-set\-all, status\-get, subnet4\-add, subnet4\-del, subnet4\-delta\-add, subnet4\-delta\-del, subnet4\-get, subnet4\-list, subnet4\-select\-test, subnet4\-update, subnet4o6\-select\-test, version\-get\&.
.sp
دستورهای پشتیبانی‌شده توسط دیمن \fIkea\-dhcp6\fP: build\-report, cache\-clear, cache\-flush, cache\-get, cache\-get\-by\-id, cache\-insert, cache\-load, cache\-remove, cache\-size, cache\-write, class\-add, class\-del, class\-get, class\-list, class\-update, config\-backend\-pull, config\-get, config\-hash\-get, config\-reload, config\-set, config\-test, config\-write, dhcp\-disable, dhcp\-enable, extended\-info6\-upgrade, ha\-continue, ha\-heartbeat, ha\-maintenance\-cancel, ha\-maintenance\-notify, ha\-maintenance\-start, ha\-reset, ha\-scopes, ha\-sync, ha\-sync\-complete\-notify, interface\-add, interface\-list, interface\-redetect, kea\-lfc\-start, lease6\-add, lease6\-bulk\-apply, lease6\-del, lease6\-get, lease6\-get\-all, lease6\-get\-by\-duid, lease6\-get\-by\-hostname, lease6\-get\-by\-hw\-address, lease6\-get\-by\-state, lease6\-get\-page, lease6\-resend\-ddns, lease6\-update, lease6\-wipe, lease6\-write, leases\-reclaim, list\-commands, network6\-add, network6\-del, network6\-get, network6\-list, network6\-subnet\-add, network6\-subnet\-del, perfmon\-control, perfmon\-get\-all\-durations, remote\-class6\-del, remote\-class6\-get, remote\-class6\-get\-all, remote\-class6\-set, remote\-global\-parameter6\-del, remote\-global\-parameter6\-get, remote\-global\-parameter6\-get\-all, remote\-global\-parameter6\-set, remote\-network6\-del, remote\-network6\-get, remote\-network6\-list, remote\-network6\-set, remote\-option\-def6\-del, remote\-option\-def6\-get, remote\-option\-def6\-get\-all, remote\-option\-def6\-set, remote\-option6\-global\-del, remote\-option6\-global\-get, remote\-option6\-global\-get\-all, remote\-option6\-global\-set, remote\-option6\-network\-del, remote\-option6\-network\-set, remote\-option6\-pd\-pool\-del, remote\-option6\-pd\-pool\-set, remote\-option6\-pool\-del, remote\-option6\-pool\-set, remote\-option6\-subnet\-del, remote\-option6\-subnet\-set, remote\-server6\-del, remote\-server6\-get, remote\-server6\-get\-all, remote\-server6\-set, remote\-subnet6\-del\-by\-id, remote\-subnet6\-del\-by\-prefix, remote\-subnet6\-get\-by\-id, remote\-subnet6\-get\-by\-prefix, remote\-subnet6\-list, remote\-subnet6\-set, reservation\-add, reservation\-del, reservation\-get, reservation\-get\-all, reservation\-get\-by\-address, reservation\-get\-by\-hostname, reservation\-get\-by\-id, reservation\-get\-page, reservation\-update, server\-tag\-get, sflq\-pool4\-del, sflq\-pool4\-get\-all, sflq\-pool4\-get\-by\-range, sflq\-pool4\-get\-by\-subnet, sflq\-pool4\-rebuild, sflq\-pool6\-del, sflq\-pool6\-get\-all, sflq\-pool6\-get\-by\-range, sflq\-pool6\-get\-by\-subnet, sflq\-pool6\-rebuild, shutdown, stat\-lease6\-get, statistic\-get, statistic\-get\-all, statistic\-global\-get\-all, statistic\-remove, statistic\-remove\-all, statistic\-reset, statistic\-reset\-all, statistic\-sample\-age\-set, statistic\-sample\-age\-set\-all, statistic\-sample\-count\-set, statistic\-sample\-count\-set\-all, status\-get, subnet6\-add, subnet6\-del, subnet6\-delta\-add, subnet6\-delta\-del, subnet6\-get, subnet6\-list, subnet6\-select\-test, subnet6\-update, version\-get\&.
.sp
دستورهای پشتیبانی‌شده توسط کتابخانه قلاب \fIcb_cmds\fP: remote\-class4\-del, remote\-class4\-get, remote\-class4\-get\-all, remote\-class4\-set, remote\-class6\-del, remote\-class6\-get, remote\-class6\-get\-all, remote\-class6\-set, remote\-global\-parameter4\-del, remote\-global\-parameter4\-get, remote\-global\-parameter4\-get\-all, remote\-global\-parameter4\-set, remote\-global\-parameter6\-del, remote\-global\-parameter6\-get, remote\-global\-parameter6\-get\-all, remote\-global\-parameter6\-set, remote\-network4\-del, remote\-network4\-get, remote\-network4\-list, remote\-network4\-set, remote\-network6\-del, remote\-network6\-get, remote\-network6\-list, remote\-network6\-set, remote\-option\-def4\-del, remote\-option\-def4\-get, remote\-option\-def4\-get\-all, remote\-option\-def4\-set, remote\-option\-def6\-del, remote\-option\-def6\-get, remote\-option\-def6\-get\-all, remote\-option\-def6\-set, remote\-option4\-global\-del, remote\-option4\-global\-get, remote\-option4\-global\-get\-all, remote\-option4\-global\-set, remote\-option4\-network\-del, remote\-option4\-network\-set, remote\-option4\-pool\-del, remote\-option4\-pool\-set, remote\-option4\-subnet\-del, remote\-option4\-subnet\-set, remote\-option6\-global\-del, remote\-option6\-global\-get, remote\-option6\-global\-get\-all, remote\-option6\-global\-set, remote\-option6\-network\-del, remote\-option6\-network\-set, remote\-option6\-pd\-pool\-del, remote\-option6\-pd\-pool\-set, remote\-option6\-pool\-del, remote\-option6\-pool\-set, remote\-option6\-subnet\-del, remote\-option6\-subnet\-set, remote\-server4\-del, remote\-server4\-get, remote\-server4\-get\-all, remote\-server4\-set, remote\-server6\-del, remote\-server6\-get, remote\-server6\-get\-all, remote\-server6\-set, remote\-subnet4\-del\-by\-id, remote\-subnet4\-del\-by\-prefix, remote\-subnet4\-get\-by\-id, remote\-subnet4\-get\-by\-prefix, remote\-subnet4\-list, remote\-subnet4\-set, remote\-subnet6\-del\-by\-id, remote\-subnet6\-del\-by\-prefix, remote\-subnet6\-get\-by\-id, remote\-subnet6\-get\-by\-prefix, remote\-subnet6\-list, remote\-subnet6\-set\&.
.sp
دستورهای پشتیبانی‌شده توسط کتابخانه قلاب \fIclass_cmds\fP: class\-add, class\-del, class\-get, class\-list, class\-update\&.
.sp
دستورهای پشتیبانی‌شده توسط کتابخانه قلاب \fIgss_tsig\fP: gss\-tsig\-get, gss\-tsig\-get\-all, gss\-tsig\-key\-del, gss\-tsig\-key\-expire, gss\-tsig\-key\-get, gss\-tsig\-list, gss\-tsig\-purge, gss\-tsig\-purge\-all, gss\-tsig\-rekey, gss\-tsig\-rekey\-all\&.
.sp
دستورهای پشتیبانی‌شده توسط کتابخانه قلاب \fIhigh_availability\fP: ha\-continue, ha\-heartbeat, ha\-maintenance\-cancel, ha\-maintenance\-notify, ha\-maintenance\-start, ha\-reset, ha\-scopes, ha\-sync, ha\-sync\-complete\-notify\&.
.sp
دستورهای پشتیبانی‌شده توسط کتابخانه قلاب \fIhost_cache\fP: cache\-clear, cache\-flush, cache\-get, cache\-get\-by\-id, cache\-insert, cache\-load, cache\-remove, cache\-size, cache\-write\&.
.sp
دستورهای پشتیبانی‌شده توسط کتابخانه قلاب \fIhost_cmds\fP: reservation\-add, reservation\-del, reservation\-get, reservation\-get\-all, reservation\-get\-by\-address, reservation\-get\-by\-hostname, reservation\-get\-by\-id, reservation\-get\-page, reservation\-update\&.
.sp
دستورهای پشتیبانی‌شده توسط کتابخانه قلاب \fIlease_cmds\fP: lease4\-add, lease4\-del, lease4\-get, lease4\-get\-all, lease4\-get\-by\-client\-id, lease4\-get\-by\-hostname, lease4\-get\-by\-hw\-address, lease4\-get\-by\-state, lease4\-get\-page, lease4\-resend\-ddns, lease4\-update, lease4\-wipe, lease4\-write, lease6\-add, lease6\-bulk\-apply, lease6\-del, lease6\-get, lease6\-get\-all, lease6\-get\-by\-duid, lease6\-get\-by\-hostname, lease6\-get\-by\-hw\-address, lease6\-get\-by\-state, lease6\-get\-page, lease6\-resend\-ddns, lease6\-update, lease6\-wipe, lease6\-write, sflq\-pool4\-del, sflq\-pool4\-get\-all, sflq\-pool4\-get\-by\-range, sflq\-pool4\-get\-by\-subnet, sflq\-pool4\-rebuild, sflq\-pool6\-del, sflq\-pool6\-get\-all, sflq\-pool6\-get\-by\-range, sflq\-pool6\-get\-by\-subnet, sflq\-pool6\-rebuild\&.
.sp
دستورهای پشتیبانی‌شده توسط کتابخانه قلاب \fIlease_query\fP: extended\-info4\-upgrade, extended\-info6\-upgrade\&.
.sp
دستورهای پشتیبانی‌شده توسط کتابخانه قلاب \fIperfmon\fP: perfmon\-control, perfmon\-get\-all\-durations\&.
.sp
دستورهای پشتیبانی‌شده توسط کتابخانه قلاب \fIstat_cmds\fP: stat\-lease4\-get, stat\-lease6\-get\&.
.sp
دستورهای پشتیبانی‌شده توسط کتابخانه قلاب \fIsubnet_cmds\fP: network4\-add, network4\-del, network4\-get, network4\-list, network4\-subnet\-add, network4\-subnet\-del, network6\-add, network6\-del, network6\-get, network6\-list, network6\-subnet\-add, network6\-subnet\-del, subnet4\-add, subnet4\-del, subnet4\-delta\-add, subnet4\-delta\-del, subnet4\-get, subnet4\-list, subnet4\-update, subnet6\-add, subnet6\-del, subnet6\-delta\-add, subnet6\-delta\-del, subnet6\-get, subnet6\-list, subnet6\-update\&.
.SS build\-report
.sp
این دستور فهرستی از گزینه‌های کامپایلی را که این فایل باینری خاص با آن‌ها ساخته شده است برمی‌گرداند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp\-ddns, kea\-dhcp4, kea\-dhcp6
.sp
در دسترس بودن: 1.2.0 (توکار)
.sp
سطح دسترسی: read \fI(پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور build\-report را ببینید \%<#\:command-build-report>
.sp
ساختار دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqbuild\-report\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
ساختار پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: <string with build details>
}
.EE
.UNINDENT
.UNINDENT.SS cache\-clear
.sp
این دستور تمام رزروهای میزبان ذخیره‌شده در کَش را حذف می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4, kea\-dhcp6
.sp
دسترس‌پذیری: 1.4.0 (کتابخانهٔ قلاب host_cache)
.sp
دسترسی: write \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور cache\-clear را ببینید \%<#\:command-cache-clear>
.sp
ساختار دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqcache\-clear\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
ساختار پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: \(dq<string>\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارت‌اند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت کامل شد، اما هیچ داده‌ای تغییر نیافت یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (conflict) (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تداخل بود)
.UNINDENT
.SS cache\-flush
.sp
این دستور تا تعداد مشخص‌شده یا تمامی رزروهای میزبان ذخیره‌شده در کَش را حذف می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4, kea\-dhcp6
.sp
دسترس‌پذیری: 1.4.0 (کتابخانهٔ قلاب host_cache)
.sp
دسترسی: write \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور cache\-flush را ببینید \%<#\:command-cache-flush>
.sp
ساختار دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqcache\-flush\(dq,
    \(dqarguments\(dq: 5
}
.EE
.UNINDENT
.UNINDENT
.sp
ساختار پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: \(dq<string>\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارت‌اند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت کامل شد، اما هیچ داده‌ای تغییر نیافت یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (conflict) (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تداخل بود)
.UNINDENT
.SS cache\-get
.sp
این دستور محتوای کامل کَش میزبان را بازمی‌گرداند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4, kea\-dhcp6
.sp
دسترس‌پذیری: 1.4.0 (کتابخانهٔ قلاب host_cache)
.sp
دسترسی: read \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور cache\-get را ببینید \%<#\:command-cache-get>
.sp
ساختار دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqcache\-get\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
ساختار پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq123 entries returned.\(dq,
    \(dqarguments\(dq: <list of host reservations>
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارت‌اند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت کامل شد، اما هیچ داده‌ای تغییر نیافت یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (conflict) (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تداخل بود)
.UNINDENT.SS cache\-get\-by\-id
.sp
این دستور مدخل‌های منطبق با شناسهٔ ارائه‌شده را از حافظهٔ پنهان میزبان (host cache) بازمی‌گرداند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4، kea\-dhcp6
.sp
دسترس‌پذیری: 1.6.0 (کتابخانهٔ قلاب host_cache)
.sp
دسترسی: read \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور cache\-get\-by\-id را ببینید \%<#\:command-cache-get-by-id>
.sp
ساختار دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqcache\-get\-by\-id\(dq,
    \(dqarguments\(dq: {
        \(dqhw\-address\(dq: \(dq01:02:03:04:05:06\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
ساختار پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq2 entries returned.\(dq,
    \(dqarguments\(dq: <list of host reservations>
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارت‌اند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت انجام شد، اما هیچ داده‌ای تغییر نیافت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (conflict) (دستور نتوانست تغییرات پیکربندی درخواست‌شده را اعمال کند زیرا با وضعیت سرور در تعارض بود)
.UNINDENT
.SS cache\-insert
.sp
این دستور یک میزبان را در حافظهٔ پنهان درج می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4، kea\-dhcp6
.sp
دسترس‌پذیری: 1.4.0 (کتابخانهٔ قلاب host_cache)
.sp
دسترسی: write \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور cache\-insert را ببینید \%<#\:command-cache-insert>
.sp
ساختار دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqcache\-insert\(dq,
    \(dqarguments\(dq: {
        \(dqhw\-address\(dq: \(dq01:02:03:04:05:06\(dq,
        \(dqsubnet\-id4\(dq: 4,
        \(dqsubnet\-id6\(dq: 0,
        \(dqip\-address\(dq: \(dq192.0.2.100\(dq,
        \(dqhostname\(dq: \(dqsomehost.example.org\(dq,
        \(dqclient\-classes4\(dq: [ ],
        \(dqclient\-classes6\(dq: [ ],
        \(dqoption\-data4\(dq: [ ],
        \(dqoption\-data6\(dq: [ ],
        \(dqnext\-server\(dq: \(dq192.0.0.2\(dq,
        \(dqserver\-hostname\(dq: \(dqserver\-hostname.example.org\(dq,
        \(dqboot\-file\-name\(dq: \(dqbootfile.efi\(dq,
        \(dqhost\-id\(dq: 0
    }
}

مثال دیگری که رزرو میزبان IPv6 را به حافظهٔ پنهان اضافه می‌کند عبارت است از:
{
    \(dqcommand\(dq: \(dqcache\-insert\(dq,
    \(dqarguments\(dq: {
        \(dqhw\-address\(dq: \(dq01:02:03:04:05:06\(dq,
        \(dqsubnet\-id4\(dq: 0,
        \(dqsubnet\-id6\(dq: 6,
        \(dqip\-addresses\(dq: [ \(dq2001:db8::cafe:babe\(dq ],
        \(dqprefixes\(dq: [ \(dq2001:db8:dead:beef::/64\(dq ],
        \(dqhostname\(dq: \(dq\(dq,
        \(dqclient\-classes4\(dq: [ ],
        \(dqclient\-classes6\(dq: [ ],
        \(dqoption\-data4\(dq: [ ],
        \(dqoption\-data6\(dq: [ ],
        \(dqnext\-server\(dq: \(dq0.0.0.0\(dq,
        \(dqserver\-hostname\(dq: \(dq\(dq,
        \(dqboot\-file\-name\(dq: \(dq\(dq,
        \(dqhost\-id\(dq: 0
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
ساختار پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: \(dq<string>\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارت‌اند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت انجام شد، اما هیچ داده‌ای تغییر نیافت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (conflict) (دستور نتوانست تغییرات پیکربندی درخواست‌شده را اعمال کند زیرا با وضعیت سرور در تعارض بود)
.UNINDENT.SS cache\-load
.sp
این دستور امکان بارگذاری محتوای یک فایل روی دیسک را در یک حافظهٔ نهان درون‌حافظه‌ای فراهم می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4، kea\-dhcp6
.sp
در دسترس از: 1.4.0 (کتابخانهٔ قلاب host_cache)
.sp
دسترسی: write \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور cache\-load را ببینید \%<#\:command-cache-load>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqcache\-load\(dq,
    \(dqarguments\(dq: \(dq/usr/local/share/kea/kea\-host\-cache.json\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: \(dq<string>\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
مقدار Result یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت به پایان رسید، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (conflict) (دستور نتوانست تغییرات پیکربندی درخواست‌شده را اعمال کند زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT
.SS cache\-remove
.sp
این دستور مدخل‌ها را از حافظهٔ نهان میزبان حذف می‌کند. این دستور پارامترهایی مشابه با دستور \fBreservation\-get\fP می‌پذیرد.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4، kea\-dhcp6
.sp
در دسترس از: 1.4.0 (کتابخانهٔ قلاب host_cache)
.sp
دسترسی: write \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور cache\-remove را ببینید \%<#\:command-cache-remove>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqcache\-remove\(dq,
    \(dqarguments\(dq: {
        \(dqip\-address\(dq: \(dq192.0.2.1\(dq,
        \(dqsubnet\-id\(dq: 123
    }
}

مثال دیگری که شناسهٔ میزبان IPv6 را بر اساس DUID و subnet\-id مشخص حذف می‌کند عبارت است از:
{
    \(dqcommand\(dq: \(dqcache\-remove\(dq,
    \(dqarguments\(dq: {
        \(dqduid\(dq: \(dq00:01:ab:cd:f0:a1:c2:d3:e4\(dq,
        \(dqsubnet\-id\(dq: 123
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: \(dq<string>\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
مقدار Result یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت به پایان رسید، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (conflict) (دستور نتوانست تغییرات پیکربندی درخواست‌شده را اعمال کند زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT
.SS cache\-size
.sp
این دستور تعداد مدخل‌های موجود در حافظهٔ نهان میزبان را برمی‌گرداند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4، kea\-dhcp6
.sp
در دسترس از: 1.6.0 (کتابخانهٔ قلاب host_cache)
.sp
دسترسی: read \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور cache\-size را ببینید \%<#\:command-cache-size>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqcache\-size\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq123 entries.\(dq,
    \(dqarguments\(dq: { \(dqsize\(dq: 123 }
}
.EE
.UNINDENT
.UNINDENT
.sp
مقدار Result یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت به پایان رسید، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (conflict) (دستور نتوانست تغییرات پیکربندی درخواست‌شده را اعمال کند زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT.SS cache\-write
.sp
این دستور به Kea فرمان می‌دهد تا محتوای حافظهٔ موقت میزبان (host cache) خود را روی دیسک بنویسد.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4، kea\-dhcp6
.sp
دسترس‌پذیری: 1.4.0 (کتابخانهٔ هوک host_cache)
.sp
دسترسی: write \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور cache\-write را ببینید \%<#\:command-cache-write>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqcache\-write\(dq,
    \(dqarguments\(dq: \(dq/path/to/the/file.json\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور یک آرگومان اجباری می‌پذیرد که مسیر نام فایلی را که باید نوشته شود مشخص می‌کند.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: \(dq<string>\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty - دستور با موفقیت به پایان رسید، اما داده‌ای تغییر نیافت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (conflict - دستور نتوانست تغییرات پیکربندی درخواست‌شده را اعمال کند زیرا با وضعیت سرور در تداخل بود)
.UNINDENT
.SS class\-add
.sp
این دستور یک کلاس جدید به پیکربندی موجود سرور اضافه می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4، kea\-dhcp6
.sp
دسترس‌پذیری: 1.5.0 (کتابخانهٔ هوک class_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور class\-add را ببینید \%<#\:command-class-add>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqclass\-add\(dq,
    \(dqarguments\(dq: {
        \(dqclient\-classes\(dq: [ {
           \(dqname\(dq: <name of the class>,
           \(dqtest\(dq: <test expression to be evaluated on incoming packets>,
           \(dqoption\-data\(dq: [ <option values here> ],
           \(dqoption\-def\(dq: [ <option definitions here> ],
           \(dqnext\-server\(dq: <ipv4 address>,
           \(dqserver\-hostname\(dq: <string>,
           \(dqboot\-file\-name\(dq: <name of the boot file>
        } ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
گزینه‌های \fBnext\-server\fP، \fBserver\-hostname\fP و \fBboot\-file\-name\fP مختص DHCPv4 هستند. تنها یک کلاس کلاینت را می‌توان با یک دستور اضافه کرد.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqClass \(aq<class\-name>\(aq added.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور موفقیت‌آمیز است (نتیجه 0)، مگر اینکه نام کلاس تکراری باشد یا خطای دیگری رخ دهد (نتیجه 1).
.SS class\-del
.sp
این دستور یک کلاس کلاینت را از پیکربندی سرور حذف می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4، kea\-dhcp6
.sp
دسترس‌پذیری: 1.5.0 (کتابخانهٔ هوک class_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور class\-del را ببینید \%<#\:command-class-del>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqclass\-del\(dq,
    \(dqarguments\(dq: {
        \(dqname\(dq: <name of the class>
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqClass \(aq<class\-name>\(aq deleted.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر کلاس کلاینت وجود نداشته باشد، دستور نتیجهٔ 3 (empty) را بازمی‌گرداند. اگر کلاس کلاینت وجود داشته باشد، در صورت موفقیت‌آمیز بودن حذف، نتیجهٔ بازگردانده‌شده 0 است؛ در صورتی که حذف ناموفق باشد، نتیجه 1 خواهد بود..SS class\-get
.sp
این دستور اطلاعات تفصیلی را درباره یک کلاس کلاینت موجود بازمی‌گرداند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4، kea\-dhcp6
.sp
در دسترس بودن: 1.5.0 (کتابخانه هوک class_cmds)
.sp
دسترسی: read \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: به دستور class\-get در \%<#\:command-class-get> مراجعه کنید
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqclass\-get\(dq,
    \(dqarguments\(dq: {
        \(dqname\(dq: <name of the class>
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqClass \(aq<class\-name>\(aq definition returned\(dq,
    \(dqarguments\(dq: {
        \(dqclient\-classes\(dq: [
            {
                \(dqname\(dq: <name of the class>,
                \(dqonly\-in\-additional\-list\(dq: <only in additional list boolean value>,
                \(dqtest\(dq: <test expression to be evaluated on incoming packets>,
                \(dqoption\-data\(dq: [ <option values here> ],
                \(dqoption\-def\(dq: [ <option definitions here> ],
                \(dqnext\-server\(dq: <ipv4 address>,
                \(dqserver\-hostname\(dq: <string>,
                \(dqboot\-file\-name\(dq: <name of the boot file>
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
اطلاعات بازگردانده‌شده به نوع سرور DHCP بستگی دارد؛ به این معنی که برخی پارامترها مختص سرور DHCPv4 هستند. همچنین، اگر برخی پارامترها برای کلاس کلاینت تنظیم نشده باشند، ممکن است در پاسخ بازگردانده نشوند. اگر کلاسی با نام مشخص‌شده وجود نداشته باشد، نتیجه ۳ (empty) بازگردانده می‌شود. اگر کلاس کلاینت پیدا شود، نتیجه ۰ بازگردانده خواهد شد. در صورت بروز خطا در حین پردازش دستور، نتیجه ۱ بازگردانده می‌شود.
.SS class\-list
.sp
این دستور فهرستی از تمامی کلاس‌های کلاینت را از پیکربندی سرور دریافت می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4، kea\-dhcp6
.sp
در دسترس بودن: 1.5.0 (کتابخانه هوک class_cmds)
.sp
دسترسی: read \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: به دستور class\-list در \%<#\:command-class-list> مراجعه کنید
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqclass\-list\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور هیچ آرگومانی ندارد.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq\(aq<number of>\(aq classes found\(dq,
    \(dqarguments\(dq: {
        \(dqclient\-classes\(dq: [
            {
                \(dqname\(dq: <first class name>
            },
            {
                \(dqname\(dq: <second class name>
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
فهرست کلاس‌های بازگردانده‌شده صرفاً حاوی نام آن‌هاست. جهت دریافت اطلاعات کامل در مورد یکی از این کلاس‌ها، از دستور class\-get در \%<#\:command-class-get>\& استفاده کنید. اگر هیچ کلاسی پیدا نشود، نتیجه بازگردانده‌شده ۳ (empty) است. اگر دستور با موفقیت پردازش شود و فهرست کلاس‌های کلاینت خالی نباشد، نتیجه ۰ بازگردانده می‌شود. در صورت بروز خطا حین پردازش دستور، نتیجه ۱ بازگردانده خواهد شد.
.SS class\-update
.sp
این دستور یک کلاس کلاینت موجود را در پیکربندی سرور به‌روزرسانی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4، kea\-dhcp6
.sp
در دسترس بودن: 1.5.0 (کتابخانه هوک class_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: به دستور class\-update در \%<#\:command-class-update> مراجعه کنید
.sp.SS config\-backend\-pull
.sp
این دستور سرور را وادار می‌کند تا فوراً با استفاده از Config Backends به‌روزرسانی شود.
این دستور هیچ پارامتری نمی‌پذیرد.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4، kea\-dhcp6
.sp
در دسترس بودن: 1.7.1 (توکار)
.sp
دسترسی: write \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور config\-backend\-pull را در \%<#\:command-config-backend-pull> ببینید
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqconfig\-backend\-pull\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqOn demand configuration update successful.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
هنگامی که هیچ Config Backend‌ای پیکربندی نشده باشد، این دستور empty (3) را بازمی‌گرداند؛
اگر خطایی رخ دهد، error (1) همراه با جزئیات خطا بازگردانده می‌شود؛
در غیر این صورت، success (0) بازگردانده خواهد شد.
.SS config\-get
.sp
این دستور پیکربندی فعلی مورد استفاده سرور را واکشی می‌کند. این پیکربندی اساساً همان محتوای فایل پیکربندی است، اما تغییرات اعمال‌شده توسط سایر دستورها و موارد ناشی از وراثت پارامترها را نیز شامل می‌شود.
.sp
پشتیبانی‌شده توسط: kea\-dhcp\-ddns، kea\-dhcp4، kea\-dhcp6
.sp
در دسترس بودن: 1.2.0 (توکار)
.sp
دسترسی: read \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور config\-get را در \%<#\:command-config-get> ببینید
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqconfig\-get\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور هیچ پارامتری نمی‌پذیرد.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqarguments\(dq: {
        <Dhcp4, Dhcp6, or DhcpDdns object>: <JSON configuration here>
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
از نسخه 2.4.0 سامانه Kea به بعد، پاسخ موفقیت‌آمیز حاوی یک خلاصه (digest) بر مبنای SHA256 از پیکربندیِ تازه دریافت‌شده است. ممکن است از این مقدار، احتمالاً با به‌کارگیری config\-hash\-get، برای تعیین اینکه آیا پیکربندی تغییر کرده است یا خیر استفاده شود.
.SS config\-hash\-get
.sp
این دستور هش (hash) پیکربندی فعلی مورد استفاده سرور را واکشی می‌کند. این
پیکربندی اساساً همان محتوای فایل پیکربندی است، اما شامل تغییرات اعمال‌شده
توسط دستورهای دیگر و موارد ناشی از وراثت پارامترها نیز می‌شود.
در حال حاضر این الگوریتم SHA256 است، اما ممکن است در آینده تغییر کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp\-ddns، kea\-dhcp4، kea\-dhcp6
.sp
در دسترس بودن: 2.4.0 (توکار)
.sp
دسترسی: read \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور config\-hash\-get را در \%<#\:command-config-hash-get> ببینید
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqconfig\-hash\-get\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور هیچ پارامتری نمی‌پذیرد.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqarguments\(dq: {
        \(dqhash\(dq: <SHA256 hash of the config in hexa>
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه (Result) نمایشی از وضعیت به‌صورت یک عدد صحیح است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت به پایان رسید، اما داده‌ای تغییر نیافت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (conflict) (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT.SS config\-reload
.sp
این دستور به Kea فرمان می‌دهد تا فایل پیکربندی را که پیش‌تر استفاده شده بود، دوباره بارگذاری کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp\-ddns، kea\-dhcp4، kea\-dhcp6
.sp
دردسترس بودن: 1.2.0 (توکار)
.sp
دسترسی: write \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور config\-reload را ببینید \%<#\:command-config-reload>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqconfig\-reload\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: \(dq<string>\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
مقدار result یک نمایش عدد صحیح از وضعیت است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت کامل شد، اما هیچ داده‌ای تغییر نکرد یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (conflict) (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT
.SS config\-set
.sp
این دستور به سرور فرمان می‌دهد که پیکربندی فعلی خود را با پیکربندی جدید ارائه‌شده در آرگومان‌های دستور جایگزین کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp\-ddns، kea\-dhcp4، kea\-dhcp6
.sp
دردسترس بودن: 1.2.0 (توکار)
.sp
دسترسی: write \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور config\-set را ببینید \%<#\:command-config-set>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqconfig\-set\(dq,
    \(dqarguments\(dq:  {
        \(dq\(aq<server>\(aq\(dq: {
        }
     }
}
.EE
.UNINDENT
.UNINDENT
.sp
در مثال زیر، \(aq<server>\(aq نام عنصر پیکربندی برای یک سرور معین مانند \(dqDhcp4\(dq یا \(dqDhcp6\(dq است.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqarguments\(dq: {
        \(dqhash\(dq: \(dq8B5F5822E93178B65CE658304C37EA511BDE7D29F792AA5E88012FC741F2BE32\(dq
    },
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqConfiguration successful.\(dq
}

or

{ \(dqresult\(dq: 1, \(dqtext\(dq: \(dqunsupported parameter: BOGUS (<string>:16:26)\(dq }
.EE
.UNINDENT
.UNINDENT
.sp
از نسخه 2.4.0 Kea به بعد، پاسخ موفقیت‌آمیز از سوی دیمن‌های DHCPv4، DHCPv6 یا DHCP\-DDNS
همچنین شامل یک خلاصه (digest) SHA\-256 از پیکربندی جدیداً تنظیم‌شده است. از این خلاصه می‌توان
به‌سادگی برای تشخیص اینکه آیا پیکربندی تغییر کرده است یا خیر، احتمالاً با استفاده از config\-hash\-get، بهره برد.
.SS config\-test
.sp
این دستور به سرور فرمان می‌دهد بررسی کند که آیا پیکربندی جدید ارائه‌شده در آرگومان‌های دستور قابل بارگذاری است یا خیر.
.sp
پشتیبانی‌شده توسط: kea\-dhcp\-ddns، kea\-dhcp4، kea\-dhcp6
.sp
دردسترس بودن: 1.2.0 (توکار)
.sp
دسترسی: write \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور config\-test را ببینید \%<#\:command-config-test>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqconfig\-test\(dq,
    \(dqarguments\(dq:  {
        \(dq\(aq<server>\(aq\(dq: {
        }
     }
}
.EE
.UNINDENT
.UNINDENT
.sp
در مثال زیر، \(aq<server>\(aq نام عنصر پیکربندی برای یک سرور معین مانند \(dqDhcp4\(dq یا \(dqDhcp6\(dq است.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{ \(dqresult\(dq: 0, \(dqtext\(dq: \(dqConfiguration seems sane.\(dq }

or

{ \(dqresult\(dq: 1, \(dqtext\(dq: \(dqunsupported parameter: BOGUS (<string>:16:26)\(dq }
.EE
.UNINDENT
.UNINDENT
.sp
مقدار result یک نمایش عدد صحیح از وضعیت است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت کامل شد، اما هیچ داده‌ای تغییر نکرد یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (conflict) (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT.SS config\-write
.sp
این دستور به کارساز Kea دستور می‌دهد تا پیکربندی
فعلی خود را درون فایلی روی دیسک بنویسد.
.sp
پشتیبانی‌شده توسط: kea\-dhcp\-ddns، kea\-dhcp4، kea\-dhcp6
.sp
در دسترس بودن: 1.2.0 (توکار)
.sp
دسترسی: write \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور config\-write را ببینید \%<#\:command-config-write>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqconfig\-write\(dq,
    \(dqarguments\(dq: {
        \(dqfilename\(dq: \(dqconfig\-modified\-2017\-03\-15.json\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: \(dq<string>\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
مقدار result یک نمایش عدد صحیح از وضعیت است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت
.IP \(bu 2
1 \- خطا
.IP \(bu 2
2 \- پشتیبانی‌نشده
.IP \(bu 2
3 \- خالی (دستور با موفقیت به پایان رسید، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت کارساز در تعارض بودند)
.UNINDENT
.SS dhcp\-disable
.sp
این دستور سرویس DHCP را غیرفعال می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4، kea\-dhcp6
.sp
در دسترس بودن: 1.4.0 (توکار)
.sp
دسترسی: write \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور dhcp\-disable را ببینید \%<#\:command-dhcp-disable>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqdhcp\-disable\(dq,
    \(dqarguments\(dq: {
        \(dqmax\-period\(dq: 20,
        \(dqorigin\(dq: \(dqha\-partner\(dq,
        \(dqorigin\-id\(dq: 2002
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: \(dq<string>\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
مقدار result یک نمایش عدد صحیح از وضعیت است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت
.IP \(bu 2
1 \- خطا
.IP \(bu 2
2 \- پشتیبانی‌نشده
.IP \(bu 2
3 \- خالی (دستور با موفقیت به پایان رسید، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت کارساز در تعارض بودند)
.UNINDENT
.SS dhcp\-enable
.sp
این دستور سرویس DHCP را فعال می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4، kea\-dhcp6
.sp
در دسترس بودن: 1.4.0 (توکار)
.sp
دسترسی: write \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور dhcp\-enable را ببینید \%<#\:command-dhcp-enable>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqdhcp\-enable\(dq,
    \(dqarguments\(dq: {
        \(dqorigin\(dq: \(dqha\-partner\(dq,
        \(dqorigin\-id\(dq: 2002
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: \(dq<string>\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
مقدار result یک نمایش عدد صحیح از وضعیت است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت
.IP \(bu 2
1 \- خطا
.IP \(bu 2
2 \- پشتیبانی‌نشده
.IP \(bu 2
3 \- خالی (دستور با موفقیت به پایان رسید، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت کارساز در تعارض بودند)
.UNINDENT.SS extended\-info4\-upgrade
.sp
این دستور اطلاعات تکمیلی (extended info) تمام اجاره‌های IPv4 را پالایش کرده و ستون‌های relay و remote ID را در پایگاه‌داده اجاره‌های SQL پر می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس بودن: 2.3.8 (کتابخانه قلاب lease_query)
.sp
دسترسی: write \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور extended\-info4\-upgrade را ببینید \%<#\:command-extended-info4-upgrade>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqextended\-info4\-upgrade\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqarguments\(dq: {
  },
  \(dqresult\(dq: 0,
  \(dqtext\(dq: \(dqUpgraded 1000 leases\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور زمانی باید استفاده شود که تعدادی اجاره قدیمی IPv4 در پایگاه‌داده اجاره با بک‌اند SQL وجود داشته باشند.
.SS extended\-info6\-upgrade
.sp
این دستور اطلاعات تکمیلی (extended info) تمام اجاره‌های IPv6 را پالایش کرده و در صورت فعال بودن، جدول‌های relay و remote ID را در پایگاه‌داده اجاره‌های SQL بازسازی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس بودن: 2.5.0 (کتابخانه قلاب lease_query)
.sp
دسترسی: write \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور extended\-info6\-upgrade را ببینید \%<#\:command-extended-info6-upgrade>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqextended\-info6\-upgrade\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqarguments\(dq: {
  },
  \(dqresult\(dq: 0,
  \(dqtext\(dq: \(dqUpgraded 1000 leases\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور زمانی باید استفاده شود که برخی اجاره‌های قدیمی IPv6 در پایگاه‌داده اجاره با بک‌اند SQL وجود داشته باشند تا آن‌ها را برای . قابل مشاهده سازد.
.SS gss\-tsig\-get
.sp
این دستور اطلاعات مربوط به کارساز GSS\-TSIG مشخص‌شده را بازیابی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp\-ddns
.sp
در دسترس بودن: 2.0.0 (کتابخانه قلاب gss_tsig)
.sp
دسترسی: read \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور gss\-tsig\-get را ببینید \%<#\:command-gss-tsig-get>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqgss\-tsig\-get\(dq,
    \(dqarguments\(dq: {
        \(dqserver\-id\(dq: \(dqfoo\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqGSS\-TSIG server[foo] found\(dq,
    \(dqarguments\(dq: {
        \(dqid\(dq: \(dqfoo\(dq,
        \(dqip\-address\(dq: \(dq192.1.2.3\(dq,
        \(dqport\(dq: 53,
        \(dqserver\-principal\(dq: \(dqDNS/foo.com@FOO.COM\(dq,
        \(dqkey\-name\-suffix\(dq: \(dqfoo.com.\(dq,
        \(dqtkey\-lifetime\(dq: 3600,
        \(dqtkey\-protocol\(dq: \(dqTCP\(dq,
        \(dqkeys\(dq: [
            {
                \(dqname\(dq: \(dq1234.sig\-foo.com.\(dq,
                \(dqserver\-id\(dq: \(dqfoo\(dq,
                \(dqinception\-date\(dq: \(dq2021\-09\-05 12:23:36.281176\(dq,
                \(dqexpire\-date\(dq: \(dq2021\-09\-05 13:23:36.281176\(dq,
                \(dqstatus\(dq: \(dqnot yet ready\(dq,
                \(dqtkey\-exchange\(dq: true
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت کامل شد، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (conflict) (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت کارساز در تعارض بودند)
.UNINDENT.SS gss\-tsig\-get\-all
.sp
این دستور کارسازها و کلیدهای GSS\-TSIG را فهرست می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp\-ddns
.sp
در دسترس در: 2.0.0 (کتابخانه هوک gss_tsig)
.sp
سطح دسترسی: read \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: به دستور gss\-tsig\-get\-all در \%<#\:command-gss-tsig-get-all> مراجعه کنید
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqgss\-tsig\-get\-all\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq1 GSS\-TSIG servers and 1 keys\(dq,
    \(dqarguments\(dq: {
        \(dqgss\-tsig\-servers\(dq: [
            {
                \(dqid\(dq: \(dqfoo\(dq,
                \(dqip\-address\(dq: \(dq192.1.2.3\(dq,
                \(dqport\(dq: 53,
                \(dqserver\-principal\(dq: \(dqDNS/foo.com@FOO.COM\(dq,
                \(dqkey\-name\-suffix\(dq: \(dqfoo.com.\(dq,
                \(dqtkey\-lifetime\(dq: 3600,
                \(dqtkey\-protocol\(dq: \(dqTCP\(dq,
                \(dqkeys\(dq: [
                    {
                        \(dqname\(dq: \(dq1234.sig\-foo.com.\(dq,
                        \(dqinception\-date\(dq: \(dq2021\-09\-05 12:23:36.281176\(dq,
                        \(dqserver\-id\(dq: \(dqfoo\(dq,
                        \(dqexpire\-date\(dq: \(dq2021\-09\-05 13:23:36.281176\(dq,
                        \(dqstatus\(dq: \(dqnot yet ready\(dq,
                        \(dqtkey\-exchange\(dq: true
                    }
                ]
            },
            {
                \(dqid\(dq: \(dqbar\(dq,
                \(dqip\-address\(dq: \(dq192.1.2.4\(dq,
                \(dqport\(dq: 53,
                \(dqserver\-principal\(dq: \(dqDNS/bar.com@FOO.COM\(dq,
                \(dqkey\-name\-suffix\(dq: \(dqbar.com.\(dq,
                \(dqtkey\-lifetime\(dq: 7200,
                \(dqtkey\-protocol\(dq: \(dqUDP\(dq,
                \(dqkeys\(dq: [ ]
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه (Result) نمایشی عددی از وضعیت است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت‌آمیز
.IP \(bu 2
1 \- خطا
.IP \(bu 2
2 \- پشتیبانی‌نشده
.IP \(bu 2
3 \- خالی (دستور با موفقیت به پایان رسید، اما هیچ داده‌ای تغییر نکرد یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت کارساز در تعارض بودند)
.UNINDENT
.SS gss\-tsig\-key\-del
.sp
این دستور کلید GSS\-TSIG مشخص‌شده را حذف می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp\-ddns
.sp
در دسترس در: 2.0.0 (کتابخانه هوک gss_tsig)
.sp
سطح دسترسی: write \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: به دستور gss\-tsig\-key\-del در \%<#\:command-gss-tsig-key-del> مراجعه کنید
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqgss\-tsig\-key\-del\(dq,
    \(dqarguments\(dq: {
        \(dqkey\-name\(dq: \(dq1234.sig\-foo.com.\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqGSS\-TSIG key \(aq1234.sig\-foo.com.\(aq deleted\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه (Result) نمایشی عددی از وضعیت است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت‌آمیز
.IP \(bu 2
1 \- خطا
.IP \(bu 2
2 \- پشتیبانی‌نشده
.IP \(bu 2
3 \- خالی (دستور با موفقیت به پایان رسید، اما هیچ داده‌ای تغییر نکرد یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت کارساز در تعارض بودند)
.UNINDENT.SS gss\-tsig\-key\-expire
.sp
این دستور کلید GSS\-TSIG مشخص‌شده را منقضی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp\-ddns
.sp
دسترس‌پذیری: 2.0.0 (کتابخانه هوک gss_tsig)
.sp
دسترسی: write \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور gss\-tsig\-key\-expire را ببینید \%<#\:command-gss-tsig-key-expire>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqgss\-tsig\-key\-expire\(dq,
    \(dqarguments\(dq: {
        \(dqkey\-name\(dq: \(dq1234.sig\-foo.com.\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqGSS\-TSIG key \(aq1234.sig\-foo.com.\(aq expired\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه، نمایشی از وضعیت در قالب عدد صحیح است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت
.IP \(bu 2
1 \- خطا
.IP \(bu 2
2 \- پشتیبانی‌نشده
.IP \(bu 2
3 \- خالی (دستور با موفقیت به پایان رسید، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تداخل بودند)
.UNINDENT
.SS gss\-tsig\-key\-get
.sp
این دستور اطلاعات مربوط به کلید GSS\-TSIG مشخص‌شده را بازیابی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp\-ddns
.sp
دسترس‌پذیری: 2.0.0 (کتابخانه هوک gss_tsig)
.sp
دسترسی: read \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور gss\-tsig\-key\-get را ببینید \%<#\:command-gss-tsig-key-get>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqgss\-tsig\-key\-get\(dq,
    \(dqarguments\(dq: {
        \(dqkey\-name\(dq: \(dq1234.sig\-foo.com.\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqGSS\-TSIG key \(aq1234.sig\-foo.com.\(aq found\(dq,
    \(dqarguments\(dq: {
        \(dqname\(dq: \(dq1234.sig\-foo.com.\(dq,
        \(dqserver\-id\(dq: \(dqfoo\(dq,
        \(dqinception\-date\(dq: \(dq2021\-09\-05 12:23:36.281176\(dq,
        \(dqexpire\-date\(dq: \(dq2021\-09\-05 13:23:36.281176\(dq,
        \(dqstatus\(dq: \(dqnot yet ready\(dq,
        \(dqtkey\-exchange\(dq: true
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه، نمایشی از وضعیت در قالب عدد صحیح است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت
.IP \(bu 2
1 \- خطا
.IP \(bu 2
2 \- پشتیبانی‌نشده
.IP \(bu 2
3 \- خالی (دستور با موفقیت به پایان رسید، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تداخل بودند)
.UNINDENT
.SS gss\-tsig\-list
.sp
این دستور شناسه‌های سرور GSS\-TSIG و نام‌های کلید را فهرست می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp\-ddns
.sp
دسترس‌پذیری: 2.0.0 (کتابخانه هوک gss_tsig)
.sp
دسترسی: read \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور gss\-tsig\-list را ببینید \%<#\:command-gss-tsig-list>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqgss\-tsig\-list\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq2 GSS\-TSIG servers and 3 keys\(dq,
    \(dqarguments\(dq: {
        \(dqgss\-tsig\-servers\(dq: [
            \(dqfoo\(dq,
            \(dqbar\(dq
        ],
        \(dqgss\-tsig\-keys\(dq: [
            \(dq1234.example.com.\(dq,
            \(dq5678.example.com.\(dq,
            \(dq43888.example.org.\(dq
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه، نمایشی از وضعیت در قالب عدد صحیح است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت
.IP \(bu 2
1 \- خطا
.IP \(bu 2
2 \- پشتیبانی‌نشده
.IP \(bu 2
3 \- خالی (دستور با موفقیت به پایان رسید، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تداخل بودند)
.UNINDENT.SS gss\-tsig\-purge
.sp
این دستور کلیدهای غیرقابل استفادهٔ GSS\-TSIG را برای سرور مشخص‌شده حذف می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp\-ddns
.sp
دسترس‌پذیری: 2.0.0 (کتابخانهٔ قلاب gss_tsig)
.sp
دسترسی: write \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور gss\-tsig\-purge را ببینید \%<#\:command-gss-tsig-purge>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqgss\-tsig\-purge\(dq,
    \(dqarguments\(dq: {
        \(dqserver\-id\(dq: \(dqfoo\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq2 purged keys for GSS\-TSIG server[foo]\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
مقدار result یک نمایش عدد صحیح از وضعیت است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- success (موفقیت)
.IP \(bu 2
1 \- error (خطا)
.IP \(bu 2
2 \- unsupported (پشتیبانی‌نشده)
.IP \(bu 2
3 \- empty (دستور با موفقیت کامل شد، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- conflict (دستور نتوانست تغییرات پیکربندی درخواست‌شده را اعمال کند زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT
.SS gss\-tsig\-purge\-all
.sp
این دستور کلیدهای غیرقابل استفادهٔ GSS\-TSIG را حذف می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp\-ddns
.sp
دسترس‌پذیری: 2.0.0 (کتابخانهٔ قلاب gss_tsig)
.sp
دسترسی: write \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور gss\-tsig\-purge\-all را ببینید \%<#\:command-gss-tsig-purge-all>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqgss\-tsig\-purge\-all\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq2 purged GSS\-TSIG keys\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
مقدار result یک نمایش عدد صحیح از وضعیت است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- success (موفقیت)
.IP \(bu 2
1 \- error (خطا)
.IP \(bu 2
2 \- unsupported (پشتیبانی‌نشده)
.IP \(bu 2
3 \- empty (دستور با موفقیت کامل شد، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- conflict (دستور نتوانست تغییرات پیکربندی درخواست‌شده را اعمال کند زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT
.SS gss\-tsig\-rekey
.sp
این دستور بدون قید و شرط کلیدهای جدید GSS\-TSIG را برای سرور DNS مشخص‌شده ایجاد می‌کند (عملیات rekey را انجام می‌دهد).
.sp
پشتیبانی‌شده توسط: kea\-dhcp\-ddns
.sp
دسترس‌پذیری: 2.0.0 (کتابخانهٔ قلاب gss_tsig)
.sp
دسترسی: write \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور gss\-tsig\-rekey را ببینید \%<#\:command-gss-tsig-rekey>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqgss\-tsig\-rekey\(dq,
    \(dqarguments\(dq: {
        \(dqserver\-id\(dq: \(dqfoo\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqGSS\-TSIG server[foo] rekeyed\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
مقدار result یک نمایش عدد صحیح از وضعیت است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- success (موفقیت)
.IP \(bu 2
1 \- error (خطا)
.IP \(bu 2
2 \- unsupported (پشتیبانی‌نشده)
.IP \(bu 2
3 \- empty (دستور با موفقیت کامل شد، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- conflict (دستور نتوانست تغییرات پیکربندی درخواست‌شده را اعمال کند زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT.SS gss\-tsig\-rekey\-all
.sp
این دستور بدون قید و شرط کلیدهای جدید GSS\-TSIG را برای تمام کارگزارهای DNS ایجاد می‌کند (کلیدزنی مجدد یا rekey).
.sp
پشتیبانی‌شده توسط: kea\-dhcp\-ddns
.sp
در دسترس بودن: 2.0.0 (کتابخانه قلاب gss_tsig)
.sp
دسترسی: write \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور gss\-tsig\-rekey\-all را ببینید \%<#\:command-gss-tsig-rekey-all>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqgss\-tsig\-rekey\-all\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqrekeyed\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه (result) یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- تهی (empty) (دستور با موفقیت انجام شد، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (conflict) (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت کارگزار در تعارض بود)
.UNINDENT
.SS ha\-continue
.sp
این دستور عملکرد یک ماشین وضعیت HA متوقف‌شده (paused) را از سر می‌گیرد.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4, kea\-dhcp6
.sp
در دسترس بودن: 1.4.0 (کتابخانه قلاب high_availability)
.sp
دسترسی: write \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور ha\-continue را ببینید \%<#\:command-ha-continue>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqha\-continue\(dq,
    \(dqarguments\(dq: {
        \(dqserver\-name\(dq: \(dqserver1\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: \(dq<string>\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه (result) یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- تهی (empty) (دستور با موفقیت انجام شد، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (conflict) (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت کارگزار در تعارض بود)
.UNINDENT
.SS ha\-heartbeat
.sp
این دستور به‌طور داخلی توسط یک همتای Kea هنگام کار در حالت دسترسی‌پذیری بالا (HA) یا توسط مدیر سیستم برای بررسی وضعیت کارگزاران از نظر دسترسی‌پذیری بالا ارسال می‌شود. این دستور وضعیت HA و مقدار ساعت کارگزار را دریافت می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4, kea\-dhcp6
.sp
در دسترس بودن: 1.4.0 (کتابخانه قلاب high_availability)
.sp
دسترسی: write \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور ha\-heartbeat را ببینید \%<#\:command-ha-heartbeat>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqha\-heartbeat\(dq,
    \(dqarguments\(dq: {
        \(dqserver\-name\(dq: \(dqserver1\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqHA peer status returned.\(dq,
    \(dqarguments\(dq: {
        \(dqstate\(dq: <server state>,
        \(dqdate\-time\(dq: <server notion of time>,
        \(dqscopes\(dq: [ <first scope>, <second scope>, ... ],
        \(dqunsent\-update\-count\(dq: <total number of lease allocations in partner\-down state>
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ شامل وضعیت کارگزار (وضعیت‌های کارگزار را ببینید \%<#\:ha-server-states>)، مقدار ساعت فعلی، محدوده‌های (scopes) سرویس‌دهی‌شده و شمارنده‌ای است که مشخص می‌کند کارگزار چه تعداد اجاره را بدون ارسال به‌روزرسانی‌های اجاره به همتای خود تخصیص داده است. همتا از این شمارنده برای تشخیص اینکه آیا باید پایگاه داده اجاره‌های خود را همگام‌سازی کند یا خیر استفاده می‌کند..SS ha\-maintenance\-cancel
.sp
این دستور برای هدایت کارگزاری که در وضعیت partner\-in\-maintenance قرار دارد
به بازگشت به وضعیت پیشین ارسال می‌شود و در عمل، عملیات نگهداری را لغو می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4، kea\-dhcp6
.sp
در دسترس بودن: 1.7.4 (کتابخانه هوک high_availability)
.sp
دسترسی: write \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: به دستور ha\-maintenance\-cancel مراجعه کنید \%<#\:command-ha-maintenance-cancel>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqha\-maintenance\-cancel\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور هیچ آرگومانی نمی‌پذیرد.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: \(dq<string>\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک مقدار عددی صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت کامل شد، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (conflict) (دستور نتوانست تغییرات پیکربندی درخواست‌شده را اعمال کند زیرا با وضعیت کارگزار در تداخل بودند)
.UNINDENT
.SS ha\-maintenance\-notify
.sp
این دستور توسط کارگزاری که ha\-maintenance\-start را دریافت کرده است
به همتای خود ارسال می‌شود تا باعث انتقال همتا به وضعیت in\-maintenance گردد
یا در نتیجه دریافت دستور ha\-maintenance\-cancel، آن را از وضعیت in\-maintenance بازگرداند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4، kea\-dhcp6
.sp
در دسترس بودن: 1.7.4 (کتابخانه هوک high_availability)
.sp
دسترسی: write \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: به دستور ha\-maintenance\-notify مراجعه کنید \%<#\:command-ha-maintenance-notify>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqha\-maintenance\-notify\(dq,
    \(dqarguments\(dq: {
        \(dqcancel\(dq: true,
        \(dqstate\(dq: \(dqready\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور شامل یک آرگومان بولی است که اگر false باشد، نشان می‌دهد
که کارگزار باید به وضعیت in\-maintenance منتقل شود.
اگر آرگومان cancel بر روی true تنظیم شده باشد، به کارگزار دستور می‌دهد که از
وضعیت in\-maintenance به وضعیت پیشین خود بازگردد. آرگومان state گیرنده را
از وضعیت کارگزار فرستنده مطلع می‌سازد.
این دستور برای استفاده توسط مدیر سیستم در نظر گرفته نشده است؛ بلکه
صرفاً برای ارتباطات داخلی میان همتاهای HA استفاده می‌شود.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: \(dq<string>\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ ممکن است شامل یک کد خطای ویژه 1001 باشد
که نشان می‌دهد همتا از ورود به وضعیت نگهداری امتناع کرده است.
.SS ha\-maintenance\-start
.sp
این دستور برای دستور دادن به یکی از کارگزارها جهت انتقال
به وضعیت partner\-in\-maintenance ارسال می‌شود که در آن وضعیت، به
تمامی پرس‌وجوهای DHCP پاسخ خواهد داد. کارگزاری که این دستور را دریافت می‌کند، دستور
ha\-maintenance\-notify را به همتای خود ارسال می‌کند تا باعث انتقال همتا
به وضعیت in\-maintenance شود.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4، kea\-dhcp6
.sp
در دسترس بودن: 1.7.4 (کتابخانه هوک high_availability)
.sp
دسترسی: write \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: به دستور ha\-maintenance\-start مراجعه کنید \%<#\:command-ha-maintenance-start>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqha\-maintenance\-start\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور هیچ آرگومانی نمی‌پذیرد.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: \(dq<string>\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک مقدار عددی صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت کامل شد، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (conflict) (دستور نتوانست تغییرات پیکربندی درخواست‌شده را اعمال کند زیرا با وضعیت کارگزار در تداخل بودند)
.UNINDENT.SS ha\-reset
.sp
این فرمان ماشین حالت HA کارگزار را با انتقال آن به وضعیت waiting بازنشانی می‌کند.
.sp
پشتیبانی توسط: kea\-dhcp4، kea\-dhcp6
.sp
در دسترس در: 1.9.4 (کتابخانه قلاب high_availability)
.sp
سطح دسترسی: write \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: فرمان ha\-reset را ببینید \%<#\:command-ha-reset>
.sp
نحو فرمان:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqha\-reset\(dq,
    \(dqarguments\(dq: {
        \(dqserver\-name\(dq: \(dqserver1\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: \(dq<string>\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (فرمان با موفقیت تکمیل شد، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (conflict) (فرمان نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت کارگزار در تداخل بودند)
.UNINDENT
.SS ha\-scopes
.sp
این فرمان دامنه‌ای (scope) را که کارگزار هنگام کار در حالت دسترس‌پذیری بالا (HA) مسئول سرویس‌دهی به آن است، تغییر می‌دهد.
.sp
پشتیبانی توسط: kea\-dhcp4، kea\-dhcp6
.sp
در دسترس در: 1.4.0 (کتابخانه قلاب high_availability)
.sp
سطح دسترسی: write \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: فرمان ha\-scopes را ببینید \%<#\:command-ha-scopes>
.sp
نحو فرمان:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqha\-scopes\(dq,
    \(dqarguments\(dq: {
        \(dqscopes\(dq: [ \(dqHA_server1\(dq, \(dqHA_server2\(dq ],
        \(dqserver\-name\(dq: \(dqserver1\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
در مثال زیر، آرگومان‌ها کارگزار را برای مدیریت ترافیک هر دو دامنهٔ HA_server1 و HA_server2 پیکربندی می‌کنند.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: \(dq<string>\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (فرمان با موفقیت تکمیل شد، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (conflict) (فرمان نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت کارگزار در تداخل بودند)
.UNINDENT
.SS ha\-sync
.sp
این فرمان به کارگزاری که در حالت HA اجرا می‌شود دستور می‌دهد تا پایگاه‌داده اجاره‌های (lease database) محلی خود را با همتای (peer) انتخاب‌شده همگام‌سازی کند.
.sp
پشتیبانی توسط: kea\-dhcp4، kea\-dhcp6
.sp
در دسترس در: 1.4.0 (کتابخانه قلاب high_availability)
.sp
سطح دسترسی: write \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: فرمان ha\-sync را ببینید \%<#\:command-ha-sync>
.sp
نحو فرمان:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqha\-sync\(dq,
    \(dqarguments\(dq: {
        \(dqserver\-name\(dq: \(dqserver1\(dq,
        \(dqmax\-period\(dq: 60
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: \(dq<string>\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (فرمان با موفقیت تکمیل شد، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (conflict) (فرمان نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت کارگزار در تداخل بودند)
.UNINDENT.SS ha\-sync\-complete\-notify
.sp
یک سرور با استفاده از این دستور به شریک (partner) خود اطلاع می‌دهد که همگام‌سازی پایگاه‌داده اجاره‌ها (lease database) را به پایان رسانده است. اگر شریک در وضعیت partner\-down باشد، موقتاً تخصیص اجاره‌های جدید را تا زمان انتقال به وضعیت عملیاتی عادی (مانند load\-balancing) متوقف می‌کند. در صورتی که شریک متوجه عدم پاسخگویی ضربان قلب (heartbeat) شود، می‌تواند تخصیص اجاره‌های جدید را در وضعیت partner\-down از سر بگیرد.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4، kea\-dhcp6
.sp
در دسترس از: 1.9.11 (کتابخانه قلاب high_availability)
.sp
دسترسی: write \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور ha\-sync\-complete\-notify را ببینید \%<#\:command-ha-sync-complete-notify>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqha\-sync\-complete\-notify\(dq,
    \(dqarguments\(dq: {
        \(dqserver\-name\(dq: \(dqserver1\(dq,
        \(dqorigin\(dq: 2001,
        \(dqmax\-period\(dq: 60
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور هیچ آرگومانی نمی‌پذیرد.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: \(dq<string>\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک مقدار عددی صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (دستور با موفقیت به پایان رسید، اما هیچ داده‌ای تغییر نکرد یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تداخل بود)
.UNINDENT
.SS interface\-add
.sp
این دستور فهرست رابط‌های مورد استفاده برای پردازش ترافیک DHCP را به‌روزرسانی می‌کند. این دستور فهرستی از رابط‌ها را به همراه نشانی‌های مربوطه (در صورت تعیین) که سرور باید گوش دادن به ترافیک DHCP را روی آن‌ها آغاز کند، به عنوان پارامتر می‌پذیرد.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4، kea\-dhcp6
.sp
در دسترس از: 3.1.9 (توکار - built\-in)
.sp
دسترسی: write \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور interface\-add را ببینید \%<#\:command-interface-add>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqinterface\-add\(dq,
    \(dqarguments\(dq: {
        \(dqinterfaces\(dq: [ \(dqeth0/10.10.1.1\(dq, \(dqeth0/192.168.1.1\(dq, \(dqeth1\(dq]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqOperation succeeded.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک مقدار عددی صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (دستور با موفقیت به پایان رسید، اما هیچ داده‌ای تغییر نکرد یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تداخل بود)
.UNINDENT
.SS interface\-list
.sp
این دستور فهرست رابط‌های شناسایی‌شده را بازیابی می‌کند. این دستور هیچ پارامتری نمی‌پذیرد.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4، kea\-dhcp6
.sp
در دسترس از: 3.1.9 (توکار - built\-in)
.sp
دسترسی: read \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور interface\-list را ببینید \%<#\:command-interface-list>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqinterface\-list\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq2 interfaces detected.\(dq,
    \(dqarguments\(dq: {
        \(dqinterfaces\(dq: [ {
            \(dqname\(dq: \(dqeth0\(dq,
            \(dqindex\(dq: 4,
            \(dqmac\(dq: \(dq00:11:22:33:44:55\(dq,
            \(dqtype\(dq: 6,
            \(dqaddresses\(dq: [ \(dq192.168.1.1\(dq, \(dq10.10.1.1\(dq,
                             \(dq2003:db8:1::1\(dq, \(dq3001:db8:1::1\(dq,
                             \(dqfe80::3a60:77ff:fed5:abcd\(dq ],
            \(dqflag\-loopback\(dq: false,
            \(dqflag\-up\(dq: true,
            \(dqflag\-running\(dq: true,
            \(dqflag\-multicast\(dq: false,
            \(dqflag\-broadcast\(dq: false,
            \(dqin\-use\(dq: true
        }, {
            \(dqname\(dq: \(dqeth1\(dq,
            \(dqindex\(dq: 7,
            \(dqmac\(dq: \(dq11:22:33:44:55:66\(dq,
            \(dqtype\(dq: 6,
            \(dqaddresses\(dq: [ \(dq10.10.1.2\(dq,
                             \(dq2003:db8:1::2\(dq,
                             \(dqfe80::3a60:77ff:fed5:1234\(dq ],
            \(dqflag\-loopback\(dq: false,
            \(dqflag\-up\(dq: true,
            \(dqflag\-running\(dq: true,
            \(dqflag\-multicast\(dq: false,
            \(dqflag\-broadcast\(dq: false,
            \(dqin\-use\(dq: false
        }]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک مقدار عددی صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (دستور با موفقیت به پایان رسید، اما هیچ داده‌ای تغییر نکرد یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تداخل بود)
.UNINDENT.SS interface\-redetect
.sp
این دستور، پس از انجام یک فرآیند شناسایی مجدد که تنها رابط‌های تازه کشف‌شده را اضافه کرده
و هیچ‌یک از رابط‌های شناسایی‌شده پیشین را حذف نمی‌کند، فهرست رابط‌های شناسایی‌شده را بازیابی می‌کند.
این دستور هیچ پارامتری نمی‌پذیرد.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4، kea\-dhcp6
.sp
در دسترس بودن: 3.1.9 (توکار)
.sp
دسترسی: write \fI(در این نسخه Kea این پارامتر نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور interface\-redetect را ببینید \%<#\:command-interface-redetect>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqinterface\-redetect\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq3 interfaces detected.\(dq,
    \(dqarguments\(dq: {
        \(dqinterfaces\(dq: [ {
            \(dqname\(dq: \(dqeth0\(dq,
            \(dqindex\(dq: 4,
            \(dqmac\(dq: \(dq00:11:22:33:44:55\(dq,
            \(dqtype\(dq: 6,
            \(dqaddresses\(dq: [ \(dq192.168.1.1\(dq, \(dq10.10.1.1\(dq, \(dq130.50.1.1\(dq,
                             \(dq2003:db8:1::1\(dq, \(dq3001:db8:1::1\(dq,
                             \(dqfe80::3a60:77ff:fed5:abcd\(dq ],
            \(dqflag\-loopback\(dq: false,
            \(dqflag\-up\(dq: true,
            \(dqflag\-running\(dq: true,
            \(dqflag\-multicast\(dq: false,
            \(dqflag\-broadcast\(dq: false,
            \(dqin\-use\(dq: true
        }, {
            \(dqname\(dq: \(dqeth1\(dq,
            \(dqindex\(dq: 7,
            \(dqmac\(dq: \(dq11:22:33:44:55:66\(dq,
            \(dqtype\(dq: 6,
            \(dqaddresses\(dq: [ \(dq10.10.1.2\(dq,
                             \(dq2003:db8:1::2\(dq,
                             \(dqfe80::3a60:77ff:fed5:1234\(dq ],
            \(dqflag\-loopback\(dq: false,
            \(dqflag\-up\(dq: true,
            \(dqflag\-running\(dq: true,
            \(dqflag\-multicast\(dq: false,
            \(dqflag\-broadcast\(dq: false,
            \(dqin\-use\(dq: false
        }, {
            \(dqname\(dq: \(dqeth2\(dq,
            \(dqindex\(dq: 8,
            \(dqmac\(dq: \(dq22:33:44:55:66:77\(dq,
            \(dqtype\(dq: 6,
            \(dqaddresses\(dq: [ \(dq192.168.1.2\(dq,
                             \(dq3001:db8:1::2\(dq,
                             \(dqfe80::3a60:77ff:fed5:5678\(dq ],
            \(dqflag\-loopback\(dq: false,
            \(dqflag\-up\(dq: true,
            \(dqflag\-running\(dq: false,
            \(dqflag\-multicast\(dq: false,
            \(dqflag\-broadcast\(dq: false,
            \(dqin\-use\(dq: false
        }]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه (Result)، نمایشی عددی از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت انجام شد، اما هیچ داده‌ای تغییر نیافت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (conflict) (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT
.SS kea\-lfc\-start
.sp
این دستور فرآیند kea\-lfc را آغاز می‌کند که وظیفه پاک‌سازی فایل اجاره‌ها را بر عهده دارد.
این دستور هیچ پارامتری دریافت نمی‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4، kea\-dhcp6
.sp
در دسترس بودن: 3.1.2 (توکار)
.sp
دسترسی: write \fI(در این نسخه Kea این پارامتر نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور kea\-lfc\-start را ببینید \%<#\:command-kea-lfc-start>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqkea\-lfc\-start\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: \(dq<string>\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه (Result)، نمایشی عددی از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت انجام شد، اما هیچ داده‌ای تغییر نیافت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (conflict) (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT.SS lease4\-add
.sp
این دستور به‌طور مدیریتی یک اجارهٔ IPv4 جدید اضافه می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس از: 1.3.0 (کتابخانه قلاب lease_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور lease4\-add را ببینید \%<#\:command-lease4-add>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqlease4\-add\(dq,
    \(dqarguments\(dq: {
        \(dqip\-address\(dq: \(dq192.0.2.202\(dq,
        \(dqhw\-address\(dq: \(dq1a:1b:1c:1d:1e:1f\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
توجه داشته باشید که Kea 1.4 به یک آرگومان اضافی به نام subnet\-ID نیاز دارد که از Kea 1.5 به بعد اختیاری است. همچنین تعدادی آرگومان اختیاری دیگر و با جزئیات بیشتر پشتیبانی می‌شوند.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: \(dq<string>\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر نتیجهٔ بازگردانده‌شده برابر با 4 باشد، نشان‌دهندهٔ این است که امکان ایجاد اجاره وجود نداشته است زیرا با وضعیت سرور یا برداشت آن از پیکربندی در تضاد بوده است. کتابخانهٔ قلاب High Availability می‌تواند با چنین نتیجه‌ای متفاوت از یک خطای عمومی رفتار کند. خطای عمومی 1 می‌تواند نشان‌دهندهٔ مشکلاتی در پردازش دستور، در دسترس بودن پایگاه داده و غیره باشد.
.SS lease4\-del
.sp
این دستور یک اجاره را از پایگاه دادهٔ اجاره‌ها حذف می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس از: 1.3.0 (کتابخانه قلاب lease_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور lease4\-del را ببینید \%<#\:command-lease4-del>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqlease4\-del\(dq,
    \(dqarguments\(dq: {
        \(dqip\-address\(dq: \(dq192.0.2.202\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
اجاره‌ای که باید حذف شود می‌تواند بر اساس نشانی IP یا نوع شناسه و مقدار شناسه مشخص گردد. شناسه‌هایی که در حال حاضر پشتیبانی می‌شوند \(dqhw\-address\(dq و \(dqclient\-id\(dq هستند.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: \(dq<string>\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عددی صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت
.IP \(bu 2
1 \- خطا
.IP \(bu 2
2 \- پشتیبانی‌نشده
.IP \(bu 2
3 \- خالی (دستور با موفقیت انجام شد، اما هیچ داده‌ای تغییر نکرد یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (دستور نتوانست تغییرات پیکربندی درخواست‌شده را اعمال کند زیرا با وضعیت سرور در تضاد بودند)
.UNINDENT
.SS lease4\-get
.sp
این دستور پایگاه دادهٔ اجاره‌ها را پرس‌وجو کرده و اجاره‌های موجود را بازیابی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس از: 1.3.0 (کتابخانه قلاب lease_cmds)
.sp
دسترسی: read \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور lease4\-get را ببینید \%<#\:command-lease4-get>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqlease4\-get\(dq,
    \(dqarguments\(dq: {
        \(dqip\-address\(dq: \(dq192.0.2.1\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqarguments\(dq: {
    \(dqclient\-id\(dq: \(dq42:42:42:42:42:42:42:42\(dq,
    \(dqcltt\(dq: 12345678,
    \(dqfqdn\-fwd\(dq: false,
    \(dqfqdn\-rev\(dq: true,
    \(dqhostname\(dq: \(dqmyhost.example.com.\(dq,
    \(dqhw\-address\(dq: \(dq08:08:08:08:08:08\(dq,
    \(dqip\-address\(dq: \(dq192.0.2.1\(dq,
    \(dqstate\(dq: 0,
    \(dqsubnet\-id\(dq: 44,
    \(dqvalid\-lft\(dq: 3600
  },
  \(dqresult\(dq: 0,
  \(dqtext\(dq: \(dqIPv4 lease found.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
دستور lease4\-get نتیجه‌ای را بازمی‌گرداند که وضعیت عملیات و در صورت یافت شدن، جزئیات اجاره را مشخص می‌کند. این خروجی یکی از مقادیر زیر را دارد: 0 (موفقیت)، 1 (خطا)، یا 3 (خالی). نتیجهٔ 3 زمانی بازگردانده می‌شود که هیچ اجاره‌ای با نشانی IP مشخص‌شده پیدا نشود..SS lease4\-get\-all
.sp
این دستور تمام اجاره‌های IPv4 یا تمام اجاره‌های مربوط به مجموعه زیرشبکه‌های مشخص‌شده را بازیابی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
دردسترس از: 1.4.0 (کتابخانه قلاب lease_cmds)
.sp
دسترسی: read \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: به دستور lease4\-get\-all مراجعه کنید \%<#\:command-lease4-get-all>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqlease4\-get\-all\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [ 1, 2, 3, ... ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
دستور \fBlease4\-get\-all\fP ممکن است به پاسخ‌های بسیار بزرگی منجر شود. لطفاً استفاده از \fBlease4\-get\-page\fP را برای دریافت آن‌ها به صورت بخش‌بخش در نظر داشته باشید. پارامتر \fBsubnets\fP اختیاری است. اگر مشخص نشود، اجاره‌های همه زیرشبکه‌ها بازگردانده می‌شوند.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqarguments\(dq: {
    \(dqleases\(dq: [
      {
        \(dqclient\-id\(dq: \(dq01:00:0c:01:02:03:04\(dq,
        \(dqcltt\(dq: 1600432232,
        \(dqfqdn\-fwd\(dq: false,
        \(dqfqdn\-rev\(dq: false,
        \(dqhostname\(dq: \(dq\(dq,
        \(dqhw\-address\(dq: \(dq00:0c:01:02:03:04\(dq,
        \(dqip\-address\(dq: \(dq192.168.1.150\(dq,
        \(dqstate\(dq: 0,
        \(dqsubnet\-id\(dq: 1,
        \(dqvalid\-lft\(dq: 4000
      },
      {
        \(dqclient\-id\(dq: \(dq01:00:0c:01:02:03:05\(dq,
        \(dqcltt\(dq: 1600432234,
        \(dqfqdn\-fwd\(dq: false,
        \(dqfqdn\-rev\(dq: false,
        \(dqhostname\(dq: \(dq\(dq,
        \(dqhw\-address\(dq: \(dq00:0c:01:02:03:05\(dq,
        \(dqip\-address\(dq: \(dq192.168.1.151\(dq,
        \(dqstate\(dq: 0,
        \(dqsubnet\-id\(dq: 1,
        \(dqvalid\-lft\(dq: 4000
      }
    ]
  },
  \(dqresult\(dq: 0,
  \(dqtext\(dq: \(dq2 IPv4 lease(s) found.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه 0 زمانی بازگردانده می‌شود که حداقل یک اجاره پیدا شود، 1 زمانی که پارامترها ناقص باشند یا وجود نداشته باشند، و 3 در صورتی بازگردانده می‌شود که هیچ اجاره‌ای با پارامتر مشخص‌شده پیدا نشود.
.SS lease4\-get\-by\-client\-id
.sp
این دستور تمام اجاره‌های IPv4 دارای client id مشخص‌شده را بازیابی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
دردسترس از: 1.7.1 (کتابخانه قلاب lease_cmds)
.sp
دسترسی: read \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: به دستور lease4\-get\-by\-client\-id مراجعه کنید \%<#\:command-lease4-get-by-client-id>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqlease4\-get\-by\-client\-id\(dq,
    \(dqarguments\(dq: {
        \(dqclient\-id\(dq: \(dq01:00:0c:01:02:03:04\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqarguments\(dq: {
    \(dqleases\(dq: [
      {
        \(dqclient\-id\(dq: \(dq01:00:0c:01:02:03:04\(dq,
        \(dqcltt\(dq: 1600432232,
        \(dqfqdn\-fwd\(dq: false,
        \(dqfqdn\-rev\(dq: false,
        \(dqhostname\(dq: \(dq\(dq,
        \(dqhw\-address\(dq: \(dq00:0c:01:02:03:04\(dq,
        \(dqip\-address\(dq: \(dq192.168.1.150\(dq,
        \(dqstate\(dq: 0,
        \(dqsubnet\-id\(dq: 1,
        \(dqvalid\-lft\(dq: 4000
      }
    ]
  },
  \(dqresult\(dq: 0,
  \(dqtext\(dq: \(dq1 IPv4 lease(s) found.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه 0 زمانی بازگردانده می‌شود که حداقل یک اجاره پیدا شود، 1 زمانی که پارامترها ناقص باشند یا وجود نداشته باشند، و 3 در صورتی بازگردانده می‌شود که هیچ اجاره‌ای یافت نشود..SS lease4\-get\-by\-hostname
.sp
این دستور تمام اجاره‌های IPv4 با نام میزبان مشخص‌شده را بازیابی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس بودن: 1.7.1 (کتابخانه هوک lease_cmds)
.sp
دسترسی: read \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور lease4\-get\-by\-hostname را ببینید \%<#\:command-lease4-get-by-hostname>
.sp
ساختار دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqlease4\-get\-by\-hostname\(dq,
    \(dqarguments\(dq: {
        \(dqhostname\(dq: \(dqmyhost.example.com.\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
ساختار پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqarguments\(dq: {
    \(dqleases\(dq: [
      {
        \(dqclient\-id\(dq: \(dq01:00:0c:01:02:03:04\(dq,
        \(dqcltt\(dq: 1600432232,
        \(dqfqdn\-fwd\(dq: false,
        \(dqfqdn\-rev\(dq: false,
        \(dqhostname\(dq: \(dqmyhost.example.com.\(dq,
        \(dqhw\-address\(dq: \(dq00:0c:01:02:03:04\(dq,
        \(dqip\-address\(dq: \(dq192.168.1.150\(dq,
        \(dqstate\(dq: 0,
        \(dqsubnet\-id\(dq: 1,
        \(dqvalid\-lft\(dq: 4000
      }
    ]
  },
  \(dqresult\(dq: 0,
  \(dqtext\(dq: \(dq1 IPv4 lease(s) found.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
در صورتی که حداقل یک اجاره یافت شود نتیجه 0، اگر پارامترها نامعتبر بوده یا وجود نداشته باشند 1،
و اگر هیچ اجاره‌ای پیدا نشود نتیجه 3 برگردانده می‌شود.
.SS lease4\-get\-by\-hw\-address
.sp
این دستور تمام اجاره‌های IPv4 با آدرس سخت‌افزاری مشخص‌شده را بازیابی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس بودن: 1.7.1 (کتابخانه هوک lease_cmds)
.sp
دسترسی: read \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور lease4\-get\-by\-hw\-address را ببینید \%<#\:command-lease4-get-by-hw-address>
.sp
ساختار دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqlease4\-get\-by\-hw\-address\(dq,
    \(dqarguments\(dq: {
        \(dqhw\-address\(dq: \(dq00:0c:01:02:03:04\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
ساختار پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqarguments\(dq: {
    \(dqleases\(dq: [
      {
        \(dqclient\-id\(dq: \(dq01:00:0c:01:02:03:04\(dq,
        \(dqcltt\(dq: 1600432232,
        \(dqfqdn\-fwd\(dq: false,
        \(dqfqdn\-rev\(dq: false,
        \(dqhostname\(dq: \(dqmyhost.example.com.\(dq,
        \(dqhw\-address\(dq: \(dq00:0c:01:02:03:04\(dq,
        \(dqip\-address\(dq: \(dq192.168.1.150\(dq,
        \(dqstate\(dq: 0,
        \(dqsubnet\-id\(dq: 1,
        \(dqvalid\-lft\(dq: 4000
      }
    ]
  },
  \(dqresult\(dq: 0,
  \(dqtext\(dq: \(dq1 IPv4 lease(s) found.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
در صورتی که حداقل یک اجاره یافت شود نتیجه 0، اگر پارامترها نامعتبر بوده یا وجود نداشته باشند 1،
و اگر هیچ اجاره‌ای پیدا نشود نتیجه 3 برگردانده می‌شود.
.SS lease4\-get\-by\-state
.INDENT 0.0
.TP
.B این دستور تمام اجاره‌های IPv4 با وضعیت مشخص‌شده را
و به‌صورت اختیاری در یک زیرشبکه بازیابی می‌کند.
.UNINDENT
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس بودن: 3.1.5 (کتابخانه هوک lease_cmds)
.sp
دسترسی: read \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور lease4\-get\-by\-state را ببینید \%<#\:command-lease4-get-by-state>
.sp
ساختار دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqlease4\-get\-by\-state\(dq,
    \(dqarguments\(dq: {
        \(dqstate\(dq: 1,
        \(dqsubnet\-id\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
ساختار پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqarguments\(dq: {
    \(dqleases\(dq: [
      {
        \(dqclient\-id\(dq: \(dq01:00:0c:01:02:03:04\(dq,
        \(dqcltt\(dq: 1600432232,
        \(dqfqdn\-fwd\(dq: false,
        \(dqfqdn\-rev\(dq: false,
        \(dqhostname\(dq: \(dq\(dq,
        \(dqhw\-address\(dq: \(dq00:0c:01:02:03:04\(dq,
        \(dqip\-address\(dq: \(dq192.168.1.150\(dq,
        \(dqstate\(dq: 1,
        \(dqsubnet\-id\(dq: 1,
        \(dqvalid\-lft\(dq: 4000
      }
    ]
  },
  \(dqresult\(dq: 0,
  \(dqtext\(dq: \(dq1 IPv4 lease(s) found.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
در صورتی که حداقل یک اجاره یافت شود نتیجه 0، اگر پارامترها نامعتبر بوده یا وجود نداشته باشند 1،
و اگر هیچ اجاره‌ای پیدا نشود نتیجه 3 برگردانده می‌شود..SS lease4\-get\-page
.sp
این دستور تمامی اجاره‌های (leases) IPv4 را به صورت صفحه‌بندی‌شده دریافت می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس بودن: 1.5.0 (کتابخانه قلاب lease_cmds)
.sp
دسترسی: خواندن (read) \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور lease4\-get\-page را در \%<#\:command-lease4-get-page> ببینید
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqlease4\-get\-page\(dq,
    \(dqarguments\(dq: {
        \(dqlimit\(dq: <integer>,
        \(dqfrom\(dq: <IPv4 address or \(aqstart\(aq>
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
آدرس from و محدودیت اندازه صفحه (limit) اجباری هستند.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqarguments\(dq: {
    \(dqleases\(dq: [
      {
        \(dqclient\-id\(dq: \(dq01:00:0c:01:02:03:04\(dq,
        \(dqcltt\(dq: 1600432232,
        \(dqfqdn\-fwd\(dq: false,
        \(dqfqdn\-rev\(dq: false,
        \(dqhostname\(dq: \(dq\(dq,
        \(dqhw\-address\(dq: \(dq00:0c:01:02:03:04\(dq,
        \(dqip\-address\(dq: \(dq192.168.1.150\(dq,
        \(dqstate\(dq: 0,
        \(dqsubnet\-id\(dq: 1,
        \(dqvalid\-lft\(dq: 4000
      },
      {
        \(dqclient\-id\(dq: \(dq01:00:0c:01:02:03:05\(dq,
        \(dqcltt\(dq: 1600432234,
        \(dqfqdn\-fwd\(dq: false,
        \(dqfqdn\-rev\(dq: false,
        \(dqhostname\(dq: \(dq\(dq,
        \(dqhw\-address\(dq: \(dq00:0c:01:02:03:05\(dq,
        \(dqip\-address\(dq: \(dq192.168.1.151\(dq,
        \(dqstate\(dq: 0,
        \(dqsubnet\-id\(dq: 1,
        \(dqvalid\-lft\(dq: 4000
      }
    ]
  },
  \(dqresult\(dq: 0,
  \(dqtext\(dq: \(dq2 IPv4 lease(s) found.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه 0 زمانی برگردانده می‌شود که حداقل یک اجاره پیدا شود، 1 زمانی که پارامترها نامعتبر یا ناموجود باشند، و 3 در صورتی برگردانده می‌شود که هیچ اجاره‌ای با پارامترهای مشخص‌شده یافت نشود.
.SS lease4\-resend\-ddns
.sp
این دستور یک درخواست مجدد به kea\-dhcp\-ddns برای به‌روزرسانی DNS جهت یک اجاره موجود ارسال می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس بودن: 1.7.6 (کتابخانه قلاب lease_cmds)
.sp
دسترسی: نوشتن (write) \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور lease4\-resend\-ddns را در \%<#\:command-lease4-resend-ddns> ببینید
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqlease4\-resend\-ddns\(dq,
    \(dqarguments\(dq: {
        \(dqip\-address\(dq: \(dq192.0.2.1\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqarguments\(dq: {
  },
  \(dqresult\(dq: 0,
  \(dqtext\(dq: \(dqNCR generated for: 192.0.2.1, hostname: example.com.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
دستور lease4\-resend\-ddns نتیجه‌ای را بازمی‌گرداند که وضعیت اجرای عملیات و در صورت یافت شدن، جزئیات اجاره را نشان می‌دهد. این نتیجه یکی از مقادیر زیر خواهد بود: 0 (موفقیت)، 1 (خطا)، یا 3 (خالی).
.SS lease4\-update
.sp
این دستور اجاره‌های موجود را به‌روزرسانی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس بودن: 1.3.0 (کتابخانه قلاب lease_cmds)
.sp
دسترسی: نوشتن (write) \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور lease4\-update را در \%<#\:command-lease4-update> ببینید
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqcommand\(dq: \(dqlease4\-update\(dq,
  \(dqarguments\(dq: {
    \(dqip\-address\(dq: \(dq192.0.2.1\(dq,
    \(dqhostname\(dq: \(dqnewhostname.example.org\(dq,
    \(dqhw\-address\(dq: \(dq1a:1b:1c:1d:1e:1f\(dq,
    \(dqsubnet\-id\(dq: 44,
    \(dqforce\-create\(dq: true
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: \(dq<string>\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر نتیجه بازگردانده‌شده برابر با 4 باشد، نشان می‌دهد که اجاره به دلیل تداخل با وضعیت سرور یا درک آن از پیکربندی نتوانسته است به‌روزرسانی شود. کتابخانه قلاب High Availability می‌تواند چنین نتیجه‌ای را به شکلی متفاوت از یک خطای عمومی مدیریت کند. خطای عمومی 1 می‌تواند نشان‌دهنده مشکلاتی در پردازش دستور، در دسترس بودن پایگاه داده و غیره باشد..SS lease4\-wipe
.sp
این دستور تمام اجاره‌های مرتبط با یک زیرشبکه مشخص را حذف می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
دردسترس‌بودن: 1.3.0 (کتابخانه قلاب lease_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور lease4\-wipe را ببینید \%<#\:command-lease4-wipe>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqlease4\-wipe\(dq,
    \(dqarguments\(dq: {
        \(dqsubnet\-id\(dq: 44
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: \(dq<string>\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه نمایشی عددی از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت به پایان رسید، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (conflict) (دستور نتوانست تغییرات پیکربندی درخواست‌شده را اعمال کند زیرا با وضعیت سرور در تداخل بود)
.UNINDENT
.SS lease4\-write
.sp
این دستور پایگاه‌داده اجاره memfile مربوط به IPv4 را درون یک فایل CSV می‌نویسد.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
دردسترس‌بودن: 2.3.1 (کتابخانه قلاب lease_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور lease4\-write را ببینید \%<#\:command-lease4-write>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqlease4\-write\(dq,
    \(dqarguments\(dq: {
        \(dqfilename\(dq: \(dqa_file.csv\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: \(dq<string>\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه نمایشی عددی از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت به پایان رسید، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (conflict) (دستور نتوانست تغییرات پیکربندی درخواست‌شده را اعمال کند زیرا با وضعیت سرور در تداخل بود)
.UNINDENT
.SS lease6\-add
.sp
این دستور به‌صورت مدیریتی یک اجاره جدید ایجاد می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
دردسترس‌بودن: 1.3.0 (کتابخانه قلاب lease_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور lease6\-add را ببینید \%<#\:command-lease6-add>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqlease6\-add\(dq,
    \(dqarguments\(dq: {
        \(dqsubnet\-id\(dq: 66,
        \(dqip\-address\(dq: \(dq2001:db8::3\(dq,
        \(dqduid\(dq: \(dq1a:1b:1c:1d:1e:1f:20:21:22:23:24\(dq,
        \(dqiaid\(dq: 1234
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
همچنین می‌توان از lease6\-add برای افزودن اجاره‌ها جهت پیشوندهای IPv6 استفاده کرد.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{ \(dqresult\(dq: 0, \(dqtext\(dq: \(dqLease added.\(dq }
or
{ \(dqresult\(dq: 1, \(dqtext\(dq: \(dqmissing parameter \(aqip\-address\(aq (<string>:3:19)\(dq }
.EE
.UNINDENT
.UNINDENT
.sp
اگر نتیجه بازگردانده‌شده برابر با 4 باشد، نشان‌دهنده این است که اجاره نتوانسته ایجاد شود زیرا با وضعیت سرور یا برداشت آن از پیکربندی در تداخل بوده است. کتابخانه قلاب High Availability می‌تواند چنین نتیجه‌ای را به شکلی متفاوت از یک خطای عمومی مدیریت کند. خطای عمومی 1 می‌تواند نشان‌دهنده مشکلاتی در پردازش دستور، دردسترس‌بودن پایگاه‌داده و غیره باشد..SS lease6\-bulk\-apply
.sp
این دستور چندین اجاره‌ی IPv6 را در یک تراکنش واحد ایجاد، به‌روزرسانی یا حذف می‌کند. این دستور تغییرات اجاره را میان همتایان HA تبادل می‌کند، اما در تمامی مواردی که اعمال چندین به‌روزرسانی اجاره در یک تراکنش واحد مطلوب باشد نیز قابل استفاده است.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس بودن: 1.6.0 (کتابخانه هوک lease_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور lease6\-bulk\-apply را ببینید \%<#\:command-lease6-bulk-apply>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqlease6\-bulk\-apply\(dq,
    \(dqarguments\(dq: {
        \(dqdeleted\-leases\(dq: [
            {
                \(dqip\-address\(dq: \(dq2001:db8:abcd::\(dq,
                \(dqtype\(dq: \(dqIA_PD\(dq,
                ...
            },
            {
                \(dqip\-address\(dq: \(dq2001:db8:abcd::234\(dq,
                \(dqtype\(dq: \(dqIA_NA\(dq,
                ...
            }
        ],
        \(dqleases\(dq: [
            {
                \(dqsubnet\-id\(dq: 66,
                \(dqip\-address\(dq: \(dq2001:db8:cafe::\(dq,
                \(dqtype\(dq: \(dqIA_PD\(dq,
                ...
            },
            {
                \(dqsubnet\-id\(dq: 66,
                \(dqip\-address\(dq: \(dq2001:db8:abcd::333\(dq,
                \(dqtype\(dq: \(dqIA_NA\(dq,
                ...
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر هر یک از اجاره‌ها ساختار نامعتبری داشته باشد، تمام تغییرات به عقب بازگردانده می‌شوند (rolled back). اگر اجاره‌ها ساختار معتبری داشته باشند اما عملیات برای یک یا چند مورد از آن‌ها با شکست مواجه شود، این اجاره‌ها در پاسخ فهرست می‌شوند؛ با این حال، تغییرات برای تمامی اجاره‌هایی که عملیات برای آن‌ها با موفقیت انجام شده است حفظ می‌گردد. پارامترهای \(dqdeleted\-leases\(dq و \(dqleases\(dq اختیاری هستند، اما تعیین حداقل یکی از آن‌ها الزامی است.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqIPv6 leases bulk apply completed.\(dq,
    \(dqarguments\(dq: {
        \(dqfailed\-deleted\-leases\(dq: [
            {
                \(dqip\-address\(dq: \(dq2001:db8:abcd::\(dq,
                \(dqtype\(dq: \(dqIA_PD\(dq,
                \(dqresult\(dq: <control result>,
                \(dqerror\-message\(dq: <error message>
            }
        ],
        \(dqfailed\-leases\(dq: [
            {
                \(dqip\-address\(dq: \(dq2001:db8:cafe::\(dq,
                \(dqtype\(dq: \(dqIA_PD\(dq,
                \(dqresult\(dq: <control result>,
                \(dqerror\-message\(dq: <error message>
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
فیلد \(dqfailed\-deleted\-leases\(dq فهرستی از اجاره‌هایی را نگهداری می‌کند که حذف آن‌ها با شکست مواجه شده است؛ این بخش شامل اجاره‌هایی که در پایگاه داده پیدا نشده‌اند نیز می‌شود. فیلد \(dqfailed\-leases\(dq شامل فهرستی از اجاره‌هایی است که ایجاد یا به‌روزرسانی آن‌ها ناموفق بوده است. به ازای هر اجاره‌ای که در حین پردازش، درج در پایگاه داده و غیره دچار خطا شده باشد، مقدار result روی 1 تنظیم می‌شود. در صورتی که خطا به دلیل تعارض میان اجاره و پیکربندی یا وضعیت سرور رخ دهد، مقدار 4 به جای 1 بازگردانده می‌شود. به ازای هر اجاره‌ای که به دلیل نیافتن آن توسط سرور در پایگاه داده حذف نشده است، مقدار 3 بازگردانده می‌شود.
.SS lease6\-del
.sp
این دستور یک اجاره را از پایگاه داده اجاره‌ها حذف می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس بودن: 1.3.0 (کتابخانه هوک lease_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور lease6\-del را ببینید \%<#\:command-lease6-del>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqlease6\-del\(dq,
    \(dqarguments\(dq: {
        \(dqip\-address\(dq: \(dq2001:db8::3\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
دستور lease6\-del نتیجه‌ای را بازمی‌گرداند که وضعیت حاصل از عملیات را نشان می‌دهد. این مقدار یکی از موارد زیر است: 0 (موفقیت)، 1 (خطا)، یا 3 (خالی).
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: \(dq<string>\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
مقدار Result یک نمایش عدد صحیح از وضعیت است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت کامل شد، اما هیچ داده‌ای تغییر نکرد یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (conflict) (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT.SS lease6\-get
.sp
این دستور پایگاه‌دادهٔ اجاره‌ها را پرس‌وجو کرده و اجاره‌های موجود را بازیابی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس بودن: 1.3.0 (کتابخانهٔ قلاب lease_cmds)
.sp
دسترسی: read \fI(پارامتر در این نسخهٔ Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور lease6\-get را ببینید \%<#\:command-lease6-get>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqcommand\(dq: \(dqlease6\-get\(dq,
  \(dqarguments\(dq: {
    \(dqip\-address\(dq: \(dq2001:db8:1234:ab::\(dq,
    \(dqtype\(dq: \(dqIA_PD\(dq
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
دستور lease6\-get نتیجه‌ای را بازمی‌گرداند که وضعیت عملیات و در صورت یافت شدن، جزئیات اجاره را مشخص می‌کند.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqarguments\(dq: {
    \(dqleases\(dq: [
      {
        \(dqcltt\(dq: 1600439560,
        \(dqduid\(dq: \(dq00:01:00:01:26:f7:81:88:00:0c:01:02:03:04\(dq,
        \(dqfqdn\-fwd\(dq: false,
        \(dqfqdn\-rev\(dq: false,
        \(dqhostname\(dq: \(dqfoobar.example.org\(dq,
        \(dqhw\-address\(dq: \(dq00:0c:01:02:03:04\(dq,
        \(dqiaid\(dq: 1,
        \(dqip\-address\(dq: \(dq2001:db8:1::\(dq,
        \(dqpreferred\-lft\(dq: 3000,
        \(dqstate\(dq: 0,
        \(dqsubnet\-id\(dq: 1,
        \(dqtype\(dq: \(dqIA_NA\(dq,
        \(dqvalid\-lft\(dq: 4000
      }
    ]
  },
  \(dqresult\(dq: 0,
  \(dqtext\(dq: \(dq1 IPv6 lease(s) found.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجهٔ 0 زمانی بازگردانده می‌شود که حداقل یک اجاره یافت شود، 1 زمانی که پارامترها نامعتبر یا مفقود باشند،
و 3 در صورتی بازگردانده می‌شود که هیچ اجاره‌ای با پارامتر مشخص‌شده یافت نشود.
.SS lease6\-get\-all
.sp
این دستور تمام اجاره‌های IPv6 یا تمام اجاره‌های مربوط به مجموعه زیرشبکه‌های مشخص‌شده را بازیابی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس بودن: 1.3.0 (کتابخانهٔ قلاب lease_cmds)
.sp
دسترسی: read \fI(پارامتر در این نسخهٔ Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور lease6\-get\-all را ببینید \%<#\:command-lease6-get-all>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqlease6\-get\-all\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [ 1, 2, 3, 4 ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
دستور \fBlease6\-get\-all\fP ممکن است منجر به پاسخ‌های بسیار حجیم شود. لطفاً استفاده از
\fBlease6\-get\-page\fP را برای دریافت آن‌ها به صورت بخش‌بخش در نظر بگیرید. پارامتر \fBsubnets\fP اختیاری است. اگر
مشخص نشود، اجاره‌های تمام زیرشبکه‌ها بازگردانده می‌شوند.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqarguments\(dq: {
        \(dqleases\(dq: [
            {
                \(dqcltt\(dq: 12345678,
                \(dqduid\(dq: \(dq42:42:42:42:42:42:42:42\(dq,
                \(dqfqdn\-fwd\(dq: false,
                \(dqfqdn\-rev\(dq: true,
                \(dqhostname\(dq: \(dqmyhost.example.com.\(dq,
                \(dqhw\-address\(dq: \(dq08:08:08:08:08:08\(dq,
                \(dqiaid\(dq: 1,
                \(dqip\-address\(dq: \(dq2001:db8:2::1\(dq,
                \(dqpreferred\-lft\(dq: 500,
                \(dqstate\(dq: 0,
                \(dqsubnet\-id\(dq: 44,
                \(dqtype\(dq: \(dqIA_NA\(dq,
                \(dqvalid\-lft\(dq: 3600
            },
            {
                \(dqcltt\(dq: 12345678,
                \(dqduid\(dq: \(dq21:21:21:21:21:21:21:21\(dq,
                \(dqfqdn\-fwd\(dq: false,
                \(dqfqdn\-rev\(dq: true,
                \(dqhostname\(dq: \(dq\(dq,
                \(dqiaid\(dq: 1,
                \(dqip\-address\(dq: \(dq2001:db8:0:0:2::\(dq,
                \(dqpreferred\-lft\(dq: 500,
                \(dqprefix\-len\(dq: 80,
                \(dqstate\(dq: 0,
                \(dqsubnet\-id\(dq: 44,
                \(dqtype\(dq: \(dqIA_PD\(dq,
                \(dqvalid\-lft\(dq: 3600
            }
        ]
    },
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq2 IPv6 lease(s) found.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجهٔ 0 زمانی بازگردانده می‌شود که حداقل یک اجاره یافت شود، 1 زمانی که پارامترها نامعتبر یا مفقود باشند،
و 3 در صورتی بازگردانده می‌شود که هیچ اجاره‌ای با پارامتر مشخص‌شده یافت نشود..SS lease6\-get\-by\-duid
.sp
این دستور تمام اجاره‌های IPv6 با DUID مشخص‌شده را بازیابی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
دسترس‌پذیری: 1.7.1 (کتابخانه هوک lease_cmds)
.sp
دسترسی: read \fI(پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور lease6\-get\-by\-duid را ببینید \%<#\:command-lease6-get-by-duid>
.sp
ساختار دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqlease6\-get\-by\-duid\(dq,
    \(dqarguments\(dq: {
        \(dqduid\(dq: \(dq1a:1b:1c:1d:1e:1f:20:21:22:23:24\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
ساختار پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqarguments\(dq: {
    \(dqleases\(dq: [
      {
        \(dqcltt\(dq: 1600439560,
        \(dqduid\(dq: \(dq00:01:00:01:26:f7:81:88:00:0c:01:02:03:04\(dq,
        \(dqfqdn\-fwd\(dq: false,
        \(dqfqdn\-rev\(dq: false,
        \(dqhostname\(dq: \(dqfoobar.example.org\(dq,
        \(dqhw\-address\(dq: \(dq00:0c:01:02:03:04\(dq,
        \(dqiaid\(dq: 1,
        \(dqip\-address\(dq: \(dq2001:db8:1::\(dq,
        \(dqpreferred\-lft\(dq: 3000,
        \(dqstate\(dq: 0,
        \(dqsubnet\-id\(dq: 1,
        \(dqtype\(dq: \(dqIA_NA\(dq,
        \(dqvalid\-lft\(dq: 4000
      }
    ]
  },
  \(dqresult\(dq: 0,
  \(dqtext\(dq: \(dq1 IPv6 lease(s) found.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه 0 هنگامی بازگردانده می‌شود که دست‌کم یک اجاره پیدا شود، 1 هنگامی که پارامترها ناقص یا نادرست باشند،
و در صورتی که هیچ اجاره‌ای با پارامتر مشخص‌شده یافت نشود، 3 بازگردانده می‌شود.
.SS lease6\-get\-by\-hostname
.sp
این دستور تمام اجاره‌های IPv6 با hostname مشخص‌شده را بازیابی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
دسترس‌پذیری: 1.7.1 (کتابخانه هوک lease_cmds)
.sp
دسترسی: read \fI(پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور lease6\-get\-by\-hostname را ببینید \%<#\:command-lease6-get-by-hostname>
.sp
ساختار دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqlease6\-get\-by\-hostname\(dq,
    \(dqarguments\(dq: {
        \(dqhostname\(dq: \(dqmyhost.example.com.\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
ساختار پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqarguments\(dq: {
    \(dqleases\(dq: [
      {
        \(dqcltt\(dq: 1600439560,
        \(dqduid\(dq: \(dq00:01:00:01:26:f7:81:88:00:0c:01:02:03:04\(dq,
        \(dqfqdn\-fwd\(dq: false,
        \(dqfqdn\-rev\(dq: false,
        \(dqhostname\(dq: \(dqfoobar.example.org\(dq,
        \(dqhw\-address\(dq: \(dq00:0c:01:02:03:04\(dq,
        \(dqiaid\(dq: 1,
        \(dqip\-address\(dq: \(dq2001:db8:1::\(dq,
        \(dqpreferred\-lft\(dq: 3000,
        \(dqstate\(dq: 0,
        \(dqsubnet\-id\(dq: 1,
        \(dqtype\(dq: \(dqIA_NA\(dq,
        \(dqvalid\-lft\(dq: 4000
      }
    ]
  },
  \(dqresult\(dq: 0,
  \(dqtext\(dq: \(dq1 IPv6 lease(s) found.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه 0 هنگامی بازگردانده می‌شود که دست‌کم یک اجاره پیدا شود، 1 هنگامی که پارامترها ناقص یا نادرست باشند،
و در صورتی که هیچ اجاره‌ای با پارامتر مشخص‌شده یافت نشود، 3 بازگردانده می‌شود..SS lease6\-get\-by\-hw\-address
.sp
این دستور تمامی اجاره‌های IPv6 با آدرس سخت‌افزاری مشخص‌شده را بازیابی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس بودن: 3.1.1 (کتابخانه قلاب lease_cmds)
.sp
سطح دسترسی: read \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور lease6\-get\-by\-hw\-address را ببینید \%<#\:command-lease6-get-by-hw-address>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqlease6\-get\-by\-hw\-address\(dq,
    \(dqarguments\(dq: {
        \(dqhw\-address\(dq: \(dq00:0c:01:02:03:04\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqarguments\(dq: {
    \(dqleases\(dq: [
      {
        \(dqcltt\(dq: 1600439560,
        \(dqduid\(dq: \(dq00:01:00:01:26:f7:81:88:00:0c:01:02:03:04\(dq,
        \(dqfqdn\-fwd\(dq: false,
        \(dqfqdn\-rev\(dq: false,
        \(dqhostname\(dq: \(dqfoobar.example.org\(dq,
        \(dqhw\-address\(dq: \(dq00:0c:01:02:03:04\(dq,
        \(dqiaid\(dq: 1,
        \(dqip\-address\(dq: \(dq2001:db8:1::\(dq,
        \(dqpreferred\-lft\(dq: 3000,
        \(dqstate\(dq: 0,
        \(dqsubnet\-id\(dq: 1,
        \(dqtype\(dq: \(dqIA_NA\(dq,
        \(dqvalid\-lft\(dq: 4000
      }
    ]
  },
  \(dqresult\(dq: 0,
  \(dqtext\(dq: \(dq1 IPv6 lease(s) found.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
در صورت یافتن حداقل یک اجاره نتیجه 0، در صورت معیوب بودن یا مفقود بودن پارامترها 1،
و در صورت پیدا نشدن هیچ اجاره‌ای 3 بازگردانده می‌شود.
.SS lease6\-get\-by\-state
.INDENT 0.0
.TP
.B این دستور تمامی اجاره‌های IPv6 با وضعیت مشخص‌شده را بازیابی می‌کند
و به صورت اختیاری درون یک زیرشبکه.
.UNINDENT
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس بودن: 3.1.5 (کتابخانه قلاب lease_cmds)
.sp
سطح دسترسی: read \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور lease6\-get\-by\-state را ببینید \%<#\:command-lease6-get-by-state>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqlease6\-get\-by\-state\(dq,
    \(dqarguments\(dq: {
        \(dqstate\(dq: \(dqregistered\(dq,
        \(dqsubnet\-id\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqarguments\(dq: {
    \(dqleases\(dq: [
      {
        \(dqcltt\(dq: 1600439560,
        \(dqduid\(dq: \(dq00:01:00:01:26:f7:81:88:00:0c:01:02:03:04\(dq,
        \(dqfqdn\-fwd\(dq: false,
        \(dqfqdn\-rev\(dq: false,
        \(dqhostname\(dq: \(dq\(dq,
        \(dqhw\-address\(dq: \(dq00:0c:01:02:03:04\(dq,
        \(dqiaid\(dq: 1,
        \(dqip\-address\(dq: \(dq2001:db8:1::\(dq,
        \(dqpreferred\-lft\(dq: 3000,
        \(dqstate\(dq: 6,
        \(dqsubnet\-id\(dq: 1,
        \(dqtype\(dq: \(dqIA_NA\(dq,
        \(dqvalid\-lft\(dq: 4000
      }
    ]
  },
  \(dqresult\(dq: 0,
  \(dqtext\(dq: \(dq1 IPv6 lease(s) found.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
در صورت یافتن حداقل یک اجاره نتیجه 0، در صورت معیوب بودن یا مفقود بودن پارامترها 1،
و در صورت پیدا نشدن هیچ اجاره‌ای با پارامتر مشخص‌شده 3 بازگردانده می‌شود..SS lease6\-get\-page
.sp
این فرمان تمام اجاره‌های IPv6 را به صورت صفحه‌بندی‌شده بازیابی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس از: 1.5.0 (کتابخانه قلاب lease_cmds)
.sp
دسترسی: read \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: فرمان lease6\-get\-page را ببینید \%<#\:command-lease6-get-page>
.sp
نحو فرمان:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqlease6\-get\-page\(dq,
    \(dqarguments\(dq: {
        \(dqlimit\(dq: <integer>,
        \(dqfrom\(dq: <IPv6 address or \(aqstart\(aq>
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
آدرس from و محدودیت اندازه صفحه (limit) الزامی هستند.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
  {
    \(dqarguments\(dq: {
      \(dqleases\(dq: [
        {
          \(dqcltt\(dq: 1600439560,
          \(dqduid\(dq: \(dq00:01:00:01:26:f7:81:88:00:0c:01:02:03:04\(dq,
          \(dqfqdn\-fwd\(dq: false,
          \(dqfqdn\-rev\(dq: false,
          \(dqhostname\(dq: \(dqfoo.example.org\(dq,
          \(dqhw\-address\(dq: \(dq00:0c:01:02:03:04\(dq,
          \(dqiaid\(dq: 1,
          \(dqip\-address\(dq: \(dq2001:db8:1::1\(dq,
          \(dqpreferred\-lft\(dq: 3000,
          \(dqstate\(dq: 0,
          \(dqsubnet\-id\(dq: 1,
          \(dqtype\(dq: \(dqIA_NA\(dq,
          \(dqvalid\-lft\(dq: 4000
        },
        {
          \(dqcltt\(dq: 1600439570,
          \(dqduid\(dq: \(dq00:01:00:01:26:f7:81:88:00:0c:01:02:03:05\(dq,
          \(dqfqdn\-fwd\(dq: false,
          \(dqfqdn\-rev\(dq: false,
          \(dqhostname\(dq: \(dqbar.example.org\(dq,
          \(dqhw\-address\(dq: \(dq00:0c:01:02:03:05\(dq,
          \(dqiaid\(dq: 1,
          \(dqip\-address\(dq: \(dq2001:db8:1::2\(dq,
          \(dqpreferred\-lft\(dq: 3000,
          \(dqstate\(dq: 0,
          \(dqsubnet\-id\(dq: 1,
          \(dqtype\(dq: \(dqIA_NA\(dq,
          \(dqvalid\-lft\(dq: 4000
        }
      ]
    },
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq1 IPv6 lease(s) found.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه 0 زمانی بازگردانده می‌شود که حداقل یک اجاره پیدا شود، 1 زمانی که پارامترها نامعتبر بوده یا وجود نداشته باشند، و 3 در صورتی که هیچ اجاره‌ای پیدا نشود بازگردانده می‌شود.
.SS lease6\-resend\-ddns
.sp
این فرمان درخواستی را جهت به‌روزرسانی DNS برای یک اجاره موجود، مجدداً به kea\-dhcp\-ddns ارسال می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس از: 1.7.6 (کتابخانه قلاب lease_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: فرمان lease6\-resend\-ddns را ببینید \%<#\:command-lease6-resend-ddns>
.sp
نحو فرمان:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqlease6\-resend\-ddns\(dq,
    \(dqarguments\(dq: {
        \(dqip\-address\(dq: \(dq2001:db8::1\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqarguments\(dq: {
  },
  \(dqresult\(dq: 0,
  \(dqtext\(dq: \(dqNCR generated for: 2001:db8::1, hostname: example.com.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
فرمان lease6\-resend\-ddns نتیجه‌ای را بازمی‌گرداند که بیانگر وضعیت عملیات و در صورت یافت شدن، جزئیات اجاره است. این نتیجه یکی از مقادیر زیر را دارد: 0 (موفقیت)، 1 (خطا)، یا 3 (خالی)..SS lease6\-update
.sp
این دستور اجاره‌های موجود را به‌روزرسانی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس بودن: 1.3.0 (کتابخانه قلاب lease_cmds)
.sp
دسترسی: write \fI(پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور lease6\-update را ببینید \%<#\:command-lease6-update>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqcommand\(dq: \(dqlease6\-update\(dq,
  \(dqarguments\(dq: {
    \(dqip\-address\(dq: \(dq2001:db8::1\(dq,
    \(dqduid\(dq: \(dq88:88:88:88:88:88:88:88\(dq,
    \(dqiaid\(dq: 7654321,
    \(dqhostname\(dq: \(dqnewhostname.example.org\(dq,
    \(dqsubnet\-id\(dq: 66,
    \(dqforce\-create\(dq: false
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: \(dq<string>\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر نتیجه بازگردانده‌شده برابر با 4 باشد، نشان می‌دهد که اجاره به دلیل تعارض با وضعیت سرور یا درک آن از پیکربندی، نتوانسته است به‌روزرسانی شود. کتابخانه قلاب High Availability می‌تواند با چنین نتیجه‌ای متفاوت از یک خطای عمومی رفتار کند. یک خطای عمومی 1 می‌تواند نشان‌دهنده مشکلاتی در پردازش دستور، در دسترس بودن پایگاه داده و غیره باشد.
.SS lease6\-wipe
.sp
این دستور تمام اجاره‌های مرتبط با یک زیرشبکه مشخص را حذف می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس بودن: 1.3.0 (کتابخانه قلاب lease_cmds)
.sp
دسترسی: write \fI(پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور lease6\-wipe را ببینید \%<#\:command-lease6-wipe>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqcommand\(dq: \(dqlease6\-wipe\(dq,
  \(dqarguments\(dq: {
    \(dqsubnet\-id\(dq: 66
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
نکته: همه backendها از این دستور پشتیبانی نمی‌کنند.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: \(dq<string>\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه، نمایشی از وضعیت در قالب عدد صحیح است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت
.IP \(bu 2
1 \- خطا
.IP \(bu 2
2 \- پشتیبانی‌نشده
.IP \(bu 2
3 \- خالی (دستور با موفقیت انجام شد، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (دستور نتوانست تغییرات پیکربندی درخواست‌شده را اعمال کند زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT
.SS lease6\-write
.sp
این دستور پایگاه داده اجاره memfile مربوط به IPv6 را درون یک فایل CSV می‌نویسد.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس بودن: 2.3.1 (کتابخانه قلاب lease_cmds)
.sp
دسترسی: write \fI(پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور lease6\-write را ببینید \%<#\:command-lease6-write>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqlease6\-write\(dq,
    \(dqarguments\(dq: {
        \(dqfilename\(dq: \(dqa_file.csv\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: \(dq<string>\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه، نمایشی از وضعیت در قالب عدد صحیح است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت
.IP \(bu 2
1 \- خطا
.IP \(bu 2
2 \- پشتیبانی‌نشده
.IP \(bu 2
3 \- خالی (دستور با موفقیت انجام شد، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (دستور نتوانست تغییرات پیکربندی درخواست‌شده را اعمال کند زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT.SS leases\-reclaim
.sp
این دستور به سرور اعلام می‌کند که تمامی اجاره‌های منقضی‌شده را فوراً بازپس گیرد.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4, kea\-dhcp6
.sp
در دسترس بودن: 1.0.0 (توکار)
.sp
دسترسی: write \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور leases\-reclaim را ببینید \%<#\:command-leases-reclaim>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqleases\-reclaim\(dq,
    \(dqarguments\(dq: {
        \(dqremove\(dq: true
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: \(dq<string>\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه، یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت
.IP \(bu 2
1 \- خطا
.IP \(bu 2
2 \- پشتیبانی‌نشده
.IP \(bu 2
3 \- خالی (دستور با موفقیت به پایان رسید، اما هیچ داده‌ای تغییر نیافت یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تداخل بود)
.UNINDENT
.SS list\-commands
.sp
این دستور فهرستی از تمام دستورات پشتیبانی‌شده توسط سرور را بازیابی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp\-ddns, kea\-dhcp4, kea\-dhcp6
.sp
در دسترس بودن: 1.0.0 (توکار)
.sp
دسترسی: read \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور list\-commands را ببینید \%<#\:command-list-commands>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqlist\-commands\(dq,
    \(dqarguments\(dq: { }
}
.EE
.UNINDENT
.UNINDENT
.sp
سرور با فهرستی از تمام دستورات پشتیبانی‌شده پاسخ می‌دهد.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: \(dq<string>\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه، یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت
.IP \(bu 2
1 \- خطا
.IP \(bu 2
2 \- پشتیبانی‌نشده
.IP \(bu 2
3 \- خالی (دستور با موفقیت به پایان رسید، اما هیچ داده‌ای تغییر نیافت یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تداخل بود)
.UNINDENT
.SS network4\-add
.sp
این دستور یک شبکه اشتراکی (shared network) جدید اضافه می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس بودن: 1.3.0 (کتابخانه هوک subnet_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور network4\-add را ببینید \%<#\:command-network4-add>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqnetwork4\-add\(dq,
    \(dqarguments\(dq: {
        \(dqshared\-networks\(dq: [ {
            \(dqname\(dq: \(dqfloor13\(dq,
            \(dqsubnet4\(dq: [
            {
                \(dqid\(dq: 100,
                \(dqpools\(dq: [ { \(dqpool\(dq: \(dq192.0.2.2\-192.0.2.99\(dq } ],
                \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
                \(dqoption\-data\(dq: [
                    {
                        \(dqname\(dq: \(dqrouters\(dq,
                        \(dqdata\(dq: \(dq192.0.2.1\(dq
                    }
                ]
            },
            {
                \(dqid\(dq: 101,
                \(dqpools\(dq: [ { \(dqpool\(dq: \(dq192.0.3.2\-192.0.3.99\(dq } ],
                \(dqsubnet\(dq: \(dq192.0.3.0/24\(dq,
                \(dqoption\-data\(dq: [
                    {
                        \(dqname\(dq: \(dqrouters\(dq,
                        \(dqdata\(dq: \(dq192.0.3.1\(dq
                    }
                ]
            } ]
        } ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqarguments\(dq: {
        \(dqshared\-networks\(dq: [ { \(dqname\(dq: \(dqfloor13\(dq } ]
    },
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqA new IPv4 shared network \(aqfloor13\(aq added\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه، یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت
.IP \(bu 2
1 \- خطا
.IP \(bu 2
2 \- پشتیبانی‌نشده
.IP \(bu 2
3 \- خالی (دستور با موفقیت به پایان رسید، اما هیچ داده‌ای تغییر نیافت یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تداخل بود)
.UNINDENT.SS network4\-del
.sp
این دستور شبکه‌های اشتراکی موجود را حذف می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
دسترس‌پذیری: 1.3.0 (کتابخانه قلاب subnet_cmds)
.sp
دسترسی: write \fI(پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور network4\-del را ببینید \%<#\:command-network4-del>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqnetwork4\-del\(dq,
    \(dqarguments\(dq: {
        \(dqname\(dq: \(dqfloor13\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqnetwork4\-del\(dq,
    \(dqarguments\(dq: {
        \(dqshared\-networks\(dq: [
            {
                \(dqname\(dq: \(dqfloor13\(dq
            }
        ]
    },
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqIPv4 shared network \(aqfloor13\(aq deleted\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌های پشتیبانی‌شده کنونی عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت
.IP \(bu 2
1 \- خطا
.IP \(bu 2
2 \- پشتیبانی‌نشده
.IP \(bu 2
3 \- خالی (دستور با موفقیت کامل شد، اما هیچ داده‌ای تغییر نکرد یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تداخل بودند)
.UNINDENT
.SS network4\-get
.sp
این دستور اطلاعات تفصیلی درباره شبکه‌های اشتراکی، از جمله زیرشبکه‌هایی که در حال حاضر بخشی از یک شبکه معین هستند را بازیابی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
دسترس‌پذیری: 1.3.0 (کتابخانه قلاب subnet_cmds)
.sp
دسترسی: read \fI(پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور network4\-get را ببینید \%<#\:command-network4-get>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqnetwork4\-get\(dq,
    \(dqarguments\(dq: {
        \(dqname\(dq: \(dqfloor13\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqInfo about IPv4 shared network \(aqfloor13\(aq returned\(dq,
    \(dqarguments\(dq: {
        \(dqshared\-networks\(dq: [
        {
            \(dqmatch\-client\-id\(dq: true,
            \(dqname\(dq: \(dqfloor13\(dq,
            \(dqoption\-data\(dq: [ ],
            \(dqrebind\-timer\(dq: 90,
            \(dqrelay\(dq: {
                \(dqip\-address\(dq: \(dq0.0.0.0\(dq
            },
            \(dqrenew\-timer\(dq: 60,
            \(dqsubnet4\(dq: [
                {
                    \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
                    \(dqid\(dq: 5,
                    <many other subnet specific details here>
                },
                {
                    \(dqsubnet\(dq: \(dq192.0.3.0/31\(dq,
                    \(dqid\(dq: 6,
                    <many other subnet specific details here>
                }
            ],
            \(dqvalid\-lifetime\(dq: 120
        }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
توجه داشته باشید که پاسخ واقعی شامل فیلدهای اضافی متعددی است که جهت شفافیت در اینجا حذف شده‌اند..SS network4\-list
.sp
این دستور فهرست کامل شبکه‌های مشترک (shared networks) پیکربندی‌شده کنونی را دریافت می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس در: 1.3.0 (کتابخانه قلاب subnet_cmds)
.sp
دسترسی: خواندن \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور network4\-list را ببینید \%<#\:command-network4-list>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqnetwork4\-list\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqarguments\(dq: {
        \(dqshared\-networks\(dq: [
            { \(dqname\(dq: \(dqfloor1\(dq },
            { \(dqname\(dq: \(dqoffice\(dq }
        ]
    },
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq2 IPv4 network(s) found\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک مقدار عددی صحیح نشان‌دهنده وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (دستور با موفقیت انجام شد، اما هیچ داده‌ای تغییر نکرد یا برگردانده نشد)
.IP \(bu 2
4 \- تعارض (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تعارض بود)
.UNINDENT
.SS network4\-subnet\-add
.sp
این دستور زیرشبکه‌های موجود را به شبکه‌های مشترک موجود اضافه می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس در: 1.3.0 (کتابخانه قلاب subnet_cmds)
.sp
دسترسی: نوشتن \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور network4\-subnet\-add را ببینید \%<#\:command-network4-subnet-add>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqnetwork4\-subnet\-add\(dq,
    \(dqarguments\(dq: {
        \(dqname\(dq: \(dqfloor13\(dq,
        \(dqid\(dq: 5
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqIPv4 subnet 10.0.0.0/8 (id 5) is now part of shared network \(aqfloor1\(aq\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک مقدار عددی صحیح نشان‌دهنده وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (دستور با موفقیت انجام شد، اما هیچ داده‌ای تغییر نکرد یا برگردانده نشد)
.IP \(bu 2
4 \- تعارض (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تعارض بود)
.UNINDENT
.SS network4\-subnet\-del
.sp
این دستور زیرشبکه‌ای را که بخشی از یک شبکه مشترک موجود است حذف کرده و آن را به یک زیرشبکه ساده و مستقل تنزل می‌دهد.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس در: 1.3.0 (کتابخانه قلاب subnet_cmds)
.sp
دسترسی: نوشتن \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور network4\-subnet\-del را ببینید \%<#\:command-network4-subnet-del>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqnetwork4\-subnet\-del\(dq,
    \(dqarguments\(dq: {
        \(dqname\(dq: \(dqfloor13\(dq,
        \(dqid\(dq: 5
    }
 }
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqIPv4 subnet 10.0.0.0/8 (id 5) is now removed from shared network \(aqfloor13\(aq\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک مقدار عددی صحیح نشان‌دهنده وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (دستور با موفقیت انجام شد، اما هیچ داده‌ای تغییر نکرد یا برگردانده نشد)
.IP \(bu 2
4 \- تعارض (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تعارض بود)
.UNINDENT.SS network6\-add
.sp
این دستور یک شبکه اشتراکی جدید اضافه می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
دردسترس از: 1.3.0 (کتابخانه قلاب subnet_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور network6\-add را ببینید \%<#\:command-network6-add>
.sp
ساختار دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqnetwork6\-add\(dq,
    \(dqarguments\(dq: {
        \(dqshared\-networks\(dq: [ {
            \(dqname\(dq: \(dqfloor13\(dq,
            \(dqsubnet6\(dq: [
            {
                \(dqid\(dq: 100,
                \(dqpools\(dq: [ { \(dqpool\(dq: \(dq2003:db8:1::1\-2003:db8:1::ff\(dq } ],
                \(dqsubnet\(dq: \(dq2003:db8:1::/64\(dq,
                \(dqoption\-data\(dq: [
                    {
                        \(dqname\(dq: \(dqdns\-servers\(dq,
                        \(dqdata\(dq: \(dq2005:db8:1::1\(dq
                    }
                ]
            },
            {
                \(dqid\(dq: 101,
                \(dqpools\(dq: [ { \(dqpool\(dq: \(dq2003:db8:2::1\-2003:db8:2::ff\(dq } ],
                \(dqsubnet\(dq: \(dq2003:db8:2::/64\(dq,
                \(dqoption\-data\(dq: [
                    {
                        \(dqname\(dq: \(dqdns\-servers\(dq,
                        \(dqdata\(dq: \(dq2006:db8:1::1\(dq
                    }
                ]
            } ]
        } ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
ساختار پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqarguments\(dq: {
        \(dqshared\-networks\(dq: [ { \(dqname\(dq: \(dqfloor13\(dq } ]
    },
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqA new IPv6 shared network \(aqfloor13\(aq added\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه (Result) نمایشی عددی صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت به پایان رسید، اما هیچ داده‌ای تغییر نکرد یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (conflict) (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تداخل بودند)
.UNINDENT
.SS network6\-del
.sp
این دستور شبکه‌های اشتراکی موجود را حذف می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
دردسترس از: 1.3.0 (کتابخانه قلاب subnet_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور network6\-del را ببینید \%<#\:command-network6-del>
.sp
ساختار دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqnetwork6\-del\(dq,
    \(dqarguments\(dq: {
        \(dqname\(dq: \(dqfloor13\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
ساختار پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqnetwork6\-del\(dq,
    \(dqarguments\(dq: {
        \(dqshared\-networks\(dq: [
            {
                \(dqname\(dq: \(dqfloor13\(dq
            }
        ]
    },
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqIPv6 shared network \(aqfloor13\(aq deleted\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه (Result) نمایشی عددی صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت به پایان رسید، اما هیچ داده‌ای تغییر نکرد یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (conflict) (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تداخل بودند)
.UNINDENT.SS network6\-get
.sp
این دستور اطلاعات دقیقی را درباره شبکه‌های اشتراکی (shared networks)، از جمله زیرشبکه‌هایی که در حال حاضر بخشی از یک شبکه مشخص هستند، بازیابی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس بودن: 1.3.0 (کتابخانه قلاب subnet_cmds)
.sp
دسترسی: read \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور network6\-get را ببینید \%<#\:command-network6-get>
.sp
ساختار دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqnetwork4\-get\(dq,
    \(dqarguments\(dq: {
        \(dqname\(dq: \(dqfloor13\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
ساختار پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqInfo about IPv6 shared network \(aqfloor13\(aq returned\(dq,
    \(dqarguments\(dq: {
        \(dqshared\-networks\(dq: [
        {
            \(dqmatch\-client\-id\(dq: true,
            \(dqname\(dq: \(dqfloor13\(dq,
            \(dqoption\-data\(dq: [ ],
            \(dqrebind\-timer\(dq: 90,
            \(dqrelay\(dq: {
                \(dqip\-address\(dq: \(dq::\(dq
            },
            \(dqrenew\-timer\(dq: 60,
            \(dqsubnet6\(dq: [
                {
                    \(dqsubnet\(dq: \(dq2003:db8:1::/64\(dq,
                    \(dqid\(dq: 5,
                    <many other subnet specific details here>
                },
                {
                    \(dqsubnet\(dq: \(dq2003:db8:2::/71\(dq,
                    \(dqid\(dq: 6,
                    <many other subnet specific details here>
                }
            ],
            \(dqvalid\-lifetime\(dq: 120
        }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
توجه داشته باشید که پاسخ واقعی شامل فیلدهای اضافی متعددی است که در اینجا برای وضوح بیشتر حذف شده‌اند.
.SS network6\-list
.sp
این دستور فهرست کامل شبکه‌های اشتراکی پیکربندی‌شده فعلی را بازیابی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس بودن: 1.3.0 (کتابخانه قلاب subnet_cmds)
.sp
دسترسی: read \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور network6\-list را ببینید \%<#\:command-network6-list>
.sp
ساختار دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqnetwork6\-list\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
ساختار پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqarguments\(dq: {
        \(dqshared\-networks\(dq: [
            { \(dqname\(dq: \(dqfloor1\(dq },
            { \(dqname\(dq: \(dqoffice\(dq }
        ]
    },
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq2 IPv6 network(s) found\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه (Result) نمایشی از وضعیت در قالب عدد صحیح است. وضعیت‌های پشتیبانی‌شده فعلی عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت
.IP \(bu 2
1 \- خطا
.IP \(bu 2
2 \- پشتیبانی‌نشده
.IP \(bu 2
3 \- خالی (دستور با موفقیت انجام شد، اما هیچ داده‌ای تغییر نکرد یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (دستور نتوانست تغییرات درخواستی در پیکربندی را اعمال کند زیرا با وضعیت سرور تداخل داشت)
.UNINDENT.SS network6\-subnet\-add
.sp
این دستور زیرشبکه‌های موجود را به شبکه‌های اشتراکی موجود اضافه می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس بودن: 1.3.0 (کتابخانه قلاب subnet_cmds)
.sp
دسترسی: write \fI(پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور network6\-subnet\-add را ببینید \%<#\:command-network6-subnet-add>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqnetwork6\-subnet\-add\(dq,
    \(dqarguments\(dq: {
        \(dqname\(dq: \(dqfloor13\(dq,
        \(dqid\(dq: 5
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqIPv6 subnet 2003:db8::/64 (id 5) is now part of shared network \(aqfloor1\(aq\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت
.IP \(bu 2
1 \- خطا
.IP \(bu 2
2 \- پشتیبانی‌نشده
.IP \(bu 2
3 \- خالی (دستور با موفقیت انجام شد، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT
.SS network6\-subnet\-del
.sp
این دستور یک زیرشبکه را که بخشی از یک شبکهٔ اشتراکی موجود است حذف کرده و آن را به یک زیرشبکهٔ ساده و مستقل تنزل می‌دهد.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس بودن: 1.3.0 (کتابخانه قلاب subnet_cmds)
.sp
دسترسی: write \fI(پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور network6\-subnet\-del را ببینید \%<#\:command-network6-subnet-del>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqnetwork6\-subnet\-del\(dq,
    \(dqarguments\(dq: {
        \(dqname\(dq: \(dqfloor13\(dq,
        \(dqid\(dq: 5
    }
 }
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqIPv6 subnet 2003:db8::/64 (id 5) is now removed from shared network \(aqfloor13\(aq\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت
.IP \(bu 2
1 \- خطا
.IP \(bu 2
2 \- پشتیبانی‌نشده
.IP \(bu 2
3 \- خالی (دستور با موفقیت انجام شد، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT
.SS perfmon\-control
.sp
این دستور پایش فعال و گزارش‌دهی آمار را فعال/غیرفعال می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4، kea\-dhcp6
.sp
در دسترس بودن: 2.7.0 (کتابخانه قلاب perfmon)
.sp
دسترسی: write \fI(پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور perfmon\-control را ببینید \%<#\:command-perfmon-control>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqcommand\(dq: \(dqperfmon\-control\(dq,
  \(dqarguments\(dq: {
    \(dqenable\-monitoring\(dq: true,
    \(dqstats\-mgr\-reporting\(dq: false
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqarguments\(dq: {
     \(dqenable\-monitoring\(dq: true,
     \(dqstats\-mgr\-reporting\(dq: false
  },
  \(dqresult\(dq: 0,
  \(dqtext\(dq: \(dqperfmon\-control success.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
در صورت موفقیت دستور، نتیجهٔ 0 همراه با مقادیر حاصل از هر دو پرچم بازگردانده می‌شود.
هنگامی که پارامترها ساختار نادرستی داشته یا مفقود باشند، نتیجه 1 است..SS perfmon\-get\-all\-durations
.sp
این دستور تمام داده‌های مدت‌زمان پایش‌شده را که در حال حاضر توسط Perfmon نگهداری می‌شوند، واکشی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4، kea\-dhcp6
.sp
در دسترس بودن: 2.7.0 (کتابخانه هوک perfmon)
.sp
دسترسی: write \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور perfmon\-get\-all\-durations را ببینید \%<#\:command-perfmon-get-all-durations>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqcommand\(dq: \(dqperfmon\-get\-all\-durations\(dq,
  \(dqarguments\(dq: {
    \(dqresult\-set\-format\(dq: true
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
اگر result\-set\-format برابر با false باشد، خروجی به صورت زیر خواهد بود:
{
   \(dqarguments\(dq: {
       \(dqdurations\(dq: [{
           \(dqduration\-key\(dq: {
               \(dqquery\-type\(dq: \(dqDHCPDISCOVER\(dq,
               \(dqresponse\-type\(dq: \(dqDHCPOFFER\(dq,
               \(dqstart\-event\(dq: \(dqbuffer_read\(dq,
               \(dqstop\-event\(dq: \(dqmt_queued\(dq,
               \(dqsubnet\-id\(dq: 0
           },
           \(dqmax\-duration\-usecs\(dq: 118,
           \(dqmean\-duration\-usecs\(dq: 47,
           \(dqmin\-duration\-usecs\(dq: 31,
           \(dqoccurrences\(dq: 501,
           \(dqstart\-time\(dq: \(dq2024\-06\-12 17:52:06.814884\(dq,
           \(dqtotal\-duration\-usecs\(dq: 23951
       },
       ...
       ],
       \(dqresult\-set\-format\(dq: false,
       \(dqinterval\-width\-secs\(dq: 5,
       \(dqtimestamp\(dq: \(dq2024\-06\-12 17:52:22.397233\(dq
   },
   \(dqresult\(dq: 0,
   \(dqtext\(dq: \(dqperfmon\-get\-all\-durations: n found\(dq
}
اگر result\-set\-format برابر با true باشد، خروجی به صورت زیر خواهد بود:
{
   \(dqarguments\(dq: {
       \(dqdurations\-result\-set\(dq: {
           \(dqcolumns\(dq: [
               \(dqquery\-type\(dq,
               \(dqresponse\-type\(dq,
               \(dqstart\-event\(dq,
               \(dqend\-event\(dq,
               \(dqsubnet\-id\(dq,
               \(dqinterval\-start\(dq,
               \(dqoccurrences\(dq,
               \(dqmin\-duration\-usecs\(dq,
               \(dqmax\-duration\-usecs\(dq,
               \(dqtotal\-duration\-usecs\(dq,
               \(dqmean\-duration\-usecs\(dq
           ],
           \(dqrows\(dq: [
               [
                   \(dqDHCPDISCOVER\(dq,
                   \(dqDHCPOFFER\(dq,
                   \(dqbuffer_read\(dq,
                   \(dqmt_queued\(dq,
                   0,
                   \(dq2024\-06\-12 17:52:06.814884\(dq,
                   501,
                   31,
                   118,
                   23951,
                   47
               ],
               ...
           ]
       },
       \(dqresult\-set\-format\(dq: true,
       \(dqinterval\-width\-secs\(dq: 5,
       \(dqtimestamp\(dq: \(dq2024\-06\-12 17:52:22.397233\(dq
   },
   \(dqresult\(dq: 0,
   \(dqtext\(dq: \(dqperfmon\-get\-all\-durations: n found\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
در صورت موفقیت‌آمیز بودن دستور، نتیجه 0 همراه با داده‌های مدت‌زمان پایش‌شده بازگردانده می‌شود.
اگر دستور نامعتبر باشد یا پردازش دستور با خطا مواجه شود، نتیجه 1 خواهد بود.
.SS remote\-class4\-del
.sp
این دستور یک کلاس کلاینت DHCPv4 را از پایگاه‌داده پیکربندی حذف می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس بودن: 1.9.10 (کتابخانه هوک cb_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-class4\-del را ببینید \%<#\:command-remote-class4-del>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-class4\-del\(dq,
    \(dqarguments\(dq: {
        \(dqclient\-classes\(dq: [
            {
                \(dqname\(dq: <client class name>
            }
        ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور شامل فهرستی با دقیقاً یک نام از کلاس کلاینت مورد نظر برای حذف است. پارامتر \fBserver\-tags\fP نباید برای این دستور مشخص شود.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq1 DHCPv4 client class(es) deleted.\(dq,
    \(dqarguments\(dq: {
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت
.IP \(bu 2
1 \- خطا
.IP \(bu 2
2 \- پشتیبانی‌نشده
.IP \(bu 2
3 \- خالی (دستور با موفقیت انجام شد، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT.SS remote\-class4\-get
.sp
این دستور یک کلاس کلاینت DHCPv4 انتخاب‌شده را بر اساس نام از پایگاه‌داده مشخص‌شده واکشی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس از: 1.9.10 (کتابخانه هوک cb_cmds)
.sp
دسترسی: read \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-class4\-get را ببینید \%<#\:command-remote-class4-get>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-class4\-get\(dq,
    \(dqarguments\(dq: {
        \(dqclient\-classes\(dq: [
            {
                \(dqname\(dq: <client class name>
            }
        ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور شامل فهرستی با دقیقاً یک نام از کلاس کلاینت برای بازگردانی است. پارامتر \fBserver\-tags\fP نباید برای این دستور مشخص شود.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqDHCPv4 client class found.\(dq,
    \(dqarguments\(dq: {
        \(dqclient\-classes\(dq: [
            {
                \(dqname\(dq: <client class name>,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ <first server tag>, <second server tag>, ... ]
                },
                <the rest of the client class information>
            }
        ],
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
ابرداده (metadata) در تعریف شبکه مشترک بازگردانده‌شده گنجانده شده است و اطلاعات مختص پایگاه‌داده مرتبط با شیء بازگردانده‌شده را ارائه می‌دهد.
.SS remote\-class4\-get\-all
.sp
این دستور تمام کلاس‌های کلاینت DHCPv4 را برای سرورهای مشخص‌شده از پایگاه‌داده پیکربندی واکشی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس از: 1.9.10 (کتابخانه هوک cb_cmds)
.sp
دسترسی: read \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-class4\-get\-all را ببینید \%<#\:command-remote-class4-get-all>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-class4\-get\-all\(dq,
    \(dqarguments\(dq: {
        \(dqremote\(dq: {
            <specification of the database to connect to>
        },
        \(dqserver\-tags\(dq: [ <first server tag>, <second server tag>, ... ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
فهرست \fBserver\-tags\fP برای این دستور الزامی است و نباید خالی باشد.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq2 DHCPv4 client class(es) found.\(dq,
    \(dqarguments\(dq: {
        \(dqclient\-classes\(dq: [
            {
                <first client class specification>,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ <first server tag>, <second server tag>, ... ]
                }
            },
            {
                <second client class specification>,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ <first server tag>, ... ]
                }
            }
        ],
        \(dqcount\(dq: 2
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ بازگردانده‌شده شامل فهرستی از نگاشت‌ها (maps) است. هر نگاشت شامل یک نام کلاس کلاینت و ابرداده (metadata) است که اطلاعات مختص پایگاه‌داده مرتبط با کلاس کلاینت را ارائه می‌دهد..SS remote\-class4\-set
.sp
این دستور یک کلاس کلاینت DHCPv4 را در پایگاه‌داده پیکربندی ایجاد کرده یا جایگزین می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس بودن: 1.9.10 (کتابخانه هوک cb_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-class4\-set را ببینید \%<#\:command-remote-class4-set>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-class4\-set\(dq,
    \(dqarguments\(dq: {
        \(dqclient\-class\(dq: [
            {
                <client class specification>,
                \(dqfollow\-class\-name\(dq: <existing class name>
            }
        ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        },
        \(dqserver\-tags\(dq: [ <first server tag>, <second server tag>, ... ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
فهرست ارائه‌شده باید دقیقاً شامل مشخصات یک کلاس کلاینت باشد. این فهرست می‌تواند حاوی پارامتر اختیاری \(dqfollow\-class\-name\(dq باشد که می‌تواند نام یک کلاس موجود را مشخص کند تا نشان دهد کلاسی که از دستور آمده است، در سلسله‌مراتب دقیقاً پس از این کلاس موجود قرار می‌گیرد. این پارامتر می‌تواند حذف شود یا روی \(dqnull\(dq تنظیم گردد تا مشخص کند کلاس کلاینت جدید باید به انتهای سلسله‌مراتب افزوده شود یا کلاس به‌روزشده در موقعیت فعلی خود باقی بماند. فهرست \fBserver\-tags\fP الزامی است و باید شامل یک یا چند برچسب سرور به‌صورت رشته باشد تا کلاس کلاینت را صراحتاً به یک یا چند سرور تعریف‌شده توسط کاربر مرتبط کند. این فهرست می‌تواند شامل برچسب سرور ویژه \(dqall\(dq باشد تا کلاس را با تمام سرورها مرتبط سازد.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqDHCPv4 shared network successfully set.\(dq,
    \(dqarguments\(dq: {
        \(dqclient\-classes\(dq: [
            {
                \(dqname\(dq: <set client class name>
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت
.IP \(bu 2
1 \- خطا
.IP \(bu 2
2 \- پشتیبانی‌نشده
.IP \(bu 2
3 \- خالی (دستور با موفقیت تکمیل شد، اما هیچ داده‌ای تغییر نکرد یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند، زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT
.SS remote\-class6\-del
.sp
این دستور یک کلاس کلاینت DHCPv6 را از پایگاه‌داده پیکربندی حذف می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس بودن: 1.9.10 (کتابخانه هوک cb_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-class6\-del را ببینید \%<#\:command-remote-class6-del>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-class6\-del\(dq,
    \(dqarguments\(dq: {
        \(dqclient\-classes\(dq: [
            {
                \(dqname\(dq: <client class name>
            }
        ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور شامل فهرستی با دقیقاً یک نام از کلاس کلاینتی است که باید حذف شود. پارامتر \fBserver\-tags\fP نباید برای این دستور مشخص شود.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq1 DHCPv6 client class(es) deleted.\(dq,
    \(dqarguments\(dq: {
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت
.IP \(bu 2
1 \- خطا
.IP \(bu 2
2 \- پشتیبانی‌نشده
.IP \(bu 2
3 \- خالی (دستور با موفقیت تکمیل شد، اما هیچ داده‌ای تغییر نکرد یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند، زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT.SS remote\-class6\-get
.sp
این فرمان یک کلاس کلاینت DHCPv6 انتخاب‌شده را بر اساس نام از پایگاه‌داده مشخص‌شده واکشی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس بودن: 1.9.10 (کتابخانه قلاب cb_cmds)
.sp
دسترسی: read \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: به فرمان remote\-class6\-get رجوع کنید \%<#\:command-remote-class6-get>
.sp
نحو فرمان:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-class6\-get\(dq,
    \(dqarguments\(dq: {
        \(dqclient\-classes\(dq: [
            {
                \(dqname\(dq: <client class name>
            }
        ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این فرمان شامل فهرستی است که دقیقاً یک نام از کلاس کلاینت مورد نظر برای بازگردانی را در بر دارد. پارامتر \fBserver\-tags\fP نباید برای این فرمان مشخص شود.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqDHCPv6 client class found.\(dq,
    \(dqarguments\(dq: {
        \(dqclient\-classes\(dq: [
            {
                \(dqname\(dq: <client class name>,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ <first server tag>, <second server tag>, ... ]
                },
                <the rest of the client class information>
            }
        ],
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
متاداده در تعریف شبکه اشتراکی بازگردانده‌شده گنجانده می‌شود و اطلاعات مختص پایگاه‌داده مرتبط با شیء بازگردانده‌شده را ارائه می‌دهد.
.SS remote\-class6\-get\-all
.sp
این فرمان تمام کلاس‌های کلاینت DHCPv6 را برای کارگزارهای مشخص‌شده از پایگاه‌داده پیکربندی واکشی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس بودن: 1.9.10 (کتابخانه قلاب cb_cmds)
.sp
دسترسی: read \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: به فرمان remote\-class6\-get\-all رجوع کنید \%<#\:command-remote-class6-get-all>
.sp
نحو فرمان:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-class6\-get\-all\(dq,
    \(dqarguments\(dq: {
        \(dqremote\(dq: {
            <specification of the database to connect to>
        },
        \(dqserver\-tags\(dq: [ <first server tag>, <second server tag>, ... ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
فهرست \fBserver\-tags\fP برای این فرمان الزامی است و نباید خالی باشد.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq2 DHCPv6 client class(es) found.\(dq,
    \(dqarguments\(dq: {
        \(dqclient\-classes\(dq: [
            {
                <first client class specification>,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ <first server tag>, <second server tag>, ... ]
                }
            },
            {
                <second client class specification>,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ <first server tag>, ... ]
                }
            }
        ],
        \(dqcount\(dq: 2
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ بازگردانده‌شده حاوی فهرستی از نگاشت‌ها است. هر نگاشت شامل نام یک کلاس کلاینت و متاداده است، که اطلاعات مختص پایگاه‌داده مربوط به کلاس کلاینت را ارائه می‌دهد..SS remote\-class6\-set
.sp
این دستور یک کلاس کلاینت DHCPv6 را در پایگاه‌داده پیکربندی ایجاد کرده یا جایگزین می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس از: 1.9.10 (کتابخانه قلاب cb_cmds)
.sp
سطح دسترسی: write \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-class6\-set را ببینید \%<#\:command-remote-class6-set>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-class6\-set\(dq,
    \(dqarguments\(dq: {
        \(dqclient\-class\(dq: [
            {
                <client class specification>,
                \(dqfollow\-class\-name\(dq: <existing class name>
            }
        ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        },
        \(dqserver\-tags\(dq: [ <first server tag>, <second server tag>, ... ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
فهرست ارائه‌شده باید دقیقاً شامل یک مشخصه کلاس کلاینت باشد. این فهرست می‌تواند شامل پارامتر اختیاری \(dqfollow\-class\-name\(dq باشد که می‌تواند نام یک کلاس موجود را مشخص کند تا نشان دهد کلاس ارائه‌شده در این دستور، دقیقاً پس از این کلاسِ موجود در سلسله‌مراتب قرار می‌گیرد. این پارامتر می‌تواند حذف شود یا روی \(dqnull\(dq تنظیم گردد تا نشان دهد کلاس کلاینت جدید باید به انتهای سلسله‌مراتب اضافه شود یا کلاس به‌روزرسانی‌شده در موقعیت فعلی خود باقی بماند. فهرست \fBserver\-tags\fP اجباری است و باید شامل یک یا چند برچسب کارساز به‌صورت رشته باشد تا کلاس کلاینت را به‌طور صریح به یک یا چند کارساز تعریف‌شده توسط کاربر مرتبط کند. این فهرست می‌تواند شامل برچسب کارساز ویژه \(dqall\(dq باشد تا کلاس را به تمام کارسازها مرتبط سازد.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqDHCPv6 shared network successfully set.\(dq,
    \(dqarguments\(dq: {
        \(dqclient\-classes\(dq: [
            {
                \(dqname\(dq: <set client class name>
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (دستور با موفقیت کامل شد، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت کارساز در تعارض بودند)
.UNINDENT
.SS remote\-global\-parameter4\-del
.sp
این دستور یک پارامتر سراسری DHCPv4 را از پایگاه‌داده پیکربندی حذف می‌کند. کارساز پس از حذف پارامتر از پایگاه‌داده، از مقدار مشخص‌شده در فایل پیکربندی یا در صورت مشخص نبودن پارامتر، از یک مقدار پیش‌فرض استفاده می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس از: 1.6.0 (کتابخانه قلاب cb_cmds)
.sp
سطح دسترسی: write \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-global\-parameter4\-del را ببینید \%<#\:command-remote-global-parameter4-del>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-global\-parameter4\-del\(dq,
    \(dqarguments\(dq: {
        \(dqparameters\(dq: [ <parameter name as string> ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        },
        \(dqserver\-tags\(dq: [ <single server tag as string> ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور فهرستی شامل دقیقاً یک نام از پارامتری که باید حذف شود را در بر دارد. در صورت حذف یک پارامتر نگاشت (map)، باید از قالب \fBmap\-name.parameter\-name\fP استفاده شود. فهرست \fBserver\-tags\fP اجباری است و باید دقیقاً شامل یک برچسب کارساز باشد. مشخص کردن یک فهرست خالی، مقدار \fBnull\fP یا چندین برچسب کارساز منجر به خطا خواهد شد.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqDHCPv4 global parameter(s) deleted.\(dq,
    \(dqarguments\(dq: {
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (دستور با موفقیت کامل شد، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت کارساز در تعارض بودند)
.UNINDENT.SS remote\-global\-parameter4\-get
.sp
این دستور پارامتر سراسری (global parameter) انتخاب‌شده برای سرور را از پایگاه داده مشخص‌شده واکشی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس بودن: 1.6.0 (کتابخانه قلاب cb_cmds)
.sp
دسترسی: خواندن \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: به دستور remote\-global\-parameter4\-get مراجعه کنید \%<#\:command-remote-global-parameter4-get>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-global\-parameter4\-get\(dq,
    \(dqarguments\(dq: {
        \(dqparameters\(dq: [ <parameter name as string> ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        },
        \(dqserver\-tags\(dq: [ <single server tag as string> ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور شامل فهرستی است که دقیقاً نام یک پارامتر را جهت واکشی دربردارد. در صورت بازیابی یک پارامتر نگاشت (map)، باید از قالب \fBmap\-name.parameter\-name\fP استفاده شود. فهرست \fBserver\-tags\fP اجباری است و باید دقیقاً شامل یک برچسب سرور (server tag) باشد. مشخص کردن یک فهرست خالی، مقدار \fBnull\fP، یا چند برچسب سرور منجر به خطا خواهد شد. برچسب سرور \(dqall\(dq مجاز است؛ این برچسب مقدار پارامتر سراسری مشترک بین همه سرورها را واکشی می‌کند.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqDHCPv4 global parameter found.\(dq,
    \(dqarguments\(dq: {
        \(dqparameters\(dq: {
            <parameter name>: <parameter value>,
            \(dqmetadata\(dq: {
                \(dqserver\-tags\(dq: [ <server tag> ]
            }
        },
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ بازگردانده‌شده شامل یک نگاشت با یک جفت نام:مقدار پارامتر سراسری است. مقدار ممکن است یک رشته JSON، عدد صحیح (integer)، عدد حقیقی (real)، بولی (boolean)، فهرستی از این نوع‌های اسکالر یا نگاشتی باشد که تنها شامل یکی از این نوع‌های اسکالر است. متادیتا (metadata) گنجانده شده و اطلاعات خاص پایگاه داده مرتبط با شیء بازگردانده‌شده را ارائه می‌دهد. اگر برچسب سرور \(dqall\(dq مشخص شود، دستور تلاش می‌کند مقدار پارامتر سراسری مرتبط با همه سرورها را واکشی کند. اگر برچسب سرور صریح مشخص شود، دستور مقدار مرتبط با سرور ارائه‌شده را واکشی می‌کند. اگر مقدار مختص سرور وجود نداشته باشد، دستور \fBremote\-global\-parameter4\-get\fP مقدار مرتبط با همه سرورها را واکشی خواهد کرد.
.SS remote\-global\-parameter4\-get\-all
.sp
این دستور تمام پارامترهای سراسری برای سرور را از پایگاه داده مشخص‌شده واکشی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس بودن: 1.6.0 (کتابخانه قلاب cb_cmds)
.sp
دسترسی: خواندن \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: به دستور remote\-global\-parameter4\-get\-all مراجعه کنید \%<#\:command-remote-global-parameter4-get-all>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-global\-parameter4\-get\-all\(dq,
    \(dqarguments\(dq: {
        \(dqremote\(dq: {
            <specification of the database to connect to>
        },
        \(dqserver\-tags\(dq: [ <single server tag as string> ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
فهرست \fBserver\-tags\fP اجباری است و باید دقیقاً شامل یک برچسب سرور باشد. مشخص کردن یک فهرست خالی، مقدار \fBnull\fP، یا چند برچسب سرور منجر به خطا خواهد شد. برچسب سرور ویژه \(dqall\(dq مجاز است؛ این برچسب پارامترهای سراسری مشترک بین همه سرورها را واکشی می‌کند.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqDHCPv4 global parameters found.\(dq,
    \(dqarguments\(dq: {
        \(dqparameters\(dq: [
            {
                <first parameter name>: <first parameter value>,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ <server tag> ]
                }
            },
            {
                <second parameter name>: <second parameter value>,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ <server tag> ]
                }
            }
        ],
        \(dqcount\(dq: 2
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ بازگردانده‌شده شامل فهرستی از نگاشت‌ها است. هر نگاشت شامل یک جفت نام:مقدار پارامتر سراسری است. مقدار ممکن است یک رشته JSON، عدد صحیح، عدد حقیقی، بولی، فهرستی از این نوع‌های اسکالر یا نگاشتی باشد که تنها شامل یکی از این نوع‌های اسکالر است. متادیتا به هر پارامتر پیوست شده و اطلاعات خاص پایگاه داده مرتبط با اشیاء بازگردانده‌شده را فراهم می‌کند. اگر برچسب سرور \(dqall\(dq در دستور گنجانده شده باشد، پاسخ حاوی پارامترهای سراسری به اشتراک گذاشته‌شده میان همه سرورها خواهد بود و پارامترهای سراسری مختص سرور را مستثنی می‌کند. اگر یک برچسب سرور صریح در دستور گنجانده شده باشد، پاسخ شامل همه پارامترهای سراسری است که مستقیماً با سرور داده‌شده مرتبط هستند و در صورت عدم وجود مقادیر مختص سرور، شامل پارامترهای سراسری مرتبط با همه سرورها خواهد بود.
.SS remote\-global\-parameter4\-set
.sp
این دستور یک یا چند پارامتر سراسری را در پایگاه داده پیکربندی ایجاد یا به‌روزرسانی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس بودن: 1.6.0 (کتابخانه قلاب cb_cmds)
.sp
دسترسی: نوشتن \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: به دستور remote\-global\-parameter4\-set مراجعه کنید \%<#\:command-remote-global-parameter4-set>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-global\-parameter4\-set\(dq,
    \(dqarguments\(dq: {
        \(dqparameters\(dq: {
            <first parameter name>: <first parameter value>,
            <second parameter name>: <second parameter value>
        },
        \(dqremote\(dq: {
            <specification of the database to connect to>
        },
        \(dqserver\-tags\(dq: [ <single server tag as string> ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور حامل چندین پارامتر سراسری به همراه مقادیر آن‌ها (شامل فهرست‌ها یا نگاشت‌ها با پارامترهای اسکالر) است. هنگام تعیین بیش از یک پارامتر باید احتیاط کرد؛ در برخی موارد، ممکن است تنها زیرمجموعه‌ای از پارامترها با موفقیت در پایگاه داده ذخیره شوند و ذخیره سایر پارامترها با شکست مواجه شود. در چنین مواردی، ممکن است دستور \fBremote\-global\-parameter4\-get\-all\fP برای تأیید محتویات پایگاه داده پس از به‌روزرسانی مفید باشد. فهرست \fBserver\-tags\fP اجباری است و باید دقیقاً شامل یک برچسب سرور باشد. مشخص کردن یک فهرست خالی، مقدار \fBnull\fP، یا چند برچسب سرور منجر به خطا خواهد شد. برچسب سرور \(dqall\(dq مجاز است؛ این برچسب پارامترهای مشخص‌شده را به همه سرورها مرتبط می‌کند.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqDHCPv4 global parameter(s) successfully set.\(dq,
    \(dqarguments\(dq: {
        \(dqparameters\(dq: {
            <first parameter name>: <first parameter value>,
            <second parameter name>: <second parameter value>
        },
        \(dqcount\(dq: 2
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه (result) یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (دستور با موفقیت تکمیل شد، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد) (empty)
.IP \(bu 2
4 \- تداخل (دستور نتوانست تغییرات پیکربندی درخواست‌شده را اعمال کند زیرا با وضعیت سرور تداخل داشت) (conflict)
.UNINDENT.SS remote\-global\-parameter6\-del
.sp
این دستور یک پارامتر سراسری DHCPv6 را از پایگاه‌داده پیکربندی حذف می‌کند. کارساز پس از حذف پارامتر از پایگاه‌داده، از مقدار مشخص‌شده در فایل پیکربندی یا در صورت مشخص نبودن پارامتر در فایل پیکربندی، از یک مقدار پیش‌فرض استفاده می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس بودن: 1.6.0 (کتابخانه قلاب cb_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-global\-parameter6\-del را ببینید \%<#\:command-remote-global-parameter6-del>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-global\-parameter6\-del\(dq,
    \(dqarguments\(dq: {
        \(dqparameters\(dq: [ <parameter name as string> ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        },
        \(dqserver\-tags\(dq: [ <single server tag as string> ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور حامل فهرستی است که دقیقاً نام یک پارامتر را برای حذف شدن در بر دارد. در صورت حذف یک پارامتر نگاشت، باید از قالب \fBmap\-name.parameter\-name\fP استفاده شود. فهرست \fBserver\-tags\fP اجباری است و باید دقیقاً شامل یک برچسب کارساز باشد. مشخص کردن یک فهرست خالی، مقدار \fBnull\fP یا چندین برچسب کارساز منجر به بروز خطا خواهد شد.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqDHCPv6 global parameter(s) deleted.\(dq,
    \(dqarguments\(dq: {
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌های پشتیبانی‌شده کنونی عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (دستور با موفقیت کامل شد، اما داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت کارساز در تداخل بود)
.UNINDENT
.SS remote\-global\-parameter6\-get
.sp
این دستور پارامتر سراسری انتخاب‌شده را برای کارساز از پایگاه‌داده مشخص‌شده واکشی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس بودن: 1.6.0 (کتابخانه قلاب cb_cmds)
.sp
دسترسی: read \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-global\-parameter6\-get را ببینید \%<#\:command-remote-global-parameter6-get>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-global\-parameter6\-get\(dq,
    \(dqarguments\(dq: {
        \(dqparameters\(dq: [ <parameter name as string> ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        },
        \(dqserver\-tags\(dq: [ <single server tag as string> ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور حامل فهرستی است که دقیقاً نام یک پارامتر را جهت واکشی در بر دارد. در صورت بازیابی یک پارامتر نگاشت، باید از قالب \fBmap\-name.parameter\-name\fP استفاده شود. فهرست \fBserver\-tags\fP اجباری است و باید دقیقاً شامل یک برچسب کارساز باشد. مشخص کردن یک فهرست خالی، مقدار \fBnull\fP یا چندین برچسب کارساز منجر به بروز خطا خواهد شد. برچسب کارساز \(dqall\(dq مجاز است؛ این برچسب مقدار پارامتر سراسری مشترک بین همه کارسازها را واکشی می‌کند.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqDHCPv6 global parameter found.\(dq,
    \(dqarguments\(dq: {
        \(dqparameters\(dq: {
            <parameter name>: <parameter value>,
            \(dqmetadata\(dq: {
                \(dqserver\-tags\(dq: [ <server tag> ]
            }
        },
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ بازگردانده‌شده شامل یک نگاشت با یک جفت نام:مقدار پارامتر سراسری است. این مقدار می‌تواند یک رشته JSON، عدد صحیح، عدد حقیقی، بولی، فهرستی از این نوع‌های اسکالر یا نگاشتی باشد که تنها شامل یکی از این نوع‌های اسکالر است. فراداده گنجانده شده و اطلاعات مخصوص پایگاه‌داده مرتبط با شیء بازگردانده‌شده را فراهم می‌کند. اگر برچسب کارساز \(dqall\(dq مشخص شده باشد، دستور تلاش می‌کند مقدار پارامتر سراسری مرتبط با همه کارسازها را واکشی کند. اگر برچسب کارساز مشخصی تعیین شده باشد، دستور مقدار مرتبط با همان کارساز را واکشی می‌کند. اگر مقدار ویژه‌ی کارساز وجود نداشته باشد، \fBremote\-global\-parameter6\-get\fP مقدار مرتبط با همه کارسازها را واکشی می‌نماید.
.SS remote\-global\-parameter6\-get\-all
.sp
این دستور تمام پارامترهای سراسری را برای کارساز از پایگاه‌داده مشخص‌شده واکشی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس بودن: 1.6.0 (کتابخانه قلاب cb_cmds)
.sp
دسترسی: read \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-global\-parameter6\-get\-all را ببینید \%<#\:command-remote-global-parameter6-get-all>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-global\-parameter6\-get\-all\(dq,
    \(dqarguments\(dq: {
        \(dqremote\(dq: {
            <specification of the database to connect to>
        },
        \(dqserver\-tags\(dq: [ <single server tag as string> ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
فهرست \fBserver\-tags\fP اجباری است و باید دقیقاً شامل یک برچسب کارساز باشد. مشخص کردن یک فهرست خالی، مقدار \fBnull\fP یا چندین برچسب کارساز منجر به بروز خطا خواهد شد. برچسب کارساز ویژه \(dqall\(dq مجاز است؛ این برچسب پارامترهای سراسری مشترک بین همه کارسازها را واکشی می‌کند.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqDHCPv6 global parameters found.\(dq,
    \(dqarguments\(dq: {
        \(dqparameters\(dq: [
            {
                <first parameter name>: <first parameter value>,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ <server tag> ]
                }
            },
            {
                <second parameter name>: <second parameter value>,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ <server tag> ]
                }
            }
        ],
        \(dqcount\(dq: 2
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ بازگردانده‌شده شامل فهرستی از نگاشت‌ها است. هر نگاشت حاوی یک جفت نام:مقدار از پارامتر سراسری است. این مقدار می‌تواند یک رشته JSON، عدد صحیح، عدد حقیقی، بولی، فهرستی از این نوع‌های اسکالر یا نگاشتی باشد که تنها شامل یکی از این نوع‌های اسکالر است. فراداده به هر پارامتر پیوست شده و اطلاعات مخصوص پایگاه‌داده مرتبط با اشیاء بازگردانده‌شده را فراهم می‌کند. اگر برچسب کارساز \(dqall\(dq در دستور گنجانده شده باشد، پاسخ حاوی پارامترهای سراسری مشترک میان همه کارسازها خواهد بود و پارامترهای سراسری مختص کارساز را مستثنی می‌کند. اگر یک برچسب کارساز مشخص در دستور گنجانده شده باشد، پاسخ شامل تمامی پارامترهای سراسری است که مستقیماً با کارساز داده‌شده مرتبط هستند، و در صورتی که مقادیر مختص به کارساز وجود نداشته باشند، پارامترهای سراسری مرتبط با همه کارسازها را نیز شامل می‌شود..SS remote\-global\-parameter6\-set
.sp
این دستور یک یا چند پارامتر سراسری را در پایگاه‌داده پیکربندی ایجاد یا به‌روزرسانی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس در: 1.6.0 (کتابخانه قلاب cb_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-global\-parameter6\-set را ببینید \%<#\:command-remote-global-parameter6-set>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-global\-parameter6\-set\(dq,
    \(dqarguments\(dq: {
        \(dqparameters\(dq: {
            <first parameter name>: <first parameter value>,
            <second parameter name>: <second parameter value>
        },
        \(dqremote\(dq: {
            <specification of the database to connect to>
        },
        \(dqserver\-tags\(dq: [ <single server tag as string> ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور حامل چندین پارامتر سراسری به همراه مقادیر آن‌ها است (از جمله فهرست‌ها یا نگاشت‌هایی با پارامترهای اسکالر). در هنگام مشخص کردن بیش از یک پارامتر باید دقت شود؛ در برخی موارد، ممکن است تنها زیرمجموعه‌ای از پارامترها با موفقیت در پایگاه‌داده ذخیره شوند و ذخیره سایر پارامترها با شکست مواجه گردد. در چنین مواردی دستور \fBremote\-global\-parameter6\-get\-all\fP ممکن است برای تأیید محتوای پایگاه‌داده پس از به‌روزرسانی مفید باشد. فهرست \fBserver\-tags\fP اجباری است و باید دقیقاً شامل یک برچسب سرور باشد. مشخص کردن یک فهرست خالی، مقدار \fBnull\fP، یا چندین برچسب سرور منجر به خطا خواهد شد. برچسب سرور \(dqall\(dq مجاز است؛ این برچسب پارامترهای مشخص‌شده را به تمام سرورها مرتبط می‌کند.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqDHCPv6 global parameter(s) successfully set.\(dq,
    \(dqarguments\(dq: {
        \(dqparameters\(dq: {
            <first parameter name>: <first parameter value>,
            <second parameter name>: <second parameter value>
        },
        \(dqcount\(dq: 2
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت
.IP \(bu 2
1 \- خطا
.IP \(bu 2
2 \- پشتیبانی‌نشده
.IP \(bu 2
3 \- خالی (دستور با موفقیت کامل شد، اما داده‌ای تغییر نیافت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تعارض بود)
.UNINDENT
.SS remote\-network4\-del
.sp
این دستور یک شبکه مشترک IPv4 را از پایگاه‌داده پیکربندی حذف می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس در: 1.6.0 (کتابخانه قلاب cb_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-network4\-del را ببینید \%<#\:command-remote-network4-del>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-network4\-del\(dq,
    \(dqarguments\(dq: {
        \(dqshared\-networks\(dq: [
            {
                \(dqname\(dq: <shared network name>
            }
        ],
        \(dqsubnets\-action\(dq: <\(aqkeep\(aq | \(aqdelete\(aq>,
        \(dqremote\(dq: {
            <specification of the database to connect to>
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور شامل فهرستی با دقیقاً یک نام از شبکه مشترک برای حذف است. پارامتر \fBsubnets\-action\fP مشخص می‌کند که آیا زیرشبکه‌ها در این شبکه مشترک باید حذف شوند یا خیر. پارامتر \fBserver\-tags\fP نباید برای این دستور مشخص شود.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq1 IPv4 shared network(s) deleted.\(dq,
    \(dqarguments\(dq: {
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت
.IP \(bu 2
1 \- خطا
.IP \(bu 2
2 \- پشتیبانی‌نشده
.IP \(bu 2
3 \- خالی (دستور با موفقیت کامل شد، اما داده‌ای تغییر نیافت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تعارض بود)
.UNINDENT.SS remote\-network4\-get
.sp
این دستور شبکهٔ اشتراکی IPv4 انتخاب‌شده برای سرور را از پایگاه‌دادهٔ مشخص‌شده واکشی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس بودن: 1.6.0 (کتابخانه هوک cb_cmds)
.sp
سطح دسترسی: read \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-network4\-get را ببینید \%<#\:command-remote-network4-get>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-network4\-get\(dq,
    \(dqarguments\(dq: {
        \(dqshared\-networks\(dq: [
            {
                \(dqname\(dq: <shared network name>
            }
        ],
        \(dqsubnets\-include\(dq: <\(aqfull\(aq | \(aqno\(aq>,
        \(dqremote\(dq: {
            <specification of the database to connect to>
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور شامل فهرستی با دقیقاً یک نام از شبکهٔ اشتراکی برای بازگردانده شدن است. پارامتر اختیاری \fBsubnets\-include\fP امکان تعیین این را فراهم می‌کند که آیا زیرشبکه‌های متعلق به شبکهٔ اشتراکی نیز باید بازگردانده شوند یا خیر. پارامتر \fBserver\-tags\fP نباید برای این دستور مشخص شود.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqIPv4 shared network found.\(dq,
    \(dqarguments\(dq: {
        \(dqshared\-networks\(dq: [
            {
                \(dqname\(dq: <shared network name>,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ <first server tag>, <second server tag>, ... ]
                },
                <the rest of the shared network information, potentially including subnets>
            }
        ],
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر زیرشبکه‌ها به همراه شبکهٔ اشتراکی بازگردانده شوند، در فهرست \fBsubnet4\fP درون تعریف شبکهٔ اشتراکی قرار می‌گیرند. فراداده در تعریف بازگردانده‌شدهٔ شبکهٔ اشتراکی گنجانده شده و اطلاعات خاص پایگاه‌دادهٔ مرتبط با شیءِ بازگردانده‌شده را فراهم می‌کند.
.SS remote\-network4\-list
.sp
این دستور فهرستی از تمام شبکه‌های اشتراکی IPv4 را از پایگاه‌دادهٔ پیکربندی واکشی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس بودن: 1.6.0 (کتابخانه هوک cb_cmds)
.sp
سطح دسترسی: read \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-network4\-list را ببینید \%<#\:command-remote-network4-list>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-network4\-list\(dq,
    \(dqarguments\(dq: {
        \(dqremote\(dq: {
            <specification of the database to connect to>
        },
        \(dqserver\-tags\(dq: [ <first server tag>, <second server tag>, ... ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
فهرست \fBserver\-tags\fP برای این دستور الزامی است و نباید خالی باشد. این فهرست می‌تواند شامل یک یا چند برچسب سرور به‌صورت رشته، یا یک مقدار تکی \fBnull\fP باشد.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq2 IPv4 shared network(s) found.\(dq,
    \(dqarguments\(dq: {
        \(dqshared\-networks\(dq: [
            {
                \(dqname\(dq: <first shared network name>,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ <first server tag>, <second server tag>, ... ]
                }
            },
            {
                \(dqname\(dq: <second shared network name>,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ <first server tag>, ... ]
                }
            }
        ],
        \(dqcount\(dq: 2
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ بازگردانده‌شده شامل فهرستی از نگاشت‌ها (maps) است. هر نگاشت شامل نام شبکهٔ اشتراکی و فراداده است که اطلاعات خاص پایگاه‌دادهٔ مرتبط با شبکهٔ اشتراکی را فراهم می‌کند. فهرست بازگردانده‌شده شامل تعاریف کامل شبکه‌های اشتراکی نیست؛ برای واکشی اطلاعات کامل دربارهٔ شبکه‌های اشتراکی انتخاب‌شده از \fBremote\-network4\-get\fP استفاده کنید. اگر دستور شامل برچسب‌های صریح سرور به‌صورت رشته باشد (از جمله برچسب سرور ویژهٔ \(dqall\(dq)، فهرست شامل تمام شبکه‌های اشتراکی خواهد بود که با هر یک از برچسب‌های مشخص‌شده مرتبط هستند. یک شبکه حتی در صورتی که با چندین سرور مرتبط باشد و تنها یکی از برچسب‌های مشخص‌شده مطابقت داشته باشد نیز بازگردانده می‌شود. اگر دستور شامل مقدار \fBnull\fP در فهرست \fBserver\-tags\fP باشد، پاسخ شامل تمام شبکه‌های اشتراکی خواهد بود که به هیچ سروری تخصیص داده نشده‌اند (تخصیص‌نیافته)..SS remote\-network4\-set
.sp
این دستور یک شبکه اشتراکی IPv4 را در پایگاه‌داده پیکربندی ایجاد یا جایگزین می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس بودن: 1.6.0 (کتابخانه هوک cb_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: به دستور remote\-network4\-set مراجعه کنید \%<#\:command-remote-network4-set>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-network4\-set\(dq,
    \(dqarguments\(dq: {
        \(dqshared\-networks\(dq: [
            {
                <shared network specification excluding subnets list>
            }
        ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        },
        \(dqserver\-tags\(dq: [ <first server tag>, <second server tag>, ... ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
فهرست ارائه‌شده باید دقیقاً شامل مشخصات یک شبکه اشتراکی باشد و نباید شامل زیرشبکه‌ها (پارامتر \(dqsubnet4\(dq) باشد. زیرشبکه‌ها با استفاده از دستور \fBremote\-subnet4\-set\fP به شبکه اشتراکی اضافه می‌شوند. فهرست \fBserver\-tags\fP اجباری است و باید شامل یک یا چند برچسب سرور به‌صورت رشته باشد تا شبکه اشتراکی را به‌طور صریح با یک یا چند سرور تعریف‌شده توسط کاربر مرتبط سازد. این فهرست می‌تواند شامل برچسب سرور ویژه \(dqall\(dq باشد تا شبکه را با تمام سرورها مرتبط کند.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqIPv4 shared network successfully set.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه، یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت انجام شد، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (conflict) (دستور نتوانست تغییرات پیکربندی درخواست‌شده را اعمال کند زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT
.SS remote\-network6\-del
.sp
این دستور یک شبکه اشتراکی IPv6 را از پایگاه‌داده پیکربندی حذف می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس بودن: 1.6.0 (کتابخانه هوک cb_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: به دستور remote\-network6\-del مراجعه کنید \%<#\:command-remote-network6-del>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-network6\-del\(dq,
    \(dqarguments\(dq: {
        \(dqshared\-networks\(dq: [
            {
                \(dqname\(dq: <shared network name>
            }
        ],
        \(dqsubnets\-action\(dq: <\(aqkeep\(aq | \(aqdelete\(aq>,
        \(dqremote\(dq: {
            <specification of the database to connect to>
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور شامل فهرستی با دقیقاً یک نام از شبکه اشتراکی مورد نظر برای حذف است. پارامتر \fBsubnets\-action\fP مشخص می‌کند که آیا زیرشبکه‌های موجود در این شبکه اشتراکی باید حذف شوند یا خیر. پارامتر \fBserver\-tags\fP نباید برای این دستور مشخص شود.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq1 IPv6 shared network(s) deleted.\(dq,
    \(dqarguments\(dq: {
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه، یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت انجام شد، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (conflict) (دستور نتوانست تغییرات پیکربندی درخواست‌شده را اعمال کند زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT.SS remote\-network6\-get
.sp
این دستور شبکهٔ اشتراکی IPv6 انتخاب‌شده را برای سرور از پایگاه‌دادهٔ مشخص‌شده واکشی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس بودن: 1.6.0 (کتابخانهٔ قلاب cb_cmds)
.sp
دسترسی: read \fI(پارامتر در این نسخهٔ Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-network6\-get را ببینید \%<#\:command-remote-network6-get>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-network6\-get\(dq,
    \(dqarguments\(dq: {
        \(dqshared\-networks\(dq: [
            {
                \(dqname\(dq: <shared network name>
            }
        ],
        \(dqsubnets\-include\(dq: <\(aqfull\(aq | \(aqno\(aq>,
        \(dqremote\(dq: {
            <specification of the database to connect to>
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور شامل فهرستی با دقیقاً یک نام از شبکهٔ اشتراکی برای بازگردانی است. پارامتر اختیاری \fBsubnets\-include\fP امکان مشخص کردن این موضوع را فراهم می‌کند که آیا زیرشبکه‌های متعلق به شبکهٔ اشتراکی نیز باید بازگردانده شوند یا خیر. پارامتر \fBserver\-tags\fP نباید برای این دستور مشخص شود.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqIPv6 shared network found.\(dq,
    \(dqarguments\(dq: {
        \(dqshared\-networks\(dq: [
            {
                \(dqname\(dq: <shared network name>,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ <first server tag>, <second server tag>, ... ]
                },
                <the rest of the shared network information, potentially including subnets>
            }
        ],
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر زیرشبکه‌ها به همراه شبکهٔ اشتراکی بازگردانده شوند، درون فهرست \fBsubnet6\fP در تعریف شبکهٔ اشتراکی منتقل می‌شوند. فراداده (metadata) در تعریف شبکهٔ اشتراکی بازگردانده‌شده گنجانده شده و اطلاعات خاص پایگاه‌دادهٔ مرتبط با شیء بازگردانده‌شده را فراهم می‌کند.
.SS remote\-network6\-list
.sp
این دستور فهرستی از تمام شبکه‌های اشتراکی IPv6 را از پایگاه‌دادهٔ پیکربندی واکشی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس بودن: 1.6.0 (کتابخانهٔ قلاب cb_cmds)
.sp
دسترسی: read \fI(پارامتر در این نسخهٔ Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-network6\-list را ببینید \%<#\:command-remote-network6-list>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-network6\-list\(dq,
    \(dqarguments\(dq: {
        \(dqremote\(dq: {
            <specification of the database to connect to>
        },
        \(dqserver\-tags\(dq: [ <first server tag>, <second server tag>, ... ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
فهرست \fBserver\-tags\fP برای این دستور الزامی است و نباید خالی باشد. این فهرست می‌تواند شامل یک یا چند برچسب سرور به‌صورت رشته، یا یک مقدار تکی \fBnull\fP باشد.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq2 IPv6 shared network(s) found.\(dq,
    \(dqarguments\(dq: {
        \(dqshared\-networks\(dq: [
            {
                \(dqname\(dq: <first shared network name>,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ <first server tag>, <second server tag>, ... ]
                }
            },
            {
                \(dqname\(dq: <second shared network name>,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ <first server tag>, ... ]
                }
            }
        ],
        \(dqcount\(dq: 2
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ بازگردانده‌شده حاوی فهرستی از نگاشت‌ها است. هر نگاشت شامل نام شبکهٔ اشتراکی و فراداده (metadata) است که اطلاعات خاص پایگاه‌دادهٔ مرتبط با شبکهٔ اشتراکی را فراهم می‌کند. فهرست بازگردانده‌شده شامل تعاریف کامل شبکه‌های اشتراکی نیست؛ از \fBremote\-network6\-get\fP برای واکشی اطلاعات کامل دربارهٔ شبکه‌های اشتراکی انتخاب‌شده استفاده کنید. اگر دستور شامل برچسب‌های صریح سرور به‌صورت رشته باشد (از جمله برچسب ویژهٔ سرور \(dqall\(dq)، فهرست حاوی تمام شبکه‌های اشتراکی خواهد بود که با هر یک از برچسب‌های مشخص‌شده مرتبط هستند. یک شبکه حتی در صورتی که با چندین سرور مرتبط باشد و تنها یکی از برچسب‌های مشخص‌شده با آن مطابقت داشته باشد بازگردانده می‌شود. اگر دستور حاوی مقدار \fBnull\fP در فهرست \fBserver\-tags\fP باشد، پاسخ شامل تمام شبکه‌های اشتراکی خواهد بود که به هیچ سروری تخصیص نیافته‌اند (تخصیص‌نیافته)..SS remote\-network6\-set
.sp
این دستور یک شبکهٔ اشتراکی IPv6 را در پایگاه‌دادهٔ پیکربندی ایجاد کرده یا جایگزین می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس در: 1.6.0 (کتابخانه قلاب cb_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-network6\-set را ببینید \%<#\:command-remote-network6-set>
.sp
ساختار دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-network6\-set\(dq,
    \(dqarguments\(dq: {
        \(dqshared\-networks\(dq: [
            {
                <shared network specification excluding subnets list>
            }
        ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        },
        \(dqserver\-tags\(dq: [ <first server tag>, <second server tag>, ... ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
فهرست ارائه‌شده باید دقیقاً شامل مشخصات یک شبکهٔ اشتراکی باشد و نباید شامل زیرشبکه‌ها (پارامتر \(dqsubnet6\(dq) باشد. زیرشبکه‌ها با استفاده از دستور \fBremote\-subnet6\-set\fP به شبکهٔ اشتراکی اضافه می‌شوند. فهرست \fBserver\-tags\fP اجباری است و باید شامل یک یا چند برچسب سرور به‌صورت رشته باشد تا شبکهٔ اشتراکی را به‌طور صریح با یک یا چند سرور تعریف‌شده توسط کاربر مرتبط سازد. این فهرست می‌تواند شامل برچسب سرور ویژهٔ \(dqall\(dq برای مرتبط کردن شبکه با همهٔ سرورها باشد.
.sp
ساختار پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqIPv6 shared network successfully set.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه، یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت به پایان رسید، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (conflict) (دستور نتوانست تغییرات پیکربندی درخواست‌شده را اعمال کند زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT
.SS remote\-option\-def4\-del
.sp
این دستور یک تعریف گزینهٔ DHCPv4 را از پایگاه‌دادهٔ پیکربندی حذف می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس در: 1.6.0 (کتابخانه قلاب cb_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-option\-def4\-del را ببینید \%<#\:command-remote-option-def4-del>
.sp
ساختار دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-option\-def4\-del\(dq,
    \(dqarguments\(dq: {
        \(dqoption\-defs\(dq: [ {
            \(dqcode\(dq: <option code>,
            \(dqspace\(dq: <option space>,
            \(dqforce\(dq: false
        } ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        },
        \(dqserver\-tags\(dq: [ <single server tag as string> ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور شامل فهرستی با مشخصات دقیقاً یک تعریف گزینه است که شامل نام و کد گزینه می‌شود. فهرست \fBserver\-tags\fP اجباری است و باید دقیقاً شامل یک برچسب سرور باشد. تعیین یک فهرست خالی، مقدار \fBnull\fP، یا چندین برچسب سرور منجر به خطا خواهد شد. از نسخهٔ 3.1.2 نرم‌افزار Kea، سرور پیش از حذف یک تعریف گزینه، ابتدا بررسی می‌کند که آیا گزینه‌ای تعریف شده که به آن تعریف وابسته باشد یا خیر. در این صورت، دستور حذف با پیامی خطا که علت را توضیح می‌دهد رد خواهد شد. این رفتار پیش‌فرض را می‌توان با تنظیم پارامتر اختیاری \fBforce\fP بر روی true لغو کرد.
.sp
ساختار پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq1 DHCPv4 option definition(s) deleted.\(dq,
    \(dqarguments\(dq: {
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه، یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت به پایان رسید، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (conflict) (دستور نتوانست تغییرات پیکربندی درخواست‌شده را اعمال کند زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT.SS remote\-option\-def4\-get
.sp
این دستور یک تعریف گزینه DHCPv4 را از پایگاه‌داده پیکربندی واکشی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس بودن: 1.6.0 (کتابخانه قلاب cb_cmds)
.sp
دسترسی: خواندن \fI(پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: به دستور remote\-option\-def4\-get مراجعه کنید \%<#\:command-remote-option-def4-get>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-option\-def4\-get\(dq,
    \(dqarguments\(dq: {
        \(dqoption\-defs\(dq: [
            {
                \(dqcode\(dq: <option code>,
                \(dqspace\(dq: <option space>
            }
        ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        },
        \(dqserver\-tags\(dq: [ <single server tag as string> ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
تعریف گزینه مورد نظر با جفت مقادیر code/space گزینه مشخص می‌شود. فهرست \fBserver\-tags\fP اجباری است و باید دقیقاً شامل یک برچسب سرور باشد. مشخص کردن یک فهرست خالی، مقدار \fBnull\fP یا چندین برچسب سرور منجر به بروز خطا می‌شود. برچسب سرور \(dqall\(dq برای واکشی نمونه تعریف گزینه به‌اشتراک‌گذاشته‌شده میان همه سرورها مجاز است.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqDHCPv4 option definition found.\(dq,
    \(dqarguments\(dq: {
        \(dqoption\-defs\(dq: [
            {
                <option definition>,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ <server tag> ]
                }
            }
        ],
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
فراداده (metadata) گنجانده شده است و اطلاعات ویژه پایگاه‌داده مرتبط با شیء بازگردانده‌شده را ارائه می‌دهد. اگر برچسب سرور \(dqall\(dq مشخص شود، دستور تلاش می‌کند تعریف گزینه مرتبط با همه سرورها را واکشی کند. اگر برچسب صریح سرور مشخص شود، دستور تعریف گزینه مرتبط با سرور داده‌شده را واکشی می‌کند. اگر تعریف گزینه مختص سرور وجود نداشته باشد، دستور \fBremote\-option\-def4\-get\fP تعریف گزینه مرتبط با همه سرورها را واکشی می‌کند.
.SS remote\-option\-def4\-get\-all
.sp
این دستور همه تعاریف گزینه‌های DHCPv4 را از پایگاه‌داده پیکربندی واکشی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس بودن: 1.6.0 (کتابخانه قلاب cb_cmds)
.sp
دسترسی: خواندن \fI(پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: به دستور remote\-option\-def4\-get\-all مراجعه کنید \%<#\:command-remote-option-def4-get-all>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-option\-def4\-get\-all\(dq,
    \(dqarguments\(dq: {
        \(dqremote\(dq: {
            <specification of the database to connect to>
        },
        \(dqserver\-tags\(dq: [ <single server tag as string> ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
فهرست \fBserver\-tags\fP اجباری است و باید دقیقاً شامل یک برچسب سرور باشد. مشخص کردن یک فهرست خالی، مقدار \fBnull\fP یا چندین برچسب سرور منجر به بروز خطا خواهد شد. برچسب سرور ویژه \(dqall\(dq برای واکشی تعاریف گزینه‌های به‌اشتراک‌گذاشته‌شده توسط همه سرورها مجاز است.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq2 DHCPv4 option definition(s) found.\(dq,
    \(dqarguments\(dq: {
        \(dqoption\-defs\(dq: [
            {
                <first option definition>,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ <server tag> ]
                }
            },
            {
                <second option definition>,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ <server tag> ]
                }
            }
        ],
        \(dqcount\(dq: 2
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ بازگردانده‌شده شامل فهرستی از نگاشت‌ها است. هر نگاشت شامل مشخصات تعریف گزینه و فراداده (metadata)، از جمله اطلاعات ویژه پایگاه‌داده مرتبط با اشیاء بازگردانده‌شده است. اگر برچسب سرور \(dqall\(dq در دستور گنجانده شود، پاسخ حاوی تعاریف گزینه‌های به‌اشتراک‌گذاشته‌شده میان همه سرورها خواهد بود و تعاریف گزینه مختص سرور را مستثنی می‌کند. اگر یک برچسب سرور صریح در دستور گنجانده شود، پاسخ حاوی تمامی تعاریف گزینه‌های مستقیماً مرتبط با سرور داده‌شده و همچنین در صورت عدم وجود تعاریف گزینه مختص سرور، تعاریف گزینه مرتبط با همه سرورها خواهد بود..SS remote\-option\-def4\-set
.sp
این دستور یک تعریف گزینهٔ DHCPv4 را در پایگاه‌دادهٔ پیکربندی ایجاد یا جایگزین می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس بودن: 1.6.0 (کتابخانهٔ قلاب cb_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخهٔ Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-option\-def4\-set را ببینید \%<#\:command-remote-option-def4-set>
.sp
ساختار دستوری:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-option\-def4\-set\(dq,
    \(dqarguments\(dq: {
        \(dqoption\-defs\(dq: [
            {
                <option definition specification>
            }
        ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        },
        \(dqserver\-tags\(dq: [ <single server tag as string> ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
فهرست ارائه‌شده باید دقیقاً شامل یک مشخصهٔ تعریف گزینه باشد. فهرست \fBserver\-tags\fP اجباری است و باید دقیقاً شامل یک برچسب سرور باشد. مشخص کردن یک فهرست خالی، مقدار \fBnull\fP یا چندین برچسب سرور منجر به خطا خواهد شد. برچسب سرور \(dqall\(dq مجاز است؛ این برچسب، تعریف گزینهٔ مشخص‌شده را به تمام سرورها مرتبط می‌کند.
.sp
ساختار پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqDHCPv4 option definition set.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌های پشتیبانی‌شدهٔ فعلی عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت
.IP \(bu 2
1 \- خطا
.IP \(bu 2
2 \- پشتیبانی‌نشده
.IP \(bu 2
3 \- خالی (دستور با موفقیت کامل شد، اما داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (دستور نتوانست تغییرات پیکربندی درخواست‌شده را اعمال کند زیرا با وضعیت سرور در تداخل بودند)
.UNINDENT
.SS remote\-option\-def6\-del
.sp
این دستور یک تعریف گزینهٔ DHCPv6 را از پایگاه‌دادهٔ پیکربندی حذف می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس بودن: 1.6.0 (کتابخانهٔ قلاب cb_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخهٔ Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-option\-def6\-del را ببینید \%<#\:command-remote-option-def6-del>
.sp
ساختار دستوری:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-option\-def6\-del\(dq,
    \(dqarguments\(dq: {
        \(dqoption\-defs\(dq: [ {
            \(dqcode\(dq: <option code>,
            \(dqspace\(dq: <option space>,
            \(dqforce\(dq: false
        } ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        },
        \(dqserver\-tags\(dq: [ <single server tag as string> ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور شامل فهرستی با دقیقاً یک مشخصهٔ تعریف گزینه، متشکل از یک نام و کد گزینه است. فهرست \fBserver\-tags\fP اجباری است و باید دقیقاً شامل یک برچسب سرور باشد. مشخص کردن یک فهرست خالی، مقدار \fBnull\fP یا چندین برچسب سرور منجر به خطا خواهد شد. از نسخهٔ Kea 3.1.2، سرور پیش از حذف یک تعریف گزینه، ابتدا بررسی می‌کند که آیا گزینه‌ای مشخص شده است که به آن تعریف وابسته باشد یا خیر. در این صورت، دستور حذف با یک پیام خطا که علت را توضیح می‌دهد رد خواهد شد. این رفتار پیش‌فرض می‌تواند با تنظیم پارامتر اختیاری \fBforce\fP روی true لغو شود.
.sp
ساختار پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq1 DHCPv6 option definition(s) deleted.\(dq,
    \(dqarguments\(dq: {
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌های پشتیبانی‌شدهٔ فعلی عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت
.IP \(bu 2
1 \- خطا
.IP \(bu 2
2 \- پشتیبانی‌نشده
.IP \(bu 2
3 \- خالی (دستور با موفقیت کامل شد، اما داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (دستور نتوانست تغییرات پیکربندی درخواست‌شده را اعمال کند زیرا با وضعیت سرور در تداخل بودند)
.UNINDENT.SS remote\-option\-def6\-get
.sp
این دستور یک تعریف گزینهٔ DHCPv6 را از پایگاه‌داده پیکربندی واکشی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس بودن: 1.6.0 (کتابخانه قلاب cb_cmds)
.sp
دسترسی: خواندن \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-option\-def6\-get را ببینید \%<#\:command-remote-option-def6-get>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-option\-def6\-get\(dq,
    \(dqarguments\(dq: {
        \(dqoption\-defs\(dq: [
            {
                \(dqcode\(dq: <option code>,
                \(dqspace\(dq: <option space>
            }
        ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        },
        \(dqserver\-tags\(dq: [ <single server tag as string> ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
تعریف گزینهٔ مورد نظر توسط جفت مقادیر code/space گزینه شناسایی می‌شود. فهرست \fBserver\-tags\fP اجباری است و باید دقیقاً شامل یک برچسب سرور باشد. مشخص کردن یک فهرست خالی، مقدار \fBnull\fP، یا چندین برچسب سرور منجر به خطا خواهد شد. برچسب سرور \(dqall\(dq برای واکشی نمونه تعریف گزینهٔ به‌اشتراک‌گذاشته‌شده توسط تمام سرورها مجاز است.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqDHCPv6 option definition found.\(dq,
    \(dqarguments\(dq: {
        \(dqoption\-defs\(dq: [
            {
                <option definition>,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ <server tag> ]
                }
            }
        ],
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
متادیتا (metadata) گنجانده شده و اطلاعات مخصوص پایگاه‌داده مرتبط با شیء بازگردانده‌شده را ارائه می‌دهد. اگر برچسب سرور \(dqall\(dq مشخص شود، دستور تعریف گزینهٔ مرتبط با تمام سرورها را واکشی می‌کند. اگر یک برچسب سرور صریح مشخص شود، دستور تعریف گزینهٔ مرتبط با سرور مشخص‌شده را واکشی می‌کند. چنانچه تعریف گزینهٔ مخصوص سرور وجود نداشته باشد، دستور \fBremote\-option\-def6\-get\fP تعریف گزینهٔ مرتبط با تمام سرورها را واکشی خواهد کرد.
.SS remote\-option\-def6\-get\-all
.sp
این دستور تمام تعاریف گزینه‌های DHCPv6 را از پایگاه‌داده پیکربندی واکشی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس بودن: 1.6.0 (کتابخانه قلاب cb_cmds)
.sp
دسترسی: خواندن \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-option\-def6\-get\-all را ببینید \%<#\:command-remote-option-def6-get-all>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-option\-def6\-get\-all\(dq,
    \(dqarguments\(dq: {
        \(dqremote\(dq: {
            <specification of the database to connect to>
        },
        \(dqserver\-tags\(dq: [ <single server tag as string> ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
فهرست \fBserver\-tags\fP اجباری است و باید دقیقاً شامل یک برچسب سرور باشد. مشخص کردن یک فهرست خالی، مقدار \fBnull\fP، یا چندین برچسب سرور منجر به خطا خواهد شد. برچسب سرور ویژهٔ \(dqall\(dq برای واکشی تعاریف گزینه‌های به‌اشتراک‌گذاشته‌شده توسط تمام سرورها مجاز است.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq2 DHCPv6 option definition(s) found.\(dq,
    \(dqarguments\(dq: {
        \(dqoption\-defs\(dq: [
            {
                <first option definition>,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ <server tag> ]
                }
            },
            {
                <second option definition>,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ <server tag> ]
                }
            }
        ],
        \(dqcount\(dq: 2
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ بازگردانده‌شده شامل فهرستی از نگاشت‌ها (maps) است. هر نگاشت حاوی مشخصات تعریف گزینه و متادیتا، شامل اطلاعات مخصوص پایگاه‌داده مرتبط با اشیاء بازگردانده‌شده است. اگر برچسب سرور \(dqall\(dq در دستور گنجانده شده باشد، پاسخ حاوی تعاریف گزینه‌های به‌اشتراک‌گذاشته‌شده میان تمام سرورها خواهد بود و تعاریف گزینه‌های اختصاصی سرورها را حذف می‌کند. اگر یک برچسب سرور صریح در دستور گنجانده شده باشد، پاسخ شامل تمام تعاریف گزینه‌های مستقیماً مرتبط با سرور مشخص‌شده و در صورت عدم وجود تعاریف گزینه‌های خاص سرور، شامل تعاریف گزینه‌های مرتبط با تمام سرورها خواهد بود..SS remote\-option\-def6\-set
.sp
این دستور یک تعریف گزینهٔ DHCPv6 را در پایگاه‌دادهٔ پیکربندی ایجاد یا جایگزین می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
دسترس‌پذیری: 1.6.0 (کتابخانهٔ قلاب cb_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخهٔ Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-option\-def6\-set را ببینید \%<#\:command-remote-option-def6-set>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-option\-def6\-set\(dq,
    \(dqarguments\(dq: {
        \(dqoption\-defs\(dq: [
            {
                <option definition specification>
            }
        ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        },
        \(dqserver\-tags\(dq: [ <single server tag as string> ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
فهرست ارائه‌شده باید دقیقاً شامل یک مشخصهٔ تعریف گزینه باشد. فهرست \fBserver\-tags\fP الزامی است و باید دقیقاً شامل یک برچسب سرور باشد. تعیین یک فهرست خالی، مقدار \fBnull\fP، یا چندین برچسب سرور منجر به خطا خواهد شد. برچسب سرور \(dqall\(dq مجاز است؛ این برچسب تعریف گزینهٔ مشخص‌شده را به تمام سرورها مرتبط می‌کند.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqDHCPv6 option definition set.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه (result) یک نمایش عدد صحیح از وضعیت است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارت‌اند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty - دستور با موفقیت به پایان رسید، اما هیچ داده‌ای متأثر یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (conflict - دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT
.SS remote\-option4\-global\-del
.sp
این دستور یک گزینهٔ سراسری DHCPv4 را از پایگاه‌دادهٔ پیکربندی حذف می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
دسترس‌پذیری: 1.6.0 (کتابخانهٔ قلاب cb_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخهٔ Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-option4\-global\-del را ببینید \%<#\:command-remote-option4-global-del>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-option4\-global\-del\(dq,
    \(dqarguments\(dq: {
        \(dqoptions\(dq: [
            {
                \(dqcode\(dq: <option code>,
                \(dqspace\(dq: <option space>,
                \(dqclient\-classes\(dq: [ <zero or more comma\-separated strings> ]
            }
        ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        },
        \(dqserver\-tags\(dq: [ <single server tag as string> ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور شامل فهرستی با دقیقاً یک مشخصهٔ گزینه است، متشکل از نام گزینه، کد و از نسخهٔ Kea 3.1، یک پارامتر اختیاری client\-classes (به Option Class\-tags as Keys مراجعه کنید \%<#\:cb-cmds-option-class-tags-as-keys>). تعیین یک فهرست خالی، مقدار \fBnull\fP، یا چندین برچسب سرور منجر به خطا خواهد شد.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq1 DHCPv4 option(s) deleted.\(dq,
    \(dqarguments\(dq: {
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه (result) یک نمایش عدد صحیح از وضعیت است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارت‌اند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty - دستور با موفقیت به پایان رسید، اما هیچ داده‌ای متأثر یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (conflict - دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT.SS remote\-option4\-global\-get
.sp
این دستور یک گزینهٔ سراسری DHCPv4 را برای کارساز از پایگاه‌دادهٔ مشخص‌شده واکشی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس بودن: 1.6.0 (کتابخانه قلاب cb_cmds)
.sp
دسترسی: خواندن \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-option4\-global\-get را ببینید \%<#\:command-remote-option4-global-get>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-option4\-global\-get\(dq,
    \(dqarguments\(dq: {
        \(dqoptions\(dq: [
            {
                \(dqcode\(dq: <option code>,
                \(dqspace\(dq: <option space>,
                \(dqclient\-classes\(dq: [ <zero or more comma\-separated strings> ]
            }
        ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        },
        \(dqserver\-tags\(dq: [ <single server tag as string> ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
گزینه با جفت‌مقدارهای کد/فضای گزینه (option code/space) و از نسخهٔ ۳.۱ Kea، با پارامتر اختیاری client\-classes شناسایی می‌شود (Option Class\-tags as Keys \%<#\:cb-cmds-option-class-tags-as-keys> را ببینید). فهرست \fBserver\-tags\fP اجباری است و باید دقیقاً شامل یک برچسب کارساز باشد. تعیین یک فهرست خالی، مقدار \fBnull\fP یا چندین برچسب کارساز منجر به خطا خواهد شد. برچسب کارساز \(dqall\(dq برای واکشی نمونهٔ گزینهٔ سراسریِ مشترک میان همهٔ کارسازها مجاز است.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqDHCPv4 option is found.\(dq,
    \(dqarguments\(dq: {
        \(dqoptions\(dq: [
            {
                <option information>,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ <server tag> ]
                }
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
فراداده گنجانده شده و اطلاعات خاص پایگاه‌دادهٔ مرتبط با شیء بازگردانده‌شده را فراهم می‌کند. اگر برچسب کارساز \(dqall\(dq مشخص شده باشد، دستور گزینهٔ سراسری مرتبط با همهٔ کارسازها را واکشی می‌کند. اگر برچسب کارسازِ صریحی مشخص شده باشد، دستور گزینهٔ سراسری مرتبط با کارساز مشخص‌شده را واکشی می‌کند. اگر گزینهٔ خاص کارساز وجود نداشته باشد، گزینهٔ مرتبط با همهٔ کارسازها را واکشی خواهد کرد.
.SS remote\-option4\-global\-get\-all
.sp
این دستور همهٔ گزینه‌های سراسری DHCPv4 را برای کارساز از پایگاه‌دادهٔ پیکربندی واکشی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس بودن: 1.6.0 (کتابخانه قلاب cb_cmds)
.sp
دسترسی: خواندن \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-option4\-global\-get\-all را ببینید \%<#\:command-remote-option4-global-get-all>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-option4\-global\-get\-all\(dq,
    \(dqarguments\(dq: {
        \(dqremote\(dq: {
            <specification of the database to connect to>
        },
        \(dqserver\-tags\(dq: [ <single server tag as string> ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
فهرست \fBserver\-tags\fP اجباری است و باید دقیقاً شامل یک برچسب کارساز باشد. تعیین یک فهرست خالی، مقدار \fBnull\fP یا چندین برچسب کارساز منجر به خطا خواهد شد. برچسب کارساز ویژهٔ \(dqall\(dq برای واکشی گزینه‌های سراسریِ مشترک میان همهٔ کارسازها مجاز است.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq2 DHCPv4 option(s) found.\(dq,
    \(dqarguments\(dq: {
        \(dqoptions\(dq: [
            {
                <first option specification>,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ <server tag> ]
                }
            },
            {
                <second option specification>,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ <server tag> ]
                }
            }
        ],
        \(dqcount\(dq: 2
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ بازگردانده‌شده شامل فهرستی از نگاشت‌ها (maps) است. هر نگاشت شامل مشخصات گزینهٔ سراسری و فراداده، از جمله اطلاعات مختص پایگاه‌دادهٔ مرتبط با شیء بازگردانده‌شده است. اگر برچسب کارساز \(dqall\(dq در دستور گنجانده شده باشد، پاسخ حاوی گزینه‌های سراسری مشترک میان همهٔ کارسازها است و گزینه‌های سراسری مختص کارساز را مستثنی می‌کند. اگر یک برچسب کارسازِ صریح در دستور گنجانده شده باشد، پاسخ شامل تمام گزینه‌های سراسری است که مستقیماً با کارساز داده‌شده مرتبط هستند، و در صورتی که گزینه‌های مختص کارساز وجود نداشته باشند، گزینه‌های مرتبط با همهٔ کارسازها را در بر خواهد داشت..SS remote\-option4\-global\-set
.sp
این دستور یک گزینهٔ سراسری DHCPv4 را در پایگاه‌دادهٔ پیکربندی ایجاد یا جایگزین می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
دسترس‌پذیری: 1.6.0 (کتابخانه قلاب cb_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخهٔ Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-option4\-global\-set را ببینید \%<#\:command-remote-option4-global-set>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-option4\-global\-set\(dq,
    \(dqarguments\(dq: {
        \(dqoptions\(dq: [
            {
                <global option specification>
            }
        ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        },
        \(dqserver\-tags\(dq: [ <single server tag as string> ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
فهرست ارائه‌شده باید دقیقاً شامل یک مشخصهٔ گزینه باشد. فهرست \fBserver\-tags\fP الزامی است و باید دقیقاً شامل یک برچسب سرور باشد. مشخص کردن یک فهرست خالی، مقدار \fBnull\fP، یا چندین برچسب سرور منجر به بروز خطا خواهد شد. برچسب سرور \(dqall\(dq مجاز است؛ این برچسب گزینهٔ مشخص‌شده را به تمام سرورها مرتبط می‌سازد.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqDHCPv4 option set.\(dq,
    \(dqarguments\(dq: {
        \(dqoptions\(dq: [
            {
                \(dqcode\(dq: <option code>,
                \(dqspace\(dq: <option space>,
                \(dqclient\-classes\(dq: [ <one or more comma\-separated strings> ]
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (دستور با موفقیت کامل شد، اما داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT
.SS remote\-option4\-network\-del
.sp
این دستور یک گزینهٔ DHCPv4 مربوط به یک شبکهٔ اشتراکی را از پایگاه‌دادهٔ پیکربندی حذف می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
دسترس‌پذیری: 1.6.0 (کتابخانه قلاب cb_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخهٔ Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-option4\-network\-del را ببینید \%<#\:command-remote-option4-network-del>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-option4\-network\-del\(dq,
    \(dqarguments\(dq: {
        \(dqshared\-networks\(dq: [
            {
                \(dqname\(dq: <shared network name>
            }
        ],
        \(dqoptions\(dq: [
            {
                \(dqcode\(dq: <option code>,
                \(dqspace\(dq: <option space>,
                \(dqclient\-classes\(dq: [ <zero or more comma\-separated strings> ]
            }
        ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور شامل دو فهرست با دقیقاً یک نام شبکهٔ اشتراکی و دقیقاً یک مشخصهٔ گزینه است که شامل نام گزینه، کد، و از نسخهٔ Kea 3.1 به بعد، پارامتر اختیاری client\-classes می‌شود (به Option Class\-tags as Keys مراجعه کنید \%<#\:cb-cmds-option-class-tags-as-keys>). مشخص کردن یک فهرست خالی، مقدار \fBnull\fP، یا برچسب سرور منجر به بروز خطا خواهد شد.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq1 DHCPv4 option(s) deleted.\(dq,
    \(dqarguments\(dq: {
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (دستور با موفقیت کامل شد، اما داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT.SS remote\-option4\-network\-set
.sp
این دستور یک گزینه DHCPv4 را در یک شبکه مشترک (shared network) در پایگاه‌داده پیکربندی ایجاد یا جایگزین می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس بودن: 1.6.0 (کتابخانه قلاب cb_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-option4\-network\-set را ببینید \%<#\:command-remote-option4-network-set>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-option4\-network\-set\(dq,
    \(dqarguments\(dq: {
        \(dqshared\-networks\(dq: [
            {
                \(dqname\(dq: <shared network name>
            }
        ],
        \(dqoptions\(dq: [
            {
                <shared network option specification>
            }
        ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
فهرست‌های ارائه‌شده باید دقیقاً شامل یک نام شبکه مشترک (shared network) و یک مشخصه گزینه باشند. تعیین یک فهرست خالی، یک مقدار \fBnull\fP یا یک server tag منجر به خطا خواهد شد.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqDHCPv4 option successfully set.\(dq,
    \(dqarguments\(dq: {
        \(dqoptions\(dq: [
            {
                \(dqcode\(dq: <option code>,
                \(dqspace\(dq: <option space>,
                \(dqclient\-classes\(dq: [ <one or more comma\-separated strings> ]
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه (Result) یک نمایش عدد صحیح از وضعیت است. وضعیت‌های پشتیبانی‌شده کنونی عبارت‌اند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت به پایان رسید، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (conflict) (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تعارض بود)
.UNINDENT
.SS remote\-option4\-pool\-del
.sp
این دستور یک گزینه DHCPv4 را از یک استخر آدرس (address pool) از پایگاه‌داده پیکربندی حذف می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس بودن: 1.6.0 (کتابخانه قلاب cb_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-option4\-pool\-del را ببینید \%<#\:command-remote-option4-pool-del>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-option4\-pool\-del\(dq,
    \(dqarguments\(dq: {
        \(dqpools\(dq: [
            {
                \(dqpool\(dq: <pool range or prefix>
            }
        ],
        \(dqoptions\(dq: [
            {
                \(dqcode\(dq: <option code>,
                \(dqspace\(dq: <option space>,
                \(dqclient\-classes\(dq: [ <zero or more comma\-separated strings> ]
            }
        ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور شامل دو فهرست با دقیقاً یک مشخصه address pool و دقیقاً یک مشخصه گزینه شامل یک نام option space، کد و از نسخه 3.1 Kea، یک پارامتر اختیاری client\-classes است (بخش Option Class\-tags as Keys را ببینید \%<#\:cb-cmds-option-class-tags-as-keys>). تعیین یک فهرست خالی، یک مقدار \fBnull\fP یا یک server tag منجر به خطا خواهد شد.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq1 DHCPv4 option(s) deleted.\(dq,
    \(dqarguments\(dq: {
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه (Result) یک نمایش عدد صحیح از وضعیت است. وضعیت‌های پشتیبانی‌شده کنونی عبارت‌اند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت به پایان رسید، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (conflict) (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تعارض بود)
.UNINDENT.SS remote\-option4\-pool\-set
.sp
این دستور یک گزینه DHCPv4 را در یک استخر نشانی در پایگاه داده پیکربندی ایجاد کرده یا جایگزین می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس بودن: 1.6.0 (کتابخانه هوک cb_cmds)
.sp
دسترسی: write \fI(پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-option4\-pool\-set را ببینید \%<#\:command-remote-option4-pool-set>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-option4\-pool\-set\(dq,
    \(dqarguments\(dq: {
        \(dqpools\(dq: [
            {
                \(dqpool\(dq: <pool range or prefix>
            }
        ],
        \(dqoptions\(dq: [
            {
                <address pool option specification>
            }
        ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور شامل دو فهرست با دقیقاً مشخصات استخر نشانی و دقیقاً یک مشخصات گزینه است. مشخص کردن یک فهرست خالی، یک مقدار \fBnull\fP یا یک server tag منجر به خطا خواهد شد.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqDHCPv4 option successfully set.\(dq,
    \(dqarguments\(dq: {
        \(dqoptions\(dq: [
            {
                \(dqcode\(dq: <option code>,
                \(dqspace\(dq: <option space>,
                \(dqclient\-classes\(dq: [ <one or more comma\-separated strings> ]
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت
.IP \(bu 2
1 \- خطا
.IP \(bu 2
2 \- پشتیبانی‌نشده
.IP \(bu 2
3 \- خالی (دستور با موفقیت کامل شد، اما داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT
.SS remote\-option4\-subnet\-del
.sp
این دستور یک گزینه DHCPv4 را برای یک زیرشبکه از پایگاه داده پیکربندی حذف می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس بودن: 1.6.0 (کتابخانه هوک cb_cmds)
.sp
دسترسی: write \fI(پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-option4\-subnet\-del را ببینید \%<#\:command-remote-option4-subnet-del>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-option4\-subnet\-del\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [
            {
                \(dqid\(dq: <subnet identifier>
            }
        ],
        \(dqoptions\(dq: [
            {
                \(dqcode\(dq: <option code>,
                \(dqspace\(dq: <option space>,
                \(dqclient\-classes\(dq: [ <zero or more comma\-separated strings> ]
            }
        ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور شامل دو فهرست با دقیقاً یک شناسه (ID) زیرشبکه و دقیقاً یک مشخصات گزینه، شامل نام گزینه، کد، و از نسخه Kea 3.1، یک پارامتر اختیاری client\-classes است (بخش Option Class\-tags as Keys را ببینید \%<#\:cb-cmds-option-class-tags-as-keys>). مشخص کردن یک فهرست خالی، یک مقدار \fBnull\fP یا یک server tag منجر به خطا خواهد شد.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq1 DHCPv4 option(s) deleted.\(dq,
    \(dqarguments\(dq: {
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت
.IP \(bu 2
1 \- خطا
.IP \(bu 2
2 \- پشتیبانی‌نشده
.IP \(bu 2
3 \- خالی (دستور با موفقیت کامل شد، اما داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT.SS remote\-option4\-subnet\-set
.sp
این دستور یک گزینه DHCPv4 را در یک زیرشبکه در پایگاه‌داده پیکربندی ایجاد یا جایگزین می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس بودن: 1.6.0 (کتابخانه قلاب cb_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-option4\-subnet\-set را ببینید \%<#\:command-remote-option4-subnet-set>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-option4\-subnet\-set\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [
            {
                \(dqid\(dq: <subnet identifier>
            }
        ],
        \(dqoptions\(dq: [
            {
                <subnet option specification>
            }
        ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
فهرست‌های ارائه‌شده باید دقیقاً شامل یک شناسه زیرشبکه و یک مشخصه گزینه باشند. مشخص کردن یک فهرست خالی، مقدار \fBnull\fP یا یک برچسب سرور (server tag) منجر به خطا خواهد شد.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqDHCPv4 option successfully set.\(dq,
    \(dqarguments\(dq: {
        \(dqoptions\(dq: [
            {
                \(dqcode\(dq: <option code>,
                \(dqspace\(dq: <option space>,
                \(dqclient\-classes\(dq: [ <one or more comma\-separated strings> ]
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت
.IP \(bu 2
1 \- خطا
.IP \(bu 2
2 \- پشتیبانی‌نشده
.IP \(bu 2
3 \- خالی (دستور با موفقیت کامل شد، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (دستور نتوانست تغییرات پیکربندی درخواست‌شده را اعمال کند زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT
.SS remote\-option6\-global\-del
.sp
این دستور یک گزینه سراسری DHCPv6 را از پایگاه‌داده پیکربندی حذف می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس بودن: 1.6.0 (کتابخانه قلاب cb_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-option6\-global\-del را ببینید \%<#\:command-remote-option6-global-del>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-option6\-global\-del\(dq,
    \(dqarguments\(dq: {
        \(dqoptions\(dq: [
            {
                \(dqcode\(dq: <option code>,
                \(dqspace\(dq: <option space>,
                \(dqclient\-classes\(dq: [ <zero or more comma\-separated strings> ]
            }
        ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        },
        \(dqserver\-tags\(dq: [ <single server tag as string> ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور شامل فهرستی با دقیقاً یک مشخصه گزینه است، متشکل از نام گزینه، کد، و از نسخه Kea 3.1.1 به بعد، پارامتر اختیاری client\-classes (به بخش Option Class\-tags as Keys مراجعه کنید \%<#\:cb-cmds-option-class-tags-as-keys>). مشخص کردن یک فهرست خالی، مقدار \fBnull\fP یا چندین برچسب سرور منجر به خطا خواهد شد.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq1 DHCPv6 option(s) deleted.\(dq,
    \(dqarguments\(dq: {
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت
.IP \(bu 2
1 \- خطا
.IP \(bu 2
2 \- پشتیبانی‌نشده
.IP \(bu 2
3 \- خالی (دستور با موفقیت کامل شد، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (دستور نتوانست تغییرات پیکربندی درخواست‌شده را اعمال کند زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT.SS remote\-option6\-global\-get
.sp
این دستور یک گزینهٔ سراسری DHCPv6 را برای سرور از پایگاه‌دادهٔ مشخص‌شده دریافت می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس از: 1.6.0 (کتابخانهٔ قلاب cb_cmds)
.sp
دسترسی: read \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-option6\-global\-get را ببینید \%<#\:command-remote-option6-global-get>
.sp
ساختار دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-option6\-global\-get\(dq,
    \(dqarguments\(dq: {
        \(dqoptions\(dq: [
            {
                \(dqcode\(dq: <option code>,
                \(dqspace\(dq: <option space>,
                \(dqclient\-classes\(dq: [ <zero or more comma\-separated strings> ]
            }
        ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        },
        \(dqserver\-tags\(dq: [ <single server tag as string> ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این گزینه با جفت مقادیر کد/فضای گزینه (option code/space) و از نسخهٔ 3.1.1 Kea به بعد، با یک پارامتر اختیاری client\-classes شناسایی می‌شود (بخش Option Class\-tags as Keys را ببینید \%<#\:cb-cmds-option-class-tags-as-keys>). فهرست \fBserver\-tags\fP اجباری است و باید دقیقاً شامل یک برچسب سرور باشد. مشخص کردن یک فهرست خالی، مقدار \fBnull\fP، یا چند برچسب سرور منجر به خطا خواهد شد. برچسب سرور \(dqall\(dq مجاز است تا نمونهٔ گزینهٔ سراسری به‌اشتراک‌گذاشته‌شده توسط همهٔ سرورها دریافت شود.
.sp
ساختار پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqDHCPv6 option is found.\(dq,
    \(dqarguments\(dq: {
        \(dqoptions\(dq: [
            {
                <option information>,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ <server tag> ]
                }
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
فراداده (metadata) گنجانده شده و اطلاعات خاص پایگاه‌دادهٔ مرتبط با شیء بازگردانده‌شده را فراهم می‌کند. اگر برچسب سرور \(dqall\(dq مشخص شده باشد، دستور تلاش می‌کند گزینهٔ سراسری مرتبط با همهٔ سرورها را دریافت کند. اگر یک برچسب سرور صریح مشخص شده باشد، دستور گزینهٔ سراسری مرتبط با سرور داده‌شده را واکشی خواهد کرد. اگر گزینهٔ مختص سرور وجود نداشته باشد، گزینهٔ مرتبط با همهٔ سرورها را دریافت می‌کند.
.SS remote\-option6\-global\-get\-all
.sp
این دستور تمام گزینه‌های سراسری DHCPv6 را برای سرور از پایگاه‌دادهٔ پیکربندی دریافت می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس از: 1.6.0 (کتابخانهٔ قلاب cb_cmds)
.sp
دسترسی: read \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-option6\-global\-get\-all را ببینید \%<#\:command-remote-option6-global-get-all>
.sp
ساختار دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-option6\-global\-get\-all\(dq,
    \(dqarguments\(dq: {
        \(dqremote\(dq: {
            <specification of the database to connect to>
        },
        \(dqserver\-tags\(dq: [ <single server tag as string> ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
فهرست \fBserver\-tags\fP اجباری است و باید دقیقاً شامل یک برچسب سرور باشد. مشخص کردن یک فهرست خالی، مقدار \fBnull\fP، یا چند برچسب سرور منجر به خطا خواهد شد. برچسب ویژهٔ سرور \(dqall\(dq مجاز است تا گزینه‌های سراسری به‌اشتراک‌گذاشته‌شده توسط همهٔ سرورها دریافت شوند.
.sp
ساختار پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq2 DHCPv6 option(s) found.\(dq,
    \(dqarguments\(dq: {
        \(dqoptions\(dq: [
            {
                <first option specification>,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ <server tag> ]
                }
            },
            {
                <second option specification>,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ <server tag> ]
                }
            }
        ],
        \(dqcount\(dq: 2
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ بازگردانده‌شده شامل فهرستی از نگاشتها است. هر نگاشت حاوی مشخصات یک گزینهٔ سراسری و فراداده (شامل اطلاعات خاص پایگاه‌دادهٔ مرتبط با شیء بازگردانده‌شده) است. اگر برچسب سرور \(dqall\(dq در دستور گنجانده شود، پاسخ شامل گزینه‌های سراسری مشترک بین همهٔ سرورها خواهد بود و گزینه‌های سراسری مختص سرور را شامل نمی‌شود. اگر یک برچسب سرور صریح در دستور گنجانده شود، پاسخ شامل تمام گزینه‌های سراسری مرتبط مستقیم با سرور داده‌شده، و همچنین گزینه‌های مرتبط با همهٔ سرورها در صورت عدم وجود گزینه‌های مختص سرور، خواهد بود..SS remote\-option6\-global\-set
.sp
این دستور یک گزینهٔ سراسری DHCPv6 را در پایگاه‌دادهٔ پیکربندی ایجاد یا جایگزین می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس بودن: 1.6.0 (کتابخانه قلاب cb_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
شرح و مثال‌ها: دستور remote\-option6\-global\-set را ببینید \%<#\:command-remote-option6-global-set>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-option6\-global\-set\(dq,
    \(dqarguments\(dq: {
        \(dqoptions\(dq: [
            {
                <global option specification>
            }
        ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        },
        \(dqserver\-tags\(dq: [ <single server tag as string> ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
فهرست ارائه‌شده باید دقیقاً شامل یک مشخصات گزینه باشد. فهرست \fBserver\-tags\fP الزامی است و باید دقیقاً شامل یک تگ سرور باشد. مشخص کردن یک فهرست خالی، مقدار \fBnull\fP، یا چندین تگ سرور منجر به خطا خواهد شد. تگ سرور \(dqall\(dq مجاز است؛ این تگ گزینهٔ مشخص‌شده را به تمام سرورها مرتبط می‌کند.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqDHCPv6 option set.\(dq,
    \(dqarguments\(dq: {
        \(dqoptions\(dq: [
            {
                \(dqcode\(dq: <option code>,
                \(dqspace\(dq: <option space>,
                \(dqclient\-classes\(dq: [ <one or more comma\-separated strings> ]
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت انجام شد، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (conflict) (دستور نتوانست تغییرات پیکربندی درخواست‌شده را اعمال کند زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT
.SS remote\-option6\-network\-del
.sp
این دستور یک گزینهٔ DHCPv6 را از یک شبکهٔ مشترک (shared network) در پایگاه‌دادهٔ پیکربندی حذف می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس بودن: 1.6.0 (کتابخانه قلاب cb_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
شرح و مثال‌ها: دستور remote\-option6\-network\-del را ببینید \%<#\:command-remote-option6-network-del>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-option6\-network\-del\(dq,
    \(dqarguments\(dq: {
        \(dqshared\-networks\(dq: [
            {
                \(dqname\(dq: <shared network name>
            }
        ],
        \(dqoptions\(dq: [
            {
                \(dqcode\(dq: <option code>,
                \(dqspace\(dq: <option space>,
                \(dqclient\-classes\(dq: [ <zero or more comma\-separated strings> ]
            }
        ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور شامل دو فهرست با دقیقاً یک نام از شبکهٔ مشترک و دقیقاً یک مشخصات گزینه است، شامل نام گزینه، کد، و از نسخهٔ Kea 3.1.1، پارامتر اختیاری client\-classes (بخش Option Class\-tags as Keys را ببینید \%<#\:cb-cmds-option-class-tags-as-keys>). مشخص کردن یک فهرست خالی، مقدار \fBnull\fP، یا یک تگ سرور منجر به بروز خطا خواهد شد.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq1 DHCPv6 option(s) deleted.\(dq,
    \(dqarguments\(dq: {
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت انجام شد، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (conflict) (دستور نتوانست تغییرات پیکربندی درخواست‌شده را اعمال کند زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT.SS remote\-option6\-network\-set
.sp
این دستور یک گزینهٔ DHCPv6 را در یک شبکهٔ مشترک (shared network) در پایگاه‌دادهٔ پیکربندی ایجاد یا جایگزین می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس بودن: 1.6.0 (کتابخانهٔ قلاب cb_cmds)
.sp
سطح دسترسی: write \fI(این پارامتر در این نسخهٔ Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-option6\-network\-set را ببینید \%<#\:command-remote-option6-network-set>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-option6\-network\-set\(dq,
    \(dqarguments\(dq: {
        \(dqshared\-networks\(dq: [
            {
                \(dqname\(dq: <shared network name>
            }
        ],
        \(dqoptions\(dq: [
            {
                <shared network option specification>
            }
        ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
فهرست‌های ارائه‌شده باید دقیقاً شامل یک نام شبکهٔ مشترک و یک مشخصهٔ گزینه باشند. تعیین یک فهرست خالی، مقدار \fBnull\fP یا یک برچسب سرور منجر به خطا خواهد شد.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqDHCPv6 option successfully set.\(dq,
    \(dqarguments\(dq: {
        \(dqoptions\(dq: [
            {
                \(dqcode\(dq: <option code>,
                \(dqspace\(dq: <option space>,
                \(dqclient\-classes\(dq: [ <one or more comma\-separated strings> ]
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه (Result) یک نمایش عددی صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (دستور با موفقیت انجام شد، اما هیچ داده‌ای تغییر نکرد یا بازگردانده نشد) (empty)
.IP \(bu 2
4 \- تداخل (دستور نتوانست تغییرات پیکربندی درخواست‌شده را اعمال کند زیرا با وضعیت سرور در تداخل بودند) (conflict)
.UNINDENT
.SS remote\-option6\-pd\-pool\-del
.sp
این دستور یک گزینهٔ DHCPv6 را از یک استخر تفویض پیشوند (prefix delegation pool) در پایگاه‌دادهٔ پیکربندی حذف می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس بودن: 1.6.0 (کتابخانهٔ قلاب cb_cmds)
.sp
سطح دسترسی: write \fI(این پارامتر در این نسخهٔ Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-option6\-pd\-pool\-del را ببینید \%<#\:command-remote-option6-pd-pool-del>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-option6\-pd\-pool\-del\(dq,
    \(dqarguments\(dq: {
        \(dqpd\-pools\(dq: [
            {
                \(dqprefix\(dq: <pool prefix (address part)>,
                \(dqprefix\-len\(dq: <pool prefix (length part)>,
                \(dqclient\-classes\(dq: [ <zero or more comma\-separated strings> ]
            }
        ],
        \(dqoptions\(dq: [
            {
                \(dqcode\(dq: <option code>,
                \(dqspace\(dq: <option space>
            }
        ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور شامل دو فهرست است که دقیقاً شامل یک مشخصهٔ استخر تفویض پیشوند و دقیقاً یک مشخصهٔ گزینه شامل نام گزینه، کد و از نسخهٔ Kea 3.1.1، پارامتر اختیاری client\-classes می‌شوند (بخش Option Class\-tags as Keys را ببینید \%<#\:cb-cmds-option-class-tags-as-keys>). تعیین یک فهرست خالی، مقدار \fBnull\fP یا یک برچسب سرور منجر به خطا خواهد شد.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq1 DHCPv6 option(s) deleted.\(dq,
    \(dqarguments\(dq: {
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه (Result) یک نمایش عددی صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (دستور با موفقیت انجام شد، اما هیچ داده‌ای تغییر نکرد یا بازگردانده نشد) (empty)
.IP \(bu 2
4 \- تداخل (دستور نتوانست تغییرات پیکربندی درخواست‌شده را اعمال کند زیرا با وضعیت سرور در تداخل بودند) (conflict)
.UNINDENT.SS remote\-option6\-pd\-pool\-set
.sp
این دستور یک گزینهٔ DHCPv6 را در یک استخر واگذاری پیشوند (prefix delegation pool) در پایگاه‌دادهٔ پیکربندی ایجاد یا جایگزین می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس از: 1.6.0 (کتابخانهٔ قلاب cb_cmds)
.sp
دسترسی: write \fI(پارامتر در این نسخهٔ Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-option6\-pd\-pool\-set را ببینید \%<#\:command-remote-option6-pd-pool-set>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-option6\-pd\-pool\-set\(dq,
    \(dqarguments\(dq: {
        \(dqpd\-pools\(dq: [
            {
                \(dqprefix\(dq: <pool prefix (address part)>,
                \(dqprefix\-len\(dq: <pool prefix (length part)>
            }
        ],
        \(dqoptions\(dq: [
            {
                <prefix delegation pool option specification>
            }
        ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور شامل دو فهرست با دقیقاً یک مشخصهٔ استخر واگذاری پیشوند و دقیقاً یک مشخصهٔ گزینه است. مشخص کردن یک فهرست خالی، یک مقدار \fBnull\fP یا یک برچسب کارساز منجر به بروز خطا خواهد شد.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqDHCPv6 option successfully set.\(dq,
    \(dqarguments\(dq: {
        \(dqoptions\(dq: [
            {
                \(dqcode\(dq: <option code>,
                \(dqspace\(dq: <option space>,
                \(dqclient\-classes\(dq: [ <one or more comma\-separated strings> ]
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه (result) نمایش عدد صحیح وضعیت است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت پایان یافت، اما هیچ داده‌ای متأثر نشد یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (conflict) (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند، زیرا با وضعیت کارساز در تعارض بودند)
.UNINDENT
.SS remote\-option6\-pool\-del
.sp
این دستور یک گزینهٔ DHCPv6 را از یک استخر نشانی در پایگاه‌دادهٔ پیکربندی حذف می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس از: 1.6.0 (کتابخانهٔ قلاب cb_cmds)
.sp
دسترسی: write \fI(پارامتر در این نسخهٔ Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-option6\-pool\-del را ببینید \%<#\:command-remote-option6-pool-del>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-option6\-pool\-del\(dq,
    \(dqarguments\(dq: {
        \(dqpools\(dq: [
            {
                \(dqpool\(dq: <pool range or prefix>
            }
        ],
        \(dqoptions\(dq: [
            {
                \(dqcode\(dq: <option code>,
                \(dqspace\(dq: <option space>,
                \(dqclient\-classes\(dq: [ <zero or more comma\-separated strings> ]
            }
        ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور شامل دو فهرست با دقیقاً یک مشخصهٔ استخر نشانی و دقیقاً یک مشخصهٔ گزینه است، شامل نام گزینه، کد و از Kea 3.1.1 به بعد، پارامتر اختیاری client\-classes (بخش Option Class\-tags as Keys را ببینید \%<#\:cb-cmds-option-class-tags-as-keys>). مشخص کردن یک فهرست خالی، یک مقدار \fBnull\fP یا یک برچسب کارساز منجر به بروز خطا خواهد شد.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq1 DHCPv6 option(s) deleted.\(dq,
    \(dqarguments\(dq: {
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه (result) نمایش عدد صحیح وضعیت است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت پایان یافت، اما هیچ داده‌ای متأثر نشد یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (conflict) (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند، زیرا با وضعیت کارساز در تعارض بودند)
.UNINDENT.SS remote\-option6\-pool\-set
.sp
این دستور یک گزینه DHCPv6 را در یک استخر نشانی در پایگاه‌داده پیکربندی ایجاد یا جایگزین می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس از: 1.6.0 (کتابخانه قلاب cb_cmds)
.sp
دسترسی: write \fI(پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-option6\-pool\-set را ببینید \%<#\:command-remote-option6-pool-set>
.sp
ساختار دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-option6\-pool\-set\(dq,
    \(dqarguments\(dq: {
        \(dqpools\(dq: [
            {
                \(dqpool\(dq: <pool range or prefix>
            }
        ],
        \(dqoptions\(dq: [
            {
                <address pool option specification>
            }
        ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور شامل دو فهرست با مشخصات دقیق استخر نشانی و مشخصات دقیق یک گزینه است. مشخص کردن یک فهرست خالی، مقدار \fBnull\fP، یا یک برچسب سرور منجر به خطا خواهد شد.
.sp
ساختار پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqDHCPv6 option successfully set.\(dq,
    \(dqarguments\(dq: {
        \(dqoptions\(dq: [
            {
                \(dqcode\(dq: <option code>,
                \(dqspace\(dq: <option space>,
                \(dqclient\-classes\(dq: [ <one or more comma\-separated strings> ]
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت
.IP \(bu 2
1 \- خطا
.IP \(bu 2
2 \- پشتیبانی‌نشده
.IP \(bu 2
3 \- خالی (دستور با موفقیت کامل شد، اما هیچ داده‌ای تغییر نکرد یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تداخل بودند)
.UNINDENT
.SS remote\-option6\-subnet\-del
.sp
این دستور یک گزینه DHCPv6 را از یک زیرشبکه در پایگاه‌داده پیکربندی حذف می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس از: 1.6.0 (کتابخانه قلاب cb_cmds)
.sp
دسترسی: write \fI(پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-option6\-subnet\-del را ببینید \%<#\:command-remote-option6-subnet-del>
.sp
ساختار دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-option6\-subnet\-del\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [
            {
                \(dqid\(dq: <subnet identifier>
            }
        ],
        \(dqoptions\(dq: [
            {
                \(dqcode\(dq: <option code>,
                \(dqspace\(dq: <option space>,
                \(dqclient\-classes\(dq: [ <zero or more comma\-separated strings> ]
            }
        ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور شامل دو فهرست با دقیقاً یک شناسه زیرشبکه و مشخصات دقیق یک گزینه است که شامل نام گزینه، کد، و از نسخه Kea 3.1.1 به بعد، پارامتر اختیاری client\-classes می‌شود (بخش Option Class\-tags as Keys را ببینید \%<#\:cb-cmds-option-class-tags-as-keys>). مشخص کردن یک فهرست خالی، مقدار \fBnull\fP، یا یک برچسب سرور منجر به خطا خواهد شد.
.sp
ساختار پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq1 DHCPv6 option(s) deleted.\(dq,
    \(dqarguments\(dq: {
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت
.IP \(bu 2
1 \- خطا
.IP \(bu 2
2 \- پشتیبانی‌نشده
.IP \(bu 2
3 \- خالی (دستور با موفقیت کامل شد، اما هیچ داده‌ای تغییر نکرد یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تداخل بودند)
.UNINDENT.SS remote\-option6\-subnet\-set
.sp
این دستور یک گزینهٔ DHCPv6 را در یک زیرشبکه در پایگاه‌دادهٔ پیکربندی ایجاد یا جایگزین می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
دردسترس‌بودن: 1.6.0 (کتابخانه قلاب cb_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخهٔ Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-option6\-subnet\-set را ببینید \%<#\:command-remote-option6-subnet-set>
.sp
ساختار دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-option6\-subnet\-set\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [
            {
                \(dqid\(dq: <subnet identifier>
            }
        ],
        \(dqoptions\(dq: [
            {
                <subnet option specification>
            }
        ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
فهرست‌های ارائه‌شده باید دقیقاً شامل یک شناسهٔ زیرشبکه و یک مشخصات گزینه باشند. تعیین یک فهرست خالی، یک مقدار \fBnull\fP، یا یک برچسب سرور منجر به خطا خواهد شد.
.sp
ساختار پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqDHCPv6 option successfully set.\(dq,
    \(dqarguments\(dq: {
        \(dqoptions\(dq: [
            {
                \(dqcode\(dq: <option code>,
                \(dqspace\(dq: <option space>
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (دستور با موفقیت پایان یافت، اما داده‌ای تغییر نیافت یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (دستور نتوانست تغییرات پیکربندی درخواست‌شده را اعمال کند زیرا با وضعیت سرور در تداخل بودند)
.UNINDENT
.SS remote\-server4\-del
.sp
این دستور اطلاعات مربوط به یک سرور DHCPv4 را از پایگاه‌دادهٔ پیکربندی حذف می‌کند. هر پیکربندی که به‌طور صریح با سرور حذف‌شده مرتبط باشد، به‌طور خودکار جداسازی می‌شود. علاوه بر این، مؤلفه‌های پیکربندی که با سرورهای دیگر قابل اشتراک‌گذاری نیستند (مانند پارامترهای سراسری DHCP) حذف می‌شوند. مؤلفه‌های پیکربندی قابل اشتراک‌گذاری (مانند زیرشبکه‌ها، شبکه‌های اشتراکی) حذف نمی‌شوند چرا که ممکن است توسط سرورهای دیگر استفاده شوند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
دردسترس‌بودن: 1.6.0 (کتابخانه قلاب cb_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخهٔ Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-server4\-del را ببینید \%<#\:command-remote-server4-del>
.sp
ساختار دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-server4\-del\(dq,
    \(dqarguments\(dq: {
        \(dqservers\(dq: [
            {
                \(dqserver\-tag\(dq: <server name>
            }
        ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور حاوی فهرستی است که دقیقاً شامل یک نگاشت با برچسب سرورِ مورد نظر برای حذف می‌باشد.
.sp
ساختار پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq1 DHCPv4 server(s) deleted.\(dq,
    \(dqarguments\(dq: {
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (دستور با موفقیت پایان یافت، اما داده‌ای تغییر نیافت یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (دستور نتوانست تغییرات پیکربندی درخواست‌شده را اعمال کند زیرا با وضعیت سرور در تداخل بودند)
.UNINDENT.SS remote\-server4\-get
.sp
این دستور اطلاعاتی درباره کارساز DHCPv4، مانند برچسب کارساز و توضیحات آن را واکشی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس بودن: 1.6.0 (کتابخانه قلاب cb_cmds)
.sp
دسترسی: read \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-server4\-get را ببینید \%<#\:command-remote-server4-get>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-server4\-get\(dq,
    \(dqarguments\(dq: {
        \(dqservers\(dq: [
            {
                \(dqserver\-tag\(dq: <server tag>
            }
        ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور فهرستی را حمل می‌کند که دقیقاً شامل یک نگاشت با برچسب کارساز موردنظر برای واکشی است.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqDHCP server \(aqserver tag\(aq found.\(dq,
    \(dqarguments\(dq: {
        \(dqservers\(dq: [
            {
                \(dqserver\-tag\(dq: <server tag>,
                \(dqdescription\(dq: <server description>
            }
        ],
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
برچسب کارساز (server tag) شناسه یکتای کارساز است که برای مرتبط کردن عناصر پیکربندی در پایگاه‌داده با نمونه کارساز خاص استفاده می‌شود. توضیحات کارساز بازگردانده‌شده توسط کاربر هنگام تنظیم اطلاعات کارساز مشخص می‌شود.
.SS remote\-server4\-get\-all
.sp
این دستور اطلاعات مربوط به تمام کارسازهای DHCPv4 مشخص‌شده توسط کاربر را واکشی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس بودن: 1.6.0 (کتابخانه قلاب cb_cmds)
.sp
دسترسی: read \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-server4\-get\-all را ببینید \%<#\:command-remote-server4-get-all>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-server4\-get\-all\(dq,
    \(dqarguments\(dq: {
        \(dqremote\(dq: {
            <specification of the database to connect to>
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور به جز \fBremote\fP\& اختیاری هیچ آرگومانی ندارد.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqDHCPv4 servers found.\(dq,
    \(dqarguments\(dq: {
        \(dqservers\(dq: [
            {
                \(dqserver\-tag\(dq: <first server tag>,
                \(dqdescription\(dq: <first server description>
            },
            {
                \(dqserver\-tag\(dq: <second server tag>,
                \(dqdescription\(dq: <second server description>
            }
        ],
        \(dqcount\(dq: 2
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ بازگردانده‌شده شامل فهرستی از نگاشت‌ها است. هر نگاشت حاوی یک برچسب کارساز است که کارساز را به‌طور یکتا شناسایی می‌کند، و همچنین توضیحات تعریف‌شده توسط کاربر برای کارساز. بخش پشتیبان پیکربندی Kea از کلیدواژه \fBall\fP برای مرتبط ساختن بخش‌هایی از پیکربندی با همه کارسازها استفاده می‌کند. این بخش به صورت داخلی کارساز منطقی \fBall\fP را برای این منظور ایجاد می‌کند. با این حال، این کارساز منطقی به عنوان نتیجه دستور \fBremote\-server4\-get\-all\fP بازگردانده نمی‌شود؛ تنها کارسازهای تعریف‌شده توسط کاربر بازگردانده می‌شوند.
.SS remote\-server4\-set
.sp
این دستور اطلاعات مربوط به کارساز DHCPv4 را در پایگاه‌داده ایجاد یا جایگزین می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس بودن: 1.6.0 (کتابخانه قلاب cb_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-server4\-set را ببینید \%<#\:command-remote-server4-set>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-server4\-set\(dq,
    \(dqarguments\(dq: {
        \(dqservers\(dq: [
            {
                \(dqserver\-tag\(dq: <server tag>,
                \(dqdescription\(dq: <server description>
            }
        ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
فهرست ارائه‌شده باید دقیقاً شامل مشخصات یک کارساز باشد. \fBserver\-tag\fP باید در میان تمام کارسازهای درون پایگاه‌داده پیکربندی یکتا باشد. \fBdescription\fP متن دلخواهی است که کارساز، موقعیت آن در شبکه و غیره را توصیف می‌کند.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqDHCPv4 server successfully set.\(dq,
    \(dqarguments\(dq: {
        \(dqservers\(dq: [
            {
                \(dqserver\-tag\(dq: <server tag>,
                \(dqdescription\(dq: <server description>
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت کامل شد، اما داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (conflict) (دستور نتوانست تغییرات پیکربندی درخواست‌شده را اعمال کند زیرا با وضعیت کارساز در تعارض بودند)
.UNINDENT.SS remote\-server6\-del
.sp
این دستور اطلاعات مربوط به یک سرور DHCPv6 را از پایگاه‌داده پیکربندی حذف می‌کند. هر پیکربندی که به‌طور صریح با سرور حذف‌شده مرتبط شده باشد، به‌طور خودکار ارتباطش قطع می‌شود. علاوه بر این، عناصر پیکربندی که با سایر سرورها قابل اشتراک‌گذاری نیستند (مانند پارامترهای سراسری DHCP) حذف می‌شوند. عناصر پیکربندی قابل اشتراک‌گذاری (مانند زیرشبکه‌ها و شبکه‌های مشترک) حذف نمی‌شوند چرا که ممکن است توسط سایر سرورها استفاده شوند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس از: 1.6.0 (کتابخانه قلاب cb_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-server6\-del را ببینید \%<#\:command-remote-server6-del>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-server6\-del\(dq,
    \(dqarguments\(dq: {
        \(dqservers\(dq: [
            {
                \(dqserver\-tag\(dq: <server name>
            }
        ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور فهرستی شامل دقیقاً یک نگاشت با برچسب سروری که باید حذف شود را حمل می‌کند.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq1 DHCPv6 server(s) deleted.\(dq,
    \(dqarguments\(dq: {
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عددی از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت
.IP \(bu 2
1 \- خطا
.IP \(bu 2
2 \- پشتیبانی‌نشده
.IP \(bu 2
3 \- خالی (دستور با موفقیت به پایان رسید، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT
.SS remote\-server6\-get
.sp
این دستور اطلاعات مربوط به سرور DHCPv6، مانند برچسب و توضیحات سرور را واکشی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس از: 1.6.0 (کتابخانه قلاب cb_cmds)
.sp
دسترسی: read \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-server6\-get را ببینید \%<#\:command-remote-server6-get>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-server6\-get\(dq,
    \(dqarguments\(dq: {
        \(dqservers\(dq: [
            {
                \(dqserver\-tag\(dq: <server tag>
            }
        ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور فهرستی شامل دقیقاً یک نگاشت با برچسب سروری که باید واکشی شود را حمل می‌کند.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqDHCP server \(aqserver tag\(aq found.\(dq,
    \(dqarguments\(dq: {
        \(dqservers\(dq: [
            {
                \(dqserver\-tag\(dq: <server tag>,
                \(dqdescription\(dq: <server description>
            }
        ],
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
برچسب سرور (server tag) شناسه یکتای سرور است که برای مرتبط کردن عناصر پیکربندی در پایگاه‌داده با نمونه سرور مشخص استفاده می‌شود. توضیحات بازگردانده‌شده سرور توسط کاربر هنگام تعیین اطلاعات سرور مشخص می‌شود..SS remote\-server6\-get\-all
.sp
این دستور اطلاعات مربوط به تمام سرورهای DHCPv6 مشخص‌شده توسط کاربر را واکشی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
دردسترس بودن: 1.6.0 (کتابخانه قلاب cb_cmds)
.sp
دسترسی: خواندن \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-server6\-get\-all را ببینید \%<#\:command-remote-server6-get-all>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-server6\-get\-all\(dq,
    \(dqarguments\(dq: {
        \(dqremote\(dq: {
            <specification of the database to connect to>
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور به جز گزینه اختیاری \fBremote\fP\& هیچ آرگومان دیگری ندارد.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqDHCPv6 servers found.\(dq,
    \(dqarguments\(dq: {
        \(dqservers\(dq: [
            {
                \(dqserver\-tag\(dq: <first server tag>,
                \(dqdescription\(dq: <first server description>
            },
            {
                \(dqserver\-tag\(dq: <second server tag>,
                \(dqdescription\(dq: <second server description>
            }
        ],
        \(dqcount\(dq: 2
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ بازگردانده‌شده شامل فهرستی از نگاشت‌ها است. هر نگاشت حاوی یک برچسب سرور است که سرور را به‌طور یکتا مشخص می‌کند، و توصیفی که توسط کاربر برای سرور تعیین شده است. بخش پشتیبان پیکربندی کی (Kea Configuration Backend) از کلیدواژه \fBall\fP برای مرتبط ساختن بخش‌هایی از پیکربندی با همه سرورها استفاده می‌کند. این بخش در درون خود، سرور منطقی \fBall\fP را برای این منظور ایجاد می‌کند. با این حال، این سرور منطقی در خروجی دستور \fBremote\-server6\-get\-all\fP بازگردانده نمی‌شود؛ تنها سرورهای تعریف‌شده توسط کاربر بازگردانده می‌شوند.
.SS remote\-server6\-set
.sp
این دستور اطلاعات مربوط به سرور DHCPv6 را در پایگاه‌داده ایجاد یا جایگزین می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
دردسترس بودن: 1.6.0 (کتابخانه قلاب cb_cmds)
.sp
دسترسی: نوشتن \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-server6\-set را ببینید \%<#\:command-remote-server6-set>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-server6\-set\(dq,
    \(dqarguments\(dq: {
        \(dqservers\(dq: [
            {
                \(dqserver\-tag\(dq: <server tag>,
                \(dqdescription\(dq: <server description>
            }
        ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
فهرست ارائه‌شده باید دقیقاً حاوی مشخصات یک سرور باشد. مقدار \fBserver\-tag\fP باید در میان تمام سرورهای موجود در پایگاه‌داده پیکربندی یکتا باشد. مقدار \fBdescription\fP متنی دلخواه برای توصیف سرور، موقعیت آن در شبکه و غیره است.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqDHCPv6 server successfully set.\(dq,
    \(dqarguments\(dq: {
        \(dqservers\(dq: [
            {
                \(dqserver\-tag\(dq: <server tag>,
                \(dqdescription\(dq: <server description>
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عددی صحیح از وضعیت است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت
.IP \(bu 2
1 \- خطا
.IP \(bu 2
2 \- پشتیبانی‌نشده
.IP \(bu 2
3 \- خالی (دستور با موفقیت کامل شد، اما داده‌ای تغییر نیافت یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تداخل بودند)
.UNINDENT.SS remote\-subnet4\-del\-by\-id
.sp
این دستور یک زیرشبکه IPv4 را با استفاده از شناسه (ID) از پایگاه‌داده پیکربندی حذف می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
دسترس‌پذیری: 1.6.0 (کتابخانه قلاب cb_cmds)
.sp
سطح دسترسی: write \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-subnet4\-del\-by\-id را ببینید \%<#\:command-remote-subnet4-del-by-id>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-subnet4\-del\-by\-id\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [
            {
                \(dqid\(dq: <subnet identifier>
            }
        ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور شامل فهرستی با دقیقاً یک شناسه از زیرشبکه برای حذف است. پارامتر \fBserver\-tags\fP نباید برای این دستور مشخص شود.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq1 IPv4 subnet(s) deleted.\(dq,
    \(dqarguments\(dq: {
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌های پشتیبانی‌شده فعلی عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت انجام شد، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (conflict) (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT
.SS remote\-subnet4\-del\-by\-prefix
.sp
این دستور یک زیرشبکه IPv4 را با استفاده از پیشوند از پایگاه‌داده پیکربندی حذف می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
دسترس‌پذیری: 1.6.0 (کتابخانه قلاب cb_cmds)
.sp
سطح دسترسی: write \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-subnet4\-del\-by\-prefix را ببینید \%<#\:command-remote-subnet4-del-by-prefix>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-subnet4\-del\-by\-prefix\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [
            {
                \(dqsubnet\(dq: <subnet prefix>
            }
        ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور شامل فهرستی با دقیقاً یک پیشوند از زیرشبکه برای حذف است. پارامتر \fBserver\-tags\fP نباید برای این دستور مشخص شود.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq1 IPv4 subnet(s) deleted.\(dq,
    \(dqarguments\(dq: {
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌های پشتیبانی‌شده فعلی عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت انجام شد، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (conflict) (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT.SS remote\-subnet4\-get\-by\-id
.sp
این دستور زیرشبکه IPv4 انتخاب‌شده را بر اساس شناسه (ID) از پایگاه داده پیکربندی واکشی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس بودن: 1.6.0 (کتابخانه قلاب cb_cmds)
.sp
دسترسی: read \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-subnet4\-get\-by\-id را ببینید \%<#\:command-remote-subnet4-get-by-id>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-subnet4\-get\-by\-id\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [ {
            \(dqid\(dq: <subnet identifier>
        } ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور شامل فهرستی با دقیقاً یک شناسه از زیرشبکه‌ای است که باید بازگردانده شود. پارامتر \fBserver\-tags\fP نباید برای این دستور مشخص شود.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqIPv4 subnet found.\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [ {
            \(dqid\(dq: <subnet identifier>,
            \(dqsubnet\(dq: <subnet prefix>,
            \(dqshared\-network\-name\(dq: <shared network name or null>,
            \(dqmetadata\(dq: {
                \(dqserver\-tags\(dq: [ <first server tag>, <second server tag>, ... ]
            },
            <the rest of the subnet specification here>
        } ],
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر نام شبکه مشترک (shared network) برابر با null باشد، به این معنی است که زیرشبکه بازگردانده‌شده متعلق به هیچ شبکه مشترکی نیست (یک زیرشبکه سراسری یا global subnet). متادیتا در تعریف زیرشبکه بازگردانده‌شده گنجانده شده و اطلاعات خاص پایگاه داده مرتبط با شیء بازگردانده‌شده را ارائه می‌دهد.
.SS remote\-subnet4\-get\-by\-prefix
.sp
این دستور زیرشبکه IPv4 انتخاب‌شده را بر اساس پیشوند (prefix) از پایگاه داده پیکربندی واکشی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس بودن: 1.6.0 (کتابخانه قلاب cb_cmds)
.sp
دسترسی: read \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-subnet4\-get\-by\-prefix را ببینید \%<#\:command-remote-subnet4-get-by-prefix>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-subnet4\-get\-by\-prefix\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [ {
            \(dqsubnet\(dq: <subnet prefix>
        } ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور شامل فهرستی با دقیقاً یک پیشوند از زیرشبکه‌ای است که باید بازگردانده شود. پارامتر \fBserver\-tags\fP نباید برای این دستور مشخص شود.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqIPv4 subnet found.\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [
            {
                \(dqid\(dq: <subnet identifier>,
                \(dqsubnet\(dq: <subnet prefix>,
                \(dqshared\-network\-name\(dq: <shared network name or null>,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ <first server tag>, <second server tag>, ... ]
                },
                <the rest of the subnet specification here>
            }
        ],
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر نام شبکه مشترک (shared network) برابر با null باشد، به این معنی است که زیرشبکه بازگردانده‌شده متعلق به هیچ شبکه مشترکی نیست (زیرشبکه سراسری یا global subnet). متادیتا در تعریف زیرشبکه بازگردانده‌شده گنجانده شده و اطلاعات خاص پایگاه داده مرتبط با شیء بازگردانده‌شده را ارائه می‌دهد..SS remote\-subnet4\-list
.sp
این دستور فهرستی از تمام زیرشبکه‌های IPv4 را از پایگاه‌داده پیکربندی واکشی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس بودن: 1.6.0 (کتابخانه قلاب cb_cmds)
.sp
دسترسی: خواندن \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-subnet4\-list را ببینید \%<#\:command-remote-subnet4-list>
.sp
ساختار دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-subnet4\-list\(dq,
    \(dqarguments\(dq: {
        \(dqremote\(dq: {
            <specification of the database to connect to>
        },
        \(dqserver\-tags\(dq: [ <first server tag>, <second server tag>, ... ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
فهرست \fBserver\-tags\fP برای این دستور الزامی است و نباید خالی باشد. این فهرست می‌تواند شامل یک یا چند برچسب سرور به‌صورت رشته، یا یک مقدار منفرد \fBnull\fP باشد.
.sp
ساختار پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq2 IPv4 subnets found.\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [
            {
                \(dqid\(dq: <first subnet identifier>,
                \(dqsubnet\(dq: <first subnet prefix>,
                \(dqshared\-network\-name\(dq: <shared network name or null>,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ <first server tag>, <second server tag>, ... ]
                }
            },
            {
                \(dqid\(dq: <second subnet identifier>,
                \(dqsubnet\(dq: <second subnet prefix>,
                \(dqshared\-network\-name\(dq: <shared network name or null>,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ <first server tag>, ... ]
                }
            }
        ],
        \(dqcount\(dq: 2
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ بازگردانده‌شده شامل فهرستی از نگاشت‌ها است. هر نگاشت حاوی یک شناسه زیرشبکه، پیشوند و نام شبکه اشتراکی است که زیرشبکه به آن تعلق دارد. اگر زیرشبکه به هیچ شبکه اشتراکی تعلق نداشته باشد، این نام null است. متادیتا شامل اطلاعات مختص پایگاه‌داده است که با زیرشبکه‌ها مرتبط است. فهرست بازگردانده‌شده شامل تعاریف کامل زیرشبکه نیست؛ برای واکشی اطلاعات کامل درباره زیرشبکه‌های انتخاب‌شده از \fBremote\-subnet4\-get\fP استفاده کنید. اگر دستور شامل برچسب‌های سرور صریح به‌صورت رشته باشد (از جمله برچسب ویژه سرور \(dqall\(dq)، فهرست شامل تمام زیرشبکه‌هایی خواهد بود که با هر یک از برچسب‌های مشخص‌شده مرتبط هستند. حتی اگر یک زیرشبکه با چندین سرور مرتبط باشد و تنها یکی از برچسب‌های مشخص‌شده مطابقت داشته باشد، آن زیرشبکه بازگردانده می‌شود. اگر دستور حاوی مقدار \fBnull\fP در فهرست \fBserver\-tags\fP باشد، پاسخ شامل تمام زیرشبکه‌هایی است که به هیچ سروری تخصیص داده نشده‌اند (تخصیص‌نیافته).
.SS remote\-subnet4\-set
.sp
این دستور یک زیرشبکه IPv4 را در پایگاه‌داده پیکربندی ایجاد کرده یا جایگزین می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس بودن: 1.6.0 (کتابخانه قلاب cb_cmds)
.sp
دسترسی: نوشتن \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-subnet4\-set را ببینید \%<#\:command-remote-subnet4-set>
.sp
ساختار دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-subnet4\-set\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [
            {
                \(dqid\(dq: <subnet identifier>,
                \(dqsubnet\(dq: <subnet prefix>,
                \(dqshared\-network\-name\(dq: <shared network name or null>,
                <the rest of the subnet specification here>
            }
        ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        },
        \(dqserver\-tags\(dq: [ <first server tag>, <second server tag>, ... ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
فهرست ارائه‌شده باید دقیقاً شامل یک مشخصه زیرشبکه باشد. پارامتر \fBshared\-network\-name\fP برای این دستورها الزامی است؛ این پارامتر زیرشبکه را بر اساس نام شبکه اشتراکی، به آن مرتبط می‌سازد. اگر زیرشبکه نباید به هیچ شبکه اشتراکی تعلق داشته باشد (یک زیرشبکه سراسری)، باید مقدار \fBnull\fP برای نام شبکه اشتراکی مشخص شود. فهرست \fBserver\-tags\fP اجباری است و باید شامل یک یا چند برچسب سرور به‌صورت رشته باشد تا زیرشبکه را به‌طور صریح با یک یا چند سرور تعریف‌شده توسط کاربر مرتبط کند. دستور \fBremote\-subnet4\-set\fP ممکن است شامل برچسب ویژه سرور \(dqall\(dq برای مرتبط کردن زیرشبکه با تمام سرورها باشد.
.sp
ساختار پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqIPv4 subnet successfully set.\(dq,
    \(dqarguments\(dq: {
        \(dqid\(dq: <subnet identifier>,
        \(dqsubnet\(dq: <subnet prefix>
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty \- دستور با موفقیت کامل شد، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (conflict \- دستور نتوانست تغییرات پیکربندی درخواست‌شده را اعمال کند زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT.SS remote\-subnet6\-del\-by\-id
.sp
این دستور یک زیرشبکه IPv6 را بر اساس شناسه از پایگاه‌داده پیکربندی حذف می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس بودن: 1.6.0 (کتابخانه هوک cb_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-subnet6\-del\-by\-id را ببینید \%<#\:command-remote-subnet6-del-by-id>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-subnet6\-del\-by\-id\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [
            {
                \(dqid\(dq: <subnet identifier>
            }
        ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور شامل فهرستی با دقیقاً یک شناسه از زیرشبکه‌ای است که باید حذف شود. پارامتر \fBserver\-tags\fP نباید برای این دستور مشخص شود.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq1 IPv6 subnet(s) deleted.\(dq,
    \(dqarguments\(dq: {
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت
.IP \(bu 2
1 \- خطا
.IP \(bu 2
2 \- پشتیبانی‌نشده
.IP \(bu 2
3 \- خالی (دستور با موفقیت کامل شد، اما هیچ داده‌ای تغییر نکرد یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (دستور نتوانست تغییرات پیکربندی درخواست‌شده را اعمال کند زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT
.SS remote\-subnet6\-del\-by\-prefix
.sp
این دستور یک زیرشبکه IPv6 را بر اساس پیشوند از پایگاه‌داده پیکربندی حذف می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس بودن: 1.6.0 (کتابخانه هوک cb_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-subnet6\-del\-by\-prefix را ببینید \%<#\:command-remote-subnet6-del-by-prefix>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-subnet6\-del\-by\-prefix\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [
            {
                \(dqsubnet\(dq: <subnet prefix>
            }
        ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور شامل فهرستی با دقیقاً یک پیشوند از زیرشبکه‌ای است که باید حذف شود. پارامتر \fBserver\-tags\fP نباید برای این دستور مشخص شود.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq1 IPv6 subnet(s) deleted.\(dq,
    \(dqarguments\(dq: {
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت
.IP \(bu 2
1 \- خطا
.IP \(bu 2
2 \- پشتیبانی‌نشده
.IP \(bu 2
3 \- خالی (دستور با موفقیت کامل شد، اما هیچ داده‌ای تغییر نکرد یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (دستور نتوانست تغییرات پیکربندی درخواست‌شده را اعمال کند زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT.SS remote\-subnet6\-get\-by\-id
.sp
این دستور زیرشبکه IPv6 انتخاب‌شده را بر اساس شناسه از پایگاه‌داده پیکربندی واکشی می‌کند.
.sp
پشتیبانی‌شده در: kea\-dhcp6
.sp
دردسترس‌بودن: 1.6.0 (کتابخانه قلاب cb_cmds)
.sp
دسترسی: read \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-subnet6\-get\-by\-id را ببینید \%<#\:command-remote-subnet6-get-by-id>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-subnet6\-get\-by\-id\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [
            {
                \(dqid\(dq: <subnet identifier>
            }
        ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور شامل فهرستی با دقیقاً یک شناسه از زیرشبکه‌ای است که باید بازگردانده شود. پارامتر \fBserver\-tags\fP نباید برای این دستور مشخص شود.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqIPv6 subnet found.\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [
            {
                \(dqid\(dq: <subnet identifier>,
                \(dqsubnet\(dq: <subnet prefix>,
                \(dqshared\-network\-name\(dq: <shared network name or null>,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ <first server tag>, <second server tag>, ... ]
                },
                <the rest of the subnet specification here>
            }
        ],
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر نام شبکه مشترک (shared network name) برابر با null باشد، به این معنی است که زیرشبکه بازگردانده‌شده به هیچ شبکه مشترکی تعلق ندارد (یک زیرشبکه سراسری). فراداده (metadata) در تعریف زیرشبکه بازگردانده‌شده گنجانده شده و اطلاعات مربوط به پایگاه‌داده را که با شیء بازگردانده‌شده مرتبط است ارائه می‌دهد.
.SS remote\-subnet6\-get\-by\-prefix
.sp
این دستور زیرشبکه IPv6 انتخاب‌شده را بر اساس پیشوند از پایگاه‌داده پیکربندی واکشی می‌کند.
.sp
پشتیبانی‌شده در: kea\-dhcp6
.sp
دردسترس‌بودن: 1.6.0 (کتابخانه قلاب cb_cmds)
.sp
دسترسی: read \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-subnet6\-get\-by\-prefix را ببینید \%<#\:command-remote-subnet6-get-by-prefix>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-subnet6\-get\-by\-prefix\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [
            {
                \(dqsubnet\(dq: <subnet prefix>
            }
        ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
این دستور شامل فهرستی با دقیقاً یک پیشوند از زیرشبکه‌ای است که باید بازگردانده شود. پارامتر \fBserver\-tags\fP نباید برای این دستور مشخص شود.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqIPv6 subnet found.\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [ {
            \(dqid\(dq: <subnet identifier>,
            \(dqsubnet\(dq: <subnet prefix>,
            \(dqshared\-network\-name\(dq: <shared network name or null>,
            \(dqmetadata\(dq: {
                \(dqserver\-tags\(dq: [ <first server tag>, <second server tag>, ... ]
            },
            <the rest of the subnet specification here>
        } ],
        \(dqcount\(dq: 1
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر نام شبکه مشترک برابر با null باشد، به این معنی است که زیرشبکه بازگردانده‌شده به هیچ شبکه مشترکی تعلق ندارد (زیرشبکه سراسری). فراداده (metadata) در تعریف زیرشبکه بازگردانده‌شده گنجانده شده و اطلاعات مربوط به پایگاه‌داده را که با شیء بازگردانده‌شده مرتبط است ارائه می‌دهد..SS remote\-subnet6\-list
.sp
این دستور فهرستی از تمام زیرشبکه‌های IPv6 را از پایگاه داده پیکربندی واکشی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس بودن: 1.6.0 (کتابخانه قلاب cb_cmds)
.sp
دسترسی: خواندن \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-subnet6\-list را ببینید \%<#\:command-remote-subnet6-list>
.sp
ساختار دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-subnet6\-list\(dq,
    \(dqarguments\(dq: {
        \(dqremote\(dq: {
            <specification of the database to connect to>
        },
        \(dqserver\-tags\(dq: [ <first server tag>, <second server tag>, ... ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
فهرست \fBserver\-tags\fP برای این دستور الزامی است و نباید خالی باشد. این فهرست می‌تواند شامل یک یا چند برچسب سرور به صورت رشته، یا یک مقدار منفرد \fBnull\fP باشد.
.sp
ساختار پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq2 IPv6 subnets found.\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [
            {
                \(dqid\(dq: <first subnet identifier>,
                \(dqsubnet\(dq: <first subnet prefix>,
                \(dqshared\-network\-name\(dq: <shared network name or null>,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ <first server tag>, <second server tag>, ... ]
                }
            },
            {
                \(dqid\(dq: <second subnet identifier>,
                \(dqsubnet\(dq: <second subnet prefix>,
                \(dqshared\-network\-name\(dq: <shared network name or null>,
                \(dqmetadata\(dq: {
                    \(dqserver\-tags\(dq: [ <first server tag>, ... ]
                }
            }
        ],
        \(dqcount\(dq: 2
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پاسخ بازگردانده‌شده شامل فهرستی از نگاشت‌ها (maps) است. هر نگاشت حاوی یک شناسه زیرشبکه، پیشوند، و نام شبکه اشتراکی است که زیرشبکه به آن تعلق دارد. اگر زیرشبکه متعلق به هیچ شبکه اشتراکی نباشد، این نام null است. متادیتا شامل اطلاعات مختص پایگاه داده است که با زیرشبکه‌ها مرتبط هستند. فهرست بازگردانده‌شده شامل تعاریف کامل زیرشبکه نیست؛ برای واکشی اطلاعات کامل درباره زیرشبکه‌های انتخاب‌شده، از \fBremote\-subnet6\-get\fP استفاده کنید. اگر دستور شامل برچسب‌های سرور صریح به صورت رشته باشد (شامل برچسب سرور ویژه \(dqall\(dq)، فهرست شامل تمامی زیرشبکه‌هایی خواهد بود که با هر یک از برچسب‌های مشخص‌شده مرتبط هستند. یک زیرشبکه حتی در صورتی که با چندین سرور مرتبط باشد و تنها یکی از برچسب‌های مشخص‌شده مطابقت داشته باشد نیز بازگردانده می‌شود. اگر دستور شامل مقدار \fBnull\fP در فهرست \fBserver\-tags\fP باشد، پاسخ شامل تمامی زیرشبکه‌هایی خواهد بود که به هیچ سروری تخصیص نیافته‌اند (تخصیص‌نیافته).
.SS remote\-subnet6\-set
.sp
این دستور یک زیرشبکه IPv6 را در پایگاه داده پیکربندی ایجاد یا جایگزین می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس بودن: 1.6.0 (کتابخانه قلاب cb_cmds)
.sp
دسترسی: نوشتن \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور remote\-subnet6\-set را ببینید \%<#\:command-remote-subnet6-set>
.sp
ساختار دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqremote\-subnet6\-set\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [
            {
                \(dqid\(dq: <subnet identifier>,
                \(dqsubnet\(dq: <subnet prefix>,
                \(dqshared\-network\-name\(dq: <shared network name or null>,
                <the rest of the subnet specification here>
            }
        ],
        \(dqremote\(dq: {
            <specification of the database to connect to>
        },
        \(dqserver\-tags\(dq: [ <first server tag>, <second server tag>, ... ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
فهرست ارائه‌شده باید دقیقاً شامل مشخصات یک زیرشبکه باشد. پارامتر \fBshared\-network\-name\fP برای این دستورها الزامی است؛ این پارامتر زیرشبکه را از طریق نام آن به شبکه اشتراکی مرتبط می‌کند. اگر زیرشبکه نباید متعلق به هیچ شبکه اشتراکی باشد (یک زیرشبکه سراسری یا global)، باید مقدار \fBnull\fP برای نام شبکه اشتراکی مشخص شود. فهرست \fBserver\-tags\fP اجباری است و باید شامل یک یا چند برچسب سرور به صورت رشته باشد تا زیرشبکه را صراحتاً به یک یا چند سرور تعریف‌شده توسط کاربر مرتبط سازد. دستور \fBremote\-subnet6\-set\fP می‌تواند شامل برچسب سرور ویژه \(dqall\(dq باشد تا زیرشبکه را به تمامی سرورها مرتبط کند.
.sp
ساختار پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqIPv6 subnet successfully set.\(dq,
    \(dqarguments\(dq: {
        \(dqid\(dq: <subnet identifier>,
        \(dqsubnet\(dq: <subnet prefix>
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه، یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت کامل شد، اما هیچ داده‌ای تغییر نکرد یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (conflict) (دستور نتوانست تغییرات پیکربندی درخواست‌شده را اعمال کند زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT.SS reservation\-add
.sp
این دستور یک رزرو میزبان (host reservation) جدید اضافه می‌کند. این رزرو می‌تواند شامل نشانی‌های IPv4، نشانی‌های IPv6، پیشوندهای IPv6، شناسه‌های گوناگون، کلاسی که کلاینت به آن تخصیص داده می‌شود، گزینه‌های DHCPv4 و DHCPv6، و موارد دیگر باشد.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4، kea\-dhcp6
.sp
در دسترس بودن: 1.2.0 (کتابخانه هوک host_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور reservation\-add را ببینید \%<#\:command-reservation-add>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqreservation\-add\(dq,
    \(dqarguments\(dq: {
        \(dqreservation\(dq: {
            \(dqboot\-file\-name\(dq: <string>,
            \(dqclient\-id\(dq: <string>,
            \(dqcircuit\-id\(dq: <string>,
            \(dqduid\(dq: <string>,
            \(dqflex\-id\(dq: <string>,
            \(dqip\-address\(dq: <string (IPv4 address)>,
            \(dqip\-addresses\(dq: [ <comma\-separated strings> ],
            \(dqhw\-address\(dq: <string>,
            \(dqhostname\(dq: <string>,
            \(dqnext\-server\(dq: <string (IPv4 address)>,
            \(dqoption\-data\(dq: [ <comma\-separated structures defining options> ],
            \(dqprefixes\(dq: [ <comma\-separated IPv6 prefixes> ],
            \(dqclient\-classes\(dq: [ <comma\-separated strings> ],
            \(dqserver\-hostname\(dq: <string>,
            \(dqsubnet\-id\(dq: <integer>,
            \(dquser\-context\(dq: <any valid JSON>
        },
        \(dqoperation\-target\(dq: <string (memory, database, all, default)>
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
توجه داشته باشید که boot\-file\-name، circuit\-id، client\-id، ip\-address، next\-server و server\-hostname مختص IPv4 هستند. ip\-addresses و prefixes مختص IPv6 هستند. operation\-target اختیاری است؛ پیش‌فرض \(aqalternate\(aq است.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: <string>
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عددی از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت کامل شد، اما هیچ داده‌ای تغییر نیافت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (conflict) (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT
.SS reservation\-del
.sp
این دستور یک رزرو میزبان موجود را حذف می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4، kea\-dhcp6
.sp
در دسترس بودن: 1.2.0 (کتابخانه هوک host_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور reservation\-del را ببینید \%<#\:command-reservation-del>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqreservation\-del\(dq,
    \(dqarguments\(dq: {
        \(dqsubnet\-id\(dq: <integer>,
        \(dqip\-address\(dq: <string>,
        \(dqidentifier\-type\(dq: <one of \(aqhw\-address\(aq, \(aqduid\(aq, \(aqcircuit\-id\(aq, \(aqclient\-id\(aq and \(aqflex\-id\(aq>,
        \(dqidentifier\(dq: <string>,
        \(dqoperation\-target\(dq: <string (memory, database, all, default)>
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
رزرو میزبان می‌تواند با جفت (subnet\-id, ip\-address) یا سه‌تاییِ (subnet\-id, identifier\-type, identifier) شناسایی شود. operation\-target اختیاری است؛ پیش‌فرض \(aqalternate\(aq است.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: \(dq<string>\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عددی از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت کامل شد، اما هیچ داده‌ای تغییر نیافت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (conflict) (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT.SS reservation\-get
.sp
این دستور یک رزرو میزبان موجود را بازیابی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4، kea\-dhcp6
.sp
در دسترس بودن: 1.2.0 (کتابخانه هوک host_cmds)
.sp
دسترسی: read \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور reservation\-get را ببینید \%<#\:command-reservation-get>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqreservation\-get\(dq,
    \(dqarguments\(dq: {
        \(dqsubnet\-id\(dq: <integer>,
        \(dqidentifier\-type\(dq: <one of \(aqhw\-address\(aq, \(aqduid\(aq, \(aqcircuit\-id\(aq, \(aqclient\-id\(aq and \(aqflex\-id\(aq>,
        \(dqidentifier\(dq: <string>,
        \(dqoperation\-target\(dq: <string (memory, database, all, default)>
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
رزرو میزبان می‌تواند با جفت (subnet\-id, ip\-address) یا سه‌گانه (subnet\-id, identifier\-type, identifier) شناسایی شود. پارامتر operation\-target اختیاری است؛ پیش‌فرض \(aqall\(aq است.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: <string>,
    \(dqarguments\(dq: {
        \(dqboot\-file\-name\(dq: <string>,
        \(dqcomment\(dq: <string>,
        \(dqclient\-id\(dq: <string>,
        \(dqcircuit\-id\(dq: <string>,
        \(dqduid\(dq: <string>,
        \(dqflex\-id\(dq: <string>,
        \(dqip\-address\(dq: <string (IPv4 address)>,
        \(dqip\-addresses\(dq: [ <comma\-separated strings> ],
        \(dqhw\-address\(dq: <string>,
        \(dqhostname\(dq: <string>,
        \(dqnext\-server\(dq: <string (IPv4 address)>,
        \(dqoption\-data\(dq: [ <comma\-separated structures defining options> ],
        \(dqprefixes\(dq: [ <comma\-separated IPv6 prefixes> ],
        \(dqclient\-classes\(dq: [ <comma\-separated strings> ],
        \(dqserver\-hostname\(dq: <string>,
        \(dqsubnet\-id\(dq: <integer>,
        \(dquser\-context\(dq: <any valid JSON>
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
شیء arguments تنها در صورتی ظاهر می‌شود که میزبانی یافت شود. بسیاری از فیلدها در شیء arguments تنها در صورتی ظاهر می‌شوند که فیلد مشخصی تنظیم شده باشد.
.SS reservation\-get\-all
.sp
این دستور تمامی رزروهای میزبان را برای یک زیرشبکه مشخص بازیابی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4، kea\-dhcp6
.sp
در دسترس بودن: 1.6.0 (کتابخانه هوک host_cmds)
.sp
دسترسی: read \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور reservation\-get\-all را ببینید \%<#\:command-reservation-get-all>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqreservation\-get\-all\(dq,
    \(dqarguments\(dq: {
        \(dqsubnet\-id\(dq: <integer>,
        \(dqoperation\-target\(dq: <string (memory, database, all, default)>
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پارامتر operation\-target اختیاری است؛ پیش‌فرض \(aqall\(aq است.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: \(dq<string>\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
دستور reservation\-get\-all ممکن است منجر به پاسخ‌های بسیار حجیم شود.
.SS reservation\-get\-by\-address
.sp
این دستور تمامی رزروهای میزبان را برای یک ip\-address مشخص و به صورت اختیاری برای یک زیرشبکه معین بازیابی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4، kea\-dhcp6
.sp
در دسترس بودن: 2.4.0 (کتابخانه هوک host_cmds)
.sp
دسترسی: read \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور reservation\-get\-by\-address را ببینید \%<#\:command-reservation-get-by-address>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqreservation\-get\-by\-address\(dq,
    \(dqarguments\(dq: {
        \(dqip\-address\(dq: <string>,
        \(dqsubnet\-id\(dq: <integer>,
        \(dqoperation\-target\(dq: <string (memory, database, all, default)>
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
رزروهای میزبان می‌توانند با جفتی از \(aqip\-address\(aq و \(aqsubnet\-id\(aq شناسایی شوند. \(aqsubnet\-id\(aq اختیاری است. \(aqoperation\-target\(aq اختیاری است؛ پیش‌فرض \(aqall\(aq است.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: \(dq<string>\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
دستور reservation\-get\-by\-address ممکن است چندین رزرو را برای یک ip\-address یکسان برگرداند. این دستور در صورتی که پرچم پیکربندی ip\-reservations\-unique روی false تنظیم شده باشد، می‌تواند مفید باشد..SS reservation\-get\-by\-hostname
.sp
این دستور تمامی رزروهای میزبان را برای یک hostname مشخص و به‌طور اختیاری یک subnet مشخص بازیابی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4، kea\-dhcp6
.sp
در دسترس از: 1.7.1 (کتابخانه قلاب host_cmds)
.sp
سطح دسترسی: read \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور reservation\-get\-by\-hostname را ببینید \%<#\:command-reservation-get-by-hostname>
.sp
ساختار دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqreservation\-get\-by\-hostname\(dq,
    \(dqarguments\(dq: {
        \(dqhostname\(dq: <hostname>,
        \(dqsubnet\-id\(dq: <integer>,
        \(dqoperation\-target\(dq: <string (memory, database, all, default)>
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پارامتر operation\-target اختیاری است؛ مقدار پیش‌فرض \(aqall\(aq است.
.sp
ساختار پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: \(dq<string>\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
دستور reservation\-get\-by\-hostname ممکن است به پاسخ‌های حجیمی منجر شود.
.SS reservation\-get\-by\-id
.sp
این دستور تمامی رزروهای میزبان را برای یک شناسهٔ مشخص (نوع و مقدار) بازیابی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4، kea\-dhcp6
.sp
در دسترس از: 1.9.0 (کتابخانه قلاب host_cmds)
.sp
سطح دسترسی: read \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور reservation\-get\-by\-id را ببینید \%<#\:command-reservation-get-by-id>
.sp
ساختار دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqreservation\-get\-by\-id\(dq,
    \(dqarguments\(dq: {
        \(dqidentifier\-type\(dq: <one of \(aqhw\-address\(aq, \(aqduid\(aq, \(aqcircuit\-id\(aq, \(aqclient\-id\(aq and \(aqflex\-id\(aq>,
        \(dqidentifier\(dq: <string>,
        \(dqoperation\-target\(dq: <string (memory, database, all, default)>
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پارامتر operation\-target اختیاری است؛ مقدار پیش‌فرض \(aqall\(aq است.
.sp
ساختار پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: \(dq<string>\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
دستور reservation\-get\-by\-id ممکن است به پاسخ‌های حجیمی منجر شود.
.SS reservation\-get\-page
.sp
این دستور تمامی رزروهای میزبان یا رزروهای میزبان مربوط به یک subnet مشخص را به‌صورت صفحه‌بندی‌شده بازیابی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4، kea\-dhcp6
.sp
در دسترس از: 1.6.0 (کتابخانه قلاب host_cmds)
.sp
سطح دسترسی: read \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور reservation\-get\-page را ببینید \%<#\:command-reservation-get-page>
.sp
ساختار دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqreservation\-get\-page\(dq,
    \(dqarguments\(dq: {
        \(dqsubnet\-id\(dq: <integer>,
        \(dqlimit\(dq: <integer>,
        \(dqsource\-index\(dq: <integer>,
        \(dqfrom\(dq: <integer>
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پارامتر limit برای اندازهٔ صفحه اجباری است. پارامتر subnet\-id از نسخهٔ 1.9.0 به بعد اختیاری است. پارامترهای source\-index و from host\-id اختیاری هستند و مقدار پیش‌فرض آن‌ها 0 است. مقادیر مورد نیاز برای بارگیری صفحهٔ بعد، در پاسخ‌ها در قالب یک نگاشت next بازگردانده می‌شوند.
.sp
ساختار پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: \(dq<string>\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
مقدار result نمایشی عددی از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت انجام شد، اما هیچ داده‌ای تغییر نکرد یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (conflict) (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT.SS reservation\-update
.sp
این دستور یک رزرو میزبان (host reservation) موجود را به‌روزرسانی می‌کند. این رزرو باید شامل شناسه‌های میزبان و یک شناسه زیرشبکه باشد و می‌تواند شامل نشانی‌های IPv4، نشانی‌های IPv6، پیشوندهای IPv6، شناسه‌های گوناگون، کلاسی که کلاینت به آن تخصیص خواهد یافت، گزینه‌های DHCPv4 و DHCPv6، و موارد دیگر باشد.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4، kea\-dhcp6
.sp
در دسترس بودن: 2.3.7 (کتابخانه قلاب host_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: به دستور reservation\-update در \%<#\:command-reservation-update> مراجعه کنید
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqreservation\-update\(dq,
    \(dqarguments\(dq: {
        \(dqreservation\(dq: {
            \(dqboot\-file\-name\(dq: <string>,
            \(dqclient\-id\(dq: <string>,
            \(dqcircuit\-id\(dq: <string>,
            \(dqduid\(dq: <string>,
            \(dqflex\-id\(dq: <string>,
            \(dqip\-address\(dq: <string (IPv4 address)>,
            \(dqip\-addresses\(dq: [ <comma\-separated strings> ],
            \(dqhw\-address\(dq: <string>,
            \(dqhostname\(dq: <string>,
            \(dqnext\-server\(dq: <string (IPv4 address)>,
            \(dqoption\-data\(dq: [ <comma\-separated structures defining options> ],
            \(dqprefixes\(dq: [ <comma\-separated IPv6 prefixes> ],
            \(dqclient\-classes\(dq: [ <comma\-separated strings> ],
            \(dqserver\-hostname\(dq: <string>,
            \(dqsubnet\-id\(dq: <integer>,
            \(dquser\-context\(dq: <any valid JSON>
        },
        \(dqoperation\-target\(dq: <string (memory, database, all, default)>
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
توجه داشته باشید که boot\-file\-name، circuit\-id، client\-id، ip\-address، next\-server و server\-hostname مختص IPv4 هستند. ip\-addresses و prefixes مختص IPv6 می‌باشند. آرگومان operation\-target اختیاری است؛ مقدار پیش‌فرض \(aqalternate\(aq است.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: <string>
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت به پایان رسید، اما داده‌ای تغییر نیافت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (conflict) (دستور نتوانست تغییرات پیکربندی درخواست‌شده را اعمال کند، زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT
.SS server\-tag\-get
.sp
این دستور برچسب سرور (server tag) مورد استفاده توسط سرور را بازمی‌گرداند.
برچسب سرور یک پارامتر پیکربندی ضروری در پیکربندی Config Backend است.
این پارامتر در فایل پیکربندی محلی تنظیم می‌شود.
این دستور هیچ پارامتری دریافت نمی‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4، kea\-dhcp6
.sp
در دسترس بودن: 1.6.0 (توکار)
.sp
دسترسی: read \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: به دستور server\-tag\-get در \%<#\:command-server-tag-get> مراجعه کنید
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqserver\-tag\-get\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqarguments\(dq: {
        \(dqserver\-tag\(dq: \(dqoffice1\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت به پایان رسید، اما داده‌ای تغییر نیافت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (conflict) (دستور نتوانست تغییرات پیکربندی درخواست‌شده را اعمال کند، زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT.SS sflq\-pool4\-del
.sp
این دستور استخری را که دقیقاً با یک محدوده نشانی مطابقت دارد از پسانه اجاره (lease back end) حذف می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4، kea\-dhcp6
.sp
در دسترس از نسخه: 3.1.9 (کتابخانه هوک lease_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور sflq\-pool4\-del را ببینید \%<#\:command-sflq-pool4-del>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
   \(dqcommand\(dq: \(dqsflq\-pool4\-del\(dq,
   \(dqarguments\(dq: {
       \(dqstart\-address\(dq: \(dq192.0.2.0\(dq,
       \(dqend\-address\(dq: \(dq192.0.2.255\(dq,
       \(dqforce\(dq: true
   }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
\(dqresult\(dq: 0,
\(dqtext\(dq: \(dq1 pool(s) deleted.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (دستور با موفقیت کامل شد، اما هیچ داده‌ای تغییر نکرد یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (دستور نتوانست تغییرات پیکربندی درخواست‌شده را اعمال کند زیرا با وضعیت سرور در تعارض بود)
.UNINDENT
.SS sflq\-pool4\-get\-all
.sp
این دستور فهرستی از تمامی استخرهای v4 SFLQ را از پسانه اجاره واکشی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4، kea\-dhcp6
.sp
در دسترس از نسخه: 3.1.9 (کتابخانه هوک lease_cmds)
.sp
دسترسی: read \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور sflq\-pool4\-get\-all را ببینید \%<#\:command-sflq-pool4-get-all>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqsflq\-pool4\-get\-all\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
\(dqarguments\(dq: {
   \(dqpools\(dq: [
       {
            \(dqcreated\-ts\(dq: \(dq2026\-05\-02 10:54:55.000000\(dq,
            \(dqdelegated\-len\(dq: 128,
            \(dqend\-address\(dq: \(dq192.0.2.255\(dq,
            \(dqfree\-leases\(dq: 256,
            \(dqlease\-type\(dq: \(dqV4\(dq,
            \(dqmodified\-ts\(dq: \(dq2026\-05\-02 10:54:55.000000\(dq,
            \(dqstart\-address\(dq: \(dq192.0.2.0\(dq,
            \(dqsubnet\-id\(dq: 6
       }
   ]
},
\(dqresult\(dq: 0,
\(dqtext\(dq: \(dq1 pool(s) found.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (دستور با موفقیت کامل شد، اما هیچ داده‌ای تغییر نکرد یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (دستور نتوانست تغییرات پیکربندی درخواست‌شده را اعمال کند زیرا با وضعیت سرور در تعارض بود)
.UNINDENT
.SS sflq\-pool4\-get\-by\-range
.sp
این دستور فهرستی از تمامی استخرهای v4 SFLQ را که با یک محدوده نشانی هم‌پوشانی دارند، از پسانه اجاره واکشی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4، kea\-dhcp6
.sp
در دسترس از نسخه: 3.1.9 (کتابخانه هوک lease_cmds)
.sp
دسترسی: read \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور sflq\-pool4\-get\-by\-range را ببینید \%<#\:command-sflq-pool4-get-by-range>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
   \(dqcommand\(dq: \(dqsflq\-pool4\-get\-by\-range\(dq,
   \(dqarguments\(dq: {
       \(dqstart\-address\(dq: \(dq192.0.2.0\(dq,
       \(dqend\-address\(dq: \(dq192.0.2.255\(dq
   }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
\(dqarguments\(dq: {
   \(dqpools\(dq: [
       {
            \(dqcreated\-ts\(dq: \(dq2026\-05\-02 10:54:55.000000\(dq,
            \(dqdelegated\-len\(dq: 128,
            \(dqend\-address\(dq: \(dq192.0.2.255\(dq,
            \(dqfree\-leases\(dq: 256,
            \(dqlease\-type\(dq: \(dqV4\(dq,
            \(dqmodified\-ts\(dq: \(dq2026\-05\-02 10:54:55.000000\(dq,
            \(dqstart\-address\(dq: \(dq192.0.2.0\(dq,
            \(dqsubnet\-id\(dq: 123
       }
   ]
},
\(dqresult\(dq: 0,
\(dqtext\(dq: \(dq1 pool(s) found.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (دستور با موفقیت کامل شد، اما هیچ داده‌ای تغییر نکرد یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (دستور نتوانست تغییرات پیکربندی درخواست‌شده را اعمال کند زیرا با وضعیت سرور در تعارض بود)
.UNINDENT.SS sflq\-pool4\-get\-by\-subnet
.sp
این دستور فهرستی از تمام poolهای v4 SFLQ متعلق به یک subnet را از lease back end واکشی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4، kea\-dhcp6
.sp
در دسترس در: 3.1.9 (کتابخانه هوک lease_cmds)
.sp
دسترسی: read \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور sflq\-pool4\-get\-by\-subnet را ببینید \%<#\:command-sflq-pool4-get-by-subnet>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
   \(dqcommand\(dq: \(dqsflq\-pool4\-get\-by\-subnet\(dq,
   \(dqarguments\(dq: {
       \(dqsubnet\-id\(dq: 123
   }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
\(dqarguments\(dq: {
   \(dqpools\(dq: [
       {
            \(dqcreated\-ts\(dq: \(dq2026\-05\-02 10:54:55.000000\(dq,
            \(dqdelegated\-len\(dq: 128,
            \(dqend\-address\(dq: \(dq192.0.2.255\(dq,
            \(dqfree\-leases\(dq: 256,
            \(dqlease\-type\(dq: \(dqV4\(dq,
            \(dqmodified\-ts\(dq: \(dq2026\-05\-02 10:54:55.000000\(dq,
            \(dqstart\-address\(dq: \(dq192.0.2.0\(dq,
            \(dqsubnet\-id\(dq: 123
       }
   ]
},
\(dqresult\(dq: 0,
\(dqtext\(dq: \(dq1 pool(s) found.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
مقدار result یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت انجام شد، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (conflict) (دستور نتوانست تغییرات پیکربندی درخواست‌شده را اعمال کند زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT
.SS sflq\-pool4\-rebuild
.sp
این دستور به lease back end فرمان می‌دهد داده‌های اجاره‌های آزاد (free lease data) را برای یک pool از نوع v4 SFLQ بازسازی کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4، kea\-dhcp6
.sp
در دسترس در: 3.1.9 (کتابخانه هوک lease_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور sflq\-pool4\-rebuild را ببینید \%<#\:command-sflq-pool4-rebuild>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqsflq\-pool4\-rebuild\(dq,
    \(dqarguments\(dq: {
       \(dqstart\-address\(dq: \(dq1.2.3.4\(dq,
       \(dqend\-address\(dq: \(dq1.2.3.4\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqSFLQ pool rebuilt.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
مقدار result یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت انجام شد، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (conflict) (دستور نتوانست تغییرات پیکربندی درخواست‌شده را اعمال کند زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT.SS sflq\-pool6\-del
.sp
این دستور استخری را که دقیقاً با یک محدوده نشانی مطابقت دارد، از بک‌اند اجاره حذف می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4, kea\-dhcp6
.sp
در دسترس بودن: 3.1.9 (کتابخانه هوک lease_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور sflq\-pool6\-del را ببینید \%<#\:command-sflq-pool6-del>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
   \(dqcommand\(dq: \(dqsflq\-pool6\-del\(dq,
   \(dqarguments\(dq: {
       \(dqstart\-address\(dq: \(dq3001::ffff\(dq,
       \(dqend\-address\(dq: \(dq3001::10\(dq,
       \(dqforce\(dq: true
   }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
\(dqresult\(dq: 0,
\(dqtext\(dq: \(dq1 pool(s) deleted.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت تکمیل شد، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (conflict) (دستور نتوانست تغییرات پیکربندی درخواست‌شده را اعمال کند زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT
.SS sflq\-pool6\-get\-all
.sp
این دستور فهرستی از تمام استخرهای v6 SFLQ را از بک‌اند اجاره واکشی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4, kea\-dhcp6
.sp
در دسترس بودن: 3.1.9 (کتابخانه هوک lease_cmds)
.sp
دسترسی: read \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور sflq\-pool6\-get\-all را ببینید \%<#\:command-sflq-pool6-get-all>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqsflq\-pool6\-get\-all\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqarguments\(dq: {
        \(dqpools\(dq: [
            {
                \(dqcreated\-ts\(dq: \(dq2026\-05\-05 08:40:40.000000\(dq,
                \(dqdelegated\-len\(dq: 128,
                \(dqend\-address\(dq: \(dq3001::ffff\(dq,
                \(dqfree\-leases\(dq: 65520,
                \(dqlease\-type\(dq: \(dqIA_NA\(dq,
                \(dqmodified\-ts\(dq: \(dq2026\-05\-05 08:40:41.000000\(dq,
                \(dqstart\-address\(dq: \(dq3001::10\(dq,
                \(dqsubnet\-id\(dq: 100
            },
            {
                \(dqcreated\-ts\(dq: \(dq2026\-05\-05 08:40:41.000000\(dq,
                \(dqdelegated\-len\(dq: 64,
                \(dqend\-address\(dq: \(dq3001:20:0:ff:ffff:ffff:ffff:ffff\(dq,
                \(dqfree\-leases\(dq: 256,
                \(dqlease\-type\(dq: \(dqIA_PD\(dq,
                \(dqmodified\-ts\(dq: \(dq2026\-05\-05 08:40:41.000000\(dq,
                \(dqstart\-address\(dq: \(dq3001:20::\(dq,
                \(dqsubnet\-id\(dq: 100
            }
        ]
    },
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq2 pool(s) found.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت تکمیل شد، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (conflict) (دستور نتوانست تغییرات پیکربندی درخواست‌شده را اعمال کند زیرا با وضعیت سرور در تعارض بودند)
.UNINDENT.SS sflq\-pool6\-get\-by\-range
.sp
این دستور فهرستی از تمام استخرهای v6 SFLQ را که با یک محدوده نشانی همپوشانی دارند، از بک‌اند اجاره (lease back end) واکشی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4, kea\-dhcp6
.sp
دسترس‌پذیری: 3.1.9 (کتابخانه قلاب lease_cmds)
.sp
دسترسی: read \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور sflq\-pool6\-get\-by\-range را ببینید \%<#\:command-sflq-pool6-get-by-range>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
   \(dqcommand\(dq: \(dqsflq\-pool6\-get\-by\-range\(dq,
   \(dqarguments\(dq: {
       \(dqstart\-address\(dq: \(dq3001::10\(dq,
       \(dqend\-address\(dq: \(dq3001::ffff\(dq
   }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqarguments\(dq: {
        \(dqpools\(dq: [
            {
                \(dqcreated\-ts\(dq: \(dq2026\-05\-05 08:40:40.000000\(dq,
                \(dqdelegated\-len\(dq: 128,
                \(dqend\-address\(dq: \(dq3001::ffff\(dq,
                \(dqfree\-leases\(dq: 65520,
                \(dqlease\-type\(dq: \(dqIA_NA\(dq,
                \(dqmodified\-ts\(dq: \(dq2026\-05\-05 08:40:41.000000\(dq,
                \(dqstart\-address\(dq: \(dq3001::10\(dq,
                \(dqsubnet\-id\(dq: 100
            }
        ]
    },
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq1 pool(s) found.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (دستور با موفقیت به پایان رسید، اما هیچ داده‌ای تغییر نیافت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تعارض بود)
.UNINDENT
.SS sflq\-pool6\-get\-by\-subnet
.sp
این دستور فهرستی از تمام استخرهای v6 SFLQ را که به یک زیرشبکه تعلق دارند، از بک‌اند اجاره (lease back end) واکشی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4, kea\-dhcp6
.sp
دسترس‌پذیری: 3.1.9 (کتابخانه قلاب lease_cmds)
.sp
دسترسی: read \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور sflq\-pool6\-get\-by\-subnet را ببینید \%<#\:command-sflq-pool6-get-by-subnet>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
   \(dqcommand\(dq: \(dqsflq\-pool6\-get\-by\-subnet\(dq,
   \(dqarguments\(dq: {
       \(dqsubnet\-id\(dq: 100
   }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqarguments\(dq: {
        \(dqpools\(dq: [
            {
                \(dqcreated\-ts\(dq: \(dq2026\-05\-05 08:40:40.000000\(dq,
                \(dqdelegated\-len\(dq: 128,
                \(dqend\-address\(dq: \(dq3001::ffff\(dq,
                \(dqfree\-leases\(dq: 65520,
                \(dqlease\-type\(dq: \(dqIA_NA\(dq,
                \(dqmodified\-ts\(dq: \(dq2026\-05\-05 08:40:41.000000\(dq,
                \(dqstart\-address\(dq: \(dq3001::10\(dq,
                \(dqsubnet\-id\(dq: 100
            },
            {
                \(dqcreated\-ts\(dq: \(dq2026\-05\-05 08:40:41.000000\(dq,
                \(dqdelegated\-len\(dq: 64,
                \(dqend\-address\(dq: \(dq3001:20:0:ff:ffff:ffff:ffff:ffff\(dq,
                \(dqfree\-leases\(dq: 256,
                \(dqlease\-type\(dq: \(dqIA_PD\(dq,
                \(dqmodified\-ts\(dq: \(dq2026\-05\-05 08:40:41.000000\(dq,
                \(dqstart\-address\(dq: \(dq3001:20::\(dq,
                \(dqsubnet\-id\(dq: 100
            }
        ]
    },
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq2 pool(s) found.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (دستور با موفقیت به پایان رسید، اما هیچ داده‌ای تغییر نیافت یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تعارض بود)
.UNINDENT.SS sflq\-pool6\-rebuild
.sp
این دستور به backend اجاره دستور می‌دهد تا داده‌های اجاره‌های آزاد را برای یک pool v6 SFLQ بازسازی کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4، kea\-dhcp6
.sp
در دسترس از: 3.1.9 (کتابخانه هوک lease_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور sflq\-pool6\-rebuild را ببینید \%<#\:command-sflq-pool6-rebuild>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqsflq\-pool6\-rebuild\(dq,
    \(dqarguments\(dq: {
       \(dqstart\-address\(dq: \(dq2001:db8:1::\(dq,
       \(dqend\-address\(dq: \(dq2001:db8:1::ffff\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqSFLQ pool rebuilt.\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت به پایان رسید، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (conflict) (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تداخل بود)
.UNINDENT
.SS shutdown
.sp
این دستور به سرور اعلام می‌کند که فرآیند خاموش شدن (shutdown) خود را آغاز کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp\-ddns، kea\-dhcp4، kea\-dhcp6
.sp
در دسترس از: 1.0.0 (توکار)
.sp
دسترسی: write \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور shutdown را ببینید \%<#\:command-shutdown>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqshutdown\(dq,
    \(dqarguments\(dq: {
        \(dqexit\-value\(dq: 123
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
سرور با تأیید این‌که فرآیند خاموش شدن آغاز شده است پاسخ می‌دهد.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: \(dq<string>\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت به پایان رسید، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (conflict) (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تداخل بود)
.UNINDENT
.SS stat\-lease4\-get
.sp
این دستور آمار اجاره‌ها را برای محدوده‌ای از زیرشبکه‌های شناخته‌شده IPv4 واکشی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس از: 1.4.0 (کتابخانه هوک stat_cmds)
.sp
دسترسی: read \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور stat\-lease4\-get را ببینید \%<#\:command-stat-lease4-get>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqcommand\(dq: \(dqstat\-lease4\-get\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqstat\-lease4\-get: 2 rows found\(dq,
    \(dqarguments\(dq: {
      \(dqresult\-set\(dq: {
        \(dqcolumns\(dq: [ \(dqsubnet\-id\(dq, \(dqtotal\-addresses\(dq, \(dqcumulative\-assigned\-addresses\(dq, \(dqassigned\-addresses\(dq, \(dqdeclined\-addresses\(dq ],
        \(dqrows\(dq: [
          [ 10, 256, 200, 111, 0 ],
          [ 20, 4098, 5000, 2034, 4 ]
        ],
        \(dqtimestamp\(dq: \(dq2018\-05\-04 15:03:37.000000\(dq
      }
    }
  }
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت به پایان رسید، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (conflict) (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تداخل بود)
.UNINDENT.SS stat\-lease6\-get
.sp
این دستور آمار اجاره‌ها را برای محدوده‌ای از زیرشبکه‌های شناخته‌شدهٔ IPv6 دریافت می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس از: 1.4.0 (کتابخانهٔ قلاب stat_cmds)
.sp
دسترسی: read \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور stat\-lease6\-get را ببینید \%<#\:command-stat-lease6-get>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
  \(dqcommand\(dq: \(dqstat\-lease6\-get\(dq,
  \(dqarguments\(dq: {
    \(dqsubnet\-id\(dq : 10
  }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqstat\-lease6\-get: 2 rows found\(dq,
    \(dqarguments\(dq: {
      \(dqresult\-set\(dq: {
        \(dqcolumns\(dq: [ \(dqsubnet\-id\(dq, \(dqtotal\-nas\(dq, \(dqcumulative\-assigned\-nas\(dq, \(dqassigned\-nas\(dq, \(dqdeclined\-addresses\(dq, \(dqtotal\-pds\(dq, \(dqcumulative\-assigned\-pds\(dq, \(dqassigned\-pds\(dq ],
        \(dqrows\(dq: [
          [ 10, 4096, 3000, 2400, 3, 0, 0],
          [ 20, 0, 0, 0, 1048, 500, 233 ],
          [ 30, 256, 300, 60, 0, 1048, 15, 15 ]
        ],
        \(dqtimestamp\(dq: \(dq2018\-05\-04 15:03:37.000000\(dq
      }
    }
  }
.EE
.UNINDENT
.UNINDENT
.sp
مقدار result یک نمایش عدد صحیح از وضعیت است. وضعیت‌های پشتیبانی‌شدهٔ کنونی عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (دستور با موفقیت به پایان رسید، اما هیچ داده‌ای تغییر نکرد یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تداخل بودند)
.UNINDENT
.SS statistic\-get
.sp
این دستور یک آمار منفرد را دریافت می‌کند. این دستور یک پارامتر رشته‌ای منفرد به نام name می‌گیرد که نام آمار را مشخص می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp\-ddns، kea\-dhcp4، kea\-dhcp6
.sp
در دسترس از: 1.0.0 (توکار)
.sp
دسترسی: read \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور statistic\-get را ببینید \%<#\:command-statistic-get>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqstatistic\-get\(dq,
    \(dqarguments\(dq: {
        \(dqname\(dq: \(dqpkt4\-received\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
سرور با جزئیات آمار درخواستی پاسخ می‌دهد، که در آن result برابر 0 نشان‌دهندهٔ موفقیت است و آمار مشخص‌شده به عنوان مقدار پارامتر \(dqarguments\(dq ارائه می‌شود.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
   \(dqresult\(dq: 0,
   \(dqarguments\(dq: {
       \(dqpkt4\-received\(dq: [ [ \(dqfirst_value\(dq, \(dq2019\-07\-30 10:11:19.498739\(dq ], [ \(dqsecond_value\(dq, \(dq2019\-07\-30 10:11:19.498662\(dq ] ]
       }
}
.EE
.UNINDENT
.UNINDENT
.sp
مقدار result یک نمایش عدد صحیح از وضعیت است. وضعیت‌های پشتیبانی‌شدهٔ کنونی عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (دستور با موفقیت به پایان رسید، اما هیچ داده‌ای تغییر نکرد یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تداخل بودند)
.UNINDENT.SS statistic\-get\-all
.sp
این دستور تمام آمارهای ثبت‌شده را بازیابی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp\-ddns، kea\-dhcp4، kea\-dhcp6
.sp
در دسترس بودن: 1.0.0 (توکار)
.sp
سطح دسترسی: read \fI(این پارامتر در این نسخهٔ Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور statistic\-get\-all را ببینید \%<#\:command-statistic-get-all>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqstatistic\-get\-all\(dq,
    \(dqarguments\(dq: { }
}
.EE
.UNINDENT
.UNINDENT
.sp
سرور با جزئیات تمام آمارهای ثبت‌شده پاسخ می‌دهد.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqarguments\(dq: {
        \(dqassigned\-addresses\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.836096\(dq
            ]
        ],
        \(dqcumulative\-assigned\-addresses\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.836166\(dq
            ]
        ],
        \(dqdeclined\-addresses\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.836156\(dq
            ]
        ],
        \(dqpkt4\-ack\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616247\(dq
            ]
        ],
        \(dqpkt4\-ack\-sent\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616290\(dq
            ]
        ],
        \(dqpkt4\-decline\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616296\(dq
            ]
        ],
        \(dqpkt4\-discover\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616303\(dq
            ]
        ],
        \(dqpkt4\-inform\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616308\(dq
            ]
        ],
        \(dqpkt4\-nak\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616312\(dq
            ]
        ],
        \(dqpkt4\-nak\-sent\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616314\(dq
            ]
        ],
        \(dqpkt4\-offer\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616318\(dq
            ]
        ],
        \(dqpkt4\-offer\-sent\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616323\(dq
            ]
        ],
        \(dqpkt4\-parse\-failed\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616326\(dq
            ]
        ],
        \(dqpkt4\-receive\-drop\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616330\(dq
            ]
        ],
        \(dqpkt4\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616335\(dq
            ]
        ],
        \(dqpkt4\-release\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616339\(dq
            ]
        ],
        \(dqpkt4\-request\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616343\(dq
            ]
        ],
        \(dqpkt4\-sent\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616348\(dq
            ]
        ],
        \(dqpkt4\-unknown\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616354\(dq
            ]
        ],
        \(dqreclaimed\-declined\-addresses\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.836159\(dq
            ]
        ],
        \(dqreclaimed\-leases\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.836163\(dq
            ]
        ],
        \(dqsubnet[1].assigned\-addresses\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.836173\(dq
            ]
        ],
        \(dqsubnet[1].cumulative\-assigned\-addresses\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.836098\(dq
            ]
        ],
        \(dqsubnet[1].declined\-addresses\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.836178\(dq
            ]
        ],
        \(dqsubnet[1].pool[0].assigned\-addresses\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.836205\(dq
            ]
        ],
        \(dqsubnet[1].pool[0].cumulative\-assigned\-addresses\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.836137\(dq
            ]
        ],
        \(dqsubnet[1].pool[0].declined\-addresses\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.836213\(dq
            ]
        ],
        \(dqsubnet[1].pool[0].reclaimed\-declined\-addresses\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.836225\(dq
            ]
        ],
        \(dqsubnet[1].pool[0].reclaimed\-leases\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.836236\(dq
            ]
        ],
        \(dqsubnet[1].pool[0].total\-addresses\(dq: [
            [
                11010049,
                \(dq2023\-06\-13 20:42:46.836128\(dq
            ]
        ],
        \(dqsubnet[1].reclaimed\-declined\-addresses\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.836186\(dq
            ]
        ],
        \(dqsubnet[1].reclaimed\-leases\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.836194\(dq
            ]
        ],
        \(dqsubnet[1].total\-addresses\(dq: [
            [
                11010049,
                \(dq2023\-06\-13 20:42:46.836083\(dq
            ]
        ],
        \(dqsubnet[1].v4\-lease\-reuses\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.836105\(dq
            ]
        ],
        \(dqsubnet[1].v4\-reservation\-conflicts\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.836111\(dq
            ]
        ],
        \(dqv4\-allocation\-fail\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616358\(dq
            ]
        ],
        \(dqv4\-allocation\-fail\-classes\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616363\(dq
            ]
        ],
        \(dqv4\-allocation\-fail\-no\-pools\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616368\(dq
            ]
        ],
        \(dqv4\-allocation\-fail\-shared\-network\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616372\(dq
            ]
        ],
        \(dqv4\-allocation\-fail\-subnet\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616376\(dq
            ]
        ],
        \(dqv4\-lease\-reuses\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616410\(dq
            ]
        ],
        \(dqv4\-reservation\-conflicts\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616412\(dq
            ]
        ]
    }
}

or

{
    \(dqresult\(dq: 0,
    \(dqarguments\(dq: {
        \(dqassigned\-nas\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196757\(dq
            ]
        ],
        \(dqassigned\-pds\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196757\(dq
            ]
        ],
        \(dqcumulative\-assigned\-nas\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196757\(dq
            ]
        ],
        \(dqcumulative\-assigned\-pds\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196758\(dq
            ]
        ],
        \(dqdeclined\-addresses\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196754\(dq
            ]
        ],
        \(dqpkt6\-advertise\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177731\(dq
            ]
        ],
        \(dqpkt6\-advertise\-sent\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177739\(dq
            ]
        ],
        \(dqpkt6\-decline\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177739\(dq
            ]
        ],
        \(dqpkt6\-dhcpv4\-query\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177740\(dq
            ]
        ],
        \(dqpkt6\-dhcpv4\-response\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177740\(dq
            ]
        ],
        \(dqpkt6\-dhcpv4\-response\-sent\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177741\(dq
            ]
        ],
        \(dqpkt6\-infrequest\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177742\(dq
            ]
        ],
        \(dqpkt6\-parse\-failed\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177742\(dq
            ]
        ],
        \(dqpkt6\-rebind\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177743\(dq
            ]
        ],
        \(dqpkt6\-receive\-drop\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177743\(dq
            ]
        ],
        \(dqpkt6\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177744\(dq
            ]
        ],
        \(dqpkt6\-release\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177744\(dq
            ]
        ],
        \(dqpkt6\-renew\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177745\(dq
            ]
        ],
        \(dqpkt6\-reply\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177745\(dq
            ]
        ],
        \(dqpkt6\-reply\-sent\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177746\(dq
            ]
        ],
        \(dqpkt6\-request\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177747\(dq
            ]
        ],
        \(dqpkt6\-sent\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177747\(dq
            ]
        ],
        \(dqpkt6\-solicit\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177748\(dq
            ]
        ],
        \(dqpkt6\-unknown\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177748\(dq
            ]
        ],
        \(dqreclaimed\-declined\-addresses\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196755\(dq
            ]
        ],
        \(dqreclaimed\-leases\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196756\(dq
            ]
        ],
        \(dqsubnet[1].assigned\-nas\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196760\(dq
            ]
        ],
        \(dqsubnet[1].assigned\-pds\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196761\(dq
            ]
        ],
        \(dqsubnet[1].cumulative\-assigned\-nas\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196727\(dq
            ]
        ],
        \(dqsubnet[1].cumulative\-assigned\-pds\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196729\(dq
            ]
        ],
        \(dqsubnet[1].declined\-addresses\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196763\(dq
            ]
        ],
        \(dqsubnet[1].pd\-pool[0].assigned\-pds\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196785\(dq
            ]
        ],
        \(dqsubnet[1].pd\-pool[0].cumulative\-assigned\-pds\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196744\(dq
            ]
        ],
        \(dqsubnet[1].pd\-pool[0].reclaimed\-leases\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196789\(dq
            ]
        ],
        \(dqsubnet[1].pd\-pool[0].total\-pds\(dq: [
            [
                256,
                \(dq2023\-06\-13 21:28:57.196741\(dq
            ]
        ],
        \(dqsubnet[1].pool[0].assigned\-nas\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196773\(dq
            ]
        ],
        \(dqsubnet[1].pool[0].cumulative\-assigned\-nas\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196739\(dq
            ]
        ],
        \(dqsubnet[1].pool[0].declined\-addresses\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196775\(dq
            ]
        ],
        \(dqsubnet[1].pool[0].reclaimed\-declined\-addresses\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196779\(dq
            ]
        ],
        \(dqsubnet[1].pool[0].reclaimed\-leases\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196783\(dq
            ]
        ],
        \(dqsubnet[1].pool[0].total\-nas\(dq: [
            [
                281474976710656,
                \(dq2023\-06\-13 21:28:57.196736\(dq
            ]
        ],
        \(dqsubnet[1].reclaimed\-declined\-addresses\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196766\(dq
            ]
        ],
        \(dqsubnet[1].reclaimed\-leases\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196770\(dq
            ]
        ],
        \(dqsubnet[1].total\-nas\(dq: [
            [
                281474976710656,
                \(dq2023\-06\-13 21:28:57.196720\(dq
            ]
        ],
        \(dqsubnet[1].total\-pds\(dq: [
            [
                256,
                \(dq2023\-06\-13 21:28:57.196724\(dq
            ]
        ],
        \(dqsubnet[1].v6\-ia\-na\-lease\-reuses\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196731\(dq
            ]
        ],
        \(dqsubnet[1].v6\-ia\-pd\-lease\-reuses\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196733\(dq
            ]
        ],
        \(dqv6\-allocation\-fail\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177749\(dq
            ]
        ],
        \(dqv6\-allocation\-fail\-classes\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177755\(dq
            ]
        ],
        \(dqv6\-allocation\-fail\-no\-pools\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177756\(dq
            ]
        ],
        \(dqv6\-allocation\-fail\-shared\-network\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177756\(dq
            ]
        ],
        \(dqv6\-allocation\-fail\-subnet\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177757\(dq
            ]
        ],
        \(dqv6\-ia\-na\-lease\-reuses\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177757\(dq
            ]
        ],
        \(dqv6\-ia\-pd\-lease\-reuses\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177758\(dq
            ]
        ]
    }
}

or

{
    \(dqresult\(dq: 0,
    \(dqarguments\(dq: {
        \(dqncr\-error\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:42:54.627751\(dq
            ]
        ],
        \(dqncr\-invalid\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:42:54.627749\(dq
            ]
        ],
        \(dqncr\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:42:54.627737\(dq
            ]
        ],
        \(dqqueue\-mgr\-queue\-full\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:42:54.627737\(dq
            ]
        ],
        \(dqupdate\-error\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:42:54.627759\(dq
            ]
        ],
        \(dqupdate\-sent\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:42:54.627752\(dq
            ]
        ],
        \(dqupdate\-signed\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:42:54.627753\(dq
            ]
        ],
        \(dqupdate\-success\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:42:54.627755\(dq
            ]
        ],
        \(dqupdate\-timeout\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:42:54.627757\(dq
            ]
        ],
        \(dqupdate\-unsigned\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:42:54.627754\(dq
            ]
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0.IP \(bu 2
0 \- موفقیت
.IP \(bu 2
1 \- خطا
.IP \(bu 2
2 \- پشتیبانی‌نشده
.IP \(bu 2
3 \- خالی (دستور با موفقیت کامل شد، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تداخل بودند)
.UNINDENT
.SS statistic\-global\-get\-all
.sp
این دستور تمام آمارهای سراسری ثبت‌شده را (بدون در نظر گرفتن آمارهای زیرشبکه) بازیابی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4، kea\-dhcp6
.sp
در دسترس بودن: 3.1.2 (توکار)
.sp
دسترسی: read \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور statistic\-global\-get\-all را ببینید \%<#\:command-statistic-global-get-all>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqstatistic\-global\-get\-all\(dq,
    \(dqarguments\(dq: { }
}
.EE
.UNINDENT
.UNINDENT
.sp
سرور با جزئیات تمام آمارهای سراسری ثبت‌شده پاسخ می‌دهد (بدون در نظر گرفتن آمارهای زیرشبکه).
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqarguments\(dq: {
        \(dqassigned\-addresses\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.836096\(dq
            ]
        ],
        \(dqcumulative\-assigned\-addresses\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.836166\(dq
            ]
        ],
        \(dqdeclined\-addresses\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.836156\(dq
            ]
        ],
        \(dqpkt4\-ack\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616247\(dq
            ]
        ],
        \(dqpkt4\-ack\-sent\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616290\(dq
            ]
        ],
        \(dqpkt4\-decline\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616296\(dq
            ]
        ],
        \(dqpkt4\-discover\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616303\(dq
            ]
        ],
        \(dqpkt4\-inform\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616308\(dq
            ]
        ],
        \(dqpkt4\-nak\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616312\(dq
            ]
        ],
        \(dqpkt4\-nak\-sent\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616314\(dq
            ]
        ],
        \(dqpkt4\-offer\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616318\(dq
            ]
        ],
        \(dqpkt4\-offer\-sent\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616323\(dq
            ]
        ],
        \(dqpkt4\-parse\-failed\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616326\(dq
            ]
        ],
        \(dqpkt4\-receive\-drop\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616330\(dq
            ]
        ],
        \(dqpkt4\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616335\(dq
            ]
        ],
        \(dqpkt4\-release\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616339\(dq
            ]
        ],
        \(dqpkt4\-request\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616343\(dq
            ]
        ],
        \(dqpkt4\-sent\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616348\(dq
            ]
        ],
        \(dqpkt4\-unknown\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616354\(dq
            ]
        ],
        \(dqreclaimed\-declined\-addresses\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.836159\(dq
            ]
        ],
        \(dqreclaimed\-leases\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.836163\(dq
            ]
        ],
        \(dqv4\-allocation\-fail\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616358\(dq
            ]
        ],
        \(dqv4\-allocation\-fail\-classes\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616363\(dq
            ]
        ],
        \(dqv4\-allocation\-fail\-no\-pools\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616368\(dq
            ]
        ],
        \(dqv4\-allocation\-fail\-shared\-network\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616372\(dq
            ]
        ],
        \(dqv4\-allocation\-fail\-subnet\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616376\(dq
            ]
        ],
        \(dqv4\-lease\-reuses\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616410\(dq
            ]
        ],
        \(dqv4\-reservation\-conflicts\(dq: [
            [
                0,
                \(dq2023\-06\-13 20:42:46.616412\(dq
            ]
        ]
    }
}

or

{
    \(dqresult\(dq: 0,
    \(dqarguments\(dq: {
        \(dqassigned\-nas\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196757\(dq
            ]
        ],
        \(dqassigned\-pds\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196757\(dq
            ]
        ],
        \(dqcumulative\-assigned\-nas\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196757\(dq
            ]
        ],
        \(dqcumulative\-assigned\-pds\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196758\(dq
            ]
        ],
        \(dqdeclined\-addresses\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196754\(dq
            ]
        ],
        \(dqpkt6\-advertise\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177731\(dq
            ]
        ],
        \(dqpkt6\-advertise\-sent\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177739\(dq
            ]
        ],
        \(dqpkt6\-decline\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177739\(dq
            ]
        ],
        \(dqpkt6\-dhcpv4\-query\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177740\(dq
            ]
        ],
        \(dqpkt6\-dhcpv4\-response\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177740\(dq
            ]
        ],
        \(dqpkt6\-dhcpv4\-response\-sent\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177741\(dq
            ]
        ],
        \(dqpkt6\-infrequest\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177742\(dq
            ]
        ],
        \(dqpkt6\-parse\-failed\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177742\(dq
            ]
        ],
        \(dqpkt6\-rebind\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177743\(dq
            ]
        ],
        \(dqpkt6\-receive\-drop\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177743\(dq
            ]
        ],
        \(dqpkt6\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177744\(dq
            ]
        ],
        \(dqpkt6\-release\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177744\(dq
            ]
        ],
        \(dqpkt6\-renew\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177745\(dq
            ]
        ],
        \(dqpkt6\-reply\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177745\(dq
            ]
        ],
        \(dqpkt6\-reply\-sent\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177746\(dq
            ]
        ],
        \(dqpkt6\-request\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177747\(dq
            ]
        ],
        \(dqpkt6\-sent\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177747\(dq
            ]
        ],
        \(dqpkt6\-solicit\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177748\(dq
            ]
        ],
        \(dqpkt6\-unknown\-received\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177748\(dq
            ]
        ],
        \(dqreclaimed\-declined\-addresses\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196755\(dq
            ]
        ],
        \(dqreclaimed\-leases\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.196756\(dq
            ]
        ],
        \(dqv6\-allocation\-fail\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177749\(dq
            ]
        ],
        \(dqv6\-allocation\-fail\-classes\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177755\(dq
            ]
        ],
        \(dqv6\-allocation\-fail\-no\-pools\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177756\(dq
            ]
        ],
        \(dqv6\-allocation\-fail\-shared\-network\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177756\(dq
            ]
        ],
        \(dqv6\-allocation\-fail\-subnet\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177757\(dq
            ]
        ],
        \(dqv6\-ia\-na\-lease\-reuses\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177757\(dq
            ]
        ],
        \(dqv6\-ia\-pd\-lease\-reuses\(dq: [
            [
                0,
                \(dq2023\-06\-13 21:28:57.177758\(dq
            ]
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه (Result) نمایشی از وضعیت به‌صورت عدد صحیح است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت به پایان رسید، اما هیچ داده‌ای تغییر نکرد یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (conflict) (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تداخل بودند)
.UNINDENT
.SS statistic\-remove
.sp
این دستور یک داده آماری منفرد را حذف می‌کند. این دستور یک پارامتر رشته‌ای تکی به نام name دریافت می‌کند که نام داده آماری را مشخص می‌سازد.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4، kea\-dhcp6
.sp
در دسترس بودن: 1.0.0 (توکار)
.sp
دسترسی: write \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور statistic\-remove را ببینید \%<#\:command-statistic-remove>
.sp
ساختار دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqstatistic\-remove\(dq,
    \(dqarguments\(dq: {
        \(dqname\(dq: \(dqpkt4\-received\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر داده آماری مشخص‌شده پیدا شود و حذف آن موفقیت‌آمیز باشد، سرور با وضعیت 0 که نشان‌دهنده موفقیت است و یک فیلد parameters خالی پاسخ می‌دهد. اگر خطایی رخ دهد (برای مثال، داده آماری درخواستی پیدا نشود)، سرور کد وضعیت 1 (خطا) را بازمی‌گرداند و فیلد text حاوی شرح خطا خواهد بود.
.sp
ساختار پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: \(dq<string>\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
فیلد result یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت به پایان رسید، اما هیچ داده‌ای تغییر نکرد یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (conflict) (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تداخل بودند)
.UNINDENT
.SS statistic\-remove\-all
.sp
(منسوخ‌شده) این دستور تمام داده‌های آماری را حذف می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4، kea\-dhcp6
.sp
در دسترس بودن: 1.0.0 (توکار)
.sp
دسترسی: write \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور statistic\-remove\-all را ببینید \%<#\:command-statistic-remove-all>
.sp
ساختار دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqstatistic\-remove\-all\(dq,
    \(dqarguments\(dq: { }
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر حذف تمام داده‌های آماری موفقیت‌آمیز باشد، سرور با وضعیت 0 که نشان‌دهنده موفقیت است و یک فیلد parameters خالی پاسخ می‌دهد. اگر خطایی رخ دهد، سرور کد وضعیت 1 (خطا) را بازمی‌گرداند و فیلد text حاوی شرح خطا خواهد بود.
.sp
ساختار پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: \(dq<string>\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
فیلد result یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت به پایان رسید، اما هیچ داده‌ای تغییر نکرد یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (conflict) (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تداخل بودند)
.UNINDENT
.SS statistic\-reset
.sp
این دستور داده آماری مشخص‌شده را روی مقدار خنثی آن تنظیم می‌کند: 0 برای عدد صحیح (integer)، 0.0 برای ممیز شناور (float)، 0h0m0s0us برای مدت‌زمان (time duration)، و \(dq\(dq برای نوع رشته‌ای (string). این دستور یک پارامتر رشته‌ای تکی به نام name دریافت می‌کند که نام داده آماری را مشخص می‌سازد.
.sp
پشتیبانی‌شده توسط: kea\-dhcp\-ddns، kea\-dhcp4، kea\-dhcp6
.sp
در دسترس بودن: 1.0.0 (توکار)
.sp
دسترسی: write \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور statistic\-reset را ببینید \%<#\:command-statistic-reset>
.sp
ساختار دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqstatistic\-reset\(dq,
    \(dqarguments\(dq: {
        \(dqname\(dq: \(dqpkt4\-received\(dq
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر داده آماری مشخص‌شده پیدا شود و بازنشانی آن موفقیت‌آمیز باشد، سرور با وضعیت 0 که نشان‌دهنده موفقیت است و یک فیلد parameters خالی پاسخ می‌دهد. اگر خطایی رخ دهد (برای مثال، داده آماری درخواستی پیدا نشود)، سرور کد وضعیت 1 (خطا) را بازمی‌گرداند و فیلد text حاوی شرح خطا خواهد بود.
.sp
ساختار پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: \(dq<string>\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
فیلد result یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت به پایان رسید، اما هیچ داده‌ای تغییر نکرد یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (conflict) (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تداخل بودند)
.UNINDENT.SS statistic\-reset\-all
.sp
این دستور تمام آمارها را به مقادیر خنثی خود تنظیم می‌کند: 0 برای عدد صحیح (integer)، 0.0 برای ممیز شناور (float)، 0h0m0s0us برای بازه زمانی (time duration) و \(dq\(dq برای نوع رشته (string).
.sp
پشتیبانی‌شده توسط: kea\-dhcp\-ddns، kea\-dhcp4، kea\-dhcp6
.sp
در دسترس بودن: 1.0.0 (داخلی)
.sp
دسترسی: write \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
شرح و مثال‌ها: دستور statistic\-reset\-all را در \%<#\:command-statistic-reset-all> ببینید.
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqstatistic\-reset\-all\(dq,
    \(dqarguments\(dq: { }
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر عملیات موفقیت‌آمیز باشد، کارگزار با وضعیت 0 که نشان‌دهنده موفقیت است و یک فیلد پارامترهای خالی پاسخ می‌دهد. در صورت بروز خطا، کارگزار کد وضعیت 1 (خطا) را بازمی‌گرداند و فیلد text حاوی شرح خطا خواهد بود.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: \(dq<string>\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه (Result) نمایشی از وضعیت در قالب عدد صحیح است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت کامل شد، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (conflict) (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت کارگزار در تداخل بود)
.UNINDENT
.SS statistic\-sample\-age\-set
.sp
این دستور یک محدودیت زمانی را برای یک آماره منفرد تنظیم می‌کند. این دستور دو پارامتر دریافت می‌کند: یک رشته به نام name و یک مقدار عدد صحیح به نام duration.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4، kea\-dhcp6
.sp
در دسترس بودن: 1.6.0 (داخلی)
.sp
دسترسی: write \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
شرح و مثال‌ها: دستور statistic\-sample\-age\-set را در \%<#\:command-statistic-sample-age-set> ببینید.
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqstatistic\-sample\-age\-set\(dq,
    \(dqarguments\(dq: {
        \(dqname\(dq: \(dqpkt4\-received\(dq,
        \(dqduration\(dq: 1245
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
کارگزار پیامی مبنی بر تنظیم موفقیت‌آمیز محدودیت برای آماره مشخص‌شده، با نتیجه 0 نشان‌دهنده موفقیت و یک فیلد پارامترهای خالی برمی‌گرداند. در صورت بروز خطا (برای مثال اگر آماره درخواستی پیدا نشود)، کارگزار کد وضعیت 1 (خطا) را بازمی‌گرداند و فیلد text حاوی شرح خطا خواهد بود.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: \(dq<string>\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه (Result) نمایشی از وضعیت در قالب عدد صحیح است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت کامل شد، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (conflict) (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت کارگزار در تداخل بود)
.UNINDENT
.SS statistic\-sample\-age\-set\-all
.sp
این دستور یک محدودیت زمانی را برای تمامی آمارها تنظیم می‌کند. این دستور یک پارامتر منفرد از نوع عدد صحیح به نام duration دریافت می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4، kea\-dhcp6
.sp
در دسترس بودن: 1.6.0 (داخلی)
.sp
دسترسی: write \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
شرح و مثال‌ها: دستور statistic\-sample\-age\-set\-all را در \%<#\:command-statistic-sample-age-set-all> ببینید.
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqstatistic\-sample\-age\-set\-all\(dq,
    \(dqarguments\(dq: {
        \(dqduration\(dq: 1245
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
کارگزار پیامی مبنی بر تنظیم موفقیت‌آمیز محدودیت‌ها برای تمامی آمارها، با نتیجه 0 نشان‌دهنده موفقیت و یک فیلد پارامترهای خالی برمی‌گرداند. در صورت بروز خطا، کارگزار کد وضعیت 1 (خطا) را بازمی‌گرداند و فیلد text حاوی شرح خطا خواهد بود.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: \(dq<string>\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه (Result) نمایشی از وضعیت در قالب عدد صحیح است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت کامل شد، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (conflict) (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت کارگزار در تداخل بود)
.UNINDENT.SS statistic\-sample\-count\-set
.sp
این دستور یک محدودیت مبتنی بر اندازه را برای یک شاخص آماری منفرد تنظیم می‌کند. این دستور دو پارامتر دریافت می‌کند: یک رشته به نام name و یک مقدار عدد صحیح به نام max\-samples.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4، kea\-dhcp6
.sp
در دسترس بودن: 1.6.0 (داخلی)
.sp
سطح دسترسی: write \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور statistic\-sample\-count\-set را ببینید \%<#\:command-statistic-sample-count-set>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqstatistic\-sample\-count\-set\(dq,
    \(dqarguments\(dq: {
        \(dqname\(dq: \(dqpkt4\-received\(dq,
        \(dqmax\-samples\(dq: 100
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
سرور پیامی مبنی بر تنظیم موفقیت‌آمیز محدودیت برای شاخص آماری داده‌شده ارسال می‌کند، با مقدار 0 برای result که نشان‌دهنده موفقیت است، و یک فیلد خالی parameters. اگر خطایی رخ دهد (برای مثال شاخص آماری درخواستی یافت نشود)، سرور کد وضعیت 1 (خطا) را برمی‌گرداند و فیلد text حاوی شرح خطا خواهد بود.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: \(dq<string>\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
فیلد result یک نمایش عدد صحیح از وضعیت است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (دستور با موفقیت به پایان رسید، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تداخل بودند)
.UNINDENT
.SS statistic\-sample\-count\-set\-all
.sp
این دستور یک محدودیت مبتنی بر اندازه را برای تمام شاخص‌های آماری تنظیم می‌کند. این دستور یک پارامتر منفرد از نوع عدد صحیح به نام max\-samples می‌گیرد.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4، kea\-dhcp6
.sp
در دسترس بودن: 1.6.0 (داخلی)
.sp
سطح دسترسی: write \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور statistic\-sample\-count\-set\-all را ببینید \%<#\:command-statistic-sample-count-set-all>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqstatistic\-sample\-count\-set\-all\(dq,
    \(dqarguments\(dq: {
        \(dqmax\-samples\(dq: 100
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
سرور پیامی مبنی بر تنظیم موفقیت‌آمیز محدودیت‌ها برای تمام شاخص‌های آماری ارسال می‌کند، با مقدار 0 برای result که نشان‌دهنده موفقیت است، و یک فیلد خالی parameters. در صورت بروز خطا، سرور کد وضعیت 1 (خطا) را برمی‌گرداند و فیلد text حاوی شرح خطا خواهد بود.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: \(dq<string>\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
فیلد result یک نمایش عدد صحیح از وضعیت است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (دستور با موفقیت به پایان رسید، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تداخل بودند)
.UNINDENT
.SS status\-get
.sp
این دستور اطلاعات زمان اجرای سرور را برمی‌گرداند.
این دستور هیچ آرگومانی نمی‌پذیرد.
.sp
پشتیبانی‌شده توسط: kea\-dhcp\-ddns، kea\-dhcp4، kea\-dhcp6
.sp
در دسترس بودن: 1.7.3 (داخلی)
.sp
سطح دسترسی: read \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور status\-get را ببینید \%<#\:command-status-get>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqstatus\-get\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqarguments\(dq: {
        \(dqdhcp\-state\(dq: {
            \(dqdisabled\-by\-db\-connection\(dq: [],
            \(dqdisabled\-by\-local\-command\(dq: [],
            \(dqdisabled\-by\-remote\-command\(dq: [],
            \(dqdisabled\-by\-user\(dq: false,
            \(dqglobally\-disabled\(dq: false
        },
        \(dqextended\-info\-tables\(dq: <whether relay information is held in lease tables>,
        \(dqhigh\-availability\(dq: [
            {
                \(dqha\-mode\(dq: <HA mode configured for this relationship>,
                \(dqha\-servers\(dq: {
                    \(dqlocal\(dq: {
                        \(dqrole\(dq: <role of this server as in the configuration file>,
                        \(dqscopes\(dq: <list of scope names served by this server>,
                        \(dqserver\-name\(dq: <name of the local server>,
                        \(dqstate\(dq: <HA state name of the server receiving the command>,
                        \(dqsystem\-time\(dq: <system time in format \(aq%Y\-%m\-%d %H:%M:%S\(aq on UTC timezone>
                    },
                    \(dqremote\(dq: {
                        \(dqage\(dq: <the age of the remote status in seconds>,
                        \(dqanalyzed\-packets\(dq: <number of packets sent to the partner server since communication was interrupted>,
                        \(dqclock\-skew\(dq: <difference in seconds between local and partner server times>,
                        \(dqcommunication\-interrupted\(dq: <whether communication did not happen for more than max\-response\-delay milliseconds>,
                        \(dqconnecting\-clients\(dq: <number of different clients getting a lease from partner>,
                        \(dqin\-touch\(dq: <indicates if this server communicated with partner>,
                        \(dqlast\-scopes\(dq: <list of scopes served by partner>,
                        \(dqlast\-state\(dq: <HA state name of the partner>,
                        \(dqrole\(dq: <partner role>,
                        \(dqserver\-name\(dq: <name of the partner server>,
                        \(dqsystem\-time\(dq: <system time in format \(aq%Y\-%m\-%d %H:%M:%S\(aq on UTC timezone>,
                        \(dqunacked\-clients\(dq: <number of unacked clients>,
                        \(dqunacked\-clients\-left\(dq: <how many more clients have to be unacked before partner\-down state>
                    }
                }
            }
        ],
        \(dqmulti\-threading\-enabled\(dq: true,
        \(dqpacket\-queue\-size\(dq: 64,
        \(dqpacket\-queue\-statistics\(dq: [ 1.2, 2.3, 3.4 ],
        \(dqpid\(dq: <integer>,
        \(dqreload\(dq: <time since reload in seconds>,
        \(dqsockets\(dq: {
            \(dqerrors\(dq: <list of errors received during the last attempt to open all sockets; only appears when status is failed or retrying>,
            \(dqstatus\(dq: <ready, retrying, or failed>
        },
        \(dqthread\-pool\-size\(dq: 4,
        \(dquptime\(dq: <uptime in seconds>
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر کتابخانه قلاب‌های libdhcp_ha (دسترس‌پذیری بالا یا High Availability) توسط سرور DHCP دریافت‌کننده این دستور بارگذاری شده باشد، پاسخ همچنین شامل اطلاعات وضعیت مختص HA سرور دریافت‌کننده دستور و وضعیت سرور همتای آن (partner) خواهد بود..SS subnet4\-add
.sp
این دستور یک زیرشبکه جدید ایجاد کرده و به پیکربندی موجود سرور اضافه می‌کند. این عملیات هیچ تأثیری بر سایر زیرشبکه‌ها ندارد.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس در: 1.3.0 (کتابخانه قلاب subnet_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور subnet4\-add را ببینید \%<#\:command-subnet4-add>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqsubnet4\-add\(dq,
    \(dqarguments\(dq: {
        \(dqsubnet4\(dq: [ {
            \(dqid\(dq: 123,
            \(dqsubnet\(dq: \(dq10.20.30.0/24\(dq,
            ...
        } ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqIPv4 subnet added\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [
            {
                \(dqid\(dq: 123,
                \(dqsubnet\(dq: \(dq10.20.30.0/24\(dq
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه، یک نمایش عدد صحیح از وضعیت است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارت‌اند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت
.IP \(bu 2
1 \- خطا
.IP \(bu 2
2 \- پشتیبانی‌نشده
.IP \(bu 2
3 \- خالی (دستور با موفقیت به پایان رسید، اما هیچ داده‌ای تغییر نکرد یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تعارض بود)
.UNINDENT
.SS subnet4\-del
.sp
این دستور یک زیرشبکه را از پیکربندی سرور حذف می‌کند. این دستور هیچ اثری بر سایر زیرشبکه‌های پیکربندی‌شده ندارد، اما حذف یک زیرشبکه پیامدهای خاصی به همراه دارد که مدیر سرور باید از آن‌ها آگاه باشد.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس در: 1.3.0 (کتابخانه قلاب subnet_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور subnet4\-del را ببینید \%<#\:command-subnet4-del>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqsubnet4\-del\(dq,
    \(dqarguments\(dq: {
        \(dqid\(dq: 123
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqIPv4 subnet 192.0.2.0/24 (id 123) deleted\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [
            {
                \(dqid\(dq: 123,
                \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه، یک نمایش عدد صحیح از وضعیت است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارت‌اند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت
.IP \(bu 2
1 \- خطا
.IP \(bu 2
2 \- پشتیبانی‌نشده
.IP \(bu 2
3 \- خالی (دستور با موفقیت به پایان رسید، اما هیچ داده‌ای تغییر نکرد یا بازگردانده نشد)
.IP \(bu 2
4 \- تعارض (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تعارض بود)
.UNINDENT.SS subnet4\-delta\-add
.sp
این دستور بخش‌هایی از یک زیرشبکه منفرد را در پیکربندی موجود سرور به‌روزرسانی (اضافه یا رونویسی) می‌کند. این عملیات تأثیری بر سایر زیرشبکه‌ها ندارد.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
دسترس‌پذیری: 2.1.7 (کتابخانه هوک subnet_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور subnet4\-delta\-add را ببینید \%<#\:command-subnet4-delta-add>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqsubnet4\-delta\-add\(dq,
    \(dqarguments\(dq: {
        \(dqsubnet4\(dq: [ {
            \(dqid\(dq: 123,
            \(dqsubnet\(dq: \(dq10.20.30.0/24\(dq,
            ...
        } ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqIPv4 subnet updated\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [
            {
                \(dqid\(dq: 123,
                \(dqsubnet\(dq: \(dq10.20.30.0/24\(dq
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه، نمایشی از وضعیت به‌صورت یک عدد صحیح است. وضعیت‌های پشتیبانی‌شده کنونی عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت
.IP \(bu 2
1 \- خطا
.IP \(bu 2
2 \- پشتیبانی‌نشده
.IP \(bu 2
3 \- خالی (دستور با موفقیت کامل شد، اما هیچ داده‌ای تغییر نکرد یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور تداخل داشتند)
.UNINDENT
.SS subnet4\-delta\-del
.sp
این دستور بخش‌هایی از یک زیرشبکه منفرد را در پیکربندی موجود سرور به‌روزرسانی (حذف) می‌کند. این عملیات تأثیری بر سایر زیرشبکه‌ها ندارد.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
دسترس‌پذیری: 2.1.7 (کتابخانه هوک subnet_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور subnet4\-delta\-del را ببینید \%<#\:command-subnet4-delta-del>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqsubnet4\-delta\-del\(dq,
    \(dqarguments\(dq: {
        \(dqsubnet4\(dq: [ {
            \(dqid\(dq: 123,
            \(dqsubnet\(dq: \(dq10.20.30.0/24\(dq,
            ...
        } ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqIPv4 subnet updated\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [
            {
                \(dqid\(dq: 123,
                \(dqsubnet\(dq: \(dq10.20.30.0/24\(dq
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه، نمایشی از وضعیت به‌صورت یک عدد صحیح است. وضعیت‌های پشتیبانی‌شده کنونی عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت
.IP \(bu 2
1 \- خطا
.IP \(bu 2
2 \- پشتیبانی‌نشده
.IP \(bu 2
3 \- خالی (دستور با موفقیت کامل شد، اما هیچ داده‌ای تغییر نکرد یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور تداخل داشتند)
.UNINDENT.SS subnet4\-get
.sp
این دستور اطلاعات دقیق درباره زیرشبکه (subnet) مشخص‌شده را بازیابی می‌کند. این دستور معمولاً پس از \fBsubnet4\-list\fP اجرا می‌شود که زیرشبکه‌های موجود را به همراه شناسه‌ها و پیشوندهای زیرشبکه مربوط به هرکدام شناسایی می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس بودن: 1.3.0 (کتابخانه قلاب subnet_cmds)
.sp
دسترسی: خواندن \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور subnet4\-get را ببینید \%<#\:command-subnet4-get>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqsubnet4\-get\(dq,
    \(dqarguments\(dq: {
        \(dqid\(dq: 10
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqInfo about IPv4 subnet 10.0.0.0/8 (id 10) returned\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [
            {
                \(dqsubnet\(dq: \(dq10.0.0.0/8\(dq,
                \(dqid\(dq: 1,
                \(dqoption\-data\(dq: [{
                    ...
                }],
                ...
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه (result) یک نمایش عدد صحیح از وضعیت است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت‌آمیز (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty): دستور با موفقیت انجام شد، اما هیچ داده‌ای تغییر نیافت یا بازگردانده نشد
.IP \(bu 2
4 \- تداخل (conflict): دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تداخل بود
.UNINDENT
.SS subnet4\-list
.sp
این دستور تمام زیرشبکه‌هایی را که در حال حاضر پیکربندی شده‌اند فهرست می‌کند. زیرشبکه‌ها در قالبی خلاصه بازگردانده می‌شوند؛ یعنی برای هر زیرشبکه، شناسه زیرشبکه، پیشوند زیرشبکه، و نام شبکه مشترک (در صورت وجود) گنجانده شده است.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس بودن: 1.3.0 (کتابخانه قلاب subnet_cmds)
.sp
دسترسی: خواندن \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور subnet4\-list را ببینید \%<#\:command-subnet4-list>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqsubnet4\-list\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq2 IPv4 subnets found\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [
            {
                \(dqid\(dq: 10,
                \(dqsubnet\(dq: \(dq10.0.0.0/8\(dq
            },
            {
                \(dqid\(dq: 100,
                \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
                \(dqshared\-network\-name\(dq: \(dqexample\-shared\-network\(dq
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر هیچ زیرشبکه IPv4 یافت نشود، یک کد خطا به همراه توضیحات خطا بازگردانده می‌شود.
.SS subnet4\-select\-test
.sp
این دستور نتیجه انتخاب زیرشبکه DHCPv4 را بازمی‌گرداند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس بودن: 2.7.0 (توکار \- built\-in)
.sp
دسترسی: خواندن \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور subnet4\-select\-test را ببینید \%<#\:command-subnet4-select-test>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqsubnet4\-select\-test\(dq,
    \(dqarguments\(dq: {
        \(dqinterface\(dq: <string>,
        \(dqaddress\(dq: <string>,
        \(dqrelay\(dq: <string>,
        \(dqlocal\(dq: <string>,
        \(dqremote\(dq: <string>,
        \(dqlink\(dq: <string>,
        \(dqsubnet\(dq: <string>,
        \(dqclasses\(dq: [ <strings> ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پارامترهای ممکن عبارتند از نام رابط ورودی، نشانی کلاینت، نشانی رله (relay)، کلاس‌های کلاینت، و غیره.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{ \(dqresult\(dq: 1, \(dqtext\(dq: <localization result> }
.EE
.UNINDENT
.UNINDENT
.sp
۳ حالت برای شبکه مشترک انتخاب‌شده، زیرشبکه، یا هیچ‌چیز..SS subnet4\-update
.sp
این دستور یک زیرشبکه تکی را در پیکربندی موجود سرور به‌روزرسانی (بازنویسی) می‌کند. این عملیات هیچ اثری بر سایر زیرشبکه‌ها ندارد.
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس بودن: 1.6.0 (کتابخانه قلاب subnet_cmds)
.sp
دسترسی: write \fI(پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور subnet4\-update را ببینید \%<#\:command-subnet4-update>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqsubnet4\-update\(dq,
    \(dqarguments\(dq: {
        \(dqsubnet4\(dq: [ {
            \(dqid\(dq: 123,
            \(dqsubnet\(dq: \(dq10.20.30.0/24\(dq,
            ...
        } ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqIPv4 subnet updated\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [
            {
                \(dqid\(dq: 123,
                \(dqsubnet\(dq: \(dq10.20.30.0/24\(dq
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت کامل شد، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (conflict) (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تداخل بود)
.UNINDENT
.SS subnet4o6\-select\-test
.sp
این دستور نتیجه انتخاب زیرشبکه DHCPv4o6 را برمی‌گرداند
.sp
پشتیبانی‌شده توسط: kea\-dhcp4
.sp
در دسترس بودن: 2.7.0 (توکار built\-in)
.sp
دسترسی: read \fI(پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور subnet4o6\-select\-test را ببینید \%<#\:command-subnet4o6-select-test>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqsubnet4o6\-select\-test\(dq,
    \(dqarguments\(dq: {
        \(dqinterface\(dq: <string>,
        \(dqinterface\-id\(dq: <string>,
        \(dqaddress\(dq: <string>,
        \(dqrelay\(dq: <string>,
        \(dqlocal\(dq: <string>,
        \(dqremote\(dq: <string>,
        \(dqlink\(dq: <string>,
        \(dqsubnet\(dq: <string>,
        \(dqclasses\(dq: [ <strings> ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پارامترهای ممکن عبارتند از: آدرس دوردست (remote address)، گزینه شناسه واسط (interface id option)، نام واسط (هر سه از سرور DHCPv6)، و غیره.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{ \(dqresult\(dq: 1, \(dqtext\(dq: <localization result> }
.EE
.UNINDENT
.UNINDENT
.sp
۳ حالت برای شبکه مشترک انتخاب‌شده، زیرشبکه یا هیچ‌چیز..
.SS subnet6\-add
.sp
این دستور یک زیرشبکه جدید را ایجاد کرده و به پیکربندی موجود سرور اضافه می‌کند. این عملیات هیچ اثری بر سایر زیرشبکه‌ها ندارد.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس بودن: 1.3.0 (کتابخانه قلاب subnet_cmds)
.sp
دسترسی: write \fI(پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور subnet6\-add را ببینید \%<#\:command-subnet6-add>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqsubnet6\-add\(dq,
    \(dqarguments\(dq: {
        \(dqsubnet6\(dq: [ {
            \(dqid\(dq: 234,
            \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
            ...
        } ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqIPv6 subnet added\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [
            {
                \(dqid\(dq: 234,
                \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت کامل شد، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (conflict) (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تداخل بود)
.UNINDENT.SS subnet6\-del
.sp
این دستور یک زیرشبکه را از پیکربندی کارگزار حذف می‌کند. این دستور تأثیری بر سایر زیرشبکه‌های پیکربندی‌شده ندارد، اما حذف یک زیرشبکه پیامدهای خاصی به همراه دارد که مدیر سیستم کارگزار باید از آن‌ها آگاه باشد.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس بودن: 1.3.0 (کتابخانه قلاب subnet_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور subnet6\-del را ببینید \%<#\:command-subnet6-del>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqsubnet6\-del\(dq,
    \(dqarguments\(dq: {
        \(dqid\(dq: 234
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqIPv6 subnet 2001:db8:1::/64 (id 234) deleted\(dq,
    \(dqsubnets\(dq: [
        {
            \(dqid\(dq: 234,
            \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq
        }
    ]
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه، نمایشی عددی (عدد صحیح) از وضعیت است. وضعیت‌های پشتیبانی‌شده فعلی عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (دستور با موفقیت انجام شد، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت کارگزار در تداخل بود)
.UNINDENT
.SS subnet6\-delta\-add
.sp
این دستور بخش‌هایی از یک زیرشبکه منفرد را در پیکربندی موجود کارگزار به‌روزرسانی (اضافه یا رونویسی) می‌کند. این عملیات هیچ تأثیری بر سایر زیرشبکه‌ها ندارد.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس بودن: 2.1.7 (کتابخانه قلاب subnet_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور subnet6\-delta\-add را ببینید \%<#\:command-subnet6-delta-add>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqsubnet6\-delta\-add\(dq,
    \(dqarguments\(dq: {
        \(dqsubnet6\(dq: [ {
            \(dqid\(dq: 234,
            \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
            ...
        } ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqIPv6 subnet updated\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [
            {
                \(dqid\(dq: 234,
                \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه، نمایشی عددی (عدد صحیح) از وضعیت است. وضعیت‌های پشتیبانی‌شده فعلی عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (دستور با موفقیت انجام شد، اما هیچ داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت کارگزار در تداخل بود)
.UNINDENT.SS subnet6\-delta\-del
.sp
این دستور بخش‌هایی از یک زیرشبکهٔ منفرد را در پیکربندی موجود کارساز به‌روزرسانی (حذف) می‌کند. این عملیات هیچ اثری بر روی سایر زیرشبکه‌ها ندارد.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
دسترس‌پذیری: 2.1.7 (کتابخانهٔ قلاب subnet_cmds)
.sp
دسترسی: read \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور subnet6\-delta\-del را ببینید \%<#\:command-subnet6-delta-del>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqsubnet6\-delta\-del\(dq,
    \(dqarguments\(dq: {
        \(dqsubnet6\(dq: [ {
            \(dqid\(dq: 234,
            \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
            ...
        } ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqIPv6 subnet updated\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [
            {
                \(dqid\(dq: 234,
                \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت
.IP \(bu 2
1 \- خطا
.IP \(bu 2
2 \- پشتیبانی‌نشده
.IP \(bu 2
3 \- خالی (دستور با موفقیت کامل شد، اما هیچ داده‌ای متأثر نشد یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت کارساز در تداخل بود)
.UNINDENT
.SS subnet6\-get
.sp
این دستور اطلاعات تفصیلی را دربارهٔ زیرشبکهٔ مشخص‌شده بازیابی می‌کند. این دستور معمولاً پس از \fBsubnet6\-list\fP می‌آید که زیرشبکه‌های موجود را به همراه شناسه‌ها و پیشوندهای مربوط به آن‌ها پیدا می‌کند.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
دسترس‌پذیری: 1.3.0 (کتابخانهٔ قلاب subnet_cmds)
.sp
دسترسی: read \fI(این پارامتر در این نسخه از Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور subnet6\-get را ببینید \%<#\:command-subnet6-get>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqsubnet6\-get\(dq,
    \(dqarguments\(dq: {
        \(dqid\(dq: 11
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqInfo about IPv6 subnet 2001:db8:1::/64 (id 11) returned\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [
            {
                \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
                \(dqid\(dq: 1,
                \(dqoption\-data\(dq: [{
                    ...
                }],
                ...
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه یک نمایش عدد صحیح از وضعیت است. وضعیت‌های پشتیبانی‌شده در حال حاضر عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت
.IP \(bu 2
1 \- خطا
.IP \(bu 2
2 \- پشتیبانی‌نشده
.IP \(bu 2
3 \- خالی (دستور با موفقیت کامل شد، اما هیچ داده‌ای متأثر نشد یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت کارساز در تداخل بود)
.UNINDENT.SS subnet6\-list
.sp
این دستور تمام زیرشبکه‌های پیکربندی‌شده فعلی را فهرست می‌کند. زیرشبکه‌ها در قالبی مختصر برگردانده می‌شوند، یعنی برای هر زیرشبکه یک شناسه زیرشبکه، پیشوند زیرشبکه، و نام شبکه اشتراکی گنجانده شده است.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس بودن: 1.3.0 (کتابخانه هوک subnet_cmds)
.sp
دسترسی: read \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور subnet6\-list را ببینید \%<#\:command-subnet6-list>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqsubnet6\-list\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dq2 IPv6 subnets found\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [
            {
                \(dqid\(dq: 11,
                \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq
            },
            {
                \(dqid\(dq: 233,
                \(dqsubnet\(dq: \(dq3000::/16\(dq,
                \(dqshared\-network\-name\(dq: \(dqexample\-shared\-network\(dq
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر هیچ زیرشبکه IPv6ای یافت نشود، یک کد خطا همراه با توضیحات خطا برگردانده می‌شود.
.SS subnet6\-select\-test
.sp
این دستور نتیجه انتخاب زیرشبکه DHCPv6 را برمی‌گرداند
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس بودن: 2.7.0 (توکار)
.sp
دسترسی: read \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور subnet6\-select\-test را ببینید \%<#\:command-subnet6-select-test>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqsubnet6\-select\-test\(dq,
    \(dqarguments\(dq: {
        \(dqinterface\(dq: <string>,
        \(dqinterface\-id\(dq: <string>,
        \(dqremote\(dq: <string>,
        \(dqlink\(dq: <string>,
        \(dqclasses\(dq: [ <strings> ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
پارامترهای ممکن عبارتند از نام رابط ورودی، نشانی دوردست (remote address)، نشانی پیوند رله (relay link address)، کلاس‌های کلاینت، و غیره.
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{ \(dqresult\(dq: 1, \(dqtext\(dq: <localization result> }
.EE
.UNINDENT
.UNINDENT
.sp
۳ حالت برای شبکه اشتراکی انتخاب‌شده، زیرشبکه، یا هیچ‌چیز..
.SS subnet6\-update
.sp
این دستور یک زیرشبکه تکی را در پیکربندی موجود سرور به‌روزرسانی (بازنویسی) می‌کند. این عملیات تاثیری بر سایر زیرشبکه‌ها ندارد.
.sp
پشتیبانی‌شده توسط: kea\-dhcp6
.sp
در دسترس بودن: 1.6.0 (کتابخانه هوک subnet_cmds)
.sp
دسترسی: write \fI(این پارامتر در این نسخه Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: دستور subnet6\-update را ببینید \%<#\:command-subnet6-update>
.sp
نحو دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqsubnet6\-update\(dq,
    \(dqarguments\(dq: {
        \(dqsubnet6\(dq: [ {
            \(dqid\(dq: 234,
            \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
            ...
        } ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نحو پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: 0,
    \(dqtext\(dq: \(dqIPv6 subnet updated\(dq,
    \(dqarguments\(dq: {
        \(dqsubnets\(dq: [
            {
                \(dqid\(dq: 234,
                \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه، نمایشی عددی از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (دستور با موفقیت انجام شد، اما داده‌ای تحت تأثیر قرار نگرفت یا بازگردانده نشد)
.IP \(bu 2
4 \- تداخل (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور در تداخل بودند)
.UNINDENT.SS version\-get
.sp
این دستور اطلاعات تفصیلی و تکمیلی را دربارهٔ نسخهٔ Kea در حال اجرا بازمی‌گرداند. رشتهٔ بازگردانده‌شده همانند حالتی است که Kea با گزینهٔ خط فرمان \fB\-V\fP اجرا شده باشد.
.sp
پشتیبانی‌شده توسط: kea\-dhcp\-ddns، kea\-dhcp4، kea\-dhcp6
.sp
در دسترس بودن: 1.2.0 (داخلی)
.sp
دسترسی: read \fI(این پارامتر در این نسخهٔ Kea نادیده گرفته می‌شود)\fP
.sp
توضیحات و مثال‌ها: به دستور version\-get در \%<#\:command-version-get> مراجعه کنید
.sp
ساختار دستور:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqcommand\(dq: \(dqversion\-get\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
ساختار پاسخ:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqresult\(dq: <integer>,
    \(dqtext\(dq: \(dq<string>\(dq
}
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه (Result) یک نمایش عددی صحیح از وضعیت است. وضعیت‌هایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.INDENT 0.0
.IP \(bu 2
0 \- موفقیت (success)
.IP \(bu 2
1 \- خطا (error)
.IP \(bu 2
2 \- پشتیبانی‌نشده (unsupported)
.IP \(bu 2
3 \- خالی (empty) (دستور با موفقیت به پایان رسید، اما هیچ داده‌ای تغییر نیافت یا برگردانده نشد)
.IP \(bu 2
4 \- تداخل (conflict) (دستور نتوانست تغییرات پیکربندی درخواستی را اعمال کند زیرا با وضعیت سرور تداخل داشت)
.UNINDENT
.SH "صفحات راهنما (MANUAL PAGES)"
.SS \fBkea\-dhcp4\fP \- سرور DHCPv4 در Kea
.SS "خلاصه دستور (SYNOPSIS)"
.sp
\fBkea\-dhcp4\fP [\fB\-v\fP] [\fB\-V\fP] [\fB\-W\fP] [\fB\-d\fP] [\fB\-c\fP config\-file] [\fB\-t\fP config\-file] [\fB\-p\fP server\-port\-number] [\fB\-P\fP client\-port\-number]
.SS "توضیحات (DESCRIPTION)"
.sp
دیمن \fBkea\-dhcp4\fP پیاده‌سازی سرور DHCPv4 را فراهم می‌کند.
.SS "آرگومان‌ها (ARGUMENTS)"
.sp
آرگومان‌ها به شرح زیر هستند:
.INDENT 0.0
.TP
.B \fB\-v\fP
نسخهٔ Kea را نمایش می‌دهد.
.TP
.B \fB\-V\fP
نسخهٔ تفصیلی Kea را نمایش می‌دهد.
.TP
.B \fB\-W\fP
گزارش پیکربندی را نمایش می‌دهد.
.TP
.B \fB\-d\fP
حالت اشکال‌زدایی (debug) را با پرگویی بیش‌تر فعال می‌کند.
.TP
.B \fB\-c config\-file\fP
فایل پیکربندی حاوی تنظیمات سرور DHCPv4 را مشخص می‌کند. این فایل همچنین ممکن است دربردارندهٔ ورودی‌های پیکربندی برای سایر سرویس‌های Kea نیز باشد.
.TP
.B \fB\-t config\-file\fP
فایل پیکربندی را بررسی کرده و نخستین خطا را (در صورت وجود) گزارش می‌کند. توجه داشته باشید که همهٔ پارامترها به‌طور کامل بررسی نمی‌شوند؛ به‌ویژه سوکت‌های سرویس و کانال کنترل باز نمی‌شوند و کتابخانه‌های hook بارگذاری نمی‌گردند.
.TP
.B \fB\-T config\-file\fP
فایل پیکربندی را بررسی کرده و نخستین خطا را (در صورت وجود) گزارش می‌کند. این گزینه بررسی‌های اضافی فراتر از آنچه \-t ارائه می‌دهد انجام می‌دهد، از جمله برقراری اتصال‌های پایگاه‌داده (برای بک‌اند اجاره‌ها، بک‌اند رزروهای میزبان، بک‌اند پیکربندی، و بک‌اند ثبت وقایع قانونی [forensic logging])، بارگذاری کتابخانه‌های hook، تجزیهٔ پیکربندی‌های کتابخانهٔ hook و غیره. این گزینه سوکت‌های UNIX یا TCP/UDP را باز نمی‌کند و فایل‌ها را نیز باز نکرده یا بازچرخانی (rotate) نمی‌کند، زیرا هر یک از این اقدامات ممکن است با یک فرایند در حال اجرا روی همان ماشین تداخل پیدا کند.
.TP
.B \fB\-p server\-port\-number\fP
شماره درگاه سرور (1\-65535) را که سرور روی آن گوش می‌دهد مشخص می‌کند. این گزینه صرفاً برای اهداف آزمایشی کاربرد دارد.
.TP
.B \fB\-P client\-port\-number\fP
شماره درگاه کلاینت (1\-65535) را که سرور به آن پاسخ می‌دهد مشخص می‌کند. این گزینه صرفاً برای اهداف آزمایشی کاربرد دارد.
.UNINDENT
.SS "مستندات (DOCUMENTATION)"
.sp
نرم‌افزار Kea به همراه یک «کتابچهٔ راهنمای مرجع مدیر سیستم Kea» (Kea Administrator Reference Manual) جامع ارائه می‌شود که تمام جنبه‌های اجرای نرم‌افزار Kea \- شامل کامپایل، نصب، پیکربندی، مثال‌های پیکربندی و موارد دیگر \- را پوشش می‌دهد. همچنین Kea دارای یک «راهنمای پیام‌های Kea» (Kea Messages Manual) است که تمامی پیام‌های احتمالی را که Kea می‌تواند چاپ کند به همراه توضیحی کوتاه برای هر یک فهرست می‌نماید. هر دو سند در قالب‌های مختلف (.txt، .html، .pdf) به همراه توزیع Kea در دسترس هستند. مستندات Kea در \%<https://\:kea\:.readthedocs\:.io>\& در دسترس است.
.sp
کد منبع Kea در «راهنمای توسعه‌دهندهٔ Kea» (Kea Developer\(aqs Guide) مستندسازی شده و در \%<https://\:reports\:.kea\:.isc\:.org/\:dev_guide>\& در دسترس است.
.sp
وب‌سایت پروژهٔ Kea در \%<https://\:kea\:.isc\:.org>\& در دسترس است.
.SS "فهرست‌های پستی و پشتیبانی (MAILING LISTS AND SUPPORT)"
.sp
دو فهرست پستی عمومی برای پروژهٔ Kea در دسترس است. فهرست \fBkea\-users\fP (kea\-users در lists.isc.org) برای کاربران Kea در نظر گرفته شده است، در حالی که \fBkea\-dev\fP (kea\-dev در lists.isc.org) برای توسعه‌دهندگان Kea، مشارکت‌کنندگان آینده و دیگر کاربران پیشرفته اختصاص دارد. هر دو فهرست در \%<https://\:lists\:.isc\:.org>\& در دسترس هستند. جامعهٔ کاربری در هر دو فهرست پستی بر مبنای بهترین تلاش (best\-effort) پشتیبانی ارائه می‌دهد.
.sp
شرکت ISC پشتیبانی حرفه‌ای برای سرویس‌های Kea ارائه می‌کند. برای جزئیات بیشتر به \%<https://\:www\:.isc\:.org/\:kea> مراجعه کنید..SS تاریخچه (HISTORY)
.sp
دیمن \fBb10\-dhcp4\fP نخستین‌بار در نوامبر ۲۰۱۱ توسط Tomek
Mrugalski کدنویسی شد.
.sp
در اواسط ۲۰۱۴، Kea از چارچوب BIND 10 جدا شد و به یک
سرور DHCP مستقل تبدیل گردید. باینری سرور DHCPv4 به
\fBkea\-dhcp4\fP تغییر نام یافت\&. نسخه Kea 1.0.0 در دسامبر ۲۰۱۵ منتشر شد.
.SS همچنین ببینید (SEE ALSO)
.sp
\fBkea\-dhcp6(8)\fP, \fBkea\-dhcp\-ddns(8)\fP,
\fBkea\-admin(8)\fP, \fBkeactrl(8)\fP,
\fBperfdhcp(8)\fP, \fBkea\-netconf(8)\fP, \fBkea\-lfc(8)\fP,
Kea Administrator Reference Manual.
.SS \fBkea\-dhcp6\fP \- سرور DHCPv6 در Kea
.SS خلاصه دستور (SYNOPSIS)
.sp
\fBkea\-dhcp6\fP [\fB\-v\fP] [\fB\-V\fP] [\fB\-W\fP] [\fB\-d\fP] [\fB\-c\fP config\-file] [\fB\-t\fP config\-file] [\fB\-p\fP server\-port\-number] [\fB\-P\fP client\-port\-number]
.SS توضیحات (DESCRIPTION)
.sp
دیمن \fBkea\-dhcp6\fP پیاده‌سازی سرور DHCPv6 را ارائه می‌دهد.
.SS آرگومان‌ها (ARGUMENTS)
.sp
آرگومان‌ها به شرح زیر هستند:
.INDENT 0.0
.TP
.B \fB\-v\fP
نسخه Kea را نمایش می‌دهد.
.TP
.B \fB\-V\fP
نسخه تفصیلی و گسترش‌یافته Kea را نمایش می‌دهد.
.TP
.B \fB\-W\fP
گزارش پیکربندی را نمایش می‌دهد.
.TP
.B \fB\-d\fP
حالت اشکال‌زدایی (debug) را با پرگویی بیشتر فعال می‌کند.
.TP
.B \fB\-c config\-file\fP
فایل پیکربندی حاوی تنظیمات سرور DHCPv6 را مشخص می‌کند. این فایل
همچنین ممکن است شامل مدخل‌های پیکربندی سایر سرویس‌های Kea نیز باشد.
.TP
.B \fB\-t config\-file\fP
فایل پیکربندی را بررسی کرده و در صورت وجود، نخستین خطا را گزارش می‌دهد. توجه
داشته باشید که تمامی پارامترها به‌طور کامل بررسی نمی‌شوند؛ به‌ویژه،
سوکت‌های سرویس و کانال کنترل باز نمی‌شوند و کتابخانه‌های هوک (hook)
بارگذاری نمی‌گردند.
.TP
.B \fB\-T config\-file\fP
فایل پیکربندی را بررسی کرده و در صورت وجود، نخستین خطا را گزارش می‌دهد.
این گزینه بررسی‌های بیشتری فراتر از آن‌چه \-t ارائه می‌دهد انجام می‌دهد، مانند برقراری
اتصالات پایگاه داده (برای بک‌اند اجاره‌ها، بک‌اند رزرو میزبان‌ها،
بک‌اند پیکربندی و بک‌اند لاگ قانونی)، بارگذاری کتابخانه‌های هوک،
تجزیه پیکربندی کتابخانه‌های هوک و غیره. این گزینه سوکت‌های UNIX یا TCP/UDP را باز نمی‌کند و
فایل‌ها را نیز باز یا بازچرخانی (rotate) نمی‌کند، چرا که هر یک از این اقدامات می‌تواند با
یک فرایند در حال اجرا روی همان ماشین تداخل ایجاد کند.
.TP
.B \fB\-p server\-port\-number\fP
شماره پورت سرور (۱\-۶۵۵۳۵) را که سرور روی آن شنود می‌کند مشخص می‌سازد. این گزینه
صرفاً برای اهداف آزمایشی کاربرد دارد.
.TP
.B \fB\-P client\-port\-number\fP
شماره پورت کلاینت (۱\-۶۵۵۳۵) را که سرور به آن پاسخ می‌دهد مشخص می‌سازد. این گزینه
صرفاً برای اهداف آزمایشی کاربرد دارد.
.UNINDENT
.SS مستندات (DOCUMENTATION)
.sp
پروژه Kea همراه با یک راهنمای مرجع جامع مدیر سیستم (Kea Administrator Reference Manual) ارائه می‌شود که
تمامی جنبه‌های اجرای نرم‌افزار Kea \- شامل کامپایل، نصب،
پیکربندی، نمونه‌های پیکربندی و موارد دیگر \- را پوشش می‌دهد. همچنین Kea دارای یک
Kea Messages Manual است که تمام پیام‌های قابل چاپ توسط Kea را
به همراه توضیح مختصری برای هر یک فهرست می‌کند. هر دو سند
در قالب‌های گوناگون (.txt، .html، .pdf) همراه با توزیع Kea
در دسترس هستند. مستندات Kea در نشانی زیر در دسترس است:
\%<https://\:kea\:.readthedocs\:.io>\&.
.sp
کد منبع Kea در Kea Developer\(aqs Guide مستند شده است
که در نشانی زیر در دسترس قرار دارد:
\%<https://\:reports\:.kea\:.isc\:.org/\:dev_guide>\&.
.sp
وبگاه پروژه Kea در نشانی زیر در دسترس است:
\%<https://\:kea\:.isc\:.org>\&.
.SS فهرست‌های پستی و پشتیبانی (MAILING LISTS AND SUPPORT)
.sp
دو فهرست پستی عمومی برای پروژه Kea در دسترس است. \fBkea\-users\fP
(kea\-users در lists.isc.org) برای کاربران Kea در نظر گرفته شده است، در حالی که \fBkea\-dev\fP
(kea\-dev در lists.isc.org) برای توسعه‌دهندگان Kea، مشارکت‌کنندگان
بالقوه و دیگر کاربران پیشرفته است. هر دو فهرست در
\%<https://\:lists\:.isc\:.org>\& در دسترس هستند. جامعه کاربری
پشتیبانی بر مبنای تمام تلاش (best\-effort) را روی هر دوی این فهرست‌ها ارائه می‌دهد.
.sp
شرکت ISC پشتیبانی حرفه‌ای برای سرویس‌های Kea ارائه می‌کند. برای جزئیات به
\%<https://\:www\:.isc\:.org/\:kea> مراجعه کنید.
.SS تاریخچه (HISTORY)
.sp
دیمن \fBb10\-dhcp6\fP نخستین‌بار در ژوئن ۲۰۱۱ توسط Tomek
Mrugalski کدنویسی شد.
.sp
در اواسط ۲۰۱۴، Kea از چارچوب BIND 10 جدا شد و به یک
سرور DHCP مستقل تبدیل گردید. باینری سرور DHCPv6 به
\fBkea\-dhcp6\fP تغییر نام یافت\&. نسخه Kea 1.0.0 در دسامبر ۲۰۱۵ منتشر شد.
.SS همچنین ببینید (SEE ALSO)
.sp
\fBkea\-dhcp4(8)\fP, \fBkea\-dhcp\-ddns(8)\fP,
\fBkea\-admin(8)\fP, \fBkeactrl(8)\fP,
\fBperfdhcp(8)\fP, \fBkea\-netconf(8)\fP, \fBkea\-lfc(8)\fP,
Kea Administrator Reference Manual.
.SS \fBkeactrl\fP \- اسکریپت شل برای مدیریت Kea
.SS خلاصه دستور (SYNOPSIS)
.sp
\fBkeactrl\fP [\fBcommand\fP] [\fB\-c\fP keactrl\-config\-file] [\fB\-s\fP server[,server,...]] [\fB\-v\fP]
.SS توضیحات (DESCRIPTION)
.sp
ابزار \fBkeactrl\fP یک اسکریپت شل است که راه‌اندازی، متوقف‌سازی و
پیکربندی مجدد سرورهای Kea (\fBkea\-dhcp4\fP، \fBkea\-dhcp6\fP،
\fBkea\-dhcp\-ddns\fP و \fBkea\-netconf\fP) را کنترل می‌کند. این ابزار
همچنین روشی را برای بررسی وضعیت کنونی سرورها و
تعیین فایل‌های پیکربندیِ در حال استفاده فراهم می‌آورد.
.SS فایل پیکربندی (CONFIGURATION FILE)
.sp
بسته به نیازمندی‌های کاربر، نیازی به اجرای تمامی سرورهای موجود نیست.
فایل پیکربندی \fBkeactrl\fP مشخص می‌کند کدام سرورها فعال و کدام
غیرفعال هستند. به‌طور پیش‌فرض، فایل پیکربندی عبارت است از:
\fB\(dq[kea\-install\-dir]/etc/kea/keactrl.conf\(dq\fP\&.
.sp
برای مستندات مربوط به پارامترهای موجود در فایل پیکربندی \fBkeactrl\fP،
به Kea Administrator Reference Manual مراجعه کنید..SS "گزینه‌ها (OPTIONS)"
.INDENT 0.0
.TP
.B \fBcommand\fP
دستوری که باید برای کارسازها ارسال شود را مشخص می‌کند. می‌تواند یکی از موارد زیر باشد:
.INDENT 7.0
.TP
.B \fBstart\fP
کارسازها را راه‌اندازی می‌کند.
.TP
.B \fBstop\fP
کارسازها را متوقف می‌کند.
.TP
.B \fBreload\fP
به کارسازها دستور می‌دهد که فایل پیکربندی Kea را دوباره بخوانند. این
دستور توسط عامل NETCONF پشتیبانی نمی‌شود.
.TP
.B \fBstatus\fP
وضعیت کارسازها را چاپ می‌کند.
.UNINDENT
.TP
.B \fB\-c|\-\-ctrl\-config keactrl\-config\-file\fP
فایل پیکربندی \fBkeactrl\fP را مشخص می‌کند. بدون این سوئیچ،
\fBkeactrl\fP از فایل
\fB\(dq[kea\-install\-dir]/etc/kea/keactrl.conf\(dq\fP\& استفاده می‌کند.
.TP
.B \fB\-s|\-\-server server[,server,...]\fP
زیرمجموعه‌ای از کارسازهای فعال را که دستور باید برای آن‌ها صادر
شود مشخص می‌کند. فهرست کارسازها باید با کاما و بدون فاصله
جدا شود. مقادیر قابل قبول عبارتند از:
.INDENT 7.0
.TP
.B \fBdhcp4\fP
کارساز DHCPv4 (\fBkea\-dhcp4\fP).
.TP
.B \fBdhcp6\fP
کارساز DHCPv6 (\fBkea\-dhcp6\fP).
.TP
.B \fBdhcp_ddns\fP
کارساز DHCP DDNS (\fBkea\-dhcp\-ddns\fP).
.TP
.B \fBnetconf\fP
عامل NETCONF (\fBkea\-netconf\fP).
.TP
.B \fBall\fP
تمام کارسازها، از جمله NETCONF در صورتی که برای ساخت پیکربندی
شده باشد. این مقدار پیش‌فرض است.
.UNINDENT
.TP
.B \fB\-v|\-\-version\fP
نسخه Kea را نمایش می‌دهد.
.TP
.B \fB\-V\fP
نسخه تفصیلی Kea را نمایش می‌دهد.
.UNINDENT
.SS "مستندات (DOCUMENTATION)"
.sp
نرم‌افزار Kea همراه با یک راهنمای جامع مرجع مدیر سیستم Kea (Kea Administrator Reference Manual) ارائه می‌شود که
تمام جنبه‌های اجرای نرم‌افزار Kea \- کامپایل، نصب،
پیکربندی، مثال‌های پیکربندی و موارد بسیار دیگر \- را پوشش می‌دهد. همچنین Kea دارای یک
راهنمای پیام‌های Kea (Kea Messages Manual) است که تمامی پیام‌های احتمالی که Kea می‌تواند چاپ کند
را با شرح کوتاهی برای هر یک فهرست می‌کند. هر دو سند
در قالب‌های گوناگون (.txt ،.html ،.pdf) همراه با توزیع Kea
در دسترس هستند. مستندات Kea در
\%<https://\:kea\:.readthedocs\:.io>\& در دسترس است.
.sp
کد منبع Kea در راهنمای توسعه‌دهندگان Kea (Kea Developer\(aqs Guide) مستندسازی شده است،
که در \%<https://\:reports\:.kea\:.isc\:.org/\:dev_guide>\& در دسترس است.
.sp
وبگاه پروژه Kea در \%<https://\:kea\:.isc\:.org>\& در دسترس است.
.SS "فهرست‌های پستی و پشتیبانی (MAILING LISTS AND SUPPORT)"
.sp
دو فهرست پستی عمومی برای پروژه Kea در دسترس است. \fBkea\-users\fP
(kea\-users در lists.isc.org) برای کاربران Kea در نظر گرفته شده است، در حالی که \fBkea\-dev\fP
(kea\-dev در lists.isc.org) برای توسعه‌دهندگان Kea، مشارکت‌کنندگان بالقوه
و دیگر کاربران پیشرفته در نظر گرفته شده است. هر دو فهرست در
\%<https://\:lists\:.isc\:.org>\& در دسترس هستند. جامعه کاربری بیشترین
تلاش خود را برای پشتیبانی روی هر دوی این فهرست‌ها ارائه می‌دهد.
.sp
سازمان ISC پشتیبانی حرفه‌ای برای خدمات Kea ارائه می‌دهد. برای جزئیات به
\%<https://\:www\:.isc\:.org/\:kea> مراجعه کنید.
.SS "همچنین ببینید (SEE ALSO)"
.sp
\fBkea\-dhcp4(8)\fP, \fBkea\-dhcp6(8)\fP, \fBkea\-dhcp\-ddns(8)\fP,
\fBkea\-admin(8)\fP, \fBkea\-netconf(8)\fP,
\fBperfdhcp(8)\fP, \fBkea\-lfc(8)\fP, Kea Administrator Reference Manual.
.SS "\fBkea\-admin\fP \- اسکریپت شل برای مدیریت پایگاه‌های داده Kea"
.SS "خلاصه دستور (SYNOPSIS)"
.sp
\fBkea\-admin\fP [command] [backend] [\fB\-h\fP database_host]
[\fB\-P\fP database_port] [\fB\-u\fP database_username]
[\fB\-p\fP [database_password]] [\fB\-n\fP database_name] [\fB\-d\fP script_directory]
[\fB\-v\fP] [\fB\-x\fP extra_argument [\fB\-x\fP extra_argument ...]]
[\fB\-4\fP | \fB\-6\fP] [\fB\-i\fP input_file] [\fB\-o\fP output_file] [\fB\-y\fP]
.SS "توضیحات (DESCRIPTION)"
.sp
دستور \fBkea\-admin\fP یک اسکریپت شل است که امکانات نگهداری پایگاه داده را ارائه می‌دهد.
به طور ویژه، قابلیت‌های مقداردهی اولیه پایگاه داده، بررسی نسخه پایگاه داده،
و ارتقای طرحواره پایگاه داده را فراهم می‌کند.
.SS "آرگومان‌ها (ARGUMENTS)"
.INDENT 0.0
.TP
.B \fBcommand\fP
دستوری که باید برای کارسازها ارسال شود را مشخص می‌کند. می‌تواند یکی از
موارد زیر باشد:
.INDENT 7.0
.TP
.B \fBdb\-init\fP
یک طرحواره جدید برای پایگاه داده مقداردهی اولیه می‌کند. این ویژگی هنگام نصب
جدید Kea مفید است. پایگاه داده به جدیدترین نسخه‌ای که توسط نسخه نرم‌افزار
در حال نصب پشتیبانی می‌شود، مقداردهی اولیه می‌گردد.
.TP
.B \fBdb\-version\fP
شماره نسخه بک‌اند پایگاه داده را گزارش می‌دهد. این شماره لزوماً با
شماره نسخه Kea برابر نیست، زیرا هر بک‌اند طرح نسخه‌گذاری
مخصوص به خود را دارد.
.TP
.B \fBdb\-upgrade\fP
ارتقای طرحواره پایگاه داده را انجام می‌دهد. این ویژگی هنگام ارتقای Kea مفید است.
.TP
.B \fBlease\-dump\fP
محتوای پایگاه داده اجاره‌ها (برای بک‌اندهای MySQL یا
PostgreSQL) را در یک فایل متنی CSV (مقادیر جداشده با کاما) تخلیه (dump) می‌کند. (پشتیبانی
از بک‌اند Cassandra منسوخ شده است.)
خط نخست فایل شامل نام ستون‌ها است. این کار می‌تواند به عنوان روشی برای
تغییر بک‌اند پایگاه داده به بک‌اند memfile به کار رود.
همچنین می‌تواند به عنوان یک ابزار عیب‌یابی استفاده شود، زیرا قالبی قابل حمل
از داده‌های اجاره را ارائه می‌دهد. آرگومان‌های اجباری دیگری نیز وجود دارند که باید
همراه با این دستور استفاده شوند: یا \fB\-4\fP یا \fB\-6\fP باید
مشخص شود، و یا \fB\-o\fP یا \fB\-\-output\fP باید ارائه گردد.
.TP
.B \fBlease\-upload\fP
اجاره‌ها را از یک فایل متنی CSV (مقادیر جداشده با کاما) درون پایگاه داده اجاره
MySQL یا PostgreSQL بارگذاری می‌کند. فایل CSV باید در قالب memfile باشد.
آرگومان‌های اجباری دیگری نیز وجود دارند که باید همراه با این
دستور استفاده شوند: یا \fB\-4\fP یا \fB\-6\fP باید مشخص شود،
و یا \fB\-i\fP یا \fB\-\-input\fP باید ارائه گردد.
.TP
.B \fBstats\-recount\fP
آمار اجاره‌ها را برای یک پایگاه داده MySQL یا PostgreSQL بازشماری می‌کند.
.UNINDENT
.TP
.B \fBbackend\fP
نوع بک‌اند را مشخص می‌کند. بک‌اندهای مجاز در حال حاضر عبارتند از: memfile،
mysql و pgsql؛ گزینه cql منسوخ شده است.
.TP
.B \fB\-h|\-\-host hostname\fP
نام میزبان را هنگام اتصال به پایگاه داده مشخص می‌کند.
مقدار پیش‌فرض \fBlocalhost\fP است.
.TP
.B \fB\-i|\-\-input input_file\fP
فایل متنی CSV (مقادیر جداشده با کاما) حاوی اجاره‌های مورد نظر برای بارگذاری را مشخص می‌کند؛
برای \fBlease\-upload\fP الزامی است.
.TP
.B \fB\-P|\-\-port port\fP
درگاه را هنگام اتصال به پایگاه داده مشخص می‌کند. در صورت عدم تعیین،
مقدار پیش‌فرضی که توسط کلاینت پایگاه داده انتخاب می‌شود استفاده خواهد شد.
.TP
.B \fB\-u|\-\-user username\fP
نام کاربری را هنگام اتصال به پایگاه داده مشخص می‌کند.
مقدار پیش‌فرض \fBkeatest\fP است.
.TP
.B \fB\-p|\-\-password password\fP
گذرواژه را هنگام اتصال به پایگاه داده مشخص می‌کند.
اگر تنها \fB\-p\fP یا \fB\-\-password\fP داده شود، گذرواژه از کاربر پرسیده می‌شود.
اگر اصلاً مشخص نشود، متغیر محیطی \fBKEA_ADMIN_DB_PASSWORD\fP
بررسی شده و در صورت وجود استفاده می‌شود.
در غیر این صورت از مقدار پیش‌فرض \fB1234\fP استفاده می‌گردد.
.TP
.B \fB\-n|\-\-name database\-name\fP
نام پایگاه داده جهت اتصال را مشخص می‌کند.
مقدار پیش‌فرض \fBkeatest\fP است.
.TP
.B \fB\-d|\-\-directory script\-directory\fP
دایرکتوری اسکریپت‌های جایگزین را مشخص می‌کند. این اسکریپت در طول
ارتقاها، مقداردهی اولیه پایگاه داده و احتمالاً سایر عملیات استفاده می‌شود.
مقدار پیش‌فرض \fB(prefix)/share/kea/scripts/\fP است.
.TP
.B \fB\-o|\-\-output output_file\fP
فایلی را که داده‌های اجاره در آن تخلیه خواهد شد، مشخص می‌کند. برای
\fBlease\-dump\fP الزامی است.
.TP
.B \fB\-v|\-\-version\fP
نسخه Kea را نمایش می‌دهد.
.TP
.B \fB\-V\fP
نسخه تفصیلی Kea را نمایش می‌دهد.
.TP
.B \fB\-4\fP
به \fBkea\-admin\fP دستور می‌دهد تا اجاره‌های DHCPv4 را تخلیه کند (lease\-dump). با
گزینه \-6 ناسازگار است.
.TP
.B \fB\-6\fP
به \fBkea\-admin\fP دستور می‌دهد تا اجاره‌های DHCPv6 را تخلیه کند (lease\-dump). با
گزینه \-4 ناسازگار است.
.TP
.B \fB\-x|\-\-extra\fP
یک آرگومان اضافی را برای ارسال به ابزار دستور پایگاه داده مشخص می‌کند؛ به عنوان مثال
برای فراخوانی \fBmysql\fP با آرگومان \fB\-\-ssl\fP. این گزینه می‌تواند تکرار شود
تا بیش از یک آرگومان ارسال گردد. نقل‌قول‌ها حفظ نمی‌شوند. از دستورات
حاوی فاصله خودداری کنید..TP
.B \fB\-y|\-\-yes\fP
هنگام بازنویسی فایل‌های موقت، پاسخ مثبت (yes) را فرض می‌کند.
.UNINDENT
.SS "مستندات (DOCUMENTATION)"
.sp
نرم‌افزار Kea همراه با یک «راهنمای مرجع مدیر سیستم Kea» (Kea Administrator Reference Manual) جامع ارائه می‌شود که تمام جنبه‌های اجرای نرم‌افزار Kea از جمله کامپایل، نصب، پیکربندی، مثال‌های پیکربندی و بسیاری موارد دیگر را پوشش می‌دهد. همچنین Kea شامل یک «راهنمای پیام‌های Kea» (Kea Messages Manual) است که تمام پیام‌های احتمالی قابل چاپ توسط Kea را به همراه شرحی مختصر از هر یک فهرست می‌کند. هر دو سند در قالب‌های مختلف (.txt، .html، .pdf) به همراه توزیع Kea در دسترس هستند. مستندات Kea در نشانی زیر در دسترس است:
\%<https://\:kea\:.readthedocs\:.io>\&.
.sp
کد منبع Kea در «راهنمای توسعه‌دهنده Kea» (Kea Developer\(aqs Guide) مستندسازی شده است که در نشانی زیر قابل مشاهده است:
\%<https://\:reports\:.kea\:.isc\:.org/\:dev_guide>\&.
.sp
وب‌سایت پروژه Kea در نشانی زیر در دسترس است:
\%<https://\:kea\:.isc\:.org>\&.
.SS "فهرست‌های پستی و پشتیبانی (Mailing Lists and Support)"
.sp
دو فهرست پستی عمومی برای پروژه Kea در دسترس است. فهرست پستی \fBkea\-users\fP (kea\-users در lists.isc.org) برای کاربران Kea در نظر گرفته شده است، در حالی که \fBkea\-dev\fP (kea\-dev در lists.isc.org) برای توسعه‌دهندگان Kea، مشارکت‌کنندگان بالقوه و دیگر کاربران پیشرفته در نظر گرفته شده است. هر دو فهرست در \%<https://\:lists\:.isc\:.org>\& در دسترس هستند. جامعه کاربری بیشترین تلاش خود را برای ارائه پشتیبانی در هر دو فهرست به کار می‌گیرد.
.sp
مجموعه ISC پشتیبانی تجاری و حرفه‌ای برای سرویس‌های Kea ارائه می‌کند. برای جزئیات به \%<https://\:www\:.isc\:.org/\:kea> مراجعه کنید.
.SS "همچنین ببینید (SEE ALSO)"
.sp
\fBkea\-dhcp4(8)\fP, \fBkea\-dhcp6(8)\fP,
\fBkea\-dhcp\-ddns(8)\fP,
\fBkeactrl(8)\fP, \fBperfdhcp(8)\fP, \fBkea\-netconf(8)\fP,
Kea Administrator Reference Manual.
.SS "\fBkea\-dhcp\-ddns\fP \- فرآیند DHCP\-DDNS در Kea"
.SS "خلاصه دستور (SYNOPSIS)"
.sp
\fBkea\-dhcp\-ddns\fP [\fB\-v\fP] [\fB\-V\fP] [\fB\-W\fP] [\fB\-d\fP] [\fB\-c\fP config\-file] [\fB\-t\fP config\-file]
.SS "توضیحات (DESCRIPTION)"
.sp
فرآیند سرویس \fBkea\-dhcp\-ddns\fP بر اساس رویدادهای تغییر اجاره (lease) در DHCP، درخواست به‌روزرسانی نگاشت DNS را ارسال می‌کند. این فرآیند به عنوان یک پردازهٔ مجزا اجرا می‌شود که انتظار دارد درخواست‌های تغییر نام (Name Change Requests) را از سرورهای Kea DHCP دریافت کند.
.SS "آرگومان‌ها (ARGUMENTS)"
.sp
آرگومان‌ها به شرح زیر هستند:
.INDENT 0.0
.TP
.B \fB\-v\fP
نسخه Kea را نمایش می‌دهد.
.TP
.B \fB\-V\fP
نسخه گسترده Kea را نمایش می‌دهد.
.TP
.B \fB\-W\fP
گزارش پیکربندی را نمایش می‌دهد.
.TP
.B \fB\-d\fP
سطح ثبت گزارش (logging) را روی اشکال‌زدایی (debug) با جزئیات بیشتر تنظیم می‌کند. این گزینه اساساً برای مقاصد توسعه در حالت مستقل (stand\-alone) کاربرد دارد.
.TP
.B \fB\-c config\-file\fP
فایل پیکربندی حاوی تنظیمات سرور DHCP\-DDNS را مشخص می‌کند. این فایل ممکن است شامل ورودی‌های پیکربندی برای دیگر سرویس‌های Kea نیز باشد.
.TP
.B \fB\-t config\-file\fP
نحو (syntax) فایل پیکربندی را بررسی کرده و در صورت وجود، نخستین خطا را گزارش می‌دهد. توجه داشته باشید که همه پارامترها به‌طور کامل بررسی نمی‌شوند؛ به‌ویژه هیچ سوکت سرویسی باز نمی‌شود.
.UNINDENT
.SS "مستندات (DOCUMENTATION)"
.sp
نرم‌افزار Kea همراه با یک «راهنمای مرجع مدیر سیستم Kea» (Kea Administrator Reference Manual) جامع ارائه می‌شود که تمام جنبه‌های اجرای نرم‌افزار Kea از جمله کامپایل، نصب، پیکربندی، مثال‌های پیکربندی و بسیاری موارد دیگر را پوشش می‌دهد. همچنین Kea شامل یک «راهنمای پیام‌های Kea» (Kea Messages Manual) است که تمام پیام‌های احتمالی قابل چاپ توسط Kea را به همراه شرحی مختصر از هر یک فهرست می‌کند. هر دو سند در قالب‌های مختلف (.txt، .html، .pdf) به همراه توزیع Kea در دسترس هستند. مستندات Kea در نشانی زیر در دسترس است:
\%<https://\:kea\:.readthedocs\:.io>\&.
.sp
کد منبع Kea در «راهنمای توسعه‌دهنده Kea» (Kea Developer\(aqs Guide) مستندسازی شده است که در نشانی زیر قابل مشاهده است:
\%<https://\:reports\:.kea\:.isc\:.org/\:dev_guide>\&.
.sp
وب‌سایت پروژه Kea در نشانی زیر در دسترس است:
\%<https://\:kea\:.isc\:.org>\&.
.SS "فهرست‌های پستی و پشتیبانی (Mailing Lists and Support)"
.sp
دو فهرست پستی عمومی برای پروژه Kea در دسترس است. فهرست پستی \fBkea\-users\fP (kea\-users در lists.isc.org) برای کاربران Kea در نظر گرفته شده است، در حالی که \fBkea\-dev\fP (kea\-dev در lists.isc.org) برای توسعه‌دهندگان Kea، مشارکت‌کنندگان بالقوه و دیگر کاربران پیشرفته در نظر گرفته شده است. هر دو فهرست در \%<https://\:lists\:.isc\:.org>\& در دسترس هستند. جامعه کاربری بیشترین تلاش خود را برای ارائه پشتیبانی در هر دو فهرست به کار می‌گیرد.
.sp
مجموعه ISC پشتیبانی تجاری و حرفه‌ای برای سرویس‌های Kea ارائه می‌کند. برای جزئیات به \%<https://\:www\:.isc\:.org/\:kea> مراجعه کنید.
.SS "تاریخچه (HISTORY)"
.sp
فرآیند \fBb10\-dhcp\-ddns\fP نخستین بار در مه ۲۰۱۳ توسط Thomas Markwalder برنامه‌نویسی شد.
.sp
پروژه Kea به یک سرور مستقل تبدیل شد و چارچوب BIND 10 حذف گردید. باینری سرور DHCP\-DDNS در ژوئیه ۲۰۱۴ به kea\-dhcp\-ddns تغییر نام یافت. نسخه Kea 1.0.0 در دسامبر ۲۰۱۵ منتشر شد.
.SS "همچنین ببینید (SEE ALSO)"
.sp
\fBkea\-dhcp4(8)\fP, \fBkea\-dhcp6(8)\fP,
\fBkea\-admin(8)\fP, \fBkeactrl(8)\fP,
\fBperfdhcp(8)\fP, \fBkea\-netconf(8)\fP, \fBkea\-lfc(8)\fP,
Kea Administrator Reference Manual.
.SS "\fBkea\-lfc\fP \- فرآیند پاک‌سازی فایل اجاره در Kea"
.SS "خلاصه دستور (SYNOPSIS)"
.sp
\fBkea\-lfc\fP [\fB\-4**|\fP\-6**] [\fB\-c\fP config\-file] [\fB\-p\fP pid\-file] [\fB\-x\fP previous\-file] [\fB\-i\fP copy\-file] [\fB\-o\fP output\-file] [\fB\-f\fP finish\-file] [\fB\-v\fP] [\fB\-V\fP] [\fB\-W\fP] [\fB\-d\fP] [\fB\-h\fP]
.SS "توضیحات (DESCRIPTION)"
.sp
فرآیند سرویس \fBkea\-lfc\fP اطلاعات زائد و تکراری را از فایل‌هایی که برای ذخیره‌سازی پایدار در بخش پشتی (backend) پایگاه‌داده memfile استفاده می‌شوند، حذف می‌کند. این سرویس به گونه‌ای نوشته شده است که به عنوان یک پردازه مستقل اجرا شود. اگرچه می‌توان آن را به صورت دستی و از خارج اجرا کرد، اما معمولاً نیازی به این کار نیست؛ این پردازه به صورت دوره‌ای توسط سرورهای Kea DHCP اجرا می‌شود..SS آرگومان‌ها
.sp
آرگومان‌ها به شرح زیر هستند:
.INDENT 0.0
.TP
.B \fB\-4 | \-6\fP
نسخه پروتکل فایل‌های اجاره (lease) را مشخص می‌کند؛ باید ۴ یا ۶ باشد.
.TP
.B \fB\-c config\-file\fP
فایل حاوی پیکربندی فرایند \fBkea\-lfc\fP را مشخص می‌کند. این فایل همچنین ممکن است حاوی مدخل‌های پیکربندی برای دیگر سرویس‌های Kea باشد. در حال حاضر \fBkea\-lfc\fP تمام آرگومان‌های خود را از خط فرمان دریافت می‌کند.
.TP
.B \fB\-p pid\-file\fP
فایل PID را مشخص می‌کند. هنگامی که فرایند \fBkea\-lfc\fP آغاز می‌شود، با بررسی فایل PID تلاش می‌کند مشخص کند که آیا نمونه دیگری از این فرایند در حال اجرا است یا خیر. اگر نمونه‌ای در حال اجرا باشد، فرایند جدید متوقف می‌شود. اگر نمونه‌ای در حال اجرا نباشد، Kea شناسه PID خود را درون فایل PID می‌نویسد.
.TP
.B \fB\-x previous\-file\fP
فایل اجاره قبلی یا پیشین را مشخص می‌کند. هنگامی که \fBkea\-lfc\fP آغاز می‌شود، این فایل نتیجه هر اجرای قبلی \fBkea\-lfc\fP است؛ هنگامی که \fBkea\-lfc\fP به پایان می‌رسد، نتیجه اجرای فعلی خواهد بود. اگر اجرای \fBkea\-lfc\fP پیش از تکمیل قطع شود، این فایل ممکن است وجود نداشته باشد.
.TP
.B \fB\-i copy\-file\fP
فایل ورودی یا رونوشت فایل اجاره را مشخص می‌کند. پیش از آنکه سرور DHCP فرایند \fBkea\-lfc\fP را فراخوانی کند، فایل اجاره فعلی را به اینجا منتقل کرده و سپس \fBkea\-lfc\fP را با این فایل فراخوانی می‌کند.
.TP
.B \fB\-o output\-file\fP
فایل خروجی اجاره را مشخص می‌کند که فایل موقتی است که \fBkea\-lfc\fP باید برای نوشتن اجاره‌ها استفاده کند. پس از پایان نوشتن این فایل، به فایل پایان منتقل می‌شود (پایین را ببینید).
.TP
.B \fB\-f finish\-file\fP
فایل پایان یا تکمیل را مشخص می‌کند، فایل موقت دیگری که \fBkea\-lfc\fP برای ثبت سوابق استفاده می‌کند. هنگامی که \fBkea\-lfc\fP نوشتن فایل خروجی را به پایان رساند، آن را به این نام فایل منتقل می‌کند. پس از اینکه \fBkea\-lfc\fP حذف فایل‌های دیگر (قبلی و ورودی) را به پایان برد، این فایل را به فایل اجاره قبلی منتقل می‌کند. با انتقال فایل‌ها به این روش، فرایندهای \fBkea\-lfc\fP و سرور DHCP می‌توانند فایل صحیح را برای استفاده تعیین کنند، حتی اگر یکی از فرایندها پیش از تکمیل وظیفه خود متوقف شده باشد.
.TP
.B \fB\-v\fP
نسخه Kea را نمایش می‌دهد.
.TP
.B \fB\-V\fP
نسخه توسعه‌یافته Kea را نمایش می‌دهد.
.TP
.B \fB\-W\fP
گزارش پیکربندی را نمایش می‌دهد.
.TP
.B \fB\-d\fP
سطح ثبت گزارش (logging) را روی اشکال‌زدایی (debug) با پرگویی بیشتر تنظیم می‌کند. این گزینه اساساً برای مقاصد توسعه در حالت مستقل (stand\-alone) است.
.TP
.B \fB\-h\fP
باعث چاپ رشته راهنمای نحوه استفاده می‌شود.
.UNINDENT
.SS مستندات
.sp
نرم‌افزار Kea همراه با یک راهنمای مرجع جامع مدیر سیستم Kea (با عنوان Kea Administrator Reference Manual) ارائه می‌شود که تمام جنبه‌های اجرای نرم‌افزار Kea شامل کامپایل، نصب، پیکربندی، مثال‌های پیکربندی و موارد دیگر را پوشش می‌دهد. همچنین Kea دارای راهنمای پیام‌های Kea (با عنوان Kea Messages Manual) است که تمام پیام‌های ممکنی را که Kea می‌تواند چاپ کند، با شرح مختصری برای هر یک فهرست می‌کند. هر دو سند در قالب‌های مختلف (.txt، .html، .pdf) همراه با توزیع Kea در دسترس هستند. مستندات Kea در
\%<https://kea.readthedocs.io>\&
در دسترس است.
.sp
کد منبع Kea در راهنمای توسعه‌دهنده Kea (با عنوان Kea Developer\(aqs Guide) مستندسازی شده است که در
\%<https://reports.kea.isc.org/dev_guide>\&
در دسترس است.
.sp
وب‌سایت پروژه Kea در \%<https://kea.isc.org>\& در دسترس است.
.SS فهرست‌های پستی و پشتیبانی
.sp
دو فهرست پستی عمومی برای پروژه Kea در دسترس است. \fBkea\-users\fP
(kea\-users در lists.isc.org) برای کاربران Kea در نظر گرفته شده است، در حالی که \fBkea\-dev\fP
(kea\-dev در lists.isc.org) برای توسعه‌دهندگان Kea، مشارکت‌کنندگان احتمالی و سایر کاربران پیشرفته در نظر گرفته شده است. هر دو فهرست در
\%<https://lists.isc.org>\& در دسترس هستند. جامعه کاربری در هر دو فهرست پستی مذکور، پشتیبانی را به بهترین نحو ممکن (best\-effort) ارائه می‌دهد.
.sp
مجموعه ISC پشتیبانی حرفه‌ای برای سرویس‌های Kea ارائه می‌دهد. برای جزئیات به
\%<https://www.isc.org/kea> مراجعه کنید.
.SS تاریخچه
.sp
فرایند \fBkea\-lfc\fP نخستین بار در ژانویه ۲۰۱۵ توسط تیم Kea/DHCP در ISC کدنویسی شد.
.SS "همچنین ببینید (SEE ALSO)"
.sp
\fBkea\-dhcp4(8)\fP، \fBkea\-dhcp6(8)\fP، \fBkea\-dhcp\-ddns(8)\fP،
\fBkea\-admin(8)\fP، \fBkeactrl(8)\fP،
\fBperfdhcp(8)\fP، \fBkea\-netconf(8)\fP، راهنمای مرجع مدیر سیستم Kea.
.SS \fBkea\-shell\fP \- کلاینت متنی برای سرورهای kea\-dhcp4، kea\-dhcp6 و kea\-dhcp\-ddns
.SS "خلاصه دستور (SYNOPSIS)"
.sp
\fBkea\-shell\fP [\fB\-h\fP] [\fB\-v\fP] [\fB\-\-host\fP] [\fB\-\-port\fP] [\fB\-\-path\fP] [\fB\-\-ca\fP] [\fB\-\-cert\fP] [\fB\-\-key\fP] [\fB\-\-auth\-user\fP] [\fB\-\-auth\-password\fP] [\fB\-\-auth\-password\-file\fP] [\fB\-\-timeout\fP] [\fB\-\-service\fP] [command]
.SS "توضیحات (DESCRIPTION)"
.sp
ابزار \fBkea\-shell\fP یک کلاینت REST برای سرورهای \fBkea\-dhcp4\fP،
\fBkea\-dhcp6\fP و \fBkea\-dhcp\-ddns\fP در Kea فراهم می‌کند. پیش‌تر این ابزار
برای دیمن Control Agent (CA) در نظر گرفته شده بود که اکنون منسوخ (حذف) شده است.
این ابزار دستورها را به عنوان یک پارامتر خط فرمان دریافت کرده و با کپسوله‌سازی مناسب JSON
به سرور Kea ارسال می‌کند. آرگومان‌های اختیاری ممکن است در ورودی استاندارد مشخص شوند.
درخواست از طریق HTTP ارسال شده و پاسخ دریافت و در خروجی استاندارد نمایش داده می‌شود.
احراز هویت پایه‌ای HTTP و HTTPS (یعنی انتقال با امنیت TLS) پشتیبانی می‌شوند.
.SS آرگومان‌ها
.sp
آرگومان‌ها به شرح زیر هستند:
.INDENT 0.0
.TP
.B \fB\-h\fP
راهنمای مربوط به پارامترهای خط فرمان را نمایش می‌دهد.
.TP
.B \fB\-v\fP
نسخه Kea را نمایش می‌دهد.
.TP
.B \fB\-\-host\fP
میزبانی را که باید به آن متصل شد مشخص می‌کند. سرور Kea باید روی میزبان مشخص‌شده در حال اجرا باشد. در صورت مشخص نشدن، از 127.0.0.1 استفاده می‌شود.
.TP
.B \fB\-\-port\fP
درگاه (پورت) TCP را برای اتصال مشخص می‌کند. سرور باید روی درگاه مشخص‌شده در حال شنود باشد. در صورت مشخص نشدن، از 8000 استفاده می‌شود.
.TP
.B \fB\-\-path\fP
مسیر موجود در URL را برای اتصال مشخص می‌کند. در صورت عدم تعیین، از مسیر خالی استفاده می‌شود. از آنجا که سرورهای Kea روی مسیر خالی شنود می‌کنند، این پارامتر تنها همراه با یک پراکسی معکوس (reverse proxy) مفید است.
.TP
.B \fB\-\-ca\fP
نام فایل یا دایرکتوری مرجع صدور گواهی (Certification Authority) را مشخص می‌کند. اگر مشخص نشود، از HTTPS استفاده نمی‌شود.
.TP
.B \fB\-\-cert\fP
نام فایل گواهی کلید عمومی موجودیت نهایی (end\-entity) کاربر را مشخص می‌کند. در صورت مشخص شدن، نام فایل کلید کاربر نیز باید مشخص شود.
.TP
.B \fB\-\-key\fP
نام فایل کلید کاربر را مشخص می‌کند. در صورت مشخص شدن، نام فایل گواهی کاربر نیز باید مشخص شود. فایل‌های کلید رمزگذاری‌شده پشتیبانی نمی‌شوند.
.TP
.B \fB\-\-auth\-user\fP
شناسه کاربری را برای احراز هویت پایه‌ای HTTP مشخص می‌کند. در صورت عدم تعیین، یا تعیین به صورت یک رشته خالی، از احراز هویت استفاده نمی‌شود.
.TP
.B \fB\-\-auth\-password\fP
گذرواژه را برای احراز هویت پایه‌ای HTTP مشخص می‌کند. اگر مشخص نشود اما شناسه کاربری مشخص شده باشد، از گذرواژه خالی استفاده می‌شود. اگر همراه با \fB\-\-auth\-password\-file\fP استفاده شود، نادیده گرفته می‌شود.
.TP
.B \fB\-\-auth\-password\-file\fP
یک فایل متنی را مشخص می‌کند که سطر اول آن حاوی گذرواژه مورد استفاده برای احراز هویت پایه‌ای HTTP است. این پرچم بر پرچم \fB\-\-auth\-password\fP اولویت دارد.
.TP
.B \fB\-\-timeout\fP
مهلت زمانی اتصال (timeout) را بر حسب ثانیه مشخص می‌کند. مقدار پیش‌فرض 10 است.
.TP
.B \fB\-\-service\fP
(منسوخ) سرورهای Kea شامل \fBkea\-dhcp4\fP، \fBkea\-dhcp6\fP و \fBkea\-dhcp\-ddns\fP این آرگومان را نادیده می‌گیرند. این گزینه برای ارتباط با دیمن منسوخ‌شده (حذف‌شده) Control Agent در نظر گرفته شده بود.
اگر با نسخه Kea قبل از 2.7.2 استفاده شود: سرویسی را که هدف یک دستور است مشخص می‌کند. اگر مشخص نشود، خود Control Agent هدف قرار می‌گیرد. ممکن است بیش از یک بار برای مشخص کردن چندین هدف استفاده شود.
.TP
.B \fBcommand\fP
دستوری را که باید به سرور ارسال شود مشخص می‌کند. در صورت مشخص نشدن، از \fBlist\-commands\fP استفاده می‌شود.
.UNINDENT.SS "مستندات (DOCUMENTATION)"
.sp
نرم‌افزار Kea همراه با «راهنمای مرجع مدیر سیستم Kea» (Kea Administrator Reference Manual) جامعی ارائه می‌شود که تمام جنبه‌های اجرای نرم‌افزار Kea \- کامپایل، نصب، پیکربندی، مثال‌های پیکربندی و بسیاری موارد دیگر \- را پوشش می‌دهد. Kea همچنین دارای یک «راهنمای پیام‌های Kea» (Kea Messages Manual) است که تمام پیام‌های ممکنی را که Kea می‌تواند چاپ کند با شرح مختصری برای هر یک فهرست می‌نماید. هر دو سند در قالب‌های مختلف (.txt، .html، .pdf) به همراه توزیع Kea در دسترس هستند. مستندات Kea در
\%<https://\:kea\:.readthedocs\:.io>\& در دسترس است.
.sp
کد منبع Kea در «راهنمای توسعه‌دهنده Kea» (Kea Developer\(aqs Guide) مستند شده است، که در \%<https://\:reports\:.kea\:.isc\:.org/\:dev_guide>\& در دسترس می‌باشد.
.sp
وبگاه پروژه Kea در \%<https://\:kea\:.isc\:.org>\& در دسترس است.
.SS "فهرست‌های پستی و پشتیبانی (MAILING LISTS AND SUPPORT)"
.sp
دو فهرست پستی عمومی برای پروژه Kea در دسترس است. \fBkea\-users\fP
(kea\-users در lists.isc.org) برای کاربران Kea در نظر گرفته شده است، در حالی که \fBkea\-dev\fP
(kea\-dev در lists.isc.org) برای توسعه‌دهندگان Kea، مشارکت‌کنندگان بالقوه و سایر کاربران پیشرفته در نظر گرفته شده است. هر دو فهرست در
\%<https://\:lists\:.isc\:.org>\& در دسترس هستند. جامعه کاربری در هر دوی این فهرست‌ها پشتیبانی در حد توان (best\-effort) ارائه می‌دهد.
.sp
سازمان ISC پشتیبانی حرفه‌ای برای خدمات Kea ارائه می‌دهد. برای جزئیات به
\%<https://\:www\:.isc\:.org/\:kea> مراجعه کنید.
.SS "تاریخچه (HISTORY)"
.sp
ابزار \fBkea\-shell\fP نخستین بار در مارس ۲۰۱۷ توسط Tomek Mrugalski نوشته شد.
.SS "همچنین ببینید (SEE ALSO)"
.sp
\fBkea\-dhcp4(8)\fP، \fBkea\-dhcp6(8)\fP، \fBkea\-dhcp\-ddns(8)\fP،
\fBkea\-admin(8)\fP، \fBkeactrl(8)\fP،
\fBperfdhcp(8)\fP، \fBkea\-lfc(8)\fP، راهنمای مرجع مدیر سیستم Kea (Kea Administrator Reference Manual).
.SS "\fBkea\-netconf\fP \- عامل NETCONF برای پیکربندی Kea"
.SS "خلاصه دستور (SYNOPSIS)"
.sp
\fBkea\-netconf\fP [\fB\-v\fP] [\fB\-V\fP] [\fB\-W\fP] [\fB\-d\fP] [\fB\-c\fP config\-file] [\fB\-t\fP config\-file]
.SS "توضیحات (DESCRIPTION)"
.sp
عامل \fBkea\-netconf\fP یک رابط YANG/NETCONF برای محیط Kea فراهم می‌کند.
.SS "آرگومان‌ها (ARGUMENTS)"
.sp
آرگومان‌ها به شرح زیر هستند:
.INDENT 0.0
.TP
.B \fB\-v\fP
نسخه Kea را نمایش می‌دهد.
.TP
.B \fB\-V\fP
نسخه گسترده Kea را نمایش می‌دهد.
.TP
.B \fB\-W\fP
گزارش پیکربندی را نمایش می‌دهد.
.TP
.B \fB\-d\fP
حالت اشکال‌زدایی (debug) را با پرگویی (verbosity) بیشتر فعال می‌کند.
.TP
.B \fB\-c config\-file\fP
فایل حاوی پیکربندی برای عامل NETCONF را مشخص می‌کند.
.TP
.B \fB\-t config\-file\fP
نحو (syntax) فایل پیکربندی را بررسی کرده و در صورت وجود، نخستین خطا را گزارش می‌کند. توجه داشته باشید که تمام پارامترها به‌طور کامل بررسی نمی‌شوند؛ به‌ویژه، سوکت‌های سرویس و کلاینت باز نمی‌شوند و کتابخانه‌های هوک (hook) بارگیری نمی‌گردند.
.UNINDENT
.SS "مستندات (DOCUMENTATION)"
.sp
نرم‌افزار Kea همراه با «راهنمای مرجع مدیر سیستم Kea» (Kea Administrator Reference Manual) جامعی ارائه می‌شود که تمام جنبه‌های اجرای نرم‌افزار Kea \- کامپایل، نصب، پیکربندی، مثال‌های پیکربندی و بسیاری موارد دیگر \- را پوشش می‌دهد. Kea همچنین دارای یک «راهنمای پیام‌های Kea» (Kea Messages Manual) است که تمام پیام‌های ممکنی را که Kea می‌تواند چاپ کند با شرح مختصری برای هر یک فهرست می‌نماید. هر دو سند در قالب‌های مختلف (.txt، .html، .pdf) به همراه توزیع Kea در دسترس هستند. مستندات Kea در
\%<https://\:kea\:.readthedocs\:.io>\& در دسترس است.
.sp
کد منبع Kea در «راهنمای توسعه‌دهنده Kea» (Kea Developer\(aqs Guide) مستند شده است، که در \%<https://\:reports\:.kea\:.isc\:.org/\:dev_guide>\& در دسترس می‌باشد.
.sp
وبگاه پروژه Kea در \%<https://\:kea\:.isc\:.org>\& در دسترس است.
.SS "فهرست‌های پستی و پشتیبانی (MAILING LISTS AND SUPPORT)"
.sp
دو فهرست پستی عمومی برای پروژه Kea در دسترس است. \fBkea\-users\fP
(kea\-users در lists.isc.org) برای کاربران Kea در نظر گرفته شده است، در حالی که \fBkea\-dev\fP
(kea\-dev در lists.isc.org) برای توسعه‌دهندگان Kea، مشارکت‌کنندگان بالقوه و سایر کاربران پیشرفته در نظر گرفته شده است. هر دو فهرست در
\%<https://\:lists\:.isc\:.org>\& در دسترس هستند. جامعه کاربری در هر دوی این فهرست‌ها پشتیبانی در حد توان (best\-effort) ارائه می‌دهد.
.sp
سازمان ISC پشتیبانی حرفه‌ای برای خدمات Kea ارائه می‌دهد. برای جزئیات به
\%<https://\:www\:.isc\:.org/\:kea> مراجعه کنید.
.SS "تاریخچه (HISTORY)"
.sp
نمونه‌های اولیه پیاده‌سازی \fBkea\-netconf\fP در طول هکاتون‌های IETF در برلین، لندن و مونترال نوشته شدند. پیاده‌سازی واقعی آماده برای محیط عملیاتی (production\-ready) در اوت ۲۰۱۸ توسط Tomek Mrugalski و Francis Dupont آغاز شد.
.SS "همچنین ببینید (SEE ALSO)"
.sp
\fBkea\-dhcp4(8)\fP، \fBkea\-dhcp6(8)\fP، \fBkea\-dhcp\-ddns(8)\fP،
\fBkea\-admin(8)\fP، \fBkeactrl(8)\fP،
\fBperfdhcp(8)\fP، \fBkea\-lfc(8)\fP، راهنمای مرجع مدیر سیستم Kea (Kea Administrator Reference Manual).
.SS "\fBperfdhcp\fP \- ابزار سنجش کارایی و بنچمارک DHCP"
.SS "خلاصه دستور (SYNOPSIS)"
.sp
\fBperfdhcp\fP [\fB\-1\fP] [\fB\-4\fP | \fB\-6\fP] [\fB\-A\fP encapsulation\-level] [\fB\-b\fP base] [\fB\-B\fP] [\fB\-c\fP] [\fB\-C\fP separator] [\fB\-d\fP drop\-time] [\fB\-D\fP max\-drop] [\-e lease\-type] [\fB\-E\fP time\-offset] [\fB\-f\fP renew\-rate] [\fB\-F\fP release\-rate] [\fB\-g\fP thread\-mode] [\fB\-h\fP] [\fB\-i\fP] [\fB\-I\fP ip\-offset] [\fB\-J\fP remote\-address\-list\-file] [\fB\-l\fP local\-address|interface] [\fB\-L\fP local\-port] [\fB\-M\fP mac\-list\-file] [\fB\-n\fP num\-request] [\fB\-N\fP remote\-port] [\fB\-O\fP random\-offset] [\fB\-o\fP code,hexstring] [\fB\-\-or\fP encapsulation\-level:code,hexstring] [\fB\-p\fP test\-period] [\fB\-P\fP preload] [\fB\-r\fP rate] [\fB\-R\fP num\-clients] [\fB\-s\fP seed] [\fB\-S\fP srvid\-offset] [\fB\-\-scenario\fP name] [\fB\-t\fP report] [\fB\-T\fP template\-file] [\fB\-u\fP] [\fB\-v\fP] [\fB\-W\fP exit\-wait\-time] [\fB\-w\fP script_name] [\fB\-x\fP diagnostic\-selector] [\fB\-X\fP xid\-offset] [server]
.SS "توضیحات (DESCRIPTION)"
.sp
ابزار \fBperfdhcp\fP یک ابزار محک‌زنی و ارزیابی کارایی (benchmarking) برای DHCP است. این ابزار با ایجاد حجم بالایی از ترافیک از چندین کلاینت شبیه‌سازی‌شده، روشی برای اندازه‌گیری کارایی سرورهای DHCP فراهم می‌کند. این ابزار قادر است هر دو سرور IPv4 و IPv6 را آزمایش کند و آمارهایی در رابطه با زمان‌های پاسخ‌دهی و تعداد درخواست‌های رهاشده (dropped) ارائه دهد.
.sp
این ابزار از دو سناریوی مختلف پشتیبانی می‌کند که امکان آزمایش رفتارهای خاصی را فراهم می‌سازند. به‌طور پیش‌فرض (سناریوی پایه یا basic)، آزمون‌ها با استفاده از توالی کامل تبادل چهار بسته‌ای (DORA برای DHCPv4 و SARR برای DHCPv6) اجرا می‌شوند. گزینه‌ای نیز برای اجرای آزمون‌ها با استفاده از تبادل دو بسته‌ای اولیه (DO و SA) به‌جای آن ارائه شده است. همچنین امکان پیکربندی \fBperfdhcp\fP برای ارسال پیام‌های RENEW و RELEASE مربوط به DHCPv6 با نرخ مشخص، به موازات تبادلات چهارطرفه DHCPv6 وجود دارد. به‌طور پیش‌فرض، اگر در مدت یک ثانیه پاسخی دریافت نشود، پاسخ به عنوان گم‌شده تلقی شده و \fBperfdhcp\fP با سایر تراکنش‌ها ادامه می‌دهد.
.sp
سناریوی دوم به نام avalanche (بهمن)، از طریق \fB\-\-scenario avalanche\fP\& انتخاب می‌شود. این سناریو ابتدا تعداد پیام‌های Discovery یا Solicit مشخص‌شده توسط گزینه \fB\-R\fP را ارسال می‌کند؛ سپس برای هر کلاینت شبیه‌سازی‌شده تا زمانی که به همه درخواست‌ها پاسخ داده شود، ارسال مجدد (با سازوکار عقب‌نشینی نمایی یا exponential back\-off) انجام می‌شود. هنگامی که همه کلاینت‌ها نشانی‌های خود را دریافت کنند، یا زمانی که آزمون به‌صورت دستی متوقف شود، گزارشی تولید می‌کند. این سناریو تلاش می‌کند حالتی را بازسازی کند که در آن سرور قادر نیست ترافیک را به‌اندازه کافی سریع مدیریت کند. کلاینت‌های واقعی فرض خواهند کرد بسته یا پاسخ گم شده است و مجدداً ارسال می‌کنند، که این امر ترافیک DHCP را باز هم افزایش می‌دهد. این پدیده گاهی اثر بهمنی (avalanche effect) نامیده می‌شود، از این رو نام سناریو از آن گرفته شده است. گزینه \fB\-p\fP در سناریوی avalanche نادیده گرفته می‌شود.
.sp
هنگام اجرای یک آزمون کارایی، \fBperfdhcp\fP بسته‌ها را با بیشترین سرعت ممکن با سرور تحت آزمون مبادله می‌کند، مگر اینکه از پارامتر \fB\-r\fP برای محدود کردن نرخ درخواست‌ها استفاده شود. مدت‌زمان آزمون را می‌توان با تعیین آستانه‌ای بر روی هر یک یا همه مواردی چون تعداد درخواست‌های ارسال‌شده توسط \fBperfdhcp\fP، زمان سپری‌شده، یا تعداد درخواست‌های رهاشده توسط سرور محدود کرد..SS "الگوها (Templates)"
.sp
برای فراهم کردن امکان سفارشی‌سازی محتوای بسته‌های ارسالی به سرور،
\fBperfdhcp\fP امکان تعیین فایل‌های الگو را می‌دهد که محتوای بسته‌ها
را مشخص می‌کنند. برای نمونه، بسته سفارشی‌شده ممکن است شامل یک
DHCPv6 ORO برای درخواست مجموعه‌ای از گزینه‌ها جهت بازگردانی توسط
سرور باشد، یا ممکن است شامل گزینه Client FQDN باشد تا از سرور درخواست
انجام به‌روزرسانی‌های DNS را نماید. از این قابلیت می‌توان برای یافتن
گلوگاه‌های کارایی در پیکربندی‌های گوناگون سرور بهره برد (مانند DDNS فعال یا
غیرفعال).
.sp
حداکثر دو فایل الگو را می‌توان در خط فرمان مشخص کرد که هر فایل
نشان‌دهنده محتوای نوع خاصی از بسته است، و این نوع بر اساس آزمونی که
در حال اجراست تعیین می‌شود. به عنوان مثال، هنگام آزمایش DHCPv6:
.INDENT 0.0
.IP \(bu 2
اگر هیچ فایل الگویی در خط فرمان مشخص نشود، \fBperfdhcp\fP
هر دو بسته Solicit و Request را تولید می‌کند.
.IP \(bu 2
اگر یک فایل الگو مشخص شود، آن فایل به عنوان الگوی بسته‌های
Solicit استفاده می‌شود: \fBperfdhcp\fP بسته‌های Request را
تولید می‌کند.
.IP \(bu 2
اگر دو فایل الگو در خط فرمان داده شود، فایل نخست به عنوان الگو
برای بسته‌های Solicit و فایل دوم به عنوان الگو برای بسته‌های
Request استفاده می‌شود.
.UNINDENT
.sp
(تصمیم‌گیری مشابهی برای بسته‌های DHCPDISCOVER و DHCPREQUEST در DHCPv4
اعمال می‌شود.)
.sp
فایل الگو بسته DHCP را نگه می‌دارد که به عنوان جریانی از ارقام هگزادسیمال
ASCII نمایش داده شده است؛ این فایل شامل هیچ‌یک از هدرهای پشته IP/UDP
نمی‌شود. فایل الگو نباید هیچ نویسه‌ای جز ارقام هگزادسیمال و فاصله‌ها
داشته باشد. فاصله‌ها هنگام تجزیه فایل الگو نادیده گرفته می‌شوند؛
درون فایل، \fB12B4\fP همانند \fB12 B4\fP و آن نیز همانند
\fB1 2 B 4\fP\& است.
.sp
فایل‌های الگو باید همراه با پارامترهای خط فرمان استفاده شوند که
آفست‌های فیلدهای داده‌ای را مشخص می‌کنند که در بسته‌های خروجی دستخوش
تغییر می‌شوند. به عنوان مثال، سوییچ \fB\-E time\-offset\fP آفست
گزینه DHCPv6 Elapsed Time را در الگوی بسته مشخص می‌کند.
اگر آفست مشخص شود، \fBperfdhcp\fP پیش از ارسال بسته به سرور، مقدار
کنونی elapsed\-time را در این فیلد تزریق می‌کند.
.sp
در بسیاری از سناریوها، \fBperfdhcp\fP نیاز دارد چندین کلاینت را شبیه‌سازی
کند که هر کدام شناسه کلاینت یکتایی دارند. از آنجا که بسته‌ها برای هر
کلاینت از همان فایل الگوی یکسان تولید می‌شوند، لازم است شناسه کلاینت
(یا آدرس سخت‌افزاری HW در DHCPv4) در بسته‌ای که از آن ایجاد می‌شود به صورت
تصادفی تغییر یابد. گزینه \fB\-O random\-offset\fP امکان تعیین آفست در
الگو را که تصادفی‌سازی باید در آنجا انجام گیرد فراهم می‌کند. مهم است که
توجه شود این آفست به انتهای (نه ابتدای) شناسه کلاینت (یا فیلد آدرس HW)
اشاره دارد. تعداد بایت‌هایی که تصادفی می‌شوند به تعداد کلاینت‌های
شبیه‌سازی‌شده بستگی دارد. اگر تعداد کلاینت‌های شبیه‌سازی‌شده بین ۱ تا ۲۵۵
باشد، تنها یک بایت (که آفست تصادفی‌سازی به آن اشاره دارد) تصادفی
می‌شود. اگر تعداد کلاینت‌های شبیه‌سازی‌شده بین ۲۵۶ تا ۶۵۵۳۵ باشد، دو
بایت تصادفی می‌شوند. توجه داشته باشید که در این حالت دو بایت پایانی
شناسه کلاینت تصادفی می‌شوند: بایتی که پارامتر آفست تصادفی‌سازی به آن
اشاره می‌کند و بایتی که پیش از آن قرار دارد (random\-offset \- 1). اگر
تعداد کلاینت‌های شبیه‌سازی‌شده از ۶۵۵۳۵ فراتر رود، سه بایت تصادفی
می‌شوند، و به همین ترتیب.
.sp
\fBperfdhcp\fP می‌تواند با فعال‌سازی گزینه \fB\-J\fP و ارسال مسیر فایلی
حاوی آدرس‌های v4 یا v6 برای استفاده به عنوان رله (relay) در پیام‌های
تولیدشده، ترافیک را از چندین زیرشبکه (subnet) شبیه‌سازی کند. این کار
امکان آزمایش تعداد بسیار زیادی از شبکه‌های اشتراکی (shared networks)
در Kea را فراهم می‌سازد. هنگام آزمایش DHCPv4، برنامه Kea باید با متغیر
محیطی \fBKEA_TEST_SEND_RESPONSES_TO_SOURCE\fP راه‌اندازی شود تا Kea
مجبور شود پیام‌های تولیدشده را به آدرس مبدا بسته ورودی ارسال کند.
.sp
الگوها در حال حاضر می‌توانند برای تولید بسته‌هایی استفاده شوند که در
تبادلات چهارمرحله‌ای به سرور فرستاده می‌شوند، یعنی Solicit و Request
(در DHCPv6) و DHCPDISCOVER و DHCPREQUEST (در DHCPv4). از آن‌ها
نمی‌توان هنگام ارسال بسته‌های Renew یا DHCPRELEASE استفاده کرد.
.SS "گزینه‌ها (Options)"
.INDENT 0.0
.TP
.B \fB\-1\fP
گزینه \fBserver\-id\fP را از نخستین پیام دریافتی برمی‌دارد.
.TP
.B \fB\-4\fP
عملکرد DHCPv4 را برقرار می‌سازد؛ این حالت پیش‌فرض است. با گزینه
\fB\-6\fP ناسازگار است.
.TP
.B \fB\-6\fP
عملکرد DHCPv6 را برقرار می‌سازد. با گزینه \fB\-4\fP ناسازگار است.
.TP
.B \fB\-b basetype=value\fP
آدرس MAC پایه یا DUID استفاده‌شده برای شبیه‌سازی کلاینت‌های گوناگون را
مشخص می‌کند. مقدار basetype می‌تواند \(dqmac\(dq یا \(dqduid\(dq باشد.
(همچنین می‌توان از کلیدواژه \(dqether\(dq به عنوان جایگزین MAC استفاده
کرد.) گزینه \fB\-b\fP می‌تواند چندین بار مشخص شود. آدرس MAC باید شامل
شش بایت (اکتت) باشد که با دونقطه تکی (:) یا دوتایی (::) جدا شده‌اند؛
به عنوان مثال: mac=00:0c:01:02:03:04. مقدار DUID یک رشته هگزادسیمال
است؛ طول آن باید حداقل شش بایت و نه بیشتر از ۶۴ بایت باشد، و طول آن باید
کمتر از ۱۲۸ رقم هگزادسیمال باشد. برای نمونه: duid=0101010101010101010110111F14.
.TP
.B \fB\-d drop\-time\fP
مدت زمانی را مشخص می‌کند که پس از آن یک درخواست به عنوان ازدست‌رفته
تلقی می‌شود. این مقدار بر حسب ثانیه داده می‌شود و می‌تواند شامل بخش
اعشاری باشد. مقدار پیش‌فرض 1 است.
.TP
.B \fB\-e lease\-type\fP
نوع اجاره (lease) درخواستی از سرور را مشخص می‌کند. می‌تواند یکی از
موارد زیر باشد:
.INDENT 7.0
.TP
.B \fBaddress\-only\fP
تنها آدرس‌های معمولی (v4 یا v6) درخواست می‌شوند.
.TP
.B \fBprefix\-only\fP
تنها پیشوندهای IPv6 درخواست می‌شوند.
.TP
.B \fBaddress\-and\-prefix\fP
هم آدرس‌ها و هم پیشوندهای IPv6 درخواست می‌شوند.
.UNINDENT
.sp
حالت‌های \fB\-e prefix\-only\fP و \fB\-e address\-and\-prefix\fP را
نمی‌توان با گزینه \fB\-4\fP استفاده کرد.
.TP
.B \fB\-F release\-rate\fP
نرخی را مشخص می‌کند که با آن، درخواست‌های DHCPv4 DHCPRELEASE یا
DHCPv6 Release به سرور فرستاده می‌شوند. این مقدار تنها زمانی معتبر است
که همراه با نرخ تبادل (ارائه‌شده با \fB\-r rate\fP) به کار رود. علاوه
بر این، مجموع این مقدار و renew\-rate (ارائه‌شده با \fB\-f rate\fP)
باید برابر یا کمتر از مقدار نرخ تبادل باشد.
.TP
.B \fB\-f renew\-rate\fP
نرخی را مشخص می‌کند که با آن، درخواست‌های DHCPv4 DHCPREQUEST یا
DHCPv6 Renew به سرور فرستاده می‌شوند. این مقدار تنها زمانی معتبر است
که همراه با نرخ تبادل (ارائه‌شده با \fB\-r rate\fP) به کار رود. علاوه
بر این، مجموع این مقدار و release\-rate (ارائه‌شده با \fB\-F rate\fP)
باید برابر یا کمتر از نرخ تبادل باشد.
.TP
.B \fB\-g thread\-mode\fP
امکان انتخاب thread\-mode را می‌دهد که می‌تواند \fBsingle\fP یا \fBmulti\fP\&
باشد. در حالت چندنخی (multi-thread)، بسته‌ها در یک رشته جداگانه دریافت
می‌شوند که بهره‌وری بهتری از پردازنده‌ها را ممکن می‌سازد. در یک سامانه با یک
پردازنده (single-CPU)، اجرای تک‌نخی بهتر است تا از مسدود کردن نخ‌ها توسط
یکدیگر جلوگیری شود. اگر بیش از یک پردازنده در سامانه موجود باشد، حالت
چندنخی پیش‌فرض است؛ در غیر این صورت، تک‌نخی پیش‌فرض خواهد بود.
.TP
.B \fB\-h\fP
راهنما را چاپ کرده و خارج می‌شود.
.TP
.B \fB\-i\fP
تنها بخش ابتدایی تبادل را انجام می‌دهد: DISCOVER\-OFFER اگر \fB\-4\fP
انتخاب شده باشد، و Solicit\-Advertise اگر \fB\-6\fP برگزیده شده باشد.
.sp
گزینه \fB\-i\fP با گزینه‌های زیر ناسازگار است: \fB\-1\fP، \fB\-d\fP،
\fB\-D\fP، \fB\-E\fP، \fB\-S\fP، \fB\-I\fP و \fB\-F\fP\&. علاوه بر این،
نمی‌توان آن را با چندین نمونه از \fB\-O\fP، \fB\-T\fP و \fB\-X\fP
به کار برد.
.TP
.B \fB\-J remote\-address\-list\-file\fP
یک فایل متنی شامل چندین آدرس را مشخص می‌کند که برای آزمایش شبکه‌های
اشتراکی طراحی شده است. در صورت ارائه، \fBperfdhcp\fP برای هر تبادل به
صورت تصادفی یکی از آدرس‌ها را انتخاب می‌کند تا ترافیک را از چندین زیرشبکه
تولید نماید. هنگام آزمایش DHCPv4، باید با متغیر محیطی
\fBKEA_TEST_SEND_RESPONSES_TO_SOURCE=ENABLE\fP راه‌اندازی شود؛ در
غیر این صورت، \fBperfdhcp\fP قادر به دریافت پاسخ‌ها نخواهد بود.
.TP
.B \fB\-l local\-addr|interface\fP
برای عملیات DHCPv4، نام میزبان/آدرس محلی را برای برقراری ارتباط با سرور
مشخص می‌کند. به طور پیش‌فرض، آدرس رابطی استفاده می‌شود که ترافیک به
طور عادی از طریق آن به سمت سرور مسیریابی می‌شود. برای عملیات DHCPv6،
نام رابط شبکه‌ای را مشخص می‌کند که تبادلات از طریق آن آغاز می‌گردند.
.TP
.B \fB\-L local\-port\fP
درگاه محلی برای استفاده را مشخص می‌کند. این مقدار باید صفر یا یک عدد
صحیح مثبت تا ۶۵۵۳۵ باشد. مقدار 0 (پیش‌فرض) به \fBperfdhcp\fP اجازه
می‌دهد تا درگاه خود را انتخاب کند.
.TP
.B \fB\-M mac\-list\-file\fP
یک فایل متنی شامل فهرستی از آدرس‌های MAC را مشخص می‌کند که در هر خط
یک آدرس قرار دارد. در صورت ارائه، برای هر تبادل جدید یک آدرس MAC به
طور تصادفی از این فهرست برگزیده می‌شود. در DHCPv6، آدرس‌های MAC برای
تولید DUID\-LL استفاده می‌شوند. این پارامتر نباید در کنار پارامتر
\fB\-b\fP استفاده شود.
.TP
.B \fB\-N remote\-port\fP
درگاه راه دور برای استفاده را مشخص می‌کند. این مقدار باید صفر یا یک عدد
صحیح مثبت تا ۶۵۵۳۵ باشد. مقدار 0 (پیش‌فرض) به \fBperfdhcp\fP اجازه
می‌دهد تا درگاه استاندارد سرویس را انتخاب کند.
.TP
.B \fB\-o code,hexstring\fP
برنامه \fBperfdhcp\fP را وادار می‌کند تا گزینه اضافی مشخص‌شده (یا در صورت
استفاده چندباره، گزینه‌ها) را در بسته‌های ارسالی بگنجاند. مقدار code شماره
گزینه را تعیین می‌کند و hexstring یک رشته هگزادسیمال است که محتوای
گزینه را تعریف می‌نماید. باید احتیاط شود، زیرا \fBperfdhcp\fP هیچ‌گونه
منطقی در پس گزینه‌ها ارائه نمی‌دهد؛ آن‌ها صرفاً درون بسته‌ها قرار گرفته
و همان‌طور که هستند ارسال می‌شوند. دقت کنید گزینه‌هایی را که پیش‌تر درج
شده‌اند دو بار اضافه نکنید. برای نمونه، جهت درج شناسه client\-class
(کد گزینه 60) با رشته \(dqdocsis\(dq، از \fB\-o 60,646f63736973\fP\&
استفاده کنید. گزینه \fB\-o\fP ممکن است چندین بار به کار رود. خانواده
پروتکل (\fB\-4\fP یا \fB\-6\fP) باید پیش از استفاده از \fB\-o\fP مشخص
شود.
.TP
.B \fB\-P preload\fP
تبادلات پیش‌بارگذاری (preload) را در زمان راه‌اندازی به صورت پشت سر هم
(back\-to\-back) آغاز می‌کند. مقدار آن باید 0 (پیش‌فرض) یا یک عدد صحیح
مثبت باشد..TP
.B \fB\-r rate\fP
نرخ تبادلات DORA/SARR (یا اگر \fB\-i\fP داده شده باشد، DO/SA) در هر ثانیه را آغاز می‌کند. یک گزارش دوره‌ای تولید می‌شود که تعداد تبادلات تکمیل‌نشده و همچنین میانگین تأخیر پاسخ را نشان می‌دهد. برنامه تا زمان متوقف شدن ادامه می‌یابد، که در آن نقطه یک گزارش نهایی تولید می‌شود.
.TP
.B \fB\-R num\-clients\fP
مشخص می‌کند چند کلاینت مختلف مورد استفاده قرار می‌گیرند. با مقدار 1 (پیش‌فرض)، به نظر می‌رسد که تمام درخواست‌ها از یک کلاینت یکسان ارسال می‌شوند. باید یک عدد مثبت باشد.
.TP
.B \fB\-s seed\fP
سید (seed) تصادفی‌سازی را مشخص می‌کند که باعث تکرارپذیر شدن اجراهای \fBperfdhcp\fP می‌شود. این مقدار باید 0 یا یک عدد صحیح مثبت باشد. مقدار 0 به این معنی است که از seed استفاده نمی‌شود؛ این مقدار پیش‌فرض است.
.TP
.B \fB\-\-scenario name\fP
نوع سناریو را تعیین می‌کند و می‌تواند \fBbasic\fP (پیش‌فرض) یا \fBavalanche\fP باشد\&.
.TP
.B \fB\-T template\-file\fP
فایلی حاوی الگوی مورد استفاده به‌صورت جریانی از ارقام هگزادسیمال را مشخص می‌کند. این گزینه می‌تواند تا دو بار مشخص شود و محتوای بسته‌های ارسالی را کنترل می‌کند (بخش \(dqTemplates\(dq در بالا را ببینید).
.TP
.B \fB\-u\fP
بررسی یکتایی آدرس را فعال می‌کند. مدت اعتبار اجاره (valid\-lifetime) نباید کوتاه‌تر از مدت زمان آزمون باشد، و کلاینت‌ها نباید یک آدرس را بیش از یک بار بدون آزادسازی (release) آن درخواست کنند.
.TP
.B \fB\-v\fP
نسخه Kea را نمایش می‌دهد.
.TP
.B \fB\-V\fP
نسخه تفصیلی Kea را نمایش می‌دهد.
.TP
.B \fB\-W exit\-wait\-time\fP
پارامتر exit\-wait\-time را تعیین می‌کند که باعث می‌شود \fBperfdhcp\fP پس از برآورده شدن شرایط خروج، مدت زمان معینی منتظر بماند تا تمام بسته‌ها بدون ارسال هیچ بسته جدیدی دریافت شوند. بر حسب میکروثانیه بیان می‌شود. در صورت عدم تعیین، از 0 استفاده می‌شود (یعنی بلافاصله پس از برآورده شدن شرایط خروج خارج شود).
.TP
.B \fB\-w script_name\fP
نام اسکریپتی را که باید قبل/بعد از \fBperfdhcp\fP اجرا شود مشخص می‌کند\&. هنگام فراخوانی، یک پارامتر منفرد، یا \(dqstart\(dq یا \(dqstop\(dq، به اسکریپت ارسال می‌شود که نشان می‌دهد قبل از \fBperfdhcp\fP فراخوانی شده است یا بعد از آن\&.
.TP
.B \fB\-x diagnostic\-selector\fP
اطلاعات عیب‌یابی تکمیلی را در خروجی می‌گنجاند. این یک رشته از کلیدواژه‌های تکی است که عملیات‌های مورد نظر برای دریافت خروجی پرجزئیات (verbose) را مشخص می‌کند. حروف کلیدی انتخابگر عبارتند از:
.INDENT 7.0
.TP
.B \fBa\fP
آرگومان‌های خط فرمان رمزگشایی‌شده را چاپ می‌کند.
.TP
.B \fBe\fP
دلیل خروج را چاپ می‌کند.
.TP
.B \fBi\fP
جزئیات پردازش نرخ را چاپ می‌کند.
.TP
.B \fBl\fP
اجاره‌های (lease) دریافتی را چاپ می‌کند.
.TP
.B \fBs\fP
شناسه اولین سرور (server ID) را چاپ می‌کند.
.TP
.B \fBt\fP
در پایان، زمان‌سنج‌های تمام تبادلات موفق را چاپ می‌کند.
.TP
.B \fBT\fP
در پایان، الگوها را چاپ می‌کند.
.UNINDENT
.TP
.B \fB\-Y seconds\fP
زمانی بر حسب ثانیه که پس از آن \fBperfdhcp\fP شروع به شبیه‌سازی انتظار طولانی‌تر کلاینت برای پاسخ‌های سرور می‌کند. این کار فیلد \fBsecs\fP را در DHCPv4 افزایش می‌دهد و مقادیر افزایش‌یافته را در گزینه \fBElapsed Time\fP در DHCPv6 ارسال می‌کند. باید همراه با \fB\-y\fP استفاده شود\&.
.TP
.B \fB\-y seconds\fP
مدت زمان بر حسب ثانیه که در طول آن \fBperfdhcp\fP شبیه‌سازی انتظار طولانی‌تر کلاینت برای پاسخ‌های سرور را انجام می‌دهد. این کار فیلد \fBsecs\fP را در DHCPv4 افزایش می‌دهد و مقادیر افزایش‌یافته را در گزینه \fBElapsed Time\fP در DHCPv6 ارسال می‌کند. باید همراه با \fB\-Y\fP استفاده شود\&.
.UNINDENT
.SS گزینه‌های فقط DHCPv4 (DHCPv4\-Only Options)
.sp
گزینه‌های زیر فقط برای DHCPv4 اعمال می‌شوند (یعنی زمانی که \fB\-4\fP داده شده باشد).
.INDENT 0.0
.TP
.B \fB\-B\fP
مدیریت همه‌پخشی (broadcast) را اجبار می‌کند.
.UNINDENT
.SS گزینه‌های فقط DHCPv6 (DHCPv6\-Only Options)
.sp
گزینه‌های زیر فقط برای DHCPv6 اعمال می‌شوند (یعنی زمانی که \fB\-6\fP داده شده باشد).
.INDENT 0.0
.TP
.B \fB\-c\fP
یک گزینه rapid\-commit اضافه می‌کند (تبادلات به‌صورت Solicit\-Advertise خواهند بود).
.TP
.B \fB\-A encapsulation\-level\fP
مشخص می‌کند که ترافیک رله‌شده (relayed) باید تولید شود. این آرگومان سطح کپسوله‌سازی (encapsulation) را مشخص می‌کند، یعنی چه تعداد عامل رله (relay agent) شبیه‌سازی می‌شوند. در حال حاضر تنها مقدار پشتیبانی‌شده برای encapsulation\-level عدد 1 است، به این معنی که ترافیک تولیدشده معادل میزان ترافیک عبوری از یک relay agent واحد است.
.TP
.B \fB\-\-or encapsulation\-level:code,hexstring\fP
برنامه \fBperfdhcp\fP را ملزم می‌کند تا گزینه اضافی مشخص‌شده (یا در صورت استفاده مکرر، گزینه‌ها) را در پیام رله‌شده DHCPv6 در سطح کپسوله‌سازی داده‌شده درج کند؛ در حال حاضر، تنها مقدار پشتیبانی‌شده برای encapsulation\-level عدد 1 است.
این گزینه بسیار شبیه به \fB\-o\fP است: آرگومان code کد گزینه را مشخص می‌کند و hexstring یک رشته هگزادسیمال است که محتوای گزینه را تعیین می‌کند. باید دقت شود، زیرا \fBperfdhcp\fP هیچ‌گونه منطقی برای گزینه‌ها ارائه نمی‌دهد؛ آن‌ها صرفاً درون بسته‌ها درج شده و به همان شکل ارسال می‌شوند. عبارت \fBencapsulation\-level:\fP اختیاری است؛ اگر حذف شود، مقدار پیش‌فرض سطح کپسوله‌سازی یعنی 1 استفاده می‌شود.
برای نمونه، جهت درج Subscriber identifier (کد گزینه 38) با مقدار 1234 در اولین سطح کپسوله‌سازی، از \fB\-\-or 38,31323334\fP یا \fB\-\-or 1:38,31323334\fP استفاده کنید\&. گزینه \fB\-\-or\fP ممکن است چندین بار استفاده شود و باید همراه با \fB\-A\fP به کار رود\&.
.UNINDENT.SS "گزینه‌های مربوط به الگو (Template\-Related Options)"
.sp
گزینه‌های زیر تنها می‌توانند در همراهی با \fB\-T\fP استفاده شوند و
چگونگی تغییر الگو توسط \fBperfdhcp\fP را مهار می‌کنند. این گزینه‌ها
می‌توانند چندین بار در خط فرمان مشخص شوند؛ هر بار تکرار بر فایل الگوی متناظر
تأثیر می‌گذارد (بخش \(dqالگوها\(dq در بالا را ببینید).
.INDENT 0.0
.TP
.B \fB\-E time\-offset\fP
انحراف فیلد \fBsecs\fP (در DHCPv4) یا گزینهٔ \fBElapsed Time\fP (در DHCPv6) را در
الگوی دوم (یعنی Request) تعیین می‌کند؛ باید ۰ یا یک عدد صحیح مثبت باشد.
مقدار ۰ این ویژگی را غیرفعال می‌کند.
.TP
.B \fB\-I ip\-offset\fP
انحراف آدرس IP (در DHCPv4) در گزینهٔ \fBrequested\-ip\fP
یا گزینهٔ \fBIA_NA\fP (در DHCPv6) را در الگوی دوم (Request) تعیین می‌کند.
.TP
.B \fB\-O random\-offset\fP
انحراف آخرین اوکتتی را که باید در الگو تصادفی‌سازی شود تعیین می‌کند. این
مقدار باید عددی صحیح و بزرگ‌تر از ۳ باشد. برای استفاده از این گزینه،
سوئیچ \fB\-T\fP حتماً باید داده شود.
.TP
.B \fB\-S srvid\-offset\fP
انحراف گزینهٔ \fBserver\-id\fP در الگوی دوم (Request) را مشخص می‌کند.
این مقدار باید عددی صحیح و مثبت باشد، و این سوئیچ تنها زمانی می‌تواند استفاده شود
که گزینهٔ الگو (\fB\-T\fP) نیز مشخص شده باشد.
.TP
.B \fB\-X xid\-offset\fP
انحراف شناسهٔ تراکنش (xid) را در الگو تعیین می‌کند. این مقدار باید یک
عدد صحیح مثبت باشد، و این سوئیچ تنها در صورتی می‌تواند استفاده شود که گزینهٔ
الگو (\fB\-T\fP) نیز داده شده باشد.
.UNINDENT
.SS "گزینه‌های مهار آزمون (Options Controlling a Test)"
.INDENT 0.0
.TP
.B \fB\-D max\-drop\fP
اگر به تعداد \(dqmax\-drop\(dq درخواست دور انداخته شود، آزمون را فوراً متوقف می‌کند.
برای توقف در صورت دور انداخته شدن حتی یک درخواست، از \fB\-D 1\fP استفاده کنید.
\(dqmax\-drop\(dq باید یک عدد صحیح مثبت باشد. اگر \(dqmax\-drop\(dq
شامل پسوند \fB%\fP باشد، بیشینهٔ درصد درخواست‌هایی را مشخص می‌کند که پیش از متوقف شدن
می‌توانند دور انداخته شوند. در این حالت، بررسی آستانه پس از این آغاز می‌شود که انتظار می‌رود
۱۰ درخواست دریافت شده باشد.
.TP
.B \fB\-n num\-requests\fP
تعداد \(dqnum\-request\(dq تراکنش را آغاز می‌کند. تا زمانی که همهٔ
تراکنش‌ها آغاز نشده یا در انتظار پاسخ نمانده باشند، هیچ گزارشی تولید نمی‌شود؛
پس از آن گزارشی تولید شده و برنامه پایان می‌یابد.
.TP
.B \fB\-p test\-period\fP
درخواست‌ها را برای مدت‌زمان \(dqtest\-period\(dq ارسال می‌کند، که به همان روش
\fB\-d\fP تعیین می‌شود. این گزینه می‌تواند به عنوان جایگزینی برای \fB\-n\fP استفاده شود،
یا هر دو گزینه داده شوند که در این حالت، آزمون با رسیدن به هر یک از این دو محدودیت به پایان می‌رسد.
.TP
.B \fB\-t interval\fP
میزان تأخیر (به ثانیه) را بین دو گزارش پیاپی تنظیم می‌کند.
.TP
.B \fB\-C separator\fP
از خروجی اولیه جلوگیری می‌کند و باعث می‌شود داده‌های میان‌دوره‌ای تنها شامل
مقدارهایی باشند که با \fBseparator\fP از هم جدا شده‌اند. در همراهی با \fB\-t\fP
برای تولید گزارش‌هایی با قابلیت تجزیهٔ آسان در بازه‌های زمانی \fB\-t\fP به کار می‌رود.
.UNINDENT
.SS "آرگومان‌ها (Arguments)"
.INDENT 0.0
.TP
.B \fBserver\fP
سرور مورد نظر برای آزمون را نشان می‌دهد که به صورت یک آدرس IP مشخص می‌شود. در مورد DHCPv6،
می‌توان از نام ویژهٔ \fBall\fP برای اشاره به
\fBAll_DHCP_Relay_Agents_and_Servers\fP (آدرس چندپخشی FF02::1:2)،
یا از نام ویژهٔ \fBservers\fP برای اشاره به \fBAll_DHCP_Servers\fP (آدرس
چندپخشی FF05::1:3) استفاده کرد. مشخص کردن سرور الزامی است، مگر در حالتی
که گزینهٔ \fB\-l\fP برای تعیین یک رابط (interface) داده شده باشد، که در این حالت
پیش‌فرض آن \fBall\fP خواهد بود.
.UNINDENT
.SS "خطاها (Errors)"
.sp
\fBperfdhcp\fP می‌تواند خطاهای زیر را در تبادل بسته‌ها گزارش کند:
.INDENT 0.0
.TP
.B tooshort
پیامی دریافت شده است که بیش از حد کوتاه بوده است.
.TP
.B orphans
پیامی دریافت شده است که با هیچ‌یک از پیام‌های ارسال‌شده به سرور همخوانی ندارد (یعنی
یک پیام تکراری است، پیامی است که پس از تأخیری بیش از حد رسیده است، یا به سادگی
شناخته نشده است).
.TP
.B locallimit
هنگام ارسال پیام، به محدودیت‌های سیستم محلی برخورد شده است.
.UNINDENT
.SS "وضعیت خروج (Exit Status)"
.sp
\fBperfdhcp\fP با یکی از کدهای وضعیت زیر خارج می‌شود:
.INDENT 0.0
.TP
.B 0
موفقیت‌آمیز.
.TP
.B 1
خطای عمومی.
.TP
.B 2
خطا در آرگومان‌های خط فرمان.
.TP
.B 3
هیچ شکست عمومی در عملکرد رخ نداده، اما یک یا چند تبادل ناموفق بوده‌اند.
.UNINDENT
.SS "مثال‌های کاربرد (Usage Examples)"
.sp
در اینجا مثالی آمده است که ترافیک عادی DHCPv4 را از ۱۰۰ دستگاه DHCPv4 شبیه‌سازی می‌کند (\-R 100)،
با نرخ ۱۰ بسته در ثانیه (\-r 10)، جزئیات نرخ پرسش/پاسخ را نمایش می‌دهد (\-xi)،
هر ۲ ثانیه یک بار گزارش می‌دهد (\-t 2)، و بسته‌ها را به IP با مقدار 192.0.2.1 می‌فرستد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
sudo perfdhcp \-xi \-t 2 \-r 10 \-R 100 192.0.2.1
.EE
.UNINDENT
.UNINDENT
.sp
این نمونه‌ای مشابه است، اما برای DHCPv6. توجه داشته باشید که پروتکل DHCPv6 از آدرس‌های
link\-local استفاده می‌کند، بنابراین رابط شبکه‌ای (در این مثال eth0) که ترافیک باید روی آن
ارسال شود، باید مشخص گردد. \fBall\fP یک نام مستعار مناسب برای \fBAll_DHCP_Relay_Agents_and_Servers\fP
(آدرس چندپخشی FF02::1:2) است. همچنین می‌توان از نام مستعار \fBservers\fP برای اشاره به
\fBAll_DHCP_Servers\fP (آدرس چندپخشی FF05::1:3) استفاده کرد. مقدار پیش‌فرض \fBall\fP است.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
sudo perfdhcp \-6 \-xi \-t 1 \-r 1 \-R 10 \-l eth0 all
.EE
.UNINDENT
.UNINDENT
.sp
مثال‌های زیر ترافیک عادی DHCPv4 و DHCPv6 را شبیه‌سازی می‌کنند که پس از ۳ ثانیه،
برای مدت ۱۰ ثانیه وانمود می‌کند هیچ پاسخی از سرور دریافت نمی‌کند. پروتکل
DHCPv4 این وضعیت را با فیلد افزایش‌یافتهٔ \fBsecs\fP نشان می‌دهد، در حالی که DHCPv6 از گزینهٔ
\fBElapsed Time\fP استفاده می‌کند. در شبکه‌های واقعی، این امر نشان می‌دهد که کلاینت‌ها پاسخ‌ها را
به‌موقع دریافت نمی‌کنند. این می‌تواند برای شبیه‌سازی برخی سناریوهای HA استفاده شود، زیرا Kea
از فیلد \fBsecs\fP و مقدار گزینهٔ \fBElapsed Time\fP به عنوان یکی از شاخص‌های
عدم پاسخ‌گویی شریک HA استفاده می‌کند. در صورت فعال شدن با \fB\-y\fP و \fB\-Y\fP، مقادیر \fBsecs\fP
و \fBElapsed Time\fP به طور پیوسته افزایش می‌یابند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
sudo perfdhcp \-xi \-t 1 \-r 1 \-y 10 \-Y 3 192.0.2.1

sudo perfdhcp \-6 \-xi \-t 1 \-r 1 \-y 10 \-Y 3 2001:db8::1
.EE
.UNINDENT
.UNINDENT.SS "مستندات (DOCUMENTATION)"
.sp
نرم‌افزار Kea همراه با یک «راهنمای مرجع جامع مدیر سیستم Kea» ارائه می‌شود که تمام جنبه‌های اجرای نرم‌افزار Kea \- از جمله کامپایل، نصب، پیکربندی، نمونه‌های پیکربندی و موارد دیگر \- را پوشش می‌دهد. همچنین Kea دارای «راهنمای پیام‌های Kea» است که تمام پیام‌های احتمالی قابل چاپ توسط Kea را همراه با شرح مختصری برای هر یک فهرست می‌کند. هر دو سند در قالب‌های مختلف (.txt، .html، .pdf) به همراه توزیع Kea در دسترس هستند. مستندات Kea در نشانی زیر در دسترس است:
\%<https://\:kea\:.readthedocs\:.io>\&.
.sp
کد منبع Kea در «راهنمای توسعه‌دهنده Kea» مستندسازی شده است که در نشانی زیر قابل دسترسی است:
\%<https://\:reports\:.kea\:.isc\:.org/\:dev_guide>\&.
.sp
وب‌سایت پروژه Kea در نشانی زیر در دسترس است:
\%<https://\:kea\:.isc\:.org>\&.
.SS "فهرست‌های پستی و پشتیبانی (MAILING LISTS AND SUPPORT)"
.sp
دو فهرست پستی عمومی برای پروژه Kea در دسترس است. \fBkea\-users\fP
(نشانی kea\-users در lists.isc.org) برای کاربران Kea در نظر گرفته شده است، در حالی که \fBkea\-dev\fP
(نشانی kea\-dev در lists.isc.org) برای توسعه‌دهندگان Kea، مشارکت‌کنندگان آینده و دیگر کاربران پیشرفته در نظر گرفته شده است. هر دو فهرست در نشانی زیر در دسترس هستند:
\%<https://\:lists\:.isc\:.org>\&. جامعه کاربری در هر دوی این فهرست‌ها در حد توان (best\-effort) پشتیبانی ارائه می‌دهد.
.sp
سازمان ISC پشتیبانی حرفه‌ای برای خدمات Kea ارائه می‌دهد. برای جزئیات به نشانی زیر مراجعه کنید:
\%<https://\:www\:.isc\:.org/\:kea>\&.
.SS "تاریخچه (HISTORY)"
.sp
ابزار \fBperfdhcp\fP در ابتدا در اکتبر ۲۰۱۱ توسط John DuBois، Francis Dupont و Marcin Siodelski از ISC کدنویسی شد. Kea 1.0.0 که شامل \fBperfdhcp\fP بود، در دسامبر ۲۰۱۵ منتشر شد.
.SS "همچنین ببینید (SEE ALSO)"
.sp
\fBkea\-dhcp4(8)\fP، \fBkea\-dhcp6(8)\fP، \fBkea\-dhcp\-ddns(8)\fP،
\fBkea\-admin(8)\fP، \fBkea\-netconf(8)\fP،
\fBkeactrl(8)\fP، \fBkea\-lfc(8)\fP، Kea Administrator Reference Manual.
.SH "راهنمای پیام‌های KEA (KEA MESSAGES MANUAL)"
.sp
نرم‌افزار Kea پیاده‌سازی متن‌بازی از کارسازهای پروتکل پیکربندی پویای میزبان (DHCP) است که توسط Internet Systems Consortium (ISC) توسعه یافته و نگهداری می‌شود.
.sp
این سند، راهنمای مرجع برای Kea نسخه 3.2.0 است.
پیوندهای مربوط به به‌روزترین نسخه این سند (در قالب‌های PDF، HTML و متن ساده)، به همراه سایر اطلاعات مفید درباره Kea را می‌توان در پایگاه دانش ISC به نشانی \%<https://\:kea\:.readthedocs\:.io> یافت.
.sp
لطفاً توجه داشته باشید که در پیام‌های زیر، علامت درصد (\fB%\fP) که به دنبال آن یک عدد می‌آید، برای نشان دادن یک جای‌نگه‌دار (placeholder) برای داده‌هایی استفاده می‌شود که توسط کد Kea در حین اجرای آن ارائه می‌گردند.
.SS ALLOC
.SS ALLOC_ENGINE_IGNORING_UNSUITABLE_GLOBAL_ADDRESS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: ignoring globally reserved address %2, it falls outside %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که موتور تخصیص تشخیص دهد نشانی رزروشده به صورت سراسری خارج از زیرشبکه (subnet) یا شبکه مشترک (shared\-network) انتخاب‌شده قرار می‌گیرد. کارساز باید نشانی رزروشده را نادیده گرفته و برای تخصیص پویا تلاش کند.
.SS ALLOC_ENGINE_IGNORING_UNSUITABLE_GLOBAL_ADDRESS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: ignoring globally reserved address %2, it falls outside %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که موتور تخصیص تشخیص دهد نشانی رزروشده به صورت سراسری خارج از زیرشبکه یا شبکه مشترک انتخاب‌شده قرار می‌گیرد. کارساز باید نشانی رزروشده را نادیده گرفته و برای تخصیص پویا تلاش کند.
.SS ALLOC_ENGINE_LEASE_RECLAIMED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
successfully reclaimed lease %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی ثبت می‌شود که موتور تخصیص یک اجاره (lease) را با موفقیت بازپس‌گیری کند. این اجاره اکنون برای واگذاری در دسترس است.
.SS ALLOC_ENGINE_V4_ALLOC_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: error during attempt to allocate an IPv4 address: %2
.EE
.UNINDENT
.UNINDENT
.sp
هنگام تلاش برای تخصیص یک نشانی IPv4 خطایی رخ داده است که دلیل این شکست در پیام گنجانده شده است. کارساز پیامی مبنی بر رد اجاره به کلاینت بازمی‌گرداند. آرگومان نخست شامل اطلاعات شناسایی کلاینت است.
.SS ALLOC_ENGINE_V4_ALLOC_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: failed to allocate an IPv4 address after %2 attempt(s)
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام هشدار قدیمی است که هنگام شکست موتور تخصیص در تخصیص یک اجاره به یک کلاینت صادر می‌شود. این پیام شامل تعداد دفعاتی است که موتور پیش از انصراف، برای تخصیص اجاره تلاش کرده است. اگر تعداد تلاش‌ها ۰ باشد زیرا موتور نتوانسته است از هیچ‌یک از استخرهای نشانی برای آن کلاینت خاص استفاده کند، این پیام ثبت نمی‌شود. با وجود اینکه چندین لاگ با جزئیات بیشتر پیش از این پیام ثبت می‌شوند، این پیام برای حفظ سازگاری با گذشته باقی مانده است.
این پیام ممکن است نشان‌دهنده این باشد که استخر نشانی شما برای تعداد کلاینت‌هایی که سعی در سرویس‌دهی به آن‌ها دارید بسیار کوچک است و باید گسترش یابد. همچنین، اگر می‌دانید تعداد کلاینت‌های فعالِ هم‌زمان کمتر از نشانی‌های در دسترس شما است، می‌توانید کاهش مدت زمان اعتبار اجاره (lease lifetime) را مد نظر قرار دهید. با این روش، نشانی‌های تخصیص‌یافته به کلاینت‌هایی که دیگر در شبکه فعال نیستند، زودتر آزاد شده و در دسترس قرار می‌گیرند..SS ALLOC_ENGINE_V4_ALLOC_FAIL_CLASSES
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Failed to allocate an IPv4 address for client with classes: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی چاپ می‌شود که Kea در تخصیص یک آدرس ناموفق بوده و بستهٔ کلاینت متعلق به یک یا چند کلاس باشد. دلایل متعددی ممکن است برای عدم انتساب اجاره (lease) وجود داشته باشد. یکی از آن‌ها این است که تمام استخرها نیازمند تعلق بسته به کلاس‌های خاصی هستند و بستهٔ دریافتی به هیچ‌یک از آن‌ها تعلق ندارد. مورد دیگر که این اطلاعات می‌تواند در آن مفید باشد، اشاره به این نکته است که آدرس‌های استخر رزروشده برای یک کلاس معین به پایان رسیده است. در صورت نمایش این پیام، بررسی اندازهٔ استخر و تعاریف رده‌بندی را مد نظر قرار دهید.
.SS ALLOC_ENGINE_V4_ALLOC_FAIL_NO_POOLS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: no pools were available for the address allocation
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که موتور تخصیص نتواند اجاره‌ای را اختصاص دهد، چرا که امکان استفاده از هیچ‌یک از استخرهای پیکربندی‌شده برای آن کلاینت خاص وجود نداشته است. همچنین این احتمال وجود دارد که تمام زیرشبکه‌هایی که موتور تخصیص تلاش کرده از آن‌ها آدرسی اختصاص دهد، فاقد استخر آدرس باشند. در این صورت، چنانچه مدیر سیستم انتظار داشته باشد به برخی از کلاینت‌ها آدرس‌های پویا اختصاص یابد، این مسئله باید یک پیکربندی نادرست تلقی شود. یک زیرشبکه تنها در صورتی می‌تواند فاقد هرگونه استخر باشد که قرار باشد به همهٔ کلاینت‌ها آدرس‌های IP رزروشده اختصاص داده شود.
اگر زیرشبکه‌های متصل به یک شبکهٔ اشتراکی یا یک زیرشبکهٔ منفرد که کلاینت متعلق به آن است دارای استخرهای پیکربندی‌شده باشند، در این حالت، این پیام نشان‌دهندهٔ آن است که هیچ‌یک از استخرها به دلیل عدم تعلق کلاینت به کلاس‌های مناسب، برای آن قابل استفاده نبوده‌اند.
.SS ALLOC_ENGINE_V4_ALLOC_FAIL_SHARED_NETWORK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: failed to allocate an IPv4 address in the shared network %2: %3 subnets have no available addresses, %4 subnets have no matching pools
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که موتور تخصیص در اختصاص یک اجاره برای کلاینت متصل به یک شبکهٔ اشتراکی (shared network) با شکست مواجه شود. شبکهٔ اشتراکی باید حداقل شامل یک زیرشبکه باشد، اما معمولاً چندین زیرشبکه را تجمیع می‌کند. این پیام لاگ نشان می‌دهد که موتور تخصیص نتوانسته هیچ اجارهٔ مناسبی را در هیچ‌یک از زیرشبکه‌های موجود در شبکهٔ اشتراکی پیدا و تخصیص دهد.
آرگومان اول حاوی اطلاعات شناسایی کلاینت است. آرگومان دوم نام شبکهٔ اشتراکی را مشخص می‌کند. دو آرگومان باقی‌مانده اطلاعات بیشتری ارائه می‌دهند که برای اشکال‌زدایی دلیل عدم توانایی موتور تخصیص در واگذاری اجاره مفید هستند. موتور تخصیص تلاش می‌کند تا آدرس‌ها را از زیرشبکه‌های مختلف در شبکهٔ اشتراکی تخصیص دهد، و ممکن است در برخی زیرشبکه‌ها به دلیل عدم وجود اجاره‌های آزاد یا رزرو بودن اجاره‌های آزاد برای کلاینت‌های دیگر با شکست مواجه شود. تعداد چنین زیرشبکه‌هایی در آرگومان سوم مشخص می‌شود. برای سایر زیرشبکه‌ها، تخصیص ممکن است به دلیل در دسترس نبودن استخرهای آن‌ها برای کلاینت مربوطه ناموفق باشد. این استخرها با کلاس‌های کلاینتی محافظت می‌شوند که کلاینت به آن‌ها تعلق ندارد. آرگومان چهارم تعداد چنین زیرشبکه‌هایی را مشخص می‌کند. مدیر سیستم با بررسی مقادیر آرگومان‌های سوم و چهارم می‌تواند مواردی را که در آن‌ها آدرسی در برخی از استخرها باقی نمانده شناسایی کند. او همچنین می‌تواند پیکربندی‌های نادرست رده‌بندی کلاینت را که موجب رد ارائهٔ سرویس به برخی کلاینت‌ها می‌شود، تشخیص دهد.
.SS ALLOC_ENGINE_V4_ALLOC_FAIL_SUBNET
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: failed to allocate an IPv4 lease in the subnet %2, subnet\-id %3, shared network %4
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که موتور تخصیص نتواند اجاره‌ای را برای کلاینت متصل به یک زیرشبکه تخصیص دهد. آرگومان اول شامل اطلاعات شناسایی کلاینت است. آرگومان‌های دوم و سوم زیرشبکه را مشخص می‌کنند. آرگومان چهارم نیز در صورتی که زیرشبکه متعلق به یک شبکهٔ اشتراکی باشد، نام شبکهٔ اشتراکی را تعیین می‌کند.
دلایل متعددی برای شکست در تخصیص اجاره وجود دارد. یکی از آن‌ها می‌تواند اتمام ظرفیت استخرها یا رزروهای موجود برای اجاره‌های آزاد باشد. با این حال، در برخی موارد، ممکن است موتور تخصیص در یافتن استخر مناسب برای کلاینت ناموفق باشد؛ یعنی در شرایطی که استخرها تنها برای کلاس‌های کلاینت خاصی در دسترس هستند، اما کلاینت درخواست‌کننده به آن‌ها تعلق ندارد. پیام‌های لاگ بعدی اطلاعات بیشتری را به منظور تمایز بین این حالات مختلف ارائه می‌دهند.
.SS ALLOC_ENGINE_V4_DECLINED_RECOVERED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
IPv4 address %1 was recovered after %2 seconds of probation\-period
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی نشان می‌دهد که آدرس مشخص‌شده به عنوان تکراری گزارش شده بود (کلاینت پیام DECLINE ارسال کرده بود) و سرور این آدرس را برای مدت‌زمانی غیرقابل‌دسترس علامت‌گذاری کرده بود. اکنون این زمان سپری شده و آدرس به استخر آدرس‌های در دسترس بازگردانده شده است. این مرحله، فرایند بازیابی رد (decline recovery) را به پایان می‌رساند.
.SS ALLOC_ENGINE_V4_DISCOVER_ADDRESS_CONFLICT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: conflicting reservation for address %2 with existing lease %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که سرور DHCP متوجه شود آدرس رزروشده برای کلاینت قابل ارائه نیست، زیرا این آدرس در حال حاضر به کلاینت دیگری تخصیص داده شده است. سرور تلاش خواهد کرد آدرس متفاوتی را به کلاینت اختصاص دهد تا زمانی که تداخل برطرف شود از آن استفاده نماید. آرگومان اول شامل اطلاعات شناسایی کلاینت است..SS ALLOC_ENGINE_V4_DISCOVER_HR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
client %1 sending DHCPDISCOVER has reservation for the address %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح ثبت گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام زمانی صادر می‌شود که موتور تخصیص تشخیص دهد کلاینت فرستندهٔ DHCPDISCOVER دارای رزرو برای آدرس مشخص‌شده است. موتور تخصیص تلاش خواهد کرد این آدرس را به کلاینت پیشنهاد (offer) دهد.
.SS ALLOC_ENGINE_V4_LEASES_RECLAMATION_COMPLETE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
reclaimed %1 leases in %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح ثبت گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی ثبت می‌شود که موتور تخصیص، بازپس‌گیری مجموعه‌ای از اجاره‌های منقضی‌شده را به پایان برساند. حداکثر تعداد اجاره‌هایی که در یک دور از روال بازپس‌گیری اجاره بازیابی می‌شوند، با استفاده از پارامتر \(aqmax\-reclaim\-leases\(aq قابل پیکربندی است. با این حال، تعداد اجاره‌های بازپس‌گرفته‌شده ممکن است توسط مقدار مهلت زمانی (timeout) که با \(aqmax\-reclaim\-time\(aq پیکربندی شده نیز محدود شود. این پیام شامل تعداد اجاره‌های بازپس‌گرفته‌شده و کل زمان صرف‌شده است.
.SS ALLOC_ENGINE_V4_LEASES_RECLAMATION_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
reclamation of expired leases failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که بازپس‌گیری اجاره‌های منقضی‌شده با شکست مواجه شود.
پیام خطا نمایش داده می‌شود.
.SS ALLOC_ENGINE_V4_LEASES_RECLAMATION_SLOW
.INDENT 0.0
.INDENT 3.5
.sp
.EX
expired leases still exist after %1 reclamations
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که سرور نتواند تمام اجاره‌های منقضی‌شده را در تعداد معینی تلاش متوالی بازپس گیرد. این امر نشان می‌دهد که مقدار \(dqreclaim\-timer\-wait\-time\(dq ممکن است بیش از حد بالا باشد. با این وجود، اگر این رویداد تنها ناشی از یک موج ناگهانی و کوتاه‌مدت از انقضای اجاره‌ها باشد، نیازی به تغییر مقدار نیست و سرور باید در تلاش‌های بعدیِ بازپس‌گیری با آن مواجه شود. اگر این وضعیت نتیجهٔ افزایش دائمی بار سرور باشد، مقدار \(dqreclaim\-timer\-wait\-time\(dq باید کاهش یابد، یا مقادیر \(dqmax\-reclaim\-leases\(dq و \(dqmax\-reclaim\-time\(dq افزایش یابند تا پردازش اجاره‌های بیشتری در یک چرخه مجاز باشد.
همچنین می‌توان این مقادیر را روی 0 تنظیم کرد تا محدودیت‌های تعداد اجاره‌ها و مدت‌زمان برداشته شود. با این حال، این عمل ممکن است باعث دوره‌های طولانی‌تر پاسخ‌گو نبودن سرور به بسته‌های DHCP در حین پردازش اجاره‌های منقضی‌شده گردد.
.SS ALLOC_ENGINE_V4_LEASES_RECLAMATION_START
.INDENT 0.0
.INDENT 3.5
.sp
.EX
starting reclamation of expired leases (limit = %1 leases or %2 milliseconds)
.EE
.UNINDENT
.UNINDENT
.sp
در سطح ثبت گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که موتور تخصیص بازپس‌گیری اجاره‌های منقضی‌شده را آغاز کند. حداکثر تعداد اجاره‌های قابل بازپس‌گیری و مهلت زمانی (timeout) در پیام آورده شده است. اگر هر یک از این مقادیر 0 باشد، به معنای «نامحدود» (\(dqunlimited\(dq) است.
.SS ALLOC_ENGINE_V4_LEASES_RECLAMATION_TIMEOUT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
timeout of %1 ms reached while reclaiming IPv4 leases
.EE
.UNINDENT
.UNINDENT
.sp
در سطح ثبت گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که موتور تخصیص هنگام اجرای بازپس‌گیری اجاره‌های منقضی‌شده به مهلت زمانی برسد. بازپس‌گیری اکنون متوقف خواهد شد و تمام اجاره‌هایی که به دلیل پایان مهلت زمانی بازپس‌گرفته نشده‌اند، با شروع بازپس‌گیری زمان‌بندی‌شدهٔ بعدی بازپس گرفته خواهند شد. آرگومان، مقدار مهلت زمانی بیان‌شده به میلی‌ثانیه است.
.SS ALLOC_ENGINE_V4_LEASE_RECLAIM
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: reclaiming expired lease for address %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح ثبت گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور بازپس‌گیری اجارهٔ منقضی‌شدهٔ DHCPv4 را آغاز می‌کند. آرگومان نخست، اطلاعات شناسایی کلاینت را مشخص می‌کند. آرگومان دوم حاوی آدرس IPv4 اجاره‌داده‌شده است.
.SS ALLOC_ENGINE_V4_LEASE_RECLAMATION_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to reclaim the lease %1: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی ثبت می‌شود که موتور تخصیص در بازپس‌گیری یک اجارهٔ منقضی‌شده با شکست مواجه شود. دلیل این شکست در پیام گنجانده شده است. این خطا ممکن است در قلاب (hook) انقضای اجاره یا هنگام انجام عملیات روی پایگاه دادهٔ اجاره‌ها رخ داده باشد..SS ALLOC_ENGINE_V4_NO_MORE_EXPIRED_LEASES
.INDENT 0.0
.INDENT 3.5
.sp
.EX
all expired leases have been reclaimed
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارساز تمامی اجاره‌های منقضی‌شدهٔ
DHCPv4 در پایگاه داده را بازپس می‌گیرد.
.SS ALLOC_ENGINE_V4_OFFER_EXISTING_LEASE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
allocation engine will try to offer existing lease to the client %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام هنگامی صادر می‌شود که موتور تخصیص تعیین می‌کند
کلاینت یک اجاره در پایگاه دادهٔ اجاره‌ها دارد، هیچ رزروی برای
اجارهٔ دیگری ندارد، و نشانی اجاره‌داده‌شده برای هیچ کلاینت
دیگری رزرو نشده است. موتور تخصیص تلاش خواهد کرد همان اجاره
را به کلاینت پیشنهاد دهد.
.SS ALLOC_ENGINE_V4_OFFER_NEW_LEASE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
allocation engine will try to offer new lease to the client %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام زمانی صادر می‌شود که موتور تخصیص تلاش می‌کند
یک اجارهٔ جدید به کلاینت پیشنهاد دهد. این حالت زمانی رخ می‌دهد که
کلاینت هیچ اجارهٔ فعلی نداشته باشد، فاقد هرگونه رزرو باشد،
یا نشانیِ موجود یا رزروشده به کلاینت دیگری اجاره داده شده باشد.
همچنین زمانی که کلاینت یک hint مشخص نکرده باشد، یا نشانی
ارائه‌شده در hint در حال استفاده باشد.
.SS ALLOC_ENGINE_V4_OFFER_REQUESTED_LEASE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
allocation engine will try to offer requested lease %1 to the client %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام زمانی صادر می‌شود که موتور تخصیص تلاش می‌کند
اجارهٔ مشخص‌شده در hint را پیشنهاد دهد. این وضعیت ممکن است
زمانی رخ دهد که: (a) کلاینت هیچ رزروی نداشته باشد، (b) کلاینت دارای
رزرو باشد اما نشانیِ رزروشده به کلاینت دیگری اجاره داده شده باشد.
.SS ALLOC_ENGINE_V4_RECLAIMED_LEASES_DELETE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
begin deletion of reclaimed leases expired more than %1 seconds ago
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی صادر می‌شود که موتور تخصیص آغاز به
حذف اجاره‌های بازپس‌گرفته‌شده‌ای می‌کند که بیش از تعداد ثانیه‌های
مشخصی پیش منقضی شده‌اند. این عملیات به‌صورت دوره‌ای بر اساس
پارامتر \(dqflush\-reclaimed\-timer\-wait\-time\(dq اجرا می‌شود.
پارامتر \(dqhold\-reclaimed\-time\(dq تعداد ثانیه‌هایی را مشخص می‌کند
که اجاره‌ها پیش از حذف شدن، ذخیره و نگهداری می‌شوند.
.SS ALLOC_ENGINE_V4_RECLAIMED_LEASES_DELETE_COMPLETE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
successfully deleted %1 expired\-reclaimed leases
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی صادر می‌شود که کارساز اجاره‌های
\(dqexpired\-reclaimed\(dq را با موفقیت از پایگاه دادهٔ اجاره‌ها حذف کند.
تعداد اجاره‌های حذف‌شده در پیام لاگ گنجانده شده است.
.SS ALLOC_ENGINE_V4_RECLAIMED_LEASES_DELETE_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deletion of expired\-reclaimed leases failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا هنگامی صادر می‌شود که حذف اجاره‌های \(dqexpired\-reclaimed\(dq
از پایگاه داده با شکست مواجه شود. پیام خطا به پیام لاگ پیوست
می‌شود.
.SS ALLOC_ENGINE_V4_REQUEST_ADDRESS_RESERVED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: requested address %2 is reserved
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام هنگامی صادر می‌شود که موتور تخصیص از تخصیص نشانی
درخواستی کلاینت خودداری کرده است، زیرا این نشانی برای
کلاینت دیگری رزرو شده است. آرگومان اول شامل اطلاعات
شناسایی کلاینت است..SS ALLOC_ENGINE_V4_REQUEST_ALLOC_REQUESTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: trying to allocate requested address %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام هنگامی صادر می‌شود که موتور تخصیص در حال تلاش برای تخصیص (یا استفادهٔ مجدد از یک نشانی منقضی‌شده) نشانی درخواست‌شده توسط کلاینت است. آرگومان نخست شامل اطلاعات شناسایی کلاینت است.
.SS ALLOC_ENGINE_V4_REQUEST_EXTEND_LEASE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: extending lifetime of the lease for address %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام هنگامی صادر می‌شود که موتور تخصیص تشخیص می‌دهد کلاینت از پیش دارای یک اجاره (lease) است که طول عمر آن قابل تمدید بوده و می‌تواند به کلاینت بازگردانده شود.
آرگومان نخست شامل اطلاعات شناسایی کلاینت است.
.SS ALLOC_ENGINE_V4_REQUEST_INVALID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
client %1 having a reservation for address %2 is requesting invalid address %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام زمانی ثبت می‌شود که کلاینت، با داشتن رزرو برای یک نشانی، نشانی متفاوتی را درخواست می‌کند. کلاینت تنها زمانی مجاز به انجام این کار است که نشانی رزروشده توسط کلاینت دیگری در حال استفاده باشد. با این حال، موتور تخصیص تشخیص داده است که نشانی رزروشده در دسترس است و کلاینت باید همان نشانی رزروشده را درخواست کند.
.SS ALLOC_ENGINE_V4_REQUEST_IN_USE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: requested address %2 is in use
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام هنگامی صادر می‌شود که کلاینت درخواستی برای یک نشانی دارد یا رزروی برای نشانی‌ای دارد که در حال استفاده است. آرگومان نخست شامل اطلاعات شناسایی کلاینت است.
.SS ALLOC_ENGINE_V4_REQUEST_OUT_OF_POOL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
client %1, which doesn\(aqt have a reservation, requested address %2 out of the dynamic pool
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام هنگامی صادر می‌شود که کلاینت درخواست تخصیص نشانی‌ای را داده است که متعلق به هیچ استخر نشانی‌ای که نشانی‌ها به‌طور پویا از آن تخصیص می‌یابند نیست. کلاینت همچنین هیچ رزروی برای این نشانی ندارد. این نشانی تنها در صورتی می‌توانست تخصیص داده شود که کلاینت برای آن رزرو می‌داشت.
.SS ALLOC_ENGINE_V4_REQUEST_PICK_ADDRESS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
client %1 hasn\(aqt specified an address \- picking available address from the pool
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام زمانی ثبت می‌شود که کلاینت هیچ نشانی ترجیحی را مشخص نکرده است (کلاینت همیشه باید این کار را انجام دهد، اما Kea سعی می‌کند انعطاف‌پذیر باشد). موتور تخصیص تلاش خواهد کرد تا نشانی در دسترسی را از استخر پویا انتخاب کرده و آن را به کلاینت تخصیص دهد.
.SS ALLOC_ENGINE_V4_REQUEST_REMOVE_LEASE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: removing previous client\(aqs lease %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام زمانی ثبت می‌شود که موتور تخصیص، اجارهٔ پیشین کلاینت را حذف می‌کند زیرا اجارهٔ جدیدی به کلاینت تخصیص یافته است.
.SS ALLOC_ENGINE_V4_REQUEST_USE_HR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
client %1 hasn\(aqt requested specific address, using reserved address %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام هنگامی صادر می‌شود که کلاینت هیچ نشانی مشخصی را درخواست نکرده است اما موتور تخصیص تشخیص داده که یک رزرو برای این کلاینت وجود دارد. موتور تخصیص تلاش خواهد کرد تا نشانی رزروشده را تخصیص دهد..SS ALLOC_ENGINE_V4_REUSE_EXPIRED_LEASE_DATA
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: reusing expired lease, updated lease information: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۵۵ ثبت می‌شود.
این پیام زمانی ثبت می‌شود که موتور تخصیص در حال استفادهٔ مجدد از یک
اجارهٔ موجود است. جزئیات اجارهٔ به‌روزشده چاپ می‌شوند.
آرگومان نخست شامل اطلاعات شناسایی کلاینت است.
.SS ALLOC_ENGINE_V6_ALLOC_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: error during attempt to allocate an IPv6 address: %2
.EE
.UNINDENT
.UNINDENT
.sp
هنگام تلاش برای تخصیص یک نشانی IPv6 خطایی رخ داد و دلیل شکست
در پیام درج شده است. سرور پیامی مبنی بر رد اجاره به کلاینت
بازمی‌گرداند. آرگومان نخست شامل اطلاعات شناسایی کلاینت است.
.SS ALLOC_ENGINE_V6_ALLOC_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: failed to allocate an IPv6 lease after %2 attempt(s)
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام هشدار قدیمی است که هنگام شکست موتور تخصیص در تخصیص
اجاره برای یک کلاینت صادر می‌شود. این پیام شامل تعداد تلاش‌های تخصیص
اجاره است که موتور قبل از انصراف انجام داده است. اگر تعداد تلاش‌ها 0 باشد،
به این دلیل که موتور نتوانسته است از هیچ‌یک از استخرها برای آن کلاینت خاص
استفاده کند، این پیام ثبت نمی‌شود. با وجود اینکه چندین گزارش با جزئیات بیشتر
پیش از این پیام می‌آیند، این پیام برای سازگاری با گذشته باقی مانده است.
این پیام ممکن است نشان‌دهندهٔ این باشد که استخر شما برای تعداد کلاینت‌هایی
که می‌خواهید به آن‌ها سرویس دهید بسیار کوچک است و باید گسترش یابد.
متناوباً، اگر می‌دانید که تعداد کلاینت‌های فعال به‌طور هم‌زمان کمتر از اجاره‌های
دردسترس شما است، ممکن است بخواهید طول عمر اجاره را کاهش دهید.
به این ترتیب، اجاره‌های تخصیص‌یافته به کلاینت‌هایی که دیگر در شبکه فعال
نیستند، زودتر دردسترس قرار می‌گیرند.
.SS ALLOC_ENGINE_V6_ALLOC_FAIL_CLASSES
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Failed to allocate an IPv6 address for client with classes: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی چاپ می‌شود که Kea در تخصیص نشانی ناموفق بوده
و بستهٔ کلاینت متعلق به یک یا چند کلاس است. عدم انتساب اجاره ممکن است
دلایل متعددی داشته باشد. یکی از آن‌ها می‌تواند وضعیتی باشد که در آن همهٔ
استخرها نیازمند تعلق بسته به کلاس‌های خاصی هستند و بستهٔ دریافتی به
هیچ‌یک از آن‌ها تعلق نداشته است. حالت دیگری که این اطلاعات می‌تواند در آن
مفید باشد، اشاره به این است که نشانی‌های استخر رزروشده برای یک کلاس معین
به پایان رسیده است. در صورت نمایش این پیام، می‌توانید اندازهٔ استخر و
تعاریف کلاس‌بندی را بررسی کنید.
.SS ALLOC_ENGINE_V6_ALLOC_FAIL_NO_POOLS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: no pools were available for the lease allocation
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که موتور تخصیص در تخصیص اجاره
ناموفق است، زیرا نتوانسته از هیچ‌یک از استخرهای پیکربندی‌شده برای آن
کلاینت خاص استفاده کند. همچنین این احتمال وجود دارد که تمام زیرشبکه‌هایی
که موتور تخصیص سعی کرده از آن‌ها نشانی اختصاص دهد، فاقد استخر نشانی
باشند. در این حالت، اگر مدیر سیستم انتظار دارد که به برخی کلاینت‌ها نشانی‌های
پویا اختصاص داده شود، این مسئله باید یک پیکربندی نادرست تلقی شود.
یک زیرشبکه تنها زمانی ممکن است فاقد هرگونه استخر باشد که قرار باشد به همهٔ
کلاینت‌ها اجاره‌های رزروشده اختصاص یابد.
فرض کنید زیرشبکه‌های متصل به یک شبکهٔ اشتراکی (shared network) یا یک
زیرشبکهٔ منفرد که کلاینت به آن تعلق دارد، دارای استخرهای پیکربندی‌شده هستند.
در این حالت، این پیام نشان‌دهندهٔ آن است که هیچ‌کدام از استخرها نتوانسته‌اند برای
کلاینت استفاده شوند زیرا کلاینت به کلاس‌های کلاینت مناسب تعلق ندارد.
.SS ALLOC_ENGINE_V6_ALLOC_FAIL_SHARED_NETWORK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: failed to allocate a lease in the shared network %2: %3 subnets have no available leases, %4 subnets have no matching pools
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که موتور تخصیص در تخصیص اجاره برای
یک کلاینت متصل به یک شبکهٔ اشتراکی (shared network) ناموفق باشد.
شبکهٔ اشتراکی باید حداقل شامل یک زیرشبکه باشد، اما معمولاً چندین زیرشبکه را
تجمیع می‌کند. این پیام گزارش نشان می‌دهد که موتور تخصیص نتوانسته است
هیچ اجارهٔ مناسبی را در هیچ‌یک از زیرشبکه‌های درون شبکهٔ اشتراکی بیابد
و تخصیص دهد.
آرگومان نخست شامل اطلاعات شناسایی کلاینت است. آرگومان دوم نام شبکهٔ
اشتراکی را مشخص می‌کند. دو آرگومان باقی‌مانده اطلاعات بیشتری ارائه می‌دهند
که برای اشکال‌زدایی دلیل عدم توانایی موتور تخصیص در انتساب اجاره مفید است.
موتور تخصیص تلاش می‌کند تا اجاره‌ها را از زیرشبکه‌های مختلف در شبکهٔ
اشتراکی تخصیص دهد، و ممکن است برای برخی از زیرشبکه‌ها با شکست مواجه
شود زیرا هیچ اجارهٔ دردسترسی در آن زیرشبکه‌ها وجود ندارد یا اجاره‌های آزاد
برای کلاینت‌های دیگر رزرو شده‌اند. تعداد چنین زیرشبکه‌هایی در آرگومان سوم
مشخص می‌شود. برای زیرشبکه‌های دیگر ممکن است تخصیص به این دلیل ناموفق
باشد که استخرهای آن‌ها برای آن کلاینت خاص دردسترس نیستند. این استخرها با
کلاس‌های کلاینتی محافظت می‌شوند که کلاینت عضو آن‌ها نیست. آرگومان چهارم
تعداد چنین زیرشبکه‌هایی را مشخص می‌کند. با بررسی مقادیر آرگومان‌های سوم و
چهارم، مدیر سیستم می‌تواند شرایطی را که در آن هیچ اجاره‌ای در برخی از استخرها
باقی نمانده است شناسایی کند. او همچنین می‌تواند پیکربندی‌های نادرست
کلاس‌بندی کلاینت را که باعث رد ارائهٔ سرویس به برخی کلاینت‌ها می‌شود،
تشخیص دهد..SS ALLOC_ENGINE_V6_ALLOC_FAIL_SUBNET
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: failed to allocate an IPv6 lease in the subnet %2, subnet\-id %3, shared network %4
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که موتور تخصیص در تخصیص یک اجاره (lease) برای کلاینت متصل به یک زیرشبکه با شکست مواجه شود. آرگومان نخست شامل اطلاعات شناسایی کلاینت است. آرگومان‌های دوم و سوم زیرشبکه را مشخص می‌کنند. آرگومان چهارم شبکهٔ اشتراکی (shared network) را مشخص می‌کند، در صورتی که زیرشبکه متعلق به یک شبکهٔ اشتراکی باشد.
دلایل متعددی برای شکست در تخصیص اجاره وجود دارد. یکی از آن‌ها ممکن است اتمام ظرفیت استخرها یا وجود رزروها برای اجاره‌های آزاد باشد. با این حال، در برخی موارد، ممکن است موتور تخصیص در یافتن یک استخر مناسب برای کلاینت ناموفق باشد؛ برای نمونه زمانی که استخرها تنها برای کلاس‌های کلاینت خاصی در دسترس هستند، اما کلاینت درخواست‌کننده متعلق به آن‌ها نیست. پیام‌های لاگ بعدی اطلاعات بیشتری را برای تفکیک بین این حالت‌های مختلف ارائه می‌دهند.
.SS ALLOC_ENGINE_V6_ALLOC_HR_LEASE_EXISTS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: lease type %2 for reserved address/prefix %3 already exists
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که موتور تخصیص تشخیص دهد اجاره مربوط به نشانی یا پیشوند IPv6 از پیش برای کلاینت تخصیص داده شده است و کلاینت می‌تواند به استفاده از آن ادامه دهد. آرگومان نخست شامل اطلاعات شناسایی کلاینت است.
.SS ALLOC_ENGINE_V6_ALLOC_LEASES_HR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
leases and static reservations found for client %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام زمانی ثبت می‌شود که موتور تخصیص در حین فرایند تخصیص اجاره‌ها برای کلاینت، اجاره‌های موجود و رزروهای ایستا (static reservations) را برای کلاینت پیدا کند. موتور تخصیص بررسی خواهد کرد که آیا اجاره‌های موجود با رزروها مطابقت دارند یا خیر. اجاره‌هایی که برای سایر کلاینت‌ها رزرو شده‌اند و اجاره‌هایی که برای این کلاینت رزرو نشده‌اند حذف خواهند شد. تمامی اجاره‌های منطبق با رزروها تمدید شده و بازگردانده می‌شوند.
.SS ALLOC_ENGINE_V6_ALLOC_LEASES_NO_HR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
no reservations found but leases exist for client %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام زمانی ثبت می‌شود که موتور تخصیص در حین فرایند تخصیص اجاره‌ها برای کلاینت باشد و هیچ رزرو ایستایی وجود نداشته باشد، اما اجاره(هایی) برای کلاینت موجود باشد. موتور تخصیص اجاره‌هایی را که برای سایر کلاینت‌ها رزرو شده‌اند حذف کرده و تمامی اجاره‌های باقی‌مانده را به کلاینت بازمی‌گرداند.
.SS ALLOC_ENGINE_V6_ALLOC_NO_LEASES_HR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
no leases found but reservations exist for client %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام زمانی ثبت می‌شود که موتور تخصیص در حین فرایند تخصیص اجاره‌ها برای کلاینت باشد. این موتور هیچ اجارهٔ موجودی برای این کلاینت نیافته است، اما به نظر می‌رسد کلاینت دارای رزروهای ایستا است. موتور تخصیص تلاش خواهد کرد منابع رزروشده را برای کلاینت تخصیص دهد.
.SS ALLOC_ENGINE_V6_ALLOC_NO_V6_HR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: unable to allocate reserved leases \- no IPv6 reservations
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام زمانی ثبت می‌شود که موتور تخصیص تشخیص دهد کلاینت هیچ رزرو IPv6 ندارد و بنابراین موتور تخصیص باید برای تخصیص اجاره‌ها از استخر پویا تلاش کند، یا در صورتی که هیچ اجاره‌ای قابل تخصیص نباشد، فرایند تخصیص را متوقف سازد. آرگومان نخست شامل اطلاعات شناسایی کلاینت است.
.SS ALLOC_ENGINE_V6_ALLOC_UNRESERVED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
no static reservations available \- trying to dynamically allocate leases for client %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که موتور تخصیص برای تخصیص اجاره‌ها از استخرهای پویا تلاش کند. این امر ممکن است ناشی از یکی از موارد زیر باشد:
(الف) هیچ رزروی برای این کلاینت وجود ندارد، (ب) رزروهایی برای کلاینت وجود دارد اما قابل استفاده نیستند زیرا نشانی‌ها توسط کلاینت دیگری در حال استفاده هستند، یا (ج) اجاره‌ای رزروشده وجود داشته اما اکنون به کلاینت دیگری تخصیص داده شده است.
.SS ALLOC_ENGINE_V6_CALCULATED_PREFERRED_LIFETIME
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: using a calculated preferred\-lifetime of %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که مقدار preferred\-lifetime بازگردانده‌شده به کلاینت، به‌طور پیش‌فرض روی ۶۲٫۵٪ از valid\-lifetime تنظیم می‌شود. این وضعیت ممکن است زمانی رخ دهد که preferred\-lifetime به‌طور صریح پیکربندی نشده باشد، یا مقدار پیکربندی‌شده بزرگ‌تر از valid\-lifetime باشد. آرگومان‌ها جزئیات کلاینت و preferred\-lifetime مورد استفاده را مشخص می‌کنند..SS ALLOC_ENGINE_V6_DECLINED_RECOVERED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
IPv6 address %1 was recovered after %2 seconds of probation\-period
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که نشانی مشخص‌شده به عنوان تکراری گزارش شده است (کلاینت پیام DECLINE ارسال کرده) و کارساز این نشانی را برای مدت معینی به عنوان غیرقابل دسترس علامت‌گذاری کرده بود. این مدت‌زمان اکنون سپری شده و نشانی به مخزن نشانی‌های در دسترس بازگردانده شده است. این مرحله، فرآیند بازیابی رد (decline recovery) را به پایان می‌رساند.
.SS ALLOC_ENGINE_V6_EXPIRED_HINT_RESERVED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: expired lease for the client\(aqs hint %2 is reserved for another client
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام زمانی ثبت می‌شود که موتور تخصیص (allocation engine) متوجه می‌شود اجارهٔ منقضی‌شده برای پیشنهاد (hint) کلاینت قابل استفادهٔ مجدد نیست، زیرا برای کلاینت دیگری رزرو شده است. آرگومان نخست شامل اطلاعات شناسایی کلاینت است.
.SS ALLOC_ENGINE_V6_EXTEND_ALLOC_UNRESERVED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
allocate new (unreserved) leases for the renewing client %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که موتور تخصیص در تلاش است تا اجاره‌های جدیدی را برای کلاینت در حال تمدید تخصیص دهد، زیرا نتوانسته هیچ‌یک از اجاره‌های موجود کلاینت را تمدید کند؛ برای مثال به دلیل اینکه اجاره‌ها برای کلاینت دیگری رزرو شده‌اند یا به هر دلیل دیگری.
.SS ALLOC_ENGINE_V6_EXTEND_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: allocation engine experienced error with attempting to extend lease lifetime: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که در حین پردازش Renew یا Rebind خطایی رخ داده است. توضیحات تکمیلی به همراه این پیام ارائه می‌شود. بسته به ماهیت خطا، ممکن است برای ادامهٔ پردازش پیام‌های این کلاینت خاص، به مداخلهٔ دستی نیاز باشد؛ سایر کلاینت‌ها تحت تأثیر قرار نخواهند گرفت. آرگومان نخست شامل اطلاعات شناسایی کلاینت است.
.SS ALLOC_ENGINE_V6_EXTEND_LEASE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: extending lifetime of the lease type %2, address %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که موتور تخصیص در حال تلاش برای افزایش طول عمر اجاره است. آرگومان نخست شامل اطلاعات شناسایی کلاینت است.
.SS ALLOC_ENGINE_V6_EXTEND_LEASE_DATA
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: detailed information about the lease being extended: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی اطلاعات تفصیلی را دربارهٔ اجاره‌ای که طول عمر آن در حال افزایش است (renew یا rebind) چاپ می‌کند. آرگومان نخست شامل اطلاعات شناسایی کلاینت است.
.SS ALLOC_ENGINE_V6_EXTEND_NEW_LEASE_DATA
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: new lease information for the lease being extended: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی اطلاعات به‌روزشده را دربارهٔ اجاره‌ای که قرار است تمدید شود چاپ می‌کند. در صورتی که به‌روزرسانی اجاره موفقیت‌آمیز باشد، اطلاعات چاپ‌شده توسط این پیام در پایگاه داده ذخیره خواهد شد. آرگومان نخست شامل اطلاعات شناسایی کلاینت است.
.SS ALLOC_ENGINE_V6_HINT_RESERVED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: lease for the client\(aqs hint %2 is reserved for another client
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام زمانی ثبت می‌شود که موتور تخصیص نمی‌تواند اجاره را با استفاده از پیشنهاد (hint) کلاینت تخصیص دهد، زیرا اجاره برای این پیشنهاد برای کلاینت دیگری رزرو شده است. آرگومان نخست شامل اطلاعات شناسایی کلاینت است.
.SS ALLOC_ENGINE_V6_HR_ADDR_GRANTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
reserved address %1 was assigned to client %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد نشانی که برای کلاینت مشخص‌شده رزرو شده بود، به آن اختصاص یافته است..SS ALLOC_ENGINE_V6_HR_PREFIX_GRANTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
reserved prefix %1/%2 was assigned to client %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که پیشوند رزرو شده برای کارخواه مشخص‌شده، به آن اختصاص یافته است.
.SS ALLOC_ENGINE_V6_LEASES_RECLAMATION_COMPLETE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
reclaimed %1 leases in %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی ثبت می‌شود که موتور تخصیص بازپس‌گیری مجموعه‌ای از اجاره‌های منقضی‌شده را به پایان برساند. بیشینه تعداد اجاره‌هایی که باید در یک دور از روال بازپس‌گیری اجاره‌ها بازپس گرفته شوند، با استفاده از پارامتر \(aqmax\-reclaim\-leases\(aq قابل پیکربندی است. با این حال، تعداد اجاره‌های بازپس‌گرفته‌شده ممکن است توسط مقدار مهلت زمانی (timeout) که با \(aqmax\-reclaim\-time\(aq پیکربندی شده نیز محدود شود. این پیام شامل تعداد اجاره‌های بازپس‌گرفته‌شده و کل زمان صرف‌شده است.
.SS ALLOC_ENGINE_V6_LEASES_RECLAMATION_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
reclamation of expired leases failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که بازپس‌گیری اجاره‌های منقضی‌شده ناموفق باشد.
پیام خطا نمایش داده می‌شود.
.SS ALLOC_ENGINE_V6_LEASES_RECLAMATION_SLOW
.INDENT 0.0
.INDENT 3.5
.sp
.EX
expired leases still exist after %1 reclamations
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که سرور نتواند تمام اجاره‌های منقضی‌شده را در تعداد مشخصی از تلاش‌های متوالی بازپس گیرد. این امر نشان می‌دهد که ممکن است مقدار \(dqreclaim\-timer\-wait\-time\(dq بیش از حد بالا باشد. با این حال، اگر این موضوع تنها یک افزایش ناگهانی و کوتاه‌مدت در انقضای اجاره‌ها باشد نیازی به تغییر این مقدار نیست و سرور باید در تلاش‌های بعدی بازپس‌گیری با آن رسیدگی کند. اگر این وضعیت نتیجه افزایش دائمی بار سرور است، مقدار \(dqreclaim\-timer\-wait\-time\(dq باید کاهش یابد، یا مقادیر \(dqmax\-reclaim\-leases\(dq و \(dqmax\-reclaim\-time\(dq باید افزایش یابند تا پردازش اجاره‌های بیشتری در یک چرخه امکان‌پذیر شود. روش دیگر این است که این مقادیر روی 0 تنظیم شوند تا محدودیت‌های مربوط به تعداد اجاره‌ها و مدت زمان حذف گردند. با این حال، این کار ممکن است منجر به دوره‌های طولانی‌تری از عدم پاسخگویی سرور به بسته‌های DHCP در زمان پردازش اجاره‌های منقضی‌شده شود.
.SS ALLOC_ENGINE_V6_LEASES_RECLAMATION_START
.INDENT 0.0
.INDENT 3.5
.sp
.EX
starting reclamation of expired leases (limit = %1 leases or %2 milliseconds)
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که موتور تخصیص بازپس‌گیری اجاره‌های منقضی‌شده را آغاز کند. بیشینه تعداد اجاره‌های قابل بازپس‌گیری و مهلت زمانی در پیام گنجانده شده‌اند. اگر هر یک از این مقادیر 0 باشد، به معنای \(dqنامحدود\(dq است.
.SS ALLOC_ENGINE_V6_LEASES_RECLAMATION_TIMEOUT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
timeout of %1 ms reached while reclaiming IPv6 leases
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که موتور تخصیص به مهلت زمانی تعیین‌شده برای انجام بازپس‌گیری اجاره‌های منقضی‌شده برسد. اکنون فرایند بازپس‌گیری متوقف خواهد شد و تمامی اجاره‌هایی که به دلیل پایان مهلت زمانی بازپس گرفته نشده‌اند، هنگام آغاز بازپس‌گیری زمان‌بندی‌شده بعدی بازپس گرفته خواهند شد. آرگومان، مقدار مهلت زمانی بیان‌شده بر حسب میلی‌ثانیه است.
.SS ALLOC_ENGINE_V6_LEASE_RECLAIM
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: reclaiming expired lease for prefix %2/%3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور بازپس‌گیری اجاره منقضی‌شده DHCPv6 را آغاز کند. اجاره بازپس‌گرفته‌شده ممکن است اجاره یک نشانی یا یک پیشوند واگذار شده (delegated prefix) باشد. آرگومان نخست، اطلاعات شناسایی کارخواه را ارائه می‌دهد. سایر آرگومان‌ها پیشوند و طول پیشوند را برای اجاره مشخص می‌کنند. طول پیشوند برای اجاره نشانی برابر با 128 است.
.SS ALLOC_ENGINE_V6_LEASE_RECLAMATION_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to reclaim the lease %1: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی ثبت می‌شود که موتور تخصیص در بازپس‌گیری یک اجاره منقضی‌شده با شکست مواجه شود. علت شکست در پیام گنجانده شده است. این خطا ممکن است در قلاب انقضای اجاره (lease expiration hook) یا هنگام انجام عملیات روی پایگاه‌داده اجاره‌ها رخ داده باشد..SS ALLOC_ENGINE_V6_NO_MORE_EXPIRED_LEASES
.INDENT 0.0
.INDENT 3.5
.sp
.EX
all expired leases have been reclaimed
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور همهٔ اجاره‌های منقضی‌شدهٔ
DHCPv6 موجود در پایگاه‌داده را بازپس‌گیری (reclaim) کند.
.SS ALLOC_ENGINE_V6_RECLAIMED_LEASES_DELETE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
begin deletion of reclaimed leases expired more than %1 seconds ago
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که موتور تخصیص (allocation engine)
حذف اجاره‌های بازپس‌گرفته‌شده‌ای را که بیش از تعداد ثانیه‌های مشخصی پیش
منقضی شده‌اند، آغاز کند. این عملیات به‌صورت دوره‌ای بر اساس پارامتر
\(dqflush\-reclaimed\-timer\-wait\-time\(dq راه‌اندازی می‌شود. پارامتر
\(dqhold\-reclaimed\-time\(dq مدت زمانی (بر حسب ثانیه) را تعیین می‌کند
که اجاره‌ها پیش از حذف شدن نهایی، نگهداری می‌شوند.
.SS ALLOC_ENGINE_V6_RECLAIMED_LEASES_DELETE_COMPLETE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
successfully deleted %1 expired\-reclaimed leases
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور اجاره‌های \(dqexpired\-reclaimed\(dq
را با موفقیت از پایگاه‌دادهٔ اجاره‌ها حذف کند. تعداد اجاره‌های حذف‌شده در پیام لاگ
گنجانده می‌شود.
.SS ALLOC_ENGINE_V6_RECLAIMED_LEASES_DELETE_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deletion of expired\-reclaimed leases failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که حذف اجاره‌های \(dqexpired\-reclaimed\(dq از
پایگاه‌داده با شکست مواجه شود. پیام خطا به انتهای پیام لاگ اضافه می‌شود.
.SS ALLOC_ENGINE_V6_RENEW_HR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
allocating leases reserved for the client %1 as a result of Renew
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که موتور تخصیص در پاسخ به پیام Renew
تلاش می‌کند اجاره‌های رزروشده را به کلاینت اختصاص دهد. سرور همچنین هر
اجاره‌ای را که کلاینت سعی در تمدید آن دارد اما برای آن رزرو نشده است،
حذف خواهد کرد.
.SS ALLOC_ENGINE_V6_RENEW_REMOVE_RESERVED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: checking if existing client\(aqs leases are reserved for another client
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام زمانی ثبت می‌شود که موتور تخصیص اجاره‌هایی برای کلاینت می‌یابد
و بررسی می‌کند که آیا این اجاره‌ها برای کلاینت دیگری رزرو شده‌اند یا خیر.
در صورت رزرو بودن، برای کلاینت درخواست‌کننده تمدید نخواهند شد. آرگومان اول
شامل اطلاعات شناسایی کلاینت است.
.SS ALLOC_ENGINE_V6_REUSE_EXPIRED_LEASE_DATA
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: reusing expired lease, updated lease information: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام زمانی ثبت می‌شود که موتور تخصیص در حال استفادهٔ مجدد از یک اجارهٔ
موجود است. جزئیات اجارهٔ به‌روزشده چاپ می‌شود. آرگومان اول شامل اطلاعات
شناسایی کلاینت است.
.SS ALLOC_ENGINE_V6_REVOKED_ADDR_LEASE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: address %2 was revoked from client %3 as it is reserved for client %4
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان‌دهندهٔ آن است که نشانی IPv6 مشخص‌شده توسط client A
استفاده می‌شده، اما اکنون برای client B رزرو شده است. به client A اعلام شده است
که استفاده از آن را متوقف کند تا بتوان آن را به client B اجاره داد. این یک رویداد
عادی هنگام رفع تعارض است که می‌تواند در مواردی مانند افزودن یک رزرو جدید توسط
مدیر سیستم برای نشانی‌ای که هم‌اکنون توسط کلاینت دیگری استفاده می‌شود، رخ دهد.
سرور وضعیت را به‌طور کامل مدیریت و بازیابی خواهد کرد، اما کلاینت‌ها نشانی‌های خود
را تغییر خواهند داد..SS ALLOC_ENGINE_V6_REVOKED_PREFIX_LEASE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: prefix %2/%3 was revoked from client %4 as it is reserved for client %5
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی نشان‌دهنده آن است که پیشوند IPv6 مشخص‌شده توسط کلاینت A در حال استفاده بود، اما اکنون برای کلاینت B رزرو شده است. به کلاینت A اعلام شده که استفاده از آن را متوقف کند تا بتوان آن را به کلاینت B اجاره داد. این یک رخداد عادی در حین رفع تداخل است که می‌تواند در مواردی مانند افزودن رزرو توسط مدیر سیستم برای نشانی‌ای که در حال حاضر توسط کلاینت دیگری استفاده می‌شود، رخ دهد. کارساز به‌طور کامل از این وضعیت بازیابی خواهد شد، اما کلاینت‌ها پیشوندهای خود را تغییر خواهند داد.
.SS ALLOC_ENGINE_V6_REVOKED_SHARED_ADDR_LEASE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: address %2 was revoked from client %3 as it is reserved for %4 other clients
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی نشان‌دهنده آن است که نشانی IPv6 مشخص‌شده توسط کلاینت A در حال استفاده بود، اما اکنون برای چندین کلاینت دیگر رزرو شده است. به کلاینت A اعلام شده که استفاده از آن را متوقف کند تا بتوان آن را به یکی از کلاینت‌هایی که برای آن رزرو دارند اجاره داد. این یک رخداد عادی در حین رفع تداخل است که می‌تواند در مواردی مانند افزودن رزروها توسط مدیر سیستم برای نشانی‌ای که در حال حاضر توسط کلاینت دیگری استفاده می‌شود، رخ دهد. کارساز به‌طور کامل از این وضعیت بازیابی خواهد شد، اما کلاینت‌ها نشانی‌های خود را تغییر خواهند داد.
.SS ALLOC_ENGINE_V6_REVOKED_SHARED_PREFIX_LEASE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: prefix %2/%3 was revoked from client %4 as it is reserved for %5 other clients
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی نشان‌دهنده آن است که پیشوند IPv6 مشخص‌شده توسط کلاینت A در حال استفاده بود، اما اکنون برای چندین کلاینت دیگر رزرو شده است. به کلاینت A اعلام شده که استفاده از آن را متوقف کند تا بتوان آن را به یکی از کلاینت‌هایی که برای آن رزرو دارند اجاره داد. این یک رخداد عادی در حین رفع تداخل است که می‌تواند در مواردی مانند افزودن رزروها توسط مدیر سیستم برای نشانی‌ای که در حال حاضر توسط کلاینت دیگری استفاده می‌شود، رخ دهد. کارساز به‌طور کامل از این وضعیت بازیابی خواهد شد، اما کلاینت‌ها پیشوندهای خود را تغییر خواهند داد.
.SS ASIODNS
.SS ASIODNS_FETCH_COMPLETED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
upstream fetch to %1(%2) has now completed
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۷۰ ثبت می‌شود.
یک پیام اشکال‌زدایی؛ این پیام ثبت می‌کند که واکشی بالادستی (پرس‌وجویی که توسط resolver از جانب کلاینت آن انجام می‌شود) به نشانی مشخص‌شده پایان یافته است.
.SS ASIODNS_FETCH_STOPPED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
upstream fetch to %1(%2) has been stopped
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
یک مؤلفه خارجی درخواست توقف یک واکشی بالادستی را داده است. این یک عملیات مجاز است و پیام تنها در صورتی باید ظاهر شود که اشکال‌زدایی فعال باشد.
.SS ASIODNS_OPEN_SOCKET
.INDENT 0.0
.INDENT 3.5
.sp
.EX
error %1 opening %2 socket to %3(%4)
.EE
.UNINDENT
.UNINDENT
.sp
کد ورودی/خروجی ناهمگام (asynchronous I/O) هنگام تلاش برای باز کردن یک سوکت با پروتکل مشخص‌شده به منظور ارسال یک پیام به نشانی هدف، با خطا مواجه شد. شماره خطای سیستمی که باعث این مشکل شده در پیام ذکر شده است.
.SS ASIODNS_READ_DATA
.INDENT 0.0
.INDENT 3.5
.sp
.EX
error %1 reading %2 data from %3(%4)
.EE
.UNINDENT
.UNINDENT
.sp
کد ورودی/خروجی ناهمگام (asynchronous I/O) هنگام تلاش برای خواندن داده‌ها از نشانی مشخص‌شده روی پروتکل داده‌شده، با خطا مواجه شد. شماره خطای سیستمی که باعث این مشکل شده در پیام ذکر شده است.
.SS ASIODNS_READ_TIMEOUT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
receive timeout while waiting for data from %1(%2)
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
مهلت زمانی یک واکشی بالادستی از نشانی مشخص‌شده به پایان رسید (timed out). این رویداد ممکن است به دلایل مختلفی رخ دهد و به احتمال زیاد مشکلی در کارساز دوردست یا مشکلی در شبکه است. این پیام تنها در صورتی ظاهر می‌شود که اشکال‌زدایی فعال باشد..SS ASIODNS_SEND_DATA
.INDENT 0.0
.INDENT 3.5
.sp
.EX
error %1 sending data using %2 to %3(%4)
.EE
.UNINDENT
.UNINDENT
.sp
کد I/O ناهمگام هنگام تلاش برای ارسال داده به نشانی مشخص‌شده روی پروتکل داده‌شده، با خطا مواجه شد. شماره خطای سیستمی که باعث بروز مشکل شده است در پیام ذکر می‌شود.
.SS ASIODNS_UNKNOWN_ORIGIN
.INDENT 0.0
.INDENT 3.5
.sp
.EX
unknown origin for ASIO error code %1 (protocol: %2, address %3)
.EE
.UNINDENT
.UNINDENT
.sp
یک بررسی سازگاری داخلی در مورد مبدأ پیامی از ماژول I/O ناهمگام با شکست مواجه شد. این موضوع ممکن است نشان‌دهنده یک خطای داخلی باشد؛ لطفاً یک گزارش باگ ارسال کنید.
.SS ASIODNS_UNKNOWN_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
unknown result (%1) when IOFetch::stop() was executed for I/O to %2(%3)
.EE
.UNINDENT
.UNINDENT
.sp
یک خطای داخلی که نشان می‌دهد متد خاتمه کلاس بازیابی بالادست (upstream fetch) مربوط به کارساز تحلیل‌گر (resolver) با یک کد نتیجه ناشناخته (که در پیام ذکر شده است) فراخوانی شده است. لطفاً یک گزارش باگ ارسال کنید.
.SS BAD
.SS BAD_CLIENT_CREDENTIALS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
bad client credentials: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که پردازش اعتبارنامه کلاینت با شکست مواجه شده باشد، از جمله زمانی که طول عمر باقی‌مانده اعتبارنامه از طول عمر TKEY کوتاه‌تر باشد. آرگومان، جزئیات خطا را شرح می‌دهد.
.SS BOOTP
.SS BOOTP_BOOTP_QUERY
.INDENT 0.0
.INDENT 3.5
.sp
.EX
recognized a BOOTP query: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی چاپ می‌شود که پرس‌وجوی BOOTP شناسایی شده باشد. کلاس کلاینت BOOTP اضافه شده و نوع پیام روی DHCPREQUEST تنظیم می‌شود. مشخصات کلاینتِ پرس‌وجو و شناسه تراکنش نمایش داده می‌شوند.
.SS BOOTP_LOAD
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Bootp hooks library has been loaded
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی (info) نشان می‌دهد که کتابخانه قلاب‌های Bootp بارگیری شده است.
.SS BOOTP_PACKET_OPTIONS_SKIPPED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
an error unpacking an option, caused subsequent options to be skipped: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که بازگشایی (unpack) یک گزینه با شکست مواجه شده و بازگشایی گزینه‌های باقی‌مانده در پرس‌وجوی DHCPv4 را غیرممکن سازد. کارساز همچنان برای پاسخ‌گویی به بسته تلاش خواهد کرد. تنها آرگومان، دلیل خطای بازگشایی را مشخص می‌کند.
.SS BOOTP_PACKET_PACK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: preparing on\-wire format of the packet to be sent
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارساز آماده‌سازی قالب انتقال روی سیم (on\-wire) بسته‌ای را که باید به کلاینت پس فرستاده شود، آغاز می‌کند. آرگومان، اطلاعات کلاینت و شناسه تراکنش را مشخص می‌کند.
.SS BOOTP_PACKET_PACK_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: preparing on\-wire\-format of the packet to be sent failed %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که آماده‌سازی قالب انتقال روی سیم (on\-wire) بسته ناموفق بوده باشد. آرگومان نخست، کلاینت و تراکنش BOOTP را مشخص می‌کند. آرگومان دوم شامل رشته خطا است..SS BOOTP_PACKET_UNPACK_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to parse query from %1 to %2, received over interface %3, reason: %4
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که پرس‌وجوی DHCPv4 دریافتی بدقواره (malformed) بوده و نتواند توسط فراخوان buffer4_receive تجزیه شود. پرس‌وجو توسط سرور دور انداخته خواهد شد. سه آرگومان نخست نشانی IP مبدأ، نشانی IP مقصد و رابط شبکه را مشخص می‌کنند. آرگومان پایانی دلیل شکست را بیان می‌کند.
.SS BOOTP_UNLOAD
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Bootp hooks library has been unloaded
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که کتابخانه قلاب‌های Bootp از حافظه تخلیه شده است.
.SS BULK
.SS BULK_LEASE_QUERY4_UNSUPPORTED_MSG_TYPE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Dropping packet with an unsupported DHCPv4 message type %1 received from: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که نوع بسته‌ای از DHCPv4 دریافت شود که قلاب پرس‌وجوی اجاره (lease query hook) از آن پشتیبانی نمی‌کند. آرگومان نخست نوع پیام پشتیبانی‌نشده و آرگومان دوم نشانی دوردست (remote address) اتصالی است که بسته خواهد شد.
.SS BULK_LEASE_QUERY6_UNSUPPORTED_MSG_TYPE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Dropping packet with an unsupported DHCPv6 message type %1 received from: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که نوع بسته‌ای از DHCPv6 دریافت شود که قلاب پرس‌وجوی اجاره (lease query hook) از آن پشتیبانی نمی‌کند. آرگومان نخست نوع پیام پشتیبانی‌نشده و آرگومان دوم نشانی دوردست (remote address) اتصالی است که بسته خواهد شد.
.SS BULK_LEASE_QUERY_AT_MAX_CONCURRENT_QUERIES
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Queuing query from: %1, details: %2, connection already has %3 queries in progress
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک درخواست‌کننده، یک پرس‌وجوی اجاره دسته‌ای (bulk lease query) را روی اتصالی ارسال کند که در حال حاضر حداکثر تعداد مجاز پرس‌وجوهای در حال انجام را دارد. آرگومان نخست نشانی درخواست‌کننده، دومی جزئیات پرس‌وجوی صف‌بندی‌شده و سومی مقدار max\-concurrent\-queries است.
.SS BULK_LEASE_QUERY_DEQUEUED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
A query from %1, details: %2, dequeued.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک پرس‌وجو از صف خارج شده و پردازش خواهد شد. آرگومان نخست نشانی درخواست‌کننده و آرگومان دوم جزئیات پرس‌وجویی است که از صف خارج شده است.
.SS BULK_LEASE_QUERY_DUPLICATE_XID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Dropping query from: %1, transaction id %2 is a duplicate
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که یک درخواست‌کننده، پرس‌وجوی اجاره دسته‌ای با همان شناسه تراکنش (transaction id) ارسال کند، در حالی که آن درخواست‌کننده هم‌اکنون پرس‌وجویی با همان شناسه تراکنش در حال انجام دارد. آرگومان نخست نشانی درخواست‌کننده و دومی شناسه تراکنش تکراری است.
.SS BULK_LEASE_QUERY_EMPTY_REQUEST
.INDENT 0.0
.INDENT 3.5
.sp
.EX
A bulk lease query packet received from %1 is empty.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که بسته پرس‌وجوی اجاره دسته‌ای فاقد بار داده (payload) دریافت شود. این آرگومان حاوی نشانی دوردست اتصالی است که بسته خواهد شد.
.SS BULK_LEASE_QUERY_INVALID_REQUEST
.INDENT 0.0
.INDENT 3.5
.sp
.EX
A bulk lease query packet received from %1 is invalid, query: %2, error: %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا هنگام دریافت بسته نامعتبر پرس‌وجوی اجاره دسته‌ای صادر می‌شود. آرگومان نخست نشانی دوردست اتصالی است که بسته خواهد شد، دومی پرس‌وجو، و آرگومان پایانی پیام خطا است..SS BULK_LEASE_QUERY_LISTENER_START_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Bulk lease query listener thread pool could not be started, error %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که استخر ریسه‌های شنونده‌ی bulk lease query نتواند پس از یک رخداد پیکربندی مجدد، (مجدداً) راه‌اندازی شود. محتمل‌ترین علت می‌تواند یک خطای پیکربندی در زمان اجرا باشد؛ مانند یک آدرس IP که نامعتبر است یا هم‌اکنون به عنوان آدرس سرویس در حال استفاده است. این آرگومان جزئیات خطا را شرح می‌دهد.
.SS BULK_LEASE_QUERY_PAUSE_CHECK_PERMISSIONS_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
An unexpected error occurred while checking pause permissions, error %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا هنگام تلاش برای متوقف کردن موقت (pause) شنونده‌ی Bulk Lease Query صادر می‌شود. رخ دادن این خطا بسیار دور از انتظار است و نشان‌دهنده‌ی یک اشکال برنامه‌نویسی است که باید به عنوان یک نقص گزارش شود.
.SS BULK_LEASE_QUERY_PAUSE_LISTENER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Listener could not be paused, error %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا هنگام تلاش برای متوقف کردن موقت (pause) شنونده‌ی Bulk Lease Query صادر می‌شود. رخ دادن این خطا بسیار دور از انتظار است و نشان‌دهنده‌ی یک اشکال برنامه‌نویسی است که باید به عنوان یک نقص گزارش شود.
.SS BULK_LEASE_QUERY_PAUSE_LISTENER_ILLEGAL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Pausing multi\-threaded processing failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا هنگام تلاش برای متوقف کردن موقت استخر ریسه‌های (thread pool) شنونده‌ی bulk lease query از طریق یک ریسه‌ی کارگر (worker thread) صادر می‌شود. این خطا نشان می‌دهد عملیاتی که روی ریسه‌ی شنونده آغاز شده، تلاش می‌کند از یک بخش بحرانی (critical section) استفاده کند که منجر به بن‌بست (dead\-lock) خواهد شد. رخ دادن این خطا بسیار دور از انتظار است و نشان‌دهنده‌ی یک اشکال برنامه‌نویسی است که باید به عنوان یک نقص گزارش شود.
.SS BULK_LEASE_QUERY_PROCESSING_UNEXPECTED_FAILURE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
A bulk lease query packet processing throws unexpected exception: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که پردازش بسته‌ی bulk lease query دچار استثنا (exception) شود. این استثنا نمایش داده می‌شود.
.SS BULK_LEASE_QUERY_QUERY_RECEIVED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
A bulk lease query packet received from %1, details: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک استعلام bulk lease query دریافت شده باشد. آرگومان نخست، آدرسی است که بسته را ارسال کرده و دومی جزئیات بسته را شرح می‌دهد.
.SS BULK_LEASE_QUERY_REJECTED_CONNECTION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
A new bulk lease query connection from %1 was rejected: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اشکال‌زدایی هنگامی صادر می‌شود که یک اتصال جدید bulk lease query رد شده باشد. آدرس کلاینت و پیام خطا نمایش داده می‌شوند.
.SS BULK_LEASE_QUERY_RESPONSE_SEND_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
A bulk lease query response could not be sent to: %1, response: %2, error: %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اشکال‌زدایی زمانی صادر می‌شود که تلاش سرور برای ارسال پاسخ استعلام با شکست مواجه شده باشد. آرگومان نخست، آدرسی است که پاسخ برای آن ارسال می‌شد، دومی حاوی جزئیات پاسخ است و سومی توضیح خطا می‌باشد.
.SS BULK_LEASE_QUERY_RESPONSE_SENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
A bulk lease query response sent to %1, details: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی صادر می‌شود که یک پاسخ bulk lease query ارسال شده باشد. آرگومان نخست، آدرسی است که بسته به آن ارسال شده و دومی جزئیات بسته را شرح می‌دهد..SS BULK_LEASE_QUERY_RESUME_LISTENER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Listener could not be resumed, error %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا هنگام تلاش برای ازسرگیری شنوندهٔ (listener) مربوط به Bulk Lease Query صادر می‌شود. وقوع این خطا بسیار بعید است و نشان‌دهندهٔ یک مشکل نرم‌افزاری است که باید به عنوان یک نقص (باگ) گزارش شود.
.SS BULK_LEASE_QUERY_UNPACK_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
A bulk lease query packet received from %1, could not be unpacked, error: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که بستهٔ پرس‌وجوی اجارهٔ انبوه (bulk lease query) دریافت‌شده ناقص یا معیوب (malformed) باشد و نتوان آن را بازگشایی کرد. آرگومان اول نشانی راه دور اتصالی است که بسته خواهد شد و آرگومان دوم شرح خطا را نشان می‌دهد.
.SS CB
.SS CB_CMDS_CLASS4_DEL_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-class4\-del command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهندهٔ آن است که گردانندهٔ (handler) دستور remote\-class4\-del هنگام پردازش دستور با شکست مواجه شده است. آرگومان، دلیل شکست را مشخص می‌کند.
.SS CB_CMDS_CLASS4_GET_ALL_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-class4\-get\-all command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهندهٔ آن است که گردانندهٔ دستور remote\-class4\-get\-all هنگام پردازش دستور با شکست مواجه شده است. آرگومان، دلیل شکست را مشخص می‌کند.
.SS CB_CMDS_CLASS4_GET_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-class4\-get command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهندهٔ آن است که گردانندهٔ دستور remote\-class4\-get هنگام پردازش دستور با شکست مواجه شده است. آرگومان، دلیل شکست را مشخص می‌کند.
.SS CB_CMDS_CLASS4_SET_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-class4\-set command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهندهٔ آن است که گردانندهٔ دستور remote\-class4\-set هنگام پردازش دستور با شکست مواجه شده است. آرگومان، دلیل شکست را مشخص می‌کند.
.SS CB_CMDS_CLASS6_DEL_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-class6\-del command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهندهٔ آن است که گردانندهٔ دستور remote\-class6\-del هنگام پردازش دستور با شکست مواجه شده است. آرگومان، دلیل شکست را مشخص می‌کند.
.SS CB_CMDS_CLASS6_GET_ALL_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-class6\-get\-all command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهندهٔ آن است که گردانندهٔ دستور remote\-class6\-get\-all هنگام پردازش دستور با شکست مواجه شده است. آرگومان، دلیل شکست را مشخص می‌کند.
.SS CB_CMDS_CLASS6_GET_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-class6\-get command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهندهٔ آن است که گردانندهٔ دستور remote\-class6\-get هنگام پردازش دستور با شکست مواجه شده است. آرگومان، دلیل شکست را مشخص می‌کند.
.SS CB_CMDS_CLASS6_SET_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-class6\-set command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهندهٔ آن است که گردانندهٔ دستور remote\-class6\-set هنگام پردازش دستور با شکست مواجه شده است. آرگومان، دلیل شکست را مشخص می‌کند..SS CB_CMDS_DEINIT_OK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
unloading cb_cmds hooks library successful
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که کتابخانه قلاب‌های Config Commands با موفقیت از حافظه تخلیه شده است.
.SS CB_CMDS_GLOBAL_PARAMETER4_DEL_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-global\-parameter4\-del command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که گرداننده دستور remote\-global\-parameter4\-del هنگام پردازش دستور با شکست مواجه شده است. این آرگومان دلیل شکست را مشخص می‌کند.
.SS CB_CMDS_GLOBAL_PARAMETER4_GET_ALL_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-global\-parameter4\-get\-all command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که گرداننده دستور remote\-global\-parameter4\-get\-all هنگام پردازش دستور با شکست مواجه شده است. این آرگومان دلیل شکست را مشخص می‌کند.
.SS CB_CMDS_GLOBAL_PARAMETER4_GET_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-global\-parameter4\-get command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که گرداننده دستور remote\-global\-parameter4\-get هنگام پردازش دستور با شکست مواجه شده است. این آرگومان دلیل شکست را مشخص می‌کند.
.SS CB_CMDS_GLOBAL_PARAMETER4_SET_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-global\-parameter4\-set command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که گرداننده دستور remote\-global\-parameter4\-set هنگام پردازش دستور با شکست مواجه شده است. این آرگومان دلیل شکست را مشخص می‌کند.
.SS CB_CMDS_GLOBAL_PARAMETER6_DEL_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-global\-parameter6\-del command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که گرداننده دستور remote\-global\-parameter6\-del هنگام پردازش دستور با شکست مواجه شده است. این آرگومان دلیل شکست را مشخص می‌کند.
.SS CB_CMDS_GLOBAL_PARAMETER6_GET_ALL_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-global\-parameter6\-get\-all command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که گرداننده دستور remote\-global\-parameter6\-get\-all هنگام پردازش دستور با شکست مواجه شده است. این آرگومان دلیل شکست را مشخص می‌کند.
.SS CB_CMDS_GLOBAL_PARAMETER6_GET_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-global\-parameter6\-get command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که گرداننده دستور remote\-global\-parameter6\-get هنگام پردازش دستور با شکست مواجه شده است. این آرگومان دلیل شکست را مشخص می‌کند.
.SS CB_CMDS_GLOBAL_PARAMETER6_SET_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-global\-parameter6\-set command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که گرداننده دستور remote\-global\-parameter6\-set هنگام پردازش دستور با شکست مواجه شده است. این آرگومان دلیل شکست را مشخص می‌کند.
.SS CB_CMDS_INIT_OK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
loading cb_cmds hooks library successful
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که کتابخانه قلاب‌های Config Commands با موفقیت بارگذاری شده است. لذت ببرید!.SS CB_CMDS_NETWORK4_DEL_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-network4\-del command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهنده آن است که گرداننده دستور remote\-network4\-del هنگام
پردازش دستور با شکست مواجه شده است. آرگومان ارائه‌شده دلیل شکست را مشخص می‌کند.
.SS CB_CMDS_NETWORK4_GET_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-network4\-get command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهنده آن است که گرداننده دستور remote\-network4\-get هنگام
پردازش دستور با شکست مواجه شده است. آرگومان ارائه‌شده دلیل شکست را مشخص می‌کند.
.SS CB_CMDS_NETWORK4_LIST_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-network4\-list command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهنده آن است که گرداننده دستور remote\-network4\-list هنگام
پردازش دستور با شکست مواجه شده است. آرگومان ارائه‌شده دلیل شکست را مشخص می‌کند.
.SS CB_CMDS_NETWORK4_SET_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-network4\-set command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهنده آن است که گرداننده دستور remote\-network4\-set هنگام
پردازش دستور با شکست مواجه شده است. آرگومان ارائه‌شده دلیل شکست را مشخص می‌کند.
.SS CB_CMDS_NETWORK6_DEL_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-network6\-del command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهنده آن است که گرداننده دستور remote\-network6\-del هنگام
پردازش دستور با شکست مواجه شده است. آرگومان ارائه‌شده دلیل شکست را مشخص می‌کند.
.SS CB_CMDS_NETWORK6_GET_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-network6\-get command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهنده آن است که گرداننده دستور remote\-network6\-get هنگام
پردازش دستور با شکست مواجه شده است. آرگومان ارائه‌شده دلیل شکست را مشخص می‌کند.
.SS CB_CMDS_NETWORK6_LIST_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-network6\-list command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهنده آن است که گرداننده دستور remote\-network6\-list هنگام
پردازش دستور با شکست مواجه شده است. آرگومان ارائه‌شده دلیل شکست را مشخص می‌کند.
.SS CB_CMDS_NETWORK6_SET_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-network6\-set command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهنده آن است که گرداننده دستور remote\-network6\-set هنگام
پردازش دستور با شکست مواجه شده است. آرگومان ارائه‌شده دلیل شکست را مشخص می‌کند.
.SS CB_CMDS_OPTION4_GLOBAL_DEL_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-global\-option4\-del command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهنده آن است که گرداننده دستور remote\-global\-option4\-del
هنگام پردازش دستور با شکست مواجه شده است. آرگومان ارائه‌شده دلیل شکست را
مشخص می‌کند.
.SS CB_CMDS_OPTION4_GLOBAL_GET_ALL_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-global\-option4\-get\-all command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهنده آن است که گرداننده دستور remote\-global\-option4\-get\-all
هنگام پردازش دستور با شکست مواجه شده است. آرگومان ارائه‌شده دلیل شکست را
مشخص می‌کند..SS CB_CMDS_OPTION4_GLOBAL_GET_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-global\-option4\-get command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا بیانگر آن است که گردانندهٔ دستور remote\-global\-option4\-get
در حین پردازش دستور با شکست مواجه شده است. آرگومان، علت شکست
را مشخص می‌کند.
.SS CB_CMDS_OPTION4_GLOBAL_SET_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-global\-option4\-set command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا بیانگر آن است که گردانندهٔ دستور remote\-global\-option4\-set
در حین پردازش دستور با شکست مواجه شده است. آرگومان، علت شکست
را مشخص می‌کند.
.SS CB_CMDS_OPTION4_NETWORK_DEL_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-network\-option4\-del command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا بیانگر آن است که گردانندهٔ دستور remote\-network\-option4\-del
در حین پردازش دستور با شکست مواجه شده است. آرگومان، علت شکست
را مشخص می‌کند.
.SS CB_CMDS_OPTION4_NETWORK_SET_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-network\-option4\-set command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا بیانگر آن است که گردانندهٔ دستور remote\-network\-option4\-set
در حین پردازش دستور با شکست مواجه شده است. آرگومان، علت شکست
را مشخص می‌کند.
.SS CB_CMDS_OPTION4_POOL_DEL_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-pool\-option4\-del command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا بیانگر آن است که گردانندهٔ دستور remote\-pool\-option4\-del
در حین پردازش دستور با شکست مواجه شده است. آرگومان، علت شکست
را مشخص می‌کند.
.SS CB_CMDS_OPTION4_POOL_SET_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-pool\-option4\-set command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا بیانگر آن است که گردانندهٔ دستور remote\-pool\-option4\-set
در حین پردازش دستور با شکست مواجه شده است. آرگومان، علت شکست
را مشخص می‌کند.
.SS CB_CMDS_OPTION4_SUBNET_DEL_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-subnet\-option4\-del command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا بیانگر آن است که گردانندهٔ دستور remote\-subnet\-option4\-del
در حین پردازش دستور با شکست مواجه شده است. آرگومان، علت شکست
را مشخص می‌کند.
.SS CB_CMDS_OPTION4_SUBNET_SET_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-subnet\-option4\-set command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا بیانگر آن است که گردانندهٔ دستور remote\-subnet\-option4\-set
در حین پردازش دستور با شکست مواجه شده است. آرگومان، علت شکست
را مشخص می‌کند.
.SS CB_CMDS_OPTION6_GLOBAL_DEL_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-global\-option6\-del command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا بیانگر آن است که گردانندهٔ دستور remote\-global\-option6\-del
در حین پردازش دستور با شکست مواجه شده است. آرگومان، علت شکست
را مشخص می‌کند.
.SS CB_CMDS_OPTION6_GLOBAL_GET_ALL_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-global\-option6\-get\-all command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا بیانگر آن است که گردانندهٔ دستور remote\-global\-option6\-get\-all
در حین پردازش دستور با شکست مواجه شده است. آرگومان، علت شکست
را مشخص می‌کند..SS CB_CMDS_OPTION6_GLOBAL_GET_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-global\-option6\-get command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که گرداننده دستور remote\-global\-option6\-get هنگام پردازش دستور ناموفق بوده است. آرگومان، دلیل شکست را ارائه می‌دهد.
.SS CB_CMDS_OPTION6_GLOBAL_SET_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-global\-option6\-set command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که گرداننده دستور remote\-global\-option6\-set هنگام پردازش دستور ناموفق بوده است. آرگومان، دلیل شکست را ارائه می‌دهد.
.SS CB_CMDS_OPTION6_NETWORK_DEL_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-network\-option6\-del command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که گرداننده دستور remote\-network\-option6\-del هنگام پردازش دستور ناموفق بوده است. آرگومان، دلیل شکست را ارائه می‌دهد.
.SS CB_CMDS_OPTION6_NETWORK_SET_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-network\-option6\-set command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که گرداننده دستور remote\-network\-option6\-set هنگام پردازش دستور ناموفق بوده است. آرگومان، دلیل شکست را ارائه می‌دهد.
.SS CB_CMDS_OPTION6_PD_POOL_DEL_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-pd\-pool\-option6\-del command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که گرداننده دستور remote\-pd\-pool\-option6\-del هنگام پردازش دستور ناموفق بوده است. آرگومان، دلیل شکست را ارائه می‌دهد.
.SS CB_CMDS_OPTION6_PD_POOL_SET_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-pd\-pool\-option6\-set command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که گرداننده دستور remote\-pd\-pool\-option6\-set هنگام پردازش دستور ناموفق بوده است. آرگومان، دلیل شکست را ارائه می‌دهد.
.SS CB_CMDS_OPTION6_POOL_DEL_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-pool\-option6\-del command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که گرداننده دستور remote\-pool\-option6\-del هنگام پردازش دستور ناموفق بوده است. آرگومان، دلیل شکست را ارائه می‌دهد.
.SS CB_CMDS_OPTION6_POOL_SET_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-pool\-option6\-set command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که گرداننده دستور remote\-pool\-option6\-set هنگام پردازش دستور ناموفق بوده است. آرگومان، دلیل شکست را ارائه می‌دهد.
.SS CB_CMDS_OPTION6_SUBNET_DEL_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-subnet\-option6\-del command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که گرداننده دستور remote\-subnet\-option6\-del هنگام پردازش دستور ناموفق بوده است. آرگومان، دلیل شکست را ارائه می‌دهد.
.SS CB_CMDS_OPTION6_SUBNET_SET_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-subnet\-option6\-set command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که گرداننده دستور remote\-subnet\-option6\-set هنگام پردازش دستور ناموفق بوده است. آرگومان، دلیل شکست را ارائه می‌دهد..SS CB_CMDS_OPTION_DEF4_DEL_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-option\-def4\-del command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا برای نشان دادن این صادر می‌شود که گرداننده دستور remote\-option\-def4\-del هنگام پردازش دستور با شکست مواجه شده است. آرگومان ارائه‌شده دلیل شکست را مشخص می‌کند.
.SS CB_CMDS_OPTION_DEF4_GET_ALL_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-option\-def4\-get\-all command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا برای نشان دادن این صادر می‌شود که گرداننده دستور remote\-option\-def4\-get\-all هنگام پردازش دستور با شکست مواجه شده است. آرگومان ارائه‌شده دلیل شکست را مشخص می‌کند.
.SS CB_CMDS_OPTION_DEF4_GET_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-option\-def4\-get command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا برای نشان دادن این صادر می‌شود که گرداننده دستور remote\-option\-def4\-get هنگام پردازش دستور با شکست مواجه شده است. آرگومان ارائه‌شده دلیل شکست را مشخص می‌کند.
.SS CB_CMDS_OPTION_DEF4_SET_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-option\-def4\-set command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا برای نشان دادن این صادر می‌شود که گرداننده دستور remote\-option\-def4\-set هنگام پردازش دستور با شکست مواجه شده است. آرگومان ارائه‌شده دلیل شکست را مشخص می‌کند.
.SS CB_CMDS_OPTION_DEF6_DEL_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-option\-def6\-del command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا برای نشان دادن این صادر می‌شود که گرداننده دستور remote\-option\-def6\-del هنگام پردازش دستور با شکست مواجه شده است. آرگومان ارائه‌شده دلیل شکست را مشخص می‌کند.
.SS CB_CMDS_OPTION_DEF6_GET_ALL_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-option\-def6\-get\-all command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا برای نشان دادن این صادر می‌شود که گرداننده دستور remote\-option\-def6\-get\-all هنگام پردازش دستور با شکست مواجه شده است. آرگومان ارائه‌شده دلیل شکست را مشخص می‌کند.
.SS CB_CMDS_OPTION_DEF6_GET_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-option\-def6\-get command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا برای نشان دادن این صادر می‌شود که گرداننده دستور remote\-option\-def6\-get هنگام پردازش دستور با شکست مواجه شده است. آرگومان ارائه‌شده دلیل شکست را مشخص می‌کند.
.SS CB_CMDS_OPTION_DEF6_SET_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-option\-def6\-set command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا برای نشان دادن این صادر می‌شود که گرداننده دستور remote\-option\-def6\-set هنگام پردازش دستور با شکست مواجه شده است. آرگومان ارائه‌شده دلیل شکست را مشخص می‌کند.
.SS CB_CMDS_SERVER4_DEL_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-server4\-del command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا برای نشان دادن این صادر می‌شود که گرداننده دستور remote\-server4\-del هنگام پردازش دستور با شکست مواجه شده است. آرگومان ارائه‌شده دلیل شکست را مشخص می‌کند.
.SS CB_CMDS_SERVER4_GET_ALL_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-server4\-get\-all command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا برای نشان دادن این صادر می‌شود که گرداننده دستور remote\-server4\-get\-all هنگام پردازش دستور با شکست مواجه شده است. آرگومان ارائه‌شده دلیل شکست را مشخص می‌کند..SS CB_CMDS_SERVER4_GET_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-server4\-get command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهندهٔ آن است که گردانندهٔ دستور remote\-server4\-get
هنگام پردازش دستور با شکست مواجه شده است. این آرگومان دلیل شکست را
ارائه می‌دهد.
.SS CB_CMDS_SERVER4_SET_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-server4\-set command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهندهٔ آن است که گردانندهٔ دستور remote\-server4\-set
هنگام پردازش دستور با شکست مواجه شده است. این آرگومان دلیل شکست را
ارائه می‌دهد.
.SS CB_CMDS_SERVER6_DEL_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-server6\-del command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهندهٔ آن است که گردانندهٔ دستور remote\-server6\-del
هنگام پردازش دستور با شکست مواجه شده است. این آرگومان دلیل شکست را
ارائه می‌دهد.
.SS CB_CMDS_SERVER6_GET_ALL_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-server6\-get\-all command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهندهٔ آن است که گردانندهٔ دستور remote\-server6\-get\-all
هنگام پردازش دستور با شکست مواجه شده است. این آرگومان دلیل شکست را
ارائه می‌دهد.
.SS CB_CMDS_SERVER6_GET_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-server6\-get command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهندهٔ آن است که گردانندهٔ دستور remote\-server6\-get
هنگام پردازش دستور با شکست مواجه شده است. این آرگومان دلیل شکست را
ارائه می‌دهد.
.SS CB_CMDS_SERVER6_SET_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-server6\-set command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهندهٔ آن است که گردانندهٔ دستور remote\-server6\-set
هنگام پردازش دستور با شکست مواجه شده است. این آرگومان دلیل شکست را
ارائه می‌دهد.
.SS CB_CMDS_SUBNET4_DEL_BY_ID_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-subnet4\-del\-by\-id command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهندهٔ آن است که گردانندهٔ دستور remote\-subnet4\-del\-by\-id
هنگام پردازش دستور با شکست مواجه شده است. این آرگومان دلیل شکست را
ارائه می‌دهد.
.SS CB_CMDS_SUBNET4_DEL_BY_PREFIX_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-subnet4\-del\-by\-prefix command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهندهٔ آن است که گردانندهٔ دستور remote\-subnet4\-del\-by\-prefix
هنگام پردازش دستور با شکست مواجه شده است. این آرگومان دلیل شکست را
ارائه می‌دهد.
.SS CB_CMDS_SUBNET4_GET_BY_ID_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-subnet4\-get\-by\-id command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهندهٔ آن است که گردانندهٔ دستور remote\-subnet4\-get\-by\-id
هنگام پردازش دستور با شکست مواجه شده است. این آرگومان دلیل شکست را
ارائه می‌دهد.
.SS CB_CMDS_SUBNET4_GET_BY_PREFIX_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-subnet4\-get\-by\-prefix command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهندهٔ آن است که گردانندهٔ دستور remote\-subnet4\-get\-by\-prefix
هنگام پردازش دستور با شکست مواجه شده است. این آرگومان دلیل شکست را
ارائه می‌دهد..SS CB_CMDS_SUBNET4_LIST_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-subnet4\-list command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا به این منظور صادر می‌شود که نشان دهد گردانندهٔ دستور remote\-subnet4\-list
هنگام پردازش دستور با شکست مواجه شده است. آرگومان،
دلیل این شکست را مشخص می‌کند.
.SS CB_CMDS_SUBNET4_SET_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-subnet4\-set command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا به این منظور صادر می‌شود که نشان دهد گردانندهٔ دستور remote\-subnet4\-set
هنگام پردازش دستور با شکست مواجه شده است. آرگومان، دلیل این
شکست را مشخص می‌کند.
.SS CB_CMDS_SUBNET6_DEL_BY_ID_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-subnet6\-del\-by\-id command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا به این منظور صادر می‌شود که نشان دهد گردانندهٔ دستور remote\-subnet6\-del\-by\-id
هنگام پردازش دستور با شکست مواجه شده است. آرگومان،
دلیل این شکست را مشخص می‌کند.
.SS CB_CMDS_SUBNET6_DEL_BY_PREFIX_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-subnet6\-del\-by\-prefix command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا به این منظور صادر می‌شود که نشان دهد گردانندهٔ دستور remote\-subnet6\-del\-by\-prefix
هنگام پردازش دستور با شکست مواجه شده است. آرگومان،
دلیل این شکست را مشخص می‌کند.
.SS CB_CMDS_SUBNET6_GET_BY_ID_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-subnet6\-get\-by\-id command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا به این منظور صادر می‌شود که نشان دهد گردانندهٔ دستور remote\-subnet6\-get\-by\-id
هنگام پردازش دستور با شکست مواجه شده است. آرگومان،
دلیل این شکست را مشخص می‌کند.
.SS CB_CMDS_SUBNET6_GET_BY_PREFIX_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-subnet6\-get\-by\-prefix command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا به این منظور صادر می‌شود که نشان دهد گردانندهٔ دستور remote\-subnet6\-get\-by\-prefix
هنگام پردازش دستور با شکست مواجه شده است. آرگومان،
دلیل این شکست را مشخص می‌کند.
.SS CB_CMDS_SUBNET6_LIST_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-subnet6\-list command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا به این منظور صادر می‌شود که نشان دهد گردانندهٔ دستور remote\-subnet6\-list
هنگام پردازش دستور با شکست مواجه شده است. آرگومان،
دلیل این شکست را مشخص می‌کند.
.SS CB_CMDS_SUBNET6_SET_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
remote\-subnet6\-set command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا به این منظور صادر می‌شود که نشان دهد گردانندهٔ دستور remote\-subnet6\-set
هنگام پردازش دستور با شکست مواجه شده است. آرگومان، دلیل این
شکست را مشخص می‌کند.
.SS CLASS
.SS CLASS_CMDS_CLASS_ADD
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class added: %1
.EE
.UNINDENT
.UNINDENT
.sp
دستور class\-add با موفقیت اجرا شد. تعریف کلاس
اضافه‌شده در لاگ ثبت می‌شود.
.SS CLASS_CMDS_CLASS_ADD_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to add a new class: %1
.EE
.UNINDENT
.UNINDENT
.sp
دستور class\-add با شکست مواجه شد. علت شکست
درون پیام خطا ارائه شده است..SS CLASS_CMDS_CLASS_ADD_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to run handler for \(aqclass\-add\(aq command
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی در گزارش ثبت می‌شود که کتابخانه قلاب‌های class_cmds با یک خطای غیرمنتظره مواجه شود و اجرای گردانندهٔ دستور \(aqclass\-add\(aq با شکست مواجه گردد.
.SS CLASS_CMDS_CLASS_DEL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class deleted: %1
.EE
.UNINDENT
.UNINDENT
.sp
دستور class\-del موفقیت‌آمیز بوده است. نام کلاس حذف‌شده در گزارش ثبت می‌شود.
.SS CLASS_CMDS_CLASS_DEL_EMPTY
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class not deleted (not found): %1
.EE
.UNINDENT
.UNINDENT
.sp
دستور class\-del هیچ کلاس منطبقی پیدا نکرد. نام کلاسی که قرار بود حذف شود در گزارش ثبت می‌شود.
.SS CLASS_CMDS_CLASS_DEL_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to delete a class: %1
.EE
.UNINDENT
.UNINDENT
.sp
دستور class\-del با شکست مواجه شد. علت شکست در پیام خطا ذکر شده است.
.SS CLASS_CMDS_CLASS_DEL_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to run handler for \(aqclass\-del\(aq command
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی در گزارش ثبت می‌شود که کتابخانه قلاب‌های class_cmds با یک خطای غیرمنتظره مواجه شود و اجرای گردانندهٔ دستور \(aqclass\-del\(aq با شکست مواجه گردد.
.SS CLASS_CMDS_CLASS_GET
.INDENT 0.0
.INDENT 3.5
.sp
.EX
successfully retrieved a class: %1
.EE
.UNINDENT
.UNINDENT
.sp
دستور class\-get موفقیت‌آمیز بوده است. نام کلاس دریافت‌شده در گزارش ثبت می‌شود.
.SS CLASS_CMDS_CLASS_GET_EMPTY
.INDENT 0.0
.INDENT 3.5
.sp
.EX
specified class was not found: %1
.EE
.UNINDENT
.UNINDENT
.sp
دستور class\-get هیچ کلاس منطبقی پیدا نکرد. نام کلاس جست‌وجوشده در گزارش ثبت می‌شود.
.SS CLASS_CMDS_CLASS_GET_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to retrieve a class: %1
.EE
.UNINDENT
.UNINDENT
.sp
دستور class\-get با شکست مواجه شد. علت شکست در پیام خطا ذکر شده است.
.SS CLASS_CMDS_CLASS_GET_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to run handler for \(aqclass\-get\(aq command
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی در گزارش ثبت می‌شود که کتابخانه قلاب‌های class_cmds با یک خطای غیرمنتظره مواجه شود و اجرای گردانندهٔ دستور \(aqclass\-get\(aq با شکست مواجه گردد.
.SS CLASS_CMDS_CLASS_LIST
.INDENT 0.0
.INDENT 3.5
.sp
.EX
successfully retrieved classes names
.EE
.UNINDENT
.UNINDENT
.sp
دستور class\-list موفقیت‌آمیز بوده است.
.SS CLASS_CMDS_CLASS_LIST_EMPTY
.INDENT 0.0
.INDENT 3.5
.sp
.EX
no class was found
.EE
.UNINDENT
.UNINDENT
.sp
دستور class\-list هیچ کلاسی پیدا نکرد..SS CLASS_CMDS_CLASS_LIST_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to retrieve classes names: %1
.EE
.UNINDENT
.UNINDENT
.sp
دستور class\-list با شکست مواجه شد. علت شکست در متن پیام خطا ارائه شده است.
.SS CLASS_CMDS_CLASS_LIST_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to run handler for \(aqclass\-list\(aq command
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی ثبت می‌شود که کتابخانه قلاب‌های class_cmds با خطایی غیرمنتظره در هنگام شکست اجرای گرداننده (handler) دستور \(aqclass\-list\(aq مواجه شود.
.SS CLASS_CMDS_CLASS_UPDATE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class updated: %1
.EE
.UNINDENT
.UNINDENT
.sp
دستور class\-update با موفقیت انجام شد. پارامترهای کلاس به‌روزشده ثبت می‌شوند.
.SS CLASS_CMDS_CLASS_UPDATE_EMPTY
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class not updated (not found): %1
.EE
.UNINDENT
.UNINDENT
.sp
دستور class\-update هیچ کلاس منطبقی پیدا نکرد. نام کلاسی که قرار بود به‌روزرسانی شود ثبت می‌شود.
.SS CLASS_CMDS_CLASS_UPDATE_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to update a class: %1
.EE
.UNINDENT
.UNINDENT
.sp
دستور class\-update با شکست مواجه شد. علت شکست در متن پیام خطا ارائه شده است.
.SS CLASS_CMDS_CLASS_UPDATE_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to run handler for \(aqclass\-update\(aq command
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی ثبت می‌شود که کتابخانه قلاب‌های class_cmds با خطایی غیرمنتظره در هنگام شکست اجرای گرداننده دستور \(aqclass\-update\(aq مواجه شود.
.SS CLASS_CMDS_DEINIT_OK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
unloading Class Commands hooks library successful
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که کتابخانه قلاب‌های Class Commands با موفقیت حذف شده است.
.SS CLASS_CMDS_INIT_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
loading Class Commands hooks library failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهنده بروز خطا در بارگذاری کتابخانه قلاب‌های Class Commands است. جزئیات خطا به عنوان آرگومان پیام ثبت گزارش ارائه شده است.
.SS CLASS_CMDS_INIT_OK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
loading Class Commands hooks library successful
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که کتابخانه قلاب‌های Class Commands با موفقیت بارگذاری شده است. لذت ببرید!
.SS COMMAND
.SS COMMAND_ACCEPTOR_START
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Starting to accept connections via unix domain socket bound to %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی زمانی صادر می‌شود که کارگزار Kea یک پذیرنده (acceptor) را راه‌اندازی می‌کند که از طریق آن اتصالات کنترلی جدید را خواهد پذیرفت. این پذیرنده به نقطه پایانی مرتبط با نام فایل ارائه‌شده به عنوان آرگومان، متصل (bound) می‌شود. در صورتی که شروع به کار پذیرنده با شکست مواجه شود، پیام‌های خطای بعدی علت شکست را ارائه خواهند داد..SS COMMAND_DEREGISTERED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Command %1 deregistered
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ debug ۱۰ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که دیمن (daemon) پشتیبانی از دستور مشخص‌شده را
متوقف کرده است. این دستور دیگر قابل اجرا نیست. اگر سوکت دستورات باز باشد و این
دستور صادر شود، دیمن قادر به پردازش آن نخواهد بود.
.SS COMMAND_EXTENDED_REGISTERED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Command %1 registered
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ debug ۱۰ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که دیمن پشتیبانی از دستور مشخص‌شده را آغاز کرده
است. گردانندهٔ (handler) دستور ثبت‌شده شامل پارامتری است که کل دستورِ آماده برای
پردازش را در خود نگه می‌دارد.
.SS COMMAND_HTTP_LISTENER_COMMAND_REJECTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Command HTTP listener rejected command \(aq%1\(aq from \(aq%2\(aq
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ debug ۱۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که دستوری رد شده باشد. آرگومان‌ها جزئیات
دستور و نشانی‌ای که درخواست از آن دریافت شده است را مشخص می‌کنند.
.SS COMMAND_HTTP_LISTENER_STARTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Command HTTP listener started with %1 threads, listening on address: %2 port: %3, use TLS: %4
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ debug ۱۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک شنوندهٔ HTTP برای پذیرش اتصالات
از کلاینت‌های Command API آغاز به کار کرده باشد که از طریق آن دستورات دریافت
و پاسخ‌ها ارسال می‌شوند. آرگومان‌ها تعداد ریسه‌هایی (threads) که شنونده استفاده
می‌کند، نشانی و درگاهی (port) که روی آن گوش می‌دهد، و استفاده یا عدم استفاده
از HTTPS/TLS را شرح می‌دهند.
.SS COMMAND_HTTP_LISTENER_STOPPED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Command HTTP listener for address: %1 port: %2 stopped.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ debug ۱۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که شنوندهٔ HTTP دستورات که روی نشانی
و درگاه داده‌شده گوش می‌داد، فرایند خاموش‌سازی را تکمیل کرده باشد.
.SS COMMAND_HTTP_LISTENER_STOPPING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Stopping Command HTTP listener for address: %1 port: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ debug ۱۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که شنوندهٔ HTTP دستورات که روی نشانی
و درگاه داده‌شده گوش می‌دهد، فرایند خاموش‌سازی را آغاز کرده باشد.
.SS COMMAND_HTTP_SOCKET_SECURITY_WARNING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
command socket configuration is NOT SECURE: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که اعمال تدابیر امنیتی غیرفعال باشد و
پیکربندی سوکت دستورات از HTTPS/TLS یا احراز هویت اولیهٔ HTTP استفاده نکند.
سرور همچنان طبق پیکربندی از سوکت استفاده خواهد کرد، اما هشدار می‌دهد که
انجام این کار ممکن است خطرات امنیتی به همراه داشته باشد.
.SS COMMAND_PROCESS_ERROR1
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Error while processing command: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار نشان می‌دهد که سرور هنگام پردازش دستور دریافت‌شده با خطایی مواجه
شده است. در صورت در دسترس بودن، اطلاعات تکمیلی ارائه خواهد شد. پیام‌های لاگ
بیشتر ممکن است جزئیات بیشتری فراهم کنند.
.SS COMMAND_PROCESS_ERROR2
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Error while processing command: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار نشان می‌دهد که سرور هنگام پردازش دستور دریافت‌شده با خطایی مواجه
شده است. تفاوت این پیام در مقایسه با COMMAND_PROCESS_ERROR1 این است که دستور اولیه
ساختار صحیحی داشته و خطا در حین پردازش منطقی رخ داده است، نه در زمان تجزیهٔ
(parsing) دستور. در صورت وجود، اطلاعات تکمیلی ارائه خواهد شد. پیام‌های لاگ بیشتر
ممکن است جزئیات بیشتری ارائه دهند..SS COMMAND_RECEIVED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Received command \(aq%1\(aq
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که فرمانی از طریق سوکت فرمان (command socket) دریافت شده است. ماهیت این فرمان و نتایج احتمالی آن در پیام‌های جداگانه‌ای ثبت خواهند شد.
.SS COMMAND_REGISTERED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Command %1 registered
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۱۰ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که دیمن پشتیبانی از فرمان مشخص‌شده را آغاز کرده است. اگر سوکت فرمان باز باشد، اکنون می‌توان این فرمان را صادر کرد.
.SS COMMAND_RESPONSE_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Server failed to generate response for command: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که سرور نتوانسته است برای فرمان مشخص‌شده پاسخی تولید کند. این امر احتمالاً نشان‌دهنده یک خطای منطقی در سرور است، زیرا انتظار می‌رود سرور برای همه فرمان‌ها، حتی موارد دارای ساختار نادرست (malformed)، پاسخ‌های معتبری تولید کند.
.SS COMMAND_SOCKET_ACCEPT_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Failed to accept incoming connection on command socket %1: %2
.EE
.UNINDENT
.UNINDENT
.sp
این خطا نشان می‌دهد که سرور یک اتصال ورودی را شناسایی کرده و فراخوان سیستمی accept را روی سوکت مذکور اجرا کرده، اما این فراخوان با خطا مواجه شده است. اطلاعات تکمیلی ممکن است توسط سیستم به عنوان پارامتر دوم ارائه شود.
.SS COMMAND_SOCKET_CLOSED_BY_FOREIGN_HOST
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Closed command socket %1 by foreign host, %2
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام اطلاع‌رسانی است که نشان می‌دهد اتصال فرمان توسط کلاینت کنترل فرمان بسته شده است، و مشخص می‌کند که آیا داده‌های ناقص خوانده‌شده دور ریخته شده‌اند یا خیر.
.SS COMMAND_SOCKET_CONNECTION_CANCEL_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Failed to cancel read operation on socket %1: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهنده بروز خطا در لغو خواندن ناهمگام فرمان کنترلی از طریق سوکت کنترل است. عملیات لغو هنگامی انجام می‌شود که حین ارتباط با یک کلاینت، وقفه زمانی (timeout) رخ دهد. پیام خطا شامل جزئیاتی درباره علت شکست است.
.SS COMMAND_SOCKET_CONNECTION_CLOSED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Closed socket %1 for existing command connection
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۱۰ ثبت می‌شود.
این یک پیام اشکال‌زدایی است که نشان می‌دهد سوکت ایجادشده برای مدیریت اتصال کلاینت بسته شده است. این معمولاً به معنای قطع ارتباط کلاینت است، اما ممکن است به معنای وقفه زمانی (timeout) نیز باشد.
.SS COMMAND_SOCKET_CONNECTION_CLOSE_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Failed to close command connection: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که هنگام بستن یک اتصال فرمان و/یا حذف آن از استخر اتصالات (connections pool)، خطایی رخ داده باشد. خطای تفصیلی به عنوان یک آرگومان ارائه می‌شود.
.SS COMMAND_SOCKET_CONNECTION_OPENED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Opened socket %1 for incoming command connection
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۱۰ ثبت می‌شود.
این یک پیام اشکال‌زدایی است که نشان می‌دهد یک اتصال ورودی جدید برای فرمان شناسایی شده و یک سوکت اختصاصی برای آن اتصال باز شده است..SS COMMAND_SOCKET_CONNECTION_SHUTDOWN_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Encountered error %1 while trying to gracefully shutdown socket
.EE
.UNINDENT
.UNINDENT
.sp
این پیام نشان‌دهنده بروز خطا هنگام تلاش برای بستن اصولی (graceful shutdown) اتصال فرمان است. نوع خطا در پیام گنجانده شده است.
.SS COMMAND_SOCKET_CONNECTION_TIMEOUT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Timeout occurred for connection over socket %1
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام اطلاع‌رسانی است که نشان می‌دهد مهلت زمانی (timeout) برای یکی از اتصالات کانال فرمان به پایان رسیده است. پاسخ ارسال‌شده توسط کارساز اتمام مهلت زمانی را اعلام می‌کند و سپس اتصال بسته می‌شود.
.SS COMMAND_SOCKET_READ
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Received %1 bytes over command socket %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح ۱۰ گزارش اشکال‌زدایی (debug) ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که تعداد بایت‌های مشخص‌شده از طریق سوکت فرمانِ شناسایی‌شده با توصیف‌گر فایل (file descriptor) معین، دریافت شده است.
.SS COMMAND_SOCKET_READ_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Encountered error %1 while reading from command socket %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که هنگام خواندن از سوکت فرمان خطایی رخ داده است.
.SS COMMAND_SOCKET_WRITE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Sent response of %1 bytes (%2 bytes left to send) over command socket %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح ۱۰ گزارش اشکال‌زدایی (debug) ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که تعداد بایت‌های مشخص‌شده از طریق سوکت فرمانِ شناسایی‌شده با توصیف‌گر فایل (file descriptor) معین، ارسال شده است.
.SS COMMAND_SOCKET_WRITE_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Error while writing to command socket %1 : %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که هنگام تلاش برای ارسال یک پاسخ به سوکت فرمان خطایی رخ داده است.
.SS COMMAND_UNIX_SOCKET_PATH_SECURITY_WARNING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
unix socket path is NOT SECURE: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که اعمال تدابیر امنیتی غیرفعال باشد و مسیر مشخص‌شده برای unix socket\-name کانال کنترل با مسیر پشتیبانی‌شده مطابقت نداشته باشد. کارساز همچنان از مسیر مشخص‌شده استفاده خواهد کرد، اما هشدار می‌دهد که انجام این کار ممکن است خطرات امنیتی در پی داشته باشد.
.SS COMMAND_UNIX_SOCKET_PERMISSIONS_SECURITY_WARNING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
unix socket permissions are NOT SECURE: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که اعمال تدابیر امنیتی غیرفعال باشد و مسیر مشخص‌شده برای unix socket\-name کانال کنترل، مجوزهای لازم برای سوکت را نداشته باشد. کارساز همچنان از مسیر مشخص‌شده استفاده خواهد کرد، اما هشدار می‌دهد که انجام این کار ممکن است خطرات امنیتی در پی داشته باشد.
.SS COMMAND_WATCH_SOCKET_CLEAR_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
watch socket failed to clear: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که مدیر فرمان (command manager) نتوانسته باشد پس از اتمام یک ارسال، وضعیت آماده (ready status) را بازنشانی کند. این یک خطای برنامه‌نویسی است که باید گزارش شود. مدیر فرمان ممکن است به کارکرد صحیح خود ادامه دهد یا ندهد.
.SS COMMAND_WATCH_SOCKET_CLOSE_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
watch socket failed to close: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که مدیر فرمان تلاش کرده است سوکت مورد استفاده برای نشان دادن وضعیت آماده برای عملیات ارسال را ببندد. از آنجا که این رخداد هنگام پایان یافتن اتصال رخ می‌دهد، نباید هیچ تأثیر منفی بر عملکرد مدیر فرمان بگذارد..SS COMMAND_WATCH_SOCKET_MARK_READY_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
watch socket failed to mark ready: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا هنگامی صادر می‌شود که command manager پس از زمان‌بندی ارسال ناهمگام، نتوانسته وضعیت آماده (ready) را تنظیم کند. این یک خطای برنامه‌نویسی است که باید گزارش شود. ممکن است command manager به کارکرد صحیح خود ادامه دهد یا ندهد.
.SS CONFIG
.SS CONFIG_BACKENDS_REGISTERED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
the following config backend types are available: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی، تمام پس‌اندهای پیکربندی (config backends) ممکن را که می‌توان در config\-database[s] استفاده کرد، فهرست می‌کند.
.SS DATABASE
.SS DATABASE_INVALID_ACCESS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
invalid database access string: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام زمانی ثبت می‌شود که تلاشی برای تجزیهٔ یک رشتهٔ دسترسی به پایگاه داده انجام شده و با خطا پایان یافته باشد. رشتهٔ دسترسی مورد نظر \- که باید به فرم \(aqkeyword=value keyword=value...\(aq باشد \- در پیام گنجانده شده است.
.SS DATABASE_MYSQL_COMMIT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
committing to MySQL database
.EE
.UNINDENT
.UNINDENT
.sp
کد یک فراخوانی commit صادر کرده است. تمام تراکنش‌های معلق در پایگاه داده اعمال خواهند شد. توجه داشته باشید که بسته به تنظیمات MySQL، این اعمال ممکن است شامل نوشتن روی دیسک نباشد.
.SS DATABASE_MYSQL_FATAL_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Unrecoverable MySQL error occurred: %1 for <%2>, reason: %3 (error code: %4).
.EE
.UNINDENT
.UNINDENT
.sp
پیام خطایی که نشان می‌دهد ارتباط با سرور پایگاه دادهٔ MySQL قطع شده است. اگر بازیابی خودکار فعال شده باشد، سرور تلاش خواهد کرد ارتباط را بازیابی کند. در غیر این صورت، سرور با یک کد خروج غیرصفر خارج خواهد شد. علت چنین خطایی به احتمال زیاد مشکل شبکه یا از کار افتادن سرور MySQL است.
.SS DATABASE_MYSQL_INITIALIZE_SCHEMA
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Initializing the MySQL schema with command: %1.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام پس از شکست در دریافت اولیهٔ نسخهٔ طرح‌واره (schema)، پیش از اجرای دستور kea\-admin جهت مقداردهی اولیهٔ خودکار طرح‌واره از سوی Kea ثبت می‌شود. دستور کامل kea\-admin نمایش داده شده است.
.SS DATABASE_MYSQL_INITIAL_CONNECTION_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
The connection to the MySQL server is not yet established. Reason: %1
.EE
.UNINDENT
.UNINDENT
.sp
پیام هشداری که هنگام ناموفق بودن تلاش اولیه برای اتصال به MySQL ثبت می‌شود. اگر دلیل ناموفق بودن تلاش، عدم وجود طرح‌واره (schema) باشد، ممکن است پس از اجرای kea\-admin db\-init توسط سرور Kea DHCP، همچنان فرصتی برای برقراری موفقیت‌آمیز اتصال وجود داشته باشد.
.SS DATABASE_MYSQL_NO_INIT_NO_ADMIN
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Not attempting to initialize the MySQL schema. kea\-admin seems to be missing.
.EE
.UNINDENT
.UNINDENT
.sp
پیام هشداری که نشان می‌دهد kea\-admin در دسترس نیست، که این امر اجرای db\-init را غیرممکن می‌سازد.
.SS DATABASE_MYSQL_NO_INIT_READONLY
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Not attempting to initialize the MySQL schema. Kea has the database configured as readonly.
.EE
.UNINDENT
.UNINDENT
.sp
پیام هشداری که نشان می‌دهد پایگاه داده در Kea به‌صورت فقط‌خواندنی (readonly) پیکربندی شده است، بنابراین برای db\-init تلاشی صورت نخواهد گرفت.
.SS DATABASE_MYSQL_ROLLBACK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
rolling back MySQL database
.EE
.UNINDENT
.UNINDENT
.sp
کد یک فراخوانی rollback صادر کرده است. تمام تراکنش‌های معلق بازگردانی (roll back) خواهند شد و در پایگاه داده اعمال نمی‌شوند..SS DATABASE_MYSQL_START_TRANSACTION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
starting new MySQL transaction
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک تراکنش جدید MySQL در حال آغاز باشد.
این پیام معمولاً هنگام درج داده در یک جدول منفرد صادر نمی‌شود، زیرا سرور در این
حالت تراکنش‌ها را به طور صریح آغاز نمی‌کند. این پیام زمانی صادر می‌شود که داده‌ها
با چندین دستور INSERT در چندین جدول درج می‌شوند و ممکن است در صورت شکست هر یک
از این دستورات INSERT، نیاز به بازگردانی (rollback) کل تراکنش باشد.
.SS DATABASE_PGSQL_COMMIT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
committing to PostgreSQL database
.EE
.UNINDENT
.UNINDENT
.sp
کد یک فراخوانی commit صادر کرده است. تمام تراکنش‌های معلق در پایگاه‌داده
اعمال (commit) خواهند شد. توجه داشته باشید که بسته به تنظیمات PostgreSQL،
اعمال تراکنش ممکن است شامل نوشتن روی دیسک نباشد.
.SS DATABASE_PGSQL_CREATE_SAVEPOINT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
creating a new PostgreSQL savepoint: %1
.EE
.UNINDENT
.UNINDENT
.sp
کد در حال صدور فراخوانی برای ایجاد یک نقطهٔ ذخیره (savepoint) درون تراکنش
جاری است. در صورتی که پیش از اعمال (commit) تراکنش، فراخوانی بعدی برای
بازگردانی (rollback) به این نقطهٔ ذخیره رخ دهد، تغییرات پایگاه‌داده که
تا این نقطه انجام شده‌اند حفظ خواهند شد.
.SS DATABASE_PGSQL_DEALLOC_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
An error occurred deallocating SQL statements while closing the PostgreSQL lease database: %1
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی صادر می‌شود که یک سرور DHCP (خواه V4 یا V6)
در هنگام آزادسازی منابع SQL پایگاه‌داده به عنوان بخشی از بستن اتصال خود به
پایگاه‌دادهٔ PostgreSQL دچار خطا شود. اتصال به عنوان بخشی از فرایند خاموش شدن
عادی سرور بسته می‌شود. این خطا به احتمال زیاد یک مسئلهٔ برنامه‌نویسی است که
احتمال وقوع آن یا تأثیر منفی آن بر عملکرد سرور بسیار اندک است.
.SS DATABASE_PGSQL_FATAL_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Unrecoverable PostgreSQL error occurred: Statement: <%1>, reason: %2 (error code: %3).
.EE
.UNINDENT
.UNINDENT
.sp
پیام خطایی که نشان می‌دهد ارتباط با سرور پایگاه‌دادهٔ PostgreSQL قطع شده است.
اگر بازیابی خودکار فعال شده باشد، سرور برای بازیابی اتصال تلاش خواهد کرد.
در غیر این صورت، سرور با یک کد خروج غیرصفر خارج خواهد شد. علت چنین خطایی
به احتمال زیاد یک مشکل شبکه‌ای است یا اینکه سرور PostgreSQL از کار افتاده است.
.SS DATABASE_PGSQL_INITIALIZE_SCHEMA
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Initializing the PostgreSQL schema with command: %1.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام پس از آنکه دریافت اولیهٔ نسخهٔ طرحواره (schema) با شکست مواجه شد،
پیش از اجرای دستور kea\-admin برای مقداردهی اولیهٔ خودکار طرحواره از Kea ثبت می‌شود.
دستور کامل kea\-admin نمایش داده می‌شود.
.SS DATABASE_PGSQL_INITIAL_CONNECTION_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
The connection to the PostgreSQL server is not yet established. Reason: %1
.EE
.UNINDENT
.UNINDENT
.sp
پیام هشداری که هنگام ناموفق بودن تلاش اولیه برای اتصال به PostgreSQL ثبت می‌شود.
اگر دلیل تلاش ناموفق عدم وجود طرحواره باشد، ممکن است همچنان پس از اجرای
kea\-admin db\-init توسط سرور Kea DHCP، شانسی برای برقراری موفق اتصال وجود داشته باشد.
.SS DATABASE_PGSQL_NO_INIT_NO_ADMIN
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Not attempting to initialize the PostgreSQL schema. kea\-admin seems to be missing.
.EE
.UNINDENT
.UNINDENT
.sp
پیام هشداری که نشان می‌دهد kea\-admin در دسترس نیست و این امر اجرای db\-init را غیرممکن می‌سازد.
.SS DATABASE_PGSQL_NO_INIT_READONLY
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Not attempting to initialize the PostgreSQL schema. Kea has the database configured as readonly.
.EE
.UNINDENT
.UNINDENT
.sp
پیام هشداری که نشان می‌دهد پایگاه‌داده در Kea به صورت فقط‌خواندنی (readonly) پیکربندی شده است، بنابراین تلاشی برای db\-init صورت نخواهد گرفت..SS DATABASE_PGSQL_ROLLBACK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
rolling back PostgreSQL database
.EE
.UNINDENT
.UNINDENT
.sp
کد دستور واگردانی (rollback) را صادر کرده است. تمام تراکنش‌های معلق واگردانی خواهند شد و در پایگاه‌داده اعمال (commit) نمی‌شوند.
.SS DATABASE_PGSQL_ROLLBACK_SAVEPOINT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
rolling back PostgreSQL database to savepoint: $1
.EE
.UNINDENT
.UNINDENT
.sp
کد در حال صدور فراخوانی برای واگردانی به نقطه ذخیره (savepoint) مشخص‌شده است. هرگونه تغییری در پایگاه‌داده که پس از ایجاد این نقطه ذخیره انجام شده باشد، واگردانی شده و در پایگاه‌داده اعمال نخواهد شد.
.SS DATABASE_PGSQL_START_TRANSACTION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
starting a new PostgreSQL transaction
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اشکال‌زدایی هنگامی صادر می‌شود که یک تراکنش جدید PostgreSQL در حال شروع باشد. این پیام معمولاً هنگام درج داده در یک جدول منفرد صادر نمی‌شود، زیرا سرور در این حالت تراکنش‌ها را به‌طور صریح آغاز نمی‌کند. این پیام هنگامی صادر می‌شود که داده‌ها با چندین دستور INSERT در چند جدول درج می‌شوند و ممکن است در صورت شکست هر یک از این دستورات INSERT، نیاز به واگردانی کل تراکنش باشد.
.SS DATABASE_PGSQL_TCP_USER_TIMEOUT_UNSUPPORTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
tcp_user_timeout is not supported in this PostgreSQL version
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار هنگامی صادر می‌شود که کاربر پارامتر tcp_user_timeout را در اتصال به پایگاه‌داده PostgreSQL پیکربندی کرده باشد، اما پایگاه‌داده نصب‌شده از این پارامتر پشتیبانی نکند. این پارامتر در نسخه 12 یا بالاتر PostgreSQL پشتیبانی می‌شود. مقدار تنظیم‌شده برای این پارامتر نادیده گرفته خواهد شد.
.SS DATABASE_TO_JSON_BOOLEAN_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Internal logic error: invalid boolean value found in database connection parameters: %1=%2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا هنگامی چاپ می‌شود که تبدیل وضعیت داخلی به JSON درخواست شده باشد، اما رشته اتصال حاوی یک پارامتر بولی (boolean) با مقداری نامعتبر باشد. این یک خطای برنامه‌نویسی است. نرم‌افزار به کار خود ادامه خواهد داد، اما داده‌های JSON بازگردانده‌شده با وجود معتبر بودن از نظر نحوی، ناقص خواهند بود. پارامتر معیوب تبدیل نخواهد شد.
.SS DATABASE_TO_JSON_INTEGER_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Internal logic error: invalid integer value found in database connection parameters: %1=%2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا هنگامی چاپ می‌شود که تبدیل وضعیت داخلی به JSON درخواست شده باشد، اما رشته اتصال حاوی یک پارامتر عدد صحیح (integer) با مقداری نادرست باشد. این یک خطای برنامه‌نویسی است. نرم‌افزار به کار خود ادامه خواهد داد، اما داده‌های JSON بازگردانده‌شده با وجود معتبر بودن از نظر نحوی، ناقص خواهند بود. پارامتر معیوب تبدیل نخواهد شد.
.SS DATABASE_TO_JSON_UNKNOWN_TYPE_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Internal logic error: unknown element found in database connection parameters: %1=%2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی چاپ می‌شود که تبدیل وضعیت داخلی به JSON درخواست شده باشد، اما رشته اتصال حاوی یک پارامتر ناشناخته باشد. این یک خطای برنامه‌نویسی است. نرم‌افزار به کار خود ادامه خواهد داد، اما داده‌های JSON بازگردانده‌شده با وجود معتبر بودن از نظر نحوی، ناقص خواهند بود. پارامتر ناشناخته تبدیل نخواهد شد.
.SS DCTL
.SS DCTL_ALREADY_RUNNING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1 already running? %2
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی رخ می‌دهد که یک ماژول با یک فایل PID از پیش موجود مواجه شود که حاوی PID یک فرایند در حال اجرا است. این موضوع به احتمال زیاد نشان‌دهنده تلاش برای راه‌اندازی نمونه دوم از یک ماژول با استفاده از همان فایل پیکربندی است. این احتمال نیز وجود دارد، هرچند بعید، که فایل PID بازمانده‌ای از فروپاشی (crash) سرور یا قطع برق باشد و PID موجود در آن به فرایندی غیر از فرایند Kea اشاره کند. در چنین حالتی، لازم است فایل PID به‌صورت دستی حذف شود. آرگومان نخست نام فرایند و آرگومان دوم حاوی PID و فایل PID است.
.SS DCTL_CFG_FILE_RELOAD_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
configuration reload failed: %1, reverting to current configuration.
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است که نشان می‌دهد برنامه تلاش کرده است پیکربندی خود را مجدداً از فایل بارگذاری کند و با یک خطا مواجه شده است. این امر احتمالاً به دلیل وجود محتوای نامعتبر در فایل پیکربندی رخ داده است. برنامه باید با همان پیکربندی فعلی خود به کار ادامه دهد..SS DCTL_CFG_FILE_RELOAD_SIGNAL_RECVD
.INDENT 0.0
.INDENT 3.5
.sp
.EX
OS signal %1 received, reloading configuration from file: %2
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام اطلاعاتی است که نشان می‌دهد برنامه سیگنالی دریافت کرده که به آن دستور می‌دهد پیکربندی خود را مجدداً از فایل بارگذاری کند.
.SS DCTL_CONFIG_CHECK_COMPLETE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
server has completed configuration check: %1, result: %2
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام اطلاعاتی است که اتمام موفقیت‌آمیز پردازش بررسی یک پیکربندی جدید را اعلان می‌کند. نتیجهٔ این بررسی چاپ می‌شود. این پیام اطلاعاتی هنگامی که بررسی پیکربندی درخواست شده باشد، چاپ می‌شود.
.SS DCTL_CONFIG_COMPLETE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
server has completed configuration: %1
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام اطلاعاتی است که پردازش موفقیت‌آمیز یک پیکربندی جدید را اعلان می‌کند. این پیام هنگام راه‌اندازی سرور، و زمانی که یک پیکربندی به‌روزشده توسط مدیر سیستم اعمال (commit) می‌شود، نمایش داده خواهد شد. ممکن است اطلاعات بیشتری نیز ارائه شود.
.SS DCTL_CONFIG_DEPRECATED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
server configuration includes a deprecated object: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا هنگامی صادر می‌شود که پیکربندی شامل یک شیء منسوخ‌شده (یعنی یک عنصر سطح بالا) باشد که نادیده گرفته خواهد شد.
.SS DCTL_CONFIG_FETCH
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Fetching configuration data from config backends.
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام اطلاعاتی است و زمانی صادر می‌شود که سرور Kea در آستانهٔ شروع واکشی داده‌های پیکربندی از یک یا چند بک‌اند پیکربندی باشد.
.SS DCTL_CONFIG_FILE_LOAD_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1 reason: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطای مهلک نشان می‌دهد که برنامه تلاش کرده پیکربندی اولیهٔ خود را از فایل بارگذاری کند اما شکست خورده است. سرویس بسته خواهد شد.
.SS DCTL_CONFIG_START
.INDENT 0.0
.INDENT 3.5
.sp
.EX
parsing new configuration: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۱۰ (debug log level 10) ثبت می‌شود.
پیام اشکال‌زدایی که نشان می‌دهد فرآیند برنامه پیکربندی به‌روزشده‌ای را دریافت کرده و آن را برای تجزیه به مدیر پیکربندی خود تحویل داده است.
.SS DCTL_DB_OPEN_CONNECTION_WITH_RETRY_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Failed to connect to database: %1 with error: %2
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام اطلاعاتی است و زمانی صادر می‌شود که اتصال سرور به پایگاه‌دادهٔ پیکربندی ناموفق باشد. این عملیات رویهٔ تلاش مجدد برای اتصال را آغاز کرده است. رشتهٔ دسترسی به پایگاه‌داده (با رمز عبور پنهان‌شده) به همراه خطا و جزئیات مربوط به رویهٔ اتصال مجدد ثبت می‌شود.
.SS DCTL_DEPRECATED_OUTPUT_OPTIONS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
The output_options parameter is deprecated. Use output\-options parameter instead.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی نمایش داده می‌شود که پارامتر منسوخ‌شدهٔ output_options به جای output\-options استفاده شود.
.SS DCTL_DEVELOPMENT_VERSION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
This software is a development branch of Kea. It is not recommended for production use.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی نمایش داده می‌شود که نسخه از نوع توسعه‌ای (در مقابل نسخهٔ پایدار) باشد: عدد دوم شمارهٔ نسخه فرد است..SS DCTL_INIT_PROCESS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1 initializing the application
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۰ ثبت می‌شود.
این پیام اشکال‌زدایی درست پیش از آنکه کنترلر برای ایجاد و مقداردهی اولیهٔ
نمونه برنامهٔ خود تلاش کند صادر می‌شود.
.SS DCTL_INIT_PROCESS_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1 application initialization failed: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که کنترلر نتواند برنامه را مقداردهی
اولیه کند و خارج خواهد شد.
.SS DCTL_LOG_PATH_SECURITY_WARNING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Log output path specified is NOT SECURE: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار هنگامی صادر می‌شود که اعمال امنیت غیرفعال باشد
و مسیر خروجی مشخص‌شده برای یک ثبت‌کنندهٔ وقایع (logger) با مسیر
پشتیبانی‌شده مطابقت نداشته باشد. سرور همچنان از مسیر تعیین‌شده استفاده خواهد
کرد، اما هشدار می‌دهد که انجام این کار ممکن است خطرات امنیتی
به همراه داشته باشد.
.SS DCTL_NOT_RUNNING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1 application instance is not running
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که تلاشی برای متوقف کردن برنامه در
حالی که در حال اجرا نیست، صورت گیرد.
.SS DCTL_OPEN_CONFIG_DB
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Opening configuration database: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هنگامی چاپ می‌شود که سرور Kea در حال تلاش برای باز کردن یک
پایگاه دادهٔ پیکربندی است. رشتهٔ دسترسی به پایگاه داده با گذرواژهٔ
سانسورشده ثبت می‌شود.
.SS DCTL_PARSER_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Parser error: %1
.EE
.UNINDENT
.UNINDENT
.sp
هنگام دریافت یک پیکربندی جدید، سرور در ایجاد یک تجزیه‌کننده (parser) برای
رمزگشایی محتوای عنصر پیکربندیِ نام‌برده ناموفق بوده، یا ساخت آن موفقیت‌آمیز
بوده اما عملیات تجزیه و اعمال تغییرات با شکست مواجه شده است.
دلیل این شکست در پیام ذکر شده است.
.SS DCTL_PID_FILE_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1 could not create a PID file: %2
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی رخ می‌دهد که سرور قادر به ایجاد فایل PID خود
نباشد. پیام گزارش باید شامل جزئیات کافی برای تعیین علت اصلی باشد.
محتمل‌ترین دلایل، عدم وجود بخشی از مسیر فایل یا وجود مشکل در مجوزهای دسترسی
است. مسیر پیش‌فرض توسط گزینه‌های \-\-localstatedir و \-\-prefix در meson setup
تعیین می‌شود، اما می‌توان با تنظیم متغیر محیطی KEA_PIDFILE_DIR آن را بازنویسی کرد.
آرگومان نخست، نام فرآیند است.
.SS DCTL_PROCESS_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1 application execution failed: %2
.EE
.UNINDENT
.UNINDENT
.sp
کنترلر هنگام اجرای برنامه با یک خطای مهلک مواجه شده و در حال
خاتمه است. دلیل این شکست در پیام گنجانده شده است.
.SS DCTL_ROOT_USER_SECURITY_WARNING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1 running as root user!
.EE
.UNINDENT
.UNINDENT
.sp
این هشدار زمانی صادر می‌شود که سرور با کاربر ریشه (root) در حال اجرا باشد.
با اینکه سرور به طور کامل کار خواهد کرد، این حالت عملکرد ممکن است
محیط شما را در معرض آسیب‌پذیری‌های امنیتی قرار دهد و تنها پس از بررسی
دقیق باید استفاده شود..SS DCTL_RUN_PROCESS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1 starting application event loop
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۰ ثبت می‌شود.
این پیام اشکال‌زدایی درست پیش از اینکه کنترل‌کننده متد اجرای (run)
برنامه را فراخوانی کند، صادر می‌شود.
.SS DCTL_SHUTDOWN
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1 has shut down, pid: %2, version: %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۰ ثبت می‌شود.
این یک پیام اطلاع‌رسانی است که نشان می‌دهد سرویس متوقف شده
است. آرگومان نام سرویس را مشخص می‌کند.
.SS DCTL_SHUTDOWN_SIGNAL_RECVD
.INDENT 0.0
.INDENT 3.5
.sp
.EX
OS signal %1 received, starting shutdown
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۰ ثبت می‌شود.
این یک پیام اشکال‌زدایی است که نشان می‌دهد برنامه سیگنالی
مبنی بر خاموش شدن دریافت کرده است.
.SS DCTL_STANDALONE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1 skipping message queue, running standalone
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۰ ثبت می‌شود.
این یک پیام اشکال‌زدایی است که نشان می‌دهد کنترل‌کننده در برنامه
در حالت مستقل (standalone) اجرا می‌شود. این بدان معناست که به صف
پیام Kea متصل نخواهد شد. حالت مستقل فقط در طول توسعهٔ برنامه مفید
است و نباید در یک محیط عملیاتی (production) استفاده شود.
.SS DCTL_STARTING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1 starting, pid: %2, version: %3 (%4)
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام اطلاع‌رسانی است که هنگام نخستین راه‌اندازی کنترل‌کننده
برای سرویس صادر می‌شود. نسخه نیز گزارش داده می‌شود.
.SS DCTL_UNLOAD_LIBRARIES_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
error unloading hooks libraries during shutdown: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که هنگام خاموش شدن، تخلیهٔ کتابخانه‌های
hooks در بستن آن‌ها با شکست مواجه شده است. اگر فهرست کتابخانه‌ها
خالی باشد، این یک خطای برنامه‌نویسی در کد سرور است. اگر خالی نباشد،
می‌تواند یک خطای برنامه‌نویسی در یکی از کتابخانه‌های hooks باشد که ممکن
است منجر به فروپاشی (crash) در طول مرحلهٔ نهایی‌سازی شود.
.SS DCTL_UNSUPPORTED_SIGNAL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ignoring reception of unsupported signal: %1
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام اشکال‌زدایی است که نشان می‌دهد برنامه یک سیگنال
پشتیبانی‌نشده دریافت کرده است. این یک خطای برنامه‌نویسی است که نشان
می‌دهد برنامه برای دریافت سیگنال ثبت‌نام کرده، اما هیچ منطق پردازشی
مرتبطی افزوده نشده است.
.SS DDNS
.SS DDNS_TUNING4_CALCULATED_HOSTNAME
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Replacing host name: %1, with calculated host name: %2, for query: %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی صادر می‌شود که کتابخانهٔ hooks مربوط
به DDNS Tuning یک نام میزبان جدید برای پرس‌وجوی کلاینت مربوطه
محاسبه کرده باشد. نام میزبان اصلی و نام میزبان محاسبه‌شده ارائه
می‌شوند.
.SS DDNS_TUNING4_PROCESS_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
An error occurred processing query %1: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهندهٔ بروز خطا در حین پردازش یک پرس‌وجو
توسط کتابخانهٔ hooks مربوط به DDNS Tuning است. اطلاعات شناسایی
کلاینت از پرس‌وجو و جزئیات خطا به عنوان آرگومان‌های پیام گزارش
ارائه می‌شوند..SS DDNS_TUNING4_SKIPPING_DDNS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Client is a member matches SKIP_DDNS class, skipping DDNS updates, query: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که در طول فراخوانی (callout) ddns4\-update، پرس‌وجوی کلاینت با کلاس SKIP_DDNS مطابقت داشته باشد. سرور kea\-dhcp4 درخواست‌های به‌روزرسانی DDNS را برای این پرس‌وجو به kea\-dhcp\-ddns ارسال نخواهد کرد. پرس‌وجو در پیام لاگ نشان داده شده است.
.SS DDNS_TUNING6_CALCULATED_HOSTNAME
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Replacing host name: %1, with calculated host name: %2, for query: %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کتابخانه قلاب‌های (hooks library) DDNS Tuning یک نام میزبان (hostname) جدید برای پرس‌وجوی کلاینت داده‌شده محاسبه کرده باشد. نام میزبان اصلی و نام میزبان محاسبه‌شده ارائه می‌شوند.
.SS DDNS_TUNING6_PROCESS_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
An error occurred processing query %1: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهنده بروز خطا در حین پردازش یک پرس‌وجو توسط کتابخانه قلاب‌های DDNS Tuning است. اطلاعات شناسایی کلاینت از پرس‌وجو و جزئیات خطا به عنوان آرگومان‌های پیام لاگ ارائه می‌شوند.
.SS DDNS_TUNING6_SKIPPING_DDNS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Client is a member matches SKIP_DDNS class, skipping DDNS updates, query: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که در طول فراخوانی ddns6\-update، پرس‌وجوی کلاینت با کلاس SKIP_DDNS مطابقت داشته باشد. سرور kea\-dhcp6 درخواست‌های به‌روزرسانی DDNS را برای این پرس‌وجو به kea\-dhcp\-ddns ارسال نخواهد کرد. پرس‌وجو در پیام لاگ نشان داده شده است.
.SS DDNS_TUNING_GLOBAL_EXPR_SET
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Global hostname expression set to: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام نشان می‌دهد که عبارت نام میزبان سراسری (global hostname expression) تنظیم شده است و در همه‌جا استفاده خواهد شد، مگر اینکه توسط پارامترهای سطح زیرشبکه (subnet) بازنویسی شود.
.SS DDNS_TUNING_LOAD_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
loading DDNS Tuning hooks library failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهنده بروز خطا هنگام بارگیری کتابخانه قلاب‌های DDNS Tuning است. جزئیات خطا به عنوان آرگومان پیام لاگ ارائه می‌شوند.
.SS DDNS_TUNING_LOAD_OK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DDNS Tuning hooks library loaded successfully.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی (info) نشان می‌دهد که کتابخانه قلاب‌های DDNS Tuning با موفقیت بارگیری شده است.
.SS DDNS_TUNING_SUBNET_EXPRESSION_PARSE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Parsing subnet expression (%1) for for subnet %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کتابخانه قلاب‌های DDNS Tuning در حال تلاش برای تجزیه عبارت نام میزبان برای یک زیرشبکه است. تجزیه پس از رویدادهای پیکربندی (مانند دستور reconfigure، به‌روزرسانی‌های backend پیکربندی، به‌روزرسانی‌های دستور subnet) رخ می‌دهد.
.SS DDNS_TUNING_SUBNET_EXPRESSION_PARSE_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
An error occurred while parsing the hostname expression for subnet %1, %2
.EE
.UNINDENT
.UNINDENT
.sp
این خطا نشان می‌دهد که عبارت نام میزبان تخصیص‌یافته به یک زیرشبکه، عبارتی معتبر نیست. سرویس DHCP طوری به کار خود ادامه می‌دهد که گویی زیرشبکه هیچ عبارتی مشخص نکرده است. زیرشبکه و خطای تجزیه در پیام لاگ گنجانده شده‌اند..SS DDNS_TUNING_SUBNET_EXPR_CACHED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Using subnet expression stored in a cache for subnet %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
عبارت این زیرشبکه پیش‌تر استفاده و در حافظه موقت (cache) ذخیره شده است. از نسخه کش‌شده استفاده می‌شود.
.SS DDNS_TUNING_UNLOAD
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DDNS Tuning hooks library has been unloaded
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که کتابخانه هوک‌های DDNS Tuning از حافظه تخلیه شده است (unloaded).
.SS DHCP4
.SS DHCP4_ADDITIONAL_CLASS_EVAL_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Expression \(aq%2\(aq evaluated to %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که هنگام ارزیابی عبارت مربوط به یک کلاس کلاینت اضافی، مشکلی رخ داده است.
توضیحی درباره مشکل چاپ می‌شود.
.SS DHCP4_ADDITIONAL_CLASS_EVAL_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Expression \(aq%2\(aq evaluated to %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که عبارت مربوط به یک کلاس کلاینت اضافی با موفقیت ارزیابی شده است. نام کلاس کلاینت و مقدار حاصل از ارزیابی چاپ می‌شوند.
.SS DHCP4_ADDITIONAL_CLASS_NO_TEST
.INDENT 0.0
.INDENT 3.5
.sp
.EX
additional class %1 has no test expression, adding it to client\(aqs classes unconditionally
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی اطلاع می‌دهد که کلاسی برای ارزیابی اضافی فهرست شده است، اما تعریف آن شامل عبارت آزمایشی برای ارزیابی نیست. این کلاس بدون قید و شرط به پرس‌وجو (query) اضافه می‌شود.
.SS DHCP4_ADDITIONAL_CLASS_UNDEFINED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
additional class %1 has no definition
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی اطلاع می‌دهد که کلاسی برای ارزیابی اضافی فهرست شده است اما تعریفی ندارد. از این کلاس صرف‌نظر می‌شود.
.SS DHCP4_ALREADY_RUNNING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1 already running? %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی رخ می‌دهد که سرور DHCPv4 با یک فایل PID از پیش موجود مواجه می‌شود که حاوی PID یک فرایند در حال اجرا است.
این امر به احتمال زیاد نشان‌دهنده تلاشی برای راه‌اندازی نمونهٔ دوم از سرور با استفاده از همان فایل پیکربندی است. ممکن است، اگرچه نامحتمل، که فایل PID بازمانده‌ای از کرش (خرابی ناگهانی) سرور یا قطع برق باشد و PID موجود در آن به فرایندی غیر از سرور اشاره کند. در چنین حالتی، لازم است فایل PID به صورت دستی حذف شود. آرگومان اول، نام فرایند DHCPv4 است و دومی حاوی PID و فایل PID است.
.SS DHCP4_BUFFER_RECEIVED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
received buffer from %1:%2 to %3:%4 over interface %5
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی ثبت می‌شود که سرور بسته‌ای را از طریق سوکت دریافت کرده باشد. هنگام ثبت این پیام، محتوای بستهٔ دریافتی هنوز تجزیه (parse) نشده است. تنها اطلاعات موجود، رابط شبکه (interface) و نشانی‌ها و پورت‌های IPv4 مبدا و مقصد هستند.
.SS DHCP4_BUFFER_RECEIVE_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
error on attempt to receive packet: %1
.EE
.UNINDENT
.UNINDENT
.sp
سرور DHCPv4 تلاش کرد بسته‌ای را دریافت کند اما هنگام این تلاش خطایی رخ داد. علت خطا در متن پیام گنجانده شده است..SS DHCP4_BUFFER_UNPACK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
parsing buffer received from %1 to %2 over interface %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح ثبت اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارساز شروع به تجزیه بافر دریافتی
حاوی پیام DHCPv4 می‌کند. آرگومان‌ها آدرس‌های IPv4 مبدأ و
مقصد و همچنین واسطی که بافر از طریق آن دریافت شده است را
مشخص می‌کنند.
.SS DHCP4_BUFFER_WAIT_SIGNAL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
signal received while waiting for next packet
.EE
.UNINDENT
.UNINDENT
.sp
در سطح ثبت اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارساز در انتظار
بسته بوده، اما این انتظار توسط سیگنال دریافت شده توسط فرایند
متوقف شده است. سیگنال پیش از آنکه کارساز شروع به انتظار
برای بسته‌های بعدی کند، رسیدگی خواهد شد.
.SS DHCP4_CB_ON_DEMAND_FETCH_UPDATES_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
error on demand attempt to fetch configuration updates from the configuration backend(s): %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که کارساز تلاش کرده به‌روزرسانی‌های
پیکربندی را از پایگاه‌داده واکشی کند و این تلاش درخواستی (on demand) با شکست مواجه شده است.
تنها آرگومان این پیام که به فراخواننده دستور config\-backend\-pull
نیز بازگردانده می‌شود، شامل دلیل شکست است.
.SS DHCP4_CB_PERIODIC_FETCH_UPDATES_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
error on periodic attempt to fetch configuration updates from the configuration backend(s): %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که کارساز تلاش کرده به‌روزرسانی‌های
پیکربندی را از پایگاه‌داده واکشی کند و این تلاش دوره‌ای با شکست مواجه شده است.
کارساز مطابق با مقدار پیکربندی‌شده پارامتر config\-fetch\-wait\-time
دوباره تلاش خواهد کرد. تنها آرگومان شامل دلیل شکست است.
.SS DHCP4_CB_PERIODIC_FETCH_UPDATES_RETRIES_EXHAUSTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
maximum number of configuration fetch attempts: 10, has been exhausted without success
.EE
.UNINDENT
.UNINDENT
.sp
این خطا نشان می‌دهد که کارساز تعدادی تلاش دوره‌ای ناموفق برای
واکشی به‌روزرسانی‌های پیکربندی از یک بک‌اند پیکربندی انجام داده است.
کارساز به کار خود ادامه خواهد داد اما هیچ تلاش دیگری برای واکشی
به‌روزرسانی‌های پیکربندی انجام نخواهد داد. مدیر سیستم باید پیکربندی را
در پایگاه‌داده اصلاح کرده و کارساز را مجدداً بارگذاری (یا راه‌اندازی مجدد) کند.
.SS DHCP4_CLASSES_ASSIGNED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: client packet has been assigned on %2 message to the following classes: %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح ثبت اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی اطلاع می‌دهد که بسته دریافتی به کلاس‌های مشخص‌شده
تخصیص یافته است. این یک رفتار عادی است و نشان‌دهنده عملکرد موفقیت‌آمیز است.
آرگومان اول اطلاعات شناسایی کلاینت و تراکنش را مشخص می‌کند. آرگومان دوم
نوع پیام DHCPv4 را تعیین می‌کند. آرگومان سوم شامل تمام کلاس‌هایی است که
بسته به آن‌ها تخصیص یافته است.
.SS DHCP4_CLASSES_ASSIGNED_AFTER_SUBNET_SELECTION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: client packet has been assigned to the following classes: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح ثبت اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی اطلاع می‌دهد که بسته دریافتی به کلاس‌های مشخص‌شده
تخصیص یافته است. این یک رفتار عادی است و نشان‌دهنده عملکرد موفقیت‌آمیز است.
آرگومان اول اطلاعات شناسایی کلاینت و تراکنش را مشخص می‌کند. آرگومان دوم
شامل تمام کلاس‌هایی است که بسته به آن‌ها تخصیص یافته است.
.SS DHCP4_CLASS_ASSIGNED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: client packet has been assigned to the following class: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح ثبت اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی اطلاع می‌دهد که بسته دریافتی به کلاس مشخص‌شده
تخصیص یافته است. این یک رفتار عادی است و نشان‌دهنده عملکرد موفقیت‌آمیز است.
آرگومان اول اطلاعات شناسایی کلاینت و تراکنش را مشخص می‌کند. آرگومان دوم
شامل کلاس جدیدی است که بسته به آن تخصیص یافته است..SS DHCP4_CLASS_UNCONFIGURED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: client packet belongs to an unconfigured class: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug log level) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی اطلاع می‌دهد که بستهٔ دریافتی متعلق به کلاسی است
که در پیکربندی یافت نمی‌شود. یا از یک هوک (hook) که پیش از اضافه شدن
قابلیت دسته‌بندی به Kea نوشته شده استفاده شده است، یا نام‌گذاری کلاس‌ها
ناسازگار و ناهماهنگ است.
.SS DHCP4_CLIENTID_IGNORED_FOR_LEASES
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: not using client identifier for lease allocation for subnet %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug log level) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارگزار در حال پردازش پیام DHCPv4 است
که برای آن هنگام تخصیص اجارهٔ جدید (lease) یا تمدید اجارهٔ موجود، از شناسهٔ کلاینت
(client identifier) استفاده نخواهد شد. کارگزار صراحتاً پیکربندی شده است تا از
شناسهٔ کلاینت برای جستجوی اجاره‌های موجود کلاینت استفاده نکند و شناسهٔ کلاینت
را در پایگاه دادهٔ اجاره‌ها ثبت نخواهد کرد. این حالت عملکرد زمانی مفید است
که کلاینت‌ها از شناسه‌های پایدار استفاده نمی‌کنند، مانند راه‌اندازی چندمرحله‌ای
(multi-stage booting). آرگومان نخست شامل اطلاعات شناسایی کلاینت و تراکنش است.
آرگومان دوم شناسهٔ زیرشبکه‌ای (subnet) را مشخص می‌کند که کلاینت به آن متصل
است و این حالت عملکرد روی کارگزار برای آن پیکربندی شده است.
.SS DHCP4_CLIENT_FQDN_DATA
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Client sent FQDN option: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug log level) ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی شامل اطلاعات تفصیلی استخراج‌شده از گزینهٔ Client FQDN
ارسال‌شده در پرس‌وجو (query) است. آرگومان نخست شامل اطلاعات شناسایی کلاینت
و تراکنش است. آرگومان دوم اطلاعات دقیق دربارهٔ گزینهٔ FQDN دریافت‌شده توسط
کارگزار را مشخص می‌کند.
.SS DHCP4_CLIENT_FQDN_PROCESS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: processing Client FQDN option
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug log level) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارگزار پردازش گزینهٔ Client FQDN
ارسال‌شده در پرس‌وجوی کلاینت را آغاز می‌کند. آرگومان شامل اطلاعات شناسایی
کلاینت و تراکنش است.
.SS DHCP4_CLIENT_FQDN_SCRUBBED_EMPTY
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: sanitizing client\(aqs FQDN option \(aq%2\(aq yielded an empty string
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug log level) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که نتیجهٔ پالایش و پاک‌سازی گزینهٔ
FQDN option(81) ارسال‌شده توسط کلاینت، یک رشتهٔ خالی باشد. در صورت وقوع
این حالت، کارگزار گزینهٔ FQDN را نادیده خواهد گرفت. آرگومان‌ها شامل کلاینت
و گزینهٔ FQDN ارسال‌شده توسط آن هستند.
.SS DHCP4_CLIENT_HOSTNAME_DATA
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: client sent Hostname option: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug log level) ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی شامل اطلاعات تفصیلی استخراج‌شده از گزینهٔ Hostname
ارسال‌شده در پرس‌وجو است. آرگومان نخست شامل اطلاعات شناسایی کلاینت و
تراکنش است. آرگومان دوم نام میزبان (hostname) حمل‌شده در گزینهٔ Hostname
ارسال‌شده توسط کلاینت را مشخص می‌کند.
.SS DHCP4_CLIENT_HOSTNAME_MALFORMED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: client hostname option malformed: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug log level) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارگزار DHCP به دلیل ناهنجار یا
ناقص بودن محتوا (malformed)، قادر به پردازش گزینهٔ hostname ارسال‌شده توسط
کلاینت نبوده است. آرگومان نخست شامل اطلاعات شناسایی کلاینت و تراکنش است.
آرگومان دوم حاوی شرح خطای داده است.
.SS DHCP4_CLIENT_HOSTNAME_PROCESS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: processing client\(aqs Hostname option
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug log level) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارگزار پردازش گزینهٔ Hostname
ارسال‌شده در پرس‌وجوی کلاینت را آغاز می‌کند. آرگومان شامل اطلاعات شناسایی
کلاینت و تراکنش است..SS DHCP4_CLIENT_HOSTNAME_SCRUBBED_EMPTY
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: sanitizing client\(aqs Hostname option \(aq%2\(aq yielded an empty string
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که نتیجهٔ پاک‌سازی گزینهٔ hostname (کد ۱۲) ارسال‌شده توسط کلاینت، یک رشتهٔ خالی باشد. در چنین حالتی، سرور گزینهٔ hostname را نادیده خواهد گرفت. آرگومان‌ها شامل کلاینت و گزینهٔ hostname ارسال‌شده توسط آن هستند.
.SS DHCP4_CLIENT_NAME_PROC_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: failed to process the fqdn or hostname sent by a client: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور DHCP قادر به پردازش گزینهٔ FQDN یا Hostname ارسال‌شده توسط کلاینت نبوده است. این مسئله احتمالاً به دلیل نامعتبر بودن ساختار (malformed) نام کلاینت یا به دلیل خطای داخلی سرور رخ داده است. آرگومان نخست حاوی اطلاعات شناسایی کلاینت و تراکنش است. آرگومان دوم حاوی توضیحات دقیق خطا می‌باشد.
.SS DHCP4_CONFIG_COMPLETE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCPv4 server has completed configuration: %1
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام اطلاع‌رسانی است که پردازش موفقیت‌آمیز یک پیکربندی جدید را اعلام می‌کند. این پیام هنگام راه‌اندازی سرور و همچنین زمانی که یک پیکربندی به‌روزرسانی‌شده توسط مدیر سیستم اعمال می‌شود، نمایش داده خواهد شد. ممکن است اطلاعات بیشتری نیز ارائه شود.
.SS DHCP4_CONFIG_LOAD_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
configuration error using file: %1, reason: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که پیکربندی DHCPv4 با شکست مواجه شده است. اگر این یک پیکربندی اولیه باشد (هنگام راه‌اندازی سرور)، سرور شروع به کار نخواهد کرد. اگر این تلاش برای پیکربندی مجدد پویا باشد، سرور به استفاده از پیکربندی پیشین ادامه خواهد داد.
.SS DHCP4_CONFIG_PACKET_QUEUE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCPv4 packet queue info after configuration: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی هنگام پیکربندی سرور DHCPv4 و بلافاصله پس از پیکربندی صف بسته‌های DHCPv4 صادر می‌شود. اطلاعات نمایش‌داده‌شده به نوع صف بستهٔ انتخاب‌شده بستگی دارد.
.SS DHCP4_CONFIG_RECEIVED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
received configuration %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۱۰ ثبت می‌شود.
این پیام اشکال‌زدایی پیکربندی دریافت‌شده توسط سرور DHCPv4 را فهرست می‌کند. منبع آن پیکربندی به بستر زیرین (backend) پیکربندیِ استفاده‌شده بستگی دارد.
.SS DHCP4_CONFIG_START
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCPv4 server is processing the following configuration: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۱۰ ثبت می‌شود.
این یک پیام اشکال‌زدایی است و هر بار که سرور پیکربندی دریافت می‌کند صادر می‌شود. این فرایند در زمان راه‌اندازی و همچنین زمانی که تغییری در پیکربندی سرور توسط مدیر سیستم اعمال می‌شود، رخ می‌دهد.
.SS DHCP4_CONFIG_SYNTAX_WARNING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
configuration syntax warning: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار نشان می‌دهد که پیکربندی DHCPv4 دارای یک خطای جزئی در ساختار نحو (syntax) بوده است. خطا نمایش داده شد و تجزیهٔ پیکربندی ادامه یافت.
.SS DHCP4_CONFIG_UNRECOVERABLE_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCPv4 server new configuration failed with an error which cannot be recovered
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطای مهلک زمانی صادر می‌شود که در پیکربندی جدید خطایی غیرقابل‌بازیابی رخ دهد. از آنجا که سرور دیگر کار نمی‌کند، باید در اسرع وقت یک پیکربندی صحیح اعمال شود.
پیکربندی را می‌توان به چندین روش اصلاح کرد. اگر کانال کنترل باز باشد، می‌توان از دستور config\-set به همراه یک پیکربندی معتبر استفاده کرد. به عنوان روش دیگر، می‌توان فایل پیکربندی اصلی را روی دیسک ویرایش کرد و سیگنال SIGHUP را فرستاد (یا دستور config\-reload را اجرا کرد). در نهایت، می‌توان سرور را به طور کامل مجدداً راه‌اندازی نمود..SS DHCP4_CONFIG_UNSUPPORTED_OBJECT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCPv4 server configuration includes an unsupported object: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که پیکربندی شامل یک شیء پشتیبانی‌نشده (یعنی یک عنصر در بالاترین سطح) باشد.
.SS DHCP4_DB_RECONNECT_DISABLED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
database reconnect is disabled: retries left: %1, reconnect wait time: %2, manager ID: %3, timer: %4
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام اطلاع‌رسانی است که نشان می‌دهد ارتباط با پایگاه‌دادهٔ اجاره‌ها یا میزبان‌ها و یا هر دو قطع شده و اتصال مجدد خودکار فعال نیست.
.SS DHCP4_DB_RECONNECT_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
maximum number of database reconnect attempts: %1, has been exhausted without success, manager ID: %2, timer: %3
.EE
.UNINDENT
.UNINDENT
.sp
این خطا نشان می‌دهد که کارساز پس از انجام حداکثر تعداد تلاش‌های پیکربندی‌شده برای اتصال مجدد، نتوانسته است دوباره به پایگاه‌داده(های) اجاره و/یا میزبان متصل شود. این امر ممکن است باعث خاموش شدن کارساز طبق آنچه در پیکربندی مشخص شده است بشود. قطع ارتباط معمولاً ناشی از مشکلی در شبکه یا کارساز پایگاه‌داده است.
.SS DHCP4_DB_RECONNECT_LOST_CONNECTION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
database connection lost: manager ID: %1, timer: %2.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که ارتباط قطع شده است و ممکن است سرویس dhcp طبق تنظیمات پیکربندی، به‌منظور تلاش برای بازیابی اتصال غیرفعال شده باشد.
.SS DHCP4_DB_RECONNECT_NO_DB_CTL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
unexpected error in database reconnect
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است که وجود یک خطای برنامه‌نویسی را نشان می‌دهد که نباید رخ دهد. این خطا در صورت قطع ارتباط مانع از تلاش کارساز برای اتصال مجدد به پایگاه‌های داده‌اش شده و کارساز خارج می‌شود. این خطا باید گزارش شود.
.SS DHCP4_DB_RECONNECT_SUCCEEDED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
database connection recovered: manager ID: %1, timer: %2.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که اتصال بازیابی شده و سرویس dhcp به وضعیت عادی بازگشته است.
.SS DHCP4_DDNS_REQUEST_SEND_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed sending a request to kea\-dhcp\-ddns, error: %1,  ncr: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که کارساز DHCP4 برای ارسال یک درخواست به‌روزرسانی DDNS به کارساز DHCP\-DDNS تلاش کرده است. این خطا به احتمال زیاد ناشی از مشکلی در پیکربندی یا شبکه است.
.SS DHCP4_DECLINE_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: error on decline lease for address %2: %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که نرم‌افزار به دلیل بروز خطا در حین یک عملیات پایگاه‌داده، در رد کردن (decline) یک اجاره از پایگاه‌دادهٔ اجاره‌ها ناموفق بوده است. آرگومان نخست شامل اطلاعات شناسایی کلاینت و تراکنش است. آرگومان دوم حاوی آدرس IPv4 است که تلاش برای رد آن انجام شده بود. آخرین آرگومان نیز شامل دلیل شکست است.
.SS DHCP4_DECLINE_LEASE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Received DHCPDECLINE for addr %1 from client %2. The lease will be unavailable for %3 seconds.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی زمانی چاپ می‌شود که کلاینت آدرسی را دریافت کرده، اما متوجه شده است که دستگاه دیگری در حال استفاده از آن است و با ارسال یک پیام DHCPDECLINE کارساز را مطلع کرده است. کارساز بررسی کرده است که این آدرس واقعاً به کلاینت اجاره داده شده بوده و سپس آن آدرس را برای مدت‌زمان مشخصی به عنوان غیرقابل استفاده علامت‌گذاری کرده است. این پیام ممکن است بیانگر پیکربندی نادرست در شبکه باشد، چرا که یا یک کلاینت دارای اشکال وجود دارد یا به‌احتمال قوی‌تر دستگاهی در حال استفاده از آدرسی است که مجاز به استفاده از آن نیست. کارساز به‌طور کامل از این وضعیت بازیابی خواهد شد، اما اگر ریشهٔ مشکل یعنی دستگاه ناسازگار یا سرکش (rogue) برطرف نشود، ممکن است این آدرس در آینده دوباره رد شود..SS DHCP4_DECLINE_LEASE_MISMATCH
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Received DHCPDECLINE for addr %1 from client %2, but the data doesn\(aqt match: received hwaddr: %3, lease hwaddr: %4, received client\-id: %5, lease client\-id: %6
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی به این معنی است که یک کلاینت تلاش کرده است آدرس خود را به عنوان رد شده (declined \- یعنی استفاده‌شده توسط موجودیتی ناشناس) گزارش کند. کارساز اطلاعاتی دربارهٔ یک اجاره (lease) برای آن آدرس دارد، اما نشانی سخت‌افزاری یا شناسهٔ کلاینت با اطلاعات ذخیره‌شده در کارساز مطابقت ندارد. درخواست کلاینت نادیده گرفته خواهد شد.
.SS DHCP4_DECLINE_LEASE_NOT_FOUND
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Received DHCPDECLINE for addr %1 from client %2, but no such lease found.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار نشان می‌دهد که یک کلاینت گزارش کرده است که آدرس آن به عنوان تکراری شناسایی شده است (یعنی دستگاه دیگری در شبکه از این آدرس استفاده می‌کند). با این حال، کارساز رکوردی برای این آدرس ندارد. این ممکن است نشان‌دهندهٔ خطای کلاینت یا پاک‌سازی پایگاه‌دادهٔ کارساز باشد.
.SS DHCP4_DEFERRED_OPTION_MISSING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: cannot find deferred option code %2 in the query
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی چاپ می‌شود که یک گزینهٔ به تعویق افتاده (deferred option) در پرس‌وجو (query) یافت نشود.
.SS DHCP4_DEFERRED_OPTION_UNPACK_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: An error unpacking the deferred option %2: %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که باز کردن معوق (deferred unpacking) یک گزینه با شکست مواجه شده و باعث شود در بسته بازنشده باقی بماند. آرگومان نخست کد گزینه و آرگومان دوم خطا است.
.SS DHCP4_DEVELOPMENT_VERSION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
This software is a development branch of Kea. It is not recommended for production use.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی نمایش داده می‌شود که نسخه از نوع در حال توسعه (در مقایسه با پایدار) باشد: عدد دوم شمارهٔ نسخه فرد است.
.SS DHCP4_DHCP4O6_BAD_PACKET
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: received malformed DHCPv4o6 packet: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
یک بستهٔ ناهنجار و بدشکل (malformed) DHCPv4o6 دریافت شد.
.SS DHCP4_DHCP4O6_HOOK_SUBNET4_SELECT_DROP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: packet was dropped, because a callout set the next step to \(aqdrop\(aq
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی چاپ می‌شود که یک callout نصب‌شده روی نقطهٔ قلاب (hook point) subnet4_select، گام بعدی را روی مقدار \(aqdrop\(aq تنظیم کند. برای این نقطهٔ قلاب خاص، تنظیم روی این مقدار به کارساز دستور می‌دهد بستهٔ دریافت‌شده را دور بیندازد (drop کند). آرگومان مشخص‌کنندهٔ اطلاعات شناسایی کلاینت و تراکنش است.
.SS DHCP4_DHCP4O6_HOOK_SUBNET4_SELECT_SKIP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: no subnet was selected, because a callout set the next skip flag
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی چاپ می‌شود که یک callout نصب‌شده روی نقطهٔ قلاب subnet4_select، گام بعدی را روی مقدار SKIP تنظیم کند. برای این نقطهٔ قلاب به‌خصوص، تنظیم این پرچم به کارساز دستور می‌دهد که هیچ زیرشبکه‌ای (subnet) را انتخاب نکند؛ اقدامی که ادامهٔ پردازش را به شدت محدود می‌کند؛ کارساز تنها قادر خواهد بود گزینه‌های سراسری (global options) را ارائه دهد \- هیچ آدرسی تخصیص نخواهد یافت. این آرگومان اطلاعات شناسایی کلاینت و تراکنش را مشخص می‌کند.
.SS DHCP4_DHCP4O6_PACKET_RECEIVED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
received DHCPv4o6 packet from DHCPv4 server (type %1) for %2 on interface %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی چاپ می‌شود که کارساز در حال دریافت یک بستهٔ DHCPv4o6 از کارساز DHCPv4 از طریق ارتباط بین‌فرایندی (inter\-process communication) باشد..SS DHCP4_DHCP4O6_PACKET_SEND
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: trying to send packet %2 (type %3) to %4 port %5 on interface %6 encapsulating %7: %8 (type %9)
.EE
.UNINDENT
.UNINDENT
.sp
در سطح ثبت گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
آرگومان‌ها اطلاعات شناسایی کلاینت (آدرس سخت‌افزاری و شناسهٔ کلاینت)، نام و نوع پیام DHCPv6، آدرس IPv6 و پورت مبدأ، نام رابط شبکه، اطلاعات شناسایی کلاینت DHCPv4، و نام و نوع پیام را مشخص می‌کنند.
.SS DHCP4_DHCP4O6_PACKET_SEND_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: failed to send DHCPv4o6 packet: %2
.EE
.UNINDENT
.UNINDENT
.sp
این خطا زمانی در خروجی ظاهر می‌شود که کارساز DHCP IPv4 نتواند یک پیام DHCPv4o6 را به کارساز DHCP IPv6 ارسال کند. دلیل بروز خطا در متن پیام گنجانده شده است.
.SS DHCP4_DHCP4O6_RECEIVE_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to receive DHCPv4o6: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح ثبت گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که ارتباط بین‌فرآیندی با کارساز DHCPv6 با شکست مواجه شده است. دلیل بروز خطا در متن پیام گنجانده شده است.
.SS DHCP4_DHCP4O6_RECEIVING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
receiving DHCPv4o6 packet from DHCPv6 server
.EE
.UNINDENT
.UNINDENT
.sp
در سطح ثبت گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی چاپ می‌شود که کارساز در حال دریافت یک بستهٔ DHCPv4o6 از کارساز DHCPv6 از طریق سوکت ارتباط بین‌فرآیندی باشد.
.SS DHCP4_DHCP4O6_RESPONSE_DATA
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: responding with packet %2 (type %3), packet details: %4
.EE
.UNINDENT
.UNINDENT
.sp
در سطح ثبت گزارش اشکال‌زدایی ۵۵ ثبت می‌شود.
پیامی برای اشکال‌زدایی شامل اطلاعات تفصیلی دربارهٔ بسته‌ای که به کارساز DHCPv6 فرستاده می‌شود تا به کلاینت بازفرستاده شود. آرگومان نخست دربردارندهٔ اطلاعات شناسایی کلاینت و تراکنش است. آرگومان‌های دوم و سوم به ترتیب حاوی نام و نوع بسته هستند. آرگومان چهارم شامل جزئیات بسته است.
.SS DHCP4_DHCP4O6_SUBNET_DATA
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: the selected subnet details: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح ثبت گزارش اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی شامل جزئیات زیرشبکهٔ انتخاب‌شده برای کلاینت است. آرگومان نخست شامل اطلاعات شناسایی کلاینت و تراکنش است. آرگومان دوم جزئیات زیرشبکه را در بر دارد.
.SS DHCP4_DHCP4O6_SUBNET_SELECTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: the subnet with ID %2 was selected for client assignments
.EE
.UNINDENT
.UNINDENT
.sp
در سطح ثبت گزارش اشکال‌زدایی ۴۵ ثبت می‌شود.
این پیام اشکال‌زدایی به انتخاب زیرشبکه‌ای اشاره دارد که قرار است برای تخصیص نشانی و گزینه‌ها به‌کار رود. انتخاب زیرشبکه یکی از گام‌های اولیه در پردازش پیام دریافتی از کلاینت است. آرگومان نخست شامل اطلاعات شناسایی کلاینت و تراکنش است. آرگومان دوم حاوی شناسهٔ زیرشبکهٔ انتخاب‌شده است.
.SS DHCP4_DHCP4O6_SUBNET_SELECTION_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: failed to select subnet for the client
.EE
.UNINDENT
.UNINDENT
.sp
در سطح ثبت گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که کارساز نتوانسته است زیرشبکه‌ای را برای کلاینتی که پیامی به کارساز ارسال کرده، انتخاب کند. کارساز قادر به ارائهٔ هیچ اجاره‌ای به کلاینت نخواهد بود؛ چنانچه پیام دریافتی DHCPDISCOVER باشد پیام دور انداخته می‌شود، و اگر پیام دریافتی DHCPREQUEST باشد یک پیام DHCPNAK ارسال خواهد شد. این آرگومان شامل اطلاعات شناسایی کلاینت و تراکنش است..SS DHCP4_DISCOVER
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: server is processing DHCPDISCOVER with hint=%2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این یک پیام اشکال‌زدایی است که نشان‌دهنده پردازش پیام DHCPDISCOVER دریافت‌شده است. آرگومان نخست حاوی اطلاعات شناسایی کلاینت و تراکنش است. آرگومان دوم ممکن است حاوی سرنخی برای سرور درباره آدرسی باشد که کلاینت مایل به تخصیص آن است. اگر سرنخی وجود نداشته باشد، این آرگومان متنی را ارائه می‌دهد که نشان می‌دهد سرنخی ارسال نشده است.
.SS DHCP4_DYNAMIC_RECONFIGURATION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
initiate server reconfiguration using file: %1, after receiving SIGHUP signal or config\-reload command
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی هنگامی ثبت می‌شود که سرور DHCPv4 در پی دریافت سیگنال SIGHUP یا دستور config\-reload، پیکربندی مجدد را آغاز می‌کند.
.SS DHCP4_DYNAMIC_RECONFIGURATION_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
dynamic server reconfiguration failed with file: %1
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطای مهلک است که در صورت شکست پیکربندی پویای مجدد سرور DHCP ثبت می‌شود.
.SS DHCP4_DYNAMIC_RECONFIGURATION_SUCCESS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
dynamic server reconfiguration succeeded with file: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی هنگامی ثبت می‌شود که پیکربندی پویای مجدد سرور DHCP با موفقیت انجام شده باشد.
.SS DHCP4_EMPTY_HOSTNAME
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: received empty hostname from the client, skipping processing of this option
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی صادر می‌شود که سرور یک گزینهٔ Hostname خالی از کلاینت دریافت کرده باشد. سرور گزینه‌های خالی Hostname را پردازش نمی‌کند و بنابراین از این گزینه صرف‌نظر می‌شود. این آرگومان حاوی اطلاعات شناسایی کلاینت و تراکنش است.
.SS DHCP4_FATAL_OPEN_SOCKETS_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
maximum number of open service sockets attempts: %1, has been exhausted without success
.EE
.UNINDENT
.UNINDENT
.sp
این خطا نشان می‌دهد که سرور پس از انجام حداکثر تعداد تلاش‌های پیکربندی‌شده برای باز کردن سوکت، در متصل کردن (bind) سوکت‌های سرویس ناموفق بوده است. این امر باعث خاموش شدن سرور مطابق با آنچه در پیکربندی مشخص شده است می‌شود.
.SS DHCP4_FLEX_ID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: flexible identifier generated for incoming packet: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی چاپ می‌شود که نوع رزرو میزبان روی flexible identifier تنظیم شده باشد و عبارت مشخص‌شده در پیکربندی آن، شناسه‌ای را برای بستهٔ ورودی تولید کرده باشد (به یک شناسه ارزیابی شده باشد). این پیام اشکال‌زدایی عمدتاً به عنوان کمکی برای اشکال‌زدایی flexible identifier در نظر گرفته شده است.
.SS DHCP4_GENERATE_FQDN
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: client did not send a FQDN or hostname; FQDN will be generated for the client
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور گزینهٔ Hostname را از کلاینت دریافت نکرده باشد و تولید نام میزبان (hostname generation) فعال باشد. این قابلیت امکان ایجاد مدخل‌های DNS را برای کلاینت‌های ساده فراهم می‌کند.
.SS DHCP4_HOOK_BUFFER_RCVD_DROP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
received buffer from %1 to %2 over interface %3 was dropped because a callout set the drop flag
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۱۵ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی چاپ می‌شود که یک کال‌اوت (callout) نصب‌شده روی نقطهٔ قلاب buffer4_receive، پرچم drop را تنظیم کرده باشد. برای این نقطهٔ قلاب به‌خصوص، تنظیم این پرچم توسط کال‌اوت به سرور دستور می‌دهد تا بسته را دور بیندازد. آرگومان‌ها آدرس‌های مبدأ و مقصد IPv4 و همچنین نام رابطی را که بافر روی آن دریافت شده است مشخص می‌کنند..SS DHCP4_HOOK_BUFFER_RCVD_SKIP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
بافر دریافت‌شده از %1 به %2 روی رابط %3 تجزیه نمی‌شود زیرا یک callout گام بعدی را روی SKIP تنظیم کرده است.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی چاپ می‌شود که یک callout نصب‌شده روی نقطه قلاب buffer4_receive، گام بعدی را روی SKIP تنظیم کرده باشد. برای این نقطه قلاب خاص، این مقدارِ تنظیم‌شده توسط یک callout به سرور دستور می‌دهد که بافر را تجزیه نکند زیرا پیش‌تر توسط قلاب تجزیه شده است. آرگومان‌ها نشانی IPv4 مبدأ و مقصد و همچنین نام رابطی را که بافر از طریق آن دریافت شده است مشخص می‌کنند.
.SS DHCP4_HOOK_BUFFER_SEND_SKIP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: پاسخ آماده‌شده دور انداخته شد زیرا یک callout گام بعدی را روی SKIP تنظیم کرده است.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی چاپ می‌شود که یک callout نصب‌شده روی نقطه قلاب buffer4_send، گام بعدی را روی SKIP تنظیم کرده باشد. برای این نقطه قلاب خاص، مقدار SKIP تنظیم‌شده توسط یک callout به سرور دستور می‌دهد که بسته را دور بیندازد. سرور تمامی پردازش‌ها را تکمیل کرده است (برای مثال ممکن است اجاره‌ها را تخصیص داده، به‌روزرسانی کرده یا آزاد کرده باشد)، اما پاسخ برای کلاینت ارسال نخواهد شد.
.SS DHCP4_HOOK_DDNS_UPDATE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
یک قلاب پارامترهای DDNS را به‌روزرسانی کرده است: hostname %1=>%2, forward update %3=>%4, reverse update %5=>%6
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۱۵ ثبت می‌شود.
این پیام نشان می‌دهد که یک قلاب در نقطه قلاب ddns4_update فراخوانی شده و آن قلاب پارامترهای به‌روزرسانی DDNS را به‌روزرسانی کرده است: hostname، یا اینکه به‌روزرسانی مستقیم DDNS (رکورد A) یا معکوس (رکورد PTR) انجام شود یا خیر.
.SS DHCP4_HOOK_DECLINE_SKIP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
calloutهای قلاب Decline4 وضعیت را روی DROP تنظیم کردند، نادیده‌گرفتن بسته.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۱۵ ثبت می‌شود.
این پیام نشان می‌دهد که سرور یک پیام DHCPDECLINE دریافت کرده و صحت آن و تطابقش با اطلاعات اجارهٔ سرور تأیید شده است. سرور قلاب‌های نقطه قلاب decline4 را فراخوانی کرده و یکی از calloutها وضعیت گام بعدی را روی DROP تنظیم کرده است. سرور اکنون پردازش بسته را به گونه‌ای متوقف می‌کند که گویی هرگز دریافت نشده است. اجاره همچنان به این کلاینت اختصاص خواهد داشت.
.SS DHCP4_HOOK_LEASE4_OFFER_ARGUMENT_MISSING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
calloutهای قلاب، آرگومان مورد انتظار %1 را برای %2 تنظیم نکردند
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی چاپ می‌شود که هیچ‌یک از calloutهای نصب‌شده روی نقطه قلاب lease4_offer، آرگومان مورد انتظار را در وضعیت callout تنظیم نکرده باشند. این یک خطای برنامه‌نویسی در کتابخانه‌های قلابِ نصب‌شده است. جزئیات آرگومان و پرس‌وجویی که در آن زمان در حال پردازش بوده، در آرگومان‌های لاگ ارائه شده است.
.SS DHCP4_HOOK_LEASE4_OFFER_DROP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: بسته دور انداخته شد، زیرا یک callout گام بعدی را روی DROP تنظیم کرده است
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اشکال‌زدایی زمانی چاپ می‌شود که یک callout نصب‌شده روی نقطه قلاب lease4_offer گام بعدی را روی DROP تنظیم کند.
.SS DHCP4_HOOK_LEASE4_OFFER_PARK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: بسته پارک شد، زیرا یک callout گام بعدی را روی PARK تنظیم کرده است
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اشکال‌زدایی زمانی چاپ می‌شود که یک callout نصب‌شده روی نقطه قلاب lease4_offer گام بعدی را روی PARK تنظیم کند.
.SS DHCP4_HOOK_LEASE4_OFFER_PARKING_LOT_FULL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
محدودیت parked\-packet\-limit به میزان %1 رسیده است، در حال دور انداختن پرس‌وجو: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اشکال‌زدایی زمانی رخ می‌دهد که پارکینگ (محل نگهداری بسته‌ها) مورد استفاده برای نگه‌داشتن پرس‌وجوهای کلاینت در حین اتمام کار کتابخانهٔ قلاب برای آن‌ها، به حد تعیین‌شده توسط پارامتر سراسری parked\-packet\-limit رسیده یا از آن فراتر رفته باشد. این حالت می‌تواند زمانی رخ دهد که kea\-dhcp4 در حال استفاده از کتابخانه‌های قلاب (مانند ping\-check) باشد که callout مربوط به \(dqlease4_offer\(dq را پیاده‌سازی کرده‌اند، و پرس‌وجوهای کلاینت سریع‌تر از توان پاسخ‌گویی آن calloutها دریافت شوند.
.SS DHCP4_HOOK_LEASE4_RELEASE_SKIP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: اجاره آزاد نشد زیرا یک callout گام بعدی را روی SKIP تنظیم کرده است
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۱۵ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی چاپ می‌شود که یک callout نصب‌شده روی نقطه قلاب lease4_release، وضعیت گام بعدی را روی SKIP تنظیم کرده باشد. برای این نقطه قلاب خاص، مقدار تنظیم‌شده توسط یک callout به سرور دستور می‌دهد که اجاره را آزاد نکند..SS DHCP4_HOOK_LEASES4_COMMITTED_DROP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: packet is dropped, because a callout set the next step to DROP
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اشکال‌زدایی هنگامی چاپ می‌شود که یک callout نصب‌شده روی نقطه قلاب leases4_committed، گام بعدی را بر روی DROP تنظیم کند.
.SS DHCP4_HOOK_LEASES4_COMMITTED_PARK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: packet is parked, because a callout set the next step to PARK
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اشکال‌زدایی هنگامی چاپ می‌شود که یک callout نصب‌شده روی نقطه قلاب leases4_committed، گام بعدی را بر روی PARK تنظیم کند.
.SS DHCP4_HOOK_LEASES4_COMMITTED_PARKING_LOT_FULL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
The parked\-packet\-limit %1, has been reached, dropping query: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اشکال‌زدایی زمانی رخ می‌دهد که توقف‌گاه (parking lot) مورد استفاده برای نگه‌داشتن پرس‌وجوهای کلاینت در حین تکمیل کار کتابخانه قلاب (hook library) برای آن‌ها، به محدودیت تعیین‌شده توسط پارامتر سراسری parked\-packet\-limit رسیده یا از آن فراتر رفته باشد. این موضوع می‌تواند زمانی رخ دهد که kea\-dhcp4 از کتابخانه‌های قلاب (مانند HA) که callout مربوط به \(dqleases4\-committed\(dq را پیاده‌سازی کرده‌اند استفاده کند و پرس‌وجوهای کلاینت سریع‌تر از توانایی آن calloutها برای انجام و پاسخ‌گویی به آن‌ها برسند.
.SS DHCP4_HOOK_PACKET_RCVD_SKIP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: packet is dropped, because a callout set the next step to SKIP
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی چاپ می‌شود که یک callout نصب‌شده بر روی نقطه قلاب pkt4_receive، گام بعدی را روی SKIP تنظیم کند. برای این نقطه قلاب به‌خصوص، مقدار تنظیم‌شده برای پرچم به سرور دستور می‌دهد که بسته را دور بیندازد.
.SS DHCP4_HOOK_PACKET_SEND_DROP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: prepared DHCPv4 response was not sent because a callout set the next step to DROP
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۱۵ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی چاپ می‌شود که یک callout نصب‌شده بر روی نقطه قلاب pkt4_send، گام بعدی را روی DROP تنظیم کند. برای این نقطه قلاب به‌خصوص، تنظیم این مقدار توسط یک callout به سرور دستور می‌دهد که بسته را دور بیندازد. این در عمل به این معناست که کلاینت هیچ پاسخی دریافت نخواهد کرد، حتی با اینکه سرور درخواست کلاینت را پردازش کرده و بر اساس آن عمل کرده باشد (برای نمونه، احتمالاً یک اجاره تخصیص داده باشد). این آرگومان اطلاعات شناسایی کلاینت و تراکنش را مشخص می‌کند.
.SS DHCP4_HOOK_PACKET_SEND_SKIP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: prepared response is not sent, because a callout set the next step to SKIP
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی چاپ می‌شود که یک callout نصب‌شده بر روی نقطه قلاب pkt4_send، گام بعدی را بر روی SKIP تنظیم کند. برای این نقطه قلاب خاص، این تنظیم به سرور دستور می‌دهد که بسته را دور بیندازد. این بدان معناست که کلاینت هیچ پاسخی دریافت نخواهد کرد، حتی با وجود اینکه سرور درخواست کلاینت را پردازش کرده و بر روی آن اقدام کرده باشد (مثلاً احتمالاً یک اجاره تخصیص داده باشد).
.SS DHCP4_HOOK_SUBNET4_SELECT_4O6_PARKING_LOT_FULL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
The parked\-packet\-limit %1, has been reached, dropping query: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۱۵ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی رخ می‌دهد که توقف‌گاه (parking lot) مورد استفاده برای نگه‌داشتن پرس‌وجوهای کلاینت در حین اتمام کار کتابخانه قلاب برای آن‌ها، به حد تعیین‌شده توسط پارامتر سراسری parked\-packet\-limit رسیده یا از آن فراتر رفته باشد. این امر می‌تواند زمانی رخ دهد که kea\-dhcp4 از کتابخانه‌های قلاب (مانند radius) که callout مربوط به \(dqsubnet4_select\(dq را پیاده‌سازی کرده‌اند استفاده کند و پرس‌وجوهای کلاینت DHCP4O6 سریع‌تر از توانایی آن calloutها برای پاسخ‌گویی به آن‌ها دریافت شوند.
.SS DHCP4_HOOK_SUBNET4_SELECT_DROP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: packet was dropped, because a callout set the next step to \(aqdrop\(aq
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی چاپ می‌شود که یک callout نصب‌شده بر روی نقطه قلاب subnet4_select، گام بعدی را بر روی مقدار \(aqdrop\(aq تنظیم کند. برای این نقطه قلاب خاص، تنظیم شدن روی این مقدار به سرور دستور می‌دهد که بسته دریافتی را دور بیندازد. این آرگومان اطلاعات شناسایی کلاینت و تراکنش را مشخص می‌کند..SS DHCP4_HOOK_SUBNET4_SELECT_PARK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: packet was parked
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی چاپ می‌شود که یک فراخوان (callout) نصب‌شده روی
نقطه قلاب (hook point) subnet4_select، پرچم park را تنظیم کند. آرگومان حاوی
اطلاعات شناسایی کلاینت و تراکنش است.
.SS DHCP4_HOOK_SUBNET4_SELECT_PARKING_LOT_FULL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
The parked\-packet\-limit %1, has been reached, dropping query: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۱۵ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی رخ می‌دهد که توقفگاه موقت (parking lot) مورد استفاده
برای نگه‌داری پرس‌وجوهای کلاینت تا زمان تکمیل کار کتابخانه قلاب برای آن‌ها،
به حد تعیین‌شده توسط پارامتر سراسری parked\-packet\-limit رسیده یا از آن فراتر
رفته باشد. این حالت می‌تواند زمانی رخ دهد که kea\-dhcp4 از کتابخانه‌های قلاب
(مانند radius) که فراخوان \(dqsubnet4_select\(dq را پیاده‌سازی می‌کنند استفاده کند
و پرس‌وجوهای کلاینت با سرعتی بیشتر از توان پاسخ‌گویی آن فراخوان‌ها برسند.
.SS DHCP4_HOOK_SUBNET4_SELECT_SKIP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: no subnet was selected, because a callout set the next skip flag
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی چاپ می‌شود که یک فراخوان نصب‌شده روی نقطه قلاب
subnet4_select، گام بعدی را روی مقدار SKIP تنظیم کند. برای این نقطه قلاب خاص،
تنظیم این پرچم به سرور دستور می‌دهد که زیرشبکه‌ای انتخاب نکند؛ اقدامی که
پردازش‌های بعدی را به شدت محدود می‌کند؛ سرور تنها قادر خواهد بود گزینه‌های
سراسری را ارائه دهد \- هیچ آدرسی تخصیص داده نخواهد شد. آرگومان، اطلاعات
شناسایی کلاینت و تراکنش را مشخص می‌کند.
.SS DHCP4_HOOK_SUBNET6_SELECT_PARKING_LOT_FULL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
The parked\-packet\-limit %1, has been reached, dropping query: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۱۵ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی رخ می‌دهد که توقفگاه موقت (parking lot) مورد استفاده
برای نگه‌داری پرس‌وجوهای کلاینت تا زمان تکمیل کار کتابخانه قلاب برای آن‌ها،
به حد تعیین‌شده توسط پارامتر سراسری parked\-packet\-limit رسیده یا از آن فراتر
رفته باشد. این حالت می‌تواند زمانی رخ دهد که kea\-dhcp4 از کتابخانه‌های قلاب
(مانند radius) که فراخوان \(dqsubnet6_select\(dq را پیاده‌سازی می‌کنند استفاده کند
و پرس‌وجوهای کلاینت با سرعتی بیشتر از توان پاسخ‌گویی آن فراخوان‌ها برسند.
.SS DHCP4_INFORM_DIRECT_REPLY
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: DHCPACK in reply to the DHCPINFORM will be sent directly to %2 over %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که DHCPACK به‌جای ارسال از طریق رله (relay)،
به‌طور مستقیم برای کلاینت ارسال گردد. آرگومان نخست شامل اطلاعات شناسایی کلاینت و
تراکنش است. آرگومان دوم حاوی آدرس IPv4 کلاینت است که پاسخ به آن ارسال خواهد شد.
آرگومان سوم شامل نام واسط محلی است.
.SS DHCP4_INIT_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to initialize Kea server: %1
.EE
.UNINDENT
.UNINDENT
.sp
راه‌اندازی اولیه سرور Kea با شکست مواجه شد. این مسئله ممکن است به دلیل ناموفق
بودن پیکربندی باشد، یا اینکه سرور هنگام راه‌اندازی با خطای بحرانی دیگری روبه‌رو
شده است. پیام خطای پیوست‌شده جزئیات بیشتری درباره این مشکل ارائه می‌دهد.
.SS DHCP4_INIT_REBOOT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: client is in INIT\-REBOOT state and requests address %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی زمانی صادر می‌شود که کلاینت در وضعیت INIT\-REBOOT قرار دارد
و درخواست تخصیص آدرس IPv4 را دارد که هم‌اکنون در حال استفاده از آن است. آرگومان
نخست شامل اطلاعات شناسایی کلاینت و تراکنش است. آرگومان دوم آدرس IPv4 درخواستی را
مشخص می‌کند.
.SS DHCP4_LEASE_ALLOC
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: lease %2 has been allocated for %3 seconds
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که سرور در پاسخ به پیام DHCPREQUEST کلاینت،
با موفقیت یک اجاره (lease) را اعطا کرده است. اطلاعات اجاره در پیام DHCPACK
برای کلاینت ارسال خواهد شد. آرگومان نخست شامل اطلاعات شناسایی کلاینت و
تراکنش است. آرگومان دوم حاوی آدرس IPv4 تخصیص‌یافته است. آرگومان سوم مدت‌زمان
اعتبار است..SS DHCP4_LEASE_OFFER
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: lease %2 will be offered
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی نشان می‌دهد که کارگزار اجاره‌ای را برای پیشنهاد به کلاینت پیدا کرده است. این بر عهدهٔ کلاینت است که از میان کارگزارهایی که اجاره پیشنهاد داده‌اند یکی را انتخاب کرده و تخصیص را با آن کارگزار ادامه دهد. آرگومان اول اطلاعات شناسایی کلاینت و تراکنش را مشخص می‌کند. آرگومان دوم آدرس IPv4 پیشنهادی را تعیین می‌کند.
.SS DHCP4_LEASE_QUERY_PACKET_PACK_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
preparing on\-wire\-format of the packet to be sent: %1, failed %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که آماده‌سازی قالب روی خط (on\-wire format) بسته ارسالی با شکست مواجه شده باشد. آرگومان اول جزئیات بسته را ارائه می‌دهد. آرگومان دوم ماهیت خطا را توضیح می‌دهد.
.SS DHCP4_LEASE_QUERY_PACKET_UNPACK_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to parse query from %1 to %2, received over interface %3, reason: %4
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که DHCPLEASEQUERY دریافتی معیوب باشد و توسط فراخوان buffer4_receive قابل تجزیه نباشد. این پرس‌وجو توسط کارگزار دور انداخته خواهد شد. سه آرگومان نخست آدرس IP مبدأ، آدرس IP مقصد و رابط شبکه را مشخص می‌کنند. آرگومان آخر دلیل شکست را ارائه می‌دهد.
.SS DHCP4_LEASE_QUERY_PROCESS_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
processing failed for lease query: %1, reason: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام خطا زمانی صادر می‌شود که کارگزار در پردازش یک DHCPLEASEQUERY با خطا مواجه شده باشد. آرگومان اول جزئیات پرس‌وجو و آرگومان دوم توضیحی دربارهٔ خطا را ارائه می‌دهد.
.SS DHCP4_LEASE_QUERY_RECEIVED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
received query: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی چاپ می‌شود که یک پرس‌وجوی DHCPLEASEQUERY دریافت شده باشد. این آرگومان جزئیات پرس‌وجو را ارائه می‌دهد.
.SS DHCP4_LEASE_QUERY_RESPONSE_SENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
response: %1, sent to %2:%3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی چاپ می‌شود که پاسخی به یک DHCPLEASEQUERY برای درخواست‌کننده ارسال شده باشد. آرگومان اول جزئیات پاسخ را ارائه می‌دهد و آرگومان‌های دوم و سوم آدرس IP و پورتی هستند که پاسخ به آن ارسال شده است.
.SS DHCP4_LEASE_QUERY_SEND_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
unable to send response: %1, iface: %2, address %3:%4 error: %5
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که کارگزار قادر به ارسال پاسخ پرس‌وجوی اجاره (DHCPLEASEQUERY) به درخواست‌کننده نبوده است. آرگومان اول جزئیات پرس‌وجو را ارائه می‌دهد و به دنبال آن رابط خروجی، آدرس IP و پورت، و در نهایت خود خطا می‌آید.
.SS DHCP4_LEASE_REUSE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: lease %2 has been reused for %3 seconds
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی نشان می‌دهد که کارگزار با موفقیت یک اجاره را در پاسخ به پیام کلاینت مجدداً استفاده کرده است. اطلاعات اجاره در پیام DHCPACK به کلاینت ارسال خواهد شد. آرگومان اول شامل اطلاعات شناسایی کلاینت و تراکنش است. آرگومان دوم حاوی آدرس IPv4 تخصیص‌یافته است. آرگومان سوم مدت‌زمان اعتبار (validity lifetime) است.
.SS DHCP4_MULTI_THREADING_INFO
.INDENT 0.0
.INDENT 3.5
.sp
.EX
enabled: %1, number of threads: %2, queue size: %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیامی است که برخی اطلاعات را دربارهٔ پارامترهای چندنخی (multi\-threading) که کارگزار با آن‌ها اجرا می‌شود فهرست می‌کند..SS DHCP4_NCR_CREATION_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: failed to generate name change requests for DNS: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام نشان می‌دهد که کارساز قادر به تولید NameChangeRequests نبوده است؛ درخواست‌هایی که باید برای ایجاد رکوردهای جدید DNS جهت اجارهٔ در حال دریافت یا به‌روزرسانی رکوردهای موجود برای اجارهٔ تمدیدشده، به پیمانهٔ kea\-dhcp_ddns ارسال شوند. آرگومان نخست شامل اطلاعات شناسایی کلاینت و تراکنش است. آرگومان دوم دلیل این شکست را شامل می‌شود.
.SS DHCP4_NOT_RUNNING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCPv4 server is not running
.EE
.UNINDENT
.UNINDENT
.sp
یک پیام هشدار است که هنگام تلاش برای متوقف کردن کارساز DHCPv4 در حالی که در حال اجرا نیست صادر می‌شود.
.SS DHCP4_NO_LEASE_INIT_REBOOT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: no lease for address %2 requested by INIT\-REBOOT client
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی صادر می‌شود که کلاینت در وضعیت INIT\-REBOOT درخواست یک نشانی IPv4 کرده است اما این کلاینت ناشناخته است. کارساز پاسخ نخواهد داد. آرگومان نخست شامل اطلاعات شناسایی کلاینت و شناسهٔ تراکنش است. آرگومان دوم شامل نشانی IPv4 درخواست‌شده توسط کلاینت است.
.SS DHCP4_OPEN_SOCKET
.INDENT 0.0
.INDENT 3.5
.sp
.EX
opening service sockets on port %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۰ ثبت می‌شود.
این پیام اشکال‌زدایی در زمان راه‌اندازی صادر می‌شود و نشان‌دهندهٔ این است که کارساز DHCPv4 در آستانهٔ باز کردن سوکت‌ها روی درگاه مشخص‌شده است.
.SS DHCP4_OPEN_SOCKETS_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
maximum number of open service sockets attempts: %1, has been exhausted without success
.EE
.UNINDENT
.UNINDENT
.sp
این خطا نشان می‌دهد که کارساز پس از انجام حداکثر دفعات تلاشِ پیکربندی‌شده، در متصل ساختن (bind) سوکت‌های سرویس ناموفق بوده است.
.SS DHCP4_OPEN_SOCKETS_NO_RECONNECT_CTL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
unexpected error in bind service sockets.
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است که بیانگر خطایی در سطح کد برنامه بوده و نباید رخ دهد. این خطا کارساز را از تلاش برای متصل ساختن (bind) سوکت‌های سرویس خود در صورت در دسترس نبودن منع می‌کند و کارساز خارج می‌شود. این خطا باید گزارش شود.
.SS DHCP4_PACKET_DROP_0001
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: failed to parse packet from %2 to %3, received over interface %4, reason: %5, %6
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۱۵ ثبت می‌شود.
کارساز DHCPv4 بسته‌ای دریافت کرده که قادر به تجزیه و تحلیل آن نیست. دلیل نامعتبر بودن بسته در پیام گنجانده شده است.
.SS DHCP4_PACKET_DROP_0002
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1, from interface %2: no suitable subnet configured for a direct client
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۱۵ ثبت می‌شود.
این پیام اطلاع‌رسانی هنگامی ثبت می‌شود که پیامی از یک کلاینت با اتصال مستقیم دریافت شده باشد، اما هیچ زیرشبکهٔ مناسبی برای واسطی که این پیام از طریق آن دریافت شده پیکربندی نشده است. نشانی IPv4 تخصیص‌یافته به این واسط باید متعلق به یکی از زیرشبکه‌های پیکربندی‌شده باشد؛ در غیر این صورت پیام دریافتی دور انداخته می‌شود (drop).
.SS DHCP4_PACKET_DROP_0003
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1, from interface %2: it contains a foreign server identifier
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۱۵ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی صادر می‌شود که پیام DHCPv4 دریافتی به این دلیل که خطاب به کارساز دیگری ارسال شده است دور انداخته می‌شود؛ به این معنی که شناسهٔ کارساز موجود در پیام با شناسهٔ مورد استفادهٔ کارساز ما مطابقت ندارد. آرگومان‌های این پیام حاوی شناسهٔ تراکنش و واسطی هستند که پیام از طریق آن دریافت شده است..SS DHCP4_PACKET_DROP_0004
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1, from interface %2: missing msg\-type option
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۱۵ ثبت می‌شود.
این یک پیام اشکال‌زدایی است که اطلاع می‌دهد بستهٔ دریافتی DHCPv4 فاقد گزینهٔ اجباری نوع پیام DHCP بوده و بنابراین دور ریخته شده است. آرگومان‌ها اطلاعات شناسایی کلاینت و تراکنش و همچنین رابطی را که پیام از طریق آن دریافت شده است مشخص می‌کنند.
.SS DHCP4_PACKET_DROP_0005
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: unrecognized type %2 in option 53
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۱۵ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که نوع پیام حمل‌شده در گزینهٔ ۵۳ DHCPv4 توسط سرور ناشناخته است. انواع پیام معتبر در وب‌سایت IANA فهرست شده‌اند: \%<http://\:www\:.iana\:.org/\:assignments/\:bootp-dhcp-parameters/\:bootp-dhcp-parameters\:.xhtml#\:message-type-53>\&.
این پیام توسط سرور پردازش نخواهد شد. آرگومان‌ها اطلاعات شناسایی کلاینت و تراکنش و همچنین نوع پیام دریافت شده را مشخص می‌کنند.
.SS DHCP4_PACKET_DROP_0006
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: unsupported DHCPv4 message type %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۱۵ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که نوع پیام حمل‌شده در گزینهٔ ۵۳ DHCPv4 معتبر است اما پیام توسط سرور پردازش نخواهد شد. این شامل پیام‌هایی می‌شود که معمولاً توسط سرور به کلاینت ارسال می‌شوند، مانند DHCPOFFER، DHCPACK، DHCPNAK و غیره. آرگومان اول اطلاعات شناسایی کلاینت و تراکنش را مشخص می‌کند. آرگومان دوم نوع پیام را مشخص می‌نماید.
.SS DHCP4_PACKET_DROP_0007
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: failed to process packet: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۱۵ ثبت می‌شود.
این یک پیام کلی و جامع است که نشان می‌دهد پردازش یک بستهٔ دریافتی ناموفق بوده است. دلیل آن در پیام ذکر شده است. سرور پاسخی ارسال نخواهد کرد بلکه در عوض بسته را نادیده می‌گیرد. آرگومان اول حاوی اطلاعات شناسایی کلاینت و تراکنش است. آرگومان دوم شامل جزئیات خطا است.
.SS DHCP4_PACKET_DROP_0008
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: DHCP service is globally disabled
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۱۵ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که بسته‌ای به دلیل غیرفعال بودن موقت سرویس DHCP دور ریخته شود. این موضوع بر تمام بسته‌های DHCP دریافتی تأثیر می‌گذارد. سرویس ممکن است توسط دستور کنترلی \(dqdhcp\-enable\(dq یا به‌طور خودکار پس از گذشت مدت زمان مشخصی از دریافت دستور \(dqdhcp\-disable\(dq مجدداً فعال شود.
.SS DHCP4_PACKET_DROP_0009
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Option 53 missing (no DHCP message type), is this a BOOTP packet?
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۱۵ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که بسته‌ای به دلیل نداشتن گزینهٔ ۵۳ و در نتیجه عدم وجود نوع پیام DHCP دور ریخته شود. محتمل‌ترین توضیح این است که بسته از نوع BOOTP بوده است.
.SS DHCP4_PACKET_DROP_0010
.INDENT 0.0
.INDENT 3.5
.sp
.EX
dropped as member of the special class \(aqDROP\(aq: %1, %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۱۵ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی صادر می‌شود که یک بستهٔ ورودی در کلاس ویژهٔ \(aqDROP\(aq طبقه‌بندی شده و دور ریخته شود. جزئیات بسته نمایش داده می‌شوند.
.SS DHCP4_PACKET_DROP_0011
.INDENT 0.0
.INDENT 3.5
.sp
.EX
dropped as sent by the same client than a packet being processed by another thread: dropped %1, %2 by thread %3 as duplicate of %4, %5 processed by thread %6
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۱۵ ثبت می‌شود.
در حال حاضر پردازش چندریسمانی (multi\-threading) با دور انداختن بسته‌های جدید تا زمان پایان پردازش، از تداخل و رقابت بین بسته‌های ارسال‌شده توسط کلاینتی با گزینهٔ شناسه کلاینت (client id) یکسان جلوگیری می‌کند.
جزئیات بسته و شناسه‌های ریسمان (thread) برای هر دو بسته در این پیام گنجانده شده است..SS DHCP4_PACKET_DROP_0012
.INDENT 0.0
.INDENT 3.5
.sp
.EX
dropped as sent by the same client than a packet being processed by another thread: dropped %1, %2 by thread %3 as duplicate of %4, %5 processed by thread %6
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۱۵ ثبت می‌شود.
در حال حاضر پردازش چندرشته‌ای (multi\-threading) با دور انداختن بسته‌های جدید تا زمان پایان پردازش، از ایجاد شرایط رقابتی (race conditions) میان بسته‌های ارسال‌شده توسط کلاینتی با آدرس سخت‌افزاری یکسان جلوگیری می‌کند.
جزئیات بسته و شناسه‌های رشته برای هر دو بسته در این پیام هشدار گنجانده شده‌اند.
.SS DHCP4_PACKET_DROP_0013
.INDENT 0.0
.INDENT 3.5
.sp
.EX
dropped as member of the special class \(aqDROP\(aq after host reservation lookup: %1, %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۱۵ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک بسته ورودی پس از جستجوی رزرو میزبان (host reservation lookup)، در کلاس ویژه \(aqDROP\(aq دسته‌بندی شده و دور انداخته شود.
جزئیات بسته نمایش داده می‌شوند.
.SS DHCP4_PACKET_DROP_0014
.INDENT 0.0
.INDENT 3.5
.sp
.EX
dropped as member of the special class \(aqDROP\(aq after early global host reservations lookup: %1, %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۱۵ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک بسته ورودی پس از جستجوی زودهنگام رزروهای سراسری میزبان (early global host reservations lookup)، در کلاس ویژه \(aqDROP\(aq دسته‌بندی شده و دور انداخته شود. جزئیات بسته نمایش داده می‌شوند.
.SS DHCP4_PACKET_NAK_0001
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: failed to select a subnet for incoming packet, src %2, type %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که بسته‌ای از زیرشبکه‌ای (subnet) دریافت شده باشد که سرور DHCPv4 برای آن پیکربندی نشده است. محتمل‌ترین علت، پیکربندی نادرست سرور است. آرگومان اول شامل اطلاعات شناسایی کلاینت و تراکنش است. آرگومان دوم حاوی آدرس IPv4 مبدأ بسته است. آرگومان سوم شامل نام بسته دریافتی است.
.SS DHCP4_PACKET_NAK_0002
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: invalid address %2 requested by INIT\-REBOOT
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کلاینت در وضعیت INIT\-REBOOT، آدرس IPv4 را درخواست کرده باشد که به آن تخصیص داده نشده است. سرور به این کلاینت با DHCPNAK پاسخ خواهد داد. آرگومان اول شامل اطلاعات شناسایی کلاینت و تراکنش است. آرگومان دوم حاوی آدرس IPv4 درخواستی توسط کلاینت است.
.SS DHCP4_PACKET_NAK_0003
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: failed to advertise a lease, client sent ciaddr %2, requested\-ip\-address %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام نشان می‌دهد که سرور پس از دریافت پیام DISCOVER از کلاینت مشخص‌شده، نتوانسته اجاره‌ای (lease) را به آن پیشنهاد دهد. دلایل احتمالی متعددی برای این شکست وجود دارد. آرگومان اول شامل اطلاعات شناسایی کلاینت و تراکنش است. آرگومان دوم حاوی آدرس IPv4 در فیلد ciaddr است. آرگومان سوم حاوی آدرس IPv4 در گزینه requested\-ip\-address (در صورت وجود) است.
.SS DHCP4_PACKET_NAK_0004
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: failed to grant a lease, client sent ciaddr %2, requested\-ip\-address %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام نشان می‌دهد که سرور پس از دریافت پیام REQUEST از کلاینت مشخص‌شده، نتوانسته اجاره‌ای را به آن اعطا کند. دلایل احتمالی متعددی برای این شکست وجود دارد. پیام‌های اضافی علت را نشان خواهند داد. آرگومان اول شامل اطلاعات شناسایی کلاینت و تراکنش است. آرگومان دوم حاوی آدرس IPv4 در فیلد ciaddr است. آرگومان سوم حاوی آدرس IPv4 در گزینه requested\-ip\-address (در صورت وجود) است.
.SS DHCP4_PACKET_NAK_0005
.INDENT 0.0
.INDENT 3.5
.sp
.EX
nacked as member of the special class \(aqREJECT\(aq: %1, %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۱۵ ثبت می‌شود.
این پیام نشان می‌دهد که سرور یک DHCPNAK برگردانده است زیرا پرس‌وجوی (query) ورودی در کلاس ویژه \(aqREJECT\(aq دسته‌بندی شده است. جزئیات بسته نمایش داده می‌شوند..SS DHCP4_PACKET_OPTIONS_SKIPPED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: An error unpacking an option, caused subsequent options to be skipped: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که استخراج (unpack) یک گزینه با شکست مواجه شده و در نتیجه استخراج گزینه‌های باقی‌مانده در بسته غیرممکن گردد. با این وجود، سرور همچنان تلاش خواهد کرد تا بسته را پردازش کرده و به آن پاسخ دهد.
.SS DHCP4_PACKET_PACK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: preparing on\-wire format of the packet to be sent
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی صادر می‌شود که سرور آماده‌سازی قالب روی شبکه (on\-wire format) بسته را برای ارسال به کلاینت آغاز می‌کند. این آرگومان اطلاعات شناسایی کلاینت و تراکنش را مشخص می‌کند.
.SS DHCP4_PACKET_PACK_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: preparing on\-wire\-format of the packet to be sent failed %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که آماده‌سازی قالب روی شبکه (on\-wire format) بسته با شکست مواجه شده باشد. آرگومان نخست، کلاینت و تراکنش DHCP را مشخص می‌کند. آرگومان دوم حاوی رشته پیام خطا است.
.SS DHCP4_PACKET_PROCESS_EXCEPTION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: exception occurred during packet processing
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که هنگام پردازش بسته، یک استثنای (exception) غیر استاندارد رخ داده که توسط سایر گرداننده‌های اختصاصی‌تر استثنا دریافت نشده است. این بسته دور ریخته می‌شود (drop) و سرور به کار خود ادامه خواهد داد.
.SS DHCP4_PACKET_PROCESS_EXCEPTION_MAIN
.INDENT 0.0
.INDENT 3.5
.sp
.EX
exception occurred during packet processing
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که در حین پردازش بسته، یک استثنای غیر استاندارد رخ داده که توسط سایر گرداننده‌های اختصاصی‌تر استثنا دریافت نشده است. این بسته دور ریخته شده و سرور به کار خود ادامه خواهد داد. این پیام خطا ممکن است در حلقه اصلی پردازش سرور ظاهر شود.
.SS DHCP4_PACKET_PROCESS_STD_EXCEPTION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: exception occurred during packet processing: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که هنگام پردازش بسته، یک استثنای استاندارد رخ داده که توسط سایر گرداننده‌های اختصاصی‌تر استثنا دریافت نشده است. این بسته دور ریخته می‌شود (drop) و سرور به فعالیت خود ادامه خواهد داد.
.SS DHCP4_PACKET_PROCESS_STD_EXCEPTION_MAIN
.INDENT 0.0
.INDENT 3.5
.sp
.EX
exception occurred during packet processing: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا بیانگر آن است که هنگام پردازش بسته، یک استثنای استاندارد رخ داده که توسط سایر گرداننده‌های اختصاصی‌تر استثنا دریافت نشده است. این بسته دور انداخته می‌شود و سرور به کار خود ادامه خواهد داد. این پیام خطا ممکن است در حلقه اصلی پردازش سرور ظاهر گردد.
.SS DHCP4_PACKET_QUEUE_FULL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
multi\-threading packet queue is full
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
پیامی برای اشکال‌زدایی که نشان می‌دهد صف چندنخی (multi\-threading) بسته‌ها پر است؛ بنابراین قدیمی‌ترین بسته موجود در صف حذف شد تا جا برای بسته دریافت‌شده جدید باز شود.
.SS DHCP4_PACKET_RECEIVED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: %2 (type %3) received from %4 to %5 on interface %6
.EE
.UNINDENT
.UNINDENT
.sp
یک پیام INFO که نشان می‌دهد سرور بسته مشخص‌شده را روی رابط شبکه (interface) معین دریافت کرده است. آرگومان نخست اطلاعات شناسایی کلاینت و تراکنش را مشخص می‌کند. آرگومان‌های دوم و سوم به ترتیب نام پیام DHCPv4 و نوع عددی آن را مشخص می‌کنند. باقی آرگومان‌ها نشانی IPv4 مبدأ، نشانی IPv4 مقصد و نام رابطی که پیام روی آن دریافت شده است را مشخص می‌کنند..SS DHCP4_PACKET_SEND
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: trying to send packet %2 (type %3) from %4:%5 to %6:%7 on interface %8
.EE
.UNINDENT
.UNINDENT
.sp
یک پیام INFO که نشان می‌دهد کارساز در تلاش است نوع مشخص‌شده‌ای از بسته را ارسال کند. آرگومان‌ها اطلاعات شناسایی کلاینت (آدرس سخت‌افزاری و شناسه کلاینت)، نام و نوع پیام DHCP، آدرس و درگاه IPv4 مبدأ، آدرس و درگاه IPv4 مقصد و نام رابط شبکه را مشخص می‌کنند. این پیام اشکال‌زدایی (debug) زمانی صادر می‌شود که کارساز در حال تلاش برای ارسال پاسخ به کلاینت است. هنگامی که کارساز از یک سوکت UDP برای ارسال بسته استفاده می‌کند، مواردی وجود دارد که ممکن است این عملیات ناموفق باشد و هیچ پیام خطایی نمایش داده نشود. یکی از این شرایط زمانی رخ می‌دهد که کارساز در حال ارسال تک‌پخشی (unicast) پاسخ به \(aqciaddr\(aq مربوط به یک پیام DHCPINFORM است. این کار اغلب نیازمند انتشار همگانی (broadcasting) یک پیام ARP برای به دست آوردن آدرس لایه پیوند مقصد تک‌پخشی است. اگر پیام‌های همگانی ARP بر اساس سیاست‌های دیوار آتش (firewall) در شبکه مسدود شده باشند، پیام ARP پاسخی در پی نخواهد داشت. در نتیجه، پاسخ به DHCPINFORM ارسال نخواهد شد. از آنجا که ارتباطات ARP تحت کنترل سیستم‌عامل است، Kea از حذف شدن (drop) بسته‌ای که در تلاش برای ارسال آن است مطلع نمی‌شود و راهی برای نمایش پیام خطا ندارد.
.SS DHCP4_PACKET_SEND_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: failed to send DHCPv4 packet: %2
.EE
.UNINDENT
.UNINDENT
.sp
این خطا زمانی در خروجی ثبت می‌شود که کارساز DHCPv4 نتواند پیام DHCP سرهم‌شده را به کلاینت ارسال کند. آرگومان نخست شامل اطلاعات شناسایی کلاینت و تراکنش است. آرگومان دوم دلیل شکست را در بر دارد.
.SS DHCP4_PARSER_COMMIT_EXCEPTION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
parser failed to commit changes
.EE
.UNINDENT
.UNINDENT
.sp
هنگام دریافت پیامی حاوی جزئیات تغییر در پیکربندی کارساز DHCPv4، مجموعه‌ای از تجزیه‌کننده‌ها با موفقیت ایجاد شدند، اما یکی از آن‌ها به دلیل رخ دادن یک استثنای سیستمی سطح پایین (low\-level system exception) در اعمال نهایی (commit) تغییرات خود شکست خورد. ممکن است پیام‌های دیگری برای نشان دادن دلیل این خطا در خروجی ثبت شوند.
.SS DHCP4_PARSER_COMMIT_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
parser failed to commit changes: %1
.EE
.UNINDENT
.UNINDENT
.sp
هنگام دریافت پیامی حاوی جزئیات تغییر در پیکربندی کارساز DHCPv4، مجموعه‌ای از تجزیه‌کننده‌ها با موفقیت ایجاد شدند، اما یکی از آن‌ها در اعمال نهایی (commit) تغییرات خود ناموفق بود. دلیل شکست در پیام ذکر شده است.
.SS DHCP4_PARSER_EXCEPTION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to create or run parser for configuration element %1
.EE
.UNINDENT
.UNINDENT
.sp
هنگام دریافت پیامی حاوی جزئیات تغییر در پیکربندی، کارساز DHCPv4 در ایجاد یک تجزیه‌کننده برای رمزگشایی محتوای عنصر پیکربندی نام‌برده‌شده ناموفق بود، یا ایجاد آن موفقیت‌آمیز بوده اما عملیات تجزیه و اعمال تغییرات با شکست مواجه شده است. این پیام در پاسخ به رخ دادن یک استثنای خارج از چارچوب Kea در خروجی ثبت شده است. پیام‌های تکمیلی ممکن است اطلاعات بیشتری ارائه دهند.
.SS DHCP4_PARSER_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to create or run parser for configuration element %1: %2
.EE
.UNINDENT
.UNINDENT
.sp
هنگام دریافت پیامی حاوی جزئیات تغییر در پیکربندی، کارساز DHCPv4 در ایجاد یک تجزیه‌کننده برای رمزگشایی محتوای عنصر پیکربندی نام‌برده‌شده ناموفق بود، یا ایجاد آن با موفقیت انجام شد اما عملیات تجزیه و اعمال تغییرات با شکست مواجه گردید. دلیل شکست در پیام ذکر شده است.
.SS DHCP4_POST_ALLOCATION_NAME_UPDATE_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: failed to update hostname %2 in a lease after address allocation: %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام نشان‌دهنده شکست در تلاش برای به‌روزرسانی اجاره (lease) و/یا گزینه‌ها در پاسخ کارساز با hostname تولیدشده توسط کارساز، یا رزروشده برای کلاینت متعلق به یک شبکه مشترک (shared network) است. مورد دوم زمانی رخ می‌دهد که کارساز به‌طور پویا از همان شبکه مشترک به زیرشبکه دیگری (به غیر از موردی که ابتدا برای تخصیص انتخاب شده بود) جابه‌جا شود.
.SS DHCP4_QUERY_DATA
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1, packet details: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۵۵ ثبت می‌شود.
پیامی اشکال‌زدایی که جزئیات بسته دریافتی را چاپ می‌کند. آرگومان نخست شامل اطلاعات شناسایی کلاینت و تراکنش است. فیلدهای بسته شامل ciaddr، yiaddr، siaddr، giaddr، sname و file در صورت خالی نبودن گنجانده خواهند شد..SS DHCP4_QUERY_LABEL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
received query: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که یک پرس‌وجو دریافت شده است. این پیام اطلاعات شناسایی کلاینت و تراکنش را نمایش می‌دهد.
.SS DHCP4_RECLAIM_EXPIRED_LEASES_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to reclaim expired leases: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که عملیات بازپس‌گیری اجاره‌های منقضی‌شده با شکست مواجه شده است و علت خطا را مشخص می‌کند.
.SS DHCP4_RECLAIM_EXPIRED_LEASES_SKIPPED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
dhcp6 service is currently disabled. Try again in %1 seconds.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که زمان‌بندی بازپس‌گیری اجاره‌ها فرارسیده باشد، اما به دلیل غیرفعال بودن سرویس DHCPv6 نادیده گرفته شده باشد. زمان‌بندی بازپس‌گیری طبق مقدار پیکربندی‌شده در reclaim\-timer\-wait\-time ادامه خواهد یافت.
.SS DHCP4_RECOVERED_STASHED_RELAY_AGENT_INFO
.INDENT 0.0
.INDENT 3.5
.sp
.EX
recovered for query %1 relay agent option from lease %2: %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که گزینه‌های agent در اجاره برای نشانی کلاینتِ درخواست‌کننده ذخیره شده بودند و اکنون بازیابی شده‌اند. آرگومان اول شامل اطلاعات درخواست، آرگومان دوم نشانی کلاینت و آرگومان آخر محتوای گزینه dhcp\-agent\-options است.
.SS DHCP4_RELEASE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: address %2 was released properly.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اطلاع‌رسانی نشان می‌دهد که یک نشانی به‌درستی آزاد شده است. این یک فرایند عادی هنگام خاموش شدن کلاینت است. آرگومان اول شامل اطلاعات شناسایی کلاینت و تراکنش، و آرگومان دوم شامل نشانی IPv4 آزادشده است.
.SS DHCP4_RELEASE_DELETED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: address %2 was deleted on release.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که یک نشانی هنگام آزادسازی حذف شده است. این یک فرایند عادی در زمان خاموش شدن کلاینت است. آرگومان اول شامل اطلاعات شناسایی کلاینت و تراکنش، و آرگومان دوم شامل نشانی IPv4 آزادشده است.
.SS DHCP4_RELEASE_EXCEPTION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: while trying to release address %2 an exception occurred: %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام زمانی صادر می‌شود که هنگام تلاش برای پردازش پیام DHCPRELEASE خطایی رخ داده باشد. این خطا تأثیری بر کلاینت نخواهد داشت، چرا که کلاینت برای پیام‌های DHCPRELEASE منتظر دریافت هیچ پاسخی از سوی سرور نمی‌ماند. بسته به ماهیت مشکل، ممکن است بر عملکرد آینده سرور اثر بگذارد. آرگومان اول شامل اطلاعات شناسایی کلاینت و تراکنش است. آرگومان دوم شامل نشانی IPv4 است که آزادسازی آن با شکست روبه‌رو شد و آخرین آرگومان حاوی توضیحات تفصیلی خطا است.
.SS DHCP4_RELEASE_EXPIRED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: address %2 expired on release.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که یک نشانی هنگام آزادسازی منقضی شده است. این یک فرایند عادی در زمان خاموش شدن کلاینت است. آرگومان اول شامل اطلاعات شناسایی کلاینت و تراکنش، و آرگومان دوم شامل نشانی IPv4 آزادشده است.
.SS DHCP4_RELEASE_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: failed to remove lease for address %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام خطا بیانگر آن است که نرم‌افزار نتوانسته است یک اجاره را از پایگاه‌داده اجاره‌ها حذف کند. این مشکل احتمالاً به دلیل بروز خطا در حین انجام عملیات روی پایگاه‌داده است؛ رفع آن به احتمال زیاد نیاز به مداخله مدیر سیستم دارد (برای مثال، بررسی اینکه آیا فرایند DHCP مجوزهای کافی برای به‌روزرسانی پایگاه‌داده را داراست یا خیر). این پیام همچنین ممکن است در صورتی رخ دهد که در حین پردازش پیام RELEASE، اجاره به‌صورت دستی از پایگاه‌داده حذف شده باشد. آرگومان نخست شامل اطلاعات شناسایی کلاینت و تراکنش است. آرگومان دوم نیز نشانی IPv4 مورد نظر برای آزادسازی را در بر دارد..SS DHCP4_RELEASE_FAIL_NO_LEASE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: client is trying to release non\-existing lease %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ‌گیری اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی چاپ می‌شود که کلاینت تلاش می‌کند یک اجاره (lease) را آزاد کند،
اما چنین اجاره‌ای برای سرور شناخته‌شده نیست. آرگومان نخست حاوی اطلاعات
شناسایی کلاینت و تراکنش است. آرگومان دوم حاوی آدرس IPv4 است که کلاینت
سعی در آزادسازی آن دارد.
.SS DHCP4_RELEASE_FAIL_WRONG_CLIENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: client is trying to release the lease %2 which belongs to a different client
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ‌گیری اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کلاینت در تلاش برای آزادسازی اجاره
آدرسی است که در حال حاضر توسط کلاینت دیگری استفاده می‌شود؛ یعنی مقادیر
\(aqclient identifier\(aq یا \(aqchaddr\(aq بین کلاینت و اجاره همخوانی ندارند.
آرگومان نخست شامل اطلاعات شناسایی کلاینت و تراکنش است. آرگومان دوم
آدرس اجاره‌شده را مشخص می‌کند.
.SS DHCP4_REQUEST
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: server is processing DHCPREQUEST with hint=%2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ‌گیری اشکال‌زدایی ۵۰ ثبت می‌شود.
این یک پیام اشکال‌زدایی است که نشان‌دهنده پردازش یک پیام دریافتی DHCPREQUEST است.
آرگومان نخست حاوی اطلاعات شناسایی کلاینت و تراکنش است. آرگومان دوم ممکن است
حاوی سرنخی (hint) برای سرور درباره آدرسی باشد که کلاینت تمایل به تخصیص آن دارد.
اگر سرنخی وجود نداشته باشد، این آرگومان متنی را ارائه می‌دهد که نشان می‌دهد
سرنخی ارسال نشده است.
.SS DHCP4_RESERVATIONS_LOOKUP_FIRST_ENABLED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Multi\-threading is enabled and host reservations lookup is always performed first.
.EE
.UNINDENT
.UNINDENT
.sp
این پیامی است که اطلاع می‌دهد با فعال بودن چندرشتگی (multi\-threading)، جستجوی
رزروهای میزبان (host reservations) همیشه پیش از جستجوی اجاره انجام می‌شود و مقدار
پیکربندی‌شده را بازنویسی می‌کند.
.SS DHCP4_RESERVED_HOSTNAME_ASSIGNED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: server assigned reserved hostname %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ‌گیری اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی صادر می‌شود که سرور یک رزرو نام میزبان (hostname) برای
کلاینت پیدا کرده و از این رزرو در گزینه نام میزبانی که به این کلاینت بازمی‌گرداند
استفاده می‌کند. در صورت تعیین پارامتر \(aqddns\-qualifying\-suffix\(aq، نام میزبان
رزروشده با مقدار این پارامتر تکمیل می‌شود.
.SS DHCP4_RESPONSE_DATA
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: responding with packet %2 (type %3), packet details: %4
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ‌گیری اشکال‌زدایی ۵۵ ثبت می‌شود.
پیام اشکال‌زدایی شامل داده‌های تفصیلی بسته‌ای است که برای کلاینت ارسال می‌شود.
آرگومان نخست حاوی اطلاعات شناسایی کلاینت و تراکنش است. آرگومان‌های دوم و سوم
به ترتیب حاوی نام و نوع بسته هستند. آرگومان چهارم شامل جزئیات اطلاعات بسته است.
فیلدهای بسته شامل ciaddr، yiaddr، siaddr، giaddr، sname و file در صورت خالی نبودن
درج خواهند شد.
.SS DHCP4_RESPONSE_FQDN_DATA
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: including FQDN option in the server\(aqs response: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ‌گیری اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی صادر می‌شود که سرور در حال افزودن گزینه Client FQDN
در پاسخ خود به کلاینت است. آرگومان نخست شامل اطلاعات شناسایی کلاینت و تراکنش
است. آرگومان دوم شامل جزئیات گزینه FQDN درج‌شده است. توجه داشته باشید که نام
ارائه‌شده در گزینه FQDN ممکن است در زمان دریافت اجاره برای کلاینت، توسط سرور
تغییر یابد.
.SS DHCP4_RESPONSE_HOSTNAME_DATA
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: including Hostname option in the server\(aqs response: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ‌گیری اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی صادر می‌شود که سرور در حال افزودن گزینه Hostname
در پاسخ خود به کلاینت است. آرگومان نخست شامل اطلاعات شناسایی کلاینت و تراکنش
است. آرگومان دوم شامل جزئیات گزینه FQDN گنجانده‌شده است. توجه داشته باشید که
نام ارائه‌شده در گزینه Hostname ممکن است هنگام دریافت اجاره برای کلاینت، توسط
سرور تغییر یابد..SS DHCP4_RESPONSE_HOSTNAME_GENERATE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: server has generated hostname %2 for the client
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی شامل نام میزبان (hostname) خودکار تولید‌شده‌ای است که برای
کلاینتی که پیام آن در حال پردازش است استفاده خواهد شد. نام‌های میزبان ممکن است در مواردی
نیاز به تولید داشته باشند که در پیکربندی کارساز الزامی شده باشد، یا زمانی که کلاینت
نام میزبان خود را ارائه نکرده باشد. آرگومان نخست شامل اطلاعات شناسایی کلاینت و
تراکنش است. آرگومان دوم نام میزبان تولید‌شده را در بر دارد.
.SS DHCP4_ROOT_USER_SECURITY_WARNING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
kea\-dhcp4 running as root user!
.EE
.UNINDENT
.UNINDENT
.sp
این هشدار زمانی صادر می‌شود که kea\-dhcp4 به عنوان کاربر ریشه (root) در حال اجرا باشد.
اگرچه کارساز به‌طور کامل به کار خود ادامه می‌دهد، اما این شیوهٔ اجرا ممکن است
محیط شما را در معرض آسیب‌پذیری‌های امنیتی قرار دهد و تنها پس از بررسی دقیق
باید استفاده شود.
.SS DHCP4_SECURITY_CHECKS_DISABLED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Invoked with command line option \-X, Security checks are disabled!!
.EE
.UNINDENT
.UNINDENT
.sp
این هشدار زمانی صادر می‌شود که بررسی‌های امنیتی داخلی که معمولاً توسط
kea\-dhcp4 انجام می‌شوند، از طریق گزینهٔ خط فرمان \(aq\-X\(aq غیرفعال شده باشند.
این بدان معناست که کارساز محدودیت‌های مربوط به مسیرهای منابع یا مجوزهای
دسترسی را اعمال نمی‌کند. این شیوهٔ اجرا ممکن است محیط شما را در معرض
آسیب‌پذیری‌های امنیتی قرار دهد و تنها پس از بررسی دقیق باید استفاده شود.
.SS DHCP4_SERVER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
server failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
کارساز DHCPv4 با یک خطای مهلک مواجه شده و در حال خاتمه است.
علت این شکست در پیام گنجانده شده است.
.SS DHCP4_SERVER_INITIATED_DECLINE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Lease for addr %2 has been found to be already in use. The lease will be unavailable for %3 seconds.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی هنگامی چاپ می‌شود که کارساز از طریق ICMP ECHO (به‌عنوان مثال بررسی ping)
یا راه‌های دیگر تشخیص دهد اجاره‌ای (lease) که باید برای ارائه آزاد باشد، در عمل در حال
استفاده است. این پیام ممکن است نشان‌دهندهٔ پیکربندی نادرست در شبکه یا به احتمال بیشتر دستگاهی
باشد که از نشانی‌ای استفاده می‌کند که مجاز به استفاده از آن نیست. کارساز به‌طور کامل از این
وضعیت بازیابی خواهد شد، اما اگر مشکل اصلی یعنی پیکربندی نادرست یا وجود دستگاه سرکش (rogue)
حل نشود، ممکن است این نشانی در آینده دوباره رد (decline) شود.
.SS DHCP4_SERVER_INITIATED_DECLINE_ADD_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: error adding a lease for address %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که کارساز نتوانسته است یک اجارهٔ ردشده (DECLINED) را به
مخزن اجاره‌ها اضافه کند. آرگومان نخست شامل اطلاعات شناسایی کلاینت و تراکنش است.
آرگومان دوم نشانی IPv4 مربوطه را که رد کردن برای آن انجام شده است، نگهداری می‌کند.
.SS DHCP4_SERVER_INITIATED_DECLINE_RESOURCE_BUSY
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: error declining a lease for address %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد در حالی که یک ریسهٔ (thread) کارساز در تلاش برای نشانه‌گذاری
یک اجاره به‌عنوان DECLINED بود، این اجاره قبلاً توسط ریسهٔ دیگری قفل شده است. آرگومان
نخست شامل اطلاعات شناسایی کلاینت و تراکنش است. آرگومان دوم نشانی IPv4 مربوطه را
که رد کردن برای آن انجام شده است، نگهداری می‌کند.
.SS DHCP4_SERVER_INITIATED_DECLINE_UPDATE_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: error updating lease for address %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که کارساز نتوانسته است وضعیت یک اجاره را در مخزن
اجاره‌ها به DECLINED به‌روزرسانی کند. آرگومان نخست شامل اطلاعات شناسایی کلاینت
و تراکنش است. آرگومان دوم نشانی IPv4 مربوطه را که رد کردن برای آن انجام شده است،
نگهداری می‌کند.
.SS DHCP4_SHUTDOWN
.INDENT 0.0
.INDENT 3.5
.sp
.EX
server shutdown
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
کارساز DHCPv4 به‌طور عادی خاتمه یافته است..SS DHCP4_SHUTDOWN_REQUEST
.INDENT 0.0
.INDENT 3.5
.sp
.EX
shutdown of server requested
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی 40 ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که خاموش‌شدن کارساز DHCPv4 از طریق فراخوانی متد \(aqshutdown\(aq در شیء اصلی Dhcpv4Srv درخواست شده است.
.SS DHCP4_SRV_CONSTRUCT_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
error creating Dhcpv4Srv object, reason: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که در حین راه‌اندازی، ساخت یکی از مؤلفه‌های اصلی درون کارساز DHCPv4 (شیء کارساز Dhcpv4) با شکست مواجه شده است. در نتیجه، کارساز خارج خواهد شد. علت شکست در متن پیام ذکر شده است.
.SS DHCP4_SRV_D2STOP_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
error stopping IO with DHCP_DDNS during shutdown: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که در حین خاموش‌شدن، هنگام توقف ورودی/خروجی (IO) بین کارساز DHCPv4 و کارساز DHCP_DDNS خطایی رخ داده است. این مشکل احتمالاً به دلیل یک خطای برنامه‌نویسی است و بعید است پس از راه‌اندازی مجدد، بر هیچ‌یک از کارسازها تأثیر بگذارد. علت شکست در متن پیام ذکر شده است.
.SS DHCP4_SRV_DHCP4O6_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
error stopping IO with DHCPv4o6 during shutdown: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که در حین خاموش‌شدن، هنگام توقف ورودی/خروجی (IO) بین کارساز DHCPv4 و کارساز DHCPv4o6 خطایی رخ داده است. این مشکل احتمالاً به دلیل یک خطای برنامه‌نویسی است و بعید است پس از راه‌اندازی مجدد، بر هیچ‌یک از کارسازها تأثیر بگذارد. علت شکست در متن پیام ذکر شده است.
.SS DHCP4_SRV_UNLOAD_LIBRARIES_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
error unloading hooks libraries during shutdown: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که در حین خاموش‌شدن، تخلیهٔ (unload) کتابخانه‌های قلاب‌ها (hooks libraries) در بستن آن‌ها با شکست مواجه شده است. اگر فهرست کتابخانه‌ها خالی باشد، این یک خطای برنامه‌نویسی در کد کارساز است. اگر خالی نباشد، می‌تواند ناشی از یک خطای برنامه‌نویسی در یکی از کتابخانه‌های قلاب باشد که ممکن است به فروپاشی (crash) در طول نهایی‌سازی بینجامد.
.SS DHCP4_STARTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Kea DHCPv4 server version %1 started
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که کارساز DHCPv4 تمامی اطلاعات پیکربندی را پردازش کرده و آمادهٔ پردازش بسته‌های DHCPv4 است. نگارش کارساز نیز چاپ می‌شود.
.SS DHCP4_STARTING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Kea DHCPv4 server version %1 (%2) starting
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که کارساز DHCPv4 گزینه‌های خط فرمان را پردازش کرده و در حال راه‌اندازی است. نگارش کارساز نیز چاپ می‌شود.
.SS DHCP4_START_INFO
.INDENT 0.0
.INDENT 3.5
.sp
.EX
pid: %1, server port: %2, client port: %3, verbose: %4
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی 0 ثبت می‌شود.
این یک پیام اشکال‌زدایی است که در حین راه‌اندازی کارساز DHCPv4 صادر می‌شود. این پیام اطلاعاتی را دربارهٔ پارامترهایی که کارساز با آن‌ها در حال اجرا است فهرست می‌کند.
.SS DHCP4_SUBNET_DATA
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: the selected subnet details: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی 55 ثبت می‌شود.
این پیام اشکال‌زدایی شامل جزئیات زیرشبکهٔ انتخاب‌شده برای کلاینت است. آرگومان نخست شامل اطلاعات شناسایی کلاینت و تراکنش است. آرگومان دوم شامل جزئیات زیرشبکه است..SS DHCP4_SUBNET_DYNAMICALLY_CHANGED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: changed selected subnet %2 to subnet %3 from shared network %4 for client assignments
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۵ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که کارگزار برای تخصیص‌های کلاینت از زیرشبکه
دیگری به غیر از زیرشبکه اولیه استفاده می‌کند. این زیرشبکه تازه انتخاب‌شده
متعلق به همان شبکه مشترک (shared network) زیرشبکه اصلی است.
برخی از دلایل انتخاب زیرشبکه جدید عبارتند از: اتمام استخر آدرس
در زیرشبکه اصلی یا وجود رزروهای ایستا برای این کلاینت در زیرشبکه جدید.
.SS DHCP4_SUBNET_SELECTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: the subnet with ID %2 was selected for client assignments
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۵ ثبت می‌شود.
این یک پیام اشکال‌زدایی است که به انتخاب یک زیرشبکه جهت استفاده برای
تخصیص آدرس و گزینه‌ها اشاره می‌کند. انتخاب زیرشبکه یکی از گام‌های
اولیه در پردازش پیام دریافتی کلاینت است. آرگومان اول شامل اطلاعات
شناسایی کلاینت و تراکنش است. آرگومان دوم شناسه زیرشبکه انتخاب‌شده را نگه می‌دارد.
.SS DHCP4_SUBNET_SELECTION_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: failed to select subnet for the client
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که کارگزار در انتخاب زیرشبکه برای کلاینتی
که پیامی به کارگزار فرستاده، ناموفق بوده است. کارگزار قادر به ارائه هیچ
اجاره‌ای به کلاینت نخواهد بود؛ در صورتی که پیام دریافتی DHCPDISCOVER باشد
آن را دور می‌اندازد (drop می‌کند)، و اگر پیام دریافتی DHCPREQUEST باشد
یک پیام DHCPNAK ارسال خواهد کرد. آرگومان شامل اطلاعات شناسایی
کلاینت و تراکنش است.
.SS DHCP4_TESTING_MODE_SEND_TO_SOURCE_ENABLED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
All packets will be sent to the source address of an incoming packet \- use only for testing
.EE
.UNINDENT
.UNINDENT
.sp
این پیام زمانی چاپ می‌شود که متغیر محیطی KEA_TEST_SEND_RESPONSES_TO_SOURCE
تنظیم شده باشد. این متغیر باعث می‌شود Kea بسته‌ها را به آدرس مبدا بسته
دریافتی ارسال کند. این ویژگی تنها در یک محیط آزمایشی برای شبیه‌سازی ترافیک
چندین زیرشبکه از یک مبدا واحد قابل استفاده است.
.SS DHCP4_UNKNOWN_ADDRESS_REQUESTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: client requested an unknown address, client sent ciaddr %2, requested\-ip\-address %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام نشان می‌دهد که کلاینت آدرسی را درخواست کرده است که به هیچ‌کدام
از استخرهای پویای مدیریت‌شده توسط این کارگزار تعلق ندارد. آرگومان اول
حاوی اطلاعات شناسایی کلاینت و تراکنش است. آرگومان دوم حاوی آدرس IPv4
در فیلد ciaddr است. آرگومان سوم حاوی آدرس IPv4 در گزینه
requested\-ip\-address است (در صورت وجود).
.SS DHCP4_V6_ONLY_PREFERRED_MISSING_IN_ACK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
v6\-only\-preferred option missing in 0.0.0.0 reply to query: %1
.EE
.UNINDENT
.UNINDENT
.sp
یک پیام DHCPACK برای آدرس 0.0.0.0 برای کلاینتی که گزینه v6\-only\-preferred (108)
را درخواست کرده بود تولید شد، اما این گزینه بر خلاف انتظار در پاسخ وجود ندارد:
پاسخ نادرست دور ریخته شده و پرس‌وجوی درخواست (request) نمایش داده می‌شود.
.SS DHCP4_V6_ONLY_PREFERRED_MISSING_IN_OFFER
.INDENT 0.0
.INDENT 3.5
.sp
.EX
v6\-only\-preferred option missing in 0.0.0.0 offer to query: %1
.EE
.UNINDENT
.UNINDENT
.sp
یک پیام DHCPOFFER برای آدرس 0.0.0.0 برای کلاینتی که گزینه v6\-only\-preferred (108)
را درخواست کرده بود تولید شد، اما این گزینه بر خلاف انتظار در پاسخ وجود ندارد:
پاسخ نادرست دور ریخته شده و پرس‌وجوی کشف (discover) نمایش داده می‌شود.
.SS DHCP6
.SS DHCP6_ADDITIONAL_CLASS_EVAL_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Expression \(aq%2\(aq evaluated to %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که هنگام ارزیابی عبارت مربوط به یک کلاس
کلاینت اضافی مشکلی رخ داده است.
شرحی از مشکل چاپ می‌شود..SS DHCP6_ADDITIONAL_CLASS_EVAL_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Expression \(aq%2\(aq evaluated to %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که عبارت یک کلاس کلاینت اضافی با موفقیت ارزیابی شده است. نام کلاس کلاینت و مقدار نتیجهٔ ارزیابی چاپ می‌شوند.
.SS DHCP6_ADDITIONAL_CLASS_NO_TEST
.INDENT 0.0
.INDENT 3.5
.sp
.EX
additional class %1 has no test expression, adding it to client\(aqs classes unconditionally
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی اطلاع می‌دهد که یک کلاس برای ارزیابی بیشتر فهرست شده است اما تعریف آن شامل هیچ عبارت آزمایشی برای ارزیابی نیست. این کلاس بدون قید و شرط به پرسمان اضافه می‌شود.
.SS DHCP6_ADDITIONAL_CLASS_UNDEFINED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
additional class %1 has no definition
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی اطلاع می‌دهد که یک کلاس برای ارزیابی بیشتر فهرست شده اما تعریفی ندارد. از این کلاس صرف‌نظر می‌شود.
.SS DHCP6_ADDR6_REGISTER_DISABLED_DROP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ADDR\-REG\-INFORM from %1 was dropped because address registration is disabled.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی چاپ می‌شود که کارگزار یک بستهٔ ADDR\-REG\-INFORM را نادیده گرفته و دور می‌اندازد، زیرا \(aqallow\-address\-registration\(aq روی false تنظیم شده است.
.SS DHCP6_ADDR_REG_INFORM_CLIENT_CHANGE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
received an ADDR\-REG\-INFORM for %1 from client \(aq%2\(aq but the address was registered by another client \(aq%3\(aq
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی زمانی صادر می‌شود که از قبل یک اجاره (lease) متعلق به کلاینتی دیگر برای نشانیِ در حال ثبت وجود داشته باشد. نشانی، شناسهٔ کلاینت جدید و کلاینت پیشین چاپ می‌شوند.
.SS DHCP6_ADDR_REG_INFORM_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
error on ADDR\-REG\-INFORM from client %1, %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی زمانی صادر می‌شود که پردازش پیام ADDR\-REG\-INFORM با شکست مواجه شده باشد. نشانی کلاینت (که معمولاً همان نشانی برای ثبت است) و شرح مشکل چاپ می‌شوند.
.SS DHCP6_ADD_DEPRECATED_UNICAST
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: adding deprecated unicast option
.EE
.UNINDENT
.UNINDENT
.sp
این هشدار زمانی ثبت می‌شود که گزینهٔ منسوخ‌شدهٔ unicast به پاسخ افزوده شود. به جز برای مقاصد آزمایشی، پیکربندی کارگزار باید اصلاح شود زیرا پرسمان‌های مستقیم unicast دیگر پذیرفته نمی‌شوند.
.SS DHCP6_ADD_GLOBAL_STATUS_CODE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: adding Status Code to DHCPv6 packet: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام زمانی ثبت می‌شود که کارگزار در حال افزودن گزینهٔ سطح بالای Status Code است. آرگومان نخست شامل اطلاعات شناسایی کلاینت و تراکنش است. آرگومان دوم جزئیات کد وضعیت را در بر دارد.
.SS DHCP6_ADD_STATUS_CODE_FOR_IA
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: adding Status Code to IA with iaid=%2: %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام زمانی ثبت می‌شود که کارگزار در حال افزودن گزینهٔ Status Code به یک IA است. آرگومان نخست شامل اطلاعات شناسایی کلاینت و تراکنش است. آرگومان دوم IAID را مشخص می‌کند. آرگومان سوم شامل جزئیات کد وضعیت است..SS DHCP6_ALREADY_RUNNING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1 already running? %2
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی رخ می‌دهد که کارساز DHCPv6 با یک فایل PID از پیش موجود که حاوی PID یک فرایند در حال اجراست مواجه می‌شود.
این امر به احتمال زیاد نشان‌دهندهٔ تلاش برای اجرای نمونهٔ دومی از کارساز با استفاده از همان فایل پیکربندی است. همچنین این احتمال، هرچند اندک، وجود دارد که فایل PID باقی‌مانده‌ای از فروپاشی (crash) کارساز یا قطعی برق باشد و شناسهٔ PID درون آن به فرایندی غیر از کارساز اشاره کند. در چنین شرایطی، لازم است فایل PID به‌صورت دستی حذف شود. آرگومان نخست نام فرایند DHCPv6 است و آرگومان دوم حاوی PID و فایل PID است.
.SS DHCP6_BUFFER_RECEIVED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
received buffer from %1:%2 to %3:%4 over interface %5
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی ثبت می‌شود که کارساز بسته‌ای را روی سوکت دریافت کرده باشد. هنگام ثبت این پیام، محتوای بستهٔ دریافتی هنوز تجزیه نشده است. تنها اطلاعات موجود، رابط شبکه و نشانی‌ها/درگاه‌های مبدأ و مقصد هستند.
.SS DHCP6_BUFFER_UNPACK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
parsing buffer received from %1 to %2 over interface %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارساز شروع به تجزیهٔ بافر دریافتی حاوی پیام DHCPv6 می‌کند. آرگومان‌ها نشانی‌های مبدأ و مقصد و همچنین رابط شبکه‌ای را که بافر از طریق آن دریافت شده است مشخص می‌کنند.
.SS DHCP6_BUFFER_WAIT_SIGNAL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
signal received while waiting for next packet
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارساز در انتظار بسته بوده است، اما این انتظار به دلیل سیگنال دریافت شده توسط فرایند دچار وقفه شده است. پیش از آن‌که کارساز انتظار برای بسته‌های بعدی را آغاز کند، به این سیگنال رسیدگی خواهد شد.
.SS DHCP6_CB_ON_DEMAND_FETCH_UPDATES_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
error on demand attempt to fetch configuration updates from the configuration backend(s): %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که کارساز برای واکشی به‌روزرسانی‌های پیکربندی از پایگاه‌داده تلاش کرده و این تلاش درخواستی (on demand) با شکست مواجه شده است. تنها آرگومان موجود، که به فراخوانندهٔ دستور config\-backend\-pull نیز برگردانده می‌شود، شامل علت شکست است.
.SS DHCP6_CB_PERIODIC_FETCH_UPDATES_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
error on periodic attempt to fetch configuration updates from the configuration backend(s): %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که کارساز برای واکشی به‌روزرسانی‌های پیکربندی از پایگاه‌داده تلاش کرده و این تلاش دوره‌ای با شکست مواجه شده است. کارساز با توجه به مقدار پیکربندی‌شده در پارامتر config\-fetch\-wait\-time مجدداً تلاش خواهد کرد. تنها آرگومان موجود حاوی علت شکست است.
.SS DHCP6_CB_PERIODIC_FETCH_UPDATES_RETRIES_EXHAUSTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
maximum number of configuration fetch attempts: 10, has been exhausted without success
.EE
.UNINDENT
.UNINDENT
.sp
این خطا نشان‌دهندهٔ آن است که کارساز چندین تلاش ناموفق دوره‌ای برای واکشی به‌روزرسانی‌های پیکربندی از پسانهٔ (backend) پیکربندی انجام داده است. کارساز به فعالیت خود ادامه خواهد داد، اما تلاش دیگری برای واکشی به‌روزرسانی‌های پیکربندی انجام نخواهد داد. مدیر سیستم باید پیکربندی را در پایگاه‌داده اصلاح کرده و کارساز را مجدداً بارگذاری (reload) یا بازراه‌اندازی (restart) کند.
.SS DHCP6_CLASSES_ASSIGNED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: client packet has been assigned on %2 message to the following classes: %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی اطلاع می‌دهد که بستهٔ ورودی به کلاس‌های مشخص‌شده تخصیص داده شده است. این یک رفتار عادی بوده و نشان‌دهندهٔ عملکرد موفقیت‌آمیز است. آرگومان اول، اطلاعات شناسایی کلاینت و تراکنش را مشخص می‌کند. آرگومان دوم نوع پیام DHCPv6 را مشخص می‌کند. آرگومان سوم شامل تمام کلاس‌هایی است که بسته به آن‌ها تخصیص یافته است..SS DHCP6_CLASSES_ASSIGNED_AFTER_SUBNET_SELECTION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: client packet has been assigned to the following classes: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی اطلاع می‌دهد که بستهٔ دریافتی به کلاس‌های مشخص‌شده تخصیص یافته است. این یک رفتار عادی است و نشان‌دهندهٔ عملکرد موفقیت‌آمیز می‌باشد.
آرگومان اول اطلاعات شناسایی کلاینت و تراکنش را مشخص می‌کند. آرگومان دوم شامل تمام کلاس‌هایی است که بسته به آن‌ها تخصیص داده شده است.
.SS DHCP6_CLASS_ASSIGNED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: client packet has been assigned to the following class: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی اطلاع می‌دهد که بستهٔ دریافتی به کلاس مشخص‌شده تخصیص یافته است. این یک رفتار عادی است و نشان‌دهندهٔ عملکرد موفقیت‌آمیز می‌باشد.
آرگومان اول اطلاعات شناسایی کلاینت و تراکنش را مشخص می‌کند. آرگومان دوم شامل کلاس جدیدی است که بسته به آن تخصیص داده شده است.
.SS DHCP6_CLASS_UNCONFIGURED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: client packet belongs to an unconfigured class: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی اطلاع می‌دهد که بستهٔ دریافتی متعلق به کلاسی است
که در پیکربندی یافت نمی‌شود. یا از یک hook استفاده شده است که
قبل از افزوده شدن دسته‌بندی به Kea نوشته شده بود، یا نام‌گذاری کلاس‌ها
ناسازگار است.
.SS DHCP6_CLIENT_FQDN_SCRUBBED_EMPTY
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: sanitizing client\(aqs FQDN option \(aq%2\(aq yielded an empty string
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که نتیجهٔ پاک‌سازی (sanitizing)
گزینهٔ FQDN (39) ارسال‌شده توسط کلاینت، یک رشتهٔ خالی باشد. در صورت بروز این حالت،
سرور از گزینهٔ FQDN صرف‌نظر خواهد کرد. آرگومان‌ها شامل کلاینت
و گزینهٔ FQDN ارسال‌شده توسط آن هستند.
.SS DHCP6_CONFIG_COMPLETE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCPv6 server has completed configuration: %1
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام اطلاع‌رسانی است که پردازش موفقیت‌آمیز یک پیکربندی جدید را
اعلان می‌کند. این پیام در زمان راه‌اندازی سرور و هنگامی که یک پیکربندی
به‌روزشده توسط مدیر سیستم اعمال می‌شود، در خروجی ثبت می‌گردد. ممکن است
اطلاعات تکمیلی نیز ارائه شود.
.SS DHCP6_CONFIG_LOAD_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
configuration error using file: %1, reason: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که پیکربندی DHCPv6 با شکست مواجه شده است.
اگر این یک پیکربندی اولیه باشد (در حین راه‌اندازی سرور)، سرور در شروع به‌کار
ناموفق خواهد بود. اگر این تلاشی برای پیکربندی مجدد پویا باشد، سرور
به استفاده از پیکربندی قدیمی ادامه خواهد داد.
.SS DHCP6_CONFIG_PACKET_QUEUE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCPv6 packet queue info after configuration: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی در حین پیکربندی سرور DHCPv6، بلافاصله پس از
پیکربندی صف بسته‌های DHCPv6 صادر می‌شود. اطلاعات نمایش‌داده‌شده به
نوع صف بستهٔ انتخاب‌شده بستگی دارد.
.SS DHCP6_CONFIG_RECEIVED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
received configuration: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۱۰ ثبت می‌شود.
پیامی اشکال‌زدایی که پیکربندی دریافت‌شده توسط سرور DHCPv6 را فهرست می‌کند.
منبع آن پیکربندی به backend پیکربندیِ مورداستفاده بستگی دارد.
.SS DHCP6_CONFIG_START
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCPv6 server is processing the following configuration: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۱۰ ثبت می‌شود.
این یک پیام اشکال‌زدایی است که هر بار با دریافت یک پیکربندی توسط سرور
صادر می‌شود. این حالت هنگام راه‌اندازی و همچنین زمانی که تغییر پیکربندی
سرور توسط مدیر سیستم اعمال می‌شود، رخ می‌دهد..SS DHCP6_CONFIG_SYNTAX_WARNING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
configuration syntax warning: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار نشان می‌دهد که پیکربندی DHCPv6 دارای یک خطای نحوی جزئی بوده است. خطا نمایش داده شد و تجزیهٔ پیکربندی ادامه یافت.
.SS DHCP6_CONFIG_UNRECOVERABLE_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCPv6 server new configuration failed with an error which cannot be recovered
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطای مهلک زمانی صادر می‌شود که پیکربندی جدید با خطایی مواجه شده که قابل بازیابی نیست. از آن‌جا که کارساز دیگر کار نمی‌کند، باید در سریع‌ترین زمان ممکن یک پیکربندی صحیح اعمال شود.
پیکربندی را می‌توان به چندین روش اصلاح کرد. اگر کانال کنترل باز باشد، می‌توان از config\-set با یک پیکربندی معتبر استفاده کرد. به عنوان روش دیگر، فایل پیکربندی اصلی روی دیسک می‌تواند اصلاح شده و سیگنال SIGHUP ارسال شود (یا دستور config\-reload صادر گردد). در نهایت، کارساز می‌تواند به طور کامل بازراه‌اندازی شود.
.SS DHCP6_CONFIG_UNSUPPORTED_OBJECT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCPv6 server configuration includes an unsupported object: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که پیکربندی شامل یک شیء پشتیبانی‌نشده (یعنی یک عنصر سطح بالا) باشد.
.SS DHCP6_DATA_DIRECTORY_DEPRECATED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(aqdata\-directory\(aq has been deprecated and should no longer be used.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که تجزیهٔ پیکربندی تشخیص دهد پارامتر \fIdata\-directory\fP مشخص شده است. این پارامتر دیگر پشتیبانی نمی‌شود. این مسیر پشتیبانی‌شده که در زمان کامپایل تعیین می‌شود، می‌تواند در زمان اجرا با تنظیم متغیر محیطی \(aqKEA_DHCP_DATA_DIR\(aq بازنویسی شود.
.SS DHCP6_DB_RECONNECT_DISABLED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
database reconnect is disabled: retries left: %1, reconnect wait time: %2, manager ID: %3, timer: %4
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام اطلاعاتی است که نشان می‌دهد ارتباط با پایگاه‌دادهٔ اجاره (lease) یا میزبان یا هر دو قطع شده و اتصال مجدد خودکار فعال نیست.
.SS DHCP6_DB_RECONNECT_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
maximum number of database reconnect attempts: %1, has been exhausted without success, manager ID: %2, timer: %3
.EE
.UNINDENT
.UNINDENT
.sp
این خطا نشان می‌دهد که کارساز پس از انجام حداکثر دفعات تلاش پیکربندی‌شده، در اتصال مجدد به پایگاه(های) دادهٔ اجاره و/یا میزبان ناموفق بوده است. این امر ممکن است طبق آنچه در پیکربندی مشخص شده، باعث متوقف شدن کارساز شود. قطع ارتباط معمولاً یک مشکل شبکه یا کارساز پایگاه‌داده است.
.SS DHCP6_DB_RECONNECT_LOST_CONNECTION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
database connection lost: manager ID: %1, timer: %2.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی نشان می‌دهد که اتصال قطع شده است و سرویس dhcp ممکن است، همان‌طور که در پیکربندی مشخص شده، برای تلاش جهت بازیابی اتصال غیرفعال شده باشد.
.SS DHCP6_DB_RECONNECT_NO_DB_CTL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
unexpected error in database reconnect
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است که بیانگر یک خطای برنامه‌نویسی بوده که نباید رخ دهد. این خطا مانع از تلاش کارساز برای اتصال مجدد به پایگاه‌های داده‌اش در صورت قطع اتصال می‌شود و کارساز خارج می‌گردد. این خطا باید گزارش شود.
.SS DHCP6_DB_RECONNECT_SUCCEEDED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
database connection recovered: manager ID: %1, timer: %2.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی نشان می‌دهد که اتصال بازیابی شده و سرویس dhcp به حالت عادی بازگردانده شده است..SS DHCP6_DDNS_CREATE_ADD_NAME_CHANGE_REQUEST
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: created name change request: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی ثبت می‌شود که NameChangeRequest جدیدی برای انجام
به‌روزرسانی DNS (جهت افزودن RRهای جدید) ایجاد شده باشد.
.SS DHCP6_DDNS_FQDN_GENERATED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: generated FQDN for the client: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی ثبت می‌شود که کارساز یک FQDN (نام) را برای
کارخواهی که پیامش در حال پردازش است، تولید کرده باشد. این نام‌ها ممکن
است بنا به خط‌مشی کارساز یا در صورتی که کارخواه هیچ FQDN مشخصی در پیام
ارسالی خود ارائه نداده باشد، توسط کارساز تولید شوند. آرگومان نخست شامل
اطلاعات شناسایی کارخواه و تراکنش است. آرگومان دوم شامل FQDN تولیدشده
می‌باشد.
.SS DHCP6_DDNS_GENERATED_FQDN_UPDATE_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: failed to update the lease using address %2, after generating FQDN for a client, reason: %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام بیانگر شکست در هنگام تلاش برای به‌روزرسانی اجاره‌نامه یا گزینه‌ها
در پاسخ کارساز با استفاده از نام میزبانی است که کارساز از روی نشانی اختصاص‌یافته
تولید کرده است. آرگومان نخست شامل اطلاعات شناسایی کارخواه و تراکنش است.
آرگومان دوم نشانی اجاره‌داده‌شده است. آرگومان سوم دلیل این شکست را نشان می‌دهد.
.SS DHCP6_DDNS_GENERATE_FQDN
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: client did not send a FQDN option; FQDN will be
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
برای کارخواه تولید خواهد شد.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارساز گزینهٔ FQDN را از کارخواه
دریافت نکرده باشد و جایگزینی نام کارخواه فعال باشد. این سازوکار امکانی را
برای ایجاد مدخل‌های DNS برای کارخواه‌های ساده فراهم می‌آورد.
.SS DHCP6_DDNS_RECEIVE_FQDN
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: received DHCPv6 Client FQDN option: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی ثبت می‌شود که کارساز گزینهٔ DHCPv6 Client FQDN
ارسال‌شده توسط کارخواه را پیدا کرده و پردازش آن را آغاز نموده باشد. آرگومان
نخست شامل اطلاعات شناسایی کارخواه و تراکنش است. آرگومان دوم شامل FQDN
دریافت‌شده می‌باشد.
.SS DHCP6_DDNS_REMOVE_OLD_LEASE_FQDN
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: FQDN for a lease: %2 has changed. New values: hostname = %3, reverse mapping = %4, forward mapping = %5
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی در طول تمدید اجاره‌نامه زمانی ثبت می‌شود که اجاره‌نامهٔ
قدیمی که دیگر ارائه نمی‌شود، FQDN متفاوتی نسبت به اجاره‌نامهٔ در حال تمدید
داشته باشد؛ بنابراین باید مدخل‌های قدیمی DNS حذف شوند. آرگومان نخست شامل
اطلاعات شناسایی کارخواه و تراکنش است. آرگومان دوم جزئیات اجاره‌نامه‌ای را
در بر دارد که اطلاعات FQDN یا نگاشت‌های آن تغییر یافته است. آرگومان‌های
باقی‌مانده اطلاعات جدید FQDN و پرچم‌های مربوط به نگاشت‌ها را نگه‌داری می‌کنند.
.SS DHCP6_DDNS_REQUEST_SEND_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed sending a request to kea\-dhcp\-ddns, error: %1,  ncr: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که کارساز DHCP نگارش ۶ در ارسال درخواست به‌روزرسانی
DDNS به کارساز DHCP\-DDNS با شکست مواجه شده است. این مورد به‌احتمال قوی
ناشی از خطای پیکربندی یا مشکلی در شبکه است.
.SS DHCP6_DDNS_RESPONSE_FQDN_DATA
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: including FQDN option in the server\(aqs response: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارساز در حال گنجاندن گزینهٔ
Client FQDN در پاسخ خود به کارخواه است. آرگومان نخست شامل اطلاعات شناسایی
کارخواه و تراکنش است. آرگومان دوم شامل جزئیات گزینهٔ FQDN گنجانده‌شده
می‌باشد. توجه داشته باشید نامی که در گزینهٔ FQDN حمل می‌شود، ممکن است در
زمان اختصاص اجاره‌نامه به کارخواه، توسط کارساز تغییر یابد..SS DHCP6_DECLINE_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: error on decline lease for address %2: %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که نرم‌افزار به دلیل بروز خطا در حین یک عملیات پایگاه‌داده، موفق به رد کردن (decline) یک اجاره از پایگاه‌داده اجاره‌ها نشده است. آرگومان نخست شامل اطلاعات شناسایی کلاینت و تراکنش است. آرگومان دوم آدرس IPv6 که رد کردن آن انجام شده را نگه می‌دارد. آخرین آرگومان نیز حاوی علت شکست است.
.SS DHCP6_DECLINE_FAIL_DUID_MISMATCH
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Client %1 sent DECLINE for address %2, but it belongs to client with DUID %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی زمانی چاپ می‌شود که یک کلاینت تلاش می‌کند اجاره‌ای را رد کند، اما آن اجاره متعلق به کلاینت دیگری است. درخواست decline رد خواهد شد.
.SS DHCP6_DECLINE_FAIL_IAID_MISMATCH
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Client %1 sent DECLINE for address %2, but used a wrong IAID (%3), instead of expected %4
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی زمانی چاپ می‌شود که یک کلاینت تلاش می‌کند یک اجاره را رد کند. سرور اجاره‌ای برای این آدرس دارد و این اجاره به همین کلاینت تعلق دارد، اما IAID ثبت‌شده با آنچه کلاینت ارسال کرده مطابقت ندارد. این بدان معناست که سرور این Decline را رد خواهد کرد.
.SS DHCP6_DECLINE_FAIL_LEASE_WITHOUT_DUID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Client %1 sent DECLINE for address %2, but the associated lease has no DUID
.EE
.UNINDENT
.UNINDENT
.sp
این وضعیت خطا احتمالاً نشان‌دهنده خرابی پایگاه‌داده است، زیرا انتظار می‌رود هر اجاره IPv6 دارای یک DUID باشد، حتی اگر خالی باشد.
.SS DHCP6_DECLINE_FAIL_NO_LEASE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Client %1 sent DECLINE for address %2, but there\(aqs no lease for it
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی زمانی چاپ می‌شود که کلاینتی تلاش کرده آدرسی را رد کند، اما سرور هیچ اجاره‌ای برای آدرس مذکور ندارد. این بدان معناست که برداشت سرور و کلاینت از اجاره‌ها متفاوت است. علل محتمل این وضعیت می‌تواند این موارد باشد: یک کلاینت سردرگم (مانند ناهماهنگی یا انحراف ساعت) یا یک کلاینت معیوب (مانند جابه‌جا شدن کلاینت به مکانی دیگر بدون این‌که متوجه شود) یا احتمالاً یک حمله (یک کلاینت سرکش تلاش می‌کند آدرس‌های تصادفی را رد کند). سرور به کلاینت اطلاع خواهد داد که درخواست decline او رد شده است و کلاینت باید بتواند از این وضعیت بازیابی شود.
.SS DHCP6_DECLINE_LEASE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Client %1 sent DECLINE for address %2 and the server marked it as declined. The lease will be recovered in %3 seconds.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که کلاینت آدرسی را اجاره کرده، اما متوجه شده که توسط دستگاه دیگری در حال استفاده است و با ارسال یک پیام Decline این موضوع را به سرور گزارش داده است. سرور اجاره را به‌عنوان ردشده (declined) علامت‌گذاری کرده است. این وضعیت احتمالاً حاکی از یک پیکربندی نادرست در شبکه است؛ یا سرور با یک pool نادرست پیکربندی شده است، یا دستگاه‌هایی با آدرس‌های ایستا (statically assigned) در شبکه حضور دارند که قرار بوده توسط سرور DHCP تخصیص داده شوند. هر دوی کلاینت (یک آدرس متفاوت درخواست خواهد کرد) و سرور (پس از سپری شدن decline\-probation\-time اجاره را بازیابی خواهد کرد) به‌صورت خودکار بازیابی خواهند شد. با این حال، اگر ریشه اصلی مشکل برطرف نشود، شرایطی که منجر به ثبت این پیام شده ممکن است دوباره تکرار شود.
.SS DHCP6_DECLINE_PROCESS_IA
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Processing of IA (IAID: %1) from client %2 started.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی چاپ می‌شود که سرور شروع به پردازش یک گزینه IA_NA دریافت‌شده در پیام Decline می‌کند. انتظار می‌رود این گزینه شامل آدرسی باشد که در حال رد شدن است. اطلاعات دقیق‌تر در پیامی جداگانه چاپ خواهد شد.
.SS DHCP6_DEVELOPMENT_VERSION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
This software is a development branch of Kea. It is not recommended for production use.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی نمایش داده می‌شود که نسخه، یک نسخه در حال توسعه (در مقایسه با پایدار) باشد: عدد دوم نسخه فرد است..SS DHCP6_DHCP4O6_PACKET_RECEIVED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
received DHCPv4o6 packet from DHCPv4 server (type %1) for %2 port %3 on interface %4
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی چاپ می‌شود که سرور در حال دریافت یک بسته DHCPv4o6
از سرور DHCPv4 از طریق ارتباط بین‌فرایندی (inter\-process communication) است.
.SS DHCP6_DHCP4O6_RECEIVE_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to receive DHCPv4o6: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که ارتباط بین‌فرایندی با سرور
DHCPv4 با شکست مواجه شده است. دلیل خطا در پیام گنجانده شده است.
.SS DHCP6_DHCP4O6_RECEIVING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
receiving DHCPv4o6 packet from DHCPv4 server
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی چاپ می‌شود که سرور در حال دریافت یک بسته DHCPv4o6
از سرور DHCPv4 از طریق سوکت ارتباط بین‌فرایندی است.
.SS DHCP6_DHCP4O6_RESPONSE_DATA
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: responding with packet %2 (type %3), packet details: %4
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۵ ثبت می‌شود.
یک پیام اشکال‌زدایی شامل داده‌های تفصیلی درباره بسته‌ای که به
کلاینت ارسال می‌شود. آرگومان اول شامل اطلاعات شناسایی کلاینت و
تراکنش است. آرگومان‌های دوم و سوم به ترتیب نام و نوع بسته را نشان می‌دهند.
آرگومان چهارم شامل جزئیات دقیق بسته است.
.SS DHCP6_DHCP4O6_SEND_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: failed to send DHCPv4o6 packet: %2
.EE
.UNINDENT
.UNINDENT
.sp
این خطا در صورتی در خروجی ثبت می‌شود که سرور IPv6 DHCP در ارسال یک پیام
سرهم‌بندی‌شده‌ی DHCPv4o6 به کلاینت شکست بخورد. دلیل خطا در متن پیام
گنجانده شده است.
.SS DHCP6_DYNAMIC_RECONFIGURATION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
initiate server reconfiguration using file: %1, after receiving SIGHUP signal or config\-reload command
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی (info) زمانی ثبت می‌شود که سرور DHCPv6
در نتیجه دریافت سیگنال SIGHUP یا دستور config\-reload، پیکربندی مجدد را آغاز کند.
.SS DHCP6_DYNAMIC_RECONFIGURATION_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
dynamic server reconfiguration failed with file: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطای مهلک (fatal) زمانی ثبت می‌شود که پیکربندی مجدد پویای
سرور DHCP با شکست مواجه شده باشد.
.SS DHCP6_DYNAMIC_RECONFIGURATION_SUCCESS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
dynamic server reconfiguration succeeded with file: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی (info) زمانی ثبت می‌شود که پیکربندی مجدد پویای سرور DHCP
با موفقیت انجام شده باشد.
.SS DHCP6_FATAL_OPEN_SOCKETS_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
maximum number of open service sockets attempts: %1, has been exhausted without success
.EE
.UNINDENT
.UNINDENT
.sp
این خطا نشان می‌دهد که سرور پس از انجام حداکثر تعداد تلاش‌های پیکربندی‌شده،
در متصل ساختن (bind) سوکت‌های سرویس ناموفق بوده است. این امر باعث خاموش شدن سرور،
طبق آنچه در پیکربندی مشخص شده است، می‌گردد.
.SS DHCP6_FLEX_ID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: flexible identifier generated for incoming packet: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی چاپ می‌شود که نوع رزرو میزبان (host reservation) روی
شناسه انعطاف‌پذیر (flexible identifier) تنظیم شده باشد و عبارت مشخص‌شده در
پیکربندی آن، شناسه‌ای برای بسته ورودی تولید کرده باشد (عبارت ارزیابی شده باشد).
هدف اصلی این پیام اشکال‌زدایی، کمک به خطایابی flexible identifier است..SS DHCP6_HOOK_ADDR6_REGISTER_DROP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: ADDR\-REG\-INFORM for %2 is dropped, because a callout set the next step to DROP
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی ثبت می‌شود که یک فراخوان (callout) نصب‌شده روی
نقطه قلاب (hook point) addr6_register، گام بعدی را روی DROP تنظیم کند. برای این
نقطه قلاب به‌خصوص، مقدار تنظیم‌شده به کارساز دستور می‌دهد تا ثبت نشانی را لغو کرده و
بسته را دور بیندازد (drop کند).
.SS DHCP6_HOOK_ADDR6_REGISTER_SKIP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: lease %2 operation for %3 is skipped, because a callout set the next step to SKIP
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی ثبت می‌شود که یک فراخوان نصب‌شده روی
نقطه قلاب addr6_register، گام بعدی را روی SKIP تنظیم کند. برای این نقطه قلاب
به‌خصوص، مقدار تنظیم‌شده به کارساز دستور می‌دهد تا از عملیات افزودن یا به‌روزرسانی اجاره (lease)
برای نشانی ثبت‌شده صرف‌نظر کند، بنابراین وضعیت ثبت نگهداری نخواهد شد.
.SS DHCP6_HOOK_BUFFER_RCVD_DROP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
received buffer from %1 to %2 over interface %3 was dropped because a callout set the drop flag
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۱۵ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی ثبت می‌شود که یک فراخوان نصب‌شده روی نقطه قلاب
buffer6_receive پرچم drop را تنظیم کند. برای این نقطه قلاب به‌خصوص،
تنظیم این پرچم توسط یک فراخوان به کارساز دستور می‌دهد تا بسته را دور بیندازد.
آرگومان‌ها نشانی مبدأ و مقصد و همچنین نام رابطی (interface) را که بافر
از طریق آن دریافت شده است مشخص می‌کنند.
.SS DHCP6_HOOK_BUFFER_RCVD_SKIP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
received buffer from %1 to %2 over interface %3 is not parsed because a callout set the next step to SKIP
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی ثبت می‌شود که یک فراخوان نصب‌شده روی
نقطه قلاب buffer6_receive وضعیت گام بعدی را روی skip تنظیم کند. برای این نقطه
قلاب به‌خصوص، این مقدار تنظیم‌شده توسط فراخوان به کارساز دستور می‌دهد تا
بافر را تجزیه (parse) نکند، زیرا پیش‌تر توسط قلاب تجزیه شده است.
آرگومان‌ها نشانی مبدأ و مقصد و همچنین نام رابطی را که بافر از طریق آن
دریافت شده است مشخص می‌کنند.
.SS DHCP6_HOOK_BUFFER_SEND_SKIP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: prepared DHCPv6 response was dropped because a callout set the next step to SKIP
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی ثبت می‌شود که یک فراخوان نصب‌شده روی نقطه قلاب
buffer6_send مقدار گام بعدی را روی SKIP تنظیم کند. برای این نقطه قلاب به‌خصوص،
تنظیم SKIP توسط فراخوان به کارساز دستور می‌دهد که بسته را دور بیندازد.
کارساز تمامی پردازش‌ها را تکمیل کرده است (برای نمونه ممکن است اجاره‌ها را تخصیص داده،
به‌روزرسانی یا آزاد کرده باشد)، اما پاسخ به کلاینت ارسال نخواهد شد.
آرگومان شامل اطلاعات شناسایی کلاینت و تراکنش است.
.SS DHCP6_HOOK_DDNS_UPDATE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
A hook has updated the DDNS parameters: hostname %1=>%2, forward update %3=>%4, reverse update %5=>%6
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۱۵ ثبت می‌شود.
این پیام نشان می‌دهد که یک قلاب روی نقطه قلاب ddns6_update فراخوانی شده
و آن قلاب پارامترهای به‌روزرسانی DDNS را تغییر داده است: نام میزبان (hostname)، یا اینکه آیا
به‌روزرسانی مستقیم (رکورد A) یا معکوس (رکورد PTR) برای DDNS انجام گیرد یا خیر.
.SS DHCP6_HOOK_DECLINE_DROP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
During Decline processing (client=%1, interface=%2, addr=%3) hook callout set next step to DROP, dropping packet.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۱۵ ثبت می‌شود.
این پیام نشان می‌دهد که کارساز پیام DECLINE را دریافت کرده، درستی آن تأیید
شده و با اطلاعات اجاره در کارساز مطابقت داشته است. کارساز قلاب‌ها را
برای نقطه قلاب lease6_decline فراخوانی کرده و یکی از فراخوان‌ها وضعیت گام بعدی را روی DROP تنظیم کرده است.
اکنون کارساز پردازش بسته را متوقف می‌کند، به گونه‌ای که انگار هرگز دریافت
نشده است. اجاره همچنان در وضعیت تخصیص‌یافته به این کلاینت باقی می‌ماند.
.SS DHCP6_HOOK_DECLINE_SKIP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
During Decline processing (client=%1, interface=%2, addr=%3) hook callout set status to SKIP, skipping decline.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام نشان می‌دهد که کارساز پیام DECLINE را دریافت کرده، درستی آن تأیید
شده و با اطلاعات اجاره در کارساز مطابقت داشته است. کارساز قلاب‌ها را
برای نقطه قلاب lease6_decline فراخوانی کرده و یکی از فراخوان‌ها وضعیت گام بعدی را روی SKIP تنظیم کرده است.
کارساز از عملیات انتقال اجاره به وضعیت ردشده (declined) صرف‌نظر کرده و
به پردازش بسته ادامه می‌دهد. به‌ویژه، پیامی از نوع REPLY ارسال خواهد کرد
به گونه‌ای که گویی رد اجاره (decline) واقعاً اتفاق افتاده است..SS DHCP6_HOOK_LEASE6_RELEASE_NA_SKIP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: اجاره نشانی DHCPv6 آزاد نشد زیرا یک callout گام بعدی را روی SKIP تنظیم کرده است
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی چاپ می‌شود که یک callout نصب‌شده روی نقطه قلاب lease6_release گام بعدی را روی SKIP تنظیم کرده باشد. برای این نقطه قلاب به‌خصوص، این تنظیم توسط callout به سرور دستور می‌دهد که اجاره را آزاد نکند. اگر یک کلاینت درخواست آزادسازی چندین اجاره را داده باشد (با ارسال چندین گزینه IA)، سرور این اجاره خاص را نگه داشته و طبق روال معمول آزادسازی موارد دیگر را ادامه می‌دهد. این آرگومان حاوی اطلاعات شناسایی کلاینت و تراکنش است.
.SS DHCP6_HOOK_LEASE6_RELEASE_PD_SKIP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: اجاره پیشوند آزاد نشد زیرا یک callout گام بعدی را روی SKIP تنظیم کرده است
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی چاپ می‌شود که یک callout نصب‌شده روی نقطه قلاب lease6_release گام بعدی را روی مقدار SKIP تنظیم کند. برای این نقطه قلاب به‌خصوص، این تنظیم توسط callout به سرور دستور می‌دهد که اجاره را آزاد نکند. اگر کلاینت درخواست آزادسازی چندین اجاره را داشته باشد (با ارسال چندین گزینه IA)، سرور این اجاره به‌خصوص را نگه داشته و طبق روال معمول تمدیدهای دیگر را ادامه خواهد داد. این آرگومان حاوی اطلاعات شناسایی کلاینت و تراکنش است.
.SS DHCP6_HOOK_LEASES6_COMMITTED_DROP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: بسته دور انداخته شد، زیرا یک callout گام بعدی را روی DROP تنظیم کرده است
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۱۵ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی چاپ می‌شود که یک callout نصب‌شده روی نقطه قلاب leases6_committed گام بعدی را روی DROP تنظیم کند.
.SS DHCP6_HOOK_LEASES6_COMMITTED_PARK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: بسته پارک شد، زیرا یک callout گام بعدی را روی PARK تنظیم کرده است
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی چاپ می‌شود که یک callout نصب‌شده روی نقطه قلاب leases6_committed گام بعدی را روی PARK تنظیم کند.
.SS DHCP6_HOOK_LEASES6_PARKING_LOT_FULL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
محدودیت parked\-packet\-limit به میزان %1 رسیده است، در حال دور انداختن پرس‌وجو: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۱۵ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی رخ می‌دهد که محوطه پارک (parking lot) مورد استفاده برای نگه‌داشتن پرس‌وجوهای کلاینت تا زمان تکمیل کار کتابخانه قلاب برای آن‌ها، به حد تعیین‌شده توسط پارامتر سراسری parked\-packet\-limit رسیده یا از آن فراتر رفته باشد. این وضعیت می‌تواند زمانی رخ دهد که kea\-dhcp6 در حال استفاده از کتابخانه‌های قلاب (مانند HA) است که callout مربوط به \(dqleases6\-committed\(dq را پیاده‌سازی می‌کنند و پرس‌وجوهای کلاینت سریع‌تر از توانایی آن calloutها برای پاسخ‌گویی به آن‌ها، دریافت می‌شوند.
.SS DHCP6_HOOK_PACKET_RCVD_SKIP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: بسته دور انداخته شد، زیرا یک callout گام بعدی را روی SKIP تنظیم کرده است
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی چاپ می‌شود که یک callout نصب‌شده روی نقطه قلاب pkt6_receive گام بعدی را روی SKIP تنظیم کند. برای این نقطه قلاب به‌خصوص، تنظیم این مقدار به سرور دستور می‌دهد که بسته را دور بیندازد.
.SS DHCP6_HOOK_PACKET_SEND_DROP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: پاسخ آماده‌شده‌ی DHCPv6 ارسال نشد زیرا یک callout گام بعدی را روی DROP تنظیم کرده است
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۱۵ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی چاپ می‌شود که یک callout نصب‌شده روی نقطه قلاب pkt6_send گام بعدی را روی DROP تنظیم کند. برای این نقطه قلاب به‌خصوص، تنظیم این مقدار توسط یک callout به سرور دستور می‌دهد که بسته را دور بیندازد. این عملاً بدین معناست که کلاینت هیچ پاسخی دریافت نخواهد کرد، حتی اگر سرور درخواست کلاینت را پردازش کرده و بر اساس آن اقدام کرده باشد (مثلاً احتمالاً یک اجاره تخصیص داده باشد). این آرگومان اطلاعات شناسایی کلاینت و تراکنش را مشخص می‌کند.
.SS DHCP6_HOOK_PACKET_SEND_SKIP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: پاسخ آماده‌شده‌ی DHCPv6 ساخته نشد زیرا یک callout گام بعدی را روی SKIP تنظیم کرده است
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی چاپ می‌شود که یک callout نصب‌شده روی نقطه قلاب pkt6_send گام بعدی را روی SKIP تنظیم کند. برای این نقطه قلاب به‌خصوص، تنظیم این مقدار توسط یک callout به سرور دستور می‌دهد که داده‌های ارسالی روی شبکه (pack) را نسازد، زیرا این کار قبلاً توسط قلاب انجام شده است. این آرگومان اطلاعات شناسایی کلاینت و تراکنش را مشخص می‌کند..SS DHCP6_HOOK_SUBNET6_SELECT_DROP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: packet was dropped because a callout set the drop flag
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی چاپ می‌شود که یک callout نصب‌شده روی نقطه قلاب subnet6_select پرچم drop را تنظیم کرده باشد. برای این نقطه قلاب به‌خصوص، تنظیم این پرچم به سرور دستور می‌دهد که بسته دریافتی را دور بیندازد (drop کند). آرگومان حاوی اطلاعات شناسایی کلاینت و تراکنش است.
.SS DHCP6_HOOK_SUBNET6_SELECT_PARK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: packet was parked
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی چاپ می‌شود که یک callout نصب‌شده روی نقطه قلاب subnet6_select پرچم park را تنظیم کرده باشد. آرگومان حاوی اطلاعات شناسایی کلاینت و تراکنش است.
.SS DHCP6_HOOK_SUBNET6_SELECT_SKIP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: no subnet was selected because a callout set the next step to SKIP
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی چاپ می‌شود که یک callout نصب‌شده روی نقطه قلاب subnet6_select گام بعدی را روی مقدار SKIP تنظیم کرده باشد. برای این نقطه قلاب به‌خصوص، تنظیم این مقدار به سرور دستور می‌دهد که هیچ زیرشبکه‌ای را انتخاب نکند؛ اقدامی که پردازش‌های بعدی را به‌شدت محدود می‌سازد؛ سرور تنها قادر به ارائه گزینه‌های سراسری (global options) خواهد بود \- هیچ آدرس یا پیشوندی تخصیص داده نخواهد شد. آرگومان حاوی اطلاعات شناسایی کلاینت و تراکنش است.
.SS DHCP6_INIT_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to initialize Kea server: %1
.EE
.UNINDENT
.UNINDENT
.sp
سرور در برقراری ارتباط با سایر بخش‌های Kea ناموفق بوده است، در خواندن فایل پیکربندی JSON شکست خورده، یا با هر مشکل بحرانی دیگری مواجه شده است که مانع از راه‌اندازی درست آن می‌شود. پیام خطای پیوست‌شده جزئیات بیشتری درباره این مشکل ارائه می‌دهد.
.SS DHCP6_LEASE_ADVERT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: lease for address %2 and iaid=%3 will be advertised
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اطلاع‌رسانی نشان می‌دهد که سرور یک آدرس را در پیام ADVERTISE به کلاینت اعلان (advertise) خواهد کرد. کلاینت در تبادل پیام بعدی، با ارسال پیام REQUEST درخواست تخصیص این آدرس را ثبت خواهد کرد. آرگومان اول شامل اطلاعات شناسایی کلاینت و تراکنش است. آرگومان‌های باقی‌مانده آدرس تخصیص‌یافته و IAID را نگه‌داری می‌کنند.
.SS DHCP6_LEASE_ADVERT_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: failed to advertise an address lease for iaid=%2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام نشان می‌دهد که سرور در پاسخ به یک پیام دریافتی SOLICIT، نتوانسته است یک اجاره آدرس غیرموقت (non\-temporary) را برای کلاینت مربوطه اعلان کند. ممکن است دلایل متعددی برای این شکست وجود داشته باشد. هر شکست در یک مدخل لاگ جداگانه ثبت می‌شود. آرگومان اول حاوی اطلاعات شناسایی کلاینت و تراکنش است. آرگومان دوم IAID را نگه‌داری می‌کند.
.SS DHCP6_LEASE_ALLOC
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: lease for address %2 and iaid=%3 has been allocated for %4 seconds
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اطلاع‌رسانی نشان می‌دهد که در پاسخ به پیام REQUEST کلاینت، سرور با موفقیت یک اجاره آدرس غیرموقت (non\-temporary) را اعطا کرده است. این یک رفتار عادی بوده و نشان‌دهنده عملکرد موفقیت‌آمیز است. آرگومان اول شامل اطلاعات شناسایی کلاینت و تراکنش است. آرگومان‌های باقی‌مانده حاوی آدرس تخصیص‌یافته، IAID و طول‌عمر اعتبار (validity lifetime) هستند.
.SS DHCP6_LEASE_ALLOC_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: failed to grant an address lease for iaid=%2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام نشان می‌دهد که سرور در پاسخ به یک REQUEST دریافتی، در اعطای اجاره آدرس غیرموقت (non\-temporary) به کلاینت ناموفق بوده است. دلایل متعددی می‌تواند برای چنین شکستی وجود داشته باشد. هر شکست در یک مدخل لاگ جداگانه ثبت می‌شود. آرگومان اول حاوی اطلاعات شناسایی کلاینت و تراکنش است. آرگومان دوم IAID را نگه‌داری می‌کند..SS DHCP6_LEASE_DATA
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: detailed lease information for iaid=%2: %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی برای چاپ اطلاعات دقیق دربارهٔ اجارهٔ تخصیص‌یافته یا اجاره‌ای که به کلاینت اعلان خواهد شد به کار می‌رود.
آرگومان نخست حاوی اطلاعات شناسایی کلاینت و تراکنش است.
آرگومان دوم حاوی IAID است.
آرگومان سوم حاوی اطلاعات دقیق اجاره است.
.SS DHCP6_LEASE_NA_WITHOUT_DUID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: address lease for address %2 does not have a DUID
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا بیانگر مشکلی در سازگاری پایگاه داده است. پایگاه دادهٔ اجاره‌ها دارای مدخلی است که نشان می‌دهد آدرس داده‌شده در حال استفاده است، اما اجاره شامل هیچ شناسهٔ کلاینتی نیست. این مسئله به احتمال زیاد به دلیل یک خطای نرم‌افزاری است: لطفاً یک گزارش باگ ارسال کنید. به عنوان راهکاری موقت، مدخل اجاره را به صورت دستی از پایگاه داده حذف کنید. آرگومان نخست شامل اطلاعات شناسایی کلاینت و تراکنش است. آرگومان دوم حاوی آدرسی است که باید آزاد شود.
.SS DHCP6_LEASE_PD_WITHOUT_DUID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: lease for prefix %2/%3 does not have a DUID
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا بیانگر نقصی در سازگاری پایگاه داده است. پایگاه دادهٔ اجاره‌ها مدخلی دارد که مشخص می‌کند پیشوند داده‌شده در حال استفاده است، اما این اجاره شامل هیچ شناسهٔ کلاینتی نیست. این موضوع به احتمال فراوان ناشی از یک خطای نرم‌افزاری است: لطفاً یک گزارش باگ ارسال کنید. به عنوان راهکاری موقت، مدخل اجاره را به صورت دستی از پایگاه داده حذف کنید. آرگومان نخست شامل اطلاعات شناسایی کلاینت و تراکنش است. آرگومان‌های دوم و سوم حاوی پیشوند و طول پیشوند هستند.
.SS DHCP6_LEASE_QUERY_ERROR_GETTING_RELAY_INFO
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to get relay information for lease: %1, reason: %2
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام هشدار است که نشان می‌دهد سرور نتوانسته از اطلاعات رلهٔ ذخیره‌شده در user\-context اجاره برای ساخت گزینهٔ lq\-relay\-data جهت DHCPV6_LEASEQUERY_REPLY استفاده کند. سرور همچنان پاسخ را به درخواست‌کننده ارسال می‌کند اما بدون گزینهٔ lq\-relay\-data. محتمل‌ترین دلیل برای این موضوع یا یک فایل اجارهٔ خراب است یا یک خطای برنامه‌نویسی و باید گزارش شود. آرگومان نخست جزئیات اجاره و آرگومان دوم خطای مشخص‌شده است.
.SS DHCP6_LEASE_QUERY_PACKET_PACK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: preparing on\-wire format of the packet to be sent
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور شروع به آماده‌سازی قالب on\-wire بسته برای ارسال به کلاینت می‌کند. آرگومان مشخص‌کنندهٔ اطلاعات شناسایی کلاینت و تراکنش است.
.SS DHCP6_LEASE_QUERY_PACKET_PACK_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: preparing on\-wire\-format of the packet to be sent failed %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا هنگامی صادر می‌شود که آماده‌سازی قالب on\-wire بسته با شکست مواجه شده باشد. آرگومان نخست کلاینت و
.SS DHCP6_LEASE_QUERY_PACKET_UNPACK_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to parse query from %1 to %2, received over interface %3, reason: %4
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که DHCPV6_LEASEQUERY دریافت‌شده بدریخت باشد و نتواند توسط فراخوانی buffer6_receive تجزیه شود. پرس‌وجو توسط سرور دور انداخته خواهد شد. سه آرگومان نخست، آدرس IP مبدأ، آدرس IP مقصد و رابط را مشخص می‌کنند. آخرین آرگومان دلیلی برای شکست ارائه می‌دهد.
.SS DHCP6_LEASE_QUERY_PREFIX_LENGTH_LIST
.INDENT 0.0
.INDENT 3.5
.sp
.EX
the list of prefix lengths to use when searching will be: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی پس از یک رویداد پیکربندی (مجدد) صادر می‌شود تا فهرستی از طول پیشوندهای واگذارشده را نمایش دهد که هنگام جستجو برای پیشوند واگذارشده‌ای که آدرس پرس‌وجو به آن تعلق دارد، استفاده خواهند شد. این آرگومان فهرستی از طول پیشوندها به ترتیبی است که هنگام جستجوها استفاده می‌شوند..SS DHCP6_LEASE_QUERY_PROCESS_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
processing failed for lease query: %1, reason: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام خطا زمانی صادر می‌شود که کارگزار هنگام پردازش یک DHCPV6_LEASEQUERY با خطا مواجه شود. آرگومان نخست جزئیات پرس‌وجو و آرگومان دوم شرح خطا را ارائه می‌دهد.
.SS DHCP6_LEASE_QUERY_RECEIVED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
received query: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی چاپ می‌شود که پرس‌وجوی DHCPV6_LEASEQUERY دریافت شده باشد.
.SS DHCP6_LEASE_QUERY_REPLY_SEND_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
unable to send response: %1, iface: %2, address %3:%4 error: %5
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که کارگزار نتواند پاسخ پرس‌وجوی اجاره (lease query) را برای درخواست‌کننده ارسال کند. آرگومان نخست جزئیات پرس‌وجو را نشان می‌دهد و به‌دنبال آن رابط خروجی، آدرس IP و درگاه، و در نهایت خود خطا می‌آید.
.SS DHCP6_LEASE_QUERY_REPLY_SENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
response: %1, sent to %2:%3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی چاپ می‌شود که پاسخی به یک DHCPV6_LEASEQUERY برای درخواست‌کننده ارسال شده باشد. آرگومان نخست جزئیات پاسخ را ارائه می‌دهد و آرگومان‌های دوم و سوم آدرس IP و درگاهی هستند که پاسخ به آن‌ها فرستاده شده است.
.SS DHCP6_LEASE_RENEW
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: lease for address %2 and iaid=%3 has been allocated
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی بیانگر این است که کارگزار در پاسخ به پیام REQUEST کلاینت، اجارهٔ یک آدرس غیرموقت (non\-temporary) را با موفقیت تمدید کرده است. این یک رفتار عادی بوده و نشان‌دهندهٔ عملکرد موفق است. آرگومان نخست حاوی اطلاعات شناسایی کلاینت و تراکنش است. باقی آرگومان‌ها آدرس تخصیص‌یافته و IAID را نگه‌داری می‌کنند.
.SS DHCP6_LEASE_REUSE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: lease for address %2 and iaid=%3 has been reused for %4 seconds
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی بیانگر این است که کارگزار در پاسخ به پیام کلاینت، اجارهٔ یک آدرس غیرموقت را با موفقیت مجدداً استفاده کرده است (reuse). این یک رفتار عادی بوده و نشان‌دهندهٔ عملکرد موفق است. آرگومان نخست حاوی اطلاعات شناسایی کلاینت و تراکنش است. باقی آرگومان‌ها آدرس تخصیص‌یافته، IAID و طول عمر اعتبار (validity lifetime) را دربرمی‌گیرند.
.SS DHCP6_MULTI_THREADING_INFO
.INDENT 0.0
.INDENT 3.5
.sp
.EX
enabled: %1, number of threads: %2, queue size: %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیامی است که برخی اطلاعات مربوط به پارامترهای چندنخی (multi\-threading) را که کارگزار با آن‌ها در حال اجرا است فهرست می‌کند.
.SS DHCP6_NOT_RUNNING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
IPv6 DHCP server is not running
.EE
.UNINDENT
.UNINDENT
.sp
هنگامی که تلاشی برای خاموش کردن کارگزار IPv6 DHCP صورت گیرد اما کارگزار در حال اجرا نباشد، یک پیام هشدار صادر می‌شود.
.SS DHCP6_NO_INTERFACES
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to detect any network interfaces
.EE
.UNINDENT
.UNINDENT
.sp
کارگزار IPv6 DHCP در حین راه‌اندازی موفق به شناسایی هیچ رابط شبکه‌ای نشد و به همین دلیل در حال متوقف شدن است..SS DHCP6_OPEN_SOCKET
.INDENT 0.0
.INDENT 3.5
.sp
.EX
opening service sockets on port %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۰ ثبت می‌شود.
این پیام اشکال‌زدایی در حین راه‌اندازی صادر می‌شود و نشان می‌دهد که سرور IPv6 DHCP در شرف باز کردن سوکت‌ها روی درگاه (port) مشخص‌شده است.
.SS DHCP6_OPEN_SOCKETS_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
maximum number of open service sockets attempts: %1, has been exhausted without success
.EE
.UNINDENT
.UNINDENT
.sp
این خطا نشان می‌دهد که سرور پس از انجام حداکثر تعداد تلاش‌های پیکربندی‌شده، در متصل کردن (bind) سوکت‌های سرویس ناموفق بوده است.
.SS DHCP6_OPEN_SOCKETS_NO_RECONNECT_CTL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
unexpected error in bind service sockets.
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است که نشان‌دهنده خطایی در برنامه‌نویسی است که نباید رخ دهد. این خطا مانع از تلاش سرور برای متصل شدن به سوکت‌های سرویس در صورت در دسترس نبودن آن‌ها می‌شود و سرور خارج می‌شود. این خطا باید گزارش شود.
.SS DHCP6_PACKET_DROP_DHCP_DISABLED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: DHCP service is globally disabled
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۱۵ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک بسته به دلیل غیرفعال بودن موقت سرویس DHCP دور انداخته (drop) می‌شود. این مسئله بر تمام بسته‌های دریافتی DHCP اثر می‌گذارد. سرویس ممکن است توسط دستور کنترلی \(dqdhcp\-enable\(dq یا به‌طور خودکار پس از گذشت مدت‌زمان مشخصی از دریافت دستور \(dqdhcp\-disable\(dq دوباره فعال شود.
.SS DHCP6_PACKET_DROP_DROP_CLASS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
dropped as member of the special class \(aqDROP\(aq: %1 %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۱۵ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک بسته دریافتی در کلاس ویژه \(aqDROP\(aq دسته‌بندی شده و دور انداخته شود. جزئیات بسته نمایش داده می‌شود.
.SS DHCP6_PACKET_DROP_DROP_CLASS2
.INDENT 0.0
.INDENT 3.5
.sp
.EX
dropped as member of the special class \(aqDROP\(aq after host reservation lookup: %1 %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۱۵ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک بسته دریافتی پس از جستجوی رزرو میزبان (host reservation lookup) در کلاس ویژه \(aqDROP\(aq دسته‌بندی شده و دور انداخته شود. جزئیات بسته نمایش داده می‌شود.
.SS DHCP6_PACKET_DROP_DROP_CLASS_EARLY
.INDENT 0.0
.INDENT 3.5
.sp
.EX
dropped as member of the special class \(aqDROP\(aq after early global host reservations lookup: %1 %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۱۵ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک بسته دریافتی پس از جستجوی زودهنگام و سراسری رزروهای میزبان در کلاس ویژه \(aqDROP\(aq دسته‌بندی شده و دور انداخته شود. جزئیات بسته نمایش داده می‌شود.
.SS DHCP6_PACKET_DROP_DUPLICATE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
dropped as sent by the same client than a packet being processed by another thread: dropped %1 %2 by thread %3 as duplicate of %4 %5 processed by thread %6
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۱۵ ثبت می‌شود.
در حال حاضر پردازش چندنخی (multi\-threading) با دور انداختن بسته‌های جدید تا زمان پایان پردازش، از تداخل و شرایط رقابتی (race condition) بین بسته‌های ارسال‌شده توسط یک کلاینت یکسان جلوگیری می‌کند. جزئیات بسته‌ها و شناسه‌های نخ‌ها برای هر دو بسته در این پیام هشدار گنجانده شده است.
.SS DHCP6_PACKET_DROP_PARSE_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: failed to parse packet from %2 to %3, received over interface %4, reason: %5, %6
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۱۵ ثبت می‌شود.
سرور DHCPv6 بسته‌ای دریافت کرده است که قادر به تفسیر و تجزیه آن نیست. دلیل نامعتبر بودن بسته در پیام ذکر شده است..SS DHCP6_PACKET_DROP_SERVERID_MISMATCH
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: dropping packet with server identifier: %2, server is using: %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۱۵ ثبت می‌شود.
پیامی اشکال‌زدایی که نشان می‌دهد سرور پیامی حاوی گزینهٔ شناسهٔ سرور (server identifier) دریافت کرده است که با شناسهٔ سروری که خود سرور استفاده می‌کند، همخوانی ندارد.
.SS DHCP6_PACKET_DROP_UNICAST
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: dropping unicast %2 packet as this packet should be sent to multicast
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۱۵ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور بستهٔ تک‌پخشی (unicast) را دور می‌اندازد، زیرا بسته‌هایی از این نوع باید به‌صورت چندپخشی (multicast) ارسال شوند. آرگومان نخست اطلاعات شناسایی کلاینت و تراکنش را مشخص می‌کند و آرگومان دوم نوع بسته را تعیین می‌نماید.
.SS DHCP6_PACKET_OPTIONS_SKIPPED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: An error unpacking an option, caused subsequent options to be skipped: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که باز کردن (unpack) یک گزینه با خطا مواجه شده و در نتیجه باز کردن گزینه‌های باقی‌مانده در بسته غیرممکن شده است. سرور همچنان تلاش خواهد کرد تا به این بسته رسیدگی کند.
.SS DHCP6_PACKET_PROCESS_EXCEPTION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: exception occurred during packet processing
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که در حین پردازش بسته، یک استثنای (exception) غیر استاندارد رخ داده است که توسط سایر مدیریت‌کننده‌های اختصاصی‌ترِ استثنا گرفته نشده است. این بسته دور انداخته می‌شود و سرور به کار خود ادامه خواهد داد.
.SS DHCP6_PACKET_PROCESS_EXCEPTION_MAIN
.INDENT 0.0
.INDENT 3.5
.sp
.EX
exception occurred during packet processing
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که در حین پردازش بسته، یک استثنای غیر استاندارد رخ داده است که توسط سایر مدیریت‌کننده‌های اختصاصی‌ترِ استثنا گرفته نشده است. این بسته دور انداخته می‌شود و سرور به کار خود ادامه خواهد داد. این پیام خطا ممکن است در حلقهٔ اصلی پردازش سرور رخ دهد.
.SS DHCP6_PACKET_PROCESS_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: processing of %2 message received from %3 failed: %4
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این یک پیام کلی و فراگیر است که نشان می‌دهد پردازش نوع پیام مشخص‌شده از آدرس اعلام‌شده با شکست مواجه شده است. دلیل آن در متن پیام ذکر شده است. سرور پاسخی ارسال نخواهد کرد، بلکه بسته را نادیده می‌گیرد.
.SS DHCP6_PACKET_PROCESS_STD_EXCEPTION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: exception occurred during packet processing: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که در حین پردازش بسته، یک استثنای استاندارد رخ داده است که توسط سایر مدیریت‌کننده‌های اختصاصی‌ترِ استثنا گرفته نشده است. این بسته دور انداخته می‌شود و سرور به کار خود ادامه خواهد داد.
.SS DHCP6_PACKET_PROCESS_STD_EXCEPTION_MAIN
.INDENT 0.0
.INDENT 3.5
.sp
.EX
exception occurred during packet processing: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که در حین پردازش بسته، یک استثنای استاندارد رخ داده است که توسط سایر مدیریت‌کننده‌های اختصاصی‌ترِ استثنا گرفته نشده است. این بسته دور انداخته می‌شود و سرور به کار خود ادامه خواهد داد. این پیام خطا ممکن است در حلقهٔ اصلی پردازش سرور رخ دهد.
.SS DHCP6_PACKET_QUEUE_FULL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
multi\-threading packet queue is full
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
پیامی اشکال‌زدایی حاکی از آنکه صف بسته‌های چندرشته‌ای (multi\-threading) پر شده است؛ بنابراین قدیمی‌ترین بستهٔ صف دور انداخته شد تا فضایی برای بستهٔ دریافت‌شده باز شود..SS DHCP6_PACKET_RECEIVED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: %2 (type %3) received from %4 to %5 on interface %6
.EE
.UNINDENT
.UNINDENT
.sp
یک پیام INFO که نشان می‌دهد سرور نوع مشخص‌شده‌ای از بسته را روی رابط مشخص‌شده دریافت کرده است. آرگومان نخست، اطلاعات شناسایی کلاینت و تراکنش را مشخص می‌کند. آرگومان‌های دوم و سوم به ترتیب نام پیام DHCPv6 و نوع عددی آن را مشخص می‌کنند. باقی آرگومان‌ها نشانی مبدأ، نشانی IP مقصد و نام رابطی را که پیام روی آن دریافت شده است مشخص می‌کنند.
.SS DHCP6_PACKET_RECEIVE_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
error on attempt to receive packet: %1
.EE
.UNINDENT
.UNINDENT
.sp
سرور IPv6 DHCP برای دریافت یک بسته تلاش کرد اما در حین این تلاش خطایی رخ داد. علت خطا در پیام گنجانده شده است.
.SS DHCP6_PACKET_REJECT_CLASS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
assignment rejected as member of the special class \(aqREJECT\(aq: %1 %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۱۵ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک بستهٔ دریافتی در کلاس ویژهٔ \(aqREJECT\(aq طبقه‌بندی شده و هیچ منبعی به آن تخصیص نیافته است.
جزئیات بسته نمایش داده می‌شوند.
.SS DHCP6_PACKET_SEND
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: trying to send packet %2 (type %3) from [%4]:%5 to [%6]:%7 on interface %8
.EE
.UNINDENT
.UNINDENT
.sp
یک پیام INFO که نشان می‌دهد سرور در حال تلاش برای ارسال نوع مشخص‌شده‌ای از بسته است. آرگومان‌ها اطلاعات شناسایی کلاینت (نشانی HW و شناسه کلاینت)، نام و نوع پیام DHCP، نشانی و درگاه IPv6 مبدأ، نشانی و درگاه IPv6 مقصد و نام رابط را مشخص می‌کنند.
.SS DHCP6_PACKET_SEND_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: failed to send DHCPv6 packet: %2
.EE
.UNINDENT
.UNINDENT
.sp
این خطا در صورتی در خروجی ثبت می‌شود که سرور IPv6 DHCP نتواند پیام سرهم‌شدهٔ DHCP را به یک کلاینت ارسال کند. علت خطا در پیام گنجانده شده است.
.SS DHCP6_PACK_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: failed to assemble response correctly: %2
.EE
.UNINDENT
.UNINDENT
.sp
این خطا زمانی در خروجی ثبت می‌شود که سرور نتواند داده‌های بازگشتی به کلاینت را در قالب یک بستهٔ معتبر سرهم‌بندی کند. به احتمال زیاد علت این امر یک خطای برنامه‌نویسی است: لطفاً یک گزارش باگ ارسال کنید.
.SS DHCP6_PARSER_COMMIT_EXCEPTION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
parser failed to commit changes
.EE
.UNINDENT
.UNINDENT
.sp
هنگام دریافت پیامی حاوی جزئیات تغییر در پیکربندی سرور IPv6 DHCP، مجموعه‌ای از تجزیه‌کننده‌ها با موفقیت ایجاد شدند، اما یکی از آن‌ها به دلیل رخ دادن یک استثنای سطح‌پایین سیستمی، در اعمال (commit) تغییرات خود شکست خورد. ممکن است پیام‌های دیگری نیز برای نشان دادن علت در خروجی ظاهر شوند.
.SS DHCP6_PARSER_COMMIT_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
parser failed to commit changes: %1
.EE
.UNINDENT
.UNINDENT
.sp
هنگام دریافت پیامی حاوی جزئیات تغییر در پیکربندی سرور IPv6 DHCP، مجموعه‌ای از تجزیه‌کننده‌ها با موفقیت ایجاد شدند، اما یکی از آن‌ها در اعمال تغییرات خود شکست خورد. دلیل این شکست در پیام آورده شده است.
.SS DHCP6_PARSER_EXCEPTION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to create or run parser for configuration element %1
.EE
.UNINDENT
.UNINDENT
.sp
هنگام دریافت پیامی حاوی جزئیات تغییر در پیکربندی، سرور IPv6 DHCP نتوانست تجزیه‌کننده‌ای برای رمزگشایی محتوای عنصر پیکربندیِ نام‌برده ایجاد کند، یا اینکه ساخت آن موفقیت‌آمیز بود اما عملیات تجزیه و اعمال تغییرات با شکست مواجه شد. این پیام در پاسخ به رخ دادن یک استثنای غیر Kea صادر شده است. پیام‌های دیگر ممکن است اطلاعات تکمیلی ارائه دهند.
محتمل‌ترین علت این اتفاق این است که فایل مشخصات سرور (که جزئیات محتویات مجاز پیکربندی را شرح می‌دهد) برای این نسخه از Kea صحیح نیست. این امر ممکن است ناشی از قطع شدن فرایند نصب یک به‌روزرسانی برای Kea باشد..SS DHCP6_PARSER_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to create or run parser for configuration element %1: %2
.EE
.UNINDENT
.UNINDENT
.sp
هنگام دریافت پیامی حاوی جزئیات تغییر در پیکربندی، کارساز DHCP برای IPv6 نتوانست یک تجزیه‌کننده برای رمزگشایی محتویات عنصر پیکربندی نام‌برده ایجاد کند، یا اینکه ساخت آن موفقیت‌آمیز بوده اما عملیات تجزیه و اعمال تغییرات با شکست مواجه شده است. علت شکست در پیام مشخص شده است.
.SS DHCP6_PD_LEASE_ADVERT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: lease for prefix %2/%3 and iaid=%4 will be advertised
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اطلاعاتی نشان می‌دهد که کارساز در پیام ADVERTISE یک پیشوند را برای کلاینت اعلان خواهد کرد. کلاینت در تبادل پیام بعدی با ارسال پیام REQUEST، تخصیص این پیشوند را درخواست خواهد کرد. آرگومان نخست شامل اطلاعات شناسایی کلاینت و تراکنش است. آرگومان‌های باقی‌مانده شامل پیشوند تخصیص‌یافته، طول پیشوند و IAID هستند.
.SS DHCP6_PD_LEASE_ADVERT_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: failed to advertise a prefix lease for iaid=%2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام نشان می‌دهد که کارساز در پاسخ به پیام SOLICIT دریافتی، نتوانسته است اجاره یک پیشوند را برای کلاینت مشخص اعلان کند. ممکن است دلایل متعددی برای این شکست وجود داشته باشد. هر شکست در یک ورودی گزارش جداگانه ثبت می‌شود. آرگومان نخست حاوی اطلاعات شناسایی کلاینت و تراکنش است. آرگومان دوم حاوی IAID است.
.SS DHCP6_PD_LEASE_ALLOC
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: lease for prefix %2/%3 and iaid=%4 has been allocated for %5 seconds
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اطلاعاتی نشان می‌دهد که کارساز در پاسخ به پیام REQUEST کلاینت، اجاره یک پیشوند را با موفقیت اعطا کرده است. این رفتاری عادی است و عملیات موفقیت‌آمیز را نشان می‌دهد. آرگومان نخست شامل اطلاعات شناسایی کلاینت و تراکنش است. آرگومان‌های باقی‌مانده شامل پیشوند تخصیص‌یافته، طول پیشوند، IAID و طول عمر اعتبار هستند.
.SS DHCP6_PD_LEASE_ALLOC_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: failed to grant a prefix lease for iaid=%2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام نشان می‌دهد که کارساز در پاسخ به پیام REQUEST دریافتی، نتوانسته است اجاره یک پیشوند را به کلاینت اعطا کند. دلایل متعددی برای این شکست می‌تواند وجود داشته باشد. هر شکست در یک ورودی گزارش جداگانه ثبت می‌شود. آرگومان نخست حاوی اطلاعات شناسایی کلاینت و تراکنش است. آرگومان دوم شامل IAID است.
.SS DHCP6_PD_LEASE_RENEW
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: lease for prefix %2/%3 and iaid=%4 has been allocated
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی نشان می‌دهد که کارساز در پاسخ به پیام REQUEST یک کلاینت، اجاره یک پیشوند را با موفقیت تمدید کرده است. این رفتاری عادی است و عملیات موفقیت‌آمیز را نشان می‌دهد. آرگومان نخست شامل اطلاعات شناسایی کلاینت و تراکنش است. آرگومان‌های باقی‌مانده شامل پیشوند تخصیص‌یافته، طول پیشوند و IAID هستند.
.SS DHCP6_PD_LEASE_REUSE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: lease for prefix %2/%3 and iaid=%4 has been reused for %5 seconds
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی نشان می‌دهد که کارساز در پاسخ به پیام کلاینت، اجاره یک پیشوند را با موفقیت مجدداً استفاده کرده است. این رفتاری عادی است و عملیات موفقیت‌آمیز را نشان می‌دهد. آرگومان نخست شامل اطلاعات شناسایی کلاینت و تراکنش است. آرگومان‌های باقی‌مانده شامل پیشوند تخصیص‌یافته، طول پیشوند، IAID و طول عمر اعتبار هستند.
.SS DHCP6_PROCESS_IA_NA_EXTEND
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: extending lease lifetime for IA_NA option with iaid=%2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام هنگامی ثبت می‌شود که کارساز تمدید طول عمر اجاره نشانی مرتبط با IAID مشخص را آغاز می‌کند. آرگومان نخست شامل اطلاعات شناسایی کلاینت و تراکنش است. آرگومان دوم شامل IAID است..SS DHCP6_PROCESS_IA_NA_RELEASE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: releasing lease for IA_NA option with iaid=%2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام زمانی ثبت می‌شود که کارساز در نتیجه دریافت پیام RELEASE، در تلاش برای آزادسازی اجاره کلاینت است. آرگومان نخست شامل اطلاعات شناسایی کلاینت و تراکنش است. آرگومان دوم حاوی IAID می‌باشد.
.SS DHCP6_PROCESS_IA_NA_REQUEST
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: server is processing IA_NA option with iaid=%2 and hint=%3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این یک پیام اشکال‌زدایی است که نشان‌دهنده پردازش یک گزینهٔ IA_NA دریافت‌شده است. آرگومان نخست شامل اطلاعات شناسایی کلاینت و تراکنش است. آرگومان دوم حاوی IAID مربوط به گزینهٔ IA_NA است. آرگومان سوم ممکن است حاوی راهنمایی (hint) برای کارساز درباره نشانی مد نظر کلاینت جهت تخصیص باشد. اگر راهنمایی وجود نداشته باشد، این آرگومان متنی را ارائه می‌دهد که نشان می‌دهد راهنمایی ارسال نشده است.
.SS DHCP6_PROCESS_IA_NA_SOLICIT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: server is processing IA_NA option with iaid=%2 and hint=%3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این یک پیام اشکال‌زدایی است که نشان‌دهنده پردازش یک گزینهٔ IA_NA دریافت‌شده است. آرگومان نخست شامل اطلاعات شناسایی کلاینت و تراکنش است. آرگومان دوم حاوی IAID مربوط به گزینهٔ IA_NA است. آرگومان سوم ممکن است حاوی راهنمایی (hint) برای کارساز درباره نشانی مد نظر کلاینت جهت تخصیص باشد. اگر راهنمایی وجود نداشته باشد، این آرگومان متنی را ارائه می‌دهد که نشان می‌دهد راهنمایی ارسال نشده است.
.SS DHCP6_PROCESS_IA_PD_EXTEND
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: extending lease lifetime for IA_PD option with iaid=%2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام زمانی ثبت می‌شود که کارساز شروع به تمدید طول عمر اجاره پیشوند (prefix lease) مرتبط با IAID مشخص می‌کند. آرگومان نخست شامل اطلاعات شناسایی کلاینت و تراکنش است. آرگومان دوم حاوی IAID است.
.SS DHCP6_PROCESS_IA_PD_REQUEST
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: server is processing IA_PD option with iaid=%2 and hint=%3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این یک پیام اشکال‌زدایی است که نشان‌دهنده پردازش یک گزینهٔ IA_PD دریافت‌شده است. آرگومان نخست شامل اطلاعات شناسایی کلاینت و تراکنش است. آرگومان دوم حاوی IAID مربوط به گزینهٔ IA_PD است. آرگومان سوم ممکن است شامل راهنمایی (hint) برای کارساز درباره پیشوندی باشد که کلاینت مایل به تخصیص آن است. اگر راهنمایی وجود نداشته باشد، این آرگومان متنی را ارائه می‌دهد که نشان می‌دهد راهنمایی ارسال نشده است.
.SS DHCP6_PROCESS_IA_PD_SOLICIT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: server is processing IA_PD option with iaid=%2 and hint=%3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این یک پیام اشکال‌زدایی است که نشان‌دهنده پردازش یک گزینهٔ IA_PD دریافت‌شده است. آرگومان نخست شامل اطلاعات شناسایی کلاینت و تراکنش است. آرگومان دوم حاوی IAID مربوط به گزینهٔ IA_PD است. آرگومان سوم ممکن است شامل راهنمایی (hint) برای کارساز درباره پیشوندی باشد که کلاینت مایل به تخصیص آن است. اگر راهنمایی وجود نداشته باشد، این آرگومان متنی را ارائه می‌دهد که نشان می‌دهد راهنمایی ارسال نشده است.
.SS DHCP6_QUERY_DATA
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1, packet details: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۵ ثبت می‌شود.
یک پیام اشکال‌زدایی که جزئیات بسته دریافت شده را چاپ می‌کند. آرگومان نخست شامل اطلاعات شناسایی کلاینت و تراکنش است.
.SS DHCP6_QUERY_LABEL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
received query: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که یک پرس‌وجو (query) دریافت شده است. این پیام اطلاعات شناسایی کلاینت و تراکنش را نمایش می‌دهد..SS DHCP6_RAPID_COMMIT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Rapid Commit option received, following 2\-way exchange
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارگزار (سرور) گزینهٔ Rapid Commit را در پیام کلاینت پیدا کند و تبادلات دوطرفه (2\-way) توسط سرور برای زیرشبکه‌ای که کلاینت به آن متصل است پشتیبانی شود. آرگومان، اطلاعات شناسایی کلاینت و تراکنش را مشخص می‌کند.
.SS DHCP6_RECLAIM_EXPIRED_LEASES_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to reclaim expired leases: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که عملیات بازپس‌گیری اجاره‌های (leases) منقضی‌شده با شکست مواجه شده است و علت خطا را مشخص می‌کند.
.SS DHCP6_RECLAIM_EXPIRED_LEASES_SKIPPED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
dhcp6 service is currently disabled. Try again in %1 seconds.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که بازپس‌گیری اجاره‌ها برای آغاز زمان‌بندی شده بود اما به دلیل غیرفعال بودن سرویس DHCPv6 نادیده گرفته شد. زمان‌بندی بازپس‌گیری همچنان مطابق با مقدار پیکربندی‌شدهٔ reclaim\-timer\-wait\-time ادامه خواهد داشت.
.SS DHCP6_REGISTERED_LEASE_ADD_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
error in registered lease add for %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که افزودن اجارهٔ ثبت‌شده ناموفق بوده است و آدرسی را که در حال ثبت بود نشان می‌دهد.
.SS DHCP6_REGISTERED_LEASE_UPDATE_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
error in registered lease update for %1: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که به‌روزرسانی اجارهٔ ثبت‌شده ناموفق بوده است و آدرس ثبت‌شده و علت خطا را نشان می‌دهد.
.SS DHCP6_RELEASE_NA
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: binding for address %2 and iaid=%3 was released properly
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که یک آدرس به‌درستی آزاد (released) شده است. این یک فرایند عادی در طول خاموش شدن کلاینت است. آرگومان نخست شامل اطلاعات شناسایی کلاینت و تراکنش است. آرگومان دوم و سوم به ترتیب شامل آدرس IPv6 آزادشده و IAID هستند.
.SS DHCP6_RELEASE_NA_DELETED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: binding for address %2 and iaid=%3 was deleted on release
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که یک آدرس در هنگام آزادسازی حذف شده است. این یک فرایند عادی در طول خاموش شدن کلاینت است. آرگومان نخست شامل اطلاعات شناسایی کلاینت و تراکنش است. آرگومان دوم و سوم به ترتیب شامل آدرس IPv6 آزادشده و IAID هستند.
.SS DHCP6_RELEASE_NA_EXPIRED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: binding for address %2 and iaid=%3 expired on release
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که یک آدرس در هنگام آزادسازی منقضی شده است. این یک فرایند عادی در طول خاموش شدن کلاینت است. آرگومان نخست شامل اطلاعات شناسایی کلاینت و تراکنش است. آرگومان دوم و سوم به ترتیب شامل آدرس IPv6 آزادشده و IAID هستند.
.SS DHCP6_RELEASE_NA_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: failed to remove address lease for address %2 and iaid=%3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که نرم‌افزار نتوانسته است اجارهٔ یک آدرس را از پایگاه‌دادهٔ اجاره‌ها حذف کند. این امر احتمالاً به دلیل بروز خطا در طول عملیات پایگاه‌داده رخ داده است: حل این مشکل به احتمال زیاد نیازمند مداخلهٔ مدیر سیستم خواهد بود (برای مثال، بررسی اینکه آیا فرایند DHCP دسترسی‌های لازم برای به‌روزرسانی پایگاه‌داده را دارد یا خیر). همچنین این خطا ممکن است زمانی رخ دهد که یک اجاره در طول پردازش پیام RELEASE به‌صورت دستی از پایگاه‌داده حذف شده باشد. آرگومان نخست شامل اطلاعات شناسایی کلاینت و تراکنش است. آرگومان دوم و سوم به ترتیب شامل آدرس آزادشده و IAID هستند..SS DHCP6_RELEASE_NA_FAIL_WRONG_DUID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: client tried to release address %2, but it belongs to another client using duid=%3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار نشان می‌دهد که یک کلاینت تلاش کرده است نشانی‌ای را که متعلق به کلاینت دیگری است آزاد کند. این اتفاق در شرایط عادی نباید رخ دهد و ممکن است نشان‌دهندهٔ پیکربندی نادرست کلاینت باشد. با این حال، از آنجا که کلاینت رهاکنندهٔ نشانی به هر حال استفاده از آن را متوقف خواهد کرد، احتمال زیادی وجود دارد که این وضعیت به خودی خود برطرف شود.
.SS DHCP6_RELEASE_NA_FAIL_WRONG_IAID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: client tried to release address %2, but it used wrong IAID (expected %3, but got %4)
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار نشان می‌دهد که کلاینت برای آزادسازی نشانی‌ای تلاش کرده است که متعلق به خود اوست، اما انتظار می‌رفت که این نشانی در یک ظرف IA (انجمن هویت) متفاوتی قرار داشته باشد. این امر احتمالاً به این معنی است که پشتیبانی کلاینت از چندین نشانی دچار ایراد است.
.SS DHCP6_RELEASE_PD
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: prefix %2/%3 for iaid=%4 was released properly
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که یک پیشوند (prefix) به‌درستی آزاد شده است. این عملیات در طول خاموش شدن کلاینت روالی عادی است. آرگومان اول حاوی اطلاعات شناسایی کلاینت و تراکنش است. آرگومان دوم و سوم پیشوند و طول آن را مشخص می‌کنند. آرگومان چهارم شامل IAID است.
.SS DHCP6_RELEASE_PD_DELETED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: prefix %2/%3 for iaid=%4 was deleted on release
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که یک پیشوند در زمان آزادسازی حذف شده است. این عملیات در طول خاموش شدن کلاینت روالی عادی است. آرگومان اول حاوی اطلاعات شناسایی کلاینت و تراکنش است. آرگومان دوم و سوم پیشوند و طول آن را مشخص می‌کنند. آرگومان چهارم شامل IAID است.
.SS DHCP6_RELEASE_PD_EXPIRED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: prefix %2/%3 for iaid=%4 expired on release
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که یک پیشوند در زمان آزادسازی منقضی شده است. این عملیات در طول خاموش شدن کلاینت روالی عادی است. آرگومان اول حاوی اطلاعات شناسایی کلاینت و تراکنش است. آرگومان دوم و سوم پیشوند و طول آن را مشخص می‌کنند. آرگومان چهارم شامل IAID است.
.SS DHCP6_RELEASE_PD_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: failed to release prefix %2/%3 for iaid=%4
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که نرم‌افزار در حذف اجارهٔ یک پیشوند از پایگاه‌دادهٔ اجاره‌ها با شکست مواجه شده است. این امر احتمالاً ناشی از بروز خطا در حین یک عملیات پایگاه‌داده است؛ رفع آن به احتمال زیاد نیازمند دخالت مدیر سیستم خواهد بود (برای نمونه بررسی اینکه آیا فرایند DHCP اختیارات کافی برای به‌روزرسانی پایگاه‌داده دارد یا خیر). همچنین این خطا ممکن است در صورتی رخ دهد که یک اجاره در طول پردازش پیام RELEASE به‌صورت دستی از پایگاه‌داده حذف شده باشد. آرگومان اول شامل اطلاعات شناسایی کلاینت و تراکنش است. آرگومان‌های دوم و سوم پیشوند و طول آن را مشخص می‌کنند. آرگومان چهارم حاوی IAID است.
.SS DHCP6_RELEASE_PD_FAIL_WRONG_DUID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: client tried to release prefix %2/%3, but it belongs to another client (duid=%4)
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار نشان می‌دهد که کلاینت تلاش کرده است پیشوندی را که متعلق به کلاینت دیگری است آزاد کند. این اتفاق در شرایط عادی نباید رخ دهد و ممکن است نشان‌دهندهٔ پیکربندی نادرست کلاینت باشد. با این حال، از آنجا که کلاینت رهاکنندهٔ پیشوند به هر حال استفاده از آن را متوقف خواهد کرد، احتمال زیادی وجود دارد که این وضعیت به خودی خود اصلاح شود. آرگومان اول شامل اطلاعات شناسایی کلاینت و تراکنش است. آرگومان‌های دوم و سوم پیشوند و طول آن را مشخص می‌کنند. آرگومان آخر حاوی DUID کلاینتی است که اجاره را در اختیار دارد.
.SS DHCP6_RELEASE_PD_FAIL_WRONG_IAID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: client tried to release prefix %2/%3, but it used wrong IAID (expected %4, but got %5)
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار نشان می‌دهد که کلاینت برای آزادسازی پیشوندی تلاش کرده است که متعلق به خود اوست، اما انتظار می‌رفت نشانی در یک ظرف IA (انجمن هویت) متفاوتی قرار داشته باشد. این امر احتمالاً به این معنی است که پشتیبانی کلاینت از چندین پیشوند دارای ایراد است. آرگومان اول شامل اطلاعات شناسایی کلاینت و تراکنش است. آرگومان‌های دوم و سوم پیشوند را مشخص می‌کنند. آرگومان‌های چهارم و پنجم به ترتیب حاوی IAID مورد انتظار و IAID دریافت‌شده هستند..SS DHCP6_REQUIRED_OPTIONS_CHECK_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: %2 message received from %3 failed the following check: %4
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 40 ثبت می‌شود.
این پیام نشان می‌دهد که بستهٔ DHCPv6 دریافت‌شده نامعتبر است. این امر ممکن است به دلایل
متعددی رخ داده باشد؛ برای نمونه، گزینهٔ اجباری client\-id وجود ندارد،
گزینهٔ server\-id که در آن نوع خاص از پیام ممنوع است درج شده،
بیش از یک نمونه از client\-id یا server\-id وجود دارد
و غیره. علت دقیق رد شدن بسته در پیام گنجانده شده است.
.SS DHCP6_RESERVATIONS_LOOKUP_FIRST_ENABLED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Multi\-threading is enabled and host reservations lookup is always performed first.
.EE
.UNINDENT
.UNINDENT
.sp
این پیامی است که اطلاع می‌دهد با فعال بودن چندنخی (multi\-threading)، جستجوی رزروهای
میزبان همواره پیش از جستجوی اجاره (lease) انجام می‌شود و مقدار پیکربندی‌شده را بازنویسی می‌کند.
.SS DHCP6_RESPONSE_DATA
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: responding with packet %2 (type %3), packet details: %4
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 55 ثبت می‌شود.
پیام اشکال‌زدایی شامل داده‌های تفصیلی بسته‌ای که به کلاینت فرستاده می‌شود.
آرگومان اول حاوی اطلاعات شناسایی کلاینت و تراکنش است.
آرگومان دوم و سوم به‌ترتیب حاوی نام و نوع بسته هستند.
آرگومان چهارم شامل اطلاعات تفصیلی بسته است.
.SS DHCP6_ROOT_USER_SECURITY_WARNING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
kea\-dhcp6 running as root user!
.EE
.UNINDENT
.UNINDENT
.sp
این هشدار زمانی صادر می‌شود که kea\-dhcp6 با کاربر root در حال اجرا باشد.
اگرچه سرور عملکرد کاملی خواهد داشت، این حالت کاربری ممکن است محیط شما را
در معرض آسیب‌پذیری‌های امنیتی قرار دهد و تنها باید پس از بررسی دقیق
استفاده شود.
.SS DHCP6_SECURITY_CHECKS_DISABLED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Invoked with command line option \-X, Security checks are disabled!!
.EE
.UNINDENT
.UNINDENT
.sp
این هشدار زمانی صادر می‌شود که بررسی‌های امنیتی داخلی که معمولاً توسط
kea\-dhcp6 انجام می‌شوند، از طریق گزینهٔ خط فرمان \(aq\-X\(aq غیرفعال شده باشند.
این بدان معناست که سرور هیچ‌گونه محدودیتی را بر روی مسیرهای منابع یا
مجوزها اعمال نمی‌کند. این حالت کاربری ممکن است محیط شما را در معرض
آسیب‌پذیری‌های امنیتی قرار دهد و تنها باید پس از بررسی دقیق استفاده شود.
.SS DHCP6_SERVER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
server failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
سرور DHCP در IPv6 با یک خطای مهلک مواجه شده و در حال خاتمه است.
علت این شکست در متن پیام ذکر شده است.
.SS DHCP6_SHUTDOWN
.INDENT 0.0
.INDENT 3.5
.sp
.EX
server shutdown
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 40 ثبت می‌شود.
سرور DHCP در IPv6 به‌طور عادی خاتمه یافته است.
.SS DHCP6_SHUTDOWN_REQUEST
.INDENT 0.0
.INDENT 3.5
.sp
.EX
shutdown of server requested
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 40 ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که خاموش‌سازی سرور IPv6 از طریق
فراخوانی متد \(aqshutdown\(aq از شیء اصلی Dhcpv6Srv درخواست شده است.
.SS DHCP6_SRV_CONSTRUCT_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
error creating Dhcpv6Srv object, reason: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که در هنگام راه‌اندازی، ساخت یک مؤلفهٔ اصلی در
سرور DHCP در IPv6 (شیء سرور Dhcpv6) با شکست مواجه شده است.
در نتیجه، سرور خارج خواهد شد. علت این شکست در متن پیام ذکر شده است..SS DHCP6_SRV_D2STOP_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
error stopping IO with DHCP_DDNS during shutdown: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که هنگام خاموش شدن، در زمان متوقف کردن IO میان کارگزار DHCPv6 و کارگزار DHCP_DDNS خطایی رخ داده است. این امر احتمالاً به دلیل یک خطای برنامه‌نویسی است و بعید است پس از راه‌اندازی مجدد، بر هیچ‌یک از کارگزارها تأثیر بگذارد. علت شکست در متن پیام ذکر شده است.
.SS DHCP6_SRV_UNLOAD_LIBRARIES_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
error unloading hooks libraries during shutdown: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که هنگام خاموش شدن، تخلیه کتابخانه‌های hooks در بستن آن‌ها با شکست مواجه شده است. اگر فهرست کتابخانه‌ها خالی باشد، این یک خطای برنامه‌نویسی در کد کارگزار است. اگر خالی نباشد، می‌تواند یک خطای برنامه‌نویسی در یکی از کتابخانه‌های hooks باشد که ممکن است به فروپاشی (crash) در حین نهایی‌سازی بیانجامد.
.SS DHCP6_STARTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Kea DHCPv6 server version %1 started
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که کارگزار DHCPv6 تمام اطلاعات پیکربندی را پردازش کرده و آمادهٔ پردازش بسته‌های DHCPv6 است. نسخهٔ برنامه نیز چاپ می‌شود.
.SS DHCP6_STARTING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Kea DHCPv6 server version %1 (%2) starting
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که کارگزار DHCPv6 تمام گزینه‌های خط فرمان را پردازش کرده و در حال راه‌اندازی است. نسخهٔ برنامه نیز چاپ می‌شود.
.SS DHCP6_START_INFO
.INDENT 0.0
.INDENT 3.5
.sp
.EX
pid: %1, server port: %2, client port: %3, verbose: %4
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) 0 ثبت می‌شود.
این یک پیام اشکال‌زدایی است که هنگام راه‌اندازی کارگزار DHCPv6 صادر می‌شود. این پیام اطلاعاتی را دربارهٔ پارامترهایی که کارگزار با آن‌ها در حال اجرا است، فهرست می‌کند.
.SS DHCP6_SUBNET_DATA
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: the selected subnet details: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) 55 ثبت می‌شود.
این پیام اشکال‌زدایی شامل جزئیات زیرشبکهٔ (subnet) انتخاب‌شده برای کلاینت است. آرگومان نخست شامل اطلاعات شناسایی کلاینت و تراکنش است. آرگومان دوم شامل جزئیات زیرشبکه است.
.SS DHCP6_SUBNET_DYNAMICALLY_CHANGED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: changed selected subnet %2 to subnet %3 from shared network %4 for client assignments
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) 45 ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که کارگزار برای تخصیص‌های کلاینت از زیرشبکهٔ دیگری به غیر از آنچه در ابتدا انتخاب شده بود، استفاده می‌کند. این زیرشبکهٔ تازه انتخاب‌شده به همان شبکهٔ مشترک (shared network) زیرشبکهٔ اولیه تعلق دارد. برخی از دلایل انتخاب زیرشبکهٔ جدید عبارت‌اند از: اتمام استخر آدرس (address pool) در زیرشبکهٔ اولیه یا این واقعیت که زیرشبکهٔ جدید شامل رزروهای ایستا (static reservations) برای این کلاینت است.
.SS DHCP6_SUBNET_SELECTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: the subnet with ID %2 was selected for client assignments
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) 45 ثبت می‌شود.
این یک پیام اشکال‌زدایی است که انتخاب یک زیرشبکه را برای استفاده در تخصیص آدرس و گزینه‌ها مشخص می‌کند. انتخاب زیرشبکه یکی از نخستین مراحل در پردازش پیام‌های دریافتی از کلاینت است. آرگومان نخست شامل اطلاعات شناسایی کلاینت و تراکنش است. آرگومان دوم حاوی شناسهٔ (ID) زیرشبکهٔ انتخاب‌شده است.
.SS DHCP6_SUBNET_SELECTION_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: failed to select subnet for the client
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) 50 ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که کارگزار در انتخاب زیرشبکه برای کلاینتی که پیامی به کارگزار فرستاده، با شکست مواجه شده است. علت احتمالاً به دلیل پیکربندی نادرست کارگزار است. پردازش بسته ادامه خواهد یافت، اما پاسخ تنها حاوی پیکربندی عمومی خواهد بود و هیچ آدرس یا پیشوندی را شامل نمی‌شود. آرگومان شامل اطلاعات شناسایی کلاینت و تراکنش است..SS DHCP6_UNKNOWN_MSG_RECEIVED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: received unknown message (type %2) on interface %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی چاپ می‌شود که سرور پیامی از نوع ناشناخته دریافت کند.
این موضوع می‌تواند بیانگر نبود یک قابلیت یا یک کلاینت یا رلهٔ نامعتبر یا معیوب باشد.
فهرست انواع پیام‌های تعریف‌شده به‌صورت رسمی در اینجا در دسترس است:
\%<http://\:www\:.iana\:.org/\:assignments/\:dhcpv6-parameters>\&.
.SS DHCP6_USING_SERVERID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
server is using server\-id %1 and stores in the file %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی زمانی ثبت می‌شود که سرور server\-id خود را از یک فایل بخواند یا
آن را تولید کند. این پیام اعلانی به مدیر سیستم است که چه server\-id استفاده
خواهد شد و در کجا ذخیره و نگهداری می‌شود. معمولاً نیازی به تغییر server id نیست.
با این وجود، انجام این کار در فایل پیکربندی Kea امکان‌پذیر است. درک پیامدهای
چنین تغییری بسیار مهم است. کلاینت‌ها server\-id پیشین را به خاطر خواهند سپرد و
از آن برای تمدید اجاره‌هایشان (leases) استفاده خواهند کرد. در نتیجه، آن‌ها برای
دریافت مجدد اجاره‌های خود و انتساب آن‌ها به یک server id جدید، ناچار خواهند بود
مرحلهٔ پیوند دوباره (rebinding) را طی کنند.
.SS DHCPSRV
.SS DHCPSRV_CFGMGR_ADD_IFACE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
listening on interface %1
.EE
.UNINDENT
.UNINDENT
.sp
پیامی اطلاعاتی که هنگام افزوده شدن یک رابط جدید به مجموعه رابط‌هایی که سرور
روی آن‌ها به پیام‌های DHCP گوش می‌دهد، صادر می‌شود.
.SS DHCPSRV_CFGMGR_ADD_SUBNET4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
adding subnet %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که زمانی گزارش می‌شود که مدیر پیکربندی DHCP در حال افزودن
ساب‌نت IPv4 مشخص‌شده به پایگاه دادهٔ خود است.
.SS DHCPSRV_CFGMGR_ADD_SUBNET6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
adding subnet %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که زمانی گزارش می‌شود که مدیر پیکربندی DHCP در حال افزودن
ساب‌نت IPv6 مشخص‌شده به پایگاه دادهٔ خود است.
.SS DHCPSRV_CFGMGR_ALL_IFACES_ACTIVE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
enabling listening on all interfaces
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور پیکربندی شده باشد تا روی همهٔ
رابط‌ها گوش فرا دهد.
.SS DHCPSRV_CFGMGR_CFG_DHCP_DDNS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Setting DHCP\-DDNS configuration to: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که تنظیمات DHCP\-DDNS سرور تغییر می‌کند.
.SS DHCPSRV_CFGMGR_CONFIG4_MERGED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Configuration backend data has been merged.
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام اطلاعاتی است و زمانی صادر می‌شود که سرور DHCPv4 داده‌های پیکربندی
دریافت‌شده از بک‌اندهای پیکربندی خود را با موفقیت در پیکربندی فعلی ادغام
کرده باشد.
.SS DHCPSRV_CFGMGR_CONFIG6_MERGED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Configuration backend data has been merged.
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام اطلاعاتی است و زمانی صادر می‌شود که سرور DHCPv6 داده‌های پیکربندی
دریافت‌شده از بک‌اندهای پیکربندی خود را با موفقیت در پیکربندی فعلی ادغام
کرده باشد..SS DHCPSRV_CFGMGR_CONFIGURE_SERVERID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
server configuration includes specification of a server identifier
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که پیکربندی سرور شامل مشخص‌سازی یک شناسه سرور (server identifier) باشد. اگر این پیکربندی جدید یک server identifier موجود را بازنویسی کند، بر پیوندهای (bindings) فعلی کلاینت‌ها تأثیر خواهد گذاشت. کلاینت‌ها هنگام تمدید پیوندهای خود از server identifier قدیمی استفاده خواهند کرد. سرور به این تمدیدها پاسخ نخواهد داد و کلاینت‌ها در نهایت به وضعیت rebinding منتقل خواهند شد. سرور باید پیوندهای موجود را مجدداً تخصیص دهد و کلاینت‌ها پس از آن از server identifier جدید استفاده خواهند کرد. توصیه می‌شود server identifier را تغییر ندهید، مگر اینکه دلیل موجهی برای آن وجود داشته باشد، تا از افزایش تعداد تمدیدها و نیاز به rebinding (افزایش ترافیک چندپخشی یا multicast، که ممکن است توسط چندین سرور دریافت شود) جلوگیری گردد.
.SS DHCPSRV_CFGMGR_DEL_SUBNET4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
IPv4 subnet %1 removed
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک زیرشبکه (subnet) با موفقیت از پیکربندی سرور حذف شود. آرگومان، زیرشبکه حذف‌شده را مشخص می‌کند.
.SS DHCPSRV_CFGMGR_DEL_SUBNET6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
IPv6 subnet %1 removed
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک زیرشبکه (subnet) با موفقیت از پیکربندی سرور حذف شود. آرگومان، زیرشبکه حذف‌شده را مشخص می‌کند.
.SS DHCPSRV_CFGMGR_FLQ_POPULATE_FREE_ADDRESS_LEASES
.INDENT 0.0
.INDENT 3.5
.sp
.EX
populating free address leases for the FLQ allocator in subnet %1; it can take a while!
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی زمانی صادر می‌شود که سرور شروع به ساخت یک صف از اجاره‌های آدرس (address leases) آزاد برای زیرشبکه مشخص‌شده می‌کند. این کار بسته به اندازه استخرهای آدرس (address pools)، می‌تواند زمان قابل توجهی ببرد.
.SS DHCPSRV_CFGMGR_FLQ_POPULATE_FREE_ADDRESS_LEASES_DONE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
populated %1 free address leases for the FLQ allocator in subnet %2 in %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی زمانی صادر می‌شود که سرور ساخت صف اجاره‌های آدرس آزاد را برای یک زیرشبکه مشخص به پایان می‌رساند. آرگومان نخست تعداد اجاره‌های آزاد، آرگومان دوم زیرشبکه، و آرگومان سوم مدت‌زمان را ثبت می‌کند.
.SS DHCPSRV_CFGMGR_FLQ_POPULATE_FREE_PREFIX_LEASES
.INDENT 0.0
.INDENT 3.5
.sp
.EX
populating free prefix leases for the FLQ allocator in subnet %1; it can take a while!
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی زمانی صادر می‌شود که سرور شروع به ساخت یک صف از اجاره‌های آزاد برای زیرشبکه مشخص‌شده می‌کند. این کار بسته به اندازه استخرهای پیشوند واگذارشده (delegated prefix pools)، می‌تواند زمان قابل توجهی ببرد.
.SS DHCPSRV_CFGMGR_FLQ_POPULATE_FREE_PREFIX_LEASES_DONE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
populated %1 free prefix leases for the FLQ allocator in subnet %2 completed in %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی زمانی صادر می‌شود که سرور ساخت صف اجاره‌های پیشوند آزاد را برای یک زیرشبکه مشخص به پایان می‌رساند. آرگومان نخست تعداد اجاره‌های آزاد، آرگومان دوم زیرشبکه، و آرگومان سوم مدت‌زمان را ثبت می‌کند.
.SS DHCPSRV_CFGMGR_IPV4_RESERVATIONS_NON_UNIQUE_IGNORED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ignoring \(dqip\-reservations\-unique\(dq setting because at least one of the host database backends does not support non\-unique IP reservations in a subnet
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که سرور در استفاده از تنظیم جدید پارامتر سراسری ip\-reservations\-unique که از طریق بک‌اند پیکربندی (configuration backend) پیکربندی شده است، ناموفق باشد. ظاهراً برخی از بک‌اندهای پایگاه‌داده میزبان (host database backends) مورد استفاده از تعیین چندین رزرو برای یک آدرس IP یکسان در یک زیرشبکه پشتیبانی نمی‌کنند. مدیر سیستم برای رفع این مشکل پیکربندی باید یا استفاده از بک‌اندی را که از این تنظیم پشتیبانی نمی‌کند متوقف سازد یا مقدار ip\-reservations\-unique را برابر با true قرار دهد.
.SS DHCPSRV_CFGMGR_IPV6_RESERVATIONS_NON_UNIQUE_IGNORED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ignoring \(dqip\-reservations\-unique\(dq setting because at least one of the host database backends does not support non unique IP reservations in a subnet
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که سرور در استفاده از تنظیم جدید پارامتر سراسری ip\-reservations\-unique که از طریق بک‌اند پیکربندی (configuration backend) پیکربندی شده است، ناموفق باشد. ظاهراً برخی از بک‌اندهای پایگاه‌داده میزبانِ مورد استفاده از تعیین چندین رزرو برای یک آدرس IP یکسان یا پیشوند واگذارشده (delegated prefix) در یک زیرشبکه پشتیبانی نمی‌کنند. مدیر سیستم برای رفع این مشکل پیکربندی باید یا استفاده از بک‌اندی را که از این تنظیم پشتیبانی نمی‌کند متوقف سازد یا مقدار ip\-reservations\-unique را برابر با true قرار دهد..SS DHCPSRV_CFGMGR_IP_RESERVATIONS_UNIQUE_DUPLICATES_DETECTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
the \(dqip\-reservations\-unique\(dq flag is set to true and multiple reservations for the IP address %1 in subnet %2 are not allowed causing error: %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که کارگزار DHCP طوری پیکربندی شده باشد که رزروهای چندگانه را برای یک نشانی IP یکسان مجاز نداند. با این حال، بک‌اند پایگاه‌داده میزبان شامل چندین رزرو برای نشانی IP ثبت‌شده به عنوان آرگومان نخست، در زیرشبکه ثبت‌شده به عنوان آرگومان دوم است که باعث ایجاد مشکلاتی در تخصیص اجاره ثبت‌شده به عنوان آرگومان سوم می‌شود.
.SS DHCPSRV_CFGMGR_IP_RESERVATIONS_UNIQUE_DUPLICATES_POSSIBLE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
setting \(dqip\-reservations\-unique\(dq from false to true poses a risk that some host backends may still contain multiple reservations for the same IP address
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که کارگزار DHCP طوری پیکربندی شده باشد که رزروهای چندگانه را برای یک نشانی IP یکسان مجاز نداند. با این حال، بک‌اندهای پایگاه‌داده میزبان ممکن است همچنان شامل چندین رزرو برای نشانی‌های IP یکسان باشند که سبب ایجاد مشکلاتی در تخصیص اجاره برای برخی نشانی‌ها می‌شود. لطفاً اطمینان حاصل کنید که تمام این موارد تکراری حذف شوند.
.SS DHCPSRV_CFGMGR_NEW_SUBNET4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
a new subnet has been added to configuration: %1
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام اطلاع‌رسانی است که گزارش می‌دهد پیکربندی برای در بر گرفتن زیرشبکه IPv4 مشخص‌شده گسترش یافته است.
.SS DHCPSRV_CFGMGR_NEW_SUBNET6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
a new subnet has been added to configuration: %1
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام اطلاع‌رسانی است که گزارش می‌دهد پیکربندی برای در بر گرفتن زیرشبکه مشخص‌شده گسترش یافته است.
.SS DHCPSRV_CFGMGR_OPTION_DEFINITION_MISMATCH
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to create option: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که گزینه‌ای مشخص شده باشد که تعریف گزینه مناسبی برای آن وجود ندارد. یا اصلاً تعریفی وجود ندارد یا محتوای گزینه با تعریف گزینه همخوانی ندارد. این آرگومان دلیل تفصیلی شکست را ارائه می‌دهد. کارگزار به کار خود ادامه خواهد داد اما تا زمان اصلاح وضعیت، این گزینه را از پردازش بسته‌ها کنار می‌گذارد. این مورد یک خطای پیکربندی محسوب می‌شود.
.SS DHCPSRV_CFGMGR_OPTION_DUPLICATE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
multiple options with the code: %1 added to the subnet: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار هنگام تلاش برای پیکربندی چند گزینه با یک کد گزینه یکسان برای یک زیرشبکه خاص صادر می‌شود. افزودن گزینه‌های چندگانه برای DHCPv6 غیرمعمول است، اما ممنوع نیست.
.SS DHCPSRV_CFGMGR_RENEW_GTR_REBIND
.INDENT 0.0
.INDENT 3.5
.sp
.EX
in %1, the value of renew\-timer %2 is greater than the value of rebind\-timer %3, ignoring renew\-timer
.EE
.UNINDENT
.UNINDENT
.sp
یک پیام هشدار که نشان می‌دهد مقدار renew\-timer پیکربندی‌شده از مقدار rebind\-timer پیکربندی‌شده بزرگ‌تر است. کارگزار مقدار renew timer را نادیده می‌گیرد و فقط مقدار rebind timer را ارسال خواهد کرد. این مورد یک خطای پیکربندی غیرمهلک در نظر گرفته می‌شود.
.SS DHCPSRV_CFGMGR_SOCKET_RAW_UNSUPPORTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
use of raw sockets is unsupported on this OS, UDP sockets will be used
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی ثبت می‌شود که کاربر مشخص کرده باشد کارگزار DHCPv4 باید از سوکت‌های خام (raw sockets) برای دریافت پیام‌های DHCP و پاسخ به کلاینت‌ها استفاده کند، اما استفاده از سوکت‌های خام در آن محیط خاص پشتیبانی نمی‌شود. سوکت‌های خام زمانی مفید هستند که کارگزار باید به کلاینت‌های مستقیماً متصل‌شده‌ای که هنوز نشانی ندارند پاسخ دهد. اگر سوکت‌های خام توسط Kea در آن پلتفرم خاص پشتیبانی نشود، Kea به استفاده از سوکت‌های IP/UDP بازمی‌گردد. پاسخ‌ها به کلاینت‌های مستقیماً متصل، همه‌پخشی (broadcast) خواهد بود. پاسخ‌ها به کلاینت‌های بازپخش‌شده (relayed) مانند معمول تک‌پخشی (unicast) خواهد بود.
.SS DHCPSRV_CFGMGR_SOCKET_TYPE_DEFAULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqdhcp\-socket\-type\(dq not specified , using default socket type %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی زمانی ثبت می‌شود که مدیر سیستم پارامتر \(dqdhcp\-socket\-type\(dq را در پیکربندی رابط‌ها مشخص نکرده باشد. در چنین حالتی، نوع سوکت پیش‌فرض استفاده خواهد شد..SS DHCPSRV_CFGMGR_SOCKET_TYPE_SELECT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
using socket type %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی زمانی ثبت می‌شود که کارگزار DHCPv4 نوع سوکت (socket type) مورد استفاده برای تمامی سوکت‌هایی که روی رابط‌ها باز خواهند شد را انتخاب کند. به‌طور معمول، نوع سوکت توسط مدیر کارگزار تعیین می‌شود. اگر نوع سوکت مشخص نشده باشد، raw socket انتخاب خواهد شد. چنانچه raw socket انتخاب شده باشد اما Kea از استفاده از raw socketها روی آن سیستم‌عامل به‌خصوص پشتیبانی نکند، به‌جای آن از یک UDP socket استفاده خواهد کرد.
.SS DHCPSRV_CFGMGR_SUBNET4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieved subnet %1 for address hint %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این یک پیام اشکال‌زدایی است که گزارش می‌دهد مدیر پیکربندی DHCP با توجه به نشانی پیشنهادی (address hint) مشخص‌شده، زیرشبکهٔ IPv4 مربوطه را بازگردانده است، چرا که نشانی در محدودهٔ این زیرشبکه قرار دارد.
.SS DHCPSRV_CFGMGR_SUBNET4_ADDR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
selected subnet %1 for packet received by matching address %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این یک پیام اشکال‌زدایی است که گزارش می‌دهد مدیر پیکربندی DHCP زیرشبکهٔ IPv4 مشخص‌شده را برای یک بستهٔ دریافتی بازگردانده است. این زیرشبکهٔ به‌خصوص از آن جهت انتخاب شد که نشانی IPv4 تطبیق‌یافته متعلق به این زیرشبکه بود.
.SS DHCPSRV_CFGMGR_SUBNET4_IFACE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
selected subnet %1 for packet received over interface %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این یک پیام اشکال‌زدایی است که گزارش می‌دهد مدیر پیکربندی DHCP زیرشبکهٔ IPv4 مشخص‌شده را برای بسته‌ای که از رابط داده‌شده دریافت شده، بازگردانده است. این زیرشبکهٔ به‌خصوص به این دلیل انتخاب شده که مشخص شده بود مستقیماً از طریق رابط داده‌شده قابل دسترسی است (پارامتر \(aqinterface\(aq در تعریف subnet4 را ببینید).
.SS DHCPSRV_CFGMGR_SUBNET4_RELAY
.INDENT 0.0
.INDENT 3.5
.sp
.EX
selected subnet %1, because of matching relay addr %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این یک پیام اشکال‌زدایی است که گزارش می‌دهد مدیر پیکربندی DHCP زیرشبکهٔ IPv4 مشخص‌شده را بازگردانده است، زیرا نشانیِ عامل رله (relay agent) شناسایی‌شده با مقدار مشخص‌شده برای این زیرشبکه مطابقت دارد.
.SS DHCPSRV_CFGMGR_SUBNET6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieved subnet %1 for address hint %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این یک پیام اشکال‌زدایی است که گزارش می‌دهد مدیر پیکربندی DHCP با توجه به نشانی پیشنهادی (address hint) مشخص‌شده، زیرشبکهٔ IPv6 مربوطه را بازگردانده است، چرا که نشانی در محدودهٔ این زیرشبکه قرار دارد.
.SS DHCPSRV_CFGMGR_SUBNET6_IFACE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
selected subnet %1 for packet received over interface %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این یک پیام اشکال‌زدایی است که گزارش می‌دهد مدیر پیکربندی DHCP زیرشبکهٔ IPv6 مشخص‌شده را برای بسته‌ای که از رابط داده‌شده دریافت شده، بازگردانده است. این زیرشبکهٔ به‌خصوص به این دلیل انتخاب شد که مشخص شده بود مستقیماً از طریق رابط داده‌شده قابل دسترسی است (پارامتر \(aqinterface\(aq در تعریف subnet6 را ببینید).
.SS DHCPSRV_CFGMGR_SUBNET6_IFACE_ID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
selected subnet %1 (interface\-id match) for incoming packet
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این یک پیام اشکال‌زدایی است که گزارش می‌دهد مدیر پیکربندی DHCP زیرشبکهٔ IPv6 مشخص‌شده را برای یک بستهٔ دریافتی بازگردانده است. این زیرشبکهٔ به‌خصوص به این دلیل انتخاب شد که مقدار گزینهٔ interface\-id با مقدار پیکربندی‌شده در گزینهٔ interface\-id کارگزار برای آن subnet6 انتخاب‌شده مطابقت داشت (پارامتر \(aqinterface\-id\(aq در تعریف subnet6 را ببینید)..SS DHCPSRV_CFGMGR_SUBNET6_RELAY
.INDENT 0.0
.INDENT 3.5
.sp
.EX
selected subnet %1, because of matching relay addr %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این یک پیام اشکال‌زدایی است که گزارش می‌دهد مدیر پیکربندی DHCP، زیرشبکهٔ IPv6 مشخص‌شده را بازگردانده است، زیرا نشانی عامل رله (relay agent) شناسایی‌شده با مقدار مشخص‌شده برای این زیرشبکه مطابقت دارد.
.SS DHCPSRV_CFGMGR_UNICAST_LINK_LOCAL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
specified link local address %1 for unicast traffic on interface %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی ثبت می‌شود که کاربر یک نشانی پیوند\-محلی (link\-local) را برای دریافت ترافیک تک‌پخشی (unicast) مشخص کرده باشد. این پیام هشدار به دلیل غیرمعمول بودن چنین کاربردی صادر می‌شود.
.SS DHCPSRV_CFGMGR_UPDATE_SUBNET4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
updating subnet %1 (result %2)
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
یک پیام اشکال‌زدایی که هنگام به‌روزرسانی زیرشبکهٔ IPv4 مشخص‌شده در پیکربندی فعلی توسط مدیر پیکربندی DHCP گزارش می‌شود. شناسهٔ زیرشبکه (Subnet ID) و نتیجه (که انتظار می‌رود true باشد) نمایش داده می‌شوند.
.SS DHCPSRV_CFGMGR_UPDATE_SUBNET6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
updating subnet %1 (result %2)
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
یک پیام اشکال‌زدایی که هنگام جایگزینی زیرشبکهٔ IPv6 مشخص‌شده در پیکربندی فعلی توسط مدیر پیکربندی DHCP گزارش می‌شود. شناسهٔ زیرشبکه و نتیجه (که انتظار می‌رود true باشد) نمایش داده می‌شوند.
.SS DHCPSRV_CFGMGR_USE_ADDRESS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
listening on address %1, on interface %2
.EE
.UNINDENT
.UNINDENT
.sp
پیامی که وقتی سرور برای شنود روی نشانی IP صریحاً مشخص‌شده در واسط (interface) داده‌شده پیکربندی شده باشد، صادر می‌شود.
.SS DHCPSRV_CFGMGR_USE_ALLOCATOR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
using the %1 allocator for %2 leases in subnet %3
.EE
.UNINDENT
.UNINDENT
.sp
پیامی که هنگام آغاز استفادهٔ مدیر پیکربندی از یک تخصیص‌دهندهٔ (allocator) مشخص برای یک زیرشبکه صادر می‌شود.
.SS DHCPSRV_CFGMGR_USE_UNICAST
.INDENT 0.0
.INDENT 3.5
.sp
.EX
listening on unicast address %1, on interface %2
.EE
.UNINDENT
.UNINDENT
.sp
یک پیام اطلاع‌رسانی (info) که هنگام پیکربندی سرور DHCP برای شنود روی نشانی تک‌پخشی (unicast) در واسط مشخص صادر می‌شود.
.SS DHCPSRV_CLASS_WITH_ADDITIONAL_AND_LIFETIMES
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class: %1 has \(aqonly\-in\-additional\-list\(aq true while specifying one or more lease life time values. Life time values will be ignored.
.EE
.UNINDENT
.UNINDENT
.sp
این هشدار زمانی صادر می‌شود که کلاسی با \(aqonly\-in\-addition\-list\(aq برابر با true پیکربندی شده باشد و هم‌زمان یک یا چند پارامتر طول عمر اجاره (مانند \(aqvalid\-lifetime\(aq، \(aqpreferred\-lifetime\(aq یا \(aqoffer\-lifetime\(aq) را تعیین کند. کلاس‌های فهرست الحاقی (additional list) پس از تخصیص اجاره ارزیابی می‌شوند؛ بنابراین پارامترهایی که در غیر این صورت بر طول عمر اجاره تأثیر می‌گذاشتند، هیچ اثری نخواهند داشت.
.SS DHCPSRV_CLIENT_CLASS_DEPRECATED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
The parameter \(aqclient\-class\(aq is deprecated. Use \(aqclient\-classes\(aq list parameter instead
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که تجزیهٔ پیکربندی، استفاده از پارامتر منسوخ‌شدهٔ \(aqclient\-class\(aq را تشخیص دهد. این پارامتر با \(aqclient\-classes\(aq جایگزین شده است. کاربران باید به پارامتر فهرستی جدید مهاجرت کنند..SS DHCPSRV_CLOSE_DB
.INDENT 0.0
.INDENT 3.5
.sp
.EX
closing currently open %1 database
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 40 ثبت می‌شود.
این یک پیام اشکال‌زدایی است و زمانی صادر می‌شود که سرور DHCP پایگاه‌دادهٔ اجاره‌های در حال حاضر باز را می‌بندد. این پیام هنگام خاموش شدن برنامه و هر زمان که پارامترهای دسترسی به پایگاه‌داده تغییر کنند، صادر می‌شود: در حالت دوم، سرور پایگاه‌دادهٔ باز فعلی را بسته و پایگاه‌داده‌ای را با استفاده از پارامترهای جدید باز می‌کند.
.SS DHCPSRV_DDNS_TTL_TOO_LARGE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1 of lease life time %2 is %3, using maximum of %4 instead.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 55 ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که مقدار DDNS TTL محاسبه‌شده با استفاده از ddns\-ttl\-percent (در صورت تعیین) یا (0.33 در صورت عدم تعیین)، از مقدار مشخص‌شدهٔ ddns\-ttl\-max بزرگ‌تر باشد. Kea این مقدار را نادیده گرفته و در عوض از حداکثر مشخص‌شده استفاده می‌کند. جزئیات پیام شامل درصد، طول عمر اجاره، TTL محاسبه‌شده و مقدار استفاده‌شدهٔ واقعی است.
.SS DHCPSRV_DDNS_TTL_TOO_SMALL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1 of lease life time %2 is %3, using minimum of %4 instead.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 55 ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که مقدار DDNS TTL محاسبه‌شده با استفاده از ddns\-ttl\-percent (در صورت تعیین) یا (0.33 در صورت عدم تعیین)، بیش از حد کوچک باشد. Kea این مقدار را نادیده گرفته و از حداقل (ddns\-ttl\-min در صورت تعیین، یا 600 ثانیه در صورت عدم تعیین) استفاده می‌کند. جزئیات پیام شامل درصد، طول عمر اجاره، TTL محاسبه‌شده و مقدار استفاده‌شدهٔ واقعی است.
.SS DHCPSRV_DHCP4O6_RECEIVED_BAD_PACKET
.INDENT 0.0
.INDENT 3.5
.sp
.EX
received bad DHCPv4o6 packet: %1
.EE
.UNINDENT
.UNINDENT
.sp
یک بستهٔ نامعتبر DHCPv4o6 دریافت شد.
.SS DHCPSRV_DHCP_DDNS_ERROR_EXCEPTION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
error handler for DHCP_DDNS IO generated an expected exception: %1
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی رخ می‌دهد که تلاش برای ارسال درخواست به kea\-dhcp\-ddns ناموفق باشد و گردانندهٔ خطای ثبت‌شده، یک استثنای مدیریت‌نشده ایجاد کند. این یک خطای برنامه‌نویسی است که نباید رخ دهد. طبق قرارداد، گردانندهٔ خطا نباید استثناها را انتشار دهد. لطفاً این خطا را گزارش دهید.
.SS DHCPSRV_DHCP_DDNS_HANDLER_NULL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
error handler for DHCP_DDNS IO is not set.
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی رخ می‌دهد که تلاش برای ارسال درخواست به kea\-dhcp\-ddns ناموفق باشد و هیچ گردانندهٔ خطایی ثبت نشده باشد. این یک خطای برنامه‌نویسی است که هرگز نباید رخ دهد و باید گزارش شود.
.SS DHCPSRV_DHCP_DDNS_NCR_REJECTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
NameChangeRequest rejected by the sender: %1, ncr: %2
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و نشان می‌دهد NameChangeSender که برای تحویل درخواست‌های به‌روزرسانی DDNS به kea\-dhcp\-ddns استفاده می‌شود، درخواست را رد کرده است. محتمل‌ترین علت این است که صف فرستنده به حداکثر ظرفیت خود رسیده باشد. این بدان معناست که درخواست‌ها سریع‌تر از توانایی تحویل آن‌ها تولید می‌شوند.
.SS DHCPSRV_DHCP_DDNS_NCR_SENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
NameChangeRequest sent to kea\-dhcp\-ddns: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 50 ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک NameChangeRequest با موفقیت به kea\-dhcp\-ddns ارسال شده باشد.
.SS DHCPSRV_DHCP_DDNS_SENDER_STARTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
NameChangeRequest sender has been started: %1
.EE
.UNINDENT
.UNINDENT
.sp
یک پیام اطلاع‌رسانی که هنگام آغاز موفقیت‌آمیز ارتباط با kea\-dhcp\-ddns صادر می‌شود..SS DHCPSRV_DHCP_DDNS_SENDER_STOPPED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
NameChangeRequest sender has been stopped.
.EE
.UNINDENT
.UNINDENT
.sp
پیامی اطلاعاتی که هنگام متوقف شدن ارتباط با kea\-dhcp\-ddns صادر می‌شود. این وضعیت معمولاً در طول پیکربندی مجدد و به عنوان بخشی از فرایند عادی خاموش شدن رخ می‌دهد. همچنین اگر ارتباطات با kea\-dhcp\-ddns قطع شود، ممکن است رخ دهد.
.SS DHCPSRV_DHCP_DDNS_SUSPEND_UPDATES
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCP_DDNS updates are being suspended.
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام هشدار است و نشان می‌دهد که به‌روزرسانی‌های DHCP_DDNS غیرفعال شده‌اند. این حالت تنها در صورتی باید رخ دهد که خطاهای ورودی/خروجی (IO) در ارتباط با kea\-dhcp\-ddns رخ داده باشد. هرگونه خطایی از این دست باید پیش‌تر همراه با جزئیات در لاگ ثبت شده باشد. بدون مداخله، تلاش دیگری برای برقراری ارتباط با kea\-dhcp\-ddns انجام نخواهد شد.
.SS DHCPSRV_EVAL_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Expression \(aq%2\(aq evaluated to %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که هنگام ارزیابی یک عبارت (expression) از یک client class مشکلی رخ داده است.
توضیحی دربارهٔ مشکل چاپ می‌شود.
.SS DHCPSRV_EVAL_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Expression \(aq%2\(aq evaluated to %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug log level) 50 ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که عبارت یک client class با موفقیت ارزیابی شده است. نام client class و مقدار حاصل از ارزیابی چاپ می‌شوند.
.SS DHCPSRV_FORENSIC_BACKENDS_REGISTERED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
the following forensic backend types are available: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی تمام انواع backendهای فارنزیک (forensic) ممکن را که می‌توان در ثبت وقایع فارنزیک (forensic logging) استفاده کرد، فهرست می‌کند.
.SS DHCPSRV_FORENSIC_BACKEND_DEREGISTER
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deregistered forensic backend type: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 40 ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک backend factory از ثبت لغو شده باشد.
دیگر استفاده از backend فارنزیک از این نوع امکان‌پذیر نیست.
.SS DHCPSRV_FORENSIC_BACKEND_REGISTER
.INDENT 0.0
.INDENT 3.5
.sp
.EX
registered forensic backend type: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 40 ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک backend factory با موفقیت ثبت شده باشد.
اکنون استفاده از backend فارنزیک از این نوع امکان‌پذیر است.
.SS DHCPSRV_HOOK_LEASE4_RECOVER_SKIP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCPv4 lease %1 was not recovered from the declined state because a callout set the skip status.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 40 ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی چاپ می‌شود که یک callout نصب‌شده روی نقطهٔ قلاب lease4_recover وضعیت مرحلهٔ بعدی را روی SKIP تنظیم کرده باشد. برای این نقطهٔ قلاب خاص، این امر نشان می‌دهد که سرور نباید اجاره (lease) را از وضعیت رد شده (declined) بازیابی کند. سرور اجاره را به همان صورتی که هست در وضعیت رد شده باقی می‌گذارد. سرور در نوبت بعدی اجرای فرایند بازیابی رد (decline recovery)، برای بازیابی آن تلاش خواهد کرد.
.SS DHCPSRV_HOOK_LEASE4_RENEW_SKIP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCPv4 lease was not renewed because a callout set the skip flag.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 40 ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی چاپ می‌شود که یک callout نصب‌شده روی نقطهٔ قلاب lease4_renew پرچم skip را تنظیم کرده باشد. برای این نقطهٔ قلاب خاص، تنظیم این پرچم توسط callout به سرور دستور می‌دهد که اجاره را تمدید نکند. سرور از اجارهٔ موجود به همان شکلی که هست، بدون تمدید طول عمر آن استفاده خواهد کرد..SS DHCPSRV_HOOK_LEASE4_SELECT_SKIP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Lease4 creation was skipped, because of callout skip flag.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی چاپ می‌شود که یک callout نصب‌شده روی
نقطه قلاب (hook point) lease4_select پرچم skip را تنظیم کند. این بدان معناست که به
سرور اعلام شده است هیچ lease4 نباید تخصیص داده شود. سرور این اجاره را در
پایگاه‌داده خود قرار نخواهد داد و کلاینت یک بسته NAK دریافت خواهد کرد.
.SS DHCPSRV_HOOK_LEASE6_EXTEND_SKIP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCPv6 lease lifetime was not extended because a callout set the skip flag for message %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی چاپ می‌شود که یک callout نصب‌شده روی نقطه قلاب
lease6_renew یا lease6_rebind پرچم skip را تنظیم کند. برای این نقطه قلاب
به‌خصوص، تنظیم این پرچم توسط callout به سرور دستور می‌دهد که طول عمر اجاره را
تمدید نکند. اگر کلاینت تمدید چندین اجاره را (با ارسال چندین گزینه IA) درخواست
کرده باشد، سرور از تمدید اجاره مورد نظر صرف‌نظر کرده و سایر تمدیدها را طبق روال معمول انجام خواهد داد.
.SS DHCPSRV_HOOK_LEASE6_RECOVER_SKIP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCPv6 lease %1 was not recovered from declined state because a callout set the skip status.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی چاپ می‌شود که یک callout نصب‌شده روی نقطه قلاب
lease6_recover وضعیت مرحله بعد را روی SKIP تنظیم کند. برای این نقطه قلاب به‌خصوص،
این موضوع نشان می‌دهد که سرور نباید اجاره را از وضعیت ردشده (declined) بازیابی کند.
سرور اجاره را همان‌طور که هست، در وضعیت declined رها خواهد کرد. سرور
دفعه بعد که فرایند بازیابی رد انجام شود، دوباره برای بازیابی آن تلاش خواهد کرد.
.SS DHCPSRV_HOOK_LEASE6_SELECT_SKIP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Lease6 (non\-temporary) creation was skipped, because of callout skip flag.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی چاپ می‌شود که یک callout نصب‌شده روی نقطه قلاب
lease6_select پرچم skip را تنظیم کند. این بدان معناست که به سرور اعلام شده است
هیچ lease6 نباید تخصیص یابد. سرور این اجاره را در پایگاه‌داده خود قرار
نخواهد داد و کلاینت برای آن گزینه IA_NA یک پاسخ NoAddrsAvail دریافت خواهد کرد.
.SS DHCPSRV_HOST_MGR_DB_OPEN_CONNECTION_WITH_RETRY_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Failed to connect to database: %1 with error: %2
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام اطلاع‌رسانی است و زمانی صادر می‌شود که سرور نتواند به
پایگاه‌داده میزبان متصل شود. این عملیات فرایند تلاش مجدد برای اتصال را آغاز کرده است.
رشته دسترسی به پایگاه‌داده همراه با سانسور گذرواژه، به همراه خطا و
جزئیات مربوط به فرایند اتصال مجدد ثبت می‌شود.
.SS DHCPSRV_LEASE4_EXTENDED_INFO_SANITY_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
extended info for lease %1 failed checks (%2)
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی چاپ می‌شود که اطلاعات تکمیلی (extended info) یک اجاره در
بررسی‌های صحت‌سنجی رد شود. جزئیات مشکلِ پیدا شده نمایش داده شده و
اطلاعات تکمیلی از بافت کاربری اجاره (lease user context) حذف می‌شود.
.SS DHCPSRV_LEASE4_EXTENDED_INFO_UPGRADED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
extended info for lease %1 was upgraded
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی چاپ می‌شود که اطلاعات تکمیلی یک اجاره ارتقا یافته باشد.
.SS DHCPSRV_LEASE6_EXTENDED_INFO_SANITY_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
extended info for lease %1 failed checks (%2)
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی چاپ می‌شود که اطلاعات تکمیلی (extended info) یک اجاره در
بررسی‌های صحت‌سنجی رد شود. جزئیات مشکلِ پیدا شده نمایش داده شده و
اطلاعات تکمیلی از بافت کاربری اجاره (lease user context) حذف می‌شود.
.SS DHCPSRV_LEASE6_EXTENDED_INFO_UPGRADED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
extended info for lease %1 was upgraded
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی چاپ می‌شود که اطلاعات تکمیلی یک اجاره ارتقا یافته باشد..SS DHCPSRV_LEASE_MGR_BACKENDS_REGISTERED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
the following lease backend types are available: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی، تمام پس‌اندهای ممکن برای اجاره را که می‌توان در lease\-database استفاده کرد، فهرست می‌کند.
.SS DHCPSRV_LEASE_MGR_BACKEND_DEREGISTER
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deregistered lease backend type: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک backend factory از حالت ثبت خارج شده باشد.
دیگر امکان استفاده از پس‌اند اجاره از این نوع وجود ندارد.
.SS DHCPSRV_LEASE_MGR_BACKEND_REGISTER
.INDENT 0.0
.INDENT 3.5
.sp
.EX
registered lease backend type: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک backend factory با موفقیت ثبت شده باشد.
اکنون امکان استفاده از پس‌اند اجاره از این نوع وجود دارد.
.SS DHCPSRV_LEASE_MGR_CALLBACK_EXCEPTION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
exception occurred in a lease manager callback for callback type %1, subnet id %2, and lease %3: %4
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی چاپ می‌شود که یکی از توابع بازخوانی (callback) ثبت‌شده در مدیر اجاره (lease manager) باعث بروز خطا شود. توابع بازخوانی می‌توانند اهداف متفاوتی داشته باشند و احتمالاً پیام‌های خطای دقیق‌تری ثبت می‌کنند. این پیام خطا احتمالاً نشان‌دهندهٔ یک خطای رسیدگی‌نشده (unhandled error) است. آرگومان نخست نوع callback را مشخص می‌کند. آرگومان دوم شناسهٔ زیرشبکه (subnet id) را چاپ می‌کند. آرگومان سوم اجاره‌ای را که خطا برای آن رخ داده است چاپ می‌کند. آرگومان آخر متن خطا را نمایش می‌دهد.
.SS DHCPSRV_LEASE_MGR_CALLBACK_UNKNOWN_EXCEPTION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
unknown exception occurred in a lease manager callback for callback type %1, subnet id %2, and lease %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی چاپ می‌شود که یکی از توابع بازخوانی (callback) ثبت‌شده در مدیر اجاره (lease manager) باعث بروز یک خطای ناشناخته شود. توابع بازخوانی می‌توانند اهداف متفاوتی داشته باشند و احتمالاً پیام‌های خطای دقیق‌تری ثبت می‌کنند. این پیام خطا احتمالاً نشان‌دهندهٔ یک خطای رسیدگی‌نشده است. آرگومان نخست نوع callback را مشخص می‌کند. آرگومان دوم شناسهٔ زیرشبکه (subnet id) را چاپ می‌کند. آرگومان سوم اجاره‌ای را که خطا برای آن رخ داده است چاپ می‌کند. این نگارش از پیام لاگ حاوی متن خطا نیست، زیرا توسط یک استثنای ناشناخته (unknown exception) برانگیخته شده است.
.SS DHCPSRV_LEASE_MGR_DB_OPEN_CONNECTION_WITH_RETRY_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Failed to connect to database: %1 with error: %2
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام اطلاعاتی است که در صورت عدم موفقیت سرور در اتصال به پایگاه‌دادهٔ اجاره‌ها صادر می‌شود. این عملیات رویهٔ تلاش مجدد برای برقراری اتصال را آغاز کرده است. رشتهٔ دسترسی به پایگاه‌داده همراه با گذرواژهٔ سانسورشده (redacted)، به همراه خطا و جزئیات رویهٔ اتصال مجدد ثبت می‌شود.
.SS DHCPSRV_LEASE_SANITY_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
The lease %1 with subnet\-id %2 failed subnet\-id checks (%3).
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی چاپ می‌شود که اجارهٔ در حال بارگذاری با پیکربندی مطابقت ندارد. با توجه به مقدار lease\-checks، اجاره بارگذاری خواهد شد، اما به احتمال زیاد توسط Kea استفاده نخواهد شد؛ زیرا هیچ زیرشبکه‌ای که با نشانی IP مرتبط با این اجاره همخوانی داشته باشد وجود ندارد.
.SS DHCPSRV_LEASE_SANITY_FAIL_DISCARD
.INDENT 0.0
.INDENT 3.5
.sp
.EX
The lease %1 with subnet\-id %2 failed subnet\-id checks (%3) and was dropped.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی چاپ می‌شود که یک اجاره بارگذاری شده، اما به Kea دستور داده شده است (با تنظیم پارامتر lease\-checks) که اجاره‌های دارای داده‌های ناسازگار را دور بیندازد. اجاره دور انداخته شد، زیرا یا هیچ زیرشبکه‌ای با subnet\-id منطبق پیکربندی نشده است، یا نشانیِ اجاره متعلق به آن زیرشبکه نیست.
.SS DHCPSRV_LEASE_SANITY_FIXED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
The lease %1 with subnet\-id %2 failed subnet\-id checks, but was corrected to subnet\-id %3.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی زمانی چاپ می‌شود که یک اجاره بارگذاری شده، اما مقدار subnet\-id آن نادرست بوده است. پارامتر lease\-checks روی مقداری تنظیم شده بود که به Kea دستور می‌داد برای رفع مشکل تلاش کند. از آنجا که یک زیرشبکهٔ منطبق وجود دارد، Kea مقدار subnet\-id را به‌روزرسانی کرده و اجاره را با موفقیت بارگذاری نمود..SS DHCPSRV_MEMFILE_ADD_ADDR4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
adding IPv4 lease with address %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ دیباگ ۵۰ ثبت می‌شود.
این پیام دیباگ زمانی صادر می‌شود که کارگزار در شرف افزودن یک اجارهٔ IPv4 با نشانی مشخص‌شده به پایگاه‌دادهٔ پشتیبان memory file است.
.SS DHCPSRV_MEMFILE_ADD_ADDR6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
adding IPv6 lease with address %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ دیباگ ۵۰ ثبت می‌شود.
این پیام دیباگ زمانی صادر می‌شود که کارگزار در شرف افزودن یک اجارهٔ IPv6 با نشانی مشخص‌شده به پایگاه‌دادهٔ پشتیبان memory file است.
.SS DHCPSRV_MEMFILE_BEGIN_BUILD_EXTENDED_INFO_TABLES6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
building extended info tables with %1 sanity check level, tables %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ دیباگ ۴۰ ثبت می‌شود.
این پیام دیباگ زمانی صادر می‌شود که کارگزار در حال ساخت جدول‌های اطلاعات تکمیلی (extended info) است.
سطح بررسی صحت (sanity check) اطلاعات تکمیلی و فعال یا غیرفعال بودن جدول‌ها نمایش داده می‌شوند.
.SS DHCPSRV_MEMFILE_BEGIN_EXTRACT_EXTENDED_INFO4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
extract extended info with %1 sanity check level%2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ دیباگ ۴۰ ثبت می‌شود.
این پیام دیباگ زمانی صادر می‌شود که کارگزار در حال استخراج اطلاعات تکمیلی است.
سطح بررسی صحت اطلاعات تکمیلی و به‌روزرسانی در فایل در صورت درخواست نمایش داده می‌شوند.
.SS DHCPSRV_MEMFILE_BUILD_EXTENDED_INFO_TABLES6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
building extended info tables saw %1 leases, extended info sanity checks modified %2 leases and %3 leases were entered into tables
.EE
.UNINDENT
.UNINDENT
.sp
ساخت جدول‌های اطلاعات تکمیلی به پایان رسید. برخی آمارها نمایش داده می‌شوند و وضعیت به‌روزشده در پایگاه‌داده به رابط فرمانی بازگردانده می‌شود.
.SS DHCPSRV_MEMFILE_BUILD_EXTENDED_INFO_TABLES6_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
building extended info tables got an exception on the lease for %1: %2
.EE
.UNINDENT
.UNINDENT
.sp
پیام خطایی که زمانی صادر می‌شود که کارگزار در حال ساخت جدول‌های اطلاعات تکمیلی است و در هنگام پردازش یک اجاره با یک استثنا (exception) مواجه می‌شود.
.SS DHCPSRV_MEMFILE_COMMIT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
committing to memory file database
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ دیباگ ۵۰ ثبت می‌شود.
کد یک فراخوانی commit صادر کرده است. برای پایگاه‌دادهٔ memory file، این یک عملیات بی‌اثر (no\-op) است.
.SS DHCPSRV_MEMFILE_CONVERTING_LEASE_FILES
.INDENT 0.0
.INDENT 3.5
.sp
.EX
running LFC now to convert lease files to the current schema: %1.%2
.EE
.UNINDENT
.UNINDENT
.sp
پیام هشداری که زمانی صادر می‌شود که کارگزار فایل‌های اجاره‌ای را شناسایی کرده که برای مطابقت با طرح‌وارهٔ (schema) کارگزار باید ارتقا یا تنزیل یابند، و کارگزار به‌طور خودکار فرایند LFC را برای انجام این تبدیل اجرا می‌کند.
این اتفاق فقط باید در نخستین باری که کارگزار پس از ارتقای نصب Kea (یا تنزیل آن) راه‌اندازی می‌شود رخ دهد.
.SS DHCPSRV_MEMFILE_DB
.INDENT 0.0
.INDENT 3.5
.sp
.EX
opening memory file lease database: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی زمانی ثبت می‌شود که یک کارگزار DHCP (چه V4 یا V6) در شرف باز کردن یک پایگاه‌دادهٔ اجارهٔ memory file است. پارامترهای اتصال شامل نام پایگاه‌داده و نام کاربری لازم برای دسترسی به آن (اما نه گذرواژه، در صورت وجود) در لاگ ثبت می‌شوند..SS DHCPSRV_MEMFILE_DELETE_ADDR4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleting lease for address %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در تلاش برای حذف اجارهٔ آدرس
مشخص‌شده از پایگاه‌دادهٔ فایل حافظه (memfile) است.
.SS DHCPSRV_MEMFILE_DELETE_ADDR6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleting lease for address %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در تلاش برای حذف اجارهٔ آدرس
مشخص‌شده از پایگاه‌دادهٔ فایل حافظه (memfile) است.
.SS DHCPSRV_MEMFILE_DELETE_EXPIRED_RECLAIMED4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleting reclaimed IPv4 leases that expired more than %1 seconds ago
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در حال حذف اجاره‌های بازپس‌گرفته‌شدهٔ (reclaimed)
DHCPv4 است که بیش از بازهٔ زمانی مشخصی منقضی شده‌اند.
آرگومان، مدت زمانی است که Kea پس از انقضای یک اجارهٔ بازپس‌گرفته‌شده
پیش از اقدام به حذف آن، منتظر می‌ماند.
.SS DHCPSRV_MEMFILE_DELETE_EXPIRED_RECLAIMED6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleting reclaimed IPv6 leases that expired more than %1 seconds ago
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در حال حذف اجاره‌های بازپس‌گرفته‌شدهٔ (reclaimed)
DHCPv6 است که بیش از بازهٔ زمانی مشخصی منقضی شده‌اند.
آرگومان، مدت زمانی است که Kea پس از انقضای یک اجارهٔ بازپس‌گرفته‌شده
پیش از اقدام به حذف آن، منتظر می‌ماند.
.SS DHCPSRV_MEMFILE_DELETE_EXPIRED_RECLAIMED_START
.INDENT 0.0
.INDENT 3.5
.sp
.EX
starting deletion of %1 expired\-reclaimed leases
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور اجاره‌های منقضی‌شده\-بازپس‌گرفته‌شده‌ای را
برای حذف پیدا کرده است. تعداد اجاره‌های قابل حذف در پیام
ثبت می‌شود.
.SS DHCPSRV_MEMFILE_EXTRACT_EXTENDED_INFO4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
extracting extended info saw %1 leases, extended info sanity checks modified %2 / updated %3 leases and %4 leases have relay or remote id
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
استخراج اطلاعات گسترده (extended info) به پایان رسید. آمارهایی نمایش داده می‌شوند، و
موارد به‌روزشده در پایگاه‌داده به رابط فرمان بازگردانده می‌شوند.
.SS DHCPSRV_MEMFILE_EXTRACT_EXTENDED_INFO4_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
extracting extended info got an exception on the lease for %1: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در حال استخراج اطلاعات گسترده است و
در حین پردازش یک اجاره با یک استثنا (exception) مواجه می‌شود.
.SS DHCPSRV_MEMFILE_FAILED_TO_OPEN
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Could not open lease file: %1
.EE
.UNINDENT
.UNINDENT
.sp
این خطا زمانی صادر می‌شود که باز کردن فایل اجاره امکان‌پذیر نباشد. آرگومان
شامل جزئیات است. محتمل‌ترین دلیل این است که پارامتر \fIname\fP
برای بک‌اند memfile حاوی مسیری به غیر از مسیر پشتیبانی‌شده باشد.
آرگومان حاوی جزئیات خواهد بود. مؤلفهٔ مسیر را می‌توان به‌سادگی
نادیده گرفت و حذف کرد. برای بازنویسی مسیر پیش‌فرض پشتیبانی‌شده، متغیر
محیطی KEA_DHCP_DATA_DIR را پیش از اجرای سرور تنظیم کنید.
.SS DHCPSRV_MEMFILE_GET4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining all IPv4 leases
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در تلاش برای دریافت تمام
اجاره‌های IPv4 از پایگاه‌دادهٔ فایل حافظه (memfile) است..SS DHCPSRV_MEMFILE_GET6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining all IPv6 leases
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در حال تلاش برای دریافت تمام اجاره‌های IPv6 از پایگاه دادهٔ memory file است.
.SS DHCPSRV_MEMFILE_GET6_DUID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv6 leases for DUID %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در حال تلاش برای دریافت اجاره‌های IPv6 برای DUID مربوطه از پایگاه دادهٔ memory file است.
.SS DHCPSRV_MEMFILE_GET_ADDR4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv4 lease for address %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در حال تلاش برای دریافت یک اجارهٔ IPv4 از پایگاه دادهٔ memory file برای آدرس مشخص‌شده است.
.SS DHCPSRV_MEMFILE_GET_ADDR6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv6 lease for address %1 and lease type %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در حال تلاش برای دریافت یک اجارهٔ IPv6 از پایگاه دادهٔ memory file برای آدرس مشخص‌شده است.
.SS DHCPSRV_MEMFILE_GET_CLIENTID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv4 leases for client ID %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در حال تلاش برای دریافت مجموعه‌ای از اجاره‌های IPv4 از پایگاه دادهٔ memory file برای کلاینتی با شناسهٔ کلاینت مشخص‌شده است.
.SS DHCPSRV_MEMFILE_GET_EXPIRED4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining maximum %1 of expired IPv4 leases
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در حال تلاش برای دریافت اجاره‌های منقضی‌شدهٔ IPv4 جهت بازپس‌گیری آن‌ها است. حداکثر تعداد اجاره‌هایی که باید بازیابی شوند در پیام ثبت می‌شود.
.SS DHCPSRV_MEMFILE_GET_EXPIRED6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining maximum %1 of expired IPv6 leases
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در حال تلاش برای دریافت اجاره‌های منقضی‌شدهٔ IPv6 جهت بازپس‌گیری آن‌ها است. حداکثر تعداد اجاره‌هایی که باید بازیابی شوند در پیام ثبت می‌شود.
.SS DHCPSRV_MEMFILE_GET_HOSTNAME4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv4 leases for hostname %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در حال تلاش برای دریافت مجموعه‌ای از اجاره‌های IPv4 از پایگاه دادهٔ memory file برای کلاینتی با نام میزبان مشخص‌شده است.
.SS DHCPSRV_MEMFILE_GET_HOSTNAME6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv6 leases for hostname %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در حال تلاش برای دریافت مجموعه‌ای از اجاره‌های IPv6 از پایگاه دادهٔ memory file برای کلاینتی با نام میزبان مشخص‌شده است..SS DHCPSRV_MEMFILE_GET_HWADDR4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv4 leases for hardware address %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در حال تلاش برای دریافت مجموعه‌ای از
اجاره‌های IPv4 از پایگاه‌داده فایل حافظه (memory file database) برای کلاینتی با
آدرس سخت‌افزاری مشخص‌شده است.
.SS DHCPSRV_MEMFILE_GET_HWADDR6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv6 leases for hardware address %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در حال تلاش برای دریافت مجموعه‌ای از
اجاره‌های IPv6 از پایگاه‌داده فایل حافظه (memory file database) برای کلاینتی با
آدرس سخت‌افزاری مشخص‌شده است.
.SS DHCPSRV_MEMFILE_GET_IAID_DUID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv6 leases for IAID %1 and DUID %2 and lease type %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در حال تلاش برای دریافت مجموعه‌ای از اجاره‌های IPv6
از پایگاه‌داده فایل حافظه برای کلاینتی با IAID
(شناسه Identity Association) و DUID (شناسه یکتای DHCP) مشخص‌شده است.
.SS DHCPSRV_MEMFILE_GET_IAID_SUBID_DUID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv6 leases for IAID %1, Subnet ID %2, DUID %3 and lease type %4
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در حال تلاش برای دریافت یک
اجاره IPv6 از پایگاه‌داده فایل حافظه برای کلاینتی با IAID
(شناسه Identity Association)، Subnet ID و DUID (شناسه یکتای DHCP) مشخص‌شده است.
.SS DHCPSRV_MEMFILE_GET_PAGE4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining at most %1 IPv4 leases starting from address %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در حال تلاش برای دریافت یک صفحه
از اجاره‌ها با شروع از آدرس مشخص‌شده است.
.SS DHCPSRV_MEMFILE_GET_PAGE6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining at most %1 IPv6 leases starting from address %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در حال تلاش برای دریافت یک صفحه
از اجاره‌ها با شروع از آدرس مشخص‌شده است.
.SS DHCPSRV_MEMFILE_GET_RELAYID4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining at most %1 IPv4 leases starting from address %2 with relay id %3 and cltt between %4 and %5
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در حال تلاش برای دریافت یک صفحه از
اجاره‌های IPv4 با شروع از آدرس مشخص‌شده با یک relay id و زمان
تراکنش کلاینت (cltt) بین تاریخ‌های شروع و پایان است.
.SS DHCPSRV_MEMFILE_GET_RELAYID6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining at most %1 IPv6 leases starting from address %2 with relay id %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در حال تلاش برای دریافت یک صفحه از
اجاره‌های IPv6 با شروع از آدرس مشخص‌شده با یک relay id است.
.SS DHCPSRV_MEMFILE_GET_REMOTEID4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining at most %1 IPv4 leases starting from address %2 with remote id %3 and cltt between %4 and %5
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در حال تلاش برای دریافت یک صفحه از
اجاره‌های IPv4 با شروع از آدرس مشخص‌شده با یک remote id و
زمان تراکنش کلاینت (cltt) بین تاریخ‌های شروع و پایان است..SS DHCPSRV_MEMFILE_GET_REMOTEID6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining at most %1 IPv6 leases starting from address %2 with remote id %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در تلاش است صفحه‌ای از اجاره‌های IPv6 را که با نشانی و remote id مشخص‌شده شروع می‌شوند، به دست آورد.
.SS DHCPSRV_MEMFILE_GET_SUBID4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv4 leases for subnet ID %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در تلاش است تمام اجاره‌های IPv4 را برای یک شناسه زیرشبکه (subnet ID) مشخص از پایگاه داده فایل حافظه دریافت کند.
.SS DHCPSRV_MEMFILE_GET_SUBID6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv6 leases for subnet ID %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در تلاش است تمام اجاره‌های IPv6 را برای یک شناسه زیرشبکه (subnet ID) مشخص از پایگاه داده فایل حافظه دریافت کند.
.SS DHCPSRV_MEMFILE_GET_SUBID_CLIENTID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv4 lease for subnet ID %1 and client ID %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در تلاش است یک اجاره IPv4 را برای کلاینتی با شناسه زیرشبکه (subnet ID) و شناسه کلاینت (client ID) مشخص‌شده، از پایگاه داده فایل حافظه دریافت کند.
.SS DHCPSRV_MEMFILE_GET_SUBID_HWADDR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv4 lease for subnet ID %1 and hardware address %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در تلاش است یک اجاره IPv4 را برای کلاینتی با شناسه زیرشبکه (subnet ID) و نشانی سخت‌افزاری (hardware address) مشخص‌شده، از پایگاه داده فایل حافظه دریافت کند.
.SS DHCPSRV_MEMFILE_GET_SUBID_PAGE6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining at most %1 IPv6 leases starting from address %2 for subnet ID %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در تلاش است صفحه‌ای از اجاره‌های IPv6 را با شروع از نشانی مشخص‌شده برای یک شناسه زیرشبکه معین از پایگاه داده فایل حافظه دریافت کند.
.SS DHCPSRV_MEMFILE_LEASE_FILE_LOAD
.INDENT 0.0
.INDENT 3.5
.sp
.EX
loading leases from file %1
.EE
.UNINDENT
.UNINDENT
.sp
پیامی اطلاعاتی (info) که هنگامی صادر می‌شود که سرور در آستانه آغاز خواندن اجاره‌های DHCP از فایل اجاره است. تمام اجاره‌هایی که در حال حاضر در حافظه نگهداری می‌شوند، با اجاره‌های خوانده‌شده از فایل جایگزین خواهند شد.
.SS DHCPSRV_MEMFILE_LEASE_LOAD
.INDENT 0.0
.INDENT 3.5
.sp
.EX
loading lease %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که اجاره DHCP در حال بارگذاری از فایل به حافظه است.
.SS DHCPSRV_MEMFILE_LEASE_LOAD_ROW_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
discarding row %1, error: %2
.EE
.UNINDENT
.UNINDENT
.sp
پیام خطایی که در صورت ناموفق بودن بارگذاری اجاره DHCP از سطر مشخص‌شده در فایل اجاره صادر می‌شود. پیام لاگ باید شامل دلیل مشخص رد شدن سطر باشد. سرور به بارگذاری داده‌های باقی‌مانده ادامه می‌دهد. این ممکن است نشان‌دهنده یک فایل اجاره خراب باشد..SS DHCPSRV_MEMFILE_LFC_EXECUTE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
executing Lease File Cleanup using: %1
.EE
.UNINDENT
.UNINDENT
.sp
پیامی اطلاعاتی که هنگام آغاز یک فرآیند جدید توسط بک‌اند پایگاه‌داده اجاره memfile برای انجام پاک‌سازی فایل اجاره (Lease File Cleanup) صادر می‌شود.
.SS DHCPSRV_MEMFILE_LFC_FAIL_PID_CREATE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Lease File Cleanup pid file create: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که کد اجرای LFC در هنگام تلاش برای ایجاد فایل PID با شکست مواجه شود. این پیام شامل یک رشته خطای مشخص‌تر است.
.SS DHCPSRV_MEMFILE_LFC_LEASE_FILE_RENAME_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to rename the current lease file %1 to %2, reason: %3
.EE
.UNINDENT
.UNINDENT
.sp
پیام خطایی که هنگام عدم موفقیت بک‌اند پایگاه‌داده اجاره memfile در انتقال فایل اجاره فعلی به یک فایل جدید (که پاک‌سازی باید روی آن انجام شود) ثبت می‌شود. این امر در عمل به این معناست که پاک‌سازی فایل اجاره انجام نمی‌شود.
.SS DHCPSRV_MEMFILE_LFC_LEASE_FILE_REOPEN_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to reopen lease file %1 after preparing input file for lease file cleanup, reason: %2, new leases will not persist!
.EE
.UNINDENT
.UNINDENT
.sp
پیام خطایی که زمانی ثبت می‌شود که بک‌اند پایگاه‌داده اجاره memfile پس از تغییر نام فایل اجاره برای پاک‌سازی، در بازگشایی مجدد یا ایجاد مجدد فایل اجاره شکست می‌خورد. کارساز به فعالیت خود ادامه می‌دهد، اما اجاره‌های جدید روی دیسک ذخیره نخواهند شد.
.SS DHCPSRV_MEMFILE_LFC_RESCHEDULED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
rescheduled Lease File Cleanup
.EE
.UNINDENT
.UNINDENT
.sp
پیامی اطلاعاتی که زمانی صادر می‌شود که بک‌اند پایگاه‌داده اجاره memfile با دریافت دستور \(dqkea\-lfc\-start\(dq، زمان‌بندی پاک‌سازی دوره‌ای فایل اجاره را مجدداً تنظیم می‌کند.
.SS DHCPSRV_MEMFILE_LFC_RUNNING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Lease File Cleanup instance already running
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی زمانی صادر می‌شود که کد اجرای LFC از طریق بررسی PID متوجه شود که نمونه‌ای قبلی از فرآیند LFC همچنان در حال اجراست.
.SS DHCPSRV_MEMFILE_LFC_SETUP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
setting up the Lease File Cleanup interval to %1 sec
.EE
.UNINDENT
.UNINDENT
.sp
پیامی اطلاعاتی که هنگام پیکربندی LFC توسط بک‌اند پایگاه‌داده اجاره memfile برای اجرای دوره‌ای ثبت می‌شود. آرگومان ارائه‌شده حاوی بازه زمانی بر حسب ثانیه است که LFC در فواصل آن اجرا خواهد شد.
.SS DHCPSRV_MEMFILE_LFC_SPAWN_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
lease file cleanup failed to run because kea\-lfc process couldn\(aqt be spawned
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی ثبت می‌شود که کارساز Kea نتواند kea\-lfc (برنامه‌ای که فایل اجاره را پاک‌سازی می‌کند) را اجرا کند. کارساز در زمان‌بندی بعدیِ پاک‌سازی فایل اجاره دوباره تلاش خواهد کرد. اگرچه این پیام نباید رخ دهد و دلیل بروز آن باید بررسی شود، اما عدم اجرای گاه‌به‌گاهِ پاک‌سازی فایل اجاره تأثیری بر عملیات جاری نخواهد گذاشت. با این حال، در صورت تداوم این شکست، حجم فایل اجاره بدون محدودیت افزایش خواهد یافت.
.SS DHCPSRV_MEMFILE_LFC_START
.INDENT 0.0
.INDENT 3.5
.sp
.EX
starting Lease File Cleanup
.EE
.UNINDENT
.UNINDENT
.sp
پیامی اطلاعاتی که زمانی صادر می‌شود که بک‌اند پایگاه‌داده اجاره Memfile پاک‌سازی دوره‌ای فایل اجاره را آغاز می‌کند.
.SS DHCPSRV_MEMFILE_LFC_UNREGISTER_TIMER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to unregister timer \(aqmemfile\-lfc\(aq: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی ثبت می‌شود که بک‌اند Memfile نتواند تایمر مورد استفاده برای زمان‌بندی پاک‌سازی فایل اجاره را لغو ثبت کند. دلایل متعددی برای بروز این اتفاق وجود دارد، هرچند محتمل‌ترین علت آن خاموش شدن سیستم و لغو ثبت تایمر توسط مؤلفه‌ای دیگر است. این پیام شامل دلیل این خطا می‌باشد..SS DHCPSRV_MEMFILE_NEEDS_DOWNGRADING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
version of lease file: %1 schema is later than version %2
.EE
.UNINDENT
.UNINDENT
.sp
پیام هشداری که هنگامی صادر می‌شود که طرحواره‌ی (schema) فایل اجاره بارگذاری‌شده توسط سرور،
جدیدتر از طرحواره‌ی memfile سرور باشد. سرور داده‌های اجاره را هنگام خواندن از طرحواره‌های
جدیدتر به طرحواره‌ی خود تبدیل می‌کند، بنابراین اطلاعات اجاره‌ی مورد استفاده توسط سرور
صحیح خواهد بود. با این حال توجه داشته باشید که هرگونه داده‌ی ذخیره‌شده در فیلدهای طرحواره‌ی
جدیدتر نادیده گرفته شده و حذف خواهد شد. آنچه باقی می‌ماند این است که خود فایل با استفاده
از طرحواره‌ی فعلی بازنویسی شود.
.SS DHCPSRV_MEMFILE_NEEDS_UPGRADING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
version of lease file: %1 schema is earlier than version %2
.EE
.UNINDENT
.UNINDENT
.sp
پیام هشداری که هنگامی صادر می‌شود که طرحواره‌ی فایل اجاره بارگذاری‌شده توسط سرور،
قدیمی‌تر از طرحواره‌ی memfile سرور باشد. توجه داشته باشید که سرور داده‌های اجاره را
هنگام خواندن از طرحواره‌های قدیمی‌تر به طرحواره‌ی فعلی تبدیل می‌کند، بنابراین اطلاعات
اجاره‌ی مورد استفاده توسط سرور صحیح خواهد بود. آنچه باقی می‌ماند این است که خود
فایل با استفاده از طرحواره‌ی فعلی بازنویسی شود.
.SS DHCPSRV_MEMFILE_NO_STORAGE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
running in non\-persistent mode, leases will be lost after restart
.EE
.UNINDENT
.UNINDENT
.sp
پیام هشداری که هنگامی صادر می‌شود که نوشتن اجاره‌ها روی دیسک در پیکربندی غیرفعال
شده باشد. این حالت برای برخی از انواع آزمایش‌های کارایی مفید است، اما در شرایط
عادی نباید فعال شود. حالت غیرپایا (non\-persistence) زمانی فعال می‌شود که پارامترهای
\(aqpersist4=no persist6=no\(aq در رشته‌ی دسترسی پایگاه‌داده مشخص شده باشند.
.SS DHCPSRV_MEMFILE_PATH_SECURITY_WARNING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Lease file path specified is NOT SECURE: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که اعمال تدابیر امنیتی غیرفعال شده باشد و
مسیر مشخص‌شده برای فایل اجاره با مسیر پشتیبانی‌شده مطابقت نداشته باشد. سرور
همچنان از مسیر مشخص‌شده استفاده خواهد کرد، اما هشدار می‌دهد که انجام این کار
ممکن است خطرات امنیتی به همراه داشته باشد.
.SS DHCPSRV_MEMFILE_READ_HWADDR_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to read hardware address from lease file: %1
.EE
.UNINDENT
.UNINDENT
.sp
پیام هشداری که هنگام ناموفق بودن تلاش برای خواندن آدرس سخت‌افزاری ذخیره‌شده
در یک فایل دیسک صادر می‌شود. این پارامتر باید ماهیت دقیق خطا را ارائه دهد.
خواندن پایگاه‌داده ادامه خواهد یافت، اما آن اجاره‌ی خاص دیگر آدرس سخت‌افزاری
مرتبط با خود را نخواهد داشت.
.SS DHCPSRV_MEMFILE_ROLLBACK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
rolling back memory file database
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
کد یک فراخوانی rollback صادر کرده است. برای پایگاه‌داده‌ی فایل حافظه (memfile)،
این یک عملیات بدون اثر (no\-op) است.
.SS DHCPSRV_MEMFILE_UPDATE_ADDR4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
updating IPv4 lease for address %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی صادر می‌شود که سرور در تلاش برای به‌روزرسانی اجاره‌ی IPv4
از پایگاه‌داده‌ی فایل حافظه برای آدرس مشخص‌شده است.
.SS DHCPSRV_MEMFILE_UPDATE_ADDR6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
updating IPv6 lease for address %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی صادر می‌شود که سرور در تلاش برای به‌روزرسانی اجاره‌ی IPv6
از پایگاه‌داده‌ی فایل حافظه برای آدرس مشخص‌شده است.
.SS DHCPSRV_MEMFILE_WIPE_LEASES4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
removing all IPv4 leases from subnet %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی زمانی چاپ می‌شود که حذف تمام اجاره‌ها از زیرشبکه‌ی (subnet)
مشخص‌شده‌ی IPv4 آغاز شده باشد. این عمل در نتیجه‌ی دریافت یک دستور مدیریتی رخ می‌دهد..SS DHCPSRV_MEMFILE_WIPE_LEASES4_FINISHED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
removing all IPv4 leases from subnet %1 finished, removed %2 leases
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی زمانی چاپ می‌شود که حذف تمام اجاره‌ها از یک زیرشبکهٔ مشخص IPv4 به پایان رسیده باشد. تعداد اجاره‌های حذف‌شده نیز نمایش داده می‌شود.
.SS DHCPSRV_MEMFILE_WIPE_LEASES6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
removing all IPv6 leases from subnet %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی زمانی چاپ می‌شود که فرایند حذف تمام اجاره‌ها از زیرشبکهٔ مشخص‌شدهٔ IPv6 در حال آغاز است. این پیام در نتیجهٔ دریافت یک دستور مدیریتی صادر می‌شود.
.SS DHCPSRV_MEMFILE_WIPE_LEASES6_FINISHED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
removing all IPv6 leases from subnet %1 finished, removed %2 leases
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی زمانی چاپ می‌شود که حذف تمام اجاره‌ها از یک زیرشبکهٔ مشخص IPv6 به پایان رسیده باشد. تعداد اجاره‌های حذف‌شده نیز نمایش داده می‌شود.
.SS DHCPSRV_MT_DISABLED_QUEUE_CONTROL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
disabling dhcp queue control when multi\-threading is enabled.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که در صورت فعال بودن multi\-threading، کنترل صف DHCP به‌طور خودکار غیرفعال گردد. این دو گزینه با یکدیگر ناسازگارند و نمی‌توان هر دو را به‌طور هم‌زمان فعال کرد.
.SS DHCPSRV_MULTIPLE_RAW_SOCKETS_PER_IFACE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
current configuration will result in opening multiple broadcast capable sockets on some interfaces and some DHCP messages may be duplicated
.EE
.UNINDENT
.UNINDENT
.sp
پیام هشداری که نشان می‌دهد پیکربندی فعلی منجر به باز شدن چندین سوکت با قابلیت دریافت ترافیک همگانی (broadcast) روی برخی از رابط‌ها خواهد شد. باید توجه داشت که این وضعیت ممکن است به دریافت و پردازش چندبارهٔ یک پیام DHCP یکسان بیانجامد، زیرا پیام توسط هر یک از سوکت‌ها به‌طور جداگانه دریافت خواهد شد.
.SS DHCPSRV_NOTYPE_DB
.INDENT 0.0
.INDENT 3.5
.sp
.EX
no \(aqtype\(aq keyword to determine database backend: %1
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی ثبت می‌شود که تلاشی برای دسترسی به یک backend پایگاه‌داده انجام شده باشد، اما کلیدواژهٔ \(aqtype\(aq در رشتهٔ دسترسی قید نشده باشد. رشتهٔ دسترسی (بدون گذرواژه‌ها) در این پیام گنجانده شده است.
.SS DHCPSRV_NO_SOCKETS_OPEN
.INDENT 0.0
.INDENT 3.5
.sp
.EX
no interface configured to listen to DHCP traffic
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که پیکربندی فعلی سرور هیچ رابطی را برای گوش دادن سرور به آن مشخص نکرده باشد، یا رابط‌های مشخص‌شده برای دریافت ترافیک پیکربندی نشده باشند.
.SS DHCPSRV_ONLY_IF_REQUIRED_DEPRECATED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
The parameter \(aqonly\-if\-required\(aq is deprecated. Use \(aqonly\-in\-additional\-list\(aq instead
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که پردازش و بررسی پیکربندی، استفاده از پارامتر منسوخ‌شدهٔ \(aqonly\-if\-required\(aq را تشخیص دهد. این پارامتر با \(aqonly\-in\-additional\-list\(aq جایگزین شده است. کاربران باید به استفاده از پارامتر جدید مهاجرت کنند.
.SS DHCPSRV_OPEN_SOCKET_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to open socket: %1
.EE
.UNINDENT
.UNINDENT
.sp
پیام هشداری که هنگام شکست IfaceMgr در باز کردن و bind کردن یک سوکت صادر می‌شود. دلیل این شکست به عنوان یک آرگومان در پیام ثبت گزارش ضمیمه شده است..SS DHCPSRV_QUEUE_NCR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Name change request to %2 DNS entry queued: %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۵۵ ثبت می‌شود.
پیام اشکال‌زدایی‌ای که هنگام در صف قرار گرفتن NameChangeRequest برای افزودن یا حذف مدخل‌های DNS برای یک اجارهٔ (lease) مشخص ثبت می‌شود. آرگومان نخست شامل اطلاعات شناسایی کلاینت است. آرگومان دوم مشخص می‌کند که آیا مدخل DNS باید افزوده شود یا حذف. آرگومان سوم حامل جزئیات NameChangeRequest است.
.SS DHCPSRV_QUEUE_NCR_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: queuing %2 name change request failed for lease %3: %4
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی ثبت می‌شود که ارسال NameChangeRequest به DHCP DDNS با شکست مواجه شود. آرگومان نخست شامل اطلاعات شناسایی کلاینت است. آرگومان دوم مشخص می‌کند که آیا مدخل DNS باید افزوده شود یا حذف. آرگومان سوم نشانی اجاره‌داده‌شده را مشخص می‌کند. آرگومان پایانی دلیل شکست را ارائه می‌دهد.
.SS DHCPSRV_QUEUE_NCR_SKIP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: skip queuing name change request for lease: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارگزار تصمیم می‌گیرد درخواست تغییر نام را در صف قرار ندهد، زیرا اجاره (lease) شامل FQDN نیست، به‌روزرسانی مستقیم (forward) و معکوس (reverse) برای این اجاره غیرفعال است یا به‌روزرسانی‌های DNS در پیکربندی غیرفعال شده‌اند. آرگومان نخست شامل اطلاعات شناسایی کلاینت است. آرگومان دوم شامل نشانی اجاره‌داده‌شده است.
.SS DHCPSRV_REQUIRE_CLIENT_CLASSES_DEPRECATED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
The parameter \(aqrequire\-client\-classes\(aq is deprecated. Use \(aqevaluate\-additional\-classes\(aq instead
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که تجزیهٔ پیکربندی، استفاده از پارامتر منسوخ‌شدهٔ \(aqrequire\-client\-classes\(aq را تشخیص دهد. این پارامتر با \(aqevaluate\-additional\-classes\(aq جایگزین شده است. کاربران باید به پارامتر جدید مهاجرت کنند.
.SS DHCPSRV_SUBNET4O6_SELECT_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Failed to select any subnet for the DHCPv4o6 packet
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارگزار نتواند هیچ زیرشبکه‌ای (subnet) را برای بستهٔ DHCPv4o6 انتخاب کند.
.SS DHCPSRV_SUBNET4_SELECT_BY_ADDRESS_NO_MATCH
.INDENT 0.0
.INDENT 3.5
.sp
.EX
No subnet matches address: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارگزار نتواند با استفاده از نشانی مشخص‌شده، زیرشبکه‌ای را انتخاب کند.
.SS DHCPSRV_SUBNET4_SELECT_BY_INTERFACE_NO_MATCH
.INDENT 0.0
.INDENT 3.5
.sp
.EX
No subnet matches interface: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارگزار نتواند با استفاده از نام رابط (interface) مشخص‌شده، زیرشبکه‌ای را انتخاب کند.
.SS DHCPSRV_SUBNET4_SELECT_BY_RELAY_ADDRESS_NO_MATCH
.INDENT 0.0
.INDENT 3.5
.sp
.EX
No subnet matches relay address: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارگزار نتواند با استفاده از نشانی بازپخش (relay address) مشخص‌شده، زیرشبکه‌ای را انتخاب کند.
.SS DHCPSRV_SUBNET4_SELECT_NO_RAI_OPTIONS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
No RAI options found to use for subnet selection.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی توسط کارگزار صادر می‌شود که پرس‌وجوی کلاینت شامل گزینه‌های RAI مناسب برای استفاده در انتخاب زیرشبکه نباشد..SS DHCPSRV_SUBNET4_SELECT_NO_RELAY_ADDRESS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Relay address (giaddr) in client packet is empty.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که هیچ نشانی رله‌ای (relay address) برای استفاده در انتخاب زیرشبکه مشخص نشده باشد.
.SS DHCPSRV_SUBNET4_SELECT_NO_USABLE_ADDRESS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
No subnet selected because no suitable address to use for subnet selection was found.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارگزار نتواند نشانی مناسبی را برای استفاده در انتخاب زیرشبکه بیابد.
.SS DHCPSRV_SUBNET6_SELECT_BY_ADDRESS_NO_MATCH
.INDENT 0.0
.INDENT 3.5
.sp
.EX
No subnet matches address: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارگزار نتواند با استفاده از نشانی مشخص‌شده، زیرشبکه‌ای را انتخاب کند.
.SS DHCPSRV_SUBNET6_SELECT_BY_INTERFACE_ID_NO_MATCH
.INDENT 0.0
.INDENT 3.5
.sp
.EX
No subnet matches interface id: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارگزار نتواند با استفاده از شناسهٔ رابط مشخص‌شده (interface id)، زیرشبکه‌ای را انتخاب کند.
.SS DHCPSRV_SUBNET6_SELECT_BY_INTERFACE_NO_MATCH
.INDENT 0.0
.INDENT 3.5
.sp
.EX
No subnet matches interface: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارگزار نتواند با استفاده از نام رابط مشخص‌شده، زیرشبکه‌ای را انتخاب کند.
.SS DHCPSRV_TEMPLATE_EVAL_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Expression \(aq%2\(aq evaluated to %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که هنگام ارزیابی یک عبارت در یک کلاس کلاینت الگویی (template client class) مشکلی رخ داده است.
توضیحی دربارهٔ مشکل چاپ می‌شود.
.SS DHCPSRV_TEMPLATE_EVAL_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Expression \(aq%2\(aq evaluated to %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که عبارت یک کلاس کلاینت الگویی با موفقیت ارزیابی شده است. نام کلاس کلاینت و مقدار حاصل از این ارزیابی چاپ می‌شوند.
.SS DHCPSRV_TIMERMGR_CALLBACK_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
running handler for timer %1 caused exception: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا هنگامی صادر می‌شود که مهلت تایمر به سر رسیده و عملیات مرتبط با این تایمر موجب پرتاب یک استثنا (exception) شده باشد.
نام تایمر و علت بروز استثنا ثبت می‌شود.
.SS DHCPSRV_TIMERMGR_REGISTER_TIMER
.INDENT 0.0
.INDENT 3.5
.sp
.EX
registering timer: %1, using interval: %2 ms
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که تایمر بازه‌ای (interval timer) جدیدی در Timer Manager ثبت شود. این تایمر یک تابع بازخوانی (callback function) مرتبط خواهد داشت و این تابع بر اساس بازهٔ زمانی مشخص‌شده اجرا می‌شود. نام یکتای تایمر و بازهٔ زمانی اجرای تابع بازخوانی در پیام گنجانده شده است..SS DHCPSRV_TIMERMGR_RUN_TIMER_OPERATION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
running operation for timer: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که Timer Manager در آستانه
اجرای یک عملیات دوره‌ای مرتبط با تایمر مشخص‌شده باشد.
نمونه‌ای از چنین عملیاتی، پاک‌سازی دوره‌ای اجاره‌های (leases)
منقضی‌شده است. نام تایمر در پیام گنجانده شده است.
.SS DHCPSRV_TIMERMGR_START_TIMER
.INDENT 0.0
.INDENT 3.5
.sp
.EX
starting timer: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که تایمر فاصله‌ای (interval timer)
ثبت‌شده در حال راه‌اندازی باشد. در صورت موفقیت‌آمیز بودن این عملیات،
تایمر به صورت دوره‌ای عملیات مرتبط با خود را اجرا خواهد کرد. نام تایمر
راه‌اندازی‌شده در پیام گنجانده شده است.
.SS DHCPSRV_TIMERMGR_STOP_TIMER
.INDENT 0.0
.INDENT 3.5
.sp
.EX
stopping timer: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که تایمر فاصله‌ای ثبت‌شده
در حال متوقف شدن باشد. تایمر همچنان ثبت‌شده باقی می‌ماند و در صورت
لزوم می‌تواند دوباره راه‌اندازی شود. نام تایمر در پیام گنجانده شده است.
.SS DHCPSRV_TIMERMGR_UNREGISTER_ALL_TIMERS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
unregistering all timers
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که تمام تایمرهای فاصله‌ای ثبت‌شده
از Timer Manager لغو ثبت (unregister) شوند.
.SS DHCPSRV_TIMERMGR_UNREGISTER_TIMER
.INDENT 0.0
.INDENT 3.5
.sp
.EX
unregistering timer: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یکی از تایمرهای فاصله‌ای ثبت‌شده
از Timer Manager لغو ثبت شود. نام تایمر در پیام گنجانده شده است.
.SS DHCPSRV_UNKNOWN_DB
.INDENT 0.0
.INDENT 3.5
.sp
.EX
unknown database type: %1
.EE
.UNINDENT
.UNINDENT
.sp
رشته دسترسی به پایگاه‌داده، نوعی از پایگاه‌داده را مشخص کرده است (که در
پیام آمده است) که برای نرم‌افزار ناشناخته است. این یک خطای پیکربندی است.
.SS DHCP
.SS DHCP_ADD_EXTERNAL_SOCKET_ALREADY_EXISTS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Adding an already existing external socket %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار نشان می‌دهد که یک سوکت خارجی اضافه شده است، اما از قبل
وجود دارد؛ یعنی افزودن‌ها و حذف‌ها به طور صحیح متعادل نیستند.
.SS DHCP_ADD_EXTERNAL_SOCKET_BAD_THREAD
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Attempted to register external socket %1 from different thread %2 than main thread %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که نخی (thread) به غیر از نخ اصلی، یک سوکت خارجی را
ثبت کرده است. این یک خطای برنامه‌نویسی است و باید اصلاح شود.
تنها نخ اصلی مجاز به انجام عملیات روی سوکت‌های خارجی است.
توصیف‌کننده فایل (file descriptor) و شناسه نخ‌های مربوطه در پیام گنجانده شده‌اند.
.SS DHCP_DDNS_ADD_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCP_DDNS Request ID %1: Transaction outcome %2
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است که پس از شکست تلاش‌های DHCP_DDNS برای ثبت ورودی‌های
نگاشت DNS صادر می‌شود. دلیل دقیق این شکست باید در مدخل‌های گزارش
(log) پیشین مستند شده باشد..SS DHCP_DDNS_ADD_SUCCEEDED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCP_DDNS Request ID %1: successfully added the DNS mapping addition for this request: %2
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام اطلاعاتی است و زمانی صادر می‌شود که DHCP_DDNS عملیات افزودن نگاشت‌های DNS را ارسال کرده و توسط یک کارساز DNS مناسب دریافت و پذیرفته شده باشد.
.SS DHCP_DDNS_AT_MAX_TRANSACTIONS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
application has %1 queued requests but has reached maximum number of %2 concurrent transactions
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۵۵ ثبت می‌شود.
این یک پیام اشکال‌زدایی است و نشان می‌دهد برنامه دارای درخواست‌های DHCP_DDNS در صف است، اما در حال حاضر به اندازهٔ حداکثر مجازِ تراکنش‌های هم‌روند فعالیت می‌کند.
.SS DHCP_DDNS_CLEARED_FOR_SHUTDOWN
.INDENT 0.0
.INDENT 3.5
.sp
.EX
application has met shutdown criteria for shutdown type: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۰ ثبت می‌شود.
این یک پیام اشکال‌زدایی است و زمانی صادر می‌شود که به برنامه دستور خاموش شدن داده شده و معیارهای لازم برای خروج را احراز کرده باشد.
.SS DHCP_DDNS_CONFIGURE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
configuration %1 received: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این یک پیام اشکال‌زدایی است و زمانی صادر می‌شود که متد پیکربندی (configure) برنامهٔ DHCP\-DDNS فراخوانی شده باشد.
.SS DHCP_DDNS_CONFIGURED_CALLOUT_DROP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
configuration was rejected because a callout set the next step to \(aqdrop\(aq: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد تلاش پیکربندی DHCP\-DDNS ناموفق بوده است؛ زیرا گام بعدیِ فراخوانی (callout) پیکربندی‌شده توسط یک کتابخانهٔ قلاب (hook library) روی \(aqdrop\(aq تنظیم شده بود. پیام خطای ارائه‌شده توسط کتابخانهٔ قلاب نمایش داده می‌شود.
.SS DHCP_DDNS_CONFIG_CHECK_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCP\-DDNS server configuration check failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که بررسی پیکربندی DHCP\-DDNS با شکست مواجه شده است. جزئیات ارائه شده است. ممکن است جزئیات بیشتر در ورودی‌های قبلی گزارش، احتمالاً در سطوح پایین‌تر، در دسترس باشد.
.SS DHCP_DDNS_CONFIG_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCP\-DDNS server configuration failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که تلاش پیکربندی DHCP\-DDNS با شکست مواجه شده است. جزئیات ارائه شده است. ممکن است جزئیات بیشتر در ورودی‌های قبلی گزارش، احتمالاً در سطوح پایین‌تر، در دسترس باشد.
.SS DHCP_DDNS_CONFIG_SYNTAX_WARNING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCP\-DDNS server configuration syntax warning: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار نشان می‌دهد که پیکربندی DHCP\-DDNS دارای یک خطای نحوی جزئی بوده است. خطا نمایش داده شده و تجزیهٔ پیکربندی از سر گرفته شد.
.SS DHCP_DDNS_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
application experienced a fatal error: %1
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام اشکال‌زدایی است و زمانی صادر می‌شود که برنامهٔ DHCP\-DDNS در درون حلقهٔ رویداد (event loop) با یک خطای غیرقابل‌بازیابی مواجه شود.
.SS DHCP_DDNS_FORWARD_ADD_BAD_DNSCLIENT_STATUS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCP_DDNS Request ID %1: received an unknown DNSClient status: %2, while adding a forward address mapping for FQDN %3 to DNS server %4
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی صادر می‌شود که DNSClient در حین افزودن نگاشت آدرس مستقیم (forward address mapping) توسط DHCP_DDNS، وضعیتی ناشناخته را برمی‌گرداند. این درخواست لغو خواهد شد. این موضوع به احتمال زیاد یک مشکل برنامه‌نویسی است و باید گزارش شود..SS DHCP_DDNS_FORWARD_ADD_BUILD_FAILURE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DNS Request ID %1:  update message to add a forward DNS entry could not be constructed for this request: %2, reason: %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطایی است که هنگام بروز خطا در تلاش برای ساخت بستهٔ ارسالی به کارساز به منظور درخواست افزودن نشانی مستقیم صادر می‌شود. دلیل این امر داده‌های نامعتبر موجود در NameChangeRequest است. درخواست لغو خواهد شد. این مشکل به احتمال زیاد ناشی از پیکربندی است.
.SS DHCP_DDNS_FORWARD_ADD_IO_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCP_DDNS Request ID %1: encountered an IO error sending a forward mapping add for FQDN %2 to DNS server %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطایی است که هنگام بروز خطای ارتباطی در حین انجام عملیات افزودن نشانی مستقیم توسط DHCP_DDNS صادر می‌شود. برنامه بسته به شرایط، تلاش مجدد را روی همان کارساز یا کارسازهای دیگر انجام خواهد داد.
.SS DHCP_DDNS_FORWARD_ADD_REJECTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DNS Request ID %1: Server, %2, rejected a DNS update request to add the address mapping for FQDN, %3, with an RCODE: %4
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطایی است و زمانی صادر می‌شود که درخواست به‌روزرسانی توسط کارساز DNS مقصد، به دلیلی که در RCODE مشخص شده است رد شود. مقادیر rcode در RFC 2136 تعریف شده‌اند.
.SS DHCP_DDNS_FORWARD_ADD_RESP_CORRUPT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCP_DDNS Request ID %1: received a corrupt response from the DNS server, %2, while adding forward address mapping for FQDN, %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطایی است و زمانی صادر می‌شود که پاسخ دریافتی توسط DHCP_DDNS در ازای درخواست به‌روزرسانی افزودن نگاشت نشانی مستقیم، مخدوش یا بدریخت (malformed) باشد. برنامه بسته به شرایط، تلاش مجدد را روی همان کارساز یا کارسازهای دیگر انجام خواهد داد.
.SS DHCP_DDNS_FORWARD_ADD_TIMEOUT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCP_DDNS Request ID %1: timed out waiting for a response to forward mapping add for FQDN %2 to DNS server %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطایی است و زمانی صادر می‌شود که در حین انجام عملیات افزودن نشانی مستقیم توسط DHCP_DDNS، پیش از سرآمدن مدت‌زمان dns\-server\-timeout هیچ پاسخی از کارساز DNS دریافت نشود. برنامه بسته به شرایط، تلاش مجدد را روی همان کارساز یا کارسازهای دیگر انجام خواهد داد.
.SS DHCP_DDNS_FORWARD_REMOVE_ADDRS_BAD_DNSCLIENT_STATUS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCP_DDNS Request ID %1: received an unknown DNSClient status: %2, while removing a forward address mapping for FQDN %3 to DNS server %4
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطایی است و زمانی صادر می‌شود که هنگام حذف نگاشت نشانی مستقیم توسط DHCP_DDNS، مؤلفهٔ DNSClient وضعیتی ناشناخته را بازگرداند. درخواست لغو خواهد شد. این موضوع به احتمال زیاد یک ایراد برنامه‌نویسی است و باید گزارش شود.
.SS DHCP_DDNS_FORWARD_REMOVE_ADDRS_BUILD_FAILURE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DNS Request ID %1: update message to remove a forward DNS Address entry could not be constructed for this request: %2, reason: %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطایی است که هنگام بروز خطا در تلاش برای ساخت بستهٔ ارسالی به کارساز به منظور درخواست حذف نشانی مستقیم (A یا AAAA) صادر می‌شود. دلیل این امر داده‌های نامعتبر موجود در NameChangeRequest است. درخواست لغو خواهد شد. این مشکل به احتمال زیاد ناشی از پیکربندی است.
/\fIsar\fP/
.SS DHCP_DDNS_FORWARD_REMOVE_ADDRS_IO_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCP_DDNS Request ID %1: encountered an IO error sending a forward mapping address removal for FQDN %2 to DNS server %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطایی است که هنگام بروز خطای ارتباطی در حین انجام عملیات حذف نشانی مستقیم توسط DHCP_DDNS صادر می‌شود. برنامه بسته به شرایط، تلاش مجدد را روی همان کارساز یا کارسازهای دیگر انجام خواهد داد.
.SS DHCP_DDNS_FORWARD_REMOVE_ADDRS_REJECTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DNS Request ID %1: Server, %2, rejected a DNS update request to remove the forward address mapping for FQDN, %3, with an RCODE: %4
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطایی است و زمانی صادر می‌شود که درخواست به‌روزرسانی توسط کارساز DNS مقصد، به دلیلی که در RCODE مشخص شده است رد شود. مقادیر rcode در RFC 2136 تعریف شده‌اند..SS DHCP_DDNS_FORWARD_REMOVE_ADDRS_RESP_CORRUPT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCP_DDNS Request ID %1: received a corrupt response from the DNS server, %2, while removing forward address mapping for FQDN, %3
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی صادر می‌شود که پاسخ دریافت‌شده توسط DHCP_DDNS برای یک درخواست به‌روزرسانی جهت حذف نگاشت نشانی مستقیم (forward address mapping)، مخدوش یا ناقص (malformed) باشد. برنامه بسته به شرایط، درخواست را مجدداً روی همان سرور یا سایر سرورها امتحان خواهد کرد.
.SS DHCP_DDNS_FORWARD_REMOVE_ADDRS_TIMEOUT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCP_DDNS Request ID %1: timed out waiting for a response to forward mapping address removal for FQDN %2 to DNS server %3
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی صادر می‌شود که هنگام حذف نگاشت نشانی مستقیم توسط DHCP_DDNS، پیش از سرآمدن مهلت زمانی dns\-server\-timeout هیچ پاسخی از سرور DNS دریافت نشود. برنامه بسته به شرایط، درخواست را مجدداً روی همان سرور یا سایر سرورها امتحان خواهد کرد.
.SS DHCP_DDNS_FORWARD_REMOVE_RRS_BAD_DNSCLIENT_STATUS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCP_DDNS Request ID %1: received an unknown DNSClient status: %2, while removing forward RRs for FQDN %3 to DNS server %4
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی صادر می‌شود که DNSClient هنگام حذف رکوردهای منبع مستقیم (forward RRs) توسط DHCP_DDNS، وضعیتی ناشناخته را بازمی‌گرداند. این درخواست لغو خواهد شد. این مورد به احتمال زیاد یک مشکل برنامه‌نویسی است و باید گزارش شود.
.SS DHCP_DDNS_FORWARD_REMOVE_RRS_BUILD_FAILURE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DNS Request ID %1: update message to remove forward DNS RR entries could not be constructed for this request: %2,  reason: %3
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی صادر می‌شود که هنگام تلاش برای ساخت بسته ارسالی به سرور جهت درخواست حذف رکوردهای منبع مستقیم (DHCID RR)، خطایی رخ دهد. این خطا ناشی از داده‌های نامعتبر موجود در NameChangeRequest است. درخواست لغو خواهد شد. این مورد به احتمال زیاد یک مشکل در پیکربندی است.
.SS DHCP_DDNS_FORWARD_REMOVE_RRS_IO_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCP_DDNS Request ID %1: encountered an IO error sending a forward RR removal for FQDN %2 to DNS server %3
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی صادر می‌شود که هنگام حذف رکوردهای منبع مستقیم توسط DHCP_DDNS، یک خطای ارتباطی (I/O) رخ دهد. برنامه درخواست را مجدداً روی همان سرور تکرار خواهد کرد.
.SS DHCP_DDNS_FORWARD_REMOVE_RRS_REJECTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DNS Request ID %1: Server, %2, rejected a DNS update request to remove forward RR entries for FQDN, %3, with an RCODE: %4
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی صادر می‌شود که یک درخواست به‌روزرسانی توسط سرور DNS مقصد، به دلیلی که با RCODE مشخص شده رد شود. مقادیر rcode در RFC 2136 تعریف شده‌اند.
.SS DHCP_DDNS_FORWARD_REMOVE_RRS_RESP_CORRUPT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCP_DDNS Request ID %1: received a corrupt response from the DNS server, %2, while removing forward RRs for FQDN, %3
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی صادر می‌شود که پاسخ دریافت‌شده توسط DHCP_DDNS برای یک درخواست به‌روزرسانی جهت حذف نگاشت رکوردهای منبع مستقیم (forward RRs)، مخدوش یا ناقص (malformed) باشد. برنامه بسته به شرایط، درخواست را مجدداً روی همان سرور یا سایر سرورها امتحان خواهد کرد.
/\fIsar\fP/
.SS DHCP_DDNS_FORWARD_REMOVE_RRS_TIMEOUT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCP_DDNS Request ID %1: timed out waiting for response to forward RR removal for FQDN %2 to DNS server %3
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی صادر می‌شود که هنگام حذف رکوردهای منبع مستقیم توسط DHCP_DDNS، پیش از سرآمدن مهلت زمانی dns\-server\-timeout هیچ پاسخی از سرور DNS دریافت نشود. برنامه بسته به شرایط، درخواست را مجدداً روی همان سرور یا سایر سرورها امتحان خواهد کرد.
.SS DHCP_DDNS_FORWARD_REPLACE_BAD_DNSCLIENT_STATUS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCP_DDNS Request ID %1: received an unknown DNSClient status: %2, while replacing forward address mapping for FQDN %3 to DNS server %4
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی صادر می‌شود که DNSClient هنگام جایگزینی نگاشت نشانی مستقیم توسط DHCP_DDNS، وضعیتی ناشناخته را بازمی‌گرداند. این درخواست لغو خواهد شد. این مورد به احتمال زیاد یک مشکل برنامه‌نویسی است و باید گزارش شود..SS DHCP_DDNS_FORWARD_REPLACE_BUILD_FAILURE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DNS Request ID %1: update message to replace a forward DNS entry could not be constructed from this request: %2, reason: %3
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی صادر می‌شود که هنگام تلاش برای ساخت بسته ارسالی به کارساز جهت درخواست جایگزینی نگاشت مستقیم، خطایی رخ دهد. این مشکل ناشی از داده‌های نامعتبر موجود در NameChangeRequest است. این درخواست متوقف خواهد شد. این خطا به احتمال زیاد یک مشکل در پیکربندی است.
.SS DHCP_DDNS_FORWARD_REPLACE_IO_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCP_DDNS Request ID %1: encountered an IO error sending a forward mapping replace for FQDN %2 to DNS server %3
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی صادر می‌شود که حین انجام عملیات جایگزینی نگاشت مستقیم توسط DHCP_DDNS، یک خطای ارتباطی (I/O) رخ دهد. برنامه با توجه به شرایط، عملیات را مجدداً با همان کارساز یا کارسازهای دیگر امتحان خواهد کرد.
.SS DHCP_DDNS_FORWARD_REPLACE_REJECTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DNS Request ID %1: Server, %2, rejected a DNS update request to replace the address mapping for FQDN, %3, with an RCODE: %4
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی صادر می‌شود که یک به‌روزرسانی توسط کارساز DNS دریافت‌کننده، به دلیلی که در RCODE مشخص شده است، رد شود. مقادیر rcode در RFC 2136 تعریف شده‌اند.
.SS DHCP_DDNS_FORWARD_REPLACE_RESP_CORRUPT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCP_DDNS Request ID %1: received a corrupt response from the DNS server, %2, while replacing forward address mapping for FQDN, %3
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی صادر می‌شود که پاسخ دریافت‌شده توسط DHCP_DDNS در قبال درخواست به‌روزرسانی جایگزینی نگاشت آدرس مستقیم، مخدوش یا ناصحیح (malformed) باشد. برنامه با توجه به شرایط، مجدداً با همان کارساز یا کارسازهای دیگر تلاش خواهد کرد.
.SS DHCP_DDNS_FORWARD_REPLACE_TIMEOUT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCP_DDNS Request ID %1: timed out waiting for a response to forward mapping replace for FQDN %2 to DNS server %3
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی صادر می‌شود که حین اجرای عملیات جایگزینی نگاشت مستقیم توسط DHCP_DDNS، تا پیش از پایان مهلت زمانی dns\-server\-timeout هیچ پاسخی از کارساز DNS دریافت نشود. برنامه با توجه به شرایط، مجدداً با همان کارساز یا کارسازهای دیگر تلاش خواهد کرد.
.SS DHCP_DDNS_FWD_REQUEST_IGNORED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Request ID %1: Forward updates are disabled, the forward portion of request will be ignored: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۵ ثبت می‌شود.
این یک پیام اشکال‌زدایی است و زمانی صادر می‌شود که به‌روزرسانی‌های مستقیم DNS غیرفعال باشند و DHCP_DDNS درخواستی شامل به‌روزرسانی مستقیم DNS دریافت کند. بخش به‌روزرسانی مستقیم انجام نخواهد شد.
.SS DHCP_DDNS_INVALID_NCR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
application received an invalid DNS update request: %1
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است که نشان می‌دهد برنامه درخواستی نامعتبر برای به‌روزرسانی یک مدخل DNS دریافت کرده است. قالب یا محتوای درخواست نادرست است. درخواست نادیده گرفته خواهد شد.
.SS DHCP_DDNS_INVALID_RESPONSE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
received response to DNS Update message is malformed: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این یک پیام اشکال‌زدایی است و زمانی صادر می‌شود که برنامه DHCP\-DDNS هنگام رمزگشایی پاسخ یک پیام DNS Update با خطا مواجه شود. به‌طور معمول، این خطا زمانی رخ می‌دهد که پیام پاسخ بدشکل و ناصحیح (malformed) باشد.
.SS DHCP_DDNS_LISTENING_ON_ALL_INTERFACES
.INDENT 0.0
.INDENT 3.5
.sp
.EX
the DHCP\-DDNS server has been configured to listen on %1. This is an insecure configuration supported for testing purposes only
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام هشدار است و زمانی صادر می‌شود که کارساز DHCP\-DDNS برای گوش دادن به یکی از آدرس‌های \fI0.0.0.0\fP یا \fI::\fP پیکربندی شده باشد. در این حالت ممکن است یک مهاجم با اهداف مخرب بتواند پیام‌های ساختگی NameChangeRequests ارسال کرده و مدخل‌های DNS را تغییر دهد. به همین دلیل، گوش دادن روی تمام رابط‌ها باید تنها هنگام استقرار در کانتینرها یا برای اهداف آزمایشی استفاده شود. نگارش‌های آینده Kea این قابلیت را به‌طور پیش‌فرض غیرفعال خواهند کرد..SS DHCP_DDNS_NCR_FLUSH_IO_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCP\-DDNS Last send before stopping did not complete successfully: %1
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است که نشان می‌دهد کلاینت DHCP\-DDNS قادر به تکمیل آخرین ارسال پیش از خروج از حالت ارسال نبوده است. این یک خطای برنامه‌نویسی است، وقوع آن بسیار نامحتمل است و نباید به توانایی برنامه در پردازش درخواست‌ها آسیبی برساند.
.SS DHCP_DDNS_NCR_LISTEN_CLOSE_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
application encountered an error while closing the listener used to receive NameChangeRequests : %1
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است که نشان می‌دهد برنامه نتوانسته است اتصال شنونده (listener) مورد استفاده برای دریافت NameChangeRequestها را ببندد. بسته شدن اتصال ممکن است در حین بازیابی از خطا یا در طول روند عادی خاموش شدن رخ دهد. در هر دو حالت، بعید است این خطا به توانایی برنامه در پردازش درخواست‌ها آسیبی برساند، اما باید برای بررسی و تحلیل گزارش شود.
.SS DHCP_DDNS_NCR_RECV_NEXT_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
application could not initiate the next read following a request receive.
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است که نشان می‌دهد شنوندهٔ NameChangeRequest پس از دریافت یک درخواست، نتوانسته است خواندن بعدی را آغاز کند. با اینکه ممکن است رخ دهد، اما بسیار نامحتمل است و احتمالاً یک خطای برنامه‌نویسی است. برنامه باید بتواند خودبه‌خود بازیابی شود.
.SS DHCP_DDNS_NCR_SEND_CLOSE_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCP\-DDNS client encountered an error while closing the sender connection used to send NameChangeRequests: %1
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است که نشان می‌دهد کلاینت DHCP\-DDNS نتوانسته است اتصال مورد استفاده برای ارسال NameChangeRequestها را ببندد. بسته شدن ممکن است در حین بازیابی از خطا یا در طول روند عادی خاموش شدن رخ دهد. در هر دو حالت، بعید است این خطا توانایی کلاینت را در ارسال درخواست‌ها مختل کند، اما باید برای بررسی و تحلیل گزارش شود.
.SS DHCP_DDNS_NCR_SEND_NEXT_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCP\-DDNS client could not initiate the next request send following send completion: %1
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است که نشان می‌دهد فرستندهٔ NameChangeRequest پس از تکمیل ارسال درخواست پیشین، نتوانسته است ارسال بعدی را آغاز کند. هرچند رخ دادن آن ممکن است، اما بسیار نامحتمل بوده و احتمالاً یک خطای برنامه‌نویسی است. برنامه باید بتواند خودبه‌خود بازیابی شود.
.SS DHCP_DDNS_NCR_UDP_CLEAR_READY_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
NCR UDP watch socket failed to clear: %1
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است که نشان می‌دهد برنامه پس از تکمیل یک ارسال، نتوانسته است وضعیت آماده (ready status) فرستندهٔ UDP NCR را بازنشانی کند. این یک خطای برنامه‌نویسی است که باید گزارش شود. برنامه ممکن است به عملکرد درست خود ادامه دهد یا ندهد.
.SS DHCP_DDNS_NCR_UDP_RECV_CANCELED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
UDP socket receive was canceled while listening for DNS Update requests
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش‌گیری اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این یک پیام اشکال‌زدایی است که نشان می‌دهد گوش دادن روی یک سوکت UDP برای دریافت درخواست‌های DNS Update لغو شده است. این یک بخش طبیعی از تعلیق عملیات گوش دادن است.
.SS DHCP_DDNS_NCR_UDP_RECV_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
UDP socket receive error while listening for DNS Update requests: %1
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است که نشان می‌دهد در حین گوش دادن روی یک سوکت UDP برای دریافت درخواست‌های DNS Update، یک خطای ورودی/خروجی (I/O) رخ داده است. این امر می‌تواند نشان‌دهندهٔ مشکل در اتصال شبکه یا کمبود منابع سیستم باشد.
.SS DHCP_DDNS_NCR_UDP_SEND_CANCELED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
UDP socket send was canceled while sending a DNS Update request to DHCP_DDNS: %1
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام اطلاع‌رسانی است که نشان می‌دهد ارسال درخواست‌ها از طریق سوکت UDP به DHCP_DDNS متوقف شده است. این یک بخش طبیعی از روند تعلیق عملیات ارسال است..SS DHCP_DDNS_NCR_UDP_SEND_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
UDP socket send error while sending a DNS Update request: %1
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است که نشان می‌دهد هنگام ارسال یک درخواست به‌روزرسانی DNS به DHCP_DDNS از طریق سوکت UDP، یک خطای IO رخ داده است. این موضوع می‌تواند بیانگر وجود مشکلی در اتصال شبکه یا منابع سیستم باشد.
.SS DHCP_DDNS_NOT_ON_LOOPBACK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
the DHCP\-DDNS server has been configured to listen on %1 which is not the local loopback.  This is an insecure configuration supported for testing purposes only
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام هشدار است که هنگام پیکربندی کارساز DHCP\-DDNS برای شنود روی آدرسی به غیر از آدرس loopback (یعنی 127.0.0.1 یا ::1) صادر می‌شود. این احتمال وجود دارد که یک مهاجم مخرب، NameChangeRequestهای جعلی به آن ارسال کرده و مدخل‌های DNS را تغییر دهد. به همین دلیل، آدرس‌هایی غیر از آدرس‌های loopback در IPv4 یا IPv6 فقط باید برای اهداف آزمایشی استفاده شوند. نسخه‌های آیندهٔ Kea برای محافظت در برابر چنین حملاتی، احراز هویت را پیاده‌سازی خواهند کرد.
.SS DHCP_DDNS_NO_ELIGIBLE_JOBS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
although there are queued requests, there are pending transactions for each, Queue count: %1  Transaction count: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) 55 ثبت می‌شود.
این یک پیام اشکال‌زدایی است و زمانی صادر می‌شود که تمام درخواست‌های موجود در صف نشان‌دهندهٔ کلاینت‌هایی باشند که در حال حاضر یک به‌روزرسانی برای آن‌ها در جریان است. این وضعیت ممکن است در طول عملیات عادی رخ دهد، اما باید یک شرایط موقتی باشد.
.SS DHCP_DDNS_NO_FWD_MATCH_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Request ID %1: the configured list of forward DDNS domains does not contain a match for: %2  The request has been discarded.
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است که نشان می‌دهد DHCP_DDNS درخواستی برای به‌روزرسانی اطلاعات مستقیم (forward) در DNS برای FQDN مشخص‌شده دریافت کرده است، اما هیچ دامنهٔ DDNS پیکربندی‌شده‌ای برای آن در پیکربندی DHCP_DDNS وجود ندارد. در این حالت یا باید پیکربندی DHCP_DDNS به‌روزرسانی شود یا منبع خودِ FQDN بررسی گردد.
.SS DHCP_DDNS_NO_MATCH
.INDENT 0.0
.INDENT 3.5
.sp
.EX
No DNS servers match FQDN %1
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام هشدار است و زمانی صادر می‌شود که هیچ دامنه‌ای در پیکربندی با نام دامنهٔ کاملاً مشخص (FQDN) ذکرشده مطابقت نداشته باشد. درخواست به‌روزرسانی DNS برای این FQDN قابل پردازش نیست.
.SS DHCP_DDNS_NO_REV_MATCH_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Request ID %1: the configured list of reverse DDNS domains does not contain a match for: %2  The request has been discarded.
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است که نشان می‌دهد DHCP_DDNS درخواستی برای به‌روزرسانی اطلاعات معکوس (reverse) در DNS برای FQDN مشخص‌شده دریافت کرده است، اما هیچ دامنهٔ DDNS پیکربندی‌شده‌ای برای آن در پیکربندی DHCP_DDNS وجود ندارد. در این حالت یا باید پیکربندی DHCP_DDNS به‌روزرسانی شود یا منبع خودِ FQDN بررسی گردد.
.SS DHCP_DDNS_QUEUE_MGR_QUEUE_FULL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
application request queue has reached maximum number of entries %1
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است که نشان می‌دهد DHCP\-DDNS درخواست‌های به‌روزرسانی DNS را با سرعتی بیشتر از توان پردازش خود دریافت می‌کند. این موضوع ممکن است به این معنا باشد که حداکثر اندازهٔ صف باید افزایش یابد، کلاینت‌های DHCP\-DDNS بیش از حد و با سرعتی بالا درخواست تولید می‌کنند، یا شاید کارسازهای بالادستی DNS با مشکل بار پردازشی مواجه شده‌اند.
.SS DHCP_DDNS_QUEUE_MGR_QUEUE_RECEIVE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Request ID %1: received and queued a request.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) 55 ثبت می‌شود.
این یک پیام اطلاعاتی است که نشان می‌دهد شنوندهٔ NameChangeRequest که توسط DHCP\-DDNS برای دریافت درخواست‌ها استفاده می‌شود، درخواستی دریافت کرده و آن را برای پردازش‌های بعدی در صف قرار داده است.
.SS DHCP_DDNS_QUEUE_MGR_RECONFIGURING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
application is reconfiguring the queue manager
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) 40 ثبت می‌شود.
این یک پیام اطلاعاتی است که نشان می‌دهد DHCP_DDNS در حال پیکربندی مجدد مدیر صف به عنوان بخشی از راه‌اندازی عادی یا در پاسخ به یک پیکربندی جدید است..SS DHCP_DDNS_QUEUE_MGR_RECOVERING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
application is attempting to recover from a queue manager IO error
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام اطلاع‌رسانی است که نشان می‌دهد DHCP_DDNS در تلاش است تا پس از مواجهه با یک خطای IO حین دریافت درخواست‌ها، مدیر صف (queue manager) را مجدداً راه‌اندازی کند.
.SS DHCP_DDNS_QUEUE_MGR_RECV_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
application\(aqs queue manager was notified of a request receive error by its listener.
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است که نشان می‌دهد شنونده‌ی (listener) NameChangeRequest که توسط DHCP\-DDNS برای دریافت درخواست‌ها استفاده می‌شود، با یک خطای IO مواجه شده است. باید پیام‌های گزارش متناظری از لایه‌ی شنونده حاوی جزئیات بیشتر وجود داشته باشد. این امر ممکن است نشان‌دهنده‌ی مشکلی در اتصال شبکه یا منابع سیستم باشد.
.SS DHCP_DDNS_QUEUE_MGR_RESUME_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
application could not restart the queue manager, reason: %1
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است که نشان می‌دهد Queue Manager مربوط به DHCP_DDNS نتوانسته پس از توقف ناشی از پر شدن صف دریافت، مجدداً راه‌اندازی شود. این بدان معناست که برنامه قادر به دریافت درخواست‌ها نیست. این مسئله به احتمال زیاد به دلیل پارامترهای پیکربندی DHCP_DDNS است که به منابعی مانند یک آدرس IP یا پورت اشاره دارند که دیگر در دسترس نیستند. در صورت ارائه‌ی یک پیکربندی جدید، DHCP_DDNS تلاش خواهد کرد مدیر صف را مجدداً راه‌اندازی کند.
.SS DHCP_DDNS_QUEUE_MGR_RESUMING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
application is resuming listening for requests now that the request queue size has reached %1 of a maximum %2 allowed
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام اطلاع‌رسانی است که نشان می‌دهد DHCP_DDNS، که پذیرش درخواست‌های جدید را متوقف کرده بود، اکنون ورودی‌های کافی از صف دریافت را پردازش کرده است تا پذیرش درخواست‌ها را از سر بگیرد.
.SS DHCP_DDNS_QUEUE_MGR_STARTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
application\(aqs queue manager has begun listening for requests.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) 0 ثبت می‌شود.
این یک پیام اشکال‌زدایی است که نشان می‌دهد Queue Manager مربوط به DHCP_DDNS با موفقیت راه‌اندازی شده و اکنون در حال گوش دادن به NameChangeRequests است.
.SS DHCP_DDNS_QUEUE_MGR_START_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
application could not start the queue manager, reason: %1
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است که نشان می‌دهد Queue Manager مربوط به DHCP_DDNS نتوانسته راه‌اندازی شود. این بدان معناست که برنامه قادر به دریافت درخواست‌ها نیست. این مسئله به احتمال زیاد به دلیل پارامترهای پیکربندی DHCP_DDNS است که به منابعی مانند یک آدرس IP یا پورت که در دسترس نیستند اشاره دارند. در صورت ارائه‌ی یک پیکربندی جدید، DHCP_DDNS تلاش خواهد کرد مدیر صف را مجدداً راه‌اندازی کند.
.SS DHCP_DDNS_QUEUE_MGR_STOPPED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
application\(aqs queue manager has stopped listening for requests.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) 40 ثبت می‌شود.
این یک پیام اشکال‌زدایی است که نشان می‌دهد Queue Manager مربوط به DHCP_DDNS گوش دادن به NameChangeRequests را متوقف کرده است. این امر ممکن است به دلیل یک رویداد عادی مانند پیکربندی مجدد یا در نتیجه‌ی یک خطا رخ داده باشد. باید پیش از این پیام، پیام‌های گزارشی وجود داشته باشند که دلیل توقف آن را مشخص کنند.
.SS DHCP_DDNS_QUEUE_MGR_STOPPING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
application is stopping the queue manager for %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) 0 ثبت می‌شود.
این یک پیام اطلاع‌رسانی است که نشان می‌دهد DHCP_DDNS در حال متوقف کردن مدیر صف است؛ چه به منظور پیکربندی مجدد آن و چه به عنوان بخشی از روند خاموش‌سازی برنامه.
.SS DHCP_DDNS_QUEUE_MGR_STOP_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
application encountered an error stopping the queue manager: %1
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است که نشان می‌دهد DHCP_DDNS هنگام تلاش برای متوقف کردن مدیر صف با خطایی مواجه شده است. رخ دادن این خطا یا مختل شدن کارایی برنامه توسط آن بعید است، اما باید جهت بررسی و تحلیل گزارش شود..SS DHCP_DDNS_QUEUE_MGR_UNEXPECTED_HANDLER_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
گرداننده دریافت درخواست مدیر صف برنامه با یک استثنای غیرمنتظره %1 مواجه شد:
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است که نشان می‌دهد یک خطای غیرمنتظره در گرداننده تکمیل دریافت درخواست Queue Manager در DHCP_DDNS رخ داده است. این موضوع به احتمال زیاد یک اشکال برنامه‌نویسی است که باید گزارش شود. برنامه ممکن است خودبه‌خود بازیابی شود.
.SS DHCP_DDNS_QUEUE_MGR_UNEXPECTED_STOP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
دریافت مدیر صف برنامه
.EE
.UNINDENT
.UNINDENT
.sp
به‌طور غیرمنتظره‌ای لغو شد در حالی که وضعیت مدیر صف عبارت است از: %1
این یک پیام خطا است که نشان می‌دهد دریافت درخواست Queue Manager در DHCP_DDNS به‌طور غیرمنتظره‌ای قطع شده است. در حالت عادی، خواندن/دریافت فقط به عنوان بخش معمولی از فرایند متوقف‌سازی مدیر صف قطع می‌شود. این موضوع به احتمال زیاد یک اشکال برنامه‌نویسی است که باید گزارش شود.
.SS DHCP_DDNS_REMOVE_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
شناسه درخواست DHCP_DDNS %1: نتیجه تراکنش: %2
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است که پس از شکست تلاش‌های DHCP_DDNS برای ارسال درخواست‌های حذف مدخل نگاشت DNS صادر می‌شود. دلیل دقیق شکست باید در مدخل‌های قبلی گزارش وقایع مستند شده باشد.
.SS DHCP_DDNS_REMOVE_SUCCEEDED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
شناسه درخواست DHCP_DDNS %1: نگاشت افزوده‌شده DNS برای این درخواست با موفقیت حذف شد: %2
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام اطلاع‌رسانی است که پس از ارسال درخواست‌های حذف نگاشت DNS توسط DHCP_DDNS صادر می‌شود؛ درخواست‌هایی که توسط یک کارساز DNS مناسب دریافت و پذیرفته شده‌اند.
.SS DHCP_DDNS_REQUEST_DROPPED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
شناسه درخواست %1: درخواست شامل هیچ درخواست به‌روزرسانی فعال‌شده‌ای نیست و نادیده گرفته خواهد شد: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۵۵ ثبت می‌شود.
این یک پیام اشکال‌زدایی است و زمانی صادر می‌شود که DHCP_DDNS درخواستی دریافت کند که شامل به‌روزرسانی در جهتی که فعال شده است نباشد. به عبارت دیگر، اگر تنها به‌روزرسانی‌های مستقیم (forward) فعال باشند و درخواستی دریافت شود که فقط به‌روزرسانی‌های معکوس (reverse) را می‌خواهد، درخواست نادیده گرفته (drop) می‌شود.
.SS DHCP_DDNS_REVERSE_REMOVE_BAD_DNSCLIENT_STATUS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
شناسه درخواست DHCP_DDNS %1: وضعیت ناشناخته DNSClient دریافت شد: %2، هنگام حذف نگاشت آدرس معکوس برای FQDN %3 به کارساز DNS %4
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی صادر می‌شود که DNSClient در حین حذف یک نگاشت آدرس معکوس توسط DHCP_DDNS، وضعیتی ناشناخته را بازگرداند. درخواست لغو خواهد شد. این موضوع به احتمال زیاد یک اشکال برنامه‌نویسی است و باید گزارش شود.
.SS DHCP_DDNS_REVERSE_REMOVE_BUILD_FAILURE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
شناسه درخواست DNS %1: پیام به‌روزرسانی برای حذف یک مدخل معکوس DNS از این درخواست ساخته نشد: %2،  دلیل: %3
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی صادر می‌شود که هنگام تلاش برای ساخت بسته ارسالی به کارساز جهت درخواست حذف PTR معکوس، خطایی رخ دهد. این امر به دلیل داده‌های نامعتبر موجود در NameChangeRequest است. درخواست لغو خواهد شد. این مشکل به احتمال زیاد یک مسئله پیکربندی است.
.SS DHCP_DDNS_REVERSE_REMOVE_IO_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
شناسه درخواست DHCP_DDNS %1: هنگام ارسال درخواست حذف نگاشت معکوس برای FQDN %2 به کارساز DNS %3 با یک خطای IO مواجه شد
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی صادر می‌شود که در حین انجام عملیات حذف نگاشت معکوس توسط DHCP_DDNS، یک خطای ارتباطی رخ دهد. برنامه تلاش مجدد را در برابر همان کارساز یا کارسازهای دیگر بر حسب مورد انجام خواهد داد.
.SS DHCP_DDNS_REVERSE_REMOVE_REJECTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
شناسه درخواست DNS %1: کارساز، %2، یک درخواست به‌روزرسانی DNS برای حذف نگاشت معکوس برای FQDN، %3 را با RCODE رد کرد: %4
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی صادر می‌شود که یک به‌روزرسانی توسط کارساز DNS که به آن ارسال شده بود، به دلیلی که توسط RCODE مشخص شده است، رد شود. مقادیر rcode در RFC 2136 تعریف شده‌اند..SS DHCP_DDNS_REVERSE_REMOVE_RESP_CORRUPT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCP_DDNS Request ID %1: received a corrupt response from the DNS server, %2, while removing reverse address mapping for FQDN, %3
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی صادر می‌شود که پاسخ دریافت‌شده توسط DHCP_DDNS برای یک درخواست به‌روزرسانی جهت حذف یک آدرس معکوس، مخدوش یا دارای ساختار نادرست (malformed) باشد.
برنامه با توجه به شرایط، تلاش مجدد را روی همان سرور یا سایر سرورها انجام خواهد داد.
.SS DHCP_DDNS_REVERSE_REMOVE_TIMEOUT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCP_DDNS Request ID %1: timed out waiting for a response to reverse mapping remove for FQDN %2 to DNS server %3
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی صادر می‌شود که هنگام انجام عملیات حذف نگاشت معکوس توسط DHCP_DDNS، پیش از اتمام مهلت زمانی dns\-server\-timeout هیچ پاسخی از سرور DNS دریافت نشود.
برنامه با توجه به شرایط، تلاش مجدد را روی همان سرور یا سایر سرورها انجام خواهد داد.
.SS DHCP_DDNS_REVERSE_REPLACE_BAD_DNSCLIENT_STATUS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCP_DDNS Request ID %1: received an unknown DNSClient status: %2, while replacing reverse address mapping for FQDN %3 to DNS server %4
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی صادر می‌شود که هنگام جایگزینی یک نگاشت آدرس معکوس توسط DHCP_DDNS، مؤلفه DNSClient وضعیتی ناشناخته را بازگرداند.
درخواست لغو خواهد شد.
این مسئله به احتمال زیاد یک اشکال برنامه‌نویسی است و باید گزارش شود.
.SS DHCP_DDNS_REVERSE_REPLACE_BUILD_FAILURE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DNS Request ID %1: update message to replace a reverse DNS entry could not be constructed from this request: %2, reason: %3
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و هنگامی رخ می‌دهد که در تلاش برای ساخت بسته ارسالی به سرور جهت درخواست جایگزینی PTR معکوس، خطایی پیش بیاید.
دلیل این امر، داده‌های نامعتبر موجود در NameChangeRequest است.
درخواست لغو خواهد شد.
این موضوع به احتمال زیاد یک مشکل در پیکربندی است.
.SS DHCP_DDNS_REVERSE_REPLACE_IO_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCP_DDNS Request ID %1: encountered an IO error sending a reverse mapping replacement for FQDN %2 to DNS server %3
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی صادر می‌شود که هنگام جایگزینی یک نگاشت معکوس توسط DHCP_DDNS، خطای ارتباطی (I/O) رخ دهد.
برنامه با توجه به شرایط، تلاش مجدد را روی همان سرور یا سایر سرورها انجام خواهد داد.
.SS DHCP_DDNS_REVERSE_REPLACE_REJECTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DNS Request ID %1: Server, %2, rejected a DNS update request to replace the reverse mapping for FQDN, %3, with an RCODE: %4
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی صادر می‌شود که یک به‌روزرسانی توسط سرور DNS مقصد، به دلیلی که در RCODE مشخص شده است رد شود.
مقادیر rcode در RFC 2136 تعریف شده‌اند.
.SS DHCP_DDNS_REVERSE_REPLACE_RESP_CORRUPT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCP_DDNS Request ID %1: received a corrupt response from the DNS server, %2, while replacing reverse address mapping for FQDN, %3
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی صادر می‌شود که پاسخ دریافت‌شده توسط DHCP_DDNS برای یک درخواست به‌روزرسانی جهت جایگزینی آدرس معکوس، مخدوش یا دارای ساختار نادرست (malformed) باشد.
برنامه با توجه به شرایط، تلاش مجدد را روی همان سرور یا سایر سرورها انجام خواهد داد.
.SS DHCP_DDNS_REVERSE_REPLACE_TIMEOUT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCP_DDNS Request ID %1: timed out waiting for a response to reverse mapping replacement for FQDN %2 to DNS server %3
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی صادر می‌شود که هنگام انجام عملیات جایگزینی نگاشت معکوس توسط DHCP_DDNS، پیش از سررسید مهلت زمانی dns\-server\-timeout هیچ پاسخی از سرور DNS دریافت نشود.
برنامه با توجه به شرایط، تلاش مجدد را روی همان سرور یا سایر سرورها انجام خواهد داد.
.SS DHCP_DDNS_REV_REQUEST_IGNORED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Request ID %1: Reverse updates are disabled, the reverse portion of request will be ignored: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۵۵ ثبت می‌شود.
این یک پیام اشکال‌زدایی است و زمانی صادر می‌شود که به‌روزرسانی‌های معکوس DNS غیرفعال باشند و DHCP_DDNS یک درخواست به‌روزرسانی حاوی به‌روزرسانی معکوس DNS دریافت کند.
به‌روزرسانی معکوس انجام نخواهد شد..SS DHCP_DDNS_RUN_EXIT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
application is exiting the event loop
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) 0 ثبت می‌شود.
این یک پیام اشکال‌زدایی است که هنگام خروج کارساز DHCP\-DDNS از حلقه
رویداد (event loop) خود صادر می‌شود.
.SS DHCP_DDNS_SECURITY_CHECKS_DISABLED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Invoked with command line option \-X, Security checks are disabled!!
.EE
.UNINDENT
.UNINDENT
.sp
این هشدار زمانی صادر می‌شود که بررسی‌های امنیتی داخلی که معمولاً
توسط kea\-dhcp\-ddns انجام می‌شوند، از طریق گزینه خط فرمان \(aq\-X\(aq غیرفعال شده باشند.
این بدان معناست که کارساز محدودیت‌ها روی مسیرهای منابع یا مجوزها را
اعمال نمی‌کند. این حالت عملکرد ممکن است محیط شما را در معرض
آسیب‌پذیری‌های امنیتی قرار دهد و تنها باید پس از بررسی و ملاحظه دقیق
استفاده شود.
.SS DHCP_DDNS_SHUTDOWN_COMMAND
.INDENT 0.0
.INDENT 3.5
.sp
.EX
application received shutdown command with args: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) 0 ثبت می‌شود.
این یک پیام اشکال‌زدایی است که پس از صدور دستور خاموش شدن برنامه توسط
کنترل‌کننده (controller) صادر می‌شود.
.SS DHCP_DDNS_STARTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Kea DHCP\-DDNS server version %1 started
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که کارساز DHCP\-DDNS تمام اطلاعات
پیکربندی را پردازش کرده و آماده آغاز پردازش است.
نسخه برنامه نیز چاپ می‌شود.
.SS DHCP_DDNS_STARTING_TRANSACTION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Request ID %1:
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) 50 ثبت می‌شود.
این یک پیام اشکال‌زدایی است که هنگام آغاز یک تراکنش توسط DHCP\-DDNS برای
یک درخواست مشخص صادر می‌شود.
.SS DHCP_DDNS_STATE_MODEL_UNEXPECTED_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Request ID %1: application encountered an unexpected error while carrying out a NameChangeRequest: %2
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است که هنگام عدم موفقیت برنامه در پردازش صحیح یک
NameChangeRequest صادر می‌شود. بخشی از یا تمام به‌روزرسانی‌های DNS درخواست‌شده به عنوان بخشی
از این به‌روزرسانی با موفقیت انجام نشدند. این یک خطای برنامه‌نویسی است و باید
گزارش شود.
.SS DHCP_DDNS_TRANS_SEND_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Request ID %1: application encountered an unexpected error while attempting to send a DNS update: %2
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی صادر می‌شود که برنامه قادر به ساخت یک پیام
به‌روزرسانی بوده است، اما تلاش برای ارسال آن با خطایی غیرمنتظره مواجه شده است. این مورد
به احتمال زیاد یک خطای برنامه‌نویسی است تا یک مشکل ارتباطی. بخشی از یا تمام
به‌روزرسانی‌های DNS درخواست‌شده به عنوان بخشی از این درخواست موفقیت‌آمیز نبودند.
.SS DHCP_DDNS_TSIG_SECRET_SECURITY_WARNING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
use of clear text TSIG \(aqsecret\(aq is NOT SECURE: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که اعمال امنیت غیرفعال باشد
و در پیکربندی کلید TSIG به جای \(aqsecret\-file\(aq از متن صریح \(aqsecret\(aq
استفاده شده باشد. کارساز همچنان از کلید پیکربندی‌شده استفاده خواهد کرد
اما هشدار می‌دهد که این کار ممکن است خطرات امنیتی در پی داشته باشد.
.SS DHCP_DDNS_UDP_SENDER_WATCH_SOCKET_CLOSE_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
watch socket failed to close: %1
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است که نشان می‌دهد برنامه نتوانسته است
سمت ورودی یا خروجی سوکت نظارتی (watch socket) فرستنده NCR را ببندد. گرچه از نظر فنی
امکان‌پذیر است، اما وقوع این خطا بسیار بعید است و نباید توانایی
برنامه را در پردازش درخواست‌ها مختل کند..SS DHCP_DDNS_UNCAUGHT_NCR_RECV_HANDLER_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
unexpected exception thrown from the application receive completion handler: %1
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است که نشان می‌دهد یک استثنا (exception) رخ داده اما در گردانندهٔ اتمام دریافتِ درخواست برنامه گرفته نشده است. این یک خطای برنامه‌نویسی است که باید گزارش شود. بسته به ماهیت خطا، برنامه ممکن است به عملکرد عادی خود ادامه دهد یا ندهد.
.SS DHCP_DDNS_UNCAUGHT_NCR_SEND_HANDLER_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
unexpected exception thrown from the DHCP\-DDNS client send completion handler: %1
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است که نشان می‌دهد یک استثنا رخ داده اما در گردانندهٔ اتمام ارسال کلاینت DHCP\-DDNS گرفته نشده است. این یک خطای برنامه‌نویسی است که باید گزارش شود. بسته به ماهیت خطا، کلاینت ممکن است به عملکرد عادی خود ادامه دهد یا خیر.
.SS DHCP_DDNS_UPDATE_REQUEST_SENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Request ID %1: %2 to server: %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug log level) ۵۰ ثبت می‌شود.
این یک پیام اشکال‌زدایی است و زمانی صادر می‌شود که DHCP_DDNS یک درخواست DNS را به یک سرور DNS ارسال می‌کند.
.SS DHCP_DDNS_UPDATE_RESPONSE_RECEIVED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Request ID %1: to server: %2 status: %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این یک پیام اشکال‌زدایی است و زمانی صادر می‌شود که DHCP_DDNS یک پاسخ به‌روزرسانی DNS را از یک سرور DNS دریافت می‌کند.
.SS DHCP_DELETE_ALL_EXTERNAL_SOCKETS_BAD_THREAD
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Attempted to unregister external sockets from different thread %1 than main thread %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که ریسه‌ای (thread) غیر از ریسهٔ اصلی تمام سوکت‌های خارجی را حذف کرده است. این یک خطای برنامه‌نویسی است و باید اصلاح شود. تنها ریسهٔ اصلی مجاز به انجام عملیات روی سوکت‌های خارجی است. شناسه‌های ریسه مربوطه در پیام گنجانده شده‌اند.
.SS DHCP_DELETE_EXTERNAL_SOCKET_BAD_THREAD
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Attempted to unregister external socket %1 from different thread %2 than main thread %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که ریسه‌ای غیر از ریسهٔ اصلی یک سوکت خارجی را لغو ثبت کرده است. این یک خطای برنامه‌نویسی است و باید اصلاح شود. تنها ریسهٔ اصلی مجاز به انجام عملیات روی سوکت‌های خارجی است. توصیف‌کنندهٔ فایل (file descriptor) و شناسه‌های ریسه مربوطه در پیام گنجانده شده‌اند.
.SS DHCP_DELETE_EXTERNAL_SOCKET_NOT_FOUND
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Deleting a not found external socket %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار نشان می‌دهد که یک سوکت خارجی حذف شده اما یافت نمی‌شود؛ یعنی افزودن‌ها و حذف‌ها به درستی متوازن نیستند.
.SS DHCP_IFACE_OPEN_SOCKET
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Opened socket on the interface %1 with address %2 and port %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که یک سوکت برای یک رابط (interface) مشخص باز شده است. نام رابط، آدرس و درگاه (port) ثبت می‌شوند.
.SS DHCP_IFACE_SOCKET_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Got an error on the interface socket %1 of interface %2: %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که خطایی روی سوکت رابط رخ داده است. توصیف‌کنندهٔ فایل، نام رابط و پیام خطا نمایش داده می‌شوند.
.SS DHCP_RECEIVE4_UNKNOWN
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Received data over unknown socket
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار نشان می‌دهد که گردانندهٔ رویدادِ توصیف‌کنندهٔ فایل با داده‌های دریافت‌شده بازگشته است، اما امکان تشخیص اینکه مربوط به کدام‌یک بوده وجود نداشته است..SS DHCP_RECEIVE6_UNKNOWN
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Received data over unknown socket
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار نشان می‌دهد که گرداننده رویداد توصیف‌کننده فایل (file descriptor event handler) با داده‌های دریافت‌شده بازمی‌گردد، اما امکان یافتن این‌که کدام‌یک بوده وجود نداشته است.
.SS EVAL
.SS EVAL_DEBUG_AND
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Popping %2 and %3 pushing %4
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که دو مقدار از پشته مقادیر پاپ (pop) می‌شوند. سپس از طریق \(dqand\(dq منطقی با یکدیگر ترکیب شده و نتیجه روی پشته مقادیر پوش (push) می‌شود.
.SS EVAL_DEBUG_BRANCH
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Branching to %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که یک انشعاب بدون شرط به مقصد نمایش‌داده‌شده انجام می‌شود.
.SS EVAL_DEBUG_CONCAT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Popping %2 and %3 pushing %4
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که دو رشته از پشته پاپ می‌شوند. سپس به یکدیگر متصل شده و رشته حاصل روی پشته پوش می‌شود. رشته‌ها در قالب هگزادسیمال نمایش داده می‌شوند.
.SS EVAL_DEBUG_EQUAL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Popping %2 and %3 pushing result %4
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که دو رشته از پشته مقادیر پاپ می‌شوند و نتیجه مقایسه آن‌ها روی پشته مقادیر پوش می‌شود. رشته‌ها در قالب هگزادسیمال نمایش داده می‌شوند.
.SS EVAL_DEBUG_HEXSTRING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Pushing hex string %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که رشته دودویی (binary) داده‌شده روی پشته مقادیر پوش می‌شود. رشته در قالب هگزادسیمال نمایش داده می‌شود.
.SS EVAL_DEBUG_IFELSE_FALSE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Popping %2 (false) and %3, leaving %4
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که شرط نادرست (false) است، بنابراین مقدار شاخه iftrue حذف شده و مقدار شاخه ifelse روی پشته مقادیر باقی می‌ماند.
.SS EVAL_DEBUG_IFELSE_TRUE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Popping %2 (true) and %3, leaving %4
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که شرط درست (true) است، بنابراین مقدار شاخه ifelse حذف شده و مقدار شاخه iftrue روی پشته مقادیر باقی می‌ماند.
.SS EVAL_DEBUG_INT16TOTEXT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Pushing Int16 %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که بازنمایی رشته‌ای آدرس داده‌شده روی پشته مقادیر پوش می‌شود. این مقدار نشان‌دهنده یک عدد صحیح ۱۶ بیتی است..SS EVAL_DEBUG_INT32TOTEXT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Pushing Int32 %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug log level) ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که بازنمایی رشته‌ای نشانی داده‌شده روی
پشتهٔ مقادیر (value stack) قرار داده می‌شود (push). این مقدار بیانگر یک عدد صحیح ۳۲ بیتی است.
.SS EVAL_DEBUG_INT8TOTEXT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Pushing Int8 %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug log level) ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که بازنمایی رشته‌ای نشانی داده‌شده روی
پشتهٔ مقادیر (value stack) قرار داده می‌شود (push). این مقدار بیانگر یک عدد صحیح ۸ بیتی است.
.SS EVAL_DEBUG_IPADDRESS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Pushing IPAddress %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug log level) ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که رشتهٔ باینری داده‌شده روی پشتهٔ مقادیر
قرار داده می‌شود (push). این مقدار بیانگر یک نشانی IPv4 یا IPv6 است.
رشته به صورت هگزادسیمال (hex) نمایش داده می‌شود.
.SS EVAL_DEBUG_IPADDRESSTOTEXT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Pushing IPAddress %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug log level) ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که بازنمایی رشته‌ای نشانی داده‌شده روی
پشتهٔ مقادیر (value stack) قرار داده می‌شود (push). این مقدار بیانگر یک نشانی IPv4 یا IPv6 است.
.SS EVAL_DEBUG_LCASE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Popping string %2 and pushing converted value to lower case %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug log level) ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که بازنمایی رشته‌ای داده‌شده به حروف کوچک
تبدیل شده و روی پشتهٔ مقادیر (value stack) قرار می‌گیرد (push).
.SS EVAL_DEBUG_MATCH
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Matching \(aq%1\(aq on %2, result %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug log level) ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که عبارت باقاعده (regular expression) داده‌شده
با مقدار برداشته‌شده از پشته (popped) مطابقت داده شد. نتیجه روی پشتهٔ مقادیر قرار گرفت (push).
.SS EVAL_DEBUG_MATCH_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Matching \(aq%1\(aq on %2 raised an error: %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که هنگام ارزیابی عبارت باقاعده (regular expression) داده‌شده
در برابر مقدار برداشته‌شده از پشته، خطایی رخ داده است.
.SS EVAL_DEBUG_MEMBER
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Checking membership of \(aq%2\(aq, pushing result %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug log level) ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که عضویت بسته برای کلاس کلاینت
(client class) بررسی شده است.
.SS EVAL_DEBUG_NOT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Popping %2 pushing %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug log level) ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که نخستین مقدار از پشتهٔ مقادیر برداشته می‌شود (pop)،
نقیض شده و سپس روی پشتهٔ مقادیر قرار می‌گیرد (push).
رشته به صورت متنی نمایش داده می‌شود.
.SS EVAL_DEBUG_OPTION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Pushing option %2 with value %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug log level) ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که رشتهٔ داده‌شده که مقدار گزینهٔ درخواستی
را مشخص می‌کند، روی پشتهٔ مقادیر قرار می‌گیرد (push).
بسته به نوع بازنمایی درخواستی (.text یا .hex)، رشته ممکن است متنی یا باینری باشد،
یا چنانچه نوع درخواستی .exists باشد، مقدار \(dqtrue\(dq یا \(dqfalse\(dq خواهد بود.
کد گزینه می‌تواند برای یک گزینه (option) یا یک زیرگزینه (sub\-option) باشد،
همان‌گونه که در عبارت دسته‌بندی درخواست شده است..SS EVAL_DEBUG_OR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Popping %2 and %3 pushing %4
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که دو مقدار از پشتهٔ مقادیر برداشته می‌شوند (pop). سپس از طریق \(dqor\(dq منطقی با هم ترکیب شده و نتیجه بر روی پشتهٔ مقادیر قرار می‌گیرد (push). رشته به صورت متنی نمایش داده می‌شود.
.SS EVAL_DEBUG_PKT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Pushing PKT meta data %2 with value %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که رشته باینری داده‌شده که بیانگر مقدار فرا‌دادهٔ (meta data) درخواستی است، بر روی پشتهٔ مقادیر قرار می‌گیرد. رشته، به استثنای نام رابط (interface)، در مبنای شانزده (hex) نمایش داده می‌شود.
.SS EVAL_DEBUG_PKT4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Pushing PKT4 field %2 with value %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که رشته باینری داده‌شده که بیانگر مقدار فیلد درخواستی است، بر روی پشتهٔ مقادیر قرار می‌گیرد. رشته در مبنای شانزده (hex) نمایش داده می‌شود.
.SS EVAL_DEBUG_PKT6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Pushing PKT6 field %2 with value %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که رشته باینری داده‌شده که بیانگر مقدار فیلد درخواستی است، بر روی پشتهٔ مقادیر قرار می‌گیرد. رشته در مبنای شانزده (hex) نمایش داده می‌شود.
.SS EVAL_DEBUG_POP_AND_BRANCH_FALSE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Value is false: branching to %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که یک انشعاب بر اساس شرط نادرست (false) به مقصد نمایش‌داده‌شده انجام می‌شود.
.SS EVAL_DEBUG_POP_OR_BRANCH_FALSE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Value is false: keeping it and branching to %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که یک انشعاب بر اساس شرط نادرست (false) به مقصد نمایش‌داده‌شده انجام می‌شود.
.SS EVAL_DEBUG_POP_OR_BRANCH_TRUE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Value is true: keeping it and branching to %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که یک انشعاب بر اساس شرط درست (true) به مقصد نمایش‌داده‌شده انجام می‌شود.
.SS EVAL_DEBUG_RELAY6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Pushing PKT6 relay field %2 nest %3 with value %4
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که رشته باینری داده‌شده که بیانگر مقدار فیلد درخواستی است، بر روی پشتهٔ مقادیر قرار می‌گیرد. رشته در مبنای شانزده (hex) نمایش داده می‌شود.
.SS EVAL_DEBUG_RELAY6_RANGE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Pushing PKT6 relay field %2 nest %3 with value %4
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی در صورتی تولید می‌شود که فیلد nest خارج از محدوده باشد. مقداری که بر روی پشته قرار می‌گیرد همواره رشتهٔ خالی خواهد بود..SS EVAL_DEBUG_SPLIT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Popping field %2, delimiters %3, string %4, pushing result %5
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که سه مقدار از پشته برداشته شده
و یک نتیجه روی پشته قرار می‌گیرد. مقادیر برداشته‌شده عبارت‌اند از
فیلد، جداکننده و رشته. نتیجه، فیلد استخراج‌شده است که روی
پشته قرار می‌گیرد. رشته‌ها به‌صورت hex نمایش داده می‌شوند.
.SS EVAL_DEBUG_SPLIT_DELIM_EMPTY
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Popping field %2, delimiters %3, string %4, pushing result %5
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که جداکنندهٔ برداشته‌شده از پشته خالی بوده
و بنابراین نتیجه، کل رشته خواهد بود. فیلد، جداکننده و رشته
همچنان از پشته برداشته شده و نتیجه همچنان روی پشته قرار می‌گیرد.
.SS EVAL_DEBUG_SPLIT_EMPTY
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Popping field %2, delimiters %3, string %4, pushing result %5
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که رشتهٔ برداشته‌شده از پشته خالی بوده
و بنابراین نتیجه نیز خالی خواهد بود. فیلد، جداکننده و رشته همچنان
از پشته برداشته شده و نتیجه همچنان روی پشته قرار می‌گیرد.
.SS EVAL_DEBUG_SPLIT_FIELD_OUT_OF_RANGE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Popping field %2, delimiters %3, string %4, pushing result %5
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که فیلد یا کمتر از یک است یا بزرگ‌تر
از تعداد فیلدهای موجود در رشتهٔ برداشته‌شده از پشته. نتیجه
خالی خواهد بود. فیلد، جداکننده و رشته همچنان از پشته برداشته شده و
نتیجه همچنان روی پشته قرار می‌گیرد.
.SS EVAL_DEBUG_STRING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Pushing text string %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که رشتهٔ متنی ارائه‌شده روی
پشتهٔ مقادیر قرار می‌گیرد. رشته به‌صورت متن نمایش داده می‌شود.
.SS EVAL_DEBUG_SUBSTRING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Popping length %2, start %3, string %4 pushing result %5
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که سه مقدار از
پشتهٔ مقادیر برداشته شده و یک نتیجه روی پشتهٔ مقادیر قرار می‌گیرد. مقادیر
برداشته‌شده، نقطهٔ شروع و طول زیررشته‌ای هستند که باید
از رشتهٔ ارائه‌شده استخراج شود. رشتهٔ حاصل روی
پشته قرار می‌گیرد. رشته‌ها به‌صورت hex نمایش داده می‌شوند.
.SS EVAL_DEBUG_SUBSTRING_EMPTY
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Popping length %2, start %3, string %4 pushing result %5
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که رشتهٔ برداشته‌شده از پشته خالی بوده
و بنابراین نتیجه نیز خالی خواهد بود. نقطهٔ شروع، طول و رشته
همچنان از پشته برداشته شده و نتیجه همچنان روی پشته قرار می‌گیرد.
.SS EVAL_DEBUG_SUBSTRING_RANGE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Popping length %2, start %3, string %4 pushing result %5
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که مقدار start خارج از محدودهٔ
رشته بوده و یک نتیجهٔ خالی روی پشته قرار خواهد گرفت. نقطهٔ شروع،
طول و رشته همچنان از پشته برداشته شده و نتیجه
همچنان روی پشته قرار می‌گیرد. رشته‌ها به‌صورت hex نمایش داده می‌شوند.
.SS EVAL_DEBUG_SUB_OPTION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Pushing option %2 sub\-option %3 with value %4
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اشکال‌زدایی نشان می‌دهد رشتهٔ ارائه‌شده که نشان‌دهندهٔ
مقدار زیرگزینهٔ (sub\-option) درخواستی از گزینهٔ والد مورد نظر است،
روی پشتهٔ مقادیر قرار می‌گیرد. رشته می‌تواند بر اساس نوع بازنمایی
درخواست‌شده (\&.text یا \&.hex) مقدار متنی یا باینری رشته باشد،
یا اگر نوع درخواستی \&.exists باشد، مقدار \(dqtrue\(dq یا \(dqfalse\(dq خواهد بود.
کدها کدهای گزینهٔ والد و زیرگزینه هستند، همان‌گونه که در
عبارت رده‌بندی درخواست شده‌اند..SS EVAL_DEBUG_SUB_OPTION_NO_OPTION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Requested option %2 sub\-option %3, but the parent option is not present, pushing result %4
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اشکال‌زدایی نشان می‌دهد که گزینهٔ والد یافت نشد.
کدها همان کدهای گزینهٔ والد و زیرگزینه (sub\-option) هستند که در عبارت
دسته‌بندی (classification statement) درخواست شده بودند.
.SS EVAL_DEBUG_TOHEXSTRING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Popping binary value %2 and separator %3, pushing result %4
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 55 ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که دو مقدار از پشتهٔ مقادیر برداشته
شده (pop) و نتیجه‌ای در پشتهٔ مقادیر قرار می‌گیرد (push). مقادیر
برداشته‌شده شامل مقدار باینری برای تبدیل و جداکننده هستند.
مقدار باینری به بازنمایی رشته‌ای هگزادسیمال خود تبدیل شده
و در پشته قرار می‌گیرد. مقدار باینری به صورت هگز (hex) نمایش داده می‌شود.
.SS EVAL_DEBUG_UCASE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Popping string %2 and pushing converted value to upper case %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 55 ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که بازنمایی رشته‌ای داده‌شده به
حروف بزرگ تبدیل شده و در پشتهٔ مقادیر قرار می‌گیرد.
.SS EVAL_DEBUG_UINT16TOTEXT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Pushing UInt16 %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 55 ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که بازنمایی رشته‌ای آدرسِ داده‌شده در
پشتهٔ مقادیر قرار می‌گیرد. این مقدار نشان‌دهندهٔ یک عدد صحیح ۱۶ بیتی بدون علامت است.
.SS EVAL_DEBUG_UINT32TOTEXT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Pushing UInt32 %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 55 ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که بازنمایی رشته‌ای آدرسِ داده‌شده در
پشتهٔ مقادیر قرار می‌گیرد. این مقدار نشان‌دهندهٔ یک عدد صحیح ۳۲ بیتی بدون علامت است.
.SS EVAL_DEBUG_UINT8TOTEXT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Pushing UInt8 %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 55 ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که بازنمایی رشته‌ای آدرسِ داده‌شده در
پشتهٔ مقادیر قرار می‌گیرد. این مقدار نشان‌دهندهٔ یک عدد صحیح ۸ بیتی بدون علامت است.
.SS EVAL_DEBUG_VENDOR_CLASS_DATA
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Data %2 (out of %3 received) in vendor class found, pushing result \(aq%4\(aq
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 55 ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که گزینهٔ vendor class پیدا شده، بررسی‌های
enterprise\-id را با موفقیت گذرانده و تعداد تکه‌های داده (data chunks) آن کافی است.
تعداد کل تکه‌ها و مقدار ارائه‌شده، جهت کمک به اشکال‌زدایی گزارش می‌شوند.
.SS EVAL_DEBUG_VENDOR_CLASS_DATA_NOT_FOUND
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Requested data index %2, but option with enterprise\-id %3 has only %4 data tuple(s), pushing result \(aq%5\(aq
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 55 ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که گزینهٔ vendor class پیدا شده و بررسی‌های
enterprise\-id را با موفقیت گذرانده است، اما تعداد تکه‌های دادهٔ آن کافی نیست.
توجه داشته باشید که ایندکس از 0 شروع می‌شود، بنابراین باید حداقل
(index + 1) تکه داده وجود داشته باشد.
.SS EVAL_DEBUG_VENDOR_CLASS_ENTERPRISE_ID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Pushing enterprise\-id %2 as result 0x%3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 55 ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که عبارت ارزیابی شده، گزینهٔ vendor
class یافت شده و enterprise\-id آن در حال گزارش است..SS EVAL_DEBUG_VENDOR_CLASS_ENTERPRISE_ID_MISMATCH
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Was looking for %2, option had %3, pushing result \(aq%4\(aq
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که عبارت ارزیابی شده و گزینه vendor class پیدا شده است، اما enterprise\-id آن با مقدار مشخص‌شده در عبارت متفاوت است.
.SS EVAL_DEBUG_VENDOR_CLASS_EXISTS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Option with enterprise\-id %2 found, pushing result \(aq%3\(aq
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که عبارت ارزیابی شده و گزینه vendor class پیدا شده است.
.SS EVAL_DEBUG_VENDOR_CLASS_NO_OPTION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Option with code %2 missing, pushing result \(aq%3\(aq
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که عبارت ارزیابی شده اما گزینه vendor class یافت نشده است.
.SS EVAL_DEBUG_VENDOR_ENTERPRISE_ID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Pushing enterprise\-id %2 as result 0x%3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که عبارت ارزیابی شده، گزینه vendor پیدا شده و enterprise\-id آن گزارش می‌شود.
.SS EVAL_DEBUG_VENDOR_ENTERPRISE_ID_MISMATCH
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Was looking for %2, option had %3, pushing result \(aq%4\(aq
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که عبارت ارزیابی شده و گزینه vendor پیدا شده است، اما enterprise\-id آن با مقدار مشخص‌شده در عبارت متفاوت است.
.SS EVAL_DEBUG_VENDOR_EXISTS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Option with enterprise\-id %2 found, pushing result \(aq%3\(aq
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که عبارت ارزیابی شده و گزینه vendor پیدا شده است.
.SS EVAL_DEBUG_VENDOR_NO_OPTION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: Option with code %2 missing, pushing result \(aq%3\(aq
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که عبارت ارزیابی شده اما گزینه vendor یافت نشده است.
.SS FLEX
.SS FLEX_ID_EXPRESSION_EVALUATED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Expression evaluated for packet to \(dq%1\(dq (size: %2)
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی هر بار که ارزیابی یک بسته موفقیت‌آمیز باشد چاپ می‌شود.
این بدان معناست که عبارت شناسه تولید شده است. توجه داشته باشید که
بسته به عبارت و محتوای بسته دریافتی، عبارت ممکن است به یک رشته خالی ارزیابی شود.
.SS FLEX_ID_EXPRESSION_EVALUATED_NP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Expression evaluated for packet to 0x%1 (size: %2)
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اشکال‌زدایی هر بار که ارزیابی یک بسته موفقیت‌آمیز باشد چاپ می‌شود.
این بدان معناست که عبارت شناسه تولید شده است. از آنجا که مقدار آن
قابل چاپ نیست، به مبنای شانزده (هگزادسیمال) تبدیل می‌شود..SS FLEX_ID_EXPRESSION_HEX
.INDENT 0.0
.INDENT 3.5
.sp
.EX
عبارت ارزیابی‌شده در قالب هگزادسیمال \(dq%1\(dq
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی، نمایشی هگزادسیمال از عبارت ارزیابی‌شده ارائه می‌دهد.
این مورد برای اهداف اشکال‌زدایی مفید است، چرا که لاگ‌های بعدی از قالب
هگزادسیمال برای ثبت وقایع استفاده می‌کنند.
.SS FLEX_ID_EXPRESSION_INVALID_JSON_TYPE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
عبارت identifier\-expression برابر با %1 است، اما رشته JSON مورد انتظار بود
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا هنگامی چاپ می‌شود که کتابخانه flex\-id در حال بارگذاری است،
اما عبارت استفاده‌شده برای تولید شناسه ناصحیح (بدشکل) است. این عبارت
نوع JSON متفاوتی (برای نمونه یک map) به‌جای رشته مورد انتظار دارد.
.SS FLEX_ID_EXPRESSION_PARSE_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
عبارت identifier\-expression برابر با [%1] است، اما تجزیه آن با خطای %2 شکست می‌خورد
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا هنگامی چاپ می‌شود که کتابخانه flex\-id در حال بارگذاری است،
اما عبارت استفاده‌شده برای تولید شناسه بدشکل است و تجزیه آن با
شکست مواجه شده است.
.SS FLEX_ID_IGNORE_IAID_APPLIED_ON_NA
.INDENT 0.0
.INDENT 3.5
.sp
.EX
گزینه ignore\-iaid مقدار IAID (%1) را برای گزینه IA_NA به 0 تغییر داده است.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام DEBUG هنگامی چاپ می‌شود که کتابخانه flex\-id پرچم ignore\-iaid را
اعمال کرده و مقدار IAID را به 0 تغییر داده است، زیرا بسته دریافتی دقیقاً
شامل یک IA_NA است.
.SS FLEX_ID_IGNORE_IAID_APPLIED_ON_PD
.INDENT 0.0
.INDENT 3.5
.sp
.EX
گزینه ignore\-iaid مقدار IAID (%1) را برای گزینه IA_PD به 0 تغییر داده است.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام DEBUG هنگامی چاپ می‌شود که کتابخانه flex\-id پرچم ignore\-iaid را
اعمال کرده و مقدار IAID را به 0 تغییر داده است، زیرا بسته دریافتی دقیقاً
شامل یک IA_PD است.
.SS FLEX_ID_IGNORE_IAID_ENABLED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
گزینه ignore\-iaid تنظیم شده است. این گزینه فقط بر روی کلاینت‌هایی با حداکثر یک IA_NA و یک IA_PD تأثیر دارد.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار (WARNING) هنگامی چاپ می‌شود که کتابخانه flex\-id در حال بارگذاری
بوده و پارامتر ignore\-iaid تنظیم شده است. این پرچم به سرور امکان می‌دهد
بسته‌هایی را که حاوی بیش از یک IA_NA و یک IA_PD هستند دور بیندازد.
.SS FLEX_ID_IGNORE_IAID_JSON_TYPE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
مقدار ignore\-iaid برابر با %1 است اما مقدار boolean مورد انتظار بود
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا هنگامی چاپ می‌شود که کتابخانه flex\-id در حال بارگذاری است،
اما پارامتر ignore\-iaid بدشکل است، یعنی نوعی متفاوت از نوع مورد انتظار دارد.
انتظار می‌رود مقدار آن یک مقدار boolean باشد.
.SS FLEX_ID_IGNORE_IAID_NOT_APPLIED_ON_NA
.INDENT 0.0
.INDENT 3.5
.sp
.EX
گزینه ignore\-iaid روی بسته اعمال نشد زیرا حاوی بیش از یک IA_NA است.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام هشدار (WARNING) هنگامی چاپ می‌شود که کتابخانه flex\-id پرچم
ignore\-iaid را اعمال نکرده است، زیرا بسته دریافتی حاوی بیش از یک IA_NA است.
.SS FLEX_ID_IGNORE_IAID_NOT_APPLIED_ON_PD
.INDENT 0.0
.INDENT 3.5
.sp
.EX
گزینه ignore\-iaid روی بسته اعمال نشد زیرا حاوی بیش از یک IA_PD است.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام هشدار (WARNING) هنگامی چاپ می‌شود که کتابخانه flex\-id پرچم
ignore\-iaid را اعمال نکرده است، زیرا بسته دریافتی حاوی بیش از یک IA_PD است..SS FLEX_ID_LOAD_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
خطایی هنگام بارگذاری کتابخانه %1 رخ داد
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی چاپ می‌شود که در حین بارگذاری کتابخانه خطایی رخ دهد.
جزئیات مشکل به عنوان پارامتر این پیام چاپ می‌شوند.
.SS FLEX_ID_NO_IDENTIFIER_EXPRESSION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
identifier\-expression یا مشخص نشده یا خالی است
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی 40 ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی چاپ می‌شود که کتابخانه flex\-id در حال بارگذاری است،
اما عبارت مورد استفاده برای تولید شناسه، تعیین‌نشده یا خالی است. کتابخانه
بارگذاری خواهد شد، اما شناسه‌های کلاینت را نه تولید می‌کند و نه جایگزین.
معمولاً این حالت زمانی رخ می‌دهد که کاربران تنها مایل به استفاده از ignore\-iaid هستند
که مستقل از این عبارت عمل می‌کند.
.SS FLEX_ID_REPLACE_CLIENT_ID_JSON_TYPE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
مقدار replace\-client\-id برابر %1 است اما مقدار بولی مورد انتظار بود
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی چاپ می‌شود که کتابخانه flex\-id در حال بارگذاری است،
اما پارامتر replace\-client\-id ساختار نادرستی دارد، یعنی نوع متفاوتی نسبت به آنچه
انتظار می‌رفت دارد. انتظار می‌رود که این پارامتر یک مقدار بولی (boolean) باشد.
.SS FLEX_ID_RESTORE_CLIENT_ID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
بازیابی شناسه کلاینت اصلی \(aq%1\(aq در پاسخ
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی 40 ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که شناسه کلاینت اصلی (ارائه‌شده توسط کلاینت)
در پاسخ سرور بازیابی می‌شود.
.SS FLEX_ID_RESTORE_DUID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
بازیابی DUID اصلی \(dq%1\(dq در پاسخ
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی 40 ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که شناسه کلاینت اصلی (ارائه‌شده توسط کلاینت)
در پاسخ سرور بازیابی می‌شود.
.SS FLEX_ID_UNLOAD
.INDENT 0.0
.INDENT 3.5
.sp
.EX
کتابخانه Flex\-id تخلیه شد.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی بیانگر آن است که کتابخانه flexible\-identifier تخلیه شده است.
.SS FLEX_ID_USED_AS_CLIENT_ID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
استفاده از شناسه منعطف \(dq%1\(dq به عنوان شناسه کلاینت
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی 40 ثبت می‌شود.
این پیام اشکال‌زدایی برای نشان دادن این موضوع صادر می‌شود که کتابخانه در حال حذف شناسه کلاینت
ارائه‌شده توسط کلاینت از پیام دریافتی، و درج شناسه کلاینت مبتنی بر شناسه منعطف به جای آن است.
سرور از این شناسه کلاینت جدید برای پردازش بسته استفاده خواهد کرد. شناسه کلاینت اصلی
در فراخوانی pkt4_send بازیابی شده و برای کلاینت پس فرستاده خواهد شد.
.SS FLEX_ID_USED_AS_DUID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
استفاده از شناسه منعطف \(dq%1\(dq به عنوان DUID
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی 40 ثبت می‌شود.
این پیام اشکال‌زدایی برای نشان دادن این موضوع صادر می‌شود که کتابخانه در حال حذف DUID
ارائه‌شده توسط کلاینت از پیام دریافتی، و درج DUID مبتنی بر شناسه منعطف به جای آن است.
سرور از این DUID جدید برای پردازش بسته استفاده خواهد کرد. DUID اصلی در فراخوانی
pkt6_send بازیابی شده و برای کلاینت پس فرستاده خواهد شد.
.SS FLEX_OPTION_LOAD_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
بارگذاری کتابخانه قلاب‌های Flex Option ناموفق بود: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهنده بروز خطا در حین بارگذاری کتابخانه قلاب‌های Flex Option است.
جزئیات خطا به عنوان آرگومان پیام گزارش ارائه می‌شود..SS FLEX_OPTION_PROCESS_ADD
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Added the option code %1 with value %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی چاپ می‌شود که یک گزینه به بستهٔ پاسخ افزوده شده باشد. کد گزینه و مقدار آن (در صورت قابل چاپ بودن درون گیومه، و در غیر این صورت به صورت هگزادسیمال) ارائه می‌شوند.
.SS FLEX_OPTION_PROCESS_CLIENT_CLASS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Skip processing of the option code %1 for class \(aq%2\(aq
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی چاپ می‌شود که از پردازش یک گزینه صرف‌نظر شده است، چرا که پرس‌وجو به کلاس کلاینت تعلق ندارد. کد گزینه و نام کلاس کلاینت ارائه می‌شوند.
.SS FLEX_OPTION_PROCESS_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
An error occurred processing query %1: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهندهٔ بروز خطا در حین پردازش یک پرس‌وجو توسط کتابخانهٔ قلاب‌های Flex Option است. اطلاعات شناسایی کلاینت از پرس‌وجو و جزئیات خطا به عنوان آرگومان‌های پیام لاگ ارائه می‌شوند.
.SS FLEX_OPTION_PROCESS_REMOVE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Removed option code %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی چاپ می‌شود که یک گزینه از بستهٔ پاسخ حذف شده باشد. کد گزینه ارائه می‌شود.
.SS FLEX_OPTION_PROCESS_SUB_ADD
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Added the sub\-option code %1 in option code %2 with value %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی چاپ می‌شود که یک زیرگزینه به بستهٔ پاسخ افزوده شده باشد. کدهای زیرگزینه و گزینهٔ دربرگیرنده، و مقدار آن (در صورت قابل چاپ بودن درون گیومه، و در غیر این صورت به صورت هگزادسیمال) ارائه می‌شوند.
.SS FLEX_OPTION_PROCESS_SUB_CLIENT_CLASS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Skip processing of the sub\-option code %1 in option code %2 for class \(aq%3\(aq
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی چاپ می‌شود که از پردازش یک زیرگزینه صرف‌نظر شده است، چرا که پرس‌وجو به کلاس کلاینت تعلق ندارد. کدهای زیرگزینه و گزینهٔ دربرگیرنده، و نام کلاس کلاینت ارائه می‌شوند.
.SS FLEX_OPTION_PROCESS_SUB_REMOVE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Removed sub\-option code %1 in option code %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی چاپ می‌شود که یک زیرگزینه از بستهٔ پاسخ حذف شده باشد. کدهای زیرگزینه و گزینهٔ دربرگیرنده ارائه می‌شوند.
.SS FLEX_OPTION_PROCESS_SUB_SUPERSEDE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Supersedes the sub\-option code %1 in option code %2 with value %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی چاپ می‌شود که یک زیرگزینه در بستهٔ پاسخ جایگزین شده باشد. کدهای زیرگزینه و گزینهٔ دربرگیرنده، و مقدار آن (در صورت قابل چاپ بودن درون گیومه، و در غیر این صورت به صورت هگزادسیمال) ارائه می‌شوند.
.SS FLEX_OPTION_PROCESS_SUPERSEDE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Supersedes the option code %1 with value %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی چاپ می‌شود که یک گزینه در بستهٔ پاسخ جایگزین شده باشد. کد گزینه و مقدار آن (در صورت قابل چاپ بودن درون گیومه، و در غیر این صورت به صورت هگزادسیمال) ارائه می‌شوند..SS FLEX_OPTION_PROCESS_VENDOR_ID_MISMATCH
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Skip processing of vendor option code %1 with vendor id %2 not matching wanted %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی چاپ می‌شود که یک زیر\-گزینه از vendor option پردازش می‌شود، اما vendor idها مطابقت ندارند. کد vendor option و هر دو vendor id ارائه شده‌اند.
.SS FLEX_OPTION_UNLOAD
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Flex Option hooks library has been unloaded
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی نشان می‌دهد که کتابخانهٔ قلاب‌های (hooks library) Flex Option از حافظه خارج (unload) شده است.
.SS FUZZ
.SS FUZZ_DATA_READ
.INDENT 0.0
.INDENT 3.5
.sp
.EX
read %1 byte(s) from AFL via stdin
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
پیام اشکال‌زدایی خروجی که مشخص می‌کند چه مقدار داده از طریق stdin از fuzzer دریافت شده است.
.SS FUZZ_INIT_COMPLETE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
fuzz initialization complete: interface %1, address %2, port %3, max loops %4
.EE
.UNINDENT
.UNINDENT
.sp
یک پیام اطلاعاتی خروجی که پس از تکمیل موفقیت‌آمیز تابع مقداردهی اولیهٔ fuzzing صادر می‌شود. پارامترهای فهرست‌شده مواردی هستند که باید/می‌توانند از طریق متغیرهای محیطی تنظیم شوند.
.SS FUZZ_INIT_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
fuzz initialization failure, reason: %1
.EE
.UNINDENT
.UNINDENT
.sp
یک پیام خطا که در صورت شکست مقداردهی اولیهٔ fuzzing گزارش می‌شود. دلیل شکست در پیام آورده شده است.
.SS FUZZ_READ_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
error reading input from fuzzer: %1
.EE
.UNINDENT
.UNINDENT
.sp
این خطا در صورتی گزارش می‌شود که خواندن داده از fuzzer (که از طریق stdin دریافت می‌شود) شکست بخورد، یا خواندن مقدار صفر بایت را بازگرداند. در صورت وقوع این حالت، ریسه (thread) قبل از تلاش مجدد برای خواندن، مدت کوتاهی به خواب می‌رود. این پیام شامل دلیل شکست است.
.SS FUZZ_SEND
.INDENT 0.0
.INDENT 3.5
.sp
.EX
sent %1 byte(s) to the socket connected to the Kea interface
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
یک پیام اشکال‌زدایی حاکی از آنکه فراخوانی sendto() در تابع اصلی fuzzing با موفقیت به پایان رسیده و تعداد بایت‌های ارسال‌شده را گزارش می‌دهد. این فراخوانی داده‌های دریافتی از AFL را به پورتی که Kea روی آن گوش می‌دهد ارسال می‌کند.
.SS FUZZ_SEND_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to send data to Kea input socket: %1
.EE
.UNINDENT
.UNINDENT
.sp
این خطا زمانی گزارش می‌شود که فراخوانی sendto() در ریسهٔ fuzzing (که داده‌های دریافت‌شده از AFL را به سوکتی که Kea روی آن گوش می‌دهد ارسال می‌کند) با شکست مواجه شود. دلیل این شکست در پیام آورده شده است. کد fuzzing تلاش می‌کند از این حالت عبور کرده و ادامه دهد، اما ممکن است باعث شکست کل فرایند fuzzing شود.
.SS FUZZ_SHORT_SEND
.INDENT 0.0
.INDENT 3.5
.sp
.EX
expected to send %1 bytes to Kea input socket but only sent %2
.EE
.UNINDENT
.UNINDENT
.sp
پیام هشداری که اگر فراخوانی sendto() (مورد استفاده برای ارسال داده از ریسهٔ fuzzing به پردازش اصلی Kea) به اندازهٔ داده‌های خوانده‌شده از AFL داده ارسال نکرده باشد، صادر می‌شود. این وضعیت ممکن است نشان‌دهندهٔ مشکلی در ارتباطات زیرین بین ریسهٔ fuzzing و پردازش اصلی Kea باشد..SS FUZZ_SOCKET_CREATE_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to crease socket for use by fuzzing thread: %1
.EE
.UNINDENT
.UNINDENT
.sp
پیام خطایی که هنگام ناتوانی کد fuzzing در ایجاد یک سوکت صادر می‌شود؛ سوکتی که از طریق آن، داده‌های دریافتی روی stdin از فازر AFL به درگاهی که Kea روی آن گوش می‌دهد، کپی می‌شود. در صورت وقوع این خطا، برنامه به احتمال زیاد متوقف (hang) خواهد شد.
.SS GSS
.SS GSS_TSIG_COMMAND_PROCESSED_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
command_processed callout failed: %1.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که callout مربوط به نقطه فراخوانی command_processed شکست خورده باشد. آرگومان حاوی دلیل بروز خطا است.
.SS GSS_TSIG_IGNORED_BAD_DIRECTION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ignored bad direction verify failure.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که اعتبارسنجی به دلیل جهت نادرست پیام با شکست مواجه شده، اما از این شکست صرف‌نظر شده است.
.SS GSS_TSIG_LOAD_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
GSS\-TSIG hooks library failed to load: %1.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که هنگام تلاش برای بارگذاری کتابخانه قلاب‌های (hooks library) مربوط به GSS\-TSIG خطایی رخ داده است. آرگومان جزئیات خطا را شرح می‌دهد.
.SS GSS_TSIG_LOAD_OK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
GSS\-TSIG hooks library loaded successfully.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که کتابخانه قلاب‌های GSS\-TSIG با موفقیت بارگذاری شده است.
.SS GSS_TSIG_MANAGER_STARTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
hooks library GSS\-TSIG key periodic manager started.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که مدیر دوره‌ای کلید GSS\-TSIG آغاز به کار کرده باشد.
.SS GSS_TSIG_MANAGER_STOPPED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
hooks library GSS\-TSIG key periodic manager stopped.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که مدیر دوره‌ای کلید GSS\-TSIG متوقف شده باشد.
.SS GSS_TSIG_MANAGER_STOP_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
manager stop error: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که مدیر دوره‌ای کلید GSS\-TSIG متوقف شده اما خطایی شناسایی شده است. پیام خطای موجود در آرگومان، جزئیات مربوط به مشکل را ارائه می‌دهد.
.SS GSS_TSIG_MANAGER_STOP_GENERAL_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
manager stop general error
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که مدیر دوره‌ای کلید GSS\-TSIG متوقف شده اما یک خطای عمومی شناسایی شده است.
.SS GSS_TSIG_NEW_KEY
.INDENT 0.0
.INDENT 3.5
.sp
.EX
new GSS\-TSIG key \(aq%1\(aq was created.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اطلاع‌رسانی نشان می‌دهد که کتابخانه قلاب‌های GSS\-TSIG یک کلید GSS\-TSIG جدید ایجاد کرده است. نام کلید جدید نمایش داده می‌شود..SS GSS_TSIG_NEW_KEY_SETUP_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
new GSS\-TSIG key \(aq%1\(aq setup failed: %2.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که برپاسازی کلید GSS\-TSIG جدید ناموفق بوده است.
نام کلید جدید و خطا نمایش داده می‌شوند.
.SS GSS_TSIG_NEW_KEY_SETUP_SUCCEED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
new GSS\-TSIG key \(aq%1\(aq setup succeeded.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که برپاسازی کلید جدید GSS\-TSIG
با موفقیت به پایان برسد. نام کلید جدید نمایش داده می‌شود.
.SS GSS_TSIG_OLD_KEY_REMOVED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1 old GSS\-TSIG keys were removed
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که برخی از کلیدهای قدیمی (قدیمی‌تر از ۲ برابر حداکثر
طول عمر TKEY) حذف شده باشند. تعداد کلیدهای حذف‌شده نمایش داده می‌شود.
.SS GSS_TSIG_UNLOAD_OK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
GSS\-TSIG hooks library unloaded successfully.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی نشان می‌دهد که کتابخانه قلاب‌های GSS\-TSIG
با موفقیت از حافظه خارج شده است.
.SS GSS_TSIG_VERIFIED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
GSS\-TSIG verify succeeded.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که اعتبارسنجی GSS\-TSIG با موفقیت انجام شود.
.SS GSS_TSIG_VERIFY_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
GSS\-TSIG verify failed: %1.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی نشان می‌دهد که اعتبارسنجی GSS\-TSIG با شکست مواجه شده است.
آرگومان جزئیات خطا را شرح می‌دهد.
.SS HA
.SS HA_BUFFER4_RECEIVE_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
buffer4_receive callout failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که فراخوانی کال‌اوت برای نقطه قلاب buffer4_receive
شکست خورده باشد. این امر ممکن است در پی یک خطای داخلی کارساز رخ دهد.
آرگومان حاوی دلیل بروز خطا است.
.SS HA_BUFFER4_RECEIVE_NOT_FOR_US
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: dropping query to be processed by another server
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که پرس‌وجوی DHCPv4 دریافتی
توسط این کارساز نادیده گرفته (drop) می‌شود؛ زیرا باید توسط کارساز دیگری پردازش شود.
این حالت زمانی رخ می‌دهد که کارساز دوردست در نتیجه توازن بار یا به دلیل ایفای نقش
به‌عنوان کارساز اصلی در پیکربندی آماده‌به‌کار فعال (hot standby)، برای پردازش بسته تعیین
شده باشد. این آرگومان اطلاعات شناسایی کلاینت را که از پرس‌وجو استخراج شده ارائه می‌دهد.
.SS HA_BUFFER4_RECEIVE_PACKET_OPTIONS_SKIPPED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
an error unpacking an option, caused subsequent options to be skipped: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که باز کردن بسته‌بندی (unpack) یک گزینه با خطا مواجه شده
و در نتیجه باز کردن بسته‌بندی گزینه‌های بعدی در پرس‌وجوی DHCPv4 غیرممکن گردد. کارساز
همچنان برای پاسخگویی به بسته تلاش خواهد کرد. تنها آرگومان موجود دلیل خطای
باز کردن بسته‌بندی را مشخص می‌کند..SS HA_BUFFER4_RECEIVE_UNPACK_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to parse query from %1 to %2, received over interface %3, reason: %4
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که پرس‌وجوی DHCPv4 دریافت‌شده معیوب (malformed) باشد و نتواند توسط کال‌اوت buffer4_receive تجزیه شود. پرس‌وجو توسط سرور نادیده گرفته شده و دور انداخته (drop) خواهد شد. سه آرگومان نخست، آدرس IP مبدأ، آدرس IP مقصد و رابط شبکه را مشخص می‌کنند. آرگومان آخر دلیل شکست را ارائه می‌دهد.
.SS HA_BUFFER6_RECEIVE_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
buffer6_receive callout failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که کال‌اوت برای نقطه قلاب (hook point) مربوط به buffer6_receive با شکست مواجه شده باشد. این اتفاق ممکن است در نتیجه یک خطای داخلی سرور رخ دهد. آرگومان ارائه‌شده شامل دلیل خطا است.
.SS HA_BUFFER6_RECEIVE_NOT_FOR_US
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: dropping query to be processed by another server
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که پرس‌وجوی DHCPv6 دریافت‌شده توسط این سرور دور انداخته می‌شود (drop)، زیرا باید توسط سرور دیگری پاسخ داده شود. این حالت زمانی پیش می‌آید که سرور دوردست در نتیجه توازن بار (load balancing) یا به دلیل اینکه سرور اولیه در پیکربندی hot standby است، برای پردازش بسته تعیین شده باشد. این آرگومان اطلاعات شناسایی کلاینت را که از پرس‌وجو استخراج شده است، ارائه می‌دهد.
.SS HA_BUFFER6_RECEIVE_PACKET_OPTIONS_SKIPPED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
an error unpacking an option, caused subsequent options to be skipped: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که بازگشایی (unpack) یک گزینه (option) با شکست مواجه شده و در نتیجه بازگشایی گزینه‌های باقی‌مانده در پرس‌وجوی DHCPv6 غیرممکن می‌شود. سرور همچنان تلاش خواهد کرد به این بسته سرویس‌دهی کند. تنها آرگومان ارائه‌شده، دلیل خطای بازگشایی را مشخص می‌کند.
.SS HA_BUFFER6_RECEIVE_UNPACK_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to parse query from %1 to %2, received over interface %3, reason: %4
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که پرس‌وجوی DHCPv6 دریافت‌شده معیوب (malformed) باشد و نتواند توسط کال‌اوت buffer6_receive تجزیه شود. این پرس‌وجو توسط سرور دور انداخته خواهد شد. سه آرگومان نخست، آدرس IP مبدأ، آدرس IP مقصد و رابط شبکه را مشخص می‌کنند. آرگومان آخر دلیل شکست را بیان می‌کند.
.SS HA_COMMAND_PROCESSED_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
command_processed callout failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که کال‌اوت برای نقطه قلاب (hook point) مربوط به command_processed با شکست مواجه شود. آرگومان ارائه‌شده شامل دلیل خطا است.
.SS HA_COMMUNICATION_INTERRUPTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: communication with %2 is interrupted
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار توسط سروری صادر می‌شود که متوجه شده است ارتباط با شریک فعال (active partner) برای مدت‌زمانی طولانی‌تر از مقدار پیکربندی‌شده‌ی heartbeat\-delay قطع شده است. در این مرحله، سرور با پایش ترافیک DHCP ارسال‌شده برای شریک و بررسی اینکه آیا سرور شریک به این ترافیک پاسخ می‌دهد یا خیر، روند failover را آغاز می‌کند. اگر مقدار max\-unacked\-clients برابر با 0 تنظیم شده باشد، این تأیید اعتبار غیرفعال است که در این حالت سرور مستقیماً به وضعیت partner\-down منتقل خواهد شد.
.SS HA_COMMUNICATION_INTERRUPTED_CLIENT4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: new client %2 attempting to get a lease from the partner
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی زمانی صادر می‌شود که سرور بازمانده (surviving server) متوجه یک بسته DHCP شود که برای شریکی که ارتباط با آن قطع شده است ارسال گردیده است. کلاینتی که بسته‌اش مشاهده شده است، هنوز به عنوان \(dqunacked\(dq (پاسخ‌داده‌نشده) در نظر گرفته نمی‌شود، زیرا مقدار فیلد secs هنوز از آستانه پیکربندی‌شده مشخص‌شده در max\-ack\-delay فراتر نرفته است..SS HA_COMMUNICATION_INTERRUPTED_CLIENT4_UNACKED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: partner server failed to respond to %2, %3 clients unacked so far, %4 clients left before transitioning to the partner\-down state
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی زمانی صادر می‌شود که کارگزار بازمانده تشخیص دهد
همتای آن در پاسخ به پرس‌وجوی DHCP ناموفق بوده است و این سرویس‌گیرنده
در نظر گرفته می‌شود که توسط همتا سرویس‌دهی نشده است. کارگزار بازمانده
چنین سرویس‌گیرندگانی را شمارش می‌کند و اگر تعداد این سرویس‌گیرندگان از آستانه
max\-unacked\-clients فراتر رود، کارگزار به وضعیت partner\-down منتقل خواهد شد. آرگومان
اول نام رابطه را مشخص می‌کند. آرگومان دوم حاوی اطلاعات شناسایی سرویس‌گیرنده
است. آرگومان سوم تعداد سرویس‌گیرندگانی را مشخص می‌کند که کارگزار در پاسخ به آن‌ها
ناموفق بوده است. آرگومان چهارم تعداد سرویس‌گیرندگان مضاعفی را مشخص می‌کند
که اگر سرویس‌دهی نشوند، باعث انتقال کارگزار به وضعیت partner\-down خواهند شد.
.SS HA_COMMUNICATION_INTERRUPTED_CLIENT6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: new client %2 attempting to get a lease from the partner
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی زمانی صادر می‌شود که کارگزار بازمانده بسته DHCP
ارسال‌شده به همتایی را که ارتباط با آن قطع شده است مشاهده می‌کند.
سرویس‌گیرنده‌ای که بسته آن مشاهده شده است هنوز \(dqunacked\(dq (تأییدنپذیرفته) در نظر
گرفته نمی‌شود زیرا مقدار گزینه elapsed time از آستانه پیکربندی‌شده مشخص‌شده
با max\-ack\-delay فراتر نرفته است. تنها آرگومان، اطلاعات شناسایی سرویس‌گیرنده
را مشخص می‌کند.
.SS HA_COMMUNICATION_INTERRUPTED_CLIENT6_UNACKED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: partner server failed to respond to %2, %3 clients unacked so far, %4 clients left before transitioning to the partner\-down state
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی زمانی صادر می‌شود که کارگزار بازمانده تشخیص دهد
همتای آن در پاسخ به پرس‌وجوی DHCP ناموفق بوده است و این سرویس‌گیرنده
در نظر گرفته می‌شود که توسط همتا سرویس‌دهی نشده است. کارگزار بازمانده
چنین سرویس‌گیرندگانی را شمارش می‌کند و اگر تعداد این سرویس‌گیرندگان از آستانه
max\-unacked\-clients فراتر رود، کارگزار به وضعیت partner\-down منتقل خواهد شد. آرگومان
اول نام رابطه را مشخص می‌کند. آرگومان دوم حاوی اطلاعات شناسایی سرویس‌گیرنده
است. آرگومان سوم تعداد سرویس‌گیرندگانی را مشخص می‌کند که کارگزار در پاسخ به آن‌ها
ناموفق بوده است. آرگومان چهارم تعداد سرویس‌گیرندگان مضاعفی را مشخص می‌کند
که در صورت عدم سرویس‌دهی، باعث انتقال کارگزار به وضعیت partner\-down خواهند شد.
.SS HA_CONFIGURATION_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to configure High Availability hooks library: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که در پیکربندی کتابخانه قلاب‌های HA خطایی رخ دهد.
آرگومان، پیام خطای دقیق را ارائه می‌دهد.
.SS HA_CONFIGURATION_SUCCESSFUL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
HA hook library has been successfully configured
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی زمانی صادر می‌شود که تجزیه‌کننده پیکربندی کتابخانه قلاب‌های HA
پیکربندی جدید را با موفقیت تجزیه و اعتبارسنجی کند.
.SS HA_CONFIG_AUTO_FAILOVER_DISABLED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: auto\-failover disabled
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار برای نشان دادن این موضوع صادر می‌شود که پارامتر \(aqauto\-failover\(aq
توسط مدیر سیستم برای کارگزار مشخص‌شده غیرفعال شده است. با تشخیص خرابی همتا،
کارگزار به‌طور خودکار شروع به سرویس‌دهی به دامنه (scope) همتا نخواهد کرد.
مدیر سیستم باید با ارسال دستور مناسب ha\-scopes این دامنه را به‌صورت دستی فعال کند.
.SS HA_CONFIG_DHCP_MT_DISABLED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: HA multi\-threading has been disabled, it cannot be enabled when Kea global multi\-threading is disabled
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی زمانی صادر می‌شود که پیکربندی HA قابلیت چندریسمانی (multi\-threading)
را فعال کرده باشد در حالی که در پیکربندی سراسری Kea چندریسمانی غیرفعال است.
.SS HA_CONFIG_DHCP_MT_DISABLED_AND_KEA_MT_ENABLED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: HA multi\-threading is disabled while Kea global multi\-threading is enabled which most likely cause performance degradation.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که پیکربندی HA قابلیت چندریسمانی را غیرفعال
کرده باشد در حالی که در پیکربندی سراسری Kea چندریسمانی فعال است.
این وضعیت به احتمال زیاد باعث افت عملکرد خواهد شد..SS HA_CONFIG_LEASE_SYNCING_DISABLED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: lease database synchronization between HA servers is disabled
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که همگام‌سازی پایگاه‌داده اجاره‌ها به‌صورت مدیریتی غیرفعال شده باشد. اگر اجاره‌ها از طریق سازوکار دیگری، برای مثال همانندسازی پایگاه‌داده SQL، بین پایگاه‌های داده اجاره همانندسازی شوند، این یک پیکربندی معتبر است.
.SS HA_CONFIG_LEASE_SYNCING_DISABLED_REMINDER
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: bypassing SYNCING state because lease database synchronization is administratively disabled
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی به عنوان یادآوری صادر می‌شود که همگام‌سازی پایگاه‌داده اجاره‌ها به‌صورت مدیریتی غیرفعال شده است و بنابراین کارگزار مستقیماً از وضعیت \(dqwaiting\(dq به وضعیت \(dqready\(dq تغییر حالت می‌دهد.
.SS HA_CONFIG_LEASE_UPDATES_AND_SYNCING_DIFFER
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: unusual configuration where \(dqsend\-lease\-updates\(dq: %2 and \(dqsync\-leases\(dq: %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که مقادیر پیکربندی پارامترهای send\-lease\-updates و sync\-leases متفاوت باشند. این ممکن است یک پیکربندی معتبر باشد، اما نامعمول است. در حالت عادی، اگر پایگاه‌داده اجاره به همراه همانندسازی استفاده شود، هر دو مقدار روی false تنظیم می‌شوند. اگر پایگاه‌داده اجاره بدون همانندسازی استفاده شود (مانند memfile)، هر دو مقدار روی true تنظیم می‌شوند. تعیین مقادیر متفاوت برای این پارامترها به این معنی است که مدیر سیستم یا می‌خواهد کارگزار هنگام راه‌اندازی، اجاره‌ها را همگام‌سازی نکند اما بعداً به‌روزرسانی‌های اجاره را به کارگزار شریک ارسال نماید، یا اینکه پایگاه‌داده اجاره باید هنگام راه‌اندازی همگام‌سازی شود، اما پس از آن هیچ به‌روزرسانی اجاره‌ای حاصل از تخصیص اجاره‌ها ارسال نشود.
.SS HA_CONFIG_LEASE_UPDATES_DISABLED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: lease updates will not be generated
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که به‌روزرسانی‌های اجاره به‌صورت مدیریتی غیرفعال شده باشند. اگر اجاره‌ها از طریق سازوکار دیگری، برای مثال همانندسازی پایگاه‌داده SQL، به پایگاه‌داده کارگزار شریک همانندسازی شوند، این یک پیکربندی معتبر است.
.SS HA_CONFIG_LEASE_UPDATES_DISABLED_REMINDER
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: lease updates are administratively disabled and will not be generated while in %2 state
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی به عنوان یادآوری صادر می‌شود که به‌روزرسانی‌های اجاره به‌صورت مدیریتی غیرفعال شده‌اند و در وضعیت HA که کارگزار به آن تغییر حالت داده است، ایجاد نخواهند شد. تنها آرگومان مشخص‌کننده وضعیتی است که کارگزار به آن منتقل شده است.
.SS HA_CONFIG_SYSTEM_MT_UNSUPPORTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: HA multi\-threading has been disabled, auto\-detection of thread support reports 0
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی زمانی صادر می‌شود که پیکربندی چندریسمانی (multi\-threading) HA روی تشخیص خودکار برای تعداد ریسمان‌ها تنظیم شده باشد و سیستم تعداد ریسمان‌های هم‌روند را 0 گزارش کند. اگر مطمئن هستید سیستم شما می‌تواند از چند ریسمان پشتیبانی کند، می‌توانید با تعیین مقادیر صریح برای http\-listener\-threads و http\-client\-threads این وضعیت را لغو و بازنویسی (override) کنید.
.SS HA_CONTINUE_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ha\-continue command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که گرداننده دستور ha\-continue هنگام پردازش دستور با شکست مواجه شده است. آرگومان دلیل شکست را مشخص می‌کند.
.SS HA_DEINIT_OK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
unloading High Availability hooks library successful
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی نشان می‌دهد که کتابخانه قلاب‌های (hooks library) دسترس‌پذیری بالا (High Availability) با موفقیت تخلیه شده است.
.SS HA_DHCP4_START_SERVICE_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to start DHCPv4 HA services in dhcp4_srv_configured callout: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که تلاش برای شروع سرویس‌های High Availability برای کارگزار DHCPv4 در فراخوانی dhcp4_srv_configured ناموفق باشد. این یک خطای داخلی کارگزار است و باید یک گزارش باگ ایجاد شود..SS HA_DHCP6_START_SERVICE_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to start DHCPv6 HA services in dhcp6_srv_configured callout: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که تلاش برای راه‌اندازی سرویس‌های دسترسی‌پذیری بالا (HA) برای کارگزار DHCPv6 در فراخوانِ dhcp6_srv_configured با شکست مواجه شود. این یک خطای داخلی کارگزار است و باید یک گزارش باگ برای آن ثبت شود.
.SS HA_DHCP_DISABLE_COMMUNICATIONS_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: failed to send request to disable DHCP service of %2: %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار نشان می‌دهد که هنگام ارسال دستور dhcp\-disable، مشکلی در ارتباط با همتای HA رخ داده است. آرگومان نخست نام کارگزار محلی را مشخص می‌کند. آرگومان دوم نام کارگزار دوردست را ارائه می‌دهد. آرگومان سوم دلیل شکست را بیان می‌کند.
.SS HA_DHCP_DISABLE_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: failed to disable DHCP service of %2: %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار نشان می‌دهد که یک همتا در پاسخ به دستور dhcp\-disable یک کد وضعیت خطا بازگردانده است. آرگومان نخست نام کارگزار محلی را مشخص می‌کند. آرگومان دوم نام کارگزار دوردست را ارائه می‌دهد. آرگومان سوم دلیل شکست را بیان می‌کند.
.SS HA_DHCP_ENABLE_COMMUNICATIONS_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: failed to send request to enable DHCP service of %2: %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار نشان می‌دهد که هنگام ارسال دستور dhcp\-enable، مشکلی در ارتباط با یک همتای HA رخ داده است. آرگومان نخست نام کارگزار محلی را مشخص می‌کند. آرگومان دوم نام کارگزار دوردست را ارائه می‌دهد. آرگومان سوم دلیل شکست را بیان می‌کند.
.SS HA_DHCP_ENABLE_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: failed to enable DHCP service of %2: %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار نشان می‌دهد که یک همتا در پاسخ به دستور dhcp\-enable یک کد وضعیت خطا بازگردانده است. آرگومان نخست نام کارگزار محلی را مشخص می‌کند. آرگومان دوم نام کارگزار دوردست را ارائه می‌دهد. آرگومان سوم دلیل شکست را بیان می‌کند.
.SS HA_HEARTBEAT_COMMUNICATIONS_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: failed to send heartbeat to %2: %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار نشان می‌دهد که هنگام ارسال ضربان قلب (heartbeat) مشکلی در ارتباط با یک همتای HA رخ داده است. این نخستین نشانه از احتمال از کار افتادن همتا است. کارگزار به تلاش برای ارسال ضربان قلب ادامه خواهد داد تا زمانی که ارتباط را قطع‌شده در نظر بگیرد.
.SS HA_HEARTBEAT_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: heartbeat to %2 failed: %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار نشان می‌دهد که یک همتا در پاسخ به یک ضربان قلب (heartbeat) کد وضعیت خطا بازگردانده است. این نشانه‌ای از آن است که همتا ممکن است به درستی کار نکند. کارگزار به تلاش برای ارسال ضربان قلب ادامه خواهد داد تا زمانی که ارتباط را قطع‌شده در نظر بگیرد.
.SS HA_HEARTBEAT_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
heartbeat command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا به این منظور صادر می‌شود که نشان دهد گردانندهٔ دستور heartbeat در حین پردازش دستور با شکست مواجه شده است. آرگومان ارائه شده دلیل شکست را مشخص می‌کند.
.SS HA_HIGH_CLOCK_SKEW
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: %2, please synchronize clocks!
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که انحراف ساعت (clock skew) میان کارگزارهای فعال از ۳۰ ثانیه فراتر رود. سرویس HA به فعالیت خود ادامه می‌دهد اما ممکن است به درستی کار نکند، به‌ویژه برای طول‌عمرهای کوتاه اجاره (lease lifetimes). مدیر سیستم باید ساعت‌ها را همگام‌سازی کند، برای نمونه با استفاده از NTP. اگر انحراف ساعت از ۶۰ ثانیه فراتر رود، سرویس HA خاتمه خواهد یافت..SS HA_HIGH_CLOCK_SKEW_CAUSED_TERMINATION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: %2, causing HA service to terminate
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که انحراف زمانی (clock skew) میان کارگزارهای فعال
از ۶۰ ثانیه فراتر رود. سرویس HA متوقف می‌شود. کارگزارها به پاسخ‌گویی به پرس‌وجوهای
DHCP ادامه خواهند داد، اما به‌روزرسانی‌های اجاره (lease) را تبادل نکرده و ضربان قلب
(heartbeat) ارسال نمی‌کنند. مدیر سیستم ملزم است ساعت‌ها را همگام‌سازی کرده و سپس
کارگزارها را مجدداً راه‌اندازی کند تا سرویس HA از سر گرفته شود.
.SS HA_INIT_OK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
loading High Availability hooks library successful
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی نشان می‌دهد که کتابخانه قلاب‌های (hooks) دسترسی‌پذیری بالا
(High Availability) با موفقیت بارگذاری شده است. لذت ببرید!
.SS HA_INVALID_PARTNER_STATE_COMMUNICATION_RECOVERY
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: partner is in the communication\-recovery state unexpectedly
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که شریک (partner) در وضعیت communication\-recovery
قرار دارد، اما این کارگزار در حالت load balancing اجرا نمی‌شود. کارگزار تنها زمانی
می‌تواند به وضعیت communication\-recovery تغییر وضعیت دهد که در حالت load balancing
اجرا شود. حالت HA هر دو کارگزار باید یکسان باشد.
.SS HA_INVALID_PARTNER_STATE_HOT_STANDBY
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: partner is in the hot\-standby state unexpectedly
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که شریک (partner) در وضعیت hot\-standby قرار دارد،
اما این کارگزار در حالت hot standby اجرا نمی‌شود. کارگزار تنها زمانی می‌تواند
به وضعیت hot\-standby تغییر وضعیت دهد که در حالت hot standby اجرا شود.
حالت HA هر دو کارگزار باید یکسان باشد.
.SS HA_INVALID_PARTNER_STATE_LOAD_BALANCING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: partner is in the load\-balancing state unexpectedly
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که شریک (partner) در وضعیت load\-balancing قرار دارد،
اما این کارگزار در حالت load balancing اجرا نمی‌شود. کارگزار تنها زمانی می‌تواند
به وضعیت load\-balancing تغییر وضعیت دهد که در حالت load balancing اجرا شود.
حالت HA هر دو کارگزار باید یکسان باشد.
.SS HA_LEASE4_EXPIRE_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
lease4_expire callout failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که فراخوان تابع (callout) برای نقطه قلاب
lease4_expire با شکست مواجه شود. این شامل خطاهای غیرمنتظره‌ای مانند ارسال آرگومان‌های
نادرست به تابع فراخوان توسط کارگزار DHCP است (خطای داخلی نامحتمل کارگزار).
آرگومان حاوی دلیل بروز خطا است.
.SS HA_LEASE4_EXPIRE_INVALID_HA_SERVER_NAME
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: invalid ha\-server\-name value for subnet %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که اجاره DHCPv4 بازپس‌گرفته‌شده متعلق به
زیرشبکه‌ای (subnet) باشد که مقدار ha\-server\-name را در user\-context دارد، اما
این مقدار یک رشته متنی نیست یا خالی است. این یک پیکربندی نادرست در کارگزار است.
آرگومان اول حاوی اطلاعات اجاره است. آرگومان دوم پیشوند زیرشبکه (subnet prefix) است.
.SS HA_LEASE4_EXPIRE_RECLAMATION_SKIP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: skipping reclamation of the lease that belongs to a partner
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارگزار در وضعیت خاتمه‌یافته (terminated) قرار دارد
و از بازپس‌گیری اجاره‌ای که احتمالاً توسط کارگزار دیگری تخصیص داده شده، یا در زمان قرار داشتن
کارگزارها در وضعیت خاتمه‌یافته HA توسط کارگزار دیگر نگهداری می‌شود، صرف‌نظر می‌کند.
آرگومان، نشانی اجاره است.
.SS HA_LEASE4_SERVER_DECLINE_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
lease4_server_decline callout failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که فراخوان تابع (callout) برای نقطه قلاب
lease4_server_decline با شکست مواجه شود. این شامل خطاهای غیرمنتظره‌ای مانند ارسال آرگومان‌های
نادرست به تابع فراخوان توسط کارگزار DHCP است (خطای داخلی نامحتمل کارگزار).
آرگومان حاوی دلیل بروز خطا است..SS HA_LEASE6_EXPIRE_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
lease4_expire callout failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که فراخوانی (callout) برای قلاب lease4_expire ناموفق باشد. این شامل خطاهای غیرمنتظره‌ای مانند ارسال آرگومان‌های نادرست توسط کارگزار DHCP به فراخوان (خطای داخلی نامحتمل کارگزار) است.
آرگومان شامل دلیل بروز خطا است.
.SS HA_LEASE6_EXPIRE_INVALID_HA_SERVER_NAME
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: invalid ha\-server\-name value for subnet %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که اجاره‌ی بازپس‌گرفته‌شده‌ی DHCPv6 به زیرشبکه‌ای تعلق داشته باشد که شامل مقدار ha\-server\-name در user\-context است، اما این مقدار یک رشته نبوده یا خالی است. این مورد ناشی از پیکربندی نادرست کارگزار است.
آرگومان نخست حاوی اطلاعات اجاره است. آرگومان دوم پیشوند زیرشبکه است.
.SS HA_LEASE6_EXPIRE_RECLAMATION_SKIP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: skipping reclamation of the lease that belongs to a partner
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارگزار در وضعیت terminated (پایان‌یافته) قرار دارد و از بازپس‌گیری اجاره‌ای که احتمالاً توسط کارگزار دیگری تخصیص داده شده یا در زمان قرار داشتن کارگزارها در وضعیت HA terminated توسط کارگزار دیگر نگهداری می‌شود، صرف‌نظر می‌کند. آرگومان، نشانی اجاره است.
.SS HA_LEASES4_COMMITTED_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
leases4_committed callout failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که فراخوانی (callout) برای قلاب leases4_committed ناموفق باشد. این شامل خطاهای غیرمنتظره‌ای مانند ارسال آرگومان‌های نادرست توسط کارگزار DHCP به فراخوان (خطای داخلی نامحتمل کارگزار) است.
آرگومان شامل دلیل بروز خطا است.
.SS HA_LEASES4_COMMITTED_NOTHING_TO_UPDATE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: leases4_committed callout was invoked without any leases
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که فراخوانی \(dqleases4_committed\(dq بازمی‌گردد زیرا نه اجاره‌ی جدیدی وجود دارد و نه اجاره‌ی حذف‌شده‌ای که لازم باشد به‌روزرسانی‌هایی برای آن‌ها ارسال شود. تنها آرگومان، جزئیات کلاینت ارسال‌کننده‌ی بسته را مشخص می‌کند.
.SS HA_LEASES4_COMMITTED_NO_RELATIONSHIP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: HA relationship not found: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که رابطه‌ی مربوط به نام کارگزار ارائه‌شده توسط فراخوان‌های قبلی، در پیکربندی HA یافت نشود. این خطا بسیار نامحتمل است و بیشتر نشان‌دهنده‌ی یک خطای برنامه‌نویسی است. آرگومان نخست، اطلاعات شناسایی کلاینت است. آرگومان دوم حاوی پیام خطای دقیق‌تری است.
.SS HA_LEASES6_COMMITTED_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
leases6_committed callout failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که فراخوانی (callout) برای قلاب leases6_committed ناموفق باشد. این شامل خطاهای غیرمنتظره‌ای مانند ارسال آرگومان‌های نادرست توسط کارگزار DHCP به فراخوان (خطای داخلی نامحتمل کارگزار) است.
آرگومان شامل دلیل بروز خطا است.
.SS HA_LEASES6_COMMITTED_NOTHING_TO_UPDATE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: leases6_committed callout was invoked without any leases
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که فراخوانی \(dqleases6_committed\(dq بازمی‌گردد زیرا نه اجاره‌ی جدیدی وجود دارد و نه اجاره‌ی حذف‌شده‌ای که لازم باشد به‌روزرسانی‌هایی برای آن‌ها ارسال شود. تنها آرگومان، جزئیات کلاینت ارسال‌کننده‌ی بسته را مشخص می‌کند.
.SS HA_LEASES6_COMMITTED_NO_RELATIONSHIP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: HA relationship not found: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که رابطه‌ی مربوط به نام کارگزار ارائه‌شده توسط فراخوان‌های قبلی، در پیکربندی HA یافت نشود. این خطا بسیار نامحتمل است و بیشتر نشان‌دهنده‌ی یک خطای برنامه‌نویسی است. آرگومان نخست، اطلاعات شناسایی کلاینت است. آرگومان دوم حاوی پیام خطای دقیق‌تری است..SS HA_LEASES_BACKLOG_COMMUNICATIONS_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: failed to communicate with %2 while sending lease updates backlog: %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهنده آن است که هنگام ارسال به‌روزرسانی‌های معوق اجاره‌ها پس از برقراری مجدد ارتباط با سرور همتا، خطای ارتباطی رخ داده است. آرگومان سوم شامل دلیل خطا است.
.SS HA_LEASES_BACKLOG_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: failed to send lease updates backlog to %2: %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهنده آن است که ارسال انباشت به‌روزرسانی‌های اجاره به سرور همتا با شکست مواجه شد. انباشت به‌روزرسانی‌های اجاره پس از برقراری مجدد ارتباطِ موقتاً قطع‌شده با همتا برای آن ارسال می‌شود. در صورت شکست این عملیات، سرور به وضعیت waiting تغییر حالت می‌دهد تا همگام‌سازی کامل پایگاه‌داده اجاره‌ها را آغاز کند.
.SS HA_LEASES_BACKLOG_NOTHING_TO_SEND
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: no leases in backlog after communication recovery
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی زمانی صادر می‌شود که پس از بازیابی ارتباط با همتا، هیچ اجاره معوقی برای ارسال وجود نداشته باشد. این بدان معناست که قطعی ارتباط آن‌قدر کوتاه بوده که هیچ کلاینت DHCP در زمانی که سرور در وضعیت communication\-recovery قرار داشته، اجاره‌ای دریافت نکرده است. اکنون سرور می‌تواند به وضعیت load\-balancing تغییر حالت دهد.
.SS HA_LEASES_BACKLOG_START
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: starting to send %2 outstanding lease updates to %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی زمانی صادر می‌شود که سرور پس از برقراری مجدد ارتباط، شروع به ارسال به‌روزرسانی‌های معوق اجاره‌ها به همتا می‌کند. آرگومان نخست نام سرور محلی را مشخص می‌کند. آرگومان دوم تعداد به‌روزرسانی‌های اجاره برای ارسال را تعیین می‌کند. نام همتا در آرگومان سوم مشخص می‌شود.
.SS HA_LEASES_BACKLOG_SUCCESS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: sending lease updates backlog to %2 successful in %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی زمانی صادر می‌شود که سرور با موفقیت ارسال انباشت به‌روزرسانی‌های اجاره به همتا را به پایان می‌رساند. آرگومان نخست نام سرور محلی را مشخص می‌کند. آرگومان دوم نام سرور دوردست را تعیین می‌کند. آرگومان سوم مدت‌زمان این عملیات را مشخص می‌سازد.
.SS HA_LEASES_SYNC_APPLIED_LEASES
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: applied %2 leases received from the partner in the local lease database
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی، تعداد اجاره‌های دریافت‌شده از سرور همتا طی همگام‌سازی پایگاه‌داده را که در پایگاه‌داده محلی اعمال شده‌اند، نمایش می‌دهد. یک حالت معمول برای شرایطی که تنها برخی از اجاره‌ها اعمال می‌شوند، زمانی است که سرور چندین رابطه (relationship) دارد و بخشی از اجاره‌های دریافت‌شده متعلق به رابطه دیگری هستند. آرگومان نخست نام این سرور را مشخص می‌کند. آرگومان دوم تعداد اجاره‌های اعمال‌شده را تعیین می‌کند.
.SS HA_LEASES_SYNC_COMMUNICATIONS_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: failed to communicate with %2 while syncing leases: %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهنده آن است که هنگام تلاش برای واکشی اجاره‌ها از پایگاه‌داده سرور همتا، خطای ارتباطی با آن سرور رخ داده است. این آرگومان حاوی دلیل بروز خطا است.
.SS HA_LEASES_SYNC_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: failed to synchronize leases with %2: %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهنده آن است که هنگام تجزیه پاسخ دریافتی از سروری که اجاره‌ها برای همگام‌سازی پایگاه‌داده محلی از آن واکشی شده‌اند، مشکلی رخ داده است. آرگومان سوم شامل دلیل خطا است.
.SS HA_LEASES_SYNC_LEASE_PAGE_RECEIVED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: received %2 leases from %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی در حین همگام‌سازی پایگاه‌داده اجاره‌ها صادر می‌شود تا نشان دهد دسته‌ای از اجاره‌ها دریافت شده است. آرگومان نخست نام سرور محلی را مشخص می‌کند. آرگومان دوم حاوی تعداد اجاره‌های دریافت‌شده است. آرگومان سوم نام سرور همتا را مشخص می‌کند..SS HA_LEASE_SYNC_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: synchronization failed for lease: %2, reason: %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که ایجاد یا به‌روزرسانی یک اجاره (lease) در
پایگاه‌داده محلی اجاره‌ها با شکست مواجه شود. اطلاعات اجاره در قالب JSON
به‌عنوان آرگومان اول ارائه می‌شود. آرگومان سوم دلیل این شکست را مشخص می‌کند.
.SS HA_LEASE_SYNC_STALE_LEASE4_SKIP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: skipping stale lease %2 in subnet %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی در طول همگام‌سازی پایگاه‌داده اجاره صادر می‌شود، زمانی که
نمونه اجاره IPv4 واکشی‌شده قدیمی‌تر از نمونه موجود در پایگاه‌داده محلی به نظر
برسد. نمونه جدیدتر در پایگاه‌داده باقی می‌ماند و اجاره واکشی‌شده دور انداخته
می‌شود. سرور راه دور همچنان نمونه اجاره قدیمی‌تر را حفظ خواهد کرد تا زمانی که
پایگاه‌داده خود را با این سرور همگام‌سازی کند. آرگومان اول نام سرور محلی را مشخص
می‌کند. آرگومان دوم آدرس اجاره‌داده‌شده را مشخص می‌کند. آرگومان سوم زیرشبکه‌ای
(subnet) را مشخص می‌کند که اجاره به آن تعلق دارد.
.SS HA_LEASE_SYNC_STALE_LEASE6_SKIP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: skipping stale lease %2 in subnet %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی در طول همگام‌سازی پایگاه‌داده اجاره صادر می‌شود، زمانی که
نمونه اجاره IPv6 واکشی‌شده قدیمی‌تر از نمونه موجود در پایگاه‌داده محلی به نظر
برسد. نمونه جدیدتر در پایگاه‌داده باقی می‌ماند و اجاره واکشی‌شده دور انداخته
می‌شود. سرور راه دور همچنان نمونه اجاره قدیمی‌تر را حفظ خواهد کرد تا زمانی که
پایگاه‌داده خود را با این سرور همگام‌سازی کند. آرگومان اول نام سرور محلی را مشخص
می‌کند. آرگومان دوم آدرس اجاره‌داده‌شده را مشخص می‌کند. آرگومان دوم [سوم] زیرشبکه‌ای
را مشخص می‌کند که اجاره به آن تعلق دارد.
.SS HA_LEASE_UPDATES_DISABLED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: lease updates will not be sent to the partner while in %2 state
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی برای اعلام این موضوع صادر می‌شود که به‌روزرسانی‌های اجاره
در زمانی که سرور در وضعیت فعلی قرار دارد به شریک (partner) ارسال نخواهد شد.
آرگومان دوم نام وضعیت فعلی سرور را مشخص می‌کند. در صورت پیکربندی سرورهای پشتیبان،
به‌روزرسانی‌های اجاره همچنان برای آن‌ها ارسال می‌شود اما از هرگونه خطای احتمالی
در ارتباط با سرورهای پشتیبان صرف‌نظر می‌گردد.
.SS HA_LEASE_UPDATES_ENABLED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: lease updates will be sent to the partner while in %2 state
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی برای اعلام این موضوع صادر می‌شود که به‌روزرسانی‌های اجاره
در زمانی که سرور در وضعیت فعلی قرار دارد به شریک (partner) ارسال خواهد شد.
مورد دوم نام وضعیت فعلی سرور را مشخص می‌کند.
.SS HA_LEASE_UPDATE_COMMUNICATIONS_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: failed to send lease update %2 to %3: %4
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار نشان می‌دهد که در هنگام پردازش درخواست کلاینت DHCP و ارسال
به‌روزرسانی اجاره، مشکلی در برقراری ارتباط با همتای (peer) مربوط به HA رخ داده
است. پیام DHCP کلاینت دور انداخته خواهد شد.
.SS HA_LEASE_UPDATE_CONFLICT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: lease update %2 sent to %3 returned conflict status code: %4
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار نشان می‌دهد که شریک در پاسخ به یک به‌روزرسانی اجاره، کد وضعیت
تعارض بازگردانده است. پیام DHCP کلاینت دور انداخته خواهد شد. اگر سرور برای
ردیابی به‌روزرسانی‌های دارای تعارضِ اجاره پیکربندی شده باشد، در صورت فراتر رفتن
از آستانه تعیین‌شده، ممکن است در نهایت به وضعیت خاتمه‌یافته (terminated) منتقل شود.
.SS HA_LEASE_UPDATE_CREATE_UPDATE_FAILED_ON_PEER
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: failed to create or update the lease having type %2 for address %3, reason: %4
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی زمانی صادر می‌شود که ایجاد یا به‌روزرسانی یکی از اجاره‌ها روی
همتای HA در حین پردازش به‌روزرسانی‌های اجارهٔ ارسال‌شده از این سرور با شکست مواجه
شود. این امر ممکن است نشان‌دهنده مشکلی در ارتباط بین همتا و پایگاه‌داده اجاره آن باشد..SS HA_LEASE_UPDATE_DELETE_FAILED_ON_PEER
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: failed to delete the lease having type %2 for address %3, reason: %4
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی زمانی صادر می‌شود که هنگام پردازش به‌روزرسانی‌های اجارهٔ ارسال‌شده از این سرور، حذف یکی از اجاره‌ها روی همتای HA با شکست مواجه شود. معمولاً حذف اجاره زمانی با شکست مواجه می‌شود که در پایگاه دادهٔ همتا وجود نداشته باشد.
.SS HA_LEASE_UPDATE_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: lease update %2 sent to %3 failed: %4
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار نشان می‌دهد که یک همتا در پاسخ به به‌روزرسانی اجاره، کد وضعیت خطا بازگردانده است. پیام DHCP کلاینت نادیده گرفته خواهد شد.
.SS HA_LEASE_UPDATE_REJECTS_CAUSED_TERMINATION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: too many rejected lease updates cause the HA service to terminate
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که سرویس HA خاتمه یابد، زیرا تعداد به‌روزرسانی‌های اجاره‌ای که کد وضعیت تداخل (conflict) برای آن‌ها از سوی شریک بازگردانده شده است، از حد تعیین‌شده با پارامتر پیکربندی max\-rejected\-lease\-updates فراتر رفته است.
.SS HA_LOAD_BALANCING_DUID_MISSING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: load balancing failed for the DHCPv6 message (transaction id: %2) because DUID is missing
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کتابخانه هوک (hook library) HA نتواند بار یک پرس‌وجوی ورودی DHCPv6 را متعادل‌سازی کند، زیرا نه شناسه کلاینت و نه نشانی سخت‌افزاری (HW address) در پرس‌وجو گنجانده نشده است. پرس‌وجو نادیده گرفته خواهد شد. تنها آرگومان شامل شناسه تراکنش (transaction id) است.
.SS HA_LOAD_BALANCING_IDENTIFIER_MISSING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: load balancing failed for the DHCPv4 message (transaction id: %2) because HW address and client identifier are missing
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کتابخانه هوک HA نتواند بار یک پرس‌وجوی ورودی DHCPv4 را متعادل‌سازی کند، زیرا نه شناسه کلاینت و نه نشانی سخت‌افزاری در پرس‌وجو گنجانده نشده است. پرس‌وجو نادیده گرفته خواهد شد. تنها آرگومان شامل شناسه تراکنش است.
.SS HA_LOAD_BALANCING_LEASE_DUID_MISSING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: load balancing failed for the DHCPv6 lease %2 because DUID is missing
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کتابخانه هوک HA نتواند بار یک اجارهٔ بازپس‌گرفته‌شدهٔ DHCPv6 را متعادل‌سازی کند، زیرا شناسه کلاینت در اجاره یافت نشده است.
.SS HA_LOAD_BALANCING_LEASE_IDENTIFIER_MISSING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: load balancing failed for the DHCPv4 lease %2 because HW address and client identifier are missing
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کتابخانه هوک HA نتواند بار یک اجارهٔ بازپس‌گرفته‌شدهٔ DHCPv4 را متعادل‌سازی کند، زیرا نه شناسه کلاینت و نه نشانی سخت‌افزاری در پرس‌وجو گنجانده نشده است.
.SS HA_LOCAL_DHCP_DISABLE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
local DHCP service is disabled while the %1 is in the %2 state
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی صادر می‌شود تا نشان دهد سرویس محلی DHCP غیرفعال است، زیرا سرور در وضعیتی قرار دارد که نباید به کلاینت‌های DHCP پاسخ دهد؛ برای نمونه، سرور هنوز پایگاه دادهٔ اجاره‌های خود را همگام‌سازی نکرده است. آرگومان نخست نام سرور و آرگومان دوم وضعیت سرور را مشخص می‌کند.
.SS HA_LOCAL_DHCP_ENABLE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
local DHCP service is enabled while the %1 is in the %2 state
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی صادر می‌شود تا نشان دهد سرویس محلی DHCP فعال است، زیرا سرور در وضعیتی قرار دارد که باید به کلاینت‌های DHCP پاسخ دهد. آرگومان نخست نام سرور و آرگومان دوم وضعیت سرور را مشخص می‌کند..SS HA_MAINTENANCE_CANCEL_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ha\-maintenance\-cancel command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهنده آن است که گرداننده (handler) دستور ha\-maintenance\-cancel هنگام پردازش دستور با شکست مواجه شده است. این آرگومان، دلیل شکست را ارائه می‌دهد.
.SS HA_MAINTENANCE_NOTIFY_CANCEL_COMMUNICATIONS_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: failed to send ha\-maintenance\-notify to %2 in attempt to cancel its maintenance: %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار نشان می‌دهد که هنگام ارسال دستور ha\-maintenance\-notify با پرچم cancel تنظیم‌شده روی true، مشکلی در برقراری ارتباط با همتای HA وجود داشته است. آرگومان نخست، نام کارگزار محلی را مشخص می‌کند. آرگومان دوم، نام کارگزار دوردست را مشخص می‌سازد. آرگومان سوم، دلیلی برای شکست رخ‌داده ارائه می‌دهد.
.SS HA_MAINTENANCE_NOTIFY_CANCEL_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: error returned while processing ha\-maintenance\-notify by %2 in attempt to cancel its maintenance: %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار نشان می‌دهد که یک همتا در پاسخ به دستور ha\-maintenance\-notify با پرچم cancel تنظیم‌شده روی true، کد وضعیت خطا برگردانده است. آرگومان نخست، نام کارگزار محلی را مشخص می‌کند. آرگومان دوم، نام کارگزار دوردست را ارائه می‌دهد. آرگومان سوم، دلیلی برای این شکست ارائه می‌کند.
.SS HA_MAINTENANCE_NOTIFY_COMMUNICATIONS_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: failed to send ha\-maintenance\-notify to %2: %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار نشان می‌دهد که هنگام ارسال دستور ha\-maintenance\-notify، مشکلی در برقراری ارتباط با یک همتای HA رخ داده است. آرگومان نخست، نام کارگزار محلی را ارائه می‌دهد. آرگومان دوم، نام کارگزار دوردست را مشخص می‌کند. آرگومان سوم، دلیل شکست را ارائه می‌دهد.
.SS HA_MAINTENANCE_NOTIFY_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: error returned while processing ha\-maintenance\-notify by %2: %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار نشان می‌دهد که یک همتا در پاسخ به دستور ha\-maintenance\-notify، یک کد وضعیت خطا برگردانده است. آرگومان نخست، نام کارگزار دوردست را ارائه می‌دهد. آرگومان دوم، دلیلی برای این شکست ارائه می‌کند.
.SS HA_MAINTENANCE_NOTIFY_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ha\-maintenance\-notify command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهنده آن است که گرداننده دستور ha\-maintenance\-notify هنگام پردازش دستور با شکست مواجه شده است. این آرگومان، دلیل شکست را ارائه می‌دهد.
.SS HA_MAINTENANCE_SHUTDOWN_SAFE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: the server can now be shutdown for maintenance as the partner has taken over the DHCP traffic
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی پس از انتقال کارگزار به وضعیت in\-maintenance نمایش داده می‌شود. این کارگزار دیگر به هیچ‌یک از پرس‌وجوهای DHCP پاسخ نمی‌دهد و شریک آن \- در وضعیت partner\-in\-maintenance \- ترافیک DHCP را بر عهده گرفته است. هنگامی که کارگزارِ در وضعیت in\-maintenance خاموش شود، شریک بلافاصله به وضعیت partner\-down منتقل می‌شود.
.SS HA_MAINTENANCE_STARTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: the server is now in the partner\-in\-maintenance state and the partner is in\-maintenance state
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی زمانی نمایش داده می‌شود که کارگزار دریافت‌کننده دستور ha\-maintenance\-start به وضعیت partner\-in\-maintenance منتقل شود. کارگزار این کار را پس از ارسال ha\-maintenance\-notify به شریک خود برای قرار دادن آن در وضعیت in\-maintenance انجام می‌دهد. از این لحظه به بعد، کارگزار موجود در وضعیت partner\-in\-maintenance به تمام پرس‌وجوها پاسخ خواهد داد و شریک به هیچ پرس‌وجویی پاسخ نمی‌دهد. شریک می‌تواند با اطمینان برای عملیات نگهداری خاموش شود که در این صورت، این کارگزار به‌طور خودکار از وضعیت partner\-in\-maintenance به وضعیت partner\-down منتقل خواهد شد.
.SS HA_MAINTENANCE_STARTED_IN_PARTNER_DOWN
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: the server is now in the partner\-down mode as a result of requested maintenance
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی هنگامی نمایش داده می‌شود که کارگزار دریافت‌کننده دستور ha\-maintenance\-start، به دلیل ناتوانی در برقراری ارتباط با شریک در زمان دریافت دستور، به وضعیت partner\-down منتقل شود. فرض بر این است که در چنین شرایطی شریک از پیش برای نگهداری آفلاین شده است. توجه داشته باشید که در این حالت، روال عادی جایگزینی در خرابی (failover) انجام نمی‌شود. کارگزار منتظر چندین بار عدم پاسخ بررسی زنده بودن (heartbeat) نمی‌ماند و ترافیک DHCP را برای پرس‌وجوهای بدون پاسخ پایش نمی‌کند. در حالت نگهداری، کارگزار به محض رویارویی با نخستین مشکل ارتباطی با شریک، به وضعیت partner\-down منتقل می‌شود..SS HA_MAINTENANCE_START_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ha\-maintenance\-start command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که گرداننده دستور ha\-maintenance\-start هنگام پردازش دستور با شکست مواجه شده است. آرگومان، دلیل شکست را مشخص می‌کند.
.SS HA_MISSING_CONFIGURATION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
high\-availability parameter not specified for High Availability hooks library
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که پیکربندی کتابخانه قلاب‌های High Availability مشخص نشده است. پارامتر \(aqhigh\-availability\(aq باید مشخص شود تا کتابخانه قلاب‌ها به درستی بارگذاری گردد.
.SS HA_PAUSE_CLIENT_LISTENER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: pausing multi\-threaded HTTP processing failed: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا هنگام تلاش برای متوقف کردن موقت ریسمان‌های کلاینت و شنونده‌ی HTTP مربوط به HA صادر می‌شود. رخ دادن این خطا بسیار بعید است و نشان‌دهنده یک مشکل برنامه‌نویسی است که باید به عنوان نقص گزارش شود. نام سرور و علت خطا چاپ می‌شوند.
.SS HA_PAUSE_CLIENT_LISTENER_ILLEGAL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: pausing multi\-threaded HTTP processing failed: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا هنگام تلاش برای متوقف کردن موقت استخرهای ریسمان کلاینت یا شنونده‌ی HTTP مربوط به HA از طریق یک ریسمان کارگر صادر می‌شود. این خطا نشان می‌دهد دستوری که روی ریسمان‌های شنونده اجرا می‌شود، در حال تلاش برای استفاده از یک بخش بحرانی است که منجر به بن‌بست (dead\-lock) خواهد شد.
.SS HA_RESET_COMMUNICATIONS_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: failed to send ha\-reset command to %2: %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار نشان‌دهنده مشکلی در برقراری ارتباط با یک همتای HA هنگام ارسال دستور ha\-reset است. آرگومان نخست، نام سرور محلی را مشخص می‌کند. آرگومان دوم، نام سرور راه دور را مشخص می‌کند. آرگومان سوم، دلیل شکست را مشخص می‌کند.
.SS HA_RESET_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: failed to reset HA state machine of %2: %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار نشان می‌دهد که یک همتا در پاسخ به دستور ha\-reset یک کد وضعیت خطا بازگردانده است. آرگومان نخست، نام سرور محلی را مشخص می‌کند. آرگومان دوم، نام سرور راه دور را مشخص می‌کند. آرگومان سوم، دلیل شکست را مشخص می‌کند.
.SS HA_RESET_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ha\-reset command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که گرداننده دستور ha\-reset هنگام پردازش دستور با شکست مواجه شده است. آرگومان، دلیل شکست را مشخص می‌کند.
.SS HA_RESUME_CLIENT_LISTENER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: resuming multi\-threaded HTTP processing failed: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا هنگام تلاش برای ازسرگیری ریسمان‌های کلاینت و شنونده‌ی HTTP مربوط به HA صادر می‌شود. رخ دادن این خطا بسیار بعید است و نشان‌دهنده یک مشکل برنامه‌نویسی است که باید به عنوان نقص گزارش شود.
.SS HA_SCOPES_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ha\-scopes command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که گرداننده دستور ha\-scopes هنگام پردازش دستور با شکست مواجه شده است. آرگومان، دلیل شکست را مشخص می‌کند..SS HA_SERVICE_STARTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: started high availability service in %2 mode as %3 server
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی هنگامی صادر می‌شود که سرویس HA در نتیجهٔ راه‌اندازی کارساز یا پیکربندی مجدد آغاز به کار کند. آرگومان نخست، نام کارساز محلی را مشخص می‌کند. آرگومان دوم، حالت HA را ارائه می‌دهد. آرگومان سوم، نقش این نمونه از کارساز را در این پیکربندی مشخص می‌کند.
.SS HA_STATE_MACHINE_CONTINUED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: state machine is un\-paused
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی زمانی صادر می‌شود که ماشین حالت HA از مکث خارج شود. این کار کارساز را از وضعیت فعلی آزاد می‌کند. در صورت نیاز، کارساز می‌تواند به هر حالت دیگری گذار کند؛ برای نمونه، اگر به نظر برسد شریک آن آفلاین است به \(aqpartner\-down\(aq برود. همچنین در صورتی که وضعیت راه‌اندازی HA چنین رفتاری را ایجاب کند، کارساز ممکن است در وضعیت فعلی باقی بماند.
.SS HA_STATE_MACHINE_PAUSED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: state machine paused in state %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی هنگامی صادر می‌شود که ماشین حالت HA متوقف (مکث) شود. ماشین حالت HA ممکن است در وضعیت‌های مشخصی که در پیکربندی کتابخانه قلاب‌های HA تعیین شده است به حالت مکث درآید. هنگامی که ماشین حالت متوقف است، کارساز در وضعیت تعیین‌شده باقی می‌ماند تا زمانی که به‌طور صریح از مکث خارج شود (از طریق دستور ha\-continue). در صورت متوقف بودن ماشین حالت، کارساز به‌طور عادی کار می‌کند اما نمی‌تواند به هیچ حالت دیگری گذار کند.
.SS HA_STATE_TRANSITION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: server transitions from %2 to %3 state, partner state is %4
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی زمانی صادر می‌شود که کارساز در نتیجهٔ تعاملی (یا عدم تعامل) با شریک خود به یک وضعیت جدید گذار کند. آرگومان‌ها به‌ترتیب نام کارساز محلی، وضعیت اولیه کارساز، وضعیت جدید کارساز و وضعیت شریک را مشخص می‌کنند.
.SS HA_STATE_TRANSITION_PASSIVE_BACKUP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: server transitions from %2 to %3 state
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی زمانی صادر می‌شود که کارساز در حالت passive\-backup به یک وضعیت جدید گذار کند. آرگومان‌ها نام کارساز محلی، وضعیت اولیه کارساز و وضعیت جدید کارساز را مشخص می‌کنند.
.SS HA_SUBNET4_SELECT_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
subnet4_select callout failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که فراخوانی (callout) برای نقطه قلاب subnet4_select با شکست مواجه شود. این امر ممکن است در نتیجه یک خطای داخلی کارساز رخ دهد. آرگومان ارائه‌شده حاوی دلیل بروز خطا است.
.SS HA_SUBNET4_SELECT_INVALID_HA_SERVER_NAME
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: invalid ha\-server\-name value for subnet %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که پرس‌وجوی DHCPv4 دریافت شده توسط این کارساز نادیده گرفته (drop) شود، زیرا مقدار ha\-server\-name مشخص‌شده در user\-context زیرشبکه از نوع غیررشته‌ای بوده یا خالی است. این موضوع ناشی از پیکربندی نادرست کارساز است. آرگومان نخست اطلاعات شناسایی کلاینت است. آرگومان دوم پیشوند زیرشبکه است.
.SS HA_SUBNET4_SELECT_NOT_FOR_US
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: dropping query in relationship %2 to be processed by another server
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که پرس‌وجوی DHCPv4 دریافت شده توسط این کارساز نادیده گرفته شود زیرا باید توسط کارساز دیگری رسیدگی شود. این حالت زمانی رخ می‌دهد که کارساز اصلی راه دور فعال و در حال کار باشد. آرگومان نخست اطلاعات شناسایی کلاینت و آرگومان دوم نام رابطه (relationship) است.
.SS HA_SUBNET4_SELECT_NO_RELATIONSHIP_FOR_SUBNET
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: HA relationship not found for %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا هنگامی صادر می‌شود که پرس‌وجوی DHCPv4 دریافت شده توسط این کارساز نادیده گرفته شود، زیرا کارساز نتوانسته رابطه‌ای منطبق با ha\-server\-name مشخص‌شده برای یک زیرشبکه پیدا کند. نام کارساز با هیچ رابطه‌ای که در پیکربندی HA مشخص شده مطابقت ندارد. دلیل معمول آن وجود یک اشتباه تایپی است. آرگومان نخست اطلاعات شناسایی کلاینت است. آرگومان دوم نام رابطه است..SS HA_SUBNET4_SELECT_NO_RELATIONSHIP_SELECTOR_FOR_SUBNET
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: unable to determine HA relationship because selected subnet %2 lacks the ha\-server\-name
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که پرس‌وجوی DHCPv4 دریافت‌شده توسط این کارساز نادیده گرفته می‌شود؛ زیرا کارساز قادر به تعیین رابطه HA که پرس‌وجوی دریافت‌شده به آن تعلق دارد نبوده است. در صورت وجود چندین رابطه، لازم است مقدار ha\-server\-name در user\-context در سطح زیرشبکه یا شبکه مشترک برای هر زیرشبکه و/یا شبکه مشترک تعیین شود. کارساز از آن‌ها به عنوان گزینش‌گر رابطه استفاده می‌کند. در صورتی که این گزینش‌گرها برای هر یک از زیرشبکه‌ها تعیین نشده باشند، یک خطای پیکربندی به‌شمار می‌رود. آرگومان نخست، اطلاعات شناسایی کلاینت است. آرگومان دوم، پیشوند زیرشبکه است.
.SS HA_SUBNET4_SELECT_NO_SUBNET_SELECTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: unable to determine HA relationship because no subnet has been selected for the client
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که پرس‌وجوی DHCPv4 دریافت‌شده توسط این کارساز نادیده گرفته می‌شود؛ چرا که نتوانسته زیرشبکه‌ای برای این کلاینت انتخاب کند. انتخاب زیرشبکه برای یافتن رابطه HA مناسب ضروری است. این پیام هنگامی که کارساز تنها یک رابطه دارد صادر نمی‌شود. آرگومان این پیام، اطلاعات شناسایی کلاینت است.
.SS HA_SUBNET6_SELECT_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
subnet6_select callout failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که فراخوانی نقطه‌قلاب (hook point) subnet6_select با شکست مواجه شده باشد. این وضعیت ممکن است در پی یک خطای داخلی در کارساز رخ دهد. آرگومان ارائه‌شده شامل دلیل بروز خطا است.
.SS HA_SUBNET6_SELECT_INVALID_HA_SERVER_NAME
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: invalid ha\-server\-name value for subnet %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که پرس‌وجوی DHCPv6 دریافت‌شده توسط این کارساز نادیده گرفته می‌شود؛ زیرا مقدار ha\-server\-name مشخص‌شده در user\-context زیرشبکه، از نوع رشته‌ای نیست یا خالی است. این حالت نشان‌دهنده پیکربندی نادرست در کارساز است. آرگومان نخست، اطلاعات شناسایی کلاینت و آرگومان دوم، پیشوند زیرشبکه است.
.SS HA_SUBNET6_SELECT_NOT_FOR_US
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: dropping query in relationship %2 to be processed by another server
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که پرس‌وجوی DHCPv6 دریافت‌شده توسط این کارساز نادیده گرفته می‌شود؛ به این دلیل که پرس‌وجو باید توسط کارساز دیگری پاسخ داده شود. این وضعیت زمانی اتفاق می‌افتد که یک کارساز اولیه (primary) از راه دور فعال و آماده خدمت‌رسانی است. آرگومان نخست، اطلاعات شناسایی کلاینت و آرگومان دوم، نام رابطه است.
.SS HA_SUBNET6_SELECT_NO_RELATIONSHIP_FOR_SUBNET
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: HA relationship not found for %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که پرس‌وجوی DHCPv6 دریافت‌شده توسط این کارساز نادیده گرفته می‌شود؛ چرا که کارساز نتوانسته رابطه‌ای منطبق بر ha\-server\-name مشخص‌شده برای زیرشبکه پیدا کند. نام کارساز با هیچ‌یک از روابط مشخص‌شده در پیکربندی HA تطابق ندارد. دلیل متداول این مشکل، وجود اشتباه تایپی است. آرگومان نخست، اطلاعات شناسایی کلاینت و آرگومان دوم، نام رابطه است.
.SS HA_SUBNET6_SELECT_NO_RELATIONSHIP_SELECTOR_FOR_SUBNET
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: unable to determine HA relationship because selected subnet %2 lacks the ha\-server\-name
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که پرس‌وجوی DHCPv6 دریافت‌شده توسط این کارساز نادیده گرفته می‌شود؛ زیرا قادر به تعیین رابطه HA که پرس‌وجوی دریافت‌شده به آن تعلق دارد نبوده است. در صورت وجود چندین رابطه، مشخص کردن مقدار ha\-server\-name در user\-context در سطح زیرشبکه یا شبکه مشترک برای هر زیرشبکه و/یا شبکه مشترک الزامی است. کارساز از آن‌ها به عنوان گزینش‌گر رابطه استفاده می‌کند. چنانچه این گزینش‌گرها برای هر یک از زیرشبکه‌ها تعیین نشده باشند، خطای پیکربندی رخ داده است. آرگومان نخست، اطلاعات شناسایی کلاینت و آرگومان دوم، پیشوند زیرشبکه است.
.SS HA_SUBNET6_SELECT_NO_SUBNET_SELECTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: unable to determine HA relationship because no subnet has been selected for the client
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که پرس‌وجوی DHCPv6 دریافت‌شده توسط این کارساز نادیده گرفته می‌شود؛ چرا که نتوانسته زیرشبکه‌ای برای این کلاینت برگزیند. انتخاب زیرشبکه به منظور یافتن یک رابطه HA مناسب الزامی است. این پیام در صورتی که کارساز فقط دارای یک رابطه باشد تولید نخواهد شد. آرگومان موجود، اطلاعات شناسایی کلاینت است..SS HA_SYNC_COMPLETE_NOTIFY_COMMUNICATIONS_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: failed to send ha\-sync\-complete\-notify to %2: %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار نشان‌دهندهٔ وجود مشکلی در برقراری ارتباط با یک همتای HA هنگام ارسال دستور ha\-sync\-complete\-notify است. آرگومان نخست، نام سرور محلی را مشخص می‌کند. آرگومان دوم، نام سرور دوردست را مشخص می‌کند. آرگومان سوم دلیل این شکست را ارائه می‌دهد.
.SS HA_SYNC_COMPLETE_NOTIFY_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: error processing ha\-sync\-complete\-notify command on %2: %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار نشان می‌دهد که یک همتا در پاسخ به دستور ha\-sync\-complete\-notify یک کد وضعیت خطا برگردانده است. آرگومان نخست، نام سرور محلی را مشخص می‌کند. آرگومان دوم، نام سرور دوردست را مشخص می‌کند. آرگومان سوم دلیل این شکست را ارائه می‌دهد.
.SS HA_SYNC_COMPLETE_NOTIFY_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ha\-sync\-complete\-notify command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهندهٔ آن است که گردانندهٔ دستور ha\-sync\-complete\-notify در حین پردازش دستور با شکست مواجه شده است. این آرگومان دلیل شکست را مشخص می‌کند.
.SS HA_SYNC_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: lease database synchronization with %2 failed: %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهندهٔ آن است که همگام‌سازی پایگاه‌دادهٔ اجاره‌ها (lease database) با شکست مواجه شده است. آرگومان نخست نام سرور محلی را مشخص می‌کند. آرگومان دوم نام سرور شریک را مشخص می‌کند. آرگومان سوم دلیل این شکست را بیان می‌کند.
.SS HA_SYNC_HANDLER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ha\-sync command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهندهٔ آن است که گردانندهٔ دستور ha\-sync در حین پردازش دستور با شکست مواجه شده است. این آرگومان دلیل شکست را مشخص می‌کند.
.SS HA_SYNC_START
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: starting lease database synchronization with %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی زمانی صادر می‌شود که سرور همگام‌سازی پایگاه‌دادهٔ اجاره‌ها را با یک سرور شریک آغاز می‌کند. آرگومان‌ها نام سرورهای محلی و دوردست را مشخص می‌کنند.
.SS HA_SYNC_SUCCESSFUL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: lease database synchronization with %2 completed successfully in %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی هنگامی صادر می‌شود که سرور همگام‌سازی پایگاه‌دادهٔ اجاره‌ها را با سرور شریک با موفقیت به پایان رسانده است. آرگومان نخست نام سرور محلی را مشخص می‌کند. آرگومان دوم نام سرور شریک را تعیین می‌کند. آرگومان سوم مدت‌زمان فرایند همگام‌سازی را نشان می‌دهد.
.SS HA_TERMINATED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
HA %1: service terminated due to an unrecoverable condition. Check previous error message(s), address the problem and restart!
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا بیانگر آن است که سرویس HA به‌دلیل یک وضعیت غیرقابل‌قبول (مانند انحراف زمانی بیش از حد ساعت یا clock skew) متوقف شده است. علت دقیق این رخداد باید در پیام(های) خطای پیشین مشخص شده باشد. وضعیت گزارش‌شده را برطرف کرده و سپس سرورها را بازراه‌اندازی کنید تا ارائهٔ سرویس ادامه یابد.
.SS HA_TERMINATED_PARTNER_DID_NOT_RESTART
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: service is terminating because the terminated partner was not restarted within %2 minutes
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار نشان می‌دهد که سرویس HA در حال خاتمه یافتن است، زیرا سرور شریک در وضعیت خاتمه‌یافته (terminated) قرار دارد و در بازهٔ زمانی مورد انتظار بازراه‌اندازی نشده است. سرورهای متوقف‌شده باید پس از رفع مشکلی که موجب توقف آن‌ها شده است، مجدداً راه‌اندازی شوند. امکان راه‌اندازی متوالی آن‌ها وجود دارد اما فاصلهٔ زمانی بین این راه‌اندازی‌ها نباید طولانی باشد. در صورت طولانی شدن، ممکن است به این معنا باشد که راه‌اندازی یکی از سرورها غیرعمدی بوده است (برای نمونه قطع برق). اگر سرورِ بازراه‌اندازی‌شده در حالت انتظار (waiting) باقی بماند، نمی‌تواند به کلاینت‌های DHCP سرویس‌دهی کند. رفتن به وضعیت خاتمه‌یافته دست‌کم امکان پاسخ‌گویی به ترافیک DHCP را فراهم می‌کند..SS HA_TERMINATED_RESTART_PARTNER
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1: waiting for the partner in the TERMINATED state to be restarted
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی زمانی صادر می‌شود که کارگزار پس از اصلاح انحراف ساعت (clock skew) مجدداً راه‌اندازی شده باشد. کارگزار همکار (partner server) همچنان در وضعیت خاتمه‌یافته (TERMINATED) قرار دارد. پیش از آنکه کارگزار بتواند پایگاه داده را همگام‌سازی کرده و عملکرد عادی را آغاز کند، همکار باید مجدداً راه‌اندازی شود.
.SS HOOKS
.SS HOOKS_ALL_CALLOUTS_DEREGISTERED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
hook library at index %1 removed all callouts on hook %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که تمام calloutهای روی hook مشخص‌شده که توسط کتابخانه با شاخص داده‌شده ثبت شده بودند، حذف شوند. این پیام مشابه پیام HOOKS_CALLOUTS_REMOVED است (و احتمالاً هر دو با هم دیده می‌شوند)، اما در سطح پایین‌تری از چارچوب hook صادر می‌شود.
.SS HOOKS_CALLOUTS_BEGIN
.INDENT 0.0
.INDENT 3.5
.sp
.EX
begin all callouts for hook %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۵ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که مدیر callout فراخوانی calloutها را برای hook آغاز می‌کند. آرگومان نام hook را مشخص می‌کند.
.SS HOOKS_CALLOUTS_COMPLETE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
completed callouts for hook %1 (total callouts duration: %2)
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۵ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که مدیر callout اجرای تمام calloutها را برای hook مورد نظر به پایان رسانده باشد. آرگومان‌ها نام hook و مدت زمان کل اجرای تمام calloutها را بر حسب میلی‌ثانیه مشخص می‌کنند.
.SS HOOKS_CALLOUTS_REMOVED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
callouts removed from hook %1 for library %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۵ ثبت می‌شود.
این یک پیام اشکال‌زدایی است که هنگام تخلیه بارگذاری کتابخانه صادر می‌شود. این پیام مشخص می‌کند که یک یا چند callout ثبت‌شده توسط آن کتابخانه از hook مشخص‌شده حذف شده‌اند. این پیام شبیه پیام HOOKS_DEREGISTER_ALL_CALLOUTS است (و احتمال دارد هر دو با هم مشاهده شوند)، اما در سطح بالاتری از چارچوب hook صادر می‌شود.
.SS HOOKS_CALLOUT_CALLED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
hooks library with index %1 has called a callout on hook %2 that has address %3 (callout duration: %4)
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۵۵ ثبت می‌شود.
این پیام که تنها در سطوح بالای اشکال‌زدایی نشان داده می‌شود، بیانگر این است که یک callout روی hook نام‌برده، ثبت‌شده توسط کتابخانه با شاخص داده‌شده (در فهرست کتابخانه‌های بارگذاری‌شده)، فراخوانی شده و وضعیت موفقیت‌آمیز بازگردانده است. نشانی callout در پیام آمده است. همچنین پیام شامل مدت زمان اجرای callout بر حسب میلی‌ثانیه می‌باشد.
.SS HOOKS_CALLOUT_DEREGISTERED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
hook library at index %1 deregistered a callout on hook %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که تمام نمونه‌های یک callout خاص روی hook مشخص‌شده در پیام، که توسط کتابخانه با شاخص داده‌شده ثبت شده بودند، حذف شده باشند.
.SS HOOKS_CALLOUT_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
error returned by callout on hook %1 registered by library with index %2 (callout address %3) (callout duration %4)
.EE
.UNINDENT
.UNINDENT
.sp
اگر یک callout هنگام فراخوانی وضعیت خطا بازگرداند، این پیام خطا صادر می‌شود. این پیام، hookای را که callout به آن متصل است، شاخص کتابخانه (در فهرست کتابخانه‌های بارگذاری‌شده) که آن را ثبت کرده است، و نشانی callout را مشخص می‌کند. در غیر این صورت، خطا نادیده گرفته می‌شود. پیام خطا شامل مدت زمان اجرای callout بر حسب میلی‌ثانیه نیز هست.
.SS HOOKS_CALLOUT_EXCEPTION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
exception thrown by callout on hook %1 registered by library with index %2 (callout address %3): %4 (callout duration: %5)
.EE
.UNINDENT
.UNINDENT
.sp
اگر یک callout هنگام فراخوانی یک استثنا (exception) ایجاد کند، این پیام خطا صادر می‌شود. این پیام، hookای را که callout به آن متصل است، شاخص کتابخانه (در فهرست کتابخانه‌های بارگذاری‌شده) که آن را ثبت کرده است، و نشانی callout را مشخص می‌کند. در غیر این صورت، خطا نادیده گرفته می‌شود. پیام خطا شامل مدت زمان اجرای callout بر حسب میلی‌ثانیه نیز هست..SS HOOKS_CALLOUT_REGISTRATION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
hooks library with index %1 registering callout for hook \(aq%2\(aq
.EE
.UNINDENT
.UNINDENT
.sp
در سطح ثبت اشکال‌زدایی ۴۵ ثبت می‌شود.
این یک پیام اشکال‌زدایی است که هنگام ثبت یک فراخوانی (callout) توسط یک کتابخانه (که اندیس آن در فهرست کتابخانه‌های در حال بارگذاری مشخص شده) نشان داده می‌شود.
.SS HOOKS_CLOSE_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to close hook library %1: %2
.EE
.UNINDENT
.UNINDENT
.sp
سامانه Kea به دلیل ذکرشده نتوانست کتابخانه قلاب (hook) نام‌برده را ببندد.
اگرچه این یک خطاست، اما به جز اتلاف منابع نباید تأثیری بر سامانهٔ در حال اجرا بگذارد. اگر این خطا ادامه داشت، باید Kea را بازراه‌اندازی کنید.
.SS HOOKS_HOOK_LIST_RESET
.INDENT 0.0
.INDENT 3.5
.sp
.EX
the list of hooks has been reset
.EE
.UNINDENT
.UNINDENT
.sp
این پیامی است که نشان می‌دهد فهرست قلاب‌ها بازنشانی شده است.
در حالی که این اتفاق هنگام اجرای مجموعه آزمون‌های Kea معمول است، نباید هنگام اجرای Kea در یک محیط عملیاتی دیده شود. اگر این پیام ظاهر شد، لطفاً از طریق مجاری معمول یک گزارش باگ ارسال کنید.
.SS HOOKS_INCORRECT_VERSION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
hook library %1 is at version %2, require version %3
.EE
.UNINDENT
.UNINDENT
.sp
سامانه Kea تشخیص داده است که کتابخانه قلاب نام‌برده با نسخه‌ای از Kea ساخته شده است که با نسخهٔ Kea در حال اجرا روی سامانهٔ شما ناسازگار است؛ از این رو کتابخانه را بارگذاری نکرده است.
این وضعیت به احتمال زیاد ناشی از نصب نسخهٔ جدیدی از Kea بدون کامپایل مجدد کتابخانه قلاب است. ساخت و نصب مجدد کتابخانه در بیشتر موارد مشکل را برطرف می‌کند.
.SS HOOKS_LIBPATH_SECURITY_WARNING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Library path specified is NOT SECURE: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که الزام امنیتی غیرفعال شده باشد و مسیر تعیین‌شده برای یک کتابخانه قلاب مشخص، با مسیرهای پشتیبانی‌شده مطابقت نداشته باشد. سرور همچنان کتابخانه قلاب را بارگذاری می‌کند، اما هشدار می‌دهد که انجام این کار ممکن است خطرات امنیتی به همراه داشته باشد.
.SS HOOKS_LIBRARY_CLOSED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
hooks library %1 successfully closed
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی زمانی صادر می‌شود که یک کتابخانه قلاب‌های ارائه‌شده توسط کاربر با موفقیت بسته شده باشد.
.SS HOOKS_LIBRARY_LOADED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
hooks library %1 successfully loaded
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی زمانی صادر می‌شود که یک کتابخانه قلاب‌های ارائه‌شده توسط کاربر با موفقیت بارگذاری شده باشد.
.SS HOOKS_LIBRARY_LOADING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
loading hooks library %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح ثبت اشکال‌زدایی ۴۰ ثبت می‌شود.
این یک پیام اشکال‌زدایی است که درست پیش از بارگذاری کتابخانهٔ مشخص‌شده نمایش داده می‌شود.
در صورت موفقیت‌آمیز بودن عملیات، این پیام با پیام اطلاع‌رسانی HOOKS_LIBRARY_LOADED دنبال خواهد شد.
.SS HOOKS_LIBRARY_MULTI_THREADING_COMPATIBLE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
hooks library %1 reports its multi\-threading compatibility as %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح ثبت اشکال‌زدایی ۴۵ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که تابع \(dqmulti_threading_compatible\(dq فراخوانی شده باشد. مقدار بازگردانده‌شده (۰ به معنای ناسازگار و سایر مقادیر به معنای سازگار) نمایش داده می‌شود..SS HOOKS_LIBRARY_MULTI_THREADING_NOT_COMPATIBLE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
hooks library %1 is not compatible with multi\-threading
.EE
.UNINDENT
.UNINDENT
.sp
هنگامی که چندنخی (multi\-threading) فعال باشد و کتابخانه سازگار نباشد (خواه به این دلیل که تابع \(dqmulti_threading_compatible\(dq مقدار 0 را برگردانده یا اینکه پیاده‌سازی نشده باشد)، این پیام خطا صادر می‌شود. کتابخانه باید از پیکربندی حذف شود یا اینکه چندنخی غیرفعال گردد.
.SS HOOKS_LIBRARY_UNLOADED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
hooks library %1 successfully unloaded
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی هنگامی صادر می‌شود که یک کتابخانهٔ قلاب‌ها (hooks library) ارائه‌شده از سوی کاربر با موفقیت تخلیه (unload) شده باشد.
.SS HOOKS_LIBRARY_UNLOADING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
unloading library %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug log level) 40 ثبت می‌شود.
این یک پیام اشکال‌زدایی است و زمانی صادر می‌شود که کتابخانهٔ مشخص‌شده در حال تخلیه شدن باشد. اگر همه‌چیز با موفقیت انجام شود، پیام اطلاع‌رسانی HOOKS_LIBRARY_UNLOADED به دنبال آن خواهد آمد.
.SS HOOKS_LIBRARY_VERSION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
hooks library %1 reports its version as %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug log level) 45 ثبت می‌شود.
پیامی اشکال‌زدایی که هنگام موفقیت‌آمیز بودن بررسی نسخهٔ کتابخانهٔ قلاب‌ها صادر می‌شود.
.SS HOOKS_LOAD_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(aqload\(aq function in hook library %1 returned error %2
.EE
.UNINDENT
.UNINDENT
.sp
تابع \(dqload\(dq در کتابخانهٔ نام‌برده در پیام پیدا و فراخوانی شد. این تابع یک وضعیت غیرصفر (که آن هم در پیام آمده است) برگرداند که به عنوان خطا تفسیر شد. کتابخانه تخلیه شده است و هیچ فراخوانی‌ای (callout) از آن نصب نخواهد شد.
.SS HOOKS_LOAD_EXCEPTION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(aqload\(aq function in hook library %1 threw an exception
.EE
.UNINDENT
.UNINDENT
.sp
تابع \(dqload\(dq در کتابخانهٔ نام‌برده در پیام پیدا و فراخوانی شد. این تابع در حین اجرا یک استثنا (نشانه‌ای از بروز خطا) پرتاب کرد که یک وضعیت خطاست. کتابخانه تخلیه شده است و هیچ فراخوانی‌ای (callout) از آن نصب نخواهد شد.
.SS HOOKS_LOAD_FRAMEWORK_EXCEPTION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(aqload\(aq function in hook library %1 threw an exception: reason %2
.EE
.UNINDENT
.UNINDENT
.sp
تابع \(dqload\(dq در کتابخانهٔ نام‌برده در پیام پیدا و فراخوانی شد. چارچوب قلاب‌ها یا خود تابع در حین اجرا یک استثنا (نشانه‌ای از بروز خطا) ایجاد کردند که وضعیتی خطاست؛ علت استثنا در پیام ثبت شده است. کتابخانه تخلیه شده است و هیچ فراخوانی‌ای (callout) از آن نصب نخواهد شد.
.SS HOOKS_LOAD_SUCCESS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(aqload\(aq function in hook library %1 returned success
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug log level) 40 ثبت می‌شود.
این یک پیام اشکال‌زدایی است و زمانی صادر می‌شود که تابع \(dqload\(dq در یک کتابخانهٔ قلاب پیدا شده و با موفقیت فراخوانی شده باشد.
.SS HOOKS_MULTI_THREADING_COMPATIBLE_EXCEPTION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(aqmulti_threading_compatible\(aq function in hook library %1 threw an exception
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که تابع multi_threading_compatible() در کتابخانهٔ قلابِ مشخص‌شده فراخوانی شده و یک استثنا ایجاد کرده باشد. این کتابخانه غیرقابل‌استفاده تلقی شده و بارگذاری نخواهد شد..SS HOOKS_NO_LOAD
.INDENT 0.0
.INDENT 3.5
.sp
.EX
no \(aqload\(aq function found in hook library %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این یک پیام اشکال‌زدایی است و نشان می‌دهد که کتابخانه مشخص‌شده بارگذاری شد،
اما هیچ تابعی با نام \(dqload\(dq در آن یافت نشد. به شرطی که کتابخانه
حاوی چند تابع «استاندارد» باشد (یعنی توابعی با نام‌های hookهای سرور
مربوطه)، این مورد مشکلی ایجاد نمی‌کند.
.SS HOOKS_NO_UNLOAD
.INDENT 0.0
.INDENT 3.5
.sp
.EX
no \(aqunload\(aq function found in hook library %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این یک پیام اشکال‌زدایی است که هنگام تخلیه (unload) کتابخانه از حافظه صادر می‌شود.
این پیام صرفاً بیان می‌کند که کتابخانه شامل تابع \(dqunload\(dq نبوده است.
.SS HOOKS_NO_VERSION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
no \(aqversion\(aq function found in hook library %1
.EE
.UNINDENT
.UNINDENT
.sp
کتابخانه اشتراکی ذکرشده در پیام پیدا شده و با موفقیت بارگذاری شد،
اما Kea هیچ تابعی با نام \(dqversion\(dq در آن نیافت. این تابع الزامی
است و باید نسخه Kea را که کتابخانه بر اساس آن ساخته شده است بازگرداند.
این مقدار برای بررسی سازگار بودن نسخه Kea با نسخه ساخته‌شده کتابخانه
استفاده می‌شود. کتابخانه بارگذاری نشده است.
.SS HOOKS_OPEN_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to open hook library %1: %2
.EE
.UNINDENT
.UNINDENT
.sp
‏Kea به دلیل ذکرشده نتوانست کتابخانه hook مشخص‌شده را باز کند.
کتابخانه بارگذاری نشده است. Kea به عملکرد خود ادامه خواهد داد،
اما بدون سرویس‌هایی که توسط این کتابخانه ارائه می‌شوند.
.SS HOOKS_STD_CALLOUT_REGISTERED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
hooks library %1 registered standard callout for hook %2 at address %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۵ ثبت می‌شود.
این یک پیام اشکال‌زدایی است و زمانی در خروجی ثبت می‌شود که تابع بارگذاری کتابخانه،
یک callout استاندارد (یک callout با نامی یکسان با نقطه hook) را پیدا کرده
و آن را ثبت کرده باشد. نشانی callout نیز مشخص شده است.
.SS HOOKS_UNLOAD_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(aqunload\(aq function in hook library %1 returned error %2
.EE
.UNINDENT
.UNINDENT
.sp
هنگام تخلیه کتابخانه از حافظه، یک تابع \(dqunload\(dq پیدا شد.
این تابع فراخوانی گردید، اما وضعیت خطا (غیر\-صفر) برگرداند که باعث
صدور این پیام شد. فرایند تخلیه پس از این پیام ادامه یافت و کتابخانه
از حافظه تخلیه شد.
.SS HOOKS_UNLOAD_EXCEPTION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(aqunload\(aq function in hook library %1 threw an exception
.EE
.UNINDENT
.UNINDENT
.sp
هنگام تخلیه کتابخانه از حافظه، یک تابع \(dqunload\(dq پیدا شد. این تابع
فراخوانی شد، اما در حین اجرا یک استثنا (نشانگر خطا) ایجاد کرد.
فرایند تخلیه پس از این پیام ادامه یافت و کتابخانه از حافظه
تخلیه شد.
.SS HOOKS_UNLOAD_FRAMEWORK_EXCEPTION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(aqunload\(aq function in hook library %1 threw an exception, reason %2
.EE
.UNINDENT
.UNINDENT
.sp
هنگام تخلیه کتابخانه از حافظه، یک تابع \(dqunload\(dq پیدا شد.
این تابع فراخوانی شد، اما در حین اجرا خود تابع یا چارچوب hooks
یک استثنا (نشانگر خطا) ایجاد کرد؛ دلیل خطا در پیام ثبت شده است.
فرایند تخلیه پس از این پیام ادامه یافت و کتابخانه از حافظه
تخلیه شد.
.SS HOOKS_UNLOAD_SUCCESS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(aqunload\(aq function in hook library %1 returned success
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این یک پیام اشکال‌زدایی است و زمانی صادر می‌شود که یک تابع \(dqunload\(dq در طول
فرایند تخلیه در یک کتابخانه hook پیدا شده، فراخوانی شده و با موفقیت پایان یافته باشد..SS HOOKS_VERSION_EXCEPTION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
تابع \(aqversion\(aq در کتابخانه هوک %1 یک استثنا ایجاد کرد
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که تابع version() در کتابخانه هوک مشخص‌شده
فراخوانی شده و یک استثنا ایجاد کرده باشد. این کتابخانه غیرقابل‌استفاده در نظر
گرفته شده و بارگذاری نخواهد شد.
.SS HOSTS
.SS HOSTS_BACKENDS_REGISTERED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
انواع بک‌اند میزبان زیر در دسترس هستند: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی، تمام بک‌اندهای میزبان ممکن را که می‌توان در
hosts\-database[s] استفاده کرد فهرست می‌کند.
.SS HOSTS_BACKEND_DEREGISTER
.INDENT 0.0
.INDENT 3.5
.sp
.EX
نوع بک‌اند میزبان لغو ثبت شد: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که ثبت یک backend factory لغو شده باشد.
دیگر استفاده از بک‌اند میزبان از این نوع امکان‌پذیر نیست.
.SS HOSTS_BACKEND_REGISTER
.INDENT 0.0
.INDENT 3.5
.sp
.EX
نوع بک‌اند میزبان ثبت شد: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک backend factory با موفقیت
ثبت شده باشد. اکنون امکان استفاده از بک‌اند میزبان از این نوع وجود دارد.
.SS HOSTS_CFG_ADD_HOST
.INDENT 0.0
.INDENT 3.5
.sp
.EX
افزودن میزبان برای رزروها: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که میزبان جدیدی (به همراه رزروها) به
پیکربندی کارساز اضافه شود. این آرگومان، میزبان و رزروهای آن را با جزئیات
شرح می‌دهد.
.SS HOSTS_CFG_CACHE_HOST_DATA_SOURCE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
دریافت منبع داده حافظه پنهان میزبان: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی زمانی صادر می‌شود که یک منبع داده حافظه پنهان میزبان
توسط مدیر میزبان (host manager) شناسایی شود.
.SS HOSTS_CFG_CLOSE_HOST_DATA_SOURCE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
در حال بستن منبع داده میزبان: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این یک پیام عادی است که هنگام بستن اتصال منبع داده میزبان توسط کارساز
چاپ می‌شود.
.SS HOSTS_CFG_DEL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
تعداد %1 میزبان دارای %2 رزرو IPv6 برای شناسه زیرشبکه %3 و نشانی %4 حذف شد(ند)
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که رزروها برای زیرشبکه و نشانی مشخص‌شده
حذف شوند. آرگومان نخست مشخص می‌کند چه تعداد میزبان حذف شده‌اند. آرگومان دوم
مشخص می‌کند چه تعداد رزرو حذف شده‌اند. آرگومان سوم شناسه زیرشبکه است. آرگومان
چهارم نشانی IP است.
.SS HOSTS_CFG_DEL4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
تعداد %1 میزبان برای شناسه زیرشبکه %2 و شناسه %3 حذف شد(ند)
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که رزروهای IPv4 برای زیرشبکه و شناسه
مشخص‌شده حذف شوند. آرگومان نخست مشخص می‌کند چه تعداد میزبان حذف شده‌اند.
آرگومان دوم شناسه زیرشبکه است. آرگومان سوم شناسه موردنظر است..SS HOSTS_CFG_DEL6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted %1 host(s) having %2 IPv6 reservation(s) for subnet id %3 and identifier %4
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 40 ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که رزروهای IPv6 برای زیرشبکه و شناسه مشخص‌شده حذف شوند. آرگومان نخست تعیین می‌کند چه تعداد میزبان حذف شده‌اند. آرگومان دوم مشخص می‌کند چه تعداد رزرو حذف شده‌اند. آرگومان سوم شناسه زیرشبکه است. آرگومان چهارم شناسه است.
.SS HOSTS_CFG_DEL_ALL_SUBNET4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted all %1 host(s) for subnet id %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 40 ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که تمامی رزروهای IPv4 برای زیرشبکه مشخص‌شده حذف شوند. آرگومان نخست مشخص می‌کند چه تعداد رزرو حذف شده‌اند. آرگومان دوم شناسه زیرشبکه است.
.SS HOSTS_CFG_DEL_ALL_SUBNET6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted all %1 host(s) having %2 IPv6 reservation(s) for subnet id %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 40 ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که تمامی رزروهای IPv6 برای زیرشبکه مشخص‌شده حذف شوند. آرگومان نخست مشخص می‌کند چه تعداد میزبان حذف شده‌اند. آرگومان دوم تعیین می‌کند چه تعداد رزرو IPv6 (نشانی‌ها و پیشوندها) حذف شده‌اند. آرگومان سوم شناسه زیرشبکه است.
.SS HOSTS_CFG_GET_ALL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
get all hosts with reservations
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 40 ثبت می‌شود.
این پیام اشکال‌زدایی هنگام آغاز بازیابی تمام میزبان‌ها صادر می‌شود.
.SS HOSTS_CFG_GET_ALL_ADDRESS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
get all hosts with reservations for IPv4 address %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 40 ثبت می‌شود.
این پیام اشکال‌زدایی هنگام آغاز بازیابی تمامی میزبان‌های دارای رزرو برای نشانی IPv4 مشخص‌شده از پیکربندی صادر می‌شود. این آرگومان نشانی IPv4 به‌کاررفته برای جستجوی میزبان‌ها را مشخص می‌کند.
.SS HOSTS_CFG_GET_ALL_ADDRESS4_COUNT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
using address %1, found %2 host(s)
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 45 ثبت می‌شود.
این پیام اشکال‌زدایی تعداد میزبان‌های یافت‌شده با استفاده از نشانی IPv4 مشخص‌شده را ثبت می‌کند. آرگومان‌ها به‌ترتیب نشانی IPv4 استفاده‌شده و تعداد میزبان‌های یافت‌شده را مشخص می‌کنند.
.SS HOSTS_CFG_GET_ALL_ADDRESS4_HOST
.INDENT 0.0
.INDENT 3.5
.sp
.EX
using address %1 found host: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 55 ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که میزبانی با رزرو برای نشانی IPv4 مشخص‌شده پیدا شود. آرگومان‌ها نشانی IPv4 و توضیحات تفصیلی میزبان یافت‌شده را مشخص می‌کنند.
.SS HOSTS_CFG_GET_ALL_ADDRESS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
get all hosts with reservations for IPv6 address %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 40 ثبت می‌شود.
این پیام اشکال‌زدایی هنگام آغاز بازیابی تمامی میزبان‌های دارای رزرو برای نشانی IPv6 مشخص‌شده از پیکربندی صادر می‌شود. این آرگومان نشانی IPv6 به‌کاررفته برای جستجوی میزبان‌ها را مشخص می‌کند.
.SS HOSTS_CFG_GET_ALL_ADDRESS6_COUNT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
using address %1, found %2 host(s)
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 45 ثبت می‌شود.
این پیام اشکال‌زدایی تعداد میزبان‌های یافت‌شده با استفاده از نشانی IPv6 مشخص‌شده را ثبت می‌کند. آرگومان‌ها به‌ترتیب نشانی IPv6 استفاده‌شده و تعداد میزبان‌های یافت‌شده را مشخص می‌کنند..SS HOSTS_CFG_GET_ALL_ADDRESS6_HOST
.INDENT 0.0
.INDENT 3.5
.sp
.EX
using address %1 found host: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) 55 ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که میزبانی با رزرو برای نشانی IPv6 مشخص‌شده یافت شود. آرگومان‌ها نشانی IPv6 و توضیحات تفصیلی میزبان یافت‌شده را مشخص می‌کنند.
.SS HOSTS_CFG_GET_ALL_COUNT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
found %1 host(s)
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) 45 ثبت می‌شود.
این پیام اشکال‌زدایی شامل جزئیات میزبان‌های یافت‌شده است. آرگومان تعداد میزبان‌های یافت‌شده را مشخص می‌کند.
.SS HOSTS_CFG_GET_ALL_HOST
.INDENT 0.0
.INDENT 3.5
.sp
.EX
found host: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) 55 ثبت می‌شود.
این پیام اشکال‌زدایی شامل جزئیات میزبان یافت‌شده است. آرگومان جزئیات میزبان یافت‌شده را مشخص می‌کند.
.SS HOSTS_CFG_GET_ALL_HOSTNAME
.INDENT 0.0
.INDENT 3.5
.sp
.EX
get all hosts with reservations for hostname %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) 40 ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که بازیابی تمام میزبان‌های دارای hostname مشخص آغاز گردد. آرگومان hostname را مشخص می‌کند.
.SS HOSTS_CFG_GET_ALL_HOSTNAME_COUNT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
using hostname %1, found %2 host(s)
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) 45 ثبت می‌شود.
این پیام اشکال‌زدایی شامل جزئیات میزبان‌های یافت‌شده با استفاده از hostname است. آرگومان‌ها به‌ترتیب hostname و تعداد میزبان‌های یافت‌شده را مشخص می‌کنند.
.SS HOSTS_CFG_GET_ALL_HOSTNAME_HOST
.INDENT 0.0
.INDENT 3.5
.sp
.EX
using hostname %1, found host: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) 55 ثبت می‌شود.
این پیام اشکال‌زدایی شامل جزئیات میزبان یافت‌شده با استفاده از hostname است. آرگومان‌ها به‌ترتیب hostname و جزئیات میزبان یافت‌شده را مشخص می‌کنند.
.SS HOSTS_CFG_GET_ALL_HOSTNAME_SUBNET_ID4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
get all hosts with reservations for hostname %1 and IPv4 subnet %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) 40 ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که بازیابی تمام میزبان‌های دارای hostname مشخص و متصل به زیرشبکه (subnet) خاص DHCPv4 آغاز گردد. آرگومان‌ها hostname و subnet id را مشخص می‌کنند.
.SS HOSTS_CFG_GET_ALL_HOSTNAME_SUBNET_ID4_COUNT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
using hostname %1 and IPv4 subnet %2, found %3 host(s)
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) 45 ثبت می‌شود.
این پیام اشکال‌زدایی شامل جزئیات میزبان‌های یافت‌شده با استفاده از hostname و DHCPv4 subnet id است. آرگومان‌ها به‌ترتیب hostname، شناسه زیرشبکه (subnet id) و تعداد میزبان‌های یافت‌شده را مشخص می‌کنند.
.SS HOSTS_CFG_GET_ALL_HOSTNAME_SUBNET_ID4_HOST
.INDENT 0.0
.INDENT 3.5
.sp
.EX
using hostname %1 and IPv4 subnet %2, found host: %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) 55 ثبت می‌شود.
این پیام اشکال‌زدایی شامل جزئیات میزبان یافت‌شده با استفاده از hostname و DHCPv4 subnet id است. آرگومان‌ها به‌ترتیب hostname، شناسه زیرشبکه (subnet id) و جزئیات میزبان یافت‌شده را مشخص می‌کنند..SS HOSTS_CFG_GET_ALL_HOSTNAME_SUBNET_ID6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
get all hosts with reservations for hostname %1 and IPv6 subnet %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگام شروع بازیابی تمام میزبان‌های دارای نام میزبان خاص متصل به زیرشبکه DHCPv6 مشخص صادر می‌شود. این آرگومان hostname و subnet id را مشخص می‌کند.
.SS HOSTS_CFG_GET_ALL_HOSTNAME_SUBNET_ID6_COUNT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
using hostname %1 and IPv6 subnet %2, found %3 host(s)
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۵ ثبت می‌شود.
این پیام اشکال‌زدایی شامل جزئیات میزبان‌های یافت‌شده با استفاده از hostname و DHCPv6 subnet id است. آرگومان‌ها به ترتیب hostname، subnet id و تعداد میزبان‌های یافت‌شده را مشخص می‌کنند.
.SS HOSTS_CFG_GET_ALL_HOSTNAME_SUBNET_ID6_HOST
.INDENT 0.0
.INDENT 3.5
.sp
.EX
using hostname %1 and IPv6 subnet %2, found host: %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی شامل جزئیات میزبان یافت‌شده با استفاده از hostname و DHCPv6 subnet id است. آرگومان‌ها به ترتیب hostname، subnet id و جزئیات میزبان یافت‌شده را مشخص می‌کنند.
.SS HOSTS_CFG_GET_ALL_IDENTIFIER
.INDENT 0.0
.INDENT 3.5
.sp
.EX
get all hosts with reservations using identifier: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگام شروع بازیابی رزروها برای تمام میزبان‌های شناسایی‌شده با HW address یا DUID صادر می‌شود. این آرگومان هم نوع شناسه و هم مقدار آن را مشخص می‌کند.
.SS HOSTS_CFG_GET_ALL_IDENTIFIER_COUNT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
using identifier %1, found %2 host(s)
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۵ ثبت می‌شود.
این پیام اشکال‌زدایی تعداد میزبان‌های یافت‌شده با استفاده از شناسه مشخص‌شده را ثبت می‌کند. آرگومان‌ها به ترتیب شناسه استفاده‌شده و تعداد میزبان‌های یافت‌شده را مشخص می‌کنند.
.SS HOSTS_CFG_GET_ALL_IDENTIFIER_HOST
.INDENT 0.0
.INDENT 3.5
.sp
.EX
using identifier: %1, found host: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی هنگام یافتن میزبان شناسایی‌شده با شناسه خاص صادر می‌شود. آرگومان‌ها شناسه و شرح تفصیلی میزبان یافت‌شده را مشخص می‌کنند.
.SS HOSTS_CFG_GET_ALL_SUBNET_ID4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
get all hosts with reservations for IPv4 subnet %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگام شروع بازیابی تمام میزبان‌های متصل به زیرشبکه DHCPv4 خاص صادر می‌شود. این آرگومان subnet id را مشخص می‌کند.
.SS HOSTS_CFG_GET_ALL_SUBNET_ID4_COUNT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
using IPv4 subnet %1, found %2 host(s)
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۵ ثبت می‌شود.
این پیام اشکال‌زدایی شامل جزئیات میزبان‌های یافت‌شده با استفاده از DHCPv4 subnet id است. آرگومان‌ها به ترتیب subnet id و تعداد میزبان‌های یافت‌شده را مشخص می‌کنند.
.SS HOSTS_CFG_GET_ALL_SUBNET_ID4_HOST
.INDENT 0.0
.INDENT 3.5
.sp
.EX
using IPv4 subnet %1, found host: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی شامل جزئیات میزبان یافت‌شده با استفاده از DHCPv4 subnet id است. آرگومان‌ها به ترتیب subnet id و جزئیات میزبان یافت‌شده را مشخص می‌کنند..SS HOSTS_CFG_GET_ALL_SUBNET_ID6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
get all hosts with reservations for IPv6 subnet %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگام شروع بازیابی تمام میزبان‌های متصل به
زیرشبکهٔ DHCPv6 مشخص صادر می‌شود. این آرگومان شناسهٔ زیرشبکه را مشخص می‌کند.
.SS HOSTS_CFG_GET_ALL_SUBNET_ID6_COUNT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
using IPv6 subnet %1, found %2 host(s)
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۵ ثبت می‌شود.
این پیام اشکال‌زدایی شامل جزئیات میزبان یافت‌شده با استفاده از شناسهٔ زیرشبکهٔ DHCPv6
است. آرگومان‌ها به‌ترتیب شناسهٔ زیرشبکه و تعداد میزبان‌های یافت‌شده را مشخص
می‌کنند.
.SS HOSTS_CFG_GET_ALL_SUBNET_ID6_HOST
.INDENT 0.0
.INDENT 3.5
.sp
.EX
using IPv6 subnet %1, found host: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی شامل جزئیات میزبان یافت‌شده با استفاده از شناسهٔ زیرشبکهٔ DHCPv6
است. آرگومان‌ها به‌ترتیب شناسهٔ زیرشبکه و جزئیات میزبان یافت‌شده را مشخص می‌کنند.
.SS HOSTS_CFG_GET_ALL_SUBNET_ID_ADDRESS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
get all hosts with reservations for subnet id %1 and IPv4 address %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگام شروع بازیابی تمام میزبان‌هایی که دارای رزرو برای
نشانی IPv4 داده‌شده در زیرشبکهٔ داده‌شده هستند، صادر می‌شود. آرگومان نخست
شناسهٔ زیرشبکه را مشخص می‌کند. آرگومان دوم نشانی IPv4 را که باید رزرو
برای آن بازگردانده شود، مشخص می‌کند.
.SS HOSTS_CFG_GET_ALL_SUBNET_ID_ADDRESS4_COUNT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
using IPv4 subnet %1 and IPv4 address %2, found %3 host(s)
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۵ ثبت می‌شود.
این پیام اشکال‌زدایی تعداد میزبان‌های یافت‌شده‌ای را که دارای رزرو برای نشانی IPv4
مشخص‌شده در زیرشبکهٔ مشخص‌شده هستند، ثبت می‌کند. آرگومان نخست شناسهٔ زیرشبکه را
مشخص می‌کند. آرگومان دوم نشانی IPv4 رزروشده را مشخص می‌کند. آرگومان سوم تعداد
میزبان‌های یافت‌شده را مشخص می‌کند.
.SS HOSTS_CFG_GET_ALL_SUBNET_ID_ADDRESS4_HOST
.INDENT 0.0
.INDENT 3.5
.sp
.EX
using IPv4 subnet %1 and IPv4 address %2, found host: %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی صادر می‌شود که میزبانی دارای رزرو برای نشانی IPv4
مشخص‌شده در زیرشبکهٔ مشخص‌شده پیدا شود. آرگومان نخست شناسهٔ زیرشبکه را مشخص
می‌کند. آرگومان دوم نشانی IPv4 رزروشده را مشخص می‌کند. آرگومان سوم جزئیات میزبان
را مشخص می‌کند.
.SS HOSTS_CFG_GET_ALL_SUBNET_ID_ADDRESS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
get all hosts with reservations for subnet id %1 and IPv6 address %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگام شروع بازیابی تمام میزبان‌های متصل به زیرشبکهٔ مشخص
صادر می‌شود که دارای نشانی IPv6 رزروشدهٔ مشخصی هستند. آرگومان‌ها به‌ترتیب
شناسهٔ زیرشبکه و نشانی IPv6 را مشخص می‌کنند.
.SS HOSTS_CFG_GET_ALL_SUBNET_ID_ADDRESS6_COUNT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
using subnet id %1 and address %2, found %3 host(s)
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۵ ثبت می‌شود.
این پیام اشکال‌زدایی شامل جزئیات میزبان یافت‌شده با استفاده از شناسهٔ زیرشبکه و
نشانی است. آرگومان‌ها به‌ترتیب شناسهٔ زیرشبکه، نشانی و تعداد میزبان‌های یافت‌شده
را مشخص می‌کنند.
.SS HOSTS_CFG_GET_ALL_SUBNET_ID_ADDRESS6_HOST
.INDENT 0.0
.INDENT 3.5
.sp
.EX
using subnet id %1 and address %2, found host: %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی شامل جزئیات میزبان یافت‌شده با استفاده از شناسهٔ زیرشبکه و
نشانی است. آرگومان‌ها به‌ترتیب شناسهٔ زیرشبکه، نشانی و جزئیات میزبان یافت‌شده
را مشخص می‌کنند..SS HOSTS_CFG_GET_ONE_PREFIX
.INDENT 0.0
.INDENT 3.5
.sp
.EX
get one host with reservation for prefix %1/%2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که بازیابی میزبانی با رزرو برای یک
پیشوند مشخص آغاز شود. آرگومان‌ها یک پیشوند و طول پیشوند را مشخص می‌کنند.
.SS HOSTS_CFG_GET_ONE_PREFIX_HOST
.INDENT 0.0
.INDENT 3.5
.sp
.EX
using prefix %1/%2, found host: %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی شامل جزئیات میزبان یافت‌شده با استفاده از پیشوند/طول
پیشوند مشخص است. آرگومان‌ها به ترتیب پیشوند، طول پیشوند و جزئیات میزبان را
مشخص می‌کنند.
.SS HOSTS_CFG_GET_ONE_PREFIX_NULL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
host not found using prefix %1/%2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که هیچ میزبانی برای پیشوند و طول
پیشوند مشخص‌شده یافت نشود.
.SS HOSTS_CFG_GET_ONE_SUBNET_ID_ADDRESS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
get one host with reservation for subnet id %1 and IPv4 address %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی صادر می‌شود که بازیابی میزبان متصل به زیرشبکه
مشخص و دارای آدرس IPv4 رزروشده خاص آغاز شود. آرگومان‌ها به ترتیب شناسه
زیرشبکه و آدرس IPv4 را مشخص می‌کنند.
.SS HOSTS_CFG_GET_ONE_SUBNET_ID_ADDRESS4_HOST
.INDENT 0.0
.INDENT 3.5
.sp
.EX
using subnet id %1 and address %2, found host: %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۵ ثبت می‌شود.
این پیام اشکال‌زدایی جزئیات میزبان یافت‌شده با استفاده از شناسه زیرشبکه
و آدرس IPv4 را ثبت می‌کند.
.SS HOSTS_CFG_GET_ONE_SUBNET_ID_ADDRESS4_NULL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
host not found using subnet id %1 and address %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۵ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که هیچ میزبانی برای شناسه زیرشبکه
و آدرس IPv4 مشخص‌شده یافت نشود.
.SS HOSTS_CFG_GET_ONE_SUBNET_ID_ADDRESS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
get one host with reservation for subnet id %1 and having IPv6 address %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی صادر می‌شود که بازیابی میزبان متصل به زیرشبکه
مشخص و دارای آدرس IPv6 رزروشده خاص آغاز شود. آرگومان‌ها به ترتیب شناسه
زیرشبکه و آدرس IPv6 را مشخص می‌کنند.
.SS HOSTS_CFG_GET_ONE_SUBNET_ID_ADDRESS6_HOST
.INDENT 0.0
.INDENT 3.5
.sp
.EX
using subnet id %1 and address %2, found host: %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۵ ثبت می‌شود.
این پیام اشکال‌زدایی جزئیات میزبان یافت‌شده با استفاده از شناسه زیرشبکه
و آدرس IPv6 را ثبت می‌کند.
.SS HOSTS_CFG_GET_ONE_SUBNET_ID_ADDRESS6_NULL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
host not found using subnet id %1 and address %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۵ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که هیچ میزبانی با استفاده از شناسه
زیرشبکه و آدرس IPv6 مشخص‌شده یافت نشود..SS HOSTS_CFG_GET_ONE_SUBNET_ID_IDENTIFIER
.INDENT 0.0
.INDENT 3.5
.sp
.EX
get one host with %1 reservation for subnet id %2, identified by %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که بازیابی میزبانی که دارای
رزروهای IPv4 یا IPv6 است، به زیرشبکه خاصی متصل بوده و با یک
شناسه یکتای مشخص شناسایی می‌شود، آغاز گردد. آرگومان نخست مشخص
می‌کند که آیا رزرو IPv4 مد نظر است یا IPv6.
.SS HOSTS_CFG_GET_ONE_SUBNET_ID_IDENTIFIER_HOST
.INDENT 0.0
.INDENT 3.5
.sp
.EX
using subnet id %1 and identifier %2, found host: %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۵ ثبت می‌شود.
این پیام اشکال‌زدایی شامل جزئیات میزبانی است که با استفاده از شناسه
زیرشبکه و شناسه میزبان مشخص یافت شده است.
.SS HOSTS_CFG_GET_ONE_SUBNET_ID_IDENTIFIER_NULL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
host not found using subnet id %1 and identifier %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۵ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که با استفاده از شناسه زیرشبکه
و شناسه میزبان مشخص‌شده هیچ میزبانی یافت نشود.
.SS HOSTS_CFG_UPDATE_ADD
.INDENT 0.0
.INDENT 3.5
.sp
.EX
add the host for reservations: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک میزبان جدید (همراه با رزروها)
در طول یک به‌روزرسانی به پیکربندی سرور افزوده شود. این آرگومان میزبان
و رزروهای آن را با جزئیات شرح می‌دهد.
.SS HOSTS_CFG_UPDATE_DEL4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted %1 host(s) for subnet id %2 and identifier %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که رزروهای IPv4 برای زیرشبکه
و شناسه مشخص‌شده در طول یک به‌روزرسانی حذف شوند. آرگومان نخست
مشخص می‌کند چه تعداد میزبان حذف شده‌اند. آرگومان دوم شناسه زیرشبکه
است. آرگومان سوم شناسه است.
.SS HOSTS_CFG_UPDATE_DEL6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted %1 host(s) having %2 IPv6 reservation(s) for subnet id %3 and identifier %4
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که رزروهای IPv6 برای زیرشبکه
و شناسه مشخص‌شده در طول یک به‌روزرسانی حذف شوند. آرگومان نخست
مشخص می‌کند چه تعداد میزبان حذف شده‌اند. آرگومان دوم مشخص می‌کند
چه تعداد رزرو حذف شده‌اند. آرگومان سوم شناسه زیرشبکه است. آرگومان
چهارم شناسه است.
.SS HOSTS_MGR_ALTERNATE_GET4_SUBNET_ID_ADDRESS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
trying alternate sources for host using subnet id %1 and address %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که Host Manager میزبان متصل
به زیرشبکه مشخص را که دارای رزرو برای نشانی IPv4 مشخص است پیدا
نمی‌کند، و جستجو برای این میزبان را در منابع داده میزبان جایگزین آغاز
می‌کند.
.SS HOSTS_MGR_ALTERNATE_GET4_SUBNET_ID_IDENTIFIER
.INDENT 0.0
.INDENT 3.5
.sp
.EX
get one host with IPv4 reservation for subnet id %1, identified by %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که بازیابی میزبانی که دارای
رزرو IPv4 است، به زیرشبکه خاصی متصل بوده و با یک شناسه یکتای
مشخص شناسایی می‌شود، آغاز گردد.
.SS HOSTS_MGR_ALTERNATE_GET4_SUBNET_ID_IDENTIFIER_HOST
.INDENT 0.0
.INDENT 3.5
.sp
.EX
using subnet id %1 and identifier %2, found in %3 host: %4
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۵ ثبت می‌شود.
این پیام اشکال‌زدایی شامل جزئیات میزبانی است که توسط یک منبع داده
میزبان‌های جایگزین با استفاده از یک شناسه زیرشبکه و شناسه میزبان
مشخص بازگردانده شده است..SS HOSTS_MGR_ALTERNATE_GET4_SUBNET_ID_IDENTIFIER_NULL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
host not found using subnet id %1 and identifier %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۵ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که با استفاده از شناسه زیرشبکه و شناسه میزبان مشخص‌شده، هیچ میزبانی یافت نشود.
.SS HOSTS_MGR_ALTERNATE_GET6_PREFIX
.INDENT 0.0
.INDENT 3.5
.sp
.EX
trying alternate sources for host using prefix %1/%2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که Host Manager میزبانی متصل به زیرشبکه مشخص را که دارای رزرو برای پیشوند تعیین‌شده باشد پیدا نکند، و جستجو برای این میزبان را در منابع داده جایگزین میزبان آغاز نماید.
.SS HOSTS_MGR_ALTERNATE_GET6_SUBNET_ID_ADDRESS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
trying alternate sources for host using subnet id %1 and IPv6 address %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که Host Manager میزبانی متصل به زیرشبکه مشخص را که دارای رزرو برای نشانی IPv6 تعیین‌شده باشد پیدا نکند، و جستجو برای این میزبان را در منابع داده جایگزین میزبان آغاز نماید.
.SS HOSTS_MGR_ALTERNATE_GET6_SUBNET_ID_IDENTIFIER
.INDENT 0.0
.INDENT 3.5
.sp
.EX
get one host with IPv6 reservation for subnet id %1, identified by %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگام شروع بازیابی میزبانی صادر می‌شود که دارای رزرو IPv4 بوده، به زیرشبکه‌ای مشخص متصل است و با یک شناسه یکتای معین شناسایی می‌شود.
.SS HOSTS_MGR_ALTERNATE_GET6_SUBNET_ID_IDENTIFIER_HOST
.INDENT 0.0
.INDENT 3.5
.sp
.EX
using subnet id %1 and identifier %2, found in %3 host: %4
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۵ ثبت می‌شود.
این پیام اشکال‌زدایی شامل جزئیات میزبانی است که توسط یک منبع داده جایگزین میزبان با استفاده از شناسه زیرشبکه و شناسه میزبان مشخص بازگردانده شده است.
.SS HOSTS_MGR_ALTERNATE_GET6_SUBNET_ID_IDENTIFIER_NULL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
host not found using subnet id %1 and identifier %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۵ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که با استفاده از شناسه زیرشبکه و شناسه میزبان مشخص‌شده، هیچ میزبانی یافت نشود.
.SS HOSTS_MGR_ALTERNATE_GET_ALL_SUBNET_ID_ADDRESS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
trying alternate sources for hosts using subnet id %1 and address %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که Host Manager جستجو برای میزبان‌ها را در منابع داده جایگزین میزبان بر اساس شناسه زیرشبکه و نشانی IPv4 آغاز می‌کند.
.SS HOSTS_MGR_ALTERNATE_GET_ALL_SUBNET_ID_ADDRESS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
trying alternate sources for hosts using subnet id %1 and address %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که Host Manager جستجو برای میزبان‌ها را در منابع داده جایگزین میزبان بر اساس شناسه زیرشبکه و نشانی IPv6 آغاز می‌کند.
.SS HOSTS_MGR_NON_UNIQUE_IP_UNSUPPORTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
host data source %1 does not support the mode in which IP reservations are non\-unique
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که مدیر سیستم تلاش کرده باشد کارساز را به گونه‌ای پیکربندی کند که چندین رزرو میزبان برای یک نشانی IP یا پیشوند یکسان مجاز باشد.
برخی از backendهای پایگاه‌داده میزبان ممکن است از این حالت عملکرد پشتیبانی نکنند. در این صورت مدیر سیستم باید استفاده از این backendها را متوقف کند یا به حالت پیش‌فرض که نیازمند یکتا بودن نشانی‌های IP درون یک زیرشبکه است بازگردد.
کارکرد این تنظیم برای backendهای میزبان MySQL و Postgres تضمین شده است..SS HOST
.SS HOST_CACHE_ADD
.INDENT 0.0
.INDENT 3.5
.sp
.EX
add host: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) 45 ثبت می‌شود.
این پیام اشکال‌زدایی جزئیات مدخل اضافه‌شده به حافظهٔ نهان (cache) میزبان را ثبت می‌کند.
.SS HOST_CACHE_ADD_DUPLICATE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
duplicate host: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) 45 ثبت می‌شود.
عملیات افزودن ناموفق بود زیرا این مدخل با مدخل موجود دیگری تداخل دارد. جزئیات آرگومان عملیات افزودن ثبت می‌شود.
.SS HOST_CACHE_COMMAND_CLEAR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
cache\-clear command successful
.EE
.UNINDENT
.UNINDENT
.sp
دستور cache\-clear موفقیت‌آمیز بوده است.
.SS HOST_CACHE_COMMAND_CLEAR_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
cache\-clear command failed (reason: %1)
.EE
.UNINDENT
.UNINDENT
.sp
دستور cache\-clear با شکست مواجه شد. علت آن ثبت می‌شود.
.SS HOST_CACHE_COMMAND_FLUSH
.INDENT 0.0
.INDENT 3.5
.sp
.EX
cache\-flush command successful
.EE
.UNINDENT
.UNINDENT
.sp
دستور cache\-flush موفقیت‌آمیز بوده است.
.SS HOST_CACHE_COMMAND_FLUSH_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
cache\-flush command failed (parameters: %1, reason: %2)
.EE
.UNINDENT
.UNINDENT
.sp
دستور cache\-flush با شکست مواجه شد. هم علت و هم پارامترهای ارسالی ثبت می‌شوند.
.SS HOST_CACHE_COMMAND_GET
.INDENT 0.0
.INDENT 3.5
.sp
.EX
cache\-get command successful (returned: %1)
.EE
.UNINDENT
.UNINDENT
.sp
دستور cache\-get موفقیت‌آمیز بوده است. تعداد مدخل‌های بازگردانده‌شده ثبت می‌شود.
.SS HOST_CACHE_COMMAND_GET_BY_ID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
cache\-get\-by\-id command successful (returned: %1)
.EE
.UNINDENT
.UNINDENT
.sp
دستور cache\-get\-by\-id موفقیت‌آمیز بوده است. تعداد مدخل‌های بازگردانده‌شده ثبت می‌شود.
.SS HOST_CACHE_COMMAND_GET_BY_ID_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
cache\-get\-by\-id command failed (reason: %1)
.EE
.UNINDENT
.UNINDENT
.sp
دستور cache\-get\-by\-id با شکست مواجه شد. علت آن ثبت می‌شود.
.SS HOST_CACHE_COMMAND_GET_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
cache\-get command failed (reason: %1)
.EE
.UNINDENT
.UNINDENT
.sp
دستور cache\-get با شکست مواجه شد. علت آن ثبت می‌شود.
.SS HOST_CACHE_COMMAND_INSERT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
cache\-insert command successful (inserted: %1, overwritten: %2)
.EE
.UNINDENT
.UNINDENT
.sp
دستور cache\-insert موفقیت‌آمیز بوده است. تعداد مدخل‌های درج‌شده و تعداد مدخل‌هایی که با موارد جدیدتر بازنویسی شده‌اند ثبت می‌شود..SS HOST_CACHE_COMMAND_INSERT_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
cache\-insert command failed (parameters: %1, reason: %2)
.EE
.UNINDENT
.UNINDENT
.sp
دستور cache\-insert ناموفق بود. هم علت و هم پارامترهای ارسال‌شده در گزارش ثبت می‌شوند.
.SS HOST_CACHE_COMMAND_LOAD
.INDENT 0.0
.INDENT 3.5
.sp
.EX
cache\-load command successful (loaded: %1, overwritten: %2)
.EE
.UNINDENT
.UNINDENT
.sp
دستور cache\-load با موفقیت انجام شد. تعداد مدخل‌های بارگذاری‌شده و تعداد مدخل‌هایی که با داده‌های جدیدتر رونویسی شده‌اند در گزارش ثبت می‌شوند.
.SS HOST_CACHE_COMMAND_LOAD_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
cache\-load command failed (parameters: %1, reason: %2)
.EE
.UNINDENT
.UNINDENT
.sp
دستور cache\-load ناموفق بود. هم علت و هم پارامترهای ارسال‌شده در گزارش ثبت می‌شوند.
.SS HOST_CACHE_COMMAND_REMOVE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
cache\-remove command successful (parameters: %1)
.EE
.UNINDENT
.UNINDENT
.sp
دستور cache\-remove با موفقیت انجام شد. پارامترهای میزبانِ حذف‌شده در گزارش ثبت می‌شوند.
.SS HOST_CACHE_COMMAND_REMOVE_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
cache\-remove command failed (parameters: %1, reason: %2)
.EE
.UNINDENT
.UNINDENT
.sp
دستور cache\-remove ناموفق بود. هم علت و هم پارامترهای ارسال‌شده در گزارش ثبت می‌شوند.
.SS HOST_CACHE_COMMAND_SIZE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
cache\-clear command successful: %1
.EE
.UNINDENT
.UNINDENT
.sp
دستور cache\-size با موفقیت انجام شد و تعداد مدخل‌های موجود در حافظهٔ نهان میزبان (host cache) را بازگرداند.
.SS HOST_CACHE_COMMAND_SIZE_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
cache\-size command failed (reason: %1)
.EE
.UNINDENT
.UNINDENT
.sp
دستور cache\-size ناموفق بود. دلیل آن در گزارش ثبت می‌شود.
.SS HOST_CACHE_COMMAND_WRITE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
cache\-write command successful (dumped: %1)
.EE
.UNINDENT
.UNINDENT
.sp
دستور cache\-write با موفقیت انجام شد. تعداد مدخل‌های ذخیره‌شده (تخلیه‌شده) در گزارش ثبت می‌شود.
.SS HOST_CACHE_COMMAND_WRITE_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
cache\-write command failed (parameters: %1, reason: %2)
.EE
.UNINDENT
.UNINDENT
.sp
دستور cache\-write ناموفق بود. هم علت و هم پارامترهای ارسال‌شده در گزارش ثبت می‌شوند.
.SS HOST_CACHE_CONFIGURATION_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to configure Host Cache hooks library: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که در پیکربندی کتابخانهٔ قلاب‌های Host Cache خطایی رخ دهد. آرگومان، پیام خطای دقیق را ارائه می‌دهد.
.SS HOST_CACHE_DEINIT_OK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
unloading Host Cache hooks library successful
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که کتابخانهٔ قلاب‌های Host Cache با موفقیت از حافظه تخلیه شده است..SS HOST_CACHE_DEL_SUBNET_ID_ADDRESS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
using subnet id %1 and address %2, delete host: %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۵ ثبت می‌شود.
این پیام اشکال‌زدایی، جزئیات مدخل کَش میزبانی را که با استفاده از شناسهٔ زیرشبکه (subnet id) و نشانی IPv4 حذف شده است، ثبت می‌کند.
.SS HOST_CACHE_DEL_SUBNET_ID_ADDRESS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
using subnet id %1 and address %2, delete host: %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۵ ثبت می‌شود.
این پیام اشکال‌زدایی، جزئیات مدخل کَش میزبانی را که با استفاده از شناسهٔ زیرشبکه (subnet id) و نشانی IPv6 حذف شده است، ثبت می‌کند.
.SS HOST_CACHE_DEL_SUBNET_ID_IDENTIFIER4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
using subnet id %1 and identifier %2, delete host: %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۵ ثبت می‌شود.
این پیام اشکال‌زدایی، جزئیات مدخل کَش میزبانی را که با استفاده از شناسهٔ زیرشبکه و شناسهٔ میزبان مشخص حذف شده است، ثبت می‌کند.
.SS HOST_CACHE_DEL_SUBNET_ID_IDENTIFIER6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
using subnet id %1 and identifier %2, delete host: %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۵ ثبت می‌شود.
این پیام اشکال‌زدایی، جزئیات مدخل کَش میزبانی را که با استفاده از شناسهٔ زیرشبکه و شناسهٔ میزبان مشخص حذف شده است، ثبت می‌کند.
.SS HOST_CACHE_GET_ONE_PREFIX
.INDENT 0.0
.INDENT 3.5
.sp
.EX
get one host with reservation for prefix %1/%2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی صادر می‌شود که بازیابی یک مدخل کَش میزبان دارای رزرو برای یک پیشوند مشخص آغاز گردد. آرگومان‌ها یک پیشوند و طول پیشوند را مشخص می‌کنند.
.SS HOST_CACHE_GET_ONE_PREFIX_HOST
.INDENT 0.0
.INDENT 3.5
.sp
.EX
using prefix %1/%2, found host: %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۵ ثبت می‌شود.
این پیام اشکال‌زدایی شامل جزئیات مدخل کَش میزبان یافت‌شده با استفاده از پیشوند/طول پیشوند مشخص است. آرگومان‌ها به ترتیب پیشوند، طول پیشوند و جزئیات میزبان را مشخص می‌کنند.
.SS HOST_CACHE_GET_ONE_SUBNET_ID_ADDRESS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
get one host with reservation for subnet id %1 and IPv4 address %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی صادر می‌شود که بازیابی یک مدخل کَش میزبان متصل به زیرشبکهٔ مشخص و دارای نشانی IPv4 رزروشدهٔ مشخص آغاز گردد. آرگومان‌ها به ترتیب شناسهٔ زیرشبکه و نشانی IPv4 را مشخص می‌کنند.
.SS HOST_CACHE_GET_ONE_SUBNET_ID_ADDRESS4_HOST
.INDENT 0.0
.INDENT 3.5
.sp
.EX
using subnet id %1 and address %2, found host: %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۵ ثبت می‌شود.
این پیام اشکال‌زدایی، جزئیات مدخل کَش میزبانی را که با استفاده از شناسهٔ زیرشبکه و نشانی IPv4 یافت شده است، ثبت می‌کند.
.SS HOST_CACHE_GET_ONE_SUBNET_ID_ADDRESS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
get one host with reservation for subnet id %1 and including IPv6 address %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی صادر می‌شود که بازیابی یک مدخل کَش میزبان متصل به زیرشبکهٔ مشخص و دارای نشانی IPv6 رزروشدهٔ مشخص آغاز گردد. آرگومان‌ها به ترتیب شناسهٔ زیرشبکه و نشانی IPv6 را مشخص می‌کنند..SS HOST_CACHE_GET_ONE_SUBNET_ID_ADDRESS6_HOST
.INDENT 0.0
.INDENT 3.5
.sp
.EX
using subnet id %1 and address %2, found host: %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۵ ثبت می‌شود.
این پیام اشکال‌زدایی، جزئیات مدخل حافظه موقت میزبان (host cache) را که با استفاده از subnet id و نشانی IPv6 پیدا شده است، در گزارش ثبت می‌کند.
.SS HOST_CACHE_GET_ONE_SUBNET_ID_IDENTIFIER
.INDENT 0.0
.INDENT 3.5
.sp
.EX
get one host with %1 reservation for subnet id %2, identified by %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگام آغاز بازیابی یک مدخل حافظه موقت میزبانِ دارای رزروهای IPv4 یا IPv6 صادر می‌شود که به یک زیرشبکه خاص متصل بوده و با یک شناسه یکتای مشخص شناسایی می‌شود. آرگومان نخست تعیین می‌کند که آیا رزرو IPv4 مد نظر است یا IPv6.
.SS HOST_CACHE_GET_ONE_SUBNET_ID_IDENTIFIER_HOST
.INDENT 0.0
.INDENT 3.5
.sp
.EX
using subnet id %1 and identifier %2, found host: %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۵ ثبت می‌شود.
این پیام اشکال‌زدایی شامل جزئیات مدخل حافظه موقت میزبانی است که با استفاده از یک subnet id و شناسه خاص میزبان پیدا شده است.
.SS HOST_CACHE_INIT_OK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
loading Host Cache hooks library successful
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی (info) نشان می‌دهد که کتابخانه قلاب‌های (hooks) بخش Host Cache با موفقیت بارگذاری شده است. لذت ببرید!
.SS HOST_CACHE_PATH_SECURITY_WARNING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Cache file path specified is NOT SECURE: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که اعمال تدابیر امنیتی غیرفعال بوده و مسیر مشخص‌شده برای فایل حافظه موقت میزبان با مسیر پشتیبانی‌شده مطابقت ندارد. کارگزار همچنان از مسیر مشخص‌شده استفاده خواهد کرد، اما هشدار می‌دهد که این کار ممکن است خطرات امنیتی ایجاد کند.
.SS HOST_CMDS_DEINIT_OK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
unloading Host Commands hooks library successful
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی نشان می‌دهد که کتابخانه قلاب‌های Host Commands با موفقیت تخلیه (حذف) شده است.
.SS HOST_CMDS_INIT_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
loading Host Commands hooks library failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا بیانگر بروز خطا هنگام بارگذاری کتابخانه قلاب‌های Host Commands است. جزئیات خطا به عنوان آرگومان در پیام گزارش ارائه شده است.
.SS HOST_CMDS_INIT_OK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
loading Host Commands hooks library successful
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی نشان می‌دهد که کتابخانه قلاب‌های Host Commands با موفقیت بارگذاری شده است. لذت ببرید!
.SS HOST_CMDS_RESERV_ADD
.INDENT 0.0
.INDENT 3.5
.sp
.EX
reservation\-add command called (parameters: %1)
.EE
.UNINDENT
.UNINDENT
.sp
دستور reservation\-add فراخوانی شده است. پارامترهای ارسالی در گزارش ثبت می‌شوند.
.SS HOST_CMDS_RESERV_ADD_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
reservation\-add command failed (parameters: %1, reason: %2)
.EE
.UNINDENT
.UNINDENT
.sp
دستور reservation\-add با شکست مواجه شد. هم دلیل و هم پارامترهای ارسالی در گزارش ثبت می‌شوند..SS HOST_CMDS_RESERV_ADD_SUCCESS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
reservation\-add command success (parameters: %1)
.EE
.UNINDENT
.UNINDENT
.sp
دستور reservation\-add با موفقیت انجام شد. پارامترهای ارسال‌شده ثبت می‌شوند.
.SS HOST_CMDS_RESERV_DEL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
reservation\-del command called (parameters: %1)
.EE
.UNINDENT
.UNINDENT
.sp
دستور reservation\-del فراخوانی شد. پارامترهای ارسال‌شده ثبت می‌شوند.
.SS HOST_CMDS_RESERV_DEL_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
reservation\-del command failed (parameters: %1, reason: %2)
.EE
.UNINDENT
.UNINDENT
.sp
دستور reservation\-del با شکست مواجه شد. هم دلیل و هم پارامترهای ارسال‌شده ثبت می‌شوند.
.SS HOST_CMDS_RESERV_DEL_SUCCESS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
reservation\-del command success (parameters: %1)
.EE
.UNINDENT
.UNINDENT
.sp
دستور reservation\-del با موفقیت انجام شد. پارامترهای ارسال‌شده ثبت می‌شوند.
.SS HOST_CMDS_RESERV_GET
.INDENT 0.0
.INDENT 3.5
.sp
.EX
reservation\-get command called (parameters: %1)
.EE
.UNINDENT
.UNINDENT
.sp
دستور reservation\-get فراخوانی شد. پارامترهای ارسال‌شده ثبت می‌شوند.
.SS HOST_CMDS_RESERV_GET_ALL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
reservation\-get\-all command called (parameters: %1)
.EE
.UNINDENT
.UNINDENT
.sp
دستور reservation\-get\-all فراخوانی شد. پارامترهای ارسال‌شده ثبت می‌شوند.
.SS HOST_CMDS_RESERV_GET_ALL_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
reservation\-get\-all command failed (parameters: %1, reason: %2)
.EE
.UNINDENT
.UNINDENT
.sp
دستور reservation\-get\-all با شکست مواجه شد. هم دلیل و هم پارامترهای ارسال‌شده ثبت می‌شوند.
.SS HOST_CMDS_RESERV_GET_ALL_SUCCESS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
reservation\-get\-all command success (parameters: %1)
.EE
.UNINDENT
.UNINDENT
.sp
دستور reservation\-get\-all با موفقیت انجام شد. پارامترهای ارسال‌شده ثبت می‌شوند.
.SS HOST_CMDS_RESERV_GET_BY_ADDRESS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
reservation\-get\-by\-address command called (parameters: %1)
.EE
.UNINDENT
.UNINDENT
.sp
دستور reservation\-get\-by\-address فراخوانی شد. پارامترهای ارسال‌شده ثبت می‌شوند.
.SS HOST_CMDS_RESERV_GET_BY_ADDRESS_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
reservation\-get\-by\-address command failed (parameters: %1, reason: %2)
.EE
.UNINDENT
.UNINDENT
.sp
دستور reservation\-get\-by\-address با شکست مواجه شد. هم دلیل و هم پارامترهای ارسال‌شده ثبت می‌شوند.
.SS HOST_CMDS_RESERV_GET_BY_ADDRESS_SUCCESS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
reservation\-get\-by\-address command success (parameters: %1)
.EE
.UNINDENT
.UNINDENT
.sp
دستور reservation\-get\-by\-address با موفقیت انجام شد. پارامترهای ارسال‌شده ثبت می‌شوند..SS HOST_CMDS_RESERV_GET_BY_HOSTNAME
.INDENT 0.0
.INDENT 3.5
.sp
.EX
reservation\-get\-by\-hostname command called (parameters: %1)
.EE
.UNINDENT
.UNINDENT
.sp
دستور reservation\-get\-by\-hostname فراخوانی شده است. پارامترهای ارسال‌شده ثبت می‌شوند.
.SS HOST_CMDS_RESERV_GET_BY_HOSTNAME_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
reservation\-get\-by\-hostname command failed (parameters: %1, reason: %2)
.EE
.UNINDENT
.UNINDENT
.sp
دستور reservation\-get\-by\-hostname شکست خورده است. هم دلیل و هم
پارامترهای ارسال‌شده ثبت می‌شوند.
.SS HOST_CMDS_RESERV_GET_BY_HOSTNAME_SUCCESS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
reservation\-get\-by\-hostname command success (parameters: %1)
.EE
.UNINDENT
.UNINDENT
.sp
دستور reservation\-get\-by\-hostname موفقیت‌آمیز بوده است. پارامترهای ارسال‌شده ثبت می‌شوند.
.SS HOST_CMDS_RESERV_GET_BY_ID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
reservation\-get\-by\-id command called (parameters: %1)
.EE
.UNINDENT
.UNINDENT
.sp
دستور reservation\-get\-by\-id فراخوانی شده است. پارامترهای ارسال‌شده ثبت می‌شوند.
.SS HOST_CMDS_RESERV_GET_BY_ID_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
reservation\-get\-by\-id command failed (parameters: %1, reason: %2)
.EE
.UNINDENT
.UNINDENT
.sp
دستور reservation\-get\-by\-id شکست خورده است. هم دلیل و هم
پارامترهای ارسال‌شده ثبت می‌شوند.
.SS HOST_CMDS_RESERV_GET_BY_ID_SUCCESS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
reservation\-get\-by\-id command success (parameters: %1)
.EE
.UNINDENT
.UNINDENT
.sp
دستور reservation\-get\-by\-id موفقیت‌آمیز بوده است. پارامترهای ارسال‌شده ثبت می‌شوند.
.SS HOST_CMDS_RESERV_GET_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
reservation\-get command failed (parameters: %1, reason: %2)
.EE
.UNINDENT
.UNINDENT
.sp
دستور reservation\-add شکست خورده است. هم دلیل و هم
پارامترهای ارسال‌شده ثبت می‌شوند.
.SS HOST_CMDS_RESERV_GET_PAGE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
reservation\-get\-page command called (parameters: %1)
.EE
.UNINDENT
.UNINDENT
.sp
دستور reservation\-get\-page فراخوانی شده است. پارامترهای ارسال‌شده ثبت می‌شوند.
.SS HOST_CMDS_RESERV_GET_PAGE_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
reservation\-get\-page command failed (parameters: %1, reason: %2)
.EE
.UNINDENT
.UNINDENT
.sp
دستور reservation\-get\-page شکست خورده است. هم دلیل و هم
پارامترهای ارسال‌شده ثبت می‌شوند.
.SS HOST_CMDS_RESERV_GET_PAGE_SUCCESS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
reservation\-get\-page command success (parameters: %1)
.EE
.UNINDENT
.UNINDENT
.sp
دستور reservation\-get\-page موفقیت‌آمیز بوده است. پارامترهای ارسال‌شده ثبت می‌شوند.
.SS HOST_CMDS_RESERV_GET_SUCCESS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
reservation\-get command success (parameters: %1)
.EE
.UNINDENT
.UNINDENT
.sp
دستور reservation\-get موفقیت‌آمیز بوده است. پارامترهای ارسال‌شده ثبت می‌شوند..SS HOST_CMDS_RESERV_UPDATE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
reservation\-update command called (parameters: %1)
.EE
.UNINDENT
.UNINDENT
.sp
دستور reservation\-update فراخوانی شده است. پارامترهای ارائه‌شده ثبت می‌شوند.
.SS HOST_CMDS_RESERV_UPDATE_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
reservation\-update command failed (parameters: %1, reason: %2)
.EE
.UNINDENT
.UNINDENT
.sp
دستور reservation\-update با شکست مواجه شده است. هم دلیل و هم پارامترهای ارائه‌شده ثبت می‌شوند.
.SS HOST_CMDS_RESERV_UPDATE_SUCCESS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
reservation\-update command success (parameters: %1)
.EE
.UNINDENT
.UNINDENT
.sp
دستور reservation\-update موفقیت‌آمیز بوده است. پارامترهای ارائه‌شده ثبت می‌شوند.
.SS HTTPS
.SS HTTPS_REQUEST_RECEIVE_START
.INDENT 0.0
.INDENT 3.5
.sp
.EX
start receiving request from %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug log level) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور شروع به دریافت درخواست جدیدی از طریق اتصال برقرارشده می‌کند. این آرگومان آدرس نقطه پایانی دوردست (remote endpoint) را مشخص می‌کند.
.SS HTTP
.SS HTTP_BAD_CLIENT_REQUEST_RECEIVED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
bad request received from %1: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug log level) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک کلاینت HTTP درخواستی بدریخت (malformed) به سرور ارسال کند. این شامل درخواست‌های HTTP با نوع محتوای (content type) غیرمنتظره، از جمله JSON بدریخت و غیره است. آرگومان نخست آدرس نقطه پایانی دوردست ارسال‌کننده درخواست را مشخص می‌کند. آرگومان دوم پیام خطای تفصیلی را ارائه می‌دهد.
.SS HTTP_BAD_CLIENT_REQUEST_RECEIVED_DETAILS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
detailed information about bad request received from %1:\en%2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug log level) ۴۵ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک کلاینت HTTP درخواستی بدریخت به سرور ارسال کند. این پیام شامل اطلاعات تفصیلی درباره درخواست دریافتی ردشده توسط سرور است. آرگومان نخست آدرس نقطه پایانی دوردست ارسال‌کننده درخواست را مشخص می‌کند. آرگومان دوم درخواست را در قالب متنی ارائه می‌دهد. اگر درخواست برای چاپ شدن بیش از حد بزرگ باشد، توسط ثبت‌کننده وقایع (logger) کوتاه‌سازی می‌شود.
.SS HTTP_BAD_SERVER_RESPONSE_RECEIVED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
bad response received when communicating with %1: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug log level) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک کلاینت HTTP در دریافت پاسخ از سرور ناکام بماند یا هنگامی که این پاسخ بدریخت باشد. آرگومان نخست URL سرور را مشخص می‌کند. آرگومان دوم پیام خطای تفصیلی را ارائه می‌دهد.
.SS HTTP_BAD_SERVER_RESPONSE_RECEIVED_DETAILS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
detailed information about bad response received from %1:\en%2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug log level) ۴۵ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک کلاینت HTTP پاسخی بدریخت از سرور دریافت کند. آرگومان نخست URL سرور را مشخص می‌کند. آرگومان دوم پاسخ را در قالب متنی ارائه می‌دهد. اگر درخواست برای چاپ شدن بیش از حد بزرگ باشد، توسط ثبت‌کننده وقایع (logger) کوتاه‌سازی می‌شود.
.SS HTTP_CLIENT_MT_STARTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
HttpClient has been started in multi\-threaded mode running %1 threads
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug log level) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک نمونه چندنخی (multi\-threaded) از کلاینت HTTP ایجاد شده باشد. آرگومان حداکثر تعداد نخ‌ها را مشخص می‌کند..SS HTTP_CLIENT_PASSWORD_SECURITY_WARNING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
use of clear text \(aqpassword\(aq is NOT SECURE: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که اعمال امنیت غیرفعال باشد و پیکربندی سوکت فرمان به‌جای \(aqpassword\-file\(aq از متن آشکار \(aqpassword\(aq استفاده کند. کارگزار همچنان از سوکت به همان صورت پیکربندی‌شده استفاده خواهد کرد، اما هشدار می‌دهد که این کار ممکن است خطرات امنیتی در پی داشته باشد.
.SS HTTP_CLIENT_QUEUE_SIZE_GROWING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
queue for URL: %1, now has %2 entries and may be growing too quickly
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که به نظر می‌رسد صف درخواست‌های در انتظار برای URL داده‌شده سریع‌تر از توان پردازش درخواست‌ها رشد می‌کند. تا زمانی که اندازهٔ صف به رشد خود ادامه دهد، این پیام به‌صورت دوره‌ای صادر خواهد شد. این وضعیت ممکن است با هجوم ناگهانی ترافیک کلاینت‌ها رخ دهد که یک انباشتگی موقت ایجاد می‌کند و پس از فرونشستن ترافیک فروکش می‌کند. اگر این اتفاق به‌طور مداوم رخ دهد، به احتمال زیاد نشان‌دهندهٔ پیکربندی استقراری است که نمی‌تواند بار کاری کلاینت‌ها را تاب بیاورد.
.SS HTTP_CLIENT_REQUEST_AUTHORIZED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
received HTTP request authorized for \(aq%1\(aq
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی زمانی صادر می‌شود که کارگزار درخواستی با سرآیند احراز هویت منطبق دریافت کند. آرگومان، شناسهٔ کاربر (user id) را ارائه می‌دهد.
.SS HTTP_CLIENT_REQUEST_BAD_AUTH_HEADER
.INDENT 0.0
.INDENT 3.5
.sp
.EX
received HTTP request with malformed authentication header: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی زمانی صادر می‌شود که کارگزار درخواستی با یک سرآیند احراز هویت بدریخت (malformed) دریافت کند. آرگومان مشکل را توضیح می‌دهد.
.SS HTTP_CLIENT_REQUEST_NOT_AUTHORIZED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
received HTTP request with not matching authentication header
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی زمانی صادر می‌شود که کارگزار درخواستی با سرآیند احراز هویت حاوی گواهی‌نامهٔ ناشناخته دریافت کند: کاربر شناسهٔ کاربری و/یا گذرواژهٔ نادرستی ارائه کرده است.
.SS HTTP_CLIENT_REQUEST_NO_AUTH_HEADER
.INDENT 0.0
.INDENT 3.5
.sp
.EX
received HTTP request without required authentication header
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی زمانی صادر می‌شود که کارگزار درخواستی فاقد سرآیند احراز هویت الزامی دریافت کند.
.SS HTTP_CLIENT_REQUEST_RECEIVED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
received HTTP request from %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) 40 ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که دریافت درخواست HTTP از نقطهٔ پایانی راه دور (remote endpoint) توسط کارگزار به پایان رسیده باشد. نشانی نقطهٔ پایانی راه دور به عنوان یک آرگومان مشخص شده است.
.SS HTTP_CLIENT_REQUEST_RECEIVED_DETAILS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
detailed information about well\-formed request received from %1:\en%2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) 45 ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارگزار HTTP درخواستی خوش‌قالب (well\-formed) دریافت کند. این پیام شامل اطلاعات تفصیلی دربارهٔ درخواست دریافتی است. آرگومان اول، نشانی نقطهٔ پایانی راه دور را که درخواست را ارسال کرده است مشخص می‌کند. آرگومان دوم، درخواست را در قالب متنی ارائه می‌دهد. اگر درخواست برای چاپ‌شدن بیش از حد بزرگ باشد، توسط ثبت‌کنندهٔ لاگ بریده (truncated) می‌شود.
.SS HTTP_CLIENT_REQUEST_SEND
.INDENT 0.0
.INDENT 3.5
.sp
.EX
sending HTTP request %1 to %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) 50 ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کلاینت شروع به ارسال یک درخواست HTTP به کارگزار می‌کند. آرگومان اول، اطلاعات پایه دربارهٔ درخواست (شماره نسخهٔ HTTP و کد وضعیت) را نگه می‌دارد. آرگومان دوم URL کارگزار را مشخص می‌کند..SS HTTP_CLIENT_REQUEST_SEND_DETAILS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
detailed information about request sent to %1:\en%2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی درست پیش از ارسال یک درخواست HTTP توسط کلاینت به
سرور صادر می‌شود. این پیام شامل اطلاعات دقیقی دربارهٔ درخواست است. آرگومان
نخست، URL سروری را که درخواست به آن ارسال می‌شود مشخص می‌کند. آرگومان دوم
درخواست را به شکل متنی ارائه می‌دهد. اگر اندازهٔ درخواست برای چاپ شدن بیش از
حد بزرگ باشد، توسط ثبت‌کنندهٔ گزارش کوتاه (truncate) می‌شود.
.SS HTTP_CLIENT_REQUEST_TIMEOUT_OCCURRED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
HTTP request timeout occurred when communicating with %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که مهلت زمانی درخواست HTTP به پایان
رسیده باشد و سرور قصد داشته باشد پاسخی حاوی کد وضعیت اتمام مهلت زمانی
درخواست (Http Request timeout) ارسال کند.
.SS HTTP_CLIENT_USER_SECURITY_WARNING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
use of clear text \(aquser\(aq is NOT SECURE: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که الزامات امنیتی غیرفعال شده باشند
و در پیکربندی سوکت فرمان به‌جای \(aquser\-file\(aq از متن آشکار \(aquser\(aq
استفاده شده باشد. سرور همچنان طبق پیکربندی از سوکت استفاده خواهد کرد،
اما هشدار می‌دهد که انجام این کار ممکن است خطرات امنیتی در پی داشته باشد.
.SS HTTP_COMMAND_MGR_HTTPS_SERVICE_REUSE_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to reused HTTPS service bound to address: %1 port: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا بیانگر آن است که سرور نتوانسته از سرویس HTTPS موجود روی آدرس
و درگاه (port) مشخص‌شده دوباره استفاده کند. سرور نمی‌تواند با استفاده از همان
آدرس و درگاه، از سوکت‌های HTTPS به HTTP تغییر وضعیت دهد.
.SS HTTP_COMMAND_MGR_HTTPS_SERVICE_UPDATED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
reused HTTPS service bound to address: %1 port: %2 and updated TLS settings
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی نشان می‌دهد که سرور از سرویس HTTPS موجود روی آدرس
و درگاه مشخص‌شده مجدداً استفاده کرده است. توجه داشته باشید که هرگونه تغییر در
پیکربندی TLS اعمال شده است.
.SS HTTP_COMMAND_MGR_HTTP_SERVICE_REUSE_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to reused HTTP service bound to address: %1 port: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا بیانگر آن است که سرور نتوانسته از سرویس HTTP موجود روی آدرس
و درگاه مشخص‌شده دوباره استفاده کند. سرور نمی‌تواند با استفاده از همان آدرس و
درگاه، از سوکت‌های HTTP به HTTPS تغییر وضعیت دهد.
.SS HTTP_COMMAND_MGR_HTTP_SERVICE_UPDATED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
reused HTTP service bound to address: %1 port: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی نشان می‌دهد که سرور از سرویس HTTP موجود روی آدرس
و درگاه مشخص‌شده مجدداً استفاده کرده است.
.SS HTTP_COMMAND_MGR_SERVICE_STARTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
started %1 service bound to address: %2 port: %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی نشان می‌دهد که سرور سرویس HTTP/HTTPS را روی آدرس
و درگاه مشخص‌شده برای دریافت دستورات کنترلی راه‌اندازی کرده است.
.SS HTTP_COMMAND_MGR_SERVICE_STOPPING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Server is stopping %1 service %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی بیانگر آن است که سرور سرویس HTTP/HTTPS را متوقف کرده است.
در صورت مشخص بودن، آدرس و درگاه نمایش داده می‌شوند..SS HTTP_CONNECTION_CLOSE_CALLBACK_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Connection close callback threw an exception
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی صادر می‌شود که فراخوان بازگشتی (callback) بستن اتصال که روی اتصال ثبت شده است، به‌طور غیرمنتظره‌ای با شکست مواجه شود. این یک خطای برنامه‌نویسی است و باید به عنوان یک باگ گزارش شود.
.SS HTTP_CONNECTION_HANDSHAKE_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
TLS handshake with %1 failed with %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی زمانی صادر می‌شود که دست‌تکانی TLS در سمت سرور با شکست مواجه شود. آدرس کلاینت و پیام خطا نمایش داده می‌شوند.
.SS HTTP_CONNECTION_HANDSHAKE_START
.INDENT 0.0
.INDENT 3.5
.sp
.EX
start TLS handshake with %1 with timeout %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور دست‌تکانی TLS را با نقطه پایانی دوردست (remote endpoint) آغاز می‌کند. آرگومان نخست، آدرس نقطه پایانی دوردست را مشخص می‌کند. آرگومان دوم، مهلت زمانی (timeout) درخواست را بر حسب ثانیه تعیین می‌کند.
.SS HTTP_CONNECTION_SHUTDOWN
.INDENT 0.0
.INDENT 3.5
.sp
.EX
shutting down HTTP connection from %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یکی از اتصالات HTTP خاموش (shut down) شود. اتصال ممکن است در نتیجه یک خطا یا پس از تبادل موفقیت‌آمیز پیام با یک کلاینت متوقف شود.
.SS HTTP_CONNECTION_SHUTDOWN_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
shutting down HTTP connection failed
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که در حین خاموش‌سازی (shutting down) یک اتصال HTTP با یک کلاینت، خطایی رخ داده باشد.
.SS HTTP_CONNECTION_STOP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
stopping HTTP connection from %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یکی از اتصالات HTTP متوقف شود. اتصال ممکن است در نتیجه یک خطا یا پس از تبادل موفقیت‌آمیز پیام با یک کلاینت متوقف شود.
.SS HTTP_CONNECTION_STOP_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
stopping HTTP connection failed
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که در حین بستن یک اتصال HTTP با یک کلاینت، خطایی رخ داده باشد.
.SS HTTP_CONNECTION_WATCH_SOCKET_CLEAR_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
clearing connection watch socket failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که در حین پاک‌سازی سوکت پایش (watch socket) مرتبط با یک اتصال HTTP با یک کلاینت، خطایی رخ دهد. خطا نمایش داده می‌شود.
.SS HTTP_CONNECTION_WATCH_SOCKET_CLOSE_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
closing connection watch socket failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که در حین بستن سوکت پایش (watch socket) مرتبط با یک اتصال HTTP با یک کلاینت، خطایی رخ دهد. خطا نمایش داده می‌شود.
.SS HTTP_CONNECTION_WATCH_SOCKET_MARK_READY_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
marking ready connection watch socket failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که در حین علامت‌گذاری سوکت پایش (watch socket) مرتبط با یک اتصال HTTP با یک کلاینت به عنوان آماده (ready)، خطایی رخ دهد. خطا نمایش داده می‌شود..SS HTTP_DATA_RECEIVED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
received %1 bytes from %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی 55 ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارگزار تکه‌ای از داده را از
نقطه پایانی راه دور (remote endpoint) دریافت کند. این داده ممکن است شامل کل درخواست یا تنها بخشی
از آن باشد. آرگومان نخست، میزان داده دریافتی را مشخص می‌کند.
آرگومان دوم، آدرس نقطه پایانی راه دور تولیدکننده داده را تعیین می‌کند.
.SS HTTP_IDLE_CONNECTION_TIMEOUT_OCCURRED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
closing persistent connection with %1 as a result of a timeout
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی 50 ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که اتصال پایدار (persistent) در HTTP به علت
بیکار ماندن بسته شود.
.SS HTTP_PREMATURE_CONNECTION_TIMEOUT_OCCURRED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
premature connection timeout occurred: in transaction ? %1, transid: %2, current_transid: %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که وقفه زمانی (timeout) غیرمنتظره‌ای در حین
تراکنش رخ دهد. اثبات شده است که این مورد هنگام تغییر دستی ساعت سیستم
یا در نتیجه همگام‌سازی با یک کارگزار زمان (time server) رخ می‌دهد. هرگونه تراکنش
در حال اجرا متوقف خواهد شد. تراکنش‌های جدید باید به شکل عادی انجام شوند.
.SS HTTP_REQUEST_RECEIVE_START
.INDENT 0.0
.INDENT 3.5
.sp
.EX
start receiving request from %1 with timeout %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی 50 ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارگزار دریافت درخواست جدیدی را
روی اتصال برقرارشده آغاز کند. آرگومان نخست، آدرس
نقطه پایانی راه دور را مشخص می‌کند. آرگومان دوم، مهلت زمانی درخواست را
بر حسب ثانیه تعیین می‌کند.
.SS HTTP_SERVER_RESPONSE_RECEIVED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
received HTTP response from %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی 40 ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کلاینت دریافت پاسخ HTTP
از کارگزار را به پایان رسانده باشد. URL کارگزار به عنوان آرگومان مشخص شده است.
.SS HTTP_SERVER_RESPONSE_RECEIVED_DETAILS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
detailed information about well\-formed response received from %1:\en%2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی 45 ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کلاینت HTTP یک پاسخ با ساختار صحیح (well\-formed)
از کارگزار دریافت کند. این پیام شامل اطلاعات تفصیلی درباره پاسخ
دریافت‌شده است. آرگومان نخست، URL کارگزاری که پاسخ را ارسال کرده مشخص می‌کند.
آرگومان دوم، پاسخ را در قالب متنی فراهم می‌آورد.
در صورتی که پاسخ برای چاپ بیش از حد بزرگ باشد، توسط سیستم ثبت گزارش (logger) کوتاه می‌شود.
.SS HTTP_SERVER_RESPONSE_SEND
.INDENT 0.0
.INDENT 3.5
.sp
.EX
sending HTTP response %1 to %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی 40 ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارگزار شروع به ارسال پاسخ HTTP
به یک نقطه پایانی راه دور کند. آرگومان نخست شامل اطلاعات پایه
درباره پاسخ است (شماره نسخه HTTP و کد وضعیت). آرگومان
دوم، آدرس نقطه پایانی راه دور را مشخص می‌کند.
.SS HTTP_SERVER_RESPONSE_SEND_DETAILS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
detailed information about response sent to %1:\en%2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی 45 ثبت می‌شود.
این پیام اشکال‌زدایی درست پیش از آنکه کارگزار پاسخ HTTP را به کلاینت
ارسال کند صادر می‌شود. این پیام شامل اطلاعات تفصیلی درباره پاسخ است.
آرگومان نخست، آدرس نقطه پایانی راه دور را که پاسخ به آن
ارسال می‌شود مشخص می‌کند. آرگومان دوم، پاسخ را در قالب متنی فراهم می‌آورد.
اگر پاسخ برای چاپ بیش از حد بزرگ باشد، توسط ثبت‌کننده وقایع کوتاه می‌شود..SS KEY
.SS KEY_LOOKUP_DISABLED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
hooks library lookup for a key: GSS\-TSIG is not enabled for the current DNS server.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که جستجو برای یک کلید GSS\-TSIG برای
یک سرور DNS که GSS\-TSIG روی آن فعال نیست، انجام شده باشد.
.SS KEY_LOOKUP_FOUND
.INDENT 0.0
.INDENT 3.5
.sp
.EX
hooks library lookup for a key: return GSS\-TSIG key \(aq%1\(aq.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که جستجو برای کلید GSS\-TSIG،
کلید قابل استفاده‌ای را برای محافظت از به‌روزرسانی DNS بازگردانده باشد. نام کلید نمایش داده می‌شود.
.SS KEY_LOOKUP_NONE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
hooks library lookup for a key: found no usable key.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که جستجو برای کلید GSS\-TSIG در یافتن
یک کلید قابل استفاده ناموفق باشد.
.SS KEY_PROCESSING_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
The GSS\-TKEY processing for server %1 failed because of an error: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که پردازش کلید برای یک سرور خاص با شکست
مواجه شده باشد. آرگومان نخست شناسه سرور را مشخص کرده و آرگومان دوم
اطلاعات بیشتری درباره خطا ارائه می‌دهد.
.SS KEY_PROCESSING_FAILED_UNSPECIFIED_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
The GSS\-TKEY processing for server %1 failed because of an unspecified error
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که پردازش کلید برای یک سرور خاص با شکست
مواجه شده باشد. آرگومان نخست شناسه سرور را مشخص می‌کند.
.SS LEASE
.SS LEASE_CMDS_ADD4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
lease4\-add command successful (address: %1)
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۲۰ ثبت می‌شود.
دستور lease4\-add موفقیت‌آمیز بوده است. نشانی IPv4 اجاره
ثبت می‌شود.
.SS LEASE_CMDS_ADD4_CONFLICT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
lease4\-add command failed due to conflict (parameters: %1, reason: %2)
.EE
.UNINDENT
.UNINDENT
.sp
دستور دریافتی lease4\-add خوش‌ساخت بوده و حاوی پارامترهای معتبری است، اما
اجاره ایجاد نشد زیرا با وضعیت سرور یا پیکربندی در تداخل است.
علت تداخل در پیام ثبت می‌شود.
.SS LEASE_CMDS_ADD4_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
lease4\-add command failed (parameters: %1, reason: %2)
.EE
.UNINDENT
.UNINDENT
.sp
دستور lease4\-add با شکست مواجه شده است. هم دلیل و هم
پارامترهای ارائه‌شده ثبت می‌شوند.
.SS LEASE_CMDS_ADD6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
lease6\-add command successful (address: %1)
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۲۰ ثبت می‌شود.
دستور lease6\-add موفقیت‌آمیز بوده است. نشانی IPv6 اجاره
ثبت می‌شود.
.SS LEASE_CMDS_ADD6_CONFLICT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
lease6\-add command failed due to conflict (parameters: %1, reason: %2)
.EE
.UNINDENT
.UNINDENT
.sp
دستور دریافتی lease6\-add خوش‌ساخت بوده و حاوی پارامترهای معتبری است، اما
اجاره ایجاد نشد زیرا با وضعیت سرور یا پیکربندی در تداخل است.
علت تداخل در پیام ثبت می‌شود..SS LEASE_CMDS_ADD6_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
lease6\-add command failed (parameters: %1, reason: %2)
.EE
.UNINDENT
.UNINDENT
.sp
دستور lease6\-add با شکست مواجه شده است. هم علت و هم
پارامترهای ارسالی در گزارش ثبت می‌شوند.
.SS LEASE_CMDS_BULK_APPLY6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
lease6\-bulk\-apply command successful (applied addresses count: %1)
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۲۰ ثبت می‌شود.
دستور lease6\-bulk\-apply موفقیت‌آمیز بوده است. تعداد نشانی‌های
اعمال‌شده در گزارش ثبت می‌شود.
.SS LEASE_CMDS_BULK_APPLY6_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
lease6\-bulk\-apply command failed (parameters: %1, reason: %2)
.EE
.UNINDENT
.UNINDENT
.sp
دستور lease6\-bulk\-apply با شکست مواجه شده است. هم علت
و هم پارامترهای ارسالی در گزارش ثبت می‌شوند.
.SS LEASE_CMDS_DEINIT_OK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
unloading Lease Commands hooks library successful
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که کتابخانه قلاب‌های (hooks library)
مربوط به Lease Commands با موفقیت خارج (تخلیه) شده است.
.SS LEASE_CMDS_DEL4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
lease4\-del command successful (address: %1)
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۲۰ ثبت می‌شود.
تلاش برای حذف یک اجاره IPv4 (دستور lease4\-del) موفقیت‌آمیز بوده است.
نشانی IPv4 اجاره در گزارش ثبت می‌شود.
.SS LEASE_CMDS_DEL4_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
lease4\-del command failed (parameters: %1, reason: %2)
.EE
.UNINDENT
.UNINDENT
.sp
تلاش برای حذف یک اجاره IPv4 (دستور lease4\-del) با شکست مواجه شده است. هم علت
و هم پارامترهای ارسالی در گزارش ثبت می‌شوند.
.SS LEASE_CMDS_DEL6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
lease4\-del command successful (address: %1)
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۲۰ ثبت می‌شود.
تلاش برای حذف یک اجاره IPv4 (دستور lease4\-del) موفقیت‌آمیز بوده است.
نشانی IPv6 اجاره در گزارش ثبت می‌شود.
.SS LEASE_CMDS_DEL6_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
lease6\-del command failed (parameters: %1, reason: %2)
.EE
.UNINDENT
.UNINDENT
.sp
تلاش برای حذف یک اجاره IPv6 (دستور lease4\-del) با شکست مواجه شده است. هم علت
و هم پارامترهای ارسالی در گزارش ثبت می‌شوند.
.SS LEASE_CMDS_GET4_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
lease4\-get command failed (parameters: %1, reason: %2)
.EE
.UNINDENT
.UNINDENT
.sp
دستور lease4\-get با شکست مواجه شده است. هم علت و هم
پارامترهای ارسالی در گزارش ثبت می‌شوند.
.SS LEASE_CMDS_GET6_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
lease6\-get command failed (parameters: %1, reason: %2)
.EE
.UNINDENT
.UNINDENT
.sp
دستور lease4\-get با شکست مواجه شده است. هم علت و هم
پارامترهای ارسالی در گزارش ثبت می‌شوند..SS LEASE_CMDS_INIT_OK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
loading Lease Commands hooks library successful
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که کتابخانه قلاب‌های (hooks library) مربوط به Lease Commands با موفقیت بارگذاری شده است. لذت ببرید!
.SS LEASE_CMDS_LEASE4_OFFER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
processing error occurred evaluating binding variables: %1
.EE
.UNINDENT
.UNINDENT
.sp
این گزارش خطا زمانی صادر می‌شود که هنگام فراخوانی گرداننده lease4_offer خطایی رخ دهد. آرگومان توضیحی درباره علت خطا ارائه می‌دهد.
.SS LEASE_CMDS_LEASES4_COMMITTED_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
processing error occurred evaluating binding variables: %1
.EE
.UNINDENT
.UNINDENT
.sp
این گزارش خطا زمانی صادر می‌شود که هنگام فراخوانی گرداننده leases4_committed خطایی رخ دهد. آرگومان توضیحی درباره علت خطا ارائه می‌دهد.
.SS LEASE_CMDS_LEASES6_COMMITTED_CONFLICT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
could not updating lease: %1 for: %2
.EE
.UNINDENT
.UNINDENT
.sp
این گزارش خطا توسط فراخوان (callback) leases6_committed زمانی صادر می‌شود که تلاشی برای به‌روزرسانی یک اجاره با مقادیر جدید binding\-variable صورت می‌گیرد، اما تغییری متناقض رخ داده که این به‌روزرسانی را نامعتبر می‌سازد. آرگومان‌ها نشانی اجاره و جزئیات پرسمان را ارائه می‌دهند.
.SS LEASE_CMDS_LEASES6_COMMITTED_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
reason: %1
.EE
.UNINDENT
.UNINDENT
.sp
این گزارش خطا زمانی صادر می‌شود که به‌روزرسانی یک یا چند اجارهٔ مرتبط با پرسمان کلاینت با مقادیر binding\-variable با شکست مواجه شده باشد. آرگومان جزئیات را ارائه می‌دهد. خطاهای منفرد مربوط به هر اجاره باید پیش از این گزارش ثبت شده باشند.
.SS LEASE_CMDS_LEASES6_COMMITTED_LEASE_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
evaluating binding\-variables for lease: %1 for: %2, reason: %3
.EE
.UNINDENT
.UNINDENT
.sp
این گزارش خطا توسط فراخوان leases6_committed زمانی صادر می‌شود که خطایی غیرمنتظره در ارزیابی binding\-variableها برای یک اجاره مشخص رخ دهد. آرگومان‌ها نشانی اجاره، جزئیات پرسمان و توضیحی درباره خطا را ارائه می‌دهند.
.SS LEASE_CMDS_LOAD_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
loading Lease Commands hooks library failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهنده بروز خطا در بارگذاری کتابخانه قلاب‌های Lease Commands است. جزئیات خطا به عنوان آرگومان پیام گزارش ارائه شده است.
.SS LEASE_CMDS_PATH_SECURITY_WARNING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
lease file path specified is NOT SECURE: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که اعمال تدابیر امنیتی غیرفعال باشد و بخش مسیر در پارامتر \fIfilename\fP از دستور lease4\-write یا lease6\-write با مسیرهای پشتیبانی‌شده مطابقت نداشته باشد. کارساز همچنان از مسیر تعیین‌شده استفاده خواهد کرد، اما هشدار می‌دهد که این کار ممکن است خطرات امنیتی به همراه داشته باشد.
.SS LEASE_CMDS_RESEND_DDNS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
lease4\-resend\-ddns command successful: %1
.EE
.UNINDENT
.UNINDENT
.sp
درخواست به‌روزرسانی DNS برای اجاره IPv4 مورد نظر با موفقیت در صف ارسال به kea\-dhcp\-ddns قرار گرفت.
.SS LEASE_CMDS_RESEND_DDNS4_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
lease4\-resend\-ddns command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
درخواست به‌روزرسانی DNS برای اجاره IPv4 مورد نظر با شکست مواجه شد. علت این شکست در گزارش ثبت می‌شود..SS LEASE_CMDS_RESEND_DDNS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
lease6\-resend\-ddns command successful: %1
.EE
.UNINDENT
.UNINDENT
.sp
درخواستی برای به‌روزرسانی DNS جهت اجاره درخواستی IPv6 با موفقیت برای ارسال به kea\-dhcp\-ddns در صف قرار گرفت.
.SS LEASE_CMDS_RESEND_DDNS6_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
lease6\-resend\-ddns command failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
درخواستی برای به‌روزرسانی DNS جهت اجاره درخواستی IPv6 با شکست مواجه شد. دلیل شکست ثبت شده است.
.SS LEASE_CMDS_UPDATE4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
lease4\-update command successful (address: %1)
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۲۰ ثبت می‌شود.
دستور lease4\-update موفقیت‌آمیز بوده است. آدرس IPv4 اجاره ثبت می‌شود.
.SS LEASE_CMDS_UPDATE4_CONFLICT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
lease4\-update command failed due to conflict (parameters: %1, reason: %2)
.EE
.UNINDENT
.UNINDENT
.sp
دستور دریافتی lease4\-update ساختار درستی دارد و حاوی پارامترهای معتبری است، اما اجاره نتوانست ایجاد شود زیرا با وضعیت یا پیکربندی کارساز در تعارض است. علت تعارض در پیام ثبت می‌شود.
.SS LEASE_CMDS_UPDATE4_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
lease4\-update command failed (parameters: %1, reason: %2)
.EE
.UNINDENT
.UNINDENT
.sp
دستور lease4\-update با شکست مواجه شد. هم دلیل شکست و هم پارامترهای ارسال‌شده ثبت می‌شوند.
.SS LEASE_CMDS_UPDATE6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
lease6\-update command successful (address: %1)
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۲۰ ثبت می‌شود.
دستور lease6\-update موفقیت‌آمیز بوده است. آدرس IPv6 اجاره ثبت می‌شود.
.SS LEASE_CMDS_UPDATE6_CONFLICT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
lease6\-update command failed due to conflict (parameters: %1, reason: %2)
.EE
.UNINDENT
.UNINDENT
.sp
دستور دریافتی lease6\-update ساختار درستی دارد و حاوی پارامترهای معتبری است، اما اجاره نتوانست ایجاد شود زیرا با وضعیت یا پیکربندی کارساز در تعارض است. علت تعارض در پیام ثبت می‌شود.
.SS LEASE_CMDS_UPDATE6_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
lease6\-add command failed (parameters: %1, reason: %2)
.EE
.UNINDENT
.UNINDENT
.sp
دستور lease6\-update با شکست مواجه شد. هم دلیل شکست و هم پارامترهای ارسال‌شده ثبت می‌شوند.
.SS LEASE_CMDS_WIPE4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
lease4\-wipe command successful (parameters: %1)
.EE
.UNINDENT
.UNINDENT
.sp
دستور lease4\-wipe موفقیت‌آمیز بوده است. پارامترهای این دستور ثبت می‌شوند.
.SS LEASE_CMDS_WIPE4_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
lease4\-wipe command failed (parameters: %1, reason: %2)
.EE
.UNINDENT
.UNINDENT
.sp
دستور lease4\-wipe با شکست مواجه شد. هم دلیل شکست و هم پارامترهای ارسال‌شده ثبت می‌شوند..SS LEASE_CMDS_WIPE6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
lease6\-wipe command successful (parameters: %1)
.EE
.UNINDENT
.UNINDENT
.sp
دستور lease6\-wipe با موفقیت انجام شد. پارامترهای این دستور ثبت شده‌اند.
.SS LEASE_CMDS_WIPE6_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
lease6\-wipe command failed (parameters: %1, reason: %2)
.EE
.UNINDENT
.UNINDENT
.sp
دستور lease6\-wipe با شکست مواجه شد. هم دلیل شکست و هم پارامترهای ارسال‌شده ثبت شده‌اند.
.SS LEASE_QUERY_LOAD_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Lease Query hooks library failed to load: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که هنگام بارگذاری کتابخانه قلاب‌های Lease Query خطایی رخ داده است. آرگومان، جزئیات خطا را شرح می‌دهد.
.SS LEASE_QUERY_LOAD_OK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Lease Query hooks library loaded successfully.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که کتابخانه قلاب‌های Lease Query با موفقیت بارگذاری شده است.
.SS LEASE_QUERY_UNLOAD_OK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Lease Query hooks library unloaded successfully.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که کتابخانه قلاب‌های Lease Query با موفقیت تخلیه شده است.
.SS LEGAL
.SS LEGAL_LOG_COMMAND_NO_LEGAL_STORE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
LegalStore instance is null
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی صادر می‌شود که کتابخانه Legal Log برای نوشتن یک مدخل دستور کنترلی در مخزن قانونی (legal store) تلاش کرده و نمونهٔ مخزن ایجاد نشده است. این یک خطای برنامه‌نویسی است و نباید رخ دهد.
.SS LEGAL_LOG_COMMAND_WRITE_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Could not write command entry to the legal store: %1
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی صادر می‌شود که کتابخانه Legal Log برای نوشتن یک مدخل دستور کنترلی در مخزن قانونی (legal store) تلاش کرده و نوشتن با شکست مواجه شده است. محتوای پیام باید توضیحی دقیق دربارهٔ خطا ارائه دهد.
.SS LEGAL_LOG_DB_OPEN_CONNECTION_WITH_RETRY_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Failed to connect to database: %1 with error: %2
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام اطلاع‌رسانی است و زمانی صادر می‌شود که کارساز در برقراری اتصال به پایگاه‌دادهٔ مخزن ناموفق بوده است. عملیات، رویهٔ تلاش مجدد برای اتصال را آغاز کرده است. رشتهٔ دسترسی به پایگاه‌داده با گذرواژهٔ پوشانده‌شده، همراه با خطا و جزئیات رویهٔ اتصال مجدد ثبت می‌شود.
.SS LEGAL_LOG_LEASE4_NO_LEGAL_STORE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
LegalStore instance is null
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی صادر می‌شود که کتابخانه Legal Log برای نوشتن یک مدخل اجارهٔ IPv4 در مخزن قانونی (legal store) تلاش کرده و نمونهٔ مخزن ایجاد نشده است. این یک خطای برنامه‌نویسی است و نباید رخ دهد.
.SS LEGAL_LOG_LEASE4_WRITE_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Could not write to the legal store: %1
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی صادر می‌شود که کتابخانه Legal Log برای نوشتن یک مدخل اجارهٔ IPv4 در مخزن قانونی (legal store) تلاش کرده و عملیات نوشتن ناموفق بوده است. محتوای پیام باید شامل نام مخزن فیزیکی و ماهیت خطا باشد..SS LEGAL_LOG_LEASE6_NO_LEGAL_STORE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
LegalStore instance is null
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی صادر می‌شود که کتابخانهٔ Legal Log تلاش کرده یک مدخل واگذاری IPv6 را در مخزن قانونی بنویسد، اما نمونهٔ مخزن ایجاد نشده است. این یک خطای برنامه‌نویسی است و نباید رخ دهد.
.SS LEGAL_LOG_LEASE6_WRITE_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Could not write to the legal store: %1
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی صادر می‌شود که کتابخانهٔ Legal Log برای نوشتن یک مدخل واگذاری IPv6 در مخزن قانونی تلاش کرده اما عملیات نوشتن با شکست مواجه شده است. محتوای پیام باید شامل نام فیزیکی مخزن و ماهیت خطا باشد.
.SS LEGAL_LOG_LOAD_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
LEGAL LOGGING DISABLED! An error occurred loading the library: %1
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی صادر می‌شود که کتابخانهٔ DHCP Legal Log بارگذاری نشود. علت دقیق باید در پیام گزارش توضیح داده شود. هیچ‌یک از مخازن موجود تغییر نخواهند کرد و هیچ مدخل ثبت گزارش قانونی صادر نخواهد شد.
.SS LEGAL_LOG_MYSQL_COMMIT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
committing to MySQL database
.EE
.UNINDENT
.UNINDENT
.sp
کد یک فراخوانی commit صادر کرده است. تمام تراکنش‌های معلق در پایگاه داده ثبت (commit) خواهند شد. توجه داشته باشید که بسته به تنظیمات MySQL، این تثبیت ممکن است شامل نوشتن مستقیم روی دیسک نباشد.
.SS LEGAL_LOG_MYSQL_DB_RECONNECT_ATTEMPT_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
database reconnect failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
پیام خطایی که هنگام ناموفق بودن تلاش برای اتصال مجدد صادر می‌شود.
.SS LEGAL_LOG_MYSQL_DB_RECONNECT_ATTEMPT_SCHEDULE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
scheduling attempt %1 of %2 in %3 milliseconds
.EE
.UNINDENT
.UNINDENT
.sp
یک پیام اطلاعاتی که هنگام زمان‌بندی تلاش بعدی سرور برای اتصال مجدد به پایگاه داده صادر می‌شود. این حالت زمانی رخ می‌دهد که سرور اتصال خود را به پایگاه داده از دست داده و در حال تلاش برای برقراری مجدد اتصال به‌صورت خودکار است.
.SS LEGAL_LOG_MYSQL_DB_RECONNECT_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
maximum number of database reconnect attempts: %1, has been exhausted without success
.EE
.UNINDENT
.UNINDENT
.sp
پیام خطایی که هنگام شکست سرور در برقراری مجدد اتصال صادر می‌شود. قطع ارتباط معمولاً به دلیل مشکلی در شبکه یا سرور پایگاه داده است.
.SS LEGAL_LOG_MYSQL_FATAL_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Unrecoverable MySQL error occurred: %1 for <%2>, reason: %3 (error code: %4).
.EE
.UNINDENT
.UNINDENT
.sp
پیام خطایی که نشان می‌دهد ارتباط با سرور پایگاه داده MySQL قطع شده است. هنگامی که این اتفاق رخ می‌دهد، سرور فوراً با یک کد خروج غیرصفر (non\-zero) خارج می‌شود. این مشکل به احتمال زیاد ناشی از مشکلی در شبکه است.
.SS LEGAL_LOG_MYSQL_GET_VERSION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining schema version information
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در شرف دریافت اطلاعات نسخهٔ شمای پایگاه داده MySQL است.
.SS LEGAL_LOG_MYSQL_INSERT_LOG
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Adding a log entry to the database: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
یک پیام اطلاع‌رسانی که هنگام درج یک مدخل گزارش ثبت می‌گردد..SS LEGAL_LOG_MYSQL_INVALID_ACCESS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
invalid database access string: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام زمانی ثبت می‌شود که تلاشی برای تجزیه یک رشته دسترسی به پایگاه داده انجام شده و با خطا مواجه شده باشد. رشته دسترسی مورد نظر \- که باید به صورت \(aqkeyword=value keyword=value...\(aq باشد \- در پیام گنجانده شده است.
.SS LEGAL_LOG_MYSQL_NO_TLS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
TLS was required but is not used
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا هنگامی صادر می‌شود که TLS برای اتصال الزامی بوده اما TLS استفاده نشده است.
.SS LEGAL_LOG_MYSQL_ROLLBACK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
rolling back MySQL database
.EE
.UNINDENT
.UNINDENT
.sp
کد یک فراخوانی rollback صادر کرده است. تمام تراکنش‌های معلق بازگردانی خواهند شد و در پایگاه داده اعمال (commit) نمی‌شوند.
.SS LEGAL_LOG_MYSQL_START_TRANSACTION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
starting new MySQL transaction
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اشکال‌زدایی (debug) زمانی صادر می‌شود که یک تراکنش MySQL جدید در حال شروع باشد. این پیام معمولاً هنگام درج داده در یک جدول منفرد صادر نمی‌شود، زیرا سرور در این حالت تراکنش‌ها را به صورت صریح آغاز نمی‌کند. این پیام زمانی صادر می‌شود که داده‌ها با چندین دستور INSERT در چندین جدول درج شوند و در صورت بروز خطا در هر یک از این دستورهای INSERT، نیاز به بازگردانی (rollback) کل تراکنش وجود داشته باشد.
.SS LEGAL_LOG_MYSQL_TLS_CIPHER
.INDENT 0.0
.INDENT 3.5
.sp
.EX
TLS cipher: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک اتصال MySQL جدید به همراه TLS ایجاد گردد. نام سایفر (cipher) پروتکل TLS ثبت می‌شود.
.SS LEGAL_LOG_PATH_SECURITY_WARNING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Forensic log path specified is NOT SECURE: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که اعمال تدابیر امنیتی غیرفعال شده باشد و مسیر مشخص‌شده برای خروجی لاگ‌های قانونی (forensic logging) با مسیر پشتیبانی‌شده مطابقت نداشته باشد. سرور همچنان از مسیر تعیین‌شده استفاده خواهد کرد، اما هشدار می‌دهد که انجام این کار ممکن است خطرات امنیتی به همراه داشته باشد.
.SS LEGAL_LOG_PGSQL_COMMIT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
committing to PostgreSQL database
.EE
.UNINDENT
.UNINDENT
.sp
کد یک فراخوانی commit صادر کرده است. تمام تراکنش‌های معلق در پایگاه داده اعمال (commit) خواهند شد. توجه داشته باشید که بسته به تنظیمات PostgreSQL، عمل ثبت ممکن است شامل نوشتن هم‌زمان روی دیسک نباشد.
.SS LEGAL_LOG_PGSQL_DB_RECONNECT_ATTEMPT_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
database reconnect failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
پیام خطایی که هنگام ناموفق بودن تلاش برای اتصال مجدد صادر می‌شود.
.SS LEGAL_LOG_PGSQL_DB_RECONNECT_ATTEMPT_SCHEDULE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
scheduling attempt %1 of %2 in %3 milliseconds
.EE
.UNINDENT
.UNINDENT
.sp
پیام اطلاعاتی (info) که هنگام زمان‌بندی تلاش بعدی سرور برای اتصال مجدد به پایگاه داده صادر می‌شود. این وضعیت زمانی رخ می‌دهد که اتصال سرور به پایگاه داده قطع شده باشد و در حال تلاش برای اتصال مجدد خودکار باشد..SS LEGAL_LOG_PGSQL_DB_RECONNECT_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
حداکثر تعداد تلاش‌ها برای اتصال مجدد به پایگاه داده: %1، بدون موفقیت به پایان رسید
.EE
.UNINDENT
.UNINDENT
.sp
پیام خطایی که هنگام شکست سرور در اتصال مجدد صادر می‌شود. قطع ارتباط معمولاً ناشی از یک مشکل شبکه یا سرور پایگاه داده است.
.SS LEGAL_LOG_PGSQL_DEALLOC_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
هنگام آزادسازی عبارت‌های SQL در زمان بستن پایگاه داده گزارش PostgreSQL خطایی رخ داد: %1
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی صادر می‌شود که کتابخانه قلاب legal log در فرایند بستن اتصال خود به پایگاه داده PostgreSQL، هنگام آزادسازی منابع SQL پایگاه داده با خطا مواجه شود. این اتصال به عنوان بخشی از روال عادی خاموش‌سازی سرور بسته می‌شود. این خطا به احتمال زیاد یک مشکل نرم‌افزاری است که وقوع آن یا تأثیر منفی آن بر عملکرد سرور بسیار بعید است.
.SS LEGAL_LOG_PGSQL_FATAL_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
خطای غیرقابل‌بازیابی PostgreSQL رخ داد: عبارت: <%1>، دلیل: %2 (کد خطا: %3).
.EE
.UNINDENT
.UNINDENT
.sp
پیام خطایی که نشان می‌دهد ارتباط با سرور پایگاه داده PostgreSQL قطع شده است. هنگام رخ دادن این وضعیت، سرور بلافاصله با یک کد خروج غیر\-صفر خارج می‌شود. این مشکل به احتمال زیاد به دلیل وجود اختلال در شبکه رخ می‌دهد.
.SS LEGAL_LOG_PGSQL_GET_VERSION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
دریافت اطلاعات نسخه طرح‌واره
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در آستانه دریافت اطلاعات نسخه طرح‌واره (schema) از پایگاه داده PostgreSQL باشد.
.SS LEGAL_LOG_PGSQL_INSERT_LOG
.INDENT 0.0
.INDENT 3.5
.sp
.EX
افزودن یک مدخل گزارش به پایگاه داده: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
پیامی اطلاع‌رسانی که هنگام درج یک مدخل گزارش ثبت می‌شود.
.SS LEGAL_LOG_PGSQL_INVALID_ACCESS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
رشته نامعتبر دسترسی به پایگاه داده: %1
.EE
.UNINDENT
.UNINDENT
.sp
این مورد زمانی ثبت می‌شود که تلاشی برای تجزیه رشته دسترسی به پایگاه داده انجام گرفته و به خطا منجر شده باشد. رشته دسترسی مورد نظر \- که باید به صورت \(aqkeyword=value keyword=value...\(aq باشد \- در متن پیام گنجانده شده است.
.SS LEGAL_LOG_PGSQL_ROLLBACK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
بازگردانی پایگاه داده PostgreSQL
.EE
.UNINDENT
.UNINDENT
.sp
کد برنامه‌نویسی یک فراخوانی بازگردانی (rollback) صادر کرده است. تمام تراکنش‌های معلق بازگردانی خواهند شد و در پایگاه داده اعمال (commit) نمی‌شوند.
.SS LEGAL_LOG_PGSQL_START_TRANSACTION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
شروع یک تراکنش جدید PostgreSQL
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک تراکنش جدید PostgreSQL در حال آغاز باشد.
این پیام معمولاً هنگام درج داده‌ها در یک جدول منفرد صادر نمی‌شود، زیرا سرور در این حالت
به‌طور صریح تراکنش‌ها را آغاز نمی‌کند. این پیام زمانی صادر می‌شود که داده‌ها
با چندین عبارت INSERT در چندین جدول درج شوند و ممکن است در صورت شکست هر یک
از این دستورات INSERT، نیاز به بازگردانی (rollback) کل تراکنش باشد.
.SS LEGAL_LOG_STORE_CLOSED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
مخزن لاگ قانونی بسته شد: %1
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام اطلاع‌رسانی است و زمانی صادر می‌شود که کتابخانه Legal Log مخزن گزارش‌های قانونی را با موفقیت بسته باشد..SS LEGAL_LOG_STORE_CLOSE_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
An error occurred closing the store: %1, error: %2
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است که هنگام بروز مشکل در کتابخانهٔ legal log برای بستن یک legal store صادر می‌شود. رخ دادن این حالت بسیار بعید است و نباید تأثیری بر محتوای مخزن یا عملیات بعدی legal store بگذارد.
.SS LEGAL_LOG_STORE_OPEN
.INDENT 0.0
.INDENT 3.5
.sp
.EX
opening Legal Log file: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی هنگامی ثبت می‌شود که یک کارگزار DHCP (چه V4 یا V6) در شرف باز کردن یک فایل legal log باشد. پارامترهای backend در لاگ ثبت می‌شوند.
.SS LEGAL_LOG_STORE_OPENED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Legal store opened: %1
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام اطلاعاتی است که پس از باز شدن موفقیت‌آمیز legal store توسط کتابخانهٔ Legal Log صادر می‌شود.
.SS LEGAL_LOG_SYSLOG
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی شامل پیامی است که در syslog ثبت می‌شود.
.SS LEGAL_LOG_SYSLOG_STORE_OPEN
.INDENT 0.0
.INDENT 3.5
.sp
.EX
opening Legal Syslog: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی هنگامی ثبت می‌شود که یک کارگزار DHCP (چه V4 یا V6) در شرف باز کردن یک مخزن legal syslog باشد. پارامترهای backend در لاگ ثبت می‌شوند.
.SS LEGAL_LOG_UNLOAD_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
An error occurred unloading the library: %1
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی صادر می‌شود که هنگام تخلیهٔ (unload) کتابخانهٔ Legal Log خطایی رخ دهد. وقوع این خطا بعید است و احتمالاً با بارگذاری مجدد کتابخانه در دفعات بعدی، عملکرد عادی آن از سر گرفته خواهد شد.
.SS LFC
.SS LFC_FAIL_PID_CREATE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام زمانی صادر می‌شود که LFC هنگام تلاش برای ایجاد فایل PID با خطا مواجه شود. این پیام شامل یک رشته خطای دقیق‌تر است.
.SS LFC_FAIL_PID_DEL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام زمانی صادر می‌شود که LFC هنگام تلاش برای حذف فایل PID با خطا مواجه شود. این پیام شامل یک رشته خطای دقیق‌تر است.
.SS LFC_FAIL_PROCESS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام زمانی صادر می‌شود که LFC هنگام تلاش برای پردازش فایل‌ها با خطا مواجه شود. این پیام شامل یک رشته خطای دقیق‌تر است.
.SS LFC_FAIL_ROTATE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام زمانی صادر می‌شود که LFC هنگام تلاش برای چرخش فایل‌ها (rotate) با خطا مواجه شود. این پیام شامل یک رشته خطای دقیق‌تر است..SS LFC_PROCESSING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Previous file: %1, copy file: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام درست پیش از اینکه LFC پردازش فایل‌های اجاره را آغاز کند، صادر می‌شود.
.SS LFC_READ_STATS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Leases: %1, attempts: %2, errors: %3.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام تعداد اجاره‌های خوانده‌شده، تعداد تلاش‌ها برای خواندن اجاره‌ها و تعداد خطاهای رخ‌داده هنگام خواندن را چاپ می‌کند.
.SS LFC_ROTATING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
LFC rotating files
.EE
.UNINDENT
.UNINDENT
.sp
این پیام درست پیش از شروع چرخش (rotate) فایل‌های اجاره توسط LFC صادر می‌شود \- حذف فایل‌های قدیمی و جایگزینی آن‌ها با موارد جدید.
.SS LFC_RUNNING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
LFC instance already running
.EE
.UNINDENT
.UNINDENT
.sp
این پیام در صورتی صادر می‌شود که LFC از طریق بررسی PID تشخیص دهد نمونه قبلی LFC ممکن است همچنان در حال اجرا باشد.
.SS LFC_START
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Starting lease file cleanup
.EE
.UNINDENT
.UNINDENT
.sp
این پیام با شروع فرایند LFC صادر می‌شود.
.SS LFC_TERMINATE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
LFC finished processing
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هنگام اتمام فرایند LFC صادر می‌شود. این پیام نشان‌دهنده موفقیت‌آمیز بودن فرایند نیست، بلکه تنها پایان یافتن آن را مشخص می‌کند.
.SS LFC_WRITE_STATS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Leases: %1, attempts: %2, errors: %3.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام تعداد اجاره‌های نوشته‌شده، تعداد تلاش‌ها برای نوشتن اجاره‌ها و تعداد خطاهای رخ‌داده هنگام نوشتن را چاپ می‌کند.
.SS LIMITS
.SS LIMITS_CONFIGURATION_LEASE_BACKEND_NOT_AVAILABLE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Lease backend not available. Could not check JSON support in the database. Continuing without checking...
.EE
.UNINDENT
.UNINDENT
.sp
پیام هشداری که ثبت می‌شود تا اطلاع دهد اگر پایگاه‌داده در حال بازیابی از JSON پشتیبانی نکند، ممکن است محدودیت‌ها کار نکنند.
.SS LIMITS_CONFIGURATION_LEASE_BACKEND_SHOULD_HAVE_BEEN_AVAILABLE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Lease backend not available when configuration shows it should have been. This is likely a programmatic error. Continuing...
.EE
.UNINDENT
.UNINDENT
.sp
پیام خطایی که برای اطلاع‌رسانی درباره یک وضعیت غیرمنتظره ثبت می‌شود؛ وضعیتی که در آن انتظار می‌رفت backend اجاره در دسترس باشد اما در دسترس نبود. ممکن است خطاهای زمان اجرا (runtime) رخ دهند.
.SS LIMITS_CONFIGURED_ADDRESS_LIMIT_BY_CLIENT_CLASS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
New lease limit of %1 addresses for client class %2 has been configured.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که برای اطلاع‌رسانی از پیکربندی موفقیت‌آمیز محدودیت نشانی به ازای هر client class ثبت می‌شود..SS LIMITS_CONFIGURED_ADDRESS_LIMIT_BY_SUBNET
.INDENT 0.0
.INDENT 3.5
.sp
.EX
حد اجاره جدید %1 نشانی برای زیرشبکه با شناسه %2 پیکربندی شده است.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی 40 ثبت می‌شود.
پیام اشکال‌زدایی ثبت‌شده برای اطلاع‌رسانی درباره پیکربندی موفقیت‌آمیز یک حد نشانی به ازای هر زیرشبکه
.SS LIMITS_CONFIGURED_PREFIX_LIMIT_BY_CLIENT_CLASS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
حد اجاره جدید %1 پیشوند برای کلاس کلاینت %2 پیکربندی شده است.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی 40 ثبت می‌شود.
پیام اشکال‌زدایی ثبت‌شده برای اطلاع‌رسانی درباره پیکربندی موفقیت‌آمیز یک حد پیشوند به ازای هر کلاس کلاینت
.SS LIMITS_CONFIGURED_PREFIX_LIMIT_BY_SUBNET
.INDENT 0.0
.INDENT 3.5
.sp
.EX
حد اجاره جدید %1 پیشوند برای زیرشبکه با شناسه %2 پیکربندی شده است.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی 40 ثبت می‌شود.
پیام اشکال‌زدایی ثبت‌شده برای اطلاع‌رسانی درباره پیکربندی موفقیت‌آمیز یک حد پیشوند به ازای هر زیرشبکه
.SS LIMITS_CONFIGURED_RATE_LIMIT_BY_CLIENT_CLASS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
حد نرخ جدید %1 برای کلاس کلاینت %2 پیکربندی شده است.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی 40 ثبت می‌شود.
پیام اشکال‌زدایی ثبت‌شده برای اطلاع‌رسانی درباره پیکربندی موفقیت‌آمیز یک حد نرخ به ازای هر کلاس کلاینت
.SS LIMITS_CONFIGURED_RATE_LIMIT_BY_SUBNET
.INDENT 0.0
.INDENT 3.5
.sp
.EX
حد نرخ جدید %1 برای زیرشبکه با شناسه %2 پیکربندی شده است.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی 40 ثبت می‌شود.
پیام اشکال‌زدایی ثبت‌شده برای اطلاع‌رسانی درباره پیکربندی موفقیت‌آمیز یک حد نرخ به ازای هر زیرشبکه
.SS LIMITS_LEASE_LIMIT_EXCEEDED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
اجاره به دلیل فراتر رفتن از %1 تخصیص داده نشد.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی 40 ثبت می‌شود.
پیام اشکال‌زدایی ثبت‌شده برای نشان دادن اینکه تعداد فعلی نشانی‌ها یا
پیشوندهای اجاره‌داده‌شده برای یک کلاس کلاینت یا یک زیرشبکه از حد مجاز فراتر رفته است.
.SS LIMITS_LEASE_WITHIN_LIMITS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
اجاره با نشانی %1 در محدوده مجاز است.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی 40 ثبت می‌شود.
پیام اشکال‌زدایی ثبت‌شده برای نشان دادن اینکه تعداد فعلی نشانی‌ها یا
پیشوندهای اجاره‌داده‌شده برای یک کلاس کلاینت یا یک زیرشبکه از حد مجاز فراتر نرفته است.
.SS LIMITS_PACKET_WIIH_SUBNET_ID_RATE_NO_SUBNET
.INDENT 0.0
.INDENT 3.5
.sp
.EX
به دلیل مشخص نشدن زیرشبکه، محدودیت نرخ بر روی بسته اعمال نمی‌شود.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی 55 ثبت می‌شود.
پیام اشکال‌زدایی ثبت‌شده برای نشان دادن اینکه حد نرخ زیرشبکه برای بسته فعلی (در صورت وجود)، به دلیل
تنظیم نشدن زیرشبکه در callout handle بررسی نمی‌شود. این وضعیت می‌تواند به عنوان مثال در صورتی رخ دهد که
زیرشبکه پس از انتخاب شدن برای بسته در حال پردازش فعلی، حذف شده باشد.
.SS LIMITS_PACKET_WITH_CLIENT_CLASSES_RATE_LIMIT_DROPPED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
بسته تخصیص‌یافته به کلاس‌های کلاینت %1 به دلیل فراتر رفتن از حد نرخ %2 برای کلاس کلاینت %3 دور انداخته می‌شود.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی 40 ثبت می‌شود.
پیام اشکال‌زدایی ثبت‌شده برای نشان دادن اینکه بسته فعلی از یکی از محدودیت‌های نرخ
پیکربندی‌شده ذیل حداقل یک کلاس کلاینت فراتر رفته است
.SS LIMITS_PACKET_WITH_CLIENT_CLASSES_RATE_LIMIT_HONORED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
بسته تخصیص‌یافته به کلاس‌های کلاینت %1 پذیرفته می‌شود.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی 55 ثبت می‌شود.
پیام اشکال‌زدایی ثبت‌شده برای نشان دادن اینکه بسته فعلی از هیچ‌یک از محدودیت‌های نرخ
پیکربندی‌شده ذیل هیچ کلاس کلاینتی فراتر نرفته است.SS LIMITS_PACKET_WITH_SUBNET_ID_RATE_LIMIT_DROPPED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Packet assigned to subnet with ID %1 is being dropped for exceeding the rate limit of %2.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی برای اعلام این‌که بستهٔ جاری به‌دلیل فراتر رفتن از محدودیت نرخ (rate limit) پیکربندی‌شده ذیل شناسهٔ زیرشبکهٔ (subnet ID) اختصاص‌یافته، در صورت وجود، دور ریخته می‌شود (drop).
.SS LIMITS_PACKET_WITH_SUBNET_ID_RATE_LIMIT_HONORED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Packet under subnet with ID %1 and limit %2 is being honored.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۵۵ ثبت می‌شود.
پیام اشکال‌زدایی برای اعلام این‌که بستهٔ جاری از محدودیت پیکربندی‌شده ذیل شناسهٔ زیرشبکهٔ اختصاص‌یافته فراتر نرفته است. این پیام همچنین زمانی که هیچ محدودیت نرخی برای این شناسهٔ زیرشبکه پیکربندی نشده باشد، ثبت می‌شود.
.SS LOGIMPL
.SS LOGIMPL_ABOVE_MAX_DEBUG
.INDENT 0.0
.INDENT 3.5
.sp
.EX
debug level of %1 is too high and will be set to the maximum of %2
.EE
.UNINDENT
.UNINDENT
.sp
پیامی از رابط به پیاده‌سازی لاگر (logger) زیرین مبنی بر این‌که سطح اشکال‌زدایی (که توسط یک رشتهٔ داخلی مانند DEBUGn تنظیم شده است، که در آن n یک عدد صحیح است، مانند DEBUG22) بالاتر از حداکثر مقدار مجاز بوده و به آن مقدار کاهش یافته است. نمایش این پیام ممکن است نشان‌دهندهٔ خطای برنامه‌نویسی باشد \- لطفاً یک گزارش باگ ارسال کنید.
.SS LOGIMPL_BAD_DEBUG_STRING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
debug string \(aq%1\(aq has invalid format
.EE
.UNINDENT
.UNINDENT
.sp
پیامی از رابط به پیاده‌سازی لاگر زیرین مبنی بر این‌که رشتهٔ ایجادشده به‌صورت داخلی برای تنظیم سطح اشکال‌زدایی، قالب معتبری ندارد (باید به‌صورت DEBUGn باشد که در آن n یک عدد صحیح است، مانند DEBUG22). نمایش این پیام نشان‌دهندهٔ خطای برنامه‌نویسی است \- لطفاً یک گزارش باگ ارسال کنید.
.SS LOGIMPL_BELOW_MIN_DEBUG
.INDENT 0.0
.INDENT 3.5
.sp
.EX
debug level of %1 is too low and will be set to the minimum of %2
.EE
.UNINDENT
.UNINDENT
.sp
پیامی از رابط به پیاده‌سازی لاگر زیرین مبنی بر این‌که سطح اشکال‌زدایی (که توسط یک رشتهٔ داخلی مانند DEBUGn تنظیم شده است، که در آن n یک عدد صحیح است، مانند DEBUG22) کمتر از حداقل مقدار مجاز بوده و به آن مقدار افزایش یافته است. نمایش این پیام ممکن است نشان‌دهندهٔ خطای برنامه‌نویسی باشد \- لطفاً یک گزارش باگ ارسال کنید.
.SS LOG
.SS LOG_BAD_DESTINATION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
unrecognized log destination: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی چاپ می‌شود که مقدار مقصد لاگر (logger destination) مشخص‌شده ناشناخته باشد. مقصد باید یکی از مقادیر \(dqconsole\(dq، \(dqfile\(dq یا \(dqsyslog\(dq باشد.
.SS LOG_BAD_SEVERITY
.INDENT 0.0
.INDENT 3.5
.sp
.EX
unrecognized log severity: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی چاپ می‌شود که مقدار سطح اهمیت لاگر (logger severity) مشخص‌شده ناشناخته باشد. سطح اهمیت باید یکی از مقادیر \(dqDEBUG\(dq، \(dqINFO\(dq، \(dqWARN\(dq، \(dqERROR\(dq، \(dqFATAL\(dq یا \(dqNONE\(dq باشد.
.SS LOG_BAD_STREAM
.INDENT 0.0
.INDENT 3.5
.sp
.EX
bad log console output stream: %1
.EE
.UNINDENT
.UNINDENT
.sp
ثبت لاگ به‌گونه‌ای پیکربندی شده است که خروجی در ترمینال (console) نوشته شود، اما جریانی (stream) که قرار است در آن نوشته شود شناخته‌شده نیست. مقادیر مجاز \(dqstdout\(dq و \(dqstderr\(dq هستند.
.SS LOG_DUPLICATE_MESSAGE_ID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
duplicate message ID (%1) in compiled code
.EE
.UNINDENT
.UNINDENT
.sp
در حین راه‌اندازی (start\-up)، نرم‌افزار Kea تشخیص داد که شناسهٔ پیام داده‌شده چندین بار در کد Kea تعریف شده است. این امر نشان‌دهندهٔ خطای برنامه‌نویسی است؛ لطفاً یک گزارش باگ ارسال کنید..SS LOG_DUPLICATE_NAMESPACE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
line %1: duplicate $NAMESPACE directive found
.EE
.UNINDENT
.UNINDENT
.sp
هنگام خواندن یک فایل پیام، بیش از یک دستورالعمل $NAMESPACE یافت شد.
(این دستورالعمل برای تعیین یک فضای نام C++ هنگام تولید فایل‌های سرآیند
در طول توسعه نرم‌افزار استفاده می‌شود.) چنین وضعیتی به عنوان یک خطا در
نظر گرفته شده و فرآیند خواندن متوقف خواهد شد.
.SS LOG_INPUT_OPEN_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
unable to open message file %1 for input: %2
.EE
.UNINDENT
.UNINDENT
.sp
برنامه به دلیل ذکرشده قادر به باز کردن فایل پیام ورودی مشخص‌شده نبود.
.SS LOG_INVALID_MESSAGE_ID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
line %1: invalid message identification \(aq%2\(aq
.EE
.UNINDENT
.UNINDENT
.sp
یک شناسه (ID) نامعتبر برای پیام در حین خواندن فایل پیام پیدا شده است.
شناسه‌های پیام باید تنها شامل نویسه‌های الفبایی\-عددی و خط زیرین (underscore)
باشند و نباید با یک رقم شروع شوند.
.SS LOG_LOCK_TEST_MESSAGE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
this is a test message.
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام گزارش وقایع (log) است که در آزمون‌ها استفاده می‌شود.
.SS LOG_NAMESPACE_EXTRA_ARGS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
line %1: $NAMESPACE directive has too many arguments
.EE
.UNINDENT
.UNINDENT
.sp
دستورالعمل $NAMESPACE در یک فایل پیام تنها یک آرگومان می‌پذیرد؛
فضای نامی که تمام نام‌های نمادِ تولیدشده در آن قرار می‌گیرند. این خطا
زمانی رخ می‌دهد که کامپایلر یک دستورالعمل $NAMESPACE را با بیش از یک
آرگومان پیدا کند.
.SS LOG_NAMESPACE_INVALID_ARG
.INDENT 0.0
.INDENT 3.5
.sp
.EX
line %1: $NAMESPACE directive has an invalid argument (\(aq%2\(aq)
.EE
.UNINDENT
.UNINDENT
.sp
آرگومان $NAMESPACE در یک فایل پیام باید یک فضای نام معتبر در C++ باشد.
این پیام در صورتی نمایش داده می‌شود که بررسی اولیه نحو (syntax) رشته
توسط خواننده فایل با شکست مواجه شود.
.SS LOG_NAMESPACE_NO_ARGS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
line %1: no arguments were given to the $NAMESPACE directive
.EE
.UNINDENT
.UNINDENT
.sp
دستورالعمل $NAMESPACE در یک فایل پیام تنها یک آرگومان می‌پذیرد؛
یک فضای نام C++ که تمام نام‌های نمادِ ایجادشده در آن قرار می‌گیرند.
این خطا زمانی تولید می‌شود که کامپایلر یک دستورالعمل $NAMESPACE بدون
هیچ آرگومانی را پیدا کند.
.SS LOG_NO_MESSAGE_ID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
line %1: message definition line found without a message ID
.EE
.UNINDENT
.UNINDENT
.sp
در یک فایل پیام، پیام‌ها با خطوطی مشخص می‌شوند که با \(dq%\(dq آغاز می‌گردند.
باقی خط باید شامل شناسه پیام و متنی باشد که پیام را شرح می‌دهد. این خطا
نشان می‌دهد که کامپایلر پیام خطی را در فایل پیدا کرده است که فقط شامل
\(dq%\(dq بوده و هیچ محتوای دیگری ندارد.
.SS LOG_NO_MESSAGE_TEXT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
line %1: line found containing a message ID (\(aq%2\(aq) and no text
.EE
.UNINDENT
.UNINDENT
.sp
در یک فایل پیام، پیام‌ها با خطوطی مشخص می‌شوند که با \(dq%\(dq آغاز می‌گردند.
باقی خط باید شامل شناسه پیام و متن توصیف‌کننده پیام باشد. این خطا نشان می‌دهد
که کامپایلر پیام خطی را در فایل پیدا کرده است که فقط حاوی \(dq%\(dq و شناسه پیام
است، اما هیچ متنی ندارد..SS LOG_NO_SUCH_MESSAGE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
could not replace message text for \(aq%1\(aq: no such message
.EE
.UNINDENT
.UNINDENT
.sp
در حین راه‌اندازی، یک فایل پیام محلی خوانده شد. خطی با شناسه پیامِ مشخص‌شده در فایل یافت شد، اما این شناسه در فرهنگ پیام‌های کامپایل‌شده (compiled\-in message dictionary) وجود ندارد. این پیام ممکن است چندین بار در فایل ظاهر شود، یک بار به ازای هر شناسه پیام ناشناخته.
دلایل متعددی برای ظاهر شدن این پیام وجود دارد:
\- شناسه پیام در فایل پیام محلی دارای غلط املایی است.
\- برنامه‌ای که پیام را در خروجی می‌نویسد ممکن است از آن پیام خاص استفاده نکند (برای نمونه، پیام از ماژولی منشأ می‌گیرد که توسط برنامه استفاده نمی‌شود).
\- فایل محلی برای نسخه‌ای قدیمی‌تر از نرم‌افزار Kea نوشته شده و نسخه جدیدتر دیگر آن پیام را تولید نمی‌کند.
علت هرچه که باشد، هیچ تأثیری بر عملکرد Kea ندارد.
.SS LOG_OPEN_OUTPUT_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
unable to open %1 for output: %2
.EE
.UNINDENT
.UNINDENT
.sp
این خطا که از درون کد ثبت وقایع ناشی می‌شود، نشان‌دهنده آن است که برنامه به دلیل ذکرشده نتوانسته فایل خروجی مشخص‌شده را باز کند.
.SS LOG_PREFIX_EXTRA_ARGS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
line %1: $PREFIX directive has too many arguments
.EE
.UNINDENT
.UNINDENT
.sp
درون یک فایل پیام، دستورالعمل $PREFIX تنها یک آرگومان می‌پذیرد؛ پیشوندی که هنگام ایجاد یک فایل C++ به نام نمادها اضافه می‌شود. این خطا زمانی ایجاد می‌شود که کامپایلر یک دستورالعمل $PREFIX با بیش از یک آرگومان را بیابد.
نکته: دستورالعمل $PREFIX منسوخ شده است و در نسخه‌های آینده Kea حذف خواهد شد.
.SS LOG_PREFIX_INVALID_ARG
.INDENT 0.0
.INDENT 3.5
.sp
.EX
line %1: $PREFIX directive has an invalid argument (\(aq%2\(aq)
.EE
.UNINDENT
.UNINDENT
.sp
درون یک فایل پیام، دستورالعمل $PREFIX تنها یک آرگومان می‌پذیرد؛ پیشوندی که هنگام ایجاد یک فایل C++ به نام نمادها اضافه می‌شود. بدین ترتیب، این پیشوند باید از محدودیت‌های نام‌گذاری نمادها در C++ پیروی کند (برای مثال، فقط می‌تواند شامل نویسه‌های الفبایی\-عددی یا زیرخط باشد و نباید با رقم شروع شود). یک دستورالعمل $PREFIX با آرگومانی یافت شد (در پیام آمده است) که این محدودیت‌ها را نقض می‌کند.
نکته: دستورالعمل $PREFIX منسوخ شده است و در نسخه‌های آینده Kea حذف خواهد شد.
.SS LOG_READING_LOCAL_FILE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
reading local message file %1
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام اطلاع‌رسانی است که توسط Kea هنگام شروع به خواندن یک فایل پیام محلی صادر می‌شود. (یک فایل پیام محلی ممکن است متن یک یا چند پیام را جایگزین کند؛ با این حال، شناسه پیام تغییر نخواهد کرد.)
.SS LOG_READ_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
error reading from message file %1: %2
.EE
.UNINDENT
.UNINDENT
.sp
هنگام خواندن از فایل پیام نام‌برده، خطای مشخص‌شده رخ داده است.
.SS LOG_UNRECOGNIZED_DIRECTIVE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
line %1: unrecognized directive \(aq%2\(aq
.EE
.UNINDENT
.UNINDENT
.sp
درون یک فایل پیام، خطی یافت شد که با نماد دلار ($) شروع شده است (که نشان‌دهنده وجود یک دستورالعمل است)، اما واژه نخست در آن خط (که در پیام نشان داده شده) شناسایی نشد.
.SS LOG_WRITE_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
error writing to %1: %2
.EE
.UNINDENT
.UNINDENT
.sp
کامپایلر پیام هنگام نوشتن در فایل خروجی نام‌برده با خطای مشخص‌شده مواجه شد.
.SS MT
.SS MT_TCP_LISTENER_MGR_STARTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
MtTcpListenerMgr started with %1 threads, listening on %2:%3, use TLS: %4
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک MtTcpListenerMgr برای پذیرش اتصالات راه‌اندازی شده باشد. آرگومان‌ها جزئیات تعداد رشته‌هایی (threads) که شنونده استفاده می‌کند، آدرس و درگاهی (port) که در آن به گوش فرامی‌دهد، و اینکه آیا از TLS استفاده می‌شود یا خیر را مشخص می‌کنند..SS MT_TCP_LISTENER_MGR_STOPPED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
MtTcpListenerMgr for %1:%2 stopped.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که MtTcpListenerMgr در حال گوش‌دادن
روی نشانی و پورت مشخص‌شده، فرایند خاموش شدن را به پایان رسانده باشد.
.SS MT_TCP_LISTENER_MGR_STOPPING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Stopping MtTcpListenerMgr for %1:%2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که MtTcpListenerMgr در حال گوش‌دادن
روی نشانی و پورت مشخص‌شده، فرایند خاموش شدن را آغاز کرده باشد.
.SS MYSQL
.SS MYSQL_CB_CREATE_UPDATE_BY_POOL_OPTION4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
create or update option pool start: %1 pool end: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام فعال شدن عملیات ایجاد یا به‌روزرسانی گزینه بر اساس استخر (pool) صادر می‌شود.
.SS MYSQL_CB_CREATE_UPDATE_BY_POOL_OPTION6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
create or update option pool start: %1 pool end: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام فعال شدن عملیات ایجاد یا به‌روزرسانی گزینه بر اساس استخر (pool) صادر می‌شود.
.SS MYSQL_CB_CREATE_UPDATE_BY_PREFIX_OPTION6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
create or update option prefix: %1 prefix len: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام فعال شدن عملیات ایجاد یا به‌روزرسانی گزینه بر اساس پیشوند (prefix) صادر می‌شود.
.SS MYSQL_CB_CREATE_UPDATE_BY_SUBNET_ID_OPTION4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
create or update option by subnet id: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام فعال شدن عملیات ایجاد یا به‌روزرسانی گزینه بر اساس شناسه زیرشبکه (subnet id) صادر می‌شود.
.SS MYSQL_CB_CREATE_UPDATE_BY_SUBNET_ID_OPTION6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
create or update option by subnet id: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام فعال شدن عملیات ایجاد یا به‌روزرسانی گزینه بر اساس شناسه زیرشبکه (subnet id) صادر می‌شود.
.SS MYSQL_CB_CREATE_UPDATE_CLIENT_CLASS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
create or update client class: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام فعال شدن عملیات ایجاد یا به‌روزرسانی کلاس کلاینت (client class) صادر می‌شود.
.SS MYSQL_CB_CREATE_UPDATE_CLIENT_CLASS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
create or update client class: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام فعال شدن عملیات ایجاد یا به‌روزرسانی کلاس کلاینت (client class) صادر می‌شود.
.SS MYSQL_CB_CREATE_UPDATE_GLOBAL_PARAMETER4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
create or update global parameter: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام فعال شدن عملیات ایجاد یا به‌روزرسانی پارامتر سراسری (global parameter) صادر می‌شود..SS MYSQL_CB_CREATE_UPDATE_GLOBAL_PARAMETER6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
create or update global parameter: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی صادر می‌شود که عملیاتی برای ایجاد یا به‌روزرسانی پارامتر سراسری فعال شده باشد.
.SS MYSQL_CB_CREATE_UPDATE_OPTION4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
create or update option
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی صادر می‌شود که عملیاتی برای ایجاد یا به‌روزرسانی گزینه (option) فعال شده باشد.
.SS MYSQL_CB_CREATE_UPDATE_OPTION6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
create or update option
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی صادر می‌شود که عملیاتی برای ایجاد یا به‌روزرسانی گزینه (option) فعال شده باشد.
.SS MYSQL_CB_CREATE_UPDATE_OPTION_DEF4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
create or update option definition: %1 code: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی صادر می‌شود که عملیاتی برای ایجاد یا به‌روزرسانی تعریف گزینه فعال شده باشد.
.SS MYSQL_CB_CREATE_UPDATE_OPTION_DEF6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
create or update option definition: %1 code: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی صادر می‌شود که عملیاتی برای ایجاد یا به‌روزرسانی تعریف گزینه فعال شده باشد.
.SS MYSQL_CB_CREATE_UPDATE_SERVER4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
create or update server: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی صادر می‌شود که عملیاتی برای ایجاد یا به‌روزرسانی اطلاعات
سرور DHCPv4 فعال شده باشد.
.SS MYSQL_CB_CREATE_UPDATE_SERVER6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
create or update server: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی صادر می‌شود که عملیاتی برای ایجاد یا به‌روزرسانی اطلاعات
سرور DHCPv6 فعال شده باشد.
.SS MYSQL_CB_CREATE_UPDATE_SHARED_NETWORK4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
create or update shared network: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی صادر می‌شود که عملیاتی برای ایجاد یا به‌روزرسانی شبکه مشترک فعال شده باشد.
.SS MYSQL_CB_CREATE_UPDATE_SHARED_NETWORK6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
create or update shared network: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی صادر می‌شود که عملیاتی برای ایجاد یا به‌روزرسانی شبکه مشترک فعال شده باشد.
.SS MYSQL_CB_CREATE_UPDATE_SHARED_NETWORK_OPTION4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
create or update shared network: %1 option
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی صادر می‌شود که عملیاتی برای ایجاد یا به‌روزرسانی گزینهٔ شبکه مشترک فعال شده باشد..SS MYSQL_CB_CREATE_UPDATE_SHARED_NETWORK_OPTION6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
create or update shared network: %1 option
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیات ایجاد یا به‌روزرسانی گزینهٔ شبکهٔ اشتراکی صادر می‌شود.
.SS MYSQL_CB_CREATE_UPDATE_SUBNET4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
create or update subnet: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیات ایجاد یا به‌روزرسانی زیرشبکه صادر می‌شود.
.SS MYSQL_CB_CREATE_UPDATE_SUBNET6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
create or update subnet: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیات ایجاد یا به‌روزرسانی زیرشبکه صادر می‌شود.
.SS MYSQL_CB_DELETE_ALL_CLIENT_CLASSES4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete all client classes
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیات حذف تمام کلاس‌های کلاینت صادر می‌شود.
.SS MYSQL_CB_DELETE_ALL_CLIENT_CLASSES4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ عملیات حذف تمام کلاس‌های کلاینت است.
.SS MYSQL_CB_DELETE_ALL_CLIENT_CLASSES6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete all client classes
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیات حذف تمام کلاس‌های کلاینت صادر می‌شود.
.SS MYSQL_CB_DELETE_ALL_CLIENT_CLASSES6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ عملیات حذف تمام کلاس‌های کلاینت است.
.SS MYSQL_CB_DELETE_ALL_GLOBAL_PARAMETERS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete all global parameters
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیات حذف تمام پارامترهای سراسری صادر می‌شود.
.SS MYSQL_CB_DELETE_ALL_GLOBAL_PARAMETERS4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ عملیات حذف تمام پارامترهای سراسری است.
.SS MYSQL_CB_DELETE_ALL_GLOBAL_PARAMETERS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete all global parameters
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیات حذف تمام پارامترهای سراسری صادر می‌شود..SS MYSQL_CB_DELETE_ALL_GLOBAL_PARAMETERS6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نتیجهٔ عملیات حذف تمام پارامترهای سراسری را نشان می‌دهد.
.SS MYSQL_CB_DELETE_ALL_OPTION_DEFS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete all option definitions
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام راه‌اندازی عملیات حذف تمام تعاریف گزینه‌ها.
.SS MYSQL_CB_DELETE_ALL_OPTION_DEFS4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نتیجهٔ عملیات حذف تمام تعاریف گزینه‌ها را نشان می‌دهد.
.SS MYSQL_CB_DELETE_ALL_OPTION_DEFS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete all option definitions
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام راه‌اندازی عملیات حذف تمام تعاریف گزینه‌ها.
.SS MYSQL_CB_DELETE_ALL_OPTION_DEFS6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نتیجهٔ عملیات حذف تمام تعاریف گزینه‌ها را نشان می‌دهد.
.SS MYSQL_CB_DELETE_ALL_SERVERS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete all DHCPv4 servers
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام راه‌اندازی عملیات حذف تمام سرورها.
.SS MYSQL_CB_DELETE_ALL_SERVERS4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نتیجهٔ عملیات حذف تمام سرورها را نشان می‌دهد.
.SS MYSQL_CB_DELETE_ALL_SERVERS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete all DHCPv6 servers
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام راه‌اندازی عملیات حذف تمام سرورها.
.SS MYSQL_CB_DELETE_ALL_SERVERS6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نتیجهٔ عملیات حذف تمام سرورها را نشان می‌دهد.
.SS MYSQL_CB_DELETE_ALL_SHARED_NETWORKS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete all shared networks
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام راه‌اندازی عملیات حذف تمام شبکه‌های اشتراکی..SS MYSQL_CB_DELETE_ALL_SHARED_NETWORKS4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهنده نتیجه یک اقدام برای حذف همه شبکه‌های مشترک است.
.SS MYSQL_CB_DELETE_ALL_SHARED_NETWORKS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete all shared networks
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی اقدامی برای حذف همه شبکه‌های مشترک صادر می‌شود.
.SS MYSQL_CB_DELETE_ALL_SHARED_NETWORKS6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهنده نتیجه یک اقدام برای حذف همه شبکه‌های مشترک است.
.SS MYSQL_CB_DELETE_ALL_SUBNETS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete all subnets
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی اقدامی برای حذف همه زیرشبکه‌ها صادر می‌شود.
.SS MYSQL_CB_DELETE_ALL_SUBNETS4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهنده نتیجه یک اقدام برای حذف همه زیرشبکه‌ها است.
.SS MYSQL_CB_DELETE_ALL_SUBNETS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete all subnets
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی اقدامی برای حذف همه زیرشبکه‌ها صادر می‌شود.
.SS MYSQL_CB_DELETE_ALL_SUBNETS6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهنده نتیجه یک اقدام برای حذف همه زیرشبکه‌ها است.
.SS MYSQL_CB_DELETE_BY_POOL_OPTION4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete pool start: %1 pool end: %2 option code: %3 space: %4
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی اقدامی برای حذف گزینه بر اساس استخر صادر می‌شود.
.SS MYSQL_CB_DELETE_BY_POOL_OPTION4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهنده نتیجه یک اقدام برای حذف گزینه بر اساس استخر است.
.SS MYSQL_CB_DELETE_BY_POOL_OPTION6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete pool start: %1 pool end: %2 option code: %3 space: %4
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی اقدامی برای حذف گزینه بر اساس استخر صادر می‌شود..SS MYSQL_CB_DELETE_BY_POOL_OPTION6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ عملیات حذف گزینه بر اساس استخر (pool) است.
.SS MYSQL_CB_DELETE_BY_POOL_PREFIX_OPTION6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete prefix: %1 prefix len: %2 option code: %3 space: %4
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام آغاز عملیات حذف گزینه بر اساس پیشوند (prefix).
.SS MYSQL_CB_DELETE_BY_POOL_PREFIX_OPTION6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ عملیات حذف گزینه بر اساس پیشوند است.
.SS MYSQL_CB_DELETE_BY_PREFIX_SUBNET4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete subnet by prefix: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام آغاز عملیات حذف زیرشبکه (subnet) بر اساس پیشوند.
.SS MYSQL_CB_DELETE_BY_PREFIX_SUBNET4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ عملیات حذف زیرشبکه بر اساس پیشوند است.
.SS MYSQL_CB_DELETE_BY_PREFIX_SUBNET6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete subnet by prefix: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام آغاز عملیات حذف زیرشبکه بر اساس پیشوند.
.SS MYSQL_CB_DELETE_BY_PREFIX_SUBNET6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ عملیات حذف زیرشبکه بر اساس پیشوند است.
.SS MYSQL_CB_DELETE_BY_SUBNET_ID_OPTION4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete by subnet id: %1 option code: %2 space: %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام آغاز عملیات حذف گزینه بر اساس شناسهٔ زیرشبکه (subnet id).
.SS MYSQL_CB_DELETE_BY_SUBNET_ID_OPTION4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ عملیات حذف گزینه بر اساس شناسهٔ زیرشبکه است.
.SS MYSQL_CB_DELETE_BY_SUBNET_ID_OPTION6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete by subnet id: %1 option code: %2 space: %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام آغاز عملیات حذف گزینه بر اساس شناسهٔ زیرشبکه..SS MYSQL_CB_DELETE_BY_SUBNET_ID_OPTION6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش‌گیری اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ عملیات حذف گزینه بر اساس شناسهٔ زیرشبکه (subnet id) است.
.SS MYSQL_CB_DELETE_BY_SUBNET_ID_SUBNET4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete subnet by subnet id: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش‌گیری اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام آغاز عملیات حذف زیرشبکه بر اساس شناسهٔ زیرشبکه صادر می‌شود.
.SS MYSQL_CB_DELETE_BY_SUBNET_ID_SUBNET4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش‌گیری اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ عملیات حذف زیرشبکه بر اساس شناسهٔ زیرشبکه است.
.SS MYSQL_CB_DELETE_BY_SUBNET_ID_SUBNET6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete subnet by subnet id: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش‌گیری اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام آغاز عملیات حذف زیرشبکه بر اساس شناسهٔ زیرشبکه صادر می‌شود.
.SS MYSQL_CB_DELETE_BY_SUBNET_ID_SUBNET6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش‌گیری اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ عملیات حذف زیرشبکه بر اساس شناسهٔ زیرشبکه است.
.SS MYSQL_CB_DELETE_CLIENT_CLASS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete client class: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش‌گیری اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام آغاز عملیات حذف کلاس کلاینت (client class) صادر می‌شود.
.SS MYSQL_CB_DELETE_CLIENT_CLASS4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش‌گیری اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ عملیات حذف کلاس کلاینت است.
.SS MYSQL_CB_DELETE_CLIENT_CLASS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete client class: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش‌گیری اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام آغاز عملیات حذف کلاس کلاینت صادر می‌شود.
.SS MYSQL_CB_DELETE_CLIENT_CLASS6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش‌گیری اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ عملیات حذف کلاس کلاینت است.
.SS MYSQL_CB_DELETE_GLOBAL_PARAMETER4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete global parameter: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش‌گیری اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام آغاز عملیات حذف پارامتر سراسری (global parameter) صادر می‌شود..SS MYSQL_CB_DELETE_GLOBAL_PARAMETER4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 40 ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ عملیات حذف پارامتر سراسری است.
.SS MYSQL_CB_DELETE_GLOBAL_PARAMETER6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete global parameter: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 40 ثبت می‌شود.
پیام اشکال‌زدایی که هنگام فراخوانی عملیات حذف پارامتر سراسری صادر می‌شود.
.SS MYSQL_CB_DELETE_GLOBAL_PARAMETER6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 40 ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ عملیات حذف پارامتر سراسری است.
.SS MYSQL_CB_DELETE_OPTION4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete option code: %1 space: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 40 ثبت می‌شود.
پیام اشکال‌زدایی که هنگام فراخوانی عملیات حذف گزینه صادر می‌شود.
.SS MYSQL_CB_DELETE_OPTION4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 40 ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ عملیات حذف گزینه است.
.SS MYSQL_CB_DELETE_OPTION6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete option code: %1 space: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 40 ثبت می‌شود.
پیام اشکال‌زدایی که هنگام فراخوانی عملیات حذف گزینه صادر می‌شود.
.SS MYSQL_CB_DELETE_OPTION6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 40 ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ عملیات حذف گزینه است.
.SS MYSQL_CB_DELETE_OPTION_DEF4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete option definition code: %1 space: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 40 ثبت می‌شود.
پیام اشکال‌زدایی که هنگام فراخوانی عملیات حذف تعریف گزینه صادر می‌شود.
.SS MYSQL_CB_DELETE_OPTION_DEF4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 40 ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ عملیات حذف تعریف گزینه است.
.SS MYSQL_CB_DELETE_OPTION_DEF6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete option definition code: %1 space: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 40 ثبت می‌شود.
پیام اشکال‌زدایی که هنگام فراخوانی عملیات حذف تعریف گزینه صادر می‌شود..SS MYSQL_CB_DELETE_OPTION_DEF6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهنده نتیجه عملیات حذف تعریف گزینه (option definition) است.
.SS MYSQL_CB_DELETE_SERVER4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete DHCPv4 server: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام آغاز عملیات حذف یک سرور.
.SS MYSQL_CB_DELETE_SERVER4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهنده نتیجه عملیات حذف یک سرور است.
.SS MYSQL_CB_DELETE_SERVER6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete DHCPv6 server: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام آغاز عملیات حذف یک سرور.
.SS MYSQL_CB_DELETE_SERVER6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهنده نتیجه عملیات حذف یک سرور است.
.SS MYSQL_CB_DELETE_SHARED_NETWORK4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete shared network: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام آغاز عملیات حذف شبکه مشترک (shared network).
.SS MYSQL_CB_DELETE_SHARED_NETWORK4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهنده نتیجه عملیات حذف شبکه مشترک (shared network) است.
.SS MYSQL_CB_DELETE_SHARED_NETWORK6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete shared network: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام آغاز عملیات حذف شبکه مشترک (shared network).
.SS MYSQL_CB_DELETE_SHARED_NETWORK6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهنده نتیجه عملیات حذف شبکه مشترک (shared network) است.
.SS MYSQL_CB_DELETE_SHARED_NETWORK_OPTION4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete shared network: %1 option code: %2 space: %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام آغاز عملیات حذف گزینه شبکه مشترک (shared network option)..SS MYSQL_CB_DELETE_SHARED_NETWORK_OPTION4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی نشان‌دهندهٔ نتیجهٔ عملیات حذف گزینهٔ شبکه مشترک.
.SS MYSQL_CB_DELETE_SHARED_NETWORK_OPTION6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete shared network: %1 option code: %2 space: %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیات حذف گزینهٔ شبکه مشترک صادر می‌شود.
.SS MYSQL_CB_DELETE_SHARED_NETWORK_OPTION6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی نشان‌دهندهٔ نتیجهٔ عملیات حذف گزینهٔ شبکه مشترک.
.SS MYSQL_CB_DELETE_SHARED_NETWORK_SUBNETS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete shared network: %1 subnets
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیات حذف زیرشبکه‌های شبکه مشترک صادر می‌شود.
.SS MYSQL_CB_DELETE_SHARED_NETWORK_SUBNETS4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی نشان‌دهندهٔ نتیجهٔ عملیات حذف زیرشبکه‌های شبکه مشترک.
.SS MYSQL_CB_DELETE_SHARED_NETWORK_SUBNETS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete shared network: %1 subnets
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیات حذف زیرشبکه‌های شبکه مشترک صادر می‌شود.
.SS MYSQL_CB_DELETE_SHARED_NETWORK_SUBNETS6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی نشان‌دهندهٔ نتیجهٔ عملیات حذف زیرشبکه‌های شبکه مشترک.
.SS MYSQL_CB_GET_ALL_CLIENT_CLASSES4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving all client classes
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیات بازیابی تمام کلاس‌های کلاینت صادر می‌شود.
.SS MYSQL_CB_GET_ALL_CLIENT_CLASSES4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی نشان‌دهندهٔ نتیجهٔ عملیات بازیابی تمام کلاس‌های کلاینت.
.SS MYSQL_CB_GET_ALL_CLIENT_CLASSES6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving all client classes
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیات بازیابی تمام کلاس‌های کلاینت صادر می‌شود..SS MYSQL_CB_GET_ALL_CLIENT_CLASSES6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 40 ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ عملیات بازیابی تمام کلاس‌های کلاینت است.
.SS MYSQL_CB_GET_ALL_GLOBAL_PARAMETERS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving all global parameters
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 40 ثبت می‌شود.
پیام اشکال‌زدایی که هنگام آغاز عملیات بازیابی تمام پارامترهای سراسری صادر می‌شود.
.SS MYSQL_CB_GET_ALL_GLOBAL_PARAMETERS4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 40 ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ عملیات بازیابی تمام پارامترهای سراسری است.
.SS MYSQL_CB_GET_ALL_GLOBAL_PARAMETERS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving all global parameters
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 40 ثبت می‌شود.
پیام اشکال‌زدایی که هنگام آغاز عملیات بازیابی تمام پارامترهای سراسری صادر می‌شود.
.SS MYSQL_CB_GET_ALL_GLOBAL_PARAMETERS6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 40 ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ عملیات بازیابی تمام پارامترهای سراسری است.
.SS MYSQL_CB_GET_ALL_OPTIONS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving all options
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 40 ثبت می‌شود.
پیام اشکال‌زدایی که هنگام آغاز عملیات بازیابی تمام گزینه‌ها صادر می‌شود.
.SS MYSQL_CB_GET_ALL_OPTIONS4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 40 ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ عملیات بازیابی تمام گزینه‌ها است.
.SS MYSQL_CB_GET_ALL_OPTIONS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving all options
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 40 ثبت می‌شود.
پیام اشکال‌زدایی که هنگام آغاز عملیات بازیابی تمام گزینه‌ها صادر می‌شود.
.SS MYSQL_CB_GET_ALL_OPTIONS6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 40 ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ عملیات بازیابی تمام گزینه‌ها است.
.SS MYSQL_CB_GET_ALL_OPTION_DEFS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving all option definitions
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 40 ثبت می‌شود.
پیام اشکال‌زدایی که هنگام آغاز عملیات بازیابی تمام تعاریف گزینه‌ها صادر می‌شود..SS MYSQL_CB_GET_ALL_OPTION_DEFS4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ یک عملیات برای دریافت تمام تعاریف گزینه است.
.SS MYSQL_CB_GET_ALL_OPTION_DEFS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving all option definitions
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیاتی جهت دریافت تمام تعاریف گزینه صادر می‌شود.
.SS MYSQL_CB_GET_ALL_OPTION_DEFS6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ یک عملیات برای دریافت تمام تعاریف گزینه است.
.SS MYSQL_CB_GET_ALL_SERVERS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving all servers
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیاتی جهت دریافت تمام سرورهای DHCPv4
صادر می‌شود.
.SS MYSQL_CB_GET_ALL_SERVERS4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ یک عملیات برای دریافت تمام سرورهای DHCPv4
است.
.SS MYSQL_CB_GET_ALL_SERVERS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving all DHCPv6 servers
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیاتی جهت دریافت تمام سرورهای DHCPv6
صادر می‌شود.
.SS MYSQL_CB_GET_ALL_SERVERS6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ یک عملیات برای دریافت تمام سرورهای DHCPv6
است.
.SS MYSQL_CB_GET_ALL_SHARED_NETWORKS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving all shared networks
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیاتی جهت دریافت تمام شبکه‌های مشترک صادر می‌شود.
.SS MYSQL_CB_GET_ALL_SHARED_NETWORKS4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ یک عملیات برای دریافت تمام شبکه‌های مشترک است.
.SS MYSQL_CB_GET_ALL_SHARED_NETWORKS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving all shared networks
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیاتی جهت دریافت تمام شبکه‌های مشترک صادر می‌شود..SS MYSQL_CB_GET_ALL_SHARED_NETWORKS6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهنده نتیجه عملیات بازیابی تمام شبکه‌های مشترک است.
.SS MYSQL_CB_GET_ALL_SUBNETS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving all subnets
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام آغاز عملیات بازیابی تمام زیرشبکه‌ها.
.SS MYSQL_CB_GET_ALL_SUBNETS4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهنده نتیجه عملیات بازیابی تمام زیرشبکه‌ها است.
.SS MYSQL_CB_GET_ALL_SUBNETS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving all subnets
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام آغاز عملیات بازیابی تمام زیرشبکه‌ها.
.SS MYSQL_CB_GET_ALL_SUBNETS6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهنده نتیجه عملیات بازیابی تمام زیرشبکه‌ها است.
.SS MYSQL_CB_GET_CLIENT_CLASS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving client class: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام آغاز عملیات بازیابی یک کلاس کلاینت.
.SS MYSQL_CB_GET_CLIENT_CLASS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving client class: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام آغاز عملیات بازیابی یک کلاس کلاینت.
.SS MYSQL_CB_GET_GLOBAL_PARAMETER4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving global parameter: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام آغاز عملیات بازیابی پارامتر سراسری.
.SS MYSQL_CB_GET_GLOBAL_PARAMETER6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving global parameter: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام آغاز عملیات بازیابی پارامتر سراسری.
.SS MYSQL_CB_GET_HOST4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
get host
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام آغاز عملیات بازیابی میزبان..SS MYSQL_CB_GET_HOST6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
get host
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام آغاز عملیاتی برای بازیابی میزبان (host).
.SS MYSQL_CB_GET_MODIFIED_CLIENT_CLASSES4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving modified client classes from: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام آغاز عملیاتی برای بازیابی کلاس‌های کلاینت تغییریافته از زمان مشخص‌شده.
.SS MYSQL_CB_GET_MODIFIED_CLIENT_CLASSES4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهنده نتیجه عملیات بازیابی کلاس‌های کلاینت تغییریافته از زمان مشخص‌شده است.
.SS MYSQL_CB_GET_MODIFIED_CLIENT_CLASSES6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving modified client classes from: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام آغاز عملیاتی برای بازیابی کلاس‌های کلاینت تغییریافته از زمان مشخص‌شده.
.SS MYSQL_CB_GET_MODIFIED_CLIENT_CLASSES6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهنده نتیجه عملیات بازیابی کلاس‌های کلاینت تغییریافته از زمان مشخص‌شده است.
.SS MYSQL_CB_GET_MODIFIED_GLOBAL_PARAMETERS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving modified global parameters from: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام آغاز عملیاتی برای بازیابی پارامترهای سراسری تغییریافته از زمان مشخص‌شده.
.SS MYSQL_CB_GET_MODIFIED_GLOBAL_PARAMETERS4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهنده نتیجه عملیات بازیابی پارامترهای سراسری تغییریافته از زمان مشخص‌شده است.
.SS MYSQL_CB_GET_MODIFIED_GLOBAL_PARAMETERS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving modified global parameters from: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام آغاز عملیاتی برای بازیابی پارامترهای سراسری تغییریافته از زمان مشخص‌شده.
.SS MYSQL_CB_GET_MODIFIED_GLOBAL_PARAMETERS6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهنده نتیجه عملیات بازیابی پارامترهای سراسری تغییریافته از زمان مشخص‌شده است.
.SS MYSQL_CB_GET_MODIFIED_OPTIONS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving modified options from: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام آغاز عملیاتی برای بازیابی گزینه‌های تغییریافته از زمان مشخص‌شده..SS MYSQL_CB_GET_MODIFIED_OPTIONS4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نتیجهٔ یک عملیات برای بازیابی گزینه‌های تغییریافته از زمان مشخص‌شده را نشان می‌دهد.
.SS MYSQL_CB_GET_MODIFIED_OPTIONS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving modified options from: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام آغاز عملیاتی برای بازیابی گزینه‌های تغییریافته از زمان مشخص‌شده صادر می‌شود.
.SS MYSQL_CB_GET_MODIFIED_OPTIONS6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نتیجهٔ یک عملیات برای بازیابی گزینه‌های تغییریافته از زمان مشخص‌شده را نشان می‌دهد.
.SS MYSQL_CB_GET_MODIFIED_OPTION_DEFS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving modified option definitions from: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام آغاز عملیاتی برای بازیابی تعاریف گزینه‌های تغییریافته از زمان مشخص‌شده صادر می‌شود.
.SS MYSQL_CB_GET_MODIFIED_OPTION_DEFS4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نتیجهٔ یک عملیات برای بازیابی تعاریف گزینه‌های تغییریافته از زمان مشخص‌شده را نشان می‌دهد.
.SS MYSQL_CB_GET_MODIFIED_OPTION_DEFS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving modified option definitions from: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام آغاز عملیاتی برای بازیابی تعاریف گزینه‌های تغییریافته از زمان مشخص‌شده صادر می‌شود.
.SS MYSQL_CB_GET_MODIFIED_OPTION_DEFS6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نتیجهٔ یک عملیات برای بازیابی تعاریف گزینه‌های تغییریافته از زمان مشخص‌شده را نشان می‌دهد.
.SS MYSQL_CB_GET_MODIFIED_SHARED_NETWORKS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving modified shared networks from: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام آغاز عملیاتی برای بازیابی شبکه‌های مشترک تغییریافته از زمان مشخص‌شده صادر می‌شود.
.SS MYSQL_CB_GET_MODIFIED_SHARED_NETWORKS4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نتیجهٔ یک عملیات برای بازیابی شبکه‌های مشترک تغییریافته از زمان مشخص‌شده را نشان می‌دهد.
.SS MYSQL_CB_GET_MODIFIED_SHARED_NETWORKS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving modified shared networks from: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام آغاز عملیاتی برای بازیابی شبکه‌های مشترک تغییریافته از زمان مشخص‌شده صادر می‌شود..SS MYSQL_CB_GET_MODIFIED_SHARED_NETWORKS6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نتیجه یک عملیات برای دریافت شبکه‌های اشتراکی تغییریافته از زمانی مشخص را نشان می‌دهد.
.SS MYSQL_CB_GET_MODIFIED_SUBNETS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving modified subnets from: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیات دریافت زیرشبکه‌های تغییریافته از زمانی مشخص صادر می‌شود.
.SS MYSQL_CB_GET_MODIFIED_SUBNETS4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نتیجه یک عملیات برای دریافت زیرشبکه‌های تغییریافته از زمانی مشخص را نشان می‌دهد.
.SS MYSQL_CB_GET_MODIFIED_SUBNETS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving modified subnets from: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیات دریافت زیرشبکه‌های تغییریافته از زمانی مشخص صادر می‌شود.
.SS MYSQL_CB_GET_MODIFIED_SUBNETS6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نتیجه یک عملیات برای دریافت زیرشبکه‌های تغییریافته از زمانی مشخص را نشان می‌دهد.
.SS MYSQL_CB_GET_OPTION4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving option code: %1 space: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیات دریافت گزینه صادر می‌شود.
.SS MYSQL_CB_GET_OPTION6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving option code: %1 space: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیات دریافت گزینه صادر می‌شود.
.SS MYSQL_CB_GET_OPTION_DEF4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving option definition code: %1 space: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیات دریافت تعریف گزینه صادر می‌شود.
.SS MYSQL_CB_GET_OPTION_DEF6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving option definition code: %1 space: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیات دریافت تعریف گزینه صادر می‌شود.
.SS MYSQL_CB_GET_PORT4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
get port
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیات دریافت پورت صادر می‌شود..SS MYSQL_CB_GET_PORT6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
get port
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیاتی برای بازیابی درگاه صادر می‌شود.
.SS MYSQL_CB_GET_RECENT_AUDIT_ENTRIES4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving audit entries from: %1 %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیاتی برای بازیابی ورودی‌های بازرسی از زمان و شناسهٔ مشخص‌شده صادر می‌شود.
.SS MYSQL_CB_GET_RECENT_AUDIT_ENTRIES4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نتیجهٔ عملیات بازیابی ورودی‌های بازرسی از زمان مشخص‌شده را نشان می‌دهد.
.SS MYSQL_CB_GET_RECENT_AUDIT_ENTRIES6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving audit entries from: %1 %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیاتی برای بازیابی ورودی‌های بازرسی از زمان و شناسهٔ مشخص‌شده صادر می‌شود.
.SS MYSQL_CB_GET_RECENT_AUDIT_ENTRIES6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نتیجهٔ عملیات بازیابی ورودی‌های بازرسی از زمان مشخص‌شده را نشان می‌دهد.
.SS MYSQL_CB_GET_SERVER4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving DHCPv4 server: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیاتی برای بازیابی اطلاعات سرور DHCPv4 صادر می‌شود.
.SS MYSQL_CB_GET_SERVER6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving DHCPv6 server: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیاتی برای بازیابی اطلاعات سرور DHCPv6 صادر می‌شود.
.SS MYSQL_CB_GET_SHARED_NETWORK4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving shared network: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیاتی برای بازیابی شبکهٔ مشترک صادر می‌شود.
.SS MYSQL_CB_GET_SHARED_NETWORK6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving shared network: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیاتی برای بازیابی شبکهٔ مشترک صادر می‌شود.
.SS MYSQL_CB_GET_SHARED_NETWORK_SUBNETS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving shared network: %1 subnets
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیاتی برای بازیابی زیرشبکه‌های شبکهٔ مشترک صادر می‌شود..SS MYSQL_CB_GET_SHARED_NETWORK_SUBNETS4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ عملیات بازیابی زیرشبکه‌های شبکهٔ اشتراکی (shared network) است.
.SS MYSQL_CB_GET_SHARED_NETWORK_SUBNETS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving shared network: %1 subnets
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام آغاز عملیات برای بازیابی زیرشبکه‌های شبکهٔ اشتراکی (shared network) صادر می‌شود.
.SS MYSQL_CB_GET_SHARED_NETWORK_SUBNETS6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ عملیات بازیابی زیرشبکه‌های شبکهٔ اشتراکی (shared network) است.
.SS MYSQL_CB_GET_SUBNET4_BY_PREFIX
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving subnet by prefix: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام آغاز عملیات برای بازیابی زیرشبکه بر اساس پیشوند (prefix) صادر می‌شود.
.SS MYSQL_CB_GET_SUBNET4_BY_SUBNET_ID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving subnet by subnet id: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام آغاز عملیات برای بازیابی زیرشبکه بر اساس شناسهٔ زیرشبکه (subnet id) صادر می‌شود.
.SS MYSQL_CB_GET_SUBNET6_BY_PREFIX
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving subnet by prefix: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام آغاز عملیات برای بازیابی زیرشبکه بر اساس پیشوند (prefix) صادر می‌شود.
.SS MYSQL_CB_GET_SUBNET6_BY_SUBNET_ID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving subnet by subnet id: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام آغاز عملیات برای بازیابی زیرشبکه بر اساس شناسهٔ زیرشبکه (subnet id) صادر می‌شود.
.SS MYSQL_CB_GET_TYPE4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
get type
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام آغاز عملیات برای بازیابی نوع (type) صادر می‌شود.
.SS MYSQL_CB_GET_TYPE6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
get type
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام آغاز عملیات برای بازیابی نوع (type) صادر می‌شود.
.SS MYSQL_CB_NO_TLS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
TLS was required but is not used
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که TLS برای اتصال الزامی بوده اما TLS استفاده نشده است..SS MYSQL_CB_RECONNECT_ATTEMPT_FAILED4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
database reconnect failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
پیام خطای صادرشده هنگامی که تلاش برای برقراری مجدد اتصال با شکست مواجه شده است.
.SS MYSQL_CB_RECONNECT_ATTEMPT_FAILED6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
database reconnect failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
پیام خطای صادرشده هنگامی که تلاش برای برقراری مجدد اتصال با شکست مواجه شده است.
.SS MYSQL_CB_RECONNECT_ATTEMPT_SCHEDULE4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
scheduling attempt %1 of %2 in %3 milliseconds
.EE
.UNINDENT
.UNINDENT
.sp
پیام اطلاعاتی صادرشده هنگامی که سرور در حال زمان‌بندی تلاش بعدی برای اتصال مجدد
به پایگاه داده است. این رویداد هنگامی رخ می‌دهد که ارتباط سرور با پایگاه داده قطع شده باشد
و سرور تلاش کند به‌طور خودکار دوباره متصل شود.
.SS MYSQL_CB_RECONNECT_ATTEMPT_SCHEDULE6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
scheduling attempt %1 of %2 in %3 milliseconds
.EE
.UNINDENT
.UNINDENT
.sp
پیام اطلاعاتی صادرشده هنگامی که سرور در حال زمان‌بندی تلاش بعدی برای اتصال مجدد
به پایگاه داده است. این رویداد هنگامی رخ می‌دهد که ارتباط سرور با پایگاه داده قطع شده باشد
و سرور تلاش کند به‌طور خودکار دوباره متصل شود.
.SS MYSQL_CB_RECONNECT_FAILED4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
maximum number of database reconnect attempts: %1, has been exhausted without success
.EE
.UNINDENT
.UNINDENT
.sp
پیام خطای صادرشده هنگامی که سرور در برقراری مجدد اتصال ناموفق بوده است. قطع ارتباط
معمولاً یک مشکل در شبکه یا سرور پایگاه داده است.
.SS MYSQL_CB_RECONNECT_FAILED6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
maximum number of database reconnect attempts: %1, has been exhausted without success
.EE
.UNINDENT
.UNINDENT
.sp
پیام خطای صادرشده هنگامی که سرور در برقراری مجدد اتصال ناموفق بوده است. قطع ارتباط
معمولاً یک مشکل در شبکه یا سرور پایگاه داده است.
.SS MYSQL_CB_REGISTER_BACKEND_TYPE4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
register backend
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگامی که عملیاتی برای ثبت backend فعال شده باشد.
.SS MYSQL_CB_REGISTER_BACKEND_TYPE6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
register backend
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگامی که عملیاتی برای ثبت backend فعال شده باشد.
.SS MYSQL_CB_TLS_CIPHER
.INDENT 0.0
.INDENT 3.5
.sp
.EX
TLS cipher: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک اتصال جدید به MySQL با TLS ایجاد شود.
نام سایفر (cipher) مورد استفاده در TLS در لاگ ثبت می‌شود.
.SS MYSQL_CB_UNREGISTER_BACKEND_TYPE4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
unregister backend
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگامی که عملیاتی برای لغو ثبت backend فعال شده باشد..SS MYSQL_CB_UNREGISTER_BACKEND_TYPE6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
unregister backend
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام فعال شدن عملیاتی برای لغو ثبت backend.
.SS MYSQL_DEINIT_OK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
unloading MySQL hooks library successful
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که کتابخانهٔ قلاب‌های (hooks) مربوط به MySQL Backend با موفقیت تخلیه (unload) شده است.
.SS MYSQL_FB_DB
.INDENT 0.0
.INDENT 3.5
.sp
.EX
opening MySQL log database: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی زمانی ثبت می‌شود که کتابخانهٔ قلاب ثبت وقایع قانونی (legal log hook library) در شرف باز کردن یک پایگاه‌دادهٔ لاگ MySQL است. پارامترهای اتصال شامل نام پایگاه‌داده و نام کاربری لازم برای دسترسی به آن (به‌جز گذرواژه در صورت وجود) ثبت می‌شوند.
.SS MYSQL_HB_DB
.INDENT 0.0
.INDENT 3.5
.sp
.EX
opening MySQL hosts database: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی زمانی ثبت می‌شود که یک کارگزار DHCP (چه V4 و چه V6) در شرف باز کردن پایگاه‌دادهٔ میزبان‌های MySQL است. پارامترهای اتصال شامل نام پایگاه‌داده و نام کاربری لازم برای دسترسی به آن (به‌جز گذرواژه در صورت وجود) ثبت می‌شوند.
.SS MYSQL_HB_DB_GET_VERSION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining schema version information for the MySQL hosts database
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارگزار در شرف دریافت اطلاعات نگارش طرح‌واره (schema version) از پایگاه‌دادهٔ میزبان‌های MySQL است.
.SS MYSQL_HB_DB_READONLY
.INDENT 0.0
.INDENT 3.5
.sp
.EX
MySQL host database opened for read access only
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی زمانی صادر می‌شود که کاربر پایگاه‌دادهٔ MySQL را در حالت فقط‌خواندنی (read\-only) پیکربندی کرده باشد. Kea قادر به درج یا ویرایش رزروهای میزبان (host reservations) نخواهد بود، اما می‌تواند موارد موجود را بازیابی کرده و آن‌ها را به کلاینت‌هایی که با کارگزار ارتباط برقرار می‌کنند اختصاص دهد.
.SS MYSQL_HB_DB_RECONNECT_ATTEMPT_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
database reconnect failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
پیام خطایی که هنگام ناموفق بودن تلاش برای اتصال مجدد صادر می‌شود.
.SS MYSQL_HB_DB_RECONNECT_ATTEMPT_SCHEDULE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
scheduling attempt %1 of %2 in %3 milliseconds
.EE
.UNINDENT
.UNINDENT
.sp
پیام اطلاع‌رسانی که زمانی صادر می‌شود که کارگزار در حال زمان‌بندی تلاش بعدی برای اتصال مجدد به پایگاه‌داده است. این حالت زمانی رخ می‌دهد که اتصال کارگزار با پایگاه‌داده قطع شده باشد و در تلاش است به‌طور خودکار دوباره متصل شود.
.SS MYSQL_HB_DB_RECONNECT_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
maximum number of database reconnect attempts: %1, has been exhausted without success
.EE
.UNINDENT
.UNINDENT
.sp
پیام خطایی که هنگام ناموفق بودن نهایی کارگزار در برقراری مجدد اتصال صادر می‌شود. قطعی اتصال معمولاً ناشی از مشکلات شبکه یا کارگزار پایگاه‌داده است.
.SS MYSQL_HB_NO_TLS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
TLS was required but is not used
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که TLS برای اتصال الزامی بوده اما استفاده نشده است..SS MYSQL_HB_TLS_CIPHER
.INDENT 0.0
.INDENT 3.5
.sp
.EX
TLS cipher: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام دیباگ زمانی صادر می‌شود که یک اتصال جدید به MySQL با TLS برقرار گردد.
نام TLS cipher ثبت می‌شود.
.SS MYSQL_INIT_OK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
loading MySQL hooks library successful
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که کتابخانهٔ قلاب‌های (hooks) پشتیبان
MySQL با موفقیت بارگذاری شده است. لذت ببرید!
.SS MYSQL_LB_ADD_ADDR4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
adding IPv4 lease with address %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام دیباگ هنگامی صادر می‌شود که سرور در آستانهٔ افزودن یک اجارهٔ IPv4
با نشانی مشخص‌شده به پایگاه‌دادهٔ پشتیبان MySQL باشد.
.SS MYSQL_LB_ADD_ADDR6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
adding IPv6 lease with address %1, lease type %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام دیباگ هنگامی صادر می‌شود که سرور در آستانهٔ افزودن یک اجارهٔ IPv6
با نشانی مشخص‌شده به پایگاه‌دادهٔ پشتیبان MySQL باشد.
.SS MYSQL_LB_COMMIT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
committing to MySQL database
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
کد یک فراخوانی commit صادر کرده است. تمام تراکنش‌های معلق در پایگاه‌داده
تثبیت (commit) خواهند شد. توجه داشته باشید که بسته به تنظیمات MySQL،
این تثبیت ممکن است لزوماً شامل نوشتن روی دیسک نباشد.
.SS MYSQL_LB_DB
.INDENT 0.0
.INDENT 3.5
.sp
.EX
opening MySQL lease database: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی زمانی ثبت می‌شود که یک سرور DHCP (خواه نسخهٔ ۴ یا
نسخهٔ ۶) در آستانهٔ باز کردن پایگاه‌دادهٔ اجاره‌های MySQL باشد. پارامترهای
اتصال شامل نام پایگاه‌داده و نام کاربری لازم برای دسترسی به آن (اما نه
گذرواژه در صورت وجود) در گزارش ثبت می‌شوند.
.SS MYSQL_LB_DB_RECONNECT_ATTEMPT_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
database reconnect failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
پیام خطایی که هنگام ناموفق بودن تلاش برای اتصال مجدد صادر می‌شود.
.SS MYSQL_LB_DB_RECONNECT_ATTEMPT_SCHEDULE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
scheduling attempt %1 of %2 in %3 milliseconds
.EE
.UNINDENT
.UNINDENT
.sp
پیام اطلاع‌رسانی صادرشده در هنگامی که سرور در حال زمان‌بندی تلاش بعدی برای
اتصال مجدد به پایگاه‌داده است. این وضعیت زمانی رخ می‌دهد که اتصال سرور به
پایگاه‌داده قطع شده باشد و در حال تلاش برای اتصال مجدد خودکار باشد.
.SS MYSQL_LB_DB_RECONNECT_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
maximum number of database reconnect attempts: %1, has been exhausted without success
.EE
.UNINDENT
.UNINDENT
.sp
پیام خطایی که هنگام ناموفق بودن سرور در برقراری مجدد اتصال صادر می‌شود. قطع
ارتباط معمولاً به دلیل مشکلی در شبکه یا سرور پایگاه‌داده رخ می‌دهد.
.SS MYSQL_LB_DELETED_EXPIRED_RECLAIMED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted %1 reclaimed leases from the database
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام دیباگ زمانی صادر می‌شود که سرور تعدادی از اجاره‌های بازپس‌گرفته‌شده
را از پایگاه‌داده حذف کرده باشد. تعداد اجاره‌های حذف‌شده در متن پیام گنجانده
می‌شود..SS MYSQL_LB_DELETED_SUBNET4_ID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted %1 leases that match subnet ID %2.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارساز در حال حذف اجاره‌هایی است که با
شناسه زیرشبکه مربوطه مطابقت دارند.
.SS MYSQL_LB_DELETED_SUBNET6_ID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted %1 leases that match subnet ID %2.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارساز در حال حذف اجاره‌هایی است که با
شناسه زیرشبکه مربوطه مطابقت دارند.
.SS MYSQL_LB_DELETE_ADDR4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleting lease for address %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارساز در حال تلاش برای حذف اجاره مربوط به
نشانی مشخص‌شده از پایگاه‌داده MySQL است.
.SS MYSQL_LB_DELETE_ADDR6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleting lease for address %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارساز در حال تلاش برای حذف اجاره مربوط به
نشانی مشخص‌شده از پایگاه‌داده MySQL است.
.SS MYSQL_LB_DELETE_EXPIRED_RECLAIMED4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleting reclaimed IPv4 leases that expired more than %1 seconds ago
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارساز در حال حذف اجاره‌های بازپس‌گرفته‌شده DHCPv4
است که بیش از یک بازه زمانی مشخص منقضی شده‌اند.
آرگومان، مدت‌زمانی است که Kea پس از انقضای یک اجاره بازپس‌گرفته‌شده، پیش از اقدام به حذف آن منتظر می‌ماند.
.SS MYSQL_LB_DELETE_EXPIRED_RECLAIMED6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleting reclaimed IPv6 leases that expired more than %1 seconds ago
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارساز در حال حذف اجاره‌های بازپس‌گرفته‌شده DHCPv6
است که بیش از یک بازه زمانی مشخص منقضی شده‌اند.
آرگومان، مدت‌زمانی است که Kea پس از انقضای یک اجاره بازپس‌گرفته‌شده، پیش از اقدام به حذف آن منتظر می‌ماند.
.SS MYSQL_LB_GET4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining all IPv4 leases
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارساز در حال تلاش برای دریافت تمامی
اجاره‌های IPv4 از پایگاه‌داده MySQL است.
.SS MYSQL_LB_GET6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining all IPv6 leases
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارساز در حال تلاش برای دریافت تمامی
اجاره‌های IPv6 از پایگاه‌داده MySQL است.
.SS MYSQL_LB_GET_ADDR4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv4 lease for address %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارساز در حال تلاش برای دریافت یک
اجاره IPv4 برای نشانی مشخص‌شده از پایگاه‌داده MySQL است..SS MYSQL_LB_GET_ADDR6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv6 lease for address %1, lease type %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی صادر می‌شود که کارساز در تلاش است تا یک اجارهٔ IPv6 را از پایگاه دادهٔ MySQL برای نشانی مشخص‌شده دریافت کند.
.SS MYSQL_LB_GET_CLIENTID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv4 leases for client ID %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی صادر می‌شود که کارساز در تلاش است تا مجموعه‌ای از اجاره‌های IPv4 را از پایگاه دادهٔ MySQL برای کلاینتی با شناسهٔ کلاینت (client ID) مشخص‌شده دریافت کند.
.SS MYSQL_LB_GET_DUID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv6 lease for duid %1,
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی صادر می‌شود که کارساز در تلاش است تا یک اجارهٔ IPv6 را از پایگاه دادهٔ MySQL برای duid مشخص‌شده دریافت کند.
.SS MYSQL_LB_GET_EXPIRED4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining maximum %1 of expired IPv4 leases
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی صادر می‌شود که کارساز در تلاش است تا اجاره‌های منقضی‌شدهٔ IPv4 را به منظور بازپس‌گیری آن‌ها دریافت کند. حداکثر تعداد اجاره‌های قابل بازیابی در این پیام ثبت می‌شود.
.SS MYSQL_LB_GET_EXPIRED6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining maximum %1 of expired IPv6 leases
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی صادر می‌شود که کارساز در تلاش است تا اجاره‌های منقضی‌شدهٔ IPv6 را به منظور بازپس‌گیری آن‌ها دریافت کند. حداکثر تعداد اجاره‌های قابل بازیابی در این پیام ثبت می‌شود.
.SS MYSQL_LB_GET_HOSTNAME4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv4 leases for hostname %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی صادر می‌شود که کارساز در تلاش است تا مجموعه‌ای از اجاره‌های IPv4 را از پایگاه دادهٔ MySQL برای کلاینتی با hostname مشخص‌شده دریافت کند.
.SS MYSQL_LB_GET_HOSTNAME6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv6 leases for hostname %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی صادر می‌شود که کارساز در تلاش است تا مجموعه‌ای از اجاره‌های IPv6 را از پایگاه دادهٔ MySQL برای کلاینتی با hostname مشخص‌شده دریافت کند.
.SS MYSQL_LB_GET_HWADDR4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv4 leases for hardware address %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی صادر می‌شود که کارساز در تلاش است تا مجموعه‌ای از اجاره‌های IPv4 را از پایگاه دادهٔ MySQL برای کلاینتی با نشانی سخت‌افزاری (hardware address) مشخص‌شده دریافت کند.
.SS MYSQL_LB_GET_HWADDR6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv6 leases for hardware address %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی صادر می‌شود که کارساز در تلاش است تا مجموعه‌ای از اجاره‌های IPv6 را از پایگاه دادهٔ MySQL برای کلاینتی با نشانی سخت‌افزاری (hardware address) مشخص‌شده دریافت کند..SS MYSQL_LB_GET_IAID_DUID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv6 leases for IAID %1, DUID %2, lease type %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارساز تلاش می‌کند مجموعه‌ای از
اجاره‌های IPv6 را برای یک کلاینت با IAID (شناسهٔ انجمن هویت) و DUID (شناسهٔ
یکتای DHCP) مشخص‌شده از پایگاه‌دادهٔ MySQL دریافت کند.
.SS MYSQL_LB_GET_IAID_SUBID_DUID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv6 leases for IAID %1, subnet ID %2, DUID %3, lease type %4
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارساز تلاش می‌کند یک اجارهٔ IPv6
را برای یک کلاینت با IAID (شناسهٔ انجمن هویت)، subnet ID و DUID (شناسهٔ
یکتای DHCP) مشخص‌شده از پایگاه‌دادهٔ MySQL دریافت کند.
.SS MYSQL_LB_GET_PAGE4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining at most %1 IPv4 leases starting from address %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارساز تلاش می‌کند صفحه‌ای از
اجاره‌ها را با شروع از نشانی مشخص‌شده دریافت کند.
.SS MYSQL_LB_GET_PAGE6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining at most %1 IPv6 leases starting from address %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارساز تلاش می‌کند صفحه‌ای از
اجاره‌ها را با شروع از نشانی مشخص‌شده دریافت کند.
.SS MYSQL_LB_GET_RELAYID4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining at most %1 IPv4 leases starting from address %2 with relay id %3 and cltt between %4 and %5
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارساز تلاش می‌کند صفحه‌ای از
اجاره‌های IPv4 را با شروع از نشانی مشخص‌شده، با یک relay id و زمان تراکنش
کلاینت (cltt) بین تاریخ‌های آغاز و پایان دریافت کند.
.SS MYSQL_LB_GET_RELAYID6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining at most %1 IPv6 leases starting from address %2 with relay id %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارساز تلاش می‌کند صفحه‌ای از
اجاره‌های IPv6 را با شروع از نشانی مشخص‌شده و دارای یک relay id دریافت کند.
.SS MYSQL_LB_GET_REMOTEID4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining at most %1 IPv4 leases starting from address %2 with remote id %3 and cltt between %4 and %5
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارساز تلاش می‌کند صفحه‌ای از
اجاره‌های IPv4 را با شروع از نشانی مشخص‌شده، با یک remote id و زمان تراکنش
کلاینت (cltt) بین تاریخ‌های آغاز و پایان دریافت کند.
.SS MYSQL_LB_GET_REMOTEID6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining at most %1 IPv6 leases starting from address %2 with remote id %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارساز تلاش می‌کند صفحه‌ای از
اجاره‌های IPv6 را با شروع از نشانی مشخص‌شده و دارای یک remote id دریافت کند.
.SS MYSQL_LB_GET_STATE4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv4 leases with state %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارساز تلاش می‌کند مجموعه‌ای از
اجاره‌های IPv4 را با وضعیت مشخص‌شده از پایگاه‌دادهٔ MySQL دریافت کند..SS MYSQL_LB_GET_STATE6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv6 leases with state %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در حال تلاش برای دریافت مجموعه‌ای
از اجاره‌های IPv6 با وضعیت مشخص‌شده از پایگاه داده MySQL است.
.SS MYSQL_LB_GET_STATE_SUBID4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv4 leases with state %1 in subnet %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در حال تلاش برای دریافت مجموعه‌ای
از اجاره‌های IPv4 با وضعیت مشخص‌شده در زیرشبکه مشخص‌شده از پایگاه داده MySQL است.
.SS MYSQL_LB_GET_STATE_SUBID6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv6 leases with state %1 in subnet %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در حال تلاش برای دریافت مجموعه‌ای
از اجاره‌های IPv6 با وضعیت مشخص‌شده در زیرشبکه مشخص‌شده از پایگاه داده MySQL است.
.SS MYSQL_LB_GET_SUBID4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv4 leases for subnet ID %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در حال تلاش برای دریافت تمام
اجاره‌های IPv4 برای یک شناسه زیرشبکه داده‌شده از پایگاه داده MySQL است.
.SS MYSQL_LB_GET_SUBID6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv6 leases for subnet ID %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در حال تلاش برای دریافت تمام
اجاره‌های IPv6 برای یک شناسه زیرشبکه داده‌شده از پایگاه داده MySQL است.
.SS MYSQL_LB_GET_SUBID_CLIENTID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv4 lease for subnet ID %1 and client ID %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در حال تلاش برای دریافت یک
اجاره IPv4 از پایگاه داده MySQL برای کلاینتی با شناسه زیرشبکه (subnet ID)
و شناسه کلاینت (client ID) مشخص‌شده است.
.SS MYSQL_LB_GET_SUBID_HWADDR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv4 lease for subnet ID %1 and hardware address %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در حال تلاش برای دریافت یک
اجاره IPv4 از پایگاه داده MySQL برای کلاینتی با شناسه زیرشبکه (subnet ID)
و نشانی سخت‌افزاری مشخص‌شده است.
.SS MYSQL_LB_GET_SUBID_PAGE6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining at most %1 IPv6 leases starting from address %2 for subnet ID %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در حال تلاش برای دریافت یک صفحه از
اجاره‌های IPv6 از پایگاه داده MySQL است که با نشانی مشخص‌شده برای شناسه زیرشبکه داده‌شده آغاز می‌شود.
.SS MYSQL_LB_GET_VERSION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining schema version information
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در آستانه دریافت اطلاعات
نسخه طرح‌واره (schema) از پایگاه داده MySQL است..SS MYSQL_LB_NEGATIVE_LEASES_STAT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
شمارش مجدد اجاره‌ها مقدار منفی بازگرداند
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که شمارش مجدد اجاره‌ها با استفاده از شمارنده‌ها
در پایگاه‌داده MySQL مقدار منفی بازگرداند. این امر نشان‌دهنده مشکلی است
که تنها با یک شمارش مجدد مستقیم و آفلاین روی پایگاه‌داده قابل رفع است.
این پیام فقط یک بار صادر می‌شود.
.SS MYSQL_LB_NO_TLS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
TLS الزامی بود اما استفاده نشده است
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که TLS برای اتصال الزامی بوده اما
از TLS استفاده نشده است.
.SS MYSQL_LB_ROLLBACK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
در حال بازگردانی پایگاه‌داده MySQL
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ دیباگ ۵۰ ثبت می‌شود.
کد یک فراخوانی rollback صادر کرده است. تمام تراکنش‌های معلق
بازگردانی خواهند شد و در پایگاه‌داده commit نمی‌شوند.
.SS MYSQL_LB_SFLQ_CREATE_POOL4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ایجاد استخر shared\-flq برای محدوده آدرس %1 \- %2، شناسه زیرشبکه %3، ایجاد مجدد %4، ظرفیت %5
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ دیباگ ۵۰ ثبت می‌شود.
این پیام دیباگ زمانی صادر می‌شود که سرور از بک‌اند اجاره درخواست کند داده‌های
اجاره آزاد مشترک را برای استخر توصیف‌شده در آرگومان‌ها ایجاد (مجدد) کند.
.SS MYSQL_LB_SFLQ_CREATE_POOL6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ایجاد استخر shared\-flq برای محدوده آدرس %1 \- %2، نوع %3، طول واگذارشده: %4، شناسه زیرشبکه %5، ایجاد مجدد %6، ظرفیت %7
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ دیباگ ۵۰ ثبت می‌شود.
این پیام دیباگ زمانی صادر می‌شود که سرور از بک‌اند اجاره درخواست کند داده‌های
اجاره آزاد مشترک را برای استخر توصیف‌شده در آرگومان‌ها ایجاد (مجدد) کند.
.SS MYSQL_LB_SFLQ_PICK_LEASE4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
انتخاب یک اجاره آزاد از محدوده آدرس %1 \- %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ دیباگ ۵۰ ثبت می‌شود.
این پیام دیباگ زمانی صادر می‌شود که سرور از بک‌اند اجاره یک
آدرس آزاد از استخر توصیف‌شده در آرگومان‌ها درخواست می‌کند.
.SS MYSQL_LB_SFLQ_PICK_LEASE6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
انتخاب یک اجاره آزاد از محدوده آدرس %1 \- %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ دیباگ ۵۰ ثبت می‌شود.
این پیام دیباگ زمانی صادر می‌شود که سرور از بک‌اند اجاره یک
اجاره آزاد از استخر توصیف‌شده در آرگومان‌ها درخواست می‌کند.
.SS MYSQL_LB_SFLQ_POOL4_DELETE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
حذف استخر V4 SFLQ با آدرس شروع %1 و آدرس پایان %2، force = %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ دیباگ ۵۰ ثبت می‌شود.
این پیام دیباگ زمانی صادر می‌شود که سرور از بک‌اند اجاره درخواست کند
استخر v4 SFLQ (و داده‌های اجاره آزاد آن) را که با آدرس‌های شروع و پایان
داده‌شده مطابقت دارد حذف کند.
.SS MYSQL_LB_SFLQ_POOL4_GET_ALL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
واکشی تمام استخرهای V4 SFLQ
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ دیباگ ۵۰ ثبت می‌شود.
این پیام دیباگ زمانی صادر می‌شود که سرور از بک‌اند اجاره فهرستی از تمام استخرهای v4 SFLQ را درخواست می‌کند.
.SS MYSQL_LB_SFLQ_POOL4_GET_BY_RANGE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
واکشی تمام استخرهای V4 SFLQ که با محدوده %1 و %2 هم‌پوشانی دارند
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ دیباگ ۵۰ ثبت می‌شود.
این پیام دیباگ زمانی صادر می‌شود که سرور از بک‌اند اجاره
استخرهای v4 SFLQ را که با محدوده آدرس داده‌شده هم‌پوشانی دارند درخواست می‌کند..SS MYSQL_LB_SFLQ_POOL4_GET_BY_SUBNET
.INDENT 0.0
.INDENT 3.5
.sp
.EX
fetch all V4 SFLQ pools for subnet\-id %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور از بک‌اند اجاره،
فهرستی از تمام استخرهای v4 SFLQ متعلق به یک زیرشبکه را درخواست کند.
.SS MYSQL_LB_SFLQ_POOL6_DELETE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete the V6 SFLQ pool with start address %1 and end address %2, force = %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور از بک‌اند اجاره بخواهد
استخر v6 SFLQ (و داده‌های اجاره‌های آزاد آن) را که با آدرس‌های شروع و پایان
داده‌شده مطابقت دارد، حذف کند.
.SS MYSQL_LB_SFLQ_POOL6_GET_ALL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
fetch all V6 SFLQ pools
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور از بک‌اند اجاره،
فهرستی از تمام استخرهای v6 SFLQ را درخواست کند.
.SS MYSQL_LB_SFLQ_POOL6_GET_BY_RANGE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
fetch all V6 SFLQ pools that overlap the range %1 and %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور از بک‌اند اجاره،
استخرهای v6 SFLQ را که با بازهٔ آدرس داده‌شده همپوشانی دارند درخواست کند.
.SS MYSQL_LB_SFLQ_POOL6_GET_BY_SUBNET
.INDENT 0.0
.INDENT 3.5
.sp
.EX
fetch all V6 SFLQ pools for subnet\-id %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور از بک‌اند اجاره،
فهرستی از تمام استخرهای v6 SFLQ متعلق به یک زیرشبکه را درخواست کند.
.SS MYSQL_LB_TLS_CIPHER
.INDENT 0.0
.INDENT 3.5
.sp
.EX
TLS cipher: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک اتصال جدید MySQL با TLS ایجاد شود.
نام رمز (cipher) TLS ثبت می‌شود.
.SS MYSQL_LB_UPDATE_ADDR4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
updating IPv4 lease for address %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در حال تلاش برای به‌روزرسانی
اجاره IPv4 از پایگاه داده MySQL برای آدرس مشخص‌شده باشد.
.SS MYSQL_LB_UPDATE_ADDR6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
updating IPv6 lease for address %1, lease type %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در حال تلاش برای به‌روزرسانی
اجاره IPv6 از پایگاه داده MySQL برای آدرس مشخص‌شده باشد.
.SS MYSQL_LB_UPGRADE_EXTENDED_INFO4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
upgrading IPv4 leases done in %1 pages with %2 updated leases
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
سرور اطلاعات گسترش‌یافته (extended info) را ارتقا داد. تعداد صفحات و شمارش نهایی
اجاره‌های به‌روزشده نمایش داده می‌شود.
.SS MYSQL_LB_UPGRADE_EXTENDED_INFO4_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
upgrading extending info for IPv4 lease at %1 failed with %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در ارتقای اطلاعات گسترش‌یافته (extended info) با شکست مواجه شود.
آدرس اجاره و پیام خطا نمایش داده می‌شوند..SS MYSQL_LB_UPGRADE_EXTENDED_INFO4_PAGE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
upgrading IPv4 lease extended info at page %1 starting at %2 (updated %3)
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارگزار اطلاعات تکمیلی (extended info) اجاره‌های IPv4 را ارتقا می‌دهد.
شمارهٔ صفحه، نشانی شروع، و تعداد اجاره‌هایی که تاکنون به‌روزرسانی شده‌اند
نمایش داده می‌شوند.
.SS MYSQL_LB_UPGRADE_EXTENDED_INFO6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
upgrading IPv6 leases done in %1 pages with %2 updated leases
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
کارگزار اطلاعات تکمیلی را ارتقا داد. تعداد صفحات و شمارش نهایی
اجاره‌های به‌روزرسانی‌شده نمایش داده می‌شوند.
.SS MYSQL_LB_UPGRADE_EXTENDED_INFO6_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
upgrading extending info for IPv6 lease at %1 failed with %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی صادر می‌شود که کارگزار در ارتقای اطلاعات تکمیلی
یک اجاره با شکست مواجه شده باشد. نشانی اجاره و پیام خطا نمایش داده می‌شوند.
.SS MYSQL_LB_UPGRADE_EXTENDED_INFO6_PAGE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
upgrading IPv6 lease extended info at page %1 starting at %2 (updated %3)
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارگزار اطلاعات تکمیلی اجاره‌های IPv6 را ارتقا می‌دهد.
شمارهٔ صفحه، نشانی شروع، و تعداد اجاره‌هایی که تاکنون به‌روزرسانی شده‌اند
نمایش داده می‌شوند.
.SS NETCONF
.SS NETCONF_BOOT_UPDATE_COMPLETED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Boot\-update configuration completed for server %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی هنگامی صادر می‌شود که پیکربندی اولیه با استفاده از NETCONF
دریافت شده و با موفقیت روی کارگزار Kea اعمال شده باشد.
.SS NETCONF_CONFIG_CHANGED_DETAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
YANG configuration changed: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی نشان‌دهندهٔ تغییر پیکربندی YANG است. قالب پیام
عبارت است از عملیات تغییر (created، modified، deleted یا moved) که به‌دنبال آن
xpathها و مقادیر گره‌های قدیمی و جدید می‌آیند.
.SS NETCONF_CONFIG_CHANGE_EVENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Received YANG configuration change %1 event
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی هنگامی صادر می‌شود که kea\-netconf یک رویداد تغییر
پیکربندی YANG را دریافت کند. نوع رویداد چاپ می‌شود.
.SS NETCONF_CONFIG_CHECK_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
NETCONF configuration check failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که بررسی پیکربندی kea\-netconf با شکست مواجه شده است.
جزئیات ارائه شده‌اند. ممکن است جزئیات بیش‌تر در مدخل‌های لاگ پیشین،
احتمالاً در سطوح پایین‌تر موجود باشد.
.SS NETCONF_CONFIG_FAIL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
NETCONF configuration failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که تلاش پیکربندی kea\-netconf با شکست مواجه شده است.
جزئیات ارائه شده‌اند. ممکن است جزئیات بیش‌تر در مدخل‌های لاگ پیشین،
احتمالاً در سطوح پایین‌تر موجود باشد.
.SS NETCONF_CONFIG_SYNTAX_WARNING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
NETCONF configuration syntax warning: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار نشان می‌دهد که پیکربندی NETCONF یک خطای نحوی جزئی داشته است.
خطا نمایش داده شد و تجزیهٔ پیکربندی ادامه یافت..SS NETCONF_CONTROL_SOCKET_INFO
.INDENT 0.0
.INDENT 3.5
.sp
.EX
the service: %1 started using control socket type: %2 %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی، جزئیات سوکت کنترلی استفاده‌شده برای سرویس مربوطه را ارائه می‌دهد. نام سرویس، نوع سوکت و جزئیات آن ثبت می‌شوند.
.SS NETCONF_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
application experienced a fatal error: %1
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطای مهلک است و زمانی صادر می‌شود که kea\-netconf با خطایی غیرقابل‌بازیابی از درون حلقه رویداد (event loop) مواجه شود.
.SS NETCONF_GET_CONFIG
.INDENT 0.0
.INDENT 3.5
.sp
.EX
got configuration from %1 server: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح ثبت اشکال‌زدایی (debug) ۵۵ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که kea\-netconf پیکربندی را از یک سرور Kea دریافت کرده است. نام سرور و پیکربندی دریافت‌شده چاپ می‌شوند.
.SS NETCONF_GET_CONFIG_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
getting configuration from %1 server failed: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که kea\-netconf هنگام دریافت پیکربندی از یک سرور Kea دچار خطا شده است. اطمینان حاصل کنید که سرور فعال و در حال اجرا است، سوکت کنترلی مناسب برای آن تعریف شده است و پیکربندی سوکت کنترلی روی سرور با پیکربندی kea\-netconf مطابقت دارد. نام سرور و خطا چاپ می‌شوند.
.SS NETCONF_GET_CONFIG_STARTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
getting configuration from %1 server
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی نشان می‌دهد که kea\-netconf در تلاش برای دریافت پیکربندی از یک سرور Kea است.
.SS NETCONF_MODULE_CHANGE_INTERNAL_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
an internal error occurred while processing changes for module %1: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که kea\-netconf هنگام پردازش تغییرات ماژول‌ها توسط sysrepo با خطایی مواجه شده است. این وضعیت معمولاً پس از شکست در اعتبارسنجی پیکربندی رخ می‌دهد و قابل بازیابی است. نام ماژول و پیام خطای داخلی چاپ می‌شوند.
.SS NETCONF_MODULE_MISSING_ERR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Missing essential module %1 in sysrepo
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطای مهلک نشان می‌دهد که ماژول ضروریِ مورد نیاز برای پیکربندی Netconf در مخزن sysrepo موجود نیست. نام ماژول چاپ می‌شود.
.SS NETCONF_MODULE_MISSING_WARN
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Missing module %1 in sysrepo
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار نشان می‌دهد که یک ماژول استفاده‌شده توسط Kea در مخزن sysrepo موجود نیست. نام ماژول چاپ می‌شود.
.SS NETCONF_MODULE_REVISION_ERR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Essential module %1 does NOT have the right revision: expected %2, got %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطای مهلک نشان می‌دهد که ماژول ضروریِ مورد نیاز برای پیکربندی Netconf، نسخه بازنگری (revision) صحیحی در مخزن sysrepo ندارد. نام ماژول و نسخه‌های بازنگری مورد انتظار و موجود چاپ می‌شوند.
.SS NETCONF_MODULE_REVISION_WARN
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Module %1 does NOT have the right revision: expected %2, got %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار نشان می‌دهد که ماژول استفاده‌شده توسط Kea نسخه بازنگری (revision) صحیحی در مخزن sysrepo ندارد. نام ماژول و نسخه‌های بازنگری مورد انتظار و موجود چاپ می‌شوند..SS NETCONF_NOTIFICATION_INTERNAL_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
an internal error occurred while sending an event notification for module %1: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که kea\-netconf هنگام ارسال یک اعلان رخداد توسط sysrepo با خطا مواجه شده است.
این خطا مهلک نیست و امکان بازیابی از آن وجود دارد.
نام ماژول و پیام خطای داخلی چاپ می‌شوند.
.SS NETCONF_NOTIFICATION_RECEIVED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Received notification of type %1 for module %2: \(aq%3\(aq
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی، هرگونه اعلان YANG را که توسط سرور ارسال شده، به kea\-netconf تحویل گردیده و سپس به کلاینت‌های مشترک‌شده بازفرستاده شده است، ثبت می‌کند. برای انجام این کار، kea\-netconf خود را به‌عنوان یک کلاینت در تمامی اعلان‌های ماژول پیکربندی‌شده مشترک می‌کند.
.SS NETCONF_NOT_SUBSCRIBED_TO_NOTIFICATIONS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
subscribing to notifications for %1 server with %2 module failed: %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار نشان می‌دهد که kea\-netconf هنگام اشتراک در اعلان‌های یک سرور Kea با خطا مواجه شده است. محتمل‌ترین علت این است که مدل مشترک‌شده توسط kea\-netconf فاقد هرگونه گره اعلان است، اما ممکن است دلایل غیرمنتظره دیگری نیز وجود داشته باشد.
نام سرور، نام ماژول و متن خطا چاپ می‌شوند.
.SS NETCONF_RUN_EXIT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
application is exiting the event loop
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) 0 ثبت می‌شود.
این یک پیام اشکال‌زدایی است که هنگام خروج kea\-netconf از حلقه رخداد (event loop) خود صادر می‌شود. این یک مرحله عادی در طول فرآیند خاموش شدن kea\-netconf است.
.SS NETCONF_SET_CONFIG
.INDENT 0.0
.INDENT 3.5
.sp
.EX
set configuration to %1 server: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) 55 ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که kea\-netconf پیکربندی را روی یک سرور Kea اعمال کرده است. نام سرور و پیکربندی اعمال‌شده چاپ می‌شوند.
.SS NETCONF_SET_CONFIG_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
setting configuration to %1 server failed: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که kea\-netconf هنگام اعمال پیکربندی روی یک سرور Kea با خطا مواجه شده است. اطمینان حاصل کنید که سرور فعال و در حال اجرا است، سوکت کنترلی مناسب برای آن تعریف شده و پیکربندی سوکت کنترلی روی سرور با kea\-netconf مطابقت دارد. نام سرور و متن خطا چاپ می‌شوند.
.SS NETCONF_SET_CONFIG_STARTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
setting configuration to %1 server
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که kea\-netconf در تلاش برای اعمال پیکربندی روی یک سرور Kea است.
.SS NETCONF_STARTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
kea\-netconf (version %1) started
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که kea\-netconf تمامی اطلاعات پیکربندی را پردازش کرده و آماده آغاز به کار است.
نسخه برنامه نیز چاپ می‌شود.
.SS NETCONF_SUBSCRIBE_CONFIG
.INDENT 0.0
.INDENT 3.5
.sp
.EX
subscribing configuration changes for %1 server with %2 module
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که kea\-netconf در تلاش است تا برای تغییرات پیکربندی یک سرور Kea با ماژول مشخص‌شده مشترک شود. نام سرور و ماژول چاپ می‌شوند..SS NETCONF_SUBSCRIBE_CONFIG_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
subscribe configuration changes for %1 server with %2 module failed: %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که kea\-netconf هنگام اشتراک در تغییرات پیکربندی برای یک سرور Kea با خطا مواجه شده است. نام‌های سرور و ماژول و همچنین خطا چاپ می‌شوند.
.SS NETCONF_SUBSCRIBE_NOTIFICATIONS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
subscribing to notifications for %1 server with %2 module
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که kea\-netconf در حال تلاش برای اشتراک در اعلان‌های یک سرور Kea است. نام سرور و نام ماژول چاپ می‌شوند.
.SS NETCONF_UPDATE_CONFIG
.INDENT 0.0
.INDENT 3.5
.sp
.EX
updating configuration with %1 server: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 55 ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که kea\-netconf پیکربندی یک سرور Kea را به‌روزرسانی می‌کند. نام سرور و پیکربندی به‌روزرسانی‌شده چاپ می‌شوند.
.SS NETCONF_UPDATE_CONFIG_COMPLETED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
completed updating configuration for %1 server
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که kea\-netconf با موفقیت پیکربندی یک سرور Kea را به‌روزرسانی کرده است.
.SS NETCONF_UPDATE_CONFIG_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
updating configuration with %1 server: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که kea\-netconf هنگام به‌روزرسانی پیکربندی یک سرور Kea با خطا مواجه شده است. این شامل رد شدن پیکربندی توسط یک سرور Kea در زمان تلاش برای اعمال آن نیز می‌شود. نام سرور و خطا چاپ می‌شوند.
.SS NETCONF_UPDATE_CONFIG_STARTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
started updating configuration for %1 server
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که kea\-netconf در حال تلاش برای به‌روزرسانی پیکربندی یک سرور Kea است.
.SS NETCONF_VALIDATE_CONFIG
.INDENT 0.0
.INDENT 3.5
.sp
.EX
validating configuration with %1 server: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 55 ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که kea\-netconf در حال اعتبارسنجی پیکربندی با یک سرور Kea است. نام سرور و پیکربندی اعتبارسنجی‌شده چاپ می‌شوند.
.SS NETCONF_VALIDATE_CONFIG_COMPLETED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
completed validating configuration for %1 server
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که kea\-netconf با موفقیت پیکربندی را با یک سرور Kea اعتبارسنجی کرده است.
.SS NETCONF_VALIDATE_CONFIG_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
validating configuration with %1 server got an error: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که kea\-netconf هنگام اعتبارسنجی پیکربندی با یک سرور Kea با خطا مواجه شده است. این پیام زمانی تولید می‌شود که در حین تلاش برای اعتبارسنجی پیکربندی دریافتی، یک استثنا (exception) رخ دهد. ممکن است توضیحات تکمیلی به عنوان پارامتر ارائه شود. همچنین می‌توانید به پیام‌های لاگ پیشین نگاهی بیندازید. نام سرور و خطا چاپ می‌شوند.
.SS NETCONF_VALIDATE_CONFIG_REJECTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
validating configuration with %1 server was rejected: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار نشان می‌دهد که kea\-netconf هنگام اعتبارسنجی پیکربندی با یک سرور Kea با خطا مواجه شده است. این پیام زمانی چاپ می‌شود که پیکربندی در حین پردازش عادی رد شده باشد. ممکن است توضیحات تکمیلی به عنوان پارامتر ارائه شود. همچنین می‌توانید به پیام‌های لاگ پیشین نگاهی بیندازید. نام سرور و خطا چاپ می‌شوند..SS NETCONF_VALIDATE_CONFIG_STARTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
started validating configuration for %1 server
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی نشان می‌دهد که kea\-netconf در حال تلاش برای اعتبارسنجی
پیکربندی با یک کارساز Kea است.
.SS PERFMON
.SS PERFMON_ALARM_CLEARED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Alarm for %1 has been cleared, reported mean duration %2 is now below low\-water\-ms: %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی زمانی صادر می‌شود که میانگین مدت‌زمان گزارش‌شده برای
هشداری که فعال شده بود، به زیر مقدار پارامتر low\-water\-ms آن کاهش یابد.
آرگومان‌ها کلید هشدار و آخرین میانگین گزارش‌شده را با جزئیات شرح می‌دهند.
.SS PERFMON_ALARM_TRIGGERED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Alarm for %1 has been triggered since %2, reported mean duration %3 exceeds high\-water\-ms: %4
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که میانگین مدت‌زمان گزارش‌شده برای یک هشدار
از مقدار high\-water\-ms آن فراتر رود. تا زمانی که میانگین‌های گزارش‌شده بالاتر از
مقدار low\-water\-ms باقی بمانند، هشدار در وضعیت فعال باقی می‌ماند و این پیام هر
alarm\-report\-secs یک‌بار تکرار خواهد شد. آرگومان‌ها کلید هشدار، زمانی که هشدار
نخستین بار فعال شد، آخرین میانگین گزارش‌شده و مقدار high\-water\-ms را مشخص می‌کنند.
.SS PERFMON_CMDS_CONTROL_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
perfmon\-control command processing failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که کتابخانه قلاب PerfMon در پردازش یک دستور
perfmon\-control با خطا مواجه شود. آرگومان، خطای دستور را توضیح می‌دهد.
.SS PERFMON_CMDS_CONTROL_OK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
perfmon\-control command success: active monitoring: %1, stats\-mgr\-reporting: %2
.EE
.UNINDENT
.UNINDENT
.sp
این گزارش اطلاعاتی زمانی صادر می‌شود که دستور perfmon\-control با موفقیت
پایش فعال (active monitoring) و/یا گزارش‌دهی statistics mgr را فعال/غیرفعال کرده باشد.
آرگومان‌ها وضعیت فعلی هر دو را نشان می‌دهند.
.SS PERFMON_CMDS_GET_ALL_DURATIONS_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
perfmon\-get\-all\-durations command processing failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که کتابخانه قلاب PerfMon در پردازش یک دستور
perfmon\-get\-all\-durations با خطا مواجه شود. آرگومان، خطای دستور را توضیح می‌دهد.
.SS PERFMON_CMDS_GET_ALL_DURATIONS_OK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
perfmon\-get\-all\-durations returning %1 durations
.EE
.UNINDENT
.UNINDENT
.sp
این گزارش اطلاعاتی زمانی صادر می‌شود که دستور perfmon\-get\-all\-durations با موفقیت
به پایان رسیده باشد. آرگومان شامل تعداد مدت‌زمان‌های بازگردانده‌شده است.
.SS PERFMON_DEINIT_OK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
unloading PerfMon hooks library successful
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی نشان می‌دهد که کتابخانه قلاب‌های PerfMon با موفقیت
تخلیه (حذف) شده است.
.SS PERFMON_DHCP4_PKT_EVENTS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
query: %1 events=[%2]
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی پس از پردازش یک پرس‌وجوی ورودی DHCPv4 صادر می‌شود؛
آرگومان‌ها عبارتند از برچسب پرس‌وجو و رونوشت پشته رویداد بسته
(packet event stack) مربوط به پرس‌وجو..SS PERFMON_DHCP4_PKT_PROCESS_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Packet event stack was not processed for query %1, reason %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که پشته رویداد پرس‌وجو پردازش نشود.
این مورد به احتمال زیاد یک خطای برنامه‌نویسی است و باید گزارش شود.
آرگومان‌ها پرس‌وجو و دلیل پردازش نشدن آن را مشخص می‌کنند.
این خطاها نباید بر عملیات عادی سرور تأثیر بگذارند.
.SS PERFMON_DHCP4_SOCKET_RECEIVED_TIME_SUPPORT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Kernel supports socket received time? %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی پس از (باز)پیکربندی صادر می‌شود و نشان می‌دهد آیا
فیلتر بسته‌ای که توسط kea\-dhcp4 استفاده می‌شود می‌تواند برچسب زمانی
دریافت بسته توسط هسته را برای ثبت رویدادهای SOCKET_RECEIVED ارائه دهد
یا خیر. اگر نتواند، perfmon همچنان کار خواهد کرد اما داده‌ای برای تعیین
مدت‌زمان انتظار در بافر هسته در دسترس نخواهد داشت.
.SS PERFMON_DHCP6_PKT_EVENTS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
query: %1 events=[%2]
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی پس از پردازش یک پرس‌وجوی ورودی DHCPv6 صادر می‌شود؛
آرگومان‌ها برچسب پرس‌وجو و تخلیه پشته رویداد بسته مربوط به پرس‌وجو هستند.
.SS PERFMON_DHCP6_PKT_PROCESS_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Packet event stack was not processed for query %1, reason %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که پشته رویداد پرس‌وجو پردازش نشود.
این مورد به احتمال زیاد یک خطای برنامه‌نویسی است و باید گزارش شود.
آرگومان‌ها پرس‌وجو و دلیل پردازش نشدن آن را مشخص می‌کنند.
این خطاها نباید بر عملیات عادی سرور تأثیر بگذارند.
.SS PERFMON_DHCP6_SOCKET_RECEIVED_TIME_SUPPORT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Kernel supports socket received time? %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی پس از (باز)پیکربندی صادر می‌شود و نشان می‌دهد آیا
فیلتر بسته‌ای که توسط kea\-dhcp6 استفاده می‌شود می‌تواند برچسب زمانی
دریافت بسته توسط هسته را برای ثبت رویدادهای SOCKET_RECEIVED ارائه دهد
یا خیر. اگر نتواند، perfmon همچنان کار خواهد کرد اما داده‌ای برای تعیین
مدت‌زمان انتظار در بافر هسته در دسترس نخواهد داشت.
.SS PERFMON_INIT_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
loading PerfMon hooks library failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا بیانگر وجود خطایی هنگام بارگذاری کتابخانه قلاب‌های PerfMon
است. جزئیات خطا به عنوان آرگومان پیام گزارش ارائه شده است.
.SS PERFMON_INIT_OK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
loading PerfMon hooks library successful
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی نشان می‌دهد که کتابخانه قلاب‌های PerfMon با موفقیت
بارگذاری شده است. لذت ببرید!
.SS PGSQL
.SS PGSQL_CB_CREATE_UPDATE_BY_POOL_OPTION4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
create or update option pool start: %1 pool end: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام فعال شدن عملیاتی برای ایجاد یا به‌روزرسانی گزینه بر اساس استخر صادر می‌شود.
.SS PGSQL_CB_CREATE_UPDATE_BY_POOL_OPTION6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
create or update option pool start: %1 pool end: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام فعال شدن عملیاتی برای ایجاد یا به‌روزرسانی گزینه بر اساس استخر صادر می‌شود..SS PGSQL_CB_CREATE_UPDATE_BY_PREFIX_OPTION6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
create or update option prefix: %1 prefix len: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی زمانی صادر می‌شود که عملیاتی برای ایجاد یا به‌روزرسانی گزینه بر اساس پیشوند (prefix) فعال شده باشد.
.SS PGSQL_CB_CREATE_UPDATE_BY_SUBNET_ID_OPTION4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
create or update option by subnet id: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی زمانی صادر می‌شود که عملیاتی برای ایجاد یا به‌روزرسانی گزینه بر اساس subnet id فعال شده باشد.
.SS PGSQL_CB_CREATE_UPDATE_BY_SUBNET_ID_OPTION6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
create or update option by subnet id: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی زمانی صادر می‌شود که عملیاتی برای ایجاد یا به‌روزرسانی گزینه بر اساس subnet id فعال شده باشد.
.SS PGSQL_CB_CREATE_UPDATE_CLIENT_CLASS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
create or update client class: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی زمانی صادر می‌شود که عملیاتی برای ایجاد یا به‌روزرسانی کلاس کلاینت (client class) فعال شده باشد.
.SS PGSQL_CB_CREATE_UPDATE_CLIENT_CLASS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
create or update client class: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی زمانی صادر می‌شود که عملیاتی برای ایجاد یا به‌روزرسانی کلاس کلاینت (client class) فعال شده باشد.
.SS PGSQL_CB_CREATE_UPDATE_GLOBAL_PARAMETER4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
create or update global parameter: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی زمانی صادر می‌شود که عملیاتی برای ایجاد یا به‌روزرسانی پارامتر سراسری فعال شده باشد.
.SS PGSQL_CB_CREATE_UPDATE_GLOBAL_PARAMETER6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
create or update global parameter: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی زمانی صادر می‌شود که عملیاتی برای ایجاد یا به‌روزرسانی پارامتر سراسری فعال شده باشد.
.SS PGSQL_CB_CREATE_UPDATE_OPTION4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
create or update option
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی زمانی صادر می‌شود که عملیاتی برای ایجاد یا به‌روزرسانی گزینه فعال شده باشد.
.SS PGSQL_CB_CREATE_UPDATE_OPTION6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
create or update option
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی زمانی صادر می‌شود که عملیاتی برای ایجاد یا به‌روزرسانی گزینه فعال شده باشد.
.SS PGSQL_CB_CREATE_UPDATE_OPTION_DEF4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
create or update option definition: %1 code: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی زمانی صادر می‌شود که عملیاتی برای ایجاد یا به‌روزرسانی تعریف گزینه فعال شده باشد..SS PGSQL_CB_CREATE_UPDATE_OPTION_DEF6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
create or update option definition: %1 code: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی زمانی صادر می‌شود که اقدامی برای ایجاد یا به‌روزرسانی تعریف گزینه (option definition) آغاز شود.
.SS PGSQL_CB_CREATE_UPDATE_SERVER4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
create or update server: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی زمانی صادر می‌شود که اقدامی برای ایجاد یا به‌روزرسانی اطلاعات
سرور DHCPv4 آغاز شود.
.SS PGSQL_CB_CREATE_UPDATE_SERVER6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
create or update server: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی زمانی صادر می‌شود که اقدامی برای ایجاد یا به‌روزرسانی اطلاعات
سرور DHCPv6 آغاز شود.
.SS PGSQL_CB_CREATE_UPDATE_SHARED_NETWORK4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
create or update shared network: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی زمانی صادر می‌شود که اقدامی برای ایجاد یا به‌روزرسانی شبکه مشترک (shared network) آغاز شود.
.SS PGSQL_CB_CREATE_UPDATE_SHARED_NETWORK6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
create or update shared network: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی زمانی صادر می‌شود که اقدامی برای ایجاد یا به‌روزرسانی شبکه مشترک (shared network) آغاز شود.
.SS PGSQL_CB_CREATE_UPDATE_SHARED_NETWORK_OPTION4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
create or update shared network: %1 option
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی زمانی صادر می‌شود که اقدامی برای ایجاد یا به‌روزرسانی گزینه شبکه مشترک آغاز شود.
.SS PGSQL_CB_CREATE_UPDATE_SHARED_NETWORK_OPTION6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
create or update shared network: %1 option
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی زمانی صادر می‌شود که اقدامی برای ایجاد یا به‌روزرسانی گزینه شبکه مشترک آغاز شود.
.SS PGSQL_CB_CREATE_UPDATE_SUBNET4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
create or update subnet: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی زمانی صادر می‌شود که اقدامی برای ایجاد یا به‌روزرسانی زیرشبکه (subnet) آغاز شود.
.SS PGSQL_CB_CREATE_UPDATE_SUBNET6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
create or update subnet: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی زمانی صادر می‌شود که اقدامی برای ایجاد یا به‌روزرسانی زیرشبکه (subnet) آغاز شود.
.SS PGSQL_CB_DELETE_ALL_CLIENT_CLASSES4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete all client classes
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی زمانی صادر می‌شود که اقدامی برای حذف تمام کلاس‌های کلاینت (client classes) آغاز شود..SS PGSQL_CB_DELETE_ALL_CLIENT_CLASSES4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهنده نتیجهٔ عملیات حذف تمام کلاس‌های کلاینت است.
.SS PGSQL_CB_DELETE_ALL_CLIENT_CLASSES6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete all client classes
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیات حذف تمام کلاس‌های کلاینت صادر می‌شود.
.SS PGSQL_CB_DELETE_ALL_CLIENT_CLASSES6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهنده نتیجهٔ عملیات حذف تمام کلاس‌های کلاینت است.
.SS PGSQL_CB_DELETE_ALL_GLOBAL_PARAMETERS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete all global parameters
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیات حذف تمام پارامترهای سراسری صادر می‌شود.
.SS PGSQL_CB_DELETE_ALL_GLOBAL_PARAMETERS4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهنده نتیجهٔ عملیات حذف تمام پارامترهای سراسری است.
.SS PGSQL_CB_DELETE_ALL_GLOBAL_PARAMETERS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete all global parameters
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیات حذف تمام پارامترهای سراسری صادر می‌شود.
.SS PGSQL_CB_DELETE_ALL_GLOBAL_PARAMETERS6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهنده نتیجهٔ عملیات حذف تمام پارامترهای سراسری است.
.SS PGSQL_CB_DELETE_ALL_OPTION_DEFS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete all option definitions
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیات حذف تمام تعاریف گزینه‌ها صادر می‌شود.
.SS PGSQL_CB_DELETE_ALL_OPTION_DEFS4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهنده نتیجهٔ عملیات حذف تمام تعاریف گزینه‌ها است.
.SS PGSQL_CB_DELETE_ALL_OPTION_DEFS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete all option definitions
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیات حذف تمام تعاریف گزینه‌ها صادر می‌شود..SS PGSQL_CB_DELETE_ALL_OPTION_DEFS6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نتیجهٔ عملیات حذف تمام تعاریف گزینه‌ها را نشان می‌دهد.
.SS PGSQL_CB_DELETE_ALL_SERVERS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete all DHCPv4 servers
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام آغاز عملیات حذف تمام سرورها صادر می‌شود.
.SS PGSQL_CB_DELETE_ALL_SERVERS4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نتیجهٔ عملیات حذف تمام سرورها را نشان می‌دهد.
.SS PGSQL_CB_DELETE_ALL_SERVERS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete all DHCPv6 servers
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام آغاز عملیات حذف تمام سرورها صادر می‌شود.
.SS PGSQL_CB_DELETE_ALL_SERVERS6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نتیجهٔ عملیات حذف تمام سرورها را نشان می‌دهد.
.SS PGSQL_CB_DELETE_ALL_SHARED_NETWORKS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete all shared networks
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام آغاز عملیات حذف تمام شبکه‌های مشترک صادر می‌شود.
.SS PGSQL_CB_DELETE_ALL_SHARED_NETWORKS4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نتیجهٔ عملیات حذف تمام شبکه‌های مشترک را نشان می‌دهد.
.SS PGSQL_CB_DELETE_ALL_SHARED_NETWORKS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete all shared networks
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام آغاز عملیات حذف تمام شبکه‌های مشترک صادر می‌شود.
.SS PGSQL_CB_DELETE_ALL_SHARED_NETWORKS6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نتیجهٔ عملیات حذف تمام شبکه‌های مشترک را نشان می‌دهد.
.SS PGSQL_CB_DELETE_ALL_SUBNETS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete all subnets
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام آغاز عملیات حذف تمام زیرشبکه‌ها صادر می‌شود..SS PGSQL_CB_DELETE_ALL_SUBNETS4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ عملیات حذف تمام زیرشبکه‌ها است.
.SS PGSQL_CB_DELETE_ALL_SUBNETS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete all subnets
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام فراخوانی عملیات حذف تمام زیرشبکه‌ها صادر می‌شود.
.SS PGSQL_CB_DELETE_ALL_SUBNETS6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ عملیات حذف تمام زیرشبکه‌ها است.
.SS PGSQL_CB_DELETE_BY_POOL_OPTION4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete pool start: %1 pool end: %2 option code: %3 space: %4
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام فراخوانی عملیات حذف گزینه بر اساس استخر صادر می‌شود.
.SS PGSQL_CB_DELETE_BY_POOL_OPTION4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ عملیات حذف گزینه بر اساس استخر است.
.SS PGSQL_CB_DELETE_BY_POOL_OPTION6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete pool start: %1 pool end: %2 option code: %3 space: %4
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام فراخوانی عملیات حذف گزینه بر اساس استخر صادر می‌شود.
.SS PGSQL_CB_DELETE_BY_POOL_OPTION6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ عملیات حذف گزینه بر اساس استخر است.
.SS PGSQL_CB_DELETE_BY_POOL_PREFIX_OPTION6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete prefix: %1 prefix len: %2 option code: %3 space: %4
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام فراخوانی عملیات حذف گزینه بر اساس پیشوند صادر می‌شود.
.SS PGSQL_CB_DELETE_BY_POOL_PREFIX_OPTION6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ عملیات حذف گزینه بر اساس پیشوند است.
.SS PGSQL_CB_DELETE_BY_PREFIX_SUBNET4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete subnet by prefix: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام فراخوانی عملیات حذف زیرشبکه بر اساس پیشوند صادر می‌شود..SS PGSQL_CB_DELETE_BY_PREFIX_SUBNET4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ عملیات حذف زیرشبکه بر اساس پیشوند است.
.SS PGSQL_CB_DELETE_BY_PREFIX_SUBNET6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete subnet by prefix: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام آغاز عملیات حذف زیرشبکه بر اساس پیشوند صادر می‌شود.
.SS PGSQL_CB_DELETE_BY_PREFIX_SUBNET6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ عملیات حذف زیرشبکه بر اساس پیشوند است.
.SS PGSQL_CB_DELETE_BY_SUBNET_ID_OPTION4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete by subnet id: %1 option code: %2 space: %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام آغاز عملیات حذف گزینه بر اساس شناسهٔ زیرشبکه صادر می‌شود.
.SS PGSQL_CB_DELETE_BY_SUBNET_ID_OPTION4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ عملیات حذف گزینه بر اساس شناسهٔ زیرشبکه است.
.SS PGSQL_CB_DELETE_BY_SUBNET_ID_OPTION6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete by subnet id: %1 option code: %2 space: %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام آغاز عملیات حذف گزینه بر اساس شناسهٔ زیرشبکه صادر می‌شود.
.SS PGSQL_CB_DELETE_BY_SUBNET_ID_OPTION6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ عملیات حذف گزینه بر اساس شناسهٔ زیرشبکه است.
.SS PGSQL_CB_DELETE_BY_SUBNET_ID_SUBNET4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete subnet by subnet id: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام آغاز عملیات حذف زیرشبکه بر اساس شناسهٔ زیرشبکه صادر می‌شود.
.SS PGSQL_CB_DELETE_BY_SUBNET_ID_SUBNET4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ عملیات حذف زیرشبکه بر اساس شناسهٔ زیرشبکه است.
.SS PGSQL_CB_DELETE_BY_SUBNET_ID_SUBNET6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete subnet by subnet id: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام آغاز عملیات حذف زیرشبکه بر اساس شناسهٔ زیرشبکه صادر می‌شود..SS PGSQL_CB_DELETE_BY_SUBNET_ID_SUBNET6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که بیانگر نتیجهٔ عملیات حذف زیرشبکه بر اساس شناسهٔ زیرشبکه (subnet id) است.
.SS PGSQL_CB_DELETE_CLIENT_CLASS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete client class: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیات حذف کلاس کلاینت (client class) صادر می‌شود.
.SS PGSQL_CB_DELETE_CLIENT_CLASS4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که بیانگر نتیجهٔ عملیات حذف کلاس کلاینت (client class) است.
.SS PGSQL_CB_DELETE_CLIENT_CLASS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete client class: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیات حذف کلاس کلاینت (client class) صادر می‌شود.
.SS PGSQL_CB_DELETE_CLIENT_CLASS6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که بیانگر نتیجهٔ عملیات حذف کلاس کلاینت (client class) است.
.SS PGSQL_CB_DELETE_GLOBAL_PARAMETER4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete global parameter: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیات حذف پارامتر سراسری (global parameter) صادر می‌شود.
.SS PGSQL_CB_DELETE_GLOBAL_PARAMETER4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که بیانگر نتیجهٔ عملیات حذف پارامتر سراسری (global parameter) است.
.SS PGSQL_CB_DELETE_GLOBAL_PARAMETER6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete global parameter: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیات حذف پارامتر سراسری (global parameter) صادر می‌شود.
.SS PGSQL_CB_DELETE_GLOBAL_PARAMETER6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که بیانگر نتیجهٔ عملیات حذف پارامتر سراسری (global parameter) است.
.SS PGSQL_CB_DELETE_OPTION4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete option code: %1 space: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیات حذف گزینه (option) صادر می‌شود..SS PGSQL_CB_DELETE_OPTION4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نتیجهٔ عملیات حذف گزینه را نشان می‌دهد.
.SS PGSQL_CB_DELETE_OPTION6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete option code: %1 space: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده در هنگام آغاز عملیات حذف گزینه.
.SS PGSQL_CB_DELETE_OPTION6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نتیجهٔ عملیات حذف گزینه را نشان می‌دهد.
.SS PGSQL_CB_DELETE_OPTION_DEF4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete option definition code: %1 space: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده در هنگام آغاز عملیات حذف تعریف گزینه.
.SS PGSQL_CB_DELETE_OPTION_DEF4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نتیجهٔ عملیات حذف تعریف گزینه را نشان می‌دهد.
.SS PGSQL_CB_DELETE_OPTION_DEF6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete option definition code: %1 space: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده در هنگام آغاز عملیات حذف تعریف گزینه.
.SS PGSQL_CB_DELETE_OPTION_DEF6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نتیجهٔ عملیات حذف تعریف گزینه را نشان می‌دهد.
.SS PGSQL_CB_DELETE_SERVER4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete DHCPv4 server: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده در هنگام آغاز عملیات حذف یک کارساز.
.SS PGSQL_CB_DELETE_SERVER4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نتیجهٔ عملیات حذف یک کارساز را نشان می‌دهد.
.SS PGSQL_CB_DELETE_SERVER6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete DHCPv6 server: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده در هنگام آغاز عملیات حذف یک کارساز..SS PGSQL_CB_DELETE_SERVER6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نتیجهٔ عملیات حذف یک سرور را نشان می‌دهد.
.SS PGSQL_CB_DELETE_SHARED_NETWORK4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete shared network: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام آغاز عملیات حذف شبکهٔ مشترک (shared network).
.SS PGSQL_CB_DELETE_SHARED_NETWORK4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نتیجهٔ عملیات حذف شبکهٔ مشترک را نشان می‌دهد.
.SS PGSQL_CB_DELETE_SHARED_NETWORK6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete shared network: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام آغاز عملیات حذف شبکهٔ مشترک (shared network).
.SS PGSQL_CB_DELETE_SHARED_NETWORK6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نتیجهٔ عملیات حذف شبکهٔ مشترک را نشان می‌دهد.
.SS PGSQL_CB_DELETE_SHARED_NETWORK_OPTION4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete shared network: %1 option code: %2 space: %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام آغاز عملیات حذف گزینهٔ شبکهٔ مشترک.
.SS PGSQL_CB_DELETE_SHARED_NETWORK_OPTION4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نتیجهٔ عملیات حذف گزینهٔ شبکهٔ مشترک را نشان می‌دهد.
.SS PGSQL_CB_DELETE_SHARED_NETWORK_OPTION6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete shared network: %1 option code: %2 space: %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام آغاز عملیات حذف گزینهٔ شبکهٔ مشترک.
.SS PGSQL_CB_DELETE_SHARED_NETWORK_OPTION6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نتیجهٔ عملیات حذف گزینهٔ شبکهٔ مشترک را نشان می‌دهد.
.SS PGSQL_CB_DELETE_SHARED_NETWORK_SUBNETS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete shared network: %1 subnets
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام آغاز عملیات حذف زیرشبکه‌های شبکهٔ مشترک..SS PGSQL_CB_DELETE_SHARED_NETWORK_SUBNETS4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نتیجهٔ عملیات حذف زیرشبکه‌های شبکهٔ مشترک (shared network) را نشان می‌دهد.
.SS PGSQL_CB_DELETE_SHARED_NETWORK_SUBNETS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete shared network: %1 subnets
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام راه‌اندازی عملیات حذف زیرشبکه‌های شبکهٔ مشترک (shared network).
.SS PGSQL_CB_DELETE_SHARED_NETWORK_SUBNETS6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted: %1 entries
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نتیجهٔ عملیات حذف زیرشبکه‌های شبکهٔ مشترک (shared network) را نشان می‌دهد.
.SS PGSQL_CB_GET_ALL_CLIENT_CLASSES4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving all client classes
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام راه‌اندازی عملیات بازیابی تمام کلاس‌های کلاینت.
.SS PGSQL_CB_GET_ALL_CLIENT_CLASSES4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نتیجهٔ عملیات بازیابی تمام کلاس‌های کلاینت را نشان می‌دهد.
.SS PGSQL_CB_GET_ALL_CLIENT_CLASSES6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving all client classes
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام راه‌اندازی عملیات بازیابی تمام کلاس‌های کلاینت.
.SS PGSQL_CB_GET_ALL_CLIENT_CLASSES6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نتیجهٔ عملیات بازیابی تمام کلاس‌های کلاینت را نشان می‌دهد.
.SS PGSQL_CB_GET_ALL_GLOBAL_PARAMETERS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving all global parameters
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام راه‌اندازی عملیات بازیابی تمام پارامترهای سراسری.
.SS PGSQL_CB_GET_ALL_GLOBAL_PARAMETERS4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نتیجهٔ عملیات بازیابی تمام پارامترهای سراسری را نشان می‌دهد.
.SS PGSQL_CB_GET_ALL_GLOBAL_PARAMETERS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving all global parameters
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام راه‌اندازی عملیات بازیابی تمام پارامترهای سراسری..SS PGSQL_CB_GET_ALL_GLOBAL_PARAMETERS6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح وقایع‌نگاری اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نمایانگر نتیجه عملیاتی برای بازیابی تمامی پارامترهای سراسری است.
.SS PGSQL_CB_GET_ALL_OPTIONS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving all options
.EE
.UNINDENT
.UNINDENT
.sp
در سطح وقایع‌نگاری اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام آغاز عملیاتی برای بازیابی تمامی گزینه‌ها صادر می‌شود.
.SS PGSQL_CB_GET_ALL_OPTIONS4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح وقایع‌نگاری اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نمایانگر نتیجه عملیاتی برای بازیابی تمامی گزینه‌ها است.
.SS PGSQL_CB_GET_ALL_OPTIONS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving all options
.EE
.UNINDENT
.UNINDENT
.sp
در سطح وقایع‌نگاری اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام آغاز عملیاتی برای بازیابی تمامی گزینه‌ها صادر می‌شود.
.SS PGSQL_CB_GET_ALL_OPTIONS6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح وقایع‌نگاری اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نمایانگر نتیجه عملیاتی برای بازیابی تمامی گزینه‌ها است.
.SS PGSQL_CB_GET_ALL_OPTION_DEFS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving all option definitions
.EE
.UNINDENT
.UNINDENT
.sp
در سطح وقایع‌نگاری اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام آغاز عملیاتی برای بازیابی تمامی تعاریف گزینه‌ها صادر می‌شود.
.SS PGSQL_CB_GET_ALL_OPTION_DEFS4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح وقایع‌نگاری اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نمایانگر نتیجه عملیاتی برای بازیابی تمامی تعاریف گزینه‌ها است.
.SS PGSQL_CB_GET_ALL_OPTION_DEFS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving all option definitions
.EE
.UNINDENT
.UNINDENT
.sp
در سطح وقایع‌نگاری اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام آغاز عملیاتی برای بازیابی تمامی تعاریف گزینه‌ها صادر می‌شود.
.SS PGSQL_CB_GET_ALL_OPTION_DEFS6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح وقایع‌نگاری اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نمایانگر نتیجه عملیاتی برای بازیابی تمامی تعاریف گزینه‌ها است.
.SS PGSQL_CB_GET_ALL_SERVERS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving all servers
.EE
.UNINDENT
.UNINDENT
.sp
در سطح وقایع‌نگاری اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام آغاز عملیاتی برای بازیابی تمامی سرورهای DHCPv4 صادر می‌شود..SS PGSQL_CB_GET_ALL_SERVERS4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ عملیات بازیابی همهٔ کارگزارهای DHCPv4
است.
.SS PGSQL_CB_GET_ALL_SERVERS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving all DHCPv6 servers
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام آغاز عملیاتی برای بازیابی همهٔ کارگزارهای DHCPv6
صادر می‌شود.
.SS PGSQL_CB_GET_ALL_SERVERS6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ عملیات بازیابی همهٔ کارگزارهای DHCPv6
است.
.SS PGSQL_CB_GET_ALL_SHARED_NETWORKS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving all shared networks
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام آغاز عملیاتی برای بازیابی همهٔ شبکه‌های اشتراکی صادر می‌شود.
.SS PGSQL_CB_GET_ALL_SHARED_NETWORKS4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ عملیات بازیابی همهٔ شبکه‌های اشتراکی است.
.SS PGSQL_CB_GET_ALL_SHARED_NETWORKS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving all shared networks
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام آغاز عملیاتی برای بازیابی همهٔ شبکه‌های اشتراکی صادر می‌شود.
.SS PGSQL_CB_GET_ALL_SHARED_NETWORKS6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ عملیات بازیابی همهٔ شبکه‌های اشتراکی است.
.SS PGSQL_CB_GET_ALL_SUBNETS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving all subnets
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام آغاز عملیاتی برای بازیابی همهٔ زیرشبکه‌ها صادر می‌شود.
.SS PGSQL_CB_GET_ALL_SUBNETS4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ عملیات بازیابی همهٔ زیرشبکه‌ها است.
.SS PGSQL_CB_GET_ALL_SUBNETS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving all subnets
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام آغاز عملیاتی برای بازیابی همهٔ زیرشبکه‌ها صادر می‌شود..SS PGSQL_CB_GET_ALL_SUBNETS6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی نشان‌دهنده نتیجه عملیات بازیابی تمام زیرشبکه‌ها.
.SS PGSQL_CB_GET_CLIENT_CLASS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving client class: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیاتی برای بازیابی یک کلاس کلاینت صادر می‌شود.
.SS PGSQL_CB_GET_CLIENT_CLASS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving client class: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیاتی برای بازیابی یک کلاس کلاینت صادر می‌شود.
.SS PGSQL_CB_GET_GLOBAL_PARAMETER4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving global parameter: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیاتی برای بازیابی پارامتر سراسری صادر می‌شود.
.SS PGSQL_CB_GET_GLOBAL_PARAMETER6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving global parameter: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیاتی برای بازیابی پارامتر سراسری صادر می‌شود.
.SS PGSQL_CB_GET_HOST4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
get host
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیاتی برای بازیابی میزبان صادر می‌شود.
.SS PGSQL_CB_GET_HOST6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
get host
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیاتی برای بازیابی میزبان صادر می‌شود.
.SS PGSQL_CB_GET_MODIFIED_CLIENT_CLASSES4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving modified client classes from: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیاتی برای بازیابی کلاس‌های کلاینت تغییریافته از زمان مشخص‌شده صادر می‌شود.
.SS PGSQL_CB_GET_MODIFIED_CLIENT_CLASSES4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی نشان‌دهنده نتیجه عملیاتی برای بازیابی کلاس‌های کلاینت تغییریافته از زمان مشخص‌شده.
.SS PGSQL_CB_GET_MODIFIED_CLIENT_CLASSES6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving modified client classes from: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیاتی برای بازیابی کلاس‌های کلاینت تغییریافته از زمان مشخص‌شده صادر می‌شود..SS PGSQL_CB_GET_MODIFIED_CLIENT_CLASSES6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ عملیات بازیابی کلاس‌های کلاینتِ تغییریافته از زمان مشخص‌شده است.
.SS PGSQL_CB_GET_MODIFIED_GLOBAL_PARAMETERS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving modified global parameters from: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیات بازیابی پارامترهای سراسری تغییریافته از زمان مشخص‌شده صادر می‌شود.
.SS PGSQL_CB_GET_MODIFIED_GLOBAL_PARAMETERS4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ عملیات بازیابی پارامترهای سراسری تغییریافته از زمان مشخص‌شده است.
.SS PGSQL_CB_GET_MODIFIED_GLOBAL_PARAMETERS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving modified global parameters from: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیات بازیابی پارامترهای سراسری تغییریافته از زمان مشخص‌شده صادر می‌شود.
.SS PGSQL_CB_GET_MODIFIED_GLOBAL_PARAMETERS6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ عملیات بازیابی پارامترهای سراسری تغییریافته از زمان مشخص‌شده است.
.SS PGSQL_CB_GET_MODIFIED_OPTIONS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving modified options from: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیات بازیابی گزینه‌های تغییریافته از زمان مشخص‌شده صادر می‌شود.
.SS PGSQL_CB_GET_MODIFIED_OPTIONS4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ عملیات بازیابی گزینه‌های تغییریافته از زمان مشخص‌شده است.
.SS PGSQL_CB_GET_MODIFIED_OPTIONS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving modified options from: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیات بازیابی گزینه‌های تغییریافته از زمان مشخص‌شده صادر می‌شود.
.SS PGSQL_CB_GET_MODIFIED_OPTIONS6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که نشان‌دهندهٔ نتیجهٔ عملیات بازیابی گزینه‌های تغییریافته از زمان مشخص‌شده است.
.SS PGSQL_CB_GET_MODIFIED_OPTION_DEFS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving modified option definitions from: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام راه‌اندازی عملیات بازیابی تعاریف گزینه‌های تغییریافته از زمان مشخص‌شده صادر می‌شود..SS PGSQL_CB_GET_MODIFIED_OPTION_DEFS4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که بیانگر نتیجهٔ عملیات بازیابی تعاریف گزینه‌های تغییریافته از زمان مشخص‌شده است.
.SS PGSQL_CB_GET_MODIFIED_OPTION_DEFS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving modified option definitions from: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام فعال شدن عملیات بازیابی تعاریف گزینه‌های تغییریافته از زمان مشخص‌شده صادر می‌شود.
.SS PGSQL_CB_GET_MODIFIED_OPTION_DEFS6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که بیانگر نتیجهٔ عملیات بازیابی تعاریف گزینه‌های تغییریافته از زمان مشخص‌شده است.
.SS PGSQL_CB_GET_MODIFIED_SHARED_NETWORKS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving modified shared networks from: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام فعال شدن عملیات بازیابی شبکه‌های اشتراکی تغییریافته از زمان مشخص‌شده صادر می‌شود.
.SS PGSQL_CB_GET_MODIFIED_SHARED_NETWORKS4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که بیانگر نتیجهٔ عملیات بازیابی شبکه‌های اشتراکی تغییریافته از زمان مشخص‌شده است.
.SS PGSQL_CB_GET_MODIFIED_SHARED_NETWORKS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving modified shared networks from: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام فعال شدن عملیات بازیابی شبکه‌های اشتراکی تغییریافته از زمان مشخص‌شده صادر می‌شود.
.SS PGSQL_CB_GET_MODIFIED_SHARED_NETWORKS6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که بیانگر نتیجهٔ عملیات بازیابی شبکه‌های اشتراکی تغییریافته از زمان مشخص‌شده است.
.SS PGSQL_CB_GET_MODIFIED_SUBNETS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving modified subnets from: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام فعال شدن عملیات بازیابی زیرشبکه‌های تغییریافته از زمان مشخص‌شده صادر می‌شود.
.SS PGSQL_CB_GET_MODIFIED_SUBNETS4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که بیانگر نتیجهٔ عملیات بازیابی زیرشبکه‌های تغییریافته از زمان مشخص‌شده است.
.SS PGSQL_CB_GET_MODIFIED_SUBNETS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving modified subnets from: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که هنگام فعال شدن عملیات بازیابی زیرشبکه‌های تغییریافته از زمان مشخص‌شده صادر می‌شود..SS PGSQL_CB_GET_MODIFIED_SUBNETS6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش‌گیری اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی نشان‌دهندهٔ نتیجهٔ عملیاتی برای بازیابی زیرشبکه‌های تغییریافته از زمانی مشخص.
.SS PGSQL_CB_GET_OPTION4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving option code: %1 space: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش‌گیری اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام راه‌اندازی عملیاتی برای بازیابی گزینه.
.SS PGSQL_CB_GET_OPTION6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving option code: %1 space: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش‌گیری اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام راه‌اندازی عملیاتی برای بازیابی گزینه.
.SS PGSQL_CB_GET_OPTION_DEF4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving option definition code: %1 space: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش‌گیری اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام راه‌اندازی عملیاتی برای بازیابی تعریف گزینه.
.SS PGSQL_CB_GET_OPTION_DEF6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving option definition code: %1 space: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش‌گیری اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام راه‌اندازی عملیاتی برای بازیابی تعریف گزینه.
.SS PGSQL_CB_GET_PORT4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
get port
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش‌گیری اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام راه‌اندازی عملیاتی برای بازیابی پورت.
.SS PGSQL_CB_GET_PORT6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
get port
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش‌گیری اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام راه‌اندازی عملیاتی برای بازیابی پورت.
.SS PGSQL_CB_GET_RECENT_AUDIT_ENTRIES4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving audit entries from: %1 %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش‌گیری اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام راه‌اندازی عملیاتی برای بازیابی مدخل‌های بازرسی از یک زمان و شناسه مشخص.
.SS PGSQL_CB_GET_RECENT_AUDIT_ENTRIES4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش‌گیری اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی نشان‌دهندهٔ نتیجهٔ عملیاتی برای بازیابی مدخل‌های بازرسی از زمانی مشخص.
.SS PGSQL_CB_GET_RECENT_AUDIT_ENTRIES6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving audit entries from: %1 %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش‌گیری اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام راه‌اندازی عملیاتی برای بازیابی مدخل‌های بازرسی از یک زمان و شناسه مشخص..SS PGSQL_CB_GET_RECENT_AUDIT_ENTRIES6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی نشان‌دهندهٔ نتیجهٔ عملیاتی جهت بازیابی مدخل‌های بازرسی (audit entries) از یک زمان مشخص.
.SS PGSQL_CB_GET_SERVER4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving DHCPv4 server: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام آغاز عملیاتی جهت بازیابی اطلاعات یک سرور DHCPv4.
.SS PGSQL_CB_GET_SERVER6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving DHCPv6 server: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام آغاز عملیاتی جهت بازیابی اطلاعات یک سرور DHCPv6.
.SS PGSQL_CB_GET_SHARED_NETWORK4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving shared network: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام آغاز عملیاتی جهت بازیابی شبکهٔ اشتراکی (shared network).
.SS PGSQL_CB_GET_SHARED_NETWORK6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving shared network: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام آغاز عملیاتی جهت بازیابی شبکهٔ اشتراکی (shared network).
.SS PGSQL_CB_GET_SHARED_NETWORK_SUBNETS4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving shared network: %1 subnets
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام آغاز عملیاتی جهت بازیابی زیرشبکه‌های شبکهٔ اشتراکی.
.SS PGSQL_CB_GET_SHARED_NETWORK_SUBNETS4_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی نشان‌دهندهٔ نتیجهٔ عملیاتی جهت بازیابی زیرشبکه‌های شبکهٔ اشتراکی.
.SS PGSQL_CB_GET_SHARED_NETWORK_SUBNETS6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving shared network: %1 subnets
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام آغاز عملیاتی جهت بازیابی زیرشبکه‌های شبکهٔ اشتراکی.
.SS PGSQL_CB_GET_SHARED_NETWORK_SUBNETS6_RESULT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving: %1 elements
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی نشان‌دهندهٔ نتیجهٔ عملیاتی جهت بازیابی زیرشبکه‌های شبکهٔ اشتراکی.
.SS PGSQL_CB_GET_SUBNET4_BY_PREFIX
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving subnet by prefix: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادرشده هنگام آغاز عملیاتی جهت بازیابی زیرشبکه بر اساس پیشوند (prefix)..SS PGSQL_CB_GET_SUBNET4_BY_SUBNET_ID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving subnet by subnet id: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که با آغاز عملیاتی برای بازیابی زیرشبکه بر اساس شناسهٔ زیرشبکه صادر می‌شود.
.SS PGSQL_CB_GET_SUBNET6_BY_PREFIX
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving subnet by prefix: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که با آغاز عملیاتی برای بازیابی زیرشبکه بر اساس پیشوند صادر می‌شود.
.SS PGSQL_CB_GET_SUBNET6_BY_SUBNET_ID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
retrieving subnet by subnet id: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که با آغاز عملیاتی برای بازیابی زیرشبکه بر اساس شناسهٔ زیرشبکه صادر می‌شود.
.SS PGSQL_CB_GET_TYPE4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
get type
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که با آغاز عملیاتی برای بازیابی نوع صادر می‌شود.
.SS PGSQL_CB_GET_TYPE6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
get type
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی که با آغاز عملیاتی برای بازیابی نوع صادر می‌شود.
.SS PGSQL_CB_RECONNECT_ATTEMPT_FAILED4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
database reconnect failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
پیام خطایی که هنگام ناموفق بودن تلاش برای اتصال مجدد صادر می‌شود.
.SS PGSQL_CB_RECONNECT_ATTEMPT_FAILED6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
database reconnect failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
پیام خطایی که هنگام ناموفق بودن تلاش برای اتصال مجدد صادر می‌شود.
.SS PGSQL_CB_RECONNECT_ATTEMPT_SCHEDULE4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
scheduling attempt %1 of %2 in %3 milliseconds
.EE
.UNINDENT
.UNINDENT
.sp
پیام اطلاعاتی که هنگامی صادر می‌شود که کارساز در حال زمان‌بندی تلاش بعدی برای اتصال مجدد به پایگاه داده است. این وضعیت زمانی رخ می‌دهد که کارساز ارتباط خود را با پایگاه داده از دست داده و در حال تلاش برای اتصال مجددِ خودکار است.
.SS PGSQL_CB_RECONNECT_ATTEMPT_SCHEDULE6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
scheduling attempt %1 of %2 in %3 milliseconds
.EE
.UNINDENT
.UNINDENT
.sp
پیام اطلاعاتی که هنگامی صادر می‌شود که کارساز در حال زمان‌بندی تلاش بعدی برای اتصال مجدد به پایگاه داده است. این وضعیت زمانی رخ می‌دهد که کارساز ارتباط خود را با پایگاه داده از دست داده و در حال تلاش برای اتصال مجددِ خودکار است.
.SS PGSQL_CB_RECONNECT_FAILED4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
maximum number of database reconnect attempts: %1, has been exhausted without success
.EE
.UNINDENT
.UNINDENT
.sp
پیام خطایی که هنگامی صادر می‌شود که کارساز در اتصال مجدد ناموفق بوده است. قطع اتصال معمولاً ناشی از مشکلات شبکه یا کارساز پایگاه داده است..SS PGSQL_CB_RECONNECT_FAILED6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
maximum number of database reconnect attempts: %1, has been exhausted without success
.EE
.UNINDENT
.UNINDENT
.sp
پیام خطایی که هنگام عدم موفقیت کارساز در اتصال مجدد صادر می‌شود. قطع ارتباط معمولاً ناشی از مشکلات شبکه یا کارساز پایگاه داده است.
.SS PGSQL_CB_REGISTER_BACKEND_TYPE4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
register backend
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادر شده هنگام راه‌اندازی عملیاتی برای ثبت backend.
.SS PGSQL_CB_REGISTER_BACKEND_TYPE6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
register backend
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادر شده هنگام راه‌اندازی عملیاتی برای ثبت backend.
.SS PGSQL_CB_UNREGISTER_BACKEND_TYPE4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
unregister backend
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادر شده هنگام راه‌اندازی عملیاتی برای لغو ثبت backend.
.SS PGSQL_CB_UNREGISTER_BACKEND_TYPE6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
unregister backend
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
پیام اشکال‌زدایی صادر شده هنگام راه‌اندازی عملیاتی برای لغو ثبت backend.
.SS PGSQL_DEINIT_OK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
unloading PostgreSQL hooks library successful
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که کتابخانه قلاب‌های (hooks) بک‌اند PostgreSQL با موفقیت تخلیه (unload) شده است.
.SS PGSQL_FB_DB
.INDENT 0.0
.INDENT 3.5
.sp
.EX
opening PostgreSQL log database: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی زمانی ثبت می‌شود که کتابخانه قلاب legal log در شرف باز کردن یک پایگاه داده لاگ PostgreSQL باشد. پارامترهای اتصال، از جمله نام پایگاه داده و نام کاربری مورد نیاز برای دسترسی به آن (به‌جز گذرواژه، در صورت وجود)، در لاگ ثبت می‌شوند.
.SS PGSQL_HB_DB
.INDENT 0.0
.INDENT 3.5
.sp
.EX
opening PostgreSQL hosts database: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی زمانی ثبت می‌شود که یک کارساز DHCP (نسخه V4 یا V6) در شرف باز کردن پایگاه داده میزبان‌های PostgreSQL باشد. پارامترهای اتصال، از جمله نام پایگاه داده و نام کاربری مورد نیاز برای دسترسی به آن (به‌جز گذرواژه، در صورت وجود)، در لاگ ثبت می‌شوند.
.SS PGSQL_HB_DB_GET_VERSION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining schema version information for the PostgreSQL hosts database
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارساز در شرف دریافت اطلاعات نگارش شمای پایگاه داده میزبان‌های PostgreSQL است.
.SS PGSQL_HB_DB_READONLY
.INDENT 0.0
.INDENT 3.5
.sp
.EX
PostgreSQL host database opened for read access only
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی زمانی صادر می‌شود که کاربر پایگاه داده PostgreSQL را در حالت فقط‌خواندنی (read\-only) پیکربندی کرده باشد. Kea قادر به درج یا تغییر رزروهای میزبان نخواهد بود، اما می‌تواند موارد موجود را بازیابی کرده و به کلاینت‌هایی که با کارساز ارتباط برقرار می‌کنند اختصاص دهد..SS PGSQL_HB_DB_RECONNECT_ATTEMPT_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
database reconnect failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
پیام خطایی که هنگام ناموفق بودن تلاش برای اتصال مجدد صادر می‌شود.
.SS PGSQL_HB_DB_RECONNECT_ATTEMPT_SCHEDULE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
scheduling attempt %1 of %2 in %3 milliseconds
.EE
.UNINDENT
.UNINDENT
.sp
پیام اطلاعاتی که هنگام زمان‌بندی تلاش بعدی کارساز برای اتصال مجدد به پایگاه داده صادر می‌شود. این حالت زمانی رخ می‌دهد که ارتباط کارساز با پایگاه داده قطع شده و تلاش برای اتصال مجدد خودکار در جریان باشد.
.SS PGSQL_HB_DB_RECONNECT_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
maximum number of database reconnect attempts: %1, has been exhausted without success
.EE
.UNINDENT
.UNINDENT
.sp
پیام خطایی که هنگام شکست کارساز در برقراری مجدد اتصال صادر می‌شود. قطع ارتباط معمولاً به دلیل مشکلات شبکه یا کارساز پایگاه داده رخ می‌دهد.
.SS PGSQL_INIT_OK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
loading PostgreSQL hooks library successful
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی نشان می‌دهد که کتابخانه قلاب‌های (hooks) پس‌زمینه PostgreSQL با موفقیت بارگذاری شده است. لذت ببرید!
.SS PGSQL_LB_ADD_ADDR4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
adding IPv4 lease with address %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارساز در شرف افزودن یک اجاره (lease) IPv4 با نشانی مشخص‌شده به پایگاه داده پس‌زمینه PostgreSQL است.
.SS PGSQL_LB_ADD_ADDR6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
adding IPv6 lease with address %1, lease type %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارساز در شرف افزودن یک اجاره (lease) IPv6 با نشانی مشخص‌شده به پایگاه داده پس‌زمینه PostgreSQL است.
.SS PGSQL_LB_COMMIT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
committing to PostgreSQL database
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
کد یک فراخوانی commit صادر کرده است. تمام تراکنش‌های معلق در پایگاه داده اعمال (commit) خواهند شد. توجه داشته باشید که بسته به تنظیمات PostgreSQL، ممکن است commit شامل نوشتن مستقیم روی دیسک نباشد.
.SS PGSQL_LB_DB
.INDENT 0.0
.INDENT 3.5
.sp
.EX
opening PostgreSQL lease database: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی زمانی ثبت می‌شود که یک کارساز DHCP (نسخه V4 یا V6) در آستانه باز کردن پایگاه داده اجاره‌های PostgreSQL باشد. پارامترهای اتصال، از جمله نام پایگاه داده و نام کاربری مورد نیاز برای دسترسی به آن (به‌جز گذرواژه، در صورت وجود) ثبت می‌شوند.
.SS PGSQL_LB_DB_RECONNECT_ATTEMPT_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
database reconnect failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
پیام خطایی که هنگام ناموفق بودن تلاش برای اتصال مجدد صادر می‌شود.
.SS PGSQL_LB_DB_RECONNECT_ATTEMPT_SCHEDULE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
scheduling attempt %1 of %2 in %3 milliseconds
.EE
.UNINDENT
.UNINDENT
.sp
پیام اطلاعاتی که هنگام زمان‌بندی تلاش بعدی کارساز برای اتصال مجدد به پایگاه داده صادر می‌شود. این حالت زمانی رخ می‌دهد که ارتباط کارساز با پایگاه داده قطع شده و تلاش برای اتصال مجدد خودکار در جریان باشد..SS PGSQL_LB_DB_RECONNECT_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
maximum number of database reconnect attempts: %1, has been exhausted without success
.EE
.UNINDENT
.UNINDENT
.sp
یک پیام خطا که هنگام ناموفق بودن تلاش سرور برای برقراری مجدد اتصال صادر می‌شود. از دست رفتن اتصال معمولاً ناشی از یک مشکل در شبکه یا سرور پایگاه داده است.
.SS PGSQL_LB_DELETED_SUBNET4_ID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted %1 leases that match subnet ID %2.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در حال حذف اجاره‌هایی است که با شناسه زیرشبکه (subnet ID) مربوطه مطابقت دارند.
.SS PGSQL_LB_DELETED_SUBNET6_ID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleted %1 leases that match subnet ID %2.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در حال حذف اجاره‌هایی است که با شناسه زیرشبکه (subnet ID) مربوطه مطابقت دارند.
.SS PGSQL_LB_DELETE_ADDR4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleting lease for address %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در تلاش است تا اجاره آدرس مشخص‌شده را از پایگاه داده PostgreSQL حذف کند.
.SS PGSQL_LB_DELETE_ADDR6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleting lease for address %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در تلاش است تا اجاره آدرس مشخص‌شده را از پایگاه داده PostgreSQL حذف کند.
.SS PGSQL_LB_DELETE_EXPIRED_RECLAIMED4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleting reclaimed IPv4 leases that expired more than %1 seconds ago
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در حال حذف اجاره‌های بازپس‌گرفته‌شده DHCPv4 است که از انقضای آن‌ها بیش از یک بازه زمانی مشخص گذشته است.
آرگومان، مدت زمانی است که Kea پس از منقضی شدن یک اجاره بازپس‌گرفته‌شده، پیش از در نظر گرفتن حذف آن، منتظر می‌ماند.
.SS PGSQL_LB_DELETE_EXPIRED_RECLAIMED6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
deleting reclaimed IPv6 leases that expired more than %1 seconds ago
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در حال حذف اجاره‌های بازپس‌گرفته‌شده DHCPv6 است که از انقضای آن‌ها بیش از یک بازه زمانی مشخص گذشته است.
آرگومان، مدت زمانی است که Kea پس از منقضی شدن یک اجاره بازپس‌گرفته‌شده، پیش از در نظر گرفتن حذف آن، منتظر می‌ماند.
.SS PGSQL_LB_GET4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining all IPv4 leases
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در تلاش است تا تمام اجاره‌های IPv4 را از پایگاه داده PostgreSQL دریافت کند.
.SS PGSQL_LB_GET6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining all IPv6 leases
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در تلاش است تا تمام اجاره‌های IPv6 را از پایگاه داده PostgreSQL دریافت کند..SS PGSQL_LB_GET_ADDR4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv4 lease for address %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارساز در تلاش است تا یک اجارهٔ IPv4 را برای آدرس مشخص‌شده از پایگاه‌دادهٔ PostgreSQL دریافت کند.
.SS PGSQL_LB_GET_ADDR6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv6 lease for address %1 (lease type %2)
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارساز در تلاش است تا یک اجارهٔ IPv6 را برای آدرس مشخص‌شده از پایگاه‌دادهٔ PostgreSQL دریافت کند.
.SS PGSQL_LB_GET_CLIENTID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv4 leases for client ID %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارساز در تلاش است تا مجموعه‌ای از اجاره‌های IPv4 را برای کلاینتی با شناسهٔ مشخص‌شدهٔ کلاینت، از پایگاه‌دادهٔ PostgreSQL دریافت کند.
.SS PGSQL_LB_GET_DUID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv6 leases for DUID %1,
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارساز در تلاش است تا مجموعه‌ای از اجاره‌های IPv6 را برای کلاینتی با DUID (شناسهٔ یکتای DHCP) مشخص‌شده، از پایگاه‌دادهٔ PostgreSQL دریافت کند.
.SS PGSQL_LB_GET_EXPIRED4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining maximum %1 of expired IPv4 leases
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارساز در تلاش است تا اجاره‌های منقضی‌شدهٔ IPv4 را برای بازپس‌گیری آن‌ها دریافت کند. حداکثر تعداد اجاره‌های قابل‌بازیابی در پیام ثبت می‌شود.
.SS PGSQL_LB_GET_EXPIRED6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining maximum %1 of expired IPv6 leases
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارساز در تلاش است تا اجاره‌های منقضی‌شدهٔ IPv6 را برای بازپس‌گیری آن‌ها دریافت کند. حداکثر تعداد اجاره‌های قابل‌بازیابی در پیام ثبت می‌شود.
.SS PGSQL_LB_GET_HOSTNAME4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv4 leases for hostname %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارساز در تلاش است تا مجموعه‌ای از اجاره‌های IPv4 را برای کلاینتی با نام میزبان مشخص‌شده، از پایگاه‌دادهٔ PostgreSQL دریافت کند.
.SS PGSQL_LB_GET_HOSTNAME6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv6 leases for hostname %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارساز در تلاش است تا مجموعه‌ای از اجاره‌های IPv6 را برای کلاینتی با نام میزبان مشخص‌شده، از پایگاه‌دادهٔ PostgreSQL دریافت کند.
.SS PGSQL_LB_GET_HWADDR4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv4 leases for hardware address %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارساز در تلاش است تا مجموعه‌ای از اجاره‌های IPv4 را برای کلاینتی با آدرس سخت‌افزاری مشخص‌شده، از پایگاه‌دادهٔ PostgreSQL دریافت کند..SS PGSQL_LB_GET_HWADDR6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv6 leases for hardware address %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در تلاش است تا مجموعه‌ای
از اجاره‌های IPv6 را از پایگاه داده PostgreSQL برای کلاینتی با آدرس
سخت‌افزاری مشخص‌شده دریافت کند.
.SS PGSQL_LB_GET_IAID_DUID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv4 leases for IAID %1 and DUID %2, lease type %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در تلاش است تا مجموعه‌ای از اجاره‌های IPv6
را از پایگاه داده PostgreSQL برای کلاینتی با IAID (شناسه Identity Association ID)
و DUID (شناسه DHCP Unique Identifier) مشخص‌شده دریافت کند.
.SS PGSQL_LB_GET_IAID_SUBID_DUID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv4 leases for IAID %1, subnet ID %2, DUID %3, and lease type %4
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در تلاش است تا یک اجاره
IPv6 را از پایگاه داده PostgreSQL برای کلاینتی با IAID (شناسه Identity Association ID)،
subnet ID و DUID (شناسه DHCP Unique Identifier) مشخص‌شده دریافت کند.
.SS PGSQL_LB_GET_PAGE4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining at most %1 IPv4 leases starting from address %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در تلاش است تا صفحه‌ای
از اجاره‌ها را که با آدرس مشخص‌شده شروع می‌شوند، دریافت کند.
.SS PGSQL_LB_GET_PAGE6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining at most %1 IPv6 leases starting from address %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در تلاش است تا صفحه‌ای
از اجاره‌ها را که با آدرس مشخص‌شده شروع می‌شوند، دریافت کند.
.SS PGSQL_LB_GET_RELAYID4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining at most %1 IPv4 leases starting from address %2 with relay id %3 and cltt between %4 and %5
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در تلاش است تا صفحه‌ای از
اجاره‌های IPv4 را که با آدرس مشخص‌شده آغاز می‌شوند، با یک relay id و زمان
تراکنش کلاینت بین تاریخ‌های شروع و پایان دریافت کند.
.SS PGSQL_LB_GET_RELAYID6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining at most %1 IPv6 leases starting from address %2 with relay id %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در تلاش است تا صفحه‌ای از
اجاره‌های IPv6 را که با آدرس مشخص‌شده آغاز می‌شوند، با یک relay id دریافت کند.
.SS PGSQL_LB_GET_REMOTEID4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining at most %1 IPv4 leases starting from address %2 with remote id %3 and cltt between %4 and %5
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در تلاش است تا صفحه‌ای از
اجاره‌های IPv4 را که با آدرس مشخص‌شده آغاز می‌شوند، با یک remote id و زمان
تراکنش کلاینت بین تاریخ‌های شروع و پایان دریافت کند.
.SS PGSQL_LB_GET_REMOTEID6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining at most %1 IPv6 leases starting from address %2 with remote id %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در تلاش است تا صفحه‌ای از
اجاره‌های IPv6 را که با آدرس مشخص‌شده آغاز می‌شوند، با یک remote id دریافت کند..SS PGSQL_LB_GET_STATE4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv4 leases with state %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در تلاش است مجموعه‌ای از
اجاره‌های IPv4 با وضعیت مشخص‌شده را از پایگاه دادهٔ PostgreSQL دریافت کند.
.SS PGSQL_LB_GET_STATE6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv6 leases with state %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در تلاش است مجموعه‌ای از
اجاره‌های IPv6 با وضعیت مشخص‌شده را از پایگاه دادهٔ PostgreSQL دریافت کند.
.SS PGSQL_LB_GET_STATE_SUBID4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv4 leases with state %1 in subnet %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در تلاش است مجموعه‌ای از
اجاره‌های IPv4 با وضعیت مشخص‌شده در زیرشبکهٔ تعیین‌شده را از پایگاه دادهٔ PostgreSQL
دریافت کند.
.SS PGSQL_LB_GET_STATE_SUBID6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv6 leases with state %1 in subnet %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در تلاش است مجموعه‌ای از
اجاره‌های IPv6 با وضعیت مشخص‌شده در زیرشبکهٔ تعیین‌شده را از پایگاه دادهٔ PostgreSQL
دریافت کند.
.SS PGSQL_LB_GET_SUBID4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv4 leases for subnet ID %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در تلاش است تمام اجاره‌های IPv4
مربوط به یک شناسهٔ زیرشبکهٔ داده‌شده را از پایگاه دادهٔ PostgreSQL دریافت کند.
.SS PGSQL_LB_GET_SUBID6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv6 leases for subnet ID %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در تلاش است تمام اجاره‌های IPv6
مربوط به یک شناسهٔ زیرشبکهٔ داده‌شده را از پایگاه دادهٔ PostgreSQL دریافت کند.
.SS PGSQL_LB_GET_SUBID_CLIENTID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv4 lease for subnet ID %1 and client ID %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در تلاش است یک اجارهٔ IPv4
را برای کلاینتی با شناسهٔ زیرشبکه و شناسهٔ کلاینت مشخص‌شده از پایگاه دادهٔ PostgreSQL
دریافت کند.
.SS PGSQL_LB_GET_SUBID_HWADDR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining IPv4 lease for subnet ID %1 and hardware address %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در تلاش است یک اجارهٔ IPv4
را برای کلاینتی با شناسهٔ زیرشبکه و آدرس سخت‌افزاری مشخص‌شده از پایگاه دادهٔ PostgreSQL
دریافت کند.
.SS PGSQL_LB_GET_SUBID_PAGE6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining at most %1 IPv6 leases starting from address %2 for subnet ID %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در تلاش است صفحه‌ای از
اجاره‌های IPv6 را با شروع از آدرس مشخص‌شده برای شناسهٔ زیرشبکهٔ تعیین‌شده از
پایگاه دادهٔ PostgreSQL دریافت کند..SS PGSQL_LB_GET_VERSION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
obtaining schema version information
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در آستانهٔ دریافت اطلاعات
نسخهٔ طرح‌واره (schema) از پایگاه‌دادهٔ PostgreSQL است.
.SS PGSQL_LB_NEGATIVE_LEASES_STAT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
recount of leases returned a negative value
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که شمارش مجدد اجاره‌ها با استفاده از
شمارنده‌ها در پایگاه‌دادهٔ PostgreSQL یک مقدار منفی برگردانده باشد. این امر
نشان‌دهندهٔ مشکلی است که تنها با یک شمارش مجدد مستقیم و برون‌خط (offline) بر روی
پایگاه‌داده قابل رفع است. این پیام فقط یک بار صادر می‌شود.
.SS PGSQL_LB_ROLLBACK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
rolling back PostgreSQL database
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
کد یک فراخوانی عقب‌گرد (rollback) صادر کرده است. تمام تراکنش‌های در انتظار،
به عقب بازگردانده شده و در پایگاه‌داده ثبت نهایی (commit) نخواهند شد.
.SS PGSQL_LB_SFLQ_CREATE_POOL4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
creating shared\-flq pool for address range %1 \- %2, subnet id %3, recreate %4, capacity %5
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور از بک‌اند اجاره می‌خواهد
داده‌های اجارهٔ آزاد اشتراکی را برای استخر (pool) شرح‌داده‌شده در آرگومان‌ها
(مجدداً) ایجاد کند.
.SS PGSQL_LB_SFLQ_CREATE_POOL6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
creating shared\-flq pool for address range %1 \- %2, type %3, delegated length: %4, subnet id %5, recreate %6, capacity %7
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور از بک‌اند اجاره می‌خواهد
داده‌های اجارهٔ آزاد اشتراکی را برای استخر شرح‌داده‌شده در آرگومان‌ها
(مجدداً) ایجاد کند.
.SS PGSQL_LB_SFLQ_PICK_LEASE4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
picking a free lease from address range %1 \- %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور از بک‌اند اجاره، یک نشانی آزاد
از استخر شرح‌داده‌شده در آرگومان‌ها را درخواست می‌کند.
.SS PGSQL_LB_SFLQ_PICK_LEASE6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
picking a free lease from address range %1 \- %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور از بک‌اند اجاره، یک اجارهٔ آزاد
از استخر شرح‌داده‌شده در آرگومان‌ها را درخواست می‌کند.
.SS PGSQL_LB_SFLQ_POOL4_DELETE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete the V4 SFLQ pool with start address %1 and end address %2, force = %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور از بک‌اند اجاره درخواست می‌کند
استخر SFLQ مربوط به v4 (و داده‌های اجارهٔ آزاد آن) را که با نشانی‌های آغاز و پایان
داده‌شده همخوانی دارد، حذف کند.
.SS PGSQL_LB_SFLQ_POOL4_GET_ALL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
fetch all V4 SFLQ pools
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور فهرستی از تمام استخرهای SFLQ
مربوط به v4 را از بک‌اند اجاره درخواست می‌کند.
.SS PGSQL_LB_SFLQ_POOL4_GET_BY_RANGE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
fetch all V4 SFLQ pools that overlap the range %1 and %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور استخرهای SFLQ مربوط به v4 را که با
محدودهٔ نشانی داده‌شده هم‌پوشانی دارند، از بک‌اند اجاره درخواست می‌کند..SS PGSQL_LB_SFLQ_POOL4_GET_BY_SUBNET
.INDENT 0.0
.INDENT 3.5
.sp
.EX
fetch all V4 SFLQ pools for subnet\-id %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی 50 ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور از بک‌اند اجاره، فهرستی از تمام استخرهای v4 SFLQ متعلق به یک زیرشبکه را درخواست کند.
.SS PGSQL_LB_SFLQ_POOL6_DELETE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
delete the V6 SFLQ pool with start address %1 and end address %2, force = %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی 50 ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور از بک‌اند اجاره درخواست کند استخر v6 SFLQ (و داده‌های اجارهٔ آزاد آن) را که با آدرس‌های آغاز و پایان داده‌شده مطابقت دارند، حذف نماید.
.SS PGSQL_LB_SFLQ_POOL6_GET_ALL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
fetch all V6 SFLQ pools
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی 50 ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور از بک‌اند اجاره، فهرستی از تمام استخرهای v6 SFLQ را درخواست کند.
.SS PGSQL_LB_SFLQ_POOL6_GET_BY_RANGE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
fetch all V6 SFLQ pools that overlap the range %1 and %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی 50 ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور از بک‌اند اجاره، استخرهای v6 SFLQ را که با محدودهٔ آدرس مشخص‌شده هم‌پوشانی دارند درخواست کند.
.SS PGSQL_LB_SFLQ_POOL6_GET_BY_SUBNET
.INDENT 0.0
.INDENT 3.5
.sp
.EX
fetch all V6 SFLQ pools for subnet\-id %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی 50 ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور از بک‌اند اجاره، فهرستی از تمام استخرهای v6 SFLQ متعلق به یک زیرشبکه را درخواست کند.
.SS PGSQL_LB_UPDATE_ADDR4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
updating IPv4 lease for address %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی 50 ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در تلاش برای به‌روزرسانی اجارهٔ IPv4 از پایگاه‌دادهٔ PostgreSQL برای آدرس مشخص‌شده است.
.SS PGSQL_LB_UPDATE_ADDR6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
updating IPv6 lease for address %1, lease type %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی 50 ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در تلاش برای به‌روزرسانی اجارهٔ IPv6 از پایگاه‌دادهٔ PostgreSQL برای آدرس مشخص‌شده است.
.SS PGSQL_LB_UPGRADE_EXTENDED_INFO4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
upgrading IPv4 leases done in %1 pages with %2 updated leases
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی 40 ثبت می‌شود.
سرور اطلاعات گسترش‌یافته (extended info) را ارتقا داد. تعداد صفحه‌ها و شمار نهایی اجاره‌های به‌روزرسانی‌شده نمایش داده می‌شوند.
.SS PGSQL_LB_UPGRADE_EXTENDED_INFO4_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
upgrading extending info for IPv4 lease at %1 failed with %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی 40 ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور در ارتقای اطلاعات گسترش‌یافته با شکست مواجه شود. آدرس اجاره و پیام خطا نمایش داده می‌شوند.
.SS PGSQL_LB_UPGRADE_EXTENDED_INFO4_PAGE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
upgrading IPv4 lease extended info at page %1 starting at %2 (updated %3)
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی 50 ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور اطلاعات گسترش‌یافتهٔ اجارهٔ IPv4 را ارتقا می‌دهد. شمارهٔ صفحه، آدرس آغازین و تعداد اجاره‌های از قبل به‌روزرسانی‌شده نمایش داده می‌شوند..SS PGSQL_LB_UPGRADE_EXTENDED_INFO6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
upgrading IPv6 leases done in %1 pages with %2 updated leases
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
کارساز اطلاعات توسعه‌یافته را ارتقا داد. تعداد صفحه‌ها و شمار نهایی اجاره‌های به‌روزرسانی‌شده نمایش داده می‌شوند.
.SS PGSQL_LB_UPGRADE_EXTENDED_INFO6_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
upgrading extending info for IPv6 lease at %1 failed with %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارساز نتواند اطلاعات توسعه‌یافته را برای یک اجاره ارتقا دهد. نشانی اجاره و پیام خطا نمایش داده می‌شوند.
.SS PGSQL_LB_UPGRADE_EXTENDED_INFO6_PAGE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
upgrading IPv6 lease extended info at page %1 starting at %2 (updated %3)
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی صادر می‌شود که کارساز اطلاعات توسعه‌یافته اجاره IPv6 را ارتقا می‌دهد. شماره صفحه، نشانی آغازین و تعداد اجاره‌هایی که تاکنون به‌روزرسانی شده‌اند نمایش داده می‌شوند.
.SS PING
.SS PING_CHECK_CB4_UPDATE_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
A subnet ping\-check parameters failed to parse after being updated %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا هنگامی صادر می‌شود که پس از به‌روزرسانی زیرشبکه از طریق backend پیکربندی، خطایی در تجزیه پارامترهای ping\-check زیرشبکه رخ دهد. این نشان می‌دهد که یک یا چند پارامتر نامعتبر هستند و باید اصلاح شوند.
.SS PING_CHECK_CHANNEL_ECHO_REPLY_RECEIVED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from address %1, id %2, sequence %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک ECHO REPLY روی سوکت ICMP کانال ping دریافت شده باشد.
.SS PING_CHECK_CHANNEL_ECHO_REQUEST_SENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
to address %1, id %2, sequence %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک ECHO REQUEST روی سوکت ICMP کانال ping نوشته (ارسال) شده باشد.
.SS PING_CHECK_CHANNEL_MALFORMED_PACKET_RECEIVED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
error occurred unpacking message %1, discarding it
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که بسته ICMP دریافت شده باشد که بازگشایی (unpack) آن امکان‌پذیر نیست.
.SS PING_CHECK_CHANNEL_NETWORK_WRITE_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
occurred trying to ping %1, error %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی رخ می‌دهد که یک نوشتن ناهمگام روی سوکت ICMP هنگام تلاش برای ارسال به شبکه هدف ping با شکست مواجه شود. این ممکن است به این معنی باشد که یک رابط شبکه غیرفعال (down) است یا خطای پیکربندی وجود دارد. نشانی اجاره برای ping و نوع خطا در آرگومان‌ها ارائه شده‌اند.
.SS PING_CHECK_CHANNEL_SOCKET_CLOSED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ICMP socket has been closed.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سوکت ICMP برای انجام بررسی‌های ping بسته شده باشد..SS PING_CHECK_CHANNEL_SOCKET_CLOSE_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
an attempt to close the ICMP socket failed %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که هنگام بستن سوکت ICMP مربوط به بررسی پینگ (ping check)، خطای غیرمنتظره‌ای رخ دهد. جزئیات خطا به عنوان آرگومان در پیام لاگ ارائه شده است.
.SS PING_CHECK_CHANNEL_SOCKET_OPENED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ICMP socket been opened successfully.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug log level) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سوکت ICMP برای انجام بررسی‌های پینگ با موفقیت باز شده باشد.
.SS PING_CHECK_CHANNEL_SOCKET_READ_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
socket read completed with an error %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی رخ می‌دهد که خواندن ناهمگام (asynchronous read) روی سوکت ICMP با شکست مواجه شود. جزئیات خطا به عنوان آرگومان در پیام لاگ ارائه شده است.
.SS PING_CHECK_CHANNEL_SOCKET_WRITE_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
socket write completed with an error %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی رخ می‌دهد که نوشتن ناهمگام (asynchronous write) روی سوکت ICMP با شکست مواجه شود. جزئیات خطا به عنوان آرگومان در پیام لاگ ارائه شده است.
.SS PING_CHECK_CHANNEL_STOP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
channel is stopping operations.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug log level) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که کانال در حال توقف عملیات و بستن سوکت ICMP است. دلیل توقف باید در پیام‌های لاگ قبلی مشخص باشد.
.SS PING_CHECK_CHANNEL_WATCH_SOCKET_CLEAR_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
an attempt to clear the WatchSocket associated with
.EE
.UNINDENT
.UNINDENT
.sp
the single\-threaded ping\-channel failed %1
این پیام خطا زمانی صادر می‌شود که هنگام پاک کردن نشانگر آمادگی (ready marker) سوکت WatchSocket مرتبط با کانال بررسی پینگ، خطای غیرمنتظره‌ای رخ دهد. این وضعیت تنها هنگام اجرا در حالت تک‌نخی (single\-threaded) می‌تواند رخ دهد. جزئیات خطا به عنوان آرگومان در پیام لاگ ارائه شده است.
.SS PING_CHECK_CHANNEL_WATCH_SOCKET_CLOSE_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
an attempt to close the WatchSocket associated with
.EE
.UNINDENT
.UNINDENT
.sp
the single\-threaded ping\-channel failed %1
این پیام خطا زمانی صادر می‌شود که هنگام بستن WatchSocket مرتبط با کانال بررسی پینگ، خطای غیرمنتظره‌ای رخ دهد. این وضعیت تنها هنگام اجرا در حالت تک‌نخی (single\-threaded) می‌تواند رخ دهد. جزئیات خطا به عنوان آرگومان در پیام لاگ ارائه شده است.
.SS PING_CHECK_DHCP4_SRV_CONFIGURED_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
dhcp4_srv_configured callout failed %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهندهٔ بروز خطا در حین فراخوانی (callout) تابع dhcp4_srv_configured از کتابخانه هوک (hook library) مربوط به Ping Check است. جزئیات خطا به عنوان آرگومان در پیام لاگ ارائه شده است.
.SS PING_CHECK_DUPLICATE_CHECK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Ping check already in progress for %1, initiated by %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug log level) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک درخواست تکراری برای بررسی یک نشانی دریافت گردد. در صورت وقوع، از بررسی تکراری صرف‌نظر می‌شود و DHCPOFFER مرتبط نادیده گرفته و رها (drop) خواهد شد..SS PING_CHECK_LEASE4_OFFER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
lease4_offer callout failed for query %1, lease address %2, reason %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهنده بروز خطا در حین فراخوانی (callout) مربوط به lease4_offer در کتابخانه قلاب‌های Ping Check است. جزئیات خطا به عنوان آرگومان پیام گزارش ارائه شده‌اند.
.SS PING_CHECK_LOAD_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
loading Ping Check hooks library failed %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهنده بروز خطا در حین بارگذاری کتابخانه قلاب‌های Ping Check است. جزئیات خطا به عنوان آرگومان پیام گزارش ارائه شده‌اند.
.SS PING_CHECK_LOAD_OK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Ping Check hooks library loaded successfully.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی نشان می‌دهد که کتابخانه قلاب‌های Ping Check با موفقیت بارگذاری شده است.
.SS PING_CHECK_MGR_CHANNEL_DOWN
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Ping Channel has shutdown, ping checking will be skipped
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که کانال زیرین ICMP به دلیل یک خطای غیرقابل جبران متوقف شده باشد. سرویس DHCP ممکن است به کار خود ادامه دهد اما بدون انجام بررسی‌های ping. پیام‌های گزارش قبلی باید جزئیات را ارائه دهند.
.SS PING_CHECK_MGR_LEASE_FREE_TO_USE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
address %1 is free to use for %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که ping check تشخیص دهد نشانی برای استفاده آزاد است. آرگومان‌های گزارش، نشانی اجاره (lease) بررسی‌شده و درخواستی را که این بررسی را آغاز کرده است مشخص می‌کنند.
.SS PING_CHECK_MGR_NEXT_ECHO_SCHEDULED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
for %1, scheduling ECHO_REQUEST %2 of %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که حداقل تعداد ECHO REQUESTها بیشتر از ۱ باشد و ECHO REQUEST بعدی برای نشانی اجاره داده‌شده زمان‌بندی شده باشد.
.SS PING_CHECK_MGR_RECEIVED_ECHO_REPLY
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from %1, id %2, sequence %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک پیام ECHO REPLY دریافت شده باشد. آرگومان گزارش، نشانی IP مبدأ، شناسه (id) و شماره توالی (sequence) پیام ECHO REPLY را مشخص می‌کند.
.SS PING_CHECK_MGR_RECEIVED_UNEXPECTED_ECHO_REPLY
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from %1, id %2, sequence %3 received after reply\-timeout expired
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک ECHO REPLY پس از منقضی شدن reply\-timeout دریافت شده باشد و دیگر مورد نیاز نباشد. این ممکن است یک ECHO REPLY سرگردان باشد یا نشان‌دهنده این باشد که مقدار reply\-timeout بیش از حد کوتاه است. آرگومان گزارش، نشانی IP مبدأ، شناسه (id) و شماره توالی پاسخ را مشخص می‌کند.
.SS PING_CHECK_MGR_RECEIVED_UNEXPECTED_UNREACHABLE_MSG
.INDENT 0.0
.INDENT 3.5
.sp
.EX
for %1, id %2, sequence %3 received after reply\-timeout expired
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک پیام UNREACHABLE پس از منقضی شدن reply\-timeout دریافت شده باشد و دیگر مورد نیاز نباشد. این ممکن است یک پیام سرگردان باشد یا نشان‌دهنده این باشد که مقدار reply\-timeout بیش از حد کوتاه است..SS PING_CHECK_MGR_RECEIVED_UNREACHABLE_MSG
.INDENT 0.0
.INDENT 3.5
.sp
.EX
for %1, id %2, sequence %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک پیام UNREACHABLE دریافت شده باشد.
آرگومان گزارش، جزئیات نشانی IP مقصد، شناسه (id) و شماره توالی برگرفته از
ECHO REQUEST تعبیه‌شده را مشخص می‌کند.
.SS PING_CHECK_MGR_REPLY_RECEIVED_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
an error occurred processing an ICMP reply message %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اشکال‌زدایی زمانی صادر می‌شود که هنگام پردازش یک پیام ورودی
ICMP خطایی رخ داده باشد. آرگومان گزارش، خطای رخ‌داده را شرح می‌دهد.
.SS PING_CHECK_MGR_REPLY_TIMEOUT_EXPIRED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
for %1, ECHO REQUEST %2 of %3, reply\-timeout %4
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که پیش از به پایان رسیدن مقدار مهلت زمانی پیکربندی‌شده،
یعنی \fIreply\-timeout\fP، هیچ پاسخی برای یک ECHO REQUEST دریافت نشود.
آرگومان‌های گزارش جزئیات را ارائه می‌دهند.
.SS PING_CHECK_MGR_SEND_COMPLETED_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
an error occurred in the send completion callback %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که پس از تکمیل یک نوشتن موفق در
سوکت PingChannel، خطای غیرمنتظره‌ای رخ داده باشد. آرگومان گزارش، خطای
مشخص را شرح می‌دهد.
.SS PING_CHECK_MGR_STARTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ping channel operations are running, number of threads %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام زمانی صادر می‌شود که کانال بررسی پینگ باز شده باشد
و آمادهٔ پردازش درخواست‌ها باشد. آرگومان گزارش شامل تعداد ریسه‌ها
در استخر ریسه‌های (thread pool) کانال است.
.SS PING_CHECK_MGR_STARTED_SINGLE_THREADED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
single\-threaded ping channel operations are running
.EE
.UNINDENT
.UNINDENT
.sp
این پیام زمانی صادر می‌شود که کانال بررسی پینگ باز شده باشد
و آمادهٔ پردازش درخواست‌ها در حالت تک‌ریسه‌ای (single\-threaded) باشد.
.SS PING_CHECK_MGR_START_PING_CHECK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
for %1, initiated by %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک بررسی پینگ برای یک نشانی
آغاز شده باشد. آرگومان‌های گزارش، جزئیات نشانی اجاره (lease address) برای
پینگ و پرس‌وجویی که بررسی را آغاز کرده است مشخص می‌کنند.
.SS PING_CHECK_MGR_STOPPED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
channel operations have stopped
.EE
.UNINDENT
.UNINDENT
.sp
این پیام زمانی صادر می‌شود که عملیات کانال بررسی پینگ
متوقف شده باشد.
.SS PING_CHECK_MGR_STOPPING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ping channel operations are stopping
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کانال بررسی پینگ در حال توقف عملیات باشد،
که معمولاً به دلیل یک رویداد پیکربندی یا خاموش شدن سرور رخ می‌دهد.
.SS PING_CHECK_MGR_SUBNET_CONFIG_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
user\-context for subnet id %1, contains invalid ping\-check %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که یک زیرشبکه (subnet) از طریق دستورات subnet به‌روزرسانی شده
و بخش \(aquser\-context\(aq آن شامل پیکربندی نامعتبر \(aqping\-check\(aq است.
سرور این خطا را یک بار ثبت کرده و سپس تا زمان اصلاح پیکربندی،
از پارامترهای سراسری ping\-check برای آن زیرشبکه استفاده خواهد کرد..SS PING_CHECK_NO_LEASE_OR_LEASE_REUSED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Ping check skipped: no lease
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که درخواست ping check ارسال‌شده توسط کارگزار، فاقد یک lease باشد. این حالت معمولاً زمانی رخ می‌دهد که یک lease مجدداً استفاده می‌شود. بررسی ping نادیده گرفته خواهد شد و پردازش offer طبق روال عادی ادامه می‌یابد.
.SS PING_CHECK_PAUSE_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Pausing ping channel operations failed %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که هنگام تلاش برای متوقف کردن موقت (pause) مخزن نخ‌های (thread pool) کانال ping، خطای غیرمنتظره‌ای رخ دهد. وقوع این خطا بسیار نامحتمل است و نشان‌دهنده یک مشکل برنامه‌نویسی است که باید به عنوان نقص (defect) گزارش شود.
.SS PING_CHECK_PAUSE_ILLEGAL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Pausing ping channel operations not allowed %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا هنگام تلاش برای متوقف کردن موقت (pause) مخزن نخ‌های (thread pool) کانال ping صادر می‌شود. این موضوع نشان می‌دهد که یک نخ کانال تلاش کرده است از یک بخش بحرانی (critical section) استفاده کند که منجر به بن‌بست (dead\-lock) می‌شد. وقوع این خطا بسیار نامحتمل است و نشان‌دهنده یک مشکل برنامه‌نویسی است که باید به عنوان یک نقص گزارش شود.
.SS PING_CHECK_PAUSE_PERMISSIONS_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Permissions check for ping\-channel pause failed %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که هنگام اعتبارسنجی تلاش برای متوقف کردن موقت (pause) مخزن نخ‌های (thread pool) کانال ping، خطای غیرمنتظره‌ای رخ دهد. وقوع این خطا بسیار نامحتمل است و نشان‌دهنده یک مشکل برنامه‌نویسی است که باید به عنوان یک نقص گزارش شود.
.SS PING_CHECK_RESUME_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Resuming ping channel operations failed %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که هنگام تلاش برای ازسرگیری عملیات مخزن نخ‌های (thread pool) کانال ping، خطای غیرمنتظره‌ای رخ دهد. وقوع این خطا بسیار نامحتمل است و نشان‌دهنده یک مشکل برنامه‌نویسی است که باید به عنوان یک نقص گزارش شود.
.SS PING_CHECK_UNEXPECTED_READ_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
could not start next socket read %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی رخ می‌دهد که آغاز یک خواندن ناهمگام (asynchronous read) روی سوکت ICMP به شکلی غیرمنتظره با شکست مواجه شود. جزئیات خطا به عنوان یک آرگومان در پیام لاگ ارائه می‌شود.
.SS PING_CHECK_UNEXPECTED_WRITE_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
could not start next socket write %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی رخ می‌دهد که آغاز یک نوشتن ناهمگام (asynchronous write) روی سوکت ICMP به شکلی غیرمنتظره با شکست مواجه شود. جزئیات خطا به عنوان یک آرگومان در پیام لاگ ارائه می‌شود.
.SS PING_CHECK_UNLOAD
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Ping Check hooks library has been unloaded
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی (info) نشان می‌دهد که کتابخانه قلاب‌های (hooks library) قابلیت Ping Check از حافظه تخلیه (unload) شده است.
.SS RADIUS
.SS RADIUS_ACCESS_BUILD_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
building Access\-Request failed: %1 for incoming message %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که هنگام ساخت یک Access\-Request خطایی رخ داده باشد..SS RADIUS_ACCESS_CACHE_GET
.INDENT 0.0
.INDENT 3.5
.sp
.EX
host %1 with attributes %2 was retrieved from the cache
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک میزبان از حافظهٔ نهان میزبان (host cache) بازیابی شود.
.SS RADIUS_ACCESS_CACHE_INSERT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
host %1 with attributes %2 was inserted into the cache
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که میزبان جدیدی در حافظهٔ نهان میزبان درج گردد.
.SS RADIUS_ACCESS_CONFLICT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
query %1 triggers a conflict for %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک پرس‌وجو (query) باعث ایجاد تداخل با یک درخواست دسترسی معلق برای همان شناسه شود.
.SS RADIUS_ACCESS_DROP_PARKED_QUERY
.INDENT 0.0
.INDENT 3.5
.sp
.EX
access request terminate callback decided to drop the parked query %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک درخواست دسترسی با تصمیم مبنی بر دور انداختن (drop) پرس‌وجوی متوقف‌شده (parked query) خاتمه یابد.
.SS RADIUS_ACCESS_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Access\-Request failed with %1 (%2)
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که هیچ پیام معتبر Access\-Accept یا Access\-Reject دریافت نشده باشد. کد بازگشتی و نام آن ثبت می‌شوند.
.SS RADIUS_ACCESS_GET_IDENTIFIER
.INDENT 0.0
.INDENT 3.5
.sp
.EX
identifier %1 of type %2 and User\-Name %3 were set from incoming message %4
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که شناسهٔ میزبان و مشخصهٔ User\-Name از یک پیام دریافتی مقداردهی شوند.
.SS RADIUS_ACCESS_GET_IDENTIFIER_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
no identifier of type %1 can be set from incoming message %2, reason: %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که ساخت شناسهٔ میزبان بر اساس پیام دریافتی امکان‌پذیر نبوده است.
.SS RADIUS_ACCESS_HOST_BACKEND_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Configuring access failed during host backend \(aq%1\(aq setup, reason: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که دسترسی/احراز هویت در پیکربندی فعال شده باشد، اما در راه‌اندازی backend میزبان مشکلی رخ دهد. نام backend میزبان و دلیل خطا ثبت می‌شوند.
.SS RADIUS_ACCESS_MAX_PENDING_REQUESTS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
query \(aq%1\(aq with identifier \(aq%2\(aq was dropped for too many pending access requests
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که تعداد درخواست‌های دسترسی معلق فراتر از حد مجاز پیکربندی‌شده باشد. پرس‌وجو و شناسهٔ آن نمایش داده می‌شوند.
.SS RADIUS_ACCESS_NO_HOST_CACHE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Configuring access failed: host cache library not loaded.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که دسترسی/احراز هویت در پیکربندی فعال باشد اما هیچ حافظهٔ نهان میزبانی (host cache) یافت نشود. قلاب Radius برای ذخیره (نهان‌سازی) پارامترهای دریافت‌شده از تبادل داده با سرور RADIUS، نیازمند بارگذاری قلاب Host Cache است..SS RADIUS_ACCESS_ORPHAN
.INDENT 0.0
.INDENT 3.5
.sp
.EX
orphan pending access request for %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که یک درخواست دسترسی (access request) بدون درخواست معلق متناظر برای شناسه پایان یابد.
.SS RADIUS_ACCESS_RESUME_PARKED_QUERY
.INDENT 0.0
.INDENT 3.5
.sp
.EX
access request terminate callback resumes processing of parked query %1 in %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی 40 ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که فراخوان بازگشتی پایان درخواست دسترسی (access request terminate callback)، پردازش یک پرس‌وجوی متوقف‌شده (parked query) را پس از نقطه فراخوانی انتخاب زیرشبکه (subnet select callout point) از سر می‌گیرد.
.SS RADIUS_ACCESS_SUBNET_RESELECT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
subnet was reselected from \(aqID %1\(aq to \(aqID %2\(aq
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی 40 ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که دسترسی/احراز هویت باعث انتخاب مجدد زیرشبکه شود. شناسه‌های اصلی و جدید زیرشبکه ثبت می‌شوند.
.SS RADIUS_ACCESS_TERMINATE_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
access request terminate callback got an error: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که یک درخواست دسترسی با یک خطای داخلی غیرمنتظره پایان یابد.
.SS RADIUS_ACCOUNTING_ASYNC
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Asynchronous send Accounting\-Request for NAS port %1 with %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی 40 ثبت می‌شود.
این پیام اشکال‌زدایی هنگام آغاز ارسال یک پیام Accounting\-Request به سرورهای حسابرسی صادر می‌شود. پورت NAS و مشخصه‌های پیام ثبت می‌شوند.
.SS RADIUS_ACCOUNTING_ASYNC_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Asynchronous Accounting\-Request failed: return code %1 (%2)
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی 40 ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که هیچ پیام معتبر Accounting\-Response دریافت نشده باشد.
.SS RADIUS_ACCOUNTING_ASYNC_SUCCEED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
received valid Accounting\-Response (asynchronously)
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی 40 ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که یک Accounting\-Response معتبر دریافت شده است.
.SS RADIUS_ACCOUNTING_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Accounting\-Request failed for %1 on event %2 (%3) failed with %4 (%5)
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که ارتباط حسابرسی ناموفق باشد.
شناسه نشست (session Id)، کد و نام رویداد، و همچنین کد بازگشتی و نام آن ثبت می‌شوند.
.SS RADIUS_ACCOUNTING_HISTORY_UPDATE_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to insert a record for %1 in the history container
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که درج یک رکورد در برچسب زمان ایجاد یا همان مخزن تاریخچه (history container) ممکن نباشد. این امر باید نشست را مختل کند، به این معنی که برای نمونه تطبیق پیام‌های وضعیت start و stop ممکن نخواهد بود.
.SS RADIUS_ACCOUNTING_NO_HISTORY
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to find the date the lease for %1 was created
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی 40 ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که آدرسی در برچسب زمان ایجاد یا همان مخزن تاریخچه (history container) یافت نشود. این امر منجر به ایجاد یک نشست حسابرسی بدون پیام وضعیت start می‌شود..SS RADIUS_ACCOUNTING_STATUS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
send Status\-Server with %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی صادر می‌شود که ارسال یک پیام Status\-Server به سرورهای accounting آغاز شود. ویژگی‌های پیام در گزارش ثبت می‌شوند.
.SS RADIUS_ACCOUNTING_STATUS_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
received error response to Status\-Server: %1 (%2) with %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که پاسخ معتبری برای پیام Status\-Server از سرورهای accounting دریافت شده، اما حاوی یک کد غیرمنتظره یا ویژگی Error\-Cause بوده است. جزئیات پاسخ در گزارش ثبت می‌شوند.
.SS RADIUS_ACCOUNTING_STATUS_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Status\-Server failed: return code %1 (%2)
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی صادر می‌شود که هیچ پاسخ معتبری برای پیام Status\-Server از سرورهای accounting دریافت نشده باشد.
.SS RADIUS_ACCOUNTING_STATUS_SUCCEED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
received valid response to Status\-Server
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که پاسخ معتبری برای پیام Status\-Server از سرورهای accounting دریافت شده است.
.SS RADIUS_ACCOUNTING_SYNC
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Synchronous send Accounting\-Request for NAS port %1 with %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی صادر می‌شود که ارسال یک پیام Accounting\-Request به سرورهای accounting آغاز گردد. پورت NAS و ویژگی‌های پیام در گزارش ثبت می‌شوند.
.SS RADIUS_ACCOUNTING_SYNC_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Synchronous Accounting\-Request failed: return code %1 (%2)
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی صادر می‌شود که هیچ پیام Accounting\-Response معتبری دریافت نشده باشد.
.SS RADIUS_ACCOUNTING_SYNC_SUCCEED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
received valid Accounting\-Response (synchronously)
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که یک Accounting\-Response معتبر دریافت شده است.
.SS RADIUS_AUTHENTICATION_ASYNC
.INDENT 0.0
.INDENT 3.5
.sp
.EX
send Access\-Request for NAS port %1 with %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی صادر می‌شود که ارسال یک پیام Access\-Request به سرورهای دسترسی (access servers) آغاز شود. پورت NAS و ویژگی‌های پیام در گزارش ثبت می‌شوند.
.SS RADIUS_AUTHENTICATION_ASYNC_ACCEPTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
received valid Access\-Accept with %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که یک پیام Access\-Accept معتبر دریافت شده است. ویژگی‌های پیام در گزارش ثبت می‌شوند.
.SS RADIUS_AUTHENTICATION_ASYNC_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Access\-Request failed: return code %1 (%2)
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگامی صادر می‌شود که هیچ پیام صحیح Access\-Accept یا Access\-Reject دریافت نشده باشد..SS RADIUS_AUTHENTICATION_ASYNC_REJECTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
received valid Access\-Reject with %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که یک پیام معتبر Access\-Reject دریافت شده است.
مشخصه‌های (attributes) پیام ثبت می‌شوند.
.SS RADIUS_AUTHENTICATION_STATUS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
send Status\-Server with %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگام شروع ارسال پیام Status\-Server به سرورهای دسترسی
صادر می‌شود. مشخصه‌های پیام ثبت می‌شوند.
.SS RADIUS_AUTHENTICATION_STATUS_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
received error response to Status\-Server: %1 (%2) with %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که یک پاسخ معتبر برای پیام Status\-Server از سرورهای دسترسی
دریافت شده است، اما حاوی یک کد غیرمنتظره یا مشخصهٔ Error\-Cause بوده است.
جزئیات پاسخ ثبت می‌شوند.
.SS RADIUS_AUTHENTICATION_STATUS_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Status\-Server failed: return code %1 (%2)
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که هیچ پاسخ معتبری برای پیام Status\-Server
از سرورهای دسترسی دریافت نشده باشد.
.SS RADIUS_AUTHENTICATION_STATUS_SUCCEED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
received valid response to Status\-Server
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که یک پاسخ معتبر برای پیام Status\-Server
از سرورهای دسترسی دریافت شده است.
.SS RADIUS_AUTHENTICATION_SYNC
.INDENT 0.0
.INDENT 3.5
.sp
.EX
send Access\-Request for NAS port %1 with %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگام شروع ارسال پیام Access\-Request به سرورهای دسترسی
صادر می‌شود. درگاه NAS و مشخصه‌های پیام ثبت می‌شوند.
.SS RADIUS_AUTHENTICATION_SYNC_ACCEPTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
received valid Access\-Accept with %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که یک پیام معتبر Access\-Accept دریافت شده است.
مشخصه‌های پیام ثبت می‌شوند.
.SS RADIUS_AUTHENTICATION_SYNC_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Access\-Request failed: return code %1 (%2)
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که هیچ پیام معتبر Access\-Accept یا
Access\-Reject دریافت نشده باشد.
.SS RADIUS_AUTHENTICATION_SYNC_REJECTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
received valid Access\-Reject with %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که یک پیام معتبر Access\-Reject دریافت شده است.
مشخصه‌های پیام ثبت می‌شوند.
.SS RADIUS_BACKEND_GET4
.INDENT 0.0
.INDENT 3.5
.sp
.EX
spurious lookup for IPv4 subnet %1 and id %2 of type %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که پس‌دانه (backend) میزبان radius به‌طور
غیرمنتظره برای جستجوی یک مدخل IPv4 فراخوانی شود. جزئیات این جستجو ثبت می‌شوند..SS RADIUS_BACKEND_GET6
.INDENT 0.0
.INDENT 3.5
.sp
.EX
spurious lookup for IPv6 subnet %1 and id %2 of type %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح ثبت اشکال‌زدایی (debug) ۴۰ گزارش می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که backend میزبان radius به‌طور غیرمنتظره برای جستجوی یک مدخل IPv6 فراخوانی شود. جزئیات این جستجو ثبت می‌شود.
.SS RADIUS_CLEANUP_EXCEPTION
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Exception on RADIUS cleanup: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که هنگام تخریب یک شیء در کتابخانهٔ قلاب (hook) RADIUS، یک استثنا (exception) رخ دهد. برای جلوگیری از پنهان ماندن استثنایی دیگر، اجازه داده نمی‌شود که انتشار این استثنا ادامه یابد، بنابراین ثبت می‌شود. این پیام عموماً به معنای یک خطای برنامه‌نویسی است و باید به ISC گزارش شود، اما ممکن است بی‌خطر نیز باشد. آرگومان، پیام خطای دقیق را ارائه می‌دهد.
.SS RADIUS_CONFIGURATION_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to configure Radius hooks library: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که در پیکربندی کتابخانهٔ قلاب‌های Radius خطایی رخ دهد. آرگومان، پیام خطای دقیق را ارائه می‌دهد.
.SS RADIUS_DECODE_MESSAGE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Decoded message \(aq%1\(aq (%2) id %3 length %4 with %5 attributes.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح ثبت اشکال‌زدایی (debug) ۴۰ گزارش می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که پیامی رمزگشایی شود. نام نوع پیام و مقدار آن، شناسه، طول و تعداد مشخصه‌ها (attributes) نمایش داده می‌شوند.
.SS RADIUS_DEINIT_OK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
unloading Radius hooks library successful
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که کتابخانهٔ قلاب‌های Radius با موفقیت تخلیه (unload) شده است.
.SS RADIUS_ENCODE_MESSAGE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Encoded message \(aq%1\(aq (%2) id %3 length %4 with %5 attributes.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح ثبت اشکال‌زدایی (debug) ۴۰ گزارش می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک پیام کدگذاری (encode) شود. نام نوع پیام و مقدار آن، شناسه، طول و تعداد مشخصه‌ها (attributes) نمایش داده می‌شوند.
.SS RADIUS_EXCHANGE_RECEIVED_ACCESS_ACCEPT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Exchange %1 received an Access\-Accept.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح ثبت اشکال‌زدایی (debug) ۴۰ گزارش می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک تبادل (exchange) یک پاسخ Access\-Accept دریافت کند. شناسهٔ تبادل نمایش داده می‌شود.
.SS RADIUS_EXCHANGE_RECEIVED_ACCESS_REJECT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Exchange %1 received an Access\-Reject.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح ثبت اشکال‌زدایی (debug) ۴۰ گزارش می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک تبادل یک پاسخ Access\-Reject دریافت کند. شناسهٔ تبادل نمایش داده می‌شود.
.SS RADIUS_EXCHANGE_RECEIVED_ACCOUNTING_RESPONSE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Exchange %1 received an Accounting\-Response.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح ثبت اشکال‌زدایی (debug) ۴۰ گزارش می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک تبادل یک پاسخ Accounting\-Response دریافت کند. شناسهٔ تبادل نمایش داده می‌شود.
.SS RADIUS_EXCHANGE_RECEIVED_BAD_RESPONSE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Exchange %1 received a bad response: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که یک تبادل پاسخی نادرست دریافت کند. شناسهٔ تبادل و پیام خطا نمایش داده می‌شوند..SS RADIUS_EXCHANGE_RECEIVED_MISMATCH
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Exchange %1: received response with identifier %2 when %3 was expected.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که درخواست ارسال‌شده و پاسخ دریافت‌شده
دارای شناسه‌های متفاوتی باشند. شناسه مبادله و شناسه‌های هر دو پیام RADIUS
نمایش داده می‌شوند.
.SS RADIUS_EXCHANGE_RECEIVED_RESPONSE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Exchange %1 received response: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) 40 ثبت می‌شود.
این پیام اشکال‌زدایی در پایان روال دریافت صادر می‌شود.
شناسه مبادله و کد خطا نمایش داده می‌شوند.
.SS RADIUS_EXCHANGE_RECEIVED_UNEXPECTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Exchange %1: sent %2, received unexpected %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که درخواست ارسال‌شده و پاسخ دریافت‌شده
مطابقت نداشته باشند. شناسه مبادله و کدهای هر دو پیام RADIUS نمایش
داده می‌شوند.
.SS RADIUS_HOOK_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
processing for hook %1 failed: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که پردازش در یک نقطه قلاب (hook point) استاندارد با شکست مواجه شود.
علت شکست نمایش داده می‌شود.
.SS RADIUS_INIT_OK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
loading Radius hooks library successful
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی نشان می‌دهد که کتابخانه قلاب‌های Radius با
موفقیت بارگذاری شده است. لذت ببرید!
.SS RADIUS_INTEGER_ATTRIBUTE_FROM_BYTES_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Creating an integer attribute %1 \(aq%2\(aq failed: %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که یک صفت عدد صحیح نتواند
ایجاد شود. نوع صفت، نام و پیام خطا نمایش داده می‌شوند.
.SS RADIUS_INTEGER_ATTRIBUTE_FROM_TEXT_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Creating an integer attribute %1 \(aq%2\(aq from %3 failed.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که یک صفت عدد صحیح نتواند
ایجاد شود. نوع صفت، نام و مقدار نامعتبر ارائه‌شده نمایش داده می‌شوند.
.SS RADIUS_IPADDR_ATTRIBUTE_FROM_BYTES_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Creating an IP address attribute %1 \(aq%2\(aq failed: %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که یک صفت نشانی IP نتواند
ایجاد شود. نوع صفت، نام و پیام خطا نمایش داده می‌شوند.
.SS RADIUS_IPADDR_ATTRIBUTE_FROM_TEXT_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Creating an IP address attribute %1 \(aq%2\(aq from %3 failed.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که یک صفت نشانی IP نتواند
ایجاد شود. نوع صفت، نام و مقدار نامعتبر ارائه‌شده نمایش داده می‌شوند.
.SS RADIUS_IPV6ADDR_ATTRIBUTE_FROM_BYTES_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Creating an IPv6 address attribute %1 \(aq%2\(aq failed: %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که یک صفت نشانی IPv6 نتواند
ایجاد شود. نوع صفت، نام و پیام خطا نمایش داده می‌شوند..SS RADIUS_IPV6ADDR_ATTRIBUTE_FROM_TEXT_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Creating an IPv6 address attribute %1 \(aq%2\(aq from %3 failed.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که صفت آدرس IPv6 نتواند ایجاد شود.
نوع صفت، نام و مقدار نامعتبر ارسال‌شده نمایش داده می‌شوند.
.SS RADIUS_IPV6PREFIX_ATTRIBUTE_FROM_BYTES_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Creating an IPv6 prefix attribute %1 \(aq%2\(aq failed: %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که صفت پیشوند IPv6 نتواند ایجاد شود.
نوع صفت، نام و پیام خطا نمایش داده می‌شوند.
.SS RADIUS_IPV6PREFIX_ATTRIBUTE_FROM_TEXT_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Creating an IPv6 prefix attribute %1 \(aq%2\(aq from %3 failed.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که صفت پیشوند IPv6 نتواند ایجاد شود.
نوع صفت، نام و مقدار نامعتبر ارسال‌شده نمایش داده می‌شوند.
.SS RADIUS_PAUSE_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Pausing the RADIUS thread pool failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که در حین اعتبارسنجی تلاش برای متوقف کردن موقت
thread pool خطایی غیرمنتظره رخ دهد. وقوع این خطا بسیار نامحتمل است و نشان‌دهنده
یک مشکل برنامه‌نویسی است که باید به عنوان نقص گزارش شود.
.SS RADIUS_PAUSE_ILLEGAL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Pausing the RADIUS thread pool not allowed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا هنگام تلاش برای متوقف کردن موقت thread pool صادر می‌شود.
این موضوع نشان می‌دهد که یک ریسه تلاش کرده است از یک بخش بحرانی (critical section)
استفاده کند که منجر به بن‌بست (deadlock) می‌شد. وقوع این خطا بسیار نامحتمل است
و نشان‌دهنده یک مشکل برنامه‌نویسی است که باید به عنوان نقص گزارش شود.
.SS RADIUS_PAUSE_PERMISSIONS_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Checking for permissions to pause the RADIUS thread pool failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که در حین اعتبارسنجی تلاش برای متوقف کردن موقت
thread pool خطایی غیرمنتظره رخ دهد. وقوع این خطا بسیار نامحتمل است و نشان‌دهنده
یک مشکل برنامه‌نویسی است که باید به عنوان نقص گزارش شود.
.SS RADIUS_REPLY_MESSAGE_ATTRIBUTE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Message %1 on exchange %2 has a Reply\-Message attribute with value \(aq%3\(aq.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی زمانی صادر می‌شود که یک صفت Reply\-Message در پیامی دریافت شده
از سرور RADIUS یافت شود. به ازای هر صفت یک پیام لاگ چاپ می‌شود. یک پیام لاگ
می‌تواند شامل چندین صفت باشد، بنابراین ممکن است به ازای هر پیام RADIUS چندین پیام
لاگ ثبت شود. این پیام شناسه پیام، شناسه تبادل (exchange) و مقدار صفت Reply\-Message
را نمایش می‌دهد.
.SS RADIUS_RESUME_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Resuming the RADIUS thread pool failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که هنگام تلاش برای ازسرگیری فعالیت thread pool
خطایی غیرمنتظره رخ دهد. وقوع این خطا بسیار نامحتمل است و نشان‌دهنده یک مشکل
برنامه‌نویسی است که باید به عنوان نقص گزارش شود.
.SS RADIUS_SERVER_CONFIGURED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
configured an %1 server: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی زمانی صادر می‌شود که یک سرور RADIUS پیکربندی شود.
نوع سرور (access یا accounting) و جزئیات پیکربندی، در حالی که عبارت محرمانه
(secret) با ستاره جایگزین شده است، ثبت می‌شوند.
.SS RADIUS_SESSION_HISTORY_APPEND_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
appending of a new record for %1 to the session history file failed: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که الحاق یک رکورد جدید به فایل تاریخچه نشست
(session history file) با شکست مواجه شود. آدرس رکورد جدید و علت شکست
نمایش داده می‌شوند..SS RADIUS_SESSION_HISTORY_LOADED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
loading of the session history file succeeded: read %1 records including %2 active records
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی زمانی صادر می‌شود که بارگذاری فایل تاریخچه نشست با موفقیت به پایان برسد. تعداد رکوردهای بارگذاری‌شده و فعال نمایش داده می‌شود.
.SS RADIUS_SESSION_HISTORY_LOAD_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
loading of the session history file
.EE
.UNINDENT
.UNINDENT
.sp
با شکست مواجه شد: %1 رکورد بارگذاری‌شده، %2 نادیده‌گرفته‌شده و %3 رکورد فعال.
این پیام خطا زمانی صادر می‌شود که بارگذاری فایل تاریخچه نشست با موفقیت به پایان نرسد. تعداد رکوردهای بارگذاری‌شده، نادیده‌گرفته‌شده و فعال نمایش داده می‌شوند.
.SS RADIUS_SESSION_HISTORY_OPENED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
opening of the session history file %1 succeeded
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی زمانی صادر می‌شود که باز کردن فایل CSV تأمین‌کننده پایداری تاریخچه نشست با موفقیت انجام شود. نام فایل نمایش داده می‌شود.
.SS RADIUS_SESSION_HISTORY_OPEN_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
opening of the session history file %1 failed: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که باز کردن فایل CSV تأمین‌کننده پایداری تاریخچه نشست با شکست مواجه شود. نام فایل و دلیل شکست نمایش داده می‌شوند.
.SS RADIUS_SESSION_HISTORY_STORED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Storing to the session history file succeeded: stored %1 records
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی زمانی صادر می‌شود که نوشتن در یک فایل جدید تاریخچه نشست با موفقیت تکمیل شده باشد. تعداد رکوردهای ذخیره‌شده نمایش داده می‌شود.
.SS RADIUS_SESSION_HISTORY_STORE_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Writing to the session history file %1 failed: %2 (stored %3 over %4 records)
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که نوشتن در یک فایل جدید تاریخچه نشست با شکست مواجه شود. نام فایل، دلیل شکست، تعداد رکوردهای ذخیره‌شده پیش از وقوع شکست و تعداد رکوردهای مورد انتظار نمایش داده می‌شوند.
.SS RADIUS_TCP_EXCHANGE_FAILURE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
TCP exchange %1 failed: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که یک تبادل TCP با خطا پایان یابد. شناسه تبادل و کد خطای بازگشتی نمایش داده می‌شوند.
.SS RADIUS_TCP_EXCHANGE_RECEIVED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
TCP exchange %1 received %2 bytes.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 40 ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک تبادل TCP پاسخی دریافت کرده باشد. شناسه تبادل و اندازه پاسخ نمایش داده می‌شوند.
.SS RADIUS_TCP_EXCHANGE_RECEIVE_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Receive for TCP exchange %1 failed: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که یک تبادل TCP در دریافت پیام با شکست مواجه شود. شناسه تبادل و پیام خطا نمایش داده می‌شوند.
.SS RADIUS_TCP_EXCHANGE_SEND
.INDENT 0.0
.INDENT 3.5
.sp
.EX
TCP exchange %1 sends %2 bytes to server %3 on port %4%5
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 40 ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک تبادل TCP پیامی را به یک سرور ارسال کند. شناسه تبادل، اندازه پیام، آدرس و پورت سرور و استفاده از TLS نمایش داده می‌شوند..SS RADIUS_TCP_EXCHANGE_START
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Start TCP exchange %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک تبادل TCP آغاز شود. شناسه
تبادل نمایش داده می‌شود.
.SS RADIUS_TCP_EXCHANGE_START_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
TCP exchange %1 failed: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که آغاز یک تبادل TCP ناموفق باشد.
شناسه تبادل و پیام خطا نمایش داده می‌شوند.
.SS RADIUS_TCP_EXCHANGE_SUCCESS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
TCP exchange %1 succeeded: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک تبادل TCP با موفقیت پایان یابد.
شناسه تبادل و کد بازگشتی نمایش داده می‌شوند.
.SS RADIUS_THREAD_POOL_STARTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
RADIUS thread pool started with %1 threads.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی زمانی صادر می‌شود که استخر ریسه‌ها (thread pool) راه‌اندازی شود.
تعداد ریسه‌ها نمایش داده می‌شود.
.SS RADIUS_TLS_STATUS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
send Status\-Server with %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگام آغاز ارسال یک پیام Status\-Server به سرورهای TLS صادر می‌شود.
مشخصه‌های (attributes) پیام ثبت می‌شوند.
.SS RADIUS_TLS_STATUS_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
received error response to Status\-Server: %1 (%2) with %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا بیانگر آن است که یک پاسخ معتبر برای پیام Status\-Server از سرورهای TLS
دریافت شده، اما دارای یک کد غیرمنتظره یا مشخصه Error\-Cause بوده است.
جزئیات پاسخ ثبت می‌شوند.
.SS RADIUS_TLS_STATUS_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Status\-Server failed: return code %1 (%2)
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که هیچ پاسخ معتبری برای پیام Status\-Server
از سرورهای TLS دریافت نشده باشد.
.SS RADIUS_TLS_STATUS_SUCCEED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
received valid response to Status\-Server
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که یک پاسخ معتبر برای پیام Status\-Server
از سرورهای TLS دریافت شده است.
.SS RADIUS_UDP_EXCHANGE_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
UDP exchange %1 failed: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که یک تبادل UDP با خطا پایان یابد.
شناسه تبادل و کد بازگشتی خطا نمایش داده می‌شوند.
.SS RADIUS_UDP_EXCHANGE_OPEN_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Open socket for UDP exchange %1 failed: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که یک تبادل UDP در باز کردن سوکت جدید با شکست مواجه شود.
شناسه تبادل و پیام خطا نمایش داده می‌شوند..SS RADIUS_UDP_EXCHANGE_RECEIVED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
UDP exchange %1 received %2 bytes.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک تبادل UDP پاسخی دریافت کرده باشد.
شناسه تبادل و اندازه پاسخ نمایش داده می‌شوند.
.SS RADIUS_UDP_EXCHANGE_RECEIVE_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Receive for UDP exchange %1 failed: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که یک تبادل UDP در دریافت پیام با شکست مواجه شود.
شناسه تبادل و پیام خطا نمایش داده می‌شوند.
.SS RADIUS_UDP_EXCHANGE_SEND_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Send for UDP exchange %1 failed: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که یک تبادل UDP در ارسال پیام با شکست مواجه شود.
شناسه تبادل و پیام خطا نمایش داده می‌شوند.
.SS RADIUS_UDP_EXCHANGE_SEND_NEW
.INDENT 0.0
.INDENT 3.5
.sp
.EX
UDP exchange %1 sends %2 bytes to new server[%3] %4 on port %5
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک تبادل UDP پیامی را به یک
سرور جدید ارسال می‌کند. شناسه تبادل، اندازه پیام، شاخص سرور،
نشانی و پورت نمایش داده می‌شوند.
.SS RADIUS_UDP_EXCHANGE_SEND_RETRY
.INDENT 0.0
.INDENT 3.5
.sp
.EX
UDP exchange %1 sends %2 bytes for the %3 try.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک تبادل UDP پیامی را به یک
سرور جدید ارسال می‌کند. شناسه تبادل، اندازه پیام و شمارنده تلاش مجدد
نمایش داده می‌شوند.
.SS RADIUS_UDP_EXCHANGE_SENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
UDP exchange %1 sent %2 bytes.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک تبادل UDP درخواستی را ارسال کرده و آماده
دریافت پاسخ باشد. شناسه تبادل و اندازه درخواست
نمایش داده می‌شوند.
.SS RADIUS_UDP_EXCHANGE_START
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Start UDP exchange %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک تبادل UDP آغاز گردد. شناسه
تبادل نمایش داده می‌شود.
.SS RADIUS_UDP_EXCHANGE_SYNC_RETURN
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Synchronous UDP exchange %1 returns with %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک تبادل UDP همگام (synchronous) بازگردد.
شناسه تبادل و کد خطا/بازگشت نمایش داده می‌شوند.
.SS RADIUS_UDP_EXCHANGE_TERMINATE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
UDP exchange %1 terminates with %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک تبادل UDP با موفقیت خاتمه یابد.
شناسه تبادل و کد بازگشت نمایش داده می‌شوند.
.SS RADIUS_UDP_EXCHANGE_TIMEOUT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
UDP exchange %1 timeout
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که یک تبادل UDP به دلیل اتمام مهلت زمانی (timeout) با شکست مواجه شود.
شناسه تبادل نمایش داده می‌شود..SS RBAC
.SS RBAC_CONFIGURED_ACLS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
RBAC hooks library has configured %1 named ACLs.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح ۴۰ گزارش اشکال‌زدایی (debug) ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که تعدادی فهرست کنترل دسترسی (ACL) نام‌گذاری‌شده
پیکربندی شده‌اند. تعداد آن‌ها نمایش داده می‌شود.
.SS RBAC_CONFIGURED_COMMANDS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
RBAC hooks library has configured %1 extra commands.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح ۴۰ گزارش اشکال‌زدایی (debug) ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که تعدادی دستور اضافی پیکربندی شده‌اند.
تعداد آن‌ها نمایش داده می‌شود.
.SS RBAC_CONFIGURED_ROLES
.INDENT 0.0
.INDENT 3.5
.sp
.EX
hooks library has configured %1 roles.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح ۴۰ گزارش اشکال‌زدایی (debug) ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که تعدادی نقش (role) پیکربندی شده‌اند.
تعداد آن‌ها نمایش داده می‌شود.
.SS RBAC_HTTP_AUTH_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Error in http_auth callout: %1.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که در نقطه فراخوانی (callout) http_auth توسط
کتابخانه هوک‌های RBAC خطایی رخ داده است. آرگومان جزئیات خطا را مشخص می‌کند.
.SS RBAC_HTTP_AUTH_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
RBAC processing in http_auth callout failed for unexpected condition: %1.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی نشان می‌دهد که کتابخانه هوک‌های RBAC در نقطه callout مربوط به
http_auth با یک وضعیت غیرمنتظره مواجه شده است. علت شکست به طور خلاصه
بیان شده و جزئیات آن در گزارش اشکال‌زدایی در دسترس است.
.SS RBAC_HTTP_AUTH_REJECT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Role configuration \(aq%1\(aq for role \(aq%2\(aq has rejected command \(aq%3\(aq.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی نشان می‌دهد که دستور در callout مربوط به http_auth
رد شده است. نام پیکربندی نقش، نام نقش و دستور نمایش داده می‌شوند.
.SS RBAC_HTTP_AUTH_RESPONSE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
RBAC hooks library has returned response: %1.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی نشان می‌دهد که کتابخانه هوک‌های RBAC پاسخی در callout مربوط
به http_auth بازگردانده است. پاسخ به صورت خلاصه بیان می‌شود.
.SS RBAC_HTTP_RESPONSE_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
RBAC processing in http_response callout failed for unexpected condition: %1.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی نشان می‌دهد که کتابخانه هوک‌های RBAC در نقطه callout مربوط به
http_response با یک وضعیت غیرمنتظره مواجه شده است. علت شکست به طور خلاصه
بیان شده و جزئیات آن در گزارش اشکال‌زدایی در دسترس است.
.SS RBAC_LOAD_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
RBAC hooks library failed to load: %1.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که هنگام بارگذاری کتابخانه هوک‌های RBAC خطایی
رخ داده است. آرگومان جزئیات خطا را شرح می‌دهد.
.SS RBAC_LOAD_OK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
RBAC hooks library loaded successfully.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی نشان می‌دهد که کتابخانه هوک‌های RBAC با موفقیت
بارگذاری شده است..SS RBAC_READ_API_FILES
.INDENT 0.0
.INDENT 3.5
.sp
.EX
RBAC hooks library read API files from \(aq%1\(aq getting %2 commands, %3 access types and %4 hooks.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که کتابخانه RBAC hooks فایل‌های API را از دایرکتوری پیکربندی‌شده خوانده است. نام دایرکتوری و برخی آمارها نمایش داده می‌شوند.
.SS RBAC_TRACE_HTTP_AUTH_ACCEPT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Role configuration \(aq%1\(aq for role \(aq%2\(aq has accepted command \(aq%3\(aq.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
دستور در کال‌اوت http_auth پذیرفته شده است. نام پیکربندی نقش، نام نقش و دستور نمایش داده می‌شوند.
.SS RBAC_TRACE_HTTP_AUTH_BAD_BODY_TYPE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Bad body type in JSON request in http_auth callout.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
کال‌اوت http_auth با نوع بدنه (body type) نادرست در درخواست JSON فراخوانی شده است. کتابخانه RBAC hooks بلافاصله بازمی‌گردد. این وضعیت یک خطا است.
.SS RBAC_TRACE_HTTP_AUTH_BAD_COMMAND_TYPE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Bad command type in JSON request in http_auth callout.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
کال‌اوت http_auth با نوع دستور (command type) نادرست در درخواست JSON فراخوانی شده است. کتابخانه RBAC hooks بلافاصله بازمی‌گردد. این وضعیت یک خطا است.
.SS RBAC_TRACE_HTTP_AUTH_COMMAND
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Command \(aq%1\(aq in http_auth callout.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
کال‌اوت http_auth با دستور نمایش‌داده‌شده فراخوانی شده است.
.SS RBAC_TRACE_HTTP_AUTH_DISABLED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
RBAC hooks library is disabled in http_auth callout.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
کال‌اوت http_auth در شرایطی فراخوانی شده است که کتابخانه RBAC hooks غیرفعال است؛ یعنی هیچ نقشی اختصاص نیافته است.
.SS RBAC_TRACE_HTTP_AUTH_EMPTY_BODY
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Empty body in JSON request in http_auth callout.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
کال‌اوت http_auth با بدنه خالی در درخواست JSON فراخوانی شده است. کتابخانه RBAC hooks بلافاصله بازمی‌گردد. این وضعیت یک خطا است.
.SS RBAC_TRACE_HTTP_AUTH_NO_COMMAND
.INDENT 0.0
.INDENT 3.5
.sp
.EX
No command entry in JSON request in http_auth callout.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
کال‌اوت http_auth بدون مدخل دستور در درخواست JSON فراخوانی شده است. کتابخانه RBAC hooks بلافاصله بازمی‌گردد. این وضعیت یک خطا است.
.SS RBAC_TRACE_HTTP_AUTH_NO_JSON
.INDENT 0.0
.INDENT 3.5
.sp
.EX
No JSON request in http_auth callout.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
کال‌اوت http_auth با درخواستی غیر از JSON فراخوانی شده است. کتابخانه RBAC hooks بلافاصله بازمی‌گردد. این وضعیت یک خطا است.
.SS RBAC_TRACE_HTTP_AUTH_NO_REQUEST
.INDENT 0.0
.INDENT 3.5
.sp
.EX
No request in http_auth callout.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
کال‌اوت http_auth بدون هیچ درخواستی فراخوانی شده است. کتابخانه RBAC hooks بلافاصله بازمی‌گردد. این وضعیت یک خطا است..SS RBAC_TRACE_HTTP_AUTH_NO_TLS_REJECT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
درخواست غیر TLS رد شده است.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ دیباگ ۴۰ ثبت می‌شود.
درخواست غیر TLS در فراخوانی http_auth رد شده است.
.SS RBAC_TRACE_HTTP_AUTH_RESPONSE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
پاسخ در فراخوانی http_auth: %1.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ دیباگ ۴۰ ثبت می‌شود.
فراخوانی http_auth همراه با یک پاسخ فراخوانی شده است. کتابخانه قلاب‌های RBAC
بلافاصله بازمی‌گردد. پاسخ خلاصه شده است.
.SS RBAC_TRACE_HTTP_AUTH_ROLE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
نقش \(aq%1\(aq در فراخوانی http_auth تخصیص داده شد.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ دیباگ ۴۰ ثبت می‌شود.
نقش نمایش‌داده‌شده در فراخوانی http_auth تخصیص داده شده است.
.SS RBAC_TRACE_HTTP_RESPONSE_BAD_BODY_TYPE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
نوع بدنه نادرست در پاسخ JSON در فراخوانی http_response.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ دیباگ ۴۰ ثبت می‌شود.
فراخوانی http_response با یک نوع بدنه نادرست در پاسخ JSON فراخوانی شده است
که احتمالاً یک پاسخ خطا است. کتابخانه قلاب‌های RBAC
بلافاصله بازمی‌گردد.
.SS RBAC_TRACE_HTTP_RESPONSE_CONTEXT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
دستور \(aq%1\(aq و پیکربندی نقش \(aq%2\(aq در فراخوانی http_response بازیابی شد.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ دیباگ ۴۰ ثبت می‌شود.
دستور و پیکربندی نقش از زمینه درخواست بازیابی شده‌اند.
آن‌ها نمایش داده می‌شوند.
.SS RBAC_TRACE_HTTP_RESPONSE_DISABLED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
کتابخانه قلاب‌های RBAC در فراخوانی http_response غیرفعال است.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ دیباگ ۴۰ ثبت می‌شود.
فراخوانی http_response با غیرفعال بودن کتابخانه قلاب‌های RBAC،
یعنی بدون تخصیص هیچ نقشی، فراخوانی شده است.
.SS RBAC_TRACE_HTTP_RESPONSE_EMPTY_BODY
.INDENT 0.0
.INDENT 3.5
.sp
.EX
بدنه خالی در پاسخ JSON در فراخوانی http_response.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ دیباگ ۴۰ ثبت می‌شود.
فراخوانی http_response با یک بدنه خالی در پاسخ JSON فراخوانی شده است.
کتابخانه قلاب‌های RBAC بلافاصله بازمی‌گردد. این یک
وضعیت خطا است.
.SS RBAC_TRACE_HTTP_RESPONSE_EMPTY_BODY_LIST
.INDENT 0.0
.INDENT 3.5
.sp
.EX
فهرست خالی در پاسخ JSON در فراخوانی http_response.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ دیباگ ۴۰ ثبت می‌شود.
فراخوانی http_response با یک فهرست بدنه خالی در پاسخ JSON فراخوانی
شده است. کتابخانه قلاب‌های RBAC بلافاصله بازمی‌گردد. این یک وضعیت
خطا است.
.SS RBAC_TRACE_HTTP_RESPONSE_MODIFIED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
پاسخ توسط یک فیلتر پاسخ در فراخوانی http_response تغییر یافته است.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ دیباگ ۴۰ ثبت می‌شود.
یک فیلتر پاسخ، پاسخ HTTP را در فراخوانی http_response تغییر داده است.
.SS RBAC_TRACE_HTTP_RESPONSE_NO_ARGUMENTS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
هیچ درخواست یا پاسخی در فراخوانی http_response وجود ندارد.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ دیباگ ۴۰ ثبت می‌شود.
فراخوانی http_response بدون درخواست یا پاسخ فراخوانی شده است. کتابخانه
قلاب‌های RBAC بلافاصله بازمی‌گردد. این یک وضعیت خطا است..SS RBAC_UNLOAD_OK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
RBAC hooks library unloaded successfully.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی نشان می‌دهد که کتابخانه قلاب‌های (hooks) RBAC با موفقیت تخلیه (unload) شده است.
.SS RUN
.SS RUN_SCRIPT_LOAD
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Run Script hooks library has been loaded
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی نشان می‌دهد که کتابخانه قلاب‌های Run Script بارگذاری شده است.
.SS RUN_SCRIPT_LOAD_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Run Script hooks library failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهنده بروز خطا هنگام بارگذاری کتابخانه قلاب‌های Run Script است. جزئیات خطا به عنوان آرگومان پیام گزارش ارائه شده است.
.SS RUN_SCRIPT_UNLOAD
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Run Script hooks library has been unloaded
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی نشان می‌دهد که کتابخانه قلاب‌های RunScript تخلیه شده است.
.SS SFLQ
.SS SFLQ_POOL4_DEL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
sflq\-pool4\-del command succeeded, (parameters: %1) pools deleted: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug log level) ۲۰ ثبت می‌شود.
دستور sflq\-pool4\-del با موفقیت اجرا شد. این دستور، آرگومان‌های فراخوانی را به همراه تعداد استخرهای (pools) حذف‌شده نمایش می‌دهد.
.SS SFLQ_POOL4_DEL_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
sflq\-pool4\-del command failed, (parameters: %1, reason: %2)
.EE
.UNINDENT
.UNINDENT
.sp
دستور sflq\-pool4\-del با شکست مواجه شد. هم علت خطا و هم پارامترهای ارسال‌شده در گزارش ثبت می‌شوند.
.SS SFLQ_POOL4_GET_ALL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
sflq\-pool4\-get\-all command succeeded, pools found: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug log level) ۲۰ ثبت می‌شود.
دستور sflq\-pool4\-get\-all با موفقیت اجرا شد.
.SS SFLQ_POOL4_GET_ALL_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
sflq\-pool4\-get\-all command failed, (parameters: %1, reason: %2)
.EE
.UNINDENT
.UNINDENT
.sp
دستور sflq\-pool4\-get\-all با شکست مواجه شد. هم علت خطا و هم پارامترهای ارسال‌شده در گزارش ثبت می‌شوند.
.SS SFLQ_POOL4_GET_BY_RANGE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
sflq\-pool4\-get\-by\-range command succeeded, (parameters: %1) pools found: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug log level) ۲۰ ثبت می‌شود.
دستور sflq\-pool4\-get\-by\-range با موفقیت اجرا شد.
.SS SFLQ_POOL4_GET_BY_RANGE_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
sflq\-pool4\-get\-by\-range command failed, (parameters: %1, reason: %2)
.EE
.UNINDENT
.UNINDENT
.sp
دستور sflq\-pool4\-get\-range با شکست مواجه شد. هم علت خطا و هم پارامترهای ارسال‌شده در گزارش ثبت می‌شوند..SS SFLQ_POOL4_GET_BY_SUBNET
.INDENT 0.0
.INDENT 3.5
.sp
.EX
sflq\-pool4\-get\-by\-subnet command succeeded, (parameters: %1) pools found: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۲۰ ثبت می‌شود.
دستور sflq\-pool4\-get\-by\-subnet موفقیت‌آمیز بود.
.SS SFLQ_POOL4_GET_BY_SUBNET_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
sflq\-pool4\-get\-by\-subnet command failed, (parameters: %1, reason: %2)
.EE
.UNINDENT
.UNINDENT
.sp
دستور sflq\-pool4\-get\-subnet با شکست مواجه شد. هم دلیل شکست و هم پارامترهای
ارسال‌شده در لاگ ثبت می‌شوند.
.SS SFLQ_POOL4_REBUILD
.INDENT 0.0
.INDENT 3.5
.sp
.EX
sflq\-pool4\-rebuild command succeeded, (parameters: %1) pools rebuilt: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۲۰ ثبت می‌شود.
دستور sflq\-pool4\-rebuild موفقیت‌آمیز بود. این پیام آرگومان‌های دستور
را به همراه تعداد استخرهای بازسازی‌شده چاپ می‌کند.
.SS SFLQ_POOL4_REBUILD_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
sflq\-pool4\-rebuild command failed, (parameters: %1, reason: %2)
.EE
.UNINDENT
.UNINDENT
.sp
دستور sflq\-pool4\-rebuild با شکست مواجه شد. هم دلیل شکست و هم پارامترهای
ارسال‌شده در لاگ ثبت می‌شوند.
.SS SFLQ_POOL6_DEL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
sflq\-pool4\-del command succeeded, (parameters: %1) pools deleted: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۲۰ ثبت می‌شود.
دستور sflq\-pool6\-del موفقیت‌آمیز بود. این پیام آرگومان‌های دستور
را به همراه تعداد استخرهای حذف‌شده چاپ می‌کند.
.SS SFLQ_POOL6_DEL_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
sflq\-pool4\-del command failed, (parameters: %1, reason: %2)
.EE
.UNINDENT
.UNINDENT
.sp
دستور sflq\-pool6\-del با شکست مواجه شد. هم دلیل شکست و هم پارامترهای
ارسال‌شده در لاگ ثبت می‌شوند.
.SS SFLQ_POOL6_GET_ALL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
sflq\-pool6\-get\-all command succeeded, pools found: %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۲۰ ثبت می‌شود.
دستور sflq\-pool6\-rebuild موفقیت‌آمیز بود.
.SS SFLQ_POOL6_GET_ALL_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
sflq\-pool6\-get\-all command failed, (parameters: %1, reason: %2)
.EE
.UNINDENT
.UNINDENT
.sp
دستور sflq\-pool6\-get\-all با شکست مواجه شد. هم دلیل شکست و هم پارامترهای
ارسال‌شده در لاگ ثبت می‌شوند.
.SS SFLQ_POOL6_GET_BY_RANGE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
sflq\-pool6\-get\-by\-range command succeeded, (parameters: %1) pools found: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۲۰ ثبت می‌شود.
دستور sflq\-pool6\-get\-by\-range موفقیت‌آمیز بود.
.SS SFLQ_POOL6_GET_BY_RANGE_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
sflq\-pool6\-get\-by\-range command failed, (parameters: %1, reason: %2)
.EE
.UNINDENT
.UNINDENT
.sp
دستور sflq\-pool6\-get\-range با شکست مواجه شد. هم دلیل شکست و هم پارامترهای
ارسال‌شده در لاگ ثبت می‌شوند..SS SFLQ_POOL6_GET_BY_SUBNET
.INDENT 0.0
.INDENT 3.5
.sp
.EX
sflq\-pool6\-get\-by\-subnet command succeeded, (parameters: %1) pools found: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۲۰ ثبت می‌شود.
دستور sflq\-pool6\-get\-by\-subnet موفقیت‌آمیز بود.
.SS SFLQ_POOL6_GET_BY_SUBNET_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
sflq\-pool6\-get\-by\-subnet command failed, (parameters: %1, reason: %2)
.EE
.UNINDENT
.UNINDENT
.sp
دستور sflq\-pool6\-get\-subnet با شکست مواجه شده است. هم دلیل و هم پارامترهای ارسال‌شده در گزارش ثبت می‌شوند.
.SS SFLQ_POOL6_REBUILD
.INDENT 0.0
.INDENT 3.5
.sp
.EX
sflq\-pool6\-rebuild command succeeded, (parameters: %1) pools rebuilt: %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۲۰ ثبت می‌شود.
دستور sflq\-pool6\-rebuild موفقیت‌آمیز بود. این پیام آرگومان‌های دستور را به همراه تعداد استخرهای (pools) بازسازی‌شده چاپ می‌کند.
.SS SFLQ_POOL6_REBUILD_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
sflq\-pool6\-rebuild command failed, (parameters: %1, reason: %2)
.EE
.UNINDENT
.UNINDENT
.sp
دستور sflq\-pool6\-rebuild با شکست مواجه شده است. هم دلیل و هم پارامترهای ارسال‌شده در گزارش ثبت می‌شوند.
.SS START
.SS START_REKEY_TIMER
.INDENT 0.0
.INDENT 3.5
.sp
.EX
started timer handling rekey for server %1 in %2 seconds.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگام راه‌اندازی تایمر تولید مجدد کلید (rekey timer) برای مدیریت کلیدهای جدید این سرور صادر می‌شود، زمانی که در حال حاضر دست‌کم یک کلید موجود است. آرگومان نخست شناسهٔ سرور و آرگومان دوم بازهٔ زمانی را مشخص می‌کند که تلاش بعدی برای پردازش کلید در آن صورت خواهد گرفت.
.SS START_RETRY_TIMER
.INDENT 0.0
.INDENT 3.5
.sp
.EX
started timer handling retry for server %1 in %2 seconds.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی هنگام راه‌اندازی تایمر تلاش مجدد (retry timer) برای مدیریت کلیدهای جدید این سرور صادر می‌شود، زمانی که در حال حاضر هیچ کلیدی موجود نیست. آرگومان نخست شناسهٔ سرور و آرگومان دوم بازهٔ زمانی را مشخص می‌کند که تلاش بعدی برای پردازش کلید در آن صورت خواهد گرفت.
.SS STAT
.SS STAT_CMDS_DEINIT_OK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
unloading Stat Commands hooks library successful
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی نشان می‌دهد که کتابخانهٔ قلاب‌های (hooks library) Stat Commands با موفقیت حذف شده است.
.SS STAT_CMDS_INIT_OK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
loading Stat Commands hooks library successful
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی نشان می‌دهد که کتابخانهٔ قلاب‌های Stat Commands با موفقیت بارگذاری شده است. لذت ببرید!
.SS STAT_CMDS_LEASE4_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
stat\-lease4\-get command failed: reason: %1
.EE
.UNINDENT
.UNINDENT
.sp
دستور stat\-lease4\-get با شکست مواجه شده است. علت شکست در گزارش ثبت می‌شود.
.SS STAT_CMDS_LEASE4_GET
.INDENT 0.0
.INDENT 3.5
.sp
.EX
stat\-lease4\-get command successful, parameters: %1 rows found: %2
.EE
.UNINDENT
.UNINDENT
.sp
دستور stat\-lease4\-get با موفقیت انجام شده است. گزارش شامل پارامترهای ارائه‌شده و تعداد سطرهای یافت‌شده خواهد بود..SS STAT_CMDS_LEASE4_GET_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
stat\-lease4\-get command failed: parameters: %1, reason: %2
.EE
.UNINDENT
.UNINDENT
.sp
دستور stat\-lease4\-get با شکست مواجه شده است. پارامترهای ارائه‌شده و دلیل شکست هر دو ثبت می‌شوند.
.SS STAT_CMDS_LEASE4_GET_INVALID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
stat\-lease4\-get command is malformed or invalid, reason: %1
.EE
.UNINDENT
.UNINDENT
.sp
دستور stat\-lease4\-get ساختار نادرستی داشته یا حاوی پارامترهای نامعتبر بوده است. توضیحات دقیق‌تر باید ثبت شود.
.SS STAT_CMDS_LEASE4_GET_NO_SUBNETS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
stat\-lease4\-get, parameters: %1, %2\(dq
.EE
.UNINDENT
.UNINDENT
.sp
پارامترهای ارسال‌شده به همراه stat\-lease4\-get معتبر بودند اما همه زیرشبکه‌های شناخته‌شده را مستثنی کردند. پارامترهای ارائه‌شده به همراه توضیحات باید ثبت شوند.
.SS STAT_CMDS_LEASE4_ORPHANED_STATS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
stat\-lease4\-get command omitted statistics for one or more non\-existent subnets
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
در حین پردازش، دستور stat\-lease4\-get آمارهایی را برای شناسه‌های زیرشبکه مربوط به زیرشبکه‌های ناموجود پیدا کرد. این مقادیر از پاسخ بازگردانده‌شده دستور به کاربر حذف شدند. این مسئله ممکن است زمانی رخ دهد که زیرشبکه‌ها به‌گونه‌ای از پیکربندی حذف شده باشند که آمار آن‌ها حذف نشده باشد. اگرچه وجود چنین آمارهایی زیان‌آور نیست، اما باید اقداماتی برای حذف آن‌ها در نظر گرفته شود. برای فضای ذخیره‌سازی اجاره memfile، این مشکل پس از بارگذاری مجدد پیکربندی یا راه‌اندازی دوباره سرور باید برطرف شود. برای ذخیره‌سازی اجاره در پایگاه‌داده (database) این مسئله پیچیده‌تر است و تا نسخه Kea 2.0.0 هنوز راه‌حل تر و تمیزی برای آن وجود ندارد.
.SS STAT_CMDS_LEASE6_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
stat\-lease6\-get command failed: reason: %1
.EE
.UNINDENT
.UNINDENT
.sp
دستور stat\-lease6\-get با شکست مواجه شده است. دلیل شکست ثبت می‌شود.
.SS STAT_CMDS_LEASE6_GET
.INDENT 0.0
.INDENT 3.5
.sp
.EX
stat\-lease6\-get command successful, parameters: %1 rows found: %2
.EE
.UNINDENT
.UNINDENT
.sp
دستور stat\-lease6\-get با موفقیت انجام شد. گزارش حاوی پارامترهای ارائه‌شده و تعداد ردیف‌های یافت‌شده خواهد بود.
.SS STAT_CMDS_LEASE6_GET_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
stat\-lease6\-get command failed: parameters: %1, reason: %2
.EE
.UNINDENT
.UNINDENT
.sp
دستور stat\-lease6\-get با شکست مواجه شده است. پارامترهای ارائه‌شده و دلیل شکست هر دو ثبت می‌شوند.
.SS STAT_CMDS_LEASE6_GET_INVALID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
stat\-lease6\-get command is malformed or invalid, reason: %1
.EE
.UNINDENT
.UNINDENT
.sp
دستور stat\-lease6\-get ساختار نادرستی داشته یا حاوی پارامترهای نامعتبر بوده است. توضیحات دقیق‌تر باید ثبت شود.
.SS STAT_CMDS_LEASE6_GET_NO_SUBNETS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
stat\-lease6\-get, parameters: %1, %2\(dq
.EE
.UNINDENT
.UNINDENT
.sp
پارامترهای ارسال‌شده به همراه stat\-lease6\-get معتبر بودند اما همه زیرشبکه‌های شناخته‌شده را مستثنی کردند. پارامترهای ارائه‌شده به همراه توضیحات باید ثبت شوند.
.SS STAT_CMDS_LEASE6_ORPHANED_STATS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
stat\-lease6\-get command omitted statistics for one or more non\-existent subnets
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی (debug) ۴۰ ثبت می‌شود.
در حین پردازش، دستور stat\-lease4\-get آمارهایی را برای شناسه‌های زیرشبکه مربوط به زیرشبکه‌های ناموجود پیدا کرد. این مقادیر از پاسخ بازگردانده‌شده دستور به کاربر حذف شدند. این مسئله ممکن است زمانی رخ دهد که زیرشبکه‌ها به‌گونه‌ای از پیکربندی حذف شده باشند که آمار آن‌ها حذف نشده باشد. اگرچه وجود چنین آمارهایی زیان‌آور نیست، اما باید اقداماتی برای حذف آن‌ها در نظر گرفته شود. برای فضای ذخیره‌سازی اجاره memfile، این مشکل پس از بارگذاری مجدد پیکربندی یا راه‌اندازی دوباره سرور باید برطرف شود. برای ذخیره‌سازی اجاره در پایگاه‌داده (database) این مسئله پیچیده‌تر است و تا نسخه Kea 2.0.0 هنوز راه‌حل تر و تمیزی برای آن وجود ندارد..SS SUBNET
.SS SUBNET_CMDS_DEINIT_OK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
unloading Subnet Commands hooks library successful
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که کتابخانهٔ قلاب‌های Host Commands با موفقیت تخلیه شده است.
.SS SUBNET_CMDS_INIT_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
loading Subnet Commands hooks library failed: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان‌دهندهٔ بروز خطا در حین بارگذاری کتابخانهٔ قلاب‌های Subnet Commands است. جزئیات خطا به عنوان آرگومان پیام گزارش ارائه شده است.
.SS SUBNET_CMDS_INIT_OK
.INDENT 0.0
.INDENT 3.5
.sp
.EX
loading Subnet Commands hooks library successful
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که کتابخانهٔ قلاب‌های Host Commands با موفقیت بارگذاری شده است. لذت ببرید!
.SS SUBNET_CMDS_NETWORK4_ADD_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to add new IPv4 network: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که کتابخانهٔ قلاب‌های Subnet Commands در افزودن یک شبکهٔ IPv4 جدید به پیکربندی کارگزار با شکست مواجه شود. دلیل شکست در پیام خطا ارائه شده است. این پیام خطا همراه با کد وضعیت خطا به کلاینت کنترل‌کننده بازگردانده خواهد شد.
.SS SUBNET_CMDS_NETWORK4_DEL_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to delete IPv4 network: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که کتابخانهٔ قلاب‌های Subnet Commands در حذف یک شبکهٔ IPv4 با شکست مواجه شود. دلیل شکست در پیام خطا ارائه شده است. این پیام خطا همراه با کد وضعیت خطا به کلاینت کنترل‌کننده بازگردانده خواهد شد.
.SS SUBNET_CMDS_NETWORK4_GET_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to return an IPv4 network: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که کارگزار در بازگرداندن یک شبکهٔ IPv4 در پاسخ به دستور \(aqnetwork4\-get\(aq با شکست مواجه شود. آرگومان مربوطه جزئیات دلیل شکست را مشخص می‌کند. این پیام خطا همراه با کد وضعیت خطا به کلاینت کنترل‌کننده بازگردانده خواهد شد. این خطا ممکن است زمانی رخ دهد که دستور دریافتی ساختاری نامعتبر داشته باشد، دارای پارامترهای غیرمجاز باشد یا فاقد پارامترهای الزامی باشد. این خطا همچنین زمانی بازگردانده می‌شود که نحو دستور درست باشد اما هیچ شبکه‌ای یافت نشود.
.SS SUBNET_CMDS_NETWORK4_LIST_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to return a list of IPv4 networks: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که کتابخانهٔ قلاب‌های Subnet Commands در بازگرداندن فهرست شبکه‌های IPv4 درخواست‌شده با دستور \(aqnetwork4\-list\(aq با شکست مواجه شود. دلیل شکست در پیام خطا ارائه شده است. این پیام خطا همراه با کد وضعیت خطا به کلاینت کنترل‌کننده بازگردانده خواهد شد.
.SS SUBNET_CMDS_NETWORK4_SUBNET_ADD_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to add existing IPv4 subnet to a shared network: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که کتابخانهٔ قلاب‌های Subnet Commands در افزودن یک زیرشبکهٔ IPv4 موجود به یک شبکهٔ اشتراکی موجود با شکست مواجه شود. دلیل شکست در پیام خطا ارائه شده است. این پیام خطا همراه با کد وضعیت خطا به کلاینت کنترل‌کننده بازگردانده خواهد شد.
.SS SUBNET_CMDS_NETWORK4_SUBNET_DEL_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to remove a IPv4 subnet from a shared network: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که کتابخانهٔ قلاب‌های Subnet Commands در حذف یک زیرشبکهٔ IPv4 موجود از یک شبکهٔ اشتراکی موجود با شکست مواجه شود. دلیل شکست در پیام خطا ارائه شده است. این پیام خطا همراه با کد وضعیت خطا به کلاینت کنترل‌کننده بازگردانده خواهد شد..SS SUBNET_CMDS_NETWORK6_ADD_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to add new IPv6 network: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که کتابخانه قلاب‌های Subnet Commands در افزودن یک شبکه IPv6 جدید به پیکربندی سرور با شکست مواجه شود. دلیل شکست در متن پیام خطا ارائه شده است. پیام خطا به همراه کد وضعیت خطا به کلاینت کنترل‌کننده بازگردانده خواهد شد.
.SS SUBNET_CMDS_NETWORK6_DEL_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to delete IPv6 network: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که کتابخانه قلاب‌های Subnet Commands در حذف یک شبکه IPv6 با شکست مواجه شود. دلیل شکست در متن پیام خطا ارائه شده است. پیام خطا به همراه کد وضعیت خطا به کلاینت کنترل‌کننده بازگردانده خواهد شد.
.SS SUBNET_CMDS_NETWORK6_GET_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to return an IPv6 network: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که سرور در بازگرداندن یک شبکه IPv6 در پاسخ به دستور \(aqnetwork4\-get\(aq با شکست مواجه شود. این آرگومان جزئیات دلیل شکست را شرح می‌دهد. پیام خطا به همراه کد وضعیت خطا به کلاینت کنترل‌کننده بازگردانده خواهد شد. این خطا ممکن است زمانی رخ دهد که دستور دریافتی دارای ساختار نامعتبر باشد، شامل پارامترهای غیرمجاز باشد یا فاقد پارامترهای الزامی باشد. همچنین در صورتی که نحو دستوری صحیح باشد اما شبکه‌ای یافت نشود نیز این پیام بازگردانده خواهد شد.
.SS SUBNET_CMDS_NETWORK6_LIST_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to return a list of IPv6 networks: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که کتابخانه قلاب‌های Subnet Commands در بازگرداندن فهرست شبکه‌های IPv4 درخواست‌شده با دستور \(aqnetwork6\-list\(aq با شکست مواجه شود. دلیل شکست در متن پیام خطا ارائه شده است. پیام خطا به همراه کد وضعیت خطا به کلاینت کنترل‌کننده بازگردانده خواهد شد.
.SS SUBNET_CMDS_NETWORK6_SUBNET_ADD_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to add existing IPv6 subnet to a shared network: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که کتابخانه قلاب‌های Subnet Commands در افزودن زیرشبکه IPv6 موجود به شبکه اشتراکی موجود با شکست مواجه شود. دلیل شکست در متن پیام خطا ارائه شده است. پیام خطا به همراه کد وضعیت خطا به کلاینت کنترل‌کننده بازگردانده خواهد شد.
.SS SUBNET_CMDS_NETWORK6_SUBNET_DEL_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to remove a IPv6 subnet from a shared network: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که کتابخانه قلاب‌های Subnet Commands در حذف زیرشبکه IPv6 موجود از شبکه اشتراکی موجود با شکست مواجه شود. دلیل شکست در متن پیام خطا ارائه شده است. پیام خطا به همراه کد وضعیت خطا به کلاینت کنترل‌کننده بازگردانده خواهد شد.
.SS SUBNET_CMDS_NETWORK_ADD
.INDENT 0.0
.INDENT 3.5
.sp
.EX
successfully added shared network %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی زمانی صادر می‌شود که کتابخانه قلاب‌های Subnet Commands در پی دریافت دستور \(aqnetwork4\-add\(aq یا \(aqnetwork6\-add\(aq یک شبکه اشتراکی را با موفقیت اضافه کند. این آرگومان نشان‌دهنده نام شبکه اشتراکی اضافه‌شده است.
.SS SUBNET_CMDS_NETWORK_DEL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
successfully deleted shared network %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی زمانی صادر می‌شود که کتابخانه قلاب‌های Subnet Commands در پی دریافت دستور \(aqnetwork4\-del\(aq یا \(aqnetwork6\-del\(aq یک شبکه اشتراکی را با موفقیت حذف کند. این آرگومان نشان‌دهنده نام شبکه اشتراکی حذف‌شده است.
.SS SUBNET_CMDS_NETWORK_GET
.INDENT 0.0
.INDENT 3.5
.sp
.EX
successfully retrieved shared network %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی زمانی صادر می‌شود که کتابخانه قلاب‌های Subnet Commands در پی دریافت دستور \(aqnetwork4\-get\(aq یا \(aqnetwork6\-get\(aq یک شبکه اشتراکی را با موفقیت بازیابی کند. این آرگومان نشان‌دهنده نام شبکه اشتراکی بازیابی‌شده است..SS SUBNET_CMDS_NETWORK_GET_EMPTY
.INDENT 0.0
.INDENT 3.5
.sp
.EX
specified shared network is not found: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی هنگامی صادر می‌شود که کتابخانه قلاب‌های Subnet Commands در پی دریافت دستور \(aqnetwork4\-get\(aq یا \(aqnetwork6\-get\(aq، هیچ شبکه اشتراکی منطبقی را پیدا نکند.
.SS SUBNET_CMDS_NETWORK_LIST
.INDENT 0.0
.INDENT 3.5
.sp
.EX
successfully retrieved list of %1 %2 shared networks
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی زمانی صادر می‌شود که کتابخانه قلاب‌های Subnet Commands در نتیجه دریافت دستور \(aqnetwork4\-list\(aq یا \(aqnetwork6\-list\(aq، فهرستی از شبکه‌های اشتراکی را با موفقیت بازیابی کند. آرگومان نخست، تعداد شبکه‌های بازیابی‌شده را مشخص می‌کند. پارامتر دوم نوع پروتکل را تعیین می‌کند: \(aqIPv4\(aq یا \(aqIPv6\(aq.
.SS SUBNET_CMDS_NETWORK_LIST_EMPTY
.INDENT 0.0
.INDENT 3.5
.sp
.EX
no %1 shared networks listed
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی هنگامی صادر می‌شود که کتابخانه قلاب‌های Subnet Commands دستور \(aqnetwork4\-list\(aq یا \(aqnetwork6\-list\(aq را با موفقیت پردازش کند، اما هیچ شبکه اشتراکی پیدا نشود. این وضعیت نشان می‌دهد که پیکربندی سرور شامل هیچ شبکه اشتراکی از نوع مشخص‌شده نیست. آرگومان، نوع پروتکل را مشخص می‌کند: \(aqIPv4\(aq یا \(aqIPv6\(aq.
.SS SUBNET_CMDS_NETWORK_SUBNET_ADD
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1 subnet %2 (id %3) added to shared network %4
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که زیرشبکه مشخص‌شده (خانواده آدرس در پارامتر ۱، و جزئیات در پارامترهای ۲ و ۳ مشخص شده است) اکنون بخشی از یک شبکه اشتراکی است. این رخداد، نتیجه موفقیت‌آمیز هر یک از دستورهای network4\-subnet\-add یا network6\-subnet\-add است.
.SS SUBNET_CMDS_NETWORK_SUBNET_DEL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
%1 subnet %2 (id %3) removed from shared network %4
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی نشان می‌دهد که زیرشبکه مشخص‌شده (خانواده آدرس در پارامتر ۱، و جزئیات در پارامترهای ۲ و ۳ مشخص شده است) دیگر بخشی از یک شبکه اشتراکی نیست. زیرشبکه در پیکربندی باقی می‌ماند، اما به یک زیرشبکه مستقل تبدیل می‌شود. این رخداد، نتیجه موفقیت‌آمیز هر یک از دستورهای network4\-subnet\-del یا network6\-subnet\-del است.
.SS SUBNET_CMDS_SUBNET4_ADD_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to add new IPv4 subnet: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که کتابخانه قلاب‌های Subnet Commands نتواند یک زیرشبکه IPv4 جدید به پیکربندی سرور اضافه کند. دلیل این شکست در متن پیام خطا ارائه می‌شود. پیام خطا همراه با کد وضعیت خطا به کلاینت کنترل‌کننده بازگردانده خواهد شد.
.SS SUBNET_CMDS_SUBNET4_DELTA_ADD_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to update IPv4 subnet: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که کتابخانه قلاب‌های Subnet Commands در به‌روزرسانی پیکربندی سرور از طریق افزودن دلتا به یک زیرشبکه IPv4 با شکست مواجه شود. دلیل این شکست در متن پیام خطا ارائه می‌شود. پیام خطا همراه با کد وضعیت خطا به کلاینت کنترل‌کننده بازگردانده خواهد شد.
.SS SUBNET_CMDS_SUBNET4_DELTA_DEL_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to update IPv4 subnet: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که کتابخانه قلاب‌های Subnet Commands در به‌روزرسانی پیکربندی سرور از طریق حذف دلتا در یک زیرشبکه IPv4 با شکست مواجه شود. دلیل این شکست در متن پیام خطا ارائه می‌شود. پیام خطا همراه با کد وضعیت خطا به کلاینت کنترل‌کننده بازگردانده خواهد شد.
.SS SUBNET_CMDS_SUBNET4_DEL_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to delete IPv4 subnet: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که کتابخانه قلاب‌های Subnet Commands در حذف یک زیرشبکه IPv4 با شکست مواجه شود. دلیل این شکست در متن پیام خطا ارائه می‌شود. پیام خطا همراه با کد وضعیت خطا به کلاینت کنترل‌کننده بازگردانده خواهد شد..SS SUBNET_CMDS_SUBNET4_GET_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to return an IPv4 subnet: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا هنگامی صادر می‌شود که سرور نتواند یک زیرشبکهٔ IPv4 را در پاسخ به دستور \(aqsubnet4\-get\(aq بازگرداند. آرگومان مربوطه جزئیات دلیل شکست را شرح می‌دهد. این پیام خطا به همراه کد وضعیت خطا به کلاینت کنترل‌کننده بازگردانده خواهد شد. این خطا ممکن است زمانی رخ دهد که دستور دریافت شده ساختار نامعتبر داشته باشد، شامل پارامترهای غیرمجاز باشد یا پارامترهای ضروری را نداشته باشد. همچنین در صورتی که نحو دستور صحیح باشد اما هیچ زیرشبکه‌ای یافت نشود نیز این پیام بازگردانده می‌شود.
.SS SUBNET_CMDS_SUBNET4_LIST_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to return a list of IPv4 subnets: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که کتابخانه هوک‌های Subnet Commands نتواند فهرستی از زیرشبکه‌های IPv4 درخواست‌شده با دستور \(aqsubnet4\-list\(aq را بازگرداند. علت شکست درون پیام خطا ارائه می‌شود. این پیام خطا به همراه کد وضعیت خطا به کلاینت کنترل‌کننده بازگردانده خواهد شد.
.SS SUBNET_CMDS_SUBNET4_UPDATE_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to update IPv4 subnet: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که کتابخانه هوک‌های Subnet Commands در به‌روزرسانی یک زیرشبکهٔ IPv4 در پیکربندی سرور با شکست مواجه شود. علت شکست درون پیام خطا ارائه می‌شود. این پیام خطا به همراه کد وضعیت خطا به کلاینت کنترل‌کننده بازگردانده خواهد شد.
.SS SUBNET_CMDS_SUBNET6_ADD_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to add new IPv6 subnet: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که کتابخانه هوک‌های Subnet Commands در افزودن یک زیرشبکهٔ جدید IPv6 به پیکربندی سرور با شکست مواجه شود. علت شکست درون پیام خطا ارائه می‌شود. این پیام خطا به همراه کد وضعیت خطا به کلاینت کنترل‌کننده بازگردانده خواهد شد.
.SS SUBNET_CMDS_SUBNET6_DELTA_ADD_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to update IPv6 subnet: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا هنگامی صادر می‌شود که کتابخانه هوک‌های Subnet Commands در به‌روزرسانی از طریق افزودن یک دلتا در زیرشبکهٔ IPv6 به پیکربندی سرور با شکست مواجه شود. علت شکست درون پیام خطا ارائه می‌شود. این پیام خطا به همراه کد وضعیت خطا به کلاینت کنترل‌کننده بازگردانده خواهد شد.
.SS SUBNET_CMDS_SUBNET6_DELTA_DEL_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to update IPv6 subnet: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا هنگامی صادر می‌شود که کتابخانه هوک‌های Subnet Commands در به‌روزرسانی از طریق حذف یک دلتا در زیرشبکهٔ IPv6 از پیکربندی سرور با شکست مواجه شود. علت شکست درون پیام خطا ارائه می‌شود. این پیام خطا به همراه کد وضعیت خطا به کلاینت کنترل‌کننده بازگردانده خواهد شد.
.SS SUBNET_CMDS_SUBNET6_DEL_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to delete IPv6 subnet: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که کتابخانه هوک‌های Subnet Commands در حذف یک زیرشبکهٔ IPv6 با شکست مواجه شود. علت شکست درون پیام خطا ارائه می‌شود. این پیام خطا به همراه کد وضعیت خطا به کلاینت کنترل‌کننده بازگردانده خواهد شد.
.SS SUBNET_CMDS_SUBNET6_GET_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to return an IPv6 subnet: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا هنگامی صادر می‌شود که سرور نتواند یک زیرشبکهٔ IPv6 را در پاسخ به دستور \(aqsubnet4\-get\(aq بازگرداند. آرگومان مربوطه جزئیات دلیل شکست را شرح می‌دهد. این پیام خطا به همراه کد وضعیت خطا به کلاینت کنترل‌کننده بازگردانده خواهد شد. این خطا ممکن است زمانی رخ دهد که دستور دریافت شده ساختار نامعتبر داشته باشد، شامل پارامترهای غیرمجاز باشد یا پارامترهای ضروری را نداشته باشد. همچنین در صورتی که نحو دستور درست باشد اما هیچ زیرشبکه‌ای پیدا نشود نیز بازگردانده خواهد شد.
.SS SUBNET_CMDS_SUBNET6_LIST_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to return a list of IPv6 subnets: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که کتابخانه هوک‌های Subnet Commands نتواند فهرستی از زیرشبکه‌های IPv6 درخواست‌شده با دستور \(aqsubnet6\-list\(aq را بازگرداند. علت شکست درون پیام خطا ارائه می‌شود. این پیام خطا به همراه کد وضعیت خطا به کلاینت کنترل‌کننده بازگردانده خواهد شد..SS SUBNET_CMDS_SUBNET6_UPDATE_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
failed to update IPv6 subnet: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که کتابخانه هوک‌های Subnet Commands نتواند یک زیرشبکه IPv6 را در پیکربندی سرور به‌روزرسانی کند. دلیل این شکست درون پیام خطا مشخص شده است. این پیام خطا به همراه کد وضعیت خطا به کلاینت کنترل‌کننده بازگردانده خواهد شد.
.SS SUBNET_CMDS_SUBNET_ADD
.INDENT 0.0
.INDENT 3.5
.sp
.EX
successfully added subnet %1 having id %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی زمانی صادر می‌شود که کتابخانه هوک‌های Subnet Commands یک زیرشبکه را در نتیجه دریافت دستور \(aqsubnet4\-add\(aq یا \(aqsubnet6\-add\(aq با موفقیت اضافه کند. پارامتر نخست، پیشوند زیرشبکه اضافه‌شده را مشخص می‌کند. پارامتر دوم، شناسه زیرشبکه را مشخص می‌سازد.
.SS SUBNET_CMDS_SUBNET_DEL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
successfully deleted subnet %1 having id %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی زمانی صادر می‌شود که کتابخانه هوک‌های Subnet Commands یک زیرشبکه را در نتیجه دریافت دستور \(aqsubnet4\-del\(aq یا \(aqsubnet6\-del\(aq با موفقیت حذف کند. پارامتر نخست، پیشوند زیرشبکه حذف‌شده را مشخص می‌کند. پارامتر دوم، شناسه زیرشبکه را مشخص می‌سازد.
.SS SUBNET_CMDS_SUBNET_GET
.INDENT 0.0
.INDENT 3.5
.sp
.EX
successfully retrieved subnet %1 having id %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی زمانی صادر می‌شود که کتابخانه هوک‌های Subnet Commands یک زیرشبکه را در نتیجه دریافت دستور \(aqsubnet4\-get\(aq یا \(aqsubnet6\-get\(aq با موفقیت بازیابی کند. پارامتر نخست، پیشوند زیرشبکه بازیابی‌شده را مشخص می‌کند. پارامتر دوم، شناسه زیرشبکه را مشخص می‌سازد.
.SS SUBNET_CMDS_SUBNET_GET_EMPTY
.INDENT 0.0
.INDENT 3.5
.sp
.EX
specified subnet is not found: %1
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی زمانی صادر می‌شود که کتابخانه هوک‌های Subnet Commands در نتیجه دریافت دستور \(aqsubnet4\-get\(aq یا \(aqsubnet6\-get\(aq هیچ زیرشبکه منطبقی نیابد.
.SS SUBNET_CMDS_SUBNET_LIST
.INDENT 0.0
.INDENT 3.5
.sp
.EX
successfully retrieved list of %1 %2 subnets
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی زمانی صادر می‌شود که کتابخانه هوک‌های Subnet Commands فهرستی از زیرشبکه‌ها را در نتیجه دریافت دستور \(aqsubnet4\-list\(aq یا \(aqsubnet6\-list\(aq با موفقیت بازیابی کند. آرگومان نخست، تعداد زیرشبکه‌های بازیابی‌شده را مشخص می‌کند. پارامتر دوم، نوع پروتکل را تعیین می‌کند: \(aqIPv4\(aq یا \(aqIPv6\(aq.
.SS SUBNET_CMDS_SUBNET_LIST_EMPTY
.INDENT 0.0
.INDENT 3.5
.sp
.EX
no %1 subnets listed
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی زمانی صادر می‌شود که کتابخانه هوک‌های Subnet Commands دستور \(aqsubnet4\-list\(aq یا \(aqsubnet6\-list\(aq را با موفقیت پردازش کند، اما هیچ زیرشبکه‌ای یافت نشود. این امر نشان می‌دهد که پیکربندی سرور شامل هیچ زیرشبکه‌ای از این نوع خاص نیست. این وضعیت یک حالت خطا محسوب نمی‌شود، اما برای سرویس DHCP موردی غیرمعمول است. این آرگومان نوع زیرشبکه‌های فهرست‌شده را مشخص می‌کند، یعنی \(aqIPv4\(aq یا \(aqIPv6\(aq.
.SS SUBNET_CMDS_SUBNET_UPDATE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
successfully updated subnet %1 having id %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاعاتی زمانی صادر می‌شود که کتابخانه هوک‌های Subnet Commands یک زیرشبکه را در نتیجه دریافت دستور \(aqsubnet4\-update\(aq یا \(aqsubnet6\-update\(aq با موفقیت به‌روزرسانی کند. پارامتر نخست، پیشوند زیرشبکه به‌روزرسانی‌شده را مشخص می‌کند. پارامتر دوم، شناسه زیرشبکه را مشخص می‌سازد.
.SS TCP
.SS TCP_CLIENT_BAD_SERVER_RESPONSE_RECEIVED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
bad response received when communicating with %1 port %2: %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح ۴۰ ثبت گزارش اشکال‌زدایی (debug) ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک کلاینت TCP موفق به دریافت پاسخ از سرور نشود یا پاسخ دریافتی ناهنجار و معیوب باشد. آرگومان‌های نخست، آدرس و پورت سرور را مشخص می‌کنند. آرگومان آخر پیام خطای تفصیلی را ارائه می‌دهد..SS TCP_CLIENT_BAD_SERVER_RESPONSE_RECEIVED_DETAILS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
detailed information about bad response received from %1 port %2:\en%3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۵ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک کلاینت TCP پاسخی بدشکل (malformed) از کارساز دریافت کند. آرگومان‌های نخست نشانی و درگاه کارساز را مشخص می‌کنند؛ آرگومان آخر رونوشتی (dump) از پاسخ را ارائه می‌دهد.
.SS TCP_CLIENT_CONNECTION_CLOSE_CALLBACK_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Connection close callback threw an exception
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی صادر می‌شود که کالبک (callback) بستن اتصال که روی اتصال ثبت شده بود، به‌طور غیرمنتظره‌ای شکست بخورد. این یک خطای برنامه‌نویسی است که باید به‌عنوان یک باگ گزارش شود.
.SS TCP_CLIENT_MT_STARTED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
TcpClient has been started in multi\-threaded mode running %1 threads
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یک نمونه کلاینت چندنخی (multi\-threaded) TCP ایجاد شده باشد. این آرگومان حداکثر تعداد نخ‌ها را مشخص می‌کند.
.SS TCP_CLIENT_PREMATURE_CONNECTION_TIMEOUT_OCCURRED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
premature connection timeout occurred: in transaction ? %1, transid: %2, current_transid: %3
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که در طول تراکنش، اتمام مهلت (timeout) پیش‌رس و غیرمنتظره‌ای رخ دهد. ثابت شده است که این اتفاق زمانی رخ می‌دهد که ساعت سیستم به‌صورت دستی یا در نتیجه همگام‌سازی با یک کارساز زمان (time server) تغییر داده شود. هر تراکنش در حال انجامی قطع خواهد شد. تراکنش‌های جدید باید به‌طور عادی انجام شوند.
.SS TCP_CLIENT_QUEUE_SIZE_GROWING
.INDENT 0.0
.INDENT 3.5
.sp
.EX
queue for address: %1, port %2, now has %3 entries and may be growing too quickly
.EE
.UNINDENT
.UNINDENT
.sp
این پیام هشدار زمانی صادر می‌شود که به نظر برسد صف درخواست‌های معلق برای نشانی و درگاه داده‌شده، سریع‌تر از توان پردازش درخواست‌ها در حال رشد است. تا زمانی که اندازه صف به رشد خود ادامه دهد، این پیام به‌صورت دوره‌ای صادر خواهد شد. این وضعیت ممکن است به دلیل هجوم ناگهانی ترافیک کلاینت‌ها رخ دهد که انباشتگی موقتی ایجاد می‌کند و سپس با فروکش کردن ترافیک برطرف می‌شود. اگر این اتفاق به‌طور مداوم رخ دهد، به احتمال زیاد نشان‌دهنده پیکربندی استقراری است که توان تحمل بار کلاینت‌ها را ندارد.
.SS TCP_CLIENT_REQUEST_SEND
.INDENT 0.0
.INDENT 3.5
.sp
.EX
sending TCP request %1 to %2 port %3
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کلاینت شروع به ارسال یک درخواست TCP به یک کارساز می‌کند. آرگومان نخست رونوشتی از درخواست را نشان می‌دهد و آرگومان‌های بعدی نشانی و درگاه کارساز را مشخص می‌کنند.
.SS TCP_CLIENT_SERVER_RESPONSE_RECEIVED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
received TCP response from %1 port %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کلاینت دریافت پاسخ TCP از کارساز را به پایان برساند. نشانی و درگاه کارساز به‌عنوان آرگومان مشخص می‌شوند.
.SS TCP_CONNECTION_REJECTED_BY_FILTER
.INDENT 0.0
.INDENT 3.5
.sp
.EX
connection from %1 has been denied by the connection filter.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که فیلتر اتصال کارساز، اتصال جدیدی را بر اساس نشانی IP کلاینت رد کند.
.SS TCP_CONNECTION_SHUTDOWN
.INDENT 0.0
.INDENT 3.5
.sp
.EX
shutting down TCP connection from %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که یکی از اتصالات TCP متوقف (بسته) شود. این اتصال می‌تواند در نتیجه یک خطا یا پس از تبادل موفق پیام با یک کلاینت متوقف شود..SS TCP_CONNECTION_SHUTDOWN_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
shutting down TCP connection failed
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که هنگام قطع یک اتصال TCP با کلاینت، خطایی رخ داده باشد.
.SS TCP_CONNECTION_STOP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
stopping TCP connection from %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ دیباگ 40 ثبت می‌شود.
این پیام دیباگ زمانی صادر می‌شود که یکی از اتصال‌های TCP متوقف شود.
اتصال ممکن است در نتیجه یک خطا یا پس از تبادل موفقیت‌آمیز پیام با کلاینت متوقف گردد.
.SS TCP_CONNECTION_STOP_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
stopping TCP connection failed
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا زمانی صادر می‌شود که هنگام بستن یک اتصال TCP با کلاینت، خطایی رخ داده باشد.
.SS TCP_DATA_RECEIVED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
received %1 bytes from %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ دیباگ 55 ثبت می‌شود.
این پیام دیباگ زمانی صادر می‌شود که سرور بخشی از داده‌ها را از نقطه پایانی راه دور (remote endpoint) دریافت کند. این داده‌ها ممکن است شامل کل درخواست یا تنها بخشی از آن باشند. آرگومان نخست، مقدار داده‌های دریافت‌شده را مشخص می‌کند. آرگومان دوم، آدرس نقطه پایانی راه دور را که داده‌ها را تولید کرده است، مشخص می‌سازد.
.SS TCP_DATA_SENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
send %1 bytes to %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ دیباگ 55 ثبت می‌شود.
این پیام دیباگ زمانی صادر می‌شود که سرور بخشی از داده‌ها را به نقطه پایانی راه دور ارسال کند. این داده‌ها ممکن است شامل کل پاسخ یا تنها بخشی از آن باشند. آرگومان نخست، مقدار داده‌های ارسالی را مشخص می‌کند. آرگومان دوم، آدرس نقطه پایانی راه دور را مشخص می‌سازد.
.SS TCP_IDLE_CONNECTION_TIMEOUT_OCCURRED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
closing connection with %1 as a result of a timeout
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ دیباگ 50 ثبت می‌شود.
این پیام دیباگ زمانی صادر می‌شود که اتصال TCP به دلیل بیکار بودن (idle) بسته شود.
.SS TCP_REQUEST_RECEIVED_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
An unexpected error occurred processing a request from %1, error: %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا هنگامی صادر می‌شود که در حین تلاش سرور برای پردازش یک درخواست دریافت‌شده، خطایی غیرمنتظره رخ دهد. آرگومان نخست، آدرس نقطه پایانی راه دور را مشخص می‌کند. آرگومان دوم، ماهیت خطا را شرح می‌دهد.
.SS TCP_REQUEST_RECEIVE_START
.INDENT 0.0
.INDENT 3.5
.sp
.EX
start receiving request from %1 with timeout %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ دیباگ 50 ثبت می‌شود.
این پیام دیباگ زمانی صادر می‌شود که سرور شروع به دریافت درخواستی جدید از طریق اتصال برقرارشده کند. آرگومان نخست، آدرس نقطه پایانی راه دور را مشخص می‌کند. آرگومان دوم، مهلت زمانی (timeout) درخواست را بر حسب ثانیه مشخص می‌سازد.
.SS TCP_SERVER_CLIENT_REQUEST_RECEIVED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
received TCP request from %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ دیباگ 40 ثبت می‌شود.
این پیام دیباگ زمانی صادر می‌شود که دریافت درخواست TCP از نقطه پایانی راه دور توسط سرور به پایان رسیده باشد. آدرس نقطه پایانی راه دور به عنوان آرگومان مشخص شده است..SS TCP_SERVER_RESPONSE_SEND
.INDENT 0.0
.INDENT 3.5
.sp
.EX
sending TCP response to %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارساز در حال آغاز ارسال یک پاسخ TCP
به یک نقطهٔ پایانی دوردست است. آرگومان، نشانی نقطهٔ
پایانی دوردست را مشخص می‌کند.
.SS TKEY
.SS TKEY_EXCHANGE_ANSWER_CLASS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
GSS\-TKEY exchange received a response with answer class: %1.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که تبادل GSS\-TKEY پاسخی با
کلاس پاسخ مشخص‌شده دریافت کرده است.
.SS TKEY_EXCHANGE_FAILED_TO_VERIFY
.INDENT 0.0
.INDENT 3.5
.sp
.EX
GSS\-TKEY exchange failed because the response failed to verify.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که تبادل GSS\-TKEY با شکست مواجه شده است زیرا اعتبارسنجی
پاسخ ناموفق بود.
.SS TKEY_EXCHANGE_FAIL_EMPTY_IN_TOKEN
.INDENT 0.0
.INDENT 3.5
.sp
.EX
GSS\-TKEY exchange failed because input token is empty.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که تبادل GSS\-TKEY با شکست مواجه شده است زیرا توکن ورودی
خالی است.
.SS TKEY_EXCHANGE_FAIL_EMPTY_OUT_TOKEN
.INDENT 0.0
.INDENT 3.5
.sp
.EX
GSS\-TKEY exchange failed because output token is empty.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که تبادل GSS\-TKEY با شکست مواجه شده است زیرا توکن خروجی
خالی است.
.SS TKEY_EXCHANGE_FAIL_EMPTY_RESPONSE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
GSS\-TKEY exchange failed because the response is empty.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که تبادل GSS\-TKEY با شکست مواجه شده است زیرا پاسخ
خالی است.
.SS TKEY_EXCHANGE_FAIL_IO_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
GSS\-TKEY exchange failed because of the IO error: %1.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که تبادل GSS\-TKEY به دلیل خطای IO با شکست مواجه شده است.
آرگومان، جزئیات خطای IO را مشخص می‌کند.
.SS TKEY_EXCHANGE_FAIL_IO_STOPPED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
GSS\-TKEY exchange failed because the IO service was stopped.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که تبادل GSS\-TKEY با شکست مواجه شده است زیرا سرویس
IO متوقف شده بود.
.SS TKEY_EXCHANGE_FAIL_IO_TIMEOUT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
GSS\-TKEY exchange failed because of IO timeout.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که تبادل GSS\-TKEY به دلیل اتمام مهلت زمانی (timeout)
در IO با شکست مواجه شده است.
.SS TKEY_EXCHANGE_FAIL_NOT_SIGNED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
GSS\-TKEY exchange failed because the response is not signed.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که تبادل GSS\-TKEY با شکست مواجه شده است زیرا پاسخ
امضا نشده است..SS TKEY_EXCHANGE_FAIL_NO_RDATA
.INDENT 0.0
.INDENT 3.5
.sp
.EX
GSS\-TKEY exchange failed because the response contains no rdata.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که تبادل GSS\-TKEY شکست خورده است زیرا پاسخ حاوی هیچ rdataای نیست.
.SS TKEY_EXCHANGE_FAIL_NO_RESPONSE_ANSWER
.INDENT 0.0
.INDENT 3.5
.sp
.EX
GSS\-TKEY exchange failed because the response contains no answer.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که تبادل GSS\-TKEY شکست خورده است زیرا پاسخ فاقد answer است.
.SS TKEY_EXCHANGE_FAIL_NULL_RESPONSE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
GSS\-TKEY exchange failed because the response is null.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که تبادل GSS\-TKEY شکست خورده است زیرا پاسخ null است.
.SS TKEY_EXCHANGE_FAIL_RESPONSE_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
GSS\-TKEY exchange failed because the response contains an error: %1.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که تبادل GSS\-TKEY شکست خورده است زیرا پاسخ حاوی یک خطا است. آرگومان، جزئیات خطای پاسخ را مشخص می‌کند.
.SS TKEY_EXCHANGE_FAIL_TKEY_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
GSS\-TKEY exchange failed because the response contains TKEY error: %1.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که تبادل GSS\-TKEY شکست خورده است زیرا پاسخ حاوی خطای TKEY است. آرگومان، جزئیات خطای TKEY را مشخص می‌کند.
.SS TKEY_EXCHANGE_FAIL_TO_INIT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
GSS\-TKEY exchange failed to initialize because of the error: %1.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که تبادل GSS\-TKEY در مرحلهٔ مقداردهی اولیه شکست خورده است، برای نمونه به این دلیل که principal سرور وجود ندارد. آرگومان، جزئیات خطا را مشخص می‌کند.
.SS TKEY_EXCHANGE_FAIL_WRONG_RESPONSE_ANSWER_COUNT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
GSS\-TKEY exchange failed because the response contains invalid number of RRs: %1.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که تبادل GSS\-TKEY شکست خورده است زیرا پاسخ حاوی تعداد نامعتبری از RRها است. آرگومان، حاوی تعداد نادرست RRها است.
.SS TKEY_EXCHANGE_FAIL_WRONG_RESPONSE_ANSWER_TYPE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
GSS\-TKEY exchange failed because the response contains wrong answer type: %1.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که تبادل GSS\-TKEY شکست خورده است زیرا پاسخ حاوی نوع answer نادرستی است. آرگومان، حاوی نوع نادرست answer است.
.SS TKEY_EXCHANGE_FAIL_WRONG_RESPONSE_OPCODE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
GSS\-TKEY exchange failed because the response contains invalid opcode: %1.
.EE
.UNINDENT
.UNINDENT
.sp
این پیام خطا نشان می‌دهد که تبادل GSS\-TKEY شکست خورده است زیرا پاسخ حاوی opcode نامعتبری است. آرگومان، حاوی opcode نادرست است.
.SS TKEY_EXCHANGE_NOT_A_RESPONSE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
GSS\-TKEY exchange received a non response type.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی 40 ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که تبادل GSS\-TKEY نوعی غیر از پاسخ (non-response) دریافت کرده است..SS TKEY_EXCHANGE_OUT_TOKEN_NOT_EMPTY
.INDENT 0.0
.INDENT 3.5
.sp
.EX
GSS\-TKEY exchange output token is not empty.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که توکن خروجی تبادل GSS\-TKEY خالی نیست.
.SS TKEY_EXCHANGE_RDATA_COUNT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
GSS\-TKEY exchange received a response with rdata count: %1.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که تبادل GSS\-TKEY پاسخی با تعداد rdata مشخص‌شده دریافت کرده است.
.SS TKEY_EXCHANGE_RECEIVE_MESSAGE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
GSS\-TKEY exchange receives a message of size: %1.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که تبادل GSS\-TKEY پیامی با اندازهٔ مشخص‌شده دریافت می‌کند.
.SS TKEY_EXCHANGE_RESPONSE_TTL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
GSS\-TKEY exchange received a response with TTL of: %1 seconds.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که تبادل GSS\-TKEY پاسخی با TTL مشخص‌شده دریافت کرده است.
.SS TKEY_EXCHANGE_SEND_MESSAGE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
GSS\-TKEY exchange sends a message of size: %1.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که تبادل GSS\-TKEY پیامی با اندازهٔ مشخص‌شده ارسال می‌کند.
.SS TKEY_EXCHANGE_VALID
.INDENT 0.0
.INDENT 3.5
.sp
.EX
GSS\-TKEY exchange retrieved a TKEY valid for: %1 seconds.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که تبادل GSS\-TKEY یک TKEY معتبر برای بازهٔ زمانی مشخص‌شده بر حسب ثانیه را بازیابی کرده است.
.SS TKEY_EXCHANGE_VERIFIED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
GSS\-TKEY exchange verified.
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۴۰ ثبت می‌شود.
این پیام اشکال‌زدایی نشان می‌دهد که تبادل GSS\-TKEY تأیید شده است.
.SS TLS
.SS TLS_CONNECTION_HANDSHAKE_FAILED
.INDENT 0.0
.INDENT 3.5
.sp
.EX
TLS handshake with %1 failed with %2
.EE
.UNINDENT
.UNINDENT
.sp
این پیام اطلاع‌رسانی زمانی صادر می‌شود که دست‌تکانی TLS در سمت سرور با شکست مواجه شود. نشانی کلاینت و پیام خطا نمایش داده می‌شوند.
.SS TLS_CONNECTION_HANDSHAKE_START
.INDENT 0.0
.INDENT 3.5
.sp
.EX
start TLS handshake with %1 with timeout %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور دست‌تکانی TLS را با نقطهٔ پایانی راه دور آغاز می‌کند. آرگومان اول نشانی نقطهٔ پایانی راه دور را مشخص می‌کند. آرگومان دوم مهلت زمانی درخواست را بر حسب ثانیه مشخص می‌کند.
.SS TLS_REQUEST_RECEIVE_START
.INDENT 0.0
.INDENT 3.5
.sp
.EX
start receiving request from %1 with timeout %2
.EE
.UNINDENT
.UNINDENT
.sp
در سطح گزارش اشکال‌زدایی ۵۰ ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که سرور دریافت درخواست جدید را بر روی اتصال برقرار شده آغاز می‌کند. آرگومان اول نشانی نقطهٔ پایانی راه دور را مشخص می‌کند. آرگومان دوم مهلت زمانی درخواست را بر حسب ثانیه مشخص می‌کند..SS TLS_SERVER_RESPONSE_SEND
.INDENT 0.0
.INDENT 3.5
.sp
.EX
sending TLS response to %1
.EE
.UNINDENT
.UNINDENT
.sp
در سطح لاگ اشکال‌زدایی 40 ثبت می‌شود.
این پیام اشکال‌زدایی زمانی صادر می‌شود که کارگزار در حال آغاز ارسال یک پاسخ TLS به یک نقطه پایانی دوردست است. این آرگومان، نشانی نقطه پایانی دوردست را مشخص می‌کند.
.SS USER
.SS USER_CHK_HOOK_LOAD_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCP UserCheckHook could not be loaded: %1
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی صادر می‌شود که DHCP UserCheckHook نتواند بارگذاری شود. علت دقیق باید در پیام لاگ توضیح داده شده باشد. انتخاب زیرشبکه کاربر به پردازش پیش‌فرض بازخواهد گشت.
.SS USER_CHK_HOOK_UNLOAD_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCP UserCheckHook an error occurred unloading the library: %1
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و هنگامی که خطایی در حین تخلیه کتابخانه UserCheckHook رخ دهد صادر می‌شود. وقوع این خطا بعید است و احتمالاً با بارگذاری بعدی کتابخانه، عملکرد عادی آن از سر گرفته خواهد شد.
.SS USER_CHK_SUBNET4_SELECT_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCP UserCheckHook an unexpected error occurred in subnet4_select callout: %1
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی صادر می‌شود که هوک subnet4_select در DHCP UserCheckHook با یک خطای غیرمنتظره مواجه شود. این پیام باید حاوی توضیح دقیق‌تری باشد.
.SS USER_CHK_SUBNET4_SELECT_REGISTRY_NULL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCP UserCheckHook UserRegistry has not been created.
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی صادر می‌شود که هوک subnet4_select در DHCP UserCheckHook فراخوانی شده باشد، اما UserRegistry ایجاد نشده باشد. این یک خطای برنامه‌نویسی است و نباید رخ دهد.
.SS USER_CHK_SUBNET6_SELECT_ERROR
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCP UserCheckHook an unexpected error occurred in subnet6_select callout: %1
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی صادر می‌شود که هوک subnet6_select در DHCP UserCheckHook با یک خطای غیرمنتظره مواجه شود. این پیام باید حاوی توضیح دقیق‌تری باشد.
.SS USER_CHK_SUBNET6_SELECT_REGISTRY_NULL
.INDENT 0.0
.INDENT 3.5
.sp
.EX
DHCP UserCheckHook UserRegistry has not been created.
.EE
.UNINDENT
.UNINDENT
.sp
این یک پیام خطا است و زمانی صادر می‌شود که هوک subnet6_select در DHCP UserCheckHook فراخوانی شده باشد، اما UserRegistry ایجاد نشده باشد. این یک خطای برنامه‌نویسی است و نباید رخ دهد.
.SS پیام‌های اشکال‌زدایی Kea بر اساس سطح لاگ
.SS پیام‌های چاپ‌شده در debuglevel 0
.INDENT 0.0
.IP \(bu 2
DCTL_INIT_PROCESS
.IP \(bu 2
DCTL_RUN_PROCESS
.IP \(bu 2
DCTL_SHUTDOWN
.IP \(bu 2
DCTL_SHUTDOWN_SIGNAL_RECVD
.IP \(bu 2
DCTL_STANDALONE
.IP \(bu 2
DHCP4_OPEN_SOCKET
.IP \(bu 2
DHCP4_START_INFO
.IP \(bu 2
DHCP6_OPEN_SOCKET
.IP \(bu 2
DHCP6_START_INFO
.IP \(bu 2
DHCP_DDNS_CLEARED_FOR_SHUTDOWN
.IP \(bu 2
DHCP_DDNS_QUEUE_MGR_STARTED
.IP \(bu 2
DHCP_DDNS_QUEUE_MGR_STOPPING
.IP \(bu 2
DHCP_DDNS_RUN_EXIT
.IP \(bu 2
DHCP_DDNS_SHUTDOWN_COMMAND
.IP \(bu 2
NETCONF_RUN_EXIT
.UNINDENT.SS "پیام‌های چاپ‌شده در debuglevel 10"
.INDENT 0.0
.IP \(bu 2
COMMAND_DEREGISTERED
.IP \(bu 2
COMMAND_EXTENDED_REGISTERED
.IP \(bu 2
COMMAND_HTTP_LISTENER_COMMAND_REJECTED
.IP \(bu 2
COMMAND_HTTP_LISTENER_STARTED
.IP \(bu 2
COMMAND_HTTP_LISTENER_STOPPED
.IP \(bu 2
COMMAND_HTTP_LISTENER_STOPPING
.IP \(bu 2
COMMAND_REGISTERED
.IP \(bu 2
COMMAND_SOCKET_CONNECTION_CLOSED
.IP \(bu 2
COMMAND_SOCKET_CONNECTION_OPENED
.IP \(bu 2
COMMAND_SOCKET_READ
.IP \(bu 2
COMMAND_SOCKET_WRITE
.IP \(bu 2
DCTL_CONFIG_START
.IP \(bu 2
DHCP4_CONFIG_RECEIVED
.IP \(bu 2
DHCP4_CONFIG_START
.IP \(bu 2
DHCP6_CONFIG_RECEIVED
.IP \(bu 2
DHCP6_CONFIG_START
.UNINDENT
.SS "پیام‌های چاپ‌شده در debuglevel 15"
.INDENT 0.0
.IP \(bu 2
DHCP4_HOOK_BUFFER_RCVD_DROP
.IP \(bu 2
DHCP4_HOOK_DDNS_UPDATE
.IP \(bu 2
DHCP4_HOOK_DECLINE_SKIP
.IP \(bu 2
DHCP4_HOOK_LEASE4_RELEASE_SKIP
.IP \(bu 2
DHCP4_HOOK_PACKET_SEND_DROP
.IP \(bu 2
DHCP4_HOOK_SUBNET4_SELECT_4O6_PARKING_LOT_FULL
.IP \(bu 2
DHCP4_HOOK_SUBNET4_SELECT_PARKING_LOT_FULL
.IP \(bu 2
DHCP4_HOOK_SUBNET6_SELECT_PARKING_LOT_FULL
.IP \(bu 2
DHCP4_PACKET_DROP_0001
.IP \(bu 2
DHCP4_PACKET_DROP_0002
.IP \(bu 2
DHCP4_PACKET_DROP_0003
.IP \(bu 2
DHCP4_PACKET_DROP_0004
.IP \(bu 2
DHCP4_PACKET_DROP_0005
.IP \(bu 2
DHCP4_PACKET_DROP_0006
.IP \(bu 2
DHCP4_PACKET_DROP_0007
.IP \(bu 2
DHCP4_PACKET_DROP_0008
.IP \(bu 2
DHCP4_PACKET_DROP_0009
.IP \(bu 2
DHCP4_PACKET_DROP_0010
.IP \(bu 2
DHCP4_PACKET_DROP_0011
.IP \(bu 2
DHCP4_PACKET_DROP_0012
.IP \(bu 2
DHCP4_PACKET_DROP_0013
.IP \(bu 2
DHCP4_PACKET_DROP_0014
.IP \(bu 2
DHCP4_PACKET_NAK_0005
.IP \(bu 2
DHCP6_HOOK_BUFFER_RCVD_DROP
.IP \(bu 2
DHCP6_HOOK_DDNS_UPDATE
.IP \(bu 2
DHCP6_HOOK_DECLINE_DROP
.IP \(bu 2
DHCP6_HOOK_LEASES6_COMMITTED_DROP
.IP \(bu 2
DHCP6_HOOK_LEASES6_PARKING_LOT_FULL
.IP \(bu 2
DHCP6_HOOK_PACKET_SEND_DROP
.IP \(bu 2
DHCP6_PACKET_DROP_DHCP_DISABLED
.IP \(bu 2
DHCP6_PACKET_DROP_DROP_CLASS
.IP \(bu 2
DHCP6_PACKET_DROP_DROP_CLASS2
.IP \(bu 2
DHCP6_PACKET_DROP_DROP_CLASS_EARLY
.IP \(bu 2
DHCP6_PACKET_DROP_DUPLICATE
.IP \(bu 2
DHCP6_PACKET_DROP_PARSE_FAIL
.IP \(bu 2
DHCP6_PACKET_DROP_SERVERID_MISMATCH
.IP \(bu 2
DHCP6_PACKET_DROP_UNICAST
.IP \(bu 2
DHCP6_PACKET_REJECT_CLASS
.UNINDENT
.SS "پیام‌های چاپ‌شده در debuglevel 20"
.INDENT 0.0
.IP \(bu 2
LEASE_CMDS_ADD4
.IP \(bu 2
LEASE_CMDS_ADD6
.IP \(bu 2
LEASE_CMDS_BULK_APPLY6
.IP \(bu 2
LEASE_CMDS_DEL4
.IP \(bu 2
LEASE_CMDS_DEL6
.IP \(bu 2
LEASE_CMDS_UPDATE4
.IP \(bu 2
LEASE_CMDS_UPDATE6
.IP \(bu 2
SFLQ_POOL4_DEL
.IP \(bu 2
SFLQ_POOL4_GET_ALL
.IP \(bu 2
SFLQ_POOL4_GET_BY_RANGE
.IP \(bu 2
SFLQ_POOL4_GET_BY_SUBNET
.IP \(bu 2
SFLQ_POOL4_REBUILD
.IP \(bu 2
SFLQ_POOL6_DEL
.IP \(bu 2
SFLQ_POOL6_GET_ALL
.IP \(bu 2
SFLQ_POOL6_GET_BY_RANGE
.IP \(bu 2
SFLQ_POOL6_GET_BY_SUBNET
.IP \(bu 2
SFLQ_POOL6_REBUILD
.UNINDENT.SS پیام‌های چاپ‌شده در debuglevel 40
.INDENT 0.0
.IP \(bu 2
ALLOC_ENGINE_IGNORING_UNSUITABLE_GLOBAL_ADDRESS
.IP \(bu 2
ALLOC_ENGINE_IGNORING_UNSUITABLE_GLOBAL_ADDRESS6
.IP \(bu 2
ALLOC_ENGINE_LEASE_RECLAIMED
.IP \(bu 2
ALLOC_ENGINE_V4_DISCOVER_HR
.IP \(bu 2
ALLOC_ENGINE_V4_LEASES_RECLAMATION_COMPLETE
.IP \(bu 2
ALLOC_ENGINE_V4_LEASES_RECLAMATION_START
.IP \(bu 2
ALLOC_ENGINE_V4_LEASES_RECLAMATION_TIMEOUT
.IP \(bu 2
ALLOC_ENGINE_V4_LEASE_RECLAIM
.IP \(bu 2
ALLOC_ENGINE_V4_NO_MORE_EXPIRED_LEASES
.IP \(bu 2
ALLOC_ENGINE_V4_OFFER_EXISTING_LEASE
.IP \(bu 2
ALLOC_ENGINE_V4_OFFER_NEW_LEASE
.IP \(bu 2
ALLOC_ENGINE_V4_OFFER_REQUESTED_LEASE
.IP \(bu 2
ALLOC_ENGINE_V4_RECLAIMED_LEASES_DELETE
.IP \(bu 2
ALLOC_ENGINE_V4_RECLAIMED_LEASES_DELETE_COMPLETE
.IP \(bu 2
ALLOC_ENGINE_V4_REQUEST_ADDRESS_RESERVED
.IP \(bu 2
ALLOC_ENGINE_V4_REQUEST_ALLOC_REQUESTED
.IP \(bu 2
ALLOC_ENGINE_V4_REQUEST_EXTEND_LEASE
.IP \(bu 2
ALLOC_ENGINE_V4_REQUEST_INVALID
.IP \(bu 2
ALLOC_ENGINE_V4_REQUEST_IN_USE
.IP \(bu 2
ALLOC_ENGINE_V4_REQUEST_OUT_OF_POOL
.IP \(bu 2
ALLOC_ENGINE_V4_REQUEST_PICK_ADDRESS
.IP \(bu 2
ALLOC_ENGINE_V4_REQUEST_REMOVE_LEASE
.IP \(bu 2
ALLOC_ENGINE_V4_REQUEST_USE_HR
.IP \(bu 2
ALLOC_ENGINE_V6_ALLOC_HR_LEASE_EXISTS
.IP \(bu 2
ALLOC_ENGINE_V6_ALLOC_LEASES_HR
.IP \(bu 2
ALLOC_ENGINE_V6_ALLOC_LEASES_NO_HR
.IP \(bu 2
ALLOC_ENGINE_V6_ALLOC_NO_LEASES_HR
.IP \(bu 2
ALLOC_ENGINE_V6_ALLOC_NO_V6_HR
.IP \(bu 2
ALLOC_ENGINE_V6_ALLOC_UNRESERVED
.IP \(bu 2
ALLOC_ENGINE_V6_CALCULATED_PREFERRED_LIFETIME
.IP \(bu 2
ALLOC_ENGINE_V6_EXPIRED_HINT_RESERVED
.IP \(bu 2
ALLOC_ENGINE_V6_EXTEND_ALLOC_UNRESERVED
.IP \(bu 2
ALLOC_ENGINE_V6_HINT_RESERVED
.IP \(bu 2
ALLOC_ENGINE_V6_LEASES_RECLAMATION_COMPLETE
.IP \(bu 2
ALLOC_ENGINE_V6_LEASES_RECLAMATION_START
.IP \(bu 2
ALLOC_ENGINE_V6_LEASES_RECLAMATION_TIMEOUT
.IP \(bu 2
ALLOC_ENGINE_V6_LEASE_RECLAIM
.IP \(bu 2
ALLOC_ENGINE_V6_NO_MORE_EXPIRED_LEASES
.IP \(bu 2
ALLOC_ENGINE_V6_RECLAIMED_LEASES_DELETE
.IP \(bu 2
ALLOC_ENGINE_V6_RECLAIMED_LEASES_DELETE_COMPLETE
.IP \(bu 2
ALLOC_ENGINE_V6_RENEW_HR
.IP \(bu 2
ALLOC_ENGINE_V6_RENEW_REMOVE_RESERVED
.IP \(bu 2
ASIODNS_FETCH_STOPPED
.IP \(bu 2
BOOTP_BOOTP_QUERY
.IP \(bu 2
BOOTP_PACKET_OPTIONS_SKIPPED
.IP \(bu 2
BOOTP_PACKET_PACK
.IP \(bu 2
BOOTP_PACKET_UNPACK_FAILED
.IP \(bu 2
BULK_LEASE_QUERY_AT_MAX_CONCURRENT_QUERIES
.IP \(bu 2
BULK_LEASE_QUERY_DEQUEUED
.IP \(bu 2
BULK_LEASE_QUERY_QUERY_RECEIVED
.IP \(bu 2
BULK_LEASE_QUERY_RESPONSE_SENT
.IP \(bu 2
DDNS_TUNING4_CALCULATED_HOSTNAME
.IP \(bu 2
DDNS_TUNING4_SKIPPING_DDNS
.IP \(bu 2
DDNS_TUNING6_CALCULATED_HOSTNAME
.IP \(bu 2
DDNS_TUNING6_SKIPPING_DDNS
.IP \(bu 2
DDNS_TUNING_SUBNET_EXPRESSION_PARSE
.IP \(bu 2
DDNS_TUNING_SUBNET_EXPR_CACHED
.IP \(bu 2
DHCP4_ADDITIONAL_CLASS_NO_TEST
.IP \(bu 2
DHCP4_ADDITIONAL_CLASS_UNDEFINED
.IP \(bu 2
DHCP4_BUFFER_RECEIVED
.IP \(bu 2
DHCP4_CLASSES_ASSIGNED
.IP \(bu 2
DHCP4_CLASSES_ASSIGNED_AFTER_SUBNET_SELECTION
.IP \(bu 2
DHCP4_CLASS_ASSIGNED
.IP \(bu 2
DHCP4_CLASS_UNCONFIGURED
.IP \(bu 2
DHCP4_DHCP4O6_HOOK_SUBNET4_SELECT_DROP
.IP \(bu 2
DHCP4_DHCP4O6_HOOK_SUBNET4_SELECT_SKIP
.IP \(bu 2
DHCP4_DHCP4O6_PACKET_RECEIVED
.IP \(bu 2
DHCP4_DHCP4O6_PACKET_SEND
.IP \(bu 2
DHCP4_FLEX_ID
.IP \(bu 2
DHCP4_HOOK_BUFFER_SEND_SKIP
.IP \(bu 2
DHCP4_HOOK_PACKET_RCVD_SKIP
.IP \(bu 2
DHCP4_HOOK_PACKET_SEND_SKIP
.IP \(bu 2
DHCP4_HOOK_SUBNET4_SELECT_DROP
.IP \(bu 2
DHCP4_HOOK_SUBNET4_SELECT_PARK
.IP \(bu 2
DHCP4_HOOK_SUBNET4_SELECT_SKIP
.IP \(bu 2
DHCP4_LEASE_QUERY_PACKET_UNPACK_FAILED
.IP \(bu 2
DHCP4_LEASE_QUERY_PROCESS_FAILED
.IP \(bu 2
DHCP4_LEASE_QUERY_RECEIVED
.IP \(bu 2
DHCP4_LEASE_QUERY_RESPONSE_SENT
.IP \(bu 2
DHCP4_PACKET_QUEUE_FULL
.IP \(bu 2
DHCP4_RECLAIM_EXPIRED_LEASES_SKIPPED
.IP \(bu 2
DHCP4_SHUTDOWN
.IP \(bu 2
DHCP4_SHUTDOWN_REQUEST
.IP \(bu 2
DHCP6_ADDITIONAL_CLASS_NO_TEST
.IP \(bu 2
DHCP6_ADDITIONAL_CLASS_UNDEFINED
.IP \(bu 2
DHCP6_ADDR6_REGISTER_DISABLED_DROP
.IP \(bu 2
DHCP6_BUFFER_RECEIVED
.IP \(bu 2
DHCP6_CLASSES_ASSIGNED
.IP \(bu 2
DHCP6_CLASSES_ASSIGNED_AFTER_SUBNET_SELECTION
.IP \(bu 2
DHCP6_CLASS_ASSIGNED
.IP \(bu 2
DHCP6_CLASS_UNCONFIGURED
.IP \(bu 2
DHCP6_DHCP4O6_PACKET_RECEIVED
.IP \(bu 2
DHCP6_FLEX_ID
.IP \(bu 2
DHCP6_HOOK_ADDR6_REGISTER_DROP
.IP \(bu 2
DHCP6_HOOK_ADDR6_REGISTER_SKIP
.IP \(bu 2
DHCP6_HOOK_BUFFER_SEND_SKIP
.IP \(bu 2
DHCP6_HOOK_LEASE6_RELEASE_NA_SKIP
.IP \(bu 2
DHCP6_HOOK_LEASE6_RELEASE_PD_SKIP
.IP \(bu 2
DHCP6_HOOK_LEASES6_COMMITTED_PARK.IP \(bu 2
DHCP6_HOOK_PACKET_RCVD_SKIP
.IP \(bu 2
DHCP6_HOOK_PACKET_SEND_SKIP
.IP \(bu 2
DHCP6_HOOK_SUBNET6_SELECT_DROP
.IP \(bu 2
DHCP6_HOOK_SUBNET6_SELECT_PARK
.IP \(bu 2
DHCP6_HOOK_SUBNET6_SELECT_SKIP
.IP \(bu 2
DHCP6_LEASE_QUERY_PACKET_UNPACK_FAILED
.IP \(bu 2
DHCP6_LEASE_QUERY_PREFIX_LENGTH_LIST
.IP \(bu 2
DHCP6_LEASE_QUERY_PROCESS_FAILED
.IP \(bu 2
DHCP6_LEASE_QUERY_RECEIVED
.IP \(bu 2
DHCP6_LEASE_QUERY_REPLY_SENT
.IP \(bu 2
DHCP6_PACKET_PROCESS_FAIL
.IP \(bu 2
DHCP6_PACKET_QUEUE_FULL
.IP \(bu 2
DHCP6_RECLAIM_EXPIRED_LEASES_SKIPPED
.IP \(bu 2
DHCP6_REQUIRED_OPTIONS_CHECK_FAIL
.IP \(bu 2
DHCP6_SHUTDOWN
.IP \(bu 2
DHCP6_SHUTDOWN_REQUEST
.IP \(bu 2
DHCP6_UNKNOWN_MSG_RECEIVED
.IP \(bu 2
DHCPSRV_CFGMGR_ADD_SUBNET4
.IP \(bu 2
DHCPSRV_CFGMGR_ADD_SUBNET6
.IP \(bu 2
DHCPSRV_CFGMGR_ALL_IFACES_ACTIVE
.IP \(bu 2
DHCPSRV_CFGMGR_CFG_DHCP_DDNS
.IP \(bu 2
DHCPSRV_CFGMGR_DEL_SUBNET4
.IP \(bu 2
DHCPSRV_CFGMGR_DEL_SUBNET6
.IP \(bu 2
DHCPSRV_CFGMGR_SUBNET4
.IP \(bu 2
DHCPSRV_CFGMGR_SUBNET4_ADDR
.IP \(bu 2
DHCPSRV_CFGMGR_SUBNET4_IFACE
.IP \(bu 2
DHCPSRV_CFGMGR_SUBNET4_RELAY
.IP \(bu 2
DHCPSRV_CFGMGR_SUBNET6
.IP \(bu 2
DHCPSRV_CFGMGR_SUBNET6_IFACE
.IP \(bu 2
DHCPSRV_CFGMGR_SUBNET6_IFACE_ID
.IP \(bu 2
DHCPSRV_CFGMGR_SUBNET6_RELAY
.IP \(bu 2
DHCPSRV_CFGMGR_UPDATE_SUBNET4
.IP \(bu 2
DHCPSRV_CFGMGR_UPDATE_SUBNET6
.IP \(bu 2
DHCPSRV_CLOSE_DB
.IP \(bu 2
DHCPSRV_FORENSIC_BACKEND_DEREGISTER
.IP \(bu 2
DHCPSRV_FORENSIC_BACKEND_REGISTER
.IP \(bu 2
DHCPSRV_HOOK_LEASE4_RECOVER_SKIP
.IP \(bu 2
DHCPSRV_HOOK_LEASE4_RENEW_SKIP
.IP \(bu 2
DHCPSRV_HOOK_LEASE4_SELECT_SKIP
.IP \(bu 2
DHCPSRV_HOOK_LEASE6_EXTEND_SKIP
.IP \(bu 2
DHCPSRV_HOOK_LEASE6_RECOVER_SKIP
.IP \(bu 2
DHCPSRV_HOOK_LEASE6_SELECT_SKIP
.IP \(bu 2
DHCPSRV_LEASE4_EXTENDED_INFO_UPGRADED
.IP \(bu 2
DHCPSRV_LEASE6_EXTENDED_INFO_UPGRADED
.IP \(bu 2
DHCPSRV_LEASE_MGR_BACKEND_DEREGISTER
.IP \(bu 2
DHCPSRV_LEASE_MGR_BACKEND_REGISTER
.IP \(bu 2
DHCPSRV_MEMFILE_BEGIN_BUILD_EXTENDED_INFO_TABLES6
.IP \(bu 2
DHCPSRV_MEMFILE_BEGIN_EXTRACT_EXTENDED_INFO4
.IP \(bu 2
DHCPSRV_MEMFILE_EXTRACT_EXTENDED_INFO4
.IP \(bu 2
DHCPSRV_MEMFILE_EXTRACT_EXTENDED_INFO4_ERROR
.IP \(bu 2
DHCPSRV_MEMFILE_LFC_UNREGISTER_TIMER_FAILED
.IP \(bu 2
DHCPSRV_SUBNET4O6_SELECT_FAILED
.IP \(bu 2
DHCPSRV_SUBNET4_SELECT_BY_ADDRESS_NO_MATCH
.IP \(bu 2
DHCPSRV_SUBNET4_SELECT_BY_INTERFACE_NO_MATCH
.IP \(bu 2
DHCPSRV_SUBNET4_SELECT_BY_RELAY_ADDRESS_NO_MATCH
.IP \(bu 2
DHCPSRV_SUBNET4_SELECT_NO_RAI_OPTIONS
.IP \(bu 2
DHCPSRV_SUBNET4_SELECT_NO_RELAY_ADDRESS
.IP \(bu 2
DHCPSRV_SUBNET4_SELECT_NO_USABLE_ADDRESS
.IP \(bu 2
DHCPSRV_SUBNET6_SELECT_BY_ADDRESS_NO_MATCH
.IP \(bu 2
DHCPSRV_SUBNET6_SELECT_BY_INTERFACE_ID_NO_MATCH
.IP \(bu 2
DHCPSRV_SUBNET6_SELECT_BY_INTERFACE_NO_MATCH
.IP \(bu 2
DHCPSRV_TIMERMGR_REGISTER_TIMER
.IP \(bu 2
DHCPSRV_TIMERMGR_START_TIMER
.IP \(bu 2
DHCPSRV_TIMERMGR_STOP_TIMER
.IP \(bu 2
DHCPSRV_TIMERMGR_UNREGISTER_ALL_TIMERS
.IP \(bu 2
DHCPSRV_TIMERMGR_UNREGISTER_TIMER
.IP \(bu 2
DHCP_DDNS_CONFIGURE
.IP \(bu 2
DHCP_DDNS_NCR_UDP_RECV_CANCELED
.IP \(bu 2
DHCP_DDNS_QUEUE_MGR_RECONFIGURING
.IP \(bu 2
DHCP_DDNS_QUEUE_MGR_STOPPED
.IP \(bu 2
DHCP_IFACE_OPEN_SOCKET
.IP \(bu 2
FLEX_ID_EXPRESSION_EVALUATED
.IP \(bu 2
FLEX_ID_EXPRESSION_HEX
.IP \(bu 2
FLEX_ID_IGNORE_IAID_APPLIED_ON_NA
.IP \(bu 2
FLEX_ID_IGNORE_IAID_APPLIED_ON_PD
.IP \(bu 2
FLEX_ID_IGNORE_IAID_NOT_APPLIED_ON_NA
.IP \(bu 2
FLEX_ID_IGNORE_IAID_NOT_APPLIED_ON_PD
.IP \(bu 2
FLEX_ID_NO_IDENTIFIER_EXPRESSION
.IP \(bu 2
FLEX_ID_RESTORE_CLIENT_ID
.IP \(bu 2
FLEX_ID_RESTORE_DUID
.IP \(bu 2
FLEX_ID_USED_AS_CLIENT_ID
.IP \(bu 2
FLEX_ID_USED_AS_DUID
.IP \(bu 2
FLEX_OPTION_PROCESS_ADD
.IP \(bu 2
FLEX_OPTION_PROCESS_CLIENT_CLASS
.IP \(bu 2
FLEX_OPTION_PROCESS_REMOVE
.IP \(bu 2
FLEX_OPTION_PROCESS_SUB_ADD
.IP \(bu 2
FLEX_OPTION_PROCESS_SUB_CLIENT_CLASS
.IP \(bu 2
FLEX_OPTION_PROCESS_SUB_REMOVE
.IP \(bu 2
FLEX_OPTION_PROCESS_SUB_SUPERSEDE
.IP \(bu 2
FLEX_OPTION_PROCESS_SUPERSEDE
.IP \(bu 2
FLEX_OPTION_PROCESS_VENDOR_ID_MISMATCH
.IP \(bu 2
GSS_TSIG_MANAGER_STARTED
.IP \(bu 2
GSS_TSIG_MANAGER_STOPPED
.IP \(bu 2
GSS_TSIG_NEW_KEY
.IP \(bu 2
GSS_TSIG_NEW_KEY_SETUP_SUCCEED
.IP \(bu 2
GSS_TSIG_OLD_KEY_REMOVED
.IP \(bu 2
GSS_TSIG_VERIFIED
.IP \(bu 2
HA_BUFFER4_RECEIVE_NOT_FOR_US
.IP \(bu 2
HA_BUFFER4_RECEIVE_PACKET_OPTIONS_SKIPPED
.IP \(bu 2
HA_BUFFER4_RECEIVE_UNPACK_FAILED.IP \(bu 2
HA_BUFFER6_RECEIVE_NOT_FOR_US
.IP \(bu 2
HA_BUFFER6_RECEIVE_PACKET_OPTIONS_SKIPPED
.IP \(bu 2
HA_BUFFER6_RECEIVE_UNPACK_FAILED
.IP \(bu 2
HA_LEASE4_EXPIRE_RECLAMATION_SKIP
.IP \(bu 2
HA_LEASE6_EXPIRE_RECLAMATION_SKIP
.IP \(bu 2
HA_LEASES4_COMMITTED_NOTHING_TO_UPDATE
.IP \(bu 2
HA_LEASES6_COMMITTED_NOTHING_TO_UPDATE
.IP \(bu 2
HA_LEASE_SYNC_STALE_LEASE4_SKIP
.IP \(bu 2
HA_LEASE_SYNC_STALE_LEASE6_SKIP
.IP \(bu 2
HA_LOAD_BALANCING_DUID_MISSING
.IP \(bu 2
HA_LOAD_BALANCING_IDENTIFIER_MISSING
.IP \(bu 2
HA_LOAD_BALANCING_LEASE_DUID_MISSING
.IP \(bu 2
HA_LOAD_BALANCING_LEASE_IDENTIFIER_MISSING
.IP \(bu 2
HA_SUBNET4_SELECT_NOT_FOR_US
.IP \(bu 2
HA_SUBNET4_SELECT_NO_SUBNET_SELECTED
.IP \(bu 2
HA_SUBNET6_SELECT_NOT_FOR_US
.IP \(bu 2
HA_SUBNET6_SELECT_NO_SUBNET_SELECTED
.IP \(bu 2
HOOKS_LIBRARY_LOADING
.IP \(bu 2
HOOKS_LIBRARY_UNLOADING
.IP \(bu 2
HOOKS_LOAD_SUCCESS
.IP \(bu 2
HOOKS_NO_LOAD
.IP \(bu 2
HOOKS_NO_UNLOAD
.IP \(bu 2
HOOKS_UNLOAD_SUCCESS
.IP \(bu 2
HOSTS_BACKEND_DEREGISTER
.IP \(bu 2
HOSTS_BACKEND_REGISTER
.IP \(bu 2
HOSTS_CFG_ADD_HOST
.IP \(bu 2
HOSTS_CFG_CLOSE_HOST_DATA_SOURCE
.IP \(bu 2
HOSTS_CFG_DEL
.IP \(bu 2
HOSTS_CFG_DEL4
.IP \(bu 2
HOSTS_CFG_DEL6
.IP \(bu 2
HOSTS_CFG_DEL_ALL_SUBNET4
.IP \(bu 2
HOSTS_CFG_DEL_ALL_SUBNET6
.IP \(bu 2
HOSTS_CFG_GET_ALL
.IP \(bu 2
HOSTS_CFG_GET_ALL_ADDRESS4
.IP \(bu 2
HOSTS_CFG_GET_ALL_ADDRESS6
.IP \(bu 2
HOSTS_CFG_GET_ALL_HOSTNAME
.IP \(bu 2
HOSTS_CFG_GET_ALL_HOSTNAME_SUBNET_ID4
.IP \(bu 2
HOSTS_CFG_GET_ALL_HOSTNAME_SUBNET_ID6
.IP \(bu 2
HOSTS_CFG_GET_ALL_IDENTIFIER
.IP \(bu 2
HOSTS_CFG_GET_ALL_SUBNET_ID4
.IP \(bu 2
HOSTS_CFG_GET_ALL_SUBNET_ID6
.IP \(bu 2
HOSTS_CFG_GET_ALL_SUBNET_ID_ADDRESS4
.IP \(bu 2
HOSTS_CFG_GET_ALL_SUBNET_ID_ADDRESS6
.IP \(bu 2
HOSTS_CFG_GET_ONE_PREFIX
.IP \(bu 2
HOSTS_CFG_GET_ONE_SUBNET_ID_ADDRESS4
.IP \(bu 2
HOSTS_CFG_GET_ONE_SUBNET_ID_ADDRESS6
.IP \(bu 2
HOSTS_CFG_GET_ONE_SUBNET_ID_IDENTIFIER
.IP \(bu 2
HOSTS_CFG_UPDATE_ADD
.IP \(bu 2
HOSTS_CFG_UPDATE_DEL4
.IP \(bu 2
HOSTS_CFG_UPDATE_DEL6
.IP \(bu 2
HOSTS_MGR_ALTERNATE_GET4_SUBNET_ID_ADDRESS4
.IP \(bu 2
HOSTS_MGR_ALTERNATE_GET4_SUBNET_ID_IDENTIFIER
.IP \(bu 2
HOSTS_MGR_ALTERNATE_GET6_PREFIX
.IP \(bu 2
HOSTS_MGR_ALTERNATE_GET6_SUBNET_ID_ADDRESS6
.IP \(bu 2
HOSTS_MGR_ALTERNATE_GET6_SUBNET_ID_IDENTIFIER
.IP \(bu 2
HOSTS_MGR_ALTERNATE_GET_ALL_SUBNET_ID_ADDRESS4
.IP \(bu 2
HOSTS_MGR_ALTERNATE_GET_ALL_SUBNET_ID_ADDRESS6
.IP \(bu 2
HOST_CACHE_GET_ONE_PREFIX
.IP \(bu 2
HOST_CACHE_GET_ONE_SUBNET_ID_ADDRESS4
.IP \(bu 2
HOST_CACHE_GET_ONE_SUBNET_ID_ADDRESS6
.IP \(bu 2
HOST_CACHE_GET_ONE_SUBNET_ID_IDENTIFIER
.IP \(bu 2
HTTP_BAD_CLIENT_REQUEST_RECEIVED
.IP \(bu 2
HTTP_BAD_SERVER_RESPONSE_RECEIVED
.IP \(bu 2
HTTP_CLIENT_MT_STARTED
.IP \(bu 2
HTTP_CLIENT_REQUEST_RECEIVED
.IP \(bu 2
HTTP_CONNECTION_SHUTDOWN
.IP \(bu 2
HTTP_CONNECTION_STOP
.IP \(bu 2
HTTP_SERVER_RESPONSE_RECEIVED
.IP \(bu 2
HTTP_SERVER_RESPONSE_SEND
.IP \(bu 2
KEY_LOOKUP_DISABLED
.IP \(bu 2
KEY_LOOKUP_FOUND
.IP \(bu 2
KEY_LOOKUP_NONE
.IP \(bu 2
LIMITS_CONFIGURED_ADDRESS_LIMIT_BY_CLIENT_CLASS
.IP \(bu 2
LIMITS_CONFIGURED_ADDRESS_LIMIT_BY_SUBNET
.IP \(bu 2
LIMITS_CONFIGURED_PREFIX_LIMIT_BY_CLIENT_CLASS
.IP \(bu 2
LIMITS_CONFIGURED_PREFIX_LIMIT_BY_SUBNET
.IP \(bu 2
LIMITS_CONFIGURED_RATE_LIMIT_BY_CLIENT_CLASS
.IP \(bu 2
LIMITS_CONFIGURED_RATE_LIMIT_BY_SUBNET
.IP \(bu 2
LIMITS_LEASE_LIMIT_EXCEEDED
.IP \(bu 2
LIMITS_LEASE_WITHIN_LIMITS
.IP \(bu 2
LIMITS_PACKET_WITH_CLIENT_CLASSES_RATE_LIMIT_DROPPED
.IP \(bu 2
LIMITS_PACKET_WITH_SUBNET_ID_RATE_LIMIT_DROPPED
.IP \(bu 2
MT_TCP_LISTENER_MGR_STARTED
.IP \(bu 2
MT_TCP_LISTENER_MGR_STOPPED
.IP \(bu 2
MT_TCP_LISTENER_MGR_STOPPING
.IP \(bu 2
MYSQL_CB_CREATE_UPDATE_BY_POOL_OPTION4
.IP \(bu 2
MYSQL_CB_CREATE_UPDATE_BY_POOL_OPTION6
.IP \(bu 2
MYSQL_CB_CREATE_UPDATE_BY_PREFIX_OPTION6
.IP \(bu 2
MYSQL_CB_CREATE_UPDATE_BY_SUBNET_ID_OPTION4
.IP \(bu 2
MYSQL_CB_CREATE_UPDATE_BY_SUBNET_ID_OPTION6
.IP \(bu 2
MYSQL_CB_CREATE_UPDATE_CLIENT_CLASS4
.IP \(bu 2
MYSQL_CB_CREATE_UPDATE_CLIENT_CLASS6
.IP \(bu 2
MYSQL_CB_CREATE_UPDATE_GLOBAL_PARAMETER4
.IP \(bu 2
MYSQL_CB_CREATE_UPDATE_GLOBAL_PARAMETER6
.IP \(bu 2
MYSQL_CB_CREATE_UPDATE_OPTION4
.IP \(bu 2
MYSQL_CB_CREATE_UPDATE_OPTION6
.IP \(bu 2
MYSQL_CB_CREATE_UPDATE_OPTION_DEF4
.IP \(bu 2
MYSQL_CB_CREATE_UPDATE_OPTION_DEF6
.IP \(bu 2
MYSQL_CB_CREATE_UPDATE_SERVER4
.IP \(bu 2
MYSQL_CB_CREATE_UPDATE_SERVER6.IP \(bu 2
MYSQL_CB_CREATE_UPDATE_SHARED_NETWORK4
.IP \(bu 2
MYSQL_CB_CREATE_UPDATE_SHARED_NETWORK6
.IP \(bu 2
MYSQL_CB_CREATE_UPDATE_SHARED_NETWORK_OPTION4
.IP \(bu 2
MYSQL_CB_CREATE_UPDATE_SHARED_NETWORK_OPTION6
.IP \(bu 2
MYSQL_CB_CREATE_UPDATE_SUBNET4
.IP \(bu 2
MYSQL_CB_CREATE_UPDATE_SUBNET6
.IP \(bu 2
MYSQL_CB_DELETE_ALL_CLIENT_CLASSES4
.IP \(bu 2
MYSQL_CB_DELETE_ALL_CLIENT_CLASSES4_RESULT
.IP \(bu 2
MYSQL_CB_DELETE_ALL_CLIENT_CLASSES6
.IP \(bu 2
MYSQL_CB_DELETE_ALL_CLIENT_CLASSES6_RESULT
.IP \(bu 2
MYSQL_CB_DELETE_ALL_GLOBAL_PARAMETERS4
.IP \(bu 2
MYSQL_CB_DELETE_ALL_GLOBAL_PARAMETERS4_RESULT
.IP \(bu 2
MYSQL_CB_DELETE_ALL_GLOBAL_PARAMETERS6
.IP \(bu 2
MYSQL_CB_DELETE_ALL_GLOBAL_PARAMETERS6_RESULT
.IP \(bu 2
MYSQL_CB_DELETE_ALL_OPTION_DEFS4
.IP \(bu 2
MYSQL_CB_DELETE_ALL_OPTION_DEFS4_RESULT
.IP \(bu 2
MYSQL_CB_DELETE_ALL_OPTION_DEFS6
.IP \(bu 2
MYSQL_CB_DELETE_ALL_OPTION_DEFS6_RESULT
.IP \(bu 2
MYSQL_CB_DELETE_ALL_SERVERS4
.IP \(bu 2
MYSQL_CB_DELETE_ALL_SERVERS4_RESULT
.IP \(bu 2
MYSQL_CB_DELETE_ALL_SERVERS6
.IP \(bu 2
MYSQL_CB_DELETE_ALL_SERVERS6_RESULT
.IP \(bu 2
MYSQL_CB_DELETE_ALL_SHARED_NETWORKS4
.IP \(bu 2
MYSQL_CB_DELETE_ALL_SHARED_NETWORKS4_RESULT
.IP \(bu 2
MYSQL_CB_DELETE_ALL_SHARED_NETWORKS6
.IP \(bu 2
MYSQL_CB_DELETE_ALL_SHARED_NETWORKS6_RESULT
.IP \(bu 2
MYSQL_CB_DELETE_ALL_SUBNETS4
.IP \(bu 2
MYSQL_CB_DELETE_ALL_SUBNETS4_RESULT
.IP \(bu 2
MYSQL_CB_DELETE_ALL_SUBNETS6
.IP \(bu 2
MYSQL_CB_DELETE_ALL_SUBNETS6_RESULT
.IP \(bu 2
MYSQL_CB_DELETE_BY_POOL_OPTION4
.IP \(bu 2
MYSQL_CB_DELETE_BY_POOL_OPTION4_RESULT
.IP \(bu 2
MYSQL_CB_DELETE_BY_POOL_OPTION6
.IP \(bu 2
MYSQL_CB_DELETE_BY_POOL_OPTION6_RESULT
.IP \(bu 2
MYSQL_CB_DELETE_BY_POOL_PREFIX_OPTION6
.IP \(bu 2
MYSQL_CB_DELETE_BY_POOL_PREFIX_OPTION6_RESULT
.IP \(bu 2
MYSQL_CB_DELETE_BY_PREFIX_SUBNET4
.IP \(bu 2
MYSQL_CB_DELETE_BY_PREFIX_SUBNET4_RESULT
.IP \(bu 2
MYSQL_CB_DELETE_BY_PREFIX_SUBNET6
.IP \(bu 2
MYSQL_CB_DELETE_BY_PREFIX_SUBNET6_RESULT
.IP \(bu 2
MYSQL_CB_DELETE_BY_SUBNET_ID_OPTION4
.IP \(bu 2
MYSQL_CB_DELETE_BY_SUBNET_ID_OPTION4_RESULT
.IP \(bu 2
MYSQL_CB_DELETE_BY_SUBNET_ID_OPTION6
.IP \(bu 2
MYSQL_CB_DELETE_BY_SUBNET_ID_OPTION6_RESULT
.IP \(bu 2
MYSQL_CB_DELETE_BY_SUBNET_ID_SUBNET4
.IP \(bu 2
MYSQL_CB_DELETE_BY_SUBNET_ID_SUBNET4_RESULT
.IP \(bu 2
MYSQL_CB_DELETE_BY_SUBNET_ID_SUBNET6
.IP \(bu 2
MYSQL_CB_DELETE_BY_SUBNET_ID_SUBNET6_RESULT
.IP \(bu 2
MYSQL_CB_DELETE_CLIENT_CLASS4
.IP \(bu 2
MYSQL_CB_DELETE_CLIENT_CLASS4_RESULT
.IP \(bu 2
MYSQL_CB_DELETE_CLIENT_CLASS6
.IP \(bu 2
MYSQL_CB_DELETE_CLIENT_CLASS6_RESULT
.IP \(bu 2
MYSQL_CB_DELETE_GLOBAL_PARAMETER4
.IP \(bu 2
MYSQL_CB_DELETE_GLOBAL_PARAMETER4_RESULT
.IP \(bu 2
MYSQL_CB_DELETE_GLOBAL_PARAMETER6
.IP \(bu 2
MYSQL_CB_DELETE_GLOBAL_PARAMETER6_RESULT
.IP \(bu 2
MYSQL_CB_DELETE_OPTION4
.IP \(bu 2
MYSQL_CB_DELETE_OPTION4_RESULT
.IP \(bu 2
MYSQL_CB_DELETE_OPTION6
.IP \(bu 2
MYSQL_CB_DELETE_OPTION6_RESULT
.IP \(bu 2
MYSQL_CB_DELETE_OPTION_DEF4
.IP \(bu 2
MYSQL_CB_DELETE_OPTION_DEF4_RESULT
.IP \(bu 2
MYSQL_CB_DELETE_OPTION_DEF6
.IP \(bu 2
MYSQL_CB_DELETE_OPTION_DEF6_RESULT
.IP \(bu 2
MYSQL_CB_DELETE_SERVER4
.IP \(bu 2
MYSQL_CB_DELETE_SERVER4_RESULT
.IP \(bu 2
MYSQL_CB_DELETE_SERVER6
.IP \(bu 2
MYSQL_CB_DELETE_SERVER6_RESULT
.IP \(bu 2
MYSQL_CB_DELETE_SHARED_NETWORK4
.IP \(bu 2
MYSQL_CB_DELETE_SHARED_NETWORK4_RESULT
.IP \(bu 2
MYSQL_CB_DELETE_SHARED_NETWORK6
.IP \(bu 2
MYSQL_CB_DELETE_SHARED_NETWORK6_RESULT
.IP \(bu 2
MYSQL_CB_DELETE_SHARED_NETWORK_OPTION4
.IP \(bu 2
MYSQL_CB_DELETE_SHARED_NETWORK_OPTION4_RESULT
.IP \(bu 2
MYSQL_CB_DELETE_SHARED_NETWORK_OPTION6
.IP \(bu 2
MYSQL_CB_DELETE_SHARED_NETWORK_OPTION6_RESULT
.IP \(bu 2
MYSQL_CB_DELETE_SHARED_NETWORK_SUBNETS4
.IP \(bu 2
MYSQL_CB_DELETE_SHARED_NETWORK_SUBNETS4_RESULT
.IP \(bu 2
MYSQL_CB_DELETE_SHARED_NETWORK_SUBNETS6
.IP \(bu 2
MYSQL_CB_DELETE_SHARED_NETWORK_SUBNETS6_RESULT
.IP \(bu 2
MYSQL_CB_GET_ALL_CLIENT_CLASSES4
.IP \(bu 2
MYSQL_CB_GET_ALL_CLIENT_CLASSES4_RESULT
.IP \(bu 2
MYSQL_CB_GET_ALL_CLIENT_CLASSES6
.IP \(bu 2
MYSQL_CB_GET_ALL_CLIENT_CLASSES6_RESULT
.IP \(bu 2
MYSQL_CB_GET_ALL_GLOBAL_PARAMETERS4
.IP \(bu 2
MYSQL_CB_GET_ALL_GLOBAL_PARAMETERS4_RESULT
.IP \(bu 2
MYSQL_CB_GET_ALL_GLOBAL_PARAMETERS6
.IP \(bu 2
MYSQL_CB_GET_ALL_GLOBAL_PARAMETERS6_RESULT
.IP \(bu 2
MYSQL_CB_GET_ALL_OPTIONS4
.IP \(bu 2
MYSQL_CB_GET_ALL_OPTIONS4_RESULT
.IP \(bu 2
MYSQL_CB_GET_ALL_OPTIONS6
.IP \(bu 2
MYSQL_CB_GET_ALL_OPTIONS6_RESULT
.IP \(bu 2
MYSQL_CB_GET_ALL_OPTION_DEFS4
.IP \(bu 2
MYSQL_CB_GET_ALL_OPTION_DEFS4_RESULT
.IP \(bu 2
MYSQL_CB_GET_ALL_OPTION_DEFS6
.IP \(bu 2
MYSQL_CB_GET_ALL_OPTION_DEFS6_RESULT
.IP \(bu 2
MYSQL_CB_GET_ALL_SERVERS4
.IP \(bu 2
MYSQL_CB_GET_ALL_SERVERS4_RESULT
.IP \(bu 2
MYSQL_CB_GET_ALL_SERVERS6
.IP \(bu 2
MYSQL_CB_GET_ALL_SERVERS6_RESULT.IP \(bu 2
MYSQL_CB_GET_ALL_SHARED_NETWORKS4
.IP \(bu 2
MYSQL_CB_GET_ALL_SHARED_NETWORKS4_RESULT
.IP \(bu 2
MYSQL_CB_GET_ALL_SHARED_NETWORKS6
.IP \(bu 2
MYSQL_CB_GET_ALL_SHARED_NETWORKS6_RESULT
.IP \(bu 2
MYSQL_CB_GET_ALL_SUBNETS4
.IP \(bu 2
MYSQL_CB_GET_ALL_SUBNETS4_RESULT
.IP \(bu 2
MYSQL_CB_GET_ALL_SUBNETS6
.IP \(bu 2
MYSQL_CB_GET_ALL_SUBNETS6_RESULT
.IP \(bu 2
MYSQL_CB_GET_CLIENT_CLASS4
.IP \(bu 2
MYSQL_CB_GET_CLIENT_CLASS6
.IP \(bu 2
MYSQL_CB_GET_GLOBAL_PARAMETER4
.IP \(bu 2
MYSQL_CB_GET_GLOBAL_PARAMETER6
.IP \(bu 2
MYSQL_CB_GET_HOST4
.IP \(bu 2
MYSQL_CB_GET_HOST6
.IP \(bu 2
MYSQL_CB_GET_MODIFIED_CLIENT_CLASSES4
.IP \(bu 2
MYSQL_CB_GET_MODIFIED_CLIENT_CLASSES4_RESULT
.IP \(bu 2
MYSQL_CB_GET_MODIFIED_CLIENT_CLASSES6
.IP \(bu 2
MYSQL_CB_GET_MODIFIED_CLIENT_CLASSES6_RESULT
.IP \(bu 2
MYSQL_CB_GET_MODIFIED_GLOBAL_PARAMETERS4
.IP \(bu 2
MYSQL_CB_GET_MODIFIED_GLOBAL_PARAMETERS4_RESULT
.IP \(bu 2
MYSQL_CB_GET_MODIFIED_GLOBAL_PARAMETERS6
.IP \(bu 2
MYSQL_CB_GET_MODIFIED_GLOBAL_PARAMETERS6_RESULT
.IP \(bu 2
MYSQL_CB_GET_MODIFIED_OPTIONS4
.IP \(bu 2
MYSQL_CB_GET_MODIFIED_OPTIONS4_RESULT
.IP \(bu 2
MYSQL_CB_GET_MODIFIED_OPTIONS6
.IP \(bu 2
MYSQL_CB_GET_MODIFIED_OPTIONS6_RESULT
.IP \(bu 2
MYSQL_CB_GET_MODIFIED_OPTION_DEFS4
.IP \(bu 2
MYSQL_CB_GET_MODIFIED_OPTION_DEFS4_RESULT
.IP \(bu 2
MYSQL_CB_GET_MODIFIED_OPTION_DEFS6
.IP \(bu 2
MYSQL_CB_GET_MODIFIED_OPTION_DEFS6_RESULT
.IP \(bu 2
MYSQL_CB_GET_MODIFIED_SHARED_NETWORKS4
.IP \(bu 2
MYSQL_CB_GET_MODIFIED_SHARED_NETWORKS4_RESULT
.IP \(bu 2
MYSQL_CB_GET_MODIFIED_SHARED_NETWORKS6
.IP \(bu 2
MYSQL_CB_GET_MODIFIED_SHARED_NETWORKS6_RESULT
.IP \(bu 2
MYSQL_CB_GET_MODIFIED_SUBNETS4
.IP \(bu 2
MYSQL_CB_GET_MODIFIED_SUBNETS4_RESULT
.IP \(bu 2
MYSQL_CB_GET_MODIFIED_SUBNETS6
.IP \(bu 2
MYSQL_CB_GET_MODIFIED_SUBNETS6_RESULT
.IP \(bu 2
MYSQL_CB_GET_OPTION4
.IP \(bu 2
MYSQL_CB_GET_OPTION6
.IP \(bu 2
MYSQL_CB_GET_OPTION_DEF4
.IP \(bu 2
MYSQL_CB_GET_OPTION_DEF6
.IP \(bu 2
MYSQL_CB_GET_PORT4
.IP \(bu 2
MYSQL_CB_GET_PORT6
.IP \(bu 2
MYSQL_CB_GET_RECENT_AUDIT_ENTRIES4
.IP \(bu 2
MYSQL_CB_GET_RECENT_AUDIT_ENTRIES4_RESULT
.IP \(bu 2
MYSQL_CB_GET_RECENT_AUDIT_ENTRIES6
.IP \(bu 2
MYSQL_CB_GET_RECENT_AUDIT_ENTRIES6_RESULT
.IP \(bu 2
MYSQL_CB_GET_SERVER4
.IP \(bu 2
MYSQL_CB_GET_SERVER6
.IP \(bu 2
MYSQL_CB_GET_SHARED_NETWORK4
.IP \(bu 2
MYSQL_CB_GET_SHARED_NETWORK6
.IP \(bu 2
MYSQL_CB_GET_SHARED_NETWORK_SUBNETS4
.IP \(bu 2
MYSQL_CB_GET_SHARED_NETWORK_SUBNETS4_RESULT
.IP \(bu 2
MYSQL_CB_GET_SHARED_NETWORK_SUBNETS6
.IP \(bu 2
MYSQL_CB_GET_SHARED_NETWORK_SUBNETS6_RESULT
.IP \(bu 2
MYSQL_CB_GET_SUBNET4_BY_PREFIX
.IP \(bu 2
MYSQL_CB_GET_SUBNET4_BY_SUBNET_ID
.IP \(bu 2
MYSQL_CB_GET_SUBNET6_BY_PREFIX
.IP \(bu 2
MYSQL_CB_GET_SUBNET6_BY_SUBNET_ID
.IP \(bu 2
MYSQL_CB_GET_TYPE4
.IP \(bu 2
MYSQL_CB_GET_TYPE6
.IP \(bu 2
MYSQL_CB_REGISTER_BACKEND_TYPE4
.IP \(bu 2
MYSQL_CB_REGISTER_BACKEND_TYPE6
.IP \(bu 2
MYSQL_CB_TLS_CIPHER
.IP \(bu 2
MYSQL_CB_UNREGISTER_BACKEND_TYPE4
.IP \(bu 2
MYSQL_CB_UNREGISTER_BACKEND_TYPE6
.IP \(bu 2
MYSQL_HB_TLS_CIPHER
.IP \(bu 2
MYSQL_LB_TLS_CIPHER
.IP \(bu 2
MYSQL_LB_UPGRADE_EXTENDED_INFO4
.IP \(bu 2
MYSQL_LB_UPGRADE_EXTENDED_INFO4_ERROR
.IP \(bu 2
MYSQL_LB_UPGRADE_EXTENDED_INFO6
.IP \(bu 2
MYSQL_LB_UPGRADE_EXTENDED_INFO6_ERROR
.IP \(bu 2
PERFMON_DHCP4_SOCKET_RECEIVED_TIME_SUPPORT
.IP \(bu 2
PERFMON_DHCP6_SOCKET_RECEIVED_TIME_SUPPORT
.IP \(bu 2
PGSQL_CB_CREATE_UPDATE_BY_POOL_OPTION4
.IP \(bu 2
PGSQL_CB_CREATE_UPDATE_BY_POOL_OPTION6
.IP \(bu 2
PGSQL_CB_CREATE_UPDATE_BY_PREFIX_OPTION6
.IP \(bu 2
PGSQL_CB_CREATE_UPDATE_BY_SUBNET_ID_OPTION4
.IP \(bu 2
PGSQL_CB_CREATE_UPDATE_BY_SUBNET_ID_OPTION6
.IP \(bu 2
PGSQL_CB_CREATE_UPDATE_CLIENT_CLASS4
.IP \(bu 2
PGSQL_CB_CREATE_UPDATE_CLIENT_CLASS6
.IP \(bu 2
PGSQL_CB_CREATE_UPDATE_GLOBAL_PARAMETER4
.IP \(bu 2
PGSQL_CB_CREATE_UPDATE_GLOBAL_PARAMETER6
.IP \(bu 2
PGSQL_CB_CREATE_UPDATE_OPTION4
.IP \(bu 2
PGSQL_CB_CREATE_UPDATE_OPTION6
.IP \(bu 2
PGSQL_CB_CREATE_UPDATE_OPTION_DEF4
.IP \(bu 2
PGSQL_CB_CREATE_UPDATE_OPTION_DEF6
.IP \(bu 2
PGSQL_CB_CREATE_UPDATE_SERVER4
.IP \(bu 2
PGSQL_CB_CREATE_UPDATE_SERVER6
.IP \(bu 2
PGSQL_CB_CREATE_UPDATE_SHARED_NETWORK4
.IP \(bu 2
PGSQL_CB_CREATE_UPDATE_SHARED_NETWORK6
.IP \(bu 2
PGSQL_CB_CREATE_UPDATE_SHARED_NETWORK_OPTION4
.IP \(bu 2
PGSQL_CB_CREATE_UPDATE_SHARED_NETWORK_OPTION6
.IP \(bu 2
PGSQL_CB_CREATE_UPDATE_SUBNET4
.IP \(bu 2
PGSQL_CB_CREATE_UPDATE_SUBNET6
.IP \(bu 2
PGSQL_CB_DELETE_ALL_CLIENT_CLASSES4
.IP \(bu 2
PGSQL_CB_DELETE_ALL_CLIENT_CLASSES4_RESULT
.IP \(bu 2
PGSQL_CB_DELETE_ALL_CLIENT_CLASSES6
.IP \(bu 2
PGSQL_CB_DELETE_ALL_CLIENT_CLASSES6_RESULT.IP \(bu 2
PGSQL_CB_DELETE_ALL_GLOBAL_PARAMETERS4
.IP \(bu 2
PGSQL_CB_DELETE_ALL_GLOBAL_PARAMETERS4_RESULT
.IP \(bu 2
PGSQL_CB_DELETE_ALL_GLOBAL_PARAMETERS6
.IP \(bu 2
PGSQL_CB_DELETE_ALL_GLOBAL_PARAMETERS6_RESULT
.IP \(bu 2
PGSQL_CB_DELETE_ALL_OPTION_DEFS4
.IP \(bu 2
PGSQL_CB_DELETE_ALL_OPTION_DEFS4_RESULT
.IP \(bu 2
PGSQL_CB_DELETE_ALL_OPTION_DEFS6
.IP \(bu 2
PGSQL_CB_DELETE_ALL_OPTION_DEFS6_RESULT
.IP \(bu 2
PGSQL_CB_DELETE_ALL_SERVERS4
.IP \(bu 2
PGSQL_CB_DELETE_ALL_SERVERS4_RESULT
.IP \(bu 2
PGSQL_CB_DELETE_ALL_SERVERS6
.IP \(bu 2
PGSQL_CB_DELETE_ALL_SERVERS6_RESULT
.IP \(bu 2
PGSQL_CB_DELETE_ALL_SHARED_NETWORKS4
.IP \(bu 2
PGSQL_CB_DELETE_ALL_SHARED_NETWORKS4_RESULT
.IP \(bu 2
PGSQL_CB_DELETE_ALL_SHARED_NETWORKS6
.IP \(bu 2
PGSQL_CB_DELETE_ALL_SHARED_NETWORKS6_RESULT
.IP \(bu 2
PGSQL_CB_DELETE_ALL_SUBNETS4
.IP \(bu 2
PGSQL_CB_DELETE_ALL_SUBNETS4_RESULT
.IP \(bu 2
PGSQL_CB_DELETE_ALL_SUBNETS6
.IP \(bu 2
PGSQL_CB_DELETE_ALL_SUBNETS6_RESULT
.IP \(bu 2
PGSQL_CB_DELETE_BY_POOL_OPTION4
.IP \(bu 2
PGSQL_CB_DELETE_BY_POOL_OPTION4_RESULT
.IP \(bu 2
PGSQL_CB_DELETE_BY_POOL_OPTION6
.IP \(bu 2
PGSQL_CB_DELETE_BY_POOL_OPTION6_RESULT
.IP \(bu 2
PGSQL_CB_DELETE_BY_POOL_PREFIX_OPTION6
.IP \(bu 2
PGSQL_CB_DELETE_BY_POOL_PREFIX_OPTION6_RESULT
.IP \(bu 2
PGSQL_CB_DELETE_BY_PREFIX_SUBNET4
.IP \(bu 2
PGSQL_CB_DELETE_BY_PREFIX_SUBNET4_RESULT
.IP \(bu 2
PGSQL_CB_DELETE_BY_PREFIX_SUBNET6
.IP \(bu 2
PGSQL_CB_DELETE_BY_PREFIX_SUBNET6_RESULT
.IP \(bu 2
PGSQL_CB_DELETE_BY_SUBNET_ID_OPTION4
.IP \(bu 2
PGSQL_CB_DELETE_BY_SUBNET_ID_OPTION4_RESULT
.IP \(bu 2
PGSQL_CB_DELETE_BY_SUBNET_ID_OPTION6
.IP \(bu 2
PGSQL_CB_DELETE_BY_SUBNET_ID_OPTION6_RESULT
.IP \(bu 2
PGSQL_CB_DELETE_BY_SUBNET_ID_SUBNET4
.IP \(bu 2
PGSQL_CB_DELETE_BY_SUBNET_ID_SUBNET4_RESULT
.IP \(bu 2
PGSQL_CB_DELETE_BY_SUBNET_ID_SUBNET6
.IP \(bu 2
PGSQL_CB_DELETE_BY_SUBNET_ID_SUBNET6_RESULT
.IP \(bu 2
PGSQL_CB_DELETE_CLIENT_CLASS4
.IP \(bu 2
PGSQL_CB_DELETE_CLIENT_CLASS4_RESULT
.IP \(bu 2
PGSQL_CB_DELETE_CLIENT_CLASS6
.IP \(bu 2
PGSQL_CB_DELETE_CLIENT_CLASS6_RESULT
.IP \(bu 2
PGSQL_CB_DELETE_GLOBAL_PARAMETER4
.IP \(bu 2
PGSQL_CB_DELETE_GLOBAL_PARAMETER4_RESULT
.IP \(bu 2
PGSQL_CB_DELETE_GLOBAL_PARAMETER6
.IP \(bu 2
PGSQL_CB_DELETE_GLOBAL_PARAMETER6_RESULT
.IP \(bu 2
PGSQL_CB_DELETE_OPTION4
.IP \(bu 2
PGSQL_CB_DELETE_OPTION4_RESULT
.IP \(bu 2
PGSQL_CB_DELETE_OPTION6
.IP \(bu 2
PGSQL_CB_DELETE_OPTION6_RESULT
.IP \(bu 2
PGSQL_CB_DELETE_OPTION_DEF4
.IP \(bu 2
PGSQL_CB_DELETE_OPTION_DEF4_RESULT
.IP \(bu 2
PGSQL_CB_DELETE_OPTION_DEF6
.IP \(bu 2
PGSQL_CB_DELETE_OPTION_DEF6_RESULT
.IP \(bu 2
PGSQL_CB_DELETE_SERVER4
.IP \(bu 2
PGSQL_CB_DELETE_SERVER4_RESULT
.IP \(bu 2
PGSQL_CB_DELETE_SERVER6
.IP \(bu 2
PGSQL_CB_DELETE_SERVER6_RESULT
.IP \(bu 2
PGSQL_CB_DELETE_SHARED_NETWORK4
.IP \(bu 2
PGSQL_CB_DELETE_SHARED_NETWORK4_RESULT
.IP \(bu 2
PGSQL_CB_DELETE_SHARED_NETWORK6
.IP \(bu 2
PGSQL_CB_DELETE_SHARED_NETWORK6_RESULT
.IP \(bu 2
PGSQL_CB_DELETE_SHARED_NETWORK_OPTION4
.IP \(bu 2
PGSQL_CB_DELETE_SHARED_NETWORK_OPTION4_RESULT
.IP \(bu 2
PGSQL_CB_DELETE_SHARED_NETWORK_OPTION6
.IP \(bu 2
PGSQL_CB_DELETE_SHARED_NETWORK_OPTION6_RESULT
.IP \(bu 2
PGSQL_CB_DELETE_SHARED_NETWORK_SUBNETS4
.IP \(bu 2
PGSQL_CB_DELETE_SHARED_NETWORK_SUBNETS4_RESULT
.IP \(bu 2
PGSQL_CB_DELETE_SHARED_NETWORK_SUBNETS6
.IP \(bu 2
PGSQL_CB_DELETE_SHARED_NETWORK_SUBNETS6_RESULT
.IP \(bu 2
PGSQL_CB_GET_ALL_CLIENT_CLASSES4
.IP \(bu 2
PGSQL_CB_GET_ALL_CLIENT_CLASSES4_RESULT
.IP \(bu 2
PGSQL_CB_GET_ALL_CLIENT_CLASSES6
.IP \(bu 2
PGSQL_CB_GET_ALL_CLIENT_CLASSES6_RESULT
.IP \(bu 2
PGSQL_CB_GET_ALL_GLOBAL_PARAMETERS4
.IP \(bu 2
PGSQL_CB_GET_ALL_GLOBAL_PARAMETERS4_RESULT
.IP \(bu 2
PGSQL_CB_GET_ALL_GLOBAL_PARAMETERS6
.IP \(bu 2
PGSQL_CB_GET_ALL_GLOBAL_PARAMETERS6_RESULT
.IP \(bu 2
PGSQL_CB_GET_ALL_OPTIONS4
.IP \(bu 2
PGSQL_CB_GET_ALL_OPTIONS4_RESULT
.IP \(bu 2
PGSQL_CB_GET_ALL_OPTIONS6
.IP \(bu 2
PGSQL_CB_GET_ALL_OPTIONS6_RESULT
.IP \(bu 2
PGSQL_CB_GET_ALL_OPTION_DEFS4
.IP \(bu 2
PGSQL_CB_GET_ALL_OPTION_DEFS4_RESULT
.IP \(bu 2
PGSQL_CB_GET_ALL_OPTION_DEFS6
.IP \(bu 2
PGSQL_CB_GET_ALL_OPTION_DEFS6_RESULT
.IP \(bu 2
PGSQL_CB_GET_ALL_SERVERS4
.IP \(bu 2
PGSQL_CB_GET_ALL_SERVERS4_RESULT
.IP \(bu 2
PGSQL_CB_GET_ALL_SERVERS6
.IP \(bu 2
PGSQL_CB_GET_ALL_SERVERS6_RESULT
.IP \(bu 2
PGSQL_CB_GET_ALL_SHARED_NETWORKS4
.IP \(bu 2
PGSQL_CB_GET_ALL_SHARED_NETWORKS4_RESULT
.IP \(bu 2
PGSQL_CB_GET_ALL_SHARED_NETWORKS6
.IP \(bu 2
PGSQL_CB_GET_ALL_SHARED_NETWORKS6_RESULT
.IP \(bu 2
PGSQL_CB_GET_ALL_SUBNETS4
.IP \(bu 2
PGSQL_CB_GET_ALL_SUBNETS4_RESULT
.IP \(bu 2
PGSQL_CB_GET_ALL_SUBNETS6
.IP \(bu 2
PGSQL_CB_GET_ALL_SUBNETS6_RESULT
.IP \(bu 2
PGSQL_CB_GET_CLIENT_CLASS4
.IP \(bu 2
PGSQL_CB_GET_CLIENT_CLASS6.IP \(bu 2
PGSQL_CB_GET_GLOBAL_PARAMETER4
.IP \(bu 2
PGSQL_CB_GET_GLOBAL_PARAMETER6
.IP \(bu 2
PGSQL_CB_GET_HOST4
.IP \(bu 2
PGSQL_CB_GET_HOST6
.IP \(bu 2
PGSQL_CB_GET_MODIFIED_CLIENT_CLASSES4
.IP \(bu 2
PGSQL_CB_GET_MODIFIED_CLIENT_CLASSES4_RESULT
.IP \(bu 2
PGSQL_CB_GET_MODIFIED_CLIENT_CLASSES6
.IP \(bu 2
PGSQL_CB_GET_MODIFIED_CLIENT_CLASSES6_RESULT
.IP \(bu 2
PGSQL_CB_GET_MODIFIED_GLOBAL_PARAMETERS4
.IP \(bu 2
PGSQL_CB_GET_MODIFIED_GLOBAL_PARAMETERS4_RESULT
.IP \(bu 2
PGSQL_CB_GET_MODIFIED_GLOBAL_PARAMETERS6
.IP \(bu 2
PGSQL_CB_GET_MODIFIED_GLOBAL_PARAMETERS6_RESULT
.IP \(bu 2
PGSQL_CB_GET_MODIFIED_OPTIONS4
.IP \(bu 2
PGSQL_CB_GET_MODIFIED_OPTIONS4_RESULT
.IP \(bu 2
PGSQL_CB_GET_MODIFIED_OPTIONS6
.IP \(bu 2
PGSQL_CB_GET_MODIFIED_OPTIONS6_RESULT
.IP \(bu 2
PGSQL_CB_GET_MODIFIED_OPTION_DEFS4
.IP \(bu 2
PGSQL_CB_GET_MODIFIED_OPTION_DEFS4_RESULT
.IP \(bu 2
PGSQL_CB_GET_MODIFIED_OPTION_DEFS6
.IP \(bu 2
PGSQL_CB_GET_MODIFIED_OPTION_DEFS6_RESULT
.IP \(bu 2
PGSQL_CB_GET_MODIFIED_SHARED_NETWORKS4
.IP \(bu 2
PGSQL_CB_GET_MODIFIED_SHARED_NETWORKS4_RESULT
.IP \(bu 2
PGSQL_CB_GET_MODIFIED_SHARED_NETWORKS6
.IP \(bu 2
PGSQL_CB_GET_MODIFIED_SHARED_NETWORKS6_RESULT
.IP \(bu 2
PGSQL_CB_GET_MODIFIED_SUBNETS4
.IP \(bu 2
PGSQL_CB_GET_MODIFIED_SUBNETS4_RESULT
.IP \(bu 2
PGSQL_CB_GET_MODIFIED_SUBNETS6
.IP \(bu 2
PGSQL_CB_GET_MODIFIED_SUBNETS6_RESULT
.IP \(bu 2
PGSQL_CB_GET_OPTION4
.IP \(bu 2
PGSQL_CB_GET_OPTION6
.IP \(bu 2
PGSQL_CB_GET_OPTION_DEF4
.IP \(bu 2
PGSQL_CB_GET_OPTION_DEF6
.IP \(bu 2
PGSQL_CB_GET_PORT4
.IP \(bu 2
PGSQL_CB_GET_PORT6
.IP \(bu 2
PGSQL_CB_GET_RECENT_AUDIT_ENTRIES4
.IP \(bu 2
PGSQL_CB_GET_RECENT_AUDIT_ENTRIES4_RESULT
.IP \(bu 2
PGSQL_CB_GET_RECENT_AUDIT_ENTRIES6
.IP \(bu 2
PGSQL_CB_GET_RECENT_AUDIT_ENTRIES6_RESULT
.IP \(bu 2
PGSQL_CB_GET_SERVER4
.IP \(bu 2
PGSQL_CB_GET_SERVER6
.IP \(bu 2
PGSQL_CB_GET_SHARED_NETWORK4
.IP \(bu 2
PGSQL_CB_GET_SHARED_NETWORK6
.IP \(bu 2
PGSQL_CB_GET_SHARED_NETWORK_SUBNETS4
.IP \(bu 2
PGSQL_CB_GET_SHARED_NETWORK_SUBNETS4_RESULT
.IP \(bu 2
PGSQL_CB_GET_SHARED_NETWORK_SUBNETS6
.IP \(bu 2
PGSQL_CB_GET_SHARED_NETWORK_SUBNETS6_RESULT
.IP \(bu 2
PGSQL_CB_GET_SUBNET4_BY_PREFIX
.IP \(bu 2
PGSQL_CB_GET_SUBNET4_BY_SUBNET_ID
.IP \(bu 2
PGSQL_CB_GET_SUBNET6_BY_PREFIX
.IP \(bu 2
PGSQL_CB_GET_SUBNET6_BY_SUBNET_ID
.IP \(bu 2
PGSQL_CB_GET_TYPE4
.IP \(bu 2
PGSQL_CB_GET_TYPE6
.IP \(bu 2
PGSQL_CB_REGISTER_BACKEND_TYPE4
.IP \(bu 2
PGSQL_CB_REGISTER_BACKEND_TYPE6
.IP \(bu 2
PGSQL_CB_UNREGISTER_BACKEND_TYPE4
.IP \(bu 2
PGSQL_CB_UNREGISTER_BACKEND_TYPE6
.IP \(bu 2
PGSQL_LB_UPGRADE_EXTENDED_INFO4
.IP \(bu 2
PGSQL_LB_UPGRADE_EXTENDED_INFO4_ERROR
.IP \(bu 2
PGSQL_LB_UPGRADE_EXTENDED_INFO6
.IP \(bu 2
PGSQL_LB_UPGRADE_EXTENDED_INFO6_ERROR
.IP \(bu 2
PING_CHECK_CHANNEL_MALFORMED_PACKET_RECEIVED
.IP \(bu 2
PING_CHECK_CHANNEL_SOCKET_CLOSED
.IP \(bu 2
PING_CHECK_CHANNEL_SOCKET_OPENED
.IP \(bu 2
PING_CHECK_CHANNEL_STOP
.IP \(bu 2
PING_CHECK_DUPLICATE_CHECK
.IP \(bu 2
PING_CHECK_MGR_LEASE_FREE_TO_USE
.IP \(bu 2
PING_CHECK_MGR_RECEIVED_ECHO_REPLY
.IP \(bu 2
PING_CHECK_MGR_START_PING_CHECK
.IP \(bu 2
PING_CHECK_MGR_STOPPING
.IP \(bu 2
RADIUS_ACCESS_CACHE_GET
.IP \(bu 2
RADIUS_ACCESS_CACHE_INSERT
.IP \(bu 2
RADIUS_ACCESS_CONFLICT
.IP \(bu 2
RADIUS_ACCESS_DROP_PARKED_QUERY
.IP \(bu 2
RADIUS_ACCESS_GET_IDENTIFIER
.IP \(bu 2
RADIUS_ACCESS_MAX_PENDING_REQUESTS
.IP \(bu 2
RADIUS_ACCESS_RESUME_PARKED_QUERY
.IP \(bu 2
RADIUS_ACCESS_SUBNET_RESELECT
.IP \(bu 2
RADIUS_ACCOUNTING_ASYNC
.IP \(bu 2
RADIUS_ACCOUNTING_ASYNC_FAILED
.IP \(bu 2
RADIUS_ACCOUNTING_ASYNC_SUCCEED
.IP \(bu 2
RADIUS_ACCOUNTING_NO_HISTORY
.IP \(bu 2
RADIUS_ACCOUNTING_STATUS
.IP \(bu 2
RADIUS_ACCOUNTING_STATUS_FAILED
.IP \(bu 2
RADIUS_ACCOUNTING_STATUS_SUCCEED
.IP \(bu 2
RADIUS_ACCOUNTING_SYNC
.IP \(bu 2
RADIUS_ACCOUNTING_SYNC_FAILED
.IP \(bu 2
RADIUS_ACCOUNTING_SYNC_SUCCEED
.IP \(bu 2
RADIUS_AUTHENTICATION_ASYNC
.IP \(bu 2
RADIUS_AUTHENTICATION_ASYNC_ACCEPTED
.IP \(bu 2
RADIUS_AUTHENTICATION_ASYNC_FAILED
.IP \(bu 2
RADIUS_AUTHENTICATION_ASYNC_REJECTED
.IP \(bu 2
RADIUS_AUTHENTICATION_STATUS
.IP \(bu 2
RADIUS_AUTHENTICATION_STATUS_FAILED
.IP \(bu 2
RADIUS_AUTHENTICATION_STATUS_SUCCEED
.IP \(bu 2
RADIUS_AUTHENTICATION_SYNC
.IP \(bu 2
RADIUS_AUTHENTICATION_SYNC_ACCEPTED
.IP \(bu 2
RADIUS_AUTHENTICATION_SYNC_FAILED
.IP \(bu 2
RADIUS_AUTHENTICATION_SYNC_REJECTED
.IP \(bu 2
RADIUS_BACKEND_GET4
.IP \(bu 2
RADIUS_BACKEND_GET6.IP \(bu 2
RADIUS_DECODE_MESSAGE
.IP \(bu 2
RADIUS_ENCODE_MESSAGE
.IP \(bu 2
RADIUS_EXCHANGE_RECEIVED_ACCESS_ACCEPT
.IP \(bu 2
RADIUS_EXCHANGE_RECEIVED_ACCESS_REJECT
.IP \(bu 2
RADIUS_EXCHANGE_RECEIVED_ACCOUNTING_RESPONSE
.IP \(bu 2
RADIUS_EXCHANGE_RECEIVED_RESPONSE
.IP \(bu 2
RADIUS_TCP_EXCHANGE_RECEIVED
.IP \(bu 2
RADIUS_TCP_EXCHANGE_SEND
.IP \(bu 2
RADIUS_TCP_EXCHANGE_START
.IP \(bu 2
RADIUS_TCP_EXCHANGE_SUCCESS
.IP \(bu 2
RADIUS_TLS_STATUS
.IP \(bu 2
RADIUS_TLS_STATUS_FAILED
.IP \(bu 2
RADIUS_TLS_STATUS_SUCCEED
.IP \(bu 2
RADIUS_UDP_EXCHANGE_RECEIVED
.IP \(bu 2
RADIUS_UDP_EXCHANGE_SEND_NEW
.IP \(bu 2
RADIUS_UDP_EXCHANGE_SEND_RETRY
.IP \(bu 2
RADIUS_UDP_EXCHANGE_SENT
.IP \(bu 2
RADIUS_UDP_EXCHANGE_START
.IP \(bu 2
RADIUS_UDP_EXCHANGE_SYNC_RETURN
.IP \(bu 2
RADIUS_UDP_EXCHANGE_TERMINATE
.IP \(bu 2
RBAC_CONFIGURED_ACLS
.IP \(bu 2
RBAC_CONFIGURED_COMMANDS
.IP \(bu 2
RBAC_CONFIGURED_ROLES
.IP \(bu 2
RBAC_TRACE_HTTP_AUTH_ACCEPT
.IP \(bu 2
RBAC_TRACE_HTTP_AUTH_BAD_BODY_TYPE
.IP \(bu 2
RBAC_TRACE_HTTP_AUTH_BAD_COMMAND_TYPE
.IP \(bu 2
RBAC_TRACE_HTTP_AUTH_COMMAND
.IP \(bu 2
RBAC_TRACE_HTTP_AUTH_DISABLED
.IP \(bu 2
RBAC_TRACE_HTTP_AUTH_EMPTY_BODY
.IP \(bu 2
RBAC_TRACE_HTTP_AUTH_NO_COMMAND
.IP \(bu 2
RBAC_TRACE_HTTP_AUTH_NO_JSON
.IP \(bu 2
RBAC_TRACE_HTTP_AUTH_NO_REQUEST
.IP \(bu 2
RBAC_TRACE_HTTP_AUTH_NO_TLS_REJECT
.IP \(bu 2
RBAC_TRACE_HTTP_AUTH_RESPONSE
.IP \(bu 2
RBAC_TRACE_HTTP_AUTH_ROLE
.IP \(bu 2
RBAC_TRACE_HTTP_RESPONSE_BAD_BODY_TYPE
.IP \(bu 2
RBAC_TRACE_HTTP_RESPONSE_CONTEXT
.IP \(bu 2
RBAC_TRACE_HTTP_RESPONSE_DISABLED
.IP \(bu 2
RBAC_TRACE_HTTP_RESPONSE_EMPTY_BODY
.IP \(bu 2
RBAC_TRACE_HTTP_RESPONSE_EMPTY_BODY_LIST
.IP \(bu 2
RBAC_TRACE_HTTP_RESPONSE_MODIFIED
.IP \(bu 2
RBAC_TRACE_HTTP_RESPONSE_NO_ARGUMENTS
.IP \(bu 2
START_REKEY_TIMER
.IP \(bu 2
START_RETRY_TIMER
.IP \(bu 2
STAT_CMDS_LEASE4_ORPHANED_STATS
.IP \(bu 2
STAT_CMDS_LEASE6_ORPHANED_STATS
.IP \(bu 2
TCP_CLIENT_BAD_SERVER_RESPONSE_RECEIVED
.IP \(bu 2
TCP_CLIENT_MT_STARTED
.IP \(bu 2
TCP_CLIENT_SERVER_RESPONSE_RECEIVED
.IP \(bu 2
TCP_CONNECTION_SHUTDOWN
.IP \(bu 2
TCP_CONNECTION_STOP
.IP \(bu 2
TCP_SERVER_CLIENT_REQUEST_RECEIVED
.IP \(bu 2
TCP_SERVER_RESPONSE_SEND
.IP \(bu 2
TKEY_EXCHANGE_ANSWER_CLASS
.IP \(bu 2
TKEY_EXCHANGE_NOT_A_RESPONSE
.IP \(bu 2
TKEY_EXCHANGE_OUT_TOKEN_NOT_EMPTY
.IP \(bu 2
TKEY_EXCHANGE_RDATA_COUNT
.IP \(bu 2
TKEY_EXCHANGE_RECEIVE_MESSAGE
.IP \(bu 2
TKEY_EXCHANGE_RESPONSE_TTL
.IP \(bu 2
TKEY_EXCHANGE_SEND_MESSAGE
.IP \(bu 2
TKEY_EXCHANGE_VALID
.IP \(bu 2
TKEY_EXCHANGE_VERIFIED
.IP \(bu 2
TLS_SERVER_RESPONSE_SEND
.UNINDENT.SS "پیام‌های چاپ‌شده در debuglevel 45"
.INDENT 0.0
.IP \(bu 2
DHCP4_DHCP4O6_SUBNET_SELECTED
.IP \(bu 2
DHCP4_SUBNET_DYNAMICALLY_CHANGED
.IP \(bu 2
DHCP4_SUBNET_SELECTED
.IP \(bu 2
DHCP6_SUBNET_DYNAMICALLY_CHANGED
.IP \(bu 2
DHCP6_SUBNET_SELECTED
.IP \(bu 2
HOOKS_CALLOUTS_BEGIN
.IP \(bu 2
HOOKS_CALLOUTS_COMPLETE
.IP \(bu 2
HOOKS_CALLOUTS_REMOVED
.IP \(bu 2
HOOKS_CALLOUT_REGISTRATION
.IP \(bu 2
HOOKS_LIBRARY_MULTI_THREADING_COMPATIBLE
.IP \(bu 2
HOOKS_LIBRARY_VERSION
.IP \(bu 2
HOOKS_STD_CALLOUT_REGISTERED
.IP \(bu 2
HOSTS_CFG_GET_ALL_ADDRESS4_COUNT
.IP \(bu 2
HOSTS_CFG_GET_ALL_ADDRESS6_COUNT
.IP \(bu 2
HOSTS_CFG_GET_ALL_COUNT
.IP \(bu 2
HOSTS_CFG_GET_ALL_HOSTNAME_COUNT
.IP \(bu 2
HOSTS_CFG_GET_ALL_HOSTNAME_SUBNET_ID4_COUNT
.IP \(bu 2
HOSTS_CFG_GET_ALL_HOSTNAME_SUBNET_ID6_COUNT
.IP \(bu 2
HOSTS_CFG_GET_ALL_IDENTIFIER_COUNT
.IP \(bu 2
HOSTS_CFG_GET_ALL_SUBNET_ID4_COUNT
.IP \(bu 2
HOSTS_CFG_GET_ALL_SUBNET_ID6_COUNT
.IP \(bu 2
HOSTS_CFG_GET_ALL_SUBNET_ID_ADDRESS4_COUNT
.IP \(bu 2
HOSTS_CFG_GET_ALL_SUBNET_ID_ADDRESS6_COUNT
.IP \(bu 2
HOSTS_CFG_GET_ONE_SUBNET_ID_ADDRESS4_HOST
.IP \(bu 2
HOSTS_CFG_GET_ONE_SUBNET_ID_ADDRESS4_NULL
.IP \(bu 2
HOSTS_CFG_GET_ONE_SUBNET_ID_ADDRESS6_HOST
.IP \(bu 2
HOSTS_CFG_GET_ONE_SUBNET_ID_ADDRESS6_NULL
.IP \(bu 2
HOSTS_CFG_GET_ONE_SUBNET_ID_IDENTIFIER_HOST
.IP \(bu 2
HOSTS_CFG_GET_ONE_SUBNET_ID_IDENTIFIER_NULL
.IP \(bu 2
HOSTS_MGR_ALTERNATE_GET4_SUBNET_ID_IDENTIFIER_HOST
.IP \(bu 2
HOSTS_MGR_ALTERNATE_GET4_SUBNET_ID_IDENTIFIER_NULL
.IP \(bu 2
HOSTS_MGR_ALTERNATE_GET6_SUBNET_ID_IDENTIFIER_HOST
.IP \(bu 2
HOSTS_MGR_ALTERNATE_GET6_SUBNET_ID_IDENTIFIER_NULL
.IP \(bu 2
HOST_CACHE_ADD
.IP \(bu 2
HOST_CACHE_ADD_DUPLICATE
.IP \(bu 2
HOST_CACHE_DEL_SUBNET_ID_ADDRESS4
.IP \(bu 2
HOST_CACHE_DEL_SUBNET_ID_ADDRESS6
.IP \(bu 2
HOST_CACHE_DEL_SUBNET_ID_IDENTIFIER4
.IP \(bu 2
HOST_CACHE_DEL_SUBNET_ID_IDENTIFIER6
.IP \(bu 2
HOST_CACHE_GET_ONE_PREFIX_HOST
.IP \(bu 2
HOST_CACHE_GET_ONE_SUBNET_ID_ADDRESS4_HOST
.IP \(bu 2
HOST_CACHE_GET_ONE_SUBNET_ID_ADDRESS6_HOST
.IP \(bu 2
HOST_CACHE_GET_ONE_SUBNET_ID_IDENTIFIER_HOST
.IP \(bu 2
HTTP_BAD_CLIENT_REQUEST_RECEIVED_DETAILS
.IP \(bu 2
HTTP_BAD_SERVER_RESPONSE_RECEIVED_DETAILS
.IP \(bu 2
HTTP_CLIENT_REQUEST_RECEIVED_DETAILS
.IP \(bu 2
HTTP_SERVER_RESPONSE_RECEIVED_DETAILS
.IP \(bu 2
HTTP_SERVER_RESPONSE_SEND_DETAILS
.IP \(bu 2
TCP_CLIENT_BAD_SERVER_RESPONSE_RECEIVED_DETAILS
.UNINDENT
.SS "پیام‌های چاپ‌شده در debuglevel 50"
.INDENT 0.0
.IP \(bu 2
ALLOC_ENGINE_V6_EXTEND_LEASE
.IP \(bu 2
ASIODNS_READ_TIMEOUT
.IP \(bu 2
DHCP4_ADDITIONAL_CLASS_EVAL_RESULT
.IP \(bu 2
DHCP4_BUFFER_UNPACK
.IP \(bu 2
DHCP4_BUFFER_WAIT_SIGNAL
.IP \(bu 2
DHCP4_CLIENTID_IGNORED_FOR_LEASES
.IP \(bu 2
DHCP4_CLIENT_FQDN_PROCESS
.IP \(bu 2
DHCP4_CLIENT_FQDN_SCRUBBED_EMPTY
.IP \(bu 2
DHCP4_CLIENT_HOSTNAME_MALFORMED
.IP \(bu 2
DHCP4_CLIENT_HOSTNAME_PROCESS
.IP \(bu 2
DHCP4_CLIENT_HOSTNAME_SCRUBBED_EMPTY
.IP \(bu 2
DHCP4_DEFERRED_OPTION_MISSING
.IP \(bu 2
DHCP4_DEFERRED_OPTION_UNPACK_FAIL
.IP \(bu 2
DHCP4_DHCP4O6_BAD_PACKET
.IP \(bu 2
DHCP4_DHCP4O6_RECEIVE_FAIL
.IP \(bu 2
DHCP4_DHCP4O6_RECEIVING
.IP \(bu 2
DHCP4_DHCP4O6_SUBNET_SELECTION_FAILED
.IP \(bu 2
DHCP4_DISCOVER
.IP \(bu 2
DHCP4_EMPTY_HOSTNAME
.IP \(bu 2
DHCP4_HOOK_BUFFER_RCVD_SKIP
.IP \(bu 2
DHCP4_INFORM_DIRECT_REPLY
.IP \(bu 2
DHCP4_NO_LEASE_INIT_REBOOT
.IP \(bu 2
DHCP4_PACKET_NAK_0002
.IP \(bu 2
DHCP4_PACKET_NAK_0003
.IP \(bu 2
DHCP4_PACKET_NAK_0004
.IP \(bu 2
DHCP4_PACKET_OPTIONS_SKIPPED
.IP \(bu 2
DHCP4_PACKET_PACK
.IP \(bu 2
DHCP4_RELEASE
.IP \(bu 2
DHCP4_RELEASE_FAIL
.IP \(bu 2
DHCP4_RELEASE_FAIL_NO_LEASE
.IP \(bu 2
DHCP4_RELEASE_FAIL_WRONG_CLIENT
.IP \(bu 2
DHCP4_REQUEST
.IP \(bu 2
DHCP4_RESPONSE_HOSTNAME_GENERATE
.IP \(bu 2
DHCP4_SUBNET_SELECTION_FAILED
.IP \(bu 2
DHCP4_UNKNOWN_ADDRESS_REQUESTED
.IP \(bu 2
DHCP6_ADDITIONAL_CLASS_EVAL_RESULT
.IP \(bu 2
DHCP6_ADD_GLOBAL_STATUS_CODE
.IP \(bu 2
DHCP6_ADD_STATUS_CODE_FOR_IA
.IP \(bu 2
DHCP6_BUFFER_UNPACK
.IP \(bu 2
DHCP6_BUFFER_WAIT_SIGNAL
.IP \(bu 2
DHCP6_CLIENT_FQDN_SCRUBBED_EMPTY
.IP \(bu 2
DHCP6_DDNS_CREATE_ADD_NAME_CHANGE_REQUEST
.IP \(bu 2
DHCP6_DDNS_GENERATE_FQDN
.IP \(bu 2
DHCP6_DDNS_RECEIVE_FQDN
.IP \(bu 2
DHCP6_DDNS_REMOVE_OLD_LEASE_FQDN
.IP \(bu 2
DHCP6_DDNS_RESPONSE_FQDN_DATA
.IP \(bu 2
DHCP6_DECLINE_PROCESS_IA
.IP \(bu 2
DHCP6_DHCP4O6_RECEIVE_FAIL
.IP \(bu 2
DHCP6_DHCP4O6_RECEIVING
.UNINDENT.IP \(bu 2
DHCP6_HOOK_BUFFER_RCVD_SKIP
.IP \(bu 2
DHCP6_HOOK_DECLINE_SKIP
.IP \(bu 2
DHCP6_LEASE_ADVERT
.IP \(bu 2
DHCP6_LEASE_ADVERT_FAIL
.IP \(bu 2
DHCP6_LEASE_ALLOC
.IP \(bu 2
DHCP6_LEASE_ALLOC_FAIL
.IP \(bu 2
DHCP6_PACKET_OPTIONS_SKIPPED
.IP \(bu 2
DHCP6_PD_LEASE_ADVERT
.IP \(bu 2
DHCP6_PD_LEASE_ADVERT_FAIL
.IP \(bu 2
DHCP6_PD_LEASE_ALLOC
.IP \(bu 2
DHCP6_PD_LEASE_ALLOC_FAIL
.IP \(bu 2
DHCP6_PROCESS_IA_NA_EXTEND
.IP \(bu 2
DHCP6_PROCESS_IA_NA_RELEASE
.IP \(bu 2
DHCP6_PROCESS_IA_NA_REQUEST
.IP \(bu 2
DHCP6_PROCESS_IA_NA_SOLICIT
.IP \(bu 2
DHCP6_PROCESS_IA_PD_EXTEND
.IP \(bu 2
DHCP6_PROCESS_IA_PD_REQUEST
.IP \(bu 2
DHCP6_PROCESS_IA_PD_SOLICIT
.IP \(bu 2
DHCP6_RAPID_COMMIT
.IP \(bu 2
DHCP6_SUBNET_SELECTION_FAILED
.IP \(bu 2
DHCPSRV_DHCP_DDNS_NCR_SENT
.IP \(bu 2
DHCPSRV_EVAL_RESULT
.IP \(bu 2
DHCPSRV_MEMFILE_ADD_ADDR4
.IP \(bu 2
DHCPSRV_MEMFILE_ADD_ADDR6
.IP \(bu 2
DHCPSRV_MEMFILE_COMMIT
.IP \(bu 2
DHCPSRV_MEMFILE_DELETE_ADDR4
.IP \(bu 2
DHCPSRV_MEMFILE_DELETE_ADDR6
.IP \(bu 2
DHCPSRV_MEMFILE_DELETE_EXPIRED_RECLAIMED4
.IP \(bu 2
DHCPSRV_MEMFILE_DELETE_EXPIRED_RECLAIMED6
.IP \(bu 2
DHCPSRV_MEMFILE_DELETE_EXPIRED_RECLAIMED_START
.IP \(bu 2
DHCPSRV_MEMFILE_GET4
.IP \(bu 2
DHCPSRV_MEMFILE_GET6
.IP \(bu 2
DHCPSRV_MEMFILE_GET6_DUID
.IP \(bu 2
DHCPSRV_MEMFILE_GET_ADDR4
.IP \(bu 2
DHCPSRV_MEMFILE_GET_ADDR6
.IP \(bu 2
DHCPSRV_MEMFILE_GET_CLIENTID
.IP \(bu 2
DHCPSRV_MEMFILE_GET_EXPIRED4
.IP \(bu 2
DHCPSRV_MEMFILE_GET_EXPIRED6
.IP \(bu 2
DHCPSRV_MEMFILE_GET_HOSTNAME4
.IP \(bu 2
DHCPSRV_MEMFILE_GET_HOSTNAME6
.IP \(bu 2
DHCPSRV_MEMFILE_GET_HWADDR4
.IP \(bu 2
DHCPSRV_MEMFILE_GET_HWADDR6
.IP \(bu 2
DHCPSRV_MEMFILE_GET_IAID_DUID
.IP \(bu 2
DHCPSRV_MEMFILE_GET_IAID_SUBID_DUID
.IP \(bu 2
DHCPSRV_MEMFILE_GET_PAGE4
.IP \(bu 2
DHCPSRV_MEMFILE_GET_PAGE6
.IP \(bu 2
DHCPSRV_MEMFILE_GET_RELAYID4
.IP \(bu 2
DHCPSRV_MEMFILE_GET_RELAYID6
.IP \(bu 2
DHCPSRV_MEMFILE_GET_REMOTEID4
.IP \(bu 2
DHCPSRV_MEMFILE_GET_REMOTEID6
.IP \(bu 2
DHCPSRV_MEMFILE_GET_SUBID4
.IP \(bu 2
DHCPSRV_MEMFILE_GET_SUBID6
.IP \(bu 2
DHCPSRV_MEMFILE_GET_SUBID_CLIENTID
.IP \(bu 2
DHCPSRV_MEMFILE_GET_SUBID_HWADDR
.IP \(bu 2
DHCPSRV_MEMFILE_GET_SUBID_PAGE6
.IP \(bu 2
DHCPSRV_MEMFILE_ROLLBACK
.IP \(bu 2
DHCPSRV_MEMFILE_UPDATE_ADDR4
.IP \(bu 2
DHCPSRV_MEMFILE_UPDATE_ADDR6
.IP \(bu 2
DHCPSRV_QUEUE_NCR_SKIP
.IP \(bu 2
DHCPSRV_TEMPLATE_EVAL_RESULT
.IP \(bu 2
DHCPSRV_TIMERMGR_RUN_TIMER_OPERATION
.IP \(bu 2
DHCP_DDNS_INVALID_RESPONSE
.IP \(bu 2
DHCP_DDNS_STARTING_TRANSACTION
.IP \(bu 2
DHCP_DDNS_UPDATE_REQUEST_SENT
.IP \(bu 2
DHCP_DDNS_UPDATE_RESPONSE_RECEIVED
.IP \(bu 2
FUZZ_DATA_READ
.IP \(bu 2
FUZZ_SEND
.IP \(bu 2
HTTPS_REQUEST_RECEIVE_START
.IP \(bu 2
HTTP_CLIENT_REQUEST_SEND
.IP \(bu 2
HTTP_CLIENT_REQUEST_TIMEOUT_OCCURRED
.IP \(bu 2
HTTP_CONNECTION_HANDSHAKE_START
.IP \(bu 2
HTTP_IDLE_CONNECTION_TIMEOUT_OCCURRED
.IP \(bu 2
HTTP_REQUEST_RECEIVE_START
.IP \(bu 2
LEGAL_LOG_MYSQL_GET_VERSION
.IP \(bu 2
LEGAL_LOG_MYSQL_INSERT_LOG
.IP \(bu 2
LEGAL_LOG_MYSQL_TLS_CIPHER
.IP \(bu 2
LEGAL_LOG_PGSQL_GET_VERSION
.IP \(bu 2
LEGAL_LOG_PGSQL_INSERT_LOG
.IP \(bu 2
MYSQL_HB_DB_GET_VERSION
.IP \(bu 2
MYSQL_LB_ADD_ADDR4
.IP \(bu 2
MYSQL_LB_ADD_ADDR6
.IP \(bu 2
MYSQL_LB_COMMIT
.IP \(bu 2
MYSQL_LB_DELETED_EXPIRED_RECLAIMED
.IP \(bu 2
MYSQL_LB_DELETED_SUBNET4_ID
.IP \(bu 2
MYSQL_LB_DELETED_SUBNET6_ID
.IP \(bu 2
MYSQL_LB_DELETE_ADDR4
.IP \(bu 2
MYSQL_LB_DELETE_ADDR6
.IP \(bu 2
MYSQL_LB_DELETE_EXPIRED_RECLAIMED4
.IP \(bu 2
MYSQL_LB_DELETE_EXPIRED_RECLAIMED6
.IP \(bu 2
MYSQL_LB_GET4
.IP \(bu 2
MYSQL_LB_GET6
.IP \(bu 2
MYSQL_LB_GET_ADDR4
.IP \(bu 2
MYSQL_LB_GET_ADDR6
.IP \(bu 2
MYSQL_LB_GET_CLIENTID
.IP \(bu 2
MYSQL_LB_GET_DUID
.IP \(bu 2
MYSQL_LB_GET_EXPIRED4
.IP \(bu 2
MYSQL_LB_GET_EXPIRED6
.IP \(bu 2
MYSQL_LB_GET_HOSTNAME4
.IP \(bu 2
MYSQL_LB_GET_HOSTNAME6
.IP \(bu 2
MYSQL_LB_GET_HWADDR4.IP \(bu 2
MYSQL_LB_GET_HWADDR6
.IP \(bu 2
MYSQL_LB_GET_IAID_DUID
.IP \(bu 2
MYSQL_LB_GET_IAID_SUBID_DUID
.IP \(bu 2
MYSQL_LB_GET_PAGE4
.IP \(bu 2
MYSQL_LB_GET_PAGE6
.IP \(bu 2
MYSQL_LB_GET_RELAYID4
.IP \(bu 2
MYSQL_LB_GET_RELAYID6
.IP \(bu 2
MYSQL_LB_GET_REMOTEID4
.IP \(bu 2
MYSQL_LB_GET_REMOTEID6
.IP \(bu 2
MYSQL_LB_GET_STATE4
.IP \(bu 2
MYSQL_LB_GET_STATE6
.IP \(bu 2
MYSQL_LB_GET_STATE_SUBID4
.IP \(bu 2
MYSQL_LB_GET_STATE_SUBID6
.IP \(bu 2
MYSQL_LB_GET_SUBID4
.IP \(bu 2
MYSQL_LB_GET_SUBID6
.IP \(bu 2
MYSQL_LB_GET_SUBID_CLIENTID
.IP \(bu 2
MYSQL_LB_GET_SUBID_HWADDR
.IP \(bu 2
MYSQL_LB_GET_SUBID_PAGE6
.IP \(bu 2
MYSQL_LB_GET_VERSION
.IP \(bu 2
MYSQL_LB_ROLLBACK
.IP \(bu 2
MYSQL_LB_SFLQ_CREATE_POOL4
.IP \(bu 2
MYSQL_LB_SFLQ_CREATE_POOL6
.IP \(bu 2
MYSQL_LB_SFLQ_PICK_LEASE4
.IP \(bu 2
MYSQL_LB_SFLQ_PICK_LEASE6
.IP \(bu 2
MYSQL_LB_SFLQ_POOL4_DELETE
.IP \(bu 2
MYSQL_LB_SFLQ_POOL4_GET_ALL
.IP \(bu 2
MYSQL_LB_SFLQ_POOL4_GET_BY_RANGE
.IP \(bu 2
MYSQL_LB_SFLQ_POOL4_GET_BY_SUBNET
.IP \(bu 2
MYSQL_LB_SFLQ_POOL6_DELETE
.IP \(bu 2
MYSQL_LB_SFLQ_POOL6_GET_ALL
.IP \(bu 2
MYSQL_LB_SFLQ_POOL6_GET_BY_RANGE
.IP \(bu 2
MYSQL_LB_SFLQ_POOL6_GET_BY_SUBNET
.IP \(bu 2
MYSQL_LB_UPDATE_ADDR4
.IP \(bu 2
MYSQL_LB_UPDATE_ADDR6
.IP \(bu 2
MYSQL_LB_UPGRADE_EXTENDED_INFO4_PAGE
.IP \(bu 2
MYSQL_LB_UPGRADE_EXTENDED_INFO6_PAGE
.IP \(bu 2
PERFMON_DHCP4_PKT_EVENTS
.IP \(bu 2
PERFMON_DHCP4_PKT_PROCESS_ERROR
.IP \(bu 2
PERFMON_DHCP6_PKT_EVENTS
.IP \(bu 2
PERFMON_DHCP6_PKT_PROCESS_ERROR
.IP \(bu 2
PGSQL_HB_DB_GET_VERSION
.IP \(bu 2
PGSQL_LB_ADD_ADDR4
.IP \(bu 2
PGSQL_LB_ADD_ADDR6
.IP \(bu 2
PGSQL_LB_COMMIT
.IP \(bu 2
PGSQL_LB_DELETED_SUBNET4_ID
.IP \(bu 2
PGSQL_LB_DELETED_SUBNET6_ID
.IP \(bu 2
PGSQL_LB_DELETE_ADDR4
.IP \(bu 2
PGSQL_LB_DELETE_ADDR6
.IP \(bu 2
PGSQL_LB_DELETE_EXPIRED_RECLAIMED4
.IP \(bu 2
PGSQL_LB_DELETE_EXPIRED_RECLAIMED6
.IP \(bu 2
PGSQL_LB_GET4
.IP \(bu 2
PGSQL_LB_GET6
.IP \(bu 2
PGSQL_LB_GET_ADDR4
.IP \(bu 2
PGSQL_LB_GET_ADDR6
.IP \(bu 2
PGSQL_LB_GET_CLIENTID
.IP \(bu 2
PGSQL_LB_GET_DUID
.IP \(bu 2
PGSQL_LB_GET_EXPIRED4
.IP \(bu 2
PGSQL_LB_GET_EXPIRED6
.IP \(bu 2
PGSQL_LB_GET_HOSTNAME4
.IP \(bu 2
PGSQL_LB_GET_HOSTNAME6
.IP \(bu 2
PGSQL_LB_GET_HWADDR4
.IP \(bu 2
PGSQL_LB_GET_HWADDR6
.IP \(bu 2
PGSQL_LB_GET_IAID_DUID
.IP \(bu 2
PGSQL_LB_GET_IAID_SUBID_DUID
.IP \(bu 2
PGSQL_LB_GET_PAGE4
.IP \(bu 2
PGSQL_LB_GET_PAGE6
.IP \(bu 2
PGSQL_LB_GET_RELAYID4
.IP \(bu 2
PGSQL_LB_GET_RELAYID6
.IP \(bu 2
PGSQL_LB_GET_REMOTEID4
.IP \(bu 2
PGSQL_LB_GET_REMOTEID6
.IP \(bu 2
PGSQL_LB_GET_STATE4
.IP \(bu 2
PGSQL_LB_GET_STATE6
.IP \(bu 2
PGSQL_LB_GET_STATE_SUBID4
.IP \(bu 2
PGSQL_LB_GET_STATE_SUBID6
.IP \(bu 2
PGSQL_LB_GET_SUBID4
.IP \(bu 2
PGSQL_LB_GET_SUBID6
.IP \(bu 2
PGSQL_LB_GET_SUBID_CLIENTID
.IP \(bu 2
PGSQL_LB_GET_SUBID_HWADDR
.IP \(bu 2
PGSQL_LB_GET_SUBID_PAGE6
.IP \(bu 2
PGSQL_LB_GET_VERSION
.IP \(bu 2
PGSQL_LB_ROLLBACK
.IP \(bu 2
PGSQL_LB_SFLQ_CREATE_POOL4
.IP \(bu 2
PGSQL_LB_SFLQ_CREATE_POOL6
.IP \(bu 2
PGSQL_LB_SFLQ_PICK_LEASE4
.IP \(bu 2
PGSQL_LB_SFLQ_PICK_LEASE6
.IP \(bu 2
PGSQL_LB_SFLQ_POOL4_DELETE
.IP \(bu 2
PGSQL_LB_SFLQ_POOL4_GET_ALL
.IP \(bu 2
PGSQL_LB_SFLQ_POOL4_GET_BY_RANGE
.IP \(bu 2
PGSQL_LB_SFLQ_POOL4_GET_BY_SUBNET
.IP \(bu 2
PGSQL_LB_SFLQ_POOL6_DELETE
.IP \(bu 2
PGSQL_LB_SFLQ_POOL6_GET_ALL
.IP \(bu 2
PGSQL_LB_SFLQ_POOL6_GET_BY_RANGE
.IP \(bu 2
PGSQL_LB_SFLQ_POOL6_GET_BY_SUBNET
.IP \(bu 2
PGSQL_LB_UPDATE_ADDR4
.IP \(bu 2
PGSQL_LB_UPDATE_ADDR6
.IP \(bu 2
PGSQL_LB_UPGRADE_EXTENDED_INFO4_PAGE
.IP \(bu 2
PGSQL_LB_UPGRADE_EXTENDED_INFO6_PAGE
.IP \(bu 2
PING_CHECK_CHANNEL_ECHO_REPLY_RECEIVED
.IP \(bu 2
PING_CHECK_CHANNEL_ECHO_REQUEST_SENT
.IP \(bu 2
PING_CHECK_MGR_NEXT_ECHO_SCHEDULED.IP \(bu 2
PING_CHECK_MGR_RECEIVED_UNEXPECTED_ECHO_REPLY
.IP \(bu 2
PING_CHECK_MGR_RECEIVED_UNEXPECTED_UNREACHABLE_MSG
.IP \(bu 2
PING_CHECK_MGR_RECEIVED_UNREACHABLE_MSG
.IP \(bu 2
PING_CHECK_MGR_REPLY_TIMEOUT_EXPIRED
.IP \(bu 2
PING_CHECK_NO_LEASE_OR_LEASE_REUSED
.IP \(bu 2
TCP_CLIENT_REQUEST_SEND
.IP \(bu 2
TCP_CONNECTION_REJECTED_BY_FILTER
.IP \(bu 2
TCP_IDLE_CONNECTION_TIMEOUT_OCCURRED
.IP \(bu 2
TCP_REQUEST_RECEIVE_START
.IP \(bu 2
TLS_CONNECTION_HANDSHAKE_START
.IP \(bu 2
TLS_REQUEST_RECEIVE_START
.UNINDENT
.SS پیام‌های چاپ‌شده در debuglevel 55
.INDENT 0.0
.IP \(bu 2
ALLOC_ENGINE_V4_REUSE_EXPIRED_LEASE_DATA
.IP \(bu 2
ALLOC_ENGINE_V6_EXTEND_LEASE_DATA
.IP \(bu 2
ALLOC_ENGINE_V6_EXTEND_NEW_LEASE_DATA
.IP \(bu 2
ALLOC_ENGINE_V6_REUSE_EXPIRED_LEASE_DATA
.IP \(bu 2
DHCP4_CLIENT_FQDN_DATA
.IP \(bu 2
DHCP4_CLIENT_HOSTNAME_DATA
.IP \(bu 2
DHCP4_CLIENT_NAME_PROC_FAIL
.IP \(bu 2
DHCP4_DHCP4O6_RESPONSE_DATA
.IP \(bu 2
DHCP4_DHCP4O6_SUBNET_DATA
.IP \(bu 2
DHCP4_GENERATE_FQDN
.IP \(bu 2
DHCP4_QUERY_DATA
.IP \(bu 2
DHCP4_RECOVERED_STASHED_RELAY_AGENT_INFO
.IP \(bu 2
DHCP4_RESERVED_HOSTNAME_ASSIGNED
.IP \(bu 2
DHCP4_RESPONSE_DATA
.IP \(bu 2
DHCP4_RESPONSE_FQDN_DATA
.IP \(bu 2
DHCP4_RESPONSE_HOSTNAME_DATA
.IP \(bu 2
DHCP4_SUBNET_DATA
.IP \(bu 2
DHCP6_DDNS_FQDN_GENERATED
.IP \(bu 2
DHCP6_DHCP4O6_RESPONSE_DATA
.IP \(bu 2
DHCP6_LEASE_DATA
.IP \(bu 2
DHCP6_QUERY_DATA
.IP \(bu 2
DHCP6_RESPONSE_DATA
.IP \(bu 2
DHCP6_SUBNET_DATA
.IP \(bu 2
DHCPSRV_DDNS_TTL_TOO_LARGE
.IP \(bu 2
DHCPSRV_DDNS_TTL_TOO_SMALL
.IP \(bu 2
DHCPSRV_MEMFILE_LEASE_LOAD
.IP \(bu 2
DHCPSRV_QUEUE_NCR
.IP \(bu 2
DHCP_DDNS_AT_MAX_TRANSACTIONS
.IP \(bu 2
DHCP_DDNS_FWD_REQUEST_IGNORED
.IP \(bu 2
DHCP_DDNS_NO_ELIGIBLE_JOBS
.IP \(bu 2
DHCP_DDNS_QUEUE_MGR_QUEUE_RECEIVE
.IP \(bu 2
DHCP_DDNS_REQUEST_DROPPED
.IP \(bu 2
DHCP_DDNS_REV_REQUEST_IGNORED
.IP \(bu 2
EVAL_DEBUG_AND
.IP \(bu 2
EVAL_DEBUG_BRANCH
.IP \(bu 2
EVAL_DEBUG_CONCAT
.IP \(bu 2
EVAL_DEBUG_EQUAL
.IP \(bu 2
EVAL_DEBUG_HEXSTRING
.IP \(bu 2
EVAL_DEBUG_IFELSE_FALSE
.IP \(bu 2
EVAL_DEBUG_IFELSE_TRUE
.IP \(bu 2
EVAL_DEBUG_INT16TOTEXT
.IP \(bu 2
EVAL_DEBUG_INT32TOTEXT
.IP \(bu 2
EVAL_DEBUG_INT8TOTEXT
.IP \(bu 2
EVAL_DEBUG_IPADDRESS
.IP \(bu 2
EVAL_DEBUG_IPADDRESSTOTEXT
.IP \(bu 2
EVAL_DEBUG_LCASE
.IP \(bu 2
EVAL_DEBUG_MATCH
.IP \(bu 2
EVAL_DEBUG_MEMBER
.IP \(bu 2
EVAL_DEBUG_NOT
.IP \(bu 2
EVAL_DEBUG_OPTION
.IP \(bu 2
EVAL_DEBUG_OR
.IP \(bu 2
EVAL_DEBUG_PKT
.IP \(bu 2
EVAL_DEBUG_PKT4
.IP \(bu 2
EVAL_DEBUG_PKT6
.IP \(bu 2
EVAL_DEBUG_POP_AND_BRANCH_FALSE
.IP \(bu 2
EVAL_DEBUG_POP_OR_BRANCH_FALSE
.IP \(bu 2
EVAL_DEBUG_POP_OR_BRANCH_TRUE
.IP \(bu 2
EVAL_DEBUG_RELAY6
.IP \(bu 2
EVAL_DEBUG_RELAY6_RANGE
.IP \(bu 2
EVAL_DEBUG_SPLIT
.IP \(bu 2
EVAL_DEBUG_SPLIT_DELIM_EMPTY
.IP \(bu 2
EVAL_DEBUG_SPLIT_EMPTY
.IP \(bu 2
EVAL_DEBUG_SPLIT_FIELD_OUT_OF_RANGE
.IP \(bu 2
EVAL_DEBUG_STRING
.IP \(bu 2
EVAL_DEBUG_SUBSTRING
.IP \(bu 2
EVAL_DEBUG_SUBSTRING_EMPTY
.IP \(bu 2
EVAL_DEBUG_SUBSTRING_RANGE
.IP \(bu 2
EVAL_DEBUG_TOHEXSTRING
.IP \(bu 2
EVAL_DEBUG_UCASE
.IP \(bu 2
EVAL_DEBUG_UINT16TOTEXT
.IP \(bu 2
EVAL_DEBUG_UINT32TOTEXT
.IP \(bu 2
EVAL_DEBUG_UINT8TOTEXT
.IP \(bu 2
EVAL_DEBUG_VENDOR_CLASS_DATA
.IP \(bu 2
EVAL_DEBUG_VENDOR_CLASS_DATA_NOT_FOUND
.IP \(bu 2
EVAL_DEBUG_VENDOR_CLASS_ENTERPRISE_ID
.IP \(bu 2
EVAL_DEBUG_VENDOR_CLASS_ENTERPRISE_ID_MISMATCH
.IP \(bu 2
EVAL_DEBUG_VENDOR_CLASS_EXISTS
.IP \(bu 2
EVAL_DEBUG_VENDOR_CLASS_NO_OPTION
.IP \(bu 2
EVAL_DEBUG_VENDOR_ENTERPRISE_ID
.IP \(bu 2
EVAL_DEBUG_VENDOR_ENTERPRISE_ID_MISMATCH
.IP \(bu 2
EVAL_DEBUG_VENDOR_EXISTS
.IP \(bu 2
EVAL_DEBUG_VENDOR_NO_OPTION
.IP \(bu 2
HOOKS_ALL_CALLOUTS_DEREGISTERED
.IP \(bu 2
HOOKS_CALLOUT_CALLED
.IP \(bu 2
HOOKS_CALLOUT_DEREGISTERED
.IP \(bu 2
HOSTS_CFG_GET_ALL_ADDRESS4_HOST
.IP \(bu 2
HOSTS_CFG_GET_ALL_ADDRESS6_HOST
.IP \(bu 2
HOSTS_CFG_GET_ALL_HOST.IP \(bu 2
HOSTS_CFG_GET_ALL_HOSTNAME_HOST
.IP \(bu 2
HOSTS_CFG_GET_ALL_HOSTNAME_SUBNET_ID4_HOST
.IP \(bu 2
HOSTS_CFG_GET_ALL_HOSTNAME_SUBNET_ID6_HOST
.IP \(bu 2
HOSTS_CFG_GET_ALL_IDENTIFIER_HOST
.IP \(bu 2
HOSTS_CFG_GET_ALL_SUBNET_ID4_HOST
.IP \(bu 2
HOSTS_CFG_GET_ALL_SUBNET_ID6_HOST
.IP \(bu 2
HOSTS_CFG_GET_ALL_SUBNET_ID_ADDRESS4_HOST
.IP \(bu 2
HOSTS_CFG_GET_ALL_SUBNET_ID_ADDRESS6_HOST
.IP \(bu 2
HOSTS_CFG_GET_ONE_PREFIX_HOST
.IP \(bu 2
HOSTS_CFG_GET_ONE_PREFIX_NULL
.IP \(bu 2
HTTP_CLIENT_REQUEST_SEND_DETAILS
.IP \(bu 2
HTTP_DATA_RECEIVED
.IP \(bu 2
LIMITS_PACKET_WIIH_SUBNET_ID_RATE_NO_SUBNET
.IP \(bu 2
LIMITS_PACKET_WITH_CLIENT_CLASSES_RATE_LIMIT_HONORED
.IP \(bu 2
LIMITS_PACKET_WITH_SUBNET_ID_RATE_LIMIT_HONORED
.IP \(bu 2
NETCONF_CONFIG_CHANGED_DETAIL
.IP \(bu 2
NETCONF_GET_CONFIG
.IP \(bu 2
NETCONF_SET_CONFIG
.IP \(bu 2
NETCONF_UPDATE_CONFIG
.IP \(bu 2
NETCONF_VALIDATE_CONFIG
.IP \(bu 2
TCP_DATA_RECEIVED
.IP \(bu 2
TCP_DATA_SENT
.UNINDENT
.SS پیام‌های چاپ‌شده در debuglevel 70
.INDENT 0.0
.IP \(bu 2
ASIODNS_FETCH_COMPLETED
.UNINDENT
.SH "مثال‌های پیکربندی (CONFIGURATION EXAMPLES)"
.sp
این مجموعه‌ای از مثال‌های پیکربندی موجود در \fBdoc/examples\fP در کدهای منبع Kea نسخهٔ 3.2.0 است\&.
.SS ddns
.SS ddns/all\-keys\-netconf.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// هشدار: این پیکربندی نمونه برای استفاده در محیط عملیاتی در نظر گرفته نشده است.
// کارساز DHCP\-DDNS در Kea ممکن است این پیکربندی را رد کند زیرا ممکن است
// شامل پارامترهای پیکربندی ناسازگار با یکدیگر (mutually exclusive) باشد.
//
// هدف اصلی این فایل نمونه ارائهٔ فهرستی جامع از پارامترهای پشتیبانی‌شده
// توسط کارساز Kea DHCP\-DDNS به همراه شرح مختصری از هر پارامتر است.
//
// این نسخهٔ پایدار برای YANG استفاده می‌شود زیرا نمی‌خواهیم هر بار که کلیدواژه‌ای
// به نحو (syntax) افزوده می‌شود، کد و مدل‌ها را به‌روزرسانی کنیم.
{
    // پیکربندی کارساز Kea DHCP\-DDNS از اینجا آغاز می‌شود.
    \(dqDhcpDdns\(dq: {

    // پارامترهای عمومی

    // آدرس IP که D2 در آن به درخواست‌های به‌روزرسانی گوش می‌دهد.
    // پیش‌فرض 127.0.0.1 است.
    \(dqip\-address\(dq: \(dq127.0.0.1\(dq,

    // درگاهی که D2 روی آن به درخواست‌های به‌روزرسانی گوش می‌دهد.
    // پیش‌فرض 53001 است.
    \(dqport\(dq: 53001,

    // حداکثر زمانی که منتظر پاسخ یک کارساز DNS خواهیم ماند.
    // واحد بر حسب میلی‌ثانیه، پیش‌فرض 100ms است.
    \(dqdns\-server\-timeout\(dq : 100,

    // پروتکل مورداستفاده برای Name Change Requests از یک کارساز Kea DHCP.
    // در حال حاضر فقط \(aqUDP\(aq پشتیبانی می‌شود.
    \(dqncr\-protocol\(dq: \(dqUDP\(dq,

    // قالب مورداستفاده برای Name Change Requests از یک کارساز Kea DHCP.
    // در حال حاضر فقط \(aqJSON\(aq پشتیبانی می‌شود.
    \(dqncr\-format\(dq: \(dqJSON\(dq,

    // پارامترهای پیکربندی سوکت کنترل فرمان برای کارساز Kea DHCP\-DDNS.
    \(dqcontrol\-socket\(dq: {

        // مکان فایل سوکت دامنهٔ یونیکس (UNIX domain socket) که کارساز DHCP\-DDNS
        // برای دریافت فرمان‌های کنترلی از مدیر محلی کارساز استفاده می‌کند.
        \(dqsocket\-name\(dq: \(dqkea\-ddns\-ctrl\-socket\(dq,

        // نوع سوکت کنترلی مورداستفاده توسط کارساز Kea DHCP\-DDNS.
        // سوکت \(aqunix\(aq در حال حاضر تنها نوع پشتیبانی‌شده است.
        \(dqsocket\-type\(dq: \(dqunix\(dq
    },

    // فهرست کتابخانه‌های hook و پارامترهای پیکربندی خاص آن‌ها
    // که باید توسط کارساز Kea DHCP\-DDNS بارگذاری شوند.
    \(dqhooks\-libraries\(dq: [
        {
            // مکان کتابخانهٔ hook برای بارگذاری.
            \(dqlibrary\(dq: \(dqddns\-server\-commands.so\(dq,

            // پارامترهای پیکربندی خاص کتابخانهٔ hook.
            \(dqparameters\(dq: { }
        }
    ],

    // بخش Forward DDNS (DNS پویا).
    \(dqforward\-ddns\(dq: {

        // فهرست دامنه‌های DDNS.
        \(dqddns\-domains\(dq: [
            {
                // نام زون (الزامی).
                \(dqname\(dq: \(dqexample.com.\(dq,

                // نام کلید TSIG مورداستفاده برای محافظت از به‌روزرسانی‌های DNS
                // برای نام‌های موجود در دامنه.
                \(dqkey\-name\(dq: \(dqd2.md5.key\(dq,

                // فهرست کارسازهای DNS که به‌روزرسانی‌های DNS به آن‌ها ارسال می‌شود.
                \(dqdns\-servers\(dq: [
                    {
                        // آدرس IP کارساز DNS (الزامی).
                        \(dqip\-address\(dq: \(dq2001:db8:1::10\(dq,

                        // درگاه UDP کارساز DNS. پیش‌فرض 53 (سرویس DNS) است.
                        \(dqport\(dq: 7802,

                        // نام کلید TSIG مورداستفاده برای محافظت از به‌روزرسانی‌های DNS
                        // ارسال‌شده به کارساز DNS.
                        \(dqkey\-name\(dq: \(dqd2.sha1.key\(dq
                    }
                ]
            }
        ]
    },

    // بخش Reverse DDNS (DNS معکوس پویا).
    \(dqreverse\-ddns\(dq: {

        // فهرست دامنه‌های DDNS.
        \(dqddns\-domains\(dq: [
            {
                // نام زون (الزامی).
                \(dqname\(dq: \(dq2.0.192.in\-addr.arpa.\(dq,

                // نام کلید TSIG مورداستفاده برای محافظت از به‌روزرسانی‌های DNS
                // برای نام‌های موجود در دامنه.
                \(dqkey\-name\(dq: \(dqd2.sha1.key\(dq,

                // فهرست کارسازهای DNS که به‌روزرسانی‌های DNS به آن‌ها ارسال می‌شود.
                \(dqdns\-servers\(dq: [
                    {
                        // آدرس IP کارساز DNS (الزامی).
                        \(dqip\-address\(dq: \(dq172.16.1.1\(dq,

                        // درگاه UDP کارساز DNS. پیش‌فرض 53 (سرویس DNS) است.
                        \(dqport\(dq: 5301,

                        // نام کلید TSIG مورداستفاده برای محافظت از به‌روزرسانی‌های DNS
                        // ارسال‌شده به کارساز DNS.
                        \(dqkey\-name\(dq: \(dqd2.md5.key\(dq
                    }
                ]
            }
        ]
    },

    // فهرست کلیدهای TSIG مورداستفاده برای محافظت از به‌روزرسانی‌های DNS.
    \(dqtsig\-keys\(dq: [
        {
            // نام کلید TSIG (الزامی).
            \(dqname\(dq: \(dqd2.md5.key\(dq,

            // الگوریتم کلید TSIG (الزامی).
            // مقدار باید یک نام الگوریتم معتبر باشد، مانند
            // HMAC\-MD5, HMAC\-SHA1, HMAC\-SHA224, ...
            \(dqalgorithm\(dq: \(dqHMAC\-MD5\(dq,

            // تعداد بیت‌ها در دایجست (digest). پیش‌فرض 0 است که به معنای
            // استفاده از تمام بیت‌های ارائه‌شده توسط الگوریتم است. مقادیر بسیار کوتاه
            // (بسته به الگوریتم) رد می‌شوند.
            \(dqdigest\-bits\(dq: 0,

            // کلید مخفی کلید TSIG (الزامی) در قالب base\-64.
            \(dqsecret\(dq: \(dqLSWXnfkKZjdPJI5QxlpnfQ==\(dq
        }
    ],

    // فهرست لاگرهای مورداستفاده توسط کارسازهایی که از این فایل پیکربندی استفاده می‌کنند.
    \(dqloggers\(dq: [
        {
            // سطح دیباگ، مقداری بین 0..99. هرچه مقدار بزرگ‌تر باشد
            // لاگ دیباگ با جزئیات بیشتری خواهد بود.
            \(dqdebuglevel\(dq: 99,

            // نام لاگر.
            \(dqname\(dq: \(dqkea\-dhcp\-ddns\(dq,

            // چگونگی خروجی لاگ را پیکربندی می‌کند.
            \(dqoutput\-options\(dq: [
                {
                    // مشخص می‌کند آیا لاگ باید در فایل فلاش (flush) شود یا خیر.
                    \(dqflush\(dq: true,

                    // حداکثر اندازهٔ فایل را قبل از چرخش (rotation) مشخص می‌کند.
                    \(dqmaxsize\(dq: 10240000,

                    // حداکثر تعداد فایل‌های چرخش‌یافته برای نگه‌داری را مشخص می‌کند.
                    \(dqmaxver\(dq: 1,

                    // مقصد ثبت لاگ را مشخص می‌کند.
                    \(dqoutput\(dq: \(dqstdout\(dq,

                    // محتوای مدخل لاگ را مشخص می‌کند
                    \(dqpattern\(dq: \(dq%D{%Y\-%m\-%d %H:%M:%S.%q} %\-5p [%c/%i] %m\en\(dq
                }
            ],

            // شدت لاگ‌برداری را مشخص می‌کند، یعنی \(dqERROR\(dq، \(dqWARN\(dq، \(dqINFO\(dq، \(dqDEBUG\(dq.
            \(dqseverity\(dq: \(dqINFO\(dq
        }
    ],

    // برای کاربرد user\-contextها مثال sample1 را ببینید.
    \(dquser\-context\(dq: { }
}

}
.EE
.UNINDENT
.UNINDENT.SS ddns/all\-keys.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// هشدار: این پیکربندی نمونه برای استفاده در محیط عملیاتی در نظر گرفته نشده است.
// سرور Kea DHCP\-DDNS ممکن است این پیکربندی را رد کند زیرا ممکن است
// شامل پارامترهای پیکربندی ناسازگار با یکدیگر (مانعة‌الجمع) باشد.
//
// هدف اصلی این فایل نمونه، ارائه فهرستی جامع از پارامترهای پشتیبانی‌شده
// توسط سرور Kea DHCP\-DDNS به همراه توضیح مختصری از هر پارامتر است.
//
// این نسخه فعلی باید به‌روز باشد، یعنی کلیدواژه‌های جدید باید هم‌زمان
// با مشخصات تجزیه‌کننده (parser) به این فایل اضافه شوند.
{
    // پیکربندی سرور Kea DHCP\-DDNS از اینجا آغاز می‌شود.
    \(dqDhcpDdns\(dq: {

    // پارامترهای سراسری

    // نشانی IP که D2 برای درخواست‌های به‌روزرسانی روی آن گوش می‌دهد.
    // پیش‌فرض 127.0.0.1 است.
    \(dqip\-address\(dq: \(dq127.0.0.1\(dq,

    // درگاهی که D2 برای درخواست‌های به‌روزرسانی روی آن گوش می‌دهد.
    // پیش‌فرض 53001 است.
    \(dqport\(dq: 53001,

    // بیشینه زمانی که منتظر پاسخ سرور DNS می‌مانیم.
    // واحد آن میلی‌ثانیه است، پیش‌فرض 100ms است.
    \(dqdns\-server\-timeout\(dq : 100,

    // پروتکل مورد استفاده برای Name Change Requests از یک سرور Kea DHCP.
    // در حال حاضر فقط \(aqUDP\(aq پشتیبانی می‌شود.
    \(dqncr\-protocol\(dq: \(dqUDP\(dq,

    // قالب مورد استفاده برای Name Change Requests از یک سرور Kea DHCP.
    // در حال حاضر فقط \(aqJSON\(aq پشتیبانی می‌شود.
    \(dqncr\-format\(dq: \(dqJSON\(dq,

    // پارامترهای پیکربندی سوکت کنترل فرمان برای سرور Kea DHCP\-DDNS.
    \(dqcontrol\-sockets\(dq: [
        {
            // نوع سوکت کنترل استفاده‌شده توسط سرور Kea DHCP\-DDNS.
            // باید unix، http یا https باشد.
            \(dqsocket\-type\(dq: \(dqunix\(dq,

            // مکان فایل سوکت دامنه یونیکس (UNIX domain socket) که سرور
            // DHCP\-DDNS برای دریافت فرمان‌های کنترلی از مدیر محلی سرور
            // استفاده می‌کند.
            \(dqsocket\-name\(dq: \(dqkea\-ddns\-ctrl\-socket\(dq
        },
        {
            // نوع سوکت کنترل استفاده‌شده توسط سرور Kea DHCP\-DDNS.
            // باید unix، http یا https باشد.
            \(dqsocket\-type\(dq: \(dqhttps\(dq,

            // نشانی سوکت HTTPS که سرور Kea DHCP\-DDNS باید برای پرس‌وجوهای
            // ورودی روی آن گوش دهد.
            \(dqsocket\-address\(dq: \(dq127.0.0.1\(dq,

            // درگاه سوکت HTTPS که سرور Kea DHCP\-DDNS باید برای پرس‌وجوهای
            // ورودی روی آن گوش دهد.
            \(dqsocket\-port\(dq: 8053,

            // لنگر اعتماد TLS (مرجع صدور گواهی یا CA). این مورد یک نام
            // فایل یا مسیر دایرکتوری است. همراه با سایر پارامترهای TLS
            // فقط برای سوکت کنترل نوع https معنادار است.
            \(dqtrust\-anchor\(dq: \(dqmy\-ca\(dq,

            // نام فایل گواهی سرور TLS.
            \(dqcert\-file\(dq: \(dqmy\-cert\(dq,

            // نام فایل کلید خصوصی سرور TLS.
            \(dqkey\-file\(dq: \(dqmy\-key\(dq,

            // پرچم الزام گواهی‌های کلاینت TLS. مقدار پیش‌فرض true
            // است و به معنای الزام گواهی کلاینت است. مقدار false به این
            // معنی است که اختیاری هستند.
            \(dqcert\-required\(dq: true,

            // احراز هویت اختیاری.
            \(dqauthentication\(dq: {
                // نوع احراز هویت الزامی. تنها مقدار پشتیبانی‌شده
                // basic برای احراز هویت پایه HTTP است.
                \(dqtype\(dq: \(dqbasic\(dq,

                // قلمرو (realm) احراز هویت پایه HTTP یک پارامتر اختیاری
                // است. پیش‌فرض آن
                // \(dqkea\-dhcp\-ddns\-server\(dq است.
                \(dqrealm\(dq: \(dqkea\-dhcp\-ddns\-server\(dq,

                // از این پارامتر اختیاری می‌توان برای تعیین یک پیشوند مشترک
                // برای فایل‌های مدیریت اعتبارنامه‌های کلاینت استفاده کرد.
                \(dqdirectory\(dq: \(dq/usr/local/share/kea/kea\-creds\(dq,

                // این فهرست شناسه‌های کاربری و گذرواژه‌های مورد استفاده برای
                // احراز هویت پایه HTTP را مشخص می‌کند. در صورت خالی بودن یا
                // عدم وجود، هر کلاینتی مجاز شمرده می‌شود.
                \(dqclients\(dq: [
                    // این مورد یک کلاینت مجاز را مشخص می‌کند.
                    {
                        // شناسه کاربری نباید خالی باشد یا نویسه
                        // \(aq:\(aq را در بر داشته باشد. این یک پارامتر الزامی است.
                        \(dquser\(dq: \(dqadmin\(dq,

                        // اگر گذرواژه مشخص نشود، یک گذرواژه خالی
                        // استفاده می‌شود.
                        \(dqpassword\(dq: \(dq1234\(dq
                    },

                    // این مورد یک کلاینت پنهان را مشخص می‌کند.
                    {
                        // شناسه کاربری محتوای فایل
                        // /usr/local/share/kea/kea\-creds/hiddenu است.
                        \(dquser\-file\(dq: \(dqhiddenu\(dq,

                        // گذرواژه محتوای فایل
                        // /usr/local/share/kea/kea\-creds/hiddenp است.
                        \(dqpassword\-file\(dq: \(dqhiddenp\(dq
                    },

                    // این مورد یک کلاینت پنهان را با استفاده از یک راز در یک فایل
                    // مشخص می‌کند.
                    {
                        // این راز محتوای فایل
                        // /usr/local/share/kea/kea\-creds/hiddens است که باید
                        // در قالب <user\-id>:<password> باشد.
                        \(dqpassword\-file\(dq: \(dqhiddens\(dq
                    }
                ]
            }
        }
    ],

    // فهرست کتابخانه‌های قلاب (hook) و پارامترهای پیکربندی خاص آن‌ها
    // که باید توسط سرور Kea DHCP\-DDNS بارگذاری شوند.
    \(dqhooks\-libraries\(dq: [
        {
            // مکان کتابخانه قلاب جهت بارگذاری.
            \(dqlibrary\(dq: \(dqddns\-server\-commands.so\(dq,

            // پارامترهای پیکربندی مختص کتابخانه قلاب.
            \(dqparameters\(dq: { }
        }
    ],

    // سرور DDNS مستقیم (Forward DDNS / Dynamic DNS).
    \(dqforward\-ddns\(dq: {

        // فهرست دامنه‌های DDNS.
        \(dqddns\-domains\(dq: [
            {
                // نام ناحیه (الزامی).
                \(dqname\(dq: \(dqexample.com.\(dq,

                // نام کلید TSIG استفاده‌شده برای محافظت از به‌روزرسانی‌های DNS
                // برای نام‌های موجود در دامنه.
                \(dqkey\-name\(dq: \(dqd2.md5.key\(dq,

                // فهرست سرورهای DNS که به‌روزرسانی‌های DNS به آن‌ها ارسال می‌شود.
                \(dqdns\-servers\(dq: [
                    {
                        // نشانی IP سرور DNS (الزامی).
                        \(dqip\-address\(dq: \(dq2001:db8:1::10\(dq,

                        // درگاه UDP سرور DNS. پیش‌فرض 53 (سرویس DNS) است.
                        \(dqport\(dq: 7802,

                        // نام کلید TSIG استفاده‌شده برای محافظت از به‌روزرسانی‌های DNS
                        // ارسال‌شده به سرور DNS.
                        \(dqkey\-name\(dq: \(dqd2.sha1.key\(dq
                    }
                ]
            }
        ]
    },

    // سرور DDNS معکوس (Reverse DDNS / Dynamic DNS).
    \(dqreverse\-ddns\(dq: {

        // فهرست دامنه‌های DDNS.
        \(dqddns\-domains\(dq: [
            {
                // نام ناحیه (الزامی).
                \(dqname\(dq: \(dq2.0.192.in\-addr.arpa.\(dq,

                // نام کلید TSIG استفاده‌شده برای محافظت از به‌روزرسانی‌های DNS
                // برای نام‌های موجود در دامنه.
                \(dqkey\-name\(dq: \(dqd2.sha1.key\(dq,

                // فهرست سرورهای DNS که به‌روزرسانی‌های DNS به آن‌ها ارسال می‌شود.
                \(dqdns\-servers\(dq: [
                    {
                        // نشانی IP سرور DNS (الزامی).
                        \(dqip\-address\(dq: \(dq172.16.1.1\(dq,

                        // درگاه UDP سرور DNS. پیش‌فرض 53 (سرویس DNS) است.
                        \(dqport\(dq: 5301,

                        // نام کلید TSIG استفاده‌شده برای محافظت از به‌روزرسانی‌های DNS
                        \(dqkey\-name\(dq: \(dqd2.md5.key\(dq
                    }
                ]
            }
        ]
    },

    // فهرست کلیدهای TSIG استفاده‌شده برای محافظت از به‌روزرسانی‌های DNS.
    \(dqtsig\-keys\(dq: [
        {
            // نام کلید TSIG (الزامی).
            \(dqname\(dq: \(dqd2.md5.key\(dq,

            // الگوریتم کلید TSIG (الزامی).
            // این مقدار باید یک نام الگوریتم معتبر باشد، به عنوان مثال:
            // HMAC\-MD5, HMAC\-SHA1, HMAC\-SHA224, ...
            \(dqalgorithm\(dq: \(dqHMAC\-MD5\(dq,

            // تعداد بیت‌ها در دایجست (digest). پیش‌فرض 0 است که به معنای
            // استفاده از تمام بیت‌های ارائه‌شده توسط الگوریتم است. مقادیر بیش از حد کوتاه
            // (بسته به الگوریتم) رد می‌شوند.
            \(dqdigest\-bits\(dq: 0,

            // رمز (secret) کلید TSIG (الزامی) در قالب base\-64.
            \(dqsecret\(dq: \(dqLSWXnfkKZjdPJI5QxlpnfQ==\(dq
        },
        {
            \(dqname\(dq: \(dqd2.sha1.key\(dq,
            \(dqalgorithm\(dq: \(dqHMAC\-SHA1\(dq,

            // یک جایگزین برای secret: مشخص کردن فایلی که رمز در آن
            // یافت می‌شود؛ یعنی رمز، محتوای فایل است.
            \(dqsecret\-file\(dq: \(dq/usr/local/share/kea/d2\-sha1\-secret\(dq
        }
    ],

    // فهرست ثبت‌کننده‌های وقایع (loggers) مورد استفاده توسط سرورهایی که از این فایل پیکربندی استفاده می‌کنند.
    \(dqloggers\(dq: [
        {
            // سطح اشکال‌زدایی (Debug level)، مقداری بین 0..99. هرچه مقدار
            // بزرگ‌تر باشد، گزارش اشکال‌زدایی با جزئیات بیشتری خواهد بود.
            \(dqdebuglevel\(dq: 99,

            // نام ثبت‌کننده وقایع (logger).
            \(dqname\(dq: \(dqkea\-dhcp\-ddns\(dq,

            // چگونگی خروجی گزارش وقایع را پیکربندی می‌کند.
            \(dqoutput\-options\(dq: [
                {
                    // مشخص می‌کند که آیا گزارش باید بلافاصله روی فایل تخلیه (flush) شود یا خیر.
                    \(dqflush\(dq: true,

                    // بیشینه اندازه فایل قبل از چرخش (rotate) فایل را مشخص می‌کند.
                    \(dqmaxsize\(dq: 10240000,

                    // بیشینه تعداد فایل‌های چرخیده نگه‌داری‌شده را مشخص می‌کند.
                    \(dqmaxver\(dq: 1,

                    // مقصد ثبت وقایع را مشخص می‌کند.
                    \(dqoutput\(dq: \(dqstdout\(dq,

                    // محتوای مدخل ثبت وقایع را مشخص می‌کند.
                    \(dqpattern\(dq: \(dq%D{%Y\-%m\-%d %H:%M:%S.%q} %\-5p [%c/%i] %m\en\(dq
                }
            ],

            // سطح اهمیت ثبت وقایع را مشخص می‌کند؛ یعنی \(dqERROR\(dq، \(dqWARN\(dq، \(dqINFO\(dq، \(dqDEBUG\(dq.
            \(dqseverity\(dq: \(dqINFO\(dq
        }
    ],

    // برای استفاده از user\-contexts به مثال sample1 نگاه کنید.
    \(dquser\-context\(dq: { }
}

}
.EE
.UNINDENT
.UNINDENT.SS ddns/comments.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک فایل پیکربندی نمونه برای D2، پردازشگر DHCP\-DDNS در Kea است.
// این فایل از کامنت‌های تعبیه‌شده استفاده می‌کند که به‌جای حذف‌شدن در مرحله تحلیل لغوی،
// درون اشیاء پیکربندی در user\-contextها گنجانده می‌شوند.

{
\(dqDhcpDdns\(dq:
{

    // حوزه سراسری
    \(dqcomment\(dq: \(dqA DHCP\-DDNS server\(dq,
    \(dqip\-address\(dq: \(dq127.0.0.1\(dq,
    \(dqport\(dq: 53001,
    \(dqdns\-server\-timeout\(dq : 1000,

    // در سوکت‌های کنترلی.
    \(dqcontrol\-sockets\(dq: [
        {
            \(dqsocket\-type\(dq: \(dqunix\(dq,
            \(dqsocket\-name\(dq: \(dqkea\-ddns\-ctrl\-socket\(dq,
            \(dquser\-context\(dq: { \(dqcomment\(dq: \(dqIndirect comment\(dq }
        },
        {
            \(dqcomment\(dq: \(dqHTTP control socket\(dq,
            \(dqsocket\-type\(dq: \(dqhttp\(dq,
            \(dqsocket\-address\(dq: \(dq::1\(dq,
            \(dqsocket\-port\(dq: 8053,
            // در احراز هویت
            \(dqauthentication\(dq: {
                \(dqcomment\(dq: \(dqbasic HTTP authentication\(dq,
                \(dqtype\(dq: \(dqbasic\(dq,
                // در کلاینت‌های احراز هویت پایه HTTP
                \(dqclients\(dq: [ {
                    \(dqcomment\(dq: \(dqadmin is authorized\(dq,
                    \(dquser\(dq: \(dqadmin\(dq,
                    \(dqpassword\(dq: \(dq1234\(dq
                } ]
            }
        }
    ],

    \(dqforward\-ddns\(dq:
    {
        \(dqddns\-domains\(dq:
        [
            // در دامنه DDNS
            {
                \(dqcomment\(dq: \(dqDdnsDomain for zone \(aqfour.example.com.\(aq\(dq,
                \(dqname\(dq: \(dqfour.example.com.\(dq,
                \(dqkey\-name\(dq: \(dqd2.md5.key\(dq,
                // در سرور DNS
                \(dqdns\-servers\(dq:
                [
                    {
                        \(dqcomment\(dq: \(dqfour.example.com. server\(dq,
                        \(dqip\-address\(dq: \(dq172.16.1.1\(dq
                    }
                ]
            }
        ]
    },

    // در کلید TSIG
    \(dqtsig\-keys\(dq:
    [
        {
            \(dqcomment\(dq: \(dqfour.example.com. key\(dq,
            \(dqname\(dq: \(dqd2.md5.key\(dq,
            \(dqalgorithm\(dq: \(dqHMAC\-MD5\(dq,
            \(dqsecret\(dq: \(dqLSWXnfkKZjdPJI5QxlpnfQ==\(dq
        }
    ],

    // در لاگرها (loggers)
    \(dqloggers\(dq: [
        {
            \(dqcomment\(dq: \(dqA logger\(dq,
            \(dqname\(dq: \(dqkea\-dhcp\-ddns\(dq,
            \(dqseverity\(dq: \(dqinfo\(dq
        }
    ]
}

}
.EE
.UNINDENT
.UNINDENT
.SS ddns/gss\-tsig.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک فایل پیکربندی نمونه برای D2، پردازشگر DHCP\-DDNS در Kea است.
// این پیکربندی از کتابخانه قلاب (hook library) GSS\-TSIG استفاده می‌کند.
{
\(dqDhcpDdns\(dq: {
    // پارامترهای زیر برای دریافت NCRها (NameChangeRequests) از سرور محلی
    // Kea DHCP استفاده می‌شوند. اطمینان حاصل کنید که kea\-dhcp4 و kea\-dhcp6
    // شما با این مقادیر مطابقت داشته باشند.
    \(dqip\-address\(dq: \(dq127.0.0.1\(dq,
    \(dqport\(dq: 53001,
    \(dqdns\-server\-timeout\(dq : 1000,

    // زون مستقیم (Forward zone): secure.example.org. این زون از GSS\-TSIG استفاده می‌کند.
    // این زون توسط دو سرور DNS ارائه می‌شود که به درخواست‌های DDNS در 192.0.2.1
    // و 192.0.2.2 گوش فرا می‌دهند.
    \(dqforward\-ddns\(dq:
    {
        \(dqddns\-domains\(dq:
        [
            // ‏DdnsDomain برای زون \(dqsecure.example.org.\(dq
            {
                \(dqname\(dq: \(dqsecure.example.org.\(dq,
                \(dqcomment\(dq: \(dqDdnsDomain example\(dq,
                \(dqdns\-servers\(dq:
                [
                    {
                      // این سرور مدخلی در gss/servers دارد و
                      // بنابراین از GSS\-TSIG استفاده خواهد کرد.
                        \(dqip\-address\(dq: \(dq192.0.2.1\(dq
                    },
                    {
                      // این سرور نیز در آنجا مدخلی دارد، بنابراین آن هم
                      // از GSS\-TSIG استفاده خواهد کرد.
                        \(dqip\-address\(dq: \(dq192.0.2.2\(dq,
                        \(dqport\(dq: 5300
                    }
                ]
            }
        ]
    },

    // زون معکوس (Reverse zone): می‌خواهیم زون معکوس \(dq2.0.192.in\-addr.arpa\(dq را به‌روزرسانی کنیم.
    \(dqreverse\-ddns\(dq:
    {
        \(dqddns\-domains\(dq:
        [
            {
                \(dqname\(dq: \(dq2.0.192.in\-addr.arpa.\(dq,
                \(dqdns\-servers\(dq:
                [
                    {
                        // یک تعریف GSS\-TSIG برای این سرور وجود دارد (ببینید:
                        // ‏DhcpDdns/gss\-tsig/servers)، بنابراین از
                        // ‏Krb/GSS\-TSIG استفاده خواهد کرد.
                        \(dqip\-address\(dq: \(dq192.0.2.1\(dq
                    }
                ]
            }
        ]
    },

    // قلاب (hook) مربوط به GSS\-TSIG بارگذاری شده و پیکربندی آن در اینجا مشخص شده است.
    \(dqhooks\-libraries\(dq: [
    {
        \(dqlibrary\(dq: \(dqlibddns_gss_tsig.so\(dq,
        \(dqparameters\(dq: {
            // این بخش یکپارچه‌سازی با GSS\-TSIG را هدایت می‌کند. هر سروری که در
            // forward\-ddns و/یا reverse\-ddns ذکر شده، باید مدخلی در اینجا داشته
            // باشد تا بتواند از مقادیر پیش‌فرض GSS\-TSIG استفاده کند (اختیاری است،
            // در صورت تعیین، برای تمام سرورهای GSS\-TSIG اعمال می‌شوند مگر اینکه
            // در سطح یک سرور خاص بازنویسی شده باشند).

            \(dqserver\-principal\(dq: \(dqDNS/server.example.org@EXAMPLE.ORG\(dq,
            \(dqclient\-principal\(dq: \(dqDHCP/admin.example.org@EXAMPLE.ORG\(dq,

            // از هر دو مورد client\-keytab و credentials\-cache می‌توان برای
            // ذخیره کلیدهای کلاینت استفاده کرد. از آنجا که حافظه موقت اعتبارنامه
            // انعطاف‌پذیرتر است، استفاده از آن توصیه می‌شود. معمولاً استفاده هم‌زمان
            // از هر دو در یک زمان ممکن است باعث ایجاد مشکل شود.
            // \(dqclient\-keytab\(dq: \(dqFILE:/etc/dhcp.keytab\(dq, // فقط در بالاترین سطح
            \(dqcredentials\-cache\(dq: \(dqFILE:/etc/ccache\(dq,     // فقط در بالاترین سطح

            \(dqgss\-replay\-flag\(dq: true, // سرویس ضد بازپخش GSS
            \(dqgss\-sequence\-flag\(dq: false, // بدون سرویس توالی GSS
            \(dqtkey\-lifetime\(dq: 3600, // ۱ ساعت
            \(dqrekey\-interval\(dq: 2700, // ۴۵ دقیقه
            \(dqretry\-interval\(dq: 120, // ۲ دقیقه
            \(dqtkey\-protocol\(dq: \(dqTCP\(dq,
            \(dqfallback\(dq: false,

            // فهرست سرورهای با قابلیت GSS\-TSIG
            \(dqservers\(dq: [
                {
                    // سرور نخست (شناسایی الزامی است)
                    \(dqid\(dq: \(dqserver1\(dq,
                    \(dqdomain\-names\(dq: [ ], // در صورت عدم تعیین یا خالی بودن، با تمام
                                         // دامنه‌هایی که خواهان استفاده از این جفت
                                         // IP+port هستند مطابقت خواهد داشت
                    \(dqip\-address\(dq: \(dq192.0.2.1\(dq,
                    \(dqport\(dq: 53,
                    \(dqserver\-principal\(dq: \(dqDNS/server1.example.org@EXAMPLE.ORG\(dq,
                    \(dqclient\-principal\(dq: \(dqDHCP/admin1.example.org@EXAMPLE.ORG\(dq,
                    \(dqgss\-replay\-flag\(dq: false, // بدون سرویس ضد بازپخش GSS
                    \(dqgss\-sequence\-flag\(dq: false, // بدون سرویس توالی GSS
                    \(dqtkey\-lifetime\(dq: 7200, // ۲ ساعت
                    \(dqrekey\-interval\(dq: 5400, // ۹۰ دقیقه
                    \(dqretry\-interval\(dq: 240, // ۴ دقیقه
                    \(dqtkey\-protocol\(dq: \(dqTCP\(dq,
                    \(dqfallback\(dq: true // اگر هیچ کلیدی در دسترس نبود، بازگشت به
                                     // رفتار استاندارد (در مقایسه با صرف‌نظر از این سرور)
                },
                {
                    // سرور دوم (بیشتر پارامترها را ندارد چرا که از
                    // مقادیر پیش‌فرض تعیین‌شده در بالا استفاده می‌کنند)
                    \(dqid\(dq: \(dqserver2\(dq,
                    \(dqip\-address\(dq: \(dq192.0.2.2\(dq,
                    \(dqport\(dq: 5300
                }
            ]
        }
    }
    ]

    // پارامترهای اضافی مانند لاگ‌گیری (logging)، سوکت کنترلی و
    // موارد دیگر به منظور وضوح بیشتر حذف شده‌اند.
}

}
.EE
.UNINDENT
.UNINDENT.SS ddns/sample1.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک فایل پیکربندی نمونه برای D2، پردازشگر DHCP\-DDNS در Kea است.
// این پیکربندی از به‌روزرسانی دو ناحیه Forward DNS با نام‌های \(dqfour.example.com\(dq و
// \(dqsix.example.com\(dq؛ و یک ناحیه Reverse DNS با نام \(dq2.0.192.in\-addr.arpa.\(dq پشتیبانی می‌کند.

{
// \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- DHCP\-DDNS \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
\(dqDhcpDdns\(dq:
{

// \-\-\-\-\-\-\-\-\-\-\-\-\-\-  پارامترهای سراسری  \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
//   D2 برای درخواست‌های به‌روزرسانی از کارگزارهای Kea DHCP روی 127.0.0.1
//   در درگاه 53001 گوش فراخواهد داد. بیشینه زمانی که منتظر پاسخ یک
//   کارگزار DNS خواهیم ماند 1000 میلی‌ثانیه است.

    \(dqip\-address\(dq: \(dq127.0.0.1\(dq,
    \(dqport\(dq: 53001,
    \(dqdns\-server\-timeout\(dq : 1000,

// یک ویژگی اضافی که نیاز به توضیح دارد user\-context است.
// این ساختاری است که می‌توانید در دامنه سراسری، در ddns domain،
// dns server، tsig key و موارد دیگر تعریف کنید. این ساختار توسط
// Kea تجزیه می‌شود، اما مستقیماً استفاده نمی‌شود. هدف آن نگهداری هر چیزی
// است که مایل به قرار دادن آن هستید \- یادداشت‌ها، عناوین اضافی، نام طبقه
// یا بخش و غیره.
// یک مدخل comment به یک user\-context با ویژگی \(dqcomment\(dq
// تبدیل می‌شود تا بتوانید یادداشت‌ها را درون خود پیکربندی درج کنید.

    \(dquser\-context\(dq: { \(dqversion\(dq: 1 },

// \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- Control Socket (سوکت کنترلی) \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-

    \(dqcontrol\-socket\(dq:
    {
        \(dqsocket\-type\(dq: \(dqunix\(dq,
        \(dqsocket\-name\(dq: \(dqkea\-ddns\-ctrl\-socket\(dq
    },

// \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- Hooks Libraries (کتابخانه‌های قلاب) \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-

    \(dqhooks\-libraries\(dq:
    [
        // فهرست کتابخانه‌های قلاب می‌تواند شامل بیش از یک کتابخانه باشد.
        {
            // تنها پارامتر ضروری نام فایل کتابخانه است.
            \(dqlibrary\(dq: \(dqddns\-server\-commands.so\(dq,

            // برخی کتابخانه‌ها ممکن است از پارامترها پشتیبانی کنند. دقت کنید
            // که این بخش را با دقت وارد نمایید، زیرا کارگزار آن را اعتبارسنجی
            // نمی‌کند (زیرا قالب آن مختص به هر کتابخانه است).
            \(dqparameters\(dq:
            {
                \(dqparam1\(dq: \(dqfoo\(dq
            }
        }
    ],

// \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- Forward DDNS  \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
//   1. ناحیه \- \(dqfour.example.com.\(dq
//      از TSIG استفاده می‌کند، نام کلید \(dqd2.md5.key\(dq است
//      توسط یک کارگزار DNS ارائه می‌شود که به درخواست‌های DDNS روی
//      172.16.1.1 در درگاه پیش‌فرض 53 (درگاه استاندارد DNS) گوش می‌دهد
//   2. ناحیه \- \(dqsix.example.com.\(dq
//      از TSIG استفاده نمی‌کند.
//      توسط یک کارگزار DNS روی \(dq2001:db8:1::10\(dq در درگاه 7802 ارائه می‌شود

    \(dqforward\-ddns\(dq:
    {
        \(dqddns\-domains\(dq:
        [
//           DdnsDomain برای ناحیه \(dqfour.example.com.\(dq
            {
                \(dqcomment\(dq: \(dqDdnsDomain example\(dq,
                \(dqname\(dq: \(dqfour.example.com.\(dq,
                \(dqkey\-name\(dq: \(dqd2.md5.key\(dq,
                \(dqdns\-servers\(dq:
                [
                    {
                        \(dqip\-address\(dq: \(dq172.16.1.1\(dq
                    }
                ]
            },

//           DdnsDomain برای ناحیه \(dqsix.example.com.\(dq
            {
                \(dqname\(dq: \(dqsix.example.com.\(dq,
                \(dqdns\-servers\(dq:
                [
                    {
                        \(dqip\-address\(dq: \(dq2001:db8:1::10\(dq,
                        \(dqport\(dq: 7802
                    }
                ]
            }
        ]
    },

// \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- Reverse DDNS  \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
// ما Reverse DNS را برای یک ناحیه \(dq2.0.192.in\-addr\-arpa\(dq به‌روزرسانی خواهیم کرد. این ناحیه
// از TSIG با کلید \(dqd2.sha1.key\(dq استفاده می‌کند و توسط دو کارگزار DNS ارائه می‌شود:
// یکی روی \(dq172.16.1.1\(dq در 53001 و دیگری روی \(dq192.168.2.10\(dq گوش می‌دهد.
    \(dqreverse\-ddns\(dq:
    {
        \(dqddns\-domains\(dq:
        [
            {
                \(dqname\(dq: \(dq2.0.192.in\-addr.arpa.\(dq,
                \(dqkey\-name\(dq: \(dqd2.sha1.key\(dq,
                \(dqdns\-servers\(dq:
                [
                    {
                        \(dqip\-address\(dq: \(dq172.16.1.1\(dq,
                        \(dqport\(dq: 53001
                    },
                    {
                        \(dqip\-address\(dq: \(dq192.168.2.10\(dq
                    }
                ]
            }
        ]
    },

// \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- TSIG keys (کلیدهای TSIG) \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
//   هر کلید دارای یک نام، یک الگوریتم (HMAC\-MD5، HMAC\-SHA1، HMAC\-SHA224...)
//   و یک راز مشترک با کدگذاری base\-64 است.
    \(dqtsig\-keys\(dq:
    [
        {
            \(dqname\(dq: \(dqd2.md5.key\(dq,
            \(dqalgorithm\(dq: \(dqHMAC\-MD5\(dq,
            \(dqsecret\(dq: \(dqLSWXnfkKZjdPJI5QxlpnfQ==\(dq
        },
        {
            \(dqname\(dq: \(dqd2.sha1.key\(dq,
            \(dqalgorithm\(dq: \(dqHMAC\-SHA1\(dq,
            \(dqsecret\(dq: \(dqhRrp29wzUv3uzSNRLlY68w==\(dq
        },
        {
            \(dqname\(dq: \(dqd2.sha256.key\(dq,
            \(dqalgorithm\(dq: \(dqHMAC\-SHA256\(dq,
            \(dqsecret\-file\(dq: \(dq/usr/local/share/kea/d2\-sha256\-secret\(dq
        },
        {
            \(dqname\(dq: \(dqd2.sha512.key\(dq,
            \(dqalgorithm\(dq: \(dqHMAC\-SHA512\(dq,
            \(dqdigest\-bits\(dq: 256,
            \(dqsecret\(dq: \(dq/4wklkm04jeH4anx2MKGJLcya+ZLHldL5d6mK+4q6UXQP7KJ9mS2QG29hh0SJR4LA0ikxNJTUMvir42gLx6fGQ==\(dq
        }
    ],

// بخش زیر ثبت وقایع را پیکربندی می‌کند. فرض بر این است پیام‌هایی که دست‌کم
// سطح اطلاعاتی (info، warn، error و fatal) دارند باید در stdout ثبت شوند.
// همچنین یک الگوی ثبت وقایع سفارشی را مشخص می‌کند.
    \(dqloggers\(dq: [
        {
            \(dqname\(dq: \(dqkea\-dhcp\-ddns\(dq,
            \(dqoutput\-options\(dq: [
                {
                    \(dqoutput\(dq: \(dqstdout\(dq,
                    // علاوه بر خروجی معمول، چندین پارامتر دیگر نیز امکان‌پذیر است.
                    // پارامتر Flush تعیین می‌کند که آیا ثبت‌کننده وقایع خروجی را به یک فایل
                    // تخلیه کند یا خیر. Maxsize حداکثر اندازه فایل را پیش از چرخش
                    // فایل تعیین می‌کند. maxver حداکثر تعداد فایل‌های نگهداری‌شده
                    // در چرخش را مشخص می‌سازد.
                    \(dqflush\(dq: true,
                    \(dqmaxsize\(dq: 204800,
                    \(dqmaxver\(dq: 4,
                    \(dqpattern\(dq: \(dq%d [%c/%i] %m\en\(dq
                }
            ],
            \(dqdebuglevel\(dq: 0,
            \(dqseverity\(dq: \(dqINFO\(dq
        }
    ]
}

}
.EE
.UNINDENT
.UNINDENT.SS ddns/template.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این فایل می‌تواند به عنوان الگویی برای ایجاد پیکربندی JSON در
// DHCP\-DDNS به کار رود.
// باید با یک آکولاد باز آغاز شود.
{

\(dqDhcpDdns\(dq :
{
// \-\-\-\-\-\-\-\-\-\-\-\-\-\-  پارامترهای سراسری \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
//    تمام پارامترهای سراسری دارای مقادیر پیش‌فرضی مطابق نمایش هستند. اگر این
//    مقادیر رضایت‌بخش هستند، می‌توانید از آن‌ها صرف‌نظر کنید.
//    \(dqip\-address\(dq : \(dq127.0.0.1\(dq,
//    \(dqport\(dq : 53001,
//    \(dqdns\-server\-timeout\(dq : 100,
//    \(dqncr\-protocol\(dq : \(dqUDP\(dq
//    \(dqncr\-format\(dq : \(dqJSON\(dq

// \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- سوکت کنترلی \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-

//    \(dqcontrol\-socket\(dq:
//    {
//        \(dqsocket\-type\(dq: \(dqunix\(dq,
//        \(dqsocket\-name\(dq: \(dqkea\-ddns\-ctrl\-socket\(dq
//    },

// \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- DDNS مستقیم  \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
    \(dqforward\-ddns\(dq :
    {
        \(dqddns\-domains\(dq :
        [
//            {
//                \(dqname\(dq : \(dq<zone name 1>\(dq,
//                \(dqkey\-name\(dq : \(dq<key name>\(dq,
//                \(dqdns\-servers\(dq :
//                [
//                    {
//                        \(dqip\-address\(dq : \(dq<ip address>\(dq
//                       ,\(dqport\(dq : 53
//                    }
//                    ,
//                    {
//                        سرور DNS بعدی برای این DdnsDomain
//                    }
//                    :
//                ]
//            }
//            ,
//            {
//                 DdnsDomain مستقیم بعدی
//            }
//            :
        ]
    },

// \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- DDNS معکوس  \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
    \(dqreverse\-ddns\(dq :
    {
        \(dqddns\-domains\(dq :
        [
//            {
//                \(dqname\(dq : \(dq<reverse zone name 1>\(dq,
//                \(dqkey\-name\(dq : \(dq<key name>\(dq,
//                \(dqdns\-servers\(dq :
//                [
//                    {
//                        \(dqip\-address\(dq : \(dq<ip address>\(dq
//                        ,\(dqport\(dq : 53
//                    }
//                    ,
//                    {
//                        سرور DNS بعدی برای این DdnsDomain
//                    }
//                    :
//                ]
//            }
//            ,
//            {
//                 DdnsDomain معکوس بعدی
//            }
//            :
        ]
    },
// \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- کلیدهای TSIG \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
    \(dqtsig\-keys\(dq :
    [
//        {
//            \(dqname\(dq : \(dq<key name>\(dq,
//            \(dqalgorithm\(dq : \(dq<algorithm name>\(dq,
//            مقادیر معتبر برای algorithm عبارتند از:    HMAC\-MD5, HMAC\-SHA1,
//                                               HMAC\-SHA224, HMAC\-SHA256,
//                                               HMAC\-SHA384, HMAC\-SHA512
//            \(dqdigest\-bits\(dq : 256,
//            حداقل طول کوتاه‌شده بر حسب بیت.
//            پیش‌فرض 0 (به معنای ممنوع بودن کوتاه‌سازی است).
//            \(dqsecret\(dq : \(dq1234\(dq (مقدار رمز مشترک)
//        }
//        ,
//        {
//                کلید TSIG بعدی
//        }
    ]

// ثبت وقایع
//    ,\(dqloggers\(dq:
//    [
//        {
//            \(dqname\(dq: \(dqkea\-dhcp\-ddns\(dq,
//            \(dqseverity\(dq: \(dqinfo\(dq
//        }
//    ]
}

// باید با یک آکولاد بسته پایان یابد.
}
.EE
.UNINDENT
.UNINDENT.SS kea4
.SS kea4/advanced.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک فایل پیکربندی نمونه برای کارساز DHCPv4 در Kea است.
// این فایل برخی از قابلیت‌های پیشرفته‌تر را پوشش می‌دهد. این فایل ممکن است
// یکپارچه نباشد زیرا هدف اصلی آن نشان دادن قابلیت‌ها است. لزوماً قرار نیست
// استفاده هم‌زمان آن‌ها با یکدیگر منطقی باشد.

// تجزیه‌کننده جدید از ۳ سبک کامنت پشتیبانی می‌کند:

// این سبک ++C است.

# این سبک bash است.

/* این یک کامنت به سبک C است. */

/* کامنت به سبک C
   می‌تواند چند خط
   را در بر بگیرد */

{ \(dqDhcp4\(dq:

{
    // به Kea گفته شده است که تنها روی رابط eth0 شنود کند.
    \(dqinterfaces\-config\(dq: {
        \(dqinterfaces\(dq: [ \(dqeth0\(dq ],

        // این گزینه مشخص می‌کند که Kea از چه نوع سوکتی استفاده می‌کند. در حال حاضر
        // مقادیر پشتیبانی‌شده \(aqraw\(aq (که پیش‌فرض است) و \(aqudp\(aq هستند. سوکت raw این مزیت
        // را دارد که همیشه همه ترافیک را دریافت می‌کند و این عیب را دارد که تمام قوانین
        // دیوار آتش را دور می‌زند و اثر منفی اندکی بر کارایی دارد.
        // اگر فقط ترافیک رله‌شده دارید، \(aqudp\(aq عموماً بهتر است. سپس Kea
        // یک سوکت عادی UDP باز می‌کند و هسته تمام پردازش‌های پشته Ethernet/IP
        // را انجام می‌دهد.
        \(dqdhcp\-socket\-type\(dq: \(dqudp\(dq,

        // معمولاً کارساز DHCP پاسخ خود را از همان رابطی بازمی‌فرستد که
        // پرس‌وجو از آن وارد شده است. این حالت پیش‌فرض است (\(dqsame\-as\-inbound\(dq).
        // با این حال، گاهی اوقات این قابلیت مفید است که بسته به عنوان یک بسته عادی UDP
        // ارسال شود و به هسته و جدول‌های مسیریابی اجازه داده شود که رابط درست را
        // تعیین کنند (\(dquse\-routing\(dq). این گزینه تنها هنگامی کار می‌کند
        // که \(dqdhcp\-socket\-type\(dq روی \(dqudp\(dq تنظیم شده باشد و در غیر این صورت نادیده گرفته می‌شود.
        \(dqoutbound\-interface\(dq: \(dquse\-routing\(dq,

        // این باعث می‌شود رابط‌ها در هر بار پیکربندی (مجدد) دوباره شناسایی شوند.
        // به طور پیش‌فرض true است.
        \(dqre\-detect\(dq: true
    },

    \(dqsanity\-checks\(dq: {
        // این پارامتر تعیین می‌کند هنگامی که یک اجاره (lease) جدید در
        // سیستم ظاهر می‌شود (یعنی یا در هنگام راه‌اندازی memfile از دیسک خوانده می‌شود یا
        // از طریق دستورهای lease اضافه می‌شود) چه کاری انجام شود. پنج حالت پشتیبانی می‌شود:
        // none \- هیچ کاری انجام نده، آن‌ها را همان‌طور که هستند بپذیر
        // warn \- اگر مشکلی در subnet\-id شناسایی شد، یک هشدار چاپ کن، اما
        //        در غیر این صورت اجاره را همان‌طور که هست بارگذاری کن. این مقدار پیش‌فرض است.
        // fix \- تلاش برای اصلاح اجاره با یافتن مقدار subnet\-id مناسب.
        //       اگر زیرشبکه مناسبی نباشد، اجاره همان‌طور که هست بارگذاری می‌شود.
        // fix\-del \- تلاش برای اصلاح اجاره با یافتن مقدار subnet\-id
        //           مناسب. اگر زیرشبکه مناسبی نباشد، اجاره حذف می‌شود.
        // del \- حذف اجاره‌هایی که مقادیر subnet\-id نادرست دارند.
        \(dqlease\-checks\(dq: \(dqfix\-del\(dq
    },

    // تعریف چاره آخر گزینه ۴۳ (Option 43) می‌تواند باعث شود پیام‌های باساختار درست
    // رد شوند چون از مقدار ناسازگار \(dqraw\(dq استفاده می‌کنند،
    // و سازندگان مختلف ممکن است زیرگزینه‌های متفاوتی را تعریف کنند.
    // تعریف گزینه باید برای جلوگیری از این مشکلات اعمال شود،
    // به عنوان نمونه با تعریف گزینه به صورت binary در دامنه سراسری.
    // در client\-classes این گزینه ممکن است طوری بازتعریف شود که حامل
    // زیرگزینه‌های وابسته به سازنده باشد.
    \(dqoption\-def\(dq: [ {
        \(dqname\(dq: \(dqvendor\-encapsulated\-options\(dq,
        \(dqcode\(dq: 43,
        \(dqtype\(dq: \(dqbinary\(dq
    } ],

    // ما باید پایگاه داده مورد استفاده برای ذخیره اجاره‌ها را مشخص کنیم. تا
    // ژوئن ۲۰۲۲، سه پس‌بند پایگاه داده پشتیبانی می‌شوند: MySQL،
    // PostgreSQL و پایگاه داده درون‌حافظه‌ای، Memfile.
    // ما از memfile استفاده خواهیم کرد چون به هیچ راه‌اندازی اولیه‌ای نیاز ندارد.
    // برای memfile، مهم است که همیشه lfc\-interval مشخص شود، تا
    // فایل اجاره بدون محدودیت رشد نکند و ساعتی یک‌بار پاک‌سازی شود.
    \(dqlease\-database\(dq: {
        \(dqtype\(dq: \(dqmemfile\(dq,
        \(dqlfc\-interval\(dq: 3600
    },

    // این یک سوکت کنترلی را تعریف می‌کند. در صورت تعریف، Kea یک سوکت UNIX باز کرده
    // و به دستورهای ورودی گوش خواهد داد. برای دیدن فهرست دستورهای پشتیبانی‌شده،
    // به بخش ۱۵ راهنمای کاربر Kea مراجعه کنید.
    \(dqcontrol\-socket\(dq: {
        \(dqsocket\-type\(dq: \(dqunix\(dq,
        \(dqsocket\-name\(dq: \(dqkea4\-ctrl\-socket\(dq
    },

    // نشانی‌ها با طول عمر ۴۰۰۰ ثانیه تخصیص داده خواهند شد.
    // به کلاینت گفته می‌شود که تمدید را پس از ۱۰۰۰ ثانیه آغاز کند. اگر کارساز
    // در عرض ۲۰۰۰ ثانیه پس از اعطای اجاره پاسخ ندهد، کلاینت
    // باید رویه REBIND را آغاز کند (تمدید اضطراری که امکان
    // جابه‌جایی به یک کارساز دیگر را فراهم می‌کند).
    \(dqvalid\-lifetime\(dq: 4000,
    \(dqrenew\-timer\(dq: 1000,
    \(dqrebind\-timer\(dq: 2000,

    // استاندارد RFC6842 می‌گوید که کارساز باید گزینه client\-id را بازتاب (echo) دهد.
    // با این حال، برخی کلاینت‌های قدیمی‌تر از این پشتیبانی نکرده و وقتی
    // client\-id خود را دریافت می‌کنند دچار سردرگمی می‌شوند. Kea می‌تواند پشتیبانی از RFC6842 را غیرفعال کند.
    \(dqecho\-client\-id\(dq: false,

    // برخی کلاینت‌ها از شناسه کلاینت پایدار استفاده نمی‌کنند، بلکه
    // در هر بار بوت آن را تولید می‌کنند. این ممکن است باعث شود کلاینتی که
    // مکرراً راه‌اندازی مجدد می‌شود چندین اجاره دریافت کند، که ممکن است
    // مطلوب نباشد. از این رو، گاهی مدیران ترجیح می‌دهند به کارساز DHCPv4
    // خود بگویند که مقدار client\-id را به کلی نادیده بگیرد و منحصراً
    // به نشانی MAC اتکا کند. این پارامتری است که به صورت سراسری تعریف می‌شود، اما
    // می‌تواند در سطح زیرشبکه بازنویسی شود.
    \(dqmatch\-client\-id\(dq: true,

    // به طور پیش‌فرض، Kea درخواست‌های کلاینت‌ها برای نشانی‌های IP ناشناخته را نادیده می‌گیرد،
    // چرا که ممکن است کارسازهای DHCP غیرهمکار دیگری در همان شبکه وجود داشته باشند (RFC 2131).
    // این پارامتر به صورت سراسری تعریف شده است، اما می‌تواند در سطح زیرشبکه بازنویسی شود
    \(dqauthoritative\(dq: false,

    // فهرست زیر زیرشبکه‌ها را تعریف می‌کند. هر زیرشبکه حداقل از
    // مدخل‌های subnet و pool تشکیل شده است. یک قابلیت اضافی که نیاز به
    // کمی توضیح دارد user\-context است. این ساختاری است که می‌توانید
    // در زیرشبکه‌ها، استخرها و موارد دیگر تعریف کنید. توسط Kea تجزیه می‌شود، اما
    // مستقیماً استفاده نمی‌شود. هدف آن نگهداری هر چیزی است که ممکن است بخواهید
    // در آنجا بگذارید \- کامنت‌ها، نام‌گذاری‌های اضافی، نام طبقه یا بخش
    // و غیره. این ساختارها در دسترس قلاب‌های Kea قرار خواهند گرفت.
    // یک مدخل comment به یک user\-context با ویژگی \(dqcomment\(dq ترجمه می‌شود
    // تا بتوانید کامنت‌ها را درون خود پیکربندی بگنجانید.
    \(dqsubnet4\(dq: [
        {
            \(dqpools\(dq: [ {
                \(dqpool\(dq:  \(dq192.0.2.1 \- 192.0.2.200\(dq,
                \(dquser\-context\(dq: { \(dqinfo\(dq: \(dqwhat a large pool\(dq }
            } ],
            \(dqid\(dq: 1,
            \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
            \(dquser\-context\(dq: {
                \(dqcomment\(dq: \(dqOur first subnet!\(dq
            }
            // معادل با استفاده از تجزیه‌کننده هوشمند
            // \(dqcomment\(dq: \(dqOur first subnet!\(dq
        },
        {
            // مقدار match\-client\-id در این زیرشبکه خاص تغییر یافته است.
            // این باعث می‌شود Kea مقادیر client\-id را در این زیرشبکه نادیده بگیرد
            // و منحصراً به نشانی‌های MAC اتکا کند.
            \(dqpools\(dq: [ { \(dqpool\(dq: \(dq192.0.3.100 \- 192.0.3.200\(dq } ],
            \(dqid\(dq: 2,
            \(dqsubnet\(dq: \(dq192.0.3.0/24\(dq,
            \(dqmatch\-client\-id\(dq: false
        },
        {
            \(dqpools\(dq: [ { \(dqpool\(dq: \(dq192.0.4.1 \- 192.0.4.254\(dq } ],
            \(dqid\(dq: 3,
            \(dqsubnet\(dq: \(dq192.0.4.0/24\(dq,

            // گاهی اوقات ممکن است رله از یک نشانی IPv4 استفاده کند که
            // با زیرشبکه مطابقت ندارد. این کار توصیه نمی‌شود، اما موارد
            // معتبری وجود دارد که منطقی است. یک مورد زمانی است که
            // یک زیرشبکه اشتراکی وجود دارد.
            \(dqrelay\(dq: {
                \(dqip\-addresses\(dq: [ \(dq192.168.1.1\(dq ]
            }
        },
        {
            // مقدار authoritative در این زیرشبکه خاص تغییر کرده است.
            // این امر باعث می‌شود Kea به درخواست‌ها برای نشانی‌های IP نامشخص
            // با یک پیام DHCPNAK پاسخ دهد.
            \(dqpools\(dq: [ { \(dqpool\(dq: \(dq192.0.5.100 \- 192.0.5.200\(dq } ],
            \(dqid\(dq: 4,
            \(dqsubnet\(dq: \(dq192.0.5.0/24\(dq,
            \(dqauthoritative\(dq: true
        }
    ],

    // موارد زیر گزارش‌گیری را پیکربندی می‌کند. فرض بر این است که پیام‌هایی با
    // حداقل سطح اطلاعاتی (info، warn، error و fatal) باید
    // در stdout ثبت شوند.
    \(dqloggers\(dq: [
          {
            \(dqname\(dq: \(dqkea\-dhcp4\(dq,
              \(dqoutput\-options\(dq: [
                  {
                      \(dqoutput\(dq: \(dqstdout\(dq,
                      // علاوه بر خروجی معمول، چندین پارامتر اضافی
                      // دیگر نیز امکان‌پذیر است. Flush تعیین می‌کند که آیا گزارش‌گیر
                      // خروجی را در یک فایل تخلیه می‌کند یا خیر. Maxsize حداکثر
                      // اندازه فایل را پیش از چرخش فایل تعیین می‌کند. maxver
                      // حداکثر تعداد فایل‌های چرخیده‌ای که نگهداری می‌شوند را
                      // مشخص می‌کند.
                      \(dqflush\(dq: true,
                      \(dqmaxsize\(dq: 204800,
                      \(dqmaxver\(dq: 4,
                      // ما از pattern برای مشخص کردن چیدمان سفارشی پیام گزارش استفاده می‌کنیم
                      \(dqpattern\(dq: \(dq%d{%y.%m.%d %H:%M:%S.%q} %\-5p [%c/%i] %m\en\(dq
                  }
              ],
              \(dqseverity\(dq: \(dqINFO\(dq
          }
      ]
  }

}
.EE
.UNINDENT
.UNINDENT.SS kea4/all\-keys\-netconf.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// هشدار: این پیکربندی نمونه برای استفاده در محیط عملیاتی در نظر گرفته نشده است.
// کارگزار Kea DHCPv4 این پیکربندی را رد خواهد کرد زیرا حاوی پارامترهای
// پیکربندی ناسازگار با یکدیگر (مانعة‌الجمع) است.
//
// هدف اصلی این فایل نمونه، ارائه فهرستی جامع از پارامترهای پشتیبانی‌شده
// توسط کارگزار Kea DHCPv4 به همراه توضیح مختصری از هر پارامتر است.
//
// این نسخه پایدار برای YANG استفاده می‌شود، زیرا نمی‌خواهیم هر بار که
// یک کلمه کلیدی به نحو اضافه می‌شود، کد و مدل‌ها به‌روزرسانی شوند.
{
    // پیکربندی کارگزار Kea DHCPv4 از اینجا آغاز می‌شود.
    \(dqDhcp4\(dq: {
        // پرچم سراسری برای انتخاب راهبرد تخصیص آدرس IP برای همه
        // زیرشبکه‌ها. برای راهبرد تخصیص تصادفی از \(dqrandom\(dq استفاده کنید.
        \(dqallocator\(dq: \(dqiterative\(dq,

        // پرچم معتبر (authoritative) سراسری برای رسیدگی به درخواست‌های کلاینت‌ها
        // برای آدرس‌های IP نامشخص (در صورت غیرفعال بودن نادیده گرفته می‌شود، در صورت فعال بودن NAK ارسال می‌شود).
        \(dqauthoritative\(dq: false,

        // نام bootfile سراسری برای تنظیم در فیلد \(aqfile\(aq.
        \(dqboot\-file\-name\(dq: \(dq/dev/null\(dq,

        // فهرست مرتب‌شده‌ای از کلاس‌های کلاینت مورد استفاده کارگزار DHCPv4.
        \(dqclient\-classes\(dq: [
            {
                // نام bootfile ویژه کلاس برای تنظیم در فیلد \(aqfile\(aq.
                \(dqboot\-file\-name\(dq: \(dq/usr/local/share/kea/bootfile.efi\(dq,

                // نام کلاس.
                \(dqname\(dq: \(dqphones_server1\(dq,

                // آدرس کارگزار بعدی ویژه کلاس برای استفاده در راه‌اندازی اولیه (bootstrap)، که
                // در فیلد \(aqsiaddr\(aq تنظیم می‌شود.
                \(dqnext\-server\(dq: \(dq10.2.3.4\(dq,

                // فهرست گزینه‌های DHCPv4 ویژه کلاس.
                \(dqoption\-data\(dq: [],

                // تعاریف گزینه‌های DHCPv4 ویژه کلاس، یعنی قالب‌های سفارشی
                // مشخص‌شده برای گزینه‌های غیر استاندارد.
                \(dqoption\-def\(dq: [],

                // نام میزبان اختیاری کارگزار ویژه کلاس، که در فیلد
                // \(aqsname\(aq تنظیم می‌شود.
                \(dqserver\-hostname\(dq: \(dq\(dq,

                // عبارت انتخاب کلاس. هنگامی که عبارت ارائه‌شده true ارزیابی شود،
                // بسته DHCP به این کلاس اختصاص می‌یابد.
                \(dqtest\(dq: \(dqmember(\(aqHA_server1\(aq)\(dq,

                // طول‌عمر معتبر کلاس.
                \(dqvalid\-lifetime\(dq: 6000,

                // حداقل طول‌عمر معتبر کلاس.
                \(dqmin\-valid\-lifetime\(dq: 4000,

                // حداکثر طول‌عمر معتبر کلاس.
                \(dqmax\-valid\-lifetime\(dq: 8000,

                // اگر بزرگ‌تر از صفر باشد، طول‌عمر اجاره‌هایی است که موقتاً در
                // مرحله DISCOVER تخصیص می‌یابند. در صورت صفر بودن (پیش‌فرض)، در DISCOVER اجاره‌ای تخصیص داده نمی‌شود.
                \(dqoffer\-lifetime\(dq : 65
            },
            {
                // مقدار پیش‌فرض نام bootfile ویژه کلاس. یک نام خالی به این
                // معنی است که نام bootfile مشخص نشده است.
                \(dqboot\-file\-name\(dq: \(dq\(dq,

                // نام کلاس دوم.
                \(dqname\(dq: \(dqphones_server2\(dq,

                // مقدار پیش‌فرض آدرس کارگزار بعدی ویژه کلاس. آدرس
                // صفر IPv4 به این معنی است که مشخص نشده است.
                \(dqnext\-server\(dq: \(dq0.0.0.0\(dq,

                // فهرست گزینه‌های DHCPv4 ویژه کلاس.
                \(dqoption\-data\(dq: [],

                // تعاریف گزینه‌های DHCPv4 ویژه کلاس، یعنی قالب‌های سفارشی
                // مشخص‌شده برای گزینه‌های غیر استاندارد.
                \(dqoption\-def\(dq: [],

                // نام میزبان اختیاری کارگزار ویژه کلاس، که در فیلد
                // \(aqsname\(aq تنظیم می‌شود.
                \(dqserver\-hostname\(dq: \(dq\(dq,

                // عبارت انتخاب کلاس. هنگامی که عبارت ارائه‌شده true ارزیابی شود،
                // بسته DHCP به این کلاس اختصاص می‌یابد.
                \(dqtest\(dq: \(dqmember(\(aqHA_server2\(aq)\(dq
            },
            {
                // نام کلاس سوم.
                \(dqname\(dq: \(dqlate\(dq,

                // پرچم بولی که مشخص می‌کند آیا عبارت کلاس تنها زمانی ارزیابی شود
                // که پیکربندی انتخاب‌شده (یعنی pool، subnet، shared\-network)
                // شامل این نام کلاس در فهرست \(dqevaluate\-additional\-classes\(dq خود باشد. مقدار
                // پیش‌فرض false به این معنی است که عبارت آزمون کلاس باید
                // همیشه ارزیابی شود.
                \(dqonly\-in\-additional\-list\(dq: true,

                // عبارت انتخاب کلاس.
                \(dqtest\(dq: \(dqmember(\(aqALL\(aq)\(dq
            },
            {
                // نام کلاس چهارم.
                \(dqname\(dq: \(dqmy\-template\-class\(dq,

                // پرچم کلاس الگو که حاوی عبارت مورد استفاده برای تولید نام‌ها برای تمام
                // زیرکلاس‌های ایجادشده است. در این حالت، کلاس‌ها بر اساس شناسه کلاینت (client ID) نام‌گذاری می‌شوند.
                \(dqtemplate\-test\(dq: \(dqsubstring(option[61].hex, 0, all)\(dq
            }
        ],

        // پارامترهایی برای فعال‌سازی رفتارهای سازگار با کلاینت‌ها، رله‌ها،
        // یا سایر کارگزاران معیوب یا ناسازگار با استاندارد
        \(dqcompatibility\(dq: {
            // نادیده گرفتن گزینه شناسه کارگزار DHCP در صورت تنظیم روی true.
            // فعال کردن این گزینه باعث می‌شود Kea به جای رها کردن پرس‌وجو، هر
            // درخواستی را حتی اگر آدرس موجود در گزینه متعلق به کارگزار دیگری
            // باشد، بپذیرد. پیش‌فرض این گزینه پیکربندی false است،
            // زیرا فعال کردن آن سازگاری با RFC را نقض می‌کند.
            \(dqignore\-dhcp\-server\-identifier\(dq: false,

            // نادیده گرفتن زیرگزینه Link Selection در Relay Agent Information در صورت تنظیم
            // روی true. فعال کردن این گزینه باعث می‌شود Kea به جای تلاش برای استفاده از زیرشبکه
            // مشخص‌شده در زیرگزینه، از منطق معمول انتخاب زیرشبکه استفاده کند. این گزینه پیکربندی
            // به‌طور پیش‌فرض false است، زیرا فعال کردن آن سازگاری با RFC را نقض می‌کند.
            \(dqignore\-rai\-link\-selection\(dq: false,

            // تجزیه ملایم‌تر گزینه‌ها در مواردی که فیلدها را می‌توان به صورت
            // قطعی استنتاج کرد، حتی اگر برخلاف RFC یا رویه معمول باشد.
            \(dqlenient\-option\-parsing\(dq: true,

            // پرچم بولی که مشخص می‌کند آیا آدرس‌های 0. و 255. باید در زیرشبکه‌هایی با طول پیشوند
            // ۲۴ یا کمتر، همیشه غیرقابل‌دسترس و اشغال‌شده در نظر گرفته شوند یا خیر. پیش‌فرض false است،
            // زیرا این آدرس‌ها خاص نیستند؛ تنها اولین و آخرین آدرس‌ها خاص هستند.
            \(dqexclude\-first\-last\-24\(dq: false
        },

        // پارامترهای پیکربندی سوکت کنترل فرمان برای کارگزار Kea DHCPv4.
        \(dqcontrol\-sockets\(dq: [
            {
                // نوع سوکت کنترل مورد استفاده توسط کارگزار Kea DHCPv4.
                // باید unix، http یا https باشد.
                \(dqsocket\-type\(dq: \(dqunix\(dq,

               // مکان فایل سوکت دامنه یونیکس (UNIX domain socket) که کارگزار DHCPv4
               // برای دریافت فرمان‌های کنترلی از مدیر محلی سرور استفاده می‌کند.
               \(dqsocket\-name\(dq: \(dqkea4\-ctrl\-socket\(dq
            },
            {
                // نوع سوکت کنترل مورد استفاده توسط کارگزار Kea DHCPv4.
                // باید unix، http یا https باشد.
                \(dqsocket\-type\(dq: \(dqhttps\(dq,

                // آدرس سوکت HTTPS که کارگزار Kea DHCPv4 باید برای پرس‌وجوهای
                // ورودی روی آن گوش فرا دهد.
                \(dqsocket\-address\(dq: \(dq127.0.0.1\(dq,

                // درگاه سوکت HTTPS که کارگزار Kea DHCPv4 باید برای پرس‌وجوهای
                // ورودی روی آن گوش فرا دهد. در صورت فعال‌سازی HA و چندنخی،
                // درگاه 8000 توسط شنونده http کتابخانه قلاب HA استفاده می‌شود.
                // هنگام استفاده از کتابخانه قلاب HA همراه با چندنخی، مطمئن شوید
                // درگاهی که توسط شنونده اختصاصی استفاده می‌شود با درگاه مشخص‌شده
                // در اینجا متفاوت باشد (مثلاً 8001). توجه داشته باشید که
                // فرمان‌ها همچنان باید به سوکت کنترل ارسال شوند.
                // شنونده اختصاصی صرفاً برای به‌روزرسانی‌های HA است.
                \(dqsocket\-port\(dq: 8004,

                // لنگر اعتماد TLS (مرجع صدور گواهی یا CA). این یک
                // نام فایل یا مسیر دایرکتوری است. همراه با سایر پارامترهای
                // TLS تنها برای نوع سوکت کنترل https کاربرد دارد.
                \(dqtrust\-anchor\(dq: \(dqmy\-ca\(dq,

                // نام فایل گواهی سرور TLS.
                \(dqcert\-file\(dq: \(dqmy\-cert\(dq,

                // نام فایل کلید خصوصی سرور TLS.
                \(dqkey\-file\(dq: \(dqmy\-key\(dq,

                // پرچم الزام گواهی‌های کلاینت TLS. پیش‌فرض true
                // است و به معنای الزام گواهی‌های کلاینت است. مقدار false
                // یعنی اختیاری هستند.
                \(dqcert\-required\(dq: true,

                // سرایندهای HTTP اضافی برای افزودن به پاسخ‌ها.
                \(dqhttp\-headers\(dq:
                [
                    {
                        // بافت کاربری (user context) اختیاری.
                        \(dquser\-context\(dq: { \(dqcomment\(dq: \(dqHSTS header\(dq },

                        // نام الزامی سرایند HTTP.
                        \(dqname\(dq: \(dqStrict\-Transport\-Security\(dq,

                        // مقدار الزامی سرایند HTTP.
                        \(dqvalue\(dq: \(dqmax\-age=31536000\(dq
                    }
                ],

                // احراز هویت اختیاری.
                \(dqauthentication\(dq: {

                    // نوع الزامی احراز هویت. تنها مقدار
                    // پشتیبانی‌شده basic برای احراز هویت
                    // پایه HTTP است.
                    \(dqtype\(dq: \(dqbasic\(dq,

                    // یک پارامتر اختیاری قلمرو (realm) احراز هویت
                    // پایه HTTP است. پیش‌فرض آن
                    // \(dqkea\-dhcpv4\-server\(dq است.
                    \(dqrealm\(dq: \(dqkea\-dhcpv4\-server\(dq,

                    // این پارامتر اختیاری می‌تواند برای تعیین یک پیشوند
                    // مشترک برای فایل‌های حاوی اطلاعات اعتباری کلاینت استفاده شود.
                    \(dqdirectory\(dq: \(dq/usr/local/share/kea/kea\-creds\(dq,

                    // این فهرست شناسه‌های کاربری و گذرواژه‌های مورد استفاده برای
                    // احراز هویت پایه HTTP را مشخص می‌کند. در صورت خالی بودن
                    // یا عدم وجود، هر کلاینتی مجاز شمرده می‌شود.
                    \(dqclients\(dq: [
                        // این بخش یک کلاینت مجاز را مشخص می‌کند.
                        {
                            // شناسه کاربری نباید خالی باشد یا
                            // حاوی نویسه \(aq:\(aq باشد. این یک
                            // پارامتر اجباری است.
                            \(dquser\(dq: \(dqadmin\(dq,

                            // در صورت عدم تعیین گذرواژه، از یک گذرواژه
                            // خالی استفاده می‌شود.
                            \(dqpassword\(dq: \(dq1234\(dq
                        },

                        // این بخش یک کلاینت مخفی را مشخص می‌کند.
                        {
                            // شناسه کاربری محتوای فایل
                            // /usr/local/share/kea/kea\-creds/hiddenu است.
                            \(dquser\-file\(dq: \(dqhiddenu\(dq,

                            // گذرواژه محتوای فایل
                            // /usr/local/share/kea/kea\-creds/hiddenp است.
                            \(dqpassword\-file\(dq: \(dqhiddenp\(dq
                        },

                        // این بخش یک کلاینت مخفی را با استفاده از
                        // یک راز در یک فایل مشخص می‌کند.
                        {
                            // راز محتوای فایل
                            // /usr/local/share/kea/kea\-creds/hiddens است که باید در
                            // قالب <user\-id>:<password> باشد.
                            \(dqpassword\-file\(dq: \(dqhiddens\(dq
                        }
                    ]
                }
            }
        ],

        // پیشوندی را مشخص می‌کند که باید به FQDN تولیدشده کلاینت اضافه شود.
        // ممکن است در سطوح سراسری، shared\-network و زیرشبکه مشخص شود.
        \(dqddns\-generated\-prefix\(dq: \(dqmyhost\(dq,

        // پرچم بولی که مشخص می‌کند آیا سرور باید تمایل کلاینت DHCP برای
        // به‌روزرسانی DNS توسط خودش را نادیده بگیرد یا خیر. با تنظیم این پرچم روی true،
        // سرور به‌روزرسانی‌های DNS را برای هر دو داده مستقیم و
        // معکوس DNS ارسال خواهد کرد. مقدار پیش‌فرض false است که نشان می‌دهد
        // سرور در صورت درخواست، به‌روزرسانی DNS را به کلاینت واگذار
        // خواهد کرد. این گزینه می‌تواند در سطوح سراسری، shared\-network،
        // و زیرشبکه مشخص شود.
        \(dqddns\-override\-client\-update\(dq: false,

        // پرچم بولی که مشخص می‌کند آیا سرور باید تمایل کلاینت DHCP
        // مبنی بر عدم به‌روزرسانی DNS را نادیده بگیرد یا خیر. با تنظیم این پارامتر
        // روی true، سرور حتی در صورتی که کلاینت عدم به‌روزرسانی را درخواست کرده باشد،
        // یک به‌روزرسانی DNS ارسال خواهد کرد. این گزینه می‌تواند در سطوح
        // سراسری، shared\-network و زیرشبکه مشخص شود.
        \(dqddns\-override\-no\-update\(dq: false,

        // پسوندی که به نام جزئی ارسال‌شده به DNS پیوست می‌شود. مقدار
        // پیش‌فرض یک رشته خالی است که نشان می‌دهد هیچ پسوندی
        // پیوست نمی‌شود. این گزینه می‌تواند در سطوح سراسری،
        // shared\-network و زیرشبکه مشخص شود.
        \(dqddns\-qualifying\-suffix\(dq: \(dq\(dq,

        // شمارشی که مشخص می‌کند آیا سرور باید نام میزبان یا FQDN کلاینت
        // ارسال‌شده توسط کلاینت را رعایت کند یا این نام را جایگزین نماید.
        // مقادیر پذیرفتنی عبارتند از: \(dqnever\(dq (استفاده از نامی که
        // کلاینت ارسال کرده)، \(dqalways\(dq (جایگزینی نام ارسال‌شده توسط
        // کلاینت)، \(dqwhen\-present\(dq (جایگزینی نام ارسالی کلاینت،
        // اما عدم تولید نام در صورتی که کلاینت نامی ارسال نکرده باشد)،
        // \(dqwhen\-not\-present\(dq (تولید نام زمانی که کلاینت نامی ارسال
        // نکرده باشد، در غیر این صورت حفظ نام ارسال‌شده توسط کلاینت).
        // مقدار پیش‌فرض \(dqnever\(dq است. این گزینه می‌تواند در سطوح
        // سراسری، shared\-network و زیرشبکه مشخص شود.
        \(dqddns\-replace\-client\-name\(dq: \(dqnever\(dq,

        // پرچم بولی که به‌روزرسانی DDNS را فعال یا غیرفعال می‌کند. مقدار
        // پیش‌فرض آن true است. این گزینه می‌تواند در سطوح سراسری، shared\-
        // network و زیرشبکه مشخص شود. این گزینه همراه با
        // dhcp\-ddns:enable\-updates عمل می‌کند که برای فعال‌سازی اتصال
        // به kea\-dhcp\-ddns باید true باشد.
        \(dqddns\-send\-updates\(dq: true,

        // پرچم بولی که وقتی true باشد، به سرور دستور می‌دهد همیشه
        // هنگام تمدید اجاره‌ها، حتی اگر اطلاعات DNS تغییری نکرده باشد،
        // DNS را به‌روزرسانی کند. رفتار پیش‌فرض سرور (یعنی وقتی پرچم false است)
        // این است که فقط در صورت تغییر اطلاعات DNS، آن را به‌روزرسانی کند. این گزینه
        // می‌تواند در سطوح سراسری، shared\-network و زیرشبکه مشخص شود.
        \(dqddns\-update\-on\-renew\(dq: true,

        // پرچم بولی که با هر درخواست به‌روزرسانی DDNS به kea\-dhcp\-ddns ارسال
        // می‌شود تا مشخص کند آیا حل تعارض به‌روزرسانی DNS مطابق آنچه در
        // RFC 4703 شرح داده شده باید برای درخواست به‌روزرسانی داده‌شده به کار رود
        // یا خیر. مقدار پیش‌فرض این پرچم true است. این گزینه می‌تواند در سطوح
        // سراسری، shared\-network و زیرشبکه مشخص شود.
        // این فیلد با ddns\-conflict\-resolution\-mode جایگزین شده است.
        // تجزیه این گزینه تنها برای سازگاری با نسخه‌های پیشین حفظ شده است.
        // \(dqddns\-use\-conflict\-resolution\(dq: true,

        // شمارشی که با هر درخواست به‌روزرسانی DDNS به kea\-dhcp\-ddns
        // ارسال می‌شود تا حالت مورد استفاده برای حل تعارض‌ها هنگام انجام
        // به‌روزرسانی‌های DDNS را مشخص کند. مقادیر پذیرفتنی عبارتند از:
        // check\-with\-dhcid (شامل افزودن رکورد DHCID و بررسی آن رکورد
        // از طریق تشخیص تعارض مطابق با RFC 4703)،
        // no\-check\-with\-dhcid (تشخیص تعارض را نادیده می‌گیرد اما هنگام
        // ایجاد/به‌روزرسانی یک مدخل، یک رکورد DHCID می‌افزاید)،
        // check\-exists\-with\-dhcid (بررسی می‌کند که آیا رکورد DHCID موجود است
        // یا خیر اما تطابق مقدار رکورد با به‌روزرسانی را تأیید نمی‌کند.
        // همچنین رکورد DHCID را برای مدخل به‌روزرسانی می‌کند)،
        // no\-check\-without\-dhcid (تشخیص تعارض را نادیده می‌گیرد و هنگام
        // ایجاد/به‌روزرسانی یک مدخل DDNS هیچ رکورد DHCID اضافه نمی‌کند).
        // مقدار پیش‌فرض \(dqcheck\-with\-dhcid\(dq است. این گزینه می‌تواند در
        // سطوح سراسری، shared\-network و زیرشبکه مشخص شود.
        \(dqddns\-conflict\-resolution\-mode\(dq: \(dqcheck\-with\-dhcid\(dq,

        // هنگامی که بزرگ‌تر از 0.0 باشد، درصدی از طول‌عمر اجاره است
        // که برای DNS TTL استفاده می‌شود.
        \(dqddns\-ttl\-percent\(dq: 0.75,

        // هنگامی که بزرگ‌تر از 0 باشد، به عنوان DNS TTL استفاده خواهد شد. بر حسب ثانیه مشخص می‌شود.
        // نمی‌توانید هر دو ddns\-ttl و هر یک از گزینه‌های ddns\-ttl\-percent ،ddns\-ttl\-min یا
        // ddns\-ttl\-max را با هم مشخص کنید. این موارد مانعة‌الجمع هستند.
        // \(dqddns\-ttl\(dq: 500,

        // هنگامی که بزرگ‌تر از 0 باشد، به عنوان حد پایین مقادیر محاسبه‌شده DNS TTL استفاده می‌شود.
        // بر حسب ثانیه مشخص می‌شود.
        \(dqddns\-ttl\-min\(dq: 24000,

        // هنگامی که بزرگ‌تر از 0 باشد، به عنوان حد بالای مقادیر محاسبه‌شده DNS TTL استفاده می‌شود.
        // بر حسب ثانیه مشخص می‌شود.
        \(dqddns\-ttl\-max\(dq: 64000,

        // زمان بر حسب ثانیه که مشخص می‌کند یک اجاره ردشده (declined) چه مدت باید
        // از تخصیص‌های DHCP کنار گذاشته شود. مقدار پیش‌فرض 86400 (۲۴ ساعت) است.
        \(dqdecline\-probation\-period\(dq: 86400,

        // پیکربندی هدایت درخواست تغییر نام (NCR) برای کارگزار Kea DHCPv4.
        // درخواست‌های NCR به ماژول Kea D2 ارسال می‌شوند تا پس از تخصیص
        // اجاره‌های DHCP، سیستم DNS را به‌روزرسانی کند.
        \(dqdhcp\-ddns\(dq: {
            // پرچم بولی که مشخص می‌کند آیا کارگزار Kea DHCPv4 باید به
            // kea\-dhcp\-ddns متصل شود یا خیر. این گزینه باید true باشد تا NCRها
            // ایجاد شده و به kea\-dhcp\-ddns ارسال شوند. به‌طور پیش‌فرض، NCRها تولید نمی‌شوند.
            \(dqenable\-updates\(dq: false,

            // حداکثر تعداد NCRهایی را که در صف در انتظار ارسال
            // به کارگزار Kea D2 قرار می‌گیرند مشخص می‌کند.
            \(dqmax\-queue\-size\(dq: 1024,

            // قالب بسته برای استفاده هنگام ارسال NCRها به کارگزار Kea D2.
            // در حال حاضر، تنها قالب JSON پشتیبانی می‌شود.
            \(dqncr\-format\(dq: \(dqJSON\(dq,

            // پروتکل سوکت برای استفاده هنگام ارسال NCRها به D2. در حال حاضر،
            // تنها UDP پشتیبانی می‌شود.
            \(dqncr\-protocol\(dq: \(dqUDP\(dq,

            // آدرس IP که کارگزار Kea DHCPv4 باید برای ارسال NCRها به D2
            // از آن استفاده کند. مقدار پیش‌فرض صفر نشان می‌دهد که Kea
            // باید یک آدرس مناسب را انتخاب کند.
            \(dqsender\-ip\(dq: \(dq0.0.0.0\(dq,

            // شماره درگاهی که کارگزار Kea DHCPv4 باید برای ارسال NCRها
            // به D2 از آن استفاده کند. مقدار پیش‌فرض صفر نشان می‌دهد که Kea
            // باید یک درگاه مناسب را انتخاب کند.
            \(dqsender\-port\(dq: 0,

            // آدرس IP که D2 روی آن به NCRها گوش فرا می‌دهد.
            \(dqserver\-ip\(dq: \(dq127.0.0.1\(dq,

            // شماره درگاهی که D2 روی آن به NCRها گوش فرا می‌دهد.
            \(dqserver\-port\(dq: 53001
        },

        // اولین درگاه از دو درگاه متوالی سوکت‌های UDP مورد استفاده
        // برای ارتباط بین کارگزارهای DHCPv6 و DHCPv4 را مشخص می‌کند.
        // به RFC 7341 مراجعه کنید. (پیش‌فرض 0 \- غیرفعال).
        // در صورت فعال بودن، مثلاً از 786 استفاده کنید.
        \(dqdhcp4o6\-port\(dq: 0,

        // پرچم بولی که مشخص می‌کند آیا کارگزار Kea DHCPv4
        // باید گزینه Client Identifier را در پاسخ‌های خود بازپس بفرستد یا خیر.
        // مقدار پیش‌فرض true است که نشان می‌دهد در صورت قرار داشتن گزینه
        // در درخواست کلاینت، باید بازگردانده شود. مقدار false
        // به کارگزار دستور می‌دهد که برای سازگاری با مشخصات قدیمی‌تر
        // DHCP که بیان می‌کردند Client Identifier نباید بازگردانده شود، این گزینه را ارسال نکند.
        \(dqecho\-client\-id\(dq: true,

        // مجموعه‌ای از پارامترهای کارگزار Kea DHCPv4 که نحوه پردازش
        // اجاره‌های منقضی‌شده DHCP توسط کارگزار را پیکربندی می‌کند.
        \(dqexpired\-leases\-processing\(dq: {
            // تعداد ثانیه‌ها از آخرین حذف اجاره‌های منقضی‌شده را مشخص می‌کند
            // که پس از آن حذف بعدی باید رخ دهد.
            // اگر هر دو گزینه \(dqflush\-reclaimed\-timer\-wait\-time\(dq و
            // \(dqhold\-reclaimed\-time\(dq صفر نباشند، هنگامی که کلاینت پیام release
            // ارسال می‌کند، اجاره به جای حذف شدن از حافظه اجاره‌ها،
            // منقضی می‌شود.
            \(dqflush\-reclaimed\-timer\-wait\-time\(dq: 25,

            // مدت‌زمان بر حسب ثانیه را برای نگهداری اجاره‌های منقضی‌شده
            // در پایگاه‌داده اجاره‌ها مشخص می‌کند (وابستگی اجاره یا lease affinity).
            // اگر هر دو گزینه \(dqflush\-reclaimed\-timer\-wait\-time\(dq و
            // \(dqhold\-reclaimed\-time\(dq صفر نباشند، هنگامی که کلاینت پیام release
            // ارسال می‌کند، اجاره به جای حذف شدن از حافظه اجاره‌ها،
            // منقضی می‌شود.
            \(dqhold\-reclaimed\-time\(dq: 3600,

            // حداکثر تعداد اجاره‌های منقضی‌شده‌ای را مشخص می‌کند که می‌توانند
            // در یک تلاش برای پاک‌سازی اجاره‌های منقضی‌شده از پایگاه‌داده
            // اجاره‌ها پردازش شوند. اگر اجاره‌های منقضی‌شده بیشتری وجود داشته
            // باشد، در طول تلاش بعدی پاک‌سازی پردازش خواهند شد.
            \(dqmax\-reclaim\-leases\(dq: 100,

            // حداکثر زمان بر حسب میلی‌ثانیه را که یک تلاش برای پاک‌سازی
            // اجاره‌های منقضی‌شده از پایگاه‌داده اجاره‌ها ممکن است طول بکشد، مشخص می‌کند.
            \(dqmax\-reclaim\-time\(dq: 250,

            // مدت‌زمان بر حسب ثانیه از آخرین تلاش برای پردازش اجاره‌های
            // منقضی‌شده پیش از آغاز تلاش بعدی را مشخص می‌کند.
            \(dqreclaim\-timer\-wait\-time\(dq: 10,

            // حداکثر تعداد چرخه‌های پردازش اجاره‌های منقضی‌شده را مشخص می‌کند
            // که منجر به پاک‌سازی کامل اجاره‌های منقضی‌شده از پایگاه‌داده اجاره‌ها
            // نشده‌اند، که پس از آن یک پیام هشدار صادر می‌شود.
            \(dqunwarned\-reclaim\-cycles\(dq: 5
        },

        // فهرست کتابخانه‌های قلاب و پارامترهای پیکربندی اختصاصی آن‌ها
        // که باید توسط کارگزار Kea DHCPv4 بارگذاری شوند.
        \(dqhooks\-libraries\(dq: [
            {
                // مکان کتابخانه قلاب برای بارگذاری.
                \(dqlibrary\(dq: \(dqlibdhcp_lease_cmds.so\(dq,

                // پارامترهای پیکربندی اختصاصی کتابخانه قلاب.
                \(dqparameters\(dq: { }
            },
            {
                // کتابخانه قلاب بک‌اند میزبان MySQL مورد نیاز برای ذخیره‌سازی میزبان.
                \(dqlibrary\(dq: \(dqlibdhcp_mysql.so\(dq
            },
            {
                // کتابخانه قلاب بک‌اند میزبان PostgreSQL مورد نیاز برای ذخیره‌سازی میزبان.
                \(dqlibrary\(dq: \(dqlibdhcp_pgsql.so\(dq
            }
        ],

        // فهرست اطلاعات اعتباری دسترسی به منابع خارجی رزروهای IPv4،
        \(dqhosts\-databases\(dq: [
            {
                // نام پایگاه‌داده برای اتصال.
                \(dqname\(dq: \(dqkeatest\(dq,

                // میزبانی که پایگاه‌داده روی آن قرار دارد.
                \(dqhost\(dq: \(dqlocalhost\(dq,

                // گذرواژه پایگاه‌داده.
                \(dqpassword\(dq: \(dq1234\(dq,

                // درگاهی که پایگاه‌داده روی آن در دسترس است.
                \(dqport\(dq: 3306,

                // نوع پایگاه‌داده، مثلاً \(dqmysql\(dq، \(dqpostgresql\(dq.
                \(dqtype\(dq: \(dqmysql\(dq,

                // نام کاربری مورد استفاده برای دسترسی به پایگاه‌داده.
                \(dquser\(dq: \(dqkeatest\(dq,

                // حالت فقط‌خواندنی.
                \(dqreadonly\(dq: false,

                // مدخل‌های بعدی برای پشتیبانی از OpenSSL در MySQL هستند.

                // لنگر اعتماد (trust anchor) یا همان فایل یا دایرکتوری مرجع صدور گواهی (CA).
                \(dqtrust\-anchor\(dq: \(dqmy\-ca\(dq,

                // نام فایل گواهی کلاینت.
                \(dqcert\-file\(dq: \(dqmy\-cert\(dq,

                // نام فایل کلید خصوصی.
                \(dqkey\-file\(dq: \(dqmy\-key\(dq,

                // فهرست الگوریتم‌های رمزنگاری (راهنمای دستور ciphers در OpenSSL را ببینید).
                \(dqcipher\-list\(dq: \(dqAES\(dq,

                // زمان انتظار برای اتصال مجدد.
                // این پارامتر تعیین می‌کند که Kea چه مدت قبل از تلاش مجدد برای
                // اتصال منتظر بماند. بر حسب میلی‌ثانیه بیان می‌شود. مقدار پیش‌فرض 0
                // (غیرفعال) برای MySQL و PostgreSQL است.
                \(dqreconnect\-wait\-time\(dq: 3000,

                // حداکثر دفعات تلاش برای اتصال مجدد.
                \(dqmax\-reconnect\-tries\(dq: 3,

                // اقدامی که در صورت شکست بازیابی اتصال باید انجام شود.
                // مقادیر پشتیبانی‌شده: stop\-retry\-exit، serve\-retry\-exit،
                // serve\-retry\-continue
                \(dqon\-fail\(dq: \(dqstop\-retry\-exit\(dq,

                // پرچمی که مشخص می‌کند آیا بازیابی پایگاه‌داده باید در هنگام راه‌اندازی
                // کارگزار و رویدادهای بازپیکربندی مورد تلاش قرار گیرد یا خیر.
                \(dqretry\-on\-startup\(dq: false,

                // مهلت زمانی برقراری اتصال به ثانیه.
                \(dqconnect\-timeout\(dq: 100,

                // مهلت زمانی عملیات خواندن پایگاه‌داده به ثانیه.
                \(dqread\-timeout\(dq: 120,

                // مهلت زمانی عملیات نوشتن پایگاه‌داده به ثانیه.
                \(dqwrite\-timeout\(dq: 180
            },
            {
                // نام پایگاه‌داده برای اتصال.
                \(dqname\(dq: \(dqkeatest\(dq,

                // میزبانی که پایگاه‌داده روی آن قرار دارد.
                \(dqhost\(dq: \(dqlocalhost\(dq,

                // گذرواژه پایگاه‌داده.
                \(dqpassword\(dq: \(dq1234\(dq,

                // درگاهی که پایگاه‌داده روی آن در دسترس است.
                \(dqport\(dq: 5432,

                // نوع پایگاه‌داده، مثلاً \(dqmysql\(dq، \(dqpostgresql\(dq.
                \(dqtype\(dq: \(dqpostgresql\(dq,

                // نام کاربری مورد استفاده برای دسترسی به پایگاه‌داده.
                \(dquser\(dq: \(dqkeatest\(dq,

                // مهلت زمانی TCP کاربر هنگام ارتباط با پایگاه‌داده.
                // بر حسب ثانیه مشخص می‌شود.
                \(dqtcp\-user\-timeout\(dq: 100,

                // لنگر اعتماد (trust anchor) یا همان فایل یا دایرکتوری مرجع صدور گواهی (CA).
                \(dqtrust\-anchor\(dq: \(dqmy\-ca\(dq,

                // نام فایل گواهی کلاینت.
                \(dqcert\-file\(dq: \(dqmy\-cert\(dq,

                // نام فایل کلید خصوصی.
                \(dqkey\-file\(dq: \(dqmy\-key\(dq,

                // حالت SSL.
                \(dqssl\-mode\(dq: \(dqverify\-ca\(dq
            }
        ],

        // فهرست انواع شناسه‌های رزرو میزبان که توسط کارگزار
        // Kea DHCPv4 برای واکشی رزروهای ایستا برای کلاینت‌های
        // DHCP استفاده می‌شود. به‌طور پیش‌فرض همه شناسه‌ها استفاده می‌شوند،
        // به این معنی که کارگزار چندین پرس‌وجو به پایگاه‌داده ارسال می‌کند تا
        // مشخص شود آیا رزروی برای یک کلاینت خاص وجود دارد یا خیر. اگر
        // یک استقرار خاص تنها از یک زیرمجموعه استفاده می‌کند، مثلاً یک نوع شناسه،
        // تنها آن شناسه باید در اینجا فهرست شود تا از پرس‌وجوهای
        // غیرضروری به پایگاه‌داده جلوگیری شود.
        \(dqhost\-reservation\-identifiers\(dq: [
            \(dqhw\-address\(dq,
            \(dqduid\(dq,
            \(dqcircuit\-id\(dq,
            \(dqclient\-id\(dq,
            \(dqflex\-id\(dq
        ],

        // پیکربندی رابط‌هایی را مشخص می‌کند که کارگزار Kea DHCPv4
        // روی آن‌ها به پرس‌وجوهای DHCP گوش فرا می‌دهد.
        \(dqinterfaces\-config\(dq: {
            // مشخص می‌کند که آیا سرور باید از سوکت‌های \(dqudp\(dq یا
            // سوکت‌های \(dqraw\(dq برای گوش دادن به ترافیک DHCP استفاده کند. سوکت‌های
            // \(dqraw\(dq زمانی مفید هستند که ترافیک مستقیم DHCP در حال
            // دریافت باشد.
            \(dqdhcp\-socket\-type\(dq: \(dqudp\(dq,

            // فهرستی از رابط‌ها را مشخص می‌کند که کارگزار Kea DHCPv4
            // باید روی آن‌ها به درخواست‌های DHCP گوش فرا دهد.
            \(dqinterfaces\(dq: [
                \(dqeth0\(dq
            ],

            // شمارشی که مشخص می‌کند چه رابطی باید برای ارسال
            // پاسخ‌های DHCP به کلاینت استفاده شود. مقدار پیش‌فرض
            // \(dqsame\-as\-inbound\(dq است که نشان می‌دهد پاسخ باید از طریق
            // رابطی که پرس‌وجوی کلاینت روی آن دریافت شده ارسال شود.
            // مقدار \(dquse\-routing\(dq نشان می‌دهد که کارگزار Kea باید از جدول
            // مسیریابی هسته برای یافتن یک رابط مناسب استفاده کند.
            \(dqoutbound\-interface\(dq: \(dqsame\-as\-inbound\(dq,

            // پرچم بولی که مشخص می‌کند آیا رابط‌های موجود باید در هنگام
            // بازپیکربندی کارگزار مجدداً شناسایی شوند یا خیر. مقدار پیش‌فرض
            // true است که به این معنی است رابط‌ها همیشه مجدداً
            // شناسایی می‌شوند.
            \(dqre\-detect\(dq: true,

            // Kea سعی می‌کند در حین مقداردهی اولیه به سوکت‌های سرویس متصل (bind) شود، اما ممکن
            // است به دلیل باز بودن قبلی درگاه یا پیکربندی نادرست شکست بخورد. Kea می‌تواند
            // این خطاها را نادیده گرفته و فقط آن‌ها را ثبت کند. این پرچم از شروع به کار
            // کارگزار DHCP بدون اتصال همه سوکت‌ها جلوگیری می‌کند. در صورت عدم تعیین،
            // مقدار پیش‌فرض آن false است.
            \(dqservice\-sockets\-require\-all\(dq: true,

            // Kea سعی می‌کند در حین مقداردهی اولیه به سوکت‌های سرویس متصل شود. این
            // گزینه مشخص می‌کند که چند بار تلاش مجدد برای اتصال به رابط انجام خواهد شد.
            // مقدار پیش‌فرض 0 است، به این معنی که عملیات تکرار نخواهد شد.
            \(dqservice\-sockets\-max\-retries\(dq: 5,

            // بازه زمانی بر حسب میلی‌ثانیه برای انتظار قبل از تلاش بعدی
            // برای باز کردن مجدد سوکت سرویس.
            \(dqservice\-sockets\-retry\-wait\-time\(dq: 5000
        },

        // پارامتر بولی که کنترل می‌کند آیا جستجوی زودهنگام رزروهای سراسری میزبان
        // باید انجام شود یا خیر. این جستجو قبل از انتخاب زیرشبکه صورت می‌گیرد
        // و هنگامی که یک رزرو سراسری با برخی کلاس‌های کلاینت یافت شود،
        // مرحله دوم رده‌بندی را راه‌اندازی می‌کند. همچنین می‌تواند برای رها کردن
        // پرس‌وجوها با استفاده از رزروهای میزبان به عنوان جدول تصمیم‌گیری
        // نمایه‌شده با شناسه‌های رزرو به کار رود.
        \(dqearly\-global\-reservations\-lookup\(dq: true,

        // پارامتر بولی که رفتار کارگزار DHCP را در رابطه با ایجاد رزروهای
        // میزبان برای یک آدرس IP یکسان کنترل می‌کند. به‌طور پیش‌فرض
        // این پرچم روی true تنظیم شده است که در این حالت سرور از ایجاد
        // چندین رزرو میزبان برای یک آدرس IP یکسان جلوگیری می‌کند. هنگامی که
        // این پارامتر روی false تنظیم شود، سرور اجازه ایجاد چندین رزرو
        // برای یک آدرس IP یکسان را در یک زیرشبکه می‌دهد. این تنظیم در
        // استقرارهایی مفید است که در آن‌ها یک میزبان ممکن است از طریق چندین رابط
        // با کارگزار DHCP ارتباط برقرار کند و بسته به رابط انتخاب‌شده، یک آدرس MAC
        // متفاوت (یا شناسه دیگر) برای شناسایی میزبان استفاده شود. توجه داشته باشید
        // که برخی از بک‌اندهای میزبان از حالتی که چندین رزرو برای یک آدرس IP
        // یکسان استفاده شود پشتیبانی نمی‌کنند. اگر این بک‌اندها در حال استفاده باشند
        // و این تنظیم اعمال شود، یک خطای پیکربندی رخ خواهد داد. بک‌اندهای MySQL و
        // PostgreSQL از این حالت پشتیبانی می‌کنند.
        \(dqip\-reservations\-unique\(dq: true,

        // پارامتر بولی که کنترل می‌کند آیا جستجوی رزروهای میزبان باید قبل از
        // جستجوی اجاره انجام شود یا خیر. این پارامتر تنها زمانی تأثیر دارد که
        // چندنخی غیرفعال باشد. هنگامی که چندنخی فعال باشد، جستجوی رزروهای
        // میزبان همیشه ابتدا انجام می‌شود تا از قفل شدن منابع جستجوی اجاره
        // جلوگیری شود.
        \(dqreservations\-lookup\-first\(dq: true,

        // اطلاعات اعتباری برای دسترسی به پایگاه‌داده اجاره را مشخص می‌کند.
        \(dqlease\-database\(dq: {
            // پارامتر اختصاصی بک‌اند memfile که بازه زمانی بر حسب ثانیه را
            // مشخص می‌کند که در آن فایل اجاره باید پاک‌سازی شود (مدخل‌های قدیمی
            // اجاره حذف می‌شوند تا از رشد بی‌رویه فایل اجاره جلوگیری شود).
            \(dqlfc\-interval\(dq: 3600,

            // حداکثر تعداد خطاهای خواندن فایل اجاره مجاز قبل از این که
            // بارگذاری فایل متوقف شود. پیش‌فرض 0 است (بدون محدودیت).
            \(dqmax\-row\-errors\(dq: 100,

            // نام فایل اجاره. در مورد پایگاه‌داده، نام پایگاه‌داده را
            // مشخص می‌کند.
            \(dqname\(dq: \(dqkea\-leases4.csv\(dq,

            // پارامتر اختصاصی memfile که مشخص می‌کند آیا اجاره‌ها باید
            // روی حافظه پایدار (دیسک) ذخیره شوند یا خیر. مقدار true
            // پیش‌فرض است و نشان می‌دهد که اجاره‌ها در حافظه پایدار
            // ذخیره می‌شوند. این تنظیم باید در محیط عملیاتی استفاده شود.
            // مقدار false تنها باید برای اهداف آزمایشی استفاده شود
            // زیرا اجاره‌های ذخیره‌نشده با راه‌اندازی مجدد سرور Kea از بین می‌روند.
            \(dqpersist\(dq: true,

            // نوع بک‌اند پایگاه‌داده اجاره، یعنی \(dqmemfile\(dq، \(dqmysql\(dq یا
            // \(dqpostgresql\(dq.
            \(dqtype\(dq: \(dqmemfile\(dq
        },

        // مقدار بولی که مشخص می‌کند آیا کارگزار Kea DHCPv4 باید از مقدار شناسه
        // کلاینت ارسال‌شده توسط کلاینت استفاده کند یا آن را نادیده بگیرد. مقدار پیش‌فرض
        // true است که نشان می‌دهد کارگزار باید از شناسه کلاینت استفاده کند
        // و این شناسه بر آدرس MAC کلاینت ارجحیت دارد. در استقرارهایی که
        // آدرس MAC باید ارجحیت داشته باشد، این مقدار می‌تواند روی false تنظیم شود
        // که در این حالت کلاینت‌ها با آدرس MAC شناسایی می‌شوند.
        // این ویژگی به‌ویژه زمانی مفید است که کلاینت‌ها شناسه‌های یکتا تولید نمی‌کنند
        // یا این شناسه‌ها پایدار نیستند، و غیره.
        \(dqmatch\-client\-id\(dq: false,

        // مقدار سراسری آدرس کارگزار بعدی تنظیم‌شده در فیلد \(aqsiaddr\(aq.
        // مقدار سراسری ممکن است در محدوده‌های پیکربندی سطح پایین‌تر
        // بازنویسی (override) شود.
        \(dqnext\-server\(dq: \(dq192.0.2.123\(dq,

        // مقدار سراسری که تعداد بسته‌های کلاینت (مانند DHCPREQUESTها) را محدود
        // می‌کند که می‌توانند در انتظار اتمام کار کتابخانه قلاب، قبل از
        // ارسال پاسخ (مانند DHCPACK) به کلاینت متوقف (پارک) شوند. یک مثال
        // رایج زمانی است که kea\-dhcp4 یک DHCPREQUEST را متوقف می‌کند در حالی که
        // به‌روزرسانی(های) اجاره را به همتایان HA خود ارسال می‌نماید. بسته پس از
        // تأیید به‌روزرسانی(ها) از حالت توقف خارج می‌شود. این مقدار، تعداد بسته‌هایی را
        // که می‌توانند در انتظار به‌روزرسانی‌ها نگه‌داشته شوند محدود می‌کند. در زمان ترافیک
        // سنگین کلاینت‌ها، این مقدار می‌تواند مانع از تجمع بیش از حد به‌روزرسانی‌ها در kea\-dhcp4 شود.
        \(dqparked\-packet\-limit\(dq: 256,

        // فهرست گزینه‌های سراسری DHCP که کارگزار Kea DHCPv4 به
        // کلاینت‌ها اختصاص می‌دهد.
        \(dqoption\-data\(dq: [
            {
                // پرچم بولی که مشخص می‌کند آیا گزینه داده‌شده همیشه
                // در پاسخ ارسال شود یا تنها در صورت درخواست. مقدار
                // پیش‌فرض false نشان می‌دهد که تنها در صورت درخواست
                // ارسال می‌شود.
                \(dqalways\-send\(dq: false,

                // یک فهرست اختیاری از کلاس‌هایی که این گزینه برای آن‌ها اعمال می‌شود.
                // اگر کلاینت با هر یک از کلاس‌های این فهرست مطابقت داشته باشد،
                // گزینه اعمال خواهد شد. اگر فهرست خالی باشد یا حذف شود،
                // این گزینه صرف‌نظر از عضویت در کلاس اعمال خواهد شد.
                \(dqclient\-classes\(dq: [ \(dqclass1\(dq, \(dqclass2\(dq ],

                // کد گزینه. در صورت ارائه نام گزینه، الزامی نیست.
                \(dqcode\(dq: 6,

                // مقدار بولی که مشخص می‌کند آیا داده گزینه مشخص‌شده
                // در فیلد \(dqdata\(dq به صورت رشته‌ای از ارقام هگزادسیمال
                // مشخص شده است یا در قالب CSV خوانا برای انسان.
                \(dqcsv\-format\(dq: true,

                // داده گزینه برای ذخیره در بار مفید (payload) گزینه.
                \(dqdata\(dq: \(dq192.0.3.1, 192.0.3.2\(dq,

                // نام گزینه. در صورت ارائه کد گزینه، الزامی نیست.
                \(dqname\(dq: \(dqdomain\-name\-servers\(dq,

                // پرچم بولی که مشخص می‌کند آیا گزینه داده‌شده هرگز
                // در پاسخ ارسال نشود. مقدار پیش‌فرض false نشان می‌دهد
                // که در مواقع لزوم ارسال می‌شود. هنگامی که true باشد،
                // گزینه بدون توجه به هر تنظیم دیگری ارسال نمی‌شود، یعنی
                // یک پرچم قطعی و نهایی است.
                \(dqnever\-send\(dq: false,

                // فضای گزینه. پیش‌فرض فضای گزینه \(dqdhcp4\(dq است که
                // گزینه‌های سطح بالای DHCPv4 را گروه‌بندی می‌کند.
                \(dqspace\(dq: \(dqdhcp4\(dq
            }
        ],

        // فهرست تعاریف گزینه‌های سراسری، یعنی قالب‌های گزینه، که کارگزار
        // Kea DHCPv4 از آن‌ها استفاده می‌کند.
        \(dqoption\-def\(dq: [
            {
                // پرچم بولی که مشخص می‌کند آیا تعریف گزینه شامل
                // آرایه‌ای از مقادیر از یک نوع است، مثلاً آرایه‌ای از آدرس‌های IPv4.
                // مقدار پیش‌فرض false به این معنی است که گزینه شامل
                // آرایه‌ای از مقادیر نیست.
                \(dqarray\(dq: false,

                // کد گزینه.
                \(dqcode\(dq: 6,

                // نام فضای گزینه‌ای را نگهداری می‌کند که توسط این گزینه کپسوله شده است.
                // تمام گزینه‌های متعلق به این فضای گزینه به عنوان زیرگزینه‌های
                // این گزینه ارسال خواهند شد. یک رشته خالی به این معنی است که این
                // گزینه هیچ گزینه‌ای را کپسوله نمی‌کند.
                \(dqencapsulate\(dq: \(dq\(dq,

                // نام گزینه.
                \(dqname\(dq: \(dqmy\-option\(dq,

                // انواع فیلدهای درون گزینه را در صورتی که گزینه یک \(dqrecord\(dq
                // باشد مشخص می‌کند (\(dqtype\(dq را ببینید). در این مثال خاص،
                // این گزینه شامل دو فیلد با طول‌های ۱ بایت و ۲ بایت است.
                \(dqrecord\-types\(dq: \(dquint8, uint16\(dq,

                // نام فضای گزینه‌ای که این گزینه به آن تعلق دارد.
                \(dqspace\(dq: \(dqmy\-space\(dq,

                // نوع گزینه. تمام انواع ممکن در راهنمای مرجع
                // مدیر سیستم Kea فهرست شده‌اند.
                \(dqtype\(dq: \(dqrecord\(dq
            }
        ],

        // مقدار سراسری برای تایمر rebind، یعنی زمانی که کلاینت
        // DHCP پس از آن در صورت عدم موفقیت در تمدید اجاره، وارد حالت rebind می‌شود.
        \(dqrebind\-timer\(dq: 40,

        // مقدار سراسری برای تایمر renew، یعنی زمانی که کلاینت
        // DHCP پس از آن اجاره را تمدید می‌کند.
        \(dqrenew\-timer\(dq: 30,

        // مقدار سراسری برای ذخیره اطلاعات گسترش‌یافته (مانند اطلاعات
        // عامل رله) همراه با هر اجاره.
        \(dqstore\-extended\-info\(dq: true,

        // آمارها تعدادی نمونه به ازای هر نقطه مشاهده نگهداری می‌کنند.
        // دو مقدار پیش‌فرض وجود دارد: حداکثر تعداد و حداکثر طول‌عمر.
        // تنظیم حداکثر تعداد روی صفر آن را غیرفعال می‌کند.
        \(dqstatistic\-default\-sample\-count\(dq: 0,

        // هنگامی که حداکثر تعداد 0 باشد، حداکثر طول‌عمر (به ثانیه) اعمال می‌شود.
        \(dqstatistic\-default\-sample\-age\(dq: 60,

        // پارامترهای چندنخی (Multi\-threading).
        \(dqmulti\-threading\(dq: {
            // به‌طور پیش‌فرض، Kea در صورت پشتیبانی سخت‌افزار، بسته‌ها را روی چندین نخ پردازش می‌کند.
            \(dqenable\-multi\-threading\(dq: true,

            // هنگامی که چندنخی فعال باشد، Kea بسته‌ها را روی تعدادی
            // از نخ‌ها پردازش می‌کند که از طریق این گزینه قابل پیکربندی است. مقدار
            // باید یک عدد صحیح مثبت باشد (0 یعنی تشخیص خودکار).
            \(dqthread\-pool\-size\(dq: 0,

            // هنگامی که چندنخی فعال باشد، Kea بسته‌ها را از رابط خوانده
            // و یک آیتم کاری به مخزن نخ‌ها اضافه می‌کند. این گزینه
            // حداکثر تعداد مواردی را که می‌توانند در صف قرار گیرند پیکربندی می‌کند.
            // مقدار باید یک عدد صحیح مثبت باشد (0 یعنی نامحدود).
            \(dqpacket\-queue\-size\(dq: 0
        },

        // نحوه برخورد کارگزار Kea DHCPv4 با داده‌های نامعتبر
        // دریافت‌شده از کلاینت را تعیین می‌کند.
        \(dqsanity\-checks\(dq: {
            // مشخص می‌کند که کارگزار Kea DHCPv4 هنگام خواندن داده‌های
            // نامعتبر برای یک اجاره از فایل اجاره چگونه باید رفتار کند. مقادیر
            // زیر پشتیبانی می‌شوند: \(dqnone\(dq (عدم تلاش برای تصحیح اطلاعات
            // اجاره)، \(dqwarn\(dq (چاپ هشدار برای ناسازگاری‌های مربوط به subnet\-id)،
            // \(dqfix\(dq (تصحیح شناسه زیرشبکه با تلاش برای یافتن زیرشبکه مناسب)،
            // \(dqfix\-del\(dq (مشابه \(dqfix\(dq اما در صورت عدم یافتن زیرشبکه مناسب،
            // اجاره را حذف می‌کند)، \(dqdel\(dq (در صورتی که اجاره مقدار شناسه
            // زیرشبکه نامعتبر داشته باشد، آن را حذف می‌کند).
            \(dqlease\-checks\(dq: \(dqwarn\(dq,

            // مشخص می‌کند که کارگزار Kea DHCPv4 در هنگام خوانده شدن اطلاعات گسترش‌یافته
            // نامعتبر برای یک اجاره از فایل اجاره، یا برای ارتقا از قالب قدیمی
            // چگونه باید رفتار کند. مقادیر زیر پشتیبانی می‌شوند: \(dqnone\(dq (عدم تلاش
            // برای تصحیح یا ارتقای اطلاعات گسترش‌یافته)، \(dqfix\(dq (رفع ناسازگاری‌های
            // رایج و ارتقا از قالب قدیمی؛ این مقدار پیش‌فرض است)، \(dqstrict\(dq
            // (رفع ناسازگاری‌های دارای تأثیر بر Leasequery)،
            // \(dqpedantic\(dq (اعمال قالب کامل کد Kea).
            \(dqextended\-info\-checks\(dq: \(dqfix\(dq
        },

        // فهرست شبکه‌های مشترک مورد استفاده توسط کارگزار Kea DHCPv4. شبکه‌های
        // مشترک زیرشبکه‌ها را با یکدیگر گروه‌بندی می‌کنند.
        \(dqshared\-networks\(dq: [
            {
                // پرچمی برای انتخاب راهبرد تخصیص آدرس IP برای همه
                // زیرشبکه‌ها در این شبکه مشترک.
                \(dqallocator\(dq: \(dqrandom\(dq,

                // پرچم معتبر بودن (authoritative) در سطح shared\-network.
                \(dqauthoritative\(dq: false,

                // نام bootfile در سطح shared\-network.
                \(dqboot\-file\-name\(dq: \(dq/dev/null\(dq,

                // این شبکه مشترک را محدود می‌کند تا تنها به کلاینت‌هایی
                // اجازه دهد که حداقل به یک کلاس در این فهرست تعلق دارند. در صورت حذف
                // یا ارائه یک فهرست خالی، هیچ محدودیتی اعمال نمی‌شود.
                \(dqclient\-classes\(dq: [],

                // مقدار در سطح shared\-network. توضیحات را در سطح سراسری ببینید.
                \(dqddns\-generated\-prefix\(dq: \(dqmyhost\(dq,

                // مقدار در سطح shared\-network. توضیحات را در سطح سراسری ببینید.
                \(dqddns\-override\-client\-update\(dq: false,

                // مقدار در سطح shared\-network. توضیحات را در سطح سراسری ببینید.
                \(dqddns\-override\-no\-update\(dq: false,

                // مقدار در سطح shared\-network. توضیحات را در سطح سراسری ببینید.
                \(dqddns\-qualifying\-suffix\(dq: \(dq\(dq,

                // مقدار در سطح shared\-network. توضیحات را در سطح سراسری ببینید.
                \(dqddns\-replace\-client\-name\(dq: \(dqnever\(dq,

                // مقدار در سطح shared\-network. توضیحات را در سطح سراسری ببینید.
                \(dqddns\-send\-updates\(dq: true,

                // مقدار در سطح shared\-network. توضیحات را در سطح سراسری ببینید.
                \(dqddns\-update\-on\-renew\(dq: true,

                // مقدار در سطح shared\-network. توضیحات را در سطح سراسری ببینید.
                // این فیلد با ddns\-conflict\-resolution\-mode جایگزین شده است.
                // تجزیه این گزینه تنها برای سازگاری با نسخه‌های پیشین حفظ شده است.
                // \(dqddns\-use\-conflict\-resolution\(dq: true,

                // مقدار در سطح shared\-network. توضیحات را در سطح سراسری ببینید.
                \(dqddns\-conflict\-resolution\-mode\(dq: \(dqcheck\-with\-dhcid\(dq,

                // مقدار در سطح shared\-network. توضیحات را در سطح سراسری ببینید.
                \(dqddns\-ttl\-percent\(dq: 0.65,

                // مقدار در سطح shared\-network. توضیحات را در سطح سراسری ببینید.
                // نمی‌توانید هر دو ddns\-ttl و هر یک از گزینه‌های ddns\-ttl\-percent ،ddns\-ttl\-min یا
                // ddns\-ttl\-max را با هم مشخص کنید. این موارد مانعة‌الجمع هستند.
                // \(dqddns\-ttl\(dq: 500,

                // مقدار در سطح shared\-network. توضیحات را در سطح سراسری ببینید.
                \(dqddns\-ttl\-min\(dq: 10000,

                // مقدار در سطح shared\-network. توضیحات را در سطح سراسری ببینید.
                \(dqddns\-ttl\-max\(dq: 20000,

                // مقدار در سطح shared\-network. توضیحات را در سطح سراسری ببینید.
                \(dqhostname\-char\-replacement\(dq: \(dqx\(dq,

                // مقدار در سطح shared\-network. توضیحات را در سطح سراسری ببینید.
                \(dqhostname\-char\-set\(dq: \(dq[^A\-Za\-z0\-9.\-]\(dq,

                // مشخص می‌کند که این شبکه مشترک برای درخواست‌های
                // دریافت‌شده روی یک رابط خاص انتخاب شده است.
                \(dqinterface\(dq: \(dqeth0\(dq,

                // پرچم در سطح shared\-network که مشخص می‌کند آیا باید از
                // شناسه کلاینت برای شناسایی کلاینت‌ها استفاده شود یا خیر.
                \(dqmatch\-client\-id\(dq: true,

                // نام شبکه مشترک.
                \(dqname\(dq: \(dqmy\-secret\-network\(dq,

                // تعیین کارگزار بعدی در سطح shared\-network
                // برای ارسال در \(aqsiaddr\(aq.
                \(dqnext\-server\(dq: \(dq192.0.2.123\(dq,

                // اگر بزرگ‌تر از صفر باشد، طول‌عمر اجاره‌هایی است که موقتاً در
                // مرحله DISCOVER تخصیص داده می‌شوند. در صورت صفر بودن (پیش‌فرض)، در DISCOVER اجاره‌ای تخصیص داده نمی‌شود.
                \(dqoffer\-lifetime\(dq : 60,

                // فهرست گزینه‌های DHCP اختصاصی شبکه مشترک.
                \(dqoption\-data\(dq: [],

                // فهرست آدرس‌های رله IPv4 که این شبکه مشترک
                // برای آن‌ها انتخاب می‌شود.
                \(dqrelay\(dq: {
                    \(dqip\-addresses\(dq: []
                },

                // تایمر rebind در سطح shared\-network.
                \(dqrebind\-timer\(dq: 41,

                // تایمر renew در سطح shared\-network.
                \(dqrenew\-timer\(dq: 31,

                // محاسبه تایمرهای T1 و T2 در سطح shared\-network.
                \(dqcalculate\-tee\-times\(dq: true,

                // T1 = طول‌عمر معتبر * ۰٫۵.
                \(dqt1\-percent\(dq: .5,

                // T2 = طول‌عمر معتبر * ۰٫۷۵.
                \(dqt2\-percent\(dq: .75,

                // آستانه کش = طول‌عمر معتبر * ۰٫۲۵.
                \(dqcache\-threshold\(dq: .25,

                // حداکثر کش: هنگامی که زمان آخرین ارسال کلاینت
                // به اندازه کافی نزدیک باشد، اجاره تمدید نمی‌شود و اجاره
                // فعلی همان‌طور که «کش شده» بود بازگردانده می‌شود.
                \(dqcache\-max\-age\(dq: 1000,

                // آستانه زمان اجاره انطباقی (1.0 به معنای غیرفعال است).
                \(dqadaptive\-lease\-time\-threshold\(dq: 0.8,

                // مشخص می‌کند که آیا سرور باید رزروهای سراسری را جستجو کند یا خیر.
                \(dqreservations\-global\(dq: false,

                // مشخص می‌کند که آیا سرور باید رزروهای درون زیرشبکه را جستجو کند یا خیر.
                \(dqreservations\-in\-subnet\(dq: true,

                // مشخص می‌کند که آیا سرور می‌تواند فرض کند همه آدرس‌های رزروشده
                // خارج از استخر (out\-of\-pool) هستند یا خیر.
                // در صورت false بودن reservations\-in\-subnet نادیده گرفته می‌شود.
                // در صورت تعیین، توسط سطوح \(dqsubnet4\(dq به ارث برده می‌شود.
                \(dqreservations\-out\-of\-pool\(dq: false,

                // فهرست کلاس‌های کلاینت که باید هنگام انتخاب این شبکه
                // مشترک برای تخصیص‌های کلاینت ارزیابی شوند.
                \(dqevaluate\-additional\-classes\(dq: [ \(dqlate\(dq ],

                // غیرفعال کردن ذخیره اطلاعات گسترش‌یافته (مانند اطلاعات عامل
                // رله) همراه با هر اجاره برای این شبکه مشترک.
                \(dqstore\-extended\-info\(dq: false,

                // نام میزبان کارگزار در سطح shared\-network تنظیم‌شده در فیلد \(aqsname\(aq.
                \(dqserver\-hostname\(dq: \(dq\(dq,

                // فهرست زیرشبکه‌های IPv4 متعلق به این شبکه مشترک.
                \(dqsubnet4\(dq: [
                    {
                        // نام رابط که با نام رابط ورودی مطابقت داده می‌شود.
                        // در DHCPv4o6 استفاده می‌شود. RFC 7341 را ببینید.
                        \(dq4o6\-interface\(dq: \(dq\(dq,

                        // مقدار گزینه شناسه رابط (Interface ID). RFC 7341 را ببینید.
                        \(dq4o6\-interface\-id\(dq: \(dq\(dq,

                        // پیشوند مطابقت‌داده‌شده با آدرس مبدأ. RFC 7341 را ببینید.
                        \(dq4o6\-subnet\(dq: \(dq2001:db8:1:1::/64\(dq,

                        // پرچمی برای انتخاب راهبرد تخصیص آدرس IP برای
                        // زیرشبکه.
                        \(dqallocator\(dq: \(dqiterative\(dq,

                        // پرچم معتبر بودن (authoritative) در سطح زیرشبکه.
                        \(dqauthoritative\(dq: false,

                        // نام bootfile در سطح زیرشبکه، تنظیم‌شده در فیلد \(aqfile\(aq.
                        \(dqboot\-file\-name\(dq: \(dq\(dq,

                        // این زیرشبکه را محدود می‌کند تا تنها به کلاینت‌هایی اجازه دهد
                        // که حداقل به یکی از کلاس‌های این فهرست تعلق دارند. در صورت حذف
                        // یا ارائه یک فهرست خالی، هیچ محدودیتی اعمال نمی‌شود.
                        \(dqclient\-classes\(dq: [],

                        // مقدار در سطح زیرشبکه. توضیحات را در سطح سراسری ببینید.
                        \(dqddns\-generated\-prefix\(dq: \(dqmyhost\(dq,

                        // مقدار در سطح زیرشبکه. توضیحات را در سطح سراسری ببینید.
                        \(dqddns\-override\-client\-update\(dq: false,

                        // مقدار در سطح زیرشبکه. توضیحات را در سطح سراسری ببینید.
                        \(dqddns\-override\-no\-update\(dq: false,

                        // مقدار در سطح زیرشبکه. توضیحات را در سطح سراسری ببینید.
                        \(dqddns\-qualifying\-suffix\(dq: \(dq\(dq,

                        // مقدار در سطح زیرشبکه. توضیحات را در سطح سراسری ببینید.
                        \(dqddns\-replace\-client\-name\(dq: \(dqnever\(dq,

                        // مقدار در سطح زیرشبکه. توضیحات را در سطح سراسری ببینید.
                        \(dqddns\-send\-updates\(dq: true,

                        // مقدار در سطح زیرشبکه. توضیحات را در سطح سراسری ببینید.
                        \(dqddns\-update\-on\-renew\(dq: true,

                        // مقدار در سطح shared\-network. توضیحات را در سطح سراسری ببینید.
                        // این فیلد با ddns\-conflict\-resolution\-mode جایگزین شده است.
                        // تجزیه این گزینه تنها برای سازگاری با نسخه‌های پیشین حفظ شده است.
                        // \(dqddns\-use\-conflict\-resolution\(dq: true,

                        // مقدار در سطح زیرشبکه. توضیحات را در سطح سراسری ببینید.
                        \(dqddns\-conflict\-resolution\-mode\(dq: \(dqcheck\-with\-dhcid\(dq,

                        // مقدار در سطح زیرشبکه. توضیحات را در سطح سراسری ببینید.
                        // \(dqddns\-ttl\-percent\(dq: 0.55,

                        // مقدار در سطح زیرشبکه. توضیحات را در سطح سراسری ببینید.
                        // نمی‌توانید هر دو ddns\-ttl و هر یک از گزینه‌های ddns\-ttl\-percent ،ddns\-ttl\-min یا
                        // ddns\-ttl\-max را با هم مشخص کنید. این موارد مانعة‌الجمع هستند.
                        \(dqddns\-ttl\(dq: 500,

                        // مقدار در سطح زیرشبکه. توضیحات را در سطح سراسری ببینید.
                        // \(dqddns\-ttl\-min\(dq: 10000,

                        // مقدار در سطح زیرشبکه. توضیحات را در سطح سراسری ببینید.
                        // \(dqddns\-ttl\-max\(dq: 20000,

                        // مقدار در سطح زیرشبکه. توضیحات را در سطح سراسری ببینید.
                        \(dqhostname\-char\-replacement\(dq: \(dqx\(dq,

                        // مقدار در سطح زیرشبکه. توضیحات را در سطح سراسری ببینید.
                        \(dqhostname\-char\-set\(dq: \(dq[^A\-Za\-z0\-9.\-]\(dq,

                        // شناسه یکتای زیرشبکه.
                        \(dqid\(dq: 1,

                        // مشخص می‌کند که این زیرشبکه برای درخواست‌های دریافت‌شده
                        // روی یک رابط خاص انتخاب شده است.
                        \(dqinterface\(dq: \(dqeth0\(dq,

                        // پرچم در سطح زیرشبکه که مشخص می‌کند آیا باید از شناسه کلاینت
                        // برای شناسایی کلاینت‌ها استفاده شود یا خیر.
                        \(dqmatch\-client\-id\(dq: true,

                        // تعیین کارگزار بعدی در سطح زیرشبکه برای ارسال
                        // در \(aqsiaddr\(aq.
                        \(dqnext\-server\(dq: \(dq0.0.0.0\(dq,

                        // اگر بزرگ‌تر از صفر باشد، طول‌عمر اجاره‌هایی است که موقتاً در
                        // مرحله DISCOVER تخصیص داده می‌شوند. در صورت صفر بودن (پیش‌فرض)، در DISCOVER اجاره‌ای تخصیص داده نمی‌شود.
                        \(dqoffer\-lifetime\(dq : 60,

                        // فعال کردن ذخیره اطلاعات گسترش‌یافته (مانند اطلاعات عامل
                        // رله) همراه با هر اجاره برای این زیرشبکه.
                        \(dqstore\-extended\-info\(dq: true,

                        // فهرست گزینه‌های DHCP در سطح زیرشبکه.
                        \(dqoption\-data\(dq: [
                            {
                                // پرچم بولی که مشخص می‌کند آیا گزینه خاص
                                // باید همیشه ارسال شود یا تنها در صورت درخواست.
                                \(dqalways\-send\(dq: false,

                                // یک فهرست اختیاری از کلاس‌هایی که این گزینه برای آن‌ها اعمال می‌شود.
                                // اگر کلاینت با هر یک از کلاس‌های این فهرست مطابقت داشته باشد،
                                // گزینه اعمال خواهد شد. اگر فهرست خالی باشد یا حذف شود،
                                // این گزینه صرف‌نظر از عضویت در کلاس اعمال خواهد شد.
                                \(dqclient\-classes\(dq: [],

                                // کد گزینه.
                                \(dqcode\(dq: 3,

                                // پرچم بولی که مشخص می‌کند آیا مقدار گزینه تعیین‌شده
                                // در \(dqdata\(dq رشته‌ای از مقادیر هگزادسیمال است یا مقدار
                                // CSV خوانا برای انسان.
                                \(dqcsv\-format\(dq: true,

                                // داده گزینه برای گنجانده شدن در بار مفید گزینه.
                                \(dqdata\(dq: \(dq192.0.3.1\(dq,

                                // نام گزینه.
                                \(dqname\(dq: \(dqrouters\(dq,

                                // پرچم بولی که مشخص می‌کند آیا گزینه داده‌شده هرگز
                                // در پاسخ ارسال نشود.
                                \(dqnever\-send\(dq: false,

                                // فضای گزینه. مقدار پیش‌فرض \(dqdhcp4\(dq فضای
                                // گزینه سطح بالا را مشخص می‌کند.
                                \(dqspace\(dq: \(dqdhcp4\(dq
                            }
                        ],

                        // فهرست استخرهای آدرس IP متعلق به زیرشبکه.
                        \(dqpools\(dq: [
                            {
                                // این استخر را محدود می‌کند تا تنها به کلاینت‌هایی
                                // اجازه دهد که حداقل به یک کلاس در این فهرست تعلق دارند. در صورت حذف
                                // یا ارائه یک فهرست خالی، هیچ محدودیتی اعمال نمی‌شود.
                                \(dqclient\-classes\(dq: [ \(dqphones_server1\(dq ],

                                // فهرست گزینه‌های DHCP در سطح استخر.
                                \(dqoption\-data\(dq: [],

                                // محدوده آدرس مورد استفاده برای تخصیص کلاینت.
                                \(dqpool\(dq: \(dq192.1.0.1 \- 192.1.0.200\(dq,

                                // فهرست کلاس‌های کلاینت که باید هنگام انتخاب این استخر
                                // برای تخصیص‌های کلاینت ارزیابی شوند.
                                \(dqevaluate\-additional\-classes\(dq: [ \(dqlate\(dq ],

                                // مقدار در سطح استخر. توضیحات را در سطح سراسری ببینید.
                                \(dqddns\-generated\-prefix\(dq: \(dqmypool\(dq,

                                // مقدار در سطح استخر. توضیحات را در سطح سراسری ببینید.
                                \(dqddns\-override\-client\-update\(dq: false,

                                // مقدار در سطح استخر. توضیحات را در سطح سراسری ببینید.
                                \(dqddns\-override\-no\-update\(dq: false,

                                // مقدار در سطح استخر. توضیحات را در سطح سراسری ببینید.
                                \(dqddns\-qualifying\-suffix\(dq: \(dqpool.example.com.\(dq,

                                // مقدار در سطح استخر. توضیحات را در سطح سراسری ببینید.
                                \(dqddns\-replace\-client\-name\(dq: \(dqalways\(dq,

                                // مقدار در سطح استخر. توضیحات را در سطح سراسری ببینید.
                                \(dqddns\-send\-updates\(dq: true,

                                // مقدار در سطح استخر. توضیحات را در سطح سراسری ببینید.
                                \(dqddns\-update\-on\-renew\(dq: false,

                                // مقدار در سطح استخر. توضیحات را در سطح سراسری ببینید.
                                \(dqddns\-conflict\-resolution\-mode\(dq: \(dqcheck\-with\-dhcid\(dq,

                                // مقدار در سطح استخر. توضیحات را در سطح سراسری ببینید.
                                \(dqddns\-ttl\-percent\(dq: 0.55,

                                // مقدار در سطح استخر. توضیحات را در سطح سراسری ببینید.
                                // نمی‌توانید هر دو ddns\-ttl و هر یک از گزینه‌های ddns\-ttl\-percent ،ddns\-ttl\-min یا
                                // ddns\-ttl\-max را با هم مشخص کنید. این موارد مانعة‌الجمع هستند.
                                // \(dqddns\-ttl\(dq: 500,

                                // مقدار در سطح استخر. توضیحات را در سطح سراسری ببینید.
                                \(dqddns\-ttl\-min\(dq: 10000,

                                // مقدار در سطح استخر. توضیحات را در سطح سراسری ببینید.
                                \(dqddns\-ttl\-max\(dq: 20000,

                                // مقدار در سطح استخر. توضیحات را در سطح سراسری ببینید.
                                \(dqhostname\-char\-replacement\(dq: \(dqx\(dq,

                                // مقدار در سطح استخر. توضیحات را در سطح سراسری ببینید.
                                \(dqhostname\-char\-set\(dq: \(dq[^A\-Za\-z0\-9.\-]\(dq
                            },
                            {
                                // این استخر را محدود می‌کند تا تنها به کلاینت‌هایی
                                // اجازه دهد که حداقل به یک کلاس در این فهرست تعلق دارند. در صورت حذف
                                // یا ارائه یک فهرست خالی، هیچ محدودیتی اعمال نمی‌شود.
                                \(dqclient\-classes\(dq: [ \(dqphones_server2\(dq ],

                                // فهرست گزینه‌های DHCP در سطح استخر.
                                \(dqoption\-data\(dq: [],

                                // محدوده آدرس مورد استفاده برای تخصیص کلاینت.
                                \(dqpool\(dq: \(dq192.3.0.1 \- 192.3.0.200\(dq,

                                // فهرست کلاس‌های کلاینت که باید هنگام انتخاب این استخر
                                // برای تخصیص‌های کلاینت ارزیابی شوند.
                                \(dqevaluate\-additional\-classes\(dq: [],

                                // شناسه استخر که برای فعال‌سازی آمارها برای این استخر استفاده می‌شود.
                                // شناسه استخر نیازی ندارد درون زیرشبکه
                                // یا در میان زیرشبکه‌ها یکتا باشد.
                                // در صورت عدم پیکربندی، پیش‌فرض آن 0 است. آمارهای
                                // مربوط به این استخر با سایر آمارهای
                                // تمام استخرهای دیگر با شناسه استخر یکسان در این زیرشبکه ترکیب خواهد شد.
                                \(dqpool\-id\(dq: 1
                            }
                        ],

                        // مقدار تایمر rebind در سطح زیرشبکه.
                        \(dqrebind\-timer\(dq: 40,

                        // فهرست آدرس‌های رله IPv4 که این زیرشبکه برای آن‌ها انتخاب می‌شود.
                        \(dqrelay\(dq: {
                            \(dqip\-addresses\(dq: [
                                \(dq192.168.56.1\(dq
                            ]
                        },

                        // مقدار تایمر renew در سطح زیرشبکه.
                        \(dqrenew\-timer\(dq: 30,

                        // مشخص می‌کند که آیا سرور باید رزروهای سراسری را جستجو کند یا خیر.
                        \(dqreservations\-global\(dq: false,

                        // مشخص می‌کند که آیا سرور باید رزروهای درون زیرشبکه را جستجو کند یا خیر.
                        \(dqreservations\-in\-subnet\(dq: true,

                        // مشخص می‌کند که آیا سرور می‌تواند فرض کند همه آدرس‌های
                        // رزروشده خارج از استخر هستند یا خیر.
                        // در صورت false بودن reservations\-in\-subnet نادیده گرفته می‌شود.
                        \(dqreservations\-out\-of\-pool\(dq: false,

                        // محاسبه تایمرهای T1 و T2 در سطح زیرشبکه.
                        \(dqcalculate\-tee\-times\(dq: true,

                        // T1 = طول‌عمر معتبر * ۰٫۵.
                        \(dqt1\-percent\(dq: .5,

                        // T2 = طول‌عمر معتبر * ۰٫۷۵.
                        \(dqt2\-percent\(dq: .75,

                        // آستانه کش = طول‌عمر معتبر * ۰٫۲۵.
                        \(dqcache\-threshold\(dq: .25,

                        // حداکثر کش در سطح زیرشبکه.
                        \(dqcache\-max\-age\(dq: 1000,

                        // آستانه زمان اجاره انطباقی (1.0 به معنای غیرفعال است).
                        \(dqadaptive\-lease\-time\-threshold\(dq: 0.8,

                        // فهرست رزروهای ایستا IPv4 اختصاص‌یافته به کلاینت‌های متعلق
                        // به این زیرشبکه. برای یک مثال با جزئیات کامل، reservations.json را ببینید.
                        \(dqreservations\(dq: [
                            {
                                // شناسه مورد استفاده برای تطبیق کلاینت. مقادیر پشتیبانی‌شده عبارتند از
                                // \(dqhw\-address\(dq، \(dqclient\-id\(dq، \(dqduid\(dq، \(dqcircuit\-id\(dq، \(dqflex\-id\(dq.
                                \(dqcircuit\-id\(dq: \(dq01:11:22:33:44:55:66\(dq,

                                // آدرس IP رزروشده.
                                \(dqip\-address\(dq: \(dq192.0.2.204\(dq,

                                // نام میزبان.
                                \(dqhostname\(dq: \(dqfoo.example.org\(dq,

                                // داده گزینه اختصاصی رزرو.
                                \(dqoption\-data\(dq: [
                                    {
                                        // نام گزینه.
                                        \(dqname\(dq: \(dqvivso\-suboptions\(dq,

                                        // داده گزینه.
                                        \(dqdata\(dq: \(dq4491\(dq
                                    }
                                ]
                            }
                        ],

                        // فهرست کلاس‌های کلاینت که باید هنگام انتخاب این زیرشبکه
                        // برای تخصیص‌های کلاینت ارزیابی شوند.
                        \(dqevaluate\-additional\-classes\(dq: [ \(dqlate\(dq ],

                        // نام میزبان کارگزار در سطح زیرشبکه تنظیم‌شده در فیلد \(aqsname\(aq.
                        \(dqserver\-hostname\(dq: \(dq\(dq,

                        // پیشوند زیرشبکه.
                        \(dqsubnet\(dq: \(dq192.0.0.0/8\(dq,

                        // طول‌عمر معتبر (پیش‌فرض) در سطح زیرشبکه.
                        \(dqvalid\-lifetime\(dq: 6000,

                        // حداقل طول‌عمر معتبر در سطح زیرشبکه.
                        \(dqmin\-valid\-lifetime\(dq: 4000,

                        // حداکثر طول‌عمر معتبر در سطح زیرشبکه.
                        \(dqmax\-valid\-lifetime\(dq: 8000
                    }
                ],

                // طول‌عمر معتبر (پیش‌فرض) در سطح shared\-network.
                \(dqvalid\-lifetime\(dq: 6001,

                // حداقل طول‌عمر معتبر در سطح shared\-network.
                \(dqmin\-valid\-lifetime\(dq: 4001,

                // حداکثر طول‌عمر معتبر در سطح shared\-network.
                \(dqmax\-valid\-lifetime\(dq: 8001
            }
        ],

        // نام میزبان سراسری سرور تنظیم‌شده در فیلد \(aqsname\(aq.
        \(dqserver\-hostname\(dq: \(dq\(dq,

        // ذخیره گزینه‌های عامل (یا RAI) تا پرس‌وجوهای مستقیم به گونه‌ای
        // رفتار کنند که گویی از طریق یک رله وارد شده‌اند.
        \(dqstash\-agent\-options\(dq: false,

        // فهرست زیرشبکه‌های IPv4 که به هیچ شبکه مشترکی تعلق ندارند.
        \(dqsubnet4\(dq: [],

        // مقدار طول‌عمر معتبر سراسری.
        \(dqvalid\-lifetime\(dq: 6000,

        // مقدار حداقل طول‌عمر معتبر سراسری.
        \(dqmin\-valid\-lifetime\(dq: 4000,

        // مقدار حداکثر طول‌عمر معتبر سراسری.
        \(dqmax\-valid\-lifetime\(dq: 8000,

        // رزروها (مثال‌ها در فایل‌های دیگر آورده شده‌اند).
        \(dqreservations\(dq: [],

        // کنترل پیکربندی (در حال حاضر استفاده نمی‌شود، یعنی این نحو
        // از قبل تعریف شده است اما ویژگی مربوطه پیاده‌سازی نشده است).
        \(dqconfig\-control\(dq: {
            // تنها مدخل پایگاه‌داده‌های پیکربندی تعریف شده است.
            \(dqconfig\-databases\(dq: [
                {
                    // نام پایگاه‌داده برای اتصال.
                    \(dqname\(dq: \(dqconfig\(dq,

                    // نوع پایگاه‌داده، مثلاً \(dqmysql\(dq، \(dqpostgresql\(dq.
                    \(dqtype\(dq: \(dqmysql\(dq
                }
            ],
            // بازه زمانی بین تلاش‌ها برای واکشی به‌روزرسانی‌های پیکربندی
            // از طریق بک‌اندهای پیکربندی مورد استفاده.
            \(dqconfig\-fetch\-wait\-time\(dq: 30
        },

        // برچسب کارگزار.
        \(dqserver\-tag\(dq: \(dqmy DHCPv4 server\(dq,

        // پارامترهای کنترل صف DHCP.
        \(dqdhcp\-queue\-control\(dq: {
            // فعال‌سازی صف اجباری است.
            \(dqenable\-queue\(dq: true,

            // نوع صف اجباری است.
            \(dqqueue\-type\(dq: \(dqkea\-ring4\(dq,

            // ظرفیت اختیاری است.
            \(dqcapacity\(dq: 64
        },

        // مشخص می‌کند که آیا سرور باید رزروهای سراسری را جستجو کند یا خیر.
        \(dqreservations\-global\(dq: false,

        // مشخص می‌کند که آیا سرور باید رزروهای درون زیرشبکه را جستجو کند یا خیر.
        \(dqreservations\-in\-subnet\(dq: true,

        // مشخص می‌کند که آیا سرور می‌تواند فرض کند همه آدرس‌های رزروشده
        // خارج از استخر هستند یا خیر.
        // در صورت false بودن reservations\-in\-subnet نادیده گرفته می‌شود.
        // در صورت تعیین، توسط سطوح \(dqshared\-networks\(dq و
        // \(dqsubnet4\(dq به ارث برده می‌شود.
        \(dqreservations\-out\-of\-pool\(dq: false,

        // محاسبه سراسری تایمرهای T1 و T2.
        \(dqcalculate\-tee\-times\(dq: true,

        // T1 = طول‌عمر معتبر * ۰٫۵.
        \(dqt1\-percent\(dq: .5,

        // T2 = طول‌عمر معتبر * ۰٫۷۵.
        \(dqt2\-percent\(dq: .75,

        // آستانه کش = طول‌عمر معتبر * ۰٫۲۵.
        \(dqcache\-threshold\(dq: .25,

        // حداکثر کش سراسری.
        \(dqcache\-max\-age\(dq: 1000,

        // آستانه زمان اجاره انطباقی (1.0 به معنای غیرفعال است).
        \(dqadaptive\-lease\-time\-threshold\(dq: 0.8,

        // رشته‌ای از صفر یا چند نویسه که با هر نویسه نامعتبر
        // در نام میزبان یا FQDN کلاینت جایگزین می‌شود. مقدار پیش‌فرض
        // یک رشته خالی است که باعث می‌شود نویسه‌های نامعتبر به جای
        // جایگزینی، حذف شوند.
        \(dqhostname\-char\-replacement\(dq: \(dqx\(dq,

        // عبارت منظم توصیف‌کننده مجموعه نویسه‌های نامعتبر در
        // نام میزبان یا FQDN کلاینت.
        \(dqhostname\-char\-set\(dq: \(dq[^A\-Za\-z0\-9.\-]\(dq,

        // فهرست ثبت‌کننده‌های وقایع (loggers) مورد استفاده توسط سرورهایی که از این فایل پیکربندی استفاده می‌کنند.
        \(dqloggers\(dq: [
            {
                // سطح اشکال‌زدایی، مقداری بین 0..99. هرچه مقدار بزرگ‌تر باشد،
                // گزارش اشکال‌زدایی با جزئیات بیشتری خواهد بود.
                \(dqdebuglevel\(dq: 99,

                // نام ثبت‌کننده وقایع.
                \(dqname\(dq: \(dqkea\-dhcp4\(dq,

                // نحوه خروجی دادن گزارش‌ها را پیکربندی می‌کند.
                \(dqoutput\-options\(dq: [
                    {
                        // مشخص می‌کند که آیا گزارش باید فوراً در فایل نوشته (flush) شود یا خیر.
                        \(dqflush\(dq: true,

                        // حداکثر اندازه فایل را پیش از چرخش (rotate) فایل مشخص می‌کند.
                        \(dqmaxsize\(dq: 10240000,

                        // حداکثر تعداد فایل‌های چرخیده‌شده برای نگهداری را مشخص می‌کند.
                        \(dqmaxver\(dq: 1,

                        // مقصد ثبت وقایع را مشخص می‌کند.
                        \(dqoutput\(dq: \(dqstdout\(dq,

                        // محتوای مدخل وقایع‌نگاری را مشخص می‌کند
                        \(dqpattern\(dq: \(dq%D{%Y\-%m\-%d %H:%M:%S.%q} %\-5p [%c/%i] %m\en\(dq
                    }
                ],

                // شدت ثبت وقایع را مشخص می‌کند، یعنی \(dqERROR\(dq، \(dqWARN\(dq، \(dqINFO\(dq، \(dqDEBUG\(dq.
                \(dqseverity\(dq: \(dqINFO\(dq
            }
        ],

        // اگر بزرگ‌تر از صفر باشد، طول‌عمر اجاره‌هایی است که موقتاً در
        // مرحله DISCOVER تخصیص داده می‌شوند. در صورت صفر بودن (پیش‌فرض)، در DISCOVER اجاره‌ای تخصیص داده نمی‌شود.
        \(dqoffer\-lifetime\(dq : 60,

        // برای استفاده از بافت‌های کاربری (user\-contexts) به مثال‌های پیشرفته نگاه کنید.
        \(dquser\-context\(dq: { }
    }
}
.EE
.UNINDENT
.UNINDENT.SS kea4/all\-keys.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// هشدار: این پیکربندی نمونه برای استفاده در محیط عملیاتی در نظر گرفته نشده است.
// کارگزار Kea DHCPv4 این پیکربندی را رد خواهد کرد زیرا شامل
// پارامترهای پیکربندی ناسازگار با یکدیگر (مانعة‌الجمع) است.
//
// هدف اصلی این فایل نمونه، ارائهٔ فهرستی جامع از
// پارامترهای پشتیبانی‌شده توسط کارگزار Kea DHCPv4 به همراه شرحی مختصر
// از هر پارامتر است.
//
// این نسخهٔ کنونی باید به‌روز باشد، بدین معنا که واژه‌های کلیدی جدید باید
// هم‌زمان با مشخصات تجزیه‌کننده به این فایل افزوده شوند.
{
    // پیکربندی کارگزار Kea DHCPv4 از اینجا آغاز می‌شود.
    \(dqDhcp4\(dq: {
        // پرچم سراسری انتخاب راهبرد تخصیص نشانی IP برای همهٔ
        // زیرشبکه‌ها. برای یک راهبرد تخصیص تصادفی از \(dqrandom\(dq استفاده کنید.
        \(dqallocator\(dq: \(dqiterative\(dq,

        // پرچم سراسری معتبر (authoritative) برای رسیدگی به درخواست‌های کلاینت‌ها برای
        // نشانی‌های IP ناشناخته (اگر غیرفعال باشد نادیده گرفته می‌شود، اگر فعال باشد NAK ارسال می‌شود).
        \(dqauthoritative\(dq: false,

        // نام فایل راه‌اندازی (bootfile) سراسری که باید در فیلد \(aqfile\(aq تنظیم شود.
        \(dqboot\-file\-name\(dq: \(dq/dev/null\(dq,

        // فهرست مرتب‌شده‌ای از کلاس‌های کلاینت که توسط کارگزار DHCPv4 استفاده می‌شود.
        \(dqclient\-classes\(dq: [
            {
                // نام فایل راه‌اندازی (bootfile) مخصوص کلاس که در فیلد \(aqfile\(aq تنظیم می‌شود.
                \(dqboot\-file\-name\(dq: \(dq/usr/local/share/kea/bootfile.efi\(dq,

                // نام کلاس.
                \(dqname\(dq: \(dqphones_server1\(dq,

                // نشانی کارگزار بعدی مخصوص کلاس برای استفاده در bootstrap که
                // در فیلد \(aqsiaddr\(aq تنظیم می‌شود.
                \(dqnext\-server\(dq: \(dq10.2.3.4\(dq,

                // فهرست گزینه‌های DHCPv4 مخصوص کلاس.
                \(dqoption\-data\(dq: [],

                // تعاریف گزینه‌های DHCPv4 مخصوص کلاس، یعنی قالب‌های سفارشی
                // مشخص‌شده برای گزینه‌های غیر استاندارد.
                \(dqoption\-def\(dq: [],

                // نام میزبان اختیاری کارگزار مخصوص کلاس که در
                // فیلد \(aqsname\(aq تنظیم می‌شود.
                \(dqserver\-hostname\(dq: \(dq\(dq,

                // عبارت انتخاب کلاس. هنگامی که عبارت داده‌شده درست (true) ارزیابی شود،
                // بستهٔ DHCP به این کلاس اختصاص می‌یابد.
                \(dqtest\(dq: \(dqmember(\(aqHA_server1\(aq)\(dq,

                // مدت‌زمان اعتبار کلاس.
                \(dqvalid\-lifetime\(dq: 6000,

                // حداقل مدت‌زمان اعتبار کلاس.
                \(dqmin\-valid\-lifetime\(dq: 4000,

                // حداکثر مدت‌زمان اعتبار کلاس.
                \(dqmax\-valid\-lifetime\(dq: 8000,

                // اگر بزرگ‌تر از صفر باشد، مدت‌زمان اعتبار اجاره‌هایی است که موقتاً
                // در DISCOVER تخصیص می‌یابند. وقتی صفر باشد (پیش‌فرض)، اجاره‌ها در DISCOVER تخصیص داده نمی‌شوند.
                \(dqoffer\-lifetime\(dq : 65
            },
            {
                // مقدار پیش‌فرض نام فایل راه‌اندازی مخصوص کلاس. یک نام خالی
                // به معنای مشخص نشدن نام فایل راه‌اندازی است.
                \(dqboot\-file\-name\(dq: \(dq\(dq,

                // نام کلاس دوم.
                \(dqname\(dq: \(dqphones_server2\(dq,

                // مقدار پیش‌فرض نشانی کارگزار بعدی مخصوص کلاس. نشانی
                // IPv4 صفر به این معناست که مشخص نشده است.
                \(dqnext\-server\(dq: \(dq0.0.0.0\(dq,

                // فهرست گزینه‌های DHCPv4 مخصوص کلاس.
                \(dqoption\-data\(dq: [],

                // تعاریف گزینه‌های DHCPv4 مخصوص کلاس، یعنی قالب‌های سفارشی
                // مشخص‌شده برای گزینه‌های غیر استاندارد.
                \(dqoption\-def\(dq: [],

                // نام میزبان اختیاری کارگزار مخصوص کلاس که در
                // فیلد \(aqsname\(aq تنظیم می‌شود.
                \(dqserver\-hostname\(dq: \(dq\(dq,

                // عبارت انتخاب کلاس. هنگامی که عبارت داده‌شده درست ارزیابی شود،
                // بستهٔ DHCP به این کلاس اختصاص می‌یابد.
                \(dqtest\(dq: \(dqmember(\(aqHA_server2\(aq)\(dq
            },
            {
                // نام کلاس سوم.
                \(dqname\(dq: \(dqlate\(dq,

                // پرچم بولی که مشخص می‌کند آیا عبارت کلاس تنها زمانی ارزیابی شود
                // که پیکربندی انتخاب‌شده (یعنی pool، subnet، shared\-network)
                // شامل این نام کلاس در فهرست \(dqevaluate\-additional\-classes\(dq خود باشد یا خیر. مقدار
                // پیش‌فرض false به این معناست که عبارت آزمون کلاس همیشه باید
                // ارزیابی شود.
                \(dqonly\-in\-additional\-list\(dq: true,

                // عبارت انتخاب کلاس.
                \(dqtest\(dq: \(dqmember(\(aqALL\(aq)\(dq
            },
            {
                // نام کلاس چهارم.
                \(dqname\(dq: \(dqmy\-template\-class\(dq,

                // پرچم کلاس الگو که حاوی عبارتی است که برای تولید نام همهٔ زیرکلاس‌های
                // ایجادشده استفاده می‌شود. در این حالت، کلاس‌ها بر اساس شناسهٔ کلاینت نام‌گذاری می‌شوند.
                \(dqtemplate\-test\(dq: \(dqsubstring(option[61].hex, 0, all)\(dq
            }
        ],

        // پارامترهایی برای فعال‌سازی رفتارهای سازگار با کلاینت‌ها، بازپخش‌کننده‌ها (relays)
        // یا سایر عامل‌های ناسازگار یا معیوب
        \(dqcompatibility\(dq: {
            // نادیده گرفتن گزینهٔ DHCP Server Identifier در صورت تنظیم روی true.
            // فعال‌سازی این مورد باعث می‌شود Kea به‌جای دور انداختن، هر پرس‌وجویی را بپذیرد،
            // حتی اگر نشانی موجود در گزینه متعلق به کارگزار دیگری باشد.
            // مقدار پیش‌فرض این گزینه false است، زیرا فعال‌سازی آن با RFC ناسازگار است.
            \(dqignore\-dhcp\-server\-identifier\(dq: false,

            // نادیده گرفتن زیرگزینهٔ Relay Agent Information Link Selection در صورت
            // تنظیم روی true. فعال‌سازی این مورد باعث می‌شود Kea به‌جای تلاش برای استفاده
            // از زیرشبکهٔ مشخص‌شده در زیرگزینه، از منطق عادی انتخاب زیرشبکه
            // استفاده کند. این گزینه به‌طور پیش‌فرض false است، زیرا فعال‌سازی آن با RFC ناسازگار است.
            \(dqignore\-rai\-link\-selection\(dq: false,

            // تجزیهٔ آسان‌گیرانه‌تر گزینه‌ها در جایی که فیلدها را می‌توان به‌طور قطعی
            // استنتاج کرد، حتی اگر مغایر با RFC یا روال معمول باشد.
            \(dqlenient\-option\-parsing\(dq: true,

            // پرچم بولی که نشان می‌دهد آیا نشانی‌های 0. و 255. در زیرشبکه‌هایی
            // با طول پیشوند 24 یا کمتر، باید هرگز آزاد در نظر گرفته نشوند یا خیر.
            // پیش‌فرض false است، زیرا این نشانی‌ها خاص نیستند؛ فقط نشانی‌های نخستین و واپسین خاص هستند.
            \(dqexclude\-first\-last\-24\(dq: false
        },

        // پارامترهای پیکربندی سوکت کنترل فرمان برای کارگزار Kea DHCPv4.
        \(dqcontrol\-sockets\(dq: [
            {
                // نوع سوکت کنترل استفاده‌شده توسط کارگزار Kea DHCPv4.
                // باید unix، http یا https باشد.
                \(dqsocket\-type\(dq: \(dqunix\(dq,

               // مکان فایل سوکت دامنهٔ یونیکس که کارگزار DHCPv4
               // برای دریافت فرمان‌های کنترلی از مدیر کارگزار محلی استفاده می‌کند.
               \(dqsocket\-name\(dq: \(dqkea4\-ctrl\-socket\(dq
            },
            {
                // نوع سوکت کنترل استفاده‌شده توسط کارگزار Kea DHCPv4.
                // باید unix، http یا https باشد.
                \(dqsocket\-type\(dq: \(dqhttps\(dq,

                // نشانی سوکت HTTPS که کارگزار Kea DHCPv4 باید برای
                // پرس‌وجوهای ورودی به آن گوش فرا دهد.
                \(dqsocket\-address\(dq: \(dq127.0.0.1\(dq,

                // درگاه سوکت HTTPS که کارگزار Kea DHCPv4 باید برای
                // پرس‌وجوهای ورودی به آن گوش فرا دهد. در صورت فعال‌سازی HA
                // و چندنخی، درگاه 8000 توسط شنوندهٔ http کتابخانهٔ قلاب HA
                // استفاده می‌شود. هنگام استفاده از کتابخانهٔ قلاب HA با چندنخی
                // برای کارکرد صحیح، مطمئن شوید درگاه استفاده‌شده توسط شنوندهٔ اختصاصی
                // متفاوت از درگاه مشخص‌شده در اینجا باشد (مثلاً 8001). توجه داشته باشید
                // که فرمان‌ها همچنان باید به یک سوکت کنترل ارسال شوند.
                // شنوندهٔ اختصاصی منحصراً برای به‌روزرسانی‌های HA است.
                \(dqsocket\-port\(dq: 8004,

                // لنگر اعتماد TLS (مرجع صدور گواهی یا CA). این یک
                // نام فایل یا مسیر دایرکتوری است. همراه با سایر پارامترهای TLS
                // تنها برای نوع سوکت کنترل https معنا دارد.
                \(dqtrust\-anchor\(dq: \(dqmy\-ca\(dq,

                // نام فایل گواهی کارگزار TLS.
                \(dqcert\-file\(dq: \(dqmy\-cert\(dq,

                // نام فایل کلید خصوصی کارگزار TLS.
                \(dqkey\-file\(dq: \(dqmy\-key\(dq,

                // پرچم الزام گواهی‌های کلاینت در TLS. پیش‌فرض true
                // است و به معنای الزام گواهی‌های کلاینت است. مقدار false
                // به معنای اختیاری بودن آن‌هاست.
                \(dqcert\-required\(dq: true,

                // هدرهای اضافی HTTP برای افزودن به پاسخ‌ها.
                \(dqhttp\-headers\(dq:
                [
                    {
                        // بافت اختیاری کاربر.
                        \(dquser\-context\(dq: { \(dqcomment\(dq: \(dqHSTS header\(dq },

                        // نام الزامی هدر HTTP.
                        \(dqname\(dq: \(dqStrict\-Transport\-Security\(dq,

                        // مقدار الزامی هدر HTTP.
                        \(dqvalue\(dq: \(dqmax\-age=31536000\(dq
                    }
                ],

                // احراز هویت اختیاری.
                \(dqauthentication\(dq: {

                    // نوع احراز هویت الزامی. تنها مقدار پشتیبانی‌شده
                    // برای احراز هویت پایهٔ HTTP مقدار basic است.
                    \(dqtype\(dq: \(dqbasic\(dq,

                    // یک پارامتر اختیاری قلمرو (realm) احراز هویت
                    // پایهٔ HTTP است. پیش‌فرض آن
                    // \(dqkea\-dhcpv4\-server\(dq است.
                    \(dqrealm\(dq: \(dqkea\-dhcpv4\-server\(dq,

                    // از این پارامتر اختیاری می‌توان برای تعیین یک پیشوند مشترک
                    // برای فایل‌های مدیریت اعتبارنامه‌های کلاینت استفاده کرد.
                    \(dqdirectory\(dq: \(dq/usr/local/share/kea/kea\-creds\(dq,

                    // این فهرست شناسه‌های کاربری و گذرواژه‌های مورد استفاده
                    // برای احراز هویت پایهٔ HTTP را مشخص می‌کند. در صورت خالی بودن
                    // یا وجود نداشتن، هر کلاینتی مجاز شمرده می‌شود.
                    \(dqclients\(dq: [
                        // این مورد یک کلاینت مجاز را مشخص می‌کند.
                        {
                            // شناسهٔ کاربری نباید خالی باشد یا
                            // حاوی نویسهٔ \(aq:\(aq باشد. این یک
                            // پارامتر الزامی است.
                            \(dquser\(dq: \(dqadmin\(dq,

                            // اگر گذرواژه مشخص نشود یک گذرواژهٔ
                            // خالی استفاده می‌شود.
                            \(dqpassword\(dq: \(dq1234\(dq
                        },

                        // این مورد یک کلاینت مخفی را مشخص می‌کند.
                        {
                            // شناسهٔ کاربری محتوای فایل
                            // /usr/local/share/kea/kea\-creds/hiddenu است.
                            \(dquser\-file\(dq: \(dqhiddenu\(dq,

                            // گذرواژه محتوای فایل
                            // /usr/local/share/kea/kea\-creds/hiddenp است.
                            \(dqpassword\-file\(dq: \(dqhiddenp\(dq
                        },

                        // این مورد یک کلاینت مخفی را با استفاده از یک
                        // راز در یک فایل مشخص می‌کند.
                        {
                            // راز محتوای فایل
                            // /usr/local/share/kea/kea\-creds/hiddens است که باید در
                            // قالب <user\-id>:<password> باشد.
                            \(dqpassword\-file\(dq: \(dqhiddens\(dq
                        }
                    ]
                }
            }
        ],

        // پیشوندی را مشخص می‌کند که باید به FQDN کلاینت تولیدشده اضافه شود.
        // ممکن است در سطوح سراسری، shared\-network و subnet مشخص شود.
        \(dqddns\-generated\-prefix\(dq: \(dqmyhost\(dq,

        // پرچم بولی که مشخص می‌کند آیا کارگزار باید تمایل کلاینت DHCP
        // برای به‌روزرسانی DNS توسط خودش را نادیده بگیرد یا خیر. با تنظیم این پرچم روی true،
        // کارگزار به‌روزرسانی‌های DNS را برای هر دو داده‌های مستقیم و
        // معکوس DNS ارسال می‌کند. مقدار پیش‌فرض false است که نشان می‌دهد
        // کارگزار در صورت درخواست، به‌روزرسانی DNS را به کلاینت واگذار می‌کند.
        // این پارامتر را می‌توان در سطوح سراسری، shared\-network
        // و subnet مشخص کرد.
        \(dqddns\-override\-client\-update\(dq: false,

        // پرچم بولی که نشان می‌دهد آیا کارگزار باید خواستهٔ کلاینت DHCP
        // مبنی بر عدم به‌روزرسانی DNS را لغو کند یا خیر. با تنظیم این پارامتر
        // روی true، کارگزار حتی زمانی که کلاینت درخواست عدم به‌روزرسانی داده باشد،
        // به‌روزرسانی DNS را ارسال می‌کند. این پارامتر را می‌توان در سطوح
        // سراسری، shared\-network و subnet مشخص کرد.
        \(dqddns\-override\-no\-update\(dq: false,

        // پسوندی که به نام ناقص ارسال‌شده به DNS افزوده می‌شود.
        // مقدار پیش‌فرض یک رشتهٔ خالی است که نشان می‌دهد هیچ
        // پسوندی افزوده نمی‌شود. می‌توان آن را در سطوح سراسری،
        // shared\-network و subnet مشخص کرد.
        \(dqddns\-qualifying\-suffix\(dq: \(dq\(dq,

        // مقداری شمارشی که مشخص می‌کند آیا کارگزار باید نام میزبان یا
        // Client FQDN ارسال‌شده توسط کلاینت را بپذیرد یا این نام را
        // جایگزین کند. مقادیر قابل قبول عبارتند از: \(dqnever\(dq (استفاده از
        // نامی که کلاینت فرستاده)، \(dqalways\(dq (جایگزینی نامی که
        // کلاینت فرستاده)، \(dqwhen\-present\(dq (جایگزینی نام فرستاده‌شده توسط کلاینت،
        // اما در صورتی که کلاینت نامی نفرستاد نامی تولید نشود)، \(dqwhen\-not\-present\(dq (تولید
        // نام در صورتی که کلاینت نامی نفرستاد، در غیر این صورت حفظ نام
        // ارسال‌شده توسط کلاینت). مقدار پیش‌فرض \(dqnever\(dq است. می‌توان آن را در
        // سطوح سراسری، shared\-network و subnet تعیین کرد.
        \(dqddns\-replace\-client\-name\(dq: \(dqnever\(dq,

        // پرچم بولی که به‌روزرسانی DDNS را فعال یا غیرفعال می‌کند.
        // پیش‌فرض آن true است. می‌تواند در سطوح سراسری، shared\-
        // network و subnet تعیین شود. این گزینه در ارتباط با
        // dhcp\-ddns:enable\-updates عمل می‌کند که باید برای فعال‌سازی اتصالات
        // به kea\-dhcp\-ddns مقدار true داشته باشد.
        \(dqddns\-send\-updates\(dq: true,

        // پرچم بولی که اگر true باشد به کارگزار دستور می‌دهد که همیشه
        // هنگام تمدید اجاره‌ها، حتی اگر اطلاعات DNS تغییر نکرده باشد،
        // DNS را به‌روز کند. رفتار پیش‌فرض کارگزار (یعنی مقدار پرچم false است)
        // این است که فقط در صورت تغییر اطلاعات DNS، آن را به‌روزرسانی کند. این مورد
        // را می‌توان در سطوح سراسری، shared\-network و subnet تعیین کرد.
        \(dqddns\-update\-on\-renew\(dq: true,

        // پرچم بولی که با هر درخواست به‌روزرسانی DDNS به kea\-dhcp\-ddns ارسال می‌شود
        // تا نشان دهد آیا باید از حل اختلاف به‌روزرسانی DNS طبق RFC 4703
        // برای درخواست به‌روزرسانی مشخص‌شده استفاده شود یا خیر. مقدار پیش‌فرض این پرچم true است.
        // این مورد را می‌توان در سطوح سراسری، shared\-network و subnet تعیین کرد.
        // این فیلد با ddns\-conflict\-resolution\-mode جایگزین شده است.
        // تجزیهٔ آن صرفاً برای سازگاری عقبرو حفظ شده است.
        // \(dqddns\-use\-conflict\-resolution\(dq: true,

        // مقداری شمارشی که همراه با هر درخواست به‌روزرسانی DDNS به kea\-dhcp\-ddns ارسال
        // می‌شود تا حالت مورد استفاده برای حل اختلاف‌ها را در حین انجام به‌روزرسانی‌های
        // DDNS مشخص کند. مقادیر قابل قبول عبارتند از:
        // check\-with\-dhcid (شامل افزودن رکورد DHCID و بررسی
        // آن رکورد از طریق تشخیص تداخل طبق RFC 4703)،
        // no\-check\-with\-dhcid (تشخیص تداخل را نادیده می‌گیرد اما هنگام
        // ایجاد/به‌روزرسانی ورودی یک رکورد DHCID اضافه می‌کند)،
        // check\-exists\-with\-dhcid (بررسی می‌کند که آیا رکورد DHCID موجود است
        // اما تطابق مقدار رکورد با به‌روزرسانی را وارسی نمی‌کند. این حالت همچنین رکورد DHCID را برای ورودی به‌روز می‌کند)،
        // no\-check\-without\-dhcid (تشخیص تداخل را نادیده می‌گیرد و هنگام
        // ایجاد/به‌روزرسانی ورودی DDNS رکورد DHCID اضافه نخواهد کرد).
        // مقدار پیش‌فرض \(dqcheck\-with\-dhcid\(dq است. می‌توان آن را در
        // سطوح سراسری، shared\-network و subnet تعیین کرد.
        \(dqddns\-conflict\-resolution\-mode\(dq: \(dqcheck\-with\-dhcid\(dq,

        // اگر بزرگ‌تر از 0.0 باشد، درصدی از مدت‌زمان اعتبار اجاره است
        // که برای TTL در DNS استفاده می‌شود.
        \(dqddns\-ttl\-percent\(dq: 0.75,

        // اگر بزرگ‌تر از 0 باشد، به عنوان TTL در DNS استفاده خواهد شد. برحسب ثانیه مشخص می‌شود.
        // نمی‌توانید هم ddns\-ttl و هم هر یک از ddns\-ttl\-percent، ddns\-ttl\-min یا
        // ddns\-ttl\-max را مشخص کنید. آن‌ها مانعة‌الجمع هستند.
        // \(dqddns\-ttl\(dq: 500,

        // اگر بزرگ‌تر از 0 باشد، به عنوان کران پایین برای مقادیر محاسبه‌شدهٔ TTL در DNS استفاده می‌شود.
        // برحسب ثانیه مشخص می‌شود.
        \(dqddns\-ttl\-min\(dq: 24000,

        // اگر بزرگ‌تر از 0 باشد، به عنوان کران بالا برای مقادیر محاسبه‌شدهٔ TTL در DNS استفاده می‌شود.
        // برحسب ثانیه مشخص می‌شود.
        \(dqddns\-ttl\-max\(dq: 64000,

        // زمان برحسب ثانیه که مشخص می‌کند چه مدت یک اجارهٔ ردشده باید
        // از تخصیص‌های DHCP کنار گذاشته شود. مقدار پیش‌فرض 86400 (24 ساعت) است.
        \(dqdecline\-probation\-period\(dq: 86400,

        // پیکربندی ارسال درخواست تغییر نام (NCR) برای کارگزار Kea DHCPv4.
        // درخواست‌های NCR به ماژول Kea D2 فرستاده می‌شوند تا DNS پس از تخصیص
        // اجاره‌های DHCP به‌روزرسانی شود.
        \(dqdhcp\-ddns\(dq: {
            // پرچم بولی که نشان می‌دهد آیا کارگزار Kea DHCPv4 باید به
            // kea\-dhcp\-ddns متصل شود یا خیر. این گزینه برای ایجاد و ارسال NCRها
            // به kea\-dhcp\-ddns باید true باشد. به‌طور پیش‌فرض، NCRها تولید نمی‌شوند.
            \(dqenable\-updates\(dq: false,

            // حداکثر تعداد NCRها را برای قرارگیری در صف در انتظار ارسال
            // به کارگزار Kea D2 مشخص می‌کند.
            \(dqmax\-queue\-size\(dq: 1024,

            // قالب بسته‌ای که باید هنگام ارسال NCRها به کارگزار Kea D2 استفاده شود.
            // در حال حاضر فقط قالب JSON پشتیبانی می‌شود.
            \(dqncr\-format\(dq: \(dqJSON\(dq,

            // پروتکل سوکت برای استفاده هنگام ارسال NCRها به D2. در حال حاضر
            // فقط UDP پشتیبانی می‌شود.
            \(dqncr\-protocol\(dq: \(dqUDP\(dq,

            // نشانی IP که کارگزار Kea DHCPv4 باید برای ارسال
            // NCRها به D2 استفاده کند. مقدار پیش‌فرض صفر نشان می‌دهد که Kea
            // باید یک نشانی مناسب انتخاب کند.
            \(dqsender\-ip\(dq: \(dq0.0.0.0\(dq,

            // شماره درگاهی که کارگزار Kea DHCPv4 باید برای ارسال
            // NCRها به D2 استفاده کند. مقدار پیش‌فرض صفر نشان می‌دهد که Kea
            // باید درگاه مناسبی را انتخاب کند.
            \(dqsender\-port\(dq: 0,

            // نشانی IP که D2 روی آن برای دریافت NCRها گوش فرا می‌دهد.
            \(dqserver\-ip\(dq: \(dq127.0.0.1\(dq,

            // شماره درگاهی که D2 روی آن به NCRها گوش می‌دهد.
            \(dqserver\-port\(dq: 53001
        },

        // نخستین درگاه از دو درگاه متوالی سوکت‌های UDP مورد استفاده
        // برای ارتباط بین کارگزارهای DHCPv6 و DHCPv4 را مشخص می‌کند.
        // استاندارد RFC 7341 را ببینید (پیش‌فرض روی 0 \- غیرفعال).
        // در صورت فعال‌سازی، مثلاً از 786 استفاده کنید.
        \(dqdhcp4o6\-port\(dq: 0,

        // پرچم بولی که مشخص می‌کند آیا کارگزار Kea DHCPv4
        // باید گزینهٔ Client Identifier را در پاسخ‌های خود بازگرداند یا خیر.
        // مقدار پیش‌فرض true است که نشان می‌دهد در صورت درج آن توسط کلاینت،
        // این گزینه باید بازگردانده شود. مقدار false به کارگزار دستور می‌دهد
        // برای سازگاری عقبرو با مشخصات قدیمی‌تر DHCP (که بیان می‌کردند Client Identifier نباید
        // بازگردانده شود) این گزینه را ارسال نکند.
        \(dqecho\-client\-id\(dq: true,

        // مجموعه‌ای از پارامترهای کارگزار Kea DHCPv4 که نحوهٔ پردازش
        // اجاره‌های منقضی‌شدهٔ DHCP توسط کارگزار را پیکربندی می‌کند.
        \(dqexpired\-leases\-processing\(dq: {
            // تعداد ثانیه‌ها پس از آخرین حذف اجاره‌های منقضی‌شده را مشخص می‌کند
            // که باید حذف بعدی در آن زمان رخ دهد.
            // اگر هر دوی \(dqflush\-reclaimed\-timer\-wait\-time\(dq و
            // \(dqhold\-reclaimed\-time\(dq صفر نباشند، هنگامی که کلاینت یک پیام release
            // ارسال می‌کند، اجاره منقضی می‌شود به‌جای اینکه از
            // ذخیره‌ساز اجاره حذف گردد.
            \(dqflush\-reclaimed\-timer\-wait\-time\(dq: 25,

            // مدت‌زمان برحسب ثانیه را برای نگهداری اجاره‌های منقضی‌شده
            // در پایگاه‌دادهٔ اجاره (lease affinity) مشخص می‌کند.
            // اگر هر دوی \(dqflush\-reclaimed\-timer\-wait\-time\(dq و
            // \(dqhold\-reclaimed\-time\(dq صفر نباشند، وقتی کلاینت یک پیام release
            // می‌فرستد، اجاره منقضی می‌شود به‌جای اینکه از
            // ذخیره‌ساز اجاره حذف گردد.
            \(dqhold\-reclaimed\-time\(dq: 3600,

            // حداکثر تعداد اجاره‌های منقضی‌شده‌ای را مشخص می‌کند که می‌توانند
            // در یک تلاش واحد برای پاک‌سازی اجاره‌های منقضی از
            // پایگاه‌دادهٔ اجاره پردازش شوند. اگر اجاره‌های منقضی بیشتری
            // وجود داشته باشد، در تلاش بعدی پاک‌سازی پردازش خواهند شد.
            \(dqmax\-reclaim\-leases\(dq: 100,

            // حداکثر زمان برحسب میلی‌ثانیه را مشخص می‌کند که یک تلاش منفرد
            // برای پاک‌سازی اجاره‌های منقضی از پایگاه‌دادهٔ اجاره می‌تواند طول بکشد.
            \(dqmax\-reclaim\-time\(dq: 250,

            // مدت‌زمان برحسب ثانیه از آخرین تلاش برای پردازش اجاره‌های
            // منقضی را پیش از آغاز تلاش بعدی مشخص می‌کند.
            \(dqreclaim\-timer\-wait\-time\(dq: 10,

            // حداکثر تعداد چرخه‌های پردازش اجاره‌های منقضی‌شده را مشخص می‌کند
            // که منجر به پاک‌سازی کامل اجاره‌های منقضی از پایگاه‌دادهٔ
            // اجاره نشدند و پس از آن پیام هشداری صادر می‌شود.
            \(dqunwarned\-reclaim\-cycles\(dq: 5
        },

        // فهرست کتابخانه‌های قلاب و پارامترهای پیکربندی خاص آن‌ها
        // برای بارگذاری توسط کارگزار Kea DHCPv4.
        \(dqhooks\-libraries\(dq: [
            {
                // مکان کتابخانهٔ قلاب جهت بارگذاری.
                \(dqlibrary\(dq: \(dqlibdhcp_lease_cmds.so\(dq,

                // پارامترهای پیکربندی مخصوص کتابخانهٔ قلاب.
                \(dqparameters\(dq: { }
            },
            {
                // کتابخانهٔ قلاب backend میزبان MySQL مورد نیاز برای ذخیره‌سازی میزبان.
                \(dqlibrary\(dq: \(dqlibdhcp_mysql.so\(dq
            },
            {
                // کتابخانهٔ قلاب backend میزبان PostgreSQL مورد نیاز برای ذخیره‌سازی میزبان.
                \(dqlibrary\(dq: \(dqlibdhcp_pgsql.so\(dq
            }
        ],

        // فهرست اعتبارنامه‌های دسترسی به منابع خارجی رزروهای IPv4،
        \(dqhosts\-databases\(dq: [
            {
                // نام پایگاه‌داده برای اتصال.
                \(dqname\(dq: \(dqkeatest\(dq,

                // میزبانی که پایگاه‌داده روی آن قرار دارد.
                \(dqhost\(dq: \(dqlocalhost\(dq,

                // گذرواژهٔ پایگاه‌داده.
                \(dqpassword\(dq: \(dq1234\(dq,

                // درگاهی که پایگاه‌داده روی آن در دسترس است.
                \(dqport\(dq: 3306,

                // نوع پایگاه‌داده، مثلاً \(dqmysql\(dq، \(dqpostgresql\(dq.
                \(dqtype\(dq: \(dqmysql\(dq,

                // نام کاربری مورد استفاده برای دسترسی به پایگاه‌داده.
                \(dquser\(dq: \(dqkeatest\(dq,

                // حالت فقط‌خواندنی.
                \(dqreadonly\(dq: false,

                // ورودی‌های بعدی برای پشتیبانی OpenSSL در MySQL هستند.

                // لنگر اعتماد یا همان فایل یا دایرکتوری مرجع صدور گواهی (CA).
                \(dqtrust\-anchor\(dq: \(dqmy\-ca\(dq,

                // نام فایل گواهی کلاینت.
                \(dqcert\-file\(dq: \(dqmy\-cert\(dq,

                // نام فایل کلید خصوصی.
                \(dqkey\-file\(dq: \(dqmy\-key\(dq,

                // فهرست رمزها (راهنمای دستور ciphers در OpenSSL را ببینید).
                \(dqcipher\-list\(dq: \(dqAES\(dq,

                // زمان انتظار اتصال مجدد.
                // این پارامتر تعیین می‌کند که Kea چقدر قبل از تلاش برای
                // اتصال مجدد منتظر بماند. برحسب میلی‌ثانیه بیان می‌شود. پیش‌فرض 0
                // (غیرفعال) برای MySQL و PostgreSQL است.
                \(dqreconnect\-wait\-time\(dq: 3000,

                // حداکثر دفعات تلاش مجدد برای اتصال.
                \(dqmax\-reconnect\-tries\(dq: 3,

                // اقدامی که هنگام شکست بازیابی اتصال انجام می‌شود.
                // مقادیر پشتیبانی‌شده: stop\-retry\-exit، serve\-retry\-exit،
                // serve\-retry\-continue
                \(dqon\-fail\(dq: \(dqstop\-retry\-exit\(dq,

                // پرچمی که مشخص می‌کند آیا بازیابی پایگاه‌داده باید در هنگام
                // راه‌اندازی کارگزار و در رویدادهای پیکربندی مجدد تلاش شود یا خیر.
                \(dqretry\-on\-startup\(dq: false,

                // مهلت زمانی برقراری اتصال برحسب ثانیه.
                \(dqconnect\-timeout\(dq: 100,

                // مهلت زمانی عملیات خواندن پایگاه‌داده برحسب ثانیه.
                \(dqread\-timeout\(dq: 120,

                // مهلت زمانی عملیات نوشتن پایگاه‌داده برحسب ثانیه.
                \(dqwrite\-timeout\(dq: 180
            },
            {
                // نام پایگاه‌داده برای اتصال.
                \(dqname\(dq: \(dqkeatest\(dq,

                // میزبانی که پایگاه‌داده روی آن قرار دارد.
                \(dqhost\(dq: \(dqlocalhost\(dq,

                // گذرواژهٔ پایگاه‌داده.
                \(dqpassword\(dq: \(dq1234\(dq,

                // درگاهی که پایگاه‌داده روی آن در دسترس است.
                \(dqport\(dq: 5432,

                // نوع پایگاه‌داده، مثلاً \(dqmysql\(dq، \(dqpostgresql\(dq.
                \(dqtype\(dq: \(dqpostgresql\(dq,

                // نام کاربری مورد استفاده برای دسترسی به پایگاه‌داده.
                \(dquser\(dq: \(dqkeatest\(dq,

                // مهلت زمانی کاربر TCP در هنگام ارتباط با پایگاه‌داده.
                // برحسب ثانیه مشخص می‌شود.
                \(dqtcp\-user\-timeout\(dq: 100,

                // لنگر اعتماد یا همان فایل یا دایرکتوری مرجع صدور گواهی (CA).
                \(dqtrust\-anchor\(dq: \(dqmy\-ca\(dq,

                // نام فایل گواهی کلاینت.
                \(dqcert\-file\(dq: \(dqmy\-cert\(dq,

                // نام فایل کلید خصوصی.
                \(dqkey\-file\(dq: \(dqmy\-key\(dq,

                // حالت SSL.
                \(dqssl\-mode\(dq: \(dqverify\-ca\(dq
            }
        ],

        // فهرست انواع شناسه‌های رزرو میزبان که توسط کارگزار Kea DHCPv4
        // برای واکشی رزروهای ایستا برای کلاینت‌های DHCP استفاده می‌شود.
        // به‌طور پیش‌فرض همهٔ شناسه‌ها استفاده می‌شوند، به این معنی که کارگزار
        // پرس‌وجوهای متعددی به پایگاه‌داده ارسال می‌کند تا دریابد آیا رزروی برای
        // یک کلاینت خاص وجود دارد یا خیر. اگر یک استقرار خاص تنها از یک زیرمجموعه،
        // مثلاً یک نوع شناسه استفاده می‌کند، این شناسه باید فقط در اینجا فهرست شود
        // تا از پرس‌وجوهای غیرضروری به پایگاه‌داده جلوگیری شود.
        \(dqhost\-reservation\-identifiers\(dq: [
            \(dqhw\-address\(dq,
            \(dqduid\(dq,
            \(dqcircuit\-id\(dq,
            \(dqclient\-id\(dq,
            \(dqflex\-id\(dq
        ],

        // پیکربندی رابط‌هایی را مشخص می‌کند که کارگزار Kea DHCPv4 روی آن‌ها
        // به درخواست‌های DHCP گوش فرا می‌دهد.
        \(dqinterfaces\-config\(dq: {
            // مشخص می‌کند که آیا کارگزار باید از سوکت‌های \(dqudp\(dq یا سوکت‌های
            // \(dqraw\(dq برای گوش دادن به ترافیک DHCP استفاده کند. سوکت‌های
            // \(dqraw\(dq زمانی مفید هستند که ترافیک مستقیم DHCP
            // دریافت می‌شود.
            \(dqdhcp\-socket\-type\(dq: \(dqudp\(dq,

            // فهرستی از رابط‌هایی را مشخص می‌کند که کارگزار Kea DHCPv4
            // باید روی آن‌ها به درخواست‌های DHCP گوش فرا دهد.
            \(dqinterfaces\(dq: [
                \(dqeth0\(dq
            ],

            // مقداری شمارشی که نشان می‌دهد کدام رابط باید برای
            // ارسال پاسخ‌های DHCP به کلاینت استفاده شود. مقدار پیش‌فرض
            // \(dqsame\-as\-inbound\(dq است که نشان می‌دهد پاسخ باید از طریق رابطی
            // که پرس‌وجوی کلاینت در آن دریافت شده ارسال شود. مقدار \(dquse\-routing\(dq
            // نشان می‌دهد که کارگزار Kea باید از جدول مسیریابی هسته برای یافتن
            // رابط مناسب استفاده کند.
            \(dqoutbound\-interface\(dq: \(dqsame\-as\-inbound\(dq,

            // پرچم بولی که مشخص می‌کند آیا رابط‌های موجود باید پس از پیکربندی
            // مجدد کارگزار دوباره شناسایی شوند یا خیر. مقدار پیش‌فرض true است،
            // به این معنی که رابط‌ها همیشه دوباره شناسایی می‌شوند.
            \(dqre\-detect\(dq: true,

            // Kea سعی می‌کند سوکت‌های سرویس را در هنگام مقداردهی اولیه متصل کند،
            // اما ممکن است به دلیل باز بودن قبلی درگاه یا یک پیکربندی نادرست با شکست مواجه شود. Kea می‌تواند
            // این خطاها را نادیده گرفته و فقط آن‌ها را ثبت کند. این پرچم از راه‌اندازی کارگزار DHCP
            // بدون اتصال همهٔ سوکت‌ها جلوگیری می‌کند. در صورت عدم تعیین،
            // مقدار پیش‌فرض آن false است.
            \(dqservice\-sockets\-require\-all\(dq: true,

            // Kea در زمان مقداردهی اولیه سعی می‌کند سوکت‌های سرویس را متصل کند. این
            // گزینه تعداد دفعات تلاش مجدد برای اتصال به رابط را مشخص می‌کند.
            // مقدار پیش‌فرض 0 است، به این معنی که عملیات تکرار نخواهد شد.
            \(dqservice\-sockets\-max\-retries\(dq: 5,

            // فاصلهٔ زمانی برحسب میلی‌ثانیه برای انتظار پیش از تلاش بعدی
            // جهت باز کردن مجدد سوکت سرویس.
            \(dqservice\-sockets\-retry\-wait\-time\(dq: 5000
        },

        // پارامتر بولی که کنترل می‌کند آیا جستجوی زودهنگام رزروهای سراسری
        // میزبان باید انجام شود یا خیر. این جستجو پیش از انتخاب زیرشبکه رخ می‌دهد
        // و هنگامی که یک رزرو سراسری با برخی کلاس‌های کلاینت یافت شود، یک
        // دسته‌بندی فاز دوم را آغاز می‌کند. همچنین می‌توان از آن برای نادیده گرفتن
        // پرس‌وجوها با استفاده از رزروهای میزبان به عنوان جدول تصمیم‌گیری نمایه‌شده
        // بر اساس شناسه‌های رزرو استفاده کرد.
        \(dqearly\-global\-reservations\-lookup\(dq: true,

        // پارامتر بولی که رفتار کارگزار DHCP را در رابطه با ایجاد رزروهای
        // میزبان برای یک نشانی IP یکسان کنترل می‌کند. به‌طور پیش‌فرض
        // این پرچم روی true تنظیم شده است که در این صورت کارگزار از ایجاد چندین
        // رزرو میزبان برای یک نشانی IP یکسان جلوگیری می‌کند. هنگامی که این پارامتر
        // روی false تنظیم شود، کارگزار اجازهٔ ایجاد چندین رزرو برای یک نشانی IP یکسان
        // را در یک زیرشبکه می‌دهد. این تنظیم در استقرارهایی مفید است که در آن ممکن است
        // یک میزبان مشخص از طریق چندین رابط با کارگزار DHCP ارتباط برقرار کند و بسته
        // به رابط انتخابی، یک نشانی MAC متفاوت (یا شناسهٔ دیگر) برای شناسایی میزبان
        // استفاده شود. توجه داشته باشید که برخی از backendهای میزبان از حالتی که در آن
        // چندین رزرو برای یک نشانی IP یکسان استفاده می‌شود پشتیبانی نمی‌کنند. اگر از این
        // backendها استفاده شود و این تنظیم اعمال گردد، خطای پیکربندی رخ خواهد داد.
        // backendهای MySQL و PostgreSQL از این حالت پشتیبانی می‌کنند.
        \(dqip\-reservations\-unique\(dq: true,

        // پارامتر بولی که کنترل می‌کند آیا جستجوی رزروهای میزبان باید قبل از
        // جستجوی اجاره انجام شود یا خیر. این پارامتر فقط زمانی تأثیر دارد که چندنخی
        // غیرفعال باشد. هنگامی که چندنخی فعال است، جستجوی رزروهای میزبان همیشه ابتدا
        // انجام می‌شود تا از قفل شدن منابع در جستجوی اجاره جلوگیری شود.
        \(dqreservations\-lookup\-first\(dq: true,

        // اعتبارنامه‌های دسترسی به پایگاه‌دادهٔ اجاره را مشخص می‌کند.
        \(dqlease\-database\(dq: {
            // پارامتر مخصوص backend بنام memfile که فاصلهٔ زمانی برحسب
            // ثانیه را مشخص می‌کند که در آن فایل اجاره باید پاک‌سازی شود (ورودی‌های اجارهٔ
            // منسوخ حذف می‌شوند تا از رشد بی‌رویهٔ فایل اجاره جلوگیری شود).
            \(dqlfc\-interval\(dq: 3600,

            // حداکثر تعداد خطاهای خواندن فایل اجاره که مجاز است پیش از آنکه بارگذاری
            // فایل متوقف شود. پیش‌فرض 0 است (بدون محدودیت).
            \(dqmax\-row\-errors\(dq: 100,

            // نام فایل اجاره. در مورد پایگاه‌داده، نام پایگاه‌داده را
            // مشخص می‌کند.
            \(dqname\(dq: \(dqkea\-leases4.csv\(dq,

            // پارامتر مخصوص memfile که نشان می‌دهد آیا اجاره‌ها باید روی
            // ذخیره‌ساز پایدار (دیسک) ذخیره شوند یا خیر. مقدار true پیش‌فرض
            // است و نشان می‌دهد که اجاره‌ها در ذخیره‌ساز پایدار ذخیره می‌شوند.
            // این تنظیم باید در محیط عملیاتی استفاده شود. مقدار false فقط باید
            // برای اهداف آزمایشی استفاده شود زیرا اجاره‌های ذخیره‌نشده پس از
            // راه‌اندازی مجدد کارگزار Kea از بین خواهند رفت.
            \(dqpersist\(dq: true,

            // نوع backend پایگاه‌دادهٔ اجاره، یعنی \(dqmemfile\(dq، \(dqmysql\(dq یا
            // \(dqpostgresql\(dq.
            \(dqtype\(dq: \(dqmemfile\(dq
        },

        // مقدار بولی که نشان می‌دهد آیا کارگزار Kea DHCPv4 باید از مقدار شناسهٔ کلاینت
        // ارسال‌شده توسط کلاینت استفاده کند یا آن را نادیده بگیرد. مقدار پیش‌فرض true است
        // که نشان می‌دهد کارگزار باید از شناسهٔ کلاینت استفاده کند و این شناسه نسبت به
        // نشانی MAC کلاینت اولویت دارد. در استقرارهایی که نشانی MAC باید اولویت داشته باشد،
        // این مقدار را می‌توان روی false تنظیم کرد که در این صورت کلاینت‌ها با نشانی MAC
        // شناسایی می‌شوند. این مورد به‌ویژه زمانی مفید است که کلاینت‌ها شناسه‌های یکتا
        // تولید نمی‌کنند یا این شناسه‌ها پایدار نیستند، و غیره.
        \(dqmatch\-client\-id\(dq: false,

        // مقدار سراسری نشانی کارگزار بعدی که در فیلد \(aqsiaddr\(aq تنظیم می‌شود.
        // مقدار سراسری ممکن است در محدوده‌های پیکربندی سطوح پایین‌تر
        // بازنویسی شود.
        \(dqnext\-server\(dq: \(dq192.0.2.123\(dq,

        // مقدار سراسری که تعداد بسته‌های کلاینت (مثلاً DHCPREQUESTها) را محدود
        // می‌کند که ممکن است در حین انتظار برای تکمیل کار کتابخانهٔ قلاب، پیش از ارسال پاسخ
        // (مثلاً DHCPACK) به کلاینت متوقف شوند. یک نمونهٔ بارز زمانی است که kea\-dhcp4
        // یک DHCPREQUEST را پارک می‌کند در حالی که به‌روزرسانی(های) اجاره را به همتایان HA خود ارسال می‌کند.
        // پس از تأیید به‌روزرسانی(ها)، بسته از حالت توقف خارج می‌شود.
        // این مقدار تعداد بسته‌هایی را که می‌توانند در انتظار به‌روزرسانی‌ها باقی بمانند
        // محدود می‌کند. در زمان ترافیک سنگین کلاینت‌ها، این مقدار می‌تواند مانع از تجمع بیش از حد
        // به‌روزرسانی‌های معوق در kea\-dhcp4 شود.
        \(dqparked\-packet\-limit\(dq: 256,

        // فهرست گزینه‌های سراسری DHCP که کارگزار Kea DHCPv4 به
        // کلاینت‌ها اختصاص می‌دهد.
        \(dqoption\-data\(dq: [
            {
                // پرچم بولی که نشان می‌دهد آیا گزینهٔ داده‌شده همیشه
                // در پاسخ ارسال شود یا تنها در صورت درخواست. مقدار پیش‌فرض
                // false نشان می‌دهد که تنها در صورت درخواست ارسال می‌شود.
                \(dqalways\-send\(dq: false,

                // فهرستی اختیاری از کلاس‌ها که این گزینه برای آن‌ها اعمال می‌شود.
                // اگر کلاینت با هر یک از کلاس‌های این فهرست مطابقت داشته باشد،
                // گزینه اعمال خواهد شد. اگر فهرست خالی باشد یا حذف شود،
                // این گزینه بدون در نظر گرفتن عضویت در کلاس اعمال می‌شود.
                \(dqclient\-classes\(dq: [ \(dqclass1\(dq, \(dqclass2\(dq ],

                // کد گزینه. در صورت ارائهٔ نام گزینه الزامی نیست.
                \(dqcode\(dq: 6,

                // مقدار بولی که نشان می‌دهد داده‌های گزینهٔ مشخص‌شده در فیلد \(dqdata\(dq
                // به صورت یک رشته از ارقام شانزده‌شانزدهی مشخص شده است یا در قالب CSV خوانا برای انسان.
                \(dqcsv\-format\(dq: true,

                // داده‌های گزینه که باید در بار مفید گزینه ذخیره شوند.
                \(dqdata\(dq: \(dq192.0.3.1, 192.0.3.2\(dq,

                // نام گزینه. در صورت ارائهٔ کد گزینه الزامی نیست.
                \(dqname\(dq: \(dqdomain\-name\-servers\(dq,

                // پرچم بولی که نشان می‌دهد آیا گزینهٔ داده‌شده هرگز
                // در پاسخ ارسال نشود یا خیر. مقدار پیش‌فرض false نشان می‌دهد
                // که در صورت نیاز ارسال می‌شود. وقتی true باشد، گزینه صرف‌نظر از هر تنظیم دیگری
                // ارسال نمی‌شود، یعنی یک پرچم نهایی است.
                \(dqnever\-send\(dq: false,

                // فضای گزینه. پیش‌فرض، فضای گزینهٔ \(dqdhcp4\(dq است که
                // گزینه‌های سطح بالای DHCPv4 را گروه‌بندی می‌کند.
                \(dqspace\(dq: \(dqdhcp4\(dq
            }
        ],

        // فهرست تعاریف گزینه‌های سراسری، یعنی قالب‌های گزینه‌ای که
        // کارگزار Kea DHCPv4 از آن‌ها استفاده می‌کند.
        \(dqoption\-def\(dq: [
            {
                // پرچم بولی که نشان می‌دهد آیا تعریف گزینه شامل آرایه‌ای از
                // مقادیر با نوع مشخص است، مانند آرایه‌ای از نشانی‌های IPv4.
                // مقدار پیش‌فرض false به این معنی است که گزینه شامل
                // آرایه‌ای از مقادیر نیست.
                \(dqarray\(dq: false,

                // کد گزینه.
                \(dqcode\(dq: 6,

                // نام فضای گزینه‌ای را که توسط این گزینه کپسوله‌سازی شده نگه می‌دارد.
                // همهٔ گزینه‌های متعلق به این فضای گزینه به عنوان زیرگزینه‌های
                // این گزینه ارسال خواهند شد. یک رشتهٔ خالی به این معناست که
                // این گزینه هیچ گزینه‌ای را کپسوله‌سازی نمی‌کند.
                \(dqencapsulate\(dq: \(dq\(dq,

                // نام گزینه.
                \(dqname\(dq: \(dqmy\-option\(dq,

                // در صورتی که گزینه از نوع \(dqrecord\(dq باشد (به \(dqtype\(dq نگاه کنید)،
                // انواع فیلدهای درون گزینه را مشخص می‌کند. در این مثال خاص،
                // این گزینه شامل دو فیلد با طول‌های ۱ بایت و ۲ بایت است.
                \(dqrecord\-types\(dq: \(dquint8, uint16\(dq,

                // نام فضای گزینه‌ای که این گزینه به آن تعلق دارد.
                \(dqspace\(dq: \(dqmy\-space\(dq,

                // نوع گزینه. همهٔ انواع ممکن در راهنمای مرجع
                // مدیر Kea فهرست شده‌اند.
                \(dqtype\(dq: \(dqrecord\(dq
            }
        ],

        // مقدار سراسری برای زمان‌سنج rebind، یعنی زمانی که پس از آن کلاینت
        // DHCP در صورت عدم موفقیت در تمدید اجاره، وارد حالت rebind می‌شود.
        \(dqrebind\-timer\(dq: 40,

        // مقدار سراسری برای زمان‌سنج renew، یعنی زمانی که پس از آن
        // کلاینت DHCP اجاره را تمدید می‌کند.
        \(dqrenew\-timer\(dq: 30,

        // مقدار سراسری برای ذخیرهٔ اطلاعات گسترش‌یافته (مثلاً اطلاعات عامل
        // بازپخش) همراه با هر اجاره.
        \(dqstore\-extended\-info\(dq: true,

        // آمارها نمونه‌هایی را در هر نقطهٔ مشاهده نگه می‌دارند.
        // دو مقدار پیش‌فرض وجود دارد: حداکثر تعداد و حداکثر طول عمر.
        // تنظیم حداکثر تعداد روی صفر آن را غیرفعال می‌کند.
        \(dqstatistic\-default\-sample\-count\(dq: 0,

        // هنگامی که حداکثر تعداد 0 است، حداکثر طول عمر (برحسب ثانیه) اعمال می‌شود.
        \(dqstatistic\-default\-sample\-age\(dq: 60,

        // پارامترهای چندنخی.
        \(dqmulti\-threading\(dq: {
            // به‌طور پیش‌فرض، اگر سخت‌افزار اجازه دهد، Kea بسته‌ها را روی چندین نخ پردازش می‌کند.
            \(dqenable\-multi\-threading\(dq: true,

            // هنگامی که چندنخی فعال باشد، Kea بسته‌ها را روی تعدادی نخ پردازش می‌کند
            // که از طریق این گزینه قابل تنظیم است. مقدار باید یک عدد صحیح مثبت باشد
            // (0 به معنی تشخیص خودکار است).
            \(dqthread\-pool\-size\(dq: 0,

            // هنگامی که چندنخی فعال باشد، Kea بسته‌ها را از رابط می‌خواند
            // و یک مورد کاری به استخر نخ‌ها اضافه می‌کند. این گزینه حداکثر تعداد
            // مواردی را که می‌توان در صف قرار داد پیکربندی می‌کند.
            // مقدار باید یک عدد صحیح مثبت باشد (0 یعنی نامحدود).
            \(dqpacket\-queue\-size\(dq: 0
        },

        // نحوهٔ برخورد کارگزار Kea DHCPv4 با داده‌های نامعتبر
        // دریافت شده از کلاینت را تعیین می‌کند.
        \(dqsanity\-checks\(dq: {
            // مشخص می‌کند که کارگزار Kea DHCPv4 در هنگام خواندن داده‌های نامعتبر
            // برای یک اجاره از فایل اجاره چگونه باید رفتار کند. مقادیر زیر
            // پشتیبانی می‌شوند: \(dqnone\(dq (تلاشی برای تصحیح اطلاعات اجاره نکن)،
            // \(dqwarn\(dq (چاپ یک هشدار برای ناسازگاری‌های مربوط به subnet\-id)،
            // \(dqfix\(dq (تصحیح شناسهٔ زیرشبکه با تلاش برای یافتن زیرشبکهٔ مناسب)،
            // \(dqfix\-del\(dq (مشابه \(dqfix\(dq اما اگر زیرشبکهٔ مناسبی یافت نشد اجاره حذف شود)،
            // \(dqdel\(dq (حذف اجاره در صورتی که اجاره دارای مقدار شناسهٔ زیرشبکهٔ نامعتبر باشد).
            \(dqlease\-checks\(dq: \(dqwarn\(dq,

            // نحوهٔ رفتار کارگزار Kea DHCPv4 در هنگام خواندن اطلاعات گسترش‌یافتهٔ
            // نامعتبر برای یک اجاره از فایل اجاره یا ارتقا از قالب قدیمی را مشخص می‌کند.
            // مقادیر زیر پشتیبانی می‌شوند: \(dqnone\(dq (تلاشی برای تصحیح یا ارتقای
            // اطلاعات گسترش‌یافته نکن)، \(dqfix\(dq (اصلاح ناسازگاری‌های رایج و
            // ارتقا از قالب قدیمی؛ این مقدار پیش‌فرض است)، \(dqstrict\(dq
            // (اصلاح ناسازگاری‌های دارای تأثیر بر Leasequery)،
            // \(dqpedantic\(dq (اعمال قالب کامل کد Kea).
            \(dqextended\-info\-checks\(dq: \(dqfix\(dq
        },

        // فهرست شبکه‌های مشترک استفاده‌شده توسط کارگزار Kea DHCPv4.
        // شبکه‌های مشترک زیرشبکه‌ها را با هم گروه‌بندی می‌کنند.
        \(dqshared\-networks\(dq: [
            {
                // پرچمی برای انتخاب یک راهبرد تخصیص نشانی IP برای همهٔ
                // زیرشبکه‌ها در این شبکهٔ مشترک.
                \(dqallocator\(dq: \(dqrandom\(dq,

                // پرچم معتبر در سطح شبکهٔ مشترک.
                \(dqauthoritative\(dq: false,

                // نام فایل راه‌اندازی در سطح شبکهٔ مشترک.
                \(dqboot\-file\-name\(dq: \(dq/dev/null\(dq,

                // این شبکهٔ مشترک را محدود می‌کند تا تنها به کلاینت‌هایی اجازه دهد
                // که دست‌کم به یکی از کلاس‌های این فهرست تعلق دارند. اگر حذف شود
                // یا یک فهرست خالی ارائه شود، هیچ محدودیتی اعمال نمی‌شود.
                \(dqclient\-classes\(dq: [],

                // مقدار در سطح شبکهٔ مشترک. توضیحات در سطح سراسری را ببینید.
                \(dqddns\-generated\-prefix\(dq: \(dqmyhost\(dq,

                // مقدار در سطح شبکهٔ مشترک. توضیحات در سطح سراسری را ببینید.
                \(dqddns\-override\-client\-update\(dq: false,

                // مقدار در سطح شبکهٔ مشترک. توضیحات در سطح سراسری را ببینید.
                \(dqddns\-override\-no\-update\(dq: false,

                // مقدار در سطح شبکهٔ مشترک. توضیحات در سطح سراسری را ببینید.
                \(dqddns\-qualifying\-suffix\(dq: \(dq\(dq,

                // مقدار در سطح شبکهٔ مشترک. توضیحات در سطح سراسری را ببینید.
                \(dqddns\-replace\-client\-name\(dq: \(dqnever\(dq,

                // مقدار در سطح شبکهٔ مشترک. توضیحات در سطح سراسری را ببینید.
                \(dqddns\-send\-updates\(dq: true,

                // مقدار در سطح شبکهٔ مشترک. توضیحات در سطح سراسری را ببینید.
                \(dqddns\-update\-on\-renew\(dq: true,

                // مقدار در سطح شبکهٔ مشترک. توضیحات در سطح سراسری را ببینید.
                // این فیلد با ddns\-conflict\-resolution\-mode جایگزین شده است.
                // تجزیهٔ آن صرفاً برای سازگاری عقبرو حفظ شده است.
                // \(dqddns\-use\-conflict\-resolution\(dq: true,

                // مقدار در سطح شبکهٔ مشترک. توضیحات در سطح سراسری را ببینید.
                \(dqddns\-conflict\-resolution\-mode\(dq: \(dqcheck\-with\-dhcid\(dq,

                // مقدار در سطح شبکهٔ مشترک. توضیحات در سطح سراسری را ببینید.
                \(dqddns\-ttl\-percent\(dq: 0.65,

                // مقدار در سطح شبکهٔ مشترک. توضیحات در سطح سراسری را ببینید.
                // نمی‌توانید هم ddns\-ttl و هم هر یک از ddns\-ttl\-percent، ddns\-ttl\-min یا
                // ddns\-ttl\-max را مشخص کنید. آن‌ها مانعة‌الجمع هستند.
                // \(dqddns\-ttl\(dq: 500,

                // مقدار در سطح شبکهٔ مشترک. توضیحات در سطح سراسری را ببینید.
                \(dqddns\-ttl\-min\(dq: 10000,

                // مقدار در سطح شبکهٔ مشترک. توضیحات در سطح سراسری را ببینید.
                \(dqddns\-ttl\-max\(dq: 20000,

                // مقدار در سطح شبکهٔ مشترک. توضیحات در سطح سراسری را ببینید.
                \(dqhostname\-char\-replacement\(dq: \(dqx\(dq,

                // مقدار در سطح شبکهٔ مشترک. توضیحات در سطح سراسری را ببینید.
                \(dqhostname\-char\-set\(dq: \(dq[^A\-Za\-z0\-9.\-]\(dq,

                // مشخص می‌کند که این شبکهٔ مشترک برای درخواست‌های دریافت شده
                // روی یک رابط خاص انتخاب شده است.
                \(dqinterface\(dq: \(dqeth0\(dq,

                // پرچم در سطح شبکهٔ مشترک که مشخص می‌کند آیا شناسهٔ کلاینت
                // باید برای شناسایی کلاینت‌ها استفاده شود یا خیر.
                \(dqmatch\-client\-id\(dq: true,

                // نام شبکهٔ مشترک.
                \(dqname\(dq: \(dqmy\-secret\-network\(dq,

                // مشخصات کارگزار بعدی در سطح شبکهٔ مشترک جهت
                // ارسال در \(aqsiaddr\(aq.
                \(dqnext\-server\(dq: \(dq192.0.2.123\(dq,

                // اگر بزرگ‌تر از صفر باشد، مدت‌زمان اعتبار اجاره‌هایی است که موقتاً
                // در DISCOVER تخصیص می‌یابند. وقتی صفر باشد (پیش‌فرض)، اجاره‌ها در DISCOVER تخصیص داده نمی‌شوند.
                \(dqoffer\-lifetime\(dq : 60,

                // فهرست گزینه‌های DHCP مخصوص شبکهٔ مشترک.
                \(dqoption\-data\(dq: [],

                // فهرست نشانی‌های بازپخش IPv4 که این شبکهٔ مشترک برای
                // آن‌ها انتخاب می‌شود.
                \(dqrelay\(dq: {
                    \(dqip\-addresses\(dq: []
                },

                // زمان‌سنج rebind در سطح شبکهٔ مشترک.
                \(dqrebind\-timer\(dq: 41,

                // زمان‌سنج renew در سطح شبکهٔ مشترک.
                \(dqrenew\-timer\(dq: 31,

                // محاسبهٔ زمان‌سنج‌های T1 و T2 در سطح شبکهٔ مشترک.
                \(dqcalculate\-tee\-times\(dq: true,

                // T1 = valid lifetime * .5.
                \(dqt1\-percent\(dq: .5,

                // T2 = valid lifetime * .75.
                \(dqt2\-percent\(dq: .75,

                // آستانهٔ حافظهٔ پنهان = valid lifetime * .25.
                \(dqcache\-threshold\(dq: .25,

                // حداکثر حافظهٔ پنهان: زمانی که زمان آخرین ارسال کلاینت به اندازهٔ کافی
                // نزدیک باشد، اجاره تمدید نمی‌شود و اجارهٔ فعلی به صورت \(dqcached\(dq بازگردانده می‌شود.
                \(dqcache\-max\-age\(dq: 1000,

                // آستانهٔ زمان اجارهٔ تطبیقی (1.0 غیرفعال است).
                \(dqadaptive\-lease\-time\-threshold\(dq: 0.8,

                // مشخص می‌کند که آیا کارگزار باید رزروهای سراسری را جستجو کند یا خیر.
                \(dqreservations\-global\(dq: false,

                // مشخص می‌کند که آیا کارگزار باید رزروهای درون زیرشبکه را جستجو کند یا خیر.
                \(dqreservations\-in\-subnet\(dq: true,

                // مشخص می‌کند که آیا کارگزار می‌تواند فرض کند همهٔ نشانی‌های رزروشده
                // خارج از استخر هستند یا خیر.
                // هنگامی که reservations\-in\-subnet برابر با false باشد نادیده گرفته می‌شود.
                // در صورت مشخص شدن، به سطوح \(dqsubnet4\(dq به ارث می‌رسد.
                \(dqreservations\-out\-of\-pool\(dq: false,

                // فهرست کلاس‌های کلاینت که باید در هنگام انتخاب این شبکهٔ مشترک
                // برای تخصیص به کلاینت ارزیابی شوند.
                \(dqevaluate\-additional\-classes\(dq: [ \(dqlate\(dq ],

                // خاموش کردن ذخیرهٔ اطلاعات گسترش‌یافته (مانند اطلاعات عامل بازپخش)
                // همراه با هر اجاره برای این شبکهٔ مشترک.
                \(dqstore\-extended\-info\(dq: false,

                // نام میزبان کارگزار در سطح شبکهٔ مشترک که در فیلد \(aqsname\(aq تنظیم می‌شود.
                \(dqserver\-hostname\(dq: \(dq\(dq,

                // فهرست زیرشبکه‌های IPv4 متعلق به این شبکهٔ مشترک.
                \(dqsubnet4\(dq: [
                    {
                        // نام رابط تطبیق‌داده‌شده با نام رابط ورودی.
                        // استفاده‌شده در DHCPv4o6. استاندارد RFC 7341 را ببینید.
                        \(dq4o6\-interface\(dq: \(dq\(dq,

                        // مقدار گزینهٔ شناسهٔ رابط. استاندارد RFC 7341 را ببینید.
                        \(dq4o6\-interface\-id\(dq: \(dq\(dq,

                        // پیشوند تطبیق‌داده‌شده با نشانی مبدأ. استاندارد RFC 7341 را ببینید.
                        \(dq4o6\-subnet\(dq: \(dq2001:db8:1:1::/64\(dq,

                        // پرچمی برای انتخاب یک راهبرد تخصیص نشانی IP برای
                        // این زیرشبکه.
                        \(dqallocator\(dq: \(dqiterative\(dq,

                        // پرچم معتبر در سطح زیرشبکه.
                        \(dqauthoritative\(dq: false,

                        // نام فایل راه‌اندازی در سطح زیرشبکه، تنظیم‌شده در فیلد \(aqfile\(aq.
                        \(dqboot\-file\-name\(dq: \(dq\(dq,

                        // این زیرشبکه را محدود می‌کند تا تنها به کلاینت‌هایی اجازه دهد
                        // که دست‌کم به یکی از کلاس‌های این فهرست تعلق دارند. اگر حذف شود
                        // یا یک فهرست خالی ارائه شود، هیچ محدودیتی اعمال نمی‌شود.
                        \(dqclient\-classes\(dq: [],

                        // مقدار در سطح زیرشبکه. توضیحات در سطح سراسری را ببینید.
                        \(dqddns\-generated\-prefix\(dq: \(dqmyhost\(dq,

                        // مقدار در سطح زیرشبکه. توضیحات در سطح سراسری را ببینید.
                        \(dqddns\-override\-client\-update\(dq: false,

                        // مقدار در سطح زیرشبکه. توضیحات در سطح سراسری را ببینید.
                        \(dqddns\-override\-no\-update\(dq: false,

                        // مقدار در سطح زیرشبکه. توضیحات در سطح سراسری را ببینید.
                        \(dqddns\-qualifying\-suffix\(dq: \(dq\(dq,

                        // مقدار در سطح زیرشبکه. توضیحات در سطح سراسری را ببینید.
                        \(dqddns\-replace\-client\-name\(dq: \(dqnever\(dq,

                        // مقدار در سطح زیرشبکه. توضیحات در سطح سراسری را ببینید.
                        \(dqddns\-send\-updates\(dq: true,

                        // مقدار در سطح زیرشبکه. توضیحات در سطح سراسری را ببینید.
                        \(dqddns\-update\-on\-renew\(dq: true,

                        // مقدار در سطح شبکهٔ مشترک. توضیحات در سطح سراسری را ببینید.
                        // این فیلد با ddns\-conflict\-resolution\-mode جایگزین شده است.
                        // تجزیهٔ آن صرفاً برای سازگاری عقبرو حفظ شده است.
                        // \(dqddns\-use\-conflict\-resolution\(dq: true,

                        // مقدار در سطح زیرشبکه. توضیحات در سطح سراسری را ببینید.
                        \(dqddns\-conflict\-resolution\-mode\(dq: \(dqcheck\-with\-dhcid\(dq,

                        // مقدار در سطح زیرشبکه. توضیحات در سطح سراسری را ببینید.
                        // \(dqddns\-ttl\-percent\(dq: 0.55,

                        // مقدار در سطح زیرشبکه. توضیحات در سطح سراسری را ببینید.
                        // نمی‌توانید هم ddns\-ttl و هم هر یک از ddns\-ttl\-percent، ddns\-ttl\-min یا
                        // ddns\-ttl\-max را مشخص کنید. آن‌ها مانعة‌الجمع هستند.
                        // \(dqddns\-ttl\(dq: 500,

                        // مقدار در سطح زیرشبکه. توضیحات در سطح سراسری را ببینید.
                        // \(dqddns\-ttl\-min\(dq: 10000,

                        // مقدار در سطح زیرشبکه. توضیحات در سطح سراسری را ببینید.
                        // \(dqddns\-ttl\-max\(dq: 20000,

                        // مقدار در سطح زیرشبکه. توضیحات در سطح سراسری را ببینید.
                        \(dqhostname\-char\-replacement\(dq: \(dqx\(dq,

                        // مقدار در سطح زیرشبکه. توضیحات در سطح سراسری را ببینید.
                        \(dqhostname\-char\-set\(dq: \(dq[^A\-Za\-z0\-9.\-]\(dq,

                        // شناسهٔ یکتای زیرشبکه.
                        \(dqid\(dq: 1,

                        // مشخص می‌کند که این زیرشبکه برای درخواست‌های دریافت شده
                        // روی یک رابط خاص انتخاب شده است.
                        \(dqinterface\(dq: \(dqeth0\(dq,

                        // پرچم در سطح زیرشبکه که مشخص می‌کند آیا شناسهٔ کلاینت
                        // باید برای شناسایی کلاینت‌ها استفاده شود یا خیر.
                        \(dqmatch\-client\-id\(dq: true,

                        // مشخصات کارگزار بعدی در سطح زیرشبکه جهت ارسال
                        // در \(aqsiaddr\(aq.
                        \(dqnext\-server\(dq: \(dq0.0.0.0\(dq,

                        // اگر بزرگ‌تر از صفر باشد، مدت‌زمان اعتبار اجاره‌هایی است که موقتاً
                        // در DISCOVER تخصیص می‌یابند. وقتی صفر باشد (پیش‌فرض)، اجاره‌ها در DISCOVER تخصیص داده نمی‌شوند.
                        \(dqoffer\-lifetime\(dq : 60,

                        // روشن کردن ذخیرهٔ اطلاعات گسترش‌یافته (مانند اطلاعات عامل
                        // بازپخش) همراه با هر اجاره برای این زیرشبکه.
                        \(dqstore\-extended\-info\(dq: true,

                        // فهرست گزینه‌های DHCP در سطح زیرشبکه.
                        \(dqoption\-data\(dq: [
                            {
                                // پرچم بولی که نشان می‌دهد آیا گزینهٔ خاص باید همیشه
                                // ارسال شود یا فقط در صورت درخواست ارسال گردد.
                                \(dqalways\-send\(dq: false,

                                // فهرستی اختیاری از کلاس‌ها که این گزینه برای آن‌ها اعمال می‌شود.
                                // اگر کلاینت با هر یک از کلاس‌های این فهرست مطابقت داشته باشد،
                                // گزینه اعمال خواهد شد. اگر فهرست خالی باشد یا حذف شود،
                                // این گزینه بدون در نظر گرفتن عضویت در کلاس اعمال می‌شود.
                                \(dqclient\-classes\(dq: [],

                                // کد گزینه.
                                \(dqcode\(dq: 3,

                                // پرچم بولی که نشان می‌دهد آیا مقدار گزینهٔ مشخص‌شده
                                // در \(dqdata\(dq رشته‌ای از مقادیر شانزده‌شانزدهی است یا مقدار خوانا برای انسان
                                // در قالب CSV.
                                \(dqcsv\-format\(dq: true,

                                // داده‌های گزینه که باید در بار مفید گزینه گنجانده شوند.
                                \(dqdata\(dq: \(dq192.0.3.1\(dq,

                                // نام گزینه.
                                \(dqname\(dq: \(dqrouters\(dq,

                                // پرچم بولی که نشان می‌دهد آیا گزینهٔ داده‌شده هرگز
                                // در پاسخ ارسال نشود یا خیر.
                                \(dqnever\-send\(dq: false,

                                // فضای گزینه. مقدار پیش‌فرض \(dqdhcp4\(dq نشان‌دهندهٔ
                                // فضای گزینهٔ سطح بالا است.
                                \(dqspace\(dq: \(dqdhcp4\(dq
                            }
                        ],

                        // فهرست استخرهای نشانی IP متعلق به زیرشبکه.
                        \(dqpools\(dq: [
                            {
                                // این استخر را محدود می‌کند تا تنها به کلاینت‌هایی اجازه دهد
                                // که دست‌کم به یکی از کلاس‌های این فهرست تعلق دارند. اگر حذف شود
                                // یا یک فهرست خالی ارائه شود، هیچ محدودیتی اعمال نمی‌شود.
                                \(dqclient\-classes\(dq: [ \(dqphones_server1\(dq ],

                                // فهرست گزینه‌های DHCP در سطح استخر.
                                \(dqoption\-data\(dq: [],

                                // محدودهٔ نشانی‌های استفاده‌شده برای تخصیص به کلاینت.
                                \(dqpool\(dq: \(dq192.1.0.1 \- 192.1.0.200\(dq,

                                // فهرست کلاس‌های کلاینت که باید در هنگام انتخاب این استخر
                                // برای تخصیص به کلاینت ارزیابی شوند.
                                \(dqevaluate\-additional\-classes\(dq: [ \(dqlate\(dq ],

                                // مقدار در سطح استخر. توضیحات در سطح سراسری را ببینید.
                                \(dqddns\-generated\-prefix\(dq: \(dqmypool\(dq,

                                // مقدار در سطح استخر. توضیحات در سطح سراسری را ببینید.
                                \(dqddns\-override\-client\-update\(dq: false,

                                // مقدار در سطح استخر. توضیحات در سطح سراسری را ببینید.
                                \(dqddns\-override\-no\-update\(dq: false,

                                // مقدار در سطح استخر. توضیحات در سطح سراسری را ببینید.
                                \(dqddns\-qualifying\-suffix\(dq: \(dqpool.example.com.\(dq,

                                // مقدار در سطح استخر. توضیحات در سطح سراسری را ببینید.
                                \(dqddns\-replace\-client\-name\(dq: \(dqalways\(dq,

                                // مقدار در سطح استخر. توضیحات در سطح سراسری را ببینید.
                                \(dqddns\-send\-updates\(dq: true,

                                // مقدار در سطح استخر. توضیحات در سطح سراسری را ببینید.
                                \(dqddns\-update\-on\-renew\(dq: false,

                                // مقدار در سطح استخر. توضیحات در سطح سراسری را ببینید.
                                \(dqddns\-conflict\-resolution\-mode\(dq: \(dqcheck\-with\-dhcid\(dq,

                                // مقدار در سطح استخر. توضیحات در سطح سراسری را ببینید.
                                \(dqddns\-ttl\-percent\(dq: 0.55,

                                // مقدار در سطح استخر. توضیحات در سطح سراسری را ببینید.
                                // نمی‌توانید هم ddns\-ttl و هم هر یک از ddns\-ttl\-percent،
                                // ddns\-ttl\-min یا ddns\-ttl\-max را مشخص کنید. آن‌ها مانعة‌الجمع هستند.
                                // \(dqddns\-ttl\(dq: 500,

                                // مقدار در سطح استخر. توضیحات در سطح سراسری را ببینید.
                                \(dqddns\-ttl\-min\(dq: 10000,

                                // مقدار در سطح استخر. توضیحات در سطح سراسری را ببینید.
                                \(dqddns\-ttl\-max\(dq: 20000,

                                // مقدار در سطح استخر. توضیحات در سطح سراسری را ببینید.
                                \(dqhostname\-char\-replacement\(dq: \(dqx\(dq,

                                // مقدار در سطح استخر. توضیحات در سطح سراسری را ببینید.
                                \(dqhostname\-char\-set\(dq: \(dq[^A\-Za\-z0\-9.\-]\(dq
                            },
                            {
                                // این استخر را محدود می‌کند تا تنها به کلاینت‌هایی اجازه دهد
                                // که دست‌کم به یکی از کلاس‌های این فهرست تعلق دارند. اگر حذف شود
                                // یا یک فهرست خالی ارائه شود، هیچ محدودیتی اعمال نمی‌شود.
                                \(dqclient\-classes\(dq: [ \(dqphones_server2\(dq ],

                                // فهرست گزینه‌های DHCP در سطح استخر.
                                \(dqoption\-data\(dq: [],

                                // محدودهٔ نشانی‌های استفاده‌شده برای تخصیص به کلاینت.
                                \(dqpool\(dq: \(dq192.3.0.1 \- 192.3.0.200\(dq,

                                // فهرست کلاس‌های کلاینت که باید در هنگام انتخاب این استخر
                                // برای تخصیص به کلاینت ارزیابی شوند.
                                \(dqevaluate\-additional\-classes\(dq: [],

                                // شناسهٔ استخر که برای فعال‌سازی آمارها برای این استخر استفاده می‌شود.
                                // شناسهٔ استخر نیازی نیست در درون زیرشبکه یا در میان زیرشبکه‌ها
                                // یکتا باشد. اگر پیکربندی نشود، پیش‌فرض آن 0 است. آمارهای
                                // مربوط به این استخر با سایر آمارهای همهٔ استخرهای دیگر با همان
                                // شناسهٔ استخر در این زیرشبکه ترکیب خواهد شد.
                                \(dqpool\-id\(dq: 1
                            }
                        ],

                        // مقدار زمان‌سنج rebind در سطح زیرشبکه.
                        \(dqrebind\-timer\(dq: 40,

                        // فهرست نشانی‌های بازپخش IPv4 که این زیرشبکه برای آن‌ها انتخاب می‌شود.
                        \(dqrelay\(dq: {
                            \(dqip\-addresses\(dq: [
                                \(dq192.168.56.1\(dq
                            ]
                        },

                        // مقدار زمان‌سنج renew در سطح زیرشبکه.
                        \(dqrenew\-timer\(dq: 30,

                        // مشخص می‌کند که آیا کارگزار باید رزروهای سراسری را جستجو کند یا خیر.
                        \(dqreservations\-global\(dq: false,

                        // مشخص می‌کند که آیا کارگزار باید رزروهای درون زیرشبکه را جستجو کند یا خیر.
                        \(dqreservations\-in\-subnet\(dq: true,

                        // مشخص می‌کند که آیا کارگزار می‌تواند فرض کند همهٔ نشانی‌های
                        // رزروشده خارج از استخر هستند یا خیر.
                        // هنگامی که reservations\-in\-subnet برابر با false باشد نادیده گرفته می‌شود.
                        \(dqreservations\-out\-of\-pool\(dq: false,

                        // محاسبهٔ زمان‌سنج‌های T1 و T2 در سطح زیرشبکه.
                        \(dqcalculate\-tee\-times\(dq: true,

                        // T1 = valid lifetime * .5.
                        \(dqt1\-percent\(dq: .5,

                        // T2 = valid lifetime * .75.
                        \(dqt2\-percent\(dq: .75,

                        // آستانهٔ حافظهٔ پنهان = valid lifetime * .25.
                        \(dqcache\-threshold\(dq: .25,

                        // حداکثر حافظهٔ پنهان در سطح زیرشبکه.
                        \(dqcache\-max\-age\(dq: 1000,

                        // آستانهٔ زمان اجارهٔ تطبیقی (1.0 غیرفعال است).
                        \(dqadaptive\-lease\-time\-threshold\(dq: 0.8,

                        // فهرست رزروهای ایستای IPv4 اختصاص‌یافته به کلاینت‌های متعلق
                        // به این زیرشبکه. برای یک مثال دقیق، reservations.json را ببینید.
                        \(dqreservations\(dq: [
                            {
                                // شناسهٔ استفاده‌شده برای مطابقت کلاینت. مقادیر پشتیبانی‌شده عبارتند از:
                                // \(dqhw\-address\(dq، \(dqclient\-id\(dq، \(dqduid\(dq، \(dqcircuit\-id\(dq، \(dqflex\-id\(dq.
                                \(dqcircuit\-id\(dq: \(dq01:11:22:33:44:55:66\(dq,

                                // نشانی IP رزروشده.
                                \(dqip\-address\(dq: \(dq192.0.2.204\(dq,

                                // نام میزبان.
                                \(dqhostname\(dq: \(dqfoo.example.org\(dq,

                                // داده‌های گزینهٔ مخصوص رزرو.
                                \(dqoption\-data\(dq: [
                                    {
                                        // نام گزینه.
                                        \(dqname\(dq: \(dqvivso\-suboptions\(dq,

                                        // داده‌های گزینه.
                                        \(dqdata\(dq: \(dq4491\(dq
                                    }
                                ]
                            }
                        ],

                        // فهرست کلاس‌های کلاینت که باید در هنگام انتخاب این زیرشبکه
                        // برای تخصیص به کلاینت ارزیابی شوند.
                        \(dqevaluate\-additional\-classes\(dq: [ \(dqlate\(dq ],

                        // نام میزبان کارگزار در سطح زیرشبکه که در فیلد \(aqsname\(aq تنظیم می‌شود.
                        \(dqserver\-hostname\(dq: \(dq\(dq,

                        // پیشوند زیرشبکه.
                        \(dqsubnet\(dq: \(dq192.0.0.0/8\(dq,

                        // مدت‌زمان اعتبار (پیش‌فرض) در سطح زیرشبکه.
                        \(dqvalid\-lifetime\(dq: 6000,

                        // حداقل مدت‌زمان اعتبار در سطح زیرشبکه.
                        \(dqmin\-valid\-lifetime\(dq: 4000,

                        // حداکثر مدت‌زمان اعتبار در سطح زیرشبکه.
                        \(dqmax\-valid\-lifetime\(dq: 8000
                    }
                ],

                // مدت‌زمان اعتبار (پیش‌فرض) در سطح شبکهٔ مشترک.
                \(dqvalid\-lifetime\(dq: 6001,

                // حداقل مدت‌زمان اعتبار در سطح شبکهٔ مشترک.
                \(dqmin\-valid\-lifetime\(dq: 4001,

                // حداکثر مدت‌زمان اعتبار در سطح شبکهٔ مشترک.
                \(dqmax\-valid\-lifetime\(dq: 8001
            }
        ],

        // نام میزبان سراسری کارگزار که در فیلد \(aqsname\(aq تنظیم می‌شود.
        \(dqserver\-hostname\(dq: \(dq\(dq,

        // پنهان‌سازی گزینه‌های عامل (یا همان RAI) تا پرس‌وجوهای مستقیم
        // از طریق یک بازپخش به نظر برسند.
        \(dqstash\-agent\-options\(dq: false,

        // فهرست زیرشبکه‌های IPv4 که به هیچ شبکهٔ مشترکی تعلق ندارند.
        \(dqsubnet4\(dq: [],

        // مقدار سراسری مدت‌زمان اعتبار.
        \(dqvalid\-lifetime\(dq: 6000,

        // مقدار سراسری حداقل مدت‌زمان اعتبار.
        \(dqmin\-valid\-lifetime\(dq: 4000,

        // مقدار سراسری حداکثر مدت‌زمان اعتبار.
        \(dqmax\-valid\-lifetime\(dq: 8000,

        // رزروها (مثال‌ها در فایل‌های دیگر هستند).
        \(dqreservations\(dq: [],

        // کنترل پیکربندی (در حال حاضر استفاده نمی‌شود، یعنی این نحو
        // از قبل تعریف شده اما ویژگی متناظر آن پیاده‌سازی نشده است).
        \(dqconfig\-control\(dq: {
            // تنها ورودی پایگاه‌های دادهٔ پیکربندی تعریف شده است.
            \(dqconfig\-databases\(dq: [
                {
                    // نام پایگاه‌داده برای اتصال.
                    \(dqname\(dq: \(dqconfig\(dq,

                    // نوع پایگاه‌داده، مثلاً \(dqmysql\(dq، \(dqpostgresql\(dq.
                    \(dqtype\(dq: \(dqmysql\(dq
                }
            ],
            // فاصلهٔ زمانی میان تلاش‌ها برای واکشی به‌روزرسانی‌های پیکربندی
            // از طریق backendهای پیکربندی استفاده‌شده.
            \(dqconfig\-fetch\-wait\-time\(dq: 30
        },

        // برچسب کارگزار.
        \(dqserver\-tag\(dq: \(dqmy DHCPv4 server\(dq,

        // پارامترهای کنترل صف DHCP.
        \(dqdhcp\-queue\-control\(dq: {
            // فعال‌سازی صف الزامی است.
            \(dqenable\-queue\(dq: true,

            // نوع صف الزامی است.
            \(dqqueue\-type\(dq: \(dqkea\-ring4\(dq,

            // گنجایش اختیاری است.
            \(dqcapacity\(dq: 64
        },

        // مشخص می‌کند که آیا کارگزار باید رزروهای سراسری را جستجو کند یا خیر.
        \(dqreservations\-global\(dq: false,

        // مشخص می‌کند که آیا کارگزار باید رزروهای درون زیرشبکه را جستجو کند یا خیر.
        \(dqreservations\-in\-subnet\(dq: true,

        // مشخص می‌کند که آیا کارگزار می‌تواند فرض کند همهٔ نشانی‌های رزروشده
        // خارج از استخر هستند یا خیر.
        // هنگامی که reservations\-in\-subnet برابر با false باشد نادیده گرفته می‌شود.
        // در صورت مشخص شدن، به سطوح \(dqshared\-networks\(dq و
        // \(dqsubnet4\(dq به ارث می‌رسد.
        \(dqreservations\-out\-of\-pool\(dq: false,

        // محاسبهٔ سراسری زمان‌سنج‌های T1 و T2.
        \(dqcalculate\-tee\-times\(dq: true,

        // T1 = valid lifetime * .5.
        \(dqt1\-percent\(dq: .5,

        // T2 = valid lifetime * .75.
        \(dqt2\-percent\(dq: .75,

        // آستانهٔ حافظهٔ پنهان = valid lifetime * .25.
        \(dqcache\-threshold\(dq: .25,

        // حداکثر حافظهٔ پنهان سراسری.
        \(dqcache\-max\-age\(dq: 1000,

        // آستانهٔ زمان اجارهٔ تطبیقی (1.0 غیرفعال است).
        \(dqadaptive\-lease\-time\-threshold\(dq: 0.8,

        // رشته‌ای از صفر یا چند نویسه که هر نویسهٔ نامعتبر
        // در نام میزبان یا Client FQDN با آن جایگزین می‌شود. مقدار پیش‌فرض
        // یک رشتهٔ خالی است که باعث می‌شود نویسه‌های نامعتبر به‌جای
        // جایگزینی، حذف شوند.
        \(dqhostname\-char\-replacement\(dq: \(dqx\(dq,

        // عبارت باقاعده‌ای که مجموعه نویسه‌های نامعتبر در
        // نام میزبان یا Client FQDN را توصیف می‌کند.
        \(dqhostname\-char\-set\(dq: \(dq[^A\-Za\-z0\-9.\-]\(dq,

        // فهرست ثبت‌کننده‌های وقایع که توسط کارگزارهای استفاده‌کننده از این فایل پیکربندی استفاده می‌شوند.
        \(dqloggers\(dq: [
            {
                // سطح اشکال‌زدایی، مقداری بین 0..99. هرچه مقدار بزرگ‌تر باشد،
                // گزارش اشکال‌زدایی دقیق‌تر خواهد بود.
                \(dqdebuglevel\(dq: 99,

                // نام ثبت‌کننده.
                \(dqname\(dq: \(dqkea\-dhcp4\(dq,

                // نحوهٔ خروجی گزارش وقایع را پیکربندی می‌کند.
                \(dqoutput\-options\(dq: [
                    {
                        // تعیین می‌کند که آیا گزارش باید در یک فایل تخلیه شود یا خیر.
                        \(dqflush\(dq: true,

                        // حداکثر اندازهٔ فایل را قبل از چرخش فایل مشخص می‌کند.
                        \(dqmaxsize\(dq: 10240000,

                        // حداکثر تعداد فایل‌های چرخانده‌شده برای نگهداری را مشخص می‌کند.
                        \(dqmaxver\(dq: 1,

                        // مقصد ثبت وقایع را مشخص می‌کند.
                        \(dqoutput\(dq: \(dqstdout\(dq,

                        // محتوای ورودی گزارش را مشخص می‌کند.
                        \(dqpattern\(dq: \(dq%D{%Y\-%m\-%d %H:%M:%S.%q} %\-5p [%c/%i] %m\en\(dq
                    }
                ],

                // شدت ثبت وقایع را مشخص می‌کند، یعنی \(dqERROR\(dq، \(dqWARN\(dq، \(dqINFO\(dq، \(dqDEBUG\(dq.
                \(dqseverity\(dq: \(dqINFO\(dq
            }
        ],

        // اگر بزرگ‌تر از صفر باشد، مدت‌زمان اعتبار اجاره‌هایی است که موقتاً
        // در DISCOVER تخصیص می‌یابند. وقتی صفر باشد (پیش‌فرض)، اجاره‌ها در DISCOVER تخصیص داده نمی‌شوند.
        \(dqoffer\-lifetime\(dq : 60,

        // برای استفاده از بافت‌های کاربر به مثال‌های پیشرفته نگاه کنید.
        \(dquser\-context\(dq: { }
    }
}
.EE
.UNINDENT
.UNINDENT.SS kea4/all\-options.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این فایل پیکربندی نمونه برای کارساز DHCPv4 در Kea شامل موارد زیر است:
//
// \- داده‌ها برای تمام گزینه‌های استاندارد
// \- تعاریف گزینه‌های سفارشی در سطح سراسری به همراه برخی داده‌های گزینه
// مرتبط
// \- داده‌های گزینه سفارشی با فضاهای نام استانداردشده گزینه غیر از \(dqdhcp4\(dq
// \- فضاهای گزینه سفارشی
// \- مثال‌هایی از تعبیه گزینه (option embedding)
//
// به خواننده اکیداً توصیه می‌شود نگاهی به قالب‌های گزینه
// مستندشده در Kea ARM بیندازد:
// https://kea.readthedocs.io/en/latest/arm/dhcp4\-srv.html?highlight=list%20of%20standard%20dhcpv4#id2

{
  \(dqDhcp4\(dq: {
    /*
                      داده‌ها برای تمامی تعاریف گزینه‌های استاندارد
    */
    // داده‌های گزینه که به صورت سراسری تعریف شده‌اند
    \(dqoption\-data\(dq: [
      /*
       Code   Len        Time Offset
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      |  2  |  4  |  n1 |  n2 |  n3 |  n4 |
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      */
      // نوع: int32
      {
        \(dqcode\(dq: 2,
        \(dqdata\(dq: \(dq\-25200\(dq,
        \(dqname\(dq: \(dqtime\-offset\(dq
      },

      /*
       Code   Len         Address 1               Address 2
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      |  3  |  n  |  a1 |  a2 |  a3 |  a4 |  a1 |  a2 |  ...
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      */
      // نوع: آرایه‌ای از {IPv4 address}
      {
        \(dqcode\(dq: 3,
        \(dqdata\(dq: \(dq192.0.2.2, 192.0.2.3\(dq,
        \(dqname\(dq: \(dqrouters\(dq
      },

      /*
       Code   Len         Address 1               Address 2
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      |  4  |  n  |  a1 |  a2 |  a3 |  a4 |  a1 |  a2 |  ...
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      */
      // نوع: آرایه‌ای از {IPv4 address}
      {
        \(dqcode\(dq: 4,
        \(dqdata\(dq: \(dq192.0.2.4, 192.0.2.5\(dq,
        \(dqname\(dq: \(dqtime\-servers\(dq
      },

      /*
       Code   Len         Address 1               Address 2
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      |  5  |  n  |  a1 |  a2 |  a3 |  a4 |  a1 |  a2 |  ...
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      */
      // نوع: آرایه‌ای از {IPv4 address}
      {
        \(dqcode\(dq: 5,
        \(dqdata\(dq: \(dq192.0.2.6, 192.0.2.7\(dq,
        \(dqname\(dq: \(dqname\-servers\(dq
      },

      /*
       Code   Len         Address 1               Address 2
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      |  6  |  n  |  a1 |  a2 |  a3 |  a4 |  a1 |  a2 |  ...
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      */
      // نوع: آرایه‌ای از {IPv4 address}
      {
        \(dqcode\(dq: 6,
        \(dqdata\(dq: \(dq192.0.2.8, 192.0.2.9\(dq,
        \(dqname\(dq: \(dqdomain\-name\-servers\(dq
      },

      /*
       Code   Len         Address 1               Address 2
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      |  7  |  n  |  a1 |  a2 |  a3 |  a4 |  a1 |  a2 |  ...
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      */
      // نوع: آرایه‌ای از {IPv4 address}
      {
        \(dqcode\(dq: 7,
        \(dqdata\(dq: \(dq192.0.2.10, 192.0.2.11\(dq,
        \(dqname\(dq: \(dqlog\-servers\(dq
      },

      /*
       Code   Len         Address 1               Address 2
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      |  8  |  n  |  a1 |  a2 |  a3 |  a4 |  a1 |  a2 |  ...
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      */
      // نوع: آرایه‌ای از {IPv4 address}
      {
        \(dqcode\(dq: 8,
        \(dqdata\(dq: \(dq192.0.2.12, 192.0.2.13\(dq,
        \(dqname\(dq: \(dqcookie\-servers\(dq
      },

      /*
       Code   Len         Address 1               Address 2
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      |  9  |  n  |  a1 |  a2 |  a3 |  a4 |  a1 |  a2 |  ...
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      */
      // نوع: آرایه‌ای از {IPv4 address}
      {
        \(dqcode\(dq: 9,
        \(dqdata\(dq: \(dq192.0.2.14, 192.0.2.15\(dq,
        \(dqname\(dq: \(dqlpr\-servers\(dq
      },

      /*
       Code   Len         Address 1               Address 2
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      |  10 |  n  |  a1 |  a2 |  a3 |  a4 |  a1 |  a2 |  ...
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      */
      // نوع: آرایه‌ای از {IPv4 address}
      {
        \(dqcode\(dq: 10,
        \(dqdata\(dq: \(dq192.0.2.16, 192.0.2.17\(dq,
        \(dqname\(dq: \(dqimpress\-servers\(dq
      },

      /*
       Code   Len         Address 1               Address 2
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      |  11 |  n  |  a1 |  a2 |  a3 |  a4 |  a1 |  a2 |  ...
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      */
      // نوع: آرایه‌ای از {IPv4 address}
      {
        \(dqcode\(dq: 11,
        \(dqdata\(dq: \(dq192.0.2.18, 192.0.2.19\(dq,
        \(dqname\(dq: \(dqresource\-location\-servers\(dq
      },

      /*
       Code   Len   File Size
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      |  13 |  2  |  l1 |  l2 |
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      */
      // نوع: uint16
      {
        \(dqcode\(dq: 13,
        \(dqdata\(dq: \(dq1024\(dq,
        \(dqname\(dq: \(dqboot\-size\(dq
      },

      /*
       Code   Len      Dump File Pathname
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-
      |  14 |  n  |  n1 |  n2 |  n3 |  n4 | ...
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-
      */
      // نوع: string
      {
        \(dqcode\(dq: 14,
        \(dqdata\(dq: \(dq/etc/crash\-dump.img\(dq,
        \(dqname\(dq: \(dqmerit\-dump\(dq
      },

      /*
       Code   Len        Domain Name
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      |  15 |  n  |  d1 |  d2 |  d3 |  d4 |  ...
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      */
      // نوع: FQDN
      {
        \(dqcode\(dq: 15,
        \(dqdata\(dq: \(dqmy.example.org\(dq,
        \(dqname\(dq: \(dqdomain\-name\(dq
      },

      /*
       Code   Len    Swap Server Address
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      |  16 |  n  |  a1 |  a2 |  a3 |  a4 |
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      */
      // نوع: IPv4 address
      {
        \(dqcode\(dq: 16,
        \(dqdata\(dq: \(dq192.0.2.20\(dq,
        \(dqname\(dq: \(dqswap\-server\(dq
      },

      /*
       Code   Len      Root Disk Pathname
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-
      |  17 |  n  |  n1 |  n2 |  n3 |  n4 | ...
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-
      */
      // نوع: string
      {
        \(dqcode\(dq: 17,
        \(dqdata\(dq: \(dq/path/to/root\(dq,
        \(dqname\(dq: \(dqroot\-path\(dq
      },

      /*
       Code   Len      Extensions Pathname
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-
      |  18 |  n  |  n1 |  n2 |  n3 |  n4 | ...
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-
      */
      // نوع: string
      {
        \(dqcode\(dq: 18,
        \(dqdata\(dq: \(dq/path/to/extensions\(dq,
        \(dqname\(dq: \(dqextensions\-path\(dq
      },

      /*
       Code   Len  Value
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      |  19 |  1  | 0/1 |
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      */
      // نوع: boolean
      {
        \(dqcode\(dq: 19,
        \(dqdata\(dq: \(dqtrue\(dq,
        \(dqname\(dq: \(dqip\-forwarding\(dq
      },

      /*
       Code   Len  Value
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      |  20 |  1  | 0/1 |
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      */
      // نوع: boolean
      {
        \(dqcode\(dq: 20,
        \(dqdata\(dq: \(dqtrue\(dq,
        \(dqname\(dq: \(dqnon\-local\-source\-routing\(dq
      },

      /*
       Code   Len         Address 1                  Mask 1
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      |  21 |  n  |  a1 |  a2 |  a3 |  a4 |  m1 |  m2 |  m3 |  m4 |
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
              Address 2                  Mask 2
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-
      |  a1 |  a2 |  a3 |  a4 |  m1 |  m2 |  m3 |  m4 | ...
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-
      */
      // نوع: آرایه‌ای از {IPv4 address}
      {
        \(dqcode\(dq: 21,
        \(dqdata\(dq: \(dq10.229.0.128, 255.255.255.128, 10.27.129.0, 255.255.255.0\(dq,
        \(dqname\(dq: \(dqpolicy\-filter\(dq
      },

      /*
       Code   Len      Size
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      |  22 |  2  |  s1 |  s2 |
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      */
      // نوع: uint16
      {
        \(dqcode\(dq: 22,
        \(dqdata\(dq: \(dq2048\(dq,
        \(dqname\(dq: \(dqmax\-dgram\-reassembly\(dq
      },

      /*
       Code   Len   TTL
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      |  23 |  1  | ttl |
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      */
      // نوع: uint8
      {
        \(dqcode\(dq: 23,
        \(dqdata\(dq: \(dq248\(dq,
        \(dqname\(dq: \(dqdefault\-ip\-ttl\(dq
      },

      /*
       Code   Len           Timeout
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      |  24 |  4  |  t1 |  t2 |  t3 |  t4 |
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      */
      // نوع: uint32
      {
        \(dqcode\(dq: 24,
        \(dqdata\(dq: \(dq131072\(dq,
        \(dqname\(dq: \(dqpath\-mtu\-aging\-timeout\(dq
      },

      /*
       Code   Len     Size 1      Size 2
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-
      |  25 |  n  |  s1 |  s2 |  s1 |  s2 | ...
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-
      */
      // نوع: آرایه‌ای از {uint16}
      {
        \(dqcode\(dq: 25,
        \(dqdata\(dq: \(dq3072, 4096\(dq,
        \(dqname\(dq: \(dqpath\-mtu\-plateau\-table\(dq
      },

      /*
       Code   Len      MTU
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      |  26 |  2  |  m1 |  m2 |
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      */
      // نوع: uint16
      {
        \(dqcode\(dq: 26,
        \(dqdata\(dq: \(dq5120\(dq,
        \(dqname\(dq: \(dqinterface\-mtu\(dq
      },

      /*
       Code   Len  Value
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      |  27 |  1  | 0/1 |
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      */
      // نوع: boolean
      {
        \(dqcode\(dq: 27,
        \(dqdata\(dq: \(dqtrue\(dq,
        \(dqname\(dq: \(dqall\-subnets\-local\(dq
      },

      /*
       Code   Len     Broadcast Address
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      |  28 |  4  |  b1 |  b2 |  b3 |  b4 |
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      */
      // نوع: IPv4 address
      {
        \(dqcode\(dq: 28,
        \(dqdata\(dq: \(dq192.0.2.255\(dq,
        \(dqname\(dq: \(dqbroadcast\-address\(dq
      },

      /*
       Code   Len  Value
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      |  29 |  1  | 0/1 |
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      */
      // نوع: boolean
      {
        \(dqcode\(dq: 29,
        \(dqdata\(dq: \(dqtrue\(dq,
        \(dqname\(dq: \(dqperform\-mask\-discovery\(dq
      },

      /*
       Code   Len  Value
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      |  30 |  1  | 0/1 |
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      */
      // نوع: boolean
      {
        \(dqcode\(dq: 30,
        \(dqdata\(dq: \(dqtrue\(dq,
        \(dqname\(dq: \(dqmask\-supplier\(dq
      },

      /*
       Code   Len  Value
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      |  31 |  1  | 0/1 |
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      */
      // نوع: boolean
      {
        \(dqcode\(dq: 31,
        \(dqdata\(dq: \(dqtrue\(dq,
        \(dqname\(dq: \(dqrouter\-discovery\(dq
      },

      /*
       Code   Len            Address
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      |  32 |  4  |  a1 |  a2 |  a3 |  a4 |
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      */
      // نوع: IPv4 address
      {
        \(dqcode\(dq: 32,
        \(dqdata\(dq: \(dq192.0.2.23\(dq,
        \(dqname\(dq: \(dqrouter\-solicitation\-address\(dq
      },

      /*
       Code   Len         Destination 1           Router 1
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      |  33 |  n  |  d1 |  d2 |  d3 |  d4 |  r1 |  r2 |  r3 |  r4 |
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
              Destination 2           Router 2
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-
      |  d1 |  d2 |  d3 |  d4 |  r1 |  r2 |  r3 |  r4 | ...
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-
      */
      // نوع: آرایه‌ای از {IPv4 address}
      {
        \(dqcode\(dq: 33,
        \(dqdata\(dq: \(dq192.0.2.24, 192.0.2.25\(dq,
        \(dqname\(dq: \(dqstatic\-routes\(dq
      },

      /*
       Code   Len  Value
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      |  34 |  1  | 0/1 |
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      */
      // نوع: boolean
      {
        \(dqcode\(dq: 34,
        \(dqdata\(dq: \(dqtrue\(dq,
        \(dqname\(dq: \(dqtrailer\-encapsulation\(dq
      },

      /*
       Code   Len           Time
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      |  35 |  4  |  t1 |  t2 |  t3 |  t4 |
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      */
      // نوع: uint32
      {
        \(dqcode\(dq: 35,
        \(dqdata\(dq: \(dq196608\(dq,
        \(dqname\(dq: \(dqarp\-cache\-timeout\(dq
      },

      /*
       Code   Len  Value
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      |  36 |  1  | 0/1 |
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      */
      // نوع: boolean
      {
        \(dqcode\(dq: 36,
        \(dqdata\(dq: \(dqtrue\(dq,
        \(dqname\(dq: \(dqieee802\-3\-encapsulation\(dq
      },

      /*
       Code   Len   TTL
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      |  37 |  1  |  n  |
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      */
      // نوع: uint8
      {
        \(dqcode\(dq: 37,
        \(dqdata\(dq: \(dq124\(dq,
        \(dqname\(dq: \(dqdefault\-tcp\-ttl\(dq
      },

      /*
       Code   Len           Time
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      |  38 |  4  |  t1 |  t2 |  t3 |  t4 |
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      */
      // نوع: uint32
      {
        \(dqcode\(dq: 38,
        \(dqdata\(dq: \(dq262144\(dq,
        \(dqname\(dq: \(dqtcp\-keepalive\-interval\(dq
      },

      /*
       Code   Len  Value
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      |  39 |  1  | 0/1 |
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      */
      // نوع: boolean
      {
        \(dqcode\(dq: 39,
        \(dqdata\(dq: \(dqtrue\(dq,
        \(dqname\(dq: \(dqtcp\-keepalive\-garbage\(dq
      },

      /*
       Code   Len      NIS Domain Name
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-
      |  40 |  n  |  n1 |  n2 |  n3 |  n4 | ...
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-
      */
      // نوع: string
      {
        \(dqcode\(dq: 40,
        \(dqdata\(dq: \(dqnis.example.org\(dq,
        \(dqname\(dq: \(dqnis\-domain\(dq
      },

      /*
       Code   Len         Address 1               Address 2
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      |  41 |  n  |  a1 |  a2 |  a3 |  a4 |  a1 |  a2 |  ...
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      */
      // نوع: آرایه‌ای از {IPv4 address}
      {
        \(dqcode\(dq: 41,
        \(dqdata\(dq: \(dq192.0.2.26, 192.0.2.27\(dq,
        \(dqname\(dq: \(dqnis\-servers\(dq
      },

      /*
       Code   Len         Address 1               Address 2
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      |  42 |  n  |  a1 |  a2 |  a3 |  a4 |  a1 |  a2 |  ...
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      */
      // نوع: آرایه‌ای از {IPv4 address}
      {
        \(dqcode\(dq: 42,
        \(dqdata\(dq: \(dq192.0.2.28, 192.0.2.29\(dq,
        \(dqname\(dq: \(dqntp\-servers\(dq
      },

      /*
       Code   Len   Vendor\-specific information
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-
      |  43 |  n  |  i1 |  i2 | ...
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-

       Code   Len   Data item        Code   Len   Data item       Code
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      |  T1 |  n  |  d1 |  d2 | ... |  T2 |  n  |  D1 |  D2 | ... | ... |
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      */
      // نوع: empty
      {
        \(dqcode\(dq: 43,
        \(dqname\(dq: \(dqvendor\-encapsulated\-options\(dq
      },

      /*
       Code   Len           Address 1              Address 2
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-
      |  44 |  n  |  a1 |  a2 |  a3 |  a4 |  b1 |  b2 |  b3 |  b4 | ...
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-
      */
      // نوع: آرایه‌ای از {IPv4 address}
      {
        \(dqcode\(dq: 44,
        \(dqdata\(dq: \(dq192.0.2.30, 192.0.2.31\(dq,
        \(dqname\(dq: \(dqnetbios\-name\-servers\(dq
      },

      /*
       Code   Len           Address 1              Address 2
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-
      |  45 |  n  |  a1 |  a2 |  a3 |  a4 |  b1 |  b2 |  b3 |  b4 | ...
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-
      */
      // نوع: آرایه‌ای از {IPv4 address}
      {
        \(dqcode\(dq: 45,
        \(dqdata\(dq: \(dq192.0.2.32, 192.0.2.33\(dq,
        \(dqname\(dq: \(dqnetbios\-dd\-server\(dq
      },

      /*
      Value         Node Type
      \-\-\-\-\-         \-\-\-\-\-\-\-\-\-
      0x1           B\-node
      0x2           P\-node
      0x4           M\-node
      0x8           H\-node

       Code   Len  Node Type
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-+
      |  46 |  1  | see above |
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-+
      */
      // نوع: uint8
      {
        \(dqcode\(dq: 46,
        \(dqdata\(dq: \(dq0x1\(dq,
        \(dqname\(dq: \(dqnetbios\-node\-type\(dq
      },

      /*
       Code   Len       NetBIOS Scope
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-
      |  47 |  n  |  s1 |  s2 |  s3 |  s4 | ...
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-
      */
      // نوع: string
      {
        \(dqcode\(dq: 47,
        \(dqdata\(dq: \(dqscope42\(dq,
        \(dqname\(dq: \(dqnetbios\-scope\(dq
      },

      /*
       Code   Len         Address 1               Address 2
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-
      |  48 |  n  |  a1 |  a2 |  a3 |  a4 |  a1 |  a2 |   ...
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-
      */
      // نوع: آرایه‌ای از {IPv4 address}
      {
        \(dqcode\(dq: 48,
        \(dqdata\(dq: \(dq192.0.2.34, 192.0.2.35\(dq,
        \(dqname\(dq: \(dqfont\-servers\(dq
      },

      /*
       Code   Len         Address 1               Address 2
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-
      |  49 |  n  |  a1 |  a2 |  a3 |  a4 |  a1 |  a2 |   ...
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-
      */
      // نوع: آرایه‌ای از {IPv4 address}
      {
        \(dqcode\(dq: 49,
        \(dqdata\(dq: \(dq192.0.2.36, 192.0.2.37\(dq,
        \(dqname\(dq: \(dqx\-display\-manager\(dq
      },

      /*
      مقدار   مفهوم
      \-\-\-\-\-   \-\-\-\-\-\-\-\-
        1     فیلد \(aqfile\(aq برای نگهداری گزینه‌ها استفاده می‌شود
        2     فیلد \(aqsname\(aq برای نگهداری گزینه‌ها استفاده می‌شود
        3     هر دو فیلد برای نگهداری گزینه‌ها استفاده می‌شوند

       Code   Len  Value
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      |  52 |  1  |1/2/3|
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      */
      // نوع: uint8
      {
        \(dqcode\(dq: 52,
        \(dqdata\(dq: \(dq3\(dq,
        \(dqname\(dq: \(dqdhcp\-option\-overload\(dq
      },

      /*
       Code   Len            Address
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      |  54 |  4  |  a1 |  a2 |  a3 |  a4 |
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      */
      // نوع: IPv4 address
      {
        \(dqcode\(dq: 54,
        \(dqdata\(dq: \(dq192.0.2.39\(dq,
        \(dqname\(dq: \(dqdhcp\-server\-identifier\(dq
      },

      /*
       Code   Len     Text
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-
      |  56 |  n  |  c1 |  c2 | ...
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-
      */
      // نوع: string
      {
        \(dqcode\(dq: 56,
        \(dqdata\(dq: \(dqError: here is a DHCPNAK!\(dq,
        \(dqname\(dq: \(dqdhcp\-message\(dq
      },

      /*
       Code   Len     Length
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      |  57 |  2  |  l1 |  l2 |
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      */
      // نوع: uint16
      {
        \(dqcode\(dq: 57,
        \(dqdata\(dq: \(dq1536\(dq,
        \(dqname\(dq: \(dqdhcp\-max\-message\-size\(dq
      },

      /*
       Code   Len   Vendor class Identifier
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-
      |  60 |  n  |  i1 |  i2 | ...
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-
      */
      // نوع: string
      {
        \(dqcode\(dq: 60,
        \(dqdata\(dq: \(dqISC\(dq,
        \(dqname\(dq: \(dqvendor\-class\-identifier\(dq
      },

      /*
       Code  Len    NetWare/IP Domain Name
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-\-+\-\-\-\-\-\-+\-\-\-\-\-\-+\-\-\-\-\-
      |  62 |  n  |  c1  |  c2  |  c3  |  ...
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-\-+\-\-\-\-\-\-+\-\-\-\-\-\-+\-\-\-\-\-
      */
      // نوع: string
      {
        \(dqcode\(dq: 62,
        \(dqdata\(dq: \(dqnwip.example.org\(dq,
        \(dqname\(dq: \(dqnwip\-domain\-name\(dq
      },

      /*
       Code   Len  NetWare/IP General Info
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-+\-\-\-\-+
      | 63  | 11  | 2  |  0 |
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-+\-\-\-\-+
                   NWIP_EXIST_IN_OPTIONS_AREA (length 0)

                  +\-\-\-\-+\-\-\-\-+\-\-\-\-+
                  |  5 |  1 |  1 |
                  +\-\-\-\-+\-\-\-\-+\-\-\-\-+
                   NSQ_BROADCAST_SERVER (length 1)
                   value is YES

                  +\-\-\-\-+\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-+
                  |  7 |  4 | IP address |
                  +\-\-\-\-+\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-+
                   NEAREST_NWIP_SERVER (length 4)
                   value is IP address of server
      */
      // نوع: binary
      {
        \(dqcode\(dq: 63,
        \(dqdata\(dq: \(dq1A BB AD AB BA D0 00 00 00 00 00 00 00 00 CA FE\(dq,
        \(dqname\(dq: \(dqnwip\-suboptions\(dq
      },

      /*
       Code   Len      NIS Client Domain Name
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-
      |  64 |  n  |  n1 |  n2 |  n3 |  n4 | ...
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-
      */
      // نوع: string
      {
        \(dqcode\(dq: 64,
        \(dqdata\(dq: \(dqnisplus.example.org\(dq,
        \(dqname\(dq: \(dqnisplus\-domain\-name\(dq
      },

      /*
       Code   Len         Address 1               Address 2
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      |  65 |  n  |  a1 |  a2 |  a3 |  a4 |  a1 |  a2 |  ...
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      */
      // نوع: IPv4 address
      {
        \(dqcode\(dq: 65,
        \(dqdata\(dq: \(dq192.0.2.40\(dq,
        \(dqname\(dq: \(dqnisplus\-servers\(dq
      },

      /*
       Code  Len   TFTP server
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-
      | 66  |  n  |  c1 |  c2 |  c3 | ...
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-
      */
      // نوع: string
      {
        \(dqcode\(dq: 66,
        \(dqdata\(dq: \(dqtftp.example.org\(dq,
        \(dqname\(dq: \(dqtftp\-server\-name\(dq
      },

      /*
       Code  Len   Bootfile name
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-
      | 67  |  n  |  c1 |  c2 |  c3 | ...
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-
      */
      // نوع: string
      {
        \(dqcode\(dq: 67,
        \(dqdata\(dq: \(dqboot\-file.img\(dq,
        \(dqname\(dq: \(dqboot\-file\-name\(dq
      },

      /*
       Code Len    Home Agent Addresses (zero or more)
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      | 68  |  n  | a1  | a2  | a3  | a4  | ...
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      */
      // نوع: آرایه‌ای از {IPv4 address}
      {
        \(dqcode\(dq: 68,
        \(dqdata\(dq: \(dq192.0.2.41, 192.0.2.42\(dq,
        \(dqname\(dq: \(dqmobile\-ip\-home\-agent\(dq
      },

      /*
       Code   Len         Address 1               Address 2
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      | 69  |  n  |  a1 |  a2 |  a3 |  a4 |  a1 |  a2 |  ...
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      */
      // نوع: آرایه‌ای از {IPv4 address}
      {
        \(dqcode\(dq: 69,
        \(dqdata\(dq: \(dq192.0.2.43, 192.0.2.44\(dq,
        \(dqname\(dq: \(dqsmtp\-server\(dq
      },

      /*
       Code   Len         Address 1               Address 2
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      | 70  |  n  |  a1 |  a2 |  a3 |  a4 |  a1 |  a2 |  ...
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      */
      // نوع: آرایه‌ای از {IPv4 address}
      {
        \(dqcode\(dq: 70,
        \(dqdata\(dq: \(dq192.0.2.45, 192.0.2.46\(dq,
        \(dqname\(dq: \(dqpop\-server\(dq
      },

      /*
       Code   Len         Address 1               Address 2
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      | 71  |  n  |  a1 |  a2 |  a3 |  a4 |  a1 |  a2 |  ...
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      */
      // نوع: آرایه‌ای از {IPv4 address}
      {
        \(dqcode\(dq: 71,
        \(dqdata\(dq: \(dq192.0.2.47, 192.0.2.48\(dq,
        \(dqname\(dq: \(dqnntp\-server\(dq
      },

      /*
       Code   Len         Address 1               Address 2
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      | 72  |  n  |  a1 |  a2 |  a3 |  a4 |  a1 |  a2 |  ...
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      */
      // نوع: آرایه‌ای از {IPv4 address}
      {
        \(dqcode\(dq: 72,
        \(dqdata\(dq: \(dq192.0.2.49, 192.0.2.50\(dq,
        \(dqname\(dq: \(dqwww\-server\(dq
      },

      /*
       Code   Len         Address 1               Address 2
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      | 73  |  n  |  a1 |  a2 |  a3 |  a4 |  a1 |  a2 |  ...
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      */
      // نوع: آرایه‌ای از {IPv4 address}
      {
        \(dqcode\(dq: 73,
        \(dqdata\(dq: \(dq192.0.2.51, 192.0.2.52\(dq,
        \(dqname\(dq: \(dqfinger\-server\(dq
      },

      /*
       Code   Len         Address 1               Address 2
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      | 74  |  n  |  a1 |  a2 |  a3 |  a4 |  a1 |  a2 |  ...
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      */
      // نوع: آرایه‌ای از {IPv4 address}
      {
        \(dqcode\(dq: 74,
        \(dqdata\(dq: \(dq192.0.2.53, 192.0.2.54\(dq,
        \(dqname\(dq: \(dqirc\-server\(dq
      },

      /*
       Code   Len         Address 1               Address 2
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      | 75  |  n  |  a1 |  a2 |  a3 |  a4 |  a1 |  a2 |  ...
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      */
      // نوع: آرایه‌ای از {IPv4 address}
      {
        \(dqcode\(dq: 75,
        \(dqdata\(dq: \(dq192.0.2.55, 192.0.2.56\(dq,
        \(dqname\(dq: \(dqstreettalk\-server\(dq
      },

      /*
       Code   Len         Address 1               Address 2
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      | 76  |  n  |  a1 |  a2 |  a3 |  a4 |  a1 |  a2 |  ...
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      */
      // نوع: آرایه‌ای از {IPv4 address}
      {
        \(dqcode\(dq: 76,
        \(dqdata\(dq: \(dq192.0.2.57, 192.0.2.58\(dq,
        \(dqname\(dq: \(dqstreettalk\-directory\-assistance\-server\(dq
      },

      /*
       Code   Len   Value
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-  . . .  \-\-+
      | 77  |  N  | User Class Data (\(aqLen\(aq octets) |
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-  . . .  \-\-+
      */
      // نوع: binary
      {
        \(dqcode\(dq: 77,
        \(dqdata\(dq: \(dq1A BB AD AB BA D0 00 00 00 00 00 00 00 00 CA FE\(dq,
        \(dqname\(dq: \(dquser\-class\(dq
      },

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |   Code = 78   |    Length     |   Mandatory   |      a1       |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |      a2       |       a3      |       a4      |      ...
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      */
      // نوع: boolean، آرایه‌ای از {IPv4 address}
      {
        \(dqcode\(dq: 78,
        \(dqdata\(dq: \(dqtrue, 192.0.2.59, 192.0.2.60\(dq,
        \(dqname\(dq: \(dqslp\-directory\-agent\(dq
      },

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |   Code = 79   |     Length    |   Mandatory   | <Scope List>...
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      */
      // نوع: boolean، string
      {
        \(dqcode\(dq: 79,
        \(dqdata\(dq: \(dqtrue, slp\-scope\(dq,
        \(dqname\(dq: \(dqslp\-service\-scope\(dq
      },

      // کد گزینه 80 در Kea تعریف نشده است.
      // کد گزینه 83 در Kea تعریف نشده است.
      // کد گزینه 84 تخصیص نیافته است.

      /*
       Code   Len        Address 1               Address 2
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      | 85  |  n  |  a1 |  a2 | a3  |  a4 |  a1 |  a2 |  a3 |  a4 |  ...
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      */
      // نوع: آرایه‌ای از {IPv4 address}
      {
        \(dqcode\(dq: 85,
        \(dqdata\(dq: \(dq192.0.2.61, 192.0.2.62\(dq,
        \(dqname\(dq: \(dqnds\-servers\(dq
      },

      /*
       Code Len  NDS Tree Name
      +\-\-\-\-+\-\-\-\-+\-\-\-\-+\-\-\-\-+\-\-\-\-+\-\-\-\-+\-\-
      | 86 | n  | c1 | c2 | c3 | c4 |  ...
      +\-\-\-\-+\-\-\-\-+\-\-\-\-+\-\-\-\-+\-\-\-\-+\-\-\-\-+\-\-
      */
      // نوع: string
      {
        \(dqcode\(dq: 86,
        \(dqdata\(dq: \(dqmy\-tree\(dq,
        \(dqname\(dq: \(dqnds\-tree\-name\(dq
      },

      /*
       Code Len  Initial NDS Context
      +\-\-\-\-+\-\-\-\-+\-\-\-\-+\-\-\-\-+\-\-\-\-+\-\-\-\-+\-\-
      | 87 | n  | c1 | c2 | c3 | c4 |  ...
      +\-\-\-\-+\-\-\-\-+\-\-\-\-+\-\-\-\-+\-\-\-\-+\-\-\-\-+\-\-
      */
      // نوع: string
      {
        \(dqcode\(dq: 87,
        \(dqdata\(dq: \(dqcontext\(dq,
        \(dqname\(dq: \(dqnds\-context\(dq
      },

      /*
       Code   Len  FQDN(s) of BCMCS Controller
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      | 88  |  n  |  s1 |  s2 |  s3 |  s4 | s5  |  ...
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      */
      // نوع: FQDN
      {
        \(dqcode\(dq: 88,
        \(dqdata\(dq: \(dqbcms\-controller.example.org\(dq,
        \(dqname\(dq: \(dqbcms\-controller\-names\(dq
      },

      /*
       Code   Len  Address 1               Address 2
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      | 89  |  n  | a1  | a2  | a3  | a4  | a1  |  ...
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-
      */
      // نوع: آرایه‌ای از {IPv4 address}
      {
        \(dqcode\(dq: 89,
        \(dqdata\(dq: \(dq192.0.2.63\(dq,
        \(dqname\(dq: \(dqbcms\-controller\-address\(dq
      },

      /*
       Code  Len  16\-bit Type
      +\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      | 93 |  n  | n1  | n2  |
      +\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      */
      // نوع: آرایه‌ای از uint16
      {
        \(dqcode\(dq: 93,
        \(dqdata\(dq: \(dq6144, 7168\(dq,
        \(dqname\(dq: \(dqclient\-system\(dq
      },

      /*
       Code  Len  Type Major Minor
      +\-\-\-\-+\-\-\-\-\-+\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      | 94 |  3  |  t |  M  |  m  |
      +\-\-\-\-+\-\-\-\-\-+\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      */
      // نوع: uint8، uint8، uint8
      {
        \(dqcode\(dq: 94,
        \(dqdata\(dq: \(dq0, 1, 0\(dq,
        \(dqname\(dq: \(dqclient\-ndi\(dq
      },

      // کد گزینه 95 پشتیبانی نمی‌شود.
      // کد گزینه 96 تخصیص نیافته است.

      /*
       Code  Len  Type  Machine Identifier
      +\-\-\-\-+\-\-\-\-\-+\-\-\-\-+\-\-\-\-\-+ . . . +\-\-\-\-\-+
      | 97 |  n  |  t |     | . . . |     |
      +\-\-\-\-+\-\-\-\-\-+\-\-\-\-+\-\-\-\-\-+ . . . +\-\-\-\-\-+
      */
      // نوع: uint8، binary
      {
        \(dqcode\(dq: 97,
        \(dqdata\(dq: \(dq0, 1A BB AD AB BA D0 00 00 00 00 00 00 00 00 CA FE\(dq,
        \(dqname\(dq: \(dquuid\-guid\(dq
      },

      /*
      0                   1                   2                   3
      0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |     Code      |    Length     |   URL list
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

         Code            98

         Length          طول فیلد داده (یعنی فهرست URL) بر حسب
                         بایت.

         URL list        فهرستی از یک یا چند URL که با نویسه فاصله
                         اسکی (0x20) از هم جدا شده‌اند.
      */
      // نوع: string
      {
        \(dqcode\(dq: 98,
        \(dqdata\(dq: \(dquap1.example.org uap2.example.org\(dq,
        \(dqname\(dq: \(dquap\-servers\(dq
      },

      /*
      0                   1                   2                   3
      0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      | GEOCONF_CIVIC |       N       |      what     |    country    |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |    code       |        civic address elements                ...
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      Code GEOCONF_CIVIC:  کد این گزینه DHCP برابر 99 است.

      N:  طول این گزینه متغیر است. حداقل طول 3
         بایت است.

      what:  عنصر \(aqwhat\(aq توصیف می‌کند که مدخل DHCP به کدام مکان
         اشاره دارد. در حال حاضر، سه حالت تعریف شده است: مکان
         کارساز DHCP (مقدار 0)، مکان عنصر شبکه‌ای که تصور
         می‌شود نزدیک‌ترین به کلاینت باشد (مقدار 1)، یا مکان
         کلاینت (مقدار 2). گزینه (2) باید (SHOULD) استفاده شود،
         اما ممکن است مشخص نباشد. گزینه‌های (0) و (1) نباید (SHOULD NOT)
         استفاده شوند مگر اینکه مشخص باشد کلاینت DHCP در مجاورت فیزیکی
         نزدیک به کارساز یا عنصر شبکه قرار دارد.

      country code:  کد کشور دو حرفی ISO 3166 با حروف بزرگ
         ASCII، مانند DE یا US. (آدرس‌های مدنی همیشه شامل تعیین
         کشور هستند، که پیشنهاددهنده استفاده از یک فیلد با قالب ثابت
         برای صرفه‌جویی در فضا است.)

      civic address elements:  صفر یا تعداد بیشتری عنصر شامل آدرس
         مدنی و/یا پستی، با قالبی که در زیر شرح داده شده است
         (بخش 3.3).
      */
      // نوع: binary
      {
        \(dqcode\(dq: 99,
        \(dqdata\(dq: \(dq1A BB AD AB BA D0 00 00 00 00 00 00 00 00 CA FE\(dq,
        \(dqname\(dq: \(dqgeoconf\-civic\(dq
      },

      /*
       PCode  Len   TZ\-POSIX String
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
      | 100 |  N  | IEEE 1003.1 String           |
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
      */
      // نوع: string
      {
        \(dqcode\(dq: 100,
        // در گزینه‌های رشته‌ای که در مقادیر خود ویرگول دارند، باید
        // آن را با نویسه گریز مشخص کرد (یعنی قبل از هر ویرگول دو بک‌اسلش قرار گیرد).
        // دلیل آن این است که ویرگول‌ها برای جداسازی فیلدها در گزینه‌های
        // مرکب رزرو شده‌اند. در عین حال، باید با مشخصات JSON که
        // اجازه \(dq\e,\(dq را نمی‌دهد، سازگار باشیم. بنابراین، نمادگذاری
        // کمی نامعمول دو بک‌اسلش مورد نیاز است.
        // مقداری که روی شبکه ارسال می‌شود:
        // EST5EDT4,M3.2.0/02:00,M11.1.0/02:00
        \(dqdata\(dq: \(dqEST5EDT4\e\e,M3.2.0/02:00\e\e,M11.1.0/02:00\(dq,
        \(dqname\(dq: \(dqpcode\(dq
      },

      /*
       TCode  Len   TZ\-Database String
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
      | 101 |  N  | Reference to the TZ Database |
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
      */
      // نوع: string
      {
        \(dqcode\(dq: 101,
        \(dqdata\(dq: \(dqEurope/Zurich\(dq,
        \(dqname\(dq: \(dqtcode\(dq
      },

      // کدهای گزینه 102\-107 تخصیص نیافته‌اند.

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |     Code      |   Length      |           Value               |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |         Value (cont.)         |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      Code:  شناسه ۸ بیتی کد گزینه IPv6\-Only Preferred به صورتی که
         توسط IANA تخصیص داده شده است: 108. کلاینت این کد را در
         فهرست Parameter Request در پیام‌های DHCPDISCOVER و DHCPREQUEST طبق
         توضیحات بخش 3.2 قرار می‌دهد.

      Length:  عدد صحیح بدون علامت ۸ بیتی. طول گزینه، بدون در نظر گرفتن
         فیلدهای Code و Length. کارساز باید (MUST) فیلد طول را برابر
         4 قرار دهد. کلاینت اگر مقدار فیلد طول برابر 4 نباشد، باید (MUST)
         گزینه IPv6\-Only Preferred را نادیده بگیرد.

      Value:  عدد صحیح بدون علامت ۳۲ بیتی. تعداد ثانیه‌هایی که کلاینت باید
         DHCPv4 را غیرفعال کند (متغیر پیکربندی V6ONLY_WAIT).
         اگر استخر کارساز صراحتاً با یک تایمر V6ONLY_WAIT پیکربندی شده باشد،
         کارساز باید فیلد را روی آن مقدار پیکربندی‌شده تنظیم کند. در غیر این صورت،
         کارساز باید آن را صفر قرار دهد. کلاینت باید این فیلد را طبق
         توضیحات بخش 3.2 پردازش کند.
      */
      // نوع: uint32
      {
        \(dqcode\(dq: 108,
        \(dqdata\(dq: \(dq3600\(dq,
        \(dqname\(dq: \(dqv6\-only\-preferred\(dq
      },

      // کدهای گزینه 109\-111 تخصیص نیافته‌اند.

      // نوع: آرایه‌ای از {IPv4 address}
      {
        \(dqcode\(dq: 112,
        \(dqdata\(dq: \(dq192.0.2.63, 192.0.2.64\(dq,
        \(dqname\(dq: \(dqnetinfo\-server\-address\(dq
      },

      // نوع: string
      {
        \(dqcode\(dq: 113,
        \(dqdata\(dq: \(dqserver1\(dq,
        \(dqname\(dq: \(dqnetinfo\-server\-tag\(dq
      },

      // نوع: string
      {
        \(dqcode\(dq: 114,
        \(dqdata\(dq: \(dqhttps://default.example.org\(dq,
        \(dqname\(dq: \(dqv4\-captive\-portal\(dq
      },

      // کد گزینه 115 تخصیص نیافته است.

      /*
       Code   Len   Value
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      | 116 |  1  |  a  |
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      */
      // نوع: uint8
      {
        \(dqcode\(dq: 116,
        \(dqdata\(dq: \(dq1\(dq,
        \(dqname\(dq: \(dqauto\-config\(dq
      },

      /*
           Code            Length      Name Service Search Order in Sequence
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |     117       |     Len       |             ns1               |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |             ns2               |             ...               |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      */
      // نوع: آرایه‌ای از {uint16}
      {
        \(dqcode\(dq: 117,
        \(dqdata\(dq: \(dq6, 41, 44, 65\(dq,
        \(dqname\(dq: \(dqname\-service\-search\(dq
      },

      /*
       Code   Len        IPv4 Address
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      | 118 |  4  | A1  | A2  | A3  | A4  |
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+
      */
      // نوع: IPv4 address
      {
        \(dqcode\(dq: 118,
        \(dqdata\(dq: \(dq192.0.2.65\(dq,
        \(dqname\(dq: \(dqsubnet\-selection\(dq
      },

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |     119       |     Len       |         Searchstring...
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                     Searchstring...
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      */
      // نوع: آرایه‌ای از {FQDN}
      {
        \(dqcode\(dq: 119,
        \(dqdata\(dq: \(dqexample.com, example.org\(dq,
        \(dqname\(dq: \(dqdomain\-search\(dq
      },

      // کد گزینه 120 در Kea تعریف نشده است.

      /*
        Code Len Destination 1    Router 1
      +\-\-\-\-\-+\-\-\-+\-\-\-\-+\-\-\-\-\-+\-\-\-\-+\-\-\-\-+\-\-\-\-+\-\-\-\-+\-\-\-\-+
      | 121 | n | d1 | ... | dN | r1 | r2 | r3 | r4 |
      +\-\-\-\-\-+\-\-\-+\-\-\-\-+\-\-\-\-\-+\-\-\-\-+\-\-\-\-+\-\-\-\-+\-\-\-\-+\-\-\-\-+

       Destination 2       Router 2
      +\-\-\-\-+\-\-\-\-\-+\-\-\-\-+\-\-\-\-+\-\-\-\-+\-\-\-\-+\-\-\-\-+
      | d1 | ... | dN | r1 | r2 | r3 | r4 |
      +\-\-\-\-+\-\-\-\-\-+\-\-\-\-+\-\-\-\-+\-\-\-\-+\-\-\-\-+\-\-\-\-+

      Destination 1...N     توصیف‌کننده‌های مقصد \- شماره زیرشبکه IP و
                            ماسک زیرشبکه یک مقصد مشخص را با استفاده از
                            یک کدگذاری فشرده توصیف می‌کنند. این کدگذاری
                            شامل یک بایت است که طول ماسک زیرشبکه را
                            توصیف می‌کند، و به دنبال آن تمام بایت‌های
                            بااهمیت شماره زیرشبکه می‌آیند.

      Router 1...N          آدرس IP روتری که باید برای رسیدن به آن مقصد
                            استفاده شود.
      */
      // نوع: internal
      {
        \(dqcode\(dq: 121,
        // لطفاً به نمادگذاری مناسب استفاده‌شده توجه فرمایید:
        // subnet1 \- router1 IP addr, subnet2 \- router2 IP addr, ..., subnetN \- routerN IP addr
        \(dqdata\(dq: \(dq10.229.0.128/25 \- 10.229.0.1, 10.198.122.47/32 \- 10.198.122.1\(dq,
        \(dqname\(dq: \(dqclassless\-static\-route\(dq
      },

      // کدهای گزینه 122\-123 در Kea تعریف نشده‌اند.

      /*
                           1 1 1 1 1 1
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |  option\-code  |  option\-len   |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |      enterprise\-number1       |
      |                               |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |   data\-len1   |               |
      +\-+\-+\-+\-+\-+\-+\-+\-+               |
      /      vendor\-class\-data1       /
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+ \-\-\-\-
      |      enterprise\-number2       |   ^
      |                               |   |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+   |
      |   data\-len2   |               | optional
      +\-+\-+\-+\-+\-+\-+\-+\-+               |   |
      /      vendor\-class\-data2       /   |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+   |
      ~            ...                ~   V
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+ \-\-\-\-

      option\-code         OPTION_V\-I_VENDOR_CLASS (124)

      option\-len          طول کل تمام داده‌های گزینه بعدی بر حسب
                          بایت

      enterprise\-numberN  شماره ۳۲ بیتی سازمانی سازنده طبق ثبت در
                          IANA [3]

      data\-lenN           طول فیلد vendor\-class\-data

      vendor\-class\-dataN  جزئیات پیکربندی سخت‌افزاری میزبانی که
                          کلاینت روی آن اجرا می‌شود، یا سازگاری با
                          کنسرسیوم صنعتی
      */
      // نوع: uint32، binary
      {
        \(dqcode\(dq: 124,
        \(dqdata\(dq: \(dq4491, 0f BA AD AB BA D0 00 00 00 00 00 00 00 00 CA FE\(dq,
        \(dqname\(dq: \(dqvivco\-suboptions\(dq
      },

      /*
                           1 1 1 1 1 1
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |  option\-code  |  option\-len   |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |      enterprise\-number1       |
      |                               |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |   data\-len1   |               |
      +\-+\-+\-+\-+\-+\-+\-+\-+ option\-data1  |
      /                               /
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+ \-\-\-\-
      |      enterprise\-number2       |   ^
      |                               |   |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+   |
      |   data\-len2   |               | optional
      +\-+\-+\-+\-+\-+\-+\-+\-+ option\-data2  |   |
      /                               /   |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+   |
      ~            ...                ~   V
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+ \-\-\-\-

      option\-code         OPTION_V\-I_VENDOR_OPTS (125)

      option\-len          طول کل تمام داده‌های گزینه بعدی بر حسب
                          بایت

      enterprise\-numberN  شماره ۳۲ بیتی سازمانی ثبت‌شده سازنده
                          طبق ثبت در IANA [3]

      data\-lenN           طول فیلد option\-data

      option\-dataN        گزینه‌های مختص سازنده، که در زیر توضیح داده شده است
      */
      // نوع: uint32
      {
        \(dqcode\(dq: 125,
        \(dqdata\(dq: \(dq4491\(dq,
        \(dqname\(dq: \(dqvivso\-suboptions\(dq
      },

      // کدهای گزینه 126\-127 تخصیص نیافته‌اند.
      // کدهای گزینه 128\-135 در Kea تعریف نشده‌اند.

      /*
      0                   1
      0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |  option\-code  | option\-length |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                               |
      +      PAA IPv4 Address         +
      |                               |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |             ...               |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
         شکل 1: گزینه DHCPv4 مربوط به PAA

      option\-code:        OPTION_PANA_AGENT (136).

      option\-length:      طول فیلد \(aqoptions\(aq بر حسب بایت؛
                          باید مضربی از چهار (4) باشد.

      PAA IPv4 Address:   آدرس IPv4 یک PAA برای استفاده کلاینت.
                          عوامل PAA به ترتیب اولویت برای استفاده توسط
                          کلاینت فهرست شده‌اند.
      */
      // نوع: آرایه‌ای از {IPv4 address}
      {
        \(dqcode\(dq: 136,
        \(dqdata\(dq: \(dq192.0.2.66, 192.0.2.67\(dq,
        \(dqname\(dq: \(dqpana\-agent\(dq
      },

      /*
      Code    Len   LoST Server Domain Name
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-
      | 137 |  n  |  s1 |  s2 |  s3 |  s4 | s5  |  ...
      +\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-
      */
      // نوع: FQDN
      {
        \(dqcode\(dq: 137,
        \(dqdata\(dq: \(dqlost.example.org\(dq,
        \(dqname\(dq: \(dqv4\-lost\(dq
      },

      /*
      0                   1
      0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |  option\-code  | option\-length |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                               |
      +       AC IPv4 Address         +
      |                               |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |             ...               |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      option\-code:   OPTION_CAPWAP_AC_V4 (138)

      option\-length:   طول فیلد \(aqoptions\(aq بر حسب بایت؛ باید
         مضربی از چهار (4) باشد.

      AC IPv4 Address:  آدرس IPv4 یک CAPWAP AC که WTP می‌تواند استفاده کند.
         کنترل‌کننده‌های AC به ترتیب اولویت برای استفاده توسط WTP فهرست شده‌اند
      */
      // نوع: آرایه‌ای از {IPv4 address}
      {
        \(dqcode\(dq: 138,
        \(dqdata\(dq: \(dq192.0.2.68, 192.0.2.69\(dq,
        \(dqname\(dq: \(dqcapwap\-ac\-v4\(dq
      },

      // کدهای گزینه 139\-140 در Kea تعریف نشده‌اند.

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |      141      |     Len       |         Searchstring...       |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                     Searchstring...                           |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      */
      // نوع: آرایه‌ای از {FQDN}
      {
        \(dqcode\(dq: 141,
        \(dqdata\(dq: \(dqexample.com, example.org\(dq,
        \(dqname\(dq: \(dqsip\-ua\-cs\-domains\(dq
      },

      // کد گزینه 142 در Kea تعریف نشده است.

      /*
       0                             1
       0  1  2  3  4  5  6  7  8  9  0  1  2  3  4  5
      +\-\-+\-\-+\-\-+\-\-+\-\-+\-\-+\-\-+\-\-+\-\-+\-\-+\-\-+\-\-+\-\-+\-\-+\-\-+\-\-+
      |   option\-code (143)   |     option\-length     |
      +\-\-+\-\-+\-\-+\-\-+\-\-+\-\-+\-\-+\-\-+\-\-+\-\-+\-\-+\-\-+\-\-+\-\-+\-\-+\-\-+
      .                                               .
      .    bootstrap\-server\-list (variable length)    .
      .                                               .
      +\-\-+\-\-+\-\-+\-\-+\-\-+\-\-+\-\-+\-\-+\-\-+\-\-+\-\-+\-\-+\-\-+\-\-+\-\-+\-\-+

      option\-code: OPTION_V4_SZTP_REDIRECT (143)

      option\-length: طول گزینه بر حسب بایت.

      bootstrap\-server\-list: فهرستی از کارسازها برای کلاینت جهت
       تلاش برای برقراری ارتباط، به منظور دریافت داده‌های راه‌اندازی
       اولیه بیشتر. هر مدخل URI در bootstrap\-server\-list به
       صورت زیر ساختاربندی شده است:

      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-...\-+\-+\-+\-+\-+\-+\-+
      |       uri\-length              |          URI                  |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-...\-+\-+\-+\-+\-+\-+\-+

      uri\-length: به طول ۲ بایت؛ طول داده‌های URI را مشخص می‌کند.
      URI: شناسه URI مربوط به کارساز راه‌اندازی اولیه SZTP.
      */
      // نوع: آرایه‌ای از {tuple}
      {
        \(dqcode\(dq: 143,
        \(dqdata\(dq: \(dqhttps://sztp1.example.com:8443, https://sztp2.example.com:8444\(dq,
        \(dqname\(dq: \(dqv4\-sztp\-redirect\(dq
      },

      // کدهای گزینه 144\-145 در Kea تعریف نشده‌اند.

      // نوع: uint8، IPv4 address، IPv4 address، آرایه‌ای از {FQDN}
      {
        \(dqcode\(dq: 146,
        \(dqdata\(dq: \(dq1, 192.0.2.70, 192.0.2.71, example.com, example.org\(dq,
        \(dqname\(dq: \(dqrdnss\-selection\(dq
      },

      // کدهای گزینه 147\-158 در Kea تعریف نشده‌اند.

      // نوع: uint8، PSID
      {
        \(dqcode\(dq: 159,
        \(dqdata\(dq: \(dq2, 3/4\(dq,
        \(dqname\(dq: \(dqv4\-portparams\(dq
      },

      // کدهای گزینه 160\-161 تخصیص نیافته‌اند.

      /*
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      | OPTION_V4_DNR |     Length    |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      ~      DNR Instance Data #1     ~
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+   \-\-\-
      .              ...              .    |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+ optional
      ~      DNR Instance Data #n     ~    |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+   \-\-\-

      DNR Instance Data Format:
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |    DNR Instance Data Length   |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |       Service Priority        |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |   ADN Length  |               |
      +\-+\-+\-+\-+\-+\-+\-+\-+               |
      ~  authentication\-domain\-name   ~
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |  Addr Length  |               |
      +\-+\-+\-+\-+\-+\-+\-+\-+               |
      ~        IPv4 Address(es)       ~
      |               +\-+\-+\-+\-+\-+\-+\-+\-+
      |               |               |
      +\-+\-+\-+\-+\-+\-+\-+\-+               |
      ~Service Parameters (SvcParams) ~
      |                               |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      Code:  OPTION_V4_DNR (162).

      Length:  نشان‌دهنده طول داده‌های محصور بر حسب بایت است.

      DNR Instance Data:  شامل داده‌های پیکربندی یک تحلیل‌گر رمزگذاری‌شده
         DNS است. هنگامی که چندین تحلیل‌گر رمزگذاری‌شده DNS قرار است گنجانده شوند،
         فیلد \(dqDNR Instance Data\(dq تکرار می‌شود.

      DNR Instance Data Length:  طول تمام داده‌های بعدی بر حسب بایت.
         این فیلد زمانی که فقط یک ADN برای یک نمونه DNR ارائه شده باشد،
         روی (\(aqADN Length\(aq + 3) تنظیم می‌شود.

      Service Priority:  اولویت این نمونه در مقایسه با سایر
         نمونه‌های DNR. این عدد صحیح ۱۶ بیتی بدون علامت مطابق با قواعد
         مشخص‌شده در بخش 2.4.1 از [RFC9460] تفسیر می‌شود.

      ADN Length:  طول authentication\-domain\-name بر حسب بایت.

      authentication\-domain\-name (variable length):  نام دامنه احراز هویت
         تحلیل‌گر رمزگذاری‌شده DNS. این فیلد مطابق با بخش 10 از
         [RFC9915] قالب‌بندی می‌شود.

      Addr Length:  طول آدرس‌های IPv4 گنجانده‌شده بر حسب بایت. در صورت
         وجود، باید مضربی از 4 باشد.

      IPv4 Address(es) (variable length):  نشان‌دهنده یک یا چند آدرس IPv4
         برای دسترسی به تحلیل‌گر رمزگذاری‌شده DNS. هر دو نوع آدرس IPv4 خصوصی
         و عمومی می‌توانند در این فیلد گنجانده شوند.

      Service Parameters (SvcParams) (variable length):  مجموعه‌ای از پارامترهای
         سرویس را مشخص می‌کند که طبق قواعد بخش 2.2 از [RFC9460]
         کدگذاری می‌شوند. طول این فیلد برابر است با:
         (\(aqDNR Instance Data Length\(aq \- 4 \- \(aqADN Length\(aq \- \(aqAddr Length\(aq)).

      توجه داشته باشید که فیلدهای \(dqAddr Length\(dq، \(dqIPv4 Address(es)\(dq و
      \(dqService Parameters (SvcParams)\(dq در صورت استفاده از حالت فقط\-ADN وجود ندارند.
      */
      // نوع: internal
      {
        // گزینه DNR ممکن است با استفاده از نمادگذاری مناسب پیکربندی شود. نمونه‌های DNR باید با نویسه خط لوله \(dq|\(dq از هم جدا شوند.
        // برای هر نمونه DNR باید فیلدهایی که با ویرگول جدا شده‌اند ارائه شوند:
        // \- اولویت سرویس (اجباری)،
        // \- نام ADN (اجباری)،
        // \- آدرس(های) IP (اختیاری \- اگر بیش از یکی باشد \- باید با فاصله جدا شوند)
        // \- پارامترهای SvcParams (اختیاری \- اگر بیش از یکی باشد \- باید با فاصله جدا شوند؛
        //   برای ارائه بیش از یک alpn\-id آن‌ها را با ویرگولی که با دو بک‌اسلش گریز داده شده است،
        //   مانند مثال زیر، از هم جدا کنید).
        // نکته: هر زمان که لازم باشد نویسه خط لوله \(dq|\(dq به عنوان چیزی غیر از جداکننده استفاده شود،
        //       باید مانند ویرگول‌های گریز داده شده در فهرست alpn\-ids، با دو بک‌اسلش گریز داده شود.
        // بر اساس این پیکربندی، Kea گزینه را طبق RFC9463 کدگذاری خواهد کرد.
        \(dqcode\(dq: 162,
        \(dqname\(dq: \(dqv4\-dnr\(dq,
        \(dqdata\(dq: \(dq1, resolver.example., 10.2.3.4 10.0.4.5, alpn=dot\e\e,doq\e\e,h2\e\e,h3 dohpath=/q{?dns} | 2, resolver.example., 10.0.5.6, alpn=dot port=8530 | 3, fooexp.resolver.example.\(dq
      },

      // کدهای گزینه 163\-209 تخصیص نیافته‌اند.

      /*
      0                   1                   2                   3
      0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |  OPTION_6RD   | option\-length |  IPv4MaskLen  |  6rdPrefixLen |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                                                               |
      |                           6rdPrefix                           |
      |                          (16 octets)                          |
      |                                                               |
      |                                                               |
      |                                                               |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                     6rdBRIPv4Address(es)                      |
      .                                                               .
      .                                                               .
      .                                                               .
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      option\-code         OPTION_6RD (212)

      option\-length       طول گزینه DHCP بر حسب بایت (۲۲ بایت
                          با یک آدرس IPv4 رله مرزی یا BR).

      IPv4MaskLen         تعداد بیت‌های با مرتبه بالا که در تمام آدرس‌های
                          IPv4 مربوط به CE در یک دامنه 6rd معین یکسان هستند.
                          این مقدار می‌تواند هر مقداری بین 0 تا 32 باشد.
                          هر مقداری بزرگتر از 32 نامعتبر است.

      6rdPrefixLen        طول پیشوند IPv6 مربوط به پیشوند IPv6 ارائه‌دهنده سرویس
                          (SP) در 6rd بر حسب تعداد بیت. به منظور بررسی محدوده
                          توسط پردازش گزینه DHCP، حاصل‌جمع
                          (32 \- IPv4MaskLen) + 6rdPrefixLen باید (MUST) کمتر
                          یا مساوی 128 باشد.

      6rdBRIPv4Address    یک یا چند آدرس IPv4 از رله(های) مرزی 6rd
                          (Border Relay) برای یک دامنه 6rd معین.

      6rdPrefix           پیشوند IPv6 ارائه‌دهنده سرویس در 6rd که به عنوان یک
                          آدرس IPv6 شانزده بایتی نمایش داده می‌شود. بیت‌های موجود
                          در پیشوند پس از تعداد بیت‌های 6rdPrefixlen رزرو شده‌اند
                          و فرستنده باید (MUST) آن‌ها را با صفر مقداردهی اولیه کرده و
                          گیرنده باید آن‌ها را نادیده بگیرد.
      */
      // نوع: uint8، uint8، IPv6 address، آرایه‌ای از {IPv4 address}
      {
        \(dqcode\(dq: 212,
        \(dqdata\(dq: \(dq24, 96, 2001:db8::f001, 192.0.2.72, 192.0.2.73\(dq,
        \(dqname\(dq: \(dqoption\-6rd\(dq
      },

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |     Code      |   Length      |  Access Network Domain Name   .
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      .            Access Network Domain Name (cont.)                 .
      .                              ...                              .
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      option\-code:  OPTION_V4_ACCESS_DOMAIN (213).

      option\-length:  طول کل گزینه نام دامنه شبکه دسترسی
         بر حسب بایت.

      option\-value:  نام دامنه مرتبط با شبکه دسترسی،
         کدگذاری‌شده طبق توضیحات بخش 3.1.
      */
      // نوع: FQDN
      {
        \(dqcode\(dq: 213,
        \(dqdata\(dq: \(dqexample.org\(dq,
        \(dqname\(dq: \(dqv4\-access\-domain\(dq
      },

      // کدهای گزینه 214\-219 تخصیص نیافته‌اند.
      // کدهای گزینه 220\-221 در Kea تعریف نشده‌اند.
      // کدهای گزینه 222\-254 تخصیص نیافته‌اند.

      /*
                               داده‌های گزینه سفارشی
      */
      // برای تعاریف، \(dqoption\-def\(dq را در زیر ببینید.
      {
        \(dqcode\(dq: 1,
        \(dqname\(dq: \(dqmy\-empty\-option\(dq,
        \(dqspace\(dq: \(dqmy\-fancy\-space\(dq
      },
      {
        \(dqcode\(dq: 224,
        \(dqdata\(dq: \(dq192.0.2.74, 3/4, 1, example.org, string\(dq,
        \(dqname\(dq: \(dqmy\-lengthy\-option\(dq,
        \(dqspace\(dq: \(dqmy\-fancy\-space\(dq
      },
      {
        \(dqcode\(dq: 254,
        \(dqdata\(dq: \(dq127, 32767, 2147483647, 255, 65535, 4294967295, 192.0.2.75, 3/4, 1, example.org, string\(dq,
        \(dqname\(dq: \(dqmy\-fancy\-option\(dq,
        \(dqspace\(dq: \(dqmy\-fancy\-space\(dq
      },
      {
        \(dqcode\(dq: 232,
        \(dqname\(dq: \(dqmy\-encapsulating\-option\(dq,
        \(dqspace\(dq: \(dqmy\-encapsulating\-space\(dq
      }
    ],

    /*
                            تعاریف گزینه‌های سفارشی
    */
    // برای kea\-dhcp4، تعاریف گزینه‌های سفارشی می‌توانند سراسری یا در یک کلاس
    // کلاینت باشند.
    \(dqoption\-def\(dq: [
      // فضای گزینه جدید امکان داشتن مجموعه‌ای جدید از کدهای گزینه را فراهم می‌کند.
      // یک گزینه خالی نیازی به \(dqdata\(dq در \(dqoption\-data\(dq ندارد.
      // حضور آن باید برای راه‌اندازی رفتار سفارشی کافی باشد.
      {
        \(dqarray\(dq: false,
        \(dqcode\(dq: 1,
        \(dqencapsulate\(dq: \(dq\(dq,
        \(dqname\(dq: \(dqmy\-empty\-option\(dq,
        \(dqrecord\-types\(dq: \(dq\(dq,
        \(dqspace\(dq: \(dqmy\-fancy\-space\(dq,
        \(dqtype\(dq: \(dqempty\(dq
      },

      // یک نوع سفارشی دارای \(dqtype\(dq تنظیم‌شده روی \(dqrecord\(dq است و تمام انواع داده (که
      // باید بیش از یکی باشند، در غیر این صورت بهتر است مستقیماً از خود نوع استفاده کنید)
      // در \(dqrecord\-types\(dq مشخص می‌شوند. اگر \(dqstring\(dq بخشی از آن‌ها باشد،
      // باید آخرین مورد باشد.
      {
        \(dqarray\(dq: false,
        \(dqcode\(dq: 224,
        \(dqencapsulate\(dq: \(dq\(dq,
        \(dqname\(dq: \(dqmy\-lengthy\-option\(dq,
        \(dqrecord\-types\(dq: \(dqipv4\-address, psid, tuple, fqdn, string\(dq,
        \(dqspace\(dq: \(dqmy\-fancy\-space\(dq,
        \(dqtype\(dq: \(dqrecord\(dq
      },

      // شامل آرایه‌هایی از همه انواع به جز رشته‌ها، زیرا آرایه‌ای از رشته‌ها
      // یک تعریف گزینه معتبر نیست.
      {
        \(dqarray\(dq: true,
        \(dqcode\(dq: 254,
        \(dqencapsulate\(dq: \(dq\(dq,
        \(dqname\(dq: \(dqmy\-fancy\-option\(dq,
        \(dqrecord\-types\(dq: \(dqint8, int16, int32, uint8, uint16, uint32, ipv4\-address, psid, tuple, fqdn\(dq,
        \(dqspace\(dq: \(dqmy\-fancy\-space\(dq,
        \(dqtype\(dq: \(dqrecord\(dq
      },

      // می‌توان از یک فضای کپسوله‌ساز منفرد استفاده کرد. گزینه‌ای حاوی هر
      // گزینه‌ای از فضای مذکور، اکنون با موفقیت توسط Kea باز خواهد شد.
      {
        \(dqarray\(dq: false,
        \(dqcode\(dq: 232,
        \(dqencapsulate\(dq: \(dqmy\-fancy\-space\(dq,
        \(dqname\(dq: \(dqmy\-encapsulating\-option\(dq,
        \(dqrecord\-types\(dq: \(dq\(dq,
        \(dqspace\(dq: \(dqmy\-encapsulating\-space\(dq,
        \(dqtype\(dq: \(dqempty\(dq
      }
    ],

    \(dqsubnet4\(dq: [
      /*
                                داده‌های گزینه DOCSIS3
      */
      // سرآیندها همان‌طور که در CL\-SP\-CANN\-DHCP\-Reg\-I16\-200715 تعریف شده‌اند هستند.
      // مقدار \(dqspace\(dq باید صراحتاً به صورت \(dqdocsis3\-v4\(dq تعریف شود
      {
        \(dqoption\-data\(dq: [
          /*
           0                   1                   2                   3
           0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
          +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
          | CL_V4OPTION_ORO|  option\-len  | req\-opt\-code\-1| req\-opt\-code\-2|
          +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
          |                              ...                              |
          +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

          option\-code   CL_V4OPTION_ORO (1).

          option\-len    تعداد گزینه‌های درخواستی.

          req\-opt\-code\-n کد گزینه برای یک گزینه درخواست‌شده توسط کلاینت.

          */
          // نوع: آرایه‌ای از {uint8}
          {
            \(dqcode\(dq: 1,
            \(dqdata\(dq: \(dq32, 42\(dq,
            \(dqname\(dq: \(dqoro\(dq,
            \(dqspace\(dq: \(dqdocsis3\-v4\(dq
          },

          /*
           0                   1                   2                   3
           0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
          +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
          | option code |    option\-len   | IPv4 address of TFTP server 1 |
          +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
          |  address of server 1 (cont.)  | IPv4 address of TFTP server 2 |
          +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
          |  address of server 2 (cont.)  |              ...
          +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
          .               ...             | IPv4 address of TFTP server n |
          +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
          |  address of server n (cont.)  |
          +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

          option code      CL_VV4OPTION_TFTP_SERVERS (2)

          option len       تعداد بایت‌ها برای آدرس‌های IPv4 کارساز TFTP (به میزان 4*n برای
                           n کارساز)
          */
          // نوع: آرایه‌ای از {IPv4 address}
          {
            \(dqcode\(dq: 2,
            \(dqdata\(dq: \(dq192.0.2.76, 192.0.2.77\(dq,
            \(dqname\(dq: \(dqtftp\-servers\(dq,
            \(dqspace\(dq: \(dqdocsis3\-v4\(dq
          }
        ],
        \(dqid\(dq: 1,
        \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq
      }
    ]
  }
}
.EE
.UNINDENT
.UNINDENT.SS kea4/backends.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک فایل پیکربندی نمونه برای کارگزار DHCPv4 در Kea است.
// این یک سناریوی پایه‌ای با یک زیرشبکه IPv4 پیکربندی‌شده است. این سناریو نشان
// می‌دهد که چگونه Kea را برای استفاده از backendهای مختلف جهت ذخیره‌سازی اجاره‌ها پیکربندی کنید:
// \- memfile
// \- MySQL
// \- PostgreSQL

{ \(dqDhcp4\(dq:

{
// به Kea اعلام شده است که تنها روی رابط eth0 شنود کند.
  \(dqinterfaces\-config\(dq: {
    \(dqinterfaces\(dq: [ \(dqeth0\(dq ]
  },

// ما باید نوع اجاره را مشخص کنیم. دقیقاً یک بخش lease\-database
// باید وجود داشته باشد. مطمئن شوید که تنها یکی را از حالت کامنت خارج می‌کنید.

// ۱. backend از نوع memfile. اطلاعات اجاره‌ها در یک فایل متنی ساده CSV ذخیره خواهند شد.
// این ساده‌ترین backend برای استفاده است زیرا به هیچ وابستگی یا سرویس در حال اجرای
// اضافه‌ای نیاز ندارد.
//  \(dqlease\-database\(dq: {
//      \(dqtype\(dq: \(dqmemfile\(dq,
//      \(dqpersist\(dq: true,
//      \(dqlfc\-interval\(dq: 3600
//  },

// ۲. backend از نوع MySQL. اجاره‌ها در پایگاه‌داده MySQL ذخیره خواهند شد. مطمئن شوید
// که فعال، در حال اجرا و به درستی مقداردهی اولیه شده است. برای جزئیات در مورد نحوه
// مقداردهی اولیه پایگاه‌داده، مستندات kea\-admin را ببینید. تنها پارامترهای کاملاً
// مورد نیاز، type و name هستند. اگر سایر پارامترها مشخص نشوند، Kea فرض خواهد کرد
// که پایگاه‌داده روی localhost در دسترس است، برای اتصال نیازی به کاربر و گذرواژه نیست و
// مهلت زمانی ۵ ثانیه است. Kea برای استفاده از این backend باید با گزینه \(dq\-D mysql\(dq
// کامپایل شده باشد.
//  \(dqlease\-database\(dq: {
//      \(dqtype\(dq: \(dqmysql\(dq,
//      \(dqname\(dq: \(dqkeatest\(dq,
//      \(dqhost\(dq: \(dqlocalhost\(dq,
//      \(dqport\(dq: 3306,
//      \(dquser\(dq: \(dqkeatest\(dq,
//      \(dqpassword\(dq: \(dq1234\(dq,
//      \(dqreconnect\-wait\-time\(dq: 3000, // بیان‌شده بر حسب میلی‌ثانیه
//      \(dqmax\-reconnect\-tries\(dq: 3,
//      \(dqon\-fail\(dq: \(dqstop\-retry\-exit\(dq,
//      \(dqretry\-on\-startup\(dq: false,
//      \(dqconnect\-timeout\(dq: 3
//  },
// از زمان Kea.2.7.4، کتابخانه قلاب libdhcp_mysql.so باید بارگذاری شود تا
// اجاره‌ها در backend پایگاه‌داده اجاره MySQL ذخیره شوند.
// مکان کتابخانه قلاب backend اجاره را مشخص کنید.
//  {
//      // کتابخانه قلاب backend اجاره MySQL که برای ذخیره‌سازی اجاره‌ها مورد نیاز است.
//      \(dqlibrary\(dq: \(dqlibdhcp_mysql.so\(dq
//  },

// ۳. backend از نوع PostgreSQL. اجاره‌ها در پایگاه‌داده PostgreSQL ذخیره خواهند شد. مطمئن
// شوید که فعال، در حال اجرا و به درستی مقداردهی اولیه شده است. برای جزئیات در مورد
// نحوه مقداردهی اولیه پایگاه‌داده، مستندات kea\-admin را ببینید. تنها پارامترهای کاملاً
// مورد نیاز، type و name هستند. اگر سایر پارامترها مشخص نشوند، Kea فرض خواهد کرد
// که پایگاه‌داده روی localhost در دسترس است، برای اتصال نیازی به کاربر و گذرواژه نیست و
// مهلت زمانی ۵ ثانیه است. Kea برای استفاده از این backend باید با گزینه \(dq\-D postgresql\(dq
// کامپایل شده باشد.
//  \(dqlease\-database\(dq: {
//      \(dqtype\(dq: \(dqpostgresql\(dq,
//      \(dqname\(dq: \(dqkeatest\(dq,
//      \(dqhost\(dq: \(dqlocalhost\(dq,
//      \(dqport\(dq: 5432,
//      \(dquser\(dq: \(dqkeatest\(dq,
//      \(dqpassword\(dq: \(dq1234\(dq,
//      \(dqreconnect\-wait\-time\(dq: 3000, // بیان‌شده بر حسب میلی‌ثانیه
//      \(dqmax\-reconnect\-tries\(dq: 3,
//      \(dqon\-fail\(dq: \(dqstop\-retry\-exit\(dq,
//      \(dqretry\-on\-startup\(dq: false,
//      \(dqconnect\-timeout\(dq: 3
//  },
// از زمان Kea.2.7.4، کتابخانه قلاب libdhcp_pgsql.so باید بارگذاری شود تا
// اجاره‌ها در backend پایگاه‌داده اجاره PostgreSQL ذخیره شوند.
// مکان کتابخانه قلاب backend اجاره را مشخص کنید.
//  {
//      // کتابخانه قلاب backend اجاره PostgreSQL که برای ذخیره‌سازی اجاره‌ها مورد نیاز است.
//      \(dqlibrary\(dq: \(dqlibdhcp_pgsql.so\(dq
//  },

// نشانی‌ها با طول عمر ۴۰۰۰ ثانیه تخصیص داده خواهند شد.
  \(dqvalid\-lifetime\(dq: 4000,

// زمان‌سنج‌های تجدید (renew) و اتصال مجدد (rebind) کامنت شده‌اند. این بدان معناست
// که گزینه‌های ۵۸ و ۵۹ به کلاینت ارسال نخواهند شد. در این حالت بر عهده کلاینت
// است که مقادیر تایمر را بر اساس RFC2131 انتخاب کند. برای ارسال این گزینه‌ها
// به کلاینت، زمان‌سنج‌ها را از حالت کامنت خارج کنید.
//  \(dqrenew\-timer\(dq: 1000,
//  \(dqrebind\-timer\(dq: 2000,

// فهرست زیر زیرشبکه‌ها را تعریف می‌کند. ما در اینجا تنها یک زیرشبکه داریم.
// به Kea اعلام می‌کنیم که این زیرشبکه مستقیماً از طریق رابط محلی در دسترس است.
  \(dqsubnet4\(dq: [
    {
       \(dqpools\(dq: [ { \(dqpool\(dq:  \(dq192.0.2.1 \- 192.0.2.200\(dq } ],
       \(dqid\(dq:1 ,
       \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
       \(dqinterface\(dq: \(dqeth0\(dq
    }
  ],

// بخش زیر ثبت رویدادها (logging) را پیکربندی می‌کند. فرض بر این است که پیام‌هایی
// با حداقل سطح اطلاعاتی (info، warn، error و fatal) باید در stdout ثبت شوند.
    \(dqloggers\(dq: [
        {
            \(dqname\(dq: \(dqkea\-dhcp4\(dq,
            \(dqoutput\-options\(dq: [
                {
                    \(dqoutput\(dq: \(dqstdout\(dq
                }
            ],
            \(dqseverity\(dq: \(dqINFO\(dq
        }
    ]
}

}
.EE
.UNINDENT
.UNINDENT.SS kea4/classify.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک فایل پیکربندی نمونه برای کارساز DHCPv4 در Kea است.
// هدف این مثال، نمایش نحوه دسته‌بندی کلاینت‌ها است.

{ \(dqDhcp4\(dq:

{

// به Kea گفته شده است تنها روی رابط eth0 گوش فرا دهد.
  \(dqinterfaces\-config\(dq: {
      \(dqinterfaces\(dq: [ \(dqeth0\(dq ]
  },

// بیایید از ساده‌ترین بک‌اند یعنی memfile استفاده کرده و مقادیر معقولی را
// برای زمان‌سنج‌ها به کار ببریم. آن‌ها ارتباطی با نمایش دسته‌بندی ندارند.
  \(dqlease\-database\(dq: { \(dqtype\(dq: \(dqmemfile\(dq },
  \(dqrenew\-timer\(dq: 1000,
  \(dqrebind\-timer\(dq: 2000,
  \(dqvalid\-lifetime\(dq: 4000,

// این فهرست چندین کلاس را تعریف می‌کند که بسته‌های ورودی می‌توانند به آن‌ها تخصیص یابند.
// یک بسته می‌تواند متعلق به صفر یا چند کلاس باشد.
  \(dqclient\-classes\(dq: [

// کلاس نخست تلاش می‌کند کل آدرس سخت‌افزاری را با یک مقدار خاص تطبیق دهد.
// تمام بسته‌های ورودی با آن آدرس MAC مقدار ویژه‌ای از گزینه را دریافت خواهند کرد.
// اگر میزبان‌های زیادی وجود دارند که نیازمند رفتار ویژه هستند، استفاده از رزروهای
// میزبان بسیار بهتر است. با این حال، ترفند زدن با آدرس‌های MAC ممکن است در برخی
// موارد مفید باشد؛ مثلاً با تطبیق OUI با مقادیر شناخته‌شده می‌توان سازندگان خاصی را شناسایی کرد.
  {
      \(dqname\(dq: \(dqspecial_snowflake\(dq,
      \(dqtest\(dq: \(dqpkt4.mac == 0x010203040506\(dq,
      \(dqoption\-data\(dq: [{
          \(dqname\(dq: \(dqdomain\-name\-servers\(dq,
          \(dqdata\(dq: \(dq127.0.0.1\(dq
      }]
  },

// بیایید تمام پیام‌های ورودی DISCOVER (نوع پیام ۱) را در یک کلاس مجزا
// دسته‌بندی کنیم.
  {
      \(dqname\(dq: \(dqdiscovers\(dq,
      \(dqtest\(dq: \(dqpkt4.msgtype == 1\(dq
  },

// انتظار می‌رود کلاینت‌ها فیلد transaction\-id را روی یک مقدار تصادفی تنظیم کنند.
// کلاینت‌هایی که آن را با 0 ارسال می‌کنند به احتمال زیاد معیوب هستند. بیایید آن‌ها
// را به همین شکل علامت‌گذاری کنیم.
  {
      \(dqname\(dq: \(dqbroken\(dq,
      \(dqtest\(dq: \(dqpkt4.transid == 0\(dq
  },

// بیایید تلفن‌های VoIP را انتخاب کنیم. آن‌هایی که شناسه کلاس خود را به عنوان
// Aastra ارسال می‌کنند، باید متعلق به کلاس VoIP باشند. برای فهرستی از تمام گزینه‌ها،
// نشانی www.iana.org/assignments/bootp\-dhcp\-parameters را ببینید.
// در این کلاس خاص، می‌خواهیم مقادیر مشخصی از برخی فیلدهای DHCPv4 را
// تنظیم کنیم. اگر بسته ورودی با آزمون مطابقت داشته باشد، آن فیلدها در
// پاسخ‌های خروجی تنظیم خواهند شد.
// گزینه ۴۳ برای کپسوله‌سازی زیرگزینه در فضای aastra تعریف شده است.
  {
      \(dqname\(dq: \(dqVoIP\(dq,
      \(dqtest\(dq: \(dqsubstring(option[60].hex,0,6) == \(aqAastra\(aq\(dq,
      \(dqnext\-server\(dq: \(dq192.0.2.254\(dq,
      \(dqserver\-hostname\(dq: \(dqhal9000\(dq,
      \(dqboot\-file\-name\(dq: \(dq/dev/null\(dq,
      \(dqoption\-def\(dq: [ {
          \(dqname\(dq: \(dqvendor\-encapsulated\-options\(dq,
          \(dqcode\(dq: 43,
          \(dqtype\(dq: \(dqempty\(dq,
          \(dqencapsulate\(dq: \(dqaastra\(dq } ]
  }

  ],

// فهرست زیر زیرشبکه‌ها را تعریف می‌کند. برای برخی زیرشبکه‌ها کلاسی را تعریف کردیم
// که در آن زیرشبکه مجاز است. در صورت عدم تعیین، همه مجاز هستند. هنگامی
// که یک کلاس مشخص می‌شود، فقط بسته‌های متعلق به آن کلاس برای آن
// زیرشبکه مجاز خواهند بود.
  \(dqsubnet4\(dq: [
    // این مورد فقط برای دستگاه‌های VoIP است.
    {
        \(dqpools\(dq: [ { \(dqpool\(dq:  \(dq192.0.2.1 \- 192.0.2.200\(dq } ],
        \(dqid\(dq: 1,
        \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
        \(dqclient\-classes\(dq: [ \(dqVoIP\(dq ],
        \(dqinterface\(dq: \(dqeth0\(dq
    },

    // این مورد هیچ client\-class مشخصی ندارد، بنابراین همه مجاز
    // به ورود هستند. هرچند، قوانین معمول انتخاب زیرشبکه همچنان اعمال می‌شوند.
    // همچنین یک رزرو کلاس ایستا برای کلاینتی با آدرس MAC معادل
    // 1a:1b:1c:1d:1e:1f وجود دارد. این کلاینت همواره به این کلاس
    // اختصاص داده خواهد شد.
    {
        \(dqpools\(dq: [ { \(dqpool\(dq:  \(dq192.0.3.1 \- 192.0.3.200\(dq } ],
        \(dqid\(dq: 2,
        \(dqsubnet\(dq: \(dq192.0.3.0/24\(dq,
        \(dqreservations\(dq: [
        {
            \(dqhw\-address\(dq: \(dq1a:1b:1c:1d:1e:1f\(dq,
            \(dqclient\-classes\(dq: [ \(dqVoIP\(dq ]
        } ],
        \(dqinterface\(dq: \(dqeth0\(dq
    },

    // فهرست زیر یک زیرشبکه با استخرها را تعریف می‌کند. برای برخی استخرها
    // کلاسی را تعریف کردیم که در آن استخر مجاز است. در صورت عدم تعیین،
    // همه مجاز هستند. وقتی کلاسی مشخص شود، تنها بسته‌های متعلق
    // به آن کلاس برای آن استخر مجاز خواهند بود.
    {
        \(dqpools\(dq: [
           // این مورد فقط برای دستگاه‌های VoIP است.
           {
              \(dqpool\(dq:  \(dq192.0.4.1 \- 192.0.4.200\(dq,
              \(dqclient\-classes\(dq: [ \(dqVoIP\(dq ]
           },

           // این مورد هیچ client\-class مشخصی ندارد،
           // بنابراین همه مجاز به ورود هستند.
           {
               \(dqpool\(dq:  \(dq192.0.5.1 \- 192.0.5.200\(dq
           } ],

        \(dqsubnet\(dq: \(dq192.0.4.0/23\(dq,
        \(dqid\(dq: 3,
        \(dqinterface\(dq: \(dqeth1\(dq
    }
  ],

// بخش زیر ثبت وقایع را پیکربندی می‌کند. فرض می‌شود که پیام‌هایی با حداقل
// سطح اطلاعاتی (info، warn، error و fatal) باید در
// stdout ثبت شوند.
    \(dqloggers\(dq: [
        {
            \(dqname\(dq: \(dqkea\-dhcp4\(dq,
            \(dqoutput\-options\(dq: [
                {
                    \(dqoutput\(dq: \(dqstdout\(dq
                }
            ],
            \(dqseverity\(dq: \(dqINFO\(dq
        }
    ]
}

}
.EE
.UNINDENT
.UNINDENT.SS kea4/classify2.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک فایل پیکربندی نمونه برای کارگزار DHCPv4 در Kea است.
// هدف این مثال، نمایش نحوه دسته‌بندی کلاینت‌ها با استفاده
// از قابلیت‌های پیشرفته است.

{ \(dqDhcp4\(dq:

{

// به Kea گفته شده است که تنها روی رابط eth0 شنود کند.
  \(dqinterfaces\-config\(dq: {
      \(dqinterfaces\(dq: [ \(dqeth0\(dq ]
  },

// بیایید از ساده‌ترین بک‌اند یعنی memfile و مقادیر معقولی برای
// تایمرها استفاده کنیم. آن‌ها تاثیری در نمایش دسته‌بندی ندارند.
  \(dqlease\-database\(dq: { \(dqtype\(dq: \(dqmemfile\(dq },
  \(dqrenew\-timer\(dq: 1000,
  \(dqrebind\-timer\(dq: 2000,
  \(dqvalid\-lifetime\(dq: 4000,

// این فهرست چندین کلاس را تعریف می‌کند که بسته‌های دریافتی می‌توانند به آن‌ها تخصیص یابند.
// یک بسته می‌تواند به صفر یا چند کلاس تعلق داشته باشد.
  \(dqclient\-classes\(dq: [

// این کلاس توسط زیرشبکه دوم در فهرست \(aqevaluate\-additional\-classes\(aq گنجانده شده است،
// بنابراین \(aqonly\-in\-additional\-list\(aq فعال است. این امر تضمین می‌کند که این کلاس
// تنها در صورت انتخاب زیرشبکه دوم ارزیابی خواهد شد. عبارت آزمایش مقدار true را برمی‌گرداند.
// توجه داشته باشید که وابستگی به کلاس VoIP امکان‌پذیر نیست زیرا هنوز
// تعریف نشده است.
  {
      \(dqname\(dq: \(dqsecond_subnet\(dq,
      \(dqonly\-in\-additional\-list\(dq: true,
      \(dqtest\(dq: \(dqmember(\(aqALL\(aq)\(dq,
      \(dqoption\-data\(dq: [{
          \(dqname\(dq: \(dqdomain\-name\-servers\(dq,
          \(dqdata\(dq: \(dq127.0.0.1\(dq
      }]
  },

// بیایید تمام بسته‌های ورودی DISCOVER (نوع پیام ۱) را در یک کلاس
// جداگانه دسته‌بندی کنیم.
  {
      \(dqname\(dq: \(dqdiscovers\(dq,
      \(dqtest\(dq: \(dqpkt4.msgtype == 1\(dq
  },

// کلاینت‌ها باید فیلد transaction\-id را روی یک مقدار تصادفی تنظیم کنند.
// کلاینت‌هایی که آن را با 0 ارسال می‌کنند به احتمال زیاد معیوب هستند. بیایید
// آن‌ها را به همین عنوان علامت‌گذاری کنیم.
  {
      \(dqname\(dq: \(dqbroken\(dq,
      \(dqtest\(dq: \(dqpkt4.transid == 0\(dq
  },

// بیایید تلفن‌های VoIP را انتخاب کنیم. مواردی که شناسه کلاس خود را
// به عنوان Aastra ارسال می‌کنند، باید متعلق به کلاس VoIP باشند. برای فهرستی از تمام گزینه‌ها،
// به www.iana.org/assignments/bootp\-dhcp\-parameters مراجعه کنید.
// در این کلاس خاص، می‌خواهیم مقادیر مشخصی از برخی فیلدهای
// DHCPv4 را تنظیم کنیم. اگر بسته ورودی با آزمایش مطابقت داشته باشد،
// آن فیلدها در پاسخ‌های خروجی تنظیم خواهند شد.
// گزینه 43 برای کپسوله‌سازی زیرگزینه در فضای aastra تعریف شده است.
  {
      \(dqname\(dq: \(dqVoIP\(dq,
      \(dqtest\(dq: \(dqsubstring(option[60].hex,0,6) == \(aqAastra\(aq\(dq,
      \(dqnext\-server\(dq: \(dq192.0.2.254\(dq,
      \(dqserver\-hostname\(dq: \(dqhal9000\(dq,
      \(dqboot\-file\-name\(dq: \(dq/dev/null\(dq,
      \(dqoption\-def\(dq: [ {
          \(dqname\(dq: \(dqvendor\-encapsulated\-options\(dq,
          \(dqcode\(dq: 43,
          \(dqtype\(dq: \(dqempty\(dq,
          \(dqencapsulate\(dq: \(dqaastra\(dq } ]
  },

// هم یک تلفن VoIP (از طریق ارزیابی یا رزرو میزبان) و هم دارای یک رزرو
// میزبان است.
  {
      \(dqname\(dq: \(dqVoIP_host\(dq,
      \(dqtest\(dq: \(dqmember(\(aqVoIP\(aq) and member(\(aqKNOWN\(aq)\(dq,
      \(dqserver\-hostname\(dq: \(dqhal9001\(dq
  }

  ],

// فهرست زیر زیرشبکه‌ها را تعریف می‌کند. برای برخی زیرشبکه‌ها کلاسی را تعریف
// کرده‌ایم که در آن زیرشبکه مجاز است. در صورت عدم تعیین،
// همه مجاز هستند. هنگامی که یک کلاس مشخص می‌شود، تنها بسته‌های متعلق
// به آن کلاس برای آن زیرشبکه مجاز خواهند بود.
  \(dqsubnet4\(dq: [
    {
// این مورد فقط برای دستگاه‌های VoIP است.
        \(dqpools\(dq: [ { \(dqpool\(dq:  \(dq192.0.2.1 \- 192.0.2.200\(dq } ],
        \(dqid\(dq: 1,
        \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
        \(dqclient\-classes\(dq: [ \(dqVoIP\(dq ],
        \(dqinterface\(dq: \(dqeth0\(dq
    },
// این مورد هیچ client\-class مشخص‌شده‌ای ندارد، بنابراین همه
// مجاز هستند. با این حال، قوانین عادی انتخاب زیرشبکه همچنان اعمال می‌شوند.
// همچنین یک رزرو کلاس ایستا برای کلاینتی با آدرس مک
// 1a:1b:1c:1d:1e:1f وجود دارد. این کلاینت همیشه
// به این کلاس تخصیص خواهد یافت.
    {
        \(dqpools\(dq: [ { \(dqpool\(dq:  \(dq192.0.3.1 \- 192.0.3.200\(dq } ],
        \(dqid\(dq: 2,
        \(dqsubnet\(dq: \(dq192.0.3.0/24\(dq,
        \(dqreservations\(dq: [
        {
            \(dqhw\-address\(dq: \(dq1a:1b:1c:1d:1e:1f\(dq,
            \(dqclient\-classes\(dq: [ \(dqVoIP\(dq ]
        } ],
        \(dqinterface\(dq: \(dqeth0\(dq,
        \(dqevaluate\-additional\-classes\(dq: [ \(dqsecond_subnet\(dq ]
    },

// فهرست زیر یک زیرشبکه با استخرها را تعریف می‌کند. برای برخی استخرها
// کلاسی را مشخص کرده‌ایم که در آن استخر مجاز است. در صورت عدم تعیین،
// همه مجاز هستند. هنگامی که یک کلاس مشخص می‌شود، تنها بسته‌های متعلق
// به آن کلاس برای آن استخر مجاز خواهند بود.
     {
        \(dqpools\(dq: [
           {
// این مورد فقط برای دستگاه‌های VoIP است.
              \(dqpool\(dq:  \(dq192.0.4.1 \- 192.0.4.200\(dq,
              \(dqclient\-classes\(dq: [ \(dqVoIP\(dq ]
           },
// این مورد هیچ client\-class مشخص‌شده‌ای ندارد، بنابراین همه
// مجاز هستند.
           {
               \(dqpool\(dq:  \(dq192.0.5.1 \- 192.0.5.200\(dq
           } ],
           \(dqid\(dq: 3,
           \(dqsubnet\(dq: \(dq192.0.4.0/23\(dq,
           \(dqinterface\(dq: \(dqeth1\(dq
        },
// این زیرشبکه به دو استخر برای کلاینت‌های ناشناخته و شناخته‌شده
// (یعنی دارای رزرو) تقسیم شده است. کلاس‌های توکار KNOWN و
// UNKNOWN در هنگام جستجوی رزرو میزبان تنظیم یا عدم‌تنظیم می‌شوند (اگر
// مقداری بازگردد KNOWN و اگر چیزی نیابد UNKNOWN) و کلاس‌های
// کلاینت وابسته به آن ارزیابی می‌شوند.
// این فرآیند پس از انتخاب زیرشبکه و پیش از تخصیص آدرس از
// استخرها رخ می‌دهد.
        {
           \(dqpools\(dq: [
                {
                   \(dqpool\(dq: \(dq192.0.8.100 \- 192.0.8.200\(dq,
                   \(dqclient\-classes\(dq: [ \(dqUNKNOWN\(dq ]
                },
                {
                   \(dqpool\(dq: \(dq192.0.9.100 \- 192.0.9.200\(dq,
                   \(dqclient\-classes\(dq: [ \(dqKNOWN\(dq ]
                }
            ],
            \(dqid\(dq: 4,
            \(dqsubnet\(dq: \(dq192.0.8.0/23\(dq,
            \(dqreservations\(dq: [
                {  \(dqhw\-address\(dq: \(dq00:00:00:11:22:33\(dq, \(dqhostname\(dq: \(dqh1\(dq },
                {  \(dqhw\-address\(dq: \(dq00:00:00:44:55:66\(dq, \(dqhostname\(dq: \(dqh4\(dq },
                {  \(dqhw\-address\(dq: \(dq00:00:00:77:88:99\(dq, \(dqhostname\(dq: \(dqh7\(dq },
                {  \(dqhw\-address\(dq: \(dq00:00:00:aa:bb:cc\(dq, \(dqhostname\(dq: \(dqha\(dq }
            ]
        }
  ],

// بخش زیر پیکربندی گزارش‌گیری را انجام می‌دهد. فرض بر این است که پیام‌هایی
// با حداقل سطح اطلاعاتی (info، warn، error و fatal) باید در
// stdout ثبت شوند.
    \(dqloggers\(dq: [
        {
            \(dqname\(dq: \(dqkea\-dhcp4\(dq,
            \(dqoutput\-options\(dq: [
                {
                    \(dqoutput\(dq: \(dqstdout\(dq
                }
            ],
            \(dqseverity\(dq: \(dqINFO\(dq
        }
    ]
}

}
.EE
.UNINDENT
.UNINDENT.SS kea4/comments.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک فایل پیکربندی نمونه برای کارساز DHCPv4 در Kea است.
// این فایل از کامنت‌های توکار (یعنی مواردی که در شیءهای پیکربندی گنجانده شده
// و در تحلیل لغوی حذف نمی‌شوند) استفاده می‌کند.

{ \(dqDhcp4\(dq:

{
   // حوزه سراسری
   \(dqcomment\(dq: \(dqیک کارساز DHCPv4\(dq,

   // در پیکربندی واسط
   \(dqinterfaces\-config\(dq: {
       \(dqcomment\(dq: \(dqاستفاده از نویسه عمومی\(dq,
       \(dqinterfaces\(dq: [ \(dq*\(dq ] },

   // در تعاریف گزینه
   \(dqoption\-def\(dq: [ {
       \(dqcomment\(dq: \(dqیک تعریف گزینه\(dq,
       \(dqname\(dq: \(dqfoo\(dq,
       \(dqcode\(dq: 100,
       \(dqtype\(dq: \(dqipv4\-address\(dq,
       \(dqspace\(dq: \(dqisc\(dq
    } ],

   // در داده‌های گزینه
   \(dqoption\-data\(dq: [ {
       \(dqcomment\(dq: \(dqتنظیم مقدار گزینه\(dq,
       \(dqname\(dq: \(dqdhcp\-message\(dq,
       \(dqdata\(dq: \(dqABCDEF0105\(dq,
       \(dqcsv\-format\(dq: false
    } ],

   // در کلاس‌های کلاینت
   \(dqclient\-classes\(dq: [
       {
          \(dqcomment\(dq: \(dqتطابق با همه\(dq,
          \(dqname\(dq: \(dqall\(dq,
          \(dqtest\(dq: \(dq\(aq\(aq == \(aq\(aq\(dq
       },
       // البته کامنت‌ها اختیاری هستند
       {
          \(dqname\(dq: \(dqnone\(dq
       },
       // می‌توان یک کامنت و یک user\-context مشخص کرد
       {
          \(dqcomment\(dq: \(dqیک کامنت\(dq,
          \(dqname\(dq: \(dqboth\(dq,
          \(dquser\-context\(dq: {
              \(dqversion\(dq: 1
          }
       }
   ],

   // در سوکت‌های کنترلی.
   \(dqcontrol\-sockets\(dq: [
       {
           \(dqsocket\-type\(dq: \(dqunix\(dq,
           \(dqsocket\-name\(dq: \(dqkea4\-ctrl\-socket\(dq,
           \(dquser\-context\(dq: { \(dqcomment\(dq: \(dqکامنت غیرمستقیم\(dq }
       },
       {
           \(dqcomment\(dq: \(dqسوکت کنترلی HTTP\(dq,
           \(dqsocket\-type\(dq: \(dqhttp\(dq,
           \(dqsocket\-address\(dq: \(dq::1\(dq,
           \(dqsocket\-port\(dq: 8004,

           // در احراز هویت
           \(dqauthentication\(dq: {
               \(dqcomment\(dq: \(dqاحراز هویت پایه HTTP\(dq,
               \(dqtype\(dq: \(dqbasic\(dq,
               // در کلاینت‌های احراز هویت پایه HTTP
               \(dqclients\(dq: [ {
                   \(dquser\(dq: \(dqadmin\(dq,
                   \(dqpassword\(dq: \(dq1234\(dq
               } ]
           }
       }
   ],

   // در شبکه‌های مشترک
   \(dqshared\-networks\(dq: [ {
       \(dqcomment\(dq: \(dqیک شبکه مشترک\(dq,
       \(dqname\(dq: \(dqfoo\(dq,

       // در زیرشبکه‌ها
       \(dqsubnet4\(dq: [
         {
           \(dqcomment\(dq: \(dqیک زیرشبکه\(dq,
           \(dqsubnet\(dq: \(dq192.0.1.0/24\(dq,
           \(dqid\(dq: 100,

           // در استخرها
           \(dqpools\(dq: [
             {
                \(dqcomment\(dq: \(dqیک استخر\(dq,
                \(dqpool\(dq: \(dq192.0.1.1\-192.0.1.10\(dq
             }
           ],

           // در رزروهای میزبان
           \(dqreservations\(dq: [
             {
                \(dqcomment\(dq: \(dqیک رزرو میزبان\(dq,
                \(dqhw\-address\(dq: \(dqAA:BB:CC:DD:EE:FF\(dq,
                \(dqhostname\(dq: \(dqfoo.example.com\(dq,

                // مجدداً در یک داده گزینه
                \(dqoption\-data\(dq: [ {
                    \(dqcomment\(dq: \(dqیک گزینه در یک رزرو\(dq,
                    \(dqname\(dq: \(dqdomain\-name\(dq,
                    \(dqdata\(dq: \(dqexample.com\(dq
                } ]
             }
           ]
         }
       ]
    } ],

   // در dhcp ddns
   \(dqdhcp\-ddns\(dq: {
       \(dqcomment\(dq: \(dqبدون DNS پویا\(dq,
       \(dqenable\-updates\(dq: false
   },

   // در لاگرها
   \(dqloggers\(dq: [ {
       \(dqcomment\(dq: \(dqیک لاگر\(dq,
       \(dqname\(dq: \(dqkea\-dhcp4\(dq
   } ]
}

}
.EE
.UNINDENT
.UNINDENT.SS kea4/config\-backend.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک فایل پیکربندی نمونه برای سرور DHCPv4 در Kea است.
// این فایل نحوه فعال‌سازی Kea Configuration Backend با استفاده از MySQL را نشان می‌دهد.
// این پیکربندی نیازمند در دسترس بودن کتابخانه libdhcp_mysql.so و
// به صورت اختیاری کتابخانه قلاب libdhcp_cb_cmds.so است.

{ \(dqDhcp4\(dq:

{
    // برچسب سرور (server tag) را برای configuration backend تنظیم می‌کند. این نمونه
    // server1 نام‌گذاری خواهد شد. هر عنصر پیکربندی که برای
    // \(dqall\(dq یا \(dqserver1\(dq قابل اعمال باشد توسط این نمونه استفاده خواهد شد.
    \(dqserver\-tag\(dq: \(dqserver1\(dq,

    // به Kea اعلام شده است که فقط روی رابط eth0 شنود کند.
    \(dqinterfaces\-config\(dq: {
        \(dqinterfaces\(dq: [ \(dqeth0\(dq ]
    },

    // استفاده از بک‌اند پایگاه داده اجاره memfile.
    \(dqlease\-database\(dq: {
        \(dqtype\(dq: \(dqmemfile\(dq,
        \(dqlfc\-interval\(dq: 3600
    },

    // این پارامتر نحوه دسترسی سرور به پایگاه داده پیکربندی را کنترل می‌کند.
    // در حال حاضر تنها دو نوع پایگاه داده در دسترس است \- \(dqmysql\(dq و
    // \(dqpostgresql\(dq.
    // استفاده از \(dqmysql\(dq مستلزم بارگذاری کتابخانه قلاب libdhcp_mysql.so است.
    // در صورت استفاده از \(dqpostgresql\(dq، بارگذاری کتابخانه قلاب libdhcp_pgsql.so
    // الزامی است.
    \(dqconfig\-control\(dq: {
        // فهرستی از بک‌اندهای پایگاه داده برای اتصال. در حال حاضر، این مقدار
        // به یک بک‌اند منفرد محدود است.
        \(dqconfig\-databases\(dq: [
            {
                \(dqtype\(dq: \(dqmysql\(dq,
                \(dqreconnect\-wait\-time\(dq: 3000, // بیان‌شده به میلی‌ثانیه
                \(dqmax\-reconnect\-tries\(dq: 3,
                \(dqname\(dq: \(dqkea\(dq,
                \(dquser\(dq: \(dqkea\(dq,
                \(dqpassword\(dq: \(dq1234\(dq,
                \(dqhost\(dq: \(dqlocalhost\(dq,
                \(dqport\(dq: 3306
            }
        ],
        // دوره‌های زمانی بررسی پایگاه داده توسط سرور برای به‌روزرسانی‌های
        // پیکربندی را کنترل می‌کند. تنظیم زیر بدین معناست که شناسایی و واکشی
        // تغییرات پیکربندی توسط سرور تا حدود 20 ثانیه زمان خواهد برد.
        \(dqconfig\-fetch\-wait\-time\(dq: 20
    },

    // این بخش یک سوکت کنترلی تعریف می‌کند. در صورت تعریف، Kea یک سوکت UNIX باز کرده
    // و به دستورهای دریافتی گوش می‌دهد. برای جزئیات به بخش ۱۷ از
    // Kea ARM مراجعه کنید.
    \(dqcontrol\-socket\(dq: {
        \(dqsocket\-type\(dq: \(dqunix\(dq,
        \(dqsocket\-name\(dq: \(dqkea4\-ctrl\-socket\(dq
    },

    // کتابخانه‌های قلاب (hooks) که configuration backend را فعال می‌کنند بارگذاری می‌شوند.
    \(dqhooks\-libraries\(dq: [
        // کتابخانه libdhcp_mysql.so برای استفاده از MySQL Configuration
        // Backend مورد نیاز است.
        {
            \(dqlibrary\(dq: \(dqlibdhcp_mysql.so\(dq
        }
        // در صورت استفاده از PostgreSQL Configuration Backend، کتابخانه \(dqlibdhcp_pgsql.so\(dq
        // مورد نیاز است.
        // {
        //    \(dqlibrary\(dq: \(dqlibdhcp_pgsql.so\(dq
        // }
        // کتابخانه libdhcp_cb_cmds.so اختیاری است. این کتابخانه امکان مدیریت
        // پیکربندی را در پایگاه داده فراهم می‌کند. اگر این کتابخانه بارگذاری نشود،
        // پیکربندی می‌تواند مستقیماً با استفاده از ابزارهای موجودی که
        // مستقیماً با پایگاه داده MySQL کار می‌کنند مدیریت شود.
        // ,{
        //     \(dqlibrary\(dq: \(dqlibdhcp_cb_cmds.so\(dq
        // }
    ],

    // بخش زیر گزارش‌گیری را پیکربندی می‌کند. فرض بر این است که پیام‌هایی با
    // حداقل سطح اطلاعاتی (info، warn، error و fatal) باید در
    // stdout ثبت شوند. در غیر این صورت، می‌توانید stderr، نام یک فایل
    // یا \(aqsyslog\(aq را مشخص کنید که پیام‌های خروجی را از طریق syslog ذخیره می‌کند.
    \(dqloggers\(dq: [
        {
            \(dqname\(dq: \(dqkea\-dhcp4\(dq,
            \(dqoutput\-options\(dq: [
                {
                    \(dqoutput\(dq: \(dqstdout\(dq
                }
            ],
            \(dqseverity\(dq: \(dqINFO\(dq
        }
    ]
}

}
.EE
.UNINDENT
.UNINDENT
.SS kea4/dhcpv4\-over\-dhcpv6.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک فایل پیکربندی نمونه برای سرور DHCPv4 مربوط به
// آزمایش‌های DHCPv4\-over\-DHCPv6 در Kea است.

{

// پیکربندی DHCPv4
\(dqDhcp4\(dq:
{
  \(dqinterfaces\-config\(dq: {
    \(dqinterfaces\(dq: [ \(dqeth0\(dq ]
  },

  \(dqlease\-database\(dq: {
      \(dqtype\(dq: \(dqmemfile\(dq,
      \(dqname\(dq: \(dqkea\-leases4.csv\(dq,
      \(dqlfc\-interval\(dq: 3600
  },

  \(dqvalid\-lifetime\(dq: 4000,

  \(dqsubnet4\(dq: [
   {
        \(dqid\(dq: 100,
        \(dqsubnet\(dq: \(dq10.10.10.0/24\(dq,
// پیشوند \(dq4o6\-\(dq قبل از \(dqinterface\(dq در اینجا فراموش نشود!
        \(dq4o6\-interface\(dq: \(dqeth0\(dq,
        \(dq4o6\-subnet\(dq: \(dq2001:db8:1:1::/64\(dq,
        \(dqpools\(dq: [ { \(dqpool\(dq: \(dq10.10.10.100 \- 10.10.10.199\(dq } ] }
  ],

// این گزینه پشتیبانی از DHCPv4\-over\-DHCPv6 را فعال می‌کند
  \(dqdhcp4o6\-port\(dq: 786,

  \(dqloggers\(dq: [
    {
      \(dqname\(dq: \(dqkea\-dhcp4\(dq,
      \(dqoutput\-options\(dq: [
          {
            \(dqoutput\(dq: \(dqkea\-dhcp4.log\(dq
          }
      ],
      \(dqseverity\(dq: \(dqDEBUG\(dq,
      \(dqdebuglevel\(dq: 0
    }
  ]
}

}
.EE
.UNINDENT
.UNINDENT.SS kea4/global\-reservations.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک فایل پیکربندی نمونه برای کارساز DHCPv4 در Kea است.
// این فایل نحوهٔ پیکربندی رزروهای سراسری میزبان را نشان می‌دهد.
// رزروهای سراسری با هیچ زیرشبکه‌ای مرتبط نیستند. آن‌ها صرف‌نظر از
// زیرشبکه‌ای که کلاینت DHCP به آن تعلق دارد تخصیص می‌یابند.
// رزروهای سراسری با استفاده از همان انواع شناسه‌های میزبان مربوط به
// رزروهای ویژهٔ زیرشبکه به کلاینت‌های DHCP تخصیص داده می‌شوند. این فایل
// شامل چندین مثال از رزروهای میزبان با استفاده از انواع شناسه‌های
// مختلف، مانند مک‌آدرس (MAC address)، شناسهٔ کلاینت و غیره است.
{ \(dqDhcp4\(dq:

{
// به Kea اعلام شده است که تنها روی رابط eth0 شنود کند.
  \(dqinterfaces\-config\(dq: {
    \(dqinterfaces\(dq: [ \(dqeth0\(dq ]
  },

// باید پایگاه‌دادهٔ مورد استفاده برای ذخیرهٔ اجاره‌ها را مشخص کنیم. تا ژوئن
// ۲۰۲۲، از سه پس‌بند پایگاه‌داده پشتیبانی می‌شود: MySQL ،PostgreSQL و
// پایگاه‌دادهٔ درون‌حافظه‌ای Memfile. ما از memfile استفاده خواهیم کرد زیرا
// به هیچ راه‌اندازی اولیه‌ای نیاز ندارد.
  \(dqlease\-database\(dq: {
      \(dqtype\(dq: \(dqmemfile\(dq,
      \(dqlfc\-interval\(dq: 3600
  },

// نشانی‌ها با طول‌عمر ۴۰۰۰ ثانیه تخصیص داده خواهند شد.
  \(dqvalid\-lifetime\(dq: 4000,

// زمان‌سنج‌های renew و rebind کامنت شده‌اند. این بدان معناست که گزینه‌های
// ۵۸ و ۵۹ به کلاینت ارسال نخواهند شد. در این حالت انتخاب مقادیر زمان‌سنج
// مطابق با RFC2131 بر عهدهٔ کلاینت خواهد بود. برای ارسال این گزینه‌ها به کلاینت،
// زمان‌سنج‌ها را از حالت کامنت خارج کنید.
//  \(dqrenew\-timer\(dq: 1000,
//  \(dqrebind\-timer\(dq: 2000,

// سامانهٔ Kea از رزروها بر اساس چندین نوع شناسهٔ مختلف پشتیبانی می‌کند:
// hw\-address (نشانی سخت‌افزاری/MAC کلاینت)، duid (شناسهٔ DUID درج‌شده توسط
// کلاینت)، client\-id (شناسهٔ کلاینت درج‌شده توسط کلاینت)، circuit\-id
// (شناسهٔ مدار درج‌شده توسط عامل رله) و flex\-id (شناسهٔ انعطاف‌پذیر
// موجود در صورت بارگذاری کتابخانهٔ قلاب flex_id). هنگامی که از Kea خواسته
// شود، می‌تواند تمام این انواع شناسه‌ها را بررسی کند، اما این کار مستلزم یک جست‌وجوی
// سنگین در پایگاه‌داده است. بنابراین از دیدگاه کارایی سودمند است که تنها از
// انواعی از رزرو استفاده شود که واقعاً در یک شبکهٔ مشخص به کار می‌روند.

// مثال زیر از دیدگاه کارایی بهینه نیست، اما قابلیت‌های رزرو میزبان را به
// خوبی نمایش می‌دهد. لطفاً از حداقل مجموعهٔ انواع شناسه‌های مورد استفاده در شبکهٔ خود استفاده کنید.
  \(dqhost\-reservation\-identifiers\(dq: [ \(dqcircuit\-id\(dq, \(dqhw\-address\(dq, \(dqduid\(dq,
                                    \(dqclient\-id\(dq, \(dqflex\-id\(dq ],

// این دستورالعمل به Kea اعلام می‌کند که رزروها سراسری هستند. توجه داشته باشید
// که این مورد می‌تواند در سطح shared network و/یا subnet نیز مشخص شود.

// مشخص می‌کند که آیا کارساز باید رزروهای سراسری را جست‌وجو کند یا خیر.
  \(dqreservations\-global\(dq: true,

// مشخص می‌کند که آیا کارساز باید رزروهای درون زیرشبکه را جست‌وجو کند یا خیر.
  \(dqreservations\-in\-subnet\(dq: false,

// مشخص می‌کند که آیا کارساز می‌تواند فرض کند تمام نشانی‌های رزروشده
// خارج از استخر (out\-of\-pool) هستند یا خیر.
// در صورتی که reservations\-in\-subnet برابر با false باشد، نادیده گرفته می‌شود.
// در صورت تعیین، توسط سطوح \(dqshared\-networks\(dq و \(dqsubnet4\(dq به ارث برده می‌شود.
  \(dqreservations\-out\-of\-pool\(dq: false,

// تعریف چندین رزرو سراسری میزبان.
  \(dqreservations\(dq: [

// این یک رزرو برای یک نشانی سخت‌افزاری/MAC مشخص است. این یک رزرو
// بسیار ساده است: فقط یک نشانی و نه چیز دیگر.
// توجه داشته باشید که رزرو نشانی‌ها در دامنهٔ سراسری توصیه نمی‌شود اما همچنان مجاز است:
// از آنجا که پیوند بین رزرو و زیرشبکه را از بین می‌برد، می‌تواند منجر به قرار گرفتن
// کلاینت در زیرشبکه‌ای متفاوت از زیرشبکه‌ای که نشانی به آن تعلق دارد شود.
    {
        \(dqhw\-address\(dq: \(dq1a:1b:1c:1d:1e:1f\(dq,
        \(dqip\-address\(dq: \(dq192.0.2.201\(dq
    },

// این یک رزرو برای یک client\-id مشخص است. همچنین نشان می‌دهد که این
// کلاینت یک hostname رزروشده دریافت خواهد کرد. یک hostname می‌تواند
// برای هر نوع شناسه‌ای تعریف شود، نه فقط client\-id. مشخص کردن حداقل
// یک hostname یا یک نشانی الزامی است.
    {
        \(dqclient\-id\(dq: \(dq01:11:22:33:44:55:66\(dq,
        \(dqhostname\(dq: \(dqspecial\-snowflake\(dq
    },

// رزرو سوم بر اساس DUID است. این رزرو همچنین مقادیر گزینه‌های خاصی را برای
// این کلاینت به‌خصوص تعریف می‌کند. اگر گزینهٔ domain\-name\-servers در سطح سراسری،
// زیرشبکه یا کلاس تعریف شده بود، مقادیر اختصاصی میزبان برای این کلاینت خاص DHCP
// اولویت خواهند داشت.
    {
        \(dqduid\(dq: \(dq01:02:03:04:05\(dq,
        \(dqip\-address\(dq: \(dq192.0.2.203\(dq,
        \(dqoption\-data\(dq: [ {
            \(dqname\(dq: \(dqdomain\-name\-servers\(dq,
            \(dqdata\(dq: \(dq10.1.1.202,10.1.1.203\(dq
        } ]
    },

// رزرو چهارم بر اساس circuit\-id است. این گزینه‌ای است که توسط عامل رله
// که بسته را از کلاینت به کارساز هدایت می‌کند، درج شده است.
// در این مثال گزینه‌های ویژهٔ سازنده (vendor specific) نیز به میزبان اختصاص یافته است.
    {
        \(dqcircuit\-id\(dq: \(dq01:11:22:33:44:55:66\(dq,
        \(dqip\-address\(dq: \(dq192.0.2.204\(dq,
        \(dqoption\-data\(dq: [
            {
                \(dqname\(dq: \(dqvivso\-suboptions\(dq,
                \(dqdata\(dq: \(dq4491\(dq
            },
            {
                \(dqname\(dq: \(dqtftp\-servers\(dq,
                \(dqspace\(dq: \(dqvendor\-4491\(dq,
                \(dqdata\(dq: \(dq10.1.1.202,10.1.1.203\(dq
            }
        ]
    },

// این رزرو برای کلاینتی است که نیاز به تنظیم فیلدهای خاصی از DHCPv4 دارد.
// سه فیلد پشتیبانی‌شده عبارتند از next\-server و server\-hostname و
// boot\-file\-name
    {
        \(dqclient\-id\(dq: \(dq01:0a:0b:0c:0d:0e:0f\(dq,
        \(dqip\-address\(dq: \(dq192.0.2.205\(dq,
        \(dqnext\-server\(dq: \(dq192.0.2.1\(dq,
        \(dqserver\-hostname\(dq: \(dqhal9000\(dq,
        \(dqboot\-file\-name\(dq: \(dq/dev/null\(dq
    },

// این رزرو از یک شناسهٔ انعطاف‌پذیر (flexible identifier) استفاده می‌کند. به جای
// اتکا به یک فیلد خاص، مدیر سیستم می‌تواند عبارتی مشابه آنچه برای دسته‌بندی کلاینت
// استفاده می‌شود تعریف کند،
// مانند substring(relay[0].option[17],0,6). سپس بر اساس مقدار آن
// عبارت برای بستهٔ ورودی، رزرو مطابقت داده می‌شود. عبارت را می‌توان به صورت
// هگزادسیمال یا متن ساده با استفاده از علامت‌های نقل‌قول تکی مشخص کرد.
// نکته: برای کارکرد شناسهٔ انعطاف‌پذیر، بارگذاری کتابخانهٔ قلاب flex_id
// الزامی است.
    {
        \(dqflex\-id\(dq: \(dq\(aqs0mEVaLue\(aq\(dq,
        \(dqip\-address\(dq: \(dq192.0.2.206\(dq
    }
  ],

  // تعریف یک زیرشبکه.
    \(dqsubnet4\(dq: [
        {
           \(dqpools\(dq: [ { \(dqpool\(dq:  \(dq192.0.2.1 \- 192.0.2.200\(dq } ],
           \(dqid\(dq: 1,
           \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
           \(dqinterface\(dq: \(dqeth0\(dq
        }
    ],

// بخش زیر گزارش‌گیری را پیکربندی می‌کند. فرض بر این است که پیام‌هایی با
// دست‌کم سطح اطلاعاتی (info ،warn ،error و fatal) باید در stdout
// ثبت شوند.
    \(dqloggers\(dq: [
        {
            \(dqname\(dq: \(dqkea\-dhcp4\(dq,
            \(dqoutput\-options\(dq: [
                {
                    \(dqoutput\(dq: \(dqstdout\(dq
                }
            ],
            \(dqseverity\(dq: \(dqINFO\(dq
        }
    ]
}

}
.EE
.UNINDENT
.UNINDENT.SS kea4/ha\-load\-balancing\-server1\-mt\-with\-tls.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک پیکربندی نمونه از سرور Kea DHCPv4 است. این پیکربندی از کتابخانه
// قلاب High Availability و کتابخانه قلاب Lease Commands برای فعال‌سازی
// قابلیت High Availability برای سرور DHCP استفاده می‌کند. توجه داشته باشید
// که تقریباً دقیقاً همین پیکربندی باید روی سرور دوم (partner) استفاده شود.
// تنها تفاوت این است که \(dqthis\-server\-name\(dq باید روی آن سرور دیگر
// برابر با \(dqserver2\(dq تنظیم شود. همچنین، پیکربندی رابط و مکان فایل‌های
// مربوط به TLS به تنظیمات شبکه و پیکربندی آن ماشین خاص بستگی دارد.
//
// سرورهایی که از این پیکربندی استفاده می‌کنند در حالت load balancing کار می‌کنند.
{

// پیکربندی DHCPv4 از اینجا شروع می‌شود.
\(dqDhcp4\(dq: {
    // نام‌های رابط‌های شبکه خود را برای شنود اضافه کنید.
    \(dqinterfaces\-config\(dq: {
        // سرور DHCPv4 روی این رابط شنود می‌کند.
        \(dqinterfaces\(dq: [ \(dqeth0\(dq ]
    },

    // پارامترهای Multi\-threading.
    \(dqmulti\-threading\(dq: {
        // به‌طور پیش‌فرض، اگر سخت‌افزار اجازه دهد Kea بسته‌ها را روی چندین نخ پردازش می‌کند.
        \(dqenable\-multi\-threading\(dq: true,

        // هنگامی که چندنخی فعال باشد، Kea بسته‌ها را روی تعدادی نخ پردازش می‌کند
        // که از طریق این گزینه قابل‌پیکربندی است.
        \(dqthread\-pool\-size\(dq: 4,

        // هنگامی که چندنخی فعال است، Kea بسته‌ها را از رابط می‌خواند و
        // یک مورد کاری را به استخر نخ‌ها اضافه می‌کند. این گزینه
        // بیشینه تعداد مواردی را که می‌توانند صف‌بندی شوند پیکربندی می‌کند.
        \(dqpacket\-queue\-size\(dq: 64
    },

    // از بک‌اند پایگاه داده اجاره Memfile برای ذخیره اجاره‌ها در یک فایل CSV استفاده کنید.
    // بسته به نحوه کامپایل Kea، ممکن است از پایگاه‌های داده SQL نیز پشتیبانی کند
    // (MySQL و/یا PostgreSQL). آن بک‌آندهای پایگاه داده به پارامترهای بیشتری
    // مانند name ،host و احتمالاً user و password نیاز دارند.
    // مثال‌های اختصاصی برای هر بک‌اند وجود دارد. برای جزئیات به بخش 7.2.2
    // \(dqLease Storage\(dq مراجعه کنید.
    \(dqlease\-database\(dq: {
        // بک‌اند Memfile ساده‌ترین و آسان‌ترین بک‌اند برای استفاده است. این یک [پایگاه داده] درون‌حافظه‌ای
        \(dqtype\(dq: \(dqmemfile\(dq
    },

    // کلاس‌های کلاینت، استخرهای آدرس را با سرورهای خاصی که در ارائه
    // High Availability مشارکت دارند مرتبط می‌کنند.
    \(dqclient\-classes\(dq: [
        // کلاس phones
        {
            \(dqname\(dq: \(dqphones\(dq,
            \(dqtest\(dq: \(dqsubstring(option[60].hex,0,6) == \(aqAastra\(aq\(dq
        },
        // لپ‌تاپ‌ها همه چیز به جز تلفن‌ها هستند.
        {
            \(dqname\(dq: \(dqlaptops\(dq,
            \(dqtest\(dq: \(dqnot member(\(aqphones\(aq)\(dq
        },
        // برخی از تلفن‌ها توسط server1 مدیریت خواهند شد. این که آیا HA_server1
        // یا HA_server2 به کلاینت اختصاص یابد، به عهده load balancing
        // انجام‌شده توسط کتابخانه قلاب HA است.
        {
            \(dqname\(dq: \(dqphones_server1\(dq,
            \(dqtest\(dq: \(dqmember(\(aqphones\(aq) and member(\(aqHA_server1\(aq)\(dq
        },
        // برخی از تلفن‌ها توسط server2 مدیریت خواهند شد.
        {
            \(dqname\(dq: \(dqphones_server2\(dq,
            \(dqtest\(dq: \(dqmember(\(aqphones\(aq) and member(\(aqHA_server2\(aq)\(dq
        },
        // برخی از لپ‌تاپ‌ها توسط server1 مدیریت خواهند شد.
        {
            \(dqname\(dq: \(dqlaptops_server1\(dq,
            \(dqtest\(dq: \(dqmember(\(aqlaptops\(aq) and member(\(aqHA_server1\(aq)\(dq
        },
        // برخی از لپ‌تاپ‌ها توسط server2 مدیریت خواهند شد.
        {
            \(dqname\(dq: \(dqlaptops_server2\(dq,
            \(dqtest\(dq: \(dqmember(\(aqlaptops\(aq) and member(\(aqHA_server2\(aq)\(dq
        }
    ],

    // قابلیت HA نیازمند بارگذاری دو کتابخانه قلاب است: libdhcp_lease_cmds.so و
    // libdhcp_ha.so. اولی به‌روزرسانی‌های ورودی اجاره را از همتایان HA مدیریت می‌کند.
    // دومی قابلیت دسترسی‌پذیری بالا را برای Kea پیاده‌سازی می‌کند.
    \(dqhooks\-libraries\(dq: [
        // کتابخانه lease_cmds باید بارگذاری شود زیرا HA از آن برای تحویل
        // به‌روزرسانی‌های اجاره به سرور و همچنین همگام‌سازی پایگاه داده اجاره
        // پس از خرابی استفاده می‌کند.
        {
            \(dqlibrary\(dq: \(dqlibdhcp_lease_cmds.so\(dq,
            \(dqparameters\(dq: { }
        },
        {
            // کتابخانه قلاب HA باید بارگذاری شود.
            \(dqlibrary\(dq: \(dqlibdhcp_ha.so\(dq,
            \(dqparameters\(dq: {
                // پیکربندی High Availability برای کتابخانه قلاب HA مشخص می‌شود.
                // هر سرور باید پیکربندی HA یکسانی داشته باشد، به جز پارامتر
                // \(dqthis\-server\-name\(dq.
                \(dqhigh\-availability\(dq: [ {
                    // این پارامتر به این نمونه سرور اشاره می‌کند. همتایان HA مربوطه
                    // باید این پارامتر را روی نام‌های خود تنظیم کنند.
                    \(dqthis\-server\-name\(dq: \(dqserver1\(dq,
                    // حالت HA روی load\-balancing تنظیم شده است. در این حالت، سرورهای
                    // فعال ترافیک را به اشتراک می‌گذارند (50/50).
                    \(dqmode\(dq: \(dqload\-balancing\(dq,
                    // در صورتی که هیچ دستور کنترلی دیگری ارسال نشود، ضربان قلب (Heartbeat)
                    // باید هر 10 ثانیه یک‌بار فرستاده شود.
                    \(dqheartbeat\-delay\(dq: 10000,
                    // بیشینه زمان برای پاسخ شریک به یک ضربان قلب، که پس از آن
                    // تشخیص خرابی آغاز می‌شود. این مقدار بر حسب میلی‌ثانیه مشخص می‌شود.
                    \(dqmax\-response\-delay\(dq: 60000,
                    // پارامترهای زیر نحوه تشخیص خرابی شریک توسط سرور را کنترل می‌کنند.
                    // تاخیر ACK آستانه‌ای را برای فیلد \(aqsecs\(aq در discovers دریافتی
                    // تعیین می‌کند. این مقدار بر حسب میلی‌ثانیه مشخص می‌شود.
                    \(dqmax\-ack\-delay\(dq: 5000,
                    // این گزینه تعداد کلاینت‌هایی را مشخص می‌کند که پیام‌هایی به شریک
                    // ارسال می‌کنند اما به نظر می‌رسد هیچ پاسخی دریافت نمی‌کنند.
                    \(dqmax\-unacked\-clients\(dq: 5,
                    // این گزینه بیشینه مهلت زمانی (بر حسب میلی‌ثانیه) را برای سرور جهت
                    // تکمیل همگام‌سازی مشخص می‌کند. اگر استقرار بزرگی دارید (ده‌ها یا
                    // صدها هزار کلاینت)، ممکن است نیاز باشد آن را بیشتر افزایش دهید.
                    // مقدار پیش‌فرض 60000 میلی‌ثانیه (60 ثانیه) است.
                    \(dqsync\-timeout\(dq: 60000,
                    // برای جلوگیری از افت کارایی زمانی که سرور Kea در حال پردازش بسته‌ها روی
                    // چندین نخ است، ماژول High Availability باید چندنخی فعال داشته باشد.
                    \(dqmulti\-threading\(dq: {
                        // فعال‌سازی High Availability برای بهره‌مندی از چندنخی. پیش‌فرض: true.
                        \(dqenable\-multi\-threading\(dq: true,
                        // هنگام اجرا در حالت MT، شنونده اختصاصی برای مدیریت به‌روزرسانی‌های اجاره استفاده می‌شود.
                        \(dqhttp\-dedicated\-listener\(dq: true,
                        // تعداد نخ‌های مورد استفاده برای مدیریت درخواست‌های ورودی.
                        // مقدار 0 به سرور دستور می‌دهد از همان تعداد نخ‌هایی استفاده کند
                        // که هسته Kea برای چندنخی DHCP استفاده می‌کند.
                        \(dqhttp\-listener\-threads\(dq: 0,
                        // تعداد نخ‌های مورد استفاده برای مدیریت درخواست‌های خروجی.
                        // مقدار 0 به سرور دستور می‌دهد از همان تعداد نخ‌هایی استفاده کند
                        // که هسته Kea برای چندنخی DHCP استفاده می‌کند.
                        \(dqhttp\-client\-threads\(dq: 0
                    },
                    \(dqpeers\(dq: [
                        // این پیکربندیِ این نمونه سرور است.
                        {
                            \(dqname\(dq: \(dqserver1\(dq,
                            // این گزینه URL این نمونه سرور را مشخص می‌کند.
                            \(dqurl\(dq: \(dqhttp://192.168.56.33:8005/\(dq,
                            // تکیه‌گاه اعتماد (Trust anchor) معروف به فایل یا پوشه مرجع گواهی (CA).
                            \(dqtrust\-anchor\(dq: \(dq/usr/lib/kea/CA.pem\(dq,
                            // نام فایل گواهی کلاینت.
                            \(dqcert\-file\(dq: \(dq/usr/lib/kea/server1_cert.pem\(dq,
                            // نام فایل کلید خصوصی.
                            \(dqkey\-file\(dq: \(dq/usr/lib/kea/server1_key.pem\(dq,
                            // گواهی‌های کلاینت الزامی بوده و تایید می‌شوند.
                            \(dqrequire\-client\-certs\(dq: true,
                            // این سرور primary است. سرور دیگر باید
                            // secondary باشد.
                            \(dqrole\(dq: \(dqprimary\(dq
                        },
                        // این پیکربندی همتای HA است.
                        {
                            \(dqname\(dq: \(dqserver2\(dq,
                            // نشانی URL را مشخص می‌کند که کانال کنترلی
                            // شریک در آن قابل دسترس است.
                            \(dqurl\(dq: \(dqhttp://192.168.56.66:8005/\(dq,
                            // تکیه‌گاه اعتماد (Trust anchor) معروف به فایل یا پوشه مرجع گواهی (CA).
                            \(dqtrust\-anchor\(dq: \(dq/usr/lib/kea/CA.pem\(dq,
                            // نام فایل گواهی کلاینت.
                            \(dqcert\-file\(dq: \(dq/usr/lib/kea/server2_cert.pem\(dq,
                            // نام فایل کلید خصوصی.
                            \(dqkey\-file\(dq: \(dq/usr/lib/kea/server2_key.pem\(dq,
                            // گواهی‌های کلاینت الزامی بوده و تایید می‌شوند.
                            \(dqrequire\-client\-certs\(dq: true,
                            // شریک، secondary است. این سرور primary است.
                            \(dqrole\(dq: \(dqsecondary\(dq
                        }
                    ]
                } ]
            }
        }
    ],

    // این مثال شامل تعریف یک زیرشبکه تکی است.
    \(dqsubnet4\(dq: [
        {
            // شناسه زیرشبکه.
            \(dqid\(dq: 1,

            // پیشوند زیرشبکه.
            \(dqsubnet\(dq: \(dq192.0.3.0/24\(dq,

            // مشخص کردن چهار استخر آدرس.
            \(dqpools\(dq: [
                {
                    \(dqpool\(dq: \(dq192.0.3.100 \- 192.0.3.125\(dq,
                    \(dqclient\-classes\(dq: [ \(dqphones_server1\(dq ]
                },
                {
                    \(dqpool\(dq: \(dq192.0.3.126 \- 192.0.3.150\(dq,
                    \(dqclient\-classes\(dq: [ \(dqlaptops_server1\(dq ]
                },
                {
                    \(dqpool\(dq: \(dq192.0.3.200 \- 192.0.3.225\(dq,
                    \(dqclient\-classes\(dq: [ \(dqphones_server2\(dq ]
                },
                {
                    \(dqpool\(dq: \(dq192.0.3.226 \- 192.0.3.250\(dq,
                    \(dqclient\-classes\(dq: [ \(dqlaptops_server2\(dq ]
                }
            ],

            // این‌ها گزینه‌های مخصوص زیرشبکه هستند. در بیشتر موارد،
            // باید دست‌کم گزینه routers را تعریف کنید، زیرا بدون این
            // گزینه، کلاینت‌های شما قادر به دسترسی به درگاه پیش‌فرض خود
            // نبوده و اتصال به اینترنت نخواهند داشت.
            \(dqoption\-data\(dq: [
                {
                    // برای هر زیرشبکه IPv4 به احتمال زیاد باید دست‌کم
                    // یک مسیریاب مشخص کنید.
                    \(dqname\(dq: \(dqrouters\(dq,
                    \(dqdata\(dq: \(dq192.0.3.1\(dq
                }
            ],

            // این زیرشبکه برای پرس‌وجوهای ارسالی از آدرس IP زیر
            // انتخاب خواهد شد.
            \(dqrelay\(dq: { \(dqip\-addresses\(dq: [ \(dq192.168.56.1\(dq ] }
        }
    ],

// بخش زیر گزارش‌گیری را پیکربندی می‌کند. فرض بر این است که پیام‌ها با
// دست‌کم سطح اطلاعاتی (info، warn، error و fatal) باید در
// stdout ثبت شوند. همچنین، می‌توانید stderr، یک نام فایل یا
// \(aqsyslog\(aq را اینجا مشخص کنید که پیام‌های خروجی را از طریق syslog ذخیره می‌کند.
    \(dqloggers\(dq: [
        {
            // این بخش بر kea\-dhcp4 اثر می‌گذارد، که ثبت‌کننده پایه برای مؤلفه
            // DHCPv4 است. این بخش به سرور DHCPv4 می‌گوید که تمام پیام‌های گزارش
            // (با سطح اهمیت INFO یا بالاتر) را در یک فایل بنویسد.
            \(dqname\(dq: \(dqkea\-dhcp4\(dq,
            \(dqoutput\-options\(dq: [
                {
                    \(dqoutput\(dq: \(dqstdout\(dq
                }
            ],
            \(dqseverity\(dq: \(dqINFO\(dq,
            \(dqdebuglevel\(dq: 0
        },
        {
            // این بخش پیکربندی ثبت‌کننده اختصاصی کتابخانه قلاب HA را
            // مشخص می‌کند.
            \(dqname\(dq: \(dqkea\-dhcp4.ha\-hooks\(dq,
            \(dqoutput\-options\(dq: [
                {
                    \(dqoutput\(dq: \(dqstdout\(dq
                }
            ],
            \(dqseverity\(dq: \(dqINFO\(dq,
            \(dqdebuglevel\(dq: 99
        }
    ]
}
}
.EE
.UNINDENT
.UNINDENT.SS kea4/ha\-load\-balancing\-server2\-mt.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک پیکربندی نمونه از سرور Kea DHCPv4 است. این پیکربندی از کتابخانه
// قلاب High Availability و کتابخانه قلاب Lease Commands برای فعال‌سازی
// قابلیت دسترسی‌پذیری بالا (High Availability) در سرور DHCP استفاده می‌کند.
// توجه داشته باشید که تقریباً دقیقاً همین پیکربندی باید در سرور دوم (همتا/partner)
// نیز استفاده شود. تنها تفاوت این است که \(dqthis\-server\-name\(dq در آن سرور
// دیگر باید روی \(dqserver1\(dq تنظیم شود. همچنین، پیکربندی رابط به تنظیمات
// شبکه آن ماشین خاص بستگی دارد.
//
// سرورهایی که از این پیکربندی استفاده می‌کنند در حالت توازن بار (load balancing) کار می‌کنند.
{

// پیکربندی DHCPv4 از اینجا آغاز می‌شود.
\(dqDhcp4\(dq: {
    // نام‌های رابط‌های شبکه خود را برای شنود اضافه کنید.
    \(dqinterfaces\-config\(dq: {
        // سرور DHCPv4 روی این رابط شنود می‌کند.
        \(dqinterfaces\(dq: [ \(dqeth0\(dq ]
    },

    // پارامترهای چندریسمانی (Multi\-threading).
    \(dqmulti\-threading\(dq: {
        // به‌طور پیش‌فرض، Kea در صورت پشتیبانی سخت‌افزار، بسته‌ها را روی چندین ریسمان پردازش می‌کند.
        \(dqenable\-multi\-threading\(dq: true,

        // هنگامی که چندریسمانی فعال باشد، Kea بسته‌ها را روی تعدادی ریسمان
        // پردازش می‌کند که از طریق این گزینه قابل‌پیکربندی است.
        \(dqthread\-pool\-size\(dq: 4,

        // هنگامی که چندریسمانی فعال باشد، Kea بسته‌ها را از رابط می‌خواند
        // و یک مورد کاری به استخر ریسمان‌ها می‌افزاید. این گزینه
        // بیشینه تعداد مواردی را که می‌توان در صف قرار داد پیکربندی می‌کند.
        \(dqpacket\-queue\-size\(dq: 64
    },

    // استفاده از پشتیبان پایگاه‌داده اجاره Memfile برای ذخیره اجاره‌ها در یک فایل CSV.
    // بسته به نحوه کامپایل Kea، ممکن است از پایگاه‌های داده SQL
    // (مانند MySQL و/یا PostgreSQL) نیز پشتیبانی کند. این پشتیبان‌های پایگاه‌داده به پارامترهای
    // بیشتری مانند name، host و احتمالاً user و password نیاز دارند.
    // نمونه‌های اختصاصی برای هر پشتیبان وجود دارد. برای جزئیات به بخش 7.2.2 \(dqLease
    // Storage\(dq مراجعه کنید.
    \(dqlease\-database\(dq: {
        // پشتیبان Memfile ساده‌ترین و راحت‌ترین گزینه برای استفاده است. این یک پشتیبان درون‌حافظه‌ای
        \(dqtype\(dq: \(dqmemfile\(dq
    },

    // کلاس‌های کلاینت، استخرهای آدرس را با سرورهای خاصی که در ارائه
    // High Availability مشارکت دارند مرتبط می‌کنند.
    \(dqclient\-classes\(dq: [
        // کلاس phones
        {
            \(dqname\(dq: \(dqphones\(dq,
            \(dqtest\(dq: \(dqsubstring(option[60].hex,0,6) == \(aqAastra\(aq\(dq
        },
        // لپ‌تاپ‌ها همه چیز هستند به جز تلفن‌ها.
        {
            \(dqname\(dq: \(dqlaptops\(dq,
            \(dqtest\(dq: \(dqnot member(\(aqphones\(aq)\(dq
        },
        // برخی از تلفن‌ها توسط server1 مدیریت خواهند شد. این که HA_server1
        // یا HA_server2 به کلاینت اختصاص یابد، مربوط به توازن بار
        // (load balancing) انجام‌شده توسط کتابخانه قلاب HA است.
        {
            \(dqname\(dq: \(dqphones_server1\(dq,
            \(dqtest\(dq: \(dqmember(\(aqphones\(aq) and member(\(aqHA_server1\(aq)\(dq
        },
        // برخی از تلفن‌ها توسط server2 مدیریت خواهند شد.
        {
            \(dqname\(dq: \(dqphones_server2\(dq,
            \(dqtest\(dq: \(dqmember(\(aqphones\(aq) and member(\(aqHA_server2\(aq)\(dq
        },
        // برخی از لپ‌تاپ‌ها توسط server1 مدیریت خواهند شد.
        {
            \(dqname\(dq: \(dqlaptops_server1\(dq,
            \(dqtest\(dq: \(dqmember(\(aqlaptops\(aq) and member(\(aqHA_server1\(aq)\(dq
        },
        // برخی از لپ‌تاپ‌ها توسط server2 مدیریت خواهند شد.
        {
            \(dqname\(dq: \(dqlaptops_server2\(dq,
            \(dqtest\(dq: \(dqmember(\(aqlaptops\(aq) and member(\(aqHA_server2\(aq)\(dq
        }
    ],

    // قابلیت HA نیازمند بارگذاری دو کتابخانه قلاب است: libdhcp_lease_cmds.so و
    // libdhcp_ha.so. اولی به‌روزرسانی‌های دریافتی اجاره را از همتایان HA مدیریت می‌کند.
    // دومی قابلیت دسترسی‌پذیری بالا را برای Kea پیاده‌سازی می‌کند.
    \(dqhooks\-libraries\(dq: [
        // کتابخانه lease_cmds باید بارگذاری شود زیرا HA از آن برای تحویل
        // به‌روزرسانی‌های اجاره به سرور و همچنین همگام‌سازی پایگاه‌داده
        // اجاره پس از خرابی استفاده می‌کند.
        {
            \(dqlibrary\(dq: \(dqlibdhcp_lease_cmds.so\(dq,
            \(dqparameters\(dq: { }
        },
        {
            // کتابخانه قلاب HA باید بارگذاری شود.
            \(dqlibrary\(dq: \(dqlibdhcp_ha.so\(dq,
            \(dqparameters\(dq: {
                // پیکربندی High Availability برای کتابخانه قلاب HA مشخص شده است.
                // هر سرور باید پیکربندی HA یکسانی داشته باشد، به جز
                // پارامتر \(dqthis\-server\-name\(dq.
                \(dqhigh\-availability\(dq: [ {
                    // این پارامتر به این نمونه سرور اشاره می‌کند. همتایان مربوطه
                    // HA باید این پارامتر را روی نام‌های خود تنظیم کنند.
                    \(dqthis\-server\-name\(dq: \(dqserver2\(dq,
                    // حالت HA روی load\-balancing تنظیم شده است. در این حالت، سرورهای
                    // فعال ترافیک را به اشتراک می‌گذارند (50/50).
                    \(dqmode\(dq: \(dqload\-balancing\(dq,
                    // در صورتی که هیچ دستور کنترلی دیگری منتقل نشود، ضربان قلب (heartbeat)
                    // باید هر ۱۰ ثانیه یک بار ارسال شود.
                    \(dqheartbeat\-delay\(dq: 10000,
                    // حداکثر زمان برای پاسخ شریک به ضربان قلب، که پس از آن
                    // تشخیص خرابی آغاز می‌شود. این مقدار به میلی‌ثانیه مشخص شده است.
                    \(dqmax\-response\-delay\(dq: 60000,
                    // پارامترهای زیر نحوه تشخیص خرابی شریک توسط سرور را کنترل می‌کنند.
                    // تأخیر ACK آستانه را برای فیلد \(aqsecs\(aq در پیام‌های discover
                    // دریافتی تنظیم می‌کند. این مقدار به میلی‌ثانیه مشخص شده است.
                    \(dqmax\-ack\-delay\(dq: 5000,
                    // این پارامتر تعداد کلاینت‌هایی را مشخص می‌کند که به شریک
                    // پیام ارسال می‌کنند اما به نظر می‌رسد پاسخی دریافت نمی‌کنند.
                    \(dqmax\-unacked\-clients\(dq: 5,
                    // این پارامتر بیشینه مهلت زمانی (به میلی‌ثانیه) را برای تکمیل همگام‌سازی توسط
                    // سرور مشخص می‌کند. اگر استقرار بزرگی دارید (چندین ده یا صدها
                    // هزار کلاینت)، ممکن است نیاز به افزایش بیشتر آن داشته باشید.
                    // مقدار پیش‌فرض 60000ms (۶۰ ثانیه) است.
                    \(dqsync\-timeout\(dq: 60000,
                    // برای جلوگیری از افت کارایی در زمانی که سرور Kea بسته‌ها را
                    // روی چندین ریسمان پردازش می‌کند، ماژول High Availability باید
                    // قابلیت چندریسمانی را فعال کرده باشد.
                    \(dqmulti\-threading\(dq: {
                        // فعال‌سازی High Availability برای بهره‌مندی از چندریسمانی. پیش‌فرض: true.
                        \(dqenable\-multi\-threading\(dq: true,
                        // هنگام اجرا در حالت MT، از شنونده اختصاصی برای مدیریت
                        // به‌روزرسانی‌های اجاره استفاده می‌شود.
                        \(dqhttp\-dedicated\-listener\(dq: true,
                        // تعداد ریسمان‌های مورد استفاده برای رسیدگی به درخواست‌های ورودی.
                        // مقدار 0 به سرور دستور می‌دهد از همان تعداد ریسمانی استفاده کند
                        // که هسته Kea برای چندریسمانی DHCP استفاده می‌کند.
                        \(dqhttp\-listener\-threads\(dq: 0,
                        // تعداد ریسمان‌های مورد استفاده برای رسیدگی به درخواست‌های خروجی.
                        // مقدار 0 به سرور دستور می‌دهد از همان تعداد ریسمانی استفاده کند
                        // که هسته Kea برای چندریسمانی DHCP استفاده می‌کند.
                        \(dqhttp\-client\-threads\(dq: 0
                    },
                    \(dqpeers\(dq: [
                        // این پیکربندی همتای HA است.
                        {
                            \(dqname\(dq: \(dqserver1\(dq,
                            // نشانی URL را مشخص می‌کند که کانال کنترلی
                            // شریک روی آن در دسترس است.
                            \(dqurl\(dq: \(dqhttp://192.168.56.33:8005/\(dq,
                            // شریک، اولیه (primary) است. این سرور ثانویه (secondary) است.
                            \(dqrole\(dq: \(dqprimary\(dq
                        },
                        // این پیکربندی این نمونه سرور است.
                        {
                            \(dqname\(dq: \(dqserver2\(dq,
                            // این گزینه نشانی URL این نمونه سرور را مشخص می‌کند.
                            \(dqurl\(dq: \(dqhttp://192.168.56.66:8005/\(dq,
                            // این سرور ثانویه است. سرور دیگر باید
                            // اولیه باشد.
                            \(dqrole\(dq: \(dqsecondary\(dq
                        }
                    ]
                } ]
            }
        }
    ],

    // این نمونه شامل اعلان یک زیرشبکه تکی است.
    \(dqsubnet4\(dq: [
        {
            // شناسه زیرشبکه.
            \(dqid\(dq: 1,

            // پیشوند زیرشبکه.
            \(dqsubnet\(dq: \(dq192.0.3.0/24\(dq,

            // تعیین چهار استخر آدرس.
            \(dqpools\(dq: [
                {
                    \(dqpool\(dq: \(dq192.0.3.100 \- 192.0.3.125\(dq,
                    \(dqclient\-classes\(dq: [ \(dqphones_server1\(dq ]
                },
                {
                    \(dqpool\(dq: \(dq192.0.3.126 \- 192.0.3.150\(dq,
                    \(dqclient\-classes\(dq: [ \(dqlaptops_server1\(dq ]
                },
                {
                    \(dqpool\(dq: \(dq192.0.3.200 \- 192.0.3.225\(dq,
                    \(dqclient\-classes\(dq: [ \(dqphones_server2\(dq ]
                },
                {
                    \(dqpool\(dq: \(dq192.0.3.226 \- 192.0.3.250\(dq,
                    \(dqclient\-classes\(dq: [ \(dqlaptops_server2\(dq ]
                }
            ],

            // این‌ها گزینه‌های ویژه‌ی زیرشبکه هستند. در بیشتر موارد،
            // باید دست‌کم گزینه routers را تعریف کنید، زیرا بدون این
            // گزینه، کلاینت‌های شما قادر به دسترسی به دروازه پیش‌فرض خود
            // نبوده و اتصال اینترنت نخواهند داشت.
            \(dqoption\-data\(dq: [
                {
                    // برای هر زیرشبکه IPv4 به احتمال زیاد باید دست‌کم
                    // یک مسیریاب مشخص کنید.
                    \(dqname\(dq: \(dqrouters\(dq,
                    \(dqdata\(dq: \(dq192.0.3.1\(dq
                }
            ],

            // این زیرشبکه برای پرس‌وجوهایی که از آدرس IP زیر می‌آیند
            // انتخاب خواهد شد.
            \(dqrelay\(dq: { \(dqip\-addresses\(dq: [ \(dq192.168.56.1\(dq ] }
        }
    ],

// بخش زیر گزارش‌گیری را پیکربندی می‌کند. فرض بر این است که پیام‌های با
// دست‌کم سطح اطلاعاتی (info، warn، error و fatal) باید در
// stdout ثبت شوند. در غیر این صورت، می‌توانید stderr، نام یک فایل
// یا \(aqsyslog\(aq را مشخص کنید که پیام‌های خروجی را از طریق syslog ذخیره می‌کند.
    \(dqloggers\(dq: [
        {
            // این بخش بر kea\-dhcp4 تأثیر می‌گذارد که گزارش‌گیر پایه برای مؤلفه
            // DHCPv4 است. این بخش به سرور DHCPv4 می‌گوید که تمام پیام‌های گزارش را
            // (با سطح بحرانی INFO یا بیشتر) در یک فایل بنویسد.
            \(dqname\(dq: \(dqkea\-dhcp4\(dq,
            \(dqoutput\-options\(dq: [
                {
                    \(dqoutput\(dq: \(dqstdout\(dq
                }
            ],
            \(dqseverity\(dq: \(dqINFO\(dq,
            \(dqdebuglevel\(dq: 0
        },
        {
            // این بخش پیکربندی گزارش‌گیر مخصوص کتابخانه قلاب HA را
            // مشخص می‌کند.
            \(dqname\(dq: \(dqkea\-dhcp4.ha\-hooks\(dq,
            \(dqoutput\-options\(dq: [
                {
                    \(dqoutput\(dq: \(dqstdout\(dq
                }
            ],
            \(dqseverity\(dq: \(dqINFO\(dq,
            \(dqdebuglevel\(dq: 99
        }
    ]
}
}
.EE
.UNINDENT
.UNINDENT.SS kea4/hooks\-radius.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک فایل پیکربندی نمونه برای کارساز DHCPv4 در Kea است
// که پیکربندی کتابخانه‌های قلاب RADIUS و Host Cache را شرح می‌دهد.
//
// این فایل برای استفاده به‌صورت مستقیم در نظر گرفته نشده است. بلکه تلاش می‌کند برخی از
// پارامترهای موجود را نمایش دهد.
//
// برای استفاده از این فایل پیکربندی، باید هر دو قلاب RADIUS و
// Host Cache را داشته باشید.
//
// کلاینت‌ها یک نام شراب (گزینه AOP با کد 250) دریافت می‌کنند که به قرمز و سفید تقسیم می‌شوند.
// برندهای گران‌قیمت دارای یک مدخل میزبان هستند، یعنی یک نشانی رزرو شده.
//
// نام‌ها
//
// brouilly (قرمز)
// chablis (سفید)
// chambertin (قرمز، گران‌قیمت)
// chinon (قرمز)
// chiroubles (قرمز)
// condrieu (سفید)
// cornas (قرمز)
// corton (قرمز)
// fleurie (قرمز)
// givry (قرمز)
// margaux (قرمز، گران‌قیمت)
// meursault (سفید)
// montrachet (سفید، گران‌قیمت)
// morgon (قرمز)
// muscadet (سفید)
// petrus (قرمز، گران‌قیمت)
// riesling (سفید)
// romanee (قرمز، گران‌قیمت)
// sylvaner (سفید)
// yquem (سفید، گران‌قیمت)
//
// فضای نشانی 192.0.2.0/24 است، با 10\-99 برای قرمزها و 110\-199 برای سفیدها.
//
// رزروها در اینجا به سبک Kea/JSON آورده شده‌اند اما باید
// در پیکربندی کارساز RADIUS قرار گیرند:
//
//       {
//          \(dqflex\-id\(dq: \(dq\(aqchambertin\(aq\(dq,
//          \(dqip\-address\(dq: \(dq192.0.2.10\(dq
//       },
//       {
//          \(dqflex\-id\(dq: \(dq\(aqmargaux\(aq\(dq,
//          \(dqip\-address\(dq: \(dq192.0.2.11\(dq
//       },
//       {
//          \(dqflex\-id\(dq: \(dq\(aqpetrus\(aq\(dq,
//          \(dqip\-address\(dq: \(dq192.0.2.12\(dq
//       },
//       {
//          \(dqflex\-id\(dq: \(dq\(aqromanee\(aq\(dq,
//          \(dqip\-address\(dq: \(dq192.0.2.13\(dq
//       },
//       {
//          \(dqflex\-id\(dq: \(dq\(aqmontrachet\(aq\(dq,
//          \(dqip\-address\(dq: \(dq192.0.2.110\(dq
//       },
//       {
//          \(dqflex\-id\(dq: \(dq\(aqyquem\(aq\(dq,
//          \(dqip\-address\(dq: \(dq192.0.2.111\(dq
//       }
//

{\(dqDhcp4\(dq:

{
  // به Kea گفته می‌شود که فقط روی رابط‌های مشخصی شنود کند.
  \(dqinterfaces\-config\(dq: {
    // احتمالاً باید رابط‌های شبکه خود را در اینجا فهرست کنید (مانند \(dqeth1961\(dq)
    \(dqinterfaces\(dq: [ \(dqeth1961\(dq ]
  },

  // برپاسازی فضای ذخیره‌سازی برای اجاره‌ها (leases).
  \(dqlease\-database\(dq: {
    \(dqtype\(dq: \(dqmemfile\(dq
  },

  // توجه کنید که هیچ hosts\-databaseای تعریف نشده است. کتابخانه‌های RADIUS و Host Cache
  // آن‌ها را به‌طور پویا ایجاد خواهند کرد.

  // از آنجا که RADIUS از رزروهای flex\-id استفاده می‌کند، Kea را فقط به استفاده از flex\-id محدود کنید.
  \(dqhost\-reservation\-identifiers\(dq: [ \(dqflex\-id\(dq ],

  // تعریف گزینه AOP.
  \(dqoption\-def\(dq: [ {
      \(dqname\(dq: \(dqAOP\(dq,
      \(dqcode\(dq: 250,
      \(dqtype\(dq: \(dqstring\(dq } ],

  // تعریف کلاس‌های کلاینت قرمز و سفید.
  // اگر تعریف نشوند ممکن است هشدارهای کاذب دریافت کنیم.
  \(dqclient\-classes\(dq: [
      { \(dqname\(dq: \(dqred\(dq },
      { \(dqname\(dq: \(dqwhite\(dq } ],

  // تعریف یک زیرشبکه.
  \(dqsubnet4\(dq: [ {
      // تنظیم شناسه زیرشبکه (یا همان پورت RADIUS NAS).
      \(dqid\(dq: 14,
      \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
      \(dqinterface\(dq: \(dqeth1961\(dq,
      \(dqpools\(dq: [
         {
            // استخر قرمز (10\-19 برای رزروها هستند)
            \(dqpool\(dq: \(dq192.0.2.20\-192.0.2.99\(dq,
            \(dqclient\-classes\(dq: [ \(dqred\(dq ]
         },
         {
            // استخر سفید (110\-119 برای رزروها هستند)
            \(dqpool\(dq: \(dq192.0.2.120\-192.0.2.199\(dq,
            \(dqclient\-classes\(dq: [ \(dqwhite\(dq ]
         }

          // توجه داشته باشید که هیچ استخری برای استفاده همگان در دسترس نیست. این نکته
          // مهمی است. بدین معنی که برای دریافت نشانی، کلاینت باید متعلق به کلاس قرمز،
          // کلاس سفید بوده و یا نشانی رزرو شده داشته باشد.
      ]
    } ],

  // برپاسازی کتابخانه‌های قلاب.
  \(dqhooks\-libraries\(dq: [
     {
        // بارگذاری کتابخانه قلاب flex\-id.
        \(dqlibrary\(dq: \(dqlibdhcp_flex_id.so\(dq,

        \(dqparameters\(dq: {
            // دریافت شناسه از گزینه AOP.
            \(dqidentifier\-expression\(dq: \(dqoption[250].text\(dq,

            // جایگزینی شناسه کلاینت در پرس‌وجوها با flex\-id.
            // در حال حاضر توسط کد دسترسی الزامی است.
            // برای حسابرسی نیز لازم است زیرا به شناسه اجاره هم تبدیل می‌شود.
            \(dqreplace\-client\-id\(dq: true
        }
     },
     {
         // بارگذاری کتابخانه قلاب host cache. این کتابخانه برای کتابخانه RADIUS
         // مورد نیاز است تا مشخصه‌ها را از مرحله احراز هویت برای استفاده بعدی
         // در حسابرسی نگه دارد.
         \(dqlibrary\(dq: \(dqlibdhcp_host_cache.so\(dq
     },
     {
         // بارگذاری کتابخانه قلاب RADIUS.
         \(dqlibrary\(dq: \(dqlibdhcp_radius.so\(dq,

         \(dqparameters\(dq: {
             // در صورت عدم استفاده از RFC 4361
             // \(dqextract\-duid\(dq: false,

             // در صورت وجود زیرشبکه‌های دارای تداخل
             // \(dqreselect\-subnet\-pool\(dq: true,

             // حذف نوع 0 اضافه شده توسط flex\-id
             \(dqclient\-id\-pop0\(dq: true,

             // شناسه flex قابل چاپ باشد (برای پیکربندی کارساز RADIUS بسیار ساده‌تر است)
             // بدون این گزینه، به صورت هگزادسیمال خواهد بود...
             \(dqclient\-id\-printable\(dq: true,

             // استفاده از flex\-id.
             \(dqidentifier\-type4\(dq: \(dqflex\-id\(dq,

             // پیکربندی یک کارساز دسترسی (یا همان احراز هویت/مجوزدهی).
             \(dqaccess\(dq: {

                 // این بخش فهرست کارسازهای دسترسی را آغاز می‌کند
                 \(dqservers\(dq: [
                     {
                         // این‌ها پارامترهای اولین (و تنها) کارساز دسترسی هستند
                         \(dqname\(dq: \(dq127.0.0.1\(dq,
                         \(dqport\(dq: 1812,
                         \(dqsecret\(dq: \(dq1234\(dq
                     }
                     // کارسازهای دسترسی دیگر را می‌توان در اینجا مشخص کرد
                 ],

                 // این بخش فهرستی از مشخصه‌های اضافی را تعریف می‌کند که Kea در Access\-Request
                 // به هر کارساز دسترسی ارسال خواهد کرد.
                 \(dqattributes\(dq: [
                 {
                     // این مشخصه با نام شناسایی می‌شود (باید در فرهنگ لغت موجود باشد)
                     // و دارای مقدار ایستا است (یعنی مقدار یکسانی برای هر بسته به تمام
                     // کارسازها ارسال خواهد شد)
                     \(dqname\(dq: \(dqPassword\(dq,
                     \(dqdata\(dq: \(dqmysecretpassword\(dq
                 },
                 {
                     // همچنین امکان تعیین یک مشخصه با استفاده از نوع آن به جای نام وجود دارد.
                     // نوع 77 همان Connect\-Info است. مقدار با استفاده از hex مشخص شده است.
                     // مجدداً، این یک مقدار ایستا است. این مقدار برای هر بسته و برای هر
                     // کارساز یکسان ارسال خواهد شد.
                     \(dqtype\(dq: 77,
                     \(dqraw\(dq: \(dq65666a6a71\(dq
                 },
                 {
                     // این مثال نشان می‌دهد چگونه می‌توان از یک عبارت برای ارسال مقدار
                     // پویا استفاده کرد. عبارت (بخش ۱۳ را ببینید) ممکن است هر مقداری را از
                     // بسته ورودی یا حتی فراداده آن (مثلاً رابطی که بسته از آن دریافت شده است)
                     // دریافت کند
                     \(dqname\(dq: \(dqConfiguration\-Token\(dq,
                     \(dqexpr\(dq: \(dqpkt.iface\(dq
                 }
                 ] // پایان مشخصه‌ها
              },

             // پیکربندی یک کارساز حسابرسی.
             \(dqaccounting\(dq: {
                 \(dqservers\(dq: [ {
                         \(dqname\(dq: \(dq127.0.0.1\(dq,
                         \(dqport\(dq: 1813,
                         \(dqsecret\(dq: \(dq1234\(dq
                     }
                ]
             }
         }
     }
     ]
}

}
.EE
.UNINDENT
.UNINDENT.SS kea4/hooks\-rbac.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک فایل پیکربندی نمونه برای کارساز DHCPv4 در Kea است که از
// کتابخانه قلاب کنترل دسترسی بر پایه نقش (RBAC) استفاده می‌کند. این پیکربندی از سناریوی
// پایه‌ای یک زیرشبکه IPv4 پیکربندی‌شده با مقادیر پیش‌فرض برای تمام پارامترها استفاده می‌کند.

{\(dqDhcp4\(dq:

{
// به Kea اعلام شده است که تنها روی رابط eth0 شنود کند.
  \(dqinterfaces\-config\(dq: {
    \(dqinterfaces\(dq: [ \(dqeth0\(dq ]
  },

// راه‌اندازی فضای ذخیره‌سازی برای اجاره‌ها.
  \(dqlease\-database\(dq: {
    \(dqtype\(dq: \(dqmemfile\(dq
  },

  \(dqvalid\-lifetime\(dq: 1800,

// تعریف یک زیرشبکه منفرد.
  \(dqsubnet4\(dq: [
    {
      \(dqpools\(dq: [ { \(dqpool\(dq: \(dq192.0.2.1 \- 192.0.2.200\(dq } ],
      \(dqid\(dq: 1,
      \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
      \(dqinterface\(dq: \(dqeth0\(dq
    }
  ],

// سوکت‌های کنترلی.
  \(dqcontrol\-sockets\(dq: [
    {
      \(dqsocket\-type\(dq: \(dqhttps\(dq,
      \(dqsocket\-address\(dq: \(dq127.0.0.1\(dq,
      \(dqsocket\-port\(dq: 8000,
      \(dqtrust\-anchor\(dq: \(dqmy\-ca\(dq,
      \(dqcert\-file\(dq: \(dqmy\-cert\(dq,
      \(dqkey\-file\(dq: \(dqmy\-key\(dq,
      \(dqcert\-required\(dq: true
    }
  ],

// قلاب‌ها را اینجا اضافه کنید.
  \(dqhooks\-libraries\(dq: [
    {
      \(dqlibrary\(dq: \(dqlibdhcp_rbac.so\(dq,
      \(dqparameters\(dq: {
          // این بخش کتابخانه قلاب RBAC را پیکربندی می‌کند.
          // پارامترهای اجباری.
          \(dqassign\-role\-method\(dq: \(dqcert\-subject\(dq,
          \(dqapi\-files\(dq: \(dq/opt/share/kea/api\(dq,
          // پارامترهای اختیاری.
          \(dqrequire\-tls\(dq: true,
          \(dqcommands\(dq: [
          {
              \(dqname\(dq: \(dqmy\-command\(dq,
              \(dqaccess\(dq: \(dqread\(dq,
              \(dqhook\(dq: \(dqmy\-hook\(dq
          } ],
          \(dqaccess\-control\-lists\(dq: [
          {
              \(dqmy\-none\(dq: { \(dqnot\(dq: \(dqALL\(dq }
          },{
              \(dqanother\-none\(dq: { \(dqand\(dq: [ \(dqALL\(dq, \(dqNONE\(dq ] }
          },{
              \(dqmy\-read\(dq: { \(dqaccess\(dq: \(dqread\(dq }
          } ],
          \(dqroles\(dq: [
          {
              \(dqname\(dq: \(dqkea\-client\(dq,
              \(dqaccept\-commands\(dq:
              {
                  \(dqcommands\(dq: [ \(dqlist\-commands\(dq, \(dqstatus\-get\(dq ]
              },
              \(dqreject\-commands\(dq: \(dqNONE\(dq,
              \(dqother\-commands\(dq: \(dqreject\(dq,
              \(dqlist\-match\-first\(dq: \(dqaccept\(dq,
              \(dqresponse\-filters\(dq: [ \(dqlist\-commands\(dq ]
          },{
              \(dqname\(dq: \(dqadmin\(dq,
              \(dqaccept\-commands\(dq: \(dqALL\(dq,
              \(dqreject\-commands\(dq:
              {
                  \(dqhook\(dq: \(dqcb_cmds\(dq
              },
              \(dqlist\-match\-first\(dq: \(dqreject\(dq
          } ],
          \(dqdefault\-role\(dq:
          {
              \(dqaccept\-commands\(dq: \(dqNONE\(dq,
              \(dqreject\-commands\(dq: \(dqALL\(dq
          },
          \(dqunknown\-role\(dq:
          {
              \(dqaccept\-commands\(dq: \(dqREAD\(dq,
              \(dqreject\-commands\(dq: \(dqWRITE\(dq
          }
      }
    }
  ]
}

}
.EE
.UNINDENT
.UNINDENT
.SS kea4/hooks.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک فایل پیکربندی نمونه برای کارساز DHCPv4 در Kea است که
// نحوه پیکربندی کتابخانه‌های قلاب را نمایش می‌دهد. این پیکربندی از سناریوی
// پایه‌ای یک زیرشبکه IPv4 پیکربندی‌شده با مقادیر پیش‌فرض برای تمام پارامترها استفاده می‌کند.

{\(dqDhcp4\(dq:

{
// به Kea اعلام شده است که تنها روی رابط eth0 شنود کند.
  \(dqinterfaces\-config\(dq: {
    \(dqinterfaces\(dq: [ \(dqeth0\(dq ]
  },

// راه‌اندازی فضای ذخیره‌سازی برای اجاره‌ها.
  \(dqlease\-database\(dq: {
    \(dqtype\(dq: \(dqmemfile\(dq
  },

  \(dqvalid\-lifetime\(dq: 1800,

// تعریف یک زیرشبکه منفرد.
  \(dqsubnet4\(dq: [
    {
      \(dqpools\(dq: [ { \(dqpool\(dq: \(dq192.0.2.1 \- 192.0.2.200\(dq } ],
      \(dqid\(dq: 1,
      \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
      \(dqinterface\(dq: \(dqeth0\(dq
    }
  ],

// راه‌اندازی کتابخانه‌های قلاب. برای این مثال، فرض می‌کنیم که دو کتابخانه
// به نام‌های \(dqsecurity\(dq و \(dqcharging\(dq بارگذاری شده‌اند. توجه داشته باشید که ترتیب مهم است:
// ابتدا \(dqsecurity\(dq مشخص شده است، بنابراین اگر هر دو کتابخانه یک تابع قلاب را
// برای یک قلاب معین ارائه دهند، تابع موجود در \(dqsecurity\(dq پیش از تابع موجود در
// \(dqcharging\(dq فراخوانی خواهد شد.

  \(dqhooks\-libraries\(dq: [
     {
        \(dqlibrary\(dq: \(dqsecurity.so\(dq
     },
     {
         \(dqlibrary\(dq: \(dqcharging.so\(dq,
         \(dqparameters\(dq: {
             \(dqpath\(dq: \(dq/var/log/kea\(dq,
             \(dqbase\-name\(dq: \(dqkea\-forensic6\(dq
         }
     }
  ]
}

}
.EE
.UNINDENT
.UNINDENT.SS kea4/leases\-expiration.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک فایل پیکربندی نمونه برای کارگزار DHCPv4 در Kea است.
// این فایل پارامترهای کنترل‌کننده پردازش اجاره‌های منقضی‌شده،
// یا همان بازپس‌گیری اجاره‌ها (leases reclamation) را فراهم می‌کند.

{ \(dqDhcp4\(dq:

{
// به Kea اعلام شده است که فقط روی واسط eth0 شنود کند.
  \(dqinterfaces\-config\(dq: {
    \(dqinterfaces\(dq: [ \(dqeth0\(dq ]
  },

// ما باید پایگاه‌داده مورد استفاده برای ذخیره اجاره‌ها را مشخص کنیم. تا
// ژوئن 2022، سه بک‌اند پایگاه‌داده پشتیبانی می‌شوند: MySQL،
// PostgreSQL و پایگاه‌داده درون‌حافظه‌ای Memfile.
// ما از memfile استفاده می‌کنیم زیرا به هیچ راه‌اندازی اولیه‌ای نیاز ندارد.
// توجه داشته باشید که ما حداکثر تعداد خطاهای خواندن ردیف را روی 100 تنظیم می‌کنیم،
// (پیش‌فرض 0 است، به معنی نامحدود).
  \(dqlease\-database\(dq: {
      \(dqtype\(dq: \(dqmemfile\(dq,
      \(dqlfc\-interval\(dq: 3600,
      \(dqmax\-row\-errors\(dq: 100
  },

// پارامترهای زیر پردازش اجاره‌های منقضی‌شده را کنترل می‌کنند. اجاره‌های
// منقضی‌شده به‌طور دوره‌ای مطابق با پارامتر \(dqreclaim\-timer\-wait\-time\(dq
// بازپس‌گرفته خواهند شد. اجاره‌های بازپس‌گرفته‌شده برای تسهیل وابستگی اجاره
// (lease affinity) به مدت 1800 ثانیه در پایگاه‌داده نگه داشته می‌شوند. پس از این
// دوره، اجاره‌ها حذف خواهند شد. بسامد حذف توسط پارامتر
// \(dqflush\-reclaimed\-timer\-wait\-time\(dq کنترل می‌شود. روال بازپس‌گیری اجاره
// در یک اجرای تکی، حداکثر 500 اجاره را پردازش خواهد کرد یا حداکثر 100 میلی‌ثانیه
// طول خواهد کشید. اگر پس از 10 تلاش همچنان اجاره‌های بازپس‌گرفته‌نشده‌ای باقی مانده
// باشد، یک پیام هشدار صادر می‌شود.
// اگر هر دو پارامتر \(dqflush\-reclaimed\-timer\-wait\-time\(dq و \(dqhold\-reclaimed\-time\(dq
// مخالف 0 باشند، وقتی کلاینت پیام release ارسال کند، اجاره به جای حذف شدن از
// فضای ذخیره‌سازی اجاره‌ها، منقضی می‌شود.
  \(dqexpired\-leases\-processing\(dq: {
    \(dqreclaim\-timer\-wait\-time\(dq: 5,
    \(dqhold\-reclaimed\-time\(dq: 1800,
    \(dqflush\-reclaimed\-timer\-wait\-time\(dq: 10,
    \(dqmax\-reclaim\-leases\(dq: 500,
    \(dqmax\-reclaim\-time\(dq: 100,
    \(dqunwarned\-reclaim\-cycles\(dq: 10
  },

// نشانی‌ها با طول عمر 4000 ثانیه تخصیص داده خواهند شد.
  \(dqvalid\-lifetime\(dq: 4000,

// فهرست زیر زیرشبکه‌ها را تعریف می‌کند. ما اینجا تنها یک زیرشبکه
// داریم. به Kea می‌گوییم که این زیرشبکه مستقیماً روی واسط محلی در دسترس است.
  \(dqsubnet4\(dq: [
    {
       \(dqpools\(dq: [ { \(dqpool\(dq:  \(dq192.0.2.1 \- 192.0.2.200\(dq } ],
       \(dqid\(dq: 1,
       \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
       \(dqinterface\(dq: \(dqeth0\(dq
    }
  ],

// بخش زیر گزارش‌گیری (logging) را پیکربندی می‌کند. فرض بر این است که پیام‌هایی
// با حداقل سطح اطلاعاتی (info، warn، error و fatal) باید در stdout
// ثبت شوند.
    \(dqloggers\(dq: [
        {
            \(dqname\(dq: \(dqkea\-dhcp4\(dq,
            \(dqoutput\-options\(dq: [
                {
                    \(dqoutput\(dq: \(dqstdout\(dq
                }
            ],
            \(dqseverity\(dq: \(dqINFO\(dq
        }
    ]
}

}
.EE
.UNINDENT
.UNINDENT
.SS kea4/multiple\-options.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک فایل پیکربندی نمونه برای کارگزار DHCPv4 در Kea است.
// این فایل پیکربندی ساده گزینه‌ها را برای یک زیرشبکه نشان می‌دهد.

{ \(dqDhcp4\(dq:

{
// به Kea اعلام شده است که فقط روی واسط eth0 شنود کند.
  \(dqinterfaces\-config\(dq: {
    \(dqinterfaces\(dq: [ \(dqeth0\(dq ]
  },

// ما باید پایگاه‌داده مورد استفاده برای ذخیره اجاره‌ها را مشخص کنیم. تا
// ژوئن 2022، سه بک‌اند پایگاه‌داده پشتیبانی می‌شوند: MySQL،
// PostgreSQL و پایگاه‌داده درون‌حافظه‌ای Memfile.
// ما از memfile استفاده می‌کنیم زیرا به هیچ راه‌اندازی اولیه‌ای نیاز ندارد.
  \(dqlease\-database\(dq: {
    \(dqtype\(dq: \(dqmemfile\(dq
  },

// نشانی‌ها با طول عمر 4000 ثانیه تخصیص داده خواهند شد.
  \(dqvalid\-lifetime\(dq: 4000,

// زمان‌سنج‌های تجدید (renew) و پیوند مجدد (rebind) کامنت شده‌اند. این بدان معناست
// که گزینه‌های 58 و 59 به کلاینت ارسال نخواهند شد. در این حالت انتخاب مقادیر زمان‌سنج
// طبق RFC2131 بر عهده کلاینت است. برای ارسال این گزینه‌ها به کلاینت، زمان‌سنج‌ها را از
// حالت کامنت خارج کنید.
//  \(dqrenew\-timer\(dq: 1000,
//  \(dqrebind\-timer\(dq: 2000,

// تعریف یک زیرشبکه. چند گزینه DHCP وجود دارد که به کلاینت‌های متصل
// به این زیرشبکه بازگردانده می‌شوند. دو گزینه اول با نام مشخص شده‌اند.
// گزینه سوم با کد گزینه (option code) مشخص شده است.
// یک استخر نشانی درون این زیرشبکه تعریف شده است. مقدار اختصاصی
// استخر برای گزینه domain\-name\-servers برای این استخر تعریف شده است.
  \(dqsubnet4\(dq: [
    {
       \(dqid\(dq: 1,
       \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
       \(dqoption\-data\(dq: [
            // هنگام تعیین گزینه‌ها، معمولاً باید یکی از (name یا code) و data را
            // مشخص کنید. مشخصات کامل گزینه شامل name، code، space، csv\-format و data است.
            // مقدار پیش‌فرض space برابر \(dqdhcp4\(dq است که معمولاً درست است، مگر اینکه از
            // گزینه‌های کپسوله‌شده استفاده کنید. مقدار پیش‌فرض csv\-format برابر \(dqtrue\(dq است، بنابراین
            // این نیز درست است، مگر اینکه بخواهید کل مقدار گزینه را به‌صورت یک رشته هگزادسیمال طولانی
            // مشخص کنید. برای نمونه، برای تعیین domain\-name\-servers می‌توانید این کار را انجام دهید:
            // {
            //     \(dqname\(dq: \(dqdomain\-name\-servers\(dq,
            //     \(dqcode\(dq: 6,
            //     \(dqcsv\-format\(dq: true,
            //     \(dqspace\(dq: \(dqdhcp4\(dq,
            //     \(dqdata\(dq: \(dq192.0.2.1, 192.0.2.2\(dq
            // }
            // اما نوشتن آن طولانی است، بنابراین در عوض انجام این کار آسان‌تر است:
         {
             \(dqname\(dq: \(dqdomain\-name\-servers\(dq,
             \(dqdata\(dq: \(dq192.0.2.1, 192.0.2.2\(dq
         },
            // توجه داشته باشید که Kea برخی از گزینه‌ها را خود به خود فراهم می‌کند.
            // به‌ویژه:

            // \- زمان اجاره نشانی IP (گزینه 51) توسط پارامتر valid\-lifetime
            //   کنترل می‌شود، بنابراین نیازی نیست آن را به عنوان یک گزینه مشخص کنید.
            // \- ماسک زیرشبکه (گزینه 1) به‌طور خودکار از پارامتر subnet
            //   مشخص‌شده برای هر مدخل \(dqsubnet4\(dq محاسبه می‌شود.
            // \- پارامتر renewal\-timer (گزینه 58) از پارامتر renew\-timer
            //   محاسبه می‌شود.
            // \- زمان‌سنج rebind (گزینه 59) از پارامتر rebind\-timer
            //   محاسبه می‌شود.

            // برای هر زیرشبکه IPv4 احتمالاً باید حداقل یک روتر (router)
            // مشخص کنید.
         {
             \(dqname\(dq: \(dqrouters\(dq,
             \(dqdata\(dq: \(dq192.0.2.1\(dq
         },

            // معمولاً افراد ترجیح می‌دهند گزینه‌ها را با نام‌هایشان ارجاع دهند،
            // تا نیازی به حفظ کردن شماره کدها نداشته باشند.
            // با این حال، برخی تمایل دارند از مقادیر عددی استفاده کنند. برای
            // نمونه، گزینه \(dqdomain\-name\(dq از کد گزینه 15 استفاده می‌کند، بنابراین
            // می‌توانید با هر یک از
            // \(dqname\(dq: \(dqdomain\-name\(dq یا \(dqcode\(dq: 15 به آن ارجاع دهید.
         {
             \(dqcode\(dq: 15,
             \(dqdata\(dq: \(dqexample.org\(dq
         },
             // گزینه Domain search نیز یک گزینه پرکاربرد است. این گزینه به کلاینت
             // می‌گوید که برای تحلیل نام‌ها در دامنه‌های مشخص‌شده تلاش کند. برای
             // نمونه، برای تحلیل نام \(dqfoo\(dq ابتدا به‌صورت
             // foo.mydomain.example.com تلاش می‌شود و در صورت ناموفق بودن،
             // به‌صورت foo.example.com بررسی خواهد شد.

         {
             \(dqname\(dq: \(dqdomain\-search\(dq,
             \(dqdata\(dq: \(dqmydomain.example.com, example.com\(dq
         },

           // گزینه‌ها را می‌توان با قالب هگزادسیمال نیز مشخص کرد.
           // در صورت امکان باید از این کار خودداری شود، زیرا توانایی Kea برای
           // اعتبارسنجی صحت مقادیر هنگام استفاده از مقادیر هگز محدود است.
         {
             \(dqname\(dq: \(dqbroadcast\-address\(dq,
             \(dqcsv\-format\(dq: false,
             \(dqdata\(dq: \(dqffff8000\(dq
         },

            // گزینه‌های رشته‌ای که در مقدار خود کاما دارند باید گریز داده شوند
            // (یعنی قبل از هر کاما دو بک‌اسلش قرار گیرد).
            // این به این دلیل است که کاما برای جداسازی فیلدها در گزینه‌های ترکیبی
            // رزرو شده است. در عین حال، باید با مشخصات JSON که \(dq\e,\(dq را مجاز
            // نمی‌داند مطابقت داشته باشیم. بنابراین نمادگذاری تا حدی نامعمول
            // با دو بک‌اسلش مورد نیاز است.

            // توالی‌های گریز مجاز در JSON عبارتند از \e به همراه یکی از نویسه‌های \(dq\e/bfnrt
            // یا \eu به همراه 4 عدد هگزادسیمال (در حال حاضر Kea
            // تنها از نقاط کدی \eu0000 تا \eu00ff پشتیبانی می‌کند).
            // پردازش CSV صرفاً \(aq\e\e\(aq را به \(aq\e\(aq و \(aq\e,\(aq را به \(aq,\(aq
            // ترجمه می‌کند، بنابراین به عنوان مثال \(aq\ex\(aq به \(aq\ex\(aq تبدیل می‌شود. اما
            // از آنجا که روی یک مقدار رشته‌ای JSON عمل می‌کند، هر یک از این نویسه‌های \(aq\e\(aq
            // در ورودی JSON باید دو برابر (تکرار) شوند.
         {
            \(dqname\(dq: \(dqboot\-file\-name\(dq,
            \(dqdata\(dq: \(dqEST5EDT4\e\e,M3.2.0/02:00\e\e,M11.1.0/02:00\(dq

         },
            // گزینه‌هایی که مقادیر عدد صحیح می‌گیرند را می‌توان در قالب ده‌دهی (dec)
            // یا شانزده‌شانزدهی (hex) مشخص کرد. قالب هگز می‌تواند ساده (مانند abcd)
            // یا با پیشوند 0x (مانند 0xabcd) باشد.
         {
            \(dqname\(dq: \(dqdefault\-ip\-ttl\(dq,
            \(dqdata\(dq: \(dq0xf0\(dq
         },
            // به جز چند استثنا، گزینه‌ها تنها زمانی به پاسخ اضافه می‌شوند که
            // کلاینت آنها را درخواست کند. پرچم always\-send باید برای
            // اجبار به ارسال یک گزینه خاص استفاده شود.
         {
            \(dqname\(dq: \(dqvendor\-class\-identifier\(dq,
            \(dqdata\(dq: \(dqisc\(dq,
            \(dqalways\-send\(dq: true
         }
       ],

        // اکنون استخرها را تعریف می‌کنیم. دو استخر در اینجا وجود دارد.
        \(dqpools\(dq: [ {
            // این استخر اول است. مورد خاصی در اینجا نیست، صرفاً یک بازه
            // از نشانی‌ها است.
           \(dqpool\(dq: \(dq192.0.2.10 \- 192.0.2.100\(dq

          }, {
            // این استخر دوم جالب‌تر است. هر کس که نشانی‌ای از این استخر
            // دریافت کند، در صورت درخواست پیکربندی کارگزارهای DNS، این مقدار
            // خاص گزینه را نیز دریافت خواهد کرد. این مقدار، به دلیل خاص‌تر بودن،
            // بر هر مقداری که در سطح سراسری (global) یا زیرشبکه تعیین شده باشد اولویت دارد.
            \(dqpool\(dq:  \(dq192.0.2.101 \- 192.0.2.200\(dq,
            \(dqoption\-data\(dq: [
                {
                    \(dqname\(dq: \(dqdomain\-name\-servers\(dq,
                    \(dqdata\(dq: \(dq192.0.2.3, 192.0.2.4\(dq
                }
          ]
        } ]
    } ],

// بخش زیر گزارش‌گیری (logging) را پیکربندی می‌کند. فرض بر این است که پیام‌هایی
// با حداقل سطح اطلاعاتی (info، warn، error و fatal) باید در stdout
// ثبت شوند.
    \(dqloggers\(dq: [
        {
            \(dqname\(dq: \(dqkea\-dhcp4\(dq,
            \(dqoutput\-options\(dq: [
                {
                    \(dqoutput\(dq: \(dqstdout\(dq
                }
            ],
            \(dqseverity\(dq: \(dqINFO\(dq
        }
    ]
}

}
.EE
.UNINDENT
.UNINDENT.SS kea4/mysql\-reservations.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک فایل پیکربندی نمونه برای کارساز DHCPv4 در Kea است.
// این فایل شامل پیکربندی پس‌دانه پایگاه‌داده میزبان MySQL است که برای
// بازیابی نشانی‌های رزرو شده، نام‌های میزبان، فیلدهای پیام DHCPv4
// و گزینه‌های DHCP از پایگاه‌داده MySQL استفاده می‌شود.
{ \(dqDhcp4\(dq:

{
// به Kea اعلام شده است که فقط روی رابط eth0 شنود کند.
  \(dqinterfaces\-config\(dq: {
    \(dqinterfaces\(dq: [ \(dqeth0\(dq ]

  },

// ما باید پایگاه‌داده مورد استفاده برای ذخیره اجاره‌ها (leases) را مشخص کنیم. از
// ژوئن ۲۰۲۲، از سه پس‌دانه پایگاه‌داده پشتیبانی می‌شود: MySQL،
// PostgreSQL و پایگاه‌داده درون‌حافظه‌ای Memfile.
// ما از memfile استفاده می‌کنیم زیرا به هیچ راه‌اندازی اولیه‌ای نیاز ندارد.
  \(dqlease\-database\(dq: {
      \(dqtype\(dq: \(dqmemfile\(dq,
      \(dqlfc\-interval\(dq: 3600
  },

// نشانی‌ها با طول‌عمر ۴۰۰۰ ثانیه تخصیص داده خواهند شد.
  \(dqvalid\-lifetime\(dq: 4000,

// زمان‌سنج‌های تجدید (renew) و پیوند مجدد (rebind) کامنت شده‌اند. این بدان معناست که گزینه‌های
// ۵۸ و ۵۹ به کلاینت ارسال نخواهند شد. در این حالت انتخاب مقادیر زمان‌سنج بر عهده
// کلاینت طبق RFC2131 خواهد بود. برای ارسال این گزینه‌ها به کلاینت، کامنت
// زمان‌سنج‌ها را بردارید.
//  \(dqrenew\-timer\(dq: 1000,
//  \(dqrebind\-timer\(dq: 2000,


// ‏Kea از رزروها بر اساس چندین نوع مختلف از شناسه‌ها پشتیبانی می‌کند:
// ‏hw\-address (نشانی سخت‌افزاری/MAC کلاینت)، duid
// ‏(DUID درج‌شده توسط کلاینت)، client\-id (شناسه کلاینت درج‌شده
// توسط کلاینت) و circuit\-id (شناسه مدار درج‌شده توسط کارگزار
// رله). در صورت تنظیم، Kea می‌تواند همه آن انواع شناسه را بررسی کند، اما این
// کار مستلزم یک جستجوی هزینه‌بر در پایگاه‌داده است. بنابراین از دیدگاه کارایی،
// بهتر است فقط از انواع رزروی که واقعاً در یک شبکه استفاده می‌شوند، بهره برد.

// مثال زیر از دیدگاه کارایی بهینه نیست، اما به خوبی
// قابلیت‌های رزرو میزبان را نشان می‌دهد. لطفاً از حداقل مجموعه
// انواع شناسه‌های مورد استفاده در شبکه خود استفاده کنید.
  \(dqhost\-reservation\-identifiers\(dq:
    [ \(dqcircuit\-id\(dq, \(dqhw\-address\(dq, \(dqduid\(dq, \(dqclient\-id\(dq ],

// اتصال به پایگاه‌داده نگه‌دارنده رزروهای میزبان را مشخص کنید. گزینه type
// مشخص می‌کند که از پایگاه‌داده MySQL استفاده می‌شود. user و password اطلاعات
// ورود مورد استفاده برای اتصال به پایگاه‌داده هستند. host و name موقعیت
// میزبانی که نمونه پایگاه‌داده روی آن اجرا می‌شود و نام پایگاه‌داده مورد استفاده
// را مشخص می‌کنند. کارساز هنگام پردازش یک بسته ابتدا بررسی می‌کند که آیا رزروی
// برای این کلاینت در فهرست رزروها در زیرشبکه (فایل پیکربندی) مشخص شده است یا خیر.
// اگر رزروی در آنجا وجود نداشته باشد، کارساز تلاش خواهد کرد رزروها را
// از این پایگاه‌داده بازیابی کند.
  \(dqhosts\-database\(dq: {
    \(dqtype\(dq: \(dqmysql\(dq,
    \(dqreconnect\-wait\-time\(dq: 3000, // برحسب میلی‌ثانیه
    \(dqmax\-reconnect\-tries\(dq: 3,
    \(dqname\(dq: \(dqkeatest\(dq,
    \(dquser\(dq: \(dqkeatest\(dq,
    \(dqpassword\(dq: \(dq1234\(dq,
    \(dqhost\(dq: \(dqlocalhost\(dq,
    \(dqport\(dq: 3306,
    \(dqtrust\-anchor\(dq: \(dqmy\-ca\(dq,
    \(dqcert\-file\(dq: \(dqmy\-cert\(dq,
    \(dqkey\-file\(dq: \(dqmy\-key\(dq,
    \(dqcipher\-list\(dq: \(dqAES\(dq
  },
// از نسخه Kea.2.7.4، کتابخانه قلاب libdhcp_mysql.so باید بارگیری شود تا
// بتوان رزروهای میزبان را در پس‌دانه پایگاه‌داده میزبان MySQL ذخیره کرد.
// موقعیت کتابخانه قلاب پس‌دانه میزبان را مشخص کنید.
  \(dqhooks\-libraries\(dq: [
    {
        // کتابخانه قلاب پس‌دانه میزبان MySQL مورد نیاز برای ذخیره‌سازی میزبان.
        \(dqlibrary\(dq: \(dqlibdhcp_mysql.so\(dq
    }
  ],

// تعریف یک زیرشبکه با یک استخر تک از نشانی‌های پویا. نشانی‌ها از
// این استخر به کلاینت‌هایی تخصیص می‌یابند که رزروی در پایگاه‌داده
// ندارند. شناسه زیرشبکه برابر ۱ است. اگر این زیرشبکه برای
// کلاینت انتخاب شود، این شناسه برای جستجوی رزروها
// درون پایگاه‌داده استفاده خواهد شد.
  \(dqsubnet4\(dq: [
    {
       \(dqpools\(dq: [ { \(dqpool\(dq:  \(dq192.0.2.10 \- 192.0.2.200\(dq } ],
       \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
       \(dqinterface\(dq: \(dqeth0\(dq,
       \(dqid\(dq: 1
    }
  ],

// بخش زیر گزارش‌گیری را پیکربندی می‌کند. فرض می‌شود که پیام‌ها با حداقل
// سطح اطلاعاتی (info، warn، error و fatal) باید
// در stdout ثبت شوند.
    \(dqloggers\(dq: [
        {
            \(dqname\(dq: \(dqkea\-dhcp4\(dq,
            \(dqoutput\-options\(dq: [
                {
                    \(dqoutput\(dq: \(dqstdout\(dq
                }
            ],
            \(dqseverity\(dq: \(dqINFO\(dq
        }
    ]
}

}
.EE
.UNINDENT
.UNINDENT.SS kea4/pgsql\-reservations.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک پیکربندی نمونه برای کارساز DHCPv4 در Kea است.
// این پیکربندی شامل تنظیمات پس‌دسته پایگاه‌داده میزبان PostgreSQL است که برای
// بازیابی نشانی‌های رزرو شده، نام‌های میزبان، فیلدهای پیام DHCPv4
// و گزینه‌های DHCP از پایگاه‌داده PostgreSQL استفاده می‌شود.
{ \(dqDhcp4\(dq:

{
// به Kea گفته شده است که تنها روی رابط eth0 شنود کند.
  \(dqinterfaces\-config\(dq: {
    \(dqinterfaces\(dq: [ \(dqeth0\(dq ]
  },


// باید پایگاه‌داده مورد استفاده برای ذخیره اجاره‌ها را مشخص کنیم. از
// ژوئن ۲۰۲۲، سه پس‌دسته پایگاه‌داده پشتیبانی می‌شوند: MySQL،
// PostgreSQL و پایگاه‌داده درون‌حافظه‌ای Memfile.
// ما از memfile استفاده خواهیم کرد چون به هیچ راه‌اندازی اولیه‌ای نیاز ندارد.
  \(dqlease\-database\(dq: {
    \(dqtype\(dq: \(dqmemfile\(dq
  },

// نشانی‌ها با طول‌عمر ۴۰۰۰ ثانیه تخصیص داده خواهند شد.
  \(dqvalid\-lifetime\(dq: 4000,

// زمان‌سنج‌های تجدید (renew) و اتصال مجدد (rebind) کامنت شده‌اند. این بدان معناست که گزینه‌های
// ۵۸ و ۵۹ به کلاینت ارسال نخواهند شد. در این حالت بر عهده کلاینت است
// که مقادیر زمان‌سنج را بر اساس RFC2131 انتخاب کند. برای ارسال این گزینه‌ها
// به کلاینت، کامنت زمان‌سنج‌ها را بردارید.
//  \(dqrenew\-timer\(dq: 1000,
//  \(dqrebind\-timer\(dq: 2000,


// کارساز Kea از رزروها بر پایه چندین نوع شناسه گوناگون پشتیبانی می‌کند:
// hw\-address (نشانی سخت‌افزاری/MAC کلاینت)، duid
// (شناسه DUID درج شده توسط کلاینت)، client\-id (شناسه کلاینت درج شده
// توسط کلاینت) و circuit\-id (شناسه مدار درج شده توسط کارگزار رله).
// در صورت تنظیم، Kea می‌تواند همه این انواع شناسه را بررسی کند،
// اما این کار مستلزم جست‌وجوی هزینه‌بر در پایگاه‌داده است. بنابراین،
// از دیدگاه کارایی بهتر است تنها از انواعی از رزرو استفاده شود
// که واقعاً در شبکه مربوطه استفاده می‌شوند.

// مثال زیر از دیدگاه کارایی بهینه نیست، اما به خوبی قابلیت‌های
// رزرو میزبان را نشان می‌دهد. لطفاً حداقل مجموعه از انواع شناسه‌های مورد نیاز
// در شبکه خود را به کار ببرید.
  \(dqhost\-reservation\-identifiers\(dq:
    [ \(dqcircuit\-id\(dq, \(dqhw\-address\(dq, \(dqduid\(dq, \(dqclient\-id\(dq ],

// مشخص کردن اتصال به پایگاه‌داده نگه‌دارنده رزروهای میزبان. پارامتر type
// مشخص می‌کند که از پایگاه‌داده PostgreSQL استفاده می‌شود. user و password اطلاعات کاربری
// مورد استفاده برای اتصال به پایگاه‌داده هستند. host و name مکان میزبانی
// که نمونه پایگاه‌داده روی آن در حال اجراست و نام پایگاه‌داده مورد استفاده را مشخص می‌کنند.
// کارساز هنگام پردازش یک بسته، ابتدا بررسی می‌کند که آیا رزروی برای این کلاینت در فهرست
// رزروهای درون زیرشبکه (فایل پیکربندی) مشخص شده است یا خیر. اگر رزروی در آنجا وجود نداشته باشد،
// کارساز تلاش خواهد کرد تا رزروها را از این پایگاه‌داده بازیابی کند.
// مشخصات پایگاه‌داده می‌تواند برای سازگاری با نسخه‌های پیشین درون یک مدخل hosts\-database قرار گیرد
// یا اینکه در فهرست hosts\-databases فهرست شود.
  \(dqhosts\-databases\(dq: [
    {
       \(dqtype\(dq: \(dqpostgresql\(dq,
       \(dqreconnect\-wait\-time\(dq: 3000, // بر حسب میلی‌ثانیه
       \(dqmax\-reconnect\-tries\(dq: 3,
       \(dqname\(dq: \(dqkeatest\(dq,
       \(dquser\(dq: \(dqkeatest\(dq,
       \(dqpassword\(dq: \(dq1234\(dq,
       \(dqhost\(dq: \(dqlocalhost\(dq
    }
  ],
// از نسخه Kea 2.7.4 به بعد، کتابخانه قلاب libdhcp_pgsql.so باید بارگیری شود
// تا بتوان رزروهای میزبان را در پس‌دسته پایگاه‌داده میزبان PostgreSQL ذخیره کرد.
// مکان کتابخانه قلاب پس‌دسته میزبان را مشخص کنید.
  \(dqhooks\-libraries\(dq: [
    {
        // کتابخانه قلاب پس‌دسته میزبان PostgreSQL مورد نیاز برای ذخیره‌سازی میزبان.
        \(dqlibrary\(dq: \(dqlibdhcp_pgsql.so\(dq
    }
  ],

// تعریف یک زیرشبکه با یک استخر تک از نشانی‌های پویا. نشانی‌ها از
// این استخر به کلاینت‌هایی اختصاص می‌یابند که در پایگاه‌داده رزروی ندارند.
// شناسه زیرشبکه برابر ۱ است. اگر این زیرشبکه برای کلاینت انتخاب شود،
// از این شناسه زیرشبکه برای جست‌وجوی رزروها در پایگاه‌داده استفاده خواهد شد.
  \(dqsubnet4\(dq: [
    {
       \(dqpools\(dq: [ { \(dqpool\(dq:  \(dq192.0.2.10 \- 192.0.2.200\(dq } ],
       \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
       \(dqinterface\(dq: \(dqeth0\(dq,
       \(dqid\(dq: 1
    }
  ],

// بخش زیر گزارش‌گیری را پیکربندی می‌کند. فرض می‌شود که پیام‌های دارای
// حداقل سطح اطلاعاتی (info، warn، error و fatal) باید در stdout ثبت شوند.
    \(dqloggers\(dq: [
        {
            \(dqname\(dq: \(dqkea\-dhcp4\(dq,
            \(dqoutput\-options\(dq: [
                {
                    \(dqoutput\(dq: \(dqstdout\(dq
                }
            ],
            \(dqseverity\(dq: \(dqINFO\(dq
        }
    ]
}

}
.EE
.UNINDENT
.UNINDENT
.SS kea4/reservations.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک پیکربندی نمونه برای کارساز DHCPv4 در Kea است.
// شامل یک زیرشبکه است که در آن دو رزرو نشانی ایستا برای کلاینت‌های شناسایی‌شده
// با نشانی‌های MAC وجود دارد.
{ \(dqDhcp4\(dq:

{
// به Kea گفته شده است که تنها روی رابط eth0 شنود کند.
  \(dqinterfaces\-config\(dq: {
    \(dqinterfaces\(dq: [ \(dqeth0\(dq ]
  },

// باید پایگاه‌داده مورد استفاده برای ذخیره اجاره‌ها را مشخص کنیم. از آوریل
// ۲۰۲۲، سه پس‌دسته پایگاه‌داده پشتیبانی می‌شوند: MySQL، PostgreSQL و
// پایگاه‌داده درون‌حافظه‌ای Memfile. ما از memfile استفاده خواهیم کرد چون
// به هیچ راه‌اندازی اولیه‌ای نیاز ندارد.
  \(dqlease\-database\(dq: {
      \(dqtype\(dq: \(dqmemfile\(dq,
      \(dqlfc\-interval\(dq: 3600
  },

// نشانی‌ها با طول‌عمر ۴۰۰۰ ثانیه تخصیص داده خواهند شد.
  \(dqvalid\-lifetime\(dq: 4000,

// زمان‌سنج‌های تجدید (renew) و اتصال مجدد (rebind) کامنت شده‌اند. این بدان معناست که گزینه‌های
// ۵۸ و ۵۹ به کلاینت ارسال نخواهند شد. در این حالت بر عهده کلاینت است
// که مقادیر زمان‌سنج را بر اساس RFC2131 انتخاب کند. برای ارسال این گزینه‌ها
// به کلاینت، کامنت زمان‌سنج‌ها را بردارید.
//  \(dqrenew\-timer\(dq: 1000,
//  \(dqrebind\-timer\(dq: 2000,

// کارساز Kea از رزروها بر پایه چندین نوع شناسه گوناگون پشتیبانی می‌کند:
// hw\-address (نشانی سخت‌افزاری/MAC کلاینت)، duid (شناسه DUID درج شده توسط
// کلاینت)، client\-id (شناسه کلاینت درج شده توسط کلاینت)، circuit\-id
// (شناسه مدار درج شده توسط کارگزار رله) و flex\-id (شناسه انعطاف‌پذیر
// موجود در صورت بارگیری کتابخانه قلاب flex_id). در صورت تنظیم، Kea می‌تواند
// همه این انواع شناسه را بررسی کند، اما این کار مستلزم جست‌وجوی هزینه‌بر
// در پایگاه‌داده است. بنابراین، از دیدگاه کارایی بهتر است تنها از انواعی از رزرو
// استفاده شود که واقعاً در شبکه مربوطه استفاده می‌شوند.

// مثال زیر از دیدگاه کارایی بهینه نیست، اما به خوبی قابلیت‌های
// رزرو میزبان را نشان می‌دهد. لطفاً حداقل مجموعه از انواع شناسه‌های مورد نیاز
// در شبکه خود را به کار ببرید.
\(dqhost\-reservation\-identifiers\(dq: [ \(dqcircuit\-id\(dq, \(dqhw\-address\(dq, \(dqduid\(dq,
                                  \(dqclient\-id\(dq, \(dqflex\-id\(dq ],

// تعریف یک زیرشبکه با چهار رزرو. برخی از رزروها متعلق به استخر پویا هستند.
// کارساز Kea توانایی مدیریت این حالت را دارد، اما از دیدگاه کارایی توصیه نمی‌شود،
// زیرا Kea نه تنها باید آزاد بودن یک نشانی مشخص را بررسی کند، بلکه باید رزرو بودن
// آن را نیز بررسی نماید. برای جلوگیری از این بررسی، می‌توان \(dqreservations\-out\-of\-pool\(dq
// را برابر true قرار داد، علاوه بر \(dqreservations\-in\-subnet\(dq که آن نیز باید برابر true
// باشد. اگر یک زیرشبکه اصلاً هیچ رزروی نداشته باشد، با قرار دادن \(dqreservations\-in\-subnet\(dq
// روی false می‌توان جست‌وجوی رزرو را به‌طور کامل نادیده گرفت.

// توجه داشته باشید که رزرو دوم برای نشانی‌ای است که در محدوده استخر
// نشانی‌های تخصیص‌یافته به صورت پویا قرار دارد. کارساز این نشانی را از این استخر مستثنی
// خواهد کرد و آن را تنها به کلاینتی که برای آن رزرو دارد اختصاص می‌دهد.
  \(dqsubnet4\(dq: [
    {
        \(dqpools\(dq: [ { \(dqpool\(dq:  \(dq192.0.2.1 \- 192.0.2.200\(dq } ],
        \(dqid\(dq: 1,
        \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
        \(dqinterface\(dq: \(dqeth0\(dq,
        // این دستور به Kea اعلام می‌کند که رزروها ممکن است هم درون‌استخر (in\-pool)
        // و هم خارج‌از‌استخر (out\-of\-pool) انجام شوند. برای بهبود کارایی، می‌توانید تمام رزروها
        // را به خارج از استخر پویا منتقل کرده و \(dqreservations\-out\-of\-pool\(dq را برابر true قرار دهید.
        // در این صورت Kea هنگام تخصیص اجاره‌ها از استخر پویا، می‌تواند از جست‌وجوی
        // رزروهای میزبان صرف‌نظر کند.

        // مشخص می‌کند که آیا کارساز باید رزروهای سراسری را جست‌وجو کند یا خیر.
        // پیش‌فرض false است.
        \(dqreservations\-global\(dq: false,

        // مشخص می‌کند که آیا کارساز باید رزروهای درون زیرشبکه را جست‌وجو کند یا خیر.
        // پیش‌فرض true است.
        \(dqreservations\-in\-subnet\(dq: true,

        // مشخص می‌کند که آیا کارساز می‌تواند فرض کند تمام نشانی‌های رزروشده خارج‌از‌استخر
        // هستند یا خیر. پیش‌فرض false است.
        // در صورت false بودن reservations\-in\-subnet نادیده گرفته می‌شود.
        // در صورت تعیین، در سطوح \(dqshared\-networks\(dq و
        // \(dqsubnet4\(dq به ارث برده می‌شود.
        \(dqreservations\-out\-of\-pool\(dq: false,

        \(dqreservations\(dq: [

// این رزروی برای یک نشانی سخت‌افزاری/MAC مشخص است. این یک رزرو بسیار
// ساده است: تنها یک نشانی و نه چیز دیگر.
        {
            \(dqhw\-address\(dq: \(dq1a:1b:1c:1d:1e:1f\(dq,
            \(dqip\-address\(dq: \(dq192.0.2.201\(dq
        },

// این رزروی برای یک client\-id مشخص است. همچنین نشان می‌دهد
// که این کلاینت یک نام میزبان رزروشده دریافت خواهد کرد. نام میزبان را می‌توان
// برای هر نوع شناسه‌ای تعریف کرد، نه فقط client\-id.
        {
            \(dqclient\-id\(dq: \(dq01:11:22:33:44:55:66\(dq,
            \(dqip\-address\(dq: \(dq192.0.2.202\(dq,
            \(dqhostname\(dq: \(dqspecial\-snowflake\(dq
        },

// رزرو سوم بر پایه DUID است. این رزرو همچنین مقادیر گزینه ویژه‌ای را
// برای این کلاینت خاص تعریف می‌کند. اگر گزینه domain\-name\-servers در سطح سراسری،
// زیرشبکه یا کلاس تعریف شده باشد، مقادیر ویژه این میزبان اولویت خواهند داشت.
        {
            \(dqduid\(dq: \(dq01:02:03:04:05\(dq,
            \(dqip\-address\(dq: \(dq192.0.2.203\(dq,
            \(dqoption\-data\(dq: [ {
                \(dqname\(dq: \(dqdomain\-name\-servers\(dq,
                \(dqdata\(dq: \(dq10.1.1.202,10.1.1.203\(dq
            } ]
        },

// رزرو چهارم بر پایه circuit\-id است. این گزینه‌ای است که توسط کارگزار رله
// که بسته را از کلاینت به کارساز بازمی‌فرستد درج می‌شود.
// در این مثال به میزبان گزینه‌های ویژه شرکت سازنده نیز اختصاص داده شده است.
        {
            \(dqcircuit\-id\(dq: \(dq01:11:22:33:44:55:66\(dq,
            \(dqip\-address\(dq: \(dq192.0.2.204\(dq,
            \(dqoption\-data\(dq: [
                {
                    \(dqname\(dq: \(dqvivso\-suboptions\(dq,
                    \(dqdata\(dq: \(dq4491\(dq
                },
                {
                    \(dqname\(dq: \(dqtftp\-servers\(dq,
                    \(dqspace\(dq: \(dqvendor\-4491\(dq,
                    \(dqdata\(dq: \(dq10.1.1.202,10.1.1.203\(dq
                }
            ]
        },
// این رزرو برای کلاینتی است که نیاز به تنظیم فیلدهای مشخصی از DHCPv4 دارد.
// سه فیلد پشتیبانی‌شده عبارتند از next\-server، server\-hostname و
// boot\-file\-name
        {
            \(dqclient\-id\(dq: \(dq01:0a:0b:0c:0d:0e:0f\(dq,
            \(dqip\-address\(dq: \(dq192.0.2.205\(dq,
            \(dqnext\-server\(dq: \(dq192.0.2.1\(dq,
            \(dqserver\-hostname\(dq: \(dqhal9000\(dq,
            \(dqboot\-file\-name\(dq: \(dq/dev/null\(dq
        },

// این رزرو از شناسه انعطاف‌پذیر استفاده می‌کند. مدیر سیستم به جای اتکا
// به فیلدی مشخص، می‌تواند عبارتی مشابه آنچه برای رده‌بندی کلاینت به کار می‌رود
// تعریف کند، به عنوان مثال: substring(relay[0].option[17],0,6). سپس، بر اساس مقدار
// آن عبارت برای بسته ورودی، رزرو تطبیق داده می‌شود.
// عبارت می‌تواند به صورت هگزادسیمال یا متن ساده با استفاده از نقل‌قول تکی
// مشخص شود.
// نکته: شناسه انعطاف‌پذیر برای کارکرد نیازمند بارگیری کتابخانه قلاب flex_id
// است.
        {
            \(dqflex\-id\(dq: \(dq\(aqs0mEVaLue\(aq\(dq,
            \(dqip\-address\(dq: \(dq192.0.2.206\(dq
        }

      ]
    }
  ],

// بخش زیر گزارش‌گیری را پیکربندی می‌کند. فرض می‌شود که پیام‌های دارای
// حداقل سطح اطلاعاتی (info، warn، error و fatal) باید در stdout ثبت شوند.
    \(dqloggers\(dq: [
        {
            \(dqname\(dq: \(dqkea\-dhcp4\(dq,
            \(dqoutput\-options\(dq: [
                {
                    \(dqoutput\(dq: \(dqstdout\(dq
                }
            ],
            \(dqseverity\(dq: \(dqINFO\(dq
        }
    ]
}

}
.EE
.UNINDENT
.UNINDENT.SS kea4/several\-subnets.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک فایل پیکربندی نمونه برای کارساز DHCPv4 در Kea است.
// این سناریویی پایه‌ای با سه زیرشبکه IPv4 پیکربندی‌شده است. در هر
// زیرشبکه، یک استخر کوچک‌تر از آدرس‌های پویا وجود دارد.

{ \(dqDhcp4\(dq:

{
// به Kea گفته شده است که تنها روی رابط eth0 شنود کند.
  \(dqinterfaces\-config\(dq: {
    \(dqinterfaces\(dq: [ \(dqeth0\(dq ]
  },

// ما باید پایگاه‌داده مورد استفاده برای ذخیره اجاره‌ها را مشخص کنیم. تا
// ژوئن ۲۰۲۲، سه پسانه پایگاه‌داده پشتیبانی می‌شوند: MySQL،
// PostgreSQL و پایگاه‌داده درون‌حافظه‌ای Memfile.
// ما از memfile استفاده می‌کنیم زیرا به هیچ راه‌اندازی اولیه‌ای نیاز ندارد.
  \(dqlease\-database\(dq: {
    \(dqtype\(dq: \(dqmemfile\(dq
  },

// آدرس‌ها با طول عمر ۴۰۰۰ ثانیه تخصیص داده خواهند شد.
// به کلاینت گفته می‌شود که پس از ۱۰۰۰ ثانیه تمدید را آغاز کند. اگر کارساز
// تا ۲۰۰۰ ثانیه پس از اعطای اجاره پاسخ ندهد، کلاینت باید
// فرآیند REBIND (تمدید اضطراری که امکان جابه‌جایی به یک
// کارساز دیگر را فراهم می‌کند) را آغاز کند.
  \(dqvalid\-lifetime\(dq: 4000,
  \(dqrenew\-timer\(dq: 1000,
  \(dqrebind\-timer\(dq: 2000,

// استاندارد RFC6842 بیان می‌کند که کارساز باید گزینه client\-id را بازتاب (echo) دهد.
// با این حال، برخی کلاینت‌های قدیمی‌تر از این پشتیبانی نمی‌کنند و زمانی
// که client\-id خود را دریافت می‌کنند سردرگم می‌شوند. Kea می‌تواند پشتیبانی از RFC6842 را غیرفعال کند.
  \(dqecho\-client\-id\(dq: false,

// برخی کلاینت‌ها از شناسه کلاینت پایدار استفاده نمی‌کنند، بلکه آن را هنگام
// هر راه‌اندازی تولید می‌کنند. این امر ممکن است باعث شود کلاینتی که مکرراً راه‌اندازی می‌شود
// چندین اجاره دریافت کند، که ممکن است مطلوب نباشد. از این رو، گاهی مدیران
// ترجیح می‌دهند به کارساز DHCPv4 خود بگویند که مقدار client\-id را کاملاً نادیده بگیرد
// و منحصراً به آدرس MAC اتکا کند. این پارامتری است که به‌صورت
// سراسری تعریف می‌شود، اما می‌تواند در سطح زیرشبکه بازنویسی شود.
  \(dqmatch\-client\-id\(dq: true,

  // به‌طور پیش‌فرض، Kea درخواست‌های کلاینت‌ها برای آدرس‌های IP نامشخص را نادیده می‌گیرد،
  // زیرا کارسازهای DHCP غیرهمکار دیگری ممکن است در همان
  // شبکه حضور داشته باشند (RFC 2131). این پارامتر به‌صورت سراسری تعریف می‌شود، اما می‌تواند
  // در سطح زیرشبکه بازنویسی شود
  \(dqauthoritative\(dq: false,

// فهرست زیر زیرشبکه‌ها را تعریف می‌کند. هر زیرشبکه حداقل شامل
// مدخل‌های subnet و pool است.
  \(dqsubnet4\(dq: [
  {
      \(dqpools\(dq: [ { \(dqpool\(dq:  \(dq192.0.2.1 \- 192.0.2.200\(dq } ],
      \(dqid\(dq: 1,
      \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq
  },
  {
// این زیرشبکه خاص مقدار match\-client\-id تغییریافته دارد.
      \(dqpools\(dq: [ { \(dqpool\(dq: \(dq192.0.3.100 \- 192.0.3.200\(dq } ],
      \(dqid\(dq: 2,
      \(dqsubnet\(dq: \(dq192.0.3.0/24\(dq,
      \(dqmatch\-client\-id\(dq: false
  },
  {
      \(dqpools\(dq: [ { \(dqpool\(dq: \(dq192.0.4.1 \- 192.0.4.254\(dq } ],
      \(dqid\(dq: 3,
      \(dqsubnet\(dq: \(dq192.0.4.0/24\(dq
  } ],

// بخش زیر ثبت وقایع را پیکربندی می‌کند. فرض بر این است که پیام‌هایی با
// حداقل سطح اطلاعاتی (info،‏ warn،‏ error و fatal) باید در
// stdout ثبت شوند.
    \(dqloggers\(dq: [
        {
            \(dqname\(dq: \(dqkea\-dhcp4\(dq,
            \(dqoutput\-options\(dq: [
                {
                    \(dqoutput\(dq: \(dqstdout\(dq
                }
            ],
            \(dqseverity\(dq: \(dqINFO\(dq
        }
    ]
}

}
.EE
.UNINDENT
.UNINDENT
.SS kea4/shared\-network.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک فایل پیکربندی نمونه برای کارساز DHCPv4 در Kea است.
// این فایل ویژگی پیشرفته‌ای به نام شبکه اشتراکی (shared network) را نشان می‌دهد. معمولاً برای
// هر پیوند فیزیکی، یک زیرشبکه IPv4 وجود دارد که انتظار می‌رود کارساز
// آن را مدیریت کند. با این حال، در برخی موارد نیاز است که زیرشبکه‌های بیشتری
// در همان مکان فیزیکی پیکربندی شوند. رایج‌ترین مورد مصرف زمانی است که یک زیرشبکه
// موجود فراتر از فرضیات اولیه خود رشد کرده و آدرس‌های آن تمام شده است،
// بنابراین مدیر سیستم باید زیرشبکه دیگری را بر روی زیرشبکه موجود اضافه کند.
{
    \(dqDhcp4\(dq: {

        // مانند هر پیکربندی دیگری، باید نام‌های رابط را به Kea اعلام کنید
        // تا به ترافیک ورودی گوش فرا دهد.
        \(dqinterfaces\-config\(dq: {
            \(dqinterfaces\(dq: [ \(dqeth0\(dq ]
        },

        // همچنین باید مشخص کنید که اطلاعات اجاره در کجا ذخیره شود.
        // پسانه memfile ساده‌ترین راه‌اندازی را دارد.
        \(dqlease\-database\(dq: {
            \(dqtype\(dq: \(dqmemfile\(dq,
            \(dqlfc\-interval\(dq: 3600
        },

        // تعریف شبکه‌های اشتراکی از اینجا آغاز می‌شود. shared\-networks می‌تواند
        // شامل فهرستی از شبکه‌های اشتراکی باشد. پارامترهای بسیاری وجود دارند
        // که می‌توان در اینجا مشخص کرد، بنابراین این مثال ممکن است در ابتدا
        // گیج‌کننده به نظر برسد، اما تنها پارامتر اجباری برای هر شبکه
        // اشتراکی name است. این نام باید یکتا باشد. معمولاً هر شبکه
        // اشتراکی برای کارکرد درست به حداقل دو زیرشبکه نیاز دارد،
        // اما اگر واقعاً بخواهید، می‌توانید یک شبکه اشتراکی تقلیل‌یافته تعریف
        // کنید که ۱ یا حتی ۰ زیرشبکه دارد. این کار هنگام مهاجرت بین
        // زیرشبکه‌های عادی و شبکه‌های اشتراکی یا هنگام اشکال‌زدایی یک مشکل
        // می‌تواند مفید باشد. استفاده از ۱ زیرشبکه در هر شبکه اشتراکی توصیه
        // نمی‌شود، زیرا بار پردازشی اضافی برای شبکه‌های اشتراکی وجود دارد.
        \(dqshared\-networks\(dq: [
        {
            // نام شبکه اشتراکی. این می‌تواند یک رشته دلخواه باشد
            // و باید در میان تمام شبکه‌های اشتراکی یکتا باشد.
            \(dqname\(dq: \(dqfrog\(dq,

            // در صورتی که شبکه اشتراکی مستقیماً از کارساز قابل دسترس باشد،
            // می‌توانید نام رابط را مشخص کنید.
            \(dqinterface\(dq: \(dqeth1\(dq,

            // شما می‌توانید پارامترهای بسیاری را که در محدوده زیرشبکه مجاز هستند در
            // اینجا مشخص کنید. قرار دادن آن‌ها در اینجا در صورتی که برای تمام زیرشبکه‌های
            // این شبکه اشتراکی اعمال شوند مفید است. احتمالاً رایج‌ترین پارامتر
            // در اینجا مقادیر گزینه‌های تعریف‌شده با option\-data خواهد بود.
            \(dqmatch\-client\-id\(dq: false,
            \(dqoption\-data\(dq: [ ],
            \(dqrebind\-timer\(dq: 150,
            \(dqauthoritative\(dq: true,

            // اگر تمام ترافیک ورودی از آن شبکه اشتراکی از طریق یک رله (relay)
            // قابل دسترس باشد و آن رله همواره از همان آدرس IP استفاده کند،
            // می‌توانید آدرس آن رله را در اینجا مشخص کنید. از آنجا که این مثال یک شبکه اشتراکی
            // با دسترسی مستقیم را نشان می‌دهد، ما در اینجا 0.0.0.0 قرار می‌دهیم.
            // بهتر است محدوده relay کلاً نادیده گرفته شود، اما برای
            // مقاصد نمایشی در اینجا باقی مانده است.
            \(dqrelay\(dq: {
                \(dqip\-addresses\(dq: [ \(dq0.0.0.0\(dq ]
            },

            // مقادیر تایمر می‌توانند در اینجا بازنویسی شوند.
            \(dqrenew\-timer\(dq: 100,

            // مشخص می‌کند که آیا کارساز باید رزروهای سراسری را جستجو کند یا خیر.
            \(dqreservations\-global\(dq: false,

            // مشخص می‌کند که آیا کارساز باید رزروهای درون زیرشبکه را جستجو کند یا خیر.
            \(dqreservations\-in\-subnet\(dq: true,

            // مشخص می‌کند که آیا کارساز می‌تواند فرض کند تمام آدرس‌های رزروشده
            // خارج از استخر (out\-of\-pool) هستند یا خیر.
            // در صورتی که reservations\-in\-subnet برابر false باشد نادیده گرفته می‌شود.
            // در صورت تعیین، توسط سطوح \(dqsubnet4\(dq به ارث برده می‌شود.
            \(dqreservations\-out\-of\-pool\(dq: false,

            // این بخش فهرستی از زیرشبکه‌های مجاز در این شبکه اشتراکی را آغاز می‌کند.
            // در مثال ما، دو زیرشبکه وجود دارد.
            \(dqsubnet4\(dq: [
                {
                    \(dqid\(dq: 1,
                    \(dqmatch\-client\-id\(dq: true,
                    \(dqnext\-server\(dq: \(dq0.0.0.0\(dq,
                    \(dqserver\-hostname\(dq: \(dq\(dq,
                    \(dqboot\-file\-name\(dq: \(dq\(dq,
                    \(dqoption\-data\(dq: [ ],
                    \(dqpools\(dq: [ ],
                    \(dqrebind\-timer\(dq: 20,

                    // در صورتی که رله شما از آدرس‌های IP متفاوتی برای هر
                    // زیرشبکه استفاده می‌کند، می‌توانید مقدار به ارث‌رسیده از
                    // shared\-network را در اینجا بازنویسی کنید.
                    \(dqrelay\(dq: {
                        \(dqip\-addresses\(dq: [ \(dq0.0.0.0\(dq ]
                    },
                    \(dqrenew\-timer\(dq: 10,
                    // مشخص می‌کند که آیا کارساز باید رزروهای سراسری را جستجو کند یا خیر.
                    \(dqreservations\-global\(dq: false,
                    // مشخص می‌کند که آیا کارساز باید رزروهای درون زیرشبکه را جستجو کند یا خیر.
                    \(dqreservations\-in\-subnet\(dq: true,
                    // مشخص می‌کند که آیا کارساز می‌تواند فرض کند تمام آدرس‌های رزروشده
                    // خارج از استخر هستند یا خیر.
                    // در صورتی که reservations\-in\-subnet برابر false باشد نادیده گرفته می‌شود.
                    \(dqreservations\-out\-of\-pool\(dq: false,
                    \(dqsubnet\(dq: \(dq10.0.0.0/8\(dq,
                    \(dqvalid\-lifetime\(dq: 30
                },
                {
                    \(dqid\(dq: 2,
                    \(dqmatch\-client\-id\(dq: true,
                    \(dqnext\-server\(dq: \(dq0.0.0.0\(dq,
                    \(dqserver\-hostname\(dq: \(dq\(dq,
                    \(dqboot\-file\-name\(dq: \(dq\(dq,
                    \(dqoption\-data\(dq: [ ],
                    \(dqpools\(dq: [ ],
                    \(dqrebind\-timer\(dq: 20,
                    \(dqrenew\-timer\(dq: 10,
                    // مشخص می‌کند که آیا کارساز باید رزروهای سراسری را جستجو کند یا خیر.
                    \(dqreservations\-global\(dq: false,
                    // مشخص می‌کند که آیا کارساز باید رزروهای درون زیرشبکه را جستجو کند یا خیر.
                    \(dqreservations\-in\-subnet\(dq: true,
                    // مشخص می‌کند که آیا کارساز می‌تواند فرض کند تمام آدرس‌های رزروشده
                    // خارج از استخر هستند یا خیر.
                    // در صورتی که reservations\-in\-subnet برابر false باشد نادیده گرفته می‌شود.
                    \(dqreservations\-out\-of\-pool\(dq: false,
                    \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
                    \(dqvalid\-lifetime\(dq: 30
                }
            ],
            \(dqvalid\-lifetime\(dq: 200
        } ], // پایان shared\-networks

        // این احتمال وجود دارد که در شبکه خود ترکیبی از زیرشبکه‌های عادی و
        // «ساده» و شبکه‌های اشتراکی داشته باشید. ترکیب آن‌ها در یک فایل
        // پیکربندی یکسان کاملاً معتبر است.

        // این یک زیرشبکه عادی است. بخشی از هیچ shared\-network نیست.
        \(dqsubnet4\(dq: [
            {
                \(dqpools\(dq: [ { \(dqpool\(dq:  \(dq192.0.3.1 \- 192.0.3.200\(dq } ],
                \(dqsubnet\(dq: \(dq192.0.3.0/24\(dq,
                \(dqinterface\(dq: \(dqeth0\(dq,
                \(dqid\(dq: 3
            }
        ]

    } // پایان Dhcp4
}
.EE
.UNINDENT
.UNINDENT.SS kea4/single\-subnet.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک فایل پیکربندی نمونه برای کارساز DHCPv4 در Kea است.
// این یک سناریوی پایه با یک زیرشبکه IPv4 پیکربندی‌شده است. این زیرشبکه
// شامل یک استخر واحد از آدرس‌های تخصیص‌یافته به‌صورت پویا است.

{ \(dqDhcp4\(dq:

{
// به Kea گفته شده است که تنها روی رابط eth0 شنود کند.
  \(dqinterfaces\-config\(dq: {
    \(dqinterfaces\(dq: [ \(dqeth0\(dq ]
  },

// باید پایگاه‌داده مورد استفاده برای ذخیره اجاره‌ها (leases) را مشخص کنیم. از
// ژوئن ۲۰۲۲، سه پس‌بند پایگاه‌داده پشتیبانی می‌شوند: MySQL،
// PostgreSQL و پایگاه‌داده درون‌حافظه‌ای Memfile.
// ما از memfile استفاده خواهیم کرد زیرا به هیچ راه‌اندازی اولیه‌ای نیاز ندارد.
  \(dqlease\-database\(dq: {
      \(dqtype\(dq: \(dqmemfile\(dq,
      \(dqlfc\-interval\(dq: 3600
  },

// آدرس‌ها با طول عمر ۴۰۰۰ ثانیه تخصیص داده خواهند شد.
  \(dqvalid\-lifetime\(dq: 4000,

// زمان‌سنج‌های renew و rebind کامنت شده‌اند. این بدان معناست که گزینه‌های
// ۵۸ و ۵۹ به کلاینت ارسال نخواهند شد. در این حالت، انتخاب مقادیر زمان‌سنج طبق RFC2131
// بر عهده کلاینت است. برای ارسال این گزینه‌ها به کلاینت، زمان‌سنج‌ها را از حالت
// کامنت خارج کنید.
//  \(dqrenew\-timer\(dq: 1000,
//  \(dqrebind\-timer\(dq: 2000,

// فهرست زیر زیرشبکه‌ها را تعریف می‌کند. در اینجا تنها یک زیرشبکه
// داریم. به Kea اعلام می‌کنیم که مستقیماً روی رابط محلی در دسترس است.
  \(dqsubnet4\(dq: [
    {
       \(dqpools\(dq: [ { \(dqpool\(dq:  \(dq192.0.2.1 \- 192.0.2.200\(dq } ],
       \(dqid\(dq: 1,
       \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
       \(dqinterface\(dq: \(dqeth0\(dq
    }
  ],

// پیکربندی زیر مربوط به گزارش‌گیری (logging) است. فرض بر این است که پیام‌هایی با حداقل
// سطح اطلاعاتی (info، warn، error و fatal) باید در stdout ثبت
// شوند. همچنین، می‌توانید stderr، نام یک فایل، یا \(aqsyslog\(aq را مشخص کنید
// که پیام‌های خروجی را از طریق syslog ذخیره می‌کند.
    \(dqloggers\(dq: [
        {
            \(dqname\(dq: \(dqkea\-dhcp4\(dq,
            \(dqoutput\-options\(dq: [
                {
                    \(dqoutput\(dq: \(dqstdout\(dq
                }
            ],
            \(dqseverity\(dq: \(dqINFO\(dq
        }
    ]
}

}
.EE
.UNINDENT
.UNINDENT
.SS kea4/vendor\-specific.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک فایل پیکربندی نمونه برای کارساز DHCPv4 در Kea است.
// هدف از این مثال، نمایش نحوه پیکربندی اطلاعات ویژه سازنده
// (Vendor Specific Information کد ۴۳) بخش ۸.۴ از RFC 2132 است.
{
    \(dqDhcp4\(dq: {
        \(dqoption\-def\(dq: [
            {
// دو گزینه‌ای که قصد داریم به عنوان زیرگزینه در گزینه ۴۳ بگنجانیم
// باید در سطح سراسری تعریف شوند
                \(dqarray\(dq: false,
                \(dqcode\(dq: 2,
                \(dqname\(dq: \(dqvlanid\(dq,
// زیرگزینه‌ها باید فضای (space) پیکربندی‌شده داشته باشند و نمی‌توانند با \(aqvendor\-\(aq شروع شوند
// در غیر این صورت به جای گزینه ۴۳ در گزینه ۱۲۵ گنجانده خواهند شد
                \(dqspace\(dq: \(dq339\(dq,
                \(dqtype\(dq: \(dquint32\(dq
            },
            {
                \(dqarray\(dq: false,
                \(dqcode\(dq: 3,
                \(dqname\(dq: \(dqdls\(dq,
                \(dqspace\(dq: \(dq339\(dq,
                \(dqtype\(dq: \(dqstring\(dq
            }
        ],
        \(dqclient\-classes\(dq: [
            {

// Kea به دسته‌بندی بر اساس گزینه ۶۰ نیاز دارد؛ می‌توانید از این الگو برای نام استفاده کنید:
// VENDOR_CLASS_ + محتوای گزینه ۶۰ (در این صورت به پارامتر test نیازی نیست)
// یا از هر نام دلخواهی استفاده کرده و پارامتر \(dqtest\(dq را متناسب با آن اضافه کنید؛ مانند:
// \(dqtest\(dq: \(dqsubstring(option[60].hex,0,9) == \(aqpartial\-content\-of\-option\-60\(aq\(dq
                \(dqname\(dq: \(dqVENDOR_CLASS_339\(dq,
                \(dqoption\-def\(dq: [
                    {
// گزینه Vendor\-specific باید در سطح کلاس تعریف شود؛ اگر قصد ارسال یک مقدار منفرد
// را داریم، نوع آن را متناسب با آن تعریف کنید. اگر این گزینه باید سایر زیرگزینه‌ها را در بر
// بگیرد، پارامتر \(dqspace\(dq باید با زیرگزینه‌های گنجانده‌شده یکسان باشد
// و \(dqtype\(dq روی empty تنظیم شود
                        \(dqcode\(dq: 43,
// با استفاده از دستورالعمل \(dqencapsulate\(dq، به Kea گفته می‌شود که گزینه‌ها را از
// فضای نام \(dq339\(dq در بر بگیرد. ما پیش‌تر چند مورد از این گزینه‌ها را تعریف کرده‌ایم.
// بدین ترتیب، زیرگزینه‌ها به این گزینه ۴۳ متصل (پیوست) می‌شوند.
                        \(dqencapsulate\(dq: \(dq339\(dq,
                        \(dqname\(dq: \(dqvendor\-encapsulated\-options\(dq,
                        \(dqtype\(dq: \(dqempty\(dq
                    }
                ],
                \(dqoption\-data\(dq: [
                    {
// گزینه vendor\-encapsulated\-options و گزینه تعریف‌شده در سطح سراسری نیز
// باید با پارامترهای \(dqdata\(dq مناسب در فهرست \(dqoption\-data\(dq پیکربندی شوند.
// از آنجا که Kea تنها گزینه‌هایی را ارسال می‌کند که کلاینت درخواست کرده باشد، و روشی
// برای درخواست زیرگزینه‌ها وجود ندارد، پارامتر \(dqalways\-send\(dq با مقدار
// تنظیم‌شده روی true نیز باید در تمام زیرگزینه‌های سفارشی گنجانده شود
                        \(dqname\(dq: \(dqvendor\-encapsulated\-options\(dq
                    },
                    {
                        \(dqalways\-send\(dq: true,
                        \(dqdata\(dq: \(dq123\(dq,
                        \(dqname\(dq: \(dqvlanid\(dq,
                        \(dqspace\(dq: \(dq339\(dq
                    },
                    {
                        \(dqalways\-send\(dq: true,
                        \(dqdata\(dq: \(dqsdlp://192.0.2.11:18443\(dq,
                        \(dqname\(dq: \(dqdls\(dq,
                        \(dqspace\(dq: \(dq339\(dq
                    }
                ]
            }
        ],
// به Kea گفته شده است که تنها روی رابط eth0 شنود کند.
        \(dqinterfaces\-config\(dq: {
            \(dqinterfaces\(dq: [\(dqeth0\(dq]
        },
// باید پایگاه‌داده مورد استفاده برای ذخیره اجاره‌ها (leases) را مشخص کنیم.
        \(dqlease\-database\(dq: {
            \(dqtype\(dq: \(dqmemfile\(dq
        },
// فهرست زیر زیرشبکه‌ها را تعریف می‌کند. در اینجا تنها یک زیرشبکه
// داریم. به Kea اعلام می‌کنیم که مستقیماً روی رابط محلی در دسترس است.
        \(dqsubnet4\(dq: [
            {
                \(dqinterface\(dq: \(dqeth0\(dq,
                \(dqpools\(dq: [
                    {
                        \(dqpool\(dq: \(dq192.0.2.50\-192.0.2.50\(dq
                    }
                ],
                \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
                \(dqid\(dq: 1
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT.SS kea4/vivso.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک فایل پیکربندی نمونه برای کارساز DHCPv4 در Kea است.
// هدف این مثال نمایش نحوه پیکربندی گزینه
// Vendor\-Identifying Vendor\-specific Information
// (کد 125) RFC 3925 است


{
    \(dqDhcp4\(dq: {
// اگر بخواهیم زیرگزینه‌ها را در گزینه 125 ارسال کنیم، ابتدا باید
// در سطح سراسری تعریف شوند
        \(dqoption\-def\(dq: [
            {
                \(dqarray\(dq: false,
                \(dqcode\(dq: 2,
                \(dqname\(dq: \(dqvlanid\(dq,
// در مورد زیرگزینه‌های گزینه 125، فضا باید با پیشوند \(dqvendor\-\(dq شروع شود
// در این مورد، \(dqvendor\-\(dq + شناسه سازنده از گزینه 60 ارسال‌شده توسط کلاینت است
// مقدار 339 مربوط به Siemens Industry Inc است.
                \(dqspace\(dq: \(dqvendor\-339\(dq,
                \(dqtype\(dq: \(dquint32\(dq
            },
            {
                \(dqarray\(dq: false,
                \(dqcode\(dq: 3,
                \(dqname\(dq: \(dqdls\(dq,
                \(dqspace\(dq: \(dqvendor\-339\(dq,
                \(dqtype\(dq: \(dqstring\(dq
            }
        ],
        \(dqclient\-classes\(dq: [
            {
// برنامه Kea به طبقه‌بندی بر اساس گزینه 60 نیاز دارد؛ می‌توانید از نام:
// VENDOR_CLASS_ + محتوای گزینه 60 استفاده کنید (که در این صورت پارامتر test لازم نیست)
// یا از هر نام دلخواهی استفاده کرده و پارامتر \(dqtest\(dq را بر این اساس اضافه کنید، مثلاً:
// \(dqtest\(dq: \(dqsubstring(option[60].hex,0,9) == \(aqpartial\-content\-of\-option\-60\(aq\(dq
                \(dqname\(dq: \(dqVENDOR_CLASS_339\(dq,
                \(dqoption\-data\(dq: [
                    {
// در فهرست \(dqoption\-data\(dq باید گزینه 125 را با پارامتر data برابر با
// vendor\-id مورد انتظارمان پیکربندی کنیم، همچنین این به Kea می‌گوید که کدام فضای سازنده را
// در زیرگزینه‌ها کپسوله‌سازی کند.
                        \(dqdata\(dq: \(dq339\(dq,
                        \(dqname\(dq: \(dqvivso\-suboptions\(dq
                    },
                    {
// و علاوه بر این باید تمام زیرگزینه‌های از پیش تعریف‌شده را با پارامتر \(dqspace\(dq
// یکسان با option\-def پیکربندی کنیم.
// از آنجا که Kea تنها گزینه‌هایی را ارسال می‌کند که کلاینت درخواست داده است، و راهی
// برای درخواست زیرگزینه‌ها وجود ندارد، پارامتر \(dqalways\-send\(dq با مقدار تنظیم‌شده
// روی true نیز باید در تمام زیرگزینه‌های سفارشی گنجانده شود.
                        \(dqalways\-send\(dq: true,
                        \(dqdata\(dq: \(dq123\(dq,
                        \(dqname\(dq: \(dqvlanid\(dq,
                        \(dqspace\(dq: \(dqvendor\-339\(dq
                    },
                    {
                        \(dqalways\-send\(dq: true,
                        \(dqdata\(dq: \(dqsdlp://192.0.2.11:18443\(dq,
                        \(dqname\(dq: \(dqdls\(dq,
                        \(dqspace\(dq: \(dqvendor\-339\(dq
                    }
                ]
            }
        ],
// به Kea دستور داده شده است که تنها روی رابط eth0 شنود کند.
        \(dqinterfaces\-config\(dq: {
            \(dqinterfaces\(dq: [
                \(dqeth0\(dq
            ]
        },
// باید پایگاه‌داده مورد استفاده برای ذخیره اجاره‌ها مشخص شود.
        \(dqlease\-database\(dq: {
            \(dqtype\(dq: \(dqmemfile\(dq
        },
// فهرست زیر زیرشبکه‌ها را تعریف می‌کند. در اینجا تنها یک زیرشبکه
// داریم. به Kea اعلام می‌کنیم که مستقیماً از طریق رابط محلی در دسترس است.
        \(dqsubnet4\(dq: [
            {
                \(dqid\(dq: 1,
                \(dqinterface\(dq: \(dqeth0\(dq,
                \(dqpools\(dq: [
                    {
                        \(dqpool\(dq: \(dq192.0.2.50\-192.0.2.50\(dq
                    }
                ],
                \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.SS kea4/with\-ddns.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک فایل پیکربندی نمونه برای کارساز DHCPv4 در Kea است.
// این یک سناریوی پایه‌ای با یک زیرشبکه IPv4 پیکربندی‌شده و با DDNS
// فعال است.

{ \(dqDhcp4\(dq:

{
// به Kea دستور داده شده است که تنها روی رابط eth0 شنود کند.
  \(dqinterfaces\-config\(dq: {
    \(dqinterfaces\(dq: [ \(dqeth0\(dq ]
  },

// باید پایگاه‌داده مورد استفاده برای ذخیره اجاره‌ها مشخص شود. تا
// ژوئن 2022، از سه زیرساخت پایگاه‌داده پشتیبانی می‌شود: MySQL ،PostgreSQL
// و پایگاه‌داده درون‌حافظه‌ای Memfile.
// ما از memfile استفاده خواهیم کرد زیرا به هیچ راه‌اندازی اولیه‌ای نیاز ندارد.
  \(dqlease\-database\(dq: {
      \(dqtype\(dq: \(dqmemfile\(dq,
      \(dqlfc\-interval\(dq: 3600
  },

// نشانی‌ها با طول عمر 4000 ثانیه اختصاص خواهند یافت.
  \(dqvalid\-lifetime\(dq: 4000,

// زمان‌سنج‌های تجدید (renew) و اتصال مجدد (rebind) کامنت شده‌اند. این بدان معناست که گزینه‌های
// 58 و 59 به کلاینت ارسال نخواهند شد. در این صورت، انتخاب مقادیر زمان‌سنج مطابق با RFC2131
// بر عهده کلاینت است. برای ارسال این گزینه‌ها به کلاینت، زمان‌سنج‌ها را از حالت کامنت
// خارج کنید.
//  \(dqrenew\-timer\(dq: 1000,
//  \(dqrebind\-timer\(dq: 2000,

// فهرست زیر زیرشبکه‌ها را تعریف می‌کند. در اینجا تنها یک زیرشبکه
// داریم. به Kea اعلام می‌کنیم که مستقیماً از طریق رابط محلی در دسترس است.
  \(dqsubnet4\(dq: [
    {
       \(dqpools\(dq: [ { \(dqpool\(dq:  \(dq192.0.2.1 \- 192.0.2.200\(dq } ],
       \(dqsubnet\(dq: \(dq192.0.2.0/24\(dq,
       \(dqinterface\(dq: \(dqeth0\(dq,
       \(dqid\(dq: 1
    }
  ],

// فعال‌سازی ارتباط با kea\-dhcp\-ddns
// (برای به‌روزرسانی‌های پویای DNS لازم است)
  \(dqdhcp\-ddns\(dq : {
        \(dqenable\-updates\(dq : true,
        \(dqserver\-ip\(dq : \(dq192.0.2.0\(dq,
        \(dqserver\-port\(dq : 3432,
        \(dqsender\-ip\(dq : \(dq192.0.2.1\(dq,
        \(dqsender\-port\(dq : 3433,
        \(dqmax\-queue\-size\(dq : 2048,
        \(dqncr\-protocol\(dq : \(dqUDP\(dq,
        \(dqncr\-format\(dq : \(dqJSON\(dq
   },

// فعال‌سازی به‌روزرسانی‌های DDNS و پیکربندی رفتار به‌روزرسانی DDNS
  \(dqddns\-send\-updates\(dq : true,
  \(dqddns\-override\-no\-update\(dq : true,
  \(dqddns\-override\-client\-update\(dq : true,
  \(dqddns\-replace\-client\-name\(dq : \(dqwhen\-present\(dq,
  \(dqddns\-generated\-prefix\(dq : \(dqtest.prefix\(dq,
  \(dqddns\-qualifying\-suffix\(dq : \(dqtest.suffix.\(dq,
  \(dqddns\-update\-on\-renew\(dq : false,
  \(dqddns\-conflict\-resolution\-mode\(dq: \(dqcheck\-with\-dhcid\(dq,
  \(dqddns\-ttl\-percent\(dq : 0.75,
  \(dqhostname\-char\-set\(dq: \(dq[^A\-Za\-z0\-9.\-]\(dq,
  \(dqhostname\-char\-replacement\(dq: \(dqx\(dq,

// بخش زیر ثبت وقایع (logging) را پیکربندی می‌کند. فرض می‌شود که پیام‌هایی
// با حداقل سطح اطلاعاتی (info، warn، error و fatal) باید در
// stdout ثبت شوند.
    \(dqloggers\(dq: [
        {
            \(dqname\(dq: \(dqkea\-dhcp4\(dq,
            \(dqoutput\-options\(dq: [
                {
                    \(dqoutput\(dq: \(dqstdout\(dq
                }
            ],
            \(dqseverity\(dq: \(dqINFO\(dq
        }
    ]
}

}
.EE
.UNINDENT
.UNINDENT.SS kea6
.SS kea6/advanced.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک فایل پیکربندی نمونه برای کارگزار DHCPv6 در Kea است.
// این پیکربندی تلاش می‌کند برخی از قابلیت‌های پیشرفته‌تر را نمایش دهد.
// از نظر توپولوژی، این یک سناریوی پایه با یک زیرشبکه IPv6 پیکربندی‌شده است.
// فرض بر این است که یک زیرشبکه (2001:db8:1::/64) به طور مستقیم
// روی رابط eth0 در دسترس است.
//
// قابلیت‌های زیر در اینجا به نمایش گذاشته شده‌اند:
// ۱. پیکربندی منابع آدرس سخت‌افزاری/MAC در DHCPv6
// ۲. گزینه‌های ارائه‌شده توسط رله (RSOO) \- برخی رله‌ها ممکن است گزینه‌هایی را با این
//    هدف درج کنند که کارگزار آن‌ها را در پیام‌های ارسالی به کلاینت قرار دهد.
// ۳. سوکت کنترلی (Control socket). Kea می‌تواند سوکتی باز کرده و به فرمان‌های
//    ورودی گوش فرا دهد.

{ \(dqDhcp6\(dq:

{
    // به Kea گفته شده است که تنها روی رابط شبکه eth0 گوش فرا دهد.
    \(dqinterfaces\-config\(dq: {
        \(dqinterfaces\(dq: [ \(dqeth0\(dq ],

        // این گزینه باعث می‌شود رابط‌ها در هر بار پیکربندی (مجدد) دوباره شناسایی شوند.
        // به طور پیش‌فرض روی true تنظیم شده است.
        \(dqre\-detect\(dq: true
    },

    // ما باید پایگاه‌داده مورد استفاده برای ذخیره اجاره‌ها (leases) را مشخص کنیم. تا
    // ژوئن ۲۰۲۲، سه پیشانه پایگاه‌داده پشتیبانی می‌شوند: MySQL ،PostgreSQL
    // و پایگاه‌داده درون‌حافظه‌ای Memfile.
    // ما از memfile استفاده خواهیم کرد زیرا نیازی به راه‌اندازی اولیه ندارد.
    \(dqlease\-database\(dq: {
        \(dqtype\(dq: \(dqmemfile\(dq,
        \(dqlfc\-interval\(dq: 3600
    },

     \(dqsanity\-checks\(dq: {
        // این پارامتر تعیین می‌کند هنگام مواجهه با یک اجاره جدید در سیستم چه کاری انجام
        // شود (یعنی در زمان راه‌اندازی memfile از دیسک خوانده شود یا از طریق فرمان‌های
        // lease اضافه شود). پنج حالت پشتیبانی می‌شود:
        // none \- هیچ کاری نکن، آن‌ها را همان‌گونه که هستند بپذیر
        // warn \- در صورت تشخیص مشکلات subnet\-id، یک هشدار چاپ کن، اما در غیر
        //        این صورت اجاره را همان‌طور بارگذاری کن. این مقدار پیش‌فرض است.
        // fix \- تلاش برای اصلاح اجاره با یافتن مقدار subnet\-id مناسب.
        //       اگر زیرشبکه مناسبی وجود نداشته باشد، اجاره همان‌طور بارگذاری می‌شود.
        // fix\-del \- تلاش برای اصلاح اجاره با یافتن مقدار subnet\-id مناسب.
        //           اگر زیرشبکه مناسبی یافت نشود، اجاره حذف می‌شود.
        // del \- حذف اجاره‌هایی که مقادیر subnet\-id نادرست دارند.
        \(dqlease\-checks\(dq: \(dqfix\-del\(dq
    },

    // نسخه 0.9.1 برنامه Kea پشتیبانی از آدرس‌های MAC/سخت‌افزاری را در DHCPv6 معرفی کرد.
    // هیچ روش واحد و قابل اعتمادی برای دریافت اطلاعات آدرس MAC در DHCPv6 وجود ندارد.
    // نرم‌افزار Kea از چندین روش پشتیبانی می‌کند. بسته به پیکربندی شبکه شما، برخی روش‌ها
    // ممکن است به بقیه ترجیح داده شوند، از این رو این پارامتر پیکربندی وجود دارد.
    // \(aqmac\-sources\(aq فهرستی از روش‌هاست. مقادیر مجاز عبارتند از:
    // any، raw، duid، ipv6\-link\-local، client\-link\-addr\-option، rfc6939 (که
    // یک نام مستعار برای client\-link\-addr\-option است)، remote\-id، rfc4649 (که یک
    // نام مستعار برای remote\-id است)، subscriber\-id، rfc4580 (که یک نام مستعار برای
    // subscriber\-id است) و docsis.

    // توجه داشته باشید که ترتیب اهمیت دارد. روش‌ها یک‌به‌یک به همان ترتیب تعیین‌شده
    // بررسی می‌شوند تا آدرس سخت‌افزاری به دست آید. اگر تفاوتی ندارد که کدام روش استفاده
    // شود، استفاده از \(aqany\(aq اندکی سریع‌تر از فهرست کردن همه آن‌هاست.

    // اگر mac\-sources مشخص نشده باشد، مقدار پیش‌فرض \(aqany\(aq استفاده می‌شود.
    \(dqmac\-sources\(dq: [ \(dqclient\-link\-addr\-option\(dq, \(dqduid\(dq, \(dqipv6\-link\-local\(dq ],

    // استاندارد RFC6422 سازوکاری موسوم به relay\-supplied options option را تعریف
    // می‌کند. عامل رله می‌تواند گزینه‌های خاصی را درج کند که در صورت وجود معیارهای
    // مشخص، کارگزار آن‌ها را به کلاینت منعکس کند (echo back). یک شرط این است که گزینه
    // باید RSOO\-enabled باشد (یعنی اجازه انعکاس داشته باشد). آیانا فهرستی از این گزینه‌ها
    // را در اینجا نگهداری می‌کند:
    // http://www.iana.org/assignments/dhcpv6\-parameters/dhcpv6\-parameters.xhtml#options\-relay\-supplied
    // با این حال، امکان اجازه به کارگزار برای انعکاس گزینه‌های اضافی وجود دارد.
    // این مدخل گزینه‌های 110، 120 و 130 را به عنوان RSOO\-enabled علامت‌گذاری می‌کند.
    \(dqrelay\-supplied\-options\(dq: [ \(dq110\(dq, \(dq120\(dq, \(dq130\(dq ],

    // این مورد یک سوکت کنترلی را تعریف می‌کند. در صورت تعریف، Kea یک سوکت UNIX
    // باز کرده و به فرمان‌های دریافتی گوش می‌دهد. برای فهرست فرمان‌های پشتیبانی‌شده،
    // بخش ۱۵ از راهنمای کاربر Kea را ببینید.
    \(dqcontrol\-socket\(dq: {
        \(dqsocket\-type\(dq: \(dqunix\(dq,
        \(dqsocket\-name\(dq: \(dqkea6\-ctrl\-socket\(dq
    },

    // آدرس‌ها با طول عمر ترجیحی (preferred) و معتبر (valid) به ترتیب با مقادیر
    // ۳۰۰۰ و ۴۰۰۰ ثانیه تخصیص داده می‌شوند. به کلاینت گفته می‌شود که پس از ۱۰۰۰ ثانیه
    // تمدید را آغاز کند. اگر کارگزار پس از ۲۰۰۰ ثانیه از زمان واگذاری اجاره پاسخی
    // ندهد، کلاینت باید روال REBIND را آغاز کند (تمدید اضطراری که امکان تغییر
    // کارگزار به یک کارگزار دیگر را فراهم می‌کند).
    \(dqpreferred\-lifetime\(dq: 3000,
    \(dqvalid\-lifetime\(dq: 4000,
    \(dqrenew\-timer\(dq: 1000,
    \(dqrebind\-timer\(dq: 2000,

    // فهرست زیر زیرشبکه‌ها را تعریف می‌کند. هر زیرشبکه حداقل از ورودی‌های subnet
    // و pool تشکیل شده است. به user\-context استفاده‌شده در سراسر تعاریف دقت کنید.
    // این داده‌ها مستقیماً توسط Kea استفاده نمی‌شوند، بلکه فقط تجزیه شده و در ساختارهای
    // مناسب ذخیره می‌گردند. تا زمانی که ساختار یک JSON معتبر باشد و با یک نگاشت (map)
    // شروع شود (یعنی درون کروشه‌های فرفری محصور باشد)، هر چیزی را می‌توانید در
    // user\-context قرار دهید.
    // یک ورودی کامنت به یک user\-context دارای ویژگی \(dqcomment\(dq ترجمه می‌شود،
    // بنابراین می‌توانید یادداشت‌ها را درون خود پیکربندی درج کنید.
    \(dqsubnet6\(dq: [
    {
        \(dqpools\(dq: [
            {
                \(dqpool\(dq: \(dq2001:db8:1::/80\(dq,

                // این user context اختصاصی برای این استخر (pool) خاص است. می‌توانید از آن
                // برای توصیف استخر استفاده کنید. فقط به خاطر داشته باشید که این ساختار مستقیماً
                // توسط خود Kea استفاده نخواهد شد؛ بلکه در دسترس قلاب‌ها (hooks) قرار می‌گیرد
                // تا در صورت نیاز از آن استفاده کنند.
                \(dquser\-context\(dq: { \(dqdepartment\(dq: \(dqengineering\(dq }
            }],

        // در اینجا user\-context برای کل زیرشبکه آمده است.
        \(dquser\-context\(dq: { \(dqcomment\(dq: \(dqFloor one, west wing\(dq },
        // معادل با استفاده از تجزیه‌کننده هوشمند
        // \(dqcomment\(dq: \(dqFloor one, west wing\(dq,

        // این بخش استخرهای تفویض پیشوند (PD - prefix delegation) را تعریف می‌کند.
        // در این حالت ما فقط یک استخر داریم که شامل پیشوندهای /64 تفویض‌شده از یک
        // استخر بزرگ /48 است. هر پیشوند تفویض‌شده شامل گزینه excluded\-prefix خواهد بود.
        \(dqpd\-pools\(dq: [
        {
            \(dqprefix\(dq: \(dq2001:db8:abcd::\(dq,
            \(dqprefix\-len\(dq: 48,
            \(dqdelegated\-len\(dq: 64,
            \(dqexcluded\-prefix\(dq: \(dq2001:db8:abcd:0:1234::\(dq,
            \(dqexcluded\-prefix\-len\(dq: 80,

            // یک user\-context دیگر برای این استخر PD. باز هم تا زمانی که یک JSON معتبر
            // باشد و با یک نگاشت آغاز شود، می‌توانید هر داده‌ای را در آن قرار دهید.
            \(dquser\-context\(dq: {
                \(dqpurpose\(dq: \(dqFor CPE devices\(dq
            }
        }
        ], // پایان استخرها

        \(dqid\(dq: 1,
        \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
        \(dqinterface\(dq: \(dqeth0\(dq,

        // گاهی رله ممکن است از یک نشانی IPv6 نامتعارف استفاده کند که با زیرشبکه مطابقت
        // ندارد. این کار توصیه نمی‌شود، اما در مواردی منطقی و مجاز است. یک مورد زمانی
        // است که رله فقط نشانی link\-local دارد و مورد دیگر در سناریوی زیرشبکه اشتراکی است.
        \(dqrelay\(dq: {
            \(dqip\-addresses\(dq: [ \(dq3000::1\(dq ]
        }
    }
    ],

// بخش زیر گزارش‌گیری (logging) را پیکربندی می‌کند. فرض بر این است که پیام‌هایی
// حداقل با سطح اطلاع‌رسانی (info، warn، error و fatal) باید در stdout ثبت شوند.
    \(dqloggers\(dq: [
        {
            \(dqname\(dq: \(dqkea\-dhcp6\(dq,
            \(dqoutput\-options\(dq: [
                {
                    \(dqoutput\(dq: \(dqstdout\(dq,
                    // علاوه بر خروجی معمولی، چندین پارامتر دیگر نیز امکان‌پذیر است. Flush تعیین
                    // می‌کند که آیا لاگر خروجی را سریعاً به فایل تخلیه کند یا خیر. Maxsize حداکثر
                    // اندازه فایل را پیش از چرخش (rotation) تعیین می‌کند. maxver
                    // حداکثر تعداد فایل‌های چرخیده‌شده‌ای را که نگهداری می‌شوند مشخص
                    // می‌سازد.
                    \(dqflush\(dq: true,
                    \(dqmaxsize\(dq: 204800,
                    \(dqmaxver\(dq: 4,
                    // ما از pattern برای مشخص کردن قالب سفارشی پیام‌های گزارش استفاده می‌کنیم
                    \(dqpattern\(dq: \(dq%d{%y.%m.%d %H:%M:%S.%q} %\-5p [%c/%i] %m\en\(dq
                }
            ],
            \(dqdebuglevel\(dq: 0,
            \(dqseverity\(dq: \(dqINFO\(dq
        }
    ]
}

}
.EE
.UNINDENT
.UNINDENT.SS kea6/all\-keys\-netconf.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// هشدار: این پیکربندی نمونه برای استفاده در محیط عملیاتی در نظر گرفته نشده است.
// کارگزار Kea DHCPv6 این پیکربندی را رد خواهد کرد زیرا شامل پارامترهای
// پیکربندی ناسازگار با یکدیگر (مانعة‌الجمع) است.
//
// هدف اصلی این فایل نمونه، ارائه فهرستی جامع از پارامترهای پشتیبانی‌شده
// توسط کارگزار Kea DHCPv6 به همراه توضیح مختصری از هر پارامتر است.
//
// این نسخه پایدار برای YANG استفاده می‌شود، زیرا نمی‌خواهیم با هر بار
// افزودن یک کلیدواژه به نحو، کدها و مدل‌ها به‌روزرسانی شوند.
{
    // پیکربندی کارگزار Kea DHCPv6 از اینجا آغاز می‌شود.
    \(dqDhcp6\(dq: {
        // پرچم سراسری جهت انتخاب راهبرد تخصیص آدرس IP برای همه
        // زیرشبکه‌ها.
        \(dqallocator\(dq: \(dqiterative\(dq,

        // پرچم سراسری برای فعال یا غیرفعال کردن ثبت آدرس کلاینت
        // از طریق بسته‌های ADDR\-REG\-INFORM (RFC 9686 را ببینید). پیش‌فرض آن true است.
        \(dqallow\-address\-registration\(dq: true,

        // پرچم سراسری جهت انتخاب راهبرد تخصیص پیشوند واگذارشده (delegated prefix)
        // برای همه زیرشبکه‌ها.
        \(dqpd\-allocator\(dq: \(dqrandom\(dq,

        // فهرست مرتب‌شده‌ای از کلاس‌های کلاینت مورد استفاده کارگزار DHCPv6.
        \(dqclient\-classes\(dq: [
            {
                // نام کلاس.
                \(dqname\(dq: \(dqphones_server1\(dq,

                // فهرست گزینه‌های DHCPv6 ویژه کلاس.
                \(dqoption\-data\(dq: [],

                // عبارت انتخاب کلاس. بسته DHCP زمانی به این کلاس
                // اختصاص داده می‌شود که مقدار عبارت داده‌شده true ارزیابی شود.
                \(dqtest\(dq: \(dqmember(\(aqHA_server1\(aq)\(dq,

                // مدت اعتبار کلاس.
                \(dqvalid\-lifetime\(dq: 6000,

                // حداقل مدت اعتبار کلاس.
                \(dqmin\-valid\-lifetime\(dq: 4000,

                // حداکثر مدت اعتبار کلاس.
                \(dqmax\-valid\-lifetime\(dq: 8000,

                // مدت ترجیحی کلاس.
                \(dqpreferred\-lifetime\(dq: 7000,

                // حداقل مدت ترجیحی کلاس.
                \(dqmin\-preferred\-lifetime\(dq: 5000,

                // حداکثر مدت ترجیحی کلاس.
                \(dqmax\-preferred\-lifetime\(dq: 9000
            },
            {
                // نام کلاس دوم.
                \(dqname\(dq: \(dqphones_server2\(dq,

                // فهرست گزینه‌های DHCPv6 ویژه کلاس.
                \(dqoption\-data\(dq: [],

                // عبارت انتخاب کلاس. بسته DHCP زمانی به این کلاس
                // اختصاص داده می‌شود که مقدار عبارت داده‌شده true ارزیابی شود.
                \(dqtest\(dq: \(dqmember(\(aqHA_server2\(aq)\(dq
            },
            {
                // نام کلاس سوم.
                \(dqname\(dq: \(dqlate\(dq,

                // پرچم بولی که مشخص می‌کند آیا عبارت کلاس فقط در صورت نیاز به کلاس ارزیابی
                // شود یا خیر؛ برای مثال، پیکربندی استخر آدرس انتخاب‌شده شامل نام این کلاس
                // در فهرست \(dqevaluate\-additional\-classes\(dq باشد. مقدار پیش‌فرض false به این معنی
                // است که عبارت آزمون کلاس باید همیشه ارزیابی شود.
                \(dqonly\-in\-additional\-list\(dq: true,

                // عبارت انتخاب کلاس.
                \(dqtest\(dq: \(dqmember(\(aqALL\(aq)\(dq
            },
            {
                // نام کلاس چهارم.
                \(dqname\(dq: \(dqmy\-template\-class\(dq,

                // پرچم کلاس الگو که حاوی عبارت مورد استفاده برای تولید نام تمام زیرکلاس‌های
                // ایجادشده است. در این حالت، کلاس‌ها بر اساس شناسه کلاینت (client ID) نام‌گذاری می‌شوند.
                \(dqtemplate\-test\(dq: \(dqsubstring(option[1].hex, 0, all)\(dq
            }
        ],

        // پارامترهایی برای فعال‌سازی رفتارهای سازگار با کلاینت‌ها،
        // رله‌ها یا سایر عامل‌های دارای نقص یا ناسازگار با استاندارد
        \(dqcompatibility\(dq: {
            // تجزیه ملایم‌تر گزینه‌ها در جایی که فیلدها می‌توانند به طور قطعی
            // استنتاج شوند، حتی اگر بر خلاف RFC یا رویه معمول باشد.
            \(dqlenient\-option\-parsing\(dq: true
        },

        // پارامترهای پیکربندی سوکت کنترل فرمان برای کارگزار Kea DHCPv6.
        \(dqcontrol\-sockets\(dq: [
            {
                // نوع سوکت کنترل مورد استفاده کارگزار Kea DHCPv6.
                // باید unix، http یا https باشد.
                \(dqsocket\-type\(dq: \(dqunix\(dq,

               // مکان فایل سوکت دامنه‌ای یونیکس (UNIX domain socket) که
               // کارگزار DHCPv6 برای دریافت فرمان‌های کنترلی از مدیر محلی
               // سرور استفاده می‌کند.
               \(dqsocket\-name\(dq: \(dqkea6\-ctrl\-socket\(dq
            },
            {
                // نوع سوکت کنترل مورد استفاده کارگزار Kea DHCPv6.
                // باید unix، http یا https باشد.
                \(dqsocket\-type\(dq: \(dqhttps\(dq,

                // آدرس سوکت HTTPS که کارگزار Kea DHCPv6 باید برای پرس‌وجوهای
                // ورودی روی آن شنود کند.
                \(dqsocket\-address\(dq: \(dq::1\(dq,

                // درگاه سوکت HTTPS که کارگزار Kea DHCPv6 باید برای پرس‌وجوهای
                // ورودی روی آن شنود کند. در صورت فعال‌سازی پایداری بالا (HA)
                // و چندنخی، درگاه 8000 توسط شنونده http کتابخانه قلاب HA
                // استفاده می‌شود. هنگام استفاده از کتابخانه قلاب HA همراه با چندنخی
                // برای عملکرد صحیح، مطمئن شوید درگاه استفاده‌شده توسط شنونده اختصاصی
                // با درگاه مشخص‌شده در اینجا متفاوت باشد (مثلاً 8001). توجه داشته باشید
                // که فرمان‌ها همچنان باید به یک سوکت کنترل ارسال شوند. شنونده
                // اختصاصی منحصراً برای به‌روزرسانی‌های HA است.
                \(dqsocket\-port\(dq: 8006,

                // لنگر اعتماد TLS (مرجع صدور گواهی یا CA). این یک نام فایل
                // یا مسیر دایرکتوری است. تنها برای سوکت کنترل از نوع https
                // همراه با سایر پارامترهای TLS کاربرد دارد.
                \(dqtrust\-anchor\(dq: \(dqmy\-ca\(dq,

                // نام فایل گواهی سرور TLS.
                \(dqcert\-file\(dq: \(dqmy\-cert\(dq,

                // نام فایل کلید خصوصی سرور TLS.
                \(dqkey\-file\(dq: \(dqmy\-key\(dq,

                // پرچم الزام گواهی‌های کلاینت TLS. پیش‌فرض true است
                // و به معنای الزام به وجود گواهی‌های کلاینت است.
                // مقدار false اختیاری بودن آن‌ها را می‌رساند.
                \(dqcert\-required\(dq: true,

                // هدرهای اضافی HTTP جهت افزودن به پاسخ‌ها.
                \(dqhttp\-headers\(dq:
                [
                    {
                        // بافتار اختیاری کاربر (user context).
                        \(dquser\-context\(dq: { \(dqcomment\(dq: \(dqHSTS header\(dq },

                        // نام الزامی هدر HTTP.
                        \(dqname\(dq: \(dqStrict\-Transport\-Security\(dq,

                        // مقدار الزامی هدر HTTP.
                        \(dqvalue\(dq: \(dqmax\-age=31536000\(dq
                    }
                ],

                // احراز هویت اختیاری.
                \(dqauthentication\(dq: {

                    // نوع الزامی احراز هویت. تنها مقدار پشتیبانی‌شده
                    // basic برای احراز هویت پایه HTTP است.
                    \(dqtype\(dq: \(dqbasic\(dq,

                    // یک پارامتر اختیاری، قلمرو (realm) احراز هویت پایه
                    // HTTP است. پیش‌فرض آن
                    // \(dqkea\-dhcpv6\-server\(dq است.
                    \(dqrealm\(dq: \(dqkea\-dhcpv6\-server\(dq,

                    // از این پارامتر اختیاری می‌توان برای تعیین یک پیشوند مشترک
                    // برای فایل‌های مدیریت اعتبارنامه‌های کلاینت استفاده کرد.
                    \(dqdirectory\(dq: \(dq/usr/local/share/kea/kea\-creds\(dq,

                    // این فهرست شناسه‌های کاربری و گذرواژه‌های مورد استفاده
                    // برای احراز هویت پایه HTTP را مشخص می‌کند. اگر خالی باشد
                    // یا وجود نداشته باشد، هر کلاینتی مجاز شمرده می‌شود.
                    \(dqclients\(dq: [
                        // این مورد یک کلاینت مجاز را مشخص می‌کند.
                        {
                            // شناسه کاربر نباید خالی باشد یا شامل
                            // نویسه \(aq:\(aq باشد. این یک پارامتر
                            // اجباری است.
                            \(dquser\(dq: \(dqadmin\(dq,

                            // اگر گذرواژه مشخص نشود، از گذرواژه
                            // خالی استفاده می‌شود.
                            \(dqpassword\(dq: \(dq1234\(dq
                        },

                        // این مورد یک کلاینت مخفی را مشخص می‌کند.
                        {
                            // شناسه کاربر محتوای فایل
                            // /usr/local/share/kea/kea\-creds/hiddenu است.
                            \(dquser\-file\(dq: \(dqhiddenu\(dq,

                            // گذرواژه محتوای فایل
                            // /usr/local/share/kea/kea\-creds/hiddenp است.
                            \(dqpassword\-file\(dq: \(dqhiddenp\(dq
                        },

                        // این مورد یک کلاینت مخفی را با استفاده از یک
                        // راز در یک فایل مشخص می‌کند.
                        {
                            // راز، محتوای فایل
                            // /usr/local/share/kea/kea\-creds/hiddens است که باید در
                            // قالب <user\-id>:<password> باشد.
                            \(dqpassword\-file\(dq: \(dqhiddens\(dq
                        }
                    ]
                }
            }
        ],

        // پیشوندی را برای الحاق به ابتدای Client FQDN تولیدشده مشخص می‌کند.
        // می‌تواند در سطوح سراسری، shared\-network و subnet تعیین شود.
        \(dqddns\-generated\-prefix\(dq: \(dqmyhost\(dq,

        // پرچم بولی که مشخص می‌کند آیا سرور باید تمایل کلاینت DHCP برای
        // به‌روزرسانی DNS توسط خودش را نادیده بگیرد یا خیر. با تنظیم این پرچم روی true،
        // سرور به‌روزرسانی‌های DNS را برای هر دو داده‌های DNS مستقیم و
        // معکوس ارسال خواهد کرد. مقدار پیش‌فرض false است که نشان می‌دهد
        // سرور در صورت درخواست، به‌روزرسانی DNS را به کلاینت واگذار می‌کند.
        // می‌تواند در سطوح سراسری، shared\-network و subnet تعیین شود.
        \(dqddns\-override\-client\-update\(dq: false,

        // پرچم بولی که مشخص می‌کند آیا سرور باید تمایل کلاینت DHCP مبنی بر
        // عدم به‌روزرسانی DNS را لغو کند یا خیر. با تنظیم این پارامتر روی
        // true، سرور حتی زمانی که کلاینت درخواست عدم به‌روزرسانی داده باشد نیز
        // به‌روزرسانی DNS را ارسال می‌کند. می‌تواند در سطوح سراسری،
        // shared\-network و subnet تعیین شود.
        \(dqddns\-override\-no\-update\(dq: false,

        // پسوندی که به نام جزئی ارسال‌شده به DNS ملحق می‌شود. مقدار پیش‌فرض
        // یک رشته خالی است که نشان می‌دهد هیچ پسوندی الحاق نمی‌شود. می‌تواند در
        // سطوح سراسری، shared\-network و subnet تعیین شود.
        \(dqddns\-qualifying\-suffix\(dq: \(dq\(dq,

        // شمارشی که مشخص می‌کند آیا سرور باید نام میزبان یا Client FQDN
        // ارسال‌شده توسط کلاینت را رعایت کند یا آن را جایگزین نماید.
        // مقادیر مجاز عبارتند از: \(dqnever\(dq (استفاده از نام ارسالی کلاینت)،
        // \(dqalways\(dq (جایگزینی نام ارسالی کلاینت)، \(dqwhen\-present\(dq (جایگزینی
        // نام ارسالی کلاینت، اما عدم تولید نام در صورتی که کلاینت نامی ارسال
        // نکرده باشد)، \(dqwhen\-not\-present\(dq (تولید نام زمانی که کلاینت نامی
        // ارسال نکرده باشد، در غیر این صورت حفظ نام ارسالی کلاینت).
        // مقدار پیش‌فرض \(dqnever\(dq است. می‌تواند در سطوح سراسری،
        // shared\-network و subnet تعیین شود.
        \(dqddns\-replace\-client\-name\(dq: \(dqnever\(dq,

        // پرچم بولی که به‌روزرسانی DDNS را فعال یا غیرفعال می‌کند. مقدار
        // پیش‌فرض آن true است. می‌تواند در سطوح سراسری، shared\-
        // network و subnet تعیین شود. این گزینه در ارتباط با
        // dhcp\-ddns:enable\-updates کار می‌کند که برای برقراری اتصال به
        // kea\-dhcp\-ddns باید روی true باشد.
        \(dqddns\-send\-updates\(dq: true,

        // پرچم بولی که در صورت true بودن، به سرور دستور می‌دهد هنگام تمدید اجاره‌ها
        // همیشه DNS را به‌روزرسانی کند، حتی اگر اطلاعات DNS تغییری نکرده باشد.
        // رفتار پیش‌فرض سرور (یعنی false بودن پرچم) به‌روزرسانی DNS صرفاً در
        // صورت تغییر اطلاعات DNS است. می‌تواند در سطوح سراسری،
        // shared\-network و subnet تعیین شود.
        \(dqddns\-update\-on\-renew\(dq: true,

        // پرچم بولی که همراه با هر درخواست به‌روزرسانی DDNS به kea\-dhcp\-ddns
        // ارسال می‌شود تا مشخص کند آیا حل تعارض به‌روزرسانی DNS طبق
        // RFC 4703 باید برای درخواست داده‌شده به کار رود یا خیر. مقدار پیش‌فرض
        // برای این پرچم true است. می‌تواند در سطوح سراسری، shared\-network و subnet تعیین شود.
        // این فیلد با ddns\-conflict\-resolution\-mode جایگزین شده است.
        // تجزیه آن صرفاً جهت سازگاری رو به عقب حفظ شده است.
        // \(dqddns\-use\-conflict\-resolution\(dq: true,

        // شمارشی که همراه با هر درخواست به‌روزرسانی DDNS به kea\-dhcp\-ddns
        // ارسال می‌شود تا حالت مورد استفاده برای حل تعارض‌ها حین انجام به‌روزرسانی‌های
        // DDNS را مشخص کند. مقادیر مجاز عبارتند از:
        // check\-with\-dhcid (شامل افزودن رکورد DHCID و بررسی آن رکورد از طریق تشخیص تعارض طبق RFC 4703)،
        // no\-check\-with\-dhcid (تشخیص تعارض را نادیده می‌گیرد اما هنگام ایجاد/به‌روزرسانی ورودی یک رکورد DHCID اضافه می‌کند)،
        // check\-exists\-with\-dhcid (وجود رکورد DHCID موجود را بررسی می‌کند اما تطابق مقدار رکورد با به‌روزرسانی را بررسی نمی‌کند.
        // این حالت همچنین رکورد DHCID را برای ورودی به‌روزرسانی می‌کند)،
        // no\-check\-without\-dhcid (تشخیص تعارض را نادیده می‌گیرد و هنگام ایجاد/به‌روزرسانی ورودی DDNS رکورد DHCID اضافه نمی‌کند).
        // مقدار پیش‌فرض \(dqcheck\-with\-dhcid\(dq است. می‌تواند در سطوح سراسری،
        // shared\-network و subnet تعیین شود.
        \(dqddns\-conflict\-resolution\-mode\(dq: \(dqcheck\-with\-dhcid\(dq,

        // در صورت بزرگ‌تر بودن از 0.0، درصدی از طول عمر اجاره است
        // که برای DNS TTL استفاده می‌شود.
        \(dqddns\-ttl\-percent\(dq: 0.75,

        // در صورت بزرگ‌تر بودن از 0، به عنوان DNS TTL استفاده خواهد شد. بر حسب ثانیه مشخص می‌شود.
        // نمی‌توان هم ddns\-ttl و هم هر یک از ddns\-ttl\-percent، ddns\-ttl\-min یا
        // ddns\-ttl\-max را مشخص کرد. آن‌ها مانعة‌الجمع هستند.
        // \(dqddns\-ttl\(dq: 500,

        // در صورت بزرگ‌تر بودن از 0، به عنوان کران پایین مقادیر محاسبه‌شده DNS TTL استفاده می‌شود.
        // بر حسب ثانیه مشخص می‌شود.
        \(dqddns\-ttl\-min\(dq: 24000,

        // در صورت بزرگ‌تر بودن از 0، به عنوان کران بالای مقادیر محاسبه‌شده DNS TTL استفاده می‌شود.
        // بر حسب ثانیه مشخص می‌شود.
        \(dqddns\-ttl\-max\(dq: 64000,

        // مدت‌زمان بر حسب ثانیه که مشخص می‌کند یک اجاره ردشده تا چه مدت باید
        // از تخصیص‌های DHCP مستثنی شود. مقدار پیش‌فرض 24 ساعت است.
        \(dqdecline\-probation\-period\(dq: 86400,

        // پیکربندی ارسال درخواست‌های تغییر نام (NCR) برای کارگزار Kea DHCPv6.
        // درخواست‌های NCR پس از تخصیص اجاره‌های DHCP، برای به‌روزرسانی DNS به ماژول
        // Kea D2 ارسال می‌شوند.
        \(dqdhcp\-ddns\(dq: {
            // پرچم بولی که مشخص می‌کند آیا کارگزار Kea DHCPv6 باید به
            // kea\-dhcp\-ddns متصل شود یا خیر. برای ایجاد و ارسال NCRها
            // به kea\-dhcp\-ddns، این مقدار باید true باشد. به طور پیش‌فرض، NCRها تولید نمی‌شوند.
            \(dqenable\-updates\(dq: false,

            // حداکثر تعداد NCRهایی که در صف در انتظار ارسال
            // به سرور Kea D2 قرار می‌گیرند را مشخص می‌کند.
            \(dqmax\-queue\-size\(dq: 1024,

            // قالب بسته مورد استفاده هنگام ارسال NCRها به سرور Kea D2.
            // در حال حاضر فقط قالب JSON پشتیبانی می‌شود.
            \(dqncr\-format\(dq: \(dqJSON\(dq,

            // پروتکل سوکت برای ارسال NCRها به D2. در حال حاضر
            // فقط UDP پشتیبانی می‌شود.
            \(dqncr\-protocol\(dq: \(dqUDP\(dq,

            // آدرس IP که کارگزار Kea DHCPv6 باید برای ارسال NCRها
            // به D2 استفاده کند. مقدار پیش‌فرض صفر نشان می‌دهد که Kea
            // باید یک آدرس مناسب را انتخاب کند.
            \(dqsender\-ip\(dq: \(dq::1\(dq,

            // شماره درگاهی که کارگزار Kea DHCPv6 باید برای ارسال NCRها
            // به D2 استفاده کند. مقدار پیش‌فرض صفر نشان می‌دهد که Kea
            // باید یک درگاه مناسب را انتخاب کند.
            \(dqsender\-port\(dq: 0,

            // آدرس IP که D2 برای دریافت NCRها روی آن شنود می‌کند.
            \(dqserver\-ip\(dq: \(dq::1\(dq,

            // شماره درگاهی که D2 برای دریافت NCRها روی آن شنود می‌کند.
            \(dqserver\-port\(dq: 53001
        },

        // اولین مورد از دو درگاه متوالی سوکت‌های UDP مورد استفاده
        // برای ارتباط بین کارگزارهای DHCPv6 و DHCPv4 را مشخص می‌کند.
        // RFC 7341 را ببینید (پیش‌فرض 0 \- غیرفعال).
        // در صورت فعال بودن، مثلاً از 786 استفاده کنید.
        \(dqdhcp4o6\-port\(dq: 0,

        // مجموعه‌ای از پارامترهای کارگزار Kea DHCPv6 که نحوه
        // پردازش اجاره‌های منقضی‌شده DHCP را توسط سرور پیکربندی می‌کنند.
        \(dqexpired\-leases\-processing\(dq: {
            // تعداد ثانیه‌ها از زمان آخرین حذف اجاره‌های منقضی‌شده
            // را مشخص می‌کند که پس از آن حذف بعدی باید رخ دهد.
            // اگر هر دو مقدار \(dqflush\-reclaimed\-timer\-wait\-time\(dq و
            // \(dqhold\-reclaimed\-time\(dq غیر صفر باشند، هنگامی که کلاینت یک پیام
            // release ارسال می‌کند، اجاره به جای حذف از فضای ذخیره اجاره،
            // منقضی می‌شود.
            \(dqflush\-reclaimed\-timer\-wait\-time\(dq: 25,

            // مدت‌زمان بر حسب ثانیه جهت نگهداری اجاره‌های منقضی‌شده
            // در پایگاه‌داده اجاره (وابستگی اجاره یا lease affinity).
            // اگر هر دو مقدار \(dqflush\-reclaimed\-timer\-wait\-time\(dq و
            // \(dqhold\-reclaimed\-time\(dq غیر صفر باشند، هنگامی که کلاینت یک پیام
            // release ارسال می‌کند، اجاره به جای حذف از فضای ذخیره اجاره،
            // منقضی می‌شود.
            \(dqhold\-reclaimed\-time\(dq: 3600,

            // حداکثر تعداد اجاره‌های منقضی‌شده قابل پردازش در یک
            // تلاش منفرد برای پاکسازی اجاره‌های منقضی‌شده از پایگاه‌داده
            // اجاره را مشخص می‌کند. اگر اجاره‌های منقضی بیشتری وجود داشته باشد،
            // در تلاش پاکسازی بعدی پردازش خواهند شد.
            \(dqmax\-reclaim\-leases\(dq: 100,

            // حداکثر زمان بر حسب میلی‌ثانیه که یک تلاش منفرد برای
            // پاکسازی اجاره‌های منقضی‌شده از پایگاه‌داده اجاره ممکن است طول بکشد.
            \(dqmax\-reclaim\-time\(dq: 250,

            // مدت‌زمان بر حسب ثانیه از زمان آخرین تلاش برای پردازش
            // اجاره‌های منقضی‌شده قبل از آغاز تلاش بعدی.
            \(dqreclaim\-timer\-wait\-time\(dq: 10,

            // حداکثر تعداد چرخه‌های پردازش اجاره منقضی‌شده که منجر به
            // پاکسازی کامل اجاره‌های منقضی از پایگاه‌داده اجاره نشده‌اند؛
            // پس از این تعداد، یک پیام هشدار صادر می‌شود.
            \(dqunwarned\-reclaim\-cycles\(dq: 5
        },

        // فهرست کتابخانه‌های قلاب (hook libraries) و پارامترهای پیکربندی خاص
        // آن‌ها جهت بارگذاری توسط کارگزار Kea DHCPv4.
        \(dqhooks\-libraries\(dq: [
            {
                // مکان کتابخانه قلاب جهت بارگذاری.
                \(dqlibrary\(dq: \(dqlibdhcp_lease_cmds.so\(dq,

                // پارامترهای پیکربندی خاص کتابخانه قلاب.
                \(dqparameters\(dq: { }
            },
            {
                // کتابخانه قلاب backend میزبان MySQL که برای ذخیره‌سازی میزبان لازم است.
                \(dqlibrary\(dq: \(dqlibdhcp_mysql.so\(dq
            },
            {
                // کتابخانه قلاب backend میزبان PostgreSQL که برای ذخیره‌سازی میزبان لازم است.
                \(dqlibrary\(dq: \(dqlibdhcp_pgsql.so\(dq
            }
        ],

        // فهرست اعتبارنامه‌های دسترسی به منابع خارجی رزروهای IPv6،
        \(dqhosts\-databases\(dq: [
            {
                // نام پایگاه‌داده جهت اتصال.
                \(dqname\(dq: \(dqkeatest\(dq,

                // میزبانی که پایگاه‌داده روی آن قرار دارد.
                \(dqhost\(dq: \(dqlocalhost\(dq,

                // گذرواژه پایگاه‌داده.
                \(dqpassword\(dq: \(dq1234\(dq,

                // درگاهی که پایگاه‌داده روی آن در دسترس است.
                \(dqport\(dq: 3306,

                // نوع پایگاه‌داده، مثلاً \(dqmysql\(dq یا \(dqpostgresql\(dq.
                \(dqtype\(dq: \(dqmysql\(dq,

                // نام کاربری مورد استفاده برای دسترسی به پایگاه‌داده.
                \(dquser\(dq: \(dqkeatest\(dq,

                // حالت فقط‌خواندنی.
                \(dqreadonly\(dq: false,

                // ورودی‌های بعدی برای پشتیبانی OpenSSL در MySQL هستند.

                // لنگر اعتماد یا همان فایل یا دایرکتوری مرجع صدور گواهی (CA).
                \(dqtrust\-anchor\(dq: \(dqmy\-ca\(dq,

                // نام فایل گواهی کلاینت.
                \(dqcert\-file\(dq: \(dqmy\-cert\(dq,

                // نام فایل کلید خصوصی.
                \(dqkey\-file\(dq: \(dqmy\-key\(dq,

                // فهرست رمزها (راهنمای دستور ciphers در OpenSSL را ببینید).
                \(dqcipher\-list\(dq: \(dqAES\(dq,

                // زمان انتظار برای اتصال مجدد.
                // این پارامتر مشخص می‌کند Kea قبل از تلاش برای اتصال مجدد چه مدت
                // منتظر بماند. بر حسب میلی‌ثانیه. پیش‌فرض برای MySQL
                // و PostgreSQL برابر 0 (غیرفعال) است.
                \(dqreconnect\-wait\-time\(dq: 3000,

                // حداکثر دفعات تلاش مجدد برای اتصال.
                \(dqmax\-reconnect\-tries\(dq: 3,

                // اقدامی که هنگام شکست بازیابی اتصال انجام می‌شود.
                // مقادیر پشتیبانی‌شده: stop\-retry\-exit، serve\-retry\-exit،
                // serve\-retry\-continue
                \(dqon\-fail\(dq: \(dqstop\-retry\-exit\(dq,

                // پرچمی که مشخص می‌کند آیا بازیابی پایگاه‌داده باید در راه‌اندازی
                // سرور و در رویدادهای بازپیکربندی تلاش شود یا خیر.
                \(dqretry\-on\-startup\(dq: false,

                // مهلت زمانی برقراری اتصال بر حسب ثانیه.
                \(dqconnect\-timeout\(dq: 100,

                // مهلت زمانی عملیات خواندن پایگاه‌داده بر حسب ثانیه.
                \(dqread\-timeout\(dq: 120,

                // مهلت زمانی عملیات نوشتن پایگاه‌داده بر حسب ثانیه.
                \(dqwrite\-timeout\(dq: 180
            },
            {
                // نام پایگاه‌داده جهت اتصال.
                \(dqname\(dq: \(dqkeatest\(dq,

                // میزبانی که پایگاه‌داده روی آن قرار دارد.
                \(dqhost\(dq: \(dqlocalhost\(dq,

                // گذرواژه پایگاه‌داده.
                \(dqpassword\(dq: \(dq1234\(dq,

                // درگاهی که پایگاه‌داده روی آن در دسترس است.
                \(dqport\(dq: 5432,

                // نوع پایگاه‌داده، مثلاً \(dqmysql\(dq یا \(dqpostgresql\(dq.
                \(dqtype\(dq: \(dqpostgresql\(dq,

                // نام کاربری مورد استفاده برای دسترسی به پایگاه‌داده.
                \(dquser\(dq: \(dqkeatest\(dq,

                // مهلت زمانی کاربری TCP حین ارتباط با پایگاه‌داده.
                // بر حسب ثانیه مشخص می‌شود.
                \(dqtcp\-user\-timeout\(dq: 100,

                // لنگر اعتماد یا همان فایل یا دایرکتوری مرجع صدور گواهی (CA).
                \(dqtrust\-anchor\(dq: \(dqmy\-ca\(dq,

                // نام فایل گواهی کلاینت.
                \(dqcert\-file\(dq: \(dqmy\-cert\(dq,

                // نام فایل کلید خصوصی.
                \(dqkey\-file\(dq: \(dqmy\-key\(dq,

                // حالت SSL.
                \(dqssl\-mode\(dq: \(dqverify\-ca\(dq
            }
        ],

        // فهرست انواع شناسه‌های رزرو میزبان مورد استفاده توسط
        // کارگزار Kea DHCPv6 برای واکشی رزروهای ایستا برای
        // کلاینت‌های DHCP. به طور پیش‌فرض تمام شناسه‌ها استفاده می‌شوند،
        // به این معنی که سرور چندین پرس‌وجو به پایگاه‌داده ارسال می‌کند تا متوجه
        // شود آیا رزروی برای کلاینت خاص وجود دارد یا خیر. اگر یک استقرار خاص
        // تنها از یک زیرمجموعه استفاده می‌کند (مثلاً یک نوع شناسه)،
        // این شناسه فقط باید در اینجا فهرست شود تا از پرس‌وجوهای
        // غیرضروری به پایگاه‌داده جلوگیری شود.
        \(dqhost\-reservation\-identifiers\(dq: [
            \(dqhw\-address\(dq,
            \(dqduid\(dq,
            \(dqflex\-id\(dq
        ],

        // پیکربندی رابط‌هایی که کارگزار Kea DHCPv6 برای
        // پرس‌وجوهای DHCP روی آن‌ها شنود می‌کند را مشخص می‌نماید.
        \(dqinterfaces\-config\(dq: {
            // فهرستی از رابط‌ها را مشخص می‌کند که کارگزار Kea DHCPv6
            // باید روی آن‌ها به درخواست‌های DHCP گوش فرا دهد.
            \(dqinterfaces\(dq: [
                \(dqeth0\(dq
            ],

            // پرچم بولی که مشخص می‌کند آیا رابط‌های در دسترس باید
            // هنگام بازپیکربندی سرور دوباره شناسایی شوند یا خیر. مقدار پیش‌فرض
            // true است، به این معنی که رابط‌ها همیشه
            // دوباره شناسایی می‌شوند.
            \(dqre\-detect\(dq: true,

            // سرور Kea هنگام مقداردهی اولیه تلاش می‌کند سوکت‌های سرویس را متصل (bind) کند،
            // اما ممکن است به دلیل باز بودن قبلی درگاه یا پیکربندی نادرست با شکست مواجه شود. Kea می‌تواند
            // این خطاها را نادیده گرفته و فقط آن‌ها را ثبت کند. این پرچم مانع از شروع
            // کارگزار DHCP بدون اتصال موفق همه سوکت‌ها می‌شود. در صورت عدم تعیین،
            // مقدار پیش‌فرض false است.
            \(dqservice\-sockets\-require\-all\(dq: true,

            // سرور Kea هنگام مقداردهی اولیه تلاش می‌کند سوکت‌های سرویس را متصل کند. این
            // گزینه مشخص می‌کند که اتصال به رابط چند بار دوباره تلاش شود.
            // مقدار پیش‌فرض 0 است، به این معنی که عملیات تکرار
            // نخواهد شد.
            \(dqservice\-sockets\-max\-retries\(dq: 5,

            // بازه زمانی بر حسب میلی‌ثانیه برای انتظار قبل از تلاش بعدی جهت
            // باز کردن مجدد یک سوکت سرویس.
            \(dqservice\-sockets\-retry\-wait\-time\(dq: 5000
        },

        // پارامتر بولی که کنترل می‌کند آیا جستجوی زودهنگام رزروهای میزبان
        // سراسری انجام شود یا خیر. این جستجو قبل از انتخاب زیرشبکه انجام
        // می‌شود و هنگامی که یک رزرو سراسری با برخی از کلاس‌های کلاینت یافت شود،
        // مرحله دوم طبقه‌بندی را فعال می‌کند. همچنین می‌تواند برای دور انداختن
        // پرس‌وجوها با استفاده از رزروهای میزبان به عنوان یک جدول تصمیم‌گیری
        // فهرست‌شده با شناسه‌های رزرو به کار رود.
        \(dqearly\-global\-reservations\-lookup\(dq: true,

        // پارامتر بولی که رفتار کارگزار DHCP را در رابطه با ایجاد رزروهای
        // میزبان برای آدرس IP یا پیشوند واگذارشده یکسان کنترل می‌کند. به طور
        // پیش‌فرض این پرچم روی true تنظیم شده که در این حالت سرور از ایجاد چندین
        // رزرو میزبان برای یک آدرس IP یا پیشوند واگذارشده یکسان جلوگیری می‌کند.
        // وقتی این پارامتر روی false تنظیم شود، سرور اجازه ایجاد چندین رزرو برای
        // آدرس IP یا پیشوند واگذارشده یکسان را در یک زیرشبکه می‌دهد. این تنظیم در
        // استقرارهایی مفید است که در آن‌ها یک میزبان ممکن است از طریق چندین رابط با
        // کارگزار DHCP ارتباط برقرار کند و بسته به رابط انتخابی، آدرس MAC مختلف
        // (یا شناسه دیگر) برای شناسایی میزبان استفاده شود.
        // توجه داشته باشید که برخی از backendهای میزبان از حالتی که در آن چندین
        // رزرو برای یک آدرس IP یا پیشوند واگذارشده یکسان استفاده می‌شود پشتیبانی نمی‌کنند.
        // اگر این backendها در حال استفاده باشند و این تنظیم اعمال شود، خطای
        // پیکربندی رخ خواهد داد. backendهای MySQL و PostgreSQL از این حالت
        // پشتیبانی می‌کنند.
        \(dqip\-reservations\-unique\(dq: true,

        // پارامتر بولی که کنترل می‌کند آیا جستجوی رزروهای میزبان باید قبل از
        // جستجوی اجاره انجام شود یا خیر. این پارامتر تنها زمانی مؤثر است
        // که چندنخی غیرفعال باشد. هنگامی که چندنخی فعال باشد،
        // جستجوی رزروهای میزبان همیشه ابتدا انجام می‌شود تا از قفل شدن منابع
        // هنگام جستجوی اجاره جلوگیری گردد.
        \(dqreservations\-lookup\-first\(dq: true,

        // اطلاعات هویتی جهت دسترسی به پایگاه‌داده اجاره را مشخص می‌کند.
        \(dqlease\-database\(dq: {
            // پارامتر ویژه backend از نوع memfile که بازه زمانی بر حسب ثانیه را
            // مشخص می‌کند که در آن فایل اجاره باید پاکسازی شود (ورودی‌های اجاره
            // منسوخ حذف می‌شوند تا از رشد بی‌رویه فایل اجاره جلوگیری شود).
            \(dqlfc\-interval\(dq: 3600,

            // حداکثر تعداد خطاهای خواندن فایل اجاره که قبل از انصراف
            // از بارگذاری فایل مجاز است. پیش‌فرض 0 (بدون محدودیت).
            \(dqmax\-row\-errors\(dq: 100,

            // نام فایل اجاره. در مورد پایگاه‌داده، نام پایگاه‌داده را
            // مشخص می‌کند.
            \(dqname\(dq: \(dqkea\-leases6.csv\(dq,

            // پارامتر ویژه memfile که مشخص می‌کند آیا اجاره‌ها باید روی فضای
            // ذخیره‌سازی دائمی (دیسک) ذخیره شوند یا خیر. مقدار true پیش‌فرض
            // است و نشان می‌دهد که اجاره‌ها در فضای ذخیره‌سازی دائمی ذخیره
            // می‌شوند. این تنظیم باید در محیط عملیاتی استفاده شود.
            // مقدار false صرفاً باید برای اهداف آزمایشی استفاده شود زیرا
            // اجاره‌های ذخیره‌نشده با راه‌اندازی مجدد سرور Kea از دست خواهند رفت.
            \(dqpersist\(dq: true,

            // نوع backend پایگاه‌داده اجاره، یعنی \(dqmemfile\(dq، \(dqmysql\(dq یا
            // \(dqpostgresql\(dq.
            \(dqtype\(dq: \(dqmemfile\(dq
        },

        // فهرستی از پارامترها که مشخص می‌کند چگونه می‌توان آدرس MAC کلاینت را
        // از پرس‌وجوی DHCP استنتاج کرد. مقادیر پشتیبانی‌شده در راهنمای
        // مرجع مدیران Kea فهرست شده‌اند.
        \(dqmac\-sources\(dq: [ \(dqduid\(dq ],

        // فهرست گزینه‌های سراسری DHCP که کارگزار Kea DHCPv6 به کلاینت‌ها
        // اختصاص می‌دهد.
        \(dqoption\-data\(dq: [
            {
                // پرچم بولی که مشخص می‌کند آیا گزینه داده‌شده همیشه در پاسخ
                // ارسال شود یا تنها در صورت درخواست. مقدار پیش‌فرض false
                // نشان می‌دهد که تنها در صورت درخواست ارسال می‌شود.
                \(dqalways\-send\(dq: false,

                // فهرستی اختیاری از کلاس‌هایی که این گزینه برای آن‌ها اعمال می‌شود.
                // اگر کلاینت با هر یک از کلاس‌های این فهرست مطابقت داشته باشد،
                // گزینه اعمال خواهد شد. اگر فهرست خالی باشد یا حذف شود،
                // این گزینه صرف‌نظر از عضویت در کلاس اعمال می‌شود.
                \(dqclient\-classes\(dq: [ \(dqclass1\(dq, \(dqclass2\(dq ],

                // کد گزینه. در صورت ارائه نام گزینه، نیازی به
                // این فیلد نیست.
                \(dqcode\(dq: 23,

                // مقدار بولی که مشخص می‌کند آیا داده‌های گزینه مشخص‌شده در
                // فیلد \(dqdata\(dq به صورت رشته‌ای از ارقام هگزادسیمال است
                // یا در قالب CSV خوانا برای انسان.
                \(dqcsv\-format\(dq: true,

                // داده‌های گزینه جهت ذخیره در بخش بار داده (payload) گزینه.
                \(dqdata\(dq: \(dq2001:db8:2::45, 2001:db8:2::100\(dq,

                // نام گزینه. در صورت ارائه کد گزینه، نیازی به
                // این فیلد نیست.
                \(dqname\(dq: \(dqdns\-servers\(dq,

                // پرچم بولی که مشخص می‌کند آیا گزینه داده‌شده هرگز در پاسخ
                // ارسال نشود. مقدار پیش‌فرض false نشان می‌دهد که در صورت لزوم
                // ارسال می‌شود. در صورت true بودن، گزینه علیرغم هر تنظیم دیگری
                // ارسال نخواهد شد، یعنی یک پرچم قطعی و نهایی است.
                \(dqnever\-send\(dq: false,

                // فضای گزینه. پیش‌فرض فضای گزینه \(dqdhcp6\(dq است که
                // گزینه‌های سطح بالای DHCPv6 را دسته‌بندی می‌کند.
                \(dqspace\(dq: \(dqdhcp6\(dq
            }
        ],

        // فهرستی از تعاریف سراسری گزینه، یعنی قالب‌های گزینه، که کارگزار
        // Kea DHCPv6 از آن‌ها استفاده می‌کند.
        \(dqoption\-def\(dq: [
            {
                // پرچم بولی که مشخص می‌کند آیا تعریف گزینه شامل آرایه‌ای از
                // مقادیر از یک نوع است (مثلاً آرایه‌ای از آدرس‌های IPv6) یا خیر.
                // مقدار پیش‌فرض false به این معنی است که گزینه شامل آرایه‌ای
                // از مقادیر نیست.
                \(dqarray\(dq: false,

                // کد گزینه.
                \(dqcode\(dq: 6,

                // حاوی نام فضای گزینه‌ای است که توسط این گزینه کپسوله‌سازی می‌شود.
                // تمام گزینه‌های متعلق به این فضای گزینه به عنوان زیرگزینه‌های این گزینه
                // ارسال خواهند شد. یک رشته خالی به این معنی است که این گزینه
                // هیچ گزینه‌ای را کپسوله‌سازی نمی‌کند.
                \(dqencapsulate\(dq: \(dq\(dq,

                // نام گزینه.
                \(dqname\(dq: \(dqmy\-option\(dq,

                // انواع فیلدهای درون گزینه را در صورتی که گزینه به صورت \(dqrecord\(dq
                // تعریف شده باشد مشخص می‌کند (به \(dqtype\(dq مراجعه کنید). در این مثال
                // خاص، این گزینه شامل دو فیلد با طول‌های ۱ بایت و ۲ بایت است.
                \(dqrecord\-types\(dq: \(dquint8, uint16\(dq,

                // نام فضای گزینه‌ای که این گزینه به آن تعلق دارد.
                \(dqspace\(dq: \(dqmy\-space\(dq,

                // نوع گزینه. تمام انواع ممکن در راهنمای مرجع مدیران
                // Kea فهرست شده‌اند.
                \(dqtype\(dq: \(dqrecord\(dq
            }
        ],

        // مقدار سراسری که تعداد بسته‌های کلاینت (مانند REQUESTها، RENEWها...)
        // را که ممکن است حین انتظار برای تکمیل کار کتابخانه قلاب قبل از ارسال
        // پاسخ (مانند REPLY) به کلاینت متوقف (park) شوند، محدود می‌کند. یک مثال معمول زمانی
        // است که kea\-dhcp6 یک REQUEST را متوقف می‌کند در حالی که به‌روزرسانی(های) اجاره را به
        // همتایان HA خود ارسال می‌نماید. پس از تایید به‌روزرسانی(ها)، بسته از حالت توقف خارج می‌شود.
        // این مقدار تعداد بسته‌هایی را که می‌توانند در انتظار به‌روزرسانی‌ها نگهداری شوند محدود می‌کند.
        // در زمان ترافیک سنگین کلاینت‌ها، این مقدار می‌تواند از ایجاد انباشت جبران‌ناپذیر به‌روزرسانی‌ها
        // در kea\-dhcp6 جلوگیری کند.
        \(dqparked\-packet\-limit\(dq: 256,

        // مقدار سراسری (پیش‌فرض) مدت ترجیحی.
        \(dqpreferred\-lifetime\(dq: 50,

        // حداقل مقدار سراسری مدت ترجیحی.
        \(dqmin\-preferred\-lifetime\(dq: 40,

        // حداکثر مقدار سراسری مدت ترجیحی.
        \(dqmax\-preferred\-lifetime\(dq: 60,

        // مقدار سراسری برای زمان‌سنج پیوند مجدد (rebind timer)، یعنی زمانی که
        // پس از آن کلاینت DHCP در صورت عدم موفقیت در تمدید اجاره، وارد حالت پیوند مجدد می‌شود.
        \(dqrebind\-timer\(dq: 40,

        // فهرست کدهای گزینه‌های ارائه‌شده توسط رله. RFC 6422 را ببینید.
        \(dqrelay\-supplied\-options\(dq: [ \(dq110\(dq, \(dq120\(dq, \(dq130\(dq ],

        // مقدار سراسری برای زمان‌سنج تمدید (renew timer)، یعنی زمانی که
        // پس از آن کلاینت DHCP اجاره را تمدید می‌کند.
        \(dqrenew\-timer\(dq: 30,

        // مقدار سراسری برای ذخیره اطلاعات گسترش‌یافته (مانند اطلاعات عامل
        // رله) همراه با هر اجاره.
        \(dqstore\-extended\-info\(dq: true,

        // آمارها نمونه‌هایی را برای هر نقطه مشاهده نگهداری می‌کنند.
        // دو مقدار پیش‌فرض وجود دارد: حداکثر تعداد و حداکثر طول عمر.
        // تنظیم حداکثر تعداد روی صفر آن را غیرفعال می‌کند.
        \(dqstatistic\-default\-sample\-count\(dq: 0,

        // هنگامی که حداکثر تعداد 0 باشد، حداکثر طول عمر (بر حسب ثانیه) اعمال می‌شود.
        \(dqstatistic\-default\-sample\-age\(dq: 60,

        // پارامترهای چندنخی.
        \(dqmulti\-threading\(dq: {
            // به طور پیش‌فرض، اگر سخت‌افزار اجازه دهد، Kea بسته‌ها را روی چندین نخ پردازش می‌کند.
            \(dqenable\-multi\-threading\(dq: true,

            // هنگام فعال بودن چندنخی، Kea بسته‌ها را روی تعداد مشخصی نخ پردازش می‌کند
            // که از طریق این گزینه قابل پیکربندی است. مقدار باید یک عدد
            // صحیح مثبت باشد (0 یعنی تشخیص خودکار).
            \(dqthread\-pool\-size\(dq: 0,

            // هنگام فعال بودن چندنخی، Kea بسته‌ها را از رابط می‌خواند و یک مورد
            // کاری را به مخزن نخ‌ها اضافه می‌کند. این گزینه حداکثر تعداد
            // مواردی را که می‌توان در صف قرار داد پیکربندی می‌کند.
            // مقدار باید یک عدد صحیح مثبت باشد (0 یعنی نامحدود).
            \(dqpacket\-queue\-size\(dq: 0
        },

        // مشخص می‌کند که کارگزار Kea DHCPv6 چگونه باید با داده‌های
        // نامعتبر دریافت شده از کلاینت برخورد کند.
        \(dqsanity\-checks\(dq: {
            // مشخص می‌کند که کارگزار Kea DHCPv6 در صورت خوانده شدن داده‌های نامعتبر
            // برای یک اجاره از فایل اجاره چگونه باید رفتار کند. مقادیر زیر پشتیبانی
            // می‌شوند: \(dqnone\(dq (تلاشی برای اصلاح اطلاعات اجاره نکن)،
            // \(dqwarn\(dq (چاپ هشدار برای ناسازگاری‌های مربوط به subnet\-id)،
            // \(dqfix\(dq (اصلاح شناسه زیرشبکه با تلاش برای یافتن زیرشبکه مناسب)،
            // \(dqfix\-del\(dq (مشابه \(dqfix\(dq، اما در صورت عدم یافتن زیرشبکه مناسب، اجاره حذف شود)،
            // \(dqdel\(dq (حذف اجاره در صورتی که اجاره دارای مقدار شناسه زیرشبکه
            // نامعتبر باشد).
            \(dqlease\-checks\(dq: \(dqwarn\(dq,

            // مشخص می‌کند که کارگزار Kea DHCPv4 هنگام خواندن اطلاعات
            // گسترش‌یافته نامعتبر برای یک اجاره از فایل اجاره چگونه رفتار کند، یا
            // اینکه آیا ارتقا از قالب قدیمی صورت گیرد یا خیر. مقادیر زیر
            // پشتیبانی می‌شوند: \(dqnone\(dq (تلاشی برای اصلاح یا ارتقای
            // اطلاعات گسترش‌یافته نکن)، \(dqfix\(dq (رفع ناسازگاری‌های رایج و
            // ارتقا از قالب قدیمی؛ این مقدار پیش‌فرض است)، \(dqstrict\(dq
            // (رفع ناسازگاری‌های دارای تاثیر بر Leasequery)،
            // \(dqpedantic\(dq (اعمال قالب کامل کد Kea).
            \(dqextended\-info\-checks\(dq: \(dqfix\(dq
        },

        // شناسه DUID سفارشی مورد استفاده توسط کارگزار DHCPv6.
        \(dqserver\-id\(dq: {
            // نوع DUID. مقادیر ممکن عبارتند از \(dqLLT\(dq، \(dqEN\(dq و \(dqLL\(dq.
            \(dqtype\(dq: \(dqEN\(dq,

            // شناسه سازمانی مورد استفاده برای duid نوع \(dqEN\(dq.
            \(dqenterprise\-id\(dq: 2495,

            // بخش شناسه مربوط به DUID.
            \(dqidentifier\(dq: \(dq0123456789\(dq,

            // پرچم بولی که مشخص می‌کند آیا DUID باید روی دیسک
            // ذخیره پایدار بماند یا خیر.
            \(dqpersist\(dq: false
        },

        // فهرست شبکه‌های اشتراکی مورد استفاده کارگزار Kea DHCPv6. شبکه‌های
        // اشتراکی، زیرشبکه‌ها را با هم گروه‌بندی می‌کنند.
        \(dqshared\-networks\(dq: [
            {
                // پرچمی جهت انتخاب راهبرد تخصیص آدرس IP برای همه
                // زیرشبکه‌ها در این شبکه اشتراکی.
                \(dqallocator\(dq: \(dqrandom\(dq,

                // پرچمی جهت انتخاب راهبرد تخصیص پیشوند واگذارشده برای
                // همه زیرشبکه‌ها در این شبکه اشتراکی.
                \(dqpd\-allocator\(dq: \(dqiterative\(dq,

                // این شبکه اشتراکی را محدود می‌کند تا فقط به کلاینت‌هایی اجازه دهد
                // که حداقل به یکی از کلاس‌های این فهرست تعلق دارند. در صورت حذف
                // یا ارائه یک فهرست خالی، هیچ محدودیتی اعمال نمی‌شود.
                \(dqclient\-classes\(dq: [],

                // مقدار در سطح شبکه اشتراکی. به توضیحات در سطح سراسری مراجعه کنید.
                \(dqddns\-generated\-prefix\(dq: \(dqmyhost\(dq,

                // مقدار در سطح شبکه اشتراکی. به توضیحات در سطح سراسری مراجعه کنید.
                \(dqddns\-override\-client\-update\(dq: false,

                // مقدار در سطح شبکه اشتراکی. به توضیحات در سطح سراسری مراجعه کنید.
                \(dqddns\-override\-no\-update\(dq: false,

                // مقدار در سطح شبکه اشتراکی. به توضیحات در سطح سراسری مراجعه کنید.
                \(dqddns\-qualifying\-suffix\(dq: \(dq\(dq,

                // مقدار در سطح شبکه اشتراکی. به توضیحات در سطح سراسری مراجعه کنید.
                \(dqddns\-replace\-client\-name\(dq: \(dqnever\(dq,

                // مقدار در سطح شبکه اشتراکی. به توضیحات در سطح سراسری مراجعه کنید.
                \(dqddns\-send\-updates\(dq: true,

                // مقدار در سطح شبکه اشتراکی. به توضیحات در سطح سراسری مراجعه کنید.
                \(dqddns\-update\-on\-renew\(dq: true,

                // مقدار در سطح شبکه اشتراکی. به توضیحات در سطح سراسری مراجعه کنید.
                // این فیلد با ddns\-conflict\-resolution\-mode جایگزین شده است.
                // تجزیه آن صرفاً جهت سازگاری رو به عقب حفظ شده است.
                // \(dqddns\-use\-conflict\-resolution\(dq: true,

                // مقدار در سطح شبکه اشتراکی. به توضیحات در سطح سراسری مراجعه کنید.
                \(dqddns\-conflict\-resolution\-mode\(dq: \(dqcheck\-with\-dhcid\(dq,

                // مقدار در سطح شبکه اشتراکی. به توضیحات در سطح سراسری مراجعه کنید.
                \(dqddns\-ttl\-percent\(dq: 0.65,

                // مقدار در سطح شبکه اشتراکی. به توضیحات در سطح سراسری مراجعه کنید.
                // نمی‌توان هم ddns\-ttl و هم هر یک از ddns\-ttl\-percent، ddns\-ttl\-min یا
                // ddns\-ttl\-max را مشخص کرد. آن‌ها مانعة‌الجمع هستند.
                // \(dqddns\-ttl\(dq: 500,

                // مقدار در سطح شبکه اشتراکی. به توضیحات در سطح سراسری مراجعه کنید.
                \(dqddns\-ttl\-min\(dq: 10000,

                // مقدار در سطح شبکه اشتراکی. به توضیحات در سطح سراسری مراجعه کنید.
                \(dqddns\-ttl\-max\(dq: 20000,

                // مقدار در سطح شبکه اشتراکی. به توضیحات در سطح سراسری مراجعه کنید.
                \(dqhostname\-char\-replacement\(dq: \(dqx\(dq,

                // مقدار در سطح شبکه اشتراکی. به توضیحات در سطح سراسری مراجعه کنید.
                \(dqhostname\-char\-set\(dq: \(dq[^A\-Za\-z0\-9.\-]\(dq,

                // مشخص می‌کند که این شبکه اشتراکی برای
                // درخواست‌های دریافتی روی یک رابط خاص انتخاب شود.
                \(dqinterface\(dq: \(dqeth0\(dq,

                // محتوای گزینه interface\-id را مشخص می‌کند که توسط
                // رله‌ها برای شناسایی رابطی روی رله که پاسخ به آن
                // ارسال می‌شود، استفاده می‌گردد.
                \(dqinterface\-id\(dq: \(dq\(dq,

                // نام شبکه اشتراکی.
                \(dqname\(dq: \(dqmy\-secret\-network\(dq,

                // فهرست گزینه‌های DHCP ویژه شبکه اشتراکی.
                \(dqoption\-data\(dq: [],

                // مدت ترجیحی (پیش‌فرض) ویژه شبکه اشتراکی.
                \(dqpreferred\-lifetime\(dq: 2000,

                // حداقل مدت ترجیحی ویژه شبکه اشتراکی.
                \(dqmin\-preferred\-lifetime\(dq: 1500,

                // حداکثر مدت ترجیحی ویژه شبکه اشتراکی.
                \(dqmax\-preferred\-lifetime\(dq: 2500,

                // پرچم بولی که مشخص می‌کند آیا سرور می‌تواند به یک
                // پیام Solicit حاوی گزینه Rapid Commit با
                // پیام Reply پاسخ دهد یا خیر (DHCPv6 rapid commit را ببینید).
                \(dqrapid\-commit\(dq: false,

                // فهرست آدرس‌های رله IPv6 که این شبکه
                // اشتراکی برای آن‌ها انتخاب می‌شود.
                \(dqrelay\(dq: {
                    \(dqip\-addresses\(dq: []
                },

                // زمان‌سنج پیوند مجدد در سطح شبکه اشتراکی.
                \(dqrebind\-timer\(dq: 41,

                // زمان‌سنج تمدید در سطح شبکه اشتراکی.
                \(dqrenew\-timer\(dq: 31,

                // محاسبه زمان‌سنج‌های T1 و T2 در سطح شبکه اشتراکی.
                \(dqcalculate\-tee\-times\(dq: true,

                // T1 = valid lifetime * .5.
                \(dqt1\-percent\(dq: .5,

                // T2 = valid lifetime * .75.
                \(dqt2\-percent\(dq: .75,

                // آستانه حافظه موقت (cache threshold) = valid lifetime * .25.
                \(dqcache\-threshold\(dq: .25,

                // حداکثر کش: هنگامی که زمان آخرین ارسال کلاینت به اندازه
                // کافی نزدیک باشد، اجاره تمدید نمی‌شود و اجاره فعلی
                // همان‌طور که \(dqکَش شده بود\(dq بازگردانده می‌شود.
                \(dqcache\-max\-age\(dq: 1000,

                // آستانه تطبیقی زمان اجاره (1.0 یعنی غیرفعال).
                \(dqadaptive\-lease\-time\-threshold\(dq: 0.8,

                // مشخص می‌کند که آیا سرور باید رزروهای سراسری را جستجو کند یا خیر.
                \(dqreservations\-global\(dq: false,

                // مشخص می‌کند که آیا سرور باید رزروهای درون‌زیرشبکه‌ای را جستجو کند یا خیر.
                \(dqreservations\-in\-subnet\(dq: true,

                // مشخص می‌کند که آیا سرور می‌تواند فرض کند تمام آدرس‌های رزروشده
                // خارج از استخر (out\-of\-pool) هستند یا خیر.
                // در صورت false بودن reservations\-in\-subnet نادیده گرفته می‌شود.
                // در صورت تعیین، توسط سطوح \(dqsubnet6\(dq به ارث برده می‌شود.
                \(dqreservations\-out\-of\-pool\(dq: false,

                // فهرست کلاس‌های کلاینتی که هنگام انتخاب این شبکه اشتراکی
                // برای تخصیص کلاینت باید ارزیابی شوند.
                \(dqevaluate\-additional\-classes\(dq: [ \(dqlate\(dq ],

                // خاموش کردن ذخیره‌سازی اطلاعات گسترش‌یافته (مانند اطلاعات عامل
                // رله) همراه با هر اجاره برای این شبکه اشتراکی.
                \(dqstore\-extended\-info\(dq: false,

                // فهرست زیرشبکه‌های IPv6 متعلق به این شبکه اشتراکی.
                \(dqsubnet6\(dq: [
                    {
                        // پرچمی جهت انتخاب راهبرد تخصیص آدرس IP برای
                        // این زیرشبکه.
                        \(dqallocator\(dq: \(dqiterative\(dq,

                        // پرچمی جهت انتخاب راهبرد تخصیص پیشوند واگذارشده
                        // برای این زیرشبکه.
                        \(dqpd\-allocator\(dq: \(dqiterative\(dq,

                        // این زیرشبکه را محدود می‌کند تا فقط به کلاینت‌هایی اجازه دهد
                        // که حداقل به یکی از کلاس‌های این فهرست تعلق دارند. در صورت حذف
                        // یا ارائه یک فهرست خالی، هیچ محدودیتی اعمال نمی‌شود.
                        \(dqclient\-classes\(dq: [],

                        // مقدار در سطح زیرشبکه. به توضیحات در سطح سراسری مراجعه کنید.
                        \(dqddns\-generated\-prefix\(dq: \(dqmyhost\(dq,

                        // مقدار در سطح زیرشبکه. به توضیحات در سطح سراسری مراجعه کنید.
                        \(dqddns\-override\-client\-update\(dq: false,

                        // مقدار در سطح زیرشبکه. به توضیحات در سطح سراسری مراجعه کنید.
                        \(dqddns\-override\-no\-update\(dq: false,

                        // مقدار در سطح زیرشبکه. به توضیحات در سطح سراسری مراجعه کنید.
                        \(dqddns\-qualifying\-suffix\(dq: \(dq\(dq,

                        // مقدار در سطح زیرشبکه. به توضیحات در سطح سراسری مراجعه کنید.
                        \(dqddns\-replace\-client\-name\(dq: \(dqnever\(dq,

                        // مقدار در سطح زیرشبکه. به توضیحات در سطح سراسری مراجعه کنید.
                        \(dqddns\-send\-updates\(dq: true,

                        // مقدار در سطح زیرشبکه. به توضیحات در سطح سراسری مراجعه کنید.
                        \(dqddns\-update\-on\-renew\(dq: true,

                        // مقدار در سطح زیرشبکه. به توضیحات در سطح سراسری مراجعه کنید.
                        // این فیلد با ddns\-conflict\-resolution\-mode جایگزین شده است.
                        // تجزیه آن صرفاً جهت سازگاری رو به عقب حفظ شده است.
                        // \(dqddns\-use\-conflict\-resolution\(dq: true,

                        // مقدار در سطح زیرشبکه. به توضیحات در سطح سراسری مراجعه کنید.
                        \(dqddns\-conflict\-resolution\-mode\(dq: \(dqcheck\-with\-dhcid\(dq,

                        // مقدار در سطح زیرشبکه. به توضیحات در سطح سراسری مراجعه کنید.
                        // \(dqddns\-ttl\-percent\(dq: 0.55,

                        // \(dqddns\-ttl\(dq: 0,
                        // نمی‌توان هم ddns\-ttl و هم هر یک از ddns\-ttl\-percent، ddns\-ttl\-min یا
                        // ddns\-ttl\-max را مشخص کرد. آن‌ها مانعة‌الجمع هستند.
                        \(dqddns\-ttl\(dq: 500,

                        // مقدار در سطح زیرشبکه. به توضیحات در سطح سراسری مراجعه کنید.
                        // \(dqddns\-ttl\-min\(dq: 10000,

                        // مقدار در سطح زیرشبکه. به توضیحات در سطح سراسری مراجعه کنید.
                        // \(dqddns\-ttl\-max\(dq: 20000,

                        // مقدار در سطح زیرشبکه. به توضیحات در سطح سراسری مراجعه کنید.
                        \(dqhostname\-char\-replacement\(dq: \(dqx\(dq,

                        // مقدار در سطح زیرشبکه. به توضیحات در سطح سراسری مراجعه کنید.
                        \(dqhostname\-char\-set\(dq: \(dq[^A\-Za\-z0\-9.\-]\(dq,

                        // شناسه یکتای زیرشبکه.
                        \(dqid\(dq: 1,

                        // مشخص می‌کند که این زیرشبکه برای درخواست‌های دریافتی
                        // روی یک رابط خاص انتخاب شود.
                        \(dqinterface\(dq: \(dqeth0\(dq,

                        // محتوای گزینه interface\-id را مشخص می‌کند که توسط
                        // رله‌ها برای شناسایی رابطی روی رله که پاسخ به آن
                        // ارسال می‌شود، استفاده می‌گردد.
                        \(dqinterface\-id\(dq: \(dq\(dq,

                        // روشن کردن ذخیره‌سازی اطلاعات گسترش‌یافته (مانند اطلاعات عامل
                        // رله) همراه با هر اجاره برای این زیرشبکه.
                        \(dqstore\-extended\-info\(dq: true,

                        // فهرست گزینه‌های DHCP در سطح زیرشبکه.
                        \(dqoption\-data\(dq: [
                            {
                                // پرچم بولی که مشخص می‌کند آیا این گزینه خاص
                                // باید همیشه ارسال شود یا تنها در صورت درخواست.
                                \(dqalways\-send\(dq: false,

                                // فهرستی اختیاری از کلاس‌هایی که این گزینه برای آن‌ها اعمال می‌شود.
                                // اگر کلاینت با هر یک از کلاس‌های این فهرست مطابقت داشته باشد،
                                // گزینه اعمال خواهد شد. اگر فهرست خالی باشد یا حذف شود،
                                // این گزینه صرف‌نظر از عضویت در کلاس اعمال می‌شود.
                                \(dqclient\-classes\(dq: [],

                                // کد گزینه.
                                \(dqcode\(dq: 7,

                                // پرچم بولی که مشخص می‌کند آیا مقدار گزینه تعیین‌شده
                                // در \(dqdata\(dq رشته‌ای از مقادیر هگزادسیمال است یا مقدار
                                // انسان‌خوانای CSV.
                                \(dqcsv\-format\(dq: false,

                                // داده‌های گزینه جهت گنجانده شدن در بار داده گزینه.
                                \(dqdata\(dq: \(dq0xf0\(dq,

                                // نام گزینه.
                                \(dqname\(dq: \(dqpreference\(dq,

                                // پرچم بولی که مشخص می‌کند آیا گزینه داده‌شده هرگز
                                // در پاسخ ارسال نشود.
                                \(dqnever\-send\(dq: false,

                                // فضای گزینه. مقدار پیش‌فرض \(dqdhcp6\(dq فضای گزینه
                                // سطح بالا را مشخص می‌کند.
                                \(dqspace\(dq: \(dqdhcp6\(dq
                            }
                        ],

                        // فهرست استخرهایی که پیشوندهای واگذارشده از آن‌ها به
                        // کلاینت‌ها اختصاص می‌یابد.
                        \(dqpd\-pools\(dq: [
                            {
                                // این زیرشبکه استخر پیشوند را محدود می‌کند تا فقط به کلاینت‌هایی
                                // اجازه دهد که حداقل به یکی از کلاس‌های این فهرست تعلق دارند. در صورت حذف
                                // یا ارائه یک فهرست خالی، هیچ محدودیتی اعمال نمی‌شود.
                                \(dqclient\-classes\(dq: [ \(dqphones_server1\(dq ],

                                // طول پیشوندهای واگذارشده به کلاینت‌ها.
                                \(dqdelegated\-len\(dq: 64,

                                // پیشوند (آدرس) مستثنی‌شده از تخصیص به کلاینت‌ها.
                                \(dqexcluded\-prefix\(dq: \(dq2001:db8:1::\(dq,

                                // پیشوند (طول) مستثنی‌شده از تخصیص به کلاینت‌ها.
                                \(dqexcluded\-prefix\-len\(dq: 72,

                                // فهرست گزینه‌های DHCP در سطح استخر پیشوند.
                                \(dqoption\-data\(dq: [],

                                // محدوده پیشوند (آدرس) مورد استفاده برای تخصیص به کلاینت‌ها.
                                \(dqprefix\(dq: \(dq2001:db8:1::\(dq,

                                // محدوده پیشوند (طول) مورد استفاده برای تخصیص به کلاینت‌ها.
                                \(dqprefix\-len\(dq: 48,

                                // فهرست کلاس‌های کلاینتی که هنگام انتخاب این استخر
                                // پیشوند برای تخصیص کلاینت باید ارزیابی شوند.
                                \(dqevaluate\-additional\-classes\(dq: [],

                                // شناسه pd\-pool مورد استفاده برای فعال‌سازی آمارها برای این pd\-pool.
                                // شناسه pd\-pool نیازی نیست درون زیرشبکه یا در میان زیرشبکه‌ها
                                // یکتا باشد. اگر پیکربندی نشده باشد، پیش‌فرض آن 0 است.
                                // آمارهای مربوط به این pd\-pool با سایر آمارهای تمام
                                // pd\-poolهای دیگر با همان شناسه pd\-pool در این زیرشبکه ترکیب خواهد شد.
                                \(dqpool\-id\(dq: 1
                            },
                            {
                                // طول پیشوندهای واگذارشده به کلاینت‌ها.
                                \(dqdelegated\-len\(dq: 64,

                                // محدوده پیشوند (آدرس) مورد استفاده برای تخصیص به کلاینت‌ها.
                                \(dqprefix\(dq: \(dq2001:db8:2::\(dq,

                                // محدوده پیشوند (طول) مورد استفاده برای تخصیص به کلاینت‌ها.
                                \(dqprefix\-len\(dq: 48
                            }
                        ],

                        // فهرست استخرهای آدرس IP متعلق به زیرشبکه.
                        \(dqpools\(dq: [
                            {
                                // این استخر زیرشبکه را محدود می‌کند تا فقط به کلاینت‌هایی
                                // اجازه دهد که حداقل به یکی از کلاس‌های این فهرست تعلق دارند. در صورت حذف
                                // یا ارائه یک فهرست خالی، هیچ محدودیتی اعمال نمی‌شود.
                                \(dqclient\-classes\(dq: [ \(dqphones_server1\(dq ],

                                // فهرست گزینه‌های DHCP در سطح استخر.
                                \(dqoption\-data\(dq: [],

                                // محدوده آدرس مورد استفاده برای تخصیص به کلاینت‌ها.
                                \(dqpool\(dq: \(dq2001:db8:0:1::/64\(dq,

                                // فهرست کلاس‌های کلاینتی که هنگام انتخاب این استخر برای تخصیص
                                // کلاینت باید ارزیابی شوند.
                                \(dqevaluate\-additional\-classes\(dq: [ \(dqlate\(dq ],

                                // مقدار در سطح استخر. به توضیحات در سطح سراسری مراجعه کنید.
                                \(dqddns\-generated\-prefix\(dq: \(dqmypool\(dq,

                                // مقدار در سطح استخر. به توضیحات در سطح سراسری مراجعه کنید.
                                \(dqddns\-override\-client\-update\(dq: false,

                                // مقدار در سطح استخر. به توضیحات در سطح سراسری مراجعه کنید.
                                \(dqddns\-override\-no\-update\(dq: false,

                                // مقدار در سطح استخر. به توضیحات در سطح سراسری مراجعه کنید.
                                \(dqddns\-qualifying\-suffix\(dq: \(dqpool.example.com.\(dq,

                                // مقدار در سطح استخر. به توضیحات در سطح سراسری مراجعه کنید.
                                \(dqddns\-replace\-client\-name\(dq: \(dqalways\(dq,

                                // مقدار در سطح استخر. به توضیحات در سطح سراسری مراجعه کنید.
                                \(dqddns\-send\-updates\(dq: true,

                                // مقدار در سطح استخر. به توضیحات در سطح سراسری مراجعه کنید.
                                \(dqddns\-update\-on\-renew\(dq: false,

                                // مقدار در سطح استخر. به توضیحات در سطح سراسری مراجعه کنید.
                                \(dqddns\-conflict\-resolution\-mode\(dq: \(dqcheck\-with\-dhcid\(dq,

                                // مقدار در سطح استخر. به توضیحات در سطح سراسری مراجعه کنید.
                                \(dqddns\-ttl\-percent\(dq: 0.55,

                                // مقدار در سطح استخر. به توضیحات در سطح سراسری مراجعه کنید.
                                // نمی‌توانید هم ddns\-ttl و هم هر یک از ddns\-ttl\-percent،
                                // ddns\-ttl\-min یا ddns\-ttl\-max را مشخص کنید. آن‌ها مانعة‌الجمع هستند.
                                // \(dqddns\-ttl\(dq: 500,

                                // مقدار در سطح استخر. به توضیحات در سطح سراسری مراجعه کنید.
                                \(dqddns\-ttl\-min\(dq: 10000,

                                // مقدار در سطح استخر. به توضیحات در سطح سراسری مراجعه کنید.
                                \(dqddns\-ttl\-max\(dq: 20000,

                                // مقدار در سطح استخر. به توضیحات در سطح سراسری مراجعه کنید.
                                \(dqhostname\-char\-replacement\(dq: \(dqx\(dq,

                                // مقدار در سطح استخر. به توضیحات در سطح سراسری مراجعه کنید.
                                \(dqhostname\-char\-set\(dq: \(dq[^A\-Za\-z0\-9.\-]\(dq
                            },
                            {
                                // این استخر زیرشبکه را محدود می‌کند تا فقط به کلاینت‌هایی
                                // اجازه دهد که حداقل به یکی از کلاس‌های این فهرست تعلق دارند. در صورت حذف
                                // یا ارائه یک فهرست خالی، هیچ محدودیتی اعمال نمی‌شود.
                                \(dqclient\-classes\(dq: [ \(dqphones_server2\(dq ],

                                // فهرست گزینه‌های DHCP در سطح استخر.
                                \(dqoption\-data\(dq: [],

                                // محدوده آدرس مورد استفاده برای تخصیص به کلاینت‌ها.
                                \(dqpool\(dq: \(dq2001:db8:0:3::/64\(dq,

                                // فهرست کلاس‌های کلاینتی که هنگام انتخاب این استخر برای تخصیص
                                // کلاینت باید ارزیابی شوند.
                                \(dqevaluate\-additional\-classes\(dq: [],

                                // شناسه استخر که برای فعال‌سازی آمارها برای این استخر استفاده می‌شود.
                                // شناسه استخر نیازی نیست در داخل زیرشبکه یا بین زیرشبکه‌ها
                                // یکتا باشد. اگر پیکربندی نشده باشد، پیش‌فرض 0 است.
                                // آمارهای مربوط به این استخر با سایر آمارهای تمام
                                // استخرهای دیگر با همان شناسه استخر در این زیرشبکه ترکیب می‌شود.
                                \(dqpool\-id\(dq: 1
                            }
                        ],

                        // مدت ترجیحی (پیش‌فرض) ویژه زیرشبکه.
                        \(dqpreferred\-lifetime\(dq: 2000,

                        // حداقل مدت ترجیحی ویژه زیرشبکه.
                        \(dqmin\-preferred\-lifetime\(dq: 1500,

                        // حداکثر مدت ترجیحی ویژه زیرشبکه.
                        \(dqmax\-preferred\-lifetime\(dq: 2500,

                        // پرچم بولی که مشخص می‌کند آیا سرور می‌تواند به یک
                        // پیام Solicit حاوی گزینه Rapid Commit با
                        // پیام Reply پاسخ دهد یا خیر (DHCPv6 rapid commit را ببینید).
                        \(dqrapid\-commit\(dq: false,

                        // مقدار زمان‌سنج پیوند مجدد در سطح زیرشبکه.
                        \(dqrebind\-timer\(dq: 40,

                        // فهرست آدرس‌های رله IPv6 که این زیرشبکه برای آن‌ها انتخاب می‌شود.
                        \(dqrelay\(dq: {
                            \(dqip\-addresses\(dq: [
                                \(dq2001:db8:0:f::1\(dq
                            ]
                        },

                        // زمان‌سنج تمدید در سطح زیرشبکه.
                        \(dqrenew\-timer\(dq: 30,

                        // مشخص می‌کند که آیا سرور باید رزروهای سراسری را جستجو کند یا خیر.
                        \(dqreservations\-global\(dq: false,

                        // مشخص می‌کند که آیا سرور باید رزروهای درون‌زیرشبکه‌ای را جستجو کند یا خیر.
                        \(dqreservations\-in\-subnet\(dq: true,

                        // مشخص می‌کند که آیا سرور می‌تواند فرض کند تمام آدرس‌های
                        // رزروشده خارج از استخر هستند یا خیر.
                        // در صورت false بودن reservations\-in\-subnet نادیده گرفته می‌شود.
                        \(dqreservations\-out\-of\-pool\(dq: false,

                        // محاسبه زمان‌سنج‌های T1 و T2 در سطح زیرشبکه.
                        \(dqcalculate\-tee\-times\(dq: true,

                        // T1 = valid lifetime * .5.
                        \(dqt1\-percent\(dq: .5,

                        // T2 = valid lifetime * .75.
                        \(dqt2\-percent\(dq: .75,

                        // آستانه حافظه موقت (cache threshold) = valid lifetime * .25.
                        \(dqcache\-threshold\(dq: .25,

                        // حداکثر کش در سطح زیرشبکه.
                        \(dqcache\-max\-age\(dq: 1000,

                        // آستانه تطبیقی زمان اجاره (1.0 یعنی غیرفعال).
                        \(dqadaptive\-lease\-time\-threshold\(dq: 0.8,

                        // فهرست رزروهای ایستای IPv6 اختصاص‌یافته به کلاینت‌های متعلق
                        // به این زیرشبکه. برای یک مثال دقیق، reservations.json را ببینید.
                        \(dqreservations\(dq: [
                            {
                                // شناسه مورد استفاده برای تطبیق کلاینت. مقادیر پشتیبانی‌شده عبارتند از
                                // \(dqduid\(dq، \(dqhw\-address\(dq و \(dqflex\-id\(dq.
                                \(dqduid\(dq: \(dq01:02:03:04:05:06:07:08:09:0A\(dq,

                                // فهرست آدرس‌های IPv6 رزروشده.
                                \(dqip\-addresses\(dq: [ \(dq2001:db8:1:cafe::1\(dq ],

                                // فهرست پیشوندهای IPv6 رزروشده.
                                \(dqprefixes\(dq: [ \(dq2001:db8:2:abcd::/64\(dq ],

                                // فهرست پیشوندهای IPv6 مستثنی‌شده.
                                \(dqexcluded\-prefixes\(dq: [ \(dq2001:db8:2:abcd:1::/80\(dq ],

                                // نام میزبان رزروشده.
                                \(dqhostname\(dq: \(dqfoo.example.com\(dq,

                                // داده‌های گزینه ویژه رزرو.
                                \(dqoption\-data\(dq: [
                                    {
                                        // نام گزینه.
                                        \(dqname\(dq: \(dqvendor\-opts\(dq,

                                        // مقدار گزینه.
                                        \(dqdata\(dq: \(dq4491\(dq
                                    }
                                ]
                            }
                        ],

                        // فهرست کلاس‌های کلاینتی که هنگام انتخاب این زیرشبکه برای
                        // تخصیص کلاینت باید ارزیابی شوند.
                        \(dqevaluate\-additional\-classes\(dq: [ \(dqlate\(dq ],

                        // پیشوند زیرشبکه.
                        \(dqsubnet\(dq: \(dq2001:db8::/32\(dq,

                        // مدت اعتبار (پیش‌فرض) در سطح زیرشبکه.
                        \(dqvalid\-lifetime\(dq: 6000,

                        // حداقل مدت اعتبار در سطح زیرشبکه.
                        \(dqmin\-valid\-lifetime\(dq: 4000,

                        // حداکثر مدت اعتبار در سطح زیرشبکه.
                        \(dqmax\-valid\-lifetime\(dq: 8000
                    }
                ],

                // مدت اعتبار (پیش‌فرض) در سطح شبکه اشتراکی.
                \(dqvalid\-lifetime\(dq: 6001,

                // حداقل مدت اعتبار در سطح شبکه اشتراکی.
                \(dqmin\-valid\-lifetime\(dq: 4001,

                // حداکثر مدت اعتبار در سطح شبکه اشتراکی.
                \(dqmax\-valid\-lifetime\(dq: 8001
            }
        ],

        // فهرست زیرشبکه‌های IPv6 که به هیچ شبکه اشتراکی تعلق ندارند.
        \(dqsubnet6\(dq: [],

        // مقدار سراسری مدت اعتبار.
        \(dqvalid\-lifetime\(dq: 6000,

        // حداقل مقدار سراسری مدت اعتبار.
        \(dqmin\-valid\-lifetime\(dq: 4000,

        // حداکثر مقدار سراسری مدت اعتبار.
        \(dqmax\-valid\-lifetime\(dq: 8000,

        // رزروها (نمونه‌ها در فایل‌های دیگر هستند).
        \(dqreservations\(dq: [],

        // کنترل پیکربندی (در حال حاضر استفاده نمی‌شود، یعنی این نحو
        // از پیش تعریف شده اما قابلیت مربوط به آن پیاده‌سازی نشده است).
        \(dqconfig\-control\(dq: {
            // فقط ورودی پایگاه‌داده‌های پیکربندی تعریف شده است.
            \(dqconfig\-databases\(dq: [
                {
                    // نام پایگاه‌داده جهت اتصال.
                    \(dqname\(dq: \(dqconfig\(dq,

                    // نوع پایگاه‌داده، مثلاً \(dqmysql\(dq یا \(dqpostgresql\(dq.
                    \(dqtype\(dq: \(dqmysql\(dq
                }
            ],
            // بازه زمانی میان تلاش‌ها برای واکشی به‌روزرسانی‌های
            // پیکربندی از طریق backendهای پیکربندی استفاده‌شده.
            \(dqconfig\-fetch\-wait\-time\(dq: 30
        },

        // برچسب سرور.
        \(dqserver\-tag\(dq: \(dqmy DHCPv6 server\(dq,

        // پارامترهای کنترل صف DHCP.
        \(dqdhcp\-queue\-control\(dq: {
            // فعال‌سازی صف اجباری است.
            \(dqenable\-queue\(dq: true,

            // نوع صف اجباری است.
            \(dqqueue\-type\(dq: \(dqkea\-ring6\(dq,

            // ظرفیت اختیاری است.
            \(dqcapacity\(dq: 64
        },

        // مشخص می‌کند که آیا سرور باید رزروهای سراسری را جستجو کند یا خیر.
        \(dqreservations\-global\(dq: false,

        // مشخص می‌کند که آیا سرور باید رزروهای درون‌زیرشبکه‌ای را جستجو کند یا خیر.
        \(dqreservations\-in\-subnet\(dq: true,

        // مشخص می‌کند که آیا سرور می‌تواند فرض کند تمام آدرس‌های رزروشده
        // خارج از استخر هستند یا خیر.
        // در صورت false بودن reservations\-in\-subnet نادیده گرفته می‌شود.
        // در صورت تعیین، توسط سطوح \(dqshared\-networks\(dq و
        // \(dqsubnet6\(dq به ارث برده می‌شود.
        \(dqreservations\-out\-of\-pool\(dq: false,

        // محاسبه زمان‌سنج‌های T1 و T2 در سطح سراسری.
        \(dqcalculate\-tee\-times\(dq: true,

        // T1 = valid lifetime * .5.
        \(dqt1\-percent\(dq: .5,

        // T2 = valid lifetime * .75.
        \(dqt2\-percent\(dq: .75,

        // آستانه حافظه موقت (cache threshold) = valid lifetime * .25.
        \(dqcache\-threshold\(dq: .25,

        // حداکثر کش در سطح سراسری.
        \(dqcache\-max\-age\(dq: 1000,

        // آستانه تطبیقی زمان اجاره (1.0 یعنی غیرفعال)
        \(dqadaptive\-lease\-time\-threshold\(dq: 0.8,

        // رشته‌ای از صفر یا چند نویسه که با هر نویسه نامعتبر
        // در Client FQDN جایگزین می‌شود. مقدار پیش‌فرض
        // یک رشته خالی است که باعث می‌شود نویسه‌های نامعتبر به جای
        // جایگزینی، حذف شوند.
        \(dqhostname\-char\-replacement\(dq: \(dqx\(dq,

        // عبارت باقاعده توصیف‌کننده مجموعه نویسه‌های نامعتبر در
        // Client FQDN.
        \(dqhostname\-char\-set\(dq: \(dq[^A\-Za\-z0\-9.\-]\(dq,

        // فهرست گزارش‌گیرهای (loggers) مورد استفاده سرورهایی که از این فایل پیکربندی استفاده می‌کنند.
        \(dqloggers\(dq: [
            {
                // سطح اشکال‌زدایی (debug level)، مقداری بین 0..99. هر چه مقدار بزرگ‌تر
                // باشد، لاگ اشکال‌زدایی جزئیات بیشتری دارد.
                \(dqdebuglevel\(dq: 99,

                // نام گزارش‌گیر.
                \(dqname\(dq: \(dqkea\-dhcp6\(dq,

                // نحوه خروجی دادن لاگ را پیکربندی می‌کند.
                \(dqoutput\-options\(dq: [
                    {
                        // مشخص می‌کند که آیا لاگ باید بی‌درنگ در فایل تخلیه (flush) شود یا خیر.
                        \(dqflush\(dq: true,

                        // حداکثر اندازه فایل قبل از چرخش فایل را مشخص می‌کند.
                        \(dqmaxsize\(dq: 10240000,

                        // حداکثر تعداد فایل‌های چرخیده نگهداری‌شده را مشخص می‌کند.
                        \(dqmaxver\(dq: 1,

                        // مقصد ثبت گزارش را مشخص می‌کند.
                        \(dqoutput\(dq: \(dqstdout\(dq,

                        // محتوای ورودی لاگ را مشخص می‌کند
                        \(dqpattern\(dq: \(dq%D{%Y\-%m\-%d %H:%M:%S.%q} %\-5p [%c/%i] %m\en\(dq
                    }
                ],

                // شدت ثبت گزارش را مشخص می‌کند، یعنی \(dqERROR\(dq، \(dqWARN\(dq، \(dqINFO\(dq، \(dqDEBUG\(dq.
                \(dqseverity\(dq: \(dqINFO\(dq
            }
        ],

        // برای استفاده از user\-contexts به مثال‌های پیشرفته نگاه کنید.
        \(dquser\-context\(dq: { }
    }
}
.EE
.UNINDENT
.UNINDENT.SS kea6/all\-keys.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// هشدار: این پیکربندی نمونه برای استفاده در محیط عملیاتی نیست.
// کارگزار Kea DHCPv6 این پیکربندی را نخواهد پذیرفت زیرا حاوی
// پارامترهای پیکربندی متقابلاً ناسازگار است.
//
// هدف اصلی این فایل نمونه، ارائهٔ فهرستی جامع از پارامترهای
// پشتیبانی‌شده توسط کارگزار Kea DHCPv6 به همراه توضیحی کوتاه
// دربارهٔ هر پارامتر است.
//
// نسخهٔ فعلی باید به‌روز باشد، یعنی کلمات کلیدی جدید باید
// هم‌زمان با مشخصات تجزیه‌کننده به این فایل اضافه شوند.
{
    // پیکربندی کارگزار Kea DHCPv6 از اینجا آغاز می‌شود.
    \(dqDhcp6\(dq: {
        // پرچم سراسری برای انتخاب راهبرد تخصیص نشانی IP برای همهٔ
        // زیرشبکه‌ها.
        \(dqallocator\(dq: \(dqiterative\(dq,

        // پرچم سراسری که ثبت نشانی کلاینت را از طریق بسته‌های
        // ADDR\-REG\-INFORM فعال یا غیرفعال می‌کند (RFC 9686 را ببینید). پیش‌فرض آن true است.
        \(dqallow\-address\-registration\(dq: true,

        // پرچم سراسری برای انتخاب راهبرد تخصیص پیشوند واگذارشده
        // برای همهٔ زیرشبکه‌ها.
        \(dqpd\-allocator\(dq: \(dqrandom\(dq,

        // فهرست مرتب‌شده‌ای از کلاس‌های کلاینت که توسط کارگزار DHCPv6 استفاده می‌شود.
        \(dqclient\-classes\(dq: [
            {
                // نام کلاس.
                \(dqname\(dq: \(dqphones_server1\(dq,

                // فهرست گزینه‌های DHCPv6 ویژهٔ کلاس.
                \(dqoption\-data\(dq: [],

                // عبارت انتخاب کلاس. هنگامی که مقدار عبارت داده‌شده true
                // ارزیابی شود، بستهٔ DHCP به این کلاس اختصاص می‌یابد.
                \(dqtest\(dq: \(dqmember(\(aqHA_server1\(aq)\(dq,

                // طول‌عمر معتبر کلاس.
                \(dqvalid\-lifetime\(dq: 6000,

                // حداقل طول‌عمر معتبر کلاس.
                \(dqmin\-valid\-lifetime\(dq: 4000,

                // حداکثر طول‌عمر معتبر کلاس.
                \(dqmax\-valid\-lifetime\(dq: 8000,

                // طول‌عمر ترجیحی کلاس.
                \(dqpreferred\-lifetime\(dq: 7000,

                // حداقل طول‌عمر ترجیحی کلاس.
                \(dqmin\-preferred\-lifetime\(dq: 5000,

                // حداکثر طول‌عمر ترجیحی کلاس.
                \(dqmax\-preferred\-lifetime\(dq: 9000
            },
            {
                // نام کلاس دوم.
                \(dqname\(dq: \(dqphones_server2\(dq,

                // فهرست گزینه‌های DHCPv6 ویژهٔ کلاس.
                \(dqoption\-data\(dq: [],

                // عبارت انتخاب کلاس. هنگامی که مقدار عبارت داده‌شده true
                // ارزیابی شود، بستهٔ DHCP به این کلاس اختصاص می‌یابد.
                \(dqtest\(dq: \(dqmember(\(aqHA_server2\(aq)\(dq
            },
            {
                // نام کلاس سوم.
                \(dqname\(dq: \(dqlate\(dq,

                // پرچم بولی که مشخص می‌کند آیا عبارت کلاس فقط در صورت نیاز
                // ارزیابی شود یا خیر؛ برای مثال، زمانی که پیکربندی استخر نشانیِ انتخاب‌شده،
                // این نام کلاس را در فهرست \(dqevaluate\-additional\-classes\(dq خود شامل شود.
                // مقدار پیش‌فرض false بدان معناست که عبارت آزمون کلاس باید
                // همیشه ارزیابی شود.
                \(dqonly\-in\-additional\-list\(dq: true,

                // عبارت انتخاب کلاس.
                \(dqtest\(dq: \(dqmember(\(aqALL\(aq)\(dq
            },
            {
                // نام کلاس چهارم.
                \(dqname\(dq: \(dqmy\-template\-class\(dq,

                // پرچم کلاس الگو که حاوی عبارتی برای تولید نام تمام
                // زیرکلاس‌های ایجادشده است. در این حالت، کلاس‌ها بر اساس شناسهٔ کلاینت نام‌گذاری می‌شوند.
                \(dqtemplate\-test\(dq: \(dqsubstring(option[1].hex, 0, all)\(dq
            }
        ],

        // پارامترهایی برای فعال‌سازی رفتارهای سازگار با کلاینت‌ها،
        // رله‌ها یا سایر عامل‌های ناسازگار یا معیوب
        \(dqcompatibility\(dq: {
            // تجزیهٔ آسان‌گیرانه‌تر گزینه‌ها در جایی که فیلدها را می‌توان به طور قطعی
            // استنتاج کرد، حتی اگر خلاف RFC یا رویهٔ معمول باشد.
            \(dqlenient\-option\-parsing\(dq: true
        },

        // پارامترهای پیکربندی سوکت کنترل فرمان برای کارگزار Kea DHCPv6.
        \(dqcontrol\-sockets\(dq: [
            {
                // نوع سوکت کنترلی که توسط کارگزار Kea DHCPv6 استفاده می‌شود.
                // باید unix، http یا https باشد.
                \(dqsocket\-type\(dq: \(dqunix\(dq,

               // مکان فایل سوکت دامنهٔ یونیکس که کارگزار DHCPv6 برای دریافت فرمان‌های
               // کنترلی از مدیر محلی سرور استفاده می‌کند.
               \(dqsocket\-name\(dq: \(dqkea6\-ctrl\-socket\(dq
            },
            {
                // نوع سوکت کنترلی که توسط کارگزار Kea DHCPv6 استفاده می‌شود.
                // باید unix، http یا https باشد.
                \(dqsocket\-type\(dq: \(dqhttps\(dq,

                // نشانی سوکت HTTPS که کارگزار Kea DHCPv6 باید برای
                // پرس‌وجوهای ورودی روی آن گوش فرا دهد.
                \(dqsocket\-address\(dq: \(dq::1\(dq,

                // درگاه سوکت HTTPS که کارگزار Kea DHCPv6 باید برای
                // پرس‌وجوهای ورودی روی آن گوش فرا دهد. در صورت فعال‌سازی HA و
                // چندنخی، درگاه 8000 توسط شنوندهٔ http کتابخانهٔ قلاب HA استفاده می‌شود.
                // هنگام استفاده از کتابخانهٔ قلاب HA با چندنخی، مطمئن شوید
                // درگاهی که توسط شنوندهٔ اختصاصی استفاده می‌شود با درگاه مشخص‌شده در اینجا
                // متفاوت است (مثلاً 8001). توجه داشته باشید که فرمان‌ها همچنان
                // باید به یک سوکت کنترل ارسال شوند. شنوندهٔ اختصاصی
                // صرفاً برای به‌روزرسانی‌های HA است.
                \(dqsocket\-port\(dq: 8006,

                // مرجع اعتماد TLS (مرجع صدور گواهی یا CA). این مقدار نام فایل یا
                // مسیر یک دایرکتوری است. همراه با سایر پارامترهای TLS
                // فقط برای سوکت کنترلی از نوع https معنادار است.
                \(dqtrust\-anchor\(dq: \(dqmy\-ca\(dq,

                // نام فایل گواهی سرور TLS.
                \(dqcert\-file\(dq: \(dqmy\-cert\(dq,

                // نام فایل کلید خصوصی سرور TLS.
                \(dqkey\-file\(dq: \(dqmy\-key\(dq,

                // پرچم الزام گواهی کلاینت در TLS. پیش‌فرض true است
                // و به معنای الزام گواهی‌های کلاینت است. مقدار false
                // به معنای اختیاری بودن آن‌هاست.
                \(dqcert\-required\(dq: true,

                // سرآیندهای اضافی HTTP برای افزودن به پاسخ‌ها.
                \(dqhttp\-headers\(dq:
                [
                    {
                        // بافت کاربری اختیاری.
                        \(dquser\-context\(dq: { \(dqcomment\(dq: \(dqHSTS header\(dq },

                        // نام سرآیند الزامی HTTP.
                        \(dqname\(dq: \(dqStrict\-Transport\-Security\(dq,

                        // مقدار سرآیند الزامی HTTP.
                        \(dqvalue\(dq: \(dqmax\-age=31536000\(dq
                    }
                ],

                // احراز هویت اختیاری.
                \(dqauthentication\(dq: {

                    // نوع احراز هویت الزامی. تنها مقدار پشتیبانی‌شده
                    // basic برای احراز هویت پایه‌ای HTTP است.
                    \(dqtype\(dq: \(dqbasic\(dq,

                    // پارامتر اختیاری قلمرو (realm) احراز هویت پایه‌ای HTTP است.
                    // پیش‌فرض آن \(dqkea\-dhcpv6\-server\(dq است.
                    \(dqrealm\(dq: \(dqkea\-dhcpv6\-server\(dq,

                    // از این پارامتر اختیاری می‌توان برای تعیین یک پیشوند مشترک برای
                    // فایل‌های حاوی اعتبارنامه‌های کلاینت استفاده کرد.
                    \(dqdirectory\(dq: \(dq/usr/local/share/kea/kea\-creds\(dq,

                    // این فهرست شناسه‌های کاربری و گذرواژه‌ها را برای استفاده در
                    // احراز هویت پایه‌ای HTTP مشخص می‌کند. در صورت خالی بودن یا عدم حضور،
                    // هر کلاینتی مجاز شمرده می‌شود.
                    \(dqclients\(dq: [
                        // این گزینه یک کلاینت مجاز را مشخص می‌کند.
                        {
                            // شناسهٔ کاربر نباید خالی باشد یا حاوی نویسهٔ \(aq:\(aq باشد.
                            // این یک پارامتر اجباری است.
                            \(dquser\(dq: \(dqadmin\(dq,

                            // در صورت مشخص نشدن گذرواژه، از گذرواژهٔ
                            // خالی استفاده می‌شود.
                            \(dqpassword\(dq: \(dq1234\(dq
                        },

                        // این گزینه یک کلاینت پنهان را مشخص می‌کند.
                        {
                            // شناسهٔ کاربر محتوای فایل
                            // /usr/local/share/kea/kea\-creds/hiddenu است.
                            \(dquser\-file\(dq: \(dqhiddenu\(dq,

                            // گذرواژه محتوای فایل
                            // /usr/local/share/kea/kea\-creds/hiddenp است.
                            \(dqpassword\-file\(dq: \(dqhiddenp\(dq
                        },

                        // این گزینه یک کلاینت پنهان را با استفاده از
                        // یک راز درون فایل مشخص می‌کند.
                        {
                            // راز، محتوای فایل /usr/local/share/kea/kea\-creds/hiddens
                            // است که باید در قالب <user\-id>:<password> باشد.
                            \(dqpassword\-file\(dq: \(dqhiddens\(dq
                        }
                    ]
                }
            }
        ],

        // پیشوندی را برای الحاق به ابتدای FQDN تولیدشدهٔ کلاینت مشخص می‌کند.
        // این مقدار می‌تواند در سطوح سراسری، shared\-network و subnet تعیین شود.
        \(dqddns\-generated\-prefix\(dq: \(dqmyhost\(dq,

        // پرچم بولی که مشخص می‌کند آیا سرور باید خواستهٔ کلاینت DHCP را برای
        // به‌روزرسانی مستقل DNS نادیده بگیرد یا خیر. با تنظیم این پرچم روی true،
        // سرور به‌روزرسانی‌های DNS را برای هر دو دادهٔ رفت و برگشت
        // ارسال می‌کند. مقدار پیش‌فرض false است که نشان می‌دهد سرور
        // در صورت درخواست، به‌روزرسانی DNS را به کلاینت واگذار می‌کند.
        // این مقدار می‌تواند در سطوح سراسری، shared\-network و subnet تعیین شود.
        \(dqddns\-override\-client\-update\(dq: false,

        // پرچم بولی که مشخص می‌کند آیا سرور باید بر تمایل کلاینت DHCP مبنی بر
        // عدم به‌روزرسانی DNS اولویت داشته باشد یا خیر. با تنظیم این پارامتر روی true،
        // سرور حتی زمانی که کلاینت درخواست عدم به‌روزرسانی داده باشد نیز به‌روزرسانی DNS
        // را ارسال خواهد کرد. این مقدار می‌تواند در سطوح سراسری، shared\-network و subnet تعیین شود.
        \(dqddns\-override\-no\-update\(dq: false,

        // پسوندی که به انتهای نام ناقص ارسال‌شده به DNS اضافه می‌شود. مقدار
        // پیش‌فرض یک رشتهٔ خالی است که نشان می‌دهد هیچ پسوندی اضافه نمی‌شود.
        // این مقدار می‌تواند در سطوح سراسری، shared\-network و subnet تعیین شود.
        \(dqddns\-qualifying\-suffix\(dq: \(dq\(dq,

        // شمارشی که مشخص می‌کند آیا سرور باید به hostname یا Client FQDN ارسال‌شده
        // توسط کلاینت احترام بگذارد یا این نام را جایگزین کند. مقادیر پذیرفته‌شده
        // عبارتند از: \(dqnever\(dq (استفاده از نام ارسالی کلاینت)، \(dqalways\(dq (جایگزینی
        // نام ارسالی کلاینت)، \(dqwhen\-present\(dq (جایگزینی نام ارسالی کلاینت، اما عدم
        // تولید نام در صورتی که کلاینت نامی ارسال نکرده باشد)، \(dqwhen\-not\-present\(dq
        // (تولید نام هنگامی که کلاینت نامی ارسال نکرده باشد، در غیر این صورت
        // حفظ نام ارسالی کلاینت). مقدار پیش‌فرض \(dqnever\(dq است. این مقدار می‌تواند
        // در سطوح سراسری، shared\-network و subnet تعیین شود.
        \(dqddns\-replace\-client\-name\(dq: \(dqnever\(dq,

        // پرچم بولی که به‌روزرسانی DDNS را فعال یا غیرفعال می‌کند. پیش‌فرض
        // آن true است. می‌تواند در سطوح سراسری، shared\-network
        // و subnet تعیین شود. این گزینه همراه با dhcp\-ddns:enable\-updates
        // کار می‌کند که برای فعال‌سازی اتصال به kea\-dhcp\-ddns باید true باشد.
        \(dqddns\-send\-updates\(dq: true,

        // پرچم بولی که در صورت true بودن، به سرور دستور می‌دهد همیشه هنگام تمدید
        // اجاره‌ها، DNS را به‌روز کند، حتی اگر اطلاعات DNS تغییری نکرده باشد.
        // رفتار پیش‌فرض سرور (یعنی false بودن پرچم) این است که فقط در صورت
        // تغییر اطلاعات DNS، آن را به‌روزرسانی کند. می‌تواند در سطوح سراسری، shared\-network و subnet تعیین شود.
        \(dqddns\-update\-on\-renew\(dq: true,

        // پرچم بولی که با هر درخواست به‌روزرسانی DDNS به kea\-dhcp\-ddns
        // ارسال می‌شود تا مشخص کند آیا حل تعارض به‌روزرسانی DNS طبق RFC 4703
        // باید برای درخواست به‌روزرسانی مربوطه اعمال شود یا خیر. مقدار پیش‌فرض این پرچم true است.
        // می‌تواند در سطوح سراسری، shared\-network و subnet تعیین شود.
        // این فیلد با ddns\-conflict\-resolution\-mode جایگزین شده است.
        // تجزیهٔ آن صرفاً برای سازگاری عقبرو حفظ شده است.
        // \(dqddns\-use\-conflict\-resolution\(dq: true,

        // شمارشی که همراه با هر درخواست به‌روزرسانی DDNS به kea\-dhcp\-ddns ارسال می‌شود
        // تا حالت مورد استفاده برای حل تعارض‌ها هنگام انجام به‌روزرسانی‌های DDNS را مشخص کند.
        // مقادیر پذیرفته‌شده عبارتند از:
        // check\-with\-dhcid (شامل افزودن رکورد DHCID و بررسی آن رکورد از طریق تشخیص تعارض مطابق RFC 4703)،
        // no\-check\-with\-dhcid (نادیده گرفتن تشخیص تعارض اما افزودن رکورد DHCID هنگام ایجاد/به‌روزرسانی یک مدخل)،
        // check\-exists\-with\-dhcid (بررسی وجود یک رکورد DHCID موجود بدون بررسی تطابق مقدار رکورد با به‌روزرسانی.
        // این حالت همچنین رکورد DHCID را برای مدخل به‌روز می‌کند)،
        // no\-check\-without\-dhcid (نادیده گرفتن تشخیص تعارض و عدم افزودن رکورد DHCID هنگام ایجاد/به‌روزرسانی مدخل DDNS).
        // مقدار پیش‌فرض \(dqcheck\-with\-dhcid\(dq است. این مقدار می‌تواند
        // در سطوح سراسری، shared\-network و subnet تعیین شود.
        \(dqddns\-conflict\-resolution\-mode\(dq: \(dqcheck\-with\-dhcid\(dq,

        // در صورتی که بزرگ‌تر از 0.0 باشد، درصدی از طول‌عمر اجاره است
        // که برای TTL در DNS استفاده می‌شود.
        \(dqddns\-ttl\-percent\(dq: 0.75,

        // در صورتی که بزرگ‌تر از 0 باشد، به عنوان TTL در DNS استفاده خواهد شد. بر حسب ثانیه مشخص می‌شود.
        // نمی‌توان هم‌زمان ddns\-ttl و هر یک از مقادیر ddns\-ttl\-percent، ddns\-ttl\-min یا
        // ddns\-ttl\-max را تعیین کرد. آن‌ها متقابلاً ناسازگار هستند.
        // \(dqddns\-ttl\(dq: 500,

        // در صورتی که بزرگ‌تر از 0 باشد، به عنوان کران پایین برای مقادیر محاسبه‌شدهٔ TTL در DNS استفاده می‌شود.
        // بر حسب ثانیه مشخص می‌شود.
        \(dqddns\-ttl\-min\(dq: 24000,

        // در صورتی که بزرگ‌تر از 0 باشد، به عنوان کران بالا برای مقادیر محاسبه‌شدهٔ TTL در DNS استفاده می‌شود.
        // بر حسب ثانیه مشخص می‌شود.
        \(dqddns\-ttl\-max\(dq: 64000,

        // زمان بر حسب ثانیه که مشخص می‌کند یک اجارهٔ ردشده چه مدت باید
        // از تخصیص‌های DHCP مستثنی شود. مقدار پیش‌فرض ۲۴ ساعت است.
        \(dqdecline\-probation\-period\(dq: 86400,

        // پیکربندی ارسال درخواست تغییر نام (NCR) برای کارگزار Kea DHCPv6.
        // درخواست‌های NCR پس از تخصیص اجاره‌های DHCP برای به‌روزرسانی DNS
        // به ماژول Kea D2 ارسال می‌شوند.
        \(dqdhcp\-ddns\(dq: {
            // پرچم بولی که مشخص می‌کند آیا کارگزار Kea DHCPv6 باید به
            // kea\-dhcp\-ddns متصل شود یا خیر. این مقدار برای ایجاد و ارسال
            // NCRها به kea\-dhcp\-ddns باید true باشد. به طور پیش‌فرض، NCRها تولید نمی‌شوند.
            \(dqenable\-updates\(dq: false,

            // حداکثر تعداد NCRهایی که در صف انتظار برای ارسال
            // به کارگزار Kea D2 قرار می‌گیرند را مشخص می‌کند.
            \(dqmax\-queue\-size\(dq: 1024,

            // قالب بسته‌ای که هنگام ارسال NCRها به کارگزار Kea D2 استفاده می‌شود.
            // در حال حاضر، فقط قالب JSON پشتیبانی می‌شود.
            \(dqncr\-format\(dq: \(dqJSON\(dq,

            // پروتکل سوکت مورد استفاده هنگام ارسال NCRها به D2. در حال حاضر،
            // فقط UDP پشتیبانی می‌شود.
            \(dqncr\-protocol\(dq: \(dqUDP\(dq,

            // نشانی IP که کارگزار Kea DHCPv6 باید برای ارسال NCRها به D2
            // استفاده کند. مقدار پیش‌فرض صفر نشان می‌دهد که Kea
            // باید یک نشانی مناسب را انتخاب کند.
            \(dqsender\-ip\(dq: \(dq::1\(dq,

            // شماره درگاهی که کارگزار Kea DHCPv6 باید برای ارسال NCRها به D2
            // استفاده کند. مقدار پیش‌فرض صفر نشان می‌دهد که Kea
            // باید یک درگاه مناسب را انتخاب کند.
            \(dqsender\-port\(dq: 0,

            // نشانی IP که D2 روی آن به NCRها گوش می‌دهد.
            \(dqserver\-ip\(dq: \(dq::1\(dq,

            // شماره درگاهی که D2 روی آن به NCRها گوش می‌دهد.
            \(dqserver\-port\(dq: 53001
        },

        // اولین درگاه از دو درگاه متوالی سوکت‌های UDP مورد استفاده برای ارتباط
        // بین کارگزارهای DHCPv6 و DHCPv4 را مشخص می‌کند. RFC 7341 را ببینید.
        // (پیش‌فرض 0 \- غیرفعال).
        // در صورت فعال بودن، مثلاً از 786 استفاده کنید.
        \(dqdhcp4o6\-port\(dq: 0,

        // مجموعه‌ای از پارامترهای کارگزار Kea DHCPv6 که نحوهٔ پردازش
        // اجاره‌های منقضی‌شدهٔ DHCP توسط کارگزار را پیکربندی می‌کند.
        \(dqexpired\-leases\-processing\(dq: {
            // تعداد ثانیه‌های گذشته از آخرین حذف اجاره‌های منقضی‌شده را مشخص می‌کند
            // که پس از آن باید حذف بعدی رخ دهد.
            // اگر هر دو مقدار \(dqflush\-reclaimed\-timer\-wait\-time\(dq و
            // \(dqhold\-reclaimed\-time\(dq غیر صفر باشند، هنگامی که کلاینت پیام آزادسازی
            // ارسال می‌کند، اجاره به جای حذف شدن از فضای ذخیره‌سازی اجاره،
            // منقضی می‌شود.
            \(dqflush\-reclaimed\-timer\-wait\-time\(dq: 25,

            // مدت‌زمان بر حسب ثانیه برای نگه‌داشتن اجاره‌های منقضی‌شده
            // در پایگاه‌دادهٔ اجاره (همبستگی اجاره) را مشخص می‌کند.
            // اگر هر دو مقدار \(dqflush\-reclaimed\-timer\-wait\-time\(dq و
            // \(dqhold\-reclaimed\-time\(dq غیر صفر باشند، هنگامی که کلاینت پیام آزادسازی
            // ارسال می‌کند، اجاره به جای حذف شدن از فضای ذخیره‌سازی اجاره،
            // منقضی می‌شود.
            \(dqhold\-reclaimed\-time\(dq: 3600,

            // حداکثر تعداد اجاره‌های منقضی‌شده‌ای که می‌توان در یک تلاش برای
            // پاک‌سازی از پایگاه‌دادهٔ اجاره پردازش کرد را مشخص می‌کند. اگر اجاره‌های
            // منقضی‌شدهٔ بیشتری وجود داشته باشد، در تلاش بعدی پاک‌سازی
            // پردازش خواهند شد.
            \(dqmax\-reclaim\-leases\(dq: 100,

            // حداکثر زمانی بر حسب میلی‌ثانیه که یک تلاش واحد برای پاک‌سازی
            // اجاره‌های منقضی‌شده از پایگاه‌دادهٔ اجاره می‌تواند طول بکشد را مشخص می‌کند.
            \(dqmax\-reclaim\-time\(dq: 250,

            // مدت‌زمان بر حسب ثانیه از آخرین تلاش برای پردازش اجاره‌های منقضی‌شده
            // پیش از آغاز تلاش بعدی را مشخص می‌کند.
            \(dqreclaim\-timer\-wait\-time\(dq: 10,

            // حداکثر تعداد چرخه‌های پردازش اجاره‌های منقضی‌شده که منجر به
            // پاک‌سازی کامل از پایگاه‌دادهٔ اجاره نشده‌اند را مشخص می‌کند
            // که پس از آن یک پیام هشدار صادر می‌شود.
            \(dqunwarned\-reclaim\-cycles\(dq: 5
        },

        // فهرست کتابخانه‌های قلاب و پارامترهای پیکربندی خاص آن‌ها
        // که باید توسط کارگزار Kea DHCPv4 بارگیری شوند.
        \(dqhooks\-libraries\(dq: [
            {
                // مکان کتابخانهٔ قلاب که باید بارگیری شود.
                \(dqlibrary\(dq: \(dqlibdhcp_lease_cmds.so\(dq,

                // پارامترهای پیکربندی ویژهٔ کتابخانهٔ قلاب.
                \(dqparameters\(dq: { }
            },
            {
                // کتابخانهٔ قلاب پسانهٔ میزبان MySQL که برای ذخیره‌سازی میزبان مورد نیاز است.
                \(dqlibrary\(dq: \(dqlibdhcp_mysql.so\(dq
            },
            {
                // کتابخانهٔ قلاب پسانهٔ میزبان PostgreSQL که برای ذخیره‌سازی میزبان مورد نیاز است.
                \(dqlibrary\(dq: \(dqlibdhcp_pgsql.so\(dq
            }
        ],

        // فهرست اعتبارنامه‌های دسترسی به منابع خارجی رزروهای IPv6،
        \(dqhosts\-databases\(dq: [
            {
                // نام پایگاه‌داده برای اتصال.
                \(dqname\(dq: \(dqkeatest\(dq,

                // میزبانی که پایگاه‌داده روی آن قرار دارد.
                \(dqhost\(dq: \(dqlocalhost\(dq,

                // گذرواژهٔ پایگاه‌داده.
                \(dqpassword\(dq: \(dq1234\(dq,

                // درگاهی که پایگاه‌داده روی آن در دسترس است.
                \(dqport\(dq: 3306,

                // نوع پایگاه‌داده، مثلاً \(dqmysql\(dq، \(dqpostgresql\(dq.
                \(dqtype\(dq: \(dqmysql\(dq,

                // نام کاربری مورد استفاده برای دسترسی به پایگاه‌داده.
                \(dquser\(dq: \(dqkeatest\(dq,

                // حالت فقط‌خواندنی.
                \(dqreadonly\(dq: false,

                // مدخل‌های بعدی برای پشتیبانی از OpenSSL در MySQL هستند.

                // مرجع اعتماد یا همان فایل یا دایرکتوری مرجع صدور گواهی.
                \(dqtrust\-anchor\(dq: \(dqmy\-ca\(dq,

                // نام فایل گواهی کلاینت.
                \(dqcert\-file\(dq: \(dqmy\-cert\(dq,

                // نام فایل کلید خصوصی.
                \(dqkey\-file\(dq: \(dqmy\-key\(dq,

                // فهرست رمزها (راهنمای دستور ciphers در OpenSSL را ببینید).
                \(dqcipher\-list\(dq: \(dqAES\(dq,

                // زمان انتظار برای اتصال مجدد.
                // این پارامتر مشخص می‌کند که Kea قبل از تلاش برای اتصال مجدد چه مدت منتظر بماند.
                // بر حسب میلی‌ثانیه بیان می‌شود. مقدار پیش‌فرض برای MySQL و PostgreSQL
                // برابر 0 (غیرفعال) است.
                \(dqreconnect\-wait\-time\(dq: 3000,

                // حداکثر دفعات تلاش برای اتصال مجدد.
                \(dqmax\-reconnect\-tries\(dq: 3,

                // اقدامی که هنگام شکست بازیابی اتصال انجام می‌شود.
                // مقادیر پشتیبانی‌شده: stop\-retry\-exit، serve\-retry\-exit،
                // serve\-retry\-continue
                \(dqon\-fail\(dq: \(dqstop\-retry\-exit\(dq,

                // پرچمی که مشخص می‌کند آیا باید هنگام راه‌اندازی سرور
                // و رویدادهای پیکربندی مجدد، بازیابی پایگاه‌داده انجام شود یا خیر.
                \(dqretry\-on\-startup\(dq: false,

                // مهلت زمانی اتصال بر حسب ثانیه.
                \(dqconnect\-timeout\(dq: 100,

                // مهلت زمانی عملیات خواندن پایگاه‌داده بر حسب ثانیه.
                \(dqread\-timeout\(dq: 120,

                // مهلت زمانی عملیات نوشتن پایگاه‌داده بر حسب ثانیه.
                \(dqwrite\-timeout\(dq: 180
            },
            {
                // نام پایگاه‌داده برای اتصال.
                \(dqname\(dq: \(dqkeatest\(dq,

                // میزبانی که پایگاه‌داده روی آن قرار دارد.
                \(dqhost\(dq: \(dqlocalhost\(dq,

                // گذرواژهٔ پایگاه‌داده.
                \(dqpassword\(dq: \(dq1234\(dq,

                // درگاهی که پایگاه‌داده روی آن در دسترس است.
                \(dqport\(dq: 5432,

                // نوع پایگاه‌داده، مثلاً \(dqmysql\(dq، \(dqpostgresql\(dq.
                \(dqtype\(dq: \(dqpostgresql\(dq,

                // نام کاربری مورد استفاده برای دسترسی به پایگاه‌داده.
                \(dquser\(dq: \(dqkeatest\(dq,

                // مهلت زمانی کاربر TCP هنگام برقراری ارتباط با پایگاه‌داده.
                // بر حسب ثانیه مشخص می‌شود.
                \(dqtcp\-user\-timeout\(dq: 100,

                // مرجع اعتماد یا همان فایل یا دایرکتوری مرجع صدور گواهی.
                \(dqtrust\-anchor\(dq: \(dqmy\-ca\(dq,

                // نام فایل گواهی کلاینت.
                \(dqcert\-file\(dq: \(dqmy\-cert\(dq,

                // نام فایل کلید خصوصی.
                \(dqkey\-file\(dq: \(dqmy\-key\(dq,

                // حالت SSL.
                \(dqssl\-mode\(dq: \(dqverify\-ca\(dq
            }
        ],

        // فهرست انواع شناسه‌های رزرو میزبان که توسط کارگزار Kea DHCPv6
        // برای واکشی رزروهای ایستا برای کلاینت‌های DHCP استفاده می‌شود.
        // به طور پیش‌فرض از تمام شناسه‌ها استفاده می‌شود، به این معنی که سرور
        // برای بررسی وجود رزرو برای یک کلاینت خاص، چندین پرس‌وجو
        // به پایگاه‌داده ارسال می‌کند. اگر در یک استقرار خاص تنها از یک زیرمجموعه
        // (مثلاً یک نوع شناسه) استفاده می‌شود، برای جلوگیری از پرس‌وجوهای غیرضروری به پایگاه‌داده،
        // فقط باید همان شناسه در اینجا ذکر شود.
        \(dqhost\-reservation\-identifiers\(dq: [
            \(dqhw\-address\(dq,
            \(dqduid\(dq,
            \(dqflex\-id\(dq
        ],

        // پیکربندی رابط‌هایی را مشخص می‌کند که کارگزار Kea DHCPv6
        // روی آن‌ها به پرس‌وجوهای DHCP گوش می‌دهد.
        \(dqinterfaces\-config\(dq: {
            // فهرستی از رابط‌ها را مشخص می‌کند که کارگزار Kea DHCPv6
            // باید روی آن‌ها به درخواست‌های DHCP گوش دهد.
            \(dqinterfaces\(dq: [
                \(dqeth0\(dq
            ],

            // پرچم بولی که مشخص می‌کند آیا رابط‌های موجود باید در هنگام
            // پیکربندی مجدد سرور دوباره شناسایی شوند یا خیر. مقدار پیش‌فرض
            // true است، به این معنی که رابط‌ها همیشه دوباره شناسایی می‌شوند.
            \(dqre\-detect\(dq: true,

            // Kea در حین مقداردهی اولیه سعی می‌کند سوکت‌های سرویس را متصل کند،
            // اما ممکن است به دلیل باز بودن قبلی یک درگاه یا پیکربندی نادرست با شکست مواجه شود.
            // Kea می‌تواند این خطاها را نادیده بگیرد و فقط ثبت کند. این پرچم
            // از شروع به کار کارگزار DHCP بدون اتصال موفقیت‌آمیز تمام سوکت‌ها جلوگیری می‌کند.
            // در صورت عدم تعیین، پیش‌فرض false است.
            \(dqservice\-sockets\-require\-all\(dq: true,

            // Kea در حین مقداردهی اولیه سعی می‌کند سوکت‌های سرویس را متصل کند. این
            // گزینه مشخص می‌کند که تلاش برای اتصال به رابط چند بار تکرار خواهد شد.
            // مقدار پیش‌فرض 0 است، به این معنی که عملیات تکرار نخواهد شد.
            \(dqservice\-sockets\-max\-retries\(dq: 5,

            // بازهٔ زمانی بر حسب میلی‌ثانیه برای انتظار پیش از تلاش بعدی جهت
            // باز کردن مجدد یک سوکت سرویس.
            \(dqservice\-sockets\-retry\-wait\-time\(dq: 5000
        },

        // پارامتر بولی که کنترل می‌کند آیا جستجوی زودهنگام رزروهای سراسری میزبان
        // باید انجام شود یا خیر. این جستجو قبل از انتخاب زیرشبکه انجام می‌شود
        // و هنگامی که یک رزرو سراسری با برخی کلاس‌های کلاینت یافت شود،
        // فاز دوم دسته‌بندی را فعال می‌کند. همچنین می‌توان از آن برای رد کردن
        // پرس‌وجوها با استفاده از رزروهای میزبان به عنوان جدول تصمیم‌گیری
        // نمایه‌شده با شناسه‌های رزرو استفاده کرد.
        \(dqearly\-global\-reservations\-lookup\(dq: true,

        // پارامتر بولی که رفتار کارگزار DHCP را در رابطه با ایجاد رزروهای میزبان
        // برای یک نشانی IP یا پیشوند واگذارشدهٔ یکسان کنترل می‌کند. به طور پیش‌فرض این پرچم
        // روی true تنظیم شده است که در این حالت، سرور از ایجاد چندین رزرو میزبان
        // برای یک نشانی IP یا پیشوند واگذارشده یکسان جلوگیری می‌کند. وقتی این پارامتر
        // روی false تنظیم شود، سرور اجازهٔ ایجاد چندین رزرو برای یک نشانی IP یا
        // پیشوند واگذارشده یکسان را درون یک زیرشبکه می‌دهد. این تنظیم در استقرارهایی مفید است
        // که در آن‌ها ممکن است یک میزبان مشخص از طریق چندین رابط با کارگزار DHCP ارتباط برقرار کند
        // و بسته به رابط انتخاب‌شده، از نشانی‌های MAC (یا شناسه‌های دیگر) متفاوتی
        // برای شناسایی میزبان استفاده شود. توجه داشته باشید که برخی از پسانه‌های میزبان از حالتی
        // که چندین رزرو برای یک نشانی IP یا پیشوند واگذارشده یکسان استفاده می‌شود پشتیبانی نمی‌کنند.
        // اگر از این پسانه‌ها استفاده شود و این تنظیم اعمال گردد، خطای پیکربندی رخ خواهد داد.
        // پسانه‌های MySQL و PostgreSQL از این حالت پشتیبانی می‌کنند.
        \(dqip\-reservations\-unique\(dq: true,

        // پارامتر بولی که کنترل می‌کند آیا جستجوی رزروهای میزبان باید پیش از
        // جستجوی اجاره انجام شود یا خیر. این پارامتر فقط زمانی اثر دارد که
        // چندنخی غیرفعال باشد. هنگامی که چندنخی فعال است، جستجوی رزروهای
        // میزبان همیشه ابتدا انجام می‌شود تا از قفل شدن منابع هنگام جستجوی اجاره جلوگیری گردد.
        \(dqreservations\-lookup\-first\(dq: true,

        // اعتبارنامه‌های دسترسی به پایگاه‌دادهٔ اجاره را مشخص می‌کند.
        \(dqlease\-database\(dq: {
            // پارامتر ویژهٔ پسانهٔ memfile که بازهٔ زمانی بر حسب ثانیه را مشخص می‌کند
            // که در آن فایل اجاره باید پاک‌سازی شود (مدخل‌های اجارهٔ منسوخ حذف می‌شوند
            // تا از رشد بی‌رویه و بی‌نهایت فایل اجاره جلوگیری شود).
            \(dqlfc\-interval\(dq: 3600,

            // حداکثر تعداد خطاهای مجاز خواندن فایل اجاره پیش از لغو بارگیری فایل.
            // پیش‌فرض 0 است (بدون محدودیت).
            \(dqmax\-row\-errors\(dq: 100,

            // نام فایل اجاره. در صورت استفاده از پایگاه‌داده، نام
            // پایگاه‌داده را مشخص می‌کند.
            \(dqname\(dq: \(dqkea\-leases6.csv\(dq,

            // پارامتر ویژهٔ memfile که مشخص می‌کند آیا اجاره‌ها باید روی فضای
            // ذخیره‌سازی دائمی (دیسک) ذخیره شوند یا خیر. مقدار true پیش‌فرض
            // است و نشان می‌دهد که اجاره‌ها در فضای ذخیره‌سازی دائمی ذخیره می‌شوند.
            // این تنظیم باید در محیط عملیاتی استفاده شود. مقدار false فقط باید
            // برای اهداف آزمایشی استفاده شود زیرا اجاره‌های ذخیره‌نشده پس از راه‌اندازی مجدد کارگزار Kea از بین خواهند رفت.
            \(dqpersist\(dq: true,

            // نوع پسانهٔ پایگاه‌دادهٔ اجاره، یعنی \(dqmemfile\(dq، \(dqmysql\(dq یا
            // \(dqpostgresql\(dq.
            \(dqtype\(dq: \(dqmemfile\(dq
        },

        // فهرستی از پارامترها که مشخص می‌کنند چگونه نشانی MAC کلاینت را می‌توان
        // از پرس‌وجوی DHCP استنتاج کرد. مقادیر پشتیبانی‌شده در «راهنمای مرجع
        // مدیر سیستم Kea» فهرست شده‌اند.
        \(dqmac\-sources\(dq: [ \(dqduid\(dq ],

        // فهرستی از گزینه‌های سراسری DHCP که کارگزار Kea DHCPv6 به
        // کلاینت‌ها اختصاص می‌دهد.
        \(dqoption\-data\(dq: [
            {
                // پرچم بولی که مشخص می‌کند آیا گزینهٔ داده‌شده همیشه در پاسخ
                // ارسال شود یا تنها در صورت درخواست. مقدار پیش‌فرض false
                // نشان می‌دهد که تنها در صورت درخواست ارسال می‌شود.
                \(dqalways\-send\(dq: false,

                // فهرستی اختیاری از کلاس‌هایی که این گزینه برای آن‌ها اعمال می‌شود.
                // اگر کلاینت با هر یک از کلاس‌های موجود در این فهرست مطابقت داشته باشد،
                // گزینه اعمال خواهد شد. اگر فهرست خالی باشد یا حذف شود،
                // این گزینه فارغ از عضویت در کلاس اعمال خواهد شد.
                \(dqclient\-classes\(dq: [ \(dqclass1\(dq, \(dqclass2\(dq ],

                // کد گزینه. در صورت ارائهٔ نام گزینه، الزامی
                // نیست.
                \(dqcode\(dq: 23,

                // مقدار بولی که مشخص می‌کند آیا داده‌های گزینهٔ مشخص‌شده
                // در فیلد \(dqdata\(dq به صورت رشته‌ای از ارقام هگزادسیمال مشخص شده است
                // یا در قالب CSV خوانا برای انسان.
                \(dqcsv\-format\(dq: true,

                // داده‌های گزینه برای ذخیره در بدنهٔ گزینه.
                \(dqdata\(dq: \(dq2001:db8:2::45, 2001:db8:2::100\(dq,

                // نام گزینه. در صورت ارائهٔ کد گزینه، الزامی
                // نیست.
                \(dqname\(dq: \(dqdns\-servers\(dq,

                // پرچم بولی که مشخص می‌کند آیا گزینهٔ داده‌شده هرگز در پاسخ
                // ارسال نشود یا خیر. مقدار پیش‌فرض false نشان می‌دهد که زمانی که
                // باید، ارسال می‌شود. در صورت true بودن، گزینه صرف‌نظر از هر تنظیم دیگری
                // ارسال نمی‌شود؛ یعنی یک پرچم قطعی و نهایی است.
                \(dqnever\-send\(dq: false,

                // فضای گزینه. مقدار پیش‌فرض فضای گزینهٔ \(dqdhcp6\(dq است
                // که گزینه‌های سطح‌بالای DHCPv6 را گروه‌بندی می‌کند.
                \(dqspace\(dq: \(dqdhcp6\(dq
            }
        ],

        // فهرستی از تعاریف گزینه‌های سراسری، یعنی قالب‌های گزینه‌ها، که
        // کارگزار Kea DHCPv6 از آن‌ها استفاده می‌کند.
        \(dqoption\-def\(dq: [
            {
                // پرچم بولی که مشخص می‌کند آیا تعریف گزینه شامل آرایه‌ای از
                // مقادیر یک نوع خاص است یا خیر، مثلاً آرایه‌ای از نشانی‌های IPv6.
                // مقدار پیش‌فرض false به این معنی است که گزینه شامل آرایه‌ای از مقادیر نیست.
                \(dqarray\(dq: false,

                // کد گزینه.
                \(dqcode\(dq: 6,

                // نام فضای گزینه‌ای را که توسط این گزینه کپسوله‌سازی شده است نگه می‌دارد.
                // تمام گزینه‌های متعلق به این فضای گزینه به عنوان زیرگزینه‌های این گزینه
                // ارسال خواهند شد. یک رشتهٔ خالی به این معنی است که این گزینه هیچ گزینه‌ای را
                // کپسوله نمی‌کند.
                \(dqencapsulate\(dq: \(dq\(dq,

                // نام گزینه.
                \(dqname\(dq: \(dqmy\-option\(dq,

                // انواع فیلدهای درون گزینه را در صورتی که گزینه یک \(dqrecord\(dq باشد
                // مشخص می‌کند (\(dqtype\(dq را ببینید). در این مثال خاص این گزینه
                // شامل دو فیلد به طول ۱ بایت و ۲ بایت است.
                \(dqrecord\-types\(dq: \(dquint8, uint16\(dq,

                // نام فضای گزینه‌ای که این گزینه به آن تعلق دارد.
                \(dqspace\(dq: \(dqmy\-space\(dq,

                // نوع گزینه. تمام انواع ممکن در «راهنمای مرجع مدیر سیستم Kea»
                // فهرست شده‌اند.
                \(dqtype\(dq: \(dqrecord\(dq
            }
        ],

        // مقدار سراسری که تعداد بسته‌های کلاینت (مانند REQUESTها، RENEWها و...)
        // را که ممکن است در انتظار تکمیل کار کتابخانهٔ قلاب، پیش از ارسال پاسخ
        // (مانند REPLY) به کلاینت متوقف شوند، محدود می‌کند. یک مثال متداول زمانی است
        // که kea\-dhcp6 یک REQUEST را متوقف می‌کند در حالی که به‌روزرسانی(های) اجاره را به
        // همتایان HA خود ارسال می‌کند. بسته پس از تأیید به‌روزرسانی(ها) از حالت توقف خارج می‌شود.
        // این مقدار، تعداد بسته‌هایی را که می‌توان در انتظار به‌روزرسانی‌ها نگه داشت،
        // محدود می‌کند. در زمان ترافیک سنگین کلاینت، این مقدار می‌تواند مانع از انباشت
        // بیش از حد و حل‌نشدنی به‌روزرسانی‌ها در kea\-dhcp6 شود.
        \(dqparked\-packet\-limit\(dq: 256,

        // مقدار سراسری (پیش‌فرض) طول‌عمر ترجیحی.
        \(dqpreferred\-lifetime\(dq: 50,

        // حداقل مقدار سراسری طول‌عمر ترجیحی.
        \(dqmin\-preferred\-lifetime\(dq: 40,

        // حداکثر مقدار سراسری طول‌عمر ترجیحی.
        \(dqmax\-preferred\-lifetime\(dq: 60,

        // مقدار سراسری تایمر پیوند مجدد، یعنی زمانی که پس از آن
        // کلاینت DHCP در صورت عدم موفقیت در تمدید اجاره، وارد وضعیت rebind می‌شود.
        \(dqrebind\-timer\(dq: 40,

        // فهرست کدهای گزینه‌های ارائه‌شده توسط رله. RFC 6422 را ببینید.
        \(dqrelay\-supplied\-options\(dq: [ \(dq110\(dq, \(dq120\(dq, \(dq130\(dq ],

        // مقدار سراسری تایمر تمدید، یعنی زمانی که پس از آن
        // کلاینت DHCP اجاره را تمدید می‌کند.
        \(dqrenew\-timer\(dq: 30,

        // مقدار سراسری برای ذخیرهٔ اطلاعات تکمیلی (مانند اطلاعات عامل
        // رله) به همراه هر اجاره.
        \(dqstore\-extended\-info\(dq: true,

        // آمارها نمونه‌هایی را به ازای هر نقطهٔ مشاهده نگه‌داری می‌کنند.
        // دو مقدار پیش‌فرض وجود دارد: حداکثر تعداد و حداکثر سن.
        // تنظیم حداکثر تعداد روی صفر، آن را غیرفعال می‌کند.
        \(dqstatistic\-default\-sample\-count\(dq: 0,

        // هنگامی که حداکثر تعداد 0 باشد، حداکثر سن (بر حسب ثانیه) اعمال می‌شود.
        \(dqstatistic\-default\-sample\-age\(dq: 60,

        // پارامترهای چندنخی.
        \(dqmulti\-threading\(dq: {
            // به طور پیش‌فرض، در صورتی که سخت‌افزار اجازه دهد، Kea بسته‌ها را روی چندین نخ پردازش می‌کند.
            \(dqenable\-multi\-threading\(dq: true,

            // هنگامی که چندنخی فعال است، Kea بسته‌ها را روی تعدادی نخ که از طریق این گزینه
            // قابل پیکربندی است، پردازش خواهد کرد. مقدار باید یک عدد صحیح مثبت باشد
            // (0 یعنی تشخیص خودکار).
            \(dqthread\-pool\-size\(dq: 0,

            // هنگامی که چندنخی فعال است، Kea بسته‌ها را از رابط می‌خواند و یک مورد کاری را
            // به مخزن نخ‌ها اضافه می‌کند. این گزینه حداکثر تعداد مواردی را که می‌توان
            // در صف قرار داد پیکربندی می‌کند. مقدار باید یک عدد صحیح مثبت باشد (0 یعنی نامحدود).
            \(dqpacket\-queue\-size\(dq: 0
        },

        // تعیین می‌کند که کارگزار Kea DHCPv6 چگونه باید با داده‌های
        // نامعتبر دریافت شده از کلاینت برخورد کند.
        \(dqsanity\-checks\(dq: {
            // مشخص می‌کند که کارگزار Kea DHCPv6 هنگامی که داده‌های نامعتبر برای یک اجاره
            // از فایل اجاره خوانده می‌شود، چگونه باید رفتار کند. مقادیر زیر پشتیبانی می‌شوند:
            // \(dqnone\(dq (تلاشی برای تصحیح اطلاعات اجاره انجام نده)،
            // \(dqwarn\(dq (چاپ یک هشدار برای ناهماهنگی‌های مربوط به subnet\-id)،
            // \(dqfix\(dq (تصحیح شناسهٔ زیرشبکه با تلاش برای یافتن زیرشبکهٔ مناسب)،
            // \(dqfix\-del\(dq (مشابه \(dqfix\(dq اما حذف اجاره در صورت پیدا نشدن زیرشبکهٔ مناسب)،
            // \(dqdel\(dq (حذف اجاره در صورتی که اجاره دارای مقدار شناسهٔ زیرشبکهٔ نامعتبر باشد).
            \(dqlease\-checks\(dq: \(dqwarn\(dq,

            // مشخص می‌کند که کارگزار Kea DHCPv4 هنگامی که اطلاعات تکمیلی نامعتبر
            // برای یک اجاره از فایل اجاره خوانده می‌شود، یا در هنگام ارتقا از قالب قدیمی،
            // چگونه باید رفتار کند. مقادیر زیر پشتیبانی می‌شوند:
            // \(dqnone\(dq (تلاشی برای تصحیح یا ارتقای اطلاعات تکمیلی انجام نده)،
            // \(dqfix\(dq (اصلاح ناهماهنگی‌های معمول و ارتقا از قالب قدیمی؛ این مقدار پیش‌فرض است)،
            // \(dqstrict\(dq (اصلاح ناهماهنگی‌های موثر بر Leasequery)،
            // \(dqpedantic\(dq (اعمال کامل قالب کد Kea).
            \(dqextended\-info\-checks\(dq: \(dqfix\(dq
        },

        // مقدار DUID سفارشی مورد استفاده توسط کارگزار DHCPv6.
        \(dqserver\-id\(dq: {
            // نوع DUID. مقادیر ممکن عبارتند از \(dqLLT\(dq، \(dqEN\(dq و \(dqLL\(dq.
            \(dqtype\(dq: \(dqEN\(dq,

            // شناسهٔ سازمانی مورد استفاده برای DUID از نوع \(dqEN\(dq.
            \(dqenterprise\-id\(dq: 2495,

            // بخش شناسهٔ DUID.
            \(dqidentifier\(dq: \(dq0123456789\(dq,

            // پرچم بولی که مشخص می‌کند آیا DUID باید روی دیسک
            // ذخیره شود یا خیر.
            \(dqpersist\(dq: false
        },

        // فهرست شبکه‌های اشتراکی مورد استفاده توسط کارگزار Kea DHCPv6. شبکه‌های
        // اشتراکی، زیرشبکه‌ها را با هم گروه‌بندی می‌کنند.
        \(dqshared\-networks\(dq: [
            {
                // پرچمی برای انتخاب راهبرد تخصیص نشانی IP برای همهٔ
                // زیرشبکه‌ها در این شبکهٔ اشتراکی.
                \(dqallocator\(dq: \(dqrandom\(dq,

                // پرچمی برای انتخاب راهبرد تخصیص پیشوند واگذارشده برای
                // همهٔ زیرشبکه‌ها در این شبکهٔ اشتراکی.
                \(dqpd\-allocator\(dq: \(dqiterative\(dq,

                // این شبکهٔ اشتراکی را محدود می‌کند تا فقط به کلاینت‌هایی
                // اجازه دهد که دست‌کم به یکی از کلاس‌های این فهرست تعلق دارند.
                // اگر حذف شود یا یک فهرست خالی ارائه گردد، هیچ محدودیتی اعمال نمی‌شود.
                \(dqclient\-classes\(dq: [],

                // مقدار در سطح شبکهٔ اشتراکی. توضیحات را در سطح سراسری ببینید.
                \(dqddns\-generated\-prefix\(dq: \(dqmyhost\(dq,

                // مقدار در سطح شبکهٔ اشتراکی. توضیحات را در سطح سراسری ببینید.
                \(dqddns\-override\-client\-update\(dq: false,

                // مقدار در سطح شبکهٔ اشتراکی. توضیحات را در سطح سراسری ببینید.
                \(dqddns\-override\-no\-update\(dq: false,

                // مقدار در سطح شبکهٔ اشتراکی. توضیحات را در سطح سراسری ببینید.
                \(dqddns\-qualifying\-suffix\(dq: \(dq\(dq,

                // مقدار در سطح شبکهٔ اشتراکی. توضیحات را در سطح سراسری ببینید.
                \(dqddns\-replace\-client\-name\(dq: \(dqnever\(dq,

                // مقدار در سطح شبکهٔ اشتراکی. توضیحات را در سطح سراسری ببینید.
                \(dqddns\-send\-updates\(dq: true,

                // مقدار در سطح شبکهٔ اشتراکی. توضیحات را در سطح سراسری ببینید.
                \(dqddns\-update\-on\-renew\(dq: true,

                // مقدار در سطح شبکهٔ اشتراکی. توضیحات را در سطح سراسری ببینید.
                // این فیلد با ddns\-conflict\-resolution\-mode جایگزین شده است.
                // تجزیهٔ آن صرفاً برای سازگاری عقبرو حفظ شده است.
                // \(dqddns\-use\-conflict\-resolution\(dq: true,

                // مقدار در سطح شبکهٔ اشتراکی. توضیحات را در سطح سراسری ببینید.
                \(dqddns\-conflict\-resolution\-mode\(dq: \(dqcheck\-with\-dhcid\(dq,

                // مقدار در سطح شبکهٔ اشتراکی. توضیحات را در سطح سراسری ببینید.
                \(dqddns\-ttl\-percent\(dq: 0.65,

                // مقدار در سطح شبکهٔ اشتراکی. توضیحات را در سطح سراسری ببینید.
                // نمی‌توان هم‌زمان ddns\-ttl و هر یک از مقادیر ddns\-ttl\-percent، ddns\-ttl\-min یا
                // ddns\-ttl\-max را تعیین کرد. آن‌ها متقابلاً ناسازگار هستند.
                // \(dqddns\-ttl\(dq: 500,

                // مقدار در سطح شبکهٔ اشتراکی. توضیحات را در سطح سراسری ببینید.
                \(dqddns\-ttl\-min\(dq: 10000,

                // مقدار در سطح شبکهٔ اشتراکی. توضیحات را در سطح سراسری ببینید.
                \(dqddns\-ttl\-max\(dq: 20000,

                // مقدار در سطح شبکهٔ اشتراکی. توضیحات را در سطح سراسری ببینید.
                \(dqhostname\-char\-replacement\(dq: \(dqx\(dq,

                // مقدار در سطح شبکهٔ اشتراکی. توضیحات را در سطح سراسری ببینید.
                \(dqhostname\-char\-set\(dq: \(dq[^A\-Za\-z0\-9.\-]\(dq,

                // مشخص می‌کند که این شبکهٔ اشتراکی برای درخواست‌های دریافت‌شده
                // روی یک رابط خاص انتخاب می‌شود.
                \(dqinterface\(dq: \(dqeth0\(dq,

                // محتوای گزینهٔ interface\-id را مشخص می‌کند که توسط رله‌ها
                // برای شناسایی رابطی روی رله که پاسخ به آن ارسال می‌شود،
                // استفاده می‌گردد.
                \(dqinterface\-id\(dq: \(dq\(dq,

                // نام شبکهٔ اشتراکی.
                \(dqname\(dq: \(dqmy\-secret\-network\(dq,

                // فهرست گزینه‌های DHCP ویژهٔ شبکهٔ اشتراکی.
                \(dqoption\-data\(dq: [],

                // طول‌عمر ترجیحی (پیش‌فرض) ویژهٔ شبکهٔ اشتراکی.
                \(dqpreferred\-lifetime\(dq: 2000,

                // حداقل طول‌عمر ترجیحی ویژهٔ شبکهٔ اشتراکی.
                \(dqmin\-preferred\-lifetime\(dq: 1500,

                // حداکثر طول‌عمر ترجیحی ویژهٔ شبکهٔ اشتراکی.
                \(dqmax\-preferred\-lifetime\(dq: 2500,

                // پرچم بولی که مشخص می‌کند آیا سرور می‌تواند به یک پیام Solicit
                // حاوی گزینهٔ Rapid Commit با یک پیام Reply پاسخ دهد یا خیر
                // (DHCPv6 rapid commit را ببینید).
                \(dqrapid\-commit\(dq: false,

                // فهرست نشانی‌های رلهٔ IPv6 که این شبکهٔ
                // اشتراکی برای آن‌ها انتخاب می‌شود.
                \(dqrelay\(dq: {
                    \(dqip\-addresses\(dq: []
                },

                // تایمر rebind در سطح شبکهٔ اشتراکی.
                \(dqrebind\-timer\(dq: 41,

                // تایمر renew در سطح شبکهٔ اشتراکی.
                \(dqrenew\-timer\(dq: 31,

                // محاسبهٔ تایمرهای T1 و T2 در سطح شبکهٔ اشتراکی.
                \(dqcalculate\-tee\-times\(dq: true,

                // T1 = valid lifetime * .5.
                \(dqt1\-percent\(dq: .5,

                // T2 = valid lifetime * .75.
                \(dqt2\-percent\(dq: .75,

                // آستانهٔ حافظهٔ پنهان = valid lifetime * .25.
                \(dqcache\-threshold\(dq: .25,

                // حداکثر حافظهٔ پنهان: هنگامی که زمان آخرین ارسال کلاینت به اندازهٔ
                // کافی نزدیک باشد، اجاره تمدید نمی‌شود و اجارهٔ فعلی به صورت
                // پنهان‌شده (\(dqcached\(dq) برگردانده می‌شود.
                \(dqcache\-max\-age\(dq: 1000,

                // آستانهٔ زمان اجارهٔ تطبیقی (1.0 یعنی غیرفعال).
                \(dqadaptive\-lease\-time\-threshold\(dq: 0.8,

                // مشخص می‌کند که آیا سرور باید رزروهای سراسری را جستجو کند یا خیر.
                \(dqreservations\-global\(dq: false,

                // مشخص می‌کند که آیا سرور باید رزروهای درون‌زیرشبکه‌ای را جستجو کند یا خیر.
                \(dqreservations\-in\-subnet\(dq: true,

                // مشخص می‌کند که آیا سرور می‌تواند فرض کند همهٔ نشانی‌های رزروشده
                // خارج از استخر هستند یا خیر.
                // هنگامی که reservations\-in\-subnet برابر false باشد نادیده گرفته می‌شود.
                // در صورت تعیین، توسط سطوح \(dqsubnet6\(dq به ارث برده می‌شود.
                \(dqreservations\-out\-of\-pool\(dq: false,

                // فهرست کلاس‌های کلاینتی که هنگام انتخاب این شبکهٔ اشتراکی
                // برای تخصیص‌های کلاینت باید ارزیابی شوند.
                \(dqevaluate\-additional\-classes\(dq: [ \(dqlate\(dq ],

                // خاموش کردن ذخیره‌سازی اطلاعات تکمیلی (مانند اطلاعات عامل
                // رله) به همراه هر اجاره برای این شبکهٔ اشتراکی.
                \(dqstore\-extended\-info\(dq: false,

                // فهرست زیرشبکه‌های IPv6 متعلق به این شبکهٔ اشتراکی.
                \(dqsubnet6\(dq: [
                    {
                        // پرچمی برای انتخاب راهبرد تخصیص نشانی IP برای
                        // زیرشبکه.
                        \(dqallocator\(dq: \(dqiterative\(dq,

                        // پرچمی برای انتخاب راهبرد تخصیص پیشوند واگذارشده
                        // برای زیرشبکه.
                        \(dqpd\-allocator\(dq: \(dqiterative\(dq,

                        // این زیرشبکه را محدود می‌کند تا فقط به کلاینت‌هایی اجازه دهد
                        // که دست‌کم به یکی از کلاس‌های این فهرست تعلق دارند. اگر حذف شود
                        // یا یک فهرست خالی ارائه گردد، هیچ محدودیتی اعمال نمی‌شود.
                        \(dqclient\-classes\(dq: [],

                        // مقدار در سطح زیرشبکه. توضیحات را در سطح سراسری ببینید.
                        \(dqddns\-generated\-prefix\(dq: \(dqmyhost\(dq,

                        // مقدار در سطح زیرشبکه. توضیحات را در سطح سراسری ببینید.
                        \(dqddns\-override\-client\-update\(dq: false,

                        // مقدار در سطح زیرشبکه. توضیحات را در سطح سراسری ببینید.
                        \(dqddns\-override\-no\-update\(dq: false,

                        // مقدار در سطح زیرشبکه. توضیحات را در سطح سراسری ببینید.
                        \(dqddns\-qualifying\-suffix\(dq: \(dq\(dq,

                        // مقدار در سطح زیرشبکه. توضیحات را در سطح سراسری ببینید.
                        \(dqddns\-replace\-client\-name\(dq: \(dqnever\(dq,

                        // مقدار در سطح زیرشبکه. توضیحات را در سطح سراسری ببینید.
                        \(dqddns\-send\-updates\(dq: true,

                        // مقدار در سطح زیرشبکه. توضیحات را در سطح سراسری ببینید.
                        \(dqddns\-update\-on\-renew\(dq: true,

                        // مقدار در سطح زیرشبکه. توضیحات را در سطح سراسری ببینید.
                        // این فیلد با ddns\-conflict\-resolution\-mode جایگزین شده است.
                        // تجزیهٔ آن صرفاً برای سازگاری عقبرو حفظ شده است.
                        // \(dqddns\-use\-conflict\-resolution\(dq: true,

                        // مقدار در سطح زیرشبکه. توضیحات را در سطح سراسری ببینید.
                        \(dqddns\-conflict\-resolution\-mode\(dq: \(dqcheck\-with\-dhcid\(dq,

                        // مقدار در سطح زیرشبکه. توضیحات را در سطح سراسری ببینید.
                        // \(dqddns\-ttl\-percent\(dq: 0.55,

                        // \(dqddns\-ttl\(dq: 0,
                        // نمی‌توان هم‌زمان ddns\-ttl و هر یک از مقادیر ddns\-ttl\-percent، ddns\-ttl\-min یا
                        // ddns\-ttl\-max را تعیین کرد. آن‌ها متقابلاً ناسازگار هستند.
                        \(dqddns\-ttl\(dq: 500,

                        // مقدار در سطح زیرشبکه. توضیحات را در سطح سراسری ببینید.
                        // \(dqddns\-ttl\-min\(dq: 10000,

                        // مقدار در سطح زیرشبکه. توضیحات را در سطح سراسری ببینید.
                        // \(dqddns\-ttl\-max\(dq: 20000,

                        // مقدار در سطح زیرشبکه. توضیحات را در سطح سراسری ببینید.
                        \(dqhostname\-char\-replacement\(dq: \(dqx\(dq,

                        // مقدار در سطح زیرشبکه. توضیحات را در سطح سراسری ببینید.
                        \(dqhostname\-char\-set\(dq: \(dq[^A\-Za\-z0\-9.\-]\(dq,

                        // شناسهٔ یکتای زیرشبکه.
                        \(dqid\(dq: 1,

                        // مشخص می‌کند که این زیرشبکه برای درخواست‌های دریافت‌شده
                        // روی یک رابط خاص انتخاب می‌شود.
                        \(dqinterface\(dq: \(dqeth0\(dq,

                        // محتوای گزینهٔ interface\-id را مشخص می‌کند که توسط رله‌ها
                        // برای شناسایی رابطی روی رله که پاسخ به آن ارسال می‌شود،
                        // استفاده می‌گردد.
                        \(dqinterface\-id\(dq: \(dq\(dq,

                        // روشن کردن ذخیره‌سازی اطلاعات تکمیلی (مانند اطلاعات عامل
                        // رله) به همراه هر اجاره برای این زیرشبکه.
                        \(dqstore\-extended\-info\(dq: true,

                        // فهرست گزینه‌های DHCP در سطح زیرشبکه.
                        \(dqoption\-data\(dq: [
                            {
                                // پرچم بولی که مشخص می‌کند آیا گزینهٔ خاص باید همیشه
                                // ارسال شود یا تنها در صورت درخواست.
                                \(dqalways\-send\(dq: false,

                                // فهرستی اختیاری از کلاس‌هایی که این گزینه برای آن‌ها اعمال می‌شود.
                                // اگر کلاینت با هر یک از کلاس‌های موجود در این فهرست مطابقت داشته باشد،
                                // گزینه اعمال خواهد شد. اگر فهرست خالی باشد یا حذف شود،
                                // این گزینه فارغ از عضویت در کلاس اعمال خواهد شد.
                                \(dqclient\-classes\(dq: [],

                                // کد گزینه.
                                \(dqcode\(dq: 7,

                                // پرچم بولی که مشخص می‌کند آیا مقدار گزینهٔ مشخص‌شده
                                // در \(dqdata\(dq رشته‌ای از مقادیر هگزادسیمال است یا مقدار
                                // CSV خوانا برای انسان.
                                \(dqcsv\-format\(dq: false,

                                // داده‌های گزینه برای قرار گرفتن در بدنهٔ گزینه.
                                \(dqdata\(dq: \(dq0xf0\(dq,

                                // نام گزینه.
                                \(dqname\(dq: \(dqpreference\(dq,

                                // پرچم بولی که مشخص می‌کند آیا گزینهٔ داده‌شده هرگز
                                // در پاسخ ارسال نشود یا خیر.
                                \(dqnever\-send\(dq: false,

                                // فضای گزینه. مقدار پیش‌فرض \(dqdhcp6\(dq نشان‌دهندهٔ
                                // فضای گزینهٔ سطح بالا است.
                                \(dqspace\(dq: \(dqdhcp6\(dq
                            }
                        ],

                        // فهرست استخرهایی که پیشوندهای واگذارشده از آن‌ها به
                        // کلاینت‌ها تخصیص داده می‌شود.
                        \(dqpd\-pools\(dq: [
                            {
                                // این استخر پیشوند زیرشبکه را محدود می‌کند تا تنها به کلاینت‌هایی
                                // اجازه دهد که دست‌کم به یکی از کلاس‌های این فهرست تعلق دارند. اگر حذف شود
                                // یا یک فهرست خالی ارائه گردد، هیچ محدودیتی اعمال نمی‌شود.
                                \(dqclient\-classes\(dq: [ \(dqphones_server1\(dq ],

                                // طول پیشوندهای واگذارشده به کلاینت‌ها.
                                \(dqdelegated\-len\(dq: 64,

                                // پیشوند (نشانی) مستثنی‌شده از تخصیص‌های کلاینت.
                                \(dqexcluded\-prefix\(dq: \(dq2001:db8:1::\(dq,

                                // پیشوند (طول) مستثنی‌شده از تخصیص‌های کلاینت.
                                \(dqexcluded\-prefix\-len\(dq: 72,

                                // فهرست گزینه‌های DHCP در سطح استخر پیشوند.
                                \(dqoption\-data\(dq: [],

                                // محدودهٔ پیشوند (نشانی) مورد استفاده برای تخصیص‌های کلاینت.
                                \(dqprefix\(dq: \(dq2001:db8:1::\(dq,

                                // محدودهٔ پیشوند (طول) مورد استفاده برای تخصیص‌های کلاینت.
                                \(dqprefix\-len\(dq: 48,

                                // فهرست کلاس‌های کلاینتی که هنگام انتخاب این استخر
                                // پیشوند برای تخصیص‌های کلاینت باید ارزیابی شوند.
                                \(dqevaluate\-additional\-classes\(dq: [],

                                // شناسهٔ PD\-pool مورد استفاده برای فعال‌سازی آمارها برای این pd\-pool.
                                // شناسهٔ pd\-pool نیازی نیست درون زیرشبکه یا در میان زیرشبکه‌ها یکتا باشد.
                                // در صورت پیکربندی نشدن، پیش‌فرض آن 0 است. آمارهای
                                // مربوط به این pd\-pool با سایر آمارهای همهٔ pd\-poolهای دیگر با همان
                                // شناسه در این زیرشبکه ترکیب خواهد شد.
                                \(dqpool\-id\(dq: 1
                            },
                            {
                                // طول پیشوندهای واگذارشده به کلاینت‌ها.
                                \(dqdelegated\-len\(dq: 64,

                                // محدودهٔ پیشوند (نشانی) مورد استفاده برای تخصیص‌های کلاینت.
                                \(dqprefix\(dq: \(dq2001:db8:2::\(dq,

                                // محدودهٔ پیشوند (طول) مورد استفاده برای تخصیص‌های کلاینت.
                                \(dqprefix\-len\(dq: 48
                            }
                        ],

                        // فهرست استخرهای نشانی IP متعلق به زیرشبکه.
                        \(dqpools\(dq: [
                            {
                                // این استخر زیرشبکه را محدود می‌کند تا فقط به کلاینت‌هایی
                                // اجازه دهد که دست‌کم به یکی از کلاس‌های این فهرست تعلق دارند. اگر حذف شود
                                // یا یک فهرست خالی ارائه گردد، هیچ محدودیتی اعمال نمی‌شود.
                                \(dqclient\-classes\(dq: [ \(dqphones_server1\(dq ],

                                // فهرست گزینه‌های DHCP در سطح استخر.
                                \(dqoption\-data\(dq: [],

                                // محدودهٔ نشانی مورد استفاده برای تخصیص‌های کلاینت.
                                \(dqpool\(dq: \(dq2001:db8:0:1::/64\(dq,

                                // فهرست کلاس‌های کلاینتی که هنگام انتخاب این استخر برای تخصیص‌های
                                // کلاینت باید ارزیابی شوند.
                                \(dqevaluate\-additional\-classes\(dq: [ \(dqlate\(dq ],

                                // مقدار در سطح استخر. توضیحات را در سطح سراسری ببینید.
                                \(dqddns\-generated\-prefix\(dq: \(dqmypool\(dq,

                                // مقدار در سطح استخر. توضیحات را در سطح سراسری ببینید.
                                \(dqddns\-override\-client\-update\(dq: false,

                                // مقدار در سطح استخر. توضیحات را در سطح سراسری ببینید.
                                \(dqddns\-override\-no\-update\(dq: false,

                                // مقدار در سطح استخر. توضیحات را در سطح سراسری ببینید.
                                \(dqddns\-qualifying\-suffix\(dq: \(dqpool.example.com.\(dq,

                                // مقدار در سطح استخر. توضیحات را در سطح سراسری ببینید.
                                \(dqddns\-replace\-client\-name\(dq: \(dqalways\(dq,

                                // مقدار در سطح استخر. توضیحات را در سطح سراسری ببینید.
                                \(dqddns\-send\-updates\(dq: true,

                                // مقدار در سطح استخر. توضیحات را در سطح سراسری ببینید.
                                \(dqddns\-update\-on\-renew\(dq: false,

                                // مقدار در سطح استخر. توضیحات را در سطح سراسری ببینید.
                                \(dqddns\-conflict\-resolution\-mode\(dq: \(dqcheck\-with\-dhcid\(dq,

                                // مقدار در سطح استخر. توضیحات را در سطح سراسری ببینید.
                                \(dqddns\-ttl\-percent\(dq: 0.55,

                                // مقدار در سطح استخر. توضیحات را در سطح سراسری ببینید.
                                // نمی‌توانید هم‌زمان ddns\-ttl و هر یک از مقادیر ddns\-ttl\-percent،
                                // ddns\-ttl\-min یا ddns\-ttl\-max را تعیین کنید. آن‌ها متقابلاً ناسازگار هستند.
                                // \(dqddns\-ttl\(dq: 500,

                                // مقدار در سطح استخر. توضیحات را در سطح سراسری ببینید.
                                \(dqddns\-ttl\-min\(dq: 10000,

                                // مقدار در سطح استخر. توضیحات را در سطح سراسری ببینید.
                                \(dqddns\-ttl\-max\(dq: 20000,

                                // مقدار در سطح استخر. توضیحات را در سطح سراسری ببینید.
                                \(dqhostname\-char\-replacement\(dq: \(dqx\(dq,

                                // مقدار در سطح استخر. توضیحات را در سطح سراسری ببینید.
                                \(dqhostname\-char\-set\(dq: \(dq[^A\-Za\-z0\-9.\-]\(dq
                            },
                            {
                                // این استخر زیرشبکه را محدود می‌کند تا فقط به کلاینت‌هایی
                                // اجازه دهد که دست‌کم به یکی از کلاس‌های این فهرست تعلق دارند. اگر حذف شود
                                // یا یک فهرست خالی ارائه گردد، هیچ محدودیتی اعمال نمی‌شود.
                                \(dqclient\-classes\(dq: [ \(dqphones_server2\(dq ],

                                // فهرست گزینه‌های DHCP در سطح استخر.
                                \(dqoption\-data\(dq: [],

                                // محدودهٔ نشانی مورد استفاده برای تخصیص‌های کلاینت.
                                \(dqpool\(dq: \(dq2001:db8:0:3::/64\(dq,

                                // فهرست کلاس‌های کلاینتی که هنگام انتخاب این استخر برای تخصیص‌های
                                // کلاینت باید ارزیابی شوند.
                                \(dqevaluate\-additional\-classes\(dq: [],

                                // شناسهٔ استخر برای فعال‌سازی آمارها برای این استخر.
                                // شناسهٔ استخر نیازی نیست درون زیرشبکه یا در میان زیرشبکه‌ها یکتا باشد.
                                // در صورت پیکربندی نشدن، پیش‌فرض آن 0 است. آمارهای
                                // مربوط به این استخر با سایر آمارهای همهٔ استخرهای دیگر با همان
                                // شناسه در این زیرشبکه ترکیب خواهد شد.
                                \(dqpool\-id\(dq: 1
                            }
                        ],

                        // طول‌عمر ترجیحی (پیش‌فرض) ویژهٔ زیرشبکه.
                        \(dqpreferred\-lifetime\(dq: 2000,

                        // حداقل طول‌عمر ترجیحی ویژهٔ زیرشبکه.
                        \(dqmin\-preferred\-lifetime\(dq: 1500,

                        // حداکثر طول‌عمر ترجیحی ویژهٔ زیرشبکه.
                        \(dqmax\-preferred\-lifetime\(dq: 2500,

                        // پرچم بولی که مشخص می‌کند آیا سرور می‌تواند به یک پیام Solicit
                        // حاوی گزینهٔ Rapid Commit با یک پیام Reply پاسخ دهد یا خیر
                        // (DHCPv6 rapid commit را ببینید).
                        \(dqrapid\-commit\(dq: false,

                        // مقدار تایمر rebind در سطح زیرشبکه.
                        \(dqrebind\-timer\(dq: 40,

                        // فهرست نشانی‌های رلهٔ IPv6 که این زیرشبکه برای آن‌ها انتخاب می‌شود.
                        \(dqrelay\(dq: {
                            \(dqip\-addresses\(dq: [
                                \(dq2001:db8:0:f::1\(dq
                            ]
                        },

                        // تایمر renew در سطح زیرشبکه.
                        \(dqrenew\-timer\(dq: 30,

                        // مشخص می‌کند که آیا سرور باید رزروهای سراسری را جستجو کند یا خیر.
                        \(dqreservations\-global\(dq: false,

                        // مشخص می‌کند که آیا سرور باید رزروهای درون‌زیرشبکه‌ای را جستجو کند یا خیر.
                        \(dqreservations\-in\-subnet\(dq: true,

                        // مشخص می‌کند که آیا سرور می‌تواند فرض کند تمام نشانی‌های
                        // رزروشده خارج از استخر هستند یا خیر.
                        // هنگامی که reservations\-in\-subnet برابر false باشد نادیده گرفته می‌شود.
                        \(dqreservations\-out\-of\-pool\(dq: false,

                        // محاسبهٔ تایمرهای T1 و T2 در سطح زیرشبکه.
                        \(dqcalculate\-tee\-times\(dq: true,

                        // T1 = valid lifetime * .5.
                        \(dqt1\-percent\(dq: .5,

                        // T2 = valid lifetime * .75.
                        \(dqt2\-percent\(dq: .75,

                        // آستانهٔ حافظهٔ پنهان = valid lifetime * .25.
                        \(dqcache\-threshold\(dq: .25,

                        // حداکثر حافظهٔ پنهان در سطح زیرشبکه.
                        \(dqcache\-max\-age\(dq: 1000,

                        // آستانهٔ زمان اجارهٔ تطبیقی (1.0 یعنی غیرفعال).
                        \(dqadaptive\-lease\-time\-threshold\(dq: 0.8,

                        // فهرست رزروهای ایستای IPv6 اختصاص‌یافته به کلاینت‌های متعلق
                        // به این زیرشبکه. برای یک مثال تفصیلی، reservations.json را ببینید.
                        \(dqreservations\(dq: [
                            {
                                // شناسهٔ مورد استفاده برای تطبیق کلاینت. مقادیر پشتیبانی‌شده عبارتند از
                                // \(dqduid\(dq، \(dqhw\-address\(dq و \(dqflex\-id\(dq.
                                \(dqduid\(dq: \(dq01:02:03:04:05:06:07:08:09:0A\(dq,

                                // فهرست نشانی‌های IPv6 رزروشده.
                                \(dqip\-addresses\(dq: [ \(dq2001:db8:1:cafe::1\(dq ],

                                // فهرست پیشوندهای IPv6 رزروشده.
                                \(dqprefixes\(dq: [ \(dq2001:db8:2:abcd::/64\(dq ],

                                // فهرست پیشوندهای IPv6 مستثنی‌شده.
                                \(dqexcluded\-prefixes\(dq: [ \(dq2001:db8:2:abcd:1::/80\(dq ],

                                // نام میزبان رزروشده.
                                \(dqhostname\(dq: \(dqfoo.example.com\(dq,

                                // داده‌های گزینهٔ ویژهٔ رزرو.
                                \(dqoption\-data\(dq: [
                                    {
                                        // نام گزینه.
                                        \(dqname\(dq: \(dqvendor\-opts\(dq,

                                        // مقدار گزینه.
                                        \(dqdata\(dq: \(dq4491\(dq
                                    }
                                ]
                            }
                        ],

                        // فهرست کلاس‌های کلاینتی که هنگام انتخاب این زیرشبکه
                        // برای تخصیص‌های کلاینت باید ارزیابی شوند.
                        \(dqevaluate\-additional\-classes\(dq: [ \(dqlate\(dq ],

                        // پیشوند زیرشبکه.
                        \(dqsubnet\(dq: \(dq2001:db8::/32\(dq,

                        // طول‌عمر معتبر (پیش‌فرض) در سطح زیرشبکه.
                        \(dqvalid\-lifetime\(dq: 6000,

                        // حداقل طول‌عمر معتبر در سطح زیرشبکه.
                        \(dqmin\-valid\-lifetime\(dq: 4000,

                        // حداکثر طول‌عمر معتبر در سطح زیرشبکه.
                        \(dqmax\-valid\-lifetime\(dq: 8000
                    }
                ],

                // طول‌عمر معتبر (پیش‌فرض) در سطح شبکهٔ اشتراکی.
                \(dqvalid\-lifetime\(dq: 6001,

                // حداقل طول‌عمر معتبر در سطح شبکهٔ اشتراکی.
                \(dqmin\-valid\-lifetime\(dq: 4001,

                // حداکثر طول‌عمر معتبر در سطح شبکهٔ اشتراکی.
                \(dqmax\-valid\-lifetime\(dq: 8001
            }
        ],

        // فهرست زیرشبکه‌های IPv6 که به هیچ شبکهٔ اشتراکی تعلق ندارند.
        \(dqsubnet6\(dq: [],

        // مقدار سراسری طول‌عمر معتبر.
        \(dqvalid\-lifetime\(dq: 6000,

        // حداقل مقدار سراسری طول‌عمر معتبر.
        \(dqmin\-valid\-lifetime\(dq: 4000,

        // حداکثر مقدار سراسری طول‌عمر معتبر.
        \(dqmax\-valid\-lifetime\(dq: 8000,

        // رزروها (مثال‌ها در فایل‌های دیگر موجود است).
        \(dqreservations\(dq: [],

        // کنترل پیکربندی (در حال حاضر استفاده نمی‌شود، یعنی این نحو
        // از پیش تعریف شده اما قابلیت مربوط به آن پیاده‌سازی نشده است).
        \(dqconfig\-control\(dq: {
            // فقط مدخل پایگاه‌های دادهٔ پیکربندی تعریف شده است.
            \(dqconfig\-databases\(dq: [
                {
                    // نام پایگاه‌داده برای اتصال.
                    \(dqname\(dq: \(dqconfig\(dq,

                    // نوع پایگاه‌داده، مثلاً \(dqmysql\(dq، \(dqpostgresql\(dq.
                    \(dqtype\(dq: \(dqmysql\(dq
                }
            ],
            // بازهٔ زمانی بین تلاش‌ها برای واکشی به‌روزرسانی‌های پیکربندی
            // از طریق پسانه‌های پیکربندی مورد استفاده.
            \(dqconfig\-fetch\-wait\-time\(dq: 30
        },

        // برچسب سرور.
        \(dqserver\-tag\(dq: \(dqmy DHCPv6 server\(dq,

        // پارامترهای کنترل صف DHCP.
        \(dqdhcp\-queue\-control\(dq: {
            // فعال‌سازی صف اجباری است.
            \(dqenable\-queue\(dq: true,

            // نوع صف اجباری است.
            \(dqqueue\-type\(dq: \(dqkea\-ring6\(dq,

            // ظرفیت اختیاری است.
            \(dqcapacity\(dq: 64
        },

        // مشخص می‌کند که آیا سرور باید رزروهای سراسری را جستجو کند یا خیر.
        \(dqreservations\-global\(dq: false,

        // مشخص می‌کند که آیا سرور باید رزروهای درون‌زیرشبکه‌ای را جستجو کند یا خیر.
        \(dqreservations\-in\-subnet\(dq: true,

        // مشخص می‌کند که آیا سرور می‌تواند فرض کند همهٔ نشانی‌های رزروشده
        // خارج از استخر هستند یا خیر.
        // هنگامی که reservations\-in\-subnet برابر false باشد نادیده گرفته می‌شود.
        // در صورت تعیین، توسط سطوح \(dqshared\-networks\(dq و
        // \(dqsubnet6\(dq به ارث برده می‌شود.
        \(dqreservations\-out\-of\-pool\(dq: false,

        // محاسبهٔ سراسری تایمرهای T1 و T2.
        \(dqcalculate\-tee\-times\(dq: true,

        // T1 = valid lifetime * .5.
        \(dqt1\-percent\(dq: .5,

        // T2 = valid lifetime * .75.
        \(dqt2\-percent\(dq: .75,

        // آستانهٔ حافظهٔ پنهان = valid lifetime * .25.
        \(dqcache\-threshold\(dq: .25,

        // حداکثر حافظهٔ پنهان سراسری.
        \(dqcache\-max\-age\(dq: 1000,

        // آستانهٔ زمان اجارهٔ تطبیقی (1.0 یعنی غیرفعال)
        \(dqadaptive\-lease\-time\-threshold\(dq: 0.8,

        // رشته‌ای از صفر یا چند نویسه که با هر نویسهٔ نامعتبر در
        // Client FQDN جایگزین می‌شود. مقدار پیش‌فرض یک رشتهٔ خالی
        // است که باعث می‌شود نویسه‌های نامعتبر به جای جایگزینی، حذف شوند.
        \(dqhostname\-char\-replacement\(dq: \(dqx\(dq,

        // عبارت باقاعده توصیف‌کنندهٔ مجموعه نویسه‌های نامعتبر در
        // Client FQDN.
        \(dqhostname\-char\-set\(dq: \(dq[^A\-Za\-z0\-9.\-]\(dq,

        // فهرست ثبت‌کننده‌های وقایع مورد استفاده توسط سرورهایی که از این فایل پیکربندی استفاده می‌کنند.
        \(dqloggers\(dq: [
            {
                // سطح اشکال‌زدایی، مقداری بین 0..99. هر چه مقدار بزرگ‌تر باشد،
                // گزارش اشکال‌زدایی دقیق‌تر خواهد بود.
                \(dqdebuglevel\(dq: 99,

                // نام ثبت‌کنندهٔ وقایع.
                \(dqname\(dq: \(dqkea\-dhcp6\(dq,

                // نحوهٔ ارسال گزارش وقایع به خروجی را پیکربندی می‌کند.
                \(dqoutput\-options\(dq: [
                    {
                        // مشخص می‌کند که آیا گزارش وقایع باید فوراً روی فایل تخلیه شود یا خیر.
                        \(dqflush\(dq: true,

                        // حداکثر اندازهٔ فایل را قبل از چرخش فایل مشخص می‌کند.
                        \(dqmaxsize\(dq: 10240000,

                        // حداکثر تعداد فایل‌های چرخش‌یافته برای نگه‌داری را مشخص می‌کند.
                        \(dqmaxver\(dq: 1,

                        // مقصد ثبت وقایع را مشخص می‌کند.
                        \(dqoutput\(dq: \(dqstdout\(dq,

                        // محتوای مدخل گزارش وقایع را مشخص می‌کند.
                        \(dqpattern\(dq: \(dq%D{%Y\-%m\-%d %H:%M:%S.%q} %\-5p [%c/%i] %m\en\(dq
                    }
                ],

                // سطح حساسیت ثبت وقایع را مشخص می‌کند، یعنی \(dqERROR\(dq، \(dqWARN\(dq، \(dqINFO\(dq، \(dqDEBUG\(dq.
                \(dqseverity\(dq: \(dqINFO\(dq
            }
        ],

        // برای کاربرد user\-contexts به مثال‌های پیشرفته نگاه کنید.
        \(dquser\-context\(dq: { }
    }
}
.EE
.UNINDENT
.UNINDENT.SS kea6/all\-options.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این فایل پیکربندی نمونه برای کارگزار DHCPv6 در Kea شامل موارد زیر است:
//
// \- داده‌ها برای تمام گزینه‌های استاندارد
// \- تعاریف گزینه‌های سفارشی در سطح سراسری همراه با برخی داده‌های گزینه مرتبط
// \- داده‌های گزینه سفارشی با فضاهای گزینه استانداردشده به جز \(dqdhcp6\(dq
// \- فضاهای گزینه سفارشی
// \- مثال‌های جاسازی گزینه
// \- داده‌های گزینه DOCSIS3
//
// اکیداً به خواننده توصیه می‌شود به ساختارهای گزینه مستندشده در Kea ARM نگاهی بیندازد:
// https://kea.readthedocs.io/en/latest/arm/dhcp6\-srv.html?highlight=option%20definitions#dhcp6\-std\-options\-list
//
// گزینه‌های دیگر نیازمند منطق خاصی هستند که هنوز پیاده‌سازی نشده است. آنها با
// این عبارت مشخص شده‌اند:
// \(dqNote: special logic not implemented\(dq

{
  \(dqDhcp6\(dq: {
    /*
                      داده‌ها برای تمام تعاریف گزینه استاندارد
    */
    // داده‌های گزینه تعریف‌شده به صورت سراسری
    \(dqoption\-data\(dq: [
      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |       OPTION_PREFERENCE       |          option\-len           |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |  pref\-value   |
      +\-+\-+\-+\-+\-+\-+\-+\-+

      option\-code   OPTION_PREFERENCE (7).

      option\-len    1.

      pref\-value    مقدار preference برای کارگزار در این پیام.
      */
      // نوع: uint8
      {
        \(dqcode\(dq: 7,
        \(dqdata\(dq: \(dq0xf0\(dq,
        \(dqname\(dq: \(dqpreference\(dq
      },

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |          OPTION_UNICAST       |        option\-len             |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                                                               |
      |                       server\-address                          |
      |                                                               |
      |                                                               |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      option\-code     OPTION_UNICAST (12).

      option\-len      16.

      server\-address  نشانی IP که کلاینت باید پیام‌های ارسالی با
                      unicast را به آن ارسال کند.

      ***نکته***: این گزینه توسط RFC9915 منسوخ شده است.
      */
      // نوع: IPv6 address
      {
        \(dqcode\(dq: 12,
        \(dqdata\(dq: \(dq2001:db8::2\(dq,
        \(dqname\(dq: \(dqunicast\(dq
      },

      /*
      0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |      OPTION_VENDOR_OPTS       |           option\-len          |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                       enterprise\-number                       |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      .                                                               .
      .                          option\-data                          .
      .                                                               .
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      option\-code          OPTION_VENDOR_OPTS (17)

      option\-len           ۴ + طول فیلد option\-data

      enterprise\-number    شماره ثبت‌شده سازنده (Enterprise Number) به گونه‌ای که
                           در IANA [6] ثبت شده است.

      option\-data          یک شیء مات (opaque) به طول option\-len بایت،
                           تفسیرشده توسط کد مختص سازنده در کلاینت‌ها
                           و کارگزارها
      */
      // نوع: uint32
      // گزینه‌های سازنده استاندارد نیستند و مختص هر سازنده‌اند.
      // سازندگان با enterprise number شناسایی می‌شوند که گاهی vendor\-id
      // یا enterprise\-id نیز نامیده می‌شود. برای مثال، CableLabs که گزینه‌های
      // DOCSIS را مشخص کرده از 4491 استفاده می‌کند. برخی سازندگان سازوکارهای
      // خود را دارند. مثلاً زیرگزینه ۱ سازنده DOCSIS معادل ORO برای گزینه‌های
      // عادی DHCPv6 است. معمولاً چندین زیرگزینه سازنده در آن تعریف می‌شود.
      // بخش ARM را ببینید:
      // https://kea.readthedocs.io/en/latest/arm/dhcp6\-srv.html#dhcpv6\-vendor\-specific\-options

      {
        \(dqcode\(dq: 17,
        \(dqdata\(dq: \(dq4294967295\(dq,
        \(dqname\(dq: \(dqvendor\-opts\(dq
      },

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |     OPTION_RECONF_ACCEPT      |               0               |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      option\-code   OPTION_RECONF_ACCEPT (20).

      option\-len    0.
      */
      // نوع: empty
      {
        \(dqcode\(dq: 20,
        \(dqname\(dq: \(dqreconf\-accept\(dq
      },

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |      OPTION_SIP_SERVER_D      |         option\-length         |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                 SIP Server Domain Name List                   |
      |                              ...                              |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      SIP Server Domain Name List: نام‌های دامنه کارگزارهای پراکسی خروجی SIP
      برای استفاده کلاینت. نام‌های دامنه همان‌طور که در بخش ۸
      (\(dqRepresentation and use of domain names\(dq) از مشخصات DHCPv6 [1]
      تعیین شده، کدگذاری می‌شوند.
      */
      // نوع: array of {FQDN}
      {
        \(dqcode\(dq: 21,
        \(dqdata\(dq: \(dqsip1.server.net, sip2.server.net\(dq,
        \(dqname\(dq: \(dqsip\-server\-dns\(dq
      },

      /*
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |      OPTION_SIP_SERVER_A      |           option\-len          |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                                                               |
      |                   SIP server (IP address)                     |
      |                                                               |
      |                                                               |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                                                               |
      |                   SIP server (IP address)                     |
      |                                                               |
      |                                                               |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                              ...                              |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      option\-code: OPTION_SIP_SERVER_A (22)

      option\-length: طول فیلد \(aqoptions\(aq به بایت؛ باید مضربی از ۱۶ باشد.

      SIP server: نشانی IPv6 یک کارگزار SIP برای استفاده کلاینت.
                  کارگزارها به ترتیب اولویت برای استفاده کلاینت فهرست
                  شده‌اند.
      */
      // نوع: array of {IPv6 address}
      {
        \(dqcode\(dq: 22,
        \(dqdata\(dq: \(dq2001:db8::3, 2001:db8::4\(dq,
        \(dqname\(dq: \(dqsip\-server\-addr\(dq
      },

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |      OPTION_DNS_SERVERS       |         option\-len            |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                                                               |
      |            DNS\-recursive\-name\-server (IPv6 address)           |
      |                                                               |
      |                                                               |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                                                               |
      |            DNS\-recursive\-name\-server (IPv6 address)           |
      |                                                               |
      |                                                               |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                              ...                              |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      option\-code:               OPTION_DNS_SERVERS (23)

      option\-len:                طول فهرست کارگزارهای نام بازگشتی DNS به بایت؛
                                 باید مضربی از ۱۶ باشد

      DNS\-recursive\-name\-server: نشانی IPv6 کارگزار نام بازگشتی DNS
      */
      // نوع: array of {IPv6 address}
      {
        \(dqcode\(dq: 23,
        \(dqdata\(dq: \(dq2001:db8::5, 2001:db8::6\(dq,
        \(dqname\(dq: \(dqdns\-servers\(dq
      },


      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |      OPTION_DOMAIN_LIST       |         option\-len            |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                          searchlist                           |
      |                              ...                              |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      option\-code:  OPTION_DOMAIN_LIST (24)

      option\-len:   طول فیلد \(aqsearchlist\(aq به بایت

      searchlist:   مشخصات فهرست نام‌های دامنه در Domain Search List
      */
      // نوع: array of {FQDN}
      {
        \(dqcode\(dq: 24,
        \(dqdata\(dq: \(dqexample.com, example.org\(dq,
        \(dqname\(dq: \(dqdomain\-search\(dq
      },

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |      OPTION_NIS_SERVERS       |         option\-len            |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                                                               |
      |                   NIS server (IPv6 address)                   |
      |                                                               |
      |                                                               |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                                                               |
      |                   NIS server (IPv6 address)                   |
      |                                                               |
      |                                                               |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                              ...                              |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      option\-code:  OPTION_NIS_SERVERS (27)

      option\-len:   طول فیلدهای \(aqNIS server\(aq به بایت؛ باید مضربی
                    از ۱۶ باشد

      NIS server:   نشانی IPv6 کارگزار NIS
      */
      // نوع: array of {IPv6 address}
      {
        \(dqcode\(dq: 27,
        \(dqdata\(dq: \(dq2001:db8::7, 2001:db8::8\(dq,
        \(dqname\(dq: \(dqnis\-servers\(dq
      },

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |      OPTION_NISP_SERVERS      |         option\-len            |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                                                               |
      |                   NIS+ server (IPv6 address)                  |
      |                                                               |
      |                                                               |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                                                               |
      |                   NIS+ server (IPv6 address)                  |
      |                                                               |
      |                                                               |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                              ...                              |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      option\-code: OPTION_NISP_SERVERS (28)

      option\-len:  طول فیلدهای \(aqNIS+ server\(aq به بایت؛ باید مضربی
                   از ۱۶ باشد

      NIS+ server: نشانی IPv6 کارگزار NIS+
      */
      // نوع: array of {IPv6 address}
      {
        \(dqcode\(dq: 28,
        \(dqdata\(dq: \(dq2001:db8::9, 2001:db8::10\(dq,
        \(dqname\(dq: \(dqnisp\-servers\(dq
      },

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |    OPTION_NIS_DOMAIN_NAME     |         option\-len            |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                       nis\-domain\-name                         |
      |                              ...                              |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      option\-code:      OPTION_NIS_DOMAIN_NAME (29)

      option\-len:       طول فیلد \(aqnis\-domain\-name\(aq به بایت

      nis\-domain\-name:  نام دامنه NIS برای کلاینت
      */
      // نوع: array of {FQDN}
      {
        \(dqcode\(dq: 29,
        \(dqdata\(dq: \(dqnis1.example.org, nis2.example.org\(dq,
        \(dqname\(dq: \(dqnis\-domain\-name\(dq
      },

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |    OPTION_NISP_DOMAIN_NAME    |         option\-len            |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                       nisp\-domain\-name                        |
      |                              ...                              |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      option\-code:      OPTION_NISP_DOMAIN_NAME (30)

      option\-len:       طول فیلد \(aqnisp\-domain\-name\(aq به بایت

      nisp\-domain\-name: نام دامنه NIS+ برای کلاینت
      */
      // نوع: array of {FQDN}
      {
        \(dqcode\(dq: 30,
        \(dqdata\(dq: \(dqnisp1.example.org, nisp2.example.org\(dq,
        \(dqname\(dq: \(dqnisp\-domain\-name\(dq
      },

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |      OPTION_SNTP_SERVERS       |        option\-len            |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                                                               |
      |                  SNTP server (IPv6 address)                   |
      |                                                               |
      |                                                               |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                                                               |
      |                  SNTP server (IPv6 address)                   |
      |                                                               |
      |                                                               |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                              ...                              |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      option\-code: OPTION_SNTP_SERVERS (31)

      option\-len:  طول فیلدهای \(aqSNTP server\(aq به بایت؛ باید
                   مضربی از ۱۶ باشد

      SNTP server: نشانی IPv6 کارگزار SNTP
      */
      // نوع: array of {IPv6 address}
      {
        \(dqcode\(dq: 31,
        \(dqdata\(dq: \(dq2001:db8::11, 2001:db8::12\(dq,
        \(dqname\(dq: \(dqsntp\-servers\(dq
      },

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |OPTION_INFORMATION_REFRESH_TIME|         option\-len            |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                   information\-refresh\-time                    |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      option\-code                OPTION_INFORMATION_REFRESH_TIME (32).

      option\-len                 4.

      information\-refresh\-time   مدت زمان نسبت به زمان جاری، بیان‌شده بر
                                 حسب ثانیه. یک فیلد ۴ بایتی شامل یک عدد صحیح
                                 بدون علامت.
      */
      // نوع: uint32
      {
        \(dqcode\(dq: 32,
        \(dqdata\(dq: \(dq3600\(dq,
        \(dqname\(dq: \(dqinformation\-refresh\-time\(dq
      },

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |      OPTION_BCMCS_SERVER_D    |         option\-length         |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |          BCMCS Control Server Domain Name List                |
      |                              ...                              |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      option\-code: OPTION_BCMCS_SERVER_D (33).

      option\-length: طول فیلد \(aqBCMCS Control Server Domain Name List\(aq
      به بایت؛ متغیر.

      BCMCS Control Server Domain Name List: قالب یکسان با بخش ۴.۱
      (به جز فیلدهای Code و Len).
      */
      // نوع: array of {FQDN}
      {
        \(dqcode\(dq: 33,
        \(dqdata\(dq: \(dqbcmcs1.example.org, bcmcs2.example.org\(dq,
        \(dqname\(dq: \(dqbcmcs\-server\-dns\(dq
      },

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |      OPTION_BCMCS_SERVER_A    |         option\-length         |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                                                               |
      |    BCMCS Control server\-1 address (IPv6 address)              |
      |                                                               |
      |                                                               |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                                                               |
      |    BCMCS Control server\-2 address (IPv6 address)              |
      |                                                               |
      |                                                               |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                              ...                              |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      option\-code: OPTION_BCMCS_SERVER_A (34).

      option\-length: طول فیلد \(aqBCMCS Control Server IPv6 address\(aq
      به بایت؛ متغیر.
      */
      // نوع: array of {IPv6 address}
      {
        \(dqcode\(dq: 34,
        \(dqdata\(dq: \(dq2001:db8::13, 2001:db8::14\(dq,
        \(dqname\(dq: \(dqbcmcs\-server\-addr\(dq
      },

      // کد گزینه ۳۵ تخصیص داده نشده است.

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |      OPTION_GEOCONF_CIVIC     |           option\-len          |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |      what     |        country code           |               .
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+               .
      .                     civic address elements                    .
      .                              ...                              .
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      option\-code:  OPTION_GEOCONF_CIVIC (36)

      option\-len:  طول Countrycode، عنصر \(aqwhat\(aq و عناصر civic address به بایت.

      what:  عنصر \(aqwhat\(aq توصیف می‌کند که مدخل DHCP به کدام مکان اشاره
         دارد. در حال حاضر، سه گزینه تعریف شده است: مکان کارگزار DHCP
         (مقدار ۰)، مکان عنصر شبکه‌ای که گمان می‌رود نزدیک‌ترین به کلاینت باشد
         (مقدار ۱)، یا مکان کلاینت (مقدار ۲). گزینه (۲) «بایستی» استفاده شود،
         اما ممکن است مشخص نباشد. گزینه‌های (۰) و (۱) «نبایستی» استفاده شوند
         مگر اینکه مشخص باشد کلاینت DHCP در نزدیکی فیزیکی کارگزار یا عنصر شبکه
         قرار دارد.

      country code:  کد کشور دو حرفی ISO 3166 با حروف بزرگ ASCII،
         مانند DE یا US. (نشانی‌های مدنی همیشه شامل تعیین کشور هستند، که
         پیشنهاددهنده استفاده از یک فیلد با قالب ثابت برای صرفه‌جویی در فضا است.)

      civic address elements:  صفر یا چند عنصر تشکیل‌دهنده نشانی مدنی
         و/یا پستی، با قالبی که در زیر شرح داده شده است
         (بخش ۳.۳).
      */
      // نوع: uint8, uint16, array of {binary}
      {
        \(dqcode\(dq: 36,
        // 0x5553 همان \(dqUS\(dq در UTF\-8 است
        \(dqdata\(dq: \(dq0, 0x5553, 15 9D, A3 FF\(dq,
        \(dqname\(dq: \(dqgeoconf\-civic\(dq
      },

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |       OPTION_REMOTE_ID        |         option\-len            |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                       enterprise\-number                       |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      .                                                               .
      .                           remote\-id                           .
      .                                                               .
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      option\-code        OPTION_REMOTE_ID (37)

      option\-len         ۴ + طول فیلد remote\-id به بایت.
                         حداقل option\-len برابر با ۵ بایت است.

      enterprise\-number  شماره ثبت‌شده سازنده (Enterprise Number) به گونه‌ای که
                         در IANA [5] ثبت شده است.

      remote\-id          مقدار مات (opaque) برای remote\-id.
      */
      // نوع: uint32, binary
      {
        \(dqcode\(dq: 37,
        \(dqdata\(dq: \(dq4294967295, 1A BB AD AB BA D0 00 00 00 00 00 00 00 00 CA FE\(dq,
        \(dqname\(dq: \(dqremote\-id\(dq
      },

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |          OPTION_FQDN          |         option\-len            |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |   flags       |                                               |
      +\-+\-+\-+\-+\-+\-+\-+\-+                                               |
      .                                                               .
      .                          domain\-name                          .
      .                                                               .
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      option\-code      OPTION_CLIENT_FQDN (39)

      option\-len       ۱ + طول domain name

      flags            بیت‌های پرچم استفاده‌شده میان کلاینت و کارگزار
                       جهت مذاکره بر سر اینکه چه کسی کدام به‌روزرسانی‌ها
                       را انجام دهد

      domain\-name      نام دامنه جزئی یا کاملاً مشخص‌شده (FQDN)
                       (با طول option\-len \- 1)
      */
      // نوع: uint8, FQDN
      {
        \(dqcode\(dq: 39,
        \(dqdata\(dq: \(dq224, client.example.org\(dq,
        \(dqname\(dq: \(dqclient\-fqdn\(dq
      },

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |       option\-code             |       option\-length           |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                                                               |
      +                                                               +
      |                                                               |
      +                         PAA IPv6 Address                      +
      |                                                               |
      +                                                               +
      |                                                               |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                          ....                                 |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      option\-code:        OPTION_PANA_AGENT (40).

      option\-length:      طول فیلد \(aqoptions\(aq به بایت؛ «باید»
                          مضربی از شانزده (۱۶) باشد.

      PAA IPv6 Address:   نشانی IPv6 مربوط به PAA برای استفاده کلاینت.
                          ‏PAAها به ترتیب اولویت برای استفاده توسط
                          کلاینت فهرست شده‌اند.
      */
      // نوع: array of {IPv6 address}
      {
        \(dqcode\(dq: 40,
        \(dqdata\(dq: \(dq2001:db8::15, 2001:db8::16\(dq,
        \(dqname\(dq: \(dqpana\-agent\(dq
      },

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |  OPTION_NEW_POSIX_TIMEZONE    |         option\-length         |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                      TZ POSIX String                          |
      |                              ...                              |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      option\-code: OPTION_NEW_POSIX_TIMEZONE(41)

      option\-length: تعداد بایت‌های نمایه رشته TZ POSIX شرح داده‌شده
      در زیر.
      */
      // نوع: string
      {
        \(dqcode\(dq: 41,
        // گزینه‌های رشته‌ای که در مقادیر خود ویرگول دارند باید گریز داده شوند
        // (یعنی قبل از هر ویرگول دو بک‌اسلش قرار می‌گیرد). دلیل آن این است که
        // ویرگول‌ها برای جداسازی فیلدها در گزینه‌های مرکب رزرو شده‌اند. در عین
        // حال، باید با مشخصات JSON که \(dq\e,\(dq را مجاز نمی‌داند سازگار
        // باشیم. بنابراین علامت‌گذاری تا حدودی غیرمعمول دو بک‌اسلش مورد نیاز
        // است. مقداری که از طریق شبکه ارسال می‌شود عبارت است از:
        // EST5EDT4,M3.2.0/02:00,M11.1.0/02:00
        \(dqdata\(dq: \(dqEST5EDT4\e\e,M3.2.0/02:00\e\e,M11.1.0/02:00\(dq,
        \(dqname\(dq: \(dqnew\-posix\-timezone\(dq
      },

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |  OPTION_NEW_TZDB_TIMEZONE    |          option\-length         |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                          TZ Name                              |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      option\-code: OPTION_NEW_TZDB_TIMEZONE(42)

      option\-length: تعداد بایت‌های نمایه رشته TZ Database شرح داده‌شده
      در زیر.
      */
      // نوع: string
      {
        \(dqcode\(dq: 42,
        \(dqdata\(dq: \(dqEurope/Zurich\(dq,
        \(dqname\(dq: \(dqnew\-tzdb\-timezone\(dq
      },

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |           OPTION_ERO          |           option\-len          |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |    requested\-option\-code\-1    |    requested\-option\-code\-2    |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                              ...                              |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      option\-code              OPTION_ERO (43).
      option\-len               ۲ * تعداد گزینه‌های درخواستی.
      requested\-option\-code\-n  کد گزینه برای یک گزینه درخواست‌شده توسط
                               عامل رله (relay agent).
      */
      // نوع: array of {uint16}
      {
        \(dqcode\(dq: 43,
        \(dqdata\(dq: \(dq16, 32, 42\(dq,
        \(dqname\(dq: \(dqero\(dq
      },

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |        OPTION_LQ_QUERY        |         option\-len            |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |   query\-type  |                                               |
      +\-+\-+\-+\-+\-+\-+\-+\-+                                               |
      |                                                               |
      |                         link\-address                          |
      |                                                               |
      |               +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |               |                                               .
      +\-+\-+\-+\-+\-+\-+\-+\-+                                               .
      .                         query\-options                         .
      .                                                               .
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      option\-code      OPTION_LQ_QUERY (44)

      option\-len       ۱۷ + طول فیلد query\-options.

      link\-address     یک نشانی سراسری که توسط کارگزار برای شناسایی پیوندی
                       که پرس‌وجو به آن اعمال می‌شود استفاده خواهد شد، یا
                       0::0 اگر مشخص نشده باشد.

      query\-type       پرس‌وجوی درخواست‌شده (زیر را ببینید).

      query\-options    گزینه‌های مربوط به پرس‌وجو.
      */
      // Note: special logic not implemented
      // نوع: uint8, IPv6 address
      {
        \(dqcode\(dq: 44,
        \(dqdata\(dq: \(dq1, 2001:db8::17\(dq,
        \(dqname\(dq: \(dqlq\-query\(dq
      },

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |       OPTION_CLIENT_DATA      |         option\-len            |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      .                                                               .
      .                        client\-options                         .
      .                                                               .
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      option\-code      OPTION_CLIENT_DATA (45)

      option\-len       طول، به بایت، از فیلد کپسوله‌شده client\-options.

      client\-options   گزینه‌های مرتبط با این کلاینت.
      */
      // Note: special logic not implemented
      // نوع: empty
      {
        \(dqcode\(dq: 45,
        \(dqname\(dq: \(dqclient\-data\(dq
      },

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |        OPTION_CLT_TIME        |         option\-len            |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                 client\-last\-transaction\-time                  |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      option\-code      OPTION_CLT_TIME (46)

      option\-len       4

      client\-last\-transaction\-time
                       تعداد ثانیه‌ها از آخرین باری که کارگزار با کلاینت
                       (روی آن پیوند) ارتباط برقرار کرده است.
      */
      // Note: special logic not implemented
      // نوع: uint32
      {
        \(dqcode\(dq: 46,
        \(dqdata\(dq: \(dq600\(dq,
        \(dqname\(dq: \(dqclt\-time\(dq
      },

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |     OPTION_LQ_RELAY_DATA      |         option\-len            |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                                                               |
      |                  peer\-address (IPv6 address)                  |
      |                                                               |
      |                                                               |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                                                               |
      |                       DHCP\-relay\-message                      |
      .                                                               .
      .                                                               .
      .                                                               .
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      option\-code      OPTION_LQ_RELAY_DATA (47)

      option\-len       ۱۶ + طول DHCP\-relay\-message.

      peer\-address     نشانی عامل رله‌ای که پیام رله‌شده توسط کارگزار از
                       آن دریافت شده است.

      DHCP\-relay\-message
                       آخرین پیام رله‌شده کامل، به استثنای پیام کلاینت
                       OPTION_RELAY_MSG، دریافت‌شده توسط کارگزار.
      */
      // Note: special logic not implemented
      // نوع: IPv6 address, binary
      {
        \(dqcode\(dq: 47,
        \(dqdata\(dq: \(dq2001:db8::18, 1A BB AD AB BA D0 00 00 00 00 00 00 00 00 CA FE\(dq,
        \(dqname\(dq: \(dqlq\-relay\-data\(dq
      },

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |     OPTION_LQ_CLIENT_LINK     |         option\-len            |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                                                               |
      |                  link\-address (IPv6 address)                  |
      |                                                               |
      |                                                               |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                                                               |
      |                  link\-address (IPv6 address)                  |
      |                                                               |
      |                                                               |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                              ...                              |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      option\-code      OPTION_LQ_CLIENT_LINK (48)

      option\-len       طول فهرست پیوندها به بایت؛ باید مضربی
                       از ۱۶ باشد.

      link\-address     یک نشانی سراسری که توسط کارگزار برای شناسایی پیوندی
                       که کلاینت در آن واقع شده استفاده می‌شود.
      */
      // Note: special logic not implemented
      // نوع: array of {IPv6 address}
      {
        \(dqcode\(dq: 48,
        \(dqdata\(dq: \(dq2001:db8::19, 2001:db8::20\(dq,
        \(dqname\(dq: \(dqlq\-client\-link\(dq
      },

      // کدهای گزینه ۴۹\-۵۰ در Kea تعریف نشده‌اند.

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |      OPTION_V6_LOST           |         option\-length         |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                LoST Server Domain Name                        |
      |                              ...                              |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      option\-code: OPTION_V6_LOST (51)

      option\-length: طول فیلد \(aqLoST Server Domain Name\(aq
           به بایت؛ متغیر.

      LoST Server Domain Name: نام دامنه کارگزار LoST برای
           استفاده کلاینت.
      */
      // نوع: FQDN
      {
        \(dqcode\(dq: 51,
        \(dqdata\(dq: \(dqlost.example.org\(dq,
        \(dqname\(dq: \(dqv6\-lost\(dq
      },

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |       option\-code             |       option\-length           |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                                                               |
      +                                                               +
      |                                                               |
      +                          AC IPv6 Address                      +
      |                                                               |
      +                                                               +
      |                                                               |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                          ....                                 |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      option\-code:   OPTION_CAPWAP_AC_V6 (52)

      option\-length:   طول فیلد \(aqoptions\(aq به بایت؛ «باید» مضربی
         از شانزده (۱۶) باشد.

      AC IPv6 Address:  نشانی IPv6 یک CAPWAP AC که WTP می‌تواند استفاده
         کند. ACها به ترتیب اولویت برای استفاده توسط WTP فهرست شده‌اند.
      */
      // نوع: array of {IPv6 address}
      {
        \(dqcode\(dq: 52,
        \(dqdata\(dq: \(dq2001:db8::21, 2001:db8::22\(dq,
        \(dqname\(dq: \(dqcapwap\-ac\-v6\(dq
      },

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |       OPTION_RELAY_ID         |          option\-len           |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      .                                                               .
      .                              DUID                             .
      .                        (variable length)                      .
      .                                                               .
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      option\-code   OPTION_RELAY_ID.

      option\-len    طول DUID به بایت.

      DUID          شناسه DUID برای عامل رله.
      */
      // نوع: binary
      {
        \(dqcode\(dq: 53,
        \(dqdata\(dq: \(dq1A BB AD AB BA D0 00 00 00 00 00 00 00 00 CA FE\(dq,
        \(dqname\(dq: \(dqrelay\-id\(dq
      },

      // کدهای گزینه ۵۴\-۵۶ در Kea تعریف نشده‌اند.

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |    OPTION_V6_ACCESS_DOMAIN    |           Length              |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      .                  Access Network Domain Name                   .
      .                              ...                              .
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      option\-code:  OPTION_V6_ACCESS_DOMAIN (57).

      option\-length:  طول کل گزینه نام دامنه شبکه دسترسی به بایت.

      option\-value:  نام دامنه مرتبط با شبکه دسترسی، کدگذاری‌شده
         همان‌طور که در بخش ۳.۱ توصیف شده است.
      */
      // نوع: FQDN
      {
        \(dqcode\(dq: 57,
        \(dqdata\(dq: \(dqv6\-access.example.org\(dq,
        \(dqname\(dq: \(dqv6\-access\-domain\(dq
      },

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |     OPTION_SIP_UA_CS_LIST     |         option\-len            |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                          searchlist                           |
      |                              ...                              |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      option\-code OPTION_SIP_UA_CS_LIST (58)

      option\-len  طول فیلد \(aqsearchlist\(aq به بایت

      searchlist  مشخصات فهرست نام‌های دامنه در SIP User Agent
                  Configuration Service Domains
      */
      // نوع: array of {FQDN}
      {
        \(dqcode\(dq: 58,
        \(dqdata\(dq: \(dqsip\-ua1.example.org, sip\-ua1.example.org\(dq,
        \(dqname\(dq: \(dqsip\-ua\-cs\-list\(dq
      },

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |       OPT_BOOTFILE_URL        |            option\-len         |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                                                               |
      .                  boot\-file\-url (variable length)              .
      |                                                               |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      option\-code       OPT_BOOTFILE_URL (59).

      option\-len        طول boot\-file\-url به بایت.

      boot\-file\-url     این رشته URL فایل راه‌اندازی است. این رشته «باید»
                        با STD 66 [RFC3986] مطابقت داشته باشد. رشته به
                        NUL ختم نمی‌شود.
      */
      // نوع: string
      {
        \(dqcode\(dq: 59,
        \(dqdata\(dq: \(dqhttps://boot.example.org/pxe/os.img\(dq,
        \(dqname\(dq: \(dqbootfile\-url\(dq
      },

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |       OPT_BOOTFILE_PARAM      |            option\-len         |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      | param\-len 1                   |                               |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+           parameter 1         .
      .                                        (variable length)      |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      .                                                               .
      .                       <multiple Parameters>                   .
      .                                                               .
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      | param\-len n                   |                               |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+           parameter n         .
      .                                        (variable length)      |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      option\-code       OPT_BOOTFILE_PARAM (60).

      option\-len        طول گزینه Boot File Parameters به بایت
                        (بدون احتساب اندازه فیلدهای option\-code و
                        option\-len).

      param\-len 1...n   یک عدد صحیح ۱۶ بیتی است که طول پارامتر بعدی
                        را به بایت مشخص می‌کند (بدون احتساب فیلد
                        parameter\-length).

      parameter 1...n   این رشته‌های UTF\-8 پارامترهای مورد نیاز برای
                        راه‌اندازی هستند، مثلاً پارامترهای هسته. رشته‌ها
                        به NUL ختم نمی‌شوند.
      */
      // نوع: array of {tuple}
      {
        \(dqcode\(dq: 60,
        \(dqdata\(dq: \(dqroot=/dev/sda2, quiet, splash\(dq,
        \(dqname\(dq: \(dqbootfile\-param\(dq
      },

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |    OPTION_CLIENT_ARCH_TYPE    |         option\-len            |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      .                                                               .
      .             architecture\-types (variable length)              .
      .                                                               .
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      option\-code         OPTION_CLIENT_ARCH_TYPE (61).

      option\-len          طول فیلد \(dqarchitecture\-types\(dq به بایت.
                          «باید» یک عدد زوج بزرگتر از صفر باشد. برای جزئیات
                          بخش ۲.۱ از [RFC4578] را ببینید.

      architecture\-types  فهرستی از یک یا چند نوع معماری، همان‌طور که در
                          بخش ۲.۱ از [RFC4578] مشخص شده است. هر شناسه نوع
                          معماری در این فهرست یک مقدار ۱۶ بیتی است که
                          محیط زمان اجرای پیش از راه‌اندازی دستگاه کلاینت را
                          توصیف می‌کند. فهرستی از مقادیر معتبر توسط IANA
                          نگهداری می‌شود (بخش ۶ را ببینید).
      */
      // نوع: array of {uint16}
      {
        \(dqcode\(dq: 61,
        \(dqdata\(dq: \(dq1, 3, 5, 7\(dq,
        \(dqname\(dq: \(dqclient\-arch\-type\(dq
      },

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |           OPTION_NII          |          option\-len           |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |     Type      |     Major     |      Minor      |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      option\-code       OPTION_NII (62).

      option\-len        3

      Type              همان‌طور که در بخش ۲.۲ از [RFC4578] مشخص شده است.

      Major             همان‌طور که در بخش ۲.۲ از [RFC4578] مشخص شده است.

      Minor             همان‌طور که در بخش ۲.۲ از [RFC4578] مشخص شده است.
      */
      // نوع: uint8, uint8, array of {uint8}
      {
        \(dqcode\(dq: 62,
        \(dqdata\(dq: \(dq1, 2, 11, 13\(dq,
        \(dqname\(dq: \(dqnii\(dq
      },

      // کد گزینه ۶۳ در Kea تعریف نشده است.

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
      |    OPTION_AFTR_NAME: 64       |          option\-len           |
      +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
      |                                                               |
      |                  tunnel\-endpoint\-name (FQDN)                  |
      |                                                               |
      +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+

      option\-len: طول فیلد tunnel\-endpoint\-name به بایت.

      tunnel\-endpoint\-name: یک نام دامنه کاملاً مشخص‌شده (FQDN) از نقطه
                            پایانی تونل AFTR
      */
      // نوع: FQDN
      {
        \(dqcode\(dq: 64,
        \(dqdata\(dq: \(dqaftr.example.org\(dq,
        \(dqname\(dq: \(dqaftr\-name\(dq
      },

      /*
      0                   1                   2                   3
      0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      | OPTION_ERP_LOCAL_DOMAIN_NAME|         option\-length         |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      | erp\-local\-domain\-name...
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-

      option code
         OPTION_ERP_LOCAL_DOMAIN_NAME (65)

      option\-length
         طول فیلد erp\-local\-domain\-name به بایت

      erp\-local\-domain\-name
         این فیلد شامل نام دامنه محلی ERP است و «باید» همان‌طور که در بخش ۸
         از RFC 3315 [RFC3315] مشخص شده کدگذاری شود. توجه داشته باشید که این
         کدگذاری استفاده از نام‌های دامنه بین‌المللی‌شده را امکان‌پذیر می‌سازد،
         اما فقط به عنوان مجموعه‌ای از A\-labelها [RFC5890].
      */
      // نوع: FQDN
      {
        \(dqcode\(dq: 65,
        \(dqdata\(dq: \(dqerp\-local.example.org\(dq,
        \(dqname\(dq: \(dqerp\-local\-domain\-name\(dq
      },

      /*
      0                   1                   2                   3
      0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |         OPTION_RSOO         |         option\-length         |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |         options...
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      OPTION_RSOO

         کد گزینه‌های ارائه‌شده توسط رله (Relay\-Supplied Options code) (66).

      option\-length

         طول RSOO.

      options

         یک یا چند گزینه DHCPv6.
      */
      // نوع: empty
      {
        \(dqcode\(dq: 66,
        \(dqname\(dq: \(dqrsoo\(dq
      },

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |       OPTION_PD_EXCLUDE       |         option\-len            |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |  prefix\-len   | IPv6 subnet ID (1 to 16 octets)               ~
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

                              گزینه استثنای پیشوند (Prefix Exclude Option)

      o  option\-code: OPTION_PD_EXCLUDE (67).

      o  option\-len: ۱ + طول IPv6 subnet ID به بایت. مقدار معتبر
         برای option\-len بین ۲ و ۱۷ است.

      o  prefix\-len: طول پیشوند مستثنی‌شده بر حسب بیت. مقدار
         prefix\-len «باید» بین \(aqOPTION_IAPREFIX prefix\-length\(aq+1 و
         ۱۲۸ باشد.

      o  IPv6 subnet ID: یک شناسه زیرشبکه IPv6 با طول متغیر تا ۱۲۸ بیت.
      */
      // نوع: binary
      {
        \(dqcode\(dq: 67,
        \(dqdata\(dq: \(dq2001:db8:1:1::/64\(dq,
        \(dqname\(dq: \(dqpd\-exclude\(dq
      },

      // کدهای گزینه ۶۸\-۷۳ در Kea تعریف نشده‌اند.

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |    OPTION_RDNSS_SELECTION     |         option\-len            |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                                                               |
      |            DNS\-recursive\-name\-server (IPv6 address)           |
      |                                                               |
      |                                                               |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      | Reserved  |prf|                                               |
      +\-+\-+\-+\-+\-+\-+\-+\-+          Domains and networks                 |
      |                          (variable length)                    |
      |                                                               |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      option\-code:  OPTION_RDNSS_SELECTION (74)

      option\-len:  طول گزینه به بایت

      DNS\-recursive\-name\-server:  نشانی IPv6 مربوط به RDNSS

      Reserved:  فیلد رزروشده برای آینده. «باید» روی صفر تنظیم شود و
                 «باید» هنگام دریافت نادیده گرفته شود.

      prf:  اولویت RDNSS:

            01 بالا (High)
            00 متوسط (Medium)
            11 پایین (Low)
            10 رزروشده (Reserved)

            مقدار اولویت رزروشده (10) «نباید» ارسال شود. هنگام دریافت،
            مقدار رزروشده «باید» به عنوان اولویت متوسط (00) در نظر گرفته شود.
      */
      // نوع: IPv6 address, uint8, array of {FQDN}
      {
        \(dqcode\(dq: 74,
        \(dqdata\(dq: \(dq2001:db8::23, 01, example.com, example.org\(dq,
        \(dqname\(dq: \(dqrdnss\-selection\(dq
      },

      // کدهای گزینه ۷۵\-۷۸ در Kea تعریف نشده‌اند.

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      | OPTION_CLIENT_LINKLAYER_ADDR  |           option\-length       |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |   link\-layer type (16 bits)   |                               |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+                               |
      |               link\-layer address (variable length)            |
      |                                                               |
      |                                                               |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      option\-code:        OPTION_CLIENT_LINKLAYER_ADDR (79)
      option\-length:      ۲ + طول نشانی link\-layer
      link\-layer type:    نوع نشانی لایه پیوند کلاینت. نوع link\-layer
                          «باید» یک نوع سخت‌افزار معتبر تخصیص‌یافته توسط
                          IANA باشد، همان‌طور که در [RFC0826] توصیف شده است
      link\-layer address: نشانی لایه پیوند کلاینت
      */
      // نوع: binary
      {
        \(dqcode\(dq: 79,
        \(dqdata\(dq: \(dq1A BB AD AB BA D0 00 00 00 00 00 00 00 00 CA FE\(dq,
        \(dqname\(dq: \(dqclient\-linklayer\-addr\(dq
      },

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |       OPTION_LINK_ADDRESS     |         option\-len            |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                                                               |
      |                  link\-address (IPv6 address)                  |
      |                                                               |
      |                                                               |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      option\-code: OPTION_LINK_ADDRESS (80)

      option\-len: ۱۶ (بایت)

      link\-address: یک نشانی IPv6 که توسط کارگزار برای شناسایی پیوندی
      که کلاینت در آن واقع شده استفاده می‌شود.
      */
      // نوع: IPv6 address
      {
        \(dqcode\(dq: 80,
        \(dqdata\(dq: \(dq2001:db8::24\(dq,
        \(dqname\(dq: \(dqlink\-address\(dq
      },

      // کد گزینه ۸۱ در Kea تعریف نشده است.

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |      OPTION_SOL_MAX_RT        |         option\-len            |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                       SOL_MAX_RT value                        |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      option\-code          OPTION_SOL_MAX_RT (82).

      option\-len           4.

      SOL_MAX_RT value     مقدار جایگزین برای SOL_MAX_RT بر حسب ثانیه؛
                           «باید» در این محدوده باشد: 60 <= \(dqvalue\(dq <= 86400
                           (۱ روز). یک فیلد ۴ بایتی حاوی یک عدد صحیح
                           بدون علامت.
      */
      // نوع: uint32
      {
        \(dqcode\(dq: 82,
        \(dqdata\(dq: \(dq420\(dq,
        \(dqname\(dq: \(dqsolmax\-rt\(dq
      },

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |      OPTION_INF_MAX_RT        |         option\-len            |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                       INF_MAX_RT value                        |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

                    تصویر ۳۹: قالب گزینه INF_MAX_RT

      option\-code          OPTION_INF_MAX_RT (83).

      option\-len           4.

      INF_MAX_RT value     مقدار جایگزین برای INF_MAX_RT بر حسب ثانیه؛
                           «باید» در این محدوده باشد: 60 <= \(dqvalue\(dq <= 86400
                           (۱ روز). یک فیلد ۴ بایتی حاوی یک عدد صحیح
                           بدون علامت.
      */
      // نوع: uint32
      {
        \(dqcode\(dq: 83,
        \(dqdata\(dq: \(dq2220\(dq,
        \(dqname\(dq: \(dqinf\-max\-rt\(dq
      },

      // کدهای گزینه ۸۴\-۸۶ در Kea تعریف نشده‌اند.

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |           option\-code         |           option\-len          |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                                                               |
      .                        IPv6 Address(es)                       .
      .                                                               .
      .                                                               .
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      option\-code:  OPTION_DHCP4_O_DHCP6_SERVER (88).

      option\-len:  طول نشانی(های) IPv6 حمل‌شده توسط گزینه،
         یعنی مضربی از ۱۶ بایت. حداقل طول این گزینه ۰ است.

      IPv6 Address:  صفر یا چند نشانی IPv6 از کارگزار(های) DHCP 4o6.
      */
      // نوع: array of {IPv6 address}
      {
        \(dqcode\(dq: 88,
        \(dqdata\(dq: \(dq2001:db8::25, 2001:db8::26\(dq,
        \(dqname\(dq: \(dqdhcp4o6\-server\-addr\(dq
      },

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |        OPTION_S46_RULE        |         option\-length         |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |     flags     |     ea\-len    |  prefix4\-len  | ipv4\-prefix   |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                  (continued)                  |  prefix6\-len  |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                           ipv6\-prefix                         |
      |                       (variable length)                       |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                                                               |
      .                        S46_RULE\-options                       .
      .                                                               .
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      o  option\-code: OPTION_S46_RULE (89)

      o  option\-length: طول گزینه، بدون احتساب فیلدهای option\-code و
         option\-length، با احتساب طول همه گزینه‌های کپسوله‌شده؛
         بیان‌شده به بایت.

      o  flags: با طول ۸ بیت؛ حامل پرچم‌های قابل اعمال بر قانون.
         معانی بیت‌های خاص در تصویر ۲ توضیح داده شده است.

      o  ea\-len: با طول ۸ بیت؛ طول بیتی Embedded Address (EA) را
         مشخص می‌کند. مقادیر مجاز بین ۰ تا ۴۸ است.

      o  prefix4\-len: با طول ۸ بیت؛ طول پیشوند Rule IPv4 prefix
         مشخص‌شده در فیلد ipv4\-prefix را بیان می‌کند. مقادیر مجاز
         بین ۰ تا ۳۲ است.

      o  ipv4\-prefix: یک فیلد ۳۲ بیتی با طول ثابت که پیشوند IPv4 را
         برای قانون S46 مشخص می‌کند. بیت‌های موجود در پیشوند پس از تعداد
         بیت‌های prefix4\-len رزرو هستند و «باید» توسط ارسال‌کننده با صفر
         مقداردهی اولیه شده و توسط گیرنده نادیده گرفته شوند.

      o  prefix6\-len: با طول ۸ بیت؛ طول پیشوند Rule IPv6 prefix
         مشخص‌شده در فیلد ipv6\-prefix را بیان می‌کند. مقادیر مجاز
         بین ۰ تا ۱۲۸ است.

      o  ipv6\-prefix: یک فیلد با طول متغیر که پیشوند دامنه IPv6 را
         برای قانون S46 مشخص می‌کند. این فیلد هنگامی که prefix6\-len
         به طور مساوی بر ۸ بخش‌پذیر نباشد، از سمت راست با بیت‌های صفر
         تا نزدیک‌ترین مرز بایت پر (pad) می‌شود.

      o  S46_RULE\-options: یک فیلد با طول متغیر که ممکن است حاوی صفر یا
         چند گزینه باشد که پارامترهای اضافی را برای این قانون S46 تعیین
         می‌کنند. این سند یک نمونه از چنین گزینه‌ای را مشخص می‌کند:
         OPTION_S46_PORTPARAMS.
      */
      // نوع: uint8, uint8, IPv4 address, IPv6 prefix
      {
        \(dqcode\(dq: 89,
        \(dqdata\(dq: \(dq1, 0, 24, 192.0.2.0, 2001:db8:1::/64\(dq,
        \(dqname\(dq: \(dqs46\-rule\(dq,
        \(dqspace\(dq: \(dqs46\-cont\-mape\-options\(dq
      },

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |         OPTION_S46_BR         |         option\-length         |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                      br\-ipv6\-address                          |
      |                                                               |
      |                                                               |
      |                                                               |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      o  option\-code: OPTION_S46_BR (90)

      o  option\-length: 16

      o  br\-ipv6\-address: یک فیلد ۱۶ بایتی با طول ثابت که نشانی IPv6 را
         برای S46 BR مشخص می‌کند.
      */
      // نوع: IPv6 address
      {
        \(dqcode\(dq: 90,
        \(dqdata\(dq: \(dq2001:db8::27\(dq,
        \(dqname\(dq: \(dqs46\-br\(dq,
        \(dqspace\(dq: \(dqs46\-cont\-mape\-options\(dq
      },

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |        OPTION_S46_DMR         |         option\-length         |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |dmr\-prefix6\-len|            dmr\-ipv6\-prefix                    |
      +\-+\-+\-+\-+\-+\-+\-+\-+           (variable length)                   |
      .                                                               .
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      o  option\-code: OPTION_S46_DMR (91)

      o  option\-length: ۱ + طول dmr\-ipv6\-prefix مشخص‌شده به بایت.

      o  dmr\-prefix6\-len: با طول ۸ بیت؛ طول ماسک بیتی پیشوند IPv6
         مشخص‌شده در فیلد dmr\-ipv6\-prefix را بیان می‌کند. مقادیر مجاز
         بین ۰ تا ۱۲۸ است.

      o  dmr\-ipv6\-prefix: یک فیلد با طول متغیر که پیشوند یا نشانی IPv6 را
         برای BR مشخص می‌کند. هنگامی که dmr\-prefix6\-len بر ۸ بخش‌پذیر
         نباشد، این فیلد از سمت راست تا نزدیک‌ترین مرز بایت با صفر پر می‌شود.
      */
      // نوع: IPv6 prefix
      {
        \(dqcode\(dq: 91,
        \(dqdata\(dq: \(dq2001:db8:cafe::/64\(dq,
        \(dqname\(dq: \(dqs46\-dmr\(dq,
        \(dqspace\(dq: \(dqs46\-cont\-mapt\-options\(dq
      },

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |      OPTION_S46_V4V6BIND      |         option\-length         |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                         ipv4\-address                          |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |bindprefix6\-len|             bind\-ipv6\-prefix                  |
      +\-+\-+\-+\-+\-+\-+\-+\-+             (variable length)                 |
      .                                                               .
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                                                               |
      .                      S46_V4V6BIND\-options                     .
      .                                                               .
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      o  option\-code: OPTION_S46_V4V6BIND (92)

      o  option\-length: طول گزینه، بدون احتساب فیلدهای option\-code و
         option\-length، با احتساب طول همه گزینه‌های کپسوله‌شده؛
         بیان‌شده به بایت.

      o  ipv4\-address: یک فیلد ۴ بایتی با طول ثابت که یک نشانی IPv4 را
         مشخص می‌کند.

      o  bindprefix6\-len: با طول ۸ بیت؛ طول ماسک بیتی پیشوند IPv6
         مشخص‌شده در فیلد bind\-ipv6\-prefix را بیان می‌کند. مقادیر مجاز
         بین ۰ تا ۱۲۸ است.

      o  bind\-ipv6\-prefix: یک فیلد با طول متغیر که پیشوند یا نشانی IPv6 را
         برای S46 CE مشخص می‌کند. هنگامی که bindprefix6\-len بر ۸ بخش‌پذیر
         نباشد، این فیلد از سمت راست تا نزدیک‌ترین مرز بایت با صفر پر می‌شود.

      o  S46_V4V6BIND\-options: یک فیلد با طول متغیر که ممکن است حاوی صفر
         یا چند گزینه باشد که پارامترهای اضافی را تعیین می‌کنند. این سند یک
         نمونه از چنین گزینه‌ای را مشخص می‌کند: OPTION_S46_PORTPARAMS.
      */
      // نوع: IPv4 address, IPv6 prefix
      {
        \(dqcode\(dq: 92,
        \(dqdata\(dq: \(dq192.0.2.78, 2001:db8:1:cafe::/64\(dq,
        \(dqname\(dq: \(dqs46\-v4v6bind\(dq,
        \(dqspace\(dq: \(dqs46\-cont\-lw\-options\(dq
      },

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |     OPTION_S46_PORTPARAMS     |         option\-length         |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |   offset      |    PSID\-len   |              PSID             |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      o  option\-code: OPTION_S46_PORTPARAMS (93)

      o  option\-length: 4

      o  offset: مقدار آفست Port Set Identifier (PSID). با طول ۸ بیت؛
         مقدار عددی را برای بیت‌های آفست/محدوده درگاه مستثنی‌شده
         الگوریتم S46 (بیت‌های a)، طبق بخش ۵.۱ از [RFC7597] مشخص می‌کند.
         مقادیر مجاز بین ۰ تا ۱۵ هستند. مقادیر پیش‌فرض برای این فیلد مختص
         سازوکار softwire در حال پیاده‌سازی بوده و در سند مشخصات مربوطه
         تعریف شده‌اند.

      o  PSID\-len: با طول ۸ بیت؛ تعداد بیت‌های باارزش در فیلد PSID را مشخص
         می‌کند (که به عنوان \(aqk\(aq نیز شناخته می‌شود). وقتی روی ۰ تنظیم شود،
         فیلد PSID نادیده گرفته می‌شود. پس از اولین بیت‌های \(aqa\(aq، تعداد k
         بیت در شماره درگاه وجود دارد که مقدار PSID را نشان می‌دهد. در نتیجه،
         نسبت اشتراک‌گذاری نشانی برابر با 2^k خواهد بود.

      o  PSID: با طول ۱۶ بیت. مقدار PSID به صورت الگوریتمی مجموعه‌ای از
         درگاه‌های تخصیص‌یافته به یک CE را مشخص می‌کند. اولین k بیت در سمت
         چپ این فیلد حاوی مقدار باینری PSID است. بیت‌های باقی‌مانده
         (16 \- k) در سمت راست، صفرهای پرکننده (padding) هستند.
      */
      // نوع: uint8, PSID
      {
        \(dqcode\(dq: 93,
        \(dqdata\(dq: \(dq2, 3/4\(dq,
        \(dqname\(dq: \(dqs46\-portparams\(dq,
        \(dqspace\(dq: \(dqs46\-rule\-options\(dq
      },

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |        OPTION_S46_CONT_MAPE   |         option\-length         |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                                                               |
      .            encapsulated\-options (variable length)             .
      .                                                               .
      +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+

      o  option\-code: OPTION_S46_CONT_MAPE (94)

      o  option\-length: طول گزینه‌های کپسوله‌شده، بیان‌شده به بایت.

      o  encapsulated\-options: گزینه‌های مرتبط با این دامنه
         Softwire46 MAP\-E.
      */
      // نوع: empty
      {
        \(dqcode\(dq: 94,
        \(dqname\(dq: \(dqs46\-cont\-mape\(dq,
        \(dqspace\(dq: \(dqdhcp6\(dq
      },

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |     OPTION_S46_CONT_MAPT      |         option\-length         |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                                                               |
      .            encapsulated\-options (variable length)             .
      .                                                               .
      +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+

      o  option\-code: OPTION_S46_CONT_MAPT (95)

      o  option\-length: طول گزینه‌های کپسوله‌شده، بیان‌شده به بایت.

      o  encapsulated\-options: گزینه‌های مرتبط با این دامنه
         Softwire46 MAP\-T.
      */
      // نوع: empty
      {
        \(dqcode\(dq: 95,
        \(dqname\(dq: \(dqs46\-cont\-mapt\(dq,
        \(dqspace\(dq: \(dqdhcp6\(dq
      },

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |      OPTION_S46_CONT_LW       |         option\-length         |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                                                               |
      +            encapsulated\-options (variable length)             .
      .                                                               .
      +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+

      o  option\-code: OPTION_S46_CONT_LW (96)

      o  option\-length: طول گزینه‌های کپسوله‌شده، بیان‌شده به بایت.

      o  encapsulated\-options: گزینه‌های مرتبط با این دامنه
         Softwire46 Lightweight 4over6.
      */
      // نوع: empty
      {
        \(dqcode\(dq: 96,
        \(dqname\(dq: \(dqs46\-cont\-lw\(dq,
        \(dqspace\(dq: \(dqdhcp6\(dq
      },

      // کدهای گزینه ۹۷\-۱۰۲ در Kea تعریف نشده‌اند.

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |          option\-code          |          option\-len           |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      .                      URI (variable length)                    .
      |                              ...                              |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      o  option\-code: گزینه Captive\-Portal DHCPv6 (103) (دو بایت).

      o  option\-len: طول URI به بایت.

      o  URI: شناسه تماس (URI) برای پورتال دریافت دسترسی (captive portal)
         که کاربر باید به آن متصل شود (کدگذاری‌شده طبق قواعد در [RFC3986]).
      */
      // نوع: string
      {
        \(dqcode\(dq: 103,
        \(dqdata\(dq: \(dqhttps://example.org/captive\-portal\(dq,
        \(dqname\(dq: \(dqv6\-captive\-portal\(dq
      },

      // کدهای گزینه ۱۰۴\-۱۱۱ در Kea تعریف نشده‌اند.
      // کد گزینه ۱۱۲ تخصیص داده نشده است.
      // کدهای گزینه ۱۱۳\-۱۳۴ در Kea تعریف نشده‌اند.

      /*
       0                   1                   2                   3
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |       option\-code (136)       |          option\-length        |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      .           bootstrap\-server\-list (variable length)             .
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      option\-code: OPTION_V6_SZTP_REDIRECT (136)

      option\-length: طول گزینه به بایت.

      bootstrap\-server\-list: فهرستی از کارگزارها برای تلاش کلاینت
       جهت برقراری تماس، به منظور به دست آوردن داده‌های راه‌اندازی اولیه
       بیشتر. هر مدخل URI در bootstrap\-server\-list به شکل زیر ساختاربندی
       شده است:

      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-...\-+\-+\-+\-+\-+\-+\-+
      |       uri\-length              |          URI                  |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-...\-+\-+\-+\-+\-+\-+\-+

      uri\-length: با طول ۲ بایت؛ طول داده‌های URI را مشخص می‌کند.
      URI: شناسه URI مربوط به کارگزار راه‌اندازی اولیه SZTP.
      */
      // نوع: array of {tuple}
      {
        \(dqcode\(dq: 136,
        \(dqdata\(dq: \(dqhttps://sztp1.example.com:8443, https://sztp2.example.com:8444\(dq,
        \(dqname\(dq: \(dqv6\-sztp\-redirect\(dq
      },

      // کدهای گزینه ۱۳۷\-۱۴۲ تخصیص داده نشده‌اند.

      /*
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |      Option Code              |         Length                |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                         IP Address                            |
      .                                                               .
      +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+

      Option Code
         OPTION\-IPv6_Address\-ANDSF (143)

      Length
         طول (به بایت) گزینه بدون احتساب فیلدهای \(aqOption Code\(aq و
         \(aqLength\(aq؛ فیلد \(aqLength\(aq روی 16N تنظیم می‌شود که N تعداد
         نشانی‌های IPv6 حمل‌شده در گزینه است

      IP Address
         نشانی(های) IPv6 مربوط به کارگزار(های) ANDSF
      */
      // نوع: IPv6 address
      {
        \(dqcode\(dq: 143,
        \(dqdata\(dq: \(dq2001:db8::28\(dq,
        \(dqname\(dq: \(dqipv6\-address\-andsf\(dq
      },

      /*
       0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |       Option\-code             |         Option\-length         |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |       Service Priority        |         ADN Length            |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      ~                   authentication\-domain\-name                  ~
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |         Addr Length           |                               |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+                               |
      ~                        ipv6\-address(es)                       ~
      |                               +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+
      |                               |                               |
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+                               |
      ~                 Service Parameters (SvcParams)                ~
      +\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+\-+

      Option\-code:  OPTION_V6_DNR (144)

      Option\-length:  طول داده‌های محصور به بایت. طول گزینه
         برابر با (\(aqADN Length\(aq + 4) است اگر فقط یک ADN در گزینه
         گنجانده شده باشد.

      Service Priority:  اولویت این نمونه OPTION_V6_DNR در مقایسه
         با سایر نمونه‌ها. این عدد صحیح بدون علامت ۱۶ بیتی طبق قواعد
         مشخص‌شده در بخش ۲.۴.۱ از [RFC9460] تفسیر می‌شود.

      ADN Length:  طول فیلد authentication\-domain\-name به بایت.

      authentication\-domain\-name (variable length):  یک نام دامنه کاملاً
         مشخص‌شده (FQDN) از تحلیل‌گر رمزگذاری‌شده DNS. این فیلد همان‌طور که
         در بخش ۱۰ از [RFC9915] مشخص شده قالب‌بندی می‌شود.

      Addr Length:  طول نشانی‌های IPv6 محصور به بایت. در صورت
         حضور، «باید» مضربی از ۱۶ باشد.

      ipv6\-address(es) (variable length):  یک یا چند نشانی IPv6 را برای
         دسترسی به تحلیل‌گر رمزگذاری‌شده DNS مشخص می‌کند. یک نشانی می‌تواند
         link\-local، ‏ULA یا GUA باشد.

      Service Parameters (SvcParams) (variable length):  مجموعه‌ای از
         پارامترهای سرویس را مشخص می‌کند که طبق قواعد بخش ۲.۲ از [RFC9460]
         کدگذاری می‌شوند.
      */
      // نوع: internal
      {
        // گزینه DNR ممکن است با استفاده از علامت‌گذاری مناسب پیکربندی شود. فیلدهای جداشده با ویرگول باید ارائه شوند:
        // \- اولویت سرویس (service priority) (اجباری)،
        // \- شناسه ADN (اجباری)،
        // \- نشانی(های) IP (اختیاری \- در صورت بیش از یک مورد \- باید با فاصله جدا شوند)
        // \- پارامترهای SvcParams (اختیاری \- در صورت بیش از یک مورد \- باید با فاصله جدا شوند؛
        //   برای ارائه بیش از یک alpn\-id آن‌ها را با ویرگول گریز داده‌شده با دو بک‌اسلش مانند
        //   مثال زیر جدا کنید).
        // بر اساس این پیکربندی، Kea گزینه را طبق RFC9463 کدگذاری خواهد کرد.
        \(dqcode\(dq: 144,
        \(dqname\(dq: \(dqv6\-dnr\(dq,
        \(dqdata\(dq: \(dq100, resolver.example., 2001:db8::1 2001:db8::2, alpn=dot\e\e,h2\e\e,h3 port=8530 dohpath=/dns\-query{?dns}\(dq
      },

      // کدهای گزینه ۱۴۵\-۶۵۵۳۵ تخصیص داده نشده‌اند.

      /*
                                 داده‌های گزینه سفارشی
      */
      // برای تعاریف، بخش \(dqoption\-def\(dq در زیر را ببینید.
      {
        \(dqcode\(dq: 111,
        \(dqdata\(dq: \(dq88, 96, 64\(dq,
        \(dqname\(dq: \(dqs46\-priority\(dq
      },
      {
        \(dqcode\(dq: 1,
        \(dqname\(dq: \(dqmy\-empty\-option\(dq,
        \(dqspace\(dq: \(dqmy\-fancy\-space\(dq
      },
      {
        \(dqcode\(dq: 222,
        \(dqdata\(dq: \(dq2001:db8::29, 2001:db8::/64, 3/4, 1, example.org, string\(dq,
        \(dqname\(dq: \(dqmy\-lengthy\-option\(dq,
        \(dqspace\(dq: \(dqmy\-fancy\-space\(dq
      },
      {
        \(dqcode\(dq: 65432,
        \(dqdata\(dq: \(dq127, 32767, 2147483647, 255, 65535, 4294967295, 192.0.2.79, 2001:db8::30, 2001:db8::/64, 3/4, 1, example.org, string\(dq,
        \(dqname\(dq: \(dqmy\-fancy\-option\(dq,
        \(dqspace\(dq: \(dqmy\-fancy\-space\(dq
      },
      {
        \(dqcode\(dq: 12321,
        \(dqname\(dq: \(dqmy\-encapsulating\-option\(dq,
        \(dqspace\(dq: \(dqmy\-encapsulating\-space\(dq
      }
    ],

    /*
                             تعاریف گزینه سفارشی
    */
    // برای kea\-dhcp6، تعاریف گزینه‌های سفارشی همیشه سراسری هستند. حتی وقتی
    // داده‌های گزینه‌های مذکور سپس در سطح زیرشبکه پیکربندی شوند.
    \(dqoption\-def\(dq: [
      // درون فضای پیش‌فرض. کدها نباید با سایر تعاریف گزینه استاندارد/سفارشی
      // تداخل داشته باشند.
      // گزینه‌ای از یک RFC واقعی (8026) که در میان تعاریف استاندارد پیاده‌سازی
      // نشده است. این گزینه به عنوان آرایه‌ای از اعداد صحیح ۱۶ بیتی ساختاربندی
      // شده است، بنابراین \(dqarray\(dq روی true و \(dqtype\(dq روی \(dquint16\(dq تنظیم می‌شود.
      {
        \(dqarray\(dq: true,
        \(dqcode\(dq: 111,
        \(dqencapsulate\(dq: \(dq\(dq,
        \(dqname\(dq: \(dqs46\-priority\(dq,
        \(dqrecord\-types\(dq: \(dq\(dq,
        \(dqspace\(dq: \(dqdhcp6\(dq,
        \(dqtype\(dq: \(dquint16\(dq
      },

      // فضای گزینه جدید امکان استفاده از مجموعه‌ای جدید از کدهای گزینه را فراهم می‌کند.
      // یک گزینه خالی نیازی به \(dqdata\(dq در \(dqoption\-data\(dq ندارد. وجود
      // آن برای فعال‌سازی رفتار سفارشی کافی خواهد بود.
      {
        \(dqarray\(dq: false,
        \(dqcode\(dq: 1,
        \(dqencapsulate\(dq: \(dq\(dq,
        \(dqname\(dq: \(dqmy\-empty\-option\(dq,
        \(dqrecord\-types\(dq: \(dq\(dq,
        \(dqspace\(dq: \(dqmy\-fancy\-space\(dq,
        \(dqtype\(dq: \(dqempty\(dq
      },

      // در یک نوع سفارشی، \(dqtype\(dq روی \(dqrecord\(dq تنظیم می‌شود و تمام انواع داده (که باید
      // بیش از ۱ مورد باشند، در غیر این صورت بهتر است مستقیماً از نوع استفاده کنید)
      // در \(dqrecord\-types\(dq مشخص می‌شوند. اگر \(dqstring\(dq بخشی از آن‌ها باشد، باید
      // آخرین مورد باشد.
      {
        \(dqarray\(dq: false,
        \(dqcode\(dq: 222,
        \(dqencapsulate\(dq: \(dq\(dq,
        \(dqname\(dq: \(dqmy\-lengthy\-option\(dq,
        \(dqrecord\-types\(dq: \(dqipv6\-address, ipv6\-prefix, psid, tuple, fqdn, string\(dq,
        \(dqspace\(dq: \(dqmy\-fancy\-space\(dq,
        \(dqtype\(dq: \(dqrecord\(dq
      },

      // شامل آرایه‌هایی از همه انواع به جز رشته‌ها، زیرا آرایه‌ای از رشته‌ها
      // یک تعریف گزینه معتبر نیست.
      {
        \(dqarray\(dq: true,
        \(dqcode\(dq: 65432,
        \(dqencapsulate\(dq: \(dq\(dq,
        \(dqname\(dq: \(dqmy\-fancy\-option\(dq,
        \(dqrecord\-types\(dq: \(dqint8, int16, int32, uint8, uint16, uint32, ipv4\-address, ipv6\-address, ipv6\-prefix.SS kea6/backends.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک فایل پیکربندی نمونه برای کارساز DHCPv6 در Kea است.
// این یک سناریوی پایه‌ای با یک زیرشبکهٔ IPv6 پیکربندی‌شده است. این مثال نشان می‌دهد
// که چگونه Kea را برای استفاده از بک‌اندهای مختلف جهت ذخیرهٔ اجاره‌ها پیکربندی کنید:
// \- memfile
// \- MySQL
// \- PostgreSQL

{ \(dqDhcp6\(dq:

{
// به Kea گفته شده است که تنها روی رابط eth0 گوش فرا دهد.
  \(dqinterfaces\-config\(dq: {
    \(dqinterfaces\(dq: [ \(dqeth0\(dq ]
  },

// ما باید نوع اجاره را مشخص کنیم. دقیقاً یک بخش lease\-database
// باید وجود داشته باشد. اطمینان حاصل کنید که فقط یکی را از حالت کامنت خارج می‌کنید.

// 1. بک‌اند memfile. اطلاعات اجاره‌ها در یک فایل متنی سادهٔ CSV ذخیره خواهد شد.
// این ساده‌ترین بک‌اند برای استفاده است زیرا به هیچ وابستگی اضافی
// یا سرویس در حال اجرایی نیاز ندارد.
  \(dqlease\-database\(dq: {
      \(dqtype\(dq: \(dqmemfile\(dq,
      \(dqpersist\(dq: true,
      \(dqlfc\-interval\(dq: 3600
  },

// 2. بک‌اند MySQL. اجاره‌ها در پایگاه‌دادهٔ MySQL ذخیره خواهند شد. اطمینان حاصل
// کنید که فعال، در حال اجرا و به‌درستی مقداردهی اولیه شده است. برای جزئیات در مورد
// نحوهٔ مقداردهی اولیهٔ پایگاه‌داده به مستندات kea\-admin مراجعه کنید. تنها پارامترهایی که
// الزاماً مورد نیاز هستند type و name می‌باشند. اگر پارامترهای دیگر مشخص نشوند،
// Kea فرض می‌کند پایگاه‌داده روی localhost در دسترس است، نام کاربری و
// گذرواژه برای اتصال لازم نیست و مهلت زمانی برابر با 5 ثانیه است.
// برای استفاده از این بک‌اند، Kea باید با گزینهٔ \(dq\-D mysql\(dq کامپایل شده باشد.
//  \(dqlease\-database\(dq: {
//      \(dqtype\(dq: \(dqmysql\(dq,
//      \(dqname\(dq: \(dqkeatest\(dq,
//      \(dqhost\(dq: \(dqlocalhost\(dq,
//      \(dqport\(dq: 3306,
//      \(dquser\(dq: \(dqkeatest\(dq,
//      \(dqpassword\(dq: \(dq1234\(dq,
//      \(dqreconnect\-wait\-time\(dq: 3000, // بیان‌شده به میلی‌ثانیه
//      \(dqmax\-reconnect\-tries\(dq: 3,
//      \(dqon\-fail\(dq: \(dqstop\-retry\-exit\(dq,
//      \(dqretry\-on\-startup\(dq: false,
//      \(dqconnect\-timeout\(dq: 3
//  },
// از نسخهٔ Kea.2.7.4 به بعد، کتابخانهٔ هوک libdhcp_mysql.so باید بارگذاری شود تا
// اجاره‌ها در بک‌اند پایگاه‌دادهٔ اجارهٔ MySQL ذخیره شوند.
// مکان کتابخانهٔ هوک بک‌اند اجاره را مشخص کنید.
//  {
//      // کتابخانهٔ هوک بک‌اند اجارهٔ MySQL که برای ذخیره‌سازی اجاره‌ها لازم است.
//      \(dqlibrary\(dq: \(dqlibdhcp_mysql.so\(dq
//  },

// 3. بک‌اند PostgreSQL. اجاره‌ها در پایگاه‌دادهٔ PostgreSQL ذخیره خواهند شد. اطمینان
// حاصل کنید که فعال، در حال اجرا و به‌درستی مقداردهی اولیه شده است. برای جزئیات در مورد
// نحوهٔ مقداردهی اولیهٔ پایگاه‌داده به مستندات kea\-admin مراجعه کنید. تنها پارامترهایی که
// الزاماً مورد نیاز هستند type و name می‌باشند. اگر پارامترهای دیگر مشخص نشوند،
// Kea فرض می‌کند پایگاه‌داده روی localhost در دسترس است، نام کاربری و
// گذرواژه برای اتصال لازم نیست و مهلت زمانی برابر با 5 ثانیه است.
// برای استفاده از این بک‌اند، Kea باید با گزینهٔ \(dq\-D postgresql\(dq کامپایل شده باشد.
//  \(dqlease\-database\(dq: {
//      \(dqtype\(dq: \(dqpostgresql\(dq,
//      \(dqname\(dq: \(dqkeatest\(dq,
//      \(dqhost\(dq: \(dqlocalhost\(dq,
//      \(dqport\(dq: 5432,
//      \(dquser\(dq: \(dqkeatest\(dq,
//      \(dqpassword\(dq: \(dq1234\(dq,
//      \(dqreconnect\-wait\-time\(dq: 3000, // بیان‌شده به میلی‌ثانیه
//      \(dqmax\-reconnect\-tries\(dq: 3,
//      \(dqon\-fail\(dq: \(dqstop\-retry\-exit\(dq,
//      \(dqretry\-on\-startup\(dq: false,
//      \(dqconnect\-timeout\(dq: 3
//  },
// از نسخهٔ Kea.2.7.4 به بعد، کتابخانهٔ هوک libdhcp_pgsql.so باید بارگذاری شود تا
// اجاره‌ها در بک‌اند پایگاه‌دادهٔ اجارهٔ PostgreSQL ذخیره شوند.
// مکان کتابخانهٔ هوک بک‌اند اجاره را مشخص کنید.
//  {
//      // کتابخانهٔ هوک بک‌اند اجارهٔ PostgreSQL که برای ذخیره‌سازی اجاره‌ها لازم است.
//      \(dqlibrary\(dq: \(dqlibdhcp_pgsql.so\(dq
//  },

// آدرس‌ها با طول‌عمرهای ترجیحی (preferred) و معتبر (valid) که به ترتیب
// 3000 و 4000 هستند اختصاص داده خواهند شد. به کلاینت گفته می‌شود که پس از
// 1000 ثانیه تمدید را آغاز کند. اگر کارساز پس از 2000 ثانیه از زمان اعطای
// اجاره پاسخی نداد، کلاینت باید روال REBIND (تمدید اضطراری که
// امکان جابه‌جایی به یک کارساز دیگر را فراهم می‌کند) را آغاز کند.
  \(dqpreferred\-lifetime\(dq: 3000,
  \(dqvalid\-lifetime\(dq: 4000,
  \(dqrenew\-timer\(dq: 1000,
  \(dqrebind\-timer\(dq: 2000,

// فهرست زیر زیرشبکه‌ها را تعریف می‌کند. هر زیرشبکه حداقل شامل
// مدخل‌های subnet و pool است.
  \(dqsubnet6\(dq: [
    {
      \(dqpools\(dq: [ { \(dqpool\(dq: \(dq2001:db8:1::/80\(dq } ],
      \(dqid\(dq: 1,
      \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
      \(dqinterface\(dq: \(dqeth0\(dq
    }
  ],

// بخش زیر ثبت وقایع (logging) را پیکربندی می‌کند. فرض می‌شود که پیام‌هایی با
// حداقل سطح اطلاعاتی (info، warn، error و fatal) باید در
// stdout ثبت شوند.
    \(dqloggers\(dq: [
        {
            \(dqname\(dq: \(dqkea\-dhcp6\(dq,
            \(dqoutput\-options\(dq: [
                {
                    \(dqoutput\(dq: \(dqstdout\(dq
                }
            ],
            \(dqdebuglevel\(dq: 0,
            \(dqseverity\(dq: \(dqINFO\(dq
        }
    ]
}

}
.EE
.UNINDENT
.UNINDENT.SS kea6/classify.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک فایل پیکربندی نمونه برای کارساز DHCPv6 در Kea است.
// هدف این مثال نمایش نحوه دسته‌بندی کلاینت‌ها است.

{ \(dqDhcp6\(dq:

{
// به Kea گفته شده است که تنها روی رابط eth0 گوش فرا دهد.
  \(dqinterfaces\-config\(dq: {
    \(dqinterfaces\(dq: [ \(dqeth0\(dq ]
  },

// بیایید از ساده‌ترین بک‌اند یعنی memfile و مقادیر معقولی
// برای تایمرها استفاده کنیم. آن‌ها ارتباطی با نمایش دسته‌بندی ندارند.
  \(dqlease\-database\(dq: {
      \(dqtype\(dq: \(dqmemfile\(dq,
      \(dqlfc\-interval\(dq: 3600
  },
  \(dqrenew\-timer\(dq: 1000,
  \(dqrebind\-timer\(dq: 2000,
  \(dqpreferred\-lifetime\(dq: 3000,
  \(dqvalid\-lifetime\(dq: 4000,

// این فهرست چندین کلاس را تعریف می‌کند که بسته‌های ورودی می‌توانند به آن‌ها اختصاص یابند.
// یک بسته می‌تواند متعلق به صفر یا چند کلاس باشد.
  \(dqclient\-classes\(dq: [

// کلاس نخست تلاش می‌کند تمام بسته‌های ورودی از رابط eth0 را تطبیق دهد.
  {
      \(dqname\(dq: \(dqlab\(dq,
      \(dqtest\(dq: \(dqpkt.iface == \(aqeth0\(aq\(dq,
      \(dqoption\-data\(dq: [{
          \(dqname\(dq: \(dqdns\-servers\(dq,
          \(dqdata\(dq: \(dq2001:db8::1\(dq
      }]
  },

// بیایید تمام پیام‌های ورودی RENEW (نوع پیام 5) را در یک کلاس مجزا
// دسته‌بندی کنیم.
  {
      \(dqname\(dq: \(dqrenews\(dq,
      \(dqtest\(dq: \(dqpkt6.msgtype == 5\(dq
  },

// بیایید مودم‌های کابلی را انتخاب کنیم. در این مثال ساده فرض می‌کنیم اگر دستگاه
// یک گزینه سازنده با enterprise\-id برابر با 4491 ارسال کند،
// یک مودم کابلی است.
  {
      \(dqname\(dq: \(dqcable\-modems\(dq,
      \(dqtest\(dq: \(dqvendor.enterprise == 4491\(dq
  }

  ],


// فهرست زیر زیرشبکه‌ها را تعریف می‌کند. هر زیرشبکه حداقل شامل
// مدخل‌های subnet و pool است.
  \(dqsubnet6\(dq: [
    {
        \(dqid\(dq: 1,
        \(dqpools\(dq: [ { \(dqpool\(dq: \(dq2001:db8:1::/80\(dq } ],
        \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
        \(dqclient\-classes\(dq: [ \(dqcable\-modems\(dq ],
        \(dqinterface\(dq: \(dqeth0\(dq
    },

    // زیرشبکه زیر شامل یک رزرو کلاس برای کلاینتی با شناسه
    // DUID 01:02:03:04:05:0A:0B:0C:0D:0E است. این کلاینت همواره به
    // این کلاس اختصاص داده خواهد شد.
    {
        \(dqid\(dq: 2,
        \(dqpools\(dq: [ { \(dqpool\(dq: \(dq2001:db8:2::/80\(dq } ],
        \(dqsubnet\(dq: \(dq2001:db8:2::/64\(dq,
        \(dqreservations\(dq: [
        {
            \(dqduid\(dq: \(dq01:02:03:04:05:0A:0B:0C:0D:0E\(dq,
            \(dqclient\-classes\(dq: [ \(dqcable\-modems\(dq ]
        } ],
        \(dqinterface\(dq: \(dqeth0\(dq
    },

    // زیرشبکه زیر شامل یک استخر با محدودیت کلاسی است: تنها
    // کلاینت‌هایی که متعلق به این کلاس هستند مجاز به استفاده از این استخر می‌باشند.
    {
        \(dqid\(dq: 3,
        \(dqpools\(dq: [
           {
               \(dqpool\(dq: \(dq2001:db8:4::/80\(dq,
               \(dqclient\-classes\(dq: [ \(dqcable\-modems\(dq ]
           } ],
         \(dqsubnet\(dq: \(dq2001:db8:4::/64\(dq,
         \(dqinterface\(dq: \(dqeth1\(dq
    }

  ],

// بخش زیر گزارش‌گیری را پیکربندی می‌کند. فرض بر این است که پیام‌ها حداقل با
// سطح اطلاعاتی (info، warn، error و fatal) باید در
// stdout ثبت شوند.
    \(dqloggers\(dq: [
        {
            \(dqname\(dq: \(dqkea\-dhcp6\(dq,
            \(dqoutput\-options\(dq: [
                {
                    \(dqoutput\(dq: \(dqstdout\(dq
                }
            ],
            \(dqdebuglevel\(dq: 0,
            \(dqseverity\(dq: \(dqINFO\(dq
        }
    ]
}

}
.EE
.UNINDENT
.UNINDENT.SS kea6/classify2.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک فایل پیکربندی نمونه برای کارساز DHCPv6 در Kea است.
// هدف این نمونه نمایش چگونگی طبقه‌بندی کلاینت‌ها است.

{ \(dqDhcp6\(dq:

{
// به Kea دستور داده شده است که فقط روی رابط eth0 شنود کند.
  \(dqinterfaces\-config\(dq: {
    \(dqinterfaces\(dq: [ \(dqeth0\(dq ]
  },

// بیایید از ساده‌ترین بک‌اند استفاده کنیم: memfile و چند مقدار معقول
// برای زمان‌سنج‌ها در نظر بگیریم. آن‌ها در نمایش طبقه‌بندی نقشی ندارند.
  \(dqlease\-database\(dq: {
      \(dqtype\(dq: \(dqmemfile\(dq,
      \(dqlfc\-interval\(dq: 3600
  },
  \(dqrenew\-timer\(dq: 1000,
  \(dqrebind\-timer\(dq: 2000,
  \(dqpreferred\-lifetime\(dq: 3000,
  \(dqvalid\-lifetime\(dq: 4000,

// این فهرست چندین کلاس را تعریف می‌کند که بسته‌های دریافتی می‌توانند به آن‌ها منتسب شوند.
// یک بسته می‌تواند عضو صفر یا چند کلاس باشد.
  \(dqclient\-classes\(dq: [

// این کلاس توسط زیرشبکه دوم در فهرست \(aqevaluate\-additional\-classes\(aq آن گنجانده شده،
// بنابراین \(aqonly\-in\-additional\-list\(aq فعال است. این تضمین می‌کند کلاس تنها
// در صورتی ارزیابی شود که زیرشبکه دوم انتخاب گردد. عبارت آزمون true برمی‌گرداند.
// توجه داشته باشید که وابستگی به کلاس cable\-modems امکان‌پذیر نیست زیرا
// هنوز تعریف نشده است.
  {
      \(dqname\(dq: \(dqsecond_subnet\(dq,
      \(dqonly\-in\-additional\-list\(dq: true,
      \(dqtest\(dq: \(dqmember(\(aqALL\(aq)\(dq,
      \(dqoption\-data\(dq: [{
          \(dqname\(dq: \(dqdns\-servers\(dq,
          \(dqdata\(dq: \(dq2001:db8::1\(dq
      }]
  },

// بیایید تمام پیام‌های RENEW دریافتی (نوع پیام ۵) را در یک کلاس مجزا
// طبقه‌بندی کنیم.
  {
      \(dqname\(dq: \(dqrenews\(dq,
      \(dqtest\(dq: \(dqpkt6.msgtype == 5\(dq
  },

// بیایید مودم‌های کابلی را انتخاب کنیم. در این مثال ساده فرض می‌کنیم دستگاه در صورتی
// یک مودم کابلی است که یک گزینه سازنده با enterprise\-id برابر با
// 4491 ارسال کند.
  {
      \(dqname\(dq: \(dqcable\-modems\(dq,
      \(dqtest\(dq: \(dqvendor.enterprise == 4491\(dq
  },

// هم یک مودم کابلی باشد (از طریق ارزیابی یا رزرو میزبان) و هم دارای یک رزرو
// میزبان باشد.
  {
      \(dqname\(dq: \(dqcable\-modem\-hosts\(dq,
      \(dqtest\(dq: \(dqmember(\(aqcable\-modems\(aq) and member(\(aqKNOWN\(aq)\(dq
  }

  ],


// فهرست زیر، زیرشبکه‌ها را تعریف می‌کند. هر زیرشبکه حداقل شامل ورودی‌های
// subnet و pool است.
  \(dqsubnet6\(dq: [
    {
        \(dqid\(dq: 1,
        \(dqpools\(dq: [ { \(dqpool\(dq: \(dq2001:db8:1::/80\(dq } ],
        \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
        \(dqclient\-classes\(dq: [ \(dqcable\-modems\(dq ],
        \(dqinterface\(dq: \(dqeth0\(dq
    },
// زیرشبکه زیر شامل رزرو کلاس برای کلاینتی با مشخصه
// DUID 01:02:03:04:05:0A:0B:0C:0D:0E است. این کلاینت همواره به این کلاس
// منتسب خواهد شد.
    {
        \(dqid\(dq: 2,
        \(dqpools\(dq: [ { \(dqpool\(dq: \(dq2001:db8:2::/80\(dq } ],
        \(dqsubnet\(dq: \(dq2001:db8:2::/64\(dq,
        \(dqreservations\(dq: [
        {
            \(dqduid\(dq: \(dq01:02:03:04:05:0A:0B:0C:0D:0E\(dq,
            \(dqclient\-classes\(dq: [ \(dqcable\-modems\(dq ]
        } ],
        \(dqinterface\(dq: \(dqeth0\(dq,
        \(dqevaluate\-additional\-classes\(dq: [ \(dqsecond_subnet\(dq ]
    },
// زیرشبکه زیر شامل یک استخر با قید کلاسی است: فقط کلاینت‌هایی که
// به این کلاس تعلق دارند مجاز به استفاده از این استخر هستند.
    {
        \(dqid\(dq: 3,
        \(dqpools\(dq: [
           {
               \(dqpool\(dq: \(dq2001:db8:4::/80\(dq,
               \(dqclient\-classes\(dq: [ \(dqcable\-modems\(dq ]
           } ],
         \(dqsubnet\(dq: \(dq2001:db8:4::/64\(dq,
         \(dqinterface\(dq: \(dqeth1\(dq
    },
// این زیرشبکه برای کلاینت‌های ناشناخته (unknown) و شناخته‌شده (known)
// (یعنی کلاینت‌هایی که رزرو دارند) به دو استخر تقسیم شده است. کلاس‌های درونی KNOWN و
// UNKNOWN در زمان جستجوی رزرو میزبان مقداردهی می‌شوند (اگر موردی یافت شود KNOWN،
// و اگر چیزی یافت نشود UNKNOWN) و کلاس‌های کلاینت وابسته به آن ارزیابی می‌گردند.
// این مرحله پس از انتخاب زیرشبکه و پیش از تخصیص نشانی از استخرها رخ می‌دهد.
    {
        \(dqid\(dq: 4,
        \(dqpools\(dq: [
            {
               \(dqpool\(dq: \(dq2001:db8:8::/64\(dq,
               \(dqclient\-classes\(dq: [ \(dqUNKNOWN\(dq ]
            },
            {
               \(dqpool\(dq: \(dq2001:db8:9::/64\(dq,
               \(dqclient\-classes\(dq: [ \(dqKNOWN\(dq ]
           }
        ],
        \(dqsubnet\(dq: \(dq2001:db8:8::/46\(dq,
        \(dqreservations\(dq: [
            {  \(dqhw\-address\(dq: \(dq00:00:00:11:22:33\(dq, \(dqhostname\(dq: \(dqh1\(dq },
            {  \(dqhw\-address\(dq: \(dq00:00:00:44:55:66\(dq, \(dqhostname\(dq: \(dqh4\(dq },
            {  \(dqhw\-address\(dq: \(dq00:00:00:77:88:99\(dq, \(dqhostname\(dq: \(dqh7\(dq },
            {  \(dqhw\-address\(dq: \(dq00:00:00:aa:bb:cc\(dq, \(dqhostname\(dq: \(dqha\(dq }
        ]
    }

  ],

// پیکربندی زیر مربوط به گزارش‌گیری است. فرض بر این است که پیام‌هایی حداقل
// با سطح اطلاعاتی (info، warn، error و fatal) باید در
// stdout ثبت شوند.
    \(dqloggers\(dq: [
        {
            \(dqname\(dq: \(dqkea\-dhcp6\(dq,
            \(dqoutput\-options\(dq: [
                {
                    \(dqoutput\(dq: \(dqstdout\(dq
                }
            ],
            \(dqdebuglevel\(dq: 0,
            \(dqseverity\(dq: \(dqINFO\(dq
        }
    ]
}

}
.EE
.UNINDENT
.UNINDENT.SS kea6/comments.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک فایل پیکربندی نمونه برای کارساز DHCPv6 در Kea است.
// این فایل از کامنت‌های تعبیه‌شده (یعنی مواردی که در اشیاء پیکربندی گنجانده
// شده و در مرحله تحلیل واژگانی حذف نمی‌گردند) استفاده می‌کند.

{ \(dqDhcp6\(dq:

{
   // دامنه سراسری
   \(dqcomment\(dq: \(dqیک کارساز DHCPv6\(dq,

   // در پیکربندی رابط
   \(dqinterfaces\-config\(dq: {
       \(dqcomment\(dq: \(dqاستفاده از نویسه عمومی (wildcard)\(dq,
       \(dqinterfaces\(dq: [ \(dq*\(dq ] },

   // در تعاریف گزینه‌ها
   \(dqoption\-def\(dq: [ {
       \(dqcomment\(dq: \(dqیک تعریف گزینه\(dq,
       \(dqname\(dq: \(dqfoo\(dq,
       \(dqcode\(dq: 100,
       \(dqtype\(dq: \(dqipv6\-address\(dq,
       \(dqspace\(dq: \(dqisc\(dq
    } ],

   // در داده‌های گزینه
   \(dqoption\-data\(dq: [ {
       \(dqcomment\(dq: \(dqتنظیم مقدار گزینه\(dq,
       \(dqname\(dq: \(dqsubscriber\-id\(dq,
       \(dqdata\(dq: \(dqABCDEF0105\(dq,
       \(dqcsv\-format\(dq: false
    } ],

   // در کلاس‌های کلاینت
   \(dqclient\-classes\(dq: [
       {
          \(dqcomment\(dq: \(dqتطابق با همه\(dq,
          \(dqname\(dq: \(dqall\(dq,
          \(dqtest\(dq: \(dq\(aq\(aq == \(aq\(aq\(dq
       },
       // البته کامنت‌ها اختیاری هستند
       {
          \(dqname\(dq: \(dqnone\(dq
       },
       // می‌توان یک کامنت و یک user\-context مشخص کرد
       {
          \(dqcomment\(dq: \(dqیک کامنت\(dq,
          \(dqname\(dq: \(dqboth\(dq,
          \(dquser\-context\(dq: {
              \(dqversion\(dq: 1
          }
       }
   ],

   // در سوکت‌های کنترلی
   \(dqcontrol\-sockets\(dq: [
       {
           \(dqsocket\-type\(dq: \(dqunix\(dq,
           \(dqsocket\-name\(dq: \(dqkea6\-ctrl\-socket\(dq,
           \(dquser\-context\(dq: { \(dqcomment\(dq: \(dqکامنت غیرمستقیم\(dq }
       },
       {
           \(dqcomment\(dq: \(dqسوکت کنترلی HTTP\(dq,
           \(dqsocket\-type\(dq: \(dqhttp\(dq,
           \(dqsocket\-address\(dq: \(dq127.0.0.1\(dq,
           \(dqsocket\-port\(dq: 8006,

           // در احراز هویت
           \(dqauthentication\(dq: {
               \(dqcomment\(dq: \(dqاحراز هویت پایه HTTP\(dq,
               \(dqtype\(dq: \(dqbasic\(dq,
               // در کلاینت‌های احراز هویت پایه HTTP
               \(dqclients\(dq: [ {
                   \(dquser\(dq: \(dqadmin\(dq,
                   \(dqpassword\(dq: \(dq1234\(dq
               } ]
           }
       }
   ],

   // در شبکه‌های اشتراکی
   \(dqshared\-networks\(dq: [ {
       \(dqcomment\(dq: \(dqیک شبکه اشتراکی\(dq,
       \(dqname\(dq: \(dqfoo\(dq,

       // در زیرشبکه‌ها
       \(dqsubnet6\(dq: [
         {
           \(dqcomment\(dq: \(dqیک زیرشبکه\(dq,
           \(dqsubnet\(dq: \(dq2001:db1::/64\(dq,
           \(dqid\(dq: 100,

           // در استخرها
           \(dqpools\(dq: [
             {
                \(dqcomment\(dq: \(dqیک استخر\(dq,
                \(dqpool\(dq: \(dq2001:db1::/64\(dq
             }
           ],

           // در استخرهای پیشوند
           \(dqpd\-pools\(dq: [
             {
                \(dqcomment\(dq: \(dqیک استخر پیشوند\(dq,
                \(dqprefix\(dq: \(dq2001:db2::\(dq,
                \(dqprefix\-len\(dq: 48,
                \(dqdelegated\-len\(dq: 64
             }
           ],

           // در رزروهای میزبان
           \(dqreservations\(dq: [
             {
                \(dqcomment\(dq: \(dqیک رزرو میزبان\(dq,
                \(dqhw\-address\(dq: \(dqAA:BB:CC:DD:EE:FF\(dq,
                \(dqhostname\(dq: \(dqfoo.example.com\(dq,

                // مجدداً در داده‌های گزینه
                \(dqoption\-data\(dq: [ {
                    \(dqcomment\(dq: \(dqیک گزینه در رزرو\(dq,
                    \(dqname\(dq: \(dqdomain\-search\(dq,
                    \(dqdata\(dq: \(dqexample.com\(dq
                } ]
             }
           ]
         }
       ]
    } ],

   // در dhcp ddns
   \(dqdhcp\-ddns\(dq: {
       \(dqcomment\(dq: \(dqبدون DNS پویا\(dq,
       \(dqenable\-updates\(dq: false
   },

   // در ثبت‌کننده‌ها
   \(dqloggers\(dq: [ {
       \(dqcomment\(dq: \(dqیک ثبت‌کننده\(dq,
       \(dqname\(dq: \(dqkea\-dhcp6\(dq
   } ]
}

}
.EE
.UNINDENT
.UNINDENT.SS kea6/config\-backend.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک فایل پیکربندی نمونه برای کارساز DHCPv4 در Kea است.
// این پرونده نحوهٔ فعال‌سازی Configuration Backend در Kea را با استفاده از MySQL نشان می‌دهد.
// این مورد نیازمند در دسترس بودن کتابخانهٔ libdhcp_mysql.so و
// به صورت اختیاری کتابخانهٔ قلاب libdhcp_cb_cmds.so است.

{ \(dqDhcp6\(dq:

{
    // برچسب کارساز را برای backend پیکربندی تنظیم کنید. این نمونه
    // server2 نامیده خواهد شد. هر بخش از پیکربندی که برای
    // \(dqall\(dq یا \(dqserver2\(dq قابل اعمال باشد توسط این نمونه استفاده خواهد شد.
    \(dqserver\-tag\(dq: \(dqserver2\(dq,

    // به Kea گفته شده است که تنها روی رابط eth0 گوش فرا دهد.
    \(dqinterfaces\-config\(dq: {
        \(dqinterfaces\(dq: [ \(dqeth0\(dq ]
    },

    // استفاده از backend پایگاه‌دادهٔ اجارهٔ memfile.
    \(dqlease\-database\(dq: {
        \(dqtype\(dq: \(dqmemfile\(dq,
        \(dqlfc\-interval\(dq: 3600
    },

    // این پارامتر نحوهٔ دسترسی کارساز به پایگاه‌دادهٔ پیکربندی را کنترل می‌کند.
    // در حال حاضر فقط دو نوع پایگاه‌داده در دسترس است \- \(dqmysql\(dq و
    // \(dqpostgresql\(dq.
    // استفاده از \(dqmysql\(dq نیازمند بارگذاری کتابخانهٔ قلاب libdhcp_mysql.so است.
    // در صورت استفاده از \(dqpostgresql\(dq، بارگذاری کتابخانهٔ قلاب libdhcp_pgsql.so
    // الزامی است.
    \(dqconfig\-control\(dq: {
        // فهرستی از backendهای پایگاه‌داده برای اتصال. در حال حاضر به یک
        // backend محدود است.
        \(dqconfig\-databases\(dq: [
            {
                \(dqtype\(dq: \(dqmysql\(dq,
                \(dqreconnect\-wait\-time\(dq: 3000, // بر حسب میلی‌ثانیه
                \(dqmax\-reconnect\-tries\(dq: 3,
                \(dqname\(dq: \(dqkea\(dq,
                \(dquser\(dq: \(dqkea\(dq,
                \(dqpassword\(dq: \(dq1234\(dq,
                \(dqhost\(dq: \(dqlocalhost\(dq,
                \(dqport\(dq: 3306
            }
        ],
        // کنترل می‌کند که کارساز هر چند وقت یک‌بار برای به‌روزرسانی‌های
        // پیکربندی از پایگاه‌داده بازپرسی کند. تنظیم زیر نشان می‌دهد که
        // کشف و دریافت تغییرات پیکربندی توسط کارساز حداکثر
        // حدود ۲۰ ثانیه طول خواهد کشید.
        \(dqconfig\-fetch\-wait\-time\(dq: 20
    },

    // این مورد یک سوکت کنترلی تعریف می‌کند. در صورت تعریف، Kea یک سوکت UNIX
    // باز کرده و به دستورهای دریافتی گوش می‌دهد. برای جزئیات به بخش ۱۷
    // راهنمای مرجع سرپرست Kea (ARM) مراجعه کنید.
    \(dqcontrol\-socket\(dq: {
        \(dqsocket\-type\(dq: \(dqunix\(dq,
        \(dqsocket\-name\(dq: \(dqkea6\-ctrl\-socket\(dq
    },

    // کتابخانه‌های قلابی که Configuration Backend را فعال می‌کنند بارگذاری شده‌اند.
    \(dqhooks\-libraries\(dq: [
        // کتابخانهٔ libdhcp_mysql.so برای استفاده از Configuration Backend
        // مربوط به MySQL مورد نیاز است.
        {
            \(dqlibrary\(dq: \(dqlibdhcp_mysql.so\(dq
        }
        // در صورت استفاده از Configuration Backend مربوط به PostgreSQL، کتابخانهٔ \(dqlibdhcp_pgsql.so\(dq
        // مورد نیاز است.
        // {
        //    \(dqlibrary\(dq: \(dqlibdhcp_pgsql.so\(dq
        // }
        // کتابخانهٔ libdhcp_cb_cmds.so اختیاری است. این کتابخانه امکان مدیریت
        // پیکربندی در پایگاه‌داده را فراهم می‌کند. اگر این کتابخانه بارگذاری نشود،
        // پیکربندی را می‌توان مستقیماً با استفاده از ابزارهای موجود که مستقیماً با
        // پایگاه‌دادهٔ MySQL کار می‌کنند مدیریت کرد.
        // ,{
        //     \(dqlibrary\(dq: \(dqlibdhcp_cb_cmds.so\(dq
        // }
    ],

    // بخش زیر ثبت وقایع (logging) را پیکربندی می‌کند. فرض بر این است پیام‌هایی با
    // حداقل سطح اطلاعاتی (info،‏ warn،‏ error و fatal) باید در
    // stdout ثبت شوند. در غیر این صورت، می‌توانید stderr، نام یک فایل
    // یا \(aqsyslog\(aq را مشخص کنید، که پیام‌های خروجی را از طریق syslog ذخیره خواهد کرد.
    \(dqloggers\(dq: [
        {
            \(dqname\(dq: \(dqkea\-dhcp6\(dq,
            \(dqoutput\-options\(dq: [
                {
                    \(dqoutput\(dq: \(dqstdout\(dq
                }
            ],
            \(dqdebuglevel\(dq: 0,
            \(dqseverity\(dq: \(dqINFO\(dq
        }
    ]
}

}
.EE
.UNINDENT
.UNINDENT
.SS kea6/dhcpv4\-over\-dhcpv6.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک فایل پیکربندی نمونه برای کارساز DHCPv6 جهت
// آزمایش‌های DHCPv4\-over\-DHCPv6 در Kea است.

{

// پیکربندی DHCPv6
\(dqDhcp6\(dq:
{
  \(dqinterfaces\-config\(dq: {
// فعال‌سازی تک‌پخشی (unicast)
    \(dqinterfaces\(dq: [ \(dqeth0/2001:db8:1::1\(dq ]
  },

  \(dqlease\-database\(dq: {
      \(dqtype\(dq: \(dqmemfile\(dq,
      \(dqname\(dq: \(dqkea\-leases6.csv\(dq
  },

  \(dqpreferred\-lifetime\(dq: 3000,
  \(dqvalid\-lifetime\(dq: 4000,
  \(dqrenew\-timer\(dq: 1000,
  \(dqrebind\-timer\(dq: 2000,

  \(dqsubnet6\(dq: [
   {    \(dqid\(dq: 1,
        \(dqsubnet\(dq: \(dq2001:db8:1:1::/64\(dq,
        \(dqinterface\(dq: \(dqeth0\(dq,
        \(dqpools\(dq: [ { \(dqpool\(dq: \(dq2001:db8:1:1::1:0/112\(dq } ] }
  ],

// این مورد پشتیبانی از DHCPv4\-over\-DHCPv6 را فعال می‌کند
  \(dqdhcp4o6\-port\(dq: 786,

// مورد نیاز برای کلاینت‌های DHCPv4\-over\-DHCPv6
  \(dqoption\-data\(dq: [
   {  \(dqname\(dq: \(dqdhcp4o6\-server\-addr\(dq,
      \(dqcode\(dq: 88,
      \(dqspace\(dq: \(dqdhcp6\(dq,
      \(dqcsv\-format\(dq: true,
// نشانی کارساز را در اینجا قرار دهید
      \(dqdata\(dq: \(dq2001:db8:1:1::1\(dq }
  ],

  \(dqloggers\(dq: [
    {
      \(dqname\(dq: \(dqkea\-dhcp6\(dq,
      \(dqoutput\-options\(dq: [
          {
            \(dqoutput\(dq: \(dqkea\-dhcp6.log\(dq
          }
      ],
      \(dqseverity\(dq: \(dqDEBUG\(dq,
      \(dqdebuglevel\(dq: 0
    }
  ]
}

}
.EE
.UNINDENT
.UNINDENT.SS kea6/duid.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک فایل پیکربندی نمونه برای کارگزار DHCPv6 در Kea است.
// این فایل نحوه پیکربندی Kea را برای استفاده از DUID\-LLT با برخی
// مقادیر مشخص‌شده به صورت صریح نمایش می‌دهد.

{ \(dqDhcp6\(dq:

{

// پیکربندی شناسه کارگزار (DUID\-LLT). مقدار هگزادسیمال شناسه
// به عنوان مؤلفه نشانی لایه پیوند DUID استفاده خواهد شد.
// نوع لایه پیوند ethernet خواهد بود. مقدار time روی 0 تنظیم شده است
// که نشان می‌دهد کارگزار باید این مقدار را تولید کند، یعنی از
// زمان فعلی استفاده کند. توجه داشته باشید که مهاجرت از این پیکربندی
// به DUID\-EN یا DUID\-LL آسان است. این کار مستلزم تغییر مقدار \(dqtype\(dq
// به ترتیب به \(dqEN\(dq یا \(dqLL\(dq است. مقدار \(dqidentifier\(dq شامل
// یک شناسه با طول متغیر DUID\-EN یا نشانی لایه پیوند DUID\-LL خواهد بود.
// مقادیر \(dqtime\(dq و \(dqhtype\(dq برای DUID\-EN نادیده گرفته می‌شوند.
// اگر کسی بخواهد از یک enterprise\-id غیرپیش‌فرض برای DUID\-EN استفاده کند،
// پارامتر \(dqenterprise\-id\(dq باید اضافه شود. توجه داشته باشید که هنگام
// مشخص کردن نگاشت \(dqserver\-id\(dq تنها پارامتر \(dqtype\(dq اجباری است.
  \(dqserver\-id\(dq: {
    \(dqtype\(dq: \(dqLLT\(dq,
    \(dqidentifier\(dq: \(dq12C4D5AF870C\(dq,
    \(dqtime\(dq: 0,
    \(dqhtype\(dq: 1
  },

// به Kea دستور داده شده است که فقط روی رابط eth0 گوش فرا دهد.
  \(dqinterfaces\-config\(dq: {
    \(dqinterfaces\(dq: [ \(dqeth0\(dq ]
  },

// ما باید پایگاه داده مورد استفاده برای ذخیره اجاره‌ها را مشخص کنیم. از
// ژوئن ۲۰۲۲، سه پس‌بند پایگاه داده پشتیبانی می‌شوند: MySQL،
// PostgreSQL و پایگاه داده درون‌حافظه‌ای Memfile.
// ما از memfile استفاده خواهیم کرد زیرا به هیچ راه‌اندازی اولیه‌ای نیاز ندارد.
  \(dqlease\-database\(dq: {
      \(dqtype\(dq: \(dqmemfile\(dq,
      \(dqlfc\-interval\(dq: 3600
  },

// نشانی‌ها با طول عمر ترجیحی (preferred) و معتبر (valid)
// به ترتیب ۳۰۰۰ و ۴۰۰۰ اختصاص خواهند یافت. به کلاینت اعلام می‌شود که پس از
// 1000 ثانیه تمدید را آغاز کند. اگر کارگزار پس از ۲۰۰۰ ثانیه از زمان
// اعطای اجاره پاسخ ندهد، کلاینت باید روال REBIND (تمدید اضطراری که
// امکان جابه‌جایی به یک کارگزار دیگر را می‌دهد) را شروع کند.
  \(dqpreferred\-lifetime\(dq: 3000,
  \(dqvalid\-lifetime\(dq: 4000,
  \(dqrenew\-timer\(dq: 1000,
  \(dqrebind\-timer\(dq: 2000,

// فهرست زیر زیرشبکه‌ها را تعریف می‌کند. هر زیرشبکه حداقل از
// مدخل‌های subnet و pool تشکیل شده است.
  \(dqsubnet6\(dq: [
    {
      \(dqid\(dq: 1,
      \(dqpools\(dq: [ { \(dqpool\(dq: \(dq2001:db8:1::/80\(dq } ],
      \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
      \(dqinterface\(dq: \(dqeth0\(dq
    }
  ],

// بخش زیر گزارش‌گیری را پیکربندی می‌کند. فرض بر این است که پیام‌هایی با حداقل
// سطح اطلاعاتی (info، warn، error) در stdout ثبت خواهند شد.
    \(dqloggers\(dq: [
        {
            \(dqname\(dq: \(dqkea\-dhcp6\(dq,
            \(dqoutput\-options\(dq: [
                {
                    \(dqoutput\(dq: \(dqstdout\(dq
                }
            ],
            \(dqdebuglevel\(dq: 0,
            \(dqseverity\(dq: \(dqINFO\(dq
        }
    ]
}

}
.EE
.UNINDENT
.UNINDENT
.SS kea6/global\-reservations.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک فایل پیکربندی نمونه برای کارگزار DHCPv6 در Kea است.
// این فایل نحوه پیکربندی رزروهای سراسری میزبان را نشان می‌دهد.
// رزروهای سراسری با هیچ زیرشبکه‌ای مرتبط نیستند. آن‌ها صرف‌نظر از
// زیرشبکه‌ای که کلاینت DHCP به آن تعلق دارد، اختصاص می‌یابند.
// رزروهای سراسری با استفاده از همان انواع شناسه میزبان که در رزروهای خاصِ زیرشبکه
// به کار می‌روند، به کلاینت‌های DHCP اختصاص داده می‌شوند. این فایل شامل چندین
// نمونه از رزرو میزبان با استفاده از انواع شناسه‌های مختلف، مانند DUID، نشانی MAC و غیره است.
{ \(dqDhcp6\(dq:

{
// به Kea دستور داده شده است که فقط روی رابط eth0 گوش فرا دهد.
  \(dqinterfaces\-config\(dq: {
    \(dqinterfaces\(dq: [ \(dqeth0\(dq ]
  },

// ما باید پایگاه داده مورد استفاده برای ذخیره اجاره‌ها را مشخص کنیم. از
// ژوئن ۲۰۲۲، سه پس‌بند پایگاه داده پشتیبانی می‌شوند: MySQL،
// PostgreSQL و پایگاه داده درون‌حافظه‌ای Memfile.
// ما از memfile استفاده خواهیم کرد زیرا به هیچ راه‌اندازی اولیه‌ای نیاز ندارد.
  \(dqlease\-database\(dq: {
      \(dqtype\(dq: \(dqmemfile\(dq,
      \(dqlfc\-interval\(dq: 3600
  },

// این موارد بسیار ابتدایی هستند و ارتباطی با رزروها ندارند.
  \(dqpreferred\-lifetime\(dq: 3000,
  \(dqvalid\-lifetime\(dq: 4000,
  \(dqrenew\-timer\(dq: 1000,
  \(dqrebind\-timer\(dq: 2000,

// سامانه Kea از سه نوع شناسه در DHCPv6 پشتیبانی می‌کند: hw\-address (نشانی
// سخت‌افزاری/MAC کلاینت)، duid (شناسه DUID درج‌شده توسط کلاینت) و flex\-id
// (شناسه انعطاف‌پذیر موجود در زمان بارگذاری کتابخانه قلاب flex_id). در صورت
// تعیین، Kea می‌تواند هر یک از این انواع شناسه را بررسی کند، اما انجام این کار
// نیازمند جستجوی پرهزینه در پایگاه داده است. بنابراین از دیدگاه کارایی، مفید است
// که تنها از انواع رزروی استفاده شود که عملاً در شبکه مربوطه به کار می‌روند.
  \(dqhost\-reservation\-identifiers\(dq: [ \(dqduid\(dq, \(dqhw\-address\(dq, \(dqflex\-id\(dq ],

// این دستور به Kea اعلام می‌کند که رزروها سراسری هستند. توجه داشته باشید که این
// مقدار می‌تواند در سطح shared network و/یا subnet نیز مشخص شود.

// مشخص می‌کند که آیا کارگزار باید رزروهای سراسری را جستجو کند یا خیر.
  \(dqreservations\-global\(dq: true,

// مشخص می‌کند که آیا کارگزار باید رزروهای درون زیرشبکه را جستجو کند یا خیر.
  \(dqreservations\-in\-subnet\(dq: false,

// مشخص می‌کند که آیا کارگزار می‌تواند فرض کند که همه نشانی‌های رزروشده
// خارج از استخر هستند یا خیر.
// در صورتی که reservations\-in\-subnet برابر با false باشد، نادیده گرفته می‌شود.
// در صورت تعیین، توسط سطوح \(dqshared\-networks\(dq و \(dqsubnet6\(dq به ارث برده می‌شود.
  \(dqreservations\-out\-of\-pool\(dq: false,

// تعریف چندین رزرو سراسری میزبان.
  \(dqreservations\(dq: [

// این یک رزرو ساده میزبان است. میزبانی که DUID آن با مقدار
// مشخص‌شده مطابقت داشته باشد، نشانی 2001:db8:1::100 را دریافت خواهد کرد.
// توجه داشته باشید که رزرو نشانی‌ها در دامنه سراسری توصیه نمی‌شود اما مجاز است:
// از آنجا که پیوند میان رزرو و زیرشبکه را قطع می‌کند، می‌تواند باعث شود
// کلاینت در زیرشبکه‌ای غیر از زیرشبکه نشانی خود قرار گیرد.
      {
          \(dqduid\(dq: \(dq01:02:03:04:05:0A:0B:0C:0D:0E\(dq,
          \(dqip\-addresses\(dq: [ \(dq2001:db8:1::100\(dq ]
      },

// این مورد شبیه به مورد قبلی است، با این تفاوت که این بار رزرو بر اساس
// نشانی سخت‌افزاری/MAC انجام می‌شود. کارگزار تمام تلاش خود را برای استخراج
// نشانی سخت‌افزاری/MAC از بسته‌های دریافتی به کار می‌گیرد (برای جزئیات به
// دستور \(aqmac\-sources\(aq مراجعه کنید). این رزرو به خصوص همچنین دو گزینه
// اضافی را برای این کلاینت تعیین می‌کند. اگر گزینه‌هایی با کد یکسان در دامنه
// سراسری، زیرشبکه یا کلاس مشخص شده باشند، مقادیر تعریف‌شده در سطح میزبان
// برای این کلاینت خاص DHCP اولویت خواهند داشت.
      {
          \(dqhw\-address\(dq: \(dq00:01:02:03:04:05\(dq,
          \(dqip\-addresses\(dq: [ \(dq2001:db8:1::101\(dq ],
          \(dqoption\-data\(dq: [
              {
                  \(dqname\(dq: \(dqdns\-servers\(dq,
                  \(dqdata\(dq: \(dq3000:1::234\(dq
              },
              {
                  \(dqname\(dq: \(dqnis\-servers\(dq,
                  \(dqdata\(dq: \(dq3000:1::234\(dq
              }
          ],
          \(dqclient\-classes\(dq: [ \(dqspecial_snowflake\(dq, \(dqoffice\(dq ]
      },

// این یک رزرو کمی پیشرفته‌تر است. کلاینت با DUID مشخص‌شده، یک
// نشانی رزروشده، یک پیشوند رزروشده و یک نام میزبان دریافت خواهد کرد.
// حداقل یکی از این سه مورد باید در رزرو تعیین شود.
// در نهایت، این رزرو شامل گزینه‌های ویژه شرکت سازنده برای CableLabs است
// که از enterprise\-id 4491 استفاده می‌کند. این مقادیر خاص فقط به کلاینتی
// بازگردانده می‌شوند که DUID آن با این رزرو مطابقت داشته باشد.
      {
          \(dqduid\(dq: \(dq01:02:03:04:05:06:07:08:09:0A\(dq,
          \(dqip\-addresses\(dq: [ \(dq2001:db8:1:cafe::1\(dq ],
          \(dqprefixes\(dq: [ \(dq2001:db8:2:abcd::/64\(dq ],
          \(dqhostname\(dq: \(dqfoo.example.com\(dq,
          \(dqoption\-data\(dq: [
              {
                  \(dqname\(dq: \(dqvendor\-opts\(dq,
                  \(dqdata\(dq: \(dq4491\(dq
              },
              {
                  \(dqname\(dq: \(dqtftp\-servers\(dq,
                  \(dqspace\(dq: \(dqvendor\-4491\(dq,
                  \(dqdata\(dq: \(dq3000:1::234\(dq
              }
          ]
      },

// این رزرو از شناسه انعطاف‌پذیر استفاده می‌کند. مدیر سیستم
// به جای تکیه بر یک فیلد خاص، می‌تواند عبارتی مشابه آنچه برای دسته‌بندی کلاینت‌ها
// استفاده می‌شود تعریف کند، مانند substring(relay[0].option[17],0,6). سپس
// بر اساس مقدار آن عبارت برای بسته ورودی، رزرو مطابقت داده می‌شود.
// عبارت می‌تواند به صورت هگز یا متن ساده با استفاده از نقل‌قول تکی
// مشخص شود.
// نکته: شناسه انعطاف‌پذیر برای کارکرد به بارگذاری کتابخانه قلاب flex_id
// نیاز دارد.
      {
          \(dqflex\-id\(dq: \(dq\(aqsomevalue\(aq\(dq,
          \(dqip\-addresses\(dq: [ \(dq2001:db8:1:cafe::2\(dq ]
      }
  ],

// فهرست زیر زیرشبکه‌ها را تعریف می‌کند. تعاریف زیرشبکه، استخرها و رابط‌ها
// مشابه سناریوی عادی است.
    \(dqsubnet6\(dq: [
        {
            \(dqid\(dq: 1,

            \(dqsubnet\(dq: \(dq2001:db8::/47\(dq,

            \(dqpools\(dq: [ { \(dqpool\(dq: \(dq2001:db8::/64\(dq } ],

            \(dqpd\-pools\(dq: [
                {
                    \(dqprefix\(dq: \(dq2001:db8:1:8000::\(dq,
                    \(dqprefix\-len\(dq: 56,
                    \(dqdelegated\-len\(dq: 64
                }
            ],
            \(dqinterface\(dq: \(dqeth0\(dq
        }
    ],

// بخش زیر گزارش‌گیری را پیکربندی می‌کند. فرض بر این است که پیام‌هایی با
// حداقل سطح اطلاعاتی (info، warn، error و fatal) باید در
// stdout ثبت شوند.
    \(dqloggers\(dq: [
        {
            \(dqname\(dq: \(dqkea\-dhcp6\(dq,
            \(dqoutput\-options\(dq: [
                {
                    \(dqoutput\(dq: \(dqstdout\(dq
                }
            ],
            \(dqdebuglevel\(dq: 0,
            \(dqseverity\(dq: \(dqINFO\(dq
        }
    ]
}

}
.EE
.UNINDENT
.UNINDENT.SS kea6/ha\-hot\-standby\-server1\-with\-tls.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک پیکربندی نمونه از کارگزار Kea DHCPv6 است. این پیکربندی از کتابخانه
// قلاب High Availability و کتابخانه قلاب Lease Commands برای فعال‌سازی
// قابلیت دسترسی‌پذیری بالا (HA) برای کارگزار DHCP استفاده می‌کند. توجه داشته باشید
// که تقریباً دقیقاً همین پیکربندی باید در کارگزار دوم (شریک) استفاده شود.
// تنها تفاوت این است که \(dqthis\-server\-name\(dq در آن کارگزار دیگر باید روی
// \(dqserver2\(dq تنظیم شود. همچنین، پیکربندی رابط و مکان فایل‌های مربوط به
// TLS به تنظیمات شبکه و پیکربندی آن دستگاه خاص بستگی دارد.
//
// کارگزارهایی که از این پیکربندی استفاده می‌کنند در حالت hot standby کار می‌کنند.
{

// پیکربندی DHCPv6 از اینجا شروع می‌شود.
\(dqDhcp6\(dq: {
    // نام‌های رابط‌های شبکه خود را برای شنود اضافه کنید.
    \(dqinterfaces\-config\(dq: {
        // کارگزار DHCPv6 روی این رابط شنود می‌کند.
        \(dqinterfaces\(dq: [ \(dqeth0\(dq ]
    },

    // استفاده از پسانه پایگاه‌داده اجاره Memfile برای ذخیره اجاره‌ها در یک فایل CSV.
    // بسته به نحوه کامپایل Kea، ممکن است از پایگاه‌های داده SQL نیز پشتیبانی کند
    // (MySQL و/یا PostgreSQL). آن پسانه‌های پایگاه‌داده به پارامترهای بیشتری مانند
    // name، host و احتمالاً user و password نیاز دارند.
    // برای هر پسانه مثال‌های اختصاصی وجود دارد. برای جزئیات به بخش 7.2.2
    // \(dqLease Storage\(dq مراجعه کنید.
    \(dqlease\-database\(dq: {
        // Memfile ساده‌ترین و آسان‌ترین پسانه برای استفاده است. این یک پسانه درون‌حافظه‌ای است
        \(dqtype\(dq: \(dqmemfile\(dq
    },

    // قابلیت HA نیازمند بارگذاری دو کتابخانه قلاب است: libdhcp_lease_cmds.so و
    // libdhcp_ha.so. اولی به‌روزرسانی‌های ورودی اجاره از همتایان HA را مدیریت می‌کند.
    // دومی قابلیت دسترسی‌پذیری بالا را برای Kea پیاده‌سازی می‌کند.
    \(dqhooks\-libraries\(dq: [
        // کتابخانه lease_cmds باید بارگذاری شود زیرا HA از آن برای تحویل
        // به‌روزرسانی‌های اجاره به کارگزار و همچنین همگام‌سازی پایگاه‌داده
        // اجاره پس از خرابی استفاده می‌کند.
        {
            \(dqlibrary\(dq: \(dqlibdhcp_lease_cmds.so\(dq,
            \(dqparameters\(dq: { }
        },
        {
            // کتابخانه قلاب HA باید بارگذاری شود.
            \(dqlibrary\(dq: \(dqlibdhcp_ha.so\(dq,
            \(dqparameters\(dq: {
                // پیکربندی دسترسی‌پذیری بالا برای کتابخانه قلاب HA مشخص شده است.
                // هر کارگزار باید پیکربندی HA یکسانی داشته باشد، به جز
                // پارامتر \(dqthis\-server\-name\(dq.
                \(dqhigh\-availability\(dq: [ {
                    // این پارامتر به این نمونه کارگزار اشاره دارد. همتایان HA
                    // مربوطه باید این پارامتر را روی نام‌های خودشان تنظیم کنند.
                    \(dqthis\-server\-name\(dq: \(dqserver1\(dq,
                    // حالت HA روی hot\-standby تنظیم شده است. این کارگزار به‌روزرسانی‌های
                    // اجاره را از سرور اصلی دریافت خواهد کرد. سرور اصلی به تمام
                    // پرس‌وجوهای DHCP پاسخ خواهد داد.
                    \(dqmode\(dq: \(dqhot\-standby\(dq,
                    // اگر هیچ دستور کنترلی دیگری ارسال نشود، ضربان قلب (heartbeat)
                    // باید هر ۱۰ ثانیه فرستاده شود.
                    \(dqheartbeat\-delay\(dq: 10000,
                    // حداکثر زمان برای پاسخ شریک به ضربان قلب، که پس از آن
                    // تشخیص خرابی آغاز می‌شود. این مقدار به میلی‌ثانیه مشخص می‌شود.
                    \(dqmax\-response\-delay\(dq: 60000,
                    // پارامترهای زیر نحوه تشخیص خرابی شریک توسط کارگزار را کنترل
                    // می‌کنند. تاخیر ACK آستانه را برای فیلد \(aqsecs\(aq پیام‌های کشف
                    // دریافت‌شده تنظیم می‌کند. این مقدار به میلی‌ثانیه مشخص می‌شود.
                    \(dqmax\-ack\-delay\(dq: 5000,
                    // این پارامتر تعداد کلاینت‌هایی را مشخص می‌کند که پیام‌هایی
                    // به شریک ارسال می‌کنند اما به نظر می‌رسد پاسخی دریافت نمی‌کنند.
                    \(dqmax\-unacked\-clients\(dq: 5,
                    // مرجع اعتماد (trust anchor) یا همان فایل یا دایرکتوری مرجع صدور گواهی (CA).
                    \(dqtrust\-anchor\(dq: \(dq/usr/lib/kea/CA.pem\(dq,
                    // نام فایل گواهی کلاینت.
                    \(dqcert\-file\(dq: \(dq/usr/lib/kea/server_cert.pem\(dq,
                    // نام فایل کلید خصوصی.
                    \(dqkey\-file\(dq: \(dq/usr/lib/kea/server_key.pem\(dq,
                    // گواهی‌های کلاینت الزامی هستند و تایید اعتبار می‌شوند.
                    \(dqrequire\-client\-certs\(dq: true,
                    \(dqpeers\(dq: [
                        // این پیکربندیِ این نمونه کارگزار است.
                        {
                            \(dqname\(dq: \(dqserver1\(dq,
                            // این پارامتر نشانی URL این نمونه کارگزار را مشخص می‌کند.
                            \(dqurl\(dq: \(dqhttp://192.168.56.33:8007\(dq,
                            // این کارگزار primary (اصلی) است. کارگزار دیگر باید
                            // standby (آماده‌به‌خدمت) باشد.
                            \(dqrole\(dq: \(dqprimary\(dq
                        },
                        // این پیکربندی همتای HA است.
                        {
                            \(dqname\(dq: \(dqserver2\(dq,
                            // نشانی URL را مشخص می‌کند که کانال کنترلی شریک
                            // روی آن در دسترس است.
                            \(dqurl\(dq: \(dqhttp://192.168.56.66:8007\(dq,
                            // شریک standby است. این کارگزار primary است.
                            \(dqrole\(dq: \(dqstandby\(dq
                        }
                    ]
                } ]
            }
        }
    ],

    // فهرست زیر زیرشبکه‌ها را تعریف می‌کند. هر زیرشبکه حداقل شامل
    // ورودی‌های subnet و pool است.
    \(dqsubnet6\(dq: [
        {
            \(dqid\(dq: 1,

            \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,

            \(dqpools\(dq: [
                {
                    \(dqpool\(dq: \(dq2001:db8:1::100 \- 2001:db8:1::250\(dq
                }
            ],

             \(dqinterface\(dq: \(dqeth0\(dq
        }
    ],

// بخش زیر ثبت گزارش را پیکربندی می‌کند. فرض می‌شود که پیام‌هایی با حداقل
// سطح اطلاعاتی (info، warn، error و fatal) باید در stdout ثبت شوند.
// به عنوان روش جایگزین، می‌توانید stderr، یک نام فایل یا \(aqsyslog\(aq را
// در اینجا مشخص کنید که پیام‌های خروجی را از طریق syslog ذخیره می‌کند.
    \(dqloggers\(dq: [
        {
            // این بخش بر kea\-dhcp6 اثر می‌گذارد که گزارش‌گر پایه برای مولفه
            // DHCPv6 است. این بخش به کارگزار DHCPv6 می‌گوید که همه پیام‌های
            // گزارش (با سطح اهمیت INFO یا بیشتر) را در یک فایل بنویسد.
            \(dqname\(dq: \(dqkea\-dhcp6\(dq,
            \(dqoutput\-options\(dq: [
                {
                    \(dqoutput\(dq: \(dqstdout\(dq
                }
            ],
            \(dqseverity\(dq: \(dqINFO\(dq,
            \(dqdebuglevel\(dq: 0
        },
        {
            // این بخش پیکربندی گزارش‌گر مخصوص کتابخانه قلاب HA را مشخص می‌کند.
            \(dqname\(dq: \(dqkea\-dhcp6.ha\-hooks\(dq,
            \(dqoutput\-options\(dq: [
                {
                    \(dqoutput\(dq: \(dqstdout\(dq
                }
            ],
            \(dqseverity\(dq: \(dqINFO\(dq,
            \(dqdebuglevel\(dq: 99
        }
    ]
}
}
.EE
.UNINDENT
.UNINDENT.SS kea6/ha\-hot\-standby\-server2.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک پیکربندی نمونه از کارساز Kea DHCPv6 است. این پیکربندی از کتابخانه
// قلاب دسترسی‌پذیری بالا (High Availability) و کتابخانه قلاب دستورات اجاره
// (Lease Commands) برای فعال‌سازی قابلیت دسترسی‌پذیری بالا برای کارساز DHCP استفاده می‌کند.
// توجه داشته باشید که تقریباً دقیقاً همین پیکربندی باید در کارساز دوم (همتا/partner)
// استفاده شود. تنها تفاوت این است که \(dqthis\-server\-name\(dq روی آن کارساز دیگر
// باید روی \(dqserver1\(dq تنظیم شود. همچنین، پیکربندی رابط به تنظیمات شبکه ماشین
// مربوطه بستگی دارد.
//
// کارسازهایی که از این پیکربندی استفاده می‌کنند در حالت hot standby کار می‌کنند.
{

// پیکربندی DHCPv6 از اینجا آغاز می‌شود.
\(dqDhcp6\(dq: {
    // نام‌های رابط‌های شبکه خود را برای گوش فرا دادن اضافه کنید.
    \(dqinterfaces\-config\(dq: {
        // کارساز DHCPv6 روی این رابط گوش فرا می‌دهد.
        \(dqinterfaces\(dq: [ \(dqeth0\(dq ]
    },

    // برای ذخیره اجاره‌ها در یک فایل CSV از backend پایگاه‌داده اجاره Memfile استفاده کنید.
    // بسته به نحوه کامپایل Kea، ممکن است از پایگاه‌های داده SQL نیز پشتیبانی کند
    // (MySQL و/یا PostgreSQL). این backendهای پایگاه‌داده به پارامترهای بیشتری
    // نیاز دارند، مانند name،‏ host و احتمالاً user و password.
    // مثال‌های اختصاصی برای هر backend وجود دارد. برای جزئیات به بخش 7.2.2 \(dqLease
    // Storage\(dq مراجعه کنید.
    \(dqlease\-database\(dq: {
        // ‏Memfile ساده‌ترین و آسان‌ترین backend برای استفاده است. این یک [پایگاه‌داده] درون‌حافظه‌ای است
        \(dqtype\(dq: \(dqmemfile\(dq
    },

    // قابلیت HA نیازمند بارگذاری دو کتابخانه قلاب است: libdhcp_lease_cmds.so و
    // libdhcp_ha.so. اولی به‌روزرسانی‌های دریافتی اجاره را از همتایان HA مدیریت می‌کند.
    // دومی قابلیت دسترسی‌پذیری بالا را برای Kea پیاده‌سازی می‌کند.
    \(dqhooks\-libraries\(dq: [
        // کتابخانه lease_cmds باید بارگذاری شود زیرا HA از آن برای تحویل
        // به‌روزرسانی‌های اجاره به کارساز و همچنین همگام‌سازی پایگاه‌داده اجاره
        // پس از خرابی استفاده می‌کند.
        {
            \(dqlibrary\(dq: \(dqlibdhcp_lease_cmds.so\(dq,
            \(dqparameters\(dq: { }
        },
        {
            // کتابخانه قلاب HA باید بارگذاری شود.
            \(dqlibrary\(dq: \(dqlibdhcp_ha.so\(dq,
            \(dqparameters\(dq: {
                // پیکربندی دسترسی‌پذیری بالا برای کتابخانه قلاب HA مشخص شده است.
                // هر کارساز باید پیکربندی HA یکسانی داشته باشد، به جز
                // پارامتر \(dqthis\-server\-name\(dq.
                \(dqhigh\-availability\(dq: [ {
                    // این پارامتر به این نمونه کارساز اشاره می‌کند. همتایان HA
                    // مربوطه باید این پارامتر را روی نام‌های خود تنظیم کرده باشند.
                    \(dqthis\-server\-name\(dq: \(dqserver2\(dq,
                    // حالت HA روی hot\-standby تنظیم شده است. این کارساز به‌روزرسانی‌های
                    // اجاره را از primary دریافت خواهد کرد. کارساز primary به تمامی
                    // پرس‌وجوهای DHCP پاسخ خواهد داد.
                    \(dqmode\(dq: \(dqhot\-standby\(dq,
                    // در صورت عدم انتقال دستورات کنترلی دیگر، ضربان قلب (heartbeat)
                    // باید هر ۱۰ ثانیه یک‌بار ارسال شود.
                    \(dqheartbeat\-delay\(dq: 10000,
                    // حداکثر زمان برای پاسخ شریک به ضربان قلب، که پس از آن
                    // تشخیص خرابی آغاز می‌شود. این مقدار به میلی‌ثانیه مشخص شده است.
                    \(dqmax\-response\-delay\(dq: 60000,
                    // پارامترهای زیر نحوه تشخیص خرابی شریک توسط کارساز را کنترل
                    // می‌کنند. تأخیر ACK آستانه را برای فیلد \(aqsecs\(aq از discoverهای
                    // دریافتی تنظیم می‌کند. این مقدار به میلی‌ثانیه مشخص شده است.
                    \(dqmax\-ack\-delay\(dq: 5000,
                    // این پارامتر تعداد کلاینت‌هایی را مشخص می‌کند که به شریک پیام
                    // ارسال می‌کنند اما به نظر می‌رسد پاسخی دریافت نمی‌کنند.
                    \(dqmax\-unacked\-clients\(dq: 5,
                    \(dqpeers\(dq: [
                        // این پیکربندی همتای HA است.
                        {
                            \(dqname\(dq: \(dqserver1\(dq,
                            // نشانی URL را مشخص می‌کند که از طریق آن می‌توان به کانال
                            // کنترلی شریک دسترسی پیدا کرد.
                            \(dqurl\(dq: \(dqhttp://192.168.56.33:8007/\(dq,
                            // شریک primary است. این کارساز standby است.
                            \(dqrole\(dq: \(dqprimary\(dq
                        },
                        // این پیکربندی نمونه این کارساز است.
                        {
                            \(dqname\(dq: \(dqserver2\(dq,
                            // این مقدار نشانی URL مربوط به نمونه این کارساز را مشخص می‌کند.
                            \(dqurl\(dq: \(dqhttp://192.168.56.66:8007/\(dq,
                            // این کارساز standby است. کارساز دیگر باید
                            // primary باشد.
                            \(dqrole\(dq: \(dqstandby\(dq
                        }
                    ]
                } ]
            }
        }
    ],

    // فهرست زیر زیرشبکه‌ها را تعریف می‌کند. هر زیرشبکه حداقل از
    // مدخل‌های subnet و pool تشکیل شده است.
    \(dqsubnet6\(dq: [
        {
            \(dqid\(dq: 1,

            \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,

            \(dqpools\(dq: [
                {
                    \(dqpool\(dq: \(dq2001:db8:1::100 \- 2001:db8:1::250\(dq
                }
            ],

             \(dqinterface\(dq: \(dqeth0\(dq
        }
    ],

// بخش زیر ثبت وقایع را پیکربندی می‌کند. فرض بر این است که پیام‌ها حداقل
// در سطح اطلاعاتی (info،‏ warn،‏ error و fatal) باید در stdout ثبت شوند.
// به عنوان جایگزین، می‌توانید در اینجا stderr، یک نام فایل یا \(aqsyslog\(aq
// را مشخص کنید که پیام‌های خروجی را از طریق syslog ذخیره می‌کند.
    \(dqloggers\(dq: [
        {
            // این بخش بر kea\-dhcp6 که ثبت‌کننده وقایع پایه برای مؤلفه DHCPv6
            // است تأثیر می‌گذارد. این بخش به کارساز DHCPv6 می‌گوید تا تمام پیام‌های
            // ثبت وقایع (با سطح اهمیت INFO یا بالاتر) را در یک فایل بنویسد.
            \(dqname\(dq: \(dqkea\-dhcp6\(dq,
            \(dqoutput\-options\(dq: [
                {
                    \(dqoutput\(dq: \(dqstdout\(dq
                }
            ],
            \(dqseverity\(dq: \(dqINFO\(dq,
            \(dqdebuglevel\(dq: 0
        },
        {
            // این بخش پیکربندی ثبت‌کننده وقایع اختصاصی کتابخانه قلاب HA
            // را مشخص می‌کند.
            \(dqname\(dq: \(dqkea\-dhcp6.ha\-hooks\(dq,
            \(dqoutput\-options\(dq: [
                {
                    \(dqoutput\(dq: \(dqstdout\(dq
                }
            ],
            \(dqseverity\(dq: \(dqINFO\(dq,
            \(dqdebuglevel\(dq: 99
        }
    ]
}
}
.EE
.UNINDENT
.UNINDENT.SS kea6/hooks\-rbac.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک فایل پیکربندی نمونه برای کارساز DHCPv6 در Kea با استفاده از
// کتابخانه قلاب کنترل دسترسی بر پایه نقش (RBAC) است. این پیکربندی از سناریوی پایه
// یک زیرشبکه IPv6 که با مقادیر پیش‌فرض برای همه پارامترها پیکربندی شده، استفاده می‌کند.

{\(dqDhcp6\(dq:

{
// به Kea اعلام شده است که تنها روی رابط eth0 شنود کند.
  \(dqinterfaces\-config\(dq: {
    \(dqinterfaces\(dq: [ \(dqeth0\(dq ]
  },

// راه‌اندازی فضای ذخیره‌سازی برای اجاره‌ها (leases).
  \(dqlease\-database\(dq: {
    \(dqtype\(dq: \(dqmemfile\(dq
  },

// تنظیم مقادیر برای زمان‌سنج‌های اجباری
  \(dqrenew\-timer\(dq: 900,
  \(dqrebind\-timer\(dq: 1200,
  \(dqpreferred\-lifetime\(dq: 1800,
  \(dqvalid\-lifetime\(dq: 2700,

// تعریف یک زیرشبکه تکی.
  \(dqsubnet6\(dq: [
    {
      \(dqid\(dq: 1,
      \(dqpools\(dq: [
        {
          \(dqpool\(dq: \(dq2001:db8:1::/80\(dq,
          \(dquser\-context\(dq: { \(dqcharging\(dq: true }
        } ],
      \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
      \(dqinterface\(dq: \(dqeth0\(dq
    }
  ],

// سوکت‌های کنترلی.
  \(dqcontrol\-sockets\(dq: [
    {
      \(dqsocket\-type\(dq: \(dqhttps\(dq,
      \(dqsocket\-address\(dq: \(dq::1\(dq,
      \(dqsocket\-port\(dq: 8000,
      \(dqtrust\-anchor\(dq: \(dqmy\-ca\(dq,
      \(dqcert\-file\(dq: \(dqmy\-cert\(dq,
      \(dqkey\-file\(dq: \(dqmy\-key\(dq,
      \(dqcert\-required\(dq: true
    }
  ],

// افزودن قلاب‌ها (hooks) در اینجا.
  \(dqhooks\-libraries\(dq: [
    {
      \(dqlibrary\(dq: \(dqlibdhcp_rbac.so\(dq,
      \(dqparameters\(dq: {
          // این بخش کتابخانه قلاب RBAC را پیکربندی می‌کند.
          // پارامترهای اجباری.
          \(dqassign\-role\-method\(dq: \(dqcert\-subject\(dq,
          \(dqapi\-files\(dq: \(dq/opt/share/kea/api\(dq,
          // پارامترهای اختیاری.
          \(dqrequire\-tls\(dq: true,
          \(dqcommands\(dq: [
          {
              \(dqname\(dq: \(dqmy\-command\(dq,
              \(dqaccess\(dq: \(dqread\(dq,
              \(dqhook\(dq: \(dqmy\-hook\(dq
          } ],
          \(dqaccess\-control\-lists\(dq: [
          {
              \(dqmy\-none\(dq: { \(dqnot\(dq: \(dqALL\(dq }
          },{
              \(dqanother\-none\(dq: { \(dqand\(dq: [ \(dqALL\(dq, \(dqNONE\(dq ] }
          },{
              \(dqmy\-read\(dq: { \(dqaccess\(dq: \(dqread\(dq }
          } ],
          \(dqroles\(dq: [
          {
              \(dqname\(dq: \(dqkea\-client\(dq,
              \(dqaccept\-commands\(dq:
              {
                  \(dqcommands\(dq: [ \(dqlist\-commands\(dq, \(dqstatus\-get\(dq ]
              },
              \(dqreject\-commands\(dq: \(dqNONE\(dq,
              \(dqother\-commands\(dq: \(dqreject\(dq,
              \(dqlist\-match\-first\(dq: \(dqaccept\(dq,
              \(dqresponse\-filters\(dq: [ \(dqlist\-commands\(dq ]
          },{
              \(dqname\(dq: \(dqadmin\(dq,
              \(dqaccept\-commands\(dq: \(dqALL\(dq,
              \(dqreject\-commands\(dq:
              {
                  \(dqhook\(dq: \(dqcb_cmds\(dq
              },
              \(dqlist\-match\-first\(dq: \(dqreject\(dq
          } ],
          \(dqdefault\-role\(dq:
          {
              \(dqaccept\-commands\(dq: \(dqNONE\(dq,
              \(dqreject\-commands\(dq: \(dqALL\(dq
          },
          \(dqunknown\-role\(dq:
          {
              \(dqaccept\-commands\(dq: \(dqREAD\(dq,
              \(dqreject\-commands\(dq: \(dqWRITE\(dq
          }
      }
    }
  ]
}

}
.EE
.UNINDENT
.UNINDENT
.SS kea6/hooks.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک فایل پیکربندی نمونه برای کارساز DHCPv6 در Kea است که
// نحوه پیکربندی کتابخانه‌های قلاب را نشان می‌دهد. این پیکربندی از سناریوی پایه
// یک زیرشبکه IPv6 که با مقادیر پیش‌فرض برای همه پارامترها پیکربندی شده، استفاده می‌کند.

{\(dqDhcp6\(dq:

{
// به Kea اعلام شده است که تنها روی رابط eth0 شنود کند.
  \(dqinterfaces\-config\(dq: {
    \(dqinterfaces\(dq: [ \(dqeth0\(dq ]
  },

// راه‌اندازی فضای ذخیره‌سازی برای اجاره‌ها (leases).
  \(dqlease\-database\(dq: {
    \(dqtype\(dq: \(dqmemfile\(dq
  },

// تنظیم مقادیر برای زمان‌سنج‌های اجباری
  \(dqrenew\-timer\(dq: 900,
  \(dqrebind\-timer\(dq: 1200,
  \(dqpreferred\-lifetime\(dq: 1800,
  \(dqvalid\-lifetime\(dq: 2700,

// تعریف یک زیرشبکه تکی.
  \(dqsubnet6\(dq: [
    {
      \(dqid\(dq: 1,
      \(dqpools\(dq: [
        {
          \(dqpool\(dq: \(dq2001:db8:1::/80\(dq,
          \(dquser\-context\(dq: { \(dqcharging\(dq: true }
        } ],
      \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
      \(dqinterface\(dq: \(dqeth0\(dq
    }
  ],

// راه‌اندازی کتابخانه‌های قلاب. برای این مثال، فرض می‌کنیم دو کتابخانه به نام‌های
// \(dqsecurity\(dq و \(dqcharging\(dq بارگذاری شده‌اند. توجه داشته باشید که ترتیب مهم است:
// ابتدا \(dqsecurity\(dq مشخص شده است، بنابراین اگر هر دو کتابخانه یک تابع قلاب
// برای یک قلاب مشخص ارائه دهند، تابع موجود در \(dqsecurity\(dq پیش از تابع موجود در
// \(dqcharging\(dq فراخوانی خواهد شد.

  \(dqhooks\-libraries\(dq: [
     {
        \(dqlibrary\(dq: \(dqsecurity.so\(dq
     },
     {
        \(dqlibrary\(dq: \(dqcharging.so\(dq,
        \(dqparameters\(dq: {
             \(dqpath\(dq: \(dq/var/log/kea\(dq,
             \(dqbase\-name\(dq: \(dqkea\-forensic6\(dq
        }
     }
  ]
}

}
.EE
.UNINDENT
.UNINDENT.SS kea6/iPXE.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک پیکربندی نمونه برای بوت iPXE در Kea6 است.

{
   \(dqDhcp6\(dq: {
   // بخش اجباری پیکربندی که رابط‌هایی را فهرست می‌کند که
   // Kea روی آن‌ها به ترافیک ورودی گوش خواهد داد.
      \(dqinterfaces\-config\(dq: {
         \(dqinterfaces\(dq: [ \(dqeth0\(dq ]
      },

// دو کلاس از نمونه ISC\-DHCP مهاجرت داده شده‌اند:
// if exists dhcp6.client\-arch\-type and
//    option dhcp6.client\-arch\-type = 00:07 {
//    option dhcp6.bootfile\-url \(dqhttp://[2001:db8::1]/ipxe.efi\(dq;
// } else if exists dhcp6.user\-class and
//          substring(option dhcp6.user\-class, 2, 4) = \(dqiPXE\(dq {
//    option dhcp6.bootfile\-url \(dqhttp://[2001:db8::1]/ubuntu.cfg\(dq;
// }

// در مثال نشان‌داده‌شده در زیر، اگر بسته ورودی شامل گزینه user class
// حاوی \(dqiPXE\(dq باشد، مقدار http://[2001:db8::1]/ubuntu.cfg
// را دریافت می‌کند و اگر گزینه نوع معماری کلاینت برابر با 7 باشد،
// مقدار http://[2001:db8::1]/ipxe.efi را دریافت خواهد کرد.
// اگر بسته ورودی شامل هر دوی این گزینه‌ها با مقادیر منطبق باشد، به کلاس
// \(dqa\-ipxe\(dq اختصاص می‌یابد زیرا نخستین کلاس منطبق بوده است. اگر می‌خواهید
// آن ترتیب را تغییر دهید، نام‌های کلاس‌ها باید ترتیب الفبایی متفاوتی
// داشته باشند. در Kea 1.3.0 (و نسخه‌های پیشین) از ترتیب الفبایی در
// دسته‌بندی استفاده می‌شود. توجه داشته باشید که این مورد در نسخه‌های بعدی
// باید تغییر کند، برای نمونه جهت حفظ ترتیب تعریف.
      \(dqclient\-classes\(dq: [
         {
            \(dqname\(dq: \(dqa\-ipxe\(dq,
            // گزینه user\-class (کد 15) یک آرایه از تاپل‌ها است
            // بنابراین باید از طول (عنصر اول تاپل) صرف‌نظر کنیم
            \(dqtest\(dq: \(dqsubstring(option[15].hex, 2, 4) == \(aqiPXE\(aq\(dq,
            \(dqoption\-data\(dq: [
               {
                  \(dqspace\(dq: \(dqdhcp6\(dq,
                  \(dqname\(dq: \(dqbootfile\-url\(dq,
                  \(dqcode\(dq: 59,
                  \(dqdata\(dq: \(dqhttp://[2001:db8::1]/ubuntu.cfg\(dq
               }
            ]
         },
         {
            \(dqname\(dq: \(dqb\-efi\(dq,
            // لطفاً برای تحمیل \(dqelse\(dq، افزودن یک
            // not a\-ipxe را در اینجا در نظر بگیرید؟
            \(dqtest\(dq: \(dqoption[61].hex == 0x0007\(dq,
            \(dqoption\-data\(dq: [
               {
                  \(dqspace\(dq: \(dqdhcp6\(dq,
                  \(dqname\(dq: \(dqbootfile\-url\(dq,
                  \(dqcode\(dq: 59,
                  \(dqdata\(dq: \(dqhttp://[2001:db8::1]/ipxe.efi\(dq
               }
            ]
         }
      ],
      \(dqsubnet6\(dq: [
         {
            \(dqid\(dq: 1,
            \(dqsubnet\(dq: \(dq2001:db8::/64\(dq
         }
      ]
   }
}
.EE
.UNINDENT
.UNINDENT
.SS kea6/leases\-expiration.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک فایل پیکربندی نمونه برای کارساز DHCPv6 در Kea است.
// این فایل پارامترهای کنترل پردازش اجاره‌های منقضی‌شده،
// معروف به بازپس‌گیری اجاره‌ها (leases reclamation) را ارائه می‌دهد.

{ \(dqDhcp6\(dq:

{
// به Kea گفته شده است که تنها روی رابط eth0 گوش فرا دهد.
  \(dqinterfaces\-config\(dq: {
    \(dqinterfaces\(dq: [ \(dqeth0\(dq ]
  },

// باید پایگاه‌داده مورد استفاده برای ذخیره اجاره‌ها را مشخص کنیم. تا
// ژوئن 2022، سه پسانه پایگاه‌داده پشتیبانی می‌شوند: MySQL،
// PostgreSQL و پایگاه‌داده درون‌حافظه‌ای Memfile.
// ما از memfile استفاده می‌کنیم زیرا به هیچ راه‌اندازی اولیه‌ای نیاز ندارد.
// توجه کنید که حداکثر تعداد خطاهای خواندن ردیف را روی 100 تنظیم می‌کنیم،
// (پیش‌فرض 0 است، به معنای نامحدود).
  \(dqlease\-database\(dq: {
      \(dqtype\(dq: \(dqmemfile\(dq,
      \(dqlfc\-interval\(dq: 3600,
      \(dqmax\-row\-errors\(dq: 100
  },

// پارامترهای زیر پردازش اجاره‌های منقضی‌شده را کنترل می‌کنند. اجاره‌های
// منقضی‌شده به صورت دوره‌ای بر اساس پارامتر \(dqreclaim\-timer\-wait\-time\(dq
// بازپس‌گرفته می‌شوند. اجاره‌های بازپس‌گرفته‌شده برای تسهیل قرابت اجاره
// (lease affinity) به مدت 1800 ثانیه در پایگاه‌داده نگهداری خواهند شد. پس از این
// دوره، اجاره‌ها حذف خواهند شد. بسامد حذف توسط پارامتر
// \(dqflush\-reclaimed\-timer\-wait\-time\(dq کنترل می‌شود. روال بازپس‌گیری اجاره
// در طول یک بار اجرا، حداکثر 500 اجاره را پردازش می‌کند یا حداکثر
// 100 میلی‌ثانیه به طول می‌انجامد. اگر پس از 10 تلاش همچنان اجاره‌های
// بازپس‌گرفته‌نشده‌ای باقی مانده باشد، یک پیام هشدار صادر می‌شود.
// اگر هر دو پارامتر \(dqflush\-reclaimed\-timer\-wait\-time\(dq و \(dqhold\-reclaimed\-time\(dq
// غیر از 0 باشند، هنگامی که کلاینت یک پیام release می‌فرستد، اجاره به جای
// حذف شدن از فضای ذخیره‌سازی اجاره، منقضی می‌شود.
  \(dqexpired\-leases\-processing\(dq: {
    \(dqreclaim\-timer\-wait\-time\(dq: 5,
    \(dqhold\-reclaimed\-time\(dq: 1800,
    \(dqflush\-reclaimed\-timer\-wait\-time\(dq: 10,
    \(dqmax\-reclaim\-leases\(dq: 500,
    \(dqmax\-reclaim\-time\(dq: 100,
    \(dqunwarned\-reclaim\-cycles\(dq: 10
  },

// نشانی‌ها به ترتیب با طول‌عمرهای ترجیحی و معتبر برابر با
// 3000 و 4000 تخصیص می‌یابند. به کلاینت گفته می‌شود که تجدید
// را پس از 1000 ثانیه آغاز کند. اگر کارساز پس از گذشت 2000 ثانیه از
// اعطای اجاره پاسخ ندهد، کلاینت باید روال REBIND را آغاز کند
// (تجدید اضطراری که امکان جابه‌جایی به یک کارساز دیگر را فراهم می‌کند).
  \(dqpreferred\-lifetime\(dq: 3000,
  \(dqvalid\-lifetime\(dq: 4000,
  \(dqrenew\-timer\(dq: 1000,
  \(dqrebind\-timer\(dq: 2000,

// فهرست زیر زیرشبکه‌ها را تعریف می‌کند. هر زیرشبکه حداقل از
// مدخل‌های subnet و pool تشکیل شده است.
  \(dqsubnet6\(dq: [
    {
      \(dqid\(dq: 1,
      \(dqpools\(dq: [ { \(dqpool\(dq: \(dq2001:db8:1::/80\(dq } ],
      \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
      \(dqinterface\(dq: \(dqeth0\(dq
    }
  ],

// موارد زیر ثبت وقایع را پیکربندی می‌کنند. فرض بر این است که پیام‌هایی
// با حداقل سطح اطلاعاتی (info، warn، error و fatal) باید در
// stdout ثبت شوند.
    \(dqloggers\(dq: [
        {
            \(dqname\(dq: \(dqkea\-dhcp6\(dq,
            \(dqoutput\-options\(dq: [
                {
                    \(dqoutput\(dq: \(dqstdout\(dq
                }
            ],
            \(dqdebuglevel\(dq: 0,
            \(dqseverity\(dq: \(dqINFO\(dq
        }
    ]
}

}
.EE
.UNINDENT
.UNINDENT.SS kea6/multiple\-options.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک فایل پیکربندی نمونه برای کارساز DHCPv6 در Kea است.
// این فایل، پیکربندی ساده گزینه‌ها برای یک زیرشبکه را نشان می‌دهد.

{ \(dqDhcp6\(dq:

{
// به Kea اعلام شده است که تنها روی رابط eth0 شنود کند.
  \(dqinterfaces\-config\(dq: {
    \(dqinterfaces\(dq: [ \(dqeth0\(dq ]
  },

// باید پایگاه‌داده مورد استفاده برای ذخیره اجاره‌ها را مشخص کنیم. تا تاریخ
// ژوئن ۲۰۲۲، سه پسانه پایگاه‌داده پشتیبانی می‌شوند: MySQL،
// PostgreSQL و پایگاه‌داده درون‌حافظه‌ای Memfile.
// ما از memfile استفاده خواهیم کرد، چرا که نیازی به هیچ راه‌اندازی اولیه‌ای ندارد.
  \(dqlease\-database\(dq: {
    \(dqtype\(dq: \(dqmemfile\(dq
  },

// نشانی‌ها با طول‌عمرهای ترجیحی و معتبر که به ترتیب ۳۰۰۰ و ۴۰۰۰
// ثانیه هستند تخصیص داده می‌شوند. به کارگیر گفته می‌شود که پس از ۱۰۰۰
// ثانیه تمدید را آغاز کند. اگر کارساز پس از گذشت ۲۰۰۰ ثانیه از اعطای اجاره
// پاسخ ندهد، کارگیر باید فرایند REBIND (تمدید اضطراری که امکان تعویض
// به یک کارساز دیگر را فراهم می‌کند) را آغاز کند.
  \(dqpreferred\-lifetime\(dq: 3000,
  \(dqvalid\-lifetime\(dq: 4000,
  \(dqrenew\-timer\(dq: 1000,
  \(dqrebind\-timer\(dq: 2000,

// تعریف یک زیرشبکه. چندین گزینه DHCP به کارگیرهای متصل به این زیرشبکه
// برگردانده می‌شود. نخستین گزینه با نام مشخص شده است.
// گزینه دوم با کد مشخص شده است. دو استخر نشانی در این زیرشبکه
// تعریف شده است. مقدار ویژه استخر برای گزینه 12 برای این استخر تعریف
// شده است: 2001:db8:1::1 \- 2001:db8:1::100. کارگیرهایی که نشانی را
// از این استخر به دست می‌آورند، گزینه 12 با مقدار 3001:cafe::21 به آن‌ها
// اختصاص می‌یابد. کارگیرهای متعلق به این زیرشبکه که نشانی را از استخر دیگر
// دریافت می‌کنند یا کارگیرهایی که پیکربندی بدون‌حالت (stateless) را به دست می‌آورند،
// مقدار ویژه زیرشبکه گزینه 12، یعنی 2001:db8:1:0:ff00::1 به آن‌ها اختصاص می‌یابد.
// در DHCPv6، زیرشبکه‌ها می‌توانند استخرهای تفویض پیشوند نیز داشته باشند؛
// بنابراین یک pd\-pools با option\-data نیز تعریف شده است.
  \(dqsubnet6\(dq: [
    {
        // به این صورت مقادیر گزینه‌ها برای این زیرشبکه خاص تعریف می‌شوند.
        \(dqoption\-data\(dq: [
            // هنگام تعیین گزینه‌ها، معمولاً باید یکی از (name یا code) و data را مشخص کنید.
            // مشخصات کامل گزینه شامل name، code، space، csv\-format و data است.
            // مقدار پیش‌فرض space برابر \(dqdhcp6\(dq است که معمولاً درست است، مگر اینکه از
            // گزینه‌های کپسوله‌شده استفاده کنید. csv\-format به‌طور پیش‌فرض برابر \(dqtrue\(dq است،
            // پس این نیز درست است، مگر اینکه بخواهید کل مقدار گزینه را به‌صورت یک رشته هگز
            // طولانی مشخص کنید. به عنوان مثال، برای تعیین domain\-name\-servers می‌توانید
            // این کار را انجام دهید:
            // {
            //     \(dqname\(dq: \(dqdns\-servers\(dq,
            //     \(dqcode\(dq: 23,
            //     \(dqcsv\-format\(dq: true,
            //     \(dqspace\(dq: \(dqdhcp6\(dq,
            //     \(dqdata\(dq: \(dq2001:db8:2::45, 2001:db8:2::100\(dq
            // }
            // اما نوشتن آن طولانی است، بنابراین ساده‌تر است که به جای آن این کار را بکنید:
            {
                \(dqname\(dq: \(dqdns\-servers\(dq,
                \(dqdata\(dq: \(dq2001:db8:2::45, 2001:db8:2::100\(dq
            },

            // معمولاً افراد ترجیح می‌دهند با نام‌ها به گزینه‌ها ارجاع دهند تا
            // نیازی به حفظ کردن شماره کدها نداشته باشند. با این حال، برخی ترجیح می‌دهند
            // از مقادیر عددی استفاده کنند. برای مثال، DHCPv6 می‌تواند در صورت وجود یک گزینه اضافی،
            // به‌صورت اختیاری از ارتباط تک‌پخشی (unicast) با کارساز استفاده کند. گزینه
            // \(dqunicast\(dq از کد گزینه 12 استفاده می‌کند، بنابراین می‌توانید با
            // \(dqname\(dq: \(dqunicast\(dq یا \(dqcode\(dq: 12 به آن ارجاع دهید.
            {
                \(dqcode\(dq: 12,
                \(dqdata\(dq: \(dq2001:db8:1:0:ff00::1\(dq
            },

            // گزینه‌ها را می‌توان در قالب شانزده‌شانزدهی (hexadecimal) نیز تعیین کرد.
            // در صورت امکان باید از این کار پرهیز شود، چرا که توانایی Kea برای
            // اعتبارسنجی درستی مقادیر هنگام استفاده از مقادیر هگز محدود است.
            {
                \(dqname\(dq: \(dqsntp\-servers\(dq,
                \(dqcsv\-format\(dq: false,
                \(dqdata\(dq: \(dq20010db8000000000000000000000001\(dq
            },

            // گزینه‌های رشته‌ای که در مقادیر خود دارای ویرگول (کاما) هستند، باید آن را
            // گریز دهند (یعنی قبل از هر ویرگول دو بک‌اسلش قرار گیرد).
            // دلیل آن این است که ویرگول‌ها برای جداسازی فیلدها در گزینه‌های مرکب رزرو شده‌اند.
            // هم‌زمان، ما باید با استاندارد JSON که \(dq\e,\(dq را مجاز نمی‌داند، سازگار باشیم.
            // بنابراین نشانه‌گذاری اندکی نامتعارف دو بک‌اسلش لازم است.

            // گریزهای مجاز JSON شامل \e هستند که بعد از آن نویسه \(dq\e/bfnrt می‌آید
            // یا \eu که بعد از آن ۴ رقم شانزده‌شانزدهی قرار می‌گیرد (در حال حاضر Kea
            // فقط از نقاط کد \eu0000 تا \eu00ff پشتیبانی می‌کند).
            // پردازش CSV فقط \(aq\e\e\(aq را به \(aq\e\(aq و \(aq\e,\(aq را به \(aq,\(aq
            // تبدیل می‌کند؛ مثلاً \(aq\ex\(aq به \(aq\ex\(aq تبدیل می‌شود. اما
            // از آنجا که روی یک مقدار رشته‌ای JSON عمل می‌کند، هر یک از این
            // نویسه‌های \(aq\e\(aq باید در ورودی JSON دو بار تکرار شوند.
            {
                \(dqname\(dq: \(dqnew\-posix\-timezone\(dq,
                \(dqdata\(dq: \(dqEST5EDT4\e\e,M3.2.0/02:00\e\e,M11.1.0/02:00\(dq
            },

            // گزینه‌هایی که مقادیر صحیح می‌پذیرند را می‌توان در قالب ده‌دهی (dec)
            // یا هگز (hex) تعیین کرد. قالب هگز می‌تواند ساده (مانند abcd)
            // یا با پیشوند 0x (مانند 0xabcd) باشد.
            {
                \(dqname\(dq: \(dqpreference\(dq,
                \(dqdata\(dq: \(dq0xf0\(dq
            },

            // تعداد کمی از گزینه‌ها در چندتایی‌های (طول، رشته) کدگذاری می‌شوند
            // که می‌توان آن‌ها را تنها با استفاده از رشته‌ها تعریف کرد، زیرا
            // پردازش CSV طول‌ها را محاسبه می‌کند.
            {
                \(dqname\(dq: \(dqbootfile\-param\(dq,
                \(dqdata\(dq: \(dqroot=/dev/sda2, quiet, splash\(dq
            },

            // به جز چند استثنا، گزینه‌ها تنها هنگامی به پاسخ اضافه می‌شوند که
            // کارگیر آن‌ها را درخواست کند. پرچم always\-send باید برای اجباری
            // کردن یک گزینه خاص استفاده شود.
            {
                \(dqname\(dq: \(dqpana\-agent\(dq,
                \(dqdata\(dq: \(dq2001:db8:2::123\(dq,
                \(dqalways\-send\(dq: true
            }
      ],
      \(dqpools\(dq: [
        {
            \(dqpool\(dq: \(dq2001:db8:1::1 \- 2001:db8:1::100\(dq,
            \(dqoption\-data\(dq: [
              {
                  \(dqcode\(dq: 12,
                  \(dqdata\(dq: \(dq3001:cafe::21\(dq
              }
            ]
        },
        {
            \(dqpool\(dq: \(dq2001:db8:1::500 \- 2001:db8:1::1000\(dq
        }
      ],
      \(dqpd\-pools\(dq: [
        {
             \(dqprefix\(dq: \(dq2001:2b8:2::\(dq,
             \(dqprefix\-len\(dq: 56,
             \(dqdelegated\-len\(dq: 64,
             \(dqoption\-data\(dq: [
               {
                   \(dqcode\(dq: 12,
                   \(dqdata\(dq: \(dq3001:cafe::12\(dq
               }
             ]
         }
      ],
      \(dqid\(dq: 1,
      \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
      \(dqinterface\(dq: \(dqeth0\(dq
    }
  ],

// بخش زیر پیکربندی ثبت رویدادها (logging) است. فرض بر این است که پیام‌هایی
// با دست‌کم سطح اطلاعاتی (info، warn، error و fatal) باید در
// stdout ثبت شوند.
    \(dqloggers\(dq: [
        {
            \(dqname\(dq: \(dqkea\-dhcp6\(dq,
            \(dqoutput\-options\(dq: [
                {
                    \(dqoutput\(dq: \(dqstdout\(dq
                }
            ],
            \(dqdebuglevel\(dq: 0,
            \(dqseverity\(dq: \(dqINFO\(dq
        }
    ]
}

}
.EE
.UNINDENT
.UNINDENT.SS kea6/mysql\-reservations.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک فایل پیکربندی نمونه برای کارساز DHCPv6 در Kea است.
// این فایل شامل پیکربندی backend پایگاه‌داده میزبان MySQL است که برای
// بازیابی نشانی‌های رزرو شده، نام‌های میزبان، فیلدهای پیام DHCPv4
// و گزینه‌های DHCP از پایگاه‌داده MySQL استفاده می‌شود.
{ \(dqDhcp6\(dq:

{
// به Kea گفته شده است که تنها روی رابط eth0 گوش فرادهد.
  \(dqinterfaces\-config\(dq: {
    \(dqinterfaces\(dq: [ \(dqeth0\(dq ]
  },

// باید پایگاه‌داده مورد استفاده برای ذخیره اجاره‌ها را مشخص کنیم. تا
// ژوئن ۲۰۲۲، سه backend پایگاه‌داده پشتیبانی می‌شوند: MySQL،
// PostgreSQL و پایگاه‌داده درون‌حافظه‌ای Memfile.
// ما از memfile استفاده می‌کنیم زیرا نیازی به راه‌اندازی اولیه ندارد.
  \(dqlease\-database\(dq: {
      \(dqtype\(dq: \(dqmemfile\(dq,
      \(dqlfc\-interval\(dq: 3600
  },

// این‌ها موارد بسیار پایه‌ای هستند و ارتباطی با رزروها ندارند.
  \(dqpreferred\-lifetime\(dq: 3000,
  \(dqvalid\-lifetime\(dq: 4000,
  \(dqrenew\-timer\(dq: 1000,
  \(dqrebind\-timer\(dq: 2000,

// نرم‌افزار Kea از دو نوع شناسه در DHCPv6 پشتیبانی می‌کند: hw\-address
// (نشانی سخت‌افزاری/MAC کلاینت) و duid (شناسه DUID درج‌شده توسط
// کلاینت). در صورت تعیین، Kea می‌تواند هر یک از این نوع شناسه‌ها را
// بررسی کند، اما این کار مستلزم جست‌وجوی هزینه‌بر در پایگاه‌داده است. بنابراین
// از دیدگاه کارایی، بهتر است تنها از نوع رزروهایی استفاده شود که واقعاً در یک شبکه مشخص به کار می‌روند.
    \(dqhost\-reservation\-identifiers\(dq: [ \(dqduid\(dq, \(dqhw\-address\(dq ],

// مشخص کردن اتصال به پایگاه‌داده نگه‌دارنده رزروهای میزبان. مقدار type
// مشخص می‌کند که از پایگاه‌داده MySQL استفاده می‌شود. user و password اطلاعات
// اعتبارسنجی مورد استفاده برای اتصال به پایگاه‌داده هستند. host و name مکان
// میزبانی که نمونه پایگاه‌داده روی آن در حال اجرا است و نام پایگاه‌داده مورد استفاده
// را تعیین می‌کنند. کارساز هنگام پردازش یک بسته، ابتدا بررسی می‌کند که آیا در
// فهرست رزروها درون زیرشبکه (فایل پیکربندی) رزروی برای این کلاینت مشخص شده است
// یا خیر. اگر رزروی در آن‌جا نباشد، کارساز تلاش می‌کند تا رزروها را از این پایگاه‌داده بازیابی کند.
  \(dqhosts\-database\(dq: {
    \(dqtype\(dq: \(dqmysql\(dq,
    \(dqreconnect\-wait\-time\(dq: 3000, // بر حسب میلی‌ثانیه
    \(dqmax\-reconnect\-tries\(dq: 3,
    \(dqname\(dq: \(dqkeatest\(dq,
    \(dquser\(dq: \(dqkeatest\(dq,
    \(dqpassword\(dq: \(dq1234\(dq,
    \(dqhost\(dq: \(dqlocalhost\(dq,
    \(dqport\(dq: 3306,
    \(dqreadonly\(dq: true,
    \(dqtrust\-anchor\(dq: \(dqmy\-ca\(dq,
    \(dqcert\-file\(dq: \(dqmy\-cert\(dq,
    \(dqkey\-file\(dq: \(dqmy\-key\(dq,
    \(dqcipher\-list\(dq: \(dqAES\(dq
  },
// از نسخه Kea.2.7.4 به بعد، برای ذخیره رزروهای میزبان در MySQL Host Database Backend،
// کتابخانه قلاب libdhcp_mysql.so باید بارگیری شود.
// مکان کتابخانه قلاب backend میزبان را مشخص کنید.
  \(dqhooks\-libraries\(dq: [
    {
        // کتابخانه قلاب backend میزبان MySQL که برای ذخیره‌سازی میزبان لازم است.
        \(dqlibrary\(dq: \(dqlibdhcp_mysql.so\(dq
    }
  ],

// تعریف یک زیرشبکه با یک استخر از نشانی‌های پویا و یک استخر از پیشوندهای
// پویا. نشانی‌ها و پیشوندها از این استخرها به کلاینت‌هایی که رزروی در
// پایگاه‌داده ندارند تخصیص داده خواهد شد. شناسه زیرشبکه برابر با 1 است.
// اگر این زیرشبکه برای کلاینت انتخاب شود، از شناسه این زیرشبکه برای
// جست‌وجوی رزروها در پایگاه‌داده استفاده می‌شود.
  \(dqsubnet6\(dq: [
    {
      \(dqsubnet\(dq: \(dq2001:db8:1::/48\(dq,

      \(dqpools\(dq: [ { \(dqpool\(dq: \(dq2001:db8:1::/80\(dq } ],

      \(dqpd\-pools\(dq: [
          {
              \(dqprefix\(dq: \(dq2001:db8:1:8000::\(dq,
              \(dqprefix\-len\(dq: 56,
              \(dqdelegated\-len\(dq: 64
          }
      ],
      \(dqinterface\(dq: \(dqeth0\(dq,
      \(dqid\(dq: 1
    }
  ],

// بخش زیر پیکربندی ثبت گزارش‌ها (logging) است. فرض بر این است که پیام‌هایی
// با حداقل سطح اطلاعاتی (info، warn، error و fatal) باید در stdout
// ثبت شوند.
    \(dqloggers\(dq: [
        {
            \(dqname\(dq: \(dqkea\-dhcp6\(dq,
            \(dqoutput\-options\(dq: [
                {
                    \(dqoutput\(dq: \(dqstdout\(dq
                }
            ],
            \(dqdebuglevel\(dq: 0,
            \(dqseverity\(dq: \(dqINFO\(dq
        }
    ]
}

}
.EE
.UNINDENT
.UNINDENT
.SS kea6/pgsql\-reservations.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک فایل پیکربندی نمونه برای کارساز DHCPv6 در Kea است.
// این فایل شامل پیکربندی backend پایگاه‌داده میزبان PostgreSQL است که برای
// بازیابی نشانی‌های رزرو شده، نام‌های میزبان، فیلدهای پیام DHCPv4
// و گزینه‌های DHCP از پایگاه‌داده PostgreSQL استفاده می‌شود.
{ \(dqDhcp6\(dq:

{
// به Kea گفته شده است که تنها روی رابط eth0 گوش فرادهد.
  \(dqinterfaces\-config\(dq: {
    \(dqinterfaces\(dq: [ \(dqeth0\(dq ]
  },

// باید پایگاه‌داده مورد استفاده برای ذخیره اجاره‌ها را مشخص کنیم. تا
// ژوئن ۲۰۲۲، سه backend پایگاه‌داده پشتیبانی می‌شوند: MySQL،
// PostgreSQL و پایگاه‌داده درون‌حافظه‌ای Memfile.
// ما از memfile استفاده می‌کنیم زیرا نیازی به راه‌اندازی اولیه ندارد.
  \(dqlease\-database\(dq: {
    \(dqtype\(dq: \(dqmemfile\(dq
  },

// این‌ها موارد بسیار پایه‌ای هستند و ارتباطی با رزروها ندارند.
  \(dqpreferred\-lifetime\(dq: 3000,
  \(dqvalid\-lifetime\(dq: 4000,
  \(dqrenew\-timer\(dq: 1000,
  \(dqrebind\-timer\(dq: 2000,

// نرم‌افزار Kea از دو نوع شناسه در DHCPv6 پشتیبانی می‌کند: hw\-address
// (نشانی سخت‌افزاری/MAC کلاینت) و duid (شناسه DUID درج‌شده توسط
// کلاینت). در صورت تعیین، Kea می‌تواند هر یک از این نوع شناسه‌ها را
// بررسی کند، اما این کار مستلزم جست‌وجوی هزینه‌بر در پایگاه‌داده است. بنابراین
// از دیدگاه کارایی، بهتر است تنها از نوع رزروهایی استفاده شود که واقعاً در یک شبکه مشخص به کار می‌روند.
    \(dqhost\-reservation\-identifiers\(dq: [ \(dqduid\(dq, \(dqhw\-address\(dq ],

// مشخص کردن اتصال به پایگاه‌داده نگه‌دارنده رزروهای میزبان. مقدار type
// مشخص می‌کند که از پایگاه‌داده PostgreSQL استفاده می‌شود. user و password اطلاعات
// اعتبارسنجی مورد استفاده برای اتصال به پایگاه‌داده هستند. host و name مکان
// میزبانی که نمونه پایگاه‌داده روی آن در حال اجرا است و نام پایگاه‌داده مورد استفاده
// را تعیین می‌کنند. کارساز هنگام پردازش یک بسته، ابتدا بررسی می‌کند که آیا در
// فهرست رزروها درون زیرشبکه (فایل پیکربندی) رزروی برای این کلاینت مشخص شده است
// یا خیر. اگر رزروی در آن‌جا نباشد، کارساز تلاش می‌کند تا رزروها را از این پایگاه‌داده بازیابی کند.
// مشخصات پایگاه‌داده برای سازگاری با نسخه‌های پیشین می‌تواند درون یک مدخل hosts\-database
// قرار گیرد یا در فهرست hosts\-databases آورده شود.
  \(dqhosts\-databases\(dq: [
    {
       \(dqtype\(dq: \(dqpostgresql\(dq,
       \(dqreconnect\-wait\-time\(dq: 3000, // بر حسب میلی‌ثانیه
       \(dqmax\-reconnect\-tries\(dq: 3,
       \(dqname\(dq: \(dqkeatest\(dq,
       \(dquser\(dq: \(dqkeatest\(dq,
       \(dqpassword\(dq: \(dq1234\(dq,
       \(dqhost\(dq: \(dqlocalhost\(dq
    }
  ],
// از نسخه Kea.2.7.4 به بعد، برای ذخیره رزروهای میزبان در PostgreSQL Host Database Backend،
// کتابخانه قلاب libdhcp_pgsql.so باید بارگیری شود.
// مکان کتابخانه قلاب backend میزبان را مشخص کنید.
  \(dqhooks\-libraries\(dq: [
    {
        // کتابخانه قلاب backend میزبان PostgreSQL که برای ذخیره‌سازی میزبان لازم است.
        \(dqlibrary\(dq: \(dqlibdhcp_pgsql.so\(dq
    }
  ],

// تعریف یک زیرشبکه با یک استخر از نشانی‌های پویا و یک استخر از پیشوندهای
// پویا. نشانی‌ها و پیشوندها از این استخرها به کلاینت‌هایی که رزروی در
// پایگاه‌داده ندارند تخصیص داده خواهد شد. شناسه زیرشبکه برابر با 1 است.
// اگر این زیرشبکه برای کلاینت انتخاب شود، از شناسه این زیرشبکه برای
// جست‌وجوی رزروها در پایگاه‌داده استفاده می‌شود.
  \(dqsubnet6\(dq: [
    {
      \(dqsubnet\(dq: \(dq2001:db8:1::/48\(dq,

      \(dqpools\(dq: [ { \(dqpool\(dq: \(dq2001:db8:1::/80\(dq } ],

      \(dqpd\-pools\(dq: [
          {
              \(dqprefix\(dq: \(dq2001:db8:1:8000::\(dq,
              \(dqprefix\-len\(dq: 56,
              \(dqdelegated\-len\(dq: 64
          }
      ],
      \(dqinterface\(dq: \(dqeth0\(dq,
      \(dqid\(dq: 1
    }
  ],

// بخش زیر پیکربندی ثبت گزارش‌ها را انجام می‌دهد. فرض بر این است که پیام‌هایی
// با حداقل سطح اطلاعاتی (info، warn، error و fatal) باید در stdout
// ثبت شوند.
    \(dqloggers\(dq: [
        {
            \(dqname\(dq: \(dqkea\-dhcp6\(dq,
            \(dqoutput\-options\(dq: [
                {
                    \(dqoutput\(dq: \(dqstdout\(dq
                }
            ],
            \(dqdebuglevel\(dq: 0,
            \(dqseverity\(dq: \(dqINFO\(dq
        }
    ]
}

}
.EE
.UNINDENT
.UNINDENT.SS kea6/reservations.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک فایل پیکربندی نمونه برای کارساز DHCPv6 در Kea است
// که نحوه انجام رزروهای میزبان را نشان می‌دهد. فرض بر این است
// که یک زیرشبکه (2001:db8:1::/64) مستقیماً روی رابط eth0 در دسترس
// است. برای تعدادی از میزبان‌ها، ترکیب‌های گوناگونی از نشانی‌ها
// و پیشوندها رزرو شده است.

{ \(dqDhcp6\(dq:

{
// به Kea گفته شده است که تنها روی رابط eth0 شنود کند.
  \(dqinterfaces\-config\(dq: {
    \(dqinterfaces\(dq: [ \(dqeth0\(dq ]
  },

// باید پایگاه‌داده مورد استفاده برای ذخیره اجاره‌ها را مشخص کنیم. تا
// ژوئن ۲۰۲۲، از سه پیشانه پایگاه‌داده پشتیبانی می‌شود: MySQL،
// PostgreSQL و پایگاه‌داده درون‌حافظه‌ای، Memfile.
// ما از memfile استفاده خواهیم کرد زیرا نیازی به راه‌اندازی اولیه ندارد.
  \(dqlease\-database\(dq: {
      \(dqtype\(dq: \(dqmemfile\(dq,
      \(dqlfc\-interval\(dq: 3600
  },

// این‌ها مواردی کاملاً ساده و پایه‌ای هستند و ارتباطی با رزروها ندارند.
  \(dqpreferred\-lifetime\(dq: 3000,
  \(dqvalid\-lifetime\(dq: 4000,
  \(dqrenew\-timer\(dq: 1000,
  \(dqrebind\-timer\(dq: 2000,

// کارساز Kea از سه نوع شناسه در DHCPv6 پشتیبانی می‌کند: hw\-address (نشانی
// سخت‌افزاری/MAC کلاینت)، duid (شناسه DUID درج‌شده توسط کلاینت) و flex\-id
// (شناسه انعطاف‌پذیر موجود هنگام بارگذاری کتابخانه قلاب flex_id). در صورت
// تنظیم، Kea می‌تواند هر یک از این انواع شناسه را بررسی کند، اما این کار مستلزم
// جست‌وجوی پرهزینه‌ای در پایگاه‌داده است. بنابراین از دیدگاه کارایی سودمند است که
// تنها از انواع رزروی استفاده شود که واقعاً در شبکه مورد نظر به کار می‌روند.
    \(dqhost\-reservation\-identifiers\(dq: [ \(dqduid\(dq, \(dqhw\-address\(dq, \(dqflex\-id\(dq ],

// فهرست زیر زیرشبکه‌ها را تعریف می‌کند. تعاریف زیرشبکه، استخرها و رابط‌ها
// مشابه سناریوی عادی و بدون رزرو میزبان هستند؛ دست‌کم
// مدخل‌های زیرشبکه و استخر.
  \(dqsubnet6\(dq: [
    {
        \(dqid\(dq: 1,

        \(dqsubnet\(dq: \(dq2001:db8:1::/48\(dq,

        // این دستورالعمل به Kea می‌گوید که رزروها می‌توانند هم درون‌استخر
        // و هم خارج‌ازاستخر انجام شوند. برای بهبود کارایی، می‌توانید همه رزروها
        // را به خارج از استخر پویا منتقل کرده و \(dqreservations\-out\-of\-pool\(dq را روی true تنظیم کنید.
        // در این صورت Kea هنگام تخصیص اجاره‌ها از استخر پویا، قادر خواهد بود
        // از جست‌وجوی رزروهای میزبان صرف‌نظر کند.

        // مشخص می‌کند که آیا کارساز باید رزروهای سراسری را جست‌وجو کند یا خیر.
        // پیش‌فرض: false.
        \(dqreservations\-global\(dq: false,

        // مشخص می‌کند که آیا کارساز باید رزروهای درون‌زیرشبکه را جست‌وجو کند یا خیر.
        // پیش‌فرض: true.
        \(dqreservations\-in\-subnet\(dq: true,

        // مشخص می‌کند که آیا کارساز می‌تواند فرض کند همه نشانی‌های رزروشده
        // خارج‌ازاستخر هستند یا خیر. پیش‌فرض: false.
        // هنگامی که reservations\-in\-subnet برابر با false باشد نادیده گرفته می‌شود.
        // در صورت تعیین، در سطوح \(dqshared\-networks\(dq و
        // \(dqsubnet6\(dq به ارث برده می‌شود.
        \(dqreservations\-out\-of\-pool\(dq: false,

        \(dqpools\(dq: [ { \(dqpool\(dq: \(dq2001:db8:1::/120\(dq } ],

        \(dqpd\-pools\(dq: [
          {
              \(dqprefix\(dq: \(dq2001:db8:1:8000::\(dq,
              \(dqprefix\-len\(dq: 56,
              \(dqdelegated\-len\(dq: 64
          }
        ],
        \(dqinterface\(dq: \(dqeth0\(dq,

// رزروهای میزبان. تعریف چندین رزرو؛ توجه داشته باشید که
// همه آن‌ها در محدوده استخر نشانی‌های تخصیص‌یافته به صورت پویا
// قرار دارند. کارساز این نشانی‌ها را از این استخر مستثنی کرده
// و آن‌ها را تنها به کلاینتی که رزروی برای آن‌ها دارد اختصاص می‌دهد.
       \(dqreservations\(dq: [
// این یک رزرو میزبان ساده است. میزبانی با DUID منطبق بر
// مقدار مشخص‌شده، نشانی 2001:db8:1::100 را دریافت خواهد کرد.
          {
              \(dqduid\(dq: \(dq01:02:03:04:05:0A:0B:0C:0D:0E\(dq,
              \(dqip\-addresses\(dq: [ \(dq2001:db8:1::100\(dq ]
          },
// این مورد مشابه مورد قبلی است، اما این بار رزرو بر اساس
// نشانی سخت‌افزاری/MAC انجام می‌شود. کارساز نهایت تلاش خود را برای
// استخراج نشانی سخت‌افزاری/MAC از بسته‌های دریافتی انجام می‌دهد (برای جزئیات
// به دستورالعمل \(aqmac\-sources\(aq مراجعه کنید). این رزرو خاص همچنین دو گزینه
// اضافی را برای ارائه به این کلاینت مشخص می‌کند. در صورتی که گزینه‌هایی
// با همان کد در دامنه سراسری، زیرشبکه یا کلاس مشخص شده باشند، مقادیر
// تعریف‌شده در سطح میزبان اولویت دارند.
          {
              \(dqhw\-address\(dq: \(dq00:01:02:03:04:05\(dq,
              \(dqip\-addresses\(dq: [ \(dq2001:db8:1::101\(dq ],
              \(dqoption\-data\(dq: [
              {
                  \(dqname\(dq: \(dqdns\-servers\(dq,
                  \(dqdata\(dq: \(dq3000:1::234\(dq
              },
              {
                  \(dqname\(dq: \(dqnis\-servers\(dq,
                  \(dqdata\(dq: \(dq3000:1::234\(dq
              } ],
              \(dqclient\-classes\(dq: [ \(dqspecial_snowflake\(dq, \(dqoffice\(dq ]
          },
// این یک رزرو تا حدی پیشرفته‌تر است. کلاینت با DUID مشخص‌شده
// یک نشانی رزروشده، یک پیشوند رزروشده و یک نام میزبان دریافت خواهد کرد.
// این رزرو برای نشانی‌ای است که در استخر پویا قرار ندارد.
// در نهایت، این رزرو شامل گزینه‌های خاص فروشنده برای CableLabs است که
// از enterprise\-id 4491 استفاده می‌کند. این مقادیر خاص تنها
// به کلاینتی تحویل داده می‌شوند که DUID آن با این رزرو مطابقت داشته باشد.
          {
              \(dqduid\(dq: \(dq01:02:03:04:05:06:07:08:09:0A\(dq,
              \(dqip\-addresses\(dq: [ \(dq2001:db8:1:cafe::1\(dq ],
              \(dqprefixes\(dq: [ \(dq2001:db8:2:abcd::/64\(dq ],
              \(dqhostname\(dq: \(dqfoo.example.com\(dq,
              \(dqoption\-data\(dq: [ {
                  \(dqname\(dq: \(dqvendor\-opts\(dq,
                  \(dqdata\(dq: \(dq4491\(dq
              },
              {
                  \(dqname\(dq: \(dqtftp\-servers\(dq,
                  \(dqspace\(dq: \(dqvendor\-4491\(dq,
                  \(dqdata\(dq: \(dq3000:1::234\(dq
              } ]

          },
// این رزرو از شناسه انعطاف‌پذیر استفاده می‌کند. به جای اتکا به یک فیلد
// خاص، مدیر سیستم می‌تواند عبارتی شبیه به آنچه در رده‌بندی کلاینت‌ها استفاده می‌شود
// تعریف کند؛ مانند:
// substring(relay[0].option[17],0,6). سپس بر اساس مقدار آن
// عبارت برای بسته دریافتی، رزرو مطابقت داده می‌شود.
// عبارت می‌تواند به صورت هگزادسیمال یا به صورت متن ساده با استفاده از
// علامت‌های نقل‌قول تکی مشخص شود.
// نکته: شناسه انعطاف‌پذیر برای کار کردن نیاز به بارگذاری
// کتابخانه قلاب flex_id دارد.
         {
             \(dqflex\-id\(dq: \(dq\(aqsomevalue\(aq\(dq,
             \(dqip\-addresses\(dq: [ \(dq2001:db8:1:cafe::2\(dq ]
         }

      ]
    }
  ],

// بخش زیر وقایع‌نگاری را پیکربندی می‌کند. فرض بر این است که پیام‌هایی
// با حداقل سطح اطلاعاتی (info، warn، error و fatal) باید در
// خروجی استاندارد (stdout) ثبت شوند.
    \(dqloggers\(dq: [
        {
            \(dqname\(dq: \(dqkea\-dhcp6\(dq,
            \(dqoutput\-options\(dq: [
                {
                    \(dqoutput\(dq: \(dqstdout\(dq
                }
            ],
            \(dqdebuglevel\(dq: 0,
            \(dqseverity\(dq: \(dqINFO\(dq
        }
    ]
}

}
.EE
.UNINDENT
.UNINDENT.SS kea6/several\-subnets.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک فایل پیکربندی نمونه برای کارساز DHCPv6 در Kea است.
// این یک سناریوی پایه با چهار زیرشبکه IPv6 پیکربندی‌شده است. در هر
// زیرشبکه، یک استخر کوچک‌تر از نشانی‌های پویا وجود دارد.

{ \(dqDhcp6\(dq:

{
// به Kea گفته شده است که تنها روی رابط eth0 شنود کند.
  \(dqinterfaces\-config\(dq: {
    \(dqinterfaces\(dq: [ \(dqeth0\(dq ]
  },

// باید پایگاه‌داده مورد استفاده برای ذخیره اجاره‌ها مشخص شود. تا
// ژوئن ۲۰۲۲، از سه پسانه پایگاه‌داده پشتیبانی می‌شود: MySQL،
// PostgreSQL و پایگاه‌داده درون‌حافظه‌ای Memfile.
// ما از memfile استفاده خواهیم کرد چون نیازی به راه‌اندازی اولیه ندارد.
  \(dqlease\-database\(dq: {
    \(dqtype\(dq: \(dqmemfile\(dq
  },

// نشانی‌ها با طول‌عمرهای ترجیحی و معتبر به ترتیب با مقادیر 3000 و
// 4000 اختصاص داده می‌شوند. به کلاینت گفته می‌شود که تمدید را
// پس از 1000 ثانیه آغاز کند. اگر کارساز پس از 2000 ثانیه از زمان
// اعطای اجاره پاسخی نداد، کلاینت باید فرایند REBIND (تمدید اضطراری
// که امکان تغییر به کارساز دیگری را می‌دهد) را آغاز کند.
  \(dqpreferred\-lifetime\(dq: 3000,
  \(dqvalid\-lifetime\(dq: 4000,
  \(dqrenew\-timer\(dq: 1000,
  \(dqrebind\-timer\(dq: 2000,

// فهرست زیر زیرشبکه‌ها را تعریف می‌کند. هر زیرشبکه دست‌کم از مدخل‌های
// subnet و pool تشکیل شده است.
  \(dqsubnet6\(dq: [
  {    \(dqpools\(dq: [ { \(dqpool\(dq: \(dq2001:db8:1::/80\(dq } ],
       \(dqid\(dq: 1, \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq  },
  {    \(dqpools\(dq: [ { \(dqpool\(dq: \(dq2001:db8:2::/80\(dq } ],
       \(dqid\(dq: 2, \(dqsubnet\(dq: \(dq2001:db8:2::/64\(dq  },
  {    \(dqpools\(dq: [ { \(dqpool\(dq: \(dq2001:db8:3::/80\(dq } ],
       \(dqid\(dq: 3, \(dqsubnet\(dq: \(dq2001:db8:3::/64\(dq  },
  {    \(dqpools\(dq: [ { \(dqpool\(dq: \(dq2001:db8:4::/80\(dq } ],
       \(dqid\(dq: 4, \(dqsubnet\(dq: \(dq2001:db8:4::/64\(dq  } ],

// بخش زیر گزارش‌گیری را پیکربندی می‌کند. در نظر می‌گیرد که پیام‌هایی با
// دست‌کم سطح اطلاعاتی (info، warn، error و fatal) باید در
// stdout ثبت شوند.
  \(dqloggers\(dq: [
        {
            \(dqname\(dq: \(dqkea\-dhcp6\(dq,
            \(dqoutput\-options\(dq: [
                {
                    \(dqoutput\(dq: \(dqstdout\(dq
                }
            ],
            \(dqdebuglevel\(dq: 0,
            \(dqseverity\(dq: \(dqINFO\(dq
        }
    ]
}

}
.EE
.UNINDENT
.UNINDENT
.SS kea6/shared\-network.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک فایل پیکربندی نمونه برای کارساز DHCPv6 در Kea است.
// این نمونه یک قابلیت پیشرفته به نام شبکه اشتراکی (shared network) را نشان می‌دهد.
// معمولاً برای هر پیوند فیزیکی، یک زیرشبکه IPv6 وجود دارد که انتظار می‌رود کارساز
// آن را مدیریت کند. با این حال، در برخی موارد نیاز است که زیرشبکه‌های بیشتری در همان
// موقعیت فیزیکی پیکربندی شوند. این ممکن است عجیب به نظر برسد، زیرا انتظار نمی‌رود
// آدرس‌های IPv6 تمام شوند. با این حال، به دلیل فضای آدرس‌دهی وسیع، برخی پیاده‌سازی‌ها
// طرح‌های آدرس‌دهی گوناگون را می‌آزمایند و بعداً متوجه می‌شوند که طرح اولیه بهترین نبوده
// و راهی برای مهاجرت به طرحی دیگر لازم است.
{
    \(dqDhcp6\(dq: {
        // به Kea گفته شده است که تنها روی رابط eth0 شنود کند.
        \(dqinterfaces\-config\(dq: {
            \(dqinterfaces\(dq: [ \(dqeth0\(dq ]
        },

        // همچنین باید مشخص کنید که اطلاعات اجاره در کجا ذخیره شود.
        // memfile پسانه‌ای است که راه‌اندازی آن از همه ساده‌تر است.
        \(dqlease\-database\(dq: {
            \(dqtype\(dq: \(dqmemfile\(dq,
            \(dqlfc\-interval\(dq: 3600
        },

        // به احتمال زیاد در شبکه خود ترکیبی از زیرشبکه‌های عادی («ساده»)
        // و شبکه‌های اشتراکی خواهید داشت. ترکیب کردن آن‌ها در همان فایل
        // پیکربندی کاملاً مجاز است.

        // این یک زیرشبکه عادی است و بخشی از هیچ shared\-network ای نیست.
        \(dqsubnet6\(dq: [
            {
                \(dqid\(dq: 1,
                \(dqpools\(dq: [ { \(dqpool\(dq: \(dq2001:db8:2::/80\(dq } ],
                \(dqsubnet\(dq: \(dq2001:db8:2::/64\(dq,
                \(dqinterface\(dq: \(dqeth0\(dq
            }
        ],

        // تعریف شبکه‌های اشتراکی از اینجا آغاز می‌شود. shared\-networks می‌تواند
        // شامل فهرستی از شبکه‌های اشتراکی باشد. پارامترهای متعددی وجود دارد
        // که می‌توان در اینجا مشخص کرد، بنابراین این مثال ممکن است در ابتدا پیچیده
        // به نظر برسد، اما تنها پارامتر اجباری برای هر شبکه اشتراکی name است.
        // این نام باید یکتا باشد. معمولاً هر شبکه اشتراکی برای کارکردن نیاز به
        // دست‌کم دو زیرشبکه دارد، اما اگر واقعاً بخواهید، می‌توانید یک شبکه اشتراکی
        // تقلیل‌یافته با ۱ یا حتی ۰ زیرشبکه تعریف کنید. این قابلیت می‌تواند هنگام مهاجرت
        // میان زیرشبکه‌های عادی و شبکه‌های اشتراکی یا هنگام اشکال‌زدایی یک مشکل
        // مفید باشد. استفاده از ۱ زیرشبکه برای هر شبکه اشتراکی توصیه نمی‌شود، زیرا
        // بار پردازشی اضافه برای شبکه‌های اشتراکی وجود دارد.
        \(dqshared\-networks\(dq: [
        {
            \(dqinterface\(dq: \(dqeth1\(dq,

            // همانند زیرشبکه‌های عادی، تعریف هم‌زمان interface و interface\-id
            // ممنوع است. این به این دلیل است که پارامتر interface رابط شبکه فیزیکی
            // را برای پیوندهای محلی در دسترس نشان می‌دهد و interface\-id مقادیر درج‌شده
            // توسط رله‌ها (relays) را مشخص می‌کند که فقط برای ترافیک دوردست استفاده
            // می‌شوند. یک شبکه اشتراکی نمی‌تواند هم مستقیم و هم رله‌شده باشد.
            // \(dqinterface\-id\(dq: \(dqcontent of the option\(dq,

            // سایر پارامترهای تعریف‌شده در اینجا توسط زیرشبکه‌ها
            // به ارث برده می‌شوند.
            \(dqname\(dq: \(dqfrog\(dq,
            \(dqoption\-data\(dq: [ ],
            \(dqpreferred\-lifetime\(dq: 200,
            \(dqrapid\-commit\(dq: true,
            \(dqrebind\-timer\(dq: 150,
            \(dqrelay\(dq: {
                \(dqip\-addresses\(dq: [ \(dq2001:db8::1\(dq ]
            },
            \(dqrenew\-timer\(dq: 100,

            // مشخص می‌کند که آیا کارساز باید رزروهای سراسری را بررسی کند یا خیر.
            \(dqreservations\-global\(dq: false,

            // مشخص می‌کند که آیا کارساز باید رزروهای درون‌زیرشبکه‌ای را بررسی کند یا خیر.
            \(dqreservations\-in\-subnet\(dq: true,

            // مشخص می‌کند که آیا کارساز می‌تواند فرض کند تمام نشانی‌های رزروشده
            // خارج از استخر (out\-of\-pool) هستند یا خیر.
            // در صورتی که reservations\-in\-subnet نادرست (false) باشد نادیده گرفته می‌شود.
            // در صورت تعیین، در سطوح \(dqsubnet6\(dq به ارث برده می‌شود.
            \(dqreservations\-out\-of\-pool\(dq: false,

            // فهرست زیرشبکه‌های متعلق به این shared\-network خاص
            // از اینجا آغاز می‌شود.
            \(dqsubnet6\(dq: [

                // این زیرشبکه نخست است.
                {
                    \(dqpreferred\-lifetime\(dq: 30,
                    \(dqrapid\-commit\(dq: false,
                    \(dqrebind\-timer\(dq: 20,
                    // بازنویسی برخی از مقادیر در اینجا امکان‌پذیر است.
                    \(dqrelay\(dq: {
                        \(dqip\-addresses\(dq: [ \(dq2001:db8:1::123\(dq ]
                    },
                    \(dqrenew\-timer\(dq: 10,
                    // مشخص می‌کند که آیا کارساز باید رزروهای سراسری را بررسی کند یا خیر.
                    \(dqreservations\-global\(dq: false,
                    // مشخص می‌کند که آیا کارساز باید رزروهای درون‌زیرشبکه‌ای را بررسی کند یا خیر.
                    \(dqreservations\-in\-subnet\(dq: true,
                    // مشخص می‌کند که آیا کارساز می‌تواند فرض کند تمام نشانی‌های رزروشده
                    // خارج از استخر (out\-of\-pool) هستند یا خیر.
                    // در صورتی که reservations\-in\-subnet نادرست (false) باشد نادیده گرفته می‌شود.
                    // در صورت تعیین، در سطوح \(dqsubnet6\(dq به ارث برده می‌شود.
                    \(dqreservations\-out\-of\-pool\(dq: false,
                    \(dqid\(dq: 2,
                    \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
                    \(dqpools\(dq: [ { \(dqpool\(dq: \(dq2001:db8:1:0:abcd::/80\(dq } ],
                    \(dqvalid\-lifetime\(dq: 40
                },

                // این زیرشبکه دوم است.
                {
                    \(dqpreferred\-lifetime\(dq: 30,
                    \(dqpools\(dq: [ { \(dqpool\(dq: \(dq3000:db8::/64\(dq } ],
                    \(dqrapid\-commit\(dq: false,
                    \(dqrebind\-timer\(dq: 20,
                    \(dqrelay\(dq: {
                        \(dqip\-addresses\(dq: [ \(dq3000::1\(dq ]
                    },
                    \(dqrenew\-timer\(dq: 10,
                    // مشخص می‌کند که آیا کارساز باید رزروهای سراسری را بررسی کند یا خیر.
                    \(dqreservations\-global\(dq: false,
                    // مشخص می‌کند که آیا کارساز باید رزروهای درون‌زیرشبکه‌ای را بررسی کند یا خیر.
                    \(dqreservations\-in\-subnet\(dq: true,
                    // مشخص می‌کند که آیا کارساز می‌تواند فرض کند تمام نشانی‌های رزروشده
                    // خارج از استخر (out\-of\-pool) هستند یا خیر.
                    // در صورتی که reservations\-in\-subnet نادرست (false) باشد نادیده گرفته می‌شود.
                    // در صورت تعیین، در سطوح \(dqsubnet6\(dq به ارث برده می‌شود.
                    \(dqreservations\-out\-of\-pool\(dq: false,
                    \(dqid\(dq: 3,
                    \(dqsubnet\(dq: \(dq3000::/16\(dq,
                    \(dqvalid\-lifetime\(dq: 40
                }
            ],
            \(dqvalid\-lifetime\(dq: 300
        } ]
    }
}
.EE
.UNINDENT
.UNINDENT.SS kea6/simple.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک فایل پیکربندی نمونه برای کارگزار DHCPv6 در Kea است.
// این یک سناریوی پایه‌ای با یک زیرشبکهٔ IPv6 پیکربندی‌شده است. فرض
// بر این است که یک زیرشبکه (2001:db8:1::/64) مستقیماً روی
// رابط eth0 در دسترس است.

{ \(dqDhcp6\(dq:

{
// به Kea گفته شده است که تنها روی رابط eth0 گوش فرا دهد.
  \(dqinterfaces\-config\(dq: {
    \(dqinterfaces\(dq: [ \(dqeth0\(dq ]
  },

// ما باید پایگاه‌داده مورد استفاده برای ذخیرهٔ اجاره‌ها را مشخص کنیم. تا
// ژوئن 2022، سه پس‌بند پایگاه‌داده پشتیبانی می‌شوند: MySQL،
// PostgreSQL و پایگاه‌داده درون‌حافظه‌ای Memfile.
// ما از memfile استفاده خواهیم کرد زیرا به هیچ راه‌اندازی اولیه‌ای نیاز ندارد.
  \(dqlease\-database\(dq: {
      \(dqtype\(dq: \(dqmemfile\(dq,
      \(dqlfc\-interval\(dq: 3600
  },

// نشانی‌ها به ترتیب با طول‌عمرهای ترجیحی و معتبر 3000 و 4000 تخصیص
// داده می‌شوند. به کلاینت گفته می‌شود که تجدید اجاره را پس از 1000 ثانیه
// آغاز کند. اگر کارگزار پس از 2000 ثانیه از زمان اعطای اجاره پاسخ نداد،
// کلاینت باید روال REBIND (تجدید اضطراری که امکان جابه‌جایی به کارگزار
// دیگری را فراهم می‌سازد) را آغاز نماید.
  \(dqpreferred\-lifetime\(dq: 3000,
  \(dqvalid\-lifetime\(dq: 4000,
  \(dqrenew\-timer\(dq: 1000,
  \(dqrebind\-timer\(dq: 2000,

// فهرست زیر زیرشبکه‌ها را تعریف می‌کند. هر زیرشبکه حداقل شامل
// مدخل‌های subnet و pool است.
  \(dqsubnet6\(dq: [
    {
      \(dqid\(dq: 1,
      \(dqpools\(dq: [ { \(dqpool\(dq: \(dq2001:db8:1::/80\(dq } ],
      \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
      \(dqinterface\(dq: \(dqeth0\(dq
    }
  ],

// بخش زیر ثبت وقایع را پیکربندی می‌کند. فرض بر این است که پیام‌هایی با
// حداقل سطح اطلاعاتی (info، warn، error و fatal) باید در stdout ثبت
// شوند. در غیر این صورت، می‌توانید در اینجا stderr، نام یک فایل یا
// \(aqsyslog\(aq را مشخص کنید که پیام‌های خروجی را از طریق syslog ذخیره می‌کند.
    \(dqloggers\(dq: [
        {
            \(dqname\(dq: \(dqkea\-dhcp6\(dq,
            \(dqoutput\-options\(dq: [
                {
                    \(dqoutput\(dq: \(dqstdout\(dq
                }
            ],
            \(dqdebuglevel\(dq: 0,
            \(dqseverity\(dq: \(dqINFO\(dq
        }
    ]
}

}
.EE
.UNINDENT
.UNINDENT
.SS kea6/softwire46.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک فایل پیکربندی نمونه برای کارگزار DHCPv6 در Kea است.
// این فایل نشان می‌دهد کاربر چگونه می‌تواند مقادیر گزینه‌های Softwire
// تعریف‌شده در RFC 7598 را برای معماری Lightweight 4over6 مشخص کند.

{ \(dqDhcp6\(dq:

{
// به Kea گفته شده است که تنها روی رابط eth0 گوش فرا دهد.
  \(dqinterfaces\-config\(dq: {
    \(dqinterfaces\(dq: [ \(dqeth0\(dq ]
  },

// بیایید از پس‌بند Memfile برای ذخیرهٔ اجاره‌ها استفاده کنیم.
  \(dqlease\-database\(dq: {
    \(dqtype\(dq: \(dqmemfile\(dq
  },

// نشانی‌ها به ترتیب با طول‌عمرهای ترجیحی و معتبر 3000 و 4000 تخصیص
// داده می‌شوند. به کلاینت گفته می‌شود که تجدید اجاره را پس از 1000 ثانیه
// آغاز کند. اگر کارگزار پس از 2000 ثانیه از زمان اعطای اجاره پاسخ نداد،
// کلاینت باید روال REBIND (تجدید اضطراری که امکان جابه‌جایی به کارگزار
// دیگری را فراهم می‌سازد) را آغاز نماید.
  \(dqpreferred\-lifetime\(dq: 3000,
  \(dqvalid\-lifetime\(dq: 4000,
  \(dqrenew\-timer\(dq: 1000,
  \(dqrebind\-timer\(dq: 2000,

// فهرست زیر زیرشبکه‌ها را تعریف می‌کند. هر زیرشبکه حداقل شامل
// مدخل‌های subnet و pool است.
  \(dqsubnet6\(dq: [
    {
      \(dqid\(dq: 1,
      \(dqpools\(dq: [ { \(dqpool\(dq: \(dq2001:db8:1::/80\(dq } ],
      \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
      \(dqinterface\(dq: \(dqeth0\(dq,
// گزینه MAP\-E Container را برای میزبان‌های متصل به این زیرشبکه بگنجانید.
      \(dqoption\-data\(dq: [
        {
            \(dqname\(dq: \(dqs46\-cont\-mape\(dq
        }
      ],
// ارسال گزینه‌های softwire مخصوص میزبان.
      \(dqreservations\(dq: [
        {
            \(dqduid\(dq: \(dq01:02:03:04:05:06:07:08:09:0A\(dq,
            \(dqoption\-data\(dq: [
// این دو گزینه در MAP\-E Container گنجانده خواهند شد
              {
                \(dqspace\(dq: \(dqs46\-cont\-mape\-options\(dq,
                \(dqname\(dq: \(dqs46\-rule\(dq,
                \(dqdata\(dq: \(dq1, 0, 24, 192.0.2.0, 2001:db8:1::/64\(dq
              },
              {
                \(dqspace\(dq: \(dqs46\-cont\-mape\-options\(dq,
                \(dqname\(dq: \(dqs46\-br\(dq,
                \(dqdata\(dq: \(dq2001:db8:cafe::1\(dq
              },
// این گزینه در گزینه S46 Rule گنجانده خواهد شد. این گزینه شامل
// مقدار PSID/طول PSID در قالبی کاربرپسند است. طول PSID تعداد
// بیت‌هایی را مشخص می‌کند که PSID روی آن‌ها کدگذاری می‌شود. مقدار
// PSID برابر 3 چهارمین مقداری است که روی این 4 بیت کدگذاری شده است: \(dq0011b\(dq.
              {
                \(dqspace\(dq: \(dqs46\-rule\-options\(dq,
                \(dqname\(dq: \(dqs46\-portparams\(dq,
                \(dqdata\(dq: \(dq0, 3/4\(dq
              }
            ]
        }
      ]
    }
  ],

// بخش زیر ثبت وقایع را پیکربندی می‌کند. Kea همهٔ پیام‌های اشکال‌زدایی
// را در فایل /var/log/kea/kea\-debug.log ثبت خواهد کرد.
    \(dqloggers\(dq: [
        {
            \(dqname\(dq: \(dqkea\-dhcp6\(dq,
            \(dqoutput\-options\(dq: [
                {
                    \(dqoutput\(dq: \(dq/var/log/kea/kea\-debug.log\(dq
                }
            ],
            \(dqdebuglevel\(dq: 99,
            \(dqseverity\(dq: \(dqDEBUG\(dq
        }
    ]
}

}
.EE
.UNINDENT
.UNINDENT.SS kea6/stateless.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// یک پیکربندی بی‌وضعیت (stateless) بسیار ساده که اطلاعات کارگزارهای DNS را
// بدون در نظر گرفتن نقطه اتصال، در اختیار همه کلاینت‌ها قرار می‌دهد.
//
// همچنین می‌توان گزینه‌ها را بر مبنای هر زیرشبکه، دقیقاً به همان روش
// حالت باوضعیت (stateful) مشخص کرد.
//

{
\(dqDhcp6\(dq: {
    \(dqinterfaces\-config\(dq: {
        \(dqinterfaces\(dq: [ \(dqeth0\(dq ]
    },

// این فهرست گزینه‌هایی است که به تمام کلاینت‌های متقاضی اعطا خواهد شد.
    \(dqoption\-data\(dq: [ {
        \(dqname\(dq: \(dqdns\-servers\(dq,
        \(dqdata\(dq: \(dq2001:db8::1, 2001:db8::2\(dq
    } ],

// در Kea 0.9.1 تعیین lease\-database اجباری است، حتی اگر استفاده نشود.
// در حالت بی‌وضعیت، تنها گزینه‌ها اعطا می‌شوند، نه نشانی‌ها یا
// پیشوندها؛ بنابراین هیچ اجاره‌ای وجود نخواهد داشت (مگر اینکه حالت‌های
// بی‌وضعیت و باوضعیت هم‌زمان استفاده شوند).
    \(dqlease\-database\(dq: {
        \(dqtype\(dq: \(dqmemfile\(dq,
        \(dqlfc\-interval\(dq: 3600
    }
}
}
.EE
.UNINDENT
.UNINDENT
.SS kea6/tee\-times.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک فایل پیکربندی نمونه برای کارگزار DHCPv6 در Kea است.
// این یک سناریوی پایه‌ای با سه زیرشبکه IPv6 است که از روش‌های
// متفاوتی برای تعیین مقادیر T1 و T2 استفاده می‌کنند.

{ \(dqDhcp6\(dq:

{
// به Kea گفته شده است که تنها روی رابط eth0 گوش فرا دهد.
  \(dqinterfaces\-config\(dq: {
    \(dqinterfaces\(dq: [ \(dqeth0\(dq ]
  },

// ما باید پایگاه داده مورد استفاده برای ذخیره اجاره‌ها را مشخص کنیم. از
// ژوئن ۲۰۲۲، از سه زیرساخت پایگاه داده پشتیبانی می‌شود: MySQL،
// PostgreSQL و پایگاه داده درون‌حافظه‌ای، Memfile.
// ما از memfile استفاده خواهیم کرد زیرا نیازی به هیچ راه‌اندازی اولیه‌ای ندارد.
  \(dqlease\-database\(dq: {
    \(dqtype\(dq: \(dqmemfile\(dq
  },

// نشانی‌ها با طول‌عمرهای ترجیحی و معتبر تخصیص داده می‌شوند که به ترتیب
// ۳۰۰۰ و ۴۰۰۰ هستند. به طور پیش‌فرض calculate\-tee\-times برابر با true است
// با مقادیر .5 و .8 به ترتیب برای t1\-percent و t2\-percent.
// از آنجا که برخی از زیرشبکه‌های ما از مقادیر محاسبه‌شده استفاده خواهند کرد،
// نباید مقادیر سراسری را برای renew\-timer و rebind\-timer مشخص کنیم.
  \(dqpreferred\-lifetime\(dq: 3000,
  \(dqvalid\-lifetime\(dq: 4000,

// فهرست زیر، زیرشبکه‌ها را تعریف می‌کند. هر زیرشبکه حداقل شامل
// مدخل‌های subnet و pool است.
  \(dqsubnet6\(dq: [
  {
        //  این زیرشبکه از محاسبات پیش‌فرض استفاده می‌کند
        \(dqid\(dq: 1,
        \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
        \(dqpools\(dq: [ { \(dqpool\(dq: \(dq2001:db8:1::/80\(dq } ]
  },
  {
        // این زیرشبکه از مقادیر صریح استفاده خواهد کرد. مقادیر
        // صریح بر محاسبات اولویت دارند.
       \(dqid\(dq: 2,
       \(dqsubnet\(dq: \(dq2001:db8:2::/64\(dq,
       \(dqpools\(dq: [ { \(dqpool\(dq: \(dq2001:db8:2::/80\(dq } ],
       \(dqrenew\-timer\(dq:  1000,
       \(dqrebind\-timer\(dq: 2000
  },
  {
        // این زیرشبکه از درصدهای سفارشی استفاده خواهد کرد
       \(dqid\(dq: 3,
       \(dqsubnet\(dq: \(dq2001:db8:3::/64\(dq,
       \(dqpools\(dq: [ { \(dqpool\(dq: \(dq2001:db8:3::/80\(dq } ],
       \(dqt1\-percent\(dq: .45,
       \(dqt2\-percent\(dq: .7
  }],

// بخش زیر گزارش‌گیری را پیکربندی می‌کند. فرض بر این است که پیام‌هایی
// با حداقل سطح اطلاعاتی (info،‏ warn،‏ error و fatal) باید در
// stdout ثبت شوند.
    \(dqloggers\(dq: [
        {
            \(dqname\(dq: \(dqkea\-dhcp6\(dq,
            \(dqoutput\-options\(dq: [
                {
                    \(dqoutput\(dq: \(dqstdout\(dq
                }
            ],
            \(dqdebuglevel\(dq: 0,
            \(dqseverity\(dq: \(dqINFO\(dq
        }
    ]
}

}
.EE
.UNINDENT
.UNINDENT
.SS kea6/with\-ddns.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک فایل پیکربندی نمونه برای کارگزار DHCPv6 در Kea است.
// این یک سناریوی پایه‌ای با یک زیرشبکه IPv6 پیکربندی‌شده است. فرض
// بر این است که یک زیرشبکه (2001:db8:1::/64) به طور مستقیم
// روی رابط eth0 در دسترس است.

{ \(dqDhcp6\(dq:

{
// به Kea گفته شده است که تنها روی رابط eth0 گوش فرا دهد.
  \(dqinterfaces\-config\(dq: {
    \(dqinterfaces\(dq: [ \(dqeth0\(dq ]
  },

// ما باید پایگاه داده مورد استفاده برای ذخیره اجاره‌ها را مشخص کنیم. از
// ژوئن ۲۰۲۲، از سه زیرساخت پایگاه داده پشتیبانی می‌شود: MySQL،
// PostgreSQL و پایگاه داده درون‌حافظه‌ای، Memfile.
// ما از memfile استفاده خواهیم کرد زیرا نیازی به هیچ راه‌اندازی اولیه‌ای ندارد.
  \(dqlease\-database\(dq: {
      \(dqtype\(dq: \(dqmemfile\(dq,
      \(dqlfc\-interval\(dq: 3600
  },

// نشانی‌ها با طول‌عمرهای ترجیحی و معتبر تخصیص داده می‌شوند که به ترتیب
// ۳۰۰۰ و ۴۰۰۰ هستند. به کلاینت گفته می‌شود که تمدید را پس از ۱۰۰۰ ثانیه
// آغاز کند. اگر کارگزار پس از ۲۰۰۰ ثانیه از زمان اعطای اجاره پاسخی ندهد،
// کلاینت باید فرایند REBIND (تمدید اضطراری که امکان جابه‌جایی به یک کارگزار
// دیگر را فراهم می‌کند) را شروع کند.
  \(dqpreferred\-lifetime\(dq: 3000,
  \(dqvalid\-lifetime\(dq: 4000,
  \(dqrenew\-timer\(dq: 1000,
  \(dqrebind\-timer\(dq: 2000,

// فهرست زیر، زیرشبکه‌ها را تعریف می‌کند. هر زیرشبکه حداقل شامل
// مدخل‌های subnet و pool است.
  \(dqsubnet6\(dq: [
    {
      \(dqpools\(dq: [ { \(dqpool\(dq: \(dq2001:db8:1::/80\(dq } ],
      \(dqid\(dq: 1,
      \(dqsubnet\(dq: \(dq2001:db8:1::/64\(dq,
      \(dqinterface\(dq: \(dqeth0\(dq
    }
  ],

// فعال‌سازی ارتباط با kea\-dhcp\-ddns
// (برای به‌روزرسانی‌های پویای DNS الزامی است)
  \(dqdhcp\-ddns\(dq : {
        \(dqenable\-updates\(dq : true,
        \(dqserver\-ip\(dq : \(dq3001::1\(dq,
        \(dqserver\-port\(dq : 3432,
        \(dqsender\-ip\(dq : \(dq3001::2\(dq,
        \(dqsender\-port\(dq : 3433,
        \(dqmax\-queue\-size\(dq : 2048,
        \(dqncr\-protocol\(dq : \(dqUDP\(dq,
        \(dqncr\-format\(dq : \(dqJSON\(dq
  },


// فعال‌سازی به‌روزرسانی‌های DDNS و پیکربندی رفتار به‌روزرسانی DDNS
  \(dqddns\-send\-updates\(dq : true,
  \(dqddns\-override\-no\-update\(dq : true,
  \(dqddns\-override\-client\-update\(dq : true,
  \(dqddns\-replace\-client\-name\(dq : \(dqwhen\-present\(dq,
  \(dqddns\-generated\-prefix\(dq : \(dqtest.prefix\(dq,
  \(dqddns\-qualifying\-suffix\(dq : \(dqtest.suffix.\(dq,
  \(dqddns\-update\-on\-renew\(dq : false,
  \(dqddns\-conflict\-resolution\-mode\(dq: \(dqcheck\-with\-dhcid\(dq,
  \(dqddns\-ttl\-percent\(dq : 0.75,
  \(dqhostname\-char\-set\(dq: \(dq[^A\-Za\-z0\-9.\-]\(dq,
  \(dqhostname\-char\-replacement\(dq: \(dqx\(dq,

// بخش زیر گزارش‌گیری را پیکربندی می‌کند. فرض بر این است که پیام‌هایی
// با حداقل سطح اطلاعاتی (info،‏ warn،‏ error و fatal) باید در
// stdout ثبت شوند.
    \(dqloggers\(dq: [
        {
            \(dqname\(dq: \(dqkea\-dhcp6\(dq,
            \(dqoutput\-options\(dq: [
                {
                    \(dqoutput\(dq: \(dqstdout\(dq
                }
            ],
            \(dqdebuglevel\(dq: 0,
            \(dqseverity\(dq: \(dqINFO\(dq
        }
    ]
}

}
.EE
.UNINDENT
.UNINDENT.SS netconf
.SS netconf/comments.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک نمونه پیکربندی برای Netconf است.
// این پیکربندی از کامنت‌های تعبیه‌شده (یعنی مواردی که در اشیاء پیکربندی گنجانده می‌شوند
// و در تحلیل لغوی حذف نمی‌گردند) استفاده می‌کند.

{
    \(dqNetconf\(dq:
    {
        // حوزه سراسری
        \(dqcomment\(dq: \(dqThe Netconf Agent\(dq,

        // در کارسازها
        \(dqmanaged\-servers\(dq:
        {
            \(dqdhcp4\(dq:
            {
                \(dqcomment\(dq: \(dqthe model is mandatory\(dq,
                \(dqmodel\(dq: \(dqkea\-dhcp4\-server\(dq,
                // در سوکت کنترلی.
                \(dqcontrol\-socket\(dq:
                {
                    \(dqcomment\(dq: \(dqusing unix/local socket\(dq,
                    \(dqsocket\-type\(dq: \(dqunix\(dq,
                    \(dqsocket\-name\(dq: \(dqkea4\-ctrl\-socket\(dq
                }
            }
        },

        // در ثبت‌کننده‌ها (loggers)
        \(dqloggers\(dq: [
            {
                \(dqcomment\(dq: \(dqA logger\(dq,
                \(dqname\(dq: \(dqkea\-netconf\(dq
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.SS netconf/kea\-dhcp6\-operations
.SS netconf/kea\-dhcp6\-operations/boot.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqDhcp6\(dq: {
        \(dqcontrol\-socket\(dq: {
            \(dqsocket\-type\(dq: \(dqunix\(dq,
            \(dqsocket\-name\(dq: \(dqkea6\-ctrl\-socket\(dq
        }
    }
}
.EE
.UNINDENT
.UNINDENT
.SS netconf/kea\-dhcp6\-operations/netconf.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqNetconf\(dq:
    {
        \(dqmanaged\-servers\(dq:
        {
            \(dqdhcp6\(dq:
            {
                \(dqcontrol\-socket\(dq:
                {
                    \(dqsocket\-type\(dq: \(dqunix\(dq,
                    \(dqsocket\-name\(dq: \(dqkea6\-ctrl\-socket\(dq
                }
            }
        },

        \(dqloggers\(dq:
        [
            {
                \(dqname\(dq: \(dqkea\-netconf\(dq,
                \(dqoutput\-options\(dq:
                [
                    {
                        \(dqoutput\(dq: \(dqstderr\(dq
                    }
                ],
                \(dqseverity\(dq: \(dqDEBUG\(dq,
                \(dqdebuglevel\(dq: 99
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT
.SS netconf/simple\-dhcp4.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک پیکربندی نمونه ساده برای Netconf است که پیکربندی
// DHCPv4 را مدیریت می‌کند. این مثال تنها رابط YANG را برای
// کارساز DHCPv4 فراهم می‌کند.
{
    \(dqNetconf\(dq:
    {
        // سه پرچم netconf را کنترل می‌کنند (مقادیر پیش‌فرض true هستند):
        // \- پرچم \(dqboot\-update\(dq در مورد بارگیری پیکربندی YANG هنگام
        //   راه‌اندازی netconf.
        // \- پرچم \(dqsubscribe\-changes\(dq در مورد اشتراک در اعلان‌ها
        //   هنگام تغییر ماژول YANG در حال اجرا.
        // \- پرچم \(dqvalidate\-changes\(dq امکان اعتبارسنجی تغییرات را فراهم یا غیرفعال می‌کند.
        \(dqboot\-update\(dq: true,
        \(dqsubscribe\-changes\(dq: true,
        \(dqvalidate\-changes\(dq: true,

        // این نگاشت نحوه مدیریت هر کارساز را مشخص می‌کند:
        // مدل YANG مورد استفاده و کانال کنترلی.
        \(dqmanaged\-servers\(dq:
        {
            // نحوه ارتباط Netconf با کارساز DHCPv4 به این صورت است.
            \(dqdhcp4\(dq:
            {
                // در نهایت، kea\-netconf قادر به مدیریت چندین مدل خواهد بود.
                // با این حال، در حال حاضر تنها انتخاب برای کارساز DHCPv4
                // مدل kea\-dhcp4\-server است.
                \(dqmodel\(dq: \(dqkea\-dhcp4\-server\(dq,

                // این سه پرچم کنترلی می‌توانند در این حوزه نیز تعریف شوند
                // و بر مقادیر سراسری و پیش‌فرض اولویت دارند.
                // پرچم boot\-update تعیین می‌کند که آیا پیکربندی اولیه باید در طول
                // راه‌اندازی kea\-netconf از netconf دریافت شود یا خیر.
                // تقریباً همیشه می‌خواهید این مقدار را روی yes تنظیم کنید.
                \(dqboot\-update\(dq: true,

                // این پرچم کنترل می‌کند که آیا دیمن kea\-netconf باید در هرگونه
                // تغییراتی مشترک شود یا خیر. در صورت تنظیم روی true، دیمن kea\-netconf
                // ابزار sysrepo را زیر نظر گرفته و هر تغییری را که از طریق کلاینت‌های
                // netconf یا sysrepocfg ایجاد شود اعمال می‌کند.
                \(dqsubscribe\-changes\(dq: true,

                // این پارامتر مشخص می‌کند که آیا kea\-netconf تلاش خواهد کرد تا صحت
                // پیکربندی آتی NETCONF را اعتبارسنجی کند یا خیر. این اعتبارسنجی
                // با فراخوانی config\-test انجام می‌شود. بسته به پاسخ Kea،
                // پیکربندی جدید پذیرفته یا رد می‌شود.
                \(dqvalidate\-changes\(dq: false,

                // در حال حاضر سه نوع کانال کنترلی پشتیبانی می‌شوند:
                // \- مقدار \(dqstdout\(dq که پیکربندی را در خروجی استاندارد چاپ می‌کند
                //   (این حالت عمدتاً برای اهداف آزمایشی است، اما می‌توانید از یک اسکریپت
                //   ساده مانند curl یا socat برای انتقال آن اطلاعات به کارساز استفاده کنید).
                // \- مقدار \(dqunix\(dq که از کانال کنترلی محلی پشتیبانی‌شده توسط کارسازهای
                //   \(dqdhcp4\(dq و \(dqdhcp6\(dq استفاده می‌کند (پشتیبانی از \(dqd2\(dq در نسخه Kea 1.5 ارائه خواهد شد).
                // \- مقدار \(dqhttp\(dq (هنوز پشتیبانی نمی‌شود؟).
                \(dqcontrol\-socket\(dq:
                {
                    \(dqsocket\-type\(dq: \(dqunix\(dq,
                    \(dqsocket\-name\(dq: \(dqkea4\-ctrl\-socket\(dq
                },

                // نوشتن یادداشت اختیاری است. می‌توانید یادداشت‌های خود را در اینجا قرار دهید.
                \(dqcomment\(dq: \(dqKea DHCPv4 server serving network on floor 13\(dq
            }

        },

        // ابزار Netconf قادر است کتابخانه‌های قلاب (hook) را برای گسترش عملکرد خود بارگیری کند.
        // کارکرد اصلی آن امکان افزودن دستورهای جدید است.

        // برای بارگیری یک کتابخانه قلاب، این بخش را از حالت کامنت خارج کنید.

        // \(dqhooks\-libraries\(dq: [
        //    // فهرست کتابخانه‌های قلاب می‌تواند حاوی بیش از یک کتابخانه باشد.
        //    {
        //        // تنها پارامتر ضروری نام فایل کتابخانه است.
        //        \(dqlibrary\(dq: \(dqnetconf\-commands.so\(dq,

        //        // برخی کتابخانه‌ها ممکن است از پارامترها پشتیبانی کنند. دقت کنید
        //        // که این بخش را با دقت بنویسید، زیرا کارساز آن را اعتبارسنجی
        //        // نمی‌کند (چون قالب آن مختص به همان کتابخانه است).
        //        \(dqparameters\(dq: {
        //            \(dqparam1\(dq: \(dqfoo\(dq
        //        }
        //    }
        // ]

        // همانند سایر مؤلفه‌های Kea، ابزار Netconf نیز از ثبت وقایع استفاده می‌کند.
        \(dqloggers\(dq: [
            {
                \(dqname\(dq: \(dqkea\-netconf\(dq,
                \(dqoutput\-options\(dq: [
                    {
                        // \(dqoutput\(dq: \(dq/var/log/kea/kea\-netconf.log\(dq,
                        \(dqoutput\(dq: \(dqstdout\(dq,
                        // علاوه بر خروجی معمول، چندین پارامتر دیگر نیز امکان‌پذیر است.
                        // پارامتر flush مشخص می‌کند که آیا ثبت‌کننده، خروجی را بلافاصله
                        // در فایل تخلیه کند یا خیر. پارامتر maxsize حداکثر حجم فایل
                        // را پیش از چرخش فایل مشخص می‌کند. پارامتر maxver حداکثر
                        // تعداد فایل‌های چرخیده‌شده‌ای را که نگهداری می‌شوند مشخص
                        // می‌کند.
                        \(dqflush\(dq: true,
                        \(dqmaxsize\(dq: 204800,
                        \(dqmaxver\(dq: 4,
                         // از pattern برای مشخص کردن چیدمان سفارشی پیام‌های وقایع استفاده می‌کنیم
                        \(dqpattern\(dq: \(dq%d{%y.%m.%d %H:%M:%S.%q} %\-5p [%c/%i] %m\en\(dq
                    }
                ],
                // می‌توانید شدت وقایع (severity) را به DEBUG،‏ INFO،‏ WARN،‏ ERROR یا
                // CRIT تغییر دهید. برای سطح DEBUG، می‌توانید مقدار debuglevel
                // را نیز مشخص کنید (۰\-۹۹، مقدار بیشتر = گزارش مفصل‌تر). تمام پیکربندی‌ها
                // در سطح DEBUG/55 ثبت می‌شوند.
                \(dqseverity\(dq: \(dqINFO\(dq,
                \(dqdebuglevel\(dq: 0
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT.SS netconf/simple\-dhcp6.json
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک مثال ساده از پیکربندی برای Netconf است که پیکربندی
// DHCPv6 را مدیریت می‌کند. این مثال تنها رابط YANG را برای
// سرور DHCPv6 فراهم می‌کند.
{
    \(dqNetconf\(dq:
    {
        // سه پرچم، netconf را کنترل می‌کنند (مقادیر پیش‌فرض true هستند):
        // \- \(dqboot\-update\(dq درباره بارگذاری پیکربندی YANG هنگام
        //   راه‌اندازی netconf.
        // \- \(dqsubscribe\-changes\(dq درباره اشتراک در اعلان‌ها هنگام
        //   تغییر ماژول در حال اجرای YANG.
        // \- \(dqvalidate\-changes\(dq امکان اعتبارسنجی یا عدم اعتبارسنجی تغییرات را فراهم می‌کند.
        \(dqboot\-update\(dq: true,
        \(dqsubscribe\-changes\(dq: true,
        \(dqvalidate\-changes\(dq: true,

        // این نگاشت نحوه مدیریت هر سرور را مشخص می‌کند:
        // مدل YANG مورد استفاده و کانال کنترلی.
        \(dqmanaged\-servers\(dq:
        {
            // روش برقراری ارتباط Netconf با سرور DHCPv6 به این صورت است.
            \(dqdhcp6\(dq:
            {
                // در نهایت kea\-netconf قادر به مدیریت چندین مدل خواهد بود.
                // با این حال، در حال حاضر گزینه‌های موجود برای سرور
                // DHCPv6 مدل‌های kea\-dhcp6\-server و
                // ietf\-dhcpv6\-server هستند، اما فقط اولی قابل استفاده است.
                \(dqmodel\(dq: \(dqkea\-dhcp6\-server\(dq,

                // این سه پرچم کنترلی می‌توانند در این محدوده نیز تعریف شوند
                // و بر مقادیر سراسری و پیش‌فرض اولویت دارند.
                // پرچم boot\-update تعیین می‌کند که آیا پیکربندی اولیه باید
                // هنگام راه‌اندازی kea\-netconf از netconf بازیابی شود یا خیر.
                // تقریباً همیشه می‌خواهید این مقدار را روی yes تنظیم کنید.
                \(dqboot\-update\(dq: true,

                // این پرچم کنترل می‌کند که آیا دیمن kea\-netconf باید در هرگونه
                // تغییری مشترک شود یا خیر. اگر روی true تنظیم شود، kea\-netconf
                // مخزن sysrepo را زیر نظر می‌گیرد و هر تغییری را که چه توسط کلاینت‌های
                // netconf و چه توسط sysrepocfg اعمال شود، دریافت خواهد کرد.
                \(dqsubscribe\-changes\(dq: true,

                // این پارامتر مشخص می‌کند که آیا kea\-netconf تلاش خواهد کرد تا صحت
                // پیکربندی NETCONF پیش‌رو را بررسی کند یا خیر. اعتبارسنجی با
                // فراخوانی config\-test انجام می‌شود. بسته به پاسخ Kea،
                // پیکربندی جدید پذیرفته یا رد می‌شود.
                \(dqvalidate\-changes\(dq: false,

                // در حال حاضر سه نوع کانال کنترلی پشتیبانی می‌شود:
                // \- \(dqstdout\(dq که پیکربندی را در خروجی استاندارد می‌نویسد (این حالت
                //   عمدتاً برای اهداف آزمایشی است، اما می‌توانید از اسکریپتی ساده
                //   (مانند curl یا socat) برای ارسال آن اطلاعات به سرور استفاده کنید.
                // \- \(dqunix\(dq که از کانال کنترلی محلی پشتیبانی‌شده توسط
                //   سرورهای \(dqdhcp4\(dq و \(dqdhcp6\(dq استفاده می‌کند (پشتیبانی از \(dqd2\(dq در Kea 1.5 ارائه می‌شود)
                // \- \(dqhttp\(dq (هنوز پشتیبانی نمی‌شود؟).
                \(dqcontrol\-socket\(dq:
                {
                    \(dqsocket\-type\(dq: \(dqunix\(dq,
                    \(dqsocket\-name\(dq: \(dqkea6\-ctrl\-socket\(dq
                },

                // کامنت اختیاری است. می‌توانید یادداشت‌هایی را اینجا بنویسید.
                \(dqcomment\(dq: \(dqKea DHCPv6 server serving network on floor 13\(dq
            }

        },

        // ابزار Netconf قادر به بارگذاری کتابخانه‌های قلاب (hook) است که عملکرد آن را گسترش می‌دهند.
        // کارکرد اصلی، قابلیت افزودن دستورهای جدید است.

        // برای بارگذاری یک کتابخانه قلاب، این بخش را از حالت توضیح خارج کنید.

        // \(dqhooks\-libraries\(dq: [
        //    // فهرست کتابخانه‌های قلاب می‌تواند شامل بیش از یک کتابخانه باشد.
        //    {
        //        // تنها پارامتر لازم، نام فایل کتابخانه است.
        //        \(dqlibrary\(dq: \(dqnetconf\-commands.so\(dq,

        //        // برخی کتابخانه‌ها ممکن است از پارامترها پشتیبانی کنند. دقت کنید
        //        // که این بخش را با احتیاط تایپ کنید، زیرا سرور آن را اعتبارسنجی نمی‌کند
        //        // (چون قالب آن مختص به هر کتابخانه است).
        //        \(dqparameters\(dq: {
        //            \(dqparam1\(dq: \(dqfoo\(dq
        //        }
        //    }
        // ]

        // مشابه سایر مؤلفه‌های Kea، ابزار Netconf نیز از سیستم ثبت وقایع استفاده می‌کند.
        \(dqloggers\(dq: [
            {
                \(dqname\(dq: \(dqkea\-netconf\(dq,
                \(dqoutput\-options\(dq: [
                    {
                        // \(dqoutput\(dq: \(dq/var/log/kea/kea\-netconf.log\(dq,
                        \(dqoutput\(dq: \(dqstdout\(dq,
                        // علاوه بر خروجی معمول، چندین پارامتر اضافی دیگر نیز امکان‌پذیر است.
                        // Flush تعیین می‌کند که آیا ثبت‌کننده خروجی را در فایل تخلیه (flush)
                        // می‌کند یا خیر. Maxsize حداکثر اندازه فایل را پیش از چرخش (rotation)
                        // مشخص می‌کند. maxver حداکثر تعداد فایل‌های چرخیده نگهداری‌شده
                        // را مشخص می‌کند.
                        \(dqflush\(dq: true,
                        \(dqmaxsize\(dq: 204800,
                        \(dqmaxver\(dq: 4,
                        // ما از pattern برای مشخص کردن الگوی سفارشی پیام گزارش استفاده می‌کنیم
                        \(dqpattern\(dq: \(dq%d{%y.%m.%d %H:%M:%S.%q} %\-5p [%c/%i] %m\en\(dq

                    }
                ],
                // می‌توانید شدت (severity) را به DEBUG،‏ INFO،‏ WARN،‏ ERROR یا
                // CRIT تغییر دهید. برای سطح DEBUG، می‌توانید علاوه بر این debuglevel
                // را نیز مشخص کنید (0\-99، مقدار بالاتر = با جزئیات بیشتر). تمام پیکربندی‌ها
                // در DEBUG/55 ثبت می‌شوند.
                \(dqseverity\(dq: \(dqINFO\(dq,
                \(dqdebuglevel\(dq: 0
            }
        ]
    }
}
.EE
.UNINDENT
.UNINDENT.SH "قالب‌های پیکربندی (CONFIGURATION TEMPLATES)"
.sp
بخش‌های زیر شامل قالب‌های پیکربندی برای انواع خاصی از استقرار هستند. فایل‌های پیکربندی نمونه در سورس‌کد Kea، در دایرکتوری \fBdoc/examples\fP نیز در دسترس هستند.
.SS "قالب: شبکه خانگی یک کاربر حرفه‌ای (Template: Home Network of a Power User)"
.sp
در ادامه قالب‌هایی برای کمک به پیکربندی شبکه خانگی یک کاربر حرفه‌ای آورده شده است؛ این قالب‌ها همچنین ممکن است برای یک دفتر کار کوچک مناسب باشند. این قالب‌ها فرضیات زیر را در نظر می‌گیرند:
.INDENT 0.0
.IP \(bu 2
مدیر سیستم می‌خواهد از یک کلاس /24 منفرد از آدرس‌های IPv4 استفاده کند.
.IP \(bu 2
قابلیت دسترسی‌پذیری بالا (HA) مورد نیاز است، بنابراین دو سرور DHCP وجود دارد.
.IP \(bu 2
تعداد انگشت‌شماری دستگاه وجود دارد و برخی از آن‌ها (مانند یک چاپگر یا NAS) به آدرس‌های ایستا یا گزینه‌های اضافی نیاز دارند.
.IP \(bu 2
مدیر سیستم نمی‌خواهد درگیر مدیریت پایگاه‌داده شود.
.IP \(bu 2
راه‌اندازی برای حداقل نگهداری تا بدون نیاز به نگهداری بهینه‌سازی شده است.
.IP \(bu 2
عملکرد و کارایی مسئله‌ای نیست؛ صدها پرس‌وجو در ثانیه مورد انتظار نیست.
.IP \(bu 2
از IPv6 استفاده نمی‌شود.
.IP \(bu 2
به‌روزرسانی‌های DNS توسط Kea انجام نخواهد شد.
.UNINDENT
.sp
راه‌اندازی منطقی شامل دو میزبان است که هر کدام یک سرور Kea DHCPv4 را اجرا می‌کنند. هر سرور به‌عنوان یک شریک از جفت HA عمل می‌کند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
+\-host\-1\-+       +\-host\-2\-+
|        |       |        |
| DHCPv4 ========= DHCPv4 |    ===== \- HTTP connection
|        |       |        |
+\-\-\-\-\-\-\-\-+       +\-\-\-\-\-\-\-\-+
.EE
.UNINDENT
.UNINDENT
.sp
سرورهای روی host\-1 و host\-2 هر دو به پورت 8000 گوش می‌دهند.
.SS "ملاحظات استقرار (Deployment Considerations)"
.sp
انتظار نمی‌رود این راه‌اندازی کارایی بسیار بالایی داشته باشد. بیشتر سخت‌افزارهای معمولی کافی خواهند بود؛ برای مثال Kea با موفقیت روی پلتفرم‌های Raspberry Pi مستقر شده است. اگر روی یک ماشین مجازی (VM) اجرا می‌شود، ۲ گیگابایت رم با یک هسته CPU باید کافی باشد. اوبونتو LTS انتخابی است که راه‌اندازی آن آسان و نگهداری آن اندک است؛ با این حال، هر سیستم‌عامل لینوکس یا FreeBSD مناسب است. سیستم‌های کم‌تر محبوب، مانند OpenBSD یا NetBSD نیز در اصل باید کار کنند، اما به‌طور منظم آزمایش نمی‌شوند.
.sp
در این مثال، دو میزبان در حال اجرای Kea وجود دارند:
.INDENT 0.0
.IP \(bu 2
192.168.1.2 \- سرور اصلی HA (فعال، تمام ترافیک را مدیریت می‌کند)
.IP \(bu 2
192.168.1.3 \- سرور ثانویه HA (غیرفعال، آماده برای تحویل گرفتن وظایف در صورت خرابی سرور اصلی)
.UNINDENT
.sp
شبکه 192.168.1.0/24 است. فرض بر این است که 192.168.1.1 روتر پیش‌فرض است.
.sp
کل زیرشبکه به استخرهای پویا و ایستا تقسیم شده است:
.INDENT 0.0
.IP \(bu 2
192.168.1.100 \- 192.168.1.199 \- این استخر پویا است. هنگامی که دستگاه‌های جدید در شبکه ظاهر می‌شوند، آدرس‌های پویا از این استخر به آن‌ها اختصاص می‌یابد.
.IP \(bu 2
رزروها خارج از این محدوده پویا انجام می‌شوند (بسته به ترجیح آدرس‌دهی، 192.168.1.1\-192.168.1.99 یا 192.168.1.200\-192.168.1.254).
.UNINDENT
.sp
برای استقرار این راه‌اندازی، مراحل زیر را انجام دهید:
.INDENT 0.0
.IP 1. 3
سرور DHCPv4 را روی host\-1 نصب کنید و فایل پیکربندی را در مکان‌های معمول آن کپی نمایید. این مسیر معمولاً در لینوکس \fB/etc/kea\fP و در FreeBSD برابر \fB/usr/local/etc/kea\fP است، و فایل به‌طور معمول \fBkea\-dhcp4.conf\fP نام دارد. لطفاً برای هر سیستم خاص به اسکریپت‌های راه‌اندازی رجوع کنید.
.IP 2. 3
موارد زیر را برای مطابقت با راه‌اندازی محلی تغییر دهید:
.INDENT 3.0
.IP \(bu 2
نام رابطی که Kea باید روی آن گوش دهد (\fBinterfaces\fP در \fBinterfaces\-config\fP).
.IP \(bu 2
نام رابطی که برای دسترسی به زیرشبکه استفاده می‌شود (\fBinterface\fP در \fBsubnet4\fP).
.IP \(bu 2
آدرس‌دهی، در صورتی که از چیزی غیر از 192.168.1.0/24 استفاده می‌کنید. مطمئن شوید که پیکربندی آدرس و پورت کنترلی (\fBsocket\-address\fP و \fBsocket\-port\fP) با پیکربندی HA (\fBurl\fP در \fBhook\-libraries/parameters/high\-availability/peers\fP) مطابقت دارد.
.IP \(bu 2
گزینه روتر، برای مطابقت با شبکه واقعی.
.IP \(bu 2
گزینه DNS، برای مطابقت با شبکه واقعی.
.UNINDENT
.IP 3. 3
اگر از فایروال استفاده می‌کنید، مطمئن شوید که host\-1 می‌تواند به host\-2 دسترسی داشته باشد. یک راه آسان برای اطمینان از این موضوع، تلاش برای دریافت پیکربندی host\-2 از host\-1 است:
.sp
\fBcurl \-X POST \-H \(dqContent\-Type: application/json\(dq \-d \(aq{ \(dqcommand\(dq: \(dqconfig\-get\(dq, \(dqservice\(dq: [ \(dqdhcp4\(dq ] }\(aq  http://192.168.1.3:8000/\fP
.sp
پیکربندی در حال اجرای DHCPv4 باید در قالب JSON بازگردانده شود.
.IP 4. 3
با تکرار مرحله ۳ از host\-2 با استفاده از آدرس IP و پورت مربوط به host\-1، بررسی کنید که ارتباط بین میزبان‌ها در جهت معکوس نیز کار می‌کند (host\-2 می‌تواند به host\-1 متصل شود).
.IP 5. 3
سرور DHCPv4 را طبق مراحل ۱ و ۲ روی host\-2 نصب کنید. فایل پیکربندی سرور آماده‌به‌خدمت بسیار شبیه به فایل سرور اصلی است، به‌جز تعریف فیلد \fBthis\-server\-name\fP (و احتمالاً نام‌های رابط).
.UNINDENT
.SS "توسعه‌های احتمالی (Possible Extensions)"
.sp
این پیکربندی نمونه پایه‌ای اما کاربردی است. پس از راه‌اندازی و اجرا، مدیران سیستم ممکن است مایل باشند تغییرات زیر را مد نظر قرار دهند:
.INDENT 0.0
.IP \(bu 2
اگر یک سرور DNS محلی وجود دارد، به‌روزرسانی‌های DNS را می‌توان از طریق Kea پیکربندی کرد. این کار نیازمند اجرای یک سرور به‌روزرسانی DHCP\-DDNS (\fBkea\-dhcp\-ddns\fP) است. برای جزئیات به Overview \%<#\:dhcp-ddns-overview> مراجعه کنید.
.IP \(bu 2
برای اجرای DHCP با حفظ وضعیت (Stateful) برای IPv6، یک سرور \fBkea\-dhcp6\fP لازم است. پیکربندی آن بسیار شبیه به \fBkea\-dhcp4\fP است، اما تفاوت‌های قابل توجهی وجود دارد: دروازه پیش‌فرض از طریق پروتکل DHCPv6 پیکربندی نمی‌شود، بلکه از طریق اعلان‌های روتر ارسال‌شده توسط روتر محلی تنظیم می‌شود. همچنین مفهوم تفویض پیشوند در DHCPv6، در DHCPv4 وجود ندارد. برای جزئیات به The DHCPv6 Server \%<#\:dhcp6> مراجعه کنید.
.IP \(bu 2
برای گسترش شبکه محلی، افزودن پایگاه‌داده MySQL یا PostgreSQL یک راهکار محبوب است. کاربران می‌توانند اجاره‌ها، رزروهای میزبان و حتی بخش عمده‌ای از پیکربندی را در پایگاه‌داده ذخیره کنند. به Kea Database Administration \%<#\:admin> و پارامترهای \fBlease\-database\fP، \fBhosts\-database\fP و \fBconfig\-control\fP در The DHCPv4 Server \%<#\:dhcp4>\& مراجعه کنید.
.IP \(bu 2
برای ارائه بینش بیشتر در مورد نحوه عملکرد سرور DHCP، واسط برنامه‌نویسی RESTful در Kea می‌تواند بسیاری از آمار زمان اجرا را پرس‌وجو کند یا حتی پیکربندی را در حین زمان اجرا تغییر دهد. کاربران همچنین می‌توانند استقرار Stork را که یک داشبورد با توسعه سریع برای Kea است، مد نظر قرار دهند. برای اطلاعات بیشتر به Monitoring Kea With Stork \%<#\:stork> مراجعه کنید.
.IP \(bu 2
همه کاربران Kea باید Kea Security \%<#\:security>: را بخوانند تا با مصالحه‌های مختلف بین راحتی استفاده و امنیت در Kea آشنا شوند.
.UNINDENT
.sp
ممکن است مقداری تنظیم این قالب‌ها برای مطابقت با نیازهای خاص سیستم ضروری باشد: حداقل، خطوط برجسته شده با رنگ زرد باید برای مطابقت با استقرار واقعی تنظیم شوند.
.sp
فایل پیکربندی DHCPv4 برای Server1:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// This is an example configuration of the Kea DHCPv4 server 1:
//
// \- uses High Availability hook library and Lease Commands hook library
//   to enable High Availability function for the DHCP server. This config
//   file is for the primary (the active) server.
// \- uses memfile, which stores lease data in a local CSV file
// \- it assumes a single /24 addressing over a link that is directly reachable
//   (no DHCP relays)
// \- there is a handful of IP reservations
//
// It is expected to run with a standby (the passive) server, which has a very similar
// configuration. The only difference is that \(dqthis\-server\-name\(dq must be set to \(dqserver2\(dq on the
// other server. Also, the interface configuration depends on the network settings of the
// particular machine.

{

\(dqDhcp4\(dq: {

    // Add names of your network interfaces to listen on.
    \(dqinterfaces\-config\(dq: {
        // The DHCPv4 server listens on this interface. When changing this to
        // the actual name of your interface, make sure to also update the
        // interface parameter in the subnet definition below.
        \(dqinterfaces\(dq: [ \(dqenp0s8\(dq ]
    },

    // Control socket is required for communication with the
    // DHCP server. High Availability requires HTTP/HTTPS control sockets
    // to be configured because lease updates are sent over the RESTful
    // API between the HA peers.
    \(dqcontrol\-socket\(dq: {
        \(dqsocket\-type\(dq: \(dqhttp\(dq,

        // We need to specify where the agent should listen to incoming HTTP
        // queries.
        \(dqsocket\-address\(dq: \(dq192.168.1.2\(dq,

        // This specifies the port the server will listen on.
        \(dqsocket\-port\(dq: 8000
    },

    // Use Memfile lease database backend to store leases in a CSV file.
    // Depending on how Kea was compiled, it may also support SQL databases
    // (MySQL and/or PostgreSQL). Those database backends require more
    // parameters, like name, host and possibly user and password.
    // There are dedicated examples for each backend. See Section 7.2.2 \(dqLease
    // Storage\(dq for details.
    \(dqlease\-database\(dq: {
        // Memfile is the simplest and easiest backend to use. It\(aqs an in\-memory
        // database with data being written to a CSV file. It is very similar to
        // what ISC DHCP does.
        \(dqtype\(dq: \(dqmemfile\(dq
    },

    // Let\(aqs configure some global parameters. The home network is not very dynamic
    // and there\(aqs no shortage of addresses, so no need to recycle aggressively.
    \(dqvalid\-lifetime\(dq: 43200, // leases will be valid for 12h
    \(dqrenew\-timer\(dq: 21600, // clients should renew every 6h
    \(dqrebind\-timer\(dq: 32400, // clients should start looking for other servers after 9h

    // Kea will clean up its database of expired leases once per hour. However, it
    // will keep the leases in expired state for 2 days. This greatly increases the
    // chances for returning devices to get the same address again. To guarantee that,
    // use host reservation.
    // If both \(dqflush\-reclaimed\-timer\-wait\-time\(dq and \(dqhold\-reclaimed\-time\(dq are
    // not 0, when the client sends a release message the lease is expired
    // instead of being deleted from lease storage.
    \(dqexpired\-leases\-processing\(dq: {
        \(dqreclaim\-timer\-wait\-time\(dq: 3600,
        \(dqhold\-reclaimed\-time\(dq: 172800,
        \(dqmax\-reclaim\-leases\(dq: 0,
        \(dqmax\-reclaim\-time\(dq: 0
    },

    // Multi\-threading parameters.
    \(dqmulti\-threading\(dq: {
        // By default, Kea processes packets on multiple threads if the hardware
        // permits. This example uses single\-threaded configuration.
        \(dqenable\-multi\-threading\(dq: false,

        // When multi\-threading is enabled, Kea will process packets on a
        // number of multiple threads configurable through this option. The
        // value must be a positive integer (0 means auto\-detect).
        \(dqthread\-pool\-size\(dq: 0,

        // When multi\-threading is enabled, Kea will read packets from the
        // interface and append a working item to the thread pool. This
        // option configures the maximum number of items that can be queued.
        // The value must be a positive integer (0 means unlimited).
        \(dqpacket\-queue\-size\(dq: 0
    },

    // HA requires two hook libraries to be loaded: libdhcp_lease_cmds.so and
    // libdhcp_ha.so. The former handles incoming lease updates from the HA peers.
    // The latter implements high availability feature for Kea. Note the library name
    // should be the same, but the path is OS specific.
    \(dqhooks\-libraries\(dq: [
        // The lease_cmds library must be loaded because HA makes use of it to
        // deliver lease updates to the server as well as synchronize the
        // lease database after failure.
        {
            \(dqlibrary\(dq: \(dqlibdhcp_lease_cmds.so\(dq
        },

        {
            // The HA hook library should be loaded.
            \(dqlibrary\(dq: \(dqlibdhcp_ha.so\(dq,
            \(dqparameters\(dq: {
                // Each server should have the same HA configuration, except for the
                // \(dqthis\-server\-name\(dq parameter.
                \(dqhigh\-availability\(dq: [ {
                    // This parameter points to this server instance. The respective
                    // HA peers must have this parameter set to their own names.
                    \(dqthis\-server\-name\(dq: \(dqserver1\(dq,
                    // The HA mode is set to hot\-standby. In this mode, the active server handles
                    // all the traffic. The standby takes over if the primary becomes unavailable.
                    \(dqmode\(dq: \(dqhot\-standby\(dq,
                    // Heartbeat is to be sent every 10 seconds if no other control
                    // commands are transmitted.
                    \(dqheartbeat\-delay\(dq: 10000,
                    // Maximum time for partner\(aqs response to a heartbeat, after which
                    // failure detection is started. This is specified in milliseconds.
                    // If we don\(aqt hear from the partner in 60 seconds, it\(aqs time to
                    // start worrying.
                    \(dqmax\-response\-delay\(dq: 60000,
                    // The following parameters control how the server detects the
                    // partner\(aqs failure. The ACK delay sets the threshold for the
                    // \(aqsecs\(aq field of the received discovers. This is specified in
                    // milliseconds.
                    \(dqmax\-ack\-delay\(dq: 5000,
                    // This specifies the number of clients which send messages to
                    // the partner but appear to not receive any response.
                    \(dqmax\-unacked\-clients\(dq: 5,
                    // This specifies the maximum timeout (in milliseconds) for the server
                    // to complete sync. If you have a large deployment (high tens or
                    // hundreds of thousands of clients), you may need to increase it
                    // further. The default value is 60000ms (60 seconds).
                    \(dqsync\-timeout\(dq: 60000,
                    // Multi\-threading parameters.
                    \(dqmulti\-threading\(dq: {
                        // By default, Kea processes packets on multiple threads if the hardware
                        // permits. This example uses single\-threaded configuration.
                       \(dqenable\-multi\-threading\(dq: false,
                       \(dqhttp\-dedicated\-listener\(dq: false,
                       \(dqhttp\-listener\-threads\(dq: 0,
                       \(dqhttp\-client\-threads\(dq: 0
                    },
                    \(dqpeers\(dq: [
                        // This is the configuration of this server instance.
                        {
                            \(dqname\(dq: \(dqserver1\(dq,
                            // This specifies the URL of this server instance.
                            // The \(dqcontrol\-socket\(dq is needed for the High Availability
                            // with single\-threading, and the \(dqsocket\-address\(dq and
                            // \(dqsocket\-port\(dq must be set to the corresponding values.
                            \(dqurl\(dq: \(dqhttp://192.168.1.2:8000/\(dq,
                            // This server is primary. The other one must be
                            // secondary.
                            \(dqrole\(dq: \(dqprimary\(dq
                        },
                        // This is the configuration of the secondary server.
                        {
                            \(dqname\(dq: \(dqserver2\(dq,
                            // Specifies the URL on which the partner\(aqs control
                            // channel can be reached.
                            // The \(dqcontrol\-socket\(dq is needed for the High Availability
                            // with single\-threading, and the \(dqsocket\-address\(dq and
                            // \(dqsocket\-port\(dq must be set to the corresponding values.
                            \(dqurl\(dq: \(dqhttp://192.168.1.3:8000/\(dq,
                            // The other server is secondary. This one must be
                            // primary.
                            \(dqrole\(dq: \(dqstandby\(dq
                        }
                    ]
                } ]
            }
        }
    ],

    // This example contains a single subnet declaration.
    \(dqsubnet4\(dq: [
        {
            // Subnet prefix.
            \(dqsubnet\(dq: \(dq192.168.1.0/24\(dq,

            // There are no relays in this network, so we need to tell Kea that this subnet
            // is reachable directly via the specified interface.
            \(dqinterface\(dq: \(dqenp0s8\(dq,

            // Specify a dynamic address pool.
            \(dqpools\(dq: [
                {
                    \(dqpool\(dq: \(dq192.168.1.100\-192.168.1.199\(dq
                }
            ],

            // These are options that are subnet specific. In most cases, you need to define at
            // least routers option, as without this option your clients will not be able to reach
            // their default gateway and will not have Internet connectivity. If you have many
            // subnets and they share the same options (e.g. DNS servers typically is the same
            // everywhere), you may define options at the global scope, so you don\(aqt repeat them
            // for every network.
            \(dqoption\-data\(dq: [
                {
                    // For each IPv4 subnet you typically need to specify at least one router.
                    \(dqname\(dq: \(dqrouters\(dq,
                    \(dqdata\(dq: \(dq192.168.1.1\(dq
                },
                {
                    // Using cloudflare or Quad9 is a reasonable option. Change this
                    // to your own DNS servers is you have them. Another popular
                    // choice is 8.8.8.8, owned by Google. Using third party DNS
                    // service raises some privacy concerns.
                    \(dqname\(dq: \(dqdomain\-name\-servers\(dq,
                    \(dqdata\(dq: \(dq1.1.1.1,9.9.9.9\(dq
                }
            ],

            // Some devices should get a static address. Since the .100 \- .199 range is dynamic,
            // let\(aqs use the lower address space for this. There are many ways how reservation
            // can be defined, but using MAC address (hw\-address) is by far the most popular one.
            // You can use client\-id, duid and even custom defined flex\-id that may use whatever
            // parts of the packet you want to use as identifiers. Also, there are many more things
            // you can specify in addition to just an IP address: extra options, next\-server, hostname,
            // assign device to client classes etc. See the Kea ARM, Section 8.3 for details.
            // The reservations are subnet specific.
            \(dqreservations\(dq: [
                {
                    \(dqhw\-address\(dq: \(dq1a:1b:1c:1d:1e:1f\(dq,
                    \(dqip\-address\(dq: \(dq192.168.1.10\(dq
                },
                {
                    \(dqclient\-id\(dq: \(dq01:11:22:33:44:55:66\(dq,
                    \(dqip\-address\(dq: \(dq192.168.1.11\(dq
                }
            ]
        }
    ],

    // Logging configuration starts here.
    \(dqloggers\(dq: [
    {
        // This section affects kea\-dhcp4, which is the base logger for DHCPv4 component. It tells
        // DHCPv4 server to write all log messages (on severity INFO or higher) to a file. The file
        // will be rotated once it grows to 2MB and up to 4 files will be kept. The debuglevel
        // (range 0 to 99) is used only when logging on DEBUG level.
        \(dqname\(dq: \(dqkea\-dhcp4\(dq,
        \(dqoutput\-options\(dq: [
            {
                \(dqoutput\(dq: \(dq/var/log/kea/kea\-dhcp4.log\(dq,
                \(dqmaxsize\(dq: 2048000,
                \(dqmaxver\(dq: 4
            }
        ],
        \(dqseverity\(dq: \(dqINFO\(dq,
        \(dqdebuglevel\(dq: 0
    }
  ]
}
}

.EE
.UNINDENT
.UNINDENT
.sp
فایل پیکربندی DHCPv4 برای Server2:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// This is an example configuration of the Kea DHCPv4 server 2:
//
// \- uses High Availability hook library and Lease Commands hook library
//   to enable High Availability function for the DHCP server. This config
//   file is for the primary (the active) server.
// \- uses memfile, which stores lease data in a local CSV file
// \- it assumes a single /24 addressing over a link that is directly reachable
//   (no DHCP relays)
// \- there is a handful of IP reservations
//
// It is expected to run with a primary (the active) server, which has a very similar
// configuration. The only difference is that \(dqthis\-server\-name\(dq must be set to \(dqserver2\(dq on the
// other server. Also, the interface configuration depends on the network settings of the
// particular machine.

{

\(dqDhcp4\(dq: {

    // Add names of your network interfaces to listen on.
    \(dqinterfaces\-config\(dq: {
        // The DHCPv4 server listens on this interface. When changing this to
        // the actual name of your interface, make sure to also update the
        // interface parameter in the subnet definition below.
        \(dqinterfaces\(dq: [ \(dqenp0s8\(dq ]
    },

    // Control socket is required for communication with the
    // DHCP server. High Availability requires HTTP/HTTPS control sockets
    // to be configured because lease updates are sent over the RESTful
    // API between the HA peers.
    \(dqcontrol\-socket\(dq: {
        \(dqsocket\-type\(dq: \(dqhttp\(dq,

        // We need to specify where the agent should listen to incoming HTTP
        // queries.
        \(dqsocket\-address\(dq: \(dq192.168.1.3\(dq,

        // This specifies the port the server will listen on.
        \(dqsocket\-port\(dq: 8000
    },

    // Use Memfile lease database backend to store leases in a CSV file.
    // Depending on how Kea was compiled, it may also support SQL databases
    // (MySQL and/or PostgreSQL). Those database backends require more
    // parameters, like name, host and possibly user and password.
    // There are dedicated examples for each backend. See Section 7.2.2 \(dqLease
    // Storage\(dq for details.
    \(dqlease\-database\(dq: {
        // Memfile is the simplest and easiest backend to use. It\(aqs an in\-memory
        // database with data being written to a CSV file. It is very similar to
        // what ISC DHCP does.
        \(dqtype\(dq: \(dqmemfile\(dq
    },

    // Let\(aqs configure some global parameters. The home network is not very dynamic
    // and there\(aqs no shortage of addresses, so no need to recycle aggressively.
    \(dqvalid\-lifetime\(dq: 43200, // leases will be valid for 12h
    \(dqrenew\-timer\(dq: 21600, // clients should renew every 6h
    \(dqrebind\-timer\(dq: 32400, // clients should start looking for other servers after 9h

    // Kea will clean up its database of expired leases once per hour. However, it
    // will keep the leases in expired state for 2 days. This greatly increases the
    // chances for returning devices to get the same address again. To guarantee that,
    // use host reservation.
    // If both \(dqflush\-reclaimed\-timer\-wait\-time\(dq and \(dqhold\-reclaimed\-time\(dq are
    // not 0, when the client sends a release message the lease is expired
    // instead of being deleted from lease storage.
    \(dqexpired\-leases\-processing\(dq: {
        \(dqreclaim\-timer\-wait\-time\(dq: 3600,
        \(dqhold\-reclaimed\-time\(dq: 172800,
        \(dqmax\-reclaim\-leases\(dq: 0,
        \(dqmax\-reclaim\-time\(dq: 0
    },

    // Multi\-threading parameters.
    \(dqmulti\-threading\(dq: {
        // By default, Kea processes packets on multiple threads if the hardware
        // permits. This example uses single\-threaded configuration.
        \(dqenable\-multi\-threading\(dq: false,

        // When multi\-threading is enabled, Kea will process packets on a
        // number of multiple threads configurable through this option. The
        // value must be a positive integer (0 means auto\-detect).
        \(dqthread\-pool\-size\(dq: 0,

        // When multi\-threading is enabled, Kea will read packets from the
        // interface and append a working item to the thread pool. This
        // option configures the maximum number of items that can be queued.
        // The value must be a positive integer (0 means unlimited).
        \(dqpacket\-queue\-size\(dq: 0
    },

    // HA requires two hook libraries to be loaded: libdhcp_lease_cmds.so and
    // libdhcp_ha.so. The former handles incoming lease updates from the HA peers.
    // The latter implements high availability feature for Kea. Note the library name
    // should be the same, but the path is OS specific.
    \(dqhooks\-libraries\(dq: [
        // The lease_cmds library must be loaded because HA makes use of it to
        // deliver lease updates to the server as well as synchronize the
        // lease database after failure.
        {
            \(dqlibrary\(dq: \(dqlibdhcp_lease_cmds.so\(dq
        },

        {
            // The HA hook library should be loaded.
            \(dqlibrary\(dq: \(dqlibdhcp_ha.so\(dq,
            \(dqparameters\(dq: {
                // Each server should have the same HA configuration, except for the
                // \(dqthis\-server\-name\(dq parameter.
                \(dqhigh\-availability\(dq: [ {
                    // This parameter points to this server instance. The respective
                    // HA peers must have this parameter set to their own names.
                    \(dqthis\-server\-name\(dq: \(dqserver2\(dq,
                    // The HA mode is set to hot\-standby. In this mode, the active server handles
                    // all the traffic. The standby takes over if the primary becomes unavailable.
                    \(dqmode\(dq: \(dqhot\-standby\(dq,
                    // Heartbeat is to be sent every 10 seconds if no other control
                    // commands are transmitted.
                    \(dqheartbeat\-delay\(dq: 10000,
                    // Maximum time for partner\(aqs response to a heartbeat, after which
                    // failure detection is started. This is specified in milliseconds.
                    // If we don\(aqt hear from the partner in 60 seconds, it\(aqs time to
                    // start worrying.
                    \(dqmax\-response\-delay\(dq: 60000,
                    // The following parameters control how the server detects the
                    // partner\(aqs failure. The ACK delay sets the threshold for the
                    // \(aqsecs\(aq field of the received discovers. This is specified in
                    // milliseconds.
                    \(dqmax\-ack\-delay\(dq: 5000,
                    // This specifies the number of clients which send messages to
                    // the partner but appear to not receive any response.
                    \(dqmax\-unacked\-clients\(dq: 5,
                    // This specifies the maximum timeout (in milliseconds) for the server
                    // to complete sync. If you have a large deployment (high tens or
                    // hundreds of thousands of clients), you may need to increase it
                    // further. The default value is 60000ms (60 seconds).
                    \(dqsync\-timeout\(dq: 60000,
                    // Multi\-threading parameters.
                    \(dqmulti\-threading\(dq: {
                        // By default, Kea processes packets on multiple threads if the hardware
                        // permits. This example uses single\-threaded configuration.
                       \(dqenable\-multi\-threading\(dq: false,
                       \(dqhttp\-dedicated\-listener\(dq: false,
                       \(dqhttp\-listener\-threads\(dq: 0,
                       \(dqhttp\-client\-threads\(dq: 0
                    },
                    \(dqpeers\(dq: [
                        // This is the configuration of the primary server.
                        {
                            \(dqname\(dq: \(dqserver1\(dq,
                            // Specifies the URL on which the partner\(aqs control
                            // channel can be reached.
                            // The \(dqcontrol\-socket\(dq is needed for the High Availability
                            // with single\-threading, and the \(dqsocket\-address\(dq and
                            // \(dqsocket\-port\(dq must be set to the corresponding values.
                            \(dqurl\(dq: \(dqhttp://192.168.1.2:8000/\(dq,
                            // The other server is primary. This one must be
                            // secondary.
                            \(dqrole\(dq: \(dqprimary\(dq
                        },
                        // This is the configuration of this server instance.
                        {
                            \(dqname\(dq: \(dqserver2\(dq,
                            // This specifies the URL of this server instance.
                            // The \(dqcontrol\-socket\(dq is needed for the High Availability
                            // with single\-threading, and the \(dqsocket\-address\(dq and
                            // \(dqsocket\-port\(dq must be set to the corresponding values.
                            \(dqurl\(dq: \(dqhttp://192.168.1.3:8000/\(dq,
                            // This server is secondary. The other one must be
                            // primary.
                            \(dqrole\(dq: \(dqstandby\(dq
                        }
                    ]
                } ]
            }
        }
    ],

    // This example contains a single subnet declaration.
    \(dqsubnet4\(dq: [
        {
            // Subnet prefix.
            \(dqsubnet\(dq: \(dq192.168.1.0/24\(dq,

            // There are no relays in this network, so we need to tell Kea that this subnet
            // is reachable directly via the specified interface.
            \(dqinterface\(dq: \(dqenp0s8\(dq,

            // Specify a dynamic address pool.
            \(dqpools\(dq: [
                {
                    \(dqpool\(dq: \(dq192.168.1.100\-192.168.1.199\(dq
                }
            ],

            // These are options that are subnet specific. In most cases, you need to define at
            // least routers option, as without this option your clients will not be able to reach
            // their default gateway and will not have Internet connectivity. If you have many
            // subnets and they share the same options (e.g. DNS servers typically is the same
            // everywhere), you may define options at the global scope, so you don\(aqt repeat them
            // for every network.
            \(dqoption\-data\(dq: [
                {
                    // For each IPv4 subnet you typically need to specify at least one router.
                    \(dqname\(dq: \(dqrouters\(dq,
                    \(dqdata\(dq: \(dq192.168.1.1\(dq
                },
                {
                    // Using cloudflare or Quad9 is a reasonable option. Change this
                    // to your own DNS servers is you have them. Another popular
                    // choice is 8.8.8.8, owned by Google. Using third party DNS
                    // service raises some privacy concerns.
                    \(dqname\(dq: \(dqdomain\-name\-servers\(dq,
                    \(dqdata\(dq: \(dq1.1.1.1,9.9.9.9\(dq
                }
            ],

            // Some devices should get a static address. Since the .100 \- .199 range is dynamic,
            // let\(aqs use the lower address space for this. There are many ways how reservation
            // can be defined, but using MAC address (hw\-address) is by far the most popular one.
            // You can use client\-id, duid and even custom defined flex\-id that may use whatever
            // parts of the packet you want to use as identifiers. Also, there are many more things
            // you can specify in addition to just an IP address: extra options, next\-server, hostname,
            // assign device to client classes etc. See the Kea ARM, Section 8.3 for details.
            // The reservations are subnet specific.
            \(dqreservations\(dq: [
                {
                    \(dqhw\-address\(dq: \(dq1a:1b:1c:1d:1e:1f\(dq,
                    \(dqip\-address\(dq: \(dq192.168.1.10\(dq
                },
                {
                    \(dqclient\-id\(dq: \(dq01:11:22:33:44:55:66\(dq,
                    \(dqip\-address\(dq: \(dq192.168.1.11\(dq
                }
            ]
        }
    ],

    // Logging configuration starts here.
    \(dqloggers\(dq: [
    {
        // This section affects kea\-dhcp4, which is the base logger for DHCPv4 component. It tells
        // DHCPv4 server to write all log messages (on severity INFO or higher) to a file. The file
        // will be rotated once it grows to 2MB and up to 4 files will be kept. The debuglevel
        // (range 0 to 99) is used only when logging on DEBUG level.
        \(dqname\(dq: \(dqkea\-dhcp4\(dq,
        \(dqoutput\-options\(dq: [
            {
                \(dqoutput\(dq: \(dq/var/log/kea/kea\-dhcp4.log\(dq,
                \(dqmaxsize\(dq: 2048000,
                \(dqmaxver\(dq: 4
            }
        ],
        \(dqseverity\(dq: \(dqINFO\(dq,
        \(dqdebuglevel\(dq: 0
    }
  ]
}
}

.EE
.UNINDENT
.UNINDENT.SS الگو: سرور Kea DHCP امن با دسترسی‌پذیری بالا (HA) و چندریسمانی (Multi\-Threading)
.sp
در زیر الگوهایی برای کمک به پیکربندی یک سرور امن Kea DHCP به همراه چندریسمانی (multi\-threading) آورده شده است. این الگوها مفروضات زیر را در نظر می‌گیرند:
.INDENT 0.0
.IP \(bu 2
مدیر سیستم می‌خواهد قابلیت دسترسی‌پذیری بالا (HA) را با چندریسمانی (multi\-threading) راه‌اندازی کند.
.IP \(bu 2
ماشین‌های اجراکننده Kea با چندریسمانی دست‌کم چهار هسته پردازنده (CPU) دارند.
.IP \(bu 2
ارتباط با کارگزار همتا (peer) با استفاده از TLS امن شده است.
.UNINDENT
.sp
ساختار منطقی شامل دو میزبان است که هرکدام یک سرور Kea DHCPv4 را اجرا می‌کنند.
در ساختار چندریسمانی، سوکت‌های کنترلی الزامی نیستند، زیرا سرور از شنونده HTTP
اختصاصی خود برای برقراری ارتباط با همتا استفاده می‌کند. با این حال، هنوز می‌توان از
سوکت‌های کنترلی HTTPS برای رسیدگی به دستورات کاربر استفاده کرد.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
+\-host\-1\-+       +\-host\-2\-+
|        |       |        |
| DHCPv4 ========= DHCPv4 |    ===== \- اتصال HTTPS
|        |       |        |
+\-\-\-\-\-\-\-\-+       +\-\-\-\-\-\-\-\-+
.EE
.UNINDENT
.UNINDENT
.sp
سرورها روی host\-1 و host\-2 هر دو روی درگاه 8001 گوش می‌دهند، و شنونده اختصاصی HTTP سرور
از درگاه 8000 استفاده می‌کند. سرورهای DHCP از طریق این شنونده اختصاصی HTTP با یکدیگر
ارتباط برقرار می‌کنند که فقط دستورات به‌روزرسانی اجاره (lease\-update) را به سرور همتا ارسال می‌کند.
.SS ملاحظات استقرار (Deployment Considerations)
.sp
انتظار نمی‌رود این ساختار به طور خودکار مقیاس‌پذیر شود. این مثال از چهار ریسمان (thread) برای
پردازش ترافیک DHCP، چهار ریسمان برای گوش دادن و مدیریت درخواست‌های HTTP همتای HA،
و چهار ریسمان برای ارسال به‌روزرسانی‌های اجاره به همتای HA استفاده می‌کند. صف ریسمان مورد استفاده برای
ذخیره درخواست‌های دریافتی DHCP روی 64 تنظیم شده است، اما برای تعیین مقادیر مناسب جهت دستیابی به
بهترین کارایی در ساختار استقرار، آزمایش‌ها و محک‌زنی‌های (benchmarks) دقیق لازم است.
.sp
در این مثال، دو میزبان وجود دارند که Kea را اجرا می‌کنند:
.INDENT 0.0
.IP \(bu 2
192.168.1.2 \- سرور اصلی HA (فعال/active، تمام ترافیک را مدیریت می‌کند)
.IP \(bu 2
192.168.1.3 \- سرور ثانویه HA (غیرفعال/passive، آماده برای در دست گرفتن کنترل در صورت خرابی سرور اصلی)
.UNINDENT
.sp
شبکه 192.168.1.0/24 است. فرض می‌شود که 192.168.1.1 مسیریاب پیش‌فرض (default router) است.
.sp
کل زیرشبکه به استخرهای پویا (dynamic pools) تقسیم شده است:
.INDENT 0.0
.IP \(bu 2
192.168.1.100 \- 192.168.1.199 \- این استخر پویا است. هنگامی که دستگاه‌های جدید در شبکه ظاهر می‌شوند،
نشانی‌های پویایی از این استخر به آن‌ها تخصیص می‌یابد.
.UNINDENT
.sp
برای استقرار این ساختار، مراحل ارائه‌شده در بخش راه‌اندازی خانگی کاربر پیشرفته را با تمایزهای زیر دنبال کنید:
.INDENT 0.0
.IP 1. 3
موارد زیر را متناسب با پیکربندی محلی تغییر دهید:
.INDENT 3.0
.IP \(bu 2
مسیرهای \fBtrust\-anchor\fP، \fBcert\-file\fP و \fBkey\-file\fP باید روی مقادیر متناظر
با ماشین استقرار تنظیم شوند.
.IP \(bu 2
در صورت استفاده از شبکه‌ای غیر از 192.168.1.0/24، آدرس‌دهی باید به‌روزرسانی شود.
اطمینان حاصل کنید که پیکربندی نشانی و درگاه سوکت کنترلی
(\fBsocket\-address\fP و \fBsocket\-port\fP) با پیکربندی HA
(\fBurl\fP در \fBhook\-libraries/parameters/high\-availability/peers\fP) متفاوت باشد.
سوکت کنترلی HTTP فقط برای مدیریت دستورات مدیریتی به کار می‌رود،
زیرا ماژول HA به‌روزرسانی‌های اجاره را با استفاده از شنونده اختصاصی HTTP به همتا ارسال می‌کند.
.UNINDENT
.IP 2. 3
با بررسی لاگ‌های Kea، ارتباط بین همتاهای HA را راستی‌آزمایی کنید.
.IP 3. 3
با تکرار مرحله ۳ از مبدا host\-2 با استفاده از نشانی IP و درگاه host\-1، بررسی کنید که
ارتباط بین میزبان‌ها در جهت معکوس نیز کار می‌کند (host\-2 بتواند به host\-1 متصل شود).
.IP 4. 3
نرم‌افزار DHCPv4 را همانند مراحل ۱ و ۲ روی host\-2 نصب کنید. فایل پیکربندی سرور
آماده‌به‌کار (standby) به‌جز تعریف فیلد \fBthis\-server\-name\fP (و احتمالاً نام رابط‌های شبکه)،
بسیار شبیه به فایل سرور اصلی است.
.UNINDENT
.SS توسعه‌های احتمالی (Possible Extensions)
.sp
این پیکربندی نمونه ساده اما کاربردی است. پس از راه‌اندازی و اجرا، ممکن است مدیران سیستم
بخواهند تغییرات زیر را در نظر بگیرند:
.INDENT 0.0
.IP \(bu 2
در صورت استفاده از پایگاه‌داده، امکان پیکربندی TLS برای backend پایگاه‌داده نیز وجود دارد (برای
اجاره، میزبان، بک‌اند پیکربندی یا لاگ‌گیری جرم‌یابی). برای اطلاعات بیشتر بخش اتصال پایگاه‌داده \%<#\:database-connectivity>
را ببینید.
.UNINDENT
.sp
ممکن است برای تطبیق این الگوها با نیازهای خاص سیستم، به مقداری تنظیم نیاز باشد:
دست‌کم، خطوط برجسته‌شده باید متناسب با استقرار واقعی تنظیم شوند.
.sp
فایل پیکربندی DHCPv4 برای Server1:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک پیکربندی نمونه برای سرور ۱ Kea DHCPv4 است:
//
// \- برای فعال کردن قابلیت دسترسی‌پذیری بالا (HA) در سرور DHCP، از کتابخانه‌های قلاب
//   High Availability و Lease Commands استفاده می‌کند. این فایل پیکربندی
//   برای سرور اصلی (فعال/active) است.
// \- از memfile استفاده می‌کند که اطلاعات اجاره را در یک فایل CSV محلی ذخیره می‌نماید
// \- فرض را بر یک آدرس‌دهی تک /24 روی پیوندی می‌گذارد که مستقیماً در دسترس است
//   (بدون رله‌های DHCP)
// \- شامل تعداد اندکی رزرو IP است
//
// انتظار می‌رود این سرور در کنار یک سرور آماده‌به‌کار (غیرفعال/passive) که پیکربندی بسیار مشابهی
// دارد اجرا شود. تنها تفاوت این است که \(dqthis\-server\-name\(dq در سرور دیگر باید روی \(dqserver2\(dq
// تنظیم شود. همچنین پیکربندی رابط و مکان فایل‌های مربوط به TLS به تنظیمات شبکه
// و پیکربندی آن ماشین خاص بستگی دارد.

{

\(dqDhcp4\(dq: {

    // نام‌های رابط‌های شبکه خود را برای گوش دادن اضافه کنید.
    \(dqinterfaces\-config\(dq: {
        // سرور DHCPv4 روی این رابط گوش می‌دهد. در صورت تغییر این مقدار به
        // نام واقعی رابط خود، حتماً پارامتر interface را در تعریف زیرشبکه در زیر
        // نیز به‌روزرسانی کنید.
        \(dqinterfaces\(dq: [ \(dqenp0s8\(dq ]
    },

    // سوکت کنترلی برای برقراری ارتباط با سرور DHCP الزامی است.
    // دسترسی‌پذیری بالا (HA) به پیکربندی سوکت‌های کنترلی HTTP/HTTPS نیاز دارد
    // زیرا به‌روزرسانی‌های اجاره از طریق RESTful API بین همتاهای HA
    // ارسال می‌شوند.
    \(dqcontrol\-socket\(dq: {
        \(dqsocket\-type\(dq: \(dqhttps\(dq,

        // باید مشخص کنیم که سرور در کجا باید به پرس‌وجوهای ورودی HTTP
        // گوش دهد.
        \(dqsocket\-address\(dq: \(dq192.168.1.2\(dq,

        // این درگاهی را مشخص می‌کند که سرور روی آن گوش خواهد داد.
        // در صورت فعال‌سازی HA و چندریسمانی، درگاه 8000 توسط شنونده http
        // کتابخانه قلاب HA استفاده می‌شود. هنگام استفاده از کتابخانه قلاب HA با
        // چندریسمانی، اطمینان حاصل کنید که درگاه استفاده‌شده توسط شنونده اختصاصی
        // با درگاه سرور متفاوت باشد (مثلاً 8001). توجه داشته باشید که دستورات
        // همچنان باید به سوکت کنترلی ارسال شوند.
        // شنونده اختصاصی صرفاً برای به‌روزرسانی‌های HA است.
        \(dqsocket\-port\(dq: 8001,

        // لنگر اعتماد TLS (مرجع صدور گواهی یا CA). این یک نام فایل یا
        // (فقط برای OpenSSL) مسیر دایرکتوری است.
        \(dqtrust\-anchor\(dq: \(dq/usr/lib/kea/CA.pem\(dq,

        // نام فایل گواهی سرور TLS.
        \(dqcert\-file\(dq: \(dq/usr/lib/kea/ca1_cert.pem\(dq,

        // نام فایل کلید خصوصی سرور TLS.
        \(dqkey\-file\(dq: \(dq/usr/lib/kea/ca1_key.pem\(dq,

        // پرچم الزام گواهی‌های کلاینت در TLS.
        \(dqcert\-required\(dq: true
    },

    // پارامترهای چندریسمانی (Multi\-threading).
    \(dqmulti\-threading\(dq: {
        // به طور پیش‌فرض، در صورتی که سخت‌افزار اجازه دهد، Kea بسته‌ها را روی چندین ریسمان پردازش می‌کند.
        \(dqenable\-multi\-threading\(dq: true,

        // هنگامی که چندریسمانی فعال باشد، Kea بسته‌ها را روی تعدادی ریسمان
        // که از طریق این گزینه قابل پیکربندی است پردازش می‌کند.
        // مقدار باید یک عدد صحیح مثبت باشد (0 یعنی تشخیص خودکار).
        \(dqthread\-pool\-size\(dq: 4,

        // هنگامی که چندریسمانی فعال باشد، Kea بسته‌ها را از رابط می‌خواند
        // و یک مورد کاری به استخر ریسمان‌ها می‌افزاید. این گزینه حداکثر
        // تعداد مواردی را که می‌توانند صف‌بندی شوند پیکربندی می‌کند.
        // مقدار باید یک عدد صحیح مثبت باشد (0 یعنی نامحدود).
        \(dqpacket\-queue\-size\(dq: 64
    },

    // از بک‌اند پایگاه‌داده اجاره Memfile برای ذخیره اجاره‌ها در یک فایل CSV استفاده کنید.
    // بسته به نحوه کامپایل شدن Kea، ممکن است از پایگاه‌های داده SQL
    // (مانند MySQL و/یا PostgreSQL) نیز پشتیبانی کند. آن بک‌اندهای پایگاه‌داده نیازمند
    // پارامترهای بیشتری مانند name ،host و احتمالاً user و password هستند.
    // مثال‌های اختصاصی برای هر بک‌اند وجود دارد. برای جزئیات به بخش 7.2.2 \(dqLease
    // Storage\(dq مراجعه کنید.
    \(dqlease\-database\(dq: {
        // بک‌اند Memfile ساده‌ترین بک‌اند برای استفاده است. این یک پایگاه‌داده درون‌حافظه‌ای
        // با قابلیت نوشتن داده‌ها در یک فایل CSV است. این رفتار بسیار شبیه به
        // عملکرد ISC DHCP است.
        \(dqtype\(dq: \(dqmemfile\(dq
    },

    // بیایید چند پارامتر عمومی را پیکربندی کنیم. شبکه خانگی خیلی پویا نیست
    // و کمبود نشانی وجود ندارد، بنابراین نیازی به بازیافت تهاجمی نیست.
    \(dqvalid\-lifetime\(dq: 43200, // اجاره‌ها به مدت ۱۲ ساعت معتبر خواهند بود
    \(dqrenew\-timer\(dq: 21600, // کلاینت‌ها باید هر ۶ ساعت تمدید کنند
    \(dqrebind\-timer\(dq: 32400, // کلاینت‌ها پس از ۹ ساعت باید جستجو برای سرورهای دیگر را آغاز کنند

    // نرم‌افزار Kea پایگاه‌داده اجاره‌های منقضی‌شده خود را یک بار در ساعت پاکسازی می‌کند.
    // با این حال، اجاره‌ها را به مدت ۲ روز در وضعیت منقضی نگه می‌دارد. این کار شانس
    // دریافت مجدد همان نشانی را توسط دستگاه‌های بازگشتی بسیار افزایش می‌دهد. برای ضمانت آن،
    // از رزرو میزبان استفاده کنید.
    // اگر هر دو مقدار \(dqflush\-reclaimed\-timer\-wait\-time\(dq و \(dqhold\-reclaimed\-time\(dq
    // برابر با 0 نباشند، هنگامی که کلاینت یک پیام release ارسال می‌کند، اجاره به جای حذف
    // از محل ذخیره اجاره، منقضی می‌شود.
    \(dqexpired\-leases\-processing\(dq: {
        \(dqreclaim\-timer\-wait\-time\(dq: 3600,
        \(dqhold\-reclaimed\-time\(dq: 172800,
        \(dqmax\-reclaim\-leases\(dq: 0,
        \(dqmax\-reclaim\-time\(dq: 0
    },

    // قابلیت HA نیازمند بارگذاری دو کتابخانه قلاب است: libdhcp_lease_cmds.so و
    // libdhcp_ha.so. اولی به‌روزرسانی‌های دریافتی اجاره را از همتاهای HA مدیریت می‌کند.
    // دومی قابلیت دسترسی‌پذیری بالا را برای Kea پیاده‌سازی می‌کند. توجه داشته باشید که نام
    // کتابخانه باید یکسان باشد، اما مسیر آن وابسته به سیستم‌عامل است.
    \(dqhooks\-libraries\(dq: [
        // کتابخانه lease_cmds باید بارگذاری شود زیرا HA از آن برای تحویل
        // به‌روزرسانی‌های اجاره به سرور و همچنین همگام‌سازی پایگاه‌داده
        // اجاره پس از خرابی استفاده می‌کند.
        {
            \(dqlibrary\(dq: \(dqlibdhcp_lease_cmds.so\(dq
        },

        {
            // کتابخانه قلاب HA باید بارگذاری شود.
            \(dqlibrary\(dq: \(dqlibdhcp_ha.so\(dq,
            \(dqparameters\(dq: {
                // هر سرور باید پیکربندی HA یکسانی داشته باشد، به جز
                // پارامتر \(dqthis\-server\-name\(dq.
                \(dqhigh\-availability\(dq: [ {
                    // این پارامتر به این نمونه سرور اشاره دارد. همتاهای مربوطه
                    // در HA باید این پارامتر را روی نام‌های خود تنظیم کنند.
                    \(dqthis\-server\-name\(dq: \(dqserver1\(dq,
                    // حالت HA روی hot\-standby تنظیم شده است. در این حالت، سرور فعال
                    // تمام ترافیک را مدیریت می‌کند. در صورت عدم دسترسی سرور اصلی، سرور آماده‌به‌کار کنترل را در دست می‌گیرد.
                    \(dqmode\(dq: \(dqhot\-standby\(dq,
                    // در صورتی که هیچ دستور کنترلی دیگری ارسال نشود، ضربان قلب
                    // باید هر ۱۰ ثانیه یک‌بار فرستاده شود.
                    \(dqheartbeat\-delay\(dq: 10000,
                    // حداکثر زمان برای پاسخ شریک به ضربان قلب، که پس از آن
                    // تشخیص خرابی آغاز می‌شود. این مقدار بر حسب میلی‌ثانیه مشخص شده است.
                    // اگر تا ۶۰ ثانیه پاسخی از شریک دریافت نکنیم، زمان
                    // نگران شدن فرا رسیده است.
                    \(dqmax\-response\-delay\(dq: 60000,
                    // پارامترهای زیر نحوه تشخیص خرابی شریک توسط سرور را کنترل
                    // می‌کنند. تاخیر ACK آستانه را برای فیلد \(aqsecs\(aq در discoverهای
                    // دریافتی تعیین می‌کند. این مقدار بر حسب میلی‌ثانیه مشخص شده است.
                    \(dqmax\-ack\-delay\(dq: 5000,
                    // این پارامتر تعداد کلاینت‌هایی را مشخص می‌کند که پیام‌هایی به
                    // شریک ارسال می‌کنند اما به نظر می‌رسد هیچ پاسخی دریافت نمی‌کنند.
                    \(dqmax\-unacked\-clients\(dq: 5,
                    // این پارامتر حداکثر مهلت زمانی (بر حسب میلی‌ثانیه) را برای تکمیل
                    // همگام‌سازی توسط سرور مشخص می‌کند. اگر استقرار بزرگی دارید (چند ده یا
                    // چند صد هزار کلاینت)، ممکن است نیاز به افزایش آن داشته باشید.
                    // مقدار پیش‌فرض 60000 میلی‌ثانیه (۶۰ ثانیه) است.
                    \(dqsync\-timeout\(dq: 60000,
                    // پارامترهای چندریسمانی.
                    // برای جلوگیری از افت کارایی هنگامی که سرور Kea بسته‌ها را
                    // روی چندین ریسمان پردازش می‌کند، ماژول دسترسی‌پذیری بالا (HA)
                    // باید قابلیت چندریسمانی را فعال داشته باشد.
                    \(dqmulti\-threading\(dq: {
                        // فعال‌سازی دسترسی‌پذیری بالا برای بهره‌مندی از چندریسمانی. پیش‌فرض: true.
                        \(dqenable\-multi\-threading\(dq: true,
                        // هنگام اجرا در حالت MT (چندریسمانی)، شنونده اختصاصی برای مدیریت
                        // به‌روزرسانی‌های اجاره استفاده می‌شود.
                        \(dqhttp\-dedicated\-listener\(dq: true,
                        // تعداد ریسمان‌های مورد استفاده برای مدیریت درخواست‌های ورودی.
                        // مقدار 0 به سرور دستور می‌دهد از همان تعداد ریسمانی استفاده کند
                        // که هسته Kea برای چندریسمانی DHCP استفاده می‌کند.
                        \(dqhttp\-listener\-threads\(dq: 0,
                        // تعداد ریسمان‌های مورد استفاده برای مدیریت درخواست‌های خروجی.
                        // مقدار 0 به سرور دستور می‌دهد از همان تعداد ریسمانی استفاده کند
                        // که هسته Kea برای چندریسمانی DHCP استفاده می‌کند.
                        \(dqhttp\-client\-threads\(dq: 0
                    },
                    \(dqpeers\(dq: [
                        // این پیکربندی مربوط به این نمونه سرور است.
                        {
                            \(dqname\(dq: \(dqserver1\(dq,
                            // این مقدار نشانی URL شنونده اختصاصی HTTP این سرور را مشخص می‌کند.
                            // مقدار \(dqcontrol\-socket\(dq برای دسترسی‌پذیری بالا با
                            // چندریسمانی الزامی نیست، اما در صورت استفاده، باید از مقادیر متفاوتی
                            // برای \(dqsocket\-address\(dq و \(dqsocket\-port\(dq استفاده کند.
                            \(dqurl\(dq: \(dqhttp://192.168.1.2:8005/\(dq,
                            // لنگر اعتماد یا فایل/دایرکتوری مرجع صدور گواهی (CA).
                            \(dqtrust\-anchor\(dq: \(dq/usr/lib/kea/CA.pem\(dq,
                            // نام فایل گواهی کلاینت.
                            \(dqcert\-file\(dq: \(dq/usr/lib/kea/server1_cert.pem\(dq,
                            // نام فایل کلید خصوصی.
                            \(dqkey\-file\(dq: \(dq/usr/lib/kea/server1_key.pem\(dq,
                            // گواهی‌های کلاینت الزامی بوده و اعتبارسنجی می‌شوند.
                            \(dqrequire\-client\-certs\(dq: true,
                            // این سرور اصلی (primary) است. سرور دیگر باید
                            // ثانویه باشد.
                            \(dqrole\(dq: \(dqprimary\(dq
                        },
                        // این پیکربندی مربوط به سرور ثانویه است.
                        {
                            \(dqname\(dq: \(dqserver2\(dq,
                            // این مقدار نشانی URL شنونده اختصاصی HTTP سرور دیگر را مشخص می‌کند.
                            // مقدار \(dqcontrol\-socket\(dq برای دسترسی‌پذیری بالا با
                            // چندریسمانی الزامی نیست، اما در صورت استفاده، باید از مقادیر متفاوتی
                            // برای \(dqsocket\-address\(dq و \(dqsocket\-port\(dq استفاده کند.
                            \(dqurl\(dq: \(dqhttp://192.168.1.3:8005/\(dq,
                            // لنگر اعتماد یا فایل/دایرکتوری مرجع صدور گواهی (CA).
                            \(dqtrust\-anchor\(dq: \(dq/usr/lib/kea/CA.pem\(dq,
                            // نام فایل گواهی کلاینت.
                            \(dqcert\-file\(dq: \(dq/usr/lib/kea/server2_cert.pem\(dq,
                            // نام فایل کلید خصوصی.
                            \(dqkey\-file\(dq: \(dq/usr/lib/kea/server2_key.pem\(dq,
                            // گواهی‌های کلاینت الزامی بوده و اعتبارسنجی می‌شوند.
                            \(dqrequire\-client\-certs\(dq: true,
                            // سرور دیگر ثانویه است. این یکی باید
                            // اصلی باشد.
                            \(dqrole\(dq: \(dqstandby\(dq
                        }
                    ]
                } ]
            }
        }
    ],

    // این مثال شامل تعریف یک زیرشبکه تکی است.
    \(dqsubnet4\(dq: [
        {
            // پیشوند زیرشبکه.
            \(dqsubnet\(dq: \(dq192.168.1.0/24\(dq,

            // هیچ رله‌ای در این شبکه وجود ندارد، بنابراین باید به Kea اعلام کنیم که این زیرشبکه
            // مستقیماً از طریق رابط مشخص‌شده در دسترس است.
            \(dqinterface\(dq: \(dqenp0s8\(dq,

            // یک استخر نشانی پویا مشخص کنید.
            \(dqpools\(dq: [
                {
                    \(dqpool\(dq: \(dq192.168.1.100\-192.168.1.199\(dq
                }
            ]
        }
    ],

    // پیکربندی لاگ‌گیری از اینجا شروع می‌شود.
    \(dqloggers\(dq: [
    {
        // این بخش بر kea\-dhcp4 اثر می‌گذارد که لاگر پایه برای مؤلفه DHCPv4 است. این بخش به
        // سرور DHCPv4 می‌گوید که تمام پیام‌های لاگ (با شدت INFO یا بالاتر) را در یک فایل بنویسد. فایل
        // به محض رسیدن به اندازه 2MB چرخش داده خواهد شد و حداکثر ۴ فایل نگه داشته می‌شود. مقدار debuglevel
        // (محدوده 0 تا 99) فقط هنگام لاگ‌گیری در سطح DEBUG استفاده می‌شود.
        \(dqname\(dq: \(dqkea\-dhcp4\(dq,
        \(dqoutput\-options\(dq: [
            {
                \(dqoutput\(dq: \(dq/var/log/kea/kea\-dhcp4.log\(dq,
                \(dqmaxsize\(dq: 2048000,
                \(dqmaxver\(dq: 4
            }
        ],
        \(dqseverity\(dq: \(dqINFO\(dq,
        \(dqdebuglevel\(dq: 0
    }
  ]
}
}

.EE
.UNINDENT
.UNINDENT
.sp
فایل پیکربندی DHCPv4 برای Server2:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
// این یک پیکربندی نمونه برای سرور ۲ Kea DHCPv4 است:
//
// \- برای فعال کردن قابلیت دسترسی‌پذیری بالا (HA) در سرور DHCP، از کتابخانه‌های قلاب
//   High Availability و Lease Commands استفاده می‌کند. این فایل پیکربندی
//   برای سرور ثانویه (آماده‌به‌کار/standby) است.
// \- از memfile استفاده می‌کند که اطلاعات اجاره را در یک فایل CSV محلی ذخیره می‌نماید
// \- فرض را بر یک آدرس‌دهی تک /24 روی پیوندی می‌گذارد که مستقیماً در دسترس است
//   (بدون رله‌های DHCP)
// \- شامل تعداد اندکی رزرو IP است
//
// انتظار می‌رود این سرور در کنار یک سرور اصلی (فعال/active) که پیکربندی بسیار مشابهی
// دارد اجرا شود. تنها تفاوت این است که \(dqthis\-server\-name\(dq در سرور دیگر باید روی \(dqserver2\(dq
// تنظیم شود. همچنین پیکربندی رابط و مکان فایل‌های مربوط به TLS به تنظیمات شبکه
// و پیکربندی آن ماشین خاص بستگی دارد.

{

\(dqDhcp4\(dq: {

    // نام‌های رابط‌های شبکه خود را برای گوش دادن اضافه کنید.
    \(dqinterfaces\-config\(dq: {
        // سرور DHCPv4 روی این رابط گوش می‌دهد. در صورت تغییر این مقدار به
        // نام واقعی رابط خود، حتماً پارامتر interface را در تعریف زیرشبکه در زیر
        // نیز به‌روزرسانی کنید.
        \(dqinterfaces\(dq: [ \(dqenp0s8\(dq ]
    },

    // سوکت کنترلی برای برقراری ارتباط با سرور DHCP الزامی است.
    // دسترسی‌پذیری بالا (HA) به پیکربندی سوکت‌های کنترلی HTTP/HTTPS نیاز دارد
    // زیرا به‌روزرسانی‌های اجاره از طریق RESTful API بین همتاهای HA
    // ارسال می‌شوند.
    \(dqcontrol\-socket\(dq: {
        \(dqsocket\-type\(dq: \(dqhttps\(dq,

        // باید مشخص کنیم که سرور در کجا باید به پرس‌وجوهای ورودی HTTP
        // گوش دهد.
        \(dqsocket\-address\(dq: \(dq192.168.1.3\(dq,

        // این درگاهی را مشخص می‌کند که سرور روی آن گوش خواهد داد.
        // در صورت فعال‌سازی HA و چندریسمانی، درگاه 8000 توسط شنونده http
        // کتابخانه قلاب HA استفاده می‌شود. هنگام استفاده از کتابخانه قلاب HA با
        // چندریسمانی، اطمینان حاصل کنید که درگاه استفاده‌شده توسط شنونده اختصاصی
        // با درگاه سرور متفاوت باشد (مثلاً 8001). توجه داشته باشید که دستورات
        // همچنان باید به سوکت کنترلی ارسال شوند.
        // شنونده اختصاصی صرفاً برای به‌روزرسانی‌های HA است.
        \(dqsocket\-port\(dq: 8001,

        // لنگر اعتماد TLS (مرجع صدور گواهی یا CA). این یک نام فایل یا
        // (فقط برای OpenSSL) مسیر دایرکتوری است.
        \(dqtrust\-anchor\(dq: \(dq/usr/lib/kea/CA.pem\(dq,

        // نام فایل گواهی سرور TLS.
        \(dqcert\-file\(dq: \(dq/usr/lib/kea/ca2_cert.pem\(dq,

        // نام فایل کلید خصوصی سرور TLS.
        \(dqkey\-file\(dq: \(dq/usr/lib/kea/ca2_key.pem\(dq,

        // پرچم الزام گواهی‌های کلاینت در TLS.
        \(dqcert\-required\(dq: true
    },

    // پارامترهای چندریسمانی (Multi\-threading).
    \(dqmulti\-threading\(dq: {
        // به طور پیش‌فرض، در صورتی که سخت‌افزار اجازه دهد، Kea بسته‌ها را روی چندین ریسمان پردازش می‌کند.
        \(dqenable\-multi\-threading\(dq: true,

        // هنگامی که چندریسمانی فعال باشد، Kea بسته‌ها را روی تعدادی ریسمان
        // که از طریق این گزینه قابل پیکربندی است پردازش می‌کند.
        // مقدار باید یک عدد صحیح مثبت باشد (0 یعنی تشخیص خودکار).
        \(dqthread\-pool\-size\(dq: 4,

        // هنگامی که چندریسمانی فعال باشد، Kea بسته‌ها را از رابط می‌خواند
        // و یک مورد کاری به استخر ریسمان‌ها می‌افزاید. این گزینه حداکثر
        // تعداد مواردی را که می‌توانند صف‌بندی شوند پیکربندی می‌کند.
        // مقدار باید یک عدد صحیح مثبت باشد (0 یعنی نامحدود).
        \(dqpacket\-queue\-size\(dq: 64
    },

    // از بک‌اند پایگاه‌داده اجاره Memfile برای ذخیره اجاره‌ها در یک فایل CSV استفاده کنید.
    // بسته به نحوه کامپایل شدن Kea، ممکن است از پایگاه‌های داده SQL
    // (مانند MySQL و/یا PostgreSQL) نیز پشتیبانی کند. آن بک‌اندهای پایگاه‌داده نیازمند
    // پارامترهای بیشتری مانند name ،host و احتمالاً user و password هستند.
    // مثال‌های اختصاصی برای هر بک‌اند وجود دارد. برای جزئیات به بخش 7.2.2 \(dqLease
    // Storage\(dq مراجعه کنید.
    \(dqlease\-database\(dq: {
        // بک‌اند Memfile ساده‌ترین بک‌اند برای استفاده است. این یک پایگاه‌داده درون‌حافظه‌ای
        // با قابلیت نوشتن داده‌ها در یک فایل CSV است. این رفتار بسیار شبیه به
        // عملکرد ISC DHCP است.
        \(dqtype\(dq: \(dqmemfile\(dq
    },

    // بیایید چند پارامتر عمومی را پیکربندی کنیم. شبکه خانگی خیلی پویا نیست
    // و کمبود نشانی وجود ندارد، بنابراین نیازی به بازیافت تهاجمی نیست.
    \(dqvalid\-lifetime\(dq: 43200, // اجاره‌ها به مدت ۱۲ ساعت معتبر خواهند بود
    \(dqrenew\-timer\(dq: 21600, // کلاینت‌ها باید هر ۶ ساعت تمدید کنند
    \(dqrebind\-timer\(dq: 32400, // کلاینت‌ها پس از ۹ ساعت باید جستجو برای سرورهای دیگر را آغاز کنند

    // نرم‌افزار Kea پایگاه‌داده اجاره‌های منقضی‌شده خود را یک بار در ساعت پاکسازی می‌کند.
    // با این حال، اجاره‌ها را به مدت ۲ روز در وضعیت منقضی نگه می‌دارد. این کار شانس
    // دریافت مجدد همان نشانی را توسط دستگاه‌های بازگشتی بسیار افزایش می‌دهد. برای ضمانت آن،
    // از رزرو میزبان استفاده کنید.
    // اگر هر دو مقدار \(dqflush\-reclaimed\-timer\-wait\-time\(dq و \(dqhold\-reclaimed\-time\(dq
    // برابر با 0 نباشند، هنگامی که کلاینت یک پیام release ارسال می‌کند، اجاره به جای حذف
    // از محل ذخیره اجاره، منقضی می‌شود.
    \(dqexpired\-leases\-processing\(dq: {
        \(dqreclaim\-timer\-wait\-time\(dq: 3600,
        \(dqhold\-reclaimed\-time\(dq: 172800,
        \(dqmax\-reclaim\-leases\(dq: 0,
        \(dqmax\-reclaim\-time\(dq: 0
    },

    // قابلیت HA نیازمند بارگذاری دو کتابخانه قلاب است: libdhcp_lease_cmds.so و
    // libdhcp_ha.so. اولی به‌روزرسانی‌های دریافتی اجاره را از همتاهای HA مدیریت می‌کند.
    // دومی قابلیت دسترسی‌پذیری بالا را برای Kea پیاده‌سازی می‌کند. توجه داشته باشید که نام
    // کتابخانه باید یکسان باشد، اما مسیر آن وابسته به سیستم‌عامل است.
    \(dqhooks\-libraries\(dq: [
        // کتابخانه lease_cmds باید بارگذاری شود زیرا HA از آن برای تحویل
        // به‌روزرسانی‌های اجاره به سرور و همچنین همگام‌سازی پایگاه‌داده
        // اجاره پس از خرابی استفاده می‌کند.
        {
            \(dqlibrary\(dq: \(dqlibdhcp_lease_cmds.so\(dq
        },

        {
            // کتابخانه قلاب HA باید بارگذاری شود.
            \(dqlibrary\(dq: \(dqlibdhcp_ha.so\(dq,
            \(dqparameters\(dq: {
                // هر سرور باید پیکربندی HA یکسانی داشته باشد، به جز
                // پارامتر \(dqthis\-server\-name\(dq.
                \(dqhigh\-availability\(dq: [ {
                    // این پارامتر به این نمونه سرور اشاره دارد. همتاهای مربوطه
                    // در HA باید این پارامتر را روی نام‌های خود تنظیم کنند.
                    \(dqthis\-server\-name\(dq: \(dqserver2\(dq,
                    // حالت HA روی hot\-standby تنظیم شده است. در این حالت، سرور فعال
                    // تمام ترافیک را مدیریت می‌کند. در صورت عدم دسترسی سرور اصلی، سرور آماده‌به‌کار کنترل را در دست می‌گیرد.
                    \(dqmode\(dq: \(dqhot\-standby\(dq,
                    // در صورتی که هیچ دستور کنترلی دیگری ارسال نشود، ضربان قلب
                    // باید هر ۱۰ ثانیه یک‌بار فرستاده شود.
                    \(dqheartbeat\-delay\(dq: 10000,
                    // حداکثر زمان برای پاسخ شریک به ضربان قلب، که پس از آن
                    // تشخیص خرابی آغاز می‌شود. این مقدار بر حسب میلی‌ثانیه مشخص شده است.
                    // اگر تا ۶۰ ثانیه پاسخی از شریک دریافت نکنیم، زمان
                    // نگران شدن فرا رسیده است.
                    \(dqmax\-response\-delay\(dq: 60000,
                    // پارامترهای زیر نحوه تشخیص خرابی شریک توسط سرور را کنترل
                    // می‌کنند. تاخیر ACK آستانه را برای فیلد \(aqsecs\(aq در discoverهای
                    // دریافتی تعیین می‌کند. این مقدار بر حسب میلی‌ثانیه مشخص شده است.
                    \(dqmax\-ack\-delay\(dq: 5000,
                    // این پارامتر تعداد کلاینت‌هایی را مشخص می‌کند که پیام‌هایی به
                    // شریک ارسال می‌کنند اما به نظر می‌رسد هیچ پاسخی دریافت نمی‌کنند.
                    \(dqmax\-unacked\-clients\(dq: 5,
                    // این پارامتر حداکثر مهلت زمانی (بر حسب میلی‌ثانیه) را برای تکمیل
                    // همگام‌سازی توسط سرور مشخص می‌کند. اگر استقرار بزرگی دارید (چند ده یا
                    // چند صد هزار کلاینت)، ممکن است نیاز به افزایش آن داشته باشید.
                    // مقدار پیش‌فرض 60000 میلی‌ثانیه (۶۰ ثانیه) است.
                    \(dqsync\-timeout\(dq: 60000,
                    // پارامترهای چندریسمانی.
                    // برای جلوگیری از افت کارایی هنگامی که سرور Kea بسته‌ها را
                    // روی چندین ریسمان پردازش می‌کند، ماژول دسترسی‌پذیری بالا (HA)
                    // باید قابلیت چندریسمانی را فعال داشته باشد.
                    \(dqmulti\-threading\(dq: {
                        // فعال‌سازی دسترسی‌پذیری بالا برای بهره‌مندی از چندریسمانی. پیش‌فرض: true.
                        \(dqenable\-multi\-threading\(dq: true,
                        // هنگام اجرا در حالت MT (چندریسمانی)، شنونده اختصاصی برای مدیریت
                        // به‌روزرسانی‌های اجاره استفاده می‌شود.
                        \(dqhttp\-dedicated\-listener\(dq: true,
                        // تعداد ریسمان‌های مورد استفاده برای مدیریت درخواست‌های ورودی.
                        // مقدار 0 به سرور دستور می‌دهد از همان تعداد ریسمانی استفاده کند
                        // که هسته Kea برای چندریسمانی DHCP استفاده می‌کند.
                        \(dqhttp\-listener\-threads\(dq: 0,
                        // تعداد ریسمان‌های مورد استفاده برای مدیریت درخواست‌های خروجی.
                        // مقدار 0 به سرور دستور می‌دهد از همان تعداد ریسمانی استفاده کند
                        // که هسته Kea برای چندریسمانی DHCP استفاده می‌کند.
                        \(dqhttp\-client\-threads\(dq: 0
                    },
                    \(dqpeers\(dq: [
                        // این پیکربندی مربوط به سرور اصلی است.
                        {
                            \(dqname\(dq: \(dqserver1\(dq,
                            // این مقدار نشانی URL شنونده اختصاصی HTTP سرور دیگر را مشخص می‌کند.
                            // مقدار \(dqcontrol\-socket\(dq برای دسترسی‌پذیری بالا با
                            // چندریسمانی الزامی نیست، اما در صورت استفاده، باید از مقادیر متفاوتی
                            // برای \(dqsocket\-address\(dq و \(dqsocket\-port\(dq استفاده کند.
                            \(dqurl\(dq: \(dqhttp://192.168.1.2:8005/\(dq,
                            // لنگر اعتماد یا فایل/دایرکتوری مرجع صدور گواهی (CA).
                            \(dqtrust\-anchor\(dq: \(dq/usr/lib/kea/CA.pem\(dq,
                            // نام فایل گواهی کلاینت.
                            \(dqcert\-file\(dq: \(dq/usr/lib/kea/server1_cert.pem\(dq,
                            // نام فایل کلید خصوصی.
                            \(dqkey\-file\(dq: \(dq/usr/lib/kea/server1_key.pem\(dq,
                            // گواهی‌های کلاینت الزامی بوده و اعتبارسنجی می‌شوند.
                            \(dqrequire\-client\-certs\(dq: true,
                            // سرور دیگر اصلی است. این یکی باید
                            // ثانویه باشد.
                            \(dqrole\(dq: \(dqprimary\(dq
                        },
                        // این پیکربندی مربوط به این نمونه سرور است.
                        {
                            \(dqname\(dq: \(dqserver2\(dq,
                            // این مقدار نشانی URL شنونده اختصاصی HTTP این سرور را مشخص می‌کند.
                            // مقدار \(dqcontrol\-socket\(dq برای دسترسی‌پذیری بالا با
                            // چندریسمانی الزامی نیست، اما در صورت استفاده، باید از مقادیر متفاوتی
                            // برای \(dqsocket\-address\(dq و \(dqsocket\-port\(dq استفاده کند.
                            \(dqurl\(dq: \(dqhttp://192.168.1.3:8005/\(dq,
                            // لنگر اعتماد یا فایل/دایرکتوری مرجع صدور گواهی (CA).
                            \(dqtrust\-anchor\(dq: \(dq/usr/lib/kea/CA.pem\(dq,
                            // نام فایل گواهی کلاینت.
                            \(dqcert\-file\(dq: \(dq/usr/lib/kea/server2_cert.pem\(dq,
                            // نام فایل کلید خصوصی.
                            \(dqkey\-file\(dq: \(dq/usr/lib/kea/server2_key.pem\(dq,
                            // گواهی‌های کلاینت الزامی بوده و اعتبارسنجی می‌شوند.
                            \(dqrequire\-client\-certs\(dq: true,
                            // این سرور ثانویه است. دیگری باید
                            // اصلی باشد.
                            \(dqrole\(dq: \(dqstandby\(dq
                        }
                    ]
                } ]
            }
        }
    ],

    // این مثال شامل تعریف یک زیرشبکه تکی است.
    \(dqsubnet4\(dq: [
        {
            // پیشوند زیرشبکه.
            \(dqsubnet\(dq: \(dq192.168.1.0/24\(dq,

            // هیچ رله‌ای در این شبکه وجود ندارد، بنابراین باید به Kea اعلام کنیم که این زیرشبکه
            // مستقیماً از طریق رابط مشخص‌شده در دسترس است.
            \(dqinterface\(dq: \(dqenp0s8\(dq,

            // یک استخر نشانی پویا مشخص کنید.
            \(dqpools\(dq: [
                {
                    \(dqpool\(dq: \(dq192.168.1.100\-192.168.1.199\(dq
                }
            ]
        }
    ],

    // پیکربندی لاگ‌گیری از اینجا شروع می‌شود.
    \(dqloggers\(dq: [
    {
        // این بخش بر kea\-dhcp4 اثر می‌گذارد که لاگر پایه برای مؤلفه DHCPv4 است. این بخش به
        // سرور DHCPv4 می‌گوید که تمام پیام‌های لاگ (با شدت INFO یا بالاتر) را در یک فایل بنویسد. فایل
        // به محض رسیدن به اندازه 2MB چرخش داده خواهد شد و حداکثر ۴ فایل نگه داشته می‌شود. مقدار debuglevel
        // (محدوده 0 تا 99) فقط هنگام لاگ‌گیری در سطح DEBUG استفاده می‌شود.
        \(dqname\(dq: \(dqkea\-dhcp4\(dq,
        \(dqoutput\-options\(dq: [
            {
                \(dqoutput\(dq: \(dq/var/log/kea/kea\-dhcp4.log\(dq,
                \(dqmaxsize\(dq: 2048000,
                \(dqmaxver\(dq: 4
            }
        ],
        \(dqseverity\(dq: \(dqINFO\(dq,
        \(dqdebuglevel\(dq: 0
    }
  ]
}
}

.EE
.UNINDENT
.UNINDENT.SH "نمودارهای جریان KEA (KEA FLOW DIAGRAMS)"
.sp
این نمودارهای جریان، پیاده‌سازی سرور DHCPv4 در Kea را شرح می‌دهند و ممکن است برای مدیران سیستم مفید باشند. برای طراحی پیکربندی‌ای که منجر به دریافت نشانی‌ها و گزینه‌های مد نظر توسط کلاینت‌ها شود، درک توالی گام‌های پردازش درخواست اهمیت دارد. برای نمونه، Kea برای یافتن یک نشانی مناسب به جستجو و پیمایش می‌پردازد و نخستین نشانی دردسترس را به طور مشروط می‌پذیرد، بنابراین ترتیبی که نشانی‌ها ارزیابی می‌شوند حائز اهمیت است.
.sp
همچنین درک منطق پردازش Kea مفید است زیرا انتخاب‌های پیکربندی وجود دارند که می‌توانند فرآیند را بسیار کارآمدتر کنند. Kea بسیار انعطاف‌پذیر است، بنابراین می‌توان آن را برای موارد کاربرد بسیار گوناگون و در محیط‌های مختلف به کار برد. در محیطی که توان عملیاتی (throughput) و کارایی در اولویت هستند، مدیر سیستم می‌تواند برخی از مراحل پردازش را محدود کند. برای مثال، این امکان وجود دارد که تعداد شناسه‌های کلاینت متفاوتی را که Kea هنگام جستجو برای یک رزرو میزبان (host reservation) ارزیابی می‌کند محدود کرد، یا حتی از مرحله بررسی رزروهای میزبان صرف‌نظر نمود.
.sp
این نمودارها بر جنبه‌هایی از پردازش Kea تمرکز دارند که برای راهبران بیشترین فایده را خواهند داشت. نمودارها پردازش درخواست DHCPv4 را نشان می‌دهند، اما بیشتر این منطق به طور یکسان برای DHCPv6 نیز اعمال می‌شود. در ادامه عنوان هر نمودار، شماره نسخه Kea آمده است. رفتار Kea در طول زمان تکامل یافته است و این نمودارها رفتار سیستم را بر اساس نسخه مشخص‌شده Kea مستند می‌کنند. این نمودارها در درخت منبع Kea در قالب‌های UML (کد منبع)، PNG و SVG ارائه شده‌اند.
.SS "حلقه اصلی (Main Loop)"
.sp
حلقه اصلی بین هر دو سرور DHCPv4 و DHCPv6 مشترک است.
.INDENT 0.0
.INDENT 2.5
[image]
حلقه اصلی سرور DHCP.UNINDENT
.UNINDENT
.SS "پردازش بسته DHCPv4 (DHCPv4 Packet Processing)"
.sp
پردازش بسته DHCPv4 نوع پیام DHCP را ارزیابی می‌کند: Discover، Request، Release، Decline یا Inform. این نمودار جریان کلی و سطح‌بالای پردازش یک بسته ورودی DHCP کلاینت را از زمان دریافت تا پاسخ سرور نشان می‌دهد.
.INDENT 0.0
.INDENT 2.5
[image]
پردازش بسته DHCPv4.UNINDENT
.UNINDENT
.SS "پردازش DHCPREQUEST (DHCPREQUEST Processing)"
.sp
نمودارهای زیر بر پردازش DHCPREQUEST تمرکز دارند. این نمودار نمایی کلی از فرآیند را ارائه می‌دهد، از انتخاب زیرشبکه گرفته تا بررسی رزروهای میزبان و ارزیابی کلاس‌های کلاینت. در نهایت، پیش از تأیید اجاره، گزینه‌ها ارزیابی شده و به پیام اضافه می‌شوند.
.INDENT 0.0
.INDENT 2.5
[image]
پردازش DHCPREQUEST.UNINDENT
.UNINDENT
.SS "انتخاب زیرشبکه DHCPv4 (DHCPv4 Subnet Selection)"
.sp
انتخاب زیرشبکه فرآیند گزینش زیرشبکه‌ای است که از نظر توپولوژی برای کلاینت مناسب باشد. هنگامی که زیرشبکه انتخاب‌شده عضوی از یک شبکه اشتراکی (shared network) باشد، کل شبکه اشتراکی انتخاب می‌شود. در حین انتخاب زیرشبکه، ممکن است کلاس کلاینت در طول پیمایش زیرشبکه‌ها بیش از یک بار بررسی شود تا مشخص گردد آیا در زیرشبکه انتخاب‌شده مجاز است یا خیر.
.INDENT 0.0
.INDENT 2.5
[image]
انتخاب زیرشبکه DHCPv4.UNINDENT
.UNINDENT
.SS "حالت خاص راه‌اندازی دوگانه در DHCPv4 (DHCPv4 Special Case of Double\-Booting)"
.sp
پس از انتخاب زیرشبکه و پیش از تخصیص اجاره، سرور DHCPv4 حالت خاص کلاینت‌هایی را که با یک ایمیج ارائه‌شده توسط PXE boot یا bootp مجدداً راه‌اندازی می‌شوند مدیریت می‌کند. کادر Lease Request در ادامه بسط داده شده است.
.INDENT 0.0
.INDENT 2.5
[image]
تخصیص اجاره DHCPv4.UNINDENT
.UNINDENT
.SS "تخصیص اجاره در DHCPv4 (DHCPv4 Lease Allocation)"
.sp
نخستین نمودار زیر، جزئیات پردازش درخواست کلاینت را به تصویر می‌کشد و تمدید یک اجاره موجود، انتساب یک اجاره رزروشده و تخصیص یک اجاره رزرو‌نشده را نشان می‌دهد.
.INDENT 0.0
.INDENT 2.5
[image]
تخصیص اجاره DHCPREQUEST.UNINDENT
.UNINDENT
.sp
نمودار دوم الگوریتم مورد استفاده برای اعتبارسنجی یک اجاره درخواستی یا انتخاب یک نشانی جدید جهت پیشنهاد را نشان می‌دهد. سمت راست نمودار نشان می‌دهد که چگونه یک نشانی جدید انتخاب می‌شود، هنگامی که یک اجاره جدید مورد نیاز است و کلاینت نه نشانی درخواستی دارد و نه رزرو. زمانی که یک اجاره جدید مورد نیاز است و Kea روی استخرها و زیرشبکه‌ها پیمایش می‌کند، کار خود را با زیرشبکه انتخاب‌شده در فرآیند انتخاب زیرشبکه در بالا آغاز می‌نماید.
.INDENT 0.0
.INDENT 2.5
[image]
الگوریتم requestLease4.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
نشانی‌های ردشده (Declined) در آمار نشانی‌های تخصیص‌یافته لحاظ می‌شوند،
بنابراین معادله assigned + free = total برقرار است.
.UNINDENT
.UNINDENT
.SS "وضعیت‌های اجاره (Lease States)"
.sp
این نمودار وضعیت‌های مختلف اجاره را نشان می‌دهد، از جمله وضعیت \fBfree\fP که در آن هیچ شیء اجاره‌ای وجود ندارد.
.INDENT 0.0
.INDENT 2.5
[image]
وضعیت‌های اجاره.UNINDENT
.UNINDENT
.SS "بررسی رزروهای میزبان (Checking for Host Reservations)"
.sp
موتور تخصیص پس از انتخاب یک زیرشبکه، رزروهای میزبان را بررسی می‌کند. نمودار زیر جزئیات آن عملیات را نشان می‌دهد. انتخاب زیرشبکه بر اساس توپولوژی شبکه انجام می‌شود. رزروهای میزبان در وهله نخست برای انتساب گزینه‌ها هستند، و گزینه‌ها پس از انتخاب زیرشبکه ارزیابی می‌شوند. با این حال، اگر کلاس‌های کلاینت در رزرو میزبان اضافه شده باشند، آن‌ها نیز در یک بررسی دیگر در برابر زیرشبکه انتخاب‌شده ارزیابی می‌شوند. Kea شامل چندین گزینه برای صرف‌نظر از بررسی رزروهای میزبان است، که در صورت عدم استفاده از رزروها، می‌تواند این فرآیند را بسیار کارآمدتر کند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
برای یافتن یک اجاره آزاد، موتور تخصیص کار خود را با ارزیابی آخرین زیرشبکه استفاده‌شده آغاز می‌کند.
زیرشبکه فعلی به تاریخچه پرس‌وجوهای قبلی بستگی دارد.
.UNINDENT
.UNINDENT
.INDENT 0.0
.INDENT 2.5
[image]
ارزیابی رزرو میزبان.UNINDENT
.UNINDENT
.SS "ساخت فهرست گزینه‌ها (Building the Options List)"
.INDENT 0.0
.TP
.B پیش از ارسال پاسخ، گزینه‌ها اضافه می‌شوند:
.INDENT 7.0
.IP \(bu 2
ارزیابی کلاس‌های کلاینت مورد نیاز
.IP \(bu 2
ساخت فهرست گزینه‌های پیکربندی‌شده
.IP \(bu 2
الحاق گزینه‌های درخواستی
.IP \(bu 2
الحاق گزینه‌های سازنده درخواستی
.IP \(bu 2
الحاق گزینه‌های پایه
.UNINDENT
.UNINDENT
.INDENT 0.0
.INDENT 2.5
[image]
الگوریتم buildCfgOptionList (ساخت فهرست گزینه‌های پیکربندی‌شده).UNINDENT
.UNINDENT
.INDENT 0.0
.INDENT 2.5
[image]
الگوریتم appendRequestedOptions (الحاق گزینه‌های درخواستی).UNINDENT
.UNINDENT
.INDENT 0.0
.INDENT 2.5
[image]
الگوریتم appendRequestedVendorOptions (الحاق گزینه‌های سازنده درخواستی).UNINDENT
.UNINDENT.SS نحوه تشخیص کلاینت یکسان در پیام‌های مختلف DHCP توسط Kea
.INDENT 0.0
.INDENT 2.5
[تصویر]
.UNINDENT
.UNINDENT
.SS گردش‌های کاری RADIUS برای تخصیص اجاره
.INDENT 0.0
.INDENT 2.5
[تصویر]
.UNINDENT
.UNINDENT
.SH "ساختار فایل پیکربندی KEA (KEA CONFIGURATION FILE SYNTAX (BNF))"
.sp
Kea از چندین دیمن (daemon) تشکیل شده است که هر یک ساختار پیکربندی خاص خود را دارند. بخش‌های زیر
ساختار کاملی از تمام پارامترهای ممکن را به شکل فرم باکوس\-نائور (BNF) ارائه می‌دهند.
برای اطلاعات بیشتر، این مقاله ویکی‌پدیا درباره BNF به نشانی \%<https://\:en\:.wikipedia\:.org/\:wiki/\:Backus%E2%80%93Naur_form> را
ببینید.
.SS گرامر BNF برای DHCPv4
.sp
این گرامر از \fBdhcp4_parser.yy\fP\& تولید شده است. برای جزئیات بیشتر بخش The DHCPv4 Server \%<#\:dhcp4> را ببینید.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
  Grammar

  $accept ::= start EOF

  start ::= TOPLEVEL_JSON sub_json

  start ::= TOPLEVEL_DHCP4 syntax_map

  start ::= SUB_DHCP4 sub_dhcp4

  start ::= SUB_INTERFACES4 sub_interfaces4

  start ::= SUB_SUBNET4 sub_subnet4

  start ::= SUB_POOL4 sub_pool4

  start ::= SUB_RESERVATION sub_reservation

  start ::= SUB_OPTION_DEFS sub_option_def_list

  start ::= SUB_OPTION_DEF sub_option_def

  start ::= SUB_OPTION_DATA sub_option_data

  start ::= SUB_HOOKS_LIBRARY sub_hooks_library

  start ::= SUB_DHCP_DDNS sub_dhcp_ddns

  start ::= SUB_CONFIG_CONTROL sub_config_control

  value ::= INTEGER
       | FLOAT
       | BOOLEAN
       | STRING
       | NULL
       | map2
       | list_generic

  sub_json ::= value

  map2 ::= \(dq{\(dq map_content \(dq}\(dq

  map_value ::= map2

  map_content ::=
             | not_empty_map

  not_empty_map ::= STRING \(dq:\(dq value
               | not_empty_map \(dq,\(dq STRING \(dq:\(dq value
               | not_empty_map \(dq,\(dq

  list_generic ::= \(dq[\(dq list_content \(dq]\(dq

  list_content ::=
              | not_empty_list

  not_empty_list ::= value
                | not_empty_list \(dq,\(dq value
                | not_empty_list \(dq,\(dq

  list_strings ::= \(dq[\(dq list_strings_content \(dq]\(dq

  list_strings_content ::=
                      | not_empty_list_strings

  not_empty_list_strings ::= STRING
                        | not_empty_list_strings \(dq,\(dq STRING
                        | not_empty_list_strings \(dq,\(dq

  unknown_map_entry ::= STRING \(dq:\(dq

  syntax_map ::= \(dq{\(dq global_object \(dq}\(dq

  global_object ::= \(dqDhcp4\(dq \(dq:\(dq \(dq{\(dq global_params \(dq}\(dq
               | global_object_comma

  global_object_comma ::= global_object \(dq,\(dq

  sub_dhcp4 ::= \(dq{\(dq global_params \(dq}\(dq

  global_params ::= global_param
               | global_params \(dq,\(dq global_param
               | global_params \(dq,\(dq

  global_param ::= valid_lifetime
              | min_valid_lifetime
              | max_valid_lifetime
              | renew_timer
              | rebind_timer
              | decline_probation_period
              | subnet4_list
              | shared_networks
              | interfaces_config
              | lease_database
              | hosts_database
              | hosts_databases
              | host_reservation_identifiers
              | client_classes
              | option_def_list
              | option_data_list
              | hooks_libraries
              | expired_leases_processing
              | dhcp4o6_port
              | control_socket
              | control_sockets
              | dhcp_queue_control
              | dhcp_ddns
              | echo_client_id
              | match_client_id
              | authoritative
              | next_server
              | server_hostname
              | boot_file_name
              | user_context
              | comment
              | sanity_checks
              | reservations
              | config_control
              | server_tag
              | reservations_global
              | reservations_in_subnet
              | reservations_out_of_pool
              | calculate_tee_times
              | t1_percent
              | t2_percent
              | cache_threshold
              | cache_max_age
              | adaptive_lease_time_threshold
              | loggers
              | hostname_char_set
              | hostname_char_replacement
              | ddns_send_updates
              | ddns_override_no_update
              | ddns_override_client_update
              | ddns_replace_client_name
              | ddns_generated_prefix
              | ddns_qualifying_suffix
              | ddns_update_on_renew
              | ddns_use_conflict_resolution
              | ddns_conflict_resolution_mode
              | ddns_ttl_percent
              | ddns_ttl
              | ddns_ttl_min
              | ddns_ttl_max
              | store_extended_info
              | statistic_default_sample_count
              | statistic_default_sample_age
              | dhcp_multi_threading
              | early_global_reservations_lookup
              | ip_reservations_unique
              | reservations_lookup_first
              | compatibility
              | parked_packet_limit
              | allocator
              | offer_lifetime
              | stash_agent_options
              | unknown_map_entry

  valid_lifetime ::= \(dqvalid\-lifetime\(dq \(dq:\(dq INTEGER

  min_valid_lifetime ::= \(dqmin\-valid\-lifetime\(dq \(dq:\(dq INTEGER

  max_valid_lifetime ::= \(dqmax\-valid\-lifetime\(dq \(dq:\(dq INTEGER

  renew_timer ::= \(dqrenew\-timer\(dq \(dq:\(dq INTEGER

  rebind_timer ::= \(dqrebind\-timer\(dq \(dq:\(dq INTEGER

  calculate_tee_times ::= \(dqcalculate\-tee\-times\(dq \(dq:\(dq BOOLEAN

  t1_percent ::= \(dqt1\-percent\(dq \(dq:\(dq FLOAT

  t2_percent ::= \(dqt2\-percent\(dq \(dq:\(dq FLOAT

  cache_threshold ::= \(dqcache\-threshold\(dq \(dq:\(dq FLOAT

  cache_max_age ::= \(dqcache\-max\-age\(dq \(dq:\(dq INTEGER

  adaptive_lease_time_threshold ::= \(dqadaptive\-lease\-time\-threshold\(dq \(dq:\(dq FLOAT

  decline_probation_period ::= \(dqdecline\-probation\-period\(dq \(dq:\(dq INTEGER

  server_tag ::= \(dqserver\-tag\(dq \(dq:\(dq STRING

  parked_packet_limit ::= \(dqparked\-packet\-limit\(dq \(dq:\(dq INTEGER

  allocator ::= \(dqallocator\(dq \(dq:\(dq STRING

  echo_client_id ::= \(dqecho\-client\-id\(dq \(dq:\(dq BOOLEAN

  match_client_id ::= \(dqmatch\-client\-id\(dq \(dq:\(dq BOOLEAN

  authoritative ::= \(dqauthoritative\(dq \(dq:\(dq BOOLEAN

  ddns_send_updates ::= \(dqddns\-send\-updates\(dq \(dq:\(dq BOOLEAN

  ddns_override_no_update ::= \(dqddns\-override\-no\-update\(dq \(dq:\(dq BOOLEAN

  ddns_override_client_update ::= \(dqddns\-override\-client\-update\(dq \(dq:\(dq BOOLEAN

  ddns_replace_client_name ::= \(dqddns\-replace\-client\-name\(dq \(dq:\(dq ddns_replace_client_name_value

  ddns_replace_client_name_value ::= \(dqwhen\-present\(dq
                                | \(dqnever\(dq
                                | \(dqalways\(dq
                                | \(dqwhen\-not\-present\(dq
                                | BOOLEAN

  ddns_generated_prefix ::= \(dqddns\-generated\-prefix\(dq \(dq:\(dq STRING

  ddns_qualifying_suffix ::= \(dqddns\-qualifying\-suffix\(dq \(dq:\(dq STRING

  ddns_update_on_renew ::= \(dqddns\-update\-on\-renew\(dq \(dq:\(dq BOOLEAN

  ddns_use_conflict_resolution ::= \(dqddns\-use\-conflict\-resolution\(dq \(dq:\(dq BOOLEAN

  ddns_conflict_resolution_mode ::= \(dqddns\-conflict\-resolution\-mode\(dq \(dq:\(dq ddns_conflict_resolution_mode_value

  ddns_conflict_resolution_mode_value ::= \(dqcheck\-with\-dhcid\(dq
                                     | \(dqno\-check\-with\-dhcid\(dq
                                     | \(dqcheck\-exists\-with\-dhcid\(dq
                                     | \(dqno\-check\-without\-dhcid\(dq

  ddns_ttl_percent ::= \(dqddns\-ttl\-percent\(dq \(dq:\(dq FLOAT

  ddns_ttl ::= \(dqddns\-ttl\(dq \(dq:\(dq INTEGER

  ddns_ttl_min ::= \(dqddns\-ttl\-min\(dq \(dq:\(dq INTEGER

  ddns_ttl_max ::= \(dqddns\-ttl\-max\(dq \(dq:\(dq INTEGER

  hostname_char_set ::= \(dqhostname\-char\-set\(dq \(dq:\(dq STRING

  hostname_char_replacement ::= \(dqhostname\-char\-replacement\(dq \(dq:\(dq STRING

  store_extended_info ::= \(dqstore\-extended\-info\(dq \(dq:\(dq BOOLEAN

  statistic_default_sample_count ::= \(dqstatistic\-default\-sample\-count\(dq \(dq:\(dq INTEGER

  statistic_default_sample_age ::= \(dqstatistic\-default\-sample\-age\(dq \(dq:\(dq INTEGER

  early_global_reservations_lookup ::= \(dqearly\-global\-reservations\-lookup\(dq \(dq:\(dq BOOLEAN

  ip_reservations_unique ::= \(dqip\-reservations\-unique\(dq \(dq:\(dq BOOLEAN

  reservations_lookup_first ::= \(dqreservations\-lookup\-first\(dq \(dq:\(dq BOOLEAN

  offer_lifetime ::= \(dqoffer\-lifetime\(dq \(dq:\(dq INTEGER

  stash_agent_options ::= \(dqstash\-agent\-options\(dq \(dq:\(dq BOOLEAN

  interfaces_config ::= \(dqinterfaces\-config\(dq \(dq:\(dq \(dq{\(dq interfaces_config_params \(dq}\(dq

  interfaces_config_params ::= interfaces_config_param
                          | interfaces_config_params \(dq,\(dq interfaces_config_param
                          | interfaces_config_params \(dq,\(dq

  interfaces_config_param ::= interfaces_list
                         | dhcp_socket_type
                         | outbound_interface
                         | re_detect
                         | service_sockets_require_all
                         | service_sockets_retry_wait_time
                         | service_sockets_max_retries
                         | user_context
                         | comment
                         | unknown_map_entry

  sub_interfaces4 ::= \(dq{\(dq interfaces_config_params \(dq}\(dq

  interfaces_list ::= \(dqinterfaces\(dq \(dq:\(dq list_strings

  dhcp_socket_type ::= \(dqdhcp\-socket\-type\(dq \(dq:\(dq socket_type

  socket_type ::= \(dqraw\(dq
             | \(dqudp\(dq

  outbound_interface ::= \(dqoutbound\-interface\(dq \(dq:\(dq outbound_interface_value

  outbound_interface_value ::= \(dqsame\-as\-inbound\(dq
                          | \(dquse\-routing\(dq

  re_detect ::= \(dqre\-detect\(dq \(dq:\(dq BOOLEAN

  service_sockets_require_all ::= \(dqservice\-sockets\-require\-all\(dq \(dq:\(dq BOOLEAN

  service_sockets_retry_wait_time ::= \(dqservice\-sockets\-retry\-wait\-time\(dq \(dq:\(dq INTEGER

  service_sockets_max_retries ::= \(dqservice\-sockets\-max\-retries\(dq \(dq:\(dq INTEGER

  lease_database ::= \(dqlease\-database\(dq \(dq:\(dq \(dq{\(dq database_map_params \(dq}\(dq

  sanity_checks ::= \(dqsanity\-checks\(dq \(dq:\(dq \(dq{\(dq sanity_checks_params \(dq}\(dq

  sanity_checks_params ::= sanity_checks_param
                      | sanity_checks_params \(dq,\(dq sanity_checks_param
                      | sanity_checks_params \(dq,\(dq

  sanity_checks_param ::= lease_checks
                     | extended_info_checks

  lease_checks ::= \(dqlease\-checks\(dq \(dq:\(dq STRING

  extended_info_checks ::= \(dqextended\-info\-checks\(dq \(dq:\(dq STRING

  hosts_database ::= \(dqhosts\-database\(dq \(dq:\(dq \(dq{\(dq database_map_params \(dq}\(dq

  hosts_databases ::= \(dqhosts\-databases\(dq \(dq:\(dq \(dq[\(dq database_list \(dq]\(dq

  database_list ::=
               | not_empty_database_list

  not_empty_database_list ::= database
                         | not_empty_database_list \(dq,\(dq database
                         | not_empty_database_list \(dq,\(dq

  database ::= \(dq{\(dq database_map_params \(dq}\(dq

  database_map_params ::= database_map_param
                     | database_map_params \(dq,\(dq database_map_param
                     | database_map_params \(dq,\(dq

  database_map_param ::= database_type
                    | user
                    | password
                    | host
                    | port
                    | name
                    | persist
                    | lfc_interval
                    | readonly
                    | connect_timeout
                    | read_timeout
                    | write_timeout
                    | tcp_user_timeout
                    | max_reconnect_tries
                    | reconnect_wait_time
                    | on_fail
                    | retry_on_startup
                    | max_row_errors
                    | trust_anchor
                    | cert_file
                    | key_file
                    | ssl_mode
                    | cipher_list
                    | unknown_map_entry

  database_type ::= \(dqtype\(dq \(dq:\(dq STRING

  user ::= \(dquser\(dq \(dq:\(dq STRING

  password ::= \(dqpassword\(dq \(dq:\(dq STRING

  host ::= \(dqhost\(dq \(dq:\(dq STRING

  port ::= \(dqport\(dq \(dq:\(dq INTEGER

  name ::= \(dqname\(dq \(dq:\(dq STRING

  persist ::= \(dqpersist\(dq \(dq:\(dq BOOLEAN

  lfc_interval ::= \(dqlfc\-interval\(dq \(dq:\(dq INTEGER

  readonly ::= \(dqreadonly\(dq \(dq:\(dq BOOLEAN

  connect_timeout ::= \(dqconnect\-timeout\(dq \(dq:\(dq INTEGER

  read_timeout ::= \(dqread\-timeout\(dq \(dq:\(dq INTEGER

  write_timeout ::= \(dqwrite\-timeout\(dq \(dq:\(dq INTEGER

  tcp_user_timeout ::= \(dqtcp\-user\-timeout\(dq \(dq:\(dq INTEGER

  max_reconnect_tries ::= \(dqmax\-reconnect\-tries\(dq \(dq:\(dq INTEGER

  reconnect_wait_time ::= \(dqreconnect\-wait\-time\(dq \(dq:\(dq INTEGER

  on_fail ::= \(dqon\-fail\(dq \(dq:\(dq on_fail_mode

  on_fail_mode ::= \(dqstop\-retry\-exit\(dq
              | \(dqserve\-retry\-exit\(dq
              | \(dqserve\-retry\-continue\(dq

  retry_on_startup ::= \(dqretry\-on\-startup\(dq \(dq:\(dq BOOLEAN

  max_row_errors ::= \(dqmax\-row\-errors\(dq \(dq:\(dq INTEGER

  trust_anchor ::= \(dqtrust\-anchor\(dq \(dq:\(dq STRING

  cert_file ::= \(dqcert\-file\(dq \(dq:\(dq STRING

  key_file ::= \(dqkey\-file\(dq \(dq:\(dq STRING

  ssl_mode ::= \(dqssl\-mode\(dq \(dq:\(dq ssl_mode
          | \(dqdisable\(dq
          | \(dqprefer\(dq
          | \(dqrequire\(dq
          | \(dqverify\-ca\(dq
          | \(dqverify\-full\(dq

  cipher_list ::= \(dqcipher\-list\(dq \(dq:\(dq STRING

  host_reservation_identifiers ::= \(dqhost\-reservation\-identifiers\(dq \(dq:\(dq \(dq[\(dq host_reservation_identifiers_list \(dq]\(dq

  host_reservation_identifiers_list ::= host_reservation_identifier
                                   | host_reservation_identifiers_list \(dq,\(dq host_reservation_identifier
                                   | host_reservation_identifiers_list \(dq,\(dq

  host_reservation_identifier ::= duid_id
                             | hw_address_id
                             | circuit_id
                             | client_id
                             | flex_id

  duid_id ::= \(dqduid\(dq

  hw_address_id ::= \(dqhw\-address\(dq

  circuit_id ::= \(dqcircuit\-id\(dq

  client_id ::= \(dqclient\-id\(dq

  flex_id ::= \(dqflex\-id\(dq

  dhcp_multi_threading ::= \(dqmulti\-threading\(dq \(dq:\(dq \(dq{\(dq multi_threading_params \(dq}\(dq

  multi_threading_params ::= multi_threading_param
                        | multi_threading_params \(dq,\(dq multi_threading_param
                        | multi_threading_params \(dq,\(dq

  multi_threading_param ::= enable_multi_threading
                       | thread_pool_size
                       | packet_queue_size
                       | user_context
                       | comment
                       | unknown_map_entry

  enable_multi_threading ::= \(dqenable\-multi\-threading\(dq \(dq:\(dq BOOLEAN

  thread_pool_size ::= \(dqthread\-pool\-size\(dq \(dq:\(dq INTEGER

  packet_queue_size ::= \(dqpacket\-queue\-size\(dq \(dq:\(dq INTEGER

  hooks_libraries ::= \(dqhooks\-libraries\(dq \(dq:\(dq \(dq[\(dq hooks_libraries_list \(dq]\(dq

  hooks_libraries_list ::=
                      | not_empty_hooks_libraries_list

  not_empty_hooks_libraries_list ::= hooks_library
                                | not_empty_hooks_libraries_list \(dq,\(dq hooks_library
                                | not_empty_hooks_libraries_list \(dq,\(dq

  hooks_library ::= \(dq{\(dq hooks_params \(dq}\(dq

  sub_hooks_library ::= \(dq{\(dq hooks_params \(dq}\(dq

  hooks_params ::= hooks_param
              | hooks_params \(dq,\(dq hooks_param
              | hooks_params \(dq,\(dq
              | unknown_map_entry

  hooks_param ::= library
             | parameters

  library ::= \(dqlibrary\(dq \(dq:\(dq STRING

  parameters ::= \(dqparameters\(dq \(dq:\(dq map_value

  expired_leases_processing ::= \(dqexpired\-leases\-processing\(dq \(dq:\(dq \(dq{\(dq expired_leases_params \(dq}\(dq

  expired_leases_params ::= expired_leases_param
                       | expired_leases_params \(dq,\(dq expired_leases_param
                       | expired_leases_params \(dq,\(dq

  expired_leases_param ::= reclaim_timer_wait_time
                      | flush_reclaimed_timer_wait_time
                      | hold_reclaimed_time
                      | max_reclaim_leases
                      | max_reclaim_time
                      | unwarned_reclaim_cycles

  reclaim_timer_wait_time ::= \(dqreclaim\-timer\-wait\-time\(dq \(dq:\(dq INTEGER

  flush_reclaimed_timer_wait_time ::= \(dqflush\-reclaimed\-timer\-wait\-time\(dq \(dq:\(dq INTEGER

  hold_reclaimed_time ::= \(dqhold\-reclaimed\-time\(dq \(dq:\(dq INTEGER

  max_reclaim_leases ::= \(dqmax\-reclaim\-leases\(dq \(dq:\(dq INTEGER

  max_reclaim_time ::= \(dqmax\-reclaim\-time\(dq \(dq:\(dq INTEGER

  unwarned_reclaim_cycles ::= \(dqunwarned\-reclaim\-cycles\(dq \(dq:\(dq INTEGER

  subnet4_list ::= \(dqsubnet4\(dq \(dq:\(dq \(dq[\(dq subnet4_list_content \(dq]\(dq

  subnet4_list_content ::=
                      | not_empty_subnet4_list

  not_empty_subnet4_list ::= subnet4
                        | not_empty_subnet4_list \(dq,\(dq subnet4
                        | not_empty_subnet4_list \(dq,\(dq

  subnet4 ::= \(dq{\(dq subnet4_params \(dq}\(dq

  sub_subnet4 ::= \(dq{\(dq subnet4_params \(dq}\(dq

  subnet4_params ::= subnet4_param
                | subnet4_params \(dq,\(dq subnet4_param
                | subnet4_params \(dq,\(dq

  subnet4_param ::= valid_lifetime
               | min_valid_lifetime
               | max_valid_lifetime
               | renew_timer
               | rebind_timer
               | option_data_list
               | pools_list
               | subnet
               | interface
               | id
               | client_class
               | network_client_classes
               | require_client_classes
               | evaluate_additional_classes
               | reservations
               | reservations_global
               | reservations_in_subnet
               | reservations_out_of_pool
               | relay
               | match_client_id
               | authoritative
               | next_server
               | server_hostname
               | boot_file_name
               | subnet_4o6_interface
               | subnet_4o6_interface_id
               | subnet_4o6_subnet
               | user_context
               | comment
               | calculate_tee_times
               | t1_percent
               | t2_percent
               | cache_threshold
               | cache_max_age
               | adaptive_lease_time_threshold
               | ddns_send_updates
               | ddns_override_no_update
               | ddns_override_client_update
               | ddns_replace_client_name
               | ddns_generated_prefix
               | ddns_qualifying_suffix
               | ddns_update_on_renew
               | ddns_use_conflict_resolution
               | ddns_conflict_resolution_mode
               | ddns_ttl_percent
               | ddns_ttl
               | ddns_ttl_min
               | ddns_ttl_max
               | hostname_char_set
               | hostname_char_replacement
               | store_extended_info
               | allocator
               | offer_lifetime
               | unknown_map_entry

  subnet ::= \(dqsubnet\(dq \(dq:\(dq STRING

  subnet_4o6_interface ::= \(dq4o6\-interface\(dq \(dq:\(dq STRING

  subnet_4o6_interface_id ::= \(dq4o6\-interface\-id\(dq \(dq:\(dq STRING

  subnet_4o6_subnet ::= \(dq4o6\-subnet\(dq \(dq:\(dq STRING

  interface ::= \(dqinterface\(dq \(dq:\(dq STRING

  client_class ::= \(dqclient\-class\(dq \(dq:\(dq STRING

  network_client_classes ::= \(dqclient\-classes\(dq \(dq:\(dq list_strings

  require_client_classes ::= \(dqrequire\-client\-classes\(dq \(dq:\(dq list_strings

  evaluate_additional_classes ::= \(dqevaluate\-additional\-classes\(dq \(dq:\(dq list_strings

  reservations_global ::= \(dqreservations\-global\(dq \(dq:\(dq BOOLEAN

  reservations_in_subnet ::= \(dqreservations\-in\-subnet\(dq \(dq:\(dq BOOLEAN

  reservations_out_of_pool ::= \(dqreservations\-out\-of\-pool\(dq \(dq:\(dq BOOLEAN

  id ::= \(dqid\(dq \(dq:\(dq INTEGER

  shared_networks ::= \(dqshared\-networks\(dq \(dq:\(dq \(dq[\(dq shared_networks_content \(dq]\(dq

  shared_networks_content ::=
                         | shared_networks_list

  shared_networks_list ::= shared_network
                      | shared_networks_list \(dq,\(dq shared_network
                      | shared_networks_list \(dq,\(dq

  shared_network ::= \(dq{\(dq shared_network_params \(dq}\(dq

  shared_network_params ::= shared_network_param
                       | shared_network_params \(dq,\(dq shared_network_param
                       | shared_network_params \(dq,\(dq

  shared_network_param ::= name
                      | subnet4_list
                      | interface
                      | renew_timer
                      | rebind_timer
                      | option_data_list
                      | match_client_id
                      | authoritative
                      | next_server
                      | server_hostname
                      | boot_file_name
                      | relay
                      | reservations_global
                      | reservations_in_subnet
                      | reservations_out_of_pool
                      | client_class
                      | network_client_classes
                      | require_client_classes
                      | evaluate_additional_classes
                      | valid_lifetime
                      | min_valid_lifetime
                      | max_valid_lifetime
                      | user_context
                      | comment
                      | calculate_tee_times
                      | t1_percent
                      | t2_percent
                      | cache_threshold
                      | cache_max_age
                      | adaptive_lease_time_threshold
                      | ddns_send_updates
                      | ddns_override_no_update
                      | ddns_override_client_update
                      | ddns_replace_client_name
                      | ddns_generated_prefix
                      | ddns_qualifying_suffix
                      | ddns_update_on_renew
                      | ddns_use_conflict_resolution
                      | ddns_conflict_resolution_mode
                      | ddns_ttl_percent
                      | ddns_ttl
                      | ddns_ttl_min
                      | ddns_ttl_max
                      | hostname_char_set
                      | hostname_char_replacement
                      | store_extended_info
                      | allocator
                      | offer_lifetime
                      | unknown_map_entry

  option_def_list ::= \(dqoption\-def\(dq \(dq:\(dq \(dq[\(dq option_def_list_content \(dq]\(dq

  sub_option_def_list ::= \(dq{\(dq option_def_list \(dq}\(dq

  option_def_list_content ::=
                         | not_empty_option_def_list

  not_empty_option_def_list ::= option_def_entry
                           | not_empty_option_def_list \(dq,\(dq option_def_entry
                           | not_empty_option_def_list \(dq,\(dq

  option_def_entry ::= \(dq{\(dq option_def_params \(dq}\(dq

  sub_option_def ::= \(dq{\(dq option_def_params \(dq}\(dq

  option_def_params ::=
                   | not_empty_option_def_params

  not_empty_option_def_params ::= option_def_param
                             | not_empty_option_def_params \(dq,\(dq option_def_param
                             | not_empty_option_def_params \(dq,\(dq

  option_def_param ::= option_def_name
                  | option_def_code
                  | option_def_type
                  | option_def_record_types
                  | option_def_space
                  | option_def_encapsulate
                  | option_def_array
                  | user_context
                  | comment
                  | unknown_map_entry

  option_def_name ::= name

  code ::= \(dqcode\(dq \(dq:\(dq INTEGER

  option_def_code ::= code

  option_def_type ::= \(dqtype\(dq \(dq:\(dq STRING

  option_def_record_types ::= \(dqrecord\-types\(dq \(dq:\(dq STRING

  space ::= \(dqspace\(dq \(dq:\(dq STRING

  option_def_space ::= space

  option_def_encapsulate ::= \(dqencapsulate\(dq \(dq:\(dq STRING

  option_def_array ::= \(dqarray\(dq \(dq:\(dq BOOLEAN

  option_data_list ::= \(dqoption\-data\(dq \(dq:\(dq \(dq[\(dq option_data_list_content \(dq]\(dq

  option_data_list_content ::=
                          | not_empty_option_data_list

  not_empty_option_data_list ::= option_data_entry
                            | not_empty_option_data_list \(dq,\(dq option_data_entry
                            | not_empty_option_data_list \(dq,\(dq

  option_data_entry ::= \(dq{\(dq option_data_params \(dq}\(dq

  sub_option_data ::= \(dq{\(dq option_data_params \(dq}\(dq

  option_data_params ::=
                    | not_empty_option_data_params

  not_empty_option_data_params ::= option_data_param
                              | not_empty_option_data_params \(dq,\(dq option_data_param
                              | not_empty_option_data_params \(dq,\(dq

  option_data_param ::= option_data_name
                   | option_data_data
                   | option_data_code
                   | option_data_space
                   | option_data_csv_format
                   | option_data_always_send
                   | option_data_never_send
                   | user_context
                   | comment
                   | option_data_client_classes
                   | unknown_map_entry

  option_data_name ::= name

  option_data_data ::= \(dqdata\(dq \(dq:\(dq STRING

  option_data_code ::= code

  option_data_space ::= space

  option_data_csv_format ::= \(dqcsv\-format\(dq \(dq:\(dq BOOLEAN

  option_data_always_send ::= \(dqalways\-send\(dq \(dq:\(dq BOOLEAN

  option_data_never_send ::= \(dqnever\-send\(dq \(dq:\(dq BOOLEAN

  option_data_client_classes ::= \(dqclient\-classes\(dq \(dq:\(dq list_strings

  pools_list ::= \(dqpools\(dq \(dq:\(dq \(dq[\(dq pools_list_content \(dq]\(dq

  pools_list_content ::=
                    | not_empty_pools_list

  not_empty_pools_list ::= pool_list_entry
                      | not_empty_pools_list \(dq,\(dq pool_list_entry
                      | not_empty_pools_list \(dq,\(dq

  pool_list_entry ::= \(dq{\(dq pool_params \(dq}\(dq

  sub_pool4 ::= \(dq{\(dq pool_params \(dq}\(dq

  pool_params ::= pool_param
             | pool_params \(dq,\(dq pool_param
             | pool_params \(dq,\(dq

  pool_param ::= pool_entry
            | pool_id
            | option_data_list
            | client_class
            | network_client_classes
            | require_client_classes
            | evaluate_additional_classes
            | ddns_send_updates
            | ddns_override_no_update
            | ddns_override_client_update
            | ddns_replace_client_name
            | ddns_generated_prefix
            | ddns_qualifying_suffix
            | ddns_update_on_renew
            | ddns_conflict_resolution_mode
            | ddns_ttl_percent
            | ddns_ttl
            | ddns_ttl_min
            | ddns_ttl_max
            | hostname_char_set
            | hostname_char_replacement
            | user_context
            | comment
            | unknown_map_entry

  pool_entry ::= \(dqpool\(dq \(dq:\(dq STRING

  pool_id ::= \(dqpool\-id\(dq \(dq:\(dq INTEGER

  user_context ::= \(dquser\-context\(dq \(dq:\(dq map_value

  comment ::= \(dqcomment\(dq \(dq:\(dq STRING

  reservations ::= \(dqreservations\(dq \(dq:\(dq \(dq[\(dq reservations_list \(dq]\(dq

  reservations_list ::=
                   | not_empty_reservations_list

  not_empty_reservations_list ::= reservation
                             | not_empty_reservations_list \(dq,\(dq reservation
                             | not_empty_reservations_list \(dq,\(dq

  reservation ::= \(dq{\(dq reservation_params \(dq}\(dq

  sub_reservation ::= \(dq{\(dq reservation_params \(dq}\(dq

  reservation_params ::=
                    | not_empty_reservation_params

  not_empty_reservation_params ::= reservation_param
                              | not_empty_reservation_params \(dq,\(dq reservation_param
                              | not_empty_reservation_params \(dq,\(dq

  reservation_param ::= duid
                   | reservation_client_classes
                   | client_id_value
                   | circuit_id_value
                   | flex_id_value
                   | ip_address
                   | hw_address
                   | hostname
                   | option_data_list
                   | next_server
                   | server_hostname
                   | boot_file_name
                   | user_context
                   | comment
                   | unknown_map_entry

  next_server ::= \(dqnext\-server\(dq \(dq:\(dq STRING

  server_hostname ::= \(dqserver\-hostname\(dq \(dq:\(dq STRING

  boot_file_name ::= \(dqboot\-file\-name\(dq \(dq:\(dq STRING

  ip_address ::= \(dqip\-address\(dq \(dq:\(dq STRING

  duid ::= \(dqduid\(dq \(dq:\(dq STRING

  hw_address ::= \(dqhw\-address\(dq \(dq:\(dq STRING

  client_id_value ::= \(dqclient\-id\(dq \(dq:\(dq STRING

  circuit_id_value ::= \(dqcircuit\-id\(dq \(dq:\(dq STRING

  flex_id_value ::= \(dqflex\-id\(dq \(dq:\(dq STRING

  hostname ::= \(dqhostname\(dq \(dq:\(dq STRING

  reservation_client_classes ::= \(dqclient\-classes\(dq \(dq:\(dq list_strings

  relay ::= \(dqrelay\(dq \(dq:\(dq \(dq{\(dq relay_map \(dq}\(dq

  relay_map ::= ip_addresses

  ip_addresses ::= \(dqip\-addresses\(dq \(dq:\(dq list_strings

  client_classes ::= \(dqclient\-classes\(dq \(dq:\(dq \(dq[\(dq client_classes_list \(dq]\(dq

  client_classes_list ::=
                     | not_empty_classes_list

  not_empty_classes_list ::= client_class_entry
                        | not_empty_classes_list \(dq,\(dq client_class_entry
                        | not_empty_classes_list \(dq,\(dq

  client_class_entry ::= \(dq{\(dq client_class_params \(dq}\(dq

  client_class_params ::=
                     | not_empty_client_class_params

  not_empty_client_class_params ::= client_class_param
                               | not_empty_client_class_params \(dq,\(dq client_class_param
                               | not_empty_client_class_params \(dq,\(dq

  client_class_param ::= client_class_name
                    | client_class_test
                    | client_class_template_test
                    | only_if_required
                    | only_in_additional_list
                    | option_def_list
                    | option_data_list
                    | next_server
                    | server_hostname
                    | boot_file_name
                    | user_context
                    | comment
                    | unknown_map_entry
                    | valid_lifetime
                    | min_valid_lifetime
                    | max_valid_lifetime
                    | offer_lifetime

  client_class_name ::= name

  client_class_test ::= \(dqtest\(dq \(dq:\(dq STRING

  client_class_template_test ::= \(dqtemplate\-test\(dq \(dq:\(dq STRING

  only_if_required ::= \(dqonly\-if\-required\(dq \(dq:\(dq BOOLEAN

  only_in_additional_list ::= \(dqonly\-in\-additional\-list\(dq \(dq:\(dq BOOLEAN

  dhcp4o6_port ::= \(dqdhcp4o6\-port\(dq \(dq:\(dq INTEGER

  control_socket ::= \(dqcontrol\-socket\(dq \(dq:\(dq \(dq{\(dq control_socket_params \(dq}\(dq

  control_sockets ::= \(dqcontrol\-sockets\(dq \(dq:\(dq \(dq[\(dq control_socket_list \(dq]\(dq

  control_socket_list ::=
                     | not_empty_control_socket_list

  not_empty_control_socket_list ::= control_socket_entry
                               | not_empty_control_socket_list \(dq,\(dq control_socket_entry
                               | not_empty_control_socket_list \(dq,\(dq

  control_socket_entry ::= \(dq{\(dq control_socket_params \(dq}\(dq

  control_socket_params ::= control_socket_param
                       | control_socket_params \(dq,\(dq control_socket_param
                       | control_socket_params \(dq,\(dq

  control_socket_param ::= control_socket_type
                      | control_socket_name
                      | control_socket_address
                      | control_socket_port
                      | authentication
                      | trust_anchor
                      | cert_file
                      | key_file
                      | cert_required
                      | http_headers
                      | user_context
                      | comment
                      | unknown_map_entry

  control_socket_type ::= \(dqsocket\-type\(dq \(dq:\(dq control_socket_type_value

  control_socket_type_value ::= \(dqunix\(dq
                           | \(dqhttp\(dq
                           | \(dqhttps\(dq

  control_socket_name ::= \(dqsocket\-name\(dq \(dq:\(dq STRING

  control_socket_address ::= \(dqsocket\-address\(dq \(dq:\(dq STRING

  control_socket_port ::= \(dqsocket\-port\(dq \(dq:\(dq INTEGER

  cert_required ::= \(dqcert\-required\(dq \(dq:\(dq BOOLEAN

  http_headers ::= \(dqhttp\-headers\(dq \(dq:\(dq \(dq[\(dq http_header_list \(dq]\(dq

  http_header_list ::=
                  | not_empty_http_header_list

  not_empty_http_header_list ::= http_header
                            | not_empty_http_header_list \(dq,\(dq http_header
                            | not_empty_http_header_list \(dq,\(dq

  http_header ::= \(dq{\(dq http_header_params \(dq}\(dq

  http_header_params ::= http_header_param
                    | http_header_params \(dq,\(dq http_header_param
                    | http_header_params \(dq,\(dq

  http_header_param ::= name
                   | header_value
                   | user_context
                   | comment
                   | unknown_map_entry

  header_value ::= \(dqvalue\(dq \(dq:\(dq STRING

  authentication ::= \(dqauthentication\(dq \(dq:\(dq \(dq{\(dq auth_params \(dq}\(dq

  auth_params ::= auth_param
             | auth_params \(dq,\(dq auth_param
             | auth_params \(dq,\(dq

  auth_param ::= auth_type
            | realm
            | directory
            | clients
            | comment
            | user_context
            | unknown_map_entry

  auth_type ::= \(dqtype\(dq \(dq:\(dq auth_type_value

  auth_type_value ::= \(dqbasic\(dq

  realm ::= \(dqrealm\(dq \(dq:\(dq STRING

  directory ::= \(dqdirectory\(dq \(dq:\(dq STRING

  clients ::= \(dqclients\(dq \(dq:\(dq \(dq[\(dq clients_list \(dq]\(dq

  clients_list ::=
              | not_empty_clients_list

  not_empty_clients_list ::= basic_auth
                        | not_empty_clients_list \(dq,\(dq basic_auth
                        | not_empty_clients_list \(dq,\(dq

  basic_auth ::= \(dq{\(dq clients_params \(dq}\(dq

  clients_params ::= clients_param
                | clients_params \(dq,\(dq clients_param
                | clients_params \(dq,\(dq

  clients_param ::= user
               | user_file
               | password
               | password_file
               | user_context
               | comment
               | unknown_map_entry

  user_file ::= \(dquser\-file\(dq \(dq:\(dq STRING

  password_file ::= \(dqpassword\-file\(dq \(dq:\(dq STRING

  dhcp_queue_control ::= \(dqdhcp\-queue\-control\(dq \(dq:\(dq \(dq{\(dq queue_control_params \(dq}\(dq

  queue_control_params ::= queue_control_param
                      | queue_control_params \(dq,\(dq queue_control_param
                      | queue_control_params \(dq,\(dq

  queue_control_param ::= enable_queue
                     | queue_type
                     | capacity
                     | user_context
                     | comment
                     | arbitrary_map_entry

  enable_queue ::= \(dqenable\-queue\(dq \(dq:\(dq BOOLEAN

  queue_type ::= \(dqqueue\-type\(dq \(dq:\(dq STRING

  capacity ::= \(dqcapacity\(dq \(dq:\(dq INTEGER

  arbitrary_map_entry ::= STRING \(dq:\(dq value

  dhcp_ddns ::= \(dqdhcp\-ddns\(dq \(dq:\(dq \(dq{\(dq dhcp_ddns_params \(dq}\(dq

  sub_dhcp_ddns ::= \(dq{\(dq dhcp_ddns_params \(dq}\(dq

  dhcp_ddns_params ::= dhcp_ddns_param
                  | dhcp_ddns_params \(dq,\(dq dhcp_ddns_param
                  | dhcp_ddns_params \(dq,\(dq

  dhcp_ddns_param ::= enable_updates
                 | server_ip
                 | server_port
                 | sender_ip
                 | sender_port
                 | max_queue_size
                 | ncr_protocol
                 | ncr_format
                 | user_context
                 | comment
                 | unknown_map_entry

  enable_updates ::= \(dqenable\-updates\(dq \(dq:\(dq BOOLEAN

  server_ip ::= \(dqserver\-ip\(dq \(dq:\(dq STRING

  server_port ::= \(dqserver\-port\(dq \(dq:\(dq INTEGER

  sender_ip ::= \(dqsender\-ip\(dq \(dq:\(dq STRING

  sender_port ::= \(dqsender\-port\(dq \(dq:\(dq INTEGER

  max_queue_size ::= \(dqmax\-queue\-size\(dq \(dq:\(dq INTEGER

  ncr_protocol ::= \(dqncr\-protocol\(dq \(dq:\(dq ncr_protocol_value

  ncr_protocol_value ::= \(dqudp\(dq
                    | \(dqtcp\(dq

  ncr_format ::= \(dqncr\-format\(dq \(dq:\(dq \(dqJSON\(dq

  config_control ::= \(dqconfig\-control\(dq \(dq:\(dq \(dq{\(dq config_control_params \(dq}\(dq

  sub_config_control ::= \(dq{\(dq config_control_params \(dq}\(dq

  config_control_params ::= config_control_param
                       | config_control_params \(dq,\(dq config_control_param
                       | config_control_params \(dq,\(dq

  config_control_param ::= config_databases
                      | config_fetch_wait_time

  config_databases ::= \(dqconfig\-databases\(dq \(dq:\(dq \(dq[\(dq database_list \(dq]\(dq

  config_fetch_wait_time ::= \(dqconfig\-fetch\-wait\-time\(dq \(dq:\(dq INTEGER

  loggers ::= \(dqloggers\(dq \(dq:\(dq \(dq[\(dq loggers_entries \(dq]\(dq

  loggers_entries ::= logger_entry
                 | loggers_entries \(dq,\(dq logger_entry
                 | loggers_entries \(dq,\(dq

  logger_entry ::= \(dq{\(dq logger_params \(dq}\(dq

  logger_params ::= logger_param
               | logger_params \(dq,\(dq logger_param
               | logger_params \(dq,\(dq

  logger_param ::= name
              | output_options_list
              | debuglevel
              | severity
              | user_context
              | comment
              | unknown_map_entry

  debuglevel ::= \(dqdebuglevel\(dq \(dq:\(dq INTEGER

  severity ::= \(dqseverity\(dq \(dq:\(dq STRING

  output_options_list ::= \(dqoutput\-options\(dq \(dq:\(dq \(dq[\(dq output_options_list_content \(dq]\(dq

  output_options_list_content ::= output_entry
                             | output_options_list_content \(dq,\(dq output_entry
                             | output_options_list_content \(dq,\(dq

  output_entry ::= \(dq{\(dq output_params_list \(dq}\(dq

  output_params_list ::= output_params
                    | output_params_list \(dq,\(dq output_params
                    | output_params_list \(dq,\(dq

  output_params ::= output
               | flush
               | maxsize
               | maxver
               | pattern

  output ::= \(dqoutput\(dq \(dq:\(dq STRING

  flush ::= \(dqflush\(dq \(dq:\(dq BOOLEAN

  maxsize ::= \(dqmaxsize\(dq \(dq:\(dq INTEGER

  maxver ::= \(dqmaxver\(dq \(dq:\(dq INTEGER

  pattern ::= \(dqpattern\(dq \(dq:\(dq STRING

  compatibility ::= \(dqcompatibility\(dq \(dq:\(dq \(dq{\(dq compatibility_params \(dq}\(dq

  compatibility_params ::= compatibility_param
                      | compatibility_params \(dq,\(dq compatibility_param
                      | compatibility_params \(dq,\(dq

  compatibility_param ::= lenient_option_parsing
                     | ignore_dhcp_server_identifier
                     | ignore_rai_link_selection
                     | exclude_first_last_24
                     | unknown_map_entry

  lenient_option_parsing ::= \(dqlenient\-option\-parsing\(dq \(dq:\(dq BOOLEAN

  ignore_dhcp_server_identifier ::= \(dqignore\-dhcp\-server\-identifier\(dq \(dq:\(dq BOOLEAN

  ignore_rai_link_selection ::= \(dqignore\-rai\-link\-selection\(dq \(dq:\(dq BOOLEAN

  exclude_first_last_24 ::= \(dqexclude\-first\-last\-24\(dq \(dq:\(dq BOOLEAN
.EE
.UNINDENT
.UNINDENT.SS دستور زبان BNF برای DHCPv6
.sp
این دستور زبان از \fBdhcp6_parser.yy\fP\& تولید شده است. برای جزئیات بیشتر «The DHCPv6 Server» \%<#\:dhcp6> را ببینید.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
  Grammar

  $accept ::= start EOF

  start ::= TOPLEVEL_JSON sub_json

  start ::= TOPLEVEL_DHCP6 syntax_map

  start ::= SUB_DHCP6 sub_dhcp6

  start ::= SUB_INTERFACES6 sub_interfaces6

  start ::= SUB_SUBNET6 sub_subnet6

  start ::= SUB_POOL6 sub_pool6

  start ::= SUB_PD_POOL sub_pd_pool

  start ::= SUB_RESERVATION sub_reservation

  start ::= SUB_OPTION_DEFS sub_option_def_list

  start ::= SUB_OPTION_DEF sub_option_def

  start ::= SUB_OPTION_DATA sub_option_data

  start ::= SUB_HOOKS_LIBRARY sub_hooks_library

  start ::= SUB_DHCP_DDNS sub_dhcp_ddns

  start ::= SUB_CONFIG_CONTROL sub_config_control

  value ::= INTEGER
       | FLOAT
       | BOOLEAN
       | STRING
       | NULL
       | map2
       | list_generic

  sub_json ::= value

  map2 ::= \(dq{\(dq map_content \(dq}\(dq

  map_value ::= map2

  map_content ::=
             | not_empty_map

  not_empty_map ::= STRING \(dq:\(dq value
               | not_empty_map \(dq,\(dq STRING \(dq:\(dq value
               | not_empty_map \(dq,\(dq

  list_generic ::= \(dq[\(dq list_content \(dq]\(dq

  list_content ::=
              | not_empty_list

  not_empty_list ::= value
                | not_empty_list \(dq,\(dq value
                | not_empty_list \(dq,\(dq

  list_strings ::= \(dq[\(dq list_strings_content \(dq]\(dq

  list_strings_content ::=
                      | not_empty_list_strings

  not_empty_list_strings ::= STRING
                        | not_empty_list_strings \(dq,\(dq STRING
                        | not_empty_list_strings \(dq,\(dq

  unknown_map_entry ::= STRING \(dq:\(dq

  syntax_map ::= \(dq{\(dq global_object \(dq}\(dq

  global_object ::= \(dqDhcp6\(dq \(dq:\(dq \(dq{\(dq global_params \(dq}\(dq
               | global_object_comma

  global_object_comma ::= global_object \(dq,\(dq

  sub_dhcp6 ::= \(dq{\(dq global_params \(dq}\(dq

  global_params ::= global_param
               | global_params \(dq,\(dq global_param
               | global_params \(dq,\(dq

  global_param ::= data_directory
              | preferred_lifetime
              | min_preferred_lifetime
              | max_preferred_lifetime
              | valid_lifetime
              | min_valid_lifetime
              | max_valid_lifetime
              | renew_timer
              | rebind_timer
              | decline_probation_period
              | subnet6_list
              | shared_networks
              | interfaces_config
              | lease_database
              | hosts_database
              | hosts_databases
              | mac_sources
              | relay_supplied_options
              | host_reservation_identifiers
              | client_classes
              | option_def_list
              | option_data_list
              | hooks_libraries
              | expired_leases_processing
              | server_id
              | dhcp4o6_port
              | control_socket
              | control_sockets
              | dhcp_queue_control
              | dhcp_ddns
              | user_context
              | comment
              | sanity_checks
              | reservations
              | config_control
              | server_tag
              | reservations_global
              | reservations_in_subnet
              | reservations_out_of_pool
              | calculate_tee_times
              | t1_percent
              | t2_percent
              | cache_threshold
              | cache_max_age
              | adaptive_lease_time_threshold
              | loggers
              | hostname_char_set
              | hostname_char_replacement
              | ddns_send_updates
              | ddns_override_no_update
              | ddns_override_client_update
              | ddns_replace_client_name
              | ddns_generated_prefix
              | ddns_qualifying_suffix
              | ddns_update_on_renew
              | ddns_use_conflict_resolution
              | ddns_conflict_resolution_mode
              | ddns_ttl_percent
              | ddns_ttl
              | ddns_ttl_min
              | ddns_ttl_max
              | store_extended_info
              | statistic_default_sample_count
              | statistic_default_sample_age
              | dhcp_multi_threading
              | early_global_reservations_lookup
              | ip_reservations_unique
              | reservations_lookup_first
              | allow_address_registration
              | compatibility
              | parked_packet_limit
              | allocator
              | pd_allocator
              | unknown_map_entry

  data_directory ::= \(dqdata\-directory\(dq \(dq:\(dq STRING

  preferred_lifetime ::= \(dqpreferred\-lifetime\(dq \(dq:\(dq INTEGER

  min_preferred_lifetime ::= \(dqmin\-preferred\-lifetime\(dq \(dq:\(dq INTEGER

  max_preferred_lifetime ::= \(dqmax\-preferred\-lifetime\(dq \(dq:\(dq INTEGER

  valid_lifetime ::= \(dqvalid\-lifetime\(dq \(dq:\(dq INTEGER

  min_valid_lifetime ::= \(dqmin\-valid\-lifetime\(dq \(dq:\(dq INTEGER

  max_valid_lifetime ::= \(dqmax\-valid\-lifetime\(dq \(dq:\(dq INTEGER

  renew_timer ::= \(dqrenew\-timer\(dq \(dq:\(dq INTEGER

  rebind_timer ::= \(dqrebind\-timer\(dq \(dq:\(dq INTEGER

  calculate_tee_times ::= \(dqcalculate\-tee\-times\(dq \(dq:\(dq BOOLEAN

  t1_percent ::= \(dqt1\-percent\(dq \(dq:\(dq FLOAT

  t2_percent ::= \(dqt2\-percent\(dq \(dq:\(dq FLOAT

  cache_threshold ::= \(dqcache\-threshold\(dq \(dq:\(dq FLOAT

  cache_max_age ::= \(dqcache\-max\-age\(dq \(dq:\(dq INTEGER

  adaptive_lease_time_threshold ::= \(dqadaptive\-lease\-time\-threshold\(dq \(dq:\(dq FLOAT

  decline_probation_period ::= \(dqdecline\-probation\-period\(dq \(dq:\(dq INTEGER

  ddns_send_updates ::= \(dqddns\-send\-updates\(dq \(dq:\(dq BOOLEAN

  ddns_override_no_update ::= \(dqddns\-override\-no\-update\(dq \(dq:\(dq BOOLEAN

  ddns_override_client_update ::= \(dqddns\-override\-client\-update\(dq \(dq:\(dq BOOLEAN

  ddns_replace_client_name ::= \(dqddns\-replace\-client\-name\(dq \(dq:\(dq ddns_replace_client_name_value

  ddns_replace_client_name_value ::= \(dqwhen\-present\(dq
                                | \(dqnever\(dq
                                | \(dqalways\(dq
                                | \(dqwhen\-not\-present\(dq
                                | BOOLEAN

  ddns_generated_prefix ::= \(dqddns\-generated\-prefix\(dq \(dq:\(dq STRING

  ddns_qualifying_suffix ::= \(dqddns\-qualifying\-suffix\(dq \(dq:\(dq STRING

  ddns_update_on_renew ::= \(dqddns\-update\-on\-renew\(dq \(dq:\(dq BOOLEAN

  ddns_use_conflict_resolution ::= \(dqddns\-use\-conflict\-resolution\(dq \(dq:\(dq BOOLEAN

  ddns_conflict_resolution_mode ::= \(dqddns\-conflict\-resolution\-mode\(dq \(dq:\(dq ddns_conflict_resolution_mode_value

  ddns_conflict_resolution_mode_value ::= \(dqcheck\-with\-dhcid\(dq
                                     | \(dqno\-check\-with\-dhcid\(dq
                                     | \(dqcheck\-exists\-with\-dhcid\(dq
                                     | \(dqno\-check\-without\-dhcid\(dq

  ddns_ttl_percent ::= \(dqddns\-ttl\-percent\(dq \(dq:\(dq FLOAT

  ddns_ttl ::= \(dqddns\-ttl\(dq \(dq:\(dq INTEGER

  ddns_ttl_min ::= \(dqddns\-ttl\-min\(dq \(dq:\(dq INTEGER

  ddns_ttl_max ::= \(dqddns\-ttl\-max\(dq \(dq:\(dq INTEGER

  hostname_char_set ::= \(dqhostname\-char\-set\(dq \(dq:\(dq STRING

  hostname_char_replacement ::= \(dqhostname\-char\-replacement\(dq \(dq:\(dq STRING

  store_extended_info ::= \(dqstore\-extended\-info\(dq \(dq:\(dq BOOLEAN

  statistic_default_sample_count ::= \(dqstatistic\-default\-sample\-count\(dq \(dq:\(dq INTEGER

  statistic_default_sample_age ::= \(dqstatistic\-default\-sample\-age\(dq \(dq:\(dq INTEGER

  server_tag ::= \(dqserver\-tag\(dq \(dq:\(dq STRING

  parked_packet_limit ::= \(dqparked\-packet\-limit\(dq \(dq:\(dq INTEGER

  allocator ::= \(dqallocator\(dq \(dq:\(dq STRING

  pd_allocator ::= \(dqpd\-allocator\(dq \(dq:\(dq STRING

  early_global_reservations_lookup ::= \(dqearly\-global\-reservations\-lookup\(dq \(dq:\(dq BOOLEAN

  ip_reservations_unique ::= \(dqip\-reservations\-unique\(dq \(dq:\(dq BOOLEAN

  reservations_lookup_first ::= \(dqreservations\-lookup\-first\(dq \(dq:\(dq BOOLEAN

  allow_address_registration ::= \(dqallow\-address\-registration\(dq \(dq:\(dq BOOLEAN

  interfaces_config ::= \(dqinterfaces\-config\(dq \(dq:\(dq \(dq{\(dq interfaces_config_params \(dq}\(dq

  sub_interfaces6 ::= \(dq{\(dq interfaces_config_params \(dq}\(dq

  interfaces_config_params ::= interfaces_config_param
                          | interfaces_config_params \(dq,\(dq interfaces_config_param
                          | interfaces_config_params \(dq,\(dq

  interfaces_config_param ::= interfaces_list
                         | re_detect
                         | service_sockets_require_all
                         | service_sockets_retry_wait_time
                         | service_sockets_max_retries
                         | user_context
                         | comment
                         | unknown_map_entry

  interfaces_list ::= \(dqinterfaces\(dq \(dq:\(dq list_strings

  re_detect ::= \(dqre\-detect\(dq \(dq:\(dq BOOLEAN

  service_sockets_require_all ::= \(dqservice\-sockets\-require\-all\(dq \(dq:\(dq BOOLEAN

  service_sockets_retry_wait_time ::= \(dqservice\-sockets\-retry\-wait\-time\(dq \(dq:\(dq INTEGER

  service_sockets_max_retries ::= \(dqservice\-sockets\-max\-retries\(dq \(dq:\(dq INTEGER

  lease_database ::= \(dqlease\-database\(dq \(dq:\(dq \(dq{\(dq database_map_params \(dq}\(dq

  hosts_database ::= \(dqhosts\-database\(dq \(dq:\(dq \(dq{\(dq database_map_params \(dq}\(dq

  hosts_databases ::= \(dqhosts\-databases\(dq \(dq:\(dq \(dq[\(dq database_list \(dq]\(dq

  database_list ::=
               | not_empty_database_list

  not_empty_database_list ::= database
                         | not_empty_database_list \(dq,\(dq database
                         | not_empty_database_list \(dq,\(dq

  database ::= \(dq{\(dq database_map_params \(dq}\(dq

  database_map_params ::= database_map_param
                     | database_map_params \(dq,\(dq database_map_param
                     | database_map_params \(dq,\(dq

  database_map_param ::= database_type
                    | user
                    | password
                    | host
                    | port
                    | name
                    | persist
                    | lfc_interval
                    | readonly
                    | connect_timeout
                    | read_timeout
                    | write_timeout
                    | tcp_user_timeout
                    | max_reconnect_tries
                    | reconnect_wait_time
                    | on_fail
                    | retry_on_startup
                    | max_row_errors
                    | trust_anchor
                    | cert_file
                    | key_file
                    | ssl_mode
                    | cipher_list
                    | unknown_map_entry

  database_type ::= \(dqtype\(dq \(dq:\(dq STRING

  user ::= \(dquser\(dq \(dq:\(dq STRING

  password ::= \(dqpassword\(dq \(dq:\(dq STRING

  host ::= \(dqhost\(dq \(dq:\(dq STRING

  port ::= \(dqport\(dq \(dq:\(dq INTEGER

  name ::= \(dqname\(dq \(dq:\(dq STRING

  persist ::= \(dqpersist\(dq \(dq:\(dq BOOLEAN

  lfc_interval ::= \(dqlfc\-interval\(dq \(dq:\(dq INTEGER

  readonly ::= \(dqreadonly\(dq \(dq:\(dq BOOLEAN

  connect_timeout ::= \(dqconnect\-timeout\(dq \(dq:\(dq INTEGER

  read_timeout ::= \(dqread\-timeout\(dq \(dq:\(dq INTEGER

  write_timeout ::= \(dqwrite\-timeout\(dq \(dq:\(dq INTEGER

  tcp_user_timeout ::= \(dqtcp\-user\-timeout\(dq \(dq:\(dq INTEGER

  reconnect_wait_time ::= \(dqreconnect\-wait\-time\(dq \(dq:\(dq INTEGER

  on_fail ::= \(dqon\-fail\(dq \(dq:\(dq on_fail_mode

  on_fail_mode ::= \(dqstop\-retry\-exit\(dq
              | \(dqserve\-retry\-exit\(dq
              | \(dqserve\-retry\-continue\(dq

  retry_on_startup ::= \(dqretry\-on\-startup\(dq \(dq:\(dq BOOLEAN

  max_row_errors ::= \(dqmax\-row\-errors\(dq \(dq:\(dq INTEGER

  max_reconnect_tries ::= \(dqmax\-reconnect\-tries\(dq \(dq:\(dq INTEGER

  trust_anchor ::= \(dqtrust\-anchor\(dq \(dq:\(dq STRING

  cert_file ::= \(dqcert\-file\(dq \(dq:\(dq STRING

  key_file ::= \(dqkey\-file\(dq \(dq:\(dq STRING

  ssl_mode ::= \(dqssl\-mode\(dq \(dq:\(dq ssl_mode
          | \(dqdisable\(dq
          | \(dqprefer\(dq
          | \(dqrequire\(dq
          | \(dqverify\-ca\(dq
          | \(dqverify\-full\(dq

  cipher_list ::= \(dqcipher\-list\(dq \(dq:\(dq STRING

  sanity_checks ::= \(dqsanity\-checks\(dq \(dq:\(dq \(dq{\(dq sanity_checks_params \(dq}\(dq

  sanity_checks_params ::= sanity_checks_param
                      | sanity_checks_params \(dq,\(dq sanity_checks_param
                      | sanity_checks_params \(dq,\(dq

  sanity_checks_param ::= lease_checks
                     | extended_info_checks

  lease_checks ::= \(dqlease\-checks\(dq \(dq:\(dq STRING

  extended_info_checks ::= \(dqextended\-info\-checks\(dq \(dq:\(dq STRING

  mac_sources ::= \(dqmac\-sources\(dq \(dq:\(dq \(dq[\(dq mac_sources_list \(dq]\(dq

  mac_sources_list ::= mac_sources_value
                  | mac_sources_list \(dq,\(dq mac_sources_value
                  | mac_sources_list \(dq,\(dq

  mac_sources_value ::= duid_id
                   | string_id

  duid_id ::= \(dqduid\(dq

  string_id ::= STRING

  host_reservation_identifiers ::= \(dqhost\-reservation\-identifiers\(dq \(dq:\(dq \(dq[\(dq host_reservation_identifiers_list \(dq]\(dq

  host_reservation_identifiers_list ::= host_reservation_identifier
                                   | host_reservation_identifiers_list \(dq,\(dq host_reservation_identifier
                                   | host_reservation_identifiers_list \(dq,\(dq

  host_reservation_identifier ::= duid_id
                             | hw_address_id
                             | flex_id

  hw_address_id ::= \(dqhw\-address\(dq

  flex_id ::= \(dqflex\-id\(dq

  relay_supplied_options ::= \(dqrelay\-supplied\-options\(dq \(dq:\(dq \(dq[\(dq list_content \(dq]\(dq

  dhcp_multi_threading ::= \(dqmulti\-threading\(dq \(dq:\(dq \(dq{\(dq multi_threading_params \(dq}\(dq

  multi_threading_params ::= multi_threading_param
                        | multi_threading_params \(dq,\(dq multi_threading_param
                        | multi_threading_params \(dq,\(dq

  multi_threading_param ::= enable_multi_threading
                       | thread_pool_size
                       | packet_queue_size
                       | user_context
                       | comment
                       | unknown_map_entry

  enable_multi_threading ::= \(dqenable\-multi\-threading\(dq \(dq:\(dq BOOLEAN

  thread_pool_size ::= \(dqthread\-pool\-size\(dq \(dq:\(dq INTEGER

  packet_queue_size ::= \(dqpacket\-queue\-size\(dq \(dq:\(dq INTEGER

  hooks_libraries ::= \(dqhooks\-libraries\(dq \(dq:\(dq \(dq[\(dq hooks_libraries_list \(dq]\(dq

  hooks_libraries_list ::=
                      | not_empty_hooks_libraries_list

  not_empty_hooks_libraries_list ::= hooks_library
                                | not_empty_hooks_libraries_list \(dq,\(dq hooks_library
                                | not_empty_hooks_libraries_list \(dq,\(dq

  hooks_library ::= \(dq{\(dq hooks_params \(dq}\(dq

  sub_hooks_library ::= \(dq{\(dq hooks_params \(dq}\(dq

  hooks_params ::= hooks_param
              | hooks_params \(dq,\(dq hooks_param
              | hooks_params \(dq,\(dq
              | unknown_map_entry

  hooks_param ::= library
             | parameters

  library ::= \(dqlibrary\(dq \(dq:\(dq STRING

  parameters ::= \(dqparameters\(dq \(dq:\(dq map_value

  expired_leases_processing ::= \(dqexpired\-leases\-processing\(dq \(dq:\(dq \(dq{\(dq expired_leases_params \(dq}\(dq

  expired_leases_params ::= expired_leases_param
                       | expired_leases_params \(dq,\(dq expired_leases_param
                       | expired_leases_params \(dq,\(dq

  expired_leases_param ::= reclaim_timer_wait_time
                      | flush_reclaimed_timer_wait_time
                      | hold_reclaimed_time
                      | max_reclaim_leases
                      | max_reclaim_time
                      | unwarned_reclaim_cycles

  reclaim_timer_wait_time ::= \(dqreclaim\-timer\-wait\-time\(dq \(dq:\(dq INTEGER

  flush_reclaimed_timer_wait_time ::= \(dqflush\-reclaimed\-timer\-wait\-time\(dq \(dq:\(dq INTEGER

  hold_reclaimed_time ::= \(dqhold\-reclaimed\-time\(dq \(dq:\(dq INTEGER

  max_reclaim_leases ::= \(dqmax\-reclaim\-leases\(dq \(dq:\(dq INTEGER

  max_reclaim_time ::= \(dqmax\-reclaim\-time\(dq \(dq:\(dq INTEGER

  unwarned_reclaim_cycles ::= \(dqunwarned\-reclaim\-cycles\(dq \(dq:\(dq INTEGER

  subnet6_list ::= \(dqsubnet6\(dq \(dq:\(dq \(dq[\(dq subnet6_list_content \(dq]\(dq

  subnet6_list_content ::=
                      | not_empty_subnet6_list

  not_empty_subnet6_list ::= subnet6
                        | not_empty_subnet6_list \(dq,\(dq subnet6
                        | not_empty_subnet6_list \(dq,\(dq

  subnet6 ::= \(dq{\(dq subnet6_params \(dq}\(dq

  sub_subnet6 ::= \(dq{\(dq subnet6_params \(dq}\(dq

  subnet6_params ::= subnet6_param
                | subnet6_params \(dq,\(dq subnet6_param
                | subnet6_params \(dq,\(dq

  subnet6_param ::= preferred_lifetime
               | min_preferred_lifetime
               | max_preferred_lifetime
               | valid_lifetime
               | min_valid_lifetime
               | max_valid_lifetime
               | renew_timer
               | rebind_timer
               | option_data_list
               | pools_list
               | pd_pools_list
               | subnet
               | interface
               | interface_id
               | id
               | rapid_commit
               | client_class
               | network_client_classes
               | require_client_classes
               | evaluate_additional_classes
               | reservations
               | reservations_global
               | reservations_in_subnet
               | reservations_out_of_pool
               | relay
               | user_context
               | comment
               | calculate_tee_times
               | t1_percent
               | t2_percent
               | cache_threshold
               | cache_max_age
               | adaptive_lease_time_threshold
               | hostname_char_set
               | hostname_char_replacement
               | ddns_send_updates
               | ddns_override_no_update
               | ddns_override_client_update
               | ddns_replace_client_name
               | ddns_generated_prefix
               | ddns_qualifying_suffix
               | ddns_update_on_renew
               | ddns_use_conflict_resolution
               | ddns_conflict_resolution_mode
               | ddns_ttl_percent
               | ddns_ttl
               | ddns_ttl_min
               | ddns_ttl_max
               | store_extended_info
               | allocator
               | pd_allocator
               | unknown_map_entry

  subnet ::= \(dqsubnet\(dq \(dq:\(dq STRING

  interface ::= \(dqinterface\(dq \(dq:\(dq STRING

  interface_id ::= \(dqinterface\-id\(dq \(dq:\(dq STRING

  client_class ::= \(dqclient\-class\(dq \(dq:\(dq STRING

  network_client_classes ::= \(dqclient\-classes\(dq \(dq:\(dq list_strings

  require_client_classes ::= \(dqrequire\-client\-classes\(dq \(dq:\(dq list_strings

  evaluate_additional_classes ::= \(dqevaluate\-additional\-classes\(dq \(dq:\(dq list_strings

  reservations_global ::= \(dqreservations\-global\(dq \(dq:\(dq BOOLEAN

  reservations_in_subnet ::= \(dqreservations\-in\-subnet\(dq \(dq:\(dq BOOLEAN

  reservations_out_of_pool ::= \(dqreservations\-out\-of\-pool\(dq \(dq:\(dq BOOLEAN

  id ::= \(dqid\(dq \(dq:\(dq INTEGER

  rapid_commit ::= \(dqrapid\-commit\(dq \(dq:\(dq BOOLEAN

  shared_networks ::= \(dqshared\-networks\(dq \(dq:\(dq \(dq[\(dq shared_networks_content \(dq]\(dq

  shared_networks_content ::=
                         | shared_networks_list

  shared_networks_list ::= shared_network
                      | shared_networks_list \(dq,\(dq shared_network
                      | shared_networks_list \(dq,\(dq

  shared_network ::= \(dq{\(dq shared_network_params \(dq}\(dq

  shared_network_params ::= shared_network_param
                       | shared_network_params \(dq,\(dq shared_network_param
                       | shared_network_params \(dq,\(dq

  shared_network_param ::= name
                      | subnet6_list
                      | interface
                      | interface_id
                      | renew_timer
                      | rebind_timer
                      | option_data_list
                      | relay
                      | reservations_global
                      | reservations_in_subnet
                      | reservations_out_of_pool
                      | client_class
                      | network_client_classes
                      | require_client_classes
                      | evaluate_additional_classes
                      | preferred_lifetime
                      | min_preferred_lifetime
                      | max_preferred_lifetime
                      | rapid_commit
                      | valid_lifetime
                      | min_valid_lifetime
                      | max_valid_lifetime
                      | user_context
                      | comment
                      | calculate_tee_times
                      | t1_percent
                      | t2_percent
                      | cache_threshold
                      | cache_max_age
                      | adaptive_lease_time_threshold
                      | hostname_char_set
                      | hostname_char_replacement
                      | ddns_send_updates
                      | ddns_override_no_update
                      | ddns_override_client_update
                      | ddns_replace_client_name
                      | ddns_generated_prefix
                      | ddns_qualifying_suffix
                      | ddns_update_on_renew
                      | ddns_use_conflict_resolution
                      | ddns_conflict_resolution_mode
                      | ddns_ttl_percent
                      | ddns_ttl
                      | ddns_ttl_min
                      | ddns_ttl_max
                      | store_extended_info
                      | allocator
                      | pd_allocator
                      | unknown_map_entry

  option_def_list ::= \(dqoption\-def\(dq \(dq:\(dq \(dq[\(dq option_def_list_content \(dq]\(dq

  sub_option_def_list ::= \(dq{\(dq option_def_list \(dq}\(dq

  option_def_list_content ::=
                         | not_empty_option_def_list

  not_empty_option_def_list ::= option_def_entry
                           | not_empty_option_def_list \(dq,\(dq option_def_entry
                           | not_empty_option_def_list \(dq,\(dq

  option_def_entry ::= \(dq{\(dq option_def_params \(dq}\(dq

  sub_option_def ::= \(dq{\(dq option_def_params \(dq}\(dq

  option_def_params ::=
                   | not_empty_option_def_params

  not_empty_option_def_params ::= option_def_param
                             | not_empty_option_def_params \(dq,\(dq option_def_param
                             | not_empty_option_def_params \(dq,\(dq

  option_def_param ::= option_def_name
                  | option_def_code
                  | option_def_type
                  | option_def_record_types
                  | option_def_space
                  | option_def_encapsulate
                  | option_def_array
                  | user_context
                  | comment
                  | unknown_map_entry

  option_def_name ::= name

  code ::= \(dqcode\(dq \(dq:\(dq INTEGER

  option_def_code ::= code

  option_def_type ::= \(dqtype\(dq \(dq:\(dq STRING

  option_def_record_types ::= \(dqrecord\-types\(dq \(dq:\(dq STRING

  space ::= \(dqspace\(dq \(dq:\(dq STRING

  option_def_space ::= space

  option_def_encapsulate ::= \(dqencapsulate\(dq \(dq:\(dq STRING

  option_def_array ::= \(dqarray\(dq \(dq:\(dq BOOLEAN

  option_data_list ::= \(dqoption\-data\(dq \(dq:\(dq \(dq[\(dq option_data_list_content \(dq]\(dq

  option_data_list_content ::=
                          | not_empty_option_data_list

  not_empty_option_data_list ::= option_data_entry
                            | not_empty_option_data_list \(dq,\(dq option_data_entry
                            | not_empty_option_data_list \(dq,\(dq

  option_data_entry ::= \(dq{\(dq option_data_params \(dq}\(dq

  sub_option_data ::= \(dq{\(dq option_data_params \(dq}\(dq

  option_data_params ::=
                    | not_empty_option_data_params

  not_empty_option_data_params ::= option_data_param
                              | not_empty_option_data_params \(dq,\(dq option_data_param
                              | not_empty_option_data_params \(dq,\(dq

  option_data_param ::= option_data_name
                   | option_data_data
                   | option_data_code
                   | option_data_space
                   | option_data_csv_format
                   | option_data_always_send
                   | option_data_never_send
                   | user_context
                   | comment
                   | option_data_client_classes
                   | unknown_map_entry

  option_data_name ::= name

  option_data_data ::= \(dqdata\(dq \(dq:\(dq STRING

  option_data_code ::= code

  option_data_space ::= space

  option_data_csv_format ::= \(dqcsv\-format\(dq \(dq:\(dq BOOLEAN

  option_data_always_send ::= \(dqalways\-send\(dq \(dq:\(dq BOOLEAN

  option_data_never_send ::= \(dqnever\-send\(dq \(dq:\(dq BOOLEAN

  option_data_client_classes ::= \(dqclient\-classes\(dq \(dq:\(dq list_strings

  pools_list ::= \(dqpools\(dq \(dq:\(dq \(dq[\(dq pools_list_content \(dq]\(dq

  pools_list_content ::=
                    | not_empty_pools_list

  not_empty_pools_list ::= pool_list_entry
                      | not_empty_pools_list \(dq,\(dq pool_list_entry
                      | not_empty_pools_list \(dq,\(dq

  pool_list_entry ::= \(dq{\(dq pool_params \(dq}\(dq

  sub_pool6 ::= \(dq{\(dq pool_params \(dq}\(dq

  pool_params ::= pool_param
             | pool_params \(dq,\(dq pool_param
             | pool_params \(dq,\(dq

  pool_param ::= pool_entry
            | pool_id
            | option_data_list
            | client_class
            | network_client_classes
            | require_client_classes
            | evaluate_additional_classes
            | ddns_send_updates
            | ddns_override_no_update
            | ddns_override_client_update
            | ddns_replace_client_name
            | ddns_generated_prefix
            | ddns_qualifying_suffix
            | ddns_update_on_renew
            | ddns_conflict_resolution_mode
            | ddns_ttl_percent
            | ddns_ttl
            | ddns_ttl_min
            | ddns_ttl_max
            | hostname_char_set
            | hostname_char_replacement
            | user_context
            | comment
            | unknown_map_entry

  pool_entry ::= \(dqpool\(dq \(dq:\(dq STRING

  pool_id ::= \(dqpool\-id\(dq \(dq:\(dq INTEGER

  user_context ::= \(dquser\-context\(dq \(dq:\(dq map_value

  comment ::= \(dqcomment\(dq \(dq:\(dq STRING

  pd_pools_list ::= \(dqpd\-pools\(dq \(dq:\(dq \(dq[\(dq pd_pools_list_content \(dq]\(dq

  pd_pools_list_content ::=
                       | not_empty_pd_pools_list

  not_empty_pd_pools_list ::= pd_pool_entry
                         | not_empty_pd_pools_list \(dq,\(dq pd_pool_entry
                         | not_empty_pd_pools_list \(dq,\(dq

  pd_pool_entry ::= \(dq{\(dq pd_pool_params \(dq}\(dq

  sub_pd_pool ::= \(dq{\(dq pd_pool_params \(dq}\(dq

  pd_pool_params ::= pd_pool_param
                | pd_pool_params \(dq,\(dq pd_pool_param
                | pd_pool_params \(dq,\(dq

  pd_pool_param ::= pd_prefix
               | pd_prefix_len
               | pd_delegated_len
               | pool_id
               | option_data_list
               | client_class
               | network_client_classes
               | require_client_classes
               | evaluate_additional_classes
               | excluded_prefix
               | excluded_prefix_len
               | user_context
               | comment
               | unknown_map_entry

  pd_prefix ::= \(dqprefix\(dq \(dq:\(dq STRING

  pd_prefix_len ::= \(dqprefix\-len\(dq \(dq:\(dq INTEGER

  excluded_prefix ::= \(dqexcluded\-prefix\(dq \(dq:\(dq STRING

  excluded_prefix_len ::= \(dqexcluded\-prefix\-len\(dq \(dq:\(dq INTEGER

  pd_delegated_len ::= \(dqdelegated\-len\(dq \(dq:\(dq INTEGER

  reservations ::= \(dqreservations\(dq \(dq:\(dq \(dq[\(dq reservations_list \(dq]\(dq

  reservations_list ::=
                   | not_empty_reservations_list

  not_empty_reservations_list ::= reservation
                             | not_empty_reservations_list \(dq,\(dq reservation
                             | not_empty_reservations_list \(dq,\(dq

  reservation ::= \(dq{\(dq reservation_params \(dq}\(dq

  sub_reservation ::= \(dq{\(dq reservation_params \(dq}\(dq

  reservation_params ::=
                    | not_empty_reservation_params

  not_empty_reservation_params ::= reservation_param
                              | not_empty_reservation_params \(dq,\(dq reservation_param
                              | not_empty_reservation_params \(dq,\(dq

  reservation_param ::= duid
                   | reservation_client_classes
                   | ip_addresses
                   | prefixes
                   | excluded_prefixes
                   | hw_address
                   | hostname
                   | flex_id_value
                   | option_data_list
                   | user_context
                   | comment
                   | unknown_map_entry

  ip_addresses ::= \(dqip\-addresses\(dq \(dq:\(dq list_strings

  prefixes ::= \(dqprefixes\(dq \(dq:\(dq list_strings

  excluded_prefixes ::= \(dqexcluded\-prefixes\(dq \(dq:\(dq list_strings

  duid ::= \(dqduid\(dq \(dq:\(dq STRING

  hw_address ::= \(dqhw\-address\(dq \(dq:\(dq STRING

  hostname ::= \(dqhostname\(dq \(dq:\(dq STRING

  flex_id_value ::= \(dqflex\-id\(dq \(dq:\(dq STRING

  reservation_client_classes ::= \(dqclient\-classes\(dq \(dq:\(dq list_strings

  relay ::= \(dqrelay\(dq \(dq:\(dq \(dq{\(dq relay_map \(dq}\(dq

  relay_map ::= ip_addresses

  client_classes ::= \(dqclient\-classes\(dq \(dq:\(dq \(dq[\(dq client_classes_list \(dq]\(dq

  client_classes_list ::=
                     | not_empty_classes_list

  not_empty_classes_list ::= client_class_entry
                        | not_empty_classes_list \(dq,\(dq client_class_entry
                        | not_empty_classes_list \(dq,\(dq

  client_class_entry ::= \(dq{\(dq client_class_params \(dq}\(dq

  client_class_params ::=
                     | not_empty_client_class_params

  not_empty_client_class_params ::= client_class_param
                               | not_empty_client_class_params \(dq,\(dq client_class_param
                               | not_empty_client_class_params \(dq,\(dq

  client_class_param ::= client_class_name
                    | client_class_test
                    | client_class_template_test
                    | only_if_required
                    | only_in_additional_list
                    | option_data_list
                    | user_context
                    | comment
                    | preferred_lifetime
                    | min_preferred_lifetime
                    | max_preferred_lifetime
                    | valid_lifetime
                    | min_valid_lifetime
                    | max_valid_lifetime
                    | unknown_map_entry

  client_class_name ::= name

  client_class_test ::= \(dqtest\(dq \(dq:\(dq STRING

  client_class_template_test ::= \(dqtemplate\-test\(dq \(dq:\(dq STRING

  only_if_required ::= \(dqonly\-if\-required\(dq \(dq:\(dq BOOLEAN

  only_in_additional_list ::= \(dqonly\-in\-additional\-list\(dq \(dq:\(dq BOOLEAN

  server_id ::= \(dqserver\-id\(dq \(dq:\(dq \(dq{\(dq server_id_params \(dq}\(dq

  server_id_params ::= server_id_param
                  | server_id_params \(dq,\(dq server_id_param
                  | server_id_params \(dq,\(dq

  server_id_param ::= server_id_type
                 | identifier
                 | time
                 | htype
                 | enterprise_id
                 | persist
                 | user_context
                 | comment
                 | unknown_map_entry

  server_id_type ::= \(dqtype\(dq \(dq:\(dq duid_type

  duid_type ::= \(dqLLT\(dq
           | \(dqEN\(dq
           | \(dqLL\(dq

  htype ::= \(dqhtype\(dq \(dq:\(dq INTEGER

  identifier ::= \(dqidentifier\(dq \(dq:\(dq STRING

  time ::= \(dqtime\(dq \(dq:\(dq INTEGER

  enterprise_id ::= \(dqenterprise\-id\(dq \(dq:\(dq INTEGER

  dhcp4o6_port ::= \(dqdhcp4o6\-port\(dq \(dq:\(dq INTEGER

  control_socket ::= \(dqcontrol\-socket\(dq \(dq:\(dq \(dq{\(dq control_socket_params \(dq}\(dq

  control_sockets ::= \(dqcontrol\-sockets\(dq \(dq:\(dq \(dq[\(dq control_socket_list \(dq]\(dq

  control_socket_list ::=
                     | not_empty_control_socket_list

  not_empty_control_socket_list ::= control_socket_entry
                               | not_empty_control_socket_list \(dq,\(dq control_socket_entry
                               | not_empty_control_socket_list \(dq,\(dq

  control_socket_entry ::= \(dq{\(dq control_socket_params \(dq}\(dq

  control_socket_params ::= control_socket_param
                       | control_socket_params \(dq,\(dq control_socket_param
                       | control_socket_params \(dq,\(dq

  control_socket_param ::= control_socket_type
                      | control_socket_name
                      | control_socket_address
                      | control_socket_port
                      | authentication
                      | trust_anchor
                      | cert_file
                      | key_file
                      | cert_required
                      | http_headers
                      | user_context
                      | comment
                      | unknown_map_entry

  control_socket_type ::= \(dqsocket\-type\(dq \(dq:\(dq control_socket_type_value

  control_socket_type_value ::= \(dqunix\(dq
                           | \(dqhttp\(dq
                           | \(dqhttps\(dq

  control_socket_name ::= \(dqsocket\-name\(dq \(dq:\(dq STRING

  control_socket_address ::= \(dqsocket\-address\(dq \(dq:\(dq STRING

  control_socket_port ::= \(dqsocket\-port\(dq \(dq:\(dq INTEGER

  cert_required ::= \(dqcert\-required\(dq \(dq:\(dq BOOLEAN

  http_headers ::= \(dqhttp\-headers\(dq \(dq:\(dq \(dq[\(dq http_header_list \(dq]\(dq

  http_header_list ::=
                  | not_empty_http_header_list

  not_empty_http_header_list ::= http_header
                            | not_empty_http_header_list \(dq,\(dq http_header
                            | not_empty_http_header_list \(dq,\(dq

  http_header ::= \(dq{\(dq http_header_params \(dq}\(dq

  http_header_params ::= http_header_param
                    | http_header_params \(dq,\(dq http_header_param
                    | http_header_params \(dq,\(dq

  http_header_param ::= name
                   | header_value
                   | user_context
                   | comment
                   | unknown_map_entry

  header_value ::= \(dqvalue\(dq \(dq:\(dq STRING

  authentication ::= \(dqauthentication\(dq \(dq:\(dq \(dq{\(dq auth_params \(dq}\(dq

  auth_params ::= auth_param
             | auth_params \(dq,\(dq auth_param
             | auth_params \(dq,\(dq

  auth_param ::= auth_type
            | realm
            | directory
            | clients
            | comment
            | user_context
            | unknown_map_entry

  auth_type ::= \(dqtype\(dq \(dq:\(dq auth_type_value

  auth_type_value ::= \(dqbasic\(dq

  realm ::= \(dqrealm\(dq \(dq:\(dq STRING

  directory ::= \(dqdirectory\(dq \(dq:\(dq STRING

  clients ::= \(dqclients\(dq \(dq:\(dq \(dq[\(dq clients_list \(dq]\(dq

  clients_list ::=
              | not_empty_clients_list

  not_empty_clients_list ::= basic_auth
                        | not_empty_clients_list \(dq,\(dq basic_auth
                        | not_empty_clients_list \(dq,\(dq

  basic_auth ::= \(dq{\(dq clients_params \(dq}\(dq

  clients_params ::= clients_param
                | clients_params \(dq,\(dq clients_param
                | clients_params \(dq,\(dq

  clients_param ::= user
               | user_file
               | password
               | password_file
               | user_context
               | comment
               | unknown_map_entry

  user_file ::= \(dquser\-file\(dq \(dq:\(dq STRING

  password_file ::= \(dqpassword\-file\(dq \(dq:\(dq STRING

  dhcp_queue_control ::= \(dqdhcp\-queue\-control\(dq \(dq:\(dq \(dq{\(dq queue_control_params \(dq}\(dq

  queue_control_params ::= queue_control_param
                      | queue_control_params \(dq,\(dq queue_control_param
                      | queue_control_params \(dq,\(dq

  queue_control_param ::= enable_queue
                     | queue_type
                     | capacity
                     | user_context
                     | comment
                     | arbitrary_map_entry

  enable_queue ::= \(dqenable\-queue\(dq \(dq:\(dq BOOLEAN

  queue_type ::= \(dqqueue\-type\(dq \(dq:\(dq STRING

  capacity ::= \(dqcapacity\(dq \(dq:\(dq INTEGER

  arbitrary_map_entry ::= STRING \(dq:\(dq value

  dhcp_ddns ::= \(dqdhcp\-ddns\(dq \(dq:\(dq \(dq{\(dq dhcp_ddns_params \(dq}\(dq

  sub_dhcp_ddns ::= \(dq{\(dq dhcp_ddns_params \(dq}\(dq

  dhcp_ddns_params ::= dhcp_ddns_param
                  | dhcp_ddns_params \(dq,\(dq dhcp_ddns_param
                  | dhcp_ddns_params \(dq,\(dq

  dhcp_ddns_param ::= enable_updates
                 | server_ip
                 | server_port
                 | sender_ip
                 | sender_port
                 | max_queue_size
                 | ncr_protocol
                 | ncr_format
                 | user_context
                 | comment
                 | unknown_map_entry

  enable_updates ::= \(dqenable\-updates\(dq \(dq:\(dq BOOLEAN

  server_ip ::= \(dqserver\-ip\(dq \(dq:\(dq STRING

  server_port ::= \(dqserver\-port\(dq \(dq:\(dq INTEGER

  sender_ip ::= \(dqsender\-ip\(dq \(dq:\(dq STRING

  sender_port ::= \(dqsender\-port\(dq \(dq:\(dq INTEGER

  max_queue_size ::= \(dqmax\-queue\-size\(dq \(dq:\(dq INTEGER

  ncr_protocol ::= \(dqncr\-protocol\(dq \(dq:\(dq ncr_protocol_value

  ncr_protocol_value ::= \(dqUDP\(dq
                    | \(dqTCP\(dq

  ncr_format ::= \(dqncr\-format\(dq \(dq:\(dq \(dqJSON\(dq

  config_control ::= \(dqconfig\-control\(dq \(dq:\(dq \(dq{\(dq config_control_params \(dq}\(dq

  sub_config_control ::= \(dq{\(dq config_control_params \(dq}\(dq

  config_control_params ::= config_control_param
                       | config_control_params \(dq,\(dq config_control_param
                       | config_control_params \(dq,\(dq

  config_control_param ::= config_databases
                      | config_fetch_wait_time

  config_databases ::= \(dqconfig\-databases\(dq \(dq:\(dq \(dq[\(dq database_list \(dq]\(dq

  config_fetch_wait_time ::= \(dqconfig\-fetch\-wait\-time\(dq \(dq:\(dq INTEGER

  loggers ::= \(dqloggers\(dq \(dq:\(dq \(dq[\(dq loggers_entries \(dq]\(dq

  loggers_entries ::= logger_entry
                 | loggers_entries \(dq,\(dq logger_entry
                 | loggers_entries \(dq,\(dq

  logger_entry ::= \(dq{\(dq logger_params \(dq}\(dq

  logger_params ::= logger_param
               | logger_params \(dq,\(dq logger_param
               | logger_params \(dq,\(dq

  logger_param ::= name
              | output_options_list
              | debuglevel
              | severity
              | user_context
              | comment
              | unknown_map_entry

  debuglevel ::= \(dqdebuglevel\(dq \(dq:\(dq INTEGER

  severity ::= \(dqseverity\(dq \(dq:\(dq STRING

  output_options_list ::= \(dqoutput\-options\(dq \(dq:\(dq \(dq[\(dq output_options_list_content \(dq]\(dq

  output_options_list_content ::= output_entry
                             | output_options_list_content \(dq,\(dq output_entry
                             | output_options_list_content \(dq,\(dq

  output_entry ::= \(dq{\(dq output_params_list \(dq}\(dq

  output_params_list ::= output_params
                    | output_params_list \(dq,\(dq output_params
                    | output_params_list \(dq,\(dq

  output_params ::= output
               | flush
               | maxsize
               | maxver
               | pattern

  output ::= \(dqoutput\(dq \(dq:\(dq STRING

  flush ::= \(dqflush\(dq \(dq:\(dq BOOLEAN

  maxsize ::= \(dqmaxsize\(dq \(dq:\(dq INTEGER

  maxver ::= \(dqmaxver\(dq \(dq:\(dq INTEGER

  pattern ::= \(dqpattern\(dq \(dq:\(dq STRING

  compatibility ::= \(dqcompatibility\(dq \(dq:\(dq \(dq{\(dq compatibility_params \(dq}\(dq

  compatibility_params ::= compatibility_param
                      | compatibility_params \(dq,\(dq compatibility_param
                      | compatibility_params \(dq,\(dq

  compatibility_param ::= lenient_option_parsing
                     | unknown_map_entry

  lenient_option_parsing ::= \(dqlenient\-option\-parsing\(dq \(dq:\(dq BOOLEAN
.EE
.UNINDENT
.UNINDENT.SS گرامر BNF برای DHCP\-DDNS
.sp
این گرامر از \fBd2_parser.yy\fP تولید شده است. برای جزئیات بیشتر The DHCP\-DDNS Server \%<#\:dhcp-ddns-server> را ببینید.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
  Grammar

  $accept ::= start EOF

  start ::= TOPLEVEL_JSON sub_json

  start ::= TOPLEVEL_DHCPDDNS syntax_map

  start ::= SUB_DHCPDDNS sub_dhcpddns

  start ::= SUB_TSIG_KEY sub_tsig_key

  start ::= SUB_TSIG_KEYS sub_tsig_keys

  start ::= SUB_DDNS_DOMAIN sub_ddns_domain

  start ::= SUB_DDNS_DOMAINS sub_ddns_domains

  start ::= SUB_DNS_SERVER sub_dns_server

  start ::= SUB_DNS_SERVERS sub_dns_servers

  start ::= SUB_HOOKS_LIBRARY sub_hooks_library

  value ::= INTEGER
       | FLOAT
       | BOOLEAN
       | STRING
       | NULL
       | map2
       | list_generic

  sub_json ::= value

  map2 ::= \(dq{\(dq map_content \(dq}\(dq

  map_value ::= map2

  map_content ::=
             | not_empty_map

  not_empty_map ::= STRING \(dq:\(dq value
               | not_empty_map \(dq,\(dq STRING \(dq:\(dq value
               | not_empty_map \(dq,\(dq

  list_generic ::= \(dq[\(dq list_content \(dq]\(dq

  list_content ::=
              | not_empty_list

  not_empty_list ::= value
                | not_empty_list \(dq,\(dq value
                | not_empty_list \(dq,\(dq

  unknown_map_entry ::= STRING \(dq:\(dq

  syntax_map ::= \(dq{\(dq global_object \(dq}\(dq

  global_object ::= \(dqDhcpDdns\(dq \(dq:\(dq \(dq{\(dq dhcpddns_params \(dq}\(dq
               | global_object_comma

  global_object_comma ::= global_object \(dq,\(dq

  sub_dhcpddns ::= \(dq{\(dq dhcpddns_params \(dq}\(dq

  dhcpddns_params ::= dhcpddns_param
                 | dhcpddns_params \(dq,\(dq dhcpddns_param
                 | dhcpddns_params \(dq,\(dq

  dhcpddns_param ::= ip_address
                | port
                | dns_server_timeout
                | ncr_protocol
                | ncr_format
                | forward_ddns
                | reverse_ddns
                | tsig_keys
                | control_socket
                | control_sockets
                | hooks_libraries
                | loggers
                | user_context
                | comment
                | unknown_map_entry

  ip_address ::= \(dqip\-address\(dq \(dq:\(dq STRING

  port ::= \(dqport\(dq \(dq:\(dq INTEGER

  dns_server_timeout ::= \(dqdns\-server\-timeout\(dq \(dq:\(dq INTEGER

  ncr_protocol ::= \(dqncr\-protocol\(dq \(dq:\(dq ncr_protocol_value

  ncr_protocol_value ::= \(dqUDP\(dq
                    | \(dqTCP\(dq

  ncr_format ::= \(dqncr\-format\(dq \(dq:\(dq \(dqJSON\(dq

  user_context ::= \(dquser\-context\(dq \(dq:\(dq map_value

  comment ::= \(dqcomment\(dq \(dq:\(dq STRING

  forward_ddns ::= \(dqforward\-ddns\(dq \(dq:\(dq \(dq{\(dq ddns_mgr_params \(dq}\(dq

  reverse_ddns ::= \(dqreverse\-ddns\(dq \(dq:\(dq \(dq{\(dq ddns_mgr_params \(dq}\(dq

  ddns_mgr_params ::=
                 | not_empty_ddns_mgr_params

  not_empty_ddns_mgr_params ::= ddns_mgr_param
                           | ddns_mgr_params \(dq,\(dq ddns_mgr_param
                           | ddns_mgr_params \(dq,\(dq

  ddns_mgr_param ::= ddns_domains
                | unknown_map_entry

  ddns_domains ::= \(dqddns\-domains\(dq \(dq:\(dq \(dq[\(dq ddns_domain_list \(dq]\(dq

  sub_ddns_domains ::= \(dq[\(dq ddns_domain_list \(dq]\(dq

  ddns_domain_list ::=
                  | not_empty_ddns_domain_list

  not_empty_ddns_domain_list ::= ddns_domain
                            | not_empty_ddns_domain_list \(dq,\(dq ddns_domain
                            | not_empty_ddns_domain_list \(dq,\(dq

  ddns_domain ::= \(dq{\(dq ddns_domain_params \(dq}\(dq

  sub_ddns_domain ::= \(dq{\(dq ddns_domain_params \(dq}\(dq

  ddns_domain_params ::= ddns_domain_param
                    | ddns_domain_params \(dq,\(dq ddns_domain_param
                    | ddns_domain_params \(dq,\(dq

  ddns_domain_param ::= ddns_domain_name
                   | ddns_key_name
                   | dns_servers
                   | user_context
                   | comment
                   | unknown_map_entry

  ddns_domain_name ::= \(dqname\(dq \(dq:\(dq STRING

  ddns_key_name ::= \(dqkey\-name\(dq \(dq:\(dq STRING

  dns_servers ::= \(dqdns\-servers\(dq \(dq:\(dq \(dq[\(dq dns_server_list \(dq]\(dq

  sub_dns_servers ::= \(dq[\(dq dns_server_list \(dq]\(dq

  dns_server_list ::= dns_server
                 | dns_server_list \(dq,\(dq dns_server
                 | dns_server_list \(dq,\(dq

  dns_server ::= \(dq{\(dq dns_server_params \(dq}\(dq

  sub_dns_server ::= \(dq{\(dq dns_server_params \(dq}\(dq

  dns_server_params ::= dns_server_param
                   | dns_server_params \(dq,\(dq dns_server_param
                   | dns_server_params \(dq,\(dq

  dns_server_param ::= dns_server_hostname
                  | dns_server_ip_address
                  | dns_server_port
                  | ddns_key_name
                  | user_context
                  | comment
                  | unknown_map_entry

  dns_server_hostname ::= \(dqhostname\(dq \(dq:\(dq STRING

  dns_server_ip_address ::= \(dqip\-address\(dq \(dq:\(dq STRING

  dns_server_port ::= \(dqport\(dq \(dq:\(dq INTEGER

  tsig_keys ::= \(dqtsig\-keys\(dq \(dq:\(dq \(dq[\(dq tsig_keys_list \(dq]\(dq

  sub_tsig_keys ::= \(dq[\(dq tsig_keys_list \(dq]\(dq

  tsig_keys_list ::=
                | not_empty_tsig_keys_list

  not_empty_tsig_keys_list ::= tsig_key
                          | not_empty_tsig_keys_list \(dq,\(dq tsig_key
                          | not_empty_tsig_keys_list \(dq,\(dq

  tsig_key ::= \(dq{\(dq tsig_key_params \(dq}\(dq

  sub_tsig_key ::= \(dq{\(dq tsig_key_params \(dq}\(dq

  tsig_key_params ::= tsig_key_param
                 | tsig_key_params \(dq,\(dq tsig_key_param
                 | tsig_key_params \(dq,\(dq

  tsig_key_param ::= tsig_key_name
                | tsig_key_algorithm
                | tsig_key_digest_bits
                | tsig_key_secret
                | tsig_key_secret_file
                | user_context
                | comment
                | unknown_map_entry

  tsig_key_name ::= \(dqname\(dq \(dq:\(dq STRING

  tsig_key_algorithm ::= \(dqalgorithm\(dq \(dq:\(dq STRING

  tsig_key_digest_bits ::= \(dqdigest\-bits\(dq \(dq:\(dq INTEGER

  tsig_key_secret ::= \(dqsecret\(dq \(dq:\(dq STRING

  tsig_key_secret_file ::= \(dqsecret\-file\(dq \(dq:\(dq STRING

  control_socket ::= \(dqcontrol\-socket\(dq \(dq:\(dq \(dq{\(dq control_socket_params \(dq}\(dq

  control_sockets ::= \(dqcontrol\-sockets\(dq \(dq:\(dq \(dq[\(dq control_socket_list \(dq]\(dq

  control_socket_list ::=
                     | not_empty_control_socket_list

  not_empty_control_socket_list ::= control_socket_entry
                               | not_empty_control_socket_list \(dq,\(dq control_socket_entry
                               | not_empty_control_socket_list \(dq,\(dq

  control_socket_entry ::= \(dq{\(dq control_socket_params \(dq}\(dq

  control_socket_params ::= control_socket_param
                       | control_socket_params \(dq,\(dq control_socket_param
                       | control_socket_params \(dq,\(dq

  control_socket_param ::= control_socket_type
                      | control_socket_name
                      | control_socket_address
                      | control_socket_port
                      | authentication
                      | trust_anchor
                      | cert_file
                      | key_file
                      | cert_required
                      | user_context
                      | comment
                      | unknown_map_entry

  control_socket_type ::= \(dqsocket\-type\(dq \(dq:\(dq control_socket_type_value

  control_socket_type_value ::= \(dqunix\(dq
                           | \(dqhttp\(dq
                           | \(dqhttps\(dq

  control_socket_name ::= \(dqsocket\-name\(dq \(dq:\(dq STRING

  control_socket_address ::= \(dqsocket\-address\(dq \(dq:\(dq STRING

  control_socket_port ::= \(dqsocket\-port\(dq \(dq:\(dq INTEGER

  trust_anchor ::= \(dqtrust\-anchor\(dq \(dq:\(dq STRING

  cert_file ::= \(dqcert\-file\(dq \(dq:\(dq STRING

  key_file ::= \(dqkey\-file\(dq \(dq:\(dq STRING

  cert_required ::= \(dqcert\-required\(dq \(dq:\(dq BOOLEAN

  authentication ::= \(dqauthentication\(dq \(dq:\(dq \(dq{\(dq auth_params \(dq}\(dq

  auth_params ::= auth_param
             | auth_params \(dq,\(dq auth_param
             | auth_params \(dq,\(dq

  auth_param ::= auth_type
            | realm
            | directory
            | clients
            | comment
            | user_context
            | unknown_map_entry

  auth_type ::= \(dqtype\(dq \(dq:\(dq auth_type_value

  auth_type_value ::= \(dqbasic\(dq

  realm ::= \(dqrealm\(dq \(dq:\(dq STRING

  directory ::= \(dqdirectory\(dq \(dq:\(dq STRING

  clients ::= \(dqclients\(dq \(dq:\(dq \(dq[\(dq clients_list \(dq]\(dq

  clients_list ::=
              | not_empty_clients_list

  not_empty_clients_list ::= basic_auth
                        | not_empty_clients_list \(dq,\(dq basic_auth
                        | not_empty_clients_list \(dq,\(dq

  basic_auth ::= \(dq{\(dq clients_params \(dq}\(dq

  clients_params ::= clients_param
                | clients_params \(dq,\(dq clients_param
                | clients_params \(dq,\(dq

  clients_param ::= user
               | user_file
               | password
               | password_file
               | user_context
               | comment
               | unknown_map_entry

  user ::= \(dquser\(dq \(dq:\(dq STRING

  user_file ::= \(dquser\-file\(dq \(dq:\(dq STRING

  password ::= \(dqpassword\(dq \(dq:\(dq STRING

  password_file ::= \(dqpassword\-file\(dq \(dq:\(dq STRING

  hooks_libraries ::= \(dqhooks\-libraries\(dq \(dq:\(dq \(dq[\(dq hooks_libraries_list \(dq]\(dq

  hooks_libraries_list ::=
                      | not_empty_hooks_libraries_list

  not_empty_hooks_libraries_list ::= hooks_library
                                | not_empty_hooks_libraries_list \(dq,\(dq hooks_library
                                | not_empty_hooks_libraries_list \(dq,\(dq

  hooks_library ::= \(dq{\(dq hooks_params \(dq}\(dq

  sub_hooks_library ::= \(dq{\(dq hooks_params \(dq}\(dq

  hooks_params ::= hooks_param
              | hooks_params \(dq,\(dq hooks_param
              | hooks_params \(dq,\(dq
              | unknown_map_entry

  hooks_param ::= library
             | parameters

  library ::= \(dqlibrary\(dq \(dq:\(dq STRING

  parameters ::= \(dqparameters\(dq \(dq:\(dq map_value

  loggers ::= \(dqloggers\(dq \(dq:\(dq \(dq[\(dq loggers_entries \(dq]\(dq

  loggers_entries ::= logger_entry
                 | loggers_entries \(dq,\(dq logger_entry
                 | loggers_entries \(dq,\(dq

  logger_entry ::= \(dq{\(dq logger_params \(dq}\(dq

  logger_params ::= logger_param
               | logger_params \(dq,\(dq logger_param
               | logger_params \(dq,\(dq

  logger_param ::= name
              | output_options_list
              | debuglevel
              | severity
              | user_context
              | comment
              | unknown_map_entry

  name ::= \(dqname\(dq \(dq:\(dq STRING

  debuglevel ::= \(dqdebuglevel\(dq \(dq:\(dq INTEGER

  severity ::= \(dqseverity\(dq \(dq:\(dq STRING

  output_options_list ::= \(dqoutput\-options\(dq \(dq:\(dq \(dq[\(dq output_options_list_content \(dq]\(dq

  output_options_list_content ::= output_entry
                             | output_options_list_content \(dq,\(dq output_entry
                             | output_options_list_content \(dq,\(dq

  output_entry ::= \(dq{\(dq output_params_list \(dq}\(dq

  output_params_list ::= output_params
                    | output_params_list \(dq,\(dq output_params
                    | output_params_list \(dq,\(dq

  output_params ::= output
               | flush
               | maxsize
               | maxver
               | pattern

  output ::= \(dqoutput\(dq \(dq:\(dq STRING

  flush ::= \(dqflush\(dq \(dq:\(dq BOOLEAN

  maxsize ::= \(dqmaxsize\(dq \(dq:\(dq INTEGER

  maxver ::= \(dqmaxver\(dq \(dq:\(dq INTEGER

  pattern ::= \(dqpattern\(dq \(dq:\(dq STRING
.EE
.UNINDENT
.UNINDENT.SS گرامر BNF برای Kea NETCONF Agent
.sp
این گرامر از \fBnetconf_parser.yy\fP تولید شده است\&. برای جزئیات بیشتر به YANG/NETCONF \%<#\:netconf> مراجعه کنید.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
  Grammar

  $accept ::= start EOF

  start ::= START_JSON json

  start ::= START_NETCONF netconf_syntax_map

  start ::= START_SUB_NETCONF sub_netconf

  sub_netconf ::= \(dq{\(dq global_params \(dq}\(dq

  json ::= value

  value ::= INTEGER
       | FLOAT
       | BOOLEAN
       | STRING
       | NULL
       | map
       | list_generic

  map ::= \(dq{\(dq map_content \(dq}\(dq

  map_value ::= map

  map_content ::=
             | not_empty_map

  not_empty_map ::= STRING \(dq:\(dq value
               | not_empty_map \(dq,\(dq STRING \(dq:\(dq value
               | not_empty_map \(dq,\(dq

  list_generic ::= \(dq[\(dq list_content \(dq]\(dq

  list_content ::=
              | not_empty_list

  not_empty_list ::= value
                | not_empty_list \(dq,\(dq value
                | not_empty_list \(dq,\(dq

  unknown_map_entry ::= STRING \(dq:\(dq

  netconf_syntax_map ::= \(dq{\(dq global_object \(dq}\(dq

  global_object ::= \(dqNetconf\(dq \(dq:\(dq \(dq{\(dq global_params \(dq}\(dq
               | global_object_comma

  global_object_comma ::= global_object \(dq,\(dq

  global_params ::=
               | not_empty_global_params

  not_empty_global_params ::= global_param
                         | not_empty_global_params \(dq,\(dq global_param
                         | not_empty_global_params \(dq,\(dq

  global_param ::= boot_update
              | subscribe_changes
              | validate_changes
              | managed_servers
              | hooks_libraries
              | loggers
              | user_context
              | comment
              | unknown_map_entry

  boot_update ::= \(dqboot\-update\(dq \(dq:\(dq BOOLEAN

  subscribe_changes ::= \(dqsubscribe\-changes\(dq \(dq:\(dq BOOLEAN

  validate_changes ::= \(dqvalidate\-changes\(dq \(dq:\(dq BOOLEAN

  user_context ::= \(dquser\-context\(dq \(dq:\(dq map_value

  comment ::= \(dqcomment\(dq \(dq:\(dq STRING

  hooks_libraries ::= \(dqhooks\-libraries\(dq \(dq:\(dq \(dq[\(dq hooks_libraries_list \(dq]\(dq

  hooks_libraries_list ::=
                      | not_empty_hooks_libraries_list

  not_empty_hooks_libraries_list ::= hooks_library
                                | not_empty_hooks_libraries_list \(dq,\(dq hooks_library
                                | not_empty_hooks_libraries_list \(dq,\(dq

  hooks_library ::= \(dq{\(dq hooks_params \(dq}\(dq

  hooks_params ::= hooks_param
              | hooks_params \(dq,\(dq hooks_param
              | hooks_params \(dq,\(dq
              | unknown_map_entry

  hooks_param ::= library
             | parameters

  library ::= \(dqlibrary\(dq \(dq:\(dq STRING

  parameters ::= \(dqparameters\(dq \(dq:\(dq map_value

  managed_servers ::= \(dqmanaged\-servers\(dq \(dq:\(dq \(dq{\(dq servers_entries \(dq}\(dq

  servers_entries ::=
                 | not_empty_servers_entries

  not_empty_servers_entries ::= server_entry
                           | not_empty_servers_entries \(dq,\(dq server_entry
                           | not_empty_servers_entries \(dq,\(dq

  server_entry ::= dhcp4_server
              | dhcp6_server
              | d2_server
              | unknown_map_entry

  dhcp4_server ::= \(dqdhcp4\(dq \(dq:\(dq \(dq{\(dq managed_server_params \(dq}\(dq

  dhcp6_server ::= \(dqdhcp6\(dq \(dq:\(dq \(dq{\(dq managed_server_params \(dq}\(dq

  d2_server ::= \(dqd2\(dq \(dq:\(dq \(dq{\(dq managed_server_params \(dq}\(dq

  managed_server_params ::= managed_server_param
                       | managed_server_params \(dq,\(dq managed_server_param
                       | managed_server_params \(dq,\(dq

  managed_server_param ::= model
                      | boot_update
                      | subscribe_changes
                      | validate_changes
                      | control_socket
                      | user_context
                      | comment
                      | unknown_map_entry

  model ::= \(dqmodel\(dq \(dq:\(dq STRING

  control_socket ::= \(dqcontrol\-socket\(dq \(dq:\(dq \(dq{\(dq control_socket_params \(dq}\(dq

  control_socket_params ::= control_socket_param
                       | control_socket_params \(dq,\(dq control_socket_param
                       | control_socket_params \(dq,\(dq

  control_socket_param ::= socket_type
                      | socket_name
                      | socket_url
                      | user_context
                      | comment
                      | unknown_map_entry

  socket_type ::= \(dqsocket\-type\(dq \(dq:\(dq socket_type_value

  socket_type_value ::= \(dqunix\(dq
                   | \(dqhttp\(dq
                   | \(dqstdout\(dq

  socket_name ::= \(dqsocket\-name\(dq \(dq:\(dq STRING

  socket_url ::= \(dqsocket\-url\(dq \(dq:\(dq STRING

  loggers ::= \(dqloggers\(dq \(dq:\(dq \(dq[\(dq loggers_entries \(dq]\(dq

  loggers_entries ::= logger_entry
                 | loggers_entries \(dq,\(dq logger_entry
                 | loggers_entries \(dq,\(dq

  logger_entry ::= \(dq{\(dq logger_params \(dq}\(dq

  logger_params ::= logger_param
               | logger_params \(dq,\(dq logger_param
               | logger_params \(dq,\(dq

  logger_param ::= name
              | output_options_list
              | debuglevel
              | severity
              | user_context
              | comment
              | unknown_map_entry

  name ::= \(dqname\(dq \(dq:\(dq STRING

  debuglevel ::= \(dqdebuglevel\(dq \(dq:\(dq INTEGER

  severity ::= \(dqseverity\(dq \(dq:\(dq STRING

  output_options_list ::= \(dqoutput\-options\(dq \(dq:\(dq \(dq[\(dq output_options_list_content \(dq]\(dq

  output_options_list_content ::= output_entry
                             | output_options_list_content \(dq,\(dq output_entry
                             | output_options_list_content \(dq,\(dq

  output_entry ::= \(dq{\(dq output_params_list \(dq}\(dq

  output_params_list ::= output_params
                    | output_params_list \(dq,\(dq output_params
                    | output_params_list \(dq,\(dq

  output_params ::= output
               | flush
               | maxsize
               | maxver
               | pattern

  output ::= \(dqoutput\(dq \(dq:\(dq STRING

  flush ::= \(dqflush\(dq \(dq:\(dq BOOLEAN

  maxsize ::= \(dqmaxsize\(dq \(dq:\(dq INTEGER

  maxver ::= \(dqmaxver\(dq \(dq:\(dq INTEGER

  pattern ::= \(dqpattern\(dq \(dq:\(dq STRING
.EE
.UNINDENT
.UNINDENT.SH "قدردانی‌ها (ACKNOWLEDGMENTS)"
.sp
پروژه Kea یک پروژه متن‌باز است که توسط Internet Systems Consortium, Inc، یک سازمان غیرانتفاعی 501(c)3 طراحی، توسعه یافته و نگهداری می‌شود. بودجه ISC عمدتاً از طریق درآمدهای حاصل از اشتراک‌های پشتیبانی برای نرم‌افزارهای متن‌باز تأمین می‌شود و ما همه کاربران حرفه‌ای را تشویق می‌کنیم که این گزینه را در نظر بگیرند. برای اطلاعات بیشتر، \%<https://\:www\:.isc\:.org/\:support>\& را مشاهده کنید.
.sp
ما از تمامی سازمان‌ها و افرادی که در تحقق Kea یاری رسانده‌اند سپاسگزاری می‌کنیم. شرکت Comcast \%<https://\:www\:.comcast\:.com> و Comcast Innovation Fund پشتیبانی عمده‌ای را برای توسعه ماژول‌های DHCPv4، DHCPv6 و DDNS نرم‌افزار Kea فراهم کردند. همچنین Mozilla هزینه کارهای اولیه روی RESTful API را از طریق یک جایزه MOSS تأمین مالی نمود.
.sp
نرم‌افزار Kea در ابتدا به عنوان مجموعه‌ای از برنامه‌ها در چارچوب BIND 10 پیاده‌سازی شد. از حامیان مالی مؤسس پروژه BIND 10 سپاسگزاری می‌کنیم: Afilias \%<https://\:www\:.afilias\:.info>،
IIS.SE \%<https://\:www\:.iis\:.se>،
Nominet \%<https://\:www\:.nominet\:.uk>،
SIDN \%<https://\:www\:.sidn\:.nl>، JPRS \%<https://\:jprs\:.co\:.jp>
و CIRA \%<https://\:cira\:.ca>؛ و همچنین حامیان مالی دیگر:
AFNIC \%<https://\:www\:.afnic\:.fr>،
CNNIC \%<https://\:www\:.cnnic\:.net\:.cn>، CZ.NIC \%<https://\:www\:.nic\:.cz>،
DENIC eG \%<https://\:www\:.denic\:.de>،
Google \%<https://\:www\:.google\:.com>، RIPE
NCC \%<https://\:www\:.ripe\:.net>، Registro.br \%<https://\:registro\:.br>،
\&.nz Registry Services \%<https://\:nzrs\:.net\:.nz>، و Technical Center
of Internet \%<https://\:www\:.tcinet\:.ru>\&.
.SH "نویسندگان (AUTHORS)"
Internet Systems Consortium
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
2019-2026, Internet Systems Consortium
.\" End of generated man page.