.TH "kresctl" "8" "2026-06-17" "CZ.NIC" "Knot Resolver 6.4.0"
.\"
.\" kresctl.8 -- Knot Resolver control tool manpage
.\"
.\" Copyright (c) CZ.NIC. All rights reserved.
.\"
.\" SPDX-License-Identifier: GPL-3.0-or-later
.\"
.\"
.SH "نام (NAME)"
.B kresctl
\- ابزار کنترل Knot Resolver 6.4.0، تحلیل‌گر کامل DNS با حافظه پنهان و مجهز به DNSSEC
.SH "خلاصه دستور (SYNOPSIS)"
.B kresctl
.RB [ \-s | \-\-socket
.IR API_SOCKET ]
.IR <command>
.IR <args>
.SH "توضیحات (DESCRIPTION)"
دستور
.B \fIkresctl\fR
ابزاری کنترلی برای Knot Resolver است؛ یک تحلیل‌گر کامل DNS با حافظه پنهان و مجهز به DNSSEC.
.P

از
\fBkresctl\fR
می‌توان برای کنترل و بازرسی پیکربندی Knot Resolver در حال اجرا از طریق رابط برنامه‌نویسی کاربردی HTTP (HTTP API) آن استفاده کرد.

مستندات کامل در
\fIhttps://www.knot-resolver.cz/documentation/latest/\fR
یا در مستندات بسته (که در بیشتر توزیع‌ها به عنوان بسته knot-resolver-doc در دسترس است) موجود است.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های موجود عبارتند از:
.TP
.B \-s\fI <api_socket>\fR, \fB\-\-socket \fI<api_socket>

نحوه اتصال به یک Knot Resolver در حال اجرا را مشخص می‌کند. یک مسیر به سوکت دامنه یونیکس (Unix-domain socket) یا \fIhost:port\fR را می‌پذیرد. مقدار پیش‌فرض \fI/var/run/knot-resolver/kres-api.sock\fR است.

برخی از دستورها نیازی به برقراری ارتباط با تحلیل‌گر در حال اجرا ندارند. در چنین مواردی، مقدار این گزینه نادیده گرفته می‌شود و حتی اگر سوکت نامعتبر باشد نیز ممکن است دستور با موفقیت اجرا شود.
.TP
.B \-h, --help
چاپ پیام راهنما و خروج.
.SH "دستورها (COMMANDS)"
.TP
.B config [-d|--delete] [--stdin] \fIjson_ptr\fR \fI[new_value]\fR
دریافت یا تغییر پیکربندی زمان اجرای تحلیل‌گر (resolver).

آرگومان
\fIjson_ptr\fR
از استاندارد
\fBRFC 6901\fR
پیروی می‌کند و مشخص می‌نماید که این ابزار روی کدام بخش از پیکربندی عمل خواهد کرد. این آرگومان الزامی است. در صورتی که هیچ گزینه یا آرگومان اضافی ارائه نشود، مقدار پیکربندی‌شده فعلی را چاپ می‌کند. معادل متد GET در HTTP API زیرین است.

هنگامی که
\fB-d\fR
یا
\fB--delete\fR
ارائه شود،
\fBkresctl\fR
تلاش می‌کند زیردرخت پیکربندی زمان اجرا را حذف کند. در صورتی که این عملیات پیکربندی را نامعتبر سازد، با شکست مواجه می‌شود. معادل متد DELETE در HTTP API است.

هنگامی که
\fB--stdin\fR
یا
\fInew_value\fR
ارائه شوند، مقدار جدید (از طریق آرگومان یا با خواندن از ورودی استاندارد stdin) در مسیر مشخص‌شده توسط
\fIjson_ptr\fR
در پیکربندی قرار می‌گیرد. در صورتی که این عملیات پیکربندی را نامعتبر سازد، با شکست مواجه خواهد شد. معادل متد PUT در HTTP API زیرین است.
.TP
.B stop
تحلیل‌گر در حال اجرا را به آرامی و به صورت مناسب (gracefully) متوقف می‌کند.
.SH "همچنین ببینید (SEE ALSO)"
\fBkresd(8)\fR, \fIhttps://www.knot-resolver.cz/documentation/latest/\fR
.SH "نویسندگان (AUTHORS)"
توسعه‌دهندگان
.B kresd
در فایل AUTHORS در توزیع نرم‌افزار ذکر شده‌اند.