.\" *************************************************************************
.\" *  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 "NDISC6" "8" "$Date$" "ndisc6" "System Manager's Manual"
.SH "نام (NAME)"
ndisc6 \- ابزار کشف همسایه در ICMPv6
.SH "خلاصه دستور (SYNOPSIS)"
.BR "ndisc6" " [" "-1mnqv" "] [" "-r attempts" "] [" "-s source_ip" "]"
.BR "" "[" "-w wait_ms" "] <" "IPv6 address" "> <" "iface" ">"

.SH "توضیحات (DESCRIPTION)"
.B NDisc6
یک برنامه یونیکس است که فرآیند کشف همسایه (Neighbor Discovery) در ICMPv6 را در فضای کاربری پیاده‌سازی می‌کند (این کار به طور معمول توسط هسته انجام می‌گیرد)\&. این برنامه برای یافتن آدرس لایه پیوند (آدرس لایه ۲ یا همان مک‌آدرس در شبکه اترنت) هر گره IPv6 حاضر در همان پیوند محلی (on\-link) استفاده می‌شود\&.

آدرس IPv6 گره مورد نظر و همچنین رابط شبکه‌ای که جستجو روی آن صورت می‌پذیرد باید مشخص شوند\&.

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

.TP
.BR "\-1" " یا " "\-\-single"
خروج بلافاصله پس از دریافت نخستین اعلان (پیش‌فرض)\&.

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

.TP
.BR "\-m" " یا " "\-\-multiple"
انتظار برای اعلان‌های تکراری احتمالی و چاپ همه آن‌ها\&.

.TP
.BR "\-n" " یا " "\-\-numeric"
اگر پارامتر اول یک آدرس معتبر IPv6 نباشد، از تفکیک آن به عنوان نام میزبان DNS صرف‌نظر شود\&.

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

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

.TP
.BR "\-s source_ip" " یا " "\-\-source source_ip"
تعیین آدرس IPv6 مورد استفاده به عنوان مبدأ برای بسته‌های درخواست همسایه (neighbor solicitation)\&.

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

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

.TP
.BR "\-w wait_ms" " یا " "\-\-wait wait_ms"
.RI "انتظار به میزان " "wait_ms" " میلی‌ثانیه برای دریافت پاسخ پیش از تلاش مجدد\&."
به طور پیش‌فرض، ndisc6 بین هر تلاش ۱ ثانیه درنگ می‌کند
(مقدار RETRANS_TIMER از RFC2461)\&.

.PP
.RB "اگر " "ndisc6" " پس از تعداد دفعات تلاش مشخص‌شده و انتظار برای "
.RI "" "wait_ms" " میلی‌ثانیه در هر بار هیچ پاسخی دریافت نکند، با کد 2"
خارج خواهد شد\&. در صورت بروز خطا، با کد 1 خارج می‌شود\&.
در غیر این صورت، خروج با کد 0 خواهد بود\&. این امکان را فراهم می‌سازد تا از کد خروج برای بررسی حضور یک میزبان روی پیوند محلی استفاده شود\&.

.SH "عیب‌یابی (DIAGNOSTICS)"

اگر هیچ پاسخی دریافت نکردید در حالی که مطمئن هستید میزبان مقصد فعال است، به احتمال زیاد آن میزبان بر روی پیوند محلی (on\-link) قرار ندارد؛ به این معنی که برای رسیدن به آن باید از یک یا چند روتر عبور کنید\&. بر اساس طراحی، گره‌های IPv6 به دلایل امنیتی بسته‌های کشف همسایه ICMPv6 دریافت‌شده از گره‌های خارج از پیوند محلی (سگمنت اترنت یکسان) را نادیده می‌گیرند\&. از نظر فنی، این کار با اطمینان از این که حد جهش (TTL) برابر با 255 است کنترل می‌شود\&.

.RB "توجه داشته باشید که نمی‌توانید از " "ndisc6" " برای یافتن آدرس لایه پیوند میزبان محلی خود استفاده کنید\&."

.SH "امنیت (SECURITY)"
.RB "" "ndisc6" " "
.RI "باید به صورت " "setuid" " به کاربر " "root" " تنظیم شود تا کاربران"
عادی نیز بتوانند از آن استفاده کنند\&. این برنامه پیش از هرگونه اقدام به ارسال یا دریافت داده از شبکه، دسترسی‌های ریشه خود را رها می‌کند تا آسیب‌پذیری‌های احتمالی امنیتی کاهش یابد\&.

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

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

<http://www.remlab.net/ndisc6>