.\" SPDX-License-Identifier: GPL-2.0-or-later
.TH PPPOE-RELAY 8 "26 January 2001"
.\""
.UC 4
.SH "نام (NAME)"
pppoe\-relay \- عامل رله PPPoE در فضای کاربری.
.SH "خلاصه دستور (SYNOPSIS)"
.B pppoe\-relay \fR[\fIگزینه‌ها\fR]

.SH "توضیحات (DESCRIPTION)"
برنامه \fBpppoe\-relay\fR یک عامل رله در فضای کاربری برای PPPoE
(Point-to-Point Protocol over Ethernet یا پروتکل نقطه به نقطه روی اترنت) برای لینوکس است.
\fBpppoe\-relay\fR در هماهنگی با کلاینت \fBpppoe\fR و سرور \fBpppoe\-server\fR کار می‌کند.
برای مشاهده جزئیات مربوط به نحوه کارکرد \fBpppoe\-relay\fR، بخش «نحوه عملکرد» را در ادامه این راهنما ببینید.

.SH "گزینه‌ها (OPTIONS)"
.TP
.B \-S \fIinterface\fR
رابط اترنت \fIinterface\fR را به فهرست رابط‌های مدیریت‌شده توسط \fBpppoe\-relay\fR اضافه می‌کند.
تنها سرورهای PPPoE می‌توانند به این رابط متصل شوند.

.TP
.B \-C \fIinterface\fR
رابط اترنت \fIinterface\fR را به فهرست رابط‌های مدیریت‌شده توسط \fBpppoe\-relay\fR اضافه می‌کند.
تنها کلاینت‌های PPPoE می‌توانند به این رابط متصل شوند.

.TP
.B \-B \fIinterface\fR
رابط اترنت \fIinterface\fR را به فهرست رابط‌های مدیریت‌شده توسط \fBpppoe\-relay\fR اضافه می‌کند.
هم کلاینت‌ها و هم سرورهای PPPoE می‌توانند به این رابط متصل شوند.

.TP
.B \-n \fInum\fR
حداکثر \fInum\fR نشست هم‌روند PPPoE را مجاز می‌داند.
در صورت عدم تعیین، مقدار پیش‌فرض ۵۰۰۰ است.
مقدار \fInum\fR می‌تواند در محدوده ۱ تا ۶۵۵۳۴ باشد.

.TP
.B \-i \fItimeout\fR
مدت‌زمان مجاز برای عدم فعالیت (idle timeout) نشست را مشخص می‌کند.
اگر هر دو طرف در یک نشست بیش از \fItimeout\fR ثانیه غیرفعال باشند، نشست خاتمه می‌یابد.
اگر \fItimeout\fR برابر صفر تعیین شود، نشست‌ها هرگز به‌دلیل عدم فعالیت خاتمه نخواهند یافت.

توجه داشته باشید که روال انقضای نشست‌های غیرفعال هرگز با بسامدی بیشتر از هر ۳۰ ثانیه یک‌بار اجرا نمی‌شود، بنابراین مهلت زمانی تقریبی است.
مقدار پیش‌فرض برای \fItimeout\fR ۶۰۰ ثانیه (۱۰ دقیقه) است.

.TP
.B \-F
گزینه \fB\-F\fR باعث می‌شود \fBpppoe\-relay\fR به پس‌زمینه فورک \fIنشود\fR؛
در عوض در پیش‌زمینه باقی می‌ماند.

.TP
.B \-h
گزینه \fB\-h\fR یک پیام کوتاه از نحوه استفاده را چاپ کرده و خارج می‌شود.

.SH "نحوه عملکرد (OPERATION)"

دستور \fBpppoe\-relay\fR به فریم‌های ورودی PPPoE PADI روی تمامی رابط‌های مشخص‌شده با گزینه‌های \fB\-B\fR یا \fB\-C\fR گوش فرا می‌دهد.
هنگامی که یک فریم PADI دریافت می‌شود، \fBpppoe\-relay\fR یک برچسب Relay\-Session\-ID به آن افزوده و فریم PADI را روی تمامی رابط‌های مشخص‌شده با گزینه‌های \fB\-B\fR یا \fB\-S\fR (به‌جز رابطی که فریم از طریق آن دریافت شده است) همه‌پخشی (broadcast) می‌کند.

