.\" *************************************************************************
.\" *  Copyright © 2004-2006 Rémi Denis-Courmont.                           *
.\" *  This program is free software: you can redistribute and/or modify    *
.\" *  it under the terms of the GNU General Public License as published by *
.\" *  the Free Software Foundation, versions 2 or 3 of the license.        *
.\" *                                                                       *
.\" *  This program 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 General Public License for more details.                         *
.\" *                                                                       *
.\" *  You should have received a copy of the GNU General Public License    *
.\" *  along with this program. If not, see <http://www.gnu.org/licenses/>. *
.\" *************************************************************************
.TH "RDISC6" "8" "$Date$" "rdisc6" "راهنمای مدیر سیستم"
.SH "نام (NAME)"
rdisc6 \- ابزار کشف مسیریاب در ICMPv6
.SH "خلاصه دستور (SYNOPSIS)"
.BR "rdisc6" " [" "-qv" "] [" "-r attempts" "] [" "-s source_ip" "]"
.BR "" "[" "-w wait_ms" "] [" "IPv6 address" "] <" "iface" ">"

.SH "توضیحات (DESCRIPTION)"
.B rdisc6
یک برنامه یونیکس است که فرآیند کشف مسیریاب در ICMPv6 را در فضای کاربری (userland) پیاده‌سازی می‌کند (این کار به‌طور معمول توسط کرنل انجام می‌شود). از این ابزار برای جستجو و دریافت فهرست مسیریاب‌های موجود روی پیوند (on-link) و پیشوندهای IPv6 استفاده می‌شود.
.PP
این ابزار همچنین می‌تواند برای وادار کردن کرنل به به‌روزرسانی وضعیت یک رابط شبکه با پیکربندی خودکار IPv6 (autoconfigured) استفاده شود.
.PP
نام رابط شبکه‌ای که باید برای یافتن مسیریاب‌ها کاوش شود، باید مشخص گردد.

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

.TP
.BR "\-1" " یا " "\-\-single"
خروج به محض دریافت نخستین پیام اعلان (advertisement).

.TP
.BR "\-h" " یا " "\-\-help"
نمایش راهنما و خروج.

.TP
.BR "\-m" " یا " "\-\-multiple"
انتظار برای دریافت چندین اعلان احتمالی و چاپ تمام آن‌ها (پیش‌فرض).

.TP
.BR "\-n" " یا " "\-\-numeric"
در صورتی که پارامتر اختیاری یک نشانی معتبر IPv6 نباشد، تلاشی برای وضوح‌یابی آن به عنوان نام میزبان DNS انجام نده.

.TP
.BR "\-q" " یا " "\-\-quiet"
تنها نمایش پیشوندهای اعلام‌شده IPv6. در صورت بروز خطا هیچ خروجی نمایش داده نمی‌شود. این گزینه بیشتر هنگام فراخوانی برنامه از داخل یک اسکریپت شل مفید است.

.TP
.BR "\-r attempts" " یا " "\-\-retry attempts"
ارسال درخواست‌های کشف مسیریاب ICMPv6 به تعداد مشخص‌شده تا زمان دریافت پاسخ یا لغو عملیات. به‌طور پیش‌فرض، rdisc6 پیش از لغو عملیات، ۳ بار تلاش می‌کند (MAX_RTR_SOLICITATIONS از RFC2461).

.TP
.BR "\-s source_ip" " یا " "\-\-source source_ip"
مشخص کردن نشانی IPv6 که به عنوان نشانی مبدا برای بسته‌های درخواست مسیریاب (router solicitation) استفاده می‌شود.

.TP
.BR "\-V" " یا " "\-\-version"
نمایش نسخه و مجوز برنامه و خروج.

.TP
.BR "\-v" " یا " "\-\-verbose"
نمایش اطلاعات با جزئیات کامل (verbose). این حالت پیش‌فرض است.

.TP
.BR "\-w wait_ms" " یا " "\-\-wait wait_ms"
.RI "مدت زمان " "wait_ms" " میلی‌ثانیه برای دریافت پاسخ پیش از تلاش مجدد صبر کن."
به‌طور پیش‌فرض، rdisc6 بین هر تلاش ۴ ثانیه منتظر می‌ماند (RTR_SOLICITATION_INTERVAL از RFC2461).

.PP
.RB "اگر " "rdisc6" " پس از تعداد دفعات تلاش مشخص‌شده و با هر بار "
.RI "انتظار به مدت " "wait_ms" " میلی‌ثانیه پاسخی دریافت نکند، با کد خروج ۲ خاتمه می‌یابد. در صورت بروز خطا، با کد ۱ خارج می‌شود."
در غیر این صورت با کد ۰ خارج خواهد شد.

.SH "امنیت (SECURITY)"
برنامه
.B rdisc6
باید دارای مجوز
.B setuid root
باشد تا کاربران غیرمدیر (غیرممتاز) نیز بتوانند از آن استفاده کنند. این برنامه پیش از هرگونه اقدام برای ارسال یا دریافت داده از شبکه، مجوزهای کاربری ریشه (root) خود را رها می‌کند تا اثرات احتمالی ناشی از آسیب‌پذیری‌های امنیتی را کاهش دهد.

.SH "همچنین ببینید (SEE ALSO)"
.BR ndisc6 (8),
.BR ipv6 (7)

.SH "نویسنده (AUTHOR)"
R\[char233]mi Denis-Courmont <remi at remlab dot net>
.PP
http://www.remlab.net/ndisc6/