.\" 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 "KHOST" "1" "2026-06-12" "3.5.5" "Knot DNS"
.SH "نام (NAME)"
khost \- ابزار ساده برای جستجوی DNS
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBkhost\fP [\fIoptions\fP] \fIname\fP [\fIserver\fP]
.SH "توضیحات (DESCRIPTION)"
.sp
این ابزار یک پرس‌وجوی DNS برای \fIname\fP به \fIserver\fP ارسال می‌کند و پاسخ را در قالبی با خوانایی بهتر برای کاربر نمایش می‌دهد. برای پرس‌وجوهای پیشرفته‌تر DNS به‌جای آن از kdig \%<> استفاده کنید.
.SS "پارامترها (PARAMETERS)"
.INDENT 0.0
.TP
.B \fIname\fP
نام دامنه‌ای است که باید جستجو شود. اگر \fIname\fP یک نشانی IPv4 یا IPv6 باشد، از نوع پرس‌وجوی PTR استفاده می‌شود.
.TP
.B \fIserver\fP
نام یا نشانی کارساز نام برای ارسال پرس‌وجو به آن است. نشانی را می‌توان با ساختار [address]:port مشخص کرد. اگر کارسازی مشخص نشود، از کارسازهای موجود در \fB/etc/resolv.conf\fP استفاده می‌شود.
.UNINDENT
.sp
اگر هیچ آرگومانی ارائه نشود، \fBkhost\fP یک راهنمای کوتاه چاپ می‌کند.
.SS "گزینه‌ها (OPTIONS)"
.INDENT 0.0
.TP
\fB\-4\fP
تنها استفاده از پروتکل IPv4.
.TP
\fB\-6\fP
تنها استفاده از پروتکل IPv6.
.TP
\fB\-a\fP
ارسال پرس‌وجوی ANY در حالت پرگو (verbose).
.TP
\fB\-d\fP
فعال‌سازی پیام‌های اشکال‌زدایی.
.TP
\fB\-h\fP, \fB\-\-help\fP
چاپ راهنمای برنامه.
.TP
\fB\-r\fP
غیرفعال‌سازی بازگشت (recursion).
.TP
\fB\-T\fP
استفاده از پروتکل TCP.
.TP
\fB\-v\fP
فعال‌سازی خروجی پرگو (verbose).
.TP
\fB\-V\fP, \fB\-\-version\fP
چاپ نسخه برنامه. گزینه \fB\-VV\fP باعث می‌شود برنامه خلاصه‌ای از پیکربندی زمان ساخت را چاپ کند.
.TP
\fB\-w\fP
انتظار نامحدود برای دریافت پاسخ.
.TP
\fB\-c\fP \fIclass\fP
تنظیم کلاس پرس‌وجو (مانند CH، CLASS4). کلاس پیش‌فرض IN است.
.TP
\fB\-t\fP \fItype\fP
تنظیم نوع پرس‌وجو (مانند NS، IXFR=12345، TYPE65535). پیش‌فرض، ارسال ۳ پرس‌وجو (A، AAAA و MX) است.
.TP
\fB\-R\fP \fIretries\fP
تعداد تلاش‌های مجدد UDP (>=0) برای پرس‌وجو از یک کارساز نام. مقدار پیش‌فرض ۱ است.
.TP
\fB\-W\fP \fIwait\fP
زمان انتظار برای پاسخ برحسب ثانیه. این مهلت زمانی برای هر تلاش پرس‌وجو اعمال می‌شود. مقدار پیش‌فرض ۲ ثانیه است.
.UNINDENT
.SH "وضعیت خروج (EXIT STATUS)"
.sp
وضعیت خروج ۰ به معنای اجرای موفقیت‌آمیز است. هر وضعیت خروج دیگری نشان‌دهنده یک خطا است.
.SH "مثال‌ها (EXAMPLES)"
.INDENT 0.0
.IP 1. 3
دریافت رکوردهای A، AAAA و MX برای example.com:
.INDENT 3.0
.INDENT 3.5
.sp
.EX
$ khost example.com
.EE
.UNINDENT
.UNINDENT
.IP 2. 3
دریافت رکورد معکوس برای نشانی 192.0.2.1:
.INDENT 3.0
.INDENT 3.5
.sp
.EX
$ khost 192.0.2.1
.EE
.UNINDENT
.UNINDENT
.IP 3. 3
انجام انتقال منطقه (zone transfer) در حالت پرگو برای منطقه example.com:
.INDENT 3.0
.INDENT 3.5
.sp
.EX
$ khost \-t AXFR \-v example.com
.EE
.UNINDENT
.UNINDENT
.UNINDENT
.SH "فایل‌ها (FILES)"
.sp
\fB/etc/resolv.conf\fP
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBkdig(1)\fP, \fBknsupdate(1)\fP\&.
.SH "نویسندگان (AUTHORS)"
CZ.NIC, z.s.p.o. و مشارکت‌کنندگان <https://www.knot-dns.cz>
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
Copyright (C) CZ.NIC, z.s.p.o. and contributors
.\" End of generated man page.