هر فریم PADO دریافت‌شده به کلاینتی که فریم PADI را ارسال کرده بود رله می‌شود (به شرط آنکه حاوی برچسب‌های معتبر Relay\-Session\-ID باشند).
به همین ترتیب، فریم‌های PADR از سوی کلاینت‌ها به متمرکزکننده دسترسی (access concentrator) مربوطه رله می‌شوند.

هنگامی که یک فریم PADS دریافت می‌شود، \fBpppoe\-relay\fR آدرس‌های MAC دو طرف ارتباط و شناسه‌های نشست (session\-ID) آن‌ها را در یک جدول درهم‌سازی وارد می‌کند.
(شناسه نشستی که توسط متمرکزکننده دسترسی دیده می‌شود ممکن است با آنچه توسط کلاینت دیده می‌شود متفاوت باشد؛
\fBpppoe\-relay\fR باید نشست‌ها را مجدداً شماره‌گذاری کند تا از احتمال وجود شناسه‌های نشست تکراری جلوگیری شود.)
هر زمان که هر یک از دو طرف یک فریم نشست ارسال کنند، \fBpppoe\-relay\fR مدخل نشست را در جدول درهم‌سازی جستجو کرده و فریم را به طرف مربوطه رله می‌کند.

هنگامی که یک فریم PADT دریافت می‌شود، \fBpppoe\-relay\fR آن را به طرف مقابل رله کرده و مدخل نشست را از جدول درهم‌سازی خود حذف می‌کند.

اگر یک کلاینت و سرور دچار فروپاشی (crash) شوند (یا فریم‌ها از بین بروند)، ممکن است فریم‌های PADT هرگز ارسال نشوند و جدول درهم‌سازی \fBpppoe\-relay\fR با نشست‌های راکد و کهنه پر شود.
بنابراین، یک روال پاک‌سازی نشست به‌صورت دوره‌ای اجرا می‌شود و نشست‌های قدیمی را از جدول درهم‌سازی حذف می‌کند.
یک نشست در صورتی «قدیمی» در نظر گرفته می‌شود که در طول \fItimeout\fR ثانیه هیچ ترافیکی در آن مشاهده نشده باشد.
هنگامی که یک نشست به‌دلیل اتمام مهلت زمانی حذف می‌شود، یک فریم PADT به هر یک از طرفین ارسال می‌شود تا اطمینان حاصل شود که آن‌ها از پایان یافتن نشست آگاه هستند.

.SH "مثال‌های فراخوانی (EXAMPLE INVOCATIONS)"

.nf
pppoe\-relay \-C eth0 \-S eth1
.fi

مثال بالا فریم‌ها را بین کلاینت‌های PPPoE در شبکه eth0 و سرورهای PPPoE در شبکه eth1 رله می‌کند.

.nf
pppoe\-relay \-B eth0 \-B eth1
.fi

این مثال یک رله شفاف (transparent relay) است -- فریم‌ها بین هر ترکیبی از کلاینت‌ها و سرورها در شبکه‌های eth0 و eth1 رله می‌شوند.

.nf
pppoe\-relay \-S eth0 \-C eth1 \-C eth2 \-C eth3
.fi

این مثال فریم‌ها را بین سرورها در شبکه eth0 و کلاینت‌ها در شبکه‌های eth1، eth2 و eth3 رله می‌کند.

.SH "نویسندگان (AUTHORS)"
برنامه \fBpppoe\-relay\fR توسط Dianne Skoll <dianne@skoll.ca> نوشته شده است.

صفحه خانگی \fBpppoe\fR در آدرس \fIhttps://dianne.skoll.ca/projects/rp\-pppoe/\fR قرار دارد.

.SH "همچنین ببینید (SEE ALSO)"
pppd(8), pppoe(8), pppoe\-sniff(8), pppoe\-server(8)