| NM-SETTINGS-NMCLI(5) | Configuration | NM-SETTINGS-NMCLI(5) |
نام (NAME)
nm-settings - شرح تنظیمات و ویژگیهای نمایههای اتصال NetworkManager برای nmcli
توضیحات (DESCRIPTION)
مدیر شبکه (NetworkManager) بر اساس مفهوم نمایههای اتصال (connection profiles) بنا شده است که گاهی تنها به عنوان اتصال (connection) به آنها اشاره میشود. این نمایههای اتصال شامل پیکربندی شبکه هستند. هنگامی که NetworkManager یک نمایه اتصال را روی یک دستگاه شبکه فعال میکند، پیکربندی اعمال شده و یک اتصال شبکه فعال برقرار خواهد شد. کاربران در ایجاد هر تعداد نمایه اتصال که مناسب بدانند آزاد هستند. بنابراین آنها این انعطافپذیری را دارند که پیکربندیهای شبکه گوناگونی را برای نیازهای مختلف شبکهای داشته باشند.
مدیر شبکه (NetworkManager) یک رابط برنامهنویسی کاربردی (API) برای پیکربندی نمایههای اتصال، فعالسازی آنها جهت پیکربندی شبکه، و بررسی پیکربندی فعلی شبکه فراهم میکند. ابزار خط فرمان nmcli یک برنامه کلاینت برای NetworkManager است که از این API استفاده میکند. برای جزئیات بیشتر به nmcli(1) مراجعه کنید.
با دستوراتی مانند nmcli connection add، nmcli connection modify و nmcli connection show، میتوان نمایههای اتصال را ایجاد، ویرایش و بررسی کرد. یک نمایه از ویژگیها (properties) تشکیل شده است. در D-Bus این قالب از ساختار شرحدادهشده در nm-settings-dbus(5) پیروی میکند، در حالی که این صفحه راهنما قالب تنظیمات را به شکلی که توسط nmcli انتظار میرود توصیف میکند.
تنظیمات و ویژگیهای نشاندادهشده در جدولهای زیر تمام گزینههای موجود برای پیکربندی اتصال را فهرست میکنند. با این حال، توجه داشته باشید که همه تنظیمات برای همه انواع اتصالات قابل اعمال نیستند. ویرایشگر اتصال nmcli همچنین دارای دستور درونی describe است که میتواند توضیحات مربوط به تنظیمات و ویژگیهای خاص این صفحه را نمایش دهد.
مقادیر setting و property را در صورتی که یکتا باشند میتوان بهصورت مختصر نوشت. فهرست زیر همچنین نامهای مستعاری را نشان میدهد که میتوان بدون قید نام کامل بهجای آن استفاده کرد. برای نمونه connection.interface-name و ifname به یک ویژگی یکسان اشاره دارند.
تنظیمات (SETTINGS)
connection setting
تنظیمات عمومی نمایه اتصال.
ویژگیها:
connection.auth-retries
Format: integer
Valid values: -1 - 2147483647
connection.autoconnect
مشخص میکند که آیا در صورت در دسترس بودن منابع، اتصال باید بهطور خودکار توسط NetworkManager برقرار شود یا خیر. مقدار TRUE برای فعالسازی خودکار اتصال، و مقدار FALSE به معنای نیاز به مداخله دستی برای فعالسازی اتصال است.
اتصال خودکار زمانی رخ میدهد که شرایط مناسب باشد؛ این یعنی برای مثال دستگاه در حال حاضر مدیریتشده بوده و فعال نباشد. بنابراین اتصال خودکار هرگز جایگزین یک نمایه فعال نمیشود و با آن رقابت نمیکند.
توجه داشته باشید که اتصال خودکار برای نمایههای VPN پیادهسازی نشده است. گزینه "secondaries" را به عنوان روش جایگزین برای اتصال خودکار نمایههای VPN ببینید.
اگر چندین نمایه برای اتصال خودکار روی یک دستگاه یکسان آماده باشند، نمایهای انتخاب میشود که "connection.autoconnect-priority" بهتری داشته باشد. اگر اولویتها برابر باشند، نمایهای که اخیراً متصل شده فعال میگردد. اگر نمایهها پیشتر متصل نشده باشند یا مقدار "connection.timestamp" آنها یکسان باشد، انتخاب نامشخص است.
بسته به "connection.multi-connect"، یک نمایه میتواند در هر زمان تنها یک بار یا چندین بار متصل (خودکار) شود.
Format: boolean
Valid values: true/yes/on, false/no/off
connection.autoconnect-ports
Format: choice (NMTernary)
Valid values: default (-1), false (0), true (1)
connection.autoconnect-priority
Format: integer
Valid values: -999 - 999
connection.autoconnect-retries
Format: integer
Valid values: -1 - 2147483647
Special values: default (-1), forever (0)
connection.autoconnect-slaves
Deprecated 1.46. Use "autoconnect-ports" instead, this is just an alias.
Format: choice (NMSettingConnectionAutoconnectSlaves)
Valid values: default (-1), no (0), yes (1)
connection.controller
نام رابط دستگاه کنترلکننده یا UUID اتصال کنترلکننده.
Format: string
connection.dns-over-tls
مقادیر مجاز عبارتند از: "yes" (2) استفاده از DNSOverTls و غیرفعالسازی عقبگرد (fallback)، مقدار "opportunistic" (1) استفاده از DNSOverTls با امکان بازگشت به وضوحبخشی رمزگذارینشده، مقدار "no" (0) هرگز از DNSOverTls استفاده نشود. در صورت مشخص نشدن، "default" به پلاگین مورد استفاده بستگی دارد. ابزار systemd-resolved از تنظیم سراسری استفاده میکند.
این قابلیت نیازمند پلاگینی است که از DNSOverTls پشتیبانی کند؛ در غیر این صورت، این تنظیم هیچ اثری نخواهد داشت. یکی از این پلاگینها dns-systemd-resolved است.
Format: choice (NMSettingConnectionDnsOverTls)
Valid values: default (-1), no (0), opportunistic (1), yes (2)
connection.dnssec
مقادیر مجاز عبارتند از: "yes" (2) استفاده از DNSSEC و غیرفعالسازی عقبگرد، مقدار "allow-downgrade" (1) استفاده از DNSSEC با امکان بازگشت در صورتی که کارساز (سرور) از آن پشتیبانی نکند، مقدار "no" (0) هرگز از DNSSEC استفاده نشود. تأثیر "default" (-1) به پلاگین dns مورد استفاده بستگی دارد. سرویس systemd-resolved در این حالت از تنظیم سراسری خود استفاده میکند.
این قابلیت به پلاگینی نیاز دارد که از DNSSEC پشتیبانی کند؛ در غیر این صورت، این تنظیم اثری نخواهد داشت. یکی از این پلاگینها systemd-resolved است.
Format: choice (NMSettingConnectionDnssec)
Valid values: default (-1), no (0), allow-downgrade (1), yes (2)
connection.down-on-poweroff
Format: choice (NMSettingConnectionDownOnPoweroff)
Valid values: default (-1), no (0), yes (1)
connection.gateway-ping-timeout
Format: integer
Valid values: 0 - 600
connection.id
یک شناسه یکتا و قابلخواندن برای انسان برای اتصال، مانند "Work Wi-Fi" یا "T-Mobile 3G".
Format: string
connection.interface-name
نام رابط شبکهای که این اتصال به آن متصل (مقید) شده است. در صورت تنظیم نشدن، اتصال میتواند به هر رابطی از نوع مناسب متصل شود (مشروط به محدودیتهای اعمالشده توسط سایر تنظیمات).
برای دستگاههای نرمافزاری، این ویژگی نام دستگاه ایجادشده را مشخص میکند.
برای انواع اتصالاتی که نام رابطها در آنها به سادگی پایدار نمیماند (مانند اینترنت همراه یا اترنت USB)، این ویژگی نباید استفاده شود. تنظیم این ویژگی رابطهایی را که اتصال میتواند با آنها استفاده شود محدود میکند، و اگر نام رابطها تغییر کند یا بازترتیب شوند، اتصال ممکن است روی رابط اشتباهی اعمال گردد.
Format: string
connection.ip-ping-addresses
Format: list of IPv4 or IPv6 addresses
connection.ip-ping-addresses-require-all
Format: choice (NMTernary)
Valid values: default (-1), false/no (0), true/yes (1)
connection.ip-ping-timeout
Format: integer
Valid values: 0 - 600
connection.lldp
Format: choice (NMSettingConnectionLldp)
Valid values: default (-1), disable (0), enable-rx/enable (1)
connection.llmnr
مقادیر مجاز عبارتند از: "yes" (2) ثبت نام میزبان و وضوحبخشی برای اتصال، "no" (0) غیرفعالسازی LLMNR برای رابط، "resolve" (1) نام میزبان ثبت نشود اما وضوحبخشی نامهای میزبان LLMNR مجاز باشد. در صورت تعیین نشدن، "default" در نهایت به پلاگین DNS بستگی دارد (که در حال حاضر برای systemd-resolved به معنای "yes" است).
این قابلیت نیازمند پلاگینی است که از LLMNR پشتیبانی کند؛ در غیر این صورت، این تنظیم اثری نخواهد داشت. یکی از این پلاگینها dns-systemd-resolved است.
Format: choice (NMSettingConnectionLlmnr)
Valid values: default (-1), no (0), resolve (1), yes (2)
connection.master
نام رابط دستگاه کنترلکننده یا UUID اتصال کنترلکننده.
Deprecated 1.46. Use "controller" instead, this is just an alias.
Format: string
connection.mdns
مقادیر مجاز عبارتند از: "yes" (2) ثبت نام میزبان و وضوحبخشی برای اتصال، "no" (0) غیرفعالسازی mDNS برای رابط، "resolve" (1) نام میزبان ثبت نشود اما وضوحبخشی نامهای میزبان mDNS مجاز باشد و "default" (-1) برای بررسی پیشفرض سراسری در NetworkManager.conf. در صورت تعیین نشدن، "default" در نهایت به پلاگین DNS بستگی دارد.
این قابلیت نیازمند پلاگینی است که از mDNS پشتیبانی کند؛ در غیر این صورت، این تنظیم هیچ اثری ندارد. در حال حاضر تنها پلاگین DNS پشتیبانیشده systemd-resolved است. برای systemd-resolved، مقدار پیشفرض از طریق تنظیم MulticastDNS= در فایل resolved.conf قابل پیکربندی است.
Format: choice (NMSettingConnectionMdns)
Valid values: default (-1), no (0), resolve (1), yes (2)
connection.metered
هنگام بهروزرسانی این ویژگی روی اتصالی که در حال حاضر فعال است، تغییر فوراً اعمال میشود.
Format: ternary
Valid values: true/yes/on, false/no/off, default/unknown
connection.mptcp-flags
اگر "disabled" (0x1) باشد، مدیریت MPTCP برای رابط غیرفعال شده و هیچ نقطه پایانی ثبت نمیشود.
فلگ "enabled" (0x2) به معنای فعال بودن مدیریت MPTCP است. این فلگ میتواند از حضور سایر فلگها نیز استنباط شود.
حتی در صورت فعال بودن، مدیریت MPTCP بهطور پیشفرض غیرفعال خواهد ماند مگر اینکه پارامتر sysctl به نشانی "/proc/sys/net/mptcp/enabled" روشن باشد. مدیر شبکه مقدار sysctl را تغییر نمیدهد و این به عهده مدیر سیستم یا توزیع است. برای پیکربندی نقاط پایانی حتی در صورت غیرفعال بودن این sysctl، میتوان از فلگ "also-without-sysctl" (0x4) استفاده کرد. در این حالت، NetworkManager پارامتر sysctl را نادیده گرفته و صرفنظر از آن نقاط پایانی را پیکربندی میکند.
حتی در صورت فعال بودن، NetworkManager تنها در صورتی نقاط پایانی MPTCP را برای یک خانواده آدرس خاص پیکربندی میکند که یک مسیر پیشفرض تکپخشی (0.0.0.0/0 یا ::/0) در جدول مسیریابی اصلی وجود داشته باشد. فلگ "also-without-default-route" (0x8) میتواند این رفتار را نادیده بگیرد (بازنویسی کند).
هنگامی که مدیریت MPTCP فعال باشد، نقاط پایانی با فلگهای آدرس تعیینشده "signal" (0x10)، "subflow" (0x20)، "backup" (0x40)، "fullmesh" (0x80)، "laminar" (0x100) پیکربندی میشوند. برای اطلاعات بیشتر درباره فلگها به راهنمای ip-mptcp(8) مراجعه کنید.
اگر فلگها صفر (0x0) باشند، پیشفرض سراسری اتصال از فایل NetworkManager.conf رعایت میشود. در صورت مشخص نشدن، مقدار بازگشتی "enabled,subflow" است. توجه داشته باشید که این بدان معناست که MPTCP بهطور پیشفرض بسته به sysctl مسیر "/proc/sys/net/mptcp/enabled" انجام میشود.
مدیر شبکه محدودیتهای MPTCP را تغییر نمیدهد و MPTCP را از طریق "/proc/sys/net/mptcp/enabled" فعال نمیکند. این یک پیکربندی میزبان است که مدیر سیستم میتواند از طریق sysctl و ip-mptcp آن را تغییر دهد.
پالایش سختگیرانه مسیر معکوس (rp_filter) بسیاری از سناریوهای استفاده از MPTCP را مختل میکند؛ بنابراین وقتی مدیریت MPTCP برای نشانیهای IPv4 روی رابط فعال باشد، NetworkManager پالایش سختگیرانه مسیر معکوس (1) را به حالت منعطف (2) تقلیل میدهد.
Format: flags (NMMptcpFlags)
Valid values: none/default (0x0), disabled (0x1), enabled (0x2), also-without-sysctl (0x4), also-without-default-route (0x8), signal (0x10), subflow (0x20), backup (0x40), fullmesh (0x80), laminar (0x100)
connection.mud-url
مقدار ویژه "none" برای نشان دادن عدم استفاده از نشانی اینترنتی MUD مجاز است.
اگر مقدار مربوط به هر نمایه نامشخص باشد (حالت پیشفرض)، پیشفرض سراسری اتصال بررسی میشود. در صورت تعیین نشدن، پیشفرض نهایی "none" است.
Format: string
connection.multi-connect
Format: choice (NMConnectionMultiConnect)
Valid values: default (0), single (1), manual-multiple (2), multiple (3)
connection.permissions
در حال حاضر تنها نوع "[type]" مجاز، "user" است. سایر مقادیر نادیده گرفته شده و برای کاربردهای آینده رزرو شدهاند. شناسه [id] نام کاربری است که این مجوز به آن اشاره دارد و نباید شامل نویسه ":" باشد. هر اطلاعات [reserved] موجود باید نادیده گرفته شود و برای کاربردهای آینده رزرو است. تمامی بخشهای [type]، [id] و [reserved] باید UTF-8 معتبر باشند.
Format: list of strings
connection.port-type
نام تنظیم نوع دستگاه اتصال کنترلکننده این پورت (مانند "bond")، یا مقدار NULL اگر این اتصال پورت نباشد.
Format: string
Valid values: bond, bridge, ovs-bridge, ovs-port, team, vrf
connection.secondaries
Format: list of strings
connection.slave-type
نام تنظیم نوع دستگاه اتصال کنترلکننده این پورت (مانند "bond")، یا مقدار NULL اگر این اتصال پورت نباشد.
Deprecated 1.46. Use "port-type" instead, this is just an alias.
Format: string
Valid values: bond, bridge, ovs-bridge, ovs-port, team, vrf
connection.stable-id
شناسه stable-id برای تولید نشانیهای خصوصی پایدار IPv6 با تنظیم ipv6.addr-gen-mode=stable-privacy استفاده میشود. همچنین برای مقداردهی اولیه تولید آدرس MAC شبیهسازیشده در ethernet.cloned-mac-address=stable و wifi.cloned-mac-address=stable به کار میرود. همچنین برای استخراج شناسه کلاینت DHCP در ipv4.dhcp-client-id=stable، شناسه DHCPv6 DUID در ipv6.dhcp-duid=stable-[llt,ll,uuid] و DHCP IAID در ipv4.iaid=stable و ipv6.iaid=stable کاربرد دارد.
توجه داشته باشید که بسته به زمینهای که در آن استفاده میشود، پارامترهای دیگری نیز به الگوریتم تولید تزریق میشوند. به عنوان نمونه، معمولاً یک کلید اختصاصی هر میزبان نیز گنجانده میشود تا سیستمهای مختلف شناسههای متفاوتی تولید کنند. یا با ipv6.addr-gen-mode=stable-privacy، نام دستگاه نیز گنجانده میشود تا رابطهای مختلف نشانیهای متفاوتی تولید کنند. کلید اختصاصی هر میزبان هویت دستگاه شماست و در مسیر /var/lib/NetworkManager/secret_key ذخیره میشود. برای اطلاعات درباره secret-key و هویت میزبان، صفحه راهنمای NetworkManager(8) را ببینید.
با نویسه '$' برای انجام جایگزینیهای پویا در زمان فعالسازی به شکل ویژهای رفتار میشود. در حال حاضر، الگوهای "${CONNECTION}"، "${DEVICE}"، "${MAC}"، "${NETWORK_SSID}"، "${BOOT}" و "${RANDOM}" پشتیبانی میشوند. اینها به طور موثری شناسههای یکتایی به ازای هر اتصال، هر دستگاه، هر SSID، هر بوت، یا هر بار ایجاد میکنند. الگوی "${CONNECTION}" از connection.uuid نمایه استفاده میکند، "${DEVICE}" از نام رابط دستگاه استفاده میکند و "${MAC}" از نشانی MAC دائمی دستگاه استفاده میکند. الگوی "${NETWORK_SSID}" از SSID برای شبکههای Wi-Fi استفاده کرده و در سایر شبکهها به "${CONNECTION}" بازمیگردد. هرگونه الگوی ناشناخته پس از '$' به صورت لفظی در نظر گرفته میشود اما برای استفادههای آینده محفوظ است. بنابراین توصیه میشود از '$' خودداری کرده یا آن را به صورت "$$" اسکیپ کنید. برای نمونه، آن را روی "${CONNECTION}-${BOOT}-${DEVICE}" تنظیم کنید تا یک شناسه یکتا برای این اتصال ایجاد شود که با هر بار راهاندازی مجدد تغییر کرده و بسته به رابطی که نمایه در آن فعال میشود تفاوت داشته باشد.
اگر مقدار تنظیم نشده باشد، پیشفرض سراسری اتصال بررسی میشود. اگر همچنان تنظیم نشده باشد، پیشفرض "default${CONNECTION}" است تا یک شناسه یکتا به ازای هر نمایه اتصال ایجاد شود.
Format: string
connection.timestamp
مدیر شبکه زمان اتصال (timestamp) را هنگامی که اتصال فعال است بهصورت دورهای بهروزرسانی میکند تا اطمینان حاصل شود که اتصال فعال دارای جدیدترین برچسب زمانی است. این ویژگی تنها برای خواندن است (تغییرات در این ویژگی حفظ نخواهد شد).
Format: read only
connection.type
نوع پایه اتصال. برای اتصالات وابسته به سختافزار، باید شامل نام تنظیم مربوط به نوع سختافزار خاص باشد (مانند "802-3-ethernet" یا "802-11-wireless" یا "bluetooth" و غیره)، و برای اتصالات غیروابسته به سختافزار مانند VPN یا موارد دیگر، باید شامل نام تنظیم مربوط به آن نوع باشد (مانند "vpn" یا "bridge" و غیره).
Format: string
Valid values: 6lowpan, 802-11-olpc-mesh, 802-11-wireless, 802-3-ethernet, adsl, bluetooth, bond, bridge, cdma, dummy, generic, geneve, gsm, hsr, infiniband, ip-tunnel, ipvlan, loopback, macsec, macvlan, ovs-bridge, ovs-interface, ovs-port, pppoe, team, tun, veth, vlan, vpn, vrf, vxlan, wifi-p2p, wimax, wireguard, wpan
connection.uuid
شناسه UUID را نمیتوان تغییر داد، مگر در حالت برونخط (آفلاین). در آن حالت، مقادیر ویژه "new"، "generate" و "" برای تولید یک UUID تصادفی جدید مجاز هستند.
Format: a valid RFC4122 universally unique identifier (UUID).
connection.wait-activation-delay
مقدار 0 به معنای عدم انتظار است. مقدار پیشفرض -1 است که در حال حاضر همان معنای عدم انتظار را دارد.
Format: integer
Valid values: -1 - 2147483647
connection.wait-device-timeout
مقدار 0 به معنای عدم انتظار است. مقدار پیشفرض -1 است که در حال حاضر همان معنای عدم انتظار را دارد.
Format: integer
Valid values: -1 - 2147483647
connection.zone
هنگام بهروزرسانی این ویژگی روی اتصالی که در حال حاضر فعال است، تغییر فوراً اعمال میشود.
Format: string
6lowpan setting
تنظیمات 6LoWPAN.
ویژگیها:
6lowpan.parent
در صورت تعیین، نام رابط والد یا UUID اتصال والدی را مشخص میکند که این رابط 6LowPAN باید از آن ایجاد شود.
Format: string
802-1x setting
تنظیمات احراز هویت IEEE 802.1x.
ویژگیها:
802-1x.altsubject-matches
Format: list of strings
802-1x.anonymous-identity
Format: string
802-1x.auth-timeout
Format: integer
Valid values: 0 - 2147483647
802-1x.ca-cert
این ویژگی میتواند تنظیمنشده باقی بماند حتی اگر روش EAP از گواهیهای CA پشتیبانی کند، اما این کار امکان حملات مرد میانی (man-in-the-middle) را فراهم میکند و توصیه نمیشود.
توجه داشته باشید که فعال کردن 802-1x.system-ca-certs این تنظیم را بازنویسی میکند تا از مسیر توکار استفاده شود، به شرطی که مسیر توکار یک دایرکتوری نباشد.
Format: filesystem path
802-1x.ca-cert-password
Format: string
802-1x.ca-cert-password-flags
Format: flags (NMSettingSecretFlags)
Valid values: none (0x0), agent-owned (0x1), not-saved (0x2), not-required (0x4)
802-1x.ca-path
اگر NMSetting8021x:system-ca-certs فعال باشد و مسیر توکار CA یک دایرکتوری موجود باشد، این تنظیم نادیده گرفته میشود.
Format: string
802-1x.client-cert
Format: filesystem path
802-1x.client-cert-password
Format: string
802-1x.client-cert-password-flags
Format: flags (NMSettingSecretFlags)
Valid values: none (0x0), agent-owned (0x1), not-saved (0x2), not-required (0x4)
802-1x.domain-match
Format: string
802-1x.domain-suffix-match
Format: string
802-1x.eap
Format: list of strings
Valid values: leap, md5, tls, peap, ttls, sim, fast, pwd
802-1x.identity
Format: string
802-1x.openssl-ciphers
Format: string
802-1x.optional
Format: boolean
Valid values: true/yes/on, false/no/off
802-1x.pac-file
Format: string
802-1x.password
Format: string
802-1x.password-flags
Format: flags (NMSettingSecretFlags)
Valid values: none (0x0), agent-owned (0x1), not-saved (0x2), not-required (0x4)
802-1x.password-raw
Format: bytes
802-1x.password-raw-flags
Format: flags (NMSettingSecretFlags)
Valid values: none (0x0), agent-owned (0x1), not-saved (0x2), not-required (0x4)
802-1x.phase1-auth-flags
Format: flags (NMSetting8021xAuthFlags)
Valid values: none (0x0), tls-1-0-disable (0x1), tls-1-1-disable (0x2), tls-1-2-disable (0x4), tls-disable-time-checks (0x8), tls-1-3-disable (0x10), tls-1-0-enable (0x20), tls-1-1-enable (0x40), tls-1-2-enable (0x80), tls-1-3-enable (0x100), all (0x1ff)
802-1x.phase1-fast-provisioning
Format: string
Valid values: 0, 1, 2, 3
802-1x.phase1-peaplabel
Format: string
Valid values: 0, 1
802-1x.phase1-peapver
Format: string
Valid values: 0, 1
802-1x.phase2-altsubject-matches
Format: list of strings
802-1x.phase2-auth
Format: string
Valid values: pap, chap, mschap, mschapv2, gtc, otp, md5, tls
802-1x.phase2-autheap
Format: string
Valid values: md5, mschapv2, otp, gtc, tls
802-1x.phase2-ca-cert
این ویژگی میتواند تنظیمنشده باقی بماند حتی اگر روش EAP از گواهیهای CA پشتیبانی کند، اما این کار امکان حملات مرد میانی (man-in-the-middle) را فراهم میکند و توصیه نمیشود.
توجه داشته باشید که فعال کردن 802-1x.system-ca-certs این تنظیم را بازنویسی میکند تا از مسیر توکار استفاده شود، به شرطی که مسیر توکار یک دایرکتوری نباشد.
Format: filesystem path
802-1x.phase2-ca-cert-password
Format: string
802-1x.phase2-ca-cert-password-flags
Format: flags (NMSettingSecretFlags)
Valid values: none (0x0), agent-owned (0x1), not-saved (0x2), not-required (0x4)
802-1x.phase2-ca-path
اگر NMSetting8021x:system-ca-certs فعال باشد و مسیر توکار CA یک دایرکتوری موجود باشد، این تنظیم نادیده گرفته میشود.
Format: filesystem path
802-1x.phase2-client-cert
Format: filesystem path
802-1x.phase2-client-cert-password
Format: string
802-1x.phase2-client-cert-password-flags
Format: flags (NMSettingSecretFlags)
Valid values: none (0x0), agent-owned (0x1), not-saved (0x2), not-required (0x4)
802-1x.phase2-domain-match
Format: string
802-1x.phase2-domain-suffix-match
Format: string
802-1x.phase2-private-key
Format: filesystem path
802-1x.phase2-private-key-password
Format: string
802-1x.phase2-private-key-password-flags
Format: flags (NMSettingSecretFlags)
Valid values: none (0x0), agent-owned (0x1), not-saved (0x2), not-required (0x4)
802-1x.phase2-subject-match
این ویژگی از نسخه 1.2 منسوخ شده است. در عوض از "phase2-domain-suffix-match" استفاده کنید.
Format: string
802-1x.pin
Format: string
802-1x.pin-flags
Format: flags (NMSettingSecretFlags)
Valid values: none (0x0), agent-owned (0x1), not-saved (0x2), not-required (0x4)
802-1x.private-key
Format: filesystem path
802-1x.private-key-password
Format: string
802-1x.private-key-password-flags
Format: flags (NMSettingSecretFlags)
Valid values: none (0x0), agent-owned (0x1), not-saved (0x2), not-required (0x4)
802-1x.subject-match
این ویژگی از نسخه 1.2 منسوخ شده است. در عوض از "phase2-domain-suffix-match" استفاده کنید.
Format: string
802-1x.system-ca-certs
Format: boolean
Valid values: true/yes/on, false/no/off
adsl setting
تنظیمات ADSL.
ویژگیها:
adsl.encapsulation
کپسولهسازی اتصال ADSL. میتواند "vcmux" یا "llc" باشد.
Format: string
Valid values: vcmux, llc
adsl.password
گذرواژه استفادهشده برای احراز هویت در سرویس ADSL.
Format: string
adsl.password-flags
Format: flags (NMSettingSecretFlags)
Valid values: none (0x0), agent-owned (0x1), not-saved (0x2), not-required (0x4)
adsl.protocol
پروتکل اتصال ADSL. میتواند "pppoa", "pppoe" یا "ipoatm" باشد.
Format: string
Valid values: pppoa, pppoe, ipoatm
adsl.username
نام کاربری استفادهشده برای احراز هویت در سرویس ADSL.
Format: string
adsl.vci
Format: integer
Valid values: 0 - 65536
adsl.vpi
Format: integer
Valid values: 0 - 65536
bluetooth setting
تنظیمات بلوتوث (Bluetooth).
ویژگیها:
bluetooth.bdaddr
آدرس بلوتوث دستگاه.
Format: MAC address
bluetooth.type
یا "dun" برای اتصالات Dial-Up Networking یا "panu" برای اتصالات Personal Area Networking به دستگاههایی که از نمایه NAP پشتیبانی میکنند.
Format: string
Valid values: dun, panu, nap
bond setting
تنظیمات پیوند (Bonding).
ویژگیها:
bond.options
Format: list of key/value options
bridge setting
تنظیمات پل (Bridging).
ویژگیها:
bridge.ageing-time
زمان کهنگی (aging time) آدرس MAC اترنت، بر حسب ثانیه.
Format: integer
Valid values: 0 - 1000000
bridge.forward-delay
تاخیر ارسال پروتکل درخت پوشا (STP)، بر حسب ثانیه.
Format: integer
Valid values: 0 - 30
bridge.group-address
آدرس باید یک آدرس پیوند-محلی (link-local) در قالب استاندارد آدرس MAC اترنت باشد، یعنی آدرسی به شکل 01:80:C2:00:00:0X، که X در [0, 4..F] است. در صورت تعییننشدن، مقدار پیشفرض 01:80:C2:00:00:00 است.
Format: MAC address
bridge.group-forward-mask
ماسک آدرسهای گروه برای هدایت به جلو. معمولاً، آدرسهای گروه در محدوده 01:80:C2:00:00:00 تا 01:80:C2:00:00:0F بر اساس استانداردها به جلو هدایت نمیشوند. این ویژگی یک ماسک ۱۶ بیتی است که هر بیت آن متناظر با یک آدرس گروه در آن محدوده است که باید به جلو هدایت شود. این ماسک نمیتواند بیتهای 0، 1 یا 2 را فعال داشته باشد زیرا آنها برای STP، فریمهای مکث MAC و LACP استفاده میشوند.
Format: integer
Valid values: 0 - 65535
bridge.hello-time
زمان hello در پروتکل درخت پوشا (STP)، بر حسب ثانیه.
Format: integer
Valid values: 0 - 10
bridge.mac-address
در صورت تعیین، آدرس MAC پل. هنگام ایجاد یک پل جدید، این آدرس MAC تنظیم خواهد شد.
اگر این فیلد تعییننشده رها شود، به جای آن به "ethernet.cloned-mac-address" ارجاع داده میشود تا آدرس MAC اولیه ایجاد شود. توجه داشته باشید که تنظیم "ethernet.cloned-mac-address" در هر صورت بعداً هنگام فعالسازی پل، آدرس MAC پل را بازنویسی میکند.
این ویژگی از نسخه 1.12 منسوخ شده است. به جای آن از ویژگی "cloned-mac-address" استفاده کنید.
Format: MAC address
bridge.max-age
حداکثر عمر پیام در پروتکل درخت پوشا (STP)، بر حسب ثانیه.
Format: integer
Valid values: 0 - 40
bridge.multicast-hash-max
Format: integer
Valid values: 1 - 4294967295
bridge.multicast-last-member-count
Format: integer
Valid values: 0 - 4294967295
bridge.multicast-last-member-interval
Format: integer
Valid values: 0 - 18446744073709551615
bridge.multicast-membership-interval
Format: integer
Valid values: 0 - 18446744073709551615
bridge.multicast-querier
Format: boolean
Valid values: true/yes/on, false/no/off
bridge.multicast-querier-interval
Format: integer
Valid values: 0 - 18446744073709551615
bridge.multicast-query-interval
Format: integer
Valid values: 0 - 18446744073709551615
bridge.multicast-query-response-interval
Format: integer
Valid values: 0 - 18446744073709551615
bridge.multicast-query-use-ifaddr
Format: boolean
Valid values: true/yes/on, false/no/off
bridge.multicast-router
مقادیر پشتیبانیشده عبارتند از: 'auto'، 'disabled'، 'enabled' که هسته به ترتیب اعداد 1، 0 و 2 را به آنها اختصاص میدهد. در صورت تعییننشدن، مقدار پیشفرض 'auto' (1) است.
Format: string
Valid values: auto, disabled, enabled
bridge.multicast-snooping
کنترل میکند که آیا ردیابی IGMP (IGMP snooping) برای این پل فعال باشد یا خیر. توجه داشته باشید اگر ردیابی به دلیل برخورد درهمسازی (hash collision) به طور خودکار غیرفعال شده باشد، سیستم ممکن است تا زمان حل برخوردها از فعال کردن این ویژگی خودداری کند.
Format: boolean
Valid values: true/yes/on, false/no/off
bridge.multicast-startup-query-count
Format: integer
Valid values: 0 - 4294967295
bridge.multicast-startup-query-interval
Format: integer
Valid values: 0 - 18446744073709551615
bridge.priority
اولویت پروتکل درخت پوشا (STP) را برای این پل تنظیم میکند. مقادیر کمتر «بهتر» هستند؛ پلی که کمترین اولویت را دارد به عنوان پل ریشه (root bridge) انتخاب خواهد شد.
Format: integer
Valid values: 0 - 65535
bridge.stp
کنترل میکند که آیا پروتکل درخت پوشا (STP) برای این پل فعال باشد یا خیر.
Format: boolean
Valid values: true/yes/on, false/no/off
bridge.vlan-default-pvid
Format: integer
Valid values: 0 - 4094
bridge.vlan-filtering
Format: boolean
Valid values: true/yes/on, false/no/off
bridge.vlan-protocol
مقادیر پشتیبانیشده عبارتند از: '802.1Q'، '802.1ad'. در صورت تعییننشدن، مقدار پیشفرض '802.1Q' است.
Format: string
Valid values: 802.1Q, 802.1ad
bridge.vlan-stats-enabled
Format: boolean
Valid values: true/yes/on, false/no/off
bridge.vlans
در nmcli فهرست VLAN را میتوان با نحو زیر مشخص کرد:
$vid [pvid] [untagged] [, $vid [pvid] [untagged]]...
که در آن vid$ یا یک شناسه واحد بین 1 و 4094 است یا محدودهای از شناسهها که با یک خط تیره از هم جدا شدهاند.
Format: list of bridge.vlans objects
bridge-port setting
تنظیمات درگاه پل (Bridge Port).
ویژگیها:
bridge-port.hairpin-mode
«حالت سنجاقسری» (hairpin mode) را برای درگاه فعال یا غیرفعال میکند، که به فریمها اجازه میدهد از همان درگاهی که دریافت شدهاند دوباره به بیرون ارسال شوند.
Format: boolean
Valid values: true/yes/on, false/no/off
bridge-port.path-cost
هزینه مسیر در پروتکل درخت پوشا (STP) برای مقصدهای از طریق این درگاه.
Format: integer
Valid values: 0 - 65535
bridge-port.priority
اولویت پروتکل درخت پوشا (STP) این درگاه پل.
Format: integer
Valid values: 0 - 63
bridge-port.vlans
در nmcli فهرست VLAN را میتوان با نحو زیر مشخص کرد:
$vid [pvid] [untagged] [, $vid [pvid] [untagged]]...
که در آن vid$ یا یک شناسه واحد بین 1 و 4094 است یا محدودهای از شناسهها که با یک خط تیره از هم جدا شدهاند.
Format: list of bridge-port.vlans objects
cdma setting
تنظیمات پهنباند همراه مبتنی بر CDMA.
ویژگیها:
cdma.mtu
Format: integer
Special values: auto
cdma.number
Format: string
cdma.password
گذرواژه استفادهشده برای احراز هویت در شبکه، در صورت نیاز. بسیاری از ارائهدهندگان به گذرواژه نیاز ندارند یا هر گذرواژهای را میپذیرند. اما اگر گذرواژهای لازم باشد، در اینجا مشخص میشود.
Format: string
cdma.password-flags
Format: flags (NMSettingSecretFlags)
Valid values: none (0x0), agent-owned (0x1), not-saved (0x2), not-required (0x4)
cdma.username
نام کاربری استفادهشده برای احراز هویت در شبکه، در صورت نیاز. بسیاری از ارائهدهندگان به نام کاربری نیاز ندارند یا هر نام کاربری را میپذیرند. اما اگر نام کاربری لازم باشد، در اینجا مشخص میشود.
Format: string
dcb setting
تنظیمات پلبندی مرکز داده (DCB).
ویژگیها:
dcb.app-fcoe-flags
Format: flags (NMSettingDcbFlags)
Valid values: none (0x0), enable (0x1), advertise (0x2), willing (0x4)
dcb.app-fcoe-mode
از نسخه ۱.۳۴، مقدار NULL پیشفرض است و به معنی «fabric» میباشد. قبل از ۱.۳۴، مقدار NULL نامعتبر شناخته میشد و پیشفرض «fabric» بود.
Format: string
Valid values: fabric, vn2vn
dcb.app-fcoe-priority
Format: integer
Valid values: -1 - 7
Special values: unset (-1)
dcb.app-fip-flags
Format: flags (NMSettingDcbFlags)
Valid values: none (0x0), enable (0x1), advertise (0x2), willing (0x4)
dcb.app-fip-priority
Format: integer
Valid values: -1 - 7
Special values: unset (-1)
dcb.app-iscsi-flags
Format: flags (NMSettingDcbFlags)
Valid values: none (0x0), enable (0x1), advertise (0x2), willing (0x4)
dcb.app-iscsi-priority
Format: integer
Valid values: -1 - 7
Special values: unset (-1)
dcb.priority-bandwidth
Format: list of integers
Valid values: 0 - 100
dcb.priority-flow-control
Format: list of booleans
Valid values: true/yes/on, false/no/off
dcb.priority-flow-control-flags
Format: flags (NMSettingDcbFlags)
Valid values: none (0x0), enable (0x1), advertise (0x2), willing (0x4)
dcb.priority-group-bandwidth
Format: list of integers
Valid values: 0 - 100
dcb.priority-group-flags
Format: flags (NMSettingDcbFlags)
Valid values: none (0x0), enable (0x1), advertise (0x2), willing (0x4)
dcb.priority-group-id
Format: list of integers
Valid values: 0 - 7, 15
dcb.priority-strict-bandwidth
Format: list of booleans
Valid values: true/yes/on, false/no/off
dcb.priority-traffic-class
Format: list of integers
Valid values: 0 - 7
ethtool setting
تنظیمات اترنت Ethtool.
ویژگیها:
ethtool.channels-combined
Valid values: 0 - 4294967295
ethtool.channels-other
Valid values: 0 - 4294967295
ethtool.channels-rx
Valid values: 0 - 4294967295
ethtool.channels-tx
Valid values: 0 - 4294967295
ethtool.coalesce-adaptive-rx
Valid values: 0 - 4294967295
ethtool.coalesce-adaptive-tx
Valid values: 0 - 4294967295
ethtool.coalesce-pkt-rate-high
Valid values: 0 - 4294967295
ethtool.coalesce-pkt-rate-low
Valid values: 0 - 4294967295
ethtool.coalesce-rx-frames
Valid values: 0 - 4294967295
ethtool.coalesce-rx-frames-high
Valid values: 0 - 4294967295
ethtool.coalesce-rx-frames-irq
Valid values: 0 - 4294967295
ethtool.coalesce-rx-frames-low
Valid values: 0 - 4294967295
ethtool.coalesce-rx-usecs
Valid values: 0 - 4294967295
ethtool.coalesce-rx-usecs-high
Valid values: 0 - 4294967295
ethtool.coalesce-rx-usecs-irq
Valid values: 0 - 4294967295
ethtool.coalesce-rx-usecs-low
Valid values: 0 - 4294967295
ethtool.coalesce-sample-interval
Valid values: 0 - 4294967295
ethtool.coalesce-stats-block-usecs
Valid values: 0 - 4294967295
ethtool.coalesce-tx-frames
Valid values: 0 - 4294967295
ethtool.coalesce-tx-frames-high
Valid values: 0 - 4294967295
ethtool.coalesce-tx-frames-irq
Valid values: 0 - 4294967295
ethtool.coalesce-tx-frames-low
Valid values: 0 - 4294967295
ethtool.coalesce-tx-usecs
Valid values: 0 - 4294967295
ethtool.coalesce-tx-usecs-high
Valid values: 0 - 4294967295
ethtool.coalesce-tx-usecs-irq
Valid values: 0 - 4294967295
ethtool.coalesce-tx-usecs-low
Valid values: 0 - 4294967295
ethtool.eee-enabled
Valid values: on, off, ignore
ethtool.feature-esp-hw-offload
Valid values: on, off, ignore
ethtool.feature-esp-tx-csum-hw-offload
Valid values: on, off, ignore
ethtool.feature-fcoe-mtu
Valid values: on, off, ignore
ethtool.feature-gro
Valid values: on, off, ignore
ethtool.feature-gso
Valid values: on, off, ignore
ethtool.feature-highdma
Valid values: on, off, ignore
ethtool.feature-hw-tc-offload
Valid values: on, off, ignore
ethtool.feature-l2-fwd-offload
Valid values: on, off, ignore
ethtool.feature-loopback
Valid values: on, off, ignore
ethtool.feature-lro
Valid values: on, off, ignore
ethtool.feature-macsec-hw-offload
Valid values: on, off, ignore
ethtool.feature-ntuple
Valid values: on, off, ignore
ethtool.feature-rx
Valid values: on, off, ignore
ethtool.feature-rx-all
Valid values: on, off, ignore
ethtool.feature-rx-fcs
Valid values: on, off, ignore
ethtool.feature-rx-gro-hw
Valid values: on, off, ignore
ethtool.feature-rx-gro-list
Valid values: on, off, ignore
ethtool.feature-rx-udp-gro-forwarding
Valid values: on, off, ignore
ethtool.feature-rx-udp_tunnel-port-offload
Valid values: on, off, ignore
ethtool.feature-rx-vlan-filter
Valid values: on, off, ignore
ethtool.feature-rx-vlan-stag-filter
Valid values: on, off, ignore
ethtool.feature-rx-vlan-stag-hw-parse
Valid values: on, off, ignore
ethtool.feature-rxhash
Valid values: on, off, ignore
ethtool.feature-rxvlan
Valid values: on, off, ignore
ethtool.feature-sg
Valid values: on, off, ignore
ethtool.feature-tls-hw-record
Valid values: on, off, ignore
ethtool.feature-tls-hw-rx-offload
Valid values: on, off, ignore
ethtool.feature-tls-hw-tx-offload
Valid values: on, off, ignore
ethtool.feature-tso
Valid values: on, off, ignore
ethtool.feature-tx
Valid values: on, off, ignore
ethtool.feature-tx-checksum-fcoe-crc
Valid values: on, off, ignore
ethtool.feature-tx-checksum-ip-generic
Valid values: on, off, ignore
ethtool.feature-tx-checksum-ipv4
Valid values: on, off, ignore
ethtool.feature-tx-checksum-ipv6
Valid values: on, off, ignore
ethtool.feature-tx-checksum-sctp
Valid values: on, off, ignore
ethtool.feature-tx-esp-segmentation
Valid values: on, off, ignore
ethtool.feature-tx-fcoe-segmentation
Valid values: on, off, ignore
ethtool.feature-tx-gre-csum-segmentation
Valid values: on, off, ignore
ethtool.feature-tx-gre-segmentation
Valid values: on, off, ignore
ethtool.feature-tx-gso-list
Valid values: on, off, ignore
ethtool.feature-tx-gso-partial
Valid values: on, off, ignore
ethtool.feature-tx-gso-robust
Valid values: on, off, ignore
ethtool.feature-tx-ipxip4-segmentation
Valid values: on, off, ignore
ethtool.feature-tx-ipxip6-segmentation
Valid values: on, off, ignore
ethtool.feature-tx-nocache-copy
Valid values: on, off, ignore
ethtool.feature-tx-scatter-gather
Valid values: on, off, ignore
ethtool.feature-tx-scatter-gather-fraglist
Valid values: on, off, ignore
ethtool.feature-tx-sctp-segmentation
Valid values: on, off, ignore
ethtool.feature-tx-tcp-ecn-segmentation
Valid values: on, off, ignore
ethtool.feature-tx-tcp-mangleid-segmentation
Valid values: on, off, ignore
ethtool.feature-tx-tcp-segmentation
Valid values: on, off, ignore
ethtool.feature-tx-tcp6-segmentation
Valid values: on, off, ignore
ethtool.feature-tx-tunnel-remcsum-segmentation
Valid values: on, off, ignore
ethtool.feature-tx-udp-segmentation
Valid values: on, off, ignore
ethtool.feature-tx-udp_tnl-csum-segmentation
Valid values: on, off, ignore
ethtool.feature-tx-udp_tnl-segmentation
Valid values: on, off, ignore
ethtool.feature-tx-vlan-stag-hw-insert
Valid values: on, off, ignore
ethtool.feature-txvlan
Valid values: on, off, ignore
ethtool.fec-mode
Valid values: auto (0x2), off (0x4), rs (0x8), baser (0x10), llrs (0x20)
ethtool.pause-autoneg
Valid values: on, off, ignore
ethtool.pause-rx
Valid values: on, off, ignore
ethtool.pause-tx
Valid values: on, off, ignore
ethtool.ring-rx
Valid values: 0 - 4294967295
ethtool.ring-rx-jumbo
Valid values: 0 - 4294967295
ethtool.ring-rx-mini
Valid values: 0 - 4294967295
ethtool.ring-tx
Valid values: 0 - 4294967295
generic setting
تنظیمات پیوند عمومی.
ویژگیها:
generic.device-handler
برای جزئیات بیشتر درباره نحوه نگارش گرداننده دستگاه، به صفحه راهنمای NetworkManager-dispatcher(8) مراجعه کنید.
با تنظیم این ویژگی، اتصال عمومی به صورت «مجازی» درمیآید، به این معنی که میتواند بدون وجود یک دستگاه واقعی فعال شود؛ دستگاه در زمان آغاز اتصال از طریق فراخوانی device-handler ایجاد خواهد شد.
Format: string
gsm setting
تنظیمات پهنباند تلفن همراه مبتنی بر GSM.
ویژگیها:
gsm.apn
نام نقطه دسترسی GPRS که APN مورد استفاده هنگام برقراری نشست داده با شبکه مبتنی بر GSM را مشخص میکند. مقدار APN اغلب نحوه صورتحساب مصرف شبکه کاربر را تعیین میکند و اینکه آیا کاربر به اینترنت دسترسی دارد یا صرفاً به یک محیط محصور ارائهدهنده (walled-garden) دسترسی خواهد داشت؛ بنابراین استفاده از APN صحیح متناسب با طرح پهنباند همراه کاربر اهمیت بالایی دارد. طبق استاندارد GSM 03.60 بخش 14.9، مقدار APN تنها میتواند شامل نویسههای a-z، 0-9، . و - باشد.
اگر APN تنظیم نشده باشد (حالت پیشفرض)، ممکن است بر اساس تنظیم «auto-config» شناسایی شود. این ویژگی را میتوان صراحتاً روی رشته خالی تنظیم کرد تا از این رفتار جلوگیری شده و از هیچ APNای استفاده نشود.
Format: string
gsm.auto-config
Format: boolean
Valid values: true/yes/on, false/no/off
gsm.device-id
Format: string
gsm.device-uid
Format: string
gsm.home-only
Format: boolean
Valid values: true/yes/on, false/no/off
gsm.initial-eps-bearer-apn
Format: string
gsm.initial-eps-bearer-configure
Format: boolean
Valid values: true/yes/on, false/no/off
gsm.initial-eps-bearer-noauth
Format: boolean
Valid values: true/yes/on, false/no/off
gsm.initial-eps-bearer-password
Format: string
gsm.initial-eps-bearer-password-flags
Format: flags (NMSettingSecretFlags)
Valid values: none (0x0), agent-owned (0x1), not-saved (0x2), not-required (0x4)
gsm.initial-eps-bearer-refuse-chap
Format: boolean
Valid values: true/yes/on, false/no/off
gsm.initial-eps-bearer-refuse-eap
Format: boolean
Valid values: true/yes/on, false/no/off
gsm.initial-eps-bearer-refuse-mschap
Format: boolean
Valid values: true/yes/on, false/no/off
gsm.initial-eps-bearer-refuse-mschapv2
Format: boolean
Valid values: true/yes/on, false/no/off
gsm.initial-eps-bearer-refuse-pap
Format: boolean
Valid values: true/yes/on, false/no/off
gsm.initial-eps-bearer-username
Format: string
gsm.mtu
Format: integer
Special values: auto
gsm.network-id
Format: string
gsm.number
این ویژگی از نسخه 1.16 منسوخ شده است. مقادیر ارائهشده توسط کاربر برای این تنظیم دیگر استفاده نمیشوند.
Format: string
gsm.password
گذرواژه مورد استفاده برای احراز هویت در شبکه، در صورت نیاز. بسیاری از ارائهدهندگان نیازی به گذرواژه ندارند یا هر گذرواژهای را میپذیرند. اما اگر گذرواژهای الزامی باشد، در اینجا مشخص میشود.
Format: string
gsm.password-flags
Format: flags (NMSettingSecretFlags)
Valid values: none (0x0), agent-owned (0x1), not-saved (0x2), not-required (0x4)
gsm.pin
Format: string
gsm.pin-flags
Format: flags (NMSettingSecretFlags)
Valid values: none (0x0), agent-owned (0x1), not-saved (0x2), not-required (0x4)
gsm.sim-id
Format: string
gsm.sim-operator-id
Format: string
gsm.username
نام کاربری مورد استفاده برای احراز هویت در شبکه، در صورت نیاز. بسیاری از ارائهدهندگان نیازی به نام کاربری ندارند یا هر نام کاربری را میپذیرند. اما اگر نام کاربری الزامی باشد، در اینجا مشخص میشود.
Format: string
hsr setting
تنظیمات HSR/PRP.
ویژگیها:
hsr.interlink
Format: string
hsr.multicast-spec
آخرین بایت آدرس نظارت (supervision address).
Format: integer
Valid values: 0 - 255
hsr.port1
نام رابط port1 در HSR. این ویژگی الزامی است.
Format: string
hsr.port2
نام رابط port2 در HSR. این ویژگی الزامی است.
Format: string
hsr.protocol-version
Format: choice (NMSettingHsrProtocolVersion)
Valid values: default (-1), hsr-2010 (0), hsr-2012 (1)
hsr.prp
Format: boolean
Valid values: true/yes/on, false/no/off
infiniband setting
تنظیمات Infiniband.
ویژگیها:
infiniband.mac-address
در صورت تعیین، این اتصال تنها برای دستگاه IPoIB اعمال خواهد شد که آدرس MAC دائمی آن مطابقت داشته باشد. این ویژگی آدرس MAC دستگاه را تغییر نمیدهد (یعنی جعل MAC نیست).
Format: Infiniband MAC address
infiniband.mtu
در صورت غیرصفر بودن، تنها بستههایی با اندازه مشخصشده یا کوچکتر ارسال میشوند و بستههای بزرگتر به چندین فریم تقسیم خواهند شد.
Format: integer
Special values: auto
infiniband.p-key
مقدار p-key اینفینیباند مورد استفاده برای این دستگاه. مقدار -1 به معنای استفاده از p-key پیشفرض است (معروف به «p-key در نمایه 0»). در غیر این صورت، این یک عدد صحیح 16 بیتی بدون علامت است که اگر یک p-key «عضویت کامل» (full membership) باشد، بیت مرتبه بالای 0x8000 آن تنظیم میشود. مقادیر 0 و 0x8000 مجاز نیستند.
با تنظیم p-key، نام رابط همواره «$parent.$p_key» خواهد بود. تنظیم «connection.interface-name» روی نامی دیگر پشتیبانی نمیشود.
توجه داشته باشید که هسته در داخل همواره بیت عضویت کامل را تنظیم میکند، حتی اگر نام رابط آن را نشان ندهد. معمولاً کاربر مایل است یک p-key با عضویت کامل و فلگ 0x8000 تنظیمشده را پیکربندی کند.
Format: integer
Valid values: -1 - 65535
Special values: default (-1)
infiniband.parent
نام رابطِ دستگاه والد (parent) این دستگاه. در حالت عادی NULL است، اما اگر ویژگی «p_key» تنظیم شده باشد، باید دستگاه پایه را با تنظیم این ویژگی یا ویژگی «mac-address» مشخص کنید.
Format: string
infiniband.transport-mode
حالت انتقال IP-over-InfiniBand؛ یا «datagram» یا «connected».
Format: string
Valid values: datagram, connected
ipv4 setting
تنظیمات IPv4.
ویژگیها:
ipv4.addresses
فهرستی از نشانیهای IPv4 و طول پیشوند آنها. نشانیهای چندگانه را میتوان با کاما از هم جدا کرد؛ برای مثال "192.168.1.5/24, 10.1.0.5/24". نشانیها به ترتیب نزولی اولویت فهرست میشوند، به این معنی که اولین نشانی، نشانی اصلی خواهد بود.
Format: a comma separated list of addresses
ipv4.auto-route-ext-gw
برای سایر انواع اتصال، افزودن چنین مسیر خودکاری در حال حاضر پشتیبانی نمیشود و تنظیم این گزینه روی TRUE هیچ تاثیری ندارد.
Format: ternary
Valid values: true/yes/on, false/no/off, default/unknown
ipv4.clat
هنگامی که CLAT فعال باشد، NetworkManager پیشوند NAT64 را از اعلانهای مسیریاب IPv6 کشف میکند؛ اگر یک پیشوند NAT64 اعلام شده باشد، NetworkManager یک برنامه BPF را برای انجام ترجمه بدون حالت (stateless) بستهها میان IPv4 و IPv6 نصب میکند.
تنظیم روی "no" (0) ویژگی CLAT را به طور کامل غیرفعال میکند. مقدار "auto" (1) ویژگی CLAT را تنها زمانی فعال میکند که روش IPv4 برابر 'auto' باشد و دستگاه دارای دروازه (gateway) بومی IPv4 نباشد. مقدار "force" (2) ویژگی CLAT را حتی اگر روش IPv4 برابر 'auto' نباشد و حتی اگر دستگاه دارای دروازه بومی IPv4 باشد فعال میکند.
هنگامی که روی "default" (-1) تنظیم شود، مقدار واقعی در پیکربندی سراسری جستجو میشود؛ اگر مشخص نشده باشد، پیشفرض آن "no" (0) خواهد بود. در آینده مقدار پیشفرض جایگزین (fallback) به "auto" (1) تغییر خواهد یافت.
Format: choice (NMSettingIp4ConfigClat)
Valid values: default (-1), no (0), auto (1), force (2)
ipv4.dad-timeout
مقدار صفر به این معنی است که هیچ تشخیص نشانی تکراری انجام نمیشود؛ -1 به معنای مقدار پیشفرض است (یا مقداری که به صورت سراسری در NetworkManager.conf پیکربندی شده یا ۲۰۰ میلیثانیه). مقداری بزرگتر از صفر، زمان انتظار بر حسب میلیثانیه است. توجه داشته باشید که بازههای زمانی طبق RFC 5227 مشمول تصادفیسازی هستند، بنابراین مدت زمان واقعی میتواند بین نصف تا کل زمان مشخصشده در این ویژگی باشد.
Format: integer
Valid values: -1 - 30000
Special values: default (-1), off (0)
ipv4.dhcp-client-id
مقادیر ویژه "mac" و "perm-mac" پشتیبانی میشوند که از نشانی MAC فعلی یا دائمی دستگاه برای تولید یک شناسه کلاینت با نوع اترنت (01) استفاده میکنند. در حال حاضر، این گزینهها فقط برای پیوندهای نوع اترنت کار میکنند.
مقدار ویژه "ipv6-duid" از DUID موجود در ویژگی "ipv6.dhcp-duid" به عنوان یک شناسه کلاینت سازگار با RFC4361 استفاده میکند. برای IAID از "ipv4.dhcp-iaid" استفاده کرده و در صورت عدم تنظیم، به "ipv6.dhcp-iaid" بازمیگردد.
مقدار ویژه "duid" یک شناسه کلاینت سازگار با RFC4361 بر اساس "ipv4.dhcp-iaid" تولید میکند و از یک DUID ایجادشده با هش کردن /etc/machine-id استفاده مینماید.
مقدار ویژه "stable" برای تولید یک شناسه کلاینت از نوع 0 بر اساس stable-id (به connection.stable-id مراجعه کنید) و یک کلید به ازای هر میزبان پشتیبانی میشود. اگر stable-id را تنظیم کنید، ممکن است بخواهید مشخصکننده "${DEVICE}" یا "${MAC}" را نیز بگنجانید تا کلیدی به ازای هر دستگاه به دست آورید.
مقدار ویژه "none" از ارسال هرگونه شناسه کلاینت جلوگیری میکند. توجه داشته باشید که این کار معمولاً توصیه نمیشود.
در صورت عدم تنظیم، مقدار پیشفرض پیکربندیشده به صورت سراسری از NetworkManager.conf استفاده میشود. اگر باز هم تنظیم نشده باشد، کلاینت داخلی dhcp به طور پیشفرض روی "mac" قرار میگیرد.
Format: string
Special values: mac, perm-mac, duid, ipv6-duid, stable, none
ipv4.dhcp-dscp
این ویژگی در حال حاضر تنها برای IPv4 معتبر است و فقط توسط افزونه DHCP «داخلی» (internal) پشتیبانی میشود.
Format: string
Valid values: CS0, CS4, CS6
ipv4.dhcp-fqdn
Format: string
ipv4.dhcp-hostname
Format: string
ipv4.dhcp-hostname-flags
در حال حاضر، این ویژگی تنها شامل فلگهایی برای کنترل فلگهای FQDN تنظیمشده در گزینه DHCP FQDN است. فلگهای FQDN پشتیبانیشده عبارتند از "fqdn-serv-update" (0x1)، "fqdn-encoded" (0x2) و "fqdn-no-update" (0x4). هنگامی که هیچ فلگ FQDN تنظیم نشده باشد و "fqdn-clear-flags" (0x8) تنظیم شده باشد، گزینه DHCP FQDN فاقد هرگونه فلگ خواهد بود. در غیر این صورت، اگر هیچ فلگ FQDN تنظیم نشده باشد و "fqdn-clear-flags" (0x8) نیز تنظیم نشده باشد، فلگهای استاندارد FQDN در درخواست تنظیم میشوند: "fqdn-serv-update" (0x1)، "fqdn-encoded" (0x2) برای IPv4 و "fqdn-serv-update" (0x1) برای IPv6.
هنگامی که این ویژگی روی مقدار پیشفرض "none" (0x0) تنظیم شود، یک مقدار پیشفرض سراسری در پیکربندی NetworkManager جستجو میشود. اگر آن مقدار تنظیم نشده باشد یا آن هم "none" (0x0) باشد، فلگهای استاندارد FQDN شرحدادهشده در بالا در درخواستهای DHCP ارسال میشوند.
Format: flags (NMDhcpHostnameFlags)
Valid values: none (0x0), fqdn-serv-update (0x1), fqdn-encoded (0x2), fqdn-no-update (0x4), fqdn-clear-flags (0x8)
ipv4.dhcp-iaid
برای DHCPv4، مقدار IAID فقط به همراه مقادیر "duid" و "ipv6-duid" در "ipv4.dhcp-client-id" جهت تولید client-id استفاده میشود.
برای DHCPv6، توجه داشته باشید که در حال حاضر این ویژگی تنها توسط افزونه داخلی ("internal") DHCPv6 پشتیبانی میشود.
مقدار DHCPv6 IAID که واقعاً برای یک رابط فعال استفاده شده است، در اطلاعات اجاره (lease) دستگاه نمایش داده میشود.
Format: string
ipv4.dhcp-ipv6-only-preferred
هنگامی که روی "yes" (1) تنظیم شود، میزبان این گزینه را به فهرست درخواست پارامتر اضافه میکند؛ اگر کارساز DHCP این گزینه را برگرداند، میزبان کلاینت DHCP را برای بازه زمانی مشخصشده در گزینه متوقف میکند.
این قابلیت را در صورتی فعال کنید که میزبان از حالت فقط-IPv6 پشتیبانی میکند، یعنی یا تمام برنامهها قابلیت کار در حالت فقط-IPv6 را دارند یا شکلی از CLAT (464XLAT) مستقر شده است.
اگر روی "auto" (2) تنظیم شود، هرگاه روش IPv6 برابر "auto" باشد و نمایه اتصال دارای ipv4.clat تنظیمشده روی "yes" یا "auto" باشد، این گزینه به طور خودکار فعال میشود. اگر این دو شرط برآورده شوند، میزبان میتواند در حالت فقط-IPv6 کار کند و بنابراین در صورتی که شبکه نیز از آن پشتیبانی کند، غیرفعال کردن DHCPv4 ایمن است.
هنگامی که روی "default" (-1) تنظیم شود، مقدار واقعی در پیکربندی سراسری جستجو میشود؛ اگر مشخص نشده باشد، پیشفرض آن "auto" (2) خواهد بود.
اگر روش IPv6 در اتصال روی "disabled" تنظیم شده باشد، این ویژگی بیتاثیر است و گزینه "IPv6-Only Preferred" همیشه غیرفعال خواهد بود.
Format: choice (NMSettingIP4DhcpIpv6OnlyPreferred)
Valid values: default (-1), no (0), yes (1), auto (2)
ipv4.dhcp-reject-servers
برای DHCPv4، هر عنصر باید یک نشانی IPv4 باشد که میتواند اختیاری با یک اسلش و طول پیشوند همراه شود (مانند "192.168.122.0/24").
این ویژگی در حال حاضر برای DHCPv6 پیادهسازی نشده است.
Format: list of IPv4 addresses
ipv4.dhcp-send-hostname-deprecated
این ویژگی از نسخه 1.52 منسوخ شده است؛ در عوض از نسخه جدید dhcp-send-hostname استفاده کنید.
Format: boolean
Valid values: true/yes/on, false/no/off
ipv4.dhcp-send-hostname
مقدار پیشفرض، default (-1) است. در این حالت، مقدار سراسری از پیکربندی NetworkManager جستجو میشود. اگر تنظیم نشده باشد، مقدار حاصل از dhcp-send-hostname-deprecated که پیشفرض آن TRUE است، برای سازگاری عقبرو استفاده میشود. در آینده این مورد تغییر خواهد کرد و در غیاب یک پیشفرض سراسری، همیشه به TRUE بازمیگردد.
Format: choice (NMTernary)
Valid values: default (-1), false/no (0), true/yes (1)
ipv4.dhcp-send-release
Format: ternary
Valid values: true/yes/on, false/no/off, default/unknown
ipv4.dhcp-timeout
برای بینهایت، آن را روی 2147483647 (MAXINT32) تنظیم کنید.
Format: integer
Valid values: 0 - 2147483647
Special values: default (0), infinity (2147483647)
ipv4.dhcp-vendor-class-identifier
Format: string
ipv4.dns
هر کارساز میتواند یا به صورت یک نشانی IP ساده (اختیاری همراه با یک "#" و نام کارساز SNI برای DNS over TLS) یا با نحو URI مشخص شود.
هنگامی که به عنوان یک URI مشخص شود، قالبهای زیر پشتیبانی میشوند: dns+udp://ADDRESS[:PORT]، dns+tls://ADDRESS[:PORT][SERVERNAME] .
هنگام استفاده از نحو URI، نشانیهای IPv6 باید در براکتهای مربع محصور شوند ('[', ']').
Format: list of IPv4 addresses
ipv4.dns-options
گزینههایی که در حال حاضر پشتیبانی میشوند عبارتند از "attempts"، "debug"، "edns0"، "ndots"، "no-aaaa"، "no-check-names"، "no-reload"، "no-tld-query"، "rotate"، "single-request"، "single-request-reopen"، "timeout"، "trust-ad"، "use-vc". به راهنمای resolv.conf(5) مراجعه کنید.
توجه داشته باشید که بین یک فهرست تنظیمنشده (پیشفرض) و یک فهرست خالی تمایز وجود دارد. در nmcli، برای لغو تنظیم فهرست، مقدار را روی "" قرار دهید. برای تنظیم یک فهرست خالی، آن را روی " " قرار دهید. در حال حاضر، یک فهرست تنظیمنشده همان معنای فهرست خالی را دارد. ممکن است در آینده تغییر کند.
تنظیم "trust-ad" تنها در صورتی رعایت میشود که نمایه کارسازهای نام را به resolv.conf ارائه دهد و تمام نمایههای ارائهدهنده دارای "trust-ad" فعال باشند.
هنگام استفاده از یک افزونه کش DNS (مانند dnsmasq یا systemd-resolved در NetworkManager.conf)، گزینههای "edns0" و "trust-ad" به طور خودکار اضافه میشوند.
گزینههای معتبر "ipv4.dns-options" و "ipv6.dns-options" با هم ادغام میشوند.
Format: a comma separated list of DNS options
ipv4.dns-priority
اولویت نسبی برای کارسازهای DNS که با این تنظیم مشخص شدهاند. مقدار عددی کمتر بهتر است (اولویت بالاتر).
مقادیر منفی این اثر ویژه را دارند که سایر پیکربندیهای دارای مقدار اولویت عددی بزرگتر را حذف میکنند؛ بنابراین در صورت وجود حداقل یک اولویت منفی، تنها کارسازهای DNS از اتصالات با کمترین مقدار اولویت استفاده خواهند شد. برای جلوگیری از هرگونه نشت DNS (یا DNS leaks)، اولویت نمایهای را که باید استفاده شود روی منفیترین مقدار در میان تمام نمایههای اتصال فعال تنظیم کنید.
مقدار صفر یک مقدار پیشفرض پیکربندیشده به صورت سراسری را انتخاب میکند. اگر دومی نیز موجود نباشد یا صفر باشد، برای VPNها (شامل WireGuard) به طور پیشفرض 50 و برای سایر اتصالات 100 خواهد بود.
توجه داشته باشید که اولویت برای مرتبسازی تنظیمات DNS میان چندین اتصال فعال است. این گزینه ابهامزدایی میان چندین کارساز DNS درون یک نمایه اتصال یکسان را انجام نمیدهد.
هنگامی که چندین دستگاه دارای پیکربندیهایی با اولویت یکسان باشند، ابتدا VPNها در نظر گرفته میشوند، سپس دستگاههای دارای بهترین مسیر پیشفرض (کمترین متریک) و سپس تمام دستگاههای دیگر.
هنگام استفاده از dns=default، کارسازهای با اولویت بالاتر در بالای resolv.conf قرار خواهند گرفت. برای اولویت دادن به یک کارساز مشخص نسبت به دیگری درون یک اتصال یکسان، کافی است آنها را به ترتیب مورد نظر قید کنید. توجه داشته باشید که تحلیلکننده معمولاً کارسازهای نام در /etc/resolv.conf را به ترتیبی که فهرست شدهاند امتحان میکند و در صورت شکست، به سراغ کارساز بعدی در فهرست میرود. برای مثال به گزینه "rotate" در تنظیم dns-options مراجعه کنید. اگر اولویتهای DNS منفی وجود داشته باشد، آنگاه فقط کارسازهای نام دستگاههای دارای آن کمترین اولویت در نظر گرفته خواهند شد.
هنگام استفاده از یک تحلیلکننده DNS که از بازفرست مشروط یا تفکیک DNS (با تنظیمات dns=dnsmasq یا dns=systemd-resolved) پشتیبانی میکند، از هر اتصال برای پرسوجوی دامنهها در فهرست جستجوی آن استفاده میشود. دامنههای جستجو مشخص میکنند که از کدام کارسازهای نام پرسش شود، و اولویت DNS برای اولویتبندی کارسازهای نام بر اساس دامنه استفاده میشود. پرسوجوها برای دامنههایی که در هیچ فهرست جستجویی وجود ندارند، از طریق اتصالاتی هدایت میشوند که دارای دامنه عام ویژه '~.' هستند؛ دامنهای که به طور خودکار به اتصالات دارای مسیر پیشفرض اضافه میشود (یا میتواند به صورت دستی اضافه شود). هنگامی که چندین اتصال یک دامنه یکسان را مشخص کنند، اتصالی که بهترین اولویت (کمترین مقدار عددی) را دارد برنده میشود. اگر یک زیردامنه روی رابط دیگری پیکربندی شده باشد، صرفنظر از اولویت پذیرفته خواهد شد، مگر اینکه دامنه والد روی رابط دیگر دارای اولویت منفی باشد که باعث میشود زیردامنه سایهاندازی شود. با Split DNS میتوان با پیکربندی مناسب اولویتهای DNS و دامنههای جستجو، از نشتهای ناخواسته DNS جلوگیری کرد تا فقط کارسازهای نام رابط مورد نظر پیکربندی شوند.
Format: integer
Valid values: -2147483648 - 2147483647
ipv4.dns-search
هنگام استفاده از یک افزونه DNS که از بازفرست مشروط یا تفکیک DNS پشتیبانی میکند، دامنههای جستجو مشخص میکنند که از کدام کارسازهای نام پرسوجو شود. این ویژگی رفتار را در مقایسه با اجرای معمولی /etc/resolv.conf متمایز میکند. برای اطلاعات بیشتر به تنظیم dns-priority نیز مراجعه کنید.
هنگامی که روی نمایهای تنظیم شود که DHCP نیز در آن فعال است، فهرست جستجوی DNS که به صورت خودکار دریافت شده (گزینه 119 برای DHCPv4 و گزینه 24 برای DHCPv6) با فهرست دستی ادغام میشود. با تنظیم "ignore-auto-dns" میتوان از این امر جلوگیری کرد. توجه داشته باشید که اگر هیچ جستجوی DNS پیکربندی نشده باشد، مقدار جایگزین از دامنه دریافتی از DHCP (گزینه 15) به دست خواهد آمد.
Format: list of strings
ipv4.forwarding
Format: choice (NMSettingIPConfigForwarding)
Valid values: default (-1), no (0), yes (1), auto (2)
ipv4.gateway
دروازه (gateway) مرتبط با این پیکربندی. این تنظیم تنها در صورتی معنا دارد که نشانیها نیز روی دستگاه تعیین شده باشند.
تنظیم دروازه باعث میشود NetworkManager یک مسیر پیشفرض استاندارد را با این دروازه به عنوان پرش بعدی (next hop) پیکربندی کند. در صورت تنظیم بودن "never-default"، این مورد نادیده گرفته میشود. یک جایگزین، پیکربندی صریح مسیر پیشفرض با یک مسیر دستی و طول پیشوند 0/ است.
توجه داشته باشید که دروازه معمولاً با مسیریابیای که NetworkManager برای رابطهای WireGuard پیکربندی میکند تداخل دارد، بنابراین معمولاً در آن حالت نباید تنظیم شود. به "ip4-auto-default-route" مراجعه کنید.
Format: IPv4 address
ipv4.ignore-auto-dns
Format: boolean
Valid values: true/yes/on, false/no/off
ipv4.ignore-auto-routes
Format: boolean
Valid values: true/yes/on, false/no/off
ipv4.link-local
هنگامی که روی "auto" تنظیم شود، مقدار وابسته به "ipv4.method" است. هنگامی که روی "default" تنظیم شود، قبل از بازگشت به "auto"، از مقدار پیشفرض سراسری اتصال پیروی میکند. توجه داشته باشید که اگر "ipv4.method" برابر "disabled" باشد، آدرسدهی پیوند-محلی نیز همیشه غیرفعال خواهد بود. مقدار پیشفرض "default" است. از نسخه 1.52، هنگامی که روی "fallback" تنظیم شود، در صورتی که هیچ نشانی IPv4 دیگری تنظیم نشده باشد، یک نشانی پیوند-محلی دریافت میشود.
Format: choice (NMSettingIP4LinkLocal)
Valid values: default (0), auto (1), disabled (2), enabled (3), fallback (4)
ipv4.may-fail
Format: boolean
Valid values: true/yes/on, false/no/off
ipv4.method
- •
- "auto" - تخصیص خودکار نشانی IPv4 از طریق DHCP، PPP، یا سرویسهای مشابه را فعال میکند.
- •
- "manual" - پیکربندی نشانیهای ایستای IPv4 را روی رابط فعال میسازد. توجه داشته باشید که باید حداقل یک نشانی IP و ماسک زیرشبکه در ویژگی "ipv4.addresses" تعیین کنید.
- •
- "disabled" - پروتکل IPv4 را در این نمایه اتصال غیرفعال میکند.
- •
- "shared" - دسترسی
به شبکه را
برای
رایانههای
دیگر فراهم
میسازد.
اگر نشانی IP
و ماسک
زیرشبکهای
در "ipv4.addresses"
مشخص
نکنید، NetworkManager
نشانی 10.42.x.1/24 را
به رابط
اختصاص
میدهد.
علاوه بر
این، NetworkManager یک
کارساز DHCP و
بازفرستنده
DNS را
راهاندازی
میکند.
میزبانهایی
که به این
رابط متصل
میشوند،
نشانی IP را
از محدوده
پیکربندیشده
دریافت
خواهند کرد
و NetworkManager قابلیت
NAT را برای
نگاشت
نشانیهای
کلاینت به
نشانی
اتصال شبکه
پیشفرض
فعلی
پیکربندی
میکند.
در حال حاضر، NetworkManager از dnsmasq به عنوان کارساز DHCP/DNS برای اشتراکگذاری اتصال استفاده میکند. میتوانید با افزودن فایلها به /etc/NetworkManager/dnsmasq-shared.d/. پیکربندی اضافی برای dnsmasq ارائه دهید. البته توجه داشته باشید که این کار توصیه نمیشود، زیرا ممکن است NetworkManager در آینده به یک پیادهسازی متفاوت تغییر یابد.
- •
- "link-local" - نشانیهای پیوند-محلی را بر اساس RFC 3927 فعال میکند. NetworkManager یک نشانی تصادفی پیوند-محلی از زیرشبکه 169.254.0.0/16 به رابط اختصاص میدهد.
Format: string
Valid values: auto, link-local, manual, shared, disabled
ipv4.never-default
Format: boolean
Valid values: true/yes/on, false/no/off
ipv4.replace-local-rule
Format: ternary
Valid values: true/yes/on, false/no/off, default/unknown
ipv4.required-timeout
این ویژگی برای مثال زمانی مفید است که هم IPv4 و هم IPv6 فعال باشند و مجاز به شکست باشند. به طور معمول، اتصال به محض اینکه یکی از دو خانواده نشانی کامل شود با موفقیت برقرار میگردد؛ با تعیین زمان انتظار لازم (required timeout) مثلاً برای IPv4، میتوان اطمینان حاصل کرد که حتی اگر IPv6 زودتر از IPv4 موفق شود، NetworkManager قبل از فعال شدن اتصال، مدتی را برای IPv4 منتظر میماند.
توجه داشته باشید که اگر "may-fail" برای همان خانواده نشانی FALSE باشد، این ویژگی بیتاثیر است زیرا NetworkManager باید تا پایان کل زمان انتظار DHCP منتظر بماند.
مقدار صفر به این معنی است که هیچ زمان انتظار لازمی وجود ندارد؛ -1 به معنای مقدار پیشفرض است (یا بازنویسی پیکربندی ipvx.required-timeout یا صفر).
Format: integer
Valid values: -1 - 2147483647
Special values: default (-1), infinity (2147483647)
ipv4.route-metric
Format: integer
Valid values: -1 - 4294967295
ipv4.route-table
این ویژگی بر تمام مسیرها، از جمله مسیرهای دستگاه (device-routes)، IPv4LL، DHCP، SLAAC، مسیرهای پیشفرض و مسیرهای ایستا اثر میگذارد. اما توجه داشته باشید که مسیرهای ایستا میتوانند با مشخص کردن صریح یک جدول مسیریابی غیرصفر، این تنظیم را به طور جداگانه بازنویسی کنند.
اگر تنظیم جدول روی صفر رها شود، واجد شرایط است که از طریق پیکربندی سراسری بازنویسی شود. اگر این ویژگی حتی پس از اعمال مقدار پیکربندی سراسری باز هم صفر باشد، مسیریابی مبتنی بر سیاست برای خانواده نشانی این اتصال غیرفعال خواهد بود.
غیرفعال بودن مسیریابی مبتنی بر سیاست به این معنی است که NetworkManager تمام مسیرها را به جدول اصلی (main table) اضافه خواهد کرد (به جز مسیرهای ایستایی که صراحتاً جدول متفاوتی را پیکربندی کردهاند). علاوه بر این، NetworkManager هیچ مسیر اضافهای را از جدولهایی غیر از جدول اصلی حذف نخواهد کرد. این کار برای حفظ سازگاری عقبرو برای کاربرانی است که جدولهای مسیریابی را در خارج از NetworkManager مدیریت میکنند.
Format: integer
Valid values: 0 - 4294967295
Special values: unspec (0), main (254)
ipv4.routed-dns
Format: choice (NMSettingIPConfigRoutedDns)
Valid values: default (-1), no (0), yes (1)
ipv4.routes
ویژگیهای گوناگونی پشتیبانی میشوند:
- •
- "advmss" - یک عدد صحیح ۳۲ بیتی بدون علامت.
- •
- "cwnd" - یک عدد صحیح ۳۲ بیتی بدون علامت.
- •
- "initcwnd" - یک عدد صحیح ۳۲ بیتی بدون علامت.
- •
- "initrwnd" - یک عدد صحیح ۳۲ بیتی بدون علامت.
- •
- "lock-advmss" - یک مقدار بولی (boolean).
- •
- "lock-cwnd" - یک مقدار بولی (boolean).
- •
- "lock-initcwnd" - یک مقدار بولی (boolean).
- •
- "lock-initrwnd" - یک مقدار بولی (boolean).
- •
- "lock-mtu" - یک مقدار بولی (boolean).
- •
- "lock-window" - یک مقدار بولی (boolean).
- •
- "mtu" - یک عدد صحیح ۳۲ بیتی بدون علامت.
- •
- "onlink" - یک مقدار بولی (boolean). فلگ onlink برای مسیرهای IPv4 بدون دروازه (gateway) نادیده گرفته میشود. این همچنین به این معنی است که با یک "weight" مثبت، مسیر نمیتواند با مسیرهای ECMP که onlink هستند و دروازه دارند ادغام شود.
- •
- "quickack" - یک مقدار بولی (boolean).
- •
- "rto_min" - یک عدد صحیح ۳۲ بیتی بدون علامت. مقدار بر حسب میلیثانیه است.
- •
- "scope" - یک عدد صحیح ۸ بیتی بدون علامت. فقط برای IPv4.
- •
- "src" - یک نشانی IPv4.
- •
- "table" - یک عدد صحیح ۳۲ بیتی بدون علامت. مقدار پیشفرض به ipv4.route-table بستگی دارد.
- •
- "tos" - یک عدد صحیح ۸ بیتی بدون علامت. فقط برای IPv4.
- •
- "type" - یکی از موارد unicast، local، blackhole، unreachable، prohibit، throw. مقدار پیشفرض unicast است.
- •
- "weight" - یک عدد
صحیح ۳۲
بیتی بدون
علامت در
بازه 0 تا 256.
وزن غیرصفر
نشان
میدهد که
مسیر IPv4 یک
مسیر ECMP IPv4 است.
برنامه NetworkManager
به طور
خودکار
مسیرهای
سازگار ECMP را
در مسیرهای
چند-پرشی (multi-hop)
ادغام
میکند.
تنظیم روی
صفر یا حذف
این ویژگی،
مسیرهای
تک-پرشی (single hop)
را
پیکربندی
میکند که
ادغام
نخواهند شد.
اگر مسیر
هیچ شریکی
برای ادغام
پیدا نکند،
به عنوان یک
مسیر
تک-پرشی
پیکربندی
میشود.
توجه داشته باشید که در NetworkManager، در حال حاضر تمام nexthopهای یک مسیر ECMP باید دارای فلگ "onlink" یکسان باشند تا بتوانند ادغام شوند.
- •
- "window" - یک عدد صحیح ۳۲ بیتی بدون علامت.
برای جزئیات بیشتر به راهنمای `man ip-route` نیز مراجعه کنید.
Format: a comma separated list of routes
ipv4.routing-rules
مثال: priority 5 from 192.167.4.0/24 table 45
Format: a comma separated list of routing rules
ipv4.shared-dhcp-lease-time
مقادیر ویژه عبارتند از 0 برای مقدار پیشفرض ۱ ساعت و 2147483647 (MAXINT32) برای زمان اجاره نامحدود (بینهایت).
Format: integer
Valid values: 0 - 2147483647
Special values: default (0), infinity (2147483647)
ipv4.shared-dhcp-range
Format: string
ipv6 setting
تنظیمات IPv6.
ویژگیها:
ipv6.addr-gen-mode
مقادیر مجاز عبارتند از: "eui64" (0)، "stable-privacy" (1)، "default" (3) یا "default-or-eui64" (2).
اگر این ویژگی روی "eui64" تنظیم شود، آدرسها با استفاده از توکن رابط مشتقشده از آدرس سختافزاری ایجاد خواهند شد. این کار باعث میشود بخش میزبان آدرس ثابت بماند و امکان ردیابی حضور میزبان هنگام جابهجایی میان شبکهها فراهم شود. آدرس تنها در صورت تعویض سختافزار رابط تغییر میکند. در صورت تشخیص آدرس تکراری، هیچ سازوکار پشتیبانی برای تولید آدرس دیگر وجود ندارد. در صورت پیکربندی، "ipv6.token" به جای آدرس MAC برای تولید آدرسهای پیکربندی خودکار بدون حالت استفاده میشود.
اگر این ویژگی روی "stable-privacy" تنظیم شود، شناسه رابط مطابق با RFC7217 تولید میشود. این سازوکار با هش کردن یک کلید اختصاصی میزبان (به راهنمای NetworkManager(8) مراجعه کنید)، نام رابط، ویژگی "connection.stable-id" اتصال و پیشوند آدرس کار میکند. این ویژگی حریم خصوصی را با دشوار کردن ردیابی حضور میزبان از طریق آدرس بهبود میبخشد و آدرس حتی در صورت تعویض سختافزار رابط شبکه پایدار باقی میماند.
مقادیر ویژه "default" و "default-or-eui64" به مقدار پیشفرض سراسری اتصال بازمیگردند (همانگونه که در راهنمای NetworkManager.conf(5) مستند شده است). اگر پیشفرض سراسری مشخص نشده باشد، مقدار جایگزین به ترتیب "stable-privacy" یا "eui64" خواهد بود.
در صورت عدم تعیین، هنگام ایجاد یک نمایه جدید مقدار پیشفرض "default" است.
توجه داشته باشید که این تنظیم از افزونههای حریم خصوصی (Privacy Extensions) که با ویژگی "ip6-privacy" پیکربندی میشوند مجزا است و بر آدرسهای موقت پیکربندیشده با آن گزینه تأثیری نمیگذارد.
Format: one of "eui64" (0), "stable-privacy" (1), "default" (3) or "default-or-eui64" (2)
Valid values: eui64 (0), stable-privacy (1), default-or-eui64 (2), default (3)
ipv6.addresses
فهرستی از آدرسهای IPv6 و طول پیشوند آنها. چندین آدرس را میتوان با کاما از هم جدا کرد؛ به عنوان مثال "2001:db8:85a3::8a2e:370:7334/64, 2001:db8:85a3::5/64". آدرسها به ترتیب اولویت نزولی فهرست میشوند، به این معنی که اولین آدرس، آدرس اصلی (primary) خواهد بود. این موضوع میتواند در انتخاب آدرس مبدأ IPv6 تأثیرگذار باشد (بخش ۵ از RFC 6724).
Format: a comma separated list of addresses
ipv6.auto-route-ext-gw
برای سایر انواع اتصالات، افزودن چنین مسیر خودکاری در حال حاضر پشتیبانی نمیشود و تنظیم آن روی TRUE هیچ اثری ندارد.
Format: ternary
Valid values: true/yes/on, false/no/off, default/unknown
ipv6.dhcp-duid
مقدار ویژه "lease"، مقدار DUID که قبلاً استفاده شده را از پرونده اجاره (lease file) متعلق به اتصال بازیابی میکند. اگر هیچ DUID یافت نشود، یک DUID-UUID سراسری و دائمی (RFC 6355) بر اساس شناسه دستگاه (machine-id) تولید خواهد شد.
مقادیر ویژه "llt" و "ll" یک DUID از نوع LLT یا LL (به RFC 3315 مراجعه کنید) را بر اساس آدرس MAC فعلی دستگاه تولید میکنند. به منظور تلاش برای ارائه یک DUID-LLT پایدار، فیلد زمان شامل یک برچسب زمانی ثابت خواهد بود که به طور سراسری (برای همه نمایهها) استفاده شده و روی دیسک ذخیره میشود.
مقادیر ویژه "stable-llt"، "stable-ll" و "stable-uuid" یک DUID از نوع متناظر را تولید میکنند که از stable-id اتصال و یک کلید منحصربهفرد به ازای هر میزبان مشتق میشود. در صورتی که این نمایه روی چندین دستگاه فعال میشود، ممکن است بخواهید مشخصکننده "${DEVICE}" یا "${MAC}" را در stable-id بگنجانید. بنابراین، آدرس لایه پیوند در "stable-ll" و "stable-llt" یک آدرس تولیدشده و مشتق از stable id خواهد بود. مقدار زمان DUID-LLT در گزینه "stable-llt" از میان یک بازه زمانی ایستا به مدت سه سال انتخاب میشود (حد بالای این بازه همان برچسب زمانی ثابتی است که در "llt" به کار میرود).
هنگامی که این ویژگی تنظیم نشده باشد، مقدار سراسری ارائهشده برای "ipv6.dhcp-duid" به کار میرود. در صورتی که هیچ مقدار سراسری تعیین نشده باشد، مقدار پیشفرض "lease" فرض میشود.
Format: string
ipv6.dhcp-hostname
Format: string
ipv6.dhcp-hostname-flags
در حال حاضر، این ویژگی فقط شامل پرچمهایی برای کنترل پرچمهای FQDN تنظیمشده در گزینه DHCP FQDN است. پرچمهای FQDN پشتیبانیشده عبارتند از "fqdn-serv-update" (0x1)، "fqdn-encoded" (0x2) و "fqdn-no-update" (0x4). هنگامی که هیچ پرچم FQDN تنظیم نشده و "fqdn-clear-flags" (0x8) تنظیم شده باشد، گزینه DHCP FQDN فاقد هرگونه پرچمی خواهد بود. در غیر این صورت، اگر هیچ پرچم FQDN تنظیم نشده و "fqdn-clear-flags" (0x8) نیز تنظیم نشده باشد، پرچمهای استاندارد FQDN در درخواست تنظیم میشوند: "fqdn-serv-update" (0x1)، "fqdn-encoded" (0x2) برای IPv4 و "fqdn-serv-update" (0x1) برای IPv6.
هنگامی که این ویژگی روی مقدار پیشفرض "none" (0x0) تنظیم شود، یک مقدار پیشفرض سراسری در پیکربندی NetworkManager جستجو میشود. اگر آن مقدار تنظیم نشده باشد یا آن هم "none" (0x0) باشد، پرچمهای استاندارد FQDN شرحدادهشده در بالا در درخواستهای DHCP ارسال میشوند.
Format: flags (NMDhcpHostnameFlags)
Valid values: none (0x0), fqdn-serv-update (0x1), fqdn-encoded (0x2), fqdn-no-update (0x4), fqdn-clear-flags (0x8)
ipv6.dhcp-iaid
برای DHCPv4، شناسه IAID تنها با مقادیر "duid" و "ipv6-duid" در "ipv4.dhcp-client-id" برای تولید client-id استفاده میشود.
برای DHCPv6، توجه داشته باشید که در حال حاضر این ویژگی فقط توسط پلاگین "internal" برای DHCPv6 پشتیبانی میشود.
شناسه DHCPv6 IAID که در عمل برای یک رابط فعالشده استفاده میشود، در اطلاعات اجاره دستگاه نمایش داده میشود.
Format: string
ipv6.dhcp-pd-hint
Format: string
ipv6.dhcp-send-hostname-deprecated
این ویژگی از نسخه 1.52 منسوخ شده است؛ به جای آن از نسخه جدید dhcp-send-hostname استفاده کنید.
Format: boolean
Valid values: true/yes/on, false/no/off
ipv6.dhcp-send-hostname
مقدار پیشفرض، default (-1) است. در این حالت مقدار سراسری از پیکربندی NetworkManager خوانده میشود. اگر تنظیم نشده باشد، مقدار dhcp-send-hostname-deprecated (که به طور پیشفرض TRUE است) برای سازگاری با نسخههای پیشین استفاده میشود. در آینده این سازوکار تغییر خواهد کرد و در صورت نبود مقدار پیشفرض سراسری، همیشه به TRUE بازمیگردد.
Format: choice (NMTernary)
Valid values: default (-1), false/no (0), true/yes (1)
ipv6.dhcp-send-release
Format: ternary
Valid values: true/yes/on, false/no/off, default/unknown
ipv6.dhcp-timeout
برای بینهایت، آن را روی 2147483647 (MAXINT32) تنظیم کنید.
Format: integer
Valid values: 0 - 2147483647
Special values: default (0), infinity (2147483647)
ipv6.dns
هر سرور را میتوان به صورت یک آدرس IP ساده (اختیاراً به همراه یک "#" و نام سرور SNI برای DNS over TLS) یا با ساختار نگارشی URI مشخص کرد.
هنگامی که به صورت URI مشخص میشود، قالبهای زیر پشتیبانی میشوند: dns+udp://ADDRESS[:PORT], dns+tls://ADDRESS[:PORT][SERVERNAME] .
هنگام استفاده از ساختار URI، آدرسهای IPv6 باید درون براکتهای کروشه قرار گیرند ('[', ']').
Format: list of IPv6 addresses
ipv6.dns-options
گزینههایی که در حال حاضر پشتیبانی میشوند عبارتند از "attempts"، "debug"، "edns0"، "ndots"، "no-aaaa"، "no-check-names"، "no-reload"، "no-tld-query"، "rotate"، "single-request"، "single-request-reopen"، "timeout"، "trust-ad"، "use-vc" و همچنین "inet6"، "ip6-bytestring"، "ip6-dotint"، "no-ip6-dotint". راهنمای resolv.conf(5) را ببینید.
توجه داشته باشید که میان یک فهرست تنظیمنشده (پیشفرض) و یک فهرست خالی تمایز وجود دارد. در nmcli، برای لغو تنظیم فهرست، مقدار آن را روی "" بگذارید. برای تعیین یک فهرست خالی، آن را روی " " قرار دهید. در حال حاضر، فهرست تنظیمنشده معنایی مشابه فهرست خالی دارد؛ این رفتار ممکن است در آینده تغییر کند.
تنظیم "trust-ad" تنها در صورتی اعمال میشود که نمایه، سرورهای نامی را به resolv.conf اضافه کند و تمام نمایههای ارائهدهنده نیز "trust-ad" را فعال کرده باشند.
هنگام استفاده از افزونه DNS دارای حافظه پنهان (dnsmasq یا systemd-resolved در NetworkManager.conf)، گزینههای "edns0" و "trust-ad" به طور خودکار اضافه میشوند.
گزینههای معتبر در "ipv4.dns-options" و "ipv6.dns-options" با یکدیگر ادغام میشوند.
Format: a comma separated list of DNS options
ipv6.dns-priority
اولویت نسبی برای سرورهای DNS مشخصشده توسط این تنظیم. یک مقدار عددی کمتر بهتر است (اولویت بالاتر).
مقادیر منفی این اثر ویژه را دارند که سایر پیکربندیهای دارای مقدار اولویت عددی بزرگتر را حذف میکنند؛ بنابراین در صورت وجود دستکم یک اولویت منفی، فقط سرورهای DNS از اتصالاتی که کمترین مقدار اولویت را دارند استفاده خواهند شد. برای جلوگیری کامل از نشت DNS، اولویت نمایهای را که باید استفاده شود روی منفیترین مقدار در میان تمام نمایههای اتصالات فعال تنظیم کنید.
مقدار صفر، مقدار پیشفرض پیکربندیشده سراسری را برمیگزیند. اگر دومی نیز وجود نداشته باشد یا صفر باشد، مقدار پیشفرض برای VPNها (شامل WireGuard) برابر ۵۰ و برای سایر اتصالات برابر ۱۰۰ خواهد بود.
توجه داشته باشید که این اولویت برای مرتبسازی تنظیمات DNS در میان چندین اتصال فعال است. این مقدار سرورهای DNS متعدد درون یک نمایه اتصال یکسان را تفکیک نمیکند.
هنگامی که چندین دستگاه دارای پیکربندیهایی با اولویت یکسان باشند، ابتدا VPNها در نظر گرفته میشوند، سپس دستگاههای دارای بهترین (کمترین متریک) مسیر پیشفرض و سپس سایر دستگاهها.
هنگام استفاده از dns=default، سرورهای دارای اولویت بالاتر در بالای فایل resolv.conf قرار خواهند گرفت. برای اولویت دادن به یک سرور خاص نسبت به سروری دیگر درون همان اتصال، فقط کافی است آنها را به ترتیب مورد نظر بنویسید. توجه داشته باشید که تحلیلگر معمولاً سرورهای نام موجود در /etc/resolv.conf را به همان ترتیبی که فهرست شدهاند امتحان میکند و در صورت بروز خطا به سراغ سرور بعدی در فهرست میرود. برای مثال به گزینه "rotate" در تنظیمات dns-options نگاه کنید. اگر اولویت DNS منفی وجود داشته باشد، فقط سرورهای نام دستگاههای دارای پایینترین اولویت در نظر گرفته میشوند.
هنگام استفاده از تحلیلگر DNS که از ارجاع مشروط یا تفکیک DNS (یا Split DNS) پشتیبانی میکند (با تنظیمات dns=dnsmasq یا dns=systemd-resolved)، از هر اتصال برای پرسوجوی دامنههای موجود در فهرست جستجوی آن استفاده میشود. دامنههای جستجو تعیین میکنند که باید از کدام سرورهای نام پرسش شود، و اولویت DNS برای اولویتبندی سرورهای نام بر اساس دامنه به کار میرود. پرسوجوهای مربوط به دامنههایی که در هیچ فهرست جستجویی وجود ندارند، از طریق اتصالاتی هدایت میشوند که دامنه نویسه عمومی ویژه '~.' را دارند؛ این دامنه به طور خودکار به اتصالات دارای مسیر پیشفرض اضافه میشود (یا میتوان آن را به صورت دستی اضافه کرد). هنگامی که چندین اتصال یک دامنه یکسان را مشخص کنند، اتصالی که بهترین اولویت (کمترین مقدار عددی) را داشته باشد برنده میشود. اگر یک زیردامنه روی رابط دیگری پیکربندی شده باشد بدون توجه به اولویت پذیرفته خواهد شد، مگر اینکه دامنه والد در رابط دیگر اولویت منفی داشته باشد که باعث پوشانده شدن (shadowed) زیردامنه میشود. با Split DNS میتوان با پیکربندی صحیح اولویتهای DNS و دامنههای جستجو از نشت ناخواسته DNS جلوگیری کرد، به گونهای که فقط سرورهای نام رابط مورد نظر پیکربندی شوند.
Format: integer
Valid values: -2147483648 - 2147483647
ipv6.dns-search
هنگام استفاده از افزونه DNS که از ارجاع مشروط یا Split DNS پشتیبانی میکند، دامنههای جستجو مشخص میکنند که کدام سرورهای نام باید مورد پرسش قرار گیرند. این موضوع رفتار را با حالت کار با /etc/resolv.conf ساده متفاوت میکند. برای اطلاعات بیشتر تنظیم dns-priority را نیز ببینید.
هنگامی که روی نمایهای تنظیم شود که DHCP را نیز فعال کرده است، فهرست جستجوی DNS که به طور خودکار دریافت شده (گزینه ۱۱۹ برای DHCPv4 و گزینه ۲۴ برای DHCPv6) با فهرست دستی ادغام میشود. با تنظیم "ignore-auto-dns" میتوان از این رفتار جلوگیری کرد. توجه داشته باشید که اگر هیچ جستجوی DNS پیکربندی نشده باشد، مقدار جایگزین از دامنه ارائهشده توسط DHCP (گزینه ۱۵) مشتق خواهد شد.
Format: list of strings
ipv6.gateway
دروازه مرتبط با این پیکربندی. این تنظیم تنها زمانی معنا دارد که آدرسها نیز روی دستگاه تنظیم شده باشند.
تنظیم دروازه باعث میشود که NetworkManager یک مسیر پیشفرض استاندارد با دروازه به عنوان جهش بعدی (next hop) پیکربندی کند. اگر "never-default" تنظیم شده باشد این مقدار نادیده گرفته میشود. یک روش جایگزین این است که مسیر پیشفرض را صراحتاً با یک مسیر دستی و طول پیشوند 0/ پیکربندی کنید.
توجه داشته باشید که دروازه معمولاً با مسیریابی که NetworkManager برای رابطهای WireGuard پیکربندی میکند تداخل دارد، بنابراین معمولاً در آن حالت نباید تنظیم شود. ویژگی "ip4-auto-default-route" را ببینید.
Format: IPv6 address
ipv6.ignore-auto-dns
Format: boolean
Valid values: true/yes/on, false/no/off
ipv6.ignore-auto-routes
Format: boolean
Valid values: true/yes/on, false/no/off
ipv6.ip6-privacy
تنظیم این مقدار به ازای هر اتصال روی "-1" (پیشفرض) به معنای بازگشت به تنظیمات سراسری "ipv6.ip6-privacy" است. اگر آن هم مشخص نشده باشد یا روی "-1" تنظیم شده باشد، مقدار بازگشتی از خواندن "/proc/sys/net/ipv6/conf/default/use_tempaddr" به دست میآید.
توجه داشته باشید که این تنظیم از آدرسهای Stable Privacy که میتوان با تنظیم "stable-privacy" در ویژگی "addr-gen-mode" به عنوان راه دیگری برای جلوگیری از ردیابی میزبان با آدرسهای IPv6 فعال کرد، مجزا است.
Format: choice (NMSettingIP6ConfigPrivacy)
Valid values: unknown/default (-1), disabled (0), prefer-public-addr (1), prefer-temp-addr (2)
ipv6.may-fail
Format: boolean
Valid values: true/yes/on, false/no/off
ipv6.method
اگر مقادیر "auto"، "dhcp"، "manual"، "ignore" یا "shared" را تنظیم کنید، NetworkManager علاوه بر آدرس سراسری، یک آدرس محلی پیوند IPv6 نیز به رابط اختصاص میدهد. این رفتار مطابق با RFC 4291 است.
Format: string
Valid values: ignore, auto, dhcp, link-local, manual, shared, disabled
ipv6.mtu
Format: integer
Special values: auto
ipv6.never-default
Format: boolean
Valid values: true/yes/on, false/no/off
ipv6.ra-timeout
برای بینهایت، آن را روی 2147483647 (MAXINT32) تنظیم کنید.
Format: integer
Valid values: 0 - 2147483647
Special values: default (0), infinity (2147483647)
ipv6.replace-local-rule
Format: ternary
Valid values: true/yes/on, false/no/off, default/unknown
ipv6.required-timeout
این ویژگی برای مثال زمانی کاربرد دارد که هر دو پروتکل IPv4 و IPv6 فعال باشند و مجاز به شکست (may-fail) باشند. به طور معمول به محض اینکه یکی از این دو خانواده آدرس کامل شود اتصال برقرار میگردد؛ با تعیین مهلت زمانی الزامی برای مثلاً IPv4، میتوان اطمینان حاصل کرد که حتی اگر IPv6 زودتر از IPv4 موفق شود، NetworkManager قبل از فعال شدن اتصال، مدتی را برای IPv4 منتظر میماند.
توجه داشته باشید که اگر "may-fail" برای همان خانواده آدرس FALSE باشد، این ویژگی هیچ اثری ندارد زیرا NetworkManager باید تا پایان کل مهلت زمانی DHCP منتظر بماند.
مقدار صفر به معنای عدم وجود مهلت زمانی الزامی است و 1- نشاندهنده مقدار پیشفرض است (یا بازنویسی ipvx.required-timeout در پیکربندی یا صفر).
Format: integer
Valid values: -1 - 2147483647
Special values: default (-1), infinity (2147483647)
ipv6.route-metric
Format: integer
Valid values: -1 - 4294967295
ipv6.route-table
این امر بر همه مسیرها تأثیر میگذارد، از جمله مسیرهای دستگاه (device-routes)، IPv4LL، DHCP، SLAAC، مسیرهای پیشفرض و مسیرهای ایستا. اما توجه داشته باشید که مسیرهای ایستا میتوانند به صورت جداگانه با مشخص کردن یک جدول مسیریابی غیرصفر، این تنظیم را بازنویسی کنند.
اگر تنظیم جدول روی صفر باقی بماند، واجد شرایط بازنویسی از طریق پیکربندی سراسری خواهد بود. اگر حتی پس از اعمال مقدار پیکربندی سراسری این ویژگی همچنان صفر باشد، مسیریابی مبتنی بر خطمشی برای خانواده آدرس این اتصال غیرفعال میشود.
غیرفعال بودن مسیریابی مبتنی بر خطمشی به این معنی است که NetworkManager همه مسیرها را به جدول اصلی (main) اضافه خواهد کرد (به جز مسیرهای ایستایی که صراحتاً جدول متفاوتی را پیکربندی کردهاند). علاوه بر این، NetworkManager هیچ مسیر متفرقهای را از جدولهایی به جز جدول اصلی حذف نخواهد کرد. این کار برای حفظ سازگاری با گذشته برای کاربرانی است که جداول مسیریابی را در خارج از NetworkManager مدیریت میکنند.
Format: integer
Valid values: 0 - 4294967295
Special values: unspec (0), main (254)
ipv6.routed-dns
Format: choice (NMSettingIPConfigRoutedDns)
Valid values: default (-1), no (0), yes (1)
ipv6.routes
مشخصههای مختلفی پشتیبانی میشوند:
برای جزئیات بیشتر `man ip-route` را نیز ببینید.
Format: a comma separated list of routes
ipv6.routing-rules
مثال: priority 5 from 1:2:3::5/128 table 45
Format: a comma separated list of routing rules
ipv6.temp-preferred-lifetime
تنظیم این مقدار به ازای هر اتصال روی "0" (پیشفرض) به معنای بازگشت به تنظیمات سراسری "ipv6.temp-preferred-lifetime" است. اگر آن هم مشخص نشده باشد یا روی "0" تنظیم شده باشد، مقدار بازگشتی از خواندن "/proc/sys/net/ipv6/conf/default/temp_prefered_lft" به دست میآید.
Format: integer
Valid values: 0 - 2147483647
Special values: default (0)
ipv6.temp-valid-lifetime
تنظیم این مقدار به ازای هر اتصال روی "0" (پیشفرض) به معنای بازگشت به تنظیمات سراسری "ipv6.temp-valid-lifetime" است. اگر آن هم مشخص نشده باشد یا روی "0" تنظیم شده باشد، مقدار بازگشتی از خواندن "/proc/sys/net/ipv6/conf/default/temp_valid_lft" به دست میآید.
Format: integer
Valid values: 0 - 2147483647
Special values: default (0)
ipv6.token
هنگامی که تنظیم شود، توکن به عنوان شناسه رابط IPv6 به جای آدرس سختافزاری استفاده میشود. این موضوع تنها بر آدرسهای حاصل از پیکربندی خودکار بدون حالت (Stateless Autoconfiguration) اعمال میشود، نه بر آدرسهای محلی پیوند IPv6.
Format: string
ip-tunnel setting
تنظیمات تونلسازی آیپی (IP Tunneling).
ویژگیها:
ip-tunnel.encapsulation-limit
Format: integer
Valid values: 0 - 255
ip-tunnel.flags
Format: flags (NMIPTunnelFlags)
Valid values: none (0x0), ip6-ign-encap-limit (0x1), ip6-use-orig-tclass (0x2), ip6-use-orig-flowlabel (0x4), ip6-mip6-dev (0x8), ip6-rcv-dscp-copy (0x10), ip6-use-orig-fwmark (0x20)
ip-tunnel.flow-label
Format: integer
Valid values: 0 - 1048575
ip-tunnel.fwmark
Format: integer
Valid values: 0 - 4294967295
ip-tunnel.input-key
Format: string
ip-tunnel.local
نقطه پایانی محلی تونل؛ این مقدار میتواند خالی باشد، در غیر این صورت باید حاوی یک نشانی IPv4 یا IPv6 باشد.
Format: string
ip-tunnel.mode
حالت تونلسازی. مقادیر معتبر: ipip (1)، gre (2)، sit (3)، isatap (4)، vti (5)، ip6ip6 (6)، ipip6 (7)، ip6gre (8)، vti6 (9)، gretap (10) و ip6gretap (11)
Format: choice (NMIPTunnelMode)
Valid values: ipip (1), gre (2), sit (3), isatap (4), vti (5), ip6ip6 (6), ipip6 (7), ip6gre (8), vti6 (9), gretap (10), ip6gretap (11)
ip-tunnel.mtu
Format: integer
Special values: auto
ip-tunnel.output-key
Format: string
ip-tunnel.parent
در صورت تعیین، نام رابط والد یا UUID اتصال والد را مشخص میکند که دستگاه جدید به آن متصل خواهد شد تا بستههای تونلشده فقط از طریق آن رابط مسیریابی شوند.
Format: string
ip-tunnel.path-mtu-discovery
Format: boolean
Valid values: true/yes/on, false/no/off
ip-tunnel.remote
نقطه پایانی دوردست تونل؛ این مقدار باید حاوی یک نشانی IPv4 یا IPv6 باشد.
Format: string
ip-tunnel.tos
Format: integer
Valid values: 0 - 255
ip-tunnel.ttl
Format: integer
Valid values: 0 - 255
ipvlan setting
تنظیمات IPVLAN.
ویژگیها:
ipvlan.mode
حالت IPVLAN. مقادیر معتبر: l2 (1)، l3 (2)، l3s (3)
Format: choice (NMSettingIpvlanMode)
Valid values: l2 (1), l3 (2), l3s (3)
ipvlan.parent
در صورت تعیین، نام رابط والد یا UUID اتصال والد را مشخص میکند که این رابط IPVLAN باید از آن ایجاد شود. اگر این ویژگی مشخص نشود، اتصال باید شامل تنظیم "802-3-ethernet" با ویژگی "mac-address" باشد.
Format: string
ipvlan.private
Format: boolean
Valid values: true/yes/on, false/no/off
ipvlan.vepa
Format: boolean
Valid values: true/yes/on, false/no/off
macsec setting
تنظیمات MACSec.
ویژگیها:
macsec.encrypt
مشخص میکند که آیا ترافیک ارسالی باید رمزنگاری شود یا خیر.
Format: boolean
Valid values: true/yes/on, false/no/off
macsec.mka-cak
کلید اشتراکی پیشین CAK (کلید انجمن اتصال یا Connectivity Association Key) برای توافق کلید MACsec. باید رشتهای از ۳۲ نویسه شانزدهشانزدهی (هگزادسیمال) باشد.
Format: string
macsec.mka-cak-flags
Format: flags (NMSettingSecretFlags)
Valid values: none (0x0), agent-owned (0x1), not-saved (0x2), not-required (0x4)
macsec.mka-ckn
نام کلید اشتراکی پیشین CKN (نام کلید انجمن اتصال یا Connectivity-association Key Name) برای توافق کلید MACsec. باید رشتهای از نویسههای شانزدهشانزدهی با طول زوج بین ۲ تا ۶۴ باشد.
Format: string
macsec.mode
نحوه به دست آوردن CAK (کلید انجمن اتصال) برای MKA (توافق کلید MACsec) را مشخص میکند.
Format: choice (NMSettingMacsecMode)
Valid values: psk (0), eap (1)
macsec.offload
مقدار "off" (0) آفلود MACsec را غیرفعال میکند.
مقادیر "phy" (1) و "mac" (2) به ترتیب درخواست آفلود به لایه PHY یا MAC را ارسال میکنند؛ اگر حالت انتخابشده در دسترس نباشد، اتصال با شکست مواجه خواهد شد.
مقدار "default" (-1) از مقدار پیشفرض سراسری مشخصشده در پیکربندی NetworkManager استفاده میکند؛ اگر هیچ پیشفرض سراسری تعریف نشده باشد، پیشفرض توکار برابر با "off" (0) خواهد بود.
Format: choice (NMSettingMacsecOffload)
Valid values: default (-1), off (0), phy (1), mac (2)
macsec.parent
در صورت تعیین، نام رابط والد یا UUID اتصال والد را مشخص میکند که این رابط MACSEC باید از آن ایجاد شود. اگر این ویژگی مشخص نشود، اتصال باید شامل تنظیم "802-3-ethernet" با ویژگی "mac-address" باشد.
Format: string
macsec.port
بخش پورت مربوط به شناسه کانال امن (SCI یا Secure Channel Identifier)، بین ۱ تا ۶۵۵۳۴.
Format: integer
Valid values: 1 - 65534
macsec.send-sci
Format: boolean
Valid values: true/yes/on, false/no/off
macsec.validation
Format: choice (NMSettingMacsecValidation)
Valid values: disable (0), check (1), strict (2)
macvlan setting
تنظیمات MAC VLAN.
ویژگیها:
macvlan.mode
حالت macvlan، که سازوکار ارتباطی میان چندین macvlan روی یک دستگاه زیرین یکسان را تعیین میکند.
Format: choice (NMSettingMacvlanMode)
Valid values: vepa (1), bridge (2), private (3), passthru (4), source (5)
macvlan.parent
در صورت تعیین، نام رابط والد یا UUID اتصال والد را مشخص میکند که این رابط MAC-VLAN باید از آن ایجاد شود. اگر این ویژگی مشخص نشود، اتصال باید شامل تنظیم "802-3-ethernet" با ویژگی "mac-address" باشد.
Format: string
macvlan.promiscuous
Format: boolean
Valid values: true/yes/on, false/no/off
macvlan.tap
مشخص میکند که آیا رابط باید یک MACVTAP باشد یا خیر.
Format: boolean
Valid values: true/yes/on, false/no/off
match setting
تنظیمات تطبیق (Match).
ویژگیها:
match.driver
برای نحوه استفاده از نویسههای خاص '|'، '&'، '!' و '\\' برای تطبیقهای اختیاری، اجباری و معکوس کردن الگو به NMSettingMatch:interface-name مراجعه کنید.
Format: list of strings
match.interface-name
یک عنصر میتواند با نماد لوله (|) یا امپرسند (&) شروع شود. اولی به این معناست که عنصر اختیاری است و دومی به معنای اجباری بودن آن است. اگر هرگونه عنصر اختیاری وجود داشته باشد، در صورتی که حداقل یکی از عناصر اختیاری مطابقت داشته باشد، تطبیق برابر با درست (true) ارزیابی میشود (OR منطقی). اگر عناصر اجباری وجود داشته باشند، همه آنها باید مطابقت داشته باشند (AND منطقی). بهطور پیشفرض، یک عنصر اختیاری است. این بدان معناست که عنصر "foo" رفتاری مشابه "|foo" دارد. همچنین میتوان با قرار دادن علامت تعجب (!) میان نماد خط لوله (یا امپرسند) و قبل از الگو، یک عنصر را معکوس کرد. توجه داشته باشید که "!foo" یک میانبر برای تطبیق اجباری "&!foo" است. در نهایت، میتوان از یک بکاسلش در ابتدای عنصر (پس از نویسههای خاص اختیاری) برای اسکیپ کردن ابتدای الگو استفاده کرد. به عنوان مثال، "&\\!a" یک تطبیق اجباری برای دقیقا "!a" است.
Format: list of strings
match.kernel-command-line
برای نحوه استفاده از نویسههای خاص '|'، '&'، '!' و '\\' برای تطبیقهای اختیاری، اجباری و معکوس کردن تطبیق به NMSettingMatch:interface-name مراجعه کنید.
Format: list of strings
match.path
برای دستگاههای PCI مسیر به صورت "pci-$domain:$bus:$device.$function" است که در آن هر متغیر یک مقدار شانزدهشانزدهی است؛ برای مثال "pci-0000:0a:00.0".
مسیر یک دستگاه را میتوان با دستور "udevadm info /sys/class/net/$dev | grep ID_PATH=" یا با مشاهده ویژگی "path" ارائهشده توسط NetworkManager ("nmcli -f general.path device show $dev") به دست آورد.
هر عنصر این فهرست یک الگوی نویسه عمومی شل (shell wildcard pattern) است.
برای نحوه استفاده از نویسههای خاص '|'، '&'، '!' و '\\' برای تطبیقهای اختیاری، اجباری و معکوس کردن الگو به NMSettingMatch:interface-name مراجعه کنید.
Format: list of strings
802-11-olpc-mesh setting
Alias: olpc-mesh
تنظیمات شبکه مش بیسیم OLPC.
ویژگیها:
802-11-olpc-mesh.channel
کانالی که شبکه مش مورد نظر برای پیوستن روی آن قرار دارد.
Format: integer
Valid values: 0 - 4294967295
802-11-olpc-mesh.dhcp-anycast-address
نشانی MAC انیکست DHCP مورد استفاده هنگام درخواست نشانی IP از طریق DHCP. نشانی انیکست خاصِ مورد استفاده مشخص میکند کدام رده کارگزار DHCP به درخواست پاسخ دهد.
این ویژگی در حال حاضر تنها توسط افزونه DHCP با نام dhclient پیادهسازی شده است.
Format: MAC address
802-11-olpc-mesh.ssid
شناسه SSID مربوط به شبکه مش برای پیوستن.
Format: string
ovs-bridge setting
تنظیمات پیوند OvsBridge.
ویژگیها:
ovs-bridge.datapath-type
Format: string
Valid values: system, netdev
ovs-bridge.fail-mode
Format: string
Valid values: secure, standalone
ovs-bridge.mcast-snooping-enable
Format: boolean
Valid values: true/yes/on, false/no/off
ovs-bridge.rstp-enable
Format: boolean
Valid values: true/yes/on, false/no/off
ovs-bridge.stp-enable
Format: boolean
Valid values: true/yes/on, false/no/off
ovs-dpdk setting
تنظیمات پیوند OvsDpdk.
ویژگیها:
ovs-dpdk.devargs
Format: string
ovs-dpdk.lsc-interrupt
Format: choice (NMSettingOvsDpdkLscInterrupt)
Valid values: ignore (-1), disabled (0), enabled (1)
ovs-dpdk.n-rxq
Format: integer
Valid values: 0 - 4294967295
ovs-dpdk.n-rxq-desc
Format: integer
Valid values: 0 - 4096
ovs-dpdk.n-txq-desc
Format: integer
Valid values: 0 - 4096
ovs-interface setting
تنظیمات رابط Open vSwitch.
ویژگیها:
ovs-interface.ofport-request
Format: integer
Valid values: 0 - 65279
ovs-interface.type
Format: string
Valid values: internal, system, patch, dpdk
ovs-patch setting
تنظیمات پیوند OvsPatch.
ویژگیها:
ovs-patch.peer
Format: string
ovs-port setting
تنظیمات پیوند OvsPort.
ویژگیها:
ovs-port.bond-downdelay
Format: integer
Valid values: 0 - 4294967295
ovs-port.bond-mode
Format: string
Valid values: active-backup, balance-slb, balance-tcp
ovs-port.bond-updelay
Format: integer
Valid values: 0 - 4294967295
ovs-port.lacp
Format: string
Valid values: active, off, passive
ovs-port.tag
Format: integer
Valid values: 0 - 4095
ovs-port.trunks
این ویژگی تنها برای پورتهایی با حالت "trunk"، "native-tagged" یا "native-untagged port" معتبر است. اگر خالی باشد، پورت تمام VLANها را ترانک میکند.
Format: list of ovs-port.trunks objects
ovs-port.vlan-mode
Format: string
Valid values: access, native-tagged, native-untagged, trunk, dot1q-tunnel
ppp setting
تنظیمات پروتکل نقطه به نقطه (PPP).
ویژگیها:
ppp.baud
Format: integer
Valid values: 0 - 4294967295
ppp.crtscts
Format: boolean
Valid values: true/yes/on, false/no/off
ppp.lcp-echo-failure
Format: integer
Valid values: 0 - 4294967295
ppp.lcp-echo-interval
Format: integer
Valid values: 0 - 4294967295
ppp.mppe-stateful
Format: boolean
Valid values: true/yes/on, false/no/off
ppp.mru
Format: integer
Valid values: 0 - 16384
ppp.mtu
Format: integer
Special values: auto
ppp.no-vj-comp
Format: boolean
Valid values: true/yes/on, false/no/off
ppp.noauth
Format: boolean
Valid values: true/yes/on, false/no/off
ppp.nobsdcomp
Format: boolean
Valid values: true/yes/on, false/no/off
ppp.nodeflate
Format: boolean
Valid values: true/yes/on, false/no/off
ppp.refuse-chap
Format: boolean
Valid values: true/yes/on, false/no/off
ppp.refuse-eap
Format: boolean
Valid values: true/yes/on, false/no/off
ppp.refuse-mschap
Format: boolean
Valid values: true/yes/on, false/no/off
ppp.refuse-mschapv2
Format: boolean
Valid values: true/yes/on, false/no/off
ppp.refuse-pap
Format: boolean
Valid values: true/yes/on, false/no/off
ppp.require-mppe
Format: boolean
Valid values: true/yes/on, false/no/off
ppp.require-mppe-128
Format: boolean
Valid values: true/yes/on, false/no/off
pppoe setting
تنظیمات پروتکل نقطه به نقطه روی اترنت (PPPoE).
ویژگیها:
pppoe.parent
در صورت تعیین شدن، نام رابط والد را که این اتصال PPPoE باید روی آن ایجاد شود مشخص میکند. اگر این ویژگی مشخص نشود، اتصال روی رابط مشخصشده در "interface-name" از NMSettingConnection فعال میشود.
Format: string
pppoe.password
گذرواژه مورد استفاده برای احراز هویت در سرویس PPPoE.
Format: string
pppoe.password-flags
Format: flags (NMSettingSecretFlags)
Valid values: none (0x0), agent-owned (0x1), not-saved (0x2), not-required (0x4)
pppoe.service
در صورت تعیین شدن، به PPPoE دستور میدهد که فقط با متمرکزکنندههای دسترسی (access concentrators) که سرویس مشخصشده را ارائه میدهند نشست برقرار کند. برای بیشتر ارائهدهندگان، این مقدار باید خالی بماند. این ویژگی تنها در صورتی لازم است که چندین متمرکزکننده دسترسی وجود داشته باشد یا مشخصاً نیاز به یک سرویس خاص محرز باشد.
Format: string
pppoe.username
نام کاربری مورد استفاده برای احراز هویت در سرویس PPPoE.
Format: string
proxy setting
تنظیمات پروکسی وب (WWW Proxy).
ویژگیها:
proxy.browser-only
مشخص میکند که آیا پیکربندی پروکسی فقط برای مرورگر است یا خیر.
Format: boolean
Valid values: true/yes/on, false/no/off
proxy.method
روش پیکربندی پروکسی، پیشفرض "none" (0) است.
Format: choice (NMSettingProxyMethod)
Valid values: none (0), auto (1)
proxy.pac-script
اسکریپت PAC. در نمایه، این مقدار باید یک کد جاوااسکریپت با رمزگذاری UTF-8 باشد که تابع FindProxyForURL() را تعریف میکند. هنگام تنظیم این ویژگی در nmcli، نام فایل نیز پذیرفته میشود. در این حالت، nmcli محتوای فایل را خوانده و اسکریپت را تنظیم میکند. پیشوندهای "file://" و "js://" برای تفکیک صریح میان این دو مورد پشتیبانی میشوند.
Format: string
proxy.pac-url
نشانی اینترنتی PAC برای دریافت فایل PAC.
Format: string
serial setting
تنظیمات پیوند سریال.
ویژگیها:
serial.baud
Format: integer
Valid values: 0 - 4294967295
serial.bits
Format: integer
Valid values: 5 - 8
serial.parity
Format: choice (NMSettingSerialParity)
Valid values: none/N/n (0), even/E/e (1), odd/O/o (2)
serial.send-delay
Format: integer
Valid values: 0 - 18446744073709551615
serial.stopbits
Format: integer
Valid values: 1 - 2
sriov setting
تنظیمات SR-IOV.
ویژگیها:
sriov.autoprobe-drivers
اگر روی "true" (1) تنظیم شود، هسته تلاش میکند VFها را به یک درایور سازگار متصل کند و در صورت موفقیت، یک رابط شبکه جدید برای هر VF ایجاد خواهد شد.
اگر روی "false" (0) تنظیم شود، VFها تخصیص نیافته و هیچ رابط شبکهای برای آنها ایجاد نمیشود.
هنگامی که روی "default" (-1) تنظیم شود، از پیشفرض سراسری استفاده میشود؛ در صورتی که پیشفرض سراسری مشخص نشده باشد، مقدار "true" (1) فرض میشود.
Format: ternary
Valid values: true/yes/on, false/no/off, default/unknown
sriov.eswitch-encap-mode
در حال حاضر این ویژگی فقط برای دستگاههای PCI PF پشتیبانی میشود، و تنها در صورتی که دستگاه eswitch از همان آدرس PCI مربوط به PF مدیریت شود.
اگر روی "preserve" (-1) (پیشفرض) تنظیم شود، حالت کپسولهسازی eswitch توسط NetworkManager تغییر نخواهد کرد.
Format: choice (NMSriovEswitchEncapMode)
Valid values: preserve (-1), none (0), basic (1)
sriov.eswitch-inline-mode
در حال حاضر این ویژگی فقط برای دستگاههای PCI PF پشتیبانی میشود، و تنها در صورتی که دستگاه eswitch از همان آدرس PCI مربوط به PF مدیریت شود.
اگر روی "preserve" (-1) (پیشفرض) تنظیم شود، حالت inline دستگاه eswitch توسط NetworkManager تغییر نخواهد کرد.
Format: choice (NMSriovEswitchInlineMode)
Valid values: preserve (-1), none (0), link (1), network (2), transport (3)
sriov.eswitch-mode
اگر روی "preserve" (-1) (پیشفرض) تنظیم شود، حالت eswitch توسط NetworkManager تغییر نخواهد کرد.
Format: choice (NMSriovEswitchMode)
Valid values: preserve (-1), legacy (0), switchdev (1)
sriov.preserve-on-down
اگر روی "no" (0) تنظیم شود، NetworkManager هنگام غیرفعال شدن اتصال، پارامترهای SR-IOV را بازنشانی میکند. هنگامی که روی "yes" (1) تنظیم شود، NetworkManager آن پارامترها را روی دستگاه حفظ مینماید. اگر مقدار "default" (-1) باشد، NetworkManager به دنبال یک مقدار پیشفرض سراسری در پیکربندی میگردد؛ در صورتی که چنین مقداری تعریف نشده باشد، از "no" (0) به عنوان جایگزین استفاده میکند.
Format: choice (NMSriovPreserveOnDown)
Valid values: default (-1), no (0), yes (1)
sriov.total-vfs
توجه داشته باشید زمانی که تنظیم sriov وجود داشته باشد، NetworkManager در حین فعالسازی، تعداد توابع مجازی را روی رابط اعمال میکند (حتی زمانی که صفر باشد) و پس از غیرفعالسازی آن را بازنشانی مینماید. برای جلوگیری از هرگونه تغییر در پارامترهای SR-IOV، تنظیم sriov را به اتصال اضافه نکنید.
Format: integer
Valid values: 0 - 4294967295
sriov.vfs
هر توصیفکننده VF یک دیکشنری است که نام مشخصهها را به مقادیر GVariant نگاشت میکند. مدخل 'index' برای هر VF اجباری است.
هنگامی که به صورت رشته نمایش داده شود، یک VF به این شکل است:
"INDEX [ATTR=VALUE[ ATTR=VALUE]...]".
برای مثال:
"2 mac=00:11:22:33:44:55 spoof-check=true".
چندین VF را میتوان با استفاده از ویرگول به عنوان جداکننده مشخص کرد. در حال حاضر، مشخصههای زیر پشتیبانی میشوند: mac، spoof-check، trust، min-tx-rate، max-tx-rate، vlans.
مشخصه "vlans" به صورت فهرستی از توصیفکنندههای VLAN جداشده با نقطهویرگول نمایش داده میشود، که در آن هر توصیفکننده به این شکل است:
"ID[.PRIORITY[.PROTO]]".
مقدار PROTO میتواند 'q' برای 802.1Q (پیشفرض) یا 'ad' برای 802.1ad باشد.
Format: list of sriov.vfs objects
tc setting
تنظیمات کنترل ترافیک لینوکس (TC).
ویژگیها:
tc.qdiscs
هر qdisc را میتوان با مشخصههای زیر تعیین کرد:
handle HANDLE
parent HANDLE
root
KIND
پارامترهای مربوط به 'fq_codel':
limit U32
memory_limit U32
flows U32
target U32
interval U32
quantum U32
ecn BOOL
ce_threshold U32
پارامترهای مربوط به 'sfq':
divisor U32
limit U32
depth U32
perturb_period U32
quantum U32
flows U32
پارامترهای مربوط به 'tbf':
rate U64
burst U32
اگر بافر شما بیش از حد کوچک باشد، ممکن است بستهها دور ریخته شوند زیرا در هر تیک تایمر، توکنهای بیشتری نسبت به گنجایش سطل وارد میشوند. حداقل اندازه بافر را میتوان با تقسیم نرخ (rate) بر HZ محاسبه کرد.
محاسبات مصرف توکن با استفاده از جدولی انجام میشود که به طور پیشفرض دارای تفکیکپذیری ۸ بسته است. این تفکیکپذیری را میتوان با تعیین اندازه سلول (cell size) به همراه burst تغییر داد. به عنوان مثال، برای مشخص کردن بافر ۶۰۰۰ بایتی با اندازه سلول ۱۶ بایت، مقدار burst را روی 6000/16 تنظیم کنید. احتمالاً هرگز نیازی به تنظیم این مورد نخواهید داشت. مقدار باید توان صحیحی از ۲ باشد.
limit U32
latency U32
Format: GPtrArray(NMTCQdisc)
tc.tfilters
هر فیلتر ترافیک (tfilters) را میتوان با مشخصههای زیر تعیین کرد:
handle HANDLE
parent HANDLE
root
KIND
کنشهای مربوط به 'mirred':
egress bool
ingress bool
mirror bool
redirect bool
کنش مربوط به 'simple':
sdata char[32]
Format: GPtrArray(NMTCTfilter)
team setting
تنظیمات پیوند تیمی (Teaming).
ویژگیها:
team.config
پیکربندی JSON برای رابط شبکه تیمی. این ویژگی باید حاوی دادههای خام پیکربندی JSON مناسب برای teamd باشد، زیرا مقدار مستقیماً به teamd ارسال میشود. در صورت مشخص نشدن، از پیکربندی پیشفرض استفاده میشود. برای جزئیات قالب به man teamd.conf مراجعه کنید.
Format: string
team.link-watchers
Format: list of team.link-watchers objects
team.mcast-rejoin-count
Format: integer
Valid values: -2147483648 - 2147483647
Special values: unset (-1), disabled (0)
team.mcast-rejoin-interval
Format: integer
Valid values: -2147483648 - 2147483647
Special values: unset (-1), default (0)
team.notify-peers-count
Format: integer
Valid values: -2147483648 - 2147483647
Special values: unset (-1), disabled (0)
team.notify-peers-interval
Format: integer
Valid values: -2147483648 - 2147483647
Special values: unset (-1), default (0)
team.runner
Format: string
Valid values: broadcast, roundrobin, random, activebackup, loadbalance, lacp
team.runner-active
Format: boolean
Valid values: true/yes/on, false/no/off
team.runner-agg-select-policy
Format: string
Valid values: lacp_prio, lacp_prio_stable, bandwidth, count, port_config
team.runner-fast-rate
Format: boolean
Valid values: true/yes/on, false/no/off
team.runner-hwaddr-policy
Format: string
Valid values: same_all, by_active, only_active
team.runner-min-ports
Format: integer
Valid values: -2147483648 - 2147483647
Special values: unset (-1), default (1)
team.runner-sys-prio
Format: integer
Valid values: -2147483648 - 2147483647
Special values: unset (-1), default (65535)
team.runner-tx-balancer
Format: string
Valid values: basic
team.runner-tx-balancer-interval
Format: integer
Valid values: -2147483648 - 2147483647
Special values: unset (-1), default (50)
team.runner-tx-hash
Format: list of strings
Valid values: eth, vlan, ipv4, ipv6, ip, l3, tcp, udp, sctp, l4
team-port setting
تنظیمات درگاه تیمی (Team Port).
ویژگیها:
team-port.config
پیکربندی JSON برای درگاه تیمی. این ویژگی باید حاوی دادههای خام پیکربندی JSON مناسب برای teamd باشد، زیرا مقدار مستقیماً به teamd ارسال میشود. در صورت مشخص نشدن، از پیکربندی پیشفرض استفاده میشود. برای جزئیات قالب به man teamd.conf مراجعه کنید.
Format: string
team-port.lacp-key
Format: integer
Valid values: -2147483648 - 2147483647
Special values: unset (-1), default (0)
team-port.lacp-prio
Format: integer
Valid values: -2147483648 - 2147483647
Special values: unset (-1), default (255)
team-port.link-watchers
Format: list of team-port.link-watchers objects
team-port.prio
Format: integer
Valid values: -2147483648 - 2147483647
Special values: unset (0), default (0)
team-port.queue-id
Format: integer
Valid values: -2147483648 - 2147483647
Special values: unset (-1), default (0)
team-port.sticky
Format: boolean
Valid values: true/yes/on, false/no/off
tun setting
تنظیمات تونل (Tunnel).
ویژگیها:
tun.group
شناسه گروهی (GID) که مالک دستگاه خواهد بود. اگر روی NULL تنظیم شود، همه افراد قادر به استفاده از دستگاه خواهند بود.
Format: string
tun.mode
حالت کاری دستگاه مجازی. مقادیر مجاز عبارتند از «tun» (1) برای ساخت یک دستگاه لایه ۳ و «tap» (2) برای ساخت یک دستگاه لایه ۲ شبیه اترنت.
Format: choice (NMSettingTunMode)
Valid values: tun (1), tap (2)
tun.multi-queue
اگر این ویژگی روی TRUE تنظیم شود، رابط کاربری از چندین توصیفگر فایل (صف) به منظور موازیسازی ارسال یا دریافت بستهها پشتیبانی خواهد کرد. در غیر این صورت، رابط تنها از یک صف پشتیبانی میکند.
Format: boolean
Valid values: true/yes/on, false/no/off
tun.owner
شناسه کاربری (UID) که مالک دستگاه خواهد بود. اگر روی NULL تنظیم شود، همه افراد قادر به استفاده از دستگاه خواهند بود.
Format: string
tun.pi
اگر TRUE باشد، رابط یک سرآیند ۴ بایتی توصیفکننده رابط فیزیکی را به بستهها اضافه میکند.
Format: boolean
Valid values: true/yes/on, false/no/off
tun.vnet-hdr
اگر TRUE باشد (پرچم IFF_VNET_HDR)، بستههای تونل شامل سرآیند شبکه virtio خواهند بود.
Format: boolean
Valid values: true/yes/on, false/no/off
vlan setting
تنظیمات VLAN (شبکه محلی مجازی).
ویژگیها:
vlan.egress-priority-map
برای بستههای خروجی، فهرستی از نگاشتهای اولویتهای SKB لینوکس به اولویتهای 802.1p. نگاشت در قالب «from:to» ارائه میشود که در آن هم «from» و هم «to» اعداد صحیح بدون علامت هستند، مانند «7:3».
Format: list of vlan.egress-priority-map objects
vlan.flags
یک یا چند پرچم که رفتار و ویژگیهای رابط VLAN را کنترل میکنند. پرچمها شامل «reorder-headers» (0x1) (بازتوالی سرآیندهای بستههای خروجی)، «gvrp» (0x2) (استفاده از پروتکل GVRP)، «loose-binding» (0x4) (اتصال سست رابط به وضعیت عملیاتی دستگاه کنترلکننده آن) و «mvrp» (0x8) (استفاده از پروتکل MVRP) هستند.
مقدار پیشفرض این ویژگی NM_VLAN_FLAG_REORDER_HEADERS است، اما قبلاً 0 بود. به منظور حفظ سازگاری عقبرو، مقدار پیشفرض در واسط برنامهنویسی D-Bus همچنان 0 باقی مانده و ویژگی ناموجود در D-Bus کماکان 0 در نظر گرفته میشود.
Format: flags (NMVlanFlags)
Valid values: reorder-headers (0x1), gvrp (0x2), loose-binding (0x4), mvrp (0x8)
vlan.id
شناسه VLAN که باید به رابط ایجادشده توسط این اتصال اختصاص داده شود. محدوده معتبر از 0 تا 4094 است، بدون شناسه رزروشده 4095.
Format: integer
Valid values: 0 - 4095
vlan.ingress-priority-map
برای بستههای ورودی، فهرستی از نگاشتهای اولویتهای 802.1p به اولویتهای SKB لینوکس. نگاشت در قالب «from:to» ارائه میشود که در آن هر دو «from» و «to» اعداد صحیح بدون علامت هستند، مانند «7:3».
Format: list of vlan.ingress-priority-map objects
vlan.parent
در صورت تعیین، نام رابط والد یا UUID اتصال والد را که این رابط VLAN باید از آن ایجاد شود مشخص میکند. اگر این ویژگی مشخص نشود، اتصال باید شامل تنظیم «802-3-ethernet» با ویژگی «mac-address» باشد.
Format: string
vlan.protocol
مقادیر پشتیبانیشده عبارتند از: '802.1Q' و '802.1ad'. در صورت عدم تعیین، مقدار پیشفرض '802.1Q' است.
Format: string
Valid values: 802.1Q, 802.1ad
vpn setting
تنظیمات VPN (شبکه خصوصی مجازی).
ویژگیها:
vpn.data
Format: list of key/value options
vpn.persistent
Format: boolean
Valid values: true/yes/on, false/no/off
vpn.secrets
Format: list of key/value options
vpn.service-type
نام سرویس D-Bus پلاگین VPN که این تنظیم برای اتصال به شبکه خود از آن استفاده میکند؛ مانند org.freedesktop.NetworkManager.vpnc برای پلاگین vpnc.
Format: string
vpn.timeout
Format: integer
Valid values: 0 - 4294967295
vpn.user-name
اگر اتصال VPN برای احراز هویت به نام کاربری نیاز داشته باشد، آن نام باید در اینجا ارائه شود. اگر اتصال در دسترس بیش از یک کاربر است و VPN ایجاب میکند هر کاربر نام متفاوتی وارد کند، این ویژگی را خالی بگذارید. اگر این ویژگی خالی باشد، NetworkManager به طور خودکار نام کاربریِ کاربری را که اتصال VPN را درخواست کرده است ارائه میدهد.
Format: string
vrf setting
تنظیمات VRF (مسیریابی و فوروارد مجازی).
ویژگیها:
vrf.table
جدول مسیریابی برای این VRF.
Format: integer
Valid values: 0 - 4294967295
vxlan setting
تنظیمات VXLAN (شبکه محلی گسترشپذیر مجازی).
ویژگیها:
vxlan.ageing
Format: integer
Valid values: 0 - 4294967295
vxlan.destination-port
پورت مقصد UDP را برای ارتباط با نقطه پایانی دوردست تونل VXLAN مشخص میکند.
Format: integer
Valid values: 0 - 65535
vxlan.id
شناسه شبکه VXLAN (یا شناسه بخش VXLAN) مورد استفاده را مشخص میکند.
Format: integer
Valid values: 0 - 16777215
vxlan.l2-miss
Format: boolean
Valid values: true/yes/on, false/no/off
vxlan.l3-miss
Format: boolean
Valid values: true/yes/on, false/no/off
vxlan.learning
Format: boolean
Valid values: true/yes/on, false/no/off
vxlan.limit
Format: integer
Valid values: 0 - 4294967295
vxlan.local
در صورت تعیین، آدرس IP مبدأ را برای استفاده در بستههای خروجی مشخص میکند.
Format: string
vxlan.parent
در صورت تعیین، نام رابط والد یا UUID اتصال والد را مشخص میکند.
Format: string
vxlan.proxy
Format: boolean
Valid values: true/yes/on, false/no/off
vxlan.remote
آدرس IP مقصد تکپخشی (unicast) را برای استفاده در بستههای خروجی هنگامی که آدرس لایه پیوند مقصد در پایگاه داده فورواردینگ دستگاه VXLAN شناخته شده نیست، یا آدرس IP چندپخشی (multicast) را برای پیوستن مشخص میکند.
Format: string
vxlan.rsc
Format: boolean
Valid values: true/yes/on, false/no/off
vxlan.source-port-max
حداکثر پورت مبدأ UDP را برای ارتباط با نقطه پایانی دوردست تونل VXLAN مشخص میکند.
Format: integer
Valid values: 0 - 65535
vxlan.source-port-min
حداقل پورت مبدأ UDP را برای ارتباط با نقطه پایانی دوردست تونل VXLAN مشخص میکند.
Format: integer
Valid values: 0 - 65535
vxlan.tos
Format: integer
Valid values: 0 - 255
vxlan.ttl
Format: integer
Valid values: 0 - 255
wifi-p2p setting
تنظیمات وایفای همتابههمتا (Wi-Fi P2P).
ویژگیها:
wifi-p2p.peer
دستگاه P2P که باید به آن متصل شد. در حال حاضر، این تنها راه برای ایجاد یک گروه یا پیوستن به آن است.
Format: MAC address
wifi-p2p.wfd-ies
فناوری Wi-Fi Display مستلزم تنظیم یک عنصر اطلاعاتی اختصاصی پروتکل در فریمهای خاصی از وایفای است. این موارد را میتوان در اینجا برای برقراری اتصال مشخص کرد. این تنظیم تنها هنگام پیادهسازی کلاینت Wi-Fi Display سودمند است.
Format: bytes
wifi-p2p.wps-method
تغییر تنظیم پیشفرض فایده چندانی ندارد چرا که NetworkManager به صورت خودکار بهترین روش برای استفاده را تعیین خواهد کرد.
Format: flags (NMSettingWirelessSecurityWpsMethod)
Valid values: default (0x0), disabled (0x1), auto (0x2), pbc (0x4), pin (0x8)
wimax setting
تنظیمات وایمکس (WiMax).
ویژگیها:
wimax.mac-address
در صورت تعیین، این اتصال تنها به دستگاه WiMAX اعمال خواهد شد که آدرس MAC آن همخوانی داشته باشد. این ویژگی آدرس MAC دستگاه را تغییر نمیدهد (که به عنوان جعل MAC یا MAC spoofing شناخته میشود).
این ویژگی از نسخه 1.2 منسوخ شده است. WiMAX دیگر پشتیبانی نمیشود.
Format: string
wimax.network-name
نام ارائهدهنده خدمات شبکه (NSP) مربوط به شبکه WiMAX که این اتصال باید استفاده کند.
این ویژگی از نسخه 1.2 منسوخ شده است. WiMAX دیگر پشتیبانی نمیشود.
Format: MAC address
802-3-ethernet setting
Alias: ethernet
تنظیمات اترنت کابلی (Wired Ethernet).
ویژگیها:
802-3-ethernet.accept-all-mac-addresses
Format: ternary
Valid values: true/yes/on, false/no/off, default/unknown
802-3-ethernet.auto-negotiate
Format: boolean
Valid values: true/yes/on, false/no/off
802-3-ethernet.cloned-mac-address
در صورت تعیین، درخواست میکند که دستگاه به جای آدرس قبلی از این آدرس MAC استفاده کند. این کار تحت عنوان شبیهسازی یا جعل MAC شناخته میشود.
علاوه بر تعیین صریح یک آدرس MAC، مقادیر ویژه «preserve»، «permanent»، «random» و «stable» پشتیبانی میشوند. مقدار «preserve» به این معنی است که در هنگام فعالسازی، دست به آدرس MAC زده نشود. مقدار «permanent» به این معنی است که از آدرس سختافزاری دائمی دستگاه در صورت وجود استفاده شود (در غیر این صورت به عنوان «preserve» در نظر گرفته میشود). مقدار «random» در هر اتصال یک آدرس MAC تصادفی تولید میکند. مقدار «stable» یک آدرس MAC هششده بر اساس connection.stable-id و یک کلید وابسته به ماشین تولید میکند.
در صورت عدم تعیین، این مقدار میتواند از طریق پیشفرضهای سراسری بازنویسی شود؛ راهنمای NetworkManager.conf را ببینید. اگر همچنان نامشخص باشد، مقدار پیشفرض آن «preserve» است (نسخههای قدیمیتر NetworkManager ممکن است از مقدار پیشفرض متفاوتی استفاده کنند).
در D-Bus، این فیلد به صورت «assigned-mac-address» یا «cloned-mac-address» منسوخشده بیان میشود.
Format: MAC address
Special values: preserve, permanent, random, stable
802-3-ethernet.duplex
Format: string
Valid values: half, full
802-3-ethernet.generate-mac-address-mask
اگر این ویژگی NULL باشد، واجد شرایط بازنویسی توسط تنظیمات پیشفرض اتصال خواهد بود. اگر مقدار همچنان NULL یا یک رشته خالی باشد، حالت پیشفرض ساخت یک آدرس MAC تکپخشی با مدیریت محلی است.
اگر مقدار شامل یک آدرس MAC باشد، از این آدرس به عنوان ماسک استفاده میشود. بیتهای ستشده ماسک باید با آدرس MAC کنونی دستگاه پر شوند، در حالی که بیتهای ستنشده مشمول تصادفیسازی هستند. تنظیم «FE:FF:FF:00:00:00» به معنای حفظ OUI آدرس MAC کنونی و تنها تصادفیسازی ۳ بایت پایینی با استفاده از الگوریتم «random» یا «stable» است.
اگر مقدار شامل یک آدرس MAC اضافی پس از ماسک باشد، از این آدرس به جای آدرس MAC کنونی دستگاه برای پر کردن بیتهایی که نباید تصادفی شوند استفاده میشود. برای مثال، مقدار «FE:FF:FF:00:00:00 68:F7:28:00:00:00» مقدار OUI آدرس MAC را برابر 68:F7:28 قرار میدهد، در حالی که بیتهای پایینی تصادفیسازی میشوند. مقدار «02:00:00:00:00:00 00:00:00:00:00:00» یک آدرس MAC ثبتشده در سختافزار (burned-in) با مدیریت سراسری و کاملاً تصادفی ایجاد خواهد کرد.
اگر مقدار شامل بیش از یک آدرس MAC اضافی باشد، یکی از آنها به صورت تصادفی برگزیده میشود. برای نمونه، «02:00:00:00:00:00 00:00:00:00:00:00 02:00:00:00:00:00» یک آدرس MAC کاملاً درهمریخته ایجاد میکند که به صورت تصادفی دارای مدیریت محلی یا سراسری است.
Format: string
802-3-ethernet.mac-address
در صورت تعیین، این اتصال تنها به دستگاه اترنت با آدرس MAC دائمی منطبق اعمال میشود. این ویژگی آدرس MAC دستگاه را تغییر نمیدهد (یعنی جعل MAC نیست).
Format: MAC address
802-3-ethernet.mac-address-blacklist
Format: list of MAC addresses
802-3-ethernet.mac-address-denylist
Format: list of MAC addresses
802-3-ethernet.mtu
اگر غیرصفر باشد، بستهها فقط در اندازه مشخصشده یا کوچکتر ارسال میشوند و بستههای بزرگتر به چندین فریم اترنت تقسیم میشوند.
Format: integer
Special values: auto
802-3-ethernet.port
Format: read only
802-3-ethernet.s390-nettype
Format: string
Valid values: qeth, lcs, ctc
802-3-ethernet.s390-options
در حال حاضر، NetworkManager به خودی خود کاری با این اطلاعات انجام نمیدهد. با این حال، s390utils یک قاعده udev ارائه میکند که این اطلاعات را پردازش کرده و بر روی رابط اعمال مینماید.
Format: list of key/value options
802-3-ethernet.s390-subchannels
Format: list of 802-3-ethernet.s390-subchannels objects
802-3-ethernet.speed
Format: integer
Valid values: 0 - 4294967295
802-3-ethernet.wake-on-lan
Format: flags (NMSettingWiredWakeOnLan)
Valid values: phy (0x2), unicast (0x4), multicast (0x8), broadcast (0x10), arp (0x20), magic (0x40), default (0x1), ignore (0x8000)
802-3-ethernet.wake-on-lan-password
Format: MAC address
wireguard setting
تنظیمات وایرگارد (WireGuard).
ویژگیها:
wireguard.fwmark
توجه داشته باشید که فعال بودن «ip4-auto-default-route» یا «ip6-auto-default-route» متضمن انتخاب خودکار یک fwmark است.
Format: integer
Valid values: 0 - 4294967295
wireguard.ip4-auto-default-route
توجه داشته باشید که برای کارکرد این خودکارسازی، معمولاً نباید ipv4.gateway را تنظیم کنید، زیرا منجر به ایجاد یک مسیر پیشفرض متداخل خواهد شد.
رها کردن این گزینه در مقدار پیشفرض، چنانچه ipv4.never-default تنظیم نشده باشد و همتایانی وجود داشته باشند که از مسیر پیشفرض به عنوان allowed-ips استفاده کنند، این گزینه را به طور خودکار فعال خواهد کرد. از آنجا که این خودکارسازی تنها در صورتی منطقی است که همتایی با allowed-ips دارای /0 داشته باشید، معمولاً نیازی به فعالسازی صریح آن نیست. با این حال، در صورتی که تمایل دارید مسیریابی و قواعد خود را پیکربندی کنید، میتوانید آن را غیرفعال نمایید.
Format: ternary
Valid values: true/yes/on, false/no/off, default/unknown
wireguard.ip6-auto-default-route
Format: ternary
Valid values: true/yes/on, false/no/off, default/unknown
wireguard.listen-port
Format: integer
Valid values: 0 - 65535
wireguard.mtu
اگر صفر باشد از یک MTU پیشفرض استفاده میشود. توجه داشته باشید که برخلاف تنظیم MTU در wg-quick، این مقدار مسیرهای جاری در زمان فعالسازی را در نظر نمیگیرد.
Format: integer
Special values: auto
wireguard.peer-routes
توجه داشته باشید که اگر AllowedIPs همتا برابر "0.0.0.0/0" یا "::/0" باشد و تنظیم ipv4.never-default یا ipv6.never-default پروفایل فعال باشد، مسیر همتا برای این همتا به طور خودکار افزوده نخواهد شد.
Format: boolean
Valid values: true/yes/on, false/no/off
wireguard.peers
public-key [attribute=value [attribute=value]...]
کلید عمومی الزامی است و باید با کدگذاری base64 باشد؛ میتوان آن را با اجرای دستور wg pubkey بر روی کلید خصوصی به دست آورد، و معمولاً به صورت خارج از باند (out of band) به نویسنده فایل پیکربندی منتقل میشود.
ویژگیهای پشتیبانیشده عبارتند از:
endpoint
allowed-ips
persistent-keepalive
preshared-key
preshared-key-flags
Format: a comma-separated list of WireGuard peers
wireguard.private-key
Format: string
wireguard.private-key-flags
Format: flags (NMSettingSecretFlags)
Valid values: none (0x0), agent-owned (0x1), not-saved (0x2), not-required (0x4)
802-11-wireless setting
Alias: wifi
تنظیمات Wi-Fi.
ویژگیها:
802-11-wireless.ap-isolation
اگر روی "true" (1) تنظیم شود، دستگاهها قادر به ارتباط با یکدیگر نخواهند بود. این امر امنیت را افزایش میدهد زیرا از دستگاهها در برابر حملات سایر کلاینتهای موجود در شبکه محافظت میکند. در عین حال، مانع دسترسی دستگاهها به منابع موجود در همان شبکه بیسیم مانند اشتراکهای فایل، چاپگرها و غیره میشود.
اگر روی "false" (0) تنظیم شود، دستگاهها میتوانند با یکدیگر ارتباط برقرار کنند.
هنگامی که روی "default" (-1) تنظیم شود، از پیشفرض سراسری استفاده میشود؛ در صورتی که پیشفرض سراسری مشخص نشده باشد، "false" (0) فرض میشود.
Format: ternary
Valid values: true/yes/on, false/no/off, default/unknown
802-11-wireless.band
Format: string
Valid values: a, bg, 6GHz
802-11-wireless.bssid
قفل کردن یک نمایه کلاینت به یک BSSID خاص مانع از رومینگ شده و همچنین اسکن پسزمینه را غیرفعال میکند. اگر تنها یک نقطه دسترسی برای SSID وجود داشته باشد، این کار میتواند مفید باشد.
Format: MAC address
802-11-wireless.channel
Format: integer
Valid values: 0 - 4294967295
802-11-wireless.channel-width
هنگامی که روی "auto" (0) (پیشفرض) تنظیم شود، عرض کانال به صورت خودکار تعیین میشود. در حال حاضر، این بدان معناست که امنترین (کوچکترین) عرض انتخاب میشود.
اگر مقدار "auto" (0) نباشد، آنگاه ویژگی 'channel' نیز باید تنظیم شده باشد. هنگام استفاده از باند 2.4GHz، عرض میتواند حداکثر 40MHz باشد.
این ویژگی تنها زمانی میتواند مقداری متفاوت از "auto" (0) داشته باشد که رابط در حالت AP پیکربندی شده باشد.
Format: choice (NMSettingWirelessChannelWidth)
Valid values: auto (0), 20mhz (20), 40mhz (40), 80mhz (80)
802-11-wireless.cloned-mac-address
در صورت تعیین، درخواست میکند که دستگاه به جای نشانی اصلی از این نشانی MAC استفاده کند. این به عنوان شبیهسازی یا جعل MAC (کلونینگ MAC) شناخته میشود.
علاوه بر تعیین صریح یک نشانی MAC، مقادیر ویژه "preserve"، "permanent"، "random"، "stable" و "stable-ssid" نیز پشتیبانی میشوند. "preserve" به این معناست که نشانی MAC هنگام فعالسازی دستنخورده باقی بماند. "permanent" به معنای استفاده از نشانی سختافزاری دائمی دستگاه است. "random" در هر بار اتصال یک نشانی MAC تصادفی ایجاد میکند. "stable" یک نشانی MAC هششده بر اساس connection.stable-id و یک کلید وابسته به ماشین تولید میکند. "stable-ssid" یک نشانی MAC هششده بر اساس SSID ایجاد میکند، مشابه با تنظیم stable-id روی "${NETWORK_SSID}".
اگر مشخص نشود، مقدار میتواند از طریق پیشفرضهای سراسری بازنویسی شود؛ راهنمای NetworkManager.conf را ببینید. اگر همچنان نامشخص باشد، به طور پیشفرض روی "preserve" قرار میگیرد (نسخههای قدیمیتر NetworkManager ممکن است از مقدار پیشفرض متفاوتی استفاده کنند).
در D-Bus، این فیلد به صورت "assigned-mac-address" یا نام منسوخشده "cloned-mac-address" بیان میشود.
Format: MAC address
Special values: preserve, permanent, random, stable, stable-ssid
802-11-wireless.generate-mac-address-mask
اگر ویژگی NULL باشد، واجد شرایط بازنویسی توسط تنظیم پیشفرض اتصال است. اگر مقدار همچنان NULL یا یک رشته خالی باشد، پیشفرض ایجاد یک نشانی MAC محلی مدیریتشده و تکپخشی است.
اگر مقدار شامل یک نشانی MAC باشد، این نشانی به عنوان ماسک استفاده میشود. بیتهای تنظیمشده ماسک با نشانی MAC فعلی دستگاه پر میشوند، در حالی که بیتهای تنظیمنشده مشمول تصادفیسازی هستند. تنظیم "FE:FF:FF:00:00:00" به معنای حفظ OUI نشانی MAC فعلی و تصادفیسازی ۳ بایت پایینی با استفاده از الگوریتم "random" یا "stable" است.
اگر مقدار علاوه بر ماسک شامل یک نشانی MAC اضافی باشد، این نشانی به جای نشانی MAC فعلی برای پر کردن بیتهایی که نباید تصادفیسازی شوند استفاده میشود. به عنوان مثال، مقدار "FE:FF:FF:00:00:00 68:F7:28:00:00:00" شناسه OUI نشانی MAC را روی 68:F7:28 قرار میدهد، در حالی که بیتهای پایینی تصادفیسازی میشوند. مقدار "02:00:00:00:00:00 00:00:00:00:00:00" یک نشانی MAC کاملاً تصادفی، سراسری مدیریتشده و کارخانهای ایجاد میکند.
اگر مقدار شامل بیش از یک نشانی MAC اضافی باشد، یکی از آنها به صورت تصادفی انتخاب میشود. به عنوان مثال، "02:00:00:00:00:00 00:00:00:00:00:00 02:00:00:00:00:00" یک نشانی MAC کاملاً تصادفی، به صورت تصادفی محلی یا سراسری مدیریتشده ایجاد میکند.
Format: string
802-11-wireless.hidden
در حالت زیرساخت، راهکارهای مختلفی برای کشف مطمئنتر شبکههای پنهان استفاده میشود، مانند اسکن کاوشی برای SSID. با این حال، این راهکارها ناامنیهای ذاتی شبکههای با SSID پنهان را آشکار میکنند، بنابراین شبکههای با SSID پنهان باید با احتیاط استفاده شوند.
در حالت AP، شبکه ایجادشده SSID خود را پخش نمیکند.
توجه داشته باشید که علامتگذاری شبکه به عنوان پنهان ممکن است برای شما (در حالت زیرساخت) یا ایستگاههای کلاینت (در حالت AP) یک مسئله حریم خصوصی باشد، زیرا درخواستهای کاوش صریح به وضوح روی امواج بیسیم قابل شناسایی هستند.
Format: boolean
Valid values: true/yes/on, false/no/off
802-11-wireless.mac-address
در صورت تعیین، این اتصال تنها روی دستگاه Wi-Fi اعمال میشود که نشانی MAC دائمی آن مطابقت داشته باشد. این ویژگی نشانی MAC دستگاه را تغییر نمیدهد (یعنی جعل MAC نیست).
Format: MAC address
802-11-wireless.mac-address-blacklist
Format: list of MAC addresses
802-11-wireless.mac-address-denylist
Format: list of MAC addresses
802-11-wireless.mac-address-randomization
این ویژگی از نسخه 1.4 منسوخ شده است. به جای آن از ویژگی "cloned-mac-address" استفاده کنید.
Format: choice (NMSettingMacRandomization)
Valid values: default (0), never (1), always (2)
802-11-wireless.mode
حالت شبکه Wi-Fi؛ یکی از مقادیر "infrastructure"، "mesh"، "adhoc" یا "ap". اگر خالی باشد، infrastructure فرض میشود.
Format: string
Valid values: infrastructure, adhoc, ap, mesh
802-11-wireless.mtu
در صورت غیرصفر بودن، تنها بستههایی با اندازه مشخصشده یا کوچکتر را انتقال میدهد و بستههای بزرگتر را به چندین فریم اترنت تقسیم میکند.
Format: integer
Special values: auto
802-11-wireless.powersave
Format: choice (NMSettingWirelessPowersave)
Valid values: default (0), ignore (1), disable (2), enable (3)
802-11-wireless.seen-bssids
این یک ویژگی معمولی نیست که کاربر آن را پیکربندی کند. در عوض، NetworkManager به صورت خودکار BSSIDهای دیدهشده را تنظیم کرده و آنها را به صورت داخلی در فایل "/var/lib/NetworkManager/seen-bssids" ردیابی میکند.
Format: read only
802-11-wireless.ssid
شناسه SSID شبکه Wi-Fi. باید مشخص شود.
Format: string
802-11-wireless.wake-on-wlan
Format: flags (NMSettingWirelessWakeOnWLan)
Valid values: any (0x2), disconnect (0x4), magic (0x8), gtk-rekey-failure (0x10), eap-identity-request (0x20), 4way-handshake (0x40), rfkill-release (0x80), tcp (0x100), all (0x1fe), default (0x1), ignore (0x8000)
802-11-wireless-security setting
Alias: wifi-sec
تنظیمات امنیتی Wi-Fi.
ویژگیها:
802-11-wireless-security.auth-alg
Format: string
Valid values: open, shared, leap
802-11-wireless-security.fils
Format: choice (NMSettingWirelessSecurityFils)
Valid values: default (0), disable (1), optional (2), required (3)
802-11-wireless-security.group
Format: list of strings
Valid values: wep40, wep104, tkip, ccmp
802-11-wireless-security.key-mgmt
این ویژگی باید برای هر اتصال Wi-Fi که از امنیت استفاده میکند تنظیم شود.
Format: string
Valid values: none, ieee8021x, wpa-psk, wpa-eap, wpa-eap-suite-b-192, sae, owe
802-11-wireless-security.leap-password
Format: string
802-11-wireless-security.leap-password-flags
Format: flags (NMSettingSecretFlags)
Valid values: none (0x0), agent-owned (0x1), not-saved (0x2), not-required (0x4)
802-11-wireless-security.leap-username
Format: string
802-11-wireless-security.pairwise
Format: list of strings
Valid values: tkip, ccmp
802-11-wireless-security.pmf
Format: choice (NMSettingWirelessSecurityPmf)
Valid values: default (0), disable (1), optional (2), required (3)
802-11-wireless-security.proto
Format: list of strings
Valid values: wpa, rsn
802-11-wireless-security.psk
Format: string
802-11-wireless-security.psk-flags
Format: flags (NMSettingSecretFlags)
Valid values: none (0x0), agent-owned (0x1), not-saved (0x2), not-required (0x4)
802-11-wireless-security.wep-key-flags
Format: flags (NMSettingSecretFlags)
Valid values: none (0x0), agent-owned (0x1), not-saved (0x2), not-required (0x4)
802-11-wireless-security.wep-key-type
Format: choice (NMWepKeyType)
Valid values: unknown (0), key (1), passphrase (2)
802-11-wireless-security.wep-key0
Format: string
802-11-wireless-security.wep-key1
Format: string
802-11-wireless-security.wep-key2
Format: string
802-11-wireless-security.wep-key3
Format: string
802-11-wireless-security.wep-tx-keyidx
Format: integer
Valid values: 0 - 3
802-11-wireless-security.wps-method
تغییر تنظیم پیشفرض اهمیت چندانی ندارد، زیرا NetworkManager به طور خودکار بر اساس قابلیتهای نقطه دسترسی امکان شروع ثبتنام WPS را تعیین میکند.
با تنظیم این ویژگی روی مقدار 1، قابلیت WPS میتواند غیرفعال شود.
Format: flags (NMSettingWirelessSecurityWpsMethod)
Valid values: default (0x0), disabled (0x1), auto (0x2), pbc (0x4), pin (0x8)
wpan setting
تنظیمات MAC در IEEE 802.15.4 (WPAN).
ویژگیها:
wpan.channel
کانال IEEE 802.15.4. یک عدد صحیح مثبت یا -1 به معنای "تنظیم نشود، از هر آنچه دستگاه قبلاً تنظیم شده است استفاده شود".
Format: integer
Valid values: -32768 - 32767
Special values: default (-1)
wpan.mac-address
در صورت تعیین، این اتصال تنها روی دستگاه لایه MAC استاندارد IEEE 802.15.4 (WPAN) که نشانی MAC دائمی آن مطابقت دارد اعمال میشود.
Format: WPAN MAC address
wpan.page
صفحه کانال IEEE 802.15.4. یک عدد صحیح مثبت یا -1 به معنای "تنظیم نشود، از هر آنچه دستگاه قبلاً تنظیم شده است استفاده شود".
Format: integer
Valid values: -32768 - 32767
Special values: default (-1)
wpan.pan-id
شناسه شبکه محدوده شخصی (PAN) در IEEE 802.15.4.
Format: integer
Valid values: 0 - 65535
Special values: unset (0xffff)
wpan.short-address
نشانی کوتاه IEEE 802.15.4 برای استفاده در یک محیط محدود شده.
Format: integer
Valid values: 0 - 65535
Special values: unset (0xffff)
bond-port setting
تنظیمات درگاه Bond.
ویژگیها:
bond-port.prio
اولویت درگاه برای انتخاب مجدد درگاه فعال bond در زمان بروز خطا (failover). عدد بزرگتر به معنای اولویت بالاتر در انتخاب است. درگاه اولیه بالاترین اولویت را دارد. این گزینه تنها با حالتهای active-backup، balance-tlb و balance-alb سازگار است.
Format: integer
Valid values: -2147483648 - 2147483647
bond-port.queue-id
شناسه صف این درگاه bond. حداکثر مقدار شناسه صف برابر با تعداد صفهای TX فعال فعلی در دستگاه است.
Format: integer
Valid values: 0 - 65535
geneve setting
تنظیمات GENEVE.
ویژگیها:
geneve.destination-port
درگاه مقصد UDP را برای برقراری ارتباط با نقطه پایانی راه دور تونل GENEVE مشخص میکند.
Format: integer
Valid values: 0 - 65535
geneve.df
مقدار "unset" (0): فلگ DF تنظیم نشود، بستهها ممکن است قطعهبندی شوند. مقدار "set" (1): همیشه فلگ DF تنظیم شود، بستهها قطعهبندی نخواهند شد. مقدار "inherit" (2): فلگ DF از هدر IP درونی به ارث برده شود.
Format: choice (NMSettingGeneveDf)
Valid values: unset (0), set (1), inherit (2)
geneve.id
شناسه شبکه GENEVE (یا شناسه بخش GENEVE) را برای استفاده مشخص میکند.
Format: integer
Valid values: 0 - 16777215
geneve.remote
نشانی IP تکپخشی مقصد را برای استفاده در بستههای ارسالی هنگام برقراری ارتباط با نقطه پایانی راه دور تونل GENEVE مشخص میکند.
Format: string
geneve.tos
Format: integer
Valid values: 0 - 255
Special values: inherit (1)
geneve.ttl
Format: integer
Valid values: -1 - 255
Special values: inherit (-1)
hostname setting
تنظیمات نام میزبان (Hostname).
ویژگیها:
hostname.from-dhcp
هنگامی که روی "default" (-1) تنظیم شود، از مقدار پیکربندی سراسری استفاده میشود. اگر ویژگی در پیکربندی سراسری مقداری نداشته باشد، NetworkManager مقدار را "true" (1) فرض میکند.
Format: ternary
Valid values: true/yes/on, false/no/off, default/unknown
hostname.from-dns-lookup
هنگامی که روی "default" (-1) تنظیم شود، از مقدار پیکربندی سراسری استفاده میشود. اگر ویژگی در پیکربندی سراسری مقداری نداشته باشد، NetworkManager مقدار را "true" (1) فرض میکند.
Format: ternary
Valid values: true/yes/on, false/no/off, default/unknown
hostname.only-from-default
اگر روی "false" (0) تنظیم شود، نام میزبان میتواند از این دستگاه تنظیم شود حتی اگر مسیر پیشفرض نداشته باشد.
هنگامی که روی "default" (-1) تنظیم شود، از مقدار پیکربندی سراسری استفاده میشود. اگر ویژگی در پیکربندی سراسری مقداری نداشته باشد، NetworkManager مقدار را "false" (0) فرض میکند.
Format: ternary
Valid values: true/yes/on, false/no/off, default/unknown
hostname.priority
اگر مقدار صفر باشد، میتواند توسط یک مقدار سراسری از پیکربندی NetworkManager بازنویسی شود. اگر ویژگی در پیکربندی سراسری مقداری نداشته باشد، مقدار 100 فرض میشود.
مقادیر منفی اثر ویژهای در مستثنی کردن سایر اتصالها با اولویت عددی بزرگتر دارند؛ بنابراین در حضور حداقل یک اولویت منفی، تنها اتصالهای با کمترین مقدار اولویت برای تعیین نام میزبان استفاده خواهند شد.
Format: integer
Valid values: -2147483648 - 2147483647
link setting
تنظیمات پیوند (Link).
ویژگیها:
link.gro-max-size
Format: integer
Valid values: -1 - 4294967295
Special values: default (-1)
link.gso-max-segments
Format: integer
Valid values: -1 - 4294967295
Special values: default (-1)
link.gso-max-size
Format: integer
Valid values: -1 - 4294967295
Special values: default (-1)
link.tx-queue-length
Format: integer
Valid values: -1 - 4294967295
Special values: default (-1)
loopback setting
تنظیمات پیوند Loopback.
ویژگیها:
loopback.mtu
در صورت غیرصفر بودن، تنها بستههایی با اندازه مشخصشده یا کوچکتر را انتقال میدهد و بستههای بزرگتر را به چندین فریم اترنت تقسیم میکند.
Format: integer
Special values: auto
prefix-delegation setting
تنظیمات تفویض پیشوند (Prefix Delegation) در IPv6.
ویژگیها:
prefix-delegation.subnet-id
Format: integer
Valid values: -1 - 4294967295
veth setting
تنظیمات Veth.
ویژگیها:
veth.peer
این ویژگی نام رابط همتا در veth را مشخص میکند. این ویژگی اجباری است.
Format: string
Secret flag types:
هر ویژگی گذرواژه یا داده امنیتی (secret) در یک بخش تنظیمات دارای یک ویژگی مرتبط flags است که نحوه مدیریت آن داده امنیتی را توصیف میکند. ویژگی flags یک میدان بیتی است که شامل صفر یا چند مقدار زیر است که به صورت منطقی با یکدیگر OR شدهاند.
فایلها (FILES)
/etc/NetworkManager/system-connections یا مکانهای اختصاصی افزونههای توزیع
همچنین ببینید (SEE ALSO)
nmcli(1), nmcli-examples(7), NetworkManager(8), nm-settings-dbus(5), nm-settings-keyfile(5), NetworkManager.conf(5)
| NetworkManager 1.58.1 |