iwd.config(5) Linux Connectivity iwd.config(5)

iwd.config - پرونده پیکربندی برای دیمن شبکه بی‌سیم

پرونده پیکربندی main.conf

پرونده پیکربندی main.conf تنظیمات سراسری سیستم را برای iwd پیکربندی می‌کند. این پرونده در دایرکتوری پیکربندی مشخص‌شده توسط متغیر محیطی $CONFIGURATION_DIRECTORY قرار دارد که معمولاً توسط systemd ارائه می‌شود. در صورت عدم وجود چنین متغیر محیطی، مسیر پیش‌فرض /etc/iwd در نظر گرفته می‌شود. اگر پرونده main.conf وجود نداشته باشد، مقادیر پیش‌فرض انتخاب می‌شوند. وجود پرونده main.conf الزامی نیست.

برای جزئیات قالب پرونده، iwd.network را ببینید.

تنظیمات به چندین دسته تقسیم می‌شوند. هر دسته دارای یک گروه مرتبط است که در جدول‌های جداگانه زیر شرح داده شده است.

گروه [General] شامل تنظیمات عمومی است.

EnableNetworkConfiguration مقادیر: true، false فعال‌سازی پیکربندی شبکه. تنظیم این گزینه روی true به iwd امکان می‌دهد رابط‌های شبکه را با آدرس‌های IP پیکربندی کند. دو نوع آدرس‌دهی IP توسط iwd پشتیبانی می‌شود: ایستا و پویا. آدرس‌های IP ایستا از طریق پرونده‌های پیکربندی شبکه تنظیم می‌شوند. اگر هیچ پیکربندی IP ایستایی برای یک شبکه ارائه نشده باشد، iwd تلاش خواهد کرد تا آدرس‌های پویا را از طریق کلاینت DHCP داخلی از شبکه دریافت کند. این گزینه همچنین پیکربندی شبکه و کارساز DHCP را در حالت نقطه دسترسی (AP) فعال می‌کند، مشروط بر اینکه نمایه AP فعال‌شده آن را بازنویسی نکند. قابلیت پیکربندی شبکه به‌طور پیش‌فرض غیرفعال است. برای تنظیمات بیشتر مرتبط با پیکربندی شبکه، تنظیمات [Network] را ببینید.
UseDefaultInterface (منسوخ‌شده) مقادیر: true، false به iwd اجازه نمی‌دهد رابط‌های بی‌سیم، از جمله رابط‌های پیش‌فرض را هنگام راه‌اندازی حذف کند یا دوباره بسازد. در صورتی که درایور کارت شبکه بی‌سیم شما اشکال دارد یا اجازه چنین عملیاتی را نمی‌دهد، یا اگر به دلایل دیگر نمی‌خواهید iwd دستگاه‌های شبکه (netdevs) را مدیریت کند، این رفتار را فعال کنید. برای اکثر کاربرانی که از درایور بالادستی استفاده می‌کنند، حذف یا غیرفعال کردن این تنظیم ایمن است. این تنظیم منسوخ شده است، لطفاً به‌جای آن از [DriverQuirks].DefaultInterface استفاده کنید.
AddressRandomization مقادیر: disabled، once، network اگر AddressRandomization روی disabled تنظیم شود، رفتار پیش‌فرض هسته استفاده می‌شود. این بدان معناست که هسته یک آدرس MAC را از محدوده آدرس‌های MAC دائمی ارائه‌شده توسط سخت‌افزار یا درایور اختصاص می‌دهد. بنابراین شبکه‌ها می‌توانند کاربر را از طریق آدرس ثابت MAC ردیابی کنند. اگر AddressRandomization روی once تنظیم شود، آدرس MAC هنگام شروع iwd یا زمانی که سخت‌افزار برای اولین بار شناسایی می‌شود (به دلیل اتصال داغ یا موارد مشابه) تنها یک‌بار تصادفی‌سازی می‌شود. اگر AddressRandomization روی network تنظیم شود، آدرس MAC در هر اتصال به یک شبکه تصادفی‌سازی می‌شود. آدرس MAC بر اساس SSID و آدرس دائمی آداپتور تولید می‌گردد. این ویژگی اجازه می‌دهد تا در هر بار اتصال به یک SSID مشخص، همان آدرس MAC تولید شود در حالی که آدرس دائمی همچنان مخفی می‌ماند.
AddressRandomizationRange مقادیر: full، nic با این تنظیم می‌توان مشخص کرد که کدام بخش از آدرس تصادفی‌سازی شود. هنگام استفاده از AddressRandomizationRange تنظیم‌شده روی nic، فقط بایت‌های اختصاصی کارت شبکه (۳ بایت آخر) تصادفی می‌شوند. توجه داشته باشید که محدوده تصادفی‌سازی به 00:00:01 تا 00:00:FE محدود است. برای ۳ بایت اول از آدرس MAC دائمی کارت استفاده می‌شود. هنگام استفاده از AddressRandomizationRange تنظیم‌شده روی full، تمام ۶ بایت آدرس تصادفی می‌شوند. بیت مدیریت محلی (locally-administered) نیز تنظیم خواهد شد.
RoamThreshold مقدار: مقدار rssi بر حسب dBm، از -100 تا 1، پیش‌فرض: -70 این مقدار برای کنترل میزان تمایل iwd به رومینگ در هنگام اتصال به نقطه دسترسی 2.4GHz به کار می‌رود.
RoamThreshold5G مقدار: مقدار rssi بر حسب dBm، از -100 تا 1، پیش‌فرض: -76 این مقدار برای کنترل میزان تمایل iwd به رومینگ در هنگام اتصال به نقطه دسترسی 5GHz به کار می‌رود.
CriticalRoamThreshold مقدار: مقدار rssi بر حسب dBm، از -100 تا -1، پیش‌فرض: -80 آستانه‌ای (برای 2.4GHz) که در آن IWD بدون در نظر گرفتن تمایل (affinity) تعیین‌شده برای BSS فعلی اقدام به رومینگ می‌کند. اگر BSS متصل دارای تمایل باشد (تنظیم‌شده در فهرست تمایلات Station)، آستانه رومینگ تا این مقدار کاهش می‌یابد و IWD تا زمانی که تمایل پاک نشود، یا سیگنال به زیر این آستانه افت نکند، تلاشی برای رومینگ (یا اسکن رومینگ) نخواهد کرد.
CriticalRoamThreshold5G مقدار: مقدار rssi بر حسب dBm، از -100 تا -1، پیش‌فرض: -82 این اثر مشابهی با CriticalRoamThreshold دارد، اما برای باند 5GHz اعمال می‌شود.
RoamRetryInterval مقدار: عدد صحیح بدون علامت بر حسب ثانیه (پیش‌فرض: 60) مشخص می‌کند در صورتی که آخرین تلاش برای رومینگ با شکست مواجه شود، یا اگر سیگنال BSS تازه متصل‌شده همچنان ضعیف در نظر گرفته شود، iwd چه مدت قبل از تلاش مجدد برای رومینگ منتظر بماند.
ManagementFrameProtection مقادیر: 0، 1 یا 2 هنگامی که ManagementFrameProtection روی 0 باشد، MFP کاملاً خاموش می‌شود، حتی اگر سخت‌افزار توانایی آن را داشته باشد. این تنظیم توصیه نمی‌شود. هنگامی که ManagementFrameProtection روی 1 باشد، در صورتی که سخت‌افزار محلی و نقطه دسترسی (AP) راه دور هر دو از آن پشتیبانی کنند، MFP فعال می‌شود. هنگامی که ManagementFrameProtection روی 2 باشد، MFP همیشه الزامی است. این حالت ممکن است مانع از برقراری موفقیت‌آمیز اتصال روی برخی سخت‌افزارها یا به برخی شبکه‌ها شود.
ControlPortOverNL80211 مقادیر: false، true فعال/غیرفعال کردن ارسال بسته‌های EAPoL از طریق NL80211. در صورت پشتیبانی در هسته، به‌طور پیش‌فرض فعال است. انجام این کار تمام ترافیک EAPoL را مستقیماً به فرایند درخواست‌کننده (iwd) ارسال می‌کند، به‌جای اینکه آن‌ها را روی دستگاه اترنت قرار دهد. از آنجا که معمولاً فقط درخواست‌کننده می‌تواند این بسته‌ها را رمزگشایی یا درک کند، فعال‌سازی این گزینه می‌تواند در چرخه‌های پردازنده سیستم صرفه‌جویی کند و از برخی شرایط رقابتی دیرینه جلوگیری نماید.
DisableANQP مقادیر: false، true فعال/غیرفعال کردن پرس‌وجوهای ANQP. روش انجام پرس‌وجوهای ANQP توسط IWD وابسته به یک وصله جدید در هسته است (موجود در هسته نسخه 5.3 به بعد). اگر هسته شما فاقد این قابلیت است، این گزینه باید غیرفعال باشد (پیش‌فرض). همچنین برخی از درایورها فریم‌های کنش عمومی (public action frames) را بسیار نامناسب ارسال می‌کنند (باعث فریز یا کرش می‌شود) که دلیل دیگری برای غیرفعال بودن پیش‌فرض آن است. اگر می‌خواهید به‌راحتی از شبکه‌های Hotspot 2.0 استفاده کنید، تنظیم DisableANQP روی false توصیه می‌شود.
DisableOCV مقدار: false، true غیرفعال کردن اعتبارسنجی کانال عملیاتی (Operating Channel Validation). پشتیبانی از این قابلیت توسط هسته اعلان نمی‌شود، بنابراین اگر هسته‌ها یا درایورهایی وجود دارند که از OCV پشتیبانی نمی‌کنند، می‌توان آن را در اینجا غیرفعال کرد.
SystemdEncrypt هشدار: این یک ویژگی بسیار تجربی است مقدار: شناسه کلید Systemd رمزنگاری نمایه‌های شبکه را با استفاده از کلید مخفی ارائه‌شده توسط systemd فعال می‌کند. پس از فعال‌سازی، تمام نمایه‌های شبکه PSK/8021x به‌طور خودکار رمزنگاری می‌شوند. پس از رمزنگاری نمایه، هیچ راه بازگشتی با استفاده از IWD به‌تنهایی وجود ندارد. ابزاری به نام iwd-decrypt-profile به فرض مشخص بودن کلید مخفی برای رمزگشایی نمایه ارائه شده است. این نمایه رمزگشایی‌شده می‌تواند به‌صورت دستی در /var/lib/iwd قرار داده شود تا رمزنگاری نمایه لغو شود، اما این یک فرآیند دستی خواهد بود. راه‌اندازی systemd برای ارائه کلید مخفی بر عهده کاربر است زیرا IWD راهی برای انجام خودکار آن ندارد. گزینه‌های مورد نیاز systemd عبارتند از LoadCredentialEncrypted یا SetCredentialEncrypted، و شناسه کلید مخفی باید همان نامی باشد که برای SystemdEncrypt تنظیم شده است.
Country مقدار: کد کشور (ISO Alpha-2) درخواست تنظیم کشور را برای سیستم ارسال می‌کند. توجه داشته باشید که تنظیم این گزینه صرفاً یک درخواست برای تنظیم کشور است و تضمین نمی‌کند که کشور حتماً تنظیم شود. برای یک wiphy خودگردان، هرگز امکان تنظیم کشور از فضای کاربری وجود ندارد. برای سایر دستگاه‌ها، هر درخواست دامنه مقرراتی صرفاً یک «راهنمایی» است و در نهایت تصمیم‌گیری در مورد تنظیم کشور به هسته واگذار می‌شود.
DisablePMKSA مقدار: false، true غیرفعال کردن پشتیبانی از PMKSA در IWD

