.TH "xdp-forward" "8" "OCTOBER 11, 2024" "V1.6.3" "XDP program loader"
.SH "نام (NAME)"
xdp-forward \- لایه هدایت بسته مبتنی بر XDP
.SH "خلاصه دستور (SYNOPSIS)"
.PP
دستور
.B xdp-forward
یک لایه هدایت بسته‌ها با XDP است که هدایت بسته‌های شبکه را با استفاده از XDP شتاب‌بخشی می‌کند. برای استفاده از آن، کافی است آن را روی مجموعه‌ای از رابط‌های شبکه که می‌خواهید هدایت بسته بین آن‌ها تسریع شود، بارگذاری نمایید. سپس بخش فضای کاربری (Userspace) دستور
.B xdp-forward
برنامه‌های XDP را روی آن رابط‌ها پیکربندی و بارگذاری کرده و بسته‌ها را با استفاده از
.B XDP_REDIRECT
بین آن‌ها هدایت می‌کند؛ در این فرآیند، برای تعیین مقصد هر بسته از جدول مسیریابی هسته یا جدول جریان (flowtable) مربوط به netfilter استفاده می‌شود.

.PP
هر بسته‌ای که
.B xdp-forward
نحوه هدایت آن را نداند، به پشته شبکه ارسال شده و طبق معمول توسط هسته مدیریت می‌شود. بسته به حالتی که
.B xdp-forward
در آن بارگذاری شده است، این امر به رفتارهای هدایت متفاوتی منجر می‌گردد. بخش
\fBحالت‌های هدایت (FORWARDING MODES)\fP
را در ادامه ببینید.
.SS "اجرای xdp-forward"
.PP
نحو اجرای
.B xdp-forward
به صورت زیر است:

.RS
.nf
\fCxdp-forward COMMAND [options]

Where COMMAND can be one of:
       load        - Load the XDP forwarding plane
       unload      - Unload the XDP forwarding plane
       help        - show the list of available commands
\fP
.fi
.RE

.PP
هر دستور و گزینه‌های آن در ادامه توضیح داده شده‌اند. همچنین می‌توانید از
.I xdp\-forward COMMAND \-\-help
برای مشاهده گزینه‌های هر دستور استفاده کنید.
.SH "دستور LOAD (The LOAD command)"
.PP
دستور
.I load
لایه هدایت بسته XDP را روی فهرستی از رابط‌های شبکه بارگذاری می‌کند.

.PP
نحو دستور
.I load
به صورت زیر است:

.PP
\fIxdp\-forward load [options] <ifname...>\fP

.PP
که در آن
.I <ifname...>
نام مجموعه‌ای از رابط‌های شبکه است که بسته‌ها باید بین آن‌ها هدایت شوند. یک برنامه XDP روی هر رابط بارگذاری خواهد شد و به گونه‌ای پیکربندی می‌شود که بسته‌ها را به تمام رابط‌های دیگر در آن مجموعه هدایت کند (با استفاده از جدول مسیریابی هسته برای تعیین رابط مقصد هر بسته).

