.\" dnsget.1: dnsget manpage
.\"
.\" Copyright (C) 2005-2014  Michael Tokarev <mjt+udns@tls.msk.ru>
.\" This file is part of UDNS library, an async DNS stub resolver.
.\"
.\" This library is free software; you can redistribute it and/or
.\" modify it under the terms of the GNU Lesser General Public
.\" License as published by the Free Software Foundation; either
.\" version 2.1 of the License, or (at your option) any later version.
.\"
.\" This library is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
.\" Lesser General Public License for more details.
.\"
.\" You should have received a copy of the GNU Lesser General Public
.\" License along with this library, in file named COPYING.LGPL; if not,
.\" write to the Free Software Foundation, Inc., 59 Temple Place,
.\" Suite 330, Boston, MA  02111-1307  USA

.TH dnsget 1 "Jan 2014" "User Utilities"

.SH "نام (NAME)"
dnsget \- ابزار جستجوی DNS

.SH "خلاصه دستور (SYNOPSIS)"
.B dnsget
.RB [\| \-v \||\| \-q \|]
.RB [\| \-c
.IR class \|]
.RB [\| \-t
.IR type \|]
.RB [\| \-o
.IR opt , opt ,...]
.IR name \|.\|.\|.

.SH "توضیحات (DESCRIPTION)"
دستور
.B dnsget
یک ابزار خط‌فرمانی ساده برای انجام جستجوهای DNS است که عملکردی شبیه به
.BR host (1)
و
.BR dig (1)
دارد. این ابزار هم در سناریوهای تعاملی و اشکال‌زدایی و هم در اسکریپت‌ها قابل استفاده است. این برنامه با استفاده از کتابخانهٔ
.BR udns (3)
پیاده‌سازی شده است.

.PP
به‌طور پیش‌فرض،
.B dnsget
خروجی قابل‌فهم برای انسان تولید می‌کند، شبیه به:
.RS
.nf
alias.example.com. CNAME www.example.com.
www.example.com. A 192.168.1.1
www.example.com. MX 10 mx.example.com.
.fi
.RE
که برای مشاهدهٔ نحوهٔ تحلیل یک نام مشخص کافی است. قالب خروجی با گزینه‌های
.B \-v
و
.B \-q
قابل کنترل است \-\- گزینهٔ اول سطح پرگویی (verbosity) را تا چاپ کامل محتوای تمامی بسته‌های DNS ارسالی و دریافتی افزایش می‌دهد که برای اشکال‌زدایی مشکلات DNS مناسب است، در حالی که گزینهٔ دوم سطح خروجی را کاهش داده و آن را ساکت‌تر می‌کند، تا حدی که تنها نتیجهٔ خام بدون هیچ پیام خطایی نمایش داده می‌شود که برای استفاده در اسکریپت‌ها ایده‌آل است.

.SH "گزینه‌ها (OPTIONS)"

گزینه‌های زیر توسط
.B dnsget
پشتیبانی می‌شوند:

.TP
.B \-v
تولید خروجی با جزئیات بیشتر. استفادهٔ بیشتر از
.B \-v
به معنی نمایش جزئیات بیشتر خواهد بود. با یک
.BR \-v
تنها،
.B dnsget
محتوای تمام بسته‌های DNS دریافتی را (در قالبی خوانا) چاپ می‌کند، در حالی که با
.BR \-vv ،
تمام بسته‌های DNS ارسالی نیز در خروجی نمایش داده می‌شوند.

.TP
.B \-q
نقطهٔ مقابل \fB\-v\fR \-\- تولید خروجی با جزئیات کمتر. با یک
.BR \-q
تنها،
.B dnsget
تنها داده‌های (رمزگشایی‌شدهٔ) رکوردهای منبع (RR) نهایی DNS را نشان می‌دهد، در حالی که
.B \-qq
پیام‌های خطا را نیز فرونشانی (پنهان) می‌کند.

.TP
\fB\-t \fItype\fR
درخواست رکورد(های) با نوع داده‌شدهٔ \fItype\fR. به‌طور پیش‌فرض،
.B dnsget
رکورد نشانی IPv4 (رکورد A) را درخواست می‌کند، یا در صورتی که آرگومان مورد نظر یک نشانی IPv4 یا IPv6 باشد، رکورد PTR را درخواست خواهد کرد. انواع شناخته‌شده شامل A، AAAA، MX، TXT، CNAME، PTR، NS، SOA، ANY و موارد دیگر است.