گروه [Network] شامل تنظیمات مرتبط با پیکربندی شبکه است.

EnableIPv6 مقادیر: true، false پیش‌فرض سراسری را تنظیم می‌کند که به iwd می‌گوید آیا باید آدرس‌ها و مسیرهای IPv6 را پیکربندی کند یا خیر (خواه از طریق تنظیمات ایستا، اعلان‌های مسیریاب یا پروتکل DHCPv6 ارائه شده باشند). این تنظیم به‌طور پیش‌فرض فعال است. این تنظیم همچنین می‌تواند برای هر شبکه به‌طور جداگانه بازنویسی شود.
NameResolvingService مقادیر: resolvconf، systemd، none روش تحلیل نام DNS مورد استفاده در سیستم را پیکربندی می‌کند. این گزینه پیکربندی باید همراه با EnableNetworkConfiguration استفاده شود و امکان انتخاب نحوه ادغام با تحلیل‌گر نام سیستم را فراهم می‌سازد. در صورت عدم تعیین، به‌طور پیش‌فرض از systemd استفاده می‌شود. اگر none تعیین شود، اطلاعات DNS و نام دامنه نادیده گرفته خواهد شد.
RoutePriorityOffset مقادیر: مقدار uint32 (پیش‌فرض: 300) آفست اولویت مسیریابی را پیکربندی می‌کند که توسط سیستم برای اولویت‌بندی مسیرهای پیش‌فرض استفاده می‌شود. مسیری که دارای آفست اولویت کمتری باشد، ارجح است. در صورت عدم تعیین، به‌طور پیش‌فرض از 300 استفاده می‌شود.

