.\" rblcheck.1
.\" rblckeck manpage
.\"
.\" Copyright (C) 2005  Michael Tokarev <mjt@corpit.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 rblckeck 1 "Apr 2005" "User Utilities"

.SH "نام (NAME)"
rblckeck \- ابزار جستجو و بررسی در DNSBL

.SH "خلاصه دستور (SYNOPSIS)"
.B rblcheck
.RB [\| \-s
.IR zone \|]
.RB [\| \-S
.IR zone\-file \|]
.RB [\| \-c \|]
.RB [\| \-tmvq \|]
.RB [\| \-n
.IR nsaddr \|]
.IR address \|.\|.\|.

.SH "توضیحات (DESCRIPTION)"
دستور
.B rblcheck
یک ابزار خط فرمانی ساده برای جستجو و بررسی در DNSBL (لیست‌های مسدودسازی مبتنی بر DNS) است.
برای هر نشانی IP (یا یک نام، که در این صورت ابتدا به یک نشانی حل خواهد شد)، این ابزار بررسی می‌کند که آیا آن نشانی در (فهرستی از) فهرست‌های مسدودسازی DNS مشخص‌شده با گزینه‌های
.B \-s
یا
.B \-S
قرار دارد یا خیر؛ همچنین در صورت امکان، متن مرتبط با این فهرست‌بندی را دریافت می‌کند (معمولاً این متن یا توضیحاتی در مورد دلیل ثبت شدن است یا پیوندی به چنین توضیحی)، و در نهایت نتایج را در خروجی استاندارد نمایش می‌دهد.
.PP
این برنامه بر پایه کتابخانه
.BR udns (3)
پیاده‌سازی شده است.

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

گزینه‌های زیر توسط
.BR rblcheck
شناسایی می‌شوند:

.TP
.B \-s \fIzone\fR
افزودن نام \fIzone\fR داده‌شده به فهرست ناحیه‌های DNSBL فعال.
.TP
.B \-S \fIzone-file\fR
افزودن فهرست ناحیه‌ها از \fIzone-file\fR مشخص‌شده به فهرست ناحیه‌های فعال (این فایل در هر خط، یک ناحیه را به عنوان نخستین کلمه مشخص می‌کند؛ خطوط خالی و خطوطی که با نویسه «#» آغاز می‌شوند نادیده گرفته می‌شوند).
.TP
.B \-c
بازنشانی فهرست ناحیه‌های فعال.
.TP
.B \-v
حالت پُرگو؛ تولید خروجی کامل‌تر با جزئیات بیشتر.
.TP
.B \-q
نقطه مقابل \fB\-v\fR؛ تولید خروجی خلاصه‌تر با جزئیات کمتر.
.TP
.B \-t
دریافت متن برای نشانی‌های فهرست‌شده.
.TP
.B \-n \fInsaddr\fR
استفاده از کارساز نام (nameserver) مشخص‌شده (به شکل نشانی IPv4 یا IPv6) به جای مقدار پیش‌فرض. همین نتیجه را می‌توان با تنظیم متغیر محیطی $NSCACHEIP نیز به دست آورد.
.TP
.B \-m
توقف پس از اولین تطابق؛ یعنی پس از یافتن اولین نشانی‌ای که در فهرست قرار دارد.

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

.PP
اگر هیچ‌یک از گزینه‌های
.BR \-s ،
.BR \-S
و
.B \-c
مشخص نشوند،
.B rblcheck
تلاش می‌کند تا فهرست ناحیه‌ها را به ترتیب با استفاده از متغیر محیطی $RBLCHECK_ZONES، یا فایل ~/.rblcheckrc و یا فایل /etc/rblckechrc به دست آورد. اگر هیچ ناحیه‌ای پیدا نشود، برنامه ناموفق خارج خواهد شد.

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

.SH "محیط (ENVIRONMENT)"

.TP
.B $RBLCHECK_ZONES
در صورتی که هیچ‌یک از گزینه‌های
.BR \-s ،
.B \-S
یا
.B \-c
داده نشده باشند،
.B rblcheck
این متغیر را بررسی می‌کند تا فهرست ناحیه‌های DNSBL را برای بررسی استخراج کند.

.SH "فایل‌ها (FILES)"

.TP
$HOME/.rblcheckrc و /etc/rblcheckrc
اگر هیچ‌یک از گزینه‌های
.BR \-s ،
.B \-S
یا
.B \-c
داده نشده باشند و متغیر محیطی $RBLCHECK_ZONES نیز تنظیم نشده باشد،
.B rblcheck
این دو فایل را (اولین فایلی که وجود داشته باشد) بررسی می‌کند تا فهرست ناحیه‌های DNSBL را برای ارزیابی دریافت کند.
هر خط یک ناحیه را مشخص می‌کند (تنها اولین کلمه در هر خط استفاده می‌شود).
خطوط خالی و خطوطی که با نویسه «#» آغاز می‌شوند نادیده گرفته می‌شوند.

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

.SH "نویسندگان (AUTHORS)"
این برنامه و صفحات راهنمای آن توسط Michael Tokarev نوشته شده‌اند.