.TP
\fB\-c \fIclass\fR
درخواست رکورد(های) DNS با کلاس داده‌شدهٔ \fIclass\fR. به‌طور پیش‌فرض
.B dnsget
از کلاس IN استفاده می‌کند. کلاس‌های معتبر شامل IN، CH، HS و ANY هستند.

.TP
.B \-a
(گزینهٔ سازگاری). معادل تنظیم نوع پرس‌وجو به
.B ANY
و افزایش سطح پرگویی خروجی
.RB ( \-v ).

.TP
.B \-C
(برنامه‌ریزی‌شده)

.TP
.B \-x
(برنامه‌ریزی‌شده)

.TP
\fB\-o \fIopt\fR,\fIopt\fR,...
(می‌تواند چندین بار مشخص شود).
تنظیم گزینه‌های تحلیل‌گر (به شکل \fIoption\fR:\fIvalue\fR) به همان گونه‌ای که در متغیر محیطی
.RB $ RES_OPTIONS
تنظیم می‌شوند، یا تنظیم پرچم‌های پرس‌وجو:
.RS
.TP
\fBtimeout\fR:\fIsec\fR
تنظیم مهلت زمانی اولیهٔ پرس‌وجو به \fIsec\fR ثانیه.
.TP
\fBattempts\fR:\fInum\fR
تلاش (مجدد) برای هر پرس‌وجو به تعداد \fInum\fR بار پیش از اعلام شکست.
.TP
\fBudpbuf\fR:\fIbytes\fR
تنظیم اندازهٔ بافر UDP در DNS به میزان \fIbytes\fR بایت. مقادیر معتبر از 512 تا 65535 هستند. اگر \fIbytes\fR بزرگتر از 512 باشد، افزونه‌های EDNS0 (RFC 2671) استفاده خواهند شد.
.TP
\fBport\fR:\fInum\fR
استفاده از شماره درگاه UDP مشخص‌شدهٔ \fInum\fR به جای درگاه پیش‌فرض 53 (domain).
.TP
\fBaa\fR
تنظیم بیت پرس‌وجوی AA (تنها معتبر / auth only).
.TP
\fBnord\fR
عدم تنظیم بیت پرس‌وجوی RD (درخواست بازگشتی / recursion desired) (به‌طور پیش‌فرض تنظیم است).
.TP
\fBdnssec\fR یا \fBdo\fR
تنظیم پرچم پرس‌وجوی DNSSEC OK (DO) (دستور \fBdnsget\fR امضاهای DNSSEC را اعتبارسنجی نمی‌کند، بلکه تنها آن‌ها را نمایش می‌دهد؛ این مورد در EDNS RR تنظیم می‌شود).
.TP
\fBcd\fR
تنظیم بیت پرس‌وجوی CD (بررسی غیرفعال / checking disabled).
.RE

.TP
\fB\-n \fInameserver\fR
استفاده از nameserver(های) داده‌شده (می‌تواند بیش از یک بار مشخص شود) به جای مقدار پیش‌فرض. استفاده از این گزینه همان تأثیر متغیرهای محیطی
.RB $ NSCACHEIP
یا
.RB $ NAMESERVERS
را دارد، با این تفاوت که در حال حاضر تنها نشانی‌های IPv4 شناسایی می‌شوند و امکان مشخص کردن نام‌ها (که با تنظیمات پیش‌فرض تحلیل خواهند شد) به جای نشانی‌های IP وجود دارد.

.TP
.B \-h
نمایش راهنمای کوتاه و خروج.

.SH "وضعیت خروج (EXIT STATUS)"
هنگامی که همهٔ نام‌ها با موفقیت تحلیل شوند،
.B dnsget
با وضعیت خروج صفر خارج می‌شود. اگر حداقل یک نام یافت نشود،
.B dnsget
با کد بازگشتی 100 خارج خواهد شد. در صورت بروز هر خطای دیگری در حین تحلیل نام، با کد 99 خارج می‌شود. در صورت بروز خطای نحوهٔ استفاده یا مقداردهی اولیه،
.B dnsget
کد 1 را برمی‌گرداند.

.SH "همچنین ببینید (SEE ALSO)"
.BR host (1),
.BR dig (1),
.BR resolv.conf (5),
.BR udns (3).