.TH ARPD 8 "28 June, 2007" "iproute2" "راهنمای مدیریت سیستم پارچ"

.SH "نام (NAME)"
arpd \- دیمن جمع‌آوری و مدیریت کش ARP در فضای کاربری

.SH "خلاصه دستور (SYNOPSIS)"
.B arpd
[\fB\-lkh?\fR]
[\fB\-a\fR \fIN\fR]
[\fB\-b\fR \fIdbase\fR]
[\fB\-B\fR \fInumber\fR]
[\fB\-f\fR \fIfile\fR]
[\fB\-p\fR \fIinterval\fR]
[\fB\-n\fR \fItime\fR]
[\fB\-R\fR \fIrate\fR]
[\fI<INTERFACES>\fR]

.SH "توضیحات (DESCRIPTION)"
دیمن
.B arpd
اطلاعات ARP غیرمنتظره (gratuitous ARP) را جمع‌آوری کرده، روی دیسک محلی ذخیره می‌کند و در صورت نیاز به هسته تحویل می‌دهد تا از ارسال پیام‌های همگانی (broadcast) تکراری ناشی از اندازه محدود حافظه نهان (کش) ARP هسته جلوگیری شود.

.SH "گزینه‌ها (OPTIONS)"
.TP
.BR \-h ", " \-?
نمایش پیام راهنما و خروج.
.TP
.B \-l
تخلیه محتوای پایگاه‌داده
.B arpd
در خروجی استاندارد و خروج از برنامه. خروجی شامل سه ستون است: نمایه (index) رابط، نشانی IP رابط، و نشانی MAC رابط. ورودی‌های منفی مربوط به میزبان‌های غیرفعال (dead) نیز نشان داده می‌شوند؛ در این حالت به جای نشانی MAC، واژه
.B FAILED
به همراه یک دونقطه و تازه‌ترین زمانی که غیرفعال بودن میزبان به اثبات رسیده است نمایش داده می‌شود.
.TP
.BI \-f " <FILE>"
خواندن و بارگذاری پایگاه‌داده
.B arpd
از پرونده
.I FILE
با قالب متنی مشابه آنچه توسط گزینه
.B \-l
تولید می‌شود. پس از بارگذاری برنامه خارج می‌شود؛ در صورتی که گزینه
.B \-l
نیز همراه آن مشخص شده باشد، پایگاه‌داده حاصل فهرست خواهد شد. اگر
.I FILE
به صورت
.B \-
تعیین شود، جدول ARP از ورودی استاندارد (stdin) خوانده می‌شود.
.TP
.BI \-b " <DATABASE>"
مکان پرونده پایگاه‌داده. مسیر پیش‌فرض
.I /var/lib/arpd/arpd.db
است.
.TP
.BI \-a " <NUMBER>"
با این گزینه،
.B arpd
نه تنها به صورت غیرفعال (passive) به بسته‌های ARP روی رابط گوش می‌دهد، بلکه خود نیز پرس‌وجوهای همگانی ارسال می‌کند.
.I NUMBER
تعداد این پرس‌وجوها پیش از آن است که یک مقصد به عنوان غیرفعال (dead) در نظر گرفته شود. هنگامی که
.B arpd
به عنوان دستیار هسته (یعنی با فعال بودن
.B app_solicit
در
.B sysctl
یا حتی با گزینه
.BR \-k )
بدون این گزینه اجرا شود و هنوز اطلاعات کافی نیاموخته باشد، ممکن است وقفه‌های یک‌ثانیه‌ای در ارائه خدمات مشاهده شود. این وضعیت مهلک نیست، اما مطلوب هم نخواهد بود.
.TP
.B \-k
جلوگیری از ارسال پرس‌وجوهای همگانی توسط هسته. این گزینه تنها در ترکیب با گزینه
.B \-a
معنا دارد.
.TP
.BI \-n " <TIME>"
مدت‌زمان انقضای حافظه نهان منفی (negative cache) را مشخص می‌کند. هنگامی که وضوح‌بخشی آدرس با شکست مواجه می‌شود،
.B arpd
تلاش‌های بعدی برای وضوح‌بخشی را در این بازه زمانی متوقف می‌سازد. این گزینه تنها همراه با گزینه
.B \-k
کاربرد دارد. این مدت‌زمان نباید بسیار طولانی‌تر از زمان راه‌اندازی یک میزبان معمولی باشد که از ARP غیرمنتظره پشتیبانی نمی‌کند. مقدار پیش‌فرض ۶۰ ثانیه است.
.TP
.BI \-p " <TIME>"
زمان انتظار بر حسب ثانیه میان تلاش‌های نظرسنجی (polling) از جدول ARP هسته.
.I TIME
می‌تواند یک عدد ممیز شناور (اعشاری) باشد. مقدار پیش‌فرض ۳۰ است.
.TP
.BI \-R " <RATE>"
حداکثر نرخ پایدار ارسال بسته‌های همگانی توسط
.B arpd
بر حسب بسته در ثانیه. مقدار پیش‌فرض ۱ است.
.TP
.BI \-B " <NUMBER>"
تعداد ارسال‌های همگانی متوالی (پشت‌سرهم) توسط
.BR arpd .
مقدار پیش‌فرض ۳ است. این گزینه همراه با گزینه
.BR \-R ،
تضمین می‌کند که تعداد پرس‌وجوهای ARP ارسال‌شده به صورت همگانی در هر بازه زمانی
.IR T ،
از مقدار
.B B+R*T
فراتر نرود.
.PP
.I <INTERFACES>
فهرستی از نام‌های رابط‌های شبکه جهت نظارت و پایش است. در صورتی که هیچ رابطی مشخص نشود،
.B arpd
تمام رابط‌ها را پایش می‌کند. در این حالت
.B arpd
پارامترهای
.B sysctl
را تغییر نمی‌دهد و فرض می‌شود که کاربر خود پس از راه‌اندازی
.B arpd
این کار را انجام خواهد داد.

