.\" 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 "NSLOOKUP" "1" "2026-08-19" "9.20.27" "BIND 9"
.SH NAME
nslookup \- استعلام و پرسوجو از کارسازهای نام به صورت تعاملی
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBnslookup\fP [\-option] [name | \-] [server]
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBnslookup\fP برنامه‌ای برای پرسوجو از کارسازهای نام دامنه اینترنت است.
\fBnslookup\fP دارای دو حالت است: تعاملی و غیرتعاملی. حالت تعاملی
به کاربر امکان می‌دهد تا از کارسازهای نام درباره اطلاعات میزبان‌ها و
دامنه‌های گوناگون پرسوجو کند یا فهرستی از میزبان‌های یک دامنه را چاپ نماید.
حالت غیرتعاملی تنها نام و اطلاعات درخواستی را برای یک میزبان یا
دامنه چاپ می‌کند.
.SH "آرگومان‌ها (ARGUMENTS)"
.sp
ورود به حالت تعاملی در موارد زیر صورت می‌گیرد:
.INDENT 0.0
.IP a. 3
هنگامی که هیچ آرگومانی داده نشود (از کارساز نام پیش‌فرض استفاده می‌شود)؛
.IP b. 3
هنگامی که آرگومان نخست یک خط تیره (\-) باشد و آرگومان دوم نام میزبان
یا نشانی اینترنتی یک کارساز نام باشد.
.UNINDENT
.sp
حالت غیرتعاملی زمانی استفاده می‌شود که نام یا نشانی اینترنتی میزبان مورد نظر
برای جستجو به عنوان آرگومان نخست داده شود. آرگومان اختیاری دوم،
نام میزبان یا نشانی یک کارساز نام را مشخص می‌کند.
.sp
گزینه‌ها را می‌توان در خط فرمان نیز مشخص کرد، به شرطی که پیش از آرگومان‌ها
قرار گیرند و با یک خط تیره شروع شوند. برای نمونه، جهت تغییر نوع
پرسوجوی پیش‌فرض به اطلاعات میزبان، با مهلت زمانی اولیه ۱۰ ثانیه، بنویسید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
nslookup \-query=hinfo  \-timeout=10
.EE
.UNINDENT
.UNINDENT
.sp
گزینه \fB\-version\fP باعث می‌شود \fBnslookup\fP شماره نسخه را چاپ کرده
و بلافاصله خارج شود.
.SH "دستورات تعاملی (INTERACTIVE COMMANDS)"
.INDENT 0.0
.TP
.B \fBhost [server]\fP
این دستور اطلاعات مربوط به \fBhost\fP \%<#\:std-iscman-host> را با استفاده از کارساز پیش‌فرض فعلی
یا با استفاده از \fBserver\fP (در صورت مشخص شدن) جستجو می‌کند. اگر \fBhost\fP \%<#\:std-iscman-host>
یک نشانی اینترنتی باشد و نوع پرسوجو A یا PTR باشد، نام میزبان بازگردانده می‌شود. اگر \fBhost\fP \%<#\:std-iscman-host>
یک نام باشد و نقطه پایانی (\fB\&.\fP) نداشته باشد، از فهرست جستجو برای واجد شرایط کردن نام استفاده می‌شود.
.sp
برای جستجوی میزبانی که در دامنه فعلی نیست، یک نقطه به انتهای نام اضافه کنید.
.TP
.B \fBserver domain\fP | \fBlserver domain\fP
این دستورات کارساز پیش‌فرض را به \fBdomain\fP تغییر می‌دهند؛ \fBlserver\fP از کارساز اولیه
برای جستجوی اطلاعات درباره \fBdomain\fP استفاده می‌کند، در حالی که \fBserver\fP از کارساز
پیش‌فرض فعلی بهره می‌برد. اگر پاسخی معتبر (authoritative answer) یافت نشود،
نام کارسازهایی که ممکن است پاسخ را داشته باشند برگردانده می‌شود.
.TP
.B \fBroot\fP
این دستور پیاده‌سازی نشده است.
.TP
.B \fBfinger\fP
این دستور پیاده‌سازی نشده است.
.TP
.B \fBls\fP
این دستور پیاده‌سازی نشده است.
.TP
.B \fBview\fP
این دستور پیاده‌سازی نشده است.
.TP
.B \fBhelp\fP
این دستور پیاده‌سازی نشده است.
.TP
.B \fB?\fP
این دستور پیاده‌سازی نشده است.
.TP
.B \fBexit\fP
این دستور از برنامه خارج می‌شود.
.TP
.B \fBset keyword[=value]\fP
این دستور برای تغییر اطلاعات وضعیتی که بر جستجوها اثر می‌گذارند به کار می‌رود.
کلیدواژه‌های معتبر عبارتند از:
.INDENT 7.0
.TP
.B \fBall\fP
این کلیدواژه مقادیر فعلی گزینه‌های پرکاربرد برای \fBset\fP را چاپ می‌کند.
اطلاعات مربوط به کارساز و میزبان پیش‌فرض فعلی نیز چاپ می‌شود.
.TP
.B \fBclass=value\fP
این کلیدواژه کلاس پرسوجو را به یکی از موارد زیر تغییر می‌دهد:
.INDENT 7.0
.TP
.B \fBIN\fP
کلاس اینترنت (Internet class)
.TP
.B \fBCH\fP
کلاس آشوب (Chaos class)
.TP
.B \fBHS\fP
کلاس هسیود (Hesiod class)
.TP
.B \fBANY\fP
عام (wildcard)
.UNINDENT
.sp
کلاس، گروه پروتکل اطلاعات را مشخص می‌کند. مقدار پیش‌فرض \fBIN\fP است؛
کوته‌نوشت این کلیدواژه \fBcl\fP است.
.TP
.B \fBnodebug\fP
این کلیدواژه نمایش بسته پاسخ کامل و هرگونه بسته پاسخ میانی را در حین جستجو روشن یا خاموش می‌کند.
پیش‌فرض این کلیدواژه \fBnodebug\fP است؛ کوته‌نوشت این کلیدواژه \fB[no]deb\fP است.
.TP
.B \fBnod2\fP
این کلیدواژه حالت اشکال‌زدایی را روشن یا خاموش می‌کند. این حالت اطلاعات بیشتری درباره
عملکرد nslookup نمایش می‌دهد. مقدار پیش‌فرض \fBnod2\fP است.
.TP
.B \fBdomain=name\fP
این کلیدواژه فهرست جستجو را به \fBname\fP تنظیم می‌کند.
.TP
.B \fBnosearch\fP
اگر درخواست جستجو دارای دست‌کم یک نقطه باشد، اما به یک نقطه پایانی ختم نشود،
این کلیدواژه نام‌های دامنه موجود در فهرست جستجوی دامنه را تا زمان دریافت پاسخ
به درخواست می‌افزاید. مقدار پیش‌فرض \fBsearch\fP است.
.TP
.B \fBport=value\fP
این کلیدواژه درگاه پیش‌فرض کارساز نام TCP/UDP را از درگاه پیش‌فرض ۵۳
به \fBvalue\fP تغییر می‌دهد. کوته‌نوشت این کلیدواژه \fBpo\fP است.
.TP
.B \fBquerytype=value\fP | \fBtype=value\fP
این کلیدواژه نوع پرسوجوی اطلاعات را به \fBvalue\fP تغییر می‌دهد.
مقادیر پیش‌فرض ابتدا A و سپس AAAA هستند؛ کوته‌نوشت‌های این کلیدواژه‌ها
\fBq\fP و \fBty\fP هستند.
.sp
لطفاً توجه داشته باشید که تنها تعیین یک نوع پرسوجو ممکن است.
فقط در رفتار پیش‌فرض و زمانی که گزینه جایگزینی مشخص نشده باشد، هر دو مورد جستجو می‌شوند.
.TP
.B \fBnorecurse\fP
این کلیدواژه به کارساز نام می‌گوید که در صورت نداشتن اطلاعات، از کارسازهای دیگر پرسوجو کند.
پیش‌فرض \fBrecurse\fP است؛ کوته‌نوشت این کلیدواژه \fB[no]rec\fP است.
.TP
.B \fBndots=number\fP
این کلیدواژه تعداد نقطه‌ها (جداکننده‌های برچسب) را در یک دامنه تنظیم می‌کند که
جستجو را غیرفعال می‌سازد. نام‌های مطلق همواره جستجو را متوقف می‌کنند.
.TP
.B \fBretry=number\fP
این کلیدواژه تعداد تلاش‌های مجدد را به \fBnumber\fP تنظیم می‌کند.
.TP
.B \fBtimeout=number\fP
این کلیدواژه بازه مهلت زمانی اولیه برای انتظار دریافت پاسخ را به \fBnumber\fP (بر حسب ثانیه) تغییر می‌دهد.
.TP
.B \fBnovc\fP
این کلیدواژه مشخص می‌کند که آیا هنگام ارسال درخواست‌ها به کارساز، همواره باید از یک مدار مجازی (virtual circuit) استفاده شود.
مقدار پیش‌فرض \fBnovc\fP است.
.TP
.B \fBnofail\fP
این کلیدواژه در صورتی که یک کارساز نام با SERVFAIL یا یک ارجاع (referral) پاسخ دهد،
کارساز نام بعدی را امتحان می‌کند (nofail)، یا در صورت دریافت چنین پاسخی به پرسوجو پایان می‌دهد (fail).
مقدار پیش‌فرض \fBnofail\fP است.
.UNINDENT
.UNINDENT
.SH "مقادیر بازگشتی (RETURN VALUES)"
.sp
دستور \fBnslookup\fP در صورت شکست هرگونه پرسوجو با وضعیت خروج ۱، و در غیر این صورت با ۰ خارج می‌شود.
.SH "پشتیبانی از IDN (IDN SUPPORT)"
.sp
اگر \fBnslookup\fP با پشتیبانی از IDN (نام دامنه بین‌المللی‌شده) کامپایل شده باشد،
می‌تواند نام‌های دامنه غیر ASCII را بپذیرد و نمایش دهد. \fBnslookup\fP پیش از ارسال
درخواست به یک کارساز DNS یا نمایش پاسخ از کارساز، کدگذاری نویسه‌های یک نام دامنه را
به‌طور مناسب تبدیل می‌کند. برای غیرفعال کردن پشتیبانی از IDN، متغیر محیطی
\fBIDN_DISABLE\fP را تعریف کنید. در صورتی که این متغیر هنگام اجرای \fBnslookup\fP
تنظیم شده باشد، یا زمانی که خروجی استاندارد یک tty نباشد، پشتیبانی از IDN غیرفعال می‌شود.
.SH "فایلها (FILES)"
.sp
\fB/etc/resolv.conf\fP
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBdig(1)\fP \%<#\:std-iscman-dig>, \fBhost(1)\fP \%<#\:std-iscman-host>, \fBnamed(8)\fP \%<#\:std-iscman-named>\&.
.SH "نویسنده (AUTHOR)"
Internet Systems Consortium
.SH "حق نشر (COPYRIGHT)"
2026, Internet Systems Consortium
.\" End of generated man page.