.PP
گزینه‌های پشتیبانی‌شده عبارتند از:
.SS "-f, --fwd-mode <mode>"
.PP
مشخص می‌کند که
.I xdp\-forward
در کدام حالت هدایت باید کار کند. بسته به حالت انتخاب‌شده،
.I xdp\-forward
هدایت را به روش‌های مختلفی انجام می‌دهد که می‌تواند به رفتارهای متفاوتی منجر شود، از جمله اینکه کدام زیرمجموعه از پیکربندی‌های هسته (مانند قوانین دیوار آتش) در حین هدایت رعایت می‌شوند. برای توضیحات کامل درباره هر حالت، به بخش
\fBحالت‌های هدایت (FORWARDING MODES)\fP
در ادامه مراجعه کنید.
.SS "-F, --fib-mode <mode>"
.PP
مشخص می‌کند که
.I xdp\-forward
چگونه جستجوی جدول مسیریابی را در هسته لینوکس انجام دهد. برای توضیحات کامل درباره هر حالت، به بخش
\fBحالت‌های FIB (FIB MODES)\fP
در ادامه مراجعه کنید.
.SS "-m, --mode <mode>"
.PP
مشخص می‌کند که برنامه XDP در چه حالتی بارگذاری شود. مقادیر معتبر عبارتند از:
.BR native
که حالت پیش‌فرض XDP درون درایور (in-driver) است؛
.BR skb
که باعث استفاده از حالت موسوم به
\fIحالت skb\fP
(همچنین معروف به
\fIgeneric XDP\fP)
می‌شود؛
.BR hw
که باعث می‌شود برنامه به سخت‌افزار منتقل (offload) شود؛ یا
.BR unspecified
که انتخاب حالت را به هسته واگذار می‌کند (که اگر درایور پشتیبانی کند حالت native، وگرنه حالت generic را انتخاب خواهد کرد). توجه داشته باشید که استفاده از
.B unspecified
می‌تواند پیش‌بینی حالتی را که در نهایت برنامه در آن بارگذاری می‌شود دشوار سازد؛ به همین دلیل، مقدار پیش‌فرض
.B native
است. همچنین توجه داشته باشید که سخت‌افزارهایی با پشتیبانی از حالت
.B hw
نادر هستند: کارت‌های Solarflare (با درایور 'sfc') تنها دستگاه‌هایی با این پشتیبانی در هسته اصلی لینوکس محسوب می‌شوند.
.SS "-v, --verbose"
.PP
فعال‌سازی ثبت گزارش‌های اشکال‌زدایی (دیباگ). برای دریافت جزئیات بیشتر، این گزینه را دو بار مشخص کنید.
.SS "-h, --help"
.PP
نمایش خلاصه‌ای از گزینه‌های موجود.
.SH "دستور UNLOAD (The UNLOAD command)"
.PP
دستور
.I unload
برای تخلیه برنامه‌ها از یک رابط شبکه استفاده می‌شود.

.PP
نحو دستور
.I unload
به صورت زیر است:

.PP
\fIxdp\-forward unload [options] <ifname...>\fP

.PP
که در آن
.I <ifname...>
فهرست رابط‌هایی است که باید لایه هدایت بسته XDP از روی آن‌ها تخلیه شود. توجه داشته باشید که هرچند
.I xdp\-forward
برنامه‌های XDP بارگذاری‌شده روی هر رابط را بررسی کرده و اطمینان حاصل می‌کند که فقط برنامه خود را تخلیه نماید، اما بررسی نمی‌کند که آیا فهرست رابط‌های داده‌شده دقیقاً همان فهرستی است که هنگام بارگذاری داده شده بود یا خیر. از این رو، ممکن است با دادن فهرستی متفاوت از رابط‌ها، یک تخلیه جزئی صورت گیرد که این امر می‌تواند به رفتارهای غیرمنتظره منجر شود.

.PP
گزینه‌های پشتیبانی‌شده عبارتند از:
.SS "-v, --verbose"
.PP
فعال‌سازی ثبت گزارش‌های اشکال‌زدایی (دیباگ). برای دریافت جزئیات بیشتر، این گزینه را دو بار مشخص کنید.
.SS "-h, --help"
.PP
نمایش خلاصه‌ای از گزینه‌های موجود.
.SH "حالت‌های هدایت (FORWARDING MODES)"
.PP
ابزار
.I xdp\-forward
از حالت‌های هدایت زیر پشتیبانی می‌کند (که توسط پارامتر
.I \-\-fwd\-mode
در دستور
.I xdp\-forward load
انتخاب می‌شود):
.SS "fib (پیش‌فرض)"
.PP
در حالت هدایت
\fIfib\fP،
ابزار
.I xdp\-forward
برای هر بسته یک جستجو در جدول مسیریابی هسته (یا FIB) انجام می‌دهد و بسته‌ها را بر اساس نتیجه این جستجو بین رابط‌های پیکربندی‌شده هدایت می‌کند. هر بسته‌ای که جستجوی آن با شکست مواجه شود، به پشته شبکه فرستاده خواهد شد. این شامل بسته‌هایی است که نیازمند کشف همسایه (Neighbour discovery) برای گام بعدی (Next hop) هستند؛ بدین معنا که بسته‌ها به صورت دوره‌ای (در ابتدا و زمانی که مدخل nexthop منقضی می‌شود) برای کشف گام بعدی به پشته هسته ارسال خواهند شد.