گروه [Blacklist] شامل تنظیمات مربوط به قرار دادن BSSها در فهرست سیاه است. اگر iwd تشخیص دهد که اتصال به یک BSS به دلیلی ناموفق بوده که نشان‌دهنده عملکرد نادرست یا پیکربندی اشتباه BSS است (مانند اتمام مهلت زمانی، کدهای وضعیت یا خطای غیرمنتظره و غیره)، آنگاه iwd این BSS را در فهرست سیاه قرار می‌دهد و برای مدتی از اتصال به آن خودداری می‌کند. این گزینه‌ها به کاربر اجازه می‌دهند مدت زمانی را که یک BSS با رفتار نامناسب در فهرست سیاه می‌ماند کنترل کند.

InitialTimeout مقادیر: مقدار uint64 بر حسب ثانیه (پیش‌فرض: 60) مدت‌زمان اولیه حضور یک BSS در فهرست سیاه. تنظیم این مقدار روی صفر، قابلیت فهرست سیاه را در IWD غیرفعال می‌کند.
InitialRoamRequestedTimeout (منسوخ‌شده) مقادیر: مقدار uint64 بر حسب ثانیه (پیش‌فرض: 30) این تنظیم منسوخ شده است، لطفاً به‌جای آن از [Blacklist].InitialAccessPointBusyTimeout استفاده کنید.
InitialAccessPointBusyTimeout مقادیر: مقدار uint64 بر حسب ثانیه (پیش‌فرض: 30) مدت‌زمان اولیه‌ای که یک BSS پس از اعلام اینکه نمی‌تواند اتصالات بیشتری را بپذیرد، در فهرست سیاه قرار می‌گیرد. این وضعیت یا با درخواست مدیریت انتقال BSS (که به IWD می‌گوید به جای دیگری رومینگ کند) یا با رد احراز هویت یا پیوستگی با کد وضعیت NO_MORE_STAS ایجاد می‌شود. هنگامی که یک BSS به این روش در فهرست سیاه قرار گیرد، IWD تلاش خواهد کرد تا در طول مدت پیکربندی‌شده از اتصال به آن خودداری کند.
Multiplier مقادیر: عدد صحیح بدون علامت بزرگ‌تر از صفر، بر حسب ثانیه (پیش‌فرض: 30) اگر BSS قبلاً در فهرست سیاه قرار گرفته باشد و پس از انقضای مهلت اولیه، تلاش دیگری برای اتصال با شکست مواجه شود، مدت‌زمان حضور در فهرست سیاه به ازای هر تلاش ناموفق ضریبی از Multiplier افزایش می‌یابد تا زمانی که به زمان MaxiumTimeout بر حسب ثانیه برسد.
MaximumTimeout مقادیر: مقدار uint64 بر حسب ثانیه (پیش‌فرض: 86400) حداکثر مدت‌زمانی که یک BSS در فهرست سیاه می‌ماند.

