'\" t
.TH "SYSTEMD\&.LINK" "5" "" "systemd 261.2" "systemd.link"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
systemd.link \- پیکربندی دستگاه شبکه
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fIlink\fR\&.link
.SH "توضیحات (DESCRIPTION)"
.PP
یک فایل متنی ساده به سبک ini که پیکربندی را برای دستگاه‌های شبکه منطبق کدگذاری می‌کند و توسط
\fBsystemd-udevd\fR(8)
و به‌ویژه توکار (builtin)
\fBnet_setup_link\fR
آن استفاده می‌شود\&. برای توصیف کلی نحو،
\fBsystemd.syntax\fR(7)
را ببینید\&.
.PP
توجه داشته باشید که برخی توزیع‌ها ممکن است فایل‌های
\&.link
را در سازوکارهای مراحل اولیه بوت خود بگنجانند (برای مثال با گنجاندن نسخه‌هایی از فایل‌های
\&.link
در initramfs)\&. از این رو ممکن است انجام اقدامات دستی برای اطمینان از همگام بودن هرگونه تغییرات محلی با سازوکارهای ذخیره‌سازی مراحل اولیه بوت لازم باشد\&. باید به مستندات مرتبط با توزیع خاص مراجعه شود\&.
.PP
فایل‌های
\&.link
از فایل‌های واقع در دایرکتوری شبکه سیستم
/usr/lib/systemd/network
و
/usr/local/lib/systemd/network
\&\s-2\u[1]\d\s+2، دایرکتوری موقت و فرار زمان اجرای شبکه
/run/systemd/network، و دایرکتوری شبکه مدیریت محلی
/etc/systemd/network
خوانده می‌شوند\&. تمام فایل‌های پیکربندی صرف‌نظر از دایرکتوری‌هایی که در آن قرار دارند، به صورت الفبایی\-عددی مرتب و پردازش می‌شوند\&. با این حال، فایل‌های با نام یکسان جایگزین یکدیگر می‌شوند\&. توصیه می‌شود که نام هر فایل با عددی کوچک‌تر از
"70"
پیشوندگذاری شود (برای مثال
10\-eth0\&.link)\&. در غیر این صورت، فایل‌های
\&.link
پیش‌فرض یا فایل‌های ایجادشده توسط
\fBsystemd-network-generator.service\fR(8)
ممکن است بر فایل‌های پیکربندی‌شده توسط کاربر اولویت یابند\&. فایل‌های موجود در
/etc/
بالاترین اولویت را دارند، فایل‌های موجود در
/run/
بر فایل‌های با نام مشابه در
/usr/lib/
مقدم هستند\&. در صورت نیاز می‌توان از این سازوکار برای بازنویسی و جایگزینی یک فایل link ارائه‌شده توسط سیستم با یک فایل محلی استفاده کرد\&. به عنوان یک حالت خاص، یک فایل خالی (اندازه فایل ۰) یا پیوند نمادین با همان نام که به
/dev/null
اشاره دارد، فایل پیکربندی را به طور کامل غیرفعال می‌کند (اصطلاحاً "ماسک" می‌شود)\&.
.PP
همراه با فایل link به نام
foo\&.link، ممکن است دایرکتوری قطعه الحاقی (drop\-in) با نام
foo\&.link\&.d/
وجود داشته باشد\&. تمام فایل‌های با پسوند
"\&.conf"
از این دایرکتوری به ترتیب الفبایی\-عددی ادغام شده و پس از تجزیه خود فایل اصلی، تجزیه خواهند شد\&. این امر برای تغییر دادن یا افزودن تنظیمات پیکربندی، بدون نیاز به ویرایش فایل پیکربندی اصلی مفید است\&. هر فایل drop\-in باید دارای سرآیندهای بخش مناسب باشد\&.
.PP
علاوه بر
/etc/systemd/network، دایرکتوری‌های قطعه الحاقی
"\&.d"
را می‌توان در دایرکتوری‌های
/usr/lib/systemd/network
یا
/run/systemd/network
قرار داد\&. فایل‌های drop\-in موجود در
/etc/
بر موارد موجود در
/run/
اولویت دارند که آن‌ها نیز به نوبه خود بر موارد موجود در
/usr/lib/
مقدم هستند\&. فایل‌های drop\-in تحت هر یک از این دایرکتوری‌ها، صرف‌نظر از محل قرارگیری فایل link اصلی، بر آن اولویت دارند\&.
.PP
فایل link شامل یک بخش [Match] است که تعیین می‌کند آیا یک فایل link معین می‌تواند روی یک دستگاه معین اعمال شود یا خیر، و همچنین یک بخش [Link] که نحوه پیکربندی دستگاه را مشخص می‌کند\&. اولین فایل (به ترتیب واژه‌نگاری) از میان فایل‌های link که با یک دستگاه مشخص مطابقت داشته باشد، اعمال می‌شود\&. توجه داشته باشید که یک فایل پیش‌فرض به نام
99\-default\&.link
توسط سیستم ارائه می‌شود\&. بنابراین هر فایل
\&.link
ارائه‌شده توسط کاربر باید نامی از نظر واژه‌نگاری جلوتر داشته باشد تا اصلاً در نظر گرفته شود\&.
.PP
برای عیب‌یابی مشکلات مربوط به فایل‌های
\&.link،
\fBudevadm\fR(8)
را ببینید\&.
.SH "گزینه‌های بخش [MATCH] ([MATCH] SECTION OPTIONS)"
.PP
گفته می‌شود یک فایل link با یک رابط مطابقت دارد اگر تمام تطبیق‌های مشخص‌شده توسط بخش [Match] برآورده شوند\&. هنگامی که یک فایل link شامل تنظیمات معتبری در بخش [Match] نباشد، آنگاه فایل با تمام رابط‌ها مطابقت خواهد داشت و
\fBsystemd\-udevd\fR
در این باره هشدار می‌دهد\&. راهنمایی: برای جلوگیری از هشدار و شفاف‌سازی اینکه قرار است با تمام رابط‌ها مطابقت داده شود، مورد زیر را اضافه کنید:
.sp
.if n \{\
.RS 4
.\}
.nf
OriginalName=*
.fi
.if n \{\
.RE
.\}
.sp
اولین فایل (به ترتیب الفبایی\-عددی) از میان فایل‌های link که با یک رابط مشخص مطابقت داشته باشد اعمال می‌شود، و تمام فایل‌های بعدی نادیده گرفته می‌شوند، حتی اگر آن‌ها نیز مطابقت داشته باشند\&. کلیدهای زیر پذیرفته می‌شوند:
.PP
\fIMACAddress=\fR
.RS 4
فهرستی از آدرس‌های سخت‌افزاری جداشده با فاصله (whitespace)\&. قالب‌های قابل‌قبول عبارتند از:
.PP
\fBشانزده‌شانزدهی جداشده با دونقطه\fR
.RS 4
هر فیلد باید یک بایت باشد\&. برای مثال
"12:34:56:78:90:ab"
یا
"AA:BB:CC:DD:EE:FF"\&.
.sp
افزوده شده در نسخه 250\&.
.RE
.PP
\fBشانزده‌شانزدهی جداشده با خط تیره\fR
.RS 4
هر فیلد باید یک بایت باشد\&. برای مثال
"12\-34\-56\-78\-90\-ab"
یا
"AA\-BB\-CC\-DD\-EE\-FF"\&.
.sp
افزوده شده در نسخه 250\&.
.RE
.PP
\fBشانزده‌شانزدهی جداشده با نقطه\fR
.RS 4
هر فیلد باید دو بایت باشد\&. برای مثال
"1234\&.5678\&.90ab"
یا
"AABB\&.CCDD\&.EEFF"\&.
.sp
افزوده شده در نسخه 250\&.
.RE
.PP
\fBقالب آدرس IPv4\fR
.RS 4
برای مثال
"127\&.0\&.0\&.1"
یا
"192\&.168\&.0\&.1"\&.
.sp
افزوده شده در نسخه 250\&.
.RE
.PP
\fBقالب آدرس IPv6\fR
.RS 4
برای مثال
"2001:0db8:85a3::8a2e:0370:7334"
یا
"::1"\&.
.sp
افزوده شده در نسخه 250\&.
.RE
.sp
طول کل هر آدرس MAC باید ۴ (برای تونل IPv4)، ۶ (برای اترنت)، ۱۶ (برای تونل IPv6)، یا ۲۰ (برای InfiniBand) باشد\&. این گزینه ممکن است بیش از یک بار مشخص شود که در این صورت فهرست‌ها ادغام می‌شوند\&. اگر یک رشته خالی به این گزینه اختصاص یابد، فهرست آدرس‌های سخت‌افزاری تعریف‌شده پیش از این بازنشانی می‌شود\&. پیش‌فرض تنظیم‌نشده است\&.
.sp
افزوده شده در نسخه 211\&.
.RE
.PP
\fIPermanentMACAddress=\fR
.RS 4
فهرستی از آدرس‌های دائمی سخت‌افزار، جداشده با فاصله\&. در حالی که
\fIMACAddress=\fR
با آدرس MAC فعلی دستگاه مطابقت داده می‌شود، این گزینه با آدرس MAC دائمی دستگاه مطابقت داده می‌شود که ممکن است با آدرس فعلی متفاوت باشد\&. از قالب کامل شانزده‌شانزدهی جداشده با دونقطه، خط تیره یا نقطه، یا قالب آدرس IPv4 یا IPv6 استفاده کنید\&. این گزینه ممکن است بیش از یک بار مشخص شود که در این صورت فهرست‌ها ادغام می‌شوند\&. اگر یک رشته خالی به این گزینه اختصاص یابد، فهرست آدرس‌های سخت‌افزاری تعریف‌شده پیش از این بازنشانی می‌شود\&. پیش‌فرض تنظیم‌نشده است\&.
.sp
افزوده شده در نسخه 245\&.
.RE
.PP
\fIPath=\fR
.RS 4
فهرستی از الگوهای تطبیق مسیر به سبک شل (globs)، جداشده با فاصله، که با مسیر پایدار دستگاه، همان‌طور که توسط ویژگی udev به نام
\fIID_PATH\fR
ارائه شده مطابقت می‌یابد\&.
.sp
افزوده شده در نسخه 211\&.
.RE
.PP
\fIDriver=\fR
.RS 4
فهرستی از الگوهای سبک شل جداشده با فاصله که با درایوری که در حال حاضر به دستگاه متصل است مطابقت می‌یابد، همان‌طور که توسط ویژگی udev به نام
\fIID_NET_DRIVER\fR
دستگاه والد آن، یا در صورت تنظیم نشدن آن، توسط درایور ارائه شده توسط
\fBethtool \-i\fR
خود دستگاه مشخص می‌شود\&. اگر پیشوند فهرست یک علامت "!" باشد، آزمون معکوس می‌شود\&.
.sp
افزوده شده در نسخه 211\&.
.RE
.PP
\fIType=\fR
.RS 4
فهرستی از الگوهای سبک شل جداشده با فاصله که با نوع دستگاه مطابقت می‌یابد، همان‌طور که توسط
\fBnetworkctl list\fR
نمایش داده می‌شود\&. اگر پیشوند فهرست یک علامت "!" باشد، آزمون معکوس می‌شود\&. برخی از مقادیر معتبر عبارتند از
"ether"،
"loopback"،
"wlan"،
"wwan"\&. انواع معتبر یا از ویژگی udev به نام
"DEVTYPE"
یا ماکروهای
"ARPHRD_"
در
linux/if_arp\&.h
نام‌گذاری شده‌اند، بنابراین این فهرست جامع نیست\&.
.sp
افزوده شده در نسخه 211\&.
.RE
.PP
\fIKind=\fR
.RS 4
فهرستی از الگوهای سبک شل جداشده با فاصله که با گونه (kind) دستگاه مطابقت می‌یابد، همان‌طور که توسط
\fBnetworkctl status \fR\fB\fIINTERFACE\fR\fR
یا
\fBip \-d link show \fR\fB\fIINTERFACE\fR\fR
نمایش داده می‌شود\&. اگر پیشوند فهرست یک علامت "!" باشد، آزمون معکوس می‌شود\&. برخی از مقادیر معتبر عبارتند از
"bond"،
"bridge"،
"gre"،
"tun"،
"veth"\&. گونه‌های معتبر توسط ویژگی
"IFLA_INFO_KIND"
در netlink ارائه می‌شوند، بنابراین این فهرست جامع نیست\&.
.sp
افزوده شده در نسخه 251\&.
.RE
.PP
\fIProperty=\fR
.RS 4
فهرستی از نام‌های ویژگی udev به همراه مقادیر آن‌ها پس از علامت مساوی ("=")، جداشده با فاصله\&. اگر چندین ویژگی مشخص شوند، نتایج آزمون با عملگر AND ترکیب می‌شوند\&. اگر پیشوند فهرست یک علامت "!" باشد، آزمون معکوس می‌شود\&. اگر یک مقدار شامل فاصله (whitespace) باشد، لطفاً کل جفت کلید و مقدار را درون علامت نقل‌قول قرار دهید\&. اگر مقداری شامل علامت نقل‌قول است، لطفاً با
"\e"
از علامت نقل‌قول فرار (escape) کنید\&.
.sp
مثال: اگر یک فایل \&.link شامل موارد زیر باشد:
.sp
.if n \{\
.RS 4
.\}
.nf
Property=ID_MODEL_ID=9999 "ID_VENDOR_FROM_DATABASE=vendor name" "KEY=with \e"quotation\e""
.fi
.if n \{\
.RE
.\}
.sp
آنگاه، فایل \&.link تنها زمانی مطابقت دارد که رابط هر سه ویژگی بالا را دارا باشد\&.
.sp
افزوده شده در نسخه 243\&.
.RE
.PP
\fIOriginalName=\fR
.RS 4
فهرستی از الگوهای سبک شل جداشده با فاصله که با نام دستگاه مطابقت می‌یابد، همان‌طور که توسط ویژگی udev به نام "INTERFACE" نمایش داده می‌شود\&. این گزینه را نمی‌توان برای تطبیق روی نام‌هایی که قبلاً از فضای کاربری تغییر یافته‌اند استفاده کرد\&. هنگام تطبیق روی نام‌های تخصیص‌یافته توسط هسته احتیاط توصیه می‌شود، زیرا مشخص است که این نام‌ها در میان راه‌اندازی‌های مجدد (بوت‌ها) ناپایدار هستند\&.
.sp
افزوده شده در نسخه 218\&.
.RE
.PP
\fIHost=\fR
.RS 4
با نام میزبان یا شناسه ماشینِ میزبان مطابقت می‌دهد\&. برای جزئیات،
\fIConditionHost=\fR
در
\fBsystemd.unit\fR(5)
را ببینید\&. هنگامی که با علامت تعجب ("!") پیشوندگذاری شود، نتیجه نفی می‌شود\&. اگر یک رشته خالی اختصاص یابد، مقدار اختصاص‌یافته قبلی پاک می‌شود\&.
.sp
افزوده شده در نسخه 211\&.
.RE
.PP
\fIVirtualization=\fR
.RS 4
بررسی می‌کند که آیا سیستم در یک محیط مجازی‌سازی‌شده اجرا می‌شود یا خیر، و به صورت اختیاری بررسی می‌کند که آیا یک پیاده‌سازی خاص است یا خیر\&. برای جزئیات،
\fIConditionVirtualization=\fR
در
\fBsystemd.unit\fR(5)
را ببینید\&. هنگامی که با علامت تعجب ("!") پیشوندگذاری شود، نتیجه نفی می‌شود\&. اگر یک رشته خالی اختصاص یابد، مقدار اختصاص‌یافته قبلی پاک می‌شود\&.
.sp
افزوده شده در نسخه 211\&.
.RE
.PP
\fIKernelCommandLine=\fR
.RS 4
بررسی می‌کند که آیا یک گزینه خاص در خط فرمان هسته تنظیم شده است یا خیر\&. برای جزئیات،
\fIConditionKernelCommandLine=\fR
در
\fBsystemd.unit\fR(5)
را ببینید\&. هنگامی که با علامت تعجب ("!") پیشوندگذاری شود، نتیجه نفی می‌شود\&. اگر یک رشته خالی اختصاص یابد، مقدار اختصاص‌یافته قبلی پاک می‌شود\&.
.sp
افزوده شده در نسخه 211\&.
.RE
.PP
\fIKernelVersion=\fR
.RS 4
بررسی می‌کند که آیا نسخه هسته (همان‌طور که توسط
\fBuname \-r\fR
گزارش می‌شود) با یک عبارت خاص مطابقت دارد یا خیر\&. برای جزئیات،
\fIConditionKernelVersion=\fR
در
\fBsystemd.unit\fR(5)
را ببینید\&. هنگامی که با علامت تعجب ("!") پیشوندگذاری شود، نتیجه نفی می‌شود\&. اگر یک رشته خالی اختصاص یابد، مقدار اختصاص‌یافته قبلی پاک می‌شود\&.
.sp
افزوده شده در نسخه 237\&.
.RE
.PP
\fIVersion=\fR
.RS 4
بررسی می‌کند که آیا نسخه یک نرم‌افزار با یک عبارت خاص مطابقت دارد یا خیر\&. برای جزئیات،
\fIConditionVersion=\fR
در
\fBsystemd.unit\fR(5)
را ببینید\&. هنگامی که با علامت تعجب ("!") پیشوندگذاری شود، نتیجه نفی می‌شود\&. اگر یک رشته خالی اختصاص یابد، مقدار اختصاص‌یافته قبلی پاک می‌شود\&.
.sp
افزوده شده در نسخه 258\&.
.RE
.PP
\fICredential=\fR
.RS 4
بررسی می‌کند که آیا اعتبارنامه (گواهی‌نامه) مشخص‌شده به سرویس
systemd\-udevd\&.service
ارسال شده است یا خیر\&. برای جزئیات،
\m[blue]\fBاعتبارنامه‌های سیستم و سرویس\fR\m[]\&\s-2\u[2]\d\s+2
را ببینید\&. هنگامی که با علامت تعجب ("!") پیشوندگذاری شود، نتیجه نفی می‌شود\&. اگر یک رشته خالی اختصاص یابد، مقدار اختصاص‌یافته قبلی پاک می‌شود\&.
.sp
افزوده شده در نسخه 252\&.
.RE
.PP
\fIArchitecture=\fR
.RS 4
بررسی می‌کند که آیا سیستم بر روی یک معماری خاص در حال اجرا است یا خیر\&. برای جزئیات،
\fIConditionArchitecture=\fR
در
\fBsystemd.unit\fR(5)
را ببینید\&. هنگامی که با علامت تعجب ("!") پیشوندگذاری شود، نتیجه نفی می‌شود\&. اگر یک رشته خالی اختصاص یابد، مقدار اختصاص‌یافته قبلی پاک می‌شود\&.
.sp
افزوده شده در نسخه 211\&.
.RE
.PP
\fIFirmware=\fR
.RS 4
بررسی می‌کند که آیا سیستم روی ماشینی با میان‌افزار (فِرم‌ور) مشخص‌شده در حال اجرا است یا خیر\&. برای جزئیات،
\fIConditionFirmware=\fR
در
\fBsystemd.unit\fR(5)
را ببینید\&. هنگامی که با علامت تعجب ("!") پیشوندگذاری شود، نتیجه نفی می‌شود\&. اگر یک رشته خالی اختصاص یابد، مقدار اختصاص‌یافته قبلی پاک می‌شود\&.
.sp
افزوده شده در نسخه 249\&.
.RE
.SH "گزینه‌های بخش [LINK] ([LINK] SECTION OPTIONS)"
.PP
بخش [Link] کلیدهای زیر را می‌پذیرد:
.PP
\fIDescription=\fR
.RS 4
توصیفی از دستگاه\&.
.sp
افزوده شده در نسخه 211\&.
.RE
.PP
\fIProperty=\fR
.RS 4
تنظیم ویژگی‌های مشخص‌شدهٔ udev\&. این گزینه فهرستی از جفت‌های کلید\-مقدار جداشده با فاصله را می‌گیرد که با علامت مساوی ("=") به هم متصل شده‌اند\&. مثال:
.sp
.if n \{\
.RS 4
.\}
.nf
Property=HOGE=foo BAR=baz
.fi
.if n \{\
.RE
.\}
.sp
این گزینه از بسط سادهٔ مشخص‌کننده‌ها پشتیبانی می‌کند، بخش «مشخص‌کننده‌ها» در زیر را ببینید\&. این گزینه می‌تواند چندین بار مشخص شود\&. اگر یک رشته خالی اختصاص یابد، تمام تخصیص‌های قبلی پاک می‌شوند\&.
.sp
این تنظیم برای پیکربندی ویژگی
"ID_NET_MANAGED_BY="
مفید است که اعلام می‌کند کدام سرویس مدیریت شبکه باید رابط را مدیریت کند، و توسط
\fBsystemd-networkd\fR(8)
و سایرین رعایت می‌شود\&. از
.sp
.if n \{\
.RS 4
.\}
.nf
Property=ID_NET_MANAGED_BY=io\&.systemd\&.Network
.fi
.if n \{\
.RE
.\}
.sp
استفاده کنید تا صراحتاً اعلام شود که
\fBsystemd\-networkd\fR
باید رابط را مدیریت کند، یا این ویژگی را روی مقدار دیگری تنظیم کنید تا صراحتاً اعلام شود که نباید چنین کند\&. برای جزئیات نحوه استفاده از این ویژگی برای تطبیق نام‌های رابط،
\fBsystemd.network\fR(5)
را ببینید\&.
.sp
افزوده شده در نسخه 256\&.
.RE
.PP
\fIImportProperty=\fR
.RS 4
وارد کردن ویژگی‌های مشخص‌شدهٔ udev از پایگاه داده ذخیره‌شده\&. این گزینه فهرستی از نام‌های ویژگی‌ها را می‌گیرد که با فاصله از هم جدا شده‌اند\&. مثال:
.sp
.if n \{\
.RS 4
.\}
.nf
ImportProperty=HOGE BAR
.fi
.if n \{\
.RE
.\}
.sp
این گزینه از بسط سادهٔ مشخص‌کننده‌ها پشتیبانی می‌کند، بخش «مشخص‌کننده‌ها» در زیر را ببینید\&. این گزینه می‌تواند چندین بار مشخص شود\&. اگر یک رشته خالی اختصاص یابد، تمام تخصیص‌های قبلی پاک می‌شوند\&.
.sp
اگر همان ویژگی در
\fIProperty=\fR
در بالا نیز تنظیم شده باشد، مقدار ویژگی واردشده توسط مقدار مشخص‌شده در
\fIProperty=\fR
رونویسی خواهد شد\&.
.sp
افزوده شده در نسخه 256\&.
.RE
.PP
\fIUnsetProperty=\fR
.RS 4
حذف تنظیم ویژگی‌های مشخص‌شدهٔ udev\&. این گزینه فهرستی از نام‌های ویژگی‌ها را می‌گیرد که با فاصله از هم جدا شده‌اند\&. مثال:
.sp
.if n \{\
.RS 4
.\}
.nf
UnsetProperty=HOGE BAR
.fi
.if n \{\
.RE
.\}
.sp
این گزینه از بسط سادهٔ مشخص‌کننده‌ها پشتیبانی می‌کند، بخش «مشخص‌کننده‌ها» در زیر را ببینید\&. این گزینه می‌تواند چندین بار مشخص شود\&. اگر یک رشته خالی اختصاص یابد، تمام تخصیص‌های قبلی پاک می‌شوند\&.
.sp
این تنظیم پس از اعمال
\fIImportProperty=\fR
و
\fIProperty=\fR
اعمال می‌شود\&. از این رو، اگر همان ویژگی در
\fIImportProperty=\fR
یا
\fIProperty=\fR
مشخص شده باشد، مقدار ویژگی واردشده یا مشخص‌شده نادیده گرفته خواهد شد و تنظیم ویژگی حذف می‌گردد\&.
.sp
افزوده شده در نسخه 256\&.
.RE
.PP
\fIAlias=\fR
.RS 4
ویژگی رابط به نام
\fIifalias\fR
روی این مقدار تنظیم می‌شود\&.
.sp
افزوده شده در نسخه 211\&.
.RE
.PP
\fIMACAddressPolicy=\fR
.RS 4
سیاستی که بر اساس آن آدرس MAC باید تنظیم شود\&. سیاست‌های موجود عبارتند از:
.PP
\fBpersistent\fR
.RS 4
اگر سخت‌افزار دارای یک آدرس MAC پایدار باشد (همان‌طور که بیشتر سخت‌افزارها باید داشته باشند)، و اگر توسط هسته استفاده شود، هیچ اقدامی انجام نمی‌شود\&. در غیر این صورت، یک آدرس MAC جدید تولید می‌شود که تضمین می‌شود در هر بار راه‌اندازی برای ماشین مشخص و دستگاه مشخص یکسان باشد، اما در غیر این صورت تصادفی است\&. این قابلیت وابسته به وجود ویژگی‌های ID_NET_NAME_* برای link است\&. در سخت‌افزارهایی که این ویژگی‌ها تنظیم نشده‌اند، تولید آدرس MAC پایدار با شکست مواجه خواهد شد\&.
.sp
افزوده شده در نسخه 211\&.
.RE
.PP
\fBrandom\fR
.RS 4
اگر هسته از یک آدرس MAC تصادفی استفاده کند، هیچ اقدامی انجام نمی‌شود\&. در غیر این صورت، هر بار که دستگاه ظاهر می‌شود (معمولاً هنگام بوت)، یک آدرس جدید به طور تصادفی تولید می‌شود\&. در هر صورت، آدرس تصادفی دارای بیت‌های
"unicast"
و
"locally administered"
تنظیم‌شده خواهد بود\&.
.sp
افزوده شده در نسخه 211\&.
.RE
.PP
\fBnone\fR
.RS 4
آدرس MAC اختصاص‌داده‌شده توسط هسته را حفظ می‌کند\&. یا از آدرس MAC مشخص‌شده در
\fIMACAddress=\fR
استفاده می‌کند\&.
.sp
افزوده شده در نسخه 227\&.
.RE
.sp
اختصاص یک رشته خالی معادل تنظیم
"none"
است\&.
.sp
افزوده شده در نسخه 211\&.
.RE
.PP
\fIMACAddress=\fR
.RS 4
آدرس MAC رابط برای استفاده\&. برای اینکه این تنظیم اعمال شود،
\fIMACAddressPolicy=\fR
باید یا تنظیم نشده باشد، یا خالی باشد، یا روی
"none"
تنظیم شده باشد\&.
.sp
افزوده شده در نسخه 211\&.
.RE
.PP
\fINamePolicy=\fR
.RS 4
فهرستی مرتب‌شده و جداشده با فاصله از سیاست‌ها که بر اساس آن‌ها نام رابط باید تنظیم شود\&.
\fINamePolicy=\fR
ممکن است با مشخص کردن
\fBnet\&.ifnames=0\fR
در خط فرمان هسته غیرفعال شود\&. هر یک از این سیاست‌ها ممکن است با شکست مواجه شوند و اولین سیاستی که با موفقیت انجام شود استفاده می‌گردد\&. نام به طور مستقیم تنظیم نمی‌شود، بلکه به عنوان ویژگی
\fBID_NET_NAME\fR
به udev صادر می‌شود، که به طور پیش‌فرض توسط یک قاعدهٔ
\fBudev\fR(7)
برای تنظیم
\fINAME\fR
استفاده می‌شود\&. سیاست‌های موجود عبارتند از:
.PP
\fBkernel\fR
.RS 4
اگر هسته ادعا کند نامی که برای دستگاه تنظیم کرده قابل‌پیش‌بینی است، آنگاه هیچ تغییر نامی انجام نمی‌شود\&.
.sp
افزوده شده در نسخه 216\&.
.RE
.PP
\fBdatabase\fR
.RS 4
نام بر اساس مدخل‌های موجود در پایگاه داده سخت‌افزاری udev با کلید
\fIID_NET_NAME_FROM_DATABASE\fR
تنظیم می‌شود\&.
.sp
افزوده شده در نسخه 211\&.
.RE
.PP
\fBonboard\fR
.RS 4
نام بر اساس اطلاعات ارائه‌شده توسط میان‌افزار برای دستگاه‌های روی برد (on\-board) تنظیم می‌شود، همان‌طور که توسط ویژگی udev به نام
\fIID_NET_NAME_ONBOARD\fR
صادر شده است\&.
\fBsystemd.net-naming-scheme\fR(7)
را ببینید\&.
.sp
افزوده شده در نسخه 211\&.
.RE
.PP
\fBslot\fR
.RS 4
نام بر اساس اطلاعات ارائه‌شده توسط میان‌افزار برای دستگاه‌های اتصال گرم (hot\-plug) تنظیم می‌شود، همان‌طور که توسط ویژگی udev به نام
\fIID_NET_NAME_SLOT\fR
صادر شده است\&.
\fBsystemd.net-naming-scheme\fR(7)
را ببینید\&.
.sp
افزوده شده در نسخه 211\&.
.RE
.PP
\fBpath\fR
.RS 4
نام بر اساس موقعیت فیزیکی دستگاه تنظیم می‌شود، همان‌طور که توسط ویژگی udev به نام
\fIID_NET_NAME_PATH\fR
صادر شده است\&.
\fBsystemd.net-naming-scheme\fR(7)
را ببینید\&.
.sp
افزوده شده در نسخه 211\&.
.RE
.PP
\fBmac\fR
.RS 4
نام بر اساس آدرس MAC پایدار دستگاه تنظیم می‌شود، همان‌طور که توسط ویژگی udev به نام
\fIID_NET_NAME_MAC\fR
صادر شده است\&.
\fBsystemd.net-naming-scheme\fR(7)
را ببینید\&.
.sp
افزوده شده در نسخه 211\&.
.RE
.PP
\fBkeep\fR
.RS 4
اگر دستگاه قبلاً نامی داشته که توسط فضای کاربری به آن داده شده است (به عنوان بخشی از ایجاد دستگاه یا تغییر نام)، آن را حفظ می‌کند\&.
.sp
افزوده شده در نسخه 241\&.
.RE
.sp
افزوده شده در نسخه 211\&.
.RE
.PP
\fIName=\fR
.RS 4
نام رابط برای استفاده\&. این گزینه اولویت کمتری نسبت به
\fINamePolicy=\fR
دارد، بنابراین برای اینکه این تنظیم اعمال شود،
\fINamePolicy=\fR
باید تنظیم‌نشده، خالی، غیرفعال باشد، یا تمام سیاست‌های پیکربندی‌شده در آن با شکست مواجه شوند\&. همچنین مثال زیر با
"Name=dmz0"
را ببینید\&.
.sp
توجه داشته باشید که تعیین نامی که ممکن است هسته برای رابط دیگری استفاده کند (برای مثال
"eth0")
خطرناک است زیرا تخصیص نام انجام‌شده توسط udev با تخصیص نام انجام‌شده توسط هسته رقابت می‌کند، و فقط یک رابط می‌تواند از این نام استفاده کند\&. بسته به ترتیب عملیات، یا udev یا هسته برنده خواهد شد، که باعث غیرقابل‌پیش‌بینی شدن نام‌گذاری می‌شود\&. بهتر است از پیشوند متفاوتی استفاده شود، برای مثال
"internal0"/"external0"
یا
"lan0"/"lan1"/"lan3"\&.
.sp
نام‌های رابط باید حداقل طول ۱ نویسه و حداکثر طول ۱۵ نویسه داشته باشند، و می‌توانند شامل هر نویسه ۷ بیتی ASCII باشند، به استثنای نویسه‌های کنترلی،
":"،
"/"
و
"%"\&. در حالی که
"\&."
یک نویسه مجاز است، توصیه می‌شود هنگام نام‌گذاری رابط‌ها از آن خودداری کنید زیرا ابزارهای مختلف (مانند
\fBresolvconf\fR(1))
از آن به عنوان نویسه جداکننده استفاده می‌کنند\&. همچنین، نام‌های رابط کاملاً عددی مجاز نیستند (به منظور جلوگیری از ابهام با مشخص کردن رابط بر اساس نمایه‌های عددی)، و رشته‌های خاص زیر نیز مجاز نیستند:
"\&."،
"\&.\&."،
"all"
و
"default"\&.
.sp
افزوده شده در نسخه 211\&.
.RE
.PP
\fIAlternativeNamesPolicy=\fR
.RS 4
فهرستی جداشده با فاصله از سیاست‌ها که بر اساس آن‌ها باید نام‌های جایگزین رابط تنظیم شوند\&. هر یک از این سیاست‌ها ممکن است با شکست مواجه شوند، و تمام سیاست‌های موفق استفاده می‌شوند\&. سیاست‌های موجود عبارتند از
"database"،
"onboard"،
"slot"،
"path"
و
"mac"\&. اگر هسته از نام‌های جایگزین پشتیبانی نکند، این تنظیم نادیده گرفته خواهد شد\&.
.sp
افزوده شده در نسخه 245\&.
.RE
.PP
\fIAlternativeName=\fR
.RS 4
نام جایگزین رابط برای استفاده\&. این گزینه می‌تواند چندین بار مشخص شود\&. اگر رشته خالی به این گزینه اختصاص داده شود، فهرست بازنشانی می‌شود و تمام تخصیص‌های قبلی بی‌اثر خواهند بود\&. اگر هسته از نام‌های جایگزین پشتیبانی نکند، این تنظیم نادیده گرفته خواهد شد\&.
.sp
نام‌های جایگزین رابط ممکن است برای شناسایی رابط‌ها در ابزارهای مختلف استفاده شوند\&. برخلاف نام اصلی (همان‌طور که با
\fIName=\fR
در بالا پیکربندی می‌شود)، ممکن است چندین نام جایگزین وجود داشته باشد که به همان رابط اشاره می‌کنند\&. نام‌های جایگزین برخلاف ۱۵ نویسه مجاز برای نام اصلی رابط، می‌توانند حداکثر طولی برابر با ۱۲۷ نویسه داشته باشند، اما در غیر این صورت مشمول همان محدودیت‌های نام‌گذاری هستند\&.
.sp
افزوده شده در نسخه 245\&.
.RE
.PP
\fITransmitQueues=\fR
.RS 4
تعداد صف‌های ارسال دستگاه را مشخص می‌کند\&. یک عدد صحیح در محدوده ۱\&...۱۶۳۸۴\&. در صورت تنظیم نشدن، از مقدار پیش‌فرض هسته استفاده خواهد شد\&.
.sp
افزوده شده در نسخه 248\&.
.RE
.PP
\fIReceiveQueues=\fR
.RS 4
تعداد صف‌های دریافت دستگاه را مشخص می‌کند\&. یک عدد صحیح در محدوده ۱\&...۱۶۳۸۴\&. در صورت تنظیم نشدن، از مقدار پیش‌فرض هسته استفاده خواهد شد\&.
.sp
افزوده شده در نسخه 248\&.
.RE
.PP
\fITransmitQueueLength=\fR
.RS 4
طول صف ارسال دستگاه را بر حسب تعداد بسته‌ها مشخص می‌کند\&. یک عدد صحیح بدون علامت در محدوده ۰\&...۴۲۹۴۹۶۷۲۹۴\&. در صورت تنظیم نشدن، از مقدار پیش‌فرض هسته استفاده خواهد شد\&.
.sp
افزوده شده در نسخه 248\&.
.RE
.PP
\fIMTUBytes=\fR
.RS 4
حداکثر واحد انتقال (MTU) بر حسب بایت برای تنظیم روی دستگاه\&. پسوندهای معمول K، M، G پشتیبانی شده و بر مبنای ۱۰۲۴ درک می‌شوند\&.
.sp
افزوده شده در نسخه 211\&.
.RE
.PP
\fIBitsPerSecond=\fR
.RS 4
سرعت تنظیم‌شده برای دستگاه؛ مقدار به نزدیک‌ترین Mbps به سمت پایین گرد می‌شود\&. پسوندهای معمول K، M، G پشتیبانی شده و بر مبنای ۱۰۰۰ درک می‌شوند\&.
.sp
افزوده شده در نسخه 211\&.
.RE
.PP
\fIDuplex=\fR
.RS 4
حالت دوطرفه (Duplex) برای تنظیم روی دستگاه\&. مقادیر پذیرفته‌شده عبارتند از
\fBhalf\fR
(نیمه‌دوطرفه) و
\fBfull\fR
(تمام‌دوطرفه)\&.
.sp
افزوده شده در نسخه 211\&.
.RE
.PP
\fIAutoNegotiation=\fR
.RS 4
یک مقدار بولی می‌گیرد\&. اگر روی yes تنظیم شود، مذاکره خودکار (Auto-negotiation) پارامترهای انتقال فعال می‌شود\&. مذاکره خودکار روشی است که از طریق آن دو دستگاه اترنت متصل‌شده، پارامترهای انتقال مشترک مانند سرعت، حالت دوطرفه و کنترل جریان را انتخاب می‌کنند\&. در صورت تنظیم نشدن، از مقدار پیش‌فرض هسته استفاده خواهد شد\&.
.sp
توجه داشته باشید که اگر مذاکره خودکار فعال باشد، تنظیمات سرعت و حالت دوطرفه فقط‌خواندنی هستند\&. اگر مذاکره خودکار غیرفعال باشد، در صورتی که درایور از چندین حالت پیوند پشتیبانی کند، تنظیمات سرعت و حالت دوطرفه قابل‌نوشتن هستند\&.
.sp
افزوده شده در نسخه 233\&.
.RE
.PP
\fIWakeOnLan=\fR
.RS 4
سیاست بیدارباش از طریق شبکه (Wake\-on\-LAN) برای تنظیم روی دستگاه\&. مقدار ویژه
"off"
را می‌گیرد که Wake\-on\-LAN را غیرفعال می‌کند، یا فهرستی جداشده با فاصله از کلمات زیر:
.PP
\fBphy\fR
.RS 4
بیدارباش با فعالیت PHY\&.
.sp
افزوده شده در نسخه 211\&.
.RE
.PP
\fBunicast\fR
.RS 4
بیدارباش با پیام‌های تک‌پخشی (unicast)\&.
.sp
افزوده شده در نسخه 235\&.
.RE
.PP
\fBmulticast\fR
.RS 4
بیدارباش با پیام‌های چندپخشی (multicast)\&.
.sp
افزوده شده در نسخه 235\&.
.RE
.PP
\fBbroadcast\fR
.RS 4
بیدارباش با پیام‌های همه‌پخشی (broadcast)\&.
.sp
افزوده شده در نسخه 235\&.
.RE
.PP
\fBarp\fR
.RS 4
بیدارباش با ARP\&.
.sp
افزوده شده در نسخه 235\&.
.RE
.PP
\fBmagic\fR
.RS 4
بیدارباش هنگام دریافت بسته جادویی (magic packet)\&.
.sp
افزوده شده در نسخه 211\&.
.RE
.PP
\fBsecureon\fR
.RS 4
فعال‌سازی گذرواژه SecureOn برای MagicPacket\&. زمانی که
\fIWakeOnLanPassword=\fR
مشخص شود به صورت ضمنی اعمال می‌شود\&. اگر بدون گزینه
\fIWakeOnLanPassword=\fR
مشخص شود، گذرواژه از اعتبارنامه (گواهی‌نامه)
"\fILINK\fR\&.link\&.wol\&.password"
(برای مثال
"60\-foo\&.link\&.wol\&.password")
خوانده می‌شود، و اگر اعتبارنامه یافت نشود، از
"wol\&.password"
خوانده می‌شود\&. برای جزئیات،
\fIImportCredential=\fR/\fILoadCredential=\fR/\fISetCredential=\fR
در
\fBsystemd.exec\fR(5)
را ببینید\&. گذرواژه در اعتبارنامه باید ۶ بایت در قالب هگزادسیمال باشد که هر بایت با یک دونقطه (":") مانند آدرس MAC اترنت جدا شده باشد، برای مثال
"aa:bb:cc:dd:ee:ff"\&.
.sp
افزوده شده در نسخه 235\&.
.RE
.sp
پیش‌فرض تنظیم‌نشده است و از مقدار پیش‌فرض دستگاه استفاده خواهد شد\&. این تنظیم می‌تواند چندین بار مشخص شود\&. اگر یک رشته خالی اختصاص داده شود، تمام تخصیص‌های قبلی پاک می‌شوند\&.
.sp
افزوده شده در نسخه 211\&.
.RE
.PP
\fIWakeOnLanPassword=\fR
.RS 4
گذرواژه SecureOn را برای MagicPacket مشخص می‌کند\&. یک مسیر مطلق به یک فایل معمولی یا یک سوکت استریم
\fBAF_UNIX\fR،
یا گذرواژه متنی ساده را می‌پذیرد\&. هنگامی که مسیری به یک فایل معمولی مشخص شود، گذرواژه از آن خوانده می‌شود\&. هنگامی که یک سوکت استریم
\fBAF_UNIX\fR
مشخص شود، اتصالی به آن برقرار شده و گذرواژه از آن خوانده می‌شود\&. گذرواژه باید ۶ بایت در قالب هگزادسیمال باشد که هر بایت با یک دونقطه (":") مانند آدرس MAC اترنت جدا شده باشد، برای مثال
"aa:bb:cc:dd:ee:ff"\&.
این گزینه متضمن
\fIWakeOnLan=secureon\fR
است\&. پیش‌فرض تنظیم‌نشده است و مقدار فعلی تغییر نخواهد کرد\&.
.sp
افزوده شده در نسخه 250\&.
.RE
.PP
\fIPort=\fR
.RS 4
گزینه پورت برای انتخاب درگاه (پورت) دستگاه استفاده می‌شود\&. مقادیر پشتیبانی‌شده عبارتند از:
.PP
\fBtp\fR
.RS 4
یک رابط اترنت با استفاده از کابل زوج‌به‌هم‌تابیده (Twisted\-Pair) به عنوان رسانه\&.
.sp
افزوده شده در نسخه 234\&.
.RE
.PP
\fBaui\fR
.RS 4
رابط واحد اتصال (Attachment Unit Interface یا AUI)\&. معمولاً با هاب‌ها استفاده می‌شود\&.
.sp
افزوده شده در نسخه 234\&.
.RE
.PP
\fBbnc\fR
.RS 4
یک رابط اترنت با استفاده از اتصالات BNC و کابل کواکسیال\&.
.sp
افزوده شده در نسخه 234\&.
.RE
.PP
\fBmii\fR
.RS 4
یک رابط اترنت با استفاده از رابط مستقل از رسانه (Media Independent Interface یا MII)\&.
.sp
افزوده شده در نسخه 234\&.
.RE
.PP
\fBfibre\fR
.RS 4
یک رابط اترنت با استفاده از فیبر نوری به عنوان رسانه\&.
.sp
افزوده شده در نسخه 234\&.
.RE
.sp
افزوده شده در نسخه 234\&.
.RE
.PP
\fIAdvertise=\fR
.RS 4
تعیین می‌کند چه سرعت‌ها و حالت‌های عملکرد دوطرفه‌ای برای مذاکره خودکار اعلان می‌شوند\&. این متضمن
"AutoNegotiation=yes"
است\&. مقادیر پشتیبانی‌شده عبارتند از:
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.B جدول\ \&1.\ \&مقادیر پشتیبانی‌شده برای اعلان
.TS
allbox tab(:);
lB lB lB.
T{
اعلان (Advertise)
T}:T{
سرعت (Mbps)
T}:T{
حالت دوطرفه (Duplex)
T}
.T&
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l.
T{
\fB10baset\-full\fR
T}:T{
10
T}:T{
full
T}
T{
\fB10baset1brr\-full\fR
T}:T{
10
T}:T{
full
T}
T{
\fB10baset1l\-full\fR
T}:T{
10
T}:T{
full
T}
T{
\fB10baset1s\-full\fR
T}:T{
10
T}:T{
full
T}
T{
\fB10baset\-half\fR
T}:T{
10
T}:T{
half
T}
T{
\fB10baset1s\-half\fR
T}:T{
10
T}:T{
half
T}
T{
\fB10baset1s\-p2mp\-half\fR
T}:T{
10
T}:T{
half
T}
T{
\fB100basefx\-full\fR
T}:T{
100
T}:T{
full
T}
T{
\fB100baset\-full\fR
T}:T{
100
T}:T{
full
T}
T{
\fB100baset1\-full\fR
T}:T{
100
T}:T{
full
T}
T{
\fB100basefx\-half\fR
T}:T{
100
T}:T{
half
T}
T{
\fB100baset\-half\fR
T}:T{
100
T}:T{
half
T}
T{
\fB1000basekx\-full\fR
T}:T{
1000
T}:T{
full
T}
T{
\fB1000baset\-full\fR
T}:T{
1000
T}:T{
full
T}
T{
\fB1000baset1\-full\fR
T}:T{
1000
T}:T{
full
T}
T{
\fB1000basex\-full\fR
T}:T{
1000
T}:T{
full
T}
T{
\fB1000baset\-half\fR
T}:T{
1000
T}:T{
half
T}
T{
\fB2500baset\-full\fR
T}:T{
2500
T}:T{
full
T}
T{
\fB2500basex\-full\fR
T}:T{
2500
T}:T{
full
T}
T{
\fB5000baset\-full\fR
T}:T{
5000
T}:T{
full
T}
T{
\fB10000baser\-fec\fR
T}:T{
10000
T}:T{
\ \&
T}
T{
\fB10000basecr\-full\fR
T}:T{
10000
T}:T{
full
T}
T{
\fB10000baseer\-full\fR
T}:T{
10000
T}:T{
full
T}
T{
\fB10000basekr\-full\fR
T}:T{
10000
T}:T{
full
T}
T{
\fB10000basekx4\-full\fR
T}:T{
10000
T}:T{
full
T}
T{
\fB10000baselr\-full\fR
T}:T{
10000
T}:T{
full
T}
T{
\fB10000baselrm\-full\fR
T}:T{
10000
T}:T{
full
T}
T{
\fB10000basesr\-full\fR
T}:T{
10000
T}:T{
full
T}
T{
\fB10000baset\-full\fR
T}:T{
10000
T}:T{
full
T}
T{
\fB20000basekr2\-full\fR
T}:T{
20000
T}:T{
full
T}
T{
\fB20000basemld2\-full\fR
T}:T{
20000
T}:T{
full
T}
T{
\fB25000basecr\-full\fR
T}:T{
25000
T}:T{
full
T}
T{
\fB25000basekr\-full\fR
T}:T{
25000
T}:T{
full
T}
T{
\fB25000basesr\-full\fR
T}:T{
25000
T}:T{
full
T}
T{
\fB40000basecr4\-full\fR
T}:T{
40000
T}:T{
full
T}
T{
\fB40000basekr4\-full\fR
T}:T{
40000
T}:T{
full
T}
T{
\fB40000baselr4\-full\fR
T}:T{
40000
T}:T{
full
T}
T{
\fB40000basesr4\-full\fR
T}:T{
40000
T}:T{
full
T}
T{
\fB50000basecr\-full\fR
T}:T{
50000
T}:T{
full
T}
T{
\fB50000basecr2\-full\fR
T}:T{
50000
T}:T{
full
T}
T{
\fB50000basedr\-full\fR
T}:T{
50000
T}:T{
full
T}
T{
\fB50000basekr\-full\fR
T}:T{
50000
T}:T{
full
T}
T{
\fB50000basekr2\-full\fR
T}:T{
50000
T}:T{
full
T}
T{
\fB50000baselr\-er\-fr\-full\fR
T}:T{
50000
T}:T{
full
T}
T{
\fB50000basesr\-full\fR
T}:T{
50000
T}:T{
full
T}
T{
\fB50000basesr2\-full\fR
T}:T{
50000
T}:T{
full
T}
T{
\fB56000basecr4\-full\fR
T}:T{
56000
T}:T{
full
T}
T{
\fB56000basekr4\-full\fR
T}:T{
56000
T}:T{
full
T}
T{
\fB56000baselr4\-full\fR
T}:T{
56000
T}:T{
full
T}
T{
\fB56000basesr4\-full\fR
T}:T{
56000
T}:T{
full
T}
T{
\fB100000basecr\-full\fR
T}:T{
100000
T}:T{
full
T}
T{
\fB100000basecr2\-full\fR
T}:T{
100000
T}:T{
full
T}
T{
\fB100000basecr4\-full\fR
T}:T{
100000
T}:T{
full
T}
T{
\fB100000basedr\-full\fR
T}:T{
100000
T}:T{
full
T}
T{
\fB100000basedr2\-full\fR
T}:T{
100000
T}:T{
full
T}
T{
\fB100000basekr\-full\fR
T}:T{
100000
T}:T{
full
T}
T{
\fB100000basekr2\-full\fR
T}:T{
100000
T}:T{
full
T}
T{
\fB100000basekr4\-full\fR
T}:T{
100000
T}:T{
full
T}
T{
\fB100000baselr\-er\-fr\-full\fR
T}:T{
100000
T}:T{
full
T}
T{
\fB100000baselr2\-er2\-fr2\-full\fR
T}:T{
100000
T}:T{
full
T}
T{
\fB100000baselr4\-er4\-full\fR
T}:T{
100000
T}:T{
full
T}
T{
\fB100000basesr\-full\fR
T}:T{
100000
T}:T{
full
T}
T{
\fB100000basesr2\-full\fR
T}:T{
100000
T}:T{
full
T}
T{
\fB100000basesr4\-full\fR
T}:T{
100000
T}:T{
full
T}
T{
\fB200000basecr\-full\fR
T}:T{
200000
T}:T{
full
T}
T{
\fB200000basecr2\-full\fR
T}:T{
200000
T}:T{
full
T}
T{
\fB200000basecr4\-full\fR
T}:T{
200000
T}:T{
full
T}
T{
\fB200000basedr\-2\-full\fR
T}:T{
200000
T}:T{
full
T}
T{
\fB200000basedr\-full\fR
T}:T{
200000
T}:T{
full
T}
T{
\fB200000basedr2\-full\fR
T}:T{
200000
T}:T{
full
T}
T{
\fB200000basedr4\-full\fR
T}:T{
200000
T}:T{
full
T}
T{
\fB200000basekr\-full\fR
T}:T{
200000
T}:T{
full
T}
T{
\fB200000basekr2\-full\fR
T}:T{
200000
T}:T{
full
T}
T{
\fB200000basekr4\-full\fR
T}:T{
200000
T}:T{
full
T}
T{
\fB200000baselr2\-er2\-fr2\-full\fR
T}:T{
200000
T}:T{
full
T}
T{
\fB200000baselr4\-er4\-fr4\-full\fR
T}:T{
200000
T}:T{
full
T}
T{
\fB200000basesr\-full\fR
T}:T{
200000
T}:T{
full
T}
T{
\fB200000basesr2\-full\fR
T}:T{
200000
T}:T{
full
T}
T{
\fB200000basesr4\-full\fR
T}:T{
200000
T}:T{
full
T}
T{
\fB200000basevr\-full\fR
T}:T{
200000
T}:T{
full
T}
T{
\fB400000basecr2\-full\fR
T}:T{
400000
T}:T{
full
T}
T{
\fB400000basecr4\-full\fR
T}:T{
400000
T}:T{
full
T}
T{
\fB400000basecr8\-full\fR
T}:T{
400000
T}:T{
full
T}
T{
\fB400000basedr2\-2\-full\fR
T}:T{
400000
T}:T{
full
T}
T{
\fB400000basedr2\-full\fR
T}:T{
400000
T}:T{
full
T}
T{
\fB400000basedr4\-full\fR
T}:T{
400000
T}:T{
full
T}
T{
\fB400000basedr8\-full\fR
T}:T{
400000
T}:T{
full
T}
T{
\fB400000basekr2\-full\fR
T}:T{
400000
T}:T{
full
T}
T{
\fB400000basekr4\-full\fR
T}:T{
400000
T}:T{
full
T}
T{
\fB400000basekr8\-full\fR
T}:T{
400000
T}:T{
full
T}
T{
\fB400000baselr4\-er4\-fr4\-full\fR
T}:T{
400000
T}:T{
full
T}
T{
\fB400000baselr8\-er8\-fr8\-full\fR
T}:T{
400000
T}:T{
full
T}
T{
\fB400000basesr2\-full\fR
T}:T{
400000
T}:T{
full
T}
T{
\fB400000basesr4\-full\fR
T}:T{
400000
T}:T{
full
T}
T{
\fB400000basesr8\-full\fR
T}:T{
400000
T}:T{
full
T}
T{
\fB400000basevr2\-full\fR
T}:T{
400000
T}:T{
full
T}
T{
\fB800000basecr4\-full\fR
T}:T{
800000
T}:T{
full
T}
T{
\fB800000basecr8\-full\fR
T}:T{
800000
T}:T{
full
T}
T{
\fB800000basedr4\-2\-full\fR
T}:T{
800000
T}:T{
full
T}
T{
\fB800000basedr4\-full\fR
T}:T{
800000
T}:T{
full
T}
T{
\fB800000basedr8\-2\-full\fR
T}:T{
800000
T}:T{
full
T}
T{
\fB800000basedr8\-full\fR
T}:T{
800000
T}:T{
full
T}
T{
\fB800000basekr4\-full\fR
T}:T{
800000
T}:T{
full
T}
T{
\fB800000basekr8\-full\fR
T}:T{
800000
T}:T{
full
T}
T{
\fB800000basesr4\-full\fR
T}:T{
800000
T}:T{
full
T}
T{
\fB800000basesr8\-full\fR
T}:T{
800000
T}:T{
full
T}
T{
\fB800000basevr4\-full\fR
T}:T{
800000
T}:T{
full
T}
T{
\fB800000basevr8\-full\fR
T}:T{
800000
T}:T{
full
T}
T{
\fB1600000basecr8\-full\fR
T}:T{
1600000
T}:T{
full
T}
T{
\fB1600000basedr8\-2\-full\fR
T}:T{
1600000
T}:T{
full
T}
T{
\fB1600000basedr8\-full\fR
T}:T{
1600000
T}:T{
full
T}
T{
\fB1600000basekr8\-full\fR
T}:T{
1600000
T}:T{
full
T}
T{
\fBasym\-pause\fR
T}:T{
\ \&
T}:T{
\ \&
T}
T{
\fBaui\fR
T}:T{
\ \&
T}:T{
\ \&
T}
T{
\fBautonegotiation\fR
T}:T{
\ \&
T}:T{
\ \&
T}
T{
\fBbackplane\fR
T}:T{
\ \&
T}:T{
\ \&
T}
T{
\fBbnc\fR
T}:T{
\ \&
T}:T{
\ \&
T}
T{
\fBfec\-baser\fR
T}:T{
\ \&
T}:T{
\ \&
T}
T{
\fBfec\-llrs\fR
T}:T{
\ \&
T}:T{
\ \&
T}
T{
\fBfec\-none\fR
T}:T{
\ \&
T}:T{
\ \&
T}
T{
\fBfec\-rs\fR
T}:T{
\ \&
T}:T{
\ \&
T}
T{
\fBfibre\fR
T}:T{
\ \&
T}:T{
\ \&
T}
T{
\fBmii\fR
T}:T{
\ \&
T}:T{
\ \&
T}
T{
\fBpause\fR
T}:T{
\ \&
T}:T{
\ \&
T}
T{
\fBtp\fR
T}:T{
\ \&
T}:T{
\ \&
T}
.TE
.sp 1
به طور پیش‌فرض، این گزینه تنظیم نشده است، یعنی تمام حالت‌های ممکن اعلان خواهند شد\&. این گزینه ممکن است بیش از یک بار مشخص شود که در این صورت تمام سرعت‌ها و حالت‌های مشخص‌شده اعلان می‌شوند\&. اگر یک رشته خالی به این گزینه اختصاص یابد، فهرست بازنشانی شده و تمام تخصیص‌های قبلی بی‌اثر خواهند بود\&.
.sp
افزوده شده در نسخه 240\&.
.RE
.PP
\fIReceiveChecksumOffload=\fR
.RS 4
یک مقدار بولی می‌گیرد\&. اگر روی true تنظیم شود، تخلیه بار سخت‌افزاری (hardware offload) برای محاسبه مجموع مقابله‌ای (checksum) بسته‌های شبکه ورودی (ingress) فعال می‌شود\&. در صورت تنظیم نشدن، از مقدار پیش‌فرض هسته استفاده خواهد شد\&.
.sp
افزوده شده در نسخه 245\&.
.RE
.PP
\fITransmitChecksumOffload=\fR
.RS 4
یک مقدار بولی می‌گیرد\&. اگر روی true تنظیم شود، تخلیه بار سخت‌افزاری برای محاسبه مجموع مقابله‌ای بسته‌های شبکه خروجی (egress) فعال می‌شود\&. در صورت تنظیم نشدن، از مقدار پیش‌فرض هسته استفاده خواهد شد\&.
.sp
افزوده شده در نسخه 245\&.
.RE
.PP
\fIScatterGather=\fR
.RS 4
یک مقدار بولی می‌گیرد\&. اگر روی true تنظیم شود، قابلیت تخلیه باری را فعال می‌کند که در آن سخت‌افزار یک بسته شبکه را از چندین بافر حافظه غیرپیوسته می‌سازد\&. در صورت تنظیم نشدن، از مقدار پیش‌فرض هسته استفاده خواهد شد\&. این متناظر با دستور
\fBethtool \-K \fR\fB\fIINTERFACE\fR\fR\fB tx\-scatter\-gather on|off\fR
است\&.
.sp
افزوده شده در نسخه 260\&.
.RE
.PP
\fIScatterGatherFragmentList=\fR
.RS 4
یک مقدار بولی می‌گیرد\&. اگر روی true تنظیم شود، قابلیت تخلیه باری را فعال می‌کند که در آن سخت‌افزار یک بسته شبکه را از فهرستی زنجیره‌ای از بافرهای سوکت می‌سازد\&. در صورت تنظیم نشدن، از مقدار پیش‌فرض هسته استفاده خواهد شد\&. این متناظر با دستور
\fBethtool \-K \fR\fB\fIINTERFACE\fR\fR\fB tx\-scatter\-gather\-fraglist on|off\fR
است\&.
.sp
افزوده شده در نسخه 260\&.
.RE
.PP
\fITCPSegmentationOffload=\fR
.RS 4
یک مقدار بولی می‌گیرد\&. اگر روی true تنظیم شود، تخلیه بار قطعه‌بندی TCP (یا TSO) فعال می‌شود\&. در صورت تنظیم نشدن، از مقدار پیش‌فرض هسته استفاده خواهد شد\&.
.sp
افزوده شده در نسخه 232\&.
.RE
.PP
\fITCPECNSegmentationOffload=\fR
.RS 4
یک مقدار بولی می‌گیرد\&. اگر روی true تنظیم شود، تخلیه بار قطعه‌بندی TCP (یا TSO) حتی زمانی که پرچم‌های ECN (اعلان صریح ازدحام) در جریان TCP فعال باشند، انجام می‌شود\&. در صورت تنظیم نشدن، از مقدار پیش‌فرض هسته استفاده خواهد شد\&. این متناظر با دستور
\fBethtool \-K \fR\fB\fIINTERFACE\fR\fR\fB tx\-tcp\-ecn\-segmentation on|off\fR
است\&.
.sp
افزوده شده در نسخه 260\&.
.RE
.PP
\fITCPMangleIdSegmentationOffload=\fR
.RS 4
یک مقدار بولی می‌گیرد\&. اگر روی true تنظیم شود، تخلیه بار قطعه‌بندی TCP (یا TSO) حتی اگر سخت‌افزار قادر به افزایش صحیح فیلد شناسه (ID) پروتکل IPv4 برای هر بسته حاصل نباشد، انجام می‌شود\&. در صورت تنظیم نشدن، از مقدار پیش‌فرض هسته استفاده خواهد شد\&. این متناظر با دستور
\fBethtool \-K \fR\fB\fIINTERFACE\fR\fR\fB tx\-tcp\-mangleid\-segmentation on|off\fR
است\&.
.sp
افزوده شده در نسخه 260\&.
.RE
.PP
\fITCP6SegmentationOffload=\fR
.RS 4
یک مقدار بولی می‌گیرد\&. اگر روی true تنظیم شود، تخلیه بار قطعه‌بندی TCP6 (یعنی tx\-tcp6\-segmentation) فعال می‌شود\&. در صورت تنظیم نشدن، از مقدار پیش‌فرض هسته استفاده خواهد شد\&.
.sp
افزوده شده در نسخه 235\&.
.RE
.PP
\fIGenericSegmentationOffload=\fR
.RS 4
یک مقدار بولی می‌گیرد\&. اگر روی true تنظیم شود، تخلیه بار قطعه‌بندی عمومی (GSO) فعال می‌شود\&. در صورت تنظیم نشدن، از مقدار پیش‌فرض هسته استفاده خواهد شد\&.
.sp
افزوده شده در نسخه 232\&.
.RE
.PP
\fIPartialGenericSegmentationOffload=\fR
.RS 4
یک مقدار بولی می‌گیرد\&. اگر روی true تنظیم شود، تخلیه بار قطعه‌بندی عمومی جزئی (GSO_Partial) فعال می‌شود\&. برای جزئیات بیشتر،
\m[blue]\fBتخلیه بار قطعه‌بندی عمومی جزئی\fR\m[]\&\s-2\u[3]\d\s+2
را ببینید\&. در صورت تنظیم نشدن، از مقدار پیش‌فرض هسته استفاده خواهد شد\&.
.sp
افزوده شده در نسخه 258\&.
.RE
.PP
\fIGenericReceiveOffload=\fR
.RS 4
یک مقدار بولی می‌گیرد\&. اگر روی true تنظیم شود، تخلیه بار دریافت عمومی (GRO) فعال می‌شود\&. در صورت تنظیم نشدن، از مقدار پیش‌فرض هسته استفاده خواهد شد\&.
.sp
افزوده شده در نسخه 232\&.
.RE
.PP
\fIGenericReceiveOffloadHardware=\fR
.RS 4
یک مقدار بولی می‌گیرد\&. اگر روی true تنظیم شود، تخلیه بار دریافت عمومی با شتاب‌دهنده سخت‌افزاری (GRO) فعال می‌شود\&. در صورت تنظیم نشدن، از مقدار پیش‌فرض هسته استفاده خواهد شد\&.
.sp
افزوده شده در نسخه 250\&.
.RE
.PP
\fIGenericReceiveOffloadList=\fR
.RS 4
یک مقدار بولی می‌گیرد\&. اگر روی true تنظیم شود، فهرست تخلیه بار دریافت عمومی (GRO List) برای UDP فعال می‌شود\&. در صورت تنظیم نشدن، از مقدار پیش‌فرض هسته استفاده خواهد شد\&. این متناظر با دستور
\fBethtool \-K \fR\fB\fIINTERFACE\fR\fR\fB rx\-gro\-list on|off\fR
است\&.
.sp
افزوده شده در نسخه 260\&.
.RE
.PP
\fIGenericReceiveOffloadUDPForwarding=\fR
.RS 4
یک مقدار بولی می‌گیرد\&. اگر روی true تنظیم شود، تخلیه بار دریافت عمومی (GRO) برای تجمیع بسته‌های UDP ورودی فعال می‌شود\&. در صورت تنظیم نشدن، از مقدار پیش‌فرض هسته استفاده خواهد شد\&. این متناظر با دستور
\fBethtool \-K \fR\fB\fIINTERFACE\fR\fR\fB rx\-udp\-gro\-forwarding on|off\fR
است\&.
.sp
افزوده شده در نسخه 260\&.
.RE
.PP
\fILargeReceiveOffload=\fR
.RS 4
یک مقدار بولی می‌گیرد\&. اگر روی true تنظیم شود، تخلیه بار دریافت بزرگ (LRO) فعال می‌شود\&. در صورت تنظیم نشدن، از مقدار پیش‌فرض هسته استفاده خواهد شد\&.
.sp
افزوده شده در نسخه 232\&.
.RE
.PP
\fIReceivePacketSteeringCPUMask=\fR
.RS 4
فهرست CPUهای هدایت بسته دریافتی (RPS) را که RPS ممکن است ترافیک را به آن‌ها فوروارد کند، پیکربندی می‌کند\&. فهرستی از نمایه‌ها یا محدوده‌های CPU را می‌گیرد که با فاصله یا کاما از هم جدا شده‌اند\&. متناوباً، مقدار ویژه
"all"
را می‌گیرد که تمام CPUهای موجود را در ماسک شامل می‌کند\&. محدوده‌های CPU با نمایه‌های CPU پایینی و بالایی جداشده با خط تیره مشخص می‌شوند (برای مثال
"2\-6")\&. این گزینه ممکن است بیش از یک بار مشخص شود که در این صورت فهرست محدوده‌های CPU مشخص‌شده ادغام می‌شوند\&. اگر یک رشته خالی اختصاص یابد، فهرست بازنشانی شده و تمام تخصیص‌های قبلی بی‌اثر خواهند بود\&. پیش‌فرض تنظیم‌نشده است و فهرست CPU مربوط به RPS بدون تغییر باقی می‌ماند\&. برای غیرفعال کردن RPS در صورتی که قبلاً فعال بوده است، از مقدار ویژه
"disable"
استفاده کنید\&.
.sp
افزوده شده در نسخه 256\&.
.RE
.PP
\fIIRQAffinityPolicy=\fR
.RS 4
راهبرد توزیع IRQ را برای وقفه‌های MSI/MSI\-X رابط شبکه مشخص می‌کند\&. یکی از مقادیر
"spread"
یا
"single"
را می‌گیرد\&. هنگامی که روی
"spread"
تنظیم شود، IRQهای صف با استفاده از الگوریتم حداکثر فاصله آگاه از توپولوژی توزیع می‌شوند که CPUهای روی گره‌های NUMA مختلف، سپس هسته‌های فیزیکی مختلف، و سپس هایپرتِرِدهای (hyperthreads) مختلف را ترجیح می‌دهد\&. هنگامی که روی
"single"
تنظیم شود، تمام IRQها به یک CPU واحد پین می‌شوند (به طور پیش‌فرض CPU 0، یا اولین CPU در مجموعه مشخص‌شده توسط
\fIIRQAffinity=\fR)\&.
هنگامی که تعداد IRQها بیشتر از CPUهای در دسترس باشد، صف‌ها با استفاده از تخصیص نوبتی (round\-robin) دور می‌زنند\&. در صورت تنظیم نشدن، هیچ مدیریت وابستگی (affinity) انجام نمی‌شود\&. تنظیم این گزینه روی یک رشته خالی صراحتاً مدیریت وابستگی را غیرفعال می‌کند\&.
.sp
این گزینه فقط برای دستگاه‌هایی با وقفه‌های MSI/MSI\-X که از طریق
/sys/class/net/\fIiface\fR/device/msi_irqs/
قابل‌شناسایی هستند اعمال می‌شود\&. دستگاه‌های مجازی (veth، tap) و دستگاه‌های سنتی INTx با ثبت یک اعلان نادیده گرفته می‌شوند\&.
.sp
توجه داشته باشید که اگر
\fBirqbalance\fR(1)
یا دیمن‌های مدیریت IRQ مشابه در حال اجرا باشند، ممکن است وابستگی پیکربندی‌شده را بازنویسی کنند\&. غیرفعال کردن چنین دیمن‌هایی یا پیکربندی آن‌ها برای مستثنی کردن رابط‌های تحت مدیریت را در نظر بگیرید\&.
.sp
افزوده شده در نسخه 260\&.
.RE
.PP
\fIIRQAffinity=\fR
.RS 4
مجموعه CPUهای واجد شرایط برای تخصیص IRQ را فیلتر می‌کند\&. فهرستی از نمایه‌ها یا محدوده‌های CPU را می‌پذیرد که با فاصله یا ویرگول جدا شده‌اند (برای مثال،
"0\-3"،
"0,2,4,6"،
"0\-3,8\-11")\&. این گزینه همراه با
\fIIRQAffinityPolicy=\fR
و
\fIIRQAffinityNUMA=\fR
کار می‌کند تا مشخص کند کدام CPUها IRQهای شبکه را دریافت کنند\&. هنگامی که با سیاست
"spread"
مشخص شود، فقط CPUهای فهرست‌شده برای توزیع IRQ در نظر گرفته می‌شوند\&. هنگامی که با سیاست
"single"
مشخص شود، IRQها به جای CPU 0 به اولین CPU در مجموعه مجاز پین می‌شوند\&. اگر
\fIIRQAffinityPolicy=\fR
تنظیم نشده باشد، هیچ اثری ندارد\&.
.sp
افزوده شده در نسخه 260\&.
.RE
.PP
\fIIRQAffinityNUMA=\fR
.RS 4
CPUها را به مواردی که به گره NUMA مشخص‌شده تعلق دارند فیلتر می‌کند\&. مقدار
"local"
یا یک شماره گره NUMA صریح (0، 1، 2، \&.\&.\&.) را می‌گیرد\&. هنگامی که روی
"local"
تنظیم شود، گره NUMA محلی برای اسلات PCIe کارت شبکه (NIC) استفاده می‌شود (تعیین‌شده از
/sys/class/net/\fIiface\fR/device/numa_node)\&. اگر گره NUMA دستگاه قابل تعیین نباشد (برای مثال در سیستم‌های غیر NUMA)، یک هشدار ثبت شده و از پیکربندی وابستگی IRQ صرف‌نظر می‌شود\&.
.sp
هنگامی که هر دو گزینهٔ
\fIIRQAffinity=\fR
و
\fIIRQAffinityNUMA=\fR
مشخص شوند، اشتراک آن‌ها استفاده می‌شود\&. اگر اشتراک منجر به یک مجموعه خالی شود، یک خطا ثبت شده و هیچ وابستگی اعمال نمی‌شود\&. اگر
\fIIRQAffinityPolicy=\fR
تنظیم نشده باشد، هیچ اثری ندارد\&.
.sp
افزوده شده در نسخه 260\&.
.RE
.PP
\fIReceiveVLANCTAGHardwareAcceleration=\fR
.RS 4
یک مقدار بولی می‌گیرد\&. اگر روی true تنظیم شود، شتاب‌دهنده سخت‌افزاری دریافت VLAN CTAG فعال می‌شود\&. در صورت تنظیم نشدن، از مقدار پیش‌فرض هسته استفاده خواهد شد\&.
.sp
افزوده شده در نسخه 250\&.
.RE
.PP
\fITransmitVLANCTAGHardwareAcceleration=\fR
.RS 4
یک مقدار بولی می‌گیرد\&. اگر روی true تنظیم شود، شتاب‌دهنده سخت‌افزاری ارسال VLAN CTAG فعال می‌شود\&. در صورت تنظیم نشدن، از مقدار پیش‌فرض هسته استفاده خواهد شد\&.
.sp
افزوده شده در نسخه 250\&.
.RE
.PP
\fIReceiveVLANCTAGFilter=\fR
.RS 4
یک مقدار بولی می‌گیرد\&. اگر روی true تنظیم شود، فیلتر کردن دریافت روی VLAN CTAGها فعال می‌شود\&. در صورت تنظیم نشدن، از مقدار پیش‌فرض هسته استفاده خواهد شد\&.
.sp
افزوده شده در نسخه 250\&.
.RE
.PP
\fITransmitVLANSTAGHardwareAcceleration=\fR
.RS 4
یک مقدار بولی می‌گیرد\&. اگر روی true تنظیم شود، شتاب‌دهنده سخت‌افزاری ارسال VLAN STAG فعال می‌شود\&. در صورت تنظیم نشدن، از مقدار پیش‌فرض هسته استفاده خواهد شد\&.
.sp
افزوده شده در نسخه 250\&.
.RE
.PP
\fINTupleFilter=\fR
.RS 4
یک مقدار بولی می‌گیرد\&. اگر روی true تنظیم شود، فیلترها و کنش‌های دریافت N\-tuple فعال می‌شوند\&. در صورت تنظیم نشدن، از مقدار پیش‌فرض هسته استفاده خواهد شد\&.
.sp
افزوده شده در نسخه 250\&.
.RE
.PP
\fIReceiveFCS=\fR
.RS 4
یک مقدار بولی می‌گیرد\&. اگر روی true تنظیم شود، مقدار توالی بررسی فریم (Frame Check Sequence یا FCS) بدون کوتاه کردن آن به بالای پشته ارسال می‌شود، و به فضای کاربری اجازه می‌دهد نرخ خطا یا سلامت پیوند را محاسبه کند\&. در صورت تنظیم نشدن، از مقدار پیش‌فرض هسته استفاده خواهد شد\&.
.sp
افزوده شده در نسخه 258\&.
.RE
.PP
\fIReceiveAll=\fR
.RS 4
یک مقدار بولی می‌گیرد\&. اگر روی true تنظیم شود، به رابط اجازه می‌دهد فریم‌های اترنت آسیب‌دیده را نیز دریافت کند\&. در صورت تنظیم نشدن، از مقدار پیش‌فرض هسته استفاده خواهد شد\&.
.sp
افزوده شده در نسخه 258\&.
.RE
.PP
\fIRxChannels=\fR, \fITxChannels=\fR, \fIOtherChannels=\fR, \fICombinedChannels=\fR
.RS 4
تعداد کانال‌های دریافت، ارسال، سایر یا ترکیبی را به ترتیب مشخص می‌کند\&. یک عدد صحیح بدون علامت در محدوده ۱\&...۴۲۹۴۹۶۷۲۹۵ یا
"max"
را می‌گیرد\&. اگر روی
"max"
تنظیم شود، حداکثر مقدار اعلام‌شده توسط سخت‌افزار استفاده خواهد شد\&. در صورت تنظیم نشدن، عدد تغییر نخواهد کرد\&. پیش‌فرض تنظیم‌نشده است\&.
.sp
افزوده شده در نسخه 239\&.
.RE
.PP
\fIRxBufferSize=\fR, \fIRxMiniBufferSize=\fR, \fIRxJumboBufferSize=\fR, \fITxBufferSize=\fR
.RS 4
حداکثر تعداد بسته‌های معلق در بافر دریافت NIC، بافر دریافت مینی، بافر دریافت جامبو، یا بافر ارسال را به ترتیب مشخص می‌کند\&. یک عدد صحیح بدون علامت در محدوده ۱\&...۴۲۹۴۹۶۷۲۹۵ یا
"max"
را می‌گیرد\&. اگر روی
"max"
تنظیم شود، حداکثر مقدار اعلام‌شده توسط سخت‌افزار استفاده خواهد شد\&. در صورت تنظیم نشدن، عدد تغییر نخواهد کرد\&. پیش‌فرض تنظیم‌نشده است\&.
.sp
افزوده شده در نسخه 244\&.
.RE
.PP
\fIRxFlowControl=\fR
.RS 4
یک مقدار بولی می‌گیرد\&. در صورت تنظیم، کنترل جریان دریافت را فعال می‌کند، که به عنوان پیام PAUSE دریافت اترنت نیز شناخته می‌شود (تولید و ارسال فریم‌های PAUSE اترنت)\&. در صورت تنظیم نشدن، از مقدار پیش‌فرض هسته استفاده خواهد شد\&.
.sp
افزوده شده در نسخه 246\&.
.RE
.PP
\fITxFlowControl=\fR
.RS 4
یک مقدار بولی می‌گیرد\&. در صورت تنظیم، کنترل جریان ارسال را فعال می‌کند، که به عنوان پیام PAUSE ارسال اترنت نیز شناخته می‌شود (پاسخ دادن به فریم‌های PAUSE دریافت‌شدهٔ اترنت)\&. در صورت تنظیم نشدن، از مقدار پیش‌فرض هسته استفاده خواهد شد\&.
.sp
افزوده شده در نسخه 246\&.
.RE
.PP
\fIAutoNegotiationFlowControl=\fR
.RS 4
یک مقدار بولی می‌گیرد\&. در صورت تنظیم، مذاکره خودکار به رابط امکان می‌دهد تا اعلان‌های وضعیت را با دستگاه متصل‌شده مبادله کند تا دو دستگاه بتوانند در مورد پیکربندی PAUSE اترنت به توافق برسند\&. در صورت تنظیم نشدن، از مقدار پیش‌فرض هسته استفاده خواهد شد\&.
.sp
افزوده شده در نسخه 246\&.
.RE
.PP
\fIGenericSegmentOffloadMaxBytes=\fR
.RS 4
حداکثر اندازه بسته تخلیه بار قطعه‌بندی عمومی (GSO) را که دستگاه باید بپذیرد، مشخص می‌کند\&. پسوندهای معمول K، M، G پشتیبانی شده و بر مبنای ۱۰۲۴ درک می‌شوند\&. یک عدد صحیح بدون علامت در محدوده ۱\&...۶۵۵۳۶\&. پیش‌فرض تنظیم‌نشده است\&.
.sp
افزوده شده در نسخه 248\&.
.RE
.PP
\fIGenericSegmentOffloadMaxSegments=\fR
.RS 4
حداکثر تعداد بخش‌های تخلیه بار قطعه‌بندی عمومی (GSO) را که دستگاه باید بپذیرد، مشخص می‌کند\&. یک عدد صحیح بدون علامت در محدوده ۱\&...۶۵۵۳۵\&. پیش‌فرض تنظیم‌نشده است\&.
.sp
افزوده شده در نسخه 248\&.
.RE
.PP
\fIUseAdaptiveRxCoalesce=\fR, \fIUseAdaptiveTxCoalesce=\fR
.RS 4
ویژگی‌های بولی که در صورت تنظیم، تجمیع وقفه (coalescing) تطبیقی Rx/Tx را در صورتی که سخت‌افزار از آن پشتیبانی کند، فعال/غیرفعال می‌کنند\&. در صورت تنظیم نشدن، از مقدار پیش‌فرض هسته استفاده خواهد شد\&.
.sp
افزوده شده در نسخه 250\&.
.RE
.PP
\fIRxCoalesceSec=\fR, \fIRxCoalesceIrqSec=\fR, \fIRxCoalesceLowSec=\fR, \fIRxCoalesceHighSec=\fR, \fITxCoalesceSec=\fR, \fITxCoalesceIrqSec=\fR, \fITxCoalesceLowSec=\fR, \fITxCoalesceHighSec=\fR
.RS 4
این ویژگی‌ها تاخیر پیش از ایجاد وقفه‌های Rx/Tx را پس از ارسال/دریافت یک بسته پیکربندی می‌کنند\&. ویژگی‌های
"Irq"
زمانی اعمال می‌شوند که میزبان در حال سرویس‌دهی به یک IRQ باشد\&. ویژگی‌های
"Low"
و
"High"
در صورت فعال بودن تجمیع وقفه تطبیقی Rx/Tx، به ترتیب زمانی اعمال می‌شوند که نرخ بسته‌ها به زیر آستانه نرخ بسته پایین افت کند یا از آستانه نرخ بسته بالا فراتر رود\&. در صورت تنظیم نشدن، از مقادیر پیش‌فرض هسته استفاده خواهد شد\&.
.sp
افزوده شده در نسخه 250\&.
.RE
.PP
\fIRxMaxCoalescedFrames=\fR, \fIRxMaxCoalescedIrqFrames=\fR, \fIRxMaxCoalescedLowFrames=\fR, \fIRxMaxCoalescedHighFrames=\fR, \fITxMaxCoalescedFrames=\fR, \fITxMaxCoalescedIrqFrames=\fR, \fITxMaxCoalescedLowFrames=\fR, \fITxMaxCoalescedHighFrames=\fR
.RS 4
این ویژگی‌ها حداکثر تعداد فریم‌هایی را که پیش از ایجاد یک وقفه Rx/Tx ارسال/دریافت می‌شوند، پیکربندی می‌کنند\&. ویژگی‌های
"Irq"
زمانی اعمال می‌شوند که میزبان در حال سرویس‌دهی به یک IRQ باشد\&. ویژگی‌های
"Low"
و
"High"
در صورت فعال بودن تجمیع وقفه تطبیقی Rx/Tx، به ترتیب زمانی اعمال می‌شوند که نرخ بسته‌ها به زیر آستانه نرخ بسته پایین افت کند یا از آستانه نرخ بسته بالا فراتر رود\&. در صورت تنظیم نشدن، از مقادیر پیش‌فرض هسته استفاده خواهد شد\&.
.sp
افزوده شده در نسخه 250\&.
.RE
.PP
\fICoalescePacketRateLow=\fR, \fICoalescePacketRateHigh=\fR
.RS 4
این ویژگی‌ها به ترتیب آستانه نرخ بسته پایین و بالا (بیان‌شده بر حسب بسته در ثانیه) را پیکربندی می‌کنند و برای تعیین زمانی استفاده می‌شوند که تنظیمات تجمیع وقفه متناظر برای نرخ‌های بسته پایین و بالا در صورت فعال بودن تجمیع تطبیقی Rx/Tx اعمال شوند\&. در صورت تنظیم نشدن، از مقادیر پیش‌فرض هسته استفاده خواهد شد\&.
.sp
افزوده شده در نسخه 250\&.
.RE
.PP
\fICoalescePacketRateSampleIntervalSec=\fR
.RS 4
فاصله زمانی نمونه‌برداری از نرخ بسته مورد استفاده برای تجمیع تطبیقی Rx/Tx را پیکربندی می‌کند\&. این ویژگی نمی‌تواند صفر باشد\&. کمترین تفکیک‌پذیری زمانی پشتیبانی‌شده توسط این ویژگی ثانیه است\&. کسرهای ثانیه قبل از ارسال به هسته به سمت بالا گرد می‌شوند\&. در صورت تنظیم نشدن، از مقدار پیش‌فرض هسته استفاده خواهد شد\&.
.sp
افزوده شده در نسخه 250\&.
.RE
.PP
\fIStatisticsBlockCoalesceSec=\fR
.RS 4
مدت زمان تاخیر در به‌روزرسانی‌های بلوک آمار درون حافظه درایور\&. اگر درایور دارای بلوک آماری درون حافظه نباشد، این ویژگی نادیده گرفته می‌شود\&. این ویژگی نمی‌تواند صفر باشد\&. در صورت تنظیم نشدن، از مقدار پیش‌فرض هسته استفاده خواهد شد\&.
.sp
افزوده شده در نسخه 250\&.
.RE
.PP
\fIMDI=\fR
.RS 4
حالت رابط وابسته به رسانه (MDI) را برای رابط مشخص می‌کند\&. یک MDI رابط از پیاده‌سازی لایه فیزیکی به رسانه فیزیکی مورد استفاده برای حمل انتقال را توصیف می‌کند\&. یکی از کلمات زیر را می‌گیرد:
"straight"
(یا معادل آن:
"mdi")،
"crossover"
(یا معادل آن:
"mdi\-x"،
"mdix")، و
"auto"\&. هنگامی که روی
"straight"
باشد، حالت مستقیم MDI استفاده خواهد شد\&. هنگامی که روی
"crossover"
باشد، حالت متقاطع MDI (یعنی MDI\-X) استفاده خواهد شد\&. هنگامی که روی
"auto"
باشد، وضعیت MDI به صورت خودکار تشخیص داده می‌شود\&. پیش‌فرض تنظیم‌نشده است و از مقدار پیش‌فرض هسته استفاده خواهد شد\&.
.sp
افزوده شده در نسخه 251\&.
.RE
.PP
\fISR\-IOVVirtualFunctions=\fR
.RS 4
تعداد توابع مجازی SR\-IOV را مشخص می‌کند\&. یک عدد صحیح در محدوده ۰\&...۲۱۴۷۴۸۳۶۴۷ می‌گیرد\&. پیش‌فرض تنظیم‌نشده است و به طور خودکار از مقادیر مشخص‌شده در تنظیمات
\fIVirtualFunction=\fR
در بخش‌های [SR\-IOV] تعیین می‌شود\&.
.sp
افزوده شده در نسخه 251\&.
.RE
.SH "گزینه‌های بخش [SR\-IOV] ([SR\-IOV] SECTION OPTIONS)"
.PP
فناوری SR\-IOV قابلیت تقسیم یک منبع PCI فیزیکی واحد را به توابع PCI مجازی فراهم می‌کند که سپس می‌توانند برای مثال به یک ماشین مجازی (VM) تزریق شوند\&. در مورد VFهای شبکه، SR\-IOV با اجازه دادن به ترافیک برای دور زدن پشته شبکه ماشین میزبان، تاخیر و استفاده از CPU را برای ترافیک شبکه شمال\-جنوب (یعنی ترافیکی با نقاط پایانی خارج از ماشین میزبان) کاهش می‌دهد\&.
.PP
وجود بخش [SR\-IOV] در یک فایل \&.link باعث ایجاد و پیکربندی تابع مجازی مشخص‌شده می‌شود\&. درون یک فایل \&.network، تابع مجازی مشخص‌شده پیکربندی خواهد شد، اما باید از قبل وجود داشته باشد\&. برای پیکربندی چندین SR\-IOV، چندین بخش [SR\-IOV] را مشخص کنید\&.
.PP
بخش [SR\-IOV] کلیدهای زیر را می‌پذیرد\&:
.PP
\fIVirtualFunction=\fR
.RS 4
یک تابع مجازی (VF) را مشخص می‌کند، یک تابع سبک PCIe که صرفاً برای انتقال داده‌ها به داخل و خارج طراحی شده است\&. یک عدد صحیح در محدوده ۰\&...۲۱۴۷۴۸۳۶۴۶ می‌گیرد\&. این گزینه اجباری است\&.
.sp
افزوده شده در نسخه 251\&.
.RE
.PP
\fIVLANId=\fR
.RS 4
شناسه VLAN تابع مجازی را مشخص می‌کند\&. یک عدد صحیح در محدوده ۱\&...۴۰۹۵ می‌گیرد\&.
.sp
افزوده شده در نسخه 251\&.
.RE
.PP
\fIQualityOfService=\fR
.RS 4
کیفیت خدمات (QoS) تابع مجازی را مشخص می‌کند\&. یک عدد صحیح در محدوده ۱\&...۴۲۹۴۹۶۷۲۹۴ می‌گیرد\&.
.sp
افزوده شده در نسخه 251\&.
.RE
.PP
\fIVLANProtocol=\fR
.RS 4
پروتکل VLAN تابع مجازی را مشخص می‌کند\&. مقدار
"802\&.1Q"
یا
"802\&.1ad"
را می‌گیرد\&.
.sp
افزوده شده در نسخه 251\&.
.RE
.PP
\fIMACSpoofCheck=\fR
.RS 4
یک مقدار بولی می‌گیرد\&. بررسی جعل آدرس MAC را کنترل می‌کند\&. در صورت تنظیم نشدن، از مقدار پیش‌فرض هسته استفاده خواهد شد\&.
.sp
افزوده شده در نسخه 251\&.
.RE
.PP
\fIQueryReceiveSideScaling=\fR
.RS 4
یک مقدار بولی می‌گیرد\&. امکان استعلام پیکربندی مقیاس‌پذیری سمت دریافت (RSS) تابع مجازی (VF) را تغییر وضعیت می‌دهد\&. اطلاعات RSS تابع مجازی مانند کلید هش RSS ممکن است در برخی دستگاه‌ها که این اطلاعات بین VF و تابع فیزیکی (PF) به اشتراک گذاشته می‌شود، حساس تلقی شود\&. در صورت تنظیم نشدن، از مقدار پیش‌فرض هسته استفاده خواهد شد\&.
.sp
افزوده شده در نسخه 251\&.
.RE
.PP
\fITrust=\fR
.RS 4
یک مقدار بولی می‌گیرد\&. امکان تنظیم حالت اعتماد (trust mode) تابع مجازی (VF) را فراهم می‌کند\&. در صورت تنظیم، کاربران VF می‌توانند ویژگی خاصی را تنظیم کنند که ممکن است بر امنیت و/یا عملکرد تأثیر بگذارد\&. در صورت تنظیم نشدن، از مقدار پیش‌فرض هسته استفاده خواهد شد\&.
.sp
افزوده شده در نسخه 251\&.
.RE
.PP
\fILinkState=\fR
.RS 4
امکان تنظیم وضعیت پیوند (link state) تابع مجازی (VF) را فراهم می‌کند\&. یک مقدار بولی یا مقدار ویژه
"auto"
را می‌گیرد\&. تنظیم روی
"auto"
به معنای بازتاب وضعیت پیوند تابع فیزیکی (PF) است،
"yes"
به VF اجازه می‌دهد با سایر VFهای روی این میزبان ارتباط برقرار کند حتی اگر وضعیت پیوند PF قطع (down) باشد،
"no"
باعث می‌شود سخت‌افزار هر بسته‌ای را که توسط VF ارسال می‌شود دور بریزد\&. در صورت تنظیم نشدن، از مقدار پیش‌فرض هسته استفاده خواهد شد\&.
.sp
افزوده شده در نسخه 251\&.
.RE
.PP
\fIMACAddress=\fR
.RS 4
آدرس MAC را برای تابع مجازی مشخص می‌کند\&.
.sp
افزوده شده در نسخه 251\&.
.RE
.SH "گزینه‌های بخش [ENERGYEFFICIENTETHERNET] ([ENERGYEFFICIENTETHERNET] SECTION OPTIONS)"
.PP
بخش [EnergyEfficientEthernet] قابلیت اترنت با مصرف بهینه انرژی (EEE) رابط را کنترل می‌کند، و کلیدهای زیر را می‌پذیرد\&:
.PP
\fIEnable=\fR
.RS 4
یک آرگومان بولی می‌گیرد\&. هنگامی که true باشد، قابلیت اترنت با مصرف بهینه انرژی (EEE) روی رابط فعال خواهد شد\&. پیش‌فرض تنظیم‌نشده است و فعال‌سازی EEE بدون تغییر باقی خواهد ماند\&.
.sp
افزوده شده در نسخه 258\&.
.RE
.PP
\fITxLowPowerIdle=\fR
.RS 4
یک آرگومان بولی می‌گیرد\&. هنگامی که true باشد، حالت بیکاری کم‌مصرف ارسال (Tx\-LPI) قابلیت اترنت با مصرف بهینه انرژی روی رابط فعال خواهد شد\&. پیش‌فرض تنظیم‌نشده است و فعال‌سازی این حالت بدون تغییر باقی خواهد ماند\&.
.sp
افزوده شده در نسخه 258\&.
.RE
.PP
\fITxLowPowerIdleSec=\fR
.RS 4
یک بازه زمانی را می‌گیرد\&. این گزینه پیکربندی می‌کند که رابط پس از ارسال، چه مدت نباید وارد حالت بیکاری کم‌مصرف شود\&. اگر خیلی کوتاه باشد، ممکن است کارایی را کاهش دهد\&. اگر خیلی طولانی باشد، ممکن است صرفه‌جویی در مصرف انرژی حاصل نشود\&. پیش‌فرض تنظیم‌نشده است و بازه زمانی بدون تغییر باقی خواهد ماند\&.
.sp
افزوده شده در نسخه 258\&.
.RE
.PP
\fILinkMode=\fR
.RS 4
فهرستی از حالت‌های پیوند را می‌گیرد، برای مثال
"1000baset\-full"\&.
برای مقادیر ممکن جدول مربوط به تنظیم
\fIAdvertise=\fR
در بخش [Link] در بالا را ببینید\&. این گزینه حالت‌های اتصال دارای قابلیت اترنت با مصرف بهینه انرژی را که باید اعلان شوند پیکربندی می‌کند\&. پیش‌فرض تنظیم‌نشده است و حالت‌های اعلان‌شده بدون تغییر باقی خواهند ماند\&.
.sp
افزوده شده در نسخه 258\&.
.RE
.SH "مشخص‌کننده‌ها (SPECIFIERS)"
.PP
برخی تنظیمات مشخص‌کننده‌هایی را تفکیک می‌کنند که ممکن است برای نوشتن فایل‌های واحد عمومی با اشاره به پارامترهای زمان اجرا یا واحد استفاده شوند که هنگام بارگذاری فایل‌های واحد جایگزین می‌شوند\&. برای اینکه تنظیم معتبر باشد، مشخص‌کننده‌ها باید شناخته‌شده و قابل‌تفکیک باشند\&. مشخص‌کننده‌های زیر درک می‌شوند:
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.B جدول\ \&2.\ \&مشخص‌کننده‌های موجود در فایل‌های واحد
.TS
allbox tab(:);
lB lB lB.
T{
مشخص‌کننده
T}:T{
مفهوم
T}:T{
جزئیات
T}
.T&
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l
l l l.
T{
"%a"
T}:T{
معماری
T}:T{
یک رشته کوتاه که معماری سیستم محلی را مشخص می‌کند\&. رشته‌ای مانند \fBx86\fR، \fBx86\-64\fR یا \fBarm64\fR\&. برای فهرست کامل، به معماری‌های تعریف‌شده برای \fIConditionArchitecture=\fR در \fBsystemd.unit\fR(5) مراجعه کنید\&.
T}
T{
"%A"
T}:T{
نسخه ایمیج سیستم‌عامل
T}:T{
شناسه نسخه ایمیج سیستم‌عاملِ سیستم در حال اجرا، همان‌طور که از فیلد \fIIMAGE_VERSION=\fR در /etc/os\-release خوانده می‌شود\&. اگر تنظیم نشده باشد، به یک رشته خالی تبدیل می‌شود\&. برای اطلاعات بیشتر به \fBos-release\fR(5) مراجعه کنید\&.
T}
T{
"%b"
T}:T{
شناسه بوت
T}:T{
شناسه بوت سیستم در حال اجرا، قالب‌بندی‌شده به صورت رشته\&. برای اطلاعات بیشتر به \fBrandom\fR(4) مراجعه کنید\&.
T}
T{
"%B"
T}:T{
شناسه ساخت سیستم‌عامل
T}:T{
شناسه ساخت سیستم‌عاملِ سیستم در حال اجرا، همان‌طور که از فیلد \fIBUILD_ID=\fR در /etc/os\-release خوانده می‌شود\&. اگر تنظیم نشده باشد، به یک رشته خالی تبدیل می‌شود\&. برای اطلاعات بیشتر به \fBos-release\fR(5) مراجعه کنید\&.
T}
T{
"%H"
T}:T{
نام میزبان
T}:T{
نام میزبان سیستم در حال اجرا\&.
T}
T{
"%l"
T}:T{
نام کوتاه میزبان
T}:T{
نام میزبان سیستم در حال اجرا، کوتاه‌شده در اولین نقطه برای حذف هرگونه مؤلفه دامنه\&.
T}
T{
"%m"
T}:T{
شناسه ماشین
T}:T{
شناسه ماشینِ سیستم در حال اجرا، قالب‌بندی‌شده به صورت رشته\&. برای اطلاعات بیشتر به \fBmachine-id\fR(5) مراجعه کنید\&.
T}
T{
"%M"
T}:T{
شناسه ایمیج سیستم‌عامل
T}:T{
شناسه ایمیج سیستم‌عاملِ سیستم در حال اجرا، همان‌طور که از فیلد \fIIMAGE_ID=\fR در /etc/os\-release خوانده می‌شود\&. اگر تنظیم نشده باشد، به یک رشته خالی تبدیل می‌شود\&. برای اطلاعات بیشتر به \fBos-release\fR(5) مراجعه کنید\&.
T}
T{
"%o"
T}:T{
شناسه سیستم‌عامل
T}:T{
شناسه سیستم‌عاملِ سیستم در حال اجرا، همان‌طور که از فیلد \fIID=\fR در /etc/os\-release خوانده می‌شود\&. برای اطلاعات بیشتر به \fBos-release\fR(5) مراجعه کنید\&.
T}
T{
"%q"
T}:T{
نام زیبای میزبان
T}:T{
نام زیبای میزبانِ (pretty hostname) سیستم در حال اجرا، همان‌طور که از فیلد \fIPRETTY_HOSTNAME=\fR در /etc/machine\-info خوانده می‌شود\&. اگر تنظیم نشده باشد، به نام کوتاه میزبان تبدیل می‌شود\&. برای اطلاعات بیشتر به \fBmachine-info\fR(5) مراجعه کنید\&.
T}
T{
"%T"
T}:T{
دایرکتوری فایل‌های موقت
T}:T{
این یا /tmp است یا مسیری که "$TMPDIR"، "$TEMP" یا "$TMP" روی آن تنظیم شده‌اند\&. (توجه داشته باشید که دایرکتوری ممکن است بدون خط مورب انتهایی مشخص شود\&.)
T}
T{
"%v"
T}:T{
انتشار هسته
T}:T{
همانند خروجی دستور \fBuname \-r\fR\&.
T}
T{
"%V"
T}:T{
دایرکتوری برای فایل‌های موقت بزرگ‌تر و پایدار
T}:T{
این یا /var/tmp است یا مسیری که "$TMPDIR"، "$TEMP" یا "$TMP" روی آن تنظیم شده‌اند\&. (توجه داشته باشید که دایرکتوری ممکن است بدون خط مورب انتهایی مشخص شود\&.)
T}
T{
"%w"
T}:T{
شناسه نسخه سیستم‌عامل
T}:T{
شناسه نسخه سیستم‌عاملِ سیستم در حال اجرا، همان‌طور که از فیلد \fIVERSION_ID=\fR در /etc/os\-release خوانده می‌شود\&. اگر تنظیم نشده باشد، به یک رشته خالی تبدیل می‌شود\&. برای اطلاعات بیشتر به \fBos-release\fR(5) مراجعه کنید\&.
T}
T{
"%W"
T}:T{
شناسه گونه سیستم‌عامل
T}:T{
شناسه گونهٔ (واریانت) سیستم‌عاملِ سیستم در حال اجرا، همان‌طور که از فیلد \fIVARIANT_ID=\fR در /etc/os\-release خوانده می‌شود\&. اگر تنظیم نشده باشد، به یک رشته خالی تبدیل می‌شود\&. برای اطلاعات بیشتر به \fBos-release\fR(5) مراجعه کنید\&.
T}
.TE
.sp 1
.SH "مثال‌ها (EXAMPLES)"
.PP
\fBمثال\ \&1.\ \&/usr/lib/systemd/network/99\-default\&.link\fR
.PP
فایل link به نام
99\-default\&.link
که همراه با systemd ارائه می‌شود، سیاست‌های پیش‌فرض را برای نام رابط، نام‌های جایگزین و آدرس MAC پیوندها تعریف می‌کند\&.
.sp
.if n \{\
.RS 4
.\}
.nf
[Match]
OriginalName=*