.PP
توجه داشته باشید که به جز جستجوی FIB، هیچ بررسی دیگری انجام نمی‌شود؛ به ویژه، این حالت زیرسیستم netfilter را به طور کامل دور می‌زند، بنابراین قوانین دیوار آتش قبل از هدایت بررسی نخواهند شد.
.SS "flowtable"
.PP
حالت عملیاتی
\fIflowtable\fP
در صورتی که flowtable سخت‌افزاری در دسترس نباشد، منطق flowtable نرم‌افزاری netfilter را به لایه XDP منتقل (offload) می‌کند.
در حال حاضر
.I xdp\-forward
تنها قادر است مدخل‌های TCP یا UDP مربوط به netfilter flowtable را به XDP منتقل نماید. کاربر باید flowtable را به طور جداگانه پیکربندی کند.
.SH "حالت‌های FIB (FIB MODES)"
.PP
ابزار
.I xdp\-forward
از حالت‌های FIB زیر پشتیبانی می‌کند (که توسط پارامتر
.I \-\-fib\-mode
در دستور
.I xdp\-forward load
انتخاب می‌شود):
.SS "full (پیش‌فرض)"
.PP
در حالت عملیاتی
\fIfull\fP،
ابزار
.I xdp\-forward
برای هر بسته یک جستجوی کامل در جدول مسیریابی هسته (یا FIB) انجام می‌دهد و بسته‌ها را بر اساس نتیجه این جستجو بین رابط‌های پیکربندی‌شده هدایت می‌کند. به ویژه، هرگونه قوانین مسیریابی مبتنی بر خط‌مشی (Policy routing) پیکربندی‌شده توسط کاربر را اعمال خواهد کرد.
.SS "direct"
.PP
حالت
\fIdirect\fP
مانند
\fIfull\fP
عمل می‌کند، با این تفاوت که فلگ
\fIBPF_FIB_LOOKUP_DIRECT\fP
را به روال جستجوی FIB ارسال می‌کند. این بدان معناست که در طول جستجو، هرگونه قوانین مسیریابی مبتنی بر خط‌مشی نادیده گرفته می‌شوند که این امر می‌تواند عملکرد را بهبود بخشد (اما طبیعتاً از خط‌مشی آن قوانین پیروی نخواهد کرد).
.SH "مثال‌ها (EXAMPLES)"
.PP
برای فعال‌سازی انتقال (offload) جدول جریان (flowtable) برای ترافیک tcp و udp بین کارت‌های شبکه n0 و n1، دستورات زیر را اجرا کنید:

.RS
.nf
\fC#nft -f /dev/stdin <<EOF
table inet filter {
    flowtable ft {
        hook ingress priority filter
        devices = { n0, n1 }
    }
    chain forward {
        type filter hook forward priority filter
        meta l4proto { tcp, udp } flow add @ft
    }
}
EOF

#xdp-forward load -f flowtable n0 n1
\fP
.fi
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
برای آگاهی از جزئیات معنایی بارگذاری XDP و نیازمندی‌های سازگاری هسته، به
.BR libxdp (3)
مراجعه کنید.
.SH "اشکالات (BUGS)"
.PP
لطفاً هرگونه اشکال را در گیت‌هاب گزارش دهید:
\fIhttps://github.com/xdp-project/xdp-tools/issues\fP
.SH "نویسنده (AUTHOR)"
.PP
دستور xdp-forward توسط Toke Høiland-Jørgensen و بر پایه نمونه هسته xdp_fwd که در ابتدا توسط David Ahern نوشته شده بود، توسعه یافته است. این صفحه راهنما توسط Toke Høiland-Jørgensen نوشته شده است.