گروه [Rank] شامل تنظیمات مربوط به رتبه‌بندی شبکه‌ها برای اهداف اتصال خودکار است.

BandModifier2_4GHz مقادیر: مقدار ممیز شناور (پیش‌فرض: 1.0) با افزایش یا کاهش مقدار این ضریب، اولویت نقاط دسترسی 2.4GHz را افزایش یا کاهش دهید. مقدار 0.0 باند 2.4GHz را غیرفعال کرده و از اسکن یا اتصال روی آن فرکانس‌ها جلوگیری می‌کند.
BandModifier5GHz مقادیر: مقدار ممیز شناور (پیش‌فرض: 1.0) با افزایش یا کاهش مقدار این ضریب، اولویت نقاط دسترسی 5GHz را افزایش یا کاهش دهید. شبکه‌های 5GHz از قبل به دلیل پهنای باند و نرخ انتقال داده بالاتر ترجیح داده می‌شوند. با این حال، شبکه‌های 5GHz حساسیت بالایی به RSSI دارند، بنابراین هنوز ممکن است IWD در شرایط خاصی نقاط دسترسی 2.4GHz را ترجیح دهد. مقدار 0.0 باند 5GHz را غیرفعال کرده و از اسکن یا اتصال روی آن فرکانس‌ها جلوگیری می‌کند.
BandModifier6GHz مقادیر: مقدار ممیز شناور (پیش‌فرض: 1.0) با افزایش یا کاهش مقدار این ضریب، اولویت نقاط دسترسی 6GHz را افزایش یا کاهش دهید. از آنجا که شبکه‌های 6GHz حساسیت بالایی به RSSI دارند، این گزینه امکانی فراهم می‌کند تا نقاط دسترسی 6GHz را نسبت به نقاط دسترسی 5GHz ترجیح دهید. مقدار 0.0 باند 6GHz را غیرفعال کرده و از اسکن یا اتصال روی آن فرکانس‌ها جلوگیری می‌کند.
HighUtilizationThreshold مقادیر: عدد صحیح بدون علامت 0 - 255 (پیش‌فرض: 0، غیرفعال) هشدار: این یک ویژگی تجربی است آستانه بهره‌برداری BSS که در آن ضریب رتبه منفی بر روی BSS اعمال می‌شود. با افزایش بار برای یک BSS، ضریب رتبه‌بندی به‌صورت نمایی کاهش می‌یابد. در صورتی که میزان بهره‌برداری BSS بالا باشد، تنظیم این مقدار می‌تواند اثرات بسیار شدیدی بر رتبه BSS بگذارد، بنابراین با احتیاط استفاده شود.
HighStationCountThreshold مقادیر: عدد صحیح بدون علامت 0 - 255 (پیش‌فرض: 0، غیرفعال) هشدار: این یک ویژگی تجربی است آستانه تعداد ایستگاه‌های BSS که در آن ضریب رتبه منفی بر روی BSS اعمال می‌شود. با افزایش تعداد ایستگاه‌ها برای یک BSS، ضریب رتبه‌بندی به‌صورت نمایی کاهش می‌یابد. در صورتی که تعداد ایستگاه‌های متصل به BSS بالا باشد، تنظیم این مقدار می‌تواند اثرات بسیار شدیدی بر رتبه BSS بگذارد، با احتیاط استفاده شود.

