.TH IP\-NEIGHBOUR 8 "20 Dec 2011" "iproute2" "Linux" .SH "نام (NAME)" ip-neighbour \- مدیریت جداول نگاشت ARP یا NDISC همسایهها .SH "خلاصه دستور (SYNOPSIS)" .sp .ad l .in +8 .ti -8 .B ip .RI "[ " OPTIONS " ]" .B neigh .RI " { " COMMAND " | " .BR help " }" .sp .ti -8 .BR "ip neigh" " { " add " | " del " | " change " | " replace " } { " .IR ADDR " [ " .B lladdr .IR LLADDR " ] [ " .B nud .IR STATE " ] |" .B proxy .IR ADDR " } [ " .B dev .IR DEV " ] [ " .BR router " ] [ " .BR use " ] [ " .BR managed " ] [ " .BR extern_learn " ]" .ti -8 .BR "ip neigh" " { " show " | " flush " } [ " proxy " ] [ " to .IR PREFIX " ] [ " .B dev .IR DEV " ] [ " .B nud .IR STATE " ] [ " .B vrf .IR NAME " ] [" .BR nomaster " ]" .ti -8 .B ip neigh get .IR ADDR .B dev .IR DEV .ti -8 .IR STATE " := {" .BR permanent " | " noarp " | " stale " | " reachable " | " none " |" .BR incomplete " | " delay " | " probe " | " failed " }" .SH "توضیحات (DESCRIPTION)" دستور .B ip neigh اشیای .I neighbour (همسایه) را که پیوندهای میان آدرس‌های پروتکل و آدرس‌های لایه پیوند (Link Layer) را برای میزبان‌هایی که یک پیوند مشترک دارند برقرار می‌سازند، مدیریت می‌کند. مدخل‌های همسایه در جدول‌ها سازمان‌دهی می‌شوند. جدول همسایگی IPv4 با نام دیگری نیز شناخته می‌شود: جدول ARP. .P دستورات متناظر، پیوندهای همسایه و ویژگی‌های آن‌ها را نمایش می‌دهند، مدخل‌های همسایه جدید اضافه می‌کنند و مدخل‌های قدیمی را حذف می‌نمایند. .TP ip neighbour add افزودن یک مدخل همسایه جدید .TP ip neighbour change تغییر دادن یک مدخل موجود .TP ip neighbour replace افزودن یک مدخل جدید یا تغییر دادن یک مدخل موجود .RS .PP این دستورات رکوردهای همسایگی جدید ایجاد کرده یا رکوردهای موجود را به‌روزرسانی می‌کنند. .TP .BI to " ADDRESS " (پیش‌فرض) آدرس پروتکل مربوط به همسایه. این آدرس می‌تواند یک آدرس IPv4 یا IPv6 باشد. .TP .BI dev " NAME" رابط شبکه‌ای که این همسایه به آن متصل است. .TP .BI proxy مشخص می‌کند که آیا برای این مدخل همسایه پروکسی انجام می‌دهیم یا خیر. .TP .BI router مشخص می‌کند که آیا همسایه یک مسیریاب (روتر) است یا خیر. .TP .BI use این مدخل همسایه در حالت «در حال استفاده» (use) است. این گزینه می‌تواند برای نشان دادن به هسته سیستم‌عامل استفاده شود که یک کنترل‌کننده در حال استفاده از این مدخل پویا است. اگر مدخل وجود نداشته باشد، هسته آن را تفکیک (resolve) خواهد کرد. اگر وجود داشته باشد، تلاشی برای تازه‌سازی (refresh) مدخل همسایه فعال می‌شود. .TP .BI managed این مدخل همسایه «مدیریت‌شده» (managed) است. این گزینه می‌تواند برای نشان دادن به هسته سیستم‌عامل استفاده شود که یک کنترل‌کننده در حال استفاده از این مدخل پویا است. بر خلاف .BR use ، اگر مدخل وجود نداشته باشد، هسته آن را تفکیک می‌کند و به‌طور دوره‌ای تلاش می‌کند تا مدخل همسایه را به‌صورت خودکار تازه‌سازی نماید تا در صورت امکان در وضعیت تفکیک‌شده باقی بماند. .TP .BI extern_learn این مدخل همسایه از خارج یاد گرفته شده است. این گزینه می‌تواند برای نشان دادن به هسته سیستم‌عامل استفاده شود که این یک مدخل پویا است که توسط کنترل‌کننده یاد گرفته شده است. هسته چنین مدخلی را پاکسازی (gc) نخواهد کرد. .TP .BI lladdr " LLADDRESS" آدرس لایه پیوند (Link Layer) همسایه. .I LLADDRESS همچنین می‌تواند .BR "null" باشد. .TP .BI nud " STATE" وضعیت مدخل همسایه. .B nud مخفف «Neighbour Unreachability Detection» (تشخیص عدم دسترسی‌پذیری همسایه) است. وضعیت می‌تواند یکی از مقادیر زیر را داشته باشد: .RS .TP .B permanent مدخل همسایه برای همیشه معتبر است و فقط به صورت مدیریتی (دستی) می‌تواند حذف شود. .TP .B noarp مدخل همسایه معتبر است. تلاشی برای اعتبارسنجی این مدخل انجام نخواهد شد اما با پایان یافتن طول عمرش می‌تواند حذف شود. .TP .B reachable مدخل همسایه تا زمان منقضی شدن مهلت دسترسی‌پذیری (Reachability Timeout) معتبر است. .TP .B stale مدخل همسایه معتبر اما مشکوک است. این گزینه به .B ip neigh در صورتی که وضعیت معتبر بوده و آدرس توسط این دستور تغییر نکرده باشد، وضعیت همسایه را تغییر نمی‌دهد. .TP .B none این یک شبه‌وضعیت است که در زمان ایجاد اولیه مدخل همسایه یا پس از تلاش برای حذف آن قبل از آزاد شدن شرایط حذف استفاده می‌شود. .TP .B incomplete مدخل همسایه هنوز اعتبارسنجی/تفکیک نشده است. .TP .B delay اعتبارسنجی مدخل همسایه در حال حاضر به تعویق افتاده است. .TP .B probe همسایه در حال کاوش و سنجش (Probe) است. .TP .B failed حداکثر تعداد کاوش‌ها بدون موفقیت به پایان رسیده و اعتبارسنجی همسایه در نهایت با شکست مواجه شده است. .RE .RE .TP ip neighbour delete حذف یک مدخل همسایه .RS .PP آرگومان‌ها مانند .BR "ip neigh add" هستند، با این تفاوت که .B lladdr و .B nud نادیده گرفته می‌شوند. .PP .B هشدار: تلاش برای حذف یا تغییر دستی یک مدخل .B noarp ایجادشده توسط هسته ممکن است به رفتار غیرقابل پیش‌بینی منجر شود. به‌ویژه، هسته ممکن است حتی روی رابط .B NOARP یا در صورت چندپخشی (Multicast) یا همه‌پخشی (Broadcast) بودن آدرس، تلاش کند آن را تفکیک نماید. .RE .TP ip neighbour show فهرست کردن مدخل‌های همسایه .RS .TP .BI to " ADDRESS " (پیش‌فرض) پیشوندی که همسایه‌ها را برای فهرست کردن انتخاب می‌کند. .TP .BI dev " NAME" تنها همسایه‌های متصل به این دستگاه را فهرست می‌کند. .TP .BI vrf " NAME" تنها همسایه‌های مربوط به VRF مشخص‌شده را فهرست می‌کند. .TP .BI nomaster تنها همسایه‌های متصل به رابطی بدون رابط اصلی (Master) را فهرست می‌کند. .TP .BI proxy پروکسی‌های همسایه را فهرست می‌کند. .TP .B unused تنها همسایه‌هایی را که در حال حاضر مورد استفاده نیستند فهرست می‌کند. .TP .BI nud " STATE" تنها مدخل‌های همسایه در این وضعیت را فهرست می‌کند. .I NUD_STATE مقادیر فهرست‌شده در بالا یا مقدار ویژه .B all را می‌پذیرد که به معنای تمام وضعیت‌ها است. این گزینه می‌تواند بیش از یک بار تکرار شود. اگر این گزینه ارائه نشود، .B ip تمامی مدخل‌ها را به جز .B none و .BR "noarp" فهرست می‌کند. .RE .TP ip neighbour flush پاکسازی مدخل‌های همسایه .RS این دستور همان آرگومان‌های .B show را دارد. تفاوت‌ها در این است که وقتی هیچ آرگومانی داده نشود اجرا نمی‌شود و وضعیت‌های پیش‌فرض همسایه برای پاکسازی شامل .B permanent و .BR "noarp" نمی‌شود. .PP با گزینه .BR \-statistics ، خروجی دستور با جزئیات بیشتر (Verbose) نمایش داده می‌شود. این گزینه تعداد همسایه‌های حذف‌شده و تعداد دورهای انجام‌شده برای پاکسازی جدول همسایه را چاپ می‌کند. اگر این گزینه دو بار داده شود، .B ip neigh flush تمام همسایه‌های حذف‌شده را نیز نمایش می‌دهد. .RE .TP ip neigh get جستجو و دریافت یک مدخل همسایه برای یک مقصد با داشتن یک دستگاه .RS .TP .BI proxy مشخص می‌کند که آیا باید به دنبال مدخل همسایه پروکسی بگردد یا خیر. .TP .BI to " ADDRESS " (پیش‌فرض) پیشوندی که همسایه مورد نظر برای پرس‌وجو را تعیین می‌کند. .TP .BI dev " NAME" دریافت مدخل همسایه متصل به این دستگاه. .RE .SH "مثال‌ها (EXAMPLES)" .PP ip neighbour .RS جدول همسایگی فعلی در هسته را نمایش می‌دهد. .RE .PP ip neigh flush dev eth0 .RS مدخل‌های جدول همسایگی روی دستگاه eth0 را حذف و پاکسازی می‌کند. .RE .PP ip neigh get 10.0.1.10 dev eth0 .RS یک جستجوی همسایه در هسته انجام می‌دهد و یک مدخل همسایه را بازمی‌گرداند. .RE .SH "همچنین ببینید (SEE ALSO)" .br .BR ip (8) .SH "نویسنده (AUTHOR)" صفحه راهنمای اصلی توسط Michail Litvak نوشته شده است.