.SH "سیگنال‌ها (SIGNALS)"
هنگامی که
.B arpd
سیگنال‌های
.B SIGINT
یا
.B SIGTERM
را دریافت می‌کند، با نظم خارج می‌شود؛ پایگاه‌داده را همگام‌سازی کرده و پارامترهای تغییریافته
.B sysctl
را به حالت اولیه بازمی‌گرداند. در صورت دریافت سیگنال
.BR SIGHUP ،
پایگاه‌داده را روی دیسک ذخیره و همگام می‌کند. با سیگنال
.BR SIGUSR1 ،
برخی آمارهای عملکردی را به
.B syslog
می‌فرستد. اثر سایر سیگنال‌ها تعریف‌نشده است؛ به ویژه، ممکن است موجب خرابی پایگاه‌داده شده و پارامترهای
.B sysctl
را در وضعیتی غیرقابل پیش‌بینی رها کنند.

.SH "نکات (NOTE)"
برای اینکه
.B arpd
بتواند به عنوان حل‌کننده ARP خدمت‌رسانی کند، هسته باید با گزینه
.B CONFIG_ARPD
کامپایل شده باشد و در حالتی که فهرست رابط‌ها در خط فرمان داده نشده باشد، متغیر
.B app_solicit
روی رابط‌های مورد نظر باید در مسیر
.I /proc/sys/net/ipv4/neigh/*
تنظیم شده باشد. در غیر این صورت،
.B arpd
همچنان اطلاعات ARP غیرمنتظره را در پایگاه‌داده خود جمع‌آوری خواهد کرد.

.SH "مثال‌ها (EXAMPLES)"
.TP
.B arpd \-b /var/tmp/arpd.db
راه‌اندازی
.B arpd
برای جمع‌آوری ARP غیرمنتظره، بدون دخالت در عملکردهای هسته.
.TP
.B killall arpd ; arpd \-l \-b /var/tmp/arpd.db
مشاهده نتایج ثبت‌شده پس از گذشت مدتی از اجرای دیمن.
.TP
.B arpd \-b /var/tmp/arpd.db \-a 1 eth0 eth1
فعال‌سازی حالت دستیار هسته، با حفظ نقش اصلی برای هسته.
.TP
.B arpd \-b /var/tmp/arpd.db \-a 3 \-k eth0 eth1
جایگزینی کامل وضوح‌بخشی هسته روی رابط‌های eth0 و eth1. در این حالت هسته همچنان کاوش‌های تک‌پخشی (unicast) را برای اعتبارسنجی ورودی‌ها انجام می‌دهد، اما تمامی فعالیت‌های ارسال همگانی (broadcast) متوقف شده و تحت کنترل
.B arpd
انجام می‌شود.
.PP
این حالتی است که
.B arpd
معمولاً در آن فعالیت می‌کند. البته این حالت پیش‌فرض نیست تا از فعال‌سازی اتفاقی حالتی بیش از حد تهاجمی جلوگیری شود.