گروه [Scan] شامل تنظیمات مربوط به قابلیت اسکن است. به‌طور معمول نیازی به تغییر مقادیر پیش‌فرض نیست.

DisablePeriodicScan مقادیر: true، false غیرفعال کردن اسکن دوره‌ای. تنظیم این گزینه روی «true» از انجام اسکن‌های دوره‌ای توسط iwd برای شبکه‌های در دسترس در زمان قطع بودن ارتباط جلوگیری می‌کند. رفتار اسکن‌های آغازشده توسط کاربر تحت تأثیر قرار نمی‌گیرد. اسکن دوره‌ای به‌طور پیش‌فرض فعال است.
InitialPeriodicScanInterval مقادیر: عدد صحیح بدون علامت بر حسب ثانیه (پیش‌فرض: 10) بازه زمانی اولیه برای اسکن دوره‌ای پس از قطع اتصال.
MaximumPeriodicScanInterval مقادیر: عدد صحیح بدون علامت بر حسب ثانیه (پیش‌فرض: 300) حداکثر بازه زمانی برای اسکن دوره‌ای.
DisableRoamingScan مقادیر: true، false غیرفعال کردن اسکن رومینگ. تنظیم این گزینه روی «true» از تلاش iwd برای اسکن در هنگام فعال شدن تصمیمات رومینگ جلوگیری می‌کند. این حالت می‌تواند مانع از رومینگ صحیح iwd شود، اما برای شبکه‌هایی که در سطوح بسیار پایین rssi کار می‌کنند و رومینگ در آن‌ها امکان‌پذیر نیست مفید است.