[Link]
NamePolicy=keep kernel database onboard slot path
AlternativeNamesPolicy=database onboard slot path
MACAddressPolicy=persistent
.fi
.if n \{\
.RE
.\}
.PP
\fBمثال\ \&2.\ \&/etc/systemd/network/10\-dmz\&.link\fR
.PP
این مثال نام ثابت
"dmz0"
را به رابط با آدرس MAC برابر با 00:a0:de:63:7a:e6 اختصاص می‌دهد:
.sp
.if n \{\
.RS 4
.\}
.nf
[Match]
MACAddress=00:a0:de:63:7a:e6

[Link]
Name=dmz0
.fi
.if n \{\
.RE
.\}
.PP
\fINamePolicy=\fR
تنظیم نشده است، بنابراین
\fIName=\fR
اعمال می‌شود\&. ما از پیشوند
"10\-"
استفاده می‌کنیم تا این فایل در ابتدای فهرست قرار گیرد\&. توجه داشته باشید که این فایل باید قبل از
99\-default\&.link
قرار گیرد، یعنی برای اینکه اصلاً اعمال شود نیاز به یک پیشوند عددی دارد\&.
.PP
\fBمثال\ \&3.\ \&اعمال (مجدد) یک فایل \&.link روی یک رابط\fR
.PP
پس از ایجاد یک فایل \&.link جدید یا تغییر یک فایل \&.link موجود، تنظیمات جدید ممکن است با دستورهای زیر روی رابط منطبق اعمال شوند:
.sp
.if n \{\
.RS 4
.\}
.nf
$ sudo udevadm control \-\-reload
$ sudo ip link set eth0 down
$ sudo udevadm trigger \-\-verbose \-\-settle \-\-action add /sys/class/net/eth0
.fi
.if n \{\
.RE
.\}
.PP
همچنین ممکن است لازم باشد قبل از عملیات فوق، سرویسی را که رابط شبکه را مدیریت می‌کند، برای مثال
\fBsystemd-networkd.service\fR(8)
یا
NetworkManager\&.service
متوقف کنید و سپس پس از آن سرویس را مجدداً راه‌اندازی نمایید\&. برای جزئیات بیشتر درباره دستور
\fBudevadm\fR،
\fBudevadm\fR(8)
را ببینید\&.
.PP
\fBمثال\ \&4.\ \&اشکال‌زدایی از تخصیص‌های \fINamePolicy=\fR\fR
.sp
.if n \{\
.RS 4
.\}
.nf
$ sudo SYSTEMD_LOG_LEVEL=debug udevadm test\-builtin net_setup_link /sys/class/net/hub0
\&...
Parsed configuration file /usr/lib/systemd/network/99\-default\&.link
Parsed configuration file /etc/systemd/network/10\-eth0\&.link
ID_NET_DRIVER=cdc_ether
Config file /etc/systemd/network/10\-eth0\&.link applies to device hub0
link_config: autonegotiation is unset or enabled, the speed and duplex are not writable\&.
hub0: Device has name_assign_type=4
Using default interface naming scheme \*(Aqv240\*(Aq\&.
hub0: Policies did not yield a name, using specified Name=hub0\&.
ID_NET_LINK_FILE=/etc/systemd/network/10\-eth0\&.link
ID_NET_NAME=hub0
\&...
.fi
.if n \{\
.RE
.\}
.PP
پیکربندی صریح
\fIName=\fR
در این حالت برنده می‌شود\&.
.sp
.if n \{\
.RS 4
.\}
.nf
sudo SYSTEMD_LOG_LEVEL=debug udevadm test\-builtin net_setup_link /sys/class/net/enp0s31f6
\&...
Parsed configuration file /usr/lib/systemd/network/99\-default\&.link
Parsed configuration file /etc/systemd/network/10\-eth0\&.link
Created link configuration context\&.
ID_NET_DRIVER=e1000e
Config file /usr/lib/systemd/network/99\-default\&.link applies to device enp0s31f6
link_config: autonegotiation is unset or enabled, the speed and duplex are not writable\&.
enp0s31f6: Device has name_assign_type=4
Using default interface naming scheme \*(Aqv240\*(Aq\&.
enp0s31f6: Policy *keep*: keeping existing userspace name
enp0s31f6: Device has addr_assign_type=0
enp0s31f6: MAC on the device already matches policy *persistent*
ID_NET_LINK_FILE=/usr/lib/systemd/network/99\-default\&.link
\&...
.fi
.if n \{\
.RE
.\}
.PP
در این حالت، رابط قبلاً تغییر نام داده شده بود، بنابراین سیاست
\fBkeep\fR
که به عنوان اولین گزینه در
99\-default\&.link
مشخص شده است به این معنی است که نام موجود حفظ می‌شود\&. اگر
\fBkeep\fR
حذف می‌شد، یا اگر در مرحله‌ای از بوت قبل از انجام تغییر نام بودیم، ممکن بود در عوض خروجی زیر را دریافت کنیم:
.sp
.if n \{\
.RS 4
.\}
.nf
enp0s31f6: Policy *path* yields "enp0s31f6"\&.
enp0s31f6: Device has addr_assign_type=0
enp0s31f6: MAC on the device already matches policy *persistent*
ID_NET_LINK_FILE=/usr/lib/systemd/network/99\-default\&.link
ID_NET_NAME=enp0s31f6
\&...
.fi
.if n \{\
.RE
.\}
.PP
لطفاً توجه داشته باشید که جزئیات خروجی ممکن است تغییر کند\&.
.PP
\fBمثال\ \&5.\ \&/etc/systemd/network/10\-internet\&.link\fR
.PP
این مثال نام ثابت
"internet0"
را به رابط با مسیر دستگاه
"pci\-0000:00:1a\&.0\-*"
اختصاص می‌دهد:
.sp
.if n \{\
.RS 4
.\}
.nf
[Match]
Path=pci\-0000:00:1a\&.0\-*

[Link]
Name=internet0
.fi
.if n \{\
.RE
.\}
.PP
\fBمثال\ \&6.\ \&/etc/systemd/network/25\-wireless\&.link\fR
.PP
در اینجا یک مثال پیچیده آورده شده است که استفاده از تعداد زیادی از تنظیمات [Match] و [Link] را نشان می‌دهد\&.
.sp
.if n \{\
.RS 4
.\}
.nf
[Match]
MACAddress=12:34:56:78:9a:bc
Driver=brcmsmac
Path=pci\-0000:02:00\&.0\-*
Type=wlan
Virtualization=no
Host=my\-laptop
Architecture=x86\-64

[Link]
Name=wireless0
MTUBytes=1450
BitsPerSecond=10M
WakeOnLan=magic
MACAddress=cb:a9:87:65:43:21
.fi
.if n \{\
.RE
.\}
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBsystemd-udevd.service\fR(8), \fBudevadm\fR(8), \fBsystemd.netdev\fR(5), \fBsystemd.network\fR(5), \fBsystemd-network-generator.service\fR(8)
.SH "نکات (NOTES)"
.IP " 1." 4
💣💥🧨💥💥💣 لطفاً توجه داشته باشید که این فایل‌های پیکربندی باید همیشه در دسترس باشند\&. اگر
/usr/local/
یک پارتیشن جداگانه باشد، ممکن است در طول مراحل اولیه بوت در دسترس نباشد و نباید برای پیکربندی استفاده شود\&.
.IP " 2." 4
اعتبارنامه‌های سیستم و سرویس
.RS 4
\%https://systemd.io/CREDENTIALS
.RE
.IP " 3." 4
تخلیه بار قطعه‌بندی عمومی جزئی
.RS 4
\%https://docs.kernel.org/networking/segmentation-offloads.html#partial-generic-segmentation-offload
.RE