گروه [IPv4] شامل تنظیمات مربوط به پیکربندی شبکه IPv4 است.

APAddressPool مقادیر: فهرستی از رشته‌های IP با نمادگذاری پیشوند که با کاما جدا شده‌اند فضای آدرس‌های IP مورد استفاده برای زیرشبکه‌های حالت نقطه دسترسی (AP) و کارساز DHCP را تعریف می‌کند. پیش‌فرض 192.168.0.0/16 است. طول پیشوند اندازه استخری را که آدرس از آن انتخاب می‌شود تعیین می‌کند، اما اندازه واقعی زیرشبکه (netmask) بر اساس نمایه AP فعال‌شده تعیین می‌شود و پیش‌فرض آن ۲۸ بیت است. تنظیم [IPv4].Address در نمایه AP مقدار سراسری تعیین‌شده در اینجا را بازنویسی می‌کند. تنظیم فضای آدرس خیلی کوچک، تعداد نقاط دسترسی قابل اجرای همزمان روی رابط‌های مختلف را محدود خواهد کرد.

گروه [DriverQuirks] شامل پرچم‌های ویژه‌ای مرتبط با درایورهایی است که دارای باگ هستند یا رفتارشان با اکثریت درایورهای دیگر تفاوت دارد.

DefaultInterface مقادیر: فهرست جداشده با کاما از درایورها یا تطابق‌های glob اگر درایور در حال استفاده با یکی از موارد این فهرست مطابقت داشته باشد، IWD تلاشی برای حذف و ایجاد مجدد رابط پیش‌فرض نخواهد کرد.
ForcePae مقادیر: فهرست جداشده با کاما از درایورها یا تطابق‌های glob اگر درایور در حال استفاده با یکی از موارد این فهرست مطابقت داشته باشد، از ControlPortOverNL80211 استفاده نخواهد شد و به‌جای آن PAE به کار می‌رود. برخی از درایورها علی‌رغم اینکه اعلام می‌کنند از ControlPortOverNL80211 پشتیبانی می‌کنند، اما پشتیبانی صحیحی از آن ندارند.
PowerSaveDisable مقادیر: فهرست جداشده با کاما از درایورها یا تطابق‌های glob اگر درایور مورد استفاده با یکی از موارد این فهرست مطابقت داشته باشد، صرفه‌جویی در مصرف انرژی (power save) غیرفعال خواهد شد.
MulticastRxDisable مقادیر: فهرست جداشده با کاما از درایورها یا تطابق‌های glob اگر درایور در حال استفاده با یکی از موارد این فهرست مطابقت داشته باشد، دریافت چندپخشی (multicast RX) غیرفعال خواهد شد.
SaeDisable مقادیر: فهرست جداشده با کاما از درایورها یا تطابق‌های glob اگر درایور در حال استفاده با یکی از موارد این فهرست مطابقت داشته باشد، اتصال‌های SAE/WPA3 برای ارتباطات غیرفعال خواهند شد. این امر از اتصال به شبکه‌های صرفاً WPA3 جلوگیری می‌کند، اما با استفاده از WPA2 اتصال به شبکه‌های ترکیبی WPA3/WPA2 را ممکن می‌سازد.

iwd(8)، iwd.network(5)

Marcel Holtmann <marcel@holtmann.org>, Denis Kenzior <denkenz@gmail.com>, Andrew Zaborowski <andrew.zaborowski@intel.com>, Tim Kourt <tim.a.kourt@linux.intel.com>, James Prestwood <prestwoj@gmail.com>

2013-2019 Intel Corporation

22 September